@cavuno/board 1.39.0 → 1.40.0

package/dist/theme.d.ts

@@ -40,6 +40,54 @@ interface ThemeInput {
  * lives in exactly one place.
  */
 declare function isSafeThemeColorValue(value: string): boolean;
+/**
+ * Email-safe snapshot keys (platform brand snapshot / MIG-04).
+ * Light-only subset consumed by Convex email branding.
+ */
+type EmailSafeSnapshotColorKey = 'buttonPrimary' | 'buttonPrimaryText' | 'background' | 'mutedBackground' | 'border' | 'text' | 'textMuted' | 'brandColor';
+/**
+ * Inverse of the email-safe subset of `tokenLines`: for each snapshot
+ * color key, the ordered list of CSS custom property names (no `--`)
+ * that may supply it. First PRESENT property wins when DIFFERENT CSS
+ * names map to one snapshot key (e.g. muted > secondary for
+ * mutedBackground). Within one CSS property name, multi-`:root` cascade
+ * is last-wins and is resolved before this table is consulted.
+ *
+ * Additive export for the platform brand-snapshot deriver (MIG-04) —
+ * keeps the CSS ↔ board contract next to its forward twin.
+ */
+declare const EMAIL_SAFE_SNAPSHOT_FROM_CSS: {
+    readonly [K in EmailSafeSnapshotColorKey]: readonly string[];
+};
+/**
+ * Board key → CSS custom property name(s) (no `--` prefix).
+ *
+ * The forward write contract for the builder theme tab (MIG-05) and the
+ * emission table for `boardThemeToCss` / `tokenLines` — one table, so a
+ * tab edit and a render path cannot drift. When a board key fans out to
+ * several CSS names (e.g. `text` → foreground + card-foreground + …),
+ * a single tab edit writes every name with the same hex value.
+ *
+ * Fallbacks that only apply at *emit* time when a preferred key is
+ * absent (`destructive` ← buttonDanger ?? textError; `ring` ← brandColor
+ * ?? buttonPrimary) stay in `tokenLines` — they are not owned write
+ * targets of the fallback key.
+ */
+declare const BOARD_COLOR_TO_CSS_TOKENS: {
+    readonly [K in BoardColorKey]: readonly string[];
+};
+/**
+ * CSS custom property names (no `--`) that fan out from *optional*
+ * ColorTokensSchema keys (`textSubtle`, `textDisabled`). Production
+ * starter `tokens.css` may omit these declarations; the builder theme
+ * batch lane SKIPS missing optional declarations rather than escalating
+ * the whole preset to the model (MIG-05). Required declarations still
+ * escalate on absence — never invent (L5-B).
+ */
+declare const OPTIONAL_THEME_DECLARATIONS: readonly ["foreground-subtle", "foreground-disabled"];
+type OptionalThemeDeclaration = (typeof OPTIONAL_THEME_DECLARATIONS)[number];
+/** True when a CSS custom property name (with or without `--`) is optional. */
+declare function isOptionalThemeDeclaration(token: string): boolean;
 /**
  * Render the board theme as `:root` (+ `.dark`) CSS-variable overrides.
  * Inject once at the app shell, after the static theme stylesheet.
@@ -67,4 +115,4 @@ declare function themeFontFamily(fontKey: string): string;
 /** One Google Fonts request covering the sans + heading families. */
 declare function googleFontsUrl(theme: ThemeInput | null): string | null;
 
-export { BOARD_COLOR_KEYS, type BoardColorKey, THEME_FONT_GOOGLE_FAMILIES, type ThemeInput, boardThemeToCss, googleFontsUrl, isSafeThemeColorValue, themeFontFamily, themeMode };
+export { BOARD_COLOR_KEYS, BOARD_COLOR_TO_CSS_TOKENS, type BoardColorKey, EMAIL_SAFE_SNAPSHOT_FROM_CSS, type EmailSafeSnapshotColorKey, OPTIONAL_THEME_DECLARATIONS, type OptionalThemeDeclaration, THEME_FONT_GOOGLE_FAMILIES, type ThemeInput, boardThemeToCss, googleFontsUrl, isOptionalThemeDeclaration, isSafeThemeColorValue, themeFontFamily, themeMode };

package/dist/theme.js

@@ -21,9 +21,13 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var theme_exports = {};
 __export(theme_exports, {
   BOARD_COLOR_KEYS: () => BOARD_COLOR_KEYS,
+  BOARD_COLOR_TO_CSS_TOKENS: () => BOARD_COLOR_TO_CSS_TOKENS,
+  EMAIL_SAFE_SNAPSHOT_FROM_CSS: () => EMAIL_SAFE_SNAPSHOT_FROM_CSS,
+  OPTIONAL_THEME_DECLARATIONS: () => OPTIONAL_THEME_DECLARATIONS,
   THEME_FONT_GOOGLE_FAMILIES: () => THEME_FONT_GOOGLE_FAMILIES,
   boardThemeToCss: () => boardThemeToCss,
   googleFontsUrl: () => googleFontsUrl,
+  isOptionalThemeDeclaration: () => isOptionalThemeDeclaration,
   isSafeThemeColorValue: () => isSafeThemeColorValue,
   themeFontFamily: () => themeFontFamily,
   themeMode: () => themeMode
@@ -56,37 +60,67 @@ function color(colors, key) {
   if (typeof value !== "string" || !value) return void 0;
   return isSafeThemeColorValue(value) ? value : void 0;
 }
+var EMAIL_SAFE_SNAPSHOT_FROM_CSS = {
+  buttonPrimary: ["primary"],
+  buttonPrimaryText: ["primary-foreground"],
+  background: ["background"],
+  // muted wins; secondary fills only when --muted is absent (A3).
+  mutedBackground: ["muted", "secondary"],
+  border: ["border"],
+  text: ["foreground"],
+  textMuted: ["muted-foreground"],
+  brandColor: ["ring"]
+};
+var BOARD_COLOR_TO_CSS_TOKENS = {
+  background: ["background"],
+  text: [
+    "foreground",
+    "card-foreground",
+    "popover-foreground",
+    "secondary-foreground",
+    "accent-foreground"
+  ],
+  surfaceBackground: ["card", "popover"],
+  mutedBackground: ["secondary", "muted"],
+  highlightBackground: ["accent"],
+  buttonPrimary: ["primary"],
+  buttonPrimaryText: ["primary-foreground"],
+  buttonDanger: ["destructive"],
+  textMuted: ["muted-foreground"],
+  border: ["border", "input"],
+  brandColor: ["ring"],
+  contrastBackground: ["contrast-background"],
+  contrastText: ["contrast-foreground"],
+  textSubtle: ["foreground-subtle"],
+  textDisabled: ["foreground-disabled"],
+  textError: ["foreground-error"]
+};
+var OPTIONAL_THEME_DECLARATIONS = [
+  "foreground-subtle",
+  "foreground-disabled"
+];
+function isOptionalThemeDeclaration(token) {
+  const name = token.startsWith("--") ? token.slice(2) : token;
+  return OPTIONAL_THEME_DECLARATIONS.includes(name);
+}
 function tokenLines(colors) {
   const lines = [];
   const set = (token, value) => {
     if (value) lines.push(`  --${token}: ${value};`);
   };
-  set("background", color(colors, "background"));
-  set("foreground", color(colors, "text"));
-  set("card", color(colors, "surfaceBackground"));
-  set("card-foreground", color(colors, "text"));
-  set("popover", color(colors, "surfaceBackground"));
-  set("popover-foreground", color(colors, "text"));
-  set("primary", color(colors, "buttonPrimary"));
-  set("primary-foreground", color(colors, "buttonPrimaryText"));
-  set("secondary", color(colors, "mutedBackground"));
-  set("secondary-foreground", color(colors, "text"));
-  set("muted", color(colors, "mutedBackground"));
-  set("muted-foreground", color(colors, "textMuted"));
-  set("accent", color(colors, "highlightBackground"));
-  set("accent-foreground", color(colors, "text"));
-  set(
-    "destructive",
-    color(colors, "buttonDanger") ?? color(colors, "textError")
-  );
-  set("border", color(colors, "border"));
-  set("input", color(colors, "border"));
-  set("ring", color(colors, "brandColor") ?? color(colors, "buttonPrimary"));
-  set("contrast-background", color(colors, "contrastBackground"));
-  set("contrast-foreground", color(colors, "contrastText"));
-  set("foreground-subtle", color(colors, "textSubtle"));
-  set("foreground-disabled", color(colors, "textDisabled"));
-  set("foreground-error", color(colors, "textError"));
+  for (const boardKey of BOARD_COLOR_KEYS) {
+    const value = color(colors, boardKey);
+    if (!value) continue;
+    for (const cssToken of BOARD_COLOR_TO_CSS_TOKENS[boardKey]) {
+      set(cssToken, value);
+    }
+  }
+  if (!color(colors, "buttonDanger") && color(colors, "textError")) {
+    set("destructive", color(colors, "textError"));
+  }
+  if (!color(colors, "brandColor") && color(colors, "buttonPrimary")) {
+    set("ring", color(colors, "buttonPrimary"));
+  }
   return lines;
 }
 function boardThemeToCss(theme) {

package/dist/theme.mjs

@@ -26,37 +26,67 @@ function color(colors, key) {
   if (typeof value !== "string" || !value) return void 0;
   return isSafeThemeColorValue(value) ? value : void 0;
 }
+var EMAIL_SAFE_SNAPSHOT_FROM_CSS = {
+  buttonPrimary: ["primary"],
+  buttonPrimaryText: ["primary-foreground"],
+  background: ["background"],
+  // muted wins; secondary fills only when --muted is absent (A3).
+  mutedBackground: ["muted", "secondary"],
+  border: ["border"],
+  text: ["foreground"],
+  textMuted: ["muted-foreground"],
+  brandColor: ["ring"]
+};
+var BOARD_COLOR_TO_CSS_TOKENS = {
+  background: ["background"],
+  text: [
+    "foreground",
+    "card-foreground",
+    "popover-foreground",
+    "secondary-foreground",
+    "accent-foreground"
+  ],
+  surfaceBackground: ["card", "popover"],
+  mutedBackground: ["secondary", "muted"],
+  highlightBackground: ["accent"],
+  buttonPrimary: ["primary"],
+  buttonPrimaryText: ["primary-foreground"],
+  buttonDanger: ["destructive"],
+  textMuted: ["muted-foreground"],
+  border: ["border", "input"],
+  brandColor: ["ring"],
+  contrastBackground: ["contrast-background"],
+  contrastText: ["contrast-foreground"],
+  textSubtle: ["foreground-subtle"],
+  textDisabled: ["foreground-disabled"],
+  textError: ["foreground-error"]
+};
+var OPTIONAL_THEME_DECLARATIONS = [
+  "foreground-subtle",
+  "foreground-disabled"
+];
+function isOptionalThemeDeclaration(token) {
+  const name = token.startsWith("--") ? token.slice(2) : token;
+  return OPTIONAL_THEME_DECLARATIONS.includes(name);
+}
 function tokenLines(colors) {
   const lines = [];
   const set = (token, value) => {
     if (value) lines.push(`  --${token}: ${value};`);
   };
-  set("background", color(colors, "background"));
-  set("foreground", color(colors, "text"));
-  set("card", color(colors, "surfaceBackground"));
-  set("card-foreground", color(colors, "text"));
-  set("popover", color(colors, "surfaceBackground"));
-  set("popover-foreground", color(colors, "text"));
-  set("primary", color(colors, "buttonPrimary"));
-  set("primary-foreground", color(colors, "buttonPrimaryText"));
-  set("secondary", color(colors, "mutedBackground"));
-  set("secondary-foreground", color(colors, "text"));
-  set("muted", color(colors, "mutedBackground"));
-  set("muted-foreground", color(colors, "textMuted"));
-  set("accent", color(colors, "highlightBackground"));
-  set("accent-foreground", color(colors, "text"));
-  set(
-    "destructive",
-    color(colors, "buttonDanger") ?? color(colors, "textError")
-  );
-  set("border", color(colors, "border"));
-  set("input", color(colors, "border"));
-  set("ring", color(colors, "brandColor") ?? color(colors, "buttonPrimary"));
-  set("contrast-background", color(colors, "contrastBackground"));
-  set("contrast-foreground", color(colors, "contrastText"));
-  set("foreground-subtle", color(colors, "textSubtle"));
-  set("foreground-disabled", color(colors, "textDisabled"));
-  set("foreground-error", color(colors, "textError"));
+  for (const boardKey of BOARD_COLOR_KEYS) {
+    const value = color(colors, boardKey);
+    if (!value) continue;
+    for (const cssToken of BOARD_COLOR_TO_CSS_TOKENS[boardKey]) {
+      set(cssToken, value);
+    }
+  }
+  if (!color(colors, "buttonDanger") && color(colors, "textError")) {
+    set("destructive", color(colors, "textError"));
+  }
+  if (!color(colors, "brandColor") && color(colors, "buttonPrimary")) {
+    set("ring", color(colors, "buttonPrimary"));
+  }
   return lines;
 }
 function boardThemeToCss(theme) {
@@ -131,9 +161,13 @@ function googleFontsUrl(theme) {
 }
 export {
   BOARD_COLOR_KEYS,
+  BOARD_COLOR_TO_CSS_TOKENS,
+  EMAIL_SAFE_SNAPSHOT_FROM_CSS,
+  OPTIONAL_THEME_DECLARATIONS,
   THEME_FONT_GOOGLE_FAMILIES,
   boardThemeToCss,
   googleFontsUrl,
+  isOptionalThemeDeclaration,
   isSafeThemeColorValue,
   themeFontFamily,
   themeMode

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cavuno/board",
-  "version": "1.39.0",
+  "version": "1.40.0",
   "description": "Typed isomorphic client for the Cavuno Board API",
   "license": "MIT",
   "type": "commonjs",

package/skills/manifest.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.39.0",
+  "version": "1.40.0",
   "skills": [
     {
       "name": "cavuno-board-account",