@salesforce/ui-theme-manager 11.46.0

package/dist/protocol/ootbThemes.js

@@ -0,0 +1,229 @@
+function createBuiltInThemes() {
+  return [
+    {
+      $schema: "https://salesforce.com/schema/theme.json",
+      metadata: {
+        developerName: "cosmos",
+        label: "Cosmos",
+        description: "Salesforce default theme with signature blues"
+      },
+      colors: {
+        primary: "#0176D3",
+        secondary: "#032D60",
+        background: "#FFFFFF",
+        surface: "#F3F3F3",
+        text: "#181818",
+        textSecondary: "#444444",
+        accent: "#0B5CAB",
+        error: "#BA0517",
+        success: "#2E844A"
+      },
+      typography: {
+        headingFamily: "'Inter', sans-serif",
+        bodyFamily: "'Inter', sans-serif",
+        baseFontSize: "16px",
+        headingWeight: "700",
+        bodyWeight: "400",
+        lineHeight: "1.5"
+      },
+      spacing: { density: "default", baseUnit: "8px" },
+      borders: { radius: "4px", radiusSmall: "2px", radiusLarge: "8px" },
+      buttons: {
+        primaryBg: "#0176D3",
+        primaryText: "#FFFFFF",
+        borderRadius: "4px",
+        paddingX: "16px",
+        paddingY: "8px"
+      },
+      logo: null
+    },
+    {
+      $schema: "https://salesforce.com/schema/theme.json",
+      metadata: {
+        developerName: "luxury_hotel",
+        label: "Luxury Hotel Portal",
+        description: "Sophisticated theme for a luxury hotel portal with gold accents"
+      },
+      colors: {
+        primary: "#1A365D",
+        secondary: "#C9A96E",
+        background: "#FAF9F7",
+        surface: "#FFFFFF",
+        text: "#1A202C",
+        textSecondary: "#4A5568",
+        accent: "#C5A54E",
+        error: "#D32F2F",
+        success: "#2E7D32"
+      },
+      typography: {
+        headingFamily: "'Playfair Display', serif",
+        bodyFamily: "'Inter', sans-serif",
+        baseFontSize: "16px",
+        headingWeight: "700",
+        bodyWeight: "400",
+        lineHeight: "1.6"
+      },
+      spacing: { density: "spacious", baseUnit: "8px" },
+      borders: { radius: "12px", radiusSmall: "6px", radiusLarge: "20px" },
+      buttons: {
+        primaryBg: "#C5A54E",
+        primaryText: "#FFFFFF",
+        borderRadius: "8px",
+        paddingX: "24px",
+        paddingY: "12px"
+      },
+      logo: null
+    },
+    {
+      $schema: "https://salesforce.com/schema/theme.json",
+      metadata: {
+        developerName: "midnight",
+        label: "Midnight",
+        description: "Dark theme with deep blues and purples"
+      },
+      colors: {
+        primary: "#6B5CE7",
+        secondary: "#A78BFA",
+        background: "#0F0F23",
+        surface: "#1A1A3E",
+        text: "#E8E8F0",
+        textSecondary: "#A0A0C0",
+        accent: "#8B5CF6",
+        error: "#F87171",
+        success: "#4ADE80"
+      },
+      typography: {
+        headingFamily: "'Inter', sans-serif",
+        bodyFamily: "'Inter', sans-serif",
+        baseFontSize: "16px",
+        headingWeight: "600",
+        bodyWeight: "400",
+        lineHeight: "1.6"
+      },
+      spacing: { density: "default", baseUnit: "8px" },
+      borders: { radius: "6px", radiusSmall: "3px", radiusLarge: "12px" },
+      buttons: {
+        primaryBg: "#6B5CE7",
+        primaryText: "#FFFFFF",
+        borderRadius: "6px",
+        paddingX: "20px",
+        paddingY: "10px"
+      },
+      logo: null
+    },
+    {
+      $schema: "https://salesforce.com/schema/theme.json",
+      metadata: {
+        developerName: "sunrise",
+        label: "Sunrise",
+        description: "Warm theme with vibrant oranges and yellows"
+      },
+      colors: {
+        primary: "#EA580C",
+        secondary: "#D97706",
+        background: "#FFFBF5",
+        surface: "#FEF3E2",
+        text: "#1C1917",
+        textSecondary: "#57534E",
+        accent: "#F59E0B",
+        error: "#DC2626",
+        success: "#16A34A"
+      },
+      typography: {
+        headingFamily: "'Inter', sans-serif",
+        bodyFamily: "'Inter', sans-serif",
+        baseFontSize: "16px",
+        headingWeight: "700",
+        bodyWeight: "400",
+        lineHeight: "1.5"
+      },
+      spacing: { density: "spacious", baseUnit: "8px" },
+      borders: { radius: "8px", radiusSmall: "4px", radiusLarge: "16px" },
+      buttons: {
+        primaryBg: "#EA580C",
+        primaryText: "#FFFFFF",
+        borderRadius: "8px",
+        paddingX: "18px",
+        paddingY: "10px"
+      },
+      logo: null
+    },
+    {
+      $schema: "https://salesforce.com/schema/theme.json",
+      metadata: {
+        developerName: "high_contrast",
+        label: "High Contrast",
+        description: "Maximum contrast for accessibility with bold colors"
+      },
+      colors: {
+        primary: "#000000",
+        secondary: "#1A1A1A",
+        background: "#FFFFFF",
+        surface: "#F5F5F5",
+        text: "#000000",
+        textSecondary: "#333333",
+        accent: "#0000FF",
+        error: "#CC0000",
+        success: "#006600"
+      },
+      typography: {
+        headingFamily: "'Inter', sans-serif",
+        bodyFamily: "'Inter', sans-serif",
+        baseFontSize: "18px",
+        headingWeight: "900",
+        bodyWeight: "500",
+        lineHeight: "1.6"
+      },
+      spacing: { density: "spacious", baseUnit: "10px" },
+      borders: { radius: "0px", radiusSmall: "0px", radiusLarge: "0px" },
+      buttons: {
+        primaryBg: "#000000",
+        primaryText: "#FFFFFF",
+        borderRadius: "0px",
+        paddingX: "20px",
+        paddingY: "12px"
+      },
+      logo: null
+    },
+    {
+      $schema: "https://salesforce.com/schema/theme.json",
+      metadata: {
+        developerName: "muted_professional",
+        label: "Muted Professional",
+        description: "Subtle grays and navy for a refined business look"
+      },
+      colors: {
+        primary: "#2C3E50",
+        secondary: "#34495E",
+        background: "#FAFBFC",
+        surface: "#EDF2F7",
+        text: "#2D3748",
+        textSecondary: "#718096",
+        accent: "#4A5568",
+        error: "#C53030",
+        success: "#38A169"
+      },
+      typography: {
+        headingFamily: "'Inter', sans-serif",
+        bodyFamily: "'Inter', sans-serif",
+        baseFontSize: "15px",
+        headingWeight: "600",
+        bodyWeight: "400",
+        lineHeight: "1.5"
+      },
+      spacing: { density: "compact", baseUnit: "6px" },
+      borders: { radius: "3px", radiusSmall: "2px", radiusLarge: "6px" },
+      buttons: {
+        primaryBg: "#2C3E50",
+        primaryText: "#FFFFFF",
+        borderRadius: "3px",
+        paddingX: "14px",
+        paddingY: "8px"
+      },
+      logo: null
+    }
+  ];
+}
+export {
+  createBuiltInThemes
+};

