@litfamily/litgravity 0.1.0 → 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 (248) hide show
  1. package/CHANGELOG.md +32 -0
  2. package/README.md +72 -17
  3. package/README_ko-KR.md +72 -17
  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/readme-studio/templates/hyperframes-cover/package-lock.json +3 -3
  246. package/plugin/skills/readme-studio/templates/remotion-cover/package-lock.json +3 -3
  247. package/plugin/skills/review-work/SKILL.md +1 -1
  248. package/plugin/skills/start-work/SKILL.md +1 -1
@@ -1,165 +1,113 @@
1
1
  # Title treatments
2
2
 
3
- A title treatment fixes where a slide's title stands, how large it is set, which colour it takes and
4
- what is drawn with it: a rule, a band, a rail, a numeral or a panel. The engine knows eight. Each has
5
- one frame, so every slide under a treatment carries its title at the same coordinates. A deck earns
6
- its variety by giving different slide jobs different frames; a reader learns three to five positions
7
- as fast as one, provided each position always announces the same kind of page.
8
-
9
- ## The title is a label
10
-
11
- Write the title as a noun phrase that names the subject, the measure and, where it matters, the
12
- period: "분기별 방문·대출 추이", "Loans per visit by branch, 2026". The claim goes into the first
13
- takeaway of the body. A numeral beside a title is a real part number, step or figure, set at title
14
- size at most. The gate (OF-114) reads the last word of a Korean title and the verbs of an English
15
- one, and flags a sentence:
16
-
17
- | Looks like a sentence (flagged) | Reads as a label (passes) |
18
- |---|---|
19
- | 서가 이용이 지난해보다 늘었다 | 서가 이용 추이, 2025-2026 |
20
- | 신규 회원 가입이 증가함 | 월별 신규 회원 가입 |
21
- | Revenue grew 18% in Q3. | Revenue by division, Q3 2026 |
22
- | Conversion rises with feed rate | Conversion at 60 min by feed rate |
23
-
24
- A question ("왜 대출이 줄었나?") and a quotation set as a statement pass. A trailing parenthesis such
25
- as "(예시 데이터)" is set aside before the reading.
3
+ A title treatment decides how a slide's title looks: how large it is, what colour it takes and what
4
+ comes with it (a rule, a band, a rail, a numeral, a panel). The engine knows eight. None of them
5
+ moves the title. Every content title sits in the slide grid's one title zone (`scripts/lib/slide-grid.js`:
6
+ columns 1-10, y 36, 72 pt tall) and its body starts at y 120, whichever treatment and whichever
7
+ tonality draws it; a statement sits in the display title zone. The deck gets its variety from three
8
+ to five treatments for different slide jobs, and a reader never has to look for the title.
9
+
10
+ Two rules hold for all eight. The title is a topic label, never a sentence: a noun phrase that names
11
+ the subject, the measure and, where it matters, the period ("분기별 방문·대출 추이", "Loans per visit by
12
+ branch, 2026"), with the claim in the body as the first takeaway. It never gets an eyebrow or kicker
13
+ word above it. A numeral beside a title is a real part number, step or figure at title size at most,
14
+ never decoration. The gate fails a declarative title or cover subtitle (OF-114): a Korean title that
15
+ ends in -다, -니다, -요 or a nominalised claim (-음, -함, -됨), an English title with a finite verb or
16
+ a final period.
26
17
 
27
18
  ## How a slide gets its treatment
28
19
 
29
- Resolution happens in two passes, and both write to the compile log.
30
-
31
- 1. **Resolve (per slide).** The family names a role (`content`, `data`, `data-takeaway`, `sequence`,
32
- `image`, `statement`, `reference`, `definition`). The pack's `structure` entry for that family wins
33
- when it exists (Paper draws a comparison under `top-rule`, Chalk under `side-rail`); otherwise the
34
- pack's `role-defaults` entry stands. The remaining treatments of the pack follow as fall-backs, each
35
- filtered by what the family allows and by what the slide can show: `kicker-numeral` needs a part
36
- number, `overlay` needs a full-bleed image, `statement` carries one sentence and at most one
37
- support line, and `bottom-anchor` closes a page whose upper part is a visual.
38
- 2. **Render (whole deck).** For every candidate the engine lays the body out and measures the empty
39
- band under it. The role default stays when its band is within the density cap, the previous slide
40
- used another treatment, and no treatment already covers more than about a third of the content
41
- slides (at least three slides). Otherwise the candidate with the lowest cost wins; the cost grows
42
- with the empty band, with repeating the previous title and with a treatment the deck already
43
- leans on. The role default also survives a close contest: it keeps its place unless a rival
44
- leaves at least 0.10 less of the body empty (0.15 when neither reaches the density band), and a
45
- family drawn with its `structure` title keeps it past the third-of-the-deck share.
46
-
47
- After the choices, `spreadTreatments` adjusts the deck as a whole and logs every move it makes:
48
-
49
- - A deck of eight or more slides gets at least three distinct treatments (one at variance 3 or
50
- below): `variety: slide 5 drawn under side-rail so the deck carries 3 title treatments`.
51
- - No title zone (top, side, band, bottom) covers more than 40 % of the content slides, and no single
52
- composition covers more than 40 % of them: `variety: slide 7 drawn under bottom-anchor so the deck
53
- carries 5 layouts`. These two moves take data slides (roles `data` and `data-takeaway`) only, so
54
- agendas, sequences and definitions keep their titles.
55
-
56
- The variance dial caps how many distinct treatments one deck mixes: variance 1-3 allows 2, 4 allows 3,
57
- 5-6 allow 4, 7 and above allow 5, and never more than the pack lists. Gazette (variance 4) therefore
58
- tops out at three, Signal, Chalk, Ledger and Night at four, Atlas and Studio at five.
59
-
60
- ## Pinning a title
61
-
62
- Write `title: <treatment>` on the line after `layout:`. The key sits in a closed set (`title` and
63
- `variant`), so a body line such as "source: internal data" stays body text.
20
+ The pack maps each slide role to a default treatment (`role-defaults` in the pack, listed in every
21
+ tonality sheet). Roles come from the family: text families are `content`, tables and KPI rows are
22
+ `data`, charts and big numbers are `data-takeaway`, processes and timelines are `sequence`, picture
23
+ families are `image`, statements and quotes are `statement`, methods are `definition`, references
24
+ are `reference`. A pack may also name a family's own title under `structure` (Paper draws a comparison
25
+ under `top-rule`, Chalk on its board rail under `side-rail`): that title comes before the role default
26
+ and is kept even when the deck already leans on it, so two tonalities of one source differ in
27
+ structure, not only in colour. When the role default is a bottom title the slide may not take (a
28
+ table), the pack's next treatment in order stands in for it.
29
+
30
+ The engine then lays the slide out under every treatment the family and the pack both allow. It
31
+ keeps the role default when the body fills to the density band; otherwise it takes the treatment
32
+ that leaves the smallest empty band, with a cost for repeating the previous slide's treatment and a
33
+ cap so that no fill-chosen treatment covers more than about a third of the deck. The variance dial
34
+ caps how many distinct treatments one deck mixes. The compile log names every slide whose
35
+ treatment moved away from the role default.
36
+
37
+ To pin one slide, put a `title:` key on the line after `layout:`. It must name a treatment the pack
38
+ and the family both allow, or the compile stops with the allowed list:
64
39
 
