@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
@@ -1,25 +1,31 @@
1
1
  # Signal
2
2
 
3
- Signal is the direction for a talk given out loud, where every slide says one thing and says it
4
- loudly. The ground is white, nearly all type is near-black ink, and one hot red-orange accent is kept
5
- for the protagonist: the figure, the word or the row the slide exists for. There are no cards and
6
- few lines; weight, size and space do the grouping. The pack file states the trade: large type and few
7
- words, wrong when the audience must read the detail later or when most of the content is tables.
3
+ Signal is the direction for a talk given out loud. Each slide carries one topic with the facts that
4
+ support it, set on the reading ramp so the room can follow while the speaker talks and a reader can
5
+ still check the figures later. The ground stays white, almost everything is near-black ink, and a
6
+ single red-orange accent marks the one figure or word the slide exists for. There are no cards and
7
+ very few lines; space, weight and colour do the grouping.
8
8
 
9
- ## When to choose it
9
+ ## When to use it
10
10
 
11
- Reach for Signal when someone stands in front of decision makers for ten to fifteen minutes: an
12
- investment pitch, a product launch, a proposal that has to land in one sitting. The pack lists eleven
13
- families and none of them is a plain text page: the engine has no `text-column`, `agenda` or
14
- `references-appendix` here, so a deck whose content is mostly paragraphs and lists belongs in another
15
- direction. The brief signals that fit are a story that runs from a problem to an ask, a handful of
16
- real headline numbers, and a room that follows a speaker.
11
+ Reach for Signal when someone will stand in front of decision makers and speak for ten to fifteen
12
+ minutes: an investment pitch, a product launch, a proposal that has to land in one sitting. The
13
+ content signals that point here are short bodies (about 40 Korean glyphs or 80 Latin characters per
14
+ content slide or less), a handful of real headline numbers, and a story that moves from a problem
15
+ to an ask. It is the first candidate for the pitch deck type, and the third one for an image-led
16
+ launch when the pictures are few.
17
17
 
18
- Choose Ledger or Gazette when the deck is circulated ahead of the meeting and read alone, and when
19
- tables fill a third of the slides or more.
18
+ ## When it is the wrong choice
19
+
20
+ Signal fails when the deck will be read alone later, because its open pages hold less detail than a
21
+ reader needs without a speaker. It also fails when tables make up a third of the slides or
22
+ more: tables at Signal's sizes either run out of room or shrink to a size that contradicts the rest
23
+ of the deck. If the brief says the deck is sent ahead or circulated, Ledger or Gazette fits better.
20
24
 
21
25
  ## Tokens
22
26
 
27
+ The values below come from the pack file and are what the engine draws.
28
+
23
29
  | Token | Value |
24
30
  |---|---|
25
31
  | ground / surface | #FFFFFF / #F4F4F5 |
@@ -28,130 +34,117 @@ tables fill a third of the slides or more.
28
34
  | field / on-field | #C8361A / #FFFFFF |
29
35
  | positive / negative | #1E7A3F / #15131A |
30
36
  | series | #C8361A, #15131A, #6B6870, #2F6F8F |
31
- | faces | Pretendard Bold for display, title and numerals, Pretendard Regular for body and labels; `faces: a2z` moves display and numerals to A2Z Black and titles to A2Z Bold |
32
- | tracking (title / display) | -1 % / -2 % of the size |
33
- | density / variance | 10 / 6 (up to 4 title treatments, which is all four of the pack) |
37
+ | faces | Pretendard Bold for display, title and numerals, Pretendard Regular for body and labels; `faces: a2z` swaps to A2Z Black display and numerals, A2Z Bold titles |
38
+ | ramp / hero | compact (body 13 pt, labels 11, sources 9) / hero step (60 pt) on cover and statement titles that fit, off with `hero: false`; figures at most title size |
39
+ | density / variance | 10 / 6 |
34
40
  | radius / edge | 0 / fill |
35
- | table | no header fill, rules at the top and bottom, the row whose first cell the title names in accent-tint, bold totals |
36
- | chart | no gridlines and no value axis, direct labels, accent on the highlighted series over muted ones |
37
- | image | no frame |
38
- | decoration | colour-field, hairline-rule, numeral |
41
+ | table | open style, no header fill, rules at top and bottom, protagonist row in accent-tint, bold totals |
42
+ | chart | no gridlines, direct labels, accent on the highlighted bar over muted bars |
39
43
 
