@nimblebrain/synapse 0.12.1 → 0.13.0

package/dist/chunk-DOKVNVTI.js

@@ -0,0 +1,162 @@
+// src/theme-defaults.ts
+var FONT_DISPLAY_VALUES = /* @__PURE__ */ new Set([
+  "auto",
+  "block",
+  "swap",
+  "fallback",
+  "optional"
+]);
+var LIGHT = {
+  // ── Surfaces ──
+  "--color-background-primary": "#ffffff",
+  "--color-background-secondary": "#fafafa",
+  "--color-background-tertiary": "#f3f4f6",
+  // ── Text ──
+  "--color-text-primary": "#111827",
+  "--color-text-secondary": "#6b7280",
+  "--color-text-tertiary": "#9ca3af",
+  "--color-text-accent": "#2563eb",
+  "--nb-color-accent-foreground": "#ffffff",
+  // ── Border / ring ──
+  "--color-border-primary": "#e5e7eb",
+  "--color-border-secondary": "#d1d5db",
+  "--color-ring-primary": "#2563eb",
+  // ── Status / brand semantics ──
+  "--nb-color-danger": "#dc2626",
+  "--nb-color-success": "#059669",
+  "--nb-color-warning": "#f59e0b",
+  "--nb-color-warm": "#d4620a",
+  "--nb-color-warm-light": "#fef5ee",
+  "--nb-color-processing": "#7c3aed",
+  "--nb-color-processing-light": "#f3eeff",
+  "--nb-color-info-light": "#eef4ff"
+};
+var DARK = {
+  // ── Surfaces (base → lifted) ──
+  "--color-background-primary": "#18181b",
+  "--color-background-secondary": "#27272a",
+  "--color-background-tertiary": "#2f2f34",
+  // ── Text ──
+  "--color-text-primary": "#fafafa",
+  "--color-text-secondary": "#a1a1aa",
+  "--color-text-tertiary": "#71717a",
+  "--color-text-accent": "#818cf8",
+  "--nb-color-accent-foreground": "#ffffff",
+  // ── Border / ring (lighter than surfaces so they remain visible) ──
+  "--color-border-primary": "#3f3f46",
+  "--color-border-secondary": "#52525b",
+  "--color-ring-primary": "#818cf8",
+  // ── Status / brand semantics (brightened for contrast on dark) ──
+  "--nb-color-danger": "#f87171",
+  "--nb-color-success": "#34d399",
+  "--nb-color-warning": "#fbbf24",
+  "--nb-color-warm": "#fb923c",
+  "--nb-color-warm-light": "#3a2a1e",
+  "--nb-color-processing": "#a78bfa",
+  "--nb-color-processing-light": "#2a2440",
+  "--nb-color-info-light": "#1e2a44"
+};
+var DEFAULT_THEME_VARS = {
+  light: LIGHT,
+  dark: DARK
+};
+function applyThemeVariables(mode, hostVars) {
+  if (typeof document === "undefined") return;
+  const root = document.documentElement.style;
+  for (const [k, v] of Object.entries(DEFAULT_THEME_VARS[mode])) {
+    root.setProperty(k, v);
+  }
+  if (hostVars && typeof hostVars === "object") {
+    for (const [k, v] of Object.entries(hostVars)) {
+      if (typeof k === "string" && typeof v === "string") {
+        root.setProperty(k, v);
+      }
+    }
+  }
+}
+var managedFaces = /* @__PURE__ */ new Set();
+var appliedFontKey = "";
+function fontFacesKey(faces) {
+  if (!Array.isArray(faces)) return "";
+  return JSON.stringify(faces.map((d) => [d.family, d.src, d.weight, d.style, d.display]));
+}
+function normalizeFontFaces(raw) {
+  if (!Array.isArray(raw)) return void 0;
+  const usable = raw.filter(isFontFaceDescriptor);
+  if (raw.length > 0 && usable.length === 0) return void 0;
+  return usable;
+}
+function applyThemeFontFaces(faces) {
+  const next = normalizeFontFaces(faces);
+  if (next === void 0) return;
+  if (typeof document === "undefined") return;
+  if (!document.fonts || typeof FontFace === "undefined") return;
+  const key = fontFacesKey(next);
+  if (key === appliedFontKey) return;
+  appliedFontKey = key;
+  for (const face of managedFaces) {
+    try {
+      document.fonts.delete(face);
+    } catch {
+    }
+  }
+  managedFaces.clear();
+  for (const d of next) {
+    try {
+      const face = new FontFace(d.family, d.src, {
+        weight: d.weight,
+        style: d.style,
+        // Wire data is untyped: ignore an unrecognised `display` rather than let
+        // the constructor reject the descriptor and cost the app this face.
+        display: d.display && FONT_DISPLAY_VALUES.has(d.display) ? d.display : "swap"
+      });
+      document.fonts.add(face);
+      managedFaces.add(face);
+    } catch {
+    }
+  }
+}
+function isFontFaceDescriptor(value) {
+  if (!value || typeof value !== "object") return false;
+  const d = value;
+  return typeof d.family === "string" && typeof d.src === "string";
+}
+function applyTheme(mode, hostVars, fontFaces) {
+  applyThemeVariables(mode, hostVars);
+  applyThemeFontFaces(fontFaces);
+}
+
+// src/detection.ts
+var FONT_FACES_CONTEXT_KEY = "synapse/fontFaces";
+var DEFAULT_THEME = {
+  mode: "light",
+  primaryColor: "#6366f1",
+  tokens: {}
+};
+function detectHost(initResponse) {
+  const resp = initResponse;
+  const hostName = resp?.hostInfo?.name ?? "unknown";
+  const protocolVersion = resp?.protocolVersion ?? "unknown";
+  return {
+    isNimbleBrain: hostName === "nimblebrain",
+    serverName: hostName,
+    protocolVersion
+  };
+}
+function extractTheme(ctx) {
+  if (!ctx) return { ...DEFAULT_THEME };
+  const mode = ctx.theme === "light" || ctx.theme === "dark" ? ctx.theme : DEFAULT_THEME.mode;
+  const variables = ctx.styles?.variables;
+  const tokens = variables && typeof variables === "object" && !Array.isArray(variables) ? variables : {};
+  return { mode, primaryColor: DEFAULT_THEME.primaryColor, tokens };
+}
+function extractFontFaces(ctx) {
+  return normalizeFontFaces(ctx?.[FONT_FACES_CONTEXT_KEY]);
+}
+function foldFontFaces(prev, ctx) {
+  return extractFontFaces(ctx) ?? prev;
+}
+
+export { FONT_FACES_CONTEXT_KEY, applyTheme, detectHost, extractFontFaces, extractTheme, foldFontFaces, fontFacesKey };
+//# sourceMappingURL=chunk-DOKVNVTI.js.map
+//# sourceMappingURL=chunk-DOKVNVTI.js.map

