@adobe/design-system-registry 3.3.0 → 5.0.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.
Files changed (39) hide show
  1. package/CHANGELOG.md +18 -0
  2. package/index.js +39 -139
  3. package/moon.yml +2 -29
  4. package/package.json +5 -34
  5. package/AUTHORING.md +0 -290
  6. package/PLATFORM_EXTENSIONS.md +0 -315
  7. package/ava.config.js +0 -21
  8. package/registry/alignments.json +0 -22
  9. package/registry/anatomy-terms.json +0 -739
  10. package/registry/categories.json +0 -55
  11. package/registry/color-families.json +0 -177
  12. package/registry/components.json +0 -277
  13. package/registry/densities.json +0 -17
  14. package/registry/easing-curves.json +0 -42
  15. package/registry/glossary.json +0 -181
  16. package/registry/motion-roles.json +0 -32
  17. package/registry/navigation-terms.json +0 -241
  18. package/registry/orientations.json +0 -17
  19. package/registry/platform-extensions/ios-states.json +0 -59
  20. package/registry/platform-extensions/web-components-states.json +0 -58
  21. package/registry/platforms.json +0 -37
  22. package/registry/positions.json +0 -32
  23. package/registry/property-terms.json +0 -212
  24. package/registry/scale-values.json +0 -126
  25. package/registry/shapes.json +0 -12
  26. package/registry/sizes.json +0 -71
  27. package/registry/states.json +0 -184
  28. package/registry/structures.json +0 -57
  29. package/registry/substructures.json +0 -12
  30. package/registry/token-objects.json +0 -32
  31. package/registry/token-terminology.json +0 -925
  32. package/registry/typography-families.json +0 -27
  33. package/registry/typography-styles.json +0 -22
  34. package/registry/typography-weights.json +0 -37
  35. package/registry/variants.json +0 -282
  36. package/schemas/platform-extension.json +0 -79
  37. package/schemas/registry-value.json +0 -230
  38. package/scripts/validate-registry.js +0 -134
  39. package/test/registry.test.js +0 -417
