@gtkx/utils 1.0.0-rc.4 → 1.0.0

package/README.md

@@ -108,7 +108,7 @@ React Native and similar frameworks hide the native toolkit so one API can run e
 
 ### Why Node.js, and why generated bindings
 
-GTKX runs on Node.js, which puts native modules, the npm ecosystem, and the tooling built for Node.js APIs within reach. GJS is GNOME's own runtime, built on SpiderMonkey rather than V8; node-gtk runs on Node.js but is lightly maintained, on the older nan/V8 ABI rather than N-API, and still centered on GTK3. The [Why GTKX guide](https://gtkx.dev/guide/why-gtkx) covers the comparison in full.
+GTKX runs on Node.js, which puts native modules, the npm ecosystem, and the tooling built for Node.js APIs within reach. GJS is GNOME's own runtime, built on SpiderMonkey rather than V8; node-gtk runs on Node.js but is lightly maintained, on the older nan/V8 ABI rather than N-API, and still centered on GTK3. The [Why GTKX guide](https://gtkx.dev/guide/why-gtkx) covers what running on Node.js means day to day.
 
 GTKX generates the TypeScript types and the native FFI calls from the same GObject-Introspection data, so the types cannot drift from the calls they back. Codegen covers the whole GTK4 and Adwaita surface.
 
