@earendil-works/chord 1.4.0 → 1.5.0

package/dist/next/link/values.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"values.d.ts","sourceRoot":"","sources":["../../../src/next/link/values.ts"],"names":[],"mappings":"AAKA,OAAO,EAAgB,KAAK,IAAI,EAAE,MAAM,WAAW,CAAC;AAKpD,yFAAyF;AACzF,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAE/C;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAC1B,KAAK,EAAE,OAAO,EACd,KAAK,EAAE,OAAO,GACZ;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,UAAU,EAAE,GAAG,SAAS,CAAA;CAAE,CAexE;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,OAAO,CAE5D;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,EAAE,QAAQ,EAAE,SAAS,UAAU,EAAE,GAAG,SAAS,GAAG,OAAO,CAG5G;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAG3C;AAED,+GAA+G;AAC/G,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAO7C;AAED,qEAAqE;AACrE,wBAAgB,SAAS,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAEpD;AAED,qEAAqE;AACrE,wBAAgB,QAAQ,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAElD;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,UAAU,EAAE,GAAG,OAAO,CAmBxF"}

package/dist/next/link/values.js

@@ -0,0 +1,117 @@
+// Values in messages (§3 values, §22): JSON text, and for payloads marked as carrying bytes raw byte segments, a
+// `Uint8Array` leaf written as `{"$bytes": i}` and read back as a view of the received message (no copy, never
+// base64); a part as the text codec splices it. Shared by the codecs.
+import { invalid } from "../data/internal.js";
+import { DeflatedPart } from "./part.js";
+/** Strict, and a leading U+FEFF is data, not a byte order mark to strip. */
+const STRICT_UTF8 = new TextDecoder("utf-8", { fatal: true, ignoreBOM: true });
+/** A JSON part at its origin: the value's JSON text (state and params are JSON only). */
+export function jsonPart(value) {
+    return JSON.stringify(value) ?? "null";
+}
+/**
+ * A payload part at its origin (arguments, a result): its JSON and, when `bytes` (its method's schema has a `bytes()`
+ * leaf), its byte segments: each `Uint8Array` leaf becomes a segment, and an own key `$bytes`, reserved there, fails
+ * `invalid/args`; otherwise plain JSON, where `$bytes` is ordinary data. `undefined` (a handler returning nothing) is
+ * `null`.
+ */
+export function payloadPart(value, bytes) {
+    if (!bytes)
+        return { json: jsonPart(value), segments: undefined };
+    const segments = [];
+    const json = JSON.stringify(value, (_key, leaf) => {
+        if (leaf instanceof Uint8Array) {
+            segments.push(leaf);
+            return { $bytes: segments.length - 1 };
+        }
+        // The replacer does not see the markers it returns, only their fields.
+        if (typeof leaf === "object" && leaf !== null && Object.hasOwn(leaf, "$bytes")) {
+            throw invalid("args", '"$bytes" is reserved in values crossing a link');
+        }
+        return leaf;
+    });
+    return { json: json ?? "null", segments };
+}
+/**
+ * Parses a part's JSON where it is owned, once opened (`openPart`). Throws on a part that is no strict UTF-8 JSON (a
+ * protocol error).
+ */
+export function parsePart(json) {
+    return typeof json === "string" ? JSON.parse(json) : parseJson(json);
+}
+/**
+ * Parses a payload part's JSON where it is owned, once opened, its `{"$bytes": i}` references resolved to views of
+ * `segments` when it has them. Throws on a malformed part (a protocol error).
+ */
+export function parsePayload(json, segments) {
+    const value = parsePart(json);
+    return segments === undefined ? value : resolveSegments(value, segments);
+}
+/**
+ * A part as the text codec splices it into its tuple, tagged so that no JSON value is reserved: `[0, json]` for a plain
+ * part, `[1, base64]` for a deflated one. Throws on invalid UTF-8.
+ */
+export function partText(part) {
+    if (part instanceof DeflatedPart)
+        return `[1,"${base64(part.bytes)}"]`;
+    return `[0,${typeof part === "string" ? part : readUtf8(part)}]`;
+}
+/** A part from its place in a text tuple (`partText` reversed). Throws on anything else (a protocol error). */
+export function textPart(value) {
+    // Trust boundary: fresh JSON from the text decoder.
+    if (!Array.isArray(value) || value.length !== 2)
+        throw new Error("text: a part is no [codec, payload] pair");
+    const [codec, payload] = value;
+    if (codec === 0)
+        return JSON.stringify(payload);
+    if (codec === 1 && typeof payload === "string")
+        return new DeflatedPart(fromBase64(payload));
+    throw new Error("text: a part of an unknown codec");
+}
+/** Strict UTF-8 JSON. Throws on anything else (a protocol error). */
+export function parseJson(bytes) {
+    return JSON.parse(STRICT_UTF8.decode(bytes));
+}
+/** Strict UTF-8 text. Throws on invalid UTF-8 (a protocol error). */
+export function readUtf8(bytes) {
+    return STRICT_UTF8.decode(bytes);
+}
+/**
+ * Replaces every `{"$bytes": i}` in a freshly decoded payload with segment `i`, in place. Throws on a malformed
+ * reference (a protocol error).
+ */
+export function resolveSegments(value, segments) {
+    if (typeof value !== "object" || value === null)
+        return value;
+    // Trust boundary: fresh JSON from the link, owned by this decode.
+    const node = value;
+    if (!Array.isArray(node) && Object.hasOwn(node, "$bytes")) {
+        const index = node.$bytes;
+        if (Object.keys(node).length !== 1 || typeof index !== "number" || segments[index] === undefined) {
+            throw new Error("payload: a malformed byte segment reference");
+        }
+        return segments[index];
+    }
+    for (const key of Object.keys(node)) {
+        const child = node[key];
+        const resolved = resolveSegments(child, segments);
+        // Defined, not assigned: a key `__proto__` is an own property of parsed JSON.
+        if (resolved !== child)
+            Object.defineProperty(node, key, { value: resolved, writable: true, enumerable: true, configurable: true });
+    }
+    return node;
+}
+/** Bytes as base64 (the text codec's deflated parts; portable: `btoa` over a binary string, in chunks). */
+function base64(bytes) {
+    let binary = "";
+    for (let offset = 0; offset < bytes.byteLength; offset += 0x8000) {
+        binary += String.fromCharCode(...bytes.subarray(offset, offset + 0x8000));
+    }
+    return btoa(binary);
+}
+/** Bytes from base64. Throws on text that is no base64 (a protocol error). */
+function fromBase64(text) {
+    const binary = atob(text);
+    return Uint8Array.from(binary, (char) => char.charCodeAt(0));
+}
+//# sourceMappingURL=values.js.map

