@cavuno/board 2.0.5 → 3.1.0

package/dist/theme.d.mts

@@ -1,115 +0,0 @@
-/**
- * `@cavuno/board/theme` — board theme → shadcn CSS-variable overrides
- *.
- *
- * The board's stored theme (16 semantic colors × light/dark from
- * `board.context().theme`) is mapped onto the canonical shadcn token
- * vocabulary and emitted as overrides of the app's theme block. One
- * contract, two consumers: the dashboard edits the board theme, and agents
- * restyle through the standard shadcn theme file — both end up in the same
- * tokens. The hosted board renders the same 16 source colors through its
- * own token system; a coverage golden  asserts neither side
- * silently drops a color key.
- *
- * A null theme emits nothing — the app's static default theme applies
- * untouched.
- */
-/** The 16 board color keys (the wire ships them as an open record). */
-declare const BOARD_COLOR_KEYS: readonly ["brandColor", "buttonPrimary", "buttonPrimaryText", "buttonDanger", "background", "surfaceBackground", "mutedBackground", "highlightBackground", "text", "textSubtle", "textMuted", "textDisabled", "textError", "border", "contrastBackground", "contrastText"];
-type BoardColorKey = (typeof BOARD_COLOR_KEYS)[number];
-/**
- * Structural input — satisfied by the SDK's `PublicBoardTheme` (whose color
- * records are open on the wire) and any narrowed server copy.
- */
-interface ThemeInput {
-    mode: string;
-    schemeId: string;
-    typography: {
-        fontSans: string;
-        fontHeading?: string | null;
-    };
-    colors: {
-        light?: Record<string, unknown>;
-        dark?: Record<string, unknown>;
-    };
-}
-/**
- * True when `value` is safe to emit inside a `<style>` CSS declaration — i.e.
- * carries none of the breakout characters above. Shared by the SDK render sink
- * (`boardThemeToCss`) and the hosted public-API serializer, so the denylist
- * lives in exactly one place.
- */
-declare function isSafeThemeColorValue(value: string): boolean;
-/**
- * Email-safe snapshot keys.
- * Light-only subset consumed by server-rendered 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 —
- * 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 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 (without `--`) backed by optional color tokens.
- * A starter may omit these declarations; required declarations must still
- * be present.
- */
-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.
- *
- * @example
- * const css = boardThemeToCss((await board.context()).theme);
- */
-declare function boardThemeToCss(theme: ThemeInput | null): string;
-/** The board's color-scheme preference; unknown/absent → `system`. */
-declare function themeMode(theme: ThemeInput | null): 'light' | 'dark' | 'system';
-/**
- * Theme font key → Google Fonts family slug, transcribed from the hosted
- * board's `theme-fonts-metadata.ts` (tested against it). The wire's
- * `typography.fontSans` is an internal KEY (`'source-sans-pro'`), and the
- * Google family is not always a re-casing of it (`source-sans-pro` →
- * `Source+Sans+3`) — never build a font request from the raw key.
- */
-declare const THEME_FONT_GOOGLE_FAMILIES: Record<string, string>;
-/**
- * The CSS `font-family` name the Google stylesheet registers for a font key
- * — the name `--font-sans` must reference for the loaded font to apply
- * (e.g. `'source-sans-pro'` → `"Source Sans 3"`).
- */
-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, 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

