@gtkx/utils 1.0.0-rc.1 → 1.0.0-rc.3

package/dist/array/index-before-or-end.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Finds the index of the first item matching `before`, or `list.length` when `before` is `null` or
+ * nothing matches. Use it to resolve where a new item should be inserted so it lands before the
+ * referenced one, defaulting to the end.
+ *
+ * @template T - The list item type.
+ * @template B - The reference value type.
+ * @param list - The list to search.
+ * @param before - The item to insert before, or `null` to target the end.
+ * @param isMatch - Called with each item and the non-null `before`; return `true` on a match.
+ * @returns The matched index, or `list.length`.
+ */
+declare const indexBeforeOrEnd: <T, B>(list: T[], before: B | null, isMatch: (item: T, before: B) => boolean) => number;
+export { indexBeforeOrEnd };
+//# sourceMappingURL=index-before-or-end.d.ts.map

package/dist/array/index-before-or-end.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-before-or-end.d.ts","sourceRoot":"","sources":["../../src/array/index-before-or-end.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,QAAA,MAAM,gBAAgB,GAAI,CAAC,EAAE,CAAC,EAC1B,MAAM,CAAC,EAAE,EACT,QAAQ,CAAC,GAAG,IAAI,EAChB,SAAS,CAAC,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,KAAK,OAAO,KACzC,MAQF,CAAC;AAEF,OAAO,EAAE,gBAAgB,EAAE,CAAC"}

package/dist/array/index-before-or-end.js

@@ -0,0 +1,21 @@
+/**
+ * Finds the index of the first item matching `before`, or `list.length` when `before` is `null` or
+ * nothing matches. Use it to resolve where a new item should be inserted so it lands before the
+ * referenced one, defaulting to the end.
+ *
+ * @template T - The list item type.
+ * @template B - The reference value type.
+ * @param list - The list to search.
+ * @param before - The item to insert before, or `null` to target the end.
+ * @param isMatch - Called with each item and the non-null `before`; return `true` on a match.
+ * @returns The matched index, or `list.length`.
+ */
+const indexBeforeOrEnd = (list, before, isMatch) => {
+    if (before === null) {
+        return list.length;
+    }
+    const index = list.findIndex((item) => isMatch(item, before));
+    return index === -1 ? list.length : index;
+};
+export { indexBeforeOrEnd };
+//# sourceMappingURL=index-before-or-end.js.map

package/dist/array/index-before-or-end.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-before-or-end.js","sourceRoot":"","sources":["../../src/array/index-before-or-end.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,MAAM,gBAAgB,GAAG,CACrB,IAAS,EACT,MAAgB,EAChB,OAAwC,EAClC,EAAE;IACR,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;QAClB,OAAO,IAAI,CAAC,MAAM,CAAC;IACvB,CAAC;IAED,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;IAE9D,OAAO,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC;AAC9C,CAAC,CAAC;AAEF,OAAO,EAAE,gBAAgB,EAAE,CAAC","sourcesContent":["/**\n * Finds the index of the first item matching `before`, or `list.length` when `before` is `null` or\n * nothing matches. Use it to resolve where a new item should be inserted so it lands before the\n * referenced one, defaulting to the end.\n *\n * @template T - The list item type.\n * @template B - The reference value type.\n * @param list - The list to search.\n * @param before - The item to insert before, or `null` to target the end.\n * @param isMatch - Called with each item and the non-null `before`; return `true` on a match.\n * @returns The matched index, or `list.length`.\n */\nconst indexBeforeOrEnd = <T, B>(\n    list: T[],\n    before: B | null,\n    isMatch: (item: T, before: B) => boolean,\n): number => {\n    if (before === null) {\n        return list.length;\n    }\n\n    const index = list.findIndex((item) => isMatch(item, before));\n\n    return index === -1 ? list.length : index;\n};\n\nexport { indexBeforeOrEnd };\n"]}

package/dist/array/index.d.ts

@@ -0,0 +1,6 @@
+export { indexBeforeOrEnd } from "./index-before-or-end.js";
+export { remove } from "./remove.js";
+export { sortStringsBy } from "./sort-strings-by.js";
+export { sortStrings } from "./sort-strings.js";
+export { uniqBy } from "./uniq-by.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/array/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC"}