package/dist/next/link/values.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"values.js","sourceRoot":"","sources":["../../../src/next/link/values.ts"],"names":[],"mappings":"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","sourcesContent":["// Values in messages (§3 values, §22): JSON text, and for payloads marked as carrying bytes raw byte segments, a\n// `Uint8Array` leaf written as `{\"$bytes\": i}` and read back as a view of the received message (no copy, never\n// base64); a part as the text codec splices it. Shared by the codecs.\n\nimport { invalid } from \"../data/internal.ts\";\nimport { DeflatedPart, type Part } from \"./part.ts\";\n\n/** Strict, and a leading U+FEFF is data, not a byte order mark to strip. */\nconst STRICT_UTF8 = new TextDecoder(\"utf-8\", { fatal: true, ignoreBOM: true });\n\n/** A JSON part at its origin: the value's JSON text (state and params are JSON only). */\nexport function jsonPart(value: unknown): string {\n\treturn JSON.stringify(value) ?? \"null\";\n}\n\n/**\n * A payload part at its origin (arguments, a result): its JSON and, when `bytes` (its method's schema has a `bytes()`\n * leaf), its byte segments: each `Uint8Array` leaf becomes a segment, and an own key `$bytes`, reserved there, fails\n * `invalid/args`; otherwise plain JSON, where `$bytes` is ordinary data. `undefined` (a handler returning nothing) is\n * `null`.\n */\nexport function payloadPart(\n\tvalue: unknown,\n\tbytes: boolean,\n): { readonly json: string; readonly segments: Uint8Array[] | undefined } {\n\tif (!bytes) return { json: jsonPart(value), segments: undefined };\n\tconst segments: Uint8Array[] = [];\n\tconst json = JSON.stringify(value, (_key, leaf: unknown) => {\n\t\tif (leaf instanceof Uint8Array) {\n\t\t\tsegments.push(leaf);\n\t\t\treturn { $bytes: segments.length - 1 };\n\t\t}\n\t\t// The replacer does not see the markers it returns, only their fields.\n\t\tif (typeof leaf === \"object\" && leaf !== null && Object.hasOwn(leaf, \"$bytes\")) {\n\t\t\tthrow invalid(\"args\", '\"$bytes\" is reserved in values crossing a link');\n\t\t}\n\t\treturn leaf;\n\t});\n\treturn { json: json ?? \"null\", segments };\n}\n\n/**\n * Parses a part's JSON where it is owned, once opened (`openPart`). Throws on a part that is no strict UTF-8 JSON (a\n * protocol error).\n */\nexport function parsePart(json: string | Uint8Array): unknown {\n\treturn typeof json === \"string\" ? JSON.parse(json) : parseJson(json);\n}\n\n/**\n * Parses a payload part's JSON where it is owned, once opened, its `{\"$bytes\": i}` references resolved to views of\n * `segments` when it has them. Throws on a malformed part (a protocol error).\n */\nexport function parsePayload(json: string | Uint8Array, segments: readonly Uint8Array[] | undefined): unknown {\n\tconst value = parsePart(json);\n\treturn segments === undefined ? value : resolveSegments(value, segments);\n}\n\n/**\n * A part as the text codec splices it into its tuple, tagged so that no JSON value is reserved: `[0, json]` for a plain\n * part, `[1, base64]` for a deflated one. Throws on invalid UTF-8.\n */\nexport function partText(part: Part): string {\n\tif (part instanceof DeflatedPart) return `[1,\"${base64(part.bytes)}\"]`;\n\treturn `[0,${typeof part === \"string\" ? part : readUtf8(part)}]`;\n}\n\n/** A part from its place in a text tuple (`partText` reversed). Throws on anything else (a protocol error). */\nexport function textPart(value: unknown): Part {\n\t// Trust boundary: fresh JSON from the text decoder.\n\tif (!Array.isArray(value) || value.length !== 2) throw new Error(\"text: a part is no [codec, payload] pair\");\n\tconst [codec, payload] = value as [unknown, unknown];\n\tif (codec === 0) return JSON.stringify(payload);\n\tif (codec === 1 && typeof payload === \"string\") return new DeflatedPart(fromBase64(payload));\n\tthrow new Error(\"text: a part of an unknown codec\");\n}\n\n/** Strict UTF-8 JSON. Throws on anything else (a protocol error). */\nexport function parseJson(bytes: Uint8Array): unknown {\n\treturn JSON.parse(STRICT_UTF8.decode(bytes));\n}\n\n/** Strict UTF-8 text. Throws on invalid UTF-8 (a protocol error). */\nexport function readUtf8(bytes: Uint8Array): string {\n\treturn STRICT_UTF8.decode(bytes);\n}\n\n/**\n * Replaces every `{\"$bytes\": i}` in a freshly decoded payload with segment `i`, in place. Throws on a malformed\n * reference (a protocol error).\n */\nexport function resolveSegments(value: unknown, segments: readonly Uint8Array[]): unknown {\n\tif (typeof value !== \"object\" || value === null) return value;\n\t// Trust boundary: fresh JSON from the link, owned by this decode.\n\tconst node = value as Record<string, unknown>;\n\tif (!Array.isArray(node) && Object.hasOwn(node, \"$bytes\")) {\n\t\tconst index = node.$bytes;\n\t\tif (Object.keys(node).length !== 1 || typeof index !== \"number\" || segments[index] === undefined) {\n\t\t\tthrow new Error(\"payload: a malformed byte segment reference\");\n\t\t}\n\t\treturn segments[index];\n\t}\n\tfor (const key of Object.keys(node)) {\n\t\tconst child = node[key];\n\t\tconst resolved = resolveSegments(child, segments);\n\t\t// Defined, not assigned: a key `__proto__` is an own property of parsed JSON.\n\t\tif (resolved !== child)\n\t\t\tObject.defineProperty(node, key, { value: resolved, writable: true, enumerable: true, configurable: true });\n\t}\n\treturn node;\n}\n\n/** Bytes as base64 (the text codec's deflated parts; portable: `btoa` over a binary string, in chunks). */\nfunction base64(bytes: Uint8Array): string {\n\tlet binary = \"\";\n\tfor (let offset = 0; offset < bytes.byteLength; offset += 0x8000) {\n\t\tbinary += String.fromCharCode(...bytes.subarray(offset, offset + 0x8000));\n\t}\n\treturn btoa(binary);\n}\n\n/** Bytes from base64. Throws on text that is no base64 (a protocol error). */\nfunction fromBase64(text: string): Uint8Array {\n\tconst binary = atob(text);\n\treturn Uint8Array.from(binary, (char) => char.charCodeAt(0));\n}\n"]}

