@salesforce/ui-theme-manager 11.46.0

package/dist/protocol/brandCss.cjs

@@ -0,0 +1,255 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const brandResolver = require("./brandResolver.cjs");
+function formatDimension(dim) {
+  return `${dim.value}${dim.unit}`;
+}
+function buildFontStack(font) {
+  if (typeof font === "string" && font.startsWith("{!$brand")) {
+    return "system-ui, -apple-system, sans-serif";
+  }
+  if (typeof font === "string") {
+    const quoted = font.includes(" ") ? `"${font}"` : font;
+    return `${quoted}, sans-serif`;
+  }
+  if (typeof font === "object" && font && "name" in font) {
+    const fontObj = font;
+    const parts = [];
+    const quotedName = fontObj.name.includes(" ") ? `"${fontObj.name}"` : fontObj.name;
+    parts.push(quotedName);
+    if (fontObj.fallbacks && fontObj.fallbacks.length > 0) {
+      for (const fallback of fontObj.fallbacks) {
+        const quoted = fallback.includes(" ") ? `"${fallback}"` : fallback;
+        parts.push(quoted);
+      }
+    }
+    if (fontObj.category) {
+      parts.push(fontObj.category);
+    }
+    return parts.join(", ");
+  }
+  return "system-ui, -apple-system, sans-serif";
+}
+function brandToVariables(brand) {
+  const vars = {};
+  if (brand.colorScheme.primaryAccent) {
+    vars["--tm-color-primary"] = brand.colorScheme.primaryAccent;
+  }
+  if (brand.colorScheme.primaryAccentDerived) {
+    vars["--tm-color-secondary"] = brand.colorScheme.primaryAccentDerived;
+  }
+  if (brand.colorScheme.root) {
+    vars["--tm-color-background"] = brand.colorScheme.root;
+  }
+  if (brand.colorScheme.neutral) {
+    vars["--tm-color-surface"] = brand.colorScheme.neutral;
+    vars["--tm-color-text-secondary"] = brand.colorScheme.neutral;
+  }
+  if (brand.colorScheme.contrast) {
+    vars["--tm-color-text"] = brand.colorScheme.contrast;
+  }
+  if (brand.colorScheme.primaryAccentContrast) {
+    vars["--tm-color-accent"] = brand.colorScheme.primaryAccentContrast;
+  }
+  if (brand.baseFontFamily) {
+    const baseFont = brand.baseFontFamily;
+    vars["--tm-font-body"] = buildFontStack(baseFont);
+  }
+  const heading1 = brand.typography?.heading?.heading1;
+  if (heading1?.fontFamily) {
+    const headingFont = heading1.fontFamily;
+    vars["--tm-font-heading"] = buildFontStack(headingFont);
+  }
+  if (brand.baseFontSize) {
+    vars["--tm-font-size-base"] = formatDimension(brand.baseFontSize);
+  }
+  if (brand.fontWeight?.normal !== void 0) {
+    vars["--tm-body-weight"] = String(brand.fontWeight.normal);
+  }
+  if (brand.fontWeight?.bold !== void 0) {
+    vars["--tm-heading-weight"] = String(brand.fontWeight.bold);
+  }
+  const paragraph1 = brand.typography?.paragraph?.paragraph1;
+  if (paragraph1?.lineHeight !== void 0) {
+    vars["--tm-line-height"] = String(paragraph1.lineHeight);
+  }
+  if (brand.spacing?.medium?.top) {
+    vars["--tm-spacing-base"] = formatDimension(brand.spacing.medium.top);
+  }
+  if (brand.borderRadius?.round) {
+    const roundRadius = formatDimension(brand.borderRadius.round);
+    vars["--tm-border-radius"] = roundRadius;
+    vars["--tm-border-radius-small"] = roundRadius;
+    vars["--tm-border-radius-large"] = roundRadius;
+  }
+  const primaryButton = brand.buttonStyleGroup?.primary;
+  if (primaryButton) {
+    const colorGroup = primaryButton["lightning:buttonColorGroup"];
+    if (colorGroup?.backgroundColor) {
+      const bg = colorGroup.backgroundColor;
+      vars["--tm-button-primary-bg"] = typeof bg === "string" ? bg : "";
+    }
+    if (colorGroup?.textColor) {
+      const text = colorGroup.textColor;
+      vars["--tm-button-primary-text"] = typeof text === "string" ? text : "";
+    }
+    if (colorGroup?.borderColor) {
+      const border = colorGroup.borderColor;
+      vars["--tm-button-primary-border"] = typeof border === "string" ? border : "";
+    }
+    const borderRadius = primaryButton["lightning:borderRadius"];
+    if (borderRadius && typeof borderRadius === "object" && "unit" in borderRadius) {
+      vars["--tm-button-radius"] = formatDimension(borderRadius);
+    }
+    const borderWidth = primaryButton["lightning:borderWidth"];
+    if (borderWidth && typeof borderWidth === "object" && "unit" in borderWidth) {
+      vars["--tm-button-primary-border-width"] = formatDimension(borderWidth);
+    }
+    const padding = primaryButton["lightning:padding"];
+    if (padding?.left) {
+      vars["--tm-button-padding-x"] = formatDimension(padding.left);
+    }
+    if (padding?.top) {
+      vars["--tm-button-padding-y"] = formatDimension(padding.top);
+    }
+  }
+  const secondaryButton = brand.buttonStyleGroup?.secondary;
+  if (secondaryButton) {
+    const colorGroup = secondaryButton["lightning:buttonColorGroup"];
+    if (colorGroup?.backgroundColor) {
+      const bg = colorGroup.backgroundColor;
+      vars["--tm-button-secondary-bg"] = typeof bg === "string" ? bg : "";
+    }
+    if (colorGroup?.textColor) {
+      const text = colorGroup.textColor;
+      vars["--tm-button-secondary-text"] = typeof text === "string" ? text : "";
+    }
+    if (colorGroup?.borderColor) {
+      const border = colorGroup.borderColor;
+      vars["--tm-button-secondary-border"] = typeof border === "string" ? border : "";
+    }
+    const borderRadius = secondaryButton["lightning:borderRadius"];
+    if (borderRadius && typeof borderRadius === "object" && "unit" in borderRadius) {
+      vars["--tm-button-secondary-radius"] = formatDimension(borderRadius);
+    }
+    const borderWidth = secondaryButton["lightning:borderWidth"];
+    if (borderWidth && typeof borderWidth === "object" && "unit" in borderWidth) {
+      vars["--tm-button-secondary-border-width"] = formatDimension(borderWidth);
+    }
+    const padding = secondaryButton["lightning:padding"];
+    if (padding?.left) {
+      vars["--tm-button-secondary-padding-x"] = formatDimension(padding.left);
+    }
+    if (padding?.top) {
+      vars["--tm-button-secondary-padding-y"] = formatDimension(padding.top);
+    }
+  }
+  const tertiaryButton = brand.buttonStyleGroup?.tertiary;
+  if (tertiaryButton) {
+    const colorGroup = tertiaryButton["lightning:buttonColorGroup"];
+    if (colorGroup?.backgroundColor) {
+      const bg = colorGroup.backgroundColor;
+      vars["--tm-button-tertiary-bg"] = typeof bg === "string" ? bg : "";
+    }
+    if (colorGroup?.textColor) {
+      const text = colorGroup.textColor;
+      vars["--tm-button-tertiary-text"] = typeof text === "string" ? text : "";
+    }
+    if (colorGroup?.borderColor) {
+      const border = colorGroup.borderColor;
+      vars["--tm-button-tertiary-border"] = typeof border === "string" ? border : "";
+    }
+    const borderRadius = tertiaryButton["lightning:borderRadius"];
+    if (borderRadius && typeof borderRadius === "object" && "unit" in borderRadius) {
+      vars["--tm-button-tertiary-radius"] = formatDimension(borderRadius);
+    }
+    const borderWidth = tertiaryButton["lightning:borderWidth"];
+    if (borderWidth && typeof borderWidth === "object" && "unit" in borderWidth) {
+      vars["--tm-button-tertiary-border-width"] = formatDimension(borderWidth);
+    }
+    const padding = tertiaryButton["lightning:padding"];
+    if (padding?.left) {
+      vars["--tm-button-tertiary-padding-x"] = formatDimension(padding.left);
+    }
+    if (padding?.top) {
+      vars["--tm-button-tertiary-padding-y"] = formatDimension(padding.top);
+    }
+  }
+  for (let i = 1; i <= 6; i++) {
+    const heading = brand.typography?.heading?.[`heading${i}`];
+    if (heading && typeof heading === "object") {
+      if (heading.fontFamily) {
+        vars[`--tm-heading${i}-font`] = buildFontStack(heading.fontFamily);
+      }
+      if (heading.fontSize && typeof heading.fontSize === "object" && "unit" in heading.fontSize) {
+        vars[`--tm-heading${i}-size`] = formatDimension(heading.fontSize);
+      }
+      if (heading.fontWeight !== void 0) {
+        vars[`--tm-heading${i}-weight`] = String(heading.fontWeight);
+      }
+      if (heading.lineHeight !== void 0) {
+        vars[`--tm-heading${i}-line-height`] = String(heading.lineHeight);
+      }
+    }
+  }
+  const para1 = brand.typography?.paragraph?.paragraph1;
+  if (para1) {
+    if (para1.fontFamily) {
+      vars["--tm-paragraph1-font"] = buildFontStack(para1.fontFamily);
+    }
+    if (para1.fontSize && typeof para1.fontSize === "object" && "unit" in para1.fontSize) {
+      vars["--tm-paragraph1-size"] = formatDimension(para1.fontSize);
+    }
+    if (para1.fontWeight !== void 0) {
+      vars["--tm-paragraph1-weight"] = String(para1.fontWeight);
+    }
+    if (para1.lineHeight !== void 0) {
+      vars["--tm-paragraph1-line-height"] = String(para1.lineHeight);
+    }
+  }
+  const para2 = brand.typography?.paragraph?.paragraph2;
+  if (para2) {
+    if (para2.fontFamily) {
+      vars["--tm-paragraph2-font"] = buildFontStack(para2.fontFamily);
+    }
+    if (para2.fontSize && typeof para2.fontSize === "object" && "unit" in para2.fontSize) {
+      vars["--tm-paragraph2-size"] = formatDimension(para2.fontSize);
+    }
+    if (para2.fontWeight !== void 0) {
+      vars["--tm-paragraph2-weight"] = String(para2.fontWeight);
+    }
+    if (para2.lineHeight !== void 0) {
+      vars["--tm-paragraph2-line-height"] = String(para2.lineHeight);
+    }
+  }
+  if (brand.borderRadius?.square) {
+    vars["--tm-border-radius-square"] = formatDimension(brand.borderRadius.square);
+  }
+  if (brand.borderRadius?.round) {
+    vars["--tm-border-radius-round"] = formatDimension(brand.borderRadius.round);
+  }
+  if (brand.borderWeight?.medium) {
+    vars["--tm-border-weight-medium"] = formatDimension(brand.borderWeight.medium);
+  }
+  if (brand.borderWeight?.none) {
+    vars["--tm-border-weight-none"] = formatDimension(brand.borderWeight.none);
+  }
+  return vars;
+}
+function generateBrandCss(brand) {
+  const resolved = brandResolver.resolveBrandTokens(brand);
+  const vars = brandToVariables(resolved);
+  const cssVars = Object.entries(vars).map(([key, value]) => `  ${key}: ${value};`).join("\n");
+  const title = brand["sfdc_cms:title"] ?? "Untitled Brand";
+  return `/**
+ * Brand: ${title}
+ * Generated by Salesforce UI Theme Manager
+ */
+
+:root {
+${cssVars}
+}
+`;
+}
+exports.brandToVariables = brandToVariables;
+exports.generateBrandCss = generateBrandCss;

