@amg555/frameforge-mcp 2.7.3 → 2.7.7

package/plugins/aiinsight-shorts/styles/paper-atlas/STYLE.md

@@ -0,0 +1,30 @@
+# Paper Atlas: history told in cut paper, 9:16
+
+Storybook, curious, grand. Every shape is cut paper on aged parchment (a light paper edge and a soft drop shadow),
+maps with crimson routes, gold date ribbons, wax seals, simple period figures, captions on torn paper strips.
+Example: `example/` = **HOW ONE BAKERY BURNED DOWN LONDON** (1666; 41 s, 10 shots). Sheet: `style-sheet.png`.
+
+## 1. Rules
+- Everything is cut paper: draw shapes with `K.cut(pathFn, colour)` so they get the edge + shadow.
+- **Crimson** only for routes, targets, fire and the key word; **gold** only for dates, crowns and seals.
+- Maps first: where, then who, then what. A gold ribbon (`K.ribbon('1666', x, y, s)`) opens every new era.
+- Night = the same parchment under a navy wash (`nightPage` in the example); day = parchment + pale sky.
+- No battles or violence shown: tell it with objects, places and consequences (fire, smoke, rebuilt houses).
+- Captions: Caladea serif on a torn paper strip, 2-4 words, one crimson word, y 1640 (auto-fit).
+- Narration: `bm_george` (UK documentary). Music `"tension"` for disasters, `"bed"` for lighter history.
+- Facts and numbers checked against museums, encyclopaedias or primary records, listed in `script.json` "sources".
+  Don't put invented quotes on signs: paraphrase what happened instead.
+
+## 2. Kit (`example/src/core/kit.js`, `import * as K`)
+- Paper: `cut(path, fill, { shadow, edge })`, path helpers `P_rr, P_circ, P_poly`, `parchment(seed)`.
+- Maps: `map({ highlight, route, labels })` (invented coastlines), `landPts(cx, cy, rx, ry, seed)`, `dashedRoute(pts, p)`,
+  `compass`, `label(text, x, y, size)`. For a real place, draw a simplified outline in `shots.js` (see `londonMap`).
+- People: `figure({ x, y, h, dir, role: 'king'│'queen'│'sailor'│'scholar'│'guard'│'merchant'│'worker', walk, arm })`.
+- Places: `hall()`, `harbor(t, shipX)`, `ship(x, y, s, rot)`.
+- Graphics: `ribbon`, `seal(x, y, s, letter)`, `timeline(labels, x, y, w, p, active)`, `slip(text, x, y, s, rot, size)`,
+  `captionStrip`.
+- The example adds `house`, `flame`, `smoke`, `wind`, `stPauls`, `oven` in `shots.js`.
+
+## 3. QA pitfalls we've hit
+- Timeline or labels colliding with the caption strip → keep them above y 1450.
+- Map labels unreadable under coloured marks → put them on a `slip`.

package/plugins/aiinsight-shorts/styles/paper-atlas/example/data/cues.json

