Skip to content

Conversation

@GarthDB
Copy link
Member

@GarthDB GarthDB commented Jan 12, 2026

Adds a new foundational package that provides a single source of truth for design system terminology.

What's Changed

  • New package: @adobe/design-system-registry
  • 8 registry JSON files (sizes, states, variants, anatomy-terms, components, scale-values, categories, platforms)
  • JSON schema validation for registry structure
  • Comprehensive test coverage with AVA (36 tests passing)
  • Validation script for consistency checks
  • Moon configuration as library layer

Related

Testing

  • pnpm ava - 36 tests passing ✅
  • node scripts/validate-registry.js - All registry validation passing ✅

Registries Included

  1. sizes.json - Size scale values (xs, s, m, l, xl, xxl, xxxl, numeric sizes)
  2. states.json - Interaction states (default, hover, focus, disabled, etc.)
  3. variants.json - Color and style variants (accent, negative, primary, etc.)
  4. anatomy-terms.json - Anatomical part names (edge, visual, text, icon, etc.)
  5. components.json - Spectrum component names (54 components)
  6. scale-values.json - Numeric scale values (50, 75, 100, 200, etc.)
  7. categories.json - Component categories (8 categories)
  8. platforms.json - Platform names (desktop, mobile, web, iOS, Android)

Future Work

  • Update component-options-editor to consume registry (separate PR)
  • Update component-schemas to reference registry (separate PR)
  • Add token name validation using registry (separate PR)

- Create packages/design-system-registry as new library package
- Add registries for sizes, states, variants, anatomy terms, components
- Include scale values, categories, and platforms registries
- Add JSON schema validation for registry entries
- Add comprehensive AVA tests (36 tests passing)
- Add moon.yml configuration as library layer
- Add validation script for registry consistency
@changeset-bot
Copy link

changeset-bot bot commented Jan 12, 2026

🦋 Changeset detected

Latest commit: 3dff45c

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 2 packages
Name Type
@adobe/design-system-registry Minor
spectrum-glossary Major

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

@GarthDB
Copy link
Member Author

GarthDB commented Jan 12, 2026

Run report for 3dff45cb

Total time: 1m 27s | Comparison time: 3m 46s | Estimated savings: 2m 19s (61.5% faster)