40
- Negative equals ink on purpose: the accent is red, so a loss keeps the ink colour and carries its ▼
41
- sign ("▼ −4%"). The default ramp is the compact one (body 13 pt, label 11, title 26, display 36), with
42
- no hero step; a figure never exceeds title size.
44
+ Density 10 sets the pitch on the compact grid (24 pt side margins), body 13 pt and no step-up: a
45
+ pitch read after the meeting carries its basis and sources on every slide. Lower it to 8 (body 14 pt,
46
+ 36 pt margins) for a pitch given only from the stage. Losses use ink with a ▼ sign, because red already means
47
+ "look here" in this direction.
43
48
 
44
- ## Titles by family
49
+ ## Treatments by slide role
45
50
 
46
- The role defaults are: content and statement slides `top-plain-large` and `statement`, data and
47
- sequence `top-rule`, data with a takeaway `top-plain-large`, images `bottom-anchor`, references and
48
- definitions `top-rule`. A `top-rule` title sits on a full hairline because the pack lists no
49
- `accent-rule`. The engine keeps the default while the body fills and otherwise takes the title with
50
- the smallest empty band; `title: top-plain-large` after `layout:` pins one slide.
51
-
52
- Default titles come from the role map, narrowed to what each family allows:
53
-
54
- | Family | Default title | Then, in pack order |
55
- |---|---|---|
56
- | `statement` | `statement` | none |
57
- | `big-number` | `top-plain-large` | `bottom-anchor`, `top-rule` |
58
- | `image-split` | `bottom-anchor` | `top-plain-large`, `top-rule` |
59
- | `asymmetric-feature` | `bottom-anchor` | `top-plain-large`, `top-rule` |
60
- | `process` | `top-rule` | `top-plain-large` |
61
- | `kpi-row` | `top-rule` | `top-plain-large`, `bottom-anchor` |
62
- | `chart-insight` | `top-plain-large` | `bottom-anchor`, `top-rule` |
63
- | `full-chart` | `top-plain-large` | `bottom-anchor`, `top-rule` |
64
- | `comparison` | `top-rule` (numbers) / `top-plain-large` (arguments) | `top-plain-large`, `bottom-anchor`, `top-rule` |
65
- | `table-insight` | `top-rule` | `bottom-anchor` |
66
- | `quote` | `statement` | `top-rule` |
67
-
68
- A `top-plain-large` title holds two lines of about 20 Korean glyphs; over that the engine moves the
69
- slide and logs `note: slide N: the title is longer than the top-plain-large budget; shorten it`.
51
+ Content slides take `top-plain-large`, data and sequence slides `top-rule`, data with a takeaway
52
+ `top-plain-large`, image slides `bottom-anchor`, statements `statement`, and references and
53
+ definitions `top-rule`. The engine treats that map as a starting point: for each slide it lays out
54
+ every treatment the family allows, keeps the role's own when the body fills, and otherwise picks the
55
+ one that leaves the least empty band without letting one title cover more than about a third of the
56
+ deck. To force a treatment, put `title: bottom-anchor` (or another allowed id) on the line after
57
+ `layout:`.
70
58
 
71
59
  ## Families and variants
72
60
 
73
- - `big-number` is a data panel in the field colour: two to four related figures, each with label and
74
- basis in white, the evidence beside it.
75
- - `image-split` and `asymmetric-feature` give a picture or a one-row figure one side and three to
76
- five short facts the other.
77
- - `process` shows three to five steps (rows down the body when they are four or fewer).
78
- - `kpi-row` runs two to six results with a basis row; `chart-insight` and `full-chart` carry growth
79
- curves with one highlighted series; `comparison` reads two columns across shared rows;
80
- `table-insight` holds the one table a pitch needs; `quote` sets a customer's sentence.
81
- - Covers `cover-numeral`, `cover-typographic`, `cover-split-field`; sections `section-field`,
82
- `section-numeral`; closings `closing-statement`, `closing-ask`.
83
-
84
- Display devices: the typographic cover is `drench`, the field from edge to edge with the title in up
85
- to three balanced lines, anchored low; a statement is `open`, the sentence alone on white at display
86
- size; a big number sits on a `field` panel; a closing's next step runs as a `band` of the field across
87
- the grid above the footer. `closing-ask` rows carry their amounts at title size, each with a bar for
88
- its share of the ask.
61
+ - `statement` is kept for a pull quote or a display-led deck the user asks for; a claim is not a title.
62
+ - `big-number` is a data panel of two to four related figures, each with its label and basis, beside
63
+ the facts that explain them.
64
+ - `image-split` pairs a product picture with three short labelled points.
65
+ - `asymmetric-feature` gives a picture or number the narrow side and the explanation the wide one.
66
+ - `process` shows three to five steps across the page, each with a head and two lines of detail.
67
+ - `kpi-row` runs two to four results at title size, each with its label and a basis row under it.
68
+ - `chart-insight` and `full-chart` carry growth curves and comparisons with one highlighted series.
69
+ - `comparison` reads two columns across shared rows, such as before and after.
70
+ - `table-insight` holds the one table a pitch needs, usually unit economics, with its takeaway.
71
+ - `quote` sets a customer's sentence as the statement.
72
+
73
+ Covers are `cover-numeral`, `cover-typographic` and `cover-split-field`; sections are
74
+ `section-field` and `section-numeral`; closings are `closing-statement` and `closing-ask`.
75
+
76
+ Display slides. The typographic cover is the red field from edge to edge, the topic name in up to
77
+ three balanced lines at display size, anchored low. A statement (pull quote) sets its text in up to
78
+ three balanced lines on white. A big number is a red data panel: one row per figure with value, label
79
+ and basis in white, its evidence beside it. A closing's rows carry their amounts at title size, each
80
+ with a bar for its share of the ask, and the next step runs in
81
+ a red band across the grid just above the footer.
89
82
 
