@hazeljs/prompts 0.2.4 → 0.3.1

package/dist/__tests__/template.test.js

@@ -56,5 +56,184 @@ describe('PromptTemplate', () => {
             expect(tpl.render({ defined: 'hello' })).toBe('hello {optional}');
         });
     });
+    describe('strict mode', () => {
+        it('should throw error when variable is missing in strict mode', () => {
+            const tpl = new template_1.PromptTemplate('Hello {name}!', { name: 'Test' });
+            expect(() => {
+                tpl.render({}, { strict: true });
+            }).toThrow('Missing required template variable');
+        });
+        it('should not throw in non-strict mode', () => {
+            const tpl = new template_1.PromptTemplate('Hello {name}!', { name: 'Test' });
+            expect(tpl.render({}, { strict: false })).toBe('Hello {name}!');
+        });
+        it('should allow undefined in non-strict mode by default', () => {
+            const tpl = new template_1.PromptTemplate('Hello {name}!', { name: 'Test' });
+            expect(tpl.render({})).toBe('Hello {name}!');
+        });
+    });
+    describe('conditionals {#if}', () => {
+        it('should render content when condition is true', () => {
+            const tpl = new template_1.PromptTemplate('{#if show}Visible{/if}', {
+                name: 'Conditional',
+            });
+            expect(tpl.render({ show: true })).toBe('Visible');
+        });
+        it('should not render content when condition is false', () => {
+            const tpl = new template_1.PromptTemplate('{#if show}Hidden{/if}', {
+                name: 'Conditional',
+            });
+            expect(tpl.render({ show: false })).toBe('');
+        });
+        it('should handle nested variables in conditional blocks', () => {
+            const tpl = new template_1.PromptTemplate('{#if show}Hello {name}!{/if}', { name: 'Conditional' });
+            expect(tpl.render({ show: true, name: 'World' })).toBe('Hello World!');
+        });
+        it('should handle multiple conditionals', () => {
+            const tpl = new template_1.PromptTemplate('{#if a}A{/if}{#if b}B{/if}', {
+                name: 'Multi',
+            });
+            expect(tpl.render({ a: true, b: false })).toBe('A');
+            expect(tpl.render({ a: false, b: true })).toBe('B');
+            expect(tpl.render({ a: true, b: true })).toBe('AB');
+        });
+    });
+    describe('loops {#each}', () => {
+        it('should iterate over array', () => {
+            const tpl = new template_1.PromptTemplate('{#each items}{.}{/each}', {
+                name: 'Loop',
+            });
+            expect(tpl.render({ items: ['a', 'b', 'c'] })).toBe('abc');
+        });
+        it('should handle empty arrays', () => {
+            const tpl = new template_1.PromptTemplate('{#each items}{.}{/each}', {
+                name: 'Loop',
+            });
+            expect(tpl.render({ items: [] })).toBe('');
+        });
+        it('should provide index in loops', () => {
+            const tpl = new template_1.PromptTemplate('{#each items}{@index}:{.} {/each}', {
+                name: 'Loop',
+            });
+            expect(tpl.render({ items: ['a', 'b'] })).toBe('0:a 1:b ');
+        });
+        it('should handle arrays with numbers', () => {
+            const tpl = new template_1.PromptTemplate('{#each nums}{.},{/each}', {
+                name: 'Loop',
+            });
+            expect(tpl.render({ nums: [1, 2, 3] })).toBe('1,2,3,');
+        });
+    });
+    describe('partials {@include}', () => {
+        it('should include partial templates', () => {
+            const partial = new template_1.PromptTemplate('Hello {name}!', { name: 'Greeting' });
+            const main = new template_1.PromptTemplate('Start {@include greeting} End', {
+                name: 'Main',
+            });
+            const includeResolver = (key) => {
+                if (key === 'greeting')
+                    return partial.render({ name: 'World' });
+                return undefined;
+            };
+            const result = main.render({ name: 'World' }, { includeResolver });
+            expect(result).toBe('Start Hello World! End');
+        });
+        it('should handle missing partials gracefully', () => {
+            const tpl = new template_1.PromptTemplate('{@include missing}', {
+                name: 'Main',
+            });
+            expect(tpl.render({})).toBe('{@include missing}');
+        });
+        it('should pass variables to partials', () => {
+            const partial = new template_1.PromptTemplate('Value: {value}', { name: 'Partial' });
+            const main = new template_1.PromptTemplate('{@include part}', { name: 'Main' });
+            const includeResolver = (key) => {
+                if (key === 'part')
+                    return partial.render({ value: 42 });
+                return undefined;
+            };
+            const result = main.render({ value: 42 }, { includeResolver });
+            expect(result).toBe('Value: 42');
+        });
+    });
+    describe('preview()', () => {
+        it('should generate preview with sample data and token estimate', () => {
+            const tpl = new template_1.PromptTemplate('Name: {name}, Age: {age}', {
+                name: 'Profile',
+            });
+            const preview = tpl.preview({ name: 'Alice', age: 30 });
+            expect(preview).toContain('Name: Alice, Age: 30');
+            expect(preview).toContain('Preview:');
+            expect(preview).toContain('tokens');
+        });
+        it('should work with conditionals in preview', () => {
+            const tpl = new template_1.PromptTemplate('{#if show}{msg}{/if}', {
+                name: 'Test',
+            });
+            const preview = tpl.preview({ show: true, msg: 'Hello' });
+            expect(preview).toContain('Hello');
+            expect(preview).toContain('Preview:');
+        });
+        it('should work with loops in preview', () => {
+            const tpl = new template_1.PromptTemplate('{#each items}{.} {/each}', {
+                name: 'Test',
+            });
+            const preview = tpl.preview({ items: [1, 2, 3] });
+            expect(preview).toContain('1 2 3');
+            expect(preview).toContain('Preview:');
+        });
+    });
+    describe('variables()', () => {
+        it('should extract simple variables', () => {
+            const tpl = new template_1.PromptTemplate('Hello {name}, you are {age} years old', { name: 'Test' });
+            const vars = tpl.variables();
+            expect(vars).toContain('name');
+            expect(vars).toContain('age');
+            expect(vars.length).toBe(2);
+        });
+        it('should extract variables from conditionals', () => {
+            const tpl = new template_1.PromptTemplate('{#if show}{msg}{/if}', {
+                name: 'Test',
+            });
+            const vars = tpl.variables();
+            expect(vars).toContain('show');
+            expect(vars).toContain('msg');
+        });
+        it('should extract variables from loops', () => {
+            const tpl = new template_1.PromptTemplate('{#each items}{item}{/each}', {
+                name: 'Test',
+            });
+            const vars = tpl.variables();
+            expect(vars).toContain('items');
+        });
+        it('should deduplicate variables', () => {
+            const tpl = new template_1.PromptTemplate('{name} and {name} again', { name: 'Test' });
+            const vars = tpl.variables();
+            expect(vars).toEqual(['name']);
+        });
+        it('should handle templates with no variables', () => {
+            const tpl = new template_1.PromptTemplate('Static text only', { name: 'Test' });
+            const vars = tpl.variables();
+            expect(vars).toEqual([]);
+        });
+    });
+    describe('complex scenarios', () => {
+        it('should handle nested conditionals and loops', () => {
+            const tpl = new template_1.PromptTemplate('{#if show}{#each items}- {.}\n{/each}{/if}', { name: 'Complex' });
+            expect(tpl.render({ show: true, items: ['a', 'b'] })).toBe('- a\n- b\n');
+            expect(tpl.render({ show: false, items: ['a', 'b'] })).toBe('');
+        });
+        it('should combine all features', () => {
+            const partial = new template_1.PromptTemplate('[{value}]', { name: 'Bracket' });
+            const tpl = new template_1.PromptTemplate('{#if show}{#each items}{@include bracket} {/each}{/if}', { name: 'All' });
+            const includeResolver = (key) => {
+                if (key === 'bracket')
+                    return partial.render({ value: 'x' });
+                return undefined;
+            };
+            const result = tpl.render({ show: true, items: ['a', 'b'] }, { includeResolver });
+            expect(result).toContain('[');
+        });
+    });
 });
 //# sourceMappingURL=template.test.js.map

