@litfamily/litgravity 0.1.1 → 0.1.3
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.
- package/CHANGELOG.md +46 -0
- package/README.md +19 -3
- package/README_ko-KR.md +19 -3
- package/TRADEMARK.md +12 -0
- package/package.json +3 -2
- package/plugin/hooks/lib/lanes.mjs +65 -0
- package/plugin/hooks/lib/liveness.mjs +81 -0
- package/plugin/hooks/lib/motion.mjs +34 -5
- package/plugin/hooks/lib/reentry.mjs +7 -0
- package/plugin/hooks/lib/rewind/brief.mjs +364 -0
- package/plugin/hooks/lib/rewind/collect.mjs +359 -0
- package/plugin/hooks/lib/rewind/gauge.mjs +55 -0
- package/plugin/hooks/lib/rewind/next-step.mjs +77 -0
- package/plugin/hooks/lib/rewind/redact.mjs +60 -0
- package/plugin/hooks/lib/rewind/transcripts.mjs +214 -0
- package/plugin/hooks/lib/routes.mjs +79 -5
- package/plugin/hooks/lib/workflow-stack.mjs +213 -0
- package/plugin/hooks/post-tool-use.mjs +39 -1
- package/plugin/hooks/pre-invocation.mjs +93 -2
- package/plugin/hooks/session-start.mjs +26 -3
- package/plugin/hooks/stop.mjs +55 -6
- package/plugin/hud/looks.mjs +29 -0
- package/plugin/hud/render.mjs +277 -12
- package/plugin/plugin.json +1 -1
- package/plugin/skills/frontend-ui-ux/SKILL.md +12 -1
- package/plugin/skills/frontend-ui-ux/kit/components.css +417 -0
- package/plugin/skills/frontend-ui-ux/kit/fonts.json +22 -0
- package/plugin/skills/frontend-ui-ux/kit/layouts/landing.html +164 -0
- package/plugin/skills/frontend-ui-ux/kit/layouts/settings.html +114 -0
- package/plugin/skills/frontend-ui-ux/kit/layouts/workspace.html +115 -0
- package/plugin/skills/frontend-ui-ux/kit/styles/computational-brutalism.json +227 -0
- package/plugin/skills/frontend-ui-ux/kit/styles/field-notes.json +205 -0
- package/plugin/skills/frontend-ui-ux/kit/styles/graphite.json +200 -0
- package/plugin/skills/frontend-ui-ux/kit/styles/meadow.json +199 -0
- package/plugin/skills/frontend-ui-ux/kit/styles/neo-brutalism.json +222 -0
- package/plugin/skills/frontend-ui-ux/kit/ui.js +226 -0
- package/plugin/skills/frontend-ui-ux/references/house-styles.md +234 -0
- package/plugin/skills/frontend-ui-ux/scripts/design-lock.mjs +400 -0
- package/plugin/skills/frontend-ui-ux/scripts/interface-probe-lock.mjs +196 -0
- package/plugin/skills/frontend-ui-ux/scripts/interface-probe-page.mjs +30 -9
- package/plugin/skills/frontend-ui-ux/scripts/interface-probe-rules.mjs +20 -8
- package/plugin/skills/frontend-ui-ux/scripts/interface-probe.mjs +42 -9
- package/plugin/skills/frontend-ui-ux/scripts/pixel-art.mjs +60 -0
- package/plugin/skills/lit-adhd/SKILL.md +160 -0
- package/plugin/skills/lit-adhd/references/card-examples.md +107 -0
- package/plugin/skills/lit-adhd/references/status-taxonomy.md +34 -0
- package/plugin/skills/lit-adhd/scripts/rewind.mjs +5 -0
- package/plugin/skills/lit-diagram-drawer/SKILL.md +5 -3
- package/plugin/skills/lit-diagram-drawer/references/drawing-rules.md +1 -1
- package/plugin/skills/lit-diagram-drawer/references/style-guide.md +21 -12
- package/plugin/skills/lit-diagram-drawer/references/type-architecture.md +3 -3
- package/plugin/skills/lit-diagram-drawer/references/type-dependency.md +1 -1
- package/plugin/skills/lit-diagram-drawer/references/type-tree.md +3 -3
- package/plugin/skills/lit-diagram-drawer/references/type-wardley.md +1 -1
- package/plugin/skills/lit-diagram-drawer/scripts/diagram-craft-rules.mjs +1 -2
- package/plugin/skills/lit-diagram-drawer/scripts/visual-quality.mjs +1 -2
- package/plugin/skills/lit-docx/SKILL.md +3 -3
- package/plugin/skills/lit-handoff/SKILL.md +1 -0
- package/plugin/skills/lit-hijack/SKILL.md +263 -0
- package/plugin/skills/lit-hijack/references/capture-and-provenance.md +100 -0
- package/plugin/skills/lit-hijack/references/clean-room-build.md +75 -0
- package/plugin/skills/lit-hijack/references/distil-and-licence.md +67 -0
- package/plugin/skills/lit-hijack/references/gap-and-port-design.md +100 -0
- package/plugin/skills/lit-hijack/references/parity-and-report.md +85 -0
- package/plugin/skills/lit-hijack/scripts/hijack.mjs +953 -0
- package/plugin/skills/lit-plan/SKILL.md +3 -2
- package/plugin/skills/lit-plan/references/plan-contract.md +12 -1
- package/plugin/skills/lit-plan/scripts/check-plan.mjs +39 -3
- package/plugin/skills/lit-plan/templates/plan.md +3 -0
- package/plugin/skills/lit-pptx/SKILL.md +8 -8
- package/plugin/skills/lit-pptx/fonts/jetbrains-mono/JetBrainsMono-Bold.ttf +0 -0
- package/plugin/skills/lit-pptx/fonts/jetbrains-mono/JetBrainsMono-Regular.ttf +0 -0
- package/plugin/skills/lit-pptx/fonts/jetbrains-mono/OFL.txt +93 -0
- package/plugin/skills/lit-pptx/fonts/provenance.json +32 -1
- package/plugin/skills/lit-pptx/references/agents/analyst.md +34 -56
- package/plugin/skills/lit-pptx/references/agents/antithesis.md +49 -67
- package/plugin/skills/lit-pptx/references/agents/architect.md +38 -51
- package/plugin/skills/lit-pptx/references/agents/critic.md +25 -41
- package/plugin/skills/lit-pptx/references/agents/synthesizer.md +37 -46
- package/plugin/skills/lit-pptx/references/agents/thesis.md +29 -49
- package/plugin/skills/lit-pptx/references/anti-slop-checklist.md +119 -145
- package/plugin/skills/lit-pptx/references/authoring-guide.md +187 -278
- package/plugin/skills/lit-pptx/references/consensus-protocol.md +99 -97
- package/plugin/skills/lit-pptx/references/data-display-cookbook.md +36 -137
- package/plugin/skills/lit-pptx/references/density-and-fill.md +147 -216
- package/plugin/skills/lit-pptx/references/design-system-azure.md +56 -85
- package/plugin/skills/lit-pptx/references/direction-step.md +134 -176
- package/plugin/skills/lit-pptx/references/examples/01-pitch-signal-ko.md +114 -115
- package/plugin/skills/lit-pptx/references/examples/02-pitch-studio-ko.md +66 -66
- package/plugin/skills/lit-pptx/references/examples/03-business-review-ledger-ko.md +63 -63
- package/plugin/skills/lit-pptx/references/examples/04-business-review-night-en.md +96 -96
- package/plugin/skills/lit-pptx/references/examples/05-research-talk-paper-en.md +81 -81
- package/plugin/skills/lit-pptx/references/examples/06-lecture-chalk-ko.md +103 -103
- package/plugin/skills/lit-pptx/references/examples/07-data-review-night-en.md +100 -98
- package/plugin/skills/lit-pptx/references/examples/08-image-led-atlas-ko.md +76 -76
- package/plugin/skills/lit-pptx/references/examples/09-briefing-gazette-ko.md +96 -96
- package/plugin/skills/lit-pptx/references/examples/10-status-update-ledger-ko.md +80 -80
- package/plugin/skills/lit-pptx/references/examples/11-portfolio-studio-en.md +72 -72
- package/plugin/skills/lit-pptx/references/examples/12-research-tutorial-chalk-en.md +95 -95
- package/plugin/skills/lit-pptx/references/examples/13-engineering-review-computational-brutalism-ko.md +173 -0
- package/plugin/skills/lit-pptx/references/examples/14-launch-pitch-neo-brutalism-ko.md +154 -0
- package/plugin/skills/lit-pptx/references/examples/15-design-lecture-bauhaus-ko.md +139 -0
- package/plugin/skills/lit-pptx/references/examples/16-community-programme-riso-ko.md +158 -0
- package/plugin/skills/lit-pptx/references/examples/17-public-data-briefing-newsroom-ko.md +179 -0
- package/plugin/skills/lit-pptx/references/interview-protocol.md +83 -102
- package/plugin/skills/lit-pptx/references/layout-families.md +161 -265
- package/plugin/skills/lit-pptx/references/stages/autopilot.md +30 -70
- package/plugin/skills/lit-pptx/references/stages/interview.md +36 -68
- package/plugin/skills/lit-pptx/references/stages/plan.md +26 -67
- package/plugin/skills/lit-pptx/references/title-treatments.md +93 -145
- package/plugin/skills/lit-pptx/references/tonalities/atlas.md +95 -108
- package/plugin/skills/lit-pptx/references/tonalities/bauhaus.md +140 -0
- package/plugin/skills/lit-pptx/references/tonalities/chalk.md +107 -122
- package/plugin/skills/lit-pptx/references/tonalities/computational-brutalism.md +150 -0
- package/plugin/skills/lit-pptx/references/tonalities/gazette.md +87 -111
- package/plugin/skills/lit-pptx/references/tonalities/ledger.md +96 -125
- package/plugin/skills/lit-pptx/references/tonalities/neo-brutalism.md +161 -0
- package/plugin/skills/lit-pptx/references/tonalities/newsroom.md +144 -0
- package/plugin/skills/lit-pptx/references/tonalities/night.md +104 -131
- package/plugin/skills/lit-pptx/references/tonalities/paper.md +114 -130
- package/plugin/skills/lit-pptx/references/tonalities/riso.md +137 -0
- package/plugin/skills/lit-pptx/references/tonalities/signal.md +96 -103
- package/plugin/skills/lit-pptx/references/tonalities/studio.md +81 -112
- package/plugin/skills/lit-pptx/scripts/compile-deck.js +4 -6
- package/plugin/skills/lit-pptx/scripts/craft_extras.py +135 -91
- package/plugin/skills/lit-pptx/scripts/deck_craft.py +1 -1
- package/plugin/skills/lit-pptx/scripts/embed_fonts.py +13 -1
- package/plugin/skills/lit-pptx/scripts/layout_inventory.py +1 -1
- package/plugin/skills/lit-pptx/scripts/learn_template.py +1 -1
- package/plugin/skills/lit-pptx/scripts/lib/grid-resolver.js +101 -110
- package/plugin/skills/lit-pptx/scripts/lib/layout-resolver.js +9 -15
- package/plugin/skills/lit-pptx/scripts/lib/render-pack.js +370 -563
- package/plugin/skills/lit-pptx/scripts/lib/slide-grid.js +104 -0
- package/plugin/skills/lit-pptx/scripts/lib/template-registry.js +57 -6
- package/plugin/skills/lit-pptx/scripts/qa_deck.py +6 -6
- package/plugin/skills/lit-pptx/scripts/render_pages.py +31 -0
- package/plugin/skills/lit-pptx/scripts/validate_pptx.py +1 -1
- package/plugin/skills/lit-pptx/specs/markdown-slide-spec-v1.md +167 -191
- package/plugin/skills/lit-pptx/specs/markdown-slide-spec-v2.md +117 -166
- package/plugin/skills/lit-pptx/specs/template-enrollment-contract.md +307 -330
- package/plugin/skills/lit-pptx/templates/tonalities/atlas/pack.yaml +1 -1
- package/plugin/skills/lit-pptx/templates/tonalities/bauhaus/pack.yaml +98 -0
- package/plugin/skills/lit-pptx/templates/tonalities/chalk/pack.yaml +1 -1
- package/plugin/skills/lit-pptx/templates/tonalities/computational-brutalism/pack.yaml +99 -0
- package/plugin/skills/lit-pptx/templates/tonalities/gazette/pack.yaml +1 -1
- package/plugin/skills/lit-pptx/templates/tonalities/ledger/pack.yaml +1 -1
- package/plugin/skills/lit-pptx/templates/tonalities/neo-brutalism/pack.yaml +107 -0
- package/plugin/skills/lit-pptx/templates/tonalities/newsroom/pack.yaml +99 -0
- package/plugin/skills/lit-pptx/templates/tonalities/night/pack.yaml +1 -1
- package/plugin/skills/lit-pptx/templates/tonalities/paper/pack.yaml +1 -1
- package/plugin/skills/lit-pptx/templates/tonalities/riso/pack.yaml +99 -0
- package/plugin/skills/lit-pptx/templates/tonalities/signal/pack.yaml +2 -2
- package/plugin/skills/lit-pptx/templates/tonalities/studio/pack.yaml +1 -1
- package/plugin/skills/lit-schematic/SKILL.md +114 -0
- package/plugin/skills/lit-schematic/examples/iso-heat-exchanger/build.mjs +38 -0
- package/plugin/skills/lit-schematic/examples/iso-heat-exchanger/scene.mjs +133 -0
- package/plugin/skills/lit-schematic/examples/journal-adsorption-rig/build.mjs +87 -0
- package/plugin/skills/lit-schematic/examples/pid-dosing-skid/build.mjs +85 -0
- package/plugin/skills/lit-schematic/references/cutaway-outputs.md +70 -0
- package/plugin/skills/lit-schematic/references/isometric-craft.md +101 -0
- package/plugin/skills/lit-schematic/references/journal-figures.md +72 -0
- package/plugin/skills/lit-schematic/references/kit-api.md +134 -0
- package/plugin/skills/lit-schematic/references/pfd-and-layout.md +53 -0
- package/plugin/skills/lit-schematic/references/pid-drafting.md +103 -0
- package/plugin/skills/lit-schematic/references/pid-symbols.md +163 -0
- package/plugin/skills/lit-schematic/references/verification.md +100 -0
- package/plugin/skills/lit-schematic/scripts/doctor.mjs +57 -0
- package/plugin/skills/lit-schematic/scripts/lib/figure.mjs +81 -0
- package/plugin/skills/lit-schematic/scripts/lib/fonts.mjs +27 -0
- package/plugin/skills/lit-schematic/scripts/lib/geom.mjs +113 -0
- package/plugin/skills/lit-schematic/scripts/lib/interactive.mjs +292 -0
- package/plugin/skills/lit-schematic/scripts/lib/isa.mjs +115 -0
- package/plugin/skills/lit-schematic/scripts/lib/iso.mjs +719 -0
- package/plugin/skills/lit-schematic/scripts/lib/legend-sheet.mjs +162 -0
- package/plugin/skills/lit-schematic/scripts/lib/pid.mjs +937 -0
- package/plugin/skills/lit-schematic/scripts/lib/png.mjs +132 -0
- package/plugin/skills/lit-schematic/scripts/lib/qa-core.mjs +658 -0
- package/plugin/skills/lit-schematic/scripts/lib/route.mjs +218 -0
- package/plugin/skills/lit-schematic/scripts/lib/sheet.mjs +890 -0
- package/plugin/skills/lit-schematic/scripts/lib/svg.mjs +82 -0
- package/plugin/skills/lit-schematic/scripts/lib/theme.mjs +115 -0
- package/plugin/skills/lit-schematic/scripts/motion.mjs +129 -0
- package/plugin/skills/lit-schematic/scripts/qa.mjs +92 -0
- package/plugin/skills/lit-schematic/scripts/render.mjs +233 -0
- package/plugin/skills/lit-schematic/scripts/scaffold.mjs +60 -0
- package/plugin/skills/lit-scientific-visualization/SKILL.md +17 -6
- package/plugin/skills/lit-typographic-motion/SKILL.md +58 -48
- package/plugin/skills/lit-typographic-motion/engine/THIRD_PARTY_NOTICES +13 -2
- package/plugin/skills/lit-typographic-motion/engine/blender/runner.py +218 -0
- package/plugin/skills/lit-typographic-motion/engine/core/presets.mjs +1 -1
- package/plugin/skills/lit-typographic-motion/engine/node/analysis.mjs +65 -1
- package/plugin/skills/lit-typographic-motion/engine/node/assets.mjs +298 -0
- package/plugin/skills/lit-typographic-motion/engine/node/blender.mjs +143 -0
- package/plugin/skills/lit-typographic-motion/engine/node/board.mjs +136 -0
- package/plugin/skills/lit-typographic-motion/engine/node/brief.mjs +7 -1
- package/plugin/skills/lit-typographic-motion/engine/node/chrome.mjs +9 -12
- package/plugin/skills/lit-typographic-motion/engine/node/cover-assets.mjs +5 -3
- package/plugin/skills/lit-typographic-motion/engine/node/cover-capture.mjs +7 -6
- package/plugin/skills/lit-typographic-motion/engine/node/cover-treatment.mjs +37 -4
- package/plugin/skills/lit-typographic-motion/engine/node/cover.mjs +19 -8
- package/plugin/skills/lit-typographic-motion/engine/node/done.mjs +45 -6
- package/plugin/skills/lit-typographic-motion/engine/node/frame-worker.mjs +7 -5
- package/plugin/skills/lit-typographic-motion/engine/node/gallery.mjs +121 -0
- package/plugin/skills/lit-typographic-motion/engine/node/host.mjs +34 -0
- package/plugin/skills/lit-typographic-motion/engine/node/house.mjs +44 -0
- package/plugin/skills/lit-typographic-motion/engine/node/look.mjs +34 -20
- package/plugin/skills/lit-typographic-motion/engine/node/pipeline.mjs +19 -9
- package/plugin/skills/lit-typographic-motion/engine/node/scaffold.mjs +210 -0
- package/plugin/skills/lit-typographic-motion/engine/node/score.mjs +639 -0
- package/plugin/skills/lit-typographic-motion/engine/node/sound-cli.mjs +21 -4
- package/plugin/skills/lit-typographic-motion/engine/node/sound.mjs +127 -29
- package/plugin/skills/lit-typographic-motion/engine/node/stage-capture.mjs +7 -6
- package/plugin/skills/lit-typographic-motion/engine/node/stage-gate.mjs +59 -5
- package/plugin/skills/lit-typographic-motion/engine/node/stage-qa.mjs +141 -9
- package/plugin/skills/lit-typographic-motion/engine/node/stage-serve.mjs +28 -5
- package/plugin/skills/lit-typographic-motion/engine/node/stage.mjs +82 -14
- package/plugin/skills/lit-typographic-motion/engine/node/styles.mjs +213 -0
- package/plugin/skills/lit-typographic-motion/engine/node/treatment.mjs +311 -10
- package/plugin/skills/lit-typographic-motion/engine/stage/cover-init.js +14 -2
- package/plugin/skills/lit-typographic-motion/engine/stage/init.js +11 -1
- package/plugin/skills/lit-typographic-motion/engine/stage/qa.js +6 -1
- package/plugin/skills/lit-typographic-motion/engine/stage/stage-kit.js +83 -0
- package/plugin/skills/lit-typographic-motion/engine/vendor/three/LICENSE +21 -0
- package/plugin/skills/lit-typographic-motion/engine/vendor/three/addons/environments/RoomEnvironment.js +144 -0
- package/plugin/skills/lit-typographic-motion/engine/vendor/three/addons/geometries/RoundedBoxGeometry.js +155 -0
- package/plugin/skills/lit-typographic-motion/engine/vendor/three/three.module.js +54571 -0
- package/plugin/skills/lit-typographic-motion/recipes/hero-3d/expected.json +69 -0
- package/plugin/skills/lit-typographic-motion/recipes/hero-3d/index.html +139 -0
- package/plugin/skills/lit-typographic-motion/recipes/orbit-loop/expected.json +6 -4
- package/plugin/skills/lit-typographic-motion/recipes/painted-light/expected.json +4 -2
- package/plugin/skills/lit-typographic-motion/recipes/weight-tide/expected.json +7 -5
- package/plugin/skills/lit-typographic-motion/references/cover.md +394 -443
- package/plugin/skills/lit-typographic-motion/references/craft-loop.md +57 -87
- package/plugin/skills/lit-typographic-motion/references/depth.md +122 -0
- package/plugin/skills/lit-typographic-motion/references/look.md +94 -129
- package/plugin/skills/lit-typographic-motion/references/runtime.md +58 -91
- package/plugin/skills/lit-typographic-motion/references/sound.md +130 -99
- package/plugin/skills/lit-typographic-motion/references/stage.md +190 -215
- package/plugin/skills/lit-typographic-motion/references/studio.md +245 -0
- package/plugin/skills/lit-typographic-motion/references/style-bibles.md +108 -97
- package/plugin/skills/lit-typographic-motion/references/treatment.md +191 -143
- package/plugin/skills/lit-typographic-motion/scripts/motion-doctor.mjs +17 -5
- package/plugin/skills/lit-typographic-motion/scripts/motion.mjs +47 -7
- package/plugin/skills/lit-typographic-motion/styles/paper.json +41 -0
- package/plugin/skills/lit-typographic-motion/styles/swiss-signal.json +41 -0
- package/plugin/skills/lit-typographic-motion/styles/terminalcore.json +42 -0
- package/plugin/skills/lit-typographic-motion/styles/tidal.json +41 -0
- package/plugin/skills/litresearch/SKILL.md +1 -0
- package/plugin/skills/readme-studio/SKILL.md +2 -0
- package/plugin/skills/review-work/SKILL.md +1 -1
- package/plugin/skills/start-work/SKILL.md +2 -2
|
@@ -1,61 +1,64 @@
|
|
|
1
1
|
# Markdown Slide Specification v2
|
|
2
2
|
|
|
3
|
-
> **Status:** Current. Additive over v1
|
|
4
|
-
> `slide-ast-v1` document.
|
|
5
|
-
> **
|
|
6
|
-
>
|
|
7
|
-
>
|
|
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
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
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
|
|
17
|
-
the
|
|
18
|
-
|
|
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
|
|
26
|
+
The compiler chooses the AST version from the deck's content, not from a flag.
|
|
23
27
|
|
|
24
|
-
|
|
|
25
|
-
|
|
26
|
-
|
|
|
27
|
-
|
|
|
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
|
-
|
|
30
|
-
|
|
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
|
|
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
|
|
46
|
-
|
|
47
|
-
|
|
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
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
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
|
-
|
|
55
|
-
|
|
56
|
-
|
|
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
|
-
|
|
69
|
-
|
|
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
|
|
79
|
-
|
|
80
|
-
|
|
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
|
-
|
|
91
|
-
|
|
92
|
-
|
|
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
|
|
86
|
+
### 5.1 Tier 1 — `region`
|
|
97
87
|
|
|
98
88
|
```
|
|
99
|
-
::: region name=
|
|
89
|
+
::: region name=right_figure
|
|
100
90
|
| 항목 | 값 |
|
|
101
91
|
|------|-----|
|
|
102
92
|
:::
|
|
103
93
|
```
|
|
104
94
|
|
|
105
|
-
The body
|
|
106
|
-
one its type
|
|
107
|
-
|
|
108
|
-
|
|
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
|
|
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
|
-

|
|
119
110
|
:::
|
|
120
111
|
::::
|
|
121
112
|
```
|
|
122
113
|
|
|
123
|
-
Tracks are
|
|
124
|
-
|
|
125
|
-
|
|
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
|
-
-
|
|
128
|
-
|
|
129
|
-
-
|
|
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
|
|
122
|
+
### 5.3 Tier 3 — `box` and `shape`
|
|
136
123
|
|
|
137
124
|
```
|
|
138
|
-
::: box x=
|
|
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
|
|
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
|
|
146
|
-
|
|
147
|
-
|
|
148
|
-
|
|
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
|
|
152
|
-
|
|
153
|
-
|
|
154
|
-
|
|
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`.
|
|
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
|
|
161
|
-
image do not see placements, and coordinates
|
|
162
|
-
|
|
163
|
-
|
|
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
|
|
168
|
-
|
|
169
|
-
|
|
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
|
-
|
|
172
|
-
|
|
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
|
|
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
|
|
188
|
-
|
|
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
|
-
|
|
195
|
-
|
|
196
|
-
|
|
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
|
|
202
|
-
name=` or `:::: columns
|
|
203
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
235
|
-
|
|
236
|
-
|
|
237
|
-
|
|
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
|
-
|
|
205
|
+
## 10. Non-goals retained from v1
|
|
240
206
|
|
|
241
|
-
|
|
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
|
-
|
|
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.
|