@frontmcp/ui 0.5.0

package/src/handlebars/index.d.ts

@@ -0,0 +1,193 @@
+/**
+ * Handlebars Renderer Module
+ *
+ * Provides Handlebars template rendering for HTML templates.
+ * Enhances plain HTML with {{variable}} syntax support.
+ *
+ * @example
+ * ```typescript
+ * import { HandlebarsRenderer, createHandlebarsRenderer } from '@frontmcp/ui/handlebars';
+ *
+ * const renderer = createHandlebarsRenderer();
+ *
+ * const template = `
+ *   <div class="card">
+ *     <h2>{{escapeHtml output.title}}</h2>
+ *     <p>Created: {{formatDate output.createdAt}}</p>
+ *     {{#if output.items.length}}
+ *       <ul>
+ *         {{#each output.items}}
+ *           <li>{{this.name}} - {{formatCurrency this.price}}</li>
+ *         {{/each}}
+ *       </ul>
+ *     {{/if}}
+ *   </div>
+ * `;
+ *
+ * const html = renderer.render(template, {
+ *   input: { query: 'test' },
+ *   output: {
+ *     title: 'Results',
+ *     createdAt: new Date(),
+ *     items: [{ name: 'Item 1', price: 9.99 }]
+ *   }
+ * });
+ * ```
+ *
+ * @packageDocumentation
+ */
+import type { TemplateHelpers } from '../types';
+import { type HelperFunction } from './helpers';
+/**
+ * Check if Handlebars is available.
+ */
+export declare function isHandlebarsAvailable(): Promise<boolean>;
+/**
+ * Options for the Handlebars renderer.
+ */
+export interface HandlebarsRendererOptions {
+    /**
+     * Additional custom helpers to register.
+     */
+    helpers?: Record<string, HelperFunction>;
+    /**
+     * Partial templates to register.
+     */
+    partials?: Record<string, string>;
+    /**
+     * Strict mode - error on missing variables.
+     * @default false
+     */
+    strict?: boolean;
+    /**
+     * Whether to auto-escape output.
+     * @default true
+     */
+    autoEscape?: boolean;
+}
+/**
+ * Render context for templates.
+ */
+export interface RenderContext {
+    /**
+     * Tool input arguments.
+     */
+    input: Record<string, unknown>;
+    /**
+     * Tool output/result.
+     */
+    output: unknown;
+    /**
+     * Structured content (if schema provided).
+     */
+    structuredContent?: unknown;
+    /**
+     * Template helper functions.
+     */
+    helpers?: TemplateHelpers;
+}
+/**
+ * Handlebars template renderer.
+ *
+ * Provides safe, cacheable Handlebars rendering with built-in helpers
+ * for formatting, escaping, and logic.
+ *
+ * @example
+ * ```typescript
+ * const renderer = new HandlebarsRenderer();
+ *
+ * // Simple render
+ * const html = await renderer.render('<div>{{output.name}}</div>', { output: { name: 'Test' } });
+ *
+ * // With custom helpers
+ * renderer.registerHelper('shout', (str) => String(str).toUpperCase() + '!');
+ * const html2 = await renderer.render('<div>{{shout output.name}}</div>', { output: { name: 'hello' } });
+ * ```
+ */
+export declare class HandlebarsRenderer {
+    private readonly options;
+    private compiledTemplates;
+    private initialized;
+    private hbs;
+    constructor(options?: HandlebarsRendererOptions);
+    /**
+     * Initialize the renderer with Handlebars.
+     */
+    private init;
+    /**
+     * Render a Handlebars template.
+     *
+     * @param template - Template string
+     * @param context - Render context with input/output
+     * @returns Rendered HTML string
+     */
+    render(template: string, context: RenderContext): Promise<string>;
+    /**
+     * Render a template synchronously.
+     *
+     * Note: Requires Handlebars to be pre-loaded. Use `render()` for async loading.
+     *
+     * @param template - Template string
+     * @param context - Render context
+     * @returns Rendered HTML string
+     */
+    renderSync(template: string, context: RenderContext): string;
+    /**
+     * Initialize synchronously (for environments where Handlebars is already loaded).
+     */
+    initSync(handlebars: typeof import('handlebars')): void;
+    /**
+     * Register a custom helper.
+     *
+     * @param name - Helper name
+     * @param fn - Helper function
+     */
+    registerHelper(name: string, fn: HelperFunction): void;
+    /**
+     * Register a partial template.
+     *
+     * @param name - Partial name
+     * @param template - Partial template string
+     */
+    registerPartial(name: string, template: string): void;
+    /**
+     * Clear compiled template cache.
+     */
+    clearCache(): void;
+    /**
+     * Check if a template string contains Handlebars syntax.
+     *
+     * @param template - Template string to check
+     * @returns true if contains {{...}} syntax
+     */
+    static containsHandlebars(template: string): boolean;
+    /**
+     * Check if the renderer is initialized.
+     */
+    get isInitialized(): boolean;
+}
+/**
+ * Create a new Handlebars renderer.
+ *
+ * @param options - Renderer options
+ * @returns New HandlebarsRenderer instance
+ */
+export declare function createHandlebarsRenderer(options?: HandlebarsRendererOptions): HandlebarsRenderer;
+/**
+ * Render a template with default settings.
+ *
+ * Convenience function for one-off rendering.
+ *
+ * @param template - Template string
+ * @param context - Render context
+ * @returns Rendered HTML
+ */
+export declare function renderTemplate(template: string, context: RenderContext): Promise<string>;
+/**
+ * Check if a template contains Handlebars syntax.
+ *
+ * @param template - Template string
+ * @returns true if contains {{...}}
+ */
+export declare function containsHandlebars(template: string): boolean;
+export { builtinHelpers, escapeHtml, formatDate, formatCurrency, formatNumber, json, jsonEmbed, eq, ne, gt, gte, lt, lte, and, or, not, first, last, length, includes, join, uppercase, lowercase, capitalize, truncate, defaultValue, uniqueId, classNames, resetUniqueIdCounter, type HelperFunction, } from './helpers';

