use-scroll-animate 8.8.0 → 9.0.0

package/dist/components/dsl.d.cts

@@ -0,0 +1,76 @@
+/**
+ * 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_TRIGGERS: readonly ["click", "hover", "enter", "load", "loop", "manual"];
+type EffectTrigger = (typeof EFFECT_TRIGGERS)[number];
+
+/**
+ * `motionary/dsl` (= `motionary/components/dsl`, 9.0) — the declarative
+ * motion DSL. Describe motion as one readable string instead of code:
+ *
+ * ```html
+ * <section data-motion="enter: fade-up 600ms ease-out stagger 80ms; hover: pop; click: confetti count=40">
+ * ```
+ *
+ * Grammar — rules separated by `;`, each `trigger: effect [modifiers…]`:
+ * - trigger: `enter` · `click` · `hover` · `load` · `loop` · `manual`
+ * - effect: any registered effect name (timeline presets, packs, plugins)
+ * - modifiers: a duration (`600ms` / `0.6s`), `delay 120ms`,
+ *   `stagger 80ms` (children one after another), an easing (`ease-out`,
+ *   `linear`, `spring`, `cubic-bezier(…)`, `steps(…)`), `once`, and
+ *   `key=value` effect options (numbers / booleans parsed).
+ *
+ * `parseMotion()` → rules + errors, `serializeMotion()` back to a string,
+ * `motion\`…\`` tagged template, `applyMotion(root)` binds every
+ * `[data-motion]` under `root` (and watches for new ones with `observe`),
+ * `bindMotion(el, rules)` for one element, and `createComponent(json)`
+ * builds live markup from the 8.9 `describeComponent()` JSON.
+ */
+
+interface MotionRule {
+    trigger: EffectTrigger;
+    effect: string;
+    duration?: number;
+    delay?: number;
+    stagger?: number;
+    easing?: string;
+    once?: boolean;
+    options: Record<string, string | number | boolean>;
+}
+interface MotionParse {
+    rules: MotionRule[];
+    errors: string[];
+}
+/** Parse a motion string into rules (+ human-readable errors for what was skipped) (9.0). */
+declare function parseMotion(src: string): MotionParse;
+/** Rules back to the canonical motion string (9.0). */
+declare function serializeMotion(rules: MotionRule[]): string;
+/** Tagged template: motion`enter: fade-up ${dur}ms` → the motion string (validated in dev via `parseMotion`) (9.0). */
+declare function motion(strings: TemplateStringsArray, ...vals: unknown[]): string;
+/** Bind parsed rules (or a motion string) to one element; returns the cleanup (9.0). */
+declare function bindMotion(el: HTMLElement, rules: MotionRule[] | string, onError?: (msg: string) => void): () => void;
+/** Bind every `[data-motion]` under `root` (default `document`); `observe` also binds ones added later. Returns { errors, cleanup } (9.0). */
+declare function applyMotion(root?: ParentNode, opts?: {
+    observe?: boolean;
+    attribute?: string;
+}): {
+    errors: string[];
+    cleanup: () => void;
+};
+interface ComponentJSON {
+    $schema?: string;
+    tag: string;
+    attrs?: Record<string, string>;
+    children?: (ComponentJSON | string)[];
+}
+/** Build live markup from the 8.9 `describeComponent()` / `exportComponent(el, 'json')` format (9.0). */
+declare function createComponent(desc: ComponentJSON | string): Element;
+
+export { applyMotion, bindMotion, createComponent, motion, parseMotion, serializeMotion };
+export type { ComponentJSON, MotionParse, MotionRule };

package/dist/components/dsl.d.ts

