use-scroll-animate 7.5.0 → 7.7.0

package/CHANGELOG.md

@@ -7,6 +7,33 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [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
+- **2 new components (7.6)** in `motionary/components/widgets` (also in `dist/widgets.umd.js`):
+  - `<usa-globe>` — SVG globe in orthographic projection (no WebGL, no tiles): graticule, pulsing `markers` ("Shanghai:31.2,121.5; London:51.5,-0.1"), `speed` (°/s, 0 = still), `tilt`, `lon`; spins only while on screen, drag to turn; `flyTo(name)` eases a marker round to the front (`usa:focus`). `project()`, `parseMarkers()`.
+  - `<usa-location-card>` — place card with a stylised mini map: `name`, `address`, `lat`/`lon`, origin `from-lat`/`from-lon` (distance by haversine, `unit` km | mi, or `distance`), `href` → “Directions”. On first view the route draws itself, the pin drops with a bounce and a ring pulses; `replay()`; `usa:arrive`. `haversine()`, `formatDistance()`.
+- **Maps & geo motion — `motionary/fx/geo`** (= `motionary/components/fx-geo`, `registerGeoPack()`, also in `registerEffectPacks()`): `route-draw` (enter), `marker-pulse` (attention), `pin-drop` (enter), `globe-spin` (enter). `routeLength()`.
+- Showcase: 4 new gallery cards with copyable code and live demos (and live Store thumbnails); Animation Store 317 → 321 items.
+- Note: the plan's “flight lines” (飞线) ship as `route-draw` over any SVG path.
+
+### Accessibility
+- Globe = `role="img"` labelled with its marker names; location card = labelled `<article>` with a heading and a real link. Reduced motion: the globe does not spin and `flyTo()` jumps; pin and route appear at once; `route-draw` shows the routes, `marker-pulse` does nothing, `pin-drop` / `globe-spin` fade in.
+
 ## [7.5.0] - 2026-10-08
 
 ### Added

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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"}

package/dist/components/fx-form.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.7 — Form motion (`motionary/fx/form`, also `motionary/components/fx-form`):
+ *
+ * - `field-shake` (attention) — the element shakes sideways with a red
+ *   outline flash, the classic "invalid" cue (`distance`, `color`).
+ * - `field-success` (attention) — a green glow pulses round the element and a
+ *   small check badge pops on its corner (`color`).
+ * - `label-float` (enter) — every `label` (or `[data-label]`) inside rises and
+ *   settles, one after another, like floating labels (`stagger`).
+ * - `form-cascade` (enter) — the element's children (fields, buttons) slide
+ *   in one after another (`stagger`, `distance`).
+ *
+ * Reduced motion: field-shake / field-success only flash the outline colour,
+ * label-float and form-cascade fade in.
+ */
+
+/** Decaying sideways shake keyframes (7.7). */
+declare function shakeFrames(distance?: number, steps?: number): Keyframe[];
+declare const FORM_FX: EffectDefinition[];
+/** Register field-shake, field-success, label-float and form-cascade (7.7). */
+declare function registerFormPack(): void;
+
+export { FORM_FX, registerFormPack, shakeFrames };

package/dist/components/fx-form.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.7 — Form motion (`motionary/fx/form`, also `motionary/components/fx-form`):
+ *
+ * - `field-shake` (attention) — the element shakes sideways with a red
+ *   outline flash, the classic "invalid" cue (`distance`, `color`).
+ * - `field-success` (attention) — a green glow pulses round the element and a
+ *   small check badge pops on its corner (`color`).
+ * - `label-float` (enter) — every `label` (or `[data-label]`) inside rises and
+ *   settles, one after another, like floating labels (`stagger`).
+ * - `form-cascade` (enter) — the element's children (fields, buttons) slide
+ *   in one after another (`stagger`, `distance`).
+ *
+ * Reduced motion: field-shake / field-success only flash the outline colour,
+ * label-float and form-cascade fade in.
+ */
+
+/** Decaying sideways shake keyframes (7.7). */
+declare function shakeFrames(distance?: number, steps?: number): Keyframe[];
+declare const FORM_FX: EffectDefinition[];
+/** Register field-shake, field-success, label-float and form-cascade (7.7). */
+declare function registerFormPack(): void;
+
+export { FORM_FX, registerFormPack, shakeFrames };

package/dist/components/fx-form.js

@@ -0,0 +1,88 @@
+import { registerEffects } from '../chunks/registry-CyKExAmE.js';
+import '../chunks/base-2-yYc93C.js';
+
+/** 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() {
+    registerEffects(FORM_FX);
+}
+
+export { FORM_FX, registerFormPack, shakeFrames };
+//# sourceMappingURL=fx-form.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fx-form.js","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":[],"mappings":"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"}

package/dist/components/fx-geo.cjs

@@ -0,0 +1,125 @@
+'use strict';
+
+var registry = require('../chunks/registry-DehBVRDV.cjs');
+require('../chunks/base-BaQV-2ha.cjs');
+
+/** Length of a polyline through `points` (7.6). */
+function routeLength(points) {
+    let len = 0;
+    for (let i = 1; i < points.length; i++)
+        len += Math.hypot(points[i].x - points[i - 1].x, points[i].y - points[i - 1].y);
+    return Math.round(len * 100) / 100;
+}
+const lengthOf = (p) => {
+    try {
+        const n = typeof p.getTotalLength === 'function' ? p.getTotalLength() : 0;
+        if (n > 0)
+            return n;
+    }
+    catch {
+        /* not rendered */
+    }
+    const pts = (p.getAttribute('points') || '')
+        .trim()
+        .split(/[\s,]+/)
+        .map(Number);
+    const xy = [];
+    for (let i = 0; i + 1 < pts.length; i += 2)
+        xy.push({ x: pts[i], y: pts[i + 1] });
+    return routeLength(xy) || 100;
+};
+const fade = (el, ctx) => ctx.animate(el, [{ opacity: 0 }, { opacity: 1 }], { duration: 250 })?.finished.catch(() => undefined);
+const GEO_FX = [
+    {
+        name: 'route-draw',
+        kind: 'enter',
+        description: 'SVG paths / polylines inside the element (or `[data-route]`) draw themselves along their length, one after another (`duration`, `stagger`).',
+        defaults: { duration: 1200, stagger: 250 },
+        run: (el, o, ctx) => {
+            const marked = Array.from(el.querySelectorAll('[data-route]'));
+            const paths = marked.length ? marked : Array.from(el.querySelectorAll('path, polyline'));
+            if (ctx.reduced || !paths.length)
+                return;
+            const runs = paths.map((p, i) => {
+                const len = lengthOf(p);
+                const prev = { a: p.style.strokeDasharray, o: p.style.strokeDashoffset };
+                p.style.strokeDasharray = `${len}`;
+                ctx.onCleanup(() => {
+                    p.style.strokeDasharray = prev.a;
+                    p.style.strokeDashoffset = prev.o;
+                });
+                return ctx.animate(p, [{ strokeDashoffset: `${len}` }, { strokeDashoffset: '0' }], { duration: o.duration, delay: i * o.stagger, easing: 'ease-in-out', fill: 'backwards' })?.finished.catch(() => undefined);
+            });
+            return Promise.all(runs).then(() => undefined);
+        },
+    },
+    {
+        name: 'marker-pulse',
+        kind: 'attention',
+        description: 'Rings expand out of the element like a location beacon (`color`, `rings`).',
+        defaults: { color: '#ef4444', rings: 2, duration: 1100 },
+        run: (el, o, ctx) => {
+            if (ctx.reduced)
+                return;
+            if (getComputedStyle(el).position === 'static') {
+                const prev = el.style.position;
+                el.style.position = 'relative';
+                ctx.onCleanup(() => (el.style.position = prev));
+            }
+            const all = Array.from({ length: Math.max(1, Math.min(4, o.rings)) }, (_, i) => {
+                const ring = document.createElement('span');
+                ring.setAttribute('aria-hidden', 'true');
+                Object.assign(ring.style, { position: 'absolute', left: '50%', top: '50%', width: '100%', aspectRatio: '1', borderRadius: '50%', border: `2px solid ${o.color}`, pointerEvents: 'none', translate: '-50% -50%' });
+                el.appendChild(ring);
+                const a = ctx.animate(ring, [{ transform: 'scale(.4)', opacity: 0.9 }, { transform: 'scale(2.2)', opacity: 0 }], { duration: o.duration, delay: i * (o.duration / 3), easing: 'ease-out', fill: 'backwards' });
+                const end = () => ring.remove();
+                ctx.onCleanup(end);
+                return a ? a.finished.then(end, end) : (end(), undefined);
+            });
+            return Promise.all(all).then(() => undefined);
+        },
+    },
+    {
+        name: 'pin-drop',
+        kind: 'enter',
+        description: 'The element drops onto its spot with a squash and a landing shadow (`height`).',
+        defaults: { height: 80, duration: 700 },
+        run: (el, o, ctx) => {
+            if (ctx.reduced)
+                return fade(el, ctx);
+            const h = Math.max(10, Number(o.height) || 80);
+            ctx.animate(el, [{ filter: 'drop-shadow(0 0 0 rgba(0,0,0,0))' }, { filter: 'drop-shadow(0 6px 4px rgba(0,0,0,.35))', offset: 0.6 }, { filter: 'drop-shadow(0 2px 2px rgba(0,0,0,.2))' }], { duration: o.duration });
+            return ctx
+                .animate(el, [
+                { transform: `translateY(${-h}px)`, opacity: 0, easing: 'cubic-bezier(.5,0,.9,.5)' },
+                { transform: 'translateY(0) scale(1.08, .88)', opacity: 1, offset: 0.6 },
+                { transform: 'translateY(-8px) scale(.97, 1.04)', offset: 0.8 },
+                { transform: 'none', opacity: 1 },
+            ], { duration: o.duration, fill: 'backwards' })
+                ?.finished.catch(() => undefined);
+        },
+    },
+    {
+        name: 'globe-spin',
+        kind: 'enter',
+        description: 'The element turns in like a globe coming round — rotateY with perspective (`turns`).',
+        defaults: { turns: 0.5, duration: 1100 },
+        run: (el, o, ctx) => {
+            if (ctx.reduced)
+                return fade(el, ctx);
+            const deg = Math.round(360 * (Number(o.turns) || 0.5));
+            return ctx
+                .animate(el, [{ transform: `perspective(600px) rotateY(${-deg}deg) scale(.8)`, opacity: 0 }, { transform: 'perspective(600px) rotateY(0) scale(1)', opacity: 1 }], { duration: o.duration, easing: 'cubic-bezier(.2,.8,.2,1)', fill: 'backwards' })
+                ?.finished.catch(() => undefined);
+        },
+    },
+];
+/** Register route-draw, marker-pulse, pin-drop and globe-spin (7.6). */
+function registerGeoPack() {
+    registry.registerEffects(GEO_FX);
+}
+
+exports.GEO_FX = GEO_FX;
+exports.registerGeoPack = registerGeoPack;
+exports.routeLength = routeLength;
+//# sourceMappingURL=fx-geo.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fx-geo.cjs","sources":["../../src/components/fx2/geo.ts"],"sourcesContent":["/**\n * 7.6 — Maps & geo motion (`motionary/fx/geo`, also `motionary/components/fx-geo`):\n *\n * - `route-draw` (enter) — every SVG `path` / `polyline` inside the element\n *   (or `[data-route]` only, when present) draws itself along its length,\n *   one after another (`duration`, `stagger`).\n * - `marker-pulse` (attention) — rings expand out of the element like a\n *   location beacon (`color`, `rings`).\n * - `pin-drop` (enter) — the element drops onto its spot with a squash and a\n *   landing shadow (`height`).\n * - `globe-spin` (enter) — the element turns in like a globe coming round\n *   (rotateY with perspective) (`turns`).\n *\n * Reduced motion: route-draw shows the routes, marker-pulse does nothing,\n * pin-drop and globe-spin fade in.\n */\nimport type { EffectContext, EffectDefinition } from '../fx/registry';\nimport { registerEffects } from '../fx/registry';\n\n/** Length of a polyline through `points` (7.6). */\nexport function routeLength(points: { x: number; y: number }[]): number {\n  let len = 0;\n  for (let i = 1; i < points.length; i++) len += Math.hypot(points[i].x - points[i - 1].x, points[i].y - points[i - 1].y);\n  return Math.round(len * 100) / 100;\n}\n\nconst lengthOf = (p: SVGGeometryElement): number => {\n  try {\n    const n = typeof p.getTotalLength === 'function' ? p.getTotalLength() : 0;\n    if (n > 0) return n;\n  } catch {\n    /* not rendered */\n  }\n  const pts = (p.getAttribute('points') || '')\n    .trim()\n    .split(/[\\s,]+/)\n    .map(Number);\n  const xy = [];\n  for (let i = 0; i + 1 < pts.length; i += 2) xy.push({ x: pts[i], y: pts[i + 1] });\n  return routeLength(xy) || 100;\n};\n\nconst fade = (el: HTMLElement, ctx: EffectContext) => ctx.animate(el, [{ opacity: 0 }, { opacity: 1 }], { duration: 250 })?.finished.catch(() => undefined);\n\nexport const GEO_FX: EffectDefinition[] = [\n  {\n    name: 'route-draw',\n    kind: 'enter',\n    description: 'SVG paths / polylines inside the element (or `[data-route]`) draw themselves along their length, one after another (`duration`, `stagger`).',\n    defaults: { duration: 1200, stagger: 250 },\n    run: (el: HTMLElement, o: any, ctx: EffectContext) => {\n      const marked = Array.from(el.querySelectorAll<SVGGeometryElement>('[data-route]'));\n      const paths = marked.length ? marked : Array.from(el.querySelectorAll<SVGGeometryElement>('path, polyline'));\n      if (ctx.reduced || !paths.length) return;\n      const runs = paths.map((p, i) => {\n        const len = lengthOf(p);\n        const prev = { a: p.style.strokeDasharray, o: p.style.strokeDashoffset };\n        p.style.strokeDasharray = `${len}`;\n        ctx.onCleanup(() => {\n          p.style.strokeDasharray = prev.a;\n          p.style.strokeDashoffset = prev.o;\n        });\n        return ctx.animate(p, [{ strokeDashoffset: `${len}` }, { strokeDashoffset: '0' }], { duration: o.duration, delay: i * o.stagger, easing: 'ease-in-out', fill: 'backwards' })?.finished.catch(() => undefined);\n      });\n      return Promise.all(runs).then(() => undefined);\n    },\n  },\n  {\n    name: 'marker-pulse',\n    kind: 'attention',\n    description: 'Rings expand out of the element like a location beacon (`color`, `rings`).',\n    defaults: { color: '#ef4444', rings: 2, duration: 1100 },\n    run: (el: HTMLElement, o: any, ctx: EffectContext) => {\n      if (ctx.reduced) return;\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 all = Array.from({ length: Math.max(1, Math.min(4, o.rings)) }, (_, i) => {\n        const ring = document.createElement('span');\n        ring.setAttribute('aria-hidden', 'true');\n        Object.assign(ring.style, { position: 'absolute', left: '50%', top: '50%', width: '100%', aspectRatio: '1', borderRadius: '50%', border: `2px solid ${o.color}`, pointerEvents: 'none', translate: '-50% -50%' });\n        el.appendChild(ring);\n        const a = ctx.animate(ring, [{ transform: 'scale(.4)', opacity: 0.9 }, { transform: 'scale(2.2)', opacity: 0 }], { duration: o.duration, delay: i * (o.duration / 3), easing: 'ease-out', fill: 'backwards' });\n        const end = () => ring.remove();\n        ctx.onCleanup(end);\n        return a ? a.finished.then(end, end) : (end(), undefined);\n      });\n      return Promise.all(all).then(() => undefined);\n    },\n  },\n  {\n    name: 'pin-drop',\n    kind: 'enter',\n    description: 'The element drops onto its spot with a squash and a landing shadow (`height`).',\n    defaults: { height: 80, duration: 700 },\n    run: (el: HTMLElement, o: any, ctx: EffectContext) => {\n      if (ctx.reduced) return fade(el, ctx);\n      const h = Math.max(10, Number(o.height) || 80);\n      ctx.animate(el, [{ filter: 'drop-shadow(0 0 0 rgba(0,0,0,0))' }, { filter: 'drop-shadow(0 6px 4px rgba(0,0,0,.35))', offset: 0.6 }, { filter: 'drop-shadow(0 2px 2px rgba(0,0,0,.2))' }], { duration: o.duration });\n      return ctx\n        .animate(\n          el,\n          [\n            { transform: `translateY(${-h}px)`, opacity: 0, easing: 'cubic-bezier(.5,0,.9,.5)' },\n            { transform: 'translateY(0) scale(1.08, .88)', opacity: 1, offset: 0.6 },\n            { transform: 'translateY(-8px) scale(.97, 1.04)', offset: 0.8 },\n            { transform: 'none', opacity: 1 },\n          ],\n          { duration: o.duration, fill: 'backwards' }\n        )\n        ?.finished.catch(() => undefined);\n    },\n  },\n  {\n    name: 'globe-spin',\n    kind: 'enter',\n    description: 'The element turns in like a globe coming round — rotateY with perspective (`turns`).',\n    defaults: { turns: 0.5, duration: 1100 },\n    run: (el: HTMLElement, o: any, ctx: EffectContext) => {\n      if (ctx.reduced) return fade(el, ctx);\n      const deg = Math.round(360 * (Number(o.turns) || 0.5));\n      return ctx\n        .animate(el, [{ transform: `perspective(600px) rotateY(${-deg}deg) scale(.8)`, opacity: 0 }, { transform: 'perspective(600px) rotateY(0) scale(1)', opacity: 1 }], { duration: o.duration, easing: 'cubic-bezier(.2,.8,.2,1)', fill: 'backwards' })\n        ?.finished.catch(() => undefined);\n    },\n  },\n];\n\n/** Register route-draw, marker-pulse, pin-drop and globe-spin (7.6). */\nexport function registerGeoPack(): void {\n  registerEffects(GEO_FX);\n}\n"],"names":["registerEffects"],"mappings":"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"}

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

@@ -0,0 +1,70 @@
+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.6 — Maps & geo motion (`motionary/fx/geo`, also `motionary/components/fx-geo`):
+ *
+ * - `route-draw` (enter) — every SVG `path` / `polyline` inside the element
+ *   (or `[data-route]` only, when present) draws itself along its length,
+ *   one after another (`duration`, `stagger`).
+ * - `marker-pulse` (attention) — rings expand out of the element like a
+ *   location beacon (`color`, `rings`).
+ * - `pin-drop` (enter) — the element drops onto its spot with a squash and a
+ *   landing shadow (`height`).
+ * - `globe-spin` (enter) — the element turns in like a globe coming round
+ *   (rotateY with perspective) (`turns`).
+ *
+ * Reduced motion: route-draw shows the routes, marker-pulse does nothing,
+ * pin-drop and globe-spin fade in.
+ */
+
+/** Length of a polyline through `points` (7.6). */
+declare function routeLength(points: {
+    x: number;
+    y: number;
+}[]): number;
+declare const GEO_FX: EffectDefinition[];
+/** Register route-draw, marker-pulse, pin-drop and globe-spin (7.6). */
+declare function registerGeoPack(): void;
+
+export { GEO_FX, registerGeoPack, routeLength };