{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://designsystemdocspec.org/v0.15.2/common/token-overrides.schema.json",
"title": "Token overrides definition",
"description": "Shared token-override map used by anatomy parts, variant values, and states. Keys name the visual attribute; values reference the token used. Token references MUST name a documented token, never a raw value.",
"$defs": {
"tokenOverrides": {
"type": "object",
"minProperties": 1,
"description": "Token overrides for one part, variant value, or state. Keys name the visual attribute (ex: 'background', 'text-color', 'border-radius'); values are token `identifier` (ex: 'color-action-primary', 'radius-md'). When the system documents a token layer, each value MUST resolve to a documented token. Raw values (ex: '#ffffff', '4px') are not allowed here — token-less systems put those in design-specifications.",
"propertyNames": {
"pattern": "^[a-z][a-z0-9-]*$"
},
"additionalProperties": {
"$ref": "entity-ref.schema.json#/$defs/entityIdentifier"
},
"examples": [
{
"background": "color-action-primary",
"text-color": "color-text-on-action",
"border-radius": "radius-md"
}
]
}
}
}