[suiramdev]

Summary

Every Kubai icon inside a control now animates from the control: hovering or focusing the whole button plays it, and a real change to the button's toggled ARIA state (aria-pressed, -checked, -selected, -expanded, -current) plays it once. Start with HostAnimatedKubaiIcon in apps/web/src/shared/lib/kubai-icon.tsx.

Motivation

• Icons only moved when the pointer was over the glyph itself, so most hovers on a button showed nothing.
• Toggling a control (navigating, picking a theme) gave the icon no feedback.

Drawbacks

• The 460 ms motion length is copied from kubai-icons, which does not export it.
• Losing a toggled state also plays the icon, so the row being left animates too.

Prior art

• The library's trigger="parent" binds hover only and needs a data-kubai-trigger attribute on hosts inside vendored @freenary/ui primitives; rejected in favour of driving its controlled hover prop.

Notes

• Visual change: icon motion on button hover, focus and toggle.
• No tests added; verified in the browser on the login page's Theme button.
• apps/fumadocs: none — no page describes icon motion. docs/engineering/web-ui.md and apps/web/AGENTS.md updated.