package/dist/chunk-DOKVNVTI.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/theme-defaults.ts","../src/detection.ts"],"names":[],"mappings":"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","file":"chunk-DOKVNVTI.js","sourcesContent":["/**\n * Theme-aware default backing for the `@nimblebrain/synapse/ui` token contract.\n *\n * `tokens` (see `ui/tokens.ts`) are `var(--token, fallback)` references. A CSS\n * `var()` fallback is a *static literal* — it cannot branch on light vs. dark.\n * So any var the host does NOT inject resolves to its single hardcoded (light)\n * fallback in BOTH themes. Pair such a token with a theme-aware one and you get\n * white-on-white in dark mode: it looks correct in light, passes `tsc`/build,\n * and only breaks when the theme is toggled.\n *\n * This module closes that gap with a default layer the SDK controls and that\n * CAN branch on theme. {@link applyThemeVariables} writes the neutral defaults\n * for the active `mode` first, then the host's variables on top — so:\n *   - the host's (brand) values always win for the keys it provides, and\n *   - any var the host omits still resolves to a theme-correct neutral value.\n *\n * It's the `var()` fallback, but able to branch on theme. The values stay\n * deliberately NEUTRAL (grays + a generic blue), never NimbleBrain brand —\n * brand arrives only by host injection, mirroring `ui/tokens.ts`. This keeps\n * the library host-agnostic while guaranteeing every token resolves correctly\n * in both themes even against an incomplete host, a standalone `connect()`\n * widget, or a third-party host.\n *\n * Font *faces* are the one part of theming CSS variables cannot carry — a token\n * names a family, it cannot load one. {@link applyThemeFontFaces} closes that\n * half, and {@link applyTheme} applies both together.\n *\n * Only theme-sensitive (color) vars are listed here. Theme-invariant vars\n * (radii, type scale, shadows, font stacks, weights, border widths) look the\n * same in both themes, so their static `var()` fallback is already correct —\n * they are intentionally absent. The `tokens` regression test enforces this\n * with a TOTAL partition: every referenced var must be either declared\n * theme-invariant (an explicit allowlist) or defined in both maps below, so a\n * newly added theme-sensitive token can't slip through unbacked.\n */\n\nimport type { FontDisplayValue, FontFaceDescriptor } from \"./types.js\";\n\nconst FONT_DISPLAY_VALUES = new Set<FontDisplayValue>([\n  \"auto\",\n  \"block\",\n  \"swap\",\n  \"fallback\",\n  \"optional\",\n]);\n\n/**\n * Light-theme neutral defaults. Values match the (light) fallbacks baked into\n * `tokens` — applying them changes nothing observable in light mode; they exist\n * so the light path flows through the same code as dark and so a standalone\n * render with an explicit `light` theme is backed identically to its fallbacks.\n */\nconst LIGHT: Record<string, string> = {\n  // ── Surfaces ──\n  \"--color-background-primary\": \"#ffffff\",\n  \"--color-background-secondary\": \"#fafafa\",\n  \"--color-background-tertiary\": \"#f3f4f6\",\n  // ── Text ──\n  \"--color-text-primary\": \"#111827\",\n  \"--color-text-secondary\": \"#6b7280\",\n  \"--color-text-tertiary\": \"#9ca3af\",\n  \"--color-text-accent\": \"#2563eb\",\n  \"--nb-color-accent-foreground\": \"#ffffff\",\n  // ── Border / ring ──\n  \"--color-border-primary\": \"#e5e7eb\",\n  \"--color-border-secondary\": \"#d1d5db\",\n  \"--color-ring-primary\": \"#2563eb\",\n  // ── Status / brand semantics ──\n  \"--nb-color-danger\": \"#dc2626\",\n  \"--nb-color-success\": \"#059669\",\n  \"--nb-color-warning\": \"#f59e0b\",\n  \"--nb-color-warm\": \"#d4620a\",\n  \"--nb-color-warm-light\": \"#fef5ee\",\n  \"--nb-color-processing\": \"#7c3aed\",\n  \"--nb-color-processing-light\": \"#f3eeff\",\n  \"--nb-color-info-light\": \"#eef4ff\",\n};\n\n/**\n * Dark-theme neutral defaults. A monotonic neutral ladder — the three surface\n * tiers are the darkest, borders sit a step lighter so they stay visible\n * against every surface, and text inverts to light. \"Subtle\"/\"strong\" keep\n * their light-mode semantics: `bgSubtle` reads as a lifted hover/inset tint and\n * `borderStrong` is more prominent than `border`.\n */\nconst DARK: Record<string, string> = {\n  // ── Surfaces (base → lifted) ──\n  \"--color-background-primary\": \"#18181b\",\n  \"--color-background-secondary\": \"#27272a\",\n  \"--color-background-tertiary\": \"#2f2f34\",\n  // ── Text ──\n  \"--color-text-primary\": \"#fafafa\",\n  \"--color-text-secondary\": \"#a1a1aa\",\n  \"--color-text-tertiary\": \"#71717a\",\n  \"--color-text-accent\": \"#818cf8\",\n  \"--nb-color-accent-foreground\": \"#ffffff\",\n  // ── Border / ring (lighter than surfaces so they remain visible) ──\n  \"--color-border-primary\": \"#3f3f46\",\n  \"--color-border-secondary\": \"#52525b\",\n  \"--color-ring-primary\": \"#818cf8\",\n  // ── Status / brand semantics (brightened for contrast on dark) ──\n  \"--nb-color-danger\": \"#f87171\",\n  \"--nb-color-success\": \"#34d399\",\n  \"--nb-color-warning\": \"#fbbf24\",\n  \"--nb-color-warm\": \"#fb923c\",\n  \"--nb-color-warm-light\": \"#3a2a1e\",\n  \"--nb-color-processing\": \"#a78bfa\",\n  \"--nb-color-processing-light\": \"#2a2440\",\n  \"--nb-color-info-light\": \"#1e2a44\",\n};\n\n/**\n * The neutral default theme, keyed by mode. Exported for the regression test\n * that asserts every color var referenced by `tokens` is backed in both modes.\n */\nexport const DEFAULT_THEME_VARS: Record<\"light\" | \"dark\", Record<string, string>> = {\n  light: LIGHT,\n  dark: DARK,\n};\n\n/**\n * Apply theme CSS custom properties onto `document.documentElement`.\n *\n * Writes the neutral defaults for `mode` FIRST, then the host's variables on\n * top — so the host's values win for the keys it provides, and any var it omits\n * still resolves to a theme-correct neutral default.\n *\n * SSR-safe (no-ops when `document` is unavailable). Idempotent — `setProperty`\n * overwrites, so re-applying on every theme change is correct and cheap.\n *\n * Prefer {@link applyTheme}: it applies variables *and* font faces together, so\n * a caller cannot wire up half a theme.\n */\nexport function applyThemeVariables(\n  mode: \"light\" | \"dark\",\n  hostVars: Record<string, string> | undefined | null,\n): void {\n  if (typeof document === \"undefined\") return;\n  const root = document.documentElement.style;\n  for (const [k, v] of Object.entries(DEFAULT_THEME_VARS[mode])) {\n    root.setProperty(k, v);\n  }\n  if (hostVars && typeof hostVars === \"object\") {\n    for (const [k, v] of Object.entries(hostVars)) {\n      if (typeof k === \"string\" && typeof v === \"string\") {\n        root.setProperty(k, v);\n      }\n    }\n  }\n}\n\n/** The faces this module has added, so a re-apply replaces rather than accumulates. */\nconst managedFaces = new Set<FontFace>();\n\n/** Signature of the currently-applied set — lets a repeat call no-op. */\nlet appliedFontKey = \"\";\n\n/** Stable signature of a face list — the one comparison rule for \"same fonts?\",\n *  shared by the sink's re-apply guard and `onThemeChanged`'s equality filter. */\nexport function fontFacesKey(faces: readonly FontFaceDescriptor[] | undefined | null): string {\n  if (!Array.isArray(faces)) return \"\";\n  return JSON.stringify(faces.map((d) => [d.family, d.src, d.weight, d.style, d.display]));\n}\n\n/**\n * Normalise an untrusted face list into the one shape every layer trusts.\n *\n * THE rule, in one place:\n *   - not an array           → `undefined` — nothing was said, keep what's loaded\n *   - array, none usable     → `undefined` — a shape mistake is not a clear\n *   - array, some usable     → those entries\n *   - empty array            → `[]` — the explicit clear\n *\n * The wire and the sink each used to spell this out separately and drifted\n * apart, so a host whose descriptors were mis-shaped kept its typeface through\n * one path and lost it through the other. One predicate, one spelling.\n */\nexport function normalizeFontFaces(raw: unknown): FontFaceDescriptor[] | undefined {\n  if (!Array.isArray(raw)) return undefined;\n  const usable = raw.filter(isFontFaceDescriptor);\n  if (raw.length > 0 && usable.length === 0) return undefined;\n  return usable;\n}\n\n/**\n * Load host-supplied `@font-face`s into the app document.\n *\n * Uses the CSSOM {@link FontFace} constructor rather than building `@font-face`\n * CSS text. That is deliberate, and load-bearing for two reasons:\n *\n *  1. **No CSS-injection sink.** `family` and `src` are separate arguments, not\n *     concatenated into a stylesheet, so a host value containing `}` cannot\n *     escape the rule and inject arbitrary CSS into the app.\n *  2. **Uniform URL handling.** The `src` descriptor is parsed by the browser\n *     against the `src` grammar, so relative (`url('/fonts/x.woff2')`), absolute\n *     (`url('https://cdn.example/x.woff2')`) and `data:` forms all just work.\n *     A malformed descriptor throws `SyntaxError` here instead of silently\n *     producing dead CSS.\n *\n * The SDK ships no font data. A host that sends nothing leaves the web-safe\n * fallbacks in `ui/tokens.ts` in force — which is why omitting fonts entirely is\n * a supported configuration, not a degraded one.\n *\n * Faces are added but not force-loaded: the browser fetches a face when CSS\n * first matches it, so an unused weight costs nothing. `display` defaults to\n * `swap` so text paints in the fallback immediately rather than blocking.\n *\n * SSR-safe, and safe in environments without the CSS Font Loading API (older\n * jsdom): both no-op. Re-applying an unchanged set is a no-op.\n */\nexport function applyThemeFontFaces(faces: readonly FontFaceDescriptor[] | undefined | null): void {\n  // `normalizeFontFaces` owns what absent/garbage means. Reached from the public\n  // `applyHostTheme`, so the input here is not necessarily typed: a host\n  // building `fontFaces` from untrusted JSON can hand us mis-shaped entries,\n  // and reading those as \"clear\" would unload the typeface over a typo.\n  const next = normalizeFontFaces(faces);\n  if (next === undefined) return;\n  if (typeof document === \"undefined\") return;\n  // `document.fonts` (CSS Font Loading API) is absent in some test DOMs.\n  if (!document.fonts || typeof FontFace === \"undefined\") return;\n\n  const key = fontFacesKey(next);\n  if (key === appliedFontKey) return;\n  appliedFontKey = key;\n\n  for (const face of managedFaces) {\n    try {\n      document.fonts.delete(face);\n    } catch {\n      // Already evicted, or the API rejected the handle — nothing to undo.\n    }\n  }\n  managedFaces.clear();\n\n  for (const d of next) {\n    try {\n      const face = new FontFace(d.family, d.src, {\n        weight: d.weight,\n        style: d.style,\n        // Wire data is untyped: ignore an unrecognised `display` rather than let\n        // the constructor reject the descriptor and cost the app this face.\n        display: d.display && FONT_DISPLAY_VALUES.has(d.display) ? d.display : \"swap\",\n      });\n      document.fonts.add(face);\n      managedFaces.add(face);\n    } catch {\n      // Malformed descriptor — skip this face and keep the web-safe fallback.\n      // One bad entry must not cost the app the rest of its typography.\n    }\n  }\n}\n\nfunction isFontFaceDescriptor(value: unknown): value is FontFaceDescriptor {\n  if (!value || typeof value !== \"object\") return false;\n  const d = value as Partial<FontFaceDescriptor>;\n  return typeof d.family === \"string\" && typeof d.src === \"string\";\n}\n\n/**\n * Apply a resolved theme to the app document — CSS variables and font faces.\n *\n * This is the single path by which theming reaches the DOM: the handshake,\n * `host-context-changed`, and the React `<SynapseProvider>` all funnel through\n * here. Keeping colour and typography on one call is the point — two entry\n * points invite a caller to wire one and forget the other, shipping a host's\n * palette under the wrong typeface.\n *\n * Omitting `fontFaces` is safe and means \"leave the loaded faces alone\" (see\n * {@link applyThemeFontFaces}), so a caller re-applying a theme derived from a\n * partial host context cannot silently strip the host's typeface.\n */\nexport function applyTheme(\n  mode: \"light\" | \"dark\",\n  hostVars: Record<string, string> | undefined | null,\n  fontFaces?: readonly FontFaceDescriptor[] | null,\n): void {\n  applyThemeVariables(mode, hostVars);\n  applyThemeFontFaces(fontFaces);\n}\n\n/** Test seam — forget applied faces so a fresh apply is observable. */\nexport function resetAppliedFontFaces(): void {\n  managedFaces.clear();\n  appliedFontKey = \"\";\n}\n","import type { McpUiHostContext, McpUiInitializeResult } from \"@modelcontextprotocol/ext-apps\";\nimport { normalizeFontFaces } from \"./theme-defaults.js\";\nimport type { FontFaceDescriptor, HostInfo, SynapseTheme } from \"./types\";\n\n/**\n * Host-context key carrying `@font-face` descriptors.\n *\n * A NimbleBrain extension (`synapse/` prefix), because the ext-apps spec has no\n * equivalent: `styles.variables` is a flat `Record<McpUiStyleVariableKey, string>`\n * that can name a font family but cannot carry the rule that loads it.\n * `McpUiHostContext` declares `[key: string]: unknown` for forward\n * compatibility, so riding an extra key is spec-legal, and hosts that don't send\n * it degrade to the web-safe token fallbacks.\n */\nexport const FONT_FACES_CONTEXT_KEY = \"synapse/fontFaces\";\n\nconst DEFAULT_THEME: SynapseTheme = {\n  mode: \"light\",\n  primaryColor: \"#6366f1\",\n  tokens: {},\n};\n\n/**\n * Detect the host environment from the ext-apps `ui/initialize` response.\n *\n * Reports identity only (host name, protocol version). Theme lives in the\n * unified host-context state and is read via `extractTheme(hostContext)`\n * — no parallel `theme` field on `HostInfo`.\n *\n * Handles missing or malformed fields gracefully — never throws.\n */\nexport function detectHost(initResponse: unknown): HostInfo {\n  const resp = initResponse as Partial<McpUiInitializeResult> | null | undefined;\n\n  const hostName = resp?.hostInfo?.name ?? \"unknown\";\n  const protocolVersion = resp?.protocolVersion ?? \"unknown\";\n\n  return {\n    isNimbleBrain: hostName === \"nimblebrain\",\n    serverName: hostName,\n    protocolVersion,\n  };\n}\n\nexport function extractTheme(ctx: Partial<McpUiHostContext> | undefined): SynapseTheme {\n  if (!ctx) return { ...DEFAULT_THEME };\n\n  // Spec: theme is a string (\"light\" | \"dark\")\n  const mode = ctx.theme === \"light\" || ctx.theme === \"dark\" ? ctx.theme : DEFAULT_THEME.mode;\n\n  // Spec: tokens live under styles.variables\n  const variables = ctx.styles?.variables;\n  const tokens =\n    variables && typeof variables === \"object\" && !Array.isArray(variables)\n      ? (variables as Record<string, string>)\n      : {};\n\n  // Deliberately no `fontFaces` here. Faces are sticky across a partial context\n  // (see `foldFontFaces`), and this function sees only the context in hand — so\n  // populating the field would publish a NON-sticky value on the return type and\n  // invite `extractTheme(ctx).fontFaces`, which is the unload-on-toggle bug.\n  // `resolveTheme` overlays the sticky set; nothing else should.\n  return { mode, primaryColor: DEFAULT_THEME.primaryColor, tokens };\n}\n\n/**\n * Read the `synapse/fontFaces` host-context extension.\n *\n * `undefined` and `[]` are **distinct answers**, because a host-context-changed\n * carries only the fields that changed:\n *   - `undefined` — the host said nothing about fonts, so keep what's loaded.\n *   - `[]` — the host explicitly sent an empty list, i.e. drop the faces.\n * Collapsing the two would leave a host no way to clear typography it had\n * previously set.\n *\n * Individual malformed entries are dropped rather than rejecting the batch —\n * one bad face must not cost the app the rest of its typography. Anything that\n * survives is still validated by the browser when the descriptor is built.\n */\nexport function extractFontFaces(\n  ctx: Partial<McpUiHostContext> | undefined,\n): FontFaceDescriptor[] | undefined {\n  return normalizeFontFaces(ctx?.[FONT_FACES_CONTEXT_KEY]);\n}\n\n/**\n * THE rule for merging incoming faces over what is already loaded, in one\n * place: **absent — or a batch with nothing usable — means unchanged; an\n * explicit list, including empty, replaces.**\n *\n * Every consumer of the host-context font extension folds through here. The\n * rule leaked one layer at a time when each site spelled it itself, so the\n * spelling now lives once and the call sites just call it.\n */\nexport function foldFontFaces(\n  prev: FontFaceDescriptor[] | undefined,\n  ctx: Partial<McpUiHostContext> | undefined,\n): FontFaceDescriptor[] | undefined {\n  return extractFontFaces(ctx) ?? prev;\n}\n"]}