@@ -0,0 +1,167 @@
+{
+ "duration": 40.924,
+ "cues": [
+  {
+   "t": 0.1,
+   "type": "whoosh"
+  },
+  {
+   "t": 0.15,
+   "type": "pop",
+   "gain": 0.6
+  },
+  {
+   "t": 5.68,
+   "type": "whoosh"
+  },
+  {
+   "t": 5.78,
+   "type": "pop",
+   "gain": 0.5
+  },
+  {
+   "t": 9.939,
+   "type": "pop"
+  },
+  {
+   "t": 11.011,
+   "type": "whoosh"
+  },
+  {
+   "t": 13.993,
+   "type": "slide",
+   "dur": 1.6,
+   "gain": 0.7
+  },
+  {
+   "t": 15.591,
+   "type": "whoosh"
+  },
+  {
+   "t": 15.591,
+   "type": "pop",
+   "gain": 0.45
+  },
+  {
+   "t": 15.591,
+   "type": "sizzle",
+   "dur": 2
+  },
+  {
+   "t": 15.921,
+   "type": "pop",
+   "gain": 0.45
+  },
+  {
+   "t": 16.251,
+   "type": "pop",
+   "gain": 0.45
+  },
+  {
+   "t": 16.581,
+   "type": "pop",
+   "gain": 0.45
+  },
+  {
+   "t": 16.911,
+   "type": "pop",
+   "gain": 0.45
+  },
+  {
+   "t": 17.241,
+   "type": "pop",
+   "gain": 0.45
+  },
+  {
+   "t": 18.167,
+   "type": "whoosh"
+  },
+  {
+   "t": 18.267,
+   "type": "pop",
+   "gain": 0.5
+  },
+  {
+   "t": 20.318,
+   "type": "boing",
+   "gain": 0.5
+  },
+  {
+   "t": 21.395,
+   "type": "whoosh"
+  },
+  {
+   "t": 21.395,
+   "type": "sizzle",
+   "dur": 2.4,
+   "gain": 0.7
+  },
+  {
+   "t": 23.856,
+   "type": "whoosh"
+  },
+  {
+   "t": 23.936,
+   "type": "pop"
+  },
+  {
+   "t": 25.646,
+   "type": "pop"
+  },
+  {
+   "t": 27.596,
+   "type": "thud"
+  },
+  {
+   "t": 29.526,
+   "type": "whoosh"
+  },
+  {
+   "t": 30.589,
+   "type": "slam"
+  },
+  {
+   "t": 30.839,
+   "type": "thud",
+   "gain": 0.6
+  },
+  {
+   "t": 33.017,
+   "type": "whoosh"
+  },
+  {
+   "t": 33.267,
+   "type": "thud",
+   "gain": 0.35
+  },
+  {
+   "t": 33.417,
+   "type": "thud",
+   "gain": 0.35
+  },
+  {
+   "t": 33.567,
+   "type": "thud",
+   "gain": 0.35
+  },
+  {
+   "t": 33.717,
+   "type": "thud",
+   "gain": 0.35
+  },
+  {
+   "t": 33.867,
+   "type": "thud",
+   "gain": 0.35
+  },
+  {
+   "t": 35.855,
+   "type": "sparkle",
+   "dur": 1
+  },
+  {
+   "t": 37.017,
+   "type": "whoosh"
+  }
+ ]
+}

package/plugins/aiinsight-shorts/styles/paper-atlas/example/data/lines.json

@@ -0,0 +1,67 @@
+{
+ "duration": 40.924,
+ "voice": "bm_george",
+ "speed": 1.0,
+ "lines": [
+  {
+   "i": 0,
+   "text": "In sixteen sixty-six, a tiny bakery fire burned down most of London.",
+   "start": 0.4,
+   "end": 5.46
+  },
+  {
+   "i": 1,
+   "text": "It started just after midnight, in Thomas Farriner's bakery on Pudding Lane.",
+   "start": 5.76,
+   "end": 10.791
+  },
+  {
+   "i": 2,
+   "text": "London was packed with wooden houses, and a strong wind was blowing,",
+   "start": 11.091,
+   "end": 15.321
+  },
+  {
+   "i": 3,
+   "text": "so the flames jumped from roof to roof.",
+   "start": 15.671,
+   "end": 17.947
+  },
+  {
+   "i": 4,
+   "text": "The Lord Mayor was woken up, but he shrugged it off.",
+   "start": 18.247,
+   "end": 21.175
+  },
+  {
+   "i": 5,
+   "text": "For four days, the city burned.",
+   "start": 21.475,
+   "end": 23.636
+  },
+  {
+   "i": 6,
+   "text": "Thirteen thousand houses, eighty-seven churches, and St Paul's Cathedral were gone.",
+   "start": 23.936,
+   "end": 29.306
+  },
+  {
+   "i": 7,
+   "text": "In the end, they blew up whole streets to stop it spreading.",
+   "start": 29.606,
+   "end": 32.797
+  },
+  {
+   "i": 8,
+   "text": "And when London was rebuilt, it was built in brick and stone.",
+   "start": 33.097,
+   "end": 36.797
+  },
+  {
+   "i": 9,
+   "text": "All because of one small bakery.",
+   "start": 37.097,
+   "end": 39.624
+  }
+ ]
+}