@anvpx/motion 0.0.0-stage → 0.1.0

package/templates/recap/blueprints/timeline-story.json

@@ -0,0 +1,94 @@
+{
+  "discover": {
+    "aspects": ["16:9", "1:1"],
+    "audience": ["readers", "community", "stakeholders"],
+    "goodFor": "One story in 3-7 eras with a takeaway.",
+    "lengths": { "max": 90, "min": 40 },
+    "notFor": "Period news roundups, metric charts (datastory/trend), live occasions.",
+    "tags": ["recap", "history", "timeline", "chart"],
+    "tone": ["calm", "friendly"],
+    "useCases": [
+      "Tell how a project or place changed across three to seven eras.",
+      "Pair a timeline with one chart that shows the direction.",
+      "Close a history with one takeaway line."
+    ]
+  },
+  "example": {
+    "chartTitle": "Loaves baked each morning",
+    "closing": "Still the same corner shop",
+    "data": [
+      { "label": "2019", "value": 60 },
+      { "label": "2020", "value": 90 },
+      { "label": "2021", "value": 140 },
+      { "label": "2022", "value": 200 }
+    ],
+    "eras": [
+      { "detail": "One oven", "label": "Doors open", "when": "2019" },
+      { "detail": "Bread to go", "label": "Second oven", "when": "2020" },
+      { "detail": "Tables outside", "label": "Cafe corner", "when": "2021" },
+      { "detail": "Bakes for neighbors", "label": "Street staple", "when": "2022" }
+    ],
+    "takeaway": "Slow growth [kept] the bakery on its corner",
+    "topic": "The corner bakery",
+    "unit": "loaves"
+  },
+  "id": "timeline-story",
+  "meta": { "lang": "en", "title": { "$slot": "topic" } },
+  "purpose": "Tell one story in 40-90s: eras on a timeline, an optional chart, a takeaway.",
+  "scenes": [
+    {
+      "id": "intro",
+      "props": { "kicker": "Story", "title": { "$slot": "topic" } },
+      "type": "title"
+    },
+    {
+      "id": "eras",
+      "props": { "items": { "$slot": "eras" }, "title": "How it unfolded" },
+      "type": "timeline"
+    },
+    {
+      "id": "trend",
+      "props": {
+        "data": { "$slot": "data" },
+        "kind": "bar",
+        "orient": "v",
+        "sort": "none",
+        "title": { "$slot": "chartTitle" },
+        "unit": { "$slot": "unit" }
+      },
+      "type": "chart",
+      "when": "data"
+    },
+    {
+      "id": "point",
+      "props": { "kind": "statement", "label": "Takeaway", "text": { "$slot": "takeaway" } },
+      "type": "callout"
+    },
+    { "id": "end", "props": { "title": { "$slot": "closing" } }, "type": "outro" }
+  ],
+  "slots": {
+    "chartTitle": { "default": "By the numbers", "max": 50, "type": "text" },
+    "closing": { "max": 60, "required": true, "type": "text" },
+    "data": {
+      "fields": { "label": "text", "value": "number" },
+      "list": true,
+      "max": 8,
+      "min": 3,
+      "optional": true,
+      "type": "object"
+    },
+    "eras": {
+      "fields": { "detail": "text", "label": "text", "when": "text" },
+      "list": true,
+      "max": 7,
+      "min": 3,
+      "required": true,
+      "type": "object"
+    },
+    "length": { "default": "standard", "type": "enum", "values": ["short", "standard", "long"] },
+    "style": { "default": "editorial", "type": "enum", "values": ["editorial", "editorialdark"] },
+    "takeaway": { "max": 110, "required": true, "type": "text" },
+    "topic": { "max": 40, "required": true, "type": "text" },
+    "unit": { "default": "", "max": 12, "type": "text" }
+  }
+}

package/templates/recap/copy.md