package/dist/chunk-IA2M4GTK.cjs

@@ -0,0 +1,170 @@
+'use strict';
+
+// src/theme-defaults.ts
+var FONT_DISPLAY_VALUES = /* @__PURE__ */ new Set([
+  "auto",
+  "block",
+  "swap",
+  "fallback",
+  "optional"
+]);
+var LIGHT = {
+  // ── Surfaces ──
+  "--color-background-primary": "#ffffff",
+  "--color-background-secondary": "#fafafa",
+  "--color-background-tertiary": "#f3f4f6",
+  // ── Text ──
+  "--color-text-primary": "#111827",
+  "--color-text-secondary": "#6b7280",
+  "--color-text-tertiary": "#9ca3af",
+  "--color-text-accent": "#2563eb",
+  "--nb-color-accent-foreground": "#ffffff",
+  // ── Border / ring ──
+  "--color-border-primary": "#e5e7eb",
+  "--color-border-secondary": "#d1d5db",
+  "--color-ring-primary": "#2563eb",
+  // ── Status / brand semantics ──
+  "--nb-color-danger": "#dc2626",
+  "--nb-color-success": "#059669",
+  "--nb-color-warning": "#f59e0b",
+  "--nb-color-warm": "#d4620a",
+  "--nb-color-warm-light": "#fef5ee",
+  "--nb-color-processing": "#7c3aed",
+  "--nb-color-processing-light": "#f3eeff",
+  "--nb-color-info-light": "#eef4ff"
+};
+var DARK = {
+  // ── Surfaces (base → lifted) ──
+  "--color-background-primary": "#18181b",
+  "--color-background-secondary": "#27272a",
+  "--color-background-tertiary": "#2f2f34",
+  // ── Text ──
+  "--color-text-primary": "#fafafa",
+  "--color-text-secondary": "#a1a1aa",
+  "--color-text-tertiary": "#71717a",
+  "--color-text-accent": "#818cf8",
+  "--nb-color-accent-foreground": "#ffffff",
+  // ── Border / ring (lighter than surfaces so they remain visible) ──
+  "--color-border-primary": "#3f3f46",
+  "--color-border-secondary": "#52525b",
+  "--color-ring-primary": "#818cf8",
+  // ── Status / brand semantics (brightened for contrast on dark) ──
+  "--nb-color-danger": "#f87171",
+  "--nb-color-success": "#34d399",
+  "--nb-color-warning": "#fbbf24",
+  "--nb-color-warm": "#fb923c",
+  "--nb-color-warm-light": "#3a2a1e",
+  "--nb-color-processing": "#a78bfa",
+  "--nb-color-processing-light": "#2a2440",
+  "--nb-color-info-light": "#1e2a44"
+};
+var DEFAULT_THEME_VARS = {
+  light: LIGHT,
+  dark: DARK
+};
+function applyThemeVariables(mode, hostVars) {
+  if (typeof document === "undefined") return;
+  const root = document.documentElement.style;
+  for (const [k, v] of Object.entries(DEFAULT_THEME_VARS[mode])) {
+    root.setProperty(k, v);
+  }
+  if (hostVars && typeof hostVars === "object") {
+    for (const [k, v] of Object.entries(hostVars)) {
+      if (typeof k === "string" && typeof v === "string") {
+        root.setProperty(k, v);
+      }
+    }
+  }
+}
+var managedFaces = /* @__PURE__ */ new Set();
+var appliedFontKey = "";
+function fontFacesKey(faces) {
+  if (!Array.isArray(faces)) return "";
+  return JSON.stringify(faces.map((d) => [d.family, d.src, d.weight, d.style, d.display]));
+}
+function normalizeFontFaces(raw) {
+  if (!Array.isArray(raw)) return void 0;
+  const usable = raw.filter(isFontFaceDescriptor);
+  if (raw.length > 0 && usable.length === 0) return void 0;
+  return usable;
+}
+function applyThemeFontFaces(faces) {
+  const next = normalizeFontFaces(faces);
+  if (next === void 0) return;
+  if (typeof document === "undefined") return;
+  if (!document.fonts || typeof FontFace === "undefined") return;
+  const key = fontFacesKey(next);
+  if (key === appliedFontKey) return;
+  appliedFontKey = key;
+  for (const face of managedFaces) {
+    try {
+      document.fonts.delete(face);
+    } catch {
+    }
+  }
+  managedFaces.clear();
+  for (const d of next) {
+    try {
+      const face = new FontFace(d.family, d.src, {
+        weight: d.weight,
+        style: d.style,
+        // Wire data is untyped: ignore an unrecognised `display` rather than let
+        // the constructor reject the descriptor and cost the app this face.
+        display: d.display && FONT_DISPLAY_VALUES.has(d.display) ? d.display : "swap"
+      });
+      document.fonts.add(face);
+      managedFaces.add(face);
+    } catch {
+    }
+  }
+}
+function isFontFaceDescriptor(value) {
+  if (!value || typeof value !== "object") return false;
+  const d = value;
+  return typeof d.family === "string" && typeof d.src === "string";
+}
+function applyTheme(mode, hostVars, fontFaces) {
+  applyThemeVariables(mode, hostVars);
+  applyThemeFontFaces(fontFaces);
+}
+
+// src/detection.ts
+var FONT_FACES_CONTEXT_KEY = "synapse/fontFaces";
+var DEFAULT_THEME = {
+  mode: "light",
+  primaryColor: "#6366f1",
+  tokens: {}
+};
+function detectHost(initResponse) {
+  const resp = initResponse;
+  const hostName = resp?.hostInfo?.name ?? "unknown";
+  const protocolVersion = resp?.protocolVersion ?? "unknown";
+  return {
+    isNimbleBrain: hostName === "nimblebrain",
+    serverName: hostName,
+    protocolVersion
+  };
+}
+function extractTheme(ctx) {
+  if (!ctx) return { ...DEFAULT_THEME };
+  const mode = ctx.theme === "light" || ctx.theme === "dark" ? ctx.theme : DEFAULT_THEME.mode;
+  const variables = ctx.styles?.variables;
+  const tokens = variables && typeof variables === "object" && !Array.isArray(variables) ? variables : {};
+  return { mode, primaryColor: DEFAULT_THEME.primaryColor, tokens };
+}
+function extractFontFaces(ctx) {
+  return normalizeFontFaces(ctx?.[FONT_FACES_CONTEXT_KEY]);
+}
+function foldFontFaces(prev, ctx) {
+  return extractFontFaces(ctx) ?? prev;
+}
+
+exports.FONT_FACES_CONTEXT_KEY = FONT_FACES_CONTEXT_KEY;
+exports.applyTheme = applyTheme;
+exports.detectHost = detectHost;
+exports.extractFontFaces = extractFontFaces;
+exports.extractTheme = extractTheme;
+exports.foldFontFaces = foldFontFaces;
+exports.fontFacesKey = fontFacesKey;
+//# sourceMappingURL=chunk-IA2M4GTK.cjs.map
+//# sourceMappingURL=chunk-IA2M4GTK.cjs.map