65
40
  ```markdown
66
41
  ---
67
42
  layout: chart-insight
68
43
  title: bottom-anchor
69
44
 
70
- ## 시간대별 처리량, 2026년 9월
71
-
72
- ::: chart type=column unit="건"
73
- | 시간대 | 처리량 |
74
- |---|---|
75
- | 09시 | 120 |
76
- | 12시 | 180 |
77
- | 15시 | 90 |
78
- :::
79
-
80
- - 처리량은 오후 3시에 가장 낮다
45
+ ## 피크 시간대 처리량은 오후 3시에 가장 낮다
46
+ …
81
47
  ---
82
48
  ```
83
49
 
84
- A pin that names an unknown treatment, one the pack lacks, one the family refuses, or one that cannot
85
- be drawn on this slide stops the compile with a message that lists the allowed set. In Ledger,
86
- `title: side-rail` on a `full-chart` slide ends with `Compilation error: Slide 2: the full-chart
87
- family does not take "side-rail"; it allows bottom-anchor, top-plain-large, top-rule`. Run
88
- `node "$SKILL_ROOT/scripts/compile-deck.js" --list-layouts <id>` to read, for every family of a pack,
89
- the titles it takes there. Covers and sections take the title of their variant and reject a `title:` key.
90
-
91
- ## The eight frames
92
-
93
- Geometry below is for the 16:9 canvas in points (960 x 540); the grid keeps 12 columns and the
94
- canvas width is shared out as margin, column and gutter by the density dial. The body floor is y 486
95
- and the footer zone starts at y 498.
96
-
97
- | Treatment | Title frame | Drawn with it | Body zone | Typical job |
98
- |---|---|---|---|---|
99
- | `top-rule` | columns 1-12, y 36, title size | a hairline 6 pt under the frame, or a one-column accent bar 4 pt tall when the pack lists `accent-rule` | from y 120 to the floor (18 pt under the rule on the compact step) | read pages: text, tables, references |
100
- | `top-plain-large` | columns 1-10, y 36, display size | nothing | 24 pt under the title (18 on the compact step) | pages that open on one idea, large comparisons |
101
- | `side-rail` | columns 1-4, y 36, title size | a filled rail (`rail-fill`) or a hairline at the column-4 edge | columns 5-12, from y 36; the rail under the title holds labels, takeaways and the source strip | a chart or picture with its reading |
102
- | `band` | columns 1-11, y 36, title in the on-field colour | a full-width band 108 pt tall in the field colour | from y 132 (120 compact) | briefing pages, dark decks |
103
- | `statement` | columns 1-10 (5-12 under an offset device), centred on y 303 | optional support line 24 pt under it | none | pull quotes, display-led decks |
104
- | `overlay` | columns 1-7, y 348, title size | a field panel at 88 % opacity starting at y 324, a caption line at y 432 | the picture is the page | full-bleed images |
105
- | `kicker-numeral` | columns 3-12, y 48, title size | the part number in the accent colour, columns 1-2 at the cover step | from y 132 (120 compact) | steps and numbered parts |
106
- | `bottom-anchor` | columns 1-9, last line ends on y 486 | optional hairline 12 pt above the title | y 36 down to 24 pt above the title | chart-, figure- and number-led pages |
107
-
108
- ## Glyph budgets
109
-
110
- The budget is how much title the frame holds before the engine moves the slide or stops a pin. The
111
- figures come from the same measure the engine uses (a Hangul syllable counts about 0.94 em, a Latin
112
- letter about 0.52 em, a bold face adds 4 %), for a title typed without a forced break.
113
-
114
- | Treatment | Density 2 (presented ramp) | Density 6 (reading ramp) | Density 10 (compact ramp) |
115
- |---|---|---|---|
116
- | `top-rule` | 25 ko / 45 la, 1 line | 64 / 115, 2 lines | 67 / 122, 2 lines |
117
- | `top-plain-large` | 30 / 55, 2 lines | 38 / 69, 2 lines | 40 / 73, 2 lines |
118
- | `side-rail` | 31 / 57, 4 lines | 40 / 72, 4 lines | 42 / 77, 4 lines |
119
- | `band` | 23 / 41, 1 line | 58 / 106, 2 lines | 61 / 111, 2 lines |
120
- | `statement` | 45 / 82, 3 lines | 57 / 104, 3 lines | 60 / 109, 3 lines |
121
- | `overlay` | 28 / 52, 2 lines | 36 / 66, 2 lines | 38 / 70, 2 lines |
122
- | `kicker-numeral` | 20 / 37, 1 line | 26 / 48, 1 line | 28 / 50, 1 line |
123
- | `bottom-anchor` | 37 / 68, 2 lines | 47 / 86, 2 lines | 50 / 90, 2 lines |
124
-
125
- The reading and compact ramps set the title at 26 pt, which lets `top-rule` and `band` take two lines
126
- (2 x 26 x 1.15 stays inside the 60 pt frame). Every pack starts at density 10, so the right-hand
127
- column is what a default deck sees. A short title leaves room; a title over budget triggers
128
- `note: slide N: the title is longer than the <treatment> budget; shorten it` and the slide takes
129
- the first treatment its family allows.
50
+ Covers, sections and closings take their own variant's title and refuse a `title:` key.
51
+
52
+ ## The eight
53
+
54
+ Geometry is in points on the 16:9 canvas (12 columns, 24 pt margins, 78 pt pitch); the 4:3 canvas keeps
55
+ the same y values. The density dial changes type and spacing inside the zones, never the zones. Glyph
56
+ budgets are for Korean at the presented ramp, with the reading ramp in brackets; Latin text takes about
57
+ twice as many characters.
58
+
59
+ | Treatment | Title | Comes with | Body | Fits | Budget |
60
+ |---|---|---|---|---|---|
61
+ | `top-rule` | the title zone, title size | a short accent rule or a full hairline 4 pt under the title's last line | y 120-486 | content and data pages that are read | two lines of about 23 glyphs (29) |
62
+ | `top-plain-large` | the title zone, display size | nothing | y 120-486 | comparison, image-split, pages that open on one claim | one line of about 17 glyphs (two of 21) |
63
+ | `side-rail` | the title zone, title size | a bar in the left margin: the page's full height in the rail colour when the pack fills its rail, else as tall as the title zone in the accent | y 120-486 | a chart or picture with its takeaways, a comparison with labelled criteria | as `top-rule` |
64
+ | `band` | the title zone, title size, in the on-field colour | the field colour from the page's top edge to the title zone's foot (y 108) | y 120-486 | Korean briefing pages, data pages, a newspaper masthead | as `top-rule` |
65
+ | `statement` | the display title zone (columns 1-9, y 132-348), display or hero size, centred | an optional support line in the support zone (y 372) | none: the text is the content | a pull quote, or a display-led deck the user asked for | three lines of about 15 glyphs |
66
+ | `overlay` | a dark panel at the lower left over a full-bleed picture | the panel at 88 % opacity, a caption on it | none: the picture is the content | full-picture slides | two lines of about 15 glyphs |
67
+ | `kicker-numeral` | the title zone, title size | the numeral at cover size in the aside zone right of the title (columns 11-12), in the accent colour; the part number, never an agenda's row count | y 120-486 | steps, numbered recommendations | as `top-rule` |
68
+ | `bottom-anchor` | the title zone, title size | a 3 pt ink rule across the columns at the zone's foot (y 110) | y 120-486 | chart-led, figure-led and big-picture slides | as `top-rule` |
69
+
70
+ Over budget, the engine moves the slide to another allowed treatment and says so in a `note:` line;
71
+ a `title:` key that asks for an over-budget treatment stops the compile, because a pinned choice
72
+ that cannot hold the title is an authoring error. Shorten the title or pick another treatment.
130
73
 
