@fastpaca/cria 0.0.1 → 1.0.1

package/dist/render.test.js

@@ -1,49 +1,167 @@
 import { jsx as _jsx, jsxs as _jsxs } from "@fastpaca/cria/jsx-runtime";
-import assert from "node:assert/strict";
-import { test } from "node:test";
+import { expect, test } from "vitest";
 import { Omit, Region, render, Truncate } from "./index";
 // Simple tokenizer: 1 token per 4 characters (approximates real tokenizers)
 const tokenizer = (text) => Math.ceil(text.length / 4);
 const FIT_ERROR_PATTERN = /Cannot fit prompt/;
-test("render: basic text output", () => {
+test("render: basic text output", async () => {
     const element = _jsx(Region, { priority: 0, children: "Hello, world!" });
-    const result = render(element, { tokenizer, budget: 100 });
-    assert.strictEqual(result, "Hello, world!");
+    const result = await render(element, { tokenizer, budget: 100 });
+    expect(result).toBe("Hello, world!");
 });
-test("render: nested regions", () => {
+test("render: nested regions", async () => {
     const element = (_jsxs(Region, { priority: 0, children: ["Start ", _jsx(Region, { priority: 1, children: "Middle" }), " End"] }));
-    const result = render(element, { tokenizer, budget: 100 });
-    assert.strictEqual(result, "Start Middle End");
+    const result = await render(element, { tokenizer, budget: 100 });
+    expect(result).toBe("Start Middle End");
 });
-test("render: omit removes region when over budget", () => {
+test("render: omit removes region when over budget", async () => {
     const element = (_jsxs(Region, { priority: 0, children: ["Important", " ", _jsx(Omit, { priority: 1, children: "Less important content that should be removed" }), "Also important"] }));
-    const resultLarge = render(element, { tokenizer, budget: 100 });
-    assert.ok(resultLarge.includes("Less important"));
-    const resultSmall = render(element, { tokenizer, budget: 10 });
-    assert.ok(!resultSmall.includes("Less important"));
-    assert.ok(resultSmall.includes("Important"));
+    const resultLarge = await render(element, { tokenizer, budget: 100 });
+    expect(resultLarge).toContain("Less important");
+    const resultSmall = await render(element, { tokenizer, budget: 10 });
+    expect(resultSmall).not.toContain("Less important");
+    expect(resultSmall).toContain("Important");
 });
-test("render: truncate reduces content", () => {
+test("render: truncate reduces content", async () => {
     const longContent = "A".repeat(100);
     const element = (_jsxs(Region, { priority: 0, children: ["Header", " ", _jsx(Truncate, { budget: 5, priority: 1, children: longContent })] }));
-    const result = render(element, { tokenizer, budget: 10 });
-    assert.ok(result.length < 100);
-    assert.ok(result.includes("Header"));
+    const result = await render(element, { tokenizer, budget: 10 });
+    expect(result.length).toBeLessThan(100);
+    expect(result).toContain("Header");
 });
-test("render: priority ordering - lower priority removed first", () => {
+test("render: priority ordering - lower priority removed first", async () => {
     const element = (_jsxs(Region, { priority: 0, children: [_jsx(Region, { priority: 0, children: "Critical" }), _jsx(Omit, { priority: 1, children: "Medium importance" }), _jsx(Omit, { priority: 2, children: "Low importance" })] }));
-    const result = render(element, { tokenizer, budget: 5 });
-    assert.ok(result.includes("Critical"));
-    assert.ok(!result.includes("Medium"));
-    assert.ok(!result.includes("Low"));
+    const result = await render(element, { tokenizer, budget: 5 });
+    expect(result).toContain("Critical");
+    expect(result).not.toContain("Medium");
+    expect(result).not.toContain("Low");
 });
-test("render: throws FitError when cannot fit", () => {
+test("render: throws FitError when cannot fit", async () => {
     const element = (_jsx(Region, { priority: 0, children: "This content has no strategy and cannot be reduced" }));
-    assert.throws(() => render(element, { tokenizer, budget: 1 }), FIT_ERROR_PATTERN);
+    await expect(render(element, { tokenizer, budget: 1 })).rejects.toThrow(FIT_ERROR_PATTERN);
 });
-test("render: multiple strategies at same priority applied together", () => {
+test("render: multiple strategies at same priority applied together", async () => {
     const element = (_jsxs(Region, { priority: 0, children: [_jsx(Omit, { id: "a", priority: 1, children: "AAA" }), _jsx(Omit, { id: "b", priority: 1, children: "BBB" })] }));
-    const result = render(element, { tokenizer, budget: 0 });
-    assert.strictEqual(result, "");
+    const result = await render(element, { tokenizer, budget: 0 });
+    expect(result).toBe("");
+});
+test("render: hooks fire in expected order", async () => {
+    const calls = [];
+    const element = (_jsxs(Region, { priority: 0, children: ["A", _jsx(Omit, { priority: 1, children: "BBBB" })] }));
+    const result = await render(element, {
+        tokenizer,
+        budget: 1,
+        hooks: {
+            onFitStart: () => {
+                calls.push("start");
+            },
+            onFitIteration: () => {
+                calls.push("iteration");
+            },
+            onStrategyApplied: () => {
+                calls.push("strategy");
+            },
+            onFitComplete: () => {
+                calls.push("complete");
+            },
+        },
+    });
+    expect(result).toBe("A");
+    expect(calls).toEqual(["start", "iteration", "strategy", "complete"]);
+});
+test("render: onFitError fires before FitError throws", async () => {
+    const element = _jsx(Region, { priority: 0, children: "Too long" });
+    let errorEvent = null;
+    await expect(render(element, {
+        tokenizer,
+        budget: 1,
+        hooks: {
+            onFitError: (event) => {
+                errorEvent = event;
+            },
+        },
+    })).rejects.toThrow(FIT_ERROR_PATTERN);
+    expect(errorEvent).not.toBeNull();
+    expect(errorEvent?.priority).toBe(-1);
+});
+test("render: hook errors bubble (sync error)", async () => {
+    const element = (_jsxs(Region, { priority: 0, children: ["A", _jsx(Omit, { priority: 1, children: "BBBB" })] }));
+    await expect(render(element, {
+        tokenizer,
+        budget: 1,
+        hooks: {
+            onFitStart: () => {
+                throw new Error("Hook error");
+            },
+        },
+    })).rejects.toThrow("Hook error");
+});
+test("render: hook errors bubble (async error)", async () => {
+    const element = (_jsxs(Region, { priority: 0, children: ["A", _jsx(Omit, { priority: 1, children: "BBBB" })] }));
+    await expect(render(element, {
+        tokenizer,
+        budget: 1,
+        hooks: {
+            onFitComplete: async () => {
+                await Promise.resolve();
+                throw new Error("Async hook error");
+            },
+        },
+    })).rejects.toThrow("Async hook error");
+});
+test("render: onFitError hook errors bubble", async () => {
+    const element = _jsx(Region, { priority: 0, children: "Too long" });
+    await expect(render(element, {
+        tokenizer,
+        budget: 1,
+        hooks: {
+            onFitError: () => {
+                throw new Error("Error hook failed");
+            },
+        },
+    })).rejects.toThrow("Error hook failed");
+});
+test("render: fit decisions are deterministic", async () => {
+    const buildTree = () => (_jsxs(Region, { priority: 0, children: ["Head ", _jsx(Omit, { priority: 3, children: "Drop" }), _jsx(Truncate, { budget: 4, priority: 2, children: "LongTail" }), _jsx(Region, { priority: 1, children: "End" })] }));
+    const runOnce = async () => {
+        const events = [];
+        const result = await render(buildTree(), {
+            tokenizer,
+            budget: 12,
+            hooks: {
+                onFitStart: (event) => {
+                    events.push({ type: "start", totalTokens: event.totalTokens });
+                },
+                onFitIteration: (event) => {
+                    events.push({
+                        type: "iteration",
+                        iteration: event.iteration,
+                        priority: event.priority,
+                        totalTokens: event.totalTokens,
+                    });
+                },
+                onStrategyApplied: (event) => {
+                    events.push({
+                        type: "strategy",
+                        iteration: event.iteration,
+                        priority: event.priority,
+                        resultType: event.result ? "node" : "null",
+                    });
+                },
+                onFitComplete: (event) => {
+                    events.push({
+                        type: "complete",
+                        iterations: event.iterations,
+                        totalTokens: event.totalTokens,
+                    });
+                },
+            },
+        });
+        return { result, events };
+    };
+    const first = await runOnce();
+    const second = await runOnce();
+    expect(first.result).toBe(second.result);
+    expect(first.events).toEqual(second.events);
 });
 //# sourceMappingURL=render.test.js.map

package/dist/render.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"render.test.js","sourceRoot":"","sources":["../src/render.test.tsx"],"names":[],"mappings":";AAAA,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAEzD,4EAA4E;AAC5E,MAAM,SAAS,GAAG,CAAC,IAAY,EAAU,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AAEvE,MAAM,iBAAiB,GAAG,mBAAmB,CAAC;AAE9C,IAAI,CAAC,2BAA2B,EAAE,GAAG,EAAE;IACrC,MAAM,OAAO,GAAG,KAAC,MAAM,IAAC,QAAQ,EAAE,CAAC,8BAAwB,CAAC;IAC5D,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;IAC3D,MAAM,CAAC,WAAW,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;AAC9C,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,wBAAwB,EAAE,GAAG,EAAE;IAClC,MAAM,OAAO,GAAG,CACd,MAAC,MAAM,IAAC,QAAQ,EAAE,CAAC,uBACX,KAAC,MAAM,IAAC,QAAQ,EAAE,CAAC,uBAAiB,YACnC,CACV,CAAC;IACF,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;IAC3D,MAAM,CAAC,WAAW,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;AACjD,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,8CAA8C,EAAE,GAAG,EAAE;IACxD,MAAM,OAAO,GAAG,CACd,MAAC,MAAM,IAAC,QAAQ,EAAE,CAAC,0BACP,GAAG,EACb,KAAC,IAAI,IAAC,QAAQ,EAAE,CAAC,8DAAsD,sBAEhE,CACV,CAAC;IAEF,MAAM,WAAW,GAAG,MAAM,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;IAChE,MAAM,CAAC,EAAE,CAAC,WAAW,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAAC,CAAC;IAElD,MAAM,WAAW,GAAG,MAAM,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC;IAC/D,MAAM,CAAC,EAAE,CAAC,CAAC,WAAW,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAAC,CAAC;IACnD,MAAM,CAAC,EAAE,CAAC,WAAW,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC;AAC/C,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,kCAAkC,EAAE,GAAG,EAAE;IAC5C,MAAM,WAAW,GAAG,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACpC,MAAM,OAAO,GAAG,CACd,MAAC,MAAM,IAAC,QAAQ,EAAE,CAAC,uBACV,GAAG,EACV,KAAC,QAAQ,IAAC,MAAM,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,YAC7B,WAAW,GACH,IACJ,CACV,CAAC;IAEF,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC;IAC1D,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC;IAC/B,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC;AACvC,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,0DAA0D,EAAE,GAAG,EAAE;IACpE,MAAM,OAAO,GAAG,CACd,MAAC,MAAM,IAAC,QAAQ,EAAE,CAAC,aACjB,KAAC,MAAM,IAAC,QAAQ,EAAE,CAAC,yBAAmB,EACtC,KAAC,IAAI,IAAC,QAAQ,EAAE,CAAC,kCAA0B,EAC3C,KAAC,IAAI,IAAC,QAAQ,EAAE,CAAC,+BAAuB,IACjC,CACV,CAAC;IAEF,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC;IACzD,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC;IACvC,MAAM,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC;IACtC,MAAM,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;AACrC,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,yCAAyC,EAAE,GAAG,EAAE;IACnD,MAAM,OAAO,GAAG,CACd,KAAC,MAAM,IAAC,QAAQ,EAAE,CAAC,mEAEV,CACV,CAAC;IAEF,MAAM,CAAC,MAAM,CACX,GAAG,EAAE,CAAC,MAAM,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC,EAC/C,iBAAiB,CAClB,CAAC;AACJ,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,+DAA+D,EAAE,GAAG,EAAE;IACzE,MAAM,OAAO,GAAG,CACd,MAAC,MAAM,IAAC,QAAQ,EAAE,CAAC,aACjB,KAAC,IAAI,IAAC,EAAE,EAAC,GAAG,EAAC,QAAQ,EAAE,CAAC,oBAEjB,EACP,KAAC,IAAI,IAAC,EAAE,EAAC,GAAG,EAAC,QAAQ,EAAE,CAAC,oBAEjB,IACA,CACV,CAAC;IAEF,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC;IACzD,MAAM,CAAC,WAAW,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;AACjC,CAAC,CAAC,CAAC"}
+{"version":3,"file":"render.test.js","sourceRoot":"","sources":["../src/render.test.tsx"],"names":[],"mappings":"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"}

package/dist/renderers/markdown.d.ts

@@ -0,0 +1,3 @@
+import type { PromptRenderer } from "../types";
+export declare const markdownRenderer: PromptRenderer<string>;
+//# sourceMappingURL=markdown.d.ts.map

package/dist/renderers/markdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown.d.ts","sourceRoot":"","sources":["../../src/renderers/markdown.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAiC,cAAc,EAAE,MAAM,UAAU,CAAC;AAG9E,eAAO,MAAM,gBAAgB,EAAE,cAAc,CAAC,MAAM,CAKnD,CAAC"}

package/dist/renderers/markdown.js

@@ -0,0 +1,43 @@
+import { safeStringify } from "./shared";
+export const markdownRenderer = {
+    name: "markdown",
+    tokenString: (element) => renderToMarkdown(element),
+    render: (element) => renderToMarkdown(element),
+    empty: () => "",
+};
+const ROLE_LABELS = {
+    system: "System",
+    user: "User",
+    assistant: "Assistant",
+};
+function renderToMarkdown(element) {
+    switch (element.kind) {
+        case "message": {
+            const content = renderChildrenToMarkdown(element.children).trimEnd();
+            const label = ROLE_LABELS[element.role] ?? element.role;
+            return `${label}: ${content}\n\n`;
+        }
+        case "reasoning": {
+            return `<thinking>\n${element.text}\n</thinking>\n`;
+        }
+        case "tool-call": {
+            const inputText = safeStringify(element.input, true);
+            return `<tool_call name="${element.toolName}">\n${inputText}\n</tool_call>\n`;
+        }
+        case "tool-result": {
+            const outputText = safeStringify(element.output, true);
+            return `<tool_result name="${element.toolName}">\n${outputText}\n</tool_result>\n`;
+        }
+        default: {
+            return renderChildrenToMarkdown(element.children);
+        }
+    }
+}
+function renderChildrenToMarkdown(children) {
+    let result = "";
+    for (const child of children) {
+        result += typeof child === "string" ? child : renderToMarkdown(child);
+    }
+    return result;
+}
+//# sourceMappingURL=markdown.js.map

package/dist/renderers/markdown.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown.js","sourceRoot":"","sources":["../../src/renderers/markdown.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,MAAM,CAAC,MAAM,gBAAgB,GAA2B;IACtD,IAAI,EAAE,UAAU;IAChB,WAAW,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,gBAAgB,CAAC,OAAO,CAAC;IACnD,MAAM,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,gBAAgB,CAAC,OAAO,CAAC;IAC9C,KAAK,EAAE,GAAG,EAAE,CAAC,EAAE;CAChB,CAAC;AAEF,MAAM,WAAW,GAA2B;IAC1C,MAAM,EAAE,QAAQ;IAChB,IAAI,EAAE,MAAM;IACZ,SAAS,EAAE,WAAW;CACvB,CAAC;AAEF,SAAS,gBAAgB,CAAC,OAAsB;IAC9C,QAAQ,OAAO,CAAC,IAAI,EAAE,CAAC;QACrB,KAAK,SAAS,CAAC,CAAC,CAAC;YACf,MAAM,OAAO,GAAG,wBAAwB,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,OAAO,EAAE,CAAC;YACrE,MAAM,KAAK,GAAG,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC;YACxD,OAAO,GAAG,KAAK,KAAK,OAAO,MAAM,CAAC;QACpC,CAAC;QACD,KAAK,WAAW,CAAC,CAAC,CAAC;YACjB,OAAO,eAAe,OAAO,CAAC,IAAI,iBAAiB,CAAC;QACtD,CAAC;QACD,KAAK,WAAW,CAAC,CAAC,CAAC;YACjB,MAAM,SAAS,GAAG,aAAa,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;YACrD,OAAO,oBAAoB,OAAO,CAAC,QAAQ,OAAO,SAAS,kBAAkB,CAAC;QAChF,CAAC;QACD,KAAK,aAAa,CAAC,CAAC,CAAC;YACnB,MAAM,UAAU,GAAG,aAAa,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;YACvD,OAAO,sBAAsB,OAAO,CAAC,QAAQ,OAAO,UAAU,oBAAoB,CAAC;QACrF,CAAC;QACD,OAAO,CAAC,CAAC,CAAC;YACR,OAAO,wBAAwB,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QACpD,CAAC;IACH,CAAC;AACH,CAAC;AAED,SAAS,wBAAwB,CAAC,QAAwB;IACxD,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,KAAK,MAAM,KAAK,IAAI,QAAQ,EAAE,CAAC;QAC7B,MAAM,IAAI,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC;IACxE,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/renderers/shared.d.ts

@@ -0,0 +1,82 @@
+import type { PromptChildren, PromptElement } from "../types";
+/**
+ * Semantic representation of prompt content parts.
+ * Used by renderers to convert prompt trees into provider-specific formats.
+ */
+export type SemanticPart = {
+    type: "text";
+    text: string;
+} | {
+    type: "reasoning";
+    text: string;
+} | {
+    type: "tool-call";
+    toolCallId: string;
+    toolName: string;
+    input: unknown;
+} | {
+    type: "tool-result";
+    toolCallId: string;
+    toolName: string;
+    output: unknown;
+};
+export type ToolCallPart = Extract<SemanticPart, {
+    type: "tool-call";
+}>;
+export type ToolResultPart = Extract<SemanticPart, {
+    type: "tool-result";
+}>;
+export type TextPart = Extract<SemanticPart, {
+    type: "text";
+}>;
+export type ReasoningPart = Extract<SemanticPart, {
+    type: "reasoning";
+}>;
+export type MessageElement = Extract<PromptElement, {
+    kind: "message";
+}>;
+/**
+ * Collect all message nodes from the prompt tree.
+ */
+export declare function collectMessageNodes(element: PromptElement, acc?: MessageElement[]): MessageElement[];
+/**
+ * Extract semantic parts from prompt children.
+ */
+export declare function collectSemanticParts(children: PromptChildren): SemanticPart[];
+/**
+ * Extract semantic parts from a single prompt element.
+ */
+export declare function semanticPartsFromElement(element: PromptElement): SemanticPart[];
+/**
+ * Coalesce adjacent text parts into single parts.
+ */
+export declare function coalesceTextParts(parts: readonly SemanticPart[]): SemanticPart[];
+/**
+ * Safely stringify a value to JSON string.
+ * Returns string values directly, handles undefined, and catches JSON errors.
+ *
+ * @param value - The value to stringify
+ * @param pretty - If true, format with 2-space indentation (default: false)
+ */
+export declare function safeStringify(value: unknown, pretty?: boolean): string;
+/**
+ * Categorized parts from a semantic parts list.
+ */
+export interface CategorizedParts {
+    textParts: TextPart[];
+    toolCallParts: ToolCallPart[];
+    toolResultParts: ToolResultPart[];
+    reasoningParts: ReasoningPart[];
+}
+/**
+ * Categorize semantic parts by type for easier processing.
+ */
+export declare function categorizeParts(parts: readonly SemanticPart[]): CategorizedParts;
+/**
+ * Extract text content from semantic parts.
+ * Optionally wraps reasoning parts in thinking tags.
+ */
+export declare function partsToText(parts: readonly SemanticPart[], options?: {
+    wrapReasoning?: boolean;
+}): string;
+//# sourceMappingURL=shared.d.ts.map

package/dist/renderers/shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../src/renderers/shared.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAE9D;;;GAGG;AACH,MAAM,MAAM,YAAY,GACpB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC9B;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACnC;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,GAC3E;IACE,IAAI,EAAE,aAAa,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;CACjB,CAAC;AAEN,MAAM,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,EAAE;IAAE,IAAI,EAAE,WAAW,CAAA;CAAE,CAAC,CAAC;AACxE,MAAM,MAAM,cAAc,GAAG,OAAO,CAAC,YAAY,EAAE;IAAE,IAAI,EAAE,aAAa,CAAA;CAAE,CAAC,CAAC;AAC5E,MAAM,MAAM,QAAQ,GAAG,OAAO,CAAC,YAAY,EAAE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAC/D,MAAM,MAAM,aAAa,GAAG,OAAO,CAAC,YAAY,EAAE;IAAE,IAAI,EAAE,WAAW,CAAA;CAAE,CAAC,CAAC;AAEzE,MAAM,MAAM,cAAc,GAAG,OAAO,CAAC,aAAa,EAAE;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,CAAC,CAAC;AAEzE;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,aAAa,EACtB,GAAG,GAAE,cAAc,EAAO,GACzB,cAAc,EAAE,CAalB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,cAAc,GAAG,YAAY,EAAE,CAe7E;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,aAAa,GACrB,YAAY,EAAE,CA8BhB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,SAAS,YAAY,EAAE,GAC7B,YAAY,EAAE,CAuBhB;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,UAAQ,GAAG,MAAM,CAgBpE;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,QAAQ,EAAE,CAAC;IACtB,aAAa,EAAE,YAAY,EAAE,CAAC;IAC9B,eAAe,EAAE,cAAc,EAAE,CAAC;IAClC,cAAc,EAAE,aAAa,EAAE,CAAC;CACjC;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,SAAS,YAAY,EAAE,GAC7B,gBAAgB,CA2BlB;AAED;;;GAGG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,SAAS,YAAY,EAAE,EAC9B,OAAO,GAAE;IAAE,aAAa,CAAC,EAAE,OAAO,CAAA;CAAO,GACxC,MAAM,CAaR"}

package/dist/renderers/shared.js

@@ -0,0 +1,156 @@
+/**
+ * Collect all message nodes from the prompt tree.
+ */
+export function collectMessageNodes(element, acc = []) {
+    if (element.kind === "message") {
+        acc.push(element);
+        return acc;
+    }
+    for (const child of element.children) {
+        if (typeof child !== "string") {
+            collectMessageNodes(child, acc);
+        }
+    }
+    return acc;
+}
+/**
+ * Extract semantic parts from prompt children.
+ */
+export function collectSemanticParts(children) {
+    const parts = [];
+    for (const child of children) {
+        if (typeof child === "string") {
+            if (child.length > 0) {
+                parts.push({ type: "text", text: child });
+            }
+            continue;
+        }
+        parts.push(...semanticPartsFromElement(child));
+    }
+    return parts;
+}
+/**
+ * Extract semantic parts from a single prompt element.
+ */
+export function semanticPartsFromElement(element) {
+    switch (element.kind) {
+        case "tool-call":
+            return [
+                {
+                    type: "tool-call",
+                    toolCallId: element.toolCallId,
+                    toolName: element.toolName,
+                    input: element.input,
+                },
+            ];
+        case "tool-result":
+            return [
+                {
+                    type: "tool-result",
+                    toolCallId: element.toolCallId,
+                    toolName: element.toolName,
+                    output: element.output,
+                },
+            ];
+        case "reasoning":
+            return element.text.length === 0
+                ? []
+                : [{ type: "reasoning", text: element.text }];
+        case "message":
+            // Nested messages are ambiguous - skip
+            return [];
+        default:
+            return collectSemanticParts(element.children);
+    }
+}
+/**
+ * Coalesce adjacent text parts into single parts.
+ */
+export function coalesceTextParts(parts) {
+    const result = [];
+    let buffer = "";
+    for (const part of parts) {
+        if (part.type === "text") {
+            buffer += part.text;
+            continue;
+        }
+        if (buffer.length > 0) {
+            result.push({ type: "text", text: buffer });
+            buffer = "";
+        }
+        result.push(part);
+    }
+    if (buffer.length > 0) {
+        result.push({ type: "text", text: buffer });
+    }
+    return result;
+}
+/**
+ * Safely stringify a value to JSON string.
+ * Returns string values directly, handles undefined, and catches JSON errors.
+ *
+ * @param value - The value to stringify
+ * @param pretty - If true, format with 2-space indentation (default: false)
+ */
+export function safeStringify(value, pretty = false) {
+    if (typeof value === "string") {
+        return value;
+    }
+    if (value === undefined) {
+        return "null";
+    }
+    try {
+        return ((pretty ? JSON.stringify(value, null, 2) : JSON.stringify(value)) ??
+            "null");
+    }
+    catch {
+        return String(value);
+    }
+}
+/**
+ * Categorize semantic parts by type for easier processing.
+ */
+export function categorizeParts(parts) {
+    const textParts = [];
+    const toolCallParts = [];
+    const toolResultParts = [];
+    const reasoningParts = [];
+    for (const part of parts) {
+        switch (part.type) {
+            case "text":
+                textParts.push(part);
+                break;
+            case "tool-call":
+                toolCallParts.push(part);
+                break;
+            case "tool-result":
+                toolResultParts.push(part);
+                break;
+            case "reasoning":
+                reasoningParts.push(part);
+                break;
+            default:
+                // Exhaustive check - TypeScript will error if a case is missing
+                break;
+        }
+    }
+    return { textParts, toolCallParts, toolResultParts, reasoningParts };
+}
+/**
+ * Extract text content from semantic parts.
+ * Optionally wraps reasoning parts in thinking tags.
+ */
+export function partsToText(parts, options = {}) {
+    const { wrapReasoning = false } = options;
+    let result = "";
+    for (const part of parts) {
+        if (part.type === "text") {
+            result += part.text;
+        }
+        else if (part.type === "reasoning" && wrapReasoning) {
+            result += `<thinking>\n${part.text}\n</thinking>\n`;
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=shared.js.map

package/dist/renderers/shared.js.map

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

package/dist/snapshot.d.ts

@@ -0,0 +1,47 @@
+import type { RenderHooks } from "./render";
+import type { MaybePromise, PromptElement, PromptRenderer, Tokenizer } from "./types";
+export type SnapshotChild = string | SnapshotElement;
+export interface SnapshotElement extends Omit<PromptElement, "children" | "strategy" | "context"> {
+    children: SnapshotChild[];
+    tokens: number;
+    hash: string;
+}
+export interface Snapshot {
+    root: SnapshotElement;
+    totalTokens: number;
+    hash: string;
+}
+export interface SnapshotOptions {
+    tokenizer: Tokenizer;
+    renderer?: PromptRenderer<unknown>;
+}
+export interface SnapshotHooksOptions {
+    tokenizer: Tokenizer;
+    renderer?: PromptRenderer<unknown>;
+    onSnapshot: (snapshot: Snapshot) => MaybePromise<void>;
+}
+/**
+ * Create a deterministic snapshot of a fitted prompt tree.
+ *
+ * - Keeps the tree structure (no flattening) and mirrors PromptElement shape.
+ * - Adds per-node token counts (using renderer.tokenString) and stable hashes.
+ * - Excludes strategy/context from the snapshot; this is for observability only.
+ */
+export declare function createSnapshot(element: PromptElement, { tokenizer, renderer }: SnapshotOptions): Snapshot;
+export declare function createSnapshotHooks({ tokenizer, renderer, onSnapshot, }: SnapshotHooksOptions): RenderHooks;
+export interface DiffEntry {
+    path: readonly number[];
+    node: SnapshotChild;
+}
+export interface DiffChange {
+    path: readonly number[];
+    before: SnapshotChild;
+    after: SnapshotChild;
+}
+export interface SnapshotDiff {
+    added: DiffEntry[];
+    removed: DiffEntry[];
+    changed: DiffChange[];
+}
+export declare function diffSnapshots(before: Snapshot, after: Snapshot): SnapshotDiff;
+//# sourceMappingURL=snapshot.d.ts.map

package/dist/snapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.d.ts","sourceRoot":"","sources":["../src/snapshot.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAE5C,OAAO,KAAK,EACV,YAAY,EACZ,aAAa,EACb,cAAc,EAEd,SAAS,EACV,MAAM,SAAS,CAAC;AAEjB,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,eAAe,CAAC;AAErD,MAAM,WAAW,eACf,SAAQ,IAAI,CAAC,aAAa,EAAE,UAAU,GAAG,UAAU,GAAG,SAAS,CAAC;IAChE,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,eAAe,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,SAAS,CAAC;IACrB,QAAQ,CAAC,EAAE,cAAc,CAAC,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,SAAS,CAAC;IACrB,QAAQ,CAAC,EAAE,cAAc,CAAC,OAAO,CAAC,CAAC;IACnC,UAAU,EAAE,CAAC,QAAQ,EAAE,QAAQ,KAAK,YAAY,CAAC,IAAI,CAAC,CAAC;CACxD;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,aAAa,EACtB,EAAE,SAAS,EAAE,QAA2B,EAAE,EAAE,eAAe,GAC1D,QAAQ,CAOV;AAED,wBAAgB,mBAAmB,CAAC,EAClC,SAAS,EACT,QAAQ,EACR,UAAU,GACX,EAAE,oBAAoB,GAAG,WAAW,CAapC;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACxB,IAAI,EAAE,aAAa,CAAC;CACrB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACxB,MAAM,EAAE,aAAa,CAAC;IACtB,KAAK,EAAE,aAAa,CAAC;CACtB;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,OAAO,EAAE,SAAS,EAAE,CAAC;IACrB,OAAO,EAAE,UAAU,EAAE,CAAC;CACvB;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,GAAG,YAAY,CAQ7E"}