@wundr.io/prompt-templates 1.0.3

package/dist/helpers.js

@@ -0,0 +1,566 @@
+"use strict";
+/**
+ * @wundr/prompt-templates - Built-in Handlebars helpers for prompt templating
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatTools = formatTools;
+exports.ifDefined = ifDefined;
+exports.codeBlock = codeBlock;
+exports.formatMemory = formatMemory;
+exports.repeat = repeat;
+exports.formatDate = formatDate;
+exports.json = json;
+exports.truncate = truncate;
+exports.join = join;
+exports.compare = compare;
+exports.capitalize = capitalize;
+exports.uppercase = uppercase;
+exports.lowercase = lowercase;
+exports.indent = indent;
+exports.wrap = wrap;
+exports.bulletList = bulletList;
+exports.numberedList = numberedList;
+exports.getBuiltinHelpers = getBuiltinHelpers;
+const handlebars_1 = __importDefault(require("handlebars"));
+/**
+ * Format tools array into a structured prompt format
+ *
+ * @param tools - Array of tool definitions
+ * @param options - Handlebars helper options
+ * @returns Formatted tools string
+ *
+ * @example
+ * {{formatTools tools}}
+ */
+function formatTools(tools, options) {
+    if (!tools || tools.length === 0) {
+        return '';
+    }
+    const format = options?.hash?.['format'];
+    if (format === 'json') {
+        return JSON.stringify(tools, null, 2);
+    }
+    if (format === 'compact') {
+        return tools.map(t => `- ${t.name}: ${t.description}`).join('\n');
+    }
+    // Default detailed format
+    const formatted = tools
+        .map(tool => {
+        let output = `### ${tool.name}\n${tool.description}`;
+        if (tool.parameters?.properties) {
+            output += '\n\n**Parameters:**';
+            for (const [name, prop] of Object.entries(tool.parameters.properties)) {
+                const required = tool.parameters.required?.includes(name)
+                    ? ' (required)'
+                    : '';
+                const paramProp = prop;
+                output += `\n- \`${name}\`${required}: ${paramProp.type || 'any'} - ${paramProp.description || 'No description'}`;
+            }
+        }
+        if (tool.examples && tool.examples.length > 0) {
+            output += '\n\n**Examples:**';
+            for (const example of tool.examples) {
+                output += `\n\`\`\`\n${example}\n\`\`\``;
+            }
+        }
+        return output;
+    })
+        .join('\n\n---\n\n');
+    return formatted;
+}
+/**
+ * Conditionally render block if value is defined and not null/undefined
+ *
+ * @param value - Value to check
+ * @param options - Handlebars helper options
+ * @returns Rendered block or empty string
+ *
+ * @example
+ * {{#ifDefined user.name}}Hello, {{user.name}}{{/ifDefined}}
+ */
+function ifDefined(value, options) {
+    if (value !== undefined && value !== null) {
+        return options.fn(this);
+    }
+    return options.inverse ? options.inverse(this) : '';
+}
+/**
+ * Wrap content in a code block with optional language
+ *
+ * @param language - Programming language for syntax highlighting
+ * @param options - Handlebars helper options
+ * @returns Code block formatted string
+ *
+ * @example
+ * {{#codeBlock "javascript"}}
+ * const x = 1;
+ * {{/codeBlock}}
+ */
+function codeBlock(language, options) {
+    // Handle case where language is not provided
+    if (typeof language === 'object' && !options) {
+        options = language;
+        language = '';
+    }
+    const content = options?.fn(this) || '';
+    const lang = typeof language === 'string' ? language : '';
+    return `\`\`\`${lang}\n${content.trim()}\n\`\`\``;
+}
+/**
+ * Format memory/conversation history into a readable format
+ *
+ * @param messages - Array of conversation messages
+ * @param options - Handlebars helper options
+ * @returns Formatted memory string
+ *
+ * @example
+ * {{formatMemory memory.messages}}
+ */
+function formatMemory(messages, options) {
+    if (!messages || messages.length === 0) {
+        return '';
+    }
+    const maxMessages = options?.hash?.['max'] ?? messages.length;
+    const format = options?.hash?.['format'];
+    const slicedMessages = messages.slice(-maxMessages);
+    if (format === 'compact') {
+        return slicedMessages
+            .map(m => `[${m.role.toUpperCase()}]: ${m.content}`)
+            .join('\n');
+    }
+    if (format === 'xml') {
+        return slicedMessages
+            .map(m => `<message role="${m.role}"${m.name ? ` name="${m.name}"` : ''}>\n${m.content}\n</message>`)
+            .join('\n\n');
+    }
+    // Default format
+    return slicedMessages
+        .map(m => {
+        const roleLabel = m.role.charAt(0).toUpperCase() + m.role.slice(1).toLowerCase();
+        const nameLabel = m.name ? ` (${m.name})` : '';
+        return `**${roleLabel}${nameLabel}:**\n${m.content}`;
+    })
+        .join('\n\n');
+}
+/**
+ * Repeat content n times
+ *
+ * @param count - Number of times to repeat
+ * @param options - Handlebars helper options
+ * @returns Repeated content
+ *
+ * @example
+ * {{#repeat 3}}Item {{@index}}{{/repeat}}
+ */
+function repeat(count, options) {
+    const results = [];
+    for (let i = 0; i < count; i++) {
+        const data = handlebars_1.default.createFrame(options.data || {});
+        data['index'] = i;
+        data['first'] = i === 0;
+        data['last'] = i === count - 1;
+        results.push(options.fn(this, { data }));
+    }
+    return results.join('');
+}
+/**
+ * Format a date value
+ *
+ * @param date - Date to format
+ * @param formatStr - Format string (iso, locale, relative, or custom)
+ * @returns Formatted date string
+ *
+ * @example
+ * {{formatDate timestamp "iso"}}
+ */
+function formatDate(date, formatStr) {
+    if (!date) {
+        return '';
+    }
+    const dateObj = date instanceof Date ? date : new Date(date);
+    if (isNaN(dateObj.getTime())) {
+        return '';
+    }
+    const format = typeof formatStr === 'string' ? formatStr : 'iso';
+    switch (format) {
+        case 'iso':
+            return dateObj.toISOString();
+        case 'locale':
+            return dateObj.toLocaleString();
+        case 'date':
+            return dateObj.toLocaleDateString();
+        case 'time':
+            return dateObj.toLocaleTimeString();
+        case 'relative': {
+            const now = Date.now();
+            const diff = now - dateObj.getTime();
+            const seconds = Math.floor(diff / 1000);
+            const minutes = Math.floor(seconds / 60);
+            const hours = Math.floor(minutes / 60);
+            const days = Math.floor(hours / 24);
+            if (days > 0) {
+                return `${days} day${days > 1 ? 's' : ''} ago`;
+            }
+            if (hours > 0) {
+                return `${hours} hour${hours > 1 ? 's' : ''} ago`;
+            }
+            if (minutes > 0) {
+                return `${minutes} minute${minutes > 1 ? 's' : ''} ago`;
+            }
+            return 'just now';
+        }
+        default:
+            return dateObj.toISOString();
+    }
+}
+/**
+ * JSON stringify with formatting options
+ *
+ * @param value - Value to stringify
+ * @param options - Handlebars helper options
+ * @returns JSON string
+ *
+ * @example
+ * {{json data indent=2}}
+ */
+function json(value, options) {
+    const indent = options?.hash?.['indent'] ?? 2;
+    try {
+        return JSON.stringify(value, null, indent);
+    }
+    catch {
+        return String(value);
+    }
+}
+/**
+ * Truncate text to a maximum length
+ *
+ * @param text - Text to truncate
+ * @param length - Maximum length
+ * @param suffix - Suffix to add when truncated (default: '...')
+ * @returns Truncated text
+ *
+ * @example
+ * {{truncate description 100 "..."}}
+ */
+function truncate(text, length, suffix) {
+    if (!text) {
+        return '';
+    }
+    const maxLength = typeof length === 'number' ? length : 100;
+    const ellipsis = typeof suffix === 'string' ? suffix : '...';
+    if (text.length <= maxLength) {
+        return text;
+    }
+    return text.substring(0, maxLength - ellipsis.length) + ellipsis;
+}
+/**
+ * Join array items with a separator
+ *
+ * @param items - Array to join
+ * @param separator - Separator string (default: ', ')
+ * @returns Joined string
+ *
+ * @example
+ * {{join tags ", "}}
+ */
+function join(items, separator) {
+    if (!items || !Array.isArray(items)) {
+        return '';
+    }
+    const sep = typeof separator === 'string' ? separator : ', ';
+    return items.map(String).join(sep);
+}
+/**
+ * String comparison helper
+ *
+ * @param a - First value
+ * @param operator - Comparison operator
+ * @param b - Second value
+ * @param options - Handlebars helper options
+ * @returns Rendered block based on comparison result
+ *
+ * @example
+ * {{#compare role "eq" "admin"}}Admin content{{/compare}}
+ */
+function compare(a, operator, b, options) {
+    let result = false;
+    switch (operator) {
+        case 'eq':
+        case '==':
+        case '===':
+            result = a === b;
+            break;
+        case 'ne':
+        case '!=':
+        case '!==':
+            result = a !== b;
+            break;
+        case 'lt':
+        case '<':
+            result = Number(a) < Number(b);
+            break;
+        case 'lte':
+        case '<=':
+            result = Number(a) <= Number(b);
+            break;
+        case 'gt':
+        case '>':
+            result = Number(a) > Number(b);
+            break;
+        case 'gte':
+        case '>=':
+            result = Number(a) >= Number(b);
+            break;
+        case 'contains':
+            result = typeof a === 'string' && typeof b === 'string' && a.includes(b);
+            break;
+        case 'startsWith':
+            result =
+                typeof a === 'string' && typeof b === 'string' && a.startsWith(b);
+            break;
+        case 'endsWith':
+            result = typeof a === 'string' && typeof b === 'string' && a.endsWith(b);
+            break;
+        default:
+            result = false;
+    }
+    if (result) {
+        return options.fn(this);
+    }
+    return options.inverse ? options.inverse(this) : '';
+}
+/**
+ * Capitalize first letter of string
+ *
+ * @param text - Text to capitalize
+ * @returns Capitalized text
+ *
+ * @example
+ * {{capitalize name}}
+ */
+function capitalize(text) {
+    if (!text) {
+        return '';
+    }
+    return text.charAt(0).toUpperCase() + text.slice(1);
+}
+/**
+ * Convert string to uppercase
+ *
+ * @param text - Text to convert
+ * @returns Uppercase text
+ *
+ * @example
+ * {{uppercase status}}
+ */
+function uppercase(text) {
+    if (!text) {
+        return '';
+    }
+    return text.toUpperCase();
+}
+/**
+ * Convert string to lowercase
+ *
+ * @param text - Text to convert
+ * @returns Lowercase text
+ *
+ * @example
+ * {{lowercase status}}
+ */
+function lowercase(text) {
+    if (!text) {
+        return '';
+    }
+    return text.toLowerCase();
+}
+/**
+ * Indent text by a number of spaces
+ *
+ * @param text - Text to indent
+ * @param spaces - Number of spaces (default: 2)
+ * @returns Indented text
+ *
+ * @example
+ * {{indent content 4}}
+ */
+function indent(text, spaces) {
+    if (!text) {
+        return '';
+    }
+    const numSpaces = typeof spaces === 'number' ? spaces : 2;
+    const indentStr = ' '.repeat(numSpaces);
+    return text
+        .split('\n')
+        .map(line => indentStr + line)
+        .join('\n');
+}
+/**
+ * Wrap text to a maximum line width
+ *
+ * @param text - Text to wrap
+ * @param width - Maximum line width (default: 80)
+ * @returns Wrapped text
+ *
+ * @example
+ * {{wrap longText 72}}
+ */
+function wrap(text, width) {
+    if (!text) {
+        return '';
+    }
+    const maxWidth = typeof width === 'number' ? width : 80;
+    const words = text.split(' ');
+    const lines = [];
+    let currentLine = '';
+    for (const word of words) {
+        if (currentLine.length + word.length + 1 > maxWidth) {
+            if (currentLine) {
+                lines.push(currentLine);
+            }
+            currentLine = word;
+        }
+        else {
+            currentLine = currentLine ? `${currentLine} ${word}` : word;
+        }
+    }
+    if (currentLine) {
+        lines.push(currentLine);
+    }
+    return lines.join('\n');
+}
+/**
+ * Create a bulleted list from array
+ *
+ * @param items - Array of items
+ * @param options - Handlebars helper options
+ * @returns Bulleted list string
+ *
+ * @example
+ * {{bulletList items bullet="*"}}
+ */
+function bulletList(items, options) {
+    if (!items || !Array.isArray(items)) {
+        return '';
+    }
+    const bullet = options?.hash?.['bullet'] || '-';
+    return items.map(item => `${bullet} ${String(item)}`).join('\n');
+}
+/**
+ * Create a numbered list from array
+ *
+ * @param items - Array of items
+ * @param options - Handlebars helper options
+ * @returns Numbered list string
+ *
+ * @example
+ * {{numberedList steps start=1}}
+ */
+function numberedList(items, options) {
+    if (!items || !Array.isArray(items)) {
+        return '';
+    }
+    const start = options?.hash?.['start'] || 1;
+    return items
+        .map((item, index) => `${start + index}. ${String(item)}`)
+        .join('\n');
+}
+/**
+ * Get all built-in helper definitions
+ *
+ * @returns Array of helper definitions
+ */
+function getBuiltinHelpers() {
+    return [
+        {
+            name: 'formatTools',
+            description: 'Format tools array into a structured prompt format',
+            fn: formatTools,
+        },
+        {
+            name: 'ifDefined',
+            description: 'Conditionally render block if value is defined and not null/undefined',
+            fn: ifDefined,
+        },
+        {
+            name: 'codeBlock',
+            description: 'Wrap content in a code block with optional language',
+            fn: codeBlock,
+        },
+        {
+            name: 'formatMemory',
+            description: 'Format memory/conversation history into a readable format',
+            fn: formatMemory,
+        },
+        {
+            name: 'repeat',
+            description: 'Repeat content n times',
+            fn: repeat,
+        },
+        {
+            name: 'formatDate',
+            description: 'Format a date value',
+            fn: formatDate,
+        },
+        {
+            name: 'json',
+            description: 'JSON stringify with formatting options',
+            fn: json,
+        },
+        {
+            name: 'truncate',
+            description: 'Truncate text to a maximum length',
+            fn: truncate,
+        },
+        {
+            name: 'join',
+            description: 'Join array items with a separator',
+            fn: join,
+        },
+        {
+            name: 'compare',
+            description: 'String comparison helper',
+            fn: compare,
+        },
+        {
+            name: 'capitalize',
+            description: 'Capitalize first letter of string',
+            fn: capitalize,
+        },
+        {
+            name: 'uppercase',
+            description: 'Convert string to uppercase',
+            fn: uppercase,
+        },
+        {
+            name: 'lowercase',
+            description: 'Convert string to lowercase',
+            fn: lowercase,
+        },
+        {
+            name: 'indent',
+            description: 'Indent text by a number of spaces',
+            fn: indent,
+        },
+        {
+            name: 'wrap',
+            description: 'Wrap text to a maximum line width',
+            fn: wrap,
+        },
+        {
+            name: 'bulletList',
+            description: 'Create a bulleted list from array',
+            fn: bulletList,
+        },
+        {
+            name: 'numberedList',
+            description: 'Create a numbered list from array',
+            fn: numberedList,
+        },
+    ];
+}
+//# sourceMappingURL=helpers.js.map

