use-scroll-animate 7.6.0 → 7.8.0

package/CHANGELOG.md

@@ -7,6 +7,33 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [7.8.0] - 2026-10-08
+
+### Added
+- **3 new components (7.8)** in `motionary/components/widgets` (also in `dist/widgets.umd.js`):
+  - `<usa-chat-composer>` — AI chat input: the textarea grows with its text (up to `rows`, default 6), Enter sends / Shift+Enter new line, the send button pops when there is text and morphs into Stop while `busy`, when a conic "thinking" glow runs round the composer. `usa:send` { text } (cancelable), `usa:stop`; `placeholder`, `label`, `value`, `busy`, `send()`, `clear()`.
+  - `<usa-suggestion-chips>` — follow-up prompt chips from `items="a|b|c"` (or child elements): slide in one after another, picking pulses the chip and emits `usa:pick` { text, index }; `dismiss` fades the others; `setItems()` / `items`; arrow keys. `parseChips()`.
+  - `<usa-voice-button>` — push-to-talk mic: toggles `listening` (`usa:start` / `usa:stop`), a halo breathes and `bars` (3–9) wave; set `level` (0–1) from an analyser / speech API and both follow it. `toggle()`; `waveBars()`.
+- **AI UI motion — `motionary/fx/ai`** (= `motionary/components/fx-ai`, `registerAiPack()`, also in `registerEffectPacks()`): `stream-text` (enter), `thinking-glow` (loop), `voice-wave` (attention), `gen-skeleton` (enter). `splitWords()`.
+- Showcase: 5 new gallery cards with copyable code, live demos and live Store thumbnails; Animation Store 326 → 331 items.
+
+### Accessibility
+- Composer: labelled textarea, the button's `aria-label` switches Send ↔ Stop generating. Chips: labelled list of real buttons, arrow-key navigation, dismissed chips are disabled. Voice button: a real `<button aria-pressed>`. `stream-text` restores the original text nodes when it finishes (screen readers read the full text). Reduced motion: no glow, pop, slide, halo or wave; `stream-text` shows the text at once, `thinking-glow` is skipped, `voice-wave` does nothing, `gen-skeleton` fades in.
+
+## [7.7.0] - 2026-10-08
+
+### Added
+- **3 new components (7.7)** in `motionary/components/widgets` (also in `dist/widgets.umd.js`):
+  - `<usa-field>` — animated text input: the `label` floats up on focus / when filled, the underline grows, native validation on blur (`type`, `required`, `pattern`, `minlength`, `maxlength`) — invalid shakes and slides the message in (`usa:invalid`, custom text via `error`), valid draws a check (`usa:valid`); `hint`; `strength` adds a 4-step password meter. The `<input>` is in the light DOM, so forms submit it by `name`. `value`, `validate()`, `input`; `passwordStrength()`.
+  - `<usa-otp>` — one-time-code input: `length` boxes (3–10, default 6), auto-advance, Backspace / arrow keys, paste a whole code, `autocomplete="one-time-code"`, `mode="alnum"`, initial `value`; digits pop in; `usa:complete` { code }; `error(message)` shakes red and clears, `success()` green wave, `fillCode(code)`, `clear()`. `sanitizeCode()`.
+  - `<usa-upload-progress>` — file row: `name`, `size` (bytes), `value` 0–100 (bar eases, shine while uploading), `status` uploading | done | error, `message`; done draws a check (`usa:done`), error shakes + Retry (`usa:error`, `usa:retry`). `formatBytes()`.
+- **Form motion — `motionary/fx/form`** (= `motionary/components/fx-form`, `registerFormPack()`, also in `registerEffectPacks()`): `field-shake` (attention), `field-success` (attention), `label-float` (enter), `form-cascade` (enter). `shakeFrames()`.
+- Showcase: 5 new gallery cards with copyable code, live demos and live Store thumbnails; Animation Store 321 → 326 items.
+- Note: the plan's "success check" ships as `field-success` (the existing `success-check` effect is unchanged).
+
+### Accessibility
+- Field: real `<label for>`, `aria-invalid`, message in an `aria-live` region linked with `aria-describedby`. OTP: labelled `role="group"`, each box labelled "Digit n of N". Upload: `role="progressbar"` with `aria-valuenow` / `aria-valuetext`, a real Retry button. Reduced motion: no shake, pop, wave, shine or easing — states switch at once; `field-shake` / `field-success` only flash the outline, `label-float` / `form-cascade` fade in.
+
 ## [7.6.0] - 2026-10-08
 
 ### Added

package/dist/components/fx-ai.cjs

