@anvpx/motion 0.0.0-stage → 0.1.1

package/stopwords.json

@@ -0,0 +1,65 @@
+[
+  "a",
+  "an",
+  "and",
+  "are",
+  "as",
+  "at",
+  "be",
+  "but",
+  "by",
+  "for",
+  "from",
+  "has",
+  "have",
+  "how",
+  "i",
+  "in",
+  "into",
+  "is",
+  "it",
+  "its",
+  "of",
+  "on",
+  "or",
+  "our",
+  "so",
+  "that",
+  "the",
+  "their",
+  "them",
+  "then",
+  "there",
+  "these",
+  "they",
+  "this",
+  "to",
+  "up",
+  "us",
+  "use",
+  "using",
+  "was",
+  "we",
+  "what",
+  "when",
+  "where",
+  "which",
+  "who",
+  "why",
+  "will",
+  "with",
+  "you",
+  "your",
+  "about",
+  "can",
+  "do",
+  "does",
+  "make",
+  "need",
+  "needs",
+  "want",
+  "video",
+  "videos",
+  "short",
+  "quick"
+]

package/templates/compare/blueprints/versus.json

@@ -0,0 +1,79 @@
+{
+  "id": "versus",
+  "purpose": "Compare two options in 20-50s: title, side-by-side points, optional headline numbers, verdict, close.",
+  "discover": {
+    "useCases": [
+      "Put two options side by side and name a winner.",
+      "Weigh two alternatives for a decision and state the verdict in one line.",
+      "Back a recommendation with two to four headline numbers."
+    ],
+    "audience": ["buyers", "teams", "readers"],
+    "goodFor": "Two options, one to five points each, a verdict and optionally a few key numbers.",
+    "notFor": "Persuasion or launches (pitch), three or more options (pitch/pricing).",
+    "tags": ["compare", "versus", "review", "kpi", "before-after"],
+    "tone": ["calm", "balanced"],
+    "aspects": ["16:9", "1:1"],
+    "lengths": { "min": 20, "max": 50 }
+  },
+  "slots": {
+    "title": { "type": "text", "max": 60, "required": true },
+    "leftLabel": { "type": "text", "max": 24, "required": true },
+    "leftPoints": { "type": "text[]", "min": 1, "max": 5, "itemMax": 40, "required": true },
+    "rightLabel": { "type": "text", "max": 24, "required": true },
+    "rightPoints": { "type": "text[]", "min": 1, "max": 5, "itemMax": 40, "required": true },
+    "winner": { "type": "enum", "values": ["left", "right"] },
+    "numbers": {
+      "type": "object",
+      "fields": { "value": "text", "label": "text" },
+      "list": true,
+      "min": 2,
+      "max": 4,
+      "optional": true
+    },
+    "verdict": { "type": "text", "max": 80, "required": true },
+    "length": { "type": "enum", "values": ["short", "standard", "long"], "default": "standard" },
+    "style": { "type": "enum", "values": ["tidy", "editorial", "punchy"], "default": "tidy" }
+  },
+  "example": {
+    "title": "Option A or Option B",
+    "leftLabel": "Option A",
+    "leftPoints": ["Lower cost", "Easy start", "Few options"],
+    "rightLabel": "Option B",
+    "rightPoints": ["Higher cost", "Takes longer", "More flexible"],
+    "winner": "left",
+    "numbers": [
+      { "value": "20%", "label": "Lower cost" },
+      { "value": "2 days", "label": "Faster start" }
+    ],
+    "verdict": "Pick A unless you need the flexibility"
+  },
+  "meta": { "title": { "$slot": "title" }, "lang": "en" },
+  "scenes": [
+    {
+      "id": "intro",
+      "type": "title",
+      "props": { "kicker": "Versus", "title": { "$slot": "title" } }
+    },
+    {
+      "id": "sides",
+      "type": "compare",
+      "props": {
+        "left": { "label": { "$slot": "leftLabel" }, "points": { "$slot": "leftPoints" } },
+        "right": { "label": { "$slot": "rightLabel" }, "points": { "$slot": "rightPoints" } },
+        "winner": { "$slot": "winner" }
+      }
+    },
+    {
+      "when": "numbers",
+      "id": "numbers",
+      "type": "kpi-grid",
+      "props": { "title": "By the numbers", "items": { "$slot": "numbers" } }
+    },
+    {
+      "id": "verdict",
+      "type": "callout",
+      "props": { "kind": "statement", "label": "Verdict", "text": { "$slot": "verdict" } }
+    },
+    { "id": "end", "type": "outro", "props": { "title": { "$slot": "title" } } }
+  ]
+}

