@anvpx/motion 0.0.0-stage → 0.1.1

package/CATALOG.md

@@ -0,0 +1,301 @@
+# Catalog
+
+Generated by `mk catalog --write` from the scene registry; do not edit. Read the index, then `mk catalog <type>` for one scene. `*` marks a required field.
+
+## Index
+
+```
+type | layer | purpose | required
+title | base | Opening or section title card with optional kicker and subtitle. | title
+hero | base | Landing-page hero: kicker, big headline with [x] accents, subline and up to 4 glass tiles; bento or centered. | title
+poster | base | Type-led statement: 1-3 oversized lines with [x] accents, optional kicker and foot; outline draws the last line as outline type and accent words keep their gradient fill. | lines
+bullets | base | Short list of 1-6 points with an optional heading. | items
+stat | base | One hero number with label, unit, delta and context; counts up. | value,label
+flow | base | Node-and-arrow diagram (2-8 nodes) laid out left-right or top-bottom. | nodes,edges
+outro | base | Closing card with title, up to 3 lines and up to 4 credits. | title
+lower-third | overlay | Name plate with optional title at the lower edge. | name
+bug | overlay | Corner word mark or ledger image; give exactly one of text or image. | -
+progress | overlay | Thin progress bar over the scene or the whole timeline. | -
+countdown | overlay | Integer count between from and to, one step per equal slice of the duration. | from,to
+chapter | overlay | Numbered chapter chip in a corner. | number,label
+caption | overlay | Voice word timings as karaoke captions; falls back to a full-text card. | -
+compare | base | Two options side by side or wiped before/after, 1-5 points each; the winner is marked by icon and text. | left,right
+callout | base | One formula, rule, definition, warning or tip made big; [x] marks accent terms, revealed term by term. | text
+quote | base | Testimonial or quotation with attribution, optional 1-5 star rating and avatar. | quote,name
+icon-grid | base | Features, benefits or categories as 2-8 icon cards with a short label and optional detail. | items
+steps | base | Ordered progression of 2-6 steps: a process path, or ascending ladder/stairs tiers with value labels (pricing, levels). | steps
+timeline | base | Dated milestones, history or a now/next roadmap: 2-7 items on a horizontal or vertical axis with done/now/next states. | items
+media-frame | base | Screenshot or photo, bare or in a browser, phone or laptop frame, with optional title, caption and numbered callout dots. | image
+kinetic | base | One word or short phrase per beat at full screen (slam, stack or swap); for hooks, rules of three and key messages. | words
+code | base | Code or terminal text typed or revealed line by line, with highlighted lines and +/- diff lines. | lines
+kpi-grid | base | 2-6 headline numbers side by side, each with label, unit, change and trend arrow (good=down when a fall is good); values count up. | items
+chart | base | Animated bar, line or donut chart for ranking, trend or share, with values shown and an optional highlight. | kind
+table | base | Small data table or ranked list (2-5 columns, 2-8 rows) with row-by-row reveal and one optional highlighted row. | columns,rows
+scene3d | base | WebGL diorama (vendored three.js): post, light, material, environment presets; model presets knot|gem|sphere|torus; flat 2D canvas fallback without WebGL. 3D output is machine+GPU stable, not portable. | -
+sticker | base | Pop-comic sticker slam: 1-5 short phrases slam in with outline type, tilt and a starburst; for hooks, myth-vs-fact and punchy shorts. | words
+waveform | base | Audio waveform from precomputed peaks: bars rise as the playhead sweeps; for voice agents, podcasts and narrated reports. Peaks are storyboard data, never decoded audio. | peaks
+Detail: `mk catalog <type>`. Props are strict; unlisted keys are rejected.
+```
+
+## Scenes
+
+```
+title (base): Opening or section title card with optional kicker and subtitle.
+  title   * text
+  subtitle  text
+  kicker    text
+props: {"title":"Hello"}
+```
+
+```
+hero (base): Landing-page hero: kicker, big headline with [x] accents, subline and up to 4 glass tiles; bento or centered.
+  title   * text<=70
+  subtitle  text<=120
+  kicker    text<=28
+  tiles     {value,label,detail}[..4]
+  layout    bento|center  = "bento"
+props: {"title":"Design at the [speed] of thought","layout":"bento"}
+```
+
+```
+poster (base): Type-led statement: 1-3 oversized lines with [x] accents, optional kicker and foot; outline draws the last line as outline type and accent words keep their gradient fill.
+  lines  * text<=38[1..3]
+  kicker   text<=28
+  foot     text<=60
+  align    left|center  = "left"
+  outline  boolean  = false
+props: {"lines":["Make it","move"],"outline":true}
+```
+
+```
+bullets (base): Short list of 1-6 points with an optional heading.
+  title   text
+  items * text[1..6]
+  marker  dot|check|cross|number
+props: {"items":["One","Two"]}
+```
+
+```
+stat (base): One hero number with label, unit, delta and context; counts up.
+  value  * text|number
+  label  * text
+  unit     text
+  delta    text
+  context  text
+props: {"value":42,"label":"Users"}
+```
+
+```
+flow (base): Node-and-arrow diagram (2-8 nodes) laid out left-right or top-bottom.
+  nodes    * {id,label}[2..8]
+  edges    * {from,to,label}[]
+  direction  lr|tb  = "lr"
+props: {"nodes":[{"id":"a","label":"A"},{"id":"b","label":"B"}],"edges":[{"from":"a","to":"b"}]}
+```
+
+```
+outro (base): Closing card with title, up to 3 lines and up to 4 credits.
+  title  * text
+  lines    text[..3]
+  credits  text[..4]
+props: {"title":"Thanks"}
+```
+
+```
+lower-third (overlay): Name plate with optional title at the lower edge.
+  name * text
+  title  text
+  align  left|right  = "left"
+props: {"name":"Ada Lovelace"}
+```
+
+```
+bug (overlay): Corner word mark or ledger image; give exactly one of text or image.
+  text      text<=32
+  image     text
+  position  top-left|top-right|bottom-left|bottom-right  = "top-right"
+  opacity   subtle|medium|full  = "medium"
+props: {"text":"ACME"}
+```
+
+```
+progress (overlay): Thin progress bar over the scene or the whole timeline.
+  scope  scene|timeline  = "scene"
+  color  accent|accent2  = "accent"
+  label  text
+props: {}
+```
+
+```
+countdown (overlay): Integer count between from and to, one step per equal slice of the duration.
+  from    * int 0..999
+  to      * int 0..999
+  label     text
+  position  top-left|top-right|bottom-left|bottom-right|center  = "center"
+props: {"from":3,"to":1}
+```
+
+```
+chapter (overlay): Numbered chapter chip in a corner.
+  number  * int 0..99
+  label   * text
+  position  top-left|top-right|bottom-left|bottom-right  = "top-left"
+props: {"number":1,"label":"Intro"}
+```
+
+```
+caption (overlay): Voice word timings as karaoke captions; falls back to a full-text card.
+  text   text<=140
+  words  {w,start,end}[1..40]
+props: {"words":[{"w":"Hello","start":0,"end":0.4},{"w":"world","start":0.4,"end":0.9}]}
+```
+
+```
+compare (base): Two options side by side or wiped before/after, 1-5 points each; the winner is marked by icon and text.
+  title        text<=60
+  left       * {label,points,value,tag}
+  right      * {label,points,value,tag}
+  mode         split|wipe  = "split"
+  verdict      text<=80
+  winner       left|right
+  winnerLabel  text<=20  = "Winner"
+props: {"left":{"label":"Before","points":["Manual"]},"right":{"label":"After","points":["Automated"]},"winner":"right"}
+```
+
+```
+callout (base): One formula, rule, definition, warning or tip made big; [x] marks accent terms, revealed term by term.
+  text * text<=120
+  kind   formula|statement|definition|warning|tip  = "statement"
+  label  text<=30
+  note   text<=80
+props: {"text":"[Profit] = [Revenue] − [Costs]","kind":"formula"}
+```
+
+```
+quote (base): Testimonial or quotation with attribution, optional 1-5 star rating and avatar.
+  quote * text<=200
+  name  * text<=40
+  role    text<=40
+  org     text<=40
+  rating  int 1..5
+  image   text
+props: {"quote":"Simple and fast.","name":"Alex Kim","rating":5}
+```
+
+```
+icon-grid (base): Features, benefits or categories as 2-8 icon cards with a short label and optional detail.
+  title  text
+  items* {icon,label,detail}[2..8]
+  cols   int 2..4
+icons: `mk icon search <query>` | `mk icon list [--tag group]` (names only)
+props: {"title":"Why teams switch","items":[{"icon":"zap","label":"Fast setup","detail":"Live in a day"},{"icon":"shield","label":"Secure by default"},{"icon":"globe","label":"Works worldwide"}]}
+```
+
+```
+steps (base): Ordered progression of 2-6 steps: a process path, or ascending ladder/stairs tiers with value labels (pricing, levels).
+  title   text
+  steps * {label,value,detail}[2..6]
+  layout  path|ladder|stairs  = "path"
+  active  int 1..9007199254740991
+props: {"title":"Plans","layout":"ladder","steps":[{"label":"Starter","value":"$0"},{"label":"Team","value":"$29"},{"label":"Scale","value":"$99"}]}
+```
+
+```
+timeline (base): Dated milestones, history or a now/next roadmap: 2-7 items on a horizontal or vertical axis with done/now/next states.
+  title   text
+  items * {when,label,detail,state}[2..7]
+  orient  h|v  = "h"
+props: {"title":"Roadmap","items":[{"when":"Q1","label":"Beta","state":"done"},{"when":"Q2","label":"Launch","state":"now"},{"when":"Q3","label":"Scale","state":"next"}]}
+```
+
+```
+media-frame (base): Screenshot or photo, bare or in a browser, phone or laptop frame, with optional title, caption and numbered callout dots.
+  image   * text
+  device    none|browser|phone|laptop  = "browser"
+  layout    full|left|right  = "full"
+  title     text<=60
+  caption   text<=140
+  motion    none|kenburns|tilt  = "kenburns"
+  callouts  {x,y,label}[..3]
+props: {"image":"screenshot.png","device":"browser","callouts":[{"x":30,"y":40,"label":"Start here"}]}
+```
+
+```
+kinetic (base): One word or short phrase per beat at full screen (slam, stack or swap); for hooks, rules of three and key messages.
+  words   * text<=18[1..8]
+  mode      slam|stack|swap  = "slam"
+  emphasis  int 1..8
+props: {"words":["Plan","Build","Ship"],"mode":"slam","emphasis":3}
+```
+
+```
+code (base): Code or terminal text typed or revealed line by line, with highlighted lines and +/- diff lines.
+  lines    * text<=60[1..14]
+  lang       js|ts|json|py|sh|plain  = "plain"
+  reveal     type|lines  = "lines"
+  highlight  int 1..9007199254740991[..14]
+  file       text<=40
+props: {"lines":["const total = price * 2","- old line","+ new line"],"lang":"js"}
+```
+
+```
+kpi-grid (base): 2-6 headline numbers side by side, each with label, unit, change and trend arrow (good=down when a fall is good); values count up.
+  title  text
+  items* {value,label,unit,delta,trend,good}[2..6]
+  cols   int 2..3
+props: {"title":"Quarter at a glance","items":[{"value":"$4.2M","label":"Revenue","delta":"+12%","trend":"up"},{"value":86,"unit":"%","label":"Retention","delta":"-2 pts","trend":"down"}]}
+```
+
+```
+chart (base): Animated bar, line or donut chart for ranking, trend or share, with values shown and an optional highlight.
+  kind      * bar|line|donut
+  title       text
+  unit        text
+  showValues  boolean  = true
+  caption     text
+  data        {label,value}[2..8]
+  sort        none|asc|desc
+  highlight   int 0..9007199254740991
+  orient      h|v
+  x           text<=12[2..12]
+  series      {name,values}[1..3]
+  trend       {name,values}[1..3]
+props: {"kind":"bar","title":"Signups by channel","data":[{"label":"Search","value":420},{"label":"Referral","value":310},{"label":"Social","value":190}],"highlight":0}
+```
+
+```
+table (base): Small data table or ranked list (2-5 columns, 2-8 rows) with row-by-row reveal and one optional highlighted row.
+  title      text
+  columns  * text<=32[2..5]
+  rows     * text<=40|number[][2..8]
+  rank       boolean
+  highlight  int 0..9007199254740991
+  align      l|r[..5]
+props: {"title":"Top regions","columns":["Region","Revenue"],"rows":[["North","$4.2M"],["South","$3.1M"]],"rank":true,"highlight":0}
+```
+
+```
+scene3d (base): WebGL diorama (vendored three.js): post, light, material, environment presets; model presets knot|gem|sphere|torus; flat 2D canvas fallback without WebGL. 3D output is machine+GPU stable, not portable.
+  title     text<=60
+  caption   text<=140
+  model     text
+  post      clean|bloom|cinematic|vintage  = "cinematic"
+  light     studio|sunset|night|soft  = "studio"
+  material  clay|gloss|metal|emissive  = "clay"
+  hdri      neutral|studio|sunset|night  = "neutral"
+props: {"title":"Orbit"}
+```
+
+```
+sticker (base): Pop-comic sticker slam: 1-5 short phrases slam in with outline type, tilt and a starburst; for hooks, myth-vs-fact and punchy shorts.
+  words* text<=16[1..5]
+  burst  boolean  = true
+props: {"words":["Myth","Busted"],"burst":true}
+```
+
+```
+waveform (base): Audio waveform from precomputed peaks: bars rise as the playhead sweeps; for voice agents, podcasts and narrated reports. Peaks are storyboard data, never decoded audio.
+  peaks* number 0..1[16..128]
+  label  text<=40
+props: {"peaks":[0.2,0.4,0.6,0.8,0.6,0.4,0.3,0.5,0.7,0.9,0.7,0.5,0.4,0.3,0.2,0.1],"label":"Intro"}
+```

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 anvpx
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,96 @@
-# Temporary Holding Version
+# motion-kit
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+**Storyboard JSON in, animated video out.** motion-kit turns a small, validated document into an explainer, infographic or social clip and renders it locally with HyperFrames. Free and open source: no metering, no watermark, no account, no cloud.
+
+```
+brief ──► direction ──► storyboard.json ──► validate ──► preview ──► approve ──► render --gated
+          (design)      (small, diffable)   (schema+lint)  (contact sheet, stills, clip)
+```
+
+## Why it is different
+
+- **A small production document with room for original design.** Storyboards are diffable, reviewable and patchable JSON. Use catalog components where they fit, or author deterministic HTML/CSS/JS scenes for original compositions through the same build and approval path.
+- **Deterministic by construction.** Every scene is a pure function of time (`seek(t)`): no frame-rate clock, no unseeded randomness. Same-machine drafts are byte-identical.
+- **A real approval gate.** `mk preview` writes a review pack, `mk approve` records the user's yes, and `mk render --gated` refuses with exit 4 until the recorded approval matches the current inputs. Any edit re-arms it.
+- **Local and offline.** Rendering, linting, contact sheets and voice run on your machine. Confidential decks stay on disk.
+
+## Requirements
+
+- Node.js **>= 22**
+- **ffmpeg** and **ffprobe** >= 6 on `PATH`
+- Chrome for HyperFrames: `mk doctor` reports it; the first render downloads `chrome-headless-shell` if it is missing
+
+Optional voice needs Python 3.12 plus Kokoro/faster-whisper; `mk doctor` tells you what is missing. The engine itself needs no Python.
+
+## Quickstart
+
+```sh
+npx -y @anvpx/motion@0.1.1 doctor
+
+# Optional: make the rest shorter
+alias mk="npx -y @anvpx/motion@0.1.1"        # bash/zsh
+function mk { npx -y @anvpx/motion@0.1.1 @args }   # PowerShell
+
+# Optional template-assisted example, after deciding the visual direction:
+mk template list --for "how our pricing works"
+mk new explain/architecture --demo --out storyboard.json   # --demo = example copy; --set k=v for yours
+mk validate storyboard.json
+mk preview storyboard.json
+mk approve storyboard.json --note "looks right"   # only after the user said yes
+mk render storyboard.json --gated --verify
+```
+
+`mk preview` writes `out/<name>.preview/`: `contact.png` (show this first), `stills/`, `clip.mp4` and `preview.json`. `mk render` writes a delivery-quality H.264 MP4 as `<out>/final.mp4`.
+
+## What you get
+
+- **28 scene types** — title, bullets, stat, flow, chart, compare, timeline, code, scene3d and more. `mk catalog` lists them; `mk catalog <type>` shows the props.
+- **12 templates and 30 blueprints** — `mk template list --for "<brief>"` ranks blueprints; `mk template show <template>/<blueprint>` explains one.
+- **Shared themes** — light/dark families projected from DTCG tokens, plus user themes and vendored assets with a licence ledger.
+- **Edits as verbs** — `mk patch` (atomic JSON Patch), `mk scene add|remove|move`, `mk fit --seconds N`.
+- **Review without rendering** — `mk still --at 1,5,9`, `mk compare a.json b.json --at N`, `mk contact out/final.mp4`.
+- **A static player** — `mk publish storyboard.json [--serve]` writes a 16:9 page that plays the same timeline in a browser.
+- **Delivery formats** — H.264 MP4 by default; `--format webm|mov|gif|png-sequence` converts the master, and `--resolution 4k` renders at 4K (alpha and HDR are not produced).
+- **Captions in and out** — `mk captions <voice-manifest> --storyboard <s> --out ops.json` builds karaoke overlays; `--srt`/`--vtt` export captions, and `--from-srt`/`--from-vtt` import them.
+- **Asset intake** — `mk assets import <file...> --dir assets --licence <id> --source-url <url>` copies, hashes and records a ledger row.
+- **Delivery checks** — `mk verify` re-probes streams, frame count and loudness (`--loudness`), and detects black/frozen spans (`--events`).
+
+## How authoring works
+
+The agent first develops a visual argument in an authoring-only `direction.md`: concept, composition, typography, color, motion, sound and intended divergence from relevant prior work. It loads focused craft guidance for unresolved decisions, then chooses template-assisted, direct or authored realization by fit. Templates help repeat a brand system; authored scenes can carry the whole film when the brief calls for it. There is no template-exhaustion requirement or custom-scene quota. The protocol lives in the skill (`skills/motion-kit/SKILL.md`) and in `docs/AGENT-WORKFLOW.md`. Users never write storyboards; the agent designs, shows a preview, and renders only after an explicit yes.
+
+Claude Code users can install the bundled plugin with `mk plugin install`.
+
+## The approval gate
+
+```
+mk preview  →  user reviews contact.png / stills / clip  →  mk approve  →  mk render --gated --verify
+```
+
+`mk render --gated` exits **4** (`AWAITING_APPROVAL`) when the storyboard, its themes, referenced assets, asset ledger or audio inputs changed after the approval. `mk verify` exits **5** on a failed QA check. Approval is a sidecar file in `.mk/<name>/approval.json`; it is never a storyboard field.
+
+## Limits (honest version)
+
+- No GUI, editor or scrubbing player. The review surface is the preview pack plus `mk publish`.
+- Delivery is opaque video: MP4 by default, or WebM/MOV/GIF/PNG-sequence conversions of the master. No alpha channel and no HDR path.
+- Captions are generated from voice word timings or imported SRT/VTT; word-level karaoke needs a voice manifest.
+- Voice is optional and needs a Python 3.12 environment; it is not reachable from `npx` alone.
+- Determinism is proven on the same machine. Cross-machine or cross-GPU pixel equality is not claimed.
+- Pre-1.0: HyperFrames 0.8.212 and the single storyboard schema are pinned; the scene vocabulary can still change.
+
+## Development (from source)
+
+```sh
+pnpm install
+pnpm build      # tsc -b, runtime assets, generated package payloads
+pnpm scaffold:check  # fail if a generated copy drifted from its source
+pnpm check      # typecheck + lint
+pnpm test       # unit tests
+pnpm test:integration   # needs Chrome
+```
+
+Run the CLI from source with `node packages/cli/dist/main.js <command>`. Design and contracts: `PLAN.md`, `CONSTITUTION.md`; usage guide: `docs/GUIDE.md`; agent instructions: `AGENTS.md`; current work and acceptance: `docs/BEST-IN-CLASS-IMPLEMENTATION.md`.
+
+## Licence
+
+MIT — see `LICENSE`. Vendored assets keep their own licences: Lucide icons (ISC), Fontsource fonts (OFL-1.1), LUTs and music beds (CC0-1.0), three.js (MIT); every shipped file has a row in the asset ledger, and `docs/LICENCE-AUDIT.md` records the audit. HyperFrames is Apache-2.0 and is a runtime dependency.

