structured-outputs 0.1.0-beta.2 → 0.1.0-beta.20

package/esm/deps/jsr.io/@std/internal/1.0.5/styles.js

@@ -0,0 +1,208 @@
+// Copyright 2018-2024 the Deno authors. All rights reserved. MIT license.
+// This module is browser compatible.
+// A module to print ANSI terminal colors. Inspired by chalk, kleur, and colors
+// on npm.
+// This code is vendored from `fmt/colors.ts`.
+// deno-lint-ignore no-explicit-any
+import * as dntShim from "../../../../../_dnt.shims.js";
+const { Deno } = dntShim.dntGlobalThis;
+const noColor = typeof Deno?.noColor === "boolean"
+    ? Deno.noColor
+    : false;
+const enabled = !noColor;
+function code(open, close) {
+    return {
+        open: `\x1b[${open.join(";")}m`,
+        close: `\x1b[${close}m`,
+        regexp: new RegExp(`\\x1b\\[${close}m`, "g"),
+    };
+}
+function run(str, code) {
+    return enabled
+        ? `${code.open}${str.replace(code.regexp, code.open)}${code.close}`
+        : str;
+}
+/**
+ * Sets the style of text to be printed to bold.
+ *
+ * Disable by setting the `NO_COLOR` environmental variable.
+ *
+ * @param str Text to make bold
+ *
+ * @returns Bold text for printing
+ *
+ * @example Usage
+ * ```ts no-assert
+ * import { bold } from "@std/internal/styles";
+ *
+ * console.log(bold("Hello, world!")); // Prints "Hello, world!" in bold
+ * ```
+ */
+export function bold(str) {
+    return run(str, code([1], 22));
+}
+/**
+ * Sets the color of text to be printed to red.
+ *
+ * Disable by setting the `NO_COLOR` environmental variable.
+ *
+ * @param str Text to make red
+ *
+ * @returns Red text for printing
+ *
+ * @example Usage
+ * ```ts no-assert
+ * import { red } from "@std/internal/styles";
+ *
+ * console.log(red("Hello, world!")); // Prints "Hello, world!" in red
+ * ```
+ */
+export function red(str) {
+    return run(str, code([31], 39));
+}
+/**
+ * Sets the color of text to be printed to green.
+ *
+ * Disable by setting the `NO_COLOR` environmental variable.
+ *
+ * @param str Text to make green
+ *
+ * @returns Green text for print
+ *
+ * @example Usage
+ * ```ts no-assert
+ * import { green } from "@std/internal/styles";
+ *
+ * console.log(green("Hello, world!")); // Prints "Hello, world!" in green
+ * ```
+ */
+export function green(str) {
+    return run(str, code([32], 39));
+}
+/**
+ * Sets the color of text to be printed to yellow.
+ *
+ * Disable by setting the `NO_COLOR` environmental variable.
+ *
+ * @param str Text to make yellow
+ *
+ * @returns Yellow text for print
+ *
+ * @example Usage
+ * ```ts no-assert
+ * import { yellow } from "@std/internal/styles";
+ *
+ * console.log(yellow("Hello, world!")); // Prints "Hello, world!" in yellow
+ * ```
+ */
+export function yellow(str) {
+    return run(str, code([33], 39));
+}
+/**
+ * Sets the color of text to be printed to white.
+ *
+ * @param str Text to make white
+ *
+ * @returns White text for print
+ *
+ * @example Usage
+ * ```ts no-assert
+ * import { white } from "@std/internal/styles";
+ *
+ * console.log(white("Hello, world!")); // Prints "Hello, world!" in white
+ * ```
+ */
+export function white(str) {
+    return run(str, code([37], 39));
+}
+/**
+ * Sets the color of text to be printed to gray.
+ *
+ * @param str Text to make gray
+ *
+ * @returns Gray text for print
+ *
+ * @example Usage
+ * ```ts no-assert
+ * import { gray } from "@std/internal/styles";
+ *
+ * console.log(gray("Hello, world!")); // Prints "Hello, world!" in gray
+ * ```
+ */
+export function gray(str) {
+    return brightBlack(str);
+}
+/**
+ * Sets the color of text to be printed to bright-black.
+ *
+ * @param str Text to make bright-black
+ *
+ * @returns Bright-black text for print
+ *
+ * @example Usage
+ * ```ts no-assert
+ * import { brightBlack } from "@std/internal/styles";
+ *
+ * console.log(brightBlack("Hello, world!")); // Prints "Hello, world!" in bright-black
+ * ```
+ */
+export function brightBlack(str) {
+    return run(str, code([90], 39));
+}
+/**
+ * Sets the background color of text to be printed to red.
+ *
+ * @param str Text to make its background red
+ *
+ * @returns Red background text for print
+ *
+ * @example Usage
+ * ```ts no-assert
+ * import { bgRed } from "@std/internal/styles";
+ *
+ * console.log(bgRed("Hello, world!")); // Prints "Hello, world!" with red background
+ * ```
+ */
+export function bgRed(str) {
+    return run(str, code([41], 49));
+}
+/**
+ * Sets the background color of text to be printed to green.
+ *
+ * @param str Text to make its background green
+ *
+ * @returns Green background text for print
+ *
+ * @example Usage
+ * ```ts no-assert
+ * import { bgGreen } from "@std/internal/styles";
+ *
+ * console.log(bgGreen("Hello, world!")); // Prints "Hello, world!" with green background
+ * ```
+ */
+export function bgGreen(str) {
+    return run(str, code([42], 49));
+}
+// https://github.com/chalk/ansi-regex/blob/02fa893d619d3da85411acc8fd4e2eea0e95a9d9/index.js
+const ANSI_PATTERN = new RegExp([
+    "[\\u001B\\u009B][[\\]()#;?]*(?:(?:(?:(?:;[-a-zA-Z\\d\\/#&.:=?%@~_]+)*|[a-zA-Z\\d]+(?:;[-a-zA-Z\\d\\/#&.:=?%@~_]*)*)?\\u0007)",
+    "(?:(?:\\d{1,4}(?:;\\d{0,4})*)?[\\dA-PR-TXZcf-nq-uy=><~]))",
+].join("|"), "g");
+/**
+ * Remove ANSI escape codes from the string.
+ *
+ * @param string Text to remove ANSI escape codes from
+ *
+ * @returns Text without ANSI escape codes
+ *
+ * @example Usage
+ * ```ts no-assert
+ * import { red, stripAnsiCode } from "@std/internal/styles";
+ *
+ * console.log(stripAnsiCode(red("Hello, world!"))); // Prints "Hello, world!"
+ * ```
+ */
+export function stripAnsiCode(string) {
+    return string.replace(ANSI_PATTERN, "");
+}
+//# sourceMappingURL=styles.js.map

