@cavuno/board 1.39.0 → 1.41.0

package/dist/server.d.ts

@@ -1,9 +1,9 @@
 import { BoardSdk } from './index.js';
-import './_spec-DxC1ze93.js';
-import './search-DBoMM-gE.js';
-import './board-RfZEAJse.js';
-import './jobs-CLLIvtMc.js';
-import './salaries-DK4RnJnw.js';
+import './_spec-l_596ZwW.js';
+import './search-DZrq-k76.js';
+import './board-BzK5j73O.js';
+import './jobs-CXudz1Y4.js';
+import './salaries-ByBuHCLH.js';
 
 /**
  * Session cookie codec — pure (no framework imports, no node imports) so it
@@ -77,6 +77,56 @@ declare function safeRedirectPath(path: string | undefined | null, defaultPath?:
  */
 declare function currentPathFromReferer(referer: string | null): string;
 
+/**
+ * MIG-10 (added scope) — keep `<slug>.cavuno.app` live after a custom-domain
+ * cutover by 308-redirecting to the board's canonical custom domain.
+ *
+ * ## Where this lives (DEVIATION LOUDLY)
+ * **Serving-side, not the dispatch edge.** Production hostname→worker
+ * routing is the WFP dispatch Worker's KV map (`hostname → workerName`
+ * only — see `docs/recipes/ops/wfp-dispatch-custom-domain.md` and
+ * `createWfpReleaseDeploy` / `deterministicWorkerName`). That edge has
+ * **no board domain data** (no Convex, no primaryDomain). Inventing a
+ * second edge datastore for canonical hosts is forbidden by the ticket.
+ *
+ * Data source: the board's public context already carries
+ * `primaryDomain: string | null` (`GET /v1/boards/:id` via
+ * `serializeBoardContext`). The starter loads context for every request
+ * (theme, features, analytics) — reuse that field. When `primaryDomain`
+ * is set, a request whose Host is a `*.cavuno.app` serving host 308s to
+ * `https://<primaryDomain><path+query>` in **one hop**. Domainless boards
+ * (`primaryDomain === null`) keep **serving** from cavuno.app (no redirect).
+ *
+ * Wire this helper into the starter's root middleware / entry (the
+ * migration starter's host check) with `Response.redirect(url, 308)`.
+ * Pure so unit tests pin behaviour without a Worker runtime.
+ *
+ * Pattern: Vercel `*.vercel.app` / GitHub `github.io` permanent fallback
+ * origin — SEO-neutral 308 to the canonical production host.
+ */
+/**
+ * True when the request host is a cavuno.app board-serving host
+ * (slug or board-hash subdomain), not the apex and not a preview host
+ * we deliberately leave alone.
+ */
+declare function isCavunoAppServingHost(hostname: string): boolean;
+/**
+ * When a custom-domain board is hit on its cavuno.app fallback origin,
+ * return the one-hop 308 Location to the canonical custom domain.
+ * Domainless boards (no primaryDomain) return null — serve in place.
+ */
+declare function getCavunoAppCanonicalRedirectUrl(params: {
+    currentHost: string | null;
+    /**
+     * From `board.context().primaryDomain` — the board's active primary
+     * custom domain hostname, or null when domainless.
+     */
+    primaryDomain: string | null | undefined;
+    /** Full request URL or path+query; path+query is preserved on the hop. */
+    requestUrl?: string | null;
+    defaultPath?: string;
+}): string | null;
+
 /**
  * Single-flight session refresh — dedupes concurrent refreshes for the same
  * session WITHIN one process/isolate (the rotation race, ADR-0057 wart #4,
@@ -111,4 +161,4 @@ declare function currentPathFromReferer(referer: string | null): string;
  */
 declare function createSessionRefresher(board: Pick<BoardSdk, 'auth' | 'client'>): (session: BoardSession) => Promise<BoardSession | null>;
 
