@litfamily/litcodex 1.0.14 → 1.0.16

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 (122) hide show
  1. package/README-Ko-KR.md +10 -10
  2. package/README.md +10 -10
  3. package/dist/install/generated-skill-payload-hashes.d.ts +101 -40
  4. package/dist/install/generated-skill-payload-hashes.js +101 -40
  5. package/marketplace/plugins/litcodex/.codex-plugin/plugin.json +1 -1
  6. package/marketplace/plugins/litcodex/components/auto-update/package.json +1 -1
  7. package/marketplace/plugins/litcodex/components/comment-checker/package.json +1 -1
  8. package/marketplace/plugins/litcodex/components/git-bash/package.json +1 -1
  9. package/marketplace/plugins/litcodex/components/lit-loop/dist/auto-handoff.js +11 -7
  10. package/marketplace/plugins/litcodex/components/lit-loop/package.json +1 -1
  11. package/marketplace/plugins/litcodex/components/lsp/package.json +1 -1
  12. package/marketplace/plugins/litcodex/components/rules/package.json +1 -1
  13. package/marketplace/plugins/litcodex/components/start-work-continuation/package.json +1 -1
  14. package/marketplace/plugins/litcodex/components/telemetry/package.json +1 -1
  15. package/marketplace/plugins/litcodex/components/wikify-knowledge/package.json +1 -1
  16. package/marketplace/plugins/litcodex/skills/frontend-ui-ux/THIRD-PARTY-NOTICE.txt +0 -2
  17. package/marketplace/plugins/litcodex/skills/lit-docx/SKILL.md +16 -12
  18. package/marketplace/plugins/litcodex/skills/lit-docx/references/components.md +113 -0
  19. package/marketplace/plugins/litcodex/skills/lit-docx/references/direction-step.md +164 -0
  20. package/marketplace/plugins/litcodex/skills/lit-docx/references/examples/01-report-ko.md +95 -0
  21. package/marketplace/plugins/litcodex/skills/lit-docx/references/examples/02-brief-ko.md +45 -0
  22. package/marketplace/plugins/litcodex/skills/lit-docx/references/examples/03-manual-ko.md +105 -0
  23. package/marketplace/plugins/litcodex/skills/lit-docx/references/examples/04-proposal-ko.md +97 -0
  24. package/marketplace/plugins/litcodex/skills/lit-docx/references/examples/05-memo-en.md +34 -0
  25. package/marketplace/plugins/litcodex/skills/lit-docx/references/examples/06-journal-en.md +89 -0
  26. package/marketplace/plugins/litcodex/skills/lit-docx/references/examples/07-report-en.md +101 -0
  27. package/marketplace/plugins/litcodex/skills/lit-docx/references/examples/08-proposal-en.md +94 -0
  28. package/marketplace/plugins/litcodex/skills/lit-docx/references/examples/09-memo-ko.md +34 -0
  29. package/marketplace/plugins/litcodex/skills/lit-docx/references/page-composition.md +141 -0
  30. package/marketplace/plugins/litcodex/skills/lit-docx/references/tonalities/brief.md +70 -0
  31. package/marketplace/plugins/litcodex/skills/lit-docx/references/tonalities/journal.md +73 -0
  32. package/marketplace/plugins/litcodex/skills/lit-docx/references/tonalities/manual.md +70 -0
  33. package/marketplace/plugins/litcodex/skills/lit-docx/references/tonalities/memo.md +75 -0
  34. package/marketplace/plugins/litcodex/skills/lit-docx/references/tonalities/proposal.md +71 -0
  35. package/marketplace/plugins/litcodex/skills/lit-docx/references/tonalities/report.md +83 -0
  36. package/marketplace/plugins/litcodex/skills/lit-docx/scripts/convert_md_to_docx.py +401 -58
  37. package/marketplace/plugins/litcodex/skills/lit-docx/scripts/docx_craft.py +124 -1
  38. package/marketplace/plugins/litcodex/skills/lit-docx/scripts/docx_design.py +2446 -0
  39. package/marketplace/plugins/litcodex/skills/lit-docx/scripts/docx_layout.py +960 -0
  40. package/marketplace/plugins/litcodex/skills/lit-docx/scripts/slop_lint.py +21 -6
  41. package/marketplace/plugins/litcodex/skills/lit-docx/templates/tonalities/brief.yaml +28 -0
  42. package/marketplace/plugins/litcodex/skills/lit-docx/templates/tonalities/journal.yaml +26 -0
  43. package/marketplace/plugins/litcodex/skills/lit-docx/templates/tonalities/manual.yaml +26 -0
  44. package/marketplace/plugins/litcodex/skills/lit-docx/templates/tonalities/memo.yaml +27 -0
  45. package/marketplace/plugins/litcodex/skills/lit-docx/templates/tonalities/proposal.yaml +27 -0
  46. package/marketplace/plugins/litcodex/skills/lit-docx/templates/tonalities/report.yaml +27 -0
  47. package/marketplace/plugins/litcodex/skills/lit-pptx/SKILL.md +12 -11
  48. package/marketplace/plugins/litcodex/skills/lit-pptx/pretendard-font/public/static/Pretendard-Bold.otf +0 -0
  49. package/marketplace/plugins/litcodex/skills/lit-pptx/pretendard-font/public/static/Pretendard-Regular.otf +0 -0
  50. package/marketplace/plugins/litcodex/skills/lit-pptx/references/anti-slop-checklist.md +33 -29
  51. package/marketplace/plugins/litcodex/skills/lit-pptx/references/authoring-guide.md +11 -2
  52. package/marketplace/plugins/litcodex/skills/lit-pptx/references/density-and-fill.md +179 -0
  53. package/marketplace/plugins/litcodex/skills/lit-pptx/references/design-system-azure.md +1 -1
  54. package/marketplace/plugins/litcodex/skills/lit-pptx/references/direction-step.md +203 -0
  55. package/marketplace/plugins/litcodex/skills/lit-pptx/references/examples/01-pitch-signal-ko.md +185 -0
  56. package/marketplace/plugins/litcodex/skills/lit-pptx/references/examples/02-pitch-studio-en.md +162 -0
  57. package/marketplace/plugins/litcodex/skills/lit-pptx/references/examples/03-business-review-ledger-ko.md +229 -0
  58. package/marketplace/plugins/litcodex/skills/lit-pptx/references/examples/04-research-talk-paper-en.md +212 -0
  59. package/marketplace/plugins/litcodex/skills/lit-pptx/references/examples/05-research-keynote-night-ko.md +191 -0
  60. package/marketplace/plugins/litcodex/skills/lit-pptx/references/examples/06-lecture-chalk-ko.md +175 -0
  61. package/marketplace/plugins/litcodex/skills/lit-pptx/references/examples/07-data-review-night-en.md +241 -0
  62. package/marketplace/plugins/litcodex/skills/lit-pptx/references/examples/08-field-report-atlas-ko.md +168 -0
  63. package/marketplace/plugins/litcodex/skills/lit-pptx/references/examples/09-briefing-gazette-ko.md +219 -0
  64. package/marketplace/plugins/litcodex/skills/lit-pptx/references/examples/10-status-update-ledger-en.md +157 -0
  65. package/marketplace/plugins/litcodex/skills/lit-pptx/references/examples/11-portfolio-studio-ko.md +183 -0
  66. package/marketplace/plugins/litcodex/skills/lit-pptx/references/examples/12-tutorial-chalk-en.md +176 -0
  67. package/marketplace/plugins/litcodex/skills/lit-pptx/references/examples/13-status-update-gazette-ko.md +157 -0
  68. package/marketplace/plugins/litcodex/skills/lit-pptx/references/interview-protocol.md +1 -1
  69. package/marketplace/plugins/litcodex/skills/lit-pptx/references/layout-families.md +210 -0
  70. package/marketplace/plugins/litcodex/skills/lit-pptx/references/title-treatments.md +146 -0
  71. package/marketplace/plugins/litcodex/skills/lit-pptx/references/tonalities/atlas.md +113 -0
  72. package/marketplace/plugins/litcodex/skills/lit-pptx/references/tonalities/chalk.md +115 -0
  73. package/marketplace/plugins/litcodex/skills/lit-pptx/references/tonalities/gazette.md +118 -0
  74. package/marketplace/plugins/litcodex/skills/lit-pptx/references/tonalities/ledger.md +129 -0
  75. package/marketplace/plugins/litcodex/skills/lit-pptx/references/tonalities/night.md +126 -0
  76. package/marketplace/plugins/litcodex/skills/lit-pptx/references/tonalities/paper.md +109 -0
  77. package/marketplace/plugins/litcodex/skills/lit-pptx/references/tonalities/signal.md +121 -0
  78. package/marketplace/plugins/litcodex/skills/lit-pptx/references/tonalities/studio.md +111 -0
  79. package/marketplace/plugins/litcodex/skills/lit-pptx/scripts/compile-deck.js +65 -17
  80. package/marketplace/plugins/litcodex/skills/lit-pptx/scripts/craft_extras.py +654 -11
  81. package/marketplace/plugins/litcodex/skills/lit-pptx/scripts/embed_fonts.py +1 -1
  82. package/marketplace/plugins/litcodex/skills/lit-pptx/scripts/inventory.py +32 -2
  83. package/marketplace/plugins/litcodex/skills/lit-pptx/scripts/lib/directive-parser.js +2 -2
  84. package/marketplace/plugins/litcodex/skills/lit-pptx/scripts/lib/grid-resolver.js +521 -0
  85. package/marketplace/plugins/litcodex/skills/lit-pptx/scripts/lib/layout-resolver.js +401 -16
  86. package/marketplace/plugins/litcodex/skills/lit-pptx/scripts/lib/markdown-loader.js +6 -4
  87. package/marketplace/plugins/litcodex/skills/lit-pptx/scripts/lib/render-adapter-html.js +2 -2
  88. package/marketplace/plugins/litcodex/skills/lit-pptx/scripts/lib/render-adapter-pptx.js +498 -145
  89. package/marketplace/plugins/litcodex/skills/lit-pptx/scripts/lib/render-pack.js +3558 -0
  90. package/marketplace/plugins/litcodex/skills/lit-pptx/scripts/lib/slide-ast.js +54 -6
  91. package/marketplace/plugins/litcodex/skills/lit-pptx/scripts/lib/template-registry.js +335 -11
  92. package/marketplace/plugins/litcodex/skills/lit-pptx/scripts/office-run.mjs +2 -1
  93. package/marketplace/plugins/litcodex/skills/lit-pptx/scripts/qa_deck.py +99 -19
  94. package/marketplace/plugins/litcodex/skills/lit-pptx/scripts/validate_pptx.py +6 -1
  95. package/marketplace/plugins/litcodex/skills/lit-pptx/templates/boilerplate_professional.css +6 -6
  96. package/marketplace/plugins/litcodex/skills/lit-pptx/templates/enrolled/AZURE-A2Z/layout-mapping.yaml +1 -1
  97. package/marketplace/plugins/litcodex/skills/lit-pptx/templates/enrolled/AZURE-A2Z/template.yaml +4 -1
  98. package/marketplace/plugins/litcodex/skills/lit-pptx/templates/enrolled/AZURE-PRO/layout-mapping.yaml +1 -1
  99. package/marketplace/plugins/litcodex/skills/lit-pptx/templates/enrolled/AZURE-PRO/template.yaml +4 -1
  100. package/marketplace/plugins/litcodex/skills/lit-pptx/templates/tonalities/atlas/pack.yaml +105 -0
  101. package/marketplace/plugins/litcodex/skills/lit-pptx/templates/tonalities/chalk/pack.yaml +110 -0
  102. package/marketplace/plugins/litcodex/skills/lit-pptx/templates/tonalities/gazette/pack.yaml +105 -0
  103. package/marketplace/plugins/litcodex/skills/lit-pptx/templates/tonalities/ledger/pack.yaml +106 -0
  104. package/marketplace/plugins/litcodex/skills/lit-pptx/templates/tonalities/night/pack.yaml +106 -0
  105. package/marketplace/plugins/litcodex/skills/lit-pptx/templates/tonalities/paper/pack.yaml +111 -0
  106. package/marketplace/plugins/litcodex/skills/lit-pptx/templates/tonalities/signal/pack.yaml +107 -0
  107. package/marketplace/plugins/litcodex/skills/lit-pptx/templates/tonalities/studio/pack.yaml +105 -0
  108. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/engine/THIRD_PARTY_NOTICES +1 -1
  109. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/engine/fonts.mjs +6 -6
  110. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/engine/gate.mjs +1 -1
  111. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/engine/stage-qa.mjs +2 -2
  112. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/references/runtime.md +1 -1
  113. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/references/stage.md +1 -1
  114. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/references/style-bibles.md +2 -2
  115. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/references/treatment.md +1 -1
  116. package/marketplace/plugins/litcodex/skills/lit-typographic-motion/references/type-and-timing.md +3 -3
  117. package/node_modules/@litcodex/lit-loop/dist/auto-handoff.js +11 -7
  118. package/node_modules/@litcodex/lit-loop/package.json +1 -1
  119. package/package.json +2 -2
  120. package/readme-assets/badge-version.svg +1 -1
  121. package/marketplace/plugins/litcodex/skills/lit-pptx/pretendard-font/public/static/PretendardGOV-Bold.otf +0 -0
  122. package/marketplace/plugins/litcodex/skills/lit-pptx/pretendard-font/public/static/PretendardGOV-Regular.otf +0 -0