package/dist/array/index.js

@@ -0,0 +1,6 @@
+export { indexBeforeOrEnd } from "./index-before-or-end.js";
+export { remove } from "./remove.js";
+export { sortStringsBy } from "./sort-strings-by.js";
+export { sortStrings } from "./sort-strings.js";
+export { uniqBy } from "./uniq-by.js";
+//# sourceMappingURL=index.js.map

package/dist/array/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/array/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC","sourcesContent":["export { indexBeforeOrEnd } from \"./index-before-or-end.js\";\nexport { remove } from \"./remove.js\";\nexport { sortStringsBy } from \"./sort-strings-by.js\";\nexport { sortStrings } from \"./sort-strings.js\";\nexport { uniqBy } from \"./uniq-by.js\";\n"]}

package/dist/array/remove.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Removes the first strictly-equal (`===`) occurrence of `value` from `arr` in place.
+ *
+ * @template T - The type of the array elements.
+ * @param arr - The array to mutate.
+ * @param value - The value to remove.
+ *
+ * @example
+ * const items = ["a", "b", "c"];
+ * remove(items, "b"); // items is now ["a", "c"]
+ */
+declare function remove<T>(arr: T[], value: T): void;
+export { remove };
+//# sourceMappingURL=remove.d.ts.map

package/dist/array/remove.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remove.d.ts","sourceRoot":"","sources":["../../src/array/remove.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,iBAAS,MAAM,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI,CAM3C;AAED,OAAO,EAAE,MAAM,EAAE,CAAC"}

package/dist/array/remove.js

@@ -0,0 +1,19 @@
+/**
+ * Removes the first strictly-equal (`===`) occurrence of `value` from `arr` in place.
+ *
+ * @template T - The type of the array elements.
+ * @param arr - The array to mutate.
+ * @param value - The value to remove.
+ *
+ * @example
+ * const items = ["a", "b", "c"];
+ * remove(items, "b"); // items is now ["a", "c"]
+ */
+function remove(arr, value) {
+    const index = arr.indexOf(value);
+    if (index !== -1) {
+        arr.splice(index, 1);
+    }
+}
+export { remove };
+//# sourceMappingURL=remove.js.map

package/dist/array/remove.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remove.js","sourceRoot":"","sources":["../../src/array/remove.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,SAAS,MAAM,CAAI,GAAQ,EAAE,KAAQ;IACjC,MAAM,KAAK,GAAG,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAEjC,IAAI,KAAK,KAAK,CAAC,CAAC,EAAE,CAAC;QACf,GAAG,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IACzB,CAAC;AACL,CAAC;AAED,OAAO,EAAE,MAAM,EAAE,CAAC","sourcesContent":["/**\n * Removes the first strictly-equal (`===`) occurrence of `value` from `arr` in place.\n *\n * @template T - The type of the array elements.\n * @param arr - The array to mutate.\n * @param value - The value to remove.\n *\n * @example\n * const items = [\"a\", \"b\", \"c\"];\n * remove(items, \"b\"); // items is now [\"a\", \"c\"]\n */\nfunction remove<T>(arr: T[], value: T): void {\n    const index = arr.indexOf(value);\n\n    if (index !== -1) {\n        arr.splice(index, 1);\n    }\n}\n\nexport { remove };\n"]}

package/dist/array/sort-strings-by.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Returns the items sorted by a string key using locale-aware comparison.
+ *
+ * @template T - The type of items being sorted.
+ * @param items - The items to sort.
+ * @param key - Maps an item to the string its order is decided by.
+ * @returns A new array of the items in ascending locale order of their keys.
+ *
+ * @example
+ * sortStringsBy([{ name: "b" }, { name: "a" }], (item) => item.name);
+ * // [{ name: "a" }, { name: "b" }]
+ */
+declare function sortStringsBy<T>(items: Iterable<T>, key: (item: T) => string): T[];
+export { sortStringsBy };
+//# sourceMappingURL=sort-strings-by.d.ts.map

package/dist/array/sort-strings-by.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sort-strings-by.d.ts","sourceRoot":"","sources":["../../src/array/sort-strings-by.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,iBAAS,aAAa,CAAC,CAAC,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,GAAG,CAAC,EAAE,CAE3E;AAED,OAAO,EAAE,aAAa,EAAE,CAAC"}