@@ -0,0 +1,130 @@
+'use strict';
+
+var registry = require('../chunks/registry-DehBVRDV.cjs');
+require('../chunks/base-BaQV-2ha.cjs');
+
+/** Split text into words, keeping the whitespace after each (7.8). */
+function splitWords(text) {
+    return text.match(/\S+\s*|\s+/g) || [];
+}
+const fade = (el, ctx) => ctx.animate(el, [{ opacity: 0 }, { opacity: 1 }], { duration: 250 })?.finished.catch(() => undefined);
+function textNodes(el) {
+    const out = [];
+    const walk = (n) => n.childNodes.forEach((c) => (c.nodeType === 3 ? (c.textContent || '').trim() && out.push(c) : c.nodeType === 1 && walk(c)));
+    walk(el);
+    return out;
+}
+const AI_FX = [
+    {
+        name: 'stream-text',
+        kind: 'enter',
+        description: 'The text appears word by word like a streamed LLM reply, with a blinking caret (`speed` ms per word).',
+        defaults: { speed: 45 },
+        run: (el, o, ctx) => {
+            if (ctx.reduced)
+                return;
+            const speed = Math.max(5, Number(o.speed) || 45);
+            const spans = [];
+            const restores = [];
+            for (const t of textNodes(el)) {
+                const wrap = document.createElement('span');
+                wrap.setAttribute('data-usa-stream', '');
+                for (const w of splitWords(t.textContent || '')) {
+                    const s = document.createElement('span');
+                    s.textContent = w;
+                    s.style.opacity = '0';
+                    wrap.appendChild(s);
+                    spans.push(s);
+                }
+                t.parentNode.replaceChild(wrap, t);
+                restores.push(() => wrap.isConnected && wrap.replaceWith(t));
+            }
+            const caret = document.createElement('span');
+            caret.setAttribute('aria-hidden', 'true');
+            caret.textContent = '▍';
+            Object.assign(caret.style, { opacity: '.7', marginLeft: '1px' });
+            el.appendChild(caret);
+            const blink = ctx.animate(caret, [{ opacity: 0.8 }, { opacity: 0 }], { duration: 500, iterations: Infinity, direction: 'alternate' });
+            let done = false;
+            const finish = () => {
+                if (done)
+                    return;
+                done = true;
+                blink?.cancel();
+                caret.remove();
+                restores.forEach((r) => r());
+            };
+            ctx.onCleanup(finish);
+            const runs = spans.map((s, i) => {
+                const a = ctx.animate(s, [{ opacity: 0, filter: 'blur(3px)' }, { opacity: 1, filter: 'none' }], { duration: 220, delay: i * speed, fill: 'both', easing: 'ease-out' });
+                if (!a)
+                    s.style.opacity = '';
+                return a?.finished.catch(() => undefined);
+            });
+            return Promise.all(runs).then(finish);
+        },
+    },
+    {
+        name: 'thinking-glow',
+        kind: 'loop',
+        description: 'A soft colour glow breathes and drifts round the element while a model is "thinking" (`colors`, comma-separated). Stops on cleanup.',
+        defaults: { colors: '#6366f1,#ec4899,#22d3ee', duration: 2400 },
+        run: (el, o, ctx) => {
+            const cs = String(o.colors).split(',').map((c) => c.trim()).filter(Boolean);
+            const c = cs.length ? cs : ['#6366f1'];
+            const frames = c.map((col, i) => ({ boxShadow: `0 0 ${i % 2 ? 26 : 14}px ${i % 2 ? 4 : 1}px ${col}`, offset: i / c.length }));
+            frames.push({ boxShadow: `0 0 14px 1px ${c[0]}`, offset: 1 });
+            const a = ctx.animate(el, frames, { duration: o.duration, iterations: Infinity, easing: 'ease-in-out' });
+            return () => a?.cancel();
+        },
+    },
+    {
+        name: 'voice-wave',
+        kind: 'attention',
+        description: "The element's children bounce in a wave like voice level bars, or the element pulses when it has none (`cycles`).",
+        defaults: { cycles: 2, duration: 700 },
+        run: (el, o, ctx) => {
+            if (ctx.reduced)
+                return;
+            const kids = Array.from(el.children);
+            const n = Math.max(1, Math.min(6, Number(o.cycles) || 2));
+            if (!kids.length)
+                return ctx.animate(el, [{ transform: 'scale(1)' }, { transform: 'scale(1.12)' }, { transform: 'scale(1)' }], { duration: o.duration, iterations: n, easing: 'ease-in-out' })?.finished.catch(() => undefined);
+            return Promise.all(kids.map((k, i) => ctx.animate(k, [{ transform: 'scaleY(1)' }, { transform: 'scaleY(1.9)' }, { transform: 'scaleY(.6)' }, { transform: 'scaleY(1)' }], { duration: o.duration, delay: i * (o.duration / (kids.length * 2)), iterations: n, easing: 'ease-in-out' })?.finished.catch(() => undefined))).then(() => undefined);
+        },
+    },
+    {
+        name: 'gen-skeleton',
+        kind: 'enter',
+        description: 'A shimmering skeleton covers the element, then dissolves to reveal the generated content (`hold` ms).',
+        defaults: { hold: 900, duration: 500 },
+        run: (el, o, ctx) => {
+            if (ctx.reduced)
+                return fade(el, ctx);
+            if (getComputedStyle(el).position === 'static') {
+                const prev = el.style.position;
+                el.style.position = 'relative';
+                ctx.onCleanup(() => (el.style.position = prev));
+            }
+            const sk = document.createElement('span');
+            sk.setAttribute('aria-hidden', 'true');
+            Object.assign(sk.style, { position: 'absolute', inset: '0', borderRadius: 'inherit', pointerEvents: 'none', background: 'linear-gradient(100deg,#e2e8f0 30%,#f8fafc 50%,#e2e8f0 70%)', backgroundSize: '200% 100%', zIndex: '1' });
+            el.appendChild(sk);
+            const end = () => sk.remove();
+            ctx.onCleanup(end);
+            const hold = Math.max(0, Number(o.hold) || 0);
+            ctx.animate(sk, [{ backgroundPosition: '120% 0' }, { backgroundPosition: '-20% 0' }], { duration: 900, iterations: Math.max(1, Math.ceil(hold / 900)) });
+            const a = ctx.animate(sk, [{ opacity: 1 }, { opacity: 0 }], { duration: o.duration, delay: hold, fill: 'both', easing: 'ease-out' });
+            return a ? a.finished.then(end, end) : (end(), undefined);
+        },
+    },
+];
+/** Register stream-text, thinking-glow, voice-wave and gen-skeleton (7.8). */
+function registerAiPack() {
+    registry.registerEffects(AI_FX);
+}
+
+exports.AI_FX = AI_FX;
+exports.registerAiPack = registerAiPack;
+exports.splitWords = splitWords;
+//# sourceMappingURL=fx-ai.cjs.map

