@conductor-by-89soone/tokens 0.0.0

package/dist/contrast-cli.js

@@ -0,0 +1,1510 @@
+import { resolve, dirname, join } from 'path';
+import { fileURLToPath } from 'url';
+import { mkdirSync, writeFileSync, rmSync, renameSync, existsSync, readFileSync } from 'fs';
+
+// src/contrast-cli.ts
+
+// src/build/errors.ts
+var EXIT_CODES = {
+  "TOK-CYCLE": 1,
+  "TOK-UNKNOWN-REF": 1,
+  "TOK-DEPTH": 1,
+  "TOK-TIER": 1,
+  "TOK-TIER-MISSING": 1,
+  "TOK-DUPLICATE-KEY": 1,
+  "TOK-ICON": 1,
+  "TOK-GROUP-SIZE": 1,
+  "TOK-USAGE": 1,
+  "TOK-VALUE": 1,
+  "TOK-Z-DUPLICATE": 1,
+  "TOK-PREFIX": 2,
+  "TOK-NAME-COLLISION": 2,
+  "TOK-MEDIA-VAR": 2,
+  "TOK-CP-DUPLICATE-ID": 1,
+  "TOK-CP-UNKNOWN-KEY": 1,
+  "TOK-CP-DECORATIVE": 1,
+  "TOK-CP-USAGE": 1,
+  "TOK-CP-COLOR": 1,
+  "TOK-CP-ALPHA": 1,
+  "TOK-LITERAL": 1,
+  "TOK-ARG": 3
+};
+var TokenBuildError = class extends Error {
+  code;
+  exitCode;
+  /** Indented lines printed under the summary: offending keys, cycle paths, hints. */
+  details;
+  constructor(code, summary, details = []) {
+    super(`error[${code}]: ${summary}`);
+    this.name = "TokenBuildError";
+    this.code = code;
+    this.exitCode = EXIT_CODES[code];
+    this.details = details;
+  }
+  /** The full stderr rendering, summary line first. */
+  format() {
+    return [this.message, ...this.details.map((line) => `  ${line}`)].join("\n");
+  }
+};
+function isUnchanged(path, contents) {
+  return existsSync(path) && readFileSync(path, "utf8") === contents;
+}
+function writeArtifacts(outDir, artifacts) {
+  mkdirSync(outDir, { recursive: true });
+  const staged = [];
+  try {
+    for (const [name, contents] of artifacts) {
+      const final = join(outDir, name);
+      if (isUnchanged(final, contents)) continue;
+      const temporary = `${final}.${process.pid}.tmp`;
+      writeFileSync(temporary, contents, "utf8");
+      staged.push({ temporary, final, name });
+    }
+  } catch (error) {
+    for (const { temporary } of staged) rmSync(temporary, { force: true });
+    throw error;
+  }
+  for (const { temporary, final } of staged) renameSync(temporary, final);
+  return staged.map(({ name }) => name);
+}
+
+// src/contrast/args.ts
+var USAGE = "usage: conductor-check-contrast [--theme <dark|light|all>] [--report] [--out <dir>]";
+function parseContrastArgs(argv) {
+  let theme = "all";
+  let report = false;
+  let outDir = "dist";
+  const requireValue = (flag, next) => {
+    if (next === void 0 || next.startsWith("--")) {
+      throw new TokenBuildError("TOK-ARG", `\`${flag}\` needs a value`, [USAGE]);
+    }
+    return next;
+  };
+  for (let index = 0; index < argv.length; index += 1) {
+    const arg = argv[index];
+    switch (arg) {
+      case "--report":
+        report = true;
+        break;
+      case "--theme":
+        theme = requireValue("--theme", argv[index + 1]);
+        index += 1;
+        break;
+      case "--out":
+        outDir = requireValue("--out", argv[index + 1]);
+        index += 1;
+        break;
+      default:
+        throw new TokenBuildError("TOK-ARG", `unrecognised argument \`${arg}\``, [USAGE]);
+    }
+  }
+  return { theme, report, outDir };
+}
+function selectThemes(available, requested) {
+  if (requested === "all") return available;
+  const match = available.filter((theme) => theme.theme === requested);
+  if (match.length > 0) return match;
+  throw new TokenBuildError("TOK-ARG", `theme \`${requested}\` is not defined`, [
+    `available themes: ${available.map((theme) => theme.theme).join(", ")}`,
+    USAGE
+  ]);
+}
+
+// src/schema.ts
+var MAX_REFERENCE_DEPTH = 10;
+function stripBraces(reference) {
+  const trimmed = reference.trim();
+  return trimmed.startsWith("{") && trimmed.endsWith("}") ? trimmed.slice(1, -1).trim() : trimmed;
+}
+
+// src/build/reference.ts
+function buildTokenIndex(tokens) {
+  const index = /* @__PURE__ */ new Map();
+  const duplicates = [];
+  for (const token of tokens) {
+    if (index.has(token.key)) duplicates.push(token.key);
+    else index.set(token.key, token);
+  }
+  if (duplicates.length > 0) {
+    throw new TokenBuildError(
+      "TOK-DUPLICATE-KEY",
+      `${duplicates.length} token key(s) declared more than once`,
+      [...duplicates, "hint: a token key is unique across primitives, palette and components."]
+    );
+  }
+  return index;
+}
+function resolveReferenceTarget(index, reference) {
+  const key = stripBraces(reference);
+  if (index.has(key)) return key;
+  const defaulted = `${key}.DEFAULT`;
+  return index.has(defaulted) ? defaulted : void 0;
+}
+function formatCycle(path) {
+  return path.join(" \u2192 ");
+}
+function resolveTokens(index) {
+  const values2 = /* @__PURE__ */ new Map();
+  const edges = [];
+  function resolve2(key, chain) {
+    const cached = values2.get(key);
+    if (cached !== void 0) return cached;
+    const cycleStart = chain.indexOf(key);
+    if (cycleStart !== -1) {
+      const path = [...chain.slice(cycleStart), key];
+      throw new TokenBuildError("TOK-CYCLE", "circular token reference detected", [
+        formatCycle(path),
+        "hint: break the cycle; a token cannot resolve through itself."
+      ]);
+    }
+    if (chain.length > MAX_REFERENCE_DEPTH) {
+      throw new TokenBuildError(
+        "TOK-DEPTH",
+        `token reference chain exceeds the maximum depth of ${MAX_REFERENCE_DEPTH}`,
+        [formatCycle([...chain, key]), "hint: flatten the chain or point at a literal."]
+      );
+    }
+    const token = index.get(key);
+    const nextChain = [...chain, key];
+    const depth = chain.length;
+    const resolveEdge = (reference) => {
+      const target = resolveReferenceTarget(index, reference);
+      if (target === void 0) {
+        throw new TokenBuildError("TOK-UNKNOWN-REF", "token reference points at an unknown key", [
+          `from: ${key}`,
+          `to:   ${stripBraces(reference)}`,
+          "hint: check the spelling, or define the missing token."
+        ]);
+      }
+      const resolvedValue = resolve2(target, nextChain);
+      edges.push({ from: key, to: target, depth, resolvedValue });
+      return resolvedValue;
+    };
+    let resolved;
+    if (token.alias !== void 0) {
+      resolved = resolveEdge(token.alias);
+    } else if (typeof token.value === "number") {
+      resolved = String(token.value);
+    } else if (typeof token.value === "string") {
+      resolved = token.value.replace(
+        /\{([^{}]+)\}/g,
+        (_match, reference) => resolveEdge(reference)
+      );
+    } else {
+      throw new TokenBuildError("TOK-VALUE", "token declares neither `value` nor `alias`", [
+        `key: ${key}`,
+        "hint: a primitive needs a literal `value`; a semantic or component token needs one of the two."
+      ]);
+    }
+    values2.set(key, resolved);
+    return resolved;
+  }
+  for (const key of index.keys()) resolve2(key, []);
+  return { values: values2, edges };
+}
+
+// src/contrast-pairs.ts
+var CONTRAST_THRESHOLDS = {
+  body: 4.5,
+  large: 3,
+  nonText: 3
+};
+var BOTH_THEMES = ["dark", "light"];
+function pair(id, foreground, background, usage, note) {
+  return { id, foreground, background, usage, themes: BOTH_THEMES, ...note === void 0 ? {} : { note } };
+}
+var textOnSurface = [
+  pair("CP-001", "text.primary", "surface.base", "body"),
+  pair("CP-002", "text.primary", "surface.raised", "body"),
+  pair("CP-003", "text.primary", "surface.elevated", "body"),
+  pair("CP-004", "text.secondary", "surface.raised", "body"),
+  pair("CP-005", "text.secondary", "surface.elevated", "body"),
+  pair("CP-006", "text.muted", "surface.base", "body"),
+  pair("CP-007", "text.muted", "surface.elevated", "body"),
+  pair("CP-008", "text.monoPayload", "surface.raised", "body")
+];
+var accentPairs = [
+  pair("CP-009", "accent", "surface.base", "body"),
+  pair("CP-010", "accent", "surface.raised", "body"),
+  pair("CP-011", "text.inverse", "accent", "body"),
+  pair("CP-012", "accent.strong", "surface.base", "nonText")
+];
+var correctedTokens = [
+  pair("CP-013", "focusRing", "surface.base", "nonText"),
+  pair("CP-014", "focusRing", "surface.raised", "nonText"),
+  pair("CP-015", "focusRing", "surface.elevated", "nonText"),
+  pair("CP-016", "border.control", "surface.base", "nonText"),
+  pair("CP-017", "border.control", "surface.raised", "nonText"),
+  pair("CP-018", "border.control", "surface.elevated", "nonText")
+];
+var statusPairs = [
+  pair("CP-019", "status.running", "surface.raised", "body"),
+  pair("CP-020", "status.waiting", "surface.raised", "body"),
+  pair("CP-021", "status.success", "surface.raised", "body"),
+  pair("CP-022", "status.partial", "surface.raised", "body"),
+  pair("CP-023", "status.danger", "surface.raised", "body"),
+  pair("CP-024", "status.queued", "surface.raised", "nonText")
+  // CP-025 removed by CR-006. Do not reuse this id.
+];
+var meterPairs = [
+  pair("CP-026", "meter.normal", "surface.raised", "body"),
+  pair("CP-027", "meter.warning", "surface.raised", "body"),
+  pair("CP-028", "meter.exceeded", "surface.raised", "body")
+];
+var severityPairs = [
+  pair("CP-029", "badge.severity.text", "severity.read", "body"),
+  pair("CP-030", "badge.severity.text", "severity.write", "body"),
+  pair("CP-031", "badge.severity.text", "severity.destructive", "body"),
+  pair("CP-032", "badge.severity.text", "severity.blocked", "body")
+];
+var badgePairs = [
+  pair("CP-033", "badge.fill.text", "status.running", "body"),
+  pair("CP-034", "badge.fill.text", "status.waiting", "body"),
+  pair("CP-035", "badge.fill.text", "status.success", "body"),
+  pair("CP-036", "badge.fill.text", "status.partial", "body"),
+  pair("CP-037", "badge.fill.text", "status.danger", "body"),
+  pair("CP-038", "badge.marker.text", "badge.marker.background", "body"),
+  pair(
+    "CP-039",
+    "status.queued",
+    "badge.marker.background",
+    "nonText",
+    "tokens spec 8.2 names the foreground `badge.marker.dot`; that key is a variant slot rather than a token, and it resolves to `status.queued` for the only declared variant."
+  )
+];
+var disabledPairs = [
+  pair("CP-040", "text.muted", "state.disabled", "body"),
+  pair("CP-041", "button.policyDisabled.text", "state.disabledPolicy", "body")
+];
+var contrastPairs = [
+  ...textOnSurface,
+  ...accentPairs,
+  ...correctedTokens,
+  ...statusPairs,
+  ...meterPairs,
+  ...severityPairs,
+  ...badgePairs,
+  ...disabledPairs
+];
+
+// src/scales.ts
+function semantic(key, value2, description) {
+  return { key, tier: "semantic", value: value2, usage: "decorative", description };
+}
+function aliased(key, alias, description) {
+  return { key, tier: "semantic", alias, usage: "decorative", description };
+}
+var FONT_SIZE_PX = {
+  "2xs": 10,
+  xs: 11,
+  sm: 12,
+  base: 13,
+  md: 14,
+  lg: 16,
+  xl: 20
+};
+var LINE_HEIGHT_RATIO = {
+  "2xs": 1.4,
+  xs: 1.45,
+  sm: 1.5,
+  base: 1.5,
+  md: 1.5,
+  lg: 1.5,
+  xl: 1.3
+};
+var FONT_STEPS = Object.keys(FONT_SIZE_PX);
+function roundHalfUp(value2) {
+  return Math.floor(value2 + 0.5);
+}
+function lineHeightPx(step) {
+  return roundHalfUp(FONT_SIZE_PX[step] * LINE_HEIGHT_RATIO[step]);
+}
+var fontSize = FONT_STEPS.map(
+  (step) => semantic(`font.size.${step}`, `${FONT_SIZE_PX[step]}px`, `Font size step \`${step}\`.`)
+);
+var fontLineHeight = FONT_STEPS.map(
+  (step) => semantic(
+    `font.lineHeight.${step}`,
+    `${lineHeightPx(step)}px`,
+    `Line height paired with \`font.size.${step}\`.`
+  )
+);
+var space = [
+  aliased("space.1", "scale.4", "Tightest gap. Badge padding block."),
+  aliased("space.2", "scale.8", "Button padding block, button gap."),
+  aliased("space.3", "scale.12", "Table cell padding inline, input padding inline."),
+  aliased("space.4", "scale.16", "Table cell padding block."),
+  aliased("space.5", "scale.24", "Card padding, card grid gap, content stack gap."),
+  aliased("space.6", "scale.32", "Page stack gap."),
+  aliased("space.7", "scale.40", "Section spacing."),
+  aliased("space.8", "scale.48", "Widest gap.")
+];
+var radius = [
+  aliased("radius.xs", "curve.6", "Smallest radius."),
+  aliased("radius.sm", "curve.9", "Form control radius."),
+  aliased("radius.md", "curve.12", "Button radius, compact card radius."),
+  aliased("radius.lg", "curve.18", "Card and overlay radius."),
+  aliased("radius.xl", "curve.24", "Largest radius."),
+  semantic("radius.pill", "9999px", "Fully rounded badge, toggle, marker and progress geometry.")
+];
+var Z_LAYERS = {
+  base: 0,
+  raised: 10,
+  sticky: 20,
+  drawer: 30,
+  overlay: 40,
+  popover: 50
+};
+var zDescriptions = {
+  base: "Normal flow.",
+  raised: "Lifts a focus ring out of an ancestor's `overflow: hidden`.",
+  sticky: "The app shell top bar.",
+  drawer: "Side navigation and the `Drawer` panel.",
+  overlay: "`Dialog` and `Drawer` scrims.",
+  popover: "`Tooltip`, `DropdownMenu`, `Select` content, skip link."
+};
+var z = Object.keys(Z_LAYERS).map(
+  (layer) => semantic(`z.${layer}`, Z_LAYERS[layer], zDescriptions[layer])
+);
+var BREAKPOINT_PX = {
+  sm: 560,
+  md: 800,
+  lg: 1080
+};
+var breakpointDescriptions = {
+  sm: "Single-column card grid; taller form controls.",
+  md: "Single-column split layout; table horizontal scroll; off-canvas navigation.",
+  lg: "Narrower navigation; narrower minimum grid column."
+};
+var breakpoint = Object.keys(BREAKPOINT_PX).map(
+  (name) => semantic(`breakpoint.${name}`, `${BREAKPOINT_PX[name]}px`, breakpointDescriptions[name])
+);
+var motion = [
+  semantic("motion.fast", "140ms {ease.entrance}", "Colour, background and border transitions."),
+  semantic("motion.standard", "240ms {ease.entrance}", "Overlay and page entrance."),
+  semantic("motion.bounce", "300ms {ease.overshoot}", "Toggle and switch settle.")
+];
+var scaleTokens = [
+  ...fontSize,
+  ...fontLineHeight,
+  ...space,
+  ...radius,
+  ...z,
+  ...breakpoint,
+  ...motion
+];
+
+// src/components.ts
+function component(key, source, description, usage = "decorative") {
+  return { key, tier: "component", usage, description, ...source };
+}
+var value = (literal) => ({ value: literal });
+var ref = (key) => ({ alias: key });
+var button = [
+  component("button.minHeight", value("40px"), "Minimum target height."),
+  component("button.minHeightCompact", value("42px"), "Minimum height below `breakpoint.sm`."),
+  component("button.paddingBlock", ref("space.2"), "Vertical padding."),
+  component("button.paddingInline", value("14px"), "Horizontal padding."),
+  component("button.radius", ref("radius.md"), "Corner radius."),
+  component("button.fontSize", ref("font.size.md"), "Label size. 14px for body-level readability."),
+  component("button.gap", ref("space.2"), "Gap between icon and label."),
+  component("button.transition", ref("motion.fast"), "State transition."),
+  component("button.primary.background", ref("accent.DEFAULT"), "Primary fill."),
+  component("button.primary.backgroundHover", ref("accent.DEFAULT"), "Primary fill stays flat on hover."),
+  component("button.primary.text", ref("text.inverse"), "Primary label. 5.39:1 on the fill.", "body"),
+  component("button.primary.border", value("transparent"), "Primary needs no edge."),
+  component("button.primary.shadow", ref("elevation.raised"), "Primary resting shadow."),
+  component("button.primary.shadowHover", ref("elevation.hover"), "Primary hover shadow."),
+  component("button.secondary.background", ref("surface.raised"), "Secondary fill."),
+  component("button.secondary.backgroundHover", ref("surface.elevated"), "Secondary hover fill."),
+  component("button.secondary.text", ref("text.primary"), "Secondary label.", "body"),
+  component(
+    "button.secondary.border",
+    ref("border.strong"),
+    "Secondary edge. Not `border.control`: FR-THM-005 AC-2 scopes that token to the five form controls, and a button is identified by its fill, label and focus ring."
+  ),
+  component("button.secondary.borderHover", ref("accent.DEFAULT"), "Secondary hover edge."),
+  component("button.ghost.background", value("transparent"), "Ghost has no fill."),
+  component("button.ghost.backgroundHover", ref("state.hover"), "Ghost hover wash."),
+  component("button.ghost.text", ref("text.muted"), "Ghost label.", "body"),
+  component("button.ghost.textHover", ref("text.primary"), "Ghost hover label.", "body"),
+  component("button.ghost.border", value("transparent"), "Ghost has no edge."),
+  component("button.disabled.background", ref("state.disabled"), "Disabled fill."),
+  component("button.disabled.text", ref("text.muted"), "Disabled label. 5.05:1 on the fill.", "body"),
+  component("button.disabled.border", ref("border.default"), "Disabled edge."),
+  component("button.policyDisabled.background", ref("state.disabledPolicy"), "Policy-blocked fill."),
+  component(
+    "button.policyDisabled.text",
+    ref("meter.exceeded"),
+    "Policy-blocked label. 5.27:1 on the dark amber fill (CP-041); `status.danger` would be 3.87:1.",
+    "body"
+  ),
+  component("button.policyDisabled.border", ref("status.danger"), "Policy-blocked edge."),
+  component("button.focusRing", ref("focusRing"), "Focus indicator.")
+];
+var card = [
+  component("card.background", ref("surface.glass"), "Card fill."),
+  component("card.border", ref("border.default"), "Card edge."),
+  component("card.radius", ref("radius.lg"), "Card radius."),
+  component("card.radiusCompact", ref("radius.md"), "Card radius below `breakpoint.sm`."),
+  component("card.padding", ref("space.5"), "Card padding."),
+  component("card.paddingCompact", value("18px"), "Card padding below `breakpoint.sm`."),
+  component("card.shadow", ref("elevation.raised"), "Card resting shadow."),
+  component("card.interactive.borderHover", ref("border.strong"), "Interactive card hover edge."),
+  component("card.interactive.shadowHover", ref("elevation.hover"), "Interactive card hover shadow."),
+  component("card.interactive.translateHover", value("-2px"), "Interactive card hover lift."),
+  component("card.interactive.transition", ref("motion.fast"), "Interactive card transition."),
+  component("card.grid.minColumn", value("320px"), "`auto-fill` minimum column width."),
+  component("card.grid.minColumnCompact", value("260px"), "Minimum column below `breakpoint.lg`."),
+  component("card.grid.gap", ref("space.5"), "Grid gap.")
+];
+var badge = [
+  component("badge.radius", value("9999px"), "Pill radius."),
+  component("badge.paddingBlock", ref("space.1"), "Vertical padding."),
+  component("badge.paddingInline", value("10px"), "Horizontal padding."),
+  component("badge.fontSize", ref("font.size.sm"), "Label size."),
+  component("badge.lineHeight", ref("font.lineHeight.sm"), "Label line height."),
+  component("badge.gap", value("6px"), "Gap between icon and label."),
+  component("badge.iconSize", value("12px"), "Icon box."),
+  component("badge.fill.text", ref("text.inverse"), "Label on a status fill. 5.03:1 to 9.87:1.", "body"),
+  component("badge.marker.background", ref("surface.raised"), "Marker-shape background."),
+  component("badge.marker.text", ref("text.primary"), "Marker-shape label. 15.77:1.", "body"),
+  component("badge.marker.border", ref("border.strong"), "Marker-shape edge."),
+  component("badge.marker.dotSize", value("9px"), "Status dot diameter."),
+  component("badge.marker.dotRing", ref("surface.raised"), "Marker dot ring."),
+  component("badge.marker.dotRingWidth", value("2px"), "Marker dot ring width."),
+  component("badge.severity.text", ref("text.primary"), "Label on a severity fill. 4.67:1 to 9.32:1.", "body")
+];
+var table = [
+  component("table.headerText", ref("text.muted"), "Column header text.", "body"),
+  component("table.headerFontSize", ref("font.size.base"), "Column header size."),
+  component("table.headerBorder", ref("border.default"), "Header rule."),
+  component("table.headerBorderWidth", value("2px"), "Header rule width."),
+  component(
+    "table.cellBorder",
+    ref("border.default"),
+    "Row rule. A decorative border is correct here: row separators divide content, they do not identify a component, so WCAG 1.4.11 does not apply."
+  ),
+  component("table.cellPaddingBlock", ref("space.4"), "Cell vertical padding."),
+  component("table.cellPaddingInline", ref("space.3"), "Cell horizontal padding."),
+  component("table.rowBackgroundHover", ref("state.hover"), "Row hover wash."),
+  component("table.rowTransition", ref("motion.fast"), "Row hover transition."),
+  component("table.linkText", ref("text.secondary"), "In-cell link.", "body"),
+  component("table.linkTextHover", ref("text.primary"), "In-cell link hover.", "body"),
+  component("table.numFontFamily", ref("font.mono"), "Numeric cell font."),
+  component("table.scrollBreakpoint", ref("breakpoint.md"), "Below this, the table scrolls.")
+];
+var timeline = [
+  component("timeline.background", ref("surface.timeline"), "Timeline fill."),
+  component("timeline.border", ref("border.default"), "Timeline edge."),
+  component("timeline.stepBackgroundHover", ref("state.hover"), "Interactive step hover fill."),
+  component("timeline.markerBackground", ref("accent.DEFAULT"), "Default marker fill."),
+  component("timeline.markerRing", ref("accent.glow"), "Default marker glow."),
+  component("timeline.markerBorder", ref("surface.timeline"), "Marker ring edge.")
+];
+var codeBlock = [
+  component("codeBlock.background", ref("surface.timeline"), "Code block fill."),
+  component("codeBlock.border", ref("border.default"), "Code block edge."),
+  component("codeBlock.text", ref("text.monoPayload"), "Code block text.", "body")
+];
+var kbd = [
+  component("kbd.background", ref("surface.raised"), "Keycap fill."),
+  component("kbd.border", ref("border.default"), "Keycap edge."),
+  component("kbd.borderBottom", ref("border.strong"), "Keycap lower edge."),
+  component("kbd.text", ref("text.secondary"), "Keycap text.", "body")
+];
+var banner = [
+  component("banner.info.background", ref("surface.raised"), "Info banner surface."),
+  component("banner.info.border", ref("status.running"), "Info banner edge."),
+  component("banner.info.text", ref("text.secondary"), "Info banner body text.", "body"),
+  component("banner.warning.background", ref("surface.raised"), "Warning banner surface."),
+  component("banner.warning.border", ref("status.waiting"), "Warning banner edge."),
+  component("banner.warning.text", ref("text.secondary"), "Warning banner body text.", "body"),
+  component("banner.danger.background", ref("surface.raised"), "Danger banner surface."),
+  component("banner.danger.border", ref("status.danger"), "Danger banner edge."),
+  component("banner.danger.text", ref("text.secondary"), "Danger banner body text.", "body")
+];
+var emptyState = [
+  component("emptyState.titleText", ref("text.primary"), "Empty-state title.", "body"),
+  component("emptyState.descriptionText", ref("text.muted"), "Empty-state description.", "body"),
+  component("emptyState.padding", ref("space.6"), "Empty-state padding.")
+];
+var feedbackMeter = [
+  component("feedbackMeter.trackBackground", ref("surface.track"), "Meter track."),
+  component("feedbackMeter.fillNormal", ref("meter.normal"), "Normal meter fill."),
+  component("feedbackMeter.fillWarning", ref("meter.warning"), "Warning meter fill."),
+  component("feedbackMeter.fillExceeded", ref("meter.exceeded"), "Exceeded meter fill."),
+  component("feedbackMeter.height", value("8px"), "Meter track height.")
+];
+var progressRing = [
+  component("progressRing.trackStroke", ref("surface.track"), "Progress-ring track."),
+  component("progressRing.indicatorStroke", ref("accent.DEFAULT"), "Progress-ring indicator."),
+  component("progressRing.labelText", ref("text.primary"), "Progress-ring label.", "body"),
+  component("progressRing.size", value("64px"), "Medium progress-ring diameter."),
+  component("progressRing.sizeCompact", value("40px"), "Small progress-ring diameter.")
+];
+var spinner = [
+  component("spinner.trackStroke", ref("surface.track"), "Spinner track."),
+  component("spinner.indicatorStroke", ref("accent.DEFAULT"), "Spinner indicator."),
+  component("spinner.size", value("24px"), "Medium spinner diameter."),
+  component("spinner.sizeCompact", value("16px"), "Small spinner diameter.")
+];
+var input = [
+  component("input.minHeight", value("40px"), "Minimum target height."),
+  component("input.minHeightCompact", value("42px"), "Minimum height below `breakpoint.sm`."),
+  component("input.background", ref("surface.base"), "Field fill."),
+  component("input.backgroundFocus", ref("surface.canvas"), "Focused field fill."),
+  component("input.text", ref("text.primary"), "Field value.", "body"),
+  component(
+    "input.placeholder",
+    ref("text.faint"),
+    "Placeholder. `text.faint` is allowed here and the dark field sits on `surface.base`, so the combination FR-THM-005 AC-3 forbids never renders."
+  ),
+  component("input.border", ref("border.control"), "Field edge. 3.23:1 on `surface.raised`."),
+  component("input.borderHover", ref("border.control"), "Hovered field edge."),
+  component("input.borderFocus", ref("accent.DEFAULT"), "Focused field edge."),
+  component("input.borderInvalid", ref("status.danger"), "Invalid field edge."),
+  component("input.radius", ref("radius.sm"), "Field radius."),
+  component("input.paddingBlock", value("9px"), "Field vertical padding."),
+  component("input.paddingInline", ref("space.3"), "Field horizontal padding."),
+  component("input.focusRing", ref("focusRing"), "Focus indicator."),
+  component("input.label.text", ref("text.secondary"), "Field label with stronger hierarchy.", "body"),
+  component("input.label.fontSize", ref("font.size.base"), "Field label size."),
+  component("input.error.text", ref("status.danger"), "Field error message.", "body"),
+  component("input.transition", ref("motion.fast"), "Field transition.")
+];
+var overlay = [
+  component("overlay.scrim", ref("surface.overlay"), "Backdrop behind Dialog and Drawer."),
+  component("overlay.scrimBlur", value("4px"), "Backdrop blur radius."),
+  component("overlay.scrimZ", ref("z.overlay"), "Backdrop stacking layer."),
+  component("overlay.background", ref("surface.glass"), "Overlay panel fill."),
+  component("overlay.backgroundBlur", value("16px"), "Overlay panel backdrop blur."),
+  component("overlay.border", ref("border.strong"), "Overlay panel edge."),
+  component("overlay.radius", ref("radius.lg"), "Overlay panel radius."),
+  component("overlay.shadow", ref("elevation.overlay"), "Overlay panel shadow."),
+  component("overlay.contentZ", ref("z.popover"), "Tooltip, menu and select content layer."),
+  component("overlay.drawerZ", ref("z.drawer"), "Drawer panel layer."),
+  component("overlay.drawerBackground", ref("surface.raised"), "Drawer panel fill."),
+  component("overlay.drawerWidth", value("500px"), "Drawer panel width."),
+  component("overlay.enter", ref("motion.standard"), "Overlay entrance."),
+  component("overlay.exit", ref("motion.fast"), "Overlay exit.")
+];
+var HEADING_MIN_PX = FONT_SIZE_PX.xl * 1.2;
+var HEADING_MAX_PX = FONT_SIZE_PX.xl * 1.6;
+var page = [
+  component(
+    "page.headingSize",
+    value(`clamp(${HEADING_MIN_PX}px, 3vw, ${HEADING_MAX_PX}px)`),
+    "Responsive page heading size, derived from `font.size.xl` (\xD7 1.2 and \xD7 1.6)."
+  ),
+  component(
+    "page.headingLineHeight",
+    value("1.16"),
+    "The only unitless line height: `clamp()` makes a px value impossible here."
+  ),
+  component("page.stackGap", ref("space.6"), "Gap between page sections."),
+  component("page.stackGapCompact", ref("space.5"), "Section gap below `breakpoint.sm`."),
+  component("page.contentStackGap", ref("space.5"), "Gap inside a content stack."),
+  component("page.splitBreakpoint", ref("breakpoint.md"), "Below this, a split layout stacks."),
+  component("page.splitAsideWidth", value("minmax(280px, 340px)"), "Split layout aside track."),
+  component("page.shellNavWidth", value("272px"), "App shell navigation width."),
+  component("page.shellNavWidthCompact", value("232px"), "Navigation width below `breakpoint.lg`."),
+  component("page.topbarZ", ref("z.sticky"), "Top bar stacking layer."),
+  component("page.navZ", ref("z.drawer"), "Navigation stacking layer."),
+  component("page.skipLinkZ", ref("z.popover"), "Skip link stacking layer.")
+];
+var shell = [
+  component("appShell.navWidth", ref("page.shellNavWidth"), "AppShell desktop navigation width."),
+  component("appShell.mainMaxWidth", value("1480px"), "AppShell main content maximum width."),
+  component("appShell.overlayBackground", ref("surface.overlay"), "Mobile navigation scrim."),
+  component("skipLink.background", ref("accent.DEFAULT"), "Skip-link fill."),
+  component("skipLink.text", ref("text.inverse"), "Skip-link label."),
+  component("navList.background", ref("surface.raised"), "Navigation surface."),
+  component("navList.border", ref("border.subtle"), "Navigation surface edge."),
+  component("navItem.text", ref("text.muted"), "Navigation item label."),
+  component("navItem.textActive", ref("text.primary"), "Active navigation item label."),
+  component("navItem.backgroundHover", ref("state.hover"), "Navigation item hover wash."),
+  component("navItem.backgroundActive", ref("state.selected"), "Active navigation item wash."),
+  component("navItem.indicator", ref("accent.DEFAULT"), "Active navigation item indicator."),
+  component("navSectionLabel.text", ref("text.faint"), "Navigation section label."),
+  component("font.weight.sectionLabel", value(700), "Navigation section label weight."),
+  component("topBar.background", ref("surface.glass"), "TopBar glass surface."),
+  component("topBar.border", ref("border.subtle"), "TopBar lower edge."),
+  component("topBar.eyebrowText", ref("text.faint"), "TopBar eyebrow label."),
+  component("topBar.titleText", ref("text.secondary"), "TopBar context title."),
+  component("topBar.minHeight", value("68px"), "TopBar minimum height.")
+];
+var componentTokens = [
+  ...button,
+  ...card,
+  ...badge,
+  ...table,
+  ...timeline,
+  ...codeBlock,
+  ...kbd,
+  ...banner,
+  ...emptyState,
+  ...feedbackMeter,
+  ...progressRing,
+  ...spinner,
+  ...input,
+  ...overlay,
+  ...page,
+  ...shell
+];
+
+// src/palette.dark.ts
+function darkToken(input2) {
+  return { tier: "semantic", ...input2 };
+}
+var surface = [
+  darkToken({
+    key: "surface.base",
+    usage: "decorative",
+    value: "#080b12",
+    description: "Application background. Contrast-exempt: surfaces are background arguments."
+  }),
+  darkToken({
+    key: "surface.canvas",
+    usage: "decorative",
+    value: "#0b101a",
+    description: "Content canvas. Contrast-exempt: surfaces are background arguments."
+  }),
+  darkToken({
+    key: "surface.subtle",
+    usage: "decorative",
+    value: "#101722",
+    description: "Recessed fill. Contrast-exempt: surfaces are background arguments."
+  }),
+  darkToken({
+    key: "surface.2",
+    usage: "decorative",
+    alias: "surface.subtle",
+    description: "Source alias of `surface.subtle`, kept as a reference (FR-THM-001 AC-2)."
+  }),
+  darkToken({
+    key: "surface.raised",
+    usage: "decorative",
+    value: "#141d2a",
+    description: "Card and panel fill. Contrast-exempt: surfaces are background arguments."
+  }),
+  darkToken({
+    key: "surface.elevated",
+    usage: "decorative",
+    value: "#192535",
+    description: "Highest surface. Contrast-exempt: surfaces are background arguments."
+  }),
+  darkToken({
+    key: "surface.overlay",
+    usage: "decorative",
+    value: "rgba(4, 7, 12, 0.78)",
+    description: "Dialog scrim. Contrast-exempt: nothing is drawn on top of a scrim."
+  }),
+  darkToken({
+    key: "surface.glass",
+    usage: "decorative",
+    value: "rgba(16, 23, 34, 0.82)",
+    description: "Translucent panel behind `backdrop-filter`. Contrast-exempt: translucent layer."
+  }),
+  darkToken({
+    key: "surface.timeline",
+    usage: "decorative",
+    value: "#0d141f",
+    description: "Timeline rail. Contrast-exempt: surfaces are background arguments."
+  }),
+  darkToken({
+    key: "surface.track",
+    usage: "decorative",
+    value: "rgba(255, 255, 255, 0.05)",
+    description: "Progress and meter track, matching the source 1:1."
+  })
+];
+var text = [
+  darkToken({
+    key: "text.primary",
+    usage: "body",
+    value: "#f4f7fb",
+    description: "Top of the text hierarchy. 14.40:1 to 18.32:1 across the five surfaces."
+  }),
+  darkToken({
+    key: "text.secondary",
+    usage: "body",
+    value: "#c5cfdd",
+    description: "Supporting copy. 9.83:1 to 12.51:1 across the five surfaces."
+  }),
+  darkToken({
+    key: "text.muted",
+    usage: "body",
+    value: "#8290a3",
+    description: "De-emphasised copy, table headers, field labels. 4.76:1 to 6.06:1."
+  }),
+  darkToken({
+    key: "text.faint",
+    usage: "decorative",
+    value: "#5f6d80",
+    description: "Meta text, timestamps, uppercase labels and input placeholders only. Contrast-exempt: 2.94:1 to 3.74:1 never reaches body 4.5:1. Forbidden on `surface.elevated` (FR-THM-005 AC-3)."
+  }),
+  darkToken({
+    key: "text.inverse",
+    usage: "body",
+    value: "#07111f",
+    description: "Text on an accent, status or severity fill."
+  }),
+  darkToken({
+    key: "text.monoPayload",
+    usage: "body",
+    value: "#dce6f3",
+    description: "Monospace payload text. 13.44:1 on `surface.raised`."
+  })
+];
+var border = [
+  darkToken({
+    key: "border.subtle",
+    usage: "decorative",
+    value: "rgba(148, 163, 184, 0.1)",
+    description: "Hairline divider. Contrast-exempt (1.13:1), WCAG 1.4.11 exception: card and panel edges are already identified by surface luminance and `elevation.*` (FR-THM-005 AC-4)."
+  }),
+  darkToken({
+    key: "border.default",
+    usage: "decorative",
+    value: "rgba(148, 163, 184, 0.18)",
+    description: "Default edge. Contrast-exempt (1.30:1), same WCAG 1.4.11 exception. Form controls use `border.control` instead (FR-THM-005 AC-4)."
+  }),
+  darkToken({
+    key: "border.strong",
+    usage: "decorative",
+    value: "rgba(148, 163, 184, 0.3)",
+    description: "Pronounced edge for buttons and overlays. Contrast-exempt (1.69:1), same WCAG 1.4.11 exception (FR-THM-005 AC-4)."
+  }),
+  darkToken({
+    key: "border.control",
+    usage: "nonText",
+    value: "rgba(148, 163, 184, 0.6)",
+    description: "Form control edge. Corrected token (FR-THM-005 AC-2): the source reused `border.default` at 1.30:1. Alpha 0.60 yields 3.23:1 on `surface.raised`. Applies to TextField, TextArea, Select, Switch and Checkbox only."
+  }),
+  darkToken({
+    key: "border.DEFAULT",
+    usage: "decorative",
+    alias: "border.default",
+    description: "Source alias of `border.default`, kept as a reference (FR-THM-001 AC-2)."
+  })
+];
+var accent = [
+  darkToken({
+    key: "accent.DEFAULT",
+    usage: "body",
+    value: "#6d7cff",
+    description: "The single accent. 5.60:1 on `surface.base`, 4.82:1 on `surface.raised`. Body use on `surface.elevated` is forbidden (4.40:1); large text and non-text use are allowed."
+  }),
+  darkToken({
+    key: "accent.strong",
+    usage: "nonText",
+    value: "#5667f5",
+    description: "Second accent step. Never a fill beneath body text; 4.36:1 on `surface.base`."
+  }),
+  darkToken({
+    key: "accent.soft",
+    usage: "decorative",
+    value: "rgba(109, 124, 255, 0.14)",
+    description: "Faint accent wash. Contrast-exempt: text above it is always `text.primary`."
+  }),
+  darkToken({
+    key: "accent.glow",
+    usage: "decorative",
+    value: "rgba(109, 124, 255, 0.28)",
+    description: "Dark-only glow. Contrast-exempt: never the sole carrier of information."
+  })
+];
+var status = [
+  darkToken({
+    key: "status.queued",
+    usage: "nonText",
+    value: "#64748b",
+    icon: "circle-dashed",
+    description: "Queued. 3.56:1 on `surface.raised`. Dot and marker only, never a text foreground; the component must render an icon and a label alongside it (FR-THM-005 AC-5, AC-7)."
+  }),
+  darkToken({
+    key: "status.running",
+    usage: "body",
+    alias: "accent.DEFAULT",
+    icon: "loader",
+    description: "Running. Resolves to the accent, matching the source 1:1 (`#6d7cff`); the reference keeps the accent family single-sourced (design principle P-5)."
+  }),
+  darkToken({
+    key: "status.waiting",
+    usage: "body",
+    value: "#f59e0b",
+    icon: "pause-circle",
+    description: "Waiting on input. 7.89:1 on `surface.raised`."
+  }),
+  darkToken({
+    key: "status.success",
+    usage: "body",
+    value: "#10b981",
+    icon: "check-circle-2",
+    description: "Completed successfully. 6.68:1 on `surface.raised`."
+  }),
+  darkToken({
+    key: "status.partial",
+    usage: "body",
+    value: "#eab308",
+    icon: "alert-circle",
+    description: "Completed with gaps. 8.84:1 on `surface.raised`."
+  }),
+  darkToken({
+    key: "status.danger",
+    usage: "body",
+    value: "#ef4444",
+    icon: "x-circle",
+    description: "Failed. 4.50:1 on `surface.raised`."
+  }),
+  darkToken({
+    key: "status.neutralEnd",
+    usage: "decorative",
+    value: "#475569",
+    icon: "circle-slash",
+    description: "Cancelled or superseded. Contrast-exempt per CR-006 (`srs_final.md` 12.1): 2.04:1 to 2.60:1 reaches non-text 3:1 on no surface. WCAG 1.4.11 exception \u2014 FR-THM-005 AC-7 forces an icon and a label alongside the colour, and the source's surface-coloured ring supplies the marker's shape boundary, so the dot's fill carries no identification on its own. Known cost: the dot reads faintly against a dark background."
+  })
+];
+var meter = [
+  darkToken({
+    key: "meter.normal",
+    usage: "body",
+    value: "#34d399",
+    description: "Below the warning threshold. 8.82:1 on `surface.raised`."
+  }),
+  darkToken({
+    key: "meter.warning",
+    usage: "body",
+    value: "#fbbf24",
+    description: "Past the warning threshold. 10.15:1 on `surface.raised`."
+  }),
+  darkToken({
+    key: "meter.exceeded",
+    usage: "body",
+    alias: "red.400",
+    description: "Past the hard limit. 6.13:1 on `surface.raised`."
+  })
+];
+var severity = [
+  darkToken({
+    key: "severity.read",
+    usage: "body",
+    value: "#15803d",
+    icon: "eye",
+    description: "Read-only side effect. Fill only; 4.67:1 beneath `text.primary`."
+  }),
+  darkToken({
+    key: "severity.write",
+    usage: "body",
+    value: "#c2410c",
+    icon: "pencil",
+    description: "Mutating side effect. Fill only; 4.82:1 beneath `text.primary`."
+  }),
+  darkToken({
+    key: "severity.destructive",
+    usage: "body",
+    value: "#b91c1c",
+    icon: "trash-2",
+    description: "Destructive side effect. Fill only; 6.02:1 beneath `text.primary`."
+  }),
+  darkToken({
+    key: "severity.blocked",
+    usage: "body",
+    value: "#7f1d1d",
+    icon: "shield-x",
+    description: "Blocked by policy. Fill only; 9.32:1 beneath `text.primary`."
+  })
+];
+var fontFamily = [
+  darkToken({
+    key: "font.sans",
+    usage: "decorative",
+    alias: "stack.sans",
+    description: "Interface font stack. Not a colour."
+  }),
+  darkToken({
+    key: "font.mono",
+    usage: "decorative",
+    alias: "stack.mono",
+    description: "Payload and code font stack. Not a colour."
+  })
+];
+var elevation = [
+  darkToken({
+    key: "elevation.raised",
+    usage: "decorative",
+    value: "0 12px 30px rgba(0, 0, 0, 0.18)",
+    description: "Resting card shadow. Contrast-exempt: a shadow, not a colour."
+  }),
+  darkToken({
+    key: "elevation.hover",
+    usage: "decorative",
+    value: "0 18px 46px rgba(0, 0, 0, 0.26)",
+    description: "Hovered card shadow. Contrast-exempt: a shadow, not a colour."
+  }),
+  darkToken({
+    key: "elevation.overlay",
+    usage: "decorative",
+    value: "0 24px 64px rgba(0, 0, 0, 0.45), 0 0 0 1px {border.strong}",
+    description: "Overlay shadow plus a 1px ring. The ring references `border.strong` so each theme resolves its own edge. Contrast-exempt with that border (FR-THM-005 AC-4)."
+  })
+];
+var interaction = [
+  darkToken({
+    key: "focusRing",
+    usage: "nonText",
+    value: "0 0 0 3px rgba(109, 124, 255, 0.8)",
+    description: "Corrected token (FR-THM-005 AC-1). The source used accent alpha 0.30, which composites to 1.50:1 on `surface.base` and fails WCAG 2.4.11; a focus indicator cannot be decorative. Alpha 0.80 gives 3.93:1 on `surface.base` and 3.56:1 on `surface.raised`."
+  }),
+  darkToken({
+    key: "state.hover",
+    usage: "decorative",
+    value: "rgba(255, 255, 255, 0.055)",
+    description: "Hover wash. Contrast-exempt: nudges the surface, carries no meaning."
+  }),
+  darkToken({
+    key: "state.selected",
+    usage: "decorative",
+    value: "rgba(109, 124, 255, 0.16)",
+    description: "Selected wash. Contrast-exempt: selection is also announced via `aria-pressed` and text."
+  }),
+  darkToken({
+    key: "state.disabled",
+    usage: "decorative",
+    value: "#18202c",
+    description: "Disabled fill. Contrast-exempt as a fill; checked beneath `text.muted` (5.05:1)."
+  }),
+  darkToken({
+    key: "state.disabledPolicy",
+    usage: "decorative",
+    value: "#422006",
+    description: "Policy-blocked fill. Contrast-exempt as a fill; checked beneath the label (5.27:1)."
+  })
+];
+var darkPalette = [
+  ...surface,
+  ...text,
+  ...border,
+  ...accent,
+  ...status,
+  ...meter,
+  ...severity,
+  ...fontFamily,
+  ...elevation,
+  ...interaction
+];
+
+// src/palette.light.ts
+var values = {
+  "surface.base": "#e8ecf2",
+  "surface.canvas": "#eef1f6",
+  "surface.subtle": "#f3f6f9",
+  "surface.raised": "#fbfcfd",
+  "surface.elevated": "#ffffff",
+  "surface.overlay": "rgba(12, 18, 28, 0.45)",
+  "surface.glass": "rgba(251, 252, 253, 0.86)",
+  "surface.timeline": "#f1f4f8",
+  "surface.track": "rgba(12, 18, 28, 0.08)",
+  "text.primary": "#0c121c",
+  "text.secondary": "#33415a",
+  "text.muted": "#4d5a6e",
+  "text.faint": "#6b788c",
+  "text.inverse": "#f4f7fb",
+  "text.monoPayload": "#1b2537",
+  "border.subtle": "#e2e8f0",
+  "border.default": "#6b788c",
+  "border.strong": "#5b6879",
+  "border.control": "#64748b",
+  "accent.DEFAULT": "#4f5bd5",
+  "accent.strong": "#3f4ac0",
+  "accent.soft": "rgba(79, 91, 213, 0.14)",
+  "accent.glow": "rgba(79, 91, 213, 0.22)",
+  "status.queued": "#52607a",
+  "status.waiting": "#b45309",
+  "status.success": "#047857",
+  "status.partial": "#a16207",
+  "status.danger": "#c81e1e",
+  "status.neutralEnd": "#3f4b5f",
+  "meter.normal": "#047857",
+  "meter.warning": "#b45309",
+  "meter.exceeded": "#dc2626",
+  "elevation.raised": "0 12px 30px rgba(12, 18, 28, 0.08)",
+  "elevation.hover": "0 18px 46px rgba(12, 18, 28, 0.12)",
+  "elevation.overlay": "0 24px 64px rgba(12, 18, 28, 0.2), 0 0 0 1px {border.strong}",
+  "focusRing": "0 0 0 3px rgba(79, 91, 213, 0.8)",
+  "state.hover": "rgba(12, 18, 28, 0.05)",
+  "state.selected": "rgba(79, 91, 213, 0.12)",
+  "state.disabled": "#e2e8f0",
+  "state.disabledPolicy": "#fef3c7"
+};
+var lightPalette = darkPalette.map((token) => {
+  const value2 = values[token.key];
+  return value2 === void 0 ? token : { ...token, value: value2, alias: void 0 };
+});
+
+// src/primitives.ts
+function primitive(key, value2, description) {
+  return { key, tier: "primitive", value: value2, usage: "decorative", description };
+}
+var ink = [
+  primitive("ink.0", "#ffffff", "Pure white. `::selection` text, light `surface.elevated`."),
+  primitive("ink.25", "#fbfcfd", "Light `surface.raised`."),
+  primitive("ink.50", "#f4f7fb", "Dark `text.primary`, light `text.inverse`."),
+  primitive("ink.75", "#f3f6f9", "Light `surface.subtle`."),
+  primitive("ink.100", "#f1f4f8", "Light `surface.timeline`."),
+  primitive("ink.150", "#eef1f6", "Light `surface.canvas`."),
+  primitive("ink.200", "#e8ecf2", "Light `surface.base`."),
+  primitive("ink.250", "#e2e8f0", "Light `border.subtle` and `state.disabled`."),
+  primitive("ink.300", "#dce6f3", "Dark `text.monoPayload`."),
+  primitive("ink.350", "#c5cfdd", "Dark `text.secondary`."),
+  primitive("ink.400", "#8290a3", "Dark `text.muted`."),
+  primitive("ink.500", "#6b788c", "Light `text.faint` and `border.default`."),
+  primitive("ink.600", "#5f6d80", "Dark `text.faint`."),
+  primitive("ink.650", "#5b6879", "Light `border.strong`."),
+  primitive("ink.700", "#4d5a6e", "Light `text.muted`."),
+  primitive("ink.750", "#33415a", "Light `text.secondary`."),
+  primitive("ink.800", "#1b2537", "Light `text.monoPayload`."),
+  primitive("ink.810", "#192535", "Dark `surface.elevated`."),
+  primitive("ink.820", "#18202c", "Dark `state.disabled`."),
+  primitive("ink.840", "#141d2a", "Dark `surface.raised`."),
+  primitive("ink.860", "#101722", "Dark `surface.subtle`."),
+  primitive("ink.870", "#0d141f", "Dark `surface.timeline`."),
+  primitive("ink.880", "#0c121c", "Light `text.primary`; base colour of the light shadow ramp."),
+  primitive("ink.890", "#07111f", "Dark `text.inverse`."),
+  primitive("ink.895", "#0b101a", "Dark `surface.canvas`."),
+  primitive("ink.900", "#080b12", "Dark `surface.base`."),
+  primitive("ink.950", "#04070c", "Base colour of the dark `surface.overlay` scrim.")
+];
+var indigo = [
+  primitive("indigo.300", "#aab3ff", "Link hover in the source product."),
+  primitive("indigo.400", "#7b89ff", "Upper stop of the source primary-button gradient."),
+  primitive("indigo.500", "#6d7cff", "Dark `accent`."),
+  primitive("indigo.600", "#5667f5", "Dark `accent.strong`."),
+  primitive("indigo.700", "#4f5bd5", "Light `accent`."),
+  primitive("indigo.800", "#3f4ac0", "Light `accent.strong`.")
+];
+var slate = [
+  primitive("slate.400", "#94a3b8", "Base colour of all four dark border tokens and the scrollbar."),
+  primitive("slate.500", "#64748b", "Dark `status.queued`; light `border.control`."),
+  primitive("slate.600", "#475569", "Dark `status.neutralEnd`."),
+  primitive("slate.700", "#3f4b5f", "Light `status.neutralEnd`."),
+  primitive("slate.750", "#52607a", "Light `status.queued`.")
+];
+var statusHues = [
+  primitive("emerald.400", "#34d399", "Dark `meter.normal`."),
+  primitive("emerald.500", "#10b981", "Dark `status.success`."),
+  primitive("emerald.700", "#047857", "Light `status.success` and `meter.normal`."),
+  primitive("green.700", "#15803d", "`severity.read`, both themes."),
+  primitive("amber.100", "#fef3c7", "Light `state.disabledPolicy`."),
+  primitive("amber.400", "#fbbf24", "Dark `meter.warning`."),
+  primitive("amber.500", "#f59e0b", "Dark `status.waiting`."),
+  primitive("amber.700", "#b45309", "Light `status.waiting` and `meter.warning`."),
+  primitive("amber.950", "#422006", "Dark `state.disabledPolicy`."),
+  primitive("yellow.500", "#eab308", "Dark `status.partial`."),
+  primitive("yellow.700", "#a16207", "Light `status.partial`."),
+  primitive("orange.700", "#c2410c", "`severity.write`, both themes."),
+  primitive("red.300", "#fca5a5", "Policy-disabled button label in the source product."),
+  primitive("red.400", "#f87171", "Dark `meter.exceeded`."),
+  primitive("red.500", "#ef4444", "Dark `status.danger`."),
+  primitive("red.600", "#dc2626", "Light `meter.exceeded`."),
+  primitive("red.650", "#c81e1e", "Light `status.danger`."),
+  primitive("red.700", "#b91c1c", "`severity.destructive`, both themes."),
+  primitive("red.900", "#7f1d1d", "`severity.blocked`, both themes.")
+];
+var nonColour = [
+  primitive(
+    "stack.sans",
+    'Inter, ui-sans-serif, -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif',
+    "System sans stack. `Inter` is supplied by the consumer or falls through."
+  ),
+  primitive(
+    "stack.mono",
+    `'JetBrains Mono', ui-monospace, SFMono-Regular, "SF Mono", Menlo, monospace`,
+    "System mono stack for payloads and code."
+  ),
+  primitive("scale.4", "4px", "Spacing step."),
+  primitive("scale.8", "8px", "Spacing step."),
+  primitive("scale.12", "12px", "Spacing step."),
+  primitive("scale.16", "16px", "Spacing step."),
+  primitive("scale.24", "24px", "Spacing step."),
+  primitive("scale.32", "32px", "Spacing step."),
+  primitive("scale.40", "40px", "Spacing step."),
+  primitive("scale.48", "48px", "Spacing step."),
+  primitive("curve.6", "6px", "Corner radius step."),
+  primitive("curve.9", "9px", "Corner radius step."),
+  primitive("curve.12", "12px", "Corner radius step."),
+  primitive("curve.18", "18px", "Corner radius step."),
+  primitive("curve.24", "24px", "Corner radius step."),
+  primitive("ease.entrance", "cubic-bezier(0.2, 0, 0, 1)", "Entrance and state-change easing."),
+  primitive("ease.overshoot", "cubic-bezier(0.34, 1.56, 0.64, 1)", "Toggle settle easing.")
+];
+var primitiveTokens = [
+  ...ink,
+  ...indigo,
+  ...slate,
+  ...statusHues,
+  ...nonColour
+];
+
+// src/token-source.ts
+function componentOverride(key, source) {
+  const token = componentTokens.find((candidate) => candidate.key === key);
+  if (token === void 0) throw new Error(`unknown component token override: ${key}`);
+  return { ...token, ...source };
+}
+var THEME_SOURCES = [
+  {
+    theme: "dark",
+    colorScheme: "dark",
+    selectors: [":root", '[data-cdt-theme="dark"]'],
+    palette: darkPalette
+  },
+  {
+    theme: "light",
+    colorScheme: "light",
+    selectors: [':root[data-cdt-theme="light"]'],
+    palette: lightPalette,
+    componentOverrides: [
+      componentOverride("button.policyDisabled.text", { alias: "severity.destructive" }),
+      componentOverride("card.background", { alias: "surface.elevated" }),
+      componentOverride("card.border", { alias: "border.strong" }),
+      componentOverride("badge.severity.text", { alias: "text.inverse" }),
+      componentOverride("input.background", { alias: "surface.elevated" }),
+      componentOverride("input.backgroundFocus", { alias: "surface.elevated" }),
+      componentOverride("overlay.background", { alias: "surface.elevated" }),
+      componentOverride("overlay.backgroundBlur", { value: "0px" })
+    ]
+  }
+];
+function tokensForTheme(theme) {
+  const overrides = new Map((theme.componentOverrides ?? []).map((token) => [token.key, token]));
+  return [
+    ...primitiveTokens,
+    ...theme.palette,
+    ...scaleTokens,
+    ...componentTokens.map((token) => overrides.get(token.key) ?? token)
+  ];
+}
+
+// src/contrast/color.ts
+var HEX_SOURCE = "#([0-9a-f]{3,8})\\b";
+var FUNCTIONAL_SOURCE = "\\b(rgba?|hsla?)\\(\\s*([^()]*)\\)";
+var clamp = (value2, low, high) => Math.min(Math.max(value2, low), high);
+function fromHex(digits) {
+  const byte = (pair2) => parseInt(pair2.length === 1 ? pair2 + pair2 : pair2, 16);
+  if (digits.length === 3 || digits.length === 4) {
+    const [r, g, b, a] = [...digits];
+    return { r: byte(r), g: byte(g), b: byte(b), alpha: a === void 0 ? 1 : byte(a) / 255 };
+  }
+  if (digits.length === 6 || digits.length === 8) {
+    const at = (index) => digits.slice(index, index + 2);
+    return {
+      r: byte(at(0)),
+      g: byte(at(2)),
+      b: byte(at(4)),
+      alpha: digits.length === 8 ? byte(at(6)) / 255 : 1
+    };
+  }
+  return void 0;
+}
+function argumentsOf(body) {
+  return body.replace(/\//g, " ").split(/[\s,]+/).filter((part) => part !== "");
+}
+function toAlpha(raw) {
+  if (raw === void 0) return 1;
+  const value2 = raw.endsWith("%") ? Number(raw.slice(0, -1)) / 100 : Number(raw);
+  return Number.isFinite(value2) ? clamp(value2, 0, 1) : 1;
+}
+function fromRgb(body) {
+  const parts = argumentsOf(body);
+  if (parts.length < 3) return void 0;
+  const channel = (raw) => {
+    const value2 = raw.endsWith("%") ? Number(raw.slice(0, -1)) / 100 * 255 : Number(raw);
+    return Number.isFinite(value2) ? clamp(Math.round(value2), 0, 255) : Number.NaN;
+  };
+  const r = channel(parts[0]);
+  const g = channel(parts[1]);
+  const b = channel(parts[2]);
+  if ([r, g, b].some(Number.isNaN)) return void 0;
+  return { r, g, b, alpha: toAlpha(parts[3]) };
+}
+function fromHsl(body) {
+  const parts = argumentsOf(body);
+  if (parts.length < 3) return void 0;
+  const hue = Number(parts[0].replace(/deg$/i, ""));
+  const saturation = Number(parts[1].replace(/%$/, "")) / 100;
+  const lightness = Number(parts[2].replace(/%$/, "")) / 100;
+  if (![hue, saturation, lightness].every((value2) => Number.isFinite(value2))) return void 0;
+  const chroma = (1 - Math.abs(2 * clamp(lightness, 0, 1) - 1)) * clamp(saturation, 0, 1);
+  const sextant = (hue % 360 + 360) % 360 / 60;
+  const secondary = chroma * (1 - Math.abs(sextant % 2 - 1));
+  const lift = clamp(lightness, 0, 1) - chroma / 2;
+  const wheel = [
+    [chroma, secondary, 0],
+    [secondary, chroma, 0],
+    [0, chroma, secondary],
+    [0, secondary, chroma],
+    [secondary, 0, chroma],
+    [chroma, 0, secondary]
+  ];
+  const [r, g, b] = wheel[Math.floor(sextant) % 6];
+  const channel = (raw) => clamp(Math.round((raw + lift) * 255), 0, 255);
+  return { r: channel(r), g: channel(g), b: channel(b), alpha: toAlpha(parts[3]) };
+}
+function parseFunctional(name, body) {
+  return name.toLowerCase().startsWith("hsl") ? fromHsl(body) : fromRgb(body);
+}
+function findColors(value2) {
+  const found = [];
+  for (const match of value2.matchAll(new RegExp(FUNCTIONAL_SOURCE, "gi"))) {
+    const parsed = parseFunctional(match[1], match[2]);
+    if (parsed) found.push(parsed);
+  }
+  for (const match of value2.matchAll(new RegExp(HEX_SOURCE, "gi"))) {
+    const parsed = fromHex(match[1]);
+    if (parsed) found.push(parsed);
+  }
+  return found;
+}
+function linearise(channel8) {
+  const channel = channel8 / 255;
+  return channel <= 0.04045 ? channel / 12.92 : ((channel + 0.055) / 1.055) ** 2.4;
+}
+function relativeLuminance({ r, g, b }) {
+  return 0.2126 * linearise(r) + 0.7152 * linearise(g) + 0.0722 * linearise(b);
+}
+function contrastRatio(one, other) {
+  const first = relativeLuminance(one);
+  const second = relativeLuminance(other);
+  const lighter = Math.max(first, second);
+  const darker = Math.min(first, second);
+  return (lighter + 0.05) / (darker + 0.05);
+}
+function compositeOver(foreground, background) {
+  if (foreground.alpha >= 1) return foreground;
+  const mix = (front, back) => Math.round(front * foreground.alpha + back * (1 - foreground.alpha));
+  return {
+    r: mix(foreground.r, background.r),
+    g: mix(foreground.g, background.g),
+    b: mix(foreground.b, background.b),
+    alpha: 1
+  };
+}
+function toHex({ r, g, b }) {
+  const pair2 = (channel) => channel.toString(16).padStart(2, "0");
+  return `#${pair2(r)}${pair2(g)}${pair2(b)}`;
+}
+
+// src/contrast/check.ts
+function assertUniqueIds(pairs) {
+  const seen = /* @__PURE__ */ new Set();
+  const duplicates = /* @__PURE__ */ new Set();
+  for (const { id } of pairs) {
+    if (seen.has(id)) duplicates.add(id);
+    seen.add(id);
+  }
+  if (duplicates.size === 0) return;
+  throw new TokenBuildError("TOK-CP-DUPLICATE-ID", `${duplicates.size} contrast pair id(s) declared twice`, [
+    ...duplicates,
+    "hint: CP ids are permanent. A removed pair leaves its number retired (tokens spec 8.2)."
+  ]);
+}
+function lookup(index, pair2, role) {
+  const declared = pair2[role];
+  const key = resolveReferenceTarget(index, declared);
+  if (key === void 0) {
+    throw new TokenBuildError("TOK-CP-UNKNOWN-KEY", "contrast pair names a token that does not exist", [
+      `pair: ${pair2.id}`,
+      `${role}: ${declared}`,
+      "hint: check the spelling, or remove the pair. Primitive keys are not addressable here."
+    ]);
+  }
+  return index.get(key);
+}
+function assertUsageAgrees(pair2, foreground) {
+  if (foreground.usage === "decorative") {
+    throw new TokenBuildError(
+      "TOK-CP-DECORATIVE",
+      "a `decorative` token is declared as a contrast pair foreground",
+      [
+        `pair: ${pair2.id}`,
+        `foreground: ${foreground.key}`,
+        `reason it is excluded: ${foreground.description}`,
+        "hint: `decorative` means excluded from contrast checking. Reclassifying it needs a CR."
+      ]
+    );
+  }
+  const agrees = foreground.usage === pair2.usage || pair2.usage === "large" && foreground.usage === "body";
+  if (agrees) return;
+  throw new TokenBuildError("TOK-CP-USAGE", "contrast pair threshold disagrees with the token's `usage`", [
+    `pair: ${pair2.id}`,
+    `foreground: ${foreground.key} declares usage \`${String(foreground.usage)}\``,
+    `pair declares usage \`${pair2.usage}\``,
+    "hint: `srs_final.md` 12.1 fixes each token's usage; the pair follows it."
+  ]);
+}
+function colorOf(pair2, token, value2, role) {
+  const colors = findColors(value2);
+  if (colors.length === 1) return colors[0];
+  throw new TokenBuildError(
+    "TOK-CP-COLOR",
+    colors.length === 0 ? "contrast pair token resolves to a value that holds no colour" : "contrast pair token resolves to a value that holds more than one colour",
+    [
+      `pair: ${pair2.id}`,
+      `${role}: ${token.key}`,
+      `value: ${value2}`,
+      `colours found: ${colors.length}`,
+      "hint: a pair measures one colour. `focusRing` works because its box-shadow carries exactly one."
+    ]
+  );
+}
+function measure(pair2, theme, index, values2) {
+  const foreground = lookup(index, pair2, "foreground");
+  const background = lookup(index, pair2, "background");
+  assertUsageAgrees(pair2, foreground);
+  const foregroundValue = values2.get(foreground.key);
+  const backgroundValue = values2.get(background.key);
+  const backgroundColor = colorOf(pair2, background, backgroundValue, "background");
+  if (backgroundColor.alpha < 1) {
+    throw new TokenBuildError("TOK-CP-ALPHA", "contrast pair background is translucent", [
+      `pair: ${pair2.id}`,
+      `background: ${background.key} = ${backgroundValue}`,
+      "hint: a translucent background has no colour of its own. Declare the opaque surface beneath it."
+    ]);
+  }
+  const foregroundColor = colorOf(pair2, foreground, foregroundValue, "foreground");
+  const composited = compositeOver(foregroundColor, backgroundColor);
+  const ratio = contrastRatio(composited, backgroundColor);
+  const threshold = CONTRAST_THRESHOLDS[pair2.usage];
+  return {
+    id: pair2.id,
+    theme,
+    foreground: pair2.foreground,
+    background: pair2.background,
+    foregroundValue,
+    backgroundValue,
+    compositedForeground: toHex(composited),
+    usage: pair2.usage,
+    threshold,
+    ratio: Number(ratio.toFixed(4)),
+    pass: ratio >= threshold
+  };
+}
+function exclusionsFor(tokens) {
+  return tokens.filter((token) => token.tier !== "primitive" && token.usage === "decorative").map((token) => ({ key: token.key, usage: "decorative", reason: token.description }));
+}
+function checkContrast(options = {}) {
+  const themes = options.themes ?? THEME_SOURCES;
+  const pairs = options.pairs ?? contrastPairs;
+  assertUniqueIds(pairs);
+  const results = [];
+  const exclusions = /* @__PURE__ */ new Map();
+  for (const theme of themes) {
+    const tokens = tokensForTheme(theme);
+    const index = buildTokenIndex(tokens);
+    const { values: values2 } = resolveTokens(index);
+    for (const exclusion of exclusionsFor(tokens)) exclusions.set(exclusion.key, exclusion);
+    for (const pair2 of pairs) {
+      if (!pair2.themes.includes(theme.theme)) continue;
+      results.push(measure(pair2, theme.theme, index, values2));
+    }
+  }
+  const failed = results.filter((result) => !result.pass).length;
+  return {
+    themes: themes.map((theme) => theme.theme),
+    thresholds: CONTRAST_THRESHOLDS,
+    results,
+    exclusions: [...exclusions.values()],
+    summary: {
+      declaredPairs: pairs.length,
+      checks: results.length,
+      passed: results.length - failed,
+      failed,
+      excludedTokens: exclusions.size
+    }
+  };
+}
+
+// src/contrast/report.ts
+function formatRatio(ratio) {
+  return ratio.toFixed(2);
+}
+function formatResult(result) {
+  const columns = [
+    `theme=${result.theme}`.padEnd(12),
+    `id=${result.id}`.padEnd(11),
+    `pair=${result.foreground}/${result.background}`.padEnd(52),
+    `ratio=${formatRatio(result.ratio)}`.padEnd(12),
+    `threshold=${result.threshold.toFixed(2)}(${result.usage})`.padEnd(26),
+    result.pass ? "PASS" : "FAIL"
+  ];
+  return columns.join(" ").trimEnd();
+}
+function formatSummary(report) {
+  return `${report.summary.failed} of ${report.summary.checks} pairs checked failed contrast threshold`;
+}
+function exitCodeFor(report) {
+  return report.summary.failed > 0 ? 1 : 0;
+}
+function formatExclusions(report) {
+  const lines = [
+    `[contrast] ${report.summary.excludedTokens} token(s) excluded from contrast checks (usage: decorative)`
+  ];
+  for (const exclusion of report.exclusions) {
+    lines.push(`  ${exclusion.key}`);
+    lines.push(`    reason: ${exclusion.reason}`);
+  }
+  lines.push("[contrast] --report: no files written");
+  return lines;
+}
+function renderReportJson(report) {
+  return `${JSON.stringify(
+    {
+      $generatedBy: "@conductor-by-89soone/tokens conductor-check-contrast",
+      themes: report.themes,
+      thresholds: report.thresholds,
+      summary: report.summary,
+      results: report.results,
+      exclusions: report.exclusions
+    },
+    null,
+    2
+  )}
+`;
+}
+
+// src/contrast-cli.ts
+var PACKAGE_ROOT = resolve(dirname(fileURLToPath(import.meta.url)), "..");
+var REPORT_FILE = "contrast-report.json";
+function runOnce(options) {
+  const themes = selectThemes(THEME_SOURCES, options.theme);
+  const report = checkContrast({ themes });
+  if (options.report) {
+    for (const line of formatExclusions(report)) console.log(line);
+    return 0;
+  }
+  for (const result of report.results) console.log(formatResult(result));
+  const outDir = resolve(PACKAGE_ROOT, options.outDir);
+  writeArtifacts(outDir, /* @__PURE__ */ new Map([[REPORT_FILE, renderReportJson(report)]]));
+  console.log(`[contrast] wrote ${options.outDir}/${REPORT_FILE}`);
+  console.log(formatSummary(report));
+  return exitCodeFor(report);
+}
+function reportFailure(error) {
+  if (error instanceof TokenBuildError) {
+    console.error(error.format());
+    if (error.exitCode === 1) console.error("no output written");
+    return error.exitCode;
+  }
+  console.error(error instanceof Error ? error.stack ?? error.message : String(error));
+  return 1;
+}
+function main(argv) {
+  try {
+    return runOnce(parseContrastArgs(argv));
+  } catch (error) {
+    return reportFailure(error);
+  }
+}
+process.exitCode = main(process.argv.slice(2));