@frontmcp/ui 0.5.0 → 0.6.0

package/esm/dependency/types.d.ts.map

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

package/esm/handlebars/expression-extractor.d.ts

@@ -0,0 +1,147 @@
+/**
+ * Handlebars Expression Extractor
+ *
+ * Extracts variable paths from Handlebars templates for validation
+ * against schemas.
+ *
+ * @packageDocumentation
+ */
+/**
+ * Type of Handlebars expression.
+ */
+export type ExpressionType = 'variable' | 'helper' | 'block' | 'block-close';
+/**
+ * Extracted expression with metadata.
+ */
+export interface ExtractedExpression {
+    /** The variable path (e.g., "output.temperature") */
+    path: string;
+    /** The full expression (e.g., "{{output.temperature}}") */
+    fullExpression: string;
+    /** Line number in template (1-indexed) */
+    line: number;
+    /** Column position (1-indexed) */
+    column: number;
+    /** Type of expression */
+    type: ExpressionType;
+    /** For helpers, the helper name */
+    helperName?: string;
+}
+/**
+ * Result of expression extraction.
+ */
+export interface ExtractionResult {
+    /** All extracted expressions */
+    expressions: ExtractedExpression[];
+    /** Unique variable paths */
+    paths: string[];
+    /** Paths starting with "output." */
+    outputPaths: string[];
+    /** Paths starting with "input." */
+    inputPaths: string[];
+    /** Paths starting with "structuredContent." */
+    structuredContentPaths: string[];
+}
+/**
+ * Extract all Handlebars expressions from a template.
+ *
+ * @param template - Handlebars template string
+ * @returns Array of extracted expressions with metadata
+ *
+ * @example
+ * ```typescript
+ * const expressions = extractExpressions('<div>{{output.name}}</div>');
+ * // [{ path: 'output.name', fullExpression: '{{output.name}}', ... }]
+ * ```
+ */
+export declare function extractExpressions(template: string): ExtractedExpression[];
+/**
+ * Extract all variable paths from a template.
+ *
+ * @param template - Handlebars template string
+ * @returns Array of unique variable paths
+ *
+ * @example
+ * ```typescript
+ * const paths = extractVariablePaths('<div>{{output.a}} {{input.b}}</div>');
+ * // ['output.a', 'input.b']
+ * ```
+ */
+export declare function extractVariablePaths(template: string): string[];
+/**
+ * Extract only output.* paths from a template.
+ *
+ * @param template - Handlebars template string
+ * @returns Array of unique output paths
+ *
+ * @example
+ * ```typescript
+ * const paths = extractOutputPaths('<div>{{output.temp}} {{input.city}}</div>');
+ * // ['output.temp']
+ * ```
+ */
+export declare function extractOutputPaths(template: string): string[];
+/**
+ * Extract only input.* paths from a template.
+ *
+ * @param template - Handlebars template string
+ * @returns Array of unique input paths
+ */
+export declare function extractInputPaths(template: string): string[];
+/**
+ * Extract only structuredContent.* paths from a template.
+ *
+ * @param template - Handlebars template string
+ * @returns Array of unique structuredContent paths
+ */
+export declare function extractStructuredContentPaths(template: string): string[];
+/**
+ * Comprehensive extraction returning all path categories.
+ *
+ * @param template - Handlebars template string
+ * @returns Extraction result with categorized paths
+ *
+ * @example
+ * ```typescript
+ * const result = extractAll('<div>{{output.a}} {{input.b}}</div>');
+ * // {
+ * //   expressions: [...],
+ * //   paths: ['output.a', 'input.b'],
+ * //   outputPaths: ['output.a'],
+ * //   inputPaths: ['input.b'],
+ * //   structuredContentPaths: []
+ * // }
+ * ```
+ */
+export declare function extractAll(template: string): ExtractionResult;
+/**
+ * Check if a template contains any Handlebars expressions with variable paths.
+ *
+ * @param template - Handlebars template string
+ * @returns true if template contains variable paths
+ */
+export declare function hasVariablePaths(template: string): boolean;
+/**
+ * Get expression details at a specific line and column.
+ *
+ * @param template - Handlebars template string
+ * @param line - Line number (1-indexed)
+ * @param column - Column number (1-indexed)
+ * @returns Expression at position or undefined
+ */
+export declare function getExpressionAt(template: string, line: number, column: number): ExtractedExpression | undefined;
+/**
+ * Normalize a path for comparison.
+ * Converts array index access to wildcard format.
+ *
+ * @param path - Variable path
+ * @returns Normalized path
+ *
+ * @example
+ * ```typescript
+ * normalizePath('output.items.0.name'); // 'output.items.[].name'
+ * normalizePath('output.data[0].value'); // 'output.data.[].value'
+ * ```
+ */
+export declare function normalizePath(path: string): string;
+//# sourceMappingURL=expression-extractor.d.ts.map

