@frontmcp/ui 0.5.1 → 0.6.1

package/esm/layouts/base.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Base Layout System
+ *
+ * Provides the foundation for all FrontMCP UI pages with:
+ * - Platform-aware rendering (OpenAI, Claude, etc.)
+ * - Theme integration
+ * - CDN resource management
+ * - Responsive layouts
+ */
+import { type PlatformCapabilities, type ThemeConfig, type DeepPartial } from '@frontmcp/uipack/theme';
+/**
+ * Page type determines the layout structure
+ */
+export type PageType = 'auth' | 'consent' | 'error' | 'loading' | 'success' | 'dashboard' | 'widget' | 'resource' | 'custom';
+/**
+ * Layout size/width options
+ */
+export type LayoutSize = 'xs' | 'sm' | 'md' | 'lg' | 'xl' | '2xl' | '3xl' | 'full';
+/**
+ * Background style options
+ */
+export type BackgroundStyle = 'solid' | 'gradient' | 'pattern' | 'none';
+/**
+ * Layout alignment options
+ */
+export type LayoutAlignment = 'center' | 'top' | 'start';
+/**
+ * Base layout configuration options
+ */
+export interface BaseLayoutOptions {
+    /** Page title (will be suffixed with branding) */
+    title: string;
+    /** Page type for layout structure */
+    pageType?: PageType;
+    /** Content width */
+    size?: LayoutSize;
+    /** Content alignment */
+    alignment?: LayoutAlignment;
+    /** Background style */
+    background?: BackgroundStyle;
+    /** Optional page description for meta tag */
+    description?: string;
+    /** Target platform capabilities */
+    platform?: PlatformCapabilities;
+    /** Theme configuration (deep partial - nested properties are also optional) */
+    theme?: DeepPartial<ThemeConfig>;
+    /** Include HTMX (default: based on platform) */
+    includeHtmx?: boolean;
+    /** Include Alpine.js (default: false) */
+    includeAlpine?: boolean;
+    /** Include Lucide icons (default: false) */
+    includeIcons?: boolean;
+    /** Additional head content */
+    headExtra?: string;
+    /** Additional body attributes */
+    bodyAttrs?: Record<string, string>;
+    /** Custom body classes */
+    bodyClass?: string;
+    /** Title suffix/branding */
+    titleSuffix?: string;
+    /** Favicon URL */
+    favicon?: string;
+    /** Open Graph meta tags */
+    og?: {
+        title?: string;
+        description?: string;
+        image?: string;
+        type?: string;
+    };
+}
+export { escapeHtml } from '@frontmcp/uipack/utils';
+/**
+ * Build the complete HTML document
+ *
+ * @param content - The page content (HTML string)
+ * @param options - Layout configuration options
+ * @returns Complete HTML document string
+ */
+export declare function baseLayout(content: string, options: BaseLayoutOptions): string;
+/**
+ * Create a layout builder with preset options.
+ * The returned function accepts optional options that extend/override the defaults.
+ * If defaults include `title`, the returned function's options are fully optional.
+ */
+export declare function createLayoutBuilder(defaults: Partial<BaseLayoutOptions>): (content: string, options?: Partial<BaseLayoutOptions>) => string;
+//# sourceMappingURL=base.d.ts.map

package/esm/layouts/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../src/layouts/base.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EACL,KAAK,oBAAoB,EACzB,KAAK,WAAW,EAChB,KAAK,WAAW,EAWjB,MAAM,wBAAwB,CAAC;AAOhC;;GAEG;AACH,MAAM,MAAM,QAAQ,GAChB,MAAM,GACN,SAAS,GACT,OAAO,GACP,SAAS,GACT,SAAS,GACT,WAAW,GACX,QAAQ,GACR,UAAU,GACV,QAAQ,CAAC;AAEb;;GAEG;AACH,MAAM,MAAM,UAAU,GAClB,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,IAAI,GACJ,KAAK,GACL,KAAK,GACL,MAAM,CAAC;AAEX;;GAEG;AACH,MAAM,MAAM,eAAe,GACvB,OAAO,GACP,UAAU,GACV,SAAS,GACT,MAAM,CAAC;AAEX;;GAEG;AACH,MAAM,MAAM,eAAe,GACvB,QAAQ,GACR,KAAK,GACL,OAAO,CAAC;AAMZ;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,kDAAkD;IAClD,KAAK,EAAE,MAAM,CAAC;IAEd,qCAAqC;IACrC,QAAQ,CAAC,EAAE,QAAQ,CAAC;IAEpB,oBAAoB;IACpB,IAAI,CAAC,EAAE,UAAU,CAAC;IAElB,wBAAwB;IACxB,SAAS,CAAC,EAAE,eAAe,CAAC;IAE5B,uBAAuB;IACvB,UAAU,CAAC,EAAE,eAAe,CAAC;IAE7B,6CAA6C;IAC7C,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,mCAAmC;IACnC,QAAQ,CAAC,EAAE,oBAAoB,CAAC;IAEhC,+EAA+E;IAC/E,KAAK,CAAC,EAAE,WAAW,CAAC,WAAW,CAAC,CAAC;IAEjC,gDAAgD;IAChD,WAAW,CAAC,EAAE,OAAO,CAAC;IAEtB,yCAAyC;IACzC,aAAa,CAAC,EAAE,OAAO,CAAC;IAExB,4CAA4C;IAC5C,YAAY,CAAC,EAAE,OAAO,CAAC;IAEvB,8BAA8B;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,iCAAiC;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEnC,0BAA0B;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,4BAA4B;IAC5B,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,kBAAkB;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,2BAA2B;IAC3B,EAAE,CAAC,EAAE;QACH,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,CAAC;CACH;AAOD,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AA8FpD;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,iBAAiB,GAAG,MAAM,CAuG9E;AAMD;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,OAAO,CAAC,iBAAiB,CAAC,GACnC,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,KAAK,MAAM,CAyBnE"}

