@frontmcp/ui 0.5.1 → 0.6.0

package/esm/layouts/index.js

@@ -0,0 +1,892 @@
+// libs/ui/src/theme/cdn.ts
+var CDN = {
+  /**
+   * Tailwind CSS v4 Browser CDN
+   * Generates styles on-the-fly with @theme support
+   * @see https://tailwindcss.com/docs/installation/play-cdn
+   */
+  tailwind: "https://cdn.jsdelivr.net/npm/@tailwindcss/browser@4",
+  /**
+   * HTMX 2.x - High power tools for HTML
+   * Enables AJAX, WebSockets, Server Sent Events directly in HTML
+   * @see https://htmx.org
+   */
+  htmx: {
+    url: "https://cdnjs.cloudflare.com/ajax/libs/htmx/2.0.7/htmx.min.js",
+    integrity: "sha512-T6VLg/MJYMbLTmQ8VLvonbWg8VOvmDhXcOvHzCwo6ShdGuUU5SEcp1IAPXL4k9lVoMi8gRXl5K/S/zh43Y9rJA=="
+  },
+  /**
+   * Alpine.js - Lightweight reactive framework
+   * Used for more complex client-side interactions
+   * @see https://alpinejs.dev
+   */
+  alpine: {
+    url: "https://cdn.jsdelivr.net/npm/alpinejs@3.14.3/dist/cdn.min.js",
+    integrity: "sha384-6zY8MFQJ/EqS1r4RJl+7j8rvZPuBWpT0RzWf+IFcKhxqUzQNmJzA1X1VEVZhYaEz"
+  },
+  /**
+   * Google Fonts - Inter for modern UI typography
+   */
+  fonts: {
+    preconnect: ["https://fonts.googleapis.com", "https://fonts.gstatic.com"],
+    inter: "https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700&display=swap",
+    mono: "https://fonts.googleapis.com/css2?family=JetBrains+Mono:wght@400;500;600&display=swap"
+  },
+  /**
+   * Lucide Icons - Beautiful & consistent icons
+   * @see https://lucide.dev
+   */
+  icons: {
+    url: "https://cdn.jsdelivr.net/npm/lucide@0.294.0/dist/umd/lucide.min.js",
+    integrity: "sha384-wpLmHb7v7V1LsEuTmPQ9tXqWZvTtRWWVqJuE+Yz6X0I6O2T6bHJVeXH1lVWqF4qE"
+  }
+};
+var scriptCache = /* @__PURE__ */ new Map();
+function getCachedScript(url) {
+  return scriptCache.get(url);
+}
+function isScriptCached(url) {
+  return scriptCache.has(url);
+}
+function buildFontPreconnect() {
+  return CDN.fonts.preconnect.map((url, i) => `<link rel="preconnect" href="${url}"${i > 0 ? " crossorigin" : ""}>`).join("\n  ");
+}
+function buildFontStylesheets(options = {}) {
+  const { inter = true, mono = false } = options;
+  const links = [];
+  if (inter) {
+    links.push(`<link href="${CDN.fonts.inter}" rel="stylesheet">`);
+  }
+  if (mono) {
+    links.push(`<link href="${CDN.fonts.mono}" rel="stylesheet">`);
+  }
+  return links.join("\n  ");
+}
+function buildScriptTag(url, integrity, options = {}) {
+  const attrs = [`src="${url}"`];
+  if (integrity) {
+    attrs.push(`integrity="${integrity}"`);
+    attrs.push('crossorigin="anonymous"');
+  }
+  if (options.defer) attrs.push("defer");
+  if (options.async) attrs.push("async");
+  return `<script ${attrs.join(" ")}></script>`;
+}
+function buildInlineScriptTag(content) {
+  return `<script>${content}</script>`;
+}
+function buildCdnScripts(options = {}) {
+  const { tailwind = true, htmx = true, alpine = false, icons = false, inline = false } = options;
+  const scripts = [];
+  if (inline) {
+    if (tailwind) {
+      if (isScriptCached(CDN.tailwind)) {
+        scripts.push(buildInlineScriptTag(getCachedScript(CDN.tailwind)));
+      } else {
+        console.warn(
+          "[frontmcp/ui] Inline mode requested but Tailwind script not cached. Call fetchAndCacheScripts() first."
+        );
+      }
+    }
+    if (htmx) {
+      if (isScriptCached(CDN.htmx.url)) {
+        scripts.push(buildInlineScriptTag(getCachedScript(CDN.htmx.url)));
+      } else {
+        console.warn(
+          "[frontmcp/ui] Inline mode requested but HTMX script not cached. Call fetchAndCacheScripts() first."
+        );
+      }
+    }
+    if (alpine) {
+      if (isScriptCached(CDN.alpine.url)) {
+        scripts.push(buildInlineScriptTag(getCachedScript(CDN.alpine.url)));
+      } else {
+        console.warn(
+          "[frontmcp/ui] Inline mode requested but Alpine.js script not cached. Call fetchAndCacheScripts() first."
+        );
+      }
+    }
+    if (icons) {
+      if (isScriptCached(CDN.icons.url)) {
+        scripts.push(buildInlineScriptTag(getCachedScript(CDN.icons.url)));
+      } else {
+        console.warn(
+          "[frontmcp/ui] Inline mode requested but Lucide icons script not cached. Call fetchAndCacheScripts() first."
+        );
+      }
+    }
+  } else {
+    if (tailwind) {
+      scripts.push(buildScriptTag(CDN.tailwind));
+    }
+    if (htmx) {
+      scripts.push(buildScriptTag(CDN.htmx.url, CDN.htmx.integrity));
+    }
+    if (alpine) {
+      scripts.push(buildScriptTag(CDN.alpine.url, CDN.alpine.integrity, { defer: true }));
+    }
+    if (icons) {
+      scripts.push(buildScriptTag(CDN.icons.url, CDN.icons.integrity));
+    }
+  }
+  return scripts.join("\n  ");
+}
+
+// libs/ui/src/theme/platforms.ts
+var OPENAI_PLATFORM = {
+  id: "openai",
+  name: "OpenAI",
+  supportsWidgets: true,
+  supportsTailwind: true,
+  supportsHtmx: true,
+  networkMode: "full",
+  scriptStrategy: "cdn",
+  options: {
+    sdk: "apps-sdk",
+    version: "1.0"
+  }
+};
+var CLAUDE_PLATFORM = {
+  id: "claude",
+  name: "Claude (Artifacts)",
+  supportsWidgets: true,
+  supportsTailwind: true,
+  supportsHtmx: false,
+  // Network blocked, HTMX won't work for API calls
+  networkMode: "blocked",
+  scriptStrategy: "inline",
+  maxInlineSize: 100 * 1024,
+  // 100KB limit for artifacts
+  cspRestrictions: ["script-src 'unsafe-inline'", "connect-src 'none'"],
+  options: {
+    mode: "artifacts",
+    framework: "react"
+    // Claude artifacts prefer React
+  }
+};
+function canUseCdn(platform) {
+  return platform.networkMode === "full" && platform.scriptStrategy === "cdn";
+}
+function needsInlineScripts(platform) {
+  return platform.scriptStrategy === "inline" || platform.networkMode === "blocked";
+}
+
+// libs/ui/src/theme/presets/github-openai.ts
+var GITHUB_OPENAI_THEME = {
+  name: "github-openai",
+  colors: {
+    semantic: {
+      // Primary: Near-black for main actions and branding
+      primary: "#24292f",
+      // Secondary: Medium gray for secondary elements
+      secondary: "#57606a",
+      // Accent: Blue for links, focus states, and highlights
+      accent: "#0969da",
+      // Status colors
+      success: "#1a7f37",
+      // GitHub green
+      warning: "#9a6700",
+      // Amber warning
+      danger: "#cf222e",
+      // GitHub red
+      info: "#0969da"
+      // Blue info
+    },
+    surface: {
+      // Pure white background
+      background: "#ffffff",
+      // Light gray surface (GitHub code background style)
+      surface: "#f6f8fa",
+      // White elevated surfaces (modals, cards)
+      elevated: "#ffffff",
+      // Dark semi-transparent overlay
+      overlay: "rgba(27, 31, 36, 0.5)"
+    },
+    text: {
+      // Near-black for primary text
+      primary: "#24292f",
+      // Gray for secondary/muted text
+      secondary: "#57606a",
+      // Light gray for disabled text
+      disabled: "#8c959f",
+      // White for text on dark backgrounds
+      inverse: "#ffffff",
+      // Blue for links
+      link: "#0969da"
+    },
+    border: {
+      // Light gray border (GitHub style)
+      default: "#d0d7de",
+      // Medium gray on hover
+      hover: "#8c959f",
+      // Blue focus ring
+      focus: "#0969da",
+      // Subtle divider
+      divider: "#d8dee4"
+    }
+  },
+  typography: {
+    families: {
+      // System UI font stack (GitHub/Apple style)
+      sans: '-apple-system, BlinkMacSystemFont, "Segoe UI", "Noto Sans", Helvetica, Arial, sans-serif, "Apple Color Emoji", "Segoe UI Emoji"',
+      // Monospace stack
+      mono: 'ui-monospace, SFMono-Regular, SF Mono, Menlo, Consolas, "Liberation Mono", monospace'
+    },
+    sizes: {
+      xs: "0.75rem",
+      // 12px
+      sm: "0.875rem",
+      // 14px
+      base: "1rem",
+      // 16px
+      lg: "1.125rem",
+      // 18px
+      xl: "1.25rem",
+      // 20px
+      "2xl": "1.5rem",
+      // 24px
+      "3xl": "1.875rem",
+      // 30px
+      "4xl": "2.25rem"
+      // 36px
+    },
+    weights: {
+      normal: "400",
+      medium: "500",
+      semibold: "600",
+      bold: "700"
+    }
+  },
+  radius: {
+    none: "0",
+    sm: "3px",
+    // GitHub uses smaller radii
+    md: "6px",
+    lg: "8px",
+    xl: "12px",
+    "2xl": "16px",
+    full: "9999px"
+  },
+  shadows: {
+    // Subtle shadows with gray tones
+    sm: "0 1px 0 rgba(27, 31, 36, 0.04)",
+    md: "0 3px 6px rgba(140, 149, 159, 0.15)",
+    lg: "0 8px 24px rgba(140, 149, 159, 0.2)",
+    xl: "0 12px 28px rgba(140, 149, 159, 0.3)"
+  },
+  components: {
+    button: {
+      radius: "6px",
+      paddingX: "16px",
+      paddingY: "5px",
+      fontSize: "14px",
+      fontWeight: "500"
+    },
+    card: {
+      radius: "6px",
+      padding: "16px",
+      shadow: "0 1px 0 rgba(27, 31, 36, 0.04)",
+      borderWidth: "1px"
+    },
+    input: {
+      radius: "6px",
+      paddingX: "12px",
+      paddingY: "5px",
+      borderWidth: "1px",
+      focusRingWidth: "3px"
+    }
+  },
+  cdn: {
+    fonts: {
+      preconnect: ["https://fonts.googleapis.com", "https://fonts.gstatic.com"],
+      stylesheets: [
+        // System UI fonts don't need external stylesheets, but we include
+        // Inter as an optional enhancement for consistent cross-platform rendering
+        "https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700&display=swap"
+      ]
+    },
+    icons: {
+      script: {
+        url: "https://cdn.jsdelivr.net/npm/lucide@0.294.0/dist/umd/lucide.min.js"
+      }
+    },
+    scripts: {
+      tailwind: "https://cdn.jsdelivr.net/npm/@tailwindcss/browser@4",
+      htmx: {
+        url: "https://cdnjs.cloudflare.com/ajax/libs/htmx/2.0.7/htmx.min.js",
+        integrity: "sha512-T6VLg/MJYMbLTmQ8VLvonbWg8VOvmDhXcOvHzCwo6ShdGuUU5SEcp1IAPXL4k9lVoMi8gRXl5K/S/zh43Y9rJA=="
+      },
+      alpine: {
+        url: "https://cdn.jsdelivr.net/npm/alpinejs@3.14.3/dist/cdn.min.js",
+        integrity: "sha384-6zY8MFQJ/EqS1r4RJl+7j8rvZPuBWpT0RzWf+IFcKhxqUzQNmJzA1X1VEVZhYaEz"
+      }
+    }
+  }
+};
+var DEFAULT_THEME = GITHUB_OPENAI_THEME;
+
+// libs/ui/src/theme/theme.ts
+function mergeThemesCore(base, override) {
+  const baseColors = base.colors ?? { semantic: { primary: "#24292f" } };
+  const filterStrings = (arr) => arr.filter((s) => s !== void 0);
+  return {
+    ...base,
+    ...override,
+    colors: {
+      ...baseColors,
+      ...override.colors,
+      semantic: { ...baseColors.semantic, ...override.colors?.semantic },
+      surface: { ...baseColors.surface, ...override.colors?.surface },
+      text: { ...baseColors.text, ...override.colors?.text },
+      border: { ...baseColors.border, ...override.colors?.border },
+      custom: { ...baseColors.custom, ...override.colors?.custom }
+    },
+    typography: {
+      ...base.typography,
+      ...override.typography,
+      families: { ...base.typography?.families, ...override.typography?.families },
+      sizes: { ...base.typography?.sizes, ...override.typography?.sizes },
+      weights: { ...base.typography?.weights, ...override.typography?.weights },
+      lineHeight: { ...base.typography?.lineHeight, ...override.typography?.lineHeight }
+    },
+    spacing: { ...base.spacing, ...override.spacing },
+    radius: { ...base.radius, ...override.radius },
+    shadows: { ...base.shadows, ...override.shadows },
+    components: {
+      ...base.components,
+      ...override.components,
+      button: { ...base.components?.button, ...override.components?.button },
+      card: { ...base.components?.card, ...override.components?.card },
+      input: { ...base.components?.input, ...override.components?.input }
+    },
+    cdn: {
+      ...base.cdn,
+      ...override.cdn,
+      fonts: {
+        // Concatenate then dedupe so base entries are preserved without duplicates
+        preconnect: filterStrings(
+          Array.from(/* @__PURE__ */ new Set([...base.cdn?.fonts?.preconnect ?? [], ...override.cdn?.fonts?.preconnect ?? []]))
+        ),
+        stylesheets: filterStrings(
+          Array.from(/* @__PURE__ */ new Set([...base.cdn?.fonts?.stylesheets ?? [], ...override.cdn?.fonts?.stylesheets ?? []]))
+        )
+      },
+      icons: {
+        ...base.cdn?.icons,
+        ...override.cdn?.icons,
+        // Deep merge script to preserve integrity when only url is overridden
+        script: override.cdn?.icons?.script ? { ...base.cdn?.icons?.script, ...override.cdn?.icons?.script } : base.cdn?.icons?.script
+      },
+      scripts: {
+        // tailwind is a simple string, just use override or base
+        tailwind: override.cdn?.scripts?.tailwind ?? base.cdn?.scripts?.tailwind,
+        // Deep merge htmx/alpine to preserve integrity when only url is overridden
+        htmx: override.cdn?.scripts?.htmx ? { ...base.cdn?.scripts?.htmx, ...override.cdn?.scripts?.htmx } : base.cdn?.scripts?.htmx,
+        alpine: override.cdn?.scripts?.alpine ? { ...base.cdn?.scripts?.alpine, ...override.cdn?.scripts?.alpine } : base.cdn?.scripts?.alpine
+      }
+    },
+    customVars: { ...base.customVars, ...override.customVars },
+    customCss: [base.customCss, override.customCss].filter(Boolean).join("\n")
+  };
+}
+function mergeThemes(base, override) {
+  const merged = mergeThemesCore(base, override);
+  let darkVariant;
+  if (override.dark !== void 0) {
+    const darkBase = base.dark ?? base;
+    const { dark: _nestedDark, ...overrideDarkWithoutNested } = override.dark;
+    darkVariant = mergeThemesCore(darkBase, overrideDarkWithoutNested);
+  } else if (base.dark !== void 0) {
+    const { dark: _nestedDark, ...baseDarkWithoutNested } = base.dark;
+    darkVariant = baseDarkWithoutNested;
+  }
+  return {
+    ...merged,
+    dark: darkVariant
+  };
+}
+function emitColorScale(lines, name, scale) {
+  for (const [shade, value] of Object.entries(scale)) {
+    if (value) lines.push(`--color-${name}-${shade}: ${value};`);
+  }
+}
+function buildThemeCss(theme) {
+  const lines = [];
+  const semantic = theme.colors.semantic;
+  if (typeof semantic.primary === "string") {
+    lines.push(`--color-primary: ${semantic.primary};`);
+  } else if (semantic.primary) {
+    emitColorScale(lines, "primary", semantic.primary);
+  }
+  if (semantic.secondary) {
+    if (typeof semantic.secondary === "string") {
+      lines.push(`--color-secondary: ${semantic.secondary};`);
+    } else {
+      emitColorScale(lines, "secondary", semantic.secondary);
+    }
+  }
+  if (semantic.accent) {
+    if (typeof semantic.accent === "string") {
+      lines.push(`--color-accent: ${semantic.accent};`);
+    } else {
+      emitColorScale(lines, "accent", semantic.accent);
+    }
+  }
+  if (semantic.neutral) {
+    if (typeof semantic.neutral === "string") {
+      lines.push(`--color-neutral: ${semantic.neutral};`);
+    } else {
+      emitColorScale(lines, "neutral", semantic.neutral);
+    }
+  }
+  if (semantic.success) lines.push(`--color-success: ${semantic.success};`);
+  if (semantic.warning) lines.push(`--color-warning: ${semantic.warning};`);
+  if (semantic.danger) lines.push(`--color-danger: ${semantic.danger};`);
+  if (semantic.info) lines.push(`--color-info: ${semantic.info};`);
+  const surface = theme.colors.surface;
+  if (surface?.background) lines.push(`--color-background: ${surface.background};`);
+  if (surface?.surface) lines.push(`--color-surface: ${surface.surface};`);
+  if (surface?.elevated) lines.push(`--color-elevated: ${surface.elevated};`);
+  if (surface?.overlay) lines.push(`--color-overlay: ${surface.overlay};`);
+  const text = theme.colors.text;
+  if (text?.primary) lines.push(`--color-text-primary: ${text.primary};`);
+  if (text?.secondary) lines.push(`--color-text-secondary: ${text.secondary};`);
+  if (text?.disabled) lines.push(`--color-text-disabled: ${text.disabled};`);
+  if (text?.inverse) lines.push(`--color-text-inverse: ${text.inverse};`);
+  if (text?.link) lines.push(`--color-text-link: ${text.link};`);
+  const border = theme.colors.border;
+  if (border?.default) lines.push(`--color-border: ${border.default};`);
+  if (border?.hover) lines.push(`--color-border-hover: ${border.hover};`);
+  if (border?.focus) lines.push(`--color-border-focus: ${border.focus};`);
+  if (border?.divider) lines.push(`--color-divider: ${border.divider};`);
+  if (theme.colors.custom) {
+    for (const [key, value] of Object.entries(theme.colors.custom)) {
+      lines.push(`--color-${key}: ${value};`);
+    }
+  }
+  const typography = theme.typography;
+  if (typography?.families?.sans) lines.push(`--font-sans: ${typography.families.sans};`);
+  if (typography?.families?.serif) lines.push(`--font-serif: ${typography.families.serif};`);
+  if (typography?.families?.mono) lines.push(`--font-mono: ${typography.families.mono};`);
+  if (typography?.families?.display) lines.push(`--font-display: ${typography.families.display};`);
+  const radius = theme.radius;
+  if (radius?.none) lines.push(`--radius-none: ${radius.none};`);
+  if (radius?.sm) lines.push(`--radius-sm: ${radius.sm};`);
+  if (radius?.md) lines.push(`--radius-md: ${radius.md};`);
+  if (radius?.lg) lines.push(`--radius-lg: ${radius.lg};`);
+  if (radius?.xl) lines.push(`--radius-xl: ${radius.xl};`);
+  if (radius?.["2xl"]) lines.push(`--radius-2xl: ${radius["2xl"]};`);
+  if (radius?.full) lines.push(`--radius-full: ${radius.full};`);
+  if (theme.customVars) {
+    for (const [key, value] of Object.entries(theme.customVars)) {
+      lines.push(`${key}: ${value};`);
+    }
+  }
+  return lines.join("\n      ");
+}
+
+// libs/ui/src/utils/escape-html.ts
+function escapeHtml(str) {
+  if (str === null || str === void 0) {
+    return "";
+  }
+  const s = String(str);
+  return s.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&#39;").replace(/\u2028/g, "\\u2028").replace(/\u2029/g, "\\u2029");
+}
+
+// libs/ui/src/layouts/base.ts
+function getSizeClass(size) {
+  const sizeMap = {
+    xs: "max-w-sm",
+    sm: "max-w-md",
+    md: "max-w-lg",
+    lg: "max-w-xl",
+    xl: "max-w-2xl",
+    "2xl": "max-w-3xl",
+    "3xl": "max-w-4xl",
+    full: "max-w-full"
+  };
+  return sizeMap[size];
+}
+function getAlignmentClasses(alignment) {
+  const alignMap = {
+    center: "min-h-screen flex items-center justify-center",
+    top: "min-h-screen flex flex-col items-center pt-12",
+    start: "min-h-screen"
+  };
+  return alignMap[alignment];
+}
+function getBackgroundClasses(background, theme) {
+  switch (background) {
+    case "gradient":
+      return "bg-gradient-to-br from-primary to-secondary";
+    case "pattern":
+      return 'bg-surface bg-[url("data:image/svg+xml,...")]';
+    // Pattern would be defined
+    case "solid":
+      return "bg-background";
+    case "none":
+    default:
+      return "";
+  }
+}
+function buildMetaTags(options) {
+  const tags = [];
+  if (options.description) {
+    tags.push(`<meta name="description" content="${escapeHtml(options.description)}">`);
+  }
+  if (options.og) {
+    if (options.og.title) {
+      tags.push(`<meta property="og:title" content="${escapeHtml(options.og.title)}">`);
+    }
+    if (options.og.description) {
+      tags.push(`<meta property="og:description" content="${escapeHtml(options.og.description)}">`);
+    }
+    if (options.og.image) {
+      tags.push(`<meta property="og:image" content="${escapeHtml(options.og.image)}">`);
+    }
+    if (options.og.type) {
+      tags.push(`<meta property="og:type" content="${escapeHtml(options.og.type)}">`);
+    }
+  }
+  if (options.favicon) {
+    tags.push(`<link rel="icon" href="${escapeHtml(options.favicon)}">`);
+  }
+  return tags.join("\n  ");
+}
+function buildBodyAttrs(attrs) {
+  if (!attrs) return "";
+  return Object.entries(attrs).map(([key, value]) => `${key}="${escapeHtml(value)}"`).join(" ");
+}
+function baseLayout(content, options) {
+  const {
+    title,
+    pageType = "custom",
+    size = "md",
+    alignment = "center",
+    background = "solid",
+    platform = OPENAI_PLATFORM,
+    theme: themeOverrides,
+    includeHtmx,
+    includeAlpine = false,
+    includeIcons = false,
+    headExtra = "",
+    bodyAttrs,
+    bodyClass = "",
+    titleSuffix = "FrontMCP"
+  } = options;
+  const theme = themeOverrides ? mergeThemes(DEFAULT_THEME, themeOverrides) : DEFAULT_THEME;
+  const shouldIncludeHtmx = includeHtmx ?? platform.supportsHtmx;
+  const useCdn = canUseCdn(platform);
+  const useInline = needsInlineScripts(platform);
+  const fontPreconnect = useCdn ? buildFontPreconnect() : "";
+  const fontStylesheets = useCdn ? buildFontStylesheets({ inter: true }) : "";
+  const scripts = buildCdnScripts({
+    tailwind: platform.supportsTailwind,
+    htmx: shouldIncludeHtmx,
+    alpine: includeAlpine,
+    icons: includeIcons,
+    inline: useInline
+  });
+  const themeCss = buildThemeCss(theme);
+  const customCss = theme.customCss || "";
+  const styleBlock = platform.supportsTailwind ? `<style type="text/tailwindcss">
+    @theme {
+      ${themeCss}
+    }
+    ${customCss}
+  </style>` : "";
+  const sizeClass = getSizeClass(size);
+  const alignmentClasses = getAlignmentClasses(alignment);
+  const backgroundClasses = getBackgroundClasses(background, theme);
+  const allBodyClasses = [backgroundClasses, "font-sans antialiased", bodyClass].filter(Boolean).join(" ");
+  const metaTags = buildMetaTags(options);
+  const bodyAttrStr = buildBodyAttrs(bodyAttrs);
+  const wrappedContent = alignment === "center" ? `<div class="${alignmentClasses} p-4">
+    <div class="w-full ${sizeClass}">
+      ${content}
+    </div>
+  </div>` : `<div class="${alignmentClasses}">
+    <div class="w-full ${sizeClass} mx-auto px-4 py-8">
+      ${content}
+    </div>
+  </div>`;
+  return `<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>${escapeHtml(title)}${titleSuffix ? ` - ${escapeHtml(titleSuffix)}` : ""}</title>
+  ${metaTags}
+
+  <!-- Fonts -->
+  ${fontPreconnect}
+  ${fontStylesheets}
+
+  <!-- Tailwind CSS -->
+  ${scripts}
+  ${styleBlock}
+
+  ${headExtra}
+</head>
+<body class="${escapeHtml(allBodyClasses)}"${bodyAttrStr ? ` ${bodyAttrStr}` : ""}>
+  ${wrappedContent}
+</body>
+</html>`;
+}
+function createLayoutBuilder(defaults) {
+  return (content, options = {}) => {
+    let mergedTheme = DEFAULT_THEME;
+    if (defaults.theme) {
+      mergedTheme = mergeThemes(mergedTheme, defaults.theme);
+    }
+    if (options.theme) {
+      mergedTheme = mergeThemes(mergedTheme, options.theme);
+    }
+    const merged = {
+      ...defaults,
+      ...options,
+      theme: mergedTheme
+    };
+    if (!merged.title) {
+      throw new Error("createLayoutBuilder: title is required either in defaults or options");
+    }
+    return baseLayout(content, merged);
+  };
+}
+
+// libs/ui/src/layouts/presets.ts
+function authLayout(content, options) {
+  const { showBranding = true, logo, footer, ...baseOptions } = options;
+  const brandingHtml = showBranding && logo ? `<div class="text-center mb-8">${logo}</div>` : showBranding ? `<div class="text-center mb-8">
+          <div class="inline-flex items-center justify-center w-16 h-16 rounded-xl bg-gradient-to-br from-primary to-secondary mb-4">
+            <svg class="w-8 h-8 text-white" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+              <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M12 15v2m-6 4h12a2 2 0 002-2v-6a2 2 0 00-2-2H6a2 2 0 00-2 2v6a2 2 0 002 2zm10-10V7a4 4 0 00-8 0v4h8z"/>
+            </svg>
+          </div>
+        </div>` : "";
+  const footerHtml = footer ? `<div class="mt-8 text-center text-sm text-text-secondary">${footer}</div>` : "";
+  const wrappedContent = `
+    <div class="bg-white rounded-2xl shadow-xl p-8">
+      ${brandingHtml}
+      ${content}
+    </div>
+    ${footerHtml}
+  `;
+  return baseLayout(wrappedContent, {
+    ...baseOptions,
+    pageType: "auth",
+    size: baseOptions.size ?? "sm",
+    alignment: "center",
+    background: "gradient"
+  });
+}
+function consentLayout(content, options) {
+  const { clientName, clientIcon, userInfo, ...baseOptions } = options;
+  const headerHtml = clientName ? `<div class="text-center mb-6">
+        ${clientIcon ? `<img src="${escapeHtml(clientIcon)}" alt="${escapeHtml(
+    clientName
+  )}" class="w-16 h-16 rounded-xl mx-auto mb-4">` : `<div class="inline-flex items-center justify-center w-16 h-16 rounded-xl bg-gradient-to-br from-primary to-secondary text-white font-bold text-2xl mx-auto mb-4">
+              ${escapeHtml(clientName.charAt(0).toUpperCase())}
+            </div>`}
+        <h1 class="text-2xl font-bold text-text-primary">${escapeHtml(clientName)}</h1>
+      </div>` : "";
+  const userInfoHtml = userInfo ? `<div class="flex items-center gap-3 p-3 bg-gray-50 rounded-lg mb-6">
+        ${userInfo.avatar ? `<img src="${escapeHtml(userInfo.avatar)}" class="w-10 h-10 rounded-full">` : `<div class="w-10 h-10 rounded-full bg-primary text-white flex items-center justify-center font-medium">
+              ${escapeHtml((userInfo.name || userInfo.email || "U").charAt(0).toUpperCase())}
+            </div>`}
+        <div>
+          ${userInfo.name ? `<div class="font-medium text-text-primary">${escapeHtml(userInfo.name)}</div>` : ""}
+          ${userInfo.email ? `<div class="text-sm text-text-secondary">${escapeHtml(userInfo.email)}</div>` : ""}
+        </div>
+      </div>` : "";
+  const wrappedContent = `
+    ${headerHtml}
+    ${userInfoHtml}
+    ${content}
+  `;
+  return baseLayout(wrappedContent, {
+    ...baseOptions,
+    pageType: "consent",
+    size: baseOptions.size ?? "lg",
+    alignment: "top",
+    background: "solid"
+  });
+}
+function errorLayout(content, options) {
+  const {
+    errorCode,
+    errorTitle = "Something went wrong",
+    errorMessage,
+    showRetry = true,
+    retryUrl,
+    showHome = true,
+    homeUrl = "/",
+    ...baseOptions
+  } = options;
+  const errorHtml = `
+    <div class="text-center">
+      <!-- Error icon -->
+      <div class="inline-flex items-center justify-center w-20 h-20 rounded-full bg-danger/10 mb-6">
+        <svg class="w-10 h-10 text-danger" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+          <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M12 9v2m0 4h.01m-6.938 4h13.856c1.54 0 2.502-1.667 1.732-3L13.732 4c-.77-1.333-2.694-1.333-3.464 0L3.34 16c-.77 1.333.192 3 1.732 3z"/>
+        </svg>
+      </div>
+
+      ${errorCode ? `<p class="text-6xl font-bold text-danger mb-2">${escapeHtml(errorCode)}</p>` : ""}
+      <h1 class="text-2xl font-bold text-text-primary mb-4">${escapeHtml(errorTitle)}</h1>
+      ${errorMessage ? `<p class="text-text-secondary mb-8">${escapeHtml(errorMessage)}</p>` : ""}
+
+      ${content}
+
+      <div class="flex gap-4 justify-center mt-8">
+        ${showRetry ? `<button onclick="${retryUrl ? `window.location.href='${escapeHtml(retryUrl)}'` : "window.location.reload()"}" class="px-6 py-3 bg-primary hover:bg-primary/90 text-white font-medium rounded-lg transition-colors">Try Again</button>` : ""}
+        ${showHome ? `<a href="${escapeHtml(
+    homeUrl
+  )}" class="px-6 py-3 bg-gray-100 hover:bg-gray-200 text-text-primary font-medium rounded-lg transition-colors">Go Home</a>` : ""}
+      </div>
+    </div>
+  `;
+  return baseLayout(errorHtml, {
+    ...baseOptions,
+    pageType: "error",
+    size: "sm",
+    alignment: "center",
+    background: "solid",
+    title: baseOptions.title ?? errorTitle
+  });
+}
+function loadingLayout(content, options) {
+  const { message = "Loading...", showSpinner = true, showProgress = false, progress = 0, ...baseOptions } = options;
+  const spinnerHtml = showSpinner ? `<div class="inline-flex items-center justify-center w-16 h-16 mb-6">
+        <svg class="animate-spin w-12 h-12 text-primary" fill="none" viewBox="0 0 24 24">
+          <circle class="opacity-25" cx="12" cy="12" r="10" stroke="currentColor" stroke-width="4"></circle>
+          <path class="opacity-75" fill="currentColor" d="M4 12a8 8 0 018-8V0C5.373 0 0 5.373 0 12h4zm2 5.291A7.962 7.962 0 014 12H0c0 3.042 1.135 5.824 3 7.938l3-2.647z"></path>
+        </svg>
+      </div>` : "";
+  const progressHtml = showProgress ? `<div class="w-full bg-gray-200 rounded-full h-2 mb-4">
+        <div class="bg-primary h-2 rounded-full transition-all duration-300" style="width: ${progress}%"></div>
+      </div>` : "";
+  const loadingHtml = `
+    <div class="text-center">
+      ${spinnerHtml}
+      <h2 class="text-xl font-medium text-text-primary mb-2">${escapeHtml(message)}</h2>
+      ${progressHtml}
+      ${content}
+    </div>
+  `;
+  return baseLayout(loadingHtml, {
+    ...baseOptions,
+    pageType: "loading",
+    size: "sm",
+    alignment: "center",
+    background: "solid",
+    title: baseOptions.title ?? "Loading"
+  });
+}
+function successLayout(content, options) {
+  const {
+    successTitle = "Success!",
+    successMessage,
+    continueText = "Continue",
+    continueUrl,
+    autoClose,
+    ...baseOptions
+  } = options;
+  const autoCloseScript = autoClose ? `<script>
+        let countdown = ${autoClose};
+        const countdownEl = document.getElementById('countdown');
+        const interval = setInterval(() => {
+          countdown--;
+          if (countdownEl) countdownEl.textContent = countdown;
+          if (countdown <= 0) {
+            clearInterval(interval);
+            ${continueUrl ? `window.location.href = '${escapeHtml(continueUrl)}';` : "window.close();"}
+          }
+        }, 1000);
+      </script>` : "";
+  const successHtml = `
+    <div class="text-center">
+      <!-- Success icon -->
+      <div class="inline-flex items-center justify-center w-20 h-20 rounded-full bg-success/10 mb-6">
+        <svg class="w-10 h-10 text-success" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+          <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M5 13l4 4L19 7"/>
+        </svg>
+      </div>
+
+      <h1 class="text-2xl font-bold text-text-primary mb-4">${escapeHtml(successTitle)}</h1>
+      ${successMessage ? `<p class="text-text-secondary mb-8">${escapeHtml(successMessage)}</p>` : ""}
+
+      ${content}
+
+      ${continueUrl ? `<a href="${escapeHtml(
+    continueUrl
+  )}" class="inline-block mt-6 px-6 py-3 bg-primary hover:bg-primary/90 text-white font-medium rounded-lg transition-colors">${escapeHtml(
+    continueText
+  )}</a>` : ""}
+
+      ${autoClose ? `<p class="mt-4 text-sm text-text-secondary">Closing in <span id="countdown">${autoClose}</span> seconds...</p>` : ""}
+    </div>
+    ${autoCloseScript}
+  `;
+  return baseLayout(successHtml, {
+    ...baseOptions,
+    pageType: "success",
+    size: "sm",
+    alignment: "center",
+    background: "solid",
+    title: baseOptions.title ?? successTitle
+  });
+}
+function widgetLayout(content, options) {
+  const { maxWidth = "100%", showBorder = false, transparent = true, ...baseOptions } = options;
+  const containerClasses = [
+    "widget-container",
+    showBorder ? "border border-border rounded-lg" : "",
+    transparent ? "" : "bg-surface"
+  ].filter(Boolean).join(" ");
+  const wrappedContent = `
+    <div class="${containerClasses}" style="max-width: ${escapeHtml(maxWidth)}">
+      ${content}
+    </div>
+  `;
+  return baseLayout(wrappedContent, {
+    ...baseOptions,
+    pageType: "widget",
+    size: "full",
+    alignment: "start",
+    background: "none"
+  });
+}
+var authLayoutBuilder = createLayoutBuilder({
+  pageType: "auth",
+  size: "sm",
+  alignment: "center",
+  background: "gradient"
+});
+var consentLayoutBuilder = createLayoutBuilder({
+  pageType: "consent",
+  size: "lg",
+  alignment: "top",
+  background: "solid"
+});
+var errorLayoutBuilder = createLayoutBuilder({
+  pageType: "error",
+  size: "sm",
+  alignment: "center",
+  background: "solid"
+});
+export {
+  authLayout,
+  authLayoutBuilder,
+  baseLayout,
+  consentLayout,
+  consentLayoutBuilder,
+  createLayoutBuilder,
+  errorLayout,
+  errorLayoutBuilder,
+  escapeHtml,
+  loadingLayout,
+  successLayout,
+  widgetLayout
+};