a11y

const (
	// ActionClick performs the default action for the element.
	// For buttons this triggers activation; for links this navigates.
	ActionClick Action = iota + 1

	// ActionFocus moves keyboard focus to the element.
	ActionFocus

	// ActionBlur removes keyboard focus from the element.
	ActionBlur

	// ActionSetValue sets the element's value.
	// This is used for text fields, sliders, and other value-bearing controls.
	ActionSetValue

	// ActionIncrement increases the element's value by one step.
	// This is used for sliders, spin buttons, and similar controls.
	ActionIncrement

	// ActionDecrement decreases the element's value by one step.
	// This is used for sliders, spin buttons, and similar controls.
	ActionDecrement

	// ActionExpand expands a collapsible element.
	// This is used for tree items, disclosure triangles, and similar controls.
	ActionExpand

	// ActionCollapse collapses an expanded element.
	// This is used for tree items, disclosure triangles, and similar controls.
	ActionCollapse

	// ActionSelect selects the element within its container.
	// This is used for list items, tabs, and similar selectable elements.
	ActionSelect

	// ActionScrollIntoView scrolls the element into the visible area
	// of its scroll container.
	ActionScrollIntoView

	// ActionScrollUp scrolls the content upward.
	ActionScrollUp

	// ActionScrollDown scrolls the content downward.
	ActionScrollDown

	// ActionScrollLeft scrolls the content to the left.
	ActionScrollLeft

	// ActionScrollRight scrolls the content to the right.
	ActionScrollRight

	// ActionShowContextMenu opens the element's context menu.
	ActionShowContextMenu

	// ActionDismiss dismisses a transient element such as a tooltip,
	// dialog, or popup menu.
	ActionDismiss
)

const (
	// CheckedFalse indicates the control is not checked.
	CheckedFalse CheckedState = iota

	// CheckedTrue indicates the control is checked.
	CheckedTrue

	// CheckedMixed indicates the control is in a mixed/indeterminate state.
	// This is used when a checkbox represents a group where some items
	// are checked and some are not.
	CheckedMixed
)

const (
	// PriorityLow indicates the announcement can wait until the screen reader
	// finishes its current speech. This is appropriate for non-urgent status
	// updates (equivalent to ARIA aria-live="polite").
	PriorityLow Priority = iota

	// PriorityHigh indicates the announcement should interrupt current speech.
	// This is appropriate for urgent messages like errors or alerts
	// (equivalent to ARIA aria-live="assertive").
	PriorityHigh
)

const (
	// RoleUnknown indicates an element whose role is not known.
	// This should only be used as a fallback when no other role applies.
	RoleUnknown Role = iota

	// RoleWindow represents a top-level application window.
	RoleWindow

	// RoleGroup represents a generic grouping of related elements.
	RoleGroup

	// RoleSeparator represents a visual or logical divider between sections.
	RoleSeparator

	// RoleToolbar represents a collection of commonly used function buttons
	// or controls.
	RoleToolbar

	// RoleStatusBar represents a bar that displays status information,
	// typically at the bottom of a window.
	RoleStatusBar

	// RoleMenuBar represents a horizontal bar containing menu items.
	RoleMenuBar

	// RoleGenericContainer represents a container with no specific semantics.
	// Use [RoleGroup] instead when elements are logically related.
	RoleGenericContainer
)

const (
	// RoleButton represents a clickable button that triggers an action.
	RoleButton Role = iota + 20

	// RoleCheckbox represents a control with checked, unchecked, or mixed state.
	RoleCheckbox

	// RoleRadio represents a radio button within a group where only one
	// can be selected at a time.
	RoleRadio

	// RoleTextField represents a single-line text input field.
	RoleTextField

	// RoleTextArea represents a multi-line text input field.
	RoleTextArea

	// RoleSlider represents a control for selecting a value from a continuous range.
	RoleSlider

	// RoleSwitch represents a toggle control with on/off state.
	RoleSwitch

	// RoleComboBox represents a composite widget combining a text field with
	// a popup list of choices.
	RoleComboBox

	// RoleSpinButton represents a numeric input with increment/decrement controls.
	RoleSpinButton

	// RoleRadioGroup represents a group of radio buttons where only one
	// can be selected.
	RoleRadioGroup

	// RoleSearchBox represents a text field specifically for search input.
	RoleSearchBox

	// RoleToggleButton represents a button that can be toggled on or off.
	RoleToggleButton

	// RoleColorWell represents a control for selecting a color value.
	RoleColorWell
)

