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

package/src/string/index.ts

@@ -0,0 +1,5 @@
+export { camelCase } from "./camel-case.js";
+export { kebabCase } from "./kebab-case.js";
+export { lowerFirst } from "./lower-first.js";
+export { pascalCase } from "./pascal-case.js";
+export { upperFirst } from "./upper-first.js";

package/src/string/kebab-case.ts

@@ -0,0 +1,18 @@
+/**
+ * Converts a camelCase or PascalCase string to kebab case by lower-casing uppercase letters and
+ * inserting hyphens before interior ones.
+ *
+ * @param str - The string to convert.
+ * @returns The kebab-cased string.
+ *
+ * @example
+ * kebabCase("iconName"); // "icon-name"
+ * kebabCase("Title"); // "title"
+ */
+function kebabCase(str: string): string {
+    return str.replaceAll(/[A-Z]/g, (char, index: number) =>
+        index === 0 ? char.toLowerCase() : `-${char.toLowerCase()}`,
+    );
+}
+
+export { kebabCase };

package/src/string/lower-first.ts

@@ -0,0 +1,15 @@
+/**
+ * Converts the first character of a string to lower case.
+ *
+ * @param str - The string to transform.
+ * @returns The string with its first character lower-cased.
+ *
+ * @example
+ * lowerFirst("Fred"); // "fred"
+ * lowerFirst("FRED"); // "fRED"
+ */
+function lowerFirst(str: string): string {
+    return str.charAt(0).toLowerCase() + str.slice(1);
+}
+
+export { lowerFirst };

package/src/string/pascal-case.ts

@@ -0,0 +1,21 @@
+import { upperFirst } from "./upper-first.js";
+import { mapWordSegments } from "./word-segments.js";
+
+/**
+ * Converts an underscore- or hyphen-delimited string to Pascal case.
+ *
+ * Splits only on `_` and `-` and capitalizes each segment's first character, so GObject acronyms
+ * are preserved (`pascalCase("GLArea")` stays `"GLArea"`).
+ *
+ * @param str - The string to convert.
+ * @returns The Pascal-cased string.
+ *
+ * @example
+ * pascalCase("icon_name"); // "IconName"
+ * pascalCase("scrolled-window"); // "ScrolledWindow"
+ */
+function pascalCase(str: string): string {
+    return mapWordSegments(str, upperFirst);
+}
+
+export { pascalCase };

package/src/string/upper-first.ts

@@ -0,0 +1,15 @@
+/**
+ * Converts the first character of a string to upper case.
+ *
+ * @param str - The string to transform.
+ * @returns The string with its first character upper-cased.
+ *
+ * @example
+ * upperFirst("fred"); // "Fred"
+ * upperFirst("Fred"); // "Fred"
+ */
+function upperFirst(str: string): string {
+    return str.charAt(0).toUpperCase() + str.slice(1);
+}
+
+export { upperFirst };

package/src/string/word-segments.ts

@@ -0,0 +1,15 @@
+function splitWords(input: string): string[] {
+    return input.split(/[_-]/g).filter((part) => part.length > 0);
+}
+
+function mapWordSegments(input: string, mapSegment: (part: string, index: number) => string): string {
+    const parts = splitWords(input);
+
+    if (parts.length === 0) {
+        return input;
+    }
+
+    return parts.map((part, index) => mapSegment(part, index)).join("");
+}
+
+export { mapWordSegments };

package/src/util/index.ts

@@ -0,0 +1 @@
+export { packageVersion } from "./package-version.js";

package/src/util/package-version.ts

@@ -0,0 +1,16 @@
+import { createRequire } from "node:module";
+
+/**
+ * Reads the `version` field from the `package.json` next to the calling module.
+ *
+ * @param importMetaUrl - The caller's `import.meta.url`, used to resolve the sibling `package.json`.
+ * @returns The package's version string.
+ *
+ * @example
+ * packageVersion(import.meta.url); // "1.2.3"
+ */
+function packageVersion(importMetaUrl: string): string {
+    return (createRequire(importMetaUrl)("../package.json") as { version: string }).version;
+}
+
+export { packageVersion };

