@litfamily/litgravity 0.1.1 → 0.1.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (246) hide show
  1. package/CHANGELOG.md +27 -0
  2. package/README.md +17 -3
  3. package/README_ko-KR.md +17 -3
  4. package/package.json +1 -1
  5. package/plugin/hooks/lib/lanes.mjs +65 -0
  6. package/plugin/hooks/lib/motion.mjs +34 -5
  7. package/plugin/hooks/lib/reentry.mjs +7 -0
  8. package/plugin/hooks/lib/rewind/brief.mjs +332 -0
  9. package/plugin/hooks/lib/rewind/collect.mjs +328 -0
  10. package/plugin/hooks/lib/rewind/gauge.mjs +55 -0
  11. package/plugin/hooks/lib/rewind/next-step.mjs +77 -0
  12. package/plugin/hooks/lib/rewind/redact.mjs +60 -0
  13. package/plugin/hooks/lib/rewind/transcripts.mjs +211 -0
  14. package/plugin/hooks/lib/routes.mjs +79 -5
  15. package/plugin/hooks/lib/workflow-stack.mjs +213 -0
  16. package/plugin/hooks/post-tool-use.mjs +37 -1
  17. package/plugin/hooks/pre-invocation.mjs +91 -2
  18. package/plugin/hooks/session-start.mjs +26 -3
  19. package/plugin/hooks/stop.mjs +22 -2
  20. package/plugin/hud/looks.mjs +29 -0
  21. package/plugin/hud/render.mjs +234 -12
  22. package/plugin/plugin.json +1 -1
  23. package/plugin/skills/frontend-ui-ux/SKILL.md +12 -1
  24. package/plugin/skills/frontend-ui-ux/kit/components.css +417 -0
  25. package/plugin/skills/frontend-ui-ux/kit/fonts.json +22 -0
  26. package/plugin/skills/frontend-ui-ux/kit/layouts/landing.html +164 -0
  27. package/plugin/skills/frontend-ui-ux/kit/layouts/settings.html +114 -0
  28. package/plugin/skills/frontend-ui-ux/kit/layouts/workspace.html +115 -0
  29. package/plugin/skills/frontend-ui-ux/kit/styles/computational-brutalism.json +227 -0
  30. package/plugin/skills/frontend-ui-ux/kit/styles/field-notes.json +205 -0
  31. package/plugin/skills/frontend-ui-ux/kit/styles/graphite.json +200 -0
  32. package/plugin/skills/frontend-ui-ux/kit/styles/meadow.json +199 -0
  33. package/plugin/skills/frontend-ui-ux/kit/styles/neo-brutalism.json +222 -0
  34. package/plugin/skills/frontend-ui-ux/kit/ui.js +226 -0
  35. package/plugin/skills/frontend-ui-ux/references/house-styles.md +234 -0
  36. package/plugin/skills/frontend-ui-ux/scripts/design-lock.mjs +400 -0
  37. package/plugin/skills/frontend-ui-ux/scripts/interface-probe-lock.mjs +196 -0
  38. package/plugin/skills/frontend-ui-ux/scripts/interface-probe-page.mjs +30 -9
  39. package/plugin/skills/frontend-ui-ux/scripts/interface-probe-rules.mjs +20 -8
  40. package/plugin/skills/frontend-ui-ux/scripts/interface-probe.mjs +42 -9
  41. package/plugin/skills/frontend-ui-ux/scripts/pixel-art.mjs +60 -0
  42. package/plugin/skills/lit-adhd/SKILL.md +157 -0
  43. package/plugin/skills/lit-adhd/references/card-examples.md +101 -0
  44. package/plugin/skills/lit-adhd/references/status-taxonomy.md +32 -0
  45. package/plugin/skills/lit-adhd/scripts/rewind.mjs +5 -0
  46. package/plugin/skills/lit-diagram-drawer/SKILL.md +5 -3
  47. package/plugin/skills/lit-diagram-drawer/references/drawing-rules.md +1 -1
  48. package/plugin/skills/lit-diagram-drawer/references/style-guide.md +21 -12
  49. package/plugin/skills/lit-diagram-drawer/references/type-architecture.md +3 -3
  50. package/plugin/skills/lit-diagram-drawer/references/type-dependency.md +1 -1
  51. package/plugin/skills/lit-diagram-drawer/references/type-tree.md +3 -3
  52. package/plugin/skills/lit-diagram-drawer/references/type-wardley.md +1 -1
  53. package/plugin/skills/lit-diagram-drawer/scripts/diagram-craft-rules.mjs +1 -2
  54. package/plugin/skills/lit-diagram-drawer/scripts/visual-quality.mjs +1 -2
  55. package/plugin/skills/lit-docx/SKILL.md +3 -3
  56. package/plugin/skills/lit-handoff/SKILL.md +1 -0
  57. package/plugin/skills/lit-hijack/SKILL.md +263 -0
  58. package/plugin/skills/lit-hijack/references/capture-and-provenance.md +100 -0
  59. package/plugin/skills/lit-hijack/references/clean-room-build.md +75 -0
  60. package/plugin/skills/lit-hijack/references/distil-and-licence.md +67 -0
  61. package/plugin/skills/lit-hijack/references/gap-and-port-design.md +100 -0
  62. package/plugin/skills/lit-hijack/references/parity-and-report.md +85 -0
  63. package/plugin/skills/lit-hijack/scripts/hijack.mjs +953 -0
  64. package/plugin/skills/lit-plan/SKILL.md +1 -1
  65. package/plugin/skills/lit-pptx/SKILL.md +8 -8
  66. package/plugin/skills/lit-pptx/fonts/jetbrains-mono/JetBrainsMono-Bold.ttf +0 -0
  67. package/plugin/skills/lit-pptx/fonts/jetbrains-mono/JetBrainsMono-Regular.ttf +0 -0
  68. package/plugin/skills/lit-pptx/fonts/jetbrains-mono/OFL.txt +93 -0
  69. package/plugin/skills/lit-pptx/fonts/provenance.json +32 -1
  70. package/plugin/skills/lit-pptx/references/agents/analyst.md +34 -56
  71. package/plugin/skills/lit-pptx/references/agents/antithesis.md +49 -67
  72. package/plugin/skills/lit-pptx/references/agents/architect.md +38 -51
  73. package/plugin/skills/lit-pptx/references/agents/critic.md +25 -41
  74. package/plugin/skills/lit-pptx/references/agents/synthesizer.md +37 -46
  75. package/plugin/skills/lit-pptx/references/agents/thesis.md +29 -49
  76. package/plugin/skills/lit-pptx/references/anti-slop-checklist.md +119 -145
  77. package/plugin/skills/lit-pptx/references/authoring-guide.md +187 -278
  78. package/plugin/skills/lit-pptx/references/consensus-protocol.md +99 -97
  79. package/plugin/skills/lit-pptx/references/data-display-cookbook.md +36 -137
  80. package/plugin/skills/lit-pptx/references/density-and-fill.md +147 -216
  81. package/plugin/skills/lit-pptx/references/design-system-azure.md +56 -85
  82. package/plugin/skills/lit-pptx/references/direction-step.md +134 -176
  83. package/plugin/skills/lit-pptx/references/examples/01-pitch-signal-ko.md +114 -115
  84. package/plugin/skills/lit-pptx/references/examples/02-pitch-studio-ko.md +66 -66
  85. package/plugin/skills/lit-pptx/references/examples/03-business-review-ledger-ko.md +63 -63
  86. package/plugin/skills/lit-pptx/references/examples/04-business-review-night-en.md +96 -96
  87. package/plugin/skills/lit-pptx/references/examples/05-research-talk-paper-en.md +81 -81
  88. package/plugin/skills/lit-pptx/references/examples/06-lecture-chalk-ko.md +103 -103
  89. package/plugin/skills/lit-pptx/references/examples/07-data-review-night-en.md +100 -98
  90. package/plugin/skills/lit-pptx/references/examples/08-image-led-atlas-ko.md +76 -76
  91. package/plugin/skills/lit-pptx/references/examples/09-briefing-gazette-ko.md +96 -96
  92. package/plugin/skills/lit-pptx/references/examples/10-status-update-ledger-ko.md +80 -80
  93. package/plugin/skills/lit-pptx/references/examples/11-portfolio-studio-en.md +72 -72
  94. package/plugin/skills/lit-pptx/references/examples/12-research-tutorial-chalk-en.md +95 -95
  95. package/plugin/skills/lit-pptx/references/examples/13-engineering-review-computational-brutalism-ko.md +173 -0
  96. package/plugin/skills/lit-pptx/references/examples/14-launch-pitch-neo-brutalism-ko.md +154 -0
  97. package/plugin/skills/lit-pptx/references/examples/15-design-lecture-bauhaus-ko.md +139 -0
  98. package/plugin/skills/lit-pptx/references/examples/16-community-programme-riso-ko.md +158 -0
  99. package/plugin/skills/lit-pptx/references/examples/17-public-data-briefing-newsroom-ko.md +179 -0
  100. package/plugin/skills/lit-pptx/references/interview-protocol.md +83 -102
  101. package/plugin/skills/lit-pptx/references/layout-families.md +161 -265
  102. package/plugin/skills/lit-pptx/references/stages/autopilot.md +30 -70
  103. package/plugin/skills/lit-pptx/references/stages/interview.md +36 -68
  104. package/plugin/skills/lit-pptx/references/stages/plan.md +26 -67
  105. package/plugin/skills/lit-pptx/references/title-treatments.md +93 -145
  106. package/plugin/skills/lit-pptx/references/tonalities/atlas.md +95 -108
  107. package/plugin/skills/lit-pptx/references/tonalities/bauhaus.md +140 -0
  108. package/plugin/skills/lit-pptx/references/tonalities/chalk.md +107 -122
  109. package/plugin/skills/lit-pptx/references/tonalities/computational-brutalism.md +150 -0
  110. package/plugin/skills/lit-pptx/references/tonalities/gazette.md +87 -111
  111. package/plugin/skills/lit-pptx/references/tonalities/ledger.md +96 -125
  112. package/plugin/skills/lit-pptx/references/tonalities/neo-brutalism.md +161 -0
  113. package/plugin/skills/lit-pptx/references/tonalities/newsroom.md +144 -0
  114. package/plugin/skills/lit-pptx/references/tonalities/night.md +104 -131
  115. package/plugin/skills/lit-pptx/references/tonalities/paper.md +114 -130
  116. package/plugin/skills/lit-pptx/references/tonalities/riso.md +137 -0
  117. package/plugin/skills/lit-pptx/references/tonalities/signal.md +96 -103
  118. package/plugin/skills/lit-pptx/references/tonalities/studio.md +81 -112
  119. package/plugin/skills/lit-pptx/scripts/compile-deck.js +4 -6
  120. package/plugin/skills/lit-pptx/scripts/craft_extras.py +135 -91
  121. package/plugin/skills/lit-pptx/scripts/deck_craft.py +1 -1
  122. package/plugin/skills/lit-pptx/scripts/embed_fonts.py +13 -1
  123. package/plugin/skills/lit-pptx/scripts/layout_inventory.py +1 -1
  124. package/plugin/skills/lit-pptx/scripts/learn_template.py +1 -1
  125. package/plugin/skills/lit-pptx/scripts/lib/grid-resolver.js +101 -110
  126. package/plugin/skills/lit-pptx/scripts/lib/layout-resolver.js +9 -15
  127. package/plugin/skills/lit-pptx/scripts/lib/render-pack.js +370 -563
  128. package/plugin/skills/lit-pptx/scripts/lib/slide-grid.js +104 -0
  129. package/plugin/skills/lit-pptx/scripts/lib/template-registry.js +57 -6
  130. package/plugin/skills/lit-pptx/scripts/qa_deck.py +6 -6
  131. package/plugin/skills/lit-pptx/scripts/render_pages.py +31 -0
  132. package/plugin/skills/lit-pptx/scripts/validate_pptx.py +1 -1
  133. package/plugin/skills/lit-pptx/specs/markdown-slide-spec-v1.md +167 -191
  134. package/plugin/skills/lit-pptx/specs/markdown-slide-spec-v2.md +117 -166
  135. package/plugin/skills/lit-pptx/specs/template-enrollment-contract.md +307 -330
  136. package/plugin/skills/lit-pptx/templates/tonalities/atlas/pack.yaml +1 -1
  137. package/plugin/skills/lit-pptx/templates/tonalities/bauhaus/pack.yaml +98 -0
  138. package/plugin/skills/lit-pptx/templates/tonalities/chalk/pack.yaml +1 -1
  139. package/plugin/skills/lit-pptx/templates/tonalities/computational-brutalism/pack.yaml +99 -0
  140. package/plugin/skills/lit-pptx/templates/tonalities/gazette/pack.yaml +1 -1
  141. package/plugin/skills/lit-pptx/templates/tonalities/ledger/pack.yaml +1 -1
  142. package/plugin/skills/lit-pptx/templates/tonalities/neo-brutalism/pack.yaml +107 -0
  143. package/plugin/skills/lit-pptx/templates/tonalities/newsroom/pack.yaml +99 -0
  144. package/plugin/skills/lit-pptx/templates/tonalities/night/pack.yaml +1 -1
  145. package/plugin/skills/lit-pptx/templates/tonalities/paper/pack.yaml +1 -1
  146. package/plugin/skills/lit-pptx/templates/tonalities/riso/pack.yaml +99 -0
  147. package/plugin/skills/lit-pptx/templates/tonalities/signal/pack.yaml +2 -2
  148. package/plugin/skills/lit-pptx/templates/tonalities/studio/pack.yaml +1 -1
  149. package/plugin/skills/lit-schematic/SKILL.md +114 -0
  150. package/plugin/skills/lit-schematic/examples/iso-heat-exchanger/build.mjs +38 -0
  151. package/plugin/skills/lit-schematic/examples/iso-heat-exchanger/scene.mjs +133 -0
  152. package/plugin/skills/lit-schematic/examples/journal-adsorption-rig/build.mjs +87 -0
  153. package/plugin/skills/lit-schematic/examples/pid-dosing-skid/build.mjs +85 -0
  154. package/plugin/skills/lit-schematic/references/cutaway-outputs.md +70 -0
  155. package/plugin/skills/lit-schematic/references/isometric-craft.md +101 -0
  156. package/plugin/skills/lit-schematic/references/journal-figures.md +72 -0
  157. package/plugin/skills/lit-schematic/references/kit-api.md +134 -0
  158. package/plugin/skills/lit-schematic/references/pfd-and-layout.md +53 -0
  159. package/plugin/skills/lit-schematic/references/pid-drafting.md +103 -0
  160. package/plugin/skills/lit-schematic/references/pid-symbols.md +163 -0
  161. package/plugin/skills/lit-schematic/references/verification.md +100 -0
  162. package/plugin/skills/lit-schematic/scripts/doctor.mjs +57 -0
  163. package/plugin/skills/lit-schematic/scripts/lib/figure.mjs +81 -0
  164. package/plugin/skills/lit-schematic/scripts/lib/fonts.mjs +27 -0
  165. package/plugin/skills/lit-schematic/scripts/lib/geom.mjs +113 -0
  166. package/plugin/skills/lit-schematic/scripts/lib/interactive.mjs +292 -0
  167. package/plugin/skills/lit-schematic/scripts/lib/isa.mjs +115 -0
  168. package/plugin/skills/lit-schematic/scripts/lib/iso.mjs +719 -0
  169. package/plugin/skills/lit-schematic/scripts/lib/legend-sheet.mjs +162 -0
  170. package/plugin/skills/lit-schematic/scripts/lib/pid.mjs +937 -0
  171. package/plugin/skills/lit-schematic/scripts/lib/png.mjs +132 -0
  172. package/plugin/skills/lit-schematic/scripts/lib/qa-core.mjs +658 -0
  173. package/plugin/skills/lit-schematic/scripts/lib/route.mjs +218 -0
  174. package/plugin/skills/lit-schematic/scripts/lib/sheet.mjs +890 -0
  175. package/plugin/skills/lit-schematic/scripts/lib/svg.mjs +82 -0
  176. package/plugin/skills/lit-schematic/scripts/lib/theme.mjs +115 -0
  177. package/plugin/skills/lit-schematic/scripts/motion.mjs +129 -0
  178. package/plugin/skills/lit-schematic/scripts/qa.mjs +92 -0
  179. package/plugin/skills/lit-schematic/scripts/render.mjs +233 -0
  180. package/plugin/skills/lit-schematic/scripts/scaffold.mjs +60 -0
  181. package/plugin/skills/lit-scientific-visualization/SKILL.md +17 -6
  182. package/plugin/skills/lit-typographic-motion/SKILL.md +58 -48
  183. package/plugin/skills/lit-typographic-motion/engine/THIRD_PARTY_NOTICES +13 -2
  184. package/plugin/skills/lit-typographic-motion/engine/blender/runner.py +218 -0
  185. package/plugin/skills/lit-typographic-motion/engine/core/presets.mjs +1 -1
  186. package/plugin/skills/lit-typographic-motion/engine/node/analysis.mjs +65 -1
  187. package/plugin/skills/lit-typographic-motion/engine/node/assets.mjs +298 -0
  188. package/plugin/skills/lit-typographic-motion/engine/node/blender.mjs +143 -0
  189. package/plugin/skills/lit-typographic-motion/engine/node/board.mjs +136 -0
  190. package/plugin/skills/lit-typographic-motion/engine/node/brief.mjs +7 -1
  191. package/plugin/skills/lit-typographic-motion/engine/node/chrome.mjs +9 -12
  192. package/plugin/skills/lit-typographic-motion/engine/node/cover-assets.mjs +5 -3
  193. package/plugin/skills/lit-typographic-motion/engine/node/cover-capture.mjs +7 -6
  194. package/plugin/skills/lit-typographic-motion/engine/node/cover-treatment.mjs +37 -4
  195. package/plugin/skills/lit-typographic-motion/engine/node/cover.mjs +19 -8
  196. package/plugin/skills/lit-typographic-motion/engine/node/done.mjs +45 -6
  197. package/plugin/skills/lit-typographic-motion/engine/node/frame-worker.mjs +7 -5
  198. package/plugin/skills/lit-typographic-motion/engine/node/gallery.mjs +121 -0
  199. package/plugin/skills/lit-typographic-motion/engine/node/host.mjs +34 -0
  200. package/plugin/skills/lit-typographic-motion/engine/node/house.mjs +44 -0
  201. package/plugin/skills/lit-typographic-motion/engine/node/look.mjs +34 -20
  202. package/plugin/skills/lit-typographic-motion/engine/node/pipeline.mjs +19 -9
  203. package/plugin/skills/lit-typographic-motion/engine/node/scaffold.mjs +210 -0
  204. package/plugin/skills/lit-typographic-motion/engine/node/score.mjs +639 -0
  205. package/plugin/skills/lit-typographic-motion/engine/node/sound-cli.mjs +21 -4
  206. package/plugin/skills/lit-typographic-motion/engine/node/sound.mjs +127 -29
  207. package/plugin/skills/lit-typographic-motion/engine/node/stage-capture.mjs +7 -6
  208. package/plugin/skills/lit-typographic-motion/engine/node/stage-gate.mjs +59 -5
  209. package/plugin/skills/lit-typographic-motion/engine/node/stage-qa.mjs +141 -9
  210. package/plugin/skills/lit-typographic-motion/engine/node/stage-serve.mjs +28 -5
  211. package/plugin/skills/lit-typographic-motion/engine/node/stage.mjs +82 -14
  212. package/plugin/skills/lit-typographic-motion/engine/node/styles.mjs +213 -0
  213. package/plugin/skills/lit-typographic-motion/engine/node/treatment.mjs +311 -10
  214. package/plugin/skills/lit-typographic-motion/engine/stage/cover-init.js +14 -2
  215. package/plugin/skills/lit-typographic-motion/engine/stage/init.js +11 -1
  216. package/plugin/skills/lit-typographic-motion/engine/stage/qa.js +6 -1
  217. package/plugin/skills/lit-typographic-motion/engine/stage/stage-kit.js +83 -0
  218. package/plugin/skills/lit-typographic-motion/engine/vendor/three/LICENSE +21 -0
  219. package/plugin/skills/lit-typographic-motion/engine/vendor/three/addons/environments/RoomEnvironment.js +144 -0
  220. package/plugin/skills/lit-typographic-motion/engine/vendor/three/addons/geometries/RoundedBoxGeometry.js +155 -0
  221. package/plugin/skills/lit-typographic-motion/engine/vendor/three/three.module.js +54571 -0
  222. package/plugin/skills/lit-typographic-motion/recipes/hero-3d/expected.json +69 -0
  223. package/plugin/skills/lit-typographic-motion/recipes/hero-3d/index.html +139 -0
  224. package/plugin/skills/lit-typographic-motion/recipes/orbit-loop/expected.json +6 -4
  225. package/plugin/skills/lit-typographic-motion/recipes/painted-light/expected.json +4 -2
  226. package/plugin/skills/lit-typographic-motion/recipes/weight-tide/expected.json +7 -5
  227. package/plugin/skills/lit-typographic-motion/references/cover.md +394 -443
  228. package/plugin/skills/lit-typographic-motion/references/craft-loop.md +57 -87
  229. package/plugin/skills/lit-typographic-motion/references/depth.md +122 -0
  230. package/plugin/skills/lit-typographic-motion/references/look.md +94 -129
  231. package/plugin/skills/lit-typographic-motion/references/runtime.md +58 -91
  232. package/plugin/skills/lit-typographic-motion/references/sound.md +130 -99
  233. package/plugin/skills/lit-typographic-motion/references/stage.md +190 -215
  234. package/plugin/skills/lit-typographic-motion/references/studio.md +245 -0
  235. package/plugin/skills/lit-typographic-motion/references/style-bibles.md +108 -97
  236. package/plugin/skills/lit-typographic-motion/references/treatment.md +191 -143
  237. package/plugin/skills/lit-typographic-motion/scripts/motion-doctor.mjs +17 -5
  238. package/plugin/skills/lit-typographic-motion/scripts/motion.mjs +47 -7
  239. package/plugin/skills/lit-typographic-motion/styles/paper.json +41 -0
  240. package/plugin/skills/lit-typographic-motion/styles/swiss-signal.json +41 -0
  241. package/plugin/skills/lit-typographic-motion/styles/terminalcore.json +42 -0
  242. package/plugin/skills/lit-typographic-motion/styles/tidal.json +41 -0
  243. package/plugin/skills/litresearch/SKILL.md +1 -0
  244. package/plugin/skills/readme-studio/SKILL.md +2 -0
  245. package/plugin/skills/review-work/SKILL.md +1 -1
  246. package/plugin/skills/start-work/SKILL.md +1 -1