package/dist/chunk-IA2M4GTK.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/theme-defaults.ts","../src/detection.ts"],"names":[],"mappings":";;;AAsCA,IAAM,mBAAA,uBAA0B,GAAA,CAAsB;AAAA,EACpD,MAAA;AAAA,EACA,OAAA;AAAA,EACA,MAAA;AAAA,EACA,UAAA;AAAA,EACA;AACF,CAAC,CAAA;AAQD,IAAM,KAAA,GAAgC;AAAA;AAAA,EAEpC,4BAAA,EAA8B,SAAA;AAAA,EAC9B,8BAAA,EAAgC,SAAA;AAAA,EAChC,6BAAA,EAA+B,SAAA;AAAA;AAAA,EAE/B,sBAAA,EAAwB,SAAA;AAAA,EACxB,wBAAA,EAA0B,SAAA;AAAA,EAC1B,uBAAA,EAAyB,SAAA;AAAA,EACzB,qBAAA,EAAuB,SAAA;AAAA,EACvB,8BAAA,EAAgC,SAAA;AAAA;AAAA,EAEhC,wBAAA,EAA0B,SAAA;AAAA,EAC1B,0BAAA,EAA4B,SAAA;AAAA,EAC5B,sBAAA,EAAwB,SAAA;AAAA;AAAA,EAExB,mBAAA,EAAqB,SAAA;AAAA,EACrB,oBAAA,EAAsB,SAAA;AAAA,EACtB,oBAAA,EAAsB,SAAA;AAAA,EACtB,iBAAA,EAAmB,SAAA;AAAA,EACnB,uBAAA,EAAyB,SAAA;AAAA,EACzB,uBAAA,EAAyB,SAAA;AAAA,EACzB,6BAAA,EAA+B,SAAA;AAAA,EAC/B,uBAAA,EAAyB;AAC3B,CAAA;AASA,IAAM,IAAA,GAA+B;AAAA;AAAA,EAEnC,4BAAA,EAA8B,SAAA;AAAA,EAC9B,8BAAA,EAAgC,SAAA;AAAA,EAChC,6BAAA,EAA+B,SAAA;AAAA;AAAA,EAE/B,sBAAA,EAAwB,SAAA;AAAA,EACxB,wBAAA,EAA0B,SAAA;AAAA,EAC1B,uBAAA,EAAyB,SAAA;AAAA,EACzB,qBAAA,EAAuB,SAAA;AAAA,EACvB,8BAAA,EAAgC,SAAA;AAAA;AAAA,EAEhC,wBAAA,EAA0B,SAAA;AAAA,EAC1B,0BAAA,EAA4B,SAAA;AAAA,EAC5B,sBAAA,EAAwB,SAAA;AAAA;AAAA,EAExB,mBAAA,EAAqB,SAAA;AAAA,EACrB,oBAAA,EAAsB,SAAA;AAAA,EACtB,oBAAA,EAAsB,SAAA;AAAA,EACtB,iBAAA,EAAmB,SAAA;AAAA,EACnB,uBAAA,EAAyB,SAAA;AAAA,EACzB,uBAAA,EAAyB,SAAA;AAAA,EACzB,6BAAA,EAA+B,SAAA;AAAA,EAC/B,uBAAA,EAAyB;AAC3B,CAAA;AAMO,IAAM,kBAAA,GAAuE;AAAA,EAClF,KAAA,EAAO,KAAA;AAAA,EACP,IAAA,EAAM;AACR,CAAA;AAeO,SAAS,mBAAA,CACd,MACA,QAAA,EACM;AACN,EAAA,IAAI,OAAO,aAAa,WAAA,EAAa;AACrC,EAAA,MAAM,IAAA,GAAO,SAAS,eAAA,CAAgB,KAAA;AACtC,EAAA,KAAA,MAAW,CAAC,GAAG,CAAC,CAAA,IAAK,OAAO,OAAA,CAAQ,kBAAA,CAAmB,IAAI,CAAC,CAAA,EAAG;AAC7D,IAAA,IAAA,CAAK,WAAA,CAAY,GAAG,CAAC,CAAA;AAAA,EACvB;AACA,EAAA,IAAI,QAAA,IAAY,OAAO,QAAA,KAAa,QAAA,EAAU;AAC5C,IAAA,KAAA,MAAW,CAAC,CAAA,EAAG,CAAC,KAAK,MAAA,CAAO,OAAA,CAAQ,QAAQ,CAAA,EAAG;AAC7C,MAAA,IAAI,OAAO,CAAA,KAAM,QAAA,IAAY,OAAO,MAAM,QAAA,EAAU;AAClD,QAAA,IAAA,CAAK,WAAA,CAAY,GAAG,CAAC,CAAA;AAAA,MACvB;AAAA,IACF;AAAA,EACF;AACF;AAGA,IAAM,YAAA,uBAAmB,GAAA,EAAc;AAGvC,IAAI,cAAA,GAAiB,EAAA;AAId,SAAS,aAAa,KAAA,EAAiE;AAC5F,EAAA,IAAI,CAAC,KAAA,CAAM,OAAA,CAAQ,KAAK,GAAG,OAAO,EAAA;AAClC,EAAA,OAAO,KAAK,SAAA,CAAU,KAAA,CAAM,IAAI,CAAC,CAAA,KAAM,CAAC,CAAA,CAAE,MAAA,EAAQ,CAAA,CAAE,GAAA,EAAK,EAAE,MAAA,EAAQ,CAAA,CAAE,OAAO,CAAA,CAAE,OAAO,CAAC,CAAC,CAAA;AACzF;AAeO,SAAS,mBAAmB,GAAA,EAAgD;AACjF,EAAA,IAAI,CAAC,KAAA,CAAM,OAAA,CAAQ,GAAG,GAAG,OAAO,MAAA;AAChC,EAAA,MAAM,MAAA,GAAS,GAAA,CAAI,MAAA,CAAO,oBAAoB,CAAA;AAC9C,EAAA,IAAI,IAAI,MAAA,GAAS,CAAA,IAAK,MAAA,CAAO,MAAA,KAAW,GAAG,OAAO,MAAA;AAClD,EAAA,OAAO,MAAA;AACT;AA4BO,SAAS,oBAAoB,KAAA,EAA+D;AAKjG,EAAA,MAAM,IAAA,GAAO,mBAAmB,KAAK,CAAA;AACrC,EAAA,IAAI,SAAS,MAAA,EAAW;AACxB,EAAA,IAAI,OAAO,aAAa,WAAA,EAAa;AAErC,EAAA,IAAI,CAAC,QAAA,CAAS,KAAA,IAAS,OAAO,aAAa,WAAA,EAAa;AAExD,EAAA,MAAM,GAAA,GAAM,aAAa,IAAI,CAAA;AAC7B,EAAA,IAAI,QAAQ,cAAA,EAAgB;AAC5B,EAAA,cAAA,GAAiB,GAAA;AAEjB,EAAA,KAAA,MAAW,QAAQ,YAAA,EAAc;AAC/B,IAAA,IAAI;AACF,MAAA,QAAA,CAAS,KAAA,CAAM,OAAO,IAAI,CAAA;AAAA,IAC5B,CAAA,CAAA,MAAQ;AAAA,IAER;AAAA,EACF;AACA,EAAA,YAAA,CAAa,KAAA,EAAM;AAEnB,EAAA,KAAA,MAAW,KAAK,IAAA,EAAM;AACpB,IAAA,IAAI;AACF,MAAA,MAAM,OAAO,IAAI,QAAA,CAAS,CAAA,CAAE,MAAA,EAAQ,EAAE,GAAA,EAAK;AAAA,QACzC,QAAQ,CAAA,CAAE,MAAA;AAAA,QACV,OAAO,CAAA,CAAE,KAAA;AAAA;AAAA;AAAA,QAGT,OAAA,EAAS,EAAE,OAAA,IAAW,mBAAA,CAAoB,IAAI,CAAA,CAAE,OAAO,CAAA,GAAI,CAAA,CAAE,OAAA,GAAU;AAAA,OACxE,CAAA;AACD,MAAA,QAAA,CAAS,KAAA,CAAM,IAAI,IAAI,CAAA;AACvB,MAAA,YAAA,CAAa,IAAI,IAAI,CAAA;AAAA,IACvB,CAAA,CAAA,MAAQ;AAAA,IAGR;AAAA,EACF;AACF;AAEA,SAAS,qBAAqB,KAAA,EAA6C;AACzE,EAAA,IAAI,CAAC,KAAA,IAAS,OAAO,KAAA,KAAU,UAAU,OAAO,KAAA;AAChD,EAAA,MAAM,CAAA,GAAI,KAAA;AACV,EAAA,OAAO,OAAO,CAAA,CAAE,MAAA,KAAW,QAAA,IAAY,OAAO,EAAE,GAAA,KAAQ,QAAA;AAC1D;AAeO,SAAS,UAAA,CACd,IAAA,EACA,QAAA,EACA,SAAA,EACM;AACN,EAAA,mBAAA,CAAoB,MAAM,QAAQ,CAAA;AAClC,EAAA,mBAAA,CAAoB,SAAS,CAAA;AAC/B;;;ACxQO,IAAM,sBAAA,GAAyB;AAEtC,IAAM,aAAA,GAA8B;AAAA,EAClC,IAAA,EAAM,OAAA;AAAA,EACN,YAAA,EAAc,SAAA;AAAA,EACd,QAAQ;AACV,CAAA;AAWO,SAAS,WAAW,YAAA,EAAiC;AAC1D,EAAA,MAAM,IAAA,GAAO,YAAA;AAEb,EAAA,MAAM,QAAA,GAAW,IAAA,EAAM,QAAA,EAAU,IAAA,IAAQ,SAAA;AACzC,EAAA,MAAM,eAAA,GAAkB,MAAM,eAAA,IAAmB,SAAA;AAEjD,EAAA,OAAO;AAAA,IACL,eAAe,QAAA,KAAa,aAAA;AAAA,IAC5B,UAAA,EAAY,QAAA;AAAA,IACZ;AAAA,GACF;AACF;AAEO,SAAS,aAAa,GAAA,EAA0D;AACrF,EAAA,IAAI,CAAC,GAAA,EAAK,OAAO,EAAE,GAAG,aAAA,EAAc;AAGpC,EAAA,MAAM,IAAA,GAAO,IAAI,KAAA,KAAU,OAAA,IAAW,IAAI,KAAA,KAAU,MAAA,GAAS,GAAA,CAAI,KAAA,GAAQ,aAAA,CAAc,IAAA;AAGvF,EAAA,MAAM,SAAA,GAAY,IAAI,MAAA,EAAQ,SAAA;AAC9B,EAAA,MAAM,MAAA,GACJ,SAAA,IAAa,OAAO,SAAA,KAAc,QAAA,IAAY,CAAC,KAAA,CAAM,OAAA,CAAQ,SAAS,CAAA,GACjE,SAAA,GACD,EAAC;AAOP,EAAA,OAAO,EAAE,IAAA,EAAM,YAAA,EAAc,aAAA,CAAc,cAAc,MAAA,EAAO;AAClE;AAgBO,SAAS,iBACd,GAAA,EACkC;AAClC,EAAA,OAAO,kBAAA,CAAmB,GAAA,GAAM,sBAAsB,CAAC,CAAA;AACzD;AAWO,SAAS,aAAA,CACd,MACA,GAAA,EACkC;AAClC,EAAA,OAAO,gBAAA,CAAiB,GAAG,CAAA,IAAK,IAAA;AAClC","file":"chunk-IA2M4GTK.cjs","sourcesContent":["/**\n * Theme-aware default backing for the `@nimblebrain/synapse/ui` token contract.\n *\n * `tokens` (see `ui/tokens.ts`) are `var(--token, fallback)` references. A CSS\n * `var()` fallback is a *static literal* — it cannot branch on light vs. dark.\n * So any var the host does NOT inject resolves to its single hardcoded (light)\n * fallback in BOTH themes. Pair such a token with a theme-aware one and you get\n * white-on-white in dark mode: it looks correct in light, passes `tsc`/build,\n * and only breaks when the theme is toggled.\n *\n * This module closes that gap with a default layer the SDK controls and that\n * CAN branch on theme. {@link applyThemeVariables} writes the neutral defaults\n * for the active `mode` first, then the host's variables on top — so:\n *   - the host's (brand) values always win for the keys it provides, and\n *   - any var the host omits still resolves to a theme-correct neutral value.\n *\n * It's the `var()` fallback, but able to branch on theme. The values stay\n * deliberately NEUTRAL (grays + a generic blue), never NimbleBrain brand —\n * brand arrives only by host injection, mirroring `ui/tokens.ts`. This keeps\n * the library host-agnostic while guaranteeing every token resolves correctly\n * in both themes even against an incomplete host, a standalone `connect()`\n * widget, or a third-party host.\n *\n * Font *faces* are the one part of theming CSS variables cannot carry — a token\n * names a family, it cannot load one. {@link applyThemeFontFaces} closes that\n * half, and {@link applyTheme} applies both together.\n *\n * Only theme-sensitive (color) vars are listed here. Theme-invariant vars\n * (radii, type scale, shadows, font stacks, weights, border widths) look the\n * same in both themes, so their static `var()` fallback is already correct —\n * they are intentionally absent. The `tokens` regression test enforces this\n * with a TOTAL partition: every referenced var must be either declared\n * theme-invariant (an explicit allowlist) or defined in both maps below, so a\n * newly added theme-sensitive token can't slip through unbacked.\n */\n\nimport type { FontDisplayValue, FontFaceDescriptor } from \"./types.js\";\n\nconst FONT_DISPLAY_VALUES = new Set<FontDisplayValue>([\n  \"auto\",\n  \"block\",\n  \"swap\",\n  \"fallback\",\n  \"optional\",\n]);\n\n/**\n * Light-theme neutral defaults. Values match the (light) fallbacks baked into\n * `tokens` — applying them changes nothing observable in light mode; they exist\n * so the light path flows through the same code as dark and so a standalone\n * render with an explicit `light` theme is backed identically to its fallbacks.\n */\nconst LIGHT: Record<string, string> = {\n  // ── Surfaces ──\n  \"--color-background-primary\": \"#ffffff\",\n  \"--color-background-secondary\": \"#fafafa\",\n  \"--color-background-tertiary\": \"#f3f4f6\",\n  // ── Text ──\n  \"--color-text-primary\": \"#111827\",\n  \"--color-text-secondary\": \"#6b7280\",\n  \"--color-text-tertiary\": \"#9ca3af\",\n  \"--color-text-accent\": \"#2563eb\",\n  \"--nb-color-accent-foreground\": \"#ffffff\",\n  // ── Border / ring ──\n  \"--color-border-primary\": \"#e5e7eb\",\n  \"--color-border-secondary\": \"#d1d5db\",\n  \"--color-ring-primary\": \"#2563eb\",\n  // ── Status / brand semantics ──\n  \"--nb-color-danger\": \"#dc2626\",\n  \"--nb-color-success\": \"#059669\",\n  \"--nb-color-warning\": \"#f59e0b\",\n  \"--nb-color-warm\": \"#d4620a\",\n  \"--nb-color-warm-light\": \"#fef5ee\",\n  \"--nb-color-processing\": \"#7c3aed\",\n  \"--nb-color-processing-light\": \"#f3eeff\",\n  \"--nb-color-info-light\": \"#eef4ff\",\n};\n\n/**\n * Dark-theme neutral defaults. A monotonic neutral ladder — the three surface\n * tiers are the darkest, borders sit a step lighter so they stay visible\n * against every surface, and text inverts to light. \"Subtle\"/\"strong\" keep\n * their light-mode semantics: `bgSubtle` reads as a lifted hover/inset tint and\n * `borderStrong` is more prominent than `border`.\n */\nconst DARK: Record<string, string> = {\n  // ── Surfaces (base → lifted) ──\n  \"--color-background-primary\": \"#18181b\",\n  \"--color-background-secondary\": \"#27272a\",\n  \"--color-background-tertiary\": \"#2f2f34\",\n  // ── Text ──\n  \"--color-text-primary\": \"#fafafa\",\n  \"--color-text-secondary\": \"#a1a1aa\",\n  \"--color-text-tertiary\": \"#71717a\",\n  \"--color-text-accent\": \"#818cf8\",\n  \"--nb-color-accent-foreground\": \"#ffffff\",\n  // ── Border / ring (lighter than surfaces so they remain visible) ──\n  \"--color-border-primary\": \"#3f3f46\",\n  \"--color-border-secondary\": \"#52525b\",\n  \"--color-ring-primary\": \"#818cf8\",\n  // ── Status / brand semantics (brightened for contrast on dark) ──\n  \"--nb-color-danger\": \"#f87171\",\n  \"--nb-color-success\": \"#34d399\",\n  \"--nb-color-warning\": \"#fbbf24\",\n  \"--nb-color-warm\": \"#fb923c\",\n  \"--nb-color-warm-light\": \"#3a2a1e\",\n  \"--nb-color-processing\": \"#a78bfa\",\n  \"--nb-color-processing-light\": \"#2a2440\",\n  \"--nb-color-info-light\": \"#1e2a44\",\n};\n\n/**\n * The neutral default theme, keyed by mode. Exported for the regression test\n * that asserts every color var referenced by `tokens` is backed in both modes.\n */\nexport const DEFAULT_THEME_VARS: Record<\"light\" | \"dark\", Record<string, string>> = {\n  light: LIGHT,\n  dark: DARK,\n};\n\n/**\n * Apply theme CSS custom properties onto `document.documentElement`.\n *\n * Writes the neutral defaults for `mode` FIRST, then the host's variables on\n * top — so the host's values win for the keys it provides, and any var it omits\n * still resolves to a theme-correct neutral default.\n *\n * SSR-safe (no-ops when `document` is unavailable). Idempotent — `setProperty`\n * overwrites, so re-applying on every theme change is correct and cheap.\n *\n * Prefer {@link applyTheme}: it applies variables *and* font faces together, so\n * a caller cannot wire up half a theme.\n */\nexport function applyThemeVariables(\n  mode: \"light\" | \"dark\",\n  hostVars: Record<string, string> | undefined | null,\n): void {\n  if (typeof document === \"undefined\") return;\n  const root = document.documentElement.style;\n  for (const [k, v] of Object.entries(DEFAULT_THEME_VARS[mode])) {\n    root.setProperty(k, v);\n  }\n  if (hostVars && typeof hostVars === \"object\") {\n    for (const [k, v] of Object.entries(hostVars)) {\n      if (typeof k === \"string\" && typeof v === \"string\") {\n        root.setProperty(k, v);\n      }\n    }\n  }\n}\n\n/** The faces this module has added, so a re-apply replaces rather than accumulates. */\nconst managedFaces = new Set<FontFace>();\n\n/** Signature of the currently-applied set — lets a repeat call no-op. */\nlet appliedFontKey = \"\";\n\n/** Stable signature of a face list — the one comparison rule for \"same fonts?\",\n *  shared by the sink's re-apply guard and `onThemeChanged`'s equality filter. */\nexport function fontFacesKey(faces: readonly FontFaceDescriptor[] | undefined | null): string {\n  if (!Array.isArray(faces)) return \"\";\n  return JSON.stringify(faces.map((d) => [d.family, d.src, d.weight, d.style, d.display]));\n}\n\n/**\n * Normalise an untrusted face list into the one shape every layer trusts.\n *\n * THE rule, in one place:\n *   - not an array           → `undefined` — nothing was said, keep what's loaded\n *   - array, none usable     → `undefined` — a shape mistake is not a clear\n *   - array, some usable     → those entries\n *   - empty array            → `[]` — the explicit clear\n *\n * The wire and the sink each used to spell this out separately and drifted\n * apart, so a host whose descriptors were mis-shaped kept its typeface through\n * one path and lost it through the other. One predicate, one spelling.\n */\nexport function normalizeFontFaces(raw: unknown): FontFaceDescriptor[] | undefined {\n  if (!Array.isArray(raw)) return undefined;\n  const usable = raw.filter(isFontFaceDescriptor);\n  if (raw.length > 0 && usable.length === 0) return undefined;\n  return usable;\n}\n\n/**\n * Load host-supplied `@font-face`s into the app document.\n *\n * Uses the CSSOM {@link FontFace} constructor rather than building `@font-face`\n * CSS text. That is deliberate, and load-bearing for two reasons:\n *\n *  1. **No CSS-injection sink.** `family` and `src` are separate arguments, not\n *     concatenated into a stylesheet, so a host value containing `}` cannot\n *     escape the rule and inject arbitrary CSS into the app.\n *  2. **Uniform URL handling.** The `src` descriptor is parsed by the browser\n *     against the `src` grammar, so relative (`url('/fonts/x.woff2')`), absolute\n *     (`url('https://cdn.example/x.woff2')`) and `data:` forms all just work.\n *     A malformed descriptor throws `SyntaxError` here instead of silently\n *     producing dead CSS.\n *\n * The SDK ships no font data. A host that sends nothing leaves the web-safe\n * fallbacks in `ui/tokens.ts` in force — which is why omitting fonts entirely is\n * a supported configuration, not a degraded one.\n *\n * Faces are added but not force-loaded: the browser fetches a face when CSS\n * first matches it, so an unused weight costs nothing. `display` defaults to\n * `swap` so text paints in the fallback immediately rather than blocking.\n *\n * SSR-safe, and safe in environments without the CSS Font Loading API (older\n * jsdom): both no-op. Re-applying an unchanged set is a no-op.\n */\nexport function applyThemeFontFaces(faces: readonly FontFaceDescriptor[] | undefined | null): void {\n  // `normalizeFontFaces` owns what absent/garbage means. Reached from the public\n  // `applyHostTheme`, so the input here is not necessarily typed: a host\n  // building `fontFaces` from untrusted JSON can hand us mis-shaped entries,\n  // and reading those as \"clear\" would unload the typeface over a typo.\n  const next = normalizeFontFaces(faces);\n  if (next === undefined) return;\n  if (typeof document === \"undefined\") return;\n  // `document.fonts` (CSS Font Loading API) is absent in some test DOMs.\n  if (!document.fonts || typeof FontFace === \"undefined\") return;\n\n  const key = fontFacesKey(next);\n  if (key === appliedFontKey) return;\n  appliedFontKey = key;\n\n  for (const face of managedFaces) {\n    try {\n      document.fonts.delete(face);\n    } catch {\n      // Already evicted, or the API rejected the handle — nothing to undo.\n    }\n  }\n  managedFaces.clear();\n\n  for (const d of next) {\n    try {\n      const face = new FontFace(d.family, d.src, {\n        weight: d.weight,\n        style: d.style,\n        // Wire data is untyped: ignore an unrecognised `display` rather than let\n        // the constructor reject the descriptor and cost the app this face.\n        display: d.display && FONT_DISPLAY_VALUES.has(d.display) ? d.display : \"swap\",\n      });\n      document.fonts.add(face);\n      managedFaces.add(face);\n    } catch {\n      // Malformed descriptor — skip this face and keep the web-safe fallback.\n      // One bad entry must not cost the app the rest of its typography.\n    }\n  }\n}\n\nfunction isFontFaceDescriptor(value: unknown): value is FontFaceDescriptor {\n  if (!value || typeof value !== \"object\") return false;\n  const d = value as Partial<FontFaceDescriptor>;\n  return typeof d.family === \"string\" && typeof d.src === \"string\";\n}\n\n/**\n * Apply a resolved theme to the app document — CSS variables and font faces.\n *\n * This is the single path by which theming reaches the DOM: the handshake,\n * `host-context-changed`, and the React `<SynapseProvider>` all funnel through\n * here. Keeping colour and typography on one call is the point — two entry\n * points invite a caller to wire one and forget the other, shipping a host's\n * palette under the wrong typeface.\n *\n * Omitting `fontFaces` is safe and means \"leave the loaded faces alone\" (see\n * {@link applyThemeFontFaces}), so a caller re-applying a theme derived from a\n * partial host context cannot silently strip the host's typeface.\n */\nexport function applyTheme(\n  mode: \"light\" | \"dark\",\n  hostVars: Record<string, string> | undefined | null,\n  fontFaces?: readonly FontFaceDescriptor[] | null,\n): void {\n  applyThemeVariables(mode, hostVars);\n  applyThemeFontFaces(fontFaces);\n}\n\n/** Test seam — forget applied faces so a fresh apply is observable. */\nexport function resetAppliedFontFaces(): void {\n  managedFaces.clear();\n  appliedFontKey = \"\";\n}\n","import type { McpUiHostContext, McpUiInitializeResult } from \"@modelcontextprotocol/ext-apps\";\nimport { normalizeFontFaces } from \"./theme-defaults.js\";\nimport type { FontFaceDescriptor, HostInfo, SynapseTheme } from \"./types\";\n\n/**\n * Host-context key carrying `@font-face` descriptors.\n *\n * A NimbleBrain extension (`synapse/` prefix), because the ext-apps spec has no\n * equivalent: `styles.variables` is a flat `Record<McpUiStyleVariableKey, string>`\n * that can name a font family but cannot carry the rule that loads it.\n * `McpUiHostContext` declares `[key: string]: unknown` for forward\n * compatibility, so riding an extra key is spec-legal, and hosts that don't send\n * it degrade to the web-safe token fallbacks.\n */\nexport const FONT_FACES_CONTEXT_KEY = \"synapse/fontFaces\";\n\nconst DEFAULT_THEME: SynapseTheme = {\n  mode: \"light\",\n  primaryColor: \"#6366f1\",\n  tokens: {},\n};\n\n/**\n * Detect the host environment from the ext-apps `ui/initialize` response.\n *\n * Reports identity only (host name, protocol version). Theme lives in the\n * unified host-context state and is read via `extractTheme(hostContext)`\n * — no parallel `theme` field on `HostInfo`.\n *\n * Handles missing or malformed fields gracefully — never throws.\n */\nexport function detectHost(initResponse: unknown): HostInfo {\n  const resp = initResponse as Partial<McpUiInitializeResult> | null | undefined;\n\n  const hostName = resp?.hostInfo?.name ?? \"unknown\";\n  const protocolVersion = resp?.protocolVersion ?? \"unknown\";\n\n  return {\n    isNimbleBrain: hostName === \"nimblebrain\",\n    serverName: hostName,\n    protocolVersion,\n  };\n}\n\nexport function extractTheme(ctx: Partial<McpUiHostContext> | undefined): SynapseTheme {\n  if (!ctx) return { ...DEFAULT_THEME };\n\n  // Spec: theme is a string (\"light\" | \"dark\")\n  const mode = ctx.theme === \"light\" || ctx.theme === \"dark\" ? ctx.theme : DEFAULT_THEME.mode;\n\n  // Spec: tokens live under styles.variables\n  const variables = ctx.styles?.variables;\n  const tokens =\n    variables && typeof variables === \"object\" && !Array.isArray(variables)\n      ? (variables as Record<string, string>)\n      : {};\n\n  // Deliberately no `fontFaces` here. Faces are sticky across a partial context\n  // (see `foldFontFaces`), and this function sees only the context in hand — so\n  // populating the field would publish a NON-sticky value on the return type and\n  // invite `extractTheme(ctx).fontFaces`, which is the unload-on-toggle bug.\n  // `resolveTheme` overlays the sticky set; nothing else should.\n  return { mode, primaryColor: DEFAULT_THEME.primaryColor, tokens };\n}\n\n/**\n * Read the `synapse/fontFaces` host-context extension.\n *\n * `undefined` and `[]` are **distinct answers**, because a host-context-changed\n * carries only the fields that changed:\n *   - `undefined` — the host said nothing about fonts, so keep what's loaded.\n *   - `[]` — the host explicitly sent an empty list, i.e. drop the faces.\n * Collapsing the two would leave a host no way to clear typography it had\n * previously set.\n *\n * Individual malformed entries are dropped rather than rejecting the batch —\n * one bad face must not cost the app the rest of its typography. Anything that\n * survives is still validated by the browser when the descriptor is built.\n */\nexport function extractFontFaces(\n  ctx: Partial<McpUiHostContext> | undefined,\n): FontFaceDescriptor[] | undefined {\n  return normalizeFontFaces(ctx?.[FONT_FACES_CONTEXT_KEY]);\n}\n\n/**\n * THE rule for merging incoming faces over what is already loaded, in one\n * place: **absent — or a batch with nothing usable — means unchanged; an\n * explicit list, including empty, replaces.**\n *\n * Every consumer of the host-context font extension folds through here. The\n * rule leaked one layer at a time when each site spelled it itself, so the\n * spelling now lives once and the call sites just call it.\n */\nexport function foldFontFaces(\n  prev: FontFaceDescriptor[] | undefined,\n  ctx: Partial<McpUiHostContext> | undefined,\n): FontFaceDescriptor[] | undefined {\n  return extractFontFaces(ctx) ?? prev;\n}\n"]}