@@ -0,0 +1,76 @@
+/**
+ * 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_TRIGGERS: readonly ["click", "hover", "enter", "load", "loop", "manual"];
+type EffectTrigger = (typeof EFFECT_TRIGGERS)[number];
+
+/**
+ * `motionary/dsl` (= `motionary/components/dsl`, 9.0) — the declarative
+ * motion DSL. Describe motion as one readable string instead of code:
+ *
+ * ```html
+ * <section data-motion="enter: fade-up 600ms ease-out stagger 80ms; hover: pop; click: confetti count=40">
+ * ```
+ *
+ * Grammar — rules separated by `;`, each `trigger: effect [modifiers…]`:
+ * - trigger: `enter` · `click` · `hover` · `load` · `loop` · `manual`
+ * - effect: any registered effect name (timeline presets, packs, plugins)
+ * - modifiers: a duration (`600ms` / `0.6s`), `delay 120ms`,
+ *   `stagger 80ms` (children one after another), an easing (`ease-out`,
+ *   `linear`, `spring`, `cubic-bezier(…)`, `steps(…)`), `once`, and
+ *   `key=value` effect options (numbers / booleans parsed).
+ *
+ * `parseMotion()` → rules + errors, `serializeMotion()` back to a string,
+ * `motion\`…\`` tagged template, `applyMotion(root)` binds every
+ * `[data-motion]` under `root` (and watches for new ones with `observe`),
+ * `bindMotion(el, rules)` for one element, and `createComponent(json)`
+ * builds live markup from the 8.9 `describeComponent()` JSON.
+ */
+
+interface MotionRule {
+    trigger: EffectTrigger;
+    effect: string;
+    duration?: number;
+    delay?: number;
+    stagger?: number;
+    easing?: string;
+    once?: boolean;
+    options: Record<string, string | number | boolean>;
+}
+interface MotionParse {
+    rules: MotionRule[];
+    errors: string[];
+}
+/** Parse a motion string into rules (+ human-readable errors for what was skipped) (9.0). */
+declare function parseMotion(src: string): MotionParse;
+/** Rules back to the canonical motion string (9.0). */
+declare function serializeMotion(rules: MotionRule[]): string;
+/** Tagged template: motion`enter: fade-up ${dur}ms` → the motion string (validated in dev via `parseMotion`) (9.0). */
+declare function motion(strings: TemplateStringsArray, ...vals: unknown[]): string;
+/** Bind parsed rules (or a motion string) to one element; returns the cleanup (9.0). */
+declare function bindMotion(el: HTMLElement, rules: MotionRule[] | string, onError?: (msg: string) => void): () => void;
+/** Bind every `[data-motion]` under `root` (default `document`); `observe` also binds ones added later. Returns { errors, cleanup } (9.0). */
+declare function applyMotion(root?: ParentNode, opts?: {
+    observe?: boolean;
+    attribute?: string;
+}): {
+    errors: string[];
+    cleanup: () => void;
+};
+interface ComponentJSON {
+    $schema?: string;
+    tag: string;
+    attrs?: Record<string, string>;
+    children?: (ComponentJSON | string)[];
+}
+/** Build live markup from the 8.9 `describeComponent()` / `exportComponent(el, 'json')` format (9.0). */
+declare function createComponent(desc: ComponentJSON | string): Element;
+
+export { applyMotion, bindMotion, createComponent, motion, parseMotion, serializeMotion };
+export type { ComponentJSON, MotionParse, MotionRule };

package/dist/components/dsl.js

