@fgv/ts-utils 5.1.0-4 → 5.1.0-40

package/lib/packlets/base/shouldNotFail.js

@@ -0,0 +1,129 @@
+"use strict";
+/*
+ * Copyright (c) 2026 Erik Fortune
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports._parseStackFrame = _parseStackFrame;
+exports._findShouldNotFailFrame = _findShouldNotFailFrame;
+exports._normalizeShouldNotFailFnName = _normalizeShouldNotFailFnName;
+exports._formatShouldNotFailMessage = _formatShouldNotFailMessage;
+/**
+ * Parses a single stack-trace line in either V8 or WebKit format.
+ *
+ * V8: `    at <fn> (<file>:<line>:<col>)` or `    at <file>:<line>:<col>`
+ * WebKit: `<fn>@<file>:<line>:<col>` or `@<file>:<line>:<col>`
+ * @internal
+ */
+function _parseStackFrame(line) {
+    const trimmed = line.trim();
+    const v8WithFn = /^at\s+(.+?)\s+\((.+):(\d+):\d+\)$/.exec(trimmed);
+    if (v8WithFn) {
+        return { fn: v8WithFn[1], file: v8WithFn[2], line: Number(v8WithFn[3]) };
+    }
+    const v8NoFn = /^at\s+(.+):(\d+):\d+$/.exec(trimmed);
+    if (v8NoFn) {
+        return { file: v8NoFn[1], line: Number(v8NoFn[2]) };
+    }
+    const webkit = /^(.*?)@(.+):(\d+):\d+$/.exec(trimmed);
+    if (webkit) {
+        return { fn: webkit[1] === '' ? undefined : webkit[1], file: webkit[2], line: Number(webkit[3]) };
+    }
+    return {};
+}
+/**
+ * Finds the caller frame at the supplied depth in a stack string.
+ *
+ * Filters out frames whose **parsed function name** contains `shouldNotFail`
+ * (the file path is deliberately NOT inspected — consumer test files may
+ * themselves be named after `shouldNotFail` and their frames must not be
+ * filtered out). Covers both the V8 path — where `Error.captureStackTrace`
+ * should have done this already but the extra filter is harmless — and the
+ * WebKit fallback path where `captureStackTrace` is unavailable. `frameDepth`
+ * is 1-indexed: `1` selects the immediate caller.
+ * @internal
+ */
+function _findShouldNotFailFrame(stack, frameDepth) {
+    var _a;
+    if (!stack) {
+        return {};
+    }
+    const userFrames = [];
+    for (const line of stack.split('\n')) {
+        if (!/^\s*at\s|@/.test(line)) {
+            continue;
+        }
+        const parsed = _parseStackFrame(line);
+        if (parsed.file === undefined && parsed.fn === undefined) {
+            continue;
+        }
+        // Filter by parsed function name only — never by raw line text, since the
+        // file path may itself contain 'shouldNotFail' (e.g. consumer test files).
+        if (parsed.fn !== undefined && parsed.fn.includes('shouldNotFail')) {
+            continue;
+        }
+        userFrames.push(parsed);
+    }
+    return (_a = userFrames[frameDepth - 1]) !== null && _a !== void 0 ? _a : {};
+}
+/**
+ * Normalizes a function name from a stack frame, returning `undefined` when
+ * the name is empty or one of the well-known anonymous-IIFE noise patterns
+ * (typically emitted by V8 for module-top-level code).
+ * @internal
+ */
+function _normalizeShouldNotFailFnName(fn) {
+    if (fn === undefined || fn === '' || fn === '<anonymous>' || fn === 'Object.<anonymous>') {
+        return undefined;
+    }
+    return fn;
+}
+/**
+ * Composes the error message thrown by `Result<T>.shouldNotFail` from the
+ * captured frame and optional label.
+ * @internal
+ */
+function _formatShouldNotFailMessage(originalMessage, label, frame) {
+    const fn = _normalizeShouldNotFailFnName(frame.fn);
+    const fileLoc = frame.file !== undefined && frame.line !== undefined ? `${frame.file}:${frame.line}` : undefined;
+    if (label !== undefined) {
+        if (fn !== undefined && fileLoc !== undefined) {
+            return `${label} (at ${fn} in ${fileLoc}): ${originalMessage}`;
+        }
+        if (fileLoc !== undefined) {
+            return `${label} (at ${fileLoc}): ${originalMessage}`;
+        }
+        if (fn !== undefined) {
+            return `${label} (at ${fn}): ${originalMessage}`;
+        }
+        return `${label}: ${originalMessage}`;
+    }
+    if (fn !== undefined && fileLoc !== undefined) {
+        return `${fn} at ${fileLoc}: ${originalMessage}`;
+    }
+    if (fileLoc !== undefined) {
+        return `${fileLoc}: ${originalMessage}`;
+    }
+    if (fn !== undefined) {
+        return `${fn}: ${originalMessage}`;
+    }
+    return originalMessage;
+}
+//# sourceMappingURL=shouldNotFail.js.map