package/esm/handlebars/expression-extractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"expression-extractor.d.ts","sourceRoot":"","sources":["../../../src/handlebars/expression-extractor.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,UAAU,GAAG,QAAQ,GAAG,OAAO,GAAG,aAAa,CAAC;AAE7E;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,qDAAqD;IACrD,IAAI,EAAE,MAAM,CAAC;IACb,2DAA2D;IAC3D,cAAc,EAAE,MAAM,CAAC;IACvB,0CAA0C;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,kCAAkC;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,yBAAyB;IACzB,IAAI,EAAE,cAAc,CAAC;IACrB,mCAAmC;IACnC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,gCAAgC;IAChC,WAAW,EAAE,mBAAmB,EAAE,CAAC;IACnC,4BAA4B;IAC5B,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,oCAAoC;IACpC,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,mCAAmC;IACnC,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,+CAA+C;IAC/C,sBAAsB,EAAE,MAAM,EAAE,CAAC;CAClC;AAwCD;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,mBAAmB,EAAE,CAmE1E;AAgDD;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAI/D;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAE7D;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAE5D;AAED;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAExE;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,gBAAgB,CAW7D;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAE1D;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,mBAAmB,GAAG,SAAS,CAS/G;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAQlD"}

package/esm/handlebars/helpers.d.ts

