@adobe/design-data-spec 2.1.0 → 2.2.0
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/package.json +1 -1
- package/spec/taxonomy.md +10 -9
package/package.json
CHANGED
package/spec/taxonomy.md
CHANGED
|
@@ -104,15 +104,16 @@ Example: `colorFamily=blue` + `scaleIndex=100` → `blue-100`.
|
|
|
104
104
|
|
|
105
105
|
Typography tokens describe typeface attributes: family, weight, style, and numeric scale. Their name objects use `scope: "typography"` fields alongside the universal `property` field.
|
|
106
106
|
|
|
107
|
-
**NORMATIVE:** Typography tokens SHOULD include at least one of `family`, `weight`, or `
|
|
108
|
-
|
|
109
|
-
| Category | Name object field | Answers | Description
|
|
110
|
-
| --------- | ----------------- | ------- |
|
|
111
|
-
| Family | `family` | What? | Type family of the token (e.g. `sans-serif`, `serif`, `cjk`, `code`). Values come from [`typography-families.json`](../../packages/design-data/registry/typography-families.json).
|
|
112
|
-
| Weight | `weight` | How? | Typographic weight (e.g. `regular`, `bold`, `light`, `black`). Values come from [`typography-weights.json`](../../packages/design-data/registry/typography-weights.json).
|
|
113
|
-
| Style | `style` | How? | Typographic style (e.g. `italic`, `oblique`, `normal`). Include `normal` when the token explicitly declares a normal style (e.g. a reset). Values come from [`typography-styles.json`](../../packages/design-data/registry/typography-styles.json).
|
|
114
|
-
| Alignment | `alignment` | How? | Horizontal text-alignment direction (e.g. `start`, `center`, `end`). Corresponds to the CSS `text-align` axis. Values come from [`alignments.json`](../../packages/design-data/registry/alignments.json).
|
|
115
|
-
| Scale | `scaleIndex` | Which? | Numeric size scale step (e.g. `75`, `100`, `200`). Shared with other token types; not scope-restricted.
|
|
107
|
+
**NORMATIVE:** Typography tokens SHOULD include at least one of `family`, `weight`, `style`, `scaleIndex`, or `structure`. Tokens missing all five are flagged by rule SPEC-043 (`domain-required-fields`, warning). `family`, `weight`, and `style` are the primary identifiers; `scaleIndex` and `structure` satisfy the rule for scale-indexed and structural typography tokens respectively.
|
|
108
|
+
|
|
109
|
+
| Category | Name object field | Answers | Description |
|
|
110
|
+
| --------- | ----------------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
111
|
+
| Family | `family` | What? | Type family of the token (e.g. `sans-serif`, `serif`, `cjk`, `code`). Values come from [`typography-families.json`](../../packages/design-data/registry/typography-families.json). |
|
|
112
|
+
| Weight | `weight` | How? | Typographic weight (e.g. `regular`, `bold`, `light`, `black`). Values come from [`typography-weights.json`](../../packages/design-data/registry/typography-weights.json). |
|
|
113
|
+
| Style | `style` | How? | Typographic style (e.g. `italic`, `oblique`, `normal`). Include `normal` when the token explicitly declares a normal style (e.g. a reset). Values come from [`typography-styles.json`](../../packages/design-data/registry/typography-styles.json). |
|
|
114
|
+
| Alignment | `alignment` | How? | Horizontal text-alignment direction (e.g. `start`, `center`, `end`). Corresponds to the CSS `text-align` axis. Values come from [`alignments.json`](../../packages/design-data/registry/alignments.json). |
|
|
115
|
+
| Scale | `scaleIndex` | Which? | Numeric size scale step (e.g. `75`, `100`, `200`). Shared with other token types; not scope-restricted. |
|
|
116
|
+
| Structure | `structure` | Where? | Structural typography scale this token belongs to (e.g. `body`, `detail`, `heading`). Used for tokens that apply within a named typographic structure rather than a specific family/weight/style axis. Values come from [`structures.json`](../../packages/design-data/registry/structures.json). |
|
|
116
117
|
|
|
117
118
|
**Default serialization order for typography tokens:**
|
|
118
119
|
|