@@ -1,115 +0,0 @@
-/**
- * `@cavuno/board/theme` — board theme → shadcn CSS-variable overrides
- *.
- *
- * The board's stored theme (16 semantic colors × light/dark from
- * `board.context().theme`) is mapped onto the canonical shadcn token
- * vocabulary and emitted as overrides of the app's theme block. One
- * contract, two consumers: the dashboard edits the board theme, and agents
- * restyle through the standard shadcn theme file — both end up in the same
- * tokens. The hosted board renders the same 16 source colors through its
- * own token system; a coverage golden  asserts neither side
- * silently drops a color key.
- *
- * A null theme emits nothing — the app's static default theme applies
- * untouched.
- */
-/** The 16 board color keys (the wire ships them as an open record). */
-declare const BOARD_COLOR_KEYS: readonly ["brandColor", "buttonPrimary", "buttonPrimaryText", "buttonDanger", "background", "surfaceBackground", "mutedBackground", "highlightBackground", "text", "textSubtle", "textMuted", "textDisabled", "textError", "border", "contrastBackground", "contrastText"];
-type BoardColorKey = (typeof BOARD_COLOR_KEYS)[number];
-/**
- * Structural input — satisfied by the SDK's `PublicBoardTheme` (whose color
- * records are open on the wire) and any narrowed server copy.
- */
-interface ThemeInput {
-    mode: string;
-    schemeId: string;
-    typography: {
-        fontSans: string;
-        fontHeading?: string | null;
-    };
-    colors: {
-        light?: Record<string, unknown>;
-        dark?: Record<string, unknown>;
-    };
-}
-/**
- * True when `value` is safe to emit inside a `<style>` CSS declaration — i.e.
- * carries none of the breakout characters above. Shared by the SDK render sink
- * (`boardThemeToCss`) and the hosted public-API serializer, so the denylist
- * lives in exactly one place.
- */
-declare function isSafeThemeColorValue(value: string): boolean;
-/**
- * Email-safe snapshot keys.
- * Light-only subset consumed by server-rendered 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 —
- * 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 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 (without `--`) backed by optional color tokens.
- * A starter may omit these declarations; required declarations must still
- * be present.
- */
-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.
- *
- * @example
- * const css = boardThemeToCss((await board.context()).theme);
- */
-declare function boardThemeToCss(theme: ThemeInput | null): string;
-/** The board's color-scheme preference; unknown/absent → `system`. */
-declare function themeMode(theme: ThemeInput | null): 'light' | 'dark' | 'system';
-/**
- * Theme font key → Google Fonts family slug, transcribed from the hosted
- * board's `theme-fonts-metadata.ts` (tested against it). The wire's
- * `typography.fontSans` is an internal KEY (`'source-sans-pro'`), and the
- * Google family is not always a re-casing of it (`source-sans-pro` →
- * `Source+Sans+3`) — never build a font request from the raw key.
- */
-declare const THEME_FONT_GOOGLE_FAMILIES: Record<string, string>;
-/**
- * The CSS `font-family` name the Google stylesheet registers for a font key
- * — the name `--font-sans` must reference for the loaded font to apply
- * (e.g. `'source-sans-pro'` → `"Source Sans 3"`).
- */
-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, 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

@@ -1,195 +0,0 @@
-"use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-
-// src/theme/index.ts
-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
-});
-module.exports = __toCommonJS(theme_exports);
-var BOARD_COLOR_KEYS = [
-  "brandColor",
-  "buttonPrimary",
-  "buttonPrimaryText",
-  "buttonDanger",
-  "background",
-  "surfaceBackground",
-  "mutedBackground",
-  "highlightBackground",
-  "text",
-  "textSubtle",
-  "textMuted",
-  "textDisabled",
-  "textError",
-  "border",
-  "contrastBackground",
-  "contrastText"
-];
-var CSS_INJECTION_CHARS = /[<>{};]|[\u0000-\u001f\u007f-\u009f\u2028\u2029]/;
-function isSafeThemeColorValue(value) {
-  return !CSS_INJECTION_CHARS.test(value);
-}
-function color(colors, key) {
-  const value = 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.
-  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};`);
-  };
-  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) {
-  if (!theme) return "";
-  const light = tokenLines(theme.colors.light ?? {});
-  const dark = tokenLines(theme.colors.dark ?? {});
-  const fontSans = theme.typography?.fontSans;
-  const genericStack = "ui-sans-serif, system-ui, sans-serif";
-  const sansStack = fontSans ? `'${themeFontFamily(fontSans)}', ${genericStack}` : genericStack;
-  if (fontSans) {
-    light.push(`  --font-sans: ${sansStack};`);
-  }
-  const fontHeading = theme.typography?.fontHeading;
-  if (fontHeading) {
-    light.push(
-      `  --font-heading: '${themeFontFamily(fontHeading)}', ${sansStack};`
-    );
-  }
-  const blocks = [];
-  if (light.length > 0) blocks.push(`:root {
-${light.join("\n")}
-}`);
-  if (dark.length > 0) blocks.push(`.dark {
-${dark.join("\n")}
-}`);
-  return blocks.join("\n\n");
-}
-function themeMode(theme) {
-  if (!theme) return "system";
-  return theme.mode === "light" || theme.mode === "dark" ? theme.mode : "system";
-}
-var THEME_FONT_GOOGLE_FAMILIES = {
-  "be-vietnam-pro": "Be+Vietnam+Pro",
-  inter: "Inter",
-  "plus-jakarta-sans": "Plus+Jakarta+Sans",
-  "dm-sans": "DM+Sans",
-  "public-sans": "Public+Sans",
-  figtree: "Figtree",
-  "work-sans": "Work+Sans",
-  "open-sans": "Open+Sans",
-  poppins: "Poppins",
-  hind: "Hind",
-  lexend: "Lexend",
-  "fira-sans": "Fira+Sans",
-  manrope: "Manrope",
-  "source-sans-pro": "Source+Sans+3",
-  outfit: "Outfit",
-  "space-grotesk": "Space+Grotesk",
-  geist: "Geist",
-  "source-serif-4": "Source+Serif+4",
-  lora: "Lora",
-  "crimson-pro": "Crimson+Pro"
-};
-function googleFamily(fontKey) {
-  return THEME_FONT_GOOGLE_FAMILIES[fontKey] ?? encodeURIComponent(fontKey).replaceAll("%20", "+");
-}
-function themeFontFamily(fontKey) {
-  return googleFamily(fontKey).replaceAll("+", " ");
-}
-function googleFontsUrl(theme) {
-  if (!theme) return null;
-  const families = /* @__PURE__ */ new Set();
-  if (theme.typography?.fontSans) {
-    families.add(googleFamily(theme.typography.fontSans));
-  }
-  if (theme.typography?.fontHeading) {
-    families.add(googleFamily(theme.typography.fontHeading));
-  }
-  if (families.size === 0) return null;
-  const params = [...families].map((f) => `family=${f}:wght@400;500;600;700`).join("&");
-  return `https://fonts.googleapis.com/css2?${params}&display=swap`;
-}

