Learn / UI architecture
Status (2026-10-07)
- Anatomy: 23 slot contracts published, 22 with catalog patterns (the
exception is
HoverIntent, a timing behavior without an ARIA contract). No adapter hides slots yet — none has internal-only parts;hiddenwaits for the first one. - Capabilities: frozen at the seven above. Proposals like
CollectionItem,OverlayTrigger, orFormControlreturn when a behavior requires them. - The a11y gate runs in CI (
patterns.test.ts); every catalog entry names a tier and at least one role. - Representative widgets (Combobox, Menu, Tree, Field, Drawer) arrive via the adapter + fork work already landed, not as bespoke state machines.
- Styles/recipes (Phase 3):
design.tsshared pieces, anatomy-checkedrecipeFor,.extend+ partial selection,forCapability. Themes (Phase 4): values with density/radius/motion/contrast knobs (the control-size knob stays open: no height scale exists yet). Floor/gate (Phase 5): metadata + CI gate. - Component coverage past that follows the capability matrix, not a checklist: fill a missing capability and a family of widgets gets cheap.
Where to read next
- Mixins guide — Slot / Style / Behavior mental model.
foldkit-mixins-ui— the adapters, the fork policy, and the supported-components table.