baml-sap-ts 0.1.0

package/dist/schema-renderer.js

@@ -0,0 +1,329 @@
+"use strict";
+/**
+ * Schema Renderer - Converts TypeBox schemas to LLM prompt instructions
+ *
+ * This is the TypeScript equivalent of BAML's render_output_format.rs
+ * It generates schema instructions that guide the LLM to output correctly
+ * structured data.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.renderSchema = renderSchema;
+exports.createPromptWithSchema = createPromptWithSchema;
+exports.createJsonSchemaPrompt = createJsonSchemaPrompt;
+const typebox_1 = require("@sinclair/typebox");
+const defaultOptions = {
+    includeDescriptions: true,
+    indent: 2,
+    maxDepth: 50,
+    allowPartials: false,
+};
+/**
+ * Render a TypeBox schema as prompt instructions
+ */
+function renderSchema(schema, options = {}) {
+    const opts = { ...defaultOptions, ...options };
+    const visited = new WeakSet();
+    try {
+        const rendered = renderSchemaInternal(schema, opts, 0, visited);
+        return formatOutput(rendered, schema, opts);
+    }
+    finally {
+        // Cleanup visited set
+        visited.delete(schema);
+    }
+}
+/**
+ * Main schema rendering function
+ */
+function renderSchemaInternal(schema, options, depth, visited) {
+    // Circular reference / max depth check
+    if (depth > options.maxDepth || visited.has(schema)) {
+        return "<recursive>";
+    }
+    // Mark as visited for this render pass
+    visited.add(schema);
+    try {
+        // Handle schema references
+        if (schema.$ref) {
+            return `<reference to: ${schema.$ref}>`;
+        }
+        // Handle different schema kinds
+        switch (schema[typebox_1.Kind]) {
+            case "Object":
+                return renderObject(schema, options, depth, visited);
+            case "Array":
+                return renderArray(schema, options, depth, visited);
+            case "Union":
+                return renderUnion(schema, options, depth, visited);
+            case "Intersect":
+                return renderIntersect(schema, options, depth, visited);
+            case "Optional":
+                return renderOptional(schema, options, depth, visited);
+            case "Literal":
+                return renderLiteral(schema);
+            case "Enum":
+                return renderEnum(schema);
+            case "String":
+                return renderString(schema);
+            case "Number":
+            case "Integer":
+                return renderNumber(schema);
+            case "Boolean":
+                return renderBoolean(schema);
+            case "Null":
+                return "null";
+            case "Any":
+            case "Unknown":
+                return "any";
+            case "Record":
+                return renderRecord(schema, options, depth, visited);
+            case "Tuple":
+                return renderTuple(schema, options, depth, visited);
+            case "Ref":
+                return renderRef(schema);
+            default:
+                // Handle primitive types that might not have Kind set
+                if (schema.type) {
+                    return renderJsonSchemaType(schema, options, depth, visited);
+                }
+                return "<unknown type>";
+        }
+    }
+    finally {
+        visited.delete(schema);
+    }
+}
+function renderObject(schema, options, depth, visited) {
+    const properties = schema.properties;
+    if (!properties || Object.keys(properties).length === 0) {
+        return "{}";
+    }
+    const indent = " ".repeat(options.indent * (depth + 1));
+    const closeIndent = " ".repeat(options.indent * depth);
+    const fields = Object.entries(properties).map(([key, propSchema]) => {
+        const isOptional = isOptionalProperty(propSchema);
+        const typeStr = renderSchemaInternal(propSchema, options, depth + 1, visited);
+        const description = options.includeDescriptions && propSchema.description
+            ? ` // ${propSchema.description}`
+            : "";
+        return `${indent}"${key}": ${typeStr}${isOptional ? " (optional)" : ""}${description}`;
+    });
+    return `{\n${fields.join(",\n")}${closeIndent}\n${closeIndent}}`;
+}
+function renderArray(schema, options, depth, visited) {
+    const items = schema.items;
+    if (!items) {
+        return "any[]";
+    }
+    const itemStr = renderSchemaInternal(items, options, depth, visited);
+    return `${itemStr}[]`;
+}
+function renderUnion(schema, options, depth, visited) {
+    const anyOf = schema.anyOf;
+    if (!anyOf || anyOf.length === 0) {
+        return "any";
+    }
+    const variants = anyOf.map((s) => renderSchemaInternal(s, options, depth, visited));
+    if (variants.length === 1) {
+        return variants[0];
+    }
+    // For simple unions, use oneOf format
+    if (variants.every((v) => !v.includes("\n"))) {
+        return variants.join(" | ");
+    }
+    // For complex unions, use structured format
+    const indent = " ".repeat(options.indent * (depth + 1));
+    return `one of:\n${variants.map((v, i) => `${indent}${i + 1}. ${v}`).join("\n")}`;
+}
+function renderIntersect(schema, options, depth, visited) {
+    const allOf = schema.allOf;
+    if (!allOf || allOf.length === 0) {
+        return "{}";
+    }
+    // Merge all object schemas
+    const merged = {};
+    for (const subSchema of allOf) {
+        if (subSchema[typebox_1.Kind] === "Object") {
+            const props = subSchema.properties;
+            Object.assign(merged, props);
+        }
+    }
+    // Create a merged object schema
+    const mergedSchema = {
+        [typebox_1.Kind]: "Object",
+        type: "object",
+        properties: merged,
+    };
+    return renderObject(mergedSchema, options, depth, visited);
+}
+function renderOptional(schema, options, depth, visited) {
+    const inner = schema.item;
+    if (!inner) {
+        return "any?";
+    }
+    return renderSchemaInternal(inner, options, depth, visited);
+}
+function renderLiteral(schema) {
+    const value = schema.const;
+    if (typeof value === "string") {
+        return `"${value}"`;
+    }
+    return String(value);
+}
+function renderEnum(schema) {
+    const values = schema.enum;
+    if (!values || values.length === 0) {
+        return "<empty enum>";
+    }
+    return values.map((v) => (typeof v === "string" ? `"${v}"` : String(v))).join(" | ");
+}
+function renderString(schema) {
+    const constraints = [];
+    if (schema.minLength !== undefined) {
+        constraints.push(`min ${schema.minLength} chars`);
+    }
+    if (schema.maxLength !== undefined) {
+        constraints.push(`max ${schema.maxLength} chars`);
+    }
+    if (schema.pattern) {
+        constraints.push(`matches /${schema.pattern}/`);
+    }
+    if (schema.format) {
+        constraints.push(`format: ${schema.format}`);
+    }
+    if (constraints.length > 0) {
+        return `string (${constraints.join(", ")})`;
+    }
+    return "string";
+}
+function renderNumber(schema) {
+    const isInt = schema[typebox_1.Kind] === "Integer" || schema.type === "integer";
+    const typeName = isInt ? "integer" : "number";
+    const constraints = [];
+    if (schema.minimum !== undefined) {
+        constraints.push(`>= ${schema.minimum}`);
+    }
+    if (schema.maximum !== undefined) {
+        constraints.push(`<= ${schema.maximum}`);
+    }
+    if (schema.exclusiveMinimum !== undefined) {
+        constraints.push(`> ${schema.exclusiveMinimum}`);
+    }
+    if (schema.exclusiveMaximum !== undefined) {
+        constraints.push(`< ${schema.exclusiveMaximum}`);
+    }
+    if (schema.multipleOf !== undefined) {
+        constraints.push(`multiple of ${schema.multipleOf}`);
+    }
+    if (constraints.length > 0) {
+        return `${typeName} (${constraints.join(", ")})`;
+    }
+    return typeName;
+}
+function renderBoolean(_schema) {
+    return "boolean";
+}
+function renderRecord(schema, options, depth, visited) {
+    const pattern = schema.patternProperties;
+    const additional = schema.additionalProperties;
+    let valueType;
+    if (pattern && Object.keys(pattern).length > 0) {
+        const keyPattern = Object.keys(pattern)[0];
+        valueType = renderSchemaInternal(pattern[keyPattern], options, depth, visited);
+    }
+    else if (additional) {
+        valueType = renderSchemaInternal(additional, options, depth, visited);
+    }
+    else {
+        valueType = "any";
+    }
+    return `Record<string, ${valueType}>`;
+}
+function renderTuple(schema, options, depth, visited) {
+    const items = schema.items;
+    if (!items || items.length === 0) {
+        return "[]";
+    }
+    const rendered = items.map((item) => renderSchemaInternal(item, options, depth, visited));
+    return `[${rendered.join(", ")}]`;
+}
+function renderRef(schema) {
+    const ref = schema.$ref;
+    return ref ? `<${ref}>` : "<reference>";
+}
+function renderJsonSchemaType(schema, options, depth, visited) {
+    const type = schema.type;
+    switch (type) {
+        case "string":
+            return renderString(schema);
+        case "number":
+            return renderNumber(schema);
+        case "integer":
+            return renderNumber(schema);
+        case "boolean":
+            return "boolean";
+        case "null":
+            return "null";
+        case "array":
+            if (schema.items) {
+                const itemStr = renderSchemaInternal(schema.items, options, depth, visited);
+                return `${itemStr}[]`;
+            }
+            return "any[]";
+        case "object":
+            if (schema.properties) {
+                return renderObject(schema, options, depth, visited);
+            }
+            return "{}";
+        default:
+            return String(type) || "any";
+    }
+}
+function isOptionalProperty(schema) {
+    // Check if it's an optional type
+    if (schema[typebox_1.Kind] === "Optional") {
+        return true;
+    }
+    // Check for nullable
+    if (schema.anyOf) {
+        const variants = schema.anyOf;
+        return variants.some((v) => v[typebox_1.Kind] === "Null" || v.type === "null");
+    }
+    return false;
+}
+/**
+ * Format the final output with schema instructions
+ */
+function formatOutput(rendered, _schema, options) {
+    const lines = [];
+    lines.push("Respond with a JSON object in the following format:");
+    lines.push("");
+    lines.push("```json");
+    lines.push(rendered);
+    lines.push("```");
+    if (options.allowPartials) {
+        lines.push("");
+        lines.push("Note: If streaming, partial JSON is acceptable.");
+    }
+    return lines.join("\n");
+}
+/**
+ * Create a prompt with schema instructions appended
+ */
+function createPromptWithSchema(basePrompt, schema, options) {
+    const schemaInstructions = renderSchema(schema, options);
+    return `${basePrompt.trim()}\n\n${schemaInstructions}`;
+}
+/**
+ * Create a compact JSON schema representation for the prompt
+ * This is an alternative to the human-readable format above
+ */
+function createJsonSchemaPrompt(basePrompt, schema, _options = {}) {
+    const jsonSchema = JSON.stringify(schema, null, 2);
+    let prompt = `${basePrompt.trim()}\n\nRespond with a JSON object matching this schema:\n\n`;
+    prompt += "```json\n";
+    prompt += jsonSchema;
+    prompt += "\n```";
+    return prompt;
+}
+//# sourceMappingURL=schema-renderer.js.map