90
83
  ## Do
91
84
 
92
- - Write every title as a topic label; the claim is the first line of the body.
93
- - Give every figure its basis or comparison, and every chart or table a caption with period and source.
94
- - Give a `big-number` panel two to four related figures and two or three lines of evidence.
95
- - Keep a list to four items and let each carry a number or a name.
96
- - End on `closing-ask` with the amount, its uses as a table of at most four rows and the next step.
85
+ - Write every title as a topic label (subject, measure, period); the claim is the first body line.
86
+ - Give every figure its basis or comparison and a caption with period and source.
87
+ - Give a big-number panel two to four figures and two or three lines of evidence.
88
+ - Let each bullet carry a number or a name; split a long list into labelled groups.
89
+ - End on `closing-ask` with the amount, its uses in a table and the next meeting with an owner.
97
90
 
98
91
  ## Avoid
99
92
 
100
93
  - Red for a loss; red belongs to the protagonist.
101
- - Display text beyond two lines, or one giant figure alone on a slide.
102
- - Cards and boxed groups.
103
- - A table slide without a sentence that tells the room what to take from it.
104
-
105
- ## Failure patterns
106
-
107
- | Symptom | Cause | Fix |
108
- |---|---|---|
109
- | `note: slide 1: text-column is not a signal layout family (...); drawn with its own geometry`; QA reports an 87 % empty band on a two-bullet page | a paragraph page in a deck built for the stage | use `process`, `comparison` or `big-number`, or choose Gazette |
110
- | `closing-ask` renders as a plain table with two columns of bullets | five or more action rows plus a three-line next step do not fit above the floor | cut to four rows, merge the smallest items, or shorten the next step |
111
- | `note: ... the title is longer than the top-rule budget; shorten it` | a 100-glyph title | name the subject and period only |
112
- | OF-114 on "시장은 이미 열렸다" | a statement written as a declarative sentence | set it as a quotation (leading “) or a noun phrase |
113
- | the accent colours the rival series of a chart | the engine highlights the latest period, else the series measured beside a plan, target or baseline, else the last column | put the protagonist in the last column, or name the others with a period or a reference word (계획, 전년, baseline) |
94
+ - Display text running past two lines, or one giant figure alone on a slide.
95
+ - Cards or boxed groups; this direction groups with space.
96
+ - A table slide with no sentence that tells the room what to take from it.
114
97
 
115
98
  ## Two worked slides
116
99
 
117
- Four steps with an accent numeral each; a step that opens with `1.` takes that number, and the rows
118
- spread down the body.
100
+ A big number on its own reads as decoration, so the panel holds three related figures with their
101
+ basis, and the evidence sits beside it and ends level with it.
119
102
 
