@rojaostudio/ds-core 1.1.0-next.0 → 1.1.0-next.2

package/dist/{chunk-CFCKPKAF.js → chunk-DZAJKHNW.js}

@@ -681,16 +681,25 @@ var WHITE = "#ffffff";
 var BLACK = "#000000";
 var black = (pct) => BLACK + Math.round(pct / 100 * 255).toString(16).padStart(2, "0");
 var white = (pct) => WHITE + Math.round(pct / 100 * 255).toString(16).padStart(2, "0");
-function palette(name) {
+function palette(name, custom) {
+  const own = custom == null ? void 0 : custom[name];
+  if (typeof own === "string") {
+    if (!isHex(own)) throw new Error(`rdsTheme: palette "${name}" is not a hex colour`);
+    return buildScale(own);
+  }
+  if (own) return own;
   const p = palettes[name];
   if (!p || typeof p === "string") throw new Error(`rdsTheme: unknown palette "${name}"`);
   return p;
 }
-function ramp(c) {
+function ramp(c, custom) {
   var _a;
   if (isHex(c)) return { base: c, scale: buildScale(c) };
-  const m = c.match(/^([a-zA-Z]+)-(\d{2,3})$/);
-  if (m) return { base: (_a = refToHex(c)) != null ? _a : palette(m[1])[Number(m[2])], scale: palette(m[1]) };
+  const m = c.match(/^([a-zA-Z][a-zA-Z0-9]*)-(\d{2,3})$/);
+  if (m) {
+    const scale = palette(m[1], custom);
+    return { base: (_a = scale[Number(m[2])]) != null ? _a : refToHex(c), scale };
+  }
   const hex = refToHex(c);
   if (!hex) throw new Error(`rdsTheme: cannot resolve colour "${c}"`);
   return { base: hex, scale: buildScale(hex) };
@@ -806,15 +815,16 @@ var lighterStep = (s) => s - 100 ;
 var roleVar = (role) => `--${role.replaceAll("/", "-")}`;
 function generateRdsTheme(def) {
   const b = def.brand;
-  const P = ramp(b.primary);
-  const S = b.secondary ? ramp(b.secondary) : P;
-  const A = b.accent ? ramp(b.accent) : P;
-  const N = palette(def.text && palettes[def.text] && typeof palettes[def.text] !== "string" ? def.text : "zinc");
+  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 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");
   const teal = palette("teal"), purple = palette("purple");
-  const heading = b.heading ? ramp(b.heading).base : P.base;
-  const invert = b.invert ? ramp(b.invert).base : WHITE;
+  const heading = b.heading ? ramp(b.heading, own).base : P.base;
+  const invert = b.invert ? ramp(b.invert, own).base : WHITE;
   const l = {
     "colors/primary/light": P.scale[500],
     "colors/primary/default": P.base,
@@ -1092,6 +1102,31 @@ 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 isColourRef = (v) => /^[a-z][a-z0-9-]*\/[a-z]?\d+$/i.test(v);
+function rdsThemeFromTable(table) {
+  var _a;
+  const out = { light: {}, dark: {}, brand: {} };
+  const problems = [];
+  for (const mode of ["light", "dark", "brand"]) {
+    const roles = (_a = table.modes) == null ? void 0 : _a[mode];
+    if (!roles) {
+      problems.push(`mode "${mode}" is missing`);
+      continue;
+    }
+    for (const [role] of ROLES) {
+      const ref2 = roles[role];
+      if (ref2 === void 0) problems.push(`${mode}: role "${role}" is missing`);
+      else if (isColourRef(ref2)) {
+        const value = table.primitives[ref2];
+        if (value === void 0) problems.push(`${mode}: "${role}" points to unknown primitive "${ref2}"`);
+        else out[mode][roleVar(role)] = value.toLowerCase();
+      } else out[mode][roleVar(role)] = ref2;
+    }
+  }
+  if (problems.length) throw new Error(`rdsThemeFromTable(${table.name}):
+  ${problems.join("\n  ")}`);
+  return out;
+}
 
 // generate/emitCss.ts
 var SECTIONS = [
@@ -1313,4 +1348,4 @@ neutral 50 ${neutral[50]} \xB7 500 ${neutral[500]} \xB7 900 ${neutral[900]}
 `;
 }
 
-export { ROLES, SCALE_STEPS, brandTones, buildScale, contrastRatio, emitClaudeMd, emitCss, emitRdsCss, generateRdsTheme, generateTheme, hexToHsl, hslToHex, isHex, isNeutralBrand, onColor, rdsContrast, refToHex, relativeLuminance, resolveTheme, roleVar };
+export { ROLES, SCALE_STEPS, brandTones, buildScale, contrastRatio, emitClaudeMd, emitCss, emitRdsCss, generateRdsTheme, generateTheme, hexToHsl, hslToHex, isHex, isNeutralBrand, onColor, rdsContrast, rdsThemeFromTable, refToHex, relativeLuminance, resolveTheme, roleVar };

package/dist/generate.d.ts

@@ -28,6 +28,19 @@ type RdsCssOptions = {
 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;
+/**
+ * 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.
+ * Exported by `figma/export-brand.js`. The theme comes out one to one with the Figma brand mode.
+ */
+type RdsBrandTable = {
+    $schema?: "rds-brand-table/1";
+    name: string;
+    primitives: Record<string, string>;
+    modes: Record<RdsMode, 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;
 
 /**
  * emitCss.ts — formata o output do generateTheme num theme.css legível.
@@ -110,4 +123,4 @@ declare function isNeutralBrand(def: {
     palettes?: PaletteDefs;
 }): boolean;
 
-export { BrandDef, type ClaudeMdOptions, type ClaudeMdTarget, ROLES as RDS_ROLES, 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, refToHex, relativeLuminance, roleVar };
+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 };

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, refToHex, relativeLuminance, resolveTheme, roleVar } from './chunk-CFCKPKAF.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-DZAJKHNW.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, RdsCssOptions, RdsMode, RdsTheme, SCALE_STEPS, Scale, ScaleStep, brandTones, buildScale, contrastRatio, emitClaudeMd, emitCss, emitRdsCss, generateRdsTheme, hexToHsl, hslToHex, isHex, isNeutralBrand, onColor, rdsContrast, refToHex, relativeLuminance, roleVar } from './generate.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 { 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-3QTDO2HW.js';
-export { ROLES as RDS_ROLES, SCALE_STEPS, brandTones, buildScale, contrastRatio, emitClaudeMd, emitCss, emitRdsCss, generateRdsTheme, generateTheme, hexToHsl, hslToHex, isHex, isNeutralBrand, onColor, rdsContrast, refToHex, relativeLuminance, resolveTheme, roleVar } from './chunk-CFCKPKAF.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-DZAJKHNW.js';
 export { primitives, tokens } from './chunk-FRWRLCYM.js';
 import './chunk-ORMEWXMH.js';

package/dist/themes.js

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

package/figma/export-brand.js

@@ -0,0 +1,51 @@
+/* global figma */
+// Exports one brand of the [RDS] Base Tokens file as a brand table for rdsThemeFromTable().
+// Run inside the Base Tokens file with the Figma Plugin API (a plugin console or an agent with use_figma),
+// after setting BRAND to the mode name of the `base` collection. The return value is the JSON to save.
+//
+// Each theme role is followed through the aliases of the `base` collection (in the brand's mode) down to a
+// primitive of the [RDS] Primitives library, kept by name ("accyan/400") with the colour Figma resolves.
+const BRAND = "rojao";
+
+const cols = await figma.variables.getLocalVariableCollectionsAsync();
+const base = cols.find((c) => c.name === "base");
+const theme = cols.find((c) => c.name === "theme");
+if (!base || !theme) throw new Error("open the [RDS] Base Tokens file");
+const brandMode = base.modes.find((m) => m.name === BRAND);
+if (!brandMode) throw new Error(`no brand "${BRAND}" in base: ${base.modes.map((m) => m.name).join(", ")}`);
+const local = new Set(cols.map((c) => c.id));
+
+const hex = (c) =>
+  "#" +
+  [c.r, c.g, c.b].map((x) => Math.round(x * 255).toString(16).padStart(2, "0")).join("") +
+  (c.a !== undefined && c.a < 1 ? Math.round(c.a * 255).toString(16).padStart(2, "0") : "");
+const literal = (v, val) => (v.resolvedType === "COLOR" ? hex(val) : String(val));
+const isAlias = (val) => val && typeof val === "object" && val.type === "VARIABLE_ALIAS";
+
+const primitives = {};
+async function resolve(v, themeMode) {
+  if (!local.has(v.variableCollectionId)) {
+    // A Primitives library variable: keep its name, record what it resolves to.
+    const val = Object.values(v.valuesByMode)[0];
+    if (isAlias(val)) return resolve(await figma.variables.getVariableByIdAsync(val.id), themeMode);
+    primitives[v.name] = literal(v, val);
+    return v.name;
+  }
+  const modeId = v.variableCollectionId === base.id ? brandMode.modeId
+    : v.variableCollectionId === theme.id ? themeMode : Object.keys(v.valuesByMode)[0];
+  const val = v.valuesByMode[modeId] ?? Object.values(v.valuesByMode)[0];
+  if (isAlias(val)) return resolve(await figma.variables.getVariableByIdAsync(val.id), themeMode);
+  return literal(v, val);
+}
+
+const modes = {};
+for (const m of theme.modes) {
+  const roles = {};
+  for (const id of theme.variableIds) {
+    const v = await figma.variables.getVariableByIdAsync(id);
+    roles[v.name] = await resolve(v, m.modeId);
+  }
+  modes[m.name] = roles;
+}
+const sorted = Object.fromEntries(Object.entries(primitives).sort(([a], [b]) => a.localeCompare(b)));
+return { $schema: "rds-brand-table/1", name: BRAND, primitives: sorted, modes };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rojaostudio/ds-core",
-  "version": "1.1.0-next.0",
+  "version": "1.1.0-next.2",
   "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)",
@@ -54,7 +54,8 @@
   "files": [
     "LICENSE",
     "README.md",
-    "dist"
+    "dist",
+    "figma/export-brand.js"
   ],
   "devDependencies": {
     "eslint": "^9.18.0",
@@ -68,7 +69,7 @@
   "publishConfig": {
     "registry": "https://registry.npmjs.org",
     "access": "public",
-    "provenance": false
+    "provenance": true
   },
   "scripts": {
     "build": "tsup",