package/esm/deps/jsr.io/@std/internal/1.0.5/styles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"styles.js","sourceRoot":"","sources":["../../../../../../src/deps/jsr.io/@std/internal/1.0.5/styles.ts"],"names":[],"mappings":"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"}

package/esm/deps/jsr.io/@std/internal/1.0.5/types.js

@@ -0,0 +1,3 @@
+// Copyright 2018-2024 the Deno authors. All rights reserved. MIT license.
+export {};
+//# sourceMappingURL=types.js.map

package/esm/deps/jsr.io/@std/internal/1.0.5/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../../src/deps/jsr.io/@std/internal/1.0.5/types.ts"],"names":[],"mappings":"AAAA,0EAA0E"}

package/esm/mod.js

@@ -1,12 +1,5 @@
-// moderate --exclude _base.ts code_critique.ts
-export * from "./array.js";
-export * from "./common.js";
-export * from "./F.js";
-export * from "./literal.js";
-export * from "./number.js";
-export * from "./object.js";
+import "./_dnt.polyfills.js";
+export * as T from "./types/mod.js";
 export * from "./ResponseFormat.js";
-export * from "./schema.js";
-export * from "./string.js";
-export * from "./union.js";
+export * from "./Tool.js";
 //# sourceMappingURL=mod.js.map

