@gtkx/utils 0.21.0 → 1.0.0-rc.2

package/dist/error/error-message.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-message.js","sourceRoot":"","sources":["../../src/error/error-message.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAE9C;;;;;;;;;GASG;AACH,SAAS,YAAY,CAAC,KAAc;IAChC,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACtF,CAAC;AAED,OAAO,EAAE,YAAY,EAAE,CAAC","sourcesContent":["import { isErrorLike } from \"./error-like.js\";\n\n/**\n * Extracts a human-readable message from an unknown thrown value, falling back to its string form.\n *\n * @param error - The caught value to describe.\n * @returns The value's message when it has one, otherwise its string form.\n *\n * @example\n * errorMessage(new Error(\"boom\")); // \"boom\"\n * errorMessage(42); // \"42\"\n */\nfunction errorMessage(error: unknown): string {\n    return Error.isError(error) || isErrorLike(error) ? error.message : String(error);\n}\n\nexport { errorMessage };\n"]}

package/dist/error/format-child-process-error.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Combines the `stderr` and `stdout` of a failed child-process error into a single trimmed string.
+ *
+ * @param error - The child-process error to read output from.
+ * @returns The joined output, or `undefined` when neither stream carried any text.
+ *
+ * @example
+ * formatChildProcessError({ stderr: "boom" }); // "boom"
+ */
+declare function formatChildProcessError(error: unknown): string | undefined;
+export { formatChildProcessError };
+//# sourceMappingURL=format-child-process-error.d.ts.map

package/dist/error/format-child-process-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-child-process-error.d.ts","sourceRoot":"","sources":["../../src/error/format-child-process-error.ts"],"names":[],"mappings":"AAGA;;;;;;;;GAQG;AACH,iBAAS,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CASnE;AAED,OAAO,EAAE,uBAAuB,EAAE,CAAC"}

package/dist/error/format-child-process-error.js

@@ -0,0 +1,21 @@
+import { isRecord } from "../predicate/is-record.js";
+import { readStream } from "./error-like.js";
+/**
+ * Combines the `stderr` and `stdout` of a failed child-process error into a single trimmed string.
+ *
+ * @param error - The child-process error to read output from.
+ * @returns The joined output, or `undefined` when neither stream carried any text.
+ *
+ * @example
+ * formatChildProcessError({ stderr: "boom" }); // "boom"
+ */
+function formatChildProcessError(error) {
+    if (!isRecord(error)) {
+        return undefined;
+    }
+    const { stderr, stdout } = error;
+    const details = [readStream(stderr), readStream(stdout)].filter(Boolean).join("\n").trim();
+    return details.length > 0 ? details : undefined;
+}
+export { formatChildProcessError };
+//# sourceMappingURL=format-child-process-error.js.map

package/dist/error/format-child-process-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-child-process-error.js","sourceRoot":"","sources":["../../src/error/format-child-process-error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C;;;;;;;;GAQG;AACH,SAAS,uBAAuB,CAAC,KAAc;IAC3C,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACnB,OAAO,SAAS,CAAC;IACrB,CAAC;IAED,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,KAAK,CAAC;IACjC,MAAM,OAAO,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;IAE3F,OAAO,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;AACpD,CAAC;AAED,OAAO,EAAE,uBAAuB,EAAE,CAAC","sourcesContent":["import { isRecord } from \"../predicate/is-record.js\";\nimport { readStream } from \"./error-like.js\";\n\n/**\n * Combines the `stderr` and `stdout` of a failed child-process error into a single trimmed string.\n *\n * @param error - The child-process error to read output from.\n * @returns The joined output, or `undefined` when neither stream carried any text.\n *\n * @example\n * formatChildProcessError({ stderr: \"boom\" }); // \"boom\"\n */\nfunction formatChildProcessError(error: unknown): string | undefined {\n    if (!isRecord(error)) {\n        return undefined;\n    }\n\n    const { stderr, stdout } = error;\n    const details = [readStream(stderr), readStream(stdout)].filter(Boolean).join(\"\\n\").trim();\n\n    return details.length > 0 ? details : undefined;\n}\n\nexport { formatChildProcessError };\n"]}

package/dist/error/index.d.ts

@@ -0,0 +1,4 @@
+export { errorMessage } from "./error-message.js";
+export { formatChildProcessError } from "./format-child-process-error.js";
+export { normalizeError } from "./normalize-error.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/error/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/error/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAC1E,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/error/index.js

@@ -0,0 +1,4 @@
+export { errorMessage } from "./error-message.js";
+export { formatChildProcessError } from "./format-child-process-error.js";
+export { normalizeError } from "./normalize-error.js";
+//# sourceMappingURL=index.js.map