package/templates/compare/copy.md

@@ -0,0 +1,18 @@
+# Compare copy guide
+
+Tone: fair, specific, decisive. Show both sides, then commit to a verdict.
+
+Do
+- Title: the choice as a question or "A or B", at most 8 words.
+- Option labels: nouns of 1-3 words.
+- Points: parallel phrases of 2-5 words, same order on both sides.
+- Numbers: 2-4 headline figures with a unit; only what you can source.
+- Verdict: one sentence naming the winner and the reason.
+
+Don't
+- No more than 5 points per side, 25 words per scene.
+- No loaded adjectives (terrible, amazing); compare facts.
+- No invented figures; leave the numbers out instead.
+- Skip the winner when the honest answer is "it depends"; say what it depends on.
+
+Vocabulary: "option" not "solution", "cost" not "price tag", "pick" not "go with".

package/templates/compare/pacing.json

@@ -0,0 +1,15 @@
+{
+  "wordsPerSecond": 2.5,
+  "sceneSeconds": {
+    "title": { "short": 3, "standard": 4, "long": 5 },
+    "compare": { "short": 7, "standard": 10, "long": 14 },
+    "kpi-grid": { "short": 4, "standard": 5, "long": 6 },
+    "callout": { "short": 4, "standard": 5, "long": 7 },
+    "outro": { "short": 3, "standard": 4, "long": 5 }
+  },
+  "lengths": {
+    "short": { "scenes": [3, 5], "totalSec": [15, 35] },
+    "standard": { "scenes": [4, 5], "totalSec": [20, 50] },
+    "long": { "scenes": [4, 5], "totalSec": [30, 60] }
+  }
+}

package/templates/compare/styles/editorial.json

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

package/templates/compare/styles/punchy.json

@@ -0,0 +1,6 @@
+{
+  "id": "punchy",
+  "theme": "tech-dark",
+  "frame": { "width": 1080, "height": 1080, "fps": 30 },
+  "direction": { "shot": "close", "move": "static", "ease": "spring-snappy", "transition": "cut" }
+}

package/templates/compare/styles/tidy.json

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

package/templates/compare/template.json

@@ -0,0 +1,52 @@
+{
+  "templateVersion": 1,
+  "id": "compare",
+  "version": "1.0.0",
+  "title": "Compare",
+  "summary": "Two options side by side with a clear verdict. Calm, editorial or punchy.",
+  "domains": ["decision", "product", "analysis"],
+  "discover": {
+    "useCases": [
+      "Put two options side by side and name a winner.",
+      "Weigh alternatives for a buying or planning decision with a clear verdict.",
+      "Back a recommendation with two to four headline numbers."
+    ],
+    "audience": ["buyers", "teams", "readers", "stakeholders"],
+    "goodFor": "Two options with one to five points each and a one-line verdict.",
+    "notFor": "Persuading an audience (pitch), long data analysis (datastory).",
+    "tags": ["compare", "versus", "review", "before-after", "kpi", "sales"],
+    "tone": ["calm", "balanced"],
+    "aspects": ["16:9", "1:1"]
+  },
+  "requires": {
+    "storyboard": 1,
+    "scenes": ["title", "compare", "kpi-grid", "callout", "outro"]
+  },
+  "themes": [
+    { "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"
+    },
+    { "id": "tech-light", "file": "@shared/tech-light.json", "mode": "light", "pair": "tech-dark" },
+    { "id": "tech-dark", "file": "@shared/tech-dark.json", "mode": "dark", "pair": "tech-light" }
+  ],
+  "styles": [
+    { "id": "tidy", "file": "styles/tidy.json" },
+    { "id": "editorial", "file": "styles/editorial.json" },
+    { "id": "punchy", "file": "styles/punchy.json" }
+  ],
+  "blueprints": [{ "id": "versus", "file": "blueprints/versus.json" }],
+  "pacing": "pacing.json",
+  "copy": "copy.md",
+  "license": "Apache-2.0"
+}

package/templates/datastory/blueprints/data-story.json