@@ -0,0 +1,16 @@
+# Recap copy guide
+
+Tone: calm, direct, factual. Say what happened, in order, then what it means.
+
+Do
+- Title: the period or story in at most 8 words.
+- Timeline: each entry names one event; detail adds one fact, at most 10 words.
+- Numbers: at most one or two figures; label says what was counted.
+- Close with one takeaway of at most 15 words, no new facts.
+
+Don't
+- No more than 7 entries, one idea per entry, no new facts at the close.
+- No superlatives you cannot prove; no invented figures, quotes or dates.
+- No exclamation marks, emoji, or "simply", "just", "easy".
+
+Vocabulary: "look back" not "deep dive", "period" not "leverage", "takeaway" not "learnings".

package/templates/recap/pacing.json

@@ -0,0 +1,16 @@
+{
+  "lengths": {
+    "long": { "scenes": [5, 7], "totalSec": [35, 100] },
+    "short": { "scenes": [3, 5], "totalSec": [12, 40] },
+    "standard": { "scenes": [4, 6], "totalSec": [20, 70] }
+  },
+  "sceneSeconds": {
+    "callout": { "long": 8, "short": 4, "standard": 6 },
+    "chart": { "long": 8, "short": 5, "standard": 6 },
+    "outro": { "long": 5, "short": 3, "standard": 4 },
+    "stat": { "long": 6, "short": 4, "standard": 5 },
+    "timeline": { "long": 14, "short": 7, "standard": 10 },
+    "title": { "long": 5, "short": 3, "standard": 4 }
+  },
+  "wordsPerSecond": 2.5
+}

package/templates/recap/styles/editorial.json

@@ -0,0 +1,6 @@
+{
+  "direction": { "ease": "out", "move": "push-in", "shot": "medium", "transition": "cut" },
+  "frame": { "fps": 30, "height": 1080, "width": 1920 },
+  "id": "editorial",
+  "theme": "editorial-light"
+}

package/templates/recap/styles/editorialdark.json

@@ -0,0 +1,6 @@
+{
+  "direction": { "ease": "out", "move": "push-in", "shot": "medium", "transition": "crossfade" },
+  "frame": { "fps": 30, "height": 1080, "width": 1920 },
+  "id": "editorialdark",
+  "theme": "editorial-dark"
+}

package/templates/recap/template.json

@@ -0,0 +1,50 @@
+{
+  "blueprints": [
+    { "file": "blueprints/news-recap.json", "id": "news-recap" },
+    { "file": "blueprints/timeline-story.json", "id": "timeline-story" }
+  ],
+  "copy": "copy.md",
+  "discover": {
+    "aspects": ["16:9", "1:1"],
+    "audience": ["readers", "team", "stakeholders"],
+    "goodFor": "A look back: events in order, at most a few numbers, one takeaway.",
+    "notFor": "Live announcements (event), metric deep dives (datastory).",
+    "tags": ["recap", "news", "timeline", "history", "data"],
+    "tone": ["calm", "direct"],
+    "useCases": [
+      "Recap a period's events in order with one number to remember.",
+      "Tell the story of a project as a timeline with a takeaway.",
+      "Summarise what happened for readers who missed it."
+    ]
+  },
+  "domains": ["report", "news", "history"],
+  "id": "recap",
+  "license": "Apache-2.0",
+  "pacing": "pacing.json",
+  "requires": {
+    "scenes": ["title", "timeline", "stat", "chart", "callout", "outro"],
+    "storyboard": 1
+  },
+  "styles": [
+    { "file": "styles/editorial.json", "id": "editorial" },
+    { "file": "styles/editorialdark.json", "id": "editorialdark" }
+  ],
+  "summary": "Look back at a period or a story: timelines, numbers and one takeaway.",
+  "templateVersion": 1,
+  "themes": [
+    {
+      "file": "@shared/editorial-light.json",
+      "id": "editorial-light",
+      "mode": "light",
+      "pair": "editorial-dark"
+    },
+    {
+      "file": "@shared/editorial-dark.json",
+      "id": "editorial-dark",
+      "mode": "dark",
+      "pair": "editorial-light"
+    }
+  ],
+  "title": "Recap",
+  "version": "1.0.0"
+}