package/lib/packlets/base/shouldNotFail.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shouldNotFail.js","sourceRoot":"","sources":["../../../src/packlets/base/shouldNotFail.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * Copyright (c) 2026 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\n/**\n * Internal helpers for `Result<T>.shouldNotFail()`. Parsing and message\n * composition live here so the `Result` class file stays focused on the\n * Result hierarchy itself; the helpers are exported with the `_` prefix\n * convention and `@internal` tag so unit tests can cover them directly\n * without adding test-only public exports.\n */\n\n/**\n * Parsed stack-frame information used by `Result<T>.shouldNotFail`.\n * All fields are optional — runtimes that don't expose stack traces produce\n * an empty frame and the call site is omitted from the message.\n * @internal\n */\nexport interface _IShouldNotFailFrame {\n  fn?: string;\n  file?: string;\n  line?: number;\n}\n\n/**\n * Parses a single stack-trace line in either V8 or WebKit format.\n *\n * V8: `    at <fn> (<file>:<line>:<col>)` or `    at <file>:<line>:<col>`\n * WebKit: `<fn>@<file>:<line>:<col>` or `@<file>:<line>:<col>`\n * @internal\n */\nexport function _parseStackFrame(line: string): _IShouldNotFailFrame {\n  const trimmed = line.trim();\n  const v8WithFn = /^at\\s+(.+?)\\s+\\((.+):(\\d+):\\d+\\)$/.exec(trimmed);\n  if (v8WithFn) {\n    return { fn: v8WithFn[1], file: v8WithFn[2], line: Number(v8WithFn[3]) };\n  }\n  const v8NoFn = /^at\\s+(.+):(\\d+):\\d+$/.exec(trimmed);\n  if (v8NoFn) {\n    return { file: v8NoFn[1], line: Number(v8NoFn[2]) };\n  }\n  const webkit = /^(.*?)@(.+):(\\d+):\\d+$/.exec(trimmed);\n  if (webkit) {\n    return { fn: webkit[1] === '' ? undefined : webkit[1], file: webkit[2], line: Number(webkit[3]) };\n  }\n  return {};\n}\n\n/**\n * Finds the caller frame at the supplied depth in a stack string.\n *\n * Filters out frames whose **parsed function name** contains `shouldNotFail`\n * (the file path is deliberately NOT inspected — consumer test files may\n * themselves be named after `shouldNotFail` and their frames must not be\n * filtered out). Covers both the V8 path — where `Error.captureStackTrace`\n * should have done this already but the extra filter is harmless — and the\n * WebKit fallback path where `captureStackTrace` is unavailable. `frameDepth`\n * is 1-indexed: `1` selects the immediate caller.\n * @internal\n */\nexport function _findShouldNotFailFrame(stack: string | undefined, frameDepth: number): _IShouldNotFailFrame {\n  if (!stack) {\n    return {};\n  }\n  const userFrames: _IShouldNotFailFrame[] = [];\n  for (const line of stack.split('\\n')) {\n    if (!/^\\s*at\\s|@/.test(line)) {\n      continue;\n    }\n    const parsed = _parseStackFrame(line);\n    if (parsed.file === undefined && parsed.fn === undefined) {\n      continue;\n    }\n    // Filter by parsed function name only — never by raw line text, since the\n    // file path may itself contain 'shouldNotFail' (e.g. consumer test files).\n    if (parsed.fn !== undefined && parsed.fn.includes('shouldNotFail')) {\n      continue;\n    }\n    userFrames.push(parsed);\n  }\n  return userFrames[frameDepth - 1] ?? {};\n}\n\n/**\n * Normalizes a function name from a stack frame, returning `undefined` when\n * the name is empty or one of the well-known anonymous-IIFE noise patterns\n * (typically emitted by V8 for module-top-level code).\n * @internal\n */\nexport function _normalizeShouldNotFailFnName(fn: string | undefined): string | undefined {\n  if (fn === undefined || fn === '' || fn === '<anonymous>' || fn === 'Object.<anonymous>') {\n    return undefined;\n  }\n  return fn;\n}\n\n/**\n * Composes the error message thrown by `Result<T>.shouldNotFail` from the\n * captured frame and optional label.\n * @internal\n */\nexport function _formatShouldNotFailMessage(\n  originalMessage: string,\n  label: string | undefined,\n  frame: _IShouldNotFailFrame\n): string {\n  const fn = _normalizeShouldNotFailFnName(frame.fn);\n  const fileLoc =\n    frame.file !== undefined && frame.line !== undefined ? `${frame.file}:${frame.line}` : undefined;\n\n  if (label !== undefined) {\n    if (fn !== undefined && fileLoc !== undefined) {\n      return `${label} (at ${fn} in ${fileLoc}): ${originalMessage}`;\n    }\n    if (fileLoc !== undefined) {\n      return `${label} (at ${fileLoc}): ${originalMessage}`;\n    }\n    if (fn !== undefined) {\n      return `${label} (at ${fn}): ${originalMessage}`;\n    }\n    return `${label}: ${originalMessage}`;\n  }\n  if (fn !== undefined && fileLoc !== undefined) {\n    return `${fn} at ${fileLoc}: ${originalMessage}`;\n  }\n  if (fileLoc !== undefined) {\n    return `${fileLoc}: ${originalMessage}`;\n  }\n  if (fn !== undefined) {\n    return `${fn}: ${originalMessage}`;\n  }\n  return originalMessage;\n}\n"]}

package/lib/packlets/base/utils.d.ts

@@ -1,4 +1,16 @@
 import { Result } from './result';
+/**
+ * Union of all values in an array/tuple type, preserving literal types if possible.
+ * If T is not an array/tuple, results in `never`.
+ * @public
+ */
+export type OneOf<T> = T extends readonly unknown[] ? T[number] : never;
+/**
+ * Union of all string values in an array/tuple type, preserving literal types if possible.
+ * If T is not an array/tuple, results in `never`.
+ * @public
+ */
+export type StringOneOf<T> = Extract<OneOf<T>, string>;
 /**
  * Helper type-guard function to report whether a specified key is present in
  * a supplied object.

package/lib/packlets/base/utils.d.ts.map

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

package/lib/packlets/base/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../src/packlets/base/utils.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;AA0BH,0BAEC;AAUD,oBAQC;AAWD,oBAOC;AAQD,sCAEC;AAQD,0CAEC;AAQD,4CAEC;AAQD,8CAEC;AAiBD,kCAEC;AAaD,kEAMC;AAaD,8CAeC;AAgBD,kCAgBC;AAUD,kDAKC;AAUD,4EAKC;AAUD,kCAgBC;AAUD,kDAKC;AAUD,4EAKC;AA9RD,qCAAiD;AAgBjD;;;;;;;GAOG;AACH,SAAgB,OAAO,CAAmB,GAA6B,EAAE,IAAO;IAC9E,OAAO,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC;AAClC,CAAC;AAED;;;;;;;GAOG;AACH,SAAgB,IAAI,CAAsC,IAAO,EAAE,OAAY;IAC7E,MAAM,IAAI,GAAwB,EAAE,CAAC;IACrC,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;QAC1B,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC;YAChB,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC;QACxB,CAAC;IACH,CAAC;IACD,OAAO,IAAkB,CAAC;AAC5B,CAAC;AAED;;;;;;;;GAQG;AACH,SAAgB,IAAI,CAAsC,IAAO,EAAE,OAAY;IAC7E,MAAM,IAAI,GAAwB,EAAE,CAAC;IACrC,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAiB,CAAC,CAAC,EAAE,CAAC;QAChG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAgC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IAC3D,CAAC;IAED,OAAO,IAAkB,CAAC;AAC5B,CAAC;AAED;;;;;GAKG;AACH,SAAgB,aAAa,CAAoB,GAAwB;IACvE,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,CAAS,CAAC;AAClC,CAAC;AAED;;;;;GAKG;AACH,SAAgB,eAAe,CAAwB,GAAmB;IACxE,OAAO,MAAM,CAAC,MAAM,CAAC,GAAG,CAAS,CAAC;AACpC,CAAC;AAED;;;;;GAKG;AACH,SAAgB,gBAAgB,CAAwB,GAAmB;IACzE,OAAO,MAAM,CAAC,OAAO,CAAC,GAAG,CAAoB,CAAC;AAChD,CAAC;AAED;;;;;GAKG;AACH,SAAgB,iBAAiB,CAAwB,OAA2B;IAClF,OAAO,MAAM,CAAC,WAAW,CAAC,OAAO,CAAmB,CAAC;AACvD,CAAC;AASD;;;;;;;GAOG;AACH,SAAgB,WAAW,CAAI,KAAQ;IACrC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAyB,CAAC;AAC1E,CAAC;AAED;;;;;;;;;;GAUG;AACH,SAAgB,2BAA2B,CACzC,GAA6B,EAC7B,IAAO,EACP,YAAsB;IAEtB,OAAO,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC;AACvD,CAAC;AAED;;;;;;;;;;GAUG;AACH,SAAgB,iBAAiB,CAC/B,GAA6B,EAC7B,IAAO;IAYP,OAAO,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AAC3D,CAAC;AAQD;;;;;;;GAOG;AACH,SAAgB,WAAW,CACzB,GAAmB,EACnB,OAAsC;IAEtC,MAAM,GAAG,GAAG,IAAI,GAAG,EAAU,CAAC;IAC9B,KAAK,MAAM,GAAG,IAAI,GAAG,EAAE,CAAC;QACtB,IAAI,GAAG,CAAC,GAAG,CAAC,KAAK,SAAS,EAAE,CAAC;YAC3B,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;YAC1C,IAAI,UAAU,CAAC,SAAS,EAAE,EAAE,CAAC;gBAC3B,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,UAAU,CAAC,KAAK,CAAC,CAAC;YACjC,CAAC;iBAAM,CAAC;gBACN,OAAO,IAAA,aAAI,EAAC,GAAG,GAAG,KAAK,UAAU,CAAC,OAAO,EAAE,CAAC,CAAC;YAC/C,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,IAAA,gBAAO,EAAC,GAAG,CAAC,CAAC;AACtB,CAAC;AAED;;;;;;;GAOG;AACH,SAAgB,mBAAmB,CACjC,GAA+B,EAC/B,OAAsC;IAEtC,OAAO,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,IAAA,gBAAO,EAAC,SAAS,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;AAC5E,CAAC;AAED;;;;;;;GAOG;AACH,SAAgB,gCAAgC,CAC9C,GAA+B,EAC/B,OAAsC;IAEtC,OAAO,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,IAAA,gBAAO,EAAC,IAAI,GAAG,EAAU,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;AACpF,CAAC;AAED;;;;;;;GAOG;AACH,SAAgB,WAAW,CACzB,GAAwB,EACxB,OAAsC;IAEtC,MAAM,MAAM,GAAmB,EAAoB,CAAC;IACpD,KAAK,MAAM,GAAG,IAAI,GAAG,EAAE,CAAC;QACtB,IAAI,GAAG,CAAC,CAAC,CAAC,KAAK,SAAS,EAAE,CAAC;YACzB,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;YAC3C,IAAI,UAAU,CAAC,SAAS,EAAE,EAAE,CAAC;gBAC3B,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,KAAK,CAAC;YACpC,CAAC;iBAAM,CAAC;gBACN,OAAO,IAAA,aAAI,EAAC,GAAG,GAAG,CAAC,CAAC,CAAC,KAAK,UAAU,CAAC,OAAO,EAAE,CAAC,CAAC;YAClD,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,IAAA,gBAAO,EAAC,MAAM,CAAC,CAAC;AACzB,CAAC;AAED;;;;;;;GAOG;AACH,SAAgB,mBAAmB,CACjC,GAAoC,EACpC,OAAsC;IAEtC,OAAO,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,IAAA,gBAAO,EAAC,SAAS,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;AAC5E,CAAC;AAED;;;;;;;GAOG;AACH,SAAgB,gCAAgC,CAC9C,GAAoC,EACpC,OAAsC;IAEtC,OAAO,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,IAAA,gBAAO,EAAC,EAAoB,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;AACvF,CAAC","sourcesContent":["/*\r\n * Copyright (c) 2020 Erik Fortune\r\n *\r\n * Permission is hereby granted, free of charge, to any person obtaining a copy\r\n * of this software and associated documentation files (the \"Software\"), to deal\r\n * in the Software without restriction, including without limitation the rights\r\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\r\n * copies of the Software, and to permit persons to whom the Software is\r\n * furnished to do so, subject to the following conditions:\r\n *\r\n * The above copyright notice and this permission notice shall be included in all\r\n * copies or substantial portions of the Software.\r\n *\r\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\r\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\r\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\r\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\r\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\r\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\r\n * SOFTWARE.\r\n */\r\n\r\nimport { Result, fail, succeed } from './result';\r\n\r\n/**\r\n * Union of all values in an array/tuple type, preserving literal types if possible.\r\n * If T is not an array/tuple, results in `never`.\r\n * @public\r\n */\r\nexport type OneOf<T> = T extends readonly unknown[] ? T[number] : never;\r\n\r\n/**\r\n * Union of all string values in an array/tuple type, preserving literal types if possible.\r\n * If T is not an array/tuple, results in `never`.\r\n * @public\r\n */\r\nexport type StringOneOf<T> = Extract<OneOf<T>, string>;\r\n\r\n/**\r\n * Helper type-guard function to report whether a specified key is present in\r\n * a supplied object.\r\n * @param key - The key to be tested.\r\n * @param item - The object to be tested.\r\n * @returns Returns `true` if the key is present, `false` otherwise.\r\n * @public\r\n */\r\nexport function isKeyOf<T extends object>(key: string | number | symbol, item: T): key is keyof T {\r\n  return item.hasOwnProperty(key);\r\n}\r\n\r\n/**\r\n * Simple implicit pick function, which picks a set of properties from a supplied\r\n * object.  Ignores picked properties that do not exist regardless of type signature.\r\n * @param from - The object from which keys are to be picked.\r\n * @param include - The keys of the properties to be picked from `from`.\r\n * @returns A new object containing the requested properties from `from`, where present.\r\n * @public\r\n */\r\nexport function pick<T extends object, K extends keyof T>(from: T, include: K[]): Pick<T, K> {\r\n  const rtrn: Partial<Pick<T, K>> = {};\r\n  for (const key of include) {\r\n    if (key in from) {\r\n      rtrn[key] = from[key];\r\n    }\r\n  }\r\n  return rtrn as Pick<T, K>;\r\n}\r\n\r\n/**\r\n * Simple implicit omit function, which picks all of the properties from a supplied\r\n * object except those specified for exclusion.\r\n * @param from - The object from which keys are to be picked.\r\n * @param exclude - The keys of the properties to be excluded from the returned object.\r\n * @returns A new object containing all of the properties from `from` that were not\r\n * explicitly excluded.\r\n * @public\r\n */\r\nexport function omit<T extends object, K extends keyof T>(from: T, exclude: K[]): Omit<T, K> {\r\n  const rtrn: Partial<Omit<T, K>> = {};\r\n  for (const entry of Object.entries(from).filter((e) => !exclude.includes(e[0] as keyof T as K))) {\r\n    rtrn[entry[0] as unknown as keyof Omit<T, K>] = entry[1];\r\n  }\r\n\r\n  return rtrn as Omit<T, K>;\r\n}\r\n\r\n/**\r\n * Type-safe(ish) key extractor for typed records.\r\n * @param obj - The record from which keys are to be extracted.\r\n * @returns The keys of the record as an array.\r\n * @public\r\n */\r\nexport function keysForRecord<TK extends string>(obj: Record<TK, unknown>): TK[] {\r\n  return Object.keys(obj) as TK[];\r\n}\r\n\r\n/**\r\n * Type-safe(ish) value extractor for typed records.\r\n * @param obj - The record from which values are to be extracted.\r\n * @returns The values of the record as an array.\r\n * @public\r\n */\r\nexport function valuesForRecord<TK extends string, TV>(obj: Record<TK, TV>): TV[] {\r\n  return Object.values(obj) as TV[];\r\n}\r\n\r\n/**\r\n * Type-safe(ish) entries extractor for typed records.\r\n * @param obj - The record from which entries are to be extracted.\r\n * @returns The entries of the record as an array of `[key, value]` tuples.\r\n * @public\r\n */\r\nexport function entriesForRecord<TK extends string, TV>(obj: Record<TK, TV>): Array<[TK, TV]> {\r\n  return Object.entries(obj) as Array<[TK, TV]>;\r\n}\r\n\r\n/**\r\n * Type-safe(ish) record constructor from an iterable of `[key, value]` tuples.\r\n * @param entries - The iterable of `[key, value]` tuples from which to construct the record.\r\n * @returns A record constructed from the supplied entries.\r\n * @public\r\n */\r\nexport function recordFromEntries<TK extends string, TV>(entries: Iterable<[TK, TV]>): Record<TK, TV> {\r\n  return Object.fromEntries(entries) as Record<TK, TV>;\r\n}\r\n\r\n/**\r\n * Helper type to extract the element type and preserve readonly status.\r\n * @public\r\n */\r\n// eslint-disable-next-line @typescript-eslint/no-unused-vars\r\nexport type EnsureArrayResult<T> = T extends readonly (infer _U)[] ? T : T[];\r\n\r\n/**\r\n * Ensures the input is an array. If already an array, returns it as-is.\r\n * If a single item, wraps it in an array.\r\n * Preserves readonly status of input arrays.\r\n * @param items - A single item or an array of items.\r\n * @returns The input array unchanged, or a new array containing the single item.\r\n * @public\r\n */\r\nexport function ensureArray<T>(items: T): EnsureArrayResult<T> {\r\n  return (Array.isArray(items) ? items : [items]) as EnsureArrayResult<T>;\r\n}\r\n\r\n/**\r\n * Gets the value of a property specified by key from an arbitrary object,\r\n * or a default value if the property does not exist.\r\n * @param key - The key specifying the property to be retrieved.\r\n * @param item - The object from which the property is to be retrieved.\r\n * @param defaultValue - An optional default value to be returned if the property\r\n * is not present (default `undefined`).\r\n * @returns The value of the requested property, or the default value if the\r\n * requested property does not exist.\r\n * @public\r\n */\r\nexport function getValueOfPropertyOrDefault<T extends object>(\r\n  key: string | number | symbol,\r\n  item: T,\r\n  defaultValue?: unknown\r\n): unknown | undefined {\r\n  return isKeyOf(key, item) ? item[key] : defaultValue;\r\n}\r\n\r\n/**\r\n * Gets the type of a property specified by key from an arbitrary object.\r\n * @param key - The key specifying the property to be tested.\r\n * @param item - The object from which the property is to be tested.\r\n * @returns The type of the requested property, or `undefined` if the\r\n * property does not exist.\r\n * @example\r\n * Returns `'undefined'` (a string) if the property exists but has the value\r\n * undefined but `undefined` (the literal) if the property does not exist.\r\n * @public\r\n */\r\nexport function getTypeOfProperty<T extends object>(\r\n  key: string | number | symbol,\r\n  item: T\r\n):\r\n  | 'string'\r\n  | 'number'\r\n  | 'bigint'\r\n  | 'boolean'\r\n  | 'symbol'\r\n  | 'undefined'\r\n  | 'undefined'\r\n  | 'object'\r\n  | 'function'\r\n  | undefined {\r\n  return isKeyOf(key, item) ? typeof item[key] : undefined;\r\n}\r\n\r\n/**\r\n * Type for factory methods which convert a key-value pair to a new unique value.\r\n * @public\r\n */\r\ntype KeyedThingFactory<TS, TD, TK extends string = string> = (key: TK, thing: TS) => Result<TD>;\r\n\r\n/**\r\n * Applies a factory method to convert a `Record<TK, TS>` into a `Map<TK, TD>`.\r\n * @param src - The `Record` to be converted.\r\n * @param factory - The factory method used to convert elements.\r\n * @returns {@link Success} with the resulting map on success, or {@link Failure} with a\r\n * message if an error occurs.\r\n * @public\r\n */\r\nexport function recordToMap<TS, TD, TK extends string = string>(\r\n  src: Record<TK, TS>,\r\n  factory: KeyedThingFactory<TS, TD, TK>\r\n): Result<Map<TK, TD>> {\r\n  const map = new Map<TK, TD>();\r\n  for (const key in src) {\r\n    if (src[key] !== undefined) {\r\n      const itemResult = factory(key, src[key]);\r\n      if (itemResult.isSuccess()) {\r\n        map.set(key, itemResult.value);\r\n      } else {\r\n        return fail(`${key}: ${itemResult.message}`);\r\n      }\r\n    }\r\n  }\r\n  return succeed(map);\r\n}\r\n\r\n/**\r\n * Applies a factory method to convert an optional `Record<TK, TS>` into a `Map<TK, TD>`, or `undefined`.\r\n * @param src - The `Record` to be converted, or undefined.\r\n * @param factory - The factory method used to convert elements.\r\n * @returns {@link Success} with the resulting map if conversion succeeds, or {@link Success} with `undefined`\r\n * if `src` is `undefined`. Returns {@link Failure} with a message if an error occurs.\r\n * @public\r\n */\r\nexport function optionalRecordToMap<TS, TD, TK extends string = string>(\r\n  src: Record<TK, TS> | undefined,\r\n  factory: KeyedThingFactory<TS, TD, TK>\r\n): Result<Map<TK, TD> | undefined> {\r\n  return src === undefined ? succeed(undefined) : recordToMap(src, factory);\r\n}\r\n\r\n/**\r\n * Applies a factory method to convert an optional `Record<TK, TS>` into a `Map<TK, TD>`\r\n * @param src - The `Record` to be converted, or `undefined`.\r\n * @param factory - The factory method used to convert elements.\r\n * @returns {@link Success} with the resulting map (empty if `src` is `undefined`) if conversion succeeds.\r\n * Returns {@link Failure} with a message if an error occurs.\r\n * @public\r\n */\r\nexport function optionalRecordToPossiblyEmptyMap<TS, TD, TK extends string = string>(\r\n  src: Record<TK, TS> | undefined,\r\n  factory: KeyedThingFactory<TS, TD, TK>\r\n): Result<Map<TK, TD>> {\r\n  return src === undefined ? succeed(new Map<TK, TD>()) : recordToMap(src, factory);\r\n}\r\n\r\n/**\r\n * Applies a factory method to convert a `ReadonlyMap<TK, TS>` into a `Record<TK, TD>`.\r\n * @param src - The `Map` object to be converted.\r\n * @param factory - The factory method used to convert elements.\r\n * @returns {@link Success} with the resulting `Record<TK, TD>` if conversion succeeds, or\r\n * {@link Failure} with an error message if an error occurs.\r\n * @public\r\n */\r\nexport function mapToRecord<TS, TD, TK extends string = string>(\r\n  src: ReadonlyMap<TK, TS>,\r\n  factory: KeyedThingFactory<TS, TD, TK>\r\n): Result<Record<TK, TD>> {\r\n  const record: Record<TK, TD> = {} as Record<TK, TD>;\r\n  for (const kvp of src) {\r\n    if (kvp[1] !== undefined) {\r\n      const itemResult = factory(kvp[0], kvp[1]);\r\n      if (itemResult.isSuccess()) {\r\n        record[kvp[0]] = itemResult.value;\r\n      } else {\r\n        return fail(`${kvp[0]}: ${itemResult.message}`);\r\n      }\r\n    }\r\n  }\r\n  return succeed(record);\r\n}\r\n\r\n/**\r\n * Applies a factory method to convert an optional `ReadonlyMap<string, TS>` into a `Record<string, TD>` or `undefined`.\r\n * @param src - The `Map` object to be converted, or `undefined`.\r\n * @param factory - The factory method used to convert elements.\r\n * @returns {@link Success} with the resulting record if conversion succeeds, or {@link Success} with `undefined` if\r\n * `src` is `undefined`. Returns {@link Failure} with a message if an error occurs.\r\n * @public\r\n */\r\nexport function optionalMapToRecord<TS, TD, TK extends string = string>(\r\n  src: ReadonlyMap<TK, TS> | undefined,\r\n  factory: KeyedThingFactory<TS, TD, TK>\r\n): Result<Record<TK, TD> | undefined> {\r\n  return src === undefined ? succeed(undefined) : mapToRecord(src, factory);\r\n}\r\n\r\n/**\r\n * Applies a factory method to convert an optional `ReadonlyMap<string, TS>` into a `Record<string, TD>`\r\n * @param src - The `ReadonlyMap` object to be converted, or `undefined`.\r\n * @param factory - The factory method used to convert elements.\r\n * @returns {@link Success} with the resulting record (empty if `src` is `undefined`) if conversion succeeds.\r\n * Returns {@link Failure} with a message if an error occurs.\r\n * @public\r\n */\r\nexport function optionalMapToPossiblyEmptyRecord<TS, TD, TK extends string = string>(\r\n  src: ReadonlyMap<TK, TS> | undefined,\r\n  factory: KeyedThingFactory<TS, TD, TK>\r\n): Result<Record<TK, TD>> {\r\n  return src === undefined ? succeed({} as Record<TK, TD>) : mapToRecord(src, factory);\r\n}\r\n"]}

package/lib/packlets/base/uuid.d.ts

@@ -0,0 +1,27 @@
+import { Brand } from './brand';
+/**
+ * A canonical UUIDv4 string: 8-4-4-4-12 lowercase hex digits with version
+ * nibble `4` and variant nibble in `[89ab]`. Produced by {@link generateUuid}
+ * and validated by {@link isValidUuid}.
+ * @public
+ */
+export type Uuid = Brand<string, 'Uuid'>;
+/**
+ * Type guard that returns `true` when the input is a canonical UUIDv4 string.
+ * @param value - The string to test.
+ * @returns `true` if `value` is a canonical UUIDv4, narrowing it to {@link Uuid}.
+ * @public
+ */
+export declare function isValidUuid(value: string): value is Uuid;
+/**
+ * Generates a cryptographically random UUIDv4 using the platform's Web Crypto
+ * API (`globalThis.crypto.randomUUID`). Works in Node.js \>= 18 and modern
+ * browsers without per-call runtime checks.
+ * @returns A new {@link Uuid}.
+ * @throws An `Error` if the runtime does not expose `globalThis.crypto.randomUUID`.
+ * This indicates an unsupported platform, not a per-call failure mode, so it is
+ * surfaced as a thrown error rather than a `Result`.
+ * @public
+ */
+export declare function generateUuid(): Uuid;
+//# sourceMappingURL=uuid.d.ts.map

package/lib/packlets/base/uuid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uuid.d.ts","sourceRoot":"","sources":["../../../src/packlets/base/uuid.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAEhC;;;;;GAKG;AACH,MAAM,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AASzC;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,IAAI,CAExD;AAED;;;;;;;;;GASG;AACH,wBAAgB,YAAY,IAAI,IAAI,CASnC"}

package/lib/packlets/base/uuid.js

@@ -0,0 +1,59 @@
+"use strict";
+/*
+ * Copyright (c) 2026 Erik Fortune
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isValidUuid = isValidUuid;
+exports.generateUuid = generateUuid;
+/**
+ * Canonical UUIDv4 format: 8-4-4-4-12 lowercase hex digits with the version
+ * nibble `4` in the third group and the variant nibble (8, 9, a, or b) at the
+ * start of the fourth group. Matches what `crypto.randomUUID()` returns.
+ */
+const uuidRegex = /^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/;
+/**
+ * Type guard that returns `true` when the input is a canonical UUIDv4 string.
+ * @param value - The string to test.
+ * @returns `true` if `value` is a canonical UUIDv4, narrowing it to {@link Uuid}.
+ * @public
+ */
+function isValidUuid(value) {
+    return uuidRegex.test(value);
+}
+/**
+ * Generates a cryptographically random UUIDv4 using the platform's Web Crypto
+ * API (`globalThis.crypto.randomUUID`). Works in Node.js \>= 18 and modern
+ * browsers without per-call runtime checks.
+ * @returns A new {@link Uuid}.
+ * @throws An `Error` if the runtime does not expose `globalThis.crypto.randomUUID`.
+ * This indicates an unsupported platform, not a per-call failure mode, so it is
+ * surfaced as a thrown error rather than a `Result`.
+ * @public
+ */
+function generateUuid() {
+    const cryptoObj = globalThis.crypto;
+    /* c8 ignore next 5 - all supported runtimes (node >= 18, modern browsers) expose globalThis.crypto.randomUUID */
+    if (typeof (cryptoObj === null || cryptoObj === void 0 ? void 0 : cryptoObj.randomUUID) !== 'function') {
+        throw new Error('generateUuid: globalThis.crypto.randomUUID is not available; requires Node.js >= 18 or a modern browser');
+    }
+    return cryptoObj.randomUUID();
+}
+//# sourceMappingURL=uuid.js.map

package/lib/packlets/base/uuid.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"uuid.js","sourceRoot":"","sources":["../../../src/packlets/base/uuid.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;AAyBH,kCAEC;AAYD,oCASC;AApCD;;;;GAIG;AACH,MAAM,SAAS,GAAW,uEAAuE,CAAC;AAElG;;;;;GAKG;AACH,SAAgB,WAAW,CAAC,KAAa;IACvC,OAAO,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAC/B,CAAC;AAED;;;;;;;;;GASG;AACH,SAAgB,YAAY;IAC1B,MAAM,SAAS,GAAG,UAAU,CAAC,MAAM,CAAC;IACpC,iHAAiH;IACjH,IAAI,OAAO,CAAA,SAAS,aAAT,SAAS,uBAAT,SAAS,CAAE,UAAU,CAAA,KAAK,UAAU,EAAE,CAAC;QAChD,MAAM,IAAI,KAAK,CACb,yGAAyG,CAC1G,CAAC;IACJ,CAAC;IACD,OAAO,SAAS,CAAC,UAAU,EAAU,CAAC;AACxC,CAAC","sourcesContent":["/*\n * Copyright (c) 2026 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\nimport { Brand } from './brand';\n\n/**\n * A canonical UUIDv4 string: 8-4-4-4-12 lowercase hex digits with version\n * nibble `4` and variant nibble in `[89ab]`. Produced by {@link generateUuid}\n * and validated by {@link isValidUuid}.\n * @public\n */\nexport type Uuid = Brand<string, 'Uuid'>;\n\n/**\n * Canonical UUIDv4 format: 8-4-4-4-12 lowercase hex digits with the version\n * nibble `4` in the third group and the variant nibble (8, 9, a, or b) at the\n * start of the fourth group. Matches what `crypto.randomUUID()` returns.\n */\nconst uuidRegex: RegExp = /^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/;\n\n/**\n * Type guard that returns `true` when the input is a canonical UUIDv4 string.\n * @param value - The string to test.\n * @returns `true` if `value` is a canonical UUIDv4, narrowing it to {@link Uuid}.\n * @public\n */\nexport function isValidUuid(value: string): value is Uuid {\n  return uuidRegex.test(value);\n}\n\n/**\n * Generates a cryptographically random UUIDv4 using the platform's Web Crypto\n * API (`globalThis.crypto.randomUUID`). Works in Node.js \\>= 18 and modern\n * browsers without per-call runtime checks.\n * @returns A new {@link Uuid}.\n * @throws An `Error` if the runtime does not expose `globalThis.crypto.randomUUID`.\n * This indicates an unsupported platform, not a per-call failure mode, so it is\n * surfaced as a thrown error rather than a `Result`.\n * @public\n */\nexport function generateUuid(): Uuid {\n  const cryptoObj = globalThis.crypto;\n  /* c8 ignore next 5 - all supported runtimes (node >= 18, modern browsers) expose globalThis.crypto.randomUUID */\n  if (typeof cryptoObj?.randomUUID !== 'function') {\n    throw new Error(\n      'generateUuid: globalThis.crypto.randomUUID is not available; requires Node.js >= 18 or a modern browser'\n    );\n  }\n  return cryptoObj.randomUUID() as Uuid;\n}\n"]}

package/lib/packlets/collections/aggregatedResultMap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aggregatedResultMap.d.ts","sourceRoot":"","sources":["../../../src/packlets/collections/aggregatedResultMap.ts"],"names":[],"mappings":"AAsBA,OAAO,EAEL,cAAc,EACd,MAAM,EAMP,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,SAAS,EAAc,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,SAAS,EAAc,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,2BAA2B,EAAE,MAAM,sBAAsB,CAAC;AACnE,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AACpG,OAAO,EAAE,UAAU,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAChE,OAAO,EAAE,4BAA4B,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAE1F;;;GAGG;AACH,MAAM,WAAW,iCAAiC,CAChD,aAAa,SAAS,MAAM,GAAG,MAAM,EACrC,OAAO,SAAS,MAAM,GAAG,MAAM,EAC/B,KAAK,GAAG,OAAO,EACf,SAAS,GAAG,OAAO;IAEnB,QAAQ,CAAC,SAAS,EAAE,KAAK,CAAC;IAC1B,QAAQ,CAAC,EAAE,EAAE,aAAa,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,4BAA4B,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAC7D,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,CAAC;CAC/B;AAED;;;GAGG;AACH,MAAM,WAAW,gCAAgC,CAC/C,aAAa,SAAS,MAAM,GAAG,MAAM,EACrC,OAAO,SAAS,MAAM,GAAG,MAAM,EAC/B,KAAK,GAAG,OAAO,EACf,SAAS,GAAG,OAAO;IAEnB,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC;IACzB,QAAQ,CAAC,EAAE,EAAE,aAAa,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,mBAAmB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IACpD,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB;AAED;;;GAGG;AACH,MAAM,MAAM,wBAAwB,CAClC,aAAa,SAAS,MAAM,EAC5B,OAAO,SAAS,MAAM,EACtB,KAAK,EACL,SAAS,GAAG,OAAO,IAEjB,iCAAiC,CAAC,aAAa,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,CAAC,GAC3E,gCAAgC,CAAC,aAAa,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC;AAE/E;;;GAGG;AACH,MAAM,WAAW,wCAAwC,CAAC,aAAa,SAAS,MAAM,GAAG,MAAM;IAC7F,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,EAAE,EAAE,aAAa,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC,aAAa,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAChE,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED;;;GAGG;AACH,MAAM,WAAW,sCAAsC,CAAC,aAAa,SAAS,MAAM,GAAG,MAAM;IAC3F,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,EAAE,EAAE,aAAa,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACxC,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED;;;GAGG;AACH,MAAM,MAAM,4BAA4B,CAAC,aAAa,SAAS,MAAM,GAAG,MAAM,IAC1E,wCAAwC,CAAC,aAAa,CAAC,GACvD,sCAAsC,CAAC,aAAa,CAAC,CAAC;AAE1D;;;GAGG;AACH,MAAM,MAAM,4BAA4B,CACtC,aAAa,SAAS,MAAM,EAC5B,OAAO,SAAS,MAAM,EACtB,KAAK,EACL,SAAS,GAAG,OAAO,IAEjB,wBAAwB,CAAC,aAAa,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,CAAC,GAClE,4BAA4B,CAAC,aAAa,CAAC,CAAC;AAEhD;;;GAGG;AACH,MAAM,WAAW,8BAA8B,CAAC,SAAS,GAAG,OAAO;IACjE;;;OAGG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;IAE/B;;OAEG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,CAAC;CAC/B;AAED;;;GAGG;AACH,MAAM,WAAW,qCAAqC,CACpD,YAAY,SAAS,MAAM,EAC3B,aAAa,SAAS,MAAM,EAC5B,OAAO,SAAS,MAAM,EACtB,KAAK,EACL,SAAS,GAAG,OAAO;IAEnB;;OAEG;IACH,QAAQ,CAAC,oBAAoB,CAAC,EAAE,SAAS,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;IACjE;;OAEG;IACH,QAAQ,CAAC,qBAAqB,EAAE,SAAS,CAAC,aAAa,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;IACtG;;OAEG;IACH,QAAQ,CAAC,eAAe,EAAE,SAAS,CAAC,OAAO,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IACpF;;OAEG;IACH,QAAQ,CAAC,aAAa,EAAE,SAAS,CAAC,KAAK,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IAC9E;;;OAGG;IACH,QAAQ,CAAC,iBAAiB,CAAC,EAAE,SAAS,CAAC,SAAS,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IAE3F;;OAEG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAE5B;;;OAGG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,aAAa,CAClC,4BAA4B,CAAC,aAAa,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,CAAC,CACvE,CAAC;CACH;AAED;;;GAGG;AACH,qBAAa,4BAA4B,CACvC,YAAY,SAAS,MAAM,EAC3B,aAAa,SAAS,MAAM,EAC5B,OAAO,SAAS,MAAM,EACtB,KAAK,EACL,SAAS,GAAG,OAAO,CACnB,YAAW,2BAA2B,CAAC,YAAY,EAAE,KAAK,CAAC;IAE3D,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA8E;IAEnG;;OAEG;IACH,SAAgB,UAAU,EAAE,kBAAkB,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC;IAEpE;;;;OAIG;gBAED,GAAG,EAAE,mBAAmB,CAAC,YAAY,EAAE,aAAa,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,CAAC,EAChF,UAAU,EAAE,kBAAkB,CAAC,YAAY,EAAE,KAAK,CAAC;IAMrD,uDAAuD;IACvD,IAAW,GAAG,IAAI,4BAA4B,CAAC,YAAY,EAAE,KAAK,CAAC,CAElE;IAED,uDAAuD;IAChD,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc,CAAC,KAAK,EAAE,qBAAqB,CAAC;IAMrE,uDAAuD;IAChD,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAQhC,uDAAuD;IAChD,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,cAAc,CAAC,KAAK,EAAE,qBAAqB,CAAC;IAMrF,uDAAuD;IAChD,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,cAAc,CAAC,KAAK,EAAE,qBAAqB,CAAC;IAMrF,0DAA0D;IACnD,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,cAAc,CAAC,KAAK,EAAE,qBAAqB,CAAC;IAMxF,0DAA0D;IACnD,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc,CAAC,KAAK,EAAE,qBAAqB,CAAC;CAKzE;AAWD;;;;;;;GAOG;AACH,qBAAa,uBAAuB,CAClC,YAAY,SAAS,MAAM,EAC3B,aAAa,SAAS,MAAM,EAC5B,OAAO,SAAS,MAAM,EACtB,KAAK,EACL,SAAS,GAAG,OAAO,CACnB,YAAW,UAAU,CAAC,YAAY,EAAE,KAAK,CAAC,EAAE,4BAA4B,CAAC,YAAY,EAAE,KAAK,CAAC;IAE7F,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAqC;IACxE,OAAO,CAAC,QAAQ,CAAC,YAAY,CAG3B;IACF,OAAO,CAAC,QAAQ,CAAC,uBAAuB,CAGtC;IACF,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAAmC;IACzE,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAED;IACtC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAA4D;IAC7F,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAwD;IACvF,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAAgE;IACpG,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAAsE;IAC5G,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA0C;IACxE,OAAO,CAAC,QAAQ,CAAC,WAAW,CAM1B;IAEF;;;;;;OAMG;IACH,SAAS,aACP,MAAM,EAAE,qCAAqC,CAAC,YAAY,EAAE,aAAa,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,CAAC;IAwEvG;;OAEG;IACH,IAAW,UAAU,IAAI,2BAA2B,CAAC,YAAY,EAAE,KAAK,CAAC,CAExE;IAED;;OAEG;IACH,IAAW,IAAI,IAAI,MAAM,CAMxB;IAED;;;;OAIG;IACI,GAAG,CAAC,GAAG,EAAE,YAAY,GAAG,cAAc,CAAC,KAAK,EAAE,qBAAqB,CAAC;IAM3E;;;;OAIG;IACI,GAAG,CAAC,GAAG,EAAE,YAAY,GAAG,OAAO;IAQtC;;OAEG;IACK,OAAO,IAAI,gBAAgB,CAAC,aAAa,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC;IAYvE;;OAEG;IACK,IAAI,IAAI,gBAAgB,CAAC,YAAY,CAAC;IAM9C;;OAEG;IACK,MAAM,IAAI,gBAAgB,CAAC,KAAK,CAAC;IAQzC;;;;OAIG;IACI,OAAO,CAAC,EAAE,EAAE,kBAAkB,CAAC,YAAY,EAAE,KAAK,CAAC,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI;IAMpF;;OAEG;IACI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,gBAAgB,CAAC,aAAa,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC;IAMhF;;;;;OAKG;IACI,GAAG,CAAC,GAAG,EAAE,YAAY,EAAE,KAAK,EAAE,KAAK,GAAG,cAAc,CAAC,KAAK,EAAE,qBAAqB,CAAC;IAQzF;;;;;OAKG;IACI,GAAG,CAAC,GAAG,EAAE,YAAY,EAAE,KAAK,EAAE,KAAK,GAAG,cAAc,CAAC,KAAK,EAAE,qBAAqB,CAAC;IAQzF;;;;;OAKG;IACI,MAAM,CAAC,GAAG,EAAE,YAAY,EAAE,KAAK,EAAE,KAAK,GAAG,cAAc,CAAC,KAAK,EAAE,qBAAqB,CAAC;IAM5F;;;;OAIG;IACI,MAAM,CAAC,GAAG,EAAE,YAAY,GAAG,cAAc,CAAC,KAAK,EAAE,qBAAqB,CAAC;IAM9E;;;;;OAKG;IACI,QAAQ,CAAC,GAAG,EAAE,YAAY,EAAE,KAAK,EAAE,KAAK,GAAG,cAAc,CAAC,KAAK,EAAE,qBAAqB,CAAC;IAE9F;;;;;OAKG;IACI,QAAQ,CACb,GAAG,EAAE,YAAY,EACjB,OAAO,EAAE,qBAAqB,CAAC,YAAY,EAAE,KAAK,CAAC,GAClD,cAAc,CAAC,KAAK,EAAE,qBAAqB,CAAC;IAiB/C;;;OAGG;IACI,KAAK,IAAI,IAAI;IAQpB;;OAEG;IACI,UAAU,IAAI,kBAAkB,CAAC,YAAY,EAAE,KAAK,CAAC;IAM5D;;;;;OAKG;IACI,SAAS,CAAC,YAAY,EAAE,aAAa,EAAE,MAAM,EAAE,OAAO,GAAG,MAAM,CAAC,YAAY,CAAC;IAKpF;;;;;;OAMG;IACI,eAAe,CACpB,YAAY,EAAE,aAAa,EAC3B,MAAM,EAAE,OAAO,EACf,KAAK,EAAE,KAAK,GACX,cAAc,CAAC,YAAY,EAAE,qBAAqB,CAAC;IAQtD;;;;;;OAMG;IACI,eAAe,CACpB,YAAY,EAAE,aAAa,EAC3B,MAAM,EAAE,OAAO,EACf,KAAK,EAAE,KAAK,GACX,cAAc,CAAC,YAAY,EAAE,qBAAqB,CAAC;IAQtD;;;;;;OAMG;IACI,kBAAkB,CACvB,YAAY,EAAE,aAAa,EAC3B,MAAM,EAAE,OAAO,EACf,KAAK,EAAE,KAAK,GACX,cAAc,CAAC,YAAY,EAAE,qBAAqB,CAAC;IAQtD;;;;;OAKG;IACI,oBAAoB,CACzB,YAAY,EAAE,aAAa,EAC3B,MAAM,EAAE,OAAO,GACd,cAAc,CAAC,YAAY,EAAE,qBAAqB,CAAC;IAUtD;;;OAGG;IACH,IAAW,WAAW,IAAI,4BAA4B,CACpD,aAAa,EACb,wBAAwB,CAAC,aAAa,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,CAAC,CACnE,CAEA;IAED;;OAEG;IACH,IAAW,eAAe,IAAI,MAAM,CAEnC;IAED;;;;OAIG;IACI,qBAAqB,CAAC,YAAY,EAAE,aAAa,GAAG,MAAM,CAAC,SAAS,GAAG,SAAS,CAAC;IAMxF;;;;;OAKG;IACI,qBAAqB,CAAC,YAAY,EAAE,aAAa,EAAE,QAAQ,EAAE,SAAS,GAAG,MAAM,CAAC,SAAS,CAAC;IAUjG;;;;OAIG;IACI,kBAAkB,CACvB,KAAK,EAAE,4BAA4B,CAAC,aAAa,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,CAAC,GAC5E,cAAc,CACf,wBAAwB,CAAC,aAAa,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,CAAC,EAClE,qBAAqB,CACtB;IAWD;;;;;;OAMG;IACI,sBAAsB,CAC3B,YAAY,EAAE,MAAM,EACpB,KAAK,CAAC,EAAE,QAAQ,CAAC,aAAa,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EAChD,OAAO,CAAC,EAAE,8BAA8B,CAAC,SAAS,CAAC,GAClD,MAAM,CAAC,aAAa,CAAC;IAcxB;;;;;;;;;;OAUG;IACH,SAAS,CAAC,iBAAiB,CACzB,YAAY,EAAE,aAAa,GAC1B,cAAc,CACf,wBAAwB,CAAC,aAAa,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,CAAC,EAClE,qBAAqB,CACtB;IAOD;;OAEG;IACH,OAAO,CAAC,UAAU;IAMlB,OAAO,CAAC,iBAAiB;IAMzB,OAAO,CAAC,eAAe;IAavB,OAAO,CAAC,sBAAsB;IAc9B;;;OAGG;IACH,OAAO,CAAC,qBAAqB;IAW7B;;OAEG;IACH,OAAO,CAAC,6BAA6B;IA2BrC;;;;OAIG;IACH,OAAO,CAAC,MAAM,CAAC,qBAAqB;IAgBpC;;;;;OAKG;IACH,OAAO,CAAC,MAAM,CAAC,gBAAgB;IAa/B;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,sBAAsB;IAIrC;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,6BAA6B;IA2C5C;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,8BAA8B;IA2C7C;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,yBAAyB;IA0DxC;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,uBAAuB;IA0DtC;;;;OAIG;IACH,OAAO,CAAC,MAAM,CAAC,eAAe;CA+B/B;AAED;;;;;GAKG;AACH,qBAAa,mBAAmB,CAC9B,YAAY,SAAS,MAAM,EAC3B,aAAa,SAAS,MAAM,EAC5B,OAAO,SAAS,MAAM,EACtB,KAAK,EACL,SAAS,GAAG,OAAO,CACnB,SAAQ,uBAAuB,CAAC,YAAY,EAAE,aAAa,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,CAAC;IACvF;;;OAGG;gBAED,MAAM,EAAE,qCAAqC,CAAC,YAAY,EAAE,aAAa,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,CAAC;IAKvG;;;;OAIG;WACW,MAAM,CAClB,YAAY,SAAS,MAAM,EAC3B,aAAa,SAAS,MAAM,EAC5B,OAAO,SAAS,MAAM,EACtB,KAAK,EACL,SAAS,GAAG,OAAO,EAEnB,MAAM,EAAE,qCAAqC,CAAC,YAAY,EAAE,aAAa,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,CAAC,GACpG,MAAM,CAAC,mBAAmB,CAAC,YAAY,EAAE,aAAa,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC;CAGvF"}

package/lib/packlets/collections/aggregatedResultMap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"aggregatedResultMap.js","sourceRoot":"","sources":["../../../src/packlets/collections/aggregatedResultMap.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * Copyright (c) 2026 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\nimport {\n  captureResult,\n  DetailedResult,\n  Result,\n  fail,\n  failWithDetail,\n  succeed,\n  succeedWithDetail,\n  Success\n} from '../base';\nimport { Converter, Converters } from '../conversion';\nimport { Validator, Validators } from '../validation';\nimport { KeyValueEntry } from './common';\nimport { KeyValueConverters } from './keyValueConverters';\nimport { IReadOnlyResultMapValidator } from './resultMapValidator';\nimport { IReadOnlyResultMap, ResultMapForEachCb, ResultMapResultDetail } from './readonlyResultMap';\nimport { IResultMap, ResultMapValueFactory } from './resultMap';\nimport { IReadOnlyValidatingResultMap, ValidatingResultMap } from './validatingResultMap';\n\n/**\n * A read-only collection entry in an {@link AggregatedResultMap | aggregated result map}.\n * @public\n */\nexport interface IReadonlyAggregatedResultMapEntry<\n  TCOLLECTIONID extends string = string,\n  TITEMID extends string = string,\n  TITEM = unknown,\n  TMETADATA = unknown\n> {\n  readonly isMutable: false;\n  readonly id: TCOLLECTIONID;\n  readonly items: IReadOnlyValidatingResultMap<TITEMID, TITEM>;\n  readonly metadata?: TMETADATA;\n}\n\n/**\n * A mutable collection entry in an {@link AggregatedResultMap | aggregated result map}.\n * @public\n */\nexport interface IMutableAggregatedResultMapEntry<\n  TCOLLECTIONID extends string = string,\n  TITEMID extends string = string,\n  TITEM = unknown,\n  TMETADATA = unknown\n> {\n  readonly isMutable: true;\n  readonly id: TCOLLECTIONID;\n  readonly items: ValidatingResultMap<TITEMID, TITEM>;\n  metadata?: TMETADATA;\n}\n\n/**\n * A collection entry in an {@link AggregatedResultMap | aggregated result map}, either mutable or read-only.\n * @public\n */\nexport type AggregatedResultMapEntry<\n  TCOLLECTIONID extends string,\n  TITEMID extends string,\n  TITEM,\n  TMETADATA = unknown\n> =\n  | IReadonlyAggregatedResultMapEntry<TCOLLECTIONID, TITEMID, TITEM, TMETADATA>\n  | IMutableAggregatedResultMapEntry<TCOLLECTIONID, TITEMID, TITEM, TMETADATA>;\n\n/**\n * JSON format for an {@link AggregatedResultMap | aggregated result map} collection entry using an entries array.\n * @public\n */\nexport interface IAggregatedResultMapJsonEntryWithEntries<TCOLLECTIONID extends string = string> {\n  readonly isMutable: boolean;\n  readonly id: TCOLLECTIONID;\n  readonly entries: ReadonlyArray<KeyValueEntry<string, unknown>>;\n  readonly metadata?: unknown;\n}\n\n/**\n * JSON format for an {@link AggregatedResultMap | aggregated result map} collection entry using a string-keyed items object.\n * @public\n */\nexport interface IAggregatedResultMapJsonEntryWithItems<TCOLLECTIONID extends string = string> {\n  readonly isMutable: boolean;\n  readonly id: TCOLLECTIONID;\n  readonly items: Record<string, unknown>;\n  readonly metadata?: unknown;\n}\n\n/**\n * JSON format for an {@link AggregatedResultMap | aggregated result map} collection entry - supports both entries array and items object.\n * @public\n */\nexport type AggregatedResultMapJsonEntry<TCOLLECTIONID extends string = string> =\n  | IAggregatedResultMapJsonEntryWithEntries<TCOLLECTIONID>\n  | IAggregatedResultMapJsonEntryWithItems<TCOLLECTIONID>;\n\n/**\n * Any valid input format for an {@link AggregatedResultMap | aggregated result map} collection entry.\n * @public\n */\nexport type AggregatedResultMapEntryInit<\n  TCOLLECTIONID extends string,\n  TITEMID extends string,\n  TITEM,\n  TMETADATA = unknown\n> =\n  | AggregatedResultMapEntry<TCOLLECTIONID, TITEMID, TITEM, TMETADATA>\n  | AggregatedResultMapJsonEntry<TCOLLECTIONID>;\n\n/**\n * Options for {@link Collections.AggregatedResultMapBase.addCollectionWithItems | addCollectionWithItems}.\n * @public\n */\nexport interface IAddCollectionWithItemsOptions<TMETADATA = unknown> {\n  /**\n   * If true, the collection will be immutable (read-only).\n   * Defaults to false (mutable).\n   */\n  readonly isImmutable?: boolean;\n\n  /**\n   * Optional metadata to attach to the collection.\n   */\n  readonly metadata?: TMETADATA;\n}\n\n/**\n * Parameters for constructing an {@link AggregatedResultMap | aggregated result map}.\n * @public\n */\nexport interface IAggregatedResultMapConstructorParams<\n  TCOMPOSITEID extends string,\n  TCOLLECTIONID extends string,\n  TITEMID extends string,\n  TITEM,\n  TMETADATA = unknown\n> {\n  /**\n   * Validator for composite IDs.\n   */\n  readonly compositeIdValidator?: Validator<TCOMPOSITEID, unknown>;\n  /**\n   * Converter or validator for collection IDs.\n   */\n  readonly collectionIdConverter: Converter<TCOLLECTIONID, unknown> | Validator<TCOLLECTIONID, unknown>;\n  /**\n   * Converter or validator for item IDs.\n   */\n  readonly itemIdConverter: Converter<TITEMID, unknown> | Validator<TITEMID, unknown>;\n  /**\n   * Converter or validator for individual items in each collection.\n   */\n  readonly itemConverter: Converter<TITEM, unknown> | Validator<TITEM, unknown>;\n  /**\n   * Optional converter or validator for collection metadata.  If not provided, a metadata field\n   * in the input will cause a validation failure.\n   */\n  readonly metadataConverter?: Converter<TMETADATA, unknown> | Validator<TMETADATA, unknown>;\n\n  /**\n   * Optional separator string for composite IDs.  Defaults to `.`.\n   */\n  readonly separator?: string;\n\n  /**\n   * Initial collections to populate the map.\n   * @remarks Each entry may be mutable or read-only.\n   */\n  readonly collections?: ReadonlyArray<\n    AggregatedResultMapEntryInit<TCOLLECTIONID, TITEMID, TITEM, TMETADATA>\n  >;\n}\n\n/**\n * A validator for weakly-typed access to an {@link AggregatedResultMap | aggregated result map}.\n * @public\n */\nexport class AggregatedResultMapValidator<\n  TCOMPOSITEID extends string,\n  TCOLLECTIONID extends string,\n  TITEMID extends string,\n  TITEM,\n  TMETADATA = unknown\n> implements IReadOnlyResultMapValidator<TCOMPOSITEID, TITEM>\n{\n  private readonly _map: AggregatedResultMap<TCOMPOSITEID, TCOLLECTIONID, TITEMID, TITEM, TMETADATA>;\n\n  /**\n   * The key-value converters used for validating weakly-typed access.\n   */\n  public readonly converters: KeyValueConverters<TCOMPOSITEID, TITEM>;\n\n  /**\n   * Constructs a new {@link AggregatedResultMapValidator | aggregated result map validator}.\n   * @param map - The {@link AggregatedResultMap | aggregated result map} being validated.\n   * @param converters - The key-value converters for weakly-typed access.\n   */\n  public constructor(\n    map: AggregatedResultMap<TCOMPOSITEID, TCOLLECTIONID, TITEMID, TITEM, TMETADATA>,\n    converters: KeyValueConverters<TCOMPOSITEID, TITEM>\n  ) {\n    this._map = map;\n    this.converters = converters;\n  }\n\n  /** {@inheritDoc Collections.ResultMapValidator.map} */\n  public get map(): IReadOnlyValidatingResultMap<TCOMPOSITEID, TITEM> {\n    return this._map;\n  }\n\n  /** {@inheritDoc Collections.ResultMapValidator.get} */\n  public get(key: string): DetailedResult<TITEM, ResultMapResultDetail> {\n    return this.converters.convertKey(key).onSuccess((k) => {\n      return this._map.get(k);\n    });\n  }\n\n  /** {@inheritDoc Collections.ResultMapValidator.has} */\n  public has(key: string): boolean {\n    const result = this.converters.convertKey(key);\n    if (result.isFailure()) {\n      return false;\n    }\n    return this._map.has(result.value);\n  }\n\n  /** {@inheritDoc Collections.ResultMapValidator.add} */\n  public add(key: string, value: unknown): DetailedResult<TITEM, ResultMapResultDetail> {\n    return this.converters.convertEntry([key, value]).onSuccess(([vk, vv]) => {\n      return this._map.add(vk, vv);\n    });\n  }\n\n  /** {@inheritDoc Collections.ResultMapValidator.set} */\n  public set(key: string, value: unknown): DetailedResult<TITEM, ResultMapResultDetail> {\n    return this.converters.convertEntry([key, value]).onSuccess(([vk, vv]) => {\n      return this._map.set(vk, vv);\n    });\n  }\n\n  /** {@inheritDoc Collections.ResultMapValidator.update} */\n  public update(key: string, value: unknown): DetailedResult<TITEM, ResultMapResultDetail> {\n    return this.converters.convertEntry([key, value]).onSuccess(([vk, vv]) => {\n      return this._map.update(vk, vv);\n    });\n  }\n\n  /** {@inheritDoc Collections.ResultMapValidator.delete} */\n  public delete(key: string): DetailedResult<TITEM, ResultMapResultDetail> {\n    return this.converters.convertKey(key).onSuccess((k) => {\n      return this._map.delete(k);\n    });\n  }\n}\n\n/**\n * Type guard to check if an {@link AggregatedResultMapEntry | aggregated result map entry} is mutable.\n */\nfunction isMutableEntry<TCOLLECTIONID extends string, TITEMID extends string, TITEM, TMETADATA>(\n  entry: AggregatedResultMapEntry<TCOLLECTIONID, TITEMID, TITEM, TMETADATA>\n): entry is IMutableAggregatedResultMapEntry<TCOLLECTIONID, TITEMID, TITEM, TMETADATA> {\n  return entry.isMutable === true;\n}\n\n/**\n * Base class for an aggregated result map that wraps a collection of {@link ValidatingResultMap} instances,\n * keyed by collection ID. Items are accessed via composite IDs that combine the collection ID\n * and item ID with a delimiter.\n * @remarks Consumers should inherit from this class or use {@link AggregatedResultMap | AggregatedResultMap}\n * for fully generic.\n * @public\n */\nexport class AggregatedResultMapBase<\n  TCOMPOSITEID extends string,\n  TCOLLECTIONID extends string,\n  TITEMID extends string,\n  TITEM,\n  TMETADATA = unknown\n> implements IResultMap<TCOMPOSITEID, TITEM>, IReadOnlyValidatingResultMap<TCOMPOSITEID, TITEM>\n{\n  private readonly _childKvConverters: KeyValueConverters<TITEMID, TITEM>;\n  private readonly _collections: ValidatingResultMap<\n    TCOLLECTIONID,\n    AggregatedResultMapEntry<TCOLLECTIONID, TITEMID, TITEM, TMETADATA>\n  >;\n  private readonly _collectionKvConverters: KeyValueConverters<\n    TCOLLECTIONID,\n    AggregatedResultMapEntry<TCOLLECTIONID, TITEMID, TITEM, TMETADATA>\n  >;\n  private readonly _compositeIdValidator: Validator<TCOMPOSITEID, unknown>;\n  private readonly _collectionIdConverter:\n    | Converter<TCOLLECTIONID, unknown>\n    | Validator<TCOLLECTIONID, unknown>;\n  private readonly _itemIdConverter: Converter<TITEMID, unknown> | Validator<TITEMID, unknown>;\n  private readonly _itemConverter: Converter<TITEM, unknown> | Validator<TITEM, unknown>;\n  private readonly _metadataConverter?: Converter<TMETADATA, unknown> | Validator<TMETADATA, unknown>;\n  private readonly _delimiter: string;\n  private readonly _compositeIdConverter: Converter<Converters.ICompositeId<TCOLLECTIONID, TITEMID>, unknown>;\n  private readonly _kvConverters: KeyValueConverters<TCOMPOSITEID, TITEM>;\n  private readonly _validating: AggregatedResultMapValidator<\n    TCOMPOSITEID,\n    TCOLLECTIONID,\n    TITEMID,\n    TITEM,\n    TMETADATA\n  >;\n\n  /**\n   * Protected constructor for derived classes.\n   * Use the {@link AggregatedResultMap.create | create static method} for safe construction with error handling.\n   * @param params - {@link IAggregatedResultMapConstructorParams | Parameters} for constructing the map.\n   * @throws If initialization fails (e.g., invalid collections).\n   * @public\n   */\n  protected constructor(\n    params: IAggregatedResultMapConstructorParams<TCOMPOSITEID, TCOLLECTIONID, TITEMID, TITEM, TMETADATA>\n  ) {\n    this._compositeIdValidator =\n      params.compositeIdValidator ?? AggregatedResultMapBase._compositeIdValidator(params);\n    this._collectionIdConverter = params.collectionIdConverter;\n    this._itemIdConverter = params.itemIdConverter;\n    this._itemConverter = params.itemConverter;\n    this._metadataConverter = params.metadataConverter;\n    this._delimiter = params.separator ?? '.';\n\n    // Build child key-value converters for item ID/value pairs\n    this._childKvConverters = new KeyValueConverters<TITEMID, TITEM>({\n      key: params.itemIdConverter,\n      value: params.itemConverter\n    });\n\n    // Build composite ID converter for parsing composite IDs\n    this._compositeIdConverter = Converters.compositeId(\n      params.collectionIdConverter,\n      this._delimiter,\n      params.itemIdConverter\n    );\n\n    // Build key-value converters for composite ID/item pairs\n    this._kvConverters = new KeyValueConverters<TCOMPOSITEID, TITEM>({\n      key: this._compositeIdValidator,\n      value: params.itemConverter\n    });\n\n    // Build entry converter for collection entries\n    const entryConverter = AggregatedResultMapBase._entryConverter<TCOLLECTIONID, TITEMID, TITEM, TMETADATA>(\n      params.collectionIdConverter,\n      this._childKvConverters,\n      params.metadataConverter\n    );\n\n    // Build key-value converters for the collections map\n    this._collectionKvConverters = new KeyValueConverters<\n      TCOLLECTIONID,\n      AggregatedResultMapEntry<TCOLLECTIONID, TITEMID, TITEM, TMETADATA>\n    >({\n      key: params.collectionIdConverter,\n      value: entryConverter\n    });\n\n    // Convert all input collections to [id, entry] pairs for ValidatingResultMap\n    const initCollections = params.collections ?? [];\n    const initEntries: KeyValueEntry<string, unknown>[] = initCollections.map((entry) => {\n      return [entry.id, entry];\n    });\n\n    // Build the inner ValidatingResultMap - throws on error\n    this._collections = new ValidatingResultMap<\n      TCOLLECTIONID,\n      AggregatedResultMapEntry<TCOLLECTIONID, TITEMID, TITEM, TMETADATA>\n    >({\n      converters: this._collectionKvConverters,\n      entries: initEntries\n    });\n\n    // Build the validator\n    this._validating = new AggregatedResultMapValidator<\n      TCOMPOSITEID,\n      TCOLLECTIONID,\n      TITEMID,\n      TITEM,\n      TMETADATA\n    >(this, this._kvConverters);\n  }\n\n  // ==================== IReadOnlyValidatingResultMap implementation ====================\n\n  /**\n   * A validator for weakly-typed access to the map.\n   */\n  public get validating(): IReadOnlyResultMapValidator<TCOMPOSITEID, TITEM> {\n    return this._validating;\n  }\n\n  /**\n   * The total number of items across all collections.\n   */\n  public get size(): number {\n    let total = 0;\n    for (const entry of Array.from(this._collections.values())) {\n      total += entry.items.size;\n    }\n    return total;\n  }\n\n  /**\n   * Gets an item by its composite ID.\n   * @param key - The composite ID of the item.\n   * @returns `Success` with the item if found, `Failure` otherwise.\n   */\n  public get(key: TCOMPOSITEID): DetailedResult<TITEM, ResultMapResultDetail> {\n    return this._splitAndLookup(key).onSuccess(({ entry, itemId }) => {\n      return entry.items.get(itemId);\n    });\n  }\n\n  /**\n   * Checks if an item exists by its composite ID.\n   * @param key - The composite ID of the item.\n   * @returns `true` if the item exists, `false` otherwise.\n   */\n  public has(key: TCOMPOSITEID): boolean {\n    const result = this._splitAndLookup(key);\n    if (result.isFailure()) {\n      return false;\n    }\n    return result.value.entry.items.has(result.value.itemId);\n  }\n\n  /**\n   * Iterates over all entries in all collections.\n   */\n  public *entries(): IterableIterator<KeyValueEntry<TCOMPOSITEID, TITEM>> {\n    for (const collectionEntry of Array.from(this._collections.values())) {\n      for (const [itemId, item] of Array.from(collectionEntry.items.entries())) {\n        // Validate the composite ID through the converter\n        const compositeId = this._compositeIdValidator\n          .convert(`${collectionEntry.id}${this._delimiter}${itemId}`)\n          .orThrow();\n        yield [compositeId, item];\n      }\n    }\n  }\n\n  /**\n   * Iterates over all composite keys.\n   */\n  public *keys(): IterableIterator<TCOMPOSITEID> {\n    for (const [key] of Array.from(this.entries())) {\n      yield key;\n    }\n  }\n\n  /**\n   * Iterates over all values.\n   */\n  public *values(): IterableIterator<TITEM> {\n    for (const collectionEntry of Array.from(this._collections.values())) {\n      for (const value of Array.from(collectionEntry.items.values())) {\n        yield value;\n      }\n    }\n  }\n\n  /**\n   * Calls a callback for each entry.\n   * @param cb - The callback to call.\n   * @param thisArg - Optional `this` argument for the callback.\n   */\n  public forEach(cb: ResultMapForEachCb<TCOMPOSITEID, TITEM>, thisArg?: unknown): void {\n    for (const [key, value] of Array.from(this.entries())) {\n      cb.call(thisArg, value, key, this);\n    }\n  }\n\n  /**\n   * Gets an iterator over the map entries.\n   */\n  public [Symbol.iterator](): IterableIterator<KeyValueEntry<TCOMPOSITEID, TITEM>> {\n    return this.entries();\n  }\n\n  // ==================== Mutating methods ====================\n\n  /**\n   * Sets an item by its composite ID. Creates the collection if it doesn't exist and is mutable.\n   * @param key - The composite ID of the item.\n   * @param value - The value to set.\n   * @returns `Success` with the value if set, `Failure` otherwise.\n   */\n  public set(key: TCOMPOSITEID, value: TITEM): DetailedResult<TITEM, ResultMapResultDetail> {\n    return this._splitCompositeId(key).onSuccess(({ collectionId, itemId }) => {\n      return this._getOrCreateMutableCollection(collectionId).onSuccess((collection) => {\n        return collection.set(itemId, value);\n      });\n    });\n  }\n\n  /**\n   * Adds an item by its composite ID. Fails if the item already exists.\n   * @param key - The composite ID of the item.\n   * @param value - The value to add.\n   * @returns `Success` with the value if added, `Failure` otherwise.\n   */\n  public add(key: TCOMPOSITEID, value: TITEM): DetailedResult<TITEM, ResultMapResultDetail> {\n    return this._splitCompositeId(key).onSuccess(({ collectionId, itemId }) => {\n      return this._getOrCreateMutableCollection(collectionId).onSuccess((collection) => {\n        return collection.add(itemId, value);\n      });\n    });\n  }\n\n  /**\n   * Updates an existing item by its composite ID. Fails if the item doesn't exist.\n   * @param key - The composite ID of the item.\n   * @param value - The new value.\n   * @returns `Success` with the value if updated, `Failure` otherwise.\n   */\n  public update(key: TCOMPOSITEID, value: TITEM): DetailedResult<TITEM, ResultMapResultDetail> {\n    return this._splitAndLookupMutable(key).onSuccess(({ entry, itemId }) => {\n      return entry.items.update(itemId, value);\n    });\n  }\n\n  /**\n   * Deletes an item by its composite ID.\n   * @param key - The composite ID of the item.\n   * @returns `Success` with the deleted value, `Failure` otherwise.\n   */\n  public delete(key: TCOMPOSITEID): DetailedResult<TITEM, ResultMapResultDetail> {\n    return this._splitAndLookupMutable(key).onSuccess(({ entry, itemId }) => {\n      return entry.items.delete(itemId);\n    });\n  }\n\n  /**\n   * Gets an existing item or adds a new one.\n   * @param key - The composite ID of the item.\n   * @param value - The value to add if not found.\n   * @returns `Success` with the existing or new value.\n   */\n  public getOrAdd(key: TCOMPOSITEID, value: TITEM): DetailedResult<TITEM, ResultMapResultDetail>;\n\n  /**\n   * Gets an existing item or adds a new one using a factory.\n   * @param key - The composite ID of the item.\n   * @param factory - A factory function to create the value if not found. Receives the composite ID.\n   * @returns `Success` with the existing or new value.\n   */\n  public getOrAdd(\n    key: TCOMPOSITEID,\n    factory: ResultMapValueFactory<TCOMPOSITEID, TITEM>\n  ): DetailedResult<TITEM, ResultMapResultDetail>;\n\n  public getOrAdd(\n    key: TCOMPOSITEID,\n    valueOrFactory: TITEM | ResultMapValueFactory<TCOMPOSITEID, TITEM>\n  ): DetailedResult<TITEM, ResultMapResultDetail> {\n    return this._splitCompositeId(key).onSuccess(({ collectionId, itemId }) => {\n      return this._getOrCreateMutableCollection(collectionId).onSuccess((collection) => {\n        // Use type guard to check if valueOrFactory is a factory function\n        if (this._isFactory(valueOrFactory)) {\n          return collection.getOrAdd(itemId, () => valueOrFactory(key));\n        }\n        return collection.getOrAdd(itemId, valueOrFactory);\n      });\n    });\n  }\n\n  /**\n   * Clears all items from all mutable collections.\n   * Immutable collections are not affected.\n   */\n  public clear(): void {\n    for (const entry of Array.from(this._collections.values())) {\n      if (isMutableEntry(entry)) {\n        entry.items.clear();\n      }\n    }\n  }\n\n  /**\n   * Returns a read-only view of this map.\n   */\n  public toReadOnly(): IReadOnlyResultMap<TCOMPOSITEID, TITEM> {\n    return this;\n  }\n\n  // ==================== Convenience methods for split IDs ====================\n\n  /**\n   * Composes a collection ID and item ID into a composite ID.\n   * @param collectionId - The collection ID.\n   * @param itemId - The item ID.\n   * @returns `Success` with the composite ID if valid, `Failure` otherwise.\n   */\n  public composeId(collectionId: TCOLLECTIONID, itemId: TITEMID): Result<TCOMPOSITEID> {\n    const rawId = `${collectionId}${this._delimiter}${itemId}`;\n    return this._compositeIdValidator.convert(rawId);\n  }\n\n  /**\n   * Adds an item using separate collection and item IDs.\n   * @param collectionId - The collection ID.\n   * @param itemId - The item ID.\n   * @param value - The value to add.\n   * @returns `Success` with the composite ID if added, `Failure` otherwise.\n   */\n  public addToCollection(\n    collectionId: TCOLLECTIONID,\n    itemId: TITEMID,\n    value: TITEM\n  ): DetailedResult<TCOMPOSITEID, ResultMapResultDetail> {\n    return this._getOrCreateMutableCollection(collectionId).onSuccess((collection) => {\n      return collection.add(itemId, value).onSuccess(() => {\n        return this.composeId(collectionId, itemId).withDetail('invalid-key', 'added');\n      });\n    });\n  }\n\n  /**\n   * Sets an item using separate collection and item IDs.\n   * @param collectionId - The collection ID.\n   * @param itemId - The item ID.\n   * @param value - The value to set.\n   * @returns `Success` with the composite ID if set, `Failure` otherwise.\n   */\n  public setInCollection(\n    collectionId: TCOLLECTIONID,\n    itemId: TITEMID,\n    value: TITEM\n  ): DetailedResult<TCOMPOSITEID, ResultMapResultDetail> {\n    return this._getOrCreateMutableCollection(collectionId).onSuccess((collection) => {\n      return collection.set(itemId, value).onSuccess((_, detail) => {\n        return this.composeId(collectionId, itemId).withDetail('invalid-key', detail);\n      });\n    });\n  }\n\n  /**\n   * Updates an item using separate collection and item IDs.\n   * @param collectionId - The collection ID.\n   * @param itemId - The item ID.\n   * @param value - The new value.\n   * @returns `Success` with the composite ID if updated, `Failure` otherwise.\n   */\n  public updateInCollection(\n    collectionId: TCOLLECTIONID,\n    itemId: TITEMID,\n    value: TITEM\n  ): DetailedResult<TCOMPOSITEID, ResultMapResultDetail> {\n    return this._getMutableCollection(collectionId).onSuccess((collection) => {\n      return collection.update(itemId, value).onSuccess(() => {\n        return this.composeId(collectionId, itemId).withDetail('invalid-key', 'updated');\n      });\n    });\n  }\n\n  /**\n   * Deletes an item using separate collection and item IDs.\n   * @param collectionId - The collection ID.\n   * @param itemId - The item ID.\n   * @returns `Success` with the composite ID if deleted, `Failure` otherwise.\n   */\n  public deleteFromCollection(\n    collectionId: TCOLLECTIONID,\n    itemId: TITEMID\n  ): DetailedResult<TCOMPOSITEID, ResultMapResultDetail> {\n    return this._getMutableCollection(collectionId).onSuccess((collection) => {\n      return collection.delete(itemId).onSuccess(() => {\n        return this.composeId(collectionId, itemId).withDetail('invalid-key', 'deleted');\n      });\n    });\n  }\n\n  // ==================== Collection-level methods ====================\n\n  /**\n   * Provides read-only access to the underlying collections map.\n   * Use `collections.has(id)` and `collections.get(id)` to check existence and retrieve collections.\n   */\n  public get collections(): IReadOnlyValidatingResultMap<\n    TCOLLECTIONID,\n    AggregatedResultMapEntry<TCOLLECTIONID, TITEMID, TITEM, TMETADATA>\n  > {\n    return this._collections;\n  }\n\n  /**\n   * The number of collections.\n   */\n  public get collectionCount(): number {\n    return this._collections.size;\n  }\n\n  /**\n   * Gets the metadata for a specific collection.\n   * @param collectionId - The collection ID.\n   * @returns `Success` with the metadata if found, `Failure` otherwise.\n   */\n  public getCollectionMetadata(collectionId: TCOLLECTIONID): Result<TMETADATA | undefined> {\n    return this._collections.get(collectionId).asResult.onSuccess((entry) => {\n      return succeed(entry.metadata);\n    });\n  }\n\n  /**\n   * Sets the metadata for a mutable collection.\n   * @param collectionId - The collection ID.\n   * @param metadata - The metadata to set.\n   * @returns `Success` if set, `Failure` otherwise.\n   */\n  public setCollectionMetadata(collectionId: TCOLLECTIONID, metadata: TMETADATA): Result<TMETADATA> {\n    return this._collections.get(collectionId).asResult.onSuccess((entry) => {\n      if (!isMutableEntry(entry)) {\n        return fail(`Cannot modify metadata of immutable collection '${collectionId}'`);\n      }\n      entry.metadata = metadata;\n      return succeed(metadata);\n    });\n  }\n\n  /**\n   * Adds a new collection from a pre-built entry object.\n   * @param entry - The collection entry to add (JSON with items/entries, or pre-instantiated).\n   * @returns `Success` with the entry if added, `Failure` otherwise.\n   */\n  public addCollectionEntry(\n    entry: AggregatedResultMapEntryInit<TCOLLECTIONID, TITEMID, TITEM, TMETADATA>\n  ): DetailedResult<\n    AggregatedResultMapEntry<TCOLLECTIONID, TITEMID, TITEM, TMETADATA>,\n    ResultMapResultDetail\n  > {\n    return AggregatedResultMapBase._entryConverter<TCOLLECTIONID, TITEMID, TITEM, TMETADATA>(\n      this._collectionIdConverter,\n      this._childKvConverters,\n      this._metadataConverter\n    )\n      .convert(entry)\n      .withFailureDetail<ResultMapResultDetail>('invalid-value')\n      .onSuccess((c) => this._collections.add(c.id, c));\n  }\n\n  /**\n   * Adds a new collection with the specified ID and optional initial entries.\n   * @param collectionId - The collection ID as a string (will be validated).\n   * @param items - Optional initial entries for the collection.\n   * @param options - Optional settings (isImmutable defaults to false).\n   * @returns `Success` with the validated collection ID if added, `Failure` otherwise.\n   */\n  public addCollectionWithItems(\n    collectionId: string,\n    items?: Iterable<KeyValueEntry<string, unknown>>,\n    options?: IAddCollectionWithItemsOptions<TMETADATA>\n  ): Result<TCOLLECTIONID> {\n    const isMutable = options?.isImmutable !== true;\n    const entries = items ? Array.from(items) : [];\n    return this._collectionIdConverter\n      .convert(collectionId)\n      .onSuccess((id) =>\n        this.addCollectionEntry({ isMutable, id, entries, metadata: options?.metadata }).asResult.onSuccess(\n          () => Success.with(id)\n        )\n      );\n  }\n\n  // ==================== Protected helpers ====================\n\n  /**\n   * Deletes a collection from the internal collections map.\n   * This is a protected method for use by derived classes that need to implement\n   * collection deletion functionality.\n   *\n   * @param collectionId - The collection ID to delete.\n   * @returns `Success` with the deleted entry if found, `Failure` otherwise.\n   * @remarks\n   * - Does NOT check if the collection is mutable - callers should validate this first.\n   * - Use `collections.get(id)` to check if a collection exists and its mutability before calling.\n   */\n  protected _deleteCollection(\n    collectionId: TCOLLECTIONID\n  ): DetailedResult<\n    AggregatedResultMapEntry<TCOLLECTIONID, TITEMID, TITEM, TMETADATA>,\n    ResultMapResultDetail\n  > {\n    // ValidatingResultMap extends ResultMap which has delete method\n    return this._collections.delete(collectionId);\n  }\n\n  // ==================== Private helpers ====================\n\n  /**\n   * Type guard to check if a value is a factory function.\n   */\n  private _isFactory(\n    valueOrFactory: TITEM | ResultMapValueFactory<TCOMPOSITEID, TITEM>\n  ): valueOrFactory is ResultMapValueFactory<TCOMPOSITEID, TITEM> {\n    return typeof valueOrFactory === 'function';\n  }\n\n  private _splitCompositeId(\n    key: TCOMPOSITEID\n  ): DetailedResult<Converters.ICompositeId<TCOLLECTIONID, TITEMID>, ResultMapResultDetail> {\n    return this._compositeIdConverter.convert(key).withDetail('invalid-key', 'success');\n  }\n\n  private _splitAndLookup(\n    key: TCOMPOSITEID\n  ): DetailedResult<\n    { entry: AggregatedResultMapEntry<TCOLLECTIONID, TITEMID, TITEM, TMETADATA>; itemId: TITEMID },\n    ResultMapResultDetail\n  > {\n    return this._splitCompositeId(key).onSuccess(({ collectionId, itemId }) => {\n      return this._collections.get(collectionId).onSuccess((entry) => {\n        return succeedWithDetail({ entry, itemId }, 'success');\n      });\n    });\n  }\n\n  private _splitAndLookupMutable(\n    key: TCOMPOSITEID\n  ): DetailedResult<\n    { entry: IMutableAggregatedResultMapEntry<TCOLLECTIONID, TITEMID, TITEM, TMETADATA>; itemId: TITEMID },\n    ResultMapResultDetail\n  > {\n    return this._splitAndLookup(key).onSuccess(({ entry, itemId }) => {\n      if (!isMutableEntry(entry)) {\n        return failWithDetail(`Cannot modify immutable collection '${entry.id}'`, 'failure');\n      }\n      return succeedWithDetail({ entry, itemId }, 'success');\n    });\n  }\n\n  /**\n   * Gets an existing mutable collection by ID.\n   * Returns failure if the collection doesn't exist or is immutable.\n   */\n  private _getMutableCollection(\n    collectionId: TCOLLECTIONID\n  ): DetailedResult<ValidatingResultMap<TITEMID, TITEM>, ResultMapResultDetail> {\n    return this._collections.get(collectionId).onSuccess((entry) => {\n      if (!isMutableEntry(entry)) {\n        return failWithDetail(`Cannot modify immutable collection '${collectionId}'`, 'failure');\n      }\n      return succeedWithDetail(entry.items, 'exists');\n    });\n  }\n\n  /**\n   * Gets an existing mutable collection or creates a new one.\n   */\n  private _getOrCreateMutableCollection(\n    collectionId: TCOLLECTIONID\n  ): DetailedResult<ValidatingResultMap<TITEMID, TITEM>, ResultMapResultDetail> {\n    const existing = this._collections.get(collectionId);\n    if (existing.isSuccess()) {\n      if (!isMutableEntry(existing.value)) {\n        return failWithDetail(`Cannot modify immutable collection '${collectionId}'`, 'failure');\n      }\n      return succeedWithDetail(existing.value.items, 'exists');\n    }\n\n    // Create a new mutable collection\n    const newItems = new ValidatingResultMap<TITEMID, TITEM>({\n      converters: this._childKvConverters\n    });\n    const newEntry: IMutableAggregatedResultMapEntry<TCOLLECTIONID, TITEMID, TITEM, TMETADATA> = {\n      isMutable: true,\n      id: collectionId,\n      items: newItems\n    };\n    return this._collections.add(collectionId, newEntry).onSuccess(() => {\n      return succeedWithDetail(newItems, 'added');\n    });\n  }\n\n  // ==================== Static converter factories ====================\n\n  /**\n   * Constructs a composite id validator using other converters/validators and separator supplied in params.\n   * @param params - Constructor params.\n   * @returns The composite ID validator.\n   */\n  private static _compositeIdValidator<\n    TCOMPOSITEID extends string,\n    TCOLLECTIONID extends string,\n    TITEMID extends string,\n    TITEM,\n    TMETADATA = unknown\n  >(\n    params: IAggregatedResultMapConstructorParams<TCOMPOSITEID, TCOLLECTIONID, TITEMID, TITEM, TMETADATA>\n  ): Validator<TCOMPOSITEID, unknown> {\n    return Validators.compositeId<TCOMPOSITEID, TCOLLECTIONID, TITEMID>({\n      collectionId: Converters.asValidator(params.collectionIdConverter),\n      separator: params.separator ?? '.',\n      itemId: Converters.asValidator(params.itemIdConverter)\n    });\n  }\n\n  /**\n   * Converts metadata from source, failing fast if metadata is present but no converter is configured.\n   * @param sourceMetadata - The metadata from the source (may be undefined).\n   * @param metadataConverter - Optional converter for metadata.\n   * @returns Success with converted metadata (or undefined), or Failure if metadata is present but disallowed.\n   */\n  private static _convertMetadata<TMETADATA>(\n    sourceMetadata: unknown,\n    metadataConverter?: Converter<TMETADATA, unknown> | Validator<TMETADATA, unknown>\n  ): Result<TMETADATA | undefined> {\n    if (sourceMetadata === undefined) {\n      return succeed(undefined);\n    }\n    if (!metadataConverter) {\n      return fail('metadata is not allowed when no metadataConverter is configured');\n    }\n    return metadataConverter.convert(sourceMetadata);\n  }\n\n  /**\n   * Extracts metadata from a source object if present.\n   */\n  private static _extractSourceMetadata(from: unknown): unknown {\n    return typeof from === 'object' && from !== null && 'metadata' in from ? from.metadata : undefined;\n  }\n\n  /**\n   * Creates a converter for pre-instantiated mutable entries.\n   * These are entries that already have a ValidatingResultMap as their items property.\n   */\n  private static _instantiatedMutableConverter<\n    TCOLLECTIONID extends string,\n    TITEMID extends string,\n    TITEM,\n    TMETADATA = unknown\n  >(\n    collectionIdConverter: Converter<TCOLLECTIONID, unknown> | Validator<TCOLLECTIONID, unknown>,\n    metadataConverter?: Converter<TMETADATA, unknown> | Validator<TMETADATA, unknown>\n  ): Converter<IMutableAggregatedResultMapEntry<TCOLLECTIONID, TITEMID, TITEM, TMETADATA>, unknown> {\n    const baseConverter = Converters.strictObject<{\n      isMutable: true;\n      id: TCOLLECTIONID;\n      items: ValidatingResultMap<TITEMID, TITEM>;\n    }>({\n      isMutable: Converters.literal(true),\n      id: collectionIdConverter,\n      items: Converters.isA<ValidatingResultMap<TITEMID, TITEM>>(\n        'ValidatingResultMap',\n        (t) => t instanceof ValidatingResultMap\n      )\n    });\n\n    return Converters.generic<\n      IMutableAggregatedResultMapEntry<TCOLLECTIONID, TITEMID, TITEM, TMETADATA>,\n      unknown\n    >((from) => {\n      return baseConverter.convert(from).onSuccess((base) => {\n        const sourceMetadata = AggregatedResultMapBase._extractSourceMetadata(from);\n        return AggregatedResultMapBase._convertMetadata(sourceMetadata, metadataConverter).onSuccess(\n          (metadata) => {\n            const entry: IMutableAggregatedResultMapEntry<TCOLLECTIONID, TITEMID, TITEM, TMETADATA> = {\n              isMutable: true,\n              id: base.id,\n              items: base.items,\n              metadata\n            };\n            return succeed(entry);\n          }\n        );\n      });\n    });\n  }\n\n  /**\n   * Creates a converter for pre-instantiated read-only entries.\n   * These are entries that already have an IReadOnlyValidatingResultMap as their items property.\n   */\n  private static _instantiatedReadonlyConverter<\n    TCOLLECTIONID extends string,\n    TITEMID extends string,\n    TITEM,\n    TMETADATA = unknown\n  >(\n    collectionIdConverter: Converter<TCOLLECTIONID, unknown> | Validator<TCOLLECTIONID, unknown>,\n    metadataConverter?: Converter<TMETADATA, unknown> | Validator<TMETADATA, unknown>\n  ): Converter<IReadonlyAggregatedResultMapEntry<TCOLLECTIONID, TITEMID, TITEM, TMETADATA>, unknown> {\n    const baseConverter = Converters.strictObject<{\n      isMutable: false;\n      id: TCOLLECTIONID;\n      items: IReadOnlyValidatingResultMap<TITEMID, TITEM>;\n    }>({\n      isMutable: Converters.literal(false),\n      id: collectionIdConverter,\n      items: Converters.isA<IReadOnlyValidatingResultMap<TITEMID, TITEM>>(\n        'IReadOnlyValidatingResultMap',\n        (t) => t instanceof ValidatingResultMap\n      )\n    });\n\n    return Converters.generic<\n      IReadonlyAggregatedResultMapEntry<TCOLLECTIONID, TITEMID, TITEM, TMETADATA>,\n      unknown\n    >((from) => {\n      return baseConverter.convert(from).onSuccess((base) => {\n        const sourceMetadata = AggregatedResultMapBase._extractSourceMetadata(from);\n        return AggregatedResultMapBase._convertMetadata(sourceMetadata, metadataConverter).onSuccess(\n          (metadata) => {\n            const entry: IReadonlyAggregatedResultMapEntry<TCOLLECTIONID, TITEMID, TITEM, TMETADATA> = {\n              isMutable: false,\n              id: base.id,\n              items: base.items,\n              metadata\n            };\n            return succeed(entry);\n          }\n        );\n      });\n    });\n  }\n\n  /**\n   * Creates a converter for JSON entries with an entries array.\n   * Converts the entries array to a ValidatingResultMap.\n   */\n  private static _jsonWithEntriesConverter<\n    TCOLLECTIONID extends string,\n    TITEMID extends string,\n    TITEM,\n    TMETADATA = unknown\n  >(\n    collectionIdConverter: Converter<TCOLLECTIONID, unknown> | Validator<TCOLLECTIONID, unknown>,\n    childKvConverters: KeyValueConverters<TITEMID, TITEM>,\n    metadataConverter?: Converter<TMETADATA, unknown> | Validator<TMETADATA, unknown>\n  ): Converter<AggregatedResultMapEntry<TCOLLECTIONID, TITEMID, TITEM, TMETADATA>, unknown> {\n    const entriesArrayConverter = Converters.isA<KeyValueEntry<string, unknown>[]>(\n      'entries array',\n      (t): t is KeyValueEntry<string, unknown>[] =>\n        Array.isArray(t) && t.every((item) => Array.isArray(item) && item.length === 2)\n    );\n\n    const baseConverter = Converters.object<{\n      isMutable: boolean;\n      id: TCOLLECTIONID;\n      entries: KeyValueEntry<string, unknown>[];\n    }>({\n      isMutable: Converters.boolean,\n      id: collectionIdConverter,\n      entries: entriesArrayConverter\n    });\n\n    return Converters.generic<AggregatedResultMapEntry<TCOLLECTIONID, TITEMID, TITEM, TMETADATA>>((from) => {\n      return baseConverter.convert(from).onSuccess((json) => {\n        const sourceMetadata = AggregatedResultMapBase._extractSourceMetadata(from);\n\n        return childKvConverters.convertEntries(json.entries).onSuccess((convertedEntries) => {\n          const items = new ValidatingResultMap<TITEMID, TITEM>({\n            converters: childKvConverters,\n            entries: convertedEntries\n          });\n          return AggregatedResultMapBase._convertMetadata(sourceMetadata, metadataConverter).onSuccess(\n            (metadata) => {\n              if (json.isMutable) {\n                return succeed<AggregatedResultMapEntry<TCOLLECTIONID, TITEMID, TITEM, TMETADATA>>({\n                  isMutable: true,\n                  id: json.id,\n                  items,\n                  metadata\n                });\n              }\n              return succeed<AggregatedResultMapEntry<TCOLLECTIONID, TITEMID, TITEM, TMETADATA>>({\n                isMutable: false,\n                id: json.id,\n                items: items.toReadOnly(),\n                metadata\n              });\n            }\n          );\n        });\n      });\n    });\n  }\n\n  /**\n   * Creates a converter for JSON entries with an items object.\n   * Converts the items object to a ValidatingResultMap.\n   */\n  private static _jsonWithItemsConverter<\n    TCOLLECTIONID extends string,\n    TITEMID extends string,\n    TITEM,\n    TMETADATA = unknown\n  >(\n    collectionIdConverter: Converter<TCOLLECTIONID, unknown> | Validator<TCOLLECTIONID, unknown>,\n    childKvConverters: KeyValueConverters<TITEMID, TITEM>,\n    metadataConverter?: Converter<TMETADATA, unknown> | Validator<TMETADATA, unknown>\n  ): Converter<AggregatedResultMapEntry<TCOLLECTIONID, TITEMID, TITEM, TMETADATA>, unknown> {\n    const baseConverter = Converters.object<{\n      isMutable: boolean;\n      id: TCOLLECTIONID;\n      items: Record<string, unknown>;\n    }>({\n      isMutable: Converters.boolean,\n      id: collectionIdConverter,\n      items: Converters.generic<Record<string, unknown>>((from) => {\n        if (typeof from === 'object' && from !== null && !Array.isArray(from)) {\n          return succeed(from as Record<string, unknown>);\n        }\n        return fail('expected an object');\n      })\n    });\n\n    return Converters.generic<AggregatedResultMapEntry<TCOLLECTIONID, TITEMID, TITEM, TMETADATA>>((from) => {\n      return baseConverter.convert(from).onSuccess((json) => {\n        const sourceMetadata = AggregatedResultMapBase._extractSourceMetadata(from);\n        const entries = Object.entries(json.items) as KeyValueEntry<string, unknown>[];\n\n        return childKvConverters.convertEntries(entries).onSuccess((convertedEntries) => {\n          const items = new ValidatingResultMap<TITEMID, TITEM>({\n            converters: childKvConverters,\n            entries: convertedEntries\n          });\n          return AggregatedResultMapBase._convertMetadata(sourceMetadata, metadataConverter).onSuccess(\n            (metadata) => {\n              if (json.isMutable) {\n                return succeed<AggregatedResultMapEntry<TCOLLECTIONID, TITEMID, TITEM, TMETADATA>>({\n                  isMutable: true,\n                  id: json.id,\n                  items,\n                  metadata\n                });\n              }\n              return succeed<AggregatedResultMapEntry<TCOLLECTIONID, TITEMID, TITEM, TMETADATA>>({\n                isMutable: false,\n                id: json.id,\n                items: items.toReadOnly(),\n                metadata\n              });\n            }\n          );\n        });\n      });\n    });\n  }\n\n  /**\n   * Creates a unified entry converter that handles all entry formats.\n   * Tries each format in order: instantiated mutable, instantiated readonly,\n   * JSON with entries array, JSON with items object.\n   */\n  private static _entryConverter<\n    TCOLLECTIONID extends string,\n    TITEMID extends string,\n    TITEM,\n    TMETADATA = unknown\n  >(\n    collectionIdConverter: Converter<TCOLLECTIONID, unknown> | Validator<TCOLLECTIONID, unknown>,\n    childKvConverters: KeyValueConverters<TITEMID, TITEM>,\n    metadataConverter?: Converter<TMETADATA, unknown> | Validator<TMETADATA, unknown>\n  ): Converter<AggregatedResultMapEntry<TCOLLECTIONID, TITEMID, TITEM, TMETADATA>, unknown> {\n    return Converters.oneOf<AggregatedResultMapEntry<TCOLLECTIONID, TITEMID, TITEM, TMETADATA>, unknown>([\n      AggregatedResultMapBase._instantiatedMutableConverter<TCOLLECTIONID, TITEMID, TITEM, TMETADATA>(\n        collectionIdConverter,\n        metadataConverter\n      ),\n      AggregatedResultMapBase._instantiatedReadonlyConverter<TCOLLECTIONID, TITEMID, TITEM, TMETADATA>(\n        collectionIdConverter,\n        metadataConverter\n      ),\n      AggregatedResultMapBase._jsonWithEntriesConverter<TCOLLECTIONID, TITEMID, TITEM, TMETADATA>(\n        collectionIdConverter,\n        childKvConverters,\n        metadataConverter\n      ),\n      AggregatedResultMapBase._jsonWithItemsConverter<TCOLLECTIONID, TITEMID, TITEM, TMETADATA>(\n        collectionIdConverter,\n        childKvConverters,\n        metadataConverter\n      )\n    ]);\n  }\n}\n\n/**\n * An aggregated result map that wraps a collection of {@link ValidatingResultMap | ValidatingResultMap} instances,\n * keyed by collection ID. Items are accessed via composite IDs that combine the collection ID\n * and item ID with a delimiter.\n * @public\n */\nexport class AggregatedResultMap<\n  TCOMPOSITEID extends string,\n  TCOLLECTIONID extends string,\n  TITEMID extends string,\n  TITEM,\n  TMETADATA = unknown\n> extends AggregatedResultMapBase<TCOMPOSITEID, TCOLLECTIONID, TITEMID, TITEM, TMETADATA> {\n  /**\n   * Constructs a new {@link AggregatedResultMap | AggregatedResultMap}.\n   * @param params -\n   */\n  public constructor(\n    params: IAggregatedResultMapConstructorParams<TCOMPOSITEID, TCOLLECTIONID, TITEMID, TITEM, TMETADATA>\n  ) {\n    super(params);\n  }\n\n  /**\n   * Creates a new {@link AggregatedResultMap | AggregatedResultMap}.\n   * @param params - Parameters for constructing the map.\n   * @returns `Success` with the new map if successful, `Failure` otherwise.\n   */\n  public static create<\n    TCOMPOSITEID extends string,\n    TCOLLECTIONID extends string,\n    TITEMID extends string,\n    TITEM,\n    TMETADATA = unknown\n  >(\n    params: IAggregatedResultMapConstructorParams<TCOMPOSITEID, TCOLLECTIONID, TITEMID, TITEM, TMETADATA>\n  ): Result<AggregatedResultMap<TCOMPOSITEID, TCOLLECTIONID, TITEMID, TITEM, TMETADATA>> {\n    return captureResult(() => new AggregatedResultMap(params));\n  }\n}\n"]}

package/lib/packlets/collections/collectible.d.ts.map

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

package/lib/packlets/collections/collectible.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"collectible.js","sourceRoot":"","sources":["../../../src/packlets/collections/collectible.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;AAEH,kCAA+D;AAC/D,8CAAqE;AAuFrE;;;;GAIG;AACH,MAAa,WAAW;IAQtB;;OAEG;IACH,IAAW,KAAK;QACd,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IA2BD,YAAmB,MAAmD;QACpE,IAAI,CAAC,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC;QACtB,IAAI,gBAAgB,IAAI,MAAM,EAAE,CAAC;YAC/B,IAAI,CAAC,eAAe;gBAClB,OAAO,MAAM,CAAC,cAAc,KAAK,UAAU;oBACzC,CAAC,CAAC,uBAAU,CAAC,OAAO,CAAC,MAAM,CAAC,cAAc,CAAC;oBAC3C,CAAC,CAAC,MAAM,CAAC,cAAc,CAAC;YAC5B,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;gBAC/B,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC;YACrE,CAAC;QACH,CAAC;aAAM,CAAC;YACN,qDAAqD;YACrD,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC;QAC7B,CAAC;IACH,CAAC;IAkCM,MAAM,CAAC,iBAAiB,CAC7B,MAAmD;QAEnD,OAAO,IAAA,oBAAa,EAAC,GAAG,EAAE,CAAC,IAAI,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC;IACtD,CAAC;IAED;;OAEG;IACI,QAAQ,CAAC,KAAa;QAC3B,IAAI,SAA6B,CAAC;QAClC,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;YACzB,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;YAC/D,iFAAiF;YACjF,IAAI,OAAO,EAAE,CAAC;gBACZ,OAAO,IAAA,WAAI,EAAC,OAAO,CAAC,CAAC;YACvB,CAAC;YACD,SAAS,GAAG,KAAK,CAAC;QACpB,CAAC;QAED,IAAI,KAAK,KAAK,IAAI,CAAC,KAAK,EAAE,CAAC;YACzB,OAAO,IAAA,cAAO,EAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC7B,CAAC;aAAM,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YACrC,OAAO,IAAA,WAAI,EAAC,SAAS,IAAI,CAAC,KAAK,0CAA0C,KAAK,EAAE,CAAC,CAAC;QACpF,CAAC;QAED,6CAA6C;QAC7C,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;YAC5B,OAAO,IAAA,WAAI,EAAC,SAAS,KAAK,4DAA4D,CAAC,CAAC;QAC1F,CAAC;QAED,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC;QACxB,OAAO,IAAA,cAAO,EAAC,SAAS,CAAC,CAAC;IAC5B,CAAC;CACF;AA1HD,kCA0HC","sourcesContent":["/*\n * Copyright (c) 2025 Erik Fortune\n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to deal\n * in the Software without restriction, including without limitation the rights\n * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n * copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in all\n * copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n * SOFTWARE.\n */\n\nimport { Result, captureResult, fail, succeed } from '../base';\nimport { Converter, ConverterFunc, Converters } from '../conversion';\nimport { Validator } from '../validation';\n\n/**\n * An item that can be collected by some {@link ConvertingCollector | Collector}.\n * @public\n */\nexport interface ICollectible<TKEY extends string = string, TINDEX extends number = number> {\n  readonly key: TKEY;\n  readonly index: TINDEX | undefined;\n  setIndex(index: number): Result<TINDEX>;\n}\n\n/**\n * Infer the key type from an {@link Collections.ICollectible | ICollectible} type.\n * @public\n */\nexport type CollectibleKey<TITEM extends ICollectible> = TITEM extends ICollectible<infer TKEY>\n  ? TKEY\n  : never;\n\n/**\n * Infer the index type from an {@link Collections.ICollectible | ICollectible} type.\n * @public\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport type CollectibleIndex<TITEM extends ICollectible> = TITEM extends ICollectible<any, infer TINDEX>\n  ? TINDEX\n  : never;\n\n/**\n * Factory function for creating a new {@link Collections.ICollectible | ICollectible} instance given a key, an index and a source representation\n * of the item to be added.\n * @public\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport type CollectibleFactory<TITEM extends ICollectible<any, any>, TSRC> = (\n  key: CollectibleKey<TITEM>,\n  index: number,\n  item: TSRC\n) => Result<TITEM>;\n\n/**\n * Factory function for creating a new {@link Collections.ICollectible | ICollectible} instance given a key and an index.\n * @public\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport type CollectibleFactoryCallback<TITEM extends ICollectible<any, any>> = (\n  key: CollectibleKey<TITEM>,\n  index: number\n) => Result<TITEM>;\n\n/**\n * Parameters for constructing a new {@link Collections.ICollectible | ICollectible} instance with\n * a defined, strongly-typed index.\n * @public\n */\nexport interface ICollectibleConstructorParamsWithIndex<\n  TKEY extends string = string,\n  TINDEX extends number = number\n> {\n  key: TKEY;\n  index: TINDEX;\n}\n\n/**\n * Parameters for constructing a new {@link Collections.ICollectible | ICollectible} instance with an\n * index converter.\n * @public\n */\nexport interface ICollectibleConstructorParamsWithConverter<\n  TKEY extends string = string,\n  TINDEX extends number = number\n> {\n  key: TKEY;\n  index?: number;\n  indexConverter: Validator<TINDEX, unknown> | Converter<TINDEX, unknown> | ConverterFunc<TINDEX, undefined>;\n}\n\n/**\n * Parameters for constructing a new {@link Collections.ICollectible | ICollectible} instance.\n * @public\n */\nexport type ICollectibleConstructorParams<TKEY extends string = string, TINDEX extends number = number> =\n  | ICollectibleConstructorParamsWithIndex<TKEY, TINDEX>\n  | ICollectibleConstructorParamsWithConverter<TKEY, TINDEX>;\n\n/**\n * Simple implementation of {@link Collections.ICollectible | ICollectible} which does not allow the index to be\n * changed once set.\n * @public\n */\nexport class Collectible<TKEY extends string = string, TINDEX extends number = number>\n  implements ICollectible<TKEY, TINDEX>\n{\n  /**\n   * {@link Collections.ICollectible.key}\n   */\n  public readonly key: TKEY;\n\n  /**\n   * {@link Collections.ICollectible.index}\n   */\n  public get index(): TINDEX | undefined {\n    return this._index;\n  }\n\n  protected _index: TINDEX | undefined;\n  protected readonly _indexConverter?: Validator<TINDEX, unknown> | Converter<TINDEX, unknown>;\n\n  /**\n   * Constructs a new {@link Collections.Collectible | Collectible} instance\n   * with a defined, strongly-typed index.\n   * @param params - {@link Collections.ICollectibleConstructorParamsWithIndex | Parameters} for constructing\n   * the collectible.\n   */\n  public constructor(params: ICollectibleConstructorParamsWithIndex<TKEY, TINDEX>);\n\n  /**\n   * Constructs a new {@link Collections.Collectible | Collectible} instance with\n   * an undefined index and an index converter to validate te index when it is set.\n   * @param params - {@link Collections.ICollectibleConstructorParamsWithConverter | Parameters} for constructing\n   * the collectible.\n   */\n  public constructor(params: ICollectibleConstructorParamsWithConverter<TKEY, TINDEX>);\n\n  /**\n   * Constructs a new {@link Collections.Collectible | Collectible} instance.\n   * @param params - {@link Collections.ICollectibleConstructorParams | Parameters} for constructing\n   * the collectible.\n   */\n  public constructor(params: ICollectibleConstructorParams<TKEY, TINDEX>);\n  public constructor(params: ICollectibleConstructorParams<TKEY, TINDEX>) {\n    this.key = params.key;\n    if ('indexConverter' in params) {\n      this._indexConverter =\n        typeof params.indexConverter === 'function'\n          ? Converters.generic(params.indexConverter)\n          : params.indexConverter;\n      if (params.index !== undefined) {\n        this._index = this._indexConverter.convert(params.index).orThrow();\n      }\n    } else {\n      /* c8 ignore next 3 - coverage is having a bad day */\n      this._index = params.index;\n    }\n  }\n\n  /**\n   * Creates a new {@link Collections.Collectible | Collectible} instance with a defined, strongly-typed index.\n   * @param params - {@link Collections.ICollectibleConstructorParamsWithIndex | Parameters} for constructing\n   * the collectible.\n   * @returns {@link Success} with the new collectible if successful, {@link Failure} otherwise.\n   */\n  public static createCollectible<TKEY extends string = string, TINDEX extends number = number>(\n    params: ICollectibleConstructorParamsWithIndex<TKEY, TINDEX>\n  ): Result<Collectible<TKEY, TINDEX>>;\n\n  /**\n   * Creates a new {@link Collections.Collectible | Collectible} instance with an undefined index and an index\n   * converter to validate the index when it is set.\n   * @param params - {@link Collections.ICollectibleConstructorParamsWithConverter | Parameters} for constructing\n   * the collectible.\n   * @returns {@link Success} with the new collectible if successful, {@link Failure} otherwise.\n   */\n  public static createCollectible<TKEY extends string = string, TINDEX extends number = number>(\n    params: ICollectibleConstructorParamsWithConverter<TKEY, TINDEX>\n  ): Result<Collectible<TKEY, TINDEX>>;\n\n  /**\n   * Creates a new {@link Collections.Collectible | Collectible} instance.\n   * @param params - {@link Collections.ICollectibleConstructorParams | Parameters} for constructing\n   * the collectible.\n   * @returns {@link Success} with the new collectible if successful, {@link Failure} otherwise\n   * @public\n   */\n  public static createCollectible<TKEY extends string = string, TINDEX extends number = number>(\n    params: ICollectibleConstructorParams<TKEY, TINDEX>\n  ): Result<Collectible<TKEY, TINDEX>>;\n\n  public static createCollectible<TKEY extends string = string, TINDEX extends number = number>(\n    params: ICollectibleConstructorParams<TKEY, TINDEX>\n  ): Result<Collectible<TKEY, TINDEX>> {\n    return captureResult(() => new Collectible(params));\n  }\n\n  /**\n   * {@link Collections.ICollectible.setIndex}\n   */\n  public setIndex(index: number): Result<TINDEX> {\n    let converted: TINDEX | undefined;\n    if (this._indexConverter) {\n      const { value, message } = this._indexConverter.convert(index);\n      /* c8 ignore next 3 - there's a test for this but coverage is having a bad day */\n      if (message) {\n        return fail(message);\n      }\n      converted = value;\n    }\n\n    if (index === this.index) {\n      return succeed(this.index);\n    } else if (this._index !== undefined) {\n      return fail(`index ${this.index} is immutable and cannot be changed to ${index}`);\n    }\n\n    /* c8 ignore next 3 - should be impossible */\n    if (converted === undefined) {\n      return fail(`index ${index} cannot be set on a Collectible without an index converter`);\n    }\n\n    this._index = converted;\n    return succeed(converted);\n  }\n}\n"]}

package/lib/packlets/collections/collector.d.ts

@@ -46,7 +46,7 @@ export declare class Collector<TITEM extends ICollectible<any, any>> implements
     private readonly _byKey;
     private readonly _byIndex;
     /**
-     * {@inheritDoc Collections.ResultMap.size}
+     * Returns the number of entries in the map.
      */
     get size(): number;
     /**
@@ -73,19 +73,28 @@ export declare class Collector<TITEM extends ICollectible<any, any>> implements
      */
     add(item: TITEM): DetailedResult<TITEM, CollectorResultDetail>;
     /**
-     * {@inheritDoc Collections.ResultMap.entries}
+     * Returns an iterator over the map entries.
+     * @returns An iterator over the map entries.
      */
     entries(): IterableIterator<KeyValueEntry<CollectibleKey<TITEM>, TITEM>>;
     /**
-     * {@inheritDoc Collections.ResultMap.forEach}
+     * Calls a function for each entry in the map.
+     * @param callback - The function to call for each entry.
+     * @param arg - An optional argument to pass to the callback.
      */
     forEach(callback: ResultMapForEachCb<CollectibleKey<TITEM>, TITEM>, arg?: unknown): void;
     /**
-     * {@inheritDoc Collections.ResultMap.get}
+     * Gets a value by key.
+     * @param key - The key to look up.
+     * @returns Returns {@link DetailedSuccess | Success} with the value and detail `exists` if found,
+     * or {@link DetailedFailure | Failure} with detail `not-found` if the key does not exist.
      */
     get(key: CollectibleKey<TITEM>): DetailedResult<TITEM, ResultMapResultDetail>;
     /**
-     * {@inheritDoc Collections.IReadOnlyCollector.getAt}
+     * Gets the item at a specified index.
+     * @param index - The index of the item to retrieve.
+     * @returns Returns {@link Success | Success} with the item if it exists, or {@link Failure | Failure}
+     * with an error if the index is out of range.
      */
     getAt(index: number): Result<TITEM>;
     /**
@@ -110,19 +119,24 @@ export declare class Collector<TITEM extends ICollectible<any, any>> implements
      */
     getOrAdd(key: CollectibleKey<TITEM>, factory: CollectibleFactoryCallback<TITEM>): DetailedResult<TITEM, CollectorResultDetail>;
     /**
-     * {@inheritDoc Collections.ResultMap.has}
+     * Returns true if the map contains an entry with the given key.
+     * @param key - The key to check for.
+     * @returns `true` if the key exists, `false` otherwise.
      */
     has(key: CollectibleKey<TITEM>): boolean;
     /**
-     * {@inheritDoc Collections.ResultMap.keys}
+     * Returns an iterator over the map keys.
+     * @returns An iterator over the map keys.
      */
     keys(): IterableIterator<CollectibleKey<TITEM>>;
     /**
-     * {@inheritDoc Collections.ResultMap.values}
+     * Returns an iterator over the map values.
+     * @returns An iterator over the map values.
      */
     values(): IterableIterator<TITEM>;
     /**
-     * {@inheritDoc Collections.IReadOnlyCollector.valuesByIndex}
+     * Gets all items in the collection, ordered by index.
+     * @returns An array of items in the collection, ordered by index.
      */
     valuesByIndex(): ReadonlyArray<TITEM>;
     /**