package/dist/error/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/error/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAC1E,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC","sourcesContent":["export { errorMessage } from \"./error-message.js\";\nexport { formatChildProcessError } from \"./format-child-process-error.js\";\nexport { normalizeError } from \"./normalize-error.js\";\n"]}

package/dist/error/normalize-error.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Coerces an unknown thrown value into an `Error`, reusing it when it already is one and otherwise
+ * wrapping its message while copying any error-like own properties.
+ *
+ * @param error - The caught value to normalize.
+ * @returns The value itself when it is an `Error`, otherwise a new `Error` carrying its message.
+ *
+ * @example
+ * normalizeError("boom"); // Error: boom
+ */
+declare function normalizeError(error: unknown): Error;
+export { normalizeError };
+//# sourceMappingURL=normalize-error.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"normalize-error.d.ts","sourceRoot":"","sources":["../../src/error/normalize-error.ts"],"names":[],"mappings":"AAGA;;;;;;;;;GASG;AACH,iBAAS,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,CAM7C;AAED,OAAO,EAAE,cAAc,EAAE,CAAC"}

package/dist/error/normalize-error.js

@@ -0,0 +1,20 @@
+import { isErrorLike } from "./error-like.js";
+import { errorMessage } from "./error-message.js";
+/**
+ * Coerces an unknown thrown value into an `Error`, reusing it when it already is one and otherwise
+ * wrapping its message while copying any error-like own properties.
+ *
+ * @param error - The caught value to normalize.
+ * @returns The value itself when it is an `Error`, otherwise a new `Error` carrying its message.
+ *
+ * @example
+ * normalizeError("boom"); // Error: boom
+ */
+function normalizeError(error) {
+    if (Error.isError(error)) {
+        return error;
+    }
+    return Object.assign(new Error(errorMessage(error)), isErrorLike(error) ? error : {});
+}
+export { normalizeError };
+//# sourceMappingURL=normalize-error.js.map

package/dist/error/normalize-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize-error.js","sourceRoot":"","sources":["../../src/error/normalize-error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD;;;;;;;;;GASG;AACH,SAAS,cAAc,CAAC,KAAc;IAClC,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,KAAK,CAAC;IACjB,CAAC;IAED,OAAO,MAAM,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,EAAE,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;AAC1F,CAAC;AAED,OAAO,EAAE,cAAc,EAAE,CAAC","sourcesContent":["import { isErrorLike } from \"./error-like.js\";\nimport { errorMessage } from \"./error-message.js\";\n\n/**\n * Coerces an unknown thrown value into an `Error`, reusing it when it already is one and otherwise\n * wrapping its message while copying any error-like own properties.\n *\n * @param error - The caught value to normalize.\n * @returns The value itself when it is an `Error`, otherwise a new `Error` carrying its message.\n *\n * @example\n * normalizeError(\"boom\"); // Error: boom\n */\nfunction normalizeError(error: unknown): Error {\n    if (Error.isError(error)) {\n        return error;\n    }\n\n    return Object.assign(new Error(errorMessage(error)), isErrorLike(error) ? error : {});\n}\n\nexport { normalizeError };\n"]}

package/dist/function/call-method.d.ts

@@ -0,0 +1,3 @@
+declare function callMethod(target: object, method: string, args: unknown[]): unknown;
+export { callMethod };
+//# sourceMappingURL=call-method.d.ts.map

package/dist/function/call-method.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"call-method.d.ts","sourceRoot":"","sources":["../../src/function/call-method.ts"],"names":[],"mappings":"AAeA,iBAAS,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,OAAO,CAI5E;AAED,OAAO,EAAE,UAAU,EAAE,CAAC"}

package/dist/function/call-method.js

@@ -0,0 +1,19 @@
+/**
+ * Calls the named method on `target` with the given arguments, returning `undefined` when the
+ * property is missing or not callable.
+ *
+ * @param target - The object to read the method from and bind as `this`.
+ * @param method - The name of the method to look up.
+ * @param args - The arguments passed to the method.
+ * @returns The method's return value, or `undefined` when it is not a function.
+ *
+ * @example
+ * callMethod(console, "log", ["hi"]); // logs "hi"; returns undefined
+ */
+const isCallable = (value) => typeof value === "function";
+function callMethod(target, method, args) {
+    const fn = Reflect.get(target, method);
+    return isCallable(fn) ? Reflect.apply(fn, target, args) : undefined;
+}
+export { callMethod };
+//# sourceMappingURL=call-method.js.map

