@anvpx/motion 0.0.0-stage → 0.1.1

package/packs/painted/examples/dry-ink/storyboard.json

@@ -0,0 +1,88 @@
+{
+  "meta": {
+    "fps": 30,
+    "height": 1080,
+    "lang": "en",
+    "theme": "default",
+    "title": "How compost becomes soil — dry-ink",
+    "width": 1920
+  },
+  "scenes": [
+    {
+      "duration": 4,
+      "ease": "out",
+      "id": "intro",
+      "move": "static",
+      "props": {
+        "kicker": "Soil school",
+        "subtitle": "Greens, browns, patience",
+        "title": "How compost becomes soil"
+      },
+      "shot": "overhead",
+      "type": "title"
+    },
+    {
+      "duration": 8,
+      "ease": "out",
+      "id": "line",
+      "move": "static",
+      "props": {
+        "layout": "path",
+        "steps": [
+          {
+            "detail": "Greens plus browns",
+            "label": "Feed",
+            "value": "1:3"
+          },
+          {
+            "detail": "Damp as wrung sponge",
+            "label": "Damp",
+            "value": "Wrung"
+          },
+          {
+            "detail": "Turn when the core cools",
+            "label": "Turn",
+            "value": "When cool"
+          }
+        ],
+        "title": "Lay the dry line"
+      },
+      "shot": "overhead",
+      "transition": "cut",
+      "type": "steps"
+    },
+    {
+      "duration": 7,
+      "ease": "out",
+      "id": "notes",
+      "move": "pan-l",
+      "props": {
+        "items": [
+          "One part greens to three browns",
+          "Moist as a wrung sponge",
+          "Turn when the core cools"
+        ],
+        "title": "Three feed rules"
+      },
+      "shot": "overhead",
+      "transition": "cut",
+      "type": "bullets"
+    },
+    {
+      "duration": 6,
+      "ease": "out",
+      "id": "aside",
+      "move": "pan-l",
+      "props": {
+        "kind": "tip",
+        "label": "The turn rule",
+        "note": "Heat means working; cool means turn",
+        "text": "[Turn] when the core cools"
+      },
+      "shot": "overhead",
+      "transition": "crossfade",
+      "type": "callout"
+    }
+  ],
+  "version": 1
+}

package/packs/painted/examples/oil/storyboard.json

@@ -0,0 +1,89 @@
+{
+  "meta": {
+    "fps": 30,
+    "height": 1080,
+    "lang": "en",
+    "theme": "default",
+    "title": "How compost becomes soil — oil",
+    "width": 1920
+  },
+  "scenes": [
+    {
+      "duration": 4,
+      "ease": "out",
+      "id": "intro",
+      "move": "reveal",
+      "props": {
+        "kicker": "Soil school",
+        "subtitle": "Greens, browns, patience",
+        "title": "How compost becomes soil"
+      },
+      "shot": "close",
+      "type": "title"
+    },
+    {
+      "duration": 8,
+      "ease": "out",
+      "id": "layers",
+      "move": "reveal",
+      "props": {
+        "layout": "ladder",
+        "steps": [
+          { "detail": "Dry leaves, cardboard", "label": "Browns", "value": "3 parts" },
+          { "detail": "Scraps, cuttings", "label": "Greens", "value": "1 part" },
+          { "detail": "Rest 8 to 12 weeks", "label": "Cure", "value": "Patience" }
+        ],
+        "title": "Lay the beats down"
+      },
+      "shot": "close",
+      "transition": "cut",
+      "type": "steps"
+    },
+    {
+      "duration": 8,
+      "ease": "out",
+      "id": "season",
+      "move": "reveal",
+      "props": {
+        "items": [
+          {
+            "detail": "Greens plus browns, damp",
+            "label": "Build",
+            "state": "done",
+            "when": "Wk1"
+          },
+          { "detail": "Turn when the core cools", "label": "Turn", "state": "now", "when": "Wk4" },
+          {
+            "detail": "Dark, crumbly, smells like soil",
+            "label": "Sift",
+            "state": "next",
+            "when": "Wk8-12"
+          }
+        ],
+        "orient": "v",
+        "title": "Hold each beat"
+      },
+      "shot": "close",
+      "transition": "cut",
+      "type": "timeline"
+    },
+    {
+      "duration": 7,
+      "ease": "out",
+      "id": "notes",
+      "move": "reveal",
+      "props": {
+        "items": [
+          "One part greens to three browns",
+          "Damp as a wrung-out sponge",
+          "Heat means working; turn when cool"
+        ],
+        "title": "Oil holds"
+      },
+      "shot": "close",
+      "transition": "crossfade",
+      "type": "bullets"
+    }
+  ],
+  "version": 1
+}

