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

package/README.md

@@ -1,8 +1,79 @@
-# `structured-outputs`
+# Structured Outputs
 
-Refining this as I work on a story generation use case. Was annoyed by the Zod dependency and figured why not go down
-the rabbit hole.
+A TypeScript library for composing
+[OpenAI structured output schemas](https://platform.openai.com/docs/guides/structured-outputs).
 
-<!-- A **WIP** purpose-built virtual type system for modeling
-[OpenAI structured outputs](https://platform.openai.com/docs/guides/structured-outputs) without duplicate definitions
-nor codegen. -->
+## Installation
+
+### Node
+
+```sh
+npm i structured-outputs
+```
+
+### Deno
+
+```ts
+deno add jsr:@crosshatch/structured-outputs
+```
+
+## Usage
+
+### Basic Usage
+
+```ts
+import { ResponseFormat, T } from "structured-outputs"
+
+// 1. Define the shape of the desired response.
+const Character = T.object({
+  name: T.string,
+  age: T.number`Ensure between 1 and 110.`,
+})
+
+// 2. Create the response format object.
+const response_format = ResponseFormat("create_character", Character)
+
+// 3. Utilize the response format to create a chat completion.
+const response = await openai.chat.completions.create({
+  model: MODEL,
+  messages: [{ role: "system", content: [] }],
+  response_format,
+})
+
+// 4. Use `response_format.parseFirstOrThrow` to unwrap the inner data with correct types.
+const { name, age } = response_format.parseFirstOrThrow(response)
+```
+
+For more concise usage, chain off the completions promise.
+
+```ts
+const { name, age } = await openai.chat.completions
+  .create({
+    model: MODEL,
+    messages: [{ role: "system", content: [] }],
+    response_format,
+  })
+  .then(response_format.parseFirstOrThrow)
+```
+
+We can also attach a description to the response format.
+
+```diff
+- ResponseFormat("create_character", Character)
++ ResponseFormat("create_character", Character)`
++   Create a new character to be the protagonist of a children's story.
++ `
+```
+
+### Dependency Injection
+
+```ts
+const Character = T.object({
+  name: T.string`Preferably names common to those who are {"national identity"}.`,
+  age: T.number`Ensure between 1 and 110.`,
+})
+
+const AmericanCharacter = Character.apply({
+  "national identity": "american",
+})
+```

package/esm/ResponseFormat.d.ts

@@ -1,14 +1,21 @@
-import type { Ty } from "./_base.js";
-import type { ValidRootKey } from "./common.js";
-export type ResponseFormat = {
+import type { RootTy } from "./types/mod.js";
+import type { ChatCompletion, JsonSchema } from "./oai.js";
+export interface ResponseFormat<T> {
+    (template: TemplateStringsArray, ...quasis: Array<string>): ResponseFormat<T>;
     type: "json_schema";
     /** The desired return type in JSON Schema. */
-    json_schema: {
-        name: string;
-        description: string;
-        schema: Record<string, unknown>;
-        strict: true;
-    };
-};
-export declare function ResponseFormat<M extends Record<string, Ty>>(name: string, description: string, models: M, rootKey: ValidRootKey<M>): ResponseFormat;
+    json_schema: JsonSchema;
+    /** Parse the content of the first choice into a typed object. */
+    parseFirstChoice(completion: ChatCompletion): T;
+    /** Parse all choice contents into an array of typed object. */
+    parseChoices(completion: ChatCompletion): Array<T>;
+}
+export declare function ResponseFormat<T>(name: string, ty: RootTy<T, never>): ResponseFormat<T>;
+export declare namespace ResponseFormat {
+    function unwrapFirstChoice(completion: ChatCompletion): string;
+    function unwrapChoices(completions: ChatCompletion): string[];
+}
+export declare class ResponseFormatUnwrapError extends Error {
+    readonly name = "UnwrapResponseError";
+}
 //# sourceMappingURL=ResponseFormat.d.ts.map

package/esm/ResponseFormat.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ResponseFormat.d.ts","sourceRoot":"","sources":["../src/ResponseFormat.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,YAAY,CAAA;AACpC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAG/C,MAAM,MAAM,cAAc,GAAG;IAC3B,IAAI,EAAE,aAAa,CAAA;IACnB,8CAA8C;IAC9C,WAAW,EAAE;QACX,IAAI,EAAE,MAAM,CAAA;QACZ,WAAW,EAAE,MAAM,CAAA;QACnB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;QAC/B,MAAM,EAAE,IAAI,CAAA;KACb,CAAA;CACF,CAAA;AAED,wBAAgB,cAAc,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC,EACzD,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,CAAC,EACT,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,GACvB,cAAc,CAUhB"}
+{"version":3,"file":"ResponseFormat.d.ts","sourceRoot":"","sources":["../src/ResponseFormat.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAA;AAE5C,OAAO,KAAK,EAAE,cAAc,EAAwB,UAAU,EAAE,MAAM,UAAU,CAAA;AAEhF,MAAM,WAAW,cAAc,CAAC,CAAC;IAC/B,CAAC,QAAQ,EAAE,oBAAoB,EAAE,GAAG,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,GAAG,cAAc,CAAC,CAAC,CAAC,CAAA;IAC7E,IAAI,EAAE,aAAa,CAAA;IACnB,8CAA8C;IAC9C,WAAW,EAAE,UAAU,CAAA;IACvB,iEAAiE;IACjE,gBAAgB,CAAC,UAAU,EAAE,cAAc,GAAG,CAAC,CAAA;IAC/C,+DAA+D;IAC/D,YAAY,CAAC,UAAU,EAAE,cAAc,GAAG,KAAK,CAAC,CAAC,CAAC,CAAA;CACnD;AAED,wBAAgB,cAAc,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,CAAC,CAAC,EAAE,KAAK,CAAC,GAAG,cAAc,CAAC,CAAC,CAAC,CAEvF;AAoCD,yBAAiB,cAAc,CAAC;IAC9B,SAAgB,iBAAiB,CAAC,UAAU,EAAE,cAAc,GAAG,MAAM,CAMpE;IAED,SAAgB,aAAa,CAAC,WAAW,EAAE,cAAc,GAAG,MAAM,EAAE,CAEnE;CAoBF;AAED,qBAAa,yBAA0B,SAAQ,KAAK;IAClD,SAAkB,IAAI,yBAAwB;CAC/C"}

package/esm/ResponseFormat.js

@@ -1,13 +1,65 @@
-import { schema } from "./schema.js";
-export function ResponseFormat(name, description, models, rootKey) {
-    return {
+import { recombineTaggedTemplateArgs } from "./util/recombineTaggedTemplateArgs.js";
+export function ResponseFormat(name, ty) {
+    return ResponseFormat_(name, ty);
+}
+function ResponseFormat_(name, ty, description) {
+    return Object.assign((template, ...quasis) => ResponseFormat_(name, ty, description ? `${description} ${recombineTaggedTemplateArgs(template, quasis)}` : undefined), {
         type: "json_schema",
         json_schema: {
             name,
             description,
-            schema: schema(models, rootKey),
+            schema: ty.schema(),
             strict: true,
         },
-    };
+        parseFirstChoice: (completion) => {
+            return JSON.parse(ResponseFormat.unwrapFirstChoice(completion));
+        },
+        parseChoices: (completion) => {
+            return ResponseFormat.unwrapChoices(completion).map((content) => JSON.parse(content));
+        },
+        toJSON() {
+            const { type, json_schema } = this;
+            return { type, json_schema };
+        },
+    });
+}
+(function (ResponseFormat) {
+    function unwrapFirstChoice(completion) {
+        const { choices: [firstChoice] } = completion;
+        if (!firstChoice) {
+            throw new ResponseFormatUnwrapError("No choices contained within the completion response.");
+        }
+        return unwrapChoice(firstChoice);
+    }
+    ResponseFormat.unwrapFirstChoice = unwrapFirstChoice;
+    function unwrapChoices(completions) {
+        return completions.choices.map(unwrapChoice);
+    }
+    ResponseFormat.unwrapChoices = unwrapChoices;
+    function unwrapChoice(choice) {
+        const { finish_reason, message } = choice;
+        if (finish_reason !== "stop") {
+            throw new ResponseFormatUnwrapError(`Completion responded with "${finish_reason}" as finish reason; ${message}`);
+        }
+        const { content, refusal } = message;
+        if (refusal) {
+            throw new ResponseFormatUnwrapError(`Openai refused to fulfill completion request; ${refusal}`);
+        }
+        if (!content) {
+            throw new ResponseFormatUnwrapError("First response choice contained no content.");
+        }
+        return content;
+    }
+})(ResponseFormat || (ResponseFormat = {}));
+export class ResponseFormatUnwrapError extends Error {
+    constructor() {
+        super(...arguments);
+        Object.defineProperty(this, "name", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: "UnwrapResponseError"
+        });
+    }
 }
 //# sourceMappingURL=ResponseFormat.js.map

package/esm/ResponseFormat.js.map

@@ -1 +1 @@
-{"version":3,"file":"ResponseFormat.js","sourceRoot":"","sources":["../src/ResponseFormat.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAapC,MAAM,UAAU,cAAc,CAC5B,IAAY,EACZ,WAAmB,EACnB,MAAS,EACT,OAAwB;IAExB,OAAO;QACL,IAAI,EAAE,aAAa;QACnB,WAAW,EAAE;YACX,IAAI;YACJ,WAAW;YACX,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;YAC/B,MAAM,EAAE,IAAI;SACb;KACF,CAAA;AACH,CAAC"}
+{"version":3,"file":"ResponseFormat.js","sourceRoot":"","sources":["../src/ResponseFormat.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,2BAA2B,EAAE,MAAM,uCAAuC,CAAA;AAcnF,MAAM,UAAU,cAAc,CAAI,IAAY,EAAE,EAAoB;IAClE,OAAO,eAAe,CAAC,IAAI,EAAE,EAAE,CAAC,CAAA;AAClC,CAAC;AAED,SAAS,eAAe,CACtB,IAAY,EACZ,EAAoB,EACpB,WAAoB;IAEpB,OAAO,MAAM,CAAC,MAAM,CAClB,CAAC,QAA8B,EAAE,GAAG,MAAqB,EAAE,EAAE,CAC3D,eAAe,CACb,IAAI,EACJ,EAAE,EACF,WAAW,CAAC,CAAC,CAAC,GAAG,WAAW,IAAI,2BAA2B,CAAC,QAAQ,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAC5F,EACH;QACE,IAAI,EAAE,aAAsB;QAC5B,WAAW,EAAE;YACX,IAAI;YACJ,WAAW;YACX,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE;YACnB,MAAM,EAAE,IAAI;SACb;QACD,gBAAgB,EAAE,CAAC,UAA0B,EAAK,EAAE;YAClD,OAAO,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,iBAAiB,CAAC,UAAU,CAAC,CAAC,CAAA;QACjE,CAAC;QACD,YAAY,EAAE,CAAC,UAA0B,EAAY,EAAE;YACrD,OAAO,cAAc,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAA;QACvF,CAAC;QACD,MAAM;YACJ,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,GAAG,IAAI,CAAA;YAClC,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,CAAA;QAC9B,CAAC;KACF,CACF,CAAA;AACH,CAAC;AAED,WAAiB,cAAc;IAC7B,SAAgB,iBAAiB,CAAC,UAA0B;QAC1D,MAAM,EAAE,OAAO,EAAE,CAAC,WAAW,CAAC,EAAE,GAAG,UAAU,CAAA;QAC7C,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,MAAM,IAAI,yBAAyB,CAAC,sDAAsD,CAAC,CAAA;QAC7F,CAAC;QACD,OAAO,YAAY,CAAC,WAAW,CAAC,CAAA;IAClC,CAAC;IANe,gCAAiB,oBAMhC,CAAA;IAED,SAAgB,aAAa,CAAC,WAA2B;QACvD,OAAO,WAAW,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,CAAA;IAC9C,CAAC;IAFe,4BAAa,gBAE5B,CAAA;IAED,SAAS,YAAY,CAAC,MAA4B;QAChD,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,GAAG,MAAM,CAAA;QACzC,IAAI,aAAa,KAAK,MAAM,EAAE,CAAC;YAC7B,MAAM,IAAI,yBAAyB,CACjC,8BAA8B,aAAa,uBAAuB,OAAO,EAAE,CAC5E,CAAA;QACH,CAAC;QACD,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,OAAO,CAAA;QACpC,IAAI,OAAO,EAAE,CAAC;YACZ,MAAM,IAAI,yBAAyB,CACjC,iDAAiD,OAAO,EAAE,CAC3D,CAAA;QACH,CAAC;QACD,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,yBAAyB,CAAC,6CAA6C,CAAC,CAAA;QACpF,CAAC;QACD,OAAO,OAAO,CAAA;IAChB,CAAC;AACH,CAAC,EA/BgB,cAAc,KAAd,cAAc,QA+B9B;AAED,MAAM,OAAO,yBAA0B,SAAQ,KAAK;IAApD;;QACoB;;;;mBAAO,qBAAqB;WAAA;IAChD,CAAC;CAAA"}

package/esm/Tool.d.ts

@@ -0,0 +1,13 @@
+import type { RootTy, Schema } from "./types/mod.js";
+export declare function Tool<T>(name: string, ty: RootTy<T, never>): Tool<T>;
+export interface Tool<T = any> {
+    (template: TemplateStringsArray, ...quasis: Array<string>): Tool<T>;
+    type: "function";
+    /** The name with which OpenAI recognizes the tool. */
+    name: string;
+    /** A description to inform the LLM of when/how to use the tool. */
+    description?: string;
+    /** The tool implementation's argument type in JSON Schema. */
+    parameters?: Schema;
+}
+//# sourceMappingURL=Tool.d.ts.map

package/esm/Tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Tool.d.ts","sourceRoot":"","sources":["../src/Tool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAA;AAGpD,wBAAgB,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,CAAC,CAAC,EAAE,KAAK,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAEnE;AAuBD,MAAM,WAAW,IAAI,CAAC,CAAC,GAAG,GAAG;IAC3B,CAAC,QAAQ,EAAE,oBAAoB,EAAE,GAAG,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAA;IACnE,IAAI,EAAE,UAAU,CAAA;IAChB,sDAAsD;IACtD,IAAI,EAAE,MAAM,CAAA;IACZ,mEAAmE;IACnE,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,8DAA8D;IAC9D,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB"}

package/esm/Tool.js

@@ -0,0 +1,17 @@
+import { recombineTaggedTemplateArgs } from "./util/recombineTaggedTemplateArgs.js";
+export function Tool(name, ty) {
+    return Tool_(name, ty);
+}
+function Tool_(name, ty, description) {
+    return Object.assign((template, ...quasis) => Tool_(name, ty, description ? `${description} ${recombineTaggedTemplateArgs(template, quasis)}` : undefined), {
+        type: "function",
+        name,
+        description,
+        parameters: ty.schema(),
+        toJson() {
+            const { type, name, description, parameters } = this;
+            return { type, name, description, parameters };
+        },
+    });
+}
+//# sourceMappingURL=Tool.js.map

package/esm/Tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Tool.js","sourceRoot":"","sources":["../src/Tool.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,2BAA2B,EAAE,MAAM,uCAAuC,CAAA;AAEnF,MAAM,UAAU,IAAI,CAAI,IAAY,EAAE,EAAoB;IACxD,OAAO,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC,CAAA;AACxB,CAAC;AAED,SAAS,KAAK,CAAI,IAAY,EAAE,EAAoB,EAAE,WAAoB;IACxE,OAAO,MAAM,CAAC,MAAM,CAClB,CAAC,QAA8B,EAAE,GAAG,MAAqB,EAAE,EAAE,CAC3D,KAAK,CACH,IAAI,EACJ,EAAE,EACF,WAAW,CAAC,CAAC,CAAC,GAAG,WAAW,IAAI,2BAA2B,CAAC,QAAQ,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAC5F,EACH;QACE,IAAI,EAAE,UAAmB;QACzB,IAAI;QACJ,WAAW;QACX,UAAU,EAAE,EAAE,CAAC,MAAM,EAAE;QACvB,MAAM;YACJ,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,WAAW,EAAE,UAAU,EAAE,GAAG,IAAI,CAAA;YACpD,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,WAAW,EAAE,UAAU,EAAE,CAAA;QAChD,CAAC;KACF,CACF,CAAA;AACH,CAAC"}

package/esm/_dnt.polyfills.d.ts

@@ -0,0 +1,12 @@
+declare global {
+    interface Object {
+        /**
+         * Determines whether an object has a property with the specified name.
+         * @param o An object.
+         * @param v A property name.
+         */
+        hasOwn(o: object, v: PropertyKey): boolean;
+    }
+}
+export {};
+//# sourceMappingURL=_dnt.polyfills.d.ts.map

package/esm/_dnt.polyfills.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_dnt.polyfills.d.ts","sourceRoot":"","sources":["../src/_dnt.polyfills.ts"],"names":[],"mappings":"AAeA,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,MAAM;QACd;;;;WAIG;QACH,MAAM,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC;KAC5C;CACF;AAED,OAAO,EAAE,CAAC"}

package/esm/_dnt.polyfills.js

@@ -0,0 +1,16 @@
+// https://github.com/tc39/proposal-accessible-object-hasownproperty/blob/main/polyfill.js
+if (!Object.hasOwn) {
+    Object.defineProperty(Object, "hasOwn", {
+        value: function (object, property) {
+            if (object == null) {
+                throw new TypeError("Cannot convert undefined or null to object");
+            }
+            return Object.prototype.hasOwnProperty.call(Object(object), property);
+        },
+        configurable: true,
+        enumerable: false,
+        writable: true,
+    });
+}
+export {};
+//# sourceMappingURL=_dnt.polyfills.js.map

package/esm/_dnt.polyfills.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_dnt.polyfills.js","sourceRoot":"","sources":["../src/_dnt.polyfills.ts"],"names":[],"mappings":"AAAA,0FAA0F;AAC1F,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;IACnB,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,QAAQ,EAAE;QACtC,KAAK,EAAE,UAAU,MAAW,EAAE,QAAa;YACzC,IAAI,MAAM,IAAI,IAAI,EAAE,CAAC;gBACnB,MAAM,IAAI,SAAS,CAAC,4CAA4C,CAAC,CAAC;YACpE,CAAC;YACD,OAAO,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAC,CAAC;QACxE,CAAC;QACD,YAAY,EAAE,IAAI;QAClB,UAAU,EAAE,KAAK;QACjB,QAAQ,EAAE,IAAI;KACf,CAAC,CAAC;AACL,CAAC"}

package/esm/deps/jsr.io/@std/collections/1.0.9/_utils.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Filters the given array, removing all elements that do not match the given predicate
+ * **in place. This means `array` will be modified!**.
+ */
+export declare function filterInPlace<T>(array: Array<T>, predicate: (el: T) => boolean): Array<T>;
+//# sourceMappingURL=_utils.d.ts.map

package/esm/deps/jsr.io/@std/collections/1.0.9/_utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_utils.d.ts","sourceRoot":"","sources":["../../../../../../src/deps/jsr.io/@std/collections/1.0.9/_utils.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAC7B,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,EACf,SAAS,EAAE,CAAC,EAAE,EAAE,CAAC,KAAK,OAAO,GAC5B,KAAK,CAAC,CAAC,CAAC,CAeV"}

package/esm/deps/jsr.io/@std/collections/1.0.9/_utils.js

@@ -0,0 +1,19 @@
+// Copyright 2018-2024 the Deno authors. All rights reserved. MIT license.
+// This module is browser compatible.
+/**
+ * Filters the given array, removing all elements that do not match the given predicate
+ * **in place. This means `array` will be modified!**.
+ */
+export function filterInPlace(array, predicate) {
+    let outputIndex = 0;
+    for (const cur of array) {
+        if (!predicate(cur)) {
+            continue;
+        }
+        array[outputIndex] = cur;
+        outputIndex += 1;
+    }
+    array.splice(outputIndex);
+    return array;
+}
+//# sourceMappingURL=_utils.js.map

package/esm/deps/jsr.io/@std/collections/1.0.9/_utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_utils.js","sourceRoot":"","sources":["../../../../../../src/deps/jsr.io/@std/collections/1.0.9/_utils.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,qCAAqC;AAErC;;;GAGG;AACH,MAAM,UAAU,aAAa,CAC3B,KAAe,EACf,SAA6B;IAE7B,IAAI,WAAW,GAAG,CAAC,CAAC;IAEpB,KAAK,MAAM,GAAG,IAAI,KAAK,EAAE,CAAC;QACxB,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC;YACpB,SAAS;QACX,CAAC;QAED,KAAK,CAAC,WAAW,CAAC,GAAG,GAAG,CAAC;QACzB,WAAW,IAAI,CAAC,CAAC;IACnB,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;IAE1B,OAAO,KAAK,CAAC;AACf,CAAC"}

package/esm/deps/jsr.io/@std/collections/1.0.9/aggregate_groups.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Applies the given aggregator to each group in the given grouping, returning the
+ * results together with the respective group keys
+ *
+ * @typeParam T Type of the values in the input record.
+ * @typeParam A Type of the accumulator value, which will match the returned
+ * record's values.
+ *
+ * @param record The grouping to aggregate.
+ * @param aggregator The function to apply to each group.
+ *
+ * @returns A record with the same keys as the input record, but with the values
+ * being the result of applying the aggregator to each group.
+ *
+ * @example Basic usage
+ * ```ts
+ * import { aggregateGroups } from "@std/collections/aggregate-groups";
+ * import { assertEquals } from "@std/assert";
+ *
+ * const foodProperties = {
+ *   Curry: ["spicy", "vegan"],
+ *   Omelette: ["creamy", "vegetarian"],
+ * };
+ *
+ * const descriptions = aggregateGroups(
+ *   foodProperties,
+ *   (current, key, first, acc) => {
+ *     return first
+ *       ? `${key} is ${current}`
+ *       : `${acc} and ${current}`;
+ *   },
+ * );
+ *
+ * assertEquals(descriptions, {
+ *   Curry: "Curry is spicy and vegan",
+ *   Omelette: "Omelette is creamy and vegetarian",
+ * });
+ * ```
+ */
+export declare function aggregateGroups<T, A>(record: Readonly<Record<string, ReadonlyArray<T>>>, aggregator: (current: T, key: string, first: boolean, accumulator?: A) => A): Record<string, A>;
+//# sourceMappingURL=aggregate_groups.d.ts.map

package/esm/deps/jsr.io/@std/collections/1.0.9/aggregate_groups.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aggregate_groups.d.ts","sourceRoot":"","sources":["../../../../../../src/deps/jsr.io/@std/collections/1.0.9/aggregate_groups.ts"],"names":[],"mappings":"AAKA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,CAAC,EAClC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,EAClD,UAAU,EAAE,CAAC,OAAO,EAAE,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,WAAW,CAAC,EAAE,CAAC,KAAK,CAAC,GAC1E,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAcnB"}

package/esm/deps/jsr.io/@std/collections/1.0.9/aggregate_groups.js

@@ -0,0 +1,51 @@
+// Copyright 2018-2024 the Deno authors. All rights reserved. MIT license.
+// This module is browser compatible.
+import { mapEntries } from "./map_entries.js";
+/**
+ * Applies the given aggregator to each group in the given grouping, returning the
+ * results together with the respective group keys
+ *
+ * @typeParam T Type of the values in the input record.
+ * @typeParam A Type of the accumulator value, which will match the returned
+ * record's values.
+ *
+ * @param record The grouping to aggregate.
+ * @param aggregator The function to apply to each group.
+ *
+ * @returns A record with the same keys as the input record, but with the values
+ * being the result of applying the aggregator to each group.
+ *
+ * @example Basic usage
+ * ```ts
+ * import { aggregateGroups } from "@std/collections/aggregate-groups";
+ * import { assertEquals } from "@std/assert";
+ *
+ * const foodProperties = {
+ *   Curry: ["spicy", "vegan"],
+ *   Omelette: ["creamy", "vegetarian"],
+ * };
+ *
+ * const descriptions = aggregateGroups(
+ *   foodProperties,
+ *   (current, key, first, acc) => {
+ *     return first
+ *       ? `${key} is ${current}`
+ *       : `${acc} and ${current}`;
+ *   },
+ * );
+ *
+ * assertEquals(descriptions, {
+ *   Curry: "Curry is spicy and vegan",
+ *   Omelette: "Omelette is creamy and vegetarian",
+ * });
+ * ```
+ */
+export function aggregateGroups(record, aggregator) {
+    return mapEntries(record, ([key, values]) => [
+        key,
+        // Need the type assertions here because the reduce type does not support
+        // the type transition we need
+        values.reduce((accumulator, current, currentIndex) => aggregator(current, key, currentIndex === 0, accumulator), undefined),
+    ]);
+}
+//# sourceMappingURL=aggregate_groups.js.map

package/esm/deps/jsr.io/@std/collections/1.0.9/aggregate_groups.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"aggregate_groups.js","sourceRoot":"","sources":["../../../../../../src/deps/jsr.io/@std/collections/1.0.9/aggregate_groups.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,qCAAqC;AAErC,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,MAAM,UAAU,eAAe,CAC7B,MAAkD,EAClD,UAA2E;IAE3E,OAAO,UAAU,CACf,MAAM,EACN,CAAC,CAAC,GAAG,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC;QACjB,GAAG;QACH,yEAAyE;QACzE,8BAA8B;QAC9B,MAAM,CAAC,MAAM,CACX,CAAC,WAAW,EAAE,OAAO,EAAE,YAAY,EAAE,EAAE,CACrC,UAAU,CAAC,OAAO,EAAE,GAAG,EAAE,YAAY,KAAK,CAAC,EAAE,WAAW,CAAC,EAC3D,SAA0B,CACtB;KACP,CACF,CAAC;AACJ,CAAC"}

package/esm/deps/jsr.io/@std/collections/1.0.9/associate_by.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Creates a record by associating each element of the input array with a key
+ * generated by the selector function.
+ *
+ * If the selector produces the same key for multiple elements, the latest one
+ * will be used (overriding the ones before it).
+ *
+ * @typeParam T Type of the elements in the input array.
+ *
+ * @param array The array to transform.
+ * @param selector The function to extract the key from each element.
+ *
+ * @returns A record with the keys produced by the selector and the elements as
+ * values.
+ *
+ * @example Basic usage
+ * ```ts
+ * import { associateBy } from "@std/collections/associate-by";
+ * import { assertEquals } from "@std/assert";
+ *
+ * const users = [
+ *   { id: "a2e", userName: "Anna" },
+ *   { id: "5f8", userName: "Arnold" },
+ *   { id: "d2c", userName: "Kim" },
+ * ];
+ *
+ * const usersById = associateBy(users, (user) => user.id);
+ *
+ * assertEquals(usersById, {
+ *   "a2e": { id: "a2e", userName: "Anna" },
+ *   "5f8": { id: "5f8", userName: "Arnold" },
+ *   "d2c": { id: "d2c", userName: "Kim" },
+ * });
+ * ```
+ */
+export declare function associateBy<T>(array: Iterable<T>, selector: (el: T) => string): Record<string, T>;
+//# sourceMappingURL=associate_by.d.ts.map

package/esm/deps/jsr.io/@std/collections/1.0.9/associate_by.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"associate_by.d.ts","sourceRoot":"","sources":["../../../../../../src/deps/jsr.io/@std/collections/1.0.9/associate_by.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAC3B,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,EAClB,QAAQ,EAAE,CAAC,EAAE,EAAE,CAAC,KAAK,MAAM,GAC1B,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAQnB"}

package/esm/deps/jsr.io/@std/collections/1.0.9/associate_by.js

@@ -0,0 +1,45 @@
+// Copyright 2018-2024 the Deno authors. All rights reserved. MIT license.
+// This module is browser compatible.
+/**
+ * Creates a record by associating each element of the input array with a key
+ * generated by the selector function.
+ *
+ * If the selector produces the same key for multiple elements, the latest one
+ * will be used (overriding the ones before it).
+ *
+ * @typeParam T Type of the elements in the input array.
+ *
+ * @param array The array to transform.
+ * @param selector The function to extract the key from each element.
+ *
+ * @returns A record with the keys produced by the selector and the elements as
+ * values.
+ *
+ * @example Basic usage
+ * ```ts
+ * import { associateBy } from "@std/collections/associate-by";
+ * import { assertEquals } from "@std/assert";
+ *
+ * const users = [
+ *   { id: "a2e", userName: "Anna" },
+ *   { id: "5f8", userName: "Arnold" },
+ *   { id: "d2c", userName: "Kim" },
+ * ];
+ *
+ * const usersById = associateBy(users, (user) => user.id);
+ *
+ * assertEquals(usersById, {
+ *   "a2e": { id: "a2e", userName: "Anna" },
+ *   "5f8": { id: "5f8", userName: "Arnold" },
+ *   "d2c": { id: "d2c", userName: "Kim" },
+ * });
+ * ```
+ */
+export function associateBy(array, selector) {
+    const result = {};
+    for (const element of array) {
+        result[selector(element)] = element;
+    }
+    return result;
+}
+//# sourceMappingURL=associate_by.js.map

package/esm/deps/jsr.io/@std/collections/1.0.9/associate_by.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"associate_by.js","sourceRoot":"","sources":["../../../../../../src/deps/jsr.io/@std/collections/1.0.9/associate_by.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,qCAAqC;AAErC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,MAAM,UAAU,WAAW,CACzB,KAAkB,EAClB,QAA2B;IAE3B,MAAM,MAAM,GAAsB,EAAE,CAAC;IAErC,KAAK,MAAM,OAAO,IAAI,KAAK,EAAE,CAAC;QAC5B,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,GAAG,OAAO,CAAC;IACtC,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/esm/deps/jsr.io/@std/collections/1.0.9/associate_with.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Associates each string element of an array with a value returned by a selector
+ * function.
+ *
+ * If any of two pairs would have the same value, the latest one will be used
+ * (overriding the ones before it).
+ *
+ * @typeParam T The type of the values returned by the selector function.
+ *
+ * @param array The array of elements to associate with values.
+ * @param selector The selector function that returns a value for each element.
+ *
+ * @returns An object where each element of the array is associated with a value
+ * returned by the selector function.
+ *
+ * @example Basic usage
+ * ```ts
+ * import { associateWith } from "@std/collections/associate-with";
+ * import { assertEquals } from "@std/assert";
+ *
+ * const names = ["Kim", "Lara", "Jonathan"];
+ *
+ * const namesToLength = associateWith(names, (person) => person.length);
+ *
+ * assertEquals(namesToLength, {
+ *   "Kim": 3,
+ *   "Lara": 4,
+ *   "Jonathan": 8,
+ * });
+ * ```
+ */
+export declare function associateWith<T>(array: Iterable<string>, selector: (key: string) => T): Record<string, T>;
+//# sourceMappingURL=associate_with.d.ts.map

package/esm/deps/jsr.io/@std/collections/1.0.9/associate_with.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"associate_with.d.ts","sourceRoot":"","sources":["../../../../../../src/deps/jsr.io/@std/collections/1.0.9/associate_with.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAC7B,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,EACvB,QAAQ,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,CAAC,GAC3B,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAQnB"}

package/esm/deps/jsr.io/@std/collections/1.0.9/associate_with.js

@@ -0,0 +1,41 @@
+// Copyright 2018-2024 the Deno authors. All rights reserved. MIT license.
+// This module is browser compatible.
+/**
+ * Associates each string element of an array with a value returned by a selector
+ * function.
+ *
+ * If any of two pairs would have the same value, the latest one will be used
+ * (overriding the ones before it).
+ *
+ * @typeParam T The type of the values returned by the selector function.
+ *
+ * @param array The array of elements to associate with values.
+ * @param selector The selector function that returns a value for each element.
+ *
+ * @returns An object where each element of the array is associated with a value
+ * returned by the selector function.
+ *
+ * @example Basic usage
+ * ```ts
+ * import { associateWith } from "@std/collections/associate-with";
+ * import { assertEquals } from "@std/assert";
+ *
+ * const names = ["Kim", "Lara", "Jonathan"];
+ *
+ * const namesToLength = associateWith(names, (person) => person.length);
+ *
+ * assertEquals(namesToLength, {
+ *   "Kim": 3,
+ *   "Lara": 4,
+ *   "Jonathan": 8,
+ * });
+ * ```
+ */
+export function associateWith(array, selector) {
+    const result = {};
+    for (const element of array) {
+        result[element] = selector(element);
+    }
+    return result;
+}
+//# sourceMappingURL=associate_with.js.map

package/esm/deps/jsr.io/@std/collections/1.0.9/associate_with.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"associate_with.js","sourceRoot":"","sources":["../../../../../../src/deps/jsr.io/@std/collections/1.0.9/associate_with.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,qCAAqC;AAErC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,MAAM,UAAU,aAAa,CAC3B,KAAuB,EACvB,QAA4B;IAE5B,MAAM,MAAM,GAAsB,EAAE,CAAC;IAErC,KAAK,MAAM,OAAO,IAAI,KAAK,EAAE,CAAC;QAC5B,MAAM,CAAC,OAAO,CAAC,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC;IACtC,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/esm/deps/jsr.io/@std/collections/1.0.9/chunk.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Splits the given array into chunks of the given size and returns them.
+ *
+ * @typeParam T Type of the elements in the input array.
+ *
+ * @param array The array to split into chunks.
+ * @param size The size of the chunks. This must be a positive integer.
+ *
+ * @returns An array of chunks of the given size.
+ *
+ * @example Basic usage
+ * ```ts
+ * import { chunk } from "@std/collections/chunk";
+ * import { assertEquals } from "@std/assert";
+ *
+ * const words = [
+ *   "lorem",
+ *   "ipsum",
+ *   "dolor",
+ *   "sit",
+ *   "amet",
+ *   "consetetur",
+ *   "sadipscing",
+ * ];
+ * const chunks = chunk(words, 3);
+ *
+ * assertEquals(
+ *   chunks,
+ *   [
+ *     ["lorem", "ipsum", "dolor"],
+ *     ["sit", "amet", "consetetur"],
+ *     ["sadipscing"],
+ *   ],
+ * );
+ * ```
+ */
+export declare function chunk<T>(array: readonly T[], size: number): T[][];
+//# sourceMappingURL=chunk.d.ts.map

package/esm/deps/jsr.io/@std/collections/1.0.9/chunk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunk.d.ts","sourceRoot":"","sources":["../../../../../../src/deps/jsr.io/@std/collections/1.0.9/chunk.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,wBAAgB,KAAK,CAAC,CAAC,EAAE,KAAK,EAAE,SAAS,CAAC,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,EAAE,EAAE,CAgBjE"}