131
74
  ## Choosing well
132
75
 
133
- - A chart, a picture or a figure with a takeaway reads best under `side-rail` or `bottom-anchor`:
134
- the title explains the visual from beside or below, and the visual takes the full height.
135
- - A table is a read page. It takes `top-rule` or `band`; a bottom title is refused while another
136
- title fits the table.
137
- - A sequence takes `kicker-numeral` when the number is a real part, step or recommendation. An
138
- agenda carries no numeral beside its title (OF-119) because its rows are numbered already.
139
- - A claim opens the body under a label: a boxed summary, a data panel, or the first takeaway.
140
- `statement` serves pull quotes and decks the user asked to be display-led.
141
- - A Korean briefing uses `band`, so a desk reader finds the same head on every page.
142
- - A picture page uses `overlay` for a full-bleed image and `bottom-anchor` when a large picture sits
143
- above its title.
144
-
145
- Keep every title inside its frame. A title nudged by a free `::: box` is a ninth, broken treatment,
146
- and OF-110 reports it as unclassified.
76
+ - **Data with a takeaway** reads best under `bottom-anchor` or `side-rail`: the heavy rule or the
77
+ margin bar marks a page led by its chart, and the chart gets the body's full height under the title.
78
+ - **A claim** is not a title. It opens the body under a label: a boxed summary over its reasons, a
79
+ data panel of the figures behind it, or the first takeaway beside a table or chart. `statement`
80
+ stays for pull quotes and decks the user asks to be display-led; a lone sentence on a page holds
81
+ too little.
82
+ - **A sequence** wants `kicker-numeral` when the number is real: the step, the part, the
83
+ recommendation. A numeral on a list that has no order is a defect.
84
+ - **Korean briefing pages** use `band`: the strong repeated head tells a desk reader where each page
85
+ starts, and the body under it can be dense.
86
+ - **Pictures** use `overlay` only on a full-bleed image, and `bottom-anchor` when a large picture
87
+ sits above its title.
88
+
89
+ Never move a title by hand with a free box: the zone is the slide grid's, and a nudged title breaks
90
+ the one place every theme keeps.
147
91
 