package/dist/__tests__/template.test.js.map

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

package/dist/index.d.ts

@@ -1,5 +1,6 @@
 export type { PromptMetadata } from './types';
 export { PromptTemplate } from './template';
+export type { RenderOptions } from './template';
 export { PromptRegistry } from './registry';
 export type { PromptEntry, PromptStore } from './stores/store.interface';
 export { MemoryStore } from './stores/memory.store';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAG5C,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACzE,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,YAAY,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,YAAY,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAC5E,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,YAAY,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AACrF,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAG5C,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACzE,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,YAAY,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,YAAY,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAC5E,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,YAAY,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AACrF,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AACA,uCAA4C;AAAnC,0GAAA,cAAc,OAAA;AACvB,uCAA4C;AAAnC,0GAAA,cAAc,OAAA;AAIvB,sDAAoD;AAA3C,2GAAA,WAAW,OAAA;AACpB,kDAAgD;AAAvC,uGAAA,SAAS,OAAA;AAElB,oDAAkD;AAAzC,yGAAA,UAAU,OAAA;AAEnB,0DAAwD;AAA/C,+GAAA,aAAa,OAAA;AAEtB,oDAAkD;AAAzC,yGAAA,UAAU,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AACA,uCAA4C;AAAnC,0GAAA,cAAc,OAAA;AAEvB,uCAA4C;AAAnC,0GAAA,cAAc,OAAA;AAIvB,sDAAoD;AAA3C,2GAAA,WAAW,OAAA;AACpB,kDAAgD;AAAvC,uGAAA,SAAS,OAAA;AAElB,oDAAkD;AAAzC,yGAAA,UAAU,OAAA;AAEnB,0DAAwD;AAA/C,+GAAA,aAAa,OAAA;AAEtB,oDAAkD;AAAzC,yGAAA,UAAU,OAAA"}

