@adobe/design-data-spec 4.8.1 → 4.9.0

package/schemas/component-visual.schema.json

@@ -0,0 +1,287 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://opensource.adobe.com/spectrum-design-data/schemas/v0/component-visual.schema.json",
+  "title": "Component visual recipe",
+  "description": "Layer 1 structural schema for a renderer-neutral component visual recipe (spec/component-visuals.md). Semantic rules (component exists, parts are declared anatomy, relationship selectors resolve) are Layer 2.",
+  "type": "object",
+  "required": ["component", "root", "parts"],
+  "properties": {
+    "$schema": {
+      "type": "string"
+    },
+    "$id": {
+      "type": "string"
+    },
+    "specVersion": {
+      "type": "string",
+      "const": "1.0.0-draft"
+    },
+    "component": {
+      "type": "string",
+      "pattern": "^[a-z][a-z0-9-]*$",
+      "description": "Name of the component declaration this recipe draws."
+    },
+    "root": {
+      "type": "string",
+      "pattern": "^[a-z][a-z0-9-]*$",
+      "description": "Key of the root part in `parts`."
+    },
+    "notVisual": {
+      "type": "array",
+      "items": { "type": "string", "pattern": "^[a-zA-Z][a-zA-Z0-9-]*$" },
+      "uniqueItems": true,
+      "description": "Options and states the component declares that deliberately have no visual in this recipe (SPEC-066). Each name MUST be a declared option or state of the component."
+    },
+    "sizeScale": {
+      "type": "object",
+      "description": "Maps each size option value to a numeric scale index, substituted for {sizeIndex} in selectors. Selectors may also use {size} and {<option>} for any declared option.",
+      "additionalProperties": {
+        "type": "integer",
+        "minimum": 0
+      }
+    },
+    "parts": {
+      "type": "object",
+      "minProperties": 1,
+      "propertyNames": {
+        "pattern": "^[a-z][a-z0-9-]*$"
+      },
+      "additionalProperties": {
+        "$ref": "#/$defs/part"
+      }
+    }
+  },
+  "additionalProperties": false,
+  "$defs": {
+    "part": {
+      "type": "object",
+      "required": ["kind"],
+      "properties": {
+        "kind": {
+          "enum": ["box", "text", "icon", "ring", "progress"]
+        },
+        "children": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "pattern": "^[a-z][a-z0-9-]*$"
+          },
+          "uniqueItems": true
+        },
+        "visibleWhen": {
+          "$ref": "#/$defs/condition"
+        },
+        "around": {
+          "type": "string",
+          "pattern": "^[a-z][a-z0-9-]*$",
+          "description": "For a ring: the part it outlines. Defaults to the root."
+        },
+        "glyph": {
+          "enum": ["checkmark", "dash", "chevron"],
+          "description": "For an icon nested in a box: the built-in glyph to draw. Unset draws a placeholder."
+        },
+        "pressTarget": {
+          "type": "string",
+          "pattern": "^[a-z][a-z0-9-]*$",
+          "description": "For the root: the part the press scale applies to, together with the parts nested inside it. Defaults to the whole scene."
+        },
+        "placement": {
+          "type": "object",
+          "required": ["anchor"],
+          "properties": {
+            "anchor": {
+              "enum": [
+                "top-start",
+                "top-end",
+                "bottom-start",
+                "bottom-end",
+                "center"
+              ]
+            },
+            "inset": {
+              "$ref": "#/$defs/valueSource"
+            }
+          },
+          "additionalProperties": false
+        },
+        "props": {
+          "type": "object",
+          "propertyNames": {
+            "enum": [
+              "direction",
+              "align",
+              "justify",
+              "gap",
+              "paddingInlineStart",
+              "paddingInlineEnd",
+              "paddingBlockStart",
+              "paddingBlockEnd",
+              "height",
+              "minWidth",
+              "width",
+              "cornerRadius",
+              "cornerRadiusStartStart",
+              "cornerRadiusStartEnd",
+              "cornerRadiusEndStart",
+              "cornerRadiusEndEnd",
+              "fill",
+              "stroke",
+              "strokeWidth",
+              "opacity",
+              "color",
+              "trackColor",
+              "fontFamily",
+              "fontSize",
+              "fontWeight",
+              "lineHeight",
+              "gapToParent",
+              "rotation",
+              "pressDifference",
+              "pressWidthRatio",
+              "pressMinPerspective",
+              "pressMaxPerspective"
+            ]
+          },
+          "additionalProperties": {
+            "oneOf": [
+              {
+                "$ref": "#/$defs/conditionalValueSource"
+              },
+              {
+                "type": "array",
+                "minItems": 1,
+                "items": {
+                  "$ref": "#/$defs/conditionalValueSource"
+                }
+              }
+            ]
+          }
+        }
+      },
+      "additionalProperties": false
+    },
+    "condition": {
+      "type": "object",
+      "properties": {
+        "options": {
+          "type": "object",
+          "additionalProperties": {
+            "oneOf": [
+              {
+                "type": ["string", "boolean", "number"]
+              },
+              {
+                "type": "array",
+                "minItems": 1,
+                "items": {
+                  "type": ["string", "boolean", "number"]
+                }
+              }
+            ]
+          }
+        },
+        "states": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "pattern": "^[a-z][a-z0-9-]*$"
+          },
+          "uniqueItems": true
+        },
+        "modes": {
+          "type": "object",
+          "additionalProperties": {
+            "type": "string"
+          }
+        }
+      },
+      "additionalProperties": false
+    },
+    "valueSource": {
+      "type": "object",
+      "oneOf": [
+        {
+          "required": ["value"],
+          "properties": {
+            "value": {}
+          },
+          "additionalProperties": false
+        },
+        {
+          "required": ["token"],
+          "properties": {
+            "token": {
+              "$ref": "#/$defs/tokenSelector"
+            }
+          },
+          "additionalProperties": false
+        },
+        {
+          "required": ["relationship"],
+          "properties": {
+            "relationship": {
+              "$ref": "#/$defs/relationshipSelector"
+            }
+          },
+          "additionalProperties": false
+        }
+      ]
+    },
+    "conditionalValueSource": {
+      "type": "object",
+      "properties": {
+        "when": {
+          "$ref": "#/$defs/condition"
+        },
+        "priority": {
+          "type": "integer"
+        },
+        "relativeTo": {
+          "enum": ["height"]
+        },
+        "value": {},
+        "token": {
+          "$ref": "#/$defs/tokenSelector"
+        },
+        "relationship": {
+          "$ref": "#/$defs/relationshipSelector"
+        }
+      },
+      "additionalProperties": false,
+      "oneOf": [
+        {
+          "required": ["value"]
+        },
+        {
+          "required": ["token"]
+        },
+        {
+          "required": ["relationship"]
+        }
+      ],
+      "description": "A value source with optional `when`, `priority` and `relativeTo`. Used alone or in an ordered list."
+    },
+    "tokenSelector": {
+      "type": "object",
+      "minProperties": 1,
+      "additionalProperties": {
+        "type": ["string", "number", "boolean"]
+      }
+    },
+    "relationshipSelector": {
+      "type": "object",
+      "required": ["property"],
+      "properties": {
+        "property": {
+          "type": "string",
+          "minLength": 1
+        },
+        "context": {
+          "type": "string",
+          "minLength": 1
+        }
+      },
+      "additionalProperties": false
+    }
+  }
+}

