@frontmcp/ui 0.5.0 → 0.6.0

package/src/handlebars/index.d.ts

@@ -1,193 +0,0 @@
-/**
- * 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

@@ -1,350 +0,0 @@
-"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

@@ -1 +0,0 @@
-{"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

@@ -1,50 +0,0 @@
-/**
- * @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';