package/dist/components/fx-ai.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"fx-ai.cjs","sources":["../../src/components/fx2/ai.ts"],"sourcesContent":["/**\n * 7.8 — AI UI motion (`motionary/fx/ai`, also `motionary/components/fx-ai`):\n *\n * - `stream-text` (enter) — the element's text appears word by word, like a\n *   streamed LLM reply, with a blinking caret at the end (`speed` ms/word).\n * - `thinking-glow` (loop) — a soft colour glow breathes and drifts round the\n *   element while a model is \"thinking\" (`colors`); the cleanup stops it.\n * - `voice-wave` (attention) — the element's children bounce in a wave like\n *   voice level bars (or the element pulses when it has none) (`cycles`).\n * - `gen-skeleton` (enter) — a shimmering skeleton covers the element, then\n *   dissolves to reveal the generated content (`hold`).\n *\n * Reduced motion: stream-text shows the text, thinking-glow is skipped,\n * voice-wave does nothing, gen-skeleton fades in.\n */\nimport type { EffectContext, EffectDefinition } from '../fx/registry';\nimport { registerEffects } from '../fx/registry';\n\n/** Split text into words, keeping the whitespace after each (7.8). */\nexport function splitWords(text: string): string[] {\n  return text.match(/\\S+\\s*|\\s+/g) || [];\n}\n\nconst fade = (el: HTMLElement, ctx: EffectContext) => ctx.animate(el, [{ opacity: 0 }, { opacity: 1 }], { duration: 250 })?.finished.catch(() => undefined);\n\nfunction textNodes(el: Node): Text[] {\n  const out: Text[] = [];\n  const walk = (n: Node) => n.childNodes.forEach((c) => (c.nodeType === 3 ? (c.textContent || '').trim() && out.push(c as Text) : c.nodeType === 1 && walk(c)));\n  walk(el);\n  return out;\n}\n\nexport const AI_FX: EffectDefinition[] = [\n  {\n    name: 'stream-text',\n    kind: 'enter',\n    description: 'The text appears word by word like a streamed LLM reply, with a blinking caret (`speed` ms per word).',\n    defaults: { speed: 45 },\n    run: (el: HTMLElement, o: any, ctx: EffectContext) => {\n      if (ctx.reduced) return;\n      const speed = Math.max(5, Number(o.speed) || 45);\n      const spans: HTMLElement[] = [];\n      const restores: (() => void)[] = [];\n      for (const t of textNodes(el)) {\n        const wrap = document.createElement('span');\n        wrap.setAttribute('data-usa-stream', '');\n        for (const w of splitWords(t.textContent || '')) {\n          const s = document.createElement('span');\n          s.textContent = w;\n          s.style.opacity = '0';\n          wrap.appendChild(s);\n          spans.push(s);\n        }\n        (t.parentNode as Node).replaceChild(wrap, t);\n        restores.push(() => wrap.isConnected && wrap.replaceWith(t));\n      }\n      const caret = document.createElement('span');\n      caret.setAttribute('aria-hidden', 'true');\n      caret.textContent = '▍';\n      Object.assign(caret.style, { opacity: '.7', marginLeft: '1px' });\n      el.appendChild(caret);\n      const blink = ctx.animate(caret, [{ opacity: 0.8 }, { opacity: 0 }], { duration: 500, iterations: Infinity, direction: 'alternate' });\n      let done = false;\n      const finish = () => {\n        if (done) return;\n        done = true;\n        blink?.cancel();\n        caret.remove();\n        restores.forEach((r) => r());\n      };\n      ctx.onCleanup(finish);\n      const runs = spans.map((s, i) => {\n        const a = ctx.animate(s, [{ opacity: 0, filter: 'blur(3px)' }, { opacity: 1, filter: 'none' }], { duration: 220, delay: i * speed, fill: 'both', easing: 'ease-out' });\n        if (!a) s.style.opacity = '';\n        return a?.finished.catch(() => undefined);\n      });\n      return Promise.all(runs).then(finish);\n    },\n  },\n  {\n    name: 'thinking-glow',\n    kind: 'loop',\n    description: 'A soft colour glow breathes and drifts round the element while a model is \"thinking\" (`colors`, comma-separated). Stops on cleanup.',\n    defaults: { colors: '#6366f1,#ec4899,#22d3ee', duration: 2400 },\n    run: (el: HTMLElement, o: any, ctx: EffectContext) => {\n      const cs = String(o.colors).split(',').map((c) => c.trim()).filter(Boolean);\n      const c = cs.length ? cs : ['#6366f1'];\n      const frames: Keyframe[] = c.map((col, i) => ({ boxShadow: `0 0 ${i % 2 ? 26 : 14}px ${i % 2 ? 4 : 1}px ${col}`, offset: i / c.length }));\n      frames.push({ boxShadow: `0 0 14px 1px ${c[0]}`, offset: 1 });\n      const a = ctx.animate(el, frames, { duration: o.duration, iterations: Infinity, easing: 'ease-in-out' });\n      return () => a?.cancel();\n    },\n  },\n  {\n    name: 'voice-wave',\n    kind: 'attention',\n    description: \"The element's children bounce in a wave like voice level bars, or the element pulses when it has none (`cycles`).\",\n    defaults: { cycles: 2, duration: 700 },\n    run: (el: HTMLElement, o: any, ctx: EffectContext) => {\n      if (ctx.reduced) return;\n      const kids = Array.from(el.children) as HTMLElement[];\n      const n = Math.max(1, Math.min(6, Number(o.cycles) || 2));\n      if (!kids.length) return ctx.animate(el, [{ transform: 'scale(1)' }, { transform: 'scale(1.12)' }, { transform: 'scale(1)' }], { duration: o.duration, iterations: n, easing: 'ease-in-out' })?.finished.catch(() => undefined);\n      return Promise.all(\n        kids.map((k, i) =>\n          ctx.animate(k, [{ transform: 'scaleY(1)' }, { transform: 'scaleY(1.9)' }, { transform: 'scaleY(.6)' }, { transform: 'scaleY(1)' }], { duration: o.duration, delay: i * (o.duration / (kids.length * 2)), iterations: n, easing: 'ease-in-out' })?.finished.catch(() => undefined)\n        )\n      ).then(() => undefined);\n    },\n  },\n  {\n    name: 'gen-skeleton',\n    kind: 'enter',\n    description: 'A shimmering skeleton covers the element, then dissolves to reveal the generated content (`hold` ms).',\n    defaults: { hold: 900, duration: 500 },\n    run: (el: HTMLElement, o: any, ctx: EffectContext) => {\n      if (ctx.reduced) return fade(el, ctx);\n      if (getComputedStyle(el).position === 'static') {\n        const prev = el.style.position;\n        el.style.position = 'relative';\n        ctx.onCleanup(() => (el.style.position = prev));\n      }\n      const sk = document.createElement('span');\n      sk.setAttribute('aria-hidden', 'true');\n      Object.assign(sk.style, { position: 'absolute', inset: '0', borderRadius: 'inherit', pointerEvents: 'none', background: 'linear-gradient(100deg,#e2e8f0 30%,#f8fafc 50%,#e2e8f0 70%)', backgroundSize: '200% 100%', zIndex: '1' });\n      el.appendChild(sk);\n      const end = () => sk.remove();\n      ctx.onCleanup(end);\n      const hold = Math.max(0, Number(o.hold) || 0);\n      ctx.animate(sk, [{ backgroundPosition: '120% 0' }, { backgroundPosition: '-20% 0' }], { duration: 900, iterations: Math.max(1, Math.ceil(hold / 900)) });\n      const a = ctx.animate(sk, [{ opacity: 1 }, { opacity: 0 }], { duration: o.duration, delay: hold, fill: 'both', easing: 'ease-out' });\n      return a ? a.finished.then(end, end) : (end(), undefined);\n    },\n  },\n];\n\n/** Register stream-text, thinking-glow, voice-wave and gen-skeleton (7.8). */\nexport function registerAiPack(): void {\n  registerEffects(AI_FX);\n}\n"],"names":["registerEffects"],"mappings":"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"}

package/dist/components/fx-ai.d.cts