148
92
  ## How the gate reads it
149
93
 
150
- `qa_deck.py` classifies each title from the compiled file by geometry and companions, testing in this
151
- order: overlay, band, statement, bottom-anchor, side-rail, kicker-numeral, top-plain-large, top-rule.
152
- The engine also writes the intended treatment into the title shape's name (`title@<treatment>`) and
153
- the gate compares the two.
154
-
155
- - **OF-110** fails a deck of eight or more slides that uses fewer than three treatments (cover and
156
- section titles excluded) or more than the variance dial allows; on a deck of any length it fails a
157
- title that matches none of the eight, or one drawn as a treatment other than its name.
158
- - **OF-113** fails two slides under one treatment whose title frames differ by more than 1 pt (a
159
- statement compares x and width only; a bottom title compares x, width and its bottom edge).
160
- - **OF-115** fails a bottom title that ends more than 12 pt above the floor and a side rail more than
161
- 40 % empty under its title; text inside the rail belongs to the rail.
162
- - **OF-114** is the label rule above; **OF-119** fails a count numeral beside an agenda title.
163
-
164
- On a legacy template the variety checks report at MEDIUM, because naming that template asked for its
165
- single look.
94
+ `qa_deck.py` classifies every title from the compiled file by geometry and companions, in this order:
95
+ overlay, band, statement, bottom-anchor, side-rail, kicker-numeral, top-plain-large, top-rule. The
96
+ engine also writes the intended treatment into the title shape's name, and the gate compares the
97
+ two; the written name alone is never taken as evidence.
98
+
99
+ - **OF-110** fails on a deck of eight or more slides when fewer than three treatments are used
100
+ (cover and section titles not counted) or more than the variance dial allows. On a deck of any
101
+ length it fails when a title fits none of the eight, or when a title is drawn as a different
102
+ treatment than its name says.
103
+ - **OF-113** fails a title frame more than 1 pt off the deck's shared frame, whatever its treatment:
104
+ every content title is measured against one frame and every statement against the display frame. A
105
+ title over a full-bleed picture keeps its own panel.
106
+ - **OF-116**, run with `--sibling <other.pptx>` on the same source compiled under another tonality,
107
+ fails when the two decks place a slide's title frame or its body's top-left corner differently: a tonality changes the
108
+ look and never the place.
109
+ - **OF-115** fails a column that stops short beside a longer one, a title panel taller than its text
110
+ and a plate under an empty page.
111
+
112
+ On a legacy template the variety checks report as advisories, because the user asked for that
113
+ template's single title position.
@@ -1,152 +1,139 @@
1
1
  # Atlas