120
103
  ```markdown
121
104
  ---
122
- layout: process
105
+ layout: big-number
106
+
107
+ ## 수도권 세탁 대행 시장 규모와 앱 주문 비중
108
+
109
+ | 시장 규모 (연) | 앱 주문 비중 | 수거·배송 하는 세탁소 |
110
+ |---|---|---|
111
+ | 1조 2천억 원 | 6% | 20% |
112
+ | 2025년 기준 | 2023년 3% | 다섯 곳 중 한 곳 |
123
113
 
124
- ## 앱 주문부터 배송까지 네 단계
114
+ > 수도권 세탁 대행 시장 추정, 예시 업계 통계 2025 (예시)
125
115
 
126
- - **1. 접수** 앱에서 품목과 수거 시간대를 고르면 5분 안에 기사가 배정된다
127
- - **2. 수거** 기사가 문 앞에서 사진을 남기고 제휴 세탁소로 옮긴다
128
- - **3. 세탁** 제휴 세탁소가 48시간 안에 세탁하고 검수 사진을 앱에 올린다
129
- - **4. 배송** 지정한 저녁 시간대에 배송하고 문 앞 사진으로 완료를 알린다
116
+ - 시장은 아직 대부분 오프라인이다: 앱 주문은 6%, 약 720억 원
117
+ - 동네 세탁소 다섯 곳 중 네 곳은 수거·배송을 하지 않는다
118
+ - 앱 주문 비중은 2023년 3%에서 2025년 6%로 늘었다
130
119
  ---
131
120
  ```
132
121
 
133
- The ask lists four uses of the money, each keyed by its amount with a share bar, and states the
134
- request on the field band. Four rows and three lines of next step fit; a fifth row would send the
135
- slide back to the table.
122
+ The closing labels the request in the title, shows where the money goes, states the ask in the
123
+ first line and ends with the next step.
136
124
 
137
125
  ```markdown
138
126
  ---
139
127
  layout: closing-ask
140
128
 
141
- ## 18개월 운영 자금 24억 원 사용 계획
129
+ ## 18개월 운영 자금 30억 원 사용 계획
142
130
 
143
131
  | 쓰임 | 금액 | 시점 |
144
132
  |---|---|---|
145
- | 수거·배송 권역 확대 (6개 구에서 12개 구) | 10억 원 | 2027년 상반기 |
146
- | 제휴 세탁소 품질 점검 체계 | 6억 원 | 2026년 4분기 |
133
+ | 수거·배송 권역 확대 (6개 구 → 15개 구) | 14억 원 | 2027년 상반기 |
134
+ | 제휴 세탁소 품질 관리 체계 | 6억 원 | 2026년 4분기 |
147
135
  | 앱 개발 인력 | 5억 원 | 상시 |
148
- | 제휴 세탁소 90곳 모집과 운영 예비비 | 3억 원 | 2027년 1분기 |
136
+ | 신규 제휴 세탁소 120곳 모집 | 3억 원 | 2027년 1분기 |
137
+ | 운영 예비비 | 2억 원 | 필요 시 |
138
+ | 합계 | 30억 원 | 18개월 |
139
+
140
+ > 표 2. 투자금 쓰임 (예시 데이터)
149
141
 
150
- - 요청: 18개월 운영 자금 24억 원 투자 승인
151
- - 기대 성과: 18개월 뒤 월 주문 4만 건, 월 영업이익 흑자 전환
152
- - 다음 단계: 12월 첫째 주 실사 미팅, 담당 예시 재무팀
142
+ - 요청: 18개월 운영 자금 30억 원 투자 승인
143
+ - 기대 성과: 18개월 뒤 월 주문 6만 건, 월 영업이익 흑자 전환
144
+ - 다음 단계: 11월 둘째 주 실사 미팅, 담당 예시 재무팀
153
145
  ---
154
146
  ```
155
147
 
156
- Both slides compile under `tonality: signal` with a cover and pass `qa_deck.py`; the example company
157
- and the figures are invented.
148
+ ## Examples
149
+
150
+ `01-pitch-signal-ko.md`
@@ -1,26 +1,30 @@
1
1
  # Studio
2
2
 
3
- Studio treats a deck like a magazine spread. The twelve-column grid shows through as thin column lines
4
- in the gutters, titles often stand in a side rail or open the page at display size, real figures sit in
5
- labelled panels with their basis, and pages split unevenly so that one side clearly leads. A dark ochre
6
- accent marks the single thing to look at; everything else is black, warm grey and white. The pack
7
- file states the trade: editorial white space that suits a story and starves a table.
3
+ Studio treats a deck like a magazine spread. The twelve-column grid shows through as thin column
4
+ lines, titles carry a bar in the left margin or open the page at display size, real figures sit in labelled
5
+ panels with their basis, and pages split unevenly so that one side clearly leads. A dark ochre accent marks the single
6
+ thing to look at; everything else is black, grey and white.
8
7
 
9
- ## When to choose it
8
+ ## When to use it
10
9
 
