@litfamily/litgravity 0.1.1 → 0.1.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (246) hide show
  1. package/CHANGELOG.md +27 -0
  2. package/README.md +17 -3
  3. package/README_ko-KR.md +17 -3
  4. package/package.json +1 -1
  5. package/plugin/hooks/lib/lanes.mjs +65 -0
  6. package/plugin/hooks/lib/motion.mjs +34 -5
  7. package/plugin/hooks/lib/reentry.mjs +7 -0
  8. package/plugin/hooks/lib/rewind/brief.mjs +332 -0
  9. package/plugin/hooks/lib/rewind/collect.mjs +328 -0
  10. package/plugin/hooks/lib/rewind/gauge.mjs +55 -0
  11. package/plugin/hooks/lib/rewind/next-step.mjs +77 -0
  12. package/plugin/hooks/lib/rewind/redact.mjs +60 -0
  13. package/plugin/hooks/lib/rewind/transcripts.mjs +211 -0
  14. package/plugin/hooks/lib/routes.mjs +79 -5
  15. package/plugin/hooks/lib/workflow-stack.mjs +213 -0
  16. package/plugin/hooks/post-tool-use.mjs +37 -1
  17. package/plugin/hooks/pre-invocation.mjs +91 -2
  18. package/plugin/hooks/session-start.mjs +26 -3
  19. package/plugin/hooks/stop.mjs +22 -2
  20. package/plugin/hud/looks.mjs +29 -0
  21. package/plugin/hud/render.mjs +234 -12
  22. package/plugin/plugin.json +1 -1
  23. package/plugin/skills/frontend-ui-ux/SKILL.md +12 -1
  24. package/plugin/skills/frontend-ui-ux/kit/components.css +417 -0
  25. package/plugin/skills/frontend-ui-ux/kit/fonts.json +22 -0
  26. package/plugin/skills/frontend-ui-ux/kit/layouts/landing.html +164 -0
  27. package/plugin/skills/frontend-ui-ux/kit/layouts/settings.html +114 -0
  28. package/plugin/skills/frontend-ui-ux/kit/layouts/workspace.html +115 -0
  29. package/plugin/skills/frontend-ui-ux/kit/styles/computational-brutalism.json +227 -0
  30. package/plugin/skills/frontend-ui-ux/kit/styles/field-notes.json +205 -0
  31. package/plugin/skills/frontend-ui-ux/kit/styles/graphite.json +200 -0
  32. package/plugin/skills/frontend-ui-ux/kit/styles/meadow.json +199 -0
  33. package/plugin/skills/frontend-ui-ux/kit/styles/neo-brutalism.json +222 -0
  34. package/plugin/skills/frontend-ui-ux/kit/ui.js +226 -0
  35. package/plugin/skills/frontend-ui-ux/references/house-styles.md +234 -0
  36. package/plugin/skills/frontend-ui-ux/scripts/design-lock.mjs +400 -0
  37. package/plugin/skills/frontend-ui-ux/scripts/interface-probe-lock.mjs +196 -0
  38. package/plugin/skills/frontend-ui-ux/scripts/interface-probe-page.mjs +30 -9
  39. package/plugin/skills/frontend-ui-ux/scripts/interface-probe-rules.mjs +20 -8
  40. package/plugin/skills/frontend-ui-ux/scripts/interface-probe.mjs +42 -9
  41. package/plugin/skills/frontend-ui-ux/scripts/pixel-art.mjs +60 -0
  42. package/plugin/skills/lit-adhd/SKILL.md +157 -0
  43. package/plugin/skills/lit-adhd/references/card-examples.md +101 -0
  44. package/plugin/skills/lit-adhd/references/status-taxonomy.md +32 -0
  45. package/plugin/skills/lit-adhd/scripts/rewind.mjs +5 -0
  46. package/plugin/skills/lit-diagram-drawer/SKILL.md +5 -3
  47. package/plugin/skills/lit-diagram-drawer/references/drawing-rules.md +1 -1
  48. package/plugin/skills/lit-diagram-drawer/references/style-guide.md +21 -12
  49. package/plugin/skills/lit-diagram-drawer/references/type-architecture.md +3 -3
  50. package/plugin/skills/lit-diagram-drawer/references/type-dependency.md +1 -1
  51. package/plugin/skills/lit-diagram-drawer/references/type-tree.md +3 -3
  52. package/plugin/skills/lit-diagram-drawer/references/type-wardley.md +1 -1
  53. package/plugin/skills/lit-diagram-drawer/scripts/diagram-craft-rules.mjs +1 -2
  54. package/plugin/skills/lit-diagram-drawer/scripts/visual-quality.mjs +1 -2
  55. package/plugin/skills/lit-docx/SKILL.md +3 -3
  56. package/plugin/skills/lit-handoff/SKILL.md +1 -0
  57. package/plugin/skills/lit-hijack/SKILL.md +263 -0
  58. package/plugin/skills/lit-hijack/references/capture-and-provenance.md +100 -0
  59. package/plugin/skills/lit-hijack/references/clean-room-build.md +75 -0
  60. package/plugin/skills/lit-hijack/references/distil-and-licence.md +67 -0
  61. package/plugin/skills/lit-hijack/references/gap-and-port-design.md +100 -0
  62. package/plugin/skills/lit-hijack/references/parity-and-report.md +85 -0
  63. package/plugin/skills/lit-hijack/scripts/hijack.mjs +953 -0
  64. package/plugin/skills/lit-plan/SKILL.md +1 -1
  65. package/plugin/skills/lit-pptx/SKILL.md +8 -8
  66. package/plugin/skills/lit-pptx/fonts/jetbrains-mono/JetBrainsMono-Bold.ttf +0 -0
  67. package/plugin/skills/lit-pptx/fonts/jetbrains-mono/JetBrainsMono-Regular.ttf +0 -0
  68. package/plugin/skills/lit-pptx/fonts/jetbrains-mono/OFL.txt +93 -0
  69. package/plugin/skills/lit-pptx/fonts/provenance.json +32 -1
  70. package/plugin/skills/lit-pptx/references/agents/analyst.md +34 -56
  71. package/plugin/skills/lit-pptx/references/agents/antithesis.md +49 -67
  72. package/plugin/skills/lit-pptx/references/agents/architect.md +38 -51
  73. package/plugin/skills/lit-pptx/references/agents/critic.md +25 -41
  74. package/plugin/skills/lit-pptx/references/agents/synthesizer.md +37 -46
  75. package/plugin/skills/lit-pptx/references/agents/thesis.md +29 -49
  76. package/plugin/skills/lit-pptx/references/anti-slop-checklist.md +119 -145
  77. package/plugin/skills/lit-pptx/references/authoring-guide.md +187 -278
  78. package/plugin/skills/lit-pptx/references/consensus-protocol.md +99 -97
  79. package/plugin/skills/lit-pptx/references/data-display-cookbook.md +36 -137
  80. package/plugin/skills/lit-pptx/references/density-and-fill.md +147 -216
  81. package/plugin/skills/lit-pptx/references/design-system-azure.md +56 -85
  82. package/plugin/skills/lit-pptx/references/direction-step.md +134 -176
  83. package/plugin/skills/lit-pptx/references/examples/01-pitch-signal-ko.md +114 -115
  84. package/plugin/skills/lit-pptx/references/examples/02-pitch-studio-ko.md +66 -66
  85. package/plugin/skills/lit-pptx/references/examples/03-business-review-ledger-ko.md +63 -63
  86. package/plugin/skills/lit-pptx/references/examples/04-business-review-night-en.md +96 -96
  87. package/plugin/skills/lit-pptx/references/examples/05-research-talk-paper-en.md +81 -81
  88. package/plugin/skills/lit-pptx/references/examples/06-lecture-chalk-ko.md +103 -103
  89. package/plugin/skills/lit-pptx/references/examples/07-data-review-night-en.md +100 -98
  90. package/plugin/skills/lit-pptx/references/examples/08-image-led-atlas-ko.md +76 -76
  91. package/plugin/skills/lit-pptx/references/examples/09-briefing-gazette-ko.md +96 -96
  92. package/plugin/skills/lit-pptx/references/examples/10-status-update-ledger-ko.md +80 -80
  93. package/plugin/skills/lit-pptx/references/examples/11-portfolio-studio-en.md +72 -72
  94. package/plugin/skills/lit-pptx/references/examples/12-research-tutorial-chalk-en.md +95 -95
  95. package/plugin/skills/lit-pptx/references/examples/13-engineering-review-computational-brutalism-ko.md +173 -0
  96. package/plugin/skills/lit-pptx/references/examples/14-launch-pitch-neo-brutalism-ko.md +154 -0
  97. package/plugin/skills/lit-pptx/references/examples/15-design-lecture-bauhaus-ko.md +139 -0
  98. package/plugin/skills/lit-pptx/references/examples/16-community-programme-riso-ko.md +158 -0
  99. package/plugin/skills/lit-pptx/references/examples/17-public-data-briefing-newsroom-ko.md +179 -0
  100. package/plugin/skills/lit-pptx/references/interview-protocol.md +83 -102
  101. package/plugin/skills/lit-pptx/references/layout-families.md +161 -265
  102. package/plugin/skills/lit-pptx/references/stages/autopilot.md +30 -70
  103. package/plugin/skills/lit-pptx/references/stages/interview.md +36 -68
  104. package/plugin/skills/lit-pptx/references/stages/plan.md +26 -67
  105. package/plugin/skills/lit-pptx/references/title-treatments.md +93 -145
  106. package/plugin/skills/lit-pptx/references/tonalities/atlas.md +95 -108
  107. package/plugin/skills/lit-pptx/references/tonalities/bauhaus.md +140 -0
  108. package/plugin/skills/lit-pptx/references/tonalities/chalk.md +107 -122
  109. package/plugin/skills/lit-pptx/references/tonalities/computational-brutalism.md +150 -0
  110. package/plugin/skills/lit-pptx/references/tonalities/gazette.md +87 -111
  111. package/plugin/skills/lit-pptx/references/tonalities/ledger.md +96 -125
  112. package/plugin/skills/lit-pptx/references/tonalities/neo-brutalism.md +161 -0
  113. package/plugin/skills/lit-pptx/references/tonalities/newsroom.md +144 -0
  114. package/plugin/skills/lit-pptx/references/tonalities/night.md +104 -131
  115. package/plugin/skills/lit-pptx/references/tonalities/paper.md +114 -130
  116. package/plugin/skills/lit-pptx/references/tonalities/riso.md +137 -0
  117. package/plugin/skills/lit-pptx/references/tonalities/signal.md +96 -103
  118. package/plugin/skills/lit-pptx/references/tonalities/studio.md +81 -112
  119. package/plugin/skills/lit-pptx/scripts/compile-deck.js +4 -6
  120. package/plugin/skills/lit-pptx/scripts/craft_extras.py +135 -91
  121. package/plugin/skills/lit-pptx/scripts/deck_craft.py +1 -1
  122. package/plugin/skills/lit-pptx/scripts/embed_fonts.py +13 -1
  123. package/plugin/skills/lit-pptx/scripts/layout_inventory.py +1 -1
  124. package/plugin/skills/lit-pptx/scripts/learn_template.py +1 -1
  125. package/plugin/skills/lit-pptx/scripts/lib/grid-resolver.js +101 -110
  126. package/plugin/skills/lit-pptx/scripts/lib/layout-resolver.js +9 -15
  127. package/plugin/skills/lit-pptx/scripts/lib/render-pack.js +370 -563
  128. package/plugin/skills/lit-pptx/scripts/lib/slide-grid.js +104 -0
  129. package/plugin/skills/lit-pptx/scripts/lib/template-registry.js +57 -6
  130. package/plugin/skills/lit-pptx/scripts/qa_deck.py +6 -6
  131. package/plugin/skills/lit-pptx/scripts/render_pages.py +31 -0
  132. package/plugin/skills/lit-pptx/scripts/validate_pptx.py +1 -1
  133. package/plugin/skills/lit-pptx/specs/markdown-slide-spec-v1.md +167 -191
  134. package/plugin/skills/lit-pptx/specs/markdown-slide-spec-v2.md +117 -166
  135. package/plugin/skills/lit-pptx/specs/template-enrollment-contract.md +307 -330
  136. package/plugin/skills/lit-pptx/templates/tonalities/atlas/pack.yaml +1 -1
  137. package/plugin/skills/lit-pptx/templates/tonalities/bauhaus/pack.yaml +98 -0
  138. package/plugin/skills/lit-pptx/templates/tonalities/chalk/pack.yaml +1 -1
  139. package/plugin/skills/lit-pptx/templates/tonalities/computational-brutalism/pack.yaml +99 -0
  140. package/plugin/skills/lit-pptx/templates/tonalities/gazette/pack.yaml +1 -1
  141. package/plugin/skills/lit-pptx/templates/tonalities/ledger/pack.yaml +1 -1
  142. package/plugin/skills/lit-pptx/templates/tonalities/neo-brutalism/pack.yaml +107 -0
  143. package/plugin/skills/lit-pptx/templates/tonalities/newsroom/pack.yaml +99 -0
  144. package/plugin/skills/lit-pptx/templates/tonalities/night/pack.yaml +1 -1
  145. package/plugin/skills/lit-pptx/templates/tonalities/paper/pack.yaml +1 -1
  146. package/plugin/skills/lit-pptx/templates/tonalities/riso/pack.yaml +99 -0
  147. package/plugin/skills/lit-pptx/templates/tonalities/signal/pack.yaml +2 -2
  148. package/plugin/skills/lit-pptx/templates/tonalities/studio/pack.yaml +1 -1
  149. package/plugin/skills/lit-schematic/SKILL.md +114 -0
  150. package/plugin/skills/lit-schematic/examples/iso-heat-exchanger/build.mjs +38 -0
  151. package/plugin/skills/lit-schematic/examples/iso-heat-exchanger/scene.mjs +133 -0
  152. package/plugin/skills/lit-schematic/examples/journal-adsorption-rig/build.mjs +87 -0
  153. package/plugin/skills/lit-schematic/examples/pid-dosing-skid/build.mjs +85 -0
  154. package/plugin/skills/lit-schematic/references/cutaway-outputs.md +70 -0
  155. package/plugin/skills/lit-schematic/references/isometric-craft.md +101 -0
  156. package/plugin/skills/lit-schematic/references/journal-figures.md +72 -0
  157. package/plugin/skills/lit-schematic/references/kit-api.md +134 -0
  158. package/plugin/skills/lit-schematic/references/pfd-and-layout.md +53 -0
  159. package/plugin/skills/lit-schematic/references/pid-drafting.md +103 -0
  160. package/plugin/skills/lit-schematic/references/pid-symbols.md +163 -0
  161. package/plugin/skills/lit-schematic/references/verification.md +100 -0
  162. package/plugin/skills/lit-schematic/scripts/doctor.mjs +57 -0
  163. package/plugin/skills/lit-schematic/scripts/lib/figure.mjs +81 -0
  164. package/plugin/skills/lit-schematic/scripts/lib/fonts.mjs +27 -0
  165. package/plugin/skills/lit-schematic/scripts/lib/geom.mjs +113 -0
  166. package/plugin/skills/lit-schematic/scripts/lib/interactive.mjs +292 -0
  167. package/plugin/skills/lit-schematic/scripts/lib/isa.mjs +115 -0
  168. package/plugin/skills/lit-schematic/scripts/lib/iso.mjs +719 -0
  169. package/plugin/skills/lit-schematic/scripts/lib/legend-sheet.mjs +162 -0
  170. package/plugin/skills/lit-schematic/scripts/lib/pid.mjs +937 -0
  171. package/plugin/skills/lit-schematic/scripts/lib/png.mjs +132 -0
  172. package/plugin/skills/lit-schematic/scripts/lib/qa-core.mjs +658 -0
  173. package/plugin/skills/lit-schematic/scripts/lib/route.mjs +218 -0
  174. package/plugin/skills/lit-schematic/scripts/lib/sheet.mjs +890 -0
  175. package/plugin/skills/lit-schematic/scripts/lib/svg.mjs +82 -0
  176. package/plugin/skills/lit-schematic/scripts/lib/theme.mjs +115 -0
  177. package/plugin/skills/lit-schematic/scripts/motion.mjs +129 -0
  178. package/plugin/skills/lit-schematic/scripts/qa.mjs +92 -0
  179. package/plugin/skills/lit-schematic/scripts/render.mjs +233 -0
  180. package/plugin/skills/lit-schematic/scripts/scaffold.mjs +60 -0
  181. package/plugin/skills/lit-scientific-visualization/SKILL.md +17 -6
  182. package/plugin/skills/lit-typographic-motion/SKILL.md +58 -48
  183. package/plugin/skills/lit-typographic-motion/engine/THIRD_PARTY_NOTICES +13 -2
  184. package/plugin/skills/lit-typographic-motion/engine/blender/runner.py +218 -0
  185. package/plugin/skills/lit-typographic-motion/engine/core/presets.mjs +1 -1
  186. package/plugin/skills/lit-typographic-motion/engine/node/analysis.mjs +65 -1
  187. package/plugin/skills/lit-typographic-motion/engine/node/assets.mjs +298 -0
  188. package/plugin/skills/lit-typographic-motion/engine/node/blender.mjs +143 -0
  189. package/plugin/skills/lit-typographic-motion/engine/node/board.mjs +136 -0
  190. package/plugin/skills/lit-typographic-motion/engine/node/brief.mjs +7 -1
  191. package/plugin/skills/lit-typographic-motion/engine/node/chrome.mjs +9 -12
  192. package/plugin/skills/lit-typographic-motion/engine/node/cover-assets.mjs +5 -3
  193. package/plugin/skills/lit-typographic-motion/engine/node/cover-capture.mjs +7 -6
  194. package/plugin/skills/lit-typographic-motion/engine/node/cover-treatment.mjs +37 -4
  195. package/plugin/skills/lit-typographic-motion/engine/node/cover.mjs +19 -8
  196. package/plugin/skills/lit-typographic-motion/engine/node/done.mjs +45 -6
  197. package/plugin/skills/lit-typographic-motion/engine/node/frame-worker.mjs +7 -5
  198. package/plugin/skills/lit-typographic-motion/engine/node/gallery.mjs +121 -0
  199. package/plugin/skills/lit-typographic-motion/engine/node/host.mjs +34 -0
  200. package/plugin/skills/lit-typographic-motion/engine/node/house.mjs +44 -0
  201. package/plugin/skills/lit-typographic-motion/engine/node/look.mjs +34 -20
  202. package/plugin/skills/lit-typographic-motion/engine/node/pipeline.mjs +19 -9
  203. package/plugin/skills/lit-typographic-motion/engine/node/scaffold.mjs +210 -0
  204. package/plugin/skills/lit-typographic-motion/engine/node/score.mjs +639 -0
  205. package/plugin/skills/lit-typographic-motion/engine/node/sound-cli.mjs +21 -4
  206. package/plugin/skills/lit-typographic-motion/engine/node/sound.mjs +127 -29
  207. package/plugin/skills/lit-typographic-motion/engine/node/stage-capture.mjs +7 -6
  208. package/plugin/skills/lit-typographic-motion/engine/node/stage-gate.mjs +59 -5
  209. package/plugin/skills/lit-typographic-motion/engine/node/stage-qa.mjs +141 -9
  210. package/plugin/skills/lit-typographic-motion/engine/node/stage-serve.mjs +28 -5
  211. package/plugin/skills/lit-typographic-motion/engine/node/stage.mjs +82 -14
  212. package/plugin/skills/lit-typographic-motion/engine/node/styles.mjs +213 -0
  213. package/plugin/skills/lit-typographic-motion/engine/node/treatment.mjs +311 -10
  214. package/plugin/skills/lit-typographic-motion/engine/stage/cover-init.js +14 -2
  215. package/plugin/skills/lit-typographic-motion/engine/stage/init.js +11 -1
  216. package/plugin/skills/lit-typographic-motion/engine/stage/qa.js +6 -1
  217. package/plugin/skills/lit-typographic-motion/engine/stage/stage-kit.js +83 -0
  218. package/plugin/skills/lit-typographic-motion/engine/vendor/three/LICENSE +21 -0
  219. package/plugin/skills/lit-typographic-motion/engine/vendor/three/addons/environments/RoomEnvironment.js +144 -0
  220. package/plugin/skills/lit-typographic-motion/engine/vendor/three/addons/geometries/RoundedBoxGeometry.js +155 -0
  221. package/plugin/skills/lit-typographic-motion/engine/vendor/three/three.module.js +54571 -0
  222. package/plugin/skills/lit-typographic-motion/recipes/hero-3d/expected.json +69 -0
  223. package/plugin/skills/lit-typographic-motion/recipes/hero-3d/index.html +139 -0
  224. package/plugin/skills/lit-typographic-motion/recipes/orbit-loop/expected.json +6 -4
  225. package/plugin/skills/lit-typographic-motion/recipes/painted-light/expected.json +4 -2
  226. package/plugin/skills/lit-typographic-motion/recipes/weight-tide/expected.json +7 -5
  227. package/plugin/skills/lit-typographic-motion/references/cover.md +394 -443
  228. package/plugin/skills/lit-typographic-motion/references/craft-loop.md +57 -87
  229. package/plugin/skills/lit-typographic-motion/references/depth.md +122 -0
  230. package/plugin/skills/lit-typographic-motion/references/look.md +94 -129
  231. package/plugin/skills/lit-typographic-motion/references/runtime.md +58 -91
  232. package/plugin/skills/lit-typographic-motion/references/sound.md +130 -99
  233. package/plugin/skills/lit-typographic-motion/references/stage.md +190 -215
  234. package/plugin/skills/lit-typographic-motion/references/studio.md +245 -0
  235. package/plugin/skills/lit-typographic-motion/references/style-bibles.md +108 -97
  236. package/plugin/skills/lit-typographic-motion/references/treatment.md +191 -143
  237. package/plugin/skills/lit-typographic-motion/scripts/motion-doctor.mjs +17 -5
  238. package/plugin/skills/lit-typographic-motion/scripts/motion.mjs +47 -7
  239. package/plugin/skills/lit-typographic-motion/styles/paper.json +41 -0
  240. package/plugin/skills/lit-typographic-motion/styles/swiss-signal.json +41 -0
  241. package/plugin/skills/lit-typographic-motion/styles/terminalcore.json +42 -0
  242. package/plugin/skills/lit-typographic-motion/styles/tidal.json +41 -0
  243. package/plugin/skills/litresearch/SKILL.md +1 -0
  244. package/plugin/skills/readme-studio/SKILL.md +2 -0
  245. package/plugin/skills/review-work/SKILL.md +1 -1
  246. package/plugin/skills/start-work/SKILL.md +1 -1