package/dist/class.d.ts

@@ -1,22 +0,0 @@
-/**
- * A constructor value of any (possibly abstract) class producing instances of `T`.
- */
-export type AnyClass<T extends object = object> = (abstract new (...args: never[]) => T) & {
-    prototype: T;
-};
-/**
- * Returns the direct superclass of `cls`, or `null` when it has no class ancestor.
- *
- * @param cls The class whose prototype parent to inspect.
- */
-export declare function getParentClass(cls: AnyClass): AnyClass | null;
-/**
- * Walks the class chain from `cls` up through its ancestors, calling `visit` on each and
- * returning the first result that is not `undefined`.
- *
- * @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` if none was produced.
- */
-export declare function walkClassChain<T>(cls: AnyClass | null, visit: (ancestor: AnyClass) => T | undefined): T | undefined;
-//# sourceMappingURL=class.d.ts.map

package/dist/class.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"class.d.ts","sourceRoot":"","sources":["../src/class.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,QAAQ,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,IAAI,CAAC,QAAQ,MACvD,GAAG,IAAI,EAAE,KAAK,EAAE,KACf,CAAC,CAAC,GAAG;IACN,SAAS,EAAE,CAAC,CAAC;CAChB,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,QAAQ,GAAG,QAAQ,GAAG,IAAI,CAG7D;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,GAAG,EAAE,QAAQ,GAAG,IAAI,EAAE,KAAK,EAAE,CAAC,QAAQ,EAAE,QAAQ,KAAK,CAAC,GAAG,SAAS,GAAG,CAAC,GAAG,SAAS,CAQnH"}

package/dist/class.js

@@ -1,28 +0,0 @@
-/**
- * Returns the direct superclass of `cls`, or `null` when it has no class ancestor.
- *
- * @param cls The class whose prototype parent to inspect.
- */
-export function getParentClass(cls) {
-    const parent = Object.getPrototypeOf(cls);
-    return typeof parent === "function" && parent !== Function.prototype ? parent : null;
-}
-/**
- * Walks the class chain from `cls` up through its ancestors, calling `visit` on each and
- * returning the first result that is not `undefined`.
- *
- * @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` if none was produced.
- */
-export function walkClassChain(cls, visit) {
-    let current = cls;
-    while (current !== null) {
-        const result = visit(current);
-        if (result !== undefined)
-            return result;
-        current = getParentClass(current);
-    }
-    return undefined;
-}
-//# sourceMappingURL=class.js.map

package/dist/class.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"class.js","sourceRoot":"","sources":["../src/class.ts"],"names":[],"mappings":"AASA;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,GAAa;IACxC,MAAM,MAAM,GAAY,MAAM,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC;IACnD,OAAO,OAAO,MAAM,KAAK,UAAU,IAAI,MAAM,KAAK,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAE,MAAmB,CAAC,CAAC,CAAC,IAAI,CAAC;AACvG,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,cAAc,CAAI,GAAoB,EAAE,KAA4C;IAChG,IAAI,OAAO,GAAG,GAAG,CAAC;IAClB,OAAO,OAAO,KAAK,IAAI,EAAE,CAAC;QACtB,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC;QAC9B,IAAI,MAAM,KAAK,SAAS;YAAE,OAAO,MAAM,CAAC;QACxC,OAAO,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;IACtC,CAAC;IACD,OAAO,SAAS,CAAC;AACrB,CAAC","sourcesContent":["/**\n * A constructor value of any (possibly abstract) class producing instances of `T`.\n */\nexport type AnyClass<T extends object = object> = (abstract new (\n    ...args: never[]\n) => T) & {\n    prototype: T;\n};\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 */\nexport function getParentClass(cls: AnyClass): AnyClass | null {\n    const parent: unknown = Object.getPrototypeOf(cls);\n    return typeof parent === \"function\" && parent !== Function.prototype ? (parent as AnyClass) : null;\n}\n\n/**\n * Walks the class chain from `cls` up through its ancestors, calling `visit` on each and\n * returning the first result that is not `undefined`.\n *\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` if none was produced.\n */\nexport function walkClassChain<T>(cls: AnyClass | null, visit: (ancestor: AnyClass) => T | undefined): T | undefined {\n    let current = cls;\n    while (current !== null) {\n        const result = visit(current);\n        if (result !== undefined) return result;\n        current = getParentClass(current);\n    }\n    return undefined;\n}\n"]}

