@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,298 +1,194 @@
1
1
  # Layout families
2
2
 
3
- A layout family is a slide's job turned into a fixed shape on the 12-column grid. The source names it
4
- on the `layout:` line; the tonality decides how that shape is drawn: which title treatments it takes,
5
- the table and chart style, the rules and fields around it. The engine holds 28 content families, 9
6
- cover variants, 6 section variants and 5 closing variants. Each pack lists the subset that suits its
7
- character, and a source that asks a pack for something outside the list gets a `note:` line in the
8
- compile log and a drawing with the family's own geometry under the pack's role title.
3
+ A layout family is a slide's job turned into a fixed shape on the 12-column grid. The source names
4
+ it on the `layout:` line, and the tonality decides how it is drawn: which title treatments it may
5
+ take, the table and chart style, the rules and fields around it. Twenty-eight families exist; each
6
+ pack implements the ones that suit its character, and the compile stops or notes a substitution when
7
+ a source asks a pack for a family it does not have.
9
8
 
10
- Choose the family from the job of the slide. A deck reads as varied when its slides do different jobs
11
- and each job takes its own shape; the gate measures this on the compiled file (OF-111) and fails a
12
- deck whose content slides share one composition.
9
+ Pick the family from what the slide has to do, never from what the previous slide used. A deck
10
+ reads as varied when its slides do different jobs and each job gets its own shape; the gate checks
11
+ that from the compiled file (OF-111) and fails a deck whose content slides share one composition.
13
12
 
14
- Excerpts in this file are shown between rules, as they sit in a deck source: each slide starts with
15
- `layout:`, the optional `title:` key follows, then the `##` title and the content. Ask the engine what
16
- a pack offers before writing:
13
+ List what a pack offers before writing:
17
14
 
18
15
  ```bash
19
16
  node "$SKILL_ROOT/scripts/compile-deck.js" --list-tonalities
20
- node "$SKILL_ROOT/scripts/compile-deck.js" --list-layouts ledger # families with their titles, then covers, sections, closings
17
+ node "$SKILL_ROOT/scripts/compile-deck.js" --list-layouts ledger # families, the titles each allows, variants
21
18
  ```
22
19
 
23
20
  ## Content families
24
21
 
25
- "Titles" lists the treatments the family accepts in any pack; a pack narrows the list to its own
26
- treatments. "Role" picks the pack's default title (`role-defaults`).
22
+ Each row says what the family is for, what the source gives it, and which packs carry it.
27
23
 
