@pugi/cli 1.0.0-alpha.25 → 1.0.0-alpha.251

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 (206) hide show
  1. package/README.md +1 -1
  2. package/THIRD_PARTY_NOTICES.md +39 -0
  3. package/bin/pugi +19 -5
  4. package/models.json +1 -0
  5. package/package.json +22 -6
  6. package/release.json +8 -0
  7. package/skills/a11y/SKILL.md +27 -0
  8. package/skills/ab-test-analysis/SKILL.md +15 -0
  9. package/skills/ai-sdk/SKILL.md +27 -0
  10. package/skills/api-integration/SKILL.md +27 -0
  11. package/skills/architecture-review/SKILL.md +19 -0
  12. package/skills/brand-voice/SKILL.md +27 -0
  13. package/skills/ci-cd-pipeline/SKILL.md +15 -0
  14. package/skills/code-review/SKILL.md +27 -0
  15. package/skills/competitor-analysis/SKILL.md +27 -0
  16. package/skills/content-design/SKILL.md +35 -0
  17. package/skills/css-tailwind/SKILL.md +39 -0
  18. package/skills/css-tailwind/quirks.md +86 -0
  19. package/skills/db-vector/SKILL.md +27 -0
  20. package/skills/design-radix/SKILL.md +35 -0
  21. package/skills/design-system/SKILL.md +35 -0
  22. package/skills/detecting-data-anomalies/SKILL.md +15 -0
  23. package/skills/docker-deploy/SKILL.md +15 -0
  24. package/skills/edge-case-finder/SKILL.md +27 -0
  25. package/skills/fonts/SKILL.md +34 -0
  26. package/skills/framework-grammy/SKILL.md +27 -0
  27. package/skills/framework-mastra/SKILL.md +27 -0
  28. package/skills/framework-nestjs/SKILL.md +27 -0
  29. package/skills/framework-prisma/SKILL.md +27 -0
  30. package/skills/funnel-optimization/SKILL.md +19 -0
  31. package/skills/ha-prototype-web/LICENSE-APACHE-2.0 +201 -0
  32. package/skills/ha-prototype-web/NOTICE.md +126 -0
  33. package/skills/ha-prototype-web/SKILL.md +25 -0
  34. package/skills/icons/SKILL.md +34 -0
  35. package/skills/landing-templates/SKILL.md +35 -0
  36. package/skills/market-research/SKILL.md +27 -0
  37. package/skills/metrics-dashboard/SKILL.md +19 -0
  38. package/skills/monitoring-setup/SKILL.md +15 -0
  39. package/skills/motion/SKILL.md +27 -0
  40. package/skills/nestjs-api/SKILL.md +38 -0
  41. package/skills/nestjs-api/quirks.md +36 -0
  42. package/skills/nextjs-page/SKILL.md +27 -0
  43. package/skills/od-blog-post/LICENSE-APACHE-2.0 +201 -0
  44. package/skills/od-blog-post/NOTICE.md +126 -0
  45. package/skills/od-blog-post/SKILL.md +81 -0
  46. package/skills/od-contact-widget/LICENSE-APACHE-2.0 +201 -0
  47. package/skills/od-contact-widget/NOTICE.md +126 -0
  48. package/skills/od-contact-widget/SKILL.md +132 -0
  49. package/skills/od-craft/LICENSE-APACHE-2.0 +201 -0
  50. package/skills/od-craft/NOTICE.md +126 -0
  51. package/skills/od-craft/SKILL.md +58 -0
  52. package/skills/od-craft/references/README.md +108 -0
  53. package/skills/od-craft/references/accessibility-baseline.md +203 -0
  54. package/skills/od-craft/references/animation-discipline.md +156 -0
  55. package/skills/od-craft/references/anti-ai-slop.md +86 -0
  56. package/skills/od-craft/references/color.md +90 -0
  57. package/skills/od-craft/references/form-validation.md +223 -0
  58. package/skills/od-craft/references/laws-of-ux.md +298 -0
  59. package/skills/od-craft/references/rtl-and-bidi.md +188 -0
  60. package/skills/od-craft/references/state-coverage.md +136 -0
  61. package/skills/od-craft/references/typography-hierarchy-editorial.md +184 -0
  62. package/skills/od-craft/references/typography-hierarchy.md +167 -0
  63. package/skills/od-craft/references/typography.md +124 -0
  64. package/skills/od-critique/LICENSE-APACHE-2.0 +201 -0
  65. package/skills/od-critique/NOTICE.md +126 -0
  66. package/skills/od-critique/SKILL.md +259 -0
  67. package/skills/od-dashboard/LICENSE-APACHE-2.0 +201 -0
  68. package/skills/od-dashboard/NOTICE.md +126 -0
  69. package/skills/od-dashboard/SKILL.md +77 -0
  70. package/skills/od-design-brief/LICENSE-APACHE-2.0 +201 -0
  71. package/skills/od-design-brief/NOTICE.md +126 -0
  72. package/skills/od-design-brief/SKILL.md +260 -0
  73. package/skills/od-docs-page/LICENSE-APACHE-2.0 +201 -0
  74. package/skills/od-docs-page/NOTICE.md +126 -0
  75. package/skills/od-docs-page/SKILL.md +81 -0
  76. package/skills/od-email-marketing/LICENSE-APACHE-2.0 +201 -0
  77. package/skills/od-email-marketing/NOTICE.md +126 -0
  78. package/skills/od-email-marketing/SKILL.md +85 -0
  79. package/skills/od-eng-runbook/LICENSE-APACHE-2.0 +201 -0
  80. package/skills/od-eng-runbook/NOTICE.md +126 -0
  81. package/skills/od-eng-runbook/SKILL.md +52 -0
  82. package/skills/od-faq-page/LICENSE-APACHE-2.0 +201 -0
  83. package/skills/od-faq-page/NOTICE.md +126 -0
  84. package/skills/od-faq-page/SKILL.md +113 -0
  85. package/skills/od-finance-report/LICENSE-APACHE-2.0 +201 -0
  86. package/skills/od-finance-report/NOTICE.md +126 -0
  87. package/skills/od-finance-report/SKILL.md +62 -0
  88. package/skills/od-frontend-design/LICENSE-APACHE-2.0 +201 -0
  89. package/skills/od-frontend-design/LICENSE.txt +177 -0
  90. package/skills/od-frontend-design/NOTICE.md +126 -0
  91. package/skills/od-frontend-design/SKILL.md +86 -0
  92. package/skills/od-hr-onboarding/LICENSE-APACHE-2.0 +201 -0
  93. package/skills/od-hr-onboarding/NOTICE.md +126 -0
  94. package/skills/od-hr-onboarding/SKILL.md +53 -0
  95. package/skills/od-invoice/LICENSE-APACHE-2.0 +201 -0
  96. package/skills/od-invoice/NOTICE.md +126 -0
  97. package/skills/od-invoice/SKILL.md +49 -0
  98. package/skills/od-kanban-board/LICENSE-APACHE-2.0 +201 -0
  99. package/skills/od-kanban-board/NOTICE.md +126 -0
  100. package/skills/od-kanban-board/SKILL.md +51 -0
  101. package/skills/od-login-flow/LICENSE-APACHE-2.0 +201 -0
  102. package/skills/od-login-flow/NOTICE.md +126 -0
  103. package/skills/od-login-flow/SKILL.md +49 -0
  104. package/skills/od-login-flow/references/checklist.md +19 -0
  105. package/skills/od-magazine-poster/LICENSE-APACHE-2.0 +201 -0
  106. package/skills/od-magazine-poster/NOTICE.md +126 -0
  107. package/skills/od-magazine-poster/SKILL.md +90 -0
  108. package/skills/od-meeting-notes/LICENSE-APACHE-2.0 +201 -0
  109. package/skills/od-meeting-notes/NOTICE.md +126 -0
  110. package/skills/od-meeting-notes/SKILL.md +48 -0
  111. package/skills/od-mobile-app/LICENSE-APACHE-2.0 +201 -0
  112. package/skills/od-mobile-app/NOTICE.md +126 -0
  113. package/skills/od-mobile-app/SKILL.md +103 -0
  114. package/skills/od-mobile-app/assets/template.html +442 -0
  115. package/skills/od-mobile-app/references/checklist.md +46 -0
  116. package/skills/od-mobile-app/references/layouts.md +312 -0
  117. package/skills/od-mobile-onboarding/LICENSE-APACHE-2.0 +201 -0
  118. package/skills/od-mobile-onboarding/NOTICE.md +126 -0
  119. package/skills/od-mobile-onboarding/SKILL.md +54 -0
  120. package/skills/od-pm-spec/LICENSE-APACHE-2.0 +201 -0
  121. package/skills/od-pm-spec/NOTICE.md +126 -0
  122. package/skills/od-pm-spec/SKILL.md +53 -0
  123. package/skills/od-pricing-page/LICENSE-APACHE-2.0 +201 -0
  124. package/skills/od-pricing-page/NOTICE.md +126 -0
  125. package/skills/od-pricing-page/SKILL.md +80 -0
  126. package/skills/od-redesign-skill/LICENSE +21 -0
  127. package/skills/od-redesign-skill/LICENSE-APACHE-2.0 +201 -0
  128. package/skills/od-redesign-skill/NOTICE.md +126 -0
  129. package/skills/od-redesign-skill/SKILL.md +205 -0
  130. package/skills/od-reference-design-contract/LICENSE-APACHE-2.0 +201 -0
  131. package/skills/od-reference-design-contract/NOTICE.md +126 -0
  132. package/skills/od-reference-design-contract/SKILL.md +131 -0
  133. package/skills/od-reference-design-contract/references/checklist.md +26 -0
  134. package/skills/od-saas-landing/LICENSE-APACHE-2.0 +201 -0
  135. package/skills/od-saas-landing/NOTICE.md +126 -0
  136. package/skills/od-saas-landing/SKILL.md +125 -0
  137. package/skills/od-social-carousel/LICENSE-APACHE-2.0 +201 -0
  138. package/skills/od-social-carousel/NOTICE.md +126 -0
  139. package/skills/od-social-carousel/SKILL.md +92 -0
  140. package/skills/od-team-okrs/LICENSE-APACHE-2.0 +201 -0
  141. package/skills/od-team-okrs/NOTICE.md +126 -0
  142. package/skills/od-team-okrs/SKILL.md +48 -0
  143. package/skills/od-waitlist-page/LICENSE-APACHE-2.0 +201 -0
  144. package/skills/od-waitlist-page/NOTICE.md +126 -0
  145. package/skills/od-waitlist-page/SKILL.md +229 -0
  146. package/skills/od-waitlist-page/assets/template.html +457 -0
  147. package/skills/od-waitlist-page/references/checklist.md +42 -0
  148. package/skills/od-web-design-guidelines/LICENSE +21 -0
  149. package/skills/od-web-design-guidelines/LICENSE-APACHE-2.0 +201 -0
  150. package/skills/od-web-design-guidelines/NOTICE.md +126 -0
  151. package/skills/od-web-design-guidelines/SKILL.md +66 -0
  152. package/skills/od-web-design-guidelines/references/guidelines.md +133 -0
  153. package/skills/od-web-prototype/LICENSE-APACHE-2.0 +201 -0
  154. package/skills/od-web-prototype/NOTICE.md +126 -0
  155. package/skills/od-web-prototype/SKILL.md +102 -0
  156. package/skills/od-web-prototype/assets/template.html +348 -0
  157. package/skills/od-web-prototype/references/checklist.md +47 -0
  158. package/skills/od-web-prototype/references/layouts.md +247 -0
  159. package/skills/od-web-prototype-taste-brutalist/LICENSE-APACHE-2.0 +201 -0
  160. package/skills/od-web-prototype-taste-brutalist/LICENSE-MIT-Leonxlnx +21 -0
  161. package/skills/od-web-prototype-taste-brutalist/NOTICE.md +126 -0
  162. package/skills/od-web-prototype-taste-brutalist/SKILL.md +64 -0
  163. package/skills/od-web-prototype-taste-editorial/LICENSE-APACHE-2.0 +201 -0
  164. package/skills/od-web-prototype-taste-editorial/LICENSE-MIT-Leonxlnx +21 -0
  165. package/skills/od-web-prototype-taste-editorial/NOTICE.md +126 -0
  166. package/skills/od-web-prototype-taste-editorial/SKILL.md +61 -0
  167. package/skills/od-web-prototype-taste-soft/LICENSE-APACHE-2.0 +201 -0
  168. package/skills/od-web-prototype-taste-soft/LICENSE-MIT-Leonxlnx +21 -0
  169. package/skills/od-web-prototype-taste-soft/NOTICE.md +126 -0
  170. package/skills/od-web-prototype-taste-soft/SKILL.md +64 -0
  171. package/skills/od-webgl-experience/LICENSE-APACHE-2.0 +201 -0
  172. package/skills/od-webgl-experience/NOTICE.md +126 -0
  173. package/skills/od-webgl-experience/SKILL.md +81 -0
  174. package/skills/od-wireframe-annotated/LICENSE-APACHE-2.0 +201 -0
  175. package/skills/od-wireframe-annotated/NOTICE.md +126 -0
  176. package/skills/od-wireframe-annotated/SKILL.md +90 -0
  177. package/skills/od-wireframe-greybox/LICENSE-APACHE-2.0 +201 -0
  178. package/skills/od-wireframe-greybox/NOTICE.md +126 -0
  179. package/skills/od-wireframe-greybox/SKILL.md +90 -0
  180. package/skills/od-wireframe-mobile-flow/LICENSE-APACHE-2.0 +201 -0
  181. package/skills/od-wireframe-mobile-flow/NOTICE.md +126 -0
  182. package/skills/od-wireframe-mobile-flow/SKILL.md +96 -0
  183. package/skills/od-wireframe-sketch/LICENSE-APACHE-2.0 +201 -0
  184. package/skills/od-wireframe-sketch/NOTICE.md +126 -0
  185. package/skills/od-wireframe-sketch/SKILL.md +98 -0
  186. package/skills/orchestrating-multi-agent-systems/SKILL.md +19 -0
  187. package/skills/preprocessing-data/SKILL.md +15 -0
  188. package/skills/project-memory-keeper/SKILL.md +19 -0
  189. package/skills/public-apis/SKILL.md +27 -0
  190. package/skills/pugi-patterns/SKILL.md +19 -0
  191. package/skills/react-component/SKILL.md +27 -0
  192. package/skills/sprint-planning/SKILL.md +19 -0
  193. package/skills/stack-selection/SKILL.md +15 -0
  194. package/skills/standup-summary/SKILL.md +15 -0
  195. package/skills/task-decomposition/SKILL.md +19 -0
  196. package/skills/team-routing/SKILL.md +15 -0
  197. package/skills/tech-survey/SKILL.md +15 -0
  198. package/skills/test-plan/SKILL.md +15 -0
  199. package/skills/typescript-refactor/SKILL.md +15 -0
  200. package/skills/ui-components/SKILL.md +35 -0
  201. package/skills/ux-patterns/SKILL.md +35 -0
  202. package/skills/web-platform/SKILL.md +27 -0
  203. package/skills/web-scrape/SKILL.md +27 -0
  204. package/skills/web-search/SKILL.md +15 -0
  205. package/skills/webapp-testing/SKILL.md +37 -0
  206. package/skills/webapp-testing/quirks.md +26 -0