package/dist/collection.d.ts

@@ -1,30 +0,0 @@
-/**
- * Returns the items with duplicates removed, keeping the first item for each distinct key.
- *
- * @param items The items to deduplicate.
- * @param key Computes the identity string used to detect duplicates.
- */
-export declare const uniqBy: <T>(items: T[], key: (item: T) => string) => T[];
-export declare const isSameArray: <T>(a: T[], b: T[]) => boolean;
-/**
- * Returns a new array of the given strings sorted with locale-aware comparison.
- *
- * @param values The strings to sort.
- */
-export declare const sortStrings: (values: Iterable<string>) => string[];
-/**
- * Returns a new array of the given items sorted by a locale-aware comparison of their keys.
- *
- * @param items The items to sort.
- * @param key Computes the string to sort each item by.
- */
-export declare const sortStringsBy: <T>(items: Iterable<T>, key: (item: T) => string) => T[];
-/**
- * Determines whether two records have the same keys and strictly equal values.
- *
- * @param a The first record, or `undefined`.
- * @param b The second record, or `undefined`.
- * @returns `true` when both are the same reference, or both are defined with identical own keys and values.
- */
-export declare const isShallowEqual: <T extends Record<string, unknown>>(a?: T, b?: T) => boolean;
-//# sourceMappingURL=collection.d.ts.map

package/dist/collection.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"collection.d.ts","sourceRoot":"","sources":["../src/collection.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,eAAO,MAAM,MAAM,GAAI,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,KAAG,CAAC,EAUjE,CAAC;AAEF,eAAO,MAAM,WAAW,GAAI,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC,EAAE,KAAG,OAM/C,CAAC;AAIF;;;;GAIG;AACH,eAAO,MAAM,WAAW,WAAY,QAAQ,CAAC,MAAM,CAAC,KAAG,MAAM,EAAsC,CAAC;AAEpG;;;;;GAKG;AACH,eAAO,MAAM,aAAa,GAAI,CAAC,SAAS,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,KAAG,CAAC,EACpB,CAAC;AAE9D;;;;;;GAMG;AACH,eAAO,MAAM,cAAc,GAAI,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,KAAG,OAahF,CAAC"}

package/dist/collection.js

@@ -1,64 +0,0 @@
-/**
- * Returns the items with duplicates removed, keeping the first item for each distinct key.
- *
- * @param items The items to deduplicate.
- * @param key Computes the identity string used to detect duplicates.
- */
-export const uniqBy = (items, key) => {
-    const seen = new Set();
-    const result = [];
-    for (const item of items) {
-        const identity = key(item);
-        if (seen.has(identity))
-            continue;
-        seen.add(identity);
-        result.push(item);
-    }
-    return result;
-};
-export const isSameArray = (a, b) => {
-    if (a.length !== b.length)
-        return false;
-    for (let index = 0; index < a.length; index++) {
-        if (a[index] !== b[index])
-            return false;
-    }
-    return true;
-};
-const compareStrings = (a, b) => a.localeCompare(b);
-/**
- * Returns a new array of the given strings sorted with locale-aware comparison.
- *
- * @param values The strings to sort.
- */
-export const sortStrings = (values) => [...values].sort(compareStrings);
-/**
- * Returns a new array of the given items sorted by a locale-aware comparison of their keys.
- *
- * @param items The items to sort.
- * @param key Computes the string to sort each item by.
- */
-export const sortStringsBy = (items, key) => [...items].sort((a, b) => compareStrings(key(a), key(b)));
-/**
- * Determines whether two records have the same keys and strictly equal values.
- *
- * @param a The first record, or `undefined`.
- * @param b The second record, or `undefined`.
- * @returns `true` when both are the same reference, or both are defined with identical own keys and values.
- */
-export const isShallowEqual = (a, b) => {
-    if (a === b)
-        return true;
-    if (!a || !b)
-        return false;
-    const keysA = Object.keys(a);
-    const keysB = Object.keys(b);
-    if (keysA.length !== keysB.length)
-        return false;
-    for (const key of keysA) {
-        if (a[key] !== b[key])
-            return false;
-    }
-    return true;
-};
-//# sourceMappingURL=collection.js.map