28
- | Family | Role | Job | Source it reads | Packs | Titles |
29
- |---|---|---|---|---|---|
30
- | `text-column` | content | running text or a short list at reading measure | bullets or bold-headed groups; an image turns it into a picture-and-text split | atlas, chalk, paper, gazette | top-rule, band, kicker-numeral, side-rail, top-plain-large |
31
- | `text-two-column` | content | a long list with two parallel halves | bullets, cut near the middle at a group boundary, or `:::: columns` | ledger, gazette, studio | top-rule, band, kicker-numeral, top-plain-large |
32
- | `summary-box-list` | content | a boxed conclusion over two columns of evidence | `::: key-message`, else the first paragraph, then groups | gazette | band, top-rule, kicker-numeral |
33
- | `sidebar-note` | content | a main point with a fenced note: the definition or the common mistake | body, then a `::: main-box` (else the last text block) that becomes the note | chalk | top-rule, kicker-numeral, band, side-rail |
34
- | `agenda` | content | the parts of the deck, numbered 01, 02 ... | `- **Part** what it covers` lines | ledger, chalk, gazette | top-rule, kicker-numeral, band, top-plain-large, side-rail |
35
- | `statement` | statement | one sentence at display size | the `##` text is the sentence; one body line becomes the support line | signal, atlas, chalk, paper, studio, night | statement |
36
- | `quote` | statement | a quoted sentence with its source | the quote as a text line, the source as a line that opens with `—` | signal, chalk, paper | statement, top-rule |
37
- | `kpi-row` | data | two to six headline numbers | a one-row table of short values, an optional second row with each figure's basis | ledger, signal, atlas, studio, night | top-rule, band, top-plain-large, side-rail, bottom-anchor |
38
- | `kpi-over-chart` | data | headline numbers above the trend that explains them | a KPI table, then a `::: chart` block | ledger, night | top-rule, band, top-plain-large |
39
- | `dashboard-grid` | data | two to four small charts read together | two or more `::: chart` blocks plus one takeaway line | ledger, night | top-rule, band, side-rail |
40
- | `table-insight` | data | a table with its takeaways beside it | a pipe table with a `>` caption, then bullets | ledger, signal, chalk, paper, gazette | top-rule, band, side-rail, bottom-anchor |
41
- | `ledger-table` | data | a full-width table that is the evidence | a wide table with its caption, then takeaway bullets under it | ledger, gazette | top-rule, band, kicker-numeral |
42
- | `matrix-2x2` | data | options placed on two axes | a 3-column, 2-row table (see below) | ledger, gazette | top-rule, band, side-rail |
43
- | `comparison` | data or content | two sides read across, point by point | `:::: columns` with one head and numbered points per side | all eight | top-rule, band, top-plain-large, side-rail, bottom-anchor |
44
- | `chart-insight` | data-takeaway | a chart with two or three takeaways | a `::: chart` block (or a numeric table of three or more rows), then bullets | ledger, signal, paper, studio, night | top-rule, band, side-rail, bottom-anchor, top-plain-large |
45
- | `full-chart` | data-takeaway | one chart that needs the whole width | a `::: chart` block and an optional note | ledger, signal, paper, night | bottom-anchor, top-plain-large, top-rule |
46
- | `big-number` | data-takeaway | a panel of related figures with evidence beside it | a KPI table (labels in the head, values in row one, basis in row two), then bullets | ledger, signal, studio, night | top-rule, side-rail, bottom-anchor, top-plain-large |
47
- | `process` | sequence | three to five steps in order | `- **1. Step** what happens` lines | signal, chalk | top-rule, band, top-plain-large, side-rail |
48
- | `step-diagram` | sequence | steps taught one by one | as `process` | chalk | top-rule, top-plain-large, band |
49
- | `timeline` | sequence | up to six dated events on one axis | a table of date, event, status rows, or `- **date** event` lines | ledger, atlas, gazette, studio, night | top-rule, band, top-plain-large, bottom-anchor |
50
- | `method` | definition | a figure or formula with its definitions | an image or text lines, then `- **term** meaning` bullets | chalk, paper, night | top-rule, side-rail, band |
51
- | `image-full` | image | one picture as the page | an image with a caption | atlas, studio | overlay |
52
- | `image-split` | image | a picture beside its explanation | an image, then bullets | signal, atlas, chalk, studio | top-plain-large, side-rail, bottom-anchor, top-rule |
53
- | `photo-grid` | image | two or three pictures compared | two or three image lines, then one line of text | atlas, studio | top-plain-large, bottom-anchor, top-rule |
54
- | `figure-pair` | image | before and after, or two conditions | two images, then one line of text | atlas, paper | top-rule, bottom-anchor, side-rail |
55
- | `figure-academic` | image | a numbered figure with its reading | an image with numbered caption and source, then bullets | paper | top-rule, bottom-anchor, side-rail |
56
- | `asymmetric-feature` | image | one visual and a column of argument | an image or a one-row table, then bullets | signal, atlas, studio | top-plain-large, bottom-anchor, top-rule |
57
- | `references-appendix` | reference | sources, one per row | `- [1] ...` lines; links as Markdown links | ledger, gazette, paper | top-rule, band |
58
-
59
- Legacy layout names keep working under a tonality: `content` and `main` become `text-column`,
60
- `summary` becomes `comparison`, `free` becomes `text-column`, and `cover`, `section` and `closing`
61
- ask for the pack's first variant that the deck can draw. `cover-split` is read as `cover-split-field`.
62
- A name the engine does not know stops the compile with the full list of families.
63
-
64
- ## Per-family syntax
65
-
66
- **Table-led families.** A pipe table with a `>` line under it becomes a captioned table; the engine
67
- numbers the caption in the deck's language ("표 1.", "Table 1.") and renumbers a typed number instead of
68
- doubling it. Takeaway bullets follow. A line that opens with `출처:`, `자료:`, `주:`, `Source:` or
69
- `Note:` leaves the takeaways and sets as a source strip at the foot of the body.
70
-
71
- **`kpi-row` and `big-number`.** Two to six headers; one row of values; a second row of bases. A cell
72
- of the first row holds at most 12 characters and a basis at most 24, otherwise the table stays a
73
- table.
74
-
75
- ```markdown
76
- ---
77
- layout: kpi-row
78
-
79
- ## 3분기 이용 지표
80
-
81
- | 방문자 | 대출 권수 | 신규 회원 | 좌석 점유율 |
24
+ | Family | Job | Source it reads | Packs |
82
25
  |---|---|---|---|
83
- | 18.2만 명 | 41.0만 권 | 6,320명 | 78% |
84
- | 전년 동기 +12% | 전년 동기 +9% | 목표 6,000명 | 목표 75% |
85
-
86
- > 3분기 이용 지표 (예시 데이터)
87
-
88
- - 방문자와 대출이 모두 늘었고 신규 회원은 목표를 넘었다
89
- - 좌석 점유율은 개관 이후 처음 목표를 넘었다
90
- - 출처: 예시 이용 통계 시스템, 2026년 9월 말
91
- ---
92
- ```
93
-
94
- **`comparison`.** Two `::: col` blocks inside `:::: columns 1fr 1fr`. Each side opens with a bold head
95
- (`- **계획**`) and carries numbered points. When every point on both sides opens with a short label
96
- and a colon (`비용: ...`, at most three words), the labels leave the sides and stand once as a
97
- criteria column; under a side title they sit in the rail level with their rows. Without `columns`,
98
- the bullets split into two halves by entry. Halves heavy with digits (4 % of the text or more) take
99
- the pack's `data` title, others the `content` title.
100
-
101
- **`matrix-2x2`.** Header cell `영향 \ 난이도` names the vertical axis first and the horizontal axis
102
- second; the other two header cells name the columns; the first cell of each body row names the row.
103
- Each quadrant holds `item · detail · detail`: the item becomes the cell head and each detail a line.
104
-
105
- ```markdown
106
- ---
107
- layout: matrix-2x2
108
-
109
- ## 개선 과제 우선순위
110
-
111
- | 효과 \ 난이도 | 쉬움 | 어려움 |
112
- |---|---|---|
113
- | 큼 | 좌석 예약 안내 · 즉시 · 운영팀 | 서가 재배치 · 3개월 · 예산 필요 |
114
- | 작음 | 안내문 교체 · 이번 주 | 시스템 교체 · 보류 |
115
-
116
- > 효과와 난이도로 본 과제 (예시)
117
-
118
- - 효과가 크고 쉬운 과제부터 이번 달에 시작한다
119
- - 서가 재배치는 설계에 3개월이 걸려 다음 분기 예산에 넣는다
120
- - 효과가 작고 어려운 시스템 교체는 보류하고 연말에 다시 본다
121
- - 담당과 시점은 각 칸의 둘째, 셋째 줄에 적은 대로 확정한다
122
- ---
123
- ```
124
-
125
- The takeaways stand in the four columns beside the matrix, so three or four lines keep that column as
126
- long as the quadrants (a single line leaves it 86 % empty and fails OF-115). Any other table shape
127
- falls back to `table-insight`.
128
-
129
- **`process`, `step-diagram`, `agenda`, `timeline`.** Steps are bold-headed bullets; a leading `1.` in the
130
- head becomes the numeral, otherwise the position does. Points without a bold head that follow two or
131
- more steps become takeaways under the steps. A timeline reads a table whose first column is the date,
132
- the second the event and the rest the status, or bullets whose bold head is the date and whose
133
- children are the status. More than six events keep the first six.
134
-
135
- **`quote` and `statement`.** The quote line and a `—` source line:
136
-
137
- ```markdown
138
- ---
139
- layout: quote
140
-
141
- ## 이용자 한마디
142
-
143
- “창가 자리가 생긴 뒤로 매일 저녁 이곳에서 공부한다”
144
-
145
- — 예시 이용자, 고등학생
146
- ---
147
- ```
148
-
149
- The sentence sits in the title slot, so a `statement` title should be a quotation (a leading “ is
150
- read as a quote) or a noun phrase; a plain declarative sentence is flagged by OF-114.
151
-
152
- **`image-*` and `figure-*`.** The alt text of `![...](path)` is the caption and may carry a source
153
- after a bar: `![도 1. 창가 좌석 | 출처: 예시 이미지](assets/example-b.png)`. Consecutive image lines
154
- fill a `photo-grid` (up to three) or a `figure-pair` (two). `image-full` needs a picture and takes
155
- only `overlay`; a source without one stops the compile with "choose another layout family".
156
-
157
- **`method`.** Plain text lines are the formula or the statement of the method (set at title size in
158
- the accent-deep colour); bold-headed bullets are the terms, split into two or three columns when a
159
- figure does not stand beside them.
160
-
161
- **`sidebar-note`.** Main points as bullets and the note as a `::: main-box ... :::` block. A note
162
- short for its column moves across the top at lead size with the points in two columns below; under a
163
- side title it stands in the rail.
164
-
165
- **`summary-box-list`.** A `::: key-message` block of one to three lines becomes the box; bold-headed
166
- groups under it split into two columns at the boundary that evens them out.
167
-
168
- **`references-appendix`.** One entry per row, at reading size; a list longer than the body steps to
169
- label size and then to two columns. Markdown links keep their address.
26
+ | `text-column` | running text or a short list that keeps its measure | bullets or 개조식 groups; an image moves it to a picture-and-text split | atlas, chalk, paper, gazette |
27
+ | `text-two-column` | a long list with two parallel halves | bullets, split at a group boundary near the middle, or `:::: columns` | ledger, gazette, studio |
28
+ | `summary-box-list` | a boxed one-line conclusion over two columns of evidence | `::: key-message` (or the first line) for the box, groups under it | gazette |
29
+ | `sidebar-note` | a main point with a fenced note: the definition or the common mistake; a note too short for its column stands across the top at lead size with the main points in two columns under it, and under a side title it stands in the rail | body, then a `::: main-box` (or a last list) that becomes the note | chalk |
30
+ | `agenda` | the parts of the deck, numbered | `- **Part** what it covers` lines | ledger, chalk, gazette |
31
+ | `statement` | a pull quote, or a display-led deck the user asked for | the `##` text is set as the sentence (a label in the default rules; OF-114 fails a declarative title); one body line becomes the support line | signal, chalk, paper, night, atlas, studio |
32
+ | `quote` | a quoted sentence with its source | the quote as a text line, the source as a line starting with `—` | signal, chalk, paper |
33
+ | `kpi-row` | two to six headline numbers | a one-row table of short values, a second row with each figure's basis, plus bullets for evidence | ledger, signal, atlas, studio, night |
34
+ | `kpi-over-chart` | headline numbers above the trend that explains them | a one-row KPI table, then a `::: chart` block | ledger, night |
35
+ | `dashboard-grid` | two to four small charts read together | two or more `::: chart` blocks, plus one line of takeaway | ledger, night |
36
+ | `table-insight` | a table with its takeaway beside it | a pipe table with a `>` caption, then bullets | ledger, signal, chalk, paper, gazette |
37
+ | `ledger-table` | a full-width table that is the evidence | a wider table with a caption, then takeaway bullets under it | ledger, gazette |
38
+ | `matrix-2x2` | options placed on two axes | a 3 × 3 table: corner cell `영향 \ 난이도`, two column heads, two row heads; cells `item · detail · detail`; takeaways after the caption | ledger, gazette |
39
+ | `comparison` | two sides read across, point by point | `:::: columns` with a `**head**` and `(1)` `(2)` items per side; `비용: …` labels on both sides become a criteria column, in the rail under a side title; a label of more than three words is not read as a label, so the slide keeps its points whole and nothing goes to the rail | all eight |
40
+ | `chart-insight` | a chart with two or three takeaways | a `::: chart` block (or a data table), then bullets | ledger, signal, paper, studio, night |
41
+ | `full-chart` | one chart that needs the whole width | a `::: chart` block, an optional note under it | ledger, signal, paper, night |
42
+ | `big-number` | one real figure that carries the slide | a one-cell table (label in the head, value in the row), then 2-3 evidence bullets | ledger, signal, studio, night |
43
+ | `process` | three to five steps in order | `- **1. 단계** what happens` lines | signal, chalk |
44
+ | `step-diagram` | steps taught one by one | as `process` | chalk |
45
+ | `timeline` | dated events on one axis | a table of `시점 | 할 일 | 담당` rows (or `- **date** event`), then takeaway bullets | ledger, atlas, gazette, studio, night |
46
+ | `method` | a figure or formula with its definitions | an image or a text line, then `- **term** meaning` bullets | chalk, paper, night |
47
+ | `image-full` | one picture as the slide, title on a panel | an image with a caption (`도 1. … \| 출처: …`) | atlas, studio |
48
+ | `image-split` | a picture beside its explanation | an image, then bullets | signal, atlas, chalk, studio |
49
+ | `photo-grid` | two or three pictures compared | two or three images on consecutive lines, then one line of text | atlas, studio |
50
+ | `figure-pair` | before and after, or two conditions | two images, then one line of text | atlas, paper |
51
+ | `figure-academic` | a numbered figure with its reading | an image with a numbered caption and source, then observation, basis, implication bullets | paper |
52
+ | `asymmetric-feature` | a feature told by one large element and a narrow text column | an image or a one-cell figure, then bullets | signal, atlas, studio |
53
+ | `references-appendix` | sources and definitions, one per row | `- [1] …` lines; links as real Markdown links | ledger, paper, gazette |
54
+
55
+ Legacy layout names still work under a tonality: `content` and `main` become `text-column`,
56
+ `summary` becomes `comparison`, and `cover`, `section` and `closing` ask for one of the pack's own
57
+ variants (the compile notes which one it drew).
170
58
 