package/templates/report/blueprints/kpi-review.json

@@ -0,0 +1,116 @@
+{
+  "id": "kpi-review",
+  "purpose": "Review a period: 2-4 headline numbers with change and direction, 2-4 insights, optional next steps.",
+  "discover": {
+    "useCases": [
+      "Summarise a period's results for leadership with three or four headline numbers.",
+      "Review key metrics against the previous period and name what drove each change.",
+      "Close a review meeting with the evidence, the reasons and the next steps."
+    ],
+    "audience": ["executives", "managers", "finance"],
+    "goodFor": "Periodic results with 2-4 measured numbers, their change and a few reasons.",
+    "notFor": "One finding told as a story (datastory), project health by workstream (status).",
+    "tags": ["report", "kpi", "finance", "review", "data", "qbr", "update"],
+    "tone": ["formal", "direct"],
+    "aspects": ["16:9"],
+    "lengths": { "min": 25, "max": 70 }
+  },
+  "slots": {
+    "subject": { "type": "text", "max": 40, "default": "Performance review" },
+    "period": { "type": "text", "max": 30, "required": true },
+    "kpis": {
+      "type": "object",
+      "fields": {
+        "value": "text",
+        "unit": "text",
+        "label": "text",
+        "delta": "text",
+        "trend": "text",
+        "good": "text"
+      },
+      "list": true,
+      "min": 2,
+      "max": 4,
+      "required": true
+    },
+    "insights": { "type": "text[]", "min": 2, "max": 4, "itemMax": 60, "required": true },
+    "next": { "type": "text[]", "min": 1, "max": 3, "itemMax": 50, "optional": true },
+    "closing": { "type": "text", "max": 60, "default": "Decision needed on next steps" },
+    "length": { "type": "enum", "values": ["short", "standard", "long"], "default": "standard" },
+    "style": { "type": "enum", "values": ["exec", "walkthrough", "memo"], "default": "walkthrough" }
+  },
+  "example": {
+    "subject": "Quarterly review",
+    "period": "Q3 (illustrative data)",
+    "kpis": [
+      {
+        "value": "4.2",
+        "unit": "M",
+        "label": "Revenue",
+        "delta": "+12%",
+        "trend": "up",
+        "good": "up"
+      },
+      {
+        "value": "86",
+        "unit": "%",
+        "label": "Retention",
+        "delta": "-2 pts",
+        "trend": "down",
+        "good": "up"
+      },
+      {
+        "value": "3.1",
+        "unit": "days",
+        "label": "Time to resolve",
+        "delta": "-0.6",
+        "trend": "down",
+        "good": "down"
+      },
+      {
+        "value": "18",
+        "unit": "%",
+        "label": "Cost share",
+        "delta": "+1 pt",
+        "trend": "up",
+        "good": "down"
+      }
+    ],
+    "insights": [
+      "Revenue grew on larger average orders",
+      "Retention slipped in the newest cohort",
+      "Faster resolution followed the new queue"
+    ],
+    "next": ["Review the newest cohort", "Hold costs flat", "Set next quarter targets"],
+    "closing": "Decision needed on next steps"
+  },
+  "meta": { "title": { "$slot": "subject" }, "lang": "en" },
+  "scenes": [
+    {
+      "id": "intro",
+      "type": "title",
+      "props": {
+        "kicker": "KPI review",
+        "title": { "$slot": "subject" },
+        "subtitle": { "$slot": "period" }
+      }
+    },
+    {
+      "id": "numbers",
+      "type": "kpi-grid",
+      "props": { "title": "Results", "items": { "$slot": "kpis" } }
+    },
+    {
+      "id": "why",
+      "type": "bullets",
+      "props": { "title": "What drove it", "items": { "$slot": "insights" }, "marker": "dot" }
+    },
+    {
+      "when": "next",
+      "id": "next",
+      "type": "bullets",
+      "props": { "title": "Next", "items": { "$slot": "next" }, "marker": "number" }
+    },
+    { "id": "end", "type": "outro", "props": { "title": { "$slot": "closing" } } }
+  ]
+}