@@ -0,0 +1,203 @@
+import { hasEffect, bindEffect, EFFECT_TRIGGERS } from '../chunks/registry-CnO7ZVPK.js';
+import '../chunks/base-CLuqlLfG.js';
+
+/**
+ * `motionary/dsl` (= `motionary/components/dsl`, 9.0) — the declarative
+ * motion DSL. Describe motion as one readable string instead of code:
+ *
+ * ```html
+ * <section data-motion="enter: fade-up 600ms ease-out stagger 80ms; hover: pop; click: confetti count=40">
+ * ```
+ *
+ * Grammar — rules separated by `;`, each `trigger: effect [modifiers…]`:
+ * - trigger: `enter` · `click` · `hover` · `load` · `loop` · `manual`
+ * - effect: any registered effect name (timeline presets, packs, plugins)
+ * - modifiers: a duration (`600ms` / `0.6s`), `delay 120ms`,
+ *   `stagger 80ms` (children one after another), an easing (`ease-out`,
+ *   `linear`, `spring`, `cubic-bezier(…)`, `steps(…)`), `once`, and
+ *   `key=value` effect options (numbers / booleans parsed).
+ *
+ * `parseMotion()` → rules + errors, `serializeMotion()` back to a string,
+ * `motion\`…\`` tagged template, `applyMotion(root)` binds every
+ * `[data-motion]` under `root` (and watches for new ones with `observe`),
+ * `bindMotion(el, rules)` for one element, and `createComponent(json)`
+ * builds live markup from the 8.9 `describeComponent()` JSON.
+ */
+const EASINGS = { ease: 'ease', 'ease-in': 'ease-in', 'ease-out': 'ease-out', 'ease-in-out': 'ease-in-out', linear: 'linear', spring: 'cubic-bezier(0.34, 1.56, 0.64, 1)', smooth: 'cubic-bezier(0.22, 1, 0.36, 1)' };
+const TIME = /^(\d+(?:\.\d+)?)(ms|s)$/;
+const time = (t) => {
+    const m = t.match(TIME);
+    return m ? Math.round(Number(m[1]) * (m[2] === 's' ? 1000 : 1)) : undefined;
+};
+const value = (v) => (v === 'true' ? true : v === 'false' ? false : v !== '' && !Number.isNaN(Number(v)) ? Number(v) : v);
+/** Split on whitespace, keeping `fn(…)` groups together. */
+function tokens(s) {
+    const out = [];
+    let cur = '';
+    let depth = 0;
+    for (const ch of s) {
+        if (ch === '(')
+            depth++;
+        if (ch === ')')
+            depth = Math.max(0, depth - 1);
+        if (/\s/.test(ch) && !depth) {
+            if (cur)
+                out.push(cur);
+            cur = '';
+        }
+        else
+            cur += ch;
+    }
+    if (cur)
+        out.push(cur);
+    return out;
+}
+/** Parse a motion string into rules (+ human-readable errors for what was skipped) (9.0). */
+function parseMotion(src) {
+    const rules = [];
+    const errors = [];
+    for (const raw of src.split(';')) {
+        const part = raw.trim();
+        if (!part)
+            continue;
+        const i = part.indexOf(':');
+        if (i < 0) {
+            errors.push(`"${part}": expected "trigger: effect"`);
+            continue;
+        }
+        const trigger = part.slice(0, i).trim();
+        if (!EFFECT_TRIGGERS.includes(trigger)) {
+            errors.push(`"${trigger}": unknown trigger (${EFFECT_TRIGGERS.join(', ')})`);
+            continue;
+        }
+        const [effect, ...mods] = tokens(part.slice(i + 1));
+        if (!effect || !/^[a-z][a-z0-9-]*$/.test(effect)) {
+            errors.push(`"${part}": missing effect name`);
+            continue;
+        }
+        const r = { trigger, effect, options: {} };
+        for (let k = 0; k < mods.length; k++) {
+            const m = mods[k];
+            if ((m === 'delay' || m === 'stagger') && time(mods[k + 1] || '') != null)
+                r[m] = time(mods[++k]);
+            else if (time(m) != null)
+                r.duration = time(m);
+            else if (m === 'once')
+                r.once = true;
+            else if (EASINGS[m])
+                r.easing = EASINGS[m];
+            else if (/^(cubic-bezier|steps|linear)\(.*\)$/.test(m))
+                r.easing = m;
+            else if (/^[a-zA-Z][\w-]*=/.test(m)) {
+                const j = m.indexOf('=');
+                r.options[m.slice(0, j)] = value(m.slice(j + 1));
+            }
+            else
+                errors.push(`"${m}" in "${part}": unknown modifier`);
+        }
+        rules.push(r);
+    }
+    return { rules, errors };
+}
+/** Rules back to the canonical motion string (9.0). */
+function serializeMotion(rules) {
+    const inv = Object.fromEntries(Object.entries(EASINGS).map(([k, v]) => [v, k]));
+    return rules
+        .map((r) => {
+        const p = [`${r.trigger}: ${r.effect}`];
+        if (r.duration != null)
+            p.push(`${r.duration}ms`);
+        if (r.easing)
+            p.push(inv[r.easing] && inv[r.easing] !== 'ease' ? inv[r.easing] : r.easing);
+        if (r.delay != null)
+            p.push(`delay ${r.delay}ms`);
+        if (r.stagger != null)
+            p.push(`stagger ${r.stagger}ms`);
+        if (r.once)
+            p.push('once');
+        for (const [k, v] of Object.entries(r.options))
+            p.push(`${k}=${v}`);
+        return p.join(' ');
+    })
+        .join('; ');
+}
+/** Tagged template: motion`enter: fade-up ${dur}ms` → the motion string (validated in dev via `parseMotion`) (9.0). */
+function motion(strings, ...vals) {
+    return strings.reduce((a, s, i) => a + s + (i < vals.length ? String(vals[i]) : ''), '').replace(/\s+/g, ' ').trim();
+}
+/** Bind parsed rules (or a motion string) to one element; returns the cleanup (9.0). */
+function bindMotion(el, rules, onError) {
+    const parsed = typeof rules === 'string' ? parseMotion(rules) : { rules, errors: [] };
+    parsed.errors.forEach((e) => onError?.(e));
+    const cleanups = [];
+    for (const r of parsed.rules) {
+        if (!hasEffect(r.effect)) {
+            onError?.(`"${r.effect}": effect not registered (register its pack or plugin first)`);
+            continue;
+        }
+        const opts = { ...r.options, trigger: r.trigger };
+        if (r.duration != null)
+            opts.duration = r.duration;
+        if (r.easing)
+            opts.easing = r.easing;
+        if (r.once)
+            opts.once = true;
+        const targets = r.stagger != null && el.children.length ? Array.from(el.children) : [el];
+        targets.forEach((t, i) => {
+            const delay = (r.delay || 0) + (r.stagger || 0) * i;
+            try {
+                cleanups.push(bindEffect(t, r.effect, delay ? { ...opts, delay } : opts));
+            }
+            catch (e) {
+                onError?.(String(e.message || e));
+            }
+        });
+    }
+    return () => cleanups.splice(0).forEach((c) => c());
+}
+/** Bind every `[data-motion]` under `root` (default `document`); `observe` also binds ones added later. Returns { errors, cleanup } (9.0). */
+function applyMotion(root = document, opts = {}) {
+    const attr = opts.attribute || 'data-motion';
+    const errors = [];
+    const bound = new Map();
+    const bindOne = (el) => {
+        if (bound.has(el))
+            return;
+        bound.set(el, bindMotion(el, el.getAttribute(attr) || '', (m) => errors.push(m)));
+    };
+    const scan = (n) => {
+        if (n.hasAttribute?.(attr))
+            bindOne(n);
+        n.querySelectorAll?.(`[${attr}]`).forEach(bindOne);
+    };
+    scan(root);
+    let mo = null;
+    if (opts.observe && typeof MutationObserver !== 'undefined') {
+        mo = new MutationObserver((list) => list.forEach((m) => m.addedNodes.forEach((n) => n.nodeType === 1 && scan(n))));
+        mo.observe(root, { childList: true, subtree: true });
+    }
+    return {
+        errors,
+        cleanup: () => {
+            mo?.disconnect();
+            bound.forEach((c) => c());
+            bound.clear();
+        },
+    };
+}
+/** Build live markup from the 8.9 `describeComponent()` / `exportComponent(el, 'json')` format (9.0). */
+function createComponent(desc) {
+    const d = typeof desc === 'string' ? JSON.parse(desc) : desc;
+    if (!d || typeof d.tag !== 'string' || !/^[a-z][a-z0-9-]*$/.test(d.tag) || d.tag === 'script')
+        throw new Error('[motionary] createComponent: invalid tag');
+    const el = document.createElement(d.tag);
+    for (const [k, v] of Object.entries(d.attrs || {}))
+        if (!/^on/i.test(k))
+            el.setAttribute(k, String(v));
+    for (const c of d.children || [])
+        el.append(typeof c === 'string' ? document.createTextNode(c) : createComponent(c));
+    return el;
+}
+
+export { applyMotion, bindMotion, createComponent, motion, parseMotion, serializeMotion };
+//# sourceMappingURL=dsl.js.map