package/esm/mod.js.map

@@ -1 +1 @@
-{"version":3,"file":"mod.js","sourceRoot":"","sources":["../src/mod.ts"],"names":[],"mappings":"AAOA,+CAA+C;AAE/C,cAAc,YAAY,CAAA;AAC1B,cAAc,aAAa,CAAA;AAC3B,cAAc,QAAQ,CAAA;AACtB,cAAc,cAAc,CAAA;AAC5B,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA;AAC3B,cAAc,qBAAqB,CAAA;AACnC,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA;AAC3B,cAAc,YAAY,CAAA"}
+{"version":3,"file":"mod.js","sourceRoot":"","sources":["../src/mod.ts"],"names":[],"mappings":"AAAA,OAAO,qBAAqB,CAAC;AAC7B,OAAO,KAAK,CAAC,MAAM,gBAAgB,CAAA;AACnC,cAAc,qBAAqB,CAAA;AACnC,cAAc,WAAW,CAAA"}

package/esm/types/Ref.js

@@ -0,0 +1,11 @@
+import { recombineTaggedTemplateArgs } from "../util/recombineTaggedTemplateArgs.js";
+export function Ref(applied) {
+    return (ty) => {
+        applied = { ...applied, ...ty.applied };
+        const description = ty.descriptions
+            .map(({ template, placeheld }) => recombineTaggedTemplateArgs(template, placeheld.map((k) => applied[k])))
+            .join(" ");
+        return ty.toSchema(description, Ref(applied));
+    };
+}
+//# sourceMappingURL=Ref.js.map

package/esm/types/Ref.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Ref.js","sourceRoot":"","sources":["../../src/types/Ref.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,2BAA2B,EAAE,MAAM,wCAAwC,CAAA;AAIpF,MAAM,UAAU,GAAG,CAAC,OAAgB;IAClC,OAAO,CAAC,EAAE,EAAE,EAAE;QACZ,OAAO,GAAG,EAAE,GAAG,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,EAAE,CAAA;QACvC,MAAM,WAAW,GAAG,EAAE,CAAC,YAAY;aAChC,GAAG,CAAC,CAAC,EAAE,QAAQ,EAAE,SAAS,EAAE,EAAE,EAAE,CAC/B,2BAA2B,CAAC,QAAQ,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,CAAE,CAAC,CAAC,CACzE;aACA,IAAI,CAAC,GAAG,CAAC,CAAA;QACZ,OAAO,EAAE,CAAC,QAAQ,CAAC,WAAW,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC,CAAA;IAC/C,CAAC,CAAA;AACH,CAAC"}

package/esm/types/RootTy.js

@@ -0,0 +1,19 @@
+import { phantoms } from "../util/phantoms.js";
+import { Ref } from "./Ref.js";
+export function RootTy(toSchema, descriptions = [], applied = {}) {
+    return Object.assign((template, ...placeheld) => RootTy(toSchema, [{ template, placeheld }, ...descriptions], applied), phantoms(), {
+        toSchema,
+        descriptions,
+        applied,
+        apply: (values) => {
+            return RootTy(toSchema, descriptions, { ...applied, ...values });
+        },
+        schema() {
+            return Ref({})(this);
+        },
+        isRoot() {
+            return true;
+        },
+    });
+}
+//# sourceMappingURL=RootTy.js.map

