@conductor-by-89soone/tokens 0.0.0

package/dist/cli.js

@@ -0,0 +1,1635 @@
+import { watch, mkdirSync, writeFileSync, rmSync, renameSync, existsSync, readFileSync } from 'fs';
+import { resolve, dirname, join } from 'path';
+import { fileURLToPath } from 'url';
+
+// src/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");
+  }
+};
+
+// src/schema.ts
+var MAX_REFERENCE_DEPTH = 10;
+var DEFAULT_SEGMENT = "DEFAULT";
+var REFERENCE_PATTERN = /\{([^{}]+)\}/g;
+function extractReferences(value2) {
+  return [...value2.matchAll(REFERENCE_PATTERN)].map((match) => match[1]);
+}
+function stripBraces(reference) {
+  const trimmed = reference.trim();
+  return trimmed.startsWith("{") && trimmed.endsWith("}") ? trimmed.slice(1, -1).trim() : trimmed;
+}
+function referencesOf(token) {
+  if (token.alias !== void 0) return [stripBraces(token.alias)];
+  return typeof token.value === "string" ? extractReferences(token.value) : [];
+}
+var TIER_RANK = {
+  primitive: 0,
+  semantic: 1,
+  component: 2
+};
+function tierRank(tier) {
+  return TIER_RANK[tier];
+}
+var FIXED_GROUP_SIZES = {
+  status: 7,
+  severity: 4,
+  meter: 3
+};
+var ICON_REQUIRED_GROUPS = ["status", "severity"];
+function groupKeyOf(key) {
+  const [head] = key.split(".");
+  return head;
+}
+
+// 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/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/check.ts
+function exclusionsFor(tokens) {
+  return tokens.filter((token) => token.tier !== "primitive" && token.usage === "decorative").map((token) => ({ key: token.key, usage: "decorative", reason: token.description }));
+}
+
+// src/constants.ts
+var CDT_PREFIX = "cdt-";
+
+// src/build/names.ts
+var CUSTOM_PROPERTY_PREFIX = `--${CDT_PREFIX}`;
+function kebab(segment) {
+  return segment.replace(/([a-z0-9])([A-Z])/g, "$1-$2").toLowerCase();
+}
+function cssPropertyName(key) {
+  const segments = key.split(".").filter((segment) => segment !== DEFAULT_SEGMENT).map(kebab);
+  return `${CUSTOM_PROPERTY_PREFIX}${segments.join("-")}`;
+}
+function assertNoNameCollisions(tokens) {
+  const byName = /* @__PURE__ */ new Map();
+  for (const token of tokens) {
+    const name = cssPropertyName(token.key);
+    const keys = byName.get(name);
+    if (keys) keys.push(token.key);
+    else byName.set(name, [token.key]);
+  }
+  const collisions = [...byName.entries()].filter(([, keys]) => keys.length > 1);
+  if (collisions.length === 0) return;
+  throw new TokenBuildError(
+    "TOK-NAME-COLLISION",
+    `${collisions.length} CSS custom property name(s) claimed by more than one token key`,
+    [
+      ...collisions.map(([name, keys]) => `${name} <- ${keys.join(", ")}`),
+      "hint: rename one of the keys; the dot-to-kebab mapping is not injective."
+    ]
+  );
+}
+function assertPrefixed(propertyNames) {
+  const unprefixed = propertyNames.filter((name) => !name.startsWith(CUSTOM_PROPERTY_PREFIX));
+  if (unprefixed.length === 0) return;
+  throw new TokenBuildError(
+    "TOK-PREFIX",
+    `${unprefixed.length} custom property declaration(s) missing the \`${CUSTOM_PROPERTY_PREFIX}\` prefix`,
+    [...unprefixed, `hint: every Conductor custom property is namespaced \`${CUSTOM_PROPERTY_PREFIX}\`.`]
+  );
+}
+var IDENTIFIER_PATTERN = /^[A-Za-z_$][A-Za-z0-9_$]*$/;
+function isSafeIdentifier(segment) {
+  return IDENTIFIER_PATTERN.test(segment);
+}
+
+// src/build/media.ts
+var BREAKPOINT_NAMES = Object.keys(BREAKPOINT_PX);
+var MEDIA_PRELUDE = /@media((?:[^{]|\{[^{}]*\})*)\{/g;
+var BREAKPOINT_VAR = /var\(\s*--cdt-breakpoint-([a-z]+)\s*\)/g;
+var BREAKPOINT_REF = /\{\s*breakpoint\.([a-z]+)\s*\}/g;
+function literalFor(name) {
+  return BREAKPOINT_NAMES.includes(name) ? `${BREAKPOINT_PX[name]}px` : void 0;
+}
+function substitutePrelude(prelude) {
+  return prelude.replace(BREAKPOINT_VAR, (match, name) => literalFor(name) ?? match).replace(BREAKPOINT_REF, (match, name) => literalFor(name) ?? match);
+}
+function substituteBreakpoints(css) {
+  return css.replace(MEDIA_PRELUDE, (_match, prelude) => `@media${substitutePrelude(prelude)}{`);
+}
+function findBreakpointVarsInMedia(css) {
+  const offenders = [];
+  for (const [, prelude] of css.matchAll(MEDIA_PRELUDE)) {
+    const condition = prelude;
+    if (/var\(\s*--cdt-breakpoint-/.test(condition)) offenders.push(`@media${condition.trimEnd()}`);
+  }
+  return offenders;
+}
+function assertNoBreakpointVarsInMedia(css) {
+  const offenders = findBreakpointVarsInMedia(css);
+  if (offenders.length === 0) return;
+  throw new TokenBuildError(
+    "TOK-MEDIA-VAR",
+    `${offenders.length} \`@media\` condition(s) reference a breakpoint custom property`,
+    [
+      ...offenders,
+      `hint: custom properties do not evaluate in media conditions; ${cssPropertyName(
+        "breakpoint.md"
+      )} must be substituted as a literal.`
+    ]
+  );
+}
+var breakpointPixels = BREAKPOINT_PX;
+
+// src/build/emit-css.ts
+var BANNER = [
+  "/*",
+  " * Generated by @conductor-by-89soone/tokens. Do not edit.",
+  " * Source: packages/tokens/src/{primitives,palette.dark,palette.light,scales,components}.ts",
+  " */"
+].join("\n");
+function emittableTokens(tokens) {
+  return tokens.filter((token) => token.tier !== "primitive");
+}
+function declarationsFor(tokens, values2) {
+  const lines = [];
+  let previousGroup;
+  for (const token of tokens) {
+    const group = groupKeyOf(token.key);
+    if (previousGroup !== void 0 && group !== previousGroup) lines.push("");
+    previousGroup = group;
+    const resolved = values2.get(token.key);
+    lines.push(`  ${cssPropertyName(token.key)}: ${resolved};`);
+  }
+  return lines;
+}
+function emitCss(tokens, themes, fallbacks = []) {
+  const emitted = emittableTokens(tokens);
+  assertNoNameCollisions(emitted);
+  assertPrefixed(emitted.map((token) => cssPropertyName(token.key)));
+  const blocks = themes.map((theme) => {
+    const selector = theme.selectors.join(",\n");
+    const body = [`  color-scheme: ${theme.colorScheme};`, "", ...declarationsFor(emitted, theme.values)];
+    return `${selector} {
+${body.join("\n")}
+}`;
+  });
+  const fallbackBlocks = fallbacks.map((theme) => {
+    const selector = theme.selectors.join(",\n");
+    const body = [`  color-scheme: ${theme.colorScheme};`, "", ...declarationsFor(emitted, theme.values)];
+    return `@media (prefers-color-scheme: light) {
+${selector} {
+${body.join("\n")}
+}
+}`;
+  });
+  const css = `${BANNER}
+
+${[...blocks, ...fallbackBlocks].join("\n\n")}
+`;
+  const substituted = substituteBreakpoints(css);
+  assertNoBreakpointVarsInMedia(substituted);
+  return substituted;
+}
+
+// src/build/emit-json.ts
+function buildTokenJson(tokens, themes) {
+  const entries = emittableTokens(tokens).map((token) => {
+    const values2 = {};
+    for (const theme of themes) values2[theme.theme] = theme.values.get(token.key);
+    return {
+      key: token.key,
+      cssName: cssPropertyName(token.key),
+      tier: token.tier,
+      // `assertUsageMetadata` has already rejected any token without one.
+      usage: token.usage,
+      description: token.description,
+      ...token.alias !== void 0 ? { alias: token.alias } : {},
+      ...token.icon !== void 0 ? { icon: token.icon } : {},
+      ...token.themeSpecific !== void 0 ? { themeSpecific: token.themeSpecific } : {},
+      values: values2
+    };
+  });
+  return { themes: themes.map((theme) => theme.theme), tokens: entries };
+}
+function emitTokenJson(tokens, themes) {
+  return `${JSON.stringify(buildTokenJson(tokens, themes), null, 2)}
+`;
+}
+
+// src/build/emit-ts.ts
+function emptyNode() {
+  return { children: /* @__PURE__ */ new Map() };
+}
+function buildTree(tokens) {
+  const root = emptyNode();
+  for (const token of tokens) {
+    let node = root;
+    const segments = token.key.split(".");
+    for (const segment of segments.slice(0, -1)) {
+      let child = node.children.get(segment);
+      if (!child) {
+        child = emptyNode();
+        node.children.set(segment, child);
+      }
+      node = child;
+    }
+    const last = segments[segments.length - 1];
+    let leafNode = node.children.get(last);
+    if (!leafNode) {
+      leafNode = emptyNode();
+      node.children.set(last, leafNode);
+    }
+    leafNode.leaf = `var(${cssPropertyName(token.key)})`;
+  }
+  return root;
+}
+function propertyName(segment) {
+  return isSafeIdentifier(segment) ? segment : JSON.stringify(segment);
+}
+function serialize(node, depth) {
+  const pad = "  ".repeat(depth);
+  const innerPad = "  ".repeat(depth + 1);
+  const entries = [...node.children.entries()].map(([segment, child]) => {
+    const name = propertyName(segment);
+    if (child.leaf !== void 0 && child.children.size === 0) {
+      return `${innerPad}${name}: ${JSON.stringify(child.leaf)},`;
+    }
+    return `${innerPad}${name}: ${serialize(child, depth + 1)},`;
+  });
+  return `{
+${entries.join("\n")}
+${pad}}`;
+}
+var TOKENS_BANNER = [
+  "/**",
+  " * Generated by @conductor-by-89soone/tokens. Do not edit.",
+  " * Run `pnpm --filter @conductor-by-89soone/tokens run build` to regenerate.",
+  " *",
+  " * Values are CSS custom property references, not raw colours: a theme swap changes what the",
+  " * browser resolves them to, never the strings themselves (FR-THM-003 AC-4).",
+  " */"
+].join("\n");
+function emitTokensModule(tokens) {
+  const emitted = tokens.filter((token) => token.tier !== "primitive");
+  const tree = buildTree(emitted);
+  return [
+    TOKENS_BANNER,
+    "",
+    `export const tokens = ${serialize(tree, 0)} as const;`,
+    "",
+    "/** Shape of the token object, with every leaf narrowed to its own string literal. */",
+    "export type Tokens = typeof tokens;",
+    ""
+  ].join("\n");
+}
+var BREAKPOINTS_BANNER = [
+  "/**",
+  " * Generated by @conductor-by-89soone/tokens. Do not edit.",
+  " * Run `pnpm --filter @conductor-by-89soone/tokens run build` to regenerate.",
+  " *",
+  " * Literal pixel numbers, unlike `tokens`: a custom property does not evaluate inside a media",
+  " * query condition, so JS that computes a breakpoint needs the number itself (FR-TOK-009 AC-3).",
+  " */"
+].join("\n");
+function emitBreakpointsModule() {
+  const entries = Object.entries(breakpointPixels).map(
+    ([name, pixels]) => `  ${propertyName(name)}: ${pixels},`
+  );
+  return [
+    BREAKPOINTS_BANNER,
+    "",
+    `export const breakpoints = {
+${entries.join("\n")}
+} as const;`,
+    "",
+    "/** Shape of the breakpoint object, with every value narrowed to its own numeric literal. */",
+    "export type Breakpoints = typeof breakpoints;",
+    ""
+  ].join("\n");
+}
+
+// src/build/tiers.ts
+var VALID_TIERS = ["primitive", "semantic", "component"];
+function assertEveryTokenHasATier(tokens) {
+  const untiered = tokens.filter((token) => !VALID_TIERS.includes(token.tier));
+  if (untiered.length === 0) return;
+  throw new TokenBuildError(
+    "TOK-TIER-MISSING",
+    `${untiered.length} token(s) declare no valid tier`,
+    [
+      ...untiered.map((token) => token.key),
+      `hint: every token declares one of ${VALID_TIERS.join(", ")}.`
+    ]
+  );
+}
+function findTierViolations(index) {
+  const violations = [];
+  for (const token of index.values()) {
+    for (const reference of referencesOf(token)) {
+      const targetKey = resolveReferenceTarget(index, reference);
+      if (targetKey === void 0) continue;
+      const target = index.get(targetKey);
+      if (token.tier === "primitive") {
+        violations.push({
+          from: token.key,
+          fromTier: token.tier,
+          to: targetKey,
+          toTier: target.tier,
+          reason: "a primitive token references nothing (AC-1)"
+        });
+        continue;
+      }
+      if (tierRank(target.tier) > tierRank(token.tier)) {
+        violations.push({
+          from: token.key,
+          fromTier: token.tier,
+          to: targetKey,
+          toTier: target.tier,
+          reason: `a ${token.tier} token may not reference a ${target.tier} token`
+        });
+      }
+    }
+  }
+  return violations;
+}
+function assertTierDirection(index) {
+  const violations = findTierViolations(index);
+  if (violations.length === 0) return;
+  throw new TokenBuildError(
+    "TOK-TIER",
+    `${violations.length} reverse token reference(s)`,
+    [
+      ...violations.map(
+        (violation) => `${violation.from} (${violation.fromTier}) -> ${violation.to} (${violation.toTier}): ${violation.reason}`
+      ),
+      "hint: references run primitive <- semantic <- component; never upward."
+    ]
+  );
+}
+
+// src/build/validate.ts
+function buildTokenGroups(tokens) {
+  const groups = /* @__PURE__ */ new Map();
+  for (const token of tokens) {
+    const groupKey = groupKeyOf(token.key);
+    const group = groups.get(groupKey);
+    if (group) group.memberKeys.push(token.key);
+    else groups.set(groupKey, { tier: token.tier, memberKeys: [token.key] });
+  }
+  return [...groups.entries()].map(([groupKey, group], order) => ({
+    groupKey,
+    tier: group.tier,
+    memberKeys: group.memberKeys,
+    order
+  }));
+}
+function assertGroupSizes(tokens) {
+  const groups = new Map(buildTokenGroups(tokens).map((group) => [group.groupKey, group]));
+  const problems = [];
+  for (const [groupKey, expected] of Object.entries(FIXED_GROUP_SIZES)) {
+    const actual = groups.get(groupKey)?.memberKeys.length ?? 0;
+    if (actual !== expected) problems.push(`${groupKey}: expected ${expected} members, found ${actual}`);
+  }
+  if (problems.length === 0) return;
+  throw new TokenBuildError("TOK-GROUP-SIZE", `${problems.length} token group(s) of the wrong size`, [
+    ...problems,
+    "hint: FR-TOK-005 fixes these counts; changing one needs a change request."
+  ]);
+}
+function assertIconMetadata(tokens) {
+  const missing = tokens.filter((token) => ICON_REQUIRED_GROUPS.includes(groupKeyOf(token.key))).filter((token) => token.icon === void 0 || token.icon.trim() === "").map((token) => token.key);
+  if (missing.length === 0) return;
+  throw new TokenBuildError("TOK-ICON", `${missing.length} token(s) missing \`icon\` metadata`, [
+    ...missing,
+    `hint: every ${ICON_REQUIRED_GROUPS.join(" and ")} token names a non-empty icon.`
+  ]);
+}
+function assertUsageMetadata(tokens) {
+  const missing = tokens.filter((token) => token.usage === void 0).map((token) => token.key);
+  if (missing.length === 0) return;
+  throw new TokenBuildError("TOK-USAGE", `${missing.length} token(s) missing \`usage\` metadata`, [
+    ...missing,
+    "hint: classify as body, large, nonText or decorative (`srs_final.md` 12.1)."
+  ]);
+}
+function assertDistinctZLayers(values2) {
+  const byValue = /* @__PURE__ */ new Map();
+  for (const [key, value2] of values2) {
+    if (groupKeyOf(key) !== "z") continue;
+    const keys = byValue.get(value2);
+    if (keys) keys.push(key);
+    else byValue.set(value2, [key]);
+  }
+  const duplicates = [...byValue.entries()].filter(([, keys]) => keys.length > 1);
+  if (duplicates.length === 0) return;
+  throw new TokenBuildError(
+    "TOK-Z-DUPLICATE",
+    `${duplicates.length} stacking value(s) shared by more than one \`z\` layer`,
+    [
+      ...duplicates.map(([layerValue, keys]) => `${layerValue} <- ${keys.join(", ")}`),
+      "hint: two layers with the same z-index have an undefined paint order."
+    ]
+  );
+}
+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/build/index.ts
+function validateSource(tokens) {
+  assertEveryTokenHasATier(tokens);
+  assertUsageMetadata(tokens);
+  assertIconMetadata(tokens);
+  assertGroupSizes(tokens);
+}
+function countByTier(tokens) {
+  const counts = { primitive: 0, semantic: 0, component: 0 };
+  for (const token of tokens) counts[token.tier] = (counts[token.tier] ?? 0) + 1;
+  return counts;
+}
+function contrastExclusions(tokens) {
+  return exclusionsFor(tokens).map((exclusion) => ({ ...exclusion }));
+}
+function resolveTheme(theme) {
+  const tokens = tokensForTheme(theme);
+  validateSource(tokens);
+  const index = buildTokenIndex(tokens);
+  assertTierDirection(index);
+  const { values: values2 } = resolveTokens(index);
+  assertDistinctZLayers(values2);
+  return {
+    emit: {
+      theme: theme.theme,
+      selectors: theme.selectors,
+      colorScheme: theme.colorScheme,
+      values: values2
+    },
+    tokens
+  };
+}
+function buildTokens(options) {
+  const resolved = THEME_SOURCES.map(resolveTheme);
+  const canonical = resolved[0].tokens;
+  const themes = resolved.map(({ emit }) => emit);
+  const lightFallback = resolved.find(({ emit }) => emit.theme === "light")?.emit;
+  const css = emitCss(
+    canonical,
+    themes,
+    lightFallback === void 0 ? [] : [{ selectors: [":root:not([data-cdt-theme])"], colorScheme: "light", values: lightFallback.values }]
+  );
+  const json = emitTokenJson(canonical, themes);
+  const tokensModule = emitTokensModule(canonical);
+  const breakpointsModule = emitBreakpointsModule();
+  const counts = countByTier(canonical);
+  const emitted = emittableTokens(canonical);
+  const stdout = [
+    `[tokens] resolved ${canonical.length} tokens (${counts.primitive} primitive, ${counts.semantic} semantic, ${counts.component} component)`
+  ];
+  if (options.report === true) {
+    const exclusions = contrastExclusions(canonical);
+    stdout.push(`[tokens] ${exclusions.length} token(s) excluded from contrast checks (decorative)`);
+    for (const exclusion of exclusions) stdout.push(`  ${exclusion.key}`);
+    stdout.push("[tokens] --report: no files written");
+    return { stdout, written: [], css, json, tokensModule, breakpointsModule };
+  }
+  const distArtifacts = /* @__PURE__ */ new Map([
+    ["tokens.css", css],
+    ["tokens.json", json]
+  ]);
+  const written = writeArtifacts(options.outDir, distArtifacts).map((name) => `${options.outDir}/${name}`);
+  stdout.push(`[tokens] wrote ${options.outDir}/tokens.css (${emitted.length} declarations)`);
+  stdout.push(`[tokens] wrote ${options.outDir}/tokens.json`);
+  if (options.srcDir !== void 0) {
+    const sourceArtifacts = /* @__PURE__ */ new Map([
+      ["tokens.ts", tokensModule],
+      ["breakpoints.ts", breakpointsModule]
+    ]);
+    for (const name of writeArtifacts(options.srcDir, sourceArtifacts)) {
+      written.push(`${options.srcDir}/${name}`);
+    }
+    stdout.push(`[tokens] wrote ${options.srcDir}/tokens.ts, ${options.srcDir}/breakpoints.ts`);
+  }
+  return { stdout, written, css, json, tokensModule, breakpointsModule };
+}
+
+// src/build/args.ts
+var USAGE = "usage: conductor-build-tokens [--out <dir>] [--report] [--watch]";
+function parseArgs(argv) {
+  let outDir = "dist";
+  let report = false;
+  let watch2 = false;
+  for (let index = 0; index < argv.length; index += 1) {
+    const arg = argv[index];
+    switch (arg) {
+      case "--report":
+        report = true;
+        break;
+      case "--watch":
+        watch2 = true;
+        break;
+      case "--out": {
+        const next = argv[index + 1];
+        if (next === void 0 || next.startsWith("--")) {
+          throw new TokenBuildError("TOK-ARG", "`--out` needs a directory", [USAGE]);
+        }
+        outDir = next;
+        index += 1;
+        break;
+      }
+      default:
+        throw new TokenBuildError("TOK-ARG", `unrecognised argument \`${arg}\``, [USAGE]);
+    }
+  }
+  if (report && watch2) {
+    throw new TokenBuildError("TOK-ARG", "`--report` and `--watch` are mutually exclusive", [USAGE]);
+  }
+  return { outDir, report, watch: watch2 };
+}
+
+// src/cli.ts
+var PACKAGE_ROOT = resolve(dirname(fileURLToPath(import.meta.url)), "..");
+var SOURCE_DIR = join(PACKAGE_ROOT, "src");
+function runOnce(options) {
+  const started = Date.now();
+  const result = buildTokens({
+    outDir: resolve(PACKAGE_ROOT, options.outDir),
+    srcDir: options.report ? void 0 : SOURCE_DIR,
+    report: options.report
+  });
+  for (const line of result.stdout) console.log(line);
+  if (!options.report) console.log(`done in ${Date.now() - started}ms`);
+}
+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) {
+  let options;
+  try {
+    options = parseArgs(argv);
+  } catch (error) {
+    return reportFailure(error);
+  }
+  if (!options.watch) {
+    try {
+      runOnce(options);
+      return 0;
+    } catch (error) {
+      return reportFailure(error);
+    }
+  }
+  const rebuild = () => {
+    try {
+      runOnce(options);
+    } catch (error) {
+      reportFailure(error);
+    }
+  };
+  rebuild();
+  let pending;
+  watch(SOURCE_DIR, { recursive: true }, () => {
+    if (pending !== void 0) clearTimeout(pending);
+    pending = setTimeout(rebuild, 50);
+  });
+  console.log(`[tokens] watching ${SOURCE_DIR}`);
+  return 0;
+}
+process.exitCode = main(process.argv.slice(2));