package/dist/array/sort-strings-by.js

@@ -0,0 +1,17 @@
+/**
+ * Returns the items sorted by a string key using locale-aware comparison.
+ *
+ * @template T - The type of items being sorted.
+ * @param items - The items to sort.
+ * @param key - Maps an item to the string its order is decided by.
+ * @returns A new array of the items in ascending locale order of their keys.
+ *
+ * @example
+ * sortStringsBy([{ name: "b" }, { name: "a" }], (item) => item.name);
+ * // [{ name: "a" }, { name: "b" }]
+ */
+function sortStringsBy(items, key) {
+    return [...items].toSorted((a, b) => key(a).localeCompare(key(b)));
+}
+export { sortStringsBy };
+//# sourceMappingURL=sort-strings-by.js.map

package/dist/array/sort-strings-by.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sort-strings-by.js","sourceRoot":"","sources":["../../src/array/sort-strings-by.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,SAAS,aAAa,CAAI,KAAkB,EAAE,GAAwB;IAClE,OAAO,CAAC,GAAG,KAAK,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACvE,CAAC;AAED,OAAO,EAAE,aAAa,EAAE,CAAC","sourcesContent":["/**\n * Returns the items sorted by a string key using locale-aware comparison.\n *\n * @template T - The type of items being sorted.\n * @param items - The items to sort.\n * @param key - Maps an item to the string its order is decided by.\n * @returns A new array of the items in ascending locale order of their keys.\n *\n * @example\n * sortStringsBy([{ name: \"b\" }, { name: \"a\" }], (item) => item.name);\n * // [{ name: \"a\" }, { name: \"b\" }]\n */\nfunction sortStringsBy<T>(items: Iterable<T>, key: (item: T) => string): T[] {\n    return [...items].toSorted((a, b) => key(a).localeCompare(key(b)));\n}\n\nexport { sortStringsBy };\n"]}

package/dist/array/sort-strings.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Returns the values sorted as strings using locale-aware comparison.
+ *
+ * @param values - The strings to sort.
+ * @returns A new array of the values in ascending locale order.
+ *
+ * @example
+ * sortStrings(["b", "a", "c"]); // ["a", "b", "c"]
+ */
+declare function sortStrings(values: Iterable<string>): string[];
+export { sortStrings };
+//# sourceMappingURL=sort-strings.d.ts.map

package/dist/array/sort-strings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sort-strings.d.ts","sourceRoot":"","sources":["../../src/array/sort-strings.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,iBAAS,WAAW,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,MAAM,EAAE,CAEvD;AAED,OAAO,EAAE,WAAW,EAAE,CAAC"}

package/dist/array/sort-strings.js

@@ -0,0 +1,14 @@
+/**
+ * Returns the values sorted as strings using locale-aware comparison.
+ *
+ * @param values - The strings to sort.
+ * @returns A new array of the values in ascending locale order.
+ *
+ * @example
+ * sortStrings(["b", "a", "c"]); // ["a", "b", "c"]
+ */
+function sortStrings(values) {
+    return [...values].toSorted((a, b) => a.localeCompare(b));
+}
+export { sortStrings };
+//# sourceMappingURL=sort-strings.js.map

package/dist/array/sort-strings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sort-strings.js","sourceRoot":"","sources":["../../src/array/sort-strings.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,SAAS,WAAW,CAAC,MAAwB;IACzC,OAAO,CAAC,GAAG,MAAM,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;AAC9D,CAAC;AAED,OAAO,EAAE,WAAW,EAAE,CAAC","sourcesContent":["/**\n * Returns the values sorted as strings using locale-aware comparison.\n *\n * @param values - The strings to sort.\n * @returns A new array of the values in ascending locale order.\n *\n * @example\n * sortStrings([\"b\", \"a\", \"c\"]); // [\"a\", \"b\", \"c\"]\n */\nfunction sortStrings(values: Iterable<string>): string[] {\n    return [...values].toSorted((a, b) => a.localeCompare(b));\n}\n\nexport { sortStrings };\n"]}