package/assets.json

@@ -0,0 +1,37 @@
+[
+  {
+    "path": "luts/cool.cube",
+    "sourceUrl": "https://github.com/motion-kit/motion-kit/blob/main/packages/assets/luts/cool.cube",
+    "licence": "CC0-1.0",
+    "attribution": "motion-kit (original procedural LUT, CC0-1.0 public domain dedication; see luts/LICENSE-CC0.txt)",
+    "sha256": "4a526a94252483fb3c45923c447641ea5641547d100900abb4aefb4de6ef5e53"
+  },
+  {
+    "path": "luts/noir.cube",
+    "sourceUrl": "https://github.com/motion-kit/motion-kit/blob/main/packages/assets/luts/noir.cube",
+    "licence": "CC0-1.0",
+    "attribution": "motion-kit (original procedural LUT, CC0-1.0 public domain dedication; see luts/LICENSE-CC0.txt)",
+    "sha256": "c310820344d9ef2a09a5fb3678088cc2a8a44ea16527e306526161856312fe82"
+  },
+  {
+    "path": "luts/warm.cube",
+    "sourceUrl": "https://github.com/motion-kit/motion-kit/blob/main/packages/assets/luts/warm.cube",
+    "licence": "CC0-1.0",
+    "attribution": "motion-kit (original procedural LUT, CC0-1.0 public domain dedication; see luts/LICENSE-CC0.txt)",
+    "sha256": "2702600f848a77f54f787361f848f4e1d2d432a0db8e82d5e1035008c6e7618c"
+  },
+  {
+    "path": "music/bed.wav",
+    "sourceUrl": "https://github.com/motion-kit/motion-kit/blob/main/packages/assets/music/bed.wav",
+    "licence": "CC0-1.0",
+    "attribution": "motion-kit (original procedural silence bed, CC0-1.0 public domain dedication; see music/LICENSE-CC0.txt)",
+    "sha256": "e5ea01a23fcb85fd8e608c5c672ea5c22dfab6b0e581d782242f478e4b1c5900"
+  },
+  {
+    "path": "music/bed-full.wav",
+    "sourceUrl": "https://github.com/motion-kit/motion-kit/blob/main/packages/assets/music/bed-full.wav",
+    "licence": "CC0-1.0",
+    "attribution": "motion-kit (original procedural audible bed, CC0-1.0 public domain dedication; see music/LICENSE-CC0.txt)",
+    "sha256": "51a5977617fccbaec6c2dcfd6449757aa48a7c92f01dda354d9263321a6cc9b1"
+  }
+]