2
2
 
3
3
  Atlas is a picture book with good captions. Photographs bleed to the edge or take most of the body,
4
- titles sit on a dark panel over the picture or under it, and the words stay short and calm while
5
- carrying what each picture needs: what, where, when and how much. The palette is quiet on purpose, a
6
- near-black ink and one muted navy, because the photographs bring the colour. Every picture carries a
7
- numbered caption with its source, which keeps the deck honest about what the reader is looking at.
4
+ titles sit on a dark panel over a full-bleed picture or in the slide grid's title zone above it, and the words stay calm but carry the
5
+ facts each picture needs: what, where, when and how much. The
6
+ palette is quiet on purpose, a near-black ink and one muted navy, because the photographs bring the
7
+ colour. Every picture carries a numbered caption and its source, which keeps the deck honest about
8
+ what the reader is looking at.
8
9
 
9
- ## When to choose it
10
+ ## When to use it
10
11
 
11
12
  Use Atlas when the evidence is visual: product reports, portfolios, site and field visits,
12
- renovation or construction progress, exhibitions. Ten families are listed and five of them are built
13
- on pictures (`image-full`, `image-split`, `photo-grid`, `figure-pair`, `asymmetric-feature`), so the
14
- direction pays off when about a third of the slides hold a real image or a screenshot. It suits a
15
- client or a review panel who judges by seeing, with short narrative text between the pictures.
13
+ renovation or construction progress, exhibitions. It is the first candidate for the image-led deck
14
+ type and moves up whenever a third or more of the slides hold an image or a screenshot. It works for
15
+ a client or a review panel who judges by seeing, and it suits short narrative text between pictures.
16
16
 
17
- The pack file says what breaks it: few real images. A look built around pictures turns into empty
18
- boxes without them, so a text or number deck belongs in Ledger, Gazette or Signal. Long tables sit
19
- awkwardly here because the table style is light and the families give the room to images.
17
+ ## When it is the wrong choice
18
+
19
+ Atlas fails without real images. A pack built around pictures turns into grey boxes when the
20
+ source has none, so for a text or number deck pick Ledger, Gazette or Signal. It keeps a
21
+ statement for the one claim a picture deck needs, but a deck that lives on one-line claims belongs
22
+ in Signal or Studio. Long tables also sit awkwardly here, because its table style is light and its
23
+ families give
24
+ the room to images.
20
25
 
21
26
  ## Tokens
22
27
 
28
+ These values are read from the pack file `pack.yaml` of the `atlas` tonality.
29
+
23
30
  | Token | Value |
