@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,167 +1,151 @@
1
1
  # Paper
2
2
 
3
- Paper treats the screen like a printed journal page. The ground is white, the type is near-black, and
4
- structure comes from thin rules where other directions use filled boxes. Figures do most of the
5
- talking, each with a numbered caption and a source; tables use the three-rule style readers know from
6
- papers; and one deep crimson is the only colour with a job: it marks the method or result the talk
7
- proposes. The effect is calm and checkable, which is what a room of peers wants while it decides
8
- whether to believe a result.
9
-
10
- ## When to choose it
11
-
12
- Pick Paper for research talks, thesis defences, lab meetings and technical reviews where the audience
13
- reads the evidence closely. Of the eleven families, six are evidence families (`figure-academic`,
14
- `figure-pair`, `chart-insight`, `full-chart`, `table-insight`, `method`), and `references-appendix`
15
- closes the deck with a reference list whose DOIs become real links. Prefer it when the source carries
16
- numbered citations, DOIs or a references section, and when a third of the slides hold a chart. A
17
- written analysis delivered as slides also fits, because hairline tables and numbered figures survive
18
- printing.
19
-
20
- The pack file names the mismatch: a sales or launch audience, where the restraint reads as cold
21
- (Signal or Studio carry that energy). The pack has no full-bleed image family and keeps pictures
22
- inside the grid, and a large dark room asks for Night, where thin rules vanish at distance.
3
+ Paper treats the screen like a printed journal page. The ground is white, the type is near-black,
4
+ and structure comes from thin rules rather than filled boxes. Figures do most of the talking, each
5
+ with a numbered caption and a source, and tables are set in the three-rule style readers know from
6
+ papers. One deep crimson is the only colour with a job: it marks the method or result the talk
7
+ proposes, and nothing else. The effect is calm and checkable, which is what a room of peers wants
8
+ when they are deciding whether to believe a result.
9
+
10
+ ## When to use it
11
+
12
+ Pick Paper for research talks, thesis defences, lab meetings and technical reviews where the
13
+ audience reads the evidence closely. It is the first candidate for the research-talk deck type, and
14
+ it moves up the list when the source carries numbered citations, DOIs or a references section, or
15
+ when a third or more of the slides hold a chart. It also suits a written analysis that happens to be
16
+ delivered as slides, because its hairline tables and numbered figures survive printing.
17
+
18
+ ## When it is the wrong choice
19
+
20
+ Paper reads as cold to a sales, launch or investor audience; there Signal or Studio carry the
21
+ energy the room expects. It is also a poor fit for a deck of mostly photographs, since the pack has
22
+ no full-bleed image family and keeps pictures inside the grid. If the talk is given on a large
23
+ stage in a dark room, Night keeps charts legible at distance where Paper's thin rules disappear.
23
24
 
24
25
  ## Tokens
25
26
 
27
+ These values are read from the pack file `pack.yaml` of the `paper` tonality.
28
+
26
29
  | Token | Value |
27
30
  |---|---|
28
- | ground / surface | #FFFFFF / #F5F5F6 |
29
- | ink / ink-muted / line | #111418 / #50565E / #C9CDD2 |
30
- | accent / accent-deep / accent-tint | #8C1C2B / #5E121C / #F6E6E8 |
31
- | field / on-field | #111418 / #FFFFFF |
32
- | positive / negative | #1E6B3A / #50565E |
33
- | series | #8C1C2B, #111418, #50565E, #2E5E8A |
34
- | faces | Pretendard Bold for display and titles, Pretendard Regular for body, labels and numerals; `faces: a2z` keeps the same map |
35
- | tracking (title / display) | 0 % / -1 % of the size |
36
- | density / variance | 10 / 5 (up to 4 title treatments, all four of the pack) |
31
+ | ground / surface | `#FFFFFF` / `#F5F5F6` |
32
+ | ink / ink-muted | `#111418` / `#50565E` |
33
+ | line | `#C9CDD2` |
34
+ | accent / accent-deep / accent-tint | `#8C1C2B` / `#5E121C` / `#F6E6E8` |
35
+ | field / on-field | `#111418` / `#FFFFFF` |
36
+ | positive / negative | `#1E6B3A` / `#50565E` |
37
+ | series | `#8C1C2B`, `#111418`, `#50565E`, `#2E5E8A` |
38
+ | faces | display and title Pretendard Bold; body, label and numeral Pretendard Regular (`faces: a2z` keeps the same map) |
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 / 5 |
37
41
  | radius / edge | 0 / border |