package/dist/next/link/websocket.d.ts

@@ -0,0 +1,26 @@
+import { type Link } from "./link.ts";
+/** The part of a WebSocket a link uses (the browser's `WebSocket`, `ws`'s `WebSocket`). */
+export interface WebSocketLike {
+    /** 0 connecting, 1 open, 2 closing, 3 closed. */
+    readonly readyState: number;
+    binaryType: string;
+    /** Typed as the browser's `WebSocket` takes bytes: on an `ArrayBuffer`, never shared memory. */
+    send(data: Uint8Array<ArrayBuffer>): void;
+    close(): void;
+    addEventListener(type: "open" | "close" | "error", listener: () => void): void;
+    addEventListener(type: "message", listener: (event: {
+        readonly data: unknown;
+    }) => void): void;
+    removeEventListener(type: "open" | "close" | "error", listener: () => void): void;
+    removeEventListener(type: "message", listener: (event: {
+        readonly data: unknown;
+    }) => void): void;
+}
+/**
+ * A link over `socket`, one binary frame per message (`binaryType = "arraybuffer"`). Messages sent while it connects
+ * wait for `open`; a socket closing or closed already gives a closed link; `close` and `error` close the link once, and
+ * so does a text frame (no message of this protocol). A frame above the transport's `maxPayload` closes the socket
+ * (code 1009), which closes the link.
+ */
+export declare function webSocketLink(socket: WebSocketLike): Link;
+//# sourceMappingURL=websocket.d.ts.map

package/dist/next/link/websocket.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"websocket.d.ts","sourceRoot":"","sources":["../../../src/next/link/websocket.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,IAAI,EAAW,MAAM,WAAW,CAAC;AAE/C,2FAA2F;AAC3F,MAAM,WAAW,aAAa;IAC7B,iDAAiD;IACjD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,gGAAgG;IAChG,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC,WAAW,CAAC,GAAG,IAAI,CAAC;IAC1C,KAAK,IAAI,IAAI,CAAC;IACd,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,OAAO,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;IAC/E,gBAAgB,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAA;KAAE,KAAK,IAAI,GAAG,IAAI,CAAC;IAC/F,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,OAAO,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;IAClF,mBAAmB,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAA;KAAE,KAAK,IAAI,GAAG,IAAI,CAAC;CAClG;AAMD;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,CAEzD"}

package/dist/next/link/websocket.js