package/dist/function/call-method.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"call-method.js","sourceRoot":"","sources":["../../src/function/call-method.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,GAAG,CAAC,KAAc,EAA0D,EAAE,CAC1F,OAAO,KAAK,KAAK,UAAU,CAAC;AAEhC,SAAS,UAAU,CAAC,MAAc,EAAE,MAAc,EAAE,IAAe;IAC/D,MAAM,EAAE,GAAY,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEhD,OAAO,UAAU,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AACxE,CAAC;AAED,OAAO,EAAE,UAAU,EAAE,CAAC","sourcesContent":["/**\n * Calls the named method on `target` with the given arguments, returning `undefined` when the\n * property is missing or not callable.\n *\n * @param target - The object to read the method from and bind as `this`.\n * @param method - The name of the method to look up.\n * @param args - The arguments passed to the method.\n * @returns The method's return value, or `undefined` when it is not a function.\n *\n * @example\n * callMethod(console, \"log\", [\"hi\"]); // logs \"hi\"; returns undefined\n */\nconst isCallable = (value: unknown): value is (this: object, ...args: unknown[]) => unknown =>\n    typeof value === \"function\";\n\nfunction callMethod(target: object, method: string, args: unknown[]): unknown {\n    const fn: unknown = Reflect.get(target, method);\n\n    return isCallable(fn) ? Reflect.apply(fn, target, args) : undefined;\n}\n\nexport { callMethod };\n"]}

package/dist/function/index.d.ts

@@ -0,0 +1,2 @@
+export { callMethod } from "./call-method.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/function/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/function/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/function/index.js

@@ -0,0 +1,2 @@
+export { callMethod } from "./call-method.js";
+//# sourceMappingURL=index.js.map

package/dist/function/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/function/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC","sourcesContent":["export { callMethod } from \"./call-method.js\";\n"]}

package/dist/index.d.ts

@@ -1,7 +1,14 @@
-export type { AnyClass } from "./class.js";
-export { isShallowArrayEqual, isShallowEqual, omit, reverseNumericEnum } from "./collection.js";
-export { errorMessage } from "./error.js";
-export { exitCodeForSignal, type GracefulShutdownHandle, installGracefulShutdown, } from "./graceful-shutdown.js";
-export { quote, toIdentifier } from "./source.js";
-export { toCamelCase, toKebabCase, toPascalCase, toUpperFirst } from "./string.js";
+export * from "./array/index.js";
+export * from "./class/index.js";
+export * from "./error/index.js";
+export * from "./function/index.js";
+export * from "./log/index.js";
+export * from "./map/index.js";
+export * from "./object/index.js";
+export * from "./predicate/index.js";
+export * from "./process/index.js";
+export * from "./set/index.js";
+export * from "./source/index.js";
+export * from "./string/index.js";
+export * from "./util/index.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,IAAI,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAChG,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EACH,iBAAiB,EACjB,KAAK,sBAAsB,EAC3B,uBAAuB,GAC1B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC"}

package/dist/index.js

@@ -1,6 +1,14 @@
-export { isShallowArrayEqual, isShallowEqual, omit, reverseNumericEnum } from "./collection.js";
-export { errorMessage } from "./error.js";
-export { exitCodeForSignal, installGracefulShutdown, } from "./graceful-shutdown.js";
-export { quote, toIdentifier } from "./source.js";
-export { toCamelCase, toKebabCase, toPascalCase, toUpperFirst } from "./string.js";
+export * from "./array/index.js";
+export * from "./class/index.js";
+export * from "./error/index.js";
+export * from "./function/index.js";
+export * from "./log/index.js";
+export * from "./map/index.js";
+export * from "./object/index.js";
+export * from "./predicate/index.js";
+export * from "./process/index.js";
+export * from "./set/index.js";
+export * from "./source/index.js";
+export * from "./string/index.js";
+export * from "./util/index.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,IAAI,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAChG,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EACH,iBAAiB,EAEjB,uBAAuB,GAC1B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC","sourcesContent":["export * from \"./array/index.js\";\nexport * from \"./class/index.js\";\nexport * from \"./error/index.js\";\nexport * from \"./function/index.js\";\nexport * from \"./log/index.js\";\nexport * from \"./map/index.js\";\nexport * from \"./object/index.js\";\nexport * from \"./predicate/index.js\";\nexport * from \"./process/index.js\";\nexport * from \"./set/index.js\";\nexport * from \"./source/index.js\";\nexport * from \"./string/index.js\";\nexport * from \"./util/index.js\";\n"]}

package/dist/log/create-logger.d.ts

