fret-ui-headless

Headless interaction policies and primitives for Fret UI composition.

This crate contains deterministic state machines and small reusable helpers that can be shared across UI kits and component ecosystems, without depending on fret-ui rendering/theme details.

Status

Experimental learning project (not production-ready).

Examples of what lives here

• roving focus + typeahead
• menu navigation
• presence/transition helpers
• hover intent / tooltip delay groups
• table helpers and small layout-adjacent utilities

Upstream references (non-normative)

Some modules in this crate intentionally port or align with upstream interaction engines for behavioral parity:

• cmdk (command palette scoring + selection math): https://github.com/pacocoursey/cmdk
  • See src/cmdk_score.rs and src/cmdk_selection.rs.
• Floating UI (safe hover corridor inspiration): https://github.com/floating-ui/floating-ui
  • See src/safe_hover.rs (inspired by Floating UI's safePolygon idea).
• Flutter (physics/motion primitives): https://github.com/flutter/flutter
  • See src/motion/* (spring/friction/tolerance shapes).
• Embla Carousel (carousel behavior): https://github.com/davidjerleke/embla-carousel
  • See src/embla/*.

See docs/reference-stack-ui-behavior.md for repo-level guidance on which upstream references are used for which behavior classes.