@conductor-by-89soone/tokens 0.0.0 → 0.2.0

package/dist/contrast-cli.js

@@ -26,6 +26,8 @@ var EXIT_CODES = {
   "TOK-CP-USAGE": 1,
   "TOK-CP-COLOR": 1,
   "TOK-CP-ALPHA": 1,
+  "TOK-CP-FORBIDDEN": 1,
+  "TOK-THEME-KEY": 1,
   "TOK-LITERAL": 1,
   "TOK-ARG": 3
 };
@@ -270,12 +272,96 @@ var badgePairs = [
     "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."
+  ),
+  pair(
+    "CP-042",
+    "status.neutralEnd",
+    "badge.marker.background",
+    "nonText",
+    "CR-035. The second marker variant, measurable again now that the dark end state is `slate.400`. New id: CP-025 is permanently retired (tokens spec 8.2, 8.5)."
   )
 ];
 var disabledPairs = [
   pair("CP-040", "text.muted", "state.disabled", "body"),
   pair("CP-041", "button.policyDisabled.text", "state.disabledPolicy", "body")
 ];
+var datavizPairs = [
+  pair("CP-043", "dataviz.series.1", "surface.base", "nonText"),
+  pair("CP-044", "dataviz.series.1", "surface.canvas", "nonText"),
+  pair("CP-045", "dataviz.series.1", "surface.raised", "nonText"),
+  pair("CP-046", "dataviz.series.2", "surface.base", "nonText"),
+  pair("CP-047", "dataviz.series.2", "surface.canvas", "nonText"),
+  pair("CP-048", "dataviz.series.2", "surface.raised", "nonText"),
+  pair("CP-049", "dataviz.series.3", "surface.base", "nonText"),
+  pair("CP-050", "dataviz.series.3", "surface.canvas", "nonText"),
+  pair("CP-051", "dataviz.series.3", "surface.raised", "nonText"),
+  pair("CP-052", "dataviz.series.4", "surface.base", "nonText"),
+  pair("CP-053", "dataviz.series.4", "surface.canvas", "nonText"),
+  pair("CP-054", "dataviz.series.4", "surface.raised", "nonText"),
+  pair("CP-055", "dataviz.series.5", "surface.base", "nonText"),
+  pair("CP-056", "dataviz.series.5", "surface.canvas", "nonText"),
+  pair("CP-057", "dataviz.series.5", "surface.raised", "nonText"),
+  pair("CP-058", "dataviz.series.6", "surface.base", "nonText"),
+  pair("CP-059", "dataviz.series.6", "surface.canvas", "nonText"),
+  pair("CP-060", "dataviz.series.6", "surface.raised", "nonText"),
+  pair("CP-061", "dataviz.series.7", "surface.base", "nonText"),
+  pair("CP-062", "dataviz.series.7", "surface.canvas", "nonText"),
+  pair("CP-063", "dataviz.series.7", "surface.raised", "nonText"),
+  pair("CP-064", "dataviz.series.8", "surface.base", "nonText"),
+  pair("CP-065", "dataviz.series.8", "surface.canvas", "nonText"),
+  pair("CP-066", "dataviz.series.8", "surface.raised", "nonText"),
+  pair("CP-067", "dataviz.series.9", "surface.base", "nonText"),
+  pair("CP-068", "dataviz.series.9", "surface.canvas", "nonText"),
+  pair("CP-069", "dataviz.series.9", "surface.raised", "nonText"),
+  pair("CP-070", "dataviz.series.10", "surface.base", "nonText"),
+  pair("CP-071", "dataviz.series.10", "surface.canvas", "nonText"),
+  pair("CP-072", "dataviz.series.10", "surface.raised", "nonText"),
+  pair("CP-073", "dataviz.series.11", "surface.base", "nonText"),
+  pair("CP-074", "dataviz.series.11", "surface.canvas", "nonText"),
+  pair("CP-075", "dataviz.series.11", "surface.raised", "nonText"),
+  pair("CP-076", "dataviz.series.12", "surface.base", "nonText"),
+  pair("CP-077", "dataviz.series.12", "surface.canvas", "nonText"),
+  pair("CP-078", "dataviz.series.12", "surface.raised", "nonText"),
+  pair("CP-079", "dataviz.series.13", "surface.base", "nonText"),
+  pair("CP-080", "dataviz.series.13", "surface.canvas", "nonText"),
+  pair("CP-081", "dataviz.series.13", "surface.raised", "nonText"),
+  pair("CP-082", "dataviz.series.14", "surface.base", "nonText"),
+  pair("CP-083", "dataviz.series.14", "surface.canvas", "nonText"),
+  pair("CP-084", "dataviz.series.14", "surface.raised", "nonText"),
+  pair("CP-085", "dataviz.series.15", "surface.base", "nonText"),
+  pair("CP-086", "dataviz.series.15", "surface.canvas", "nonText"),
+  pair("CP-087", "dataviz.series.15", "surface.raised", "nonText"),
+  pair("CP-088", "dataviz.series.16", "surface.base", "nonText"),
+  pair("CP-089", "dataviz.series.16", "surface.canvas", "nonText"),
+  pair("CP-090", "dataviz.series.16", "surface.raised", "nonText"),
+  pair("CP-091", "dataviz.series.17", "surface.base", "nonText"),
+  pair("CP-092", "dataviz.series.17", "surface.canvas", "nonText"),
+  pair("CP-093", "dataviz.series.17", "surface.raised", "nonText"),
+  pair("CP-094", "dataviz.series.18", "surface.base", "nonText"),
+  pair("CP-095", "dataviz.series.18", "surface.canvas", "nonText"),
+  pair("CP-096", "dataviz.series.18", "surface.raised", "nonText"),
+  pair("CP-097", "dataviz.series.19", "surface.base", "nonText"),
+  pair("CP-098", "dataviz.series.19", "surface.canvas", "nonText"),
+  pair("CP-099", "dataviz.series.19", "surface.raised", "nonText"),
+  pair("CP-100", "dataviz.series.20", "surface.base", "nonText"),
+  pair("CP-101", "dataviz.series.20", "surface.canvas", "nonText"),
+  pair("CP-102", "dataviz.series.20", "surface.raised", "nonText"),
+  pair("CP-103", "dataviz.sequential.1", "surface.base", "nonText"),
+  pair("CP-104", "dataviz.sequential.1", "surface.canvas", "nonText"),
+  pair("CP-105", "dataviz.sequential.1", "surface.raised", "nonText"),
+  pair("CP-106", "dataviz.sequential.2", "surface.base", "nonText"),
+  pair("CP-107", "dataviz.sequential.2", "surface.canvas", "nonText"),
+  pair("CP-108", "dataviz.sequential.2", "surface.raised", "nonText"),
+  pair("CP-109", "dataviz.sequential.3", "surface.base", "nonText"),
+  pair("CP-110", "dataviz.sequential.3", "surface.canvas", "nonText"),
+  pair("CP-111", "dataviz.sequential.3", "surface.raised", "nonText"),
+  pair("CP-112", "dataviz.sequential.4", "surface.base", "nonText"),
+  pair("CP-113", "dataviz.sequential.4", "surface.canvas", "nonText"),
+  pair("CP-114", "dataviz.sequential.4", "surface.raised", "nonText"),
+  pair("CP-115", "dataviz.sequential.5", "surface.base", "nonText"),
+  pair("CP-116", "dataviz.sequential.5", "surface.canvas", "nonText"),
+  pair("CP-117", "dataviz.sequential.5", "surface.raised", "nonText")
+];
 var contrastPairs = [
   ...textOnSurface,
   ...accentPairs,
@@ -284,7 +370,22 @@ var contrastPairs = [
   ...meterPairs,
   ...severityPairs,
   ...badgePairs,
-  ...disabledPairs
+  ...disabledPairs,
+  ...datavizPairs
+];
+var forbiddenPairs = [
+  {
+    id: "FP-001",
+    foreground: "text.faint",
+    background: "surface.elevated",
+    reason: "`text.faint` is `decorative` and may not be painted on this surface \u2014 2.94:1 in dark, still short of body 4.5:1 in light (FR-THM-005 AC-3)"
+  },
+  {
+    id: "FP-002",
+    foreground: "accent",
+    background: "surface.elevated",
+    reason: "the accent is a body foreground on `surface.base` and `surface.raised` only; on the elevated surface it measures 4.40:1 in dark, below body 4.5:1 (tokens spec 8.4)"
+  }
 ];
 
 // src/scales.ts
@@ -347,6 +448,11 @@ var radius = [
   aliased("radius.xl", "curve.24", "Largest radius."),
   semantic("radius.pill", "9999px", "Fully rounded badge, toggle, marker and progress geometry.")
 ];
+var borderWidth = [
+  aliased("border.width.hairline", "stroke.1", "\uAE30\uBCF8 1px \uC5E3\uC9C0."),
+  aliased("border.width.emphasis", "stroke.2", "\uD45C \uD5E4\uB354 \uADDC\uCE59, \uB9C8\uCEE4 \uB9C1."),
+  aliased("border.width.rail", "stroke.3", "\uBC30\uB108 \uC0C1\uD0DC \uB808\uC77C, \uB0B4\uBE44 \uD65C\uC131 \uC778\uB514\uCF00\uC774\uD130.")
+];
 var Z_LAYERS = {
   base: 0,
   raised: 10,
@@ -389,6 +495,7 @@ var scaleTokens = [
   ...fontLineHeight,
   ...space,
   ...radius,
+  ...borderWidth,
   ...z,
   ...breakpoint,
   ...motion
@@ -472,14 +579,14 @@ var badge = [
   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.marker.dotRingWidth", ref("border.width.emphasis"), "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.headerBorderWidth", ref("border.width.emphasis"), "Header rule width."),
   component(
     "table.cellBorder",
     ref("border.default"),
@@ -591,6 +698,9 @@ var overlay = [
 ];
 var HEADING_MIN_PX = FONT_SIZE_PX.xl * 1.2;
 var HEADING_MAX_PX = FONT_SIZE_PX.xl * 1.6;
+var H2_PX = Math.round(FONT_SIZE_PX.xl * 1.3);
+var H3_PX = Math.round(FONT_SIZE_PX.xl * 1.1);
+var HEADING_LINE_HEIGHT_RATIO = 1.3;
 var page = [
   component(
     "page.headingSize",
@@ -602,6 +712,26 @@ var page = [
     value("1.16"),
     "The only unitless line height: `clamp()` makes a px value impossible here."
   ),
+  component(
+    "page.sectionHeadingSize",
+    value(`${H2_PX}px`),
+    "`h2`. `font.size.xl` \xD7 1.3."
+  ),
+  component(
+    "page.sectionHeadingLineHeight",
+    value(`${roundHalfUp(H2_PX * HEADING_LINE_HEIGHT_RATIO)}px`),
+    "Line height paired with `page.sectionHeadingSize`, at the 1.30 heading ratio."
+  ),
+  component(
+    "page.subHeadingSize",
+    value(`${H3_PX}px`),
+    "`h3`. `font.size.xl` \xD7 1.1."
+  ),
+  component(
+    "page.subHeadingLineHeight",
+    value(`${roundHalfUp(H3_PX * HEADING_LINE_HEIGHT_RATIO)}px`),
+    "Line height paired with `page.subHeadingSize`, at the 1.30 heading ratio."
+  ),
   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."),
@@ -614,12 +744,21 @@ var page = [
   component("page.skipLinkZ", ref("z.popover"), "Skip link stacking layer.")
 ];
 var shell = [
+  component(
+    "appShell.background",
+    value("radial-gradient(circle at 82% -10%, {surface.tint.1}, transparent 34rem), radial-gradient(circle at 10% 85%, {surface.tint.2}, transparent 30rem), {surface.base}"),
+    "Ambient app-shell surface derived from the source application background."
+  ),
   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.background",
+    value("linear-gradient(180deg, {surface.glass}, {surface.canvas})"),
+    "Glass navigation surface over the app-shell ambient background."
+  ),
   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."),
@@ -717,6 +856,18 @@ var surface = [
     usage: "decorative",
     value: "rgba(255, 255, 255, 0.05)",
     description: "Progress and meter track, matching the source 1:1."
+  }),
+  darkToken({
+    key: "surface.tint.1",
+    usage: "decorative",
+    value: "rgba(109, 124, 255, 0.11)",
+    description: "Primary ambient glow from the source application background. Decorative only."
+  }),
+  darkToken({
+    key: "surface.tint.2",
+    usage: "decorative",
+    value: "rgba(20, 184, 166, 0.055)",
+    description: "Secondary ambient glow from the source application background. Decorative only."
   })
 ];
 var text = [
@@ -860,10 +1011,10 @@ var status = [
   }),
   darkToken({
     key: "status.neutralEnd",
-    usage: "decorative",
-    value: "#475569",
+    usage: "nonText",
+    value: "#94a3b8",
     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."
+    description: "Cancelled or superseded. `slate.400` at 6.61:1 on `surface.raised` (CP-042). The marker is drawn as a ring rather than a fill, so it stays distinguishable from queued's filled dot by shape as well as colour. CR-035 retires the CR-006 contrast exemption at this value: the old `#475569` measured 2.04:1 to 2.60:1 and could only be classified `decorative`, which meant the end-state dot read faintly against every dark surface."
   })
 ];
 var meter = [
@@ -982,6 +1133,158 @@ var interaction = [
     description: "Policy-blocked fill. Contrast-exempt as a fill; checked beneath the label (5.27:1)."
   })
 ];
+var dataviz = [
+  darkToken({
+    key: "dataviz.series.1",
+    usage: "nonText",
+    value: "#e88171",
+    description: "Categorical chart series 1 of 20. Fill only; non-text 3:1 on chart surfaces (CP-043~CP-045). Series identity only; carries no magnitude."
+  }),
+  darkToken({
+    key: "dataviz.series.2",
+    usage: "nonText",
+    value: "#1db198",
+    description: "Categorical chart series 2 of 20. Fill only; non-text 3:1 on chart surfaces (CP-046~CP-048). Series identity only; carries no magnitude."
+  }),
+  darkToken({
+    key: "dataviz.series.3",
+    usage: "nonText",
+    value: "#e979ad",
+    description: "Categorical chart series 3 of 20. Fill only; non-text 3:1 on chart surfaces (CP-049~CP-051). Series identity only; carries no magnitude."
+  }),
+  darkToken({
+    key: "dataviz.series.4",
+    usage: "nonText",
+    value: "#1eb641",
+    description: "Categorical chart series 4 of 20. Fill only; non-text 3:1 on chart surfaces (CP-052~CP-054). Series identity only; carries no magnitude."
+  }),
+  darkToken({
+    key: "dataviz.series.5",
+    usage: "nonText",
+    value: "#e073e8",
+    description: "Categorical chart series 5 of 20. Fill only; non-text 3:1 on chart surfaces (CP-055~CP-057). Series identity only; carries no magnitude."
+  }),
+  darkToken({
+    key: "dataviz.series.6",
+    usage: "nonText",
+    value: "#54b21d",
+    description: "Categorical chart series 6 of 20. Fill only; non-text 3:1 on chart surfaces (CP-058~CP-060). Series identity only; carries no magnitude."
+  }),
+  darkToken({
+    key: "dataviz.series.7",
+    usage: "nonText",
+    value: "#ad8dec",
+    description: "Categorical chart series 7 of 20. Fill only; non-text 3:1 on chart surfaces (CP-061~CP-063). Series identity only; carries no magnitude."
+  }),
+  darkToken({
+    key: "dataviz.series.8",
+    usage: "nonText",
+    value: "#9fa41b",
+    description: "Categorical chart series 8 of 20. Fill only; non-text 3:1 on chart surfaces (CP-064~CP-066). Series identity only; carries no magnitude."
+  }),
+  darkToken({
+    key: "dataviz.series.9",
+    usage: "nonText",
+    value: "#7f9bea",
+    description: "Categorical chart series 9 of 20. Fill only; non-text 3:1 on chart surfaces (CP-067~CP-069). Series identity only; carries no magnitude."
+  }),
+  darkToken({
+    key: "dataviz.series.10",
+    usage: "nonText",
+    value: "#e18844",
+    description: "Categorical chart series 10 of 20. Fill only; non-text 3:1 on chart surfaces (CP-070~CP-072). Series identity only; carries no magnitude."
+  }),
+  darkToken({
+    key: "dataviz.series.11",
+    usage: "nonText",
+    value: "#20adc2",
+    description: "Categorical chart series 11 of 20. Fill only; non-text 3:1 on chart surfaces (CP-073~CP-075). Series identity only; carries no magnitude."
+  }),
+  darkToken({
+    key: "dataviz.series.12",
+    usage: "nonText",
+    value: "#ea7d8f",
+    description: "Categorical chart series 12 of 20. Fill only; non-text 3:1 on chart surfaces (CP-076~CP-078). Series identity only; carries no magnitude."
+  }),
+  darkToken({
+    key: "dataviz.series.13",
+    usage: "nonText",
+    value: "#1db46e",
+    description: "Categorical chart series 13 of 20. Fill only; non-text 3:1 on chart surfaces (CP-079~CP-081). Series identity only; carries no magnitude."
+  }),
+  darkToken({
+    key: "dataviz.series.14",
+    usage: "nonText",
+    value: "#e874cd",
+    description: "Categorical chart series 14 of 20. Fill only; non-text 3:1 on chart surfaces (CP-082~CP-084). Series identity only; carries no magnitude."
+  }),
+  darkToken({
+    key: "dataviz.series.15",
+    usage: "nonText",
+    value: "#28b61e",
+    description: "Categorical chart series 15 of 20. Fill only; non-text 3:1 on chart surfaces (CP-085~CP-087). Series identity only; carries no magnitude."
+  }),
+  darkToken({
+    key: "dataviz.series.16",
+    usage: "nonText",
+    value: "#c583eb",
+    description: "Categorical chart series 16 of 20. Fill only; non-text 3:1 on chart surfaces (CP-088~CP-090). Series identity only; carries no magnitude."
+  }),
+  darkToken({
+    key: "dataviz.series.17",
+    usage: "nonText",
+    value: "#7cac1c",
+    description: "Categorical chart series 17 of 20. Fill only; non-text 3:1 on chart surfaces (CP-091~CP-093). Series identity only; carries no magnitude."
+  }),
+  darkToken({
+    key: "dataviz.series.18",
+    usage: "nonText",
+    value: "#9794ee",
+    description: "Categorical chart series 18 of 20. Fill only; non-text 3:1 on chart surfaces (CP-094~CP-096). Series identity only; carries no magnitude."
+  }),
+  darkToken({
+    key: "dataviz.series.19",
+    usage: "nonText",
+    value: "#c39720",
+    description: "Categorical chart series 19 of 20. Fill only; non-text 3:1 on chart surfaces (CP-097~CP-099). Series identity only; carries no magnitude."
+  }),
+  darkToken({
+    key: "dataviz.series.20",
+    usage: "nonText",
+    value: "#52a4e3",
+    description: "Categorical chart series 20 of 20. Fill only; non-text 3:1 on chart surfaces (CP-100~CP-102). Series identity only; carries no magnitude."
+  }),
+  darkToken({
+    key: "dataviz.sequential.1",
+    usage: "nonText",
+    value: "#6960d1",
+    description: "Sequential distribution step 1 of 5 (least prominent), single-hue luminance ramp. Fill only; non-text 3:1 on chart surfaces (CP-103~CP-105)."
+  }),
+  darkToken({
+    key: "dataviz.sequential.2",
+    usage: "nonText",
+    value: "#847dd9",
+    description: "Sequential distribution step 2 of 5 (step), single-hue luminance ramp. Fill only; non-text 3:1 on chart surfaces (CP-106~CP-108)."
+  }),
+  darkToken({
+    key: "dataviz.sequential.3",
+    usage: "nonText",
+    value: "#9e98e1",
+    description: "Sequential distribution step 3 of 5 (step), single-hue luminance ramp. Fill only; non-text 3:1 on chart surfaces (CP-109~CP-111)."
+  }),
+  darkToken({
+    key: "dataviz.sequential.4",
+    usage: "nonText",
+    value: "#b7b3e9",
+    description: "Sequential distribution step 4 of 5 (step), single-hue luminance ramp. Fill only; non-text 3:1 on chart surfaces (CP-112~CP-114)."
+  }),
+  darkToken({
+    key: "dataviz.sequential.5",
+    usage: "nonText",
+    value: "#cecbf0",
+    description: "Sequential distribution step 5 of 5 (most prominent), single-hue luminance ramp. Fill only; non-text 3:1 on chart surfaces (CP-115~CP-117)."
+  })
+];
 var darkPalette = [
   ...surface,
   ...text,
@@ -992,7 +1295,8 @@ var darkPalette = [
   ...severity,
   ...fontFamily,
   ...elevation,
-  ...interaction
+  ...interaction,
+  ...dataviz
 ];
 
 // src/palette.light.ts
@@ -1006,6 +1310,8 @@ var values = {
   "surface.glass": "rgba(251, 252, 253, 0.86)",
   "surface.timeline": "#f1f4f8",
   "surface.track": "rgba(12, 18, 28, 0.08)",
+  "surface.tint.1": "rgba(79, 91, 213, 0.1)",
+  "surface.tint.2": "rgba(4, 120, 87, 0.05)",
   "text.primary": "#0c121c",
   "text.secondary": "#33415a",
   "text.muted": "#4d5a6e",
@@ -1036,12 +1342,58 @@ var values = {
   "state.hover": "rgba(12, 18, 28, 0.05)",
   "state.selected": "rgba(79, 91, 213, 0.12)",
   "state.disabled": "#e2e8f0",
-  "state.disabledPolicy": "#fef3c7"
+  "state.disabledPolicy": "#fef3c7",
+  // dataviz — chart series colours, darkened for light surfaces (CR-036).
+  "dataviz.series.1": "#d45946",
+  "dataviz.series.2": "#228f7d",
+  "dataviz.series.3": "#d54e8d",
+  "dataviz.series.4": "#22933d",
+  "dataviz.series.5": "#ca45d3",
+  "dataviz.series.6": "#4a9022",
+  "dataviz.series.7": "#906adc",
+  "dataviz.series.8": "#81851f",
+  "dataviz.series.9": "#5a7cd8",
+  "dataviz.series.10": "#bd6b2c",
+  "dataviz.series.11": "#258c9c",
+  "dataviz.series.12": "#d75369",
+  "dataviz.series.13": "#22915d",
+  "dataviz.series.14": "#d446b2",
+  "dataviz.series.15": "#2a9322",
+  "dataviz.series.16": "#ab5dd9",
+  "dataviz.series.17": "#688b21",
+  "dataviz.series.18": "#7773de",
+  "dataviz.series.19": "#9b7c24",
+  "dataviz.series.20": "#2f85c7",
+  "dataviz.sequential.1": "#7d74dc",
+  "dataviz.sequential.2": "#6e65d8",
+  "dataviz.sequential.3": "#5c52d4",
+  "dataviz.sequential.4": "#4539cd",
+  "dataviz.sequential.5": "#3329a4"
 };
-var lightPalette = darkPalette.map((token) => {
-  const value2 = values[token.key];
-  return value2 === void 0 ? token : { ...token, value: value2, alias: void 0 };
-});
+var lightAdditions = [];
+function derivePalette(base, overrides, additions = []) {
+  const baseKeys = new Set(base.map((token) => token.key));
+  const unmatched = Object.keys(overrides).filter((key) => !baseKeys.has(key));
+  if (unmatched.length > 0) {
+    throw new TokenBuildError("TOK-THEME-KEY", "theme override names a key the base palette does not declare", [
+      ...unmatched.map((key) => `override: ${key}`),
+      "hint: the override would be dropped and the token would keep its dark value, which the key-set contract check cannot see. Fix the spelling, or declare the key in the base palette."
+    ]);
+  }
+  const notExempt = additions.filter((token) => token.themeSpecific !== true);
+  if (notExempt.length > 0) {
+    throw new TokenBuildError("TOK-THEME-KEY", "theme-only token is not marked `themeSpecific`", [
+      ...notExempt.map((token) => `addition: ${token.key}`),
+      "hint: FR-QA-001 exempts a key from the cross-theme contract only when the token declares `themeSpecific: true`, so the exemption stays visible in the report."
+    ]);
+  }
+  const derived = base.map((token) => {
+    const value2 = overrides[token.key];
+    return value2 === void 0 ? token : { ...token, value: value2, alias: void 0 };
+  });
+  return [...derived, ...additions];
+}
+var lightPalette = derivePalette(darkPalette, values, lightAdditions);
 
 // src/primitives.ts
 function primitive(key, value2, description) {
@@ -1085,9 +1437,17 @@ var indigo = [
   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.400",
+    "#94a3b8",
+    "Base colour of all four dark border tokens and the scrollbar; dark `status.neutralEnd` (CR-035)."
+  ),
   primitive("slate.500", "#64748b", "Dark `status.queued`; light `border.control`."),
-  primitive("slate.600", "#475569", "Dark `status.neutralEnd`."),
+  primitive(
+    "slate.600",
+    "#475569",
+    "The source's `--status-neutral-end`. No consumer since CR-035 raised the dark end-state to `slate.400`; kept as the record of the source value that decision replaced."
+  ),
   primitive("slate.700", "#3f4b5f", "Light `status.neutralEnd`."),
   primitive("slate.750", "#52607a", "Light `status.queued`.")
 ];
@@ -1131,6 +1491,9 @@ var nonColour = [
   primitive("scale.32", "32px", "Spacing step."),
   primitive("scale.40", "40px", "Spacing step."),
   primitive("scale.48", "48px", "Spacing step."),
+  primitive("stroke.1", "1px", "Hairline width."),
+  primitive("stroke.2", "2px", "Emphasis rule width."),
+  primitive("stroke.3", "3px", "Status rail and active indicator width."),
   primitive("curve.6", "6px", "Corner radius step."),
   primitive("curve.9", "9px", "Corner radius step."),
   primitive("curve.12", "12px", "Corner radius step."),
@@ -1391,22 +1754,70 @@ function measure(pair2, theme, index, values2) {
     pass: ratio >= threshold
   };
 }
+function aliasTerminus(index, reference) {
+  let key = resolveReferenceTarget(index, reference);
+  const seen = /* @__PURE__ */ new Set();
+  while (key !== void 0 && !seen.has(key)) {
+    seen.add(key);
+    const alias = index.get(key)?.alias;
+    if (alias === void 0) return key;
+    key = resolveReferenceTarget(index, alias);
+  }
+  return key;
+}
+function assertNotForbidden(pair2, index, forbidden) {
+  const resolvedForeground = aliasTerminus(index, pair2.foreground);
+  const resolvedBackground = aliasTerminus(index, pair2.background);
+  for (const banned of forbidden) {
+    const bannedForeground = aliasTerminus(index, banned.foreground);
+    const bannedBackground = aliasTerminus(index, banned.background);
+    if (resolvedForeground !== bannedForeground || resolvedBackground !== bannedBackground) continue;
+    throw new TokenBuildError("TOK-CP-FORBIDDEN", "contrast pair declares a forbidden combination", [
+      `pair: ${pair2.id} (${pair2.foreground} on ${pair2.background})`,
+      `forbidden: ${banned.id} (${banned.foreground} on ${banned.background})`,
+      `reason: ${banned.reason}`,
+      "hint: the pair resolves to a combination that must not render. Lifting the ban needs a CR."
+    ]);
+  }
+}
+function measureForbidden(forbidden, theme, index, values2) {
+  return forbidden.map((banned) => {
+    const asPair = { ...banned, usage: "nonText", themes: [theme] };
+    const foreground = lookup(index, asPair, "foreground");
+    const background = lookup(index, asPair, "background");
+    const backgroundColor = colorOf(asPair, background, values2.get(background.key), "background");
+    const foregroundColor = colorOf(asPair, foreground, values2.get(foreground.key), "foreground");
+    const ratio = contrastRatio(compositeOver(foregroundColor, backgroundColor), backgroundColor);
+    return {
+      id: banned.id,
+      theme,
+      foreground: banned.foreground,
+      background: banned.background,
+      ratio: Number(ratio.toFixed(4)),
+      reason: banned.reason
+    };
+  });
+}
 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;
+  const forbidden = options.forbidden ?? forbiddenPairs;
   assertUniqueIds(pairs);
   const results = [];
   const exclusions = /* @__PURE__ */ new Map();
+  const forbiddenResults = [];
   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);
+    forbiddenResults.push(...measureForbidden(forbidden, theme.theme, index, values2));
     for (const pair2 of pairs) {
       if (!pair2.themes.includes(theme.theme)) continue;
+      assertNotForbidden(pair2, index, forbidden);
       results.push(measure(pair2, theme.theme, index, values2));
     }
   }
@@ -1416,12 +1827,14 @@ function checkContrast(options = {}) {
     thresholds: CONTRAST_THRESHOLDS,
     results,
     exclusions: [...exclusions.values()],
+    forbidden: forbiddenResults,
     summary: {
       declaredPairs: pairs.length,
       checks: results.length,
       passed: results.length - failed,
       failed,
-      excludedTokens: exclusions.size
+      excludedTokens: exclusions.size,
+      forbiddenPairs: forbidden.length
     }
   };
 }
@@ -1455,6 +1868,11 @@ function formatExclusions(report) {
     lines.push(`  ${exclusion.key}`);
     lines.push(`    reason: ${exclusion.reason}`);
   }
+  lines.push(`[contrast] ${report.summary.forbiddenPairs} combination(s) declared forbidden`);
+  for (const banned of report.forbidden) {
+    lines.push(`  ${banned.id} ${banned.foreground} on ${banned.background} (theme=${banned.theme}, ${formatRatio(banned.ratio)}:1)`);
+    lines.push(`    reason: ${banned.reason}`);
+  }
   lines.push("[contrast] --report: no files written");
   return lines;
 }
@@ -1466,7 +1884,8 @@ function renderReportJson(report) {
       thresholds: report.thresholds,
       summary: report.summary,
       results: report.results,
-      exclusions: report.exclusions
+      exclusions: report.exclusions,
+      forbidden: report.forbidden
     },
     null,
     2