171
59
  ## Covers, sections and closings
172
60
 
173
- The source names a variant (`layout: cover-figures`). The engine draws it when the pack lists it and
174
- the deck holds what it needs, else it takes the pack's first variant that can be drawn and logs
175
- `note: slide 1: cover-figures cannot be drawn (the deck has no row of headline numbers)` and
176
- `note: slide 1: drawn as cover-typographic`. A title on a cover or section comes from the `##` line;
177
- the frontmatter keys `subtitle`, `date`, `department` and `presenter` fill the meta lines.
61
+ These are variants. The source names one (`layout: cover-figures`); the engine draws it when the
62
+ pack lists it and the deck holds what it needs, or takes the pack's first variant that can be
63
+ drawn and notes why. A generic `cover`, `section` or `closing` asks for the pack's first choice.
178
64
 
179
65
  | Variant | What it shows | Needs | Packs |
180
66
  |---|---|---|---|
181
- | `cover-typographic` | the title large, carried by the pack's cover device (next section) | nothing | atlas, chalk, gazette, ledger, night, paper, signal |
182
- | `cover-figures` | the title over the deck's first KPI row (up to four figures) | a non-chart KPI table with two or more values | ledger, night |
183
- | `cover-index` | the title beside the numbered list of parts | an agenda, or two or more sections | ledger, paper, gazette |
184
- | `cover-numeral` | a year at title size above the title | a four-digit year in the deck title or `date` | signal, chalk, studio, night |
185
- | `cover-split-field` | the title beside a field over the right five columns | nothing | signal |
186
- | `cover-split-image` | the title beside the deck's first picture | an image anywhere in the deck | atlas, paper, studio |
67
+ | `cover-typographic` | the title large, carried by the pack's cover device (see Display slides) | nothing | ledger, signal, atlas, chalk, paper, gazette, night |
68
+ | `cover-figures` | the title over the deck's headline numbers | a KPI row somewhere in the deck | ledger, night |
69
+ | `cover-index` | the title beside the list of parts | an agenda or two or more sections | ledger, paper, gazette |
70
+ | `cover-numeral` | a real year or figure at title size above the title | a year in the title or date | signal, chalk, studio, night |
71
+ | `cover-split-field` | half the page in the accent field | nothing | signal |
72
+ | `cover-split-image` | the title beside the deck's first picture | an image somewhere in the deck | atlas, paper, studio |
187
73
  | `cover-full-image` | the first picture full-bleed with the title on a panel | an image | atlas |