-export { BOARD_ACCESS_COOKIE_NAME, type BoardSession, SESSION_COOKIE_NAME, clearGrantCookie, clearSessionCookie, createSessionRefresher, currentPathFromReferer, grantCookieName, isExpiringSoon, parseGrantCookie, parseSessionCookie, safeRedirectPath, serializeGrantCookie, serializeSessionCookie, sessionCookieName };
+export { BOARD_ACCESS_COOKIE_NAME, type BoardSession, SESSION_COOKIE_NAME, clearGrantCookie, clearSessionCookie, createSessionRefresher, currentPathFromReferer, getCavunoAppCanonicalRedirectUrl, grantCookieName, isCavunoAppServingHost, isExpiringSoon, parseGrantCookie, parseSessionCookie, safeRedirectPath, serializeGrantCookie, serializeSessionCookie, sessionCookieName };

package/dist/server.js

@@ -26,7 +26,9 @@ __export(server_exports, {
   clearSessionCookie: () => clearSessionCookie,
   createSessionRefresher: () => createSessionRefresher,
   currentPathFromReferer: () => currentPathFromReferer,
+  getCavunoAppCanonicalRedirectUrl: () => getCavunoAppCanonicalRedirectUrl,
   grantCookieName: () => grantCookieName,
+  isCavunoAppServingHost: () => isCavunoAppServingHost,
   isExpiringSoon: () => isExpiringSoon,
   parseGrantCookie: () => parseGrantCookie,
   parseSessionCookie: () => parseSessionCookie,
@@ -154,6 +156,45 @@ function currentPathFromReferer(referer) {
   }
 }
 
+// src/server/canonical-host-redirect.ts
+var CAVUNO_APP_SERVING_SUFFIX = ".cavuno.app";
+function normalizeHostname(host) {
+  if (!host) return "";
+  return host.toLowerCase().split(":")[0] ?? "";
+}
+function extractPathAndSearch(url) {
+  if (!url) return "/";
+  try {
+    const parsed = new URL(url, "https://placeholder.invalid");
+    return `${parsed.pathname}${parsed.search}` || "/";
+  } catch {
+    return "/";
+  }
+}
+function isCavunoAppServingHost(hostname) {
+  const h = hostname.toLowerCase();
+  if (!h.endsWith(CAVUNO_APP_SERVING_SUFFIX)) return false;
+  if (h === "cavuno.app") return false;
+  if (h.startsWith("preview-")) return false;
+  return true;
+}
+function getCavunoAppCanonicalRedirectUrl(params) {
+  const { currentHost, primaryDomain, requestUrl, defaultPath = "/" } = params;
+  const canonical = primaryDomain?.trim().toLowerCase().replace(/\.+$/, "");
+  if (!canonical) {
+    return null;
+  }
+  const hostname = normalizeHostname(currentHost);
+  if (!hostname || !isCavunoAppServingHost(hostname)) {
+    return null;
+  }
+  if (hostname === canonical) {
+    return null;
+  }
+  const path = requestUrl != null && requestUrl !== "" ? extractPathAndSearch(requestUrl) : defaultPath;
+  return `https://${canonical}${path.startsWith("/") ? path : `/${path}`}`;
+}
+
 // src/errors.ts
 function isBoardApiError(e) {
   return e instanceof Error && e.name === "BoardApiError" && typeof e.status === "number" && typeof e.code === "string";

package/dist/server.mjs

@@ -115,6 +115,45 @@ function currentPathFromReferer(referer) {
   }
 }
 
+// src/server/canonical-host-redirect.ts
+var CAVUNO_APP_SERVING_SUFFIX = ".cavuno.app";
+function normalizeHostname(host) {
+  if (!host) return "";
+  return host.toLowerCase().split(":")[0] ?? "";
+}
+function extractPathAndSearch(url) {
+  if (!url) return "/";
+  try {
+    const parsed = new URL(url, "https://placeholder.invalid");
+    return `${parsed.pathname}${parsed.search}` || "/";
+  } catch {
+    return "/";
+  }
+}
+function isCavunoAppServingHost(hostname) {
+  const h = hostname.toLowerCase();
+  if (!h.endsWith(CAVUNO_APP_SERVING_SUFFIX)) return false;
+  if (h === "cavuno.app") return false;
+  if (h.startsWith("preview-")) return false;
+  return true;
+}
+function getCavunoAppCanonicalRedirectUrl(params) {
+  const { currentHost, primaryDomain, requestUrl, defaultPath = "/" } = params;
+  const canonical = primaryDomain?.trim().toLowerCase().replace(/\.+$/, "");
+  if (!canonical) {
+    return null;
+  }
+  const hostname = normalizeHostname(currentHost);
+  if (!hostname || !isCavunoAppServingHost(hostname)) {
+    return null;
+  }
+  if (hostname === canonical) {
+    return null;
+  }
+  const path = requestUrl != null && requestUrl !== "" ? extractPathAndSearch(requestUrl) : defaultPath;
+  return `https://${canonical}${path.startsWith("/") ? path : `/${path}`}`;
+}
+
 // src/errors.ts
 function isBoardApiError(e) {
   return e instanceof Error && e.name === "BoardApiError" && typeof e.status === "number" && typeof e.code === "string";
@@ -172,7 +211,9 @@ export {
   clearSessionCookie,
   createSessionRefresher,
   currentPathFromReferer,
+  getCavunoAppCanonicalRedirectUrl,
   grantCookieName,
+  isCavunoAppServingHost,
   isExpiringSoon,
   parseGrantCookie,
   parseSessionCookie,

package/dist/sitemap.d.mts

@@ -1,9 +1,9 @@
 import { BoardSdk } from './index.mjs';
-import './_spec-DxC1ze93.mjs';
-import './search-CqBa1Qc4.mjs';
-import './board-CqYibYUA.mjs';
-import './jobs-DPPA1Nev.mjs';
-import './salaries-Rb5h_eVZ.mjs';
+import './_spec-l_596ZwW.mjs';
+import './search-CrIlXSJP.mjs';
+import './board-CyHA6rRP.mjs';
+import './jobs-BhthvMkA.mjs';
+import './salaries-Dr_Zugal.mjs';
 
 /**
  * Sitemap primitives — the pure XML + bucket-filename logic behind a board

package/dist/sitemap.d.ts

@@ -1,9 +1,9 @@
 import { BoardSdk } from './index.js';
-import './_spec-DxC1ze93.js';
-import './search-DBoMM-gE.js';
-import './board-RfZEAJse.js';
-import './jobs-CLLIvtMc.js';
-import './salaries-DK4RnJnw.js';
+import './_spec-l_596ZwW.js';
+import './search-DZrq-k76.js';
+import './board-BzK5j73O.js';
+import './jobs-CXudz1Y4.js';
+import './salaries-ByBuHCLH.js';
 
 /**
  * Sitemap primitives — the pure XML + bucket-filename logic behind a board

package/dist/suggest.d.mts

@@ -1,5 +1,5 @@
-import { S as SuggestionItem, a as SearchSuggestQuery, F as FetchOptions, b as SuggestResult } from './search-CqBa1Qc4.mjs';
-import './_spec-DxC1ze93.mjs';
+import { S as SuggestionItem, a as SearchSuggestQuery, F as FetchOptions, b as SuggestResult } from './search-CrIlXSJP.mjs';
+import './_spec-l_596ZwW.mjs';
 
 /**
  * `@cavuno/board/suggest` — framework-agnostic headless search-suggest

package/dist/suggest.d.ts

@@ -1,5 +1,5 @@
-import { S as SuggestionItem, a as SearchSuggestQuery, F as FetchOptions, b as SuggestResult } from './search-DBoMM-gE.js';
-import './_spec-DxC1ze93.js';
+import { S as SuggestionItem, a as SearchSuggestQuery, F as FetchOptions, b as SuggestResult } from './search-DZrq-k76.js';
+import './_spec-l_596ZwW.js';
 
 /**
  * `@cavuno/board/suggest` — framework-agnostic headless search-suggest

package/dist/theme.d.mts

@@ -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.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.41.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.41.0",
   "skills": [
     {
       "name": "cavuno-board-account",