@litfamily/litgravity 0.1.1 → 0.1.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (246) hide show
  1. package/CHANGELOG.md +27 -0
  2. package/README.md +17 -3
  3. package/README_ko-KR.md +17 -3
  4. package/package.json +1 -1
  5. package/plugin/hooks/lib/lanes.mjs +65 -0
  6. package/plugin/hooks/lib/motion.mjs +34 -5
  7. package/plugin/hooks/lib/reentry.mjs +7 -0
  8. package/plugin/hooks/lib/rewind/brief.mjs +332 -0
  9. package/plugin/hooks/lib/rewind/collect.mjs +328 -0
  10. package/plugin/hooks/lib/rewind/gauge.mjs +55 -0
  11. package/plugin/hooks/lib/rewind/next-step.mjs +77 -0
  12. package/plugin/hooks/lib/rewind/redact.mjs +60 -0
  13. package/plugin/hooks/lib/rewind/transcripts.mjs +211 -0
  14. package/plugin/hooks/lib/routes.mjs +79 -5
  15. package/plugin/hooks/lib/workflow-stack.mjs +213 -0
  16. package/plugin/hooks/post-tool-use.mjs +37 -1
  17. package/plugin/hooks/pre-invocation.mjs +91 -2
  18. package/plugin/hooks/session-start.mjs +26 -3
  19. package/plugin/hooks/stop.mjs +22 -2
  20. package/plugin/hud/looks.mjs +29 -0
  21. package/plugin/hud/render.mjs +234 -12
  22. package/plugin/plugin.json +1 -1
  23. package/plugin/skills/frontend-ui-ux/SKILL.md +12 -1
  24. package/plugin/skills/frontend-ui-ux/kit/components.css +417 -0
  25. package/plugin/skills/frontend-ui-ux/kit/fonts.json +22 -0
  26. package/plugin/skills/frontend-ui-ux/kit/layouts/landing.html +164 -0
  27. package/plugin/skills/frontend-ui-ux/kit/layouts/settings.html +114 -0
  28. package/plugin/skills/frontend-ui-ux/kit/layouts/workspace.html +115 -0
  29. package/plugin/skills/frontend-ui-ux/kit/styles/computational-brutalism.json +227 -0
  30. package/plugin/skills/frontend-ui-ux/kit/styles/field-notes.json +205 -0
  31. package/plugin/skills/frontend-ui-ux/kit/styles/graphite.json +200 -0
  32. package/plugin/skills/frontend-ui-ux/kit/styles/meadow.json +199 -0
  33. package/plugin/skills/frontend-ui-ux/kit/styles/neo-brutalism.json +222 -0
  34. package/plugin/skills/frontend-ui-ux/kit/ui.js +226 -0
  35. package/plugin/skills/frontend-ui-ux/references/house-styles.md +234 -0
  36. package/plugin/skills/frontend-ui-ux/scripts/design-lock.mjs +400 -0
  37. package/plugin/skills/frontend-ui-ux/scripts/interface-probe-lock.mjs +196 -0
  38. package/plugin/skills/frontend-ui-ux/scripts/interface-probe-page.mjs +30 -9
  39. package/plugin/skills/frontend-ui-ux/scripts/interface-probe-rules.mjs +20 -8
  40. package/plugin/skills/frontend-ui-ux/scripts/interface-probe.mjs +42 -9
  41. package/plugin/skills/frontend-ui-ux/scripts/pixel-art.mjs +60 -0
  42. package/plugin/skills/lit-adhd/SKILL.md +157 -0
  43. package/plugin/skills/lit-adhd/references/card-examples.md +101 -0
  44. package/plugin/skills/lit-adhd/references/status-taxonomy.md +32 -0
  45. package/plugin/skills/lit-adhd/scripts/rewind.mjs +5 -0
  46. package/plugin/skills/lit-diagram-drawer/SKILL.md +5 -3
  47. package/plugin/skills/lit-diagram-drawer/references/drawing-rules.md +1 -1
  48. package/plugin/skills/lit-diagram-drawer/references/style-guide.md +21 -12
  49. package/plugin/skills/lit-diagram-drawer/references/type-architecture.md +3 -3
  50. package/plugin/skills/lit-diagram-drawer/references/type-dependency.md +1 -1
  51. package/plugin/skills/lit-diagram-drawer/references/type-tree.md +3 -3
  52. package/plugin/skills/lit-diagram-drawer/references/type-wardley.md +1 -1
  53. package/plugin/skills/lit-diagram-drawer/scripts/diagram-craft-rules.mjs +1 -2
  54. package/plugin/skills/lit-diagram-drawer/scripts/visual-quality.mjs +1 -2
  55. package/plugin/skills/lit-docx/SKILL.md +3 -3
  56. package/plugin/skills/lit-handoff/SKILL.md +1 -0
  57. package/plugin/skills/lit-hijack/SKILL.md +263 -0
  58. package/plugin/skills/lit-hijack/references/capture-and-provenance.md +100 -0
  59. package/plugin/skills/lit-hijack/references/clean-room-build.md +75 -0
  60. package/plugin/skills/lit-hijack/references/distil-and-licence.md +67 -0
  61. package/plugin/skills/lit-hijack/references/gap-and-port-design.md +100 -0
  62. package/plugin/skills/lit-hijack/references/parity-and-report.md +85 -0
  63. package/plugin/skills/lit-hijack/scripts/hijack.mjs +953 -0
  64. package/plugin/skills/lit-plan/SKILL.md +1 -1
  65. package/plugin/skills/lit-pptx/SKILL.md +8 -8
  66. package/plugin/skills/lit-pptx/fonts/jetbrains-mono/JetBrainsMono-Bold.ttf +0 -0
  67. package/plugin/skills/lit-pptx/fonts/jetbrains-mono/JetBrainsMono-Regular.ttf +0 -0
  68. package/plugin/skills/lit-pptx/fonts/jetbrains-mono/OFL.txt +93 -0
  69. package/plugin/skills/lit-pptx/fonts/provenance.json +32 -1
  70. package/plugin/skills/lit-pptx/references/agents/analyst.md +34 -56
  71. package/plugin/skills/lit-pptx/references/agents/antithesis.md +49 -67
  72. package/plugin/skills/lit-pptx/references/agents/architect.md +38 -51
  73. package/plugin/skills/lit-pptx/references/agents/critic.md +25 -41
  74. package/plugin/skills/lit-pptx/references/agents/synthesizer.md +37 -46
  75. package/plugin/skills/lit-pptx/references/agents/thesis.md +29 -49
  76. package/plugin/skills/lit-pptx/references/anti-slop-checklist.md +119 -145
  77. package/plugin/skills/lit-pptx/references/authoring-guide.md +187 -278
  78. package/plugin/skills/lit-pptx/references/consensus-protocol.md +99 -97
  79. package/plugin/skills/lit-pptx/references/data-display-cookbook.md +36 -137
  80. package/plugin/skills/lit-pptx/references/density-and-fill.md +147 -216
  81. package/plugin/skills/lit-pptx/references/design-system-azure.md +56 -85
  82. package/plugin/skills/lit-pptx/references/direction-step.md +134 -176
  83. package/plugin/skills/lit-pptx/references/examples/01-pitch-signal-ko.md +114 -115
  84. package/plugin/skills/lit-pptx/references/examples/02-pitch-studio-ko.md +66 -66
  85. package/plugin/skills/lit-pptx/references/examples/03-business-review-ledger-ko.md +63 -63
  86. package/plugin/skills/lit-pptx/references/examples/04-business-review-night-en.md +96 -96
  87. package/plugin/skills/lit-pptx/references/examples/05-research-talk-paper-en.md +81 -81
  88. package/plugin/skills/lit-pptx/references/examples/06-lecture-chalk-ko.md +103 -103
  89. package/plugin/skills/lit-pptx/references/examples/07-data-review-night-en.md +100 -98
  90. package/plugin/skills/lit-pptx/references/examples/08-image-led-atlas-ko.md +76 -76
  91. package/plugin/skills/lit-pptx/references/examples/09-briefing-gazette-ko.md +96 -96
  92. package/plugin/skills/lit-pptx/references/examples/10-status-update-ledger-ko.md +80 -80
  93. package/plugin/skills/lit-pptx/references/examples/11-portfolio-studio-en.md +72 -72
  94. package/plugin/skills/lit-pptx/references/examples/12-research-tutorial-chalk-en.md +95 -95
  95. package/plugin/skills/lit-pptx/references/examples/13-engineering-review-computational-brutalism-ko.md +173 -0
  96. package/plugin/skills/lit-pptx/references/examples/14-launch-pitch-neo-brutalism-ko.md +154 -0
  97. package/plugin/skills/lit-pptx/references/examples/15-design-lecture-bauhaus-ko.md +139 -0
  98. package/plugin/skills/lit-pptx/references/examples/16-community-programme-riso-ko.md +158 -0
  99. package/plugin/skills/lit-pptx/references/examples/17-public-data-briefing-newsroom-ko.md +179 -0
  100. package/plugin/skills/lit-pptx/references/interview-protocol.md +83 -102
  101. package/plugin/skills/lit-pptx/references/layout-families.md +161 -265
  102. package/plugin/skills/lit-pptx/references/stages/autopilot.md +30 -70
  103. package/plugin/skills/lit-pptx/references/stages/interview.md +36 -68
  104. package/plugin/skills/lit-pptx/references/stages/plan.md +26 -67
  105. package/plugin/skills/lit-pptx/references/title-treatments.md +93 -145
  106. package/plugin/skills/lit-pptx/references/tonalities/atlas.md +95 -108
  107. package/plugin/skills/lit-pptx/references/tonalities/bauhaus.md +140 -0
  108. package/plugin/skills/lit-pptx/references/tonalities/chalk.md +107 -122
  109. package/plugin/skills/lit-pptx/references/tonalities/computational-brutalism.md +150 -0
  110. package/plugin/skills/lit-pptx/references/tonalities/gazette.md +87 -111
  111. package/plugin/skills/lit-pptx/references/tonalities/ledger.md +96 -125
  112. package/plugin/skills/lit-pptx/references/tonalities/neo-brutalism.md +161 -0
  113. package/plugin/skills/lit-pptx/references/tonalities/newsroom.md +144 -0
  114. package/plugin/skills/lit-pptx/references/tonalities/night.md +104 -131
  115. package/plugin/skills/lit-pptx/references/tonalities/paper.md +114 -130
  116. package/plugin/skills/lit-pptx/references/tonalities/riso.md +137 -0
  117. package/plugin/skills/lit-pptx/references/tonalities/signal.md +96 -103
  118. package/plugin/skills/lit-pptx/references/tonalities/studio.md +81 -112
  119. package/plugin/skills/lit-pptx/scripts/compile-deck.js +4 -6
  120. package/plugin/skills/lit-pptx/scripts/craft_extras.py +135 -91
  121. package/plugin/skills/lit-pptx/scripts/deck_craft.py +1 -1
  122. package/plugin/skills/lit-pptx/scripts/embed_fonts.py +13 -1
  123. package/plugin/skills/lit-pptx/scripts/layout_inventory.py +1 -1
  124. package/plugin/skills/lit-pptx/scripts/learn_template.py +1 -1
  125. package/plugin/skills/lit-pptx/scripts/lib/grid-resolver.js +101 -110
  126. package/plugin/skills/lit-pptx/scripts/lib/layout-resolver.js +9 -15
  127. package/plugin/skills/lit-pptx/scripts/lib/render-pack.js +370 -563
  128. package/plugin/skills/lit-pptx/scripts/lib/slide-grid.js +104 -0
  129. package/plugin/skills/lit-pptx/scripts/lib/template-registry.js +57 -6
  130. package/plugin/skills/lit-pptx/scripts/qa_deck.py +6 -6
  131. package/plugin/skills/lit-pptx/scripts/render_pages.py +31 -0
  132. package/plugin/skills/lit-pptx/scripts/validate_pptx.py +1 -1
  133. package/plugin/skills/lit-pptx/specs/markdown-slide-spec-v1.md +167 -191
  134. package/plugin/skills/lit-pptx/specs/markdown-slide-spec-v2.md +117 -166
  135. package/plugin/skills/lit-pptx/specs/template-enrollment-contract.md +307 -330
  136. package/plugin/skills/lit-pptx/templates/tonalities/atlas/pack.yaml +1 -1
  137. package/plugin/skills/lit-pptx/templates/tonalities/bauhaus/pack.yaml +98 -0
  138. package/plugin/skills/lit-pptx/templates/tonalities/chalk/pack.yaml +1 -1
  139. package/plugin/skills/lit-pptx/templates/tonalities/computational-brutalism/pack.yaml +99 -0
  140. package/plugin/skills/lit-pptx/templates/tonalities/gazette/pack.yaml +1 -1
  141. package/plugin/skills/lit-pptx/templates/tonalities/ledger/pack.yaml +1 -1
  142. package/plugin/skills/lit-pptx/templates/tonalities/neo-brutalism/pack.yaml +107 -0
  143. package/plugin/skills/lit-pptx/templates/tonalities/newsroom/pack.yaml +99 -0
  144. package/plugin/skills/lit-pptx/templates/tonalities/night/pack.yaml +1 -1
  145. package/plugin/skills/lit-pptx/templates/tonalities/paper/pack.yaml +1 -1
  146. package/plugin/skills/lit-pptx/templates/tonalities/riso/pack.yaml +99 -0
  147. package/plugin/skills/lit-pptx/templates/tonalities/signal/pack.yaml +2 -2
  148. package/plugin/skills/lit-pptx/templates/tonalities/studio/pack.yaml +1 -1
  149. package/plugin/skills/lit-schematic/SKILL.md +114 -0
  150. package/plugin/skills/lit-schematic/examples/iso-heat-exchanger/build.mjs +38 -0
  151. package/plugin/skills/lit-schematic/examples/iso-heat-exchanger/scene.mjs +133 -0
  152. package/plugin/skills/lit-schematic/examples/journal-adsorption-rig/build.mjs +87 -0
  153. package/plugin/skills/lit-schematic/examples/pid-dosing-skid/build.mjs +85 -0
  154. package/plugin/skills/lit-schematic/references/cutaway-outputs.md +70 -0
  155. package/plugin/skills/lit-schematic/references/isometric-craft.md +101 -0
  156. package/plugin/skills/lit-schematic/references/journal-figures.md +72 -0
  157. package/plugin/skills/lit-schematic/references/kit-api.md +134 -0
  158. package/plugin/skills/lit-schematic/references/pfd-and-layout.md +53 -0
  159. package/plugin/skills/lit-schematic/references/pid-drafting.md +103 -0
  160. package/plugin/skills/lit-schematic/references/pid-symbols.md +163 -0
  161. package/plugin/skills/lit-schematic/references/verification.md +100 -0
  162. package/plugin/skills/lit-schematic/scripts/doctor.mjs +57 -0
  163. package/plugin/skills/lit-schematic/scripts/lib/figure.mjs +81 -0
  164. package/plugin/skills/lit-schematic/scripts/lib/fonts.mjs +27 -0
  165. package/plugin/skills/lit-schematic/scripts/lib/geom.mjs +113 -0
  166. package/plugin/skills/lit-schematic/scripts/lib/interactive.mjs +292 -0
  167. package/plugin/skills/lit-schematic/scripts/lib/isa.mjs +115 -0
  168. package/plugin/skills/lit-schematic/scripts/lib/iso.mjs +719 -0
  169. package/plugin/skills/lit-schematic/scripts/lib/legend-sheet.mjs +162 -0
  170. package/plugin/skills/lit-schematic/scripts/lib/pid.mjs +937 -0
  171. package/plugin/skills/lit-schematic/scripts/lib/png.mjs +132 -0
  172. package/plugin/skills/lit-schematic/scripts/lib/qa-core.mjs +658 -0
  173. package/plugin/skills/lit-schematic/scripts/lib/route.mjs +218 -0
  174. package/plugin/skills/lit-schematic/scripts/lib/sheet.mjs +890 -0
  175. package/plugin/skills/lit-schematic/scripts/lib/svg.mjs +82 -0
  176. package/plugin/skills/lit-schematic/scripts/lib/theme.mjs +115 -0
  177. package/plugin/skills/lit-schematic/scripts/motion.mjs +129 -0
  178. package/plugin/skills/lit-schematic/scripts/qa.mjs +92 -0
  179. package/plugin/skills/lit-schematic/scripts/render.mjs +233 -0
  180. package/plugin/skills/lit-schematic/scripts/scaffold.mjs +60 -0
  181. package/plugin/skills/lit-scientific-visualization/SKILL.md +17 -6
  182. package/plugin/skills/lit-typographic-motion/SKILL.md +58 -48
  183. package/plugin/skills/lit-typographic-motion/engine/THIRD_PARTY_NOTICES +13 -2
  184. package/plugin/skills/lit-typographic-motion/engine/blender/runner.py +218 -0
  185. package/plugin/skills/lit-typographic-motion/engine/core/presets.mjs +1 -1
  186. package/plugin/skills/lit-typographic-motion/engine/node/analysis.mjs +65 -1
  187. package/plugin/skills/lit-typographic-motion/engine/node/assets.mjs +298 -0
  188. package/plugin/skills/lit-typographic-motion/engine/node/blender.mjs +143 -0
  189. package/plugin/skills/lit-typographic-motion/engine/node/board.mjs +136 -0
  190. package/plugin/skills/lit-typographic-motion/engine/node/brief.mjs +7 -1
  191. package/plugin/skills/lit-typographic-motion/engine/node/chrome.mjs +9 -12
  192. package/plugin/skills/lit-typographic-motion/engine/node/cover-assets.mjs +5 -3
  193. package/plugin/skills/lit-typographic-motion/engine/node/cover-capture.mjs +7 -6
  194. package/plugin/skills/lit-typographic-motion/engine/node/cover-treatment.mjs +37 -4
  195. package/plugin/skills/lit-typographic-motion/engine/node/cover.mjs +19 -8
  196. package/plugin/skills/lit-typographic-motion/engine/node/done.mjs +45 -6
  197. package/plugin/skills/lit-typographic-motion/engine/node/frame-worker.mjs +7 -5
  198. package/plugin/skills/lit-typographic-motion/engine/node/gallery.mjs +121 -0
  199. package/plugin/skills/lit-typographic-motion/engine/node/host.mjs +34 -0
  200. package/plugin/skills/lit-typographic-motion/engine/node/house.mjs +44 -0
  201. package/plugin/skills/lit-typographic-motion/engine/node/look.mjs +34 -20
  202. package/plugin/skills/lit-typographic-motion/engine/node/pipeline.mjs +19 -9
  203. package/plugin/skills/lit-typographic-motion/engine/node/scaffold.mjs +210 -0
  204. package/plugin/skills/lit-typographic-motion/engine/node/score.mjs +639 -0
  205. package/plugin/skills/lit-typographic-motion/engine/node/sound-cli.mjs +21 -4
  206. package/plugin/skills/lit-typographic-motion/engine/node/sound.mjs +127 -29
  207. package/plugin/skills/lit-typographic-motion/engine/node/stage-capture.mjs +7 -6
  208. package/plugin/skills/lit-typographic-motion/engine/node/stage-gate.mjs +59 -5
  209. package/plugin/skills/lit-typographic-motion/engine/node/stage-qa.mjs +141 -9
  210. package/plugin/skills/lit-typographic-motion/engine/node/stage-serve.mjs +28 -5
  211. package/plugin/skills/lit-typographic-motion/engine/node/stage.mjs +82 -14
  212. package/plugin/skills/lit-typographic-motion/engine/node/styles.mjs +213 -0
  213. package/plugin/skills/lit-typographic-motion/engine/node/treatment.mjs +311 -10
  214. package/plugin/skills/lit-typographic-motion/engine/stage/cover-init.js +14 -2
  215. package/plugin/skills/lit-typographic-motion/engine/stage/init.js +11 -1
  216. package/plugin/skills/lit-typographic-motion/engine/stage/qa.js +6 -1
  217. package/plugin/skills/lit-typographic-motion/engine/stage/stage-kit.js +83 -0
  218. package/plugin/skills/lit-typographic-motion/engine/vendor/three/LICENSE +21 -0
  219. package/plugin/skills/lit-typographic-motion/engine/vendor/three/addons/environments/RoomEnvironment.js +144 -0
  220. package/plugin/skills/lit-typographic-motion/engine/vendor/three/addons/geometries/RoundedBoxGeometry.js +155 -0
  221. package/plugin/skills/lit-typographic-motion/engine/vendor/three/three.module.js +54571 -0
  222. package/plugin/skills/lit-typographic-motion/recipes/hero-3d/expected.json +69 -0
  223. package/plugin/skills/lit-typographic-motion/recipes/hero-3d/index.html +139 -0
  224. package/plugin/skills/lit-typographic-motion/recipes/orbit-loop/expected.json +6 -4
  225. package/plugin/skills/lit-typographic-motion/recipes/painted-light/expected.json +4 -2
  226. package/plugin/skills/lit-typographic-motion/recipes/weight-tide/expected.json +7 -5
  227. package/plugin/skills/lit-typographic-motion/references/cover.md +394 -443
  228. package/plugin/skills/lit-typographic-motion/references/craft-loop.md +57 -87
  229. package/plugin/skills/lit-typographic-motion/references/depth.md +122 -0
  230. package/plugin/skills/lit-typographic-motion/references/look.md +94 -129
  231. package/plugin/skills/lit-typographic-motion/references/runtime.md +58 -91
  232. package/plugin/skills/lit-typographic-motion/references/sound.md +130 -99
  233. package/plugin/skills/lit-typographic-motion/references/stage.md +190 -215
  234. package/plugin/skills/lit-typographic-motion/references/studio.md +245 -0
  235. package/plugin/skills/lit-typographic-motion/references/style-bibles.md +108 -97
  236. package/plugin/skills/lit-typographic-motion/references/treatment.md +191 -143
  237. package/plugin/skills/lit-typographic-motion/scripts/motion-doctor.mjs +17 -5
  238. package/plugin/skills/lit-typographic-motion/scripts/motion.mjs +47 -7
  239. package/plugin/skills/lit-typographic-motion/styles/paper.json +41 -0
  240. package/plugin/skills/lit-typographic-motion/styles/swiss-signal.json +41 -0
  241. package/plugin/skills/lit-typographic-motion/styles/terminalcore.json +42 -0
  242. package/plugin/skills/lit-typographic-motion/styles/tidal.json +41 -0
  243. package/plugin/skills/litresearch/SKILL.md +1 -0
  244. package/plugin/skills/readme-studio/SKILL.md +2 -0
  245. package/plugin/skills/review-work/SKILL.md +1 -1
  246. package/plugin/skills/start-work/SKILL.md +1 -1