package/dist/template.d.ts

@@ -4,6 +4,12 @@
  * A typed, reusable prompt template that interpolates named `{variable}`
  * placeholders with caller-supplied values.
  *
+ * Supports:
+ * - `{variable}` — simple substitution
+ * - `{#if variable}...{/if}` — conditional blocks
+ * - `{#each items}...{.}...{/each}` — iteration over arrays
+ * - `{@include key}` — include another prompt from the registry
+ *
  * Usage:
  * ```typescript
  * const tpl = new PromptTemplate<{ query: string; context: string }>(
@@ -13,8 +19,28 @@
  *
  * const rendered = tpl.render({ query: 'What is TypeScript?', context: '...' });
  * ```
+ *
+ * Strict mode:
+ * ```typescript
+ * tpl.render({ query: 'test' }, { strict: true });
+ * // throws: Missing required template variable: "context"
+ * ```
  */
 import type { PromptMetadata } from './types';
+export interface RenderOptions {
+    /**
+     * When `true`, throws if any `{variable}` placeholder has no matching key
+     * in the supplied variables object.
+     * @default false
+     */
+    strict?: boolean;
+    /**
+     * Optional resolver for `{@include key}` directives.
+     * When not provided, `{@include ...}` blocks are left as-is.
+     * The PromptRegistry sets this automatically when calling `render()` through it.
+     */
+    includeResolver?: (key: string) => string | undefined;
+}
 export declare class PromptTemplate<TVariables extends object = Record<string, unknown>> {
     /** The raw template string containing `{variableName}` placeholders. */
     readonly template: string;
@@ -31,8 +57,18 @@ export declare class PromptTemplate<TVariables extends object = Record<string, u
      *
      * - If a placeholder key is present in `variables` its value is `String()`-cast.
      * - If a placeholder key is NOT present it is left as-is (e.g. `{missing}`),
-     *   making missing variables easy to spot.
+     *   making missing variables easy to spot — or throws in `strict` mode.
+     */
+    render(variables: TVariables, options?: RenderOptions): string;
+    /**
+     * Preview the rendered template — alias for `render()` with an estimated
+     * token count appended for debugging.
+     */
+    preview(variables: TVariables, options?: RenderOptions): string;
+    /**
+     * Extract all placeholder variable names from the template.
+     * Useful for introspection and validation.
      */
-    render(variables: TVariables): string;
+    variables(): string[];
 }
 //# sourceMappingURL=template.d.ts.map

