accessibility

type Accessible interface {
	// Identity
	AccessibleRole() Role
	AccessibleLabel() string
	AccessibleDescription() string
	AccessibleState() StateSet
	AccessibleValue() *ValueInfo

	// Live regions — mirrors aria-live, aria-relevant, aria-atomic
	AccessibleLive() Live
	AccessibleRelevant() Relevant
	AccessibleAtomic() bool

	// Landmarks — mirrors ARIA landmark roles
	AccessibleLandmark() Landmark

	// Relationships — mirrors aria-labelledby, aria-describedby, aria-controls, aria-owns, aria-flowto
	AccessibleLabelledBy() string
	AccessibleDescribedBy() string
	AccessibleControls() string
	AccessibleOwns() string
	AccessibleFlowTo() string

	// WAI-ARIA 1.2/1.3 properties
	AccessibleLevel() int
	AccessibleOrientation() string
	AccessibleActiveDescendant() string
	AccessiblePosInSet() int
	AccessibleSetSize() int
	AccessibleHasPopup() string
	AccessibleErrorMessage() string
	AccessibleCurrent() string
	AccessibleAutocomplete() string
	AccessiblePlaceholder() string
	AccessibleSort() string
	AccessibleKeyShortcuts() string
	AccessibleDetails() string
	AccessibleRoleDescription() string
}

type Announcement struct {
	Message  string
	Priority Priority
}

type Announcer interface {
	Announce(message string, priority Priority)
	AnnounceChange(widget Accessible)
}

type Base struct {
	Role        Role
	Label       string
	Description string
	State       StateSet
	Value       *ValueInfo

	// Live region behavior (aria-live, aria-relevant, aria-atomic)
	Live     Live
	Relevant Relevant
	Atomic   bool

	// Relationships (aria-labelledby, aria-describedby, aria-controls, aria-owns, aria-flowto)
	LabelledBy  string
	DescribedBy string
	Controls    string
	Owns        string
	FlowTo      string

	// Landmark (aria landmark roles)
	Landmark Landmark

	// WAI-ARIA 1.2/1.3 properties
	Level            int    // aria-level (heading level, tree depth)
	Orientation      string // aria-orientation (horizontal/vertical)
	ActiveDescendant string // aria-activedescendant (ID of focused descendant)
	PosInSet         int    // aria-posinset (position in set, 1-based)
	SetSize          int    // aria-setsize (total items in set)
	HasPopup         string // aria-haspopup (false/true/menu/listbox/tree/grid/dialog)
	ErrorMessage     string // aria-errormessage (ID of error element)
	Current          string // aria-current (page/step/location/date/time/true)
	Autocomplete     string // aria-autocomplete (inline/list/both/none)
	Placeholder      string // aria-placeholder
	Sort             string // aria-sort (ascending/descending/none/other)
	KeyShortcuts     string // aria-keyshortcuts
	Details          string // aria-details (ID of detailed description)
	RoleDescription  string // aria-roledescription (custom role label for AT)
}

type Bridge interface {
	// Register connects the application to the platform accessibility system.
	// The app parameter provides access to the widget tree.
	Register(app BridgeApp) error

	// Announce sends text to the screen reader.
	// Priority controls whether the message interrupts current speech.
	Announce(text string, priority Priority) error

	// UpdateTree notifies the screen reader that the widget structure changed.
	// Call this after layout changes.
	UpdateTree() error

	// NotifyFocusChange informs the screen reader that focus moved to a new widget.
	NotifyFocusChange(widget Accessible) error

	// NotifyValueChange informs the screen reader that a widget's value changed.
	// For text inputs, sliders, progress bars, etc.
	NotifyValueChange(widget Accessible, oldValue, newValue string) error

	// NotifyStateChange informs the screen reader that a widget's state changed.
	// For checkboxes, expandable items, etc.
	NotifyStateChange(widget Accessible, state string, value bool) error

	// Close disconnects from the platform accessibility system.
	Close() error
}

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

type BridgeApp interface {
	// Name returns the application name.
	Name() string

	// RootAccessible returns the root accessible element.
	RootAccessible() Accessible

	// FocusedAccessible returns the currently focused element.
	FocusedAccessible() Accessible

	// AccessibleAt returns the accessible at the given path.
	// Path is a slash-separated list of indices from root.
	AccessibleAt(path string) Accessible

	// ChildAccessibles returns the children of the given accessible.
	ChildAccessibles(parent Accessible) []Accessible
}

type FocusStyle struct {
	Indicator    string
	Style        backend.Style
	HighContrast backend.Style
}

type Landmark string

type Live string

type Priority int

type Relevant string

type Role string

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

type Speaker interface {
	// Speak sends text to the TTS engine. It blocks until speech completes
	// or ctx is cancelled.
	Speak(ctx context.Context, text string) error

	// Stop cancels any in-progress speech.
	Stop() error

	// Close releases TTS resources.
	Close() error
}

type StateSet struct {
	Checked         *bool // nil = not applicable
	Expanded        *bool
	Pressed         *bool // nil = not applicable (tri-state, for toggle buttons)
	Selected        bool
	Disabled        bool
	ReadOnly        bool
	Required        bool
	Invalid         bool
	Hidden          bool
	Busy            bool
	Modal           bool
	Multiline       bool // aria-multiline
	Multiselectable bool // aria-multiselectable
}

type ValueInfo struct {
	Min     float64
	Max     float64
	Current float64
	Text    string
}