@@ -0,0 +1,161 @@
1
+ # Neo-Brutalism
2
+
3
+ Neo-Brutalism is the loud direction, and it is loud on purpose. Every card is a flat yellow block
4
+ with a thick black border and a hard black shadow offset down and to the right, with no blur at all.
5
+ Titles are heavy and tight, the topic band is saturated blue, one pink-red accent marks the figure
6
+ the slide is for, and the ground is a warm cream. Nothing is soft: no gradients, no rounded corners,
7
+ no glow. It reads like a poster or a product sticker, so it suits a room that should feel energy,
8
+ and it stays legible because every colour pair still meets the contrast floor.
9
+
10
+ ## When to use it
11
+
12
+ Reach for Neo-Brutalism for a startup pitch at a demo day, a consumer product launch, a campaign
13
+ kick-off, a creator or community event, a hackathon final or an education deck for a young audience.
14
+ The content signals that point here are a short body (one claim and two or three facts per slide),
15
+ three or four headline numbers, a launch or sign-up ask, and words such as 런칭, 출시, 데모데이,
16
+ 캠페인, 크리에이터, or the user asking for something bold, punchy or "brutalist". It is the second
17
+ candidate for the pitch deck type, after Signal, and the first when the user asks for a bold or
18
+ playful look.
19
+
20
+ ## When it is the wrong choice
21
+
22
+ It fails for a formal report, an academic talk, a board or finance review and any deck read alone
23
+ later: the blocks take space a reader needs for detail, and a slide of long paragraphs between thick
24
+ borders reads as noise. It is wrong for grief, safety, HR or financial-loss topics, and
25
+ for a deck under a corporate brand guide. When the brief says "clean" or "minimal", Signal or Studio
26
+ fits; when it says "report", Ledger or Gazette.
27
+
28
+ ## Tokens
29
+
30
+ The values below come from the pack file and are what the engine draws.
31
+
32
+ | Token | Value |
33
+ |---|---|
34
+ | ground / surface | #FFF5E1 / #FFD43B (the yellow card) |
35
+ | ink / ink-muted / line | #111111 / #3A3A3A / #111111 |
36
+ | accent / accent-deep / accent-tint | #D81B5C / #6B0F2E / #FFC9DA |
37
+ | field / on-field | #2F4BFF / #FFFFFF |
38
+ | positive / negative | #137A43 / #111111 |
39
+ | series | #D81B5C, #2F4BFF, #111111, #137A43 |
40
+ | faces | Pretendard Bold for display, title, labels and numerals, Pretendard Regular for body; `faces: a2z` swaps to A2Z Black display, titles and numerals |
41
+ | register / ramp / hero | bold / presented (body 18 pt, labels 14, sources 12, titles 32, display 44) / allowed: a statement and a big figure may take the 72 pt hero step |
42
+ | type voice | titles tracked −2, display −3 |
43
+ | density / variance | 10 / 7 |
44
+ | radius / edge | 0 / fill and border, 2.5 pt in ink |
45
+ | shadow | 6 pt offset at 45°, ink, fully opaque, no blur |
46
+ | table | yellow header, ruled grid, protagonist row in pink tint, bold totals |
47
+ | chart | no gridlines, direct labels, series in order (pink, blue, black) |
48
+
49
+ This is the family's bold register (`register: bold`): it sets presented type and the 72 pt hero step, so
50
+ titles, figures and statements run large, but they fill the same slide-grid zones as every other
51
+ pack. A title still sits in the one title zone and the body still starts at y 120; the register
52
+ changes the size inside a zone, never the zone. The registry refuses presented type in a pack without
53
+ `register: bold`, so a report pack cannot drift into this size by accident; every pack takes its own
54
+ hero step on the cover and statements. A KPI
55
+ row keeps its bordered cards, because the card is this direction's figure. The pink accent was darkened until a pink figure on a yellow card still holds 3:1 at title
56
+ size. Losses use ink with a ▼ sign, because pink already means "look here".
57
+
58
+ The shadow is written into the file as a real outer shadow with a blur of zero, so PowerPoint,
59
+ Keynote and LibreOffice all draw the same hard edge. Every block of the blue field (a band, a
60
+ section page, a cover plate) carries the black border too.
61
+
62
+ ## QA allowances
63
+
64
+ The yellow card, the blue band and the pink accent share a content slide inside the default OF-101
65
+ limit (four hue families; a fifth fails). The gate reads this pack's `qa:` block:
66
+ `offset-shadow: true` lets OF-120 pass the hard shadow; a shadow with any blur still fails, and the
67
+ same shadow in any pack without this allowance fails. Contrast floors are unchanged.
68
+
69
+ ## Treatments by slide role
70
+
71
+ Content slides and data with a takeaway take `top-plain-large`; data, sequence, reference and
72
+ definition slides take `band` (the title in white on the blue band); image slides `bottom-anchor`;
73
+ statements `statement`. `kicker-numeral` is the third option for a sequence. The engine lays out
74
+ every treatment the family allows, keeps the role's own when the body fills, and otherwise takes the
75
+ one that leaves the least empty band. Force one with `title: <id>` on the line after `layout:`.
76
+
77
+ ## Families and variants
78
+
79
+ - `kpi-row` sets two to four results as yellow cards, each with value, label and basis.
80
+ - `big-number` is a blue panel of related figures beside the facts that explain them.
81
+ - `comparison` reads before and after across shared rows.
82
+ - `process` and `step-diagram` show three to five steps with a numeral in the accent.
83
+ - `chart-insight` carries one growth chart with its takeaway beside it.
84
+ - `table-insight` holds the one table a pitch needs, usually unit economics.
85
+ - `image-split` pairs a product shot with three short points.
86
+ - `summary-box-list` sets two to four bordered boxes of one claim each.
87
+ - `agenda`, `quote` and `statement` keep the type loud and the page open.
88
+
89
+ Covers are `cover-typographic`, `cover-split-field` and `cover-numeral`; sections are
90
+ `section-field` and `section-numeral`; closings are `closing-ask`, `closing-decision-box` and
91
+ `closing-statement`.
92
+
93
+ Display slides. The typographic cover sets the topic in white on a blue plate across the lower
94
+ half, bordered in black. A statement drenches the page in blue with the sentence in white. A big
95
+ number is a blue field panel. A closing's next step sits in a bordered box with its shadow.
96
+
97
+ ## Do
98
+
99
+ - Keep one claim per slide and write it in the first body line, in plain words.
100
+ - Give every figure its label and its basis in the card.
101
+ - Let the yellow cards carry figures and short labels, never paragraphs.
102
+ - End on `closing-ask` with the amount, its uses and the next meeting.
103
+
104
+ ## Avoid
105
+
106
+ - Blurred or soft shadows, rounded corners and gradients; the look is flat and hard.
107
+ - Thin hairlines beside the 2.5 pt borders.
108
+ - More than three fill colours on one slide.
109
+ - Muted grey text on the yellow surface.
110
+ - This direction for formal reports or sensitive topics.
111
+
112
+ ## Two worked slides
113
+
114
+ A launch deck opens its traction slide with four results as cards and two facts under them.
115
+
116
+ ```markdown
117
+ ---
118
+ layout: kpi-row
119
+
120
+ ## 베타 8주 성과, 2026년 10월
121
+
122
+ | 가입자 | 주간 재방문 | 추천 가입 | 유료 전환 |
123
+ |---|---|---|---|
124
+ | 1만 2천 명 | 46% | 38% | 7.4% |
125
+ | 목표 1만 명 | 업계 평균 25% | 광고비 0원 | 목표 5% |
126
+
127
+ > 베타 운영 기록, 2026년 8-10월 (예시)
128
+
129
+ - 광고 없이 가입자 목표를 넘겼다: 셋 중 하나 이상이 친구 추천으로 왔다
130
+ - 유료 전환 7.4%는 목표 5%를 넘었고, 연 결제가 그중 60%다
131
+ - 출처: 예시 서비스 운영 대시보드, 2026년 10월 (예시)
132
+ ---
133
+ ```
134
+
135
+ The closing states the ask, shows where the money goes and names the next step.
136
+
137
+ ```markdown
138
+ ---
139
+ layout: closing-ask
140
+
141
+ ## 시드 15억 원 사용 계획
142
+
143
+ | 쓰임 | 금액 | 시점 |
144
+ |---|---|---|
145
+ | 앱 개발 인력 4명 | 7억 원 | 2027년 상반기 |
146
+ | 크리에이터 제휴 200곳 | 4억 원 | 2027년 1분기 |
147
+ | 마케팅 실험 | 3억 원 | 상시 |
148
+ | 운영 예비비 | 1억 원 | 필요 시 |
149
+ | 합계 | 15억 원 | 12개월 |
150
+
151
+ > 투자금 쓰임 (예시 데이터)
152
+
153
+ - 요청: 시드 15억 원 투자 승인
154
+ - 기대 성과: 12개월 뒤 가입자 10만 명, 월 매출 2억 원
155
+ - 다음 단계: 11월 첫째 주 후속 미팅, 담당 예시 대표
156
+ ---
157
+ ```
158
+
159
+ ## Examples
160
+
161
+ `14-launch-pitch-neo-brutalism-ko.md`
@@ -0,0 +1,144 @@
1
+ # Newsroom
2
+
3
+ Newsroom is the direction for a data story told to people who do not read tables: a public
4
+ briefing, an explainer, a newsletter's deck, a talk that walks a general audience through a few
5
+ numbers. It looks like a newspaper's graphics desk: a black masthead band behind the title of a
6
+ data page and the cover, a heavy black rule under the other titles, grey charts with one orange series, labels on the lines, and a source and period under every figure.
7
+ The title names the topic and its period; the finding leads the body, in the first line under the
8
+ chart.
9
+
10
+ ## When to use it
11
+
12
+ Reach for Newsroom when the deck is a handful of charts with one point each, written for readers
13
+ outside the field: a city or school data briefing to residents, a survey result for members, a
14
+ newsletter's "what the numbers say", a research explainer for the press, a public talk on prices,
15
+ housing, climate or health figures. The content signals that point here are one or two charts per
16
+ idea, a finding per chart, sources and periods on every figure and
17
+ words such as 브리핑, 설명, 주민, 시민, 독자, 뉴스레터, 데이터로 본, explainer, briefing or "what the
18
+ data says". It is the first candidate for a data story for the public, ahead of Gazette and
19
+ Ledger.
20
+
21
+ ## When it is the wrong choice
22
+
23
+ It fails for an internal, dense review where people read tables line by line (Ledger), for a pitch
24
+ (Signal or Neo-Brutalism), for a lecture that builds an argument step by step (Chalk) and for a
25
+ written report that happens to be a deck (Paper or Gazette). It is wrong when there are no figures:
26
+ the grey-and-orange charts are the voice.
27
+
28
+ ## Tokens
29
+
30
+ The values below come from the pack file and are what the engine draws.
31
+
32
+ | Token | Value |
33
+ |---|---|
34
+ | ground / surface | #FBFAF7 / #EEEDEA |
35
+ | ink / ink-muted / line | #111111 / #55534D / #CCCAC5 |
36
+ | accent / accent-deep / accent-tint | #C2410C / #7C2A08 / #FBE3D3 |
37
+ | field / on-field | #111111 / #FFFFFF |
38
+ | positive / negative | #1F6B3A / #111111 |
39
+ | series | #C2410C, #77746C, #2F5D8A, #111111 |
40
+ | faces | Pretendard Bold for display, title, labels and numerals, Pretendard Regular for body; `faces: a2z` swaps to A2Z Bold display, titles and numerals |
41
+ | 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 |
42
+ | density / variance | 10 / 6 |
43
+ | radius / edge | 0 / fill |
44
+ | decoration | hairline rules, column hairlines, kicker numerals; the masthead band is the `band` title |
45
+ | table | open, no header fill, a rule under the header, bold totals |
46
+ | chart | horizontal gridlines, direct labels, the accent on the story's series over greys |
47
+
48
+ The orange holds 5.2:1 on the paper, so it can set a kicker word or a figure. The second series is a
49
+ warm grey, the third a quiet blue for the one line a story compares against. Rules and surfaces are
50
+ neutral greys: a warm-tinted rule reads as a second hue family beside the orange. A loss uses ink
51
+ with a ▼ sign.
52
+
53
+ ## QA allowances
54
+
55
+ None beyond the default craft floor. The source line under every figure is the house rule here,
56
+ and the gate's source checks already ask for it.
57
+
58
+ ## Treatments by slide role
59
+
60
+ Data slides take `band` (the title in white on the black masthead band across the top);
61
+ data-with-takeaway and image slides take `bottom-anchor` (the title over a heavy black rule); content, reference and definition slides take `top-rule`; sequences
62
+ `kicker-numeral`; statements `statement`. Every treatment draws in the slide grid's one title zone,
63
+ so a band, a bottom-anchor and a top-rule title sit at the same place and only their surface or
64
+ rule differs.
65
+ Force one with `title: <id>` on the line after `layout:`.
66
+
67
+ ## Families and variants
68
+
69
+ - `full-chart` gives one chart the whole body; `chart-insight` sets it beside two or three lines.
70
+ - `kpi-over-chart` puts the headline figures over the chart they come from.
71
+ - `big-number` and `kpi-row` carry a single figure or three.
72
+ - `figure-pair` sets two charts side by side for a before and after.
73
+ - `table-insight`, `comparison` and `timeline` hold the few tables and dates a story needs.
74
+ - `image-split`, `text-two-column` and `sidebar-note` explain a method or a term.
75
+ - `references-appendix` lists the sources at the end; `quote` and `statement` hold a resident's
76
+ sentence or the story's one finding.
77
+
78
+ Covers are `cover-typographic`, `cover-figures` and `cover-index`; sections are `section-rule` and
79
+ `section-numeral`; closings are `closing-summary-list`, `closing-statement` and `closing-ask`.
80
+
81
+ Display slides. The typographic cover sets the deck title in white on the black masthead band,
82
+ with the meta line on the band and the deck's parts on the paper under it. A statement stands between two rules. A big number sits on the orange tint. A closing's next
83
+ step stands under a rule. A deck index runs along the top of the display slides.
84
+
85
+ ## Do
86
+
87
+ - Name the topic and its period in the title; put the finding (what changed, by how much, since
88
+ when) in the first line of the body, where the gate expects a claim.
89
+ - Colour one series orange and leave the rest grey.
90
+ - Put the source and the period under every chart and table.
91
+ - Label lines and bars directly; a legend is for a chart that cannot take labels.
92
+
93
+ ## Avoid
94
+
95
+ - More than one highlighted series on a chart.
96
+ - A chart without its source and period.
97
+ - 3D, gradients or pictograms standing in for numbers.
98
+ - This direction for a pitch, a lecture or an internal dense review.
99
+
100
+ ## Two worked slides
101
+
102
+ A full chart names its topic in the title, keeps one orange line and states the finding under it.
103
+
104
+ ```markdown
105
+ ---
106
+ layout: full-chart
107
+
108
+ ## 매매가 대비 전셋값 비율, 2023-2026년
109
+
110
+ ::: chart type=line unit="%"
111
+ | 연도 | 우리 구 (%) | 시 평균 (%) |
112
+ |---|---|---|
113
+ | 2023년 | 55.2 | 56.0 |
114
+ | 2024년 | 57.1 | 56.8 |
115
+ | 2025년 | 59.4 | 57.9 |
116
+ | 2026년 | 61.3 | 58.6 |
117
+ > 매매가 대비 전셋값 비율, 해마다 6월 (예시 자료)
118
+ :::
119
+
120
+ - 우리 구의 전셋값이 처음으로 매매가의 60%를 넘었다
121
+ - 출처: 예시 구청 주택 통계, 2026년 (예시)
122
+ ---
123
+ ```
124
+
125
+ A KPI row carries three figures over what each means.
126
+
127
+ ```markdown
128
+ ---
129
+ layout: kpi-row
130
+
131
+ ## 주민 설문 결과, 2026년 9월
132
+
133
+ | 응답자 | 이사 계획 | 첫째 이유 |
134
+ |---|---|---|
135
+ | 1,204명 | 31% | 주거비 |
136
+ | 9월 1-20일, 온라인·방문 | 2년 안에 이사할 생각 | 이사 계획자의 47% |
137
+
138
+ - 출처: 예시 구 주거 실태 설문, 2026년 (예시)
139
+ ---
140
+ ```
141
+
142
+ ## Examples
143
+
144
+ `17-public-data-briefing-newsroom-ko.md`
@@ -1,174 +1,147 @@
1
1
  # Night