package/src/handlebars/index.js

@@ -0,0 +1,350 @@
+"use strict";
+/**
+ * Handlebars Renderer Module
+ *
+ * Provides Handlebars template rendering for HTML templates.
+ * Enhances plain HTML with {{variable}} syntax support.
+ *
+ * @example
+ * ```typescript
+ * import { HandlebarsRenderer, createHandlebarsRenderer } from '@frontmcp/ui/handlebars';
+ *
+ * const renderer = createHandlebarsRenderer();
+ *
+ * const template = `
+ *   <div class="card">
+ *     <h2>{{escapeHtml output.title}}</h2>
+ *     <p>Created: {{formatDate output.createdAt}}</p>
+ *     {{#if output.items.length}}
+ *       <ul>
+ *         {{#each output.items}}
+ *           <li>{{this.name}} - {{formatCurrency this.price}}</li>
+ *         {{/each}}
+ *       </ul>
+ *     {{/if}}
+ *   </div>
+ * `;
+ *
+ * const html = renderer.render(template, {
+ *   input: { query: 'test' },
+ *   output: {
+ *     title: 'Results',
+ *     createdAt: new Date(),
+ *     items: [{ name: 'Item 1', price: 9.99 }]
+ *   }
+ * });
+ * ```
+ *
+ * @packageDocumentation
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resetUniqueIdCounter = exports.classNames = exports.uniqueId = exports.defaultValue = exports.truncate = exports.capitalize = exports.lowercase = exports.uppercase = exports.join = exports.includes = exports.length = exports.last = exports.first = exports.not = exports.or = exports.and = exports.lte = exports.lt = exports.gte = exports.gt = exports.ne = exports.eq = exports.jsonEmbed = exports.json = exports.formatNumber = exports.formatCurrency = exports.formatDate = exports.escapeHtml = exports.builtinHelpers = exports.HandlebarsRenderer = void 0;
+exports.isHandlebarsAvailable = isHandlebarsAvailable;
+exports.createHandlebarsRenderer = createHandlebarsRenderer;
+exports.renderTemplate = renderTemplate;
+exports.containsHandlebars = containsHandlebars;
+const helpers_1 = require("./helpers");
+/**
+ * Lazy-loaded Handlebars module.
+ */
+let Handlebars = null;
+/**
+ * Load Handlebars module.
+ */
+async function loadHandlebars() {
+    if (Handlebars !== null) {
+        return Handlebars;
+    }
+    try {
+        Handlebars = await import('handlebars');
+        return Handlebars;
+    }
+    catch {
+        throw new Error('Handlebars is required for template rendering. Install it: npm install handlebars');
+    }
+}
+/**
+ * Check if Handlebars is available.
+ */
+async function isHandlebarsAvailable() {
+    try {
+        await loadHandlebars();
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Handlebars template renderer.
+ *
+ * Provides safe, cacheable Handlebars rendering with built-in helpers
+ * for formatting, escaping, and logic.
+ *
+ * @example
+ * ```typescript
+ * const renderer = new HandlebarsRenderer();
+ *
+ * // Simple render
+ * const html = await renderer.render('<div>{{output.name}}</div>', { output: { name: 'Test' } });
+ *
+ * // With custom helpers
+ * renderer.registerHelper('shout', (str) => String(str).toUpperCase() + '!');
+ * const html2 = await renderer.render('<div>{{shout output.name}}</div>', { output: { name: 'hello' } });
+ * ```
+ */
+class HandlebarsRenderer {
+    options;
+    compiledTemplates = new Map();
+    initialized = false;
+    hbs = null;
+    constructor(options = {}) {
+        this.options = {
+            strict: false,
+            autoEscape: true,
+            ...options,
+        };
+    }
+    /**
+     * Initialize the renderer with Handlebars.
+     */
+    async init() {
+        if (this.initialized)
+            return;
+        this.hbs = await loadHandlebars();
+        // Register built-in helpers
+        for (const [name, helper] of Object.entries(helpers_1.builtinHelpers)) {
+            this.hbs.registerHelper(name, helper);
+        }
+        // Register custom helpers
+        if (this.options.helpers) {
+            for (const [name, helper] of Object.entries(this.options.helpers)) {
+                this.hbs.registerHelper(name, helper);
+            }
+        }
+        // Register partials
+        if (this.options.partials) {
+            for (const [name, template] of Object.entries(this.options.partials)) {
+                this.hbs.registerPartial(name, template);
+            }
+        }
+        this.initialized = true;
+    }
+    /**
+     * Render a Handlebars template.
+     *
+     * @param template - Template string
+     * @param context - Render context with input/output
+     * @returns Rendered HTML string
+     */
+    async render(template, context) {
+        await this.init();
+        if (!this.hbs) {
+            throw new Error('Handlebars not initialized');
+        }
+        // Get or compile template
+        let compiled = this.compiledTemplates.get(template);
+        if (!compiled) {
+            compiled = this.hbs.compile(template, {
+                strict: this.options.strict,
+                noEscape: !this.options.autoEscape,
+            });
+            this.compiledTemplates.set(template, compiled);
+        }
+        // Build template data
+        const data = {
+            input: context.input ?? {},
+            output: context.output ?? {},
+            structuredContent: context.structuredContent,
+            // Also expose at root level for convenience
+            ...context.input,
+            ...(typeof context.output === 'object' && context.output !== null
+                ? context.output
+                : {}),
+        };
+        // Render template
+        try {
+            return compiled(data);
+        }
+        catch (error) {
+            throw new Error(`Template rendering failed: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    /**
+     * Render a template synchronously.
+     *
+     * Note: Requires Handlebars to be pre-loaded. Use `render()` for async loading.
+     *
+     * @param template - Template string
+     * @param context - Render context
+     * @returns Rendered HTML string
+     */
+    renderSync(template, context) {
+        if (!this.initialized || !this.hbs) {
+            throw new Error('HandlebarsRenderer not initialized. Call render() first or use initSync().');
+        }
+        // Get or compile template
+        let compiled = this.compiledTemplates.get(template);
+        if (!compiled) {
+            compiled = this.hbs.compile(template, {
+                strict: this.options.strict,
+                noEscape: !this.options.autoEscape,
+            });
+            this.compiledTemplates.set(template, compiled);
+        }
+        // Build template data
+        const data = {
+            input: context.input ?? {},
+            output: context.output ?? {},
+            structuredContent: context.structuredContent,
+            ...context.input,
+            ...(typeof context.output === 'object' && context.output !== null
+                ? context.output
+                : {}),
+        };
+        return compiled(data);
+    }
+    /**
+     * Initialize synchronously (for environments where Handlebars is already loaded).
+     */
+    initSync(handlebars) {
+        this.hbs = handlebars;
+        // Register built-in helpers
+        for (const [name, helper] of Object.entries(helpers_1.builtinHelpers)) {
+            this.hbs.registerHelper(name, helper);
+        }
+        // Register custom helpers
+        if (this.options.helpers) {
+            for (const [name, helper] of Object.entries(this.options.helpers)) {
+                this.hbs.registerHelper(name, helper);
+            }
+        }
+        // Register partials
+        if (this.options.partials) {
+            for (const [name, template] of Object.entries(this.options.partials)) {
+                this.hbs.registerPartial(name, template);
+            }
+        }
+        this.initialized = true;
+    }
+    /**
+     * Register a custom helper.
+     *
+     * @param name - Helper name
+     * @param fn - Helper function
+     */
+    registerHelper(name, fn) {
+        if (this.hbs) {
+            this.hbs.registerHelper(name, fn);
+        }
+        // Also store for future use
+        if (!this.options.helpers) {
+            this.options.helpers = {};
+        }
+        this.options.helpers[name] = fn;
+    }
+    /**
+     * Register a partial template.
+     *
+     * @param name - Partial name
+     * @param template - Partial template string
+     */
+    registerPartial(name, template) {
+        if (this.hbs) {
+            this.hbs.registerPartial(name, template);
+        }
+        // Also store for future use
+        if (!this.options.partials) {
+            this.options.partials = {};
+        }
+        this.options.partials[name] = template;
+    }
+    /**
+     * Clear compiled template cache.
+     */
+    clearCache() {
+        this.compiledTemplates.clear();
+    }
+    /**
+     * Check if a template string contains Handlebars syntax.
+     *
+     * @param template - Template string to check
+     * @returns true if contains {{...}} syntax
+     */
+    static containsHandlebars(template) {
+        // Match {{...}} but not {{! comments }}
+        return /\{\{(?!!)[\s\S]*?\}\}/.test(template);
+    }
+    /**
+     * Check if the renderer is initialized.
+     */
+    get isInitialized() {
+        return this.initialized;
+    }
+}
+exports.HandlebarsRenderer = HandlebarsRenderer;
+/**
+ * Create a new Handlebars renderer.
+ *
+ * @param options - Renderer options
+ * @returns New HandlebarsRenderer instance
+ */
+function createHandlebarsRenderer(options) {
+    return new HandlebarsRenderer(options);
+}
+/**
+ * Render a template with default settings.
+ *
+ * Convenience function for one-off rendering.
+ *
+ * @param template - Template string
+ * @param context - Render context
+ * @returns Rendered HTML
+ */
+async function renderTemplate(template, context) {
+    const renderer = createHandlebarsRenderer();
+    return renderer.render(template, context);
+}
+/**
+ * Check if a template contains Handlebars syntax.
+ *
+ * @param template - Template string
+ * @returns true if contains {{...}}
+ */
+function containsHandlebars(template) {
+    return HandlebarsRenderer.containsHandlebars(template);
+}
+// ============================================
+// Re-exports
+// ============================================
+var helpers_2 = require("./helpers");
+Object.defineProperty(exports, "builtinHelpers", { enumerable: true, get: function () { return helpers_2.builtinHelpers; } });
+Object.defineProperty(exports, "escapeHtml", { enumerable: true, get: function () { return helpers_2.escapeHtml; } });
+Object.defineProperty(exports, "formatDate", { enumerable: true, get: function () { return helpers_2.formatDate; } });
+Object.defineProperty(exports, "formatCurrency", { enumerable: true, get: function () { return helpers_2.formatCurrency; } });
+Object.defineProperty(exports, "formatNumber", { enumerable: true, get: function () { return helpers_2.formatNumber; } });
+Object.defineProperty(exports, "json", { enumerable: true, get: function () { return helpers_2.json; } });
+Object.defineProperty(exports, "jsonEmbed", { enumerable: true, get: function () { return helpers_2.jsonEmbed; } });
+Object.defineProperty(exports, "eq", { enumerable: true, get: function () { return helpers_2.eq; } });
+Object.defineProperty(exports, "ne", { enumerable: true, get: function () { return helpers_2.ne; } });
+Object.defineProperty(exports, "gt", { enumerable: true, get: function () { return helpers_2.gt; } });
+Object.defineProperty(exports, "gte", { enumerable: true, get: function () { return helpers_2.gte; } });
+Object.defineProperty(exports, "lt", { enumerable: true, get: function () { return helpers_2.lt; } });
+Object.defineProperty(exports, "lte", { enumerable: true, get: function () { return helpers_2.lte; } });
+Object.defineProperty(exports, "and", { enumerable: true, get: function () { return helpers_2.and; } });
+Object.defineProperty(exports, "or", { enumerable: true, get: function () { return helpers_2.or; } });
+Object.defineProperty(exports, "not", { enumerable: true, get: function () { return helpers_2.not; } });
+Object.defineProperty(exports, "first", { enumerable: true, get: function () { return helpers_2.first; } });
+Object.defineProperty(exports, "last", { enumerable: true, get: function () { return helpers_2.last; } });
+Object.defineProperty(exports, "length", { enumerable: true, get: function () { return helpers_2.length; } });
+Object.defineProperty(exports, "includes", { enumerable: true, get: function () { return helpers_2.includes; } });
+Object.defineProperty(exports, "join", { enumerable: true, get: function () { return helpers_2.join; } });
+Object.defineProperty(exports, "uppercase", { enumerable: true, get: function () { return helpers_2.uppercase; } });
+Object.defineProperty(exports, "lowercase", { enumerable: true, get: function () { return helpers_2.lowercase; } });
+Object.defineProperty(exports, "capitalize", { enumerable: true, get: function () { return helpers_2.capitalize; } });
+Object.defineProperty(exports, "truncate", { enumerable: true, get: function () { return helpers_2.truncate; } });
+Object.defineProperty(exports, "defaultValue", { enumerable: true, get: function () { return helpers_2.defaultValue; } });
+Object.defineProperty(exports, "uniqueId", { enumerable: true, get: function () { return helpers_2.uniqueId; } });
+Object.defineProperty(exports, "classNames", { enumerable: true, get: function () { return helpers_2.classNames; } });
+Object.defineProperty(exports, "resetUniqueIdCounter", { enumerable: true, get: function () { return helpers_2.resetUniqueIdCounter; } });
+//# sourceMappingURL=index.js.map

package/src/handlebars/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/handlebars/index.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Handlebars Renderer Module\n *\n * Provides Handlebars template rendering for HTML templates.\n * Enhances plain HTML with {{variable}} syntax support.\n *\n * @example\n * ```typescript\n * import { HandlebarsRenderer, createHandlebarsRenderer } from '@frontmcp/ui/handlebars';\n *\n * const renderer = createHandlebarsRenderer();\n *\n * const template = `\n *   <div class=\"card\">\n *     <h2>{{escapeHtml output.title}}</h2>\n *     <p>Created: {{formatDate output.createdAt}}</p>\n *     {{#if output.items.length}}\n *       <ul>\n *         {{#each output.items}}\n *           <li>{{this.name}} - {{formatCurrency this.price}}</li>\n *         {{/each}}\n *       </ul>\n *     {{/if}}\n *   </div>\n * `;\n *\n * const html = renderer.render(template, {\n *   input: { query: 'test' },\n *   output: {\n *     title: 'Results',\n *     createdAt: new Date(),\n *     items: [{ name: 'Item 1', price: 9.99 }]\n *   }\n * });\n * ```\n *\n * @packageDocumentation\n */\n\nimport type { TemplateContext, TemplateHelpers } from '../types';\nimport { builtinHelpers, type HelperFunction } from './helpers';\n\n/**\n * Lazy-loaded Handlebars module.\n */\nlet Handlebars: typeof import('handlebars') | null = null;\n\n/**\n * Load Handlebars module.\n */\nasync function loadHandlebars(): Promise<typeof import('handlebars')> {\n  if (Handlebars !== null) {\n    return Handlebars;\n  }\n\n  try {\n    Handlebars = await import('handlebars');\n    return Handlebars;\n  } catch {\n    throw new Error('Handlebars is required for template rendering. Install it: npm install handlebars');\n  }\n}\n\n/**\n * Check if Handlebars is available.\n */\nexport async function isHandlebarsAvailable(): Promise<boolean> {\n  try {\n    await loadHandlebars();\n    return true;\n  } catch {\n    return false;\n  }\n}\n\n/**\n * Options for the Handlebars renderer.\n */\nexport interface HandlebarsRendererOptions {\n  /**\n   * Additional custom helpers to register.\n   */\n  helpers?: Record<string, HelperFunction>;\n\n  /**\n   * Partial templates to register.\n   */\n  partials?: Record<string, string>;\n\n  /**\n   * Strict mode - error on missing variables.\n   * @default false\n   */\n  strict?: boolean;\n\n  /**\n   * Whether to auto-escape output.\n   * @default true\n   */\n  autoEscape?: boolean;\n}\n\n/**\n * Render context for templates.\n */\nexport interface RenderContext {\n  /**\n   * Tool input arguments.\n   */\n  input: Record<string, unknown>;\n\n  /**\n   * Tool output/result.\n   */\n  output: unknown;\n\n  /**\n   * Structured content (if schema provided).\n   */\n  structuredContent?: unknown;\n\n  /**\n   * Template helper functions.\n   */\n  helpers?: TemplateHelpers;\n}\n\n/**\n * Handlebars template renderer.\n *\n * Provides safe, cacheable Handlebars rendering with built-in helpers\n * for formatting, escaping, and logic.\n *\n * @example\n * ```typescript\n * const renderer = new HandlebarsRenderer();\n *\n * // Simple render\n * const html = await renderer.render('<div>{{output.name}}</div>', { output: { name: 'Test' } });\n *\n * // With custom helpers\n * renderer.registerHelper('shout', (str) => String(str).toUpperCase() + '!');\n * const html2 = await renderer.render('<div>{{shout output.name}}</div>', { output: { name: 'hello' } });\n * ```\n */\nexport class HandlebarsRenderer {\n  private readonly options: HandlebarsRendererOptions;\n  private compiledTemplates = new Map<string, HandlebarsTemplateDelegate>();\n  private initialized = false;\n  private hbs: typeof import('handlebars') | null = null;\n\n  constructor(options: HandlebarsRendererOptions = {}) {\n    this.options = {\n      strict: false,\n      autoEscape: true,\n      ...options,\n    };\n  }\n\n  /**\n   * Initialize the renderer with Handlebars.\n   */\n  private async init(): Promise<void> {\n    if (this.initialized) return;\n\n    this.hbs = await loadHandlebars();\n\n    // Register built-in helpers\n    for (const [name, helper] of Object.entries(builtinHelpers)) {\n      this.hbs.registerHelper(name, helper as Handlebars.HelperDelegate);\n    }\n\n    // Register custom helpers\n    if (this.options.helpers) {\n      for (const [name, helper] of Object.entries(this.options.helpers)) {\n        this.hbs.registerHelper(name, helper as Handlebars.HelperDelegate);\n      }\n    }\n\n    // Register partials\n    if (this.options.partials) {\n      for (const [name, template] of Object.entries(this.options.partials)) {\n        this.hbs.registerPartial(name, template);\n      }\n    }\n\n    this.initialized = true;\n  }\n\n  /**\n   * Render a Handlebars template.\n   *\n   * @param template - Template string\n   * @param context - Render context with input/output\n   * @returns Rendered HTML string\n   */\n  async render(template: string, context: RenderContext): Promise<string> {\n    await this.init();\n\n    if (!this.hbs) {\n      throw new Error('Handlebars not initialized');\n    }\n\n    // Get or compile template\n    let compiled = this.compiledTemplates.get(template);\n    if (!compiled) {\n      compiled = this.hbs.compile(template, {\n        strict: this.options.strict,\n        noEscape: !this.options.autoEscape,\n      });\n      this.compiledTemplates.set(template, compiled);\n    }\n\n    // Build template data\n    const data = {\n      input: context.input ?? {},\n      output: context.output ?? {},\n      structuredContent: context.structuredContent,\n      // Also expose at root level for convenience\n      ...context.input,\n      ...(typeof context.output === 'object' && context.output !== null\n        ? (context.output as Record<string, unknown>)\n        : {}),\n    };\n\n    // Render template\n    try {\n      return compiled(data);\n    } catch (error) {\n      throw new Error(`Template rendering failed: ${error instanceof Error ? error.message : String(error)}`);\n    }\n  }\n\n  /**\n   * Render a template synchronously.\n   *\n   * Note: Requires Handlebars to be pre-loaded. Use `render()` for async loading.\n   *\n   * @param template - Template string\n   * @param context - Render context\n   * @returns Rendered HTML string\n   */\n  renderSync(template: string, context: RenderContext): string {\n    if (!this.initialized || !this.hbs) {\n      throw new Error('HandlebarsRenderer not initialized. Call render() first or use initSync().');\n    }\n\n    // Get or compile template\n    let compiled = this.compiledTemplates.get(template);\n    if (!compiled) {\n      compiled = this.hbs.compile(template, {\n        strict: this.options.strict,\n        noEscape: !this.options.autoEscape,\n      });\n      this.compiledTemplates.set(template, compiled);\n    }\n\n    // Build template data\n    const data = {\n      input: context.input ?? {},\n      output: context.output ?? {},\n      structuredContent: context.structuredContent,\n      ...context.input,\n      ...(typeof context.output === 'object' && context.output !== null\n        ? (context.output as Record<string, unknown>)\n        : {}),\n    };\n\n    return compiled(data);\n  }\n\n  /**\n   * Initialize synchronously (for environments where Handlebars is already loaded).\n   */\n  initSync(handlebars: typeof import('handlebars')): void {\n    this.hbs = handlebars;\n\n    // Register built-in helpers\n    for (const [name, helper] of Object.entries(builtinHelpers)) {\n      this.hbs.registerHelper(name, helper as Handlebars.HelperDelegate);\n    }\n\n    // Register custom helpers\n    if (this.options.helpers) {\n      for (const [name, helper] of Object.entries(this.options.helpers)) {\n        this.hbs.registerHelper(name, helper as Handlebars.HelperDelegate);\n      }\n    }\n\n    // Register partials\n    if (this.options.partials) {\n      for (const [name, template] of Object.entries(this.options.partials)) {\n        this.hbs.registerPartial(name, template);\n      }\n    }\n\n    this.initialized = true;\n  }\n\n  /**\n   * Register a custom helper.\n   *\n   * @param name - Helper name\n   * @param fn - Helper function\n   */\n  registerHelper(name: string, fn: HelperFunction): void {\n    if (this.hbs) {\n      this.hbs.registerHelper(name, fn as Handlebars.HelperDelegate);\n    }\n    // Also store for future use\n    if (!this.options.helpers) {\n      this.options.helpers = {};\n    }\n    this.options.helpers[name] = fn;\n  }\n\n  /**\n   * Register a partial template.\n   *\n   * @param name - Partial name\n   * @param template - Partial template string\n   */\n  registerPartial(name: string, template: string): void {\n    if (this.hbs) {\n      this.hbs.registerPartial(name, template);\n    }\n    // Also store for future use\n    if (!this.options.partials) {\n      this.options.partials = {};\n    }\n    this.options.partials[name] = template;\n  }\n\n  /**\n   * Clear compiled template cache.\n   */\n  clearCache(): void {\n    this.compiledTemplates.clear();\n  }\n\n  /**\n   * Check if a template string contains Handlebars syntax.\n   *\n   * @param template - Template string to check\n   * @returns true if contains {{...}} syntax\n   */\n  static containsHandlebars(template: string): boolean {\n    // Match {{...}} but not {{! comments }}\n    return /\\{\\{(?!!)[\\s\\S]*?\\}\\}/.test(template);\n  }\n\n  /**\n   * Check if the renderer is initialized.\n   */\n  get isInitialized(): boolean {\n    return this.initialized;\n  }\n}\n\n/**\n * Create a new Handlebars renderer.\n *\n * @param options - Renderer options\n * @returns New HandlebarsRenderer instance\n */\nexport function createHandlebarsRenderer(options?: HandlebarsRendererOptions): HandlebarsRenderer {\n  return new HandlebarsRenderer(options);\n}\n\n/**\n * Render a template with default settings.\n *\n * Convenience function for one-off rendering.\n *\n * @param template - Template string\n * @param context - Render context\n * @returns Rendered HTML\n */\nexport async function renderTemplate(template: string, context: RenderContext): Promise<string> {\n  const renderer = createHandlebarsRenderer();\n  return renderer.render(template, context);\n}\n\n/**\n * Check if a template contains Handlebars syntax.\n *\n * @param template - Template string\n * @returns true if contains {{...}}\n */\nexport function containsHandlebars(template: string): boolean {\n  return HandlebarsRenderer.containsHandlebars(template);\n}\n\n// ============================================\n// Re-exports\n// ============================================\n\nexport {\n  builtinHelpers,\n  escapeHtml,\n  formatDate,\n  formatCurrency,\n  formatNumber,\n  json,\n  jsonEmbed,\n  eq,\n  ne,\n  gt,\n  gte,\n  lt,\n  lte,\n  and,\n  or,\n  not,\n  first,\n  last,\n  length,\n  includes,\n  join,\n  uppercase,\n  lowercase,\n  capitalize,\n  truncate,\n  defaultValue,\n  uniqueId,\n  classNames,\n  resetUniqueIdCounter,\n  type HelperFunction,\n} from './helpers';\n\n// Handlebars types\ntype HandlebarsTemplateDelegate = ReturnType<typeof import('handlebars')['compile']>;\n"]}

package/src/index.d.ts

@@ -0,0 +1,50 @@
+/**
+ * @frontmcp/ui
+ *
+ * Comprehensive UI library for FrontMCP applications.
+ * Provides theme system, layouts, components, page templates, and widgets
+ * for building authentication and authorization UIs across multiple LLM platforms.
+ *
+ * Key features:
+ * - Multi-framework renderer support (HTML, React, MDX)
+ * - Platform-aware theming (OpenAI, Claude, etc.)
+ * - Runtime JSX/TSX transpilation with SWC
+ * - MCP Bridge integration for cross-platform widgets
+ * - Standalone types and adapters for external consumers (AgentLink)
+ * - Build-time API for pre-compiling UI templates
+ *
+ * ## Standalone Usage (without @frontmcp/sdk)
+ *
+ * For external systems like AgentLink that want to use the UI components
+ * without the full SDK:
+ *
+ * ```typescript
+ * // Import standalone types
+ * import type { UITemplateConfig, TemplateContext } from '@frontmcp/ui/types';
+ *
+ * // Import platform adapters
+ * import { buildUIMeta } from '@frontmcp/ui/adapters';
+ *
+ * // Import build-time API
+ * import { buildToolUI } from '@frontmcp/ui/build';
+ *
+ * // Import components directly
+ * import { card, button, table } from '@frontmcp/ui/components';
+ * ```
+ */
+export * from './types';
+export { type AIPlatformType, type UIMetadata, type BuildUIMetaOptions, type BuildToolDiscoveryMetaOptions, buildUIMeta, buildToolDiscoveryMeta, buildOpenAICSP, } from './adapters';
+export { type BuildTargetPlatform, type BuildOptions, type BuildResult, type MultiBuildOptions, type MultiBuildResult, type StaticWidgetOptions, buildToolUI, buildToolUIMulti, buildStaticWidget, } from './build';
+export * from './validation';
+export * from './theme';
+export * from './layouts';
+export * from './components';
+export * from './pages';
+export * from './widgets';
+export { type ProviderType, type DisplayMode, type ThemeMode, type HostContext, type MCPBridge, type MCPBridgeExtended, type WrapToolUIOptions, type OpenAIRuntime, type OpenAIUserAgent, type SafeAreaInsets, MCP_BRIDGE_RUNTIME, getMCPBridgeScript, isMCPBridgeSupported, DEFAULT_CSP_DIRECTIVES, buildCSPDirectives, buildCSPMetaTag, validateCSPDomain, sanitizeCSPDomains, type WrapToolUIFullOptions, wrapToolUI, wrapToolUIMinimal, createTemplateHelpers, getToolUIMimeType, type SanitizerFn, type SanitizeOptions, REDACTION_TOKENS, PII_PATTERNS, sanitizeInput, createSanitizer, detectPII, isEmail, isPhone, isCreditCard, isSSN, isIPv4, detectPIIType, redactPIIFromText, } from './runtime';
+export * from './tool-template';
+export * from './base-template';
+export * from './renderers';
+export { type PlatformAdapter, type AdapterCapabilities, type BridgeConfig, FrontMcpBridge, createBridge, AdapterRegistry, defaultRegistry, registerAdapter, generateBridgeIIFE, generatePlatformBundle, UNIVERSAL_BRIDGE_SCRIPT, BRIDGE_SCRIPT_TAGS, } from './bridge';
+export { registerAllComponents, registerFmcpButton, registerFmcpCard, registerFmcpAlert, registerFmcpBadge, registerFmcpInput, registerFmcpSelect, FmcpButton, FmcpCard, FmcpAlert, FmcpBadge, FmcpInput, FmcpSelect, FmcpElement, } from './web-components';
+export { ToolUIRegistry, type RenderOptions, type UIRenderResult, type CompileStaticWidgetOptions, type HybridComponentPayload, type BuildHybridComponentPayloadOptions, renderToolTemplate, renderToolTemplateAsync, isReactComponent, hasUIConfig, containsMdxSyntax, type RenderTemplateOptions, UI_RESOURCE_SCHEME, isUIResourceUri, isStaticWidgetUri, parseWidgetUri, buildStaticWidgetUri, getUIResourceMimeType, type ParsedWidgetUri, } from './registry';