@@ -1,61 +1,64 @@
1
1
  # Markdown Slide Specification v2
2
2
 
3
- > **Status:** Current. Additive over v1: every v1 deck is a valid v2 deck and still compiles to a
4
- > `slide-ast-v1` document.
5
- > **Builds on:** `markdown-slide-spec-v1.md`, which stays the contract for the subset it describes.
6
- > **Reference implementation:** `scripts/lib/directive-parser.js`, `slide-ast.js`, `markdown-loader.js`,
7
- > `layout-resolver.js`. **Schema:** `specs/slide-ast-v2.schema.json`.
3
+ > **Status:** Current. Additive over v1 — every v1 deck is a valid v2 deck and still
4
+ > compiles to a `slide-ast-v1` document.
5
+ > **Supersedes:** `markdown-slide-spec-v1.md`, which remains accurate for the subset
6
+ > it describes and is still the contract v1 decks are held to.
7
+ > **Date:** 2026-08-02
8
8
 
9
9
  ## What changed and why
10
10
 
11
- v1 froze one non-goal that became the binding constraint in practice: free-form absolute positioning in
12
- Markdown. With a closed set of six layouts and a fixed map from block type to region, a deck could look
13
- only like the shapes its template had anticipated. A cover the template lacked, or two tables on one
14
- slide, was inexpressible rather than difficult.
11
+ v1 froze one non-goal that turned out to be the binding constraint in real work:
12
+ *free-form absolute positioning in Markdown* (v1 §11). Combined with a closed set of
13
+ six layouts and a fixed block-to-region map, a deck could only look like the shapes
14
+ its template had anticipated. Building a cover the template did not already offer, or
15
+ putting two tables on one slide, was not difficult — it was unexpressible.
15
16
 
