brandrail 0.8.0 → 0.9.0

package/dist/brandrail.mjs

@@ -7013,10 +7013,10 @@ var require_formats = __commonJS({
     function isLeapYear(year) {
       return year % 4 === 0 && (year % 100 !== 0 || year % 400 === 0);
     }
-    var DATE = /^(\d\d\d\d)-(\d\d)-(\d\d)$/;
+    var DATE2 = /^(\d\d\d\d)-(\d\d)-(\d\d)$/;
     var DAYS = [0, 31, 28, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31];
     function date5(str) {
-      const matches2 = DATE.exec(str);
+      const matches2 = DATE2.exec(str);
       if (!matches2)
         return false;
       const year = +matches2[1];
@@ -7810,6 +7810,634 @@ function contrastRatio(a, b) {
   return (l1 + 0.05) / (l2 + 0.05);
 }
 
+// ../engine/src/tokens.ts
+var EXT = "dev.brandrail";
+function slug(s) {
+  return s.replace(/([a-z])([A-Z])/g, "$1-$2").replace(/([A-Za-z])(\d)/g, "$1-$2").replace(/[^A-Za-z0-9]+/g, "-").replace(/^-+|-+$/g, "").toLowerCase();
+}
+var segs = (name) => name.split(/[/$.]+/).map(slug).filter(Boolean);
+var stripPrefix = (s, ...prefixes) => {
+  for (const p of prefixes) if (s === p) return "";
+  for (const p of prefixes) if (s.startsWith(`${p}-`)) return s.slice(p.length + 1);
+  return s;
+};
+var WEIGHTS = {
+  thin: "100",
+  hairline: "100",
+  "extra-light": "200",
+  "ultra-light": "200",
+  light: "300",
+  regular: "400",
+  regulare: "400",
+  normal: "400",
+  book: "400",
+  medium: "500",
+  "semi-bold": "600",
+  semibold: "600",
+  "demi-bold": "600",
+  bold: "700",
+  "extra-bold": "800",
+  "ultra-bold": "800",
+  black: "900",
+  heavy: "900"
+};
+function fontWeight(v) {
+  if (typeof v === "number") return String(v);
+  return WEIGHTS[slug(v)] ?? (/^\d{3}$/.test(v.trim()) ? v.trim() : v);
+}
+function colorValue(v) {
+  if (v && typeof v === "object" && ("components" in v || "hex" in v)) {
+    const c = v;
+    const alpha = typeof c.alpha === "number" ? c.alpha : 1;
+    const withAlpha = (hex4) => alpha < 1 ? `${hex4.slice(0, 7)}${Math.round(alpha * 255).toString(16).padStart(2, "0")}` : hex4.slice(0, 7);
+    if (typeof c.hex === "string" && /^#[0-9a-f]{6}/i.test(c.hex)) return withAlpha(c.hex.toLowerCase());
+    const comps = c.components?.map((x2) => typeof x2 === "number" ? x2 : 0);
+    if (comps?.length === 3 && (!c.colorSpace || /srgb|display-p3/i.test(c.colorSpace))) {
+      return withAlpha(toHex({ r: comps[0] * 255, g: comps[1] * 255, b: comps[2] * 255, a: 1 }));
+    }
+    return null;
+  }
+  if (v && typeof v === "object" && "r" in v) {
+    const c = v;
+    const hex4 = toHex({ r: c.r * 255, g: c.g * 255, b: c.b * 255, a: 1 });
+    const a = c.a ?? 1;
+    return a < 1 ? `${hex4}${Math.round(a * 255).toString(16).padStart(2, "0")}` : hex4;
+  }
+  if (typeof v !== "string") return null;
+  const s = v.trim();
+  if (/^#[0-9a-f]{3,8}$/i.test(s)) {
+    const h = s.slice(1).toLowerCase();
+    return h.length === 3 || h.length === 4 ? `#${[...h].map((c) => c + c).join("")}` : `#${h}`;
+  }
+  const rgb = parseColor(s);
+  if (!rgb) return null;
+  const hex3 = toHex(rgb);
+  return rgb.a < 1 ? `${hex3}${Math.round(rgb.a * 255).toString(16).padStart(2, "0")}` : hex3;
+}
+var dim = (v) => {
+  if (v && typeof v === "object" && "value" in v) {
+    const d = v;
+    const n = typeof d.value === "number" ? d.value : parseFloat(d.value);
+    return d.unit === "rem" ? `${Math.round(n * 16 * 100) / 100}px` : `${Math.round(n * 100) / 100}px`;
+  }
+  return typeof v === "number" ? `${Math.round(v * 100) / 100}px` : String(v).trim();
+};
+function classify(name, kind, value, opts = {}) {
+  const parts = segs(name);
+  const hay = slug(`${opts.context ?? ""} ${name}`);
+  const scopes = opts.scopes ?? [];
+  const last = parts[parts.length - 1] ?? "";
+  const rest = parts.slice(0, -1);
+  if (kind === "boolean") return null;
+  if (kind === "color") {
+    const v2 = colorValue(value);
+    if (!v2) return null;
+    let p = parts[0] === "color" || parts[0] === "colors" ? parts.slice(1) : parts;
+    if (p.length === 1) p = [stripPrefix(p[0], "colors", "color") || p[0]];
+    const tail = p[p.length - 1];
+    const m = tail.match(/^(.*[a-z])-(\d+)$/);
+    if (m && p.length <= 2) p = [...p.slice(0, -1), m[1], m[2]];
+    return { path: ["color", ...p].join("."), type: "color", value: v2 };
+  }
+  if (kind === "string") {
+    const s = String(value);
+    if (scopes.includes("FONT_FAMILY") || /font-family|typeface|font-name/.test(hay) || last === "font") {
+      const n = stripPrefix(last, "font-family", "font", "family") || "sans";
+      return { path: `font.family.${/mono|code/.test(s.toLowerCase()) && n === "sans" ? "mono" : n}`, type: "fontFamily", value: s };
+    }
+    if (scopes.includes("FONT_STYLE") || scopes.includes("FONT_WEIGHT") || /font-weight|weight/.test(hay)) {
+      return { path: `font.weight.${stripPrefix(last, "font-weight", "weight") || last}`, type: "fontWeight", value: fontWeight(s) };
+    }
+    const c = colorValue(s);
+    if (c && /^#|^rgb|^hsl/i.test(s.trim())) return classify(name, "color", s, opts);
+    return null;
+  }
+  const v = dim(value);
+  const has = (...scope) => scope.some((x2) => scopes.includes(x2));
+  const nm = (...prefixes) => stripPrefix(last, ...prefixes) || last;
+  if (has("CORNER_RADIUS") || /radius|(^|-)rad(-|$)|corner|rounded/.test(hay)) return { path: `radius.${nm("radius", "rad", "corner", "rounded")}`, type: "dimension", value: v };
+  if (has("FONT_SIZE") || /font-size|text-size/.test(hay)) return { path: `font.size.${nm("font-size", "text-size", "size")}`, type: "dimension", value: v };
+  if (has("LINE_HEIGHT") || /line-height|leading/.test(hay)) return { path: `font.line-height.${nm("line-height", "leading")}`, type: "dimension", value: v };
+  if (has("LETTER_SPACING") || /letter-spacing|tracking/.test(hay)) return { path: `font.letter-spacing.${nm("letter-spacing", "tracking")}`, type: "dimension", value: v };
+  if (has("FONT_WEIGHT") || /font-weight/.test(hay)) return { path: `font.weight.${nm("font-weight", "weight")}`, type: "fontWeight", value: String(value) };
+  if (/icon/.test(last)) return { path: `size.icon.${nm("icon")}`, type: "dimension", value: v };
+  if (has("GAP") || /spac|gap|padding|margin|inset|(^|-)space(-|$)/.test(hay)) return { path: `space.${nm("spacing", "space", "gap")}`, type: "dimension", value: v };
+  if (has("STROKE_FLOAT") || /stroke|border-width/.test(hay)) return { path: `border.width.${nm("border-width", "stroke")}`, type: "dimension", value: v };
+  if (has("WIDTH_HEIGHT") || /size|width|height/.test(hay)) return { path: ["size", ...rest.filter((x2) => x2 !== "size"), last].join("."), type: "dimension", value: v };
+  return { path: ["number", ...parts].join("."), type: "number", value: String(value) };
+}
+function rawLeaves(node2, prefix, out, studio, inherited) {
+  if (!node2 || typeof node2 !== "object" || Array.isArray(node2)) return;
+  const o = node2;
+  const groupType = o.$type ?? inherited;
+  const isLeaf = "$value" in o || studio && "value" in o && (typeof o.value !== "object" || o.value === null || "type" in o);
+  if (isLeaf) {
+    const ext = o.$extensions?.[EXT];
+    out.push({
+      path: prefix,
+      type: o.$type ?? o.type ?? groupType,
+      value: "$value" in o ? o.$value : o.value,
+      description: o.$description ?? o.description,
+      dark: ext?.modes?.dark
+    });
+    return;
+  }
+  for (const [k, v] of Object.entries(o)) if (!k.startsWith("$")) rawLeaves(v, prefix ? `${prefix}.${k}` : k, out, studio, groupType);
+}
+var REF = /^\{([^}]+)\}$/;
+function resolveRefs(raws) {
+  const byPath = new Map(raws.map((r) => [r.path, r]));
+  const deref = (v, mode, depth = 0) => {
+    if (typeof v !== "string" || depth > 10) return v;
+    const m = v.trim().match(REF);
+    if (!m) return v.replace(/\{([^}]+)\}/g, (all, p) => String(byPath.get(p)?.value ?? all));
+    const target = byPath.get(m[1]);
+    if (!target) return v;
+    return deref(mode === "dark" && target.dark !== void 0 ? target.dark : target.value, mode, depth + 1);
+  };
+  return raws.map((r) => ({ ...r, value: deref(r.value, "light"), dark: r.dark !== void 0 ? deref(r.dark, "dark") : void 0 }));
+}
+var TYPE_KIND = {
+  color: "color",
+  dimension: "number",
+  spacing: "number",
+  sizing: "number",
+  borderradius: "number",
+  fontsizes: "number",
+  fontsize: "number",
+  lineheights: "number",
+  lineheight: "number",
+  letterspacing: "number",
+  number: "number",
+  fontfamilies: "string",
+  fontfamily: "string",
+  fontweights: "string",
+  fontweight: "string"
+};
+function flattenTokens(doc) {
+  const raws = resolveRefs(collectRaw(doc).raws);
+  const out = [];
+  for (const r of raws) {
+    const t = (r.type ?? "").toLowerCase().replace(/[^a-z]/g, "");
+    if (t === "color" || !t && r.path.startsWith("color")) {
+      const v = colorValue(r.value);
+      if (!v) continue;
+      const d = r.dark !== void 0 ? colorValue(r.dark) : null;
+      out.push({ path: r.path, type: "color", value: v, ...d ? { dark: d } : {}, ...r.description ? { description: r.description } : {} });
+    } else if (typeof r.value === "string" || typeof r.value === "number" || r.value && typeof r.value === "object" && "unit" in r.value) {
+      const type = typeof r.value === "object" ? "dimension" : t === "fontfamily" || t === "fontfamilies" ? "fontFamily" : t === "fontweight" || t === "fontweights" ? "fontWeight" : TYPE_KIND[t] === "number" ? "dimension" : t === "number" ? "number" : /^font\.family\./.test(r.path) ? "fontFamily" : typeof r.value === "number" ? "number" : /px$|rem$/.test(String(r.value)) ? "dimension" : "string";
+      out.push({ path: r.path, type, value: type === "dimension" ? dim(r.value) : String(r.value), ...r.description ? { description: r.description } : {} });
+    }
+  }
+  return out;
+}
+function collectRaw(doc) {
+  const o = doc ?? {};
+  const studio = !hasDollarValue(o) && hasStudioValue(o);
+  const order = o.$metadata?.tokenSetOrder;
+  if (!studio) {
+    const raws = [];
+    rawLeaves(o, "", raws, false);
+    return { raws, studio };
+  }
+  const setNames = (order ?? Object.keys(o).filter((k) => !k.startsWith("$"))).filter((k) => o[k] && typeof o[k] === "object");
+  const looksLikeSets = setNames.length > 0 && setNames.every((k) => !hasLeafAtTop(o[k]));
+  if (!looksLikeSets) {
+    const raws = [];
+    rawLeaves(o, "", raws, true);
+    return { raws, studio };
+  }
+  const merged = /* @__PURE__ */ new Map();
+  const darkSets = setNames.filter((n) => /dark/i.test(n));
+  for (const set2 of setNames.filter((n) => !/dark/i.test(n))) {
+    const raws = [];
+    rawLeaves(o[set2], "", raws, true);
+    for (const r of raws) merged.set(r.path, r);
+  }
+  for (const set2 of darkSets) {
+    const raws = [];
+    rawLeaves(o[set2], "", raws, true);
+    for (const r of raws) {
+      const base = merged.get(r.path);
+      if (base) base.dark = r.value;
+      else merged.set(r.path, r);
+    }
+  }
+  return { raws: [...merged.values()], studio };
+}
+function hasDollarValue(node2, depth = 0) {
+  if (!node2 || typeof node2 !== "object" || depth > 12) return false;
+  if ("$value" in node2) return true;
+  return Object.values(node2).some((v) => hasDollarValue(v, depth + 1));
+}
+function hasStudioValue(node2, depth = 0) {
+  if (!node2 || typeof node2 !== "object" || depth > 12) return false;
+  const o = node2;
+  if ("value" in o && "type" in o) return true;
+  return Object.values(o).some((v) => hasStudioValue(v, depth + 1));
+}
+function hasLeafAtTop(node2) {
+  return !!node2 && typeof node2 === "object" && ("value" in node2 || "$value" in node2);
+}
+function buildDtcg(tokens) {
+  const tree = {};
+  for (const t of tokens) {
+    const parts = t.path.split(".");
+    let node2 = tree;
+    parts.forEach((p, i2) => {
+      if (i2 === parts.length - 1) {
+        node2[p] = {
+          $type: t.type,
+          $value: t.value,
+          ...t.description ? { $description: t.description } : {},
+          ...t.dark && t.dark !== t.value ? { $extensions: { [EXT]: { modes: { dark: t.dark } } } } : {}
+        };
+      } else {
+        const next = node2[p];
+        if (next && typeof next === "object" && "$value" in next) node2[p] = { default: next };
+        node2 = node2[p] ??= {};
+      }
+    });
+  }
+  return tree;
+}
+var isAlias = (v) => !!v && typeof v === "object" && v.type === "VARIABLE_ALIAS";
+var DARK = /dark|night/i;
+var LIGHT = /light|default|day|base/i;
+function finish(format, all, notes, opts) {
+  const PALETTE2 = /^(color\.[a-z-]+)\.\d{1,3}$/;
+  const usedFamilies = new Set(all.filter((t) => t.referenced).map((t) => t.path.match(PALETTE2)?.[1]).filter(Boolean));
+  if (usedFamilies.size) {
+    const steps = /* @__PURE__ */ new Map();
+    for (const t of all) {
+      const f = t.path.match(PALETTE2)?.[1];
+      if (f) steps.set(f, (steps.get(f) ?? 0) + 1);
+    }
+    for (const t of all) {
+      const f = t.path.match(PALETTE2)?.[1];
+      if (f && (usedFamilies.has(f) || (steps.get(f) ?? 0) >= 3)) t.referenced = true;
+    }
+  }
+  const hasSemantic = all.some((t) => !t.referenced) && all.some((t) => t.referenced);
+  const keep = opts.includePrimitives || !hasSemantic ? all : all.filter((t) => !t.referenced);
+  const primitives = hasSemantic ? all.filter((t) => t.referenced).length : 0;
+  const seen = /* @__PURE__ */ new Set();
+  const tokens = [];
+  for (const { referenced: _r, ...t } of keep) {
+    if (seen.has(t.path)) continue;
+    seen.add(t.path);
+    tokens.push(t);
+  }
+  tokens.sort((a, b) => a.path.localeCompare(b.path, "en", { numeric: true }));
+  return { format, tokens: buildDtcg(tokens), count: tokens.length, primitives, notes };
+}
+function fromFigmaVariables(meta3, opts = {}) {
+  const vars = meta3.variables ?? {};
+  const cols = meta3.variableCollections ?? {};
+  const notes = [];
+  const referenced = /* @__PURE__ */ new Set();
+  const modeFor = (col, want, likeName) => {
+    if (likeName) {
+      const same = col.modes.find((m) => m.name.toLowerCase() === likeName.toLowerCase());
+      if (same) return same.modeId;
+    }
+    if (want === "dark") return col.modes.find((m) => DARK.test(m.name))?.modeId;
+    return col.defaultModeId ?? col.modes[0]?.modeId;
+  };
+  const resolve4 = (v, want, modeName, depth = 0) => {
+    const col = cols[v.variableCollectionId];
+    if (!col) return void 0;
+    const modeId = modeFor(col, want, modeName) ?? col.defaultModeId;
+    const raw = v.valuesByMode[modeId] ?? Object.values(v.valuesByMode)[0];
+    if (!isAlias(raw)) return raw;
+    referenced.add(raw.id);
+    const target = vars[raw.id];
+    if (!target || depth > 10) return void 0;
+    const name = col.modes.find((m) => m.modeId === modeId)?.name;
+    return resolve4(target, want, name, depth + 1);
+  };
+  for (const v of Object.values(vars)) for (const val of Object.values(v.valuesByMode)) if (isAlias(val)) referenced.add(val.id);
+  for (const col of Object.values(cols)) {
+    if (col.remote) continue;
+    const dark = col.modes.find((m) => DARK.test(m.name));
+    const others = col.modes.filter((m) => m.modeId !== col.defaultModeId && m !== dark);
+    if (others.length) {
+      const def = col.modes.find((m) => m.modeId === col.defaultModeId)?.name;
+      notes.push(`\u201C${col.name}\u201D has modes ${col.modes.map((m) => m.name).join(", ")}; used \u201C${def}\u201D${dark ? ` (and \u201C${dark.name}\u201D as dark)` : ""}.`);
+    }
+  }
+  const out = [];
+  let hidden = 0;
+  for (const v of Object.values(vars)) {
+    const col = cols[v.variableCollectionId];
+    if (!col || v.remote || col.remote) continue;
+    if (v.hiddenFromPublishing) {
+      hidden++;
+      continue;
+    }
+    const kind = v.resolvedType === "COLOR" ? "color" : v.resolvedType === "FLOAT" ? "number" : v.resolvedType === "STRING" ? "string" : "boolean";
+    const value = resolve4(v, "default");
+    if (value === void 0) continue;
+    const c = classify(v.name, kind, value, { scopes: v.scopes?.filter((s) => s !== "ALL_SCOPES"), context: col.name });
+    if (!c) continue;
+    let darkValue;
+    if (c.type === "color") {
+      const hasDarkSomewhere = Object.values(cols).some((x2) => x2.modes.some((m) => DARK.test(m.name)));
+      if (hasDarkSomewhere) {
+        const d = colorValue(resolve4(v, "dark"));
+        if (d && d !== c.value) darkValue = d;
+      }
+    }
+    out.push({ ...c, ...darkValue ? { dark: darkValue } : {}, ...v.description ? { description: v.description } : {}, referenced: referenced.has(v.id) });
+  }
+  if (hidden) notes.push(`${hidden} variable${hidden === 1 ? "" : "s"} hidden from publishing were skipped.`);
+  return finish("figma-variables", out, notes, opts);
+}
+function fromFigmaStyles(styles, opts = {}) {
+  const out = [];
+  const families = /* @__PURE__ */ new Map();
+  let skipped = 0;
+  for (const s of styles) {
+    if (s.styleType === "FILL") {
+      const fill = s.node?.fills?.find((f) => f.type === "SOLID" && f.visible !== false && f.color);
+      if (!fill?.color) {
+        skipped++;
+        continue;
+      }
+      const c = classify(s.name, "color", { ...fill.color, a: (fill.color.a ?? 1) * (fill.opacity ?? 1) });
+      if (c) out.push({ ...c, ...s.description ? { description: s.description } : {} });
+    } else if (s.styleType === "TEXT" && s.node?.style) {
+      const st = s.node.style;
+      const name = segs(s.name).join("-");
+      if (st.fontSize) out.push({ path: `font.size.${name}`, type: "dimension", value: dim(st.fontSize) });
+      if (st.lineHeightPx) out.push({ path: `font.line-height.${name}`, type: "dimension", value: dim(Math.round(st.lineHeightPx)) });
+      if (st.fontWeight) out.push({ path: `font.weight.${name}`, type: "fontWeight", value: String(st.fontWeight) });
+      if (st.fontFamily) families.set(st.fontFamily, (families.get(st.fontFamily) ?? 0) + 1);
+    }
+  }
+  const fams = [...families.entries()].sort((a, b) => b[1] - a[1]);
+  fams.forEach(([f], i2) => out.push({ path: `font.family.${i2 === 0 ? "sans" : /mono|code/i.test(f) ? "mono" : slug(f)}`, type: "fontFamily", value: f }));
+  const notes = skipped ? [`${skipped} fill style${skipped === 1 ? "" : "s"} (gradients or images) were skipped.`] : [];
+  return finish("figma-styles", out, notes, opts);
+}
+function plainLeaves(node2, prefix, out) {
+  if (node2 === null || node2 === void 0) return;
+  if (typeof node2 !== "object" || typeof node2 === "object" && "r" in node2 && "g" in node2) {
+    out.push({ key: prefix, value: node2 });
+    return;
+  }
+  for (const [k, v] of Object.entries(node2)) plainLeaves(v, [...prefix, k], out);
+}
+function fromModeObject(obj, opts = {}) {
+  const notes = [];
+  const modes = Object.entries(obj).filter(([, v]) => v && typeof v === "object");
+  const leafSets = modes.map(([name, v]) => {
+    const l = [];
+    plainLeaves(v, [], l);
+    return { name, leaves: l, keys: new Set(l.map((x2) => x2.key.join("/"))) };
+  });
+  const groups = [];
+  for (const m of leafSets) {
+    const g = groups.find((grp) => {
+      const a = grp[0].keys;
+      let same = 0;
+      for (const k of m.keys) if (a.has(k)) same++;
+      return same / Math.max(a.size, m.keys.size) >= 0.8;
+    });
+    if (g) g.push(m);
+    else groups.push([m]);
+  }
+  const byLeaf = /* @__PURE__ */ new Map();
+  groups.forEach((grp, gi) => {
+    for (const m of grp) for (const l of m.leaves) {
+      const k = l.key[l.key.length - 1];
+      const e = byLeaf.get(k) ?? { group: gi, values: /* @__PURE__ */ new Map() };
+      e.values.set(m.name, l.value);
+      byLeaf.set(k, e);
+    }
+  });
+  const pick2 = (grp, want) => want === "dark" ? grp.find((m) => DARK.test(m.name)) : grp.find((m) => LIGHT.test(m.name) && !DARK.test(m.name)) ?? grp.find((m) => !DARK.test(m.name)) ?? grp[0];
+  const referenced = /* @__PURE__ */ new Set();
+  for (const m of leafSets) for (const l of m.leaves) if (typeof l.value === "string" && byLeaf.has(l.value)) referenced.add(l.value);
+  const deref = (v, want, depth = 0) => {
+    if (typeof v !== "string" || depth > 10) return v;
+    const ref = byLeaf.get(v) ?? byLeaf.get(v.replace(REF, "$1"));
+    if (!ref) return v;
+    referenced.add(v);
+    const grp = groups[ref.group];
+    const mode = pick2(grp, want) ?? pick2(grp, "default");
+    return deref(ref.values.get(mode.name) ?? [...ref.values.values()][0], want, depth + 1);
+  };
+  const out = [];
+  const pending = [];
+  for (const grp of groups) {
+    const def = pick2(grp, "default");
+    const dark = pick2(grp, "dark");
+    if (grp.length > 1) notes.push(`${grp.map((m) => m.name).join(" / ")} look like modes of one collection; used \u201C${def.name}\u201D${dark && dark !== def ? ` (and \u201C${dark.name}\u201D as dark)` : ""}.`);
+    for (const l of def.leaves) {
+      const key = l.key[l.key.length - 1];
+      const container = l.key.length > 1 ? l.key[l.key.length - 2].toLowerCase() : "";
+      const value = deref(l.value, "default");
+      const kind = container === "color" || colorValue(value) && /^#|^rgb|^hsl/i.test(String(value)) ? "color" : container === "string" || typeof value === "string" && !/^-?[\d.]+(px|rem|%)?$/.test(value) ? "string" : "number";
+      const c = classify(key, kind, kind === "number" && typeof value === "string" && /px$/.test(value) ? parseFloat(value) : value, { context: def.name });
+      if (!c) continue;
+      let d;
+      if (c.type === "color") {
+        const darkLeaf = dark && dark !== def ? dark.leaves.find((x2) => x2.key.join("/") === l.key.join("/")) : void 0;
+        const dv = colorValue(deref(darkLeaf ? darkLeaf.value : l.value, "dark"));
+        if (dv && dv !== c.value) d = dv;
+      }
+      pending.push({ key, t: { ...c, ...d ? { dark: d } : {} } });
+    }
+  }
+  for (const p of pending) out.push({ ...p.t, referenced: referenced.has(p.key) });
+  return finish("mode-object", out, notes, opts);
+}
+var figmaExt = (node2, key) => {
+  const ext = node2.$extensions;
+  if (!ext) return void 0;
+  if (`com.figma.${key}` in ext) return ext[`com.figma.${key}`];
+  const nested = ext["com.figma"];
+  return nested?.[key];
+};
+function fileLeaves(node2, prefix, out, inherited) {
+  if (!node2 || typeof node2 !== "object" || Array.isArray(node2)) return;
+  const o = node2;
+  const groupType = o.$type ?? inherited;
+  if ("$value" in o) {
+    const alias = figmaExt(o, "aliasData");
+    const scopes = figmaExt(o, "scopes");
+    out.push({
+      path: prefix,
+      type: o.$type ?? groupType,
+      value: o.$value,
+      description: o.$description,
+      scopes: Array.isArray(scopes) ? scopes : void 0,
+      aliasTarget: alias?.targetVariableName?.replace(/\//g, "."),
+      hidden: figmaExt(o, "hiddenFromPublishing") === true || void 0
+    });
+    return;
+  }
+  for (const [k, v] of Object.entries(o)) {
+    if (k.startsWith("$")) continue;
+    fileLeaves(v, prefix ? `${prefix}.${k}` : k, out, groupType);
+  }
+}
+var hasFigmaExt = (node2, depth = 0) => {
+  if (!node2 || typeof node2 !== "object" || depth > 12) return false;
+  const ext = node2.$extensions;
+  if (ext && Object.keys(ext).some((k) => k.startsWith("com.figma"))) return true;
+  return Object.values(node2).some((v) => hasFigmaExt(v, depth + 1));
+};
+function modeOf(file2) {
+  const root = file2.data ?? {};
+  const parts = file2.name.replace(/\\/g, "/").split("/").filter(Boolean);
+  const base = (parts.pop() ?? "tokens").replace(/(\.tokens)?\.json$/i, "");
+  const named = figmaExt(root, "modeName");
+  const split = base.match(/^(.+?)[\s._-]+(light|dark|night|day|default|mode[\s_-]*\d+)$/i);
+  return {
+    collection: parts.join("/") || (split ? split[1] : ""),
+    mode: typeof named === "string" ? named : split ? split[2] : base
+  };
+}
+function importTokenFiles(files, opts = {}) {
+  const parsed = files.filter((f) => f.data && typeof f.data === "object");
+  if (!parsed.length) throw new Error("No JSON token files found.");
+  const figma = parsed.some((f) => hasFigmaExt(f.data));
+  if (parsed.length === 1 && !figma) return importTokens(parsed[0].data, opts);
+  const notes = [];
+  const withMode = parsed.map((f) => ({ ...f, ...modeOf(f) }));
+  const byCollection = /* @__PURE__ */ new Map();
+  for (const f of withMode) byCollection.set(f.collection, [...byCollection.get(f.collection) ?? [], f]);
+  const light = /* @__PURE__ */ new Map();
+  const darkOverrides = /* @__PURE__ */ new Map();
+  for (const [collection, list] of byCollection) {
+    const dark = list.find((f) => DARK.test(f.mode));
+    const def = list.find((f) => LIGHT.test(f.mode) && !DARK.test(f.mode)) ?? list.find((f) => !DARK.test(f.mode)) ?? list[0];
+    if (list.length > 1) {
+      const label = collection ? `\u201C${collection}\u201D` : "The files";
+      notes.push(`${label}: modes ${list.map((f) => f.mode).join(", ")}; used \u201C${def.mode}\u201D${dark && dark !== def ? ` (and \u201C${dark.mode}\u201D as dark)` : ""}.`);
+    }
+    const read2 = (f, into) => {
+      const leaves3 = [];
+      fileLeaves(f.data, "", leaves3);
+      for (const l of leaves3) into.set(l.path, { path: l.path, type: l.type, value: l.value, description: l.description, leaf: l });
+    };
+    read2(def, light);
+    if (dark && dark !== def) read2(dark, darkOverrides);
+  }
+  const lightRaws = resolveRefs([...light.values()]);
+  const darkRaws = resolveRefs([...light.values()].map((r) => darkOverrides.get(r.path) ?? r));
+  const darkByPath = new Map(darkRaws.map((r) => [r.path, r.value]));
+  const referenced = /* @__PURE__ */ new Set();
+  for (const r of [...light.values(), ...darkOverrides.values()]) {
+    if (r.leaf.aliasTarget) referenced.add(r.leaf.aliasTarget);
+    const m = typeof r.value === "string" ? r.value.trim().match(REF) : null;
+    if (m) referenced.add(m[1]);
+  }
+  const out = [];
+  let hidden = 0;
+  for (const r of lightRaws) {
+    const leaf = light.get(r.path).leaf;
+    if (leaf.hidden) {
+      hidden++;
+      continue;
+    }
+    const t = (r.type ?? "").toLowerCase();
+    const kind = t === "color" ? "color" : t === "boolean" ? "boolean" : t === "string" || t === "fontfamily" || t === "fontweight" ? "string" : typeof r.value === "string" && !/^-?[\d.]+(px|rem)?$/.test(r.value) && !colorValue(r.value) ? "string" : colorValue(r.value) && t !== "number" && t !== "dimension" ? "color" : "number";
+    let tok;
+    if (figma) {
+      const value = kind === "number" && r.value && typeof r.value === "object" ? parseFloat(dim(r.value)) : r.value;
+      tok = classify(r.path.replace(/\./g, "/"), kind, value, { scopes: leaf.scopes?.filter((x2) => x2 !== "ALL_SCOPES") });
+    } else {
+      const flat = flattenTokens({ x: { $type: r.type, $value: r.value } })[0];
+      tok = flat ? { path: flat.type === "color" && !r.path.startsWith("color.") ? `color.${r.path}` : r.path, type: flat.type, value: flat.value } : null;
+    }
+    if (!tok) continue;
+    let darkValue;
+    if (tok.type === "color" && darkOverrides.size) {
+      const d = colorValue(darkByPath.get(r.path));
+      if (d && d !== tok.value) darkValue = d;
+    }
+    out.push({ ...tok, ...darkValue ? { dark: darkValue } : {}, ...r.description ? { description: r.description } : {}, referenced: referenced.has(r.path) });
+  }
+  if (hidden) notes.push(`${hidden} variable${hidden === 1 ? "" : "s"} hidden from publishing were skipped.`);
+  return finish(figma ? "figma-export" : "dtcg", out, notes, opts);
+}
+function importTokens(input2, opts = {}) {
+  if (!input2 || typeof input2 !== "object") throw new Error("Expected a JSON object.");
+  const o = input2;
+  if (Array.isArray(o.$files)) return importTokenFiles(o.$files, opts);
+  const meta3 = o.meta ?? o;
+  if (meta3.variables && meta3.variableCollections) return fromFigmaVariables(meta3, opts);
+  if (Array.isArray(o.styles) && o.styles.every((s) => s && "styleType" in s)) return fromFigmaStyles(o.styles, opts);
+  if (hasDollarValue(o) && hasFigmaExt(o)) return importTokenFiles([{ name: "tokens.json", data: o }], opts);
+  if (hasDollarValue(o) || hasStudioValue(o)) {
+    const studio = !hasDollarValue(o);
+    const flat = flattenTokens(o);
+    if (!flat.length) throw new Error("No tokens found in that file.");
+    const out = flat.map((t) => {
+      if (t.type === "color" && !t.path.startsWith("color.")) return { ...t, path: `color.${t.path}` };
+      return t;
+    });
+    const notes = studio ? [] : [];
+    const res = finish(studio ? "tokens-studio" : "dtcg", out, notes, opts);
+    return res;
+  }
+  const leaves3 = [];
+  plainLeaves(o, [], leaves3);
+  if (leaves3.length) return fromModeObject(o, opts);
+  throw new Error("Couldn't find any tokens. Supported: DTCG, Tokens Studio, Figma variables JSON.");
+}
+function diffTokens(before, after) {
+  const a = new Map(flattenTokens(before).map((t) => [t.path, t]));
+  const b = new Map(flattenTokens(after).map((t) => [t.path, t]));
+  const diff = { added: [], removed: [], changed: [], unchanged: 0 };
+  for (const [p, t] of b) {
+    const old = a.get(p);
+    if (!old) diff.added.push(t);
+    else if (old.value.toLowerCase() !== t.value.toLowerCase() || (old.dark ?? "").toLowerCase() !== (t.dark ?? "").toLowerCase()) diff.changed.push({ path: p, before: old, after: t });
+    else diff.unchanged++;
+  }
+  for (const [p, t] of a) if (!b.has(p)) diff.removed.push(t);
+  return diff;
+}
+function mergeTokens(base, incoming) {
+  const m = new Map(flattenTokens(base).map((t) => [t.path, t]));
+  for (const t of flattenTokens(incoming)) m.set(t.path, { ...m.get(t.path), ...t, description: t.description ?? m.get(t.path)?.description });
+  return buildDtcg([...m.values()]);
+}
+
+// ../engine/src/governance.ts
+var isObj = (v) => !!v && typeof v === "object" && !Array.isArray(v);
+var DATE = /^\d{4}-\d{2}-\d{2}$/;
+function tokenDeprecations(doc) {
+  const out = [];
+  const walk2 = (n, path) => {
+    if (!isObj(n)) return;
+    if ("$value" in n) {
+      const d = n.$deprecated;
+      if (d === void 0 || d === false) return;
+      const ext = isObj(n.$extensions) && isObj(n.$extensions[EXT]) ? n.$extensions[EXT] : {};
+      out.push({
+        path,
+        ...typeof ext.replacement === "string" && ext.replacement ? { replacement: ext.replacement } : {},
+        ...typeof ext.removeAfter === "string" && DATE.test(ext.removeAfter) ? { removeAfter: ext.removeAfter } : {},
+        ...typeof d === "string" && d.trim() ? { reason: d.trim() } : {}
+      });
+      return;
+    }
+    for (const [k, v] of Object.entries(n)) if (!k.startsWith("$")) walk2(v, path ? `${path}.${k}` : k);
+  };
+  walk2(doc, "");
+  return out;
+}
+var describe = (d, cssVars) => {
+  const v = (p) => cssVars && p.includes(".") ? `\`var(--${p.replace(/\./g, "-")})\`` : `\`${p}\``;
+  return `${v(d.path)}${d.replacement ? ` \u2192 use ${v(d.replacement)}` : ""}${d.removeAfter ? ` (removed after ${d.removeAfter})` : ""}${d.reason ? `. ${d.reason}` : ""}`;
+};
+var deprecationLine = describe;
+
 // ../engine/src/config.ts
 var DEFAULT_IGNORE = [
   "**/node_modules/**",
@@ -7937,6 +8565,7 @@ function resolveConfig(config2) {
   const components = config2.components ?? [];
   const replaces = /* @__PURE__ */ new Map();
   for (const c of components) {
+    if (c.status === "deprecated") continue;
     const tags = c.replaces ?? NAME_TO_TAGS[c.name.toLowerCase()] ?? [];
     for (const t of tags) {
       const key = t.toLowerCase().replace(/\s+/g, "").replace(/["']/g, "");
@@ -7952,6 +8581,7 @@ function resolveConfig(config2) {
     fontVars: fontVars.length ? fontVars : ["--font-family-sans"],
     fontSizes: uniqSorted(all.filter((l) => /^font\.size\./.test(l.path)).map((l) => px(l.value)).filter((v) => v !== null)),
     components,
+    deprecatedTokens: new Map(tokenDeprecations(config2.tokens).map((d) => [`--${d.path.replace(/\./g, "-")}`, d])),
     replaces,
     rules: config2.rules ?? {},
     ignore: [...DEFAULT_IGNORE, ...config2.ignore ?? []],
@@ -8677,1295 +9307,766 @@ var radiusScale = {
       }
       for (const m of matches(/(?<![\w-])rounded(?:-[a-z]{1,2})?-\[(\d*\.?\d+)px\]/g, code)) {
         const n = parseFloat(m[1]);
-        if (!ok(n)) out.push({ offset: m.index, message: `${m[0]} is not a radius token`, suggestion: `Use ${neighbours(config2.radii.filter((r) => r < 999), n)}` });
-      }
-      for (const b of styleBindings(code)) {
-        if (!RADIUS_PROP.test(b.prop)) continue;
-        for (const v of pxValues(b.value)) {
-          if (!ok(v.n)) out.push({ offset: b.offset, message: `${b.prop} ${fmt(v.n)} is not a radius token`, suggestion: `Use ${neighbours(config2.radii.filter((r) => r < 999), v.n)}` });
-        }
-      }
-    }
-    return out;
-  }
-};
-var fontFamily = {
-  id: "font-family",
-  title: "Unapproved font",
-  description: "Only the Brand Kit's font families may be used.",
-  defaultSeverity: "warning",
-  kinds: ALL,
-  check({ code, kind, config: config2 }) {
-    if (config2.fonts.length === 0) return [];
-    const out = [];
-    const allowed = config2.fonts;
-    const test = (value, offset) => {
-      const fam = normalizeFontFamily(value);
-      if (!fam || isGenericFont(fam) || allowed.includes(fam)) return;
-      out.push({
-        offset,
-        message: `Font "${fam}" is not in the Brand Kit`,
-        suggestion: `Use var(--font-family-sans) (${allowed[0]})`
-      });
-    };
-    for (const m of matches(/(?<![\w-])font-family\s*:\s*([^;{}\n]+)/g, code)) test(declValue(m[1], kind), m.index);
-    if (kind !== "css") {
-      for (const m of matches(/(?<![\w-])fontFamily\s*:\s*(['"`])([^'"`]+)\1/g, code)) test(m[2], m.index);
-      for (const m of matches(/(?<![\w-])font-\[([^\]]+)\]/g, code)) test(m[1].replace(/_/g, " "), m.index);
-      for (const b of styleBindings(code)) if (b.prop === "font-family") test(b.value, b.offset);
-    }
-    return out;
-  }
-};
-var TEXT_INPUT_TYPES = /* @__PURE__ */ new Set(["", "text", "email", "password", "number", "search", "tel", "url"]);
-var preferOfficialComponent = {
-  id: "prefer-official-component",
-  title: "Re-invented component",
-  description: "Use the design system component instead of a raw HTML element.",
-  defaultSeverity: "error",
-  kinds: MARKUP,
-  check({ code, config: config2, framework }) {
-    if (config2.replaces.size === 0) return [];
-    const out = [];
-    const baseTags = [...new Set([...config2.replaces.keys()].map((k) => k.replace(/\[.*$/, "").replace(/[^a-z0-9-]/g, "")))].filter(Boolean);
-    for (const m of matches(new RegExp(`<(${baseTags.join("|")})(?=[\\s>/])([^>]*)>`, "g"), code)) {
-      const tag = m[1];
-      const attrs = m[2];
-      let comp = config2.replaces.get(tag);
-      if (tag === "input" || tag === "button") {
-        const type = (attrs.match(/\btype\s*=\s*\{?\s*["'`]([\w-]+)["'`]/)?.[1] ?? "").toLowerCase();
-        const specific = config2.replaces.get(`${tag}[type=${type}]`);
-        if (specific) comp = specific;
-        else if (tag === "input" && !TEXT_INPUT_TYPES.has(type)) comp = type === "submit" || type === "button" ? config2.replaces.get("button") : void 0;
-      }
-      if (!comp) continue;
-      const usage = resolveUsage(comp, framework);
-      if (!usage) continue;
-      if (new RegExp(`(?:function|const|class)\\s+${comp.name}\\b`).test(code)) continue;
-      if (framework !== "react" && implementsTag(code, usage.tag)) continue;
-      out.push({
-        offset: m.index,
-        message: `Raw <${tag}${tag === "input" && /type=/.test(attrs) ? ` type="${attrs.match(/type\s*=\s*\{?\s*["'`]([\w-]+)/)?.[1]}"` : ""}> re-implements ${comp.name}`,
-        suggestion: useSuggestion(comp, usage)
-      });
-    }
-    return out;
-  }
-};
-var escapeRe = (s) => s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
-var implementsTag = (code, tag) => new RegExp(`selector\\s*:\\s*['"\`]${escapeRe(tag)}['"\`]|customElements\\.define\\(\\s*['"\`]${escapeRe(tag)}['"\`]|@customElement\\(\\s*['"\`]${escapeRe(tag)}['"\`]`).test(code);
-function useSuggestion(comp, u) {
-  if (u.framework === "react") return `import { ${comp.name} } from "${comp.importPath}"`;
-  const parts = [`Use <${u.tag}>`];
-  if (u.importLine) parts.push(`(${u.importLine})`);
-  return parts.join(" ");
-}
-var forbiddenImport = {
-  id: "forbidden-import",
-  title: "Other UI library",
-  description: "Only the design system's component library may be imported.",
-  defaultSeverity: "error",
-  kinds: ALL,
-  check({ code, config: config2 }) {
-    const out = [];
-    const lib = config2.components[0]?.importPath;
-    const re = /(?:\bimport\s[^'";]*?from\s*|\bimport\s*\(\s*|\bimport\s+|\brequire\(\s*|@import\s+(?:url\(\s*)?)(['"])([^'"]+)\1/g;
-    for (const m of matches(re, code)) {
-      const spec = m[2];
-      const bad = config2.forbiddenImports.find((p) => spec === p || spec.startsWith(`${p}/`));
-      if (!bad) continue;
-      out.push({
-        offset: m.index + m[0].indexOf(spec),
-        message: `Imports ${bad}, which isn't part of the design system`,
-        suggestion: lib ? `Use components from "${lib}"` : "Use the design system's components"
-      });
-    }
-    return out;
-  }
-};
-var imgAlt = {
-  id: "img-alt",
-  title: "Image without alt text",
-  description: "Every <img> needs an alt attribute (empty for decorative images).",
-  defaultSeverity: "warning",
-  kinds: MARKUP,
-  check({ code }) {
-    const out = [];
-    for (const m of matches(/<img(?=[\s/>])([^>]*)>/g, code)) {
-      if (/(?<![\w-])alt\s*=/.test(m[1]) || /\{\s*\.\.\./.test(m[1])) continue;
-      out.push({ offset: m.index, message: "<img> has no alt text", suggestion: 'Add alt="\u2026" describing the image, or alt="" if decorative' });
-    }
-    return out;
-  }
-};
-var NATIVE_ATTRS = new Set(
-  "id className style title role tabIndex hidden lang dir name value defaultValue defaultChecked checked disabled required readOnly autoFocus autoComplete placeholder type min max step maxLength minLength pattern form accept multiple href target rel download children".split(" ")
-);
-var ALWAYS_OK = /* @__PURE__ */ new Set(["key", "ref"]);
-function importedComponents(code, components) {
-  const out = /* @__PURE__ */ new Map();
-  for (const m of matches(/\bimport\s+(?:type\s+)?\{([^}]*)\}\s*from\s*(['"])([^'"]+)\2/g, code)) {
-    const from = m[3];
-    for (const part of m[1].split(",")) {
-      const [orig, alias] = part.trim().replace(/^type\s+/, "").split(/\s+as\s+/).map((s) => s.trim());
-      if (!orig) continue;
-      const comp = components.find((c) => c.name === orig && c.importPath === from && c.props?.length);
-      if (comp) out.set(alias || orig, comp);
-    }
-  }
-  return out;
-}
-function skipBalanced(code, i2) {
-  const open2 = code[i2];
-  if (open2 === '"' || open2 === "'") {
-    const end = code.indexOf(open2, i2 + 1);
-    return end === -1 ? code.length : end + 1;
-  }
-  let depth = 0;
-  let quote = null;
-  for (let j = i2; j < code.length; j++) {
-    const c = code[j];
-    if (quote) {
-      if (c === "\\") j++;
-      else if (c === quote) quote = null;
-      continue;
-    }
-    if (c === '"' || c === "'" || c === "`") quote = c;
-    else if (c === "{") depth++;
-    else if (c === "}" && --depth === 0) return j + 1;
-  }
-  return code.length;
-}
-function parseAttributes(code, start) {
-  const attrs = [];
-  let spread = false;
-  let i2 = start;
-  while (i2 < code.length) {
-    while (/\s/.test(code[i2] ?? "")) i2++;
-    const c = code[i2];
-    if (c === void 0) return null;
-    if (c === ">") return { attrs, spread, selfClosing: false };
-    if (c === "/" && code[i2 + 1] === ">") return { attrs, spread, selfClosing: true };
-    if (c === "{") {
-      spread = true;
-      i2 = skipBalanced(code, i2);
-      continue;
-    }
-    const name = /^[A-Za-z_$][\w$:.-]*/.exec(code.slice(i2, i2 + 80))?.[0];
-    if (!name) return null;
-    attrs.push({ name, offset: i2 });
-    i2 += name.length;
-    while (/\s/.test(code[i2] ?? "")) i2++;
-    if (code[i2] === "=") {
-      i2++;
-      while (/\s/.test(code[i2] ?? "")) i2++;
-      i2 = skipBalanced(code, i2);
-    }
-  }
-  return null;
-}
-function parseHtmlAttributes(code, start) {
-  const attrs = [];
-  let i2 = start;
-  while (i2 < code.length) {
-    while (/\s/.test(code[i2] ?? "")) i2++;
-    const c = code[i2];
-    if (c === void 0) return null;
-    if (c === ">" || c === "/" && code[i2 + 1] === ">") return { attrs, end: i2 };
-    if (c === "{" || c === "<" && code[i2 + 1] === "?") {
-      const close = c === "{" ? code[i2 + 1] === "%" ? "%}" : "}}" : "?>";
-      const e = code.indexOf(close, i2 + 2);
-      i2 = e === -1 ? code.length : e + close.length;
-      continue;
-    }
-    const name = /^[^\s=>/"'{]+/.exec(code.slice(i2, i2 + 120))?.[0];
-    if (!name) return null;
-    attrs.push({ name, offset: i2 });
-    i2 += name.length;
-    while (/\s/.test(code[i2] ?? "")) i2++;
-    if (code[i2] === "=") {
-      i2++;
-      while (/\s/.test(code[i2] ?? "")) i2++;
-      const q = code[i2];
-      if (q === '"' || q === "'") {
-        const e = code.indexOf(q, i2 + 1);
-        i2 = e === -1 ? code.length : e + 1;
-      } else while (i2 < code.length && !/[\s>]/.test(code[i2])) i2++;
-    }
-  }
-  return null;
-}
-var HTML_GLOBAL = /^(?:id|class|style|title|role|hidden|tabindex|lang|dir|slot|part|is|key|ref|name|for|form|aria-.+|data-.+)$/;
-function propName(raw) {
-  let n = raw;
-  if (/^(?:\(|@|on-|v-on:|\*|#|let-|ref-|v-(?!bind:|model:))/.test(n)) return null;
-  n = n.replace(/^v-bind:|^v-model:|^bind-|^:/, "").replace(/^\[\(?|\)?\]$/g, "");
-  if (/^(?:attr|class|style)\./.test(n) || /^ng[A-Z]/.test(n) || /^(?:formControl|formControlName|formGroup|routerLink|routerLinkActive)$/.test(n)) return null;
-  n = n.replace(/\.(?:px|rem|em|%)$/, "").replace(/\..*$/, "");
-  if (HTML_GLOBAL.test(n.toLowerCase())) return null;
-  return n;
-}
-var sameName = (a, b) => a.replace(/-/g, "").toLowerCase() === b.replace(/-/g, "").toLowerCase();
-var NATIVE_EVENT = /^(?:click|dblclick|auxclick|contextmenu|focus|blur|focusin|focusout|key(?:down|up|press)|mouse\w+|pointer\w+|touch\w+|wheel|drag\w*|drop|scroll|animation\w+|transition\w+)$/;
-function eventName(raw) {
-  const m = /^\(([^)]+)\)$|^on-(.+)$|^@([^.]+)|^v-on:([^.]+)/.exec(raw);
-  return m ? (m[1] ?? m[2] ?? m[3] ?? m[4]).replace(/\..*$/, "") : null;
-}
-function templateProps({ code, config: config2, framework }) {
-  const tagged = [];
-  for (const comp of config2.components) {
-    const u = resolveUsage(comp, framework);
-    if (u && (u.props?.length || u.events?.length)) tagged.push({ comp, tag: u.tag, props: u.props, events: u.events, ce: Boolean(u.customElement || u.via) });
-  }
-  if (!tagged.length) return [];
-  const out = [];
-  const forms = /* @__PURE__ */ new Map();
-  for (const t of tagged) {
-    forms.set(t.tag, t);
-    if (framework === "vue") forms.set(t.tag.replace(/([a-z0-9])([A-Z])/g, "$1-$2").toLowerCase(), t);
-  }
-  const names = [...forms.keys()].sort((a, b) => b.length - a.length).map(escapeRe).join("|");
-  for (const m of matches(new RegExp(`<(${names})(?=[\\s/>])`, "g"), code)) {
-    const t = forms.get(m[1]);
-    const parsed = parseHtmlAttributes(code, m.index + m[0].length);
-    if (!parsed) continue;
-    const list = (t.props ?? []).map((p) => p.required ? `${p.name} (required)` : p.name).join(", ");
-    const passed = [];
-    for (const a of parsed.attrs) {
-      const raw = a.name;
-      const ev = eventName(raw);
-      if (ev) {
-        if (!t.events?.length || NATIVE_EVENT.test(ev) || t.events.some((e) => e.name === ev)) continue;
-        const like = t.events.find((e) => e.name.endsWith(`-${ev}`) || e.name.endsWith(ev)) ?? (t.events.length === 1 ? t.events[0] : void 0);
-        out.push({
-          offset: a.offset,
-          message: `<${t.tag}> has no "${ev}" event`,
-          suggestion: `${like ? `Listen to ${framework === "angular" ? `(${like.name})` : framework === "vue" ? `@${like.name}` : `"${like.name}"`}${like.detail ? ` and read ${framework === "angular" ? "$any($event).detail" : framework === "vue" ? "$event.detail" : "event.detail"} (${like.detail})` : ""}. ` : ""}Events: ${t.events.map((e) => e.name).join(", ")}`
-        });
-        continue;
-      }
-      if (/^v-model$/.test(raw)) passed.push("modelValue", "value");
-      if (/^\[\(ngModel\)\]$/.test(raw)) passed.push("value");
-      const n = propName(raw);
-      if (!n || !t.props?.length) continue;
-      passed.push(n);
-      if (t.ce && n.includes("-") && /^(?:\[(?!attr\.)|:|v-bind:|bind-)/.test(raw)) {
-        const camel2 = n.replace(/-([a-z])/g, (_, c) => c.toUpperCase());
-        out.push({
-          offset: a.offset,
-          message: `${raw} binds a property that doesn't exist on <${t.tag}>`,
-          suggestion: `Bind the camelCase property: ${framework === "vue" ? `:${camel2}` : `[${camel2}]`}="\u2026" (kebab-case is only for static attributes: ${n}="\u2026")`
-        });
-        continue;
-      }
-      if (t.props.some((p) => sameName(p.name, n))) continue;
-      out.push({ offset: a.offset, message: `<${t.tag}> has no "${n}" input`, suggestion: `Remove it. ${t.comp.name} takes: ${list}` });
-    }
-    for (const p of t.props ?? []) {
-      if (!p.required || passed.some((n) => sameName(n, p.name))) continue;
-      if (p.name === "children" || p.name === "content") continue;
-      out.push({ offset: m.index, message: `<${t.tag}> is missing the required "${p.name}" input`, suggestion: `Add ${p.name}${p.type ? ` (${p.type})` : ""}` });
-    }
-  }
-  return out;
-}
-var componentProps = {
-  id: "component-props",
-  title: "Unknown or missing prop",
-  description: "Design system components only accept their documented props, and required props must be passed.",
-  defaultSeverity: "error",
-  kinds: MARKUP,
-  check(ctx) {
-    if (ctx.framework !== "react" || ctx.kind !== "jsx") return templateProps(ctx);
-    const { code, config: config2 } = ctx;
-    if (!config2.components.some((c) => c.props?.length)) return [];
-    const imported = importedComponents(code, config2.components);
-    if (imported.size === 0) return [];
-    const out = [];
-    const names = [...imported.keys()].map((n) => n.replace(/[$]/g, "\\$")).join("|");
-    for (const m of matches(new RegExp(`<(${names})(?=[\\s/>])`, "g"), code)) {
-      if (/[\w)\]]\s*$/.test(code.slice(Math.max(0, m.index - 20), m.index))) continue;
-      const comp = imported.get(m[1]);
-      const parsed = parseAttributes(code, m.index + m[0].length);
-      if (!parsed) continue;
-      const own2 = new Map(comp.props.map((p) => [p.name, p]));
-      const list = comp.props.map((p) => p.required ? `${p.name} (required)` : p.name).join(", ");
-      for (const a of parsed.attrs) {
-        if (own2.has(a.name) || ALWAYS_OK.has(a.name) || a.name.includes("-")) continue;
-        if (comp.htmlAttributes && (NATIVE_ATTRS.has(a.name) || /^on[A-Z]/.test(a.name) || /^aria/.test(a.name))) continue;
-        const sibling = config2.components.find(
-          (c) => c !== comp && c.importPath === comp.importPath && (c.name.startsWith(comp.name) || comp.name.startsWith(c.name)) && c.props?.some((p) => p.name === a.name)
-        );
-        out.push({
-          offset: a.offset,
-          message: `<${comp.name}> has no "${a.name}" prop`,
-          suggestion: sibling ? `Use <${sibling.name}>, which has "${a.name}", or remove it. ${comp.name} props: ${list}` : `Remove it. ${comp.name} props: ${list}`
-        });
-      }
-      if (!parsed.spread) {
-        const passed = new Set(parsed.attrs.map((a) => a.name));
-        for (const p of comp.props) {
-          if (!p.required || passed.has(p.name) || p.name === "children" && !parsed.selfClosing) continue;
-          out.push({ offset: m.index, message: `<${comp.name}> is missing the required "${p.name}" prop`, suggestion: `Add ${p.name}${p.type ? ` (${p.type})` : ""}` });
+        if (!ok(n)) out.push({ offset: m.index, message: `${m[0]} is not a radius token`, suggestion: `Use ${neighbours(config2.radii.filter((r) => r < 999), n)}` });
+      }
+      for (const b of styleBindings(code)) {
+        if (!RADIUS_PROP.test(b.prop)) continue;
+        for (const v of pxValues(b.value)) {
+          if (!ok(v.n)) out.push({ offset: b.offset, message: `${b.prop} ${fmt(v.n)} is not a radius token`, suggestion: `Use ${neighbours(config2.radii.filter((r) => r < 999), v.n)}` });
         }
       }
     }
     return out;
   }
 };
-var legacyLibrary = {
-  id: "legacy-library",
-  title: "Other UI library in use",
-  description: "Pieces of Material, MUI, Bootstrap, Ant Design, Chakra or PrimeNG that a design system component replaces. The count is the migration still to do.",
+var fontFamily = {
+  id: "font-family",
+  title: "Unapproved font",
+  description: "Only the Brand Kit's font families may be used.",
   defaultSeverity: "warning",
-  kinds: ["jsx", "vue", "svelte", "html", "template"],
-  check({ code, kind, config: config2, framework }) {
+  kinds: ALL,
+  check({ code, kind, config: config2 }) {
+    if (config2.fonts.length === 0) return [];
     const out = [];
-    for (const u of findLegacyUsages(code, kind)) {
-      const comp = componentForConcept(config2, u.concept);
-      const usage = comp ? resolveUsage(comp, framework) : null;
+    const allowed = config2.fonts;
+    const test = (value, offset) => {
+      const fam = normalizeFontFamily(value);
+      if (!fam || isGenericFont(fam) || allowed.includes(fam)) return;
       out.push({
-        offset: u.offset,
-        message: `${u.what} (${LIBRARY_LABEL[u.library]}) should be ${comp ? comp.name : `a design system ${u.concept}`}`,
-        suggestion: comp && usage ? useSuggestion(comp, usage) : comp ? `${comp.name} has no ${FRAMEWORK_LABEL[framework]} version yet: add one in the registry, or build it with tokens` : `No ${u.concept} component in the registry yet: add one, or build it with tokens and semantic HTML`
+        offset,
+        message: `Font "${fam}" is not in the Brand Kit`,
+        suggestion: `Use var(--font-family-sans) (${allowed[0]})`
       });
+    };
+    for (const m of matches(/(?<![\w-])font-family\s*:\s*([^;{}\n]+)/g, code)) test(declValue(m[1], kind), m.index);
+    if (kind !== "css") {
+      for (const m of matches(/(?<![\w-])fontFamily\s*:\s*(['"`])([^'"`]+)\1/g, code)) test(m[2], m.index);
+      for (const m of matches(/(?<![\w-])font-\[([^\]]+)\]/g, code)) test(m[1].replace(/_/g, " "), m.index);
+      for (const b of styleBindings(code)) if (b.prop === "font-family") test(b.value, b.offset);
     }
     return out;
   }
 };
-var RULES = [
-  noHardcodedColor,
-  noRawPaletteClass,
-  preferOfficialComponent,
-  forbiddenImport,
-  spacingScale,
-  fontFamily,
-  radiusScale,
-  imgAlt,
-  componentProps,
-  legacyLibrary
-];
-var RULE_IDS = RULES.map((r) => r.id);
-
-// ../engine/src/source.ts
-var TEMPLATE_EXTENSIONS = ["mustache", "hbs", "handlebars", "php", "phtml", "twig", "njk", "liquid"];
-function fileKind(path) {
-  const ext = path.toLowerCase().split(".").pop() ?? "";
-  if (TEMPLATE_EXTENSIONS.includes(ext)) return "template";
-  if (["tsx", "jsx", "ts", "js", "mjs", "cjs", "mdx"].includes(ext)) return "jsx";
-  if (ext === "vue") return "vue";
-  if (ext === "svelte") return "svelte";
-  if (["html", "htm", "astro"].includes(ext)) return "html";
-  if (["css", "scss", "sass", "less", "pcss"].includes(ext)) return "css";
-  return "other";
-}
-var SCANNABLE = /* @__PURE__ */ new Set(["jsx", "vue", "svelte", "html", "template", "css"]);
-var ANGULAR_COMPONENT = /@Component\s*\(\s*\{/;
-var ANGULAR_TEMPLATE = /\s(?:\[[\w.()-]+\]|\([\w.]+\)|\*ng[A-Z]\w*)\s*=|@(?:if|for|switch)\s*\(/;
-function fileFramework(path, kind, code, project) {
-  const p = path.toLowerCase();
-  switch (kind) {
-    case "vue":
-      return "vue";
-    case "svelte":
-      return "web-components";
-    case "template":
-      return "html";
-    case "css":
-      return project ?? "react";
-    case "html":
-      if (p.endsWith(".component.html") || project === "angular" || ANGULAR_TEMPLATE.test(code)) return "angular";
-      return project === "vue" || project === "web-components" ? project : "html";
-    case "jsx":
-      if (ANGULAR_COMPONENT.test(code)) return "angular";
-      if (/\.(tsx|jsx|mdx)$/.test(p)) return "react";
-      return project ?? "react";
-    default:
-      return project ?? "react";
-  }
-}
-var blank = (s) => s.replace(/[^\n]/g, " ");
-function stripComments(code, kind) {
-  let out = code;
-  if (kind === "html" || kind === "vue" || kind === "svelte" || kind === "template") {
-    out = out.replace(/<!--[\s\S]*?-->/g, blank);
-  }
-  if (kind === "template") {
-    out = out.replace(/\{\{!--[\s\S]*?--\}\}|\{\{![\s\S]*?\}\}|\{\{--[\s\S]*?--\}\}|\{#[\s\S]*?#\}|\{%-?\s*comment\s*-?%\}[\s\S]*?\{%-?\s*endcomment\s*-?%\}/g, blank).replace(/<\?(?:php|=)?[\s\S]*?(?:\?>|$)/g, (block) => block.replace(/\/\*[\s\S]*?\*\/|(?<![:"'])\/\/[^\n]*?(?=\?>|\n|$)|(?<=\s)#[^\n]*?(?=\?>|\n|$)/g, blank));
-    return out;
-  }
-  if (kind === "css") {
-    return out.replace(/\/\*[\s\S]*?\*\//g, blank).replace(/(^|[^:])\/\/[^\n]*/g, (m, p1) => p1 + blank(m.slice(p1.length)));
-  }
-  const chars = out.split("");
-  let i2 = 0;
-  let quote = null;
-  while (i2 < chars.length) {
-    const c = chars[i2];
-    const n = chars[i2 + 1];
-    if (quote) {
-      if (c === "\\") i2 += 2;
-      else {
-        if (c === quote) quote = null;
-        i2++;
+var TEXT_INPUT_TYPES = /* @__PURE__ */ new Set(["", "text", "email", "password", "number", "search", "tel", "url"]);
+var preferOfficialComponent = {
+  id: "prefer-official-component",
+  title: "Re-invented component",
+  description: "Use the design system component instead of a raw HTML element.",
+  defaultSeverity: "error",
+  kinds: MARKUP,
+  check({ code, config: config2, framework }) {
+    if (config2.replaces.size === 0) return [];
+    const out = [];
+    const baseTags = [...new Set([...config2.replaces.keys()].map((k) => k.replace(/\[.*$/, "").replace(/[^a-z0-9-]/g, "")))].filter(Boolean);
+    for (const m of matches(new RegExp(`<(${baseTags.join("|")})(?=[\\s>/])([^>]*)>`, "g"), code)) {
+      const tag = m[1];
+      const attrs = m[2];
+      let comp = config2.replaces.get(tag);
+      if (tag === "input" || tag === "button") {
+        const type = (attrs.match(/\btype\s*=\s*\{?\s*["'`]([\w-]+)["'`]/)?.[1] ?? "").toLowerCase();
+        const specific = config2.replaces.get(`${tag}[type=${type}]`);
+        if (specific) comp = specific;
+        else if (tag === "input" && !TEXT_INPUT_TYPES.has(type)) comp = type === "submit" || type === "button" ? config2.replaces.get("button") : void 0;
       }
-      continue;
-    }
-    if (c === '"' || c === "'" || c === "`") {
-      quote = c;
-      i2++;
-      continue;
-    }
-    if (c === "/" && n === "*") {
-      const end = out.indexOf("*/", i2 + 2);
-      const stop = end === -1 ? chars.length : end + 2;
-      for (let j = i2; j < stop; j++) if (chars[j] !== "\n") chars[j] = " ";
-      i2 = stop;
-      continue;
-    }
-    if (c === "/" && n === "/" && chars[i2 - 1] !== ":" && kind === "jsx") {
-      while (i2 < chars.length && chars[i2] !== "\n") chars[i2++] = " ";
-      continue;
-    }
-    i2++;
-  }
-  return chars.join("");
-}
-var LineIndex = class {
-  starts = [0];
-  text;
-  constructor(text2) {
-    this.text = text2;
-    for (let i2 = 0; i2 < text2.length; i2++) if (text2.charCodeAt(i2) === 10) this.starts.push(i2 + 1);
-  }
-  position(offset) {
-    let lo = 0;
-    let hi = this.starts.length - 1;
-    while (lo < hi) {
-      const mid = lo + hi + 1 >> 1;
-      if (this.starts[mid] <= offset) lo = mid;
-      else hi = mid - 1;
+      if (!comp) continue;
+      const usage = resolveUsage(comp, framework);
+      if (!usage) continue;
+      if (new RegExp(`(?:function|const|class)\\s+${comp.name}\\b`).test(code)) continue;
+      if (framework !== "react" && implementsTag(code, usage.tag)) continue;
+      out.push({
+        offset: m.index,
+        message: `Raw <${tag}${tag === "input" && /type=/.test(attrs) ? ` type="${attrs.match(/type\s*=\s*\{?\s*["'`]([\w-]+)/)?.[1]}"` : ""}> re-implements ${comp.name}`,
+        suggestion: useSuggestion(comp, usage)
+      });
     }
-    return { line: lo + 1, column: offset - this.starts[lo] + 1 };
-  }
-  lineText(line) {
-    const start = this.starts[line - 1] ?? 0;
-    const end = this.starts[line] ?? this.text.length + 1;
-    return this.text.slice(start, end - 1);
-  }
-  get lineCount() {
-    return this.starts.length;
+    return out;
   }
 };
-function globToRegExp(glob) {
-  let re = "";
-  for (let i2 = 0; i2 < glob.length; i2++) {
-    const c = glob[i2];
-    if (c === "*") {
-      if (glob[i2 + 1] === "*") {
-        const slash = glob[i2 + 2] === "/";
-        re += slash ? "(?:.*/)?" : ".*";
-        i2 += slash ? 2 : 1;
-      } else re += "[^/]*";
-    } else if (c === "?") re += "[^/]";
-    else if (c === "{") {
-      const end = glob.indexOf("}", i2);
-      re += `(?:${glob.slice(i2 + 1, end).split(",").map((s) => s.replace(/[.+^$()|[\]\\]/g, "\\$&")).join("|")})`;
-      i2 = end;
-    } else re += c.replace(/[.+^$()|[\]\\]/g, "\\$&");
-  }
-  return new RegExp(`^${re}$`);
-}
-function makeIgnore(globs) {
-  const res = globs.map(globToRegExp);
-  return (path) => {
-    const p = path.replace(/\\/g, "/").replace(/^\.\//, "");
-    return res.some((r) => r.test(p) || r.test(`/${p}`));
-  };
-}
-
-// ../engine/src/check.ts
-var ENGINE_VERSION = "0.8.0";
-var WEIGHT = { error: 4, warning: 1.5, info: 0.25 };
-function computeScore(counts, lines) {
-  const penalty = counts.error * WEIGHT.error + counts.warning * WEIGHT.warning + counts.info * WEIGHT.info;
-  if (penalty === 0) return 100;
-  const perK = penalty / Math.max(1, lines / 1e3);
-  return Math.max(0, Math.min(99, Math.round(100 / (1 + perK / 25))));
+var escapeRe = (s) => s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+var implementsTag = (code, tag) => new RegExp(`selector\\s*:\\s*['"\`]${escapeRe(tag)}['"\`]|customElements\\.define\\(\\s*['"\`]${escapeRe(tag)}['"\`]|@customElement\\(\\s*['"\`]${escapeRe(tag)}['"\`]`).test(code);
+function useSuggestion(comp, u) {
+  if (u.framework === "react") return `import { ${comp.name} } from "${comp.importPath}"`;
+  const parts = [`Use <${u.tag}>`];
+  if (u.importLine) parts.push(`(${u.importLine})`);
+  return parts.join(" ");
 }
-function check(files, configInput, opts = {}) {
-  const t0 = Date.now();
-  const config2 = "replaces" in configInput ? configInput : resolveConfig(configInput);
-  const ignored = makeIgnore(config2.ignore);
-  const violations = [];
-  let filesScanned = 0;
-  let linesScanned = 0;
-  for (const file2 of files) {
-    const path = file2.path.replace(/\\/g, "/").replace(/^\.\//, "");
-    const kind = fileKind(path);
-    if (!SCANNABLE.has(kind) || ignored(path)) continue;
-    const only = opts.onlyLines?.get(path);
-    if (opts.onlyLines && (!only || only.size === 0)) continue;
-    filesScanned++;
-    const idx = new LineIndex(file2.content);
-    linesScanned += only ? only.size : file2.content.split("\n").filter((l) => l.trim()).length;
-    const code = stripComments(file2.content, kind);
-    const framework = fileFramework(path, kind, code, config2.framework);
-    const seen = /* @__PURE__ */ new Set();
-    for (const rule of RULES) {
-      const setting = config2.rules[rule.id];
-      if (setting === "off" || !rule.kinds.includes(kind)) continue;
-      for (const f of rule.check({ path, kind, code, config: config2, framework })) {
-        const { line, column } = idx.position(f.offset);
-        if (only && !only.has(line)) continue;
-        const key = `${rule.id}:${line}:${column}`;
-        if (seen.has(key)) continue;
-        seen.add(key);
-        violations.push({
-          ruleId: rule.id,
-          severity: setting ?? f.severity ?? rule.defaultSeverity,
-          file: path,
-          line,
-          column,
-          message: f.message,
-          suggestion: f.suggestion,
-          snippet: opts.snippets === false ? void 0 : idx.lineText(line).trim().slice(0, 160)
-        });
-      }
+var forbiddenImport = {
+  id: "forbidden-import",
+  title: "Other UI library",
+  description: "Only the design system's component library may be imported.",
+  defaultSeverity: "error",
+  kinds: ALL,
+  check({ code, config: config2 }) {
+    const out = [];
+    const lib = config2.components[0]?.importPath;
+    const re = /(?:\bimport\s[^'";]*?from\s*|\bimport\s*\(\s*|\bimport\s+|\brequire\(\s*|@import\s+(?:url\(\s*)?)(['"])([^'"]+)\1/g;
+    for (const m of matches(re, code)) {
+      const spec = m[2];
+      const bad = config2.forbiddenImports.find((p) => spec === p || spec.startsWith(`${p}/`));
+      if (!bad) continue;
+      out.push({
+        offset: m.index + m[0].indexOf(spec),
+        message: `Imports ${bad}, which isn't part of the design system`,
+        suggestion: lib ? `Use components from "${lib}"` : "Use the design system's components"
+      });
     }
+    return out;
   }
-  violations.sort((a, b) => a.file.localeCompare(b.file) || a.line - b.line || a.column - b.column);
-  const counts = { error: 0, warning: 0, info: 0 };
-  const perRule = /* @__PURE__ */ new Map();
-  for (const v of violations) {
-    counts[v.severity]++;
-    perRule.set(v.ruleId, (perRule.get(v.ruleId) ?? 0) + 1);
-  }
-  return {
-    engineVersion: ENGINE_VERSION,
-    tokenVersion: config2.tokenVersion,
-    score: computeScore(counts, linesScanned),
-    counts,
-    filesScanned,
-    linesScanned,
-    violations,
-    byRule: [...perRule].map(([ruleId, count]) => ({ ruleId, count })).sort((a, b) => b.count - a.count),
-    durationMs: Date.now() - t0
-  };
-}
-
-// ../engine/src/report.ts
-var RENDERED_ONLY = { "text-contrast": "Low text contrast", "font-size-scale": "Off-scale font size", "page-rendered": "Blank page" };
-var title = (id) => RULES.find((r) => r.id === id)?.title ?? RENDERED_ONLY[id] ?? id;
-var ansi = (on) => {
-  const w = (code) => (s) => on ? `\x1B[${code}m${s}\x1B[0m` : s;
-  return { red: w("31"), yellow: w("33"), cyan: w("36"), green: w("32"), dim: w("2"), bold: w("1") };
 };
-var rendered = (r) => r.violations.length > 0 && r.violations.every((v) => v.line === 0);
-function formatPretty(report, { color = true, max: max2 = 200 } = {}) {
-  const c = ansi(color);
-  const sev = { error: c.red, warning: c.yellow, info: c.cyan };
-  const lines = [];
-  let lastFile = "";
-  for (const v of report.violations.slice(0, max2)) {
-    if (v.file !== lastFile) {
-      lines.push("", c.bold(v.file));
-      lastFile = v.file;
-    }
-    const rendered2 = v.line === 0;
-    lines.push(`  ${c.dim(rendered2 ? "".padEnd(8) : `${v.line}:${v.column}`.padEnd(8))} ${sev[v.severity](v.severity.padEnd(7))} ${v.message}  ${c.dim(v.ruleId)}`);
-    if (v.suggestion) lines.push(`  ${" ".repeat(16)} ${c.green("\u2192")} ${v.suggestion}`);
-    if (rendered2 && v.snippet) lines.push(`  ${" ".repeat(16)} ${c.dim(`on ${v.snippet}`)}`);
-  }
-  if (report.violations.length > max2) lines.push("", c.dim(`\u2026 and ${report.violations.length - max2} more`));
-  const s = report.score;
-  const scoreStr = s >= 80 ? c.green(String(s)) : s >= 65 ? c.yellow(String(s)) : c.red(String(s));
-  lines.push(
-    "",
-    `${c.bold("Brand score")} ${scoreStr}/100  ${c.dim("\xB7")} ${c.red(`${report.counts.error} errors`)} ${c.dim("\xB7")} ${c.yellow(`${report.counts.warning} warnings`)} ${c.dim("\xB7")} ${c.cyan(`${report.counts.info} info`)}`,
-    c.dim(`${report.filesScanned} ${rendered(report) ? "pages" : "files"}, ${report.linesScanned} ${rendered(report) ? "elements" : "lines"} in ${report.durationMs}ms${report.tokenVersion ? ` \xB7 Brand Kit v${report.tokenVersion}` : ""}`)
-  );
-  return lines.join("\n");
-}
-var esc = (s) => s.replace(/%/g, "%25").replace(/\r/g, "%0D").replace(/\n/g, "%0A");
-var escProp = (s) => esc(s).replace(/:/g, "%3A").replace(/,/g, "%2C");
-function formatGithubAnnotations(report, max2 = 50) {
-  const level = { error: "error", warning: "warning", info: "notice" };
-  return report.violations.slice(0, max2).map(
-    (v) => `::${level[v.severity]} file=${escProp(v.file)},line=${v.line},col=${v.column},title=${escProp(`Brandrail: ${title(v.ruleId)}`)}::${esc(
-      v.suggestion ? `${v.message}. ${v.suggestion}` : v.message
-    )}`
-  ).join("\n");
-}
-var COMMENT_MARKER = "<!-- brandrail-report -->";
-function formatMarkdown(report, opts = {}) {
-  const { threshold, maxRows = 30 } = opts;
-  const pass = threshold === void 0 || report.score >= threshold;
-  const badge = report.violations.length === 0 ? "\u{1F7E2}" : pass ? "\u{1F7E1}" : "\u{1F534}";
-  const out = [COMMENT_MARKER];
-  out.push(`## ${badge} Brand score: **${report.score}**/100${threshold !== void 0 ? ` (threshold ${threshold})` : ""}`);
-  out.push("");
-  out.push(
-    `**${report.counts.error}** errors \xB7 **${report.counts.warning}** warnings \xB7 **${report.counts.info}** info \u2014 ${report.filesScanned} files scanned${report.tokenVersion ? ` against Brand Kit v${report.tokenVersion}` : ""}`
-  );
-  if (report.violations.length === 0) {
-    out.push("", "Everything uses approved tokens and components. \u2728");
-  } else {
-    if (report.byRule.length) {
-      out.push("", "| Rule | Count |", "| --- | ---: |");
-      for (const r of report.byRule) out.push(`| ${title(r.ruleId)} \`${r.ruleId}\` | ${r.count} |`);
-    }
-    out.push("", "<details><summary>Violations</summary>", "", "| | Location | Issue | Fix |", "| --- | --- | --- | --- |");
-    const icon = { error: "\u{1F534}", warning: "\u{1F7E1}", info: "\u{1F535}" };
-    for (const v of report.violations.slice(0, maxRows)) {
-      const loc = v.line === 0 ? `${v.file} ${v.snippet ?? ""}`.trim() : `${v.file}:${v.line}`;
-      const url2 = opts.fileUrl?.(v);
-      const cell = (s) => s.replace(/\|/g, "\\|").replace(/\n/g, " ");
-      out.push(`| ${icon[v.severity]} | ${url2 ? `[\`${loc}\`](${url2})` : `\`${loc}\``} | ${cell(v.message)} | ${cell(v.suggestion ?? "")} |`);
+var imgAlt = {
+  id: "img-alt",
+  title: "Image without alt text",
+  description: "Every <img> needs an alt attribute (empty for decorative images).",
+  defaultSeverity: "warning",
+  kinds: MARKUP,
+  check({ code }) {
+    const out = [];
+    for (const m of matches(/<img(?=[\s/>])([^>]*)>/g, code)) {
+      if (/(?<![\w-])alt\s*=/.test(m[1]) || /\{\s*\.\.\./.test(m[1])) continue;
+      out.push({ offset: m.index, message: "<img> has no alt text", suggestion: 'Add alt="\u2026" describing the image, or alt="" if decorative' });
     }
-    if (report.violations.length > maxRows) out.push("", `\u2026and ${report.violations.length - maxRows} more.`);
-    out.push("", "</details>");
+    return out;
   }
-  out.push("", `<sub>Brandrail engine ${report.engineVersion}${opts.dashboardUrl ? ` \xB7 [Open in Brandrail](${opts.dashboardUrl})` : ""}</sub>`);
-  return out.join("\n");
-}
-
-// ../engine/src/defaults.ts
-var starterConfig = {
-  $schema: "https://brandrail.dev/schema/config.json",
-  tokenVersion: "0.0.0-local",
-  tokens: {
-    color: {
-      action: { primary: { $type: "color", $value: "#1f883d", $description: "One primary action per view" } },
-      accent: { default: { $type: "color", $value: "#0969da", $description: "Links, focus, selection" } },
-      fg: {
-        default: { $type: "color", $value: "#1f2328", $description: "Body text" },
-        muted: { $type: "color", $value: "#59636e", $description: "Secondary text" }
-      },
-      canvas: {
-        default: { $type: "color", $value: "#ffffff", $description: "Page background" },
-        subtle: { $type: "color", $value: "#f6f8fa", $description: "Headers, wells" }
-      },
-      border: { default: { $type: "color", $value: "#d1d9e0", $description: "Borders and dividers" } },
-      danger: { default: { $type: "color", $value: "#cf222e", $description: "Destructive actions, errors" } },
-      success: { default: { $type: "color", $value: "#1a7f37", $description: "Success messages, completed states" } },
-      attention: { default: { $type: "color", $value: "#9a6700", $description: "Warnings, needs attention" } }
-    },
-    font: {
-      family: { sans: { $type: "fontFamily", $value: "-apple-system, BlinkMacSystemFont, 'Segoe UI', 'Noto Sans', Helvetica, Arial, sans-serif" } },
-      size: { base: { $type: "dimension", $value: "14px" } }
-    },
-    radius: { md: { $type: "dimension", $value: "6px" } },
-    space: { unit: { $type: "dimension", $value: "8px" } }
-  },
-  components: [
-    { name: "Button", importPath: "@acme/ui" },
-    { name: "TextInput", importPath: "@acme/ui" },
-    { name: "Select", importPath: "@acme/ui" },
-    { name: "Textarea", importPath: "@acme/ui" }
-  ],
-  rules: {},
-  ignore: []
-};
-
-// ../engine/src/tokens.ts
-var EXT = "dev.brandrail";
-function slug(s) {
-  return s.replace(/([a-z])([A-Z])/g, "$1-$2").replace(/([A-Za-z])(\d)/g, "$1-$2").replace(/[^A-Za-z0-9]+/g, "-").replace(/^-+|-+$/g, "").toLowerCase();
-}
-var segs = (name) => name.split(/[/$.]+/).map(slug).filter(Boolean);
-var stripPrefix = (s, ...prefixes) => {
-  for (const p of prefixes) if (s === p) return "";
-  for (const p of prefixes) if (s.startsWith(`${p}-`)) return s.slice(p.length + 1);
-  return s;
-};
-var WEIGHTS = {
-  thin: "100",
-  hairline: "100",
-  "extra-light": "200",
-  "ultra-light": "200",
-  light: "300",
-  regular: "400",
-  regulare: "400",
-  normal: "400",
-  book: "400",
-  medium: "500",
-  "semi-bold": "600",
-  semibold: "600",
-  "demi-bold": "600",
-  bold: "700",
-  "extra-bold": "800",
-  "ultra-bold": "800",
-  black: "900",
-  heavy: "900"
 };
-function fontWeight(v) {
-  if (typeof v === "number") return String(v);
-  return WEIGHTS[slug(v)] ?? (/^\d{3}$/.test(v.trim()) ? v.trim() : v);
-}
-function colorValue(v) {
-  if (v && typeof v === "object" && ("components" in v || "hex" in v)) {
-    const c = v;
-    const alpha = typeof c.alpha === "number" ? c.alpha : 1;
-    const withAlpha = (hex4) => alpha < 1 ? `${hex4.slice(0, 7)}${Math.round(alpha * 255).toString(16).padStart(2, "0")}` : hex4.slice(0, 7);
-    if (typeof c.hex === "string" && /^#[0-9a-f]{6}/i.test(c.hex)) return withAlpha(c.hex.toLowerCase());
-    const comps = c.components?.map((x2) => typeof x2 === "number" ? x2 : 0);
-    if (comps?.length === 3 && (!c.colorSpace || /srgb|display-p3/i.test(c.colorSpace))) {
-      return withAlpha(toHex({ r: comps[0] * 255, g: comps[1] * 255, b: comps[2] * 255, a: 1 }));
-    }
-    return null;
-  }
-  if (v && typeof v === "object" && "r" in v) {
-    const c = v;
-    const hex4 = toHex({ r: c.r * 255, g: c.g * 255, b: c.b * 255, a: 1 });
-    const a = c.a ?? 1;
-    return a < 1 ? `${hex4}${Math.round(a * 255).toString(16).padStart(2, "0")}` : hex4;
-  }
-  if (typeof v !== "string") return null;
-  const s = v.trim();
-  if (/^#[0-9a-f]{3,8}$/i.test(s)) {
-    const h = s.slice(1).toLowerCase();
-    return h.length === 3 || h.length === 4 ? `#${[...h].map((c) => c + c).join("")}` : `#${h}`;
-  }
-  const rgb = parseColor(s);
-  if (!rgb) return null;
-  const hex3 = toHex(rgb);
-  return rgb.a < 1 ? `${hex3}${Math.round(rgb.a * 255).toString(16).padStart(2, "0")}` : hex3;
-}
-var dim = (v) => {
-  if (v && typeof v === "object" && "value" in v) {
-    const d = v;
-    const n = typeof d.value === "number" ? d.value : parseFloat(d.value);
-    return d.unit === "rem" ? `${Math.round(n * 16 * 100) / 100}px` : `${Math.round(n * 100) / 100}px`;
+var NATIVE_ATTRS = new Set(
+  "id className style title role tabIndex hidden lang dir name value defaultValue defaultChecked checked disabled required readOnly autoFocus autoComplete placeholder type min max step maxLength minLength pattern form accept multiple href target rel download children".split(" ")
+);
+var ALWAYS_OK = /* @__PURE__ */ new Set(["key", "ref"]);
+function importedComponents(code, components) {
+  const out = /* @__PURE__ */ new Map();
+  for (const m of matches(/\bimport\s+(?:type\s+)?\{([^}]*)\}\s*from\s*(['"])([^'"]+)\2/g, code)) {
+    const from = m[3];
+    for (const part of m[1].split(",")) {
+      const [orig, alias] = part.trim().replace(/^type\s+/, "").split(/\s+as\s+/).map((s) => s.trim());
+      if (!orig) continue;
+      const comp = components.find((c) => c.name === orig && c.importPath === from && c.props?.length);
+      if (comp) out.set(alias || orig, comp);
+    }
   }
-  return typeof v === "number" ? `${Math.round(v * 100) / 100}px` : String(v).trim();
-};
-function classify(name, kind, value, opts = {}) {
-  const parts = segs(name);
-  const hay = slug(`${opts.context ?? ""} ${name}`);
-  const scopes = opts.scopes ?? [];
-  const last = parts[parts.length - 1] ?? "";
-  const rest = parts.slice(0, -1);
-  if (kind === "boolean") return null;
-  if (kind === "color") {
-    const v2 = colorValue(value);
-    if (!v2) return null;
-    let p = parts[0] === "color" || parts[0] === "colors" ? parts.slice(1) : parts;
-    if (p.length === 1) p = [stripPrefix(p[0], "colors", "color") || p[0]];
-    const tail = p[p.length - 1];
-    const m = tail.match(/^(.*[a-z])-(\d+)$/);
-    if (m && p.length <= 2) p = [...p.slice(0, -1), m[1], m[2]];
-    return { path: ["color", ...p].join("."), type: "color", value: v2 };
+  return out;
+}
+function skipBalanced(code, i2) {
+  const open2 = code[i2];
+  if (open2 === '"' || open2 === "'") {
+    const end = code.indexOf(open2, i2 + 1);
+    return end === -1 ? code.length : end + 1;
   }
-  if (kind === "string") {
-    const s = String(value);
-    if (scopes.includes("FONT_FAMILY") || /font-family|typeface|font-name/.test(hay) || last === "font") {
-      const n = stripPrefix(last, "font-family", "font", "family") || "sans";
-      return { path: `font.family.${/mono|code/.test(s.toLowerCase()) && n === "sans" ? "mono" : n}`, type: "fontFamily", value: s };
+  let depth = 0;
+  let quote = null;
+  for (let j = i2; j < code.length; j++) {
+    const c = code[j];
+    if (quote) {
+      if (c === "\\") j++;
+      else if (c === quote) quote = null;
+      continue;
     }
-    if (scopes.includes("FONT_STYLE") || scopes.includes("FONT_WEIGHT") || /font-weight|weight/.test(hay)) {
-      return { path: `font.weight.${stripPrefix(last, "font-weight", "weight") || last}`, type: "fontWeight", value: fontWeight(s) };
+    if (c === '"' || c === "'" || c === "`") quote = c;
+    else if (c === "{") depth++;
+    else if (c === "}" && --depth === 0) return j + 1;
+  }
+  return code.length;
+}
+function parseAttributes(code, start) {
+  const attrs = [];
+  let spread = false;
+  let i2 = start;
+  while (i2 < code.length) {
+    while (/\s/.test(code[i2] ?? "")) i2++;
+    const c = code[i2];
+    if (c === void 0) return null;
+    if (c === ">") return { attrs, spread, selfClosing: false };
+    if (c === "/" && code[i2 + 1] === ">") return { attrs, spread, selfClosing: true };
+    if (c === "{") {
+      spread = true;
+      i2 = skipBalanced(code, i2);
+      continue;
+    }
+    const name = /^[A-Za-z_$][\w$:.-]*/.exec(code.slice(i2, i2 + 80))?.[0];
+    if (!name) return null;
+    attrs.push({ name, offset: i2 });
+    i2 += name.length;
+    while (/\s/.test(code[i2] ?? "")) i2++;
+    if (code[i2] === "=") {
+      i2++;
+      while (/\s/.test(code[i2] ?? "")) i2++;
+      i2 = skipBalanced(code, i2);
     }
-    const c = colorValue(s);
-    if (c && /^#|^rgb|^hsl/i.test(s.trim())) return classify(name, "color", s, opts);
-    return null;
   }
-  const v = dim(value);
-  const has = (...scope) => scope.some((x2) => scopes.includes(x2));
-  const nm = (...prefixes) => stripPrefix(last, ...prefixes) || last;
-  if (has("CORNER_RADIUS") || /radius|(^|-)rad(-|$)|corner|rounded/.test(hay)) return { path: `radius.${nm("radius", "rad", "corner", "rounded")}`, type: "dimension", value: v };
-  if (has("FONT_SIZE") || /font-size|text-size/.test(hay)) return { path: `font.size.${nm("font-size", "text-size", "size")}`, type: "dimension", value: v };
-  if (has("LINE_HEIGHT") || /line-height|leading/.test(hay)) return { path: `font.line-height.${nm("line-height", "leading")}`, type: "dimension", value: v };
-  if (has("LETTER_SPACING") || /letter-spacing|tracking/.test(hay)) return { path: `font.letter-spacing.${nm("letter-spacing", "tracking")}`, type: "dimension", value: v };
-  if (has("FONT_WEIGHT") || /font-weight/.test(hay)) return { path: `font.weight.${nm("font-weight", "weight")}`, type: "fontWeight", value: String(value) };
-  if (/icon/.test(last)) return { path: `size.icon.${nm("icon")}`, type: "dimension", value: v };
-  if (has("GAP") || /spac|gap|padding|margin|inset|(^|-)space(-|$)/.test(hay)) return { path: `space.${nm("spacing", "space", "gap")}`, type: "dimension", value: v };
-  if (has("STROKE_FLOAT") || /stroke|border-width/.test(hay)) return { path: `border.width.${nm("border-width", "stroke")}`, type: "dimension", value: v };
-  if (has("WIDTH_HEIGHT") || /size|width|height/.test(hay)) return { path: ["size", ...rest.filter((x2) => x2 !== "size"), last].join("."), type: "dimension", value: v };
-  return { path: ["number", ...parts].join("."), type: "number", value: String(value) };
+  return null;
 }
-function rawLeaves(node2, prefix, out, studio, inherited) {
-  if (!node2 || typeof node2 !== "object" || Array.isArray(node2)) return;
-  const o = node2;
-  const groupType = o.$type ?? inherited;
-  const isLeaf = "$value" in o || studio && "value" in o && (typeof o.value !== "object" || o.value === null || "type" in o);
-  if (isLeaf) {
-    const ext = o.$extensions?.[EXT];
-    out.push({
-      path: prefix,
-      type: o.$type ?? o.type ?? groupType,
-      value: "$value" in o ? o.$value : o.value,
-      description: o.$description ?? o.description,
-      dark: ext?.modes?.dark
-    });
-    return;
+function parseHtmlAttributes(code, start) {
+  const attrs = [];
+  let i2 = start;
+  while (i2 < code.length) {
+    while (/\s/.test(code[i2] ?? "")) i2++;
+    const c = code[i2];
+    if (c === void 0) return null;
+    if (c === ">" || c === "/" && code[i2 + 1] === ">") return { attrs, end: i2 };
+    if (c === "{" || c === "<" && code[i2 + 1] === "?") {
+      const close = c === "{" ? code[i2 + 1] === "%" ? "%}" : "}}" : "?>";
+      const e = code.indexOf(close, i2 + 2);
+      i2 = e === -1 ? code.length : e + close.length;
+      continue;
+    }
+    const name = /^[^\s=>/"'{]+/.exec(code.slice(i2, i2 + 120))?.[0];
+    if (!name) return null;
+    attrs.push({ name, offset: i2 });
+    i2 += name.length;
+    while (/\s/.test(code[i2] ?? "")) i2++;
+    if (code[i2] === "=") {
+      i2++;
+      while (/\s/.test(code[i2] ?? "")) i2++;
+      const q = code[i2];
+      if (q === '"' || q === "'") {
+        const e = code.indexOf(q, i2 + 1);
+        i2 = e === -1 ? code.length : e + 1;
+      } else while (i2 < code.length && !/[\s>]/.test(code[i2])) i2++;
+    }
   }
-  for (const [k, v] of Object.entries(o)) if (!k.startsWith("$")) rawLeaves(v, prefix ? `${prefix}.${k}` : k, out, studio, groupType);
+  return null;
 }
-var REF = /^\{([^}]+)\}$/;
-function resolveRefs(raws) {
-  const byPath = new Map(raws.map((r) => [r.path, r]));
-  const deref = (v, mode, depth = 0) => {
-    if (typeof v !== "string" || depth > 10) return v;
-    const m = v.trim().match(REF);
-    if (!m) return v.replace(/\{([^}]+)\}/g, (all, p) => String(byPath.get(p)?.value ?? all));
-    const target = byPath.get(m[1]);
-    if (!target) return v;
-    return deref(mode === "dark" && target.dark !== void 0 ? target.dark : target.value, mode, depth + 1);
-  };
-  return raws.map((r) => ({ ...r, value: deref(r.value, "light"), dark: r.dark !== void 0 ? deref(r.dark, "dark") : void 0 }));
+var HTML_GLOBAL = /^(?:id|class|style|title|role|hidden|tabindex|lang|dir|slot|part|is|key|ref|name|for|form|aria-.+|data-.+)$/;
+function propName(raw) {
+  let n = raw;
+  if (/^(?:\(|@|on-|v-on:|\*|#|let-|ref-|v-(?!bind:|model:))/.test(n)) return null;
+  n = n.replace(/^v-bind:|^v-model:|^bind-|^:/, "").replace(/^\[\(?|\)?\]$/g, "");
+  if (/^(?:attr|class|style)\./.test(n) || /^ng[A-Z]/.test(n) || /^(?:formControl|formControlName|formGroup|routerLink|routerLinkActive)$/.test(n)) return null;
+  n = n.replace(/\.(?:px|rem|em|%)$/, "").replace(/\..*$/, "");
+  if (HTML_GLOBAL.test(n.toLowerCase())) return null;
+  return n;
 }
-var TYPE_KIND = {
-  color: "color",
-  dimension: "number",
-  spacing: "number",
-  sizing: "number",
-  borderradius: "number",
-  fontsizes: "number",
-  fontsize: "number",
-  lineheights: "number",
-  lineheight: "number",
-  letterspacing: "number",
-  number: "number",
-  fontfamilies: "string",
-  fontfamily: "string",
-  fontweights: "string",
-  fontweight: "string"
-};
-function flattenTokens(doc) {
-  const raws = resolveRefs(collectRaw(doc).raws);
+var sameName = (a, b) => a.replace(/-/g, "").toLowerCase() === b.replace(/-/g, "").toLowerCase();
+var NATIVE_EVENT = /^(?:click|dblclick|auxclick|contextmenu|focus|blur|focusin|focusout|key(?:down|up|press)|mouse\w+|pointer\w+|touch\w+|wheel|drag\w*|drop|scroll|animation\w+|transition\w+)$/;
+function eventName(raw) {
+  const m = /^\(([^)]+)\)$|^on-(.+)$|^@([^.]+)|^v-on:([^.]+)/.exec(raw);
+  return m ? (m[1] ?? m[2] ?? m[3] ?? m[4]).replace(/\..*$/, "") : null;
+}
+function templateProps({ code, config: config2, framework }) {
+  const tagged = [];
+  for (const comp of config2.components) {
+    const u = resolveUsage(comp, framework);
+    if (u && (u.props?.length || u.events?.length)) tagged.push({ comp, tag: u.tag, props: u.props, events: u.events, ce: Boolean(u.customElement || u.via) });
+  }
+  if (!tagged.length) return [];
   const out = [];
-  for (const r of raws) {
-    const t = (r.type ?? "").toLowerCase().replace(/[^a-z]/g, "");
-    if (t === "color" || !t && r.path.startsWith("color")) {
-      const v = colorValue(r.value);
-      if (!v) continue;
-      const d = r.dark !== void 0 ? colorValue(r.dark) : null;
-      out.push({ path: r.path, type: "color", value: v, ...d ? { dark: d } : {}, ...r.description ? { description: r.description } : {} });
-    } else if (typeof r.value === "string" || typeof r.value === "number" || r.value && typeof r.value === "object" && "unit" in r.value) {
-      const type = typeof r.value === "object" ? "dimension" : t === "fontfamily" || t === "fontfamilies" ? "fontFamily" : t === "fontweight" || t === "fontweights" ? "fontWeight" : TYPE_KIND[t] === "number" ? "dimension" : t === "number" ? "number" : /^font\.family\./.test(r.path) ? "fontFamily" : typeof r.value === "number" ? "number" : /px$|rem$/.test(String(r.value)) ? "dimension" : "string";
-      out.push({ path: r.path, type, value: type === "dimension" ? dim(r.value) : String(r.value), ...r.description ? { description: r.description } : {} });
+  const forms = /* @__PURE__ */ new Map();
+  for (const t of tagged) {
+    forms.set(t.tag, t);
+    if (framework === "vue") forms.set(t.tag.replace(/([a-z0-9])([A-Z])/g, "$1-$2").toLowerCase(), t);
+  }
+  const names = [...forms.keys()].sort((a, b) => b.length - a.length).map(escapeRe).join("|");
+  for (const m of matches(new RegExp(`<(${names})(?=[\\s/>])`, "g"), code)) {
+    const t = forms.get(m[1]);
+    const parsed = parseHtmlAttributes(code, m.index + m[0].length);
+    if (!parsed) continue;
+    const list = (t.props ?? []).map((p) => p.required ? `${p.name} (required)` : p.name).join(", ");
+    const passed = [];
+    for (const a of parsed.attrs) {
+      const raw = a.name;
+      const ev = eventName(raw);
+      if (ev) {
+        if (!t.events?.length || NATIVE_EVENT.test(ev) || t.events.some((e) => e.name === ev)) continue;
+        const like = t.events.find((e) => e.name.endsWith(`-${ev}`) || e.name.endsWith(ev)) ?? (t.events.length === 1 ? t.events[0] : void 0);
+        out.push({
+          offset: a.offset,
+          message: `<${t.tag}> has no "${ev}" event`,
+          suggestion: `${like ? `Listen to ${framework === "angular" ? `(${like.name})` : framework === "vue" ? `@${like.name}` : `"${like.name}"`}${like.detail ? ` and read ${framework === "angular" ? "$any($event).detail" : framework === "vue" ? "$event.detail" : "event.detail"} (${like.detail})` : ""}. ` : ""}Events: ${t.events.map((e) => e.name).join(", ")}`
+        });
+        continue;
+      }
+      if (/^v-model$/.test(raw)) passed.push("modelValue", "value");
+      if (/^\[\(ngModel\)\]$/.test(raw)) passed.push("value");
+      const n = propName(raw);
+      if (!n || !t.props?.length) continue;
+      passed.push(n);
+      if (t.ce && n.includes("-") && /^(?:\[(?!attr\.)|:|v-bind:|bind-)/.test(raw)) {
+        const camel2 = n.replace(/-([a-z])/g, (_, c) => c.toUpperCase());
+        out.push({
+          offset: a.offset,
+          message: `${raw} binds a property that doesn't exist on <${t.tag}>`,
+          suggestion: `Bind the camelCase property: ${framework === "vue" ? `:${camel2}` : `[${camel2}]`}="\u2026" (kebab-case is only for static attributes: ${n}="\u2026")`
+        });
+        continue;
+      }
+      if (t.props.some((p) => sameName(p.name, n))) continue;
+      out.push({ offset: a.offset, message: `<${t.tag}> has no "${n}" input`, suggestion: `Remove it. ${t.comp.name} takes: ${list}` });
+    }
+    for (const p of t.props ?? []) {
+      if (!p.required || passed.some((n) => sameName(n, p.name))) continue;
+      if (p.name === "children" || p.name === "content") continue;
+      out.push({ offset: m.index, message: `<${t.tag}> is missing the required "${p.name}" input`, suggestion: `Add ${p.name}${p.type ? ` (${p.type})` : ""}` });
     }
   }
   return out;
 }
-function collectRaw(doc) {
-  const o = doc ?? {};
-  const studio = !hasDollarValue(o) && hasStudioValue(o);
-  const order = o.$metadata?.tokenSetOrder;
-  if (!studio) {
-    const raws = [];
-    rawLeaves(o, "", raws, false);
-    return { raws, studio };
-  }
-  const setNames = (order ?? Object.keys(o).filter((k) => !k.startsWith("$"))).filter((k) => o[k] && typeof o[k] === "object");
-  const looksLikeSets = setNames.length > 0 && setNames.every((k) => !hasLeafAtTop(o[k]));
-  if (!looksLikeSets) {
-    const raws = [];
-    rawLeaves(o, "", raws, true);
-    return { raws, studio };
+var componentProps = {
+  id: "component-props",
+  title: "Unknown or missing prop",
+  description: "Design system components only accept their documented props, and required props must be passed.",
+  defaultSeverity: "error",
+  kinds: MARKUP,
+  check(ctx) {
+    if (ctx.framework !== "react" || ctx.kind !== "jsx") return templateProps(ctx);
+    const { code, config: config2 } = ctx;
+    if (!config2.components.some((c) => c.props?.length)) return [];
+    const imported = importedComponents(code, config2.components);
+    if (imported.size === 0) return [];
+    const out = [];
+    const names = [...imported.keys()].map((n) => n.replace(/[$]/g, "\\$")).join("|");
+    for (const m of matches(new RegExp(`<(${names})(?=[\\s/>])`, "g"), code)) {
+      if (/[\w)\]]\s*$/.test(code.slice(Math.max(0, m.index - 20), m.index))) continue;
+      const comp = imported.get(m[1]);
+      const parsed = parseAttributes(code, m.index + m[0].length);
+      if (!parsed) continue;
+      const own2 = new Map(comp.props.map((p) => [p.name, p]));
+      const list = comp.props.map((p) => p.required ? `${p.name} (required)` : p.name).join(", ");
+      for (const a of parsed.attrs) {
+        if (own2.has(a.name) || ALWAYS_OK.has(a.name) || a.name.includes("-")) continue;
+        if (comp.htmlAttributes && (NATIVE_ATTRS.has(a.name) || /^on[A-Z]/.test(a.name) || /^aria/.test(a.name))) continue;
+        const sibling = config2.components.find(
+          (c) => c !== comp && c.importPath === comp.importPath && (c.name.startsWith(comp.name) || comp.name.startsWith(c.name)) && c.props?.some((p) => p.name === a.name)
+        );
+        out.push({
+          offset: a.offset,
+          message: `<${comp.name}> has no "${a.name}" prop`,
+          suggestion: sibling ? `Use <${sibling.name}>, which has "${a.name}", or remove it. ${comp.name} props: ${list}` : `Remove it. ${comp.name} props: ${list}`
+        });
+      }
+      if (!parsed.spread) {
+        const passed = new Set(parsed.attrs.map((a) => a.name));
+        for (const p of comp.props) {
+          if (!p.required || passed.has(p.name) || p.name === "children" && !parsed.selfClosing) continue;
+          out.push({ offset: m.index, message: `<${comp.name}> is missing the required "${p.name}" prop`, suggestion: `Add ${p.name}${p.type ? ` (${p.type})` : ""}` });
+        }
+      }
+    }
+    return out;
   }
-  const merged = /* @__PURE__ */ new Map();
-  const darkSets = setNames.filter((n) => /dark/i.test(n));
-  for (const set2 of setNames.filter((n) => !/dark/i.test(n))) {
-    const raws = [];
-    rawLeaves(o[set2], "", raws, true);
-    for (const r of raws) merged.set(r.path, r);
+};
+var legacyLibrary = {
+  id: "legacy-library",
+  title: "Other UI library in use",
+  description: "Pieces of Material, MUI, Bootstrap, Ant Design, Chakra or PrimeNG that a design system component replaces. The count is the migration still to do.",
+  defaultSeverity: "warning",
+  kinds: ["jsx", "vue", "svelte", "html", "template"],
+  check({ code, kind, config: config2, framework }) {
+    const out = [];
+    for (const u of findLegacyUsages(code, kind)) {
+      const comp = componentForConcept(config2, u.concept);
+      const usage = comp ? resolveUsage(comp, framework) : null;
+      out.push({
+        offset: u.offset,
+        message: `${u.what} (${LIBRARY_LABEL[u.library]}) should be ${comp ? comp.name : `a design system ${u.concept}`}`,
+        suggestion: comp && usage ? useSuggestion(comp, usage) : comp ? `${comp.name} has no ${FRAMEWORK_LABEL[framework]} version yet: add one in the registry, or build it with tokens` : `No ${u.concept} component in the registry yet: add one, or build it with tokens and semantic HTML`
+      });
+    }
+    return out;
   }
-  for (const set2 of darkSets) {
-    const raws = [];
-    rawLeaves(o[set2], "", raws, true);
-    for (const r of raws) {
-      const base = merged.get(r.path);
-      if (base) base.dark = r.value;
-      else merged.set(r.path, r);
+};
+var whenGone = (d) => d.removeAfter ? ` and will be removed after ${d.removeAfter}` : "";
+var deprecatedToken = {
+  id: "deprecated-token",
+  title: "Deprecated token",
+  description: "Tokens the design system is retiring. They still work until their removal date; switch to the replacement.",
+  defaultSeverity: "warning",
+  kinds: ALL,
+  check({ code, config: config2 }) {
+    if (!config2.deprecatedTokens.size) return [];
+    const out = [];
+    for (const m of matches(/var\(\s*(--[\w-]+)/g, code)) {
+      const d = config2.deprecatedTokens.get(m[1]);
+      if (!d) continue;
+      const repl = d.replacement ? `var(--${d.replacement.replace(/\./g, "-")})` : void 0;
+      out.push({
+        offset: m.index,
+        message: `${m[1]} (${d.path}) is deprecated${whenGone(d)}`,
+        suggestion: repl ? `Use ${repl}${d.reason ? `. ${d.reason}` : ""}` : d.reason || "Ask the design system team what replaces it"
+      });
     }
+    return out;
   }
-  return { raws: [...merged.values()], studio };
-}
-function hasDollarValue(node2, depth = 0) {
-  if (!node2 || typeof node2 !== "object" || depth > 12) return false;
-  if ("$value" in node2) return true;
-  return Object.values(node2).some((v) => hasDollarValue(v, depth + 1));
-}
-function hasStudioValue(node2, depth = 0) {
-  if (!node2 || typeof node2 !== "object" || depth > 12) return false;
-  const o = node2;
-  if ("value" in o && "type" in o) return true;
-  return Object.values(o).some((v) => hasStudioValue(v, depth + 1));
-}
-function hasLeafAtTop(node2) {
-  return !!node2 && typeof node2 === "object" && ("value" in node2 || "$value" in node2);
-}
-function buildDtcg(tokens) {
-  const tree = {};
-  for (const t of tokens) {
-    const parts = t.path.split(".");
-    let node2 = tree;
-    parts.forEach((p, i2) => {
-      if (i2 === parts.length - 1) {
-        node2[p] = {
-          $type: t.type,
-          $value: t.value,
-          ...t.description ? { $description: t.description } : {},
-          ...t.dark && t.dark !== t.value ? { $extensions: { [EXT]: { modes: { dark: t.dark } } } } : {}
-        };
-      } else {
-        const next = node2[p];
-        if (next && typeof next === "object" && "$value" in next) node2[p] = { default: next };
-        node2 = node2[p] ??= {};
+};
+var deprecatedComponent = {
+  id: "deprecated-component",
+  title: "Deprecated component",
+  description: "Components the design system is retiring. They still work until their removal date; switch to the replacement.",
+  defaultSeverity: "warning",
+  kinds: MARKUP,
+  check({ code, kind, config: config2, framework }) {
+    const dep = config2.components.filter((c) => c.status === "deprecated");
+    if (!dep.length) return [];
+    const out = [];
+    const report = (offset, c) => {
+      const d = c.deprecation ?? {};
+      out.push({
+        offset,
+        message: `${c.name} is deprecated${whenGone(d)}`,
+        suggestion: d.replacement ? `Use ${d.replacement}${d.reason ? `. ${d.reason}` : ""}` : d.reason || "Ask the design system team what replaces it"
+      });
+    };
+    if (framework === "react" && kind === "jsx") {
+      for (const m of matches(/\bimport\s+(?:type\s+)?\{([^}]*)\}\s*from\s*(['"])([^'"]+)\2/g, code)) {
+        for (const part of m[1].split(",")) {
+          const [orig, alias] = part.trim().replace(/^type\s+/, "").split(/\s+as\s+/).map((s) => s.trim());
+          const c = dep.find((x2) => x2.name === orig && x2.importPath === m[3]);
+          if (!c) continue;
+          const local = (alias || orig).replace(/[$]/g, "\\$");
+          let used = false;
+          for (const u of matches(new RegExp(`<${local}(?=[\\s/>])`, "g"), code)) {
+            used = true;
+            report(u.index, c);
+          }
+          if (!used) report(m.index, c);
+        }
       }
-    });
-  }
-  return tree;
-}
-var isAlias = (v) => !!v && typeof v === "object" && v.type === "VARIABLE_ALIAS";
-var DARK = /dark|night/i;
-var LIGHT = /light|default|day|base/i;
-function finish(format, all, notes, opts) {
-  const PALETTE2 = /^(color\.[a-z-]+)\.\d{1,3}$/;
-  const usedFamilies = new Set(all.filter((t) => t.referenced).map((t) => t.path.match(PALETTE2)?.[1]).filter(Boolean));
-  if (usedFamilies.size) {
-    const steps = /* @__PURE__ */ new Map();
-    for (const t of all) {
-      const f = t.path.match(PALETTE2)?.[1];
-      if (f) steps.set(f, (steps.get(f) ?? 0) + 1);
+      return out;
     }
-    for (const t of all) {
-      const f = t.path.match(PALETTE2)?.[1];
-      if (f && (usedFamilies.has(f) || (steps.get(f) ?? 0) >= 3)) t.referenced = true;
+    for (const c of dep) {
+      const u = resolveUsage(c, framework);
+      if (!u) continue;
+      const tag = u.tag.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+      for (const m of matches(new RegExp(`<${tag}(?=[\\s/>])`, "g"), code)) report(m.index, c);
     }
+    return out;
   }
-  const hasSemantic = all.some((t) => !t.referenced) && all.some((t) => t.referenced);
-  const keep = opts.includePrimitives || !hasSemantic ? all : all.filter((t) => !t.referenced);
-  const primitives = hasSemantic ? all.filter((t) => t.referenced).length : 0;
-  const seen = /* @__PURE__ */ new Set();
-  const tokens = [];
-  for (const { referenced: _r, ...t } of keep) {
-    if (seen.has(t.path)) continue;
-    seen.add(t.path);
-    tokens.push(t);
+};
+var RULES = [
+  noHardcodedColor,
+  noRawPaletteClass,
+  preferOfficialComponent,
+  forbiddenImport,
+  spacingScale,
+  fontFamily,
+  radiusScale,
+  imgAlt,
+  componentProps,
+  legacyLibrary,
+  deprecatedToken,
+  deprecatedComponent
+];
+var RULE_IDS = RULES.map((r) => r.id);
+
+// ../engine/src/source.ts
+var TEMPLATE_EXTENSIONS = ["mustache", "hbs", "handlebars", "php", "phtml", "twig", "njk", "liquid"];
+function fileKind(path) {
+  const ext = path.toLowerCase().split(".").pop() ?? "";
+  if (TEMPLATE_EXTENSIONS.includes(ext)) return "template";
+  if (["tsx", "jsx", "ts", "js", "mjs", "cjs", "mdx"].includes(ext)) return "jsx";
+  if (ext === "vue") return "vue";
+  if (ext === "svelte") return "svelte";
+  if (["html", "htm", "astro"].includes(ext)) return "html";
+  if (["css", "scss", "sass", "less", "pcss"].includes(ext)) return "css";
+  return "other";
+}
+var SCANNABLE = /* @__PURE__ */ new Set(["jsx", "vue", "svelte", "html", "template", "css"]);
+var ANGULAR_COMPONENT = /@Component\s*\(\s*\{/;
+var ANGULAR_TEMPLATE = /\s(?:\[[\w.()-]+\]|\([\w.]+\)|\*ng[A-Z]\w*)\s*=|@(?:if|for|switch)\s*\(/;
+function fileFramework(path, kind, code, project) {
+  const p = path.toLowerCase();
+  switch (kind) {
+    case "vue":
+      return "vue";
+    case "svelte":
+      return "web-components";
+    case "template":
+      return "html";
+    case "css":
+      return project ?? "react";
+    case "html":
+      if (p.endsWith(".component.html") || project === "angular" || ANGULAR_TEMPLATE.test(code)) return "angular";
+      return project === "vue" || project === "web-components" ? project : "html";
+    case "jsx":
+      if (ANGULAR_COMPONENT.test(code)) return "angular";
+      if (/\.(tsx|jsx|mdx)$/.test(p)) return "react";
+      return project ?? "react";
+    default:
+      return project ?? "react";
   }
-  tokens.sort((a, b) => a.path.localeCompare(b.path, "en", { numeric: true }));
-  return { format, tokens: buildDtcg(tokens), count: tokens.length, primitives, notes };
 }
-function fromFigmaVariables(meta3, opts = {}) {
-  const vars = meta3.variables ?? {};
-  const cols = meta3.variableCollections ?? {};
-  const notes = [];
-  const referenced = /* @__PURE__ */ new Set();
-  const modeFor = (col, want, likeName) => {
-    if (likeName) {
-      const same = col.modes.find((m) => m.name.toLowerCase() === likeName.toLowerCase());
-      if (same) return same.modeId;
-    }
-    if (want === "dark") return col.modes.find((m) => DARK.test(m.name))?.modeId;
-    return col.defaultModeId ?? col.modes[0]?.modeId;
-  };
-  const resolve4 = (v, want, modeName, depth = 0) => {
-    const col = cols[v.variableCollectionId];
-    if (!col) return void 0;
-    const modeId = modeFor(col, want, modeName) ?? col.defaultModeId;
-    const raw = v.valuesByMode[modeId] ?? Object.values(v.valuesByMode)[0];
-    if (!isAlias(raw)) return raw;
-    referenced.add(raw.id);
-    const target = vars[raw.id];
-    if (!target || depth > 10) return void 0;
-    const name = col.modes.find((m) => m.modeId === modeId)?.name;
-    return resolve4(target, want, name, depth + 1);
-  };
-  for (const v of Object.values(vars)) for (const val of Object.values(v.valuesByMode)) if (isAlias(val)) referenced.add(val.id);
-  for (const col of Object.values(cols)) {
-    if (col.remote) continue;
-    const dark = col.modes.find((m) => DARK.test(m.name));
-    const others = col.modes.filter((m) => m.modeId !== col.defaultModeId && m !== dark);
-    if (others.length) {
-      const def = col.modes.find((m) => m.modeId === col.defaultModeId)?.name;
-      notes.push(`\u201C${col.name}\u201D has modes ${col.modes.map((m) => m.name).join(", ")}; used \u201C${def}\u201D${dark ? ` (and \u201C${dark.name}\u201D as dark)` : ""}.`);
+var blank = (s) => s.replace(/[^\n]/g, " ");
+function stripComments(code, kind) {
+  let out = code;
+  if (kind === "html" || kind === "vue" || kind === "svelte" || kind === "template") {
+    out = out.replace(/<!--[\s\S]*?-->/g, blank);
+  }
+  if (kind === "template") {
+    out = out.replace(/\{\{!--[\s\S]*?--\}\}|\{\{![\s\S]*?\}\}|\{\{--[\s\S]*?--\}\}|\{#[\s\S]*?#\}|\{%-?\s*comment\s*-?%\}[\s\S]*?\{%-?\s*endcomment\s*-?%\}/g, blank).replace(/<\?(?:php|=)?[\s\S]*?(?:\?>|$)/g, (block) => block.replace(/\/\*[\s\S]*?\*\/|(?<![:"'])\/\/[^\n]*?(?=\?>|\n|$)|(?<=\s)#[^\n]*?(?=\?>|\n|$)/g, blank));
+    return out;
+  }
+  if (kind === "css") {
+    return out.replace(/\/\*[\s\S]*?\*\//g, blank).replace(/(^|[^:])\/\/[^\n]*/g, (m, p1) => p1 + blank(m.slice(p1.length)));
+  }
+  const chars = out.split("");
+  let i2 = 0;
+  let quote = null;
+  while (i2 < chars.length) {
+    const c = chars[i2];
+    const n = chars[i2 + 1];
+    if (quote) {
+      if (c === "\\") i2 += 2;
+      else {
+        if (c === quote) quote = null;
+        i2++;
+      }
+      continue;
     }
-  }
-  const out = [];
-  let hidden = 0;
-  for (const v of Object.values(vars)) {
-    const col = cols[v.variableCollectionId];
-    if (!col || v.remote || col.remote) continue;
-    if (v.hiddenFromPublishing) {
-      hidden++;
+    if (c === '"' || c === "'" || c === "`") {
+      quote = c;
+      i2++;
       continue;
     }
-    const kind = v.resolvedType === "COLOR" ? "color" : v.resolvedType === "FLOAT" ? "number" : v.resolvedType === "STRING" ? "string" : "boolean";
-    const value = resolve4(v, "default");
-    if (value === void 0) continue;
-    const c = classify(v.name, kind, value, { scopes: v.scopes?.filter((s) => s !== "ALL_SCOPES"), context: col.name });
-    if (!c) continue;
-    let darkValue;
-    if (c.type === "color") {
-      const hasDarkSomewhere = Object.values(cols).some((x2) => x2.modes.some((m) => DARK.test(m.name)));
-      if (hasDarkSomewhere) {
-        const d = colorValue(resolve4(v, "dark"));
-        if (d && d !== c.value) darkValue = d;
-      }
+    if (c === "/" && n === "*") {
+      const end = out.indexOf("*/", i2 + 2);
+      const stop = end === -1 ? chars.length : end + 2;
+      for (let j = i2; j < stop; j++) if (chars[j] !== "\n") chars[j] = " ";
+      i2 = stop;
+      continue;
     }
-    out.push({ ...c, ...darkValue ? { dark: darkValue } : {}, ...v.description ? { description: v.description } : {}, referenced: referenced.has(v.id) });
-  }
-  if (hidden) notes.push(`${hidden} variable${hidden === 1 ? "" : "s"} hidden from publishing were skipped.`);
-  return finish("figma-variables", out, notes, opts);
-}
-function fromFigmaStyles(styles, opts = {}) {
-  const out = [];
-  const families = /* @__PURE__ */ new Map();
-  let skipped = 0;
-  for (const s of styles) {
-    if (s.styleType === "FILL") {
-      const fill = s.node?.fills?.find((f) => f.type === "SOLID" && f.visible !== false && f.color);
-      if (!fill?.color) {
-        skipped++;
-        continue;
-      }
-      const c = classify(s.name, "color", { ...fill.color, a: (fill.color.a ?? 1) * (fill.opacity ?? 1) });
-      if (c) out.push({ ...c, ...s.description ? { description: s.description } : {} });
-    } else if (s.styleType === "TEXT" && s.node?.style) {
-      const st = s.node.style;
-      const name = segs(s.name).join("-");
-      if (st.fontSize) out.push({ path: `font.size.${name}`, type: "dimension", value: dim(st.fontSize) });
-      if (st.lineHeightPx) out.push({ path: `font.line-height.${name}`, type: "dimension", value: dim(Math.round(st.lineHeightPx)) });
-      if (st.fontWeight) out.push({ path: `font.weight.${name}`, type: "fontWeight", value: String(st.fontWeight) });
-      if (st.fontFamily) families.set(st.fontFamily, (families.get(st.fontFamily) ?? 0) + 1);
+    if (c === "/" && n === "/" && chars[i2 - 1] !== ":" && kind === "jsx") {
+      while (i2 < chars.length && chars[i2] !== "\n") chars[i2++] = " ";
+      continue;
     }
+    i2++;
   }
-  const fams = [...families.entries()].sort((a, b) => b[1] - a[1]);
-  fams.forEach(([f], i2) => out.push({ path: `font.family.${i2 === 0 ? "sans" : /mono|code/i.test(f) ? "mono" : slug(f)}`, type: "fontFamily", value: f }));
-  const notes = skipped ? [`${skipped} fill style${skipped === 1 ? "" : "s"} (gradients or images) were skipped.`] : [];
-  return finish("figma-styles", out, notes, opts);
-}
-function plainLeaves(node2, prefix, out) {
-  if (node2 === null || node2 === void 0) return;
-  if (typeof node2 !== "object" || typeof node2 === "object" && "r" in node2 && "g" in node2) {
-    out.push({ key: prefix, value: node2 });
-    return;
-  }
-  for (const [k, v] of Object.entries(node2)) plainLeaves(v, [...prefix, k], out);
+  return chars.join("");
 }
-function fromModeObject(obj, opts = {}) {
-  const notes = [];
-  const modes = Object.entries(obj).filter(([, v]) => v && typeof v === "object");
-  const leafSets = modes.map(([name, v]) => {
-    const l = [];
-    plainLeaves(v, [], l);
-    return { name, leaves: l, keys: new Set(l.map((x2) => x2.key.join("/"))) };
-  });
-  const groups = [];
-  for (const m of leafSets) {
-    const g = groups.find((grp) => {
-      const a = grp[0].keys;
-      let same = 0;
-      for (const k of m.keys) if (a.has(k)) same++;
-      return same / Math.max(a.size, m.keys.size) >= 0.8;
-    });
-    if (g) g.push(m);
-    else groups.push([m]);
+var LineIndex = class {
+  starts = [0];
+  text;
+  constructor(text2) {
+    this.text = text2;
+    for (let i2 = 0; i2 < text2.length; i2++) if (text2.charCodeAt(i2) === 10) this.starts.push(i2 + 1);
   }
-  const byLeaf = /* @__PURE__ */ new Map();
-  groups.forEach((grp, gi) => {
-    for (const m of grp) for (const l of m.leaves) {
-      const k = l.key[l.key.length - 1];
-      const e = byLeaf.get(k) ?? { group: gi, values: /* @__PURE__ */ new Map() };
-      e.values.set(m.name, l.value);
-      byLeaf.set(k, e);
-    }
-  });
-  const pick2 = (grp, want) => want === "dark" ? grp.find((m) => DARK.test(m.name)) : grp.find((m) => LIGHT.test(m.name) && !DARK.test(m.name)) ?? grp.find((m) => !DARK.test(m.name)) ?? grp[0];
-  const referenced = /* @__PURE__ */ new Set();
-  for (const m of leafSets) for (const l of m.leaves) if (typeof l.value === "string" && byLeaf.has(l.value)) referenced.add(l.value);
-  const deref = (v, want, depth = 0) => {
-    if (typeof v !== "string" || depth > 10) return v;
-    const ref = byLeaf.get(v) ?? byLeaf.get(v.replace(REF, "$1"));
-    if (!ref) return v;
-    referenced.add(v);
-    const grp = groups[ref.group];
-    const mode = pick2(grp, want) ?? pick2(grp, "default");
-    return deref(ref.values.get(mode.name) ?? [...ref.values.values()][0], want, depth + 1);
-  };
-  const out = [];
-  const pending = [];
-  for (const grp of groups) {
-    const def = pick2(grp, "default");
-    const dark = pick2(grp, "dark");
-    if (grp.length > 1) notes.push(`${grp.map((m) => m.name).join(" / ")} look like modes of one collection; used \u201C${def.name}\u201D${dark && dark !== def ? ` (and \u201C${dark.name}\u201D as dark)` : ""}.`);
-    for (const l of def.leaves) {
-      const key = l.key[l.key.length - 1];
-      const container = l.key.length > 1 ? l.key[l.key.length - 2].toLowerCase() : "";
-      const value = deref(l.value, "default");
-      const kind = container === "color" || colorValue(value) && /^#|^rgb|^hsl/i.test(String(value)) ? "color" : container === "string" || typeof value === "string" && !/^-?[\d.]+(px|rem|%)?$/.test(value) ? "string" : "number";
-      const c = classify(key, kind, kind === "number" && typeof value === "string" && /px$/.test(value) ? parseFloat(value) : value, { context: def.name });
-      if (!c) continue;
-      let d;
-      if (c.type === "color") {
-        const darkLeaf = dark && dark !== def ? dark.leaves.find((x2) => x2.key.join("/") === l.key.join("/")) : void 0;
-        const dv = colorValue(deref(darkLeaf ? darkLeaf.value : l.value, "dark"));
-        if (dv && dv !== c.value) d = dv;
-      }
-      pending.push({ key, t: { ...c, ...d ? { dark: d } : {} } });
+  position(offset) {
+    let lo = 0;
+    let hi = this.starts.length - 1;
+    while (lo < hi) {
+      const mid = lo + hi + 1 >> 1;
+      if (this.starts[mid] <= offset) lo = mid;
+      else hi = mid - 1;
     }
+    return { line: lo + 1, column: offset - this.starts[lo] + 1 };
   }
-  for (const p of pending) out.push({ ...p.t, referenced: referenced.has(p.key) });
-  return finish("mode-object", out, notes, opts);
-}
-var figmaExt = (node2, key) => {
-  const ext = node2.$extensions;
-  if (!ext) return void 0;
-  if (`com.figma.${key}` in ext) return ext[`com.figma.${key}`];
-  const nested = ext["com.figma"];
-  return nested?.[key];
-};
-function fileLeaves(node2, prefix, out, inherited) {
-  if (!node2 || typeof node2 !== "object" || Array.isArray(node2)) return;
-  const o = node2;
-  const groupType = o.$type ?? inherited;
-  if ("$value" in o) {
-    const alias = figmaExt(o, "aliasData");
-    const scopes = figmaExt(o, "scopes");
-    out.push({
-      path: prefix,
-      type: o.$type ?? groupType,
-      value: o.$value,
-      description: o.$description,
-      scopes: Array.isArray(scopes) ? scopes : void 0,
-      aliasTarget: alias?.targetVariableName?.replace(/\//g, "."),
-      hidden: figmaExt(o, "hiddenFromPublishing") === true || void 0
-    });
-    return;
+  lineText(line) {
+    const start = this.starts[line - 1] ?? 0;
+    const end = this.starts[line] ?? this.text.length + 1;
+    return this.text.slice(start, end - 1);
   }
-  for (const [k, v] of Object.entries(o)) {
-    if (k.startsWith("$")) continue;
-    fileLeaves(v, prefix ? `${prefix}.${k}` : k, out, groupType);
+  get lineCount() {
+    return this.starts.length;
   }
-}
-var hasFigmaExt = (node2, depth = 0) => {
-  if (!node2 || typeof node2 !== "object" || depth > 12) return false;
-  const ext = node2.$extensions;
-  if (ext && Object.keys(ext).some((k) => k.startsWith("com.figma"))) return true;
-  return Object.values(node2).some((v) => hasFigmaExt(v, depth + 1));
 };
-function modeOf(file2) {
-  const root = file2.data ?? {};
-  const parts = file2.name.replace(/\\/g, "/").split("/").filter(Boolean);
-  const base = (parts.pop() ?? "tokens").replace(/(\.tokens)?\.json$/i, "");
-  const named = figmaExt(root, "modeName");
-  const split = base.match(/^(.+?)[\s._-]+(light|dark|night|day|default|mode[\s_-]*\d+)$/i);
-  return {
-    collection: parts.join("/") || (split ? split[1] : ""),
-    mode: typeof named === "string" ? named : split ? split[2] : base
+function globToRegExp(glob) {
+  let re = "";
+  for (let i2 = 0; i2 < glob.length; i2++) {
+    const c = glob[i2];
+    if (c === "*") {
+      if (glob[i2 + 1] === "*") {
+        const slash = glob[i2 + 2] === "/";
+        re += slash ? "(?:.*/)?" : ".*";
+        i2 += slash ? 2 : 1;
+      } else re += "[^/]*";
+    } else if (c === "?") re += "[^/]";
+    else if (c === "{") {
+      const end = glob.indexOf("}", i2);
+      re += `(?:${glob.slice(i2 + 1, end).split(",").map((s) => s.replace(/[.+^$()|[\]\\]/g, "\\$&")).join("|")})`;
+      i2 = end;
+    } else re += c.replace(/[.+^$()|[\]\\]/g, "\\$&");
+  }
+  return new RegExp(`^${re}$`);
+}
+function makeIgnore(globs) {
+  const res = globs.map(globToRegExp);
+  return (path) => {
+    const p = path.replace(/\\/g, "/").replace(/^\.\//, "");
+    return res.some((r) => r.test(p) || r.test(`/${p}`));
   };
 }
-function importTokenFiles(files, opts = {}) {
-  const parsed = files.filter((f) => f.data && typeof f.data === "object");
-  if (!parsed.length) throw new Error("No JSON token files found.");
-  const figma = parsed.some((f) => hasFigmaExt(f.data));
-  if (parsed.length === 1 && !figma) return importTokens(parsed[0].data, opts);
-  const notes = [];
-  const withMode = parsed.map((f) => ({ ...f, ...modeOf(f) }));
-  const byCollection = /* @__PURE__ */ new Map();
-  for (const f of withMode) byCollection.set(f.collection, [...byCollection.get(f.collection) ?? [], f]);
-  const light = /* @__PURE__ */ new Map();
-  const darkOverrides = /* @__PURE__ */ new Map();
-  for (const [collection, list] of byCollection) {
-    const dark = list.find((f) => DARK.test(f.mode));
-    const def = list.find((f) => LIGHT.test(f.mode) && !DARK.test(f.mode)) ?? list.find((f) => !DARK.test(f.mode)) ?? list[0];
-    if (list.length > 1) {
-      const label = collection ? `\u201C${collection}\u201D` : "The files";
-      notes.push(`${label}: modes ${list.map((f) => f.mode).join(", ")}; used \u201C${def.mode}\u201D${dark && dark !== def ? ` (and \u201C${dark.mode}\u201D as dark)` : ""}.`);
+
+// ../engine/src/check.ts
+var ENGINE_VERSION = "0.9.0";
+var WEIGHT = { error: 4, warning: 1.5, info: 0.25 };
+function computeScore(counts, lines) {
+  const penalty = counts.error * WEIGHT.error + counts.warning * WEIGHT.warning + counts.info * WEIGHT.info;
+  if (penalty === 0) return 100;
+  const perK = penalty / Math.max(1, lines / 1e3);
+  return Math.max(0, Math.min(99, Math.round(100 / (1 + perK / 25))));
+}
+function check(files, configInput, opts = {}) {
+  const t0 = Date.now();
+  const config2 = "replaces" in configInput ? configInput : resolveConfig(configInput);
+  const ignored = makeIgnore(config2.ignore);
+  const violations = [];
+  let filesScanned = 0;
+  let linesScanned = 0;
+  for (const file2 of files) {
+    const path = file2.path.replace(/\\/g, "/").replace(/^\.\//, "");
+    const kind = fileKind(path);
+    if (!SCANNABLE.has(kind) || ignored(path)) continue;
+    const only = opts.onlyLines?.get(path);
+    if (opts.onlyLines && (!only || only.size === 0)) continue;
+    filesScanned++;
+    const idx = new LineIndex(file2.content);
+    linesScanned += only ? only.size : file2.content.split("\n").filter((l) => l.trim()).length;
+    const code = stripComments(file2.content, kind);
+    const framework = fileFramework(path, kind, code, config2.framework);
+    const seen = /* @__PURE__ */ new Set();
+    for (const rule of RULES) {
+      const setting = config2.rules[rule.id];
+      if (setting === "off" || !rule.kinds.includes(kind)) continue;
+      for (const f of rule.check({ path, kind, code, config: config2, framework })) {
+        const { line, column } = idx.position(f.offset);
+        if (only && !only.has(line)) continue;
+        const key = `${rule.id}:${line}:${column}`;
+        if (seen.has(key)) continue;
+        seen.add(key);
+        violations.push({
+          ruleId: rule.id,
+          severity: setting ?? f.severity ?? rule.defaultSeverity,
+          file: path,
+          line,
+          column,
+          message: f.message,
+          suggestion: f.suggestion,
+          snippet: opts.snippets === false ? void 0 : idx.lineText(line).trim().slice(0, 160)
+        });
+      }
     }
-    const read2 = (f, into) => {
-      const leaves3 = [];
-      fileLeaves(f.data, "", leaves3);
-      for (const l of leaves3) into.set(l.path, { path: l.path, type: l.type, value: l.value, description: l.description, leaf: l });
-    };
-    read2(def, light);
-    if (dark && dark !== def) read2(dark, darkOverrides);
   }
-  const lightRaws = resolveRefs([...light.values()]);
-  const darkRaws = resolveRefs([...light.values()].map((r) => darkOverrides.get(r.path) ?? r));
-  const darkByPath = new Map(darkRaws.map((r) => [r.path, r.value]));
-  const referenced = /* @__PURE__ */ new Set();
-  for (const r of [...light.values(), ...darkOverrides.values()]) {
-    if (r.leaf.aliasTarget) referenced.add(r.leaf.aliasTarget);
-    const m = typeof r.value === "string" ? r.value.trim().match(REF) : null;
-    if (m) referenced.add(m[1]);
+  violations.sort((a, b) => a.file.localeCompare(b.file) || a.line - b.line || a.column - b.column);
+  const counts = { error: 0, warning: 0, info: 0 };
+  const perRule = /* @__PURE__ */ new Map();
+  for (const v of violations) {
+    counts[v.severity]++;
+    perRule.set(v.ruleId, (perRule.get(v.ruleId) ?? 0) + 1);
   }
-  const out = [];
-  let hidden = 0;
-  for (const r of lightRaws) {
-    const leaf = light.get(r.path).leaf;
-    if (leaf.hidden) {
-      hidden++;
-      continue;
-    }
-    const t = (r.type ?? "").toLowerCase();
-    const kind = t === "color" ? "color" : t === "boolean" ? "boolean" : t === "string" || t === "fontfamily" || t === "fontweight" ? "string" : typeof r.value === "string" && !/^-?[\d.]+(px|rem)?$/.test(r.value) && !colorValue(r.value) ? "string" : colorValue(r.value) && t !== "number" && t !== "dimension" ? "color" : "number";
-    let tok;
-    if (figma) {
-      const value = kind === "number" && r.value && typeof r.value === "object" ? parseFloat(dim(r.value)) : r.value;
-      tok = classify(r.path.replace(/\./g, "/"), kind, value, { scopes: leaf.scopes?.filter((x2) => x2 !== "ALL_SCOPES") });
-    } else {
-      const flat = flattenTokens({ x: { $type: r.type, $value: r.value } })[0];
-      tok = flat ? { path: flat.type === "color" && !r.path.startsWith("color.") ? `color.${r.path}` : r.path, type: flat.type, value: flat.value } : null;
-    }
-    if (!tok) continue;
-    let darkValue;
-    if (tok.type === "color" && darkOverrides.size) {
-      const d = colorValue(darkByPath.get(r.path));
-      if (d && d !== tok.value) darkValue = d;
+  return {
+    engineVersion: ENGINE_VERSION,
+    tokenVersion: config2.tokenVersion,
+    score: computeScore(counts, linesScanned),
+    counts,
+    filesScanned,
+    linesScanned,
+    violations,
+    byRule: [...perRule].map(([ruleId, count]) => ({ ruleId, count })).sort((a, b) => b.count - a.count),
+    durationMs: Date.now() - t0
+  };
+}
+
+// ../engine/src/report.ts
+var RENDERED_ONLY = { "text-contrast": "Low text contrast", "font-size-scale": "Off-scale font size", "page-rendered": "Blank page" };
+var title = (id) => RULES.find((r) => r.id === id)?.title ?? RENDERED_ONLY[id] ?? id;
+var ansi = (on) => {
+  const w = (code) => (s) => on ? `\x1B[${code}m${s}\x1B[0m` : s;
+  return { red: w("31"), yellow: w("33"), cyan: w("36"), green: w("32"), dim: w("2"), bold: w("1") };
+};
+var rendered = (r) => r.violations.length > 0 && r.violations.every((v) => v.line === 0);
+function formatPretty(report, { color = true, max: max2 = 200 } = {}) {
+  const c = ansi(color);
+  const sev = { error: c.red, warning: c.yellow, info: c.cyan };
+  const lines = [];
+  let lastFile = "";
+  for (const v of report.violations.slice(0, max2)) {
+    if (v.file !== lastFile) {
+      lines.push("", c.bold(v.file));
+      lastFile = v.file;
     }
-    out.push({ ...tok, ...darkValue ? { dark: darkValue } : {}, ...r.description ? { description: r.description } : {}, referenced: referenced.has(r.path) });
+    const rendered2 = v.line === 0;
+    lines.push(`  ${c.dim(rendered2 ? "".padEnd(8) : `${v.line}:${v.column}`.padEnd(8))} ${sev[v.severity](v.severity.padEnd(7))} ${v.message}  ${c.dim(v.ruleId)}`);
+    if (v.suggestion) lines.push(`  ${" ".repeat(16)} ${c.green("\u2192")} ${v.suggestion}`);
+    if (rendered2 && v.snippet) lines.push(`  ${" ".repeat(16)} ${c.dim(`on ${v.snippet}`)}`);
   }
-  if (hidden) notes.push(`${hidden} variable${hidden === 1 ? "" : "s"} hidden from publishing were skipped.`);
-  return finish(figma ? "figma-export" : "dtcg", out, notes, opts);
+  if (report.violations.length > max2) lines.push("", c.dim(`\u2026 and ${report.violations.length - max2} more`));
+  const s = report.score;
+  const scoreStr = s >= 80 ? c.green(String(s)) : s >= 65 ? c.yellow(String(s)) : c.red(String(s));
+  lines.push(
+    "",
+    `${c.bold("Brand score")} ${scoreStr}/100  ${c.dim("\xB7")} ${c.red(`${report.counts.error} errors`)} ${c.dim("\xB7")} ${c.yellow(`${report.counts.warning} warnings`)} ${c.dim("\xB7")} ${c.cyan(`${report.counts.info} info`)}`,
+    c.dim(`${report.filesScanned} ${rendered(report) ? "pages" : "files"}, ${report.linesScanned} ${rendered(report) ? "elements" : "lines"} in ${report.durationMs}ms${report.tokenVersion ? ` \xB7 Brand Kit v${report.tokenVersion}` : ""}`)
+  );
+  return lines.join("\n");
 }
-function importTokens(input2, opts = {}) {
-  if (!input2 || typeof input2 !== "object") throw new Error("Expected a JSON object.");
-  const o = input2;
-  if (Array.isArray(o.$files)) return importTokenFiles(o.$files, opts);
-  const meta3 = o.meta ?? o;
-  if (meta3.variables && meta3.variableCollections) return fromFigmaVariables(meta3, opts);
-  if (Array.isArray(o.styles) && o.styles.every((s) => s && "styleType" in s)) return fromFigmaStyles(o.styles, opts);
-  if (hasDollarValue(o) && hasFigmaExt(o)) return importTokenFiles([{ name: "tokens.json", data: o }], opts);
-  if (hasDollarValue(o) || hasStudioValue(o)) {
-    const studio = !hasDollarValue(o);
-    const flat = flattenTokens(o);
-    if (!flat.length) throw new Error("No tokens found in that file.");
-    const out = flat.map((t) => {
-      if (t.type === "color" && !t.path.startsWith("color.")) return { ...t, path: `color.${t.path}` };
-      return t;
-    });
-    const notes = studio ? [] : [];
-    const res = finish(studio ? "tokens-studio" : "dtcg", out, notes, opts);
-    return res;
-  }
-  const leaves3 = [];
-  plainLeaves(o, [], leaves3);
-  if (leaves3.length) return fromModeObject(o, opts);
-  throw new Error("Couldn't find any tokens. Supported: DTCG, Tokens Studio, Figma variables JSON.");
+var esc = (s) => s.replace(/%/g, "%25").replace(/\r/g, "%0D").replace(/\n/g, "%0A");
+var escProp = (s) => esc(s).replace(/:/g, "%3A").replace(/,/g, "%2C");
+function formatGithubAnnotations(report, max2 = 50) {
+  const level = { error: "error", warning: "warning", info: "notice" };
+  return report.violations.slice(0, max2).map(
+    (v) => `::${level[v.severity]} file=${escProp(v.file)},line=${v.line},col=${v.column},title=${escProp(`Brandrail: ${title(v.ruleId)}`)}::${esc(
+      v.suggestion ? `${v.message}. ${v.suggestion}` : v.message
+    )}`
+  ).join("\n");
 }
-function diffTokens(before, after) {
-  const a = new Map(flattenTokens(before).map((t) => [t.path, t]));
-  const b = new Map(flattenTokens(after).map((t) => [t.path, t]));
-  const diff = { added: [], removed: [], changed: [], unchanged: 0 };
-  for (const [p, t] of b) {
-    const old = a.get(p);
-    if (!old) diff.added.push(t);
-    else if (old.value.toLowerCase() !== t.value.toLowerCase() || (old.dark ?? "").toLowerCase() !== (t.dark ?? "").toLowerCase()) diff.changed.push({ path: p, before: old, after: t });
-    else diff.unchanged++;
+var COMMENT_MARKER = "<!-- brandrail-report -->";
+function formatMarkdown(report, opts = {}) {
+  const { threshold, maxRows = 30 } = opts;
+  const pass = threshold === void 0 || report.score >= threshold;
+  const badge = report.violations.length === 0 ? "\u{1F7E2}" : pass ? "\u{1F7E1}" : "\u{1F534}";
+  const out = [COMMENT_MARKER];
+  out.push(`## ${badge} Brand score: **${report.score}**/100${threshold !== void 0 ? ` (threshold ${threshold})` : ""}`);
+  out.push("");
+  out.push(
+    `**${report.counts.error}** errors \xB7 **${report.counts.warning}** warnings \xB7 **${report.counts.info}** info \u2014 ${report.filesScanned} files scanned${report.tokenVersion ? ` against Brand Kit v${report.tokenVersion}` : ""}`
+  );
+  if (report.violations.length === 0) {
+    out.push("", "Everything uses approved tokens and components. \u2728");
+  } else {
+    if (report.byRule.length) {
+      out.push("", "| Rule | Count |", "| --- | ---: |");
+      for (const r of report.byRule) out.push(`| ${title(r.ruleId)} \`${r.ruleId}\` | ${r.count} |`);
+    }
+    out.push("", "<details><summary>Violations</summary>", "", "| | Location | Issue | Fix |", "| --- | --- | --- | --- |");
+    const icon = { error: "\u{1F534}", warning: "\u{1F7E1}", info: "\u{1F535}" };
+    for (const v of report.violations.slice(0, maxRows)) {
+      const loc = v.line === 0 ? `${v.file} ${v.snippet ?? ""}`.trim() : `${v.file}:${v.line}`;
+      const url2 = opts.fileUrl?.(v);
+      const cell = (s) => s.replace(/\|/g, "\\|").replace(/\n/g, " ");
+      out.push(`| ${icon[v.severity]} | ${url2 ? `[\`${loc}\`](${url2})` : `\`${loc}\``} | ${cell(v.message)} | ${cell(v.suggestion ?? "")} |`);
+    }
+    if (report.violations.length > maxRows) out.push("", `\u2026and ${report.violations.length - maxRows} more.`);
+    out.push("", "</details>");
   }
-  for (const [p, t] of a) if (!b.has(p)) diff.removed.push(t);
-  return diff;
-}
-function mergeTokens(base, incoming) {
-  const m = new Map(flattenTokens(base).map((t) => [t.path, t]));
-  for (const t of flattenTokens(incoming)) m.set(t.path, { ...m.get(t.path), ...t, description: t.description ?? m.get(t.path)?.description });
-  return buildDtcg([...m.values()]);
+  out.push("", `<sub>Brandrail engine ${report.engineVersion}${opts.dashboardUrl ? ` \xB7 [Open in Brandrail](${opts.dashboardUrl})` : ""}</sub>`);
+  return out.join("\n");
 }
 
+// ../engine/src/defaults.ts
+var starterConfig = {
+  $schema: "https://brandrail.dev/schema/config.json",
+  tokenVersion: "0.0.0-local",
+  tokens: {
+    color: {
+      action: { primary: { $type: "color", $value: "#1f883d", $description: "One primary action per view" } },
+      accent: { default: { $type: "color", $value: "#0969da", $description: "Links, focus, selection" } },
+      fg: {
+        default: { $type: "color", $value: "#1f2328", $description: "Body text" },
+        muted: { $type: "color", $value: "#59636e", $description: "Secondary text" }
+      },
+      canvas: {
+        default: { $type: "color", $value: "#ffffff", $description: "Page background" },
+        subtle: { $type: "color", $value: "#f6f8fa", $description: "Headers, wells" }
+      },
+      border: { default: { $type: "color", $value: "#d1d9e0", $description: "Borders and dividers" } },
+      danger: { default: { $type: "color", $value: "#cf222e", $description: "Destructive actions, errors" } },
+      success: { default: { $type: "color", $value: "#1a7f37", $description: "Success messages, completed states" } },
+      attention: { default: { $type: "color", $value: "#9a6700", $description: "Warnings, needs attention" } }
+    },
+    font: {
+      family: { sans: { $type: "fontFamily", $value: "-apple-system, BlinkMacSystemFont, 'Segoe UI', 'Noto Sans', Helvetica, Arial, sans-serif" } },
+      size: { base: { $type: "dimension", $value: "14px" } }
+    },
+    radius: { md: { $type: "dimension", $value: "6px" } },
+    space: { unit: { $type: "dimension", $value: "8px" } }
+  },
+  components: [
+    { name: "Button", importPath: "@acme/ui" },
+    { name: "TextInput", importPath: "@acme/ui" },
+    { name: "Select", importPath: "@acme/ui" },
+    { name: "Textarea", importPath: "@acme/ui" }
+  ],
+  rules: {},
+  ignore: []
+};
+
 // ../engine/src/instructions.ts
 var KIT_PACKAGE = "@brandrail/kit";
 var RULES_START = "<!-- brandrail:start -->";
@@ -9996,8 +10097,9 @@ function generateInstructions(config2, opts = {}) {
     }
     lines.push("");
   }
-  if (r.components.length) {
-    const usable = r.components.map((c) => ({ c, u: resolveUsage(c, fw) }));
+  const active = r.components.filter((c) => c.status !== "deprecated");
+  if (active.length) {
+    const usable = active.map((c) => ({ c, u: resolveUsage(c, fw) }));
     const here = usable.filter((x2) => x2.u);
     const missing2 = usable.filter((x2) => !x2.u).map((x2) => x2.c.name);
     lines.push("## Components");
@@ -10031,7 +10133,7 @@ function generateInstructions(config2, opts = {}) {
     lines.push("## Colours");
     lines.push("Use CSS variables only. Never write hex, rgb() or hsl() values, and never use Tailwind palette classes like `bg-blue-500`.");
     for (const c of r.colors) {
-      if (c.mode) continue;
+      if (c.mode || r.deprecatedTokens.has(c.cssVar)) continue;
       const dark = r.colors.find((d) => d.mode === "dark" && d.path === c.path);
       lines.push(`- \`var(${c.cssVar})\` \u2014 ${c.path} (${c.hex}${dark ? `, dark ${dark.hex}` : ""})`);
     }
@@ -10047,6 +10149,14 @@ function generateInstructions(config2, opts = {}) {
   if (sizeVars.length) lines.push(`- Font sizes come from the type scale: ${sizeVars.join(", ")}. Matching line heights are \`--font-line-height-*\`.`);
   if (r.fonts.length) lines.push(`- Fonts: use ${r.fontVars.map((v) => `\`var(${v})\``).join(" or ")}; never set another font-family.`);
   lines.push("");
+  const depComps = r.components.filter((c) => c.status === "deprecated");
+  if (r.deprecatedTokens.size || depComps.length) {
+    lines.push("## Deprecated: don't use in new code");
+    lines.push("These still work until their removal date. Use the replacement, and switch existing uses when you touch that code (the Checker warns on each).");
+    for (const d of r.deprecatedTokens.values()) lines.push(`- ${deprecationLine(d, true)}`);
+    for (const c of depComps) lines.push(`- ${deprecationLine({ path: c.name, ...c.deprecation }, false)}`);
+    lines.push("");
+  }
   lines.push("## New pages");
   lines.push("- Building a new page or screen? Start from a page template: MCP `get_template` (list, detail, form, settings, dashboard, sign-in) or `npx brandrail template <name>`. It's built from these components and the spacing scale, and lists the page's rules (states, layout, accessibility). Rename its sample data; keep its structure.");
   lines.push("");
@@ -10803,7 +10913,8 @@ function mergeProjectConfig(prev, kit) {
     rules: { ...prev.rules, ...kit.rules },
     ignore: prev.ignore ?? kit.ignore,
     tokensCss: prev.tokensCss,
-    framework: prev.framework ?? kit.framework
+    framework: prev.framework ?? kit.framework,
+    brandKitVersion: prev.brandKitVersion
   };
 }
 function tokensCssContent(config2, org) {
@@ -11740,8 +11851,8 @@ async function call(path, init) {
   }
   return body;
 }
-function fetchBrandKit(key) {
-  return call("/api/v1/brand-kit", { method: "GET", key });
+function fetchBrandKit(key, version2) {
+  return call(`/api/v1/brand-kit${version2 ? `?version=${encodeURIComponent(version2)}` : ""}`, { method: "GET", key });
 }
 function uploadReport(key, payload) {
   const report = payload.uploadSnippets ? payload.report : { ...payload.report, violations: payload.report.violations.map(({ snippet: _snippet, ...v }) => v) };
@@ -12015,7 +12126,7 @@ __export(external_exports, {
   decode: () => decode2,
   decodeAsync: () => decodeAsync2,
   deepPartial: () => deepPartial,
-  describe: () => describe2,
+  describe: () => describe3,
   discriminatedUnion: () => discriminatedUnion,
   e164: () => e1642,
   email: () => email2,
@@ -12421,7 +12532,7 @@ __export(core_exports2, {
   createToJSONSchemaMethod: () => createToJSONSchemaMethod,
   decode: () => decode,
   decodeAsync: () => decodeAsync,
-  describe: () => describe,
+  describe: () => describe2,
   encode: () => encode,
   encodeAsync: () => encodeAsync,
   extractDefs: () => extractDefs,
@@ -27411,7 +27522,7 @@ function _check(fn, params) {
   return ch;
 }
 // @__NO_SIDE_EFFECTS__
-function describe(description) {
+function describe2(description) {
   const ch = new $ZodCheck({ check: "describe" });
   ch._zod.onattach = [
     (inst) => {
@@ -28965,7 +29076,7 @@ __export(schemas_exports2, {
   currencyCode: () => currencyCode2,
   custom: () => custom,
   date: () => date2,
-  describe: () => describe2,
+  describe: () => describe3,
   discriminatedUnion: () => discriminatedUnion,
   e164: () => e1642,
   email: () => email2,
@@ -30557,7 +30668,7 @@ function refine(fn, _params = {}) {
 function superRefine(fn, params) {
   return _superRefine(fn, params);
 }
-var describe2 = describe;
+var describe3 = describe2;
 var meta2 = meta;
 var ZodInstanceOf = /* @__PURE__ */ $constructor("ZodInstanceOf", (inst, def) => {
   ZodCustom.init(inst, def);
@@ -41315,6 +41426,15 @@ function componentDoc(c, fw) {
   const u = resolveUsage(c, fw);
   const others = availableFrameworks(c).filter((f) => f !== fw).map((f) => FRAMEWORK_LABEL[f]);
   const title2 = `### ${c.name}${c.status && c.status !== "stable" ? ` (${c.status})` : ""}`;
+  if (c.status === "deprecated") {
+    const d = c.deprecation ?? {};
+    return [
+      title2,
+      "",
+      `Deprecated${d.removeAfter ? `: removed after ${d.removeAfter}` : ""}. Don't use it in new code${d.replacement ? `; use ${d.replacement} (get_component_docs "${d.replacement}")` : ""}.${d.reason ? ` ${d.reason}` : ""}`,
+      "When you edit code that uses it, switch to the replacement."
+    ].join("\n");
+  }
   if (!u) {
     return [
       title2,
@@ -41382,7 +41502,11 @@ function createBrandrailMcp(ctx) {
       const pick2 = category === "all" ? all : all.filter(CATEGORY[category]);
       const lines = [`# ${ctx.org} design tokens${ctx.config.tokenVersion ? ` (Brand Kit v${ctx.config.tokenVersion})` : ""}`, ""];
       lines.push("| Token | Use | Value | Meaning |", "| --- | --- | --- | --- |");
-      for (const l of pick2) lines.push(`| ${l.path} | \`${cssVar2(l.path)}\` | ${String(l.value)}${l.dark ? ` (dark ${String(l.dark)})` : ""} | ${l.description ?? ""} |`);
+      for (const l of pick2) {
+        const dep = resolved.deprecatedTokens.get(`--${l.path.replace(/\./g, "-")}`);
+        const note = dep ? `**Deprecated**${dep.replacement ? `: use \`${cssVar2(dep.replacement)}\`` : ""}${dep.removeAfter ? ` (removed after ${dep.removeAfter})` : ""}.` : l.description ?? "";
+        lines.push(`| ${l.path} | \`${cssVar2(l.path)}\` | ${String(l.value)}${l.dark ? ` (dark ${String(l.dark)})` : ""} | ${note} |`);
+      }
       if (pick2.some((l) => l.dark)) lines.push("", "Colours with a dark value switch automatically: always use the variable, never the hex, so both themes work.");
       if (category === "all" || category === "spacing") lines.push("", `Allowed spacing (px): ${resolved.spacing.filter((s) => s > 2).join(", ")}`);
       if (category === "all" || category === "radius") lines.push(`Allowed radius (px): ${resolved.radii.filter((r) => r > 0 && r < 999).join(", ")}`);
@@ -41618,10 +41742,10 @@ function cachePath(key) {
   const id = createHash2("sha256").update(`${apiBase()}|${key}`).digest("hex").slice(0, 16);
   return join4(base, "brandrail", `brand-kit-${id}.json`);
 }
-async function loadKit(key) {
-  const p = cachePath(key);
+async function loadKit(key, version2) {
+  const p = cachePath(`${key}${version2 ? `@${version2}` : ""}`);
   try {
-    const kit = await fetchBrandKit(key);
+    const kit = await fetchBrandKit(key, version2);
     mkdirSync2(dirname3(p), { recursive: true, mode: 448 });
     writeFileSync2(p, JSON.stringify({ fetchedAt: (/* @__PURE__ */ new Date()).toISOString(), ...kit }), { mode: 384 });
     return kit;
@@ -41639,7 +41763,7 @@ async function runLocalMcp(cwd, opts) {
   const configPath = findConfig(cwd);
   const local = configPath ? readConfig(configPath) : void 0;
   const key = resolveKey();
-  const kit = key ? await loadKit(key) : null;
+  const kit = key ? await loadKit(key, local?.brandKitVersion) : null;
   let config2;
   let org;
   let published;
@@ -42111,9 +42235,11 @@ async function cmdInit(cwd, flags) {
   if (flags["from-api"]) {
     const key = resolveKey();
     if (!key) throw new Error(`--from-api: ${NO_KEY}`);
-    const res = await fetchBrandKit(key);
-    config2 = { $schema: starterConfig.$schema, ...res.config };
+    const pinned = existsSync7(target) ? readConfig(target).brandKitVersion : void 0;
+    const res = await fetchBrandKit(key, pinned);
+    config2 = { $schema: starterConfig.$schema, ...res.config, ...pinned ? { brandKitVersion: pinned } : {} };
     org = res.org;
+    if (pinned && res.latestVersion && res.latestVersion !== pinned) log2(`Pinned to Brand Kit v${pinned} (v${res.latestVersion} is the latest). Remove "brandKitVersion" from ${CONFIG_FILE2} to follow the latest.`);
   }
   if (existsSync7(target) && !flags.force && !flags["from-api"]) {
     log2(`${CONFIG_FILE2} already exists (use --force to overwrite). Updating rule files from it.`);