package/templates/report/blueprints/status.json

@@ -0,0 +1,78 @@
+{
+  "id": "status",
+  "purpose": "Report a project's health: 2-6 workstreams, each a state word with its own icon, up to 3 risks and one ask.",
+  "discover": {
+    "useCases": [
+      "Report a project's health by workstream, with the main risks and one request.",
+      "Give sponsors a one-minute status before a go or no-go decision.",
+      "Show what is on track, at risk or blocked and what help would unblock it."
+    ],
+    "audience": ["executives", "managers", "stakeholders"],
+    "goodFor": "A project or programme with 2-6 parts, each with a clear state, and an ask.",
+    "notFor": "Metric results (kpi-review), weekly team progress (update/weekly-update).",
+    "tags": ["report", "status", "review", "internal", "update", "roadmap"],
+    "tone": ["formal", "direct"],
+    "aspects": ["16:9"],
+    "lengths": { "min": 20, "max": 60 }
+  },
+  "slots": {
+    "project": { "type": "text", "max": 40, "required": true },
+    "asOf": { "type": "text", "max": 40, "default": "Current status" },
+    "workstreams": {
+      "type": "object",
+      "fields": { "icon": "text", "label": "text", "detail": "text" },
+      "list": true,
+      "min": 2,
+      "max": 6,
+      "required": true
+    },
+    "risks": { "type": "text[]", "min": 1, "max": 3, "itemMax": 60, "optional": true },
+    "ask": { "type": "text", "max": 100, "optional": true },
+    "closing": { "type": "text", "max": 60, "default": "Next update in two weeks" },
+    "length": { "type": "enum", "values": ["short", "standard", "long"], "default": "standard" },
+    "style": { "type": "enum", "values": ["exec", "walkthrough", "memo"], "default": "exec" }
+  },
+  "example": {
+    "project": "Platform migration",
+    "asOf": "Status as of week 12 (illustrative)",
+    "workstreams": [
+      { "icon": "badge-check", "label": "Done", "detail": "Data transfer" },
+      { "icon": "trending-up", "label": "On track", "detail": "Service cutover" },
+      { "icon": "triangle-alert", "label": "At risk", "detail": "Vendor contract" },
+      { "icon": "ban", "label": "Blocked", "detail": "Security review" }
+    ],
+    "risks": ["Contract signature may slip two weeks", "Review needs one more engineer"],
+    "ask": "Approve one extra reviewer to hold the launch date",
+    "closing": "Next update in two weeks"
+  },
+  "meta": { "title": { "$slot": "project" }, "lang": "en" },
+  "scenes": [
+    {
+      "id": "intro",
+      "type": "title",
+      "props": {
+        "kicker": "Status",
+        "title": { "$slot": "project" },
+        "subtitle": { "$slot": "asOf" }
+      }
+    },
+    {
+      "id": "streams",
+      "type": "icon-grid",
+      "props": { "title": "Workstreams", "items": { "$slot": "workstreams" } }
+    },
+    {
+      "when": "risks",
+      "id": "risks",
+      "type": "bullets",
+      "props": { "title": "Risks", "items": { "$slot": "risks" }, "marker": "cross" }
+    },
+    {
+      "when": "ask",
+      "id": "ask",
+      "type": "callout",
+      "props": { "text": { "$slot": "ask" }, "kind": "statement", "label": "The ask" }
+    },
+    { "id": "end", "type": "outro", "props": { "title": { "$slot": "closing" } } }
+  ]
+}

package/templates/report/copy.md