package/dist/protocol/brandCss.d.cts

@@ -0,0 +1,42 @@
+import { Brand } from './brandTypes.cjs';
+/**
+ * Maps a resolved Brand object to CSS custom properties using the `--tm-*` prefix.
+ * Reuses existing --tm-* variable names for semantic compatibility with the Theme preview.
+ *
+ * Mapping decisions:
+ * - colorScheme.primaryAccent -> --tm-color-primary
+ * - colorScheme.primaryAccentDerived -> --tm-color-secondary
+ * - colorScheme.root -> --tm-color-background
+ * - colorScheme.neutral -> --tm-color-surface
+ * - colorScheme.contrast -> --tm-color-text
+ * - colorScheme.neutral -> --tm-color-text-secondary (reused; no better match in sample)
+ * - colorScheme.primaryAccentContrast -> --tm-color-accent
+ * - baseFontFamily (resolved to font name) -> --tm-font-body
+ * - typography.heading.heading1.fontFamily (resolved) -> --tm-font-heading
+ * - baseFontSize -> --tm-font-size-base
+ * - fontWeight.normal -> --tm-body-weight
+ * - fontWeight.bold -> --tm-heading-weight
+ * - typography.paragraph.paragraph1.lineHeight -> --tm-line-height
+ * - spacing.medium -> --tm-spacing-base
+ * - borderRadius.round -> --tm-border-radius
+ * - borderRadius.round (reused) -> --tm-border-radius-small
+ * - borderRadius.round (reused) -> --tm-border-radius-large
+ * - buttonStyleGroup.primary buttonColorGroup.backgroundColor -> --tm-button-primary-bg
+ * - buttonStyleGroup.primary buttonColorGroup.textColor -> --tm-button-primary-text
+ * - buttonStyleGroup.primary lightning:borderRadius -> --tm-button-radius
+ * - buttonStyleGroup.primary lightning:padding left/right -> --tm-button-padding-x
+ * - buttonStyleGroup.primary lightning:padding top/bottom -> --tm-button-padding-y
+ *
+ * @param brand - The brand object (should be resolved first)
+ * @returns Record of CSS variable names to values
+ */
+export declare function brandToVariables(brand: Brand): Record<string, string>;
+/**
+ * Generates a complete CSS stylesheet string with `:root` selector and
+ * all brand variables.
+ *
+ * @param brand - The brand to convert (will be resolved automatically)
+ * @returns CSS string ready for injection or file output
+ */
+export declare function generateBrandCss(brand: Brand): string;
+//# sourceMappingURL=brandCss.d.ts.map