@@ -0,0 +1,15 @@
+import { Logger, type LoggerOptions } from "./logger.js";
+/**
+ * Creates a {@link Logger} scoped to the given namespace.
+ *
+ * @param namespace - Namespace added to the log prefix and matched against debug configuration.
+ * @param options - Further logger options, excluding the namespace.
+ * @returns A new namespaced logger.
+ *
+ * @example
+ * const log = createLogger("react");
+ * log.info("mounted");
+ */
+declare function createLogger(namespace: string, options?: Omit<LoggerOptions, "namespace">): Logger;
+export { createLogger };
+//# sourceMappingURL=create-logger.d.ts.map

package/dist/log/create-logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-logger.d.ts","sourceRoot":"","sources":["../../src/log/create-logger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAEzD;;;;;;;;;;GAUG;AACH,iBAAS,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,GAAE,IAAI,CAAC,aAAa,EAAE,WAAW,CAAM,GAAG,MAAM,CAE/F;AAED,OAAO,EAAE,YAAY,EAAE,CAAC"}

package/dist/log/create-logger.js

@@ -0,0 +1,17 @@
+import { Logger } from "./logger.js";
+/**
+ * Creates a {@link Logger} scoped to the given namespace.
+ *
+ * @param namespace - Namespace added to the log prefix and matched against debug configuration.
+ * @param options - Further logger options, excluding the namespace.
+ * @returns A new namespaced logger.
+ *
+ * @example
+ * const log = createLogger("react");
+ * log.info("mounted");
+ */
+function createLogger(namespace, options = {}) {
+    return new Logger({ ...options, namespace });
+}
+export { createLogger };
+//# sourceMappingURL=create-logger.js.map

package/dist/log/create-logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-logger.js","sourceRoot":"","sources":["../../src/log/create-logger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAsB,MAAM,aAAa,CAAC;AAEzD;;;;;;;;;;GAUG;AACH,SAAS,YAAY,CAAC,SAAiB,EAAE,UAA4C,EAAE;IACnF,OAAO,IAAI,MAAM,CAAC,EAAE,GAAG,OAAO,EAAE,SAAS,EAAE,CAAC,CAAC;AACjD,CAAC;AAED,OAAO,EAAE,YAAY,EAAE,CAAC","sourcesContent":["import { Logger, type LoggerOptions } from \"./logger.js\";\n\n/**\n * Creates a {@link Logger} scoped to the given namespace.\n *\n * @param namespace - Namespace added to the log prefix and matched against debug configuration.\n * @param options - Further logger options, excluding the namespace.\n * @returns A new namespaced logger.\n *\n * @example\n * const log = createLogger(\"react\");\n * log.info(\"mounted\");\n */\nfunction createLogger(namespace: string, options: Omit<LoggerOptions, \"namespace\"> = {}): Logger {\n    return new Logger({ ...options, namespace });\n}\n\nexport { createLogger };\n"]}

package/dist/log/default-logger.d.ts

@@ -0,0 +1,36 @@
+import { Logger } from "./logger.js";
+/**
+ * The default namespace-less {@link Logger} backing the module-level {@link info}, {@link warn},
+ * {@link error}, and {@link debug} functions.
+ */
+declare const logger: Logger;
+/**
+ * Writes an informational line through the shared {@link logger}.
+ *
+ * @param message - The message text.
+ * @param rest - Extra values appended after the message, formatted for display.
+ */
+declare function info(message: string, ...rest: unknown[]): void;
+/**
+ * Writes a warning line through the shared {@link logger}.
+ *
+ * @param message - The message text.
+ * @param rest - Extra values appended after the message, formatted for display.
+ */
+declare function warn(message: string, ...rest: unknown[]): void;
+/**
+ * Writes an error line through the shared {@link logger}.
+ *
+ * @param message - The message text.
+ * @param rest - Extra values appended after the message, formatted for display.
+ */
+declare function error(message: string, ...rest: unknown[]): void;
+/**
+ * Writes a debug line through the shared {@link logger} when debug output is enabled.
+ *
+ * @param message - The message text.
+ * @param rest - Extra values appended after the message, formatted for display.
+ */
+declare function debug(message: string, ...rest: unknown[]): void;
+export { logger, info, warn, error, debug };
+//# sourceMappingURL=default-logger.d.ts.map

package/dist/log/default-logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"default-logger.d.ts","sourceRoot":"","sources":["../../src/log/default-logger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC;;;GAGG;AACH,QAAA,MAAM,MAAM,EAAE,MAAqB,CAAC;AAEpC;;;;;GAKG;AACH,iBAAS,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAEvD;AAED;;;;;GAKG;AACH,iBAAS,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAEvD;AAED;;;;;GAKG;AACH,iBAAS,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAExD;AAED;;;;;GAKG;AACH,iBAAS,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAExD;AAED,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC"}

package/dist/log/default-logger.js