@@ -1,925 +0,0 @@
1
- {
2
- "$schema": "https://opensource.adobe.com/spectrum-design-data/schemas/registry-value.json",
3
- "type": "token-term",
4
- "description": "Token-specific terminology for design token naming and structure",
5
- "values": [
6
- {
7
- "id": "component",
8
- "label": "Component",
9
- "description": "In token naming, refers to the UI component the token is designed for",
10
- "usedIn": ["tokens"],
11
- "definition": {
12
- "superordinate": "token name part",
13
- "description": "A segment in a design token name that specifies which UI component or element the token value is intended for",
14
- "essentialCharacteristics": [
15
- "Appears in token names like 'button-background-color' or 'component-edge-to-text'",
16
- "Helps scope tokens to specific UI elements",
17
- "May be generic ('component') or specific ('button', 'checkbox')",
18
- "Improves token discoverability and organization"
19
- ]
20
- },
21
- "terminology": {
22
- "conceptType": "term",
23
- "namingRationale": "Standard term in design token methodology for component-specific tokens"
24
- },
25
- "sources": [
26
- {
27
- "type": "wiki",
28
- "reference": "Spectrum Tokens Wiki - Terminology",
29
- "url": "https://wiki.corp.adobe.com/display/AdobeDesign/Spectrum+tokens",
30
- "date": "2025-01-12"
31
- }
32
- ],
33
- "governance": {
34
- "owner": "Spectrum Tokens Team",
35
- "reviewDate": "2025-01-12",
36
- "status": "approved"
37
- },
38
- "relatedTerms": ["object", "scale", "property"]
39
- },
40
- {
41
- "id": "object",
42
- "label": "Object",
43
- "description": "In token naming, refers to the specific part or element being styled",
44
- "usedIn": ["tokens"],
45
- "definition": {
46
- "superordinate": "token name part",
47
- "description": "A segment in a design token name that specifies what part of a component is being styled (text, icon, border, etc.)",
48
- "essentialCharacteristics": [
49
- "Appears in token names like 'component-edge-to-text' or 'button-background'",
50
- "Identifies the specific element receiving the design value",
51
- "Common objects include: text, icon, visual, control, border, background",
52
- "Helps create semantic, meaningful token names"
53
- ]
54
- },
55
- "terminology": {
56
- "conceptType": "term",
57
- "namingRationale": "Describes what is being styled or measured in a design token"
58
- },
59
- "sources": [
60
- {
61
- "type": "wiki",
62
- "reference": "Spectrum Tokens Wiki - Terminology",
63
- "url": "https://wiki.corp.adobe.com/display/AdobeDesign/Spectrum+tokens",
64
- "date": "2025-01-12"
65
- }
66
- ],
67
- "governance": {
68
- "owner": "Spectrum Tokens Team",
69
- "reviewDate": "2025-01-12",
70
- "status": "approved"
71
- },
72
- "relatedTerms": ["component", "property", "edge", "visual"]
73
- },
74
- {
75
- "id": "scale",
76
- "label": "Scale",
77
- "description": "In token naming, refers to the size or intensity level",
78
- "usedIn": ["tokens"],
79
- "definition": {
80
- "superordinate": "token name part",
81
- "description": "A segment in a design token name that indicates size, spacing, or intensity using numeric values (50, 75, 100, etc.) or t-shirt sizes (s, m, l, xl)",
82
- "essentialCharacteristics": [
83
- "Provides graduated steps for spacing, sizing, and other properties",
84
- "Common numeric scales: 50, 75, 100, 200, 300, 400, 500",
85
- "T-shirt sizes also used: xs, s, m, l, xl, xxl, xxxl",
86
- "Enables consistent scaling across the design system"
87
- ]
88
- },
89
- "terminology": {
90
- "conceptType": "term",
91
- "namingRationale": "Indicates relative size or intensity in a graduated system"
92
- },
93
- "sources": [
94
- {
95
- "type": "wiki",
96
- "reference": "Spectrum Tokens Wiki - Scale Values",
97
- "url": "https://wiki.corp.adobe.com/display/AdobeDesign/Spectrum+tokens",
98
- "date": "2025-01-12"
99
- }
100
- ],
101
- "governance": {
102
- "owner": "Spectrum Tokens Team",
103
- "reviewDate": "2025-01-12",
104
- "status": "approved"
105
- },
106
- "relatedTerms": ["component", "property"]
107
- },
108
- {
109
- "id": "property",
110
- "label": "Property",
111
- "description": "In token naming, refers to the CSS/style property being defined",
112
- "usedIn": ["tokens"],
113
- "definition": {
114
- "superordinate": "token name part",
115
- "description": "A segment in a design token name that specifies what CSS or style property the token value applies to (color, size, spacing, etc.)",
116
- "essentialCharacteristics": [
117
- "Appears at the end of token names like 'button-background-color' or 'component-height'",
118
- "Maps to CSS properties or style attributes",
119
- "Common properties: color, size, width, height, spacing, border-width",
120
- "Determines the type of value (color value, dimension, number, etc.)"
121
- ]
122
- },
123
- "terminology": {
124
- "conceptType": "term",
125
- "namingRationale": "Directly corresponds to CSS/style properties for clarity"
126
- },
127
- "sources": [
128
- {
129
- "type": "wiki",
130
- "reference": "Spectrum Tokens Wiki - Token Structure",
131
- "url": "https://wiki.corp.adobe.com/display/AdobeDesign/Spectrum+tokens",
132
- "date": "2025-01-12"
133
- }
134
- ],
135
- "governance": {
136
- "owner": "Spectrum Tokens Team",
137
- "reviewDate": "2025-01-12",
138
- "status": "approved"
139
- },
140
- "relatedTerms": ["component", "object"]
141
- },
142
- {
143
- "id": "edge",
144
- "label": "Edge",
145
- "description": "In token naming, refers to the outer boundary of a component",
146
- "usedIn": ["tokens", "anatomy"],
147
- "definition": {
148
- "superordinate": "spatial reference point",
149
- "description": "The outermost boundary of a component, used as a reference point for measuring spacing and layout",
150
- "essentialCharacteristics": [
151
- "Used in spacing tokens like 'component-edge-to-text'",
152
- "Refers to the component's bounding box",
153
- "Different from 'visual' which may be inset from the edge",
154
- "Critical for consistent component spacing"
155
- ]
156
- },
157
- "terminology": {
158
- "conceptType": "term",
159
- "namingRationale": "Objective spatial term that clearly indicates the component boundary"
160
- },
161
- "sources": [
162
- {
163
- "type": "wiki",
164
- "reference": "Spectrum Tokens Wiki - Terminology",
165
- "url": "https://wiki.corp.adobe.com/display/AdobeDesign/Spectrum+tokens",
166
- "date": "2025-01-12"
167
- }
168
- ],
169
- "governance": {
170
- "owner": "Spectrum Tokens Team",
171
- "reviewDate": "2025-01-12",
172
- "status": "approved"
173
- },
174
- "relatedTerms": ["visual", "component", "object"]
175
- },
176
- {
177
- "id": "visual",
178
- "label": "Visual",
179
- "description": "In token naming, refers to the visible graphic element of a component",
180
- "usedIn": ["tokens", "anatomy"],
181
- "definition": {
182
- "superordinate": "component part",
183
- "description": "The visible graphic element within a component, which may be inset from the component's edge",
184
- "essentialCharacteristics": [
185
- "Used in spacing tokens like 'component-edge-to-visual'",
186
- "Represents the visible content area",
187
- "May have padding or spacing between edge and visual",
188
- "Distinguishes between bounding box and visible content"
189
- ]
190
- },
191
- "terminology": {
192
- "conceptType": "term",
193
- "namingRationale": "Objective term describing the visible content area"
194
- },
195
- "sources": [
196
- {
197
- "type": "wiki",
198
- "reference": "Spectrum Tokens Wiki - Terminology",
199
- "url": "https://wiki.corp.adobe.com/display/AdobeDesign/Spectrum+tokens",
200
- "date": "2025-01-12"
201
- }
202
- ],
203
- "governance": {
204
- "owner": "Spectrum Tokens Team",
205
- "reviewDate": "2025-01-12",
206
- "status": "approved"
207
- },
208
- "relatedTerms": ["edge", "component", "object"]
209
- },
210
- {
211
- "id": "structure",
212
- "label": "Structure",
213
- "description": "A reusable visual pattern or object category with shared styling that occurs across multiple component types",
214
- "usedIn": ["tokens", "taxonomy"],
215
- "definition": {
216
- "superordinate": "token taxonomy category",
217
- "description": "An individual object or object category with shared styling that represents visual patterns occurring across many component varieties, distinct from components which represent specific UI elements",
218
- "essentialCharacteristics": [
219
- "Represents visual patterns that occur across multiple components",
220
- "Distinct from components—describes structural patterns, not specific UI elements",
221
- "Maintains shared, consistent styling",
222
- "Can be combined and composed to create components"
223
- ]
224
- },
225
- "terminology": {
226
- "conceptType": "term",
227
- "namingRationale": "Describes reusable visual patterns that form the building blocks of components"
228
- },
229
- "sources": [
230
- {
231
- "type": "internal-doc",
232
- "reference": "Spectrum Token Taxonomy",
233
- "url": "https://www.dropbox.com/scl/fi/298zpbuvernq00219t6jf/Spectrum-Token-Taxonomies-Documentation-Draft.paper?rlkey=a9ov0sfe0yizifehxjg2zs1l8&dl=0",
234
- "date": "2026-01-29"
235
- }
236
- ],
237
- "governance": {
238
- "owner": "Spectrum Tokens Team",
239
- "reviewDate": "2026-01-29",
240
- "status": "review"
241
- },
242
- "relatedTerms": [
243
- "substructure",
244
- "base",
245
- "list",
246
- "table",
247
- "container",
248
- "group",
249
- "drop-target",
250
- "focus-ring",
251
- "accessory",
252
- "banner",
253
- "text"
254
- ]
255
- },
256
- {
257
- "id": "base",
258
- "label": "Base",
259
- "description": "Basic UI elements and visual structures combined to create proportionally sized content or components",
260
- "usedIn": ["tokens", "taxonomy"],
261
- "definition": {
262
- "superordinate": "structure",
263
- "description": "The foundational UI elements and visual structures that are combined and arranged to create proportionally relative sized content or components",
264
- "essentialCharacteristics": [
265
- "Foundation for basic components like Button and Textfield",
266
- "Used for inner structures of complex components such as List Item and Tree View Item",
267
- "Represents common pairing and compositional choices for recurring basic UI elements",
268
- "Creates proportionally relative sized content"
269
- ]
270
- },
271
- "terminology": {
272
- "conceptType": "term",
273
- "namingRationale": "Indicates the foundational nature of these structural elements"
274
- },
275
- "sources": [
276
- {
277
- "type": "internal-doc",
278
- "reference": "Spectrum Token Taxonomy",
279
- "url": "https://www.dropbox.com/scl/fi/298zpbuvernq00219t6jf/Spectrum-Token-Taxonomies-Documentation-Draft.paper?rlkey=a9ov0sfe0yizifehxjg2zs1l8&dl=0",
280
- "date": "2026-01-29"
281
- }
282
- ],
283
- "governance": {
284
- "owner": "Spectrum Tokens Team",
285
- "reviewDate": "2026-01-29",
286
- "status": "review"
287
- },
288
- "relatedTerms": ["structure", "list", "accessory"]
289
- },
290
- {
291
- "id": "list",
292
- "label": "List",
293
- "description": "A vertically or horizontally oriented collection of items with varying complexity",
294
- "usedIn": ["tokens", "taxonomy"],
295
- "definition": {
296
- "superordinate": "structure",
297
- "description": "A collection of items arranged vertically or horizontally, where items can range from simple to complex and are composed of one or more base structures",
298
- "essentialCharacteristics": [
299
- "Contains items ranging from simple (Radio) to complex (List view, Tabs, Menu)",
300
- "Items composed of one or more base structures in horizontal arrangement",
301
- "Items arranged vertically or horizontally into the list",
302
- "Supports varying degrees of item complexity"
303
- ]
304
- },
305
- "terminology": {
306
- "conceptType": "term",
307
- "namingRationale": "Standard term for collections of items in UI design"
308
- },
309
- "sources": [
310
- {
311
- "type": "internal-doc",
312
- "reference": "Spectrum Token Taxonomy",
313
- "url": "https://www.dropbox.com/scl/fi/298zpbuvernq00219t6jf/Spectrum-Token-Taxonomies-Documentation-Draft.paper?rlkey=a9ov0sfe0yizifehxjg2zs1l8&dl=0",
314
- "date": "2026-01-29"
315
- }
316
- ],
317
- "governance": {
318
- "owner": "Spectrum Tokens Team",
319
- "reviewDate": "2026-01-29",
320
- "status": "review"
321
- },
322
- "relatedTerms": ["structure", "base", "item", "table"]
323
- },
324
- {
325
- "id": "table",
326
- "label": "Table",
327
- "description": "A grid structure arranging columns and rows of content",
328
- "usedIn": ["tokens", "taxonomy"],
329
- "definition": {
330
- "superordinate": "structure",
331
- "description": "A grid-based structure that arranges content into intersecting columns and rows",
332
- "essentialCharacteristics": [
333
- "Arranges content in columns and rows",
334
- "Provides grid-based layout structure",
335
- "Used for tabular data presentation"
336
- ]
337
- },
338
- "terminology": {
339
- "conceptType": "term",
340
- "namingRationale": "Standard term for grid-based data structures in UI design"
341
- },
342
- "sources": [
343
- {
344
- "type": "internal-doc",
345
- "reference": "Spectrum Token Taxonomy",
346
- "url": "https://www.dropbox.com/scl/fi/298zpbuvernq00219t6jf/Spectrum-Token-Taxonomies-Documentation-Draft.paper?rlkey=a9ov0sfe0yizifehxjg2zs1l8&dl=0",
347
- "date": "2026-01-29"
348
- }
349
- ],
350
- "governance": {
351
- "owner": "Spectrum Tokens Team",
352
- "reviewDate": "2026-01-29",
353
- "status": "review"
354
- },
355
- "relatedTerms": ["structure", "list", "item"]
356
- },
357
- {
358
- "id": "container",
359
- "label": "Container",
360
- "description": "A visible or invisible structure that houses custom content and components with consistent styling",
361
- "usedIn": ["tokens", "taxonomy"],
362
- "definition": {
363
- "superordinate": "structure",
364
- "description": "A structure that houses custom content and components with consistent styling, which may be visible or invisible depending on use",
365
- "essentialCharacteristics": [
366
- "Can be visible or invisible",
367
- "Houses custom content and components with consistent styling",
368
- "Used in components like Popovers, Cards, and Select Boxes",
369
- "Can provide spacing without visible styling (e.g., padding around side navigation)"
370
- ]
371
- },
372
- "terminology": {
373
- "conceptType": "term",
374
- "namingRationale": "Describes the containing nature of this structural element"
375
- },
376
- "sources": [
377
- {
378
- "type": "internal-doc",
379
- "reference": "Spectrum Token Taxonomy",
380
- "url": "https://www.dropbox.com/scl/fi/298zpbuvernq00219t6jf/Spectrum-Token-Taxonomies-Documentation-Draft.paper?rlkey=a9ov0sfe0yizifehxjg2zs1l8&dl=0",
381
- "date": "2026-01-29"
382
- }
383
- ],
384
- "governance": {
385
- "owner": "Spectrum Tokens Team",
386
- "reviewDate": "2026-01-29",
387
- "status": "review"
388
- },
389
- "relatedTerms": ["structure", "base"]
390
- },
391
- {
392
- "id": "group",
393
- "label": "Group",
394
- "description": "A collection of similar or related UI elements, inputs, or actions grouped together",
395
- "usedIn": ["tokens", "taxonomy"],
396
- "definition": {
397
- "superordinate": "structure",
398
- "description": "A collection of similar or closely related UI elements, inputs, or actions that are grouped together to form a cohesive functional unit",
399
- "essentialCharacteristics": [
400
- "Groups similar or related elements together for cohesive interaction",
401
- "Used in components like Button Group, Action Group, and Checkbox Group",
402
- "Creates visual and functional unity among related items",
403
- "Provides consistent spacing and alignment between grouped elements"
404
- ]
405
- },
406
- "terminology": {
407
- "conceptType": "term",
408
- "namingRationale": "Describes the grouping nature of this structural pattern"
409
- },
410
- "sources": [
411
- {
412
- "type": "internal-doc",
413
- "reference": "Spectrum Token Taxonomy",
414
- "url": "https://www.dropbox.com/scl/fi/298zpbuvernq00219t6jf/Spectrum-Token-Taxonomies-Documentation-Draft.paper?rlkey=a9ov0sfe0yizifehxjg2zs1l8&dl=0",
415
- "date": "2026-01-29"
416
- }
417
- ],
418
- "governance": {
419
- "owner": "Spectrum Tokens Team",
420
- "reviewDate": "2026-01-29",
421
- "status": "review"
422
- },
423
- "relatedTerms": ["structure", "base", "list"]
424
- },
425
- {
426
- "id": "drop-target",
427
- "label": "Drop Target",
428
- "description": "Visual indication of a UI region that can accept drop operations",
429
- "usedIn": ["tokens", "taxonomy"],
430
- "definition": {
431
- "superordinate": "structure",
432
- "description": "A consistently styled visual indication of a region within the UI that can accept drop operations during drag-and-drop interactions",
433
- "essentialCharacteristics": [
434
- "Indicates regions that accept drop operations",
435
- "Styled consistently across the design system",
436
- "Provides visual feedback during drag-and-drop interactions"
437
- ]
438
- },
439
- "terminology": {
440
- "conceptType": "term",
441
- "namingRationale": "Describes the functional purpose of this visual indicator"
442
- },
443
- "sources": [
444
- {
445
- "type": "internal-doc",
446
- "reference": "Spectrum Token Taxonomy",
447
- "url": "https://www.dropbox.com/scl/fi/298zpbuvernq00219t6jf/Spectrum-Token-Taxonomies-Documentation-Draft.paper?rlkey=a9ov0sfe0yizifehxjg2zs1l8&dl=0",
448
- "date": "2026-01-29"
449
- }
450
- ],
451
- "governance": {
452
- "owner": "Spectrum Tokens Team",
453
- "reviewDate": "2026-01-29",
454
- "status": "review"
455
- },
456
- "relatedTerms": ["structure", "focus-ring"]
457
- },
458
- {
459
- "id": "focus-ring",
460
- "label": "Focus Ring",
461
- "description": "Visual indication of interactive keyboard focus on any UI element",
462
- "usedIn": ["tokens", "taxonomy"],
463
- "definition": {
464
- "superordinate": "structure",
465
- "description": "A consistently styled visual indicator that shows keyboard focus on any interactive UI element",
466
- "essentialCharacteristics": [
467
- "Indicates keyboard focus on interactive elements",
468
- "Styled consistently across all UI elements",
469
- "Critical for keyboard accessibility"
470
- ]
471
- },
472
- "terminology": {
473
- "conceptType": "term",
474
- "namingRationale": "Standard accessibility term for keyboard focus indication"
475
- },
476
- "sources": [
477
- {
478
- "type": "internal-doc",
479
- "reference": "Spectrum Token Taxonomy",
480
- "url": "https://www.dropbox.com/scl/fi/298zpbuvernq00219t6jf/Spectrum-Token-Taxonomies-Documentation-Draft.paper?rlkey=a9ov0sfe0yizifehxjg2zs1l8&dl=0",
481
- "date": "2026-01-29"
482
- }
483
- ],
484
- "governance": {
485
- "owner": "Spectrum Tokens Team",
486
- "reviewDate": "2026-01-29",
487
- "status": "review"
488
- },
489
- "relatedTerms": ["structure", "drop-target"]
490
- },
491
- {
492
- "id": "accessory",
493
- "label": "Accessory",
494
- "description": "Component-like structures used within basic components as secondary content or actions",
495
- "usedIn": ["tokens", "taxonomy"],
496
- "definition": {
497
- "superordinate": "structure",
498
- "description": "Smaller component-like structures used within basic components as secondary content or actions, sized to fit within base structure boundaries while conforming to t-shirt sizing rules",
499
- "essentialCharacteristics": [
500
- "Intentionally smaller to fit within base structure boundaries",
501
- "Conforms to t-shirt sizing rules for icon or text sizes",
502
- "Used for interior sub-components or decorators of basic components",
503
- "Examples include in-field buttons and Action button corner triangles",
504
- "Distinct from structures like drill-in buttons which use base structures"
505
- ]
506
- },
507
- "terminology": {
508
- "conceptType": "term",
509
- "namingRationale": "Describes the supplementary nature of these interior elements"
510
- },
511
- "sources": [
512
- {
513
- "type": "internal-doc",
514
- "reference": "Spectrum Token Taxonomy",
515
- "url": "https://www.dropbox.com/scl/fi/298zpbuvernq00219t6jf/Spectrum-Token-Taxonomies-Documentation-Draft.paper?rlkey=a9ov0sfe0yizifehxjg2zs1l8&dl=0",
516
- "date": "2026-01-29"
517
- }
518
- ],
519
- "governance": {
520
- "owner": "Spectrum Tokens Team",
521
- "reviewDate": "2026-01-29",
522
- "status": "review"
523
- },
524
- "relatedTerms": ["structure", "base"]
525
- },
526
- {
527
- "id": "banner",
528
- "label": "Banner",
529
- "description": "Horizontally-oriented, contained structure for drawing attention to non-permanent information or actions",
530
- "usedIn": ["tokens", "taxonomy"],
531
- "definition": {
532
- "superordinate": "structure",
533
- "description": "A horizontally-oriented, contained structure that may float or be fixed, designed to draw user attention to non-permanent information or actions",
534
- "essentialCharacteristics": [
535
- "Horizontally oriented",
536
- "May float or be fixed in position",
537
- "Draws user attention to transient content",
538
- "Contains non-permanent information or actions"
539
- ]
540
- },
541
- "terminology": {
542
- "conceptType": "term",
543
- "namingRationale": "Standard UI term for attention-drawing horizontal elements"
544
- },
545
- "sources": [
546
- {
547
- "type": "internal-doc",
548
- "reference": "Spectrum Token Taxonomy",
549
- "url": "https://www.dropbox.com/scl/fi/298zpbuvernq00219t6jf/Spectrum-Token-Taxonomies-Documentation-Draft.paper?rlkey=a9ov0sfe0yizifehxjg2zs1l8&dl=0",
550
- "date": "2026-01-29"
551
- }
552
- ],
553
- "governance": {
554
- "owner": "Spectrum Tokens Team",
555
- "reviewDate": "2026-01-29",
556
- "status": "review"
557
- },
558
- "relatedTerms": ["structure", "container"]
559
- },
560
- {
561
- "id": "text",
562
- "label": "Text",
563
- "description": "Text content within a component or structure",
564
- "usedIn": ["tokens", "taxonomy"],
565
- "definition": {
566
- "superordinate": "structure",
567
- "description": "The textual content element within a component or structure",
568
- "essentialCharacteristics": [
569
- "Represents textual content",
570
- "Used within other structures and components"
571
- ]
572
- },
573
- "terminology": {
574
- "conceptType": "term",
575
- "namingRationale": "Fundamental term for textual content in UI"
576
- },
577
- "sources": [
578
- {
579
- "type": "internal-doc",
580
- "reference": "Spectrum Token Taxonomy",
581
- "url": "https://www.dropbox.com/scl/fi/298zpbuvernq00219t6jf/Spectrum-Token-Taxonomies-Documentation-Draft.paper?rlkey=a9ov0sfe0yizifehxjg2zs1l8&dl=0",
582
- "date": "2026-01-29"
583
- }
584
- ],
585
- "governance": {
586
- "owner": "Spectrum Tokens Team",
587
- "reviewDate": "2026-01-29",
588
- "status": "review"
589
- },
590
- "relatedTerms": ["structure", "base"]
591
- },
592
- {
593
- "id": "substructure",
594
- "label": "Substructure",
595
- "description": "A structural element that exists within or as part of a larger structure",
596
- "usedIn": ["tokens", "taxonomy"],
597
- "definition": {
598
- "superordinate": "token taxonomy category",
599
- "description": "A structural element that exists within or as part of a parent structure, representing smaller building blocks that compose structures",
600
- "essentialCharacteristics": [
601
- "Exists within or as part of a larger structure",
602
- "Represents smaller building blocks",
603
- "Can be used across different structure types"
604
- ]
605
- },
606
- "terminology": {
607
- "conceptType": "term",
608
- "namingRationale": "Indicates the hierarchical relationship to parent structures"
609
- },
610
- "sources": [
611
- {
612
- "type": "internal-doc",
613
- "reference": "Spectrum Token Taxonomy",
614
- "url": "https://www.dropbox.com/scl/fi/298zpbuvernq00219t6jf/Spectrum-Token-Taxonomies-Documentation-Draft.paper?rlkey=a9ov0sfe0yizifehxjg2zs1l8&dl=0",
615
- "date": "2026-01-29"
616
- }
617
- ],
618
- "governance": {
619
- "owner": "Spectrum Tokens Team",
620
- "reviewDate": "2026-01-29",
621
- "status": "review"
622
- },
623
- "relatedTerms": ["structure", "item"]
624
- },
625
- {
626
- "id": "item",
627
- "label": "Item",
628
- "description": "An individual element of a collection, regardless of collection type",
629
- "usedIn": ["tokens", "taxonomy"],
630
- "definition": {
631
- "superordinate": "substructure",
632
- "description": "An individual element within a collection, applicable regardless of the collection type it belongs to",
633
- "essentialCharacteristics": [
634
- "Individual element within a collection",
635
- "Collection-agnostic—applies to any collection type",
636
- "Building block for list, table, and other collection structures"
637
- ]
638
- },
639
- "terminology": {
640
- "conceptType": "term",
641
- "namingRationale": "Generic term for collection elements that applies across structure types"
642
- },
643
- "sources": [
644
- {
645
- "type": "internal-doc",
646
- "reference": "Spectrum Token Taxonomy",
647
- "url": "https://www.dropbox.com/scl/fi/298zpbuvernq00219t6jf/Spectrum-Token-Taxonomies-Documentation-Draft.paper?rlkey=a9ov0sfe0yizifehxjg2zs1l8&dl=0",
648
- "date": "2026-01-29"
649
- }
650
- ],
651
- "governance": {
652
- "owner": "Spectrum Tokens Team",
653
- "reviewDate": "2026-01-29",
654
- "status": "review"
655
- },
656
- "relatedTerms": ["substructure", "list", "table", "base"]
657
- },
658
- {
659
- "id": "padding",
660
- "label": "Padding",
661
- "description": "The internal spacing from the edges of a component's boundary to its contents",
662
- "usedIn": ["tokens", "taxonomy"],
663
- "definition": {
664
- "superordinate": "property",
665
- "description": "A stylistic attribute that defines the internal spacing from the edges of a component's boundary to its contents",
666
- "essentialCharacteristics": [
667
- "Defines space between component boundary edges and inner contents",
668
- "Applied internally within a component",
669
- "Platform-agnostic term with high comprehension across engineers and designers"
670
- ]
671
- },
672
- "terminology": {
673
- "conceptType": "term",
674
- "namingRationale": "Standard CSS and design term for internal spacing from boundaries"
675
- },
676
- "sources": [
677
- {
678
- "type": "internal-doc",
679
- "reference": "Spectrum Token Taxonomy",
680
- "url": "https://www.dropbox.com/scl/fi/298zpbuvernq00219t6jf/Spectrum-Token-Taxonomies-Documentation-Draft.paper?rlkey=a9ov0sfe0yizifehxjg2zs1l8&dl=0",
681
- "date": "2026-01-29"
682
- }
683
- ],
684
- "governance": {
685
- "owner": "Spectrum Tokens Team",
686
- "reviewDate": "2026-01-29",
687
- "status": "review"
688
- },
689
- "relatedTerms": ["property", "gap", "edge"]
690
- },
691
- {
692
- "id": "gap",
693
- "label": "Gap",
694
- "description": "The internal spacing between child elements in a component, layout, or pattern",
695
- "usedIn": ["tokens", "taxonomy"],
696
- "definition": {
697
- "superordinate": "property",
698
- "description": "A stylistic attribute that defines the internal spacing between child elements in a component, layout, or pattern",
699
- "essentialCharacteristics": [
700
- "Defines spacing between child elements, not from boundaries",
701
- "Used in components, layouts, and patterns",
702
- "Aligns with CSS gap property and Figma auto-layout gap",
703
- "Preferred over 'spacing' for specificity and modern standards alignment"
704
- ]
705
- },
706
- "terminology": {
707
- "conceptType": "term",
708
- "namingRationale": "Aligns with CSS gap property and Figma terminology, preferred over 'spacing' for specificity",
709
- "alternatives": ["spacing"]
710
- },
711
- "sources": [
712
- {
713
- "type": "internal-doc",
714
- "reference": "Spectrum Token Taxonomy",
715
- "url": "https://www.dropbox.com/scl/fi/298zpbuvernq00219t6jf/Spectrum-Token-Taxonomies-Documentation-Draft.paper?rlkey=a9ov0sfe0yizifehxjg2zs1l8&dl=0",
716
- "date": "2026-01-29"
717
- }
718
- ],
719
- "governance": {
720
- "owner": "Spectrum Tokens Team",
721
- "reviewDate": "2026-01-29",
722
- "status": "review"
723
- },
724
- "relatedTerms": ["property", "padding"]
725
- },
726
- {
727
- "id": "orientation",
728
- "label": "Orientation",
729
- "description": "The direction or order of structures and elements within a component or pattern",
730
- "usedIn": ["tokens", "taxonomy"],
731
- "definition": {
732
- "superordinate": "token taxonomy category",
733
- "description": "A category describing the direction or order of structures and elements within a component or pattern",
734
- "essentialCharacteristics": [
735
- "Defines direction or order of elements",
736
- "Options include horizontal (left to right, right to left) and vertical (top to bottom, bottom to top)",
737
- "Applies to structures and elements within components or patterns"
738
- ]
739
- },
740
- "terminology": {
741
- "conceptType": "term",
742
- "namingRationale": "Standard term for describing directional arrangement of elements"
743
- },
744
- "sources": [
745
- {
746
- "type": "internal-doc",
747
- "reference": "Spectrum Token Taxonomy",
748
- "url": "https://www.dropbox.com/scl/fi/298zpbuvernq00219t6jf/Spectrum-Token-Taxonomies-Documentation-Draft.paper?rlkey=a9ov0sfe0yizifehxjg2zs1l8&dl=0",
749
- "date": "2026-01-29"
750
- }
751
- ],
752
- "governance": {
753
- "owner": "Spectrum Tokens Team",
754
- "reviewDate": "2026-01-29",
755
- "status": "review"
756
- },
757
- "relatedTerms": ["structure", "list"]
758
- },
759
- {
760
- "id": "shape",
761
- "label": "Shape",
762
- "description": "Describes the geometric characteristics of a component's style attributes",
763
- "usedIn": ["tokens", "taxonomy"],
764
- "definition": {
765
- "superordinate": "token taxonomy category",
766
- "description": "A category describing the geometric characteristics of a component's style attributes",
767
- "essentialCharacteristics": [
768
- "Describes geometric characteristics of styling",
769
- "Applies to component style attributes",
770
- "Includes variations like uniform dimensions"
771
- ]
772
- },
773
- "terminology": {
774
- "conceptType": "term",
775
- "namingRationale": "Describes the geometric form characteristics of component styling"
776
- },
777
- "sources": [
778
- {
779
- "type": "internal-doc",
780
- "reference": "Spectrum Token Taxonomy",
781
- "url": "https://www.dropbox.com/scl/fi/298zpbuvernq00219t6jf/Spectrum-Token-Taxonomies-Documentation-Draft.paper?rlkey=a9ov0sfe0yizifehxjg2zs1l8&dl=0",
782
- "date": "2026-01-29"
783
- }
784
- ],
785
- "governance": {
786
- "owner": "Spectrum Tokens Team",
787
- "reviewDate": "2026-01-29",
788
- "status": "review"
789
- },
790
- "relatedTerms": ["uniform", "padding"]
791
- },
792
- {
793
- "id": "uniform",
794
- "label": "Uniform",
795
- "description": "Signifies that the shape of a component's style attributes is equal in all directions",
796
- "usedIn": ["tokens", "taxonomy"],
797
- "definition": {
798
- "superordinate": "shape",
799
- "description": "A shape characteristic signifying that a component's style attributes are equal in all directions",
800
- "essentialCharacteristics": [
801
- "Equal values across dimensions (e.g., vertical and horizontal)",
802
- "Results in symmetrical shapes (e.g., square padding when showing an icon only)",
803
- "Applies to attributes like padding where dimensional equality matters"
804
- ]
805
- },
806
- "terminology": {
807
- "conceptType": "term",
808
- "namingRationale": "Describes dimensional equality in component styling"
809
- },
810
- "sources": [
811
- {
812
- "type": "internal-doc",
813
- "reference": "Spectrum Token Taxonomy",
814
- "url": "https://www.dropbox.com/scl/fi/298zpbuvernq00219t6jf/Spectrum-Token-Taxonomies-Documentation-Draft.paper?rlkey=a9ov0sfe0yizifehxjg2zs1l8&dl=0",
815
- "date": "2026-01-29"
816
- }
817
- ],
818
- "governance": {
819
- "owner": "Spectrum Tokens Team",
820
- "reviewDate": "2026-01-29",
821
- "status": "review"
822
- },
823
- "relatedTerms": ["shape", "padding"]
824
- },
825
- {
826
- "id": "position",
827
- "label": "Position",
828
- "description": "The placement of an element relative to its container or viewport",
829
- "usedIn": ["tokens", "taxonomy"],
830
- "definition": {
831
- "superordinate": "token taxonomy category",
832
- "description": "A category describing the placement of an element relative to its container or viewport",
833
- "essentialCharacteristics": [
834
- "Defines element placement",
835
- "Relative to container or viewport",
836
- "Includes variations like affixed positioning"
837
- ]
838
- },
839
- "terminology": {
840
- "conceptType": "term",
841
- "namingRationale": "Standard term for describing element placement in layouts"
842
- },
843
- "sources": [
844
- {
845
- "type": "internal-doc",
846
- "reference": "Spectrum Token Taxonomy",
847
- "url": "https://www.dropbox.com/scl/fi/298zpbuvernq00219t6jf/Spectrum-Token-Taxonomies-Documentation-Draft.paper?rlkey=a9ov0sfe0yizifehxjg2zs1l8&dl=0",
848
- "date": "2026-01-29"
849
- }
850
- ],
851
- "governance": {
852
- "owner": "Spectrum Tokens Team",
853
- "reviewDate": "2026-01-29",
854
- "status": "review"
855
- },
856
- "relatedTerms": ["affixed", "container"]
857
- },
858
- {
859
- "id": "affixed",
860
- "label": "Affixed",
861
- "description": "The position of an element fixed relative to its container or the viewport",
862
- "usedIn": ["tokens", "taxonomy"],
863
- "definition": {
864
- "superordinate": "position",
865
- "description": "A position characteristic where an element is fixed relative to its container or the viewport",
866
- "essentialCharacteristics": [
867
- "Element position is fixed relative to container or viewport",
868
- "Maintains position regardless of content scrolling",
869
- "Used for persistent UI elements like headers or toolbars"
870
- ]
871
- },
872
- "terminology": {
873
- "conceptType": "term",
874
- "namingRationale": "Describes fixed positioning behavior relative to a reference point"
875
- },
876
- "sources": [
877
- {
878
- "type": "internal-doc",
879
- "reference": "Spectrum Token Taxonomy",
880
- "url": "https://www.dropbox.com/scl/fi/298zpbuvernq00219t6jf/Spectrum-Token-Taxonomies-Documentation-Draft.paper?rlkey=a9ov0sfe0yizifehxjg2zs1l8&dl=0",
881
- "date": "2026-01-29"
882
- }
883
- ],
884
- "governance": {
885
- "owner": "Spectrum Tokens Team",
886
- "reviewDate": "2026-01-29",
887
- "status": "review"
888
- },
889
- "relatedTerms": ["position", "banner"]
890
- },
891
- {
892
- "id": "size",
893
- "label": "Size",
894
- "description": "Relative t-shirt-size terms used to create relationships and patterns across tokens",
895
- "usedIn": ["tokens", "taxonomy"],
896
- "definition": {
897
- "superordinate": "token taxonomy category",
898
- "description": "A category of relative t-shirt-size terms used to create relationships and patterns of usage across multiple tokens and token types",
899
- "essentialCharacteristics": [
900
- "Uses t-shirt size terminology (extra-small, small, medium, large, extra-large)",
901
- "Creates relationships and patterns across multiple tokens and token types",
902
- "Can construct standard components or be used irregularly for novel or custom components"
903
- ]
904
- },
905
- "terminology": {
906
- "conceptType": "term",
907
- "namingRationale": "T-shirt sizing is an industry-standard approach for relative sizing in design systems"
908
- },
909
- "sources": [
910
- {
911
- "type": "internal-doc",
912
- "reference": "Spectrum Token Taxonomy",
913
- "url": "https://www.dropbox.com/scl/fi/298zpbuvernq00219t6jf/Spectrum-Token-Taxonomies-Documentation-Draft.paper?rlkey=a9ov0sfe0yizifehxjg2zs1l8&dl=0",
914
- "date": "2026-01-29"
915
- }
916
- ],
917
- "governance": {
918
- "owner": "Spectrum Tokens Team",
919
- "reviewDate": "2026-01-29",
920
- "status": "review"
921
- },
922
- "relatedTerms": ["scale", "base"]
923
- }
924
- ]
925
- }