package/dist/index.d.ts

@@ -0,0 +1 @@
+export * from "@anvpx/motion-cli";

package/dist/index.js

@@ -0,0 +1 @@
+export * from "@anvpx/motion-cli";

package/dist/main.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/main.js

@@ -0,0 +1,46 @@
+#!/usr/bin/env node
+var __rewriteRelativeImportExtension = (this && this.__rewriteRelativeImportExtension) || function (path, preserveJsx) {
+    if (typeof path === "string" && /^\.\.?\//.test(path)) {
+        return path.replace(/\.(tsx)$|((?:\.d)?)((?:\.[^./]+?)?)\.([cm]?)ts$/i, function (m, tsx, d, ext, cm) {
+            return tsx ? preserveJsx ? ".jsx" : ".js" : d && (!ext || !cm) ? m : (d + ext + "." + cm.toLowerCase() + "js");
+        });
+    }
+    return path;
+};
+import { existsSync, readFileSync } from "node:fs";
+import { createRequire } from "node:module";
+import { dirname, resolve } from "node:path";
+import { fileURLToPath, pathToFileURL } from "node:url";
+/**
+ * Runs the mk bin declared by `@anvpx/motion-cli` so the entry point stays
+ * single-sourced. Published `@anvpx/motion` installs lack the workspace
+ * checkout, so the installed package is preferred and workspace-relative or
+ * staged copies are fallbacks (each verified with `existsSync`).
+ */
+const resolveCliBinUrl = () => {
+    const searched = [];
+    try {
+        const cliPkgPath = createRequire(import.meta.url).resolve("@anvpx/motion-cli/package.json");
+        const cliPkg = JSON.parse(readFileSync(cliPkgPath, "utf8"));
+        const bin = typeof cliPkg.bin === "string" ? cliPkg.bin : cliPkg.bin?.mk;
+        if (bin !== undefined) {
+            const abs = resolve(dirname(cliPkgPath), bin);
+            if (existsSync(abs))
+                return pathToFileURL(abs).href;
+            searched.push(abs);
+        }
+    }
+    catch {
+        /* fall through to workspace-relative and staged fallbacks */
+    }
+    for (const candidate of [
+        fileURLToPath(new URL("../../cli/dist/main.js", import.meta.url)),
+        fileURLToPath(new URL("./cli/main.js", import.meta.url)),
+    ]) {
+        if (existsSync(candidate))
+            return pathToFileURL(candidate).href;
+        searched.push(candidate);
+    }
+    throw new Error(`Cannot locate @anvpx/motion-cli (fixable: reinstall @anvpx/motion with its dependencies). Searched: ${searched.join(", ") || "(none)"}`);
+};
+await import(__rewriteRelativeImportExtension(resolveCliBinUrl()));