@@ -0,0 +1,44 @@
+import { Logger } from "./logger.js";
+/**
+ * The default namespace-less {@link Logger} backing the module-level {@link info}, {@link warn},
+ * {@link error}, and {@link debug} functions.
+ */
+const logger = new Logger();
+/**
+ * Writes an informational line through the shared {@link logger}.
+ *
+ * @param message - The message text.
+ * @param rest - Extra values appended after the message, formatted for display.
+ */
+function info(message, ...rest) {
+    logger.info(message, ...rest);
+}
+/**
+ * Writes a warning line through the shared {@link logger}.
+ *
+ * @param message - The message text.
+ * @param rest - Extra values appended after the message, formatted for display.
+ */
+function warn(message, ...rest) {
+    logger.warn(message, ...rest);
+}
+/**
+ * Writes an error line through the shared {@link logger}.
+ *
+ * @param message - The message text.
+ * @param rest - Extra values appended after the message, formatted for display.
+ */
+function error(message, ...rest) {
+    logger.error(message, ...rest);
+}
+/**
+ * Writes a debug line through the shared {@link logger} when debug output is enabled.
+ *
+ * @param message - The message text.
+ * @param rest - Extra values appended after the message, formatted for display.
+ */
+function debug(message, ...rest) {
+    logger.debug(message, ...rest);
+}
+export { logger, info, warn, error, debug };
+//# sourceMappingURL=default-logger.js.map

package/dist/log/default-logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"default-logger.js","sourceRoot":"","sources":["../../src/log/default-logger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC;;;GAGG;AACH,MAAM,MAAM,GAAW,IAAI,MAAM,EAAE,CAAC;AAEpC;;;;;GAKG;AACH,SAAS,IAAI,CAAC,OAAe,EAAE,GAAG,IAAe;IAC7C,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;AAClC,CAAC;AAED;;;;;GAKG;AACH,SAAS,IAAI,CAAC,OAAe,EAAE,GAAG,IAAe;IAC7C,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;AAClC,CAAC;AAED;;;;;GAKG;AACH,SAAS,KAAK,CAAC,OAAe,EAAE,GAAG,IAAe;IAC9C,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;AACnC,CAAC;AAED;;;;;GAKG;AACH,SAAS,KAAK,CAAC,OAAe,EAAE,GAAG,IAAe;IAC9C,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;AACnC,CAAC;AAED,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC","sourcesContent":["import { Logger } from \"./logger.js\";\n\n/**\n * The default namespace-less {@link Logger} backing the module-level {@link info}, {@link warn},\n * {@link error}, and {@link debug} functions.\n */\nconst logger: Logger = new Logger();\n\n/**\n * Writes an informational line through the shared {@link logger}.\n *\n * @param message - The message text.\n * @param rest - Extra values appended after the message, formatted for display.\n */\nfunction info(message: string, ...rest: unknown[]): void {\n    logger.info(message, ...rest);\n}\n\n/**\n * Writes a warning line through the shared {@link logger}.\n *\n * @param message - The message text.\n * @param rest - Extra values appended after the message, formatted for display.\n */\nfunction warn(message: string, ...rest: unknown[]): void {\n    logger.warn(message, ...rest);\n}\n\n/**\n * Writes an error line through the shared {@link logger}.\n *\n * @param message - The message text.\n * @param rest - Extra values appended after the message, formatted for display.\n */\nfunction error(message: string, ...rest: unknown[]): void {\n    logger.error(message, ...rest);\n}\n\n/**\n * Writes a debug line through the shared {@link logger} when debug output is enabled.\n *\n * @param message - The message text.\n * @param rest - Extra values appended after the message, formatted for display.\n */\nfunction debug(message: string, ...rest: unknown[]): void {\n    logger.debug(message, ...rest);\n}\n\nexport { logger, info, warn, error, debug };\n"]}

package/dist/log/index.d.ts

@@ -0,0 +1,4 @@
+export { createLogger } from "./create-logger.js";
+export { debug, error, info, logger, warn } from "./default-logger.js";
+export { Logger, type LoggerOptions, type OutputStream } from "./logger.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/log/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/log/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AACvE,OAAO,EAAE,MAAM,EAAE,KAAK,aAAa,EAAE,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC"}

package/dist/log/index.js

@@ -0,0 +1,4 @@
+export { createLogger } from "./create-logger.js";
+export { debug, error, info, logger, warn } from "./default-logger.js";
+export { Logger } from "./logger.js";
+//# sourceMappingURL=index.js.map

package/dist/log/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/log/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AACvE,OAAO,EAAE,MAAM,EAAyC,MAAM,aAAa,CAAC","sourcesContent":["export { createLogger } from \"./create-logger.js\";\nexport { debug, error, info, logger, warn } from \"./default-logger.js\";\nexport { Logger, type LoggerOptions, type OutputStream } from \"./logger.js\";\n"]}

