@frontmcp/ui 0.5.0

package/src/handlebars/helpers.js

@@ -0,0 +1,605 @@
+"use strict";
+/**
+ * Handlebars Built-in Helpers
+ *
+ * Provides a collection of helper functions for Handlebars templates.
+ * Includes formatting, escaping, conditionals, and iteration helpers.
+ *
+ * @packageDocumentation
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.builtinHelpers = void 0;
+exports.escapeHtml = escapeHtml;
+exports.formatDate = formatDate;
+exports.formatCurrency = formatCurrency;
+exports.formatNumber = formatNumber;
+exports.jsonEmbed = jsonEmbed;
+exports.json = json;
+exports.eq = eq;
+exports.ne = ne;
+exports.gt = gt;
+exports.gte = gte;
+exports.lt = lt;
+exports.lte = lte;
+exports.and = and;
+exports.or = or;
+exports.not = not;
+exports.first = first;
+exports.last = last;
+exports.length = length;
+exports.includes = includes;
+exports.join = join;
+exports.uppercase = uppercase;
+exports.lowercase = lowercase;
+exports.capitalize = capitalize;
+exports.truncate = truncate;
+exports.defaultValue = defaultValue;
+exports.uniqueId = uniqueId;
+exports.resetUniqueIdCounter = resetUniqueIdCounter;
+exports.classNames = classNames;
+/**
+ * Escape HTML special characters to prevent XSS.
+ *
+ * @param str - String to escape
+ * @returns Escaped string safe for HTML output
+ *
+ * @example
+ * ```handlebars
+ * {{escapeHtml output.userInput}}
+ * ```
+ */
+function escapeHtml(str) {
+    if (str === null || str === undefined) {
+        return '';
+    }
+    const s = String(str);
+    return s
+        .replace(/&/g, '&')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;')
+        .replace(/"/g, '&quot;')
+        .replace(/'/g, '&#39;');
+}
+/**
+ * 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"}}
+ * ```
+ */
+function formatDate(date, format) {
+    if (date === null || date === undefined) {
+        return '';
+    }
+    let dateObj;
+    if (date instanceof Date) {
+        dateObj = date;
+    }
+    else if (typeof date === 'string' || typeof date === 'number') {
+        dateObj = new Date(date);
+    }
+    else {
+        return String(date);
+    }
+    if (isNaN(dateObj.getTime())) {
+        return String(date);
+    }
+    const options = {};
+    switch (format) {
+        case 'short':
+            options.dateStyle = 'short';
+            break;
+        case 'medium':
+            options.dateStyle = 'medium';
+            break;
+        case 'long':
+            options.dateStyle = 'long';
+            break;
+        case 'full':
+            options.dateStyle = 'full';
+            break;
+        case 'time':
+            options.timeStyle = 'short';
+            break;
+        case 'datetime':
+            options.dateStyle = 'medium';
+            options.timeStyle = 'short';
+            break;
+        case 'iso':
+            return dateObj.toISOString();
+        case 'relative':
+            return formatRelativeDate(dateObj);
+        default:
+            options.dateStyle = 'medium';
+    }
+    return new Intl.DateTimeFormat('en-US', options).format(dateObj);
+}
+/**
+ * Format a date relative to now.
+ */
+function formatRelativeDate(date) {
+    const now = new Date();
+    const diffMs = now.getTime() - date.getTime();
+    const diffSecs = Math.floor(diffMs / 1000);
+    const diffMins = Math.floor(diffSecs / 60);
+    const diffHours = Math.floor(diffMins / 60);
+    const diffDays = Math.floor(diffHours / 24);
+    if (diffSecs < 60) {
+        return 'just now';
+    }
+    else if (diffMins < 60) {
+        return `${diffMins} minute${diffMins === 1 ? '' : 's'} ago`;
+    }
+    else if (diffHours < 24) {
+        return `${diffHours} hour${diffHours === 1 ? '' : 's'} ago`;
+    }
+    else if (diffDays < 7) {
+        return `${diffDays} day${diffDays === 1 ? '' : 's'} ago`;
+    }
+    else {
+        return formatDate(date, 'medium');
+    }
+}
+/**
+ * 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"}}
+ * ```
+ */
+function formatCurrency(amount, currency) {
+    if (amount === null || amount === undefined) {
+        return '';
+    }
+    const num = typeof amount === 'number' ? amount : parseFloat(String(amount));
+    if (isNaN(num)) {
+        return String(amount);
+    }
+    return new Intl.NumberFormat('en-US', {
+        style: 'currency',
+        currency: typeof currency === 'string' ? currency : 'USD',
+    }).format(num);
+}
+/**
+ * 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}}
+ * ```
+ */
+function formatNumber(value, decimals) {
+    if (value === null || value === undefined) {
+        return '';
+    }
+    const num = typeof value === 'number' ? value : parseFloat(String(value));
+    if (isNaN(num)) {
+        return String(value);
+    }
+    const options = {};
+    if (typeof decimals === 'number') {
+        options.minimumFractionDigits = decimals;
+        options.maximumFractionDigits = decimals;
+    }
+    return new Intl.NumberFormat('en-US', options).format(num);
+}
+/**
+ * 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>
+ * ```
+ */
+function jsonEmbed(data) {
+    const json = JSON.stringify(data ?? null);
+    // Escape characters that could break out of script tags
+    return json
+        .replace(/</g, '\\u003c')
+        .replace(/>/g, '\\u003e')
+        .replace(/&/g, '\\u0026')
+        .replace(/\u2028/g, '\\u2028')
+        .replace(/\u2029/g, '\\u2029');
+}
+/**
+ * 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>
+ * ```
+ */
+function json(data, pretty) {
+    return JSON.stringify(data ?? null, null, pretty ? 2 : undefined);
+}
+/**
+ * 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}}
+ * ```
+ */
+function eq(a, b) {
+    return a === b;
+}
+/**
+ * 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}}
+ * ```
+ */
+function ne(a, b) {
+    return a !== b;
+}
+/**
+ * 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}}
+ * ```
+ */
+function gt(a, b) {
+    return Number(a) > Number(b);
+}
+/**
+ * Greater than or equal comparison.
+ *
+ * @param a - First value
+ * @param b - Second value
+ * @returns true if a >= b
+ */
+function gte(a, b) {
+    return Number(a) >= Number(b);
+}
+/**
+ * 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}}
+ * ```
+ */
+function lt(a, b) {
+    return Number(a) < Number(b);
+}
+/**
+ * Less than or equal comparison.
+ *
+ * @param a - First value
+ * @param b - Second value
+ * @returns true if a <= b
+ */
+function lte(a, b) {
+    return Number(a) <= Number(b);
+}
+/**
+ * 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}}
+ * ```
+ */
+function and(a, b) {
+    return Boolean(a) && Boolean(b);
+}
+/**
+ * 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}}
+ * ```
+ */
+function or(a, b) {
+    return Boolean(a) || Boolean(b);
+}
+/**
+ * Logical NOT.
+ *
+ * @param value - Value to negate
+ * @returns Negated boolean
+ *
+ * @example
+ * ```handlebars
+ * {{#if (not output.hidden)}}Visible{{/if}}
+ * ```
+ */
+function not(value) {
+    return !value;
+}
+/**
+ * Get the first element of an array.
+ *
+ * @param arr - Array
+ * @returns First element
+ *
+ * @example
+ * ```handlebars
+ * {{first output.items}}
+ * ```
+ */
+function first(arr) {
+    if (!Array.isArray(arr))
+        return undefined;
+    return arr[0];
+}
+/**
+ * Get the last element of an array.
+ *
+ * @param arr - Array
+ * @returns Last element
+ *
+ * @example
+ * ```handlebars
+ * {{last output.items}}
+ * ```
+ */
+function last(arr) {
+    if (!Array.isArray(arr))
+        return undefined;
+    return arr[arr.length - 1];
+}
+/**
+ * Get the length of an array or string.
+ *
+ * @param value - Array or string
+ * @returns Length
+ *
+ * @example
+ * ```handlebars
+ * {{length output.items}} items
+ * ```
+ */
+function length(value) {
+    if (Array.isArray(value))
+        return value.length;
+    if (typeof value === 'string')
+        return value.length;
+    return 0;
+}
+/**
+ * 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}}
+ * ```
+ */
+function includes(arr, value) {
+    if (!Array.isArray(arr))
+        return false;
+    return arr.includes(value);
+}
+/**
+ * Join array elements with a separator.
+ *
+ * @param arr - Array to join
+ * @param separator - Separator string (default: ', ')
+ * @returns Joined string
+ *
+ * @example
+ * ```handlebars
+ * {{join output.tags ", "}}
+ * ```
+ */
+function join(arr, separator) {
+    if (!Array.isArray(arr))
+        return '';
+    return arr.join(typeof separator === 'string' ? separator : ', ');
+}
+/**
+ * Convert to uppercase.
+ *
+ * @param str - String to convert
+ * @returns Uppercase string
+ *
+ * @example
+ * ```handlebars
+ * {{uppercase output.status}}
+ * ```
+ */
+function uppercase(str) {
+    return String(str ?? '').toUpperCase();
+}
+/**
+ * Convert to lowercase.
+ *
+ * @param str - String to convert
+ * @returns Lowercase string
+ *
+ * @example
+ * ```handlebars
+ * {{lowercase output.name}}
+ * ```
+ */
+function lowercase(str) {
+    return String(str ?? '').toLowerCase();
+}
+/**
+ * Capitalize the first letter.
+ *
+ * @param str - String to capitalize
+ * @returns Capitalized string
+ *
+ * @example
+ * ```handlebars
+ * {{capitalize output.name}}
+ * ```
+ */
+function capitalize(str) {
+    const s = String(str ?? '');
+    return s.charAt(0).toUpperCase() + s.slice(1).toLowerCase();
+}
+/**
+ * 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}}
+ * ```
+ */
+function truncate(str, maxLength, suffix) {
+    const s = String(str ?? '');
+    const len = typeof maxLength === 'number' ? maxLength : 50;
+    const suf = typeof suffix === 'string' ? suffix : '...';
+    if (s.length <= len)
+        return s;
+    return s.slice(0, len - suf.length) + suf;
+}
+/**
+ * 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"}}
+ * ```
+ */
+function defaultValue(value, defaultValue) {
+    return value || defaultValue;
+}
+/**
+ * Generate a unique ID.
+ *
+ * @param prefix - Optional prefix
+ * @returns Unique ID string
+ *
+ * @example
+ * ```handlebars
+ * <div id="{{uniqueId 'widget'}}">...</div>
+ * ```
+ */
+let idCounter = 0;
+function uniqueId(prefix) {
+    const id = ++idCounter;
+    return prefix ? `${prefix}-${id}` : `id-${id}`;
+}
+/**
+ * Reset the unique ID counter (for testing).
+ */
+function resetUniqueIdCounter() {
+    idCounter = 0;
+}
+/**
+ * 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')}}">
+ * ```
+ */
+function classNames(...classes) {
+    return classes.filter(Boolean).map(String).join(' ');
+}
+/**
+ * Collection of all built-in helpers.
+ */
+exports.builtinHelpers = {
+    // Escaping
+    escapeHtml,
+    // Formatting
+    formatDate,
+    formatCurrency,
+    formatNumber,
+    json,
+    jsonEmbed,
+    // Comparison
+    eq,
+    ne,
+    gt,
+    gte,
+    lt,
+    lte,
+    // Logical
+    and,
+    or,
+    not,
+    // Array
+    first,
+    last,
+    length,
+    includes,
+    join,
+    // String
+    uppercase,
+    lowercase,
+    capitalize,
+    truncate,
+    // Utility
+    default: defaultValue,
+    uniqueId,
+    classNames,
+};
+//# sourceMappingURL=helpers.js.map

package/src/handlebars/helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../../src/handlebars/helpers.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Handlebars Built-in Helpers\n *\n * Provides a collection of helper functions for Handlebars templates.\n * Includes formatting, escaping, conditionals, and iteration helpers.\n *\n * @packageDocumentation\n */\n\n/**\n * Helper function type for Handlebars.\n * Allows any function signature since Handlebars helpers vary widely.\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport type HelperFunction = (...args: any[]) => string | boolean | unknown;\n\n/**\n * Escape HTML special characters to prevent XSS.\n *\n * @param str - String to escape\n * @returns Escaped string safe for HTML output\n *\n * @example\n * ```handlebars\n * {{escapeHtml output.userInput}}\n * ```\n */\nexport function escapeHtml(str: unknown): string {\n  if (str === null || str === undefined) {\n    return '';\n  }\n\n  const s = String(str);\n  return s\n    .replace(/&/g, '&amp;')\n    .replace(/</g, '&lt;')\n    .replace(/>/g, '&gt;')\n    .replace(/\"/g, '&quot;')\n    .replace(/'/g, '&#39;');\n}\n\n/**\n * Format a date for display.\n *\n * @param date - Date object, ISO string, or timestamp\n * @param format - Optional format string (default: localized date)\n * @returns Formatted date string\n *\n * @example\n * ```handlebars\n * {{formatDate output.createdAt}}\n * {{formatDate output.createdAt \"short\"}}\n * {{formatDate output.createdAt \"long\"}}\n * ```\n */\nexport function formatDate(date: unknown, format?: string): string {\n  if (date === null || date === undefined) {\n    return '';\n  }\n\n  let dateObj: Date;\n\n  if (date instanceof Date) {\n    dateObj = date;\n  } else if (typeof date === 'string' || typeof date === 'number') {\n    dateObj = new Date(date);\n  } else {\n    return String(date);\n  }\n\n  if (isNaN(dateObj.getTime())) {\n    return String(date);\n  }\n\n  const options: Intl.DateTimeFormatOptions = {};\n\n  switch (format) {\n    case 'short':\n      options.dateStyle = 'short';\n      break;\n    case 'medium':\n      options.dateStyle = 'medium';\n      break;\n    case 'long':\n      options.dateStyle = 'long';\n      break;\n    case 'full':\n      options.dateStyle = 'full';\n      break;\n    case 'time':\n      options.timeStyle = 'short';\n      break;\n    case 'datetime':\n      options.dateStyle = 'medium';\n      options.timeStyle = 'short';\n      break;\n    case 'iso':\n      return dateObj.toISOString();\n    case 'relative':\n      return formatRelativeDate(dateObj);\n    default:\n      options.dateStyle = 'medium';\n  }\n\n  return new Intl.DateTimeFormat('en-US', options).format(dateObj);\n}\n\n/**\n * Format a date relative to now.\n */\nfunction formatRelativeDate(date: Date): string {\n  const now = new Date();\n  const diffMs = now.getTime() - date.getTime();\n  const diffSecs = Math.floor(diffMs / 1000);\n  const diffMins = Math.floor(diffSecs / 60);\n  const diffHours = Math.floor(diffMins / 60);\n  const diffDays = Math.floor(diffHours / 24);\n\n  if (diffSecs < 60) {\n    return 'just now';\n  } else if (diffMins < 60) {\n    return `${diffMins} minute${diffMins === 1 ? '' : 's'} ago`;\n  } else if (diffHours < 24) {\n    return `${diffHours} hour${diffHours === 1 ? '' : 's'} ago`;\n  } else if (diffDays < 7) {\n    return `${diffDays} day${diffDays === 1 ? '' : 's'} ago`;\n  } else {\n    return formatDate(date, 'medium');\n  }\n}\n\n/**\n * Format a number as currency.\n *\n * @param amount - Numeric amount\n * @param currency - ISO 4217 currency code (default: 'USD')\n * @returns Formatted currency string\n *\n * @example\n * ```handlebars\n * {{formatCurrency output.price}}\n * {{formatCurrency output.price \"EUR\"}}\n * ```\n */\nexport function formatCurrency(amount: unknown, currency?: string): string {\n  if (amount === null || amount === undefined) {\n    return '';\n  }\n\n  const num = typeof amount === 'number' ? amount : parseFloat(String(amount));\n\n  if (isNaN(num)) {\n    return String(amount);\n  }\n\n  return new Intl.NumberFormat('en-US', {\n    style: 'currency',\n    currency: typeof currency === 'string' ? currency : 'USD',\n  }).format(num);\n}\n\n/**\n * Format a number with locale-aware separators.\n *\n * @param value - Number to format\n * @param decimals - Number of decimal places (optional)\n * @returns Formatted number string\n *\n * @example\n * ```handlebars\n * {{formatNumber output.count}}\n * {{formatNumber output.percentage 2}}\n * ```\n */\nexport function formatNumber(value: unknown, decimals?: number): string {\n  if (value === null || value === undefined) {\n    return '';\n  }\n\n  const num = typeof value === 'number' ? value : parseFloat(String(value));\n\n  if (isNaN(num)) {\n    return String(value);\n  }\n\n  const options: Intl.NumberFormatOptions = {};\n  if (typeof decimals === 'number') {\n    options.minimumFractionDigits = decimals;\n    options.maximumFractionDigits = decimals;\n  }\n\n  return new Intl.NumberFormat('en-US', options).format(num);\n}\n\n/**\n * Safely embed JSON data in HTML.\n * Escapes script-breaking characters.\n *\n * @param data - Data to serialize\n * @returns JSON string safe for embedding\n *\n * @example\n * ```handlebars\n * <script type=\"application/json\" id=\"data\">\n *   {{{jsonEmbed output}}}\n * </script>\n * ```\n */\nexport function jsonEmbed(data: unknown): string {\n  const json = JSON.stringify(data ?? null);\n  // Escape characters that could break out of script tags\n  return json\n    .replace(/</g, '\\\\u003c')\n    .replace(/>/g, '\\\\u003e')\n    .replace(/&/g, '\\\\u0026')\n    .replace(/\\u2028/g, '\\\\u2028')\n    .replace(/\\u2029/g, '\\\\u2029');\n}\n\n/**\n * Convert data to JSON string.\n *\n * @param data - Data to serialize\n * @param pretty - Whether to pretty-print (optional)\n * @returns JSON string\n *\n * @example\n * ```handlebars\n * <pre>{{json output true}}</pre>\n * ```\n */\nexport function json(data: unknown, pretty?: boolean): string {\n  return JSON.stringify(data ?? null, null, pretty ? 2 : undefined);\n}\n\n/**\n * Equality comparison.\n *\n * @param a - First value\n * @param b - Second value\n * @returns true if values are equal\n *\n * @example\n * ```handlebars\n * {{#if (eq output.status \"active\")}}Active{{/if}}\n * ```\n */\nexport function eq(a: unknown, b: unknown): boolean {\n  return a === b;\n}\n\n/**\n * Inequality comparison.\n *\n * @param a - First value\n * @param b - Second value\n * @returns true if values are not equal\n *\n * @example\n * ```handlebars\n * {{#if (ne output.status \"deleted\")}}Visible{{/if}}\n * ```\n */\nexport function ne(a: unknown, b: unknown): boolean {\n  return a !== b;\n}\n\n/**\n * Greater than comparison.\n *\n * @param a - First value\n * @param b - Second value\n * @returns true if a > b\n *\n * @example\n * ```handlebars\n * {{#if (gt output.count 10)}}Many items{{/if}}\n * ```\n */\nexport function gt(a: unknown, b: unknown): boolean {\n  return Number(a) > Number(b);\n}\n\n/**\n * Greater than or equal comparison.\n *\n * @param a - First value\n * @param b - Second value\n * @returns true if a >= b\n */\nexport function gte(a: unknown, b: unknown): boolean {\n  return Number(a) >= Number(b);\n}\n\n/**\n * Less than comparison.\n *\n * @param a - First value\n * @param b - Second value\n * @returns true if a < b\n *\n * @example\n * ```handlebars\n * {{#if (lt output.remaining 5)}}Running low{{/if}}\n * ```\n */\nexport function lt(a: unknown, b: unknown): boolean {\n  return Number(a) < Number(b);\n}\n\n/**\n * Less than or equal comparison.\n *\n * @param a - First value\n * @param b - Second value\n * @returns true if a <= b\n */\nexport function lte(a: unknown, b: unknown): boolean {\n  return Number(a) <= Number(b);\n}\n\n/**\n * Logical AND.\n *\n * @param a - First value\n * @param b - Second value\n * @returns true if both values are truthy\n *\n * @example\n * ```handlebars\n * {{#if (and output.enabled output.visible)}}Show content{{/if}}\n * ```\n */\nexport function and(a: unknown, b: unknown): boolean {\n  return Boolean(a) && Boolean(b);\n}\n\n/**\n * Logical OR.\n *\n * @param a - First value\n * @param b - Second value\n * @returns true if either value is truthy\n *\n * @example\n * ```handlebars\n * {{#if (or output.featured output.promoted)}}Highlight{{/if}}\n * ```\n */\nexport function or(a: unknown, b: unknown): boolean {\n  return Boolean(a) || Boolean(b);\n}\n\n/**\n * Logical NOT.\n *\n * @param value - Value to negate\n * @returns Negated boolean\n *\n * @example\n * ```handlebars\n * {{#if (not output.hidden)}}Visible{{/if}}\n * ```\n */\nexport function not(value: unknown): boolean {\n  return !value;\n}\n\n/**\n * Get the first element of an array.\n *\n * @param arr - Array\n * @returns First element\n *\n * @example\n * ```handlebars\n * {{first output.items}}\n * ```\n */\nexport function first<T>(arr: T[]): T | undefined {\n  if (!Array.isArray(arr)) return undefined;\n  return arr[0];\n}\n\n/**\n * Get the last element of an array.\n *\n * @param arr - Array\n * @returns Last element\n *\n * @example\n * ```handlebars\n * {{last output.items}}\n * ```\n */\nexport function last<T>(arr: T[]): T | undefined {\n  if (!Array.isArray(arr)) return undefined;\n  return arr[arr.length - 1];\n}\n\n/**\n * Get the length of an array or string.\n *\n * @param value - Array or string\n * @returns Length\n *\n * @example\n * ```handlebars\n * {{length output.items}} items\n * ```\n */\nexport function length(value: unknown): number {\n  if (Array.isArray(value)) return value.length;\n  if (typeof value === 'string') return value.length;\n  return 0;\n}\n\n/**\n * Check if a value is in an array.\n *\n * @param arr - Array to search\n * @param value - Value to find\n * @returns true if value is in array\n *\n * @example\n * ```handlebars\n * {{#if (includes output.tags \"featured\")}}Featured{{/if}}\n * ```\n */\nexport function includes(arr: unknown, value: unknown): boolean {\n  if (!Array.isArray(arr)) return false;\n  return arr.includes(value);\n}\n\n/**\n * Join array elements with a separator.\n *\n * @param arr - Array to join\n * @param separator - Separator string (default: ', ')\n * @returns Joined string\n *\n * @example\n * ```handlebars\n * {{join output.tags \", \"}}\n * ```\n */\nexport function join(arr: unknown, separator?: string): string {\n  if (!Array.isArray(arr)) return '';\n  return arr.join(typeof separator === 'string' ? separator : ', ');\n}\n\n/**\n * Convert to uppercase.\n *\n * @param str - String to convert\n * @returns Uppercase string\n *\n * @example\n * ```handlebars\n * {{uppercase output.status}}\n * ```\n */\nexport function uppercase(str: unknown): string {\n  return String(str ?? '').toUpperCase();\n}\n\n/**\n * Convert to lowercase.\n *\n * @param str - String to convert\n * @returns Lowercase string\n *\n * @example\n * ```handlebars\n * {{lowercase output.name}}\n * ```\n */\nexport function lowercase(str: unknown): string {\n  return String(str ?? '').toLowerCase();\n}\n\n/**\n * Capitalize the first letter.\n *\n * @param str - String to capitalize\n * @returns Capitalized string\n *\n * @example\n * ```handlebars\n * {{capitalize output.name}}\n * ```\n */\nexport function capitalize(str: unknown): string {\n  const s = String(str ?? '');\n  return s.charAt(0).toUpperCase() + s.slice(1).toLowerCase();\n}\n\n/**\n * Truncate a string to a maximum length.\n *\n * @param str - String to truncate\n * @param maxLength - Maximum length\n * @param suffix - Suffix to add if truncated (default: '...')\n * @returns Truncated string\n *\n * @example\n * ```handlebars\n * {{truncate output.description 100}}\n * ```\n */\nexport function truncate(str: unknown, maxLength?: number, suffix?: string): string {\n  const s = String(str ?? '');\n  const len = typeof maxLength === 'number' ? maxLength : 50;\n  const suf = typeof suffix === 'string' ? suffix : '...';\n\n  if (s.length <= len) return s;\n  return s.slice(0, len - suf.length) + suf;\n}\n\n/**\n * Provide a default value if the input is falsy.\n *\n * @param value - Value to check\n * @param defaultValue - Default value if falsy\n * @returns Value or default\n *\n * @example\n * ```handlebars\n * {{default output.name \"Unknown\"}}\n * ```\n */\nexport function defaultValue(value: unknown, defaultValue: unknown): unknown {\n  return value || defaultValue;\n}\n\n/**\n * Generate a unique ID.\n *\n * @param prefix - Optional prefix\n * @returns Unique ID string\n *\n * @example\n * ```handlebars\n * <div id=\"{{uniqueId 'widget'}}\">...</div>\n * ```\n */\nlet idCounter = 0;\nexport function uniqueId(prefix?: string): string {\n  const id = ++idCounter;\n  return prefix ? `${prefix}-${id}` : `id-${id}`;\n}\n\n/**\n * Reset the unique ID counter (for testing).\n */\nexport function resetUniqueIdCounter(): void {\n  idCounter = 0;\n}\n\n/**\n * Conditionally join class names.\n *\n * @param classes - Class names (falsy values are filtered)\n * @returns Space-separated class string\n *\n * @example\n * ```handlebars\n * <div class=\"{{classNames 'base' (if active 'active') (if disabled 'disabled')}}\">\n * ```\n */\nexport function classNames(...classes: unknown[]): string {\n  return classes.filter(Boolean).map(String).join(' ');\n}\n\n/**\n * Collection of all built-in helpers.\n */\nexport const builtinHelpers: Record<string, HelperFunction> = {\n  // Escaping\n  escapeHtml,\n\n  // Formatting\n  formatDate,\n  formatCurrency,\n  formatNumber,\n  json,\n  jsonEmbed,\n\n  // Comparison\n  eq,\n  ne,\n  gt,\n  gte,\n  lt,\n  lte,\n\n  // Logical\n  and,\n  or,\n  not,\n\n  // Array\n  first,\n  last,\n  length,\n  includes,\n  join,\n\n  // String\n  uppercase,\n  lowercase,\n  capitalize,\n  truncate,\n\n  // Utility\n  default: defaultValue,\n  uniqueId,\n  classNames,\n};\n"]}