forms

type FilterBarProps struct {
	utils.BaseProps

	// Action is the list-page URL: the form's GET action (the no-JS
	// fallback), the Reset link target, and — when Wire is unset — the
	// auto-submit fetch URL. An empty Action renders an unwired form
	// (inert bar; useful for pure-CSS composition).
	Action string
	// Wire, when set with a non-empty URL, owns the auto-submit wiring in
	// both dialects. Defaults applied by the component: the change event
	// plus form encoding, so every filter field in the form serializes.
	// Target/PushURL render for htmx only; Datastar targeting is
	// response-driven — wrap the handler in wire.Handler.
	Wire *wire.Action
	// Target is the results-region selector the response swaps into
	// (htmx hx-target). Empty leaves htmx's default (the form itself).
	Target string
	// Sticky renders the top-anchored shell (sticky top-0, z-20, border,
	// solid background) — the pattern for bars above long result lists.
	Sticky bool
	// ResetText renders a ghost Reset link to the unfiltered Action URL
	// when non-empty ("Reset" via DefaultFilterBarProps).
	ResetText string
	// NoPushURL opts out of pushing the filtered URL (the zero value
	// pushes, so filtered views are shareable — the list-page convention;
	// htmx dialect only).
	NoPushURL bool
}

type FilterChip struct {
	// Label is the visible chip text.
	Label string
	// Href is the link target carrying the chip's filter state.
	Href string
	// Active marks the currently applied filter. The active chip renders
	// aria-current="true" and the filled style; keeping the link (like the
	// extraction source) is honest about the current state.
	Active bool
}

type FilterChipsProps struct {
	utils.BaseProps

	// Chips renders left to right. Provide an "All" chip (empty-value href)
	// so users can clear the filter without JavaScript.
	Chips []FilterChip
}

type SegmentedControlItem struct {
	// Label is the visible text.
	Label string
	// Value is the option's submitted value (radio mode).
	Value string
	// Href, when set on ANY item, switches the whole control to link mode —
	// every item should carry one (a mixed control is a consumer bug;
	// items without an Href render inert links in link mode).
	Href string
}

type SegmentedControlProps struct {
	utils.BaseProps

	// Name is the radio group's field name (radio mode). Ignored in link
	// mode.
	Name string
	// Items render in FORWARD DOM order (first item first) so radiogroup
	// arrow keys move down the value order (the Rating rule).
	Items []SegmentedControlItem
	// ActiveValue marks the selected item: the checked radio (radio mode)
	// or aria-current link (link mode).
	ActiveValue string
}