package/esm/types/RootTy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RootTy.js","sourceRoot":"","sources":["../../src/types/RootTy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAA;AAC9C,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAA;AAG9B,MAAM,UAAU,MAAM,CACpB,QAAkB,EAClB,eAAmC,EAAE,EACrC,UAAmB,EAAE;IAErB,OAAO,MAAM,CAAC,MAAM,CAClB,CAA2B,QAA8B,EAAE,GAAG,SAAa,EAAE,EAAE,CAC7E,MAAM,CAAoB,QAAQ,EAAE,CAAC,EAAE,QAAQ,EAAE,SAAS,EAAE,EAAE,GAAG,YAAY,CAAC,EAAE,OAAO,CAAC,EAC1F,QAAQ,EAA4B,EACpC;QACE,QAAQ;QACR,YAAY;QACZ,OAAO;QACP,KAAK,EAAE,CAAgD,MAAS,EAAE,EAAE;YAClE,OAAO,MAAM,CAAyB,QAAQ,EAAE,YAAY,EAAE,EAAE,GAAG,OAAO,EAAE,GAAG,MAAM,EAAE,CAAC,CAAA;QAC1F,CAAC;QACD,MAAM;YACJ,OAAO,GAAG,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,CAAA;QACtB,CAAC;QACD,MAAM;YACJ,OAAO,IAAI,CAAA;QACb,CAAC;KACF,CACF,CAAA;AACH,CAAC"}

package/esm/types/Ty.js

@@ -0,0 +1,17 @@
+import { phantoms } from "../util/phantoms.js";
+export function Ty(toSchema, descriptions = [], applied = {}) {
+    return Object.assign((template, ...placeheld) => Ty(toSchema, [{ template, placeheld }, ...descriptions], applied), phantoms(), {
+        toSchema,
+        descriptions,
+        applied,
+        apply: (values) => {
+            return Ty(toSchema, descriptions, { ...applied, ...values });
+        },
+        isRoot() {
+            return false;
+        },
+    });
+}
+(function (Ty) {
+})(Ty || (Ty = {}));
+//# sourceMappingURL=Ty.js.map

package/esm/types/Ty.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Ty.js","sourceRoot":"","sources":["../../src/types/Ty.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAA;AAG9C,MAAM,UAAU,EAAE,CAChB,QAAkB,EAClB,eAAmC,EAAE,EACrC,UAAmB,EAAE;IAErB,OAAO,MAAM,CAAC,MAAM,CAClB,CAA2B,QAA8B,EAAE,GAAG,SAAa,EAAE,EAAE,CAC7E,EAAE,CAAoB,QAAQ,EAAE,CAAC,EAAE,QAAQ,EAAE,SAAS,EAAE,EAAE,GAAG,YAAY,CAAC,EAAE,OAAO,CAAC,EACtF,QAAQ,EAA4B,EACpC;QACE,QAAQ;QACR,YAAY;QACZ,OAAO;QACP,KAAK,EAAE,CAAgD,MAAS,EAAE,EAAE;YAClE,OAAO,EAAE,CAAyB,QAAQ,EAAE,YAAY,EAAE,EAAE,GAAG,OAAO,EAAE,GAAG,MAAM,EAAE,CAAC,CAAA;QACtF,CAAC;QACD,MAAM;YACJ,OAAO,KAAK,CAAA;QACd,CAAC;KACF,CACF,CAAA;AACH,CAAC;AAgBD,WAAiB,EAAE;AAKnB,CAAC,EALgB,EAAE,KAAF,EAAE,QAKlB"}

package/esm/types/array.js

@@ -0,0 +1,9 @@
+import { Ty } from "./Ty.js";
+export function array(element) {
+    return Ty((description, ref) => ({
+        type: "array",
+        description,
+        items: ref(element),
+    }));
+}
+//# sourceMappingURL=array.js.map

package/esm/types/array.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"array.js","sourceRoot":"","sources":["../../src/types/array.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,SAAS,CAAA;AAE5B,MAAM,UAAU,KAAK,CAAe,OAAU;IAC5C,OAAO,EAAE,CAAC,CAAC,WAAW,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC;QAC/B,IAAI,EAAE,OAAO;QACb,WAAW;QACX,KAAK,EAAE,GAAG,CAAC,OAAO,CAAC;KACpB,CAAC,CAAC,CAAA;AACL,CAAC"}