package/dist/collection.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"collection.js","sourceRoot":"","sources":["../src/collection.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG,CAAI,KAAU,EAAE,GAAwB,EAAO,EAAE;IACnE,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,MAAM,GAAQ,EAAE,CAAC;IACvB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACvB,MAAM,QAAQ,GAAG,GAAG,CAAC,IAAI,CAAC,CAAC;QAC3B,IAAI,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC;YAAE,SAAS;QACjC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACnB,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACtB,CAAC;IACD,OAAO,MAAM,CAAC;AAClB,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,WAAW,GAAG,CAAI,CAAM,EAAE,CAAM,EAAW,EAAE;IACtD,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,MAAM;QAAE,OAAO,KAAK,CAAC;IACxC,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC;QAC5C,IAAI,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC;YAAE,OAAO,KAAK,CAAC;IAC5C,CAAC;IACD,OAAO,IAAI,CAAC;AAChB,CAAC,CAAC;AAEF,MAAM,cAAc,GAAG,CAAC,CAAS,EAAE,CAAS,EAAU,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;AAE5E;;;;GAIG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,MAAwB,EAAY,EAAE,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;AAEpG;;;;;GAKG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAI,KAAkB,EAAE,GAAwB,EAAO,EAAE,CAClF,CAAC,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAE9D;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAoC,CAAK,EAAE,CAAK,EAAW,EAAE;IACvF,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACzB,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC;QAAE,OAAO,KAAK,CAAC;IAE3B,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC7B,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC7B,IAAI,KAAK,CAAC,MAAM,KAAK,KAAK,CAAC,MAAM;QAAE,OAAO,KAAK,CAAC;IAEhD,KAAK,MAAM,GAAG,IAAI,KAAK,EAAE,CAAC;QACtB,IAAI,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC;YAAE,OAAO,KAAK,CAAC;IACxC,CAAC;IAED,OAAO,IAAI,CAAC;AAChB,CAAC,CAAC","sourcesContent":["/**\n * Returns the items with duplicates removed, keeping the first item for each distinct key.\n *\n * @param items The items to deduplicate.\n * @param key Computes the identity string used to detect duplicates.\n */\nexport const uniqBy = <T>(items: T[], key: (item: T) => string): T[] => {\n    const seen = new Set<string>();\n    const result: T[] = [];\n    for (const item of items) {\n        const identity = key(item);\n        if (seen.has(identity)) continue;\n        seen.add(identity);\n        result.push(item);\n    }\n    return result;\n};\n\nexport const isSameArray = <T>(a: T[], b: T[]): boolean => {\n    if (a.length !== b.length) return false;\n    for (let index = 0; index < a.length; index++) {\n        if (a[index] !== b[index]) return false;\n    }\n    return true;\n};\n\nconst compareStrings = (a: string, b: string): number => a.localeCompare(b);\n\n/**\n * Returns a new array of the given strings sorted with locale-aware comparison.\n *\n * @param values The strings to sort.\n */\nexport const sortStrings = (values: Iterable<string>): string[] => [...values].sort(compareStrings);\n\n/**\n * Returns a new array of the given items sorted by a locale-aware comparison of their keys.\n *\n * @param items The items to sort.\n * @param key Computes the string to sort each item by.\n */\nexport const sortStringsBy = <T>(items: Iterable<T>, key: (item: T) => string): T[] =>\n    [...items].sort((a, b) => compareStrings(key(a), key(b)));\n\n/**\n * Determines whether two records have the same keys and strictly equal values.\n *\n * @param a The first record, or `undefined`.\n * @param b The second record, or `undefined`.\n * @returns `true` when both are the same reference, or both are defined with identical own keys and values.\n */\nexport const isShallowEqual = <T extends Record<string, unknown>>(a?: T, b?: T): boolean => {\n    if (a === b) return true;\n    if (!a || !b) return false;\n\n    const keysA = Object.keys(a);\n    const keysB = Object.keys(b);\n    if (keysA.length !== keysB.length) return false;\n\n    for (const key of keysA) {\n        if (a[key] !== b[key]) return false;\n    }\n\n    return true;\n};\n"]}