package/dist/schema-renderer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-renderer.js","sourceRoot":"","sources":["../src/schema-renderer.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;AA0CH,oCAWC;AAuWD,wDAIC;AAMD,wDAaC;AAjbD,+CAiB2B;AAa3B,MAAM,cAAc,GAAwB;IAC3C,mBAAmB,EAAE,IAAI;IACzB,MAAM,EAAE,CAAC;IACT,QAAQ,EAAE,EAAE;IACZ,aAAa,EAAE,KAAK;CACpB,CAAC;AAEF;;GAEG;AACH,SAAgB,YAAY,CAAC,MAAe,EAAE,UAA+B,EAAE;IAC9E,MAAM,IAAI,GAAG,EAAE,GAAG,cAAc,EAAE,GAAG,OAAO,EAAE,CAAC;IAC/C,MAAM,OAAO,GAAG,IAAI,OAAO,EAAW,CAAC;IAEvC,IAAI,CAAC;QACJ,MAAM,QAAQ,GAAG,oBAAoB,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,CAAC,CAAC;QAChE,OAAO,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;IAC7C,CAAC;YAAS,CAAC;QACV,sBAAsB;QACtB,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACxB,CAAC;AACF,CAAC;AAED;;GAEG;AACH,SAAS,oBAAoB,CAC5B,MAAe,EACf,OAA4B,EAC5B,KAAa,EACb,OAAyB;IAEzB,uCAAuC;IACvC,IAAI,KAAK,GAAG,OAAO,CAAC,QAAS,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;QACtD,OAAO,aAAa,CAAC;IACtB,CAAC;IAED,uCAAuC;IACvC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAEpB,IAAI,CAAC;QACJ,2BAA2B;QAC3B,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;YACjB,OAAO,kBAAkB,MAAM,CAAC,IAAI,GAAG,CAAC;QACzC,CAAC;QAED,gCAAgC;QAChC,QAAQ,MAAM,CAAC,cAAI,CAAC,EAAE,CAAC;YACtB,KAAK,QAAQ;gBACZ,OAAO,YAAY,CAAC,MAAiB,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;YAEjE,KAAK,OAAO;gBACX,OAAO,WAAW,CAAC,MAAgB,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;YAE/D,KAAK,OAAO;gBACX,OAAO,WAAW,CAAC,MAAgB,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;YAE/D,KAAK,WAAW;gBACf,OAAO,eAAe,CAAC,MAAiB,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;YAEpE,KAAK,UAAU;gBACd,OAAO,cAAc,CAAC,MAA4B,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;YAE9E,KAAK,SAAS;gBACb,OAAO,aAAa,CAAC,MAAkB,CAAC,CAAC;YAE1C,KAAK,MAAM;gBACV,OAAO,UAAU,CAAC,MAAe,CAAC,CAAC;YAEpC,KAAK,QAAQ;gBACZ,OAAO,YAAY,CAAC,MAAiB,CAAC,CAAC;YAExC,KAAK,QAAQ,CAAC;YACd,KAAK,SAAS;gBACb,OAAO,YAAY,CAAC,MAA4B,CAAC,CAAC;YAEnD,KAAK,SAAS;gBACb,OAAO,aAAa,CAAC,MAAkB,CAAC,CAAC;YAE1C,KAAK,MAAM;gBACV,OAAO,MAAM,CAAC;YAEf,KAAK,KAAK,CAAC;YACX,KAAK,SAAS;gBACb,OAAO,KAAK,CAAC;YAEd,KAAK,QAAQ;gBACZ,OAAO,YAAY,CAAC,MAAiB,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;YAEjE,KAAK,OAAO;gBACX,OAAO,WAAW,CAAC,MAAgB,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;YAE/D,KAAK,KAAK;gBACT,OAAO,SAAS,CAAC,MAAc,CAAC,CAAC;YAElC;gBACC,sDAAsD;gBACtD,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;oBACjB,OAAO,oBAAoB,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;gBAC9D,CAAC;gBACD,OAAO,gBAAgB,CAAC;QAC1B,CAAC;IACF,CAAC;YAAS,CAAC;QACV,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACxB,CAAC;AACF,CAAC;AAED,SAAS,YAAY,CAAC,MAAe,EAAE,OAA4B,EAAE,KAAa,EAAE,OAAyB;IAC5G,MAAM,UAAU,GAAG,MAAM,CAAC,UAAyB,CAAC;IACpD,IAAI,CAAC,UAAU,IAAI,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzD,OAAO,IAAI,CAAC;IACb,CAAC;IAED,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,MAAO,GAAG,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC;IACzD,MAAM,WAAW,GAAG,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,MAAO,GAAG,KAAK,CAAC,CAAC;IAExD,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,UAAU,CAAC,EAAE,EAAE;QACnE,MAAM,UAAU,GAAG,kBAAkB,CAAC,UAAU,CAAC,CAAC;QAClD,MAAM,OAAO,GAAG,oBAAoB,CAAC,UAAU,EAAE,OAAO,EAAE,KAAK,GAAG,CAAC,EAAE,OAAO,CAAC,CAAC;QAC9E,MAAM,WAAW,GAChB,OAAO,CAAC,mBAAmB,IAAK,UAAsB,CAAC,WAAW;YACjE,CAAC,CAAC,OAAQ,UAAsB,CAAC,WAAW,EAAE;YAC9C,CAAC,CAAC,EAAE,CAAC;QAEP,OAAO,GAAG,MAAM,IAAI,GAAG,MAAM,OAAO,GAAG,UAAU,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,GAAG,WAAW,EAAE,CAAC;IACxF,CAAC,CAAC,CAAC;IAEH,OAAO,MAAM,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,WAAW,KAAK,WAAW,GAAG,CAAC;AAClE,CAAC;AAED,SAAS,WAAW,CAAC,MAAc,EAAE,OAA4B,EAAE,KAAa,EAAE,OAAyB;IAC1G,MAAM,KAAK,GAAG,MAAM,CAAC,KAAgB,CAAC;IACtC,IAAI,CAAC,KAAK,EAAE,CAAC;QACZ,OAAO,OAAO,CAAC;IAChB,CAAC;IAED,MAAM,OAAO,GAAG,oBAAoB,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;IACrE,OAAO,GAAG,OAAO,IAAI,CAAC;AACvB,CAAC;AAED,SAAS,WAAW,CAAC,MAAc,EAAE,OAA4B,EAAE,KAAa,EAAE,OAAyB;IAC1G,MAAM,KAAK,GAAG,MAAM,CAAC,KAAkB,CAAC;IACxC,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAClC,OAAO,KAAK,CAAC;IACd,CAAC;IAED,MAAM,QAAQ,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,oBAAoB,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC;IAEpF,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3B,OAAO,QAAQ,CAAC,CAAC,CAAC,CAAC;IACpB,CAAC;IAED,sCAAsC;IACtC,IAAI,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;QAC9C,OAAO,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC7B,CAAC;IAED,4CAA4C;IAC5C,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,MAAO,GAAG,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC;IACzD,OAAO,YAAY,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,MAAM,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;AACnF,CAAC;AAED,SAAS,eAAe,CACvB,MAAe,EACf,OAA4B,EAC5B,KAAa,EACb,OAAyB;IAEzB,MAAM,KAAK,GAAI,MAAc,CAAC,KAAkB,CAAC;IACjD,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAClC,OAAO,IAAI,CAAC;IACb,CAAC;IAED,2BAA2B;IAC3B,MAAM,MAAM,GAA4B,EAAE,CAAC;IAC3C,KAAK,MAAM,SAAS,IAAI,KAAK,EAAE,CAAC;QAC/B,IAAI,SAAS,CAAC,cAAI,CAAC,KAAK,QAAQ,EAAE,CAAC;YAClC,MAAM,KAAK,GAAI,SAAqB,CAAC,UAAyB,CAAC;YAC/D,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QAC9B,CAAC;IACF,CAAC;IAED,gCAAgC;IAChC,MAAM,YAAY,GAAY;QAC7B,CAAC,cAAI,CAAC,EAAE,QAAQ;QAChB,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE,MAAM;KACP,CAAC;IAEb,OAAO,YAAY,CAAC,YAAY,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;AAC5D,CAAC;AAED,SAAS,cAAc,CACtB,MAA0B,EAC1B,OAA4B,EAC5B,KAAa,EACb,OAAyB;IAEzB,MAAM,KAAK,GAAI,MAAc,CAAC,IAAe,CAAC;IAC9C,IAAI,CAAC,KAAK,EAAE,CAAC;QACZ,OAAO,MAAM,CAAC;IACf,CAAC;IACD,OAAO,oBAAoB,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;AAC7D,CAAC;AAED,SAAS,aAAa,CAAC,MAAgB;IACtC,MAAM,KAAK,GAAI,MAAc,CAAC,KAAK,CAAC;IACpC,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC/B,OAAO,IAAI,KAAK,GAAG,CAAC;IACrB,CAAC;IACD,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;AACtB,CAAC;AAED,SAAS,UAAU,CAAC,MAAa;IAChC,MAAM,MAAM,GAAI,MAAc,CAAC,IAA2B,CAAC;IAC3D,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACpC,OAAO,cAAc,CAAC;IACvB,CAAC;IAED,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AACtF,CAAC;AAED,SAAS,YAAY,CAAC,MAAe;IACpC,MAAM,WAAW,GAAa,EAAE,CAAC;IAEjC,IAAI,MAAM,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;QACpC,WAAW,CAAC,IAAI,CAAC,OAAO,MAAM,CAAC,SAAS,QAAQ,CAAC,CAAC;IACnD,CAAC;IACD,IAAI,MAAM,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;QACpC,WAAW,CAAC,IAAI,CAAC,OAAO,MAAM,CAAC,SAAS,QAAQ,CAAC,CAAC;IACnD,CAAC;IACD,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,WAAW,CAAC,IAAI,CAAC,YAAY,MAAM,CAAC,OAAO,GAAG,CAAC,CAAC;IACjD,CAAC;IACD,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;QACnB,WAAW,CAAC,IAAI,CAAC,WAAW,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;IAC9C,CAAC;IAED,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5B,OAAO,WAAW,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC;IAC7C,CAAC;IACD,OAAO,QAAQ,CAAC;AACjB,CAAC;AAED,SAAS,YAAY,CAAC,MAA0B;IAC/C,MAAM,KAAK,GAAG,MAAM,CAAC,cAAI,CAAC,KAAK,SAAS,IAAK,MAA8B,CAAC,IAAI,KAAK,SAAS,CAAC;IAC/F,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC;IAC9C,MAAM,WAAW,GAAa,EAAE,CAAC;IAEjC,IAAI,MAAM,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;QAClC,WAAW,CAAC,IAAI,CAAC,MAAM,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;IAC1C,CAAC;IACD,IAAI,MAAM,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;QAClC,WAAW,CAAC,IAAI,CAAC,MAAM,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;IAC1C,CAAC;IACD,IAAI,MAAM,CAAC,gBAAgB,KAAK,SAAS,EAAE,CAAC;QAC3C,WAAW,CAAC,IAAI,CAAC,KAAK,MAAM,CAAC,gBAAgB,EAAE,CAAC,CAAC;IAClD,CAAC;IACD,IAAI,MAAM,CAAC,gBAAgB,KAAK,SAAS,EAAE,CAAC;QAC3C,WAAW,CAAC,IAAI,CAAC,KAAK,MAAM,CAAC,gBAAgB,EAAE,CAAC,CAAC;IAClD,CAAC;IACD,IAAK,MAAmB,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;QACnD,WAAW,CAAC,IAAI,CAAC,eAAgB,MAAmB,CAAC,UAAU,EAAE,CAAC,CAAC;IACpE,CAAC;IAED,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5B,OAAO,GAAG,QAAQ,KAAK,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC;IAClD,CAAC;IACD,OAAO,QAAQ,CAAC;AACjB,CAAC;AAED,SAAS,aAAa,CAAC,OAAiB;IACvC,OAAO,SAAS,CAAC;AAClB,CAAC;AAED,SAAS,YAAY,CAAC,MAAe,EAAE,OAA4B,EAAE,KAAa,EAAE,OAAyB;IAC5G,MAAM,OAAO,GAAI,MAAc,CAAC,iBAA4C,CAAC;IAC7E,MAAM,UAAU,GAAI,MAAc,CAAC,oBAA+B,CAAC;IAEnE,IAAI,SAAiB,CAAC;IACtB,IAAI,OAAO,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAChD,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;QAC3C,SAAS,GAAG,oBAAoB,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;IAChF,CAAC;SAAM,IAAI,UAAU,EAAE,CAAC;QACvB,SAAS,GAAG,oBAAoB,CAAC,UAAU,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;IACvE,CAAC;SAAM,CAAC;QACP,SAAS,GAAG,KAAK,CAAC;IACnB,CAAC;IAED,OAAO,kBAAkB,SAAS,GAAG,CAAC;AACvC,CAAC;AAED,SAAS,WAAW,CAAC,MAAc,EAAE,OAA4B,EAAE,KAAa,EAAE,OAAyB;IAC1G,MAAM,KAAK,GAAG,MAAM,CAAC,KAAkB,CAAC;IACxC,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAClC,OAAO,IAAI,CAAC;IACb,CAAC;IAED,MAAM,QAAQ,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,oBAAoB,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC;IAC1F,OAAO,IAAI,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC;AACnC,CAAC;AAED,SAAS,SAAS,CAAC,MAAY;IAC9B,MAAM,GAAG,GAAI,MAAc,CAAC,IAAc,CAAC;IAC3C,OAAO,GAAG,CAAC,CAAC,CAAC,IAAI,GAAG,GAAG,CAAC,CAAC,CAAC,aAAa,CAAC;AACzC,CAAC;AAED,SAAS,oBAAoB,CAC5B,MAAW,EACX,OAA4B,EAC5B,KAAa,EACb,OAAyB;IAEzB,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;IAEzB,QAAQ,IAAI,EAAE,CAAC;QACd,KAAK,QAAQ;YACZ,OAAO,YAAY,CAAC,MAAiB,CAAC,CAAC;QACxC,KAAK,QAAQ;YACZ,OAAO,YAAY,CAAC,MAAiB,CAAC,CAAC;QACxC,KAAK,SAAS;YACb,OAAO,YAAY,CAAC,MAAkB,CAAC,CAAC;QACzC,KAAK,SAAS;YACb,OAAO,SAAS,CAAC;QAClB,KAAK,MAAM;YACV,OAAO,MAAM,CAAC;QACf,KAAK,OAAO;YACX,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;gBAClB,MAAM,OAAO,GAAG,oBAAoB,CAAC,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;gBAC5E,OAAO,GAAG,OAAO,IAAI,CAAC;YACvB,CAAC;YACD,OAAO,OAAO,CAAC;QAChB,KAAK,QAAQ;YACZ,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;gBACvB,OAAO,YAAY,CAAC,MAAiB,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;YACjE,CAAC;YACD,OAAO,IAAI,CAAC;QACb;YACC,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC;IAC/B,CAAC;AACF,CAAC;AAED,SAAS,kBAAkB,CAAC,MAAe;IAC1C,iCAAiC;IACjC,IAAI,MAAM,CAAC,cAAI,CAAC,KAAK,UAAU,EAAE,CAAC;QACjC,OAAO,IAAI,CAAC;IACb,CAAC;IAED,qBAAqB;IACrB,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;QAClB,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAkB,CAAC;QAC3C,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,cAAI,CAAC,KAAK,MAAM,IAAI,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC;IACtE,CAAC;IAED,OAAO,KAAK,CAAC;AACd,CAAC;AAED;;GAEG;AACH,SAAS,YAAY,CAAC,QAAgB,EAAE,OAAgB,EAAE,OAA4B;IACrF,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,KAAK,CAAC,IAAI,CAAC,qDAAqD,CAAC,CAAC;IAClE,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACtB,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACrB,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAElB,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;QAC3B,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,iDAAiD,CAAC,CAAC;IAC/D,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACzB,CAAC;AAED;;GAEG;AACH,SAAgB,sBAAsB,CAAC,UAAkB,EAAE,MAAe,EAAE,OAA6B;IACxG,MAAM,kBAAkB,GAAG,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEzD,OAAO,GAAG,UAAU,CAAC,IAAI,EAAE,OAAO,kBAAkB,EAAE,CAAC;AACxD,CAAC;AAED;;;GAGG;AACH,SAAgB,sBAAsB,CACrC,UAAkB,EAClB,MAAe,EACf,WAA0C,EAAE;IAE5C,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IAEnD,IAAI,MAAM,GAAG,GAAG,UAAU,CAAC,IAAI,EAAE,0DAA0D,CAAC;IAC5F,MAAM,IAAI,WAAW,CAAC;IACtB,MAAM,IAAI,UAAU,CAAC;IACrB,MAAM,IAAI,OAAO,CAAC;IAElB,OAAO,MAAM,CAAC;AACf,CAAC"}

