UI Headless Runtime
Behavioral infrastructure for interfaces you own. This documentation covers the architecture, accessibility contracts, framework integration, packaging, and release operations for the headless TypeScript runtime.
UI Headless Runtime exposes typed controllers with immutable state and DOM bindings without shipping markup, CSS, or framework adapters. The public laboratory uses those same package exports and shows live state, real events, executed source, keyboard behavior, and consumer accessibility responsibilities.
Start here
- User Guide for installation, controllers, rendering, state, DOM binding, SSR, and testing.
- Component contracts for component-specific options, state, commands, keyboard behavior, focus, and limitations.
- Architecture overview for shared state, lifecycle, focus, collections, overlays, positioning, and cleanup.
- Framework integration for the shared lifecycle and CSS/accessibility ownership boundary.
- Consumer-side recipes for React, Vue, and Angular, without official adapters or framework dependencies in the runtime package.
- Standalone npm consumer source that independently builds React, Vue, and Angular integrations without turning them into adapters.
- Demo and documentation accessibility conformance for scope, checks, limitations, and the WCAG 2.2 AA applicable-criteria target.
Public surfaces
Quality model
The repository gates strict TypeScript, formatting, linting, unused-code checks, unit coverage, real-browser integration, cross-browser production E2E, axe plus manual accessibility assertions, API reports, generated documentation, package consumers, and the composed GitHub Pages artifact.
The runtime provides accessibility behavior primitives. The published demo and generated documentation are designed and tested against applicable WCAG 2.2 AA criteria. Final consumer conformance still depends on the rendered product's markup, labels, content, styling, layout, and assistive-technology validation.