@mtdt/observeops-ds-spec 0.1.7 → 0.1.8

package/components/registry/button.json

@@ -370,5 +370,20 @@
   },
   "slots": {
     "default": "button label / content (text and/or an icon)"
-  }
-}
+  },
+  "variantEnum": [
+    "primary",
+    "primary-alt",
+    "default",
+    "neutral-lighter",
+    "neutral-lightest",
+    "transparent",
+    "error",
+    "success",
+    "danger",
+    "info",
+    "neutral",
+    "neutral-light",
+    "warning"
+  ]
+}

package/components/registry/link.json

@@ -182,5 +182,20 @@
     ],
     "doc": "Atoms/Link/Accessibility",
     "$note": "Catalogue-wide gap SF-001 = no visible :focus-visible ring; tracked in findings/."
-  }
+  },
+  "variantEnum": [
+    "primary",
+    "primary-alt",
+    "default",
+    "neutral-lighter",
+    "neutral-lightest",
+    "transparent",
+    "error",
+    "success",
+    "danger",
+    "info",
+    "neutral",
+    "neutral-light",
+    "warning"
+  ]
 }

package/components/registry/severity.json

@@ -179,5 +179,19 @@
   "changelog": [
     "2026-06-27: added to the Elements site — 13 severity levels in dot / dot+label / solid-chip / coloured-text / bg-fill shapes; source-accurate 11px dot (the Storybook reproduction enlarges to 14px).",
     "2026-06-29: stripe shown in both real usages — the standalone bar AND the table/list left-rule row."
+  ],
+  "severityEnum": [
+    "down",
+    "critical",
+    "major",
+    "warning",
+    "clear",
+    "up",
+    "maintenance",
+    "unreachable",
+    "disable",
+    "unknown",
+    "suspended",
+    "none"
   ]
 }

package/components/registry/tag.json

@@ -341,5 +341,14 @@
     ],
     "doc": "Atoms/Tag/Accessibility",
     "$note": "Catalogue-wide gap SF-001 = no visible :focus-visible ring; tracked in findings/."
-  }
+  },
+  "variantEnum": [
+    "tag-primary",
+    "tag-green",
+    "tag-red",
+    "tag-yellow",
+    "tag-orange",
+    "tag-purple",
+    "tag-unknown"
+  ]
 }

package/conformance/ds-conformance.mjs

@@ -110,11 +110,14 @@ function validValues(tag) {
   const r = JSON.parse(fs.readFileSync(p, 'utf8'))
   const props = r.props || {}
   const enumOf = (k) => (props[k] && Array.isArray(props[k].enum) && props[k].enum.length ? props[k].enum : null)
-  // Validate ONLY against a declared prop `enum` (the reliable accepted-values source). The registry's
-  // `variants` field is a doc concept whose names don't always match the prop values (e.g. link), so we
-  // do NOT validate against it — that produced false positives. Where a component has no enum, its variant
-  // isn't strictly validated here (a registry gap the ai-readiness/validate-registries pass should close).
-  return (_regCache[id] = { id, variant: enumOf('variant'), size: enumOf('size'), type: enumOf('type') })
+  // `variantEnum` / `severityEnum` are purpose-built fields listing the CANONICAL DS variant values that
+  // match the obs-* component + the CSS-class form (e.g. tag-green) — the values a rendered page actually
+  // uses. (The product-API `props.variant.enum` documents MTag's raw variants, which differ.) size/type
+  // use the reliable prop enum.
+  return (_regCache[id] = { id,
+    variant: (Array.isArray(r.variantEnum) && r.variantEnum.length) ? r.variantEnum : null,
+    severity: (Array.isArray(r.severityEnum) && r.severityEnum.length) ? r.severityEnum : null,
+    size: enumOf('size'), type: enumOf('type') })
 }
 
 // ── static server (reused from diff.mjs) ─────────────────────────────────────