package/dist/theme.mjs

@@ -1,174 +0,0 @@
-// src/theme/index.ts
-var BOARD_COLOR_KEYS = [
-  "brandColor",
-  "buttonPrimary",
-  "buttonPrimaryText",
-  "buttonDanger",
-  "background",
-  "surfaceBackground",
-  "mutedBackground",
-  "highlightBackground",
-  "text",
-  "textSubtle",
-  "textMuted",
-  "textDisabled",
-  "textError",
-  "border",
-  "contrastBackground",
-  "contrastText"
-];
-var CSS_INJECTION_CHARS = /[<>{};]|[\u0000-\u001f\u007f-\u009f\u2028\u2029]/;
-function isSafeThemeColorValue(value) {
-  return !CSS_INJECTION_CHARS.test(value);
-}
-function color(colors, key) {
-  const value = 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.
-  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};`);
-  };
-  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) {
-  if (!theme) return "";
-  const light = tokenLines(theme.colors.light ?? {});
-  const dark = tokenLines(theme.colors.dark ?? {});
-  const fontSans = theme.typography?.fontSans;
-  const genericStack = "ui-sans-serif, system-ui, sans-serif";
-  const sansStack = fontSans ? `'${themeFontFamily(fontSans)}', ${genericStack}` : genericStack;
-  if (fontSans) {
-    light.push(`  --font-sans: ${sansStack};`);
-  }
-  const fontHeading = theme.typography?.fontHeading;
-  if (fontHeading) {
-    light.push(
-      `  --font-heading: '${themeFontFamily(fontHeading)}', ${sansStack};`
-    );
-  }
-  const blocks = [];
-  if (light.length > 0) blocks.push(`:root {
-${light.join("\n")}
-}`);
-  if (dark.length > 0) blocks.push(`.dark {
-${dark.join("\n")}
-}`);
-  return blocks.join("\n\n");
-}
-function themeMode(theme) {
-  if (!theme) return "system";
-  return theme.mode === "light" || theme.mode === "dark" ? theme.mode : "system";
-}
-var THEME_FONT_GOOGLE_FAMILIES = {
-  "be-vietnam-pro": "Be+Vietnam+Pro",
-  inter: "Inter",
-  "plus-jakarta-sans": "Plus+Jakarta+Sans",
-  "dm-sans": "DM+Sans",
-  "public-sans": "Public+Sans",
-  figtree: "Figtree",
-  "work-sans": "Work+Sans",
-  "open-sans": "Open+Sans",
-  poppins: "Poppins",
-  hind: "Hind",
-  lexend: "Lexend",
-  "fira-sans": "Fira+Sans",
-  manrope: "Manrope",
-  "source-sans-pro": "Source+Sans+3",
-  outfit: "Outfit",
-  "space-grotesk": "Space+Grotesk",
-  geist: "Geist",
-  "source-serif-4": "Source+Serif+4",
-  lora: "Lora",
-  "crimson-pro": "Crimson+Pro"
-};
-function googleFamily(fontKey) {
-  return THEME_FONT_GOOGLE_FAMILIES[fontKey] ?? encodeURIComponent(fontKey).replaceAll("%20", "+");
-}
-function themeFontFamily(fontKey) {
-  return googleFamily(fontKey).replaceAll("+", " ");
-}
-function googleFontsUrl(theme) {
-  if (!theme) return null;
-  const families = /* @__PURE__ */ new Set();
-  if (theme.typography?.fontSans) {
-    families.add(googleFamily(theme.typography.fontSans));
-  }
-  if (theme.typography?.fontHeading) {
-    families.add(googleFamily(theme.typography.fontHeading));
-  }
-  if (families.size === 0) return null;
-  const params = [...families].map((f) => `family=${f}:wght@400;500;600;700`).join("&");
-  return `https://fonts.googleapis.com/css2?${params}&display=swap`;
-}
-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/skills/cavuno-board-client/SKILL.md