16
- v2 opens placement in tiers so an author reaches for the least freedom that says the thing, and it opens
17
- the layout set so a template or a tonality pack can name its own layouts. Nothing from v1 was removed. A
18
- deck that uses none of sections 2 to 6 compiles to the same `slide-ast-v1` document as before.
17
+ v2 opens placement in three tiers, so an author reaches for the least freedom that
18
+ says the thing rather than dropping straight to coordinates.
19
+
20
+ Nothing was removed. The v1 constructs, layouts, directives, separator rules and
21
+ failure behaviour are unchanged, and a deck that uses none of §2–§6 below compiles to
22
+ a byte-identical `slide-ast-v1` document.
19
23
 
20
24
  ## 1. Version selection
21
25
 
22
- The compiler decides the AST version from content (`usesV2` in `slide-ast.js`), never from a flag.
26
+ The compiler chooses the AST version from the deck's content, not from a flag.
23
27
 
24
- | The deck contains | `astVersion` | `version` |
25
- |---|---|---|
26
- | only v1 constructs on the six v1 layouts | `slide-ast-v1` | `1.0.0` |
27
- | a layout outside the v1 six (`free`, any family name), a slide-local key, or a `region`, `columns`, `box` or `shape` block | `slide-ast-v2` | `2.0.0` |
28
+ | Deck uses | `astVersion` |
29
+ |---|---|
30
+ | v1 constructs only | `slide-ast-v1` |
31
+ | any of: `region`, `columns`, `box`, `shape`, a slide-local key, a layout outside the v1 six | `slide-ast-v2` |
28
32
 