package/dist/log/logger.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Minimal writable-stream shape a {@link Logger} writes formatted lines to.
+ */
+type OutputStream = {
+    write(chunk: string): unknown;
+    /** Whether the stream is a terminal, used to decide if colored output is emitted. */
+    isTTY?: boolean | undefined;
+};
+/**
+ * Options for constructing a {@link Logger}.
+ */
+type LoggerOptions = {
+    /** Namespace appended to the log prefix and matched against debug configuration. */
+    namespace?: string | undefined;
+    /** Stream to write log lines to; defaults to `process.stderr`. */
+    stream?: OutputStream | undefined;
+    /** Forces debug output on or off; when omitted it is resolved from `--debug` and `GTKX_DEBUG`. */
+    debugEnabled?: boolean | undefined;
+};
+/**
+ * Writes prefixed, optionally colored log lines to an output stream, with debug lines gated by
+ * command-line and environment configuration.
+ */
+declare class Logger {
+    private stream;
+    private prefix;
+    private debugEnabled;
+    private colors;
+    /**
+     * @param options - Namespace, target stream, and debug configuration for the logger.
+     */
+    constructor(options?: LoggerOptions);
+    private write;
+    /**
+     * Writes an informational line.
+     *
+     * @param message - The message text.
+     * @param rest - Extra values appended after the message, formatted for display.
+     */
+    info(message: string, ...rest: unknown[]): void;
+    /**
+     * Writes a line marked as a warning.
+     *
+     * @param message - The message text.
+     * @param rest - Extra values appended after the message, formatted for display.
+     */
+    warn(message: string, ...rest: unknown[]): void;
+    /**
+     * Writes a line marked as an error.
+     *
+     * @param message - The message text.
+     * @param rest - Extra values appended after the message, formatted for display.
+     */
+    error(message: string, ...rest: unknown[]): void;
+    /**
+     * Writes a line only when debug output is enabled for this logger.
+     *
+     * @param message - The message text.
+     * @param rest - Extra values appended after the message, formatted for display.
+     */
+    debug(message: string, ...rest: unknown[]): void;
+}
+export { Logger, type OutputStream, type LoggerOptions };
+//# sourceMappingURL=logger.d.ts.map

package/dist/log/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/log/logger.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,KAAK,YAAY,GAAG;IAChB,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;IAC9B,qFAAqF;IACrF,KAAK,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CAC/B,CAAC;AAEF;;GAEG;AACH,KAAK,aAAa,GAAG;IACjB,oFAAoF;IACpF,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,kEAAkE;IAClE,MAAM,CAAC,EAAE,YAAY,GAAG,SAAS,CAAC;IAClC,kGAAkG;IAClG,YAAY,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CACtC,CAAC;AAgDF;;;GAGG;AACH,cAAM,MAAM;IACR,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,YAAY,CAAU;IAC9B,OAAO,CAAC,MAAM,CAAS;IAEvB;;OAEG;gBACS,OAAO,GAAE,aAAkB;IAOvC,OAAO,CAAC,KAAK;IAKb;;;;;OAKG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAI/C;;;;;OAKG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAI/C;;;;;OAKG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAIhD;;;;;OAKG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;CAOnD;AAED,OAAO,EAAE,MAAM,EAAE,KAAK,YAAY,EAAE,KAAK,aAAa,EAAE,CAAC"}

package/dist/log/logger.js

