@rojaostudio/ds-core 1.1.0-next.14 → 1.1.0-next.16

package/README.md

@@ -44,7 +44,7 @@ Components, styles and the React Native target live in
 
 | Entry | What's in it |
 |---|---|
-| `@rojaostudio/ds-core/generate` | `generateRdsTheme`, `rdsThemeFromTable`, `emitRdsCss`, `emitClaudeMd`, `generateTheme`/`emitCss` (1.x), `buildScale`, `contrastRatio` |
+| `@rojaostudio/ds-core/generate` | `generateRdsTheme`, `rdsThemeFromTable`, `emitRdsCss`, `emitClaudeMd`, `rdsBrandColors`, `deriveAccent`, `generateTheme`/`emitCss` (1.x), `buildScale`, `contrastRatio` |
 | `@rojaostudio/ds-core/tokens` | `primitives` — the raw palettes and scales |
 | `@rojaostudio/ds-core/recipes` | the reference brand definition |
 | `@rojaostudio/ds-core/themes` | the preset catalogue: a starting palette per niche |

package/dist/{chunk-QJN6R2DB.js → chunk-EQWIHPLK.js}

@@ -753,6 +753,23 @@ function oneLine(v, max = 200) {
   return s;
 }
 
+// generate/derive.ts
+var RAD2 = Math.PI / 180;
+var DEG2 = 180 / Math.PI;
+var ACCENT_TURN = 150;
+var ACCENT_L = 0.72;
+var ACCENT_C_MIN = 0.14;
+var ACCENT_C_MAX = 0.22;
+var NEUTRAL_C = 0.04;
+var NEUTRAL_ACCENT_HUE = 55;
+function deriveAccent(primary) {
+  if (!isHex(primary)) throw new Error(`deriveAccent: ${JSON.stringify(String(primary).slice(0, 40))} is not a #rrggbb colour`);
+  const [, C, h] = hexToOklch(primary);
+  const hue = C < NEUTRAL_C ? NEUTRAL_ACCENT_HUE : ((h * DEG2 + ACCENT_TURN) % 360 + 360) % 360;
+  const chroma = Math.min(ACCENT_C_MAX, Math.max(ACCENT_C_MIN, C));
+  return oklchToHex(ACCENT_L, chroma, hue * RAD2).toLowerCase();
+}
+
 // generate/rdsTheme.ts
 var palettes = primitives.color;
 var WHITE = "#ffffff";
@@ -999,10 +1016,12 @@ var ROLES = [
   ["surface/inverse", "d", "d"],
   ["text/on-inverse", "d", "d"],
   ["text/on-inverse-subtle", "d", "d"],
-  ["text/on/success-strong", "d", "d"]
+  ["text/on/success-strong", "d", "d"],
+  ["text/selected", "d", "b"]
 ];
 var SUCCESS_STRONG_ON = { light: WHITE, dark: BLACK };
 var coal = palettes.coal;