package/dist/error.d.ts

@@ -1,21 +0,0 @@
-/**
- * Extracts a human-readable message from an unknown thrown value, falling back to its string form.
- *
- * @param error The caught value to describe.
- */
-export declare const errorMessage: (error: unknown) => string;
-/**
- * Coerces an unknown thrown value into an `Error`, reusing it if it already is one and otherwise
- * wrapping its message while copying any error-like own properties.
- *
- * @param error The caught value to normalize.
- */
-export declare const normalizeError: (error: unknown) => Error;
-/**
- * Combines the `stderr` and `stdout` fields 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.
- */
-export declare const formatChildProcessError: (error: unknown) => string | undefined;
-//# sourceMappingURL=error.d.ts.map

package/dist/error.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"error.d.ts","sourceRoot":"","sources":["../src/error.ts"],"names":[],"mappings":"AAKA;;;;GAIG;AACH,eAAO,MAAM,YAAY,UAAW,OAAO,KAAG,MACgC,CAAC;AAE/E;;;;;GAKG;AACH,eAAO,MAAM,cAAc,UAAW,OAAO,KAAG,KAG/C,CAAC;AAQF;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,UAAW,OAAO,KAAG,MAAM,GAAG,SAKjE,CAAC"}

package/dist/error.js

@@ -1,40 +0,0 @@
-const isObject = (value) => typeof value === "object" && value !== null;
-const isErrorLike = (value) => isObject(value) && "message" in value && typeof value.message === "string";
-/**
- * Extracts a human-readable message from an unknown thrown value, falling back to its string form.
- *
- * @param error The caught value to describe.
- */
-export const errorMessage = (error) => Error.isError(error) || isErrorLike(error) ? error.message : String(error);
-/**
- * Coerces an unknown thrown value into an `Error`, reusing it if it already is one and otherwise
- * wrapping its message while copying any error-like own properties.
- *
- * @param error The caught value to normalize.
- */
-export const normalizeError = (error) => {
-    if (Error.isError(error))
-        return error;
-    return Object.assign(new Error(errorMessage(error)), isErrorLike(error) ? error : {});
-};
-const readStream = (value) => {
-    if (typeof value === "string")
-        return value;
-    if (value instanceof Uint8Array || Buffer.isBuffer(value))
-        return value.toString();
-    return "";
-};
-/**
- * Combines the `stderr` and `stdout` fields 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.
- */
-export const formatChildProcessError = (error) => {
-    if (!isObject(error))
-        return undefined;
-    const { stderr, stdout } = error;
-    const details = [readStream(stderr), readStream(stdout)].filter(Boolean).join("\n").trim();
-    return details.length > 0 ? details : undefined;
-};
-//# sourceMappingURL=error.js.map