@@ -0,0 +1,100 @@
+import pc from "picocolors";
+const BASE_PREFIX = "[gtkx]";
+function getColors(stream) {
+    return pc.createColors(pc.isColorSupported && stream.isTTY === true);
+}
+function formatValue(value) {
+    if (typeof value === "string") {
+        return value;
+    }
+    if (value instanceof Error) {
+        return value.stack ?? value.message;
+    }
+    try {
+        return JSON.stringify(value);
+    }
+    catch {
+        return String(value);
+    }
+}
+function isDebugEnabled(namespace, argv, env) {
+    if (argv.includes("--debug")) {
+        return true;
+    }
+    const spec = env.GTKX_DEBUG;
+    if (!spec) {
+        return false;
+    }
+    const names = new Set(spec.split(/[\s,]+/).filter((name) => name.length > 0));
+    if (names.has("1") || names.has("*")) {
+        return true;
+    }
+    return namespace !== undefined && names.has(namespace);
+}
+function getPrefix(namespace) {
+    return namespace === undefined ? BASE_PREFIX : `[gtkx:${namespace}]`;
+}
+/**
+ * Writes prefixed, optionally colored log lines to an output stream, with debug lines gated by
+ * command-line and environment configuration.
+ */
+class Logger {
+    stream;
+    prefix;
+    debugEnabled;
+    colors;
+    /**
+     * @param options - Namespace, target stream, and debug configuration for the logger.
+     */
+    constructor(options = {}) {
+        this.stream = options.stream ?? process.stderr;
+        this.prefix = getPrefix(options.namespace);
+        this.debugEnabled = options.debugEnabled ?? isDebugEnabled(options.namespace, process.argv, process.env);
+        this.colors = getColors(this.stream);
+    }
+    write(message, rest) {
+        const suffix = rest.length === 0 ? "" : ` ${rest.map((value) => formatValue(value)).join(" ")}`;
+        this.stream.write(`${this.prefix} ${message}${suffix}\n`);
+    }
+    /**
+     * Writes an informational line.
+     *
+     * @param message - The message text.
+     * @param rest - Extra values appended after the message, formatted for display.
+     */
+    info(message, ...rest) {
+        this.write(message, rest);
+    }
+    /**
+     * Writes a line marked as a warning.
+     *
+     * @param message - The message text.
+     * @param rest - Extra values appended after the message, formatted for display.
+     */
+    warn(message, ...rest) {
+        this.write(`${this.colors.yellow("warn")} ${message}`, rest);
+    }
+    /**
+     * Writes a line marked as an error.
+     *
+     * @param message - The message text.
+     * @param rest - Extra values appended after the message, formatted for display.
+     */
+    error(message, ...rest) {
+        this.write(`${this.colors.red("error")} ${message}`, rest);
+    }
+    /**
+     * Writes a line only when debug output is enabled for this logger.
+     *
+     * @param message - The message text.
+     * @param rest - Extra values appended after the message, formatted for display.
+     */
+    debug(message, ...rest) {
+        if (!this.debugEnabled) {
+            return;
+        }
+        this.write(message, rest);
+    }
+}
+export { Logger };
+//# sourceMappingURL=logger.js.map

package/dist/log/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/log/logger.ts"],"names":[],"mappings":"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","sourcesContent":["import pc from \"picocolors\";\n\ntype Colors = ReturnType<typeof pc.createColors>;\n\n/**\n * Minimal writable-stream shape a {@link Logger} writes formatted lines to.\n */\ntype OutputStream = {\n    write(chunk: string): unknown;\n    /** Whether the stream is a terminal, used to decide if colored output is emitted. */\n    isTTY?: boolean | undefined;\n};\n\n/**\n * Options for constructing a {@link Logger}.\n */\ntype LoggerOptions = {\n    /** Namespace appended to the log prefix and matched against debug configuration. */\n    namespace?: string | undefined;\n    /** Stream to write log lines to; defaults to `process.stderr`. */\n    stream?: OutputStream | undefined;\n    /** Forces debug output on or off; when omitted it is resolved from `--debug` and `GTKX_DEBUG`. */\n    debugEnabled?: boolean | undefined;\n};\n\nconst BASE_PREFIX = \"[gtkx]\";\n\nfunction getColors(stream: OutputStream): Colors {\n    return pc.createColors(pc.isColorSupported && stream.isTTY === true);\n}\n\nfunction formatValue(value: unknown): string {\n    if (typeof value === \"string\") {\n        return value;\n    }\n\n    if (value instanceof Error) {\n        return value.stack ?? value.message;\n    }\n\n    try {\n        return JSON.stringify(value);\n    } catch {\n        return String(value);\n    }\n}\n\nfunction isDebugEnabled(namespace: string | undefined, argv: string[], env: NodeJS.ProcessEnv): boolean {\n    if (argv.includes(\"--debug\")) {\n        return true;\n    }\n\n    const spec = env.GTKX_DEBUG;\n\n    if (!spec) {\n        return false;\n    }\n\n    const names = new Set(spec.split(/[\\s,]+/).filter((name) => name.length > 0));\n\n    if (names.has(\"1\") || names.has(\"*\")) {\n        return true;\n    }\n\n    return namespace !== undefined && names.has(namespace);\n}\n\nfunction getPrefix(namespace: string | undefined): string {\n    return namespace === undefined ? BASE_PREFIX : `[gtkx:${namespace}]`;\n}\n\n/**\n * Writes prefixed, optionally colored log lines to an output stream, with debug lines gated by\n * command-line and environment configuration.\n */\nclass Logger {\n    private stream: OutputStream;\n    private prefix: string;\n    private debugEnabled: boolean;\n    private colors: Colors;\n\n    /**\n     * @param options - Namespace, target stream, and debug configuration for the logger.\n     */\n    constructor(options: LoggerOptions = {}) {\n        this.stream = options.stream ?? process.stderr;\n        this.prefix = getPrefix(options.namespace);\n        this.debugEnabled = options.debugEnabled ?? isDebugEnabled(options.namespace, process.argv, process.env);\n        this.colors = getColors(this.stream);\n    }\n\n    private write(message: string, rest: unknown[]): void {\n        const suffix = rest.length === 0 ? \"\" : ` ${rest.map((value) => formatValue(value)).join(\" \")}`;\n        this.stream.write(`${this.prefix} ${message}${suffix}\\n`);\n    }\n\n    /**\n     * Writes an informational line.\n     *\n     * @param message - The message text.\n     * @param rest - Extra values appended after the message, formatted for display.\n     */\n    info(message: string, ...rest: unknown[]): void {\n        this.write(message, rest);\n    }\n\n    /**\n     * Writes a line marked as a warning.\n     *\n     * @param message - The message text.\n     * @param rest - Extra values appended after the message, formatted for display.\n     */\n    warn(message: string, ...rest: unknown[]): void {\n        this.write(`${this.colors.yellow(\"warn\")} ${message}`, rest);\n    }\n\n    /**\n     * Writes a line marked as an error.\n     *\n     * @param message - The message text.\n     * @param rest - Extra values appended after the message, formatted for display.\n     */\n    error(message: string, ...rest: unknown[]): void {\n        this.write(`${this.colors.red(\"error\")} ${message}`, rest);\n    }\n\n    /**\n     * Writes a line only when debug output is enabled for this logger.\n     *\n     * @param message - The message text.\n     * @param rest - Extra values appended after the message, formatted for display.\n     */\n    debug(message: string, ...rest: unknown[]): void {\n        if (!this.debugEnabled) {\n            return;\n        }\n\n        this.write(message, rest);\n    }\n}\n\nexport { Logger, type OutputStream, type LoggerOptions };\n"]}