package/dist/{chunk-A4ENX6XW.cjs → chunk-QHS7BJLI.cjs}

@@ -1,6 +1,6 @@
 'use strict';
 
-var chunkKTXASIFJ_cjs = require('./chunk-KTXASIFJ.cjs');
+var chunkIA2M4GTK_cjs = require('./chunk-IA2M4GTK.cjs');
 var extApps = require('@modelcontextprotocol/ext-apps');
 
 // src/content-parser.ts
@@ -254,9 +254,11 @@ async function connect(options) {
     };
     const ctx = result.hostContext;
     if (ctx) {
+      const initialFontFaces = chunkIA2M4GTK_cjs.extractFontFaces(ctx);
       currentTheme = {
         mode: ctx.theme === "dark" ? "dark" : "light",
-        tokens: ctx.styles?.variables && typeof ctx.styles.variables === "object" ? ctx.styles.variables : {}
+        tokens: ctx.styles?.variables && typeof ctx.styles.variables === "object" ? ctx.styles.variables : {},
+        ...initialFontFaces ? { fontFaces: initialFontFaces } : {}
       };
       if (ctx.toolInfo && typeof ctx.toolInfo === "object") {
         toolInfo = { tool: ctx.toolInfo.tool ?? {} };
@@ -264,7 +266,7 @@ async function connect(options) {
       if (ctx.containerDimensions && typeof ctx.containerDimensions === "object") {
         containerDimensions = ctx.containerDimensions;
       }
-      chunkKTXASIFJ_cjs.applyThemeVariables(currentTheme.mode, currentTheme.tokens);
+      chunkIA2M4GTK_cjs.applyTheme(currentTheme.mode, currentTheme.tokens, currentTheme.fontFaces);
     }
   }
   transport.onMessage(extApps.HOST_CONTEXT_CHANGED_METHOD, (params) => {
@@ -273,8 +275,9 @@ async function connect(options) {
     const mode = ctx.theme === "dark" ? "dark" : "light";
     const variables = ctx.styles?.variables;
     const tokens = variables && typeof variables === "object" ? variables : currentTheme.tokens;
-    currentTheme = { mode, tokens };
-    chunkKTXASIFJ_cjs.applyThemeVariables(mode, tokens);
+    const fontFaces = chunkIA2M4GTK_cjs.foldFontFaces(currentTheme.fontFaces, ctx);
+    currentTheme = { mode, tokens, ...fontFaces ? { fontFaces } : {} };
+    chunkIA2M4GTK_cjs.applyTheme(mode, tokens, fontFaces);
     const set = handlers.get(extApps.HOST_CONTEXT_CHANGED_METHOD);
     if (set) {
       for (const handler of set) handler(currentTheme);
@@ -398,30 +401,6 @@ async function connect(options) {
   return app;
 }
 
-// src/detection.ts
-var DEFAULT_THEME = {
-  mode: "light",
-  primaryColor: "#6366f1",
-  tokens: {}
-};
-function detectHost(initResponse) {
-  const resp = initResponse;
-  const hostName = resp?.hostInfo?.name ?? "unknown";
-  const protocolVersion = resp?.protocolVersion ?? "unknown";
-  return {
-    isNimbleBrain: hostName === "nimblebrain",
-    serverName: hostName,
-    protocolVersion
-  };
-}
-function extractTheme(ctx) {
-  if (!ctx) return { ...DEFAULT_THEME };
-  const mode = ctx.theme === "light" || ctx.theme === "dark" ? ctx.theme : DEFAULT_THEME.mode;
-  const variables = ctx.styles?.variables;
-  const tokens = variables && typeof variables === "object" && !Array.isArray(variables) ? variables : {};
-  return { mode, primaryColor: DEFAULT_THEME.primaryColor, tokens };
-}
-
 // src/keyboard.ts
 var KeyboardForwarder = class {
   listener;
@@ -610,6 +589,15 @@ function createSynapse(options) {
   const transport = new SynapseTransport();
   let hostInfo = null;
   let currentHostContext = {};
+  let currentFontFaces;
+  function syncFontFaces(ctx) {
+    currentFontFaces = chunkIA2M4GTK_cjs.foldFontFaces(currentFontFaces, ctx);
+    return currentFontFaces;
+  }
+  function resolveTheme(ctx) {
+    const theme = chunkIA2M4GTK_cjs.extractTheme(ctx);
+    return currentFontFaces ? { ...theme, fontFaces: currentFontFaces } : theme;
+  }
   let hostTasksCapability = null;
   let destroyed = false;
   const taskStatusRouter = createTaskStatusRouter(transport);
@@ -627,14 +615,14 @@ function createSynapse(options) {
     appCapabilities
   };
   const ready = transport.request(extApps.INITIALIZE_METHOD, initParams).then((result) => {
-    hostInfo = detectHost(result);
+    hostInfo = chunkIA2M4GTK_cjs.detectHost(result);
     currentHostContext = result?.hostContext ?? {};
     const initResult = result;
     const rawTasks = initResult?.hostCapabilities?.tasks;
     hostTasksCapability = rawTasks && typeof rawTasks === "object" && !Array.isArray(rawTasks) ? rawTasks : void 0;
     {
-      const theme = extractTheme(currentHostContext);
-      chunkKTXASIFJ_cjs.applyThemeVariables(theme.mode, theme.tokens);
+      const theme = chunkIA2M4GTK_cjs.extractTheme(currentHostContext);
+      chunkIA2M4GTK_cjs.applyTheme(theme.mode, theme.tokens, syncFontFaces(currentHostContext));
     }
     for (const cb of hostContextCallbacks) cb(currentHostContext);
     transport.send(extApps.INITIALIZED_METHOD, {});
@@ -642,8 +630,8 @@ function createSynapse(options) {
   });
   const unsubHostContext = transport.onMessage(extApps.HOST_CONTEXT_CHANGED_METHOD, (params) => {
     currentHostContext = params ?? {};
-    const theme = extractTheme(currentHostContext);
-    chunkKTXASIFJ_cjs.applyThemeVariables(theme.mode, theme.tokens);
+    const theme = chunkIA2M4GTK_cjs.extractTheme(currentHostContext);
+    chunkIA2M4GTK_cjs.applyTheme(theme.mode, theme.tokens, syncFontFaces(currentHostContext));
     for (const cb of hostContextCallbacks) cb(currentHostContext);
   });
   const hostContextCallbacks = /* @__PURE__ */ new Set();
@@ -734,7 +722,7 @@ function createSynapse(options) {
       };
     },
     getTheme() {
-      return extractTheme(currentHostContext);
+      return resolveTheme(currentHostContext);
     },
     // Selector over `onHostContextChanged`: only fires when the *derived*
     // theme actually changes, so theme subscribers don't see spurious
@@ -750,9 +738,9 @@ function createSynapse(options) {
     //    current derived theme, so a workspace-only `host-context-changed`
     //    notification correctly filters as a no-op.
     onThemeChanged(callback) {
-      let prev = hostInfo !== null ? extractTheme(currentHostContext) : null;
+      let prev = hostInfo !== null ? resolveTheme(currentHostContext) : null;
       const wrapped = (ctx) => {
-        const next = extractTheme(ctx);
+        const next = resolveTheme(ctx);
         if (prev !== null && themesEqual(prev, next)) return;
         prev = next;
         callback(next);
@@ -870,6 +858,7 @@ function validateFileResult(value) {
 }
 function themesEqual(a, b) {
   if (a.mode !== b.mode || a.primaryColor !== b.primaryColor) return false;
+  if (chunkIA2M4GTK_cjs.fontFacesKey(a.fontFaces) !== chunkIA2M4GTK_cjs.fontFacesKey(b.fontFaces)) return false;
   const aKeys = Object.keys(a.tokens);
   const bKeys = Object.keys(b.tokens);
   if (aKeys.length !== bKeys.length) return false;
@@ -881,5 +870,5 @@ function themesEqual(a, b) {
 
 exports.connect = connect;
 exports.createSynapse = createSynapse;
-//# sourceMappingURL=chunk-A4ENX6XW.cjs.map
-//# sourceMappingURL=chunk-A4ENX6XW.cjs.map
+//# sourceMappingURL=chunk-QHS7BJLI.cjs.map
+//# sourceMappingURL=chunk-QHS7BJLI.cjs.map