@@ -0,0 +1,17 @@
+# Report copy guide
+
+Tone: formal, direct, numerate. State the result, then the reason. No spin.
+
+Do
+- Values exactly as measured ("98.9", "$4.2M"); unit in its own field ("%", "days"); label 1-3 words.
+- Delta against the previous period with a sign ("+0.4 pts"). Say which direction is good when a fall is good.
+- Insights: one clause, cause then effect ("Faster reviews cut churn").
+- Workstreams: the state word is the label ("On track", "At risk", "Blocked", "Done") with its own icon; the workstream name is the detail. Never rely on colour alone. Risks name an owner or a need.
+- Close with the single decision or request.
+
+Don't
+- No adjectives that judge ("great", "disappointing"); let the number speak.
+- No more than 4 numbers, 4 insights, 6 workstreams or 3 risks per report.
+- No invented figures; every number comes from the brief.
+
+Vocabulary: "quarter" not "Q-end", "risk" not "challenge", "ask" not "wish".

package/templates/report/pacing.json

@@ -0,0 +1,16 @@
+{
+  "wordsPerSecond": 2.5,
+  "sceneSeconds": {
+    "title": { "short": 3, "standard": 4, "long": 5 },
+    "kpi-grid": { "short": 5, "standard": 6, "long": 7 },
+    "bullets": { "short": 5, "standard": 7, "long": 10 },
+    "icon-grid": { "short": 6, "standard": 9, "long": 12 },
+    "callout": { "short": 4, "standard": 6, "long": 8 },
+    "outro": { "short": 3, "standard": 4, "long": 5 }
+  },
+  "lengths": {
+    "short": { "scenes": [3, 5], "totalSec": [15, 40] },
+    "standard": { "scenes": [4, 5], "totalSec": [25, 60] },
+    "long": { "scenes": [4, 6], "totalSec": [40, 90] }
+  }
+}

package/templates/report/styles/exec.json

@@ -0,0 +1,6 @@
+{
+  "id": "exec",
+  "theme": "data-light",
+  "frame": { "width": 1920, "height": 1080, "fps": 30 },
+  "direction": { "shot": "wide", "move": "static", "ease": "in-out", "transition": "crossfade" }
+}

package/templates/report/styles/memo.json

@@ -0,0 +1,6 @@
+{
+  "id": "memo",
+  "theme": "editorial-light",
+  "frame": { "width": 1920, "height": 1080, "fps": 30 },
+  "direction": { "shot": "medium", "move": "static", "ease": "in-out", "transition": "crossfade" }
+}

package/templates/report/styles/walkthrough.json

@@ -0,0 +1,6 @@
+{
+  "id": "walkthrough",
+  "theme": "calm-light",
+  "frame": { "width": 1920, "height": 1080, "fps": 30 },
+  "direction": { "shot": "medium", "move": "push-in", "ease": "out", "transition": "crossfade" }
+}

package/templates/report/template.json

@@ -0,0 +1,56 @@
+{
+  "templateVersion": 1,
+  "id": "report",
+  "version": "1.0.1",
+  "title": "Report",
+  "summary": "Numbers for decision makers: KPI reviews and project status with risks and an ask. 16:9.",
+  "domains": ["finance", "management", "operations"],
+  "discover": {
+    "useCases": [
+      "Summarise a period's results for leadership with three or four headline numbers.",
+      "Review key metrics against the previous period and name what drove the change.",
+      "Report a project's health by workstream, with the main risks and one request.",
+      "Prepare a decision meeting by stating the evidence and the next steps in under a minute."
+    ],
+    "audience": ["executives", "managers", "finance", "stakeholders"],
+    "goodFor": "Periodic results or status for people who decide, with 2-4 numbers or 2-6 workstreams.",
+    "notFor": "Telling the story of one finding (datastory), persuading buyers (pitch).",
+    "tags": ["report", "kpi", "status", "finance", "data", "review", "update", "internal"],
+    "tone": ["formal", "direct"],
+    "aspects": ["16:9"]
+  },
+  "requires": {
+    "storyboard": 1,
+    "scenes": ["title", "kpi-grid", "bullets", "icon-grid", "callout", "outro"]
+  },
+  "themes": [
+    { "id": "data-light", "file": "@shared/data-light.json", "mode": "light", "pair": "data-dark" },
+    { "id": "data-dark", "file": "@shared/data-dark.json", "mode": "dark", "pair": "data-light" },
+    { "id": "calm-light", "file": "@shared/calm-light.json", "mode": "light", "pair": "calm-dark" },
+    { "id": "calm-dark", "file": "@shared/calm-dark.json", "mode": "dark", "pair": "calm-light" },
+    {
+      "id": "editorial-light",
+      "file": "@shared/editorial-light.json",
+      "mode": "light",
+      "pair": "editorial-dark"
+    },
+    {
+      "id": "editorial-dark",
+      "file": "@shared/editorial-dark.json",
+      "mode": "dark",
+      "pair": "editorial-light"
+    }
+  ],
+  "styles": [
+    { "id": "exec", "file": "styles/exec.json" },
+    { "id": "walkthrough", "file": "styles/walkthrough.json" },
+    { "id": "memo", "file": "styles/memo.json" }
+  ],
+  "blueprints": [
+    { "id": "kpi-review", "file": "blueprints/kpi-review.json" },
+    { "id": "status", "file": "blueprints/status.json" }
+  ],
+  "pacing": "pacing.json",
+  "copy": "copy.md",
+  "license": "Apache-2.0"
+}

