use-scroll-animate 8.9.0 → 9.0.0

package/CHANGELOG.md

@@ -7,6 +7,25 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [9.0.0] - 2026-10-09
+
+### ⚠ Breaking
+- Removed the 8.9 deprecations: `applyTheme()`, `THEMES`, `THEME_NAMES`, `<usa-theme>` / `defineTheme()` (`motionary/components/effects`). Use `applyMotionTheme()`, `MOTION_THEMES`, `MOTION_THEME_NAMES`, `<usa-motion-theme>` / `defineMotionTheme()` — same behaviour. `npx usa-codemod-9 --write src` rewrites identifiers and tags; see [docs/upgrading-9.md](docs/upgrading-9.md).
+
+### Added
+- **Declarative motion DSL — `motionary/dsl`** (= `motionary/components/dsl`): one readable string per element — `data-motion="enter: fade-up 600ms ease-out stagger 80ms; hover: pop; click: confetti count=40"`. Triggers `enter` · `click` · `hover` · `load` · `loop` · `manual`; modifiers: duration (`600ms` / `0.6s`), `delay`, `stagger` (children in turn — `delay` / `stagger` are passed as the effect's `delay` option, honoured by the entrance presets and every effect that takes one), easing (`ease-out`, `spring`, `smooth`, `cubic-bezier(…)`, `steps(…)`), `once`, `key=value` effect options. `applyMotion(root, { observe })`, `bindMotion(el, rules)`, `parseMotion()` (rules + readable errors), `serializeMotion()`, `motion` tagged template, `createComponent(json)` (builds live markup from the 8.9 `describeComponent()` JSON).
+- **Plugin marketplace GA — `motionary/marketplace`** (`motionary/components/marketplace` now re-exports it and keeps the 6.9 manifest API): `MARKETPLACE` (first-party catalogue of the 8.x effect packs), `searchPlugins(query)`, `installPlugin(listing | url, { load })` (first-party registrar or validated third-party pack), `installedPlugins()`, `fetchMarketplace(url)` (`motionary/marketplace` v1 index).
+- **2 new components (9.0)** in `motionary/components/widgets`: `<usa-motion rules="…">` (the DSL as an element; `parsed`, `errors`, `usa:motion-error`) and `<usa-plugin-store>` (search + one-click install with staggered result cards; `plugins`, `loader`, `search()`, `install()`; `usa:install` / `usa:install-error`).
+- Chinese roadmap 9.1 → 10.0 (`docs/ROADMAP.md`). `motionary` and `use-scroll-animate` are published with the npm `latest` tag.
+
+### Accessibility
+- `<usa-plugin-store>` is a labelled `search` region with a labelled search field, a live result count and real buttons whose text reports the install state. `<usa-motion>` adds no semantics; effects bound by the DSL honour reduced motion like every other effect.
+
+### Fixed
+- `<usa-plugin-store>` called `CSS.escape` without checking that the `CSS` global exists (throws in jsdom / some SSR shims) — now guarded with a fallback.
+- the 9.0 removal check treated the internal style-sheet id and the theme switcher's `localStorage` key `'usa-theme'` as leftovers of `<usa-theme>`; they are kept (saved theme choices survive the upgrade).
+- the gallery / Store motion-theme cards still named the removed `defineTheme` (they would not have defined their element) → `defineMotionTheme`.
+
 ## [8.9.0] - 2026-10-09
 
 ### Added

package/README.md

@@ -134,7 +134,7 @@ Animated components need no framework at all:
 | **Generative backgrounds** | 6 canvas backgrounds (flow-field, voronoi, mesh-gradient, starfield, metaballs, contours) + 9 background elements (aurora, particles, grain, blobs, water ripple, Acrylic / Mica, …) |
 | **Sound-reactive** | `<usa-audio>` + Web Audio beat detection (`createBeatDetector()`, `onBeat()`); 3 audio visualisers (spectrum-bars, pulse-ring, wave-ring); any effect can fire on the beat |
 | **Cursor & gestures** | 5 cursor effects (comet / ribbon / sparkle trails, magnetic dots, spotlight) + `<usa-cursor>`; fling · twist · long-press → effects with `<usa-gesture-fx>`; `<usa-swipeable>`, `<usa-pinch-zoom>` |
-| **Themes** | 5 theme packs (neon · paper · glass · retro · brutalist) via `<usa-theme>` / `applyTheme()`, each with a signature effect; motion tokens (`/components/tokens`) |
+| **Themes** | 5 theme packs (neon · paper · glass · retro · brutalist) via `<usa-motion-theme>` / `applyMotionTheme()`, each with a signature effect; motion tokens (`/components/tokens`) |
 | **Micro-interactions** | 23 ready-made UI moments: copy-success, like-heart, add-to-cart, send-plane, upvote, trash-shake, input-shake, success-check, notify-badge, … |
 | **`<usa-player>` & stories** | `<usa-player>` plays JSON animations (keyframe tracks, presets, effects; load / view / scroll / click triggers) exported from the Playground; `<usa-story>` with 6 scroll-story templates |
 | **WebGL** | `<usa-shader>`, `<usa-distort>`, `<usa-liquid>`, `<usa-post-fx>` — 5 particle presets, 9 post effects (bloom, CRT, chromatic, glitch, …) with CSS fallbacks and a power-saving governor |
@@ -166,7 +166,7 @@ Import one category (`motionary/components/cards`), everything (`motionary/compo
 | **Layout** (`/components/layout`) | `<usa-auto-animate>` · `<usa-masonry>` |
 | **Packs** (`/components/packs`) | `<usa-pack>` |
 | **Effect registry** (`/components/fx`) | `<usa-fx>` |
-| **Effect packs** (`/components/effects`) | `<usa-player>` · `<usa-story>` · `<usa-audio>` · `<usa-theme>` · `<usa-gesture-fx>` |
+| **Effect packs** (`/components/effects`) | `<usa-player>` · `<usa-story>` · `<usa-audio>` · `<usa-motion-theme>` · `<usa-gesture-fx>` |
 
 ## Accessibility & reduced motion
 

package/README_ja.md

@@ -132,7 +132,7 @@ export class Hero {}
 | **ジェネラティブ背景** | キャンバス背景 6 種（flow-field・voronoi・mesh-gradient・starfield・metaballs・contours）+ 背景要素 9 種（オーロラ・パーティクル・グレイン・Acrylic / Mica など） |
 | **サウンド連動** | `<usa-audio>` と Web Audio のビート検出（`createBeatDetector()`・`onBeat()`）、オーディオビジュアライザー 3 種、任意のエフェクトをビートで発火 |
 | **カーソル・ジェスチャー** | カーソルエフェクト 5 種 + `<usa-cursor>`、fling · twist · long-press でエフェクト（`<usa-gesture-fx>`）、`<usa-swipeable>`・`<usa-pinch-zoom>` |
-| **テーマ** | テーマ 5 種（neon · paper · glass · retro · brutalist）を `<usa-theme>` / `applyTheme()` で、各テーマに専用エフェクト。モーショントークン（`/components/tokens`） |
+| **テーマ** | テーマ 5 種（neon · paper · glass · retro · brutalist）を `<usa-motion-theme>` / `applyMotionTheme()` で、各テーマに専用エフェクト。モーショントークン（`/components/tokens`） |
 | **マイクロインタラクション** | 既製の UI 演出 23 種：copy-success・like-heart・add-to-cart・send-plane・upvote・trash-shake など |
 | **`<usa-player>` とストーリー** | `<usa-player>` は Playground から書き出した JSON アニメーションを再生（キーフレーム・プリセット・エフェクト、load / view / scroll / click トリガー）。`<usa-story>` のストーリーテンプレート 6 種 |
 | **WebGL** | `<usa-shader>`・`<usa-distort>`・`<usa-liquid>`・`<usa-post-fx>` — パーティクル 5 種、ポストエフェクト 9 種（CSS フォールバックと省電力制御付き） |
@@ -164,7 +164,7 @@ export class Hero {}
 | **レイアウト** (`/components/layout`) | `<usa-auto-animate>` · `<usa-masonry>` |
 | **パック** (`/components/packs`) | `<usa-pack>` |
 | **エフェクト登録** (`/components/fx`) | `<usa-fx>` |
-| **エフェクトパック** (`/components/effects`) | `<usa-player>` · `<usa-story>` · `<usa-audio>` · `<usa-theme>` · `<usa-gesture-fx>` |
+| **エフェクトパック** (`/components/effects`) | `<usa-player>` · `<usa-story>` · `<usa-audio>` · `<usa-motion-theme>` · `<usa-gesture-fx>` |
 
 ## アクセシビリティと reduced motion
 

package/README_zh.md

@@ -132,7 +132,7 @@ export class Hero {}
 | **生成式背景** | 6 种画布背景（flow-field、voronoi、mesh-gradient、starfield、metaballs、contours）+ 9 个背景元素（极光、粒子、胶片颗粒、流体色块、水波、亚克力 / 云母……） |
 | **声音响应** | `<usa-audio>` + Web Audio 节拍检测（`createBeatDetector()`、`onBeat()`）；3 种音频可视化（spectrum-bars、pulse-ring、wave-ring）；任意效果都可随节拍触发 |
 | **光标与手势** | 5 种光标效果（彗星 / 丝带 / 星光拖尾、磁性圆点、聚光灯）+ `<usa-cursor>`；甩动 · 旋转 · 长按触发效果（`<usa-gesture-fx>`）；`<usa-swipeable>`、`<usa-pinch-zoom>` |
-| **主题** | 5 套主题（neon · paper · glass · retro · brutalist），通过 `<usa-theme>` / `applyTheme()` 使用，各带一个标志性效果；动效令牌（`/components/tokens`） |
+| **主题** | 5 套主题（neon · paper · glass · retro · brutalist），通过 `<usa-motion-theme>` / `applyMotionTheme()` 使用，各带一个标志性效果；动效令牌（`/components/tokens`） |
 | **微交互** | 23 个现成的界面瞬间：copy-success、like-heart、add-to-cart、send-plane、upvote、trash-shake、input-shake、success-check、notify-badge…… |
 | **`<usa-player>` 与滚动叙事** | `<usa-player>` 播放 JSON 动画（关键帧轨道、预设、效果；load / view / scroll / click 触发），可从 Playground 导出；`<usa-story>` 含 6 个滚动叙事模板 |
 | **WebGL** | `<usa-shader>`、`<usa-distort>`、`<usa-liquid>`、`<usa-post-fx>` —— 5 个粒子预设、9 种后期效果（bloom、CRT、色散、故障……），带 CSS 降级与省电调速 |
@@ -164,7 +164,7 @@ export class Hero {}
 | **布局** (`/components/layout`) | `<usa-auto-animate>` · `<usa-masonry>` |
 | **效果包** (`/components/packs`) | `<usa-pack>` |
 | **效果注册表** (`/components/fx`) | `<usa-fx>` |
-| **效果包** (`/components/effects`) | `<usa-player>` · `<usa-story>` · `<usa-audio>` · `<usa-theme>` · `<usa-gesture-fx>` |
+| **效果包** (`/components/effects`) | `<usa-player>` · `<usa-story>` · `<usa-audio>` · `<usa-motion-theme>` · `<usa-gesture-fx>` |
 
 ## 无障碍与减少动态效果
 

package/dist/chunks/manifest-B08-vo9G.cjs

@@ -0,0 +1,81 @@
+'use strict';
+
+var registry = require('./registry-BVklOepd.cjs');
+
+const EFFECT_PACK_FORMAT = 'motionary/effect-pack';
+const SEMVER = /^\d+\.\d+\.\d+(?:-[\w.]+)?$/;
+const PKG = /^(?:@[a-z0-9-~][a-z0-9-._~]*\/)?[a-z0-9-~][a-z0-9-._~]*$/;
+/** Build a manifest from an effect pack. */
+function packManifest(name, packVersion, effects, extra = {}) {
+    return {
+        format: EFFECT_PACK_FORMAT,
+        version: 1,
+        name,
+        packVersion,
+        ...extra,
+        effects: effects.map((e) => ({ name: e.name, kind: e.kind, ...(e.description ? { description: e.description } : {}), ...(e.defaults ? { defaults: JSON.parse(JSON.stringify(e.defaults)) } : {}) })),
+    };
+}
+/** Check a manifest (and optionally the module's effects against it). */
+function validateManifest(m, effects) {
+    const errors = [];
+    const x = m;
+    if (!x || typeof x !== 'object')
+        return { ok: false, errors: ['manifest must be an object'] };
+    if (x.format !== EFFECT_PACK_FORMAT)
+        errors.push(`format must be "${EFFECT_PACK_FORMAT}"`);
+    if (x.version !== 1)
+        errors.push('version must be 1');
+    if (!x.name || !PKG.test(x.name))
+        errors.push('name must be an npm package name');
+    if (!x.packVersion || !SEMVER.test(x.packVersion))
+        errors.push('packVersion must be semver (x.y.z)');
+    if (!Array.isArray(x.effects) || !x.effects.length)
+        errors.push('effects must be a non-empty array');
+    const seen = new Set();
+    for (const e of x.effects || []) {
+        if (!e || !/^[a-z][a-z0-9-]*$/.test(e.name || ''))
+            errors.push(`invalid effect name "${e?.name}"`);
+        else if (seen.has(e.name))
+            errors.push(`duplicate effect "${e.name}"`);
+        else
+            seen.add(e.name);
+        if (!e || !registry.EFFECT_KINDS.includes(e.kind))
+            errors.push(`effect "${e?.name}": unknown kind "${e?.kind}"`);
+    }
+    if (effects) {
+        const names = new Set(effects.map((e) => e.name));
+        for (const n of seen)
+            if (!names.has(n))
+                errors.push(`effect "${n}" is in the manifest but not exported`);
+        for (const n of names)
+            if (!seen.has(n))
+                errors.push(`effect "${n}" is exported but missing from the manifest`);
+    }
+    return { ok: !errors.length, errors };
+}
+/**
+ * Import an effect pack (a URL / specifier, or an already imported module
+ * with `effects` / `default` and `manifest`), validate and register it.
+ * Returns the registered effect names.
+ */
+async function loadEffectPack(src, opts = {}) {
+    const mod = typeof src === 'string' ? await import(/* @vite-ignore */ src) : src;
+    const effects = mod.effects || mod.default || [];
+    const manifest = opts.manifest || mod.manifest;
+    const v = validateManifest(manifest, effects);
+    if (!v.ok)
+        throw new Error(`[motionary] invalid effect pack: ${v.errors.join('; ')}`);
+    const clash = effects.filter((e) => registry.hasEffect(e.name));
+    if (clash.length && !opts.override)
+        throw new Error(`[motionary] effect pack "${manifest.name}" would replace ${clash.map((e) => e.name).join(', ')} (pass { override: true })`);
+    for (const e of effects)
+        registry.registerEffect(e, { override: !!opts.override });
+    return effects.map((e) => e.name);
+}
+
+exports.EFFECT_PACK_FORMAT = EFFECT_PACK_FORMAT;
+exports.loadEffectPack = loadEffectPack;
+exports.packManifest = packManifest;
+exports.validateManifest = validateManifest;
+//# sourceMappingURL=manifest-B08-vo9G.cjs.map

package/dist/chunks/manifest-B08-vo9G.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest-B08-vo9G.cjs","sources":["../../src/components/fx2/manifest.ts"],"sourcesContent":["/**\n * 6.9 — effect marketplace manifest (`motionary/components/marketplace`).\n *\n * A third-party effect pack is an ES module that exports its effects (an\n * `EffectDefinition[]` as `effects` or `default`) plus a JSON manifest:\n *\n * ```json\n * { \"format\": \"motionary/effect-pack\", \"version\": 1,\n *   \"name\": \"@acme/motion-snow\", \"packVersion\": \"1.2.0\",\n *   \"description\": \"Snow and frost effects\", \"license\": \"MIT\",\n *   \"author\": \"Acme\", \"entry\": \"./dist/index.js\", \"requires\": \">=6.9\",\n *   \"effects\": [{ \"name\": \"frost\", \"kind\": \"background\", \"description\": \"…\",\n *                 \"defaults\": { \"speed\": 1 } }] }\n * ```\n *\n * `packManifest()` writes one from your effects, `validateManifest()` checks\n * one (format, semver, unique kebab-case names, known kinds, effects match\n * the module), and `loadEffectPack()` imports a pack (URL or module),\n * validates it and registers its effects — refusing names that already\n * exist unless `override`.\n */\nimport type { EffectDefinition } from '../fx/registry';\nimport { EFFECT_KINDS, registerEffect, hasEffect } from '../fx/registry';\n\nexport const EFFECT_PACK_FORMAT = 'motionary/effect-pack';\n\nexport interface EffectPackManifest {\n  format: typeof EFFECT_PACK_FORMAT;\n  version: 1;\n  name: string;\n  packVersion: string;\n  description?: string;\n  license?: string;\n  author?: string;\n  homepage?: string;\n  entry?: string;\n  requires?: string;\n  keywords?: string[];\n  effects: { name: string; kind: string; description?: string; defaults?: Record<string, unknown> }[];\n}\n\nconst SEMVER = /^\\d+\\.\\d+\\.\\d+(?:-[\\w.]+)?$/;\nconst PKG = /^(?:@[a-z0-9-~][a-z0-9-._~]*\\/)?[a-z0-9-~][a-z0-9-._~]*$/;\n\n/** Build a manifest from an effect pack. */\nexport function packManifest(name: string, packVersion: string, effects: EffectDefinition[], extra: Partial<Omit<EffectPackManifest, 'format' | 'version' | 'name' | 'packVersion' | 'effects'>> = {}): EffectPackManifest {\n  return {\n    format: EFFECT_PACK_FORMAT,\n    version: 1,\n    name,\n    packVersion,\n    ...extra,\n    effects: effects.map((e) => ({ name: e.name, kind: e.kind, ...(e.description ? { description: e.description } : {}), ...(e.defaults ? { defaults: JSON.parse(JSON.stringify(e.defaults)) } : {}) })),\n  };\n}\n\n/** Check a manifest (and optionally the module's effects against it). */\nexport function validateManifest(m: unknown, effects?: EffectDefinition[]): { ok: boolean; errors: string[] } {\n  const errors: string[] = [];\n  const x = m as Partial<EffectPackManifest> | null;\n  if (!x || typeof x !== 'object') return { ok: false, errors: ['manifest must be an object'] };\n  if (x.format !== EFFECT_PACK_FORMAT) errors.push(`format must be \"${EFFECT_PACK_FORMAT}\"`);\n  if (x.version !== 1) errors.push('version must be 1');\n  if (!x.name || !PKG.test(x.name)) errors.push('name must be an npm package name');\n  if (!x.packVersion || !SEMVER.test(x.packVersion)) errors.push('packVersion must be semver (x.y.z)');\n  if (!Array.isArray(x.effects) || !x.effects.length) errors.push('effects must be a non-empty array');\n  const seen = new Set<string>();\n  for (const e of x.effects || []) {\n    if (!e || !/^[a-z][a-z0-9-]*$/.test(e.name || '')) errors.push(`invalid effect name \"${e?.name}\"`);\n    else if (seen.has(e.name)) errors.push(`duplicate effect \"${e.name}\"`);\n    else seen.add(e.name);\n    if (!e || !(EFFECT_KINDS as readonly string[]).includes(e.kind)) errors.push(`effect \"${e?.name}\": unknown kind \"${e?.kind}\"`);\n  }\n  if (effects) {\n    const names = new Set(effects.map((e) => e.name));\n    for (const n of seen) if (!names.has(n)) errors.push(`effect \"${n}\" is in the manifest but not exported`);\n    for (const n of names) if (!seen.has(n)) errors.push(`effect \"${n}\" is exported but missing from the manifest`);\n  }\n  return { ok: !errors.length, errors };\n}\n\n/**\n * Import an effect pack (a URL / specifier, or an already imported module\n * with `effects` / `default` and `manifest`), validate and register it.\n * Returns the registered effect names.\n */\nexport async function loadEffectPack(src: string | { effects?: EffectDefinition[]; default?: EffectDefinition[]; manifest?: EffectPackManifest }, opts: { manifest?: EffectPackManifest; override?: boolean } = {}): Promise<string[]> {\n  const mod: any = typeof src === 'string' ? await import(/* @vite-ignore */ src) : src;\n  const effects: EffectDefinition[] = mod.effects || mod.default || [];\n  const manifest = opts.manifest || mod.manifest;\n  const v = validateManifest(manifest, effects);\n  if (!v.ok) throw new Error(`[motionary] invalid effect pack: ${v.errors.join('; ')}`);\n  const clash = effects.filter((e) => hasEffect(e.name));\n  if (clash.length && !opts.override) throw new Error(`[motionary] effect pack \"${manifest.name}\" would replace ${clash.map((e) => e.name).join(', ')} (pass { override: true })`);\n  for (const e of effects) registerEffect(e, { override: !!opts.override });\n  return effects.map((e) => e.name);\n}\n"],"names":["EFFECT_KINDS","hasEffect","registerEffect"],"mappings":"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"}

package/dist/chunks/manifest-PJ0h8RS_.js

@@ -0,0 +1,76 @@
+import { hasEffect, registerEffect, EFFECT_KINDS } from './registry-CnO7ZVPK.js';
+
+const EFFECT_PACK_FORMAT = 'motionary/effect-pack';
+const SEMVER = /^\d+\.\d+\.\d+(?:-[\w.]+)?$/;
+const PKG = /^(?:@[a-z0-9-~][a-z0-9-._~]*\/)?[a-z0-9-~][a-z0-9-._~]*$/;
+/** Build a manifest from an effect pack. */
+function packManifest(name, packVersion, effects, extra = {}) {
+    return {
+        format: EFFECT_PACK_FORMAT,
+        version: 1,
+        name,
+        packVersion,
+        ...extra,
+        effects: effects.map((e) => ({ name: e.name, kind: e.kind, ...(e.description ? { description: e.description } : {}), ...(e.defaults ? { defaults: JSON.parse(JSON.stringify(e.defaults)) } : {}) })),
+    };
+}
+/** Check a manifest (and optionally the module's effects against it). */
+function validateManifest(m, effects) {
+    const errors = [];
+    const x = m;
+    if (!x || typeof x !== 'object')
+        return { ok: false, errors: ['manifest must be an object'] };
+    if (x.format !== EFFECT_PACK_FORMAT)
+        errors.push(`format must be "${EFFECT_PACK_FORMAT}"`);
+    if (x.version !== 1)
+        errors.push('version must be 1');
+    if (!x.name || !PKG.test(x.name))
+        errors.push('name must be an npm package name');
+    if (!x.packVersion || !SEMVER.test(x.packVersion))
+        errors.push('packVersion must be semver (x.y.z)');
+    if (!Array.isArray(x.effects) || !x.effects.length)
+        errors.push('effects must be a non-empty array');
+    const seen = new Set();
+    for (const e of x.effects || []) {
+        if (!e || !/^[a-z][a-z0-9-]*$/.test(e.name || ''))
+            errors.push(`invalid effect name "${e?.name}"`);
+        else if (seen.has(e.name))
+            errors.push(`duplicate effect "${e.name}"`);
+        else
+            seen.add(e.name);
+        if (!e || !EFFECT_KINDS.includes(e.kind))
+            errors.push(`effect "${e?.name}": unknown kind "${e?.kind}"`);
+    }
+    if (effects) {
+        const names = new Set(effects.map((e) => e.name));
+        for (const n of seen)
+            if (!names.has(n))
+                errors.push(`effect "${n}" is in the manifest but not exported`);
+        for (const n of names)
+            if (!seen.has(n))
+                errors.push(`effect "${n}" is exported but missing from the manifest`);
+    }
+    return { ok: !errors.length, errors };
+}
+/**
+ * Import an effect pack (a URL / specifier, or an already imported module
+ * with `effects` / `default` and `manifest`), validate and register it.
+ * Returns the registered effect names.
+ */
+async function loadEffectPack(src, opts = {}) {
+    const mod = typeof src === 'string' ? await import(/* @vite-ignore */ src) : src;
+    const effects = mod.effects || mod.default || [];
+    const manifest = opts.manifest || mod.manifest;
+    const v = validateManifest(manifest, effects);
+    if (!v.ok)
+        throw new Error(`[motionary] invalid effect pack: ${v.errors.join('; ')}`);
+    const clash = effects.filter((e) => hasEffect(e.name));
+    if (clash.length && !opts.override)
+        throw new Error(`[motionary] effect pack "${manifest.name}" would replace ${clash.map((e) => e.name).join(', ')} (pass { override: true })`);
+    for (const e of effects)
+        registerEffect(e, { override: !!opts.override });
+    return effects.map((e) => e.name);
+}
+
+export { EFFECT_PACK_FORMAT as E, loadEffectPack as l, packManifest as p, validateManifest as v };
+//# sourceMappingURL=manifest-PJ0h8RS_.js.map

package/dist/chunks/manifest-PJ0h8RS_.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest-PJ0h8RS_.js","sources":["../../src/components/fx2/manifest.ts"],"sourcesContent":["/**\n * 6.9 — effect marketplace manifest (`motionary/components/marketplace`).\n *\n * A third-party effect pack is an ES module that exports its effects (an\n * `EffectDefinition[]` as `effects` or `default`) plus a JSON manifest:\n *\n * ```json\n * { \"format\": \"motionary/effect-pack\", \"version\": 1,\n *   \"name\": \"@acme/motion-snow\", \"packVersion\": \"1.2.0\",\n *   \"description\": \"Snow and frost effects\", \"license\": \"MIT\",\n *   \"author\": \"Acme\", \"entry\": \"./dist/index.js\", \"requires\": \">=6.9\",\n *   \"effects\": [{ \"name\": \"frost\", \"kind\": \"background\", \"description\": \"…\",\n *                 \"defaults\": { \"speed\": 1 } }] }\n * ```\n *\n * `packManifest()` writes one from your effects, `validateManifest()` checks\n * one (format, semver, unique kebab-case names, known kinds, effects match\n * the module), and `loadEffectPack()` imports a pack (URL or module),\n * validates it and registers its effects — refusing names that already\n * exist unless `override`.\n */\nimport type { EffectDefinition } from '../fx/registry';\nimport { EFFECT_KINDS, registerEffect, hasEffect } from '../fx/registry';\n\nexport const EFFECT_PACK_FORMAT = 'motionary/effect-pack';\n\nexport interface EffectPackManifest {\n  format: typeof EFFECT_PACK_FORMAT;\n  version: 1;\n  name: string;\n  packVersion: string;\n  description?: string;\n  license?: string;\n  author?: string;\n  homepage?: string;\n  entry?: string;\n  requires?: string;\n  keywords?: string[];\n  effects: { name: string; kind: string; description?: string; defaults?: Record<string, unknown> }[];\n}\n\nconst SEMVER = /^\\d+\\.\\d+\\.\\d+(?:-[\\w.]+)?$/;\nconst PKG = /^(?:@[a-z0-9-~][a-z0-9-._~]*\\/)?[a-z0-9-~][a-z0-9-._~]*$/;\n\n/** Build a manifest from an effect pack. */\nexport function packManifest(name: string, packVersion: string, effects: EffectDefinition[], extra: Partial<Omit<EffectPackManifest, 'format' | 'version' | 'name' | 'packVersion' | 'effects'>> = {}): EffectPackManifest {\n  return {\n    format: EFFECT_PACK_FORMAT,\n    version: 1,\n    name,\n    packVersion,\n    ...extra,\n    effects: effects.map((e) => ({ name: e.name, kind: e.kind, ...(e.description ? { description: e.description } : {}), ...(e.defaults ? { defaults: JSON.parse(JSON.stringify(e.defaults)) } : {}) })),\n  };\n}\n\n/** Check a manifest (and optionally the module's effects against it). */\nexport function validateManifest(m: unknown, effects?: EffectDefinition[]): { ok: boolean; errors: string[] } {\n  const errors: string[] = [];\n  const x = m as Partial<EffectPackManifest> | null;\n  if (!x || typeof x !== 'object') return { ok: false, errors: ['manifest must be an object'] };\n  if (x.format !== EFFECT_PACK_FORMAT) errors.push(`format must be \"${EFFECT_PACK_FORMAT}\"`);\n  if (x.version !== 1) errors.push('version must be 1');\n  if (!x.name || !PKG.test(x.name)) errors.push('name must be an npm package name');\n  if (!x.packVersion || !SEMVER.test(x.packVersion)) errors.push('packVersion must be semver (x.y.z)');\n  if (!Array.isArray(x.effects) || !x.effects.length) errors.push('effects must be a non-empty array');\n  const seen = new Set<string>();\n  for (const e of x.effects || []) {\n    if (!e || !/^[a-z][a-z0-9-]*$/.test(e.name || '')) errors.push(`invalid effect name \"${e?.name}\"`);\n    else if (seen.has(e.name)) errors.push(`duplicate effect \"${e.name}\"`);\n    else seen.add(e.name);\n    if (!e || !(EFFECT_KINDS as readonly string[]).includes(e.kind)) errors.push(`effect \"${e?.name}\": unknown kind \"${e?.kind}\"`);\n  }\n  if (effects) {\n    const names = new Set(effects.map((e) => e.name));\n    for (const n of seen) if (!names.has(n)) errors.push(`effect \"${n}\" is in the manifest but not exported`);\n    for (const n of names) if (!seen.has(n)) errors.push(`effect \"${n}\" is exported but missing from the manifest`);\n  }\n  return { ok: !errors.length, errors };\n}\n\n/**\n * Import an effect pack (a URL / specifier, or an already imported module\n * with `effects` / `default` and `manifest`), validate and register it.\n * Returns the registered effect names.\n */\nexport async function loadEffectPack(src: string | { effects?: EffectDefinition[]; default?: EffectDefinition[]; manifest?: EffectPackManifest }, opts: { manifest?: EffectPackManifest; override?: boolean } = {}): Promise<string[]> {\n  const mod: any = typeof src === 'string' ? await import(/* @vite-ignore */ src) : src;\n  const effects: EffectDefinition[] = mod.effects || mod.default || [];\n  const manifest = opts.manifest || mod.manifest;\n  const v = validateManifest(manifest, effects);\n  if (!v.ok) throw new Error(`[motionary] invalid effect pack: ${v.errors.join('; ')}`);\n  const clash = effects.filter((e) => hasEffect(e.name));\n  if (clash.length && !opts.override) throw new Error(`[motionary] effect pack \"${manifest.name}\" would replace ${clash.map((e) => e.name).join(', ')} (pass { override: true })`);\n  for (const e of effects) registerEffect(e, { override: !!opts.override });\n  return effects.map((e) => e.name);\n}\n"],"names":[],"mappings":"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"}

package/dist/components/dsl.cjs

@@ -0,0 +1,210 @@
+'use strict';
+
+var registry = require('../chunks/registry-BVklOepd.cjs');
+require('../chunks/base-DoRUZBy-.cjs');
+
+/**
+ * `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 (!registry.EFFECT_TRIGGERS.includes(trigger)) {
+            errors.push(`"${trigger}": unknown trigger (${registry.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 (!registry.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(registry.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;
+}
+
+exports.applyMotion = applyMotion;
+exports.bindMotion = bindMotion;
+exports.createComponent = createComponent;
+exports.motion = motion;
+exports.parseMotion = parseMotion;
+exports.serializeMotion = serializeMotion;
+//# sourceMappingURL=dsl.cjs.map

package/dist/components/dsl.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"dsl.cjs","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":["EFFECT_TRIGGERS","hasEffect","bindEffect"],"mappings":"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"}

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