29
- The validator accepts both. A deck written for a tonality uses family names (`kpi-row`, `chart-insight`),
30
- so it compiles to v2.
33
+ Both are accepted by the validator. This is what lets v1 fixtures and their assertions
34
+ stand untouched.
31
35
 
32
36
  ## 2. Slide-local keys
33
37
 
34
- Keys may follow the `layout:` line and end at the first blank line:
38
+ Keys may follow the `layout:` line, ending at the first blank line:
35
39
 
36
40
  ```
37
41
  ---
38
42
  layout: cover
39
43
  variant: split-navy
40
44
 
41
- # 세탁 서비스 분기 보고
45
+ # Title
42
46
  ---
43
47
  ```
44
48
 
45
- **The key set is closed to `variant` and `title`.** `variant` (section 6) swaps furniture on a legacy
46
- template. `title: <treatment>` pins one slide's title treatment under a tonality (`references/title-treatments.md`).
47
- The run of keys stops at the first line that is not one of them, and that line stays in the body.
49
+ **The key set is closed.** `variant` (§6) is the only slide-local key, and the run stops
50
+ at the first line that is not one of them. A line the engine does not act on stays in
51
+ the body.
48
52
 
49
- Closing the set keeps body text safe. A body line such as `source: internal data` has the exact shape of a
50
- key, so a rule of the form "any word and a colon" would delete it from the slide without a word. A mistyped
51
- `varient:` stays visible in the body, where the author sees it, instead of becoming an ignored key. Korean
52
- labels such as `출처: 내부 자료` were never at risk, since a key starts with an ASCII letter.
53
+ That is the whole guarantee, and it is deliberately not "anything shaped like a key".
54
+ A body line reading `source: internal data` has exactly the shape of a key, and
55
+ consuming it would delete it from the slide with no error. The same rule keeps a
56
+ mistyped `varient:` visible in the body rather than turning it into an ignored key that
57
+ silently does nothing — a typo you can see beats a variant that never applied.
53
58
 