package/dist/components/dsl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dsl.js","sources":["../../src/components/dsl/index.ts"],"sourcesContent":["/**\n * `motionary/dsl` (= `motionary/components/dsl`, 9.0) — the declarative\n * motion DSL. Describe motion as one readable string instead of code:\n *\n * ```html\n * <section data-motion=\"enter: fade-up 600ms ease-out stagger 80ms; hover: pop; click: confetti count=40\">\n * ```\n *\n * Grammar — rules separated by `;`, each `trigger: effect [modifiers…]`:\n * - trigger: `enter` · `click` · `hover` · `load` · `loop` · `manual`\n * - effect: any registered effect name (timeline presets, packs, plugins)\n * - modifiers: a duration (`600ms` / `0.6s`), `delay 120ms`,\n *   `stagger 80ms` (children one after another), an easing (`ease-out`,\n *   `linear`, `spring`, `cubic-bezier(…)`, `steps(…)`), `once`, and\n *   `key=value` effect options (numbers / booleans parsed).\n *\n * `parseMotion()` → rules + errors, `serializeMotion()` back to a string,\n * `motion\\`…\\`` tagged template, `applyMotion(root)` binds every\n * `[data-motion]` under `root` (and watches for new ones with `observe`),\n * `bindMotion(el, rules)` for one element, and `createComponent(json)`\n * builds live markup from the 8.9 `describeComponent()` JSON.\n */\nimport { bindEffect, hasEffect, EFFECT_TRIGGERS, type EffectTrigger } from '../fx/registry';\n\nexport interface MotionRule {\n  trigger: EffectTrigger;\n  effect: string;\n  duration?: number;\n  delay?: number;\n  stagger?: number;\n  easing?: string;\n  once?: boolean;\n  options: Record<string, string | number | boolean>;\n}\nexport interface MotionParse {\n  rules: MotionRule[];\n  errors: string[];\n}\n\nconst EASINGS: Record<string, string> = { ease: 'ease', 'ease-in': 'ease-in', 'ease-out': 'ease-out', 'ease-in-out': 'ease-in-out', linear: 'linear', spring: 'cubic-bezier(0.34, 1.56, 0.64, 1)', smooth: 'cubic-bezier(0.22, 1, 0.36, 1)' };\nconst TIME = /^(\\d+(?:\\.\\d+)?)(ms|s)$/;\nconst time = (t: string): number | undefined => {\n  const m = t.match(TIME);\n  return m ? Math.round(Number(m[1]) * (m[2] === 's' ? 1000 : 1)) : undefined;\n};\nconst value = (v: string): string | number | boolean => (v === 'true' ? true : v === 'false' ? false : v !== '' && !Number.isNaN(Number(v)) ? Number(v) : v);\n\n/** Split on whitespace, keeping `fn(…)` groups together. */\nfunction tokens(s: string): string[] {\n  const out: string[] = [];\n  let cur = '';\n  let depth = 0;\n  for (const ch of s) {\n    if (ch === '(') depth++;\n    if (ch === ')') depth = Math.max(0, depth - 1);\n    if (/\\s/.test(ch) && !depth) {\n      if (cur) out.push(cur);\n      cur = '';\n    } else cur += ch;\n  }\n  if (cur) out.push(cur);\n  return out;\n}\n\n/** Parse a motion string into rules (+ human-readable errors for what was skipped) (9.0). */\nexport function parseMotion(src: string): MotionParse {\n  const rules: MotionRule[] = [];\n  const errors: string[] = [];\n  for (const raw of src.split(';')) {\n    const part = raw.trim();\n    if (!part) continue;\n    const i = part.indexOf(':');\n    if (i < 0) {\n      errors.push(`\"${part}\": expected \"trigger: effect\"`);\n      continue;\n    }\n    const trigger = part.slice(0, i).trim() as EffectTrigger;\n    if (!(EFFECT_TRIGGERS as readonly string[]).includes(trigger)) {\n      errors.push(`\"${trigger}\": unknown trigger (${EFFECT_TRIGGERS.join(', ')})`);\n      continue;\n    }\n    const [effect, ...mods] = tokens(part.slice(i + 1));\n    if (!effect || !/^[a-z][a-z0-9-]*$/.test(effect)) {\n      errors.push(`\"${part}\": missing effect name`);\n      continue;\n    }\n    const r: MotionRule = { trigger, effect, options: {} };\n    for (let k = 0; k < mods.length; k++) {\n      const m = mods[k];\n      if ((m === 'delay' || m === 'stagger') && time(mods[k + 1] || '') != null) r[m] = time(mods[++k]);\n      else if (time(m) != null) r.duration = time(m);\n      else if (m === 'once') r.once = true;\n      else if (EASINGS[m]) r.easing = EASINGS[m];\n      else if (/^(cubic-bezier|steps|linear)\\(.*\\)$/.test(m)) r.easing = m;\n      else if (/^[a-zA-Z][\\w-]*=/.test(m)) {\n        const j = m.indexOf('=');\n        r.options[m.slice(0, j)] = value(m.slice(j + 1));\n      } else errors.push(`\"${m}\" in \"${part}\": unknown modifier`);\n    }\n    rules.push(r);\n  }\n  return { rules, errors };\n}\n\n/** Rules back to the canonical motion string (9.0). */\nexport function serializeMotion(rules: MotionRule[]): string {\n  const inv = Object.fromEntries(Object.entries(EASINGS).map(([k, v]) => [v, k]));\n  return rules\n    .map((r) => {\n      const p: string[] = [`${r.trigger}: ${r.effect}`];\n      if (r.duration != null) p.push(`${r.duration}ms`);\n      if (r.easing) p.push(inv[r.easing] && inv[r.easing] !== 'ease' ? inv[r.easing] : r.easing);\n      if (r.delay != null) p.push(`delay ${r.delay}ms`);\n      if (r.stagger != null) p.push(`stagger ${r.stagger}ms`);\n      if (r.once) p.push('once');\n      for (const [k, v] of Object.entries(r.options)) p.push(`${k}=${v}`);\n      return p.join(' ');\n    })\n    .join('; ');\n}\n\n/** Tagged template: motion`enter: fade-up ${dur}ms` → the motion string (validated in dev via `parseMotion`) (9.0). */\nexport function motion(strings: TemplateStringsArray, ...vals: unknown[]): string {\n  return strings.reduce((a, s, i) => a + s + (i < vals.length ? String(vals[i]) : ''), '').replace(/\\s+/g, ' ').trim();\n}\n\n/** Bind parsed rules (or a motion string) to one element; returns the cleanup (9.0). */\nexport function bindMotion(el: HTMLElement, rules: MotionRule[] | string, onError?: (msg: string) => void): () => void {\n  const parsed = typeof rules === 'string' ? parseMotion(rules) : { rules, errors: [] };\n  parsed.errors.forEach((e) => onError?.(e));\n  const cleanups: (() => void)[] = [];\n  for (const r of parsed.rules) {\n    if (!hasEffect(r.effect)) {\n      onError?.(`\"${r.effect}\": effect not registered (register its pack or plugin first)`);\n      continue;\n    }\n    const opts: Record<string, unknown> = { ...r.options, trigger: r.trigger };\n    if (r.duration != null) opts.duration = r.duration;\n    if (r.easing) opts.easing = r.easing;\n    if (r.once) opts.once = true;\n    const targets = r.stagger != null && el.children.length ? (Array.from(el.children) as HTMLElement[]) : [el];\n    targets.forEach((t, i) => {\n      const delay = (r.delay || 0) + (r.stagger || 0) * i;\n      try {\n        cleanups.push(bindEffect(t, r.effect, delay ? { ...opts, delay } : opts));\n      } catch (e) {\n        onError?.(String((e as Error).message || e));\n      }\n    });\n  }\n  return () => cleanups.splice(0).forEach((c) => c());\n}\n\n/** Bind every `[data-motion]` under `root` (default `document`); `observe` also binds ones added later. Returns { errors, cleanup } (9.0). */\nexport function applyMotion(root: ParentNode = document, opts: { observe?: boolean; attribute?: string } = {}): { errors: string[]; cleanup: () => void } {\n  const attr = opts.attribute || 'data-motion';\n  const errors: string[] = [];\n  const bound = new Map<Element, () => void>();\n  const bindOne = (el: Element) => {\n    if (bound.has(el)) return;\n    bound.set(el, bindMotion(el as HTMLElement, el.getAttribute(attr) || '', (m) => errors.push(m)));\n  };\n  const scan = (n: ParentNode) => {\n    if ((n as Element).hasAttribute?.(attr)) bindOne(n as Element);\n    n.querySelectorAll?.(`[${attr}]`).forEach(bindOne);\n  };\n  scan(root);\n  let mo: MutationObserver | null = null;\n  if (opts.observe && typeof MutationObserver !== 'undefined') {\n    mo = new MutationObserver((list) => list.forEach((m) => m.addedNodes.forEach((n) => n.nodeType === 1 && scan(n as Element))));\n    mo.observe(root as Node, { childList: true, subtree: true });\n  }\n  return {\n    errors,\n    cleanup: () => {\n      mo?.disconnect();\n      bound.forEach((c) => c());\n      bound.clear();\n    },\n  };\n}\n\nexport interface ComponentJSON {\n  $schema?: string;\n  tag: string;\n  attrs?: Record<string, string>;\n  children?: (ComponentJSON | string)[];\n}\n/** Build live markup from the 8.9 `describeComponent()` / `exportComponent(el, 'json')` format (9.0). */\nexport function createComponent(desc: ComponentJSON | string): Element {\n  const d: ComponentJSON = typeof desc === 'string' ? JSON.parse(desc) : desc;\n  if (!d || typeof d.tag !== 'string' || !/^[a-z][a-z0-9-]*$/.test(d.tag) || d.tag === 'script') throw new Error('[motionary] createComponent: invalid tag');\n  const el = document.createElement(d.tag);\n  for (const [k, v] of Object.entries(d.attrs || {})) if (!/^on/i.test(k)) el.setAttribute(k, String(v));\n  for (const c of d.children || []) el.append(typeof c === 'string' ? document.createTextNode(c) : createComponent(c));\n  return el;\n}\n"],"names":[],"mappings":"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"}