package/dist/protocol/brandCss.d.ts

@@ -0,0 +1,42 @@
+import { Brand } from './brandTypes.js';
+/**
+ * Maps a resolved Brand object to CSS custom properties using the `--tm-*` prefix.
+ * Reuses existing --tm-* variable names for semantic compatibility with the Theme preview.
+ *
+ * Mapping decisions:
+ * - colorScheme.primaryAccent -> --tm-color-primary
+ * - colorScheme.primaryAccentDerived -> --tm-color-secondary
+ * - colorScheme.root -> --tm-color-background
+ * - colorScheme.neutral -> --tm-color-surface
+ * - colorScheme.contrast -> --tm-color-text
+ * - colorScheme.neutral -> --tm-color-text-secondary (reused; no better match in sample)
+ * - colorScheme.primaryAccentContrast -> --tm-color-accent
+ * - baseFontFamily (resolved to font name) -> --tm-font-body
+ * - typography.heading.heading1.fontFamily (resolved) -> --tm-font-heading
+ * - baseFontSize -> --tm-font-size-base
+ * - fontWeight.normal -> --tm-body-weight
+ * - fontWeight.bold -> --tm-heading-weight
+ * - typography.paragraph.paragraph1.lineHeight -> --tm-line-height
+ * - spacing.medium -> --tm-spacing-base
+ * - borderRadius.round -> --tm-border-radius
+ * - borderRadius.round (reused) -> --tm-border-radius-small
+ * - borderRadius.round (reused) -> --tm-border-radius-large
+ * - buttonStyleGroup.primary buttonColorGroup.backgroundColor -> --tm-button-primary-bg
+ * - buttonStyleGroup.primary buttonColorGroup.textColor -> --tm-button-primary-text
+ * - buttonStyleGroup.primary lightning:borderRadius -> --tm-button-radius
+ * - buttonStyleGroup.primary lightning:padding left/right -> --tm-button-padding-x
+ * - buttonStyleGroup.primary lightning:padding top/bottom -> --tm-button-padding-y
+ *
+ * @param brand - The brand object (should be resolved first)
+ * @returns Record of CSS variable names to values
+ */
+export declare function brandToVariables(brand: Brand): Record<string, string>;
+/**
+ * Generates a complete CSS stylesheet string with `:root` selector and
+ * all brand variables.
+ *
+ * @param brand - The brand to convert (will be resolved automatically)
+ * @returns CSS string ready for injection or file output
+ */
+export declare function generateBrandCss(brand: Brand): string;
+//# sourceMappingURL=brandCss.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"brandCss.d.ts","sourceRoot":"","sources":["../../src/protocol/brandCss.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,KAAK,EAAmC,MAAM,cAAc,CAAC;AAyD3E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAiPrE;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAkBrD"}