package/packs/painted/examples/shape-carry/storyboard.json

@@ -0,0 +1,112 @@
+{
+  "meta": {
+    "fps": 30,
+    "height": 1080,
+    "lang": "en",
+    "theme": "default",
+    "title": "How compost becomes soil \u00e2\u20ac\u201d shape carry",
+    "width": 1920
+  },
+  "scenes": [
+    {
+      "duration": 4,
+      "ease": "out",
+      "id": "intro",
+      "move": "pan-r",
+      "props": {
+        "kicker": "Soil school",
+        "subtitle": "Greens, browns, patience",
+        "title": "How compost becomes soil"
+      },
+      "shot": "wide",
+      "type": "title"
+    },
+    {
+      "duration": 7,
+      "ease": "out",
+      "id": "season",
+      "move": "pan-r",
+      "props": {
+        "items": [
+          {
+            "detail": "Greens plus browns, damp",
+            "label": "Build",
+            "state": "done",
+            "when": "Wk1"
+          },
+          {
+            "detail": "Turn when the core cools",
+            "label": "Turn",
+            "state": "now",
+            "when": "Wk4"
+          },
+          {
+            "detail": "Dark and crumbly",
+            "label": "Sift",
+            "state": "next",
+            "when": "Wk8-12"
+          }
+        ],
+        "orient": "h",
+        "title": "Pile carries through"
+      },
+      "shot": "wide",
+      "transition": "cut",
+      "type": "timeline"
+    },
+    {
+      "duration": 6,
+      "ease": "out",
+      "id": "diagram",
+      "move": "pan-r",
+      "props": {
+        "direction": "tb",
+        "edges": [
+          {
+            "from": "pile",
+            "label": "holds",
+            "to": "heat"
+          },
+          {
+            "from": "heat",
+            "label": "cools, turn",
+            "to": "soil"
+          }
+        ],
+        "nodes": [
+          {
+            "id": "pile",
+            "label": "Pile"
+          },
+          {
+            "id": "heat",
+            "label": "Heat"
+          },
+          {
+            "id": "soil",
+            "label": "Soil"
+          }
+        ]
+      },
+      "shot": "wide",
+      "transition": "cut",
+      "type": "flow"
+    },
+    {
+      "duration": 6,
+      "ease": "out",
+      "id": "aside",
+      "move": "pan-r",
+      "props": {
+        "kind": "tip",
+        "label": "The turn rule",
+        "note": "Same pile silhouette; copy changes around it",
+        "text": "[Turn] the same pile when cool"
+      },
+      "shot": "wide",
+      "transition": "crossfade",
+      "type": "callout"
+    }
+  ],
+  "version": 1
+}

package/packs/painted/examples/stacked-beat/storyboard.json

@@ -0,0 +1,106 @@
+{
+  "meta": {
+    "fps": 30,
+    "height": 1080,
+    "lang": "en",
+    "theme": "default",
+    "title": "How compost becomes soil \u00e2\u20ac\u201d stacked beat",
+    "width": 1920
+  },
+  "scenes": [
+    {
+      "duration": 4,
+      "ease": "out",
+      "id": "intro",
+      "move": "reveal",
+      "props": {
+        "kicker": "Soil school",
+        "subtitle": "Greens, browns, patience",
+        "title": "How compost becomes soil"
+      },
+      "shot": "close",
+      "type": "title"
+    },
+    {
+      "duration": 8,
+      "ease": "out",
+      "id": "layers",
+      "move": "reveal",
+      "props": {
+        "layout": "ladder",
+        "steps": [
+          {
+            "detail": "Dry leaves, cardboard",
+            "label": "Browns",
+            "value": "3 parts"
+          },
+          {
+            "detail": "Scraps, cuttings",
+            "label": "Greens",
+            "value": "1 part"
+          },
+          {
+            "detail": "Rest 8 to 12 weeks",
+            "label": "Cure",
+            "value": "Patience"
+          }
+        ],
+        "title": "Stack the pile"
+      },
+      "shot": "close",
+      "transition": "cut",
+      "type": "steps"
+    },
+    {
+      "duration": 8,
+      "ease": "out",
+      "id": "season",
+      "move": "reveal",
+      "props": {
+        "items": [
+          {
+            "detail": "Greens plus browns, damp",
+            "label": "Build",
+            "state": "done",
+            "when": "Wk1"
+          },
+          {
+            "detail": "Turn when the core cools",
+            "label": "Turn",
+            "state": "now",
+            "when": "Wk4"
+          },
+          {
+            "detail": "Dark, crumbly, smells like soil",
+            "label": "Sift",
+            "state": "next",
+            "when": "Wk8-12"
+          }
+        ],
+        "orient": "v",
+        "title": "Three beats"
+      },
+      "shot": "close",
+      "transition": "cut",
+      "type": "timeline"
+    },
+    {
+      "duration": 7,
+      "ease": "out",
+      "id": "notes",
+      "move": "reveal",
+      "props": {
+        "items": [
+          "One part greens to three browns",
+          "Moist as a wrung sponge",
+          "Turn when the core cools"
+        ],
+        "title": "Three feed rules"
+      },
+      "shot": "close",
+      "transition": "crossfade",
+      "type": "bullets"
+    }
+  ],
+  "version": 1
+}