package/schemas/component.schema.json

@@ -47,6 +47,13 @@
     "options": {
       "$ref": "#/$defs/optionsMap"
     },
+    "constraints": {
+      "type": "array",
+      "items": {
+        "$ref": "#/$defs/optionConstraint"
+      },
+      "description": "Rules restricting which option value combinations are valid. See spec/option-constraints.md."
+    },
     "slots": {
       "type": "array",
       "items": {
@@ -61,6 +68,20 @@
       },
       "description": "Named visible parts of the component. Full spec in spec/anatomy-format.md (Phase 6.2)."
     },
+    "anatomyReview": {
+      "type": "object",
+      "required": ["status"],
+      "properties": {
+        "status": { "enum": ["draft", "reviewed"] },
+        "reviewedIn": {
+          "type": "string",
+          "description": "Version in which the anatomy was last reviewed against the anatomy definition."
+        },
+        "notes": { "type": "string" }
+      },
+      "additionalProperties": false,
+      "description": "Review status of this component's anatomy. Absent means draft. See spec/anatomy-format.md#review-checklist."
+    },
     "states": {
       "type": "array",
       "items": {
@@ -157,6 +178,54 @@
         "$ref": "#/$defs/optionDescriptor"
       }
     },
+    "optionConstraint": {
+      "type": "object",
+      "description": "If-then rule over option values. Layer 1 checks shape only; that names and values are declared in `options` is Layer 2.",
+      "required": ["when", "require", "severity"],
+      "properties": {
+        "when": {
+          "type": "object",
+          "minProperties": 1,
+          "additionalProperties": {
+            "oneOf": [
+              { "type": ["string", "number", "boolean"] },
+              {
+                "type": "array",
+                "minItems": 1,
+                "items": { "type": ["string", "number", "boolean"] }
+              }
+            ]
+          },
+          "description": "Option conditions (ANDed). A literal matches that value; an array matches any of its values."
+        },
+        "require": {
+          "type": "object",
+          "minProperties": 1,
+          "additionalProperties": {
+            "oneOf": [
+              {
+                "type": "array",
+                "minItems": 1,
+                "items": { "type": ["string", "number", "boolean"] }
+              },
+              {
+                "type": "object",
+                "required": ["present"],
+                "properties": { "present": { "type": "boolean" } },
+                "additionalProperties": false
+              }
+            ]
+          },
+          "description": "What matching combinations must satisfy: permitted values, or { present } for presence."
+        },
+        "severity": {
+          "enum": ["error", "advisory"]
+        },
+        "description": { "type": "string" },
+        "source": { "type": "string" }
+      },
+      "additionalProperties": false
+    },
     "optionDescriptor": {
       "type": "object",
       "description": "Descriptor for a single component option. The `type` keyword follows JSON Schema conventions. Use `values` (not `enum`) to declare permitted values — the structured array allows per-value lifecycle metadata. Other JSON Schema keywords (default, description, pattern, minimum, maximum, items, properties, $ref) are permitted as needed.",
@@ -273,6 +342,12 @@
           "type": "boolean",
           "default": false
         },