@@ -1,89 +0,0 @@
----
-name: cavuno-board-client
-description: Create and configure the @cavuno/board client — the pk_ board identifier, optional API-origin override, global headers, hooks, per-call FetchOptions, and the rule that keeps one shared instance safe under SSR.
----
-
-# The Board API client
-
-`createBoardClient` returns a typed client whose namespaces (`jobs`, `companies`, `blog`, `auth`, `me`, …) all route through one request pipeline: board-identifier base path, default headers, bearer token from storage, and your hooks.
-
-## When to use
-
-- Creating the client instance your whole app shares.
-- Adding global headers, logging, request/response hooks, or framework caching.
-- Calling an endpoint the SDK doesn't expose yet (`client.fetch`).
-
-## When not to use
-
-- Per-surface usage (listing jobs, auth) — see the surface skills; they assume the client exists.
-
-## Create the client
-
-```ts
-import { createBoardClient } from '@cavuno/board';
-
-const board = createBoardClient({
-  board: 'pk_a8f3...', // pk_ key (preferred) | boards_ id | slug
-});
-```
-
-Use the `pk_…` publishable key for `board`, not the slug: the slug is operator-mutable and renames break deployed frontends. The `pk_…` key is immutable and client-safe.
-
-## Configuration
-
-```ts no-check
-const board = createBoardClient({
-  board: process.env.PUBLIC_CAVUNO_BOARD!,
-  globalHeaders: { 'Accept-Language': 'en' },
-  onRequest: async (req) => req,          // mutate/replace the request (locale, URL rewrite)
-  onResponse: async (res, req) => {},     // side effects only (logging, analytics)
-  logger: console,
-  auth: { storage: 'memory' },            // see cavuno-board-auth
-});
-```
-
-The `onRequest`/`onResponse` hooks are first-class — do not monkey-patch the client. `onResponse` receives a **clone** of the response, so reading its body never disturbs the SDK's own parsing.
-
-## Per-call FetchOptions ride straight to fetch
-
-Every method takes a trailing `options?` of type `FetchOptions` (`Omit<RequestInit,'body'>` plus `query`). Anything besides `body`/`query` passes through to `fetch` untouched, so framework caching works with zero SDK knowledge:
-
-```ts snippet
-// Next.js ISR
-await board.jobs.list({ limit: 20 }, { next: { revalidate: 60, tags: ['jobs'] } });
-// Cloudflare Workers
-await board.jobs.list({ limit: 20 }, { cf: { cacheTtl: 60 } } as never);
-// Standard fetch + abort
-const ac = new AbortController();
-await board.jobs.list({ limit: 20 }, { cache: 'force-cache', signal: ac.signal });
-```
-
-## One shared instance is SSR-safe — if state stays per-call
-
-A single Workers isolate serves many users at once. A module-scoped client is safe **only** while per-user state is passed per call (`options.headers`), not stored on the instance. For browser/SPA usage, the instance may hold the session (`auth.storage`); for SSR, keep the session in an httpOnly cookie and pass `{ headers: { authorization } }` per call (see `cavuno-board-auth`).
-
-```ts
-import { createBoardClient } from '@cavuno/board';
-
-// Safe: shared, stateless. Per-user token rides per call.
-export const board = createBoardClient({
-  board: process.env.PUBLIC_CAVUNO_BOARD!,
-});
-```
-
-## Escape hatch: client.fetch
-
-`board.client.fetch<T>(path, init)` is public and first-class — it runs the full pipeline (base path, headers, token, hooks), not a raw `fetch`. Use it to call an endpoint before the SDK ships a typed method for it:
-
-```ts snippet
-const data = await board.client.fetch<{ object: 'list'; data: unknown[] }>(
-  '/some-new-endpoint',
-  { query: { limit: 5 } });
-```
-
-## Checklist
-
-- [ ] One client created from env values, reused everywhere.
-- [ ] `board` is the `pk_…` key, not the slug.
-- [ ] No per-user state on a shared SSR instance.
-- [ ] Caching done via per-call `FetchOptions`, not a wrapper.