@@ -0,0 +1,91 @@
+// WebSocket links (§3): a link over a WebSocket, the browser's or `ws` in Node, typed structurally; binary frames,
+// messages sent while it still connects buffered until it opens.
+import { LinkEnd } from "./link.js";
+const CONNECTING = 0;
+const OPEN = 1;
+/**
+ * A link over `socket`, one binary frame per message (`binaryType = "arraybuffer"`). Messages sent while it connects
+ * wait for `open`; a socket closing or closed already gives a closed link; `close` and `error` close the link once, and
+ * so does a text frame (no message of this protocol). A frame above the transport's `maxPayload` closes the socket
+ * (code 1009), which closes the link.
+ */
+export function webSocketLink(socket) {
+    return new WebSocketLink(socket);
+}
+class WebSocketLink extends LinkEnd {
+    /** The socket while the link is open. */
+    #socket;
+    /** Messages sent while the socket connects; `undefined` once it is open. */
+    #connecting;
+    #onOpen = () => {
+        const queued = this.#connecting ?? [];
+        this.#connecting = undefined;
+        for (const message of queued)
+            this.send(message);
+    };
+    #onMessage = (event) => {
+        if (event.data instanceof ArrayBuffer)
+            this.deliver(new Uint8Array(event.data));
+        else
+            this.close();
+    };
+    #onError = () => this.#end();
+    constructor(socket) {
+        super();
+        if (socket.readyState !== CONNECTING && socket.readyState !== OPEN) {
+            this.ended();
+            return;
+        }
+        this.#socket = socket;
+        socket.binaryType = "arraybuffer";
+        if (socket.readyState === CONNECTING) {
+            this.#connecting = [];
+            socket.addEventListener("open", this.#onOpen);
+        }
+        socket.addEventListener("message", this.#onMessage);
+        // `error` and `close` stay handled until the socket's own close, after this end closed: `ws` emits an `error`
+        // for a socket closed while it connects, and an unhandled one would end the process.
+        const onClose = () => {
+            socket.removeEventListener("close", onClose);
+            socket.removeEventListener("error", this.#onError);
+            this.#end();
+        };
+        socket.addEventListener("close", onClose);
+        socket.addEventListener("error", this.#onError);
+    }
+    send(message) {
+        const socket = this.#socket;
+        if (socket === undefined)
+            return;
+        if (this.#connecting !== undefined) {
+            this.#connecting.push(message);
+            return;
+        }
+        try {
+            // A link's messages are codec output or received frames, both on plain `ArrayBuffer`s.
+            socket.send(message);
+        }
+        catch {
+            this.close();
+        }
+    }
+    close() {
+        const socket = this.#socket;
+        if (socket === undefined)
+            return;
+        this.#end();
+        socket.close();
+    }
+    /** Stops listening for frames, drops what waits to be sent and closes this end. */
+    #end() {
+        const socket = this.#socket;
+        if (socket === undefined)
+            return;
+        this.#socket = undefined;
+        this.#connecting = undefined;
+        socket.removeEventListener("open", this.#onOpen);
+        socket.removeEventListener("message", this.#onMessage);
+        this.ended();
+    }
+}
+//# sourceMappingURL=websocket.js.map

package/dist/next/link/websocket.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"websocket.js","sourceRoot":"","sources":["../../../src/next/link/websocket.ts"],"names":[],"mappings":"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","sourcesContent":["// WebSocket links (§3): a link over a WebSocket, the browser's or `ws` in Node, typed structurally; binary frames,\n// messages sent while it still connects buffered until it opens.\n\nimport { type Link, LinkEnd } from \"./link.ts\";\n\n/** The part of a WebSocket a link uses (the browser's `WebSocket`, `ws`'s `WebSocket`). */\nexport interface WebSocketLike {\n\t/** 0 connecting, 1 open, 2 closing, 3 closed. */\n\treadonly readyState: number;\n\tbinaryType: string;\n\t/** Typed as the browser's `WebSocket` takes bytes: on an `ArrayBuffer`, never shared memory. */\n\tsend(data: Uint8Array<ArrayBuffer>): void;\n\tclose(): void;\n\taddEventListener(type: \"open\" | \"close\" | \"error\", listener: () => void): void;\n\taddEventListener(type: \"message\", listener: (event: { readonly data: unknown }) => void): void;\n\tremoveEventListener(type: \"open\" | \"close\" | \"error\", listener: () => void): void;\n\tremoveEventListener(type: \"message\", listener: (event: { readonly data: unknown }) => void): void;\n}\n\nconst CONNECTING = 0;\n\nconst OPEN = 1;\n\n/**\n * A link over `socket`, one binary frame per message (`binaryType = \"arraybuffer\"`). Messages sent while it connects\n * wait for `open`; a socket closing or closed already gives a closed link; `close` and `error` close the link once, and\n * so does a text frame (no message of this protocol). A frame above the transport's `maxPayload` closes the socket\n * (code 1009), which closes the link.\n */\nexport function webSocketLink(socket: WebSocketLike): Link {\n\treturn new WebSocketLink(socket);\n}\n\nclass WebSocketLink extends LinkEnd {\n\t/** The socket while the link is open. */\n\t#socket: WebSocketLike | undefined;\n\t/** Messages sent while the socket connects; `undefined` once it is open. */\n\t#connecting: Uint8Array[] | undefined;\n\treadonly #onOpen = (): void => {\n\t\tconst queued = this.#connecting ?? [];\n\t\tthis.#connecting = undefined;\n\t\tfor (const message of queued) this.send(message);\n\t};\n\treadonly #onMessage = (event: { readonly data: unknown }): void => {\n\t\tif (event.data instanceof ArrayBuffer) this.deliver(new Uint8Array(event.data));\n\t\telse this.close();\n\t};\n\treadonly #onError = (): void => this.#end();\n\n\tconstructor(socket: WebSocketLike) {\n\t\tsuper();\n\t\tif (socket.readyState !== CONNECTING && socket.readyState !== OPEN) {\n\t\t\tthis.ended();\n\t\t\treturn;\n\t\t}\n\t\tthis.#socket = socket;\n\t\tsocket.binaryType = \"arraybuffer\";\n\t\tif (socket.readyState === CONNECTING) {\n\t\t\tthis.#connecting = [];\n\t\t\tsocket.addEventListener(\"open\", this.#onOpen);\n\t\t}\n\t\tsocket.addEventListener(\"message\", this.#onMessage);\n\t\t// `error` and `close` stay handled until the socket's own close, after this end closed: `ws` emits an `error`\n\t\t// for a socket closed while it connects, and an unhandled one would end the process.\n\t\tconst onClose = (): void => {\n\t\t\tsocket.removeEventListener(\"close\", onClose);\n\t\t\tsocket.removeEventListener(\"error\", this.#onError);\n\t\t\tthis.#end();\n\t\t};\n\t\tsocket.addEventListener(\"close\", onClose);\n\t\tsocket.addEventListener(\"error\", this.#onError);\n\t}\n\n\tsend(message: Uint8Array): void {\n\t\tconst socket = this.#socket;\n\t\tif (socket === undefined) return;\n\t\tif (this.#connecting !== undefined) {\n\t\t\tthis.#connecting.push(message);\n\t\t\treturn;\n\t\t}\n\t\ttry {\n\t\t\t// A link's messages are codec output or received frames, both on plain `ArrayBuffer`s.\n\t\t\tsocket.send(message as Uint8Array<ArrayBuffer>);\n\t\t} catch {\n\t\t\tthis.close();\n\t\t}\n\t}\n\n\tclose(): void {\n\t\tconst socket = this.#socket;\n\t\tif (socket === undefined) return;\n\t\tthis.#end();\n\t\tsocket.close();\n\t}\n\n\t/** Stops listening for frames, drops what waits to be sent and closes this end. */\n\t#end(): void {\n\t\tconst socket = this.#socket;\n\t\tif (socket === undefined) return;\n\t\tthis.#socket = undefined;\n\t\tthis.#connecting = undefined;\n\t\tsocket.removeEventListener(\"open\", this.#onOpen);\n\t\tsocket.removeEventListener(\"message\", this.#onMessage);\n\t\tthis.ended();\n\t}\n}\n"]}

package/dist/next/registries/contribution.d.ts

@@ -0,0 +1,50 @@
+import { type Dependent, type DeriveSource, type NativeSource } from "../state/internal.ts";
+import type { RegistryRecord } from "./record.ts";
+import type { RegistryEntry, RegistryProvider } from "./registry.ts";
+/** Who contributes: a facet (by plugin) or a host-lifetime object (by plugin and type). */
+export type Contributor = {
+    readonly plugin: string;
+    readonly type: string | undefined;
+};
+/**
+ * What a contribution is: a plain value, a Chord JSON watchable (a source or a constant), or a native source; the
+ * watchables followed for their value.
+ */
+export type ContributionContent = {
+    readonly kind: "plain";
+    readonly value: unknown;
+} | {
+    readonly kind: "json";
+    readonly source: DeriveSource;
+} | {
+    readonly kind: "native";
+    readonly source: NativeSource;
+};
+/**
+ * One contributor's contribution to a registry: a plain value, or a Chord source it follows as a dependent (a change
+ * marks the registry's table). Its table entry is made once per value (an older version's adapted once per value);
+ * a failure or refusal leaves it out, reported once per episode.
+ */
+export declare class RegistryContribution implements Dependent {
+    #private;
+    /** The registry it contributes to. */
+    readonly record: RegistryRecord;
+    readonly contributor: Contributor;
+    /** The registry version its contributor was built against. */
+    readonly version: number;
+    constructor(record: RegistryRecord, contributor: Contributor, version: number, content: ContributionContent);
+    /** Its source changed (inside a batch): the registry's table is marked. */
+    invalidate(): void;
+    /** A retirement of its source's document changes nothing beyond the value. */
+    sourceRetired(): void;
+    /** Starts following its source, if it has one. */
+    follow(): void;
+    /** Stops following its source. */
+    unfollow(): void;
+    /**
+     * Its entry in a table of the provider at `version`: the same object while its value is the same; `undefined` when
+     * left out (a refused version, a failing source, a throwing adapter).
+     */
+    entry(version: number, provider: RegistryProvider<unknown, unknown>): RegistryEntry<unknown> | undefined;
+}
+//# sourceMappingURL=contribution.d.ts.map

package/dist/next/registries/contribution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contribution.d.ts","sourceRoot":"","sources":["../../../src/next/registries/contribution.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,SAAS,EAAE,KAAK,YAAY,EAAa,KAAK,YAAY,EAAU,MAAM,sBAAsB,CAAC;AAC/G,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,KAAK,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAErE,2FAA2F;AAC3F,MAAM,MAAM,WAAW,GAAG;IAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAC;AAEzF;;;GAGG;AACH,MAAM,MAAM,mBAAmB,GAC5B;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;CAAE,GACnD;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAA;CAAE,GACxD;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAA;CAAE,CAAC;AAE9D;;;;GAIG;AACH,qBAAa,oBAAqB,YAAW,SAAS;;IACrD,sCAAsC;IACtC,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAClC,8DAA8D;IAC9D,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAQzB,YAAY,MAAM,EAAE,cAAc,EAAE,WAAW,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,mBAAmB,EAK1G;IAED,2EAA2E;IAC3E,UAAU,IAAI,IAAI,CAEjB;IAED,8EAA8E;IAC9E,aAAa,IAAI,IAAI,CAAG;IAExB,kDAAkD;IAClD,MAAM,IAAI,IAAI,CAGb;IAED,kCAAkC;IAClC,QAAQ,IAAI,IAAI,CAEf;IASD;;;OAGG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,gBAAgB,CAAC,OAAO,EAAE,OAAO,CAAC,GAAG,aAAa,CAAC,OAAO,CAAC,GAAG,SAAS,CAqBvG;CAqDD"}

package/dist/next/registries/contribution.js

@@ -0,0 +1,129 @@
+// One contributor's contribution to a registry (slice 8 §1): its table entry, made once per value (an older version's
+// adapted once per value), followed when it is a Chord watchable, left out and reported when it fails or is refused.
+import { handedOut, Source } from "../state/internal.js";
+/**
+ * One contributor's contribution to a registry: a plain value, or a Chord source it follows as a dependent (a change
+ * marks the registry's table). Its table entry is made once per value (an older version's adapted once per value);
+ * a failure or refusal leaves it out, reported once per episode.
+ */
+export class RegistryContribution {
+    /** The registry it contributes to. */
+    record;
+    contributor;
+    /** The registry version its contributor was built against. */
+    version;
+    #content;
+    /** The last adaptation of an older contribution: the value and adapter it was made from, and its result. */
+    #adapted;
+    #entry;
+    /** Left out since its last entry: failing (reported once), or refused (reported once). */
+    #out = "none";
+    constructor(record, contributor, version, content) {
+        this.record = record;
+        this.contributor = contributor;
+        this.version = version;
+        this.#content = content;
+    }
+    /** Its source changed (inside a batch): the registry's table is marked. */
+    invalidate() {
+        this.record.contributionChanged();
+    }
+    /** A retirement of its source's document changes nothing beyond the value. */
+    sourceRetired() { }
+    /** Starts following its source, if it has one. */
+    follow() {
+        const source = this.#followed();
+        source?.dependents.add(this);
+    }
+    /** Stops following its source. */
+    unfollow() {
+        this.#followed()?.dependents.delete(this);
+    }
+    /** Its source when it changes (a constant never does). */
+    #followed() {
+        const content = this.#content;
+        if (content.kind === "native")
+            return content.source;
+        return content.kind === "json" && content.source instanceof Source ? content.source : undefined;
+    }
+    /**
+     * Its entry in a table of the provider at `version`: the same object while its value is the same; `undefined` when
+     * left out (a refused version, a failing source, a throwing adapter).
+     */
+    entry(version, provider) {
+        const adapter = this.version < version ? provider.accepts?.[this.version]?.contribution : undefined;
+        if (this.version > version || (this.version < version && adapter === undefined)) {
+            if (this.#out !== "refused")
+                this.#refused();
+            return undefined;
+        }
+        let value;
+        try {
+            const raw = this.#raw();
+            value = adapter === undefined ? raw : this.#adapt(raw, adapter);
+        }
+        catch (error) {
+            if (this.#out !== "failed")
+                this.#failed(error);
+            return undefined;
+        }
+        this.#out = "none";
+        const entry = this.#entry;
+        // `undefined` is a value: the entry, not its field, says whether there was one.
+        if (entry !== undefined && entry.value === value)
+            return entry;
+        const { plugin, type } = this.contributor;
+        this.#entry = { plugin, ...(type === undefined ? {} : { type }), version: this.version, value };
+        return this.#entry;
+    }
+    /**
+     * The contributed value now: a JSON source's value throws while it is failed or ended; a native source that failed
+     * (a registry whose `compose` threw) keeps a last good value for its readers, but is left out here as failed.
+     */
+    #raw() {
+        const content = this.#content;
+        switch (content.kind) {
+            case "plain":
+                return content.value;
+            case "json":
+                return content.source.value;
+            case "native":
+                return content.source.current();
+        }
+    }
+    #adapt(raw, adapter) {
+        const adapted = this.#adapted;
+        if (adapted !== undefined && adapted.from === raw && adapted.adapter === adapter)
+            return adapted.value;
+        const value = this.record.adapt(() => adapter(raw));
+        this.#adapted = { from: raw, adapter, value };
+        return value;
+    }
+    #refused() {
+        this.#out = "refused";
+        const { plugin, type } = this.contributor;
+        const registry = this.record.name;
+        const where = type === undefined ? {} : { type };
+        this.record.reportContribution({
+            kind: "contribution_refused",
+            registry,
+            plugin,
+            ...where,
+            version: this.version,
+        });
+    }
+    #failed(error) {
+        this.#out = "failed";
+        const { plugin, type } = this.contributor;
+        const registry = this.record.name;
+        const where = type === undefined ? {} : { type };
+        this.record.reportContribution({
+            kind: "contribution_failed",
+            registry,
+            plugin,
+            ...where,
+            error: handedOut(error),
+        });
+    }
+}
+//# sourceMappingURL=contribution.js.map