package/esm/layouts/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Layouts Module
+ *
+ * Provides base layouts and page-specific presets for FrontMCP UI.
+ */
+export { type PageType, type LayoutSize, type BackgroundStyle, type LayoutAlignment, type BaseLayoutOptions, baseLayout, createLayoutBuilder, escapeHtml, } from './base';
+export { type AuthLayoutOptions, type ConsentLayoutOptions, type ErrorLayoutOptions, type LoadingLayoutOptions, type SuccessLayoutOptions, type WidgetLayoutOptions, authLayout, consentLayout, errorLayout, loadingLayout, successLayout, widgetLayout, authLayoutBuilder, consentLayoutBuilder, errorLayoutBuilder, } from './presets';
+//# sourceMappingURL=index.d.ts.map

package/esm/layouts/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/layouts/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EACL,KAAK,QAAQ,EACb,KAAK,UAAU,EACf,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,UAAU,EACV,mBAAmB,EACnB,UAAU,GACX,MAAM,QAAQ,CAAC;AAGhB,OAAO,EACL,KAAK,iBAAiB,EACtB,KAAK,oBAAoB,EACzB,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EACxB,UAAU,EACV,aAAa,EACb,WAAW,EACX,aAAa,EACb,aAAa,EACb,YAAY,EACZ,iBAAiB,EACjB,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,WAAW,CAAC"}

package/esm/layouts/index.js