@@ -0,0 +1,95 @@
+{
+  "id": "data-story",
+  "purpose": "Tell one finding: a hook number, a bar or donut chart of 2-6 values, a takeaway sentence and the implication.",
+  "discover": {
+    "useCases": [
+      "Tell one insight with a hook number, a chart and a single takeaway sentence.",
+      "Show a share or composition of a whole and say what it implies.",
+      "Compare a few items by value and highlight the one that matters."
+    ],
+    "audience": ["general-public", "readers", "stakeholders"],
+    "goodFor": "One finding with a hook number and a chart of 2-6 values.",
+    "notFor": "Change over time (trend), several statistics at once (infographic).",
+    "tags": ["data", "chart", "ranking", "news", "recap", "social"],
+    "tone": ["clear", "confident"],
+    "aspects": ["16:9", "9:16"],
+    "lengths": { "min": 20, "max": 55 }
+  },
+  "slots": {
+    "headline": { "type": "text", "max": 60, "required": true },
+    "hook": {
+      "type": "object",
+      "fields": { "value": "text", "unit": "text", "label": "text", "context": "text" },
+      "required": true
+    },
+    "kind": { "type": "enum", "values": ["bar", "donut"], "default": "bar" },
+    "chartTitle": { "type": "text", "max": 50, "required": true },
+    "unit": { "type": "text", "max": 12, "default": "%" },
+    "data": {
+      "type": "object",
+      "fields": { "label": "text", "value": "number" },
+      "list": true,
+      "min": 2,
+      "max": 6,
+      "required": true
+    },
+    "highlight": { "type": "number", "min": 0, "max": 5, "int": true, "default": 0 },
+    "takeaway": { "type": "text", "max": 110, "required": true },
+    "implication": { "type": "text", "max": 60, "required": true },
+    "source": { "type": "text", "max": 70, "required": true },
+    "length": { "type": "enum", "values": ["short", "standard", "long"], "default": "standard" },
+    "style": { "type": "enum", "values": ["clear", "editorial", "pop"], "default": "clear" }
+  },
+  "example": {
+    "headline": "Where the time goes",
+    "hook": {
+      "value": "62",
+      "unit": "%",
+      "label": "of the workday",
+      "context": "is spent outside focused work"
+    },
+    "kind": "donut",
+    "chartTitle": "Share of the day by activity",
+    "unit": "%",
+    "data": [
+      { "label": "Meetings", "value": 30 },
+      { "label": "Messages", "value": 20 },
+      { "label": "Focus work", "value": 38 },
+      { "label": "Admin", "value": 12 }
+    ],
+    "highlight": 2,
+    "takeaway": "Only [38%] of the day goes to focused work",
+    "implication": "Protect two focus blocks a day",
+    "source": "Illustrative sample data"
+  },
+  "meta": { "title": { "$slot": "headline" }, "lang": "en" },
+  "scenes": [
+    {
+      "id": "intro",
+      "type": "title",
+      "props": { "kicker": "Data story", "title": { "$slot": "headline" } }
+    },
+    { "id": "hook", "type": "stat", "props": { "$spread": "hook" } },
+    {
+      "id": "chart",
+      "type": "chart",
+      "props": {
+        "kind": { "$slot": "kind" },
+        "title": { "$slot": "chartTitle" },
+        "unit": { "$slot": "unit" },
+        "data": { "$slot": "data" },
+        "highlight": { "$slot": "highlight" }
+      }
+    },
+    {
+      "id": "takeaway",
+      "type": "callout",
+      "props": { "text": { "$slot": "takeaway" }, "kind": "statement", "label": "Takeaway" }
+    },
+    {
+      "id": "end",
+      "type": "outro",
+      "props": { "title": { "$slot": "implication" }, "lines": [{ "$slot": "source" }] }
+    }
+  ]
+}

package/templates/datastory/blueprints/infographic.json