package/dist/map/get-or-insert.d.ts

@@ -0,0 +1,23 @@
+type GetSet<K, V> = {
+    get(key: K): V | undefined;
+    set(key: K, value: V): unknown;
+    has(key: K): boolean;
+};
+/**
+ * Returns the value stored under `key`, or inserts and returns the value produced by `factory` when
+ * the key is absent. Works with both `Map` and `WeakMap`, and caches a computed `undefined` value.
+ *
+ * @template K - The key type.
+ * @template V - The value type.
+ * @param map - The `Map` or `WeakMap` to read from and populate.
+ * @param key - The key to look up.
+ * @param factory - Produces the value to insert when `key` is absent; called at most once.
+ * @returns The existing or newly-inserted value.
+ *
+ * @example
+ * const counts = new Map<string, number[]>();
+ * getOrInsert(counts, "a", () => []).push(1); // counts is Map { "a" => [1] }
+ */
+declare function getOrInsert<K, V>(map: GetSet<K, V>, key: K, factory: (key: K) => V): V;
+export { getOrInsert, type GetSet };
+//# sourceMappingURL=get-or-insert.d.ts.map

package/dist/map/get-or-insert.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-or-insert.d.ts","sourceRoot":"","sources":["../../src/map/get-or-insert.ts"],"names":[],"mappings":"AAAA,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,IAAI;IAChB,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC;IAC3B,GAAG,CAAC,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC;IAC/B,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,OAAO,CAAC;CACxB,CAAC;AAEF;;;;;;;;;;;;;;GAcG;AACH,iBAAS,WAAW,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAS/E;AAED,OAAO,EAAE,WAAW,EAAE,KAAK,MAAM,EAAE,CAAC"}

package/dist/map/get-or-insert.js

@@ -0,0 +1,25 @@
+/**
+ * Returns the value stored under `key`, or inserts and returns the value produced by `factory` when
+ * the key is absent. Works with both `Map` and `WeakMap`, and caches a computed `undefined` value.
+ *
+ * @template K - The key type.
+ * @template V - The value type.
+ * @param map - The `Map` or `WeakMap` to read from and populate.
+ * @param key - The key to look up.
+ * @param factory - Produces the value to insert when `key` is absent; called at most once.
+ * @returns The existing or newly-inserted value.
+ *
+ * @example
+ * const counts = new Map<string, number[]>();
+ * getOrInsert(counts, "a", () => []).push(1); // counts is Map { "a" => [1] }
+ */
+function getOrInsert(map, key, factory) {
+    if (map.has(key)) {
+        return map.get(key);
+    }
+    const value = factory(key);
+    map.set(key, value);
+    return value;
+}
+export { getOrInsert };
+//# sourceMappingURL=get-or-insert.js.map