package/packs/painted/examples/staged-read/storyboard.json

@@ -0,0 +1,105 @@
+{
+  "meta": {
+    "fps": 30,
+    "height": 1080,
+    "lang": "en",
+    "theme": "default",
+    "title": "How compost becomes soil \u00e2\u20ac\u201d staged read",
+    "width": 1920
+  },
+  "scenes": [
+    {
+      "duration": 4,
+      "ease": "out",
+      "id": "intro",
+      "move": "push-in",
+      "props": {
+        "kicker": "Soil school",
+        "subtitle": "Greens, browns, patience",
+        "title": "How compost becomes soil"
+      },
+      "shot": "medium",
+      "type": "title"
+    },
+    {
+      "duration": 6,
+      "ease": "out",
+      "id": "diagram",
+      "move": "push-in",
+      "props": {
+        "direction": "lr",
+        "edges": [
+          {
+            "from": "greens",
+            "label": "nitrogen",
+            "to": "pile"
+          },
+          {
+            "from": "browns",
+            "label": "carbon",
+            "to": "pile"
+          },
+          {
+            "from": "pile",
+            "label": "heat + time",
+            "to": "soil"
+          }
+        ],
+        "nodes": [
+          {
+            "id": "greens",
+            "label": "Greens"
+          },
+          {
+            "id": "browns",
+            "label": "Browns"
+          },
+          {
+            "id": "pile",
+            "label": "Pile"
+          },
+          {
+            "id": "soil",
+            "label": "Soil"
+          }
+        ]
+      },
+      "shot": "medium",
+      "transition": "cut",
+      "type": "flow"
+    },
+    {
+      "duration": 7,
+      "ease": "out",
+      "id": "notes",
+      "move": "push-in",
+      "props": {
+        "items": [
+          "One part greens to three browns",
+          "Moist as a wrung sponge",
+          "Turn when the core cools"
+        ],
+        "title": "Three feed rules"
+      },
+      "shot": "medium",
+      "transition": "cut",
+      "type": "bullets"
+    },
+    {
+      "duration": 5,
+      "ease": "out",
+      "id": "aside",
+      "move": "push-in",
+      "props": {
+        "kind": "tip",
+        "label": "The turn rule",
+        "note": "Heat means working; cool means turn",
+        "text": "[Turn] when the core cools"
+      },
+      "shot": "medium",
+      "transition": "crossfade",
+      "type": "callout"
+    }
+  ],
+  "version": 1
+}

package/packs/painted/examples/watercolour/storyboard.json