11
- Studio fits stories told more than audited: a design or brand narrative, a strategy told through cases,
12
- a public lecture, a portfolio of built work, a pitch that people judge by seeing the product. Eleven
13
- families are listed and six carry pictures or big figures (`asymmetric-feature`, `big-number`,
14
- `image-split`, `image-full`, `photo-grid`, `kpi-row`). Variance 8 allows five title treatments in one
15
- deck, which is the point of the direction: the page head changes with the job of the page.
10
+ Studio fits stories that are told more than they are audited: a design or brand narrative, a
11
+ strategy told through cases, a public lecture, a portfolio of built work, or a pitch for a product
12
+ people judge by seeing it. The content signals that move Studio up are a high share of slides with
13
+ pictures (about 30% or more) and short to medium bodies. It is the second candidate for pitches,
14
+ image-led decks and public lectures, and it can lead when the pictures are strong but the narrative
15
+ matters as much as the images.
16
16
 
17
- The splits starve table-heavy data. A business review with several tables, a status update, or a
18
- briefing read at a desk needs more rows per page than Studio gives (Ledger or Gazette serve those). The
19
- pack also needs real figures for its panels: a deck without counts, shares or years loses one of its
20
- main devices.
17
+ ## When it is the wrong choice
18
+
19
+ The editorial splits starve table-heavy data. A business review with several tables, a status
20
+ update or a briefing that is read at a desk all need more rows on each page than Studio's uneven
21
+ splits give them; Ledger or Gazette serve those. Studio also needs real figures for its numeral
22
+ panels: a deck without counts, shares or years loses one of the direction's main devices.
21
23
 
22
24
  ## Tokens
23
25
 
26
+ Read from the pack file; these are the values the engine draws.
27
+
24
28
  | Token | Value |
25
29
  |---|---|
26
30
  | ground / surface | #FFFFFF / #F2F2F0 |
@@ -29,134 +33,99 @@ main devices.
29
33
  | field / on-field | #141414 / #FFFFFF |
30
34
  | positive / negative | #1E7A3F / #B3261E |
31
35
  | series | #8A5A00, #141414, #525252, #3B5F7F |
32
- | faces | Pretendard Bold for display, title and numerals, Pretendard Regular for body and labels; `faces: a2z` moves display and numerals to A2Z Black and titles to A2Z Medium |
33
- | tracking (title / display) | -1 % / -2 % of the size |
34
- | density / variance | 10 / 8 (up to 5 title treatments, all five of the pack) |
36
+ | faces | Pretendard Bold for display, title and numerals, Pretendard Regular for body and labels; `faces: a2z` swaps to A2Z Black display and numerals, A2Z Medium titles |
37
+ | ramp / hero | compact (body 13 pt, labels 11, sources 9) / hero step (60 pt) on cover and statement titles that fit, off with `hero: false`; figures at most title size |
38
+ | density / variance | 10 / 8 |
35
39
  | radius / edge | 0 / fill |
36
- | table | no header fill, a 2 pt ink rule under the header, no row rules, bold totals |
37
- | chart | no gridlines and no value axis, direct labels, accent on the highlighted series |
38
- | image | no frame |
39
- | decoration | column-hairlines, numeral, rail-fill, colour-field, caption-band |
40
- | fill-order | change-family, step-up, anchor-visual, distribute |
41
-
42
- Of the decoration entries, `column-hairlines` (a 0.5 pt line in the gutter before the right-hand region
43
- of a split) and `rail-fill` (the side rail filled with the surface colour) change the drawing; the
44
- others describe devices that the treatments and display keys already draw. Numbers stay at title size
45
- (26 pt) or below on every pack; the editorial feel comes from the panel, the rail and the splits.
46
-
47
- ## Titles by family
48
-
49
- Role defaults: content, data with a takeaway, sequences, images, references and definitions
50
- `side-rail`; data `top-plain-large`; statements `statement`. The `overlay` frame belongs to
51
- `image-full` alone. The engine tries every title a family allows, keeps the default while the body
52
- fills, and caps any one title at about a third of the deck, so a deck of splits alternates its heads.
53
-
54
- | Family | Default title | Then, in pack order |
55
- |---|---|---|
56
- | `asymmetric-feature` | `top-plain-large` | `bottom-anchor` |
57
- | `big-number` | `side-rail` | `top-plain-large`, `bottom-anchor` |
58
- | `image-split` | `side-rail` | `top-plain-large`, `bottom-anchor` |
59
- | `image-full` | `overlay` | none |
60
- | `photo-grid` | `top-plain-large` | `bottom-anchor` |
61
- | `text-two-column` | `top-plain-large` | none |
62
- | `chart-insight` | `side-rail` | `top-plain-large`, `bottom-anchor` |
63
- | `kpi-row` | `top-plain-large` | `side-rail`, `bottom-anchor` |
64
- | `timeline` | `top-plain-large` | `bottom-anchor` |
65
- | `comparison` | `top-plain-large` (numbers) / `side-rail` (arguments) | `side-rail`, `bottom-anchor`, `top-plain-large` |
66
- | `statement` | `statement` | none |
67
-
68
- A `side-rail` title is four lines of about ten Korean glyphs; a longer title moves the slide to
69
- another head and the log says so. `title: top-plain-large` after `layout:` pins one slide.
40
+ | table | open style, no header fill, a 2 pt ink rule under the header, no row rules, bold totals |
41
+ | chart | no gridlines, direct labels, accent on the highlighted series over muted ones |
42
+
43
+ Density 10 puts the deck on the compact grid with body 13 pt. Variance 8 lets one deck mix up to five
44
+ title treatments, which is the point of this direction.
45
+
46
+ ## Treatments by slide role
47
+
48
+ Content, data with a takeaway, references, definitions and sequences take `side-rail`; data
49
+ slides take `top-plain-large`; a pull quote takes `statement`; image slides take `side-rail`, with the
50
+ picture and its facts split unevenly in the body under the title; the `image-full` family takes `overlay`. For each slide the engine tries every
51
+ treatment its family
52
+ allows and keeps the role default when the body fills, otherwise the one that leaves the least empty
53
+ band, while keeping any single treatment under about a third of the deck. A line such as
54
+ `title: top-plain-large` after `layout:` overrides that choice for one slide.
70
55
 
71
56
  ## Families and variants
72
57
 