package/dist/components/effects.cjs

@@ -1124,7 +1124,7 @@ const P = (enter, hover, click, attention, background) => ({
     attention: { effect: attention },
     background: { effect: background },
 });
-const THEMES = {
+const MOTION_THEMES = {
     neon: {
         name: 'neon',
         vars: { bg: '#07070c', fg: '#e8e8ff', accent: '#22d3ee', 'accent-2': '#ff2bd6', surface: '#11111c', border: '1px solid #22d3ee', radius: '10px', shadow: '0 0 18px #22d3ee66, inset 0 0 12px #ff2bd622', font: 'ui-monospace, SFMono-Regular, Menlo, monospace' },
@@ -1156,15 +1156,15 @@ const THEMES = {
         presets: P('drop-bounce', 'jelly', 'brutal-shift', 'shake', 'voronoi'),
     },
 };
-const THEME_NAMES = Object.keys(THEMES);
+const MOTION_THEME_NAMES = Object.keys(MOTION_THEMES);
 const BASE_CSS = `[data-usa-theme]{background:var(--usa-theme-bg);color:var(--usa-theme-fg);font-family:var(--usa-theme-font)}
 [data-usa-theme] .usa-surface{background:var(--usa-theme-surface);border:var(--usa-theme-border);border-radius:var(--usa-theme-radius);box-shadow:var(--usa-theme-shadow)}
 [data-usa-theme] .usa-accent{color:var(--usa-theme-accent)}
 [data-usa-theme=glass] .usa-surface{-webkit-backdrop-filter:blur(14px);backdrop-filter:blur(14px)}`;
 const pack = (t) => {
-    const p = typeof t === 'string' ? THEMES[t] : t;
+    const p = typeof t === 'string' ? MOTION_THEMES[t] : t;
     if (!p)
-        throw new Error(`[motionary] unknown theme "${String(t)}" — ${THEME_NAMES.join(', ')}`);
+        throw new Error(`[motionary] unknown theme "${String(t)}" — ${MOTION_THEME_NAMES.join(', ')}`);
     return p;
 };
 /** The CSS custom properties of a theme (design + motion tokens). */
@@ -1180,8 +1180,8 @@ function themeCss(t, selector) {
     const p = pack(t);
     return `${selector || `[data-usa-theme=${p.name}]`}{${Object.entries(themeVars(p)).map(([k, v]) => `${k}:${v}`).join(';')}}`;
 }
-/** Apply a theme to `root` (default `<html>`). Returns an undo. */
-function applyTheme(t, root) {
+/** Apply a 5.8 motion theme to `root` (default `<html>`). Returns an undo (8.9). */
+function applyMotionTheme(t, root) {
     const p = pack(t);
     const el = root || document.documentElement;
     base.adoptStyles('usa-theme', BASE_CSS);
@@ -1270,17 +1270,17 @@ const THEME_FX = [
     },
 ];
 /** `<usa-theme name="neon | paper | glass | retro | brutalist">` — a themed subtree. */
-function defineTheme(tag = 'usa-theme') {
+function defineMotionTheme(tag = 'usa-motion-theme') {
     return base.defineElement(tag, (Base) => class UsaTheme extends Base {
         static get observedAttributes() {
             return ['name'];
         }
         get theme() {
             const n = this.str('name', 'neon');
-            return THEMES[n] ? n : 'neon';
+            return MOTION_THEMES[n] ? n : 'neon';
         }
         mount() {
-            this.onCleanup(applyTheme(this.theme, this));
+            this.onCleanup(applyMotionTheme(this.theme, this));
             this.querySelectorAll('[data-theme-fx]').forEach((el) => {
                 const role = (el.dataset.themeFx || 'click');
                 if (!THEME_ROLES.includes(role))
@@ -1355,7 +1355,7 @@ function defineEffectElements() {
     player.defineStory();
     audio.defineAudio();
     defineGestureFx();
-    defineTheme();
+    defineMotionTheme();
     player.definePlayer();
 }
 /** Register the built-ins and every pack (idempotent). */
@@ -1392,20 +1392,20 @@ exports.CURSOR_FX = CURSOR_FX;
 exports.EFFECT_PACKS = EFFECT_PACKS;
 exports.GESTURES = GESTURES;
 exports.MICRO_FX = MICRO_FX;
+exports.MOTION_THEMES = MOTION_THEMES;
+exports.MOTION_THEME_NAMES = MOTION_THEME_NAMES;
 exports.PAGE_FX = PAGE_FX;
 exports.PHYSICS_FX = PHYSICS_FX;
-exports.THEMES = THEMES;
 exports.THEME_FX = THEME_FX;
-exports.THEME_NAMES = THEME_NAMES;
 exports.THEME_ROLES = THEME_ROLES;
 exports.angleDelta = angleDelta;
-exports.applyTheme = applyTheme;
+exports.applyMotionTheme = applyMotionTheme;
 exports.bindGesture = bindGesture;
 exports.bounceKeyframes = bounceKeyframes;
 exports.bumpCount = bumpCount;
 exports.defineEffectElements = defineEffectElements;
 exports.defineGestureFx = defineGestureFx;
-exports.defineTheme = defineTheme;
+exports.defineMotionTheme = defineMotionTheme;
 exports.flingVelocity = flingVelocity;
 exports.playThemeEffect = playThemeEffect;
 exports.registerAllEffects = registerAllEffects;