@aloudata/aloudata-design 3.1.0 → 3.1.2

package/dist/governance/semantic.json

@@ -0,0 +1,1737 @@
+{
+  "schemaVersion": "1.0.0",
+  "semanticGovernanceArtifactVersion": "1.0.0",
+  "packageCompatibility": {
+    "minimumPackageVersion": "3.1.0",
+    "maximumExclusivePackageVersion": "4.0.0"
+  },
+  "tokenOutputContract": {
+    "entryCount": 122,
+    "identitySetFingerprint": "fnv1a32:85cdb09a",
+    "referencedTokenCount": 106
+  },
+  "provenance": [
+    {
+      "id": "token-output-contract",
+      "authorityDocument": "src/theme/contract/tokenOutputContract.ts",
+      "authorityLocator": "tokenOutputContractEntries",
+      "authorityStatus": "Accepted",
+      "governanceVersion": "current-token-output-contract"
+    },
+    {
+      "id": "neutral-architecture-23a",
+      "authorityDocument": "docs/color-system/23A-neutral-color-architecture-decision.md",
+      "authorityLocator": "Sections 8-9",
+      "authorityStatus": "Accepted",
+      "governanceVersion": "23A"
+    },
+    {
+      "id": "semantic-knowledge-decision-26",
+      "authorityDocument": "docs/color-system/26-semantic-governance-knowledge-delivery-decision.md",
+      "authorityLocator": "Sections 5-14",
+      "authorityStatus": "Accepted",
+      "governanceVersion": "26"
+    },
+    {
+      "id": "semantic-knowledge-specification-27",
+      "authorityDocument": "docs/color-system/27-semantic-governance-knowledge-delivery-specification.md",
+      "authorityLocator": "Sections 6-14",
+      "authorityStatus": "Accepted",
+      "governanceVersion": "27"
+    }
+  ],
+  "tokenFacts": [
+    {
+      "token": "--action-primary-normal",
+      "role": "action",
+      "family": "action-primary",
+      "state": "normal",
+      "lifecycle": "active",
+      "provenance": [
+        "token-output-contract",
+        "semantic-knowledge-decision-26"
+      ]
+    },
+    {
+      "token": "--action-primary-hover",
+      "role": "action",
+      "family": "action-primary",
+      "state": "hover",
+      "lifecycle": "active",
+      "provenance": [
+        "token-output-contract",
+        "semantic-knowledge-decision-26"
+      ]
+    },
+    {
+      "token": "--action-primary-active",
+      "role": "action",
+      "family": "action-primary",
+      "state": "active",
+      "lifecycle": "active",
+      "provenance": [
+        "token-output-contract",
+        "semantic-knowledge-decision-26"
+      ]
+    },
+    {
+      "token": "--action-primary-selected",
+      "role": "action",
+      "family": "action-primary",
+      "state": "selected",
+      "lifecycle": "active",
+      "provenance": [
+        "token-output-contract",
+        "semantic-knowledge-decision-26"
+      ]
+    },
+    {
+      "token": "--action-primary-subtle-normal",
+      "role": "action",
+      "family": "action-primary-subtle",
+      "state": "normal",
+      "lifecycle": "active",
+      "provenance": [
+        "token-output-contract",
+        "semantic-knowledge-decision-26"
+      ]
+    },
+    {
+      "token": "--action-primary-subtle-hover",
+      "role": "action",
+      "family": "action-primary-subtle",
+      "state": "hover",
+      "lifecycle": "active",
+      "provenance": [
+        "token-output-contract",
+        "semantic-knowledge-decision-26"
+      ]
+    },
+    {
+      "token": "--action-primary-subtle-active",
+      "role": "action",
+      "family": "action-primary-subtle",
+      "state": "active",
+      "lifecycle": "active",
+      "provenance": [
+        "token-output-contract",
+        "semantic-knowledge-decision-26"
+      ]
+    },
+    {
+      "token": "--action-primary-subtle-selected",
+      "role": "action",
+      "family": "action-primary-subtle",
+      "state": "selected",
+      "lifecycle": "active",
+      "provenance": [
+        "token-output-contract",
+        "semantic-knowledge-decision-26"
+      ]
+    },
+    {
+      "token": "--action-neutral-normal",
+      "role": "action",
+      "family": "action-neutral",
+      "state": "normal",
+      "lifecycle": "active",
+      "provenance": [
+        "token-output-contract",
+        "semantic-knowledge-decision-26"
+      ]
+    },
+    {
+      "token": "--action-neutral-hover",
+      "role": "action",
+      "family": "action-neutral",
+      "state": "hover",
+      "lifecycle": "active",
+      "provenance": [
+        "token-output-contract",
+        "semantic-knowledge-decision-26"
+      ]
+    },
+    {
+      "token": "--action-neutral-active",
+      "role": "action",
+      "family": "action-neutral",
+      "state": "active",
+      "lifecycle": "active",
+      "provenance": [
+        "token-output-contract",
+        "semantic-knowledge-decision-26"
+      ]
+    },
+    {
+      "token": "--action-neutral-selected",
+      "role": "action",
+      "family": "action-neutral",
+      "state": "selected",
+      "lifecycle": "active",
+      "provenance": [
+        "token-output-contract",
+        "semantic-knowledge-decision-26"
+      ]
+    },
+    {
+      "token": "--action-neutral-subtle-normal",
+      "role": "action",
+      "family": "action-neutral-subtle",
+      "state": "normal",
+      "lifecycle": "active",
+      "provenance": [
+        "token-output-contract",
+        "semantic-knowledge-decision-26"
+      ]
+    },
+    {
+      "token": "--action-neutral-subtle-hover",
+      "role": "action",
+      "family": "action-neutral-subtle",
+      "state": "hover",
+      "lifecycle": "active",
+      "provenance": [
+        "token-output-contract",
+        "semantic-knowledge-decision-26"
+      ]
+    },
+    {
+      "token": "--action-neutral-subtle-active",
+      "role": "action",
+      "family": "action-neutral-subtle",
+      "state": "active",
+      "lifecycle": "active",
+      "provenance": [
+        "token-output-contract",
+        "semantic-knowledge-decision-26"
+      ]
+    },
+    {
+      "token": "--action-neutral-subtle-selected",
+      "role": "action",
+      "family": "action-neutral-subtle",
+      "state": "selected",
+      "lifecycle": "active",
+      "provenance": [
+        "token-output-contract",
+        "semantic-knowledge-decision-26"
+      ]
+    },
+    {
+      "token": "--action-destructive-normal",
+      "role": "action",
+      "family": "action-destructive",
+      "state": "normal",
+      "lifecycle": "active",
+      "provenance": [
+        "token-output-contract",
+        "semantic-knowledge-decision-26"
+      ]
+    },
+    {
+      "token": "--action-destructive-hover",
+      "role": "action",
+      "family": "action-destructive",
+      "state": "hover",
+      "lifecycle": "active",
+      "provenance": [
+        "token-output-contract",
+        "semantic-knowledge-decision-26"
+      ]
+    },
+    {
+      "token": "--action-destructive-active",
+      "role": "action",
+      "family": "action-destructive",
+      "state": "active",
+      "lifecycle": "active",
+      "provenance": [
+        "token-output-contract",
+        "semantic-knowledge-decision-26"
+      ]
+    },
+    {
+      "token": "--action-destructive-selected",
+      "role": "action",
+      "family": "action-destructive",
+      "state": "selected",
+      "lifecycle": "active",
+      "provenance": [
+        "token-output-contract",
+        "semantic-knowledge-decision-26"
+      ]
+    },
+    {
+      "token": "--action-destructive-subtle-normal",
+      "role": "action",
+      "family": "action-destructive-subtle",
+      "state": "normal",
+      "lifecycle": "active",
+      "provenance": [
+        "token-output-contract",
+        "semantic-knowledge-decision-26"
+      ]
+    },
+    {
+      "token": "--action-destructive-subtle-hover",
+      "role": "action",
+      "family": "action-destructive-subtle",
+      "state": "hover",
+      "lifecycle": "active",
+      "provenance": [
+        "token-output-contract",
+        "semantic-knowledge-decision-26"
+      ]
+    },
+    {
+      "token": "--action-destructive-subtle-active",
+      "role": "action",
+      "family": "action-destructive-subtle",
+      "state": "active",
+      "lifecycle": "active",
+      "provenance": [
+        "token-output-contract",
+        "semantic-knowledge-decision-26"
+      ]
+    },
+    {
+      "token": "--action-destructive-subtle-selected",
+      "role": "action",
+      "family": "action-destructive-subtle",
+      "state": "selected",
+      "lifecycle": "active",
+      "provenance": [
+        "token-output-contract",
+        "semantic-knowledge-decision-26"
+      ]
+    },
+    {
+      "token": "--action-ghost-normal",
+      "role": "action",
+      "family": "action-ghost",
+      "state": "normal",
+      "lifecycle": "active",
+      "provenance": [
+        "token-output-contract",
+        "semantic-knowledge-decision-26"
+      ]
+    },
+    {
+      "token": "--action-ghost-hover",
+      "role": "action",
+      "family": "action-ghost",
+      "state": "hover",
+      "lifecycle": "active",
+      "provenance": [
+        "token-output-contract",
+        "semantic-knowledge-decision-26"
+      ]
+    },
+    {
+      "token": "--action-ghost-active",
+      "role": "action",
+      "family": "action-ghost",
+      "state": "active",
+      "lifecycle": "active",
+      "provenance": [
+        "token-output-contract",
+        "semantic-knowledge-decision-26"
+      ]
+    },
+    {
+      "token": "--action-ghost-selected",
+      "role": "action",
+      "family": "action-ghost",
+      "state": "selected",
+      "lifecycle": "active",
+      "provenance": [
+        "token-output-contract",
+        "semantic-knowledge-decision-26"
+      ]
+    },
+    {
+      "token": "--action-ghost-inverted-hover",
+      "role": "action",
+      "family": "action-ghost-inverted",
+      "state": "hover",
+      "lifecycle": "active",
+      "provenance": [
+        "token-output-contract",
+        "semantic-knowledge-decision-26"
+      ]
+    },
+    {
+      "token": "--action-ghost-inverted-active",
+      "role": "action",
+      "family": "action-ghost-inverted",
+      "state": "active",
+      "lifecycle": "active",
+      "provenance": [
+        "token-output-contract",
+        "semantic-knowledge-decision-26"
+      ]
+    },
+    {
+      "token": "--action-ghost-inverted-selected",
+      "role": "action",
+      "family": "action-ghost-inverted",
+      "state": "selected",
+      "lifecycle": "active",
+      "provenance": [
+        "token-output-contract",
+        "semantic-knowledge-decision-26"
+      ]
+    },
+    {
+      "token": "--action-ghost-destructive-hover",
+      "role": "action",
+      "family": "action-ghost-destructive",
+      "state": "hover",
+      "lifecycle": "active",
+      "provenance": [
+        "token-output-contract",
+        "semantic-knowledge-decision-26"
+      ]
+    },
+    {
+      "token": "--action-ghost-destructive-active",
+      "role": "action",
+      "family": "action-ghost-destructive",
+      "state": "active",
+      "lifecycle": "active",
+      "provenance": [
+        "token-output-contract",
+        "semantic-knowledge-decision-26"
+      ]
+    },
+    {
+      "token": "--action-ghost-destructive-selected",
+      "role": "action",
+      "family": "action-ghost-destructive",
+      "state": "selected",
+      "lifecycle": "active",
+      "provenance": [
+        "token-output-contract",
+        "semantic-knowledge-decision-26"
+      ]
+    },
+    {
+      "token": "--action-inverted-normal",
+      "role": "action",
+      "family": "action-inverted",
+      "state": "normal",
+      "lifecycle": "active",
+      "provenance": [
+        "token-output-contract",
+        "semantic-knowledge-decision-26"
+      ]
+    },
+    {
+      "token": "--action-inverted-hover",
+      "role": "action",
+      "family": "action-inverted",
+      "state": "hover",
+      "lifecycle": "active",
+      "provenance": [
+        "token-output-contract",
+        "semantic-knowledge-decision-26"
+      ]
+    },
+    {
+      "token": "--action-inverted-active",
+      "role": "action",
+      "family": "action-inverted",
+      "state": "active",
+      "lifecycle": "active",
+      "provenance": [
+        "token-output-contract",
+        "semantic-knowledge-decision-26"
+      ]
+    },
+    {
+      "token": "--action-inverted-selected",
+      "role": "action",
+      "family": "action-inverted",
+      "state": "selected",
+      "lifecycle": "active",
+      "provenance": [
+        "token-output-contract",
+        "semantic-knowledge-decision-26"
+      ]
+    },
+    {
+      "token": "--background-default",
+      "role": "background",
+      "lifecycle": "active",
+      "provenance": [
+        "token-output-contract",
+        "semantic-knowledge-decision-26"
+      ]
+    },
+    {
+      "token": "--background-inverted",
+      "role": "background",
+      "family": "inverted",
+      "lifecycle": "active",
+      "provenance": [
+        "token-output-contract",
+        "semantic-knowledge-decision-26"
+      ]
+    },
+    {
+      "token": "--background-mask",
+      "role": "background",
+      "lifecycle": "active",
+      "provenance": [
+        "token-output-contract",
+        "semantic-knowledge-decision-26"
+      ]
+    },
+    {
+      "token": "--background-brand-muted",
+      "role": "background",
+      "family": "brand",
+      "lifecycle": "active",
+      "provenance": [
+        "token-output-contract",
+        "semantic-knowledge-decision-26"
+      ]
+    },
+    {
+      "token": "--background-brand-on-subtle",
+      "role": "background",
+      "family": "brand",
+      "lifecycle": "active",
+      "provenance": [
+        "token-output-contract",
+        "semantic-knowledge-decision-26"
+      ]
+    },
+    {
+      "token": "--background-brand-strong",
+      "role": "background",
+      "family": "brand",
+      "lifecycle": "active",
+      "provenance": [
+        "token-output-contract",
+        "semantic-knowledge-decision-26"
+      ]
+    },
+    {
+      "token": "--background-neutral-hard",
+      "role": "background",
+      "family": "neutral-structural",
+      "lifecycle": "active",
+      "provenance": [
+        "token-output-contract",
+        "semantic-knowledge-decision-26"
+      ]
+    },
+    {
+      "token": "--background-neutral-muted",
+      "role": "background",
+      "family": "neutral-structural",
+      "lifecycle": "active",
+      "provenance": [
+        "token-output-contract",
+        "semantic-knowledge-decision-26"
+      ]
+    },
+    {
+      "token": "--background-neutral-on-subtle",
+      "role": "background",
+      "family": "neutral-structural",
+      "lifecycle": "active",
+      "provenance": [
+        "token-output-contract",
+        "semantic-knowledge-decision-26"
+      ]
+    },
+    {
+      "token": "--background-neutral-strong",
+      "role": "background",
+      "family": "neutral-structural",
+      "lifecycle": "active",
+      "provenance": [
+        "token-output-contract",
+        "semantic-knowledge-decision-26"
+      ]
+    },
+    {
+      "token": "--background-neutral-subtle",
+      "role": "background",
+      "family": "neutral-structural",
+      "lifecycle": "active",
+      "provenance": [
+        "token-output-contract",
+        "semantic-knowledge-decision-26"
+      ]
+    },
+    {
+      "token": "--background-neutral-surface",
+      "role": "background",
+      "family": "neutral-structural",
+      "lifecycle": "active",
+      "provenance": [
+        "token-output-contract",
+        "semantic-knowledge-decision-26"
+      ]
+    },
+    {
+      "token": "--background-informative-muted",
+      "role": "background",
+      "family": "informative",
+      "lifecycle": "active",
+      "provenance": [
+        "token-output-contract",
+        "semantic-knowledge-decision-26"
+      ]
+    },
+    {
+      "token": "--background-informative-on-subtle",
+      "role": "background",
+      "family": "informative",
+      "lifecycle": "active",
+      "provenance": [
+        "token-output-contract",
+        "semantic-knowledge-decision-26"
+      ]
+    },
+    {
+      "token": "--background-informative-strong",
+      "role": "background",
+      "family": "informative",
+      "lifecycle": "active",
+      "provenance": [
+        "token-output-contract",
+        "semantic-knowledge-decision-26"
+      ]
+    },
+    {
+      "token": "--background-informative-subtle",
+      "role": "background",
+      "family": "informative",
+      "lifecycle": "active",
+      "provenance": [
+        "token-output-contract",
+        "semantic-knowledge-decision-26"
+      ]
+    },
+    {
+      "token": "--background-informative-surface",
+      "role": "background",
+      "family": "informative",
+      "lifecycle": "active",
+      "provenance": [
+        "token-output-contract",
+        "semantic-knowledge-decision-26"
+      ]
+    },
+    {
+      "token": "--background-positive-muted",
+      "role": "background",
+      "family": "positive",
+      "lifecycle": "active",
+      "provenance": [
+        "token-output-contract",
+        "semantic-knowledge-decision-26"
+      ]
+    },
+    {
+      "token": "--background-positive-on-subtle",
+      "role": "background",
+      "family": "positive",
+      "lifecycle": "active",
+      "provenance": [
+        "token-output-contract",
+        "semantic-knowledge-decision-26"
+      ]
+    },
+    {
+      "token": "--background-positive-strong",
+      "role": "background",
+      "family": "positive",
+      "lifecycle": "active",
+      "provenance": [
+        "token-output-contract",
+        "semantic-knowledge-decision-26"
+      ]
+    },
+    {
+      "token": "--background-positive-subtle",
+      "role": "background",
+      "family": "positive",
+      "lifecycle": "active",
+      "provenance": [
+        "token-output-contract",
+        "semantic-knowledge-decision-26"
+      ]
+    },
+    {
+      "token": "--background-positive-surface",
+      "role": "background",
+      "family": "positive",
+      "lifecycle": "active",
+      "provenance": [
+        "token-output-contract",
+        "semantic-knowledge-decision-26"
+      ]
+    },
+    {
+      "token": "--background-warning-muted",
+      "role": "background",
+      "family": "warning",
+      "lifecycle": "active",
+      "provenance": [
+        "token-output-contract",
+        "semantic-knowledge-decision-26"
+      ]
+    },
+    {
+      "token": "--background-warning-on-subtle",
+      "role": "background",
+      "family": "warning",
+      "lifecycle": "active",
+      "provenance": [
+        "token-output-contract",
+        "semantic-knowledge-decision-26"
+      ]
+    },
+    {
+      "token": "--background-warning-strong",
+      "role": "background",
+      "family": "warning",
+      "lifecycle": "active",
+      "provenance": [
+        "token-output-contract",
+        "semantic-knowledge-decision-26"
+      ]
+    },
+    {
+      "token": "--background-warning-subtle",
+      "role": "background",
+      "family": "warning",
+      "lifecycle": "active",
+      "provenance": [
+        "token-output-contract",
+        "semantic-knowledge-decision-26"
+      ]
+    },
+    {
+      "token": "--background-warning-surface",
+      "role": "background",
+      "family": "warning",
+      "lifecycle": "active",
+      "provenance": [
+        "token-output-contract",
+        "semantic-knowledge-decision-26"
+      ]
+    },
+    {
+      "token": "--background-negative-muted",
+      "role": "background",
+      "family": "negative",
+      "lifecycle": "active",
+      "provenance": [
+        "token-output-contract",
+        "semantic-knowledge-decision-26"
+      ]
+    },
+    {
+      "token": "--background-negative-on-subtle",
+      "role": "background",
+      "family": "negative",
+      "lifecycle": "active",
+      "provenance": [
+        "token-output-contract",
+        "semantic-knowledge-decision-26"
+      ]
+    },
+    {
+      "token": "--background-negative-strong",
+      "role": "background",
+      "family": "negative",
+      "lifecycle": "active",
+      "provenance": [
+        "token-output-contract",
+        "semantic-knowledge-decision-26"
+      ]
+    },
+    {
+      "token": "--background-negative-subtle",
+      "role": "background",
+      "family": "negative",
+      "lifecycle": "active",
+      "provenance": [
+        "token-output-contract",
+        "semantic-knowledge-decision-26"
+      ]
+    },
+    {
+      "token": "--background-negative-surface",
+      "role": "background",
+      "family": "negative",
+      "lifecycle": "active",
+      "provenance": [
+        "token-output-contract",
+        "semantic-knowledge-decision-26"
+      ]
+    },
+    {
+      "token": "--border-default",
+      "role": "border",
+      "lifecycle": "active",
+      "provenance": [
+        "token-output-contract",
+        "semantic-knowledge-decision-26"
+      ]
+    },
+    {
+      "token": "--border-default-alpha",
+      "role": "border",
+      "lifecycle": "active",
+      "provenance": [
+        "token-output-contract",
+        "semantic-knowledge-decision-26"
+      ]
+    },
+    {
+      "token": "--border-inverted",
+      "role": "border",
+      "family": "inverted",
+      "lifecycle": "active",
+      "provenance": [
+        "token-output-contract",
+        "semantic-knowledge-decision-26"
+      ]
+    },
+    {
+      "token": "--border-brand-strong",
+      "role": "border",
+      "family": "brand",
+      "lifecycle": "active",
+      "provenance": [
+        "token-output-contract",
+        "semantic-knowledge-decision-26"
+      ]
+    },
+    {
+      "token": "--border-brand-subtle",
+      "role": "border",
+      "family": "brand",
+      "lifecycle": "active",
+      "provenance": [
+        "token-output-contract",
+        "semantic-knowledge-decision-26"
+      ]
+    },
+    {
+      "token": "--border-neutral-strong",
+      "role": "border",
+      "family": "neutral-structural",
+      "lifecycle": "active",
+      "provenance": [
+        "token-output-contract",
+        "semantic-knowledge-decision-26"
+      ]
+    },
+    {
+      "token": "--border-neutral-subtle",
+      "role": "border",
+      "family": "neutral-structural",
+      "lifecycle": "active",
+      "provenance": [
+        "token-output-contract",
+        "semantic-knowledge-decision-26"
+      ]
+    },
+    {
+      "token": "--border-informative-strong",
+      "role": "border",
+      "family": "informative",
+      "lifecycle": "active",
+      "provenance": [
+        "token-output-contract",
+        "semantic-knowledge-decision-26"
+      ]
+    },
+    {
+      "token": "--border-informative-subtle",
+      "role": "border",
+      "family": "informative",
+      "lifecycle": "active",
+      "provenance": [
+        "token-output-contract",
+        "semantic-knowledge-decision-26"
+      ]
+    },
+    {
+      "token": "--border-positive-strong",
+      "role": "border",
+      "family": "positive",
+      "lifecycle": "active",
+      "provenance": [
+        "token-output-contract",
+        "semantic-knowledge-decision-26"
+      ]
+    },
+    {
+      "token": "--border-positive-subtle",
+      "role": "border",
+      "family": "positive",
+      "lifecycle": "active",
+      "provenance": [
+        "token-output-contract",
+        "semantic-knowledge-decision-26"
+      ]
+    },
+    {
+      "token": "--border-warning-strong",
+      "role": "border",
+      "family": "warning",
+      "lifecycle": "active",
+      "provenance": [
+        "token-output-contract",
+        "semantic-knowledge-decision-26"
+      ]
+    },
+    {
+      "token": "--border-warning-subtle",
+      "role": "border",
+      "family": "warning",
+      "lifecycle": "active",
+      "provenance": [
+        "token-output-contract",
+        "semantic-knowledge-decision-26"
+      ]
+    },
+    {
+      "token": "--border-negative-strong",
+      "role": "border",
+      "family": "negative",
+      "lifecycle": "active",
+      "provenance": [
+        "token-output-contract",
+        "semantic-knowledge-decision-26"
+      ]
+    },
+    {
+      "token": "--border-negative-subtle",
+      "role": "border",
+      "family": "negative",
+      "lifecycle": "active",
+      "provenance": [
+        "token-output-contract",
+        "semantic-knowledge-decision-26"
+      ]
+    },
+    {
+      "token": "--control-state-selected",
+      "role": "control-state",
+      "lifecycle": "active",
+      "provenance": [
+        "token-output-contract",
+        "semantic-knowledge-decision-26"
+      ]
+    },
+    {
+      "token": "--control-state-unselected",
+      "role": "control-state",
+      "lifecycle": "active",
+      "provenance": [
+        "token-output-contract",
+        "semantic-knowledge-decision-26"
+      ]
+    },
+    {
+      "token": "--focus-ring",
+      "role": "focus",
+      "lifecycle": "active",
+      "provenance": [
+        "token-output-contract",
+        "semantic-knowledge-decision-26"
+      ]
+    },
+    {
+      "token": "--content-primary",
+      "role": "content",
+      "lifecycle": "active",
+      "provenance": [
+        "token-output-contract",
+        "semantic-knowledge-decision-26"
+      ]
+    },
+    {
+      "token": "--content-secondary",
+      "role": "content",
+      "lifecycle": "active",
+      "provenance": [
+        "token-output-contract",
+        "semantic-knowledge-decision-26"
+      ]
+    },
+    {
+      "token": "--content-tertiary",
+      "role": "content",
+      "lifecycle": "active",
+      "provenance": [
+        "token-output-contract",
+        "semantic-knowledge-decision-26"
+      ]
+    },
+    {
+      "token": "--content-disabled",
+      "role": "content",
+      "lifecycle": "active",
+      "provenance": [
+        "token-output-contract",
+        "semantic-knowledge-decision-26"
+      ]
+    },
+    {
+      "token": "--content-brand-primary",
+      "role": "content",
+      "family": "brand",
+      "lifecycle": "active",
+      "provenance": [
+        "token-output-contract",
+        "semantic-knowledge-decision-26"
+      ]
+    },
+    {
+      "token": "--content-brand-secondary",
+      "role": "content",
+      "family": "brand",
+      "lifecycle": "active",
+      "provenance": [
+        "token-output-contract",
+        "semantic-knowledge-decision-26"
+      ]
+    },
+    {
+      "token": "--content-inverted-primary",
+      "role": "content",
+      "family": "inverted",
+      "lifecycle": "active",
+      "provenance": [
+        "token-output-contract",
+        "semantic-knowledge-decision-26"
+      ]
+    },
+    {
+      "token": "--content-inverted-secondary",
+      "role": "content",
+      "family": "inverted",
+      "lifecycle": "active",
+      "provenance": [
+        "token-output-contract",
+        "semantic-knowledge-decision-26"
+      ]
+    },
+    {
+      "token": "--content-inverted-tertiary",
+      "role": "content",
+      "family": "inverted",
+      "lifecycle": "active",
+      "provenance": [
+        "token-output-contract",
+        "semantic-knowledge-decision-26"
+      ]
+    },
+    {
+      "token": "--content-inverted-disabled",
+      "role": "content",
+      "family": "inverted",
+      "lifecycle": "active",
+      "provenance": [
+        "token-output-contract",
+        "semantic-knowledge-decision-26"
+      ]
+    },
+    {
+      "token": "--content-informative-primary",
+      "role": "content",
+      "family": "informative",
+      "lifecycle": "active",
+      "provenance": [
+        "token-output-contract",
+        "semantic-knowledge-decision-26"
+      ]
+    },
+    {
+      "token": "--content-informative-secondary",
+      "role": "content",
+      "family": "informative",
+      "lifecycle": "active",
+      "provenance": [
+        "token-output-contract",
+        "semantic-knowledge-decision-26"
+      ]
+    },
+    {
+      "token": "--content-positive-primary",
+      "role": "content",
+      "family": "positive",
+      "lifecycle": "active",
+      "provenance": [
+        "token-output-contract",
+        "semantic-knowledge-decision-26"
+      ]
+    },
+    {
+      "token": "--content-positive-secondary",
+      "role": "content",
+      "family": "positive",
+      "lifecycle": "active",
+      "provenance": [
+        "token-output-contract",
+        "semantic-knowledge-decision-26"
+      ]
+    },
+    {
+      "token": "--content-warning-primary",
+      "role": "content",
+      "family": "warning",
+      "lifecycle": "active",
+      "provenance": [
+        "token-output-contract",
+        "semantic-knowledge-decision-26"
+      ]
+    },
+    {
+      "token": "--content-warning-secondary",
+      "role": "content",
+      "family": "warning",
+      "lifecycle": "active",
+      "provenance": [
+        "token-output-contract",
+        "semantic-knowledge-decision-26"
+      ]
+    },
+    {
+      "token": "--content-negative-primary",
+      "role": "content",
+      "family": "negative",
+      "lifecycle": "active",
+      "provenance": [
+        "token-output-contract",
+        "semantic-knowledge-decision-26"
+      ]
+    },
+    {
+      "token": "--content-negative-secondary",
+      "role": "content",
+      "family": "negative",
+      "lifecycle": "active",
+      "provenance": [
+        "token-output-contract",
+        "semantic-knowledge-decision-26"
+      ]
+    }
+  ],
+  "hierarchies": [
+    {
+      "id": "content-emphasis",
+      "kind": "semantic-emphasis",
+      "tokens": [
+        "--content-primary",
+        "--content-secondary",
+        "--content-tertiary",
+        "--content-disabled"
+      ],
+      "provenance": [
+        "token-output-contract",
+        "semantic-knowledge-decision-26"
+      ]
+    },
+    {
+      "id": "neutral-structural-relation",
+      "kind": "semantic-structural",
+      "tokens": [
+        "--background-default",
+        "--background-neutral-surface",
+        "--background-neutral-subtle",
+        "--background-neutral-on-subtle",
+        "--background-neutral-muted",
+        "--background-neutral-strong",
+        "--background-neutral-hard"
+      ],
+      "provenance": [
+        "token-output-contract",
+        "neutral-architecture-23a"
+      ]
+    }
+  ],
+  "pairs": [
+    {
+      "id": "feedback-family-alignment",
+      "kind": "feedback-family",
+      "families": [
+        "informative",
+        "positive",
+        "warning",
+        "negative"
+      ],
+      "roles": [
+        "background",
+        "border",
+        "content"
+      ],
+      "tokenReferences": [
+        "--background-informative-subtle",
+        "--border-informative-subtle",
+        "--content-informative-primary",
+        "--background-positive-subtle",
+        "--border-positive-subtle",
+        "--content-positive-primary",
+        "--background-warning-subtle",
+        "--border-warning-subtle",
+        "--content-warning-primary",
+        "--background-negative-subtle",
+        "--border-negative-subtle",
+        "--content-negative-primary"
+      ],
+      "provenance": [
+        "semantic-knowledge-decision-26"
+      ]
+    },
+    {
+      "id": "inverted-surface-content",
+      "kind": "inverted-content",
+      "roles": [
+        "background",
+        "action",
+        "content"
+      ],
+      "tokenReferences": [
+        "--background-inverted",
+        "--action-inverted-normal",
+        "--content-inverted-primary"
+      ],
+      "provenance": [
+        "semantic-knowledge-decision-26"
+      ]
+    },
+    {
+      "id": "action-state-family-membership",
+      "kind": "action-state-family",
+      "families": [
+        "action-primary"
+      ],
+      "roles": [
+        "action"
+      ],
+      "tokenReferences": [
+        "--action-primary-normal",
+        "--action-primary-hover",
+        "--action-primary-active",
+        "--action-primary-selected"
+      ],
+      "provenance": [
+        "semantic-knowledge-decision-26"
+      ]
+    }
+  ],
+  "uiConcepts": [
+    {
+      "id": "structural-surface",
+      "purpose": "A readable structural surface.",
+      "requiredRoles": [
+        {
+          "role": "background",
+          "tokenReferences": [
+            "--background-default"
+          ]
+        },
+        {
+          "role": "content",
+          "tokenReferences": [
+            "--content-primary"
+          ]
+        }
+      ],
+      "optionalRoles": [
+        {
+          "role": "border",
+          "tokenReferences": [
+            "--border-default"
+          ]
+        }
+      ],
+      "scope": "Structural UI surfaces.",
+      "nonGoals": [
+        "Does not define page hierarchy."
+      ],
+      "provenance": [
+        "semantic-knowledge-decision-26"
+      ]
+    },
+    {
+      "id": "neutral-structural-tier",
+      "purpose": "A neutral secondary structural grouping.",
+      "requiredRoles": [
+        {
+          "role": "background",
+          "tokenReferences": [
+            "--background-neutral-surface",
+            "--background-neutral-subtle"
+          ]
+        },
+        {
+          "role": "content",
+          "tokenReferences": [
+            "--content-primary"
+          ]
+        }
+      ],
+      "optionalRoles": [
+        {
+          "role": "border",
+          "tokenReferences": [
+            "--border-neutral-subtle"
+          ]
+        }
+      ],
+      "scope": "Neutral structural grouping.",
+      "nonGoals": [
+        "Does not prescribe page-to-card hierarchy."
+      ],
+      "provenance": [
+        "neutral-architecture-23a",
+        "semantic-knowledge-decision-26"
+      ]
+    },
+    {
+      "id": "interactive-action-surface",
+      "purpose": "An interactive action control surface.",
+      "requiredRoles": [
+        {
+          "role": "action",
+          "tokenReferences": [
+            "--action-primary-normal"
+          ]
+        },
+        {
+          "role": "content",
+          "tokenReferences": [
+            "--content-inverted-primary"
+          ]
+        },
+        {
+          "role": "focus",
+          "tokenReferences": [
+            "--focus-ring"
+          ]
+        }
+      ],
+      "optionalRoles": [
+        {
+          "role": "border",
+          "tokenReferences": [
+            "--border-default"
+          ]
+        }
+      ],
+      "scope": "Interactive actions.",
+      "nonGoals": [
+        "Does not define Menu or Dialog behavior."
+      ],
+      "provenance": [
+        "semantic-knowledge-decision-26"
+      ]
+    },
+    {
+      "id": "field-control-surface",
+      "purpose": "An editable field control surface.",
+      "requiredRoles": [
+        {
+          "role": "background",
+          "tokenReferences": [
+            "--background-default"
+          ]
+        },
+        {
+          "role": "border",
+          "tokenReferences": [
+            "--border-neutral-subtle"
+          ]
+        },
+        {
+          "role": "content",
+          "tokenReferences": [
+            "--content-primary"
+          ]
+        },
+        {
+          "role": "focus",
+          "tokenReferences": [
+            "--focus-ring"
+          ]
+        }
+      ],
+      "optionalRoles": [
+        {
+          "role": "action",
+          "tokenReferences": [
+            "--action-ghost-hover"
+          ]
+        }
+      ],
+      "scope": "Field controls.",
+      "nonGoals": [
+        "Does not define Select interaction."
+      ],
+      "provenance": [
+        "semantic-knowledge-decision-26"
+      ]
+    },
+    {
+      "id": "floating-command-surface",
+      "purpose": "A temporary floating command surface.",
+      "requiredRoles": [
+        {
+          "role": "background",
+          "tokenReferences": [
+            "--background-default"
+          ]
+        },
+        {
+          "role": "border",
+          "tokenReferences": [
+            "--border-default-alpha"
+          ]
+        },
+        {
+          "role": "content",
+          "tokenReferences": [
+            "--content-primary"
+          ]
+        },
+        {
+          "role": "action",
+          "tokenReferences": [
+            "--action-ghost-hover"
+          ]
+        },
+        {
+          "role": "focus",
+          "tokenReferences": [
+            "--focus-ring"
+          ]
+        }
+      ],
+      "optionalRoles": [],
+      "scope": "Floating command surfaces.",
+      "nonGoals": [
+        "Does not define Menu keyboard behavior."
+      ],
+      "provenance": [
+        "semantic-knowledge-decision-26"
+      ]
+    },
+    {
+      "id": "feedback-surface",
+      "purpose": "A same-family feedback surface.",
+      "requiredRoles": [
+        {
+          "role": "background",
+          "tokenReferences": [
+            "--background-informative-subtle"
+          ]
+        },
+        {
+          "role": "border",
+          "tokenReferences": [
+            "--border-informative-subtle"
+          ]
+        },
+        {
+          "role": "content",
+          "tokenReferences": [
+            "--content-informative-primary"
+          ]
+        }
+      ],
+      "optionalRoles": [],
+      "scope": "Feedback callouts.",
+      "nonGoals": [
+        "Does not select feedback purpose from context."
+      ],
+      "provenance": [
+        "semantic-knowledge-decision-26"
+      ]
+    },
+    {
+      "id": "inverted-surface",
+      "purpose": "A local inverted semantic context.",
+      "requiredRoles": [
+        {
+          "role": "background",
+          "tokenReferences": [
+            "--background-inverted"
+          ]
+        },
+        {
+          "role": "content",
+          "tokenReferences": [
+            "--content-inverted-primary"
+          ]
+        }
+      ],
+      "optionalRoles": [
+        {
+          "role": "action",
+          "tokenReferences": [
+            "--action-inverted-normal"
+          ]
+        }
+      ],
+      "scope": "Inverted local surfaces.",
+      "nonGoals": [
+        "Does not imply dark theme."
+      ],
+      "provenance": [
+        "semantic-knowledge-decision-26"
+      ]
+    }
+  ],
+  "compositionPatterns": [
+    {
+      "id": "action-control",
+      "scope": "A stable action control composition.",
+      "requiredRoles": [
+        {
+          "role": "action",
+          "tokenReferences": [
+            "--action-primary-normal"
+          ]
+        },
+        {
+          "role": "content",
+          "tokenReferences": [
+            "--content-inverted-primary"
+          ]
+        },
+        {
+          "role": "focus",
+          "tokenReferences": [
+            "--focus-ring"
+          ]
+        }
+      ],
+      "optionalRoles": [
+        {
+          "role": "border",
+          "tokenReferences": [
+            "--border-default"
+          ]
+        }
+      ],
+      "allowedStates": [
+        "normal",
+        "hover",
+        "active",
+        "selected"
+      ],
+      "relatedUiConcepts": [
+        "interactive-action-surface"
+      ],
+      "owningGovernanceSource": [
+        "semantic-knowledge-decision-26"
+      ],
+      "nonGoals": [
+        "Does not define component interaction."
+      ],
+      "provenance": [
+        "semantic-knowledge-decision-26"
+      ]
+    },
+    {
+      "id": "field-control",
+      "scope": "A stable field control composition.",
+      "requiredRoles": [
+        {
+          "role": "background",
+          "tokenReferences": [
+            "--background-default"
+          ]
+        },
+        {
+          "role": "border",
+          "tokenReferences": [
+            "--border-neutral-subtle"
+          ]
+        },
+        {
+          "role": "content",
+          "tokenReferences": [
+            "--content-primary"
+          ]
+        },
+        {
+          "role": "focus",
+          "tokenReferences": [
+            "--focus-ring"
+          ]
+        }
+      ],
+      "optionalRoles": [
+        {
+          "role": "action",
+          "tokenReferences": [
+            "--action-ghost-hover"
+          ]
+        }
+      ],
+      "allowedStates": [],
+      "relatedUiConcepts": [
+        "field-control-surface"
+      ],
+      "owningGovernanceSource": [
+        "semantic-knowledge-decision-26"
+      ],
+      "nonGoals": [
+        "Does not define complex Select behavior."
+      ],
+      "provenance": [
+        "semantic-knowledge-decision-26"
+      ]
+    },
+    {
+      "id": "floating-command-collection",
+      "scope": "A floating command collection composition.",
+      "requiredRoles": [
+        {
+          "role": "background",
+          "tokenReferences": [
+            "--background-default"
+          ]
+        },
+        {
+          "role": "border",
+          "tokenReferences": [
+            "--border-default-alpha"
+          ]
+        },
+        {
+          "role": "content",
+          "tokenReferences": [
+            "--content-primary"
+          ]
+        },
+        {
+          "role": "action",
+          "tokenReferences": [
+            "--action-ghost-hover"
+          ]
+        },
+        {
+          "role": "focus",
+          "tokenReferences": [
+            "--focus-ring"
+          ]
+        }
+      ],
+      "optionalRoles": [],
+      "allowedStates": [
+        "hover",
+        "active",
+        "selected"
+      ],
+      "relatedUiConcepts": [
+        "floating-command-surface"
+      ],
+      "owningGovernanceSource": [
+        "semantic-knowledge-decision-26"
+      ],
+      "nonGoals": [
+        "Does not define Menu behavior."
+      ],
+      "provenance": [
+        "semantic-knowledge-decision-26"
+      ]
+    },
+    {
+      "id": "feedback-callout",
+      "scope": "A same-family feedback callout composition.",
+      "requiredRoles": [
+        {
+          "role": "background",
+          "tokenReferences": [
+            "--background-informative-subtle"
+          ]
+        },
+        {
+          "role": "border",
+          "tokenReferences": [
+            "--border-informative-subtle"
+          ]
+        },
+        {
+          "role": "content",
+          "tokenReferences": [
+            "--content-informative-primary"
+          ]
+        }
+      ],
+      "optionalRoles": [],
+      "allowedStates": [],
+      "relatedUiConcepts": [
+        "feedback-surface"
+      ],
+      "owningGovernanceSource": [
+        "semantic-knowledge-decision-26"
+      ],
+      "nonGoals": [
+        "Does not select feedback intent."
+      ],
+      "provenance": [
+        "semantic-knowledge-decision-26"
+      ]
+    }
+  ],
+  "antiPatterns": [
+    {
+      "id": "primitive-bypass",
+      "meaning": "Consumer UI bypasses semantic ownership.",
+      "scope": "Consumer color use.",
+      "provenance": [
+        "semantic-knowledge-decision-26"
+      ]
+    },
+    {
+      "id": "wrong-domain",
+      "meaning": "A semantic role is used outside its domain.",
+      "scope": "Consumer color use.",
+      "provenance": [
+        "semantic-knowledge-decision-26"
+      ]
+    },
+    {
+      "id": "wrong-feedback-family",
+      "meaning": "Feedback roles mix published families.",
+      "scope": "Feedback composition.",
+      "provenance": [
+        "semantic-knowledge-decision-26"
+      ]
+    },
+    {
+      "id": "source-aware-consumer",
+      "meaning": "Consumer branches on source identity.",
+      "scope": "Consumer runtime boundary.",
+      "provenance": [
+        "neutral-architecture-23a",
+        "semantic-knowledge-decision-26"
+      ]
+    },
+    {
+      "id": "invalid-lifecycle",
+      "meaning": "Consumer uses an unavailable output lifecycle.",
+      "scope": "Consumer token use.",
+      "provenance": [
+        "token-output-contract",
+        "semantic-knowledge-decision-26"
+      ]
+    }
+  ]
+}