@@ -0,0 +1,245 @@
1
+ # Studio: house styles, shots, the board and the house file
2
+
3
+ Read this for every film, after `treatment.md`. It is what makes two films of one request look like
4
+ the same studio made them, and what lets the user see the film before the full render. Covers keep
5
+ their own recipes (`cover.md`); everything here is for films on the stage and type paths.
6
+
7
+ The rule behind every part below: a decision the model used to make again on each run is now data
8
+ the page is built from, or a check the renderer runs. Prose that only asks for consistency does not
9
+ produce it; data and checks do.
10
+
11
+ ## The flow
12
+
13
+ 1. **Style.** The treatment names one house style. The validator accepts only the style the rules
14
+ choose (below), so the same request always gets the same style.
15
+ 2. **Shots.** Each beat of the treatment is a shot with a `layout`, a `hero` move and a `transition`.
16
+ The layouts are one grid shared by every style; the style maps them to pixels per format.
17
+ 3. **Scaffold** (stage path). `motion.mjs scaffold --out <dir>` writes `stage/index.html` from the
18
+ treatment. Draw the subject of each shot in its `DRAW` function; keep the rest of the structure.
19
+ 4. **Board round** (round 1). `stage --round 1 --stills-only` (or `make ... --stills-only` on the type
20
+ path) writes the stills and `stills/board.png`, the storyboard. On the stage path it also runs the
21
+ board check, the text and style rules of the gate on the board frames, and exits 13 naming each
22
+ failed rule before any film is encoded.
23
+ 5. **Film.** The full render, with the style rules in its gate.
24
+ 6. **House.** A passed film records its style in `motion-house.json` beside the output folder; the next
25
+ film in that folder takes the same style unless the user names another.
26
+
27
+ ## Register: rich is the default
28
+
29
+ Every film is maximal unless the request asks otherwise. `register` is `rich` by default and
30
+ `minimal` only when the request asks for a calm, quiet, simple or minimal film (미니멀, 잔잔, 차분, 조용,
31
+ 심플, 절제, minimal, calm, quiet, simple, understated, sparse, serene). The validator refuses
32
+ `minimal` without that ask and `rich` with it.
33
+
34
+ A rich film fills its frame the way the reference studios do:
35
+
36
+ - **A layered world** (`world.layers`, at least 3, back to front): what lives in the far ground, the
37
+ middle and the near ground of the film's place. Every shot shows at least two of them at once.
38
+ - **Labelled parts** (`world.labels`, at least 6, at most 4 words each): the names a viewer reads on
39
+ the drawn parts, readouts, tabs and tags. A named product uses its real names. The text QA's
40
+ `TEXT-LABELS` rule fails when fewer than 75 % of them reach the screen, or when half the beat
41
+ midpoints show fewer than 3 readable text runs.
42
+ - **A filled frame.** At each beat midpoint the text QA cuts the frame into 4 x 3 regions; `RICH-FILL`
43
+ fails when more than one shot leaves over 2 of the 12 empty (the end card may breathe). A 3D hero on a
44
+ dark floor does not fill a frame by itself: put the world's parts around it as panels in the DOM
45
+ (live counters, a log that scrolls, stage pills, a progress readout, the product's own screens at a
46
+ size that reads), the way a dense dashboard frame does.
47
+ - **A moving camera** (`world.camera`, `[{beat, move}]`, in at least half the shots): push-in, truck,
48
+ crane, orbit, rack focus, parallax. A locked shot is not listed.
49
+ - **Accents by role.** Besides its core palette each style has at least three accent colours, each
50
+ for one role (a state, a category, a path); a rich `palette` may add them, at most 14 entries.
51
+ - **Decor text** (readouts, coordinates, part numbers) may fill up to 60 % of the text area.
52
+ - **An authored score**: `sound.mode: score`, layered stems arranged on the film's beats (`sound.md`).
53
+ - **Full 3D where the subject allows**: `depth: 3d`, and `render3d: blender` for path-traced light
54
+ when Blender is installed and the request asks for high-quality, cinematic or photoreal 3D
55
+ (`depth.md`); `scaffold` prints `BLENDER:` when both hold.
56
+
57
+ A minimal film keeps the restraint of a single hero on an open ground: the core palette only, decor
58
+ under 25 %, no world plan, and the style's preset beds (`sound.mode: generated`).
59
+
60
+ The flash audit (MO-C-03) is the same in both registers. Density is met with slower light changes,
61
+ lower-contrast detail behind a move, motion blur and cuts, never by locking the camera.
62
+
63
+ ## House styles
64
+
65
+ A style is a file in `styles/<id>.json`: palette roles, faces per type role, a type scale per format,
66
+ leading, motion tokens (eases, durations, staggers, a spring per object class, secondary and ambient
67
+ travel, the hold push), the transitions it hands off with, its ground, its sound beds (a default and
68
+ two alternatives, `sound.md`) and the defaults it never uses. Four ship:
69
+
70
+ | Style | Look | Type | Hand-offs | Default bed |
71
+ |---|---|---|---|---|
72
+ | `swiss-signal` (default) | Ink ground, bone type, one teal signal, one amber moment | Archivo display and headline, Pretendard body, MesloLGS NF labels | cut, wipe, match, push | glass, A minor, 104 BPM |
73
+ | `tidal` | Indigo ground with a slow teal-to-violet flow, off-white type, one coral moment | Archivo 700, Pretendard body | dissolve, match, wipe | felt-strings, D major, 84 BPM |
74
+ | `terminalcore` | Navy terminal, phosphor type at typing speed, one signal hue, no easing | VT323 with Galmuri9 for Hangul, sizes on its 9 px grid | cut, wipe | pulse-synth, E minor, 120 BPM |
75
+ | `paper` | Warm paper ground, near-black ink, terracotta signal, one blue moment, soft springs | Pretendard throughout, MesloLGS NF labels | cut, match, wipe, iris, push | soft-keys, F major, 96 BPM |
76
+
77
+ `swiss-signal`, `tidal` and `terminalcore` are the type engine's presets too, so a style means the same
78
+ palette on both paths. `paper` is stage-only.
79
+
80
+ Type sizes per role (px):
81
+
82
+ | Style | 16:9 display / headline / body / label | 9:16 display / headline / body / label |
83
+ |---|---|---|
84
+ | swiss-signal | 128 / 76 / 40 / 26 | 120 / 80 / 46 / 32 |
85
+ | tidal | 116 / 72 / 40 / 26 | 112 / 76 / 46 / 32 |
86
+ | terminalcore | 126 / 81 / 45 / 36 | 117 / 81 / 54 / 36 |
87
+ | paper | 112 / 68 / 40 / 26 | 108 / 74 / 46 / 32 |
88
+
89
+ `motion.mjs styles --out <dir> [--format 16:9|9:16]` renders the same demo film in every style and
90
+ writes `<dir>/styles.png`, the four boards side by side. Show it when the user wants to choose a style,
91
+ or asks what the films will look like.
92
+
93
+ ## Choosing the style
94
+
95
+ In this order, first match wins; the validator refuses anything else and says which rule chose:
96
+
97
+ 1. The request names a style: its id (`swiss-signal`, `tidal`, `terminalcore`) or `paper style`
98
+ (`페이퍼`, `타이달`, `터미널코어`, `스위스 시그널` too).
99
+ 2. The project's house style (`motion-house.json` beside the output folder).
100
+ 3. A keyword in the request or the copy: terminal words (터미널, CRT, 해커, terminal, hacker) take
101
+ `terminalcore`; calm or wave words (물결, 파도, 잔잔한, 흐름, gradient, wave, tide, calm) take `tidal`;
102
+ warm or paper words (따뜻한, 밝은, 종이, 손그림, 포근한, 아기자기, warm, cozy, bright, paper, handmade,
103
+ hand-drawn) take `paper` on the stage path.
104
+ 4. The genre: an `explainer` takes `paper` (a warm, legible ground for diagrams and steps; on the type
105
+ path, where `paper` has no preset, the rule is skipped) and a `brand-mood` film takes `tidal`.
106
+ 5. Otherwise `swiss-signal`.
107
+
108
+ The style fixes more than colour. On the stage path the treatment's `palette` may only list the style's
109
+ colours (a rich film adds its role accents), `typePlan.faces` only its faces, and a minimal film's
110
+ generated bed is one of the style's beds exactly. A score takes the style's genre unless `sound.genre`
111
+ names another.
112
+ On the type path the brief's `style` must equal the treatment's style or be left out.
113
+
114
+ ## Shots and layouts
115
+
116
+ Each beat carries three shot fields on the stage path:
117
+
118
+ | Field | Rule |
119
+ |---|---|
120
+ | `layout` | `title`, `split`, `split-alt`, `stage`, `full` or `hero` |
121
+ | `hero` | The one move the eye follows in this shot, as a viewer would describe it |
122
+ | `transition` | How the shot hands off: a word from the style's list; the last shot is `end` |
123
+ | `lines` | Optional: the indices of the copy lines this shot shows (a `full` shot shows none) |
124
+
125
+ The layouts, as `[x, y, w, h]` fractions of the frame:
126
+
127
+ | Layout | 16:9 type zone | 16:9 subject zone | 9:16 type zone | 9:16 subject zone |
128
+ |---|---|---|---|---|
129
+ | `title` | 0.08, 0.20, 0.84, 0.60 | whole frame (backdrop) | 0.09, 0.26, 0.82, 0.48 | whole frame |
130
+ | `split` | 0.08, 0.16, 0.36, 0.68 (left) | 0.48, 0.08, 0.46, 0.84 | 0.09, 0.08, 0.82, 0.26 (top) | 0.06, 0.36, 0.88, 0.56 |
131
+ | `split-alt` | 0.56, 0.16, 0.36, 0.68 (right) | 0.06, 0.08, 0.46, 0.84 | 0.09, 0.66, 0.82, 0.26 (bottom) | 0.06, 0.06, 0.88, 0.56 |
132
+ | `stage` | 0.08, 0.75, 0.84, 0.18 (caption band) | 0.06, 0.07, 0.88, 0.64 | 0.09, 0.79, 0.82, 0.13 | 0.06, 0.06, 0.88, 0.68 |
133
+ | `full` | none: no copy | whole frame | none | whole frame |
134
+ | `hero` | 0.08, 0.76, 0.84, 0.17 (low band) | 0.03, 0.03, 0.94, 0.94 | 0.09, 0.80, 0.82, 0.12 | 0.03, 0.03, 0.94, 0.94 |
135
+
136
+ Choose layouts for the story: `title` for an opening or closing line over a backdrop, `split` and
137
+ `split-alt` for a line beside the thing it is about (alternate them so the eye moves), `stage` when the
138
+ drawing is the shot and the words are a caption, `full` when the picture must speak alone, `hero` when
139
+ the protagonist fills the frame (a close-up, the turn, the product reveal) with one short line under
140
+ it. Composition changes with the story: two adjacent shots never share a layout, and a film of four or
141
+ more shots uses at least three layouts; the validator refuses a treatment that parks the eye. One hero
142
+ move leads each shot and the eye follows it; in a rich film the world around it keeps working:
143
+ secondary moves on the labelled parts travel 50-70 % as far and start 0.1-0.2 s later, the layers drift
144
+ at their own depths, and ambient motion never stops. A minimal film keeps ambient motion under the
145
+ style's ambient travel.
146
+
147
+ ## The page: style.css, style.js and the kit
148
+
149
+ The renderer serves two files for the film's style and format:
150
+
151
+ - `/lit/style.css`: custom properties (`--lit-ground`, `--lit-ink`, `--lit-muted`, `--lit-signal`,
152
+ `--lit-accent`, `--lit-line`, `--lit-surface`, the size steps), the body ground, the type-role classes
153
+ `.lit-display`, `.lit-headline`, `.lit-body`, `.lit-label` (face, size, weight, leading) and the colour
154
+ classes `.lit-ink`, `.lit-muted`, `.lit-signal`, `.lit-accent`, `.lit-knockout`.
155
+ - `/lit/style.js`: `window.LitStyle` (the tokens, with the layout zones in pixels for this format) and
156
+ `window.LitTimeline` (the treatment's shots: `t0`, `t1`, `layout`, `transition`, plus fps and length).
157
+
158
+ The kit reads them:
159
+
160
+ - `LitStage.shot(t)` returns the shot at `t`: `index`, `beat`, `layout`, `transition`, `local` (seconds
161
+ into the shot), `length`, `p` (0..1), `enter(delay, dur)` (0 to 1 on the style's entrance ease) and
162
+ `exit(dur)` (0 to 1 over the shot's last `dur` seconds on its exit ease).
163
+ - `LitStage.zone(layout, "type" | "subject")` returns `{ x, y, w, h }` in pixels;
164
+ `LitStage.place(el, layout, part)` positions an element there.
165
+ - `LitStage.tokens()` returns the style's eases as functions (`enter`, `move`, `exit`), durations,
166
+ staggers, a spring per object class (`micro`, `panel`, `headline`, `subject`, `camera`, each a
167
+ function of seconds from 0 to 1), `secondary`, `ambient` and `push`.
168
+
169
+ The page times every shot from `LitTimeline`, so the treatment, the page, the stills, the board, the
170
+ sound cues and the gate read one timeline. Set copy with the classes (or the same values): the gate
171
+ checks the result, not the class names.
172
+
173
+ ## Scaffold
174
+
175
+ `motion.mjs scaffold --out <dir>` needs a valid stage treatment and writes `<dir>/stage/index.html`:
176
+ the COPY block with every copy line, one `<section>` per shot with its type placed in the shot's type
177
+ zone (first line headline, or display in a `title` shot; further lines body in the muted colour), an
178
+ empty `<svg>` in the subject zone, entrances on the style's ease, the hand-off of each shot (wipe,
179
+ iris, dissolve, push; match, morph and cut switch on the cut, so carry the matching shape yourself),
180
+ and one `DRAW` function per shot. Fill the `DRAW` functions: they receive the shot (`s`), the shot's
181
+ svg and `t`. Change the structure only for a reason the treatment states. The scaffold never replaces
182
+ an existing page.
183
+
184
+ ## The board round
185
+
186
+ Round 1 is the board round. A stills-only render writes the stills set and `stills/board.png`: one
187
+ keyframe per shot with its number, time, layout and hand-off under it and its hero move in words, the
188
+ shot's type zone dashed over the frame, and a header with the style, palette and the film's format,
189
+ length and bed. On the stage path the same render runs the board check, the gate's text and style
190
+ rules on the board frames, writes `stills/check.json` and prints the verdict on the board.
191
+
192
+ - Exit 0: open the board and every still with Read, record round 1 with its change, and render the
193
+ film.
194
+ - Exit 13 `BOARD_CHECK_FAIL`: the message names each failed rule. Fix the page and render the board
195
+ again before the full render; a full render fails the same rules.
196
+
197
+ The board is a deliverable. The reply names it, so the user can see what was built.
198
+
199
+ ## Style rules in the gate
200
+
201
+ All FAIL, on the stage path, on the board round and the full render alike:
202
+
203
+ | Rule | Fails when | Typical fix |
204
+ |---|---|---|
205
+ | `TEXT-OVERLAP` | Two visible text runs overlap by more than 8 % of the smaller box at a QA sample | Fewer lines per shot, the `split` layout, or let one line leave before the next arrives |
206
+ | `TEXT-ON-STYLE` | Settled copy is in a colour outside the style's text roles, a face outside the style, or a size more than 4 % off the type scale | Use the type-role and colour classes |
207
+ | `TEXT-ZONE` | Settled copy sits outside its shot's type zone (by more than 1.2 % of the frame), or any copy shows in a `full` shot | Shorter copy, a smaller role, or a layout with a larger type zone |
208
+ | `TEXT-OVERLAP` (cut) | Text of the outgoing and the incoming shot overlaps during a hand-off: the QA samples every second frame within 0.4 s of each cut, and the failure is marked `(cut)` | Let the outgoing copy leave before the incoming copy arrives, or move the incoming copy to a different zone |
209
+ | `FLAT-FRAME` (full render) | More than 1 s of frames whose 0.5-99.5 % luminance spread is under 0.02: an empty frame of any colour | Draw the shot; never leave a stub `DRAW` empty |
210
+ | `DEAD-AIR` (full render) | More than 0.5 s in a row (0.4 s more allowed at the opening, 0.6 s more at the close) where under 2.5 % of the frame carries anything: a 48 px cell counts when its pixels vary (sd over 6) or differ from the ground by more than 16 levels | Keep the protagonist or the next shot's subject on screen through the hand-off; enter the next thing before the last one has gone |
211
+ | `ASSET-USED` (named product) | `product.assets` lists real files and the page loads none of them | Show the real logo, screenshot or README image from `stage/assets/` |
212
+
213
+ Non-copy text off the scale is a WARN; decor text (`text(el, { decor: true })`) is exempt. The cut
214
+ samples check overlap only: copy in mid-transition is off its zone and scale by design.
215
+
216
+ `FLAT-FRAME` catches a blank frame; `DEAD-AIR` catches the frame that is not blank but says nothing,
217
+ one thin line or a lone label on an empty ground, held long enough to read as a stall.
218
+
219
+ ## Preview
220
+
221
+ When the request asks for a preview or a storyboard first (미리보기, 스토리보드, 콘티, preview,
222
+ storyboard), set `preview: true` in the treatment. The film is then done at the board: a board round
223
+ whose check passed, looked at, with the board in the viewed list. The reply shows the board and says the
224
+ film is not rendered yet; when the user says go, set `preview` to false and render the film. Without
225
+ those words a bare `lit` still asks no questions and renders the film, and the reply still names the
226
+ board.
227
+
228
+ ## The house file
229
+
230
+ `motion-house.json` sits beside the output folder (the user's working directory):
231
+
232
+ ```json
233
+ { "schema": "litgravity.motion-house/v1", "style": "<style id>", "createdAt": "<time>", "films": [{ "dir": "<folder>", "style": "<style id>", "path": "<stage or type>", "format": "<16:9 or 9:16>", "durationSec": 0, "at": "<time>" }] }
234
+ ```
235
+
236
+ The renderer writes it when a full render passes and nothing is withheld; the first film sets the
237
+ house style and later films are appended. While it exists the validator holds new films in that folder
238
+ to the house style; a request that names another style wins for that film and does not move the house
239
+ style. To change the house style, edit `style` in the file or delete it.
240
+
241
+ ## What stays free
242
+
243
+ The subject, the idea, the copy, the drawing, the hero moves and the arc stay the model's, with the
244
+ treatment's concept rules (`treatment.md`). The studio fixes how a film looks and is built, never what
245
+ it is about.
@@ -1,130 +1,141 @@
1
- # Style bibles for the type path
1
+ # Style bibles
2
2
 
3
- Before any scene is chosen, a type-path film commits to one look: a ground, a type colour, one signal,
4
- three type voices, how type moves, which shader passes run and in what order, the grid it sits on, and a
5
- short list of things it must never do. The engine keeps each preset as data in `engine/core/presets.mjs`
6
- (palette hexes, voices, motion tokens, pass order and pass parameters), and the gate reads the same object.
7
- This page explains why each preset looks the way it does, so a choice between them can be argued.
3
+ A style bible is the one page that decides how a film looks before any scene is written: the
4
+ palette, the three type voices, the motion vocabulary, the shader passes and their order, the
5
+ layout grid, what to avoid, and what makes this film its own. The type engine carries each preset as
6
+ data (`engine/core/presets.mjs`), and the house styles carry the same palettes for the stage path
7
+ (`styles/<id>.json`, `studio.md`); this page is the reasoning behind that data. The treatment's
8
+ `style` decides the preset on the type path, so the brief leaves `style` out; under a bare `lit`, state
9
+ the style and the rule that chose it in one sentence.
8
10
 
9
- When the user asked for a direction, write the film's own short bible in the reply using the template
10
- below. Under a bare `lit` route, one sentence naming the preset and the reason is enough.
11
+ ## Template
11
12
 
12
- ## Template for a film's own bible
13
-
14
- | Part | What to decide |
13
+ | Part | Decide |
15
14
  | --- | --- |
16
- | Idea | One sentence: what the film says and the one image it leaves behind |
17
- | Palette | Ground, type colour, one signal hue, at most one rare accent, each named by its role |
18
- | Voices | Display for titles and hooks, body for running text (with its Hangul face), machine for figures, data and credits |
19
- | Motion tone | Named tokens for how type lands, how long it holds and how a shot ends; no per-shot curve invention |
20
- | Passes | Which look passes run, their order and strength |
21
- | Grid | Columns, gutter, margin, baseline, and where the eye enters each shot |
22
- | Anti-slop | Three to five moves this film refuses |
23
- | Originality | The metaphor, rhythm or single accent moment that belongs to this brief alone |
24
-
25
- ## How a preset is picked (MO-B-00)
26
-
27
- An explicit `style` in the brief always wins. Without one, `pickPreset` scans the brief's text (its shots,
28
- title and request) against a short keyword table, top row first, and takes the first whole-word hit.
29
- Latin keywords need word boundaries on both sides and ignore case; a Korean keyword only has to start a
30
- token, so it can carry a particle but can never match the tail of a longer word.
31
-
32
- | Keywords in the brief | Preset |
15
+ | Idea | One sentence: what the film says and the single image it leaves. |
16
+ | Palette | A ground, one type colour, one signal hue; a rich film (the default) adds the style's accents, each for one role, and a minimal one at most one rare accent. Name every colour by role. |
17
+ | Three voices | Display (titles, hooks), body (running text; Hangul body for Korean), machine (data, credits, counters). |
18
+ | Motion tone | Named tokens only: how type lands, how long it holds, how a shot ends. No per-shot curves. |
19
+ | Passes | Which look-library passes run, in which order, and how strongly. |
20
+ | Grid | Columns, gutter, margin, baseline; where the eye enters each shot. |
21
+ | Anti-slop | Three to five things this film must not do. |
22
+ | Originality | What is this brief's own: its metaphor, its rhythm, its one accent moment. |
23
+
24
+ ## Auto-pick (MO-B-00)
25
+
26
+ Checked in order, first match wins, whole words only (a Korean keyword must start a token, so it
27
+ never matches the tail of a longer word). A style the request names always wins, then the project's
28
+ house style. The treatment validator applies the same table to the request and the copy, plus the
29
+ `paper` row on the stage path (`studio.md`).
30
+
31
+ | The brief mentions | Preset |
33
32
  | --- | --- |
34
- | 터미널, CRT, 해커, terminal, hacker, crt | terminalcore |
35
- | 물결, 파도, 잔잔한, 흐름, gradient, wave, tide, calm | tidal |
36
- | no hit | swiss-signal |
33
+ | 터미널, CRT, 해커 / terminal, hacker | terminalcore |
34
+ | 물결, 파도, 잔잔한, 흐름 / gradient, wave, tide, calm | tidal |
35
+ | anything else | swiss-signal |
37
36
 
38
- Words such as system, status or flow were left out on purpose: they turn up in billing systems, design
39
- systems and workflows that have nothing to do with a terminal or the sea. The report prints the reason,
40
- for example `agent default (brief mentions "파도")`, and calls the style user-specified only when the
41
- user's request names the preset.
37
+ System, status and flow are deliberately not keywords: they appear in payment systems, design
38
+ systems and workflows that have nothing to do with a terminal or a tide.
42
39
 
43
- ## swiss-signal, the default
40
+ ## swiss-signal (default)
44
41
 
45
- **Palette.** Ink ground `#0C0E13`, bone type `#E9EBE4`, a single teal signal `#0F7A82`, an amber accent
46
- `#D9A441` saved for one moment, and graphite `#4B5058` for hairlines only. Bone on ink measures about 16:1.
47
- Teal on ink is roughly 3.8:1: enough for large type (32 px, or 25 px at weight 700) and for marks, too
48
- little for small text, which therefore stays bone.
42
+ **Palette.** Ink ground `#0C0E13`; bone type `#E9EBE4`; one teal signal `#0F7A82`; one amber
43
+ accent `#D9A441` for a single moment; graphite `#4B5058` for hairlines only. Bone on ink is 16:1.
44
+ Teal on ink is 3.8:1, which clears the 3:1 large-type floor but not 4.5:1, so teal type must be at
45
+ least 32 px (25 px at 700 weight) or a mark, never small text.
49
46
 
50
- **Voices.** Display is Archivo 900 in three static width instances (75, 100, 125); width changes step
51
- between instances and never interpolate. Hangul display uses Pretendard Bold, with Pretendard Regular as
52
- the lighter weight step. Body is Archivo 400 with Pretendard Regular. The machine voice is MesloLGS NF
53
- (Hangul falls back to Pretendard Regular).
47
+ **Voices.** Display: Archivo in static width steps (75, 100, 125) at 900, stepping width, never
48
+ interpolating; Hangul display in the Pretendard Bold file. Body: Archivo 400 / Pretendard Regular.
49
+ Machine: MesloLGS NF for annotations, credits and figures.
54
50
 
55
- **Motion.** A slam takes 0.18 s on a hard deceleration and lands on the downbeat; the entrance never
56
- scales below 0.95. After a slam the type holds still for 0.6 to 0.9 s. Shots change on hard cuts with no
57
- easing. There is no spring and no bounce: the reference is printed matter.
51
+ **Motion.** `slam`: 180 ms on the deceleration curve cubic-bezier(0.16, 1, 0.3, 1), landing on the
52
+ downbeat, entrance scale never below 0.95. `hold`: 0.6–0.9 s of stillness after a slam. `cut`: a
53
+ hard cut with no easing between shots. No spring, no bounce: print is precise, not playful.
58
54
 
59
- **Passes.** `swiss-grid` draws the hairline rules of a 12-column grid (guides stay off in every export),
60
- then `dither` lays a Bayer 4x4 pattern at strength 0.3 for an engraved texture. The post chain adds light
61
- grain, a soft vignette and a hint of chromatic aberration. Bloom and halation are zero: glow on bone type
62
- reads as cheap, and the teal is too dark to bloom anyway.
55
+ **Passes.** swiss-grid (hairline rules that make the grid visible) then dither (Bayer 4x4 at about
56
+ 0.3 strength, an engraved-print texture). Grain, vignette and a little chromatic aberration come
57
+ from the post chain. No bloom: glow on bone type reads as cheap.
63
58
 
64
- **Grid.** 12 columns, 24 px gutter, 96 px margin, 8 px baseline. Compositions are asymmetric: type hangs
65
- from a column edge, annotations sit beside the headline, and large areas stay empty.
59
+ **Grid.** 12 columns, 24 px gutter, 96 px margin, 8 px baseline. Asymmetric: type sits on the left
60
+ column edge, annotations beside the headline rather than stacked under it, generous empty space.
66
61
 
67
- **Refuses.** Centred fade-ins as the only move, one easing curve for everything, glitch without a reason
68
- on the beat, a second hue, bloom, and holds so long that the film seems to stall.
62
+ **Anti-slop.** Centered fade-ins as the only move; one ease for everything; glitch without a beat
63
+ reason; any second hue; bloom; a hold so long it reads as a stall.
69
64
 
70
- **Originality.** Borrow the structure (one ground, one signal, one rare accent) and never the colours of a
71
- known title sequence. The metaphor of each shot comes from this brief.
65
+ **Originality.** Borrow the pattern (one ground, one signal, one rare accent), never a known
66
+ film's colours. Each shot gets this brief's own metaphor.
72
67
 
73
68
  ## terminalcore
74
69
 
75
- **Palette.** Navy ground `#05070A`, panel `#0C1116` for the window chrome, one signal hue per film
76
- (phosphor green `#39FF6A` by default, electric blue `#2FB6FF` with `signalHue: "blue"`) that also becomes
77
- the type colour, and status grey `#7C8B93`. On a flat ground green reaches about 15:1 and grey about 5.7:1.
78
- The crt vignette and scanlines darken the window corners enough to pull grey under 4.5:1, so labels and
79
- readouts near the corners use the signal hue and grey stays on strokes and central text.
70
+ **Palette.** Navy ground `#05070A`; panel `#0C1116` for window chrome; one signal hue per film,
71
+ phosphor green `#39FF6A` (default) or electric blue `#2FB6FF`, never both; status grey `#7C8B93`.
72
+ Green on navy is 15:1 and grey on navy 5.7:1 on a flat ground. The crt vignette and scanlines
73
+ darken the window corners below 4.5:1 for grey, so the chrome label and the readout there are set in
74
+ the signal hue; grey stays on strokes and on text nearer the centre.
80
75
 
81
- **Voices.** Display is VT323 for Latin with Galmuri9 for Hangul, a pixel face that is only drawn at whole
82
- multiples of its 9 px grid and never below 36 px. The body uses VT323 with Pretendard Regular for Hangul.
83
- Machine readouts use MesloLGS NF, and the window chrome is labelled in Silkscreen. VT323 and Galmuri never
84
- share one status line cell for cell.
76
+ **Voices.** Display: Galmuri9 for Hangul (pixel type at whole multiples of its 9 px grid, at least
77
+ 36 px) with VT323 for Latin. Machine: MesloLGS NF for readouts. Chrome labels: Silkscreen. Galmuri
78
+ and VT323 never share a status line cell for cell.
85
79
 
86
- **Motion.** Characters type in at 22 per second, linearly, because a terminal has no easing. The first
87
- 0.25 s of a shot may boot-flicker at the capped crt amplitude, which counts as one event. Cuts land on
88
- downbeats and nothing overshoots.
80
+ **Motion.** `type-in`: characters appear at the terminal's rate (22 per second), linear, with no
81
+ easing, because a terminal does not ease. `boot-flicker`: the first 250 ms of a shot flicker at the
82
+ capped CRT amplitude, counted as one event. Hard cuts on downbeats. Nothing overshoots.
89
83
 
90
- **Passes.** Four, in this order: `terminal-ui` (window chrome, two meters, a log readout and a caret
91
- blinking at 1.2 Hz), `crt` (scanlines, curvature 0.06, triad mask, flicker amplitude 0.03), `dither`
92
- (2 px cells) and `glitch` (at most 0.5 hits per second, each hit held two frames over at most 12 % of the
93
- frame). With four passes the shared event budget, two events in any second of a shot, is the limit that
94
- actually bites.
84
+ **Passes.** terminal-ui (window chrome, meters, readout) then crt (scanlines, curvature, capped
85
+ flicker) then dither (Bayer 4x4, 2 px cells) then glitch (rare, at most 0.5 hits per second, each hit
86
+ one band for two frames). This is the only preset with four passes, so the per-shot event budget
87
+ (two events in any second) is the real limit.
95
88
 
96
- **Grid.** One thin-bordered window on a flat field, no drop shadow, with text snapped to a 14x24 px
89
+ **Grid.** One thin-bordered window on a flat field, no depth or shadow; text aligned to the
97
90
  character grid so it never drifts against the chrome.
98
91
 
99
- **Refuses.** Falling code rain, purple and cyan neon haze, continuous glitching, two signal hues, and
100
- pixel type too small to read.
92
+ **Anti-slop.** Falling code rain; purple-cyan neon haze; glitch running continuously; two signal
93
+ hues; pixel type too small to read.
101
94
 
102
- **Originality.** The window, meters and readout are drawn by the engine itself and imitate no real
103
- operating system or terminal application.
95
+ **Originality.** The window, meters and readout are this engine's own drawings, not a copy of a
96
+ real operating system or terminal app.
104
97
 
105
98
  ## tidal
106
99
 
107
- **Palette.** Indigo ground `#0E1420`, off-white type `#E8ECEF`, gradient stops deep teal `#124559` and
108
- violet `#4C3B6E`, and coral `#E07856` as punctuation for a single moment. Off-white stays above 8:1 on every
109
- stop, so type may sit anywhere on the flow without a scrim. Tidal has no signal hue of its own: the teal
110
- stop is its saturated cluster for the accent check, and marks such as bars and the pen head use the type
111
- colour.
100
+ **Palette.** Indigo ground `#0E1420`; off-white type `#E8ECEF`; gradient stops deep teal `#124559`
101
+ and violet `#4C3B6E`; coral `#E07856` as punctuation in one moment only. Off-white clears 8:1 on
102
+ every stop, so type can sit anywhere on the flow without a scrim.
103
+
104
+ **Voices.** Display: Archivo 700 at normal width, calm and mostly still; Hangul in the Pretendard
105
+ Bold file. Body: Pretendard Regular. Machine: MesloLGS NF for small credits only.
106
+
107
+ **Motion.** `drift`: position and opacity on cubic-bezier(0.37, 0, 0.63, 1) over 2–4 s, matching the
108
+ gradient's slow flow so type and background move as one system. `surge-punch`: 300 ms on the slam
109
+ curve, timed to a tidal surge. Continuous flow, not hold-and-snap.
110
+
111
+ **Passes.** tidal-gradient (a domain-warped flow mixing the stops, one or two soft surges per shot)
112
+ then swiss-grid (rules only, guides off) then glitch at 0.5 hits per second or less, as punctuation.
113
+
114
+ **Grid.** The swiss-signal grid; centred compositions are allowed here because the ground moves.
115
+
116
+ **Anti-slop.** A rainbow or hue-cycling ramp; bloom on the gradient; glitch as texture; flow so
117
+ fast that held type smears.
118
+
119
+ **Originality.** The flow field is seeded per shot, so no two films share one; stops are chosen for
120
+ the brief within two or three restrained colours.
121
+
122
+ ## paper (stage path only)
112
123
 
113
- **Voices.** Display is Archivo 700 at normal width only, calm and mostly still, with Pretendard Bold for
114
- Hangul. Body is Archivo 400 with Pretendard Regular. MesloLGS NF appears only for small credits.
124
+ **Palette.** Warm paper ground `#F3EEE5`; near-black ink `#1D1B18`; muted `#5B564E` for second lines;
125
+ one terracotta signal `#B0452A`; one blue accent `#2B5D8E` for a single moment; line `#C9BFAE` for
126
+ drawn strokes. Ink on paper is 14.9:1, muted 6.3:1, signal 4.9:1.
115
127
 
116
- **Motion.** Type drifts in position and opacity over two to four seconds on a symmetric ease, in step with
117
- the background's slow flow, so type and ground read as one system. A surge punch of 0.3 s marks a tidal
118
- surge. The film flows continuously instead of holding and snapping.
128
+ **Voices.** Pretendard throughout (700 for display and headline, 400 for body), MesloLGS NF for small
129
+ labels. Hangul and Latin share one face, so mixed lines keep one colour of type.
119
130
 
120
- **Passes.** `tidal-gradient` (a domain-warped flow mixing the stops, four octaves, at most two surges per
121
- second with attack and decay of at least 0.1 s), then `swiss-grid` with its guides off, then `glitch` at
122
- 0.5 hits per second or less, used as punctuation.
131
+ **Motion.** Soft springs: panels settle at damping 0.8, the subject may bounce at 0.6, type never
132
+ overshoots. Entrances on a quint-like ease-out, exits shorter and on an ease-in.
123
133
 
124
- **Grid.** The swiss-signal grid. Centred compositions are fine here, because the ground itself moves.
134
+ **Grid.** The shared layout zones (`studio.md`), generous margins, drawings in line weight rather than
135
+ fills.
125
136
 
126
- **Refuses.** Rainbow or hue-cycling ramps, bloom on the gradient, glitch as a texture, and a flow so fast
127
- that held type smears.
137
+ **Anti-slop.** Drop shadows that float type; neon or glow; gradients on type; more than two saturated
138
+ colours on screen; bouncy type.
128
139
 
129
- **Originality.** The flow field is seeded per shot from the run seed, so two films never share one, and
130
- the stops stay within two or three restrained colours chosen for the brief.
140
+ **Originality.** The drawing carries the film: hand-drawn lines, paper cut-outs, small diagrams. The
141
+ ground stays plain so the drawing reads.