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

package/dist/log.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"log.js","sourceRoot":"","sources":["../src/log.ts"],"names":[],"mappings":"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","sourcesContent":["import pc from \"picocolors\";\n\nconst BASE_PREFIX = \"[gtkx]\";\n\ntype Colors = ReturnType<typeof pc.createColors>;\n\n/**\n * Minimal writable-stream shape a {@link Logger} writes formatted lines to.\n */\nexport type 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 */\nexport type 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 colorsFor = (stream: OutputStream): Colors => pc.createColors(pc.isColorSupported && stream.isTTY === true);\n\nconst formatValue = (value: unknown): string => {\n    if (typeof value === \"string\") return value;\n    if (value instanceof Error) return value.stack ?? value.message;\n    try {\n        return JSON.stringify(value);\n    } catch {\n        return String(value);\n    }\n};\n\nconst resolveDebugEnabled = (namespace: string | undefined, argv: string[], env: NodeJS.ProcessEnv): boolean => {\n    if (argv.includes(\"--debug\")) return true;\n    const spec = env.GTKX_DEBUG;\n    if (!spec) return false;\n    const names = spec.split(/[\\s,]+/).filter((name) => name.length > 0);\n    if (names.includes(\"1\") || names.includes(\"*\")) return true;\n    return namespace !== undefined && names.includes(namespace);\n};\n\nconst prefixFor = (namespace: string | undefined): string =>\n    namespace === undefined ? BASE_PREFIX : `[gtkx:${namespace}]`;\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 */\nexport class 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 = prefixFor(options.namespace);\n        this.debugEnabled = options.debugEnabled ?? resolveDebugEnabled(options.namespace, process.argv, process.env);\n        this.colors = colorsFor(this.stream);\n    }\n\n    private write(message: string, rest: unknown[]): void {\n        const suffix = rest.length === 0 ? \"\" : ` ${rest.map(formatValue).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) return;\n        this.write(message, rest);\n    }\n}\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 */\nexport const createLogger = (namespace: string, options: Omit<LoggerOptions, \"namespace\"> = {}): Logger =>\n    new Logger({ ...options, namespace });\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 */\nexport const 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 */\nexport const info = (message: string, ...rest: unknown[]): void => logger.info(message, ...rest);\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 */\nexport const warn = (message: string, ...rest: unknown[]): void => logger.warn(message, ...rest);\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 */\nexport const error = (message: string, ...rest: unknown[]): void => logger.error(message, ...rest);\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 */\nexport const debug = (message: string, ...rest: unknown[]): void => logger.debug(message, ...rest);\n"]}

package/dist/package-version.d.ts

@@ -1,7 +0,0 @@
-/**
- * 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`.
- */
-export declare const packageVersion: (importMetaUrl: string) => string;
-//# sourceMappingURL=package-version.d.ts.map

package/dist/package-version.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"package-version.d.ts","sourceRoot":"","sources":["../src/package-version.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,eAAO,MAAM,cAAc,kBAAmB,MAAM,KAAG,MAC6B,CAAC"}

package/dist/package-version.js