38
- | table | booktabs: a 1 pt ink rule above the header, 0.5 pt under it, 1 pt at the end; no fill, no banding, right-aligned figures, bold totals |
39
- | chart | hairline gridlines, direct labels, `series-order`: the highlighted series takes the accent, the others take ink, muted ink and the blue in order |
40
- | image | no frame |
41
- | decoration | hairline-rule, box-outline |
42
- | fill-order | anchor-visual, distribute, step-up, change-family |
43
-
44
- `edge: border` means every surface (a summary box, a note, a decision box) is an outline in the line
45
- colour with no fill, so the page never gains a coloured card. A drop is shown with the muted ink,
46
- because negative equals `ink-muted`: a sign and a glyph carry the meaning, and the accent stays free for
47
- the proposed method. Without `accent-rule` in the decoration list, a `top-rule` title always sits on a
48
- full hairline.
49
-
50
- ## Titles by family
51
-
52
- Role defaults: content, data, sequences and references `top-rule`; data with a takeaway and images
53
- `bottom-anchor`; definitions `side-rail`; statements `statement`. The pack's `structure` draws a
54
- `comparison` as a ruled table under `top-rule`, and that title stays even when the deck already leans
55
- on it.
56
-
57
- | Family | Default title | Then, in pack order |
58
- |---|---|---|
59
- | `figure-academic` | `bottom-anchor` | `top-rule`, `side-rail` |
60
- | `figure-pair` | `bottom-anchor` | `top-rule`, `side-rail` |
61
- | `method` | `side-rail` | `top-rule` |
62
- | `chart-insight` | `bottom-anchor` | `top-rule`, `side-rail` |
63
- | `full-chart` | `bottom-anchor` | `top-rule` |
64
- | `table-insight` | `top-rule` | `bottom-anchor`, `side-rail` |
65
- | `comparison` | `top-rule` | `bottom-anchor`, `side-rail` |
66
- | `quote` | `statement` | `top-rule` |
67
- | `statement` | `statement` | none |
68
- | `text-column` | `top-rule` | `side-rail` |
69
- | `references-appendix` | `top-rule` | none |
70
-
71
- A `bottom-anchor` title stands on the floor with a hairline 12 pt above it, so the chart or figure
72
- takes the upper body and the title labels it from below. A table never takes a bottom title while
73
- another title fits. Pin with `title: top-rule` after `layout:` when a figure slide needs the title at
74
- the top.
42
+ | table | booktabs: heavy rule over the header, light rule under it, heavy rule at the end; no fill, no banding; numbers right-aligned; totals bold |
43
+ | chart | hairline gridlines, direct labels, series in order (the proposed method takes the accent, baselines take ink and muted ink) |
44
+ | decoration | hairline rule, box outline |
45
+
46
+ Negative values share the muted ink on purpose: a drop is shown with a sign and a glyph, never with
47
+ a
48
+ warning colour that would compete with the accent.
49
+
50
+ ## Treatments by slide role
51
+
52
+ Text slides, data tables, sequences and reference pages take `top-rule`, where the rule under the
53
+ title is a full hairline. Charts and figures that carry the slide take `bottom-anchor`, the title
54
+ closed by a heavy rule over a picture that takes the body's full height. Definitions and method slides
55
+ take `side-rail`, a comparison is drawn as a ruled table under a `top-rule` title (the pack's
56
+ `structure`, kept even when the deck already leans on that title), and a quoted line takes `statement`. The engine keeps the role's treatment when
57
+ the body fills to the density band; when it would leave a tall empty band, it lays the slide out
58
+ under the other treatments the family allows and keeps the one that fills best, while capping how
59
+ many treatments one deck mixes. A slide can ask for a specific treatment with a `title:` line under
60
+ its `layout:` line, for example `title: top-rule`, as long as the family allows it.
75
61
 