package/dist/array/uniq-by.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Returns a new array of the unique elements of `arr`, keyed by the value the `mapper` returns.
+ *
+ * When two elements map to the same key the first occurrence is kept and later ones discarded,
+ * preserving first-seen order.
+ *
+ * @template T - The type of elements in the array.
+ * @param arr - The array to deduplicate.
+ * @param mapper - Maps an element to the key its uniqueness is decided by.
+ * @returns A new array containing only the first element seen for each distinct key.
+ *
+ * @example
+ * uniqBy([2.1, 1.2, 2.3], Math.floor); // [2.1, 1.2]
+ * uniqBy([{ id: "a" }, { id: "a" }, { id: "b" }], (item) => item.id); // [{ id: "a" }, { id: "b" }]
+ */
+declare function uniqBy<T>(arr: T[], mapper: (item: T, index: number, array: T[]) => unknown): T[];
+export { uniqBy };
+//# sourceMappingURL=uniq-by.d.ts.map

package/dist/array/uniq-by.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uniq-by.d.ts","sourceRoot":"","sources":["../../src/array/uniq-by.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,iBAAS,MAAM,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,OAAO,GAAG,CAAC,EAAE,CAezF;AAED,OAAO,EAAE,MAAM,EAAE,CAAC"}

package/dist/array/uniq-by.js

@@ -0,0 +1,29 @@
+/**
+ * Returns a new array of the unique elements of `arr`, keyed by the value the `mapper` returns.
+ *
+ * When two elements map to the same key the first occurrence is kept and later ones discarded,
+ * preserving first-seen order.
+ *
+ * @template T - The type of elements in the array.
+ * @param arr - The array to deduplicate.
+ * @param mapper - Maps an element to the key its uniqueness is decided by.
+ * @returns A new array containing only the first element seen for each distinct key.
+ *
+ * @example
+ * uniqBy([2.1, 1.2, 2.3], Math.floor); // [2.1, 1.2]
+ * uniqBy([{ id: "a" }, { id: "a" }, { id: "b" }], (item) => item.id); // [{ id: "a" }, { id: "b" }]
+ */
+function uniqBy(arr, mapper) {
+    const seen = new Map();
+    let index = 0;
+    for (const item of arr) {
+        const key = mapper(item, index, arr);
+        if (!seen.has(key)) {
+            seen.set(key, item);
+        }
+        index++;
+    }
+    return seen.values().toArray();
+}
+export { uniqBy };
+//# sourceMappingURL=uniq-by.js.map

package/dist/array/uniq-by.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"uniq-by.js","sourceRoot":"","sources":["../../src/array/uniq-by.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,SAAS,MAAM,CAAI,GAAQ,EAAE,MAAuD;IAChF,MAAM,IAAI,GAAoB,IAAI,GAAG,EAAE,CAAC;IACxC,IAAI,KAAK,GAAG,CAAC,CAAC;IAEd,KAAK,MAAM,IAAI,IAAI,GAAG,EAAE,CAAC;QACrB,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC;QAErC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YACjB,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QACxB,CAAC;QAED,KAAK,EAAE,CAAC;IACZ,CAAC;IAED,OAAO,IAAI,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE,CAAC;AACnC,CAAC;AAED,OAAO,EAAE,MAAM,EAAE,CAAC","sourcesContent":["/**\n * Returns a new array of the unique elements of `arr`, keyed by the value the `mapper` returns.\n *\n * When two elements map to the same key the first occurrence is kept and later ones discarded,\n * preserving first-seen order.\n *\n * @template T - The type of elements in the array.\n * @param arr - The array to deduplicate.\n * @param mapper - Maps an element to the key its uniqueness is decided by.\n * @returns A new array containing only the first element seen for each distinct key.\n *\n * @example\n * uniqBy([2.1, 1.2, 2.3], Math.floor); // [2.1, 1.2]\n * uniqBy([{ id: \"a\" }, { id: \"a\" }, { id: \"b\" }], (item) => item.id); // [{ id: \"a\" }, { id: \"b\" }]\n */\nfunction uniqBy<T>(arr: T[], mapper: (item: T, index: number, array: T[]) => unknown): T[] {\n    const seen: Map<unknown, T> = new Map();\n    let index = 0;\n\n    for (const item of arr) {\n        const key = mapper(item, index, arr);\n\n        if (!seen.has(key)) {\n            seen.set(key, item);\n        }\n\n        index++;\n    }\n\n    return seen.values().toArray();\n}\n\nexport { uniqBy };\n"]}

