@xpert-ai/plugin-motion 0.1.0

package/.xpertai-plugin/plugin.json

@@ -0,0 +1,163 @@
+{
+  "name": "@xpert-ai/plugin-motion",
+  "version": "0.1.0",
+  "description": "Motion app plugin for agent-generated animated HTML, launch video compositions, motion recipe routing, reviewable versions, and exportable artifacts.",
+  "author": "XpertAI",
+  "homepage": "https://github.com/xpert-ai/xpert-plugins/tree/main/xpertai/apps/motion",
+  "repository": "https://github.com/xpert-ai/xpert-plugins/tree/main/xpertai/apps/motion",
+  "license": "AGPL-3.0",
+  "keywords": [
+    "motion",
+    "animation",
+    "agent-motion",
+    "workbench",
+    "video-composer",
+    "animated-html"
+  ],
+  "skills": "./skills/",
+  "interface": {
+    "displayName": "Motion",
+    "shortDescription": "Agentic animated HTML and launch video composer",
+    "longDescription": "Create, route, review, edit, version, and export Motion artifacts from natural-language intent. Includes Motion Assistant, middleware tools, recipe library, HTML Workbench, and browser MP4 export for launch-video compositions.",
+    "developerName": "XpertAI",
+    "category": "Productivity",
+    "capabilities": [
+      "Interactive",
+      "Read",
+      "Write"
+    ],
+    "websiteURL": "https://xpertai.cn",
+    "privacyPolicyURL": "https://xpertai.cn",
+    "termsOfServiceURL": "https://xpertai.cn",
+    "defaultPrompt": [
+      "Create a Motion HTML hero for this product brief.",
+      "Turn this launch announcement into a short kinetic video.",
+      "Search Motion recipes and propose a tasteful animation direction."
+    ],
+    "composerIcon": "./assets/composerIcon.svg",
+    "logo": "./assets/logo.svg",
+    "brandColor": "#2563EB",
+    "screenshots": []
+  },
+  "policy": {
+    "installation": "AVAILABLE",
+    "authentication": "ON_FIRST_USE",
+    "pluginSharing": true
+  },
+  "source": {
+    "source": "local",
+    "path": ".",
+    "url": "https://github.com/xpert-ai/xpert-plugins",
+    "sparsePath": "xpertai/apps/motion"
+  },
+  "assets": {
+    "composerIcon": "./assets/composerIcon.svg",
+    "logo": "./assets/logo.svg",
+    "screenshots": []
+  },
+  "targetApps": [
+    "data-xpert",
+    "xpert"
+  ],
+  "targetAppMeta": {
+    "xpert": {
+      "types": [
+        "assistant-template",
+        "skill",
+        "app",
+        "xpertai-bundle"
+      ],
+      "capabilities": [
+        "motion",
+        "motion-workbench",
+        "agent-motion",
+        "motion-library",
+        "motion-assistant-template"
+      ],
+      "marketplace": {
+        "contents": [
+          {
+            "type": "skill",
+            "name": "motion-agent-skill",
+            "displayName": "Motion Agent Skill",
+            "description": "Skill for using Motion middleware tools, recipe selection, HTML/runtime editing, launch-video composition, versioning, export, and recovery.",
+            "tags": [
+              "skill",
+              "motion",
+              "agent-motion",
+              "animation",
+              "middleware-tools"
+            ]
+          },
+          {
+            "type": "assistant-template",
+            "name": "motion-assistant",
+            "displayName": "Motion Assistant",
+            "description": "Assistant template for Motion artifact creation and review workflows.",
+            "metadata": {
+              "app": "motion"
+            }
+          },
+          {
+            "type": "app",
+            "name": "motion",
+            "displayName": "Motion",
+            "description": "Use Motion Assistant with Workbench and Agent middleware tools for animated HTML and launch video compositions.",
+            "operations": [
+              {
+                "name": "create-motion-projects",
+                "displayName": "Create Motion projects",
+                "description": "Create reviewable animated HTML and launch-video projects.",
+                "access": "write"
+              },
+              {
+                "name": "save-motion-versions",
+                "displayName": "Save Motion versions",
+                "description": "Persist working artifacts, versions, styles, exports, and action logs.",
+                "access": "write"
+              },
+              {
+                "name": "review-motion-workbench",
+                "displayName": "Review Motion Workbench",
+                "description": "Open Motion Workbench to inspect, edit, export, and restore artifacts.",
+                "access": "read"
+              }
+            ]
+          },
+          {
+            "type": "view",
+            "name": "motion_workbench",
+            "displayName": "Motion Workbench",
+            "description": "Workbench view for Motion projects, recipe library, HTML editing, video composition, versions, and exports.",
+            "metadata": {
+              "app": "motion"
+            }
+          },
+          {
+            "type": "middleware",
+            "name": "MotionMiddleware",
+            "displayName": "Motion Agent Tools",
+            "description": "Assistant middleware tools for recipe search, project creation, artifact saving, versioning, exports, status updates, and failure reporting.",
+            "metadata": {
+              "app": "motion"
+            }
+          }
+        ]
+      }
+    },
+    "data-xpert": {
+      "types": [
+        "workbench-view",
+        "assistant-tool",
+        "business-app"
+      ],
+      "capabilities": [
+        "motion",
+        "motion-workbench",
+        "agent-motion",
+        "motion-library",
+        "motion-assistant-template"
+      ]
+    }
+  }
+}

