@adobe/design-data-spec 4.11.0 → 4.12.0

package/package.json

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

package/schemas/component-spec-sheet.schema.json

@@ -154,21 +154,25 @@
           }
         },
         "markers": {
-          "description": "Numbered markers 1..n, one per group of token rows that share a recipe property template. `part` is the recipe part the marker sits on, or null when no recipe binding fits.",
+          "description": "Numbered markers 1..n, one per group of token rows that share a recipe property template. `part` is the recipe part the marker sits on, or null when no recipe binding fits. `drawn` is false when the visual has no node for the marker (no part, or the recipe does not draw it); its number stays on the rows and views note it as not drawn.",
           "type": "array",
           "items": {
             "type": "object",
-            "required": ["n", "part", "label"],
+            "required": ["n", "part", "label", "drawn"],
             "properties": {
               "n": { "type": "integer", "minimum": 1 },
               "part": { "type": ["string", "null"] },
-              "label": { "type": "string" }
+              "label": {
+                "description": "The group's relationship property with its size part dropped (the recipe's `{sizeIndex}`/`{size}` template without the placeholder). Distinct within a block.",
+                "type": "string"
+              },
+              "drawn": { "type": "boolean" }
             },
             "additionalProperties": false
           }
         },
         "measurements": {
-          "description": "Scene measurements the block shows on the Layout page: those whose relationship context is the block title (kinds `height`, `width`, `padding`, `gap`, `radius`, `border`, `focus-thickness`, `focus-gap`, `press`). A block renders in the states and options its bindings need (a focus ring in `keyboard-focus`, a pressed scale in `down`). `index` points into scene.measurements and `label` is the relationship property.",
+          "description": "Scene measurements the block shows on the Layout page: those whose relationship context is the block title (kinds `height`, `width`, `padding`, `gap`, `radius`, `border`, `focus-thickness`, `focus-gap`, `press`). A block renders in the states and options its bindings need (a focus ring in `keyboard-focus`, a pressed scale in `down`). `index` points into scene.measurements and `label` is the bound token's name, the same name the token rows show (the relationship property only when no token resolves).",
           "type": "array",
           "items": {
             "type": "object",

package/spec/component-changelog.md

@@ -32,7 +32,7 @@ A record's own `rationale` is copied into the entry when present. History comes
 | `documentation` | Descriptions, document blocks, rationale, relationship context text                                    |
 | `metadata`      | Legacy keys, ids, ordering, implementations, spec bookkeeping (summarized, not listed)                 |
 
-**Metadata-class changes are not entries.** Each commit records them as `metadata: {count, fields}`: how many changes, and which field paths changed (a record added or removed is named `<kind> <change>`, e.g. `implementation added`). They count as a patch.
+**Metadata-class changes are not entries.** Each commit records them as `metadata: {count, fields}`: how many changes, and which field paths changed (a record added or removed is named `<kind> <change>`, e.g. `implementation added`). They count as a patch. Removing a relationship whose exact twin survives (same scope, context and `$ref` or value) is metadata: nothing changes for consumers. Re-scoping a record (`scope.options` added or changed, same component, property, context and target) is an update, not a removal and an addition.
 
 In the committed file every entry, source and metadata summary is written on one line.