54
- The keys travel in the AST as `meta` (a map of strings). A `title:` pin names one of the eight treatments
55
- (`top-rule`, `top-plain-large`, `side-rail`, `band`, `statement`, `overlay`, `kicker-numeral`,
56
- `bottom-anchor`); an unknown name, a name the pack lacks, one the family refuses, and a title that cannot
57
- be drawn on this slide each stop the compile with the allowed set. A legacy template stops on any `title:`
58
- pin, and a cover or section slide takes its variant's title.
59
+ An earlier draft of this section claimed the blank line was the boundary and that prose
60
+ was therefore safe. It was not. The Korean example it used, `출처: 내부 자료`, survived
61
+ only because `출처` is not ASCII; the English equivalent was swallowed.
59
62
 
60
63
  ## 3. Directive attributes
61
64
 
@@ -65,49 +68,37 @@ A directive line may carry positional values and `key=value` pairs:
65
68
  ::: box x=6.9 y=2.6 w=5.3 h=1.4 role="body text" z=over
66
69
  ```
67
70
 
68
- `parseAttrs` splits the rest of the line on whitespace. A token with `=` is a pair, anything else is
69
- positional. Quoted values keep their spaces and lose their quotes. An unquoted value that reads as a number
70
- becomes a number, and `true` or `false` become booleans. Consequences worth knowing:
71
-
72
- - Write a colour as `#E2F0EC` (a quoted or `#`-prefixed string); a bare `112233` is read as a number.
73
- - A name with a space needs quotes.
74
- - A v1 directive with no arguments parses as before, with an empty attribute map.
71
+ Numbers and booleans are coerced; quoted values keep their spaces. A v1 directive with
72
+ no arguments parses exactly as before, with an empty attribute map.
75
73
 