@@ -0,0 +1,118 @@
1
+ # Gazette
2
+
3
+ Gazette is a Korean briefing paper laid out as slides. A slate band carries the title of each
4
+ content page, a boxed one-line conclusion sits at the top where it belongs, and 개조식 evidence
5
+ runs in two columns at the compact step down to the floor. A single red key line is the only
6
+ accent. Nobody presents a Gazette deck; it is opened at a desk, read in order, and annotated.
7
+
8
+ ## Reach for it
9
+
10
+ - 보고서형 덱: policy reviews, internal proposals, investigation results, monthly reports that are
11
+ sent ahead and read alone.
12
+ - Korean decks whose bodies run long (150 glyphs per content slide and more) or whose brief says
13
+ "보고서", "배포", "사전 검토".
14
+ - First candidate for Korean text briefings; second for business reviews and status updates read in
15
+ Korean.
16
+
17
+ ## Pass on it
18
+
19
+ - Live talks: the density that serves a reader overwhelms a listener. Signal, Ledger or Night.
20
+ - Picture-led material: Gazette has no picture family.
21
+ - English-only decks read alone: Ledger serves them better; Gazette's rhythm assumes 개조식.
22
+
23
+ ## Tokens
24
+
25
+ | Token | Value |
26
+ |---|---|
27
+ | ground / surface | #FFFFFF / #F1F4F8 |
28
+ | ink / ink-muted / line | #1A2230 / #4A5568 / #C8D0DA |
29
+ | accent / accent-deep / accent-tint | #A61B1B / #233A4F / #E8EEF4 |
30
+ | field / on-field | #233A4F / #FFFFFF |
31
+ | positive / negative | #1E7A3F / #1A2230 |
32
+ | series | #A61B1B, #233A4F, #4A5568, #7A6A2A |
33
+ | faces | Pretendard Bold (display, title, numerals), Pretendard Regular (body, labels); `faces: a2z` swaps display and numerals to A2Z Bold |
34
+ | type voice | tracking −1, tabular figures |
35
+ | table | `header-fill`: header in the slate field with white text, full grid rules, surface banding, bold totals |
36
+ | chart | hairline gridlines, direct labels, accent on the highlighted series, no annotation |
37
+ | image | no bleed, no crop, hairline frame |
38
+ | decoration | header band, box outline, hairline rule, numeral |
39
+ | radius / edge | 0 / fill and border |
40
+
41
+ ## Dials and type
42
+
43
+ Density 10, variance 4 (three treatments, a family at most three times in a row). Variance is low on
44
+ purpose: a desk reader wants the same page head every time. Never more than three text families in
45
+ a row; break them with a table, a timeline or a comparison.
46
+
47
+ ## Titles by role
48
+
49
+ | Role | Default |
50
+ |---|---|
51
+ | content, statement | `band` |
52
+ | data, reference | `top-rule` |
53
+ | sequence | `kicker-numeral` |
54
+ | data-takeaway, image, definition | `side-rail` |
55
+
56
+ `summary-box-list`, `text-two-column` and `ledger-table` may take `band`, `top-rule` or
57
+ `kicker-numeral`; `comparison`, `matrix-2x2` and `table-insight` may take `side-rail`.
58
+
59
+ ## Families and variants
60
+
61
+ - `summary-box-list`: the 핵심 요약 page; `::: key-message` holds the one-line conclusion (three
62
+ lines at most), groups of evidence under it.
63
+ - `text-two-column`, `text-column`: 개조식 groups, level 1 the claim, level 2 the evidence, five
64
+ points per level at most, consistent endings.
65
+ - `ledger-table`, `table-insight`: the figures with their reading.
66
+ - `matrix-2x2`: options sorted by effect and difficulty.
67
+ - `comparison`: 안 1 and 안 2 on the same labelled criteria.
68
+ - `timeline`: 추진 일정 with owners and outputs.
69
+ - `agenda`, `references-appendix` (붙임: sources and definitions).
70
+ - Covers `cover-band`, `cover-typographic`, `cover-index`; sections `section-band`, `section-rule`;
71
+ closings `closing-decision-box` (건의 사항), `closing-ask`.
72
+
73
+ Display devices: cover `band` (the deck's parts run across the page under the band), number panel
74
+ `outline`, closing floor `box`, section index on.
75
+
76
+ ## Do
77
+
78
+ - Write every page as a reader will meet it alone: label, conclusion, evidence, source.
79
+ - Keep 개조식 endings consistent within a list (명사형 또는 -다, not both).
80
+ - Give the decision page each item, its amount, owner and deadline.
81
+ - Close with 붙임: dated sources and the definitions the deck relies on.
82
+
83
+ ## Avoid
84
+
85
+ - English section kickers or labels above titles.
86
+ - Red for anything but the key line.
87
+ - A summary box longer than three lines.
88
+ - More than three text families in a row.
89
+
90
+ ## Worked slide
91
+
92
+ The 핵심 요약 page: one boxed conclusion, three evidence groups, the basis in the note line.
93
+
94
+ ```markdown
95
+ ---
96
+ layout: summary-box-list
97
+
98
+ ## 검토 결과 핵심 요약과 건의 방향
99
+
100
+ ::: key-message
101
+ 동 주민센터 12곳에 주 2회 금융 도움 창구를 열고, 교육은 창구 이용자에게 맞춤형으로 연결한다
102
+ :::
103
+
104
+ - **현황**
105
+ (1) 70세 이상 모바일 뱅킹 이용률 31%, 60대 64%, 전체 평균 78%
106
+ (2) 최근 3년 관내 은행 점포 21곳 → 13곳, 동 4곳은 점포가 없다
107
+ - **검토 결과**
108
+ (1) 집합 교육은 수료 3개월 뒤 실제 이용으로 이어진 비율이 22%에 그쳤다
109
+ (2) 도움 창구 시범 2곳은 방문자의 71%가 다음 달 혼자 이체를 마쳤다
110
+ - **건의 방향**
111
+ (1) 교육 중심에서 생활 현장의 도움 창구 중심으로 바꾼다
112
+ - 주: 복지정책과 실태 조사(65세 이상 1,200명, 2026년 6월)와 도움 창구 시범 기록 기준 (예시)
113
+ ---
114
+ ```
115
+
116
+ ## Examples
117
+
118
+ `09-briefing-gazette-ko.md`, `13-status-update-gazette-ko.md`
@@ -0,0 +1,129 @@
1
+ # Ledger
2
+
3
+ Ledger treats a deck as an account book that has to survive questions. Pages are white and
4
+ tightly set on the compact grid; tables carry a deep green header band with white labels, a rule
5
+ under the header and another above the totals, and right-aligned tabular figures. One teal-green
6
+ accent marks the figure each slide is about. Sections open on a rule or a real part number, never
7
+ on a colour field, so the deck stays quiet enough for a reader to compare numbers across pages.
8
+
9
+ ## Reach for it
10
+
11
+ - Business reviews, quarterly results, budget requests, status updates, data reviews that are read
12
+ before or during the meeting and annotated afterwards.
13
+ - Outlines where 30 % or more of content slides carry a table or a chart, or bodies run long
14
+ (150 Korean glyphs / 300 Latin characters per slide and up).
15
+ - Briefs that say the file is circulated, in a language other than Korean (Korean desk-read decks
16
+ go to Gazette first).
17
+ - First candidate for business reviews and status updates; second for data-heavy reviews and
18
+ Korean briefings.
19
+
20
+ ## Pass on it
21
+
22
+ - A live pitch or a launch: its density buries a listener and its calm palette undersells the
23
+ moment. Signal or Studio.
24
+ - An image-led deck: pictures are framed small with a hairline and bleed only at the sides.
25
+ - A deck built on single claims or quotations: Ledger has no `statement` treatment or family.
26
+
27
+ ## Tokens
28
+
29
+ | Token | Value |
30
+ |---|---|
31
+ | ground / surface | #FFFFFF / #F2F4F6 |
32
+ | ink / ink-muted / line | #16212C / #4B5866 / #D0D6DC |
33
+ | accent / accent-deep / accent-tint | #0E6B5A / #0A4438 / #E2F0EC |
34
+ | field / on-field | #0A4438 / #FFFFFF |
35
+ | positive / negative | #1E7A3F / #B3261E |
36
+ | series | #0E6B5A, #4B5866, #9A6A12, #2F5F8A |
37
+ | faces | Pretendard Bold (display, title, numerals), Pretendard Regular (body, labels); `faces: a2z` swaps display and numerals to A2Z Bold |
38
+ | type voice | tracking −1 on titles and display, sentence case, tabular figures |
39
+ | table | `ledger`: header in the field colour with on-field text, rules under the header and above totals, no banding, bold totals |
40
+ | chart | hairline gridlines, direct labels, accent on the highlighted series over muted ones, annotation on |
41
+ | image | bleed at the sides only, no crop, hairline frame |
42
+ | decoration | accent rule, hairline rule, rail fill, numeral |
43
+ | radius / edge | 0 / fill |
44
+
45
+ ## Dials and type
46
+
47
+ Density 10 (compact grid, 24 pt margins; body 13, labels and table cells 11, sources 9; rows from
48
+ 18 pt; no step-up) and variance 5 (three or four treatments, a family at most three times in a
49
+ row). A deck projected in a large room may drop to density 8 (body 14, 36 pt margins); that is the
50
+ only routine move. Figures never exceed the title step (26 pt).
51
+
52
+ ## Titles by role
53
+
54
+ | Role | Default | Also allowed in some families |
55
+ |---|---|---|
56
+ | content, data, reference | `top-rule` | `kicker-numeral` (agenda, ledger-table, text-two-column), `side-rail` |
57
+ | data-takeaway, definition, statement | `side-rail` | `top-rule`, `bottom-anchor` |
58
+ | sequence | `kicker-numeral` (shows the part number when the deck has sections) | `top-rule`, `bottom-anchor` for timeline |
59
+ | image | `bottom-anchor` | — |
60
+
61
+ Pin with `title:` after `layout:`. `kpi-over-chart` takes only `top-rule`; `full-chart` prefers
62
+ `bottom-anchor`.
63
+
64
+ ## Families and variants
65
+
66
+ - **Numbers:** `kpi-row`, `kpi-over-chart`, `big-number`, `dashboard-grid` put results and their
67
+ trend on one page; `kpi-over-chart` is the usual second slide of a review.
68
+ - **Tables:** `ledger-table` for the full table with takeaways under it; `table-insight` when the
69
+ reading belongs beside it; `matrix-2x2` to place options by effect and effort.
70
+ - **Charts:** `chart-insight`, `full-chart`.
71
+ - **Words and order:** `comparison` (plan against actual, two options), `timeline` (dated steps
72
+ with owners), `agenda`, `text-two-column`, `references-appendix`.
73
+ - **Covers:** `cover-figures` (lifts the first KPI row; values ≤ 12 characters, basis ≤ 24),
74
+ `cover-typographic`, `cover-index` (needs an agenda or two sections).
75
+ - **Sections:** `section-rule`, `section-numeral`; with an agenda both draw an index page with the
76
+ current part marked.
77
+ - **Closings:** `closing-decision-box`, `closing-ask`.
78
+
79
+ Display devices: cover `figures`, number panel `tint` (accent tint behind two to four figures),
80
+ closing floor `box` (the next step in a tinted box), section index on.
81
+
82
+ ## Do
83
+
84
+ - Put units in headers; keep a figure that appears twice identical, ideally from one data file.
85
+ - Give every KPI its basis row (전년 대비, 계획 대비, 목표) and every table a caption with period and
86
+ source.
87
+ - Give each table two or three takeaways; a ledger table without them stops mid-page.
88
+ - Close on a decision box listing each item with amount, owner and date.
89
+ - Fill matrix cells with full phrases (`item · detail · detail`); one-word quadrants leave holes.
90
+
91
+ ## Avoid
92
+
93
+ - KPI rows of counts that are not results (meetings held, documents written).
94
+ - More than one accent colour on a chart.
95
+ - Tables stretched with empty rows or padded cells.
96
+ - Two data slides in a row under `side-rail`.
97
+ - Claims as titles: the label names subject, measure, period; the claim opens the body.
98
+
99
+ ## Worked slide
100
+
101
+ The table names its own source on the line beneath it; the claim arrives as the first takeaway.
102
+
103
+ ```markdown
104
+ ---
105
+ layout: ledger-table
106
+
107
+ ## 제품군별 3분기 매출·영업이익 실적
108
+
109
+ | 제품군 | 매출 계획 | 매출 실적 | 영업이익 | 이익률 | 전년 대비 |
110
+ |---|---|---|---|---|---|
111
+ | 흰우유 | 605 | 598 | 9 | 1.5% | ▼ −2.3% |
112
+ | 발효유 | 360 | 372 | 27 | 7.3% | ▲ +9.1% |
113
+ | 치즈 | 220 | 236 | 21 | 8.9% | ▲ +25.5% |
114
+ | 가공유 | 210 | 222 | 7 | 3.2% | ▲ +5.2% |
115
+ | 합계 | 1,395 | 1,428 | 64 | 4.5% | ▲ +5.6% |
116
+
117
+ 출처: 경영기획실 분기 결산 자료, 2026년 9월 마감 (예시)
118
+
119
+ > 표 1. 제품군별 3분기 실적, 억 원 (예시 데이터)
120
+
121
+ - 흰우유를 뺀 세 제품군이 매출 계획을 넘었다
122
+ - 이익 64억 원 중 발효유와 치즈가 75%를 벌었다
123
+ - 주: 이익률은 제품군 영업이익을 제품군 매출로 나눈 값
124
+ ---
125
+ ```
126
+
127
+ ## Examples
128
+
129
+ `03-business-review-ledger-ko.md`, `10-status-update-ledger-en.md`
@@ -0,0 +1,126 @@
1
+ # Night
2
+
3
+ Night is a stage screen in a dark room. The ground is a deep blue-black (never pure black), type is
4
+ off-white, an amber accent marks the series or figure that matters, and a soft blue carries the
5
+ comparison series. Charts are large and labelled directly; data pages sit under a slate band. It is
6
+ the look for a technical keynote or a data review on a projector, where white pages would glare and
7
+ thin pale type would vanish.
8
+
9
+ ## Reach for it
10
+
11
+ - Data-heavy reviews, technical keynotes, research talks in a hall, operations reviews shown on a
12
+ projector or a large screen.
13
+ - Outlines where charts are 30 % or more of the content slides.
14
+ - Briefs that mention a stage, a keynote, a demo day or a darkened room.
15
+ - First candidate for data-heavy reviews; second for a research talk in a keynote hall; third for
16
+ business reviews and status updates shown on a stage.
17
+
18
+ ## Pass on it
19
+
20
+ - Decks that will be printed or photocopied: dark grounds waste toner and lose contrast on paper.
21
+ Ledger or Paper.
22
+ - Mixed decks: Night never shares a file with light slides.
23
+ - Text-led briefings: Night has no text column or table family beyond the comparison and timeline.
24
+
25
+ ## Tokens
26
+
27
+ | Token | Value |
28
+ |---|---|
29
+ | ground / surface | #0F1419 / #1A222B |
30
+ | ink / ink-muted / line | #E8EDF2 / #A3AEBA / #5A6672 |
31
+ | accent / accent-deep / accent-tint | #E3A857 / #F2C98A / #2A2418 |
32
+ | field / on-field | #1E2A36 / #F5F7FA |
33
+ | positive / negative | #6CC08B / #F08A7E |
34
+ | series | #E3A857, #7FB8E0, #A3AEBA, #C58FD0 |
35
+ | faces | Pretendard Bold (display, title), Pretendard Regular (body, labels, numerals); `faces: a2z` swaps numerals to A2Z Light |
36
+ | type voice | tracking −1 titles, −2 display; tabular figures |
37
+ | table | `header-fill`: surface header with ink text, row rules, protagonist row in accent tint, bold totals |
38
+ | chart | hairline gridlines, direct labels, accent on the highlighted series, annotation on |
39
+ | image | bleed at the sides, crop allowed, no frame |
40
+ | decoration | header band, hairline rule, numeral, rail fill |
41
+ | radius / edge | 6 / fill |
42
+
43
+ ## Dials and type
44
+
45
+ Density 10, variance 6. Fill order starts with `anchor-visual`, so charts take the room first.
46
+ Nothing pale below 18 pt carries meaning on its own: labels at 11 pt use ink-muted only for
47
+ secondary text, never for a figure.
48
+
49
+ ## Titles by role
50
+
51
+ | Role | Default |
52
+ |---|---|
53
+ | content, image | `top-plain-large` |
54
+ | data, reference | `band` |
55
+ | data-takeaway, definition | `side-rail` |
56
+ | sequence | `kicker-numeral` |
57
+ | statement | `statement` |
58
+
59
+ `full-chart` takes only `top-plain-large`; `kpi-over-chart` takes `band` or `top-plain-large`;
60
+ `big-number` takes `side-rail` or `top-plain-large`.
61
+
62
+ ## Families and variants
63
+
64
+ - `full-chart`, `chart-insight`, `dashboard-grid`: the core of a Night deck; up to four series, the
65
+ amber one first.
66
+ - `kpi-row`, `kpi-over-chart`, `big-number`: headline figures with their basis rows.
67
+ - `method`: the model or formula with its terms, for technical talks.
68
+ - `comparison`, `timeline`: options and dated plans.
69
+ - `statement`: a pull quote or a display-led deck on request.
70
+ - Covers `cover-numeral` (a real year from the date), `cover-typographic`, `cover-figures`; sections
71
+ `section-numeral`, `section-field`; closings `closing-statement`, `closing-decision-box`.
72
+
73
+ Display devices: cover `numeral`, statement `open`, number panel `tint` (dark amber tint), closing
74
+ floor `band`.
75
+
76
+ ## Do
77
+
78
+ - Use amber for the series under discussion and blue for its comparison; grey for context.
79
+ - Give every chart a caption naming what is plotted and marking example data.
80
+ - Keep a dashboard to two to four small charts with one shared reading.
81
+ - Close on a decision box with costs, owners and dates.
82
+
83
+ ## Avoid
84
+
85
+ - Neon colours, glows or saturated gradients.
86
+ - A pure black ground or white slides mixed in.
87
+ - Thin light type below 18 pt for anything that matters.
88
+ - A cover year typed into the title as well; `cover-numeral` already shows it from the date.
89
+
90
+ ## Worked slide
91
+
92
+ Two small charts read together, with one shared reading and a note on the definition.
93
+
94
+ ```markdown
95
+ ---
96
+ layout: dashboard-grid
97
+
98
+ ## Night flow and pressure in managed zones, Jul-Sep 2026
99
+
100
+ ::: chart type=line unit="L/s"
101
+ | Week | Minimum night flow (L/s) |
102
+ |---|---|
103
+ | W27 | 412 |
104
+ | W33 | 371 |
105
+ | W39 | 344 |
106
+ > Minimum night flow, 22 managed zones (example data)
107
+ :::
108
+
109
+ ::: chart type=line unit="m"
110
+ | Week | Average night pressure (m) |
111
+ |---|---|
112
+ | W27 | 52 |
113
+ | W33 | 46 |
114
+ | W39 | 45 |
115
+ > Average night pressure head, 22 managed zones (example data)
116
+ :::
117
+
118
+ - Lower night pressure cut minimum night flow by 16% across the managed zones
119
+ - Source: Example district meter and pressure logger data, July-September 2026
120
+ - Note: minimum night flow is the lowest 1-hour mean between 02:00 and 04:00
121
+ ---
122
+ ```
123
+
124
+ ## Examples
125
+
126
+ `05-research-keynote-night-ko.md`, `07-data-review-night-en.md`
@@ -0,0 +1,109 @@
1
+ # Paper
2
+
3
+ Paper is a journal page put on a screen. Ink on white, hairlines instead of fills, figures first
4
+ with numbered captions, booktabs tables, and one deep crimson that always means "the method this
5
+ talk proposes". The title page is set like an article's: a heavy rule, the title, a hairline, the
6
+ presenter, then place and date. Restraint is the point; colleagues should be able to judge the
7
+ evidence without the design arguing for it.
8
+
9
+ ## Reach for it
10
+
11
+ - Research talks, thesis defences, technical reviews, written analyses that will be cited.
12
+ - Outlines with numbered references, DOIs, figures that need captions, or equations.
13
+ - First candidate for research talks; second for lectures; third for data reviews delivered as a
14
+ written analysis.
15
+
16
+ ## Pass on it
17
+
18
+ - Sales, launch or fundraising audiences: the restraint reads as cold. Signal or Studio.
19
+ - KPI-led management decks: Paper has no `kpi-row`; Ledger fits.
20
+ - Picture-led storytelling: figures here are evidence, framed by captions, never full-bleed.
21
+
22
+ ## Tokens
23
+
24
+ | Token | Value |
25
+ |---|---|
26
+ | ground / surface | #FFFFFF / #F5F5F6 |
27
+ | ink / ink-muted / line | #111418 / #50565E / #C9CDD2 |
28
+ | accent / accent-deep / accent-tint | #8C1C2B / #5E121C / #F6E6E8 |
29
+ | field / on-field | #111418 / #FFFFFF |
30
+ | positive / negative | #1E6B3A / #50565E |
31
+ | series | #8C1C2B, #111418, #50565E, #2E5E8A |
32
+ | faces | Pretendard Bold (display, title), Pretendard Regular (body, labels, numerals); the A2Z option changes nothing here |
33
+ | type voice | tracking 0 titles, −1 display; tabular figures |
34
+ | table | `booktabs`: no header fill, three rules (top, under header, bottom), no banding, bold totals |
35
+ | chart | hairline gridlines, direct labels, series in palette order (the proposed method first), no annotation |
36
+ | image | no bleed, no crop, no frame |
37
+ | decoration | hairline rule, box outline |
38
+ | radius / edge | 0 / border |
39
+
40
+ ## Dials and type
41
+
42
+ Density 10, variance 5. Fill order starts with `anchor-visual`, then `distribute`. References that do
43
+ not fit step down to label size and then run in two columns; give eight to ten entries.
44
+
45
+ ## Titles by role
46
+
47
+ | Role | Default |
48
+ |---|---|
49
+ | content, data, sequence, reference | `top-rule` (on a hairline, never a short accent bar) |
50
+ | data-takeaway, image | `bottom-anchor` |
51
+ | definition | `side-rail` |
52
+ | statement | `statement` (between rules) |
53
+
54
+ A comparison is the one family with a title of its own (`structure`): it is drawn as a ruled table
55
+ under a `top-rule` title, kept even when the deck already leans on that title.
56
+
57
+ ## Families and variants
58
+
59
+ - `figure-academic`: a numbered figure with observation, basis, limitation and implication lines.
60
+ - `figure-pair`: two conditions or before and after, one line of reading.
61
+ - `method`: the model with its symbols defined, figure or formula first.
62
+ - `chart-insight`, `full-chart`: results; the proposed method takes the crimson.
63
+ - `table-insight`: booktabs results tables with the reading beside them.
64
+ - `comparison`: contributions against limits, on the same criteria.
65
+ - `quote`, `statement`, `text-column`, `references-appendix`.
66
+ - Covers `cover-index` (needs an agenda or two sections), `cover-typographic`, `cover-split-image`;
67
+ sections `section-rule`, `section-field`; closings `closing-summary-list`, `closing-ask`.
68
+
69
+ Display devices: cover `rules` (journal title page), statement `rules`, number panel `outline`,
70
+ closing floor `rules`, section index on.
71
+
72
+ ## Do
73
+
74
+ - Number every figure and table, and give each a source line.
75
+ - Use crimson only for the proposed method or its result.
76
+ - Define every symbol on the method slide, with units.
77
+ - End with findings, the next study and the ask, then references with dates.
78
+
79
+ ## Avoid
80
+
81
+ - The short accent bar under titles; Paper's rule is a hairline.
82
+ - Coloured card fills.
83
+ - Figures without numbered captions.
84
+ - References set below the source size or squeezed into one column at 8 pt.
85
+
86
+ ## Worked slide
87
+
88
+ A numbered figure read the way a reviewer reads it.
89
+
90
+ ```markdown
91
+ ---
92
+ layout: figure-academic
93
+
94
+ ## Raw and calibrated readings against the reference probe
95
+
96
+ ![Figure 1. Low-cost probe against reference probe, 60 pits, 15-minute readings | Source: example image](assets/example-a.png)
97
+
98
+ - **Observation** Raw readings follow the reference but read 6-9 points high in wet soil
99
+ - **Observation** After a two-point calibration per soil batch, RMSE falls from 7.8 to 2.1 VWC points
100
+ - **Basis** 498,000 paired readings from 60 pits over 14 weeks (example data)
101
+ - **Limitation** One soil mix and one depth; clay-rich pits were not in the sample
102
+ - **Implication** A per-batch calibration is enough; per-probe calibration adds 0.3 points of accuracy
103
+ - Source: Example Urban Forestry Lab field data, June-September 2026 (example data)
104
+ ---
105
+ ```
106
+
107
+ ## Examples
108
+
109
+ `04-research-talk-paper-en.md`
@@ -0,0 +1,121 @@
1
+ # Signal
2
+
3
+ Signal is built for a speaker standing in front of people who must decide something. The ground is
4
+ white, the type near-black, and a single hot red-orange is kept for the protagonist: the number,
5
+ the word or the bar the slide exists for. There are no cards and almost no rules; space, weight and
6
+ that one colour do the grouping. On the compact step each slide still carries its basis and source,
7
+ so the file holds up when it is forwarded after the meeting.
8
+
9
+ ## Reach for it
10
+
11
+ - Investment pitches, proposals, launches, any ten-to-fifteen-minute talk that ends in an ask.
12
+ - Short bodies (about 40 Korean glyphs or 80 Latin characters per content slide or fewer), a few
13
+ real headline numbers, a story from problem to ask.
14
+ - First candidate for pitches; third for an image-led launch with few pictures.
15
+
16
+ ## Pass on it
17
+
18
+ - Decks that will mostly be read alone: open pages hold less than a solitary reader needs.
19
+ Ledger or Gazette.
20
+ - Outlines where a third or more of the slides are tables: Signal has no `ledger-table` or
21
+ `dashboard-grid`, and its open table style is meant for one table, not ten.
22
+ - Rooms that want a quiet document: the red field cover and band are loud by design.
23
+
24
+ ## Tokens
25
+
26
+ | Token | Value |
27
+ |---|---|
28
+ | ground / surface | #FFFFFF / #F4F4F5 |
29
+ | ink / ink-muted / line | #15131A / #55525C / #D4D4D8 |
30
+ | accent / accent-deep / accent-tint | #C8361A / #6E1A0C / #FBE7E2 |
31
+ | field / on-field | #C8361A / #FFFFFF |
32
+ | positive / negative | #1E7A3F / #15131A (losses in ink with ▼, because red means "look here") |
33
+ | series | #C8361A, #15131A, #6B6870, #2F6F8F |
34
+ | faces | Pretendard Bold (display, title, numerals), Pretendard Regular (body, labels); `faces: a2z` gives A2Z Black display and numerals, A2Z Bold titles |
35
+ | type voice | tracking −1 titles, −2 display; proportional figures |
36
+ | table | `open`: no header fill, rules at top and bottom, protagonist row in accent tint, bold totals |
37
+ | chart | no gridlines, direct labels, accent on the highlighted bar over muted ones, annotation on |
38
+ | image | bleed and crop allowed, no frame |
39
+ | decoration | colour field, hairline rule, numeral |
40
+ | radius / edge | 0 / fill |
41
+
42
+ ## Dials and type
43
+
44
+ Density 10 and variance 6 (three or four treatments). Drop to density 8 only when the deck is shown
45
+ from a stage and never sent. Figures stop at the title step; a panel of three related figures
46
+ reads stronger than one giant number.
47
+
48
+ ## Titles by role
49
+
50
+ | Role | Default |
51
+ |---|---|
52
+ | content, data-takeaway | `top-plain-large` |
53
+ | data, sequence, reference, definition | `top-rule` |
54
+ | image | `bottom-anchor` |
55
+ | statement | `statement` |
56
+
57
+ `big-number`, `kpi-row`, `chart-insight` and `comparison` may also take `bottom-anchor` when the
58
+ visual should own the top of the page.
59
+
60
+ ## Families and variants
61
+
62
+ - `big-number`: a red panel of two to four related figures, each with label and basis, evidence
63
+ beside it.
64
+ - `image-split` and `asymmetric-feature`: a product picture with three to five labelled points;
65
+ the asymmetric version gives the picture the narrow side.
66
+ - `process`: three to five steps; on the compact step each row reads numeral, step, what happens.
67
+ - `kpi-row`, `chart-insight`, `full-chart`: traction and growth with one highlighted series.
68
+ - `comparison`: before and after, or the incumbent against the new way, on shared criteria.
69
+ - `table-insight`: the one table a pitch needs, usually unit economics.
70
+ - `quote`: a customer's sentence set as the statement; `statement` only for a pull quote or a
71
+ display-led deck the user asked for.
72
+ - Covers `cover-numeral`, `cover-typographic`, `cover-split-field`; sections `section-field`,
73
+ `section-numeral`; closings `closing-statement`, `closing-ask`.
74
+
75
+ Display devices: cover `drench` (the field edge to edge, title anchored low), statement `open`,
76
+ number panel `field` (white figures on red), closing floor `band` (the next step in a red band
77
+ above the footer).
78
+
79
+ ## Do
80
+
81
+ - Label every title (subject, measure, period); the claim is the first body line.
82
+ - Give each figure a basis or comparison and a caption with period and source.
83
+ - Keep bullet lists to four or five points, each carrying a number or a name.
84
+ - End on `closing-ask`: the amount in the title, its uses as a table of item, amount, date and
85
+ owner, and the next meeting with a name on it.
86
+
87
+ ## Avoid
88
+
89
+ - Red for losses or warnings.
90
+ - Display text running past two lines; a single huge figure alone on a page.
91
+ - Cards and boxed groups.
92
+ - A table slide with no line telling the room what to take from it.
93
+
94
+ ## Worked slide
95
+
96
+ A problem slide as a data panel: four related figures, their basis under each, the reading beside.
97
+
98
+ ```markdown
99
+ ---
100
+ layout: big-number
101
+
102
+ ## 동네 약국 유효기간 경과 의약품 폐기 규모
103
+
104
+ | 연간 폐기액 (약국당) | 폐기 품목 중 전문약 | 반품 불가 비중 | 약국 수 (수도권) |
105
+ |---|---|---|---|
106
+ | 310만 원 | 72% | 41% | 1만 1천 곳 |
107
+ | 2025년 표본 평균 | 금액 기준 | 낱알·개봉 포장 | 2025년 말 기준 |
108
+
109
+ 출처: 예시 약사회 재고 실태 조사, 수도권 약국 220곳, 2025년 11월 (예시)
110
+
111
+ > 수도권 약국 재고 조사, 2025년 (예시)
112
+
113
+ - 약국 한 곳이 해마다 약 310만 원어치 약을 기한이 지나 버린다
114
+ - 폐기액의 72%는 처방이 드문 전문약이고, 그중 41%는 도매상 반품이 안 된다
115
+ - 주: 폐기액은 약가 기준, 마약류와 냉장 보관 품목은 제외
116
+ ---
117
+ ```
118
+
119
+ ## Examples
120
+
121
+ `01-pitch-signal-ko.md`