Preview controls could not be applied. The static default fixture remains available.
§01
Contract
Semantics first
Anatomy
Uses the native select and option elements so platform keyboard, mobile picker, and form behavior remain intact.
Consumer classes, styles, and data attributes may extend the surface, but required roles, IDs, relationships, and handlers remain owned by the component.
Keyboard
Tab focuses the select.
Arrow keys and type selection follow the browser and platform contract.
Alt+Arrow or Space may open the platform picker according to the browser.
§02
Public surface
API & styling
Props
id
Explicit IDs override stable generated IDs.
class / style
Consumer additions compose with required styles.
ref
Element or callback where focus control is expected.
children
Typed content; raw HTML strings are never rendered.
Slots & events
children
Primary content slot.
onChange
Typed value plus a small reason object when state changes.
There is no stable predecessor for this explicit compiled subpath. The v1 compatibility layer remains tested separately; visual and API diffs begin with the next prerelease.