73
- - `asymmetric-feature`: a picture with the narrow share of the page and five short lines of argument.
74
- - `big-number`: two to four real figures as a panel (value, label, basis) with the facts that explain
75
- them beside it; one figure alone sits on a panel as tall as it is.
76
- - `image-split`, `image-full`: the work itself; the full-bleed slide puts its title on the panel.
77
- - `photo-grid`: two or three pictures side by side with one shared sentence.
78
- - `text-two-column`: a brief and a response, or two halves of an argument.
79
- - `chart-insight`, `kpi-row`, `timeline`, `comparison`: the few numbers the story needs, a programme
80
- along one axis, before and after across shared rows.
81
- - Covers `cover-split-image`, `cover-rail`, `cover-numeral`; sections `section-numeral`,
82
- `section-rail`; closings `closing-contact-split`, `closing-summary-list`.
83
-
84
- The pack lists no `cover-typographic`. The generic `layout: cover` opens on the deck's first picture
85
- when there is one (`cover-split-image`) and on the rail otherwise; `cover-numeral` needs a four-digit
86
- year in the deck title or the `date` key.
87
-
88
- Display devices: a statement stands between two hairlines on the open page (the offset rail stood
89
- empty beside a sentence, so the pack uses `rules`); a big number is an ochre figure panel on the tint;
90
- a closing's `closing-contact-split` keeps the field, which holds each row's amount or date in line with
91
- its row, and the next step runs as a dark band on the page floor.
58
+ - `asymmetric-feature` gives a tall picture the narrow side and four lines of argument the wide one.
59
+ - `big-number` sets two to four real figures as a panel (value, label, basis) with the facts that
60
+ explain them.
61
+ - `image-split` and `image-full` carry the work itself; the full-bleed slide puts its title on a
62
+ panel.
63
+ - `photo-grid` shows two or three pictures side by side with one shared sentence.
64
+ - `text-two-column` holds a brief and a response, or two halves of an argument.
65
+ - `chart-insight` and `kpi-row` carry the few numbers the story needs.
66
+ - `timeline` shows a programme or a history along one axis.
67
+ - `comparison` reads before and after across shared rows.
68
+
69
+ Covers are `cover-split-image` (which takes the deck's first picture), `cover-rail` and
70
+ `cover-numeral`; sections are `section-numeral` and `section-rail`; closings are
71
+ `closing-contact-split`
72
+ and `closing-summary-list`.
73
+
74
+ Display slides. The cover opens on the deck's first picture when there is one, otherwise on the
75
+ rail. A statement stands between two hairlines on the open page (a light rail beside it stood empty). A
76
+ big-number panel stands in ochre on its tint, its figures at title size. The contact-split closing keeps the field: it holds each
77
+ row's amount or date in line with its row, and the next step runs under the rows on the white side.
92
78
 
93
79
  ## Do
94
80
 
95
81
  - Let the picture or the number lead each slide and keep the text to the side that serves it.
96
82
  - Use a numeral only for a real figure (a count, a share, a year), with its label and basis.
97
83
  - Title each slide with its topic; the claim opens the body beside the picture.
98
- - Alternate the splits: after a `side-rail` slide, follow with a top title or a full-bleed picture.
99
- - Keep titles short, about ten Korean glyphs a line in a rail.
84
+ - Alternate splits: after a side-rail slide, follow with a top title or a full-bleed picture.
85
+ - Keep titles short; a title has about 29 Korean glyphs per line at reading size and two lines at
86
+ most, and a longer one moves the slide to another treatment.
100
87
 
101
88
  ## Avoid
102
89
 
103
- - Numerals as ornaments, such as step numbers on points that are not a sequence.
104
- - Column lines running through text; they belong in the gutters.
105
- - Two `side-rail` slides with the same split back to back.
106
- - Centred body text; every line aligns to the column lines.
107
-
108
- ## Failure patterns
109
-
110
- | Symptom | Cause | Fix |
111
- |---|---|---|
112
- | `note: slide 2: table-insight is not a studio layout family (...); drawn with its own geometry` | a table page in an editorial deck | use `kpi-row`, `big-number` or `comparison`, or choose Ledger |
113
- | `note: slide 1: cover-numeral cannot be drawn (the deck names no year or real figure)`, drawn as `cover-rail` | no year in the title or date | add `date: 2026년 5월` or name another cover |
114
- | a big number with one figure draws a small panel | one figure with no basis row hugs its panel | give two to four figures with bases |
115
- | the side rail leaves most of its column empty (OF-115) | a `title: side-rail` pin on a slide whose takeaways are one line | take `top-plain-large` or write four takeaways |
90
+ - Numerals used as ornaments, such as step numbers on points that are not a sequence.
91
+ - Column lines running through text; they belong in gutters.
92
+ - Two side-rail slides with the same split back to back.
93
+ - Centred body text; Studio aligns everything to the column lines.
116
94
 
117
95
  ## Two worked slides
118
96
 
119
- A portrait picture takes the narrow side and the five lines beside it fill the page; the first line
120
- carries the claim. The title sits across the top and a column line separates the two sides.
97
+ A tall portrait picture takes the narrow side, so the five facts beside it fill the page; the first
98
+ carries the claim.
121
99
 
122
100
  ```markdown
123
101
  ---
124
102
  layout: asymmetric-feature
125
103
 
126
- ## 공방 작업대와 하루의 순서
104
+ ## 1인 가구 이사 주기와 가구 폐기 실태
127
105
 
128
- ![도 1. 오전 아홉 시의 작업대 | 출처: 예시 이미지](assets/example-c.png)
106
+ ![도 1. 이사 철 배출된 가구 | 출처: 예시 이미지](assets/example-c.png)
129
107
 
130
- - 하루는 흙을 치대는 일로 시작한다
131
- - 작업대 하나에서 물레, 유약, 포장까지 모두 한다
132
- - 한 사람이 하루에 빚는 그릇은 평균 18점이다 (예시)
133
- - 유약을 바른 그릇은 일주일 말려 가마에 넣는다
134
- - 가마는 매주 목요일 한 번 불을 땐다
108
+ - 1인 가구는 2년마다 이사하며 가구를 버린다
109
+ - 수도권 1인 가구의 평균 거주 기간은 2.1년이다 (예시 조사)
110
+ - 이사 때 버려지는 가구의 절반은 산 지 3년이 안 된 것이다
111
+ - 대형 폐기물 수수료와 운반비로 한 번에 평균 9만 원을 쓴다
112
+ - 새 집 구조에 맞지 않아 버리는 경우가 가장 많다
135
113
  ---
136
114
  ```
137
115
 
138
- A big number as a panel of three related figures with their bases; the evidence stands in the rail
139
- under the title, and the panel takes the tint.
116
+ A full-bleed picture carries its label title on a panel; the caption, which states what changed,
117
+ stays on the panel with it.
140
118
 
141
119
  ```markdown
142
120
  ---
143
- layout: big-number
144
-
145
- ## 공방 수업과 주문 현황
121
+ layout: image-full
146
122
 
147
- | 정규 수강생 | 재수강 비율 | 단체 주문 |
148
- |---|---|---|
149
- | 64명 | 71% | 12건 |
150
- | 2026년 4월 기준 | 지난 학기 수강생 중 | 올해 1~4월 |
123
+ ## East branch reading room after the renovation
151
124
 
152
- > 공방 운영 현황, 예시 내부 기록 2026년 4월
153
-
154
- - 수강생 열에 일곱은 다음 학기에도 등록한다
155
- - 단체 주문은 카페와 식당에서 가장 많이 들어온다
156
- - 수업 시간표를 주 5일에서 주 6일로 늘릴 계획이다
125
+ ![East branch reading room, now open onto its street (glazed front, 2026) | Source: example image](assets/example-a.png)
157
126
  ---
158
127
  ```
159
128
 
160
- Both slides compile under `tonality: studio` after a generic cover (drawn as `cover-split-image` from the
161
- first picture) and pass `qa_deck.py`, with an `OF-105` and an `OF-109` advisory on the second. The
162
- workshop and its figures are invented; the picture is the bundled example image.
129
+ ## Examples
130
+
131
+ `02-pitch-studio-ko.md`, `11-portfolio-studio-en.md`
@@ -24,8 +24,6 @@ const { load: loadMarkdown } = require("./lib/markdown-loader");
24
24
  const { validate: validateContent } = require("./lib/directive-parser");
25
25
  const { buildBlocks, buildAst } = require("./lib/slide-ast");
26
26
  const { validate: validateAst } = require("./lib/spec-validator");
27
- // Windows has no python3 (the Store alias runs nothing); python.org installs python and the py launcher.
28
- const PYTHON = process.platform === "win32" ? "python" : "python3";
29
27
 
30
28
  // Lazy-loaded modules — may not exist yet (built by another agent)
31
29
  let templateRegistry = null;
@@ -97,7 +95,7 @@ const BUNDLED_FONTS = [
97
95
  /**
98
96
  * Describe a template's visual system for a chart drawn elsewhere.
99
97
  *
100
- * A chart belongs to the lit-scientific-visualization skill, not to this skill, and the
98
+ * A chart belongs to the scientific visualization skill, not to this skill, and the
101
99
  * reason charts end up looking foreign in a deck is that the tool drawing them
102
100
  * cannot see the deck's colours, typeface or canvas. This hands those over.
103
101
  *
@@ -150,7 +148,7 @@ async function resolveAndRender(ast, templateName, outputs, options = {}) {
150
148
  const meta = (ast.deck && ast.deck.metadata) || {};
151
149
  const tonality = options.tonality || meta.tonality || null;
152
150
  const templateObj = tonality
153
- ? templateRegistry.loadTonality(tonality, { density: meta.density, variance: meta.variance, canvas: meta.canvas, faces: options.faces || meta.faces })
151
+ ? templateRegistry.loadTonality(tonality, { density: meta.density, variance: meta.variance, canvas: meta.canvas, faces: options.faces || meta.faces, hero: meta.hero, decoration: meta.decoration })
154
152
  : templateRegistry.loadTemplate(templateName);
155
153
  if (tonality) {
156
154
  const d = templateObj.pack.dials;
@@ -399,7 +397,7 @@ if (require.main === module) {
399
397
  const frontmatter = source.match(/^---[ \t]*\n([\s\S]*?)\n---/);
400
398
  if (frontmatter && /^data:[ \t]*\S/m.test(frontmatter[1])) {
401
399
  const { spawnSync } = require("child_process");
402
- const resolved = spawnSync(PYTHON, ["-B", path.resolve(__dirname, "office_data.py"), "resolve", path.resolve(inputPath)], {
400
+ const resolved = spawnSync("python3", ["-B", path.resolve(__dirname, "office_data.py"), "resolve", path.resolve(inputPath)], {
403
401
  encoding: "utf8",
404
402
  });
405
403
  if (resolved.status !== 0) {
@@ -445,7 +443,7 @@ if (require.main === module) {
445
443
  // Optional: embed bundled fonts into the PPTX for a self-contained deck.
446
444
  if (embedFonts && pptxPath) {
447
445
  const { execFileSync } = require("child_process");
448
- execFileSync(PYTHON, [path.join(__dirname, "embed_fonts.py"), pptxPath], {
446
+ execFileSync("python3", [path.join(__dirname, "embed_fonts.py"), pptxPath], {
449
447
  stdio: "inherit",
450
448
  });
451
449
  }