package/dist/template.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"template.d.ts","sourceRoot":"","sources":["../src/template.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAE9C,qBAAa,cAAc,CAAC,UAAU,SAAS,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAE3E,wEAAwE;IACxE,QAAQ,CAAC,QAAQ,EAAE,MAAM;IACzB,kEAAkE;IAClE,QAAQ,CAAC,QAAQ,EAAE,cAAc;;IAHjC,wEAAwE;IAC/D,QAAQ,EAAE,MAAM;IACzB,kEAAkE;IACzD,QAAQ,EAAE,cAAc;IAGnC;;;;;;;OAOG;IACH,MAAM,CAAC,SAAS,EAAE,UAAU,GAAG,MAAM;CAOtC"}
+{"version":3,"file":"template.d.ts","sourceRoot":"","sources":["../src/template.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAE9C,MAAM,WAAW,aAAa;IAC5B;;;;OAIG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IAEjB;;;;OAIG;IACH,eAAe,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;CACvD;AAED,qBAAa,cAAc,CAAC,UAAU,SAAS,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAE3E,wEAAwE;IACxE,QAAQ,CAAC,QAAQ,EAAE,MAAM;IACzB,kEAAkE;IAClE,QAAQ,CAAC,QAAQ,EAAE,cAAc;;IAHjC,wEAAwE;IAC/D,QAAQ,EAAE,MAAM;IACzB,kEAAkE;IACzD,QAAQ,EAAE,cAAc;IAGnC;;;;;;;OAOG;IACH,MAAM,CAAC,SAAS,EAAE,UAAU,EAAE,OAAO,GAAE,aAAkB,GAAG,MAAM;IAyElE;;;OAGG;IACH,OAAO,CAAC,SAAS,EAAE,UAAU,EAAE,OAAO,GAAE,aAAkB,GAAG,MAAM;IAOnE;;;OAGG;IACH,SAAS,IAAI,MAAM,EAAE;CAgBtB"}

package/dist/template.js

@@ -5,6 +5,12 @@
  * A typed, reusable prompt template that interpolates named `{variable}`
  * placeholders with caller-supplied values.
  *
+ * Supports:
+ * - `{variable}` — simple substitution
+ * - `{#if variable}...{/if}` — conditional blocks
+ * - `{#each items}...{.}...{/each}` — iteration over arrays
+ * - `{@include key}` — include another prompt from the registry
+ *
  * Usage:
  * ```typescript
  * const tpl = new PromptTemplate<{ query: string; context: string }>(
@@ -14,6 +20,12 @@
  *
  * const rendered = tpl.render({ query: 'What is TypeScript?', context: '...' });
  * ```
+ *
+ * Strict mode:
+ * ```typescript
+ * tpl.render({ query: 'test' }, { strict: true });
+ * // throws: Missing required template variable: "context"
+ * ```
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.PromptTemplate = void 0;
@@ -32,14 +44,96 @@ class PromptTemplate {
      *
      * - If a placeholder key is present in `variables` its value is `String()`-cast.
      * - If a placeholder key is NOT present it is left as-is (e.g. `{missing}`),
-     *   making missing variables easy to spot.
+     *   making missing variables easy to spot — or throws in `strict` mode.
      */
-    render(variables) {
+    render(variables, options = {}) {
         const vars = variables;
-        return this.template.replace(/\{(\w+)\}/g, (match, key) => {
+        let result = this.template;
+        // Step 1: Resolve {@include key} directives
+        if (options.includeResolver) {
+            const resolver = options.includeResolver;
+            result = result.replace(/\{@include\s+([\w:.-]+)\}/g, (_match, key) => {
+                const included = resolver(key);
+                return included !== undefined ? included : _match;
+            });
+        }
+        // Step 2: Process {#if variable}...{/if} blocks
+        result = result.replace(/\{#if\s+(\w+)\}([\s\S]*?)\{\/if\}/g, (_match, key, body) => {
+            const value = vars[key];
+            // Truthy check: non-empty string, non-empty array, truthy value
+            const isTruthy = Array.isArray(value)
+                ? value.length > 0
+                : value !== undefined && value !== null && value !== '' && value !== false;
+            return isTruthy ? body : '';
+        });
+        // Step 3: Process {#each items}...{.}...{/each} blocks
+        result = result.replace(/\{#each\s+(\w+)\}([\s\S]*?)\{\/each\}/g, (_match, key, body) => {
+            const value = vars[key];
+            if (!Array.isArray(value))
+                return '';
+            return value
+                .map((item, index) => {
+                let rendered = body.replace(/\{\.\}/g, String(item));
+                rendered = rendered.replace(/\{@index\}/g, String(index));
+                return rendered;
+            })
+                .join('');
+        });
+        // Step 4: Strict mode — collect all remaining placeholders and check
+        if (options.strict) {
+            const placeholders = result.match(/\{(\w+)\}/g);
+            if (placeholders) {
+                const missing = [];
+                for (const placeholder of placeholders) {
+                    const key = placeholder.slice(1, -1);
+                    if (vars[key] === undefined) {
+                        missing.push(key);
+                    }
+                }
+                if (missing.length > 0) {
+                    const unique = [...new Set(missing)];
+                    throw new Error(`[PromptTemplate] Missing required template variable${unique.length > 1 ? 's' : ''}: ` +
+                        `${unique.map((k) => `"${k}"`).join(', ')}. ` +
+                        `Template: "${this.metadata.name}" (v${this.metadata.version ?? 'latest'})`);
+                }
+            }
+        }
+        // Step 5: Variable substitution
+        result = result.replace(/\{(\w+)\}/g, (match, key) => {
             const value = vars[key];
             return value !== undefined ? String(value) : match;
         });
+        return result;
+    }
+    /**
+     * Preview the rendered template — alias for `render()` with an estimated
+     * token count appended for debugging.
+     */
+    preview(variables, options = {}) {
+        const rendered = this.render(variables, options);
+        // Rough GPT tokenizer estimate: ~4 chars per token
+        const estimatedTokens = Math.ceil(rendered.length / 4);
+        return `${rendered}\n\n--- Preview: ~${estimatedTokens} tokens, ${rendered.length} chars ---`;
+    }
+    /**
+     * Extract all placeholder variable names from the template.
+     * Useful for introspection and validation.
+     */
+    variables() {
+        const found = new Set();
+        // Simple placeholders
+        for (const match of this.template.matchAll(/\{(\w+)\}/g)) {
+            found.add(match[1]);
+        }
+        // Conditional keys
+        for (const match of this.template.matchAll(/\{#if\s+(\w+)\}/g)) {
+            found.add(match[1]);
+        }
+        // Each keys
+        for (const match of this.template.matchAll(/\{#each\s+(\w+)\}/g)) {
+            found.add(match[1]);
+        }
+        return [...found];
     }
 }
 exports.PromptTemplate = PromptTemplate;

package/dist/template.js.map

@@ -1 +1 @@
-{"version":3,"file":"template.js","sourceRoot":"","sources":["../src/template.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;GAeG;;;AAIH,MAAa,cAAc;IACzB;IACE,wEAAwE;IAC/D,QAAgB;IACzB,kEAAkE;IACzD,QAAwB;QAFxB,aAAQ,GAAR,QAAQ,CAAQ;QAEhB,aAAQ,GAAR,QAAQ,CAAgB;IAChC,CAAC;IAEJ;;;;;;;OAOG;IACH,MAAM,CAAC,SAAqB;QAC1B,MAAM,IAAI,GAAG,SAAoC,CAAC;QAClD,OAAO,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC,KAAK,EAAE,GAAW,EAAE,EAAE;YAChE,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC;YACxB,OAAO,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;QACrD,CAAC,CAAC,CAAC;IACL,CAAC;CACF;AAvBD,wCAuBC"}
+{"version":3,"file":"template.js","sourceRoot":"","sources":["../src/template.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hazeljs/prompts",
-  "version": "0.2.4",
+  "version": "0.3.1",
   "description": "Typed, overridable prompt templates for HazelJS AI, RAG, and Agent packages",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -70,5 +70,5 @@
       }
     }
   },
-  "gitHead": "e0c2d21ace726f2a0bf20c5baefad02e1e681ba9"
+  "gitHead": "db6df492988e5d7b03253a98977c71c7a4540e1c"
 }