@@ -0,0 +1,409 @@
+// libs/ui/src/layouts/base.ts
+import {
+  OPENAI_PLATFORM,
+  canUseCdn,
+  needsInlineScripts,
+  DEFAULT_THEME,
+  buildThemeCss,
+  mergeThemes,
+  buildFontPreconnect,
+  buildFontStylesheets,
+  buildCdnScripts
+} from "@frontmcp/uipack/theme";
+import { escapeHtml } from "@frontmcp/uipack/utils";
+import { escapeHtml as escapeHtml2 } from "@frontmcp/uipack/utils";
+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="${escapeHtml2(clientIcon)}" alt="${escapeHtml2(
+    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">
+              ${escapeHtml2(clientName.charAt(0).toUpperCase())}
+            </div>`}
+        <h1 class="text-2xl font-bold text-text-primary">${escapeHtml2(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="${escapeHtml2(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">
+              ${escapeHtml2((userInfo.name || userInfo.email || "U").charAt(0).toUpperCase())}
+            </div>`}
+        <div>
+          ${userInfo.name ? `<div class="font-medium text-text-primary">${escapeHtml2(userInfo.name)}</div>` : ""}
+          ${userInfo.email ? `<div class="text-sm text-text-secondary">${escapeHtml2(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">${escapeHtml2(errorCode)}</p>` : ""}
+      <h1 class="text-2xl font-bold text-text-primary mb-4">${escapeHtml2(errorTitle)}</h1>
+      ${errorMessage ? `<p class="text-text-secondary mb-8">${escapeHtml2(errorMessage)}</p>` : ""}
+
+      ${content}
+
+      <div class="flex gap-4 justify-center mt-8">
+        ${showRetry ? `<button onclick="${retryUrl ? `window.location.href='${escapeHtml2(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="${escapeHtml2(
+    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">${escapeHtml2(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 = '${escapeHtml2(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">${escapeHtml2(successTitle)}</h1>
+      ${successMessage ? `<p class="text-text-secondary mb-8">${escapeHtml2(successMessage)}</p>` : ""}
+
+      ${content}
+
+      ${continueUrl ? `<a href="${escapeHtml2(
+    continueUrl
+  )}" class="inline-block mt-6 px-6 py-3 bg-primary hover:bg-primary/90 text-white font-medium rounded-lg transition-colors">${escapeHtml2(
+    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: ${escapeHtml2(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,
+  escapeHtml2 as escapeHtml,
+  loadingLayout,
+  successLayout,
+  widgetLayout
+};

package/esm/layouts/presets.d.ts

@@ -0,0 +1,134 @@
+/**
+ * Layout Presets
+ *
+ * Pre-configured layouts for common page types:
+ * - Auth pages (login, register, etc.)
+ * - Consent pages (OAuth, permissions)
+ * - Error pages
+ * - Loading states
+ * - Success pages
+ * - Widget mode (embedded)
+ * - Resource display (OpenAI SDK)
+ */
+import { type BaseLayoutOptions } from './base';
+/**
+ * Auth layout options
+ */
+export interface AuthLayoutOptions extends Omit<BaseLayoutOptions, 'pageType'> {
+    /** Show branding/logo */
+    showBranding?: boolean;
+    /** Custom logo HTML */
+    logo?: string;
+    /** Footer content */
+    footer?: string;
+}
+/**
+ * Build auth page layout (login, register, etc.)
+ */
+export declare function authLayout(content: string, options: AuthLayoutOptions): string;
+/**
+ * Consent layout options
+ */
+export interface ConsentLayoutOptions extends Omit<BaseLayoutOptions, 'pageType'> {
+    /** App/client name requesting consent */
+    clientName?: string;
+    /** App icon URL */
+    clientIcon?: string;
+    /** User info display */
+    userInfo?: {
+        name?: string;
+        email?: string;
+        avatar?: string;
+    };
+}
+/**
+ * Build consent page layout (OAuth consent, permissions)
+ */
+export declare function consentLayout(content: string, options: ConsentLayoutOptions): string;
+/**
+ * Error layout options
+ */
+export interface ErrorLayoutOptions extends Omit<BaseLayoutOptions, 'pageType'> {
+    /** Error code */
+    errorCode?: string;
+    /** Error title */
+    errorTitle?: string;
+    /** Error message */
+    errorMessage?: string;
+    /** Show retry button */
+    showRetry?: boolean;
+    /** Retry URL */
+    retryUrl?: string;
+    /** Show home button */
+    showHome?: boolean;
+    /** Home URL */
+    homeUrl?: string;
+}
+/**
+ * Build error page layout
+ */
+export declare function errorLayout(content: string, options: ErrorLayoutOptions): string;
+/**
+ * Loading layout options
+ */
+export interface LoadingLayoutOptions extends Omit<BaseLayoutOptions, 'pageType'> {
+    /** Loading message */
+    message?: string;
+    /** Show spinner */
+    showSpinner?: boolean;
+    /** Show progress bar */
+    showProgress?: boolean;
+    /** Progress value (0-100) */
+    progress?: number;
+}
+/**
+ * Build loading page layout
+ */
+export declare function loadingLayout(content: string, options: LoadingLayoutOptions): string;
+/**
+ * Success layout options
+ */
+export interface SuccessLayoutOptions extends Omit<BaseLayoutOptions, 'pageType'> {
+    /** Success title */
+    successTitle?: string;
+    /** Success message */
+    successMessage?: string;
+    /** Continue button text */
+    continueText?: string;
+    /** Continue URL */
+    continueUrl?: string;
+    /** Auto-close countdown (seconds) */
+    autoClose?: number;
+}
+/**
+ * Build success page layout
+ */
+export declare function successLayout(content: string, options: SuccessLayoutOptions): string;
+/**
+ * Widget layout options (for embedded widgets)
+ */
+export interface WidgetLayoutOptions extends Omit<BaseLayoutOptions, 'pageType' | 'alignment'> {
+    /** Widget max width */
+    maxWidth?: string;
+    /** Show border */
+    showBorder?: boolean;
+    /** Transparent background */
+    transparent?: boolean;
+}
+/**
+ * Build widget layout (for embedding)
+ */
+export declare function widgetLayout(content: string, options: WidgetLayoutOptions): string;
+/**
+ * Pre-configured auth layout builder
+ */
+export declare const authLayoutBuilder: (content: string, options?: Partial<BaseLayoutOptions>) => string;
+/**
+ * Pre-configured consent layout builder
+ */
+export declare const consentLayoutBuilder: (content: string, options?: Partial<BaseLayoutOptions>) => string;
+/**
+ * Pre-configured error layout builder
+ */
+export declare const errorLayoutBuilder: (content: string, options?: Partial<BaseLayoutOptions>) => string;
+//# sourceMappingURL=presets.d.ts.map

package/esm/layouts/presets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"presets.d.ts","sourceRoot":"","sources":["../../../src/layouts/presets.ts"],"names":[],"mappings":"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"}