@alpacakit/channels 0.1.0-beta.37 → 0.2.0-beta.2

package/dist/codecs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"codecs.d.ts","sourceRoot":"","sources":["../src/codecs.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAGxE,iBAAS,gBAAgB,CAAC,KAAK,CAAC,KAAK,SAAS,UAAU,EAAE,KAAK,EAAE;IAC/D,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC;IACjD,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;CACvB,GAAG,UAAU,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CAQnC;AAED,iBAAS,WAAW,IAAI,UAAU,CAAC,MAAM,CAAC,CAKzC;AAED,iBAAS,YAAY,IAAI,UAAU,CAAC,OAAO,CAAC,CAK3C;AAED,iBAAS,oBAAoB,CAC3B,KAAK,GAAE;IAAE,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;CAAkB,GACrD,UAAU,CAAC,MAAM,CAAC,CAQpB;AAED,iBAAS,eAAe,CAAC,KAAK,CAAC,MAAM,SAAS,SAAS,CAAC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,EAC1E,MAAM,EAAE,MAAM,GACb,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAQ5B;AAED,iBAAS,mBAAmB,CAC1B,KAAK,CAAC,MAAM,SAAS,SAAS,CAAC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,EACnD,MAAM,EAAE,MAAM,GAAG,UAAU,CAAC,SAAS,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAYvD;AAED,iBAAS,eAAe,IAAI,UAAU,CAAC,SAAS,MAAM,EAAE,CAAC,CASxD;AAED,eAAO,MAAM,MAAM;;;;;;;;CAQlB,CAAC"}
+{"version":3,"file":"codecs.d.ts","sourceRoot":"","sources":["../src/codecs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAI5D,KAAK,SAAS,CAAC,GAAG,IAAI,GAAG,SAAS,SAAS,GAAG,GAAG,GAAG,SAAS,CAAC;AAE9D,iBAAS,gBAAgB,CAAC,GAAG,EAAE,KAAK,SAAS,SAAS,EAAE,KAAK,EAAE;IAC7D,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IACvC,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC;CAC/C,GAAG,UAAU,CAAC,GAAG,EAAE,KAAK,CAAC,CAEzB;AAYD,iBAAS,WAAW,IAAI,UAAU,CAAC,MAAM,EAAE,MAAM,CAAC,CAKjD;AAED,iBAAS,YAAY,IAAI,UAAU,CAAC,OAAO,EAAE,OAAO,CAAC,CAKpD;AAED,iBAAS,oBAAoB,CAC3B,KAAK,GAAE;IAAE,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;CAAkB,GACrD,UAAU,CAAC,MAAM,EAAE,MAAM,CAAC,CAM5B;AAED,iBAAS,eAAe,CAAC,KAAK,CAAC,MAAM,SAAS,SAAS,CAAC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,EAC1E,MAAM,EAAE,MAAM,GACb,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAM5C;AAED,iBAAS,mBAAmB,CAC1B,KAAK,CAAC,MAAM,SAAS,SAAS,CAAC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,EAEnD,MAAM,EAAE,MAAM,GACb,UAAU,CAAC,SAAS,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,SAAS,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAYlE;AAED,iBAAS,eAAe,IAAI,UAAU,CAAC,SAAS,MAAM,EAAE,EAAE,SAAS,MAAM,EAAE,CAAC,CAS3E;AAED,eAAO,MAAM,MAAM;;;;;;;;CAQT,CAAC"}

package/dist/codecs.js

@@ -1,14 +1,14 @@
-import { createSchemaRuntimeCodec, readonlyArraySchema } from "@alpacakit/core";
 import { z } from "zod";
+import { ownedArray, ownedRecord, snapshotValueShape } from "./owned.js";
 import { VALUE_SHAPE_KIND } from "./values.js";
 function defineValueCodec(input) {
-    const codec = createSchemaRuntimeCodec(input.schema);
-    return {
-        schema: input.schema,
-        shape: input.shape,
-        decode: codec.decode,
-        encode: codec.encode,
-    };
+    return makeValueCodec(input.schema, input.shape);
+}
+function makeValueCodec(schema, shape) {
+    return ownedRecord({
+        schema,
+        shape: snapshotValueShape(shape),
+    });
 }
 function stringCodec() {
     return defineValueCodec({
@@ -25,42 +25,32 @@ function booleanCodec() {
 function positiveIntegerCodec(input = { max: null }) {
     const base = z.number().int().positive();
     return defineValueCodec({
-        schema: (input.max === null
-            ? base
-            : base.max(input.max)),
+        schema: input.max === null ? base : base.max(input.max),
         shape: { kind: VALUE_SHAPE_KIND.positiveInteger },
     });
 }
 function stringEnumCodec(values) {
-    return defineValueCodec({
-        schema: z.enum(values),
-        shape: {
-            kind: VALUE_SHAPE_KIND.stringEnum,
-            values,
-        },
+    const snapshot = ownedArray(values);
+    return makeValueCodec(z.enum(snapshot), {
+        kind: VALUE_SHAPE_KIND.stringEnum,
+        values: snapshot,
     });
 }
 function stringEnumListCodec(values) {
     const element = stringEnumCodec(values);
-    return defineValueCodec({
-        schema: readonlyArraySchema(element.schema),
-        shape: {
-            kind: VALUE_SHAPE_KIND.array,
-            element: {
-                kind: VALUE_SHAPE_KIND.stringEnum,
-                values,
-            },
+    return makeValueCodec(z.array(element.schema).readonly(), {
+        kind: VALUE_SHAPE_KIND.array,
+        element: {
+            kind: VALUE_SHAPE_KIND.stringEnum,
+            values,
         },
     });
 }
 function stringListCodec() {
     const element = stringCodec();
-    return defineValueCodec({
-        schema: readonlyArraySchema(element.schema),
-        shape: {
-            kind: VALUE_SHAPE_KIND.array,
-            element: element.shape,
-        },
+    return makeValueCodec(z.array(element.schema).readonly(), {
+        kind: VALUE_SHAPE_KIND.array,
+        element: element.shape,
     });
 }
 export const codecs = {

package/dist/contract.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../src/contract.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,SAAS,EACf,MAAM,iBAAiB,CAAC;AACzB,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,KAAK,EACV,eAAe,EACf,yBAAyB,EACzB,cAAc,EACd,YAAY,EACb,MAAM,YAAY,CAAC;AAEpB,wBAAgB,oBAAoB,CAAC,KAAK,SAAS,SAAS,EAC1D,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,GACvB,cAAc,CAAC,KAAK,CAAC,CAGvB;AAED,qBAAa,wBAAyB,SAAQ,KAAK;IAE/C,QAAQ,CAAC,SAAS,EAAE,MAAM;IAC1B,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE;gBADzB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,SAAS,MAAM,EAAE;CAKrC;AAED,wBAAgB,kBAAkB,CAChC,KAAK,CAAC,IAAI,SAAS,MAAM,EACzB,KAAK,CAAC,UAAU,SAAS,YAAY,EACrC,UAAU,EACV,MAAM,SAAS,SAAS,EAExB,KAAK,EAAE,eAAe,CAAC,IAAI,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,CAAC,GAC3D,cAAc,CAAC,MAAM,CAAC,CAKxB;AAED,wBAAgB,iBAAiB,CAC/B,KAAK,CAAC,IAAI,SAAS,MAAM,EACzB,KAAK,CAAC,UAAU,SAAS,YAAY,EACrC,UAAU,EACV,MAAM,SAAS,SAAS,EAExB,KAAK,EAAE,yBAAyB,CAAC,IAAI,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,CAAC,EACtE,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,GACrB,MAAM,CAMR"}
+{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../src/contract.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,SAAS,EACf,MAAM,iBAAiB,CAAC;AACzB,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,KAAK,EACV,eAAe,EACf,yBAAyB,EAEzB,cAAc,EACd,YAAY,EACb,MAAM,YAAY,CAAC;AAEpB,wBAAgB,oBAAoB,CAAC,KAAK,SAAS,SAAS,EAC1D,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,GACvB,cAAc,CAAC,KAAK,CAAC,CAEvB;AAED,qBAAa,wBAAyB,SAAQ,KAAK;IAE/C,QAAQ,CAAC,SAAS,EAAE,MAAM;IAC1B,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE;gBADzB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,SAAS,MAAM,EAAE;CAKrC;AAED,wBAAgB,kBAAkB,CAChC,KAAK,CAAC,IAAI,SAAS,MAAM,EACzB,KAAK,CAAC,UAAU,SAAS,YAAY,EACrC,UAAU,EACV,MAAM,SAAS,SAAS,EAExB,KAAK,EAAE,eAAe,CAAC,IAAI,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,CAAC,GAC3D,cAAc,CAAC,MAAM,CAAC,CAKxB;AAED,wBAAgB,iBAAiB,CAC/B,KAAK,CAAC,IAAI,SAAS,MAAM,EACzB,KAAK,CAAC,UAAU,SAAS,YAAY,EACrC,UAAU,EACV,MAAM,SAAS,SAAS,EAExB,KAAK,EAAE,yBAAyB,CAAC,IAAI,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,CAAC,EACtE,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,GACrB,MAAM,CAER"}

package/dist/contract.js

@@ -1,7 +1,6 @@
 import { CODEC_DECODE_RESULT_KIND, createSchemaRuntimeCodec, } from "@alpacakit/core";
 export function createOutputContract(schema) {
-    const { decode } = createSchemaRuntimeCodec(schema);
-    return { schema, decode };
+    return Object.freeze({ schema });
 }
 export class EntryOutputContractError extends Error {
     entryName;
@@ -20,7 +19,13 @@ export function requireEntryOutput(entry) {
     return entry.output;
 }
 export function verifyEntryOutput(entry, value) {
-    const decoded = requireEntryOutput(entry).decode(value);
+    return verifyEntryOutputValue(entry, value);
+}
+function verifyEntryOutputValue(entry, value) {
+    if (entry.output === null) {
+        throw new Error(`Entry ${entry.name} does not declare an output contract`);
+    }
+    const decoded = createSchemaRuntimeCodec(entry.output.schema).decode(value);
     if (decoded.kind === CODEC_DECODE_RESULT_KIND.invalid) {
         throw new EntryOutputContractError(entry.name, decoded.issues);
     }

package/dist/definition-error.d.ts

@@ -0,0 +1,5 @@
+export declare class EntryTreeDefinitionError extends Error {
+    readonly issues: readonly string[];
+    constructor(issues: readonly string[]);
+}
+//# sourceMappingURL=definition-error.d.ts.map

package/dist/definition-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"definition-error.d.ts","sourceRoot":"","sources":["../src/definition-error.ts"],"names":[],"mappings":"AAAA,qBAAa,wBAAyB,SAAQ,KAAK;IACrC,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE;gBAAzB,MAAM,EAAE,SAAS,MAAM,EAAE;CAI/C"}

package/dist/definition-error.js

@@ -0,0 +1,8 @@
+export class EntryTreeDefinitionError extends Error {
+    issues;
+    constructor(issues) {
+        super(`Invalid entry tree definition:\n${issues.join("\n")}`);
+        this.issues = issues;
+        this.name = EntryTreeDefinitionError.name;
+    }
+}

package/dist/factory.d.ts

@@ -1,16 +1,30 @@
-import type { JsonValue } from "@alpacakit/core";
-import type { ChannelSegmentOverride, CommandDocumentationInput, EntryChannelBinding, EntryDefinition, EntryDefinitionWithOutput, EntryTreeDefinition, EntryTreeEndpoint, EntryTreeNode, ParameterSet } from "./model.js";
-import type { Channel } from "./values.js";
-export declare function defineEntryTree(root: EntryTreeNode): EntryTreeDefinition;
-export declare function defineEntryNode(input: {
+import type { Callable, ChannelSegmentOverride, CommandDocumentationInput, EndpointsOfNode, EntryChannelBinding, EntryTreeDefinition, EntryTreeEndpoint, EntryTreeNode, ErasedEntryDefinition } from "./model.js";
+export declare function defineEntryTree<const Node extends EntryTreeNode>(root: Node): EntryTreeDefinition<EndpointsOfNode<Node>>;
+export declare function defineEntryNode<const Endpoints extends readonly EntryTreeEndpoint[] = readonly [], const Children extends readonly EntryTreeNode[] = readonly []>(input: {
     readonly name: string;
     readonly description: string;
     readonly documentation?: CommandDocumentationInput;
     readonly segments?: readonly ChannelSegmentOverride[];
-    readonly endpoints?: readonly EntryTreeEndpoint[];
-    readonly children?: readonly EntryTreeNode[];
-}): EntryTreeNode;
-export declare function mergeEntryTreeNodes(nodes: readonly EntryTreeNode[]): readonly EntryTreeNode[];
-export declare function defineEntryEndpoint<const Name extends string, const Parameters extends ParameterSet, Projection, Output extends JsonValue>(entry: EntryDefinitionWithOutput<Name, Parameters, Projection, Output>, ...channels: readonly EntryChannelBinding<Channel, NoInfer<Parameters[number]["name"]>>[]): EntryTreeEndpoint<EntryDefinitionWithOutput<Name, Parameters, Projection, Output>>;
-export declare function defineEntryEndpoint<const Name extends string, const Parameters extends ParameterSet, Projection>(entry: EntryDefinition<Name, Parameters, Projection>, ...channels: readonly EntryChannelBinding<Channel, NoInfer<Parameters[number]["name"]>>[]): EntryTreeEndpoint<EntryDefinition<Name, Parameters, Projection>>;
+    readonly endpoints?: Endpoints;
+    readonly children?: Children;
+}): EntryTreeNode<Endpoints[number] | EndpointsOfNode<Children[number]>>;
+export declare function mergeEntryTreeNodes<const Nodes extends readonly EntryTreeNode[]>(nodes: Nodes): readonly EntryTreeNode<EndpointsOfNode<Nodes[number]>>[];
+/**
+ * Bundles an Entry definition object with channel bindings. This factory does
+ * not register or execute an application handler.
+ */
+type CheckedHandlerDefinition<Arguments extends readonly unknown[]> = number extends Arguments["length"] ? {
+    readonly handler: never;
+} : Exclude<Arguments["length"], 0 | 1 | 2> extends never ? unknown : {
+    readonly handler: never;
+};
+type HandlerArgumentsFor<Projection, Arguments extends readonly unknown[]> = {
+    readonly [Index in keyof Arguments]: Index extends "0" ? Projection : Arguments[Index];
+};
+type RegisteredHandler<Arguments extends readonly unknown[], Result> = (...args: Arguments) => Result;
+export declare function defineEntryEndpoint<const Entry extends ErasedEntryDefinition, const Handler extends Callable, const Arguments extends readonly unknown[], Result, const Channels extends readonly EntryChannelBinding[]>(entry: Entry, definition: {
+    readonly handler: Handler & RegisteredHandler<Arguments, Result> & RegisteredHandler<HandlerArgumentsFor<ReturnType<Entry["project"]>, Arguments>, Result>;
+    readonly channels: Channels;
+} & CheckedHandlerDefinition<Arguments>): EntryTreeEndpoint<Entry, Handler, Channels>;
+export {};
 //# sourceMappingURL=factory.d.ts.map

package/dist/factory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../src/factory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EACV,sBAAsB,EAEtB,yBAAyB,EACzB,mBAAmB,EACnB,eAAe,EACf,yBAAyB,EACzB,mBAAmB,EACnB,iBAAiB,EACjB,aAAa,EACb,YAAY,EACb,MAAM,YAAY,CAAC;AAEpB,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAW3C,wBAAgB,eAAe,CAAC,IAAI,EAAE,aAAa,GAAG,mBAAmB,CAExE;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE;IACrC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,aAAa,CAAC,EAAE,yBAAyB,CAAC;IACnD,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,sBAAsB,EAAE,CAAC;IACtD,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,iBAAiB,EAAE,CAAC;IAClD,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,aAAa,EAAE,CAAC;CAC9C,GAAG,aAAa,CAShB;AAED,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,SAAS,aAAa,EAAE,GAC9B,SAAS,aAAa,EAAE,CAmF1B;AA+JD,wBAAgB,mBAAmB,CACjC,KAAK,CAAC,IAAI,SAAS,MAAM,EACzB,KAAK,CAAC,UAAU,SAAS,YAAY,EACrC,UAAU,EACV,MAAM,SAAS,SAAS,EAExB,KAAK,EAAE,yBAAyB,CAAC,IAAI,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,CAAC,EACtE,GAAG,QAAQ,EAAE,SAAS,mBAAmB,CACvC,OAAO,EACP,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,CACpC,EAAE,GACF,iBAAiB,CAClB,yBAAyB,CAAC,IAAI,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,CAAC,CAChE,CAAC;AACF,wBAAgB,mBAAmB,CACjC,KAAK,CAAC,IAAI,SAAS,MAAM,EACzB,KAAK,CAAC,UAAU,SAAS,YAAY,EACrC,UAAU,EAEV,KAAK,EAAE,eAAe,CAAC,IAAI,EAAE,UAAU,EAAE,UAAU,CAAC,EACpD,GAAG,QAAQ,EAAE,SAAS,mBAAmB,CACvC,OAAO,EACP,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,CACpC,EAAE,GACF,iBAAiB,CAAC,eAAe,CAAC,IAAI,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC"}
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../src/factory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,QAAQ,EACR,sBAAsB,EAEtB,yBAAyB,EACzB,eAAe,EACf,mBAAmB,EACnB,mBAAmB,EACnB,iBAAiB,EACjB,aAAa,EACb,qBAAqB,EACtB,MAAM,YAAY,CAAC;AAcpB,wBAAgB,eAAe,CAAC,KAAK,CAAC,IAAI,SAAS,aAAa,EAC9D,IAAI,EAAE,IAAI,GACT,mBAAmB,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,CAI5C;AAED,wBAAgB,eAAe,CAC7B,KAAK,CAAC,SAAS,SAAS,SAAS,iBAAiB,EAAE,GAAG,SAAS,EAAE,EAClE,KAAK,CAAC,QAAQ,SAAS,SAAS,aAAa,EAAE,GAAG,SAAS,EAAE,EAC7D,KAAK,EAAE;IACP,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,aAAa,CAAC,EAAE,yBAAyB,CAAC;IACnD,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,sBAAsB,EAAE,CAAC;IACtD,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,CAAC;IAC/B,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC;CAC9B,GAAG,aAAa,CAAC,SAAS,CAAC,MAAM,CAAC,GAAG,eAAe,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAWvE;AAED,wBAAgB,mBAAmB,CACjC,KAAK,CAAC,KAAK,SAAS,SAAS,aAAa,EAAE,EAC5C,KAAK,EAAE,KAAK,GAAG,SAAS,aAAa,CAAC,eAAe,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAqFxE;AA+JD;;;GAGG;AACH,KAAK,wBAAwB,CAAC,SAAS,SAAS,SAAS,OAAO,EAAE,IAChE,MAAM,SAAS,SAAS,CAAC,QAAQ,CAAC,GAC9B;IAAE,QAAQ,CAAC,OAAO,EAAE,KAAK,CAAA;CAAE,GAC3B,OAAO,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,SAAS,KAAK,GACnD,OAAO,GACP;IAAE,QAAQ,CAAC,OAAO,EAAE,KAAK,CAAA;CAAE,CAAC;AAEpC,KAAK,mBAAmB,CAAC,UAAU,EAAE,SAAS,SAAS,SAAS,OAAO,EAAE,IAAI;IAC3E,QAAQ,EAAE,KAAK,IAAI,MAAM,SAAS,GAAG,KAAK,SAAS,GAAG,GAClD,UAAU,GACV,SAAS,CAAC,KAAK,CAAC;CACrB,CAAC;AAEF,KAAK,iBAAiB,CAAC,SAAS,SAAS,SAAS,OAAO,EAAE,EAAE,MAAM,IAAI,CACrE,GAAG,IAAI,EAAE,SAAS,KACf,MAAM,CAAC;AAEZ,wBAAgB,mBAAmB,CACjC,KAAK,CAAC,KAAK,SAAS,qBAAqB,EACzC,KAAK,CAAC,OAAO,SAAS,QAAQ,EAC9B,KAAK,CAAC,SAAS,SAAS,SAAS,OAAO,EAAE,EAC1C,MAAM,EACN,KAAK,CAAC,QAAQ,SAAS,SAAS,mBAAmB,EAAE,EAErD,KAAK,EAAE,KAAK,EACZ,UAAU,EAAE;IACV,QAAQ,CAAC,OAAO,EAAE,OAAO,GACvB,iBAAiB,CAAC,SAAS,EAAE,MAAM,CAAC,GACpC,iBAAiB,CACf,mBAAmB,CAAC,UAAU,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,EAAE,SAAS,CAAC,EAC5D,MAAM,CACP,CAAC;IACJ,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;CAC7B,GAAG,wBAAwB,CAAC,SAAS,CAAC,GACtC,iBAAiB,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,CAAC,CAW7C"}

package/dist/factory.js

@@ -1,23 +1,24 @@
+import { ownedArray, ownedRecord } from "./owned.js";
 import { EntryTreeDefinitionError } from "./schema.js";
 const ENTRY_TREE_MERGE_ISSUE = {
     conflictingDocumentation: "conflicting node documentation",
 };
-const EMPTY_COMMAND_DOCUMENTATION = {
-    remarks: [],
-    relatedDocs: [],
-};
+const EMPTY_COMMAND_DOCUMENTATION = ownedRecord({
+    remarks: ownedArray([]),
+    relatedDocs: ownedArray([]),
+});
 export function defineEntryTree(root) {
-    return { root };
+    return ownedRecord({ root });
 }
 export function defineEntryNode(input) {
-    return {
+    return ownedRecord({
         name: input.name,
         description: input.description,
         documentation: normalizeCommandDocumentation(input.documentation),
-        segments: input.segments ?? [],
-        endpoints: input.endpoints ?? [],
-        children: input.children ?? [],
-    };
+        segments: ownedArray(input.segments ?? []),
+        endpoints: ownedArray(input.endpoints ?? []),
+        children: ownedArray(input.children ?? []),
+    });
 }
 export function mergeEntryTreeNodes(nodes) {
     const rootFrames = groupNodes(nodes).map((group) => createMergeFrame(group, ""));
@@ -75,7 +76,7 @@ export function mergeEntryTreeNodes(nodes) {
             }),
         }));
     }
-    return rootFrames.map((frame) => {
+    return ownedArray(rootFrames.map((frame) => {
         const node = merged.get(frame);
         if (!node) {
             throw new EntryTreeDefinitionError([
@@ -83,7 +84,7 @@ export function mergeEntryTreeNodes(nodes) {
             ]);
         }
         return node;
-    });
+    }));
 }
 function createMergeFrame(nodes, parentPath) {
     const first = nodes[0];
@@ -102,10 +103,10 @@ function normalizeCommandDocumentation(input) {
     if (input === undefined) {
         return EMPTY_COMMAND_DOCUMENTATION;
     }
-    return {
-        remarks: input.remarks ?? [],
-        relatedDocs: input.relatedDocs ?? [],
-    };
+    return ownedRecord({
+        remarks: ownedArray(input.remarks ?? []),
+        relatedDocs: ownedArray(input.relatedDocs ?? []),
+    });
 }
 function mergeCommandDocumentation(nodes, path, issues) {
     const claims = nodes
@@ -183,6 +184,15 @@ function mergeSegments(nodes, path, issues) {
     }
     return [...byChannel.values()];
 }
-export function defineEntryEndpoint(entry, ...channels) {
-    return { entry, channels };
+export function defineEntryEndpoint(entry, definition) {
+    if (definition.handler.length > 2) {
+        throw new EntryTreeDefinitionError([
+            `${entry.name}: handler must accept zero to two parameters`,
+        ]);
+    }
+    return ownedRecord({
+        entry,
+        handler: definition.handler,
+        channels: ownedArray(definition.channels),
+    });
 }

package/dist/http-compiler.d.ts

@@ -0,0 +1,15 @@
+import { compileParameterExclusions } from "./binding-compiler.js";
+import type { HttpEntryBinding, HttpSegment } from "./http-model.js";
+import { type ParameterDescription } from "./introspection.js";
+import type { EntryTreeEndpoint } from "./model.js";
+export type CompiledHttpEndpoint = {
+    readonly endpoint: EntryTreeEndpoint;
+    readonly binding: HttpEntryBinding;
+    readonly parameterBindings: ReturnType<typeof compileParameterExclusions>["bindings"];
+    readonly parameterNames: readonly string[];
+    readonly parameters: readonly ParameterDescription[];
+};
+export declare function compileHttpBinding(endpoint: EntryTreeEndpoint, binding: HttpEntryBinding, location: string, issues: string[]): CompiledHttpEndpoint;
+export declare function isHttpEntryBinding(value: unknown): value is HttpEntryBinding;
+export declare function isHttpSegment(value: unknown): value is HttpSegment;
+//# sourceMappingURL=http-compiler.d.ts.map

package/dist/http-compiler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-compiler.d.ts","sourceRoot":"","sources":["../src/http-compiler.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,0BAA0B,EAG3B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACrE,OAAO,EAAiB,KAAK,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC9E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAIpD,MAAM,MAAM,oBAAoB,GAAG;IACjC,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,CAAC;IACrC,QAAQ,CAAC,OAAO,EAAE,gBAAgB,CAAC;IACnC,QAAQ,CAAC,iBAAiB,EAAE,UAAU,CACpC,OAAO,0BAA0B,CAClC,CAAC,UAAU,CAAC,CAAC;IACd,QAAQ,CAAC,cAAc,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3C,QAAQ,CAAC,UAAU,EAAE,SAAS,oBAAoB,EAAE,CAAC;CACtD,CAAC;AAEF,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,iBAAiB,EAC3B,OAAO,EAAE,gBAAgB,EACzB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EAAE,GACf,oBAAoB,CAyBtB;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,gBAAgB,CAE5E;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,WAAW,CAElE"}

package/dist/http-compiler.js

@@ -0,0 +1,37 @@
+import { compileParameterExclusions, PARAMETER_BINDING_ISSUE_KIND, } from "./binding-compiler.js";
+import { describeEntry } from "./introspection.js";
+import { ownedArray, ownedRecord } from "./owned.js";
+import { isChannelPayload, PAYLOAD_KIND } from "./tree-internal.js";
+export function compileHttpBinding(endpoint, binding, location, issues) {
+    const compilation = compileParameterExclusions(endpoint.entry, binding.exclude);
+    issues.push(...compilation.issues.map((issue) => formatHttpParameterBindingIssue(location, issue)));
+    const parameterNames = compilation.bindings.map((compiled) => compiled.parameter.name);
+    const exposed = new Set(parameterNames);
+    return ownedRecord({
+        endpoint,
+        binding,
+        parameterBindings: compilation.bindings,
+        parameterNames: ownedArray(parameterNames),
+        parameters: ownedArray(describeEntry(endpoint.entry).parameters.filter((parameter) => exposed.has(parameter.name))),
+    });
+}
+export function isHttpEntryBinding(value) {
+    return isChannelPayload(PAYLOAD_KIND.httpBinding, value);
+}
+export function isHttpSegment(value) {
+    return isChannelPayload(PAYLOAD_KIND.httpSegment, value);
+}
+function formatHttpParameterBindingIssue(location, issue) {
+    switch (issue.kind) {
+        case PARAMETER_BINDING_ISSUE_KIND.duplicate:
+            return `${location}: duplicate exposed HTTP parameter ${issue.parameterName}`;
+        case PARAMETER_BINDING_ISSUE_KIND.duplicateExclusion:
+            return `${location}: duplicate HTTP exclusion for parameter ${issue.parameterName}`;
+        case PARAMETER_BINDING_ISSUE_KIND.nonexistentExclusion:
+            return `${location}: HTTP binding excludes nonexistent parameter ${issue.parameterName}`;
+        case PARAMETER_BINDING_ISSUE_KIND.nonexistent:
+            return `${location}: HTTP exposes nonexistent parameter ${issue.parameterName}`;
+        case PARAMETER_BINDING_ISSUE_KIND.requiredUnreachable:
+            return `${location}: required parameter ${issue.parameterName} is unreachable from HTTP`;
+    }
+}

package/dist/http-model.d.ts

@@ -0,0 +1,42 @@
+import type { ParameterDescription } from "./introspection.js";
+import type { ChannelSegmentOverride, EntryChannelBinding, RawValueMap } from "./model.js";
+import type { InputPlan, Registration } from "./registration.js";
+import { CHANNEL } from "./values.js";
+export declare const HTTP_METHOD: {
+    readonly get: "GET";
+    readonly post: "POST";
+};
+export type HttpMethod = string;
+export type HttpEntryBinding<Method extends string = string, Excluded extends readonly string[] = readonly string[]> = {
+    readonly method: Method;
+    readonly exclude: Excluded;
+};
+export type HttpSegment = {
+    readonly segment: string;
+};
+export declare function bindHttpEntry<const Method extends string = typeof HTTP_METHOD.post, const Excluded extends readonly string[] = readonly []>(input?: {
+    readonly method?: Method;
+    readonly exclude?: Excluded;
+}): EntryChannelBinding<typeof CHANNEL.http, HttpEntryBinding<Method, Excluded>>;
+export declare function overrideHttpSegment(segment: {
+    readonly segment: string;
+}): ChannelSegmentOverride<typeof CHANNEL.http, HttpSegment>;
+export type HttpQueryMap = {
+    readonly [key: string]: string | readonly string[];
+};
+export type HttpInputPlan<Values extends RawValueMap, Input> = InputPlan<Values, Input> & {
+    readonly parseQuery: (raw: HttpQueryMap) => Input;
+};
+export type HttpRegistration<Values extends RawValueMap, Input, Context, Output> = Omit<Registration<Values, Input, Context, Output>, "binding" | "input"> & {
+    readonly binding: EntryChannelBinding<typeof CHANNEL.http, HttpEntryBinding>;
+    readonly method: string;
+    readonly path: string;
+    readonly segments: readonly string[];
+    readonly parameters: readonly ParameterDescription[];
+    readonly input: HttpInputPlan<Values, Input>;
+};
+export interface HttpRouteCollection<Context, Output> {
+    readonly length: number;
+    readonly forEach: (visit: <Values extends RawValueMap, Input>(item: HttpRegistration<Values, Input, Context, Output>) => void) => void;
+}
+//# sourceMappingURL=http-model.d.ts.map

package/dist/http-model.d.ts.map

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

package/dist/http-model.js

@@ -0,0 +1,20 @@
+import { ownedArray, ownedRecord } from "./owned.js";
+import { createChannelSegmentOverride, createEntryChannelBinding, PAYLOAD_KIND, registerChannelPayload, } from "./tree-internal.js";
+import { CHANNEL } from "./values.js";
+export const HTTP_METHOD = {
+    get: "GET",
+    post: "POST",
+};
+export function bindHttpEntry(input) {
+    const payload = ownedRecord({
+        method: input?.method ?? HTTP_METHOD.post,
+        exclude: ownedArray(input?.exclude ?? []),
+    });
+    registerChannelPayload(PAYLOAD_KIND.httpBinding, payload);
+    return createEntryChannelBinding(CHANNEL.http, payload);
+}
+export function overrideHttpSegment(segment) {
+    const payload = ownedRecord({ segment: segment.segment });
+    registerChannelPayload(PAYLOAD_KIND.httpSegment, payload);
+    return createChannelSegmentOverride(CHANNEL.http, payload);
+}

package/dist/http-tree.d.ts

@@ -0,0 +1,7 @@
+import type { HttpRouteCollection } from "./http-model.js";
+import { type ContextFor, type EndpointForChannel, type EndpointsOfSource, type EntryTreeSource, type OutputFor } from "./registration.js";
+import { CHANNEL } from "./values.js";
+type HttpEndpointFor<Source extends EntryTreeSource> = EndpointForChannel<EndpointsOfSource<Source>, typeof CHANNEL.http>;
+export declare function collectHttpRoutes<const Source extends EntryTreeSource>(source: Source): HttpRouteCollection<ContextFor<HttpEndpointFor<Source>>, OutputFor<HttpEndpointFor<Source>>>;
+export {};
+//# sourceMappingURL=http-tree.d.ts.map

package/dist/http-tree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-tree.d.ts","sourceRoot":"","sources":["../src/http-tree.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAGV,mBAAmB,EACpB,MAAM,iBAAiB,CAAC;AASzB,OAAO,EACL,KAAK,UAAU,EACf,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACpB,KAAK,SAAS,EAEf,MAAM,mBAAmB,CAAC;AAU3B,OAAO,EACL,OAAO,EAGR,MAAM,aAAa,CAAC;AAErB,KAAK,eAAe,CAAC,MAAM,SAAS,eAAe,IAAI,kBAAkB,CACvE,iBAAiB,CAAC,MAAM,CAAC,EACzB,OAAO,OAAO,CAAC,IAAI,CACpB,CAAC;AAQF,wBAAgB,iBAAiB,CAAC,KAAK,CAAC,MAAM,SAAS,eAAe,EACpE,MAAM,EAAE,MAAM,GACb,mBAAmB,CACpB,UAAU,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,EACnC,SAAS,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,CACnC,CAgDA"}

package/dist/http-tree.js

@@ -0,0 +1,181 @@
+import { compileHttpBinding, isHttpEntryBinding, isHttpSegment, } from "./http-compiler.js";
+import { compileInputPlan } from "./input-compiler.js";
+import { ownedArray, ownedRecord } from "./owned.js";
+import { packRegistrationCollection, } from "./registration.js";
+import { EntryInputError } from "./runtime.js";
+import { EntryTreeDefinitionError, findChannelBinding, formatTreePath, isEntryTreeDefinition, validateEntryTreeStructure, } from "./schema.js";
+import { coerceStringValue } from "./string-coercion.js";
+import { CHANNEL, ENTRY_INPUT_TARGET_KIND, VALUE_SHAPE_KIND, } from "./values.js";
+export function collectHttpRoutes(source) {
+    const structuralIssues = validateEntryTreeStructure(source);
+    if (structuralIssues.length > 0) {
+        throw new EntryTreeDefinitionError(structuralIssues);
+    }
+    const issues = [];
+    const registrations = [];
+    const tree = isEntryTreeDefinition(source);
+    const root = sourceRoot(source);
+    const rootSegments = tree ? [] : [httpSegmentFor(root, [root.name], issues)];
+    const pending = [
+        {
+            node: root,
+            logicalPath: [root.name],
+            segments: rootSegments,
+        },
+    ];
+    while (pending.length > 0) {
+        const frame = pending.pop();
+        if (frame === undefined) {
+            continue;
+        }
+        compileNodeRoutes(frame, registrations, issues);
+        for (let index = frame.node.children.length - 1; index >= 0; index -= 1) {
+            const child = frame.node.children[index];
+            if (child !== undefined) {
+                const logicalPath = [...frame.logicalPath, child.name];
+                pending.push({
+                    node: child,
+                    logicalPath,
+                    segments: [
+                        ...frame.segments,
+                        httpSegmentFor(child, logicalPath, issues),
+                    ],
+                });
+            }
+        }
+    }
+    const unique = deduplicateRoutes(registrations, issues);
+    if (issues.length > 0) {
+        throw new EntryTreeDefinitionError(issues);
+    }
+    return packRegistrationCollection(unique);
+}
+function compileNodeRoutes(frame, output, issues) {
+    const endpoints = [...new Set(frame.node.endpoints)];
+    for (const endpoint of endpoints) {
+        const channelBinding = findChannelBinding(endpoint, CHANNEL.http);
+        if (channelBinding === null) {
+            continue;
+        }
+        const location = `${formatTreePath(frame.logicalPath)}#${endpoint.entry.name}`;
+        if (!isHttpChannelBinding(channelBinding)) {
+            issues.push(`${location}: invalid HTTP endpoint binding`);
+            continue;
+        }
+        const method = channelBinding.binding.method;
+        if (method.length === 0 || /\s/u.test(method)) {
+            issues.push(`${location}: HTTP method must be non-empty and contain no whitespace`);
+        }
+        const compiled = compileHttpBinding(endpoint, channelBinding.binding, location, issues);
+        output.push(createHttpRegistration(endpoint, channelBinding, compiled, frame.segments));
+    }
+}
+function createHttpRegistration(endpoint, channelBinding, compiled, segments) {
+    const input = compileInputPlan({
+        entry: endpoint.entry,
+        bindings: compiled.parameterBindings,
+    });
+    const parseQuery = (raw) => input.parseCoerced(raw, coerceHttpQueryValue);
+    return ownedRecord({
+        endpoint,
+        entry: endpoint.entry,
+        binding: channelBinding,
+        method: compiled.binding.method,
+        path: `/${segments.join("/")}`,
+        segments: ownedArray(segments),
+        parameters: compiled.parameters,
+        input: ownedRecord({
+            schema: input.schema,
+            parse: input.parse,
+            project: input.project,
+            parseQuery,
+        }),
+        handler: endpoint.handler,
+    });
+}
+function coerceHttpQueryValue(parameter, raw) {
+    if (parameter.codec.shape.kind === VALUE_SHAPE_KIND.array) {
+        if (!isHttpQueryValue(raw)) {
+            throw parameterInputError(parameter.name, "HTTP query value must be a string or string array");
+        }
+        return coerceStringValue(parameter.codec.shape, raw);
+    }
+    const scalar = scalarQueryValue(parameter.name, raw);
+    return coerceStringValue(parameter.codec.shape, scalar);
+}
+function scalarQueryValue(parameterName, raw) {
+    if (typeof raw === "string") {
+        return raw;
+    }
+    if (!Array.isArray(raw) || !raw.every((item) => typeof item === "string")) {
+        throw parameterInputError(parameterName, "HTTP query scalar must be a string or one-element array");
+    }
+    if (raw.length !== 1) {
+        throw parameterInputError(parameterName, raw.length === 0
+            ? "HTTP query scalar must not be an empty array"
+            : "Duplicate HTTP query scalar");
+    }
+    const value = raw[0];
+    if (value === undefined) {
+        throw parameterInputError(parameterName, "HTTP query scalar is missing");
+    }
+    return value;
+}
+function parameterInputError(parameterName, issue) {
+    return new EntryInputError([issue], {
+        kind: ENTRY_INPUT_TARGET_KIND.parameter,
+        parameterName,
+    });
+}
+function isHttpQueryValue(raw) {
+    return (typeof raw === "string" ||
+        (Array.isArray(raw) && raw.every((item) => typeof item === "string")));
+}
+function httpSegmentFor(node, path, issues) {
+    const override = node.segments.find((row) => row.channel === CHANNEL.http);
+    let segment = node.name;
+    if (override !== undefined) {
+        if (!isHttpSegment(override.segment)) {
+            issues.push(`${formatTreePath(path)}: invalid HTTP segment override`);
+        }
+        else {
+            segment = override.segment.segment;
+        }
+    }
+    if (segment.length === 0 ||
+        segment.includes("/") ||
+        /\s/u.test(segment) ||
+        containsControlCharacter(segment)) {
+        issues.push(`${formatTreePath(path)}: HTTP segment must be non-empty and contain no slash, whitespace, or control character`);
+    }
+    return segment;
+}
+function containsControlCharacter(value) {
+    for (const character of value) {
+        const codePoint = character.codePointAt(0);
+        if (codePoint !== undefined && (codePoint <= 31 || codePoint === 127)) {
+            return true;
+        }
+    }
+    return false;
+}
+function deduplicateRoutes(routes, issues) {
+    const indexed = new Map();
+    for (const route of routes) {
+        const key = JSON.stringify([route.method, route.path]);
+        const existing = indexed.get(key);
+        if (existing === undefined) {
+            indexed.set(key, route);
+        }
+        else if (existing.endpoint !== route.endpoint) {
+            issues.push(`HTTP route ${route.method} ${route.path} is owned by different endpoints`);
+        }
+    }
+    return [...indexed.values()];
+}
+function sourceRoot(source) {
+    return isEntryTreeDefinition(source) ? source.root : source;
+}
+function isHttpChannelBinding(binding) {
+    return (binding.channel === CHANNEL.http && isHttpEntryBinding(binding.binding));
+}

package/dist/http.d.ts

@@ -0,0 +1,3 @@
+export * from "./http-model.js";
+export { collectHttpRoutes } from "./http-tree.js";
+//# sourceMappingURL=http.d.ts.map

package/dist/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../src/http.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/http.js

@@ -0,0 +1,2 @@
+export * from "./http-model.js";
+export { collectHttpRoutes } from "./http-tree.js";

package/dist/index.d.ts

@@ -1,8 +1,9 @@
 export * from "./codecs.js";
-export * from "./contract.js";
+export { createOutputContract, EntryOutputContractError, requireEntryOutput, verifyEntryOutput, } from "./contract.js";
 export * from "./factory.js";
 export * from "./introspection.js";
 export * from "./model.js";
+export type { CollectionContext, ContextArgs, ContextFor, ContextOf, HandlerView, InputPlan, OutputFor, ReadonlyEndpointMetadata, ReadonlyEntryMetadata, Registration, } from "./registration.js";
 export { EntryInputError, type EntryInputTarget } from "./runtime.js";
 export { EntryTreeDefinitionError } from "./schema.js";
 export * from "./values.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC;AACnC,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,eAAe,EAAE,KAAK,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACtE,OAAO,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AACvD,cAAc,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,OAAO,EACL,oBAAoB,EACpB,wBAAwB,EACxB,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,eAAe,CAAC;AACvB,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC;AACnC,cAAc,YAAY,CAAC;AAC3B,YAAY,EACV,iBAAiB,EACjB,WAAW,EACX,UAAU,EACV,SAAS,EACT,WAAW,EACX,SAAS,EACT,SAAS,EACT,wBAAwB,EACxB,qBAAqB,EACrB,YAAY,GACb,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,eAAe,EAAE,KAAK,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACtE,OAAO,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AACvD,cAAc,aAAa,CAAC"}