76
62
  ## Families and variants
77
63
 
78
- - `figure-academic`: one figure with its numbered caption and three bold-headed observations
79
- (Observation, Basis, Implication).
64
+ - `figure-academic`: one figure with its numbered caption and a short observation, basis and
65
+ implication.
80
66
  - `figure-pair`: two figures side by side, for before and after or two conditions.
81
67
  - `method`: a formula or process figure beside the definitions of its symbols.
82
- - `chart-insight`, `full-chart`: a native chart with two or three takeaways, or across the body; at
83
- the compact step the chart's values stand in a small table beside the takeaways.
84
- - `table-insight`, `comparison`, `quote`, `statement`, `text-column`, `references-appendix` as the
85
- list above shows.
86
- - Covers `cover-index` (needs an agenda or two sections), `cover-typographic`, `cover-split-image`;
87
- sections `section-rule`, `section-field`; closings `closing-summary-list`, `closing-ask`.
88
-
89
- Display devices: the typographic cover is a journal title page (a 2 pt rule at y 96, the title, a
90
- hairline, the presenter in bold, then department and date in one line); a statement stands between
91
- two hairlines like an epigraph; a big number sits in an ink outline; a section with an agenda is the
92
- index page, this part in the accent; a closing's next step sits under a hairline on the page foot.
68
+ - `chart-insight`: a native chart with two or three takeaways beside it.
69
+ - `full-chart`: a chart across the body when the plot itself is the argument.
70
+ - `table-insight`: a booktabs table with its caption and the takeaway it supports.
71
+ - `comparison`: contributions against limits, or two methods row by row.
72
+ - `quote`: a participant's or reviewer's words as a statement.
73
+ - `statement`: an epigraph or quoted line; the research question and the finding go in a labelled
74
+ content slide with their evidence.
75
+ - `text-column`: running argument at reading measure.
76
+ - `references-appendix`: the reference list, one entry per row.
77
+
78
+ Covers are `cover-index` (lists the deck's sections, so it needs at least two), `cover-typographic`
79
+ and `cover-split-image`. Sections are `section-rule` and `section-field`. Closings are
80
+ `closing-summary-list` and `closing-ask`.
81
+
82
+ Display slides. The typographic cover is a journal title page: a heavy rule, the title, a hairline,
83
+ then the presenter and, under it, the place and date. A statement sits between two hairlines, like
84
+ an epigraph. A section shows the deck's parts in one line under its rule, this part in the accent. A
85
+ closing's next step sits under a rule at the foot of the page, its rows keyed by date.
93
86
 
94
87
  ## Do
95
88
 
96
- - Number every figure and table caption and give each a source (the engine numbers them).
97
- - Title each slide with what it shows ("Conversion at 60 min by feed rate"); the finding is the first
98
- observation.
99
- - Keep the crimson for the proposed method in every chart, so the audience learns its meaning on the
100
- first plot; name the other series with a reference word (Baseline, Prior, Plan) or a period.
101
- - Put the data fact that bounds a result on the same slide, beside the number it affects.
102
- - End with the reference list; write each DOI or URL as a Markdown link.
89
+ Number every figure and table caption and give each a source. Title each slide with what it shows
90
+ ("Conversion at 60 min by feed rate"), and put the finding in the first observation. Keep the crimson for the proposed
91
+ method in every chart, so the audience learns its meaning on the first plot. Put the data fact that
92
+ bounds a result on the same slide, beside the number it affects. End with the reference list, so the last page carries the
93
+ deck's sources.
103
94
 
104
95
  ## Avoid
105
96
 
106
- - The short accent bar under a title; this direction draws a hairline.
107
- - Coloured card fills.
108
- - The accent on anything other than the proposed method.
109
- - A figure without a numbered caption.
110
-
111
- ## Failure patterns
112
-
113
- | Symptom | Cause | Fix |
114
- |---|---|---|
115
- | QA `appendix_links` fails on a slide titled "Appendix" or "부록" | a DOI typed as plain text | write `[doi:10.x/y](https://doi.org/10.x/y)`; the engine writes a hyperlink relationship |
116
- | QA `anti_slop: forbidden_terms` | a word such as "placeholder", "tbd" or "todo" anywhere in a slide | rewrite the entry; the list matches substrings |
117
- | `note: slide 1: cover-index cannot be drawn (the deck has no agenda or sections to list)` | the deck has no agenda and fewer than two section slides | add an agenda or use `cover-typographic` |
118
- | the crimson lands on the baseline series | no period or reference word in the series names, so the last column wins | order the columns baseline first, proposed last |
119
- | a figure slide with no "Figure N." line | the alt text is empty | write the caption as the alt text |
97
+ Avoid the short accent bar under a title; in this direction the rule is a hairline. Avoid coloured
98
+ card fills, which turn a paper into a dashboard. Do not let the accent mark anything that is not the
99
+ proposed method, and never show a figure without its numbered caption.
120
100
 
121
101
  ## Two worked slides
122
102
 
123
- A chart slide where the proposed series takes the crimson because the other column is named
124
- `Baseline`. The compile adds the values table beside the takeaways and numbers the caption.
103
+ A table slide labels the table in the title and states the takeaway first beside it, so the body
104
+ fills and the reader does not have to compute the gain.
125
105
 
126
106
  ```markdown
127
107
  ---
128
- layout: chart-insight
129
-
130
- ## Glucose yield at 24 h by enzyme dose
131
-
132
- ::: chart type=column unit="%"
133
- | Enzyme dose (U/g) | Baseline (%) | Staged addition (%) |
134
- |---|---|---|
135
- | 5 | 41 | 52 |
136
- | 10 | 55 | 68 |
137
- | 15 | 63 | 77 |
138
- | 20 | 66 | 80 |
139
- > Glucose yield at 24 hours, mean of three runs (example data)
140
- :::
141
-
142
- - Staged addition raises the yield at every dose, by 11 to 14 points
143
- - The gain is largest at 10 U/g, where yield rises from 55 % to 68 %
144
- - Beyond 15 U/g both curves flatten, so extra enzyme adds little
145
- - Source: example bench log, runs 1-3
108
+ layout: table-insight
109
+
110
+ ## Conversion at 60 min by feed rate and feed mode
111
+
112
+ | Feed rate (L/min) | Single feed (%) | Staged feed (%) | Gain (points) |
113
+ |---|---|---|---|
114
+ | 0.5 | 52 | 77 | 25 |
115
+ | 0.75 | 51 | 76 | 25 |
116
+ | 1.0 | 50 | 75 | 25 |
117
+ | 1.5 | 47 | 71 | 24 |
118
+ | 2.0 | 41 | 64 | 23 |
119
+
120
+ > Table 1. Conversion at 60 minutes by feed rate, three replicates each (example data)
121
+
122
+ - The gain holds at all five feed rates tested (+23 to +25 points)
123
+ - The relative gain is 48-56% at every rate
124
+ - The gap narrows by two points at the highest rate
125
+ - Heat removal, not the feed schedule, limits the fastest runs
146
126
  ---
147
127
  ```
148
128
 
149
- A figure with its observation, basis and implication, each led by a bold label; the compile adds the
150
- colon after each label (OF-118 checks it).
129
+ A method slide pairs the process figure with every symbol the talk will use, so later charts need
130
+ no legend.
151
131
 
152
132
  ```markdown
153
133
  ---
154
- layout: figure-academic
134
+ layout: method
155
135
 
156
- ## Reactor layout with three feed ports
136
+ ## Three-stage feed layout and symbols
157
137
 
158
- ![Figure 2. Reactor with three feed ports along the column | Source: example image](assets/example-b.png)
138
+ ![Figure 2. Process layout used in all runs | Source: example image](assets/example-b.png)
159
139
 
160
- - **Observation** feed enters at ports A, B and C in a 50/30/20 split by volume
161
- - **Basis** all twelve runs used the same column and the same residence time of 24 hours
162
- - **Implication** the gain in Figure 1 comes from the feed schedule alone
140
+ - **Layout** feed split into three stages along the reactor
141
+ - **X** conversion, the fraction of feed that reacted
142
+ - **k** first-order rate constant, 1/min
143
+ - **τ** residence time per stage, min
144
+ - **n** number of feed stages, three in every run
145
+ - **q** feed split between stages, 50/30/20 by volume
163
146
  ---
164
147
  ```
165
148
 
166
- Both slides compile under `tonality: paper` with `lang: en` and a generic cover (drawn as
167
- `cover-typographic`) and pass `qa_deck.py`; the laboratory and the data are invented.
149
+ ## Examples
150
+
151
+ `05-research-talk-paper-en.md` uses the pack defaults (density 10, variance 5).
@@ -0,0 +1,137 @@
1
+ # Riso
2
+
3
+ Riso is the direction for a community, culture or education programme: a workshop, a festival, a
4
+ library or museum programme, a student club, a nonprofit's year in review. It prints in two spot
5
+ inks on warm paper, the look of a risograph poster. Teal fills the cover, the section openers and
6
+ the statements edge to edge and runs as a band behind the title of a data page; pink marks the one
7
+ word or figure that matters on a content page. Everything else is dark-blue type, grey cards and
8
+ grey rules, so the two inks are the only colours on the paper.
9
+
10
+ ## When to use it
11
+
12
+ Reach for Riso when the audience is the public or a community rather than a board: a workshop or
13
+ class opener, a festival or exhibition programme, a library, museum or youth-centre season, a
14
+ volunteer briefing, a club's recruiting talk, a nonprofit's annual gathering. The content signals
15
+ that point here are a programme with dates and places, a few counts (participants, sessions,
16
+ volunteers), steps for taking part and words such as 워크숍, 프로그램, 축제, 동아리, 도서관, 주민,
17
+ 참여, 자원봉사, community, programme or zine. It is the first candidate for a community, culture or
18
+ education programme, ahead of Studio and Bauhaus.
19
+
20
+ ## When it is the wrong choice
21
+
22
+ It fails for a board, finance or public-sector report, where two bright inks read as unserious, and
23
+ for a dense data review (Ledger) or a data story for the general public that lives on its charts
24
+ (Newsroom). It is wrong for grief, safety or financial-loss topics. For a design-history lecture,
25
+ Bauhaus; for a pitch, Signal or Neo-Brutalism.
26
+
27
+ ## Tokens
28
+
29
+ The values below come from the pack file and are what the engine draws.
30
+
31
+ | Token | Value |
32
+ |---|---|
33
+ | ground / surface | #F5F0E6 / #E4E2DE |
34
+ | ink / ink-muted / line | #1C2433 / #4E5361 / #C4C1BB |
35
+ | accent / accent-deep / accent-tint | #D1206B / #8A1043 / #F8D5E3 |
36
+ | field / on-field | #00727A / #FFFFFF |
37
+ | positive / negative | #1D6B45 / #1C2433 |
38
+ | series | #D1206B, #00727A, #1C2433, #8A6A00 |
39
+ | faces | Pretendard Bold for display, title, labels and numerals, Pretendard Regular for body; `faces: a2z` swaps to A2Z Bold display, titles and numerals |
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 |
42
+ | radius / edge | 6 / fill |
43
+ | decoration | a pink underline under top titles, teal colour fields, kicker numerals |
44
+ | table | a pink-tint header, a rule under it, grey banding, bold totals |
45
+ | chart | no gridlines, direct labels, the accent on the highlighted series over muted ones |
46
+
47
+ The pink is the fluorescent ink darkened until it holds 4.5:1 on the paper, so it can set a word;
48
+ the teal holds white type at 5.6:1. A loss uses ink with a ▼ sign, since pink is the accent. The
49
+ fourth series colour is an ochre that holds 3:1 on the paper.
50
+
51
+ ## QA allowances
52
+
53
+ Teal and pink share a content slide inside the default OF-101 limit, since a band title in teal over
54
+ a pink figure is the two-ink print this pack imitates; the two inks are the register, not a gate limit. The surface and
55
+ the rules are grey on purpose: a warm beige card would read as a third hue family and fail.
56
+
57
+ ## Treatments by slide role
58
+
59
+ Content, image and data-with-takeaway slides take `top-plain-large` (a large title over a pink
60
+ underline); data and reference slides take `band` (the title in white on a teal band across the top);
61
+ sequences `kicker-numeral`; definitions `side-rail`; statements `statement`. Every treatment draws
62
+ in the slide grid's one title zone, so a band and a plain title sit at the same place and only
63
+ their surface differs. Force one with `title: <id>` on the line after `layout:`.
64
+
65
+ ## Families and variants
66
+
67
+ - `agenda` opens a programme with its sessions; `timeline` sets the season by date.
68
+ - `process` and `step-diagram` show how to take part, in three to five steps.
69
+ - `kpi-row` and `big-number` carry the few counts such a deck has (people, sessions, books).
70
+ - `summary-box-list`, `sidebar-note` and `text-two-column` explain what each session gives.
71
+ - `comparison` reads two tracks or two age groups side by side.
72
+ - `image-split` and `photo-grid` show last year's sessions; `chart-insight` and `table-insight` hold
73
+ a small result.
74
+ - `quote` sets a participant's sentence; `statement` holds the programme's one idea.
75
+
76
+ Covers are `cover-typographic`, `cover-numeral` and `cover-split-field`; sections are
77
+ `section-field` and `section-numeral`; closings are `closing-ask`, `closing-summary-list` and
78
+ `closing-statement`.
79
+
80
+ Display slides. The typographic cover drenches the page in teal and sets the title in white on the
81
+ cover's title zone, with the meta line above and the parts across the strip. A statement and a
82
+ section opener take the same teal drench. A big number sits on a teal panel. A closing's next step
83
+ stands on a teal band across the body floor.
84
+
85
+ ## Do
86
+
87
+ - Keep full teal fields on display slides; on a content page teal is the title band and nothing more.
88
+ - Let pink mark one word or one figure on a content slide.
89
+ - Give every session a date, a place and who it is for.
90
+ - Write the way the organisers talk to participants: short, plain and inviting.
91
+
92
+ ## Avoid
93
+
94
+ - A third ink beside pink and teal (black is the type, not an ink).
95
+ - The fluorescent pink as text; the darkened accent is the type colour.
96
+ - Gradients, grain or halftone painted to fake the print.
97
+ - This direction for a board, finance, public-sector or sensitive topic.
98
+
99
+ ## Two worked slides
100
+
101
+ A process slide shows how to take part, one step per row.
102
+
103
+ ```markdown
104
+ ---
105
+ layout: process
106
+
107
+ ## 참여는 이렇게: 신청부터 첫 모임까지
108
+
109
+ - **1. 신청** 10월 31일까지 도서관 누리집에서 한 사람씩 신청한다
110
+ - **2. 안내 문자** 모임 사흘 전 장소와 준비물을 문자로 받는다
111
+ - **3. 첫 모임** 11월 7일 저녁 7시, 3층 다목적실에서 만난다
112
+ - **4. 소모임 배정** 첫 모임에서 관심사별로 다섯 명씩 나눈다
113
+ - 출처: 예시 도서관 운영 계획, 2026년 (예시)
114
+ ---
115
+ ```
116
+
117
+ A KPI row carries last season's counts, with what they mean under each.
118
+
119
+ ```markdown
120
+ ---
121
+ layout: kpi-row
122
+
123
+ ## 지난 시즌, 숫자로 본 우리 모임
124
+
125
+ | 참가자 | 모임 | 만든 책자 |
126
+ |---|---|---|
127
+ | 148명 | 24회 | 6권 |
128
+ | 2025년 가을·겨울 | 주 1회, 12주씩 두 번 | 소모임별 1권 |
129
+
130
+ - 참가자의 절반이 처음 온 주민이었다
131
+ - 출처: 예시 도서관 운영 보고, 2026년 (예시)
132
+ ---
133
+ ```
134
+
135
+ ## Examples
136
+
137
+ `16-community-programme-riso-ko.md`