2
2
 
3
- Night is a stage screen in a dark room. The ground is a deep blue-black (#0F1419), the type is
4
- off-white, one amber accent marks the series or figure that matters and a soft blue serves as the
5
- second series. Numerals are light, charts take the width of the page, and surfaces are slightly lifted
6
- slate with soft corners (radius 6). The pack file draws the boundary: data and technical keynotes on
7
- a dark ground, wrong for decks printed or read on paper, and never mixed with light slides inside one
8
- deck.
3
+ Night is a screen in a dark room. The ground is a deep blue-black, type is off-white, and the one
4
+ warm accent is amber, with a soft blue as the second series. Numbers sit in labelled rows at title
5
+ size at most, each with its basis, charts take most of the page, and a header band marks the slides that hold data. The
6
+ look keeps contrast high without glare, so a chart stays readable from the back of a hall. A plot or
7
+ diagram brought in as a picture on white would stand as a white card here: give it a `.dark` variant
8
+ beside the file, or its numbers as a `::: chart` block (authoring guide, "Charts").
9
9
 
10
- ## When to choose it
10
+ ## When to use it
11
11
 
12
- Pick Night for a talk shown on a large screen in a dim room: an engineering review, a data keynote, a
13
- platform or infrastructure update, a launch of a technical product. Ten families are listed and
14
- five of them hold charts or figures (`full-chart`, `chart-insight`, `kpi-row`, `kpi-over-chart`,
15
- `dashboard-grid`), which is why a deck of metrics is the natural fit. `method` carries an architecture
16
- figure with its definitions.
12
+ Use Night for data and technical keynotes, product demos, architecture talks and quarterly reviews
13
+ shown on a big screen. It is the first candidate for a data-heavy review and moves up whenever the
14
+ brief says the deck is presented on a stage, at a demo day or in a darkened room. It also earns a
15
+ place when a third or more of the slides hold charts, because its families give charts the most
16
+ room of any pack.
17
17
 
18
- Decks that are printed, sent as PDF to be read on paper, or shown in a bright room belong in Paper or
19
- Ledger: the dark ground wastes ink and the thin strokes of a light numeral lose contrast in daylight.
18
+ ## When it is the wrong choice
19
+
20
+ Night is wrong for decks that will be printed or read at a desk: a dark page wastes toner and tires
21
+ the eye on paper, so Ledger or Gazette serve those readers. It never mixes with light slides inside
22
+ one deck. It also lacks a table-led family, so a deck that is mostly lookup tables belongs in
23
+ Ledger.
20
24
 
21
25
  ## Tokens
22
26
 
27
+ These values are read from the pack file `pack.yaml` of the `night` tonality.
28
+
23
29
  | Token | Value |
24
30
  |---|---|
25
- | ground / surface | #0F1419 / #1A222B |
26
- | ink / ink-muted / line | #E8EDF2 / #A3AEBA / #5A6672 |
27
- | accent / accent-deep / accent-tint | #E3A857 / #F2C98A / #2A2418 |
28
- | field / on-field | #1E2A36 / #F5F7FA |
29
- | positive / negative | #6CC08B / #F08A7E |
30
- | series | #E3A857, #7FB8E0, #A3AEBA, #C58FD0 |
31
- | faces | Pretendard Bold for display and titles, Pretendard Regular for body, labels and numerals; `faces: a2z` moves numerals to A2Z Light |
32
- | tracking (title / display) | -1 % / -2 % of the size |
33
- | density / variance | 10 / 6 (up to 4 title treatments) |
31
+ | ground / surface | `#0F1419` / `#1A222B` |
32
+ | ink / ink-muted | `#E8EDF2` / `#A3AEBA` |
33
+ | line | `#5A6672` |
34
+ | accent / accent-deep / accent-tint | `#E3A857` / `#F2C98A` / `#2A2418` |
35
+ | field / on-field | `#1E2A36` / `#F5F7FA` |
36
+ | positive / negative | `#6CC08B` / `#F08A7E` |
37
+ | series | `#E3A857`, `#7FB8E0`, `#A3AEBA`, `#C58FD0` |
38
+ | faces | display, title Pretendard Bold; body, label and numeral Pretendard Regular; `faces: a2z` swaps numerals to A2Z Light |
39
+ | 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 |
40
+ | density / variance | 10 / 6 |
34
41
  | radius / edge | 6 / fill |
35
- | table | header in the surface colour, hairline row rules, the row whose first cell the title names in accent-tint, bold totals |
36
- | chart | hairline gridlines, direct labels, accent on the highlighted series over muted ones |
37
- | image | no frame |
38
- | decoration | header-band, hairline-rule, numeral, rail-fill |
39
- | fill-order | anchor-visual, step-up, distribute, change-family |
40
-
41
- The pack validator enforces contrast on ten role pairs (text pairs at 4.5:1, accent on ground at 3:1),
42
- and the light-on-dark pairs here meet the same floors. On a dark page, accent-deep is the lighter amber (#F2C98A), used for text on
43
- the accent tint. Positive and negative are lighter than on white packs for the same reason. The ramp
44
- is the compact one (body 13 pt, label 11, title 26, display 36); light thin type below 18 pt loses
45
- contrast across a room, so keep numerals and labels on the regular and bold weights.
46
-
47
- ## Titles by family
48
-
49
- Role defaults: content, images and sequences take `top-plain-large` and `kicker-numeral`; data and
50
- references take `band`; data with a takeaway and definitions take `side-rail`; statements take
51
- `statement`. A `band` title sits inside a full-width band in the field colour (#1E2A36), which on this
52
- ground reads as a lit header strip. `bottom-anchor` is absent, so a pin such as `title: bottom-anchor`
53
- stops the compile with `Slide 1: title "bottom-anchor" is not one of the night treatments
54
- (top-plain-large, statement, side-rail, kicker-numeral, band)`.
55
-
56
- | Family | Default title | Then, in pack order |
57
- |---|---|---|
58
- | `full-chart` | `top-plain-large` | none |
59
- | `chart-insight` | `side-rail` | `top-plain-large`, `band` |
60
- | `kpi-row` | `band` | `top-plain-large`, `side-rail` |
61
- | `kpi-over-chart` | `band` | `top-plain-large` |
62
- | `dashboard-grid` | `band` | `side-rail` |
63
- | `big-number` | `side-rail` | `top-plain-large` |
64
- | `method` | `side-rail` | `band` |
65
- | `comparison` | `band` (numbers) / `top-plain-large` (arguments) | `top-plain-large`, `side-rail`, `band` |
66
- | `timeline` | `top-plain-large` | `band` |
67
- | `statement` | `statement` | none |
42
+ | table | header row on the surface colour with bold ink, hairline rows, no banding, numbers right-aligned, totals bold, the row the title names in the accent tint |
43
+ | chart | hairline gridlines, direct labels, accent on the item that matters and muted colours on the rest |
44
+ | decoration | header band, hairline rule, numeral, rail fill |
45
+
46
+ ## Treatments by slide role
47
+
48
+ Text slides and image slides take `top-plain-large`, a title with no rule. Data slides take
49
+ `band`, the header band across the top. Charts with a takeaway take `side-rail`, sequences take
50
+ `kicker-numeral`, definitions take `side-rail`, and a pull quote takes `statement`. When the role's
51
+ treatment would leave an empty lower band, the engine tries the other treatments the family allows
52
+ and keeps the one that fills, while staying inside the variance cap. Write `title: side-rail` (or
53
+ another allowed treatment) under the `layout:` line to fix a slide's treatment; the business review
54
+ example does this for a big number and a timeline so the deck mixes enough compositions.
68
55
 
69
56
  ## Families and variants
70
57
 
71
- - `full-chart`: one chart across the whole body with its caption; the plot is the argument.
72
- - `chart-insight`: a chart with two or three takeaways; at the compact step its values stand in a
73
- small table.
74
- - `kpi-row`, `kpi-over-chart`: results with a basis row, alone or above the trend that explains them.
75
- - `dashboard-grid`: two to four charts read together (two columns, or three for three charts), with
76
- one line of takeaway under them.
77
- - `big-number`, `method`, `comparison`, `timeline`, `statement` as in the other packs.
78
- - Covers `cover-numeral`, `cover-typographic`, `cover-figures`; sections `section-numeral`,
79
- `section-field`; closings `closing-statement`, `closing-decision-box`.
80
-
81
- Display devices: the cover is a `numeral` (a year from the title or `date` at title size in amber over
82
- the title; a deck without a year takes the plain cover), a statement is `open` (the sentence alone on
83
- the dark ground), a big number sits on the amber-tinted panel, and a closing's next step runs as a
84
- `band` in the field colour above the footer. A native chart is drawn in the pack's colours on the
85
- dark ground, so axis text and gridlines stay legible.
58
+ - `full-chart`: one chart across the body with a short note under it.
59
+ - `chart-insight`: a chart with two or three takeaways.
60
+ - `kpi-row`: two to four headline values at title size, each with what it measures and its basis.
61
+ - `kpi-over-chart`: a value row above the trend it summarises.
62
+ - `dashboard-grid`: two to four small charts read together.
63
+ - `big-number`: a panel of two to four related figures (value, label, basis) with its evidence.
64
+ - `method`: how a metric is defined, formula first.
65
+ - `comparison`: two options or two periods, row by row.
66
+ - `timeline`: dated events on one axis.
67
+ - `statement`: a pull quote, or a display-led slide the user asks for.
68
+
69
+ Covers are `cover-numeral`, `cover-typographic` and `cover-figures`. Sections are `section-numeral`
70
+ and `section-field`. Closings are `closing-statement` and `closing-decision-box`.
71
+
72
+ Display slides. The typographic cover sets the year from the deck's date at title size beside the
73
+ topic name. A statement sets its quoted line in up to three balanced lines. A big-number panel
74
+ stands in amber on the dark amber tint, one row per figure with its label and basis. A closing's rows are keyed by date or amount, and the next step runs in the
75
+ field band above the footer.
86
76
 
87
77
  ## Do
88
78
 
89
- - Keep every slide in the one dark tonality of the deck.
90
- - Draw charts natively with `::: chart`; the engine sets series colours, labels and axes for the dark
91
- ground.
92
- - Give a figure that comes from another tool a dark variant: `flow.png` is accompanied by
93
- `flow.dark.png` in the same folder and the engine picks it up.
94
- - Give each chart a caption with period and source, and name the highlighted series with a period or
95
- a reference word.
79
+ Give each chart one highlighted series in amber and let the rest sit in muted tones. Keep titles
80
+ short labels (subject, measure, period): the open title and the band have tight glyph budgets, and the compile log warns when a title
81
+ runs over. Put the source on the last slide, inside the decision box. Use big numbers only for real
82
+ figures from the source, each with its basis and a sourced caption.
96
83
 
97
84
  ## Avoid
98
85
 
99
- - Neon or saturated glows.
100
- - A pure black ground; the ground is #0F1419.
101
- - Light slides mixed in.
102
- - Thin light type below 18 pt.
103
-
104
- ## Failure patterns
105
-
106
- | Symptom | Cause | Fix |
107
- |---|---|---|
108
- | QA OF-117 "a light figure (92 % near-white) on a dark ground" | a PNG exported on a white background was placed in a `method` slide | add `<name>.dark.png` beside the picture, or redraw it as a `::: chart` |
109
- | `Compilation error: ... title "bottom-anchor" is not one of the night treatments (...)` | a pin copied from a light pack | pin one of the five treatments, or drop the pin |
110
- | a literal `> ...` line under a chart | the caption sits after the closing `:::` | put the `>` caption inside the block |
111
- | the accent lands on the wrong series | no period or reference word in the series names | name earlier series with a period or a reference word, or put the highlighted series last |
112
- | `dashboard-grid` falls back to one chart | the slide holds a single `::: chart` block | use `chart-insight`, or add a second chart |
86
+ Avoid neon or saturated glows, a pure black ground, and any light slide mixed in. Avoid thin light
87
+ type below 18 pt; it breaks up on a projector. Do not lean on red and green alone for change; pair
88
+ the
89
+ colour with a sign and an arrow.
113
90
 
114
91
  ## Two worked slides
115
92
 
116
- One chart across the body; the amber line is the latest quarter because the series names carry their
117
- quarters, and the caption sits inside the chart block.
93
+ A value row above its trend states each number once with its basis, and the chart shows where it
94
+ came from and anchors the floor of the slide.
118
95
 
119
96
  ```markdown
120
97
  ---
121
- layout: full-chart
98
+ layout: kpi-over-chart
122
99
 
123
- ## Median API latency by week
100
+ ## Cost per million requests, Q3 2025-Q3 2026
124
101
 
125
- ::: chart type=line unit="ms"
126
- | Week | Q2 median (ms) | Q3 median (ms) |
102
+ | Cost per million | Target | Change on Q2 |
127
103
  |---|---|---|
128
- | W1 | 182 | 171 |
129
- | W2 | 185 | 166 |
130
- | W3 | 181 | 158 |
131
- | W4 | 188 | 151 |
132
- | W5 | 184 | 149 |
133
- | W6 | 190 | 144 |
134
- > Median API latency, weekly, Q2 against Q3 (example data)
104
+ | $1.82 | $2.00 | ▼ −9% |
105
+ | Q3 2026 | 9% under target | fourth fall in a row |
106
+
107
+ ::: chart type=line unit="$"
108
+ | Quarter | Cost per million requests ($) |
109
+ |---|---|
110
+ | Q3 2025 | 2.61 |
111
+ | Q4 2025 | 2.34 |
112
+ | Q1 2026 | 2.12 |
113
+ | Q2 2026 | 2.00 |
114
+ | Q3 2026 | 1.82 |
115
+ > Cost per million requests by quarter (example data)
135
116
  :::
136
117
  ---
137
118
  ```
138
119
 
139
- Two charts read together under a band title, with the fix stated in two lines below them.
120
+ A big-number panel holds three related figures with their basis and three lines of evidence, so
121
+ the figures are explained on the same page.
140
122
 
141
123
  ```markdown
142
124
  ---
143
- layout: dashboard-grid
125
+ layout: big-number
126
+ title: side-rail
144
127
 
145
- ## Error rate and cache hit rate by region
128
+ ## Incident recovery time, Q3 2026
146
129
 
147
- ::: chart type=column unit="%"
148
- | Region | Error rate (%) |
149
- |---|---|
150
- | North | 0.42 |
151
- | East | 0.38 |
152
- | South | 0.61 |
153
- | West | 0.35 |
154
- > Error rate by region, Q3 (example data)
155
- :::
130
+ | Median time to recover | Auto rollbacks | Slowest recovery |
131
+ |---|---|---|
132
+ | 8 min | 2 of 3 | 21 min |
133
+ | Q2: 27 min | before paging | database failover |
156
134
 
157
- ::: chart type=column unit="%"
158
- | Region | Cache hit rate (%) |
159
- |---|---|
160
- | North | 91 |
161
- | East | 93 |
162
- | South | 84 |
163
- | West | 94 |
164
- > Cache hit rate by region, Q3 (example data)
165
- :::
135
+ > Incident log, July-September 2026 (example)
166
136
 
167
- - South carries the highest error rate and the lowest cache hit rate
168
- - Raising South's cache hit rate to the fleet average is the first fix
137
+ - Recovery time is now under ten minutes
138
+ - The median fell from 27 minutes in Q2 after automatic rollback went live in July
139
+ - Two of the three incidents were rolled back before a person was paged
140
+ - The slowest recovery, 21 minutes, was a database failover in week 9
169
141
  ---
170
142
  ```
171
143
 
172
- Both slides compile under `tonality: night` with `lang: en` and a generic cover (drawn as
173
- `cover-numeral` from the year in the title) and pass `qa_deck.py`. The platform team and the numbers
174
- are invented.
144
+ ## Examples
145
+
146
+ `04-business-review-night-en.md` and `07-data-review-night-en.md` both use the pack defaults
147
+ (density 10, variance 6).