@@ -0,0 +1,339 @@
+/**
+ * Handlebars Built-in Helpers
+ *
+ * Provides a collection of helper functions for Handlebars templates.
+ * Includes formatting, escaping, conditionals, and iteration helpers.
+ *
+ * @packageDocumentation
+ */
+import { escapeHtml } from '../utils';
+/**
+ * Helper function type for Handlebars.
+ * Allows any function signature since Handlebars helpers vary widely.
+ */
+export type HelperFunction = (...args: any[]) => string | boolean | unknown;
+export { escapeHtml };
+/**
+ * Format a date for display.
+ *
+ * @param date - Date object, ISO string, or timestamp
+ * @param format - Optional format string (default: localized date)
+ * @returns Formatted date string
+ *
+ * @example
+ * ```handlebars
+ * {{formatDate output.createdAt}}
+ * {{formatDate output.createdAt "short"}}
+ * {{formatDate output.createdAt "long"}}
+ * ```
+ */
+export declare function formatDate(date: unknown, format?: string): string;
+/**
+ * Format a number as currency.
+ *
+ * @param amount - Numeric amount
+ * @param currency - ISO 4217 currency code (default: 'USD')
+ * @returns Formatted currency string
+ *
+ * @example
+ * ```handlebars
+ * {{formatCurrency output.price}}
+ * {{formatCurrency output.price "EUR"}}
+ * ```
+ */
+export declare function formatCurrency(amount: unknown, currency?: string): string;
+/**
+ * Format a number with locale-aware separators.
+ *
+ * @param value - Number to format
+ * @param decimals - Number of decimal places (optional)
+ * @returns Formatted number string
+ *
+ * @example
+ * ```handlebars
+ * {{formatNumber output.count}}
+ * {{formatNumber output.percentage 2}}
+ * ```
+ */
+export declare function formatNumber(value: unknown, decimals?: number): string;
+/**
+ * Safely embed JSON data in HTML.
+ * Escapes script-breaking characters.
+ *
+ * @param data - Data to serialize
+ * @returns JSON string safe for embedding
+ *
+ * @example
+ * ```handlebars
+ * <script type="application/json" id="data">
+ *   {{{jsonEmbed output}}}
+ * </script>
+ * ```
+ */
+export declare function jsonEmbed(data: unknown): string;
+/**
+ * Convert data to JSON string.
+ *
+ * @param data - Data to serialize
+ * @param pretty - Whether to pretty-print (optional)
+ * @returns JSON string
+ *
+ * @example
+ * ```handlebars
+ * <pre>{{json output true}}</pre>
+ * ```
+ */
+export declare function json(data: unknown, pretty?: boolean): string;
+/**
+ * Equality comparison.
+ *
+ * @param a - First value
+ * @param b - Second value
+ * @returns true if values are equal
+ *
+ * @example
+ * ```handlebars
+ * {{#if (eq output.status "active")}}Active{{/if}}
+ * ```
+ */
+export declare function eq(a: unknown, b: unknown): boolean;
+/**
+ * Inequality comparison.
+ *
+ * @param a - First value
+ * @param b - Second value
+ * @returns true if values are not equal
+ *
+ * @example
+ * ```handlebars
+ * {{#if (ne output.status "deleted")}}Visible{{/if}}
+ * ```
+ */
+export declare function ne(a: unknown, b: unknown): boolean;
+/**
+ * Greater than comparison.
+ *
+ * @param a - First value
+ * @param b - Second value
+ * @returns true if a > b
+ *
+ * @example
+ * ```handlebars
+ * {{#if (gt output.count 10)}}Many items{{/if}}
+ * ```
+ */
+export declare function gt(a: unknown, b: unknown): boolean;
+/**
+ * Greater than or equal comparison.
+ *
+ * @param a - First value
+ * @param b - Second value
+ * @returns true if a >= b
+ */
+export declare function gte(a: unknown, b: unknown): boolean;
+/**
+ * Less than comparison.
+ *
+ * @param a - First value
+ * @param b - Second value
+ * @returns true if a < b
+ *
+ * @example
+ * ```handlebars
+ * {{#if (lt output.remaining 5)}}Running low{{/if}}
+ * ```
+ */
+export declare function lt(a: unknown, b: unknown): boolean;
+/**
+ * Less than or equal comparison.
+ *
+ * @param a - First value
+ * @param b - Second value
+ * @returns true if a <= b
+ */
+export declare function lte(a: unknown, b: unknown): boolean;
+/**
+ * Logical AND.
+ *
+ * @param a - First value
+ * @param b - Second value
+ * @returns true if both values are truthy
+ *
+ * @example
+ * ```handlebars
+ * {{#if (and output.enabled output.visible)}}Show content{{/if}}
+ * ```
+ */
+export declare function and(a: unknown, b: unknown): boolean;
+/**
+ * Logical OR.
+ *
+ * @param a - First value
+ * @param b - Second value
+ * @returns true if either value is truthy
+ *
+ * @example
+ * ```handlebars
+ * {{#if (or output.featured output.promoted)}}Highlight{{/if}}
+ * ```
+ */
+export declare function or(a: unknown, b: unknown): boolean;
+/**
+ * Logical NOT.
+ *
+ * @param value - Value to negate
+ * @returns Negated boolean
+ *
+ * @example
+ * ```handlebars
+ * {{#if (not output.hidden)}}Visible{{/if}}
+ * ```
+ */
+export declare function not(value: unknown): boolean;
+/**
+ * Get the first element of an array.
+ *
+ * @param arr - Array
+ * @returns First element
+ *
+ * @example
+ * ```handlebars
+ * {{first output.items}}
+ * ```
+ */
+export declare function first<T>(arr: T[]): T | undefined;
+/**
+ * Get the last element of an array.
+ *
+ * @param arr - Array
+ * @returns Last element
+ *
+ * @example
+ * ```handlebars
+ * {{last output.items}}
+ * ```
+ */
+export declare function last<T>(arr: T[]): T | undefined;
+/**
+ * Get the length of an array or string.
+ *
+ * @param value - Array or string
+ * @returns Length
+ *
+ * @example
+ * ```handlebars
+ * {{length output.items}} items
+ * ```
+ */
+export declare function length(value: unknown): number;
+/**
+ * Check if a value is in an array.
+ *
+ * @param arr - Array to search
+ * @param value - Value to find
+ * @returns true if value is in array
+ *
+ * @example
+ * ```handlebars
+ * {{#if (includes output.tags "featured")}}Featured{{/if}}
+ * ```
+ */
+export declare function includes(arr: unknown, value: unknown): boolean;
+/**
+ * Join array elements with a separator.
+ *
+ * @param arr - Array to join
+ * @param separator - Separator string (default: ', ')
+ * @returns Joined string
+ *
+ * @example
+ * ```handlebars
+ * {{join output.tags ", "}}
+ * ```
+ */
+export declare function join(arr: unknown, separator?: string): string;
+/**
+ * Convert to uppercase.
+ *
+ * @param str - String to convert
+ * @returns Uppercase string
+ *
+ * @example
+ * ```handlebars
+ * {{uppercase output.status}}
+ * ```
+ */
+export declare function uppercase(str: unknown): string;
+/**
+ * Convert to lowercase.
+ *
+ * @param str - String to convert
+ * @returns Lowercase string
+ *
+ * @example
+ * ```handlebars
+ * {{lowercase output.name}}
+ * ```
+ */
+export declare function lowercase(str: unknown): string;
+/**
+ * Capitalize the first letter.
+ *
+ * @param str - String to capitalize
+ * @returns Capitalized string
+ *
+ * @example
+ * ```handlebars
+ * {{capitalize output.name}}
+ * ```
+ */
+export declare function capitalize(str: unknown): string;
+/**
+ * Truncate a string to a maximum length.
+ *
+ * @param str - String to truncate
+ * @param maxLength - Maximum length
+ * @param suffix - Suffix to add if truncated (default: '...')
+ * @returns Truncated string
+ *
+ * @example
+ * ```handlebars
+ * {{truncate output.description 100}}
+ * ```
+ */
+export declare function truncate(str: unknown, maxLength?: number, suffix?: string): string;
+/**
+ * Provide a default value if the input is falsy.
+ *
+ * @param value - Value to check
+ * @param defaultValue - Default value if falsy
+ * @returns Value or default
+ *
+ * @example
+ * ```handlebars
+ * {{default output.name "Unknown"}}
+ * ```
+ */
+export declare function defaultValue(value: unknown, defaultValue: unknown): unknown;
+export declare function uniqueId(prefix?: string): string;
+/**
+ * Reset the unique ID counter (for testing).
+ */
+export declare function resetUniqueIdCounter(): void;
+/**
+ * Conditionally join class names.
+ *
+ * @param classes - Class names (falsy values are filtered)
+ * @returns Space-separated class string
+ *
+ * @example
+ * ```handlebars
+ * <div class="{{classNames 'base' (if active 'active') (if disabled 'disabled')}}">
+ * ```
+ */
+export declare function classNames(...classes: unknown[]): string;
+/**
+ * Collection of all built-in helpers.
+ */
+export declare const builtinHelpers: Record<string, HelperFunction>;
+//# sourceMappingURL=helpers.d.ts.map

package/esm/handlebars/helpers.d.ts.map

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

package/esm/handlebars/index.d.ts

@@ -0,0 +1,195 @@
+/**
+ * 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';
+export { extractExpressions, extractVariablePaths, extractOutputPaths, extractInputPaths, extractStructuredContentPaths, extractAll, hasVariablePaths, getExpressionAt, normalizePath, type ExtractedExpression, type ExtractionResult, type ExpressionType, } from './expression-extractor';
+//# sourceMappingURL=index.d.ts.map