package/dist/next/registries/contribution.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contribution.js","sourceRoot":"","sources":["../../../src/next/registries/contribution.ts"],"names":[],"mappings":"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","sourcesContent":["// One contributor's contribution to a registry (slice 8 §1): its table entry, made once per value (an older version's\n// adapted once per value), followed when it is a Chord watchable, left out and reported when it fails or is refused.\n\nimport { type Dependent, type DeriveSource, handedOut, type NativeSource, Source } from \"../state/internal.ts\";\nimport type { RegistryRecord } from \"./record.ts\";\nimport type { RegistryEntry, RegistryProvider } from \"./registry.ts\";\n\n/** Who contributes: a facet (by plugin) or a host-lifetime object (by plugin and type). */\nexport type Contributor = { readonly plugin: string; readonly type: string | undefined };\n\n/**\n * What a contribution is: a plain value, a Chord JSON watchable (a source or a constant), or a native source; the\n * watchables followed for their value.\n */\nexport type ContributionContent =\n\t| { readonly kind: \"plain\"; readonly value: unknown }\n\t| { readonly kind: \"json\"; readonly source: DeriveSource }\n\t| { readonly kind: \"native\"; readonly source: NativeSource };\n\n/**\n * One contributor's contribution to a registry: a plain value, or a Chord source it follows as a dependent (a change\n * marks the registry's table). Its table entry is made once per value (an older version's adapted once per value);\n * a failure or refusal leaves it out, reported once per episode.\n */\nexport class RegistryContribution implements Dependent {\n\t/** The registry it contributes to. */\n\treadonly record: RegistryRecord;\n\treadonly contributor: Contributor;\n\t/** The registry version its contributor was built against. */\n\treadonly version: number;\n\treadonly #content: ContributionContent;\n\t/** The last adaptation of an older contribution: the value and adapter it was made from, and its result. */\n\t#adapted: { readonly from: unknown; readonly adapter: (old: never) => unknown; readonly value: unknown } | undefined;\n\t#entry: RegistryEntry<unknown> | undefined;\n\t/** Left out since its last entry: failing (reported once), or refused (reported once). */\n\t#out: \"none\" | \"failed\" | \"refused\" = \"none\";\n\n\tconstructor(record: RegistryRecord, contributor: Contributor, version: number, content: ContributionContent) {\n\t\tthis.record = record;\n\t\tthis.contributor = contributor;\n\t\tthis.version = version;\n\t\tthis.#content = content;\n\t}\n\n\t/** Its source changed (inside a batch): the registry's table is marked. */\n\tinvalidate(): void {\n\t\tthis.record.contributionChanged();\n\t}\n\n\t/** A retirement of its source's document changes nothing beyond the value. */\n\tsourceRetired(): void {}\n\n\t/** Starts following its source, if it has one. */\n\tfollow(): void {\n\t\tconst source = this.#followed();\n\t\tsource?.dependents.add(this);\n\t}\n\n\t/** Stops following its source. */\n\tunfollow(): void {\n\t\tthis.#followed()?.dependents.delete(this);\n\t}\n\n\t/** Its source when it changes (a constant never does). */\n\t#followed(): Source | NativeSource | undefined {\n\t\tconst content = this.#content;\n\t\tif (content.kind === \"native\") return content.source;\n\t\treturn content.kind === \"json\" && content.source instanceof Source ? content.source : undefined;\n\t}\n\n\t/**\n\t * Its entry in a table of the provider at `version`: the same object while its value is the same; `undefined` when\n\t * left out (a refused version, a failing source, a throwing adapter).\n\t */\n\tentry(version: number, provider: RegistryProvider<unknown, unknown>): RegistryEntry<unknown> | undefined {\n\t\tconst adapter = this.version < version ? provider.accepts?.[this.version]?.contribution : undefined;\n\t\tif (this.version > version || (this.version < version && adapter === undefined)) {\n\t\t\tif (this.#out !== \"refused\") this.#refused();\n\t\t\treturn undefined;\n\t\t}\n\t\tlet value: unknown;\n\t\ttry {\n\t\t\tconst raw = this.#raw();\n\t\t\tvalue = adapter === undefined ? raw : this.#adapt(raw, adapter);\n\t\t} catch (error) {\n\t\t\tif (this.#out !== \"failed\") this.#failed(error);\n\t\t\treturn undefined;\n\t\t}\n\t\tthis.#out = \"none\";\n\t\tconst entry = this.#entry;\n\t\t// `undefined` is a value: the entry, not its field, says whether there was one.\n\t\tif (entry !== undefined && entry.value === value) return entry;\n\t\tconst { plugin, type } = this.contributor;\n\t\tthis.#entry = { plugin, ...(type === undefined ? {} : { type }), version: this.version, value };\n\t\treturn this.#entry;\n\t}\n\n\t/**\n\t * The contributed value now: a JSON source's value throws while it is failed or ended; a native source that failed\n\t * (a registry whose `compose` threw) keeps a last good value for its readers, but is left out here as failed.\n\t */\n\t#raw(): unknown {\n\t\tconst content = this.#content;\n\t\tswitch (content.kind) {\n\t\t\tcase \"plain\":\n\t\t\t\treturn content.value;\n\t\t\tcase \"json\":\n\t\t\t\treturn content.source.value;\n\t\t\tcase \"native\":\n\t\t\t\treturn content.source.current();\n\t\t}\n\t}\n\n\t#adapt(raw: unknown, adapter: (old: never) => unknown): unknown {\n\t\tconst adapted = this.#adapted;\n\t\tif (adapted !== undefined && adapted.from === raw && adapted.adapter === adapter) return adapted.value;\n\t\tconst value = this.record.adapt(() => adapter(raw as never));\n\t\tthis.#adapted = { from: raw, adapter, value };\n\t\treturn value;\n\t}\n\n\t#refused(): void {\n\t\tthis.#out = \"refused\";\n\t\tconst { plugin, type } = this.contributor;\n\t\tconst registry = this.record.name;\n\t\tconst where = type === undefined ? {} : { type };\n\t\tthis.record.reportContribution({\n\t\t\tkind: \"contribution_refused\",\n\t\t\tregistry,\n\t\t\tplugin,\n\t\t\t...where,\n\t\t\tversion: this.version,\n\t\t});\n\t}\n\n\t#failed(error: unknown): void {\n\t\tthis.#out = \"failed\";\n\t\tconst { plugin, type } = this.contributor;\n\t\tconst registry = this.record.name;\n\t\tconst where = type === undefined ? {} : { type };\n\t\tthis.record.reportContribution({\n\t\t\tkind: \"contribution_failed\",\n\t\t\tregistry,\n\t\t\tplugin,\n\t\t\t...where,\n\t\t\terror: handedOut(error),\n\t\t});\n\t}\n}\n"]}