package/templates/social/blueprints/announce.json

@@ -0,0 +1,109 @@
+{
+  "id": "announce",
+  "purpose": "A vertical announcement clip: a big headline card, an optional big number, and a call to action.",
+  "discover": {
+    "useCases": [
+      "Announce news or a launch with one big number and a call to action.",
+      "Tease something new in a short vertical clip that ends with where to go next.",
+      "Share a milestone with one number and a thank-you."
+    ],
+    "audience": ["followers", "customers", "community"],
+    "goodFor": "One headline, at most one number and one action, 8-20 s, vertical.",
+    "notFor": "Several points (tip, listicle), detailed updates (update), data stories (datastory).",
+    "tags": ["social", "vertical", "announce", "launch", "promo", "marketing"],
+    "tone": ["punchy", "excited"],
+    "aspects": ["9:16", "1:1"],
+    "lengths": {
+      "min": 8,
+      "max": 20
+    }
+  },
+  "slots": {
+    "headline": {
+      "type": "text",
+      "max": 50,
+      "required": true
+    },
+    "stat": {
+      "type": "object",
+      "fields": {
+        "value": "number",
+        "label": "text"
+      },
+      "optional": true
+    },
+    "cta": {
+      "type": "text",
+      "max": 36,
+      "required": true
+    },
+    "handle": {
+      "type": "text",
+      "max": 24,
+      "optional": true
+    },
+    "platform": {
+      "type": "enum",
+      "values": ["tiktok", "reels", "shorts"],
+      "default": "tiktok"
+    },
+    "length": {
+      "type": "enum",
+      "values": ["short", "standard", "long"],
+      "default": "standard"
+    },
+    "style": {
+      "type": "enum",
+      "values": ["hook-first", "captioned", "techcut"],
+      "default": "hook-first"
+    }
+  },
+  "example": {
+    "headline": "Briar Notes 2.0 is [here]",
+    "stat": {
+      "value": 500,
+      "label": "people on the waitlist"
+    },
+    "cta": "Link in bio",
+    "handle": "@briar.labs"
+  },
+  "meta": {
+    "title": {
+      "$slot": "cta"
+    },
+    "lang": "en"
+  },
+  "scenes": [
+    {
+      "id": "headline",
+      "type": "callout",
+      "props": {
+        "kind": "statement",
+        "text": {
+          "$slot": "headline"
+        }
+      }
+    },
+    {
+      "when": "stat",
+      "id": "number",
+      "type": "stat",
+      "props": {
+        "$spread": "stat"
+      }
+    },
+    {
+      "id": "end",
+      "type": "title",
+      "props": {
+        "kicker": {
+          "$slot": "handle"
+        },
+        "title": {
+          "$slot": "cta"
+        },
+        "subtitle": "Follow along"
+      }
+    }
+  ]
+}