package/dist/protocol/brandCss.js

@@ -0,0 +1,255 @@
+import { resolveBrandTokens } from "./brandResolver.js";
+function formatDimension(dim) {
+  return `${dim.value}${dim.unit}`;
+}
+function buildFontStack(font) {
+  if (typeof font === "string" && font.startsWith("{!$brand")) {
+    return "system-ui, -apple-system, sans-serif";
+  }
+  if (typeof font === "string") {
+    const quoted = font.includes(" ") ? `"${font}"` : font;
+    return `${quoted}, sans-serif`;
+  }
+  if (typeof font === "object" && font && "name" in font) {
+    const fontObj = font;
+    const parts = [];
+    const quotedName = fontObj.name.includes(" ") ? `"${fontObj.name}"` : fontObj.name;
+    parts.push(quotedName);
+    if (fontObj.fallbacks && fontObj.fallbacks.length > 0) {
+      for (const fallback of fontObj.fallbacks) {
+        const quoted = fallback.includes(" ") ? `"${fallback}"` : fallback;
+        parts.push(quoted);
+      }
+    }
+    if (fontObj.category) {
+      parts.push(fontObj.category);
+    }
+    return parts.join(", ");
+  }
+  return "system-ui, -apple-system, sans-serif";
+}
+function brandToVariables(brand) {
+  const vars = {};
+  if (brand.colorScheme.primaryAccent) {
+    vars["--tm-color-primary"] = brand.colorScheme.primaryAccent;
+  }
+  if (brand.colorScheme.primaryAccentDerived) {
+    vars["--tm-color-secondary"] = brand.colorScheme.primaryAccentDerived;
+  }
+  if (brand.colorScheme.root) {
+    vars["--tm-color-background"] = brand.colorScheme.root;
+  }
+  if (brand.colorScheme.neutral) {
+    vars["--tm-color-surface"] = brand.colorScheme.neutral;
+    vars["--tm-color-text-secondary"] = brand.colorScheme.neutral;
+  }
+  if (brand.colorScheme.contrast) {
+    vars["--tm-color-text"] = brand.colorScheme.contrast;
+  }
+  if (brand.colorScheme.primaryAccentContrast) {
+    vars["--tm-color-accent"] = brand.colorScheme.primaryAccentContrast;
+  }
+  if (brand.baseFontFamily) {
+    const baseFont = brand.baseFontFamily;
+    vars["--tm-font-body"] = buildFontStack(baseFont);
+  }
+  const heading1 = brand.typography?.heading?.heading1;
+  if (heading1?.fontFamily) {
+    const headingFont = heading1.fontFamily;
+    vars["--tm-font-heading"] = buildFontStack(headingFont);
+  }
+  if (brand.baseFontSize) {
+    vars["--tm-font-size-base"] = formatDimension(brand.baseFontSize);
+  }
+  if (brand.fontWeight?.normal !== void 0) {
+    vars["--tm-body-weight"] = String(brand.fontWeight.normal);
+  }
+  if (brand.fontWeight?.bold !== void 0) {
+    vars["--tm-heading-weight"] = String(brand.fontWeight.bold);
+  }
+  const paragraph1 = brand.typography?.paragraph?.paragraph1;
+  if (paragraph1?.lineHeight !== void 0) {
+    vars["--tm-line-height"] = String(paragraph1.lineHeight);
+  }
+  if (brand.spacing?.medium?.top) {
+    vars["--tm-spacing-base"] = formatDimension(brand.spacing.medium.top);
+  }
+  if (brand.borderRadius?.round) {
+    const roundRadius = formatDimension(brand.borderRadius.round);
+    vars["--tm-border-radius"] = roundRadius;
+    vars["--tm-border-radius-small"] = roundRadius;
+    vars["--tm-border-radius-large"] = roundRadius;
+  }
+  const primaryButton = brand.buttonStyleGroup?.primary;
+  if (primaryButton) {
+    const colorGroup = primaryButton["lightning:buttonColorGroup"];
+    if (colorGroup?.backgroundColor) {
+      const bg = colorGroup.backgroundColor;
+      vars["--tm-button-primary-bg"] = typeof bg === "string" ? bg : "";
+    }
+    if (colorGroup?.textColor) {
+      const text = colorGroup.textColor;
+      vars["--tm-button-primary-text"] = typeof text === "string" ? text : "";
+    }
+    if (colorGroup?.borderColor) {
+      const border = colorGroup.borderColor;
+      vars["--tm-button-primary-border"] = typeof border === "string" ? border : "";
+    }
+    const borderRadius = primaryButton["lightning:borderRadius"];
+    if (borderRadius && typeof borderRadius === "object" && "unit" in borderRadius) {
+      vars["--tm-button-radius"] = formatDimension(borderRadius);
+    }
+    const borderWidth = primaryButton["lightning:borderWidth"];
+    if (borderWidth && typeof borderWidth === "object" && "unit" in borderWidth) {
+      vars["--tm-button-primary-border-width"] = formatDimension(borderWidth);
+    }
+    const padding = primaryButton["lightning:padding"];
+    if (padding?.left) {
+      vars["--tm-button-padding-x"] = formatDimension(padding.left);
+    }
+    if (padding?.top) {
+      vars["--tm-button-padding-y"] = formatDimension(padding.top);
+    }
+  }
+  const secondaryButton = brand.buttonStyleGroup?.secondary;
+  if (secondaryButton) {
+    const colorGroup = secondaryButton["lightning:buttonColorGroup"];
+    if (colorGroup?.backgroundColor) {
+      const bg = colorGroup.backgroundColor;
+      vars["--tm-button-secondary-bg"] = typeof bg === "string" ? bg : "";
+    }
+    if (colorGroup?.textColor) {
+      const text = colorGroup.textColor;
+      vars["--tm-button-secondary-text"] = typeof text === "string" ? text : "";
+    }
+    if (colorGroup?.borderColor) {
+      const border = colorGroup.borderColor;
+      vars["--tm-button-secondary-border"] = typeof border === "string" ? border : "";
+    }
+    const borderRadius = secondaryButton["lightning:borderRadius"];
+    if (borderRadius && typeof borderRadius === "object" && "unit" in borderRadius) {
+      vars["--tm-button-secondary-radius"] = formatDimension(borderRadius);
+    }
+    const borderWidth = secondaryButton["lightning:borderWidth"];
+    if (borderWidth && typeof borderWidth === "object" && "unit" in borderWidth) {
+      vars["--tm-button-secondary-border-width"] = formatDimension(borderWidth);
+    }
+    const padding = secondaryButton["lightning:padding"];
+    if (padding?.left) {
+      vars["--tm-button-secondary-padding-x"] = formatDimension(padding.left);
+    }
+    if (padding?.top) {
+      vars["--tm-button-secondary-padding-y"] = formatDimension(padding.top);
+    }
+  }
+  const tertiaryButton = brand.buttonStyleGroup?.tertiary;
+  if (tertiaryButton) {
+    const colorGroup = tertiaryButton["lightning:buttonColorGroup"];
+    if (colorGroup?.backgroundColor) {
+      const bg = colorGroup.backgroundColor;
+      vars["--tm-button-tertiary-bg"] = typeof bg === "string" ? bg : "";
+    }
+    if (colorGroup?.textColor) {
+      const text = colorGroup.textColor;
+      vars["--tm-button-tertiary-text"] = typeof text === "string" ? text : "";
+    }
+    if (colorGroup?.borderColor) {
+      const border = colorGroup.borderColor;
+      vars["--tm-button-tertiary-border"] = typeof border === "string" ? border : "";
+    }
+    const borderRadius = tertiaryButton["lightning:borderRadius"];
+    if (borderRadius && typeof borderRadius === "object" && "unit" in borderRadius) {
+      vars["--tm-button-tertiary-radius"] = formatDimension(borderRadius);
+    }
+    const borderWidth = tertiaryButton["lightning:borderWidth"];
+    if (borderWidth && typeof borderWidth === "object" && "unit" in borderWidth) {
+      vars["--tm-button-tertiary-border-width"] = formatDimension(borderWidth);
+    }
+    const padding = tertiaryButton["lightning:padding"];
+    if (padding?.left) {
+      vars["--tm-button-tertiary-padding-x"] = formatDimension(padding.left);
+    }
+    if (padding?.top) {
+      vars["--tm-button-tertiary-padding-y"] = formatDimension(padding.top);
+    }
+  }
+  for (let i = 1; i <= 6; i++) {
+    const heading = brand.typography?.heading?.[`heading${i}`];
+    if (heading && typeof heading === "object") {
+      if (heading.fontFamily) {
+        vars[`--tm-heading${i}-font`] = buildFontStack(heading.fontFamily);
+      }
+      if (heading.fontSize && typeof heading.fontSize === "object" && "unit" in heading.fontSize) {
+        vars[`--tm-heading${i}-size`] = formatDimension(heading.fontSize);
+      }
+      if (heading.fontWeight !== void 0) {
+        vars[`--tm-heading${i}-weight`] = String(heading.fontWeight);
+      }
+      if (heading.lineHeight !== void 0) {
+        vars[`--tm-heading${i}-line-height`] = String(heading.lineHeight);
+      }
+    }
+  }
+  const para1 = brand.typography?.paragraph?.paragraph1;
+  if (para1) {
+    if (para1.fontFamily) {
+      vars["--tm-paragraph1-font"] = buildFontStack(para1.fontFamily);
+    }
+    if (para1.fontSize && typeof para1.fontSize === "object" && "unit" in para1.fontSize) {
+      vars["--tm-paragraph1-size"] = formatDimension(para1.fontSize);
+    }
+    if (para1.fontWeight !== void 0) {
+      vars["--tm-paragraph1-weight"] = String(para1.fontWeight);
+    }
+    if (para1.lineHeight !== void 0) {
+      vars["--tm-paragraph1-line-height"] = String(para1.lineHeight);
+    }
+  }
+  const para2 = brand.typography?.paragraph?.paragraph2;
+  if (para2) {
+    if (para2.fontFamily) {
+      vars["--tm-paragraph2-font"] = buildFontStack(para2.fontFamily);
+    }
+    if (para2.fontSize && typeof para2.fontSize === "object" && "unit" in para2.fontSize) {
+      vars["--tm-paragraph2-size"] = formatDimension(para2.fontSize);
+    }
+    if (para2.fontWeight !== void 0) {
+      vars["--tm-paragraph2-weight"] = String(para2.fontWeight);
+    }
+    if (para2.lineHeight !== void 0) {
+      vars["--tm-paragraph2-line-height"] = String(para2.lineHeight);
+    }
+  }
+  if (brand.borderRadius?.square) {
+    vars["--tm-border-radius-square"] = formatDimension(brand.borderRadius.square);
+  }
+  if (brand.borderRadius?.round) {
+    vars["--tm-border-radius-round"] = formatDimension(brand.borderRadius.round);
+  }
+  if (brand.borderWeight?.medium) {
+    vars["--tm-border-weight-medium"] = formatDimension(brand.borderWeight.medium);
+  }
+  if (brand.borderWeight?.none) {
+    vars["--tm-border-weight-none"] = formatDimension(brand.borderWeight.none);
+  }
+  return vars;
+}
+function generateBrandCss(brand) {
+  const resolved = resolveBrandTokens(brand);
+  const vars = brandToVariables(resolved);
+  const cssVars = Object.entries(vars).map(([key, value]) => `  ${key}: ${value};`).join("\n");
+  const title = brand["sfdc_cms:title"] ?? "Untitled Brand";
+  return `/**
+ * Brand: ${title}
+ * Generated by Salesforce UI Theme Manager
+ */
+
+:root {
+${cssVars}
+}
+`;
+}
+export {
+  brandToVariables,
+  generateBrandCss
+};

