vnc

type DepsResult struct {
	// Available is true when all required binaries are present and the platform
	// is supported. Only when Available is true will New() return a live manager.
	Available bool
	// Missing lists the names of binaries that could not be found via LookPath.
	Missing []string
	// Reason is a human-readable explanation when Available is false.
	Reason string
}

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

type VNCConfig struct {
	// DisplayBase is the first X11 display number to try allocating (e.g. 100).
	DisplayBase int
	// DisplayRangeMax is the number of display numbers to search above DisplayBase.
	// Displays DisplayBase through DisplayBase+DisplayRangeMax-1 are candidates.
	DisplayRangeMax int
	// Resolution is the Xvfb screen resolution string, e.g. "1280x800x24".
	Resolution string
	// MaxRestarts is the maximum number of x11vnc crash-restart attempts before
	// the manager sets VNCStatusUnavailable. Default 3.
	MaxRestarts int
	// SessionID is the identifier of the owning session; used by DisplayAllocator
	// to associate the display lock with a specific session.
	SessionID string
}

type VNCProcessManager interface {
	// StartDisplay allocates an X11 display number and starts Xvfb.
	// Call this BEFORE the tmux session is created so DISPLAY can be injected
	// at new-session time via ExtraEnv. Returns 0 (no-op) on unsupported platforms.
	StartDisplay(ctx context.Context) error

	// StartServer starts x11vnc and the window tracker goroutine.
	// Call this AFTER the tmux session is live.
	StartServer(ctx context.Context) error

	// Stop tears down x11vnc and Xvfb and releases the display number.
	// Safe to call if Start was never called or already stopped.
	Stop()
	// State returns a snapshot of the current VNC state.
	State() VNCState
	// DisplayNumber returns the allocated X11 display number (e.g. 100 for :100).
	// Returns 0 if no display has been allocated.
	DisplayNumber() int
	// DisplayEnv returns the DISPLAY environment variable assignment for this
	// session's display, e.g. "DISPLAY=:101" or "DISPLAY=:0". Returns "" if no
	// display is available. Prefer this over DisplayNumber for env injection.
	DisplayEnv() string
	// Port returns the localhost TCP port on which x11vnc is listening.
	// Returns 0 if x11vnc is not running.
	Port() int
	// SetStateChangeCallback registers a callback that is invoked (in a goroutine)
	// each time the VNC state changes. Replaces any previously registered callback.
	SetStateChangeCallback(func(VNCState))
	// ReconcileOrphans scans X11 lock files in the allocator's range and removes
	// stale locks left behind by crashed processes from a previous run.
	ReconcileOrphans()
}

type VNCState struct {
	// Status is the current operational status.
	Status VNCStatus
	// DisplayNumber is the allocated X11 display number (e.g. 100 for :100).
	// Zero if no display has been allocated.
	DisplayNumber int
	// Port is the localhost TCP port that x11vnc is listening on.
	// Zero if x11vnc is not running.
	Port int
	// BrowserWindowDetected is true when a browser window has been found on the
	// virtual display and x11vnc has been restarted in -id mode targeting it.
	BrowserWindowDetected bool
}

type VNCStatus int

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