package/dist/error.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"error.js","sourceRoot":"","sources":["../src/error.ts"],"names":[],"mappings":"AAAA,MAAM,QAAQ,GAAG,CAAC,KAAc,EAAoC,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,CAAC;AAEnH,MAAM,WAAW,GAAG,CAAC,KAAc,EAAgC,EAAE,CACjE,QAAQ,CAAC,KAAK,CAAC,IAAI,SAAS,IAAI,KAAK,IAAI,OAAO,KAAK,CAAC,OAAO,KAAK,QAAQ,CAAC;AAE/E;;;;GAIG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,KAAc,EAAU,EAAE,CACnD,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;AAE/E;;;;;GAKG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,KAAc,EAAS,EAAE;IACpD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACvC,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,CAAC;AAEF,MAAM,UAAU,GAAG,CAAC,KAAc,EAAU,EAAE;IAC1C,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC5C,IAAI,KAAK,YAAY,UAAU,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,QAAQ,EAAE,CAAC;IACnF,OAAO,EAAE,CAAC;AACd,CAAC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,KAAc,EAAsB,EAAE;IAC1E,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IACvC,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;IAC3F,OAAO,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;AACpD,CAAC,CAAC","sourcesContent":["const isObject = (value: unknown): value is Record<string, unknown> => typeof value === \"object\" && value !== null;\n\nconst isErrorLike = (value: unknown): value is { message: string } =>\n    isObject(value) && \"message\" in value && typeof value.message === \"string\";\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 */\nexport const errorMessage = (error: unknown): string =>\n    Error.isError(error) || isErrorLike(error) ? error.message : String(error);\n\n/**\n * Coerces an unknown thrown value into an `Error`, reusing it if 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 */\nexport const normalizeError = (error: unknown): Error => {\n    if (Error.isError(error)) return error;\n    return Object.assign(new Error(errorMessage(error)), isErrorLike(error) ? error : {});\n};\n\nconst readStream = (value: unknown): string => {\n    if (typeof value === \"string\") return value;\n    if (value instanceof Uint8Array || Buffer.isBuffer(value)) return value.toString();\n    return \"\";\n};\n\n/**\n * Combines the `stderr` and `stdout` fields 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 */\nexport const formatChildProcessError = (error: unknown): string | undefined => {\n    if (!isObject(error)) return undefined;\n    const { stderr, stdout } = error;\n    const details = [readStream(stderr), readStream(stdout)].filter(Boolean).join(\"\\n\").trim();\n    return details.length > 0 ? details : undefined;\n};\n"]}

package/dist/graceful-shutdown.d.ts

@@ -1,22 +0,0 @@
-/**
- * Maps a terminating signal to its conventional process exit code (130 for `SIGINT`, 143 otherwise),
- * or 0 when no signal is given.
- *
- * @param signal The signal that triggered termination, or `null`.
- */
-export declare const exitCodeForSignal: (signal: NodeJS.Signals | null) => number;
-export type GracefulShutdownOptions = {
-    onSignal: (signal: NodeJS.Signals) => void | Promise<void>;
-    onForce?: () => void;
-    forceKillAfterMs?: number;
-    coalesceWindowMs?: number;
-    exitCode?: (signal: NodeJS.Signals, graceful: boolean) => number;
-};
-/**
- * Registers handlers for `SIGINT`, `SIGTERM`, and `SIGHUP` that run the given cleanup callback once
- * and then exit, forcing exit if a repeated signal arrives or the cleanup exceeds its timeout.
- *
- * @param options The shutdown callbacks and timing configuration.
- */
-export declare const installGracefulShutdown: (options: GracefulShutdownOptions) => void;
-//# sourceMappingURL=graceful-shutdown.d.ts.map

package/dist/graceful-shutdown.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"graceful-shutdown.d.ts","sourceRoot":"","sources":["../src/graceful-shutdown.ts"],"names":[],"mappings":"AAMA;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,WAAY,MAAM,CAAC,OAAO,GAAG,IAAI,KAAG,MAGjE,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG;IAClC,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,OAAO,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3D,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,OAAO,EAAE,QAAQ,EAAE,OAAO,KAAK,MAAM,CAAC;CACpE,CAAC;AAsEF;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,YAAa,uBAAuB,KAAG,IAc1E,CAAC"}