package/dist/protocol/themeCss.cjs

@@ -0,0 +1,47 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+function themeToVariables(theme) {
+  return {
+    "--tm-color-primary": theme.colors.primary,
+    "--tm-color-secondary": theme.colors.secondary,
+    "--tm-color-background": theme.colors.background,
+    "--tm-color-surface": theme.colors.surface,
+    "--tm-color-text": theme.colors.text,
+    "--tm-color-text-secondary": theme.colors.textSecondary,
+    "--tm-color-accent": theme.colors.accent,
+    "--tm-color-error": theme.colors.error,
+    "--tm-color-success": theme.colors.success,
+    "--tm-font-heading": theme.typography.headingFamily,
+    "--tm-font-body": theme.typography.bodyFamily,
+    "--tm-font-size-base": theme.typography.baseFontSize,
+    "--tm-heading-weight": theme.typography.headingWeight,
+    "--tm-body-weight": theme.typography.bodyWeight,
+    "--tm-line-height": theme.typography.lineHeight,
+    "--tm-spacing-base": theme.spacing.baseUnit,
+    "--tm-border-radius": theme.borders.radius,
+    "--tm-border-radius-small": theme.borders.radiusSmall,
+    "--tm-border-radius-large": theme.borders.radiusLarge,
+    "--tm-button-primary-bg": theme.buttons.primaryBg,
+    "--tm-button-primary-text": theme.buttons.primaryText,
+    "--tm-button-radius": theme.buttons.borderRadius,
+    "--tm-button-padding-x": theme.buttons.paddingX,
+    "--tm-button-padding-y": theme.buttons.paddingY
+  };
+}
+function generateThemeCss(theme) {
+  const vars = themeToVariables(theme);
+  const cssVars = Object.entries(vars).map(([key, value]) => `  ${key}: ${value};`).join("\n");
+  return `/**
+ * Theme: ${theme.metadata.label}
+ * ${theme.metadata.description}
+ * Developer Name: ${theme.metadata.developerName}
+ * Generated by Salesforce UI Theme Manager
+ */
+
+:root {
+${cssVars}
+}
+`;
+}
+exports.generateThemeCss = generateThemeCss;
+exports.themeToVariables = themeToVariables;