package/esm/types/constant.js

@@ -0,0 +1,8 @@
+import { Ty } from "./Ty.js";
+export function constant(value) {
+    return Ty((description) => ({
+        const: value,
+        description,
+    }));
+}
+//# sourceMappingURL=constant.js.map

package/esm/types/constant.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constant.js","sourceRoot":"","sources":["../../src/types/constant.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,SAAS,CAAA;AAE5B,MAAM,UAAU,QAAQ,CAA4B,KAAQ;IAC1D,OAAO,EAAE,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;QAC1B,KAAK,EAAE,KAAK;QACZ,WAAW;KACZ,CAAC,CAAC,CAAA;AACL,CAAC"}

package/esm/types/constantUnion.js

@@ -0,0 +1,25 @@
+import { partition } from "../deps/jsr.io/@std/collections/1.0.9/mod.js";
+import { Ty } from "./Ty.js";
+export function constantUnion(...members) {
+    const [strings, numbers] = partition(members, (v) => typeof v === "string");
+    return Ty((description) => {
+        return {
+            anyOf: [
+                ...strings.length
+                    ? [{
+                            type: "string",
+                            enum: strings,
+                        }]
+                    : [],
+                ...numbers.length
+                    ? [{
+                            type: "number",
+                            enum: numbers,
+                        }]
+                    : [],
+            ],
+            description,
+        };
+    });
+}
+//# sourceMappingURL=constantUnion.js.map

package/esm/types/constantUnion.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constantUnion.js","sourceRoot":"","sources":["../../src/types/constantUnion.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,8CAA8C,CAAA;AACxE,OAAO,EAAE,EAAE,EAAE,MAAM,SAAS,CAAA;AAE5B,MAAM,UAAU,aAAa,CAC3B,GAAG,OAAU;IAEb,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC,OAAO,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAA;IAC3E,OAAO,EAAE,CAAC,CAAC,WAAW,EAAE,EAAE;QACxB,OAAO;YACL,KAAK,EAAE;gBACL,GAAG,OAAO,CAAC,MAAM;oBACf,CAAC,CAAC,CAAC;4BACD,IAAI,EAAE,QAAQ;4BACd,IAAI,EAAE,OAAO;yBACd,CAAC;oBACF,CAAC,CAAC,EAAE;gBACN,GAAG,OAAO,CAAC,MAAM;oBACf,CAAC,CAAC,CAAC;4BACD,IAAI,EAAE,QAAQ;4BACd,IAAI,EAAE,OAAO;yBACd,CAAC;oBACF,CAAC,CAAC,EAAE;aACP;YACD,WAAW;SACZ,CAAA;IACH,CAAC,CAAC,CAAA;AACJ,CAAC"}

package/esm/types/leaves.js

@@ -0,0 +1,18 @@
+import { Ty } from "./Ty.js";
+export const none = Ty((description) => ({
+    type: "null",
+    description,
+}));
+export const boolean = Ty((description) => ({
+    type: "boolean",
+    description,
+}));
+export const number = Ty((description) => ({
+    type: "number",
+    description,
+}));
+export const string = Ty((description) => ({
+    type: "string",
+    description,
+}));
+//# sourceMappingURL=leaves.js.map

package/esm/types/leaves.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"leaves.js","sourceRoot":"","sources":["../../src/types/leaves.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,SAAS,CAAA;AAE5B,MAAM,CAAC,MAAM,IAAI,GAAoB,EAAE,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;IACxD,IAAI,EAAE,MAAM;IACZ,WAAW;CACZ,CAAC,CAAC,CAAA;AAEH,MAAM,CAAC,MAAM,OAAO,GAAuB,EAAE,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;IAC9D,IAAI,EAAE,SAAS;IACf,WAAW;CACZ,CAAC,CAAC,CAAA;AAEH,MAAM,CAAC,MAAM,MAAM,GAAsB,EAAE,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;IAC5D,IAAI,EAAE,QAAQ;IACd,WAAW;CACZ,CAAC,CAAC,CAAA;AAEH,MAAM,CAAC,MAAM,MAAM,GAAsB,EAAE,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;IAC5D,IAAI,EAAE,QAAQ;IACd,WAAW;CACZ,CAAC,CAAC,CAAA"}