package/dist/graceful-shutdown.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"graceful-shutdown.js","sourceRoot":"","sources":["../src/graceful-shutdown.ts"],"names":[],"mappings":"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","sourcesContent":["import { error } from \"./log.js\";\n\nconst HANDLED_SIGNALS = [\"SIGINT\", \"SIGTERM\", \"SIGHUP\"] as const satisfies NodeJS.Signals[];\nconst DEFAULT_FORCE_KILL_TIMEOUT_MS = 5000;\nconst DEFAULT_COALESCE_WINDOW_MS = 500;\n\n/**\n * Maps a terminating signal to its conventional process exit code (130 for `SIGINT`, 143 otherwise),\n * or 0 when no signal is given.\n *\n * @param signal The signal that triggered termination, or `null`.\n */\nexport const exitCodeForSignal = (signal: NodeJS.Signals | null): number => {\n    if (!signal) return 0;\n    return signal === \"SIGINT\" ? 130 : 143;\n};\n\nexport type GracefulShutdownOptions = {\n    onSignal: (signal: NodeJS.Signals) => void | Promise<void>;\n    onForce?: () => void;\n    forceKillAfterMs?: number;\n    coalesceWindowMs?: number;\n    exitCode?: (signal: NodeJS.Signals, graceful: boolean) => number;\n};\n\ntype ShutdownState = {\n    options: GracefulShutdownOptions;\n    forceKillMs: number;\n    coalesceWindowMs: number;\n    firstSignal: NodeJS.Signals | null;\n    exited: boolean;\n    coalescing: boolean;\n    forceTimer: NodeJS.Timeout | null;\n    coalesceTimer: NodeJS.Timeout | null;\n};\n\nconst clearTimers = (state: ShutdownState): void => {\n    if (state.forceTimer) {\n        clearTimeout(state.forceTimer);\n        state.forceTimer = null;\n    }\n    if (state.coalesceTimer) {\n        clearTimeout(state.coalesceTimer);\n        state.coalesceTimer = null;\n    }\n};\n\nconst finish = (state: ShutdownState, signal: NodeJS.Signals, graceful: boolean): void => {\n    if (state.exited) return;\n    state.exited = true;\n    clearTimers(state);\n    const { exitCode } = state.options;\n    const code = exitCode ? exitCode(signal, graceful) : graceful ? 0 : exitCodeForSignal(signal);\n    process.exit(code);\n};\n\nconst beginShutdown = (state: ShutdownState, signal: NodeJS.Signals): void => {\n    state.firstSignal = signal;\n    if (state.coalesceWindowMs > 0) {\n        state.coalescing = true;\n        state.coalesceTimer = setTimeout(() => {\n            state.coalescing = false;\n        }, state.coalesceWindowMs);\n        state.coalesceTimer.unref();\n    }\n    if (state.options.onForce && state.forceKillMs > 0) {\n        state.forceTimer = setTimeout(() => {\n            state.options.onForce?.();\n            finish(state, signal, false);\n        }, state.forceKillMs);\n        state.forceTimer.unref();\n    }\n    Promise.resolve()\n        .then(() => state.options.onSignal(signal))\n        .then(\n            () => finish(state, signal, true),\n            (reason: unknown) => {\n                error(\"graceful shutdown failed\", reason);\n                finish(state, signal, false);\n            },\n        );\n};\n\nconst handle = (state: ShutdownState, signal: NodeJS.Signals): void => {\n    if (state.firstSignal === null) {\n        beginShutdown(state, signal);\n        return;\n    }\n    if (state.coalescing) return;\n    state.options.onForce?.();\n    finish(state, signal, false);\n};\n\n/**\n * Registers handlers for `SIGINT`, `SIGTERM`, and `SIGHUP` that run the given cleanup callback once\n * and then exit, forcing exit if a repeated signal arrives or the cleanup exceeds its timeout.\n *\n * @param options The shutdown callbacks and timing configuration.\n */\nexport const installGracefulShutdown = (options: GracefulShutdownOptions): void => {\n    const state: ShutdownState = {\n        options,\n        forceKillMs: options.forceKillAfterMs ?? DEFAULT_FORCE_KILL_TIMEOUT_MS,\n        coalesceWindowMs: options.coalesceWindowMs ?? DEFAULT_COALESCE_WINDOW_MS,\n        firstSignal: null,\n        exited: false,\n        coalescing: false,\n        forceTimer: null,\n        coalesceTimer: null,\n    };\n    for (const sig of HANDLED_SIGNALS) {\n        process.on(sig, () => handle(state, sig));\n    }\n};\n"]}

package/dist/log.d.ts