188
- | `cover-band` | the title in a 216 pt field band, the parts or figures across the page below | nothing | gazette |
189
- | `cover-rail` | the title beside a field rail over columns 1-4 | nothing | chalk, studio |
190
- | `section-field` | the part title on a full field | nothing | signal, atlas, paper, night |
191
- | `section-numeral` | part numeral and title; with an agenda, the index page | nothing | ledger, signal, chalk, studio, night |
192
- | `section-rule` | with an agenda, an index page; without one, the title at the cover step over a hairline | nothing | ledger, paper, gazette |
193
- | `section-rail` | the part title beside the rail, the numeral or the contents in the rail | nothing | chalk, studio |
194
- | `section-band` | a field band holding the part index, the part title as a statement below | nothing | gazette |
74
+ | `cover-band` | the title under a strong head band | nothing | gazette |
75
+ | `cover-rail` | the title in a tinted left rail | nothing | chalk, studio |
76
+ | `section-field` | the part title on a colour field | nothing | signal, atlas, paper, night |
77
+ | `section-numeral` | the part number at title size beside its title, with the part count when the agenda gives it; with the agenda, the `section-rule` index page (numeral, title, the agenda with this part marked) | nothing | ledger, signal, chalk, studio, night |
78
+ | `section-rule` | with an agenda, an index page: the part numeral at title size over the part title, the agenda down the right columns with this part marked; without one, the title at the cover step over a hairline and the section's first slide titles | nothing | ledger, paper, gazette |
79
+ | `section-rail` | the part title in the rail | nothing | chalk, studio |
80
+ | `section-band` | the band holds the part index; under it the part title as a statement over the titles of the slides the part opens | nothing | gazette |
195
81
  | `section-image` | the part title on the section's own picture | an image on that slide | atlas |