package/dist/protocol/themeCss.d.cts

@@ -0,0 +1,18 @@
+import { Theme } from './types.cjs';
+/**
+ * Maps a Theme object to a flat record of CSS custom properties.
+ * CSS variable names use the `--tm-*` prefix (theme-manager).
+ *
+ * @param theme - The theme to convert
+ * @returns Record of CSS variable names to values
+ */
+export declare function themeToVariables(theme: Theme): Record<string, string>;
+/**
+ * Generates a complete CSS stylesheet string with `:root` selector and
+ * all theme variables.
+ *
+ * @param theme - The theme to convert
+ * @returns CSS string ready for injection or file output
+ */
+export declare function generateThemeCss(theme: Theme): string;
+//# sourceMappingURL=themeCss.d.ts.map

package/dist/protocol/themeCss.d.ts

@@ -0,0 +1,18 @@
+import { Theme } from './types.js';
+/**
+ * Maps a Theme object to a flat record of CSS custom properties.
+ * CSS variable names use the `--tm-*` prefix (theme-manager).
+ *
+ * @param theme - The theme to convert
+ * @returns Record of CSS variable names to values
+ */
+export declare function themeToVariables(theme: Theme): Record<string, string>;
+/**
+ * Generates a complete CSS stylesheet string with `:root` selector and
+ * all theme variables.
+ *
+ * @param theme - The theme to convert
+ * @returns CSS string ready for injection or file output
+ */
+export declare function generateThemeCss(theme: Theme): string;
+//# sourceMappingURL=themeCss.d.ts.map

package/dist/protocol/themeCss.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"themeCss.d.ts","sourceRoot":"","sources":["../../src/protocol/themeCss.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAErC;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CA2BrE;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAiBrD"}

package/dist/protocol/themeCss.js