package/esm/types/mod.js

@@ -0,0 +1,11 @@
+export * from "./array.js";
+export * from "./leaves.js";
+export * from "./constant.js";
+export * from "./constantUnion.js";
+export * from "./std/mod.js";
+export * from "./object.js";
+export * from "./Ref.js";
+export * from "./taggedUnion.js";
+export * from "./Ty.js";
+export * from "./RootTy.js";
+//# sourceMappingURL=mod.js.map

package/esm/types/mod.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mod.js","sourceRoot":"","sources":["../../src/types/mod.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAA;AAC1B,cAAc,aAAa,CAAA;AAC3B,cAAc,eAAe,CAAA;AAC7B,cAAc,oBAAoB,CAAA;AAClC,cAAc,cAAc,CAAA;AAC5B,cAAc,aAAa,CAAA;AAC3B,cAAc,UAAU,CAAA;AACxB,cAAc,kBAAkB,CAAA;AAChC,cAAc,SAAS,CAAA;AACvB,cAAc,aAAa,CAAA"}

package/esm/{object.js → types/object.js}

@@ -1,9 +1,9 @@
-import { make } from "./_base.js";
-export function object(description, fields) {
-    return make((ctx) => ({
+import { RootTy } from "./RootTy.js";
+export function object(fields) {
+    return RootTy((description, ref) => ({
         type: "object",
         description,
-        properties: Object.fromEntries(Object.entries(fields).map(([k, v]) => [k, ctx.ref(v)])),
+        properties: Object.fromEntries(Object.entries(fields).map(([k, v]) => [k, ref(v)])),
         additionalProperties: false,
         required: Object.keys(fields),
     }));

package/esm/types/object.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"object.js","sourceRoot":"","sources":["../../src/types/object.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAGpC,MAAM,UAAU,MAAM,CAA+B,MAAS;IAI5D,OAAO,MAAM,CAAC,CAAC,WAAW,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC;QACnC,IAAI,EAAE,QAAQ;QACd,WAAW;QACX,UAAU,EAAE,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACnF,oBAAoB,EAAE,KAAK;QAC3B,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC;KAC9B,CAAC,CAAC,CAAA;AACL,CAAC"}

package/esm/types/std/Option.js

@@ -0,0 +1,9 @@
+import { none } from "../leaves.js";
+import { taggedUnion } from "../taggedUnion.js";
+export function option(Some) {
+    return taggedUnion({
+        Some,
+        None: none,
+    }) `An option of specified \`some\` type.`;
+}
+//# sourceMappingURL=Option.js.map

package/esm/types/std/Option.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Option.js","sourceRoot":"","sources":["../../../src/types/std/Option.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,cAAc,CAAA;AACnC,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAG/C,MAAM,UAAU,MAAM,CAAe,IAAO;IAM1C,OAAO,WAAW,CAAC;QACjB,IAAI;QACJ,IAAI,EAAE,IAAI;KACX,CAAC,CAAA,uCAAuC,CAAA;AAC3C,CAAC"}

package/esm/types/std/Wrapper.js

@@ -0,0 +1,5 @@
+import { object } from "../object.js";
+export function Wrapper(value) {
+    return object({ value });
+}
+//# sourceMappingURL=Wrapper.js.map

package/esm/types/std/Wrapper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Wrapper.js","sourceRoot":"","sources":["../../../src/types/std/Wrapper.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AAIrC,MAAM,UAAU,OAAO,CAAe,KAAQ;IAC5C,OAAO,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,CAAA;AAC1B,CAAC"}

package/esm/types/std/mod.js

@@ -0,0 +1,3 @@
+export * from "./Option.js";
+export * from "./Wrapper.js";
+//# sourceMappingURL=mod.js.map

package/esm/types/std/mod.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mod.js","sourceRoot":"","sources":["../../../src/types/std/mod.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAA;AAC3B,cAAc,cAAc,CAAA"}

package/esm/types/taggedUnion.js

@@ -0,0 +1,20 @@
+import { Ty } from "./Ty.js";
+export function taggedUnion(members) {
+    return Ty((description, ref) => ({
+        description,
+        discriminator: "type",
+        anyOf: Object.entries(members).map(([k, v]) => ({
+            type: "object",
+            properties: {
+                type: {
+                    type: "string",
+                    const: k,
+                },
+                value: ref(v),
+            },
+            required: ["type", "value"],
+            additionalProperties: false,
+        })),
+    }));
+}
+//# sourceMappingURL=taggedUnion.js.map

package/esm/types/taggedUnion.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"taggedUnion.js","sourceRoot":"","sources":["../../src/types/taggedUnion.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,SAAS,CAAA;AAE5B,MAAM,UAAU,WAAW,CAA+B,OAAU;IASlE,OAAO,EAAE,CAAC,CAAC,WAAW,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC;QAC/B,WAAW;QACX,aAAa,EAAE,MAAM;QACrB,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC9C,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,IAAI,EAAE;oBACJ,IAAI,EAAE,QAAQ;oBACd,KAAK,EAAE,CAAC;iBACT;gBACD,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC;aACd;YACD,QAAQ,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC;YAC3B,oBAAoB,EAAE,KAAK;SAC5B,CAAC,CAAC;KACJ,CAAC,CAAC,CAAA;AACL,CAAC"}

package/esm/util/phantoms.js

@@ -0,0 +1,4 @@
+export function phantoms() {
+    return {};
+}
+//# sourceMappingURL=phantoms.js.map

package/esm/util/phantoms.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"phantoms.js","sourceRoot":"","sources":["../../src/util/phantoms.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,QAAQ;IACtB,OAAO,EAAO,CAAA;AAChB,CAAC"}

package/esm/util/recombineTaggedTemplateArgs.js

@@ -0,0 +1,4 @@
+export function recombineTaggedTemplateArgs(strings, values) {
+    return strings.reduce((acc, cur, i) => `${acc}${cur}${values[i] ?? ""}`, "");
+}
+//# sourceMappingURL=recombineTaggedTemplateArgs.js.map

package/esm/util/recombineTaggedTemplateArgs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recombineTaggedTemplateArgs.js","sourceRoot":"","sources":["../../src/util/recombineTaggedTemplateArgs.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,2BAA2B,CACzC,OAA6B,EAC7B,MAA8B;IAE9B,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,GAAG,GAAG,GAAG,MAAM,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,EAAE,EAAE,CAAC,CAAA;AAC9E,CAAC"}

package/package.json

@@ -1,20 +1,23 @@
 {
   "name": "structured-outputs",
-  "version": "0.1.0-beta.2",
-  "description": "Lightweight virtual types for OpenAI structured outputs.",
+  "version": "0.1.0-beta.20",
+  "description": "Compose OpenAI structured output schemas.",
   "repository": "github:harrysolovay/structured-outputs.git",
   "license": "Apache-2.0",
+  "main": "./esm/mod.js",
   "module": "./esm/mod.js",
+  "types": "./types/mod.d.ts",
   "exports": {
     ".": {
-      "import": "./esm/mod.js"
+      "import": {
+        "types": "./types/mod.d.ts",
+        "default": "./esm/mod.js"
+      }
     }
   },
   "dependencies": {
-    "tslib": "^2.6.2"
-  },
-  "devDependencies": {
-    "@types/node": "^20.9.0"
+    "tslib": "^2.6.2",
+    "openai": "^4.68.1"
   },
   "_generatedBy": "dnt@dev"
 }

package/src/ResponseFormat.ts

@@ -1,31 +1,82 @@
-import type { Ty } from "./_base.js"
-import type { ValidRootKey } from "./common.js"
-import { schema } from "./schema.js"
+import { assert } from "./deps/jsr.io/@std/assert/1.0.8/mod.js"
+import type Openai from "openai"
+import type { ResponseFormatJSONSchema } from "openai/resources/index.js"
+import type { RootTy } from "./types/mod.js"
+import { recombineTaggedTemplateArgs } from "./util/recombineTaggedTemplateArgs.js"
 
-export type ResponseFormat = {
-  type: "json_schema"
-  /** The desired return type in JSON Schema. */
-  json_schema: {
-    name: string
-    description: string
-    schema: Record<string, unknown>
-    strict: true
-  }
+export function ResponseFormat<T>(name: string, ty: RootTy<T, never>): ResponseFormat<T> {
+  return ResponseFormat_(name, ty)
 }
 
-export function ResponseFormat<M extends Record<string, Ty>>(
+function ResponseFormat_<T>(
   name: string,
-  description: string,
-  models: M,
-  rootKey: ValidRootKey<M>,
-): ResponseFormat {
-  return {
-    type: "json_schema",
-    json_schema: {
-      name,
-      description,
-      schema: schema(models, rootKey),
-      strict: true,
+  ty: RootTy<T, never>,
+  description?: string,
+): ResponseFormat<T> {
+  return Object.assign(
+    (template: TemplateStringsArray, ...quasis: Array<string>) =>
+      ResponseFormat_(
+        name,
+        ty,
+        description ? `${description} ${recombineTaggedTemplateArgs(template, quasis)}` : undefined,
+      ),
+    {
+      type: "json_schema" as const,
+      json_schema: {
+        name,
+        description,
+        schema: ty.schema(),
+        strict: true,
+      },
+      parse(completion: ChatCompletion): TypedChatCompletion<T> {
+        return {
+          ...completion,
+          choices: completion.choices.map((choice) => ({
+            ...choice,
+            message: {
+              ...choice.message,
+              content: choice.message.content ? JSON.parse(choice.message.content) : null,
+            },
+          })),
+        }
+      },
+      parseFirstOrThrow(completion: ChatCompletion): T {
+        const { choices: [firstChoice], usage } = completion
+        assert(firstChoice)
+        const { finish_reason, message } = firstChoice
+        const { content, refusal } = message
+        assert(content, JSON.stringify({ finish_reason, refusal, usage }))
+        return JSON.parse(content)
+      },
+      toJSON() {
+        const { type, json_schema } = this
+        return { type, json_schema }
+      },
     },
-  }
+  )
 }
+
+export interface ResponseFormat<T> {
+  (template: TemplateStringsArray, ...quasis: Array<string>): ResponseFormat<T>
+  type: "json_schema"
+  /** The desired return type in JSON Schema. */
+  json_schema: ResponseFormatJSONSchema.JSONSchema
+  /** Parse inner responses into a typed object. */
+  parse(completion: ChatCompletion): TypedChatCompletion<T>
+  /** Parse and return the first inner response into a typed object. */
+  parseFirstOrThrow(completion: ChatCompletion): T
+}
+
+export type TypedChatCompletion<T> = Omit<ChatCompletion, "choices"> & {
+  choices: Array<
+    Omit<ChatCompletionChoice, "message"> & {
+      message: Omit<ChatCompletionMessage, "content"> & {
+        content: T
+      }
+    }
+  >
+}
+
+type ChatCompletion = Openai.Chat.ChatCompletion
+type ChatCompletionChoice = Openai.Chat.ChatCompletion.Choice
+type ChatCompletionMessage = Openai.Chat.Completions.ChatCompletionMessage