@adobe/design-data-spec 3.4.1 → 3.5.0

package/conformance/invalid/SPEC-058/dataset.json

@@ -0,0 +1,38 @@
+{
+  "tokens": [
+    {
+      "name": {
+        "component": "accordion",
+        "property": "top-to-text-compact-medium"
+      },
+      "value": "5px",
+      "uuid": "aaaaaaaa-0058-4000-8000-000000000001",
+      "lifecycle": {
+        "deprecatedIn": "14.3.0",
+        "replacedBy": "aaaaaaaa-0058-4000-8000-000000000002"
+      }
+    },
+    {
+      "name": { "property": "base-padding-vertical-medium" },
+      "value": "5px",
+      "uuid": "aaaaaaaa-0058-4000-8000-000000000002"
+    }
+  ],
+  "relationships": [
+    {
+      "scope": {
+        "component": "accordion",
+        "property": "top-to-text-compact-medium"
+      },
+      "$ref": "aaaaaaaa-0058-4000-8000-000000000001"
+    }
+  ],
+  "components": [
+    {
+      "$id": "https://opensource.adobe.com/spectrum-design-data/schemas/v0/components/accordion.json",
+      "name": "accordion",
+      "displayName": "Accordion",
+      "meta": { "category": "actions" }
+    }
+  ]
+}

package/conformance/invalid/SPEC-058/expected-errors.json

@@ -0,0 +1,10 @@
+{
+  "layer": 2,
+  "errors": [
+    {
+      "rule_id": "SPEC-058",
+      "severity": "warning",
+      "message_pattern": ".*deprecated in 14.3.0.*aaaaaaaa-0058-4000-8000-000000000002.*"
+    }
+  ]
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adobe/design-data-spec",
-  "version": "3.4.1",
+  "version": "3.5.0",
   "description": "Design Data Specification — prose, JSON Schemas, rule catalog, and conformance fixtures for the design data format",
   "type": "module",
   "repository": {

package/rules/rules.yaml

@@ -690,3 +690,20 @@ rules:
     message: "Relationship '{relationship}' may need a legacyKey to round-trip through the legacy generator"
     spec_ref: spec/relationship-format.md#legacy-fields-interim
     introduced_in: "1.0.0-draft"
+
+  - id: SPEC-058
+    name: ctr-ref-not-deprecated
+    severity: warning
+    layer: 2
+    category: naming-consistency
+    note: >
+      Warning, not error: some deprecated targets have no `replacedBy` (or an ambiguous
+      array-form one) and can't be auto-corrected without manual triage, so this can't be
+      a hard gate yet.
+    assert: >
+      A relationship-only CTR's `$ref` (no `uuid`/`legacyKey`) SHOULD NOT resolve to a
+      token whose `lifecycle.deprecatedIn` is set. A value-owning CTR (`uuid`/`legacyKey`
+      present) is exempt — it legitimately *is* the deprecated token record.
+    message: "Relationship $ref {ref} resolves to a token deprecated in {deprecatedIn}"
+    spec_ref: spec/relationship-format.md#legacy-fields-interim
+    introduced_in: "1.0.0-draft"

package/spec/mode-sets.md

@@ -27,11 +27,11 @@ A **mode set declaration** is a JSON object describing one axis of variation. It
 
 These mode sets are declared in the `mode-sets/` catalog (see [Mode Set catalog](#mode-set-catalog)) and **SHOULD** be used consistently across Spectrum-compatible datasets:
 
-| `name`        | `modes`                      | `default` | Notes                                                                             |
-| ------------- | ---------------------------- | --------- | --------------------------------------------------------------------------------- |
-| `colorScheme` | `light`, `dark`, `wireframe` | `light`   | Theme / appearance.                                                               |
-| `scale`       | `desktop`, `mobile`          | `desktop` | Density scale. Legacy names; desktop = medium, mobile = large in W3C terminology. |
-| `contrast`    | `regular`, `high`            | `regular` | Accessibility contrast level.                                                     |
+| `name`        | `modes`                      | `default` | Notes                                                                                                                                                        |
+| ------------- | ---------------------------- | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `colorScheme` | `light`, `dark`, `wireframe` | `light`   | Theme / appearance.                                                                                                                                          |
+| `scale`       | `desktop`, `mobile`          | `desktop` | Density scale. Legacy names; desktop = medium, mobile = large in W3C terminology.                                                                            |
+| `contrast`    | `regular`, `high`            | `regular` | Accessibility contrast level. iOS platform data authors `increased` as a synonym for `high` — treat the two as the same crosswalk term, not distinct values. |
 
 ## Mode Set catalog