76
74
  ## 4. Nesting by fence length
77
75
 
78
- v1 forbade `:::` inside `:::`, and every v1 deck relies on that. v2 keeps the rule and adds a convention
79
- from fenced-div Markdown: a container opens with a longer fence than the blocks inside it, and a block
80
- closes on a run of its own length.
81
-
82
- | Situation | Result |
83
- |---|---|
84
- | a `::::` block holding `:::` blocks | accepted |
85
- | a block inside one of the same fence length | error naming the line |
86
- | a longer fence inside a shorter one | error |
87
- | depth beyond two | error (`Directive nesting depth exceeds 2`) |
88
- | a `::: shape` line anywhere | accepted; it is void and takes no close |
76
+ v1 forbade `:::` inside `:::` and every v1 deck depends on that. Rather than relax it,
77
+ containers nest by fence length — the pandoc fenced-div convention. A block closes on a
78
+ run of its own length, so `::::` may hold `:::` with no ambiguity.
89
79
 
90
- Only `columns` is a container. A `::: col` block is a leaf of depth two, so a column holds Markdown (bullets,
91
- a pipe table, an image line) and no directive. A chart, a box or a callout therefore goes on the slide
92
- outside the columns.
80
+ - Same-length nesting: **error** (unchanged from v1)
81
+ - A longer fence inside a shorter one: **error**
82
+ - Depth beyond two: **error**
93
83
 
94
84
  ## 5. Placement
95
85
 
96
- ### 5.1 Tier 1: `region` (legacy templates)
86
+ ### 5.1 Tier 1 — `region`
97
87
 
98
88
  ```
99
- ::: region name=table
89
+ ::: region name=right_figure
100
90
  | 항목 | 값 |
101
91
  |------|-----|
102
92
  :::
103
93
  ```
104
94
 
105
- The body parses as ordinary Markdown, and every resulting block is routed to the named region instead of the
106
- one its type implies. The block list stays flat: `region` leaves no node in the AST and only sets
107
- `regionHint` on each block. A name the layout lacks stops the compile with the regions it has. `name` is
108
- required. A tonality fixes its regions by family, so `region` has no effect there.
95
+ The body is parsed as ordinary Markdown; each resulting block is routed to the named
96
+ region instead of the one its type would imply. The block list stays flat — `region`
97
+ does not appear in the AST, it only sets `regionHint`.
98
+
99
+ A name the layout does not declare is an error listing the regions it does.
109
100
 
110
- ### 5.2 Tier 2: `columns`
101
+ ### 5.2 Tier 2 — `columns`
111
102
 
112
103
  ```
113
104
  :::: columns 2fr 1fr gap=0.3
@@ -115,149 +106,109 @@ required. A tonality fixes its regions by family, so `region` has no effect ther
115
106
  - 왼쪽
116
107
  :::
117
108
  ::: col
118
- ![도 1. 개요](fig.png)
109
+ ![도1. 개요](fig.png)
119
110
  :::
120
111
  ::::
121
112
  ```
122
113
 
123
- Tracks are positive ratios (`2fr`, `1fr`, or bare numbers). The engine divides the layout's body region
124
- between them, so the source carries no coordinates and the same deck lands correctly on a canvas of another
125
- size. `gap` is in inches and defaults to `0.25`.
114
+ Tracks are ratios and the engine divides the layout's **body region** between them, so
115
+ the source carries no coordinates and the same deck still lands correctly on a template
116
+ with another canvas. `gap` is in inches, default `0.25`.
126
117
 
127
- - The track count must equal the `::: col` count; a mismatch is an error, never padding. Zero columns is an
128
- error.
129
- - A layout without a body region cannot host columns (the error lists its regions).
130
- - On a legacy template the columns replace the body region for that slide. A bullet written outside the
131
- columns on the same slide has nowhere to go and is dropped, so put every body line inside a column.
132
- - Under a tonality `columns` supplies the two sides of a `comparison` (one head and numbered points per
133
- side).
118
+ - Track count must equal `::: col` count — a mismatch is an error, never silent padding.
119
+ - A layout with no body region cannot host columns.
120
+ - Columns replace the body region for that slide; the body region does not also render.
134
121
 
135
- ### 5.3 Tier 3: `box` and `shape`
122
+ ### 5.3 Tier 3 — `box` and `shape`
136
123
 
137
124
  ```
138
- ::: box x=0.7 y=6.45 w=11.9 h=0.5 role=body_text z=over
139
- **결론:** 접수가 늘었다
125
+ ::: box x=6.9 y=2.6 w=5.3 h=1.4 role=body_text z=over
126
+ **결론** — 세 축으로 재편
140
127
  :::
141
128
 
142
- ::: shape rect x=0.5 y=6.4 w=12.3 h=0.6 fill=#EEF4FF z=under
129
+ ::: shape rect x=0 y=6.4 w=13.333 h=1.1 fill=#EEF4FF z=under
143
130
  ```
144
131
 
145
- `box` requires numeric `x y w h` in inches on the template canvas (13.333 x 7.5 for 16:9). `role` names a
146
- font role of the template's `capabilities.yaml` (default `body_text`; an unknown role stops the compile
147
- with the available names). `align` and `valign` are passed through. The content parses as Markdown and flows
148
- down the box: each block but the last takes the height its content needs and the last takes the rest. A
149
- bold run-in label inside a box needs its own colon, since the engine adds none there (OF-118).
132
+ `box` requires `x y w h` in inches. `role` names a `font_role` from the template's
133
+ `capabilities.yaml`, defaulting to `body_text`. Content is parsed as Markdown and flows
134
+ down the box: every block but the last takes the height its content needs, the last
135
+ takes what is left.
150
136
 
151
- `shape` is a void directive: one line, no close. Its first positional value is the kind: `rect`, `roundRect`,
152
- `pill`, `ellipse`, `ring`, `line`, `text`, `image`. Style attributes are `fill line lw radius rotate text
153
- color size align valign char_spacing bold asset dir src note`; any other key stops the compile. `line` needs
154
- `x y w` only and takes its thickness from the stroke width. Every other kind needs `h`.
137
+ `shape` is a **void directive** — one line, no closing fence. Its first positional value
138
+ is the primitive: `rect · roundRect · pill · ellipse · ring · line · text · image`. Style
139
+ attributes are `fill line lw radius rotate text color size align valign char_spacing
140
+ bold asset dir src`, checked at compile time so a typo fails loudly. `line` is the one
141
+ kind that needs no height; it takes its thickness from the stroke.
155
142
 
156
- `z` is `under` or `over`. A shape defaults to `under` and a box to `over`.
143
+ `z` is `under` or `over`. Shapes default to `under`, boxes to `over`.
157
144
 
158
145
  ### 5.4 What placement does not do
159
146
 
160
- A template region is never reflowed to avoid a placed box. The nudge rules that narrow a body beside an
161
- image do not see placements, and coordinates reach the renderer as written. Covering a region is a defect the
162
- QA gate reports (occlusion, semantic overlap), not an adjustment the engine makes. The choice is deliberate:
163
- an engine that quietly moved content from under a box would make the author's intent unknowable.
147
+ **A template region is never reflowed to avoid a placed box.** The auto-nudge rules that
148
+ narrow a body beside an image do not see placements at all, and coordinates arrive at the
149
+ renderer exactly as written. Covering a region is therefore a defect the QA gate reports,
150
+ not a nudge the engine applies. This is deliberate: an engine that quietly moved content
151
+ out from under an author's box would make the author's intent unknowable.
164
152
 
165
153
  ## 6. Layouts and variants
166
154
 
