@pugi/cli 1.0.0-alpha.25 → 1.0.0-alpha.250
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/README.md +1 -1
- package/THIRD_PARTY_NOTICES.md +39 -0
- package/bin/pugi +19 -5
- package/models.json +1 -0
- package/package.json +22 -6
- package/release.json +8 -0
- package/skills/a11y/SKILL.md +27 -0
- package/skills/ab-test-analysis/SKILL.md +15 -0
- package/skills/ai-sdk/SKILL.md +27 -0
- package/skills/api-integration/SKILL.md +27 -0
- package/skills/architecture-review/SKILL.md +19 -0
- package/skills/brand-voice/SKILL.md +27 -0
- package/skills/ci-cd-pipeline/SKILL.md +15 -0
- package/skills/code-review/SKILL.md +27 -0
- package/skills/competitor-analysis/SKILL.md +27 -0
- package/skills/content-design/SKILL.md +35 -0
- package/skills/css-tailwind/SKILL.md +39 -0
- package/skills/css-tailwind/quirks.md +86 -0
- package/skills/db-vector/SKILL.md +27 -0
- package/skills/design-radix/SKILL.md +35 -0
- package/skills/design-system/SKILL.md +35 -0
- package/skills/detecting-data-anomalies/SKILL.md +15 -0
- package/skills/docker-deploy/SKILL.md +15 -0
- package/skills/edge-case-finder/SKILL.md +27 -0
- package/skills/fonts/SKILL.md +34 -0
- package/skills/framework-grammy/SKILL.md +27 -0
- package/skills/framework-mastra/SKILL.md +27 -0
- package/skills/framework-nestjs/SKILL.md +27 -0
- package/skills/framework-prisma/SKILL.md +27 -0
- package/skills/funnel-optimization/SKILL.md +19 -0
- package/skills/ha-prototype-web/LICENSE-APACHE-2.0 +201 -0
- package/skills/ha-prototype-web/NOTICE.md +126 -0
- package/skills/ha-prototype-web/SKILL.md +25 -0
- package/skills/icons/SKILL.md +34 -0
- package/skills/landing-templates/SKILL.md +35 -0
- package/skills/market-research/SKILL.md +27 -0
- package/skills/metrics-dashboard/SKILL.md +19 -0
- package/skills/monitoring-setup/SKILL.md +15 -0
- package/skills/motion/SKILL.md +27 -0
- package/skills/nestjs-api/SKILL.md +38 -0
- package/skills/nestjs-api/quirks.md +36 -0
- package/skills/nextjs-page/SKILL.md +27 -0
- package/skills/od-blog-post/LICENSE-APACHE-2.0 +201 -0
- package/skills/od-blog-post/NOTICE.md +126 -0
- package/skills/od-blog-post/SKILL.md +81 -0
- package/skills/od-contact-widget/LICENSE-APACHE-2.0 +201 -0
- package/skills/od-contact-widget/NOTICE.md +126 -0
- package/skills/od-contact-widget/SKILL.md +132 -0
- package/skills/od-craft/LICENSE-APACHE-2.0 +201 -0
- package/skills/od-craft/NOTICE.md +126 -0
- package/skills/od-craft/SKILL.md +58 -0
- package/skills/od-craft/references/README.md +108 -0
- package/skills/od-craft/references/accessibility-baseline.md +203 -0
- package/skills/od-craft/references/animation-discipline.md +156 -0
- package/skills/od-craft/references/anti-ai-slop.md +86 -0
- package/skills/od-craft/references/color.md +90 -0
- package/skills/od-craft/references/form-validation.md +223 -0
- package/skills/od-craft/references/laws-of-ux.md +298 -0
- package/skills/od-craft/references/rtl-and-bidi.md +188 -0
- package/skills/od-craft/references/state-coverage.md +136 -0
- package/skills/od-craft/references/typography-hierarchy-editorial.md +184 -0
- package/skills/od-craft/references/typography-hierarchy.md +167 -0
- package/skills/od-craft/references/typography.md +124 -0
- package/skills/od-critique/LICENSE-APACHE-2.0 +201 -0
- package/skills/od-critique/NOTICE.md +126 -0
- package/skills/od-critique/SKILL.md +259 -0
- package/skills/od-dashboard/LICENSE-APACHE-2.0 +201 -0
- package/skills/od-dashboard/NOTICE.md +126 -0
- package/skills/od-dashboard/SKILL.md +77 -0
- package/skills/od-design-brief/LICENSE-APACHE-2.0 +201 -0
- package/skills/od-design-brief/NOTICE.md +126 -0
- package/skills/od-design-brief/SKILL.md +260 -0
- package/skills/od-docs-page/LICENSE-APACHE-2.0 +201 -0
- package/skills/od-docs-page/NOTICE.md +126 -0
- package/skills/od-docs-page/SKILL.md +81 -0
- package/skills/od-email-marketing/LICENSE-APACHE-2.0 +201 -0
- package/skills/od-email-marketing/NOTICE.md +126 -0
- package/skills/od-email-marketing/SKILL.md +85 -0
- package/skills/od-eng-runbook/LICENSE-APACHE-2.0 +201 -0
- package/skills/od-eng-runbook/NOTICE.md +126 -0
- package/skills/od-eng-runbook/SKILL.md +52 -0
- package/skills/od-faq-page/LICENSE-APACHE-2.0 +201 -0
- package/skills/od-faq-page/NOTICE.md +126 -0
- package/skills/od-faq-page/SKILL.md +113 -0
- package/skills/od-finance-report/LICENSE-APACHE-2.0 +201 -0
- package/skills/od-finance-report/NOTICE.md +126 -0
- package/skills/od-finance-report/SKILL.md +62 -0
- package/skills/od-frontend-design/LICENSE-APACHE-2.0 +201 -0
- package/skills/od-frontend-design/LICENSE.txt +177 -0
- package/skills/od-frontend-design/NOTICE.md +126 -0
- package/skills/od-frontend-design/SKILL.md +86 -0
- package/skills/od-hr-onboarding/LICENSE-APACHE-2.0 +201 -0
- package/skills/od-hr-onboarding/NOTICE.md +126 -0
- package/skills/od-hr-onboarding/SKILL.md +53 -0
- package/skills/od-invoice/LICENSE-APACHE-2.0 +201 -0
- package/skills/od-invoice/NOTICE.md +126 -0
- package/skills/od-invoice/SKILL.md +49 -0
- package/skills/od-kanban-board/LICENSE-APACHE-2.0 +201 -0
- package/skills/od-kanban-board/NOTICE.md +126 -0
- package/skills/od-kanban-board/SKILL.md +51 -0
- package/skills/od-login-flow/LICENSE-APACHE-2.0 +201 -0
- package/skills/od-login-flow/NOTICE.md +126 -0
- package/skills/od-login-flow/SKILL.md +49 -0
- package/skills/od-login-flow/references/checklist.md +19 -0
- package/skills/od-magazine-poster/LICENSE-APACHE-2.0 +201 -0
- package/skills/od-magazine-poster/NOTICE.md +126 -0
- package/skills/od-magazine-poster/SKILL.md +90 -0
- package/skills/od-meeting-notes/LICENSE-APACHE-2.0 +201 -0
- package/skills/od-meeting-notes/NOTICE.md +126 -0
- package/skills/od-meeting-notes/SKILL.md +48 -0
- package/skills/od-mobile-app/LICENSE-APACHE-2.0 +201 -0
- package/skills/od-mobile-app/NOTICE.md +126 -0
- package/skills/od-mobile-app/SKILL.md +103 -0
- package/skills/od-mobile-app/assets/template.html +442 -0
- package/skills/od-mobile-app/references/checklist.md +46 -0
- package/skills/od-mobile-app/references/layouts.md +312 -0
- package/skills/od-mobile-onboarding/LICENSE-APACHE-2.0 +201 -0
- package/skills/od-mobile-onboarding/NOTICE.md +126 -0
- package/skills/od-mobile-onboarding/SKILL.md +54 -0
- package/skills/od-pm-spec/LICENSE-APACHE-2.0 +201 -0
- package/skills/od-pm-spec/NOTICE.md +126 -0
- package/skills/od-pm-spec/SKILL.md +53 -0
- package/skills/od-pricing-page/LICENSE-APACHE-2.0 +201 -0
- package/skills/od-pricing-page/NOTICE.md +126 -0
- package/skills/od-pricing-page/SKILL.md +80 -0
- package/skills/od-redesign-skill/LICENSE +21 -0
- package/skills/od-redesign-skill/LICENSE-APACHE-2.0 +201 -0
- package/skills/od-redesign-skill/NOTICE.md +126 -0
- package/skills/od-redesign-skill/SKILL.md +205 -0
- package/skills/od-reference-design-contract/LICENSE-APACHE-2.0 +201 -0
- package/skills/od-reference-design-contract/NOTICE.md +126 -0
- package/skills/od-reference-design-contract/SKILL.md +131 -0
- package/skills/od-reference-design-contract/references/checklist.md +26 -0
- package/skills/od-saas-landing/LICENSE-APACHE-2.0 +201 -0
- package/skills/od-saas-landing/NOTICE.md +126 -0
- package/skills/od-saas-landing/SKILL.md +125 -0
- package/skills/od-social-carousel/LICENSE-APACHE-2.0 +201 -0
- package/skills/od-social-carousel/NOTICE.md +126 -0
- package/skills/od-social-carousel/SKILL.md +92 -0
- package/skills/od-team-okrs/LICENSE-APACHE-2.0 +201 -0
- package/skills/od-team-okrs/NOTICE.md +126 -0
- package/skills/od-team-okrs/SKILL.md +48 -0
- package/skills/od-waitlist-page/LICENSE-APACHE-2.0 +201 -0
- package/skills/od-waitlist-page/NOTICE.md +126 -0
- package/skills/od-waitlist-page/SKILL.md +229 -0
- package/skills/od-waitlist-page/assets/template.html +457 -0
- package/skills/od-waitlist-page/references/checklist.md +42 -0
- package/skills/od-web-design-guidelines/LICENSE +21 -0
- package/skills/od-web-design-guidelines/LICENSE-APACHE-2.0 +201 -0
- package/skills/od-web-design-guidelines/NOTICE.md +126 -0
- package/skills/od-web-design-guidelines/SKILL.md +66 -0
- package/skills/od-web-design-guidelines/references/guidelines.md +133 -0
- package/skills/od-web-prototype/LICENSE-APACHE-2.0 +201 -0
- package/skills/od-web-prototype/NOTICE.md +126 -0
- package/skills/od-web-prototype/SKILL.md +102 -0
- package/skills/od-web-prototype/assets/template.html +348 -0
- package/skills/od-web-prototype/references/checklist.md +47 -0
- package/skills/od-web-prototype/references/layouts.md +247 -0
- package/skills/od-web-prototype-taste-brutalist/LICENSE-APACHE-2.0 +201 -0
- package/skills/od-web-prototype-taste-brutalist/LICENSE-MIT-Leonxlnx +21 -0
- package/skills/od-web-prototype-taste-brutalist/NOTICE.md +126 -0
- package/skills/od-web-prototype-taste-brutalist/SKILL.md +64 -0
- package/skills/od-web-prototype-taste-editorial/LICENSE-APACHE-2.0 +201 -0
- package/skills/od-web-prototype-taste-editorial/LICENSE-MIT-Leonxlnx +21 -0
- package/skills/od-web-prototype-taste-editorial/NOTICE.md +126 -0
- package/skills/od-web-prototype-taste-editorial/SKILL.md +61 -0
- package/skills/od-web-prototype-taste-soft/LICENSE-APACHE-2.0 +201 -0
- package/skills/od-web-prototype-taste-soft/LICENSE-MIT-Leonxlnx +21 -0
- package/skills/od-web-prototype-taste-soft/NOTICE.md +126 -0
- package/skills/od-web-prototype-taste-soft/SKILL.md +64 -0
- package/skills/od-webgl-experience/LICENSE-APACHE-2.0 +201 -0
- package/skills/od-webgl-experience/NOTICE.md +126 -0
- package/skills/od-webgl-experience/SKILL.md +81 -0
- package/skills/od-wireframe-annotated/LICENSE-APACHE-2.0 +201 -0
- package/skills/od-wireframe-annotated/NOTICE.md +126 -0
- package/skills/od-wireframe-annotated/SKILL.md +90 -0
- package/skills/od-wireframe-greybox/LICENSE-APACHE-2.0 +201 -0
- package/skills/od-wireframe-greybox/NOTICE.md +126 -0
- package/skills/od-wireframe-greybox/SKILL.md +90 -0
- package/skills/od-wireframe-mobile-flow/LICENSE-APACHE-2.0 +201 -0
- package/skills/od-wireframe-mobile-flow/NOTICE.md +126 -0
- package/skills/od-wireframe-mobile-flow/SKILL.md +96 -0
- package/skills/od-wireframe-sketch/LICENSE-APACHE-2.0 +201 -0
- package/skills/od-wireframe-sketch/NOTICE.md +126 -0
- package/skills/od-wireframe-sketch/SKILL.md +98 -0
- package/skills/orchestrating-multi-agent-systems/SKILL.md +19 -0
- package/skills/preprocessing-data/SKILL.md +15 -0
- package/skills/project-memory-keeper/SKILL.md +19 -0
- package/skills/public-apis/SKILL.md +27 -0
- package/skills/pugi-patterns/SKILL.md +19 -0
- package/skills/react-component/SKILL.md +27 -0
- package/skills/sprint-planning/SKILL.md +19 -0
- package/skills/stack-selection/SKILL.md +15 -0
- package/skills/standup-summary/SKILL.md +15 -0
- package/skills/task-decomposition/SKILL.md +19 -0
- package/skills/team-routing/SKILL.md +15 -0
- package/skills/tech-survey/SKILL.md +15 -0
- package/skills/test-plan/SKILL.md +15 -0
- package/skills/typescript-refactor/SKILL.md +15 -0
- package/skills/ui-components/SKILL.md +35 -0
- package/skills/ux-patterns/SKILL.md +35 -0
- package/skills/web-platform/SKILL.md +27 -0
- package/skills/web-scrape/SKILL.md +27 -0
- package/skills/web-search/SKILL.md +15 -0
- package/skills/webapp-testing/SKILL.md +37 -0
- 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.
|