package/dist/type-coercer.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Type Coercer - Validates and coerces parsed data to TypeBox schemas
+ *
+ * This module takes extracted JSON and validates/coerces it against
+ * TypeBox schemas, handling:
+ * - Union type matching
+ * - Optional fields
+ * - Default values
+ * - Type conversions
+ * - Array/object coercion
+ *
+ * Based on BAML's deserializer/coercer
+ */
+import { type Static, type TSchema } from "@sinclair/typebox";
+export interface CoercionOptions {
+    /** Allow partial objects (for streaming) */
+    allowPartials?: boolean;
+    /** Use default values for missing fields */
+    useDefaults?: boolean;
+    /** Strict mode - no type coercion */
+    strict?: boolean;
+    /** Maximum depth for coercion */
+    maxDepth?: number;
+    /** Track applied coercions */
+    trackCoercions?: boolean;
+}
+/**
+ * Result of type coercion
+ */
+export interface CoercionResult<T = unknown> {
+    /** The coerced value */
+    value: T;
+    /** Whether the coercion was successful */
+    success: boolean;
+    /** Errors encountered during coercion */
+    errors: CoercionError[];
+    /** Coercions that were applied */
+    coercions?: string[];
+    /** Whether this is a partial result */
+    isPartial?: boolean;
+}
+export interface CoercionError {
+    path: string;
+    message: string;
+    expected?: string;
+    received?: string;
+}
+/**
+ * Coerce a value to match a TypeBox schema
+ */
+export declare function coerceValue<T extends TSchema>(value: unknown, schema: T, options?: CoercionOptions, path?: string): CoercionResult<Static<T>>;
+/**
+ * Validate a value against a schema without coercion
+ */
+export declare function validateValue<T extends TSchema>(value: unknown, schema: T): {
+    valid: boolean;
+    errors: CoercionError[];
+};
+//# sourceMappingURL=type-coercer.d.ts.map