package/dist/class/any-class.d.ts

@@ -0,0 +1,8 @@
+/**
+ * A constructor value of any (possibly abstract) class producing instances of `T`.
+ */
+type AnyClass<T extends object = object> = (abstract new (...args: never[]) => T) & {
+    prototype: T;
+};
+export { type AnyClass };
+//# sourceMappingURL=any-class.d.ts.map

package/dist/class/any-class.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"any-class.d.ts","sourceRoot":"","sources":["../../src/class/any-class.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,KAAK,QAAQ,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,IAAI,CAAC,QAAQ,MAChD,GAAG,IAAI,EAAE,KAAK,EAAE,KACf,CAAC,CAAC,GAAG;IACN,SAAS,EAAE,CAAC,CAAC;CAChB,CAAC;AAEF,OAAO,EAAE,KAAK,QAAQ,EAAE,CAAC"}

package/dist/class/any-class.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=any-class.js.map

package/dist/class/any-class.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"any-class.js","sourceRoot":"","sources":["../../src/class/any-class.ts"],"names":[],"mappings":"AASA,OAAO,EAAiB,CAAC","sourcesContent":["/**\n * A constructor value of any (possibly abstract) class producing instances of `T`.\n */\ntype AnyClass<T extends object = object> = (abstract new (\n    ...args: never[]\n) => T) & {\n    prototype: T;\n};\n\nexport { type AnyClass };\n"]}

package/dist/class/get-parent-class.d.ts

@@ -0,0 +1,10 @@
+import type { AnyClass } from "./any-class.js";
+/**
+ * Returns the direct superclass of `cls`, or `null` when it has no class ancestor.
+ *
+ * @param cls - The class whose prototype parent to inspect.
+ * @returns The parent class, or `null` when there is none.
+ */
+declare function getParentClass(cls: AnyClass): AnyClass | null;
+export { getParentClass };
+//# sourceMappingURL=get-parent-class.d.ts.map

package/dist/class/get-parent-class.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-parent-class.d.ts","sourceRoot":"","sources":["../../src/class/get-parent-class.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE/C;;;;;GAKG;AACH,iBAAS,cAAc,CAAC,GAAG,EAAE,QAAQ,GAAG,QAAQ,GAAG,IAAI,CAItD;AAED,OAAO,EAAE,cAAc,EAAE,CAAC"}

package/dist/class/get-parent-class.js

@@ -0,0 +1,12 @@
+/**
+ * Returns the direct superclass of `cls`, or `null` when it has no class ancestor.
+ *
+ * @param cls - The class whose prototype parent to inspect.
+ * @returns The parent class, or `null` when there is none.
+ */
+function getParentClass(cls) {
+    const parent = Object.getPrototypeOf(cls);
+    return typeof parent === "function" && parent !== Function.prototype ? parent : null;
+}
+export { getParentClass };
+//# sourceMappingURL=get-parent-class.js.map

package/dist/class/get-parent-class.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-parent-class.js","sourceRoot":"","sources":["../../src/class/get-parent-class.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,SAAS,cAAc,CAAC,GAAa;IACjC,MAAM,MAAM,GAAY,MAAM,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC;IAEnD,OAAO,OAAO,MAAM,KAAK,UAAU,IAAI,MAAM,KAAK,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAE,MAAmB,CAAC,CAAC,CAAC,IAAI,CAAC;AACvG,CAAC;AAED,OAAO,EAAE,cAAc,EAAE,CAAC","sourcesContent":["import type { AnyClass } from \"./any-class.js\";\n\n/**\n * Returns the direct superclass of `cls`, or `null` when it has no class ancestor.\n *\n * @param cls - The class whose prototype parent to inspect.\n * @returns The parent class, or `null` when there is none.\n */\nfunction getParentClass(cls: AnyClass): AnyClass | null {\n    const parent: unknown = Object.getPrototypeOf(cls);\n\n    return typeof parent === \"function\" && parent !== Function.prototype ? (parent as AnyClass) : null;\n}\n\nexport { getParentClass };\n"]}

package/dist/class/index.d.ts