package/icons/LICENSE-lucide

@@ -0,0 +1,43 @@
+ISC License
+
+Copyright (c) 2026 Lucide Icons and Contributors
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
+
+---
+
+The following Lucide icons are derived from the Feather project:
+
+airplay, alert-circle, alert-octagon, alert-triangle, aperture, arrow-down-circle, arrow-down-left, arrow-down-right, arrow-down, arrow-left-circle, arrow-left, arrow-right-circle, arrow-right, arrow-up-circle, arrow-up-left, arrow-up-right, arrow-up, at-sign, calendar, cast, check, chevron-down, chevron-left, chevron-right, chevron-up, chevrons-down, chevrons-left, chevrons-right, chevrons-up, circle, clipboard, clock, code, columns, command, compass, corner-down-left, corner-down-right, corner-left-down, corner-left-up, corner-right-down, corner-right-up, corner-up-left, corner-up-right, crosshair, database, divide-circle, divide-square, dollar-sign, download, external-link, feather, frown, hash, headphones, help-circle, info, italic, key, layout, life-buoy, link-2, link, loader, lock, log-in, log-out, maximize, meh, minimize, minimize-2, minus-circle, minus-square, minus, monitor, moon, more-horizontal, more-vertical, move, music, navigation-2, navigation, octagon, pause-circle, percent, plus-circle, plus-square, plus, power, radio, rss, search, server, share, shopping-bag, sidebar, smartphone, smile, square, table-2, tablet, target, terminal, trash-2, trash, triangle, tv, type, upload, x-circle, x-octagon, x-square, x, zoom-in, zoom-out
+
+The MIT License (MIT) (for the icons listed above)
+
+Copyright (c) 2013-present Cole Bemis
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.