const (
	// RoleLabel represents a text label, often associated with a form control.
	RoleLabel Role = iota + 50

	// RoleImage represents a graphical image.
	RoleImage

	// RoleProgressBar represents a progress indicator showing completion
	// of a long-running operation.
	RoleProgressBar

	// RoleTooltip represents a small popup that provides additional context
	// when hovering over an element.
	RoleTooltip

	// RoleAlert represents an important message that demands the user's attention.
	RoleAlert

	// RoleBadge represents a small status descriptor, such as a notification count.
	RoleBadge

	// RoleHeading represents a heading that labels a section of content.
	RoleHeading

	// RoleMeter represents a scalar measurement within a known range,
	// such as disk usage or a gauge.
	RoleMeter

	// RoleStaticText represents non-interactive text content.
	RoleStaticText
)

const (
	// RoleDialog represents a modal or non-modal dialog window.
	RoleDialog Role = iota + 70

	// RoleAlertDialog represents a dialog that conveys an urgent message
	// and requires user response.
	RoleAlertDialog

	// RoleMenu represents a popup menu offering a list of choices.
	RoleMenu

	// RoleMenuItem represents a single item within a menu.
	RoleMenuItem

	// RoleMenuItemCheckbox represents a checkable menu item.
	RoleMenuItemCheckbox

	// RoleMenuItemRadio represents a radio-selectable menu item within a group.
	RoleMenuItemRadio

	// RoleList represents an ordered or unordered list of items.
	RoleList

	// RoleListItem represents a single item within a list.
	RoleListItem

	// RoleTree represents a hierarchical tree view.
	RoleTree

	// RoleTreeItem represents a single item within a tree view.
	RoleTreeItem

	// RoleTab represents a selectable tab within a tab list.
	RoleTab

	// RoleTabList represents a list of tabs for switching between panels.
	RoleTabList

	// RoleTabPanel represents the content panel associated with a tab.
	RoleTabPanel

	// RoleGrid represents a two-dimensional grid of interactive cells.
	RoleGrid

	// RoleGridCell represents a single cell within a grid.
	RoleGridCell

	// RoleTable represents a data table with rows and columns.
	RoleTable

	// RoleRow represents a row within a table or grid.
	RoleRow

	// RoleCell represents a single cell within a table row.
	RoleCell

	// RoleColumnHeader represents a header cell for a table column.
	RoleColumnHeader

	// RoleRowHeader represents a header cell for a table row.
	RoleRowHeader

	// RoleListBox represents a list widget from which the user can select
	// one or more items.
	RoleListBox

	// RoleScrollView represents a scrollable container.
	RoleScrollView

	// RoleApplication represents a region declared as a web application
	// (used for complex interactive widgets).
	RoleApplication

	// RoleDocument represents a document content region.
	RoleDocument

	// RoleFeed represents a scrollable list of articles that grows dynamically.
	RoleFeed
)

const (
	// RoleLink represents a navigational hyperlink.
	RoleLink Role = iota + 110

	// RoleScrollBar represents a scrollbar control.
	RoleScrollBar

	// RoleNavigation represents a navigation landmark region.
	RoleNavigation

	// RoleBanner represents a banner landmark region, typically site-wide.
	RoleBanner

	// RoleMain represents the main content landmark region.
	RoleMain

	// RoleContentInfo represents informational content about the page,
	// typically a footer.
	RoleContentInfo

	// RoleComplementary represents a complementary landmark region
	// that supports the main content.
	RoleComplementary

	// RoleRegion represents a generic landmark region of significance.
	RoleRegion

	// RoleForm represents a form landmark region.
	RoleForm

	// RoleSearch represents a search landmark region.
	RoleSearch
)