package/dist/next/registries/entries.d.ts

@@ -0,0 +1,18 @@
+import type { ComposeContext, RegistryTable } from "./registry.ts";
+/** An item taken from a table, with the contributor it came from. */
+export type TableItem<I> = {
+    readonly value: I;
+    readonly plugin: string;
+    readonly type?: string;
+};
+/**
+ * A map of every entry's keyed items (`entriesOf`, e.g. its routes), in table order: a key taken already is reported
+ * through `report` (`compose`'s) naming both plugins, and the first by plugin name keeps it.
+ */
+export declare function keyedEntries<C, I>(table: RegistryTable<C>, entriesOf: (value: C) => Readonly<Record<string, I>> | undefined, report: ComposeContext["report"]): ReadonlyMap<string, TableItem<I>>;
+/**
+ * Every entry's items (`itemsOf`) in one list: in table order, or sorted by `orderOf` (a phase's index, for example),
+ * table order kept among equals.
+ */
+export declare function orderedEntries<C, I>(table: RegistryTable<C>, itemsOf: (value: C) => readonly I[] | undefined, orderOf?: (item: I) => number): readonly TableItem<I>[];
+//# sourceMappingURL=entries.d.ts.map

package/dist/next/registries/entries.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entries.d.ts","sourceRoot":"","sources":["../../../src/next/registries/entries.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAEnE,qEAAqE;AACrE,MAAM,MAAM,SAAS,CAAC,CAAC,IAAI;IAAE,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAElG;;;GAGG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,CAAC,EAChC,KAAK,EAAE,aAAa,CAAC,CAAC,CAAC,EACvB,SAAS,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,GAAG,SAAS,EAChE,MAAM,EAAE,cAAc,CAAC,QAAQ,CAAC,GAC9B,WAAW,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,CAenC;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,CAAC,EAClC,KAAK,EAAE,aAAa,CAAC,CAAC,CAAC,EACvB,OAAO,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,SAAS,CAAC,EAAE,GAAG,SAAS,EAC/C,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,GAC3B,SAAS,SAAS,CAAC,CAAC,CAAC,EAAE,CAQzB"}