@@ -1,103 +0,0 @@
-/**
- * Minimal writable-stream shape a {@link Logger} writes formatted lines to.
- */
-export 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}.
- */
-export 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.
- */
-export 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;
-}
-/**
- * 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.
- */
-export declare const createLogger: (namespace: string, options?: Omit<LoggerOptions, "namespace">) => Logger;
-/**
- * The default namespace-less {@link Logger} backing the module-level {@link info}, {@link warn},
- * {@link error}, and {@link debug} functions.
- */
-export 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.
- */
-export declare const 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.
- */
-export declare const 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.
- */
-export declare const 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.
- */
-export declare const debug: (message: string, ...rest: unknown[]) => void;
-//# sourceMappingURL=log.d.ts.map

package/dist/log.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"log.d.ts","sourceRoot":"","sources":["../src/log.ts"],"names":[],"mappings":"AAMA;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG;IACvB,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;IAC9B,qFAAqF;IACrF,KAAK,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CAC/B,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG;IACxB,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;AA0BF;;;GAGG;AACH,qBAAa,MAAM;IACf,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,YAAY,CAAU;IAC9B,OAAO,CAAC,MAAM,CAAS;IAEvB;;OAEG;IACH,YAAY,OAAO,GAAE,aAAkB,EAKtC;IAED,OAAO,CAAC,KAAK;IAKb;;;;;OAKG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAE9C;IAED;;;;;OAKG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAE9C;IAED;;;;;OAKG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAE/C;IAED;;;;;OAKG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAG/C;CACJ;AAED;;;;;GAKG;AACH,eAAO,MAAM,YAAY,cAAe,MAAM,YAAW,IAAI,CAAC,aAAa,EAAE,WAAW,CAAC,KAAQ,MACxD,CAAC;AAE1C;;;GAGG;AACH,eAAO,MAAM,MAAM,EAAE,MAAqB,CAAC;AAE3C;;;;;GAKG;AACH,eAAO,MAAM,IAAI,YAAa,MAAM,WAAW,OAAO,EAAE,KAAG,IAAqC,CAAC;AAEjG;;;;;GAKG;AACH,eAAO,MAAM,IAAI,YAAa,MAAM,WAAW,OAAO,EAAE,KAAG,IAAqC,CAAC;AAEjG;;;;;GAKG;AACH,eAAO,MAAM,KAAK,YAAa,MAAM,WAAW,OAAO,EAAE,KAAG,IAAsC,CAAC;AAEnG;;;;;GAKG;AACH,eAAO,MAAM,KAAK,YAAa,MAAM,WAAW,OAAO,EAAE,KAAG,IAAsC,CAAC"}

package/dist/log.js

@@ -1,129 +0,0 @@
-import pc from "picocolors";
-const BASE_PREFIX = "[gtkx]";
-const colorsFor = (stream) => pc.createColors(pc.isColorSupported && stream.isTTY === true);
-const 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);
-    }
-};
-const resolveDebugEnabled = (namespace, argv, env) => {
-    if (argv.includes("--debug"))
-        return true;
-    const spec = env.GTKX_DEBUG;
-    if (!spec)
-        return false;
-    const names = spec.split(/[\s,]+/).filter((name) => name.length > 0);
-    if (names.includes("1") || names.includes("*"))
-        return true;
-    return namespace !== undefined && names.includes(namespace);
-};
-const prefixFor = (namespace) => 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.
- */
-export 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 = prefixFor(options.namespace);
-        this.debugEnabled = options.debugEnabled ?? resolveDebugEnabled(options.namespace, process.argv, process.env);
-        this.colors = colorsFor(this.stream);
-    }
-    write(message, rest) {
-        const suffix = rest.length === 0 ? "" : ` ${rest.map(formatValue).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);
-    }
-}
-/**
- * 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.
- */
-export const createLogger = (namespace, options = {}) => new Logger({ ...options, namespace });
-/**
- * The default namespace-less {@link Logger} backing the module-level {@link info}, {@link warn},
- * {@link error}, and {@link debug} functions.
- */
-export 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.
- */
-export const 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.
- */
-export const 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.
- */
-export const 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.
- */
-export const debug = (message, ...rest) => logger.debug(message, ...rest);
-//# sourceMappingURL=log.js.map