browser

type ConsoleEntry struct {
	Type string `json:"type"` // "error" or "warning"
	Text string `json:"text"`
	// TimestampMs is epoch milliseconds; CDP's Runtime.Timestamp counts
	// seconds since the epoch (mirrors the screencast frame timestamps), so
	// ordering across entries is stable but the field is wall-clock, not
	// relative to the page's time origin.
	TimestampMs int64 `json:"timestamp_ms"`
}

type FrameInfo struct {
	File     string  `json:"file"`     // frame_NNNNN.jpg inside the take dir
	T        int64   `json:"t"`        // epoch ms (CDP frame swap timestamp when present)
	Delta    float64 `json:"delta"`    // mean pixel delta vs the previous frame
	Keyframe bool    `json:"keyframe"` // scene cut (delta >= FrameCutDelta)
	ScrollX  float64 `json:"scroll_x,omitempty"`
	ScrollY  float64 `json:"scroll_y,omitempty"`
	W        int     `json:"w"`
	H        int     `json:"h"`
}

type Manager struct {
	// contains filtered or unexported fields
}

type Options struct {
	// Headless runs the browser without a window. Toggling it relaunches the
	// profile in the other mode; see SetHeadless.
	Headless bool

	// AllowDownload lets the manager download rod's pinned-revision Chromium
	// when launcher.LookPath finds no installed browser. The download lands
	// under the CLI cache dir (see browserDownloadDir). Tests leave this
	// false so a machine without a browser skips instead of downloading.
	AllowDownload bool

	// UserDataDir for the browser profile, keeping cookies across relaunches.
	// Empty takes DefaultUserDataDir (relative to the process working
	// directory, which for the CLI is the user's project root).
	UserDataDir string

	// IdleAfter overrides DefaultIdleAfter when positive.
	IdleAfter time.Duration

	// StepTimeout overrides DefaultStepTimeout when positive.
	StepTimeout time.Duration

	// BinPath forces a specific browser executable, bypassing
	// launcher.LookPath and downloads. A test seam; production leaves it
	// empty.
	BinPath string
}

type RecordOptions struct {
	// BaseDir under which rec_<id>/ is created. Empty takes DefaultCaptureDir.
	BaseDir string

	// MaxDuration is the auto-stop budget. <=0 takes the 60s default.
	MaxDuration time.Duration

	// MaxFrames is the ceiling; beyond it the oldest frames are dropped.
	// <=0 takes the 1200 default.
	MaxFrames int

	// Quality is the JPEG quality for frames. <=0 takes 80.
	Quality int

	// MaxWidth/MaxHeight optionally cap the screencast frame size.
	MaxWidth, MaxHeight int

	// Marks pulls the newest act marks from the dev bus ring (newest first).
	// The recorder keeps everything not yet consumed. Nil means no marks.
	Marks func() []TakeMark
}

type Step struct {
	// Action is one of: "goto", "click", "fill", "hover", "scroll", "key",
	// "select". Unknown actions error.
	Action string
	// Selector is the CSS selector the action targets. Required by click,
	// fill, hover, and select; ignored by goto, scroll, and key.
	Selector string
	// Value is the payload for the action:
	//   fill   — the text to type into the element (replaces existing content)
	//   goto   — the URL (allowlist-gated)
	//   key    — key name(s), e.g. "Enter Escape Tab ArrowDown a"
	//   select — the option value(s) to select, comma-separated
	//   click, hover, scroll — scroll takes it (see scrollLocked), others unused
	Value string
}

type StillOptions struct {
	// Widths is one viewport width per still. Empty captures only the
	// current viewport. Heights are inherited from the current viewport.
	Widths []int

	// URL navigates there first (allowlist-gated). Empty captures the page
	// the managed tab already shows.
	URL string

	// Dir is the output directory. Empty takes DefaultCaptureDir.
	Dir string
}

type StillResult struct {
	Width        int        `json:"width"`
	Height       int        `json:"height"`
	PNGPath      string     `json:"png"`
	ManifestPath string     `json:"manifest"`
	URL          string     `json:"url"`
	Scroll       [2]float64 `json:"scroll"`
}

type Take struct {
	ID  string
	Dir string
	// contains filtered or unexported fields
}

type TakeManifest struct {
	ID          string           `json:"id"`
	URL         string           `json:"url"`
	StartedAt   int64            `json:"started_at"`
	EndedAt     int64            `json:"ended_at"`
	DurationMs  int64            `json:"duration_ms"`
	EndReason   string           `json:"end_reason"`
	Settled     bool             `json:"settled"`
	Dropped     int              `json:"dropped"`
	Frames      []FrameInfo      `json:"frames"`
	Keyframes   []string         `json:"keyframes"`
	Marks       []TakeMark       `json:"marks"`
	Network     []networkEvent   `json:"network"`
	Navigations []TakeNavigation `json:"navigations"`
	Warnings    []string         `json:"warnings,omitempty"`
	Discarded   bool             `json:"discarded,omitempty"`
}

type TakeMark struct {
	T       int64          `json:"t"`
	Seq     int64          `json:"seq"`
	Event   string         `json:"event"`
	Dir     string         `json:"dir"`
	Payload map[string]any `json:"payload"`
}

type TakeNavigation struct {
	T int64 `json:"t"`
}