@rojaostudio/ds-core 1.1.0-next.6 → 1.1.0-next.8

package/dist/{chunk-UD53AUQQ.js → chunk-6XIFYDSU.js}

@@ -705,6 +705,27 @@ function ramp(c, custom) {
   return { base: hex, scale: buildScale(hex) };
 }
 var on = (bg) => onColor(bg);
+var AA = 4.5;
+var NON_TEXT = 3;
+var readsOn = (fg, bgs, min = AA) => bgs.every((bg) => contrastRatio(fg, bg) >= min);
+function readableFrom(base, scale, bgs, toward, fallback, min = AA) {
+  var _a;
+  if (readsOn(base, bgs, min)) return base;
+  const lb = relativeLuminance(base);
+  const steps = SCALE_STEPS.map((s2) => scale[s2]).filter((c) => !!c && isHex(c)).filter((c) => toward === "darker" ? relativeLuminance(c) < lb : relativeLuminance(c) > lb).sort((a, b) => Math.abs(relativeLuminance(a) - lb) - Math.abs(relativeLuminance(b) - lb));
+  const step2 = steps.find((c) => readsOn(c, bgs, min));
+  if (step2) return step2;
+  const [h, s, l0] = hexToHsl((_a = steps[steps.length - 1]) != null ? _a : base);
+  for (let l = l0; toward === "darker" ? l >= 0 : l <= 100; l += toward === "darker" ? -2 : 2) {
+    const c = hslToHex(h, s, l);
+    if (readsOn(c, bgs, min)) return c;
+  }
+  return fallback;
+}
+var defaultWarn = (m) => {
+  var _a;
+  return (_a = globalThis.console) == null ? void 0 : _a.warn(m);
+};
 var ROLES = [
   ["colors/primary/light", "d", "b"],
   ["colors/primary/default", "d", "b"],
@@ -808,12 +829,16 @@ var ROLES = [
   ["colors/state/info-strong", "d", "d"],
   ["colors/state/neutral-strong", "d", "d"],
   ["text/on/primary-subtle", "d", "b"],
-  ["surface/tint/subtle", "d", "b"]
+  ["surface/tint/subtle", "d", "b"],
+  ["border/error", "d", "d"]
 ];
+var awayFrom = (bg) => contrastRatio(bg, BLACK) >= contrastRatio(bg, WHITE) ? "darker" : "lighter";
 var TINT_DEFAULT = 200;
 var lighterStep = (s) => s - 100 ;
 var roleVar = (role) => `--${role.replaceAll("/", "-")}`;
-function generateRdsTheme(def) {
+function generateRdsTheme(def, opts = {}) {
+  var _a, _b;
+  const warn = (_a = opts.warn) != null ? _a : defaultWarn;
   const b = def.brand;
   const own = def.palettes;
   const P = ramp(b.primary, own);
@@ -823,7 +848,15 @@ function generateRdsTheme(def) {
   const L = palette("blue");
   const red = palette("red"), green = palette("green"), orange = palette("orange");
   const teal = palette("teal"), purple = palette("purple");
-  const heading = b.heading ? ramp(b.heading, own).base : P.base;
+  const lightBgs = [WHITE, N[100]];
+  let heading;
+  if (b.heading) {
+    heading = ramp(b.heading, own).base;
+    if (!readsOn(heading, lightBgs)) {
+      const worst = Math.min(...lightBgs.map((bg) => contrastRatio(heading, bg)));
+      warn(`generateRdsTheme(${def.name}): heading ${heading} is ${worst.toFixed(2)}:1 on surface/card or surface/page (AA asks 4.5:1). Kept as given.`);
+    }
+  } else heading = readableFrom(P.base, P.scale, lightBgs, "darker", BLACK);
   const invert = b.invert ? ramp(b.invert, own).base : WHITE;
   const l = {
     "colors/primary/light": P.scale[500],
@@ -860,13 +893,12 @@ function generateRdsTheme(def) {
     "border/strong-hover": N[600],
     "surface/tint/default": A.scale[TINT_DEFAULT],
     "surface/tint/strong": A.scale[300],
-    "text/on/tint": BLACK,
     // Light selection fill (pressed Toggle, choice tile): one step lighter than the default tint
     // (200 → 100, 100 → 50).
     "surface/tint/subtle": A.scale[lighterStep(TINT_DEFAULT)],
     "surface/action/default": L[100],
     "surface/action/strong": L[200],
-    "text/on/action-tonal": P.scale[700],
+    "text/on/action-tonal": readableFrom(P.scale[700], P.scale, [L[100]], "darker", BLACK),
     "surface/lift/action": P.scale[50],
     "surface/lift/action-strong": L[100],
     "surface/band/action": L[100],
@@ -901,8 +933,7 @@ function generateRdsTheme(def) {
     "text/warning": orange[700],
     "surface/neutral": N[100],
     "text/neutral": N[800],
-    "chart/series/1": P.scale[600],
-    "chart/series/2": orange[500],
+    "chart/series/2": orange[600],
     "chart/series/3": teal[500],
     "chart/series/4": purple[500],
     "chart/series/5": green[500],
@@ -927,8 +958,11 @@ function generateRdsTheme(def) {
     ["colors/state/neutral", "text/on/neutral"],
     ["surface/cover", "text/on/cover"],
     ["surface/lift/action", "text/on/lift-action"],
-    ["colors/primary/dark", "text/on/primary-strong"]
+    ["colors/primary/dark", "text/on/primary-strong"],
+    ["surface/tint/default", "text/on/tint"]
   ]) l[text] = on(l[fill]);
+  l["border/error"] = readableFrom(l["colors/state/error"], red, [l["surface/card"]], awayFrom(l["surface/card"]), BLACK, NON_TEXT);
+  l["chart/series/1"] = readableFrom(P.scale[600], P.scale, [l["surface/card"]], awayFrom(l["surface/card"]), BLACK, NON_TEXT);
   l["logo/primary"] = l["colors/primary/default"];
   l["logo/signature"] = l["colors/primary/default"];
   l["logo/accent"] = l["colors/accent/logo"];
@@ -945,7 +979,7 @@ function generateRdsTheme(def) {
     "border/default": N[800],
     "border/strong": N[500],
     "border/strong-hover": N[400],
-    "text/heading": N[50],
+    "text/heading": readableFrom(N[50], N, [N[900]], "lighter", WHITE),
     "text/body": N[100],
     "text/muted": N[300],
     "text/subtle": N[400],
@@ -972,15 +1006,13 @@ function generateRdsTheme(def) {
     "colors/accent/mark": A.scale[300],
     "surface/tint/default": A.scale[900],
     "surface/tint/strong": A.scale[800],
-    "text/on/tint": WHITE,
     // No step below 900 in dark: subtle is the default tint.
     "surface/tint/subtle": A.scale[900],
     "surface/action/default": L[900],
     "surface/action/strong": L[800],
-    "text/on/action-tonal": P.scale[200],
+    "text/on/action-tonal": readableFrom(P.scale[200], P.scale, [L[900]], "lighter", WHITE),
     "surface/lift/action": P.scale[800],
     "surface/lift/action-strong": P.scale[700],
-    "text/on/lift-action": WHITE,
     "colors/state/error-strong": red[400],
     "colors/state/success-strong": green[300],
     "colors/state/warning-strong": orange[400],
@@ -995,7 +1027,6 @@ function generateRdsTheme(def) {
     "text/warning": orange[300],
     "surface/neutral": N[800],
     "text/neutral": N[200],
-    "chart/series/1": P.scale[400],
     "chart/series/2": orange[400],
     "chart/series/3": teal[400],
     "chart/series/4": purple[400],
@@ -1014,12 +1045,20 @@ function generateRdsTheme(def) {
     ["colors/secondary/default", "text/on/secondary"],
     ["colors/accent/default", "text/on/accent"],
     ["colors/accent/mark", "text/on/accent-mark"],
-    ["colors/primary/dark", "text/on/primary-strong"]
+    ["colors/primary/dark", "text/on/primary-strong"],
+    ["surface/tint/default", "text/on/tint"],
+    ["surface/lift/action", "text/on/lift-action"]
   ]) d[text] = on(d[fill]);
+  d["border/error"] = readableFrom(d["colors/state/error-strong"], red, [d["surface/card"]], awayFrom(d["surface/card"]), WHITE, NON_TEXT);
+  d["chart/series/1"] = readableFrom(P.scale[400], P.scale, [d["surface/card"]], awayFrom(d["surface/card"]), WHITE, NON_TEXT);
   const plate = l["colors/primary/default"];
   const ink = on(plate);
   const inkA = ink === WHITE ? white : black;
   const antiInk = ink === WHITE ? black : white;
+  const lp = relativeLuminance(plate);
+  const isPlate = (c) => c.toLowerCase() === plate.toLowerCase();
+  const plateCard = P.scale[800] && !isPlate(P.scale[800]) && contrastRatio(ink, P.scale[800]) >= AA ? P.scale[800] : (_b = SCALE_STEPS.map((st) => P.scale[st]).filter((c) => !!c && isHex(c) && !isPlate(c)).sort((a, b2) => Math.abs(relativeLuminance(a) - lp) - Math.abs(relativeLuminance(b2) - lp)).find((c) => contrastRatio(ink, c) >= AA)) != null ? _b : plate;
+  const onPrimaryStrong = contrastRatio(plate, P.scale[100]) >= AA ? plate : on(P.scale[100]);
   const br = {
     "colors/primary/light": P.scale[300],
     "colors/primary/default": ink,
@@ -1033,7 +1072,7 @@ function generateRdsTheme(def) {
     "text/body": ink,
     "text/link": contrastRatio(l["colors/accent/invert"], plate) >= 4.5 ? l["colors/accent/invert"] : ink,
     "surface/page": plate,
-    "surface/card": l["colors/primary/light"],
+    "surface/card": plateCard,
     "surface/panel": plate,
     "border/default": inkA(20),
     "surface/tint/default": inkA(10),
@@ -1055,7 +1094,7 @@ function generateRdsTheme(def) {
     "surface/lift/action": inkA(10),
     "text/on/lift-action": ink,
     "surface/lift/action-strong": inkA(20),
-    "text/on/primary-strong": plate,
+    "text/on/primary-strong": onPrimaryStrong,
     "text/subtle": inkA(60),
     "surface/muted": inkA(10),
     "surface/muted-strong": inkA(20),
@@ -1063,11 +1102,12 @@ function generateRdsTheme(def) {
     "border/strong-hover": inkA(80),
     "text/on/primary-subtle": inkA(30)
   };
+  const brandError = readableFrom(red[300], red, [plateCard], awayFrom(plateCard), ink, NON_TEXT);
   const out = { light: {}, dark: {}, brand: {} };
   const pick = (src, role) => {
-    var _a;
+    var _a2;
     const table = src === "l" ? l : src === "d" ? d : br;
-    const v = (_a = table[role]) != null ? _a : l[role];
+    const v = (_a2 = table[role]) != null ? _a2 : l[role];
     if (v === void 0) throw new Error(`rdsTheme: no value for "${role}"`);
     return v;
   };
@@ -1076,25 +1116,58 @@ function generateRdsTheme(def) {
     out.dark[roleVar(role)] = pick(darkSrc, role);
     out.brand[roleVar(role)] = pick(brandSrc, role);
   }
+  out.brand[roleVar("border/error")] = brandError;
   return out;
 }
+var RDS_SCOPE_SELECTORS = [
+  ":root",
+  ".ds-scope",
+  "[data-rds-scope]",
+  ".dark",
+  "[data-rds-mode]",
+  ".ds-plate",
+  "[data-rds-plate]"
+];
+var RDS_TOKEN_SCOPE = RDS_SCOPE_SELECTORS.join(", ");
+var split = (list) => list.split(",").map((s) => s.trim()).filter(Boolean);
+var rootAnchored = (sel) => /^(:root|html)(?![\w-])/i.test(sel);
+var subject = (sel) => {
+  var _a;
+  return (_a = sel.trim().split(/\s*[>+~]\s*|\s+/).pop()) != null ? _a : sel;
+};
+var COVERING = /\.(ds-scope|dark|ds-plate)(?![\w-])|\[\s*data-rds-(scope|mode|plate)\s*([~|^$*]?=[^\]]*)?\]/;
+var covered = (sel) => {
+  const s = subject(sel);
+  return /^(:root|html)(?![\w-])/i.test(s) || COVERING.test(s);
+};
 function emitRdsCss(theme, opts = {}) {
   var _a, _b, _c;
-  const scope = (_a = opts.scope) != null ? _a : ":root, .ds-scope";
-  const dark = (_b = opts.dark) != null ? _b : ".dark";
-  const plate = (_c = opts.plate) != null ? _c : ".ds-plate";
-  const block2 = (sel, map, only) => {
+  const scopes = split((_a = opts.scope) != null ? _a : ":root, .ds-scope, [data-rds-scope]");
+  const darks = split((_b = opts.dark) != null ? _b : '.dark, [data-rds-mode="dark"]');
+  const plates = split((_c = opts.plate) != null ? _c : ".ds-plate, [data-rds-plate]");
+  const block2 = (sels, map, only) => {
     const lines = Object.entries(map).filter(([k, v]) => !only || only[k] !== v).map(([k, v]) => `  ${k}: ${k === "--type-font-mono" ? `"${v}", monospace` : v};`);
-    return `${sel} {
+    return `${sels.join(", ")} {
 ${lines.join("\n")}
 }`;
   };
-  const scopes = scope.split(",").map((s) => s.trim());
-  const darkSel = scopes.map((s) => s === ":root" ? `:root${dark}, ${dark}` : `${s}${dark}, ${dark} ${s}`).join(", ");
+  const darkSels = scopes.flatMap(
+    (s) => darks.flatMap((d) => {
+      if (rootAnchored(d)) return s === ":root" ? [d] : [`${d} ${s}`];
+      return s === ":root" ? [`:root${d}`, d] : [`${s}${d}`, `${d} ${s}`];
+    })
+  );
+  if (!opts.allowUncovered) {
+    const bad = [...new Set([...scopes, ...darkSels, ...plates].filter((sel) => !covered(sel)))];
+    if (bad.length)
+      throw new Error(
+        `emitRdsCss: ${bad.map((b) => `"${b}"`).join(", ")} ${bad.length > 1 ? "are" : "is"} not covered by the component tokens of @rojaostudio/ds, redeclared only on ${RDS_TOKEN_SCOPE}. The components inside would keep the colours resolved at :root. Anchor the selector at the root (':root[data-theme="dark"]', as next-themes sets it on <html>), or add the attribute the tokens cover: data-rds-scope on a scope ('.my-scope[data-rds-scope]'), data-rds-mode on a dark element ('[data-rds-mode="dark"]'), data-rds-plate on a plate. Pass allowUncovered: true only for a theme without the components.`
+      );
+  }
   return [
-    block2(scope, __spreadValues(__spreadValues({}, theme.light), theme.vars)),
-    block2(darkSel, theme.dark, theme.light),
-    block2(plate, theme.brand, theme.light)
+    block2(scopes, __spreadValues(__spreadValues({}, theme.light), theme.vars)),
+    block2(darkSels, theme.dark, theme.light),
+    block2(plates, theme.brand, theme.light)
   ].join("\n\n") + "\n";
 }
 function rdsContrast(theme, mode, fg, bg) {
@@ -1102,11 +1175,48 @@ function rdsContrast(theme, mode, fg, bg) {
   if (!/^#[0-9a-f]{6}$/i.test(a) || !/^#[0-9a-f]{6}$/i.test(c)) return null;
   return contrastRatio(a, c);
 }
+var RDS_CONTRAST_PAIRS = [
+  ["text/heading", "surface/page"],
+  ["text/heading", "surface/card"],
+  ["text/body", "surface/page"],
+  ["text/body", "surface/card"],
+  ["text/muted", "surface/card"],
+  ["text/link", "surface/card"],
+  ["text/on/primary", "colors/primary/default"],
+  ["text/on/secondary", "colors/secondary/default"],
+  ["text/on/accent", "colors/accent/default"],
+  ["text/on/accent-mark", "colors/accent/mark"],
+  ["text/on/tint", "surface/tint/default"],
+  ["text/on/action-tonal", "surface/action/default"],
+  ["text/on/lift-action", "surface/lift/action"],
+  ["text/on/primary-strong", "colors/primary/dark"],
+  ["text/on/cover", "surface/cover"],
+  ["text/on/error", "colors/state/error"],
+  ["text/on/success", "colors/state/success"],
+  ["text/on/info", "colors/state/info"],
+  ["text/on/warning", "colors/state/warning"],
+  ["text/on/neutral", "colors/state/neutral"],
+  ["text/error", "surface/error"]
+];
+function rdsContrastReport(theme) {
+  const out = [];
+  for (const mode of ["light", "dark", "brand"])
+    for (const [fg, bg] of RDS_CONTRAST_PAIRS) {
+      const ratio = rdsContrast(theme, mode, fg, bg);
+      if (ratio !== null && ratio < AA) out.push({ mode, fg, bg, ratio: Math.round(ratio * 100) / 100 });
+    }
+  return out;
+}
 var isColourRef = (v) => /^[a-z][a-z0-9-]*\/[a-z]?\d+$/i.test(v);
-function rdsThemeFromTable(table) {
-  var _a;
+var ADDED_ROLES = {
+  // Figma: light → base colors/state/error, dark → base dark/colors/state/error-strong, brand → base dark/text/error.
+  "border/error": { light: "colors/state/error", dark: "colors/state/error-strong", brand: "text/error" }
+};
+function rdsThemeFromTable(table, opts = {}) {
+  var _a, _b, _c;
   const out = { light: {}, dark: {}, brand: {} };
   const problems = [];
+  const derived = /* @__PURE__ */ new Set();
   for (const mode of ["light", "dark", "brand"]) {
     const roles = (_a = table.modes) == null ? void 0 : _a[mode];
     if (!roles) {
@@ -1114,7 +1224,12 @@ function rdsThemeFromTable(table) {
       continue;
     }
     for (const [role] of ROLES) {
-      const ref2 = roles[role];
+      let ref2 = roles[role];
+      const added = (_b = ADDED_ROLES[role]) == null ? void 0 : _b[mode];
+      if (ref2 === void 0 && added && roles[added] !== void 0) {
+        ref2 = roles[added];
+        derived.add(role);
+      }
       if (ref2 === void 0) problems.push(`${mode}: role "${role}" is missing`);
       else if (isColourRef(ref2)) {
         const value = table.primitives[ref2];
@@ -1138,6 +1253,17 @@ function rdsThemeFromTable(table) {
   }
   if (problems.length) throw new Error(`rdsThemeFromTable(${table.name}):
   ${problems.join("\n  ")}`);
+  const warn = (_c = opts.warn) != null ? _c : defaultWarn;
+  if (derived.size)
+    warn(
+      `rdsThemeFromTable(${table.name}): the table was exported before ${[...derived].map((r) => `"${r}"`).join(", ")} existed in the [RDS] theme. Taken from the tokens Figma aliases it to (` + [...derived].map((r) => Object.entries(ADDED_ROLES[r]).map(([m, src]) => `${m}: ${src}`).join(", ")).join("; ") + `). Export the table again with figma/export-brand.js.`
+    );
+  const fails = rdsContrastReport(out);
+  if (fails.length)
+    warn(
+      `rdsThemeFromTable(${table.name}): ${fails.length} text pair(s) below 4.5:1
+  ` + fails.map((f) => `${f.mode}: ${f.fg} on ${f.bg} ${f.ratio}:1`).join("\n  ")
+    );
   return out;
 }
 
@@ -1365,4 +1491,4 @@ Brand's own variables (same value in every mode): ${own.map((v) => `\`${v}\``).j
 `;
 }
 
-export { ROLES, SCALE_STEPS, brandTones, buildScale, contrastRatio, emitClaudeMd, emitCss, emitRdsCss, generateRdsTheme, generateTheme, hexToHsl, hslToHex, isHex, isNeutralBrand, onColor, rdsContrast, rdsThemeFromTable, refToHex, relativeLuminance, resolveTheme, roleVar };
+export { RDS_CONTRAST_PAIRS, RDS_SCOPE_SELECTORS, RDS_TOKEN_SCOPE, ROLES, SCALE_STEPS, brandTones, buildScale, contrastRatio, emitClaudeMd, emitCss, emitRdsCss, generateRdsTheme, generateTheme, hexToHsl, hslToHex, isHex, isNeutralBrand, onColor, rdsContrast, rdsContrastReport, rdsThemeFromTable, refToHex, relativeLuminance, resolveTheme, roleVar };

package/dist/generate.d.ts

@@ -7,6 +7,10 @@ type RdsTheme = Record<RdsMode, Record<string, string>> & {
     /** The brand's own variables (Figma `brand` collection, `<brand>/<name>`), one value for every mode. */
     vars?: Record<string, string>;
 };
+type RdsThemeOptions = {
+    /** Where the warnings go (an explicit BrandDef.heading that fails AA). Default console.warn. */
+    warn?: (message: string) => void;
+};
 /**
  * Roles of the [RDS] theme collection, in Figma order: [name, dark source, brand source].
  * The light mode always reads the plain base token. In dark and brand, Figma points either to the
@@ -15,22 +19,57 @@ type RdsTheme = Record<RdsMode, Record<string, string>> & {
 declare const ROLES: ReadonlyArray<readonly [string, "l" | "d", "l" | "d" | "b"]>;
 /** CSS custom property of a role: the Figma path with hyphens (the [RDS] codeSyntax rule). */
 declare const roleVar: (role: string) => string;
-declare function generateRdsTheme(def: BrandDef): RdsTheme;
+declare function generateRdsTheme(def: BrandDef, opts?: RdsThemeOptions): RdsTheme;
+/**
+ * The selectors on which @rojaostudio/ds redeclares its component tokens (styles/rds/components.css and
+ * foundation.css). A component token holds `var(--theme-role)`, and a custom property is resolved on the element
+ * where it is declared: a theme scope that none of these match would repaint the roles but not the components
+ * inside it, which keep the colours resolved at :root. The attributes are the generic way in: put
+ * `data-rds-scope` on a scope element, `data-rds-mode="dark"` on a dark one, `data-rds-plate` on a plate.
+ */
+declare const RDS_SCOPE_SELECTORS: readonly [":root", ".ds-scope", "[data-rds-scope]", ".dark", "[data-rds-mode]", ".ds-plate", "[data-rds-plate]"];
+/** RDS_SCOPE_SELECTORS as one selector list, as the component token layer is emitted. */
+declare const RDS_TOKEN_SCOPE: string;
 type RdsCssOptions = {
-    /** Scope of the light mode. Default `:root, .ds-scope`. */
+    /** Scope of the light mode. Default `:root, .ds-scope, [data-rds-scope]`. */
     scope?: string;
-    /** Selector of the dark mode, combined with the scope. Default `.dark`. */
+    /**
+     * Selector of the dark mode, combined with each scope. Default `.dark, [data-rds-mode="dark"]`. A selector
+     * anchored at the root (`:root[data-theme="dark"]`, `html.dark`) is used as is: the theme switches on <html>,
+     * as next-themes does.
+     */
     dark?: string;
-    /** Selector of the brand plate (a section painted with the primary). Default `.ds-plate`. */
+    /** Selector of the brand plate (a section painted with the primary). Default `.ds-plate, [data-rds-plate]`. */
     plate?: string;
+    /**
+     * Skip the check that every selector is covered by the component tokens of @rojaostudio/ds (RDS_SCOPE_SELECTORS).
+     * Only for a theme read by your own CSS, without the components.
+     */
+    allowUncovered?: boolean;
 };
 /**
  * The theme as CSS. Dark and plate only carry what differs from light: they inherit the rest
  * through the cascade, like the [RDS] modes that point back to the plain token.
+ *
+ * Throws when a selector would leave the components of @rojaostudio/ds on the root colours (see
+ * RDS_SCOPE_SELECTORS), unless `allowUncovered`.
  */
 declare function emitRdsCss(theme: RdsTheme, opts?: RdsCssOptions): string;
 /** Contrast of a role pair in one mode (alpha colours are not measured: they depend on what is below). */
 declare function rdsContrast(theme: RdsTheme, mode: RdsMode, fg: string, bg: string): number | null;
+/**
+ * The main text pairs of the theme: [text role, the surface it sits on]. Measured in every mode; a pair with an
+ * alpha colour is skipped (its contrast depends on what is below).
+ */
+declare const RDS_CONTRAST_PAIRS: ReadonlyArray<readonly [string, string]>;
+type RdsContrastFailure = {
+    mode: RdsMode;
+    fg: string;
+    bg: string;
+    ratio: number;
+};
+/** The pairs of RDS_CONTRAST_PAIRS that fail WCAG AA (4.5:1), mode by mode. Empty means every pair passes. */
+declare function rdsContrastReport(theme: RdsTheme): RdsContrastFailure[];
 /**
  * A brand as drawn in the [RDS] Base Tokens file: for each theme mode, every role points to a primitive of the
  * [RDS] Primitives library by name ("accyan/400"), and `primitives` holds the colour Figma resolves for each.
@@ -44,8 +83,13 @@ type RdsBrandTable = {
     /** The brand's own variables of the `brand` collection, by Figma path ("marca/ciano") → primitive or value. */
     vars?: Record<string, string>;
 };
-/** The theme of a brand table. Fails on a missing role or an unknown primitive, listing them all. */
-declare function rdsThemeFromTable(table: RdsBrandTable): RdsTheme;
+/**
+ * The theme of a brand table. Fails on a missing role or an unknown primitive, listing them all. A table exported
+ * before a role of ADDED_ROLES existed is the exception: the role is taken from the token Figma aliases it to, and
+ * `opts.warn` asks to export the table again. The contrast of the main text pairs (rdsContrastReport) is only
+ * reported, through `opts.warn`: the table is the brand as drawn in Figma, kept one to one even where a pair fails.
+ */
+declare function rdsThemeFromTable(table: RdsBrandTable, opts?: RdsThemeOptions): RdsTheme;
 
 /**
  * emitCss.ts — formata o output do generateTheme num theme.css legível.
@@ -149,4 +193,4 @@ declare function isNeutralBrand(def: {
     palettes?: PaletteDefs;
 }): boolean;
 
-export { BrandDef, type ClaudeMdOptions, type ClaudeMdTarget, ROLES as RDS_ROLES, type RdsBrandTable, type RdsCssOptions, type RdsMode, type RdsTheme, SCALE_STEPS, type Scale, type ScaleStep, brandTones, buildScale, contrastRatio, emitClaudeMd, emitCss, emitRdsCss, generateRdsTheme, hexToHsl, hslToHex, isHex, isNeutralBrand, onColor, rdsContrast, rdsThemeFromTable, refToHex, relativeLuminance, roleVar };
+export { BrandDef, type ClaudeMdOptions, type ClaudeMdTarget, RDS_CONTRAST_PAIRS, ROLES as RDS_ROLES, RDS_SCOPE_SELECTORS, RDS_TOKEN_SCOPE, type RdsBrandTable, type RdsContrastFailure, type RdsCssOptions, type RdsMode, type RdsTheme, type RdsThemeOptions, SCALE_STEPS, type Scale, type ScaleStep, brandTones, buildScale, contrastRatio, emitClaudeMd, emitCss, emitRdsCss, generateRdsTheme, hexToHsl, hslToHex, isHex, isNeutralBrand, onColor, rdsContrast, rdsContrastReport, rdsThemeFromTable, refToHex, relativeLuminance, roleVar };

package/dist/generate.js

@@ -1,3 +1,3 @@
-export { ROLES as RDS_ROLES, SCALE_STEPS, brandTones, buildScale, contrastRatio, emitClaudeMd, emitCss, emitRdsCss, generateRdsTheme, generateTheme, hexToHsl, hslToHex, isHex, isNeutralBrand, onColor, rdsContrast, rdsThemeFromTable, refToHex, relativeLuminance, resolveTheme, roleVar } from './chunk-UD53AUQQ.js';
+export { RDS_CONTRAST_PAIRS, ROLES as RDS_ROLES, RDS_SCOPE_SELECTORS, RDS_TOKEN_SCOPE, SCALE_STEPS, brandTones, buildScale, contrastRatio, emitClaudeMd, emitCss, emitRdsCss, generateRdsTheme, generateTheme, hexToHsl, hslToHex, isHex, isNeutralBrand, onColor, rdsContrast, rdsContrastReport, rdsThemeFromTable, refToHex, relativeLuminance, resolveTheme, roleVar } from './chunk-6XIFYDSU.js';
 import './chunk-FRWRLCYM.js';
 import './chunk-ORMEWXMH.js';

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 export { G as GenResult, R as ResolvedTheme, T as TokenMap, g as generateTheme, r as resolveTheme } from './generateTheme-CUfNpsKs.js';
-export { ClaudeMdOptions, ClaudeMdTarget, RDS_ROLES, RdsBrandTable, RdsCssOptions, RdsMode, RdsTheme, SCALE_STEPS, Scale, ScaleStep, brandTones, buildScale, contrastRatio, emitClaudeMd, emitCss, emitRdsCss, generateRdsTheme, hexToHsl, hslToHex, isHex, isNeutralBrand, onColor, rdsContrast, rdsThemeFromTable, refToHex, relativeLuminance, roleVar } from './generate.js';
+export { ClaudeMdOptions, ClaudeMdTarget, RDS_CONTRAST_PAIRS, RDS_ROLES, RDS_SCOPE_SELECTORS, RDS_TOKEN_SCOPE, RdsBrandTable, RdsContrastFailure, RdsCssOptions, RdsMode, RdsTheme, RdsThemeOptions, SCALE_STEPS, Scale, ScaleStep, brandTones, buildScale, contrastRatio, emitClaudeMd, emitCss, emitRdsCss, generateRdsTheme, hexToHsl, hslToHex, isHex, isNeutralBrand, onColor, rdsContrast, rdsContrastReport, rdsThemeFromTable, refToHex, relativeLuminance, roleVar } from './generate.js';
 export { A as Archetype, B as BrandColors, a as BrandDef, C as ColorRef, D as DarkStrategy, F as FontDef, P as PaletteRef, S as ScaleToken, T as TextStyle, b as TextStyleName, c as TypeScale } from './recipe.schema-Cq7e82nx.js';
 export { primitives, tokens } from './tokens.js';
 export { RecipeName, recipes } from './recipes.js';

package/dist/index.js

@@ -1,4 +1,4 @@
 export { recipes } from './chunk-PV6GFEAM.js';
-export { ROLES as RDS_ROLES, SCALE_STEPS, brandTones, buildScale, contrastRatio, emitClaudeMd, emitCss, emitRdsCss, generateRdsTheme, generateTheme, hexToHsl, hslToHex, isHex, isNeutralBrand, onColor, rdsContrast, rdsThemeFromTable, refToHex, relativeLuminance, resolveTheme, roleVar } from './chunk-UD53AUQQ.js';
+export { RDS_CONTRAST_PAIRS, ROLES as RDS_ROLES, RDS_SCOPE_SELECTORS, RDS_TOKEN_SCOPE, SCALE_STEPS, brandTones, buildScale, contrastRatio, emitClaudeMd, emitCss, emitRdsCss, generateRdsTheme, generateTheme, hexToHsl, hslToHex, isHex, isNeutralBrand, onColor, rdsContrast, rdsContrastReport, rdsThemeFromTable, refToHex, relativeLuminance, resolveTheme, roleVar } from './chunk-6XIFYDSU.js';
 export { primitives, tokens } from './chunk-FRWRLCYM.js';
 import './chunk-ORMEWXMH.js';

package/dist/themes.js

@@ -1,4 +1,4 @@
-import { generateTheme } from './chunk-UD53AUQQ.js';
+import { generateTheme } from './chunk-6XIFYDSU.js';
 import './chunk-FRWRLCYM.js';
 import { __spreadValues, __objRest } from './chunk-ORMEWXMH.js';
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rojaostudio/ds-core",
-  "version": "1.1.0-next.6",
+  "version": "1.1.0-next.8",
   "description": "O motor do Rojão DS — tokens, derivação de tema e emissores. Sem React, sem Tailwind, sem CSS.",
   "license": "MIT",
   "author": "Rojão Studio (https://rojao.studio)",