@@ -0,0 +1,184 @@
1
+ <!-- Vendored from nexu-io/open-design@78d5637cb49d (craft/typography-hierarchy-editorial.md), Apache-2.0, Copyright 2026 Open Design contributors. Modified by Pugi: this header line added; the text below is otherwise verbatim. Paths it names (apps/daemon/src/lint-artifact.ts, pnpm lint:craft, od.craft.requires) are upstream's, not Pugi's: the Pugi port of the linter is packages/opencode/src/session/design-lint.ts. See NOTICE.md in the skill root. -->
2
+
3
+ # Editorial typography hierarchy craft rules
4
+
5
+ Extends `typography.md` + `typography-hierarchy.md`. Defines hierarchy
6
+ behavior for editorial surfaces: long-form articles, magazine layouts,
7
+ digital guides, editorial landing pages, and blog posts.
8
+
9
+ > Opt in via `od.craft.requires: [typography, typography-hierarchy, typography-hierarchy-editorial]`.
10
+
11
+ ---
12
+
13
+ ## What "editorial" means here
14
+
15
+ Editorial hierarchy means the pacing is authored the way a print art director
16
+ paces a spread: entry point, tension, rest, disruption, resolution. The reader
17
+ is moved through content rather than given a uniform reading surface. SaaS
18
+ hierarchy is additive — elements stack and each gets its turn. Editorial
19
+ hierarchy is compositional — elements are weighted against each other and
20
+ some are deliberately suppressed so others can breathe.
21
+
22
+ ---
23
+
24
+ ## Editorial hierarchy principles
25
+
26
+ ### 1. Dramatic scale jumps
27
+
28
+ Editorial type scales are not gradual. The gap between display and body
29
+ is large — often 3–5× — because the display element is not just a heading,
30
+ it is a visual event.
31
+
32
+ | Level | Typical range | Notes |
33
+ |---|---|---|
34
+ | Display / lede | 56–96 px | (editorial override) May intentionally exceed the default `typography.md` display range |
35
+ | Deck / standfirst | 18–24 px | Large jump down — intentional |
36
+ | Body | 16–18 px | Close to deck is fine; they're in the same reading register |
37
+ | Pull quote | 28–40 px | Disrupts body rhythm; treated as a visual break, not a heading |
38
+ | Caption / label | 11–13 px | Minimal — never competes with body |
39
+
40
+ The gap between display and deck is the editorial signature. A small step
41
+ here reads as SaaS, not editorial.
42
+
43
+ ### 2. Whitespace carries hierarchy
44
+
45
+ Editorial hierarchy is not announced by a heavy heading. It is created by
46
+ the space that surrounds an element. An article title in a moderate weight
47
+ surrounded by generous whitespace outranks a bold heading crammed against
48
+ its content.
49
+
50
+ Rules:
51
+ - Above-the-fold display element: minimum 2× the line-height in space above
52
+ and below before body begins.
53
+ - Pull quotes: full column margin on both sides, or break the grid entirely.
54
+ - Section breaks: use space as the default hierarchy signal. Separators (rules, dingbats,
55
+ folios, chapter marks) are allowed only when they reinforce publication identity or
56
+ distinguish unrelated content. For RTL layouts, mirror or adapt separators using
57
+ logical directions (inline-start, inline-end) rather than physical (left, right).
58
+ - Caption clusters: tighter internal spacing, larger gap from the body above.
59
+
60
+ ### 3. Restrained bold
61
+
62
+ Editorial systems use weight sparingly. The display element is often set in
63
+ a light or regular weight — hierarchy is carried by scale and space, not mass.
64
+
65
+ Bold in editorial context means: this word/phrase matters beyond the sentence.
66
+ It is not used for section labels, UI chrome, or navigation. One to two bold
67
+ phrases per 400 words of body copy is a working upper bound.
68
+
69
+ If everything important is bold, nothing is.
70
+
71
+ ### 4. Display tracking
72
+
73
+ Negative tracking at large sizes is mandatory for Latin display. At editorial display sizes
74
+ (56 px+), tracking should be `-0.02em` to `-0.05em` (editorial override;
75
+ see `typography.md` §letter-spacing for the default range). Light display
76
+ weights may go tighter within this range.
77
+
78
+ **Script-aware exception:** For Arabic, Persian, and Urdu (cursive-joining scripts),
79
+ keep tracking at `0` — negative letter-spacing breaks cursive joining (see `rtl-and-bidi`).
80
+ Hebrew uses logical spacing rules but is not cursive-joining; consult `rtl-and-bidi`
81
+ for right-to-left baseline adjustments. Hierarchy in these scripts is carried by size,
82
+ weight, and whitespace, not tracking.
83
+
84
+ ---
85
+
86
+ ### 5. Pull quotes as rhythm disruption
87
+
88
+ A pull quote is not a blockquote. It is a visual interrupt.
89
+
90
+ | Property | Behavior |
91
+ |---|---|
92
+ | Scale | 28–40 px — above body, below display |
93
+ | Weight | Regular or light — never bold |
94
+ | Tracking | Slightly negative (`-0.01em`) or zero |
95
+ | Alignment | Break from body column — full width, or offset inline-start/inline-end |
96
+ | Spacing | Large above and below — equal to or greater than a section break |
97
+ | Color | May use `var(--accent)` as the only accent use on the page |
98
+
99
+ Pull quotes placed at regular intervals destroy their effect. One per
100
+ long-form article is usually correct. Two is a maximum.
101
+
102
+ ### 6. Body measure and reading rhythm
103
+
104
+ Long-form body copy: 60–70 ch line length. Tighter than the `typography.md`
105
+ max because editorial reading is sustained, not scanning.
106
+
107
+ Line height: `1.6`–`1.7` for serif body. Slightly more generous than the
108
+ universal rule because editorial bodies are set at a reading size, not a UI
109
+ size.
110
+
111
+ Do not justify. Use `text-align: start` with a ragged inline-end edge — the
112
+ natural setting for editorial body copy on screen.
113
+
114
+ ### 7. Asymmetrical rhythm
115
+
116
+ Uniform section spacing reads as a template. Editorial pacing alternates
117
+ between compression and expansion:
118
+
119
+ - Dense section → spacious section → medium section.
120
+ - A tightly spaced image caption cluster immediately after a generous
121
+ body paragraph creates productive tension.
122
+ - The final section before a pull quote should tighten; after it, release.
123
+
124
+ ---
125
+
126
+ ## Editorial hierarchy table
127
+
128
+ | Element | Scale | Weight | Tracking | Leading | Spacing role |
129
+ |---|---|---|---|---|---|
130
+ | Display headline | 56–96 px | Light or regular | `-0.02em` to `-0.05em` | `1.0`–`1.1` | Event — generous above/below |
131
+ | Deck / standfirst | 18–24 px | Regular | `0` | `1.4`–`1.5` | Transitional — moderate gap below |
132
+ | Byline / dateline | 12–14 px | Regular or medium | `0.02em`–`0.04em` | `1.5` | Recedes — tight gap below |
133
+ | Body | 16–18 px | Regular | `0` | `1.6`–`1.7` | Baseline — rhythm carrier |
134
+ | Pull quote | 28–40 px | Regular or light | `-0.01em` (Latin only; 0 for joining scripts) | `1.2`–`1.3` | Interrupt — large above/below |
135
+ | Image caption | 12–13 px | Regular | `0.01em` | `1.5` | Recedes — tight cluster |
136
+ | Section label | 11–12 px | Medium | `0.06em`–`0.1em` (if caps) | `1.5` | Wayfinding only |
137
+
138
+ ---
139
+
140
+ ## Anti-patterns
141
+
142
+ - **Bold display headline** — editorial display is usually light or regular.
143
+ Bold display reads as billboard advertising. If the design system's display
144
+ weight is heavy, either use the regular cut or revisit the choice.
145
+ - **Uniform section padding** — every section has the same gap. No pacing.
146
+ The page reads as a list of content blocks.
147
+ - **Pull quote styled as a callout box** — border-left, background tint,
148
+ or card treatment. A pull quote is typographic. It does not need a container.
149
+ - **Deck set at body size** — the gap between headline and deck must be large
150
+ enough to read as a scale event. 18 px minimum for a deck below a 56 px+
151
+ headline.
152
+ - **Heading for every section** — editorial long-form does not require
153
+ a heading at every content shift. Space and pacing are allowed to do the
154
+ work. (guidance)
155
+ - **Positive tracking on display** — wide-tracked display headlines read as
156
+ a branding exercise. Tighten them.
157
+ - **UI chrome in the reading column** — buttons, tags, chip badges interrupting
158
+ prose flow inside the body text column. Functional controls (inline code-copy,
159
+ API anchors, callout toggles) may live inside code and API blocks, but decorative
160
+ badges and UI chrome should live outside the reading measure to keep prose focus clear.
161
+
162
+ ---
163
+
164
+ ## Lint
165
+
166
+ - [ ] Display headline is light or regular weight unless the design system
167
+ specifies otherwise.
168
+ - [ ] Display tracking is within `-0.02em` to `-0.05em` at 56 px+ (Latin only;
169
+ 0 for Arabic/Persian/Urdu joining scripts; see `rtl-and-bidi` for Hebrew). (guidance)
170
+ - [ ] Pull-quote tracking: `-0.01em` (Latin only; 0 for joining scripts). (guidance)
171
+ - [ ] Gap between display and deck: display/deck ratio ≥ 1.5× or absolute px delta
172
+ ≥ 24 px to read as a scale event. (guidance)
173
+ - [ ] Body line height is `1.6`–`1.7`.
174
+ - [ ] Body measure is 60–70 ch.
175
+ - [ ] Pull quote, if present, breaks the body column (full width or offset).
176
+ - [ ] No more than 2 pull quotes in a single article surface. (long-form only)
177
+ - [ ] Section spacing alternates — one gap ≥ 1.5× baseline rhythm while another
178
+ is ≤ 1.2×. (long-form only — guidance)
179
+ - [ ] Bold used ≤ 2 times per 400 words in body copy. (long-form only)
180
+ - [ ] `var(--accent)` used ≤ 2 times on the full editorial surface (see `color.md` §accent discipline).
181
+ - [ ] Section separators (rules, dingbats) are used only when they
182
+ reinforce publication identity or clearly mark unrelated-content boundaries;
183
+ they must not be used as a hierarchy fallback. (guidance)
184
+ - [ ] Pull quote has no background, border, or container treatment.
@@ -0,0 +1,167 @@
1
+ <!-- Vendored from nexu-io/open-design@78d5637cb49d (craft/typography-hierarchy.md), Apache-2.0, Copyright 2026 Open Design contributors. Modified by Pugi: this header line added; the text below is otherwise verbatim. Paths it names (apps/daemon/src/lint-artifact.ts, pnpm lint:craft, od.craft.requires) are upstream's, not Pugi's: the Pugi port of the linter is packages/opencode/src/session/design-lint.ts. See NOTICE.md in the skill root. -->
2
+
3
+ # Typography hierarchy craft rules
4
+
5
+ Shared hierarchy contracts that layer on top of `typography.md`. This file does
6
+ not repeat scale ranges or tracking values — those live in `typography.md`.
7
+ This file defines how hierarchy *behaves*: entry points, rhythm, tension, and
8
+ the conditions under which controlled violations are allowed. This contract
9
+ applies per-surface (a page with multiple pacing resets may establish new
10
+ primaries at intentional intervals), not globally.
11
+
12
+ > Opt in via `od.craft.requires: [typography, typography-hierarchy]`.
13
+ > Aesthetic-specific variants (e.g. `typography-hierarchy-editorial`) extend this.
14
+
15
+ ---
16
+
17
+ ## The core contract
18
+
19
+ Every typographic surface must satisfy all three:
20
+
21
+ 1. **One dominant entry point.** The eye needs a place to start. One element
22
+ wins the hierarchy — not two, not three. If everything competes, nothing leads.
23
+ 2. **Intentional rhythm between levels.** Hierarchy is not a list of sizes.
24
+ It is the *contrast* between them. Adjacent levels that are too close
25
+ in scale, weight, or spacing produce a flat, undifferentiated surface.
26
+ 3. **Recoverable information flow.** Hierarchy may be inverted, collapsed,
27
+ or disrupted — but a reader must still be able to reconstruct the content
28
+ structure without re-reading. If they can't, it's chaos, not tension.
29
+
30
+ ---
31
+
32
+ ## Hierarchy vectors
33
+
34
+ Scale is one lever. Use all five.
35
+
36
+ | Vector | What it controls | Hierarchy direction |
37
+ |---|---|---|
38
+ | Scale | Size contrast between levels | Large → small reads as primary → secondary |
39
+ | Weight | Mass contrast between levels | Heavier reads as primary (see Controlled violations for weight inversion) |
40
+ | Spacing | Breathing room around an element | More space = more visual importance |
41
+ | Tracking | Tension and velocity | Tighter = faster; wider = ceremonial, slower |
42
+ | Alignment | Relationship to the grid/edge | Breaking alignment signals importance |
43
+
44
+ No single vector is required. A heading may lead through spacing alone if
45
+ scale is deliberately suppressed. A pull quote may lead through alignment
46
+ break. Identify which vectors are active and make sure at least two are
47
+ working in the same direction for the dominant element.
48
+
49
+ ---
50
+
51
+ ## Semantic role ≠ visual role
52
+
53
+ Allowed. Not an error. Not a lint violation.
54
+
55
+ An `<h1>` may render visually quieter than a nearby `<p>` if the
56
+ composition requires it. Body copy may behave like display typography.
57
+ A label may visually outrank a heading.
58
+
59
+ **The condition:** information flow must remain intact. A user who reads
60
+ linearly must still understand what is important, what supports it, and
61
+ what is incidental — regardless of which element "wins" visually.
62
+
63
+ ---
64
+
65
+ ## Hierarchy rhythm — the two failure modes
66
+
67
+ ### Flat hierarchy
68
+
69
+ Everything lands at roughly the same visual weight. The surface reads as
70
+ a wall. Usually caused by:
71
+ - Scale steps that are too close (e.g. 18 / 20 / 22 px for three levels)
72
+ - Weight used only once (everything is regular, or everything is medium)
73
+ - Uniform spacing between all elements
74
+
75
+ Fix: increase contrast between levels. Use at least two vectors simultaneously.
76
+
77
+ ### Noise hierarchy
78
+
79
+ Too many elements fighting for dominance. Everything is bold, large, or
80
+ accented. The eye has no resting point and no path.
81
+
82
+ Fix: promote one element deliberately. Demote everything else — including
83
+ things that feel important. Hierarchy is relative, not absolute.
84
+
85
+ ---
86
+
87
+ ## Controlled violations
88
+
89
+ The following are explicitly allowed when the three core contracts are met:
90
+
91
+ | Violation | Allowed when |
92
+ |---|---|
93
+ | Body copy at display scale | It is the intended entry point and nothing else competes |
94
+ | Heading rendered lighter than body | Intentional visual inversion with intact information flow |
95
+ | Zero scale contrast between levels | Hierarchy is carried entirely by spacing or tracking |
96
+ | No heading-level element visible | Hierarchy is emergent from layout/spacing alone |
97
+ | Primary-level spacing applied to secondary element | Creates deliberate tension while maintaining information flow |
98
+
99
+ **"Information flow remains intact" safeguards:**
100
+ - DOM/reading order still matches content meaning (no layout inversion breaks narrative)
101
+ - Proximity groups the inverted element with its parent/context
102
+ - Only one primary exists in the visual region (no competing co-primaries)
103
+ - A quick scan can identify entry point / support / incidental roles without rereading
104
+
105
+ ---
106
+
107
+ ## Spacing as hierarchy
108
+
109
+ Spacing is a full hierarchy vector. A typographic level can be elevated
110
+ entirely through surrounding whitespace without changing its size or weight.
111
+
112
+ Rules:
113
+ - Space above an element signals its relationship to what came before.
114
+ - Space below an element signals its relationship to what follows.
115
+ - An isolated element with large surrounding space reads as display-level
116
+ regardless of its font size.
117
+ - Uniform spacing between all elements destroys spatial hierarchy.
118
+
119
+ ---
120
+
121
+ ## Three-level working model
122
+
123
+ Most surfaces can be mapped to three functional levels:
124
+
125
+ | Level | Role | Typical vectors |
126
+ |---|---|---|
127
+ | **Primary** | Entry point. One at a time per visual region; long-form surfaces may re-establish at intentional pacing resets. | Scale, spacing, or alignment break |
128
+ | **Secondary** | Structure. Subdivides or supports primary. | Weight, scale step, or tracking shift |
129
+ | **Tertiary** | Incidental. Labels, captions, metadata. | Scale reduction, weight reduction, or positive tracking |
130
+
131
+ More than three visible levels above the fold is usually a composition problem,
132
+ not a hierarchy opportunity. Collapse or demote before adding a fourth level.
133
+
134
+ **Long-form surfaces:** May re-establish a primary at intentional pacing resets
135
+ (e.g. a new section with its own headline and breathing room). Never maintain
136
+ two simultaneous primaries within the same visual region.
137
+
138
+ ---
139
+
140
+ ## Anti-patterns
141
+
142
+ - **Graduated weight ladder** — regular → medium → semibold → bold → extrabold,
143
+ each level one step heavier. Reads as a default scale, not authored hierarchy.
144
+ Weight should jump, not step.
145
+ - **Uniform section spacing** — every section gap is the same value. No
146
+ hierarchy information is carried by spacing. Vary it deliberately.
147
+ - **Heading as the only hierarchy vector** — the heading is large and bold;
148
+ everything else is flat. The heading does all the work. This is a sign
149
+ that spacing and tracking are not being used as vectors.
150
+ - **Symmetrical emphasis** — two elements receive equal visual weight as
151
+ co-primaries. Pick one. The other becomes secondary.
152
+ - **Size-only hierarchy** — all contrast is in font size alone. Weight,
153
+ spacing, tracking, and alignment are uniform across levels. Fragile —
154
+ any layout constraint that collapses the size contrast destroys the hierarchy.
155
+
156
+ ---
157
+
158
+ ## Lint
159
+
160
+ - [ ] One element is unambiguously dominant above the fold.
161
+ - [ ] At least two hierarchy vectors are active on the dominant element.
162
+ - [ ] No two adjacent levels share the same scale, weight, AND spacing.
163
+ - [ ] Spacing between levels varies — at least one gap is ≥1.5× the others or
164
+ represents one typographic scale step (e.g. one token unit like `gap-md` vs `gap-sm`). (guidance)
165
+ - [ ] Semantic/visual role inversions remain structurally readable.
166
+ - [ ] Flat hierarchy: scale steps between levels are ≥1.25× apart OR compensated by a weight or spacing jump. (guidance)
167
+ - [ ] Noise hierarchy: no more than one element reads as primary above the fold.
@@ -0,0 +1,124 @@
1
+ <!-- Vendored from nexu-io/open-design@78d5637cb49d (craft/typography.md), Apache-2.0, Copyright 2026 Open Design contributors. Modified by Pugi: this header line added; the text below is otherwise verbatim. Paths it names (apps/daemon/src/lint-artifact.ts, pnpm lint:craft, od.craft.requires) are upstream's, not Pugi's: the Pugi port of the linter is packages/opencode/src/session/design-lint.ts. See NOTICE.md in the skill root. -->
2
+
3
+ # Typography craft rules
4
+
5
+ Universal typography rules that apply on top of any `DESIGN.md`. The
6
+ active design system decides *which* fonts; this file decides *how* they
7
+ behave at every size.
8
+
9
+ > Adapted from [refero_skill](https://github.com/referodesign/refero_skill)
10
+ > (MIT) — distilled and re-tuned for OpenDesign's token system.
11
+
12
+ ## Type scale
13
+
14
+ Use a multiplicative scale (1.2 or 1.25). Cap at 6–8 sizes per artifact.
15
+
16
+ | Role | Range |
17
+ |---|---|
18
+ | Display | 48–72 px |
19
+ | H1 | 32–48 px |
20
+ | H2 | 24–32 px |
21
+ | H3 | 20–24 px |
22
+ | Body | 15–18 px |
23
+ | Small | 13–14 px |
24
+ | Caption | 11–12 px |
25
+
26
+ ## Line height (leading)
27
+
28
+ | Text size | Line height |
29
+ |---|---|
30
+ | Display / H1 (≥32 px) | `1.0`–`1.2` (tight) |
31
+ | Body (15–18 px) | `1.5`–`1.6` |
32
+ | Small (≤14 px) | `1.5` |
33
+
34
+ ### CJK overrides — these are not optional
35
+
36
+ The table above is Latin leading. Latin display type can go to `1.0`
37
+ because the ascender/descender slack inside the em box keeps lines
38
+ apart. **CJK glyphs fill the em box**, so the same value makes
39
+ consecutive lines touch, and multi-line Chinese headlines visibly
40
+ collide.
41
+
42
+ | Text size | Latin | CJK |
43
+ |---|---|---|
44
+ | Display / H1 (≥32 px) | `1.0`–`1.2` | **`1.3`–`1.4`** |
45
+ | Body (15–18 px) | `1.5`–`1.6` | `1.7`–`1.8` |
46
+
47
+ The CJK floor has **no upper size tier**. It applies to every heading
48
+ level, including the **cover / hero main title** — the single biggest
49
+ headline on a deck's first slide. A Chinese cover title at 72 px,
50
+ 96 px, or larger, especially one split into multiple lines with
51
+ `<br>`, is still CJK display text: set `line-height: 1.3`–`1.4` on
52
+ it, never the Latin `1.0`–`1.2`. At 96 px a `1.05` leading makes the
53
+ two lines of a Chinese cover headline visibly collide. This is the
54
+ single most common violation, so check the cover main title first.
55
+
56
+ Negative tracking is Latin-only for the same reason: CJK is already
57
+ set on a fixed em grid, so `-0.02em` on a Chinese headline crowds the
58
+ glyphs instead of tightening the word. Use `0` for CJK display text.
59
+
60
+ When one artifact mixes both — an English kicker over a Chinese
61
+ headline is the common case — set the tight Latin values on the Latin
62
+ element only. Do not inherit them onto the CJK block from a shared
63
+ parent rule.
64
+
65
+ ## Letter-spacing — the rule that makes or breaks craft
66
+
67
+ This is the single most-skipped rule in AI-generated design. **No
68
+ exceptions.**
69
+
70
+ | Context | Letter-spacing |
71
+ |---|---|
72
+ | Body text (14–18 px) | `0` (default) |
73
+ | Small text (11–13 px) | `0.01em` to `0.02em` (positive) |
74
+ | UI labels and button text | `0.02em` |
75
+ | **ALL CAPS** | **`0.06em` to `0.1em` (required)** |
76
+ | Headings 32 px+ | `-0.01em` to `-0.02em` |
77
+ | Display 48 px+ | `-0.02em` to `-0.03em` |
78
+
79
+ ALL CAPS without positive tracking looks cramped and amateur. Display
80
+ text without negative tracking looks loose and weak. These two failures
81
+ are the most reliable AI-slop tells.
82
+
83
+ The `0.06em` floor is not arbitrary: it is the empirical lower bound
84
+ that print and web typographers have converged on for uppercase
85
+ tracking (cf. Bringhurst's *Elements of Typographic Style* §3.2.7,
86
+ which recommends 5–10% of the em for caps; modern screen practice
87
+ rounds the lower end to 0.06em). Anything tighter and the counters
88
+ collide on screen; the upper bound `0.1em` keeps the word from
89
+ disintegrating into letters.
90
+
91
+ ## Font pairing
92
+
93
+ - Maximum 2 typefaces per artifact (display + body, or one variable face
94
+ used at multiple weights).
95
+ - Always declare a system fallback chain. If the active `DESIGN.md`
96
+ ships a webfont URL, the fallback must still produce a coherent look.
97
+ - Never set `font-family: system-ui` alone on a heading — that is the
98
+ textbook AI default; always pair it with an intentional first choice.
99
+
100
+ ## Line length
101
+
102
+ Limit body copy to **50–75 characters** per line. In CSS:
103
+ `max-width: 65ch` is a safe default.
104
+
105
+ ## Three-weight system
106
+
107
+ Most well-crafted UIs use exactly 3 weights:
108
+ - **Read** (400 / 450) — body copy
109
+ - **Emphasize** (510 / 550) — UI text, labels, navigation
110
+ - **Announce** (590 / 600) — headlines, buttons
111
+
112
+ Weight 700+ is rarely needed. If your design uses bold for "emphasis on
113
+ emphasis," it likely lacks weight discipline elsewhere.
114
+
115
+ ## Common mistakes (lint these)
116
+
117
+ - ALL CAPS without `letter-spacing` ≥ `0.06em`.
118
+ - Display text (≥32 px) without negative tracking (Latin only — see the CJK overrides).
119
+ - CJK display text at Latin leading (`≤1.2`), which makes the lines overlap.
120
+ - Multi-line CJK cover / hero titles (72–96 px+, e.g. split with `<br>`) below `1.3` line-height.
121
+ - Negative tracking applied to CJK text.
122
+ - More than 3 type sizes visible above the fold.
123
+ - Mixed serif and slab on the same screen without a clear role split.
124
+ - Body copy in `text-align: justify` (creates rivers; never use on the web).
@@ -0,0 +1,201 @@
1
+ Apache License
2
+ Version 2.0, January 2004
3
+ http://www.apache.org/licenses/
4
+
5
+ TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
6
+
7
+ 1. Definitions.
8
+
9
+ "License" shall mean the terms and conditions for use, reproduction,
10
+ and distribution as defined by Sections 1 through 9 of this document.
11
+
12
+ "Licensor" shall mean the copyright owner or entity authorized by
13
+ the copyright owner that is granting the License.
14
+
15
+ "Legal Entity" shall mean the union of the acting entity and all
16
+ other entities that control, are controlled by, or are under common
17
+ control with that entity. For the purposes of this definition,
18
+ "control" means (i) the power, direct or indirect, to cause the
19
+ direction or management of such entity, whether by contract or
20
+ otherwise, or (ii) ownership of fifty percent (50%) or more of the
21
+ outstanding shares, or (iii) beneficial ownership of such entity.
22
+
23
+ "You" (or "Your") shall mean an individual or Legal Entity
24
+ exercising permissions granted by this License.
25
+
26
+ "Source" form shall mean the preferred form for making modifications,
27
+ including but not limited to software source code, documentation
28
+ source, and configuration files.
29
+
30
+ "Object" form shall mean any form resulting from mechanical
31
+ transformation or translation of a Source form, including but
32
+ not limited to compiled object code, generated documentation,
33
+ and conversions to other media types.
34
+
35
+ "Work" shall mean the work of authorship, whether in Source or
36
+ Object form, made available under the License, as indicated by a
37
+ copyright notice that is included in or attached to the work
38
+ (an example is provided in the Appendix below).
39
+
40
+ "Derivative Works" shall mean any work, whether in Source or Object
41
+ form, that is based on (or derived from) the Work and for which the
42
+ editorial revisions, annotations, elaborations, or other modifications
43
+ represent, as a whole, an original work of authorship. For the purposes
44
+ of this License, Derivative Works shall not include works that remain
45
+ separable from, or merely link (or bind by name) to the interfaces of,
46
+ the Work and Derivative Works thereof.
47
+
48
+ "Contribution" shall mean any work of authorship, including
49
+ the original version of the Work and any modifications or additions
50
+ to that Work or Derivative Works thereof, that is intentionally
51
+ submitted to Licensor for inclusion in the Work by the copyright owner
52
+ or by an individual or Legal Entity authorized to submit on behalf of
53
+ the copyright owner. For the purposes of this definition, "submitted"
54
+ means any form of electronic, verbal, or written communication sent
55
+ to the Licensor or its representatives, including but not limited to
56
+ communication on electronic mailing lists, source code control systems,
57
+ and issue tracking systems that are managed by, or on behalf of, the
58
+ Licensor for the purpose of discussing and improving the Work, but
59
+ excluding communication that is conspicuously marked or otherwise
60
+ designated in writing by the copyright owner as "Not a Contribution."
61
+
62
+ "Contributor" shall mean Licensor and any individual or Legal Entity
63
+ on behalf of whom a Contribution has been received by Licensor and
64
+ subsequently incorporated within the Work.
65
+
66
+ 2. Grant of Copyright License. Subject to the terms and conditions of
67
+ this License, each Contributor hereby grants to You a perpetual,
68
+ worldwide, non-exclusive, no-charge, royalty-free, irrevocable
69
+ copyright license to reproduce, prepare Derivative Works of,
70
+ publicly display, publicly perform, sublicense, and distribute the
71
+ Work and such Derivative Works in Source or Object form.
72
+
73
+ 3. Grant of Patent License. Subject to the terms and conditions of
74
+ this License, each Contributor hereby grants to You a perpetual,
75
+ worldwide, non-exclusive, no-charge, royalty-free, irrevocable
76
+ (except as stated in this section) patent license to make, have made,
77
+ use, offer to sell, sell, import, and otherwise transfer the Work,
78
+ where such license applies only to those patent claims licensable
79
+ by such Contributor that are necessarily infringed by their
80
+ Contribution(s) alone or by combination of their Contribution(s)
81
+ with the Work to which such Contribution(s) was submitted. If You
82
+ institute patent litigation against any entity (including a
83
+ cross-claim or counterclaim in a lawsuit) alleging that the Work
84
+ or a Contribution incorporated within the Work constitutes direct
85
+ or contributory patent infringement, then any patent licenses
86
+ granted to You under this License for that Work shall terminate
87
+ as of the date such litigation is filed.
88
+
89
+ 4. Redistribution. You may reproduce and distribute copies of the
90
+ Work or Derivative Works thereof in any medium, with or without
91
+ modifications, and in Source or Object form, provided that You
92
+ meet the following conditions:
93
+
94
+ (a) You must give any other recipients of the Work or
95
+ Derivative Works a copy of this License; and
96
+
97
+ (b) You must cause any modified files to carry prominent notices
98
+ stating that You changed the files; and
99
+
100
+ (c) You must retain, in the Source form of any Derivative Works
101
+ that You distribute, all copyright, patent, trademark, and
102
+ attribution notices from the Source form of the Work,
103
+ excluding those notices that do not pertain to any part of
104
+ the Derivative Works; and
105
+
106
+ (d) If the Work includes a "NOTICE" text file as part of its
107
+ distribution, then any Derivative Works that You distribute must
108
+ include a readable copy of the attribution notices contained
109
+ within such NOTICE file, excluding those notices that do not
110
+ pertain to any part of the Derivative Works, in at least one
111
+ of the following places: within a NOTICE text file distributed
112
+ as part of the Derivative Works; within the Source form or
113
+ documentation, if provided along with the Derivative Works; or,
114
+ within a display generated by the Derivative Works, if and
115
+ wherever such third-party notices normally appear. The contents
116
+ of the NOTICE file are for informational purposes only and
117
+ do not modify the License. You may add Your own attribution
118
+ notices within Derivative Works that You distribute, alongside
119
+ or as an addendum to the NOTICE text from the Work, provided
120
+ that such additional attribution notices cannot be construed
121
+ as modifying the License.
122
+
123
+ You may add Your own copyright statement to Your modifications and
124
+ may provide additional or different license terms and conditions
125
+ for use, reproduction, or distribution of Your modifications, or
126
+ for any such Derivative Works as a whole, provided Your use,
127
+ reproduction, and distribution of the Work otherwise complies with
128
+ the conditions stated in this License.
129
+
130
+ 5. Submission of Contributions. Unless You explicitly state otherwise,
131
+ any Contribution intentionally submitted for inclusion in the Work
132
+ by You to the Licensor shall be under the terms and conditions of
133
+ this License, without any additional terms or conditions.
134
+ Notwithstanding the above, nothing herein shall supersede or modify
135
+ the terms of any separate license agreement you may have executed
136
+ with Licensor regarding such Contributions.
137
+
138
+ 6. Trademarks. This License does not grant permission to use the trade
139
+ names, trademarks, service marks, or product names of the Licensor,
140
+ except as required for describing the origin of the Work and
141
+ reproducing the content of the NOTICE file.
142
+
143
+ 7. Disclaimer of Warranty. Unless required by applicable law or
144
+ agreed to in writing, Licensor provides the Work (and each
145
+ Contributor provides its Contributions) on an "AS IS" BASIS,
146
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
147
+ implied, including, without limitation, any warranties or conditions
148
+ of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
149
+ PARTICULAR PURPOSE. You are solely responsible for determining the
150
+ appropriateness of using or redistributing the Work and assume any
151
+ risks associated with Your exercise of permissions under this License.
152
+
153
+ 8. Limitation of Liability. In no event and under no legal theory,
154
+ whether in tort (including negligence), contract, or otherwise,
155
+ unless required by applicable law (such as deliberate and grossly
156
+ negligent acts) or agreed to in writing, shall any Contributor be
157
+ liable to You for damages, including any direct, indirect, special,
158
+ incidental, or consequential damages of any character arising as a
159
+ result of this License or out of the use or inability to use the
160
+ Work (including but not limited to damages for loss of goodwill,
161
+ work stoppage, computer failure or malfunction, or any and all
162
+ other commercial damages or losses), even if such Contributor
163
+ has been advised of the possibility of such damages.
164
+
165
+ 9. Accepting Warranty or Support. While redistributing the Work or
166
+ Derivative Works thereof, You may choose to offer, and charge a
167
+ fee for, acceptance of support, warranty, indemnity, or other
168
+ liability obligations and/or rights consistent with this License.
169
+ However, in accepting such obligations, You may act only on Your
170
+ own behalf and on Your sole responsibility, not on behalf of any
171
+ other Contributor, and only if You agree to indemnify, defend,
172
+ and hold each Contributor harmless for any liability incurred by,
173
+ or claims asserted against, such Contributor by reason of your
174
+ accepting any such warranty or support.
175
+
176
+ END OF TERMS AND CONDITIONS
177
+
178
+ APPENDIX: How to apply the Apache License to your work.
179
+
180
+ To apply the Apache License to your work, attach the following
181
+ boilerplate notice, with the fields enclosed by brackets "[]"
182
+ replaced with your own identifying information. (Don't include
183
+ the brackets!) The text should be enclosed in the appropriate
184
+ comment syntax for the file format. We also recommend that a
185
+ file or class name and description of purpose be included on the
186
+ same "printed page" as the copyright notice for easier
187
+ identification within third-party archives.
188
+
189
+ Copyright 2026 Open Design contributors
190
+
191
+ Licensed under the Apache License, Version 2.0 (the "License");
192
+ you may not use this file except in compliance with the License.
193
+ You may obtain a copy of the License at
194
+
195
+ http://www.apache.org/licenses/LICENSE-2.0
196
+
197
+ Unless required by applicable law or agreed to in writing, software
198
+ distributed under the License is distributed on an "AS IS" BASIS,
199
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
200
+ See the License for the specific language governing permissions and
201
+ limitations under the License.