@@ -0,0 +1,47 @@
+function themeToVariables(theme) {
+  return {
+    "--tm-color-primary": theme.colors.primary,
+    "--tm-color-secondary": theme.colors.secondary,
+    "--tm-color-background": theme.colors.background,
+    "--tm-color-surface": theme.colors.surface,
+    "--tm-color-text": theme.colors.text,
+    "--tm-color-text-secondary": theme.colors.textSecondary,
+    "--tm-color-accent": theme.colors.accent,
+    "--tm-color-error": theme.colors.error,
+    "--tm-color-success": theme.colors.success,
+    "--tm-font-heading": theme.typography.headingFamily,
+    "--tm-font-body": theme.typography.bodyFamily,
+    "--tm-font-size-base": theme.typography.baseFontSize,
+    "--tm-heading-weight": theme.typography.headingWeight,
+    "--tm-body-weight": theme.typography.bodyWeight,
+    "--tm-line-height": theme.typography.lineHeight,
+    "--tm-spacing-base": theme.spacing.baseUnit,
+    "--tm-border-radius": theme.borders.radius,
+    "--tm-border-radius-small": theme.borders.radiusSmall,
+    "--tm-border-radius-large": theme.borders.radiusLarge,
+    "--tm-button-primary-bg": theme.buttons.primaryBg,
+    "--tm-button-primary-text": theme.buttons.primaryText,
+    "--tm-button-radius": theme.buttons.borderRadius,
+    "--tm-button-padding-x": theme.buttons.paddingX,
+    "--tm-button-padding-y": theme.buttons.paddingY
+  };
+}
+function generateThemeCss(theme) {
+  const vars = themeToVariables(theme);
+  const cssVars = Object.entries(vars).map(([key, value]) => `  ${key}: ${value};`).join("\n");
+  return `/**
+ * Theme: ${theme.metadata.label}
+ * ${theme.metadata.description}
+ * Developer Name: ${theme.metadata.developerName}
+ * Generated by Salesforce UI Theme Manager
+ */
+
+:root {
+${cssVars}
+}
+`;
+}
+export {
+  generateThemeCss,
+  themeToVariables
+};

package/dist/protocol/types.d.cts