+        "presentIn": {
+          "type": "array",
+          "items": { "type": "string" },
+          "uniqueItems": true,
+          "description": "Declared component states in which this part is present; drawn when any is active. Absent means any state. Not for state-dependent styling."
+        },
         "contains": {
           "type": "array",
           "items": { "type": "string" },
@@ -288,6 +363,11 @@
           "description": "Version lifecycle metadata for this anatomy part. Set lifecycle.deprecatedIn to signal that tokens referencing this part should migrate."
         }
       },
+      "if": {
+        "required": ["required"],
+        "properties": { "required": { "const": true } }
+      },
+      "then": { "not": { "required": ["presentIn"] } },
       "additionalProperties": false
     },
     "stateDeclaration": {

package/schemas/manifest.schema.json

@@ -103,6 +103,11 @@
       "minLength": 1,
       "description": "Path (relative to the manifest) to the platform's extensions directory, holding platform-local tokens/components/fields/relationships/guidelines/platform-extensions as one file per artifact (see spec/manifest.md#extensions-directory). Default: \"extensions\"."
     },
+    "componentAliases": {
+      "type": "object",
+      "description": "Maps a foundation component name to a component the platform declares in extensions/components/. Applies to render, site, WASM render and recipe lookup only (see spec/manifest.md#componentaliases; SPEC-081).",
+      "additionalProperties": { "type": "string", "minLength": 1 }
+    },
     "namingExceptions": {
       "type": "object",
       "description": "Platform-local overlay on the base naming-exceptions set: names to add and/or remove for this platform's naming validation.",

package/schemas/relationship.schema.json

@@ -64,7 +64,7 @@
         },
         "options": {
           "type": "object",
-          "description": "Option-scoped narrowing (e.g. variant, size, style, arbitrary component option keys). Each key's value MUST validate against the referenced component's options.<key>.values (SPEC-053), except `state`, which is an ordered array of atomic state ids validated against the component's declared states (SPEC-054).",
+          "description": "Option-scoped narrowing (e.g. variant, size, style, arbitrary component option keys). Each string value MUST validate against the referenced component's options.<key>.values (SPEC-053); a boolean option (for example isSelected) takes `true` or `false`; an array matches when any listed value matches. `state` is the exception: an ordered array of atomic state ids validated against the component's declared states (SPEC-054).",
           "properties": {
             "state": {
               "type": "array",
@@ -77,7 +77,9 @@
             }
           },
           "additionalProperties": {
-            "type": "string"
+            "type": ["string", "boolean", "array"],
+            "items": { "type": ["string", "boolean"] },
+            "minItems": 1
           }
         }
       },