196
- | `closing-ask` | the ask as the title, its table as action rows, the next step on the floor | a table or bullets | ledger, signal, atlas, chalk, paper, gazette |
197
- | `closing-decision-box` | the decision in a box, the items to approve as action rows under it | a line or bullets, an optional table | ledger, gazette, night |
198
- | `closing-statement` | one closing sentence | text only | signal, night |
199
- | `closing-summary-list` | the takeaways numbered down the page | bullets, or a visual with a short list | chalk, paper, studio |
200
- | `closing-contact-split` | action rows beside a field that holds each row's key | a table or bullets | atlas, studio |
201
-
202
- A closing is a content slide whose title is the ask: "건의 사항: 결정 요청 사항과 기한" or "18개월 운영
203
- 자금 30억 원 사용 계획". "감사합니다" alone leaves the audience without a decision. Closings other than
204
- `closing-statement` take the top treatments (`top-rule`, `band`, `top-plain-large`).
82
+ | `closing-ask` | the ask as the title, its table as action rows keyed by amount or date, the next step on the floor | a table or bullets | ledger, signal, atlas, chalk, paper, gazette |
83
+ | `closing-decision-box` | the decision in a box, the items to approve under it | a line or bullets, an optional table | ledger, gazette, night |
84
+ | `closing-statement` | one closing sentence | no table or image | signal, night |
85
+ | `closing-summary-list` | the takeaways numbered down the page | bullets (or a visual with a short list) | chalk, paper, studio |
86
+ | `closing-contact-split` | action rows beside a field that holds each row's amount or date (with its share bar), inset from its edges; the next step or contact runs as a band of the field's colour on the body floor across the left columns, meeting the field so the two read as one L; without a table, the ask beside a field with the contact | a table or bullets, plus a short text | atlas, studio |
205
87
 