package/dist/protocol/brandResolver.cjs

@@ -0,0 +1,61 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const BRAND_REF_PATTERN = /^\{!\$brand\.([^}]+)\}$/;
+const MAX_RESOLVE_DEPTH = 10;
+function isBrandRef(value) {
+  return typeof value === "string" && BRAND_REF_PATTERN.test(value);
+}
+function resolveRef(brand, ref, depth = 0) {
+  if (depth > MAX_RESOLVE_DEPTH) {
+    throw new Error(`Max resolution depth exceeded resolving: ${ref}`);
+  }
+  if (!isBrandRef(ref)) {
+    return ref;
+  }
+  const match = ref.match(BRAND_REF_PATTERN);
+  if (!match || !match[1]) {
+    return ref;
+  }
+  const path = match[1];
+  const parts = path.split(".");
+  let current = brand;
+  for (const part of parts) {
+    if (current == null || typeof current !== "object") {
+      throw new Error(`Invalid reference path: ${ref} (failed at ${part})`);
+    }
+    current = current[part];
+    if (current === void 0) {
+      throw new Error(`Reference not found: ${ref} (${part} is undefined)`);
+    }
+  }
+  if (isBrandRef(current)) {
+    return resolveRef(brand, current, depth + 1);
+  }
+  return current;
+}
+function resolveValue(brand, value) {
+  if (value == null) {
+    return value;
+  }
+  if (isBrandRef(value)) {
+    const resolved = resolveRef(brand, value);
+    return resolveValue(brand, resolved);
+  }
+  if (Array.isArray(value)) {
+    return value.map((item) => resolveValue(brand, item));
+  }
+  if (typeof value === "object") {
+    const result = {};
+    for (const [key, val] of Object.entries(value)) {
+      result[key] = resolveValue(brand, val);
+    }
+    return result;
+  }
+  return value;
+}
+function resolveBrandTokens(brand) {
+  return resolveValue(brand, brand);
+}
+exports.isBrandRef = isBrandRef;
+exports.resolveBrandTokens = resolveBrandTokens;
+exports.resolveRef = resolveRef;