@@ -0,0 +1,79 @@
+{
+  "meta": {
+    "fps": 30,
+    "height": 1080,
+    "lang": "en",
+    "theme": "default",
+    "title": "How compost becomes soil — watercolour",
+    "width": 1920
+  },
+  "scenes": [
+    {
+      "duration": 4,
+      "ease": "out",
+      "id": "intro",
+      "move": "pull-out",
+      "props": {
+        "kicker": "Soil school",
+        "subtitle": "Greens, browns, patience",
+        "title": "How compost becomes soil"
+      },
+      "shot": "overhead",
+      "type": "title"
+    },
+    {
+      "duration": 8,
+      "ease": "out",
+      "id": "mix",
+      "move": "pull-out",
+      "props": {
+        "left": {
+          "label": "Greens",
+          "points": ["Scraps, cuttings", "Nitrogen"],
+          "value": "1 part"
+        },
+        "mode": "split",
+        "right": {
+          "label": "Browns",
+          "points": ["Leaves, cardboard", "Carbon"],
+          "value": "3 parts"
+        },
+        "title": "Greens feed, browns balance",
+        "verdict": "One part greens to three browns",
+        "winner": "right",
+        "winnerLabel": "Balance"
+      },
+      "shot": "overhead",
+      "transition": "cut",
+      "type": "compare"
+    },
+    {
+      "duration": 7,
+      "ease": "out",
+      "id": "wash",
+      "move": "pull-out",
+      "props": { "emphasis": 3, "mode": "stack", "words": ["Stack it", "Dampen it", "Turn it"] },
+      "shot": "overhead",
+      "transition": "cut",
+      "type": "kinetic"
+    },
+    {
+      "duration": 7,
+      "ease": "out",
+      "id": "cure",
+      "move": "pull-out",
+      "props": {
+        "lines": [
+          "Damp as a wrung-out sponge",
+          "Turn when the core cools",
+          "Dark, crumbly, smells like soil"
+        ],
+        "title": "Patience turns scraps into soil"
+      },
+      "shot": "overhead",
+      "transition": "crossfade",
+      "type": "outro"
+    }
+  ],
+  "version": 1
+}

package/packs/painted/look.md

@@ -0,0 +1,71 @@
+# Painted — look guide (qualified, authoring only)
+
+Warm hand-painted explainer told with existing native scenes. Ideas
+arrive the way a whiteboard talk does — one reveal at a time, earlier
+marks persist — but every shot compiles to current scene props. No
+brush renderer is promised or required.
+
+## Native mapping
+
+Use `title`, `bullets`, `flow`, `steps`, `timeline`, `callout`. Keep
+text in scene copy slots; never bake words into images. Theme and
+palette come from an existing StylePreset at authoring time; this pack
+adds no theme, atom, or dependency. Paper warmth and sketch greys are
+flat native fills, not painted textures.
+
+## Variants (pick one, record why)
+
+- `watercolour`: light wash read. Soft flat washes sit behind staged
+  left-to-right reveals; one idea enters at a time and earlier marks
+  persist on the paper. Airy, calm, generous whitespace.
+- `oil`: dense stacked read. Beats stack downward with a pause between
+  each; every new beat is laid over settled marks that stay visible
+  (dimmed if needed). Heavier fills, still flat.
+- `dry-ink`: crisp line read. One carried silhouette or frame position
+  anchors changing copy and callouts across shots; no wash, sketch
+  lines only, maximum restraint.
+
+Record the chosen variant plus one `staging-density` and one
+`accent-restraint` decision in the outline variation note (<= 200
+words total for the outline).
+
+## Staging
+
+- One core meaning per shot. Sequence reveals by narrative event
+  (setup, subject, change, reaction), never by screen position.
+- First frame is clean paper. Nothing appears before its reveal beat;
+  undrawn areas stay empty until their turn.
+- Persist the canvas: keep earlier marks visible (dimmed if needed) so
+  the viewer never re-orients from scratch.
+- Shape continuity: carry one silhouette or frame position across
+  shots while copy changes around it.
+
+## Palette and type
+
+- Paper-warm background, dark-grey sketch lines, generous whitespace.
+- At most one small conceptual accent per film (warm red, ochre, or
+  blue). Accent marks a single job: the change, the warning, the win.
+- Minimal illustration; no photorealism, no texture tricks, no p5
+  brush strokes. If the brief needs true painted strokes, record it
+  as unsupported (see Limits) and stay with flat sketch marks.
+
+## Motion (manual timing only)
+
+- Reveal, then hold: enter an idea, hold the full frame briefly
+  (>= 0.5 s) before the next reveal.
+- Prefer cuts and short settles authored in scene timing and
+  direction enums. Do not invent eases, blurs, or mask channels.
+- Keep at most one moving idea per frame; two panels only when the
+  brief demands comparison and one panel clearly dominates.
+
+## Limits (read before promising)
+
+- No streaming-ink renderer, no region-mask reveal scene, no SRT
+  ingestion. Those are parked Stage-C candidates, not this pack.
+- No procedural brush, hand asset, or font bundled. New assets need
+  ledger rows; new fonts need a separate approval packet.
+- Music, sfx, and voice treatment are opt-in (see voice.md).
+- Qualified state: the qualification review shipped with this pack plus the
+  fixture briefs validate build + preview exit 0, rubric PASS.
+  Qualified for discovery/authoring only; final full render + human
+  board sign-off still pending.