@@ -0,0 +1,106 @@
+{
+  "id": "infographic",
+  "purpose": "A shareable infographic: 2-3 big numbers, an optional share-of-whole donut, 2-4 icon facts and a source.",
+  "discover": {
+    "useCases": [
+      "Turn a handful of statistics into a shareable infographic with a share-of-whole chart.",
+      "Present two or three big numbers and the facts that explain them.",
+      "Summarise a survey or study for readers who skim."
+    ],
+    "audience": ["general-public", "readers", "customers"],
+    "goodFor": "2-3 big numbers, an optional breakdown of 2-6 parts and 2-4 facts.",
+    "notFor": "A single finding told with one visual (data-story), periodic results (report).",
+    "tags": ["infographic", "data", "chart", "survey", "social", "kpi"],
+    "tone": ["clear", "confident"],
+    "aspects": ["16:9", "9:16"],
+    "lengths": { "min": 25, "max": 70 }
+  },
+  "slots": {
+    "headline": { "type": "text", "max": 60, "required": true },
+    "big": {
+      "type": "object",
+      "fields": { "value": "text", "unit": "text", "label": "text" },
+      "list": true,
+      "min": 2,
+      "max": 3,
+      "required": true
+    },
+    "partsTitle": { "type": "text", "max": 50, "default": "How it breaks down" },
+    "parts": {
+      "type": "object",
+      "fields": { "label": "text", "value": "number" },
+      "list": true,
+      "min": 2,
+      "max": 6,
+      "optional": true
+    },
+    "facts": {
+      "type": "object",
+      "fields": { "icon": "text", "label": "text", "detail": "text" },
+      "list": true,
+      "min": 2,
+      "max": 4,
+      "required": true
+    },
+    "highlight": { "type": "number", "min": 0, "max": 5, "int": true, "default": 0 },
+    "source": { "type": "text", "max": 70, "required": true },
+    "length": { "type": "enum", "values": ["short", "standard", "long"], "default": "standard" },
+    "style": { "type": "enum", "values": ["clear", "editorial", "pop"], "default": "clear" }
+  },
+  "example": {
+    "headline": "A year of remote work",
+    "big": [
+      { "value": "72", "unit": "%", "label": "Prefer hybrid" },
+      { "value": "5", "unit": "days", "label": "Saved a month" },
+      { "value": "3", "unit": "x", "label": "More async chat" }
+    ],
+    "partsTitle": "Preferred work setup",
+    "parts": [
+      { "label": "Hybrid", "value": 72 },
+      { "label": "Remote", "value": 18 },
+      { "label": "Office", "value": 10 }
+    ],
+    "highlight": 0,
+    "facts": [
+      { "icon": "clock", "label": "Commute", "detail": "Time saved" },
+      { "icon": "users", "label": "Meetings", "detail": "Fewer" },
+      { "icon": "house", "label": "Focus", "detail": "Quiet home" }
+    ],
+    "source": "Illustrative sample data"
+  },
+  "meta": { "title": { "$slot": "headline" }, "lang": "en" },
+  "scenes": [
+    {
+      "id": "intro",
+      "type": "title",
+      "props": { "kicker": "In numbers", "title": { "$slot": "headline" } }
+    },
+    {
+      "id": "numbers",
+      "type": "kpi-grid",
+      "props": { "title": "The big numbers", "items": { "$slot": "big" } }
+    },
+    {
+      "when": "parts",
+      "id": "mix",
+      "type": "chart",
+      "props": {
+        "kind": "donut",
+        "title": { "$slot": "partsTitle" },
+        "unit": "%",
+        "data": { "$slot": "parts" },
+        "highlight": { "$slot": "highlight" }
+      }
+    },
+    {
+      "id": "facts",
+      "type": "icon-grid",
+      "props": { "title": "Behind the numbers", "items": { "$slot": "facts" } }
+    },
+    {
+      "id": "end",
+      "type": "outro",
+      "props": { "title": "Source", "lines": [{ "$slot": "source" }] }
+    }
+  ]
+}

package/templates/datastory/blueprints/trend.json

@@ -0,0 +1,93 @@
+{
+  "id": "trend",
+  "purpose": "Show change over time: a hook number, a column chart of 3-8 periods, a takeaway sentence and the implication.",
+  "discover": {
+    "useCases": [
+      "Show how a measure changed over time and what the change implies.",
+      "Explain a rise or fall with one column chart and a single sentence of meaning.",
+      "Recap a period's trajectory for readers who only have half a minute."
+    ],
+    "audience": ["general-public", "readers", "stakeholders"],
+    "goodFor": "One measure over 3-8 periods with a clear direction.",
+    "notFor": "Share of a whole or a ranking (data-story), many statistics (infographic).",
+    "tags": ["data", "chart", "news", "recap", "timeline", "kpi"],
+    "tone": ["clear", "confident"],
+    "aspects": ["16:9", "9:16"],
+    "lengths": { "min": 20, "max": 55 }
+  },
+  "slots": {
+    "headline": { "type": "text", "max": 60, "required": true },
+    "hook": {
+      "type": "object",
+      "fields": { "value": "text", "unit": "text", "label": "text", "context": "text" },
+      "required": true
+    },
+    "chartTitle": { "type": "text", "max": 50, "required": true },
+    "unit": { "type": "text", "max": 12, "default": "" },
+    "data": {
+      "type": "object",
+      "fields": { "label": "text", "value": "number" },
+      "list": true,
+      "min": 3,
+      "max": 8,
+      "required": true
+    },
+    "takeaway": { "type": "text", "max": 110, "required": true },
+    "implication": { "type": "text", "max": 60, "required": true },
+    "source": { "type": "text", "max": 70, "required": true },
+    "length": { "type": "enum", "values": ["short", "standard", "long"], "default": "standard" },
+    "style": { "type": "enum", "values": ["clear", "editorial", "pop"], "default": "clear" }
+  },
+  "example": {
+    "headline": "Reading time is shrinking",
+    "hook": {
+      "value": "9",
+      "unit": "min",
+      "label": "a day",
+      "context": "average reading time, down from 15"
+    },
+    "chartTitle": "Average minutes read per day",
+    "unit": "min",
+    "data": [
+      { "label": "2019", "value": 15 },
+      { "label": "2020", "value": 14 },
+      { "label": "2021", "value": 12 },
+      { "label": "2022", "value": 11 },
+      { "label": "2023", "value": 9 }
+    ],
+    "takeaway": "Daily reading time [fell by 40%] in five years",
+    "implication": "Shorter formats now win attention",
+    "source": "Illustrative sample data"
+  },
+  "meta": { "title": { "$slot": "headline" }, "lang": "en" },
+  "scenes": [
+    {
+      "id": "intro",
+      "type": "title",
+      "props": { "kicker": "Trend", "title": { "$slot": "headline" } }
+    },
+    { "id": "hook", "type": "stat", "props": { "$spread": "hook" } },
+    {
+      "id": "chart",
+      "type": "chart",
+      "props": {
+        "kind": "bar",
+        "orient": "v",
+        "sort": "none",
+        "title": { "$slot": "chartTitle" },
+        "unit": { "$slot": "unit" },
+        "data": { "$slot": "data" }
+      }
+    },
+    {
+      "id": "takeaway",
+      "type": "callout",
+      "props": { "text": { "$slot": "takeaway" }, "kind": "statement", "label": "Takeaway" }
+    },
+    {
+      "id": "end",
+      "type": "outro",
+      "props": { "title": { "$slot": "implication" }, "lines": [{ "$slot": "source" }] }
+    }
+  ]
+}

package/templates/datastory/copy.md

@@ -0,0 +1,16 @@
+# Data story copy guide
+
+Tone: clear, confident, plain. One finding per video. The number is the hook; the chart is the proof; the takeaway is the point.
+
+Do
+- Hook: one number with its unit and a 2-5 word label ("62%", "of orders arrive late").
+- Takeaway: one sentence, the finding in words, with the key term in [brackets] to be accented.
+- Chart: 2-6 values, labels 1-2 words, unit stated once; highlight the item the story is about.
+- Close with the implication ("what this means"), then the source line exactly as cited.
+
+Don't
+- No chart without a takeaway sentence; no takeaway that repeats the chart title.
+- No more than 3 big numbers or 4 facts; split into a second story instead.
+- No invented figures; mark illustrative data as illustrative.
+
+Vocabulary: "share" not "proportion", "rose/fell" not "experienced a change".

package/templates/datastory/pacing.json

@@ -0,0 +1,17 @@
+{
+  "wordsPerSecond": 2.5,
+  "sceneSeconds": {
+    "title": { "short": 3, "standard": 4, "long": 5 },
+    "stat": { "short": 4, "standard": 5, "long": 6 },
+    "chart": { "short": 5, "standard": 6, "long": 8 },
+    "callout": { "short": 4, "standard": 6, "long": 8 },
+    "kpi-grid": { "short": 5, "standard": 6, "long": 7 },
+    "icon-grid": { "short": 6, "standard": 8, "long": 10 },
+    "outro": { "short": 3, "standard": 4, "long": 5 }
+  },
+  "lengths": {
+    "short": { "scenes": [4, 5], "totalSec": [12, 35] },
+    "standard": { "scenes": [4, 6], "totalSec": [20, 50] },
+    "long": { "scenes": [5, 6], "totalSec": [35, 70] }
+  }
+}

package/templates/datastory/styles/clear.json

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

package/templates/datastory/styles/editorial.json

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

package/templates/datastory/styles/pop.json

@@ -0,0 +1,7 @@
+{
+  "id": "pop",
+  "theme": "pop-dark",
+  "frame": { "width": 1080, "height": 1920, "fps": 30 },
+  "direction": { "shot": "close", "move": "push-in", "ease": "out", "transition": "cut" },
+  "props": { "kpi-grid": { "cols": 2 }, "icon-grid": { "cols": 2 } }
+}