@@ -0,0 +1,4 @@
+export type { AnyClass } from "./any-class.js";
+export { getParentClass } from "./get-parent-class.js";
+export { walkClassChain } from "./walk-class-chain.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/class/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/class/index.js

@@ -0,0 +1,3 @@
+export { getParentClass } from "./get-parent-class.js";
+export { walkClassChain } from "./walk-class-chain.js";
+//# sourceMappingURL=index.js.map

package/dist/class/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/class/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC","sourcesContent":["export type { AnyClass } from \"./any-class.js\";\nexport { getParentClass } from \"./get-parent-class.js\";\nexport { walkClassChain } from \"./walk-class-chain.js\";\n"]}

package/dist/class/walk-class-chain.d.ts

@@ -0,0 +1,13 @@
+import type { AnyClass } from "./any-class.js";
+/**
+ * Walks the class chain from `cls` up through its ancestors, calling `visit` on each and returning
+ * the first result that is not `undefined`.
+ *
+ * @template T - The type produced by the visitor.
+ * @param cls - The class to start from, or `null` to visit nothing.
+ * @param visit - Called with each class in the chain; a defined return value stops the walk.
+ * @returns The first defined result from `visit`, or `undefined` when none was produced.
+ */
+declare function walkClassChain<T>(cls: AnyClass | null, visit: (ancestor: AnyClass) => T | undefined): T | undefined;
+export { walkClassChain };
+//# sourceMappingURL=walk-class-chain.d.ts.map

package/dist/class/walk-class-chain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"walk-class-chain.d.ts","sourceRoot":"","sources":["../../src/class/walk-class-chain.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAG/C;;;;;;;;GAQG;AACH,iBAAS,cAAc,CAAC,CAAC,EAAE,GAAG,EAAE,QAAQ,GAAG,IAAI,EAAE,KAAK,EAAE,CAAC,QAAQ,EAAE,QAAQ,KAAK,CAAC,GAAG,SAAS,GAAG,CAAC,GAAG,SAAS,CAc5G;AAED,OAAO,EAAE,cAAc,EAAE,CAAC"}

package/dist/class/walk-class-chain.js

@@ -0,0 +1,23 @@
+import { getParentClass } from "./get-parent-class.js";
+/**
+ * Walks the class chain from `cls` up through its ancestors, calling `visit` on each and returning
+ * the first result that is not `undefined`.
+ *
+ * @template T - The type produced by the visitor.
+ * @param cls - The class to start from, or `null` to visit nothing.
+ * @param visit - Called with each class in the chain; a defined return value stops the walk.
+ * @returns The first defined result from `visit`, or `undefined` when none was produced.
+ */
+function walkClassChain(cls, visit) {
+    let current = cls;
+    while (current !== null) {
+        const result = visit(current);
+        if (result !== undefined) {
+            return result;
+        }
+        current = getParentClass(current);
+    }
+    return undefined;
+}
+export { walkClassChain };
+//# sourceMappingURL=walk-class-chain.js.map

package/dist/class/walk-class-chain.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"walk-class-chain.js","sourceRoot":"","sources":["../../src/class/walk-class-chain.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD;;;;;;;;GAQG;AACH,SAAS,cAAc,CAAI,GAAoB,EAAE,KAA4C;IACzF,IAAI,OAAO,GAAG,GAAG,CAAC;IAElB,OAAO,OAAO,KAAK,IAAI,EAAE,CAAC;QACtB,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC;QAE9B,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACvB,OAAO,MAAM,CAAC;QAClB,CAAC;QAED,OAAO,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;IACtC,CAAC;IAED,OAAO,SAAS,CAAC;AACrB,CAAC;AAED,OAAO,EAAE,cAAc,EAAE,CAAC","sourcesContent":["import type { AnyClass } from \"./any-class.js\";\nimport { getParentClass } from \"./get-parent-class.js\";\n\n/**\n * Walks the class chain from `cls` up through its ancestors, calling `visit` on each and returning\n * the first result that is not `undefined`.\n *\n * @template T - The type produced by the visitor.\n * @param cls - The class to start from, or `null` to visit nothing.\n * @param visit - Called with each class in the chain; a defined return value stops the walk.\n * @returns The first defined result from `visit`, or `undefined` when none was produced.\n */\nfunction walkClassChain<T>(cls: AnyClass | null, visit: (ancestor: AnyClass) => T | undefined): T | undefined {\n    let current = cls;\n\n    while (current !== null) {\n        const result = visit(current);\n\n        if (result !== undefined) {\n            return result;\n        }\n\n        current = getParentClass(current);\n    }\n\n    return undefined;\n}\n\nexport { walkClassChain };\n"]}

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