@@ -0,0 +1,66 @@
+type MotionSensitivity = 'full' | 'gentle' | 'minimal' | 'static';
+type Cleanup = () => void;
+
+/**
+ * 5.0 — unified plugin-style effect registration. Every effect (built-in or
+ * yours) is a plain object registered once and played the same way:
+ * `playEffect(el, name)`, `bindEffect(el, name, { trigger })` or
+ * `<usa-fx effect="name" trigger="click">`. Effects get a context that
+ * already applies reduced motion, motion sensitivity, intensity and the
+ * animation budget.
+ */
+
+declare const EFFECT_KINDS: readonly ["enter", "exit", "attention", "click", "hover", "card", "loop", "page", "background", "text", "cursor", "scroll"];
+type EffectKind = (typeof EFFECT_KINDS)[number];
+interface EffectContext {
+    /** Reduced motion applies (OS setting, `minimal` / `static` sensitivity). */
+    readonly reduced: boolean;
+    readonly sensitivity: MotionSensitivity;
+    /** The triggering event (pointer position for click effects), if any. */
+    readonly event?: Event;
+    /** `el.animate()` with the library's motion rules (may return `null`). */
+    animate(el: Element, keyframes: Keyframe[], options: KeyframeAnimationOptions): Animation | null;
+    /** Register teardown for long-running effects (loops, listeners). */
+    onCleanup(fn: Cleanup): void;
+}
+interface EffectDefinition<O extends Record<string, unknown> = Record<string, any>> {
+    /** Unique, kebab-case. */
+    name: string;
+    kind: EffectKind;
+    /** One line for docs and the gallery. */
+    description?: string;
+    /** Option defaults (merged under the caller's options). */
+    defaults?: Partial<O>;
+    /**
+     * Under reduced motion: `'skip'` (do nothing — default for loop, background
+     * and cursor effects) or `'run'` (run with `ctx.reduced === true`, the
+     * effect degrades itself — default for everything else).
+     */
+    reduced?: 'skip' | 'run';
+    /** Play the effect. Return an Animation / Promise to be awaited, or a cleanup. */
+    run(el: HTMLElement, options: O, ctx: EffectContext): void | Cleanup | Animation | null | Promise<unknown>;
+}
+
+/**
+ * 7.8 — AI UI motion (`motionary/fx/ai`, also `motionary/components/fx-ai`):
+ *
+ * - `stream-text` (enter) — the element's text appears word by word, like a
+ *   streamed LLM reply, with a blinking caret at the end (`speed` ms/word).
+ * - `thinking-glow` (loop) — a soft colour glow breathes and drifts round the
+ *   element while a model is "thinking" (`colors`); the cleanup stops it.
+ * - `voice-wave` (attention) — the element's children bounce in a wave like
+ *   voice level bars (or the element pulses when it has none) (`cycles`).
+ * - `gen-skeleton` (enter) — a shimmering skeleton covers the element, then
+ *   dissolves to reveal the generated content (`hold`).
+ *
+ * Reduced motion: stream-text shows the text, thinking-glow is skipped,
+ * voice-wave does nothing, gen-skeleton fades in.
+ */
+
+/** Split text into words, keeping the whitespace after each (7.8). */
+declare function splitWords(text: string): string[];
+declare const AI_FX: EffectDefinition[];
+/** Register stream-text, thinking-glow, voice-wave and gen-skeleton (7.8). */
+declare function registerAiPack(): void;
+
+export { AI_FX, registerAiPack, splitWords };

package/dist/components/fx-ai.d.ts

@@ -0,0 +1,66 @@
+type MotionSensitivity = 'full' | 'gentle' | 'minimal' | 'static';
+type Cleanup = () => void;
+
+/**
+ * 5.0 — unified plugin-style effect registration. Every effect (built-in or
+ * yours) is a plain object registered once and played the same way:
+ * `playEffect(el, name)`, `bindEffect(el, name, { trigger })` or
+ * `<usa-fx effect="name" trigger="click">`. Effects get a context that
+ * already applies reduced motion, motion sensitivity, intensity and the
+ * animation budget.
+ */
+
+declare const EFFECT_KINDS: readonly ["enter", "exit", "attention", "click", "hover", "card", "loop", "page", "background", "text", "cursor", "scroll"];
+type EffectKind = (typeof EFFECT_KINDS)[number];
+interface EffectContext {
+    /** Reduced motion applies (OS setting, `minimal` / `static` sensitivity). */
+    readonly reduced: boolean;
+    readonly sensitivity: MotionSensitivity;
+    /** The triggering event (pointer position for click effects), if any. */
+    readonly event?: Event;
+    /** `el.animate()` with the library's motion rules (may return `null`). */
+    animate(el: Element, keyframes: Keyframe[], options: KeyframeAnimationOptions): Animation | null;
+    /** Register teardown for long-running effects (loops, listeners). */
+    onCleanup(fn: Cleanup): void;
+}
+interface EffectDefinition<O extends Record<string, unknown> = Record<string, any>> {
+    /** Unique, kebab-case. */
+    name: string;
+    kind: EffectKind;
+    /** One line for docs and the gallery. */
+    description?: string;
+    /** Option defaults (merged under the caller's options). */
+    defaults?: Partial<O>;
+    /**
+     * Under reduced motion: `'skip'` (do nothing — default for loop, background
+     * and cursor effects) or `'run'` (run with `ctx.reduced === true`, the
+     * effect degrades itself — default for everything else).
+     */
+    reduced?: 'skip' | 'run';
+    /** Play the effect. Return an Animation / Promise to be awaited, or a cleanup. */
+    run(el: HTMLElement, options: O, ctx: EffectContext): void | Cleanup | Animation | null | Promise<unknown>;
+}
+
+/**
+ * 7.8 — AI UI motion (`motionary/fx/ai`, also `motionary/components/fx-ai`):
+ *
+ * - `stream-text` (enter) — the element's text appears word by word, like a
+ *   streamed LLM reply, with a blinking caret at the end (`speed` ms/word).
+ * - `thinking-glow` (loop) — a soft colour glow breathes and drifts round the
+ *   element while a model is "thinking" (`colors`); the cleanup stops it.
+ * - `voice-wave` (attention) — the element's children bounce in a wave like
+ *   voice level bars (or the element pulses when it has none) (`cycles`).
+ * - `gen-skeleton` (enter) — a shimmering skeleton covers the element, then
+ *   dissolves to reveal the generated content (`hold`).
+ *
+ * Reduced motion: stream-text shows the text, thinking-glow is skipped,
+ * voice-wave does nothing, gen-skeleton fades in.
+ */
+
+/** Split text into words, keeping the whitespace after each (7.8). */
+declare function splitWords(text: string): string[];
+declare const AI_FX: EffectDefinition[];
+/** Register stream-text, thinking-glow, voice-wave and gen-skeleton (7.8). */
+declare function registerAiPack(): void;
+
+export { AI_FX, registerAiPack, splitWords };

package/dist/components/fx-ai.js