package/dist/helpers.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,56 @@
+/**
+ * @wundr/prompt-templates - Jinja2-style dynamic prompt templating using Handlebars
+ *
+ * This package provides a powerful templating engine for creating dynamic AI prompts
+ * with support for variables, helpers, macros, and context-aware rendering.
+ *
+ * @example Basic usage
+ * ```typescript
+ * import { createEngine } from '@wundr.io/prompt-templates';
+ *
+ * const engine = createEngine();
+ *
+ * const result = engine.render(
+ *   'Hello, {{name}}! You are a {{role}}.',
+ *   { variables: { name: 'Claude', role: 'helpful assistant' } }
+ * );
+ *
+ * console.log(result.output);
+ * // Output: "Hello, Claude! You are a helpful assistant."
+ * ```
+ *
+ * @example Using macros
+ * ```typescript
+ * import { createEngine } from '@wundr.io/prompt-templates';
+ *
+ * const engine = createEngine();
+ *
+ * const result = engine.render(
+ *   '{{> systemRole role="a coding assistant" expertise="TypeScript" }}',
+ *   { variables: {} }
+ * );
+ * ```
+ *
+ * @example Loading templates from files
+ * ```typescript
+ * import { createEngine } from '@wundr.io/prompt-templates';
+ *
+ * const engine = createEngine({}, '/path/to/templates');
+ * engine.loadTemplate('my-prompt');
+ *
+ * const result = engine.render('my-prompt', {
+ *   variables: { user: 'John' }
+ * });
+ * ```
+ *
+ * @packageDocumentation
+ */
+export type { JsonPrimitive, JsonValue, JsonObject, JsonArray, TemplateContext, SystemContext, MemoryContext, ConversationMessage, ToolDefinition, ToolParameters, ToolParameterProperty, PromptTemplateConfig, MacroDefinition, MacroParameter, HelperDefinition, HelperFunction, SafeString, RenderOptions, RenderResult, RenderMetadata, TemplateError, LoaderOptions, EngineEvents, EngineEventHandler, } from './types.js';
+export { PromptTemplateConfigSchema, ToolDefinitionSchema, MacroDefinitionSchema, } from './types.js';
+export { PromptTemplateEngine, createEngine } from './engine.js';
+export { TemplateLoader, createLoader } from './loader.js';
+export { formatTools, ifDefined, codeBlock, formatMemory, repeat, formatDate, json, truncate, join, compare, capitalize, uppercase, lowercase, indent, wrap, bulletList, numberedList, getBuiltinHelpers, } from './helpers.js';
+export { systemRoleMacro, taskContextMacro, outputFormatMacro, conversationHistoryMacro, toolsSectionMacro, codeContextMacro, chainOfThoughtMacro, fewShotExamplesMacro, safetyGuardrailsMacro, personaMacro, getBuiltinMacros, getMacroByName, getMacroNames, } from './macros.js';
+export declare const version = "1.0.3";
+export declare const name = "@wundr.io/prompt-templates";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AAGH,YAAY,EAEV,aAAa,EACb,SAAS,EACT,UAAU,EACV,SAAS,EAET,eAAe,EACf,aAAa,EACb,aAAa,EACb,mBAAmB,EAEnB,cAAc,EACd,cAAc,EACd,qBAAqB,EAErB,oBAAoB,EACpB,eAAe,EACf,cAAc,EACd,gBAAgB,EAChB,cAAc,EACd,UAAU,EAEV,aAAa,EACb,YAAY,EACZ,cAAc,EACd,aAAa,EAEb,aAAa,EAEb,YAAY,EACZ,kBAAkB,GACnB,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,0BAA0B,EAC1B,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,oBAAoB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAGjE,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAG3D,OAAO,EACL,WAAW,EACX,SAAS,EACT,SAAS,EACT,YAAY,EACZ,MAAM,EACN,UAAU,EACV,IAAI,EACJ,QAAQ,EACR,IAAI,EACJ,OAAO,EACP,UAAU,EACV,SAAS,EACT,SAAS,EACT,MAAM,EACN,IAAI,EACJ,UAAU,EACV,YAAY,EACZ,iBAAiB,GAClB,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,iBAAiB,EACjB,wBAAwB,EACxB,iBAAiB,EACjB,gBAAgB,EAChB,mBAAmB,EACnB,oBAAoB,EACpB,qBAAqB,EACrB,YAAY,EACZ,gBAAgB,EAChB,cAAc,EACd,aAAa,GACd,MAAM,aAAa,CAAC;AAGrB,eAAO,MAAM,OAAO,UAAU,CAAC;AAC/B,eAAO,MAAM,IAAI,+BAA+B,CAAC"}