@@ -1,8 +0,0 @@
-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`.
- */
-export const packageVersion = (importMetaUrl) => createRequire(importMetaUrl)("../package.json").version;
-//# sourceMappingURL=package-version.js.map

package/dist/package-version.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"package-version.js","sourceRoot":"","sources":["../src/package-version.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C;;;;GAIG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,aAAqB,EAAU,EAAE,CAC3D,aAAa,CAAC,aAAa,CAAC,CAAC,iBAAiB,CAAyB,CAAC,OAAO,CAAC","sourcesContent":["import { createRequire } from \"node:module\";\n\n/**\n * Reads the `version` field from the `package.json` next to the calling module.\n *\n * @param importMetaUrl The caller's `import.meta.url`, used to resolve the sibling `package.json`.\n */\nexport const packageVersion = (importMetaUrl: string): string =>\n    (createRequire(importMetaUrl)(\"../package.json\") as { version: string }).version;\n"]}

package/dist/reflect.d.ts

@@ -1,11 +0,0 @@
-/**
- * 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 method name to look up.
- * @param args Arguments passed to the method.
- * @returns The method's return value, or `undefined` when it is not a function.
- */
-export declare const callMethod: (target: object, method: string, args: unknown[]) => unknown;
-//# sourceMappingURL=reflect.d.ts.map

package/dist/reflect.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"reflect.d.ts","sourceRoot":"","sources":["../src/reflect.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,eAAO,MAAM,UAAU,WAAY,MAAM,UAAU,MAAM,QAAQ,OAAO,EAAE,KAAG,OAG5E,CAAC"}

package/dist/reflect.js

@@ -1,14 +0,0 @@
-/**
- * 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 method name to look up.
- * @param args Arguments passed to the method.
- * @returns The method's return value, or `undefined` when it is not a function.
- */
-export const callMethod = (target, method, args) => {
-    const fn = Reflect.get(target, method);
-    return typeof fn === "function" ? Reflect.apply(fn, target, args) : undefined;
-};
-//# sourceMappingURL=reflect.js.map

package/dist/reflect.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"reflect.js","sourceRoot":"","sources":["../src/reflect.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,MAAc,EAAE,MAAc,EAAE,IAAe,EAAW,EAAE;IACnF,MAAM,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC,OAAO,OAAO,EAAE,KAAK,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AAClF,CAAC,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 method name to look up.\n * @param args Arguments passed to the method.\n * @returns The method's return value, or `undefined` when it is not a function.\n */\nexport const callMethod = (target: object, method: string, args: unknown[]): unknown => {\n    const fn = Reflect.get(target, method);\n    return typeof fn === \"function\" ? Reflect.apply(fn, target, args) : undefined;\n};\n"]}

package/dist/source.d.ts

@@ -1,21 +0,0 @@
-/**
- * Returns the name unchanged, or with a trailing underscore when it collides with a reserved word,
- * so it is safe to emit as a JavaScript identifier.
- *
- * @param name The candidate identifier.
- */
-export declare const sanitizeIdentifier: (name: string) => string;
-/**
- * Converts a name to camelCase and sanitizes it into a valid JavaScript identifier.
- *
- * @param name The name to convert.
- */
-export declare const toCamelIdentifier: (name: string) => string;
-/**
- * Encodes a string as a JavaScript string literal, additionally escaping characters that are unsafe
- * to embed in generated source (angle brackets and the line and paragraph separators).
- *
- * @param value The string to encode.
- */
-export declare const sourceStringLiteral: (value: string) => string;
-//# sourceMappingURL=source.d.ts.map

package/dist/source.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"source.d.ts","sourceRoot":"","sources":["../src/source.ts"],"names":[],"mappings":"AAoDA;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,SAAU,MAAM,KAAG,MAAkD,CAAC;AAErG;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,SAAU,MAAM,KAAG,MAA+C,CAAC;AAWjG;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,UAAW,MAAM,KAAG,MAC0C,CAAC"}

package/dist/source.js

@@ -1,78 +0,0 @@
-import { toCamelCase } from "./string.js";
-const RESERVED = new Set([
-    "arguments",
-    "await",
-    "break",
-    "case",
-    "catch",
-    "class",
-    "const",
-    "continue",
-    "debugger",
-    "default",
-    "delete",
-    "do",
-    "else",
-    "enum",
-    "eval",
-    "export",
-    "extends",
-    "false",
-    "finally",
-    "for",
-    "function",
-    "if",
-    "import",
-    "in",
-    "instanceof",
-    "interface",
-    "let",
-    "new",
-    "null",
-    "package",
-    "private",
-    "protected",
-    "public",
-    "return",
-    "static",
-    "super",
-    "switch",
-    "this",
-    "throw",
-    "true",
-    "try",
-    "typeof",
-    "var",
-    "void",
-    "while",
-    "with",
-    "yield",
-]);
-/**
- * Returns the name unchanged, or with a trailing underscore when it collides with a reserved word,
- * so it is safe to emit as a JavaScript identifier.
- *
- * @param name The candidate identifier.
- */
-export const sanitizeIdentifier = (name) => (RESERVED.has(name) ? `${name}_` : name);
-/**
- * Converts a name to camelCase and sanitizes it into a valid JavaScript identifier.
- *
- * @param name The name to convert.
- */
-export const toCamelIdentifier = (name) => sanitizeIdentifier(toCamelCase(name));
-const SOURCE_ESCAPES = {
-    "<": "\\u003C",
-    ">": "\\u003E",
-    "\u2028": "\\u2028",
-    "\u2029": "\\u2029",
-};
-const UNSAFE_SOURCE_CHARS = new RegExp(`[${Object.keys(SOURCE_ESCAPES).join("")}]`, "g");
-/**
- * Encodes a string as a JavaScript string literal, additionally escaping characters that are unsafe
- * to embed in generated source (angle brackets and the line and paragraph separators).
- *
- * @param value The string to encode.
- */
-export const sourceStringLiteral = (value) => JSON.stringify(value).replace(UNSAFE_SOURCE_CHARS, (char) => SOURCE_ESCAPES[char] ?? char);
-//# sourceMappingURL=source.js.map

package/dist/source.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"source.js","sourceRoot":"","sources":["../src/source.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,MAAM,QAAQ,GAAgB,IAAI,GAAG,CAAC;IAClC,WAAW;IACX,OAAO;IACP,OAAO;IACP,MAAM;IACN,OAAO;IACP,OAAO;IACP,OAAO;IACP,UAAU;IACV,UAAU;IACV,SAAS;IACT,QAAQ;IACR,IAAI;IACJ,MAAM;IACN,MAAM;IACN,MAAM;IACN,QAAQ;IACR,SAAS;IACT,OAAO;IACP,SAAS;IACT,KAAK;IACL,UAAU;IACV,IAAI;IACJ,QAAQ;IACR,IAAI;IACJ,YAAY;IACZ,WAAW;IACX,KAAK;IACL,KAAK;IACL,MAAM;IACN,SAAS;IACT,SAAS;IACT,WAAW;IACX,QAAQ;IACR,QAAQ;IACR,QAAQ;IACR,OAAO;IACP,QAAQ;IACR,MAAM;IACN,OAAO;IACP,MAAM;IACN,KAAK;IACL,QAAQ;IACR,KAAK;IACL,MAAM;IACN,OAAO;IACP,MAAM;IACN,OAAO;CACV,CAAC,CAAC;AAEH;;;;;GAKG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,IAAY,EAAU,EAAE,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;AAErG;;;;GAIG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,IAAY,EAAU,EAAE,CAAC,kBAAkB,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC;AAEjG,MAAM,cAAc,GAA2B;IAC3C,GAAG,EAAE,SAAS;IACd,GAAG,EAAE,SAAS;IACd,QAAQ,EAAE,SAAS;IACnB,QAAQ,EAAE,SAAS;CACtB,CAAC;AAEF,MAAM,mBAAmB,GAAG,IAAI,MAAM,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;AAEzF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,KAAa,EAAU,EAAE,CACzD,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,mBAAmB,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,CAAC","sourcesContent":["import { toCamelCase } from \"./string.js\";\n\nconst RESERVED: Set<string> = new Set([\n    \"arguments\",\n    \"await\",\n    \"break\",\n    \"case\",\n    \"catch\",\n    \"class\",\n    \"const\",\n    \"continue\",\n    \"debugger\",\n    \"default\",\n    \"delete\",\n    \"do\",\n    \"else\",\n    \"enum\",\n    \"eval\",\n    \"export\",\n    \"extends\",\n    \"false\",\n    \"finally\",\n    \"for\",\n    \"function\",\n    \"if\",\n    \"import\",\n    \"in\",\n    \"instanceof\",\n    \"interface\",\n    \"let\",\n    \"new\",\n    \"null\",\n    \"package\",\n    \"private\",\n    \"protected\",\n    \"public\",\n    \"return\",\n    \"static\",\n    \"super\",\n    \"switch\",\n    \"this\",\n    \"throw\",\n    \"true\",\n    \"try\",\n    \"typeof\",\n    \"var\",\n    \"void\",\n    \"while\",\n    \"with\",\n    \"yield\",\n]);\n\n/**\n * Returns the name unchanged, or with a trailing underscore when it collides with a reserved word,\n * so it is safe to emit as a JavaScript identifier.\n *\n * @param name The candidate identifier.\n */\nexport const sanitizeIdentifier = (name: string): string => (RESERVED.has(name) ? `${name}_` : name);\n\n/**\n * Converts a name to camelCase and sanitizes it into a valid JavaScript identifier.\n *\n * @param name The name to convert.\n */\nexport const toCamelIdentifier = (name: string): string => sanitizeIdentifier(toCamelCase(name));\n\nconst SOURCE_ESCAPES: Record<string, string> = {\n    \"<\": \"\\\\u003C\",\n    \">\": \"\\\\u003E\",\n    \"\\u2028\": \"\\\\u2028\",\n    \"\\u2029\": \"\\\\u2029\",\n};\n\nconst UNSAFE_SOURCE_CHARS = new RegExp(`[${Object.keys(SOURCE_ESCAPES).join(\"\")}]`, \"g\");\n\n/**\n * Encodes a string as a JavaScript string literal, additionally escaping characters that are unsafe\n * to embed in generated source (angle brackets and the line and paragraph separators).\n *\n * @param value The string to encode.\n */\nexport const sourceStringLiteral = (value: string): string =>\n    JSON.stringify(value).replace(UNSAFE_SOURCE_CHARS, (char) => SOURCE_ESCAPES[char] ?? char);\n"]}

package/dist/string.d.ts

@@ -1,32 +0,0 @@
-/**
- * Returns the string with its first character uppercased.
- *
- * @param value The string to transform.
- */
-export declare const upperFirst: (value: string) => string;
-/**
- * Returns the string with its first character lowercased.
- *
- * @param value The string to transform.
- */
-export declare const lowerFirst: (value: string) => string;
-/**
- * Converts an underscore- or hyphen-delimited string to camelCase.
- *
- * @param input The string to convert.
- */
-export declare const toCamelCase: (input: string) => string;
-/**
- * Converts an underscore- or hyphen-delimited string to PascalCase.
- *
- * @param input The string to convert.
- */
-export declare const toPascalCase: (input: string) => string;
-/**
- * Converts a camelCase or PascalCase string to kebab-case by lowercasing uppercase letters and
- * inserting hyphens before interior ones.
- *
- * @param input The string to convert.
- */
-export declare const toKebabCase: (input: string) => string;
-//# sourceMappingURL=string.d.ts.map

package/dist/string.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"string.d.ts","sourceRoot":"","sources":["../src/string.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,eAAO,MAAM,UAAU,UAAW,MAAM,KAAG,MAAwD,CAAC;AAEpG;;;;GAIG;AACH,eAAO,MAAM,UAAU,UAAW,MAAM,KAAG,MAAwD,CAAC;AAIpG;;;;GAIG;AACH,eAAO,MAAM,WAAW,UAAW,MAAM,KAAG,MAI3C,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,YAAY,UAAW,MAAM,KAAG,MAI5C,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,WAAW,UAAW,MAAM,KAAG,MAC0E,CAAC"}

package/dist/string.js

@@ -1,43 +0,0 @@
-/**
- * Returns the string with its first character uppercased.
- *
- * @param value The string to transform.
- */
-export const upperFirst = (value) => value.charAt(0).toUpperCase() + value.slice(1);
-/**
- * Returns the string with its first character lowercased.
- *
- * @param value The string to transform.
- */
-export const lowerFirst = (value) => value.charAt(0).toLowerCase() + value.slice(1);
-const splitWords = (input) => input.split(/[_-]/g).filter((part) => part.length > 0);
-/**
- * Converts an underscore- or hyphen-delimited string to camelCase.
- *
- * @param input The string to convert.
- */
-export const toCamelCase = (input) => {
-    const parts = splitWords(input);
-    if (parts.length === 0)
-        return input;
-    return parts.map((part, index) => (index === 0 ? part : upperFirst(part))).join("");
-};
-/**
- * Converts an underscore- or hyphen-delimited string to PascalCase.
- *
- * @param input The string to convert.
- */
-export const toPascalCase = (input) => {
-    const parts = splitWords(input);
-    if (parts.length === 0)
-        return input;
-    return parts.map(upperFirst).join("");
-};
-/**
- * Converts a camelCase or PascalCase string to kebab-case by lowercasing uppercase letters and
- * inserting hyphens before interior ones.
- *
- * @param input The string to convert.
- */
-export const toKebabCase = (input) => input.replaceAll(/[A-Z]/g, (char, index) => (index === 0 ? char.toLowerCase() : `-${char.toLowerCase()}`));
-//# sourceMappingURL=string.js.map

package/dist/string.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"string.js","sourceRoot":"","sources":["../src/string.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,KAAa,EAAU,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AAEpG;;;;GAIG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,KAAa,EAAU,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AAEpG,MAAM,UAAU,GAAG,CAAC,KAAa,EAAY,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AAEvG;;;;GAIG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,KAAa,EAAU,EAAE;IACjD,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;IAChC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACrC,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AACxF,CAAC,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,KAAa,EAAU,EAAE;IAClD,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;IAChC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACrC,OAAO,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AAC1C,CAAC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,KAAa,EAAU,EAAE,CACjD,KAAK,CAAC,UAAU,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,KAAa,EAAE,EAAE,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC,CAAC","sourcesContent":["/**\n * Returns the string with its first character uppercased.\n *\n * @param value The string to transform.\n */\nexport const upperFirst = (value: string): string => value.charAt(0).toUpperCase() + value.slice(1);\n\n/**\n * Returns the string with its first character lowercased.\n *\n * @param value The string to transform.\n */\nexport const lowerFirst = (value: string): string => value.charAt(0).toLowerCase() + value.slice(1);\n\nconst splitWords = (input: string): string[] => input.split(/[_-]/g).filter((part) => part.length > 0);\n\n/**\n * Converts an underscore- or hyphen-delimited string to camelCase.\n *\n * @param input The string to convert.\n */\nexport const toCamelCase = (input: string): string => {\n    const parts = splitWords(input);\n    if (parts.length === 0) return input;\n    return parts.map((part, index) => (index === 0 ? part : upperFirst(part))).join(\"\");\n};\n\n/**\n * Converts an underscore- or hyphen-delimited string to PascalCase.\n *\n * @param input The string to convert.\n */\nexport const toPascalCase = (input: string): string => {\n    const parts = splitWords(input);\n    if (parts.length === 0) return input;\n    return parts.map(upperFirst).join(\"\");\n};\n\n/**\n * Converts a camelCase or PascalCase string to kebab-case by lowercasing uppercase letters and\n * inserting hyphens before interior ones.\n *\n * @param input The string to convert.\n */\nexport const toKebabCase = (input: string): string =>\n    input.replaceAll(/[A-Z]/g, (char, index: number) => (index === 0 ? char.toLowerCase() : `-${char.toLowerCase()}`));\n"]}

package/src/class.ts

@@ -1,36 +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 function getParentClass(cls: AnyClass): AnyClass | null {
-    const parent: unknown = Object.getPrototypeOf(cls);
-    return typeof parent === "function" && parent !== Function.prototype ? (parent as 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 function walkClassChain<T>(cls: AnyClass | null, visit: (ancestor: AnyClass) => T | undefined): T | undefined {
-    let current = cls;
-    while (current !== null) {
-        const result = visit(current);
-        if (result !== undefined) return result;
-        current = getParentClass(current);
-    }
-    return undefined;
-}

package/src/collection.ts

@@ -1,65 +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 = <T>(items: T[], key: (item: T) => string): T[] => {
-    const seen = new Set<string>();
-    const result: T[] = [];
-    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 = <T>(a: T[], b: T[]): boolean => {
-    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: string, b: string): number => 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: Iterable<string>): string[] => [...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 = <T>(items: Iterable<T>, key: (item: T) => string): T[] =>
-    [...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 = <T extends Record<string, unknown>>(a?: T, b?: T): boolean => {
-    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;
-};

package/src/error.ts

@@ -1,42 +0,0 @@
-const isObject = (value: unknown): value is Record<string, unknown> => typeof value === "object" && value !== null;
-
-const isErrorLike = (value: unknown): value is { message: string } =>
-    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: unknown): string =>
-    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: unknown): Error => {
-    if (Error.isError(error)) return error;
-    return Object.assign(new Error(errorMessage(error)), isErrorLike(error) ? error : {});
-};
-
-const readStream = (value: unknown): string => {
-    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: unknown): string | undefined => {
-    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;
-};

package/src/log.ts

@@ -1,164 +0,0 @@
-import pc from "picocolors";
-
-const BASE_PREFIX = "[gtkx]";
-
-type Colors = ReturnType<typeof pc.createColors>;
-
-/**
- * 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;
-};
-
-const colorsFor = (stream: OutputStream): Colors => pc.createColors(pc.isColorSupported && stream.isTTY === true);
-
-const formatValue = (value: unknown): string => {
-    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: string | undefined, argv: string[], env: NodeJS.ProcessEnv): boolean => {
-    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: string | undefined): string =>
-    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 {
-    private stream: OutputStream;
-    private prefix: string;
-    private debugEnabled: boolean;
-    private colors: Colors;
-
-    /**
-     * @param options Namespace, target stream, and debug configuration for the logger.
-     */
-    constructor(options: LoggerOptions = {}) {
-        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);
-    }
-
-    private write(message: string, rest: unknown[]): void {
-        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: string, ...rest: unknown[]): void {
-        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: string, ...rest: unknown[]): void {
-        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: string, ...rest: unknown[]): void {
-        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: string, ...rest: unknown[]): void {
-        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: string, options: Omit<LoggerOptions, "namespace"> = {}): Logger =>
-    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: 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: string, ...rest: unknown[]): void => 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: string, ...rest: unknown[]): void => 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: string, ...rest: unknown[]): void => 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: string, ...rest: unknown[]): void => logger.debug(message, ...rest);

package/src/package-version.ts

@@ -1,9 +0,0 @@
-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`.
- */
-export const packageVersion = (importMetaUrl: string): string =>
-    (createRequire(importMetaUrl)("../package.json") as { version: string }).version;

package/src/reflect.ts

@@ -1,13 +0,0 @@
-/**
- * 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 method name to look up.
- * @param args Arguments passed to the method.
- * @returns The method's return value, or `undefined` when it is not a function.
- */
-export const callMethod = (target: object, method: string, args: unknown[]): unknown => {
-    const fn = Reflect.get(target, method);
-    return typeof fn === "function" ? Reflect.apply(fn, target, args) : undefined;
-};