html

type AbbrConfig struct {
	Title      string // required: full expansion
	Class      string
	ID         string
	ExtraAttrs Attrs
}

type ArticleConfig struct {
	Class      string
	ID         string
	ExtraAttrs Attrs
}

type AsideConfig struct {
	Label      string // required → aria-label
	LabelledBy string // alternative → aria-labelledby
	Class      string
	ID         string
	ExtraAttrs Attrs
}

type Attrs = map[string]string

type AudioConfig struct {
	Class      string
	ID         string
	ExtraAttrs Attrs
}

type ButtonConfig struct {
	Label      string // required → text content AND aria-label
	Type       string // defaults to "button"
	Class      string
	ID         string
	ExtraAttrs Attrs
}

type ButtonGroupConfig struct {
	AriaLabel  string
	Class      string
	ID         string
	ExtraAttrs Attrs
}

type CaptionConfig struct {
	Class      string
	ID         string
	ExtraAttrs Attrs
}

type CheckboxConfig struct {
	Name       string // required
	Value      string // optional
	ID         string // optional (but strongly recommended for label association)
	Checked    bool   // optional
	Class      string
	ExtraAttrs Attrs
}

type DetailsConfig struct {
	Class      string
	ID         string
	ExtraAttrs Attrs
	// Disclosure marks this details element as a dismissible disclosure
	// (mobile hamburger nav, popover, etc.). The runtime will close it
	// automatically on SPA navigation and on Escape. See ARCHITECTURE.md
	// data-fui-disclosure.
	Disclosure bool
	// Open opens the details element on initial render.
	Open bool
}

type DivConfig struct {
	Class      string
	ID         string
	Role       string
	AriaLabel  string
	ExtraAttrs Attrs // passthrough for any extra attributes
}

type FieldSetConfig struct {
	Legend     string // required: becomes <legend> text
	Class      string
	ID         string
	ExtraAttrs Attrs
}

type FigCaptionConfig struct {
	Class      string
	ID         string
	ExtraAttrs Attrs
}

type FigureConfig struct {
	Class      string
	ID         string
	ExtraAttrs Attrs
}

type FooterConfig struct {
	Class       string
	ID          string
	ExtraAttrs  Attrs
	ContentInfo bool // explicit opt-in for role="contentinfo"
}

type FormConfig struct {
	Method     string // required: "GET" or "POST"
	Action     string // optional: form action URL
	Class      string
	ID         string
	ExtraAttrs Attrs
}

type GroupConfig struct {
	Role       string // required
	AriaLabel  string
	Class      string
	ID         string
	ExtraAttrs Attrs
}

type HeaderConfig struct {
	Class      string
	ID         string
	ExtraAttrs Attrs
	Banner     bool // explicit opt-in for role="banner"
}

type HeadingConfig struct {
	Level      int // required: 1-6
	Class      string
	ID         string
	ExtraAttrs Attrs
}

type ImageConfig struct {
	Src        string // required
	Alt        string // required (empty = decorative image)
	Class      string
	ID         string
	ExtraAttrs Attrs
}

type InputConfig struct {
	Type        string // required: "text", "email", "password", etc.
	Name        string // required: form field name
	Value       string // optional: initial value (typed equivalent of Attrs{"value": ...})
	Placeholder string // optional: placeholder text
	Class       string
	ID          string
	ExtraAttrs  Attrs // escape hatch for attributes not covered by typed fields
}

type LabelConfig struct {
	For        string // required: ID of the associated form control
	Text       string // required: label text
	Class      string
	ID         string
	ExtraAttrs Attrs
}

type LinkConfig struct {
	Href       string // required
	Text       string // required (visible text content)
	Class      string
	ID         string
	ExtraAttrs Attrs
}

type LinkHTMLConfig struct {
	Href       string      // required
	Content    render.HTML // required (raw HTML content)
	Class      string
	ID         string
	ExtraAttrs Attrs
}

type ListConfig struct {
	Class      string
	ID         string
	ExtraAttrs Attrs
}

type ListItemConfig struct {
	Class      string
	ID         string
	ExtraAttrs Attrs
}

type MainConfig struct {
	Class      string
	ID         string
	ExtraAttrs Attrs
}

type NavConfig struct {
	Label      string // required → aria-label
	LabelledBy string // alternative → aria-labelledby
	Class      string
	ID         string
	ExtraAttrs Attrs
}

type RadioConfig struct {
	Name       string // required
	Value      string // required
	ID         string // optional (but strongly recommended)
	Checked    bool   // optional
	Class      string
	ExtraAttrs Attrs
}

type SectionConfig struct {
	Label      string // required → aria-label
	LabelledBy string // alternative → aria-labelledby
	Class      string
	ID         string
	ExtraAttrs Attrs
}

type SelectConfig struct {
	Name       string         // required: form field name
	Options    []SelectOption // required: at least one option
	Class      string
	ID         string
	ExtraAttrs Attrs
}

type SelectOption struct {
	Value    string
	Text     string
	Selected bool
}

type SourceConfig struct {
	Src        string // required
	Type       string // required: MIME type
	Class      string
	ID         string
	ExtraAttrs Attrs
}

type SummaryConfig struct {
	Class      string
	ID         string
	ExtraAttrs Attrs
}

type TDConfig struct {
	Class      string
	ID         string
	ExtraAttrs Attrs
}

type THConfig struct {
	Scope      string // defaults to "col"
	Class      string
	ID         string
	ExtraAttrs Attrs
}

type TableConfig struct {
	Class      string
	ID         string
	ExtraAttrs Attrs
}

type TableRowConfig struct {
	Class      string
	ID         string
	ExtraAttrs Attrs
}

type TableSectionConfig struct {
	Class      string
	ID         string
	ExtraAttrs Attrs
}

type TextAreaConfig struct {
	Name        string // required: form field name
	Content     string // optional: initial text content (HTML-escaped on render)
	Placeholder string // optional: placeholder text
	Rows        int    // optional: rows attribute (>0 only)
	Cols        int    // optional: cols attribute (>0 only)
	Class       string
	ID          string
	ExtraAttrs  Attrs // escape hatch for attributes not covered by typed fields
}

type TextConfig struct {
	Class      string
	ID         string
	ExtraAttrs Attrs
}

type TimeConfig struct {
	Datetime   string // required: machine-readable datetime
	Class      string
	ID         string
	ExtraAttrs Attrs
}

type VideoConfig struct {
	Class      string
	ID         string
	ExtraAttrs Attrs
}