package/dist/next/registries/entries.js

@@ -0,0 +1,42 @@
+// Table helpers for `compose` (slice 8 §1, Q8): a map by key (the first by plugin name wins, duplicates reported) and
+// an ordered list; both keep each item's plugin, so a use site reports the contributor of an entry that throws.
+/**
+ * A map of every entry's keyed items (`entriesOf`, e.g. its routes), in table order: a key taken already is reported
+ * through `report` (`compose`'s) naming both plugins, and the first by plugin name keeps it.
+ */
+export function keyedEntries(table, entriesOf, report) {
+    const map = new Map();
+    for (const entry of table) {
+        const items = entriesOf(entry.value);
+        if (items === undefined)
+            continue;
+        for (const [key, value] of Object.entries(items)) {
+            const taken = map.get(key);
+            if (taken !== undefined) {
+                report({ message: `"${key}" is contributed twice`, plugins: [taken.plugin, entry.plugin] });
+                continue;
+            }
+            map.set(key, item(value, entry.plugin, entry.type));
+        }
+    }
+    return map;
+}
+/**
+ * Every entry's items (`itemsOf`) in one list: in table order, or sorted by `orderOf` (a phase's index, for example),
+ * table order kept among equals.
+ */
+export function orderedEntries(table, itemsOf, orderOf) {
+    const items = [];
+    for (const entry of table) {
+        for (const value of itemsOf(entry.value) ?? [])
+            items.push(item(value, entry.plugin, entry.type));
+    }
+    // `sort` is stable: equal orders keep table order.
+    if (orderOf !== undefined)
+        items.sort((a, b) => orderOf(a.value) - orderOf(b.value));
+    return items;
+}
+function item(value, plugin, type) {
+    return type === undefined ? { value, plugin } : { value, plugin, type };
+}
+//# sourceMappingURL=entries.js.map