206
- ### Section numbering
207
-
208
- A section numbers itself by its place in the agenda when its title equals an agenda entry or that
209
- entry's description ("03 / 04"). In a deck with two or more sections and no agenda it counts the
210
- sections. A deck with one section and no agenda has no part count: the title is set at the cover step
211
- as a statement and the titles of the slides it opens stand under it. When those slides carry body
212
- lines, each title stands over at most two of them, in a column from the margin that spans at most 70 %
213
- of the page and about 70 characters (8 columns in a Korean deck, 6 in an English one on the compact
214
- grid); a bold run-in label keeps its weight and gains its colon.
215
-
216
- ### Closing rows
217
-
218
- A closing's table becomes action rows (at most five, a totals row dropped). The key is the column of
219
- amounts in one unit ("14억 원", or a bare number under a header such as `금액 (억 원)`), else the column
220
- whose header reads as a date or deadline (`기한`, `시점`, `일정`, `마감`, `date`, `due`), else the last
221
- column. The first cell is the action in bold at lead size; the other cells form its detail line. Amount
222
- keys also draw a bar for each row's share of the total, and `closing-contact-split` closes its field with
223
- "합계 30억 원" (or, for dates, "안건 4건 · 10월 – 11월"). Rows that cannot fit above the next step keep the
224
- plain table.
88
+ A closing is a content slide whose title is the ask. "감사합니다" alone is never a closing; write
89
+ what the audience should decide or do, and who does what next by when.
225
90
 
226
91
  ## Display slides
227
92
 
228
93
  Covers, statements, sections, big numbers and closings carry little text, so each pack names the
229
- device that lets the slide hold its page (`display:` in the pack). A device frames what the deck
230
- holds; it adds no words or numbers.
94
+ device that makes the slide hold its page (`display:` in the pack). The device encodes something
95
+ in the deck or frames what is there; it never adds words or numbers the source does not hold.
231
96
 
232
97
  | Key | Device | What it draws | Packs |
233
98
  |---|---|---|---|
234
- | `cover` | `drench` | the field over the page, the title at the cover step in up to three balanced lines, anchored low | signal |
235
- | `cover` | `plate` | a field plate from y 288 to the foot, the title on it in at most two lines, the meta line above | atlas |
236
- | `cover` | `rail`, `band`, `figures`, `numeral` | the pack's `cover-rail`, `cover-band`, `cover-figures` or `cover-numeral` when the deck has what it needs, else the plain cover | chalk, gazette, ledger, night |
237
- | `cover` | `rules` | a journal title page: a heavy rule, the title, a hairline, the presenter, place and date | paper |
238
- | `statement` | `open` | the sentence alone at the display step | signal, night |
239
- | `statement` | `drench` | the whole page in the field, the sentence in the field's text colour | chalk, atlas |
240
- | `statement` | `rules` | a hairline above the sentence and one under its support line | paper, studio |
241
- | `number` | `field`, `tint`, `outline` | the panel behind a big number: the field, the accent tint, or the surface in an ink outline | signal / ledger, studio, atlas, chalk, night / gazette, paper |
242
- | `closing` | `band`, `box`, `rules` | the next step on the body floor: a field band, a tinted (or outlined) box, or a hairline above the line | signal, studio, atlas, night / ledger, gazette, chalk / paper |
243
- | `index` | `true` | section slides show the deck's parts with this part marked | ledger, gazette, paper |
244
-
245
- The engine also supports the devices `plain`, a `plate` statement and an `offset` statement; no
246
- shipped pack uses them. Things the engine settles from the deck, whatever the device:
247
-
248
- - Every title that wraps is broken into lines of near-equal width; the last line keeps two words when
249
- a split allows it, and a number stays with the word after it ("30억 원을", "4 분기").
250
- - Body text and table cells that wrap are broken at spaces, filling each line in turn, so a figure keeps
251
- its unit; a short parenthetical such as "(▲ +3.9%)" (up to 16 characters) stays on one line.
252
- - A big number is a data panel: seven of twelve columns (five of eight beside a rail), one row per
253
- figure at title size at most with its label and basis, the evidence beside it as plain notes. A single
254
- figure sits on a panel as tall as it is. No figure reaches the display, cover or hero step.
99
+ | `cover` | `drench` | the field over the whole page, the title at the cover step in up to three balanced lines, anchored low | signal, computational-brutalism, riso |
100
+ | `cover` | `plate` | a field plate over a little under half the page, the title on it in at most two lines; the date line above | atlas, neo-brutalism |
101
+ | `cover` | `rail`, `band` | the pack's `cover-rail` or `cover-band` | chalk, gazette, newsroom |
102
+ | `cover` | `figures` | `cover-figures` when the deck has a KPI row, else the plain cover | ledger |
103
+ | `cover` | `numeral` | `cover-numeral` with the year from the title or date | night |
104
+ | `cover` | `rules` | a journal title page: a heavy rule, the title, a hairline, the presenter, then place and date | paper |
105
+ | `cover` | `geometry` | the title on the left half and an elementary composition on the right half, each shape in its own grid cell: a square in the accent tint, a circle in the accent, a bar in ink, a triangle in the field | bauhaus |
106
+ | `statement` | `open` | the sentence alone, at the display step | signal, night |
107
+ | `statement` | `drench` | the whole slide in the field, the sentence in the field's text colour | chalk, atlas, computational-brutalism, neo-brutalism, riso |
108
+ | `statement` | `plate` | the sentence set low on a field plate that covers less than half the page; a sentence too tall for it keeps the open page | no pack (Atlas takes `drench`) |
109
+ | `statement` | `rules` | a hairline above the sentence and one under its support line | paper, studio, newsroom |
110
+ | `statement` | `geometry` | the sentence on the left and a narrower composition from column 10 to the edge; a quote and a closing statement take it too | bauhaus |
111
+ | `statement` | `offset` | the sentence in columns 5-12 beside a rail that stops a column short of it | no pack (the empty rail read as decoration; Studio takes `rules`) |
112
+ | `number` | `field`, `tint`, `outline` | the panel behind a big number: the field, the accent tint, or the surface in an ink outline | signal, neo-brutalism, bauhaus, riso / ledger, studio, atlas, chalk, night, newsroom / gazette, paper, computational-brutalism |
113
+ | `closing` | `band`, `box`, `rules` | the next step on the body floor: a field band across the grid, a tinted (or outlined) box, or a rule above it | signal, studio, atlas, night, riso / ledger, gazette, chalk, computational-brutalism, neo-brutalism / paper, bauhaus, newsroom |
114
+ | `index` | `true` | section slides show the deck's parts, this part marked: one per line on a `section-rule` index page, in one line inside the `section-band` band | ledger, gazette, paper, newsroom |
115
+
116
+ What the engine reads from the deck, never from the device:
117
+
118
+ - Every title that wraps (content, closing, statement, cover, section) is broken into lines of
119
+ near-equal width; the last line keeps two words whenever a split allows it (with a line more
120
+ when the frame holds it), and a number stays with the word after it ("30억 원을", "4 분기").
121
+ - Body text and table cells that wrap are broken at spaces by the engine, filling each line in
122
+ turn, so a number keeps its unit and a word stays whole: a renderer's own line breaking may split
123
+ "51점" or "(10월" after the digits, and a short parenthetical ("(▲ +3.9%)", up to 16 characters)
124
+ stays whole on its line. A one-word last line takes a word from the line above when
125
+ it fits; text that would need more lines than its frame holds is left to the renderer.
126
+ - A section numbers itself by its place in the agenda when its title is an agenda entry or that
127
+ entry's description ("03 / 04"); otherwise, in a deck of several sections, it counts them. A
128
+ deck with one section and no agenda has no part count, so no numeral is drawn: the section
129
+ title is set at the cover step as a statement, with the titles of the slides it opens under it.
130
+ When those slides carry body lines, each title stands over at most two of its lines in a column
131
+ that starts at the margin and stays within 70 % of the page and about 70 characters (8 columns
132
+ for a Korean deck, 6 for an English one); a line that opens with a bold label keeps it bold with
133
+ its colon ("**결과:** 공부 시간이 …").
134
+ - A closing's table becomes action rows. The key is the column of amounts in one unit (each row
135
+ then draws a bar for its share of the ask), else the column headed as a date or deadline, else
136
+ the last column. Rows that do not fit step their text and then their key down the ramp; only
137
+ rows that still do not fit above the next step keep the table.
138
+ - `cover-band` runs the deck's parts (else its headline figures) across the page under the band.
139
+ - A big number is a data panel: two to four figures from a KPI table (labels, values, a second row
140
+ with each figure's basis), one row per figure at title size at most, the evidence beside the panel.
141
+ One figure alone sits on a panel as tall as it is. No figure takes the display, cover or hero step.
142
+ - A big number's panel takes seven of twelve columns (five of eight beside a rail), never more
143
+ than half the page; the evidence stands beside it as plain notes, centred on the panel.
255
144
  - A dark plate, rail or panel that is not the whole page covers less than half of it, so the page
256
- keeps its ground colour and the device reads as something placed on it.
257
- - `cover-band` runs the deck's parts (else its headline figures) under the band, up to four across.
258
-
259
- ## Fill behaviour
260
-
261
- The compile lays each slide out, measures the empty band under the last block, and compares it with
262
- the density cap (0.12 at density 9 and 10, 0.14 at 7-8, 0.18 at 5-6, 0.24 at 3-4, 0.28 at 1-2). A slide
263
- over the cap tries the pack's `fill-order` in turn: `step-up` (one ramp step larger, available up to
264
- density 8), `distribute` (the next spacing step), `anchor-visual` (the visual takes the room) and
265
- `change-family` (a different title, chosen by the treatment pass). The log line reads
266
- `fill: slide 6 band 0.59 -> 0.59 (none: nothing on the slide can grow; choose a fuller family)` when
267
- nothing helped; the fix is content that reaches the floor or a family that fits it.
268
-
269
- Short content spreads without invented text: a process of up to four steps runs as rows down the
270
- body; two to five points that each open with a bold head become rows with the head beside the point;
271
- sub-point groups under bold heads run in two columns; a table's takeaways stand midway in the room
272
- under the table, and the table's rows open by up to one minimum row each. The compact step (density
273
- 10, the default) keeps type at body size, turns a short card row into figure rows beside the
274
- takeaways, reads a process row across, sets a method formula over its terms in two columns, puts a
275
- chart's values in a small table under the takeaways, and closes every data slide with the source
276
- strip. Takeaways that leave more than 40 % of their column empty beside a longer visual step up to
277
- lead size, the one place the compact step enlarges type.
278
-
279
- ## Families under different titles
280
-
281
- - Under `side-rail`, the rail under the title carries the slide's supporting content: a comparison's
282
- criteria, the takeaways of a chart, picture, figure rows or number panel, and the source strip at
283
- its foot; the visual takes columns 5-12. A rail more than 40 % empty makes the title unfit unless
284
- `title: side-rail` pins it, and then OF-115 fails the slide.
285
- - Under `bottom-anchor`, the visual takes the top and the title explains it from below with its last
286
- line on the floor; a big number stands on its panel there. A table receives a bottom title only when
287
- no other title fits.
288
- - Under `band`, the body starts below the band and runs to the floor at reading size.
289
- - A `quote` under `statement` sets the quotation as the slide's sentence and the source as its support
290
- line.
145
+ keeps its own ground colour and the device reads as something placed on it.
146
+ - `closing-decision-box` with a table keeps its decision box on top and runs the items to decide
147
+ as the same action rows under it, down to the floor.
148
+
149
+ ## How a deck keeps its variety
150
+
151
+ The compile picks each slide's title by how well the body fills, then checks the deck as the
152
+ composition check reads it (title zone × column partition over the content slides, closings
153
+ left out). When fewer distinct layouts appear than the check asks for, a data slide whose layout
154
+ another slide already has moves to a title that gives a new one, provided it neither overflows nor
155
+ leaves more than the density band empty; the log says `variety: slide N drawn under <title> so the
156
+ deck carries K layouts`. List markers are small dots drawn beside the line, so a list reads as one
157
+ column of text and not as a column of markers next to it.
158
+
159
+ Short content spreads rather than stopping at the top: a process of up to four steps runs as rows
160
+ down the body, two to five points that each open with a bold head become rows with the head beside
161
+ the point, groups of sub-points under bold heads run in two columns on the reading ramp, a
162
+ two-row comparison sets its points a step or two larger, and a table's takeaways stand midway in
163
+ the room under the table. The compact step (density 10) never enlarges type to fill: there a short
164
+ card row becomes figure rows beside the takeaways, a process row reads across (numeral, name, what
165
+ happens), a method slide sets the formula across the top over its terms in two columns, a chart
166
+ shows its values as a small table under the takeaways, and every data slide closes with the source
167
+ strip, set at the foot of the takeaway column when that column ends above the visual beside it (else
168
+ across the body's foot). Takeaways that still leave more than 40 % of their column, or of a side
169
+ title's rail, empty beside a longer visual are set one step up (lead): the one place the compact
170
+ step scales type, and only within the ramp. A process row does the same when what happens would
171
+ stop short of the body's last quarter, so the rows reach across. Terms too long for the column beside
172
+ a method figure first try half and half, which keeps the figure large enough to read. A closing
173
+ summary list ends with its source as the strip, not as a numbered row.
174
+
175
+ ## Families under a title
176
+
177
+ A family keeps its body in the same place under every treatment:
178
+
179
+ - No treatment moves the title or the body: every one draws in the slide grid's title zone, and
180
+ the body runs from y 120 to the floor whichever treatment sits over it. What changes is the
181
+ look over the title (a margin bar, a field band, a heavy rule, a numeral), so a deck's variety
182
+ comes from the families and the treatments' surfaces, not from content moving around the page.
183
+ - `bottom-anchor` belongs to a page led by its visual; a table never takes it while another
184
+ title fits.
185
+ - A `quote` under `statement` sets the quotation itself as the slide's sentence, with the source as
186
+ the support line; the heading of the source slide is not shown.
291
187
 
292
188
  ## When the compile log names a change
293
189
 
294
- `note:` lines explain each substitution: a family the pack lacks, a variant that cannot be drawn, a
295
- title moved for fill or for its glyph budget, a pack without a statement title (`ledger has no statement
296
- title, so the sentence is drawn as a top-rule title`). `variety:` lines name moves made for the deck's
297
- composition. Read both after every compile. A note means the source asked for something this direction
298
- does not do; the fix is a different family for that slide, a shorter title, or another tonality.
190
+ `note:` lines explain every substitution: a family the pack lacks, a variant that cannot be drawn,
191
+ a treatment moved for fill or for its glyph budget. Read them after every compile. A note is never
192
+ an error to suppress; it means the source asked for something this direction does not do, and the
193
+ fix is a different family for that slide, a shorter title, or a different tonality chosen through
194
+ `direction-step.md`.