@@ -0,0 +1,74 @@
+/**
+ * Copyright (c) 2026, Salesforce, Inc.,
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+/**
+ * Theme data model types.
+ *
+ * Evolution policy: Add new fields as optional. Never rename or remove fields.
+ * Never change field semantics. This schema is embedded in generated theme
+ * artifacts that may outlive the editor version that created them.
+ */
+export interface ThemeMetadata {
+    developerName: string;
+    label: string;
+    description: string;
+}
+export interface ThemeColors {
+    primary: string;
+    secondary: string;
+    background: string;
+    surface: string;
+    text: string;
+    textSecondary: string;
+    accent: string;
+    error: string;
+    success: string;
+}
+export interface ThemeTypography {
+    headingFamily: string;
+    bodyFamily: string;
+    baseFontSize: string;
+    headingWeight: string;
+    bodyWeight: string;
+    lineHeight: string;
+}
+export interface ThemeSpacing {
+    density: "compact" | "default" | "spacious";
+    baseUnit: string;
+}
+export interface ThemeBorders {
+    radius: string;
+    radiusSmall: string;
+    radiusLarge: string;
+}
+export interface ThemeButtons {
+    primaryBg: string;
+    primaryText: string;
+    borderRadius: string;
+    paddingX: string;
+    paddingY: string;
+}
+/**
+ * Root theme object. Portable across hosts.
+ */
+export interface Theme {
+    $schema: string;
+    metadata: ThemeMetadata;
+    colors: ThemeColors;
+    typography: ThemeTypography;
+    spacing: ThemeSpacing;
+    borders: ThemeBorders;
+    buttons: ThemeButtons;
+    logo: string | null;
+}
+/**
+ * Component-level style overrides. Allows per-component customization that
+ * overrides global theme tokens.
+ */
+export interface ComponentOverride {
+    component: string;
+    styles: Record<string, string>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/protocol/types.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Copyright (c) 2026, Salesforce, Inc.,
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+/**
+ * Theme data model types.
+ *
+ * Evolution policy: Add new fields as optional. Never rename or remove fields.
+ * Never change field semantics. This schema is embedded in generated theme
+ * artifacts that may outlive the editor version that created them.
+ */
+export interface ThemeMetadata {
+    developerName: string;
+    label: string;
+    description: string;
+}
+export interface ThemeColors {
+    primary: string;
+    secondary: string;
+    background: string;
+    surface: string;
+    text: string;
+    textSecondary: string;
+    accent: string;
+    error: string;
+    success: string;
+}
+export interface ThemeTypography {
+    headingFamily: string;
+    bodyFamily: string;
+    baseFontSize: string;
+    headingWeight: string;
+    bodyWeight: string;
+    lineHeight: string;
+}
+export interface ThemeSpacing {
+    density: "compact" | "default" | "spacious";
+    baseUnit: string;
+}
+export interface ThemeBorders {
+    radius: string;
+    radiusSmall: string;
+    radiusLarge: string;
+}
+export interface ThemeButtons {
+    primaryBg: string;
+    primaryText: string;
+    borderRadius: string;
+    paddingX: string;
+    paddingY: string;
+}
+/**
+ * Root theme object. Portable across hosts.
+ */
+export interface Theme {
+    $schema: string;
+    metadata: ThemeMetadata;
+    colors: ThemeColors;
+    typography: ThemeTypography;
+    spacing: ThemeSpacing;
+    borders: ThemeBorders;
+    buttons: ThemeButtons;
+    logo: string | null;
+}
+/**
+ * Component-level style overrides. Allows per-component customization that
+ * overrides global theme tokens.
+ */
+export interface ComponentOverride {
+    component: string;
+    styles: Record<string, string>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/protocol/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/protocol/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;GAMG;AAEH,MAAM,WAAW,aAAa;IAC7B,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,WAAW;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,eAAe;IAC/B,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC5B,OAAO,EAAE,SAAS,GAAG,SAAS,GAAG,UAAU,CAAC;IAC5C,QAAQ,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,YAAY;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,KAAK;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,aAAa,CAAC;IACxB,MAAM,EAAE,WAAW,CAAC;IACpB,UAAU,EAAE,eAAe,CAAC;IAC5B,OAAO,EAAE,YAAY,CAAC;IACtB,OAAO,EAAE,YAAY,CAAC;IACtB,OAAO,EAAE,YAAY,CAAC;IACtB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CACpB;AAED;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC/B"}

package/dist/protocol/utils.cjs

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+function escapeHtml(text) {
+  return text.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;");
+}
+function camelToLabel(str) {
+  return str.replace(/([A-Z])/g, " $1").replace(/^./, (s) => s.toUpperCase());
+}
+exports.camelToLabel = camelToLabel;
+exports.escapeHtml = escapeHtml;

package/dist/protocol/utils.d.cts

@@ -0,0 +1,20 @@
+/**
+ * Copyright (c) 2026, Salesforce, Inc.,
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+/**
+ * Escapes HTML special characters in a string.
+ *
+ * @param text - The text to escape
+ * @returns Escaped HTML string
+ */
+export declare function escapeHtml(text: string): string;
+/**
+ * Converts camelCase string to Title Case label.
+ *
+ * @param str - The camelCase string
+ * @returns Title Case label
+ */
+export declare function camelToLabel(str: string): string;
+//# sourceMappingURL=utils.d.ts.map

package/dist/protocol/utils.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Copyright (c) 2026, Salesforce, Inc.,
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+/**
+ * Escapes HTML special characters in a string.
+ *
+ * @param text - The text to escape
+ * @returns Escaped HTML string
+ */
+export declare function escapeHtml(text: string): string;
+/**
+ * Converts camelCase string to Title Case label.
+ *
+ * @param str - The camelCase string
+ * @returns Title Case label
+ */
+export declare function camelToLabel(str: string): string;
+//# sourceMappingURL=utils.d.ts.map

package/dist/protocol/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/protocol/utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAM/C;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEhD"}

package/dist/protocol/utils.js

@@ -0,0 +1,10 @@
+function escapeHtml(text) {
+  return text.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;");
+}
+function camelToLabel(str) {
+  return str.replace(/([A-Z])/g, " $1").replace(/^./, (s) => s.toUpperCase());
+}
+export {
+  camelToLabel,
+  escapeHtml
+};

package/dist/runtime/fontFace.cjs

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const KNOWN_FONTS = {
+  "Salesforce Sans": "https://c1.sfdcstatic.com/etc/clientlibs/sfdc-aem-master/clientlibs_base/fonts/SalesforceSans.woff2"
+};
+function generateFontFaceRules(brand) {
+  const rules = [];
+  const processedFonts = /* @__PURE__ */ new Set();
+  const addFontFace = (font) => {
+    if (!font || typeof font !== "object") return;
+    if (!("name" in font)) return;
+    const fontObj = font;
+    const name = fontObj.name;
+    if (processedFonts.has(name)) return;
+    processedFonts.add(name);
+    const fontUrl = fontObj.url || fontObj.src || fontObj.fontUrl || fontObj.woff2;
+    if (fontUrl) {
+      rules.push(`    @font-face {
+      font-family: "${name}";
+      src: url("${fontUrl}") format("woff2");
+      font-display: swap;
+    }`);
+      return;
+    }
+    if (KNOWN_FONTS[name]) {
+      rules.push(`    @font-face {
+      font-family: "${name}";
+      src: url("${KNOWN_FONTS[name]}") format("woff2");
+      font-display: swap;
+    }`);
+    }
+  };
+  if (brand.baseFontFamily) {
+    addFontFace(brand.baseFontFamily);
+  }
+  const heading1 = brand.typography?.heading?.heading1;
+  if (heading1?.fontFamily) {
+    addFontFace(heading1.fontFamily);
+  }
+  return rules.length > 0 ? "\n" + rules.join("\n") + "\n" : "";
+}
+exports.KNOWN_FONTS = KNOWN_FONTS;
+exports.generateFontFaceRules = generateFontFaceRules;

package/dist/runtime/fontFace.d.cts

@@ -0,0 +1,15 @@
+import { Brand } from '../protocol/brandTypes.cjs';
+/**
+ * Known Salesforce fonts that can be loaded from Salesforce CDN.
+ * Maps font family name to font file URL.
+ */
+export declare const KNOWN_FONTS: Record<string, string>;
+/**
+ * Generates @font-face rules for fonts that have a known source.
+ * Only emits rules for fonts actually used by the brand (body/heading).
+ *
+ * @param brand - The resolved brand object
+ * @returns CSS @font-face rules string (may be empty)
+ */
+export declare function generateFontFaceRules(brand: Brand): string;
+//# sourceMappingURL=fontFace.d.ts.map

package/dist/runtime/fontFace.d.ts

@@ -0,0 +1,15 @@
+import { Brand } from '../protocol/brandTypes.js';
+/**
+ * Known Salesforce fonts that can be loaded from Salesforce CDN.
+ * Maps font family name to font file URL.
+ */
+export declare const KNOWN_FONTS: Record<string, string>;
+/**
+ * Generates @font-face rules for fonts that have a known source.
+ * Only emits rules for fonts actually used by the brand (body/heading).
+ *
+ * @param brand - The resolved brand object
+ * @returns CSS @font-face rules string (may be empty)
+ */
+export declare function generateFontFaceRules(brand: Brand): string;
+//# sourceMappingURL=fontFace.d.ts.map

package/dist/runtime/fontFace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fontFace.d.ts","sourceRoot":"","sources":["../../src/runtime/fontFace.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAmB,MAAM,wBAAwB,CAAC;AAErE;;;GAGG;AACH,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAG9C,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAuD1D"}