167
- The layout set is open. `spec-validator.js` checks only that a layout name matches `^[a-z][a-z0-9-]*$`.
168
- Whether the layout exists is a fact about the chosen design: `layout-resolver.js` compares the name with the
169
- template mapping (or with the tonality's families) and lists the alternatives on a miss.
155
+ The layout set is no longer closed. `spec-validator` checks that a layout name is an
156
+ identifier (`^[a-z][a-z0-9-]*$`); whether it exists is a fact about the chosen template,
157
+ and `layout-resolver` compares it against the template mapping and names the alternatives
158
+ when it does not match.
170
159
 
171
- - **Legacy templates** declare layouts in `layout-mapping.yaml` (AZURE-PRO: `cover`, `content`, `main`,
172
- `summary`, `section`, `closing`).
173
- - **Tonalities** accept 28 content families, 9 cover variants, 6 section variants and 5 closing variants.
174
- A pack lists the subset it carries; a family outside the list draws with its own geometry and logs a
175
- `note:`.
176
- - **`free`** needs no declaration: the slide uses no template region, so every template supports it. On a
177
- legacy template it accepts `notes` and placements only, and a `##` title stops the compile (set the title
178
- as a box). Under a tonality `free` is read as `text-column`.
160
+ `free` needs no declaration — it means "this slide uses no template region", so every
161
+ template supports it and the slide is built entirely from placements.
179
162
 
180
- A **variant** swaps a layout's decoration set and may override the regions the new furniture displaces:
163
+ A **variant** swaps a layout's decoration set and may override the regions the new
164
+ furniture displaces:
181
165
 
182
166
  ```
167
+ ---
183
168
  layout: cover
184
169
  variant: split-navy
170
+ ---
185
171
  ```
186
172
 
187
- Both travel together, because a split cover needs a narrower title than a full-bleed one. AZURE-PRO declares
188
- `split-navy` and `minimal` for `cover` and `rule` for `section`. An unknown variant stops the compile and
189
- lists the declared ones. A tonality ignores `variant:`; its cover, section and closing variants are
190
- selected by the family name (`cover-figures`, `section-rule`, `closing-ask`).
173
+ Both parts travel together, because a split cover needs a narrower title than a
174
+ full-bleed one. An unknown variant is an error listing the ones the layout declares.
191
175
 
192
176
  ## 7. Capability derivation
193
177
 
194
- The allowed blocks of a layout come from the first source that has one: the template's
195
- `supported_blocks[layout]`, then the built-in table for the six v1 names, then the blocks implied by the
196
- regions the layout declares (`table` implies `kpi-table`, `main_box` implies `main-box`, and so on).
197
- Placement blocks and `notes` are legal on every layout, since they need no region.
178
+ When a template declares a layout but publishes no `supported_blocks` entry for it, the
179
+ allowed blocks are derived from the regions that layout declares. Placement blocks and
180
+ `notes` are allowed everywhere, since they do not depend on a region existing.
198
181
 
199
182
  ## 8. Region occupancy
200
183
 
201
- A region holds one block. Two blocks claiming one region stop the compile and name both exits (`::: region
202
- name=` or `:::: columns`). In v1 the second block silently replaced the first, which is why a slide could not
203
- carry two tables. Two documented exceptions: images in the `image` region collapse into a grid, and caption
204
- regions are subordinate labels where the last caption wins. An image line with alt text inside a
205
- `region name=image` block emits its figure-caption with the same hint; the caption joins the image grid
206
- as an entry with no source and the compile stops with `Image source is empty`. A captioned picture goes
207
- through `columns`, or through a region with an empty alt text.
184
+ A region holds one block. Two blocks claiming the same region is an error naming both
185
+ ways out — `::: region name=` or `:::: columns`. In v1 the second block silently
186
+ overwrote the first, which is why a slide could not carry two tables.
208
187
 
209
- ## 9. Charts
210
-
211
- `::: chart type=<column|bar|line|area|stacked|pie|doughnut> [unit="..."] [title="..."] [labels=false]`
212
- wraps a pipe table (first column the categories, every further column one series) and an optional `> caption`
213
- line. It compiles to a `kpi-table` block with a `chart` field and, with a caption, a `table-caption` block
214
- marked `figure: true`:
215
-
216
- ```json
217
- {"type": "kpi-table", "headers": ["분기", "매출"], "rows": [["1Q", "1,120"]],
218
- "chart": {"type": "column", "unit": "억 원"}, "caption": "분기별 매출 (예시 데이터)"}
219
- ```
188
+ Two exceptions are documented behaviour decks already rely on: images collapse into a
189
+ grid, and captions are subordinate labels where the last one wins.
220
190
 
221
- The block is legal wherever a table is, and a renderer without chart support still shows the numbers as a
222
- table. The PPTX renderer draws a native chart that fills its region down to the caption, numbered with the
223
- other figures. `type` defaults to `column`; a table with fewer than two headers or no data rows, and an
224
- unknown type, each stop the compile.
225
-
226
- Measured scientific data stays outside the dialect. `lit-scientific-visualization` draws it, and
227
- `compile-deck.js --export-viz-context <path>` writes the template's palette, body font family, bundled font
228
- file paths, canvas and DPI so the figure matches the deck.
229
-
230
- ## 10. Headline-number rows
191
+ ## 9. Charts
231
192
 
232
- A table of short values becomes a card row. The limits are part of the contract:
193
+ `::: chart type=<column|bar|line|area|stacked|pie|doughnut> [unit="…"] [title="…"] [labels=false]`
194
+ wraps a pipe table (first column: categories; every further column: one series) and an
195
+ optional `> caption` line. It compiles to a `kpi-table` block carrying a `chart` field, so it
196
+ is legal wherever a table is, and a renderer without chart support shows the numbers as a
197
+ table. The PPTX renderer draws a native chart that fills the region down to its caption; the
198
+ caption is numbered with the figures ("도 N.").
233
199
 
234
- | Design | Columns | Rows | Cell length |
235
- |---|---|---|---|
236
- | legacy template | 2 to 4 | 1 (two-column tables up to 4 pairs) | 12 characters |
237
- | tonality | 2 to 6 | 1, or 2 when the second row gives each figure's basis or comparison | 12 characters in row one, 24 in row two |
200
+ Plots of measured scientific data stay outside this dialect: they are produced by
201
+ the scientific visualization skill and placed as an image. `compile-deck.js --export-viz-context <path>` writes the template's
202
+ palette, body font family, **bundled font file paths**, canvas and DPI so the chart is
203
+ drawn in the deck's own visual system rather than a library default.
238
204
 
239
- A table outside these limits stays a table.
205
+ ## 10. Non-goals retained from v1
240
206
 
241
- ## 11. Failure behaviour
207
+ - Full Marp compatibility
208
+ - Arbitrary CSS as authoring input
209
+ - Raw HTML passthrough
210
+ - JavaScript or interactive content
211
+ - Silent fallback or degradation for unsupported constructs
242
212
 
243
- | Condition | Message begins |
244
- |---|---|
245
- | unknown variant | `layout "cover" has no variant "foo". Available: ...` |
246
- | unknown region | `block "body" maps to region "nowhere" which is not defined ...` |
247
- | two blocks in one region | `two blocks both claim region "table" ...` |
248
- | column count mismatch | `":::: columns" declares 2 track(s) ... but holds 1` |
249
- | box without a number | `"::: box" is missing a numeric "h"` |
250
- | unknown shape kind or attribute | `"::: shape" has unknown kind "star"` / `got unknown attribute "glow"` |
251
- | directive inside a column | `Nested directives must use a shorter fence than their container` |
252
- | `title:` on a legacy template | `picks a title treatment, which needs a tonality` |
253
-
254
- ## 12. Non-goals retained
255
-
256
- - Full compatibility with other slide dialects.
257
- - Arbitrary CSS as authoring input.
258
- - Raw HTML passthrough.
259
- - Scripts or interactive content.
260
- - Silent fallback or degradation for unsupported constructs.
261
-
262
- Free-form absolute positioning was a v1 non-goal. v2 reverses it for `box` and `shape` and states in
263
- section 5.4 what the author gives up in exchange.
213
+ The single v1 non-goal v2 reverses is free-form absolute positioning, and §5.4 states
214
+ what was kept in exchange.