package/README.md

@@ -0,0 +1,51 @@
+# Motion
+
+Motion is an Xpert-native Agentic App for turning natural-language intent into animated HTML and launch-video compositions.
+
+It provides:
+
+- Motion Assistant template for recipe routing and artifact creation.
+- Motion middleware tools for recipe search, scoped project CRUD, versioning, exports, status updates, and failure reporting.
+- Motion Workbench remote component with Projects, Motion Library, HTML Workbench, Video Composer, Versions, and Exports tabs.
+- Imported upstream recipe/spec/template assets under `assets/upstream` with attribution preserved.
+- Browser-side MP4 export for JSON video compositions through WebCodecs.
+
+## Package
+
+```bash
+pnpm --dir /Users/xpertai/GitHub/os/xpert-plugins/xpertai/apps/motion build
+pnpm --dir /Users/xpertai/GitHub/os/xpert-plugins/xpertai/apps/motion typecheck
+pnpm --dir /Users/xpertai/GitHub/os/xpert-plugins/xpertai/apps/motion test
+```
+
+## Public Interfaces
+
+- Package: `@xpert-ai/plugin-motion`
+- Provider: `motion`
+- View: `motion_workbench`
+- Remote component: `motion-workbench`
+- Assistant template: `Motion Assistant`
+- Capabilities: `motion`, `motion-workbench`, `agent-motion`, `motion-library`, `motion-assistant-template`
+
+## Middleware Tools
+
+- `motion_search_recipes`
+- `motion_get_recipe`
+- `motion_create_project`
+- `motion_get_project`
+- `motion_save_web_artifact`
+- `motion_save_video_composition`
+- `motion_finalize_version`
+- `motion_export_artifact`
+- `motion_update_project_status`
+- `motion_report_failure`
+
+## Data Model
+
+- `MotionProject`
+- `MotionProjectVersion`
+- `MotionStyle`
+- `MotionExport`
+- `MotionActionLog`
+
+All records are scoped by tenant and organization. Generated and exported files use the platform workspace files capability when it is available.

package/assets/composerIcon.svg

@@ -0,0 +1,5 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64" role="img" aria-label="Motion">
+  <rect x="6" y="8" width="52" height="48" rx="10" fill="#2563eb"/>
+  <path d="M17 40c11 0 11-17 22-17 7 0 10 5 12 13" fill="none" stroke="#ffffff" stroke-width="6" stroke-linecap="round"/>
+  <path d="M17 45h30" fill="none" stroke="#a7f3d0" stroke-width="5" stroke-linecap="round"/>
+</svg>

package/assets/logo.svg

@@ -0,0 +1,6 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 96 96" role="img" aria-label="Motion">
+  <rect width="96" height="96" rx="18" fill="#0f172a"/>
+  <path d="M20 61c18 0 18-26 36-26 11 0 17 8 20 20" fill="none" stroke="#38bdf8" stroke-width="10" stroke-linecap="round"/>
+  <path d="M20 67h56" fill="none" stroke="#34d399" stroke-width="8" stroke-linecap="round"/>
+  <circle cx="66" cy="31" r="8" fill="#f97316"/>
+</svg>

package/assets/upstream/ATTRIBUTION.md

