@zakkster/lite-ui-fx 1.6.0 → 1.8.0

package/CHANGELOG.md

@@ -5,6 +5,85 @@ All notable changes to `@zakkster/lite-ui-fx` are documented here.
 The format follows Keep a Changelog; this project adheres to Semantic
 Versioning.
 
+## [1.8.0] -- 2026-09-07
+
+Documentation and demo (roadmap U6). No API, recipe, or behaviour change: the
+module code (`UIFXController.js`, `UIFXRecipes.js`) is byte-identical to 1.7.0.
+Closes finding U-12 (demos that reimplemented the library inline).
+
+### Added
+
+- `README.md` rewritten on the LiteSepforge blueprint spine: positioning H2 with
+  a runnable quick-start, table of contents, why/what-you-get, a mount-modes
+  deep-dive, an API reference with UIType/state/`RECIPE_META` constant tables, a
+  composability example, a zero-GC allocation table carrying the gated torture
+  GATE line, design-decision links, testing, what-this-is-not, ecosystem. Size
+  claims are measured (controller ~5.2 KB min+gzip, catalog of 56 recipes ~24 KB).
+- `demo/index.html`: one demo that consumes the package. It imports only the
+  public `.` and `./recipes` entry points and generates the gallery from
+  `RECIPE_META`, mounting each recipe by its declared type. Includes a theme
+  switcher, a reduced-motion toggle, and a `#profile` forced-reflow hook
+  (dev-only, dormant unless the URL carries `#profile`; a full drive of the hot
+  paths reports `violationCount 0`).
+- `test/docs.test.mjs`: an executable doc gate. It extracts every fenced js block
+  in `README.md`, rewrites the package specifiers to the local files, and imports
+  each under the DOM stub, so a drifted example fails CI; a control block with a
+  bad import name proves the gate can fail. The suite is now 205 node:test cases
+  across 18 suites.
+- `decisions/0006-docs-and-demo.md`.
+
+### Removed
+
+- The three inline demo pages (`demo/demo-lite-ui-fx.html`,
+  `demo/demo-lite-uifx-vol2.html`, `demo/demo-lite-uifx-vol3.html`) that
+  reimplemented the controller and recipes inline (U-12), replaced by the single
+  consuming `demo/index.html`.
+- The README's three CodePen "Live Demo" links and the competitor-size comparison
+  table (unmeasured claims; the shipped demo is the showcase).
+
+## [1.7.0] -- 2026-09-07
+
+Host integration (roadmap U5). Two host-clock modes plus reduced-motion and a
+frame-budget signal, applied to BOTH mount modes (`mountUIFX` and `decorateUIFX`).
+Additive: a default mount is byte-identical to 1.6.0.
+
+### Added
+
+- `{ ticker }` mount option (both modes): a caller-supplied ticker
+  (`{ add(fn) -> removeFn }`, e.g. `@zakkster/lite-ticker`) drives the component
+  instead of the shared ref-counted ticker. `destroy()` unregisters the
+  component's frame but never destroys the caller's ticker (ownership stays with
+  the caller).
+- `{ driven: true }` mount option (both modes): no ticker and no RAF; the host
+  drives each frame via `instance.tick(dtMs)`. `instance.tick` is the internal
+  frame body in driven mode and throws otherwise. `{ ticker }` and `{ driven }`
+  are mutually exclusive; a non-boolean `driven` or a ticker without `.add()`
+  throws at mount.
+- `state.reducedMotion` (both modes): read from
+  `matchMedia('(prefers-reduced-motion: reduce)')` before `recipe.init` and
+  watched via the AbortController; absent `matchMedia` is a no-op (stays `false`).
+  Calm paths for six recipes -- `SwarmToggle`, `PasswordStrength`,
+  `TypewriterField`, `FocusHalo`, `ErrorShake`, `SuccessBloom`: under reduced
+  motion `ErrorShake` stops displacing, `SuccessBloom` spawns no particles, and
+  `SwarmToggle` rests its particles at formation.
+- `state.budget` (0..1, both modes): a per-frame frame-budget number (1 at
+  ~60fps, lower as frames lengthen), computed in place with no allocation, for
+  budget-aware recipes to shed work.
+- `mountRecipe` emits a `console.warn` (not a throw) when mounting a
+  `motionSafe:false` recipe while the user prefers reduced motion.
+- TypeScript: `HostTicker`, `HostClockOptions`, `state.reducedMotion` /
+  `state.budget`, and `instance.tick(dtMs)` on both instance types.
+- `decisions/0005-host-clock.md`. U5 coverage: t5 caller-ticker ownership +
+  driven determinism, t3 reduced-motion churn, and two t9 controls (`fake-calm`,
+  `ticker-ownership`). 177 -> 196 node:test tests; 5 -> 7 torture controls.
+
+### Changed
+
+- The per-mount frame loop is one named function shared by all three clock modes;
+  the default (shared-ticker) path is byte-identical to 1.6.0.
+- `RECIPE_META.motionSafe` is now `true` for six recipes (previously `false` for
+  all 56): it marks exactly the recipes that ship a reduced-motion calm path.
+
 ## [1.6.0] -- 2026-09-07
 
 Decorate mode (U4b, the second half of roadmap U4). A second public mount mode