@@ -121,10 +121,10 @@ GTKX is Linux-only and needs Node.js 24 or later. See [Requirements](#requiremen
 Scaffold a new app with the `create-gtkx` initializer:
 
 ```sh
-npm create gtkx@rc
+npm create gtkx
 ```
 
-The same command works with other package managers: `pnpm create gtkx@rc` or `yarn create gtkx@rc`.
+The same command works with other package managers: `pnpm create gtkx` or `yarn create gtkx`.
 
 Then run your new app:
 
@@ -145,7 +145,7 @@ The documentation at **[gtkx.dev](https://gtkx.dev)** includes a step-by-step tu
 
 GTKX is Linux-only. You need:
 
-- Linux with the GTK4 (4.20 or later), Adwaita (1.8 or later), and GLib development libraries
+- Linux with the GTK4 (4.20 or later) and GLib development libraries, plus Adwaita (1.8 or later) once your project binds `Adw-1`
 - Node.js 24 or later
 
 The `@gtkx/native` addon ships prebuilt for x64 and arm64 glibc Linux; other targets need to build it from the GTKX repository, which requires a Rust toolchain.
@@ -161,7 +161,7 @@ Explore the [example apps](https://github.com/gtkx-org/gtkx/tree/main/examples):
 
 ## Status
 
-GTKX 1.0 is at the release candidate stage.
+GTKX 1.0 is released.
 
 ## Contributing
 

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

@@ -1,4 +1,6 @@
+/** Any class constructor, abstract ones included, whose instances are `T`. */
 type AnyClass<T extends object = object> = (abstract new (...args: never[]) => T) & {
+    /** Object the class's instances inherit from. */
     prototype: T;
 };
 export { type AnyClass };

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

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

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

@@ -1 +1 @@
-{"version":3,"file":"any-class.js","sourceRoot":"","sources":["../../src/class/any-class.ts"],"names":[],"mappings":"AAMA,OAAO,EAAiB,CAAC","sourcesContent":["type AnyClass<T extends object = object> = (abstract new (\n    ...args: never[]\n) => T) & {\n    prototype: T;\n};\n\nexport { type AnyClass };\n"]}
+{"version":3,"file":"any-class.js","sourceRoot":"","sources":["../../src/class/any-class.ts"],"names":[],"mappings":"AAQA,OAAO,EAAiB,CAAC","sourcesContent":["/** Any class constructor, abstract ones included, whose instances are `T`. */\ntype AnyClass<T extends object = object> = (abstract new (\n    ...args: never[]\n) => T) & {\n    /** Object the class's instances inherit from. */\n    prototype: T;\n};\n\nexport { type AnyClass };\n"]}

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

@@ -4,5 +4,5 @@ type GetSet<K, V> = {
     has(key: K): boolean;
 };
 declare function getOrInsert<K, V>(map: GetSet<K, V>, key: K, factory: (key: K) => V): V;
-export { getOrInsert, type GetSet };
+export { getOrInsert };
 //# sourceMappingURL=get-or-insert.d.ts.map

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

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

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

@@ -1 +1 @@
-{"version":3,"file":"get-or-insert.js","sourceRoot":"","sources":["../../src/map/get-or-insert.ts"],"names":[],"mappings":"AAMA,SAAS,WAAW,CAAO,GAAiB,EAAE,GAAM,EAAE,OAAsB;IACxE,IAAI,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;QACf,OAAO,GAAG,CAAC,GAAG,CAAC,GAAG,CAAM,CAAC;IAC7B,CAAC;IAED,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IAC3B,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAEpB,OAAO,KAAK,CAAC;AACjB,CAAC;AAED,OAAO,EAAE,WAAW,EAAe,CAAC","sourcesContent":["type GetSet<K, V> = {\n    get(key: K): V | undefined;\n    set(key: K, value: V): unknown;\n    has(key: K): boolean;\n};\n\nfunction getOrInsert<K, V>(map: GetSet<K, V>, key: K, factory: (key: K) => V): V {\n    if (map.has(key)) {\n        return map.get(key) as V;\n    }\n\n    const value = factory(key);\n    map.set(key, value);\n\n    return value;\n}\n\nexport { getOrInsert, type GetSet };\n"]}
+{"version":3,"file":"get-or-insert.js","sourceRoot":"","sources":["../../src/map/get-or-insert.ts"],"names":[],"mappings":"AAMA,SAAS,WAAW,CAAO,GAAiB,EAAE,GAAM,EAAE,OAAsB;IACxE,IAAI,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;QACf,OAAO,GAAG,CAAC,GAAG,CAAC,GAAG,CAAM,CAAC;IAC7B,CAAC;IAED,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IAC3B,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAEpB,OAAO,KAAK,CAAC;AACjB,CAAC;AAED,OAAO,EAAE,WAAW,EAAE,CAAC","sourcesContent":["type GetSet<K, V> = {\n    get(key: K): V | undefined;\n    set(key: K, value: V): unknown;\n    has(key: K): boolean;\n};\n\nfunction getOrInsert<K, V>(map: GetSet<K, V>, key: K, factory: (key: K) => V): V {\n    if (map.has(key)) {\n        return map.get(key) as V;\n    }\n\n    const value = factory(key);\n    map.set(key, value);\n\n    return value;\n}\n\nexport { getOrInsert };\n"]}

package/dist/process/index.d.ts

@@ -1,4 +1,5 @@
 export { exitCodeForSignal } from "./exit-code-for-signal.ts";
 export { installGracefulShutdown } from "./install-graceful-shutdown.ts";
-export { resolveExecutable } from "./resolve-executable.ts";
+export { resolveExecutable, tryResolveExecutable } from "./resolve-executable.ts";
+export { spawnWithParentDeathSignal } from "./spawn-with-parent-death-signal.ts";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/process/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AACzE,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/process/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AACzE,OAAO,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAClF,OAAO,EAAE,0BAA0B,EAAE,MAAM,qCAAqC,CAAC"}

package/dist/process/index.js

@@ -1,4 +1,5 @@
 export { exitCodeForSignal } from "./exit-code-for-signal.js";
 export { installGracefulShutdown } from "./install-graceful-shutdown.js";
-export { resolveExecutable } from "./resolve-executable.js";
+export { resolveExecutable, tryResolveExecutable } from "./resolve-executable.js";
+export { spawnWithParentDeathSignal } from "./spawn-with-parent-death-signal.js";
 //# sourceMappingURL=index.js.map

package/dist/process/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/process/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AACzE,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC","sourcesContent":["export { exitCodeForSignal } from \"./exit-code-for-signal.ts\";\nexport { installGracefulShutdown } from \"./install-graceful-shutdown.ts\";\nexport { resolveExecutable } from \"./resolve-executable.ts\";\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/process/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AACzE,OAAO,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAClF,OAAO,EAAE,0BAA0B,EAAE,MAAM,qCAAqC,CAAC","sourcesContent":["export { exitCodeForSignal } from \"./exit-code-for-signal.ts\";\nexport { installGracefulShutdown } from \"./install-graceful-shutdown.ts\";\nexport { resolveExecutable, tryResolveExecutable } from \"./resolve-executable.ts\";\nexport { spawnWithParentDeathSignal } from \"./spawn-with-parent-death-signal.ts\";\n"]}

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

@@ -6,5 +6,5 @@ type GracefulShutdownOptions = {
     exitCode?: (signal: NodeJS.Signals, isGraceful: boolean) => number;
 };
 declare function installGracefulShutdown(options: GracefulShutdownOptions): void;
-export { installGracefulShutdown, type GracefulShutdownOptions };
+export { installGracefulShutdown };
 //# sourceMappingURL=install-graceful-shutdown.d.ts.map

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

@@ -1 +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,iBAAS,uBAAuB,CAAC,OAAO,EAAE,uBAAuB,GAAG,IAAI,CAiBvE;AAED,OAAO,EAAE,uBAAuB,EAAE,KAAK,uBAAuB,EAAE,CAAC"}
+{"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,iBAAS,uBAAuB,CAAC,OAAO,EAAE,uBAAuB,GAAG,IAAI,CAiBvE;AAED,OAAO,EAAE,uBAAuB,EAAE,CAAC"}

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

@@ -1 +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.ts\";\nimport { exitCodeForSignal } from \"./exit-code-for-signal.ts\";\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    hasExited: boolean;\n    isCoalescing: 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.hasExited) {\n        return;\n    }\n\n    state.hasExited = 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.isCoalescing = true;\n\n        state.coalesceTimer = setTimeout(() => {\n            state.isCoalescing = 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.isCoalescing) {\n        return;\n    }\n\n    state.options.onForce?.();\n    finish(state, signal, false);\n};\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        hasExited: false,\n        isCoalescing: 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"]}
+{"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.ts\";\nimport { exitCodeForSignal } from \"./exit-code-for-signal.ts\";\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    hasExited: boolean;\n    isCoalescing: 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.hasExited) {\n        return;\n    }\n\n    state.hasExited = 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.isCoalescing = true;\n\n        state.coalesceTimer = setTimeout(() => {\n            state.isCoalescing = 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.isCoalescing) {\n        return;\n    }\n\n    state.options.onForce?.();\n    finish(state, signal, false);\n};\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        hasExited: false,\n        isCoalescing: 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 };\n"]}

package/dist/process/kill-marked-processes.d.ts

@@ -0,0 +1,4 @@
+declare const PROCESS_MARKER = "GTKX_PROCESS_GUARD";
+declare function killMarkedProcesses(prefix: string): void;
+export { PROCESS_MARKER, killMarkedProcesses };
+//# sourceMappingURL=kill-marked-processes.d.ts.map

package/dist/process/kill-marked-processes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kill-marked-processes.d.ts","sourceRoot":"","sources":["../../src/process/kill-marked-processes.ts"],"names":[],"mappings":"AAEA,QAAA,MAAM,cAAc,uBAAuB,CAAC;AA2B5C,iBAAS,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAYjD;AAED,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,CAAC"}

package/dist/process/kill-marked-processes.js

@@ -0,0 +1,38 @@
+import { readdirSync, readFileSync } from "node:fs";
+const PROCESS_MARKER = "GTKX_PROCESS_GUARD";
+const MAX_KILL_PASSES = 8;
+const isMarked = (pid, prefix) => {
+    try {
+        return readFileSync(`/proc/${String(pid)}/environ`, "utf8")
+            .split("\0")
+            .some((assignment) => assignment.startsWith(prefix));
+    }
+    catch {
+        return false;
+    }
+};
+const markedPids = (prefix) => readdirSync("/proc")
+    .map(Number)
+    .filter((pid) => Number.isSafeInteger(pid) && pid > 1 && pid !== process.pid)
+    .filter((pid) => isMarked(pid, prefix));
+const killPid = (pid) => {
+    try {
+        process.kill(pid, "SIGKILL");
+    }
+    catch {
+        return;
+    }
+};
+function killMarkedProcesses(prefix) {
+    for (let pass = 0; pass < MAX_KILL_PASSES; pass += 1) {
+        const pids = markedPids(prefix);
+        if (pids.length === 0) {
+            return;
+        }
+        for (const pid of pids) {
+            killPid(pid);
+        }
+    }
+}
+export { PROCESS_MARKER, killMarkedProcesses };
+//# sourceMappingURL=kill-marked-processes.js.map

package/dist/process/kill-marked-processes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"kill-marked-processes.js","sourceRoot":"","sources":["../../src/process/kill-marked-processes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEpD,MAAM,cAAc,GAAG,oBAAoB,CAAC;AAC5C,MAAM,eAAe,GAAG,CAAC,CAAC;AAE1B,MAAM,QAAQ,GAAG,CAAC,GAAW,EAAE,MAAc,EAAW,EAAE;IACtD,IAAI,CAAC;QACD,OAAO,YAAY,CAAC,SAAS,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,MAAM,CAAC;aACtD,KAAK,CAAC,IAAI,CAAC;aACX,IAAI,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;IAC7D,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,KAAK,CAAC;IACjB,CAAC;AACL,CAAC,CAAC;AAEF,MAAM,UAAU,GAAG,CAAC,MAAc,EAAY,EAAE,CAC5C,WAAW,CAAC,OAAO,CAAC;KACf,GAAG,CAAC,MAAM,CAAC;KACX,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,MAAM,CAAC,aAAa,CAAC,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC,IAAI,GAAG,KAAK,OAAO,CAAC,GAAG,CAAC;KAC5E,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC;AAEhD,MAAM,OAAO,GAAG,CAAC,GAAW,EAAQ,EAAE;IAClC,IAAI,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;IACjC,CAAC;IAAC,MAAM,CAAC;QACL,OAAO;IACX,CAAC;AACL,CAAC,CAAC;AAEF,SAAS,mBAAmB,CAAC,MAAc;IACvC,KAAK,IAAI,IAAI,GAAG,CAAC,EAAE,IAAI,GAAG,eAAe,EAAE,IAAI,IAAI,CAAC,EAAE,CAAC;QACnD,MAAM,IAAI,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC;QAEhC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACpB,OAAO;QACX,CAAC;QAED,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACrB,OAAO,CAAC,GAAG,CAAC,CAAC;QACjB,CAAC;IACL,CAAC;AACL,CAAC;AAED,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,CAAC","sourcesContent":["import { readdirSync, readFileSync } from \"node:fs\";\n\nconst PROCESS_MARKER = \"GTKX_PROCESS_GUARD\";\nconst MAX_KILL_PASSES = 8;\n\nconst isMarked = (pid: number, prefix: string): boolean => {\n    try {\n        return readFileSync(`/proc/${String(pid)}/environ`, \"utf8\")\n            .split(\"\\0\")\n            .some((assignment) => assignment.startsWith(prefix));\n    } catch {\n        return false;\n    }\n};\n\nconst markedPids = (prefix: string): number[] =>\n    readdirSync(\"/proc\")\n        .map(Number)\n        .filter((pid) => Number.isSafeInteger(pid) && pid > 1 && pid !== process.pid)\n        .filter((pid) => isMarked(pid, prefix));\n\nconst killPid = (pid: number): void => {\n    try {\n        process.kill(pid, \"SIGKILL\");\n    } catch {\n        return;\n    }\n};\n\nfunction killMarkedProcesses(prefix: string): void {\n    for (let pass = 0; pass < MAX_KILL_PASSES; pass += 1) {\n        const pids = markedPids(prefix);\n\n        if (pids.length === 0) {\n            return;\n        }\n\n        for (const pid of pids) {\n            killPid(pid);\n        }\n    }\n}\n\nexport { PROCESS_MARKER, killMarkedProcesses };\n"]}

package/dist/process/process-guard.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=process-guard.d.ts.map

package/dist/process/process-guard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-guard.d.ts","sourceRoot":"","sources":["../../src/process/process-guard.ts"],"names":[],"mappings":""}

package/dist/process/process-guard.js

@@ -0,0 +1,16 @@
+import { killMarkedProcesses } from "./kill-marked-processes.js";
+const GUARD_PREFIX = process.argv[2] ?? "";
+const WATCHED_SIGNALS = ["SIGTERM", "SIGINT", "SIGHUP"];
+const sweep = () => {
+    if (GUARD_PREFIX.length > 0) {
+        killMarkedProcesses(GUARD_PREFIX);
+    }
+    process.exit(0);
+};
+process.stdin.resume();
+process.stdin.on("end", sweep);
+process.stdin.on("error", sweep);
+for (const signal of WATCHED_SIGNALS) {
+    process.on(signal, sweep);
+}
+//# sourceMappingURL=process-guard.js.map

package/dist/process/process-guard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-guard.js","sourceRoot":"","sources":["../../src/process/process-guard.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAEjE,MAAM,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;AAC3C,MAAM,eAAe,GAAG,CAAC,SAAS,EAAE,QAAQ,EAAE,QAAQ,CAAqC,CAAC;AAE5F,MAAM,KAAK,GAAG,GAAS,EAAE;IACrB,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1B,mBAAmB,CAAC,YAAY,CAAC,CAAC;IACtC,CAAC;IAED,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AACpB,CAAC,CAAC;AAEF,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;AACvB,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;AAC/B,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;AAEjC,KAAK,MAAM,MAAM,IAAI,eAAe,EAAE,CAAC;IACnC,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;AAC9B,CAAC","sourcesContent":["import { killMarkedProcesses } from \"./kill-marked-processes.ts\";\n\nconst GUARD_PREFIX = process.argv[2] ?? \"\";\nconst WATCHED_SIGNALS = [\"SIGTERM\", \"SIGINT\", \"SIGHUP\"] as const satisfies NodeJS.Signals[];\n\nconst sweep = (): void => {\n    if (GUARD_PREFIX.length > 0) {\n        killMarkedProcesses(GUARD_PREFIX);\n    }\n\n    process.exit(0);\n};\n\nprocess.stdin.resume();\nprocess.stdin.on(\"end\", sweep);\nprocess.stdin.on(\"error\", sweep);\n\nfor (const signal of WATCHED_SIGNALS) {\n    process.on(signal, sweep);\n}\n"]}

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

@@ -1,3 +1,4 @@
+declare function tryResolveExecutable(command: string): string | undefined;
 declare function resolveExecutable(command: string): string;
-export { resolveExecutable };
+export { resolveExecutable, tryResolveExecutable };
 //# sourceMappingURL=resolve-executable.d.ts.map

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

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

package/dist/process/resolve-executable.js

@@ -19,18 +19,21 @@ const findOnPath = (command) => {
     }
     return undefined;
 };
-function resolveExecutable(command) {
+function tryResolveExecutable(command) {
     if (isAbsolute(command)) {
         return command;
     }
     if (command.includes("/")) {
         return resolve(command);
     }
-    const found = findOnPath(command);
+    return findOnPath(command);
+}
+function resolveExecutable(command) {
+    const found = tryResolveExecutable(command);
     if (found === undefined) {
         throw new Error(`Cannot find the "${command}" executable on PATH`);
     }
     return found;
 }
-export { resolveExecutable };
+export { resolveExecutable, tryResolveExecutable };
 //# sourceMappingURL=resolve-executable.js.map

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

@@ -1 +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,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\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"]}
+{"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,SAAS,oBAAoB,CAAC,OAAe;IACzC,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,OAAO,UAAU,CAAC,OAAO,CAAC,CAAC;AAC/B,CAAC;AAED,SAAS,iBAAiB,CAAC,OAAe;IACtC,MAAM,KAAK,GAAG,oBAAoB,CAAC,OAAO,CAAC,CAAC;IAE5C,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,oBAAoB,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\nfunction tryResolveExecutable(command: string): string | undefined {\n    if (isAbsolute(command)) {\n        return command;\n    }\n\n    if (command.includes(\"/\")) {\n        return resolve(command);\n    }\n\n    return findOnPath(command);\n}\n\nfunction resolveExecutable(command: string): string {\n    const found = tryResolveExecutable(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, tryResolveExecutable };\n"]}

package/dist/process/spawn-with-parent-death-signal.d.ts

@@ -0,0 +1,8 @@
+import { type ChildProcess, type StdioOptions } from "node:child_process";
+type ParentDeathSpawnOptions = {
+    stdio?: StdioOptions;
+    env?: NodeJS.ProcessEnv;
+};
+declare function spawnWithParentDeathSignal(command: string, args: string[], options?: ParentDeathSpawnOptions): ChildProcess;
+export { spawnWithParentDeathSignal };
+//# sourceMappingURL=spawn-with-parent-death-signal.d.ts.map

package/dist/process/spawn-with-parent-death-signal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spawn-with-parent-death-signal.d.ts","sourceRoot":"","sources":["../../src/process/spawn-with-parent-death-signal.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,YAAY,EAAS,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAQjF,KAAK,uBAAuB,GAAG;IAC3B,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CAC3B,CAAC;AAuCF,iBAAS,0BAA0B,CAC/B,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,GAAE,uBAA4B,GACtC,YAAY,CAiBd;AAED,OAAO,EAAE,0BAA0B,EAAE,CAAC"}

package/dist/process/spawn-with-parent-death-signal.js

@@ -0,0 +1,50 @@
+import { spawn } from "node:child_process";
+import { randomBytes } from "node:crypto";
+import { Socket } from "node:net";
+import { dirname, extname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+import { killMarkedProcesses, PROCESS_MARKER } from "./kill-marked-processes.js";
+import { resolveExecutable } from "./resolve-executable.js";
+const MODULE_PATH = fileURLToPath(import.meta.url);
+const GUARD_PATH = join(dirname(MODULE_PATH), `process-guard${extname(MODULE_PATH)}`);
+const RUN_ID = randomBytes(8).toString("hex");
+const RUN_PREFIX = `${PROCESS_MARKER}=${RUN_ID}/`;
+const guard = {};
+const releaseGuard = (child) => {
+    child.unref();
+    const { stdin } = child;
+    if (stdin instanceof Socket) {
+        stdin.unref();
+    }
+};
+const startGuard = () => {
+    if (guard.child) {
+        return;
+    }
+    const child = spawn(process.execPath, [GUARD_PATH, RUN_PREFIX], {
+        detached: true,
+        stdio: ["pipe", "ignore", "ignore"],
+    });
+    child.on("error", () => {
+        guard.child = undefined;
+    });
+    guard.child = child;
+    releaseGuard(child);
+};
+function spawnWithParentDeathSignal(command, args, options = {}) {
+    const executable = resolveExecutable(command);
+    const setpriv = resolveExecutable("setpriv");
+    const jobValue = `${RUN_ID}/${randomBytes(4).toString("hex")}`;
+    startGuard();
+    const child = spawn(setpriv, ["--pdeathsig", "SIGKILL", executable, ...args], {
+        detached: true,
+        stdio: options.stdio ?? "ignore",
+        env: { ...(options.env ?? process.env), [PROCESS_MARKER]: jobValue },
+    });
+    child.on("exit", () => {
+        killMarkedProcesses(`${PROCESS_MARKER}=${jobValue}`);
+    });
+    return child;
+}
+export { spawnWithParentDeathSignal };
+//# sourceMappingURL=spawn-with-parent-death-signal.js.map

package/dist/process/spawn-with-parent-death-signal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spawn-with-parent-death-signal.js","sourceRoot":"","sources":["../../src/process/spawn-with-parent-death-signal.ts"],"names":[],"mappings":"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","sourcesContent":["import { type ChildProcess, spawn, type StdioOptions } from \"node:child_process\";\nimport { randomBytes } from \"node:crypto\";\nimport { Socket } from \"node:net\";\nimport { dirname, extname, join } from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\nimport { killMarkedProcesses, PROCESS_MARKER } from \"./kill-marked-processes.ts\";\nimport { resolveExecutable } from \"./resolve-executable.ts\";\n\ntype ParentDeathSpawnOptions = {\n    stdio?: StdioOptions;\n    env?: NodeJS.ProcessEnv;\n};\n\ntype GuardState = {\n    child?: ChildProcess | undefined;\n};\n\nconst MODULE_PATH = fileURLToPath(import.meta.url);\nconst GUARD_PATH = join(dirname(MODULE_PATH), `process-guard${extname(MODULE_PATH)}`);\nconst RUN_ID = randomBytes(8).toString(\"hex\");\nconst RUN_PREFIX = `${PROCESS_MARKER}=${RUN_ID}/`;\nconst guard: GuardState = {};\n\nconst releaseGuard = (child: ChildProcess): void => {\n    child.unref();\n    const { stdin } = child;\n\n    if (stdin instanceof Socket) {\n        stdin.unref();\n    }\n};\n\nconst startGuard = (): void => {\n    if (guard.child) {\n        return;\n    }\n\n    const child = spawn(process.execPath, [GUARD_PATH, RUN_PREFIX], {\n        detached: true,\n        stdio: [\"pipe\", \"ignore\", \"ignore\"],\n    });\n\n    child.on(\"error\", () => {\n        guard.child = undefined;\n    });\n\n    guard.child = child;\n    releaseGuard(child);\n};\n\nfunction spawnWithParentDeathSignal(\n    command: string,\n    args: string[],\n    options: ParentDeathSpawnOptions = {},\n): ChildProcess {\n    const executable = resolveExecutable(command);\n    const setpriv = resolveExecutable(\"setpriv\");\n    const jobValue = `${RUN_ID}/${randomBytes(4).toString(\"hex\")}`;\n    startGuard();\n\n    const child = spawn(setpriv, [\"--pdeathsig\", \"SIGKILL\", executable, ...args], {\n        detached: true,\n        stdio: options.stdio ?? \"ignore\",\n        env: { ...(options.env ?? process.env), [PROCESS_MARKER]: jobValue },\n    });\n\n    child.on(\"exit\", () => {\n        killMarkedProcesses(`${PROCESS_MARKER}=${jobValue}`);\n    });\n\n    return child;\n}\n\nexport { spawnWithParentDeathSignal };\n"]}

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

@@ -1,3 +1,3 @@
-declare function packageVersion(importMetaUrl: string): string;
+declare function packageVersion(importMetaUrl: string, specifier: string): string;
 export { packageVersion };
 //# sourceMappingURL=package-version.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"package-version.d.ts","sourceRoot":"","sources":["../../src/util/package-version.ts"],"names":[],"mappings":"AAEA,iBAAS,cAAc,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAErD;AAED,OAAO,EAAE,cAAc,EAAE,CAAC"}
+{"version":3,"file":"package-version.d.ts","sourceRoot":"","sources":["../../src/util/package-version.ts"],"names":[],"mappings":"AAEA,iBAAS,cAAc,CAAC,aAAa,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAExE;AAED,OAAO,EAAE,cAAc,EAAE,CAAC"}

package/dist/util/package-version.js

@@ -1,6 +1,6 @@
 import { createRequire } from "node:module";
-function packageVersion(importMetaUrl) {
-    return createRequire(importMetaUrl)("../package.json").version;
+function packageVersion(importMetaUrl, specifier) {
+    return createRequire(importMetaUrl)(specifier).version;
 }
 export { packageVersion };
 //# sourceMappingURL=package-version.js.map

package/dist/util/package-version.js.map

@@ -1 +1 @@
-{"version":3,"file":"package-version.js","sourceRoot":"","sources":["../../src/util/package-version.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,SAAS,cAAc,CAAC,aAAqB;IACzC,OAAQ,aAAa,CAAC,aAAa,CAAC,CAAC,iBAAiB,CAAyB,CAAC,OAAO,CAAC;AAC5F,CAAC;AAED,OAAO,EAAE,cAAc,EAAE,CAAC","sourcesContent":["import { createRequire } from \"node:module\";\n\nfunction packageVersion(importMetaUrl: string): string {\n    return (createRequire(importMetaUrl)(\"../package.json\") as { version: string }).version;\n}\n\nexport { packageVersion };\n"]}
+{"version":3,"file":"package-version.js","sourceRoot":"","sources":["../../src/util/package-version.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,SAAS,cAAc,CAAC,aAAqB,EAAE,SAAiB;IAC5D,OAAQ,aAAa,CAAC,aAAa,CAAC,CAAC,SAAS,CAAyB,CAAC,OAAO,CAAC;AACpF,CAAC;AAED,OAAO,EAAE,cAAc,EAAE,CAAC","sourcesContent":["import { createRequire } from \"node:module\";\n\nfunction packageVersion(importMetaUrl: string, specifier: string): string {\n    return (createRequire(importMetaUrl)(specifier) as { version: string }).version;\n}\n\nexport { packageVersion };\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gtkx/utils",
-  "version": "1.0.0-rc.4",
+  "version": "1.0.0",
   "description": "Cross-package utilities shared by the GTKX packages and toolchain: logging, error formatting, string and class helpers",
   "keywords": [
     "gtkx",

package/src/class/any-class.ts

@@ -1,6 +1,8 @@
+/** Any class constructor, abstract ones included, whose instances are `T`. */
 type AnyClass<T extends object = object> = (abstract new (
     ...args: never[]
 ) => T) & {
+    /** Object the class's instances inherit from. */
     prototype: T;
 };
 

package/src/map/get-or-insert.ts

@@ -15,4 +15,4 @@ function getOrInsert<K, V>(map: GetSet<K, V>, key: K, factory: (key: K) => V): V
     return value;
 }
 
-export { getOrInsert, type GetSet };
+export { getOrInsert };

package/src/process/index.ts

@@ -1,3 +1,4 @@
 export { exitCodeForSignal } from "./exit-code-for-signal.ts";
 export { installGracefulShutdown } from "./install-graceful-shutdown.ts";
-export { resolveExecutable } from "./resolve-executable.ts";
+export { resolveExecutable, tryResolveExecutable } from "./resolve-executable.ts";
+export { spawnWithParentDeathSignal } from "./spawn-with-parent-death-signal.ts";

package/src/process/install-graceful-shutdown.ts

@@ -117,4 +117,4 @@ function installGracefulShutdown(options: GracefulShutdownOptions): void {
     }
 }
 
-export { installGracefulShutdown, type GracefulShutdownOptions };
+export { installGracefulShutdown };

package/src/process/kill-marked-processes.ts

@@ -0,0 +1,44 @@
+import { readdirSync, readFileSync } from "node:fs";
+
+const PROCESS_MARKER = "GTKX_PROCESS_GUARD";
+const MAX_KILL_PASSES = 8;
+
+const isMarked = (pid: number, prefix: string): boolean => {
+    try {
+        return readFileSync(`/proc/${String(pid)}/environ`, "utf8")
+            .split("\0")
+            .some((assignment) => assignment.startsWith(prefix));
+    } catch {
+        return false;
+    }
+};
+
+const markedPids = (prefix: string): number[] =>
+    readdirSync("/proc")
+        .map(Number)
+        .filter((pid) => Number.isSafeInteger(pid) && pid > 1 && pid !== process.pid)
+        .filter((pid) => isMarked(pid, prefix));
+
+const killPid = (pid: number): void => {
+    try {
+        process.kill(pid, "SIGKILL");
+    } catch {
+        return;
+    }
+};
+
+function killMarkedProcesses(prefix: string): void {
+    for (let pass = 0; pass < MAX_KILL_PASSES; pass += 1) {
+        const pids = markedPids(prefix);
+
+        if (pids.length === 0) {
+            return;
+        }
+
+        for (const pid of pids) {
+            killPid(pid);
+        }
+    }
+}
+
+export { PROCESS_MARKER, killMarkedProcesses };

package/src/process/process-guard.ts

@@ -0,0 +1,20 @@
+import { killMarkedProcesses } from "./kill-marked-processes.ts";
+
+const GUARD_PREFIX = process.argv[2] ?? "";
+const WATCHED_SIGNALS = ["SIGTERM", "SIGINT", "SIGHUP"] as const satisfies NodeJS.Signals[];
+
+const sweep = (): void => {
+    if (GUARD_PREFIX.length > 0) {
+        killMarkedProcesses(GUARD_PREFIX);
+    }
+
+    process.exit(0);
+};
+
+process.stdin.resume();
+process.stdin.on("end", sweep);
+process.stdin.on("error", sweep);
+
+for (const signal of WATCHED_SIGNALS) {
+    process.on(signal, sweep);
+}

package/src/process/resolve-executable.ts

@@ -25,7 +25,7 @@ const findOnPath = (command: string): string | undefined => {
     return undefined;
 };
 
-function resolveExecutable(command: string): string {
+function tryResolveExecutable(command: string): string | undefined {
     if (isAbsolute(command)) {
         return command;
     }
@@ -34,7 +34,11 @@ function resolveExecutable(command: string): string {
         return resolve(command);
     }
 
-    const found = findOnPath(command);
+    return findOnPath(command);
+}
+
+function resolveExecutable(command: string): string {
+    const found = tryResolveExecutable(command);
 
     if (found === undefined) {
         throw new Error(`Cannot find the "${command}" executable on PATH`);
@@ -43,4 +47,4 @@ function resolveExecutable(command: string): string {
     return found;
 }
 
-export { resolveExecutable };
+export { resolveExecutable, tryResolveExecutable };

package/src/process/spawn-with-parent-death-signal.ts

@@ -0,0 +1,74 @@
+import { type ChildProcess, spawn, type StdioOptions } from "node:child_process";
+import { randomBytes } from "node:crypto";
+import { Socket } from "node:net";
+import { dirname, extname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+import { killMarkedProcesses, PROCESS_MARKER } from "./kill-marked-processes.ts";
+import { resolveExecutable } from "./resolve-executable.ts";
+
+type ParentDeathSpawnOptions = {
+    stdio?: StdioOptions;
+    env?: NodeJS.ProcessEnv;
+};
+
+type GuardState = {
+    child?: ChildProcess | undefined;
+};
+
+const MODULE_PATH = fileURLToPath(import.meta.url);
+const GUARD_PATH = join(dirname(MODULE_PATH), `process-guard${extname(MODULE_PATH)}`);
+const RUN_ID = randomBytes(8).toString("hex");
+const RUN_PREFIX = `${PROCESS_MARKER}=${RUN_ID}/`;
+const guard: GuardState = {};
+
+const releaseGuard = (child: ChildProcess): void => {
+    child.unref();
+    const { stdin } = child;
+
+    if (stdin instanceof Socket) {
+        stdin.unref();
+    }
+};
+
+const startGuard = (): void => {
+    if (guard.child) {
+        return;
+    }
+
+    const child = spawn(process.execPath, [GUARD_PATH, RUN_PREFIX], {
+        detached: true,
+        stdio: ["pipe", "ignore", "ignore"],
+    });
+
+    child.on("error", () => {
+        guard.child = undefined;
+    });
+
+    guard.child = child;
+    releaseGuard(child);
+};
+
+function spawnWithParentDeathSignal(
+    command: string,
+    args: string[],
+    options: ParentDeathSpawnOptions = {},
+): ChildProcess {
+    const executable = resolveExecutable(command);
+    const setpriv = resolveExecutable("setpriv");
+    const jobValue = `${RUN_ID}/${randomBytes(4).toString("hex")}`;
+    startGuard();
+
+    const child = spawn(setpriv, ["--pdeathsig", "SIGKILL", executable, ...args], {
+        detached: true,
+        stdio: options.stdio ?? "ignore",
+        env: { ...(options.env ?? process.env), [PROCESS_MARKER]: jobValue },
+    });
+
+    child.on("exit", () => {
+        killMarkedProcesses(`${PROCESS_MARKER}=${jobValue}`);
+    });
+
+    return child;
+}
+
+export { spawnWithParentDeathSignal };

package/src/util/package-version.ts

@@ -1,7 +1,7 @@
 import { createRequire } from "node:module";
 
-function packageVersion(importMetaUrl: string): string {
-    return (createRequire(importMetaUrl)("../package.json") as { version: string }).version;
+function packageVersion(importMetaUrl: string, specifier: string): string {
+    return (createRequire(importMetaUrl)(specifier) as { version: string }).version;
 }
 
 export { packageVersion };