@wundr.io/prompt-templates 1.0.3

package/dist/helpers.d.ts

@@ -0,0 +1,201 @@
+/**
+ * @wundr/prompt-templates - Built-in Handlebars helpers for prompt templating
+ */
+import Handlebars from 'handlebars';
+import type { ToolDefinition, ConversationMessage, HelperDefinition } from './types.js';
+/**
+ * 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}}
+ */
+export declare function formatTools(tools: ToolDefinition[] | undefined, options?: Handlebars.HelperOptions): string;
+/**
+ * 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}}
+ */
+export declare function ifDefined(this: unknown, value: unknown, options: Handlebars.HelperOptions): string;
+/**
+ * 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}}
+ */
+export declare function codeBlock(this: unknown, language: string | Handlebars.HelperOptions, options?: Handlebars.HelperOptions): string;
+/**
+ * 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}}
+ */
+export declare function formatMemory(messages: ConversationMessage[] | undefined, options?: Handlebars.HelperOptions): string;
+/**
+ * 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}}
+ */
+export declare function repeat(this: unknown, count: number, options: Handlebars.HelperOptions): string;
+/**
+ * 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"}}
+ */
+export declare function formatDate(date: Date | string | number | undefined, formatStr?: string): string;
+/**
+ * JSON stringify with formatting options
+ *
+ * @param value - Value to stringify
+ * @param options - Handlebars helper options
+ * @returns JSON string
+ *
+ * @example
+ * {{json data indent=2}}
+ */
+export declare function json(value: unknown, options?: Handlebars.HelperOptions): string;
+/**
+ * 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 "..."}}
+ */
+export declare function truncate(text: string | undefined, length?: number | Handlebars.HelperOptions, suffix?: string | Handlebars.HelperOptions): string;
+/**
+ * Join array items with a separator
+ *
+ * @param items - Array to join
+ * @param separator - Separator string (default: ', ')
+ * @returns Joined string
+ *
+ * @example
+ * {{join tags ", "}}
+ */
+export declare function join(items: unknown[] | undefined, separator?: string | Handlebars.HelperOptions): string;
+/**
+ * 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}}
+ */
+export declare function compare(this: unknown, a: unknown, operator: string, b: unknown, options: Handlebars.HelperOptions): string;
+/**
+ * Capitalize first letter of string
+ *
+ * @param text - Text to capitalize
+ * @returns Capitalized text
+ *
+ * @example
+ * {{capitalize name}}
+ */
+export declare function capitalize(text: string | undefined): string;
+/**
+ * Convert string to uppercase
+ *
+ * @param text - Text to convert
+ * @returns Uppercase text
+ *
+ * @example
+ * {{uppercase status}}
+ */
+export declare function uppercase(text: string | undefined): string;
+/**
+ * Convert string to lowercase
+ *
+ * @param text - Text to convert
+ * @returns Lowercase text
+ *
+ * @example
+ * {{lowercase status}}
+ */
+export declare function lowercase(text: string | undefined): string;
+/**
+ * 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}}
+ */
+export declare function indent(text: string | undefined, spaces?: number | Handlebars.HelperOptions): string;
+/**
+ * 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}}
+ */
+export declare function wrap(text: string | undefined, width?: number | Handlebars.HelperOptions): string;
+/**
+ * Create a bulleted list from array
+ *
+ * @param items - Array of items
+ * @param options - Handlebars helper options
+ * @returns Bulleted list string
+ *
+ * @example
+ * {{bulletList items bullet="*"}}
+ */
+export declare function bulletList(items: unknown[] | undefined, options?: Handlebars.HelperOptions): string;
+/**
+ * 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}}
+ */
+export declare function numberedList(items: unknown[] | undefined, options?: Handlebars.HelperOptions): string;
+/**
+ * Get all built-in helper definitions
+ *
+ * @returns Array of helper definitions
+ */
+export declare function getBuiltinHelpers(): HelperDefinition[];
+//# sourceMappingURL=helpers.d.ts.map

package/dist/helpers.d.ts.map

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