+var selectedOn = (primary, scale, tints, fallback) => readableFrom(primary, scale, tints, awayFrom(tints[0]), fallback);
 var inverseOf = (primary) => contrastRatio(WHITE, primary) >= AA ? primary : coal[900];
 function inverseSubtle(fill) {
   for (let p = 70; p < 100; p += 5) if (contrastRatio(over(white(p), fill), fill) >= AA) return white(p);
@@ -1023,6 +1042,28 @@ var awayFrom = (bg) => contrastRatio(bg, BLACK) >= contrastRatio(bg, WHITE) ? "d
 var TINT_DEFAULT = 200;
 var lighterStep = (s) => s - 100 ;
 var roleVar = (role) => `--${role.replaceAll("/", "-")}`;
+function brandRamps(b, own) {
+  const P = ramp(b.primary, own);
+  const S = b.secondary ? ramp(b.secondary, own) : P;
+  const A = b.accent ? ramp(b.accent, own) : ramp(deriveAccent(P.base.toLowerCase()));
+  return { P, S, A };
+}
+function rdsBrandColors(def) {
+  const where = `rdsBrandColors(${preview(def == null ? void 0 : def.name)})`;
+  if (!(def == null ? void 0 : def.brand) || typeof def.brand !== "object") throw new Error(`${where}: brand is missing`);
+  checkPalettes(def.palettes, where);
+  const { P, S, A } = brandRamps(def.brand, def.palettes);
+  const out = {
+    primary: P.base.toLowerCase(),
+    secondary: S.base.toLowerCase(),
+    accent: A.base.toLowerCase(),
+    source: { secondary: def.brand.secondary ? "recipe" : "primary", accent: def.brand.accent ? "recipe" : "derived" }
+  };
+  const c = collector(where);
+  for (const k of ["primary", "secondary", "accent"]) c.color(k, out[k]);
+  c.done();
+  return out;
+}
 function generateRdsTheme(def, opts = {}) {
   var _a, _b, _c, _d;
   const warn = (_a = opts.warn) != null ? _a : defaultWarn;
@@ -1031,9 +1072,7 @@ function generateRdsTheme(def, opts = {}) {
   checkPalettes(def.palettes, where);
   const b = def.brand;
   const own = def.palettes;
-  const P = ramp(b.primary, own);
-  const S = b.secondary ? ramp(b.secondary, own) : P;
-  const A = b.accent ? ramp(b.accent, own) : P;
+  const { P, S, A } = brandRamps(b, own);
   const N = def.text && ((own == null ? void 0 : own[def.text]) || palettes[def.text] && typeof palettes[def.text] !== "string") ? palette(def.text, own) : palette("zinc");
   const L = palette("blue");
   const red = palette("red"), green = palette("green"), orange = palette("orange");
@@ -1182,6 +1221,7 @@ function generateRdsTheme(def, opts = {}) {
   l["logo/accent"] = l["colors/accent/logo"];
   l["logo/accent-2"] = l["colors/secondary/default"];
   l["logo/accent-3"] = l["colors/accent/default"];
+  l["text/selected"] = selectedOn(l["colors/primary/default"], K, [l["surface/tint/default"], l["surface/tint/subtle"]], BLACK);
   const d = __spreadProps(__spreadValues({
     "surface/page": N[900],
     "surface/panel": N[900],
@@ -1287,6 +1327,7 @@ function generateRdsTheme(def, opts = {}) {
   [d["colors/accent/hover"]] = stateFills(A.scale, d["colors/accent/default"], d["text/on/accent"], [d["colors/accent/hover"]]);
   d["border/error"] = readableFrom(red[400], 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);
+  d["text/selected"] = selectedOn(d["colors/primary/default"], K, [d["surface/tint/default"], d["surface/tint/subtle"]], WHITE);
   const ink0 = on(P.base);
   const plate = contrastRatio(ink0, P.base) >= PLATE_MIN ? P.base : readableFrom(P.base, P.scale, [ink0], ink0 === WHITE ? "darker" : "lighter", ink0 === WHITE ? BLACK : WHITE, PLATE_MIN);
   const ink = on(plate);
@@ -1346,7 +1387,9 @@ function generateRdsTheme(def, opts = {}) {
     "surface/muted-strong": ov(20),
     "border/strong": fieldBorder,
     "border/strong-hover": fieldAlpha + 20 < 100 ? inkA(fieldAlpha + 20) : ink,
-    "text/on/primary-subtle": inkA(30)
+    "text/on/primary-subtle": inkA(30),
+    // The selected item on the plate: the ink, which the plate's overlays (ov) are drawn to carry at AA.
+    "text/selected": ink
   };
   for (const role of ["colors/primary/dark", "colors/primary/light"])
     br[role] = carry(P.scale, br["colors/primary/default"], br["text/on/primary-strong"], br[role]);
@@ -1541,6 +1584,8 @@ var RDS_CONTRAST_PAIRS = [
   ["text/muted", "surface/tint/default"],
   ["text/on/tint", "surface/tint/subtle"],
   ["text/action", "surface/action/strong"],
+  ["text/selected", "surface/tint/default"],
+  ["text/selected", "surface/tint/subtle"],
   ["text/muted", "surface/page"],
   ["text/muted", "surface/panel"],
   ["text/subtle", "surface/card"],
@@ -1597,7 +1642,9 @@ function laterFallback(role, mode, primary) {
 var isColourRef = (v) => /^[a-z][a-z0-9-]*\/[a-z]?\d+$/i.test(v);
 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" }
+  "border/error": { light: "colors/state/error", dark: "colors/state/error-strong", brand: "text/error" },
+  // Figma: colors/primary/default of each mode (base colors/primary/default, dark/…, brand/…).
+  "text/selected": { light: "colors/primary/default", dark: "colors/primary/default", brand: "colors/primary/default" }
 };
 function rdsThemeFromTable(table, opts = {}) {
   var _a, _b, _c;
@@ -1933,4 +1980,4 @@ Brand's own variables (same value in every mode): ${own.map((v) => `\`${v}\``).j
   return text;
 }
 
-export { RDS_CONTRAST_PAIRS, RDS_MEDIA_TYPE, RDS_NON_TEXT_PAIRS, RDS_PRINT_ON_WHITE, RDS_PRINT_TRANSPARENT, RDS_PRINT_WHITE, RDS_SCOPE_SELECTORS, RDS_TOKEN_SCOPE, ROLES, RdsValidationError, SCALE_STEPS, brandTones, buildScale, contrastRatio, emitClaudeMd, emitCss, emitRdsCss, generateRdsTheme, generateTheme, hexToHsl, hslToHex, isHex, isNeutralBrand, isSafeColor, isSafeFont, isSafeVarName, onColor, rdsContrast, rdsContrastReport, rdsPrintMode, rdsThemeFromTable, refToHex, relativeLuminance, resolveTheme, roleVar };
+export { RDS_CONTRAST_PAIRS, RDS_MEDIA_TYPE, RDS_NON_TEXT_PAIRS, RDS_PRINT_ON_WHITE, RDS_PRINT_TRANSPARENT, RDS_PRINT_WHITE, RDS_SCOPE_SELECTORS, RDS_TOKEN_SCOPE, ROLES, RdsValidationError, SCALE_STEPS, brandTones, buildScale, contrastRatio, deriveAccent, emitClaudeMd, emitCss, emitRdsCss, generateRdsTheme, generateTheme, hexToHsl, hslToHex, isHex, isNeutralBrand, isSafeColor, isSafeFont, isSafeVarName, onColor, rdsBrandColors, rdsContrast, rdsContrastReport, rdsPrintMode, rdsThemeFromTable, refToHex, relativeLuminance, resolveTheme, roleVar };

package/dist/generate.d.ts

@@ -20,6 +20,26 @@ type RdsThemeOptions = {
 declare const ROLES: ReadonlyArray<readonly [string, "l" | "d" | "p", "l" | "d" | "b" | "p"]>;
 /** CSS custom property of a role: the Figma path with hyphens (the [RDS] codeSyntax rule). */
 declare const roleVar: (role: string) => string;
+/** The brand colours a theme is drawn from, as #rrggbb, and where each came from (rdsBrandColors). */
+type RdsBrandColors = {
+    primary: string;
+    secondary: string;
+    accent: string;
+    /**
+     * Where the secondary and the accent came from: the recipe, or, when it names none, the primary itself (the
+     * secondary) or a colour derived from the primary (the accent).
+     */
+    source: {
+        secondary: "recipe" | "primary";
+        accent: "recipe" | "derived";
+    };
+};
+/**
+ * The primary, secondary and accent generateRdsTheme draws the theme from: the recipe's own (palette refs resolved),
+ * or, where the recipe names none, the primary as secondary and the accent derived from it. For a generator to show
+ * them in its fields.
+ */
+declare function rdsBrandColors(def: BrandDef): RdsBrandColors;
 declare function generateRdsTheme(def: BrandDef, opts?: RdsThemeOptions): RdsTheme;
 /**
  * The selectors on which @rojaostudio/ds redeclares its component tokens (styles/rds/components.css and
@@ -134,6 +154,9 @@ type RdsBrandTable = {
  */
 declare function rdsThemeFromTable(table: RdsBrandTable, opts?: RdsThemeOptions): RdsTheme;
 
+/** The accent (highlight) of a primary hex (#rrggbb). See the rule above. */
+declare function deriveAccent(primary: string): string;
+
 /**
  * validate.ts — what the emitters accept from the outside (a recipe, a brand table, a theme object).
  *
@@ -261,4 +284,4 @@ declare function isNeutralBrand(def: {
     palettes?: PaletteDefs;
 }): boolean;
 
-export { BrandDef, type ClaudeMdOptions, type ClaudeMdTarget, RDS_CONTRAST_PAIRS, RDS_MEDIA_TYPE, RDS_NON_TEXT_PAIRS, RDS_PRINT_ON_WHITE, RDS_PRINT_TRANSPARENT, RDS_PRINT_WHITE, ROLES as RDS_ROLES, RDS_SCOPE_SELECTORS, RDS_TOKEN_SCOPE, type RdsBrandTable, type RdsContrastFailure, type RdsCssOptions, type RdsMode, type RdsTheme, type RdsThemeOptions, RdsValidationError, SCALE_STEPS, type Scale, type ScaleStep, brandTones, buildScale, contrastRatio, emitClaudeMd, emitCss, emitRdsCss, generateRdsTheme, hexToHsl, hslToHex, isHex, isNeutralBrand, isSafeColor, isSafeFont, isSafeVarName, onColor, rdsContrast, rdsContrastReport, rdsPrintMode, rdsThemeFromTable, refToHex, relativeLuminance, roleVar };
+export { BrandDef, type ClaudeMdOptions, type ClaudeMdTarget, RDS_CONTRAST_PAIRS, RDS_MEDIA_TYPE, RDS_NON_TEXT_PAIRS, RDS_PRINT_ON_WHITE, RDS_PRINT_TRANSPARENT, RDS_PRINT_WHITE, ROLES as RDS_ROLES, RDS_SCOPE_SELECTORS, RDS_TOKEN_SCOPE, type RdsBrandColors, type RdsBrandTable, type RdsContrastFailure, type RdsCssOptions, type RdsMode, type RdsTheme, type RdsThemeOptions, RdsValidationError, SCALE_STEPS, type Scale, type ScaleStep, brandTones, buildScale, contrastRatio, deriveAccent, emitClaudeMd, emitCss, emitRdsCss, generateRdsTheme, hexToHsl, hslToHex, isHex, isNeutralBrand, isSafeColor, isSafeFont, isSafeVarName, onColor, rdsBrandColors, rdsContrast, rdsContrastReport, rdsPrintMode, rdsThemeFromTable, refToHex, relativeLuminance, roleVar };

package/dist/generate.js

@@ -1,3 +1,3 @@
-export { RDS_CONTRAST_PAIRS, RDS_MEDIA_TYPE, RDS_NON_TEXT_PAIRS, RDS_PRINT_ON_WHITE, RDS_PRINT_TRANSPARENT, RDS_PRINT_WHITE, ROLES as RDS_ROLES, RDS_SCOPE_SELECTORS, RDS_TOKEN_SCOPE, RdsValidationError, SCALE_STEPS, brandTones, buildScale, contrastRatio, emitClaudeMd, emitCss, emitRdsCss, generateRdsTheme, generateTheme, hexToHsl, hslToHex, isHex, isNeutralBrand, isSafeColor, isSafeFont, isSafeVarName, onColor, rdsContrast, rdsContrastReport, rdsPrintMode, rdsThemeFromTable, refToHex, relativeLuminance, resolveTheme, roleVar } from './chunk-QJN6R2DB.js';
+export { RDS_CONTRAST_PAIRS, RDS_MEDIA_TYPE, RDS_NON_TEXT_PAIRS, RDS_PRINT_ON_WHITE, RDS_PRINT_TRANSPARENT, RDS_PRINT_WHITE, ROLES as RDS_ROLES, RDS_SCOPE_SELECTORS, RDS_TOKEN_SCOPE, RdsValidationError, SCALE_STEPS, brandTones, buildScale, contrastRatio, deriveAccent, emitClaudeMd, emitCss, emitRdsCss, generateRdsTheme, generateTheme, hexToHsl, hslToHex, isHex, isNeutralBrand, isSafeColor, isSafeFont, isSafeVarName, onColor, rdsBrandColors, rdsContrast, rdsContrastReport, rdsPrintMode, rdsThemeFromTable, refToHex, relativeLuminance, resolveTheme, roleVar } from './chunk-EQWIHPLK.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_CONTRAST_PAIRS, RDS_MEDIA_TYPE, RDS_NON_TEXT_PAIRS, RDS_PRINT_ON_WHITE, RDS_PRINT_TRANSPARENT, RDS_PRINT_WHITE, RDS_ROLES, RDS_SCOPE_SELECTORS, RDS_TOKEN_SCOPE, RdsBrandTable, RdsContrastFailure, RdsCssOptions, RdsMode, RdsTheme, RdsThemeOptions, RdsValidationError, SCALE_STEPS, Scale, ScaleStep, brandTones, buildScale, contrastRatio, emitClaudeMd, emitCss, emitRdsCss, generateRdsTheme, hexToHsl, hslToHex, isHex, isNeutralBrand, isSafeColor, isSafeFont, isSafeVarName, onColor, rdsContrast, rdsContrastReport, rdsPrintMode, rdsThemeFromTable, refToHex, relativeLuminance, roleVar } from './generate.js';
+export { ClaudeMdOptions, ClaudeMdTarget, RDS_CONTRAST_PAIRS, RDS_MEDIA_TYPE, RDS_NON_TEXT_PAIRS, RDS_PRINT_ON_WHITE, RDS_PRINT_TRANSPARENT, RDS_PRINT_WHITE, RDS_ROLES, RDS_SCOPE_SELECTORS, RDS_TOKEN_SCOPE, RdsBrandColors, RdsBrandTable, RdsContrastFailure, RdsCssOptions, RdsMode, RdsTheme, RdsThemeOptions, RdsValidationError, SCALE_STEPS, Scale, ScaleStep, brandTones, buildScale, contrastRatio, deriveAccent, emitClaudeMd, emitCss, emitRdsCss, generateRdsTheme, hexToHsl, hslToHex, isHex, isNeutralBrand, isSafeColor, isSafeFont, isSafeVarName, onColor, rdsBrandColors, rdsContrast, rdsContrastReport, rdsPrintMode, 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 { RDS_CONTRAST_PAIRS, RDS_MEDIA_TYPE, RDS_NON_TEXT_PAIRS, RDS_PRINT_ON_WHITE, RDS_PRINT_TRANSPARENT, RDS_PRINT_WHITE, ROLES as RDS_ROLES, RDS_SCOPE_SELECTORS, RDS_TOKEN_SCOPE, RdsValidationError, SCALE_STEPS, brandTones, buildScale, contrastRatio, emitClaudeMd, emitCss, emitRdsCss, generateRdsTheme, generateTheme, hexToHsl, hslToHex, isHex, isNeutralBrand, isSafeColor, isSafeFont, isSafeVarName, onColor, rdsContrast, rdsContrastReport, rdsPrintMode, rdsThemeFromTable, refToHex, relativeLuminance, resolveTheme, roleVar } from './chunk-QJN6R2DB.js';
+export { RDS_CONTRAST_PAIRS, RDS_MEDIA_TYPE, RDS_NON_TEXT_PAIRS, RDS_PRINT_ON_WHITE, RDS_PRINT_TRANSPARENT, RDS_PRINT_WHITE, ROLES as RDS_ROLES, RDS_SCOPE_SELECTORS, RDS_TOKEN_SCOPE, RdsValidationError, SCALE_STEPS, brandTones, buildScale, contrastRatio, deriveAccent, emitClaudeMd, emitCss, emitRdsCss, generateRdsTheme, generateTheme, hexToHsl, hslToHex, isHex, isNeutralBrand, isSafeColor, isSafeFont, isSafeVarName, onColor, rdsBrandColors, rdsContrast, rdsContrastReport, rdsPrintMode, rdsThemeFromTable, refToHex, relativeLuminance, resolveTheme, roleVar } from './chunk-EQWIHPLK.js';
 export { primitives, tokens } from './chunk-FRWRLCYM.js';
 import './chunk-ORMEWXMH.js';

package/dist/themes.js

@@ -1,4 +1,4 @@
-import { generateTheme } from './chunk-QJN6R2DB.js';
+import { generateTheme } from './chunk-EQWIHPLK.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.14",
+  "version": "1.1.0-next.16",
   "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)",