@@ -85,7 +87,7 @@
     },
     "ctrWithValue": {
       "type": "object",
-      "required": ["scope", "value"],
+      "required": ["scope", "value", "uuid"],
       "not": {
         "required": ["$ref"]
       },
@@ -123,7 +125,7 @@
         "uuid": {
           "type": "string",
           "format": "uuid",
-          "description": "MUST be globally unique across all relationship entries in the same layer (SPEC-056)."
+          "description": "Required stable identity (SPEC-084). MUST be globally unique across all relationship entries in the same layer (SPEC-056) and never change once assigned."
         },
         "lifecycle": {
           "$ref": "#/$defs/lifecycle"
@@ -155,7 +157,7 @@
     },
     "ctrWithRef": {
       "type": "object",
-      "required": ["scope", "$ref"],
+      "required": ["scope", "$ref", "uuid"],
       "not": {
         "required": ["value"]
       },
@@ -187,7 +189,7 @@
         "uuid": {
           "type": "string",
           "format": "uuid",
-          "description": "MUST be globally unique across all relationship entries in the same layer (SPEC-056)."
+          "description": "Required stable identity (SPEC-084). MUST be globally unique across all relationship entries in the same layer (SPEC-056) and never change once assigned."
         },
         "lifecycle": {
           "$ref": "#/$defs/lifecycle"

package/spec/anatomy-format.md

@@ -19,6 +19,7 @@ An anatomy part is a **JSON object** that appears as an element of a component d
 | `name`        | string           | REQUIRED | Kebab-case identifier. **MUST** match the pattern `^[a-z][a-z0-9-]*$`.                                                   |
 | `description` | string           | OPTIONAL | Plain-text description of the part's visual role and boundaries.                                                         |
 | `required`    | boolean          | OPTIONAL | Whether this part is always rendered regardless of configuration. Default: `false`.                                      |
+| `presentIn`   | array of strings | OPTIONAL | Declared component states in which the part is present. Absent means any state — see [`presentIn`](#presentin).          |
 | `contains`    | array of strings | OPTIONAL | Informative list of child anatomy part names nested within this part (e.g. a `field` contains `["label", "help-text"]`). |
 | `lifecycle`   | object           | OPTIONAL | Version lifecycle metadata for this anatomy part — see [lifecycle](#lifecycle).                                          |
 
@@ -78,6 +79,89 @@ Each string in `contains` **MUST** match the pattern `^[a-z][a-z0-9-]*$`. Refere
 ]
 ```
 
+## What is an anatomy part
+
+Anatomy describes a component in terms a designer on any platform would recognize. It is not a description of how one renderer builds the component.
+
+**NORMATIVE:** A part **MUST** be both:
+
+1. **Visible**: it draws something (a fill, border, mark, glyph or text) in at least one state or configuration the component declares.
+2. **Styled on its own**: at least one visual property belongs to it alone, whether a token, a relationship context, or a fixed design decision. A visible piece with nothing of its own to style belongs to its parent.
+
+A token is not required. A part with only fixed decisions (a corner triangle, say) still counts.
+
+### State-only parts
+
+A part that appears only in some interaction states (the focus indicator) belongs in the default anatomy, because it is part of the component's design. Mark it with `presentIn`. A part driven by an option instead (a checkmark while selected, a progress circle while pending) is simply optional; the visual recipe says when it shows with `visibleWhen.options`.
+
+#### `presentIn`
+
+**OPTIONAL.** A list of declared component state names in which the part is present. The part is drawn when **any** listed state is active, and not otherwise. Absent means the part can appear in any state. Each entry **MUST** match a `states[].name` declared on the same component (rule SPEC-074), and for a part that also appears in a visual recipe, the recipe's `visibleWhen.states` **MUST** agree (rule SPEC-075). Conditions on options stay in the visual recipe; `presentIn` is only for state names.
+
+`presentIn` says whether a part is present, not how it is styled. A color, border or size that changes with a state (a hover fill, a down scale) is not presence: it belongs in the relationships and the recipe, and **MUST NOT** be recorded on the part.
+
+**NORMATIVE:** A part with `presentIn` **MUST NOT** also be `required: true`, because a required part is present in every state. Layer 1 rejects the combination.
+
+State names follow the state registry. Use `focus` for the focus state.
+
+### Naming
+
+**NORMATIVE:** Part names **MUST** be general and platform-neutral:
+
+* Use a registry term (`anatomy-terms.json`) when one fits. Otherwise use a new name with a `description` (SPEC-023, SPEC-035).
+* Use a singular noun in kebab-case.
+* Name the part for its role, not its shape or construction: `focus-indicator`, not `ring` or `outline`.
+* Do not use platform words (`wrapper`, `slot`, `host`, `root`, `view`, `pseudo`).
+* Do not repeat the component name (`label`, not `button-label`).
+
+### Nesting
+
+**NORMATIVE:** `contains` **MUST** describe visual enclosure: the parent visibly bounds its children, or its own styling (background, padding, border) frames them. It **MUST NOT** record DOM or layout nesting. A part has at most one parent. A state-only part may be contained by the part it surrounds.
+
+### Required and optional
+
+**NORMATIVE:** `required: true` means the part is drawn in every configuration and every declared state. A part that an option can remove (an icon, a label hidden in an icon-only layout) is optional.
+
+### What is not anatomy
+
+The following **MUST NOT** be declared as parts:
+
+* Platform wrappers and hosts.
+* Layout helpers: gaps, spacers, alignment boxes, stacks.
+* Hit areas and accessibility-only elements: hidden inputs, live regions, hidden text.
+* Elements that exist only so one renderer works: clip layers, pseudo-elements, a second element used to fake a border.
+* A grouping that has no style of its own, such as a `control` that only wraps a `box` and a `checkmark`.
+
+Another component shown inside this one (for example the progress circle in a button) is a part only when the host component styles it as its own role.
+
+### Review checklist
+
+Anatomy is hand-written and has to be reviewed against this chapter before recipes depend on it. For each part:
+
+1. Is it visible in at least one declared state or option?
+2. Does it have a style of its own?
+3. Would someone on web, iOS, Android and in Figma recognize it without explanation?
+4. Is it free of anything that exists only to make one renderer work?
+5. Does its name follow the naming rules, using a registry term when one fits?
+6. Is `required` correct for every configuration and every state?
+7. Does `presentIn` list every state the part is present in, and only those? (Required for state-only parts.) Is any state-dependent styling kept off the part?
+8. Does each `contains` entry describe visual enclosure?
+
+For the component:
+
+9. Does every token `name.anatomy` and every relationship context part resolve to a declared part, with no orphan parts?
+10. Is every visible piece with its own style declared? Check against the guidelines and states, not one platform's code.
+
+### `anatomyReview`
+
+The component declaration carries the review result next to `anatomy`:
+
+```json
+"anatomyReview": { "status": "reviewed", "reviewedIn": "1.0.0-draft", "notes": "Dropped control; focus-indicator now state-only." }
+```
+
+`status` is `draft` or `reviewed`. A component with anatomy and no `anatomyReview` is `draft`. A recipe **SHOULD** only depend on `reviewed` anatomy. Rule SPEC-073 reports, at info level, the components that have relationships but no anatomy and those whose anatomy is still `draft`.
+
 ## Canonical anatomy vocabulary
 
 The following anatomy part names are defined by the cross-platform design audit and **SHOULD** be used in preference to custom names when their semantics match. Using canonical names enables cross-component tooling, documentation generation, and token audits.
@@ -101,7 +185,7 @@ The following anatomy part names are defined by the cross-platform design audit
 
 Custom part names are permitted. When a custom name is used, the anatomy part object **SHOULD** include a `description` field explaining its visual role (rule SPEC-023).
 
-The table above is informative; the authoritative vocabulary is `@adobe/spectrum-design-data/registry/anatomy-terms.json` (119 entries). SPEC-035 fires advisory warnings when a declared anatomy part `name` is not in that registry, pointing authors at the canonical list. Custom names remain valid — SPEC-035 is advisory, not an error.
+The table above is informative; the authoritative vocabulary is `@adobe/spectrum-design-data/registry/anatomy-terms.json` (140 entries). SPEC-035 fires advisory warnings when a declared anatomy part `name` is not in that registry, pointing authors at the canonical list. Custom names remain valid — SPEC-035 is advisory, not an error.
 
 ## Cross-reference with token name objects
 
@@ -129,15 +213,18 @@ See [Token format — Name object](token-format.md#name-object) for the full nam
 
 The following rules in the Layer 2 rule catalog (`rules/rules.yaml`) apply to anatomy part declarations. SPEC-020 was introduced in Phase 6.1 (component-format); SPEC-023, SPEC-024, and SPEC-025 are introduced by this chapter.
 
-| Rule ID  | Name                              | Severity | Assert                                                                                                                                                    |
-| -------- | --------------------------------- | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| SPEC-020 | `component-anatomy-valid`         | error    | Token `anatomy` field value **MUST** match the `name` of a declared anatomy part on the referenced component.                                             |
-| SPEC-023 | `anatomy-custom-part-documented`  | warning  | Anatomy part declarations with a `name` outside the canonical anatomy vocabulary **SHOULD** include a `description` field documenting the part's purpose. |
-| SPEC-024 | `anatomy-part-name-unique`        | error    | Anatomy part `name` values **MUST** be unique within a single component's `anatomy` array.                                                                |
-| SPEC-025 | `anatomy-requires-component`      | error    | A token name object **MUST NOT** include an `anatomy` field unless a `component` field is also present.                                                   |
-| SPEC-035 | `anatomy-part-name-registry-sync` | warning  | A component anatomy part's `name` **SHOULD** appear in the canonical anatomy-terms registry (`anatomy-terms.json`).                                       |
-| SPEC-037 | `sub-entity-deprecation-cascade`  | warning  | A non-deprecated token **SHOULD NOT** reference a deprecated anatomy part via `name.anatomy`. Advisory warning prompts migration.                         |
-| SPEC-048 | `anatomy-contains-resolves`       | warning  | An anatomy part's `contains` entries **SHOULD** match the `name` of another part declared on the same component. Advisory warning for unresolved entries. |
+| Rule ID  | Name                                | Severity | Assert                                                                                                                                                                                                                     |
+| -------- | ----------------------------------- | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| SPEC-020 | `component-anatomy-valid`           | error    | Token `anatomy` field value **MUST** match the `name` of a declared anatomy part on the referenced component.                                                                                                              |
+| SPEC-023 | `anatomy-custom-part-documented`    | warning  | Anatomy part declarations with a `name` outside the canonical anatomy vocabulary **SHOULD** include a `description` field documenting the part's purpose.                                                                  |
+| SPEC-024 | `anatomy-part-name-unique`          | error    | Anatomy part `name` values **MUST** be unique within a single component's `anatomy` array.                                                                                                                                 |
+| SPEC-025 | `anatomy-requires-component`        | error    | A token name object **MUST NOT** include an `anatomy` field unless a `component` field is also present.                                                                                                                    |
+| SPEC-035 | `anatomy-part-name-registry-sync`   | warning  | A component anatomy part's `name` **SHOULD** appear in the canonical anatomy-terms registry (`anatomy-terms.json`).                                                                                                        |
+| SPEC-037 | `sub-entity-deprecation-cascade`    | warning  | A non-deprecated token **SHOULD NOT** reference a deprecated anatomy part via `name.anatomy`. Advisory warning prompts migration.                                                                                          |
+| SPEC-048 | `anatomy-contains-resolves`         | warning  | An anatomy part's `contains` entries **SHOULD** match the `name` of another part declared on the same component. Advisory warning for unresolved entries.                                                                  |
+| SPEC-073 | `component-anatomy-reviewed`        | info     | A component with relationships **SHOULD** declare anatomy, and its anatomy **SHOULD** be `reviewed` (see [`anatomyReview`](#anatomyreview)). One report for the whole dataset.                                             |
+| SPEC-074 | `anatomy-present-in-declared`       | error    | Every `presentIn` entry **MUST** match a state declared on the component, after state-name normalization (`focus`, `key-focus` and `keyboard-focus` are one state).                                                        |
+| SPEC-075 | `visual-present-in-matches-anatomy` | error    | A recipe part's `visibleWhen.states` **MUST** agree with the `presentIn` of the anatomy part of the same name. Info when either lists more than one state, since `visibleWhen.states` means all and `presentIn` means any. |
 
 ## Full example