24
31
  |---|---|
25
- | ground / surface | #FFFFFF / #F3F4F5 |
26
- | ink / ink-muted / line | #1A1D21 / #555B63 / #D6D9DD |
27
- | accent / accent-deep / accent-tint | #2B4C7E / #1B2F4E / #E6ECF4 |
28
- | field / on-field | #1A1D21 / #FFFFFF |
29
- | positive / negative | #1E7A3F / #B3261E |
30
- | series | #2B4C7E, #555B63, #8A6A2E, #3E7A5A |
31
- | faces | Pretendard Regular for display, body, label and numerals, Pretendard Bold for titles; `faces: a2z` moves display and numerals to A2Z Light |
32
- | tracking (title / display) | 0 % / -1 % of the size |
33
- | density / variance | 10 / 7 (up to 5 title treatments, all five of the pack) |
32
+ | ground / surface | `#FFFFFF` / `#F3F4F5` |
33
+ | ink / ink-muted | `#1A1D21` / `#555B63` |
34
+ | line | `#D6D9DD` |
35
+ | accent / accent-deep / accent-tint | `#2B4C7E` / `#1B2F4E` / `#E6ECF4` |
36
+ | field / on-field | `#1A1D21` / `#FFFFFF` |
37
+ | positive / negative | `#1E7A3F` / `#B3261E` |
38
+ | series | `#2B4C7E`, `#555B63`, `#8A6A2E`, `#3E7A5A` |
39
+ | faces | title Pretendard Bold, body, label, display and numerals Pretendard Regular; `faces: a2z` swaps display and numerals to A2Z Light |
40
+ | 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 |
41
+ | density / variance | 10 / 7 |
34
42
  | radius / edge | 0 / fill |
35
- | table | no header fill, a bold ink header, hairline row rules, no banding, bold totals |
36
- | chart | hairline gridlines, direct labels, accent on the highlighted series |
43
+ | table | light grid: no header fill, bold ink header, hairline rows, no banding, numbers right-aligned, totals bold |
44
+ | chart | hairline gridlines, direct labels, accent on the item that matters |
37
45
  | image | no frame |
38
- | decoration | caption-band, hairline-rule, colour-field |
39
- | fill-order | anchor-visual, change-family, distribute, step-up |
40
-
41
- The compact ramp applies (body 13 pt, label 11, title 26, display 36, cover 44). A picture family
42
- spreads the picture over most of the body, so type size rarely decides the page; the caption sets at
43
- label size under its picture and the source stays inside the caption after a bar.
44
-
45
- ## Titles by family
46
-
47
- The role defaults: images `overlay`, data with a takeaway `bottom-anchor`, content, references and
48
- definitions `side-rail`, data and sequences `top-plain-large`, statements `statement`. The `overlay`
49
- frame is a field panel at 88 % opacity over the lower left of a full-bleed picture (columns 1-7,
50
- starting at y 324), with the title at y 348 and the caption at y 432; only `image-full` takes it.
51
- `title: top-plain-large` after `layout:` pins one slide, provided the family allows it.
52
-
53
- | Family | Default title | Then, in pack order |
54
- |---|---|---|
55
- | `image-full` | `overlay` | none |
56
- | `image-split` | `bottom-anchor` | `side-rail`, `top-plain-large` |
57
- | `photo-grid` | `bottom-anchor` | `top-plain-large` |
58
- | `figure-pair` | `bottom-anchor` | `side-rail` |
59
- | `asymmetric-feature` | `bottom-anchor` | `top-plain-large` |
60
- | `kpi-row` | `top-plain-large` | `bottom-anchor`, `side-rail` |
61
- | `comparison` | `top-plain-large` (numbers) / `side-rail` (arguments) | `bottom-anchor`, `side-rail`, `top-plain-large` |
62
- | `timeline` | `top-plain-large` | `bottom-anchor` |
63
- | `text-column` | `side-rail` | `top-plain-large` |
64
- | `statement` | `statement` | none |
46
+ | decoration | caption band, hairline rule, colour field |
47
+
48
+ ## Treatments by slide role
49
+
50
+ Image slides take `overlay`, where the title sits on a dark panel over a full-bleed photograph.
51
+ Charts and figures with a takeaway take `bottom-anchor`, the title closed by a heavy rule over a
52
+ visual that takes the body's full height. Text, reference and definition slides take `side-rail`, data and
53
+ sequences take `top-plain-large`, and a pull quote takes `statement` on the dark field over the
54
+ whole page (a plate under half the page left its top half open). The
55
+ engine starts from the role's treatment and, when
56
+ the body would stay half empty, tries the others the family allows and keeps the one that fills,
57
+ within the variance cap. A `title: <treatment>` line under `layout:` pins one slide, provided the
58
+ family allows it; `image-full` only ever takes `overlay`.
65
59
 
66
60
  ## Families and variants
67
61
 
68
- - `image-full`: one picture across the slide with the title and caption on its panel.
69
- - `image-split`: a large image beside three to five short facts.
70
- - `photo-grid`: two or three images in a row with one line under them.
71
- - `figure-pair`: before and after, or two places, with one line of evidence.
72
- - `asymmetric-feature`: one image or number with the larger share of the width.
73
- - `kpi-row`: two to six numbers that prove the pictures, each with a basis row.
74
- - `comparison`, `timeline`, `text-column`: options, dated next steps and the short narrative that
75
- links picture groups.
76
- - Covers `cover-full-image`, `cover-split-image`, `cover-typographic`; sections `section-image`,
77
- `section-field`; closings `closing-contact-split`, `closing-ask`.
78
-
79
- A cover takes no image block of its own. The engine reads the first image on any content slide of the
80
- deck, so put the picture on a slide and the cover finds it; `cover-full-image` puts a panel as tall as
81
- the title and its meta line on the page foot, so the picture keeps the rest. A section needs its own
82
- image on the section slide for `section-image`.
83
-
84
- Display devices: without a picture the typographic cover is a `plate`, a dark field from y 288 to the
85
- foot with the title in at most two lines, like a caption under a photograph that is absent; a pull
86
- quote is `drench`, the whole page in the field with the quotation in white; a big number sits on the
87
- accent tint; a closing's next step runs as a dark `band` above the footer, and `closing-contact-split`
88
- holds each row's date or amount on a field beside the rows.
62
+ - `image-full`: one photograph across the whole slide with the title on its panel.
63
+ - `image-split`: a large image beside three or four short facts about it.
64
+ - `photo-grid`: up to three images in a row, with one line under them.
65
+ - `figure-pair`: before and after, or two places, side by side with one line of evidence.
66
+ - `asymmetric-feature`: one image or number given most of the width, with short evidence.
67
+ - `kpi-row`: two to four numbers that prove the pictures, each with a basis row and a sourced caption.
68
+ - `comparison`: two options or two problems, row by row.
69
+ - `timeline`: dated next steps on one axis.
70
+ - `text-column`: the short narrative that opens or links the picture sections.
71
+
72
+ Covers are `cover-full-image` (it takes the first image in the deck; the title's panel is only as
73
+ tall as the title and its meta line and stands on the foot of the page, so the picture keeps the rest), `cover-split-image` and
74
+ `cover-typographic`. Sections are `section-image` and `section-field`. Closings are
75
+ `closing-contact-split` and `closing-ask`. A cover takes no image block of its own; put the picture
76
+ on a content slide and the cover finds it.
77
+
78
+ Display slides. Without a picture, the typographic cover puts the title on a dark plate over the
79
+ lower part of the page, like a caption under a photograph that is not there. A pull quote fills the
80
+ page with the dark field, the quotation in the middle. A closing's rows carry their dates or amounts at title size, and the next step runs in a dark
81
+ band above the footer.
89
82
 
90
83
  ## Do
91
84
 
92
- - Give every photograph a numbered caption with its source: `![도 2. 오후 3시의 창가 | 출처: 예시 이미지](assets/example-b.png)`.
93
- - Let one image dominate each slide and write the facts next to it in short lines, each with a number,
94
- a date or a place; the first fact carries the claim.
95
- - Title each slide with a label (place, subject, period).
96
- - Keep narrative slides brief and use them to move between picture groups.
97
- - End with the ask and the dated next step.
85
+ Give every photograph a numbered caption with its source. Let one image dominate each slide, and
86
+ write the facts about it next to it in short lines, with a number, a date or a place in each. Title
87
+ each slide with a label (place, subject, period) and let the first fact carry the claim. Keep the
88
+ narrative slides brief and use them to move from one group of pictures to the next. End with the ask
89
+ and the dated next step.
98
90
 
99
91
  ## Avoid
100
92
 
101
- - Text laid straight on a photograph; the panel carries the words.
102
- - Images in card frames and rows of more than three images.
103
- - Grey sample boxes in a delivered deck.
104
- - Claims in titles; the caption or the first fact of the picture that proves them carries the claim.
105
-
106
- ## Failure patterns
107
-
108
- | Symptom | Cause | Fix |
109
- |---|---|---|
110
- | `Compilation error: Slide 2: no atlas treatment (overlay, bottom-anchor, side-rail, top-plain-large, statement) fits the image-full family (overlay) on this slide; choose another layout family or tonality` | `image-full` without an image | add the picture or use a text family |
111
- | `note: slide 1: cover-full-image cannot be drawn (the deck has no image)` then `drawn as cover-typographic` | no content slide holds a picture | add one, or name `cover-typographic` |
112
- | `note: slide 1: section-image cannot be drawn (the section slide has no image)`, drawn as `section-field` | the picture sits on another slide | put the image on the section slide |
113
- | a fourth image disappears from a `photo-grid` | the family draws up to three images | split into two slides |
114
- | a picture with no number under it | the alt text is empty, so no caption exists | write the alt text as the caption |
93
+ Avoid text placed straight on a photograph without the panel, images in card frames, and more than
94
+ three images in one row. Never deliver a deck with grey sample boxes in place of the real pictures.
95
+ Keep the `statement` family for a pull quote; claims belong in the first fact or the caption of the
96
+ picture that proves them, never in the title.
115
97
 
116
98
  ## Two worked slides
117
99
 
118
- One picture across the page with its label title and caption on the panel; the caption states what
119
- the picture shows and when it was taken.
100
+ An image-split slide puts the picture first and five short facts beside it, the claim in the first,
101
+ so the reader gets the evidence without a paragraph.
120
102
 
121
103
  ```markdown
122
104
  ---
123
- layout: image-full
105
+ layout: image-split
106
+
107
+ ## 재개관 첫 주 창가 좌석 이용 현황
124
108
 
125
- ## 재개관 후 동부분관 열람실
109
+ ![도 2. 오후 3시의 창가 좌석 | 출처: 예시 이미지](assets/example-b.png)
126
110
 
127
- ![도 1. 거리 쪽으로 열린 열람실, 2026년 9월 촬영 | 출처: 예시 이미지](assets/example-a.png)
111
+ - **요약** 창가 좌석은 개관부터 마감까지 하루 종일 차 있다
112
+ - **좌석 수** 창가 좌석을 24석에서 56석으로 늘렸다
113
+ - **점유율** 재개관 첫 주 오후 점유율이 92%였다
114
+ - **조명** 창가에 차양을 달아 오후 눈부심 민원이 없었다
115
+ - **동선** 서가를 벽 쪽으로 옮겨 통로 폭이 1.2m에서 1.8m가 됐다
128
116
  ---
129
117
  ```
130
118
 
131
- Three pictures side by side with one sentence under them that states the common finding. The
132
- engine numbers the captions (도 2, 도 3, 도 4) in the deck's language.
119
+ A figure pair shows the change, and the lines under both pictures state it with its basis.
133
120
 
134
121
  ```markdown
135
122
  ---
136
- layout: photo-grid
123
+ layout: figure-pair
137
124
 
138
- ## 열람실 세 구역 공사 후 모습
125
+ ## 공사 전후 어린이실 좌석 배치
139
126
 
140
- ![도 2. 창가 좌석 구역 | 출처: 예시 이미지](assets/example-a.png)
127
+ ![도 3. 공사 전 어린이실 | 출처: 예시 이미지](assets/example-b.png)
141
128
 
142
- ![도 3. 어린이 열람 구역 | 출처: 예시 이미지](assets/example-b.png)
129
+ ![도 4. 공사 후 어린이실 | 출처: 예시 이미지](assets/example-b.png)
143
130
 
144
- ![도 4. 토론실 구역 | 출처: 예시 이미지](assets/example-c.png)
145
-
146
- - 세 구역 모두 공사 전보다 좌석이 늘었고 동선이 넓어졌다
131
+ - 공사 전후의 어린이실은 같은 방으로 보이지 않는다
132
+ - 낮은 서가와 계단식 좌석으로 동시 착석이 18명에서 40명으로 늘었다
133
+ - 주말 어린이실 이용은 하루 평균 95명에서 160명이 됐다 (예시)
147
134
  ---
148
135
  ```
149
136
 
150
- Both slides compile under `tonality: atlas` after a generic `layout: cover` (drawn as
151
- `cover-full-image` from the deck's first picture) and pass `qa_deck.py`. The image files are the three
152
- bundled example pictures; the library and its figures are invented.
137
+ ## Examples
138
+
139
+ `08-image-led-atlas-ko.md` uses the pack defaults (density 10, variance 7).