@@ -0,0 +1,42 @@
+# ATTRIBUTION.md — third-party sources & credits
+
+motion-anything is Apache-2.0 (see [LICENSE](LICENSE)). Portions of the library and tooling
+build on the work of others. This file records every external source, its license, and how
+it is used. If you believe something is misattributed, please open an issue.
+
+## Motion effects
+
+- **react-bits** (<https://reactbits.dev>) — 35 recipes in `recipes/web/` are faithful,
+  dependency-free ports of react-bits effects (original GLSL shaders and effect logic,
+  re-hosted on our zero-dependency runners; the React wrappers are fully rewritten).
+  The source components are vendored under `recipes/imported/` for reference and future ports.
+  **Used and redistributed with the author's permission.** The remaining `rb-*` entries in the
+  library are reference cards that link back to reactbits.dev.
+- **Open Design** (<https://github.com/nexu-io/open-design>, Apache-2.0) — sibling project in
+  the nexu.io family. Shared here: agent engine icons (`app/agent-icons/`), design-system
+  brand packs, video/HTML template collections, and the ACP runtime integration patterns
+  (`docs/new-agent-runtime-acp.md`, `apps/daemon/src/acp.ts`).
+
+## Vendored libraries (in `app/video/vendor/`)
+
+- **mp4-muxer** — MIT. In-browser MP4 muxing for the WebCodecs export pipeline.
+- **gifenc** © Matt DesLauriers — MIT. GIF encoding for the animated-GIF export.
+
+## Bundled skills (in `skills/`)
+
+- **web-clone** — MIT, vendored with LICENSE + ATTRIBUTION in its folder.
+- **gsap skill** — GreenSock, MIT-licensed skill content, vendored with LICENSE in its folder.
+- Other companion skills (text-to-lottie, web-shader-extractor, Web-to-Design-md, Toolcraft)
+  are **not** vendored — the router defers to them if the user installs them; see
+  [INTEGRATIONS.md](INTEGRATIONS.md).
+
+## Reference cards
+
+Library entries marked `ref` (with a "Get from …" link) are pointers to upstream libraries and
+demos (GSAP, Motion.dev, Anime.js, LottieFiles, Rive, ShaderGradient, three.js ecosystem, …).
+They embed no upstream code — each card links to the original source and license.
+
+## Icons & fonts
+
+- **reicon** icon set — bundled per its upstream license (see `app/data/` provenance notes).
+- System font stacks only; no bundled fonts.

package/assets/upstream/LICENSE

@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or Derivative
+          Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright 2026 nexu.io
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/assets/upstream/MOTION-SPEC.md

@@ -0,0 +1,127 @@
+# MOTION-SPEC.md — the motion standard
+
+This is the "taste engine" of motion-anything. It encodes **how to use motion well**, so that
+every recipe and the router skill produce restrained, accessible, product-grade animation instead
+of decoration for its own sake.
+
+> Inspiration: this spec is aligned with widely-respected motion guidance (Material motion,
+> Apple HIG, and Emil Kowalski's animation principles). Recipes should cite their lineage in
+> `recipe.motion.yaml > license.upstream` where applicable.
+
+---
+
+## 1. First principles
+
+1. **Motion must mean something.** Every animation either (a) gives feedback, (b) shows a
+   relationship/continuity, or (c) directs attention. If it does none of these, cut it.
+2. **The best motion is felt, not noticed.** If users consciously notice the animation, it is
+   usually too slow, too big, or too frequent.
+3. **Restraint is the craft.** More motion is not better. A single, well-placed moment beats ten.
+4. **Performance is part of taste.** Janky motion reads as cheap. Animate GPU-friendly properties.
+5. **Accessibility is non-negotiable.** Always honor `prefers-reduced-motion`.
+
+## 2. Timing scale (duration tokens)
+
+Use these tokens; do not invent arbitrary durations.
+
+| Token | ms | Use for |
+|-------|----|---------|
+| `instant` | 80–120 | Hover/press feedback, tiny state flips |
+| `fast` | 140–220 | Micro-interactions, button/toggle states, small reveals |
+| `base` | 220–320 | Standard transitions, card/element entrances |
+| `slow` | 320–500 | Page/section transitions, larger reveals |
+| `deliberate` | 500–800 | Hero moments, celebratory bursts, onboarding |
+| `cinematic` | 800–2000 | Video transitions, launch-film moments only |
+
+Rule of thumb: **the larger the moving element or distance, the longer the duration** — but stay
+in band. UI micro-interactions should almost always be `fast`.
+
+## 3. Easing tokens
+
+| Token | curve | Use for |
+|-------|-------|---------|
+| `ease-out` | `cubic-bezier(0.16, 1, 0.3, 1)` | **Default** for things entering / responding to the user |
+| `ease-in` | `cubic-bezier(0.4, 0, 1, 1)` | Things leaving the screen |
+| `ease-in-out` | `cubic-bezier(0.65, 0, 0.35, 1)` | Moves that start and end on screen |
+| `spring-soft` | spring(stiffness 170, damping 26) | Playful, organic; toggles, drags, delight |
+| `spring-snappy` | spring(stiffness 300, damping 30) | Crisp, responsive controls |
+
+Default to **`ease-out`** for UI. Linear easing is for continuous loops only (spinners, marquees).
+
+## 4. Restraint budget
+
+Per visible viewport ("view"):
+
+- **≤ 1** celebratory / attention-grabbing moment (`feedback-delight`, `emphasis`).
+- **≤ 3** simultaneous entrance animations; stagger the rest. Stagger step **40–80ms**, capped so
+  the whole sequence finishes within `slow`.
+- **No competing loops.** At most one ambient/looping animation on screen at a time.
+- **Never auto-play celebratory motion.** Delight triggers on user intent (tap/submit), not on load.
+
+Each recipe declares its own budget in `recipe.motion.yaml > restraint`. The router must respect the
+sum across recipes it composes — if two recipes both want the "one celebratory moment", pick one.
+
+## 5. Performance rules
+
+- Animate **`transform` and `opacity`** only for anything that moves or fades. Avoid animating
+  `width`, `height`, `top`, `left`, `margin` (they trigger layout). Use `transform: translate/scale`.
+- Promote heavy animations with `will-change` sparingly; remove it after the animation ends.
+- Target **60fps**. If a recipe can't hold 60fps on a mid-range laptop, simplify it.
+- Clean up: cancel timers/RAF, remove injected DOM nodes (e.g. particles) after they finish.
+
+## 6. Accessibility — `prefers-reduced-motion`
+
+Every recipe MUST degrade gracefully. Acceptable reduced-motion fallbacks:
+
+- `scale-only` — keep a tiny scale/opacity cue, drop travel and particles.
+- `crossfade` — replace movement with a short opacity change.
+- `none` — show the end state instantly (valid for purely decorative motion).
+
+Reference pattern (every recipe's CSS should include something like this):
+
+```css
+@media (prefers-reduced-motion: reduce) {
+  /* drop travel, particles, and long durations; keep a minimal cue or none */
+}
+```
+
+## 7. Category taxonomy
+
+Recipes are tagged with one primary `category`. This is what the router matches intent against.
+
+| Category | What it is | Default duration | Default easing |
+|----------|------------|------------------|----------------|
+| `entrance` | Elements appearing (fade/slide/scale in) | `base` | `ease-out` |
+| `exit` | Elements leaving | `fast` | `ease-in` |
+| `scroll-reveal` | Reveal on scroll into view | `base` | `ease-out` |
+| `hover-press` | Pointer feedback (magnetic, lift, press) | `fast` | `ease-out` / `spring-snappy` |
+| `state-transition` | Toggle / tab / accordion / expand | `fast` | `ease-in-out` |
+| `feedback-delight` | Celebratory micro-moments (like-burst, confetti) | `deliberate` | `ease-out` / `spring-soft` |
+| `emphasis` | Draw attention (pulse, shake, count-up) | `fast`–`base` | `ease-out` |
+| `loading` | Pending/progress states | loop | linear |
+| `page-transition` | Between routes/sections | `slow` | `ease-in-out` |
+| `text-kinetic` | Animated typography (for web & video) | `base`–`cinematic` | varies |
+| `video-transition` | Shot-to-shot transitions for video | `cinematic` | `ease-in-out` |
+
+## 8. Intent → motion mapping (for the router)
+
+The router maps fuzzy human language to categories + recipes. Common cues:
+
+| User says (incl. 中文) | Likely category |
+|------------------------|-----------------|
+| "snappy", "responsive", "丝滑", "干脆" | `hover-press`, `state-transition` (`fast`, `spring-snappy`) |
+| "delightful", "surprise", "fun", "惊喜感", "好玩" | `feedback-delight` |
+| "elegant", "smooth", "premium", "高级", "优雅" | `entrance`, `scroll-reveal` (`base`/`slow`, `ease-out`) |
+| "draws attention", "pop", "强调", "突出" | `emphasis` |
+| "cinematic", "launch video", "发布视频", "电影感" | `video-transition`, `text-kinetic` (`cinematic`) |
+| "alive", "playful", "有生命力", "活泼" | `hover-press`, `feedback-delight` (`spring-soft`) |
+
+When intent is ambiguous, prefer the **more restrained** option and ask one clarifying question.
+
+## 9. Definition of done for any produced motion
+
+- [ ] Serves feedback, continuity, or attention (§1).
+- [ ] Duration + easing pulled from the tokens (§2–3), appropriate to element size.
+- [ ] Within the restraint budget for the view (§4).
+- [ ] Transforms/opacity only; cleans up after itself (§5).
+- [ ] Has a working `prefers-reduced-motion` fallback (§6).