package/dist/type-coercer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"type-coercer.d.ts","sourceRoot":"","sources":["../src/type-coercer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAEN,KAAK,MAAM,EAUX,KAAK,OAAO,EAKZ,MAAM,mBAAmB,CAAC;AAG3B,MAAM,WAAW,eAAe;IAC/B,4CAA4C;IAC5C,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,4CAA4C;IAC5C,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,qCAAqC;IACrC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,iCAAiC;IACjC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,8BAA8B;IAC9B,cAAc,CAAC,EAAE,OAAO,CAAC;CACzB;AAUD;;GAEG;AACH,MAAM,WAAW,cAAc,CAAC,CAAC,GAAG,OAAO;IAC1C,wBAAwB;IACxB,KAAK,EAAE,CAAC,CAAC;IACT,0CAA0C;IAC1C,OAAO,EAAE,OAAO,CAAC;IACjB,yCAAyC;IACzC,MAAM,EAAE,aAAa,EAAE,CAAC;IACxB,kCAAkC;IAClC,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,uCAAuC;IACvC,SAAS,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,aAAa;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,CAAC,SAAS,OAAO,EAC5C,KAAK,EAAE,OAAO,EACd,MAAM,EAAE,CAAC,EACT,OAAO,GAAE,eAAoB,EAC7B,IAAI,GAAE,MAAW,GACf,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CA6B3B;AA+uBD;;GAEG;AACH,wBAAgB,aAAa,CAAC,CAAC,SAAS,OAAO,EAC9C,KAAK,EAAE,OAAO,EACd,MAAM,EAAE,CAAC,GACP;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,aAAa,EAAE,CAAA;CAAE,CAiB7C"}