@@ -259,11 +262,10 @@ const MEASURE = () => {
   for (const inst of (m.dsInstances || [])) {
     const vv = validValues(inst.tag); if (!vv) continue
     const bad = (attr, val, allowed) => { if (val == null || !allowed || !allowed.length) return; checked++; if (!allowed.includes(val)) { invalid++; violations.component.push({ detail: `invented ${attr} "${val}" on <${inst.tag}> — valid: ${allowed.slice(0, 8).join(', ')}` }) } }
-    // Validate `size`/`type` against the prop enum (reliable). NOT `variant`: components reflect a default
-    // `variant` attr that often isn't in the registry's variant list (e.g. obs-link reflects "primary"),
-    // and the registry's variant names don't always match the component's accepted values — so validating
-    // it here produces false positives. Enabling variant validation needs a clean per-component variant
-    // enum in the registry (tracked as a spec-hardening TODO; see validate-registries / ai-readiness).
+    // variant/severity validated against the canonical registry enum (variantEnum/severityEnum); size/type
+    // against the prop enum. All match the rendered obs-* values, so no reflected-default false positives.
+    bad('variant', inst.variant, vv.variant)
+    bad('severity', inst.severity, vv.severity)
     bad('size', inst.size, vv.size)
     bad('type', inst.type, vv.type)
     // icon-only interactive control (no text) should carry an aria-label

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mtdt/observeops-ds-spec",
-  "version": "0.1.7",
+  "version": "0.1.8",
   "description": "Machine-readable spec and AI operating contract for the Motadata ObserveOps design system \u2014 components, tokens, page recipes, layout structure, and the rules an AI tool follows to build ObserveOps UI faithfully.",
   "license": "UNLICENSED",
   "main": "index.js",

package/spec.manifest.json

@@ -1,7 +1,7 @@
 {
   "name": "@mtdt/observeops-ds-spec",
-  "version": "0.1.7",
-  "generated": "2026-07-05T06:59:15.142Z",
+  "version": "0.1.8",
+  "generated": "2026-07-05T07:20:59.202Z",
   "entry": "llms.txt",
   "contract": "AGENTS.md",
   "index": "components/index.json",
@@ -50,8 +50,8 @@
     },
     {
       "path": "components/registry/button.json",
-      "bytes": 13613,
-      "sha256": "4b98033fc2df599f6e81dfcfb4ce24b5ebe869b336cd7fad99c6cf12c714506b"
+      "bytes": 13857,
+      "sha256": "b54bb602317cacf0eafb72211b9c63bc27bb7ecef1a4319c24b8174d628c2c1e"
     },
     {
       "path": "components/registry/checkbox.json",
@@ -130,8 +130,8 @@
     },
     {
       "path": "components/registry/link.json",
-      "bytes": 6575,
-      "sha256": "b3362ab4305d631e24c83149482d46723f964f4f9c62d516aaeec14bbf2e6ff4"
+      "bytes": 6818,
+      "sha256": "0502a87ed580f4899c0e0c4cea1b29303021ecdf3458049bc2e33da40a821d10"
     },
     {
       "path": "components/registry/loose-tags.json",
@@ -180,8 +180,8 @@
     },
     {
       "path": "components/registry/severity.json",
-      "bytes": 7118,
-      "sha256": "9aec8f6752f98d825bcd78e001284a98b737682b0da9125de6dd38c1fee1ff7b"
+      "bytes": 7318,
+      "sha256": "ecf038986b75313361bf7f38c57aedbc2e9c01280af37c1ba93f6c5f755ca82b"
     },
     {
       "path": "components/registry/switch.json",
@@ -200,8 +200,8 @@
     },
     {
       "path": "components/registry/tag.json",
-      "bytes": 11493,
-      "sha256": "245aef496865fb8ba8ddd065bba02c1f1b4863faa7b9b837bfd2bb09dae8738f"
+      "bytes": 11640,
+      "sha256": "8f50f7486f130d07f47484aaf5d1ef1aa772d5ea8fe13b2a90d45a6a4c35d6f2"
     },
     {
       "path": "components/registry/tags-list.json",
@@ -360,8 +360,8 @@
     },
     {
       "path": "conformance/ds-conformance.mjs",
-      "bytes": 21201,
-      "sha256": "625ab74a9f0b788a6721432cf8b8688a128c03e832fe001300f8a24ad176f9b2"
+      "bytes": 21068,
+      "sha256": "e710fd4aed8629bfdd95b5c3ced0135099d4b57fd36aafa827f05fc00e90082e"
     },
     {
       "path": "foundation/README.md",
@@ -411,7 +411,7 @@
     {
       "path": "package.json",
       "bytes": 1072,
-      "sha256": "19f2e139d6c911d1801219acf6ecbd6f029ed596d8484e8bbf4adc4ae61c78b9"
+      "sha256": "1d9d5850f9aa6ee23a7f8b071b596d37ebb013fc07262629a0bfd6bcedca03a3"
     },
     {
       "path": "tokens/README.md",