Action Time Status Info
🟩 SyncWorkspace 7.5ms Passed
🟩 SyncProject(optimized-diff) 0.3ms Passed
🟩 SyncProject(release-analyzer) 0.3ms Passed
🟩 SyncProject(componentSchemas) 0.4ms Passed
🟩 SyncProject(spectrum-diff-core) 0.3ms Passed
🟩 SyncProject(release-timeline) 0.3ms Passed
🟩 SyncProject(tokens) 0.4ms Passed
🟩 SyncProject(s2-visualizer) 0.4ms Passed
🟩 SyncProject(visualizer) 0.3ms Passed
🟩 SyncProject(site) 0.4ms Passed
🟩 SyncProject(design-system-registry) 0.3ms Passed
🟩 SyncProject(component-options-editor) 0.4ms Passed
🟩 SyncProject(component-diff-generator) 0.4ms Passed
🟩 SyncProject(token-diff-generator) 0.4ms Passed
🟩 SyncProject(spectrum-design-data-mcp) 9.3ms Passed
🟩 SyncProject(viewer) 9.4ms Passed
🟩 SyncProject(csvGenerator) 0.2ms Passed
🟩 RunTask(release-timeline:clean) 27.6ms Passed
🟩 SyncProject(spectrum-glossary) 0.3ms Passed
🟩 RunTask(viewer:clean) 34ms Passed
And 44 more...
Expanded report
Action Time Status Info
🟩 RunTask(site:copyComponentSchema) 64ms Passed
🟩 RunTask(site:copyTokenTypeSchema) 69.1ms Passed
🟩 SetupProto(0.51.4) 1.7s Passed
⬛️ SetupToolchain(node:~20.12) 1.3s Skipped
🟩 InstallWorkspaceDeps(node:~20.12) 9.8s Passed
🟩 RunTask(tokens:buildManifest) 256.2ms Passed
🟩 RunTask(visualizer:typescript) 4s Passed
🟩 RunTask(design-system-registry:validate) 437.9ms Passed
🟩 RunTask(component-options-editor:type-check) 8.6s Passed
🟩 RunTask(component-options-editor:lint) 9.1s Passed
🟩 RunTask(spectrum-glossary:build) 8.2s Passed
🟩 RunTask(token-diff-generator:test) 9.4s Passed
🟩 RunTask(csvGenerator:test) 1.8s Passed
🟩 RunTask(component-diff-generator:test) 3s Passed
🟩 RunTask(release-timeline:updateData) 1.3s Passed
🟩 RunTask(spectrum-diff-core:test) 2.8s Passed
🟩 RunTask(release-analyzer:test) 2.3s Passed
🟩 RunTask(s2-visualizer:typescript) 4.9s Passed
🟩 RunTask(component-options-editor:test) 11.5s Passed
🟩 RunTask(componentSchemas:test) 4.1s Passed
🟩 RunTask(component-options-editor:build) 42.8s Passed
🟩 RunTask(site:clean) 161.9ms Passed
🟩 RunTask(design-system-registry:test) 1.7s Passed
🟩 RunTask(spectrum-design-data-mcp:test) 2s Passed
🟩 RunTask(spectrum-glossary:clean) 853.8ms Passed
🟩 RunTask(csvGenerator:generateCSV) 243.7ms Passed
🟩 RunTask(optimized-diff:test) 1.6s Passed
🟩 RunTask(visualizer:build) 3.2s Passed
🟩 RunTask(token-diff-generator:ci) 18.2ms Passed
🟩 RunTask(token-diff-generator:diff) 235.7ms Passed
🟩 RunTask(component-diff-generator:ci) 38.3ms Passed
🟩 RunTask(component-diff-generator:diff) 481.8ms Passed
🟩 RunTask(site:build) 35.2s Passed
🟩 RunTask(spectrum-diff-core:ci) 11.7ms Passed
🟩 RunTask(release-timeline:build) 2.2s Passed
🟩 RunTask(optimized-diff:benchmark) 722.2ms Passed
🟩 RunTask(site:export) 313.2ms Passed
🟩 RunTask(s2-visualizer:build) 3.5s Passed
🟩 RunTask(component-options-editor:validate) 12.5s Passed
🟩 RunTask(tokens:buildTokens) 1m 11s Passed
🟩 RunTask(tokens:build) 13.3ms Passed
🟩 RunTask(viewer:prepare) 29.8ms Passed
🟩 RunTask(viewer:export) 41.9ms Passed
🟩 RunTask(tokens:test) 2.7s Passed
Touched files
.changeset/add-design-system-registry.md
.changeset/add-spectrum-glossary.md
.github/workflows/deploy-docs.yml
.moon/workspace.yml
APP_FRAME_BROWSING_WIKI.md
GLOSSARY_IMPLEMENTATION_STATUS.md
SDS_15462_JIRA.md
SPECTRUM_NAMING_GUIDE_WIKI.md
SPECTRUM_TOKENS_WIKI.md
docs/spectrum-glossary/.eleventy.js
docs/spectrum-glossary/.gitignore
docs/spectrum-glossary/BUILD_SUMMARY.md
docs/spectrum-glossary/CHANGELOG.md
docs/spectrum-glossary/DEPLOYMENT_INTEGRATION.md
docs/spectrum-glossary/README.md
docs/spectrum-glossary/moon.yml
docs/spectrum-glossary/package.json
docs/spectrum-glossary/scripts/build-api.js
docs/spectrum-glossary/scripts/build-search-index.js
docs/spectrum-glossary/scripts/export-to-site.sh
docs/spectrum-glossary/src/_data/meta.js
docs/spectrum-glossary/src/_data/navigation.js
docs/spectrum-glossary/src/_data/registry.js
docs/spectrum-glossary/src/_includes/components/footer.njk
docs/spectrum-glossary/src/_includes/components/header.njk
docs/spectrum-glossary/src/_includes/components/related-terms.njk
docs/spectrum-glossary/src/_includes/components/search.njk
docs/spectrum-glossary/src/_includes/components/term-card.njk
docs/spectrum-glossary/src/_includes/layouts/base.njk
docs/spectrum-glossary/src/assets/css/index.css
docs/spectrum-glossary/src/assets/js/filters.js
docs/spectrum-glossary/src/assets/js/search.js
docs/spectrum-glossary/src/assets/js/theme.js
docs/spectrum-glossary/src/categories/categories.njk
docs/spectrum-glossary/src/index.njk
docs/spectrum-glossary/src/terms/terms.njk
packages/design-system-registry/AUTHORING.md
packages/design-system-registry/CHANGELOG.md
packages/design-system-registry/PLATFORM_EXTENSIONS.md
packages/design-system-registry/README.md
packages/design-system-registry/ava.config.js
packages/design-system-registry/index.js
packages/design-system-registry/moon.yml
packages/design-system-registry/package.json
packages/design-system-registry/registry/anatomy-terms.json
packages/design-system-registry/registry/categories.json
packages/design-system-registry/registry/components.json
packages/design-system-registry/registry/glossary.json
packages/design-system-registry/registry/navigation-terms.json
packages/design-system-registry/registry/platform-extensions/ios-states.json
packages/design-system-registry/registry/platform-extensions/web-components-states.json
packages/design-system-registry/registry/platforms.json
packages/design-system-registry/registry/scale-values.json
packages/design-system-registry/registry/sizes.json
packages/design-system-registry/registry/states.json
packages/design-system-registry/registry/token-terminology.json
packages/design-system-registry/registry/variants.json
packages/design-system-registry/schemas/platform-extension.json
packages/design-system-registry/schemas/registry-value.json
packages/design-system-registry/scripts/validate-registry.js
packages/design-system-registry/test/registry.test.js
pnpm-lock.yaml
tools/component-options-editor/build/plugin/helpers.js
tools/component-options-editor/build/plugin/helpers.js.map
tools/component-options-editor/build/plugin/plugin.js
tools/component-options-editor/build/plugin/plugin.js.map
tools/component-options-editor/build/ui/app/events/saveOptionEvent.js
tools/component-options-editor/build/ui/app/events/saveOptionEvent.js.map
tools/component-options-editor/build/ui/app/litAppElement.js
tools/component-options-editor/build/ui/app/litAppElement.js.map
tools/component-options-editor/build/ui/app/templates/codeEditor.js
tools/component-options-editor/build/ui/app/templates/codeEditor.js.map
tools/component-options-editor/build/ui/app/templates/colorForm.js
tools/component-options-editor/build/ui/app/templates/colorForm.js.map
tools/component-options-editor/build/ui/app/templates/iconForm.js
tools/component-options-editor/build/ui/app/templates/iconForm.js.map
tools/component-options-editor/build/ui/app/templates/localEnumForm.js
tools/component-options-editor/build/ui/app/templates/localEnumForm.js.map
tools/component-options-editor/build/ui/app/templates/optionForm.js
tools/component-options-editor/build/ui/app/templates/optionForm.js.map
tools/component-options-editor/build/ui/app/templates/optionsPreview.js
tools/component-options-editor/build/ui/app/templates/optionsPreview.js.map
tools/component-options-editor/build/ui/app/templates/schemaImporter.js
tools/component-options-editor/build/ui/app/templates/schemaImporter.js.map
tools/component-options-editor/build/ui/app/templates/sizeForm.js
tools/component-options-editor/build/ui/app/templates/sizeForm.js.map
tools/component-options-editor/build/ui/app/templates/stateForm.js
tools/component-options-editor/build/ui/app/templates/stateForm.js.map
tools/component-options-editor/build/ui/app/templates/systemEnumForm.js
tools/component-options-editor/build/ui/app/templates/systemEnumForm.js.map
tools/component-options-editor/build/ui/app/templates/systemOptionsPanel.js
tools/component-options-editor/build/ui/app/templates/systemOptionsPanel.js.map
tools/component-options-editor/build/ui/app/templates/validationErrors.js
tools/component-options-editor/build/ui/app/templates/validationErrors.js.map
tools/component-options-editor/build/ui/bundledSchemas.json
tools/component-options-editor/build/ui/schemaConverter.js
tools/component-options-editor/build/ui/schemaConverter.js.map
tools/component-options-editor/build/ui/ui.js
tools/component-options-editor/build/ui/ui.js.map
tools/component-options-editor/build/ui/utils/jsonErrorUtils.js
tools/component-options-editor/build/ui/utils/jsonErrorUtils.js.map
tools/component-options-editor/build/ui/utils/jsonErrorUtils.test.js
tools/component-options-editor/build/ui/utils/jsonErrorUtils.test.js.map
tools/component-options-editor/build/ui/validators/jsonValidator.js
tools/component-options-editor/build/ui/validators/jsonValidator.js.map
tools/component-options-editor/build/ui/validators/jsonValidator.test.js
tools/component-options-editor/build/ui/validators/jsonValidator.test.js.map
tools/component-options-editor/src/ui/bundledSchemas.json

Updates lockfile to include dependencies for:
- design-system-registry package
- spectrum-glossary package
- Add comprehensive glossary web interface using 11ty + Spectrum Web Components
- 179 terms across 11 registries with enhanced definitions
- Full-text search with Fuse.js
- Static JSON API for programmatic access
- Dark mode support and mobile responsive
- Integrated into main docs deployment workflow
- Platform extension system for iOS, Web Components, etc.

Related: Phase 3 of Spectrum Design System Glossary project
Resolved conflicts:
- pnpm-lock.yaml: regenerated to include dependencies from both branches
The export task is only needed for deployment, not for CI builds.
This prevents CI failures when the task tries to copy to site directory.
@GarthDB GarthDB merged commit 4051014 into main Jan 13, 2026
4 checks passed
@GarthDB GarthDB deleted the feature/add-design-system-registry branch January 13, 2026 20:24
@GarthDB GarthDB mentioned this pull request Jan 13, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants