@gtkx/utils 0.21.0 → 1.0.0-rc.2

package/dist/process/install-graceful-shutdown.d.ts

@@ -0,0 +1,16 @@
+type GracefulShutdownOptions = {
+    onSignal: (signal: NodeJS.Signals) => void | Promise<void>;
+    onForce?: () => void;
+    forceKillAfterMs?: number;
+    coalesceWindowMs?: number;
+    exitCode?: (signal: NodeJS.Signals, isGraceful: 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.
+ */
+declare function installGracefulShutdown(options: GracefulShutdownOptions): void;
+export { installGracefulShutdown, type GracefulShutdownOptions };
+//# sourceMappingURL=install-graceful-shutdown.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"install-graceful-shutdown.d.ts","sourceRoot":"","sources":["../../src/process/install-graceful-shutdown.ts"],"names":[],"mappings":"AAGA,KAAK,uBAAuB,GAAG;IAC3B,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,UAAU,EAAE,OAAO,KAAK,MAAM,CAAC;CACtE,CAAC;AA2FF;;;;;GAKG;AACH,iBAAS,uBAAuB,CAAC,OAAO,EAAE,uBAAuB,GAAG,IAAI,CAiBvE;AAED,OAAO,EAAE,uBAAuB,EAAE,KAAK,uBAAuB,EAAE,CAAC"}

package/dist/process/install-graceful-shutdown.js

@@ -0,0 +1,89 @@
+import { error } from "../log/default-logger.js";
+import { exitCodeForSignal } from "./exit-code-for-signal.js";
+const HANDLED_SIGNALS = ["SIGINT", "SIGTERM", "SIGHUP"];
+const DEFAULT_FORCE_KILL_TIMEOUT_MS = 5000;
+const DEFAULT_COALESCE_WINDOW_MS = 500;
+const clearTimers = (state) => {
+    if (state.forceTimer) {
+        clearTimeout(state.forceTimer);
+        state.forceTimer = null;
+    }
+    if (state.coalesceTimer) {
+        clearTimeout(state.coalesceTimer);
+        state.coalesceTimer = null;
+    }
+};
+const finish = (state, signal, isGraceful) => {
+    if (state.exited) {
+        return;
+    }
+    state.exited = true;
+    clearTimers(state);
+    const { exitCode } = state.options;
+    const defaultCode = isGraceful ? 0 : exitCodeForSignal(signal);
+    process.exit(exitCode ? exitCode(signal, isGraceful) : defaultCode);
+};
+const runShutdown = async (state, signal) => {
+    try {
+        await state.options.onSignal(signal);
+        finish(state, signal, true);
+    }
+    catch (error_) {
+        error("graceful shutdown failed", error_);
+        finish(state, signal, false);
+    }
+};
+const beginShutdown = (state, signal) => {
+    state.firstSignal = signal;
+    if (state.coalesceWindowMs > 0) {
+        state.coalescing = true;
+        state.coalesceTimer = setTimeout(() => {
+            state.coalescing = false;
+        }, state.coalesceWindowMs);
+        state.coalesceTimer.unref();
+    }
+    if (state.options.onForce && state.forceKillMs > 0) {
+        state.forceTimer = setTimeout(() => {
+            state.options.onForce?.();
+            finish(state, signal, false);
+        }, state.forceKillMs);
+        state.forceTimer.unref();
+    }
+    void runShutdown(state, signal);
+};
+const handle = (state, signal) => {
+    if (state.firstSignal === null) {
+        beginShutdown(state, signal);
+        return;
+    }
+    if (state.coalescing) {
+        return;
+    }
+    state.options.onForce?.();
+    finish(state, signal, false);
+};
+/**
+ * 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.
+ */
+function installGracefulShutdown(options) {
+    const state = {
+        options,
+        forceKillMs: options.forceKillAfterMs ?? DEFAULT_FORCE_KILL_TIMEOUT_MS,
+        coalesceWindowMs: options.coalesceWindowMs ?? DEFAULT_COALESCE_WINDOW_MS,
+        firstSignal: null,
+        exited: false,
+        coalescing: false,
+        forceTimer: null,
+        coalesceTimer: null,
+    };
+    for (const sig of HANDLED_SIGNALS) {
+        process.on(sig, () => {
+            handle(state, sig);
+        });
+    }
+}
+export { installGracefulShutdown };
+//# sourceMappingURL=install-graceful-shutdown.js.map

package/dist/process/install-graceful-shutdown.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"install-graceful-shutdown.js","sourceRoot":"","sources":["../../src/process/install-graceful-shutdown.ts"],"names":[],"mappings":"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","sourcesContent":["import { error } from \"../log/default-logger.js\";\nimport { exitCodeForSignal } from \"./exit-code-for-signal.js\";\n\ntype GracefulShutdownOptions = {\n    onSignal: (signal: NodeJS.Signals) => void | Promise<void>;\n    onForce?: () => void;\n    forceKillAfterMs?: number;\n    coalesceWindowMs?: number;\n    exitCode?: (signal: NodeJS.Signals, isGraceful: 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 HANDLED_SIGNALS = [\"SIGINT\", \"SIGTERM\", \"SIGHUP\"] as const satisfies NodeJS.Signals[];\nconst DEFAULT_FORCE_KILL_TIMEOUT_MS = 5000;\nconst DEFAULT_COALESCE_WINDOW_MS = 500;\n\nconst clearTimers = (state: ShutdownState): void => {\n    if (state.forceTimer) {\n        clearTimeout(state.forceTimer);\n        state.forceTimer = null;\n    }\n\n    if (state.coalesceTimer) {\n        clearTimeout(state.coalesceTimer);\n        state.coalesceTimer = null;\n    }\n};\n\nconst finish = (state: ShutdownState, signal: NodeJS.Signals, isGraceful: boolean): void => {\n    if (state.exited) {\n        return;\n    }\n\n    state.exited = true;\n    clearTimers(state);\n    const { exitCode } = state.options;\n    const defaultCode = isGraceful ? 0 : exitCodeForSignal(signal);\n    process.exit(exitCode ? exitCode(signal, isGraceful) : defaultCode);\n};\n\nconst runShutdown = async (state: ShutdownState, signal: NodeJS.Signals): Promise<void> => {\n    try {\n        await state.options.onSignal(signal);\n        finish(state, signal, true);\n    } catch (error_) {\n        error(\"graceful shutdown failed\", error_);\n        finish(state, signal, false);\n    }\n};\n\nconst beginShutdown = (state: ShutdownState, signal: NodeJS.Signals): void => {\n    state.firstSignal = signal;\n\n    if (state.coalesceWindowMs > 0) {\n        state.coalescing = true;\n\n        state.coalesceTimer = setTimeout(() => {\n            state.coalescing = false;\n        }, state.coalesceWindowMs);\n\n        state.coalesceTimer.unref();\n    }\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\n        state.forceTimer.unref();\n    }\n\n    void runShutdown(state, signal);\n};\n\nconst handle = (state: ShutdownState, signal: NodeJS.Signals): void => {\n    if (state.firstSignal === null) {\n        beginShutdown(state, signal);\n\n        return;\n    }\n\n    if (state.coalescing) {\n        return;\n    }\n\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 */\nfunction 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\n    for (const sig of HANDLED_SIGNALS) {\n        process.on(sig, () => {\n            handle(state, sig);\n        });\n    }\n}\n\nexport { installGracefulShutdown, type GracefulShutdownOptions };\n"]}

package/dist/process/resolve-executable.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Resolves an executable to an absolute path, searching `PATH` only for a bare command name, so
+ * spawning it never re-runs a lookup against a `PATH` that may have changed.
+ *
+ * @param command - An executable name, or a path to one.
+ * @returns The absolute path of the executable.
+ * @throws When a bare command name is not found on `PATH`.
+ *
+ * @example
+ * resolveExecutable("weston"); // "/usr/bin/weston"
+ */
+declare function resolveExecutable(command: string): string;
+export { resolveExecutable };
+//# sourceMappingURL=resolve-executable.d.ts.map

package/dist/process/resolve-executable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-executable.d.ts","sourceRoot":"","sources":["../../src/process/resolve-executable.ts"],"names":[],"mappings":"AA2BA;;;;;;;;;;GAUG;AACH,iBAAS,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAgBlD;AAED,OAAO,EAAE,iBAAiB,EAAE,CAAC"}

package/dist/process/resolve-executable.js

@@ -0,0 +1,47 @@
+import { accessSync, constants } from "node:fs";
+import { delimiter, isAbsolute, join, resolve } from "node:path";
+const isExecutable = (path) => {
+    try {
+        accessSync(path, constants.X_OK);
+        return true;
+    }
+    catch {
+        return false;
+    }
+};
+const findOnPath = (command) => {
+    const searchPaths = (process.env.PATH ?? "").split(delimiter).filter((entry) => entry.length > 0);
+    for (const directory of searchPaths) {
+        const candidate = join(directory, command);
+        if (isExecutable(candidate)) {
+            return candidate;
+        }
+    }
+    return undefined;
+};
+/**
+ * Resolves an executable to an absolute path, searching `PATH` only for a bare command name, so
+ * spawning it never re-runs a lookup against a `PATH` that may have changed.
+ *
+ * @param command - An executable name, or a path to one.
+ * @returns The absolute path of the executable.
+ * @throws When a bare command name is not found on `PATH`.
+ *
+ * @example
+ * resolveExecutable("weston"); // "/usr/bin/weston"
+ */
+function resolveExecutable(command) {
+    if (isAbsolute(command)) {
+        return command;
+    }
+    if (command.includes("/")) {
+        return resolve(command);
+    }
+    const found = findOnPath(command);
+    if (found === undefined) {
+        throw new Error(`Cannot find the "${command}" executable on PATH`);
+    }
+    return found;
+}
+export { resolveExecutable };
+//# sourceMappingURL=resolve-executable.js.map

package/dist/process/resolve-executable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-executable.js","sourceRoot":"","sources":["../../src/process/resolve-executable.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEjE,MAAM,YAAY,GAAG,CAAC,IAAY,EAAW,EAAE;IAC3C,IAAI,CAAC;QACD,UAAU,CAAC,IAAI,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC;QAEjC,OAAO,IAAI,CAAC;IAChB,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,KAAK,CAAC;IACjB,CAAC;AACL,CAAC,CAAC;AAEF,MAAM,UAAU,GAAG,CAAC,OAAe,EAAsB,EAAE;IACvD,MAAM,WAAW,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAElG,KAAK,MAAM,SAAS,IAAI,WAAW,EAAE,CAAC;QAClC,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QAE3C,IAAI,YAAY,CAAC,SAAS,CAAC,EAAE,CAAC;YAC1B,OAAO,SAAS,CAAC;QACrB,CAAC;IACL,CAAC;IAED,OAAO,SAAS,CAAC;AACrB,CAAC,CAAC;AAEF;;;;;;;;;;GAUG;AACH,SAAS,iBAAiB,CAAC,OAAe;IACtC,IAAI,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QACtB,OAAO,OAAO,CAAC;IACnB,CAAC;IAED,IAAI,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QACxB,OAAO,OAAO,CAAC,OAAO,CAAC,CAAC;IAC5B,CAAC;IAED,MAAM,KAAK,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC;IAElC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CAAC,oBAAoB,OAAO,sBAAsB,CAAC,CAAC;IACvE,CAAC;IAED,OAAO,KAAK,CAAC;AACjB,CAAC;AAED,OAAO,EAAE,iBAAiB,EAAE,CAAC","sourcesContent":["import { accessSync, constants } from \"node:fs\";\nimport { delimiter, isAbsolute, join, resolve } from \"node:path\";\n\nconst isExecutable = (path: string): boolean => {\n    try {\n        accessSync(path, constants.X_OK);\n\n        return true;\n    } catch {\n        return false;\n    }\n};\n\nconst findOnPath = (command: string): string | undefined => {\n    const searchPaths = (process.env.PATH ?? \"\").split(delimiter).filter((entry) => entry.length > 0);\n\n    for (const directory of searchPaths) {\n        const candidate = join(directory, command);\n\n        if (isExecutable(candidate)) {\n            return candidate;\n        }\n    }\n\n    return undefined;\n};\n\n/**\n * Resolves an executable to an absolute path, searching `PATH` only for a bare command name, so\n * spawning it never re-runs a lookup against a `PATH` that may have changed.\n *\n * @param command - An executable name, or a path to one.\n * @returns The absolute path of the executable.\n * @throws When a bare command name is not found on `PATH`.\n *\n * @example\n * resolveExecutable(\"weston\"); // \"/usr/bin/weston\"\n */\nfunction resolveExecutable(command: string): string {\n    if (isAbsolute(command)) {\n        return command;\n    }\n\n    if (command.includes(\"/\")) {\n        return resolve(command);\n    }\n\n    const found = findOnPath(command);\n\n    if (found === undefined) {\n        throw new Error(`Cannot find the \"${command}\" executable on PATH`);\n    }\n\n    return found;\n}\n\nexport { resolveExecutable };\n"]}

package/dist/set/drain.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Iterates every item currently in `set`, then clears it. Use it to drain a set of pending work
+ * accumulated since the last drain.
+ *
+ * @template T - The set item type.
+ * @param set - The set to drain and clear.
+ * @param visit - Called with each item before the set is cleared.
+ */
+declare const drain: <T>(set: Set<T>, visit: (item: T) => void) => void;
+export { drain };
+//# sourceMappingURL=drain.d.ts.map

package/dist/set/drain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"drain.d.ts","sourceRoot":"","sources":["../../src/set/drain.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,QAAA,MAAM,KAAK,GAAI,CAAC,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,KAAK,IAAI,KAAG,IAMzD,CAAC;AAEF,OAAO,EAAE,KAAK,EAAE,CAAC"}

package/dist/set/drain.js

@@ -0,0 +1,16 @@
+/**
+ * Iterates every item currently in `set`, then clears it. Use it to drain a set of pending work
+ * accumulated since the last drain.
+ *
+ * @template T - The set item type.
+ * @param set - The set to drain and clear.
+ * @param visit - Called with each item before the set is cleared.
+ */
+const drain = (set, visit) => {
+    for (const item of set) {
+        visit(item);
+    }
+    set.clear();
+};
+export { drain };
+//# sourceMappingURL=drain.js.map

package/dist/set/drain.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"drain.js","sourceRoot":"","sources":["../../src/set/drain.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,KAAK,GAAG,CAAI,GAAW,EAAE,KAAwB,EAAQ,EAAE;IAC7D,KAAK,MAAM,IAAI,IAAI,GAAG,EAAE,CAAC;QACrB,KAAK,CAAC,IAAI,CAAC,CAAC;IAChB,CAAC;IAED,GAAG,CAAC,KAAK,EAAE,CAAC;AAChB,CAAC,CAAC;AAEF,OAAO,EAAE,KAAK,EAAE,CAAC","sourcesContent":["/**\n * Iterates every item currently in `set`, then clears it. Use it to drain a set of pending work\n * accumulated since the last drain.\n *\n * @template T - The set item type.\n * @param set - The set to drain and clear.\n * @param visit - Called with each item before the set is cleared.\n */\nconst drain = <T>(set: Set<T>, visit: (item: T) => void): void => {\n    for (const item of set) {\n        visit(item);\n    }\n\n    set.clear();\n};\n\nexport { drain };\n"]}

package/dist/set/index.d.ts

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

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

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

package/dist/set/index.js

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

package/dist/set/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/set/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC","sourcesContent":["export { drain } from \"./drain.js\";\n"]}

package/dist/source/index.d.ts

@@ -0,0 +1,4 @@
+export { sanitizeIdentifier } from "./sanitize-identifier.js";
+export { sourceStringLiteral } from "./source-string-literal.js";
+export { toCamelIdentifier } from "./to-camel-identifier.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/source/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/source/index.js

@@ -0,0 +1,4 @@
+export { sanitizeIdentifier } from "./sanitize-identifier.js";
+export { sourceStringLiteral } from "./source-string-literal.js";
+export { toCamelIdentifier } from "./to-camel-identifier.js";
+//# sourceMappingURL=index.js.map

package/dist/source/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/source/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC","sourcesContent":["export { sanitizeIdentifier } from \"./sanitize-identifier.js\";\nexport { sourceStringLiteral } from \"./source-string-literal.js\";\nexport { toCamelIdentifier } from \"./to-camel-identifier.js\";\n"]}

package/dist/source/sanitize-identifier.d.ts

@@ -0,0 +1,14 @@
+/**
+ * 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.
+ * @returns The name, suffixed with `_` when it is a reserved word.
+ *
+ * @example
+ * sanitizeIdentifier("iconName"); // "iconName"
+ * sanitizeIdentifier("class"); // "class_"
+ */
+declare function sanitizeIdentifier(name: string): string;
+export { sanitizeIdentifier };
+//# sourceMappingURL=sanitize-identifier.d.ts.map

package/dist/source/sanitize-identifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sanitize-identifier.d.ts","sourceRoot":"","sources":["../../src/source/sanitize-identifier.ts"],"names":[],"mappings":"AAkDA;;;;;;;;;;GAUG;AACH,iBAAS,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED,OAAO,EAAE,kBAAkB,EAAE,CAAC"}

package/dist/source/sanitize-identifier.js

@@ -0,0 +1,65 @@
+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.
+ * @returns The name, suffixed with `_` when it is a reserved word.
+ *
+ * @example
+ * sanitizeIdentifier("iconName"); // "iconName"
+ * sanitizeIdentifier("class"); // "class_"
+ */
+function sanitizeIdentifier(name) {
+    return RESERVED.has(name) ? `${name}_` : name;
+}
+export { sanitizeIdentifier };
+//# sourceMappingURL=sanitize-identifier.js.map

package/dist/source/sanitize-identifier.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sanitize-identifier.js","sourceRoot":"","sources":["../../src/source/sanitize-identifier.ts"],"names":[],"mappings":"AAAA,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;;;;;;;;;;GAUG;AACH,SAAS,kBAAkB,CAAC,IAAY;IACpC,OAAO,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;AAClD,CAAC;AAED,OAAO,EAAE,kBAAkB,EAAE,CAAC","sourcesContent":["const 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 * @returns The name, suffixed with `_` when it is a reserved word.\n *\n * @example\n * sanitizeIdentifier(\"iconName\"); // \"iconName\"\n * sanitizeIdentifier(\"class\"); // \"class_\"\n */\nfunction sanitizeIdentifier(name: string): string {\n    return RESERVED.has(name) ? `${name}_` : name;\n}\n\nexport { sanitizeIdentifier };\n"]}

package/dist/source/source-string-literal.d.ts

@@ -0,0 +1,13 @@
+/**
+ * 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.
+ * @returns The quoted, source-safe string literal.
+ *
+ * @example
+ * sourceStringLiteral("hello"); // '"hello"'
+ */
+declare function sourceStringLiteral(value: string): string;
+export { sourceStringLiteral };
+//# sourceMappingURL=source-string-literal.d.ts.map

package/dist/source/source-string-literal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-string-literal.d.ts","sourceRoot":"","sources":["../../src/source/source-string-literal.ts"],"names":[],"mappings":"AAYA;;;;;;;;;GASG;AACH,iBAAS,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAElD;AAED,OAAO,EAAE,mBAAmB,EAAE,CAAC"}

package/dist/source/source-string-literal.js

@@ -0,0 +1,24 @@
+const LINE_SEPARATOR = String.fromCodePoint(0x20_28);
+const PARAGRAPH_SEPARATOR = String.fromCodePoint(0x20_29);
+const SOURCE_ESCAPES = {
+    "<": String.raw `\u003C`,
+    ">": String.raw `\u003E`,
+    [LINE_SEPARATOR]: String.raw `\u2028`,
+    [PARAGRAPH_SEPARATOR]: String.raw `\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.
+ * @returns The quoted, source-safe string literal.
+ *
+ * @example
+ * sourceStringLiteral("hello"); // '"hello"'
+ */
+function sourceStringLiteral(value) {
+    return JSON.stringify(value).replaceAll(UNSAFE_SOURCE_CHARS, (char) => SOURCE_ESCAPES[char] ?? char);
+}
+export { sourceStringLiteral };
+//# sourceMappingURL=source-string-literal.js.map

package/dist/source/source-string-literal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-string-literal.js","sourceRoot":"","sources":["../../src/source/source-string-literal.ts"],"names":[],"mappings":"AAAA,MAAM,cAAc,GAAG,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;AACrD,MAAM,mBAAmB,GAAG,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;AAE1D,MAAM,cAAc,GAA2B;IAC3C,GAAG,EAAE,MAAM,CAAC,GAAG,CAAA,QAAQ;IACvB,GAAG,EAAE,MAAM,CAAC,GAAG,CAAA,QAAQ;IACvB,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC,GAAG,CAAA,QAAQ;IACpC,CAAC,mBAAmB,CAAC,EAAE,MAAM,CAAC,GAAG,CAAA,QAAQ;CAC5C,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;;;;;;;;;GASG;AACH,SAAS,mBAAmB,CAAC,KAAa;IACtC,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,UAAU,CAAC,mBAAmB,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,CAAC;AACzG,CAAC;AAED,OAAO,EAAE,mBAAmB,EAAE,CAAC","sourcesContent":["const LINE_SEPARATOR = String.fromCodePoint(0x20_28);\nconst PARAGRAPH_SEPARATOR = String.fromCodePoint(0x20_29);\n\nconst SOURCE_ESCAPES: Record<string, string> = {\n    \"<\": String.raw`\\u003C`,\n    \">\": String.raw`\\u003E`,\n    [LINE_SEPARATOR]: String.raw`\\u2028`,\n    [PARAGRAPH_SEPARATOR]: String.raw`\\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 * @returns The quoted, source-safe string literal.\n *\n * @example\n * sourceStringLiteral(\"hello\"); // '\"hello\"'\n */\nfunction sourceStringLiteral(value: string): string {\n    return JSON.stringify(value).replaceAll(UNSAFE_SOURCE_CHARS, (char) => SOURCE_ESCAPES[char] ?? char);\n}\n\nexport { sourceStringLiteral };\n"]}

package/dist/source/to-camel-identifier.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Converts a name to camel case and sanitizes it into a valid JavaScript identifier.
+ *
+ * @param name - The name to convert.
+ * @returns The camel-cased, reserved-word-safe identifier.
+ *
+ * @example
+ * toCamelIdentifier("icon_name"); // "iconName"
+ * toCamelIdentifier("class"); // "class_"
+ */
+declare function toCamelIdentifier(name: string): string;
+export { toCamelIdentifier };
+//# sourceMappingURL=to-camel-identifier.d.ts.map

package/dist/source/to-camel-identifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"to-camel-identifier.d.ts","sourceRoot":"","sources":["../../src/source/to-camel-identifier.ts"],"names":[],"mappings":"AAGA;;;;;;;;;GASG;AACH,iBAAS,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED,OAAO,EAAE,iBAAiB,EAAE,CAAC"}

package/dist/source/to-camel-identifier.js

@@ -0,0 +1,17 @@
+import { camelCase } from "../string/camel-case.js";
+import { sanitizeIdentifier } from "./sanitize-identifier.js";
+/**
+ * Converts a name to camel case and sanitizes it into a valid JavaScript identifier.
+ *
+ * @param name - The name to convert.
+ * @returns The camel-cased, reserved-word-safe identifier.
+ *
+ * @example
+ * toCamelIdentifier("icon_name"); // "iconName"
+ * toCamelIdentifier("class"); // "class_"
+ */
+function toCamelIdentifier(name) {
+    return sanitizeIdentifier(camelCase(name));
+}
+export { toCamelIdentifier };
+//# sourceMappingURL=to-camel-identifier.js.map

package/dist/source/to-camel-identifier.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"to-camel-identifier.js","sourceRoot":"","sources":["../../src/source/to-camel-identifier.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAE9D;;;;;;;;;GASG;AACH,SAAS,iBAAiB,CAAC,IAAY;IACnC,OAAO,kBAAkB,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;AAC/C,CAAC;AAED,OAAO,EAAE,iBAAiB,EAAE,CAAC","sourcesContent":["import { camelCase } from \"../string/camel-case.js\";\nimport { sanitizeIdentifier } from \"./sanitize-identifier.js\";\n\n/**\n * Converts a name to camel case and sanitizes it into a valid JavaScript identifier.\n *\n * @param name - The name to convert.\n * @returns The camel-cased, reserved-word-safe identifier.\n *\n * @example\n * toCamelIdentifier(\"icon_name\"); // \"iconName\"\n * toCamelIdentifier(\"class\"); // \"class_\"\n */\nfunction toCamelIdentifier(name: string): string {\n    return sanitizeIdentifier(camelCase(name));\n}\n\nexport { toCamelIdentifier };\n"]}

package/dist/string/camel-case.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Converts an underscore- or hyphen-delimited string to camel case.
+ *
+ * Unlike a general-purpose converter, this splits only on `_` and `-` and keeps the first segment
+ * verbatim, so GObject acronyms are preserved (`camelCase("GLArea")` stays `"GLArea"`).
+ *
+ * @param str - The string to convert.
+ * @returns The camel-cased string.
+ *
+ * @example
+ * camelCase("icon_name"); // "iconName"
+ * camelCase("start-widget"); // "startWidget"
+ * camelCase("Box"); // "Box"
+ */
+declare function camelCase(str: string): string;
+export { camelCase };
+//# sourceMappingURL=camel-case.d.ts.map

package/dist/string/camel-case.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"camel-case.d.ts","sourceRoot":"","sources":["../../src/string/camel-case.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;GAaG;AACH,iBAAS,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEtC;AAED,OAAO,EAAE,SAAS,EAAE,CAAC"}

package/dist/string/camel-case.js

@@ -0,0 +1,21 @@
+import { upperFirst } from "./upper-first.js";
+import { mapWordSegments } from "./word-segments.js";
+/**
+ * Converts an underscore- or hyphen-delimited string to camel case.
+ *
+ * Unlike a general-purpose converter, this splits only on `_` and `-` and keeps the first segment
+ * verbatim, so GObject acronyms are preserved (`camelCase("GLArea")` stays `"GLArea"`).
+ *
+ * @param str - The string to convert.
+ * @returns The camel-cased string.
+ *
+ * @example
+ * camelCase("icon_name"); // "iconName"
+ * camelCase("start-widget"); // "startWidget"
+ * camelCase("Box"); // "Box"
+ */
+function camelCase(str) {
+    return mapWordSegments(str, (part, index) => (index === 0 ? part : upperFirst(part)));
+}
+export { camelCase };
+//# sourceMappingURL=camel-case.js.map

package/dist/string/camel-case.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"camel-case.js","sourceRoot":"","sources":["../../src/string/camel-case.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAErD;;;;;;;;;;;;;GAaG;AACH,SAAS,SAAS,CAAC,GAAW;IAC1B,OAAO,eAAe,CAAC,GAAG,EAAE,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;AAC1F,CAAC;AAED,OAAO,EAAE,SAAS,EAAE,CAAC","sourcesContent":["import { upperFirst } from \"./upper-first.js\";\nimport { mapWordSegments } from \"./word-segments.js\";\n\n/**\n * Converts an underscore- or hyphen-delimited string to camel case.\n *\n * Unlike a general-purpose converter, this splits only on `_` and `-` and keeps the first segment\n * verbatim, so GObject acronyms are preserved (`camelCase(\"GLArea\")` stays `\"GLArea\"`).\n *\n * @param str - The string to convert.\n * @returns The camel-cased string.\n *\n * @example\n * camelCase(\"icon_name\"); // \"iconName\"\n * camelCase(\"start-widget\"); // \"startWidget\"\n * camelCase(\"Box\"); // \"Box\"\n */\nfunction camelCase(str: string): string {\n    return mapWordSegments(str, (part, index) => (index === 0 ? part : upperFirst(part)));\n}\n\nexport { camelCase };\n"]}

package/dist/string/index.d.ts

@@ -0,0 +1,6 @@
+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";
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/string/index.js

@@ -0,0 +1,6 @@
+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";
+//# sourceMappingURL=index.js.map

package/dist/string/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/string/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC","sourcesContent":["export { camelCase } from \"./camel-case.js\";\nexport { kebabCase } from \"./kebab-case.js\";\nexport { lowerFirst } from \"./lower-first.js\";\nexport { pascalCase } from \"./pascal-case.js\";\nexport { upperFirst } from \"./upper-first.js\";\n"]}

package/dist/string/kebab-case.d.ts

@@ -0,0 +1,14 @@
+/**
+ * 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"
+ */
+declare function kebabCase(str: string): string;
+export { kebabCase };
+//# sourceMappingURL=kebab-case.d.ts.map

package/dist/string/kebab-case.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kebab-case.d.ts","sourceRoot":"","sources":["../../src/string/kebab-case.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,iBAAS,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAItC;AAED,OAAO,EAAE,SAAS,EAAE,CAAC"}

package/dist/string/kebab-case.js

@@ -0,0 +1,16 @@
+/**
+ * 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) {
+    return str.replaceAll(/[A-Z]/g, (char, index) => index === 0 ? char.toLowerCase() : `-${char.toLowerCase()}`);
+}
+export { kebabCase };
+//# sourceMappingURL=kebab-case.js.map

package/dist/string/kebab-case.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"kebab-case.js","sourceRoot":"","sources":["../../src/string/kebab-case.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,SAAS,SAAS,CAAC,GAAW;IAC1B,OAAO,GAAG,CAAC,UAAU,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,KAAa,EAAE,EAAE,CACpD,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,WAAW,EAAE,EAAE,CAC9D,CAAC;AACN,CAAC;AAED,OAAO,EAAE,SAAS,EAAE,CAAC","sourcesContent":["/**\n * Converts a camelCase or PascalCase string to kebab case by lower-casing uppercase letters and\n * inserting hyphens before interior ones.\n *\n * @param str - The string to convert.\n * @returns The kebab-cased string.\n *\n * @example\n * kebabCase(\"iconName\"); // \"icon-name\"\n * kebabCase(\"Title\"); // \"title\"\n */\nfunction kebabCase(str: string): string {\n    return str.replaceAll(/[A-Z]/g, (char, index: number) =>\n        index === 0 ? char.toLowerCase() : `-${char.toLowerCase()}`,\n    );\n}\n\nexport { kebabCase };\n"]}

package/dist/string/lower-first.d.ts

@@ -0,0 +1,13 @@
+/**
+ * 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"
+ */
+declare function lowerFirst(str: string): string;
+export { lowerFirst };
+//# sourceMappingURL=lower-first.d.ts.map

package/dist/string/lower-first.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lower-first.d.ts","sourceRoot":"","sources":["../../src/string/lower-first.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,iBAAS,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEvC;AAED,OAAO,EAAE,UAAU,EAAE,CAAC"}

package/dist/string/lower-first.js

@@ -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) {
+    return str.charAt(0).toLowerCase() + str.slice(1);
+}
+export { lowerFirst };
+//# sourceMappingURL=lower-first.js.map

package/dist/string/lower-first.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lower-first.js","sourceRoot":"","sources":["../../src/string/lower-first.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,SAAS,UAAU,CAAC,GAAW;IAC3B,OAAO,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AACtD,CAAC;AAED,OAAO,EAAE,UAAU,EAAE,CAAC","sourcesContent":["/**\n * Converts the first character of a string to lower case.\n *\n * @param str - The string to transform.\n * @returns The string with its first character lower-cased.\n *\n * @example\n * lowerFirst(\"Fred\"); // \"fred\"\n * lowerFirst(\"FRED\"); // \"fRED\"\n */\nfunction lowerFirst(str: string): string {\n    return str.charAt(0).toLowerCase() + str.slice(1);\n}\n\nexport { lowerFirst };\n"]}