package/dist/next/registries/entries.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entries.js","sourceRoot":"","sources":["../../../src/next/registries/entries.ts"],"names":[],"mappings":"AAAA,sHAAsH;AACtH,gHAAgH;AAOhH;;;GAGG;AACH,MAAM,UAAU,YAAY,CAC3B,KAAuB,EACvB,SAAgE,EAChE,MAAgC;IAEhC,MAAM,GAAG,GAAG,IAAI,GAAG,EAAwB,CAAC;IAC5C,KAAK,MAAM,KAAK,IAAI,KAAK,EAAE,CAAC;QAC3B,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACrC,IAAI,KAAK,KAAK,SAAS;YAAE,SAAS;QAClC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YAClD,MAAM,KAAK,GAAG,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAC3B,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;gBACzB,MAAM,CAAC,EAAE,OAAO,EAAE,IAAI,GAAG,wBAAwB,EAAE,OAAO,EAAE,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;gBAC5F,SAAS;YACV,CAAC;YACD,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,KAAK,EAAE,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;QACrD,CAAC;IACF,CAAC;IACD,OAAO,GAAG,CAAC;AACZ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAC7B,KAAuB,EACvB,OAA+C,EAC/C,OAA6B;IAE7B,MAAM,KAAK,GAAmB,EAAE,CAAC;IACjC,KAAK,MAAM,KAAK,IAAI,KAAK,EAAE,CAAC;QAC3B,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE;YAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;IACnG,CAAC;IACD,mDAAmD;IACnD,IAAI,OAAO,KAAK,SAAS;QAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;IACrF,OAAO,KAAK,CAAC;AACd,CAAC;AAED,SAAS,IAAI,CAAI,KAAQ,EAAE,MAAc,EAAE,IAAwB;IAClE,OAAO,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;AACzE,CAAC","sourcesContent":["// Table helpers for `compose` (slice 8 §1, Q8): a map by key (the first by plugin name wins, duplicates reported) and\n// an ordered list; both keep each item's plugin, so a use site reports the contributor of an entry that throws.\n\nimport type { ComposeContext, RegistryTable } from \"./registry.ts\";\n\n/** An item taken from a table, with the contributor it came from. */\nexport type TableItem<I> = { readonly value: I; readonly plugin: string; readonly type?: string };\n\n/**\n * A map of every entry's keyed items (`entriesOf`, e.g. its routes), in table order: a key taken already is reported\n * through `report` (`compose`'s) naming both plugins, and the first by plugin name keeps it.\n */\nexport function keyedEntries<C, I>(\n\ttable: RegistryTable<C>,\n\tentriesOf: (value: C) => Readonly<Record<string, I>> | undefined,\n\treport: ComposeContext[\"report\"],\n): ReadonlyMap<string, TableItem<I>> {\n\tconst map = new Map<string, TableItem<I>>();\n\tfor (const entry of table) {\n\t\tconst items = entriesOf(entry.value);\n\t\tif (items === undefined) continue;\n\t\tfor (const [key, value] of Object.entries(items)) {\n\t\t\tconst taken = map.get(key);\n\t\t\tif (taken !== undefined) {\n\t\t\t\treport({ message: `\"${key}\" is contributed twice`, plugins: [taken.plugin, entry.plugin] });\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\tmap.set(key, item(value, entry.plugin, entry.type));\n\t\t}\n\t}\n\treturn map;\n}\n\n/**\n * Every entry's items (`itemsOf`) in one list: in table order, or sorted by `orderOf` (a phase's index, for example),\n * table order kept among equals.\n */\nexport function orderedEntries<C, I>(\n\ttable: RegistryTable<C>,\n\titemsOf: (value: C) => readonly I[] | undefined,\n\torderOf?: (item: I) => number,\n): readonly TableItem<I>[] {\n\tconst items: TableItem<I>[] = [];\n\tfor (const entry of table) {\n\t\tfor (const value of itemsOf(entry.value) ?? []) items.push(item(value, entry.plugin, entry.type));\n\t}\n\t// `sort` is stable: equal orders keep table order.\n\tif (orderOf !== undefined) items.sort((a, b) => orderOf(a.value) - orderOf(b.value));\n\treturn items;\n}\n\nfunction item<I>(value: I, plugin: string, type: string | undefined): TableItem<I> {\n\treturn type === undefined ? { value, plugin } : { value, plugin, type };\n}\n"]}

package/dist/next/registries/index.d.ts

@@ -0,0 +1,3 @@
+export { keyedEntries, orderedEntries, type TableItem } from "./entries.ts";
+export { type ComposeContext, type Contribution, defineRegistry, type Registry, type RegistryAccepts, type RegistryConflict, type RegistryEntry, type RegistryProvider, type RegistryTable, type RegistryValue, } from "./registry.ts";
+//# sourceMappingURL=index.d.ts.map

package/dist/next/registries/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/next/registries/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAC5E,OAAO,EACN,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,cAAc,EACd,KAAK,QAAQ,EACb,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,aAAa,EAClB,KAAK,gBAAgB,EACrB,KAAK,aAAa,EAClB,KAAK,aAAa,GAClB,MAAM,eAAe,CAAC"}

package/dist/next/registries/index.js

@@ -0,0 +1,5 @@
+// Registries for apps: tokens, what a provider serves them with, the table `compose` gets and its helpers, and the
+// composed value readers follow.
+export { keyedEntries, orderedEntries } from "./entries.js";
+export { defineRegistry, } from "./registry.js";
+//# sourceMappingURL=index.js.map

package/dist/next/registries/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/next/registries/index.ts"],"names":[],"mappings":"AAAA,mHAAmH;AACnH,iCAAiC;AAEjC,OAAO,EAAE,YAAY,EAAE,cAAc,EAAkB,MAAM,cAAc,CAAC;AAC5E,OAAO,EAGN,cAAc,GAQd,MAAM,eAAe,CAAC","sourcesContent":["// Registries for apps: tokens, what a provider serves them with, the table `compose` gets and its helpers, and the\n// composed value readers follow.\n\nexport { keyedEntries, orderedEntries, type TableItem } from \"./entries.ts\";\nexport {\n\ttype ComposeContext,\n\ttype Contribution,\n\tdefineRegistry,\n\ttype Registry,\n\ttype RegistryAccepts,\n\ttype RegistryConflict,\n\ttype RegistryEntry,\n\ttype RegistryProvider,\n\ttype RegistryTable,\n\ttype RegistryValue,\n} from \"./registry.ts\";\n"]}

package/dist/next/registries/internal.d.ts

@@ -0,0 +1,4 @@
+export { type ContributionContent, type Contributor, RegistryContribution } from "./contribution.ts";
+export { checkProvider, type RegistryError, RegistryRecord } from "./record.ts";
+export { RegistryValueSource, type RegistryWaiter } from "./value.ts";
+//# sourceMappingURL=internal.d.ts.map

package/dist/next/registries/internal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal.d.ts","sourceRoot":"","sources":["../../../src/next/registries/internal.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,mBAAmB,EAAE,KAAK,WAAW,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AACrG,OAAO,EAAE,aAAa,EAAE,KAAK,aAAa,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAChF,OAAO,EAAE,mBAAmB,EAAE,KAAK,cAAc,EAAE,MAAM,YAAY,CAAC"}

package/dist/next/registries/internal.js

@@ -0,0 +1,5 @@
+// Registries for Chord's layers: a host's record of each registry, its contributions and its values by version.
+export { RegistryContribution } from "./contribution.js";
+export { checkProvider, RegistryRecord } from "./record.js";
+export { RegistryValueSource } from "./value.js";
+//# sourceMappingURL=internal.js.map

package/dist/next/registries/internal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal.js","sourceRoot":"","sources":["../../../src/next/registries/internal.ts"],"names":[],"mappings":"AAAA,gHAAgH;AAEhH,OAAO,EAA8C,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AACrG,OAAO,EAAE,aAAa,EAAsB,cAAc,EAAE,MAAM,aAAa,CAAC;AAChF,OAAO,EAAE,mBAAmB,EAAuB,MAAM,YAAY,CAAC","sourcesContent":["// Registries for Chord's layers: a host's record of each registry, its contributions and its values by version.\n\nexport { type ContributionContent, type Contributor, RegistryContribution } from \"./contribution.ts\";\nexport { checkProvider, type RegistryError, RegistryRecord } from \"./record.ts\";\nexport { RegistryValueSource, type RegistryWaiter } from \"./value.ts\";\n"]}