@@ -0,0 +1,6 @@
+declare function isErrorLike(value: unknown): value is {
+    message: string;
+};
+declare function readStream(value: unknown): string;
+export { isErrorLike, readStream };
+//# sourceMappingURL=error-like.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"error-like.d.ts","sourceRoot":"","sources":["../../src/error/error-like.ts"],"names":[],"mappings":"AAEA,iBAAS,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,CAEjE;AAED,iBAAS,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAU1C;AAED,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,CAAC"}

package/dist/error/error-like.js

@@ -0,0 +1,15 @@
+import { isRecord } from "../predicate/is-record.js";
+function isErrorLike(value) {
+    return isRecord(value) && "message" in value && typeof value.message === "string";
+}
+function readStream(value) {
+    if (typeof value === "string") {
+        return value;
+    }
+    if (value instanceof Uint8Array || Buffer.isBuffer(value)) {
+        return value.toString();
+    }
+    return "";
+}
+export { isErrorLike, readStream };
+//# sourceMappingURL=error-like.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"error-like.js","sourceRoot":"","sources":["../../src/error/error-like.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAErD,SAAS,WAAW,CAAC,KAAc;IAC/B,OAAO,QAAQ,CAAC,KAAK,CAAC,IAAI,SAAS,IAAI,KAAK,IAAI,OAAO,KAAK,CAAC,OAAO,KAAK,QAAQ,CAAC;AACtF,CAAC;AAED,SAAS,UAAU,CAAC,KAAc;IAC9B,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC5B,OAAO,KAAK,CAAC;IACjB,CAAC;IAED,IAAI,KAAK,YAAY,UAAU,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACxD,OAAO,KAAK,CAAC,QAAQ,EAAE,CAAC;IAC5B,CAAC;IAED,OAAO,EAAE,CAAC;AACd,CAAC;AAED,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,CAAC","sourcesContent":["import { isRecord } from \"../predicate/is-record.js\";\n\nfunction isErrorLike(value: unknown): value is { message: string } {\n    return isRecord(value) && \"message\" in value && typeof value.message === \"string\";\n}\n\nfunction readStream(value: unknown): string {\n    if (typeof value === \"string\") {\n        return value;\n    }\n\n    if (value instanceof Uint8Array || Buffer.isBuffer(value)) {\n        return value.toString();\n    }\n\n    return \"\";\n}\n\nexport { isErrorLike, readStream };\n"]}

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

@@ -0,0 +1,13 @@
+/**
+ * Extracts a human-readable message from an unknown thrown value, falling back to its string form.
+ *
+ * @param error - The caught value to describe.
+ * @returns The value's message when it has one, otherwise its string form.
+ *
+ * @example
+ * errorMessage(new Error("boom")); // "boom"
+ * errorMessage(42); // "42"
+ */
+declare function errorMessage(error: unknown): string;
+export { errorMessage };
+//# sourceMappingURL=error-message.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"error-message.d.ts","sourceRoot":"","sources":["../../src/error/error-message.ts"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AACH,iBAAS,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAE5C;AAED,OAAO,EAAE,YAAY,EAAE,CAAC"}

package/dist/error/error-message.js

@@ -0,0 +1,16 @@
+import { isErrorLike } from "./error-like.js";
+/**
+ * Extracts a human-readable message from an unknown thrown value, falling back to its string form.
+ *
+ * @param error - The caught value to describe.
+ * @returns The value's message when it has one, otherwise its string form.
+ *
+ * @example
+ * errorMessage(new Error("boom")); // "boom"
+ * errorMessage(42); // "42"
+ */
+function errorMessage(error) {
+    return Error.isError(error) || isErrorLike(error) ? error.message : String(error);
+}
+export { errorMessage };
+//# sourceMappingURL=error-message.js.map

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"]}