@adobe/design-system-registry 0.0.0-layout-20260211224825 → 1.2.0

package/CHANGELOG.md

@@ -1,10 +1,21 @@
 # @adobe/design-system-registry
 
-## 0.0.0-layout-20260211224825
+## 1.2.0
 
-### Patch Changes
+### Minor Changes
 
-- Added layout tokens and updated token terminology
+- [#812](https://github.com/adobe/spectrum-design-data/pull/812) [`32029a9`](https://github.com/adobe/spectrum-design-data/commit/32029a9d0565efcd448c399e767844389730ef2c) Thanks [@GarthDB](https://github.com/GarthDB)! - Split sizes.json: remove numeric scale values (50-1500), keeping
+  only semantic t-shirt sizes (xs-xxxl). Numeric values 1100-1500
+  added to scale-values.json to preserve data completeness.
+
+- [#810](https://github.com/adobe/spectrum-design-data/pull/810) [`4a55a5f`](https://github.com/adobe/spectrum-design-data/commit/4a55a5f2b027d7df73852cb62dd633bd5da17c93) Thanks [@GarthDB](https://github.com/GarthDB)! - Add taxonomy registries and expand token name object schema.
+  - Split `anatomy-terms.json`: removed styling surfaces and positional terms
+  - Added `token-objects.json` (background, border, edge, visual, content)
+  - Added 6 new taxonomy registries:
+    structures, substructures, orientations, positions, densities, shapes
+  - Exported all 7 new registries from package index
+  - Added all 13 semantic fields explicitly to `nameObject` in
+    `token.schema.json`, distinguishing semantic from dimension fields
 
 ## 1.1.0
 

package/index.js

@@ -62,6 +62,34 @@ export const glossary = JSON.parse(
   readFileSync(join(__dirname, "registry", "glossary.json"), "utf-8"),
 );
 
+export const tokenObjects = JSON.parse(
+  readFileSync(join(__dirname, "registry", "token-objects.json"), "utf-8"),
+);
+
+export const structures = JSON.parse(
+  readFileSync(join(__dirname, "registry", "structures.json"), "utf-8"),
+);
+
+export const substructures = JSON.parse(
+  readFileSync(join(__dirname, "registry", "substructures.json"), "utf-8"),
+);
+
+export const orientations = JSON.parse(
+  readFileSync(join(__dirname, "registry", "orientations.json"), "utf-8"),
+);
+
+export const positions = JSON.parse(
+  readFileSync(join(__dirname, "registry", "positions.json"), "utf-8"),
+);
+
+export const densities = JSON.parse(
+  readFileSync(join(__dirname, "registry", "densities.json"), "utf-8"),
+);
+
+export const shapes = JSON.parse(
+  readFileSync(join(__dirname, "registry", "shapes.json"), "utf-8"),
+);
+
 /**
  * Get all values from a registry by ID
  * @param {object} registry - The registry object

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adobe/design-system-registry",
-  "version": "0.0.0-layout-20260211224825",
+  "version": "1.2.0",
   "description": "A single source of truth for design system terminology used across Spectrum tokens, component schemas, and anatomy",
   "type": "module",
   "main": "index.js",
@@ -13,7 +13,14 @@
     "./registry/components.json": "./registry/components.json",
     "./registry/scale-values.json": "./registry/scale-values.json",
     "./registry/categories.json": "./registry/categories.json",
-    "./registry/platforms.json": "./registry/platforms.json"
+    "./registry/platforms.json": "./registry/platforms.json",
+    "./registry/token-objects.json": "./registry/token-objects.json",
+    "./registry/structures.json": "./registry/structures.json",
+    "./registry/substructures.json": "./registry/substructures.json",
+    "./registry/orientations.json": "./registry/orientations.json",
+    "./registry/positions.json": "./registry/positions.json",
+    "./registry/densities.json": "./registry/densities.json",
+    "./registry/shapes.json": "./registry/shapes.json"
   },
   "repository": {
     "type": "git",
@@ -25,7 +32,7 @@
     "url": "https://github.com/adobe/spectrum-design-data/issues"
   },
   "publishConfig": {
-    "provenance": false
+    "provenance": true
   },
   "homepage": "https://github.com/adobe/spectrum-design-data/tree/main/packages/design-system-registry#readme",
   "license": "Apache-2.0",

package/registry/anatomy-terms.json

@@ -1,20 +1,8 @@
 {
   "$schema": "https://opensource.adobe.com/spectrum-design-data/schemas/registry-value.json",
   "type": "anatomy-term",
-  "description": "Anatomical part names used in design tokens and component structures",
+  "description": "Visible, named parts of components as defined by designers. These are the parts called out in component specification diagrams. Styling surfaces (background, border, etc.) belong in token-objects.json; positional terms (top, bottom, etc.) belong in positions.json.",
   "values": [
-    {
-      "id": "edge",
-      "label": "Edge",
-      "description": "The outer boundary or border of a component",
-      "usedIn": ["tokens"]
-    },
-    {
-      "id": "visual",
-      "label": "Visual",
-      "description": "Visual elements like icons, images, or decorative elements",
-      "usedIn": ["tokens"]
-    },
     {
       "id": "text",
       "label": "Text",
@@ -27,18 +15,6 @@
       "description": "Interactive control elements like checkboxes or radio buttons",
       "usedIn": ["tokens"]
     },
-    {
-      "id": "border",
-      "label": "Border",
-      "description": "Border or outline of a component",
-      "usedIn": ["tokens"]
-    },
-    {
-      "id": "background",
-      "label": "Background",
-      "description": "Background surface or fill",
-      "usedIn": ["tokens"]
-    },
     {
       "id": "icon",
       "label": "Icon",
@@ -51,36 +27,6 @@
       "description": "Text labels",
       "usedIn": ["tokens", "component-schemas"]
     },
-    {
-      "id": "content",
-      "label": "Content",
-      "description": "Main content area",
-      "usedIn": ["tokens"]
-    },
-    {
-      "id": "top",
-      "label": "Top",
-      "description": "Top edge or boundary",
-      "usedIn": ["tokens"]
-    },
-    {
-      "id": "bottom",
-      "label": "Bottom",
-      "description": "Bottom edge or boundary",
-      "usedIn": ["tokens"]
-    },
-    {
-      "id": "start",
-      "label": "Start",
-      "description": "Start edge (left in LTR, right in RTL)",
-      "usedIn": ["tokens"]
-    },
-    {
-      "id": "end",
-      "label": "End",
-      "description": "End edge (right in LTR, left in RTL)",
-      "usedIn": ["tokens"]
-    },
     {
       "id": "body",
       "label": "Body",

package/registry/densities.json

@@ -0,0 +1,17 @@
+{
+  "$schema": "https://opensource.adobe.com/spectrum-design-data/schemas/registry-value.json",
+  "type": "density",
+  "description": "Options that create more or less space within or around the parts of a component.",
+  "values": [
+    {
+      "id": "spacious",
+      "label": "Spacious",
+      "description": "More space within and around component parts"
+    },
+    {
+      "id": "compact",
+      "label": "Compact",
+      "description": "Less space within and around component parts"
+    }
+  ]
+}

package/registry/orientations.json

@@ -0,0 +1,17 @@
+{
+  "$schema": "https://opensource.adobe.com/spectrum-design-data/schemas/registry-value.json",
+  "type": "orientation",
+  "description": "Direction or order of structures and elements within a component or pattern.",
+  "values": [
+    {
+      "id": "vertical",
+      "label": "Vertical",
+      "description": "Top-to-bottom direction"
+    },
+    {
+      "id": "horizontal",
+      "label": "Horizontal",
+      "description": "Left-to-right (or right-to-left) direction"
+    }
+  ]
+}

package/registry/positions.json

@@ -0,0 +1,32 @@
+{
+  "$schema": "https://opensource.adobe.com/spectrum-design-data/schemas/registry-value.json",
+  "type": "position",
+  "description": "Location of an object relative to another, with or without respect to directional order.",
+  "values": [
+    {
+      "id": "affixed",
+      "label": "Affixed",
+      "description": "Attached to another element in a fixed position"
+    },
+    {
+      "id": "top",
+      "label": "Top",
+      "description": "Top position relative to a reference element"
+    },
+    {
+      "id": "bottom",
+      "label": "Bottom",
+      "description": "Bottom position relative to a reference element"
+    },
+    {
+      "id": "start",
+      "label": "Start",
+      "description": "Start position (left in LTR, right in RTL)"
+    },
+    {
+      "id": "end",
+      "label": "End",
+      "description": "End position (right in LTR, left in RTL)"
+    }
+  ]
+}

package/registry/scale-values.json

@@ -86,6 +86,41 @@
       "value": 1000,
       "category": "extended",
       "usedIn": ["tokens"]
+    },
+    {
+      "id": "1100",
+      "label": "Scale 1100",
+      "value": 1100,
+      "category": "extended",
+      "usedIn": ["component-schemas"]
+    },
+    {
+      "id": "1200",
+      "label": "Scale 1200",
+      "value": 1200,
+      "category": "extended",
+      "usedIn": ["component-schemas"]
+    },
+    {
+      "id": "1300",
+      "label": "Scale 1300",
+      "value": 1300,
+      "category": "extended",
+      "usedIn": ["component-schemas"]
+    },
+    {
+      "id": "1400",
+      "label": "Scale 1400",
+      "value": 1400,
+      "category": "extended",
+      "usedIn": ["component-schemas"]
+    },
+    {
+      "id": "1500",
+      "label": "Scale 1500",
+      "value": 1500,
+      "category": "extended",
+      "usedIn": ["component-schemas"]
     }
   ]
 }

package/registry/shapes.json

@@ -0,0 +1,12 @@
+{
+  "$schema": "https://opensource.adobe.com/spectrum-design-data/schemas/registry-value.json",
+  "type": "shape",
+  "description": "Terms relative to the overall shape of a component. This is a starting vocabulary — new shape terms should be added here as design system patterns are identified.",
+  "values": [
+    {
+      "id": "uniform",
+      "label": "Uniform",
+      "description": "Equal proportions (e.g., 1:1 ratio between horizontal and vertical padding)"
+    }
+  ]
+}

package/registry/sizes.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://opensource.adobe.com/spectrum-design-data/schemas/registry-value.json",
   "type": "size",
-  "description": "Standard size scale values used across Spectrum",
+  "description": "Semantic t-shirt size values used across Spectrum. Numeric scale values belong in scale-values.json.",
   "values": [
     {
       "id": "xs",
@@ -45,108 +45,6 @@
       "label": "3X Large",
       "aliases": [],
       "usedIn": ["component-options", "component-schemas"]
-    },
-    {
-      "id": "50",
-      "label": "Size 50",
-      "aliases": [],
-      "usedIn": ["tokens", "component-schemas"]
-    },
-    {
-      "id": "75",
-      "label": "Size 75",
-      "aliases": [],
-      "usedIn": ["tokens", "component-schemas"]
-    },
-    {
-      "id": "100",
-      "label": "Size 100",
-      "aliases": [],
-      "usedIn": ["tokens", "component-schemas"]
-    },
-    {
-      "id": "200",
-      "label": "Size 200",
-      "aliases": [],
-      "usedIn": ["tokens", "component-schemas"]
-    },
-    {
-      "id": "300",
-      "label": "Size 300",
-      "aliases": [],
-      "usedIn": ["tokens", "component-schemas"]
-    },
-    {
-      "id": "400",
-      "label": "Size 400",
-      "aliases": [],
-      "usedIn": ["tokens", "component-schemas"]
-    },
-    {
-      "id": "500",
-      "label": "Size 500",
-      "aliases": [],
-      "usedIn": ["tokens", "component-schemas"]
-    },
-    {
-      "id": "600",
-      "label": "Size 600",
-      "aliases": [],
-      "usedIn": ["tokens", "component-schemas"]
-    },
-    {
-      "id": "700",
-      "label": "Size 700",
-      "aliases": [],
-      "usedIn": ["tokens", "component-schemas"]
-    },
-    {
-      "id": "800",
-      "label": "Size 800",
-      "aliases": [],
-      "usedIn": ["tokens", "component-schemas"]
-    },
-    {
-      "id": "900",
-      "label": "Size 900",
-      "aliases": [],
-      "usedIn": ["tokens", "component-schemas"]
-    },
-    {
-      "id": "1000",
-      "label": "Size 1000",
-      "aliases": [],
-      "usedIn": ["tokens", "component-schemas"]
-    },
-    {
-      "id": "1100",
-      "label": "Size 1100",
-      "aliases": [],
-      "usedIn": ["component-schemas"]
-    },
-    {
-      "id": "1200",
-      "label": "Size 1200",
-      "aliases": [],
-      "usedIn": ["component-schemas"]
-    },
-    {
-      "id": "1300",
-      "label": "Size 1300",
-      "aliases": [],
-      "usedIn": ["component-schemas"]
-    },
-    {
-      "id": "1400",
-      "label": "Size 1400",
-      "aliases": [],
-      "usedIn": ["component-schemas"]
-    },
-    {
-      "id": "1500",
-      "label": "Size 1500",
-      "aliases": [],
-      "usedIn": ["component-schemas"]
     }
   ]
 }

package/registry/structures.json

@@ -0,0 +1,27 @@
+{
+  "$schema": "https://opensource.adobe.com/spectrum-design-data/schemas/registry-value.json",
+  "type": "structure",
+  "description": "Reusable visual patterns or object categories that occur across many varieties of components. Distinct from components, which are specific UI elements.",
+  "values": [
+    {
+      "id": "base",
+      "label": "Base",
+      "description": "Foundation structure shared across components"
+    },
+    {
+      "id": "container",
+      "label": "Container",
+      "description": "Enclosing structure that holds child elements"
+    },
+    {
+      "id": "list",
+      "label": "List",
+      "description": "Ordered or unordered collection of items"
+    },
+    {
+      "id": "accessory",
+      "label": "Accessory",
+      "description": "Supplementary element attached to a primary structure"
+    }
+  ]
+}

package/registry/substructures.json

@@ -0,0 +1,12 @@
+{
+  "$schema": "https://opensource.adobe.com/spectrum-design-data/schemas/registry-value.json",
+  "type": "substructure",
+  "description": "Structures that only exist within the context of a parent structure (e.g., item within a list).",
+  "values": [
+    {
+      "id": "item",
+      "label": "Item",
+      "description": "Individual element within a parent structure (e.g., list item)"
+    }
+  ]
+}

package/registry/token-objects.json

@@ -0,0 +1,32 @@
+{
+  "$schema": "https://opensource.adobe.com/spectrum-design-data/schemas/registry-value.json",
+  "type": "token-object",
+  "description": "Styling surfaces to which visual properties are applied. These are abstract targets that exist on any element regardless of component type. Not to be confused with component anatomy (visible named parts).",
+  "values": [
+    {
+      "id": "background",
+      "label": "Background",
+      "description": "Background surface or fill"
+    },
+    {
+      "id": "border",
+      "label": "Border",
+      "description": "Border or outline of a component"
+    },
+    {
+      "id": "edge",
+      "label": "Edge",
+      "description": "Outer boundary of a component (used in spacing tokens)"
+    },
+    {
+      "id": "visual",
+      "label": "Visual",
+      "description": "Visible graphic element area (may be inset from edge)"
+    },
+    {
+      "id": "content",
+      "label": "Content",
+      "description": "Main content area"
+    }
+  ]
+}

package/test/registry.test.js

@@ -20,6 +20,13 @@ import {
   scaleValues,
   categories,
   platforms,
+  tokenObjects,
+  structures,
+  substructures,
+  orientations,
+  positions,
+  densities,
+  shapes,
   getValues,
   findValue,
   hasValue,
@@ -226,6 +233,13 @@ test("sizes includes common t-shirt sizes", (t) => {
   t.true(ids.includes("xl"));
 });
 
+test("sizes does not contain numeric scale values", (t) => {
+  const ids = getValues(sizes);
+  t.false(ids.includes("50"));
+  t.false(ids.includes("100"));
+  t.false(ids.includes("200"));
+});
+
 test("states includes common interaction states", (t) => {
   const ids = getValues(states);
   t.true(ids.includes("default"));
@@ -243,10 +257,27 @@ test("variants includes semantic variants", (t) => {
 
 test("anatomyTerms includes key anatomy parts", (t) => {
   const ids = getValues(anatomyTerms);
-  t.true(ids.includes("edge"));
-  t.true(ids.includes("visual"));
   t.true(ids.includes("text"));
   t.true(ids.includes("icon"));
+  t.true(ids.includes("label"));
+  t.true(ids.includes("handle"));
+});
+
+test("anatomyTerms does not include styling surfaces", (t) => {
+  const ids = getValues(anatomyTerms);
+  t.false(ids.includes("background"));
+  t.false(ids.includes("border"));
+  t.false(ids.includes("edge"));
+  t.false(ids.includes("visual"));
+});
+
+test("tokenObjects includes styling surfaces", (t) => {
+  const ids = getValues(tokenObjects);
+  t.true(ids.includes("background"));
+  t.true(ids.includes("border"));
+  t.true(ids.includes("edge"));
+  t.true(ids.includes("visual"));
+  t.true(ids.includes("content"));
 });
 
 test("components includes core components", (t) => {
@@ -278,3 +309,70 @@ test("scaleValues includes common numeric scales", (t) => {
   t.true(ids.includes("200"));
   t.true(ids.includes("300"));
 });
+
+test("scaleValues includes extended numeric scales", (t) => {
+  const ids = getValues(scaleValues);
+  t.true(ids.includes("1100"));
+  t.true(ids.includes("1200"));
+  t.true(ids.includes("1500"));
+});
+
+// Taxonomy registry tests
+
+const taxonomyRegistries = [
+  ["tokenObjects", tokenObjects],
+  ["structures", structures],
+  ["substructures", substructures],
+  ["orientations", orientations],
+  ["positions", positions],
+  ["densities", densities],
+  ["shapes", shapes],
+];
+
+for (const [name, registry] of taxonomyRegistries) {
+  test(`${name} registry loads successfully`, (t) => {
+    t.truthy(registry);
+    t.truthy(registry.values);
+    t.true(Array.isArray(registry.values));
+    t.true(registry.values.length > 0);
+  });
+
+  test(`${name} registry has no duplicate IDs`, (t) => {
+    const ids = registry.values.map((v) => v.id);
+    const uniqueIds = new Set(ids);
+    t.is(ids.length, uniqueIds.size);
+  });
+
+  test(`all ${name} values have id and label`, (t) => {
+    registry.values.forEach((value) => {
+      t.truthy(value.id, `${name} value missing id`);
+      t.truthy(value.label, `${name} value ${value.id} missing label`);
+    });
+  });
+}
+
+test("structures includes base and container", (t) => {
+  const ids = getValues(structures);
+  t.true(ids.includes("base"));
+  t.true(ids.includes("container"));
+});
+
+test("orientations includes vertical and horizontal", (t) => {
+  const ids = getValues(orientations);
+  t.true(ids.includes("vertical"));
+  t.true(ids.includes("horizontal"));
+});
+
+test("positions includes directional terms", (t) => {
+  const ids = getValues(positions);
+  t.true(ids.includes("top"));
+  t.true(ids.includes("bottom"));
+  t.true(ids.includes("start"));
+  t.true(ids.includes("end"));
+});
+
+test("densities includes spacious and compact", (t) => {
+  const ids = getValues(densities);
+  t.true(ids.includes("spacious"));
+  t.true(ids.includes("compact"));
+});