@@ -0,0 +1,126 @@
+import { registerEffects } from '../chunks/registry-CyKExAmE.js';
+import '../chunks/base-2-yYc93C.js';
+
+/** Split text into words, keeping the whitespace after each (7.8). */
+function splitWords(text) {
+    return text.match(/\S+\s*|\s+/g) || [];
+}
+const fade = (el, ctx) => ctx.animate(el, [{ opacity: 0 }, { opacity: 1 }], { duration: 250 })?.finished.catch(() => undefined);
+function textNodes(el) {
+    const out = [];
+    const walk = (n) => n.childNodes.forEach((c) => (c.nodeType === 3 ? (c.textContent || '').trim() && out.push(c) : c.nodeType === 1 && walk(c)));
+    walk(el);
+    return out;
+}
+const AI_FX = [
+    {
+        name: 'stream-text',
+        kind: 'enter',
+        description: 'The text appears word by word like a streamed LLM reply, with a blinking caret (`speed` ms per word).',
+        defaults: { speed: 45 },
+        run: (el, o, ctx) => {
+            if (ctx.reduced)
+                return;
+            const speed = Math.max(5, Number(o.speed) || 45);
+            const spans = [];
+            const restores = [];
+            for (const t of textNodes(el)) {
+                const wrap = document.createElement('span');
+                wrap.setAttribute('data-usa-stream', '');
+                for (const w of splitWords(t.textContent || '')) {
+                    const s = document.createElement('span');
+                    s.textContent = w;
+                    s.style.opacity = '0';
+                    wrap.appendChild(s);
+                    spans.push(s);
+                }
+                t.parentNode.replaceChild(wrap, t);
+                restores.push(() => wrap.isConnected && wrap.replaceWith(t));
+            }
+            const caret = document.createElement('span');
+            caret.setAttribute('aria-hidden', 'true');
+            caret.textContent = '▍';
+            Object.assign(caret.style, { opacity: '.7', marginLeft: '1px' });
+            el.appendChild(caret);
+            const blink = ctx.animate(caret, [{ opacity: 0.8 }, { opacity: 0 }], { duration: 500, iterations: Infinity, direction: 'alternate' });
+            let done = false;
+            const finish = () => {
+                if (done)
+                    return;
+                done = true;
+                blink?.cancel();
+                caret.remove();
+                restores.forEach((r) => r());
+            };
+            ctx.onCleanup(finish);
+            const runs = spans.map((s, i) => {
+                const a = ctx.animate(s, [{ opacity: 0, filter: 'blur(3px)' }, { opacity: 1, filter: 'none' }], { duration: 220, delay: i * speed, fill: 'both', easing: 'ease-out' });
+                if (!a)
+                    s.style.opacity = '';
+                return a?.finished.catch(() => undefined);
+            });
+            return Promise.all(runs).then(finish);
+        },
+    },
+    {
+        name: 'thinking-glow',
+        kind: 'loop',
+        description: 'A soft colour glow breathes and drifts round the element while a model is "thinking" (`colors`, comma-separated). Stops on cleanup.',
+        defaults: { colors: '#6366f1,#ec4899,#22d3ee', duration: 2400 },
+        run: (el, o, ctx) => {
+            const cs = String(o.colors).split(',').map((c) => c.trim()).filter(Boolean);
+            const c = cs.length ? cs : ['#6366f1'];
+            const frames = c.map((col, i) => ({ boxShadow: `0 0 ${i % 2 ? 26 : 14}px ${i % 2 ? 4 : 1}px ${col}`, offset: i / c.length }));
+            frames.push({ boxShadow: `0 0 14px 1px ${c[0]}`, offset: 1 });
+            const a = ctx.animate(el, frames, { duration: o.duration, iterations: Infinity, easing: 'ease-in-out' });
+            return () => a?.cancel();
+        },
+    },
+    {
+        name: 'voice-wave',
+        kind: 'attention',
+        description: "The element's children bounce in a wave like voice level bars, or the element pulses when it has none (`cycles`).",
+        defaults: { cycles: 2, duration: 700 },
+        run: (el, o, ctx) => {
+            if (ctx.reduced)
+                return;
+            const kids = Array.from(el.children);
+            const n = Math.max(1, Math.min(6, Number(o.cycles) || 2));
+            if (!kids.length)
+                return ctx.animate(el, [{ transform: 'scale(1)' }, { transform: 'scale(1.12)' }, { transform: 'scale(1)' }], { duration: o.duration, iterations: n, easing: 'ease-in-out' })?.finished.catch(() => undefined);
+            return Promise.all(kids.map((k, i) => ctx.animate(k, [{ transform: 'scaleY(1)' }, { transform: 'scaleY(1.9)' }, { transform: 'scaleY(.6)' }, { transform: 'scaleY(1)' }], { duration: o.duration, delay: i * (o.duration / (kids.length * 2)), iterations: n, easing: 'ease-in-out' })?.finished.catch(() => undefined))).then(() => undefined);
+        },
+    },
+    {
+        name: 'gen-skeleton',
+        kind: 'enter',
+        description: 'A shimmering skeleton covers the element, then dissolves to reveal the generated content (`hold` ms).',
+        defaults: { hold: 900, duration: 500 },
+        run: (el, o, ctx) => {
+            if (ctx.reduced)
+                return fade(el, ctx);
+            if (getComputedStyle(el).position === 'static') {
+                const prev = el.style.position;
+                el.style.position = 'relative';
+                ctx.onCleanup(() => (el.style.position = prev));
+            }
+            const sk = document.createElement('span');
+            sk.setAttribute('aria-hidden', 'true');
+            Object.assign(sk.style, { position: 'absolute', inset: '0', borderRadius: 'inherit', pointerEvents: 'none', background: 'linear-gradient(100deg,#e2e8f0 30%,#f8fafc 50%,#e2e8f0 70%)', backgroundSize: '200% 100%', zIndex: '1' });
+            el.appendChild(sk);
+            const end = () => sk.remove();
+            ctx.onCleanup(end);
+            const hold = Math.max(0, Number(o.hold) || 0);
+            ctx.animate(sk, [{ backgroundPosition: '120% 0' }, { backgroundPosition: '-20% 0' }], { duration: 900, iterations: Math.max(1, Math.ceil(hold / 900)) });
+            const a = ctx.animate(sk, [{ opacity: 1 }, { opacity: 0 }], { duration: o.duration, delay: hold, fill: 'both', easing: 'ease-out' });
+            return a ? a.finished.then(end, end) : (end(), undefined);
+        },
+    },
+];
+/** Register stream-text, thinking-glow, voice-wave and gen-skeleton (7.8). */
+function registerAiPack() {
+    registerEffects(AI_FX);
+}
+
+export { AI_FX, registerAiPack, splitWords };
+//# sourceMappingURL=fx-ai.js.map

package/dist/components/fx-ai.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fx-ai.js","sources":["../../src/components/fx2/ai.ts"],"sourcesContent":["/**\n * 7.8 — AI UI motion (`motionary/fx/ai`, also `motionary/components/fx-ai`):\n *\n * - `stream-text` (enter) — the element's text appears word by word, like a\n *   streamed LLM reply, with a blinking caret at the end (`speed` ms/word).\n * - `thinking-glow` (loop) — a soft colour glow breathes and drifts round the\n *   element while a model is \"thinking\" (`colors`); the cleanup stops it.\n * - `voice-wave` (attention) — the element's children bounce in a wave like\n *   voice level bars (or the element pulses when it has none) (`cycles`).\n * - `gen-skeleton` (enter) — a shimmering skeleton covers the element, then\n *   dissolves to reveal the generated content (`hold`).\n *\n * Reduced motion: stream-text shows the text, thinking-glow is skipped,\n * voice-wave does nothing, gen-skeleton fades in.\n */\nimport type { EffectContext, EffectDefinition } from '../fx/registry';\nimport { registerEffects } from '../fx/registry';\n\n/** Split text into words, keeping the whitespace after each (7.8). */\nexport function splitWords(text: string): string[] {\n  return text.match(/\\S+\\s*|\\s+/g) || [];\n}\n\nconst fade = (el: HTMLElement, ctx: EffectContext) => ctx.animate(el, [{ opacity: 0 }, { opacity: 1 }], { duration: 250 })?.finished.catch(() => undefined);\n\nfunction textNodes(el: Node): Text[] {\n  const out: Text[] = [];\n  const walk = (n: Node) => n.childNodes.forEach((c) => (c.nodeType === 3 ? (c.textContent || '').trim() && out.push(c as Text) : c.nodeType === 1 && walk(c)));\n  walk(el);\n  return out;\n}\n\nexport const AI_FX: EffectDefinition[] = [\n  {\n    name: 'stream-text',\n    kind: 'enter',\n    description: 'The text appears word by word like a streamed LLM reply, with a blinking caret (`speed` ms per word).',\n    defaults: { speed: 45 },\n    run: (el: HTMLElement, o: any, ctx: EffectContext) => {\n      if (ctx.reduced) return;\n      const speed = Math.max(5, Number(o.speed) || 45);\n      const spans: HTMLElement[] = [];\n      const restores: (() => void)[] = [];\n      for (const t of textNodes(el)) {\n        const wrap = document.createElement('span');\n        wrap.setAttribute('data-usa-stream', '');\n        for (const w of splitWords(t.textContent || '')) {\n          const s = document.createElement('span');\n          s.textContent = w;\n          s.style.opacity = '0';\n          wrap.appendChild(s);\n          spans.push(s);\n        }\n        (t.parentNode as Node).replaceChild(wrap, t);\n        restores.push(() => wrap.isConnected && wrap.replaceWith(t));\n      }\n      const caret = document.createElement('span');\n      caret.setAttribute('aria-hidden', 'true');\n      caret.textContent = '▍';\n      Object.assign(caret.style, { opacity: '.7', marginLeft: '1px' });\n      el.appendChild(caret);\n      const blink = ctx.animate(caret, [{ opacity: 0.8 }, { opacity: 0 }], { duration: 500, iterations: Infinity, direction: 'alternate' });\n      let done = false;\n      const finish = () => {\n        if (done) return;\n        done = true;\n        blink?.cancel();\n        caret.remove();\n        restores.forEach((r) => r());\n      };\n      ctx.onCleanup(finish);\n      const runs = spans.map((s, i) => {\n        const a = ctx.animate(s, [{ opacity: 0, filter: 'blur(3px)' }, { opacity: 1, filter: 'none' }], { duration: 220, delay: i * speed, fill: 'both', easing: 'ease-out' });\n        if (!a) s.style.opacity = '';\n        return a?.finished.catch(() => undefined);\n      });\n      return Promise.all(runs).then(finish);\n    },\n  },\n  {\n    name: 'thinking-glow',\n    kind: 'loop',\n    description: 'A soft colour glow breathes and drifts round the element while a model is \"thinking\" (`colors`, comma-separated). Stops on cleanup.',\n    defaults: { colors: '#6366f1,#ec4899,#22d3ee', duration: 2400 },\n    run: (el: HTMLElement, o: any, ctx: EffectContext) => {\n      const cs = String(o.colors).split(',').map((c) => c.trim()).filter(Boolean);\n      const c = cs.length ? cs : ['#6366f1'];\n      const frames: Keyframe[] = c.map((col, i) => ({ boxShadow: `0 0 ${i % 2 ? 26 : 14}px ${i % 2 ? 4 : 1}px ${col}`, offset: i / c.length }));\n      frames.push({ boxShadow: `0 0 14px 1px ${c[0]}`, offset: 1 });\n      const a = ctx.animate(el, frames, { duration: o.duration, iterations: Infinity, easing: 'ease-in-out' });\n      return () => a?.cancel();\n    },\n  },\n  {\n    name: 'voice-wave',\n    kind: 'attention',\n    description: \"The element's children bounce in a wave like voice level bars, or the element pulses when it has none (`cycles`).\",\n    defaults: { cycles: 2, duration: 700 },\n    run: (el: HTMLElement, o: any, ctx: EffectContext) => {\n      if (ctx.reduced) return;\n      const kids = Array.from(el.children) as HTMLElement[];\n      const n = Math.max(1, Math.min(6, Number(o.cycles) || 2));\n      if (!kids.length) return ctx.animate(el, [{ transform: 'scale(1)' }, { transform: 'scale(1.12)' }, { transform: 'scale(1)' }], { duration: o.duration, iterations: n, easing: 'ease-in-out' })?.finished.catch(() => undefined);\n      return Promise.all(\n        kids.map((k, i) =>\n          ctx.animate(k, [{ transform: 'scaleY(1)' }, { transform: 'scaleY(1.9)' }, { transform: 'scaleY(.6)' }, { transform: 'scaleY(1)' }], { duration: o.duration, delay: i * (o.duration / (kids.length * 2)), iterations: n, easing: 'ease-in-out' })?.finished.catch(() => undefined)\n        )\n      ).then(() => undefined);\n    },\n  },\n  {\n    name: 'gen-skeleton',\n    kind: 'enter',\n    description: 'A shimmering skeleton covers the element, then dissolves to reveal the generated content (`hold` ms).',\n    defaults: { hold: 900, duration: 500 },\n    run: (el: HTMLElement, o: any, ctx: EffectContext) => {\n      if (ctx.reduced) return fade(el, ctx);\n      if (getComputedStyle(el).position === 'static') {\n        const prev = el.style.position;\n        el.style.position = 'relative';\n        ctx.onCleanup(() => (el.style.position = prev));\n      }\n      const sk = document.createElement('span');\n      sk.setAttribute('aria-hidden', 'true');\n      Object.assign(sk.style, { position: 'absolute', inset: '0', borderRadius: 'inherit', pointerEvents: 'none', background: 'linear-gradient(100deg,#e2e8f0 30%,#f8fafc 50%,#e2e8f0 70%)', backgroundSize: '200% 100%', zIndex: '1' });\n      el.appendChild(sk);\n      const end = () => sk.remove();\n      ctx.onCleanup(end);\n      const hold = Math.max(0, Number(o.hold) || 0);\n      ctx.animate(sk, [{ backgroundPosition: '120% 0' }, { backgroundPosition: '-20% 0' }], { duration: 900, iterations: Math.max(1, Math.ceil(hold / 900)) });\n      const a = ctx.animate(sk, [{ opacity: 1 }, { opacity: 0 }], { duration: o.duration, delay: hold, fill: 'both', easing: 'ease-out' });\n      return a ? a.finished.then(end, end) : (end(), undefined);\n    },\n  },\n];\n\n/** Register stream-text, thinking-glow, voice-wave and gen-skeleton (7.8). */\nexport function registerAiPack(): void {\n  registerEffects(AI_FX);\n}\n"],"names":[],"mappings":"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"}

package/dist/components/fx-form.cjs

@@ -0,0 +1,92 @@
+'use strict';
+
+var registry = require('../chunks/registry-DehBVRDV.cjs');
+require('../chunks/base-BaQV-2ha.cjs');
+
+/** Decaying sideways shake keyframes (7.7). */
+function shakeFrames(distance = 8, steps = 5) {
+    const f = [{ transform: 'none' }];
+    for (let i = 0; i < steps; i++) {
+        const d = Math.round(distance * (1 - i / steps) * 10) / 10;
+        f.push({ transform: `translateX(${i % 2 ? d : -d}px)` });
+    }
+    f.push({ transform: 'none' });
+    return f;
+}
+const fade = (el, ctx) => ctx.animate(el, [{ opacity: 0 }, { opacity: 1 }], { duration: 250 })?.finished.catch(() => undefined);
+const ring = (el, color, ctx, duration) => ctx.animate(el, [{ boxShadow: `0 0 0 0 ${color}` }, { boxShadow: `0 0 0 4px ${color}`, offset: 0.3 }, { boxShadow: '0 0 0 0 transparent' }], { duration })?.finished.catch(() => undefined);
+const FORM_FX = [
+    {
+        name: 'field-shake',
+        kind: 'attention',
+        description: 'Shakes the element sideways with a red outline flash — the "invalid" cue (`distance`, `color`).',
+        defaults: { distance: 8, color: 'rgba(225,29,72,.55)', duration: 450 },
+        run: (el, o, ctx) => {
+            const r = ring(el, o.color, ctx, o.duration + 200);
+            if (ctx.reduced)
+                return r;
+            return ctx.animate(el, shakeFrames(Number(o.distance) || 8), { duration: o.duration, easing: 'ease-out' })?.finished.catch(() => undefined);
+        },
+    },
+    {
+        name: 'field-success',
+        kind: 'attention',
+        description: 'A green glow pulses round the element and a check badge pops on its corner (`color`).',
+        defaults: { color: 'rgba(22,163,74,.5)', duration: 900 },
+        run: (el, o, ctx) => {
+            const r = ring(el, o.color, ctx, o.duration);
+            if (ctx.reduced)
+                return r;
+            if (getComputedStyle(el).position === 'static') {
+                const prev = el.style.position;
+                el.style.position = 'relative';
+                ctx.onCleanup(() => (el.style.position = prev));
+            }
+            const b = document.createElement('span');
+            b.setAttribute('aria-hidden', 'true');
+            b.textContent = '✓';
+            Object.assign(b.style, { position: 'absolute', right: '-6px', top: '-6px', width: '18px', height: '18px', borderRadius: '50%', background: '#16a34a', color: '#fff', font: '700 12px/18px system-ui,sans-serif', textAlign: 'center', pointerEvents: 'none' });
+            el.appendChild(b);
+            const end = () => b.remove();
+            ctx.onCleanup(end);
+            const a = ctx.animate(b, [{ transform: 'scale(0)', opacity: 0 }, { transform: 'scale(1.25)', opacity: 1, offset: 0.25 }, { transform: 'scale(1)', opacity: 1, offset: 0.4 }, { transform: 'scale(1)', opacity: 1, offset: 0.85 }, { transform: 'scale(.6)', opacity: 0 }], { duration: o.duration + 500, easing: 'ease-out' });
+            return a ? a.finished.then(end, end) : (end(), undefined);
+        },
+    },
+    {
+        name: 'label-float',
+        kind: 'enter',
+        description: 'Every `label` (or `[data-label]`) inside rises and settles one after another, like floating labels (`stagger`).',
+        defaults: { stagger: 80, duration: 450 },
+        run: (el, o, ctx) => {
+            const marked = Array.from(el.querySelectorAll('[data-label]'));
+            const labels = marked.length ? marked : Array.from(el.querySelectorAll('label'));
+            const items = labels.length ? labels : [el];
+            return Promise.all(items.map((l, i) => ctx.reduced
+                ? fade(l, ctx)
+                : ctx.animate(l, [{ transform: 'translateY(14px) scale(1.12)', opacity: 0, transformOrigin: '0 50%' }, { transform: 'translateY(-3px) scale(.96)', opacity: 1, offset: 0.7 }, { transform: 'none', opacity: 1 }], { duration: o.duration, delay: i * o.stagger, easing: 'cubic-bezier(.2,.8,.2,1)', fill: 'backwards' })?.finished.catch(() => undefined))).then(() => undefined);
+        },
+    },
+    {
+        name: 'form-cascade',
+        kind: 'enter',
+        description: "The element's children (fields, buttons) slide in one after another (`stagger`, `distance`).",
+        defaults: { stagger: 70, distance: 18, duration: 500 },
+        run: (el, o, ctx) => {
+            const kids = Array.from(el.children);
+            const items = kids.length ? kids : [el];
+            return Promise.all(items.map((k, i) => ctx.reduced
+                ? fade(k, ctx)
+                : ctx.animate(k, [{ transform: `translateY(${Number(o.distance) || 18}px)`, opacity: 0 }, { transform: 'none', opacity: 1 }], { duration: o.duration, delay: i * o.stagger, easing: 'cubic-bezier(.2,.8,.2,1)', fill: 'backwards' })?.finished.catch(() => undefined))).then(() => undefined);
+        },
+    },
+];
+/** Register field-shake, field-success, label-float and form-cascade (7.7). */
+function registerFormPack() {
+    registry.registerEffects(FORM_FX);
+}
+
+exports.FORM_FX = FORM_FX;
+exports.registerFormPack = registerFormPack;
+exports.shakeFrames = shakeFrames;
+//# sourceMappingURL=fx-form.cjs.map

package/dist/components/fx-form.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"fx-form.cjs","sources":["../../src/components/fx2/form.ts"],"sourcesContent":["/**\n * 7.7 — Form motion (`motionary/fx/form`, also `motionary/components/fx-form`):\n *\n * - `field-shake` (attention) — the element shakes sideways with a red\n *   outline flash, the classic \"invalid\" cue (`distance`, `color`).\n * - `field-success` (attention) — a green glow pulses round the element and a\n *   small check badge pops on its corner (`color`).\n * - `label-float` (enter) — every `label` (or `[data-label]`) inside rises and\n *   settles, one after another, like floating labels (`stagger`).\n * - `form-cascade` (enter) — the element's children (fields, buttons) slide\n *   in one after another (`stagger`, `distance`).\n *\n * Reduced motion: field-shake / field-success only flash the outline colour,\n * label-float and form-cascade fade in.\n */\nimport type { EffectContext, EffectDefinition } from '../fx/registry';\nimport { registerEffects } from '../fx/registry';\n\n/** Decaying sideways shake keyframes (7.7). */\nexport function shakeFrames(distance = 8, steps = 5): Keyframe[] {\n  const f: Keyframe[] = [{ transform: 'none' }];\n  for (let i = 0; i < steps; i++) {\n    const d = Math.round(distance * (1 - i / steps) * 10) / 10;\n    f.push({ transform: `translateX(${i % 2 ? d : -d}px)` });\n  }\n  f.push({ transform: 'none' });\n  return f;\n}\n\nconst fade = (el: HTMLElement, ctx: EffectContext) => ctx.animate(el, [{ opacity: 0 }, { opacity: 1 }], { duration: 250 })?.finished.catch(() => undefined);\nconst ring = (el: HTMLElement, color: string, ctx: EffectContext, duration: number) =>\n  ctx.animate(el, [{ boxShadow: `0 0 0 0 ${color}` }, { boxShadow: `0 0 0 4px ${color}`, offset: 0.3 }, { boxShadow: '0 0 0 0 transparent' }], { duration })?.finished.catch(() => undefined);\n\nexport const FORM_FX: EffectDefinition[] = [\n  {\n    name: 'field-shake',\n    kind: 'attention',\n    description: 'Shakes the element sideways with a red outline flash — the \"invalid\" cue (`distance`, `color`).',\n    defaults: { distance: 8, color: 'rgba(225,29,72,.55)', duration: 450 },\n    run: (el: HTMLElement, o: any, ctx: EffectContext) => {\n      const r = ring(el, o.color, ctx, o.duration + 200);\n      if (ctx.reduced) return r;\n      return ctx.animate(el, shakeFrames(Number(o.distance) || 8), { duration: o.duration, easing: 'ease-out' })?.finished.catch(() => undefined);\n    },\n  },\n  {\n    name: 'field-success',\n    kind: 'attention',\n    description: 'A green glow pulses round the element and a check badge pops on its corner (`color`).',\n    defaults: { color: 'rgba(22,163,74,.5)', duration: 900 },\n    run: (el: HTMLElement, o: any, ctx: EffectContext) => {\n      const r = ring(el, o.color, ctx, o.duration);\n      if (ctx.reduced) return r;\n      if (getComputedStyle(el).position === 'static') {\n        const prev = el.style.position;\n        el.style.position = 'relative';\n        ctx.onCleanup(() => (el.style.position = prev));\n      }\n      const b = document.createElement('span');\n      b.setAttribute('aria-hidden', 'true');\n      b.textContent = '✓';\n      Object.assign(b.style, { position: 'absolute', right: '-6px', top: '-6px', width: '18px', height: '18px', borderRadius: '50%', background: '#16a34a', color: '#fff', font: '700 12px/18px system-ui,sans-serif', textAlign: 'center', pointerEvents: 'none' });\n      el.appendChild(b);\n      const end = () => b.remove();\n      ctx.onCleanup(end);\n      const a = ctx.animate(b, [{ transform: 'scale(0)', opacity: 0 }, { transform: 'scale(1.25)', opacity: 1, offset: 0.25 }, { transform: 'scale(1)', opacity: 1, offset: 0.4 }, { transform: 'scale(1)', opacity: 1, offset: 0.85 }, { transform: 'scale(.6)', opacity: 0 }], { duration: o.duration + 500, easing: 'ease-out' });\n      return a ? a.finished.then(end, end) : (end(), undefined);\n    },\n  },\n  {\n    name: 'label-float',\n    kind: 'enter',\n    description: 'Every `label` (or `[data-label]`) inside rises and settles one after another, like floating labels (`stagger`).',\n    defaults: { stagger: 80, duration: 450 },\n    run: (el: HTMLElement, o: any, ctx: EffectContext) => {\n      const marked = Array.from(el.querySelectorAll<HTMLElement>('[data-label]'));\n      const labels = marked.length ? marked : Array.from(el.querySelectorAll<HTMLElement>('label'));\n      const items = labels.length ? labels : [el];\n      return Promise.all(\n        items.map((l, i) =>\n          ctx.reduced\n            ? fade(l, ctx)\n            : ctx.animate(l, [{ transform: 'translateY(14px) scale(1.12)', opacity: 0, transformOrigin: '0 50%' }, { transform: 'translateY(-3px) scale(.96)', opacity: 1, offset: 0.7 }, { transform: 'none', opacity: 1 }], { duration: o.duration, delay: i * o.stagger, easing: 'cubic-bezier(.2,.8,.2,1)', fill: 'backwards' })?.finished.catch(() => undefined)\n        )\n      ).then(() => undefined);\n    },\n  },\n  {\n    name: 'form-cascade',\n    kind: 'enter',\n    description: \"The element's children (fields, buttons) slide in one after another (`stagger`, `distance`).\",\n    defaults: { stagger: 70, distance: 18, duration: 500 },\n    run: (el: HTMLElement, o: any, ctx: EffectContext) => {\n      const kids = Array.from(el.children) as HTMLElement[];\n      const items = kids.length ? kids : [el];\n      return Promise.all(\n        items.map((k, i) =>\n          ctx.reduced\n            ? fade(k, ctx)\n            : ctx.animate(k, [{ transform: `translateY(${Number(o.distance) || 18}px)`, opacity: 0 }, { transform: 'none', opacity: 1 }], { duration: o.duration, delay: i * o.stagger, easing: 'cubic-bezier(.2,.8,.2,1)', fill: 'backwards' })?.finished.catch(() => undefined)\n        )\n      ).then(() => undefined);\n    },\n  },\n];\n\n/** Register field-shake, field-success, label-float and form-cascade (7.7). */\nexport function registerFormPack(): void {\n  registerEffects(FORM_FX);\n}\n"],"names":["registerEffects"],"mappings":"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"}