@vibe-agent-toolkit/utils 0.2.0-rc.10 → 0.2.0-rc.12

package/dist/skill-targets.js.map

@@ -1 +1 @@
-{"version":3,"file":"skill-targets.js","sourceRoot":"","sources":["../src/skill-targets.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAElC,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAE3C,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,QAAQ;IACR,OAAO;IACP,SAAS;IACT,QAAQ;IACR,QAAQ;IACR,UAAU;IACV,QAAQ;CACA,CAAC;AAIX,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,MAAM,EAAE,SAAS,CAAU,CAAC;AAW9D;;;;;;;;;;;;;;;GAeG;AACH,MAAM,kBAAkB,GAAG,gBAAgB,CAAC;AAE5C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AACH,MAAM,CAAC,MAAM,aAAa,GAAoD;IAC5E,MAAM,EAAE,EAAE,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,gBAAgB,EAAE;IACnE,KAAK,EAAE,EAAE,OAAO,EAAE,kBAAkB,EAAE,UAAU,EAAE,kBAAkB,EAAE;IACtE,OAAO,EAAE,EAAE,OAAO,EAAE,iBAAiB,EAAE,UAAU,EAAE,gBAAgB,EAAE;IACrE,MAAM,EAAE,EAAE,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,gBAAgB,EAAE;IACnE,MAAM,EAAE,EAAE,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,gBAAgB,EAAE;IACnE,QAAQ,EAAE,EAAE,OAAO,EAAE,0BAA0B,EAAE,UAAU,EAAE,kBAAkB,EAAE;IACjF,MAAM,EAAE,EAAE,OAAO,EAAE,kBAAkB,EAAE,UAAU,EAAE,kBAAkB,EAAE;CACxE,CAAC;AAEF,SAAS,aAAa,CAAC,KAAa;IAClC,OAAQ,kBAAwC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AACnE,CAAC;AAED,SAAS,YAAY,CAAC,KAAa;IACjC,OAAQ,iBAAuC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AAClE,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,kBAAkB,CAChC,MAAmB,EACnB,KAAiB,EACjB,GAAW;IAEX,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,EAAE,CAAC;QAC3B,MAAM,IAAI,KAAK,CACb,mBAAmB,MAAM,CAAC,MAAM,CAAC,qBAAqB,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACtF,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CACb,kBAAkB,MAAM,CAAC,KAAK,CAAC,oBAAoB,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAClF,CAAC;IACJ,CAAC;IAED,MAAM,KAAK,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;IACpC,MAAM,IAAI,GAAG,KAAK,KAAK,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC;IAChD,MAAM,GAAG,GAAG,KAAK,KAAK,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC;IAChE,OAAO,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;AAClC,CAAC"}
+{"version":3,"file":"skill-targets.js","sourceRoot":"","sources":["../src/skill-targets.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAElC,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAE7D,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,QAAQ;IACR,OAAO;IACP,SAAS;IACT,QAAQ;IACR,QAAQ;IACR,UAAU;IACV,QAAQ;CACA,CAAC;AAIX,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,MAAM,EAAE,SAAS,CAAU,CAAC;AAW9D;;;;;;;;;;;;;;;GAeG;AACH,MAAM,kBAAkB,GAAG,gBAAgB,CAAC;AAE5C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AACH,MAAM,CAAC,MAAM,aAAa,GAAoD;IAC5E,MAAM,EAAE,EAAE,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,gBAAgB,EAAE;IACnE,KAAK,EAAE,EAAE,OAAO,EAAE,kBAAkB,EAAE,UAAU,EAAE,kBAAkB,EAAE;IACtE,OAAO,EAAE,EAAE,OAAO,EAAE,iBAAiB,EAAE,UAAU,EAAE,gBAAgB,EAAE;IACrE,MAAM,EAAE,EAAE,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,gBAAgB,EAAE;IACnE,MAAM,EAAE,EAAE,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,gBAAgB,EAAE;IACnE,QAAQ,EAAE,EAAE,OAAO,EAAE,0BAA0B,EAAE,UAAU,EAAE,kBAAkB,EAAE;IACjF,MAAM,EAAE,EAAE,OAAO,EAAE,kBAAkB,EAAE,UAAU,EAAE,kBAAkB,EAAE;CACxE,CAAC;AAEF,SAAS,aAAa,CAAC,KAAa;IAClC,OAAQ,kBAAwC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AACnE,CAAC;AAED,SAAS,YAAY,CAAC,KAAa;IACjC,OAAQ,iBAAuC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AAClE,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,kBAAkB,CAChC,MAAmB,EACnB,KAAiB,EACjB,GAAW;IAEX,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,EAAE,CAAC;QAC3B,MAAM,IAAI,KAAK,CACb,mBAAmB,MAAM,CAAC,MAAM,CAAC,qBAAqB,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACtF,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CACb,kBAAkB,MAAM,CAAC,KAAK,CAAC,oBAAoB,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAClF,CAAC;IACJ,CAAC;IAED,MAAM,KAAK,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;IACpC,kGAAkG;IAClG,MAAM,IAAI,GAAG,KAAK,KAAK,MAAM,CAAC,CAAC,CAAC,kBAAkB,CAAC,OAAO,EAAE,EAAE,qCAAqC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;IACpH,MAAM,GAAG,GAAG,KAAK,KAAK,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC;IAChE,OAAO,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;AAClC,CAAC"}

package/dist/skill-test/spawn-claude.d.ts

@@ -46,21 +46,6 @@ export interface SpawnResult {
     timedOut: boolean;
     stalled: boolean;
 }
-/**
- * SIGKILL the child AND every process in its group. The child is spawned
- * `detached` (POSIX) so it leads a new process group; killing the negated pid
- * reaps backgrounded grandchildren (e.g. a skill that runs `nohup … &`) and
- * orphaned MCP subprocesses that a direct `child.kill()` would leave running.
- *
- * - Guards an undefined pid (child never spawned — nothing to kill).
- * - Absorbs the throw that means the group is already gone (see
- *   {@link isProcessGroupGone}); anything else stays loud.
- * - Windows has no POSIX process groups: fall back to `taskkill /T /F`, which
- *   terminates the whole process tree.
- */
-export declare function killProcessTree(child: {
-    pid?: number | undefined;
-}): void;
 /**
  * SIGKILL every currently in-flight `claude` child (and its process tree, via
  * {@link killProcessTree}) and clear the registry. Idempotent — safe to call

package/dist/skill-test/spawn-claude.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"spawn-claude.d.ts","sourceRoot":"","sources":["../../src/skill-test/spawn-claude.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,eAAe,GAAG,MAAM,EAAE,CAoBlE;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE;IAAE,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,GAAG,IAAI,CAkBzE;AAgCD;;;;;GAKG;AACH,wBAAgB,2BAA2B,IAAI,IAAI,CAKlD;AAED,MAAM,WAAW,oBAAqB,SAAQ,eAAe;IAC3D;;;;;;;;;OASG;IACH,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,yFAAyF;IACzF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;GAMG;AACH,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,WAAW,CAAC,CA8G1F"}
+{"version":3,"file":"spawn-claude.d.ts","sourceRoot":"","sources":["../../src/skill-test/spawn-claude.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,eAAe,GAAG,MAAM,EAAE,CAoBlE;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;CAClB;AA4BD;;;;;GAKG;AACH,wBAAgB,2BAA2B,IAAI,IAAI,CAKlD;AAED,MAAM,WAAW,oBAAqB,SAAQ,eAAe;IAC3D;;;;;;;;;OASG;IACH,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,yFAAyF;IACzF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;GAMG;AACH,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,WAAW,CAAC,CA8G1F"}

package/dist/skill-test/spawn-claude.js

@@ -1,5 +1,5 @@
-import { spawnSync } from 'node:child_process';
 import { Readable } from 'node:stream';
+import { killProcessTree } from '../kill-process-tree.js';
 import { spawnHardened } from '../spawn-hardened.js';
 /**
  * Pure assembly of the headless `claude -p` argv (spec §9). The prompt is never
@@ -61,51 +61,12 @@ export function assembleClaudeArgs(opts) {
     return args;
 }
 /**
- * SIGKILL the child AND every process in its group. The child is spawned
- * `detached` (POSIX) so it leads a new process group; killing the negated pid
- * reaps backgrounded grandchildren (e.g. a skill that runs `nohup … &`) and
- * orphaned MCP subprocesses that a direct `child.kill()` would leave running.
- *
- * - Guards an undefined pid (child never spawned — nothing to kill).
- * - Absorbs the throw that means the group is already gone (see
- *   {@link isProcessGroupGone}); anything else stays loud.
- * - Windows has no POSIX process groups: fall back to `taskkill /T /F`, which
- *   terminates the whole process tree.
- */
-export function killProcessTree(child) {
-    const { pid } = child;
-    if (pid === undefined)
-        return;
-    try {
-        if (process.platform === 'win32') {
-            // eslint-disable-next-line sonarjs/no-os-command-from-path -- taskkill is a fixed Windows system command (no PATH-injection surface); it is the only POSIX-process-group-free way to terminate the child's tree.
-            spawnSync('taskkill', ['/pid', String(pid), '/T', '/F']);
-        }
-        else {
-            // Negated pid → deliver the signal to the whole process group.
-            process.kill(-pid, 'SIGKILL');
-        }
-    }
-    catch (error) {
-        // A reaper that says nothing about a tree it did not reap is the
-        // orphan-billing defect the registry exists to prevent, so only "already
-        // gone" is absorbed. A bug here — the one other thing `process.kill` on our
-        // own child's group can throw — stays loud.
-        if (!isProcessGroupGone(error))
-            throw error;
-    }
-}
-/**
- * Whether `process.kill(-pid)` failed because the group is already gone.
- *
- * `ESRCH`: no such process group. `EPERM`: the group id has been recycled to a
- * process this uid may not signal — which, for a group WE created and would
- * have permission over, also means every process of ours in it has exited.
- * Both are the outcome the kill was after.
+ * How a `claude` child is killed: with every process in its group. It is spawned `detached` (POSIX),
+ * so it leads a new process group, and the group kill reaps backgrounded grandchildren (a skill that
+ * runs `nohup … &`) and orphaned MCP subprocesses that a direct `child.kill()` would leave running;
+ * on Windows `taskkill /T /F` takes the tree.
  */
-function isProcessGroupGone(error) {
-    return error instanceof Error && 'code' in error && (error.code === 'ESRCH' || error.code === 'EPERM');
-}
+const CLAUDE_TREE = { groupLeader: true, throughChild: false };
 /**
  * Registry of currently in-flight `claude` child processes, keyed by the
  * `ChildProcess` object itself. A child is registered immediately after
@@ -131,7 +92,7 @@ const activeClaudeChildren = new Set();
  */
 export function killAllActiveClaudeChildren() {
     for (const child of activeClaudeChildren) {
-        killProcessTree(child);
+        killProcessTree(child, CLAUDE_TREE);
     }
     activeClaudeChildren.clear();
 }
@@ -193,7 +154,7 @@ export async function spawnHeadlessClaude(opts) {
         const promptStream = Readable.from([opts.prompt], { objectMode: false });
         const wallTimer = setTimeout(() => {
             timedOut = true;
-            killProcessTree(child);
+            killProcessTree(child, CLAUDE_TREE);
         }, opts.timeoutMs);
         // Stall watchdog: reset on every stdout/stderr chunk; fire if silent for stallMs.
         let stallTimer;
@@ -204,7 +165,7 @@ export async function spawnHeadlessClaude(opts) {
                     clearTimeout(stallTimer);
                 stallTimer = setTimeout(() => {
                     stalled = true;
-                    killProcessTree(child);
+                    killProcessTree(child, CLAUDE_TREE);
                 }, stallMs);
             };
             resetStallTimer();
@@ -226,7 +187,7 @@ export async function spawnHeadlessClaude(opts) {
         };
         promptStream.on('error', err => {
             clearAllTimers();
-            killProcessTree(child);
+            killProcessTree(child, CLAUDE_TREE);
             reject(err);
         });
         // Swallow EPIPE: if the child exits before consuming all stdin, the write
@@ -242,7 +203,7 @@ export async function spawnHeadlessClaude(opts) {
         // ever fires while the process is actually alive we would otherwise drop it
         // from the reap set without killing it (the exact orphan this file guards
         // against). killProcessTree no-ops on an undefined pid (never-spawned case).
-        child.on('error', err => { clearAllTimers(); killProcessTree(child); reject(err); });
+        child.on('error', err => { clearAllTimers(); killProcessTree(child, CLAUDE_TREE); reject(err); });
         child.on('close', code => { clearAllTimers(); resolve({ status: code ?? -1, timedOut, stalled }); });
     });
 }

package/dist/skill-test/spawn-claude.js.map

@@ -1 +1 @@
-{"version":3,"file":"spawn-claude.js","sourceRoot":"","sources":["../../src/skill-test/spawn-claude.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"spawn-claude.js","sourceRoot":"","sources":["../../src/skill-test/spawn-claude.ts"],"names":[],"mappings":"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"}

package/dist/special-file.d.ts

@@ -0,0 +1,18 @@
+/**
+ * The one special-file policy: what a read does with an entry that is not a
+ * regular file. Internal, and off the barrel: `openForReading` and the
+ * tree-change walk both judge by it, so a named pipe is refused the same way
+ * whether one file is read or a whole tree is.
+ */
+/**
+ * Refuse, before reading a byte, something that is not a regular file: a named
+ * pipe, socket or device has no content to read, only a stream that may never
+ * end. It is an `EFTYPE` errno ("inappropriate file type"), so every caller's
+ * own environmental-refusal convention codes it. A directory is left to the
+ * read, which raises the OS's own `EISDIR`.
+ */
+export declare function refuseSpecialFile(stats: {
+    isFile(): boolean;
+    isDirectory(): boolean;
+}, filePath: string): void;
+//# sourceMappingURL=special-file.d.ts.map

package/dist/special-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"special-file.d.ts","sourceRoot":"","sources":["../src/special-file.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE;IAAE,MAAM,IAAI,OAAO,CAAC;IAAC,WAAW,IAAI,OAAO,CAAA;CAAE,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAM9G"}

package/dist/special-file.js

@@ -0,0 +1,21 @@
+/**
+ * The one special-file policy: what a read does with an entry that is not a
+ * regular file. Internal, and off the barrel: `openForReading` and the
+ * tree-change walk both judge by it, so a named pipe is refused the same way
+ * whether one file is read or a whole tree is.
+ */
+/** An OS errno (BSD's "inappropriate file type"), not a VAT code: the shape every errno predicate reads. */
+const NOT_A_REGULAR_FILE_ERRNO = 'EFTYPE';
+/**
+ * Refuse, before reading a byte, something that is not a regular file: a named
+ * pipe, socket or device has no content to read, only a stream that may never
+ * end. It is an `EFTYPE` errno ("inappropriate file type"), so every caller's
+ * own environmental-refusal convention codes it. A directory is left to the
+ * read, which raises the OS's own `EISDIR`.
+ */
+export function refuseSpecialFile(stats, filePath) {
+    if (stats.isFile() || stats.isDirectory())
+        return;
+    throw Object.assign(new Error(`${NOT_A_REGULAR_FILE_ERRNO}: not a regular file (a named pipe, socket or device), refused unread: ${filePath}`), { code: NOT_A_REGULAR_FILE_ERRNO, path: filePath, syscall: 'open' });
+}
+//# sourceMappingURL=special-file.js.map

package/dist/special-file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"special-file.js","sourceRoot":"","sources":["../src/special-file.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,4GAA4G;AAC5G,MAAM,wBAAwB,GAAG,QAAQ,CAAC;AAE1C;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAoD,EAAE,QAAgB;IACtG,IAAI,KAAK,CAAC,MAAM,EAAE,IAAI,KAAK,CAAC,WAAW,EAAE;QAAE,OAAO;IAClD,MAAM,MAAM,CAAC,MAAM,CACjB,IAAI,KAAK,CAAC,GAAG,wBAAwB,0EAA0E,QAAQ,EAAE,CAAC,EAC1H,EAAE,IAAI,EAAE,wBAAwB,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,CACpE,CAAC;AACJ,CAAC"}

package/dist/terminating-signals.d.ts

@@ -0,0 +1,129 @@
+/**
+ * The signals a process must not die of before it has cleaned up, the ONE way a handler for them is
+ * installed ({@link handleTerminatingSignals}), and how the process then dies of the signal itself.
+ *
+ * 🚨 Every terminating-signal handler in VAT's product code goes through
+ * {@link handleTerminatingSignals}; `local/no-raw-signal-listener` refuses any other way of adding
+ * or removing a listener for one (its README lists every shape it catches). The class it closes: a handler
+ * that removed itself on the first signal and started an ASYNCHRONOUS cleanup, so a second signal —
+ * which a terminal Ctrl-C under the `vat` wrapper delivers (the terminal signals the whole
+ * foreground group, and the wrapper forwards) — met the default disposition and killed the process
+ * half-way through that cleanup, leaking the clone or the lock it was removing.
+ */
+/**
+ * The signals that end a process by default disposition — `kill <pid>`, `kill -INT <pid>`,
+ * `timeout(1)`, a CI runner stopping or cancelling a step, a closed terminal, Ctrl-C, `Ctrl-\`,
+ * Ctrl-Break.
+ *
+ * SIGQUIT is here because its default disposition terminates exactly as the others do (plus a core
+ * dump where the system allows one). SIGBREAK is Windows' Ctrl-Break, which Node delivers there and
+ * which ends a process with no handler. Each exists on one platform only: a listener for the other
+ * platform's registers an ordinary event that never fires, which is harmless — so ONE list serves
+ * both. SIGKILL is not here because nothing can handle it.
+ *
+ * ⚠️ On Windows only SIGINT, SIGBREAK and SIGHUP are ever DELIVERED, and only as console events
+ * (Ctrl-C, Ctrl-Break, the console closing) — which the console sends to EVERY process attached to
+ * it. An outside kill there (`taskkill /F`, `process.kill(pid, <any>)`, `child.kill()`) is
+ * `TerminateProcess`: no handler runs at all.
+ */
+export declare const TERMINATING_SIGNALS: readonly ["SIGTERM", "SIGHUP", "SIGINT", "SIGQUIT", "SIGBREAK"];
+/** One of {@link TERMINATING_SIGNALS}. */
+export type TerminatingSignal = (typeof TERMINATING_SIGNALS)[number];
+/**
+ * Whether `signal` is one of {@link TERMINATING_SIGNALS}.
+ *
+ * @param signal - A signal name, as a child's `exit` reports it
+ * @returns True for a terminating signal
+ */
+export declare function isTerminatingSignal(signal: string): signal is TerminatingSignal;
+/**
+ * How long after the first terminating signal a repeat is still the SAME interruption, and is
+ * swallowed rather than acted on.
+ *
+ * A terminal's Ctrl-C under the `vat` wrapper arrives twice — the foreground group's, and the
+ * wrapper's forward — milliseconds apart. A repeat later than this is an operator (or a supervisor)
+ * asking again because the first did not end the process soon enough: it ends the process at once,
+ * whatever cleanup is still running.
+ */
+export declare const REPEAT_SIGNAL_WINDOW_MS = 500;
+/**
+ * End this process OF `signal`, as its default disposition would have — so a shell and a CI runner
+ * read the status they expect (128 + n) — with an exit-code fallback.
+ *
+ * The {@link handleTerminatingSignals} listener is removed first, so the raise reaches the default
+ * disposition rather than a guard still swallowing repeats. Only that listener: nothing else in VAT
+ * installs one (`local/no-raw-signal-listener`), and a host's own — a test runner's — is not this
+ * module's to strip. A process one of those keeps alive takes the fallback below.
+ *
+ * The wait is synchronous so nothing else runs meanwhile: output published after the operator asked
+ * this process to end would read as the run's verdict. A process still here after
+ * {@link RERAISE_GRACE_MS} survived its own raise (PID 1) and exits `fallbackExitCode`. Windows is
+ * never sent the raise: it cannot SEND most of these signals, and the ones it can terminate without
+ * a signal status to preserve — so on Windows this always exits `fallbackExitCode`.
+ *
+ * @param signal - The signal this process received
+ * @param fallbackExitCode - The exit code when the raise cannot end this process
+ */
+export declare function reRaiseSignal(signal: NodeJS.Signals, fallbackExitCode: number): never;
+/**
+ * What a guard undoes before the process ends: given the signal, and an `AbortSignal` that aborts
+ * — synchronously, just before the process ends — when a later repeat forces the ending while this
+ * cleanup is still running. Most cleanups have nothing to do then; one that started something which
+ * must not outlive this process (the `vat` wrapper's CLI) kills it there.
+ */
+export type TerminatingSignalCleanup = (signal: TerminatingSignal, forced: AbortSignal) => unknown;
+/** What {@link handleTerminatingSignals} hands back. */
+export interface TerminatingSignalGuard {
+    /**
+     * The guarded work is over without a signal: stop guarding it.
+     *
+     * Before any signal arrived, this removes the guard — and the process's listeners with the last
+     * one. Once a signal HAS arrived it changes nothing: the process still ends of that signal when
+     * every cleanup has settled (or a later repeat forces it). A caller that must end the process its
+     * own way meanwhile does so with {@link reRaiseSignal} or `process.exit`, both of which pass every
+     * guard by.
+     *
+     * @returns True when the guard was removed; false when a signal is already ending the process
+     */
+    release(): boolean;
+    /**
+     * {@link release} for work that would go on to report or exit its own way: resolves once the
+     * guard is removed — and NEVER settles when a signal is already ending the process, so that work
+     * neither publishes nor exits under it. Call it only once this guard's own cleanup can no longer
+     * be in progress (the caller has run or awaited it), so the ending it yields to is not waiting
+     * on the caller.
+     *
+     * @returns A promise that resolves once the guard is removed
+     */
+    releaseOrAwaitEnding(): Promise<void>;
+}
+/**
+ * Guard this process's terminating signals while `cleanup` has something to undo: on the FIRST
+ * {@link TERMINATING_SIGNALS} member, run it — and every other live guard's — then die of that
+ * signal.
+ *
+ * - **A repeat within {@link REPEAT_SIGNAL_WINDOW_MS} is swallowed.** A terminal Ctrl-C under the
+ *   `vat` wrapper arrives twice (the group's, and the wrapper's forward); the second must not meet
+ *   the default disposition half-way through an asynchronous cleanup.
+ * - **A repeat after it ends the process at once**, of the repeat, the cleanups abandoned (each
+ *   cleanup's `forced` signal aborts first): a second Ctrl-C or kill still ends a cleanup that hung.
+ * - **Synchronous or asynchronous.** A `cleanup` that returns a promise is awaited, whichever way it
+ *   settles — it reports its own failures — and a ref'd timer holds the process open meanwhile, so
+ *   a promise that holds nothing open cannot let it exit 0. When none returned one, the process
+ *   ends synchronously, inside the signal's own turn.
+ * - **The ending** is {@link reRaiseSignal}: on POSIX the process dies of the signal (128 + n); on
+ *   Windows, or where the raise cannot kill it (PID 1), it exits `fallbackExitCode`.
+ * - **Guards compose.** One listener serves every live guard, so two guards in one process both
+ *   clean up before it ends; the first one installed decides `fallbackExitCode`. A guard installed
+ *   while an ending is in progress runs its cleanup at once, and the ending waits for it too.
+ *
+ * @param options - The guard
+ * @param options.cleanup - What to undo before the process ends
+ * @param options.fallbackExitCode - The exit code where the signal cannot end the process
+ * @returns The guard, to release once the guarded work is over
+ */
+export declare function handleTerminatingSignals(options: {
+    cleanup: TerminatingSignalCleanup;
+    fallbackExitCode: number;
+}): TerminatingSignalGuard;
+//# sourceMappingURL=terminating-signals.d.ts.map

package/dist/terminating-signals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminating-signals.d.ts","sourceRoot":"","sources":["../src/terminating-signals.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,mBAAmB,iEAAkE,CAAC;AAEnG,0CAA0C;AAC1C,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,CAAC,CAAC;AAErE;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,IAAI,iBAAiB,CAE/E;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,uBAAuB,MAAM,CAAC;AAa3C;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,CAAC,OAAO,EAAE,gBAAgB,EAAE,MAAM,GAAG,KAAK,CAOrF;AAED;;;;;GAKG;AACH,MAAM,MAAM,wBAAwB,GAAG,CAAC,MAAM,EAAE,iBAAiB,EAAE,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC;AAwGnG,wDAAwD;AACxD,MAAM,WAAW,sBAAsB;IACrC;;;;;;;;;;OAUG;IACH,OAAO,IAAI,OAAO,CAAC;IACnB;;;;;;;;OAQG;IACH,oBAAoB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACvC;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE;IAChD,OAAO,EAAE,wBAAwB,CAAC;IAClC,gBAAgB,EAAE,MAAM,CAAC;CAC1B,GAAG,sBAAsB,CAiBzB"}

package/dist/terminating-signals.js

@@ -0,0 +1,210 @@
+/**
+ * The signals a process must not die of before it has cleaned up, the ONE way a handler for them is
+ * installed ({@link handleTerminatingSignals}), and how the process then dies of the signal itself.
+ *
+ * 🚨 Every terminating-signal handler in VAT's product code goes through
+ * {@link handleTerminatingSignals}; `local/no-raw-signal-listener` refuses any other way of adding
+ * or removing a listener for one (its README lists every shape it catches). The class it closes: a handler
+ * that removed itself on the first signal and started an ASYNCHRONOUS cleanup, so a second signal —
+ * which a terminal Ctrl-C under the `vat` wrapper delivers (the terminal signals the whole
+ * foreground group, and the wrapper forwards) — met the default disposition and killed the process
+ * half-way through that cleanup, leaking the clone or the lock it was removing.
+ */
+/**
+ * The signals that end a process by default disposition — `kill <pid>`, `kill -INT <pid>`,
+ * `timeout(1)`, a CI runner stopping or cancelling a step, a closed terminal, Ctrl-C, `Ctrl-\`,
+ * Ctrl-Break.
+ *
+ * SIGQUIT is here because its default disposition terminates exactly as the others do (plus a core
+ * dump where the system allows one). SIGBREAK is Windows' Ctrl-Break, which Node delivers there and
+ * which ends a process with no handler. Each exists on one platform only: a listener for the other
+ * platform's registers an ordinary event that never fires, which is harmless — so ONE list serves
+ * both. SIGKILL is not here because nothing can handle it.
+ *
+ * ⚠️ On Windows only SIGINT, SIGBREAK and SIGHUP are ever DELIVERED, and only as console events
+ * (Ctrl-C, Ctrl-Break, the console closing) — which the console sends to EVERY process attached to
+ * it. An outside kill there (`taskkill /F`, `process.kill(pid, <any>)`, `child.kill()`) is
+ * `TerminateProcess`: no handler runs at all.
+ */
+export const TERMINATING_SIGNALS = ['SIGTERM', 'SIGHUP', 'SIGINT', 'SIGQUIT', 'SIGBREAK'];
+/**
+ * Whether `signal` is one of {@link TERMINATING_SIGNALS}.
+ *
+ * @param signal - A signal name, as a child's `exit` reports it
+ * @returns True for a terminating signal
+ */
+export function isTerminatingSignal(signal) {
+    return TERMINATING_SIGNALS.includes(signal);
+}
+/**
+ * How long after the first terminating signal a repeat is still the SAME interruption, and is
+ * swallowed rather than acted on.
+ *
+ * A terminal's Ctrl-C under the `vat` wrapper arrives twice — the foreground group's, and the
+ * wrapper's forward — milliseconds apart. A repeat later than this is an operator (or a supervisor)
+ * asking again because the first did not end the process soon enough: it ends the process at once,
+ * whatever cleanup is still running.
+ */
+export const REPEAT_SIGNAL_WINDOW_MS = 500;
+/**
+ * How long a re-raised signal is given to end this process before it ends itself instead.
+ *
+ * A process that SURVIVES its own re-raise is one whose default disposition for the signal does
+ * nothing — PID 1 in a container is the common case — and it must still end.
+ */
+const RERAISE_GRACE_MS = 1000;
+/** The longest interval a Node timer accepts: the hold below never fires, it only holds. */
+const HOLD_INTERVAL_MS = 2 ** 31 - 1;
+/**
+ * End this process OF `signal`, as its default disposition would have — so a shell and a CI runner
+ * read the status they expect (128 + n) — with an exit-code fallback.
+ *
+ * The {@link handleTerminatingSignals} listener is removed first, so the raise reaches the default
+ * disposition rather than a guard still swallowing repeats. Only that listener: nothing else in VAT
+ * installs one (`local/no-raw-signal-listener`), and a host's own — a test runner's — is not this
+ * module's to strip. A process one of those keeps alive takes the fallback below.
+ *
+ * The wait is synchronous so nothing else runs meanwhile: output published after the operator asked
+ * this process to end would read as the run's verdict. A process still here after
+ * {@link RERAISE_GRACE_MS} survived its own raise (PID 1) and exits `fallbackExitCode`. Windows is
+ * never sent the raise: it cannot SEND most of these signals, and the ones it can terminate without
+ * a signal status to preserve — so on Windows this always exits `fallbackExitCode`.
+ *
+ * @param signal - The signal this process received
+ * @param fallbackExitCode - The exit code when the raise cannot end this process
+ */
+export function reRaiseSignal(signal, fallbackExitCode) {
+    unlisten();
+    if (process.platform !== 'win32') {
+        process.kill(process.pid, signal);
+        Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, RERAISE_GRACE_MS);
+    }
+    process.exit(fallbackExitCode);
+}
+/** Every guard not yet released, in installation order. */
+const registrations = new Set();
+/** The ending in progress, if a signal has arrived — and the reason a repeat is not a new one. */
+let ending;
+/** Whether `value` is a promise (or any thenable) to wait for. */
+function isThenable(value) {
+    return typeof value?.then === 'function';
+}
+/**
+ * Run one cleanup inside `current`. A synchronous throw becomes a rejection, so it cannot stop the
+ * others — or the ending: a cleanup reports its own failures, and this only makes sure the process
+ * still ends. A promise it returns is waited for, whichever way it settles: the ending finishes
+ * once the last one has.
+ */
+function joinEnding(current, cleanup) {
+    let outcome;
+    try {
+        outcome = cleanup(current.signal, current.forced.signal);
+    }
+    catch (error) {
+        outcome = Promise.reject(error instanceof Error ? error : new Error(String(error)));
+    }
+    if (!isThenable(outcome))
+        return;
+    current.pending += 1;
+    const settled = () => {
+        current.pending -= 1;
+        if (current.pending === 0 && ending === current)
+            finishEnding(current, current.signal);
+    };
+    outcome.then(settled, settled);
+}
+/** End `current`'s ending: let go of everything this module holds, then die of `signal`. */
+function finishEnding(current, signal) {
+    clearInterval(current.hold);
+    registrations.clear();
+    ending = undefined;
+    reRaiseSignal(signal, current.fallbackExitCode);
+}
+/** The one listener every guard shares, on every {@link TERMINATING_SIGNALS} member. */
+function onTerminatingSignal(signal) {
+    const current = ending;
+    if (current !== undefined) {
+        // The same interruption, delivered twice (a group Ctrl-C and the wrapper's forward): swallowed,
+        // so it cannot cut the cleanups short.
+        if (performance.now() - current.at < REPEAT_SIGNAL_WINDOW_MS)
+            return;
+        // Asked again: the cleanups are abandoned, and the process ends now, of the repeat.
+        current.forced.abort();
+        finishEnding(current, signal);
+        return;
+    }
+    const [first] = registrations;
+    if (first === undefined)
+        return;
+    const started = {
+        signal,
+        at: performance.now(),
+        fallbackExitCode: first.fallbackExitCode,
+        forced: new AbortController(),
+        hold: setInterval(() => undefined, HOLD_INTERVAL_MS),
+        pending: 0,
+    };
+    ending = started;
+    for (const registration of registrations)
+        joinEnding(started, registration.cleanup);
+    // Synchronous cleanups end the process synchronously: nothing else runs meanwhile, so nothing can
+    // publish a verdict after the operator asked this process to stop.
+    if (started.pending === 0)
+        finishEnding(started, signal);
+}
+function listen() {
+    for (const signal of TERMINATING_SIGNALS)
+        process.on(signal, onTerminatingSignal);
+}
+function unlisten() {
+    for (const signal of TERMINATING_SIGNALS)
+        process.off(signal, onTerminatingSignal);
+}
+/**
+ * Guard this process's terminating signals while `cleanup` has something to undo: on the FIRST
+ * {@link TERMINATING_SIGNALS} member, run it — and every other live guard's — then die of that
+ * signal.
+ *
+ * - **A repeat within {@link REPEAT_SIGNAL_WINDOW_MS} is swallowed.** A terminal Ctrl-C under the
+ *   `vat` wrapper arrives twice (the group's, and the wrapper's forward); the second must not meet
+ *   the default disposition half-way through an asynchronous cleanup.
+ * - **A repeat after it ends the process at once**, of the repeat, the cleanups abandoned (each
+ *   cleanup's `forced` signal aborts first): a second Ctrl-C or kill still ends a cleanup that hung.
+ * - **Synchronous or asynchronous.** A `cleanup` that returns a promise is awaited, whichever way it
+ *   settles — it reports its own failures — and a ref'd timer holds the process open meanwhile, so
+ *   a promise that holds nothing open cannot let it exit 0. When none returned one, the process
+ *   ends synchronously, inside the signal's own turn.
+ * - **The ending** is {@link reRaiseSignal}: on POSIX the process dies of the signal (128 + n); on
+ *   Windows, or where the raise cannot kill it (PID 1), it exits `fallbackExitCode`.
+ * - **Guards compose.** One listener serves every live guard, so two guards in one process both
+ *   clean up before it ends; the first one installed decides `fallbackExitCode`. A guard installed
+ *   while an ending is in progress runs its cleanup at once, and the ending waits for it too.
+ *
+ * @param options - The guard
+ * @param options.cleanup - What to undo before the process ends
+ * @param options.fallbackExitCode - The exit code where the signal cannot end the process
+ * @returns The guard, to release once the guarded work is over
+ */
+export function handleTerminatingSignals(options) {
+    const registration = { cleanup: options.cleanup, fallbackExitCode: options.fallbackExitCode };
+    if (ending === undefined) {
+        if (registrations.size === 0)
+            listen();
+        registrations.add(registration);
+    }
+    else {
+        joinEnding(ending, registration.cleanup);
+    }
+    const release = () => {
+        if (ending !== undefined)
+            return false;
+        if (registrations.delete(registration) && registrations.size === 0)
+            unlisten();
+        return true;
+    };
+    return {
+        release,
+        releaseOrAwaitEnding: () => (release() ? Promise.resolve() : new Promise(() => { })),
+    };
+}
+//# sourceMappingURL=terminating-signals.js.map

package/dist/terminating-signals.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminating-signals.js","sourceRoot":"","sources":["../src/terminating-signals.ts"],"names":[],"mappings":"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"}

package/dist/test-helpers.d.ts

@@ -26,7 +26,7 @@ export type SymlinkCapability = {
  *
  * Because the answer is memoized for the whole process, what reads as "no"
  * matters more than usual: a `null` here silently `skip()`s every symlink test
- * for the rest of the run. So ONLY {@link SYMLINK_UNSUPPORTED_ERRNOS} is a
+ * for the rest of the run. So ONLY {@link isSymlinkUnsupportedError} is a
  * no. A tmpdir that is unwritable or missing, or a bug, is not an answer about
  * symlinks at all and stays loud rather than becoming a process-wide skip for
  * a reason nothing reported.
@@ -106,13 +106,14 @@ export declare const INHERITED_GIT_ENV: readonly ["GIT_ALTERNATE_OBJECT_DIRECTOR
 export declare function detachGitEnv(): () => void;
 /**
  * The errno-shaped error a refused `fs` call throws: a message, the `code`,
- * and the `syscall`, exactly as Node shapes one.
+ * the `syscall` and the `path`, exactly as Node shapes one — a caller that names
+ * the refused file from `path` (a tree probe naming the nested file) reads it.
  */
 export declare function errnoError(code: string, syscall: string, target: string): NodeJS.ErrnoException;
 /** The sync `node:fs` calls a refusal can be injected into. */
-export type RefusableSyncFsMethod = 'readdirSync' | 'readFileSync' | 'statSync' | 'lstatSync' | 'realpathSync' | 'renameSync' | 'rmSync' | 'unlinkSync';
+export type RefusableSyncFsMethod = 'cpSync' | 'openSync' | 'readdirSync' | 'readFileSync' | 'statSync' | 'lstatSync' | 'realpathSync' | 'renameSync' | 'rmSync' | 'unlinkSync' | 'writeFileSync';
 /** The `node:fs/promises` calls a refusal can be injected into. */
-export type RefusableAsyncFsMethod = 'readdir' | 'readFile' | 'stat' | 'lstat' | 'access';
+export type RefusableAsyncFsMethod = 'readdir' | 'readFile' | 'stat' | 'lstat' | 'access' | 'copyFile' | 'mkdir' | 'writeFile';
 /**
  * Make `fs[method]` throw `code` for exactly `targetPath` until the returned
  * restore is called; every other path, and every other method, stays real.
@@ -131,8 +132,11 @@ export declare function refuseSyncFs(method: RefusableSyncFsMethod, targetPath:
 /**
  * `fs/promises[method]` rejects with `code` for exactly `targetPath` until the
  * returned restore is called; every other path, and every other method, is real.
+ * `beforeRefusing`, when given, runs first on each refused call — a write that
+ * fails partway (a full disk) leaves a truncated file behind, and a test of the
+ * cleanup needs that file to exist.
  */
-export declare function refuseAsyncFs(method: RefusableAsyncFsMethod, targetPath: string, code: string): () => void;
+export declare function refuseAsyncFs(method: RefusableAsyncFsMethod, targetPath: string, code: string, beforeRefusing?: () => void): () => void;
 /**
  * Run `body` while `fs[method]` throws `code` for exactly `targetPath`; the
  * patch is lifted however `body` exits. See {@link refuseSyncFs}.

package/dist/test-helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"test-helpers.d.ts","sourceRoot":"","sources":["../src/test-helpers.ts"],"names":[],"mappings":"AAQA,OAAO,CAAC,MAAM,sBAAsB,EAAE,OAAO,MAAM,CAAC;AAEpD;;;;;;;;;GASG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAAE,QAAQ,CAAC,CAAC,sBAAsB,CAAC,EAAE,IAAI,CAAA;CAAE,CAAC;AAe5E;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,iBAAiB,IAAI,iBAAiB,GAAG,IAAI,CAwB5D;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,iBAAiB,EACvB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,UAAU,GACjC,IAAI,CAEN;AAED;;;;;;;;GAQG;AACH,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,iBAAiB,EACvB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,UAAU,GACjC,OAAO,CAAC,IAAI,CAAC,CAEf;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,iBAAiB,yUAgBpB,CAAC;AAEX;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,YAAY,IAAI,MAAM,IAAI,CAoBzC;AAGD;;;GAGG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,cAAc,CAE/F;AAED,+DAA+D;AAC/D,MAAM,MAAM,qBAAqB,GAC7B,aAAa,GACb,cAAc,GACd,UAAU,GACV,WAAW,GACX,cAAc,GACd,YAAY,GACZ,QAAQ,GACR,YAAY,CAAC;AAEjB,mEAAmE;AACnE,MAAM,MAAM,sBAAsB,GAAG,SAAS,GAAG,UAAU,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;AAiB1F;;;;;;;;;;;;;GAaG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,qBAAqB,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,IAAI,CAQxG;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,sBAAsB,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,IAAI,CAQ1G;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CAAC,CAAC,EACvC,MAAM,EAAE,qBAAqB,EAC7B,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GACzB,OAAO,CAAC,CAAC,CAAC,CAOZ;AAED;;;;;;;;;GASG;AACH,wBAAsB,sBAAsB,CAAC,CAAC,EAC5C,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GACzB,OAAO,CAAC,CAAC,CAAC,CAEZ"}
+{"version":3,"file":"test-helpers.d.ts","sourceRoot":"","sources":["../src/test-helpers.ts"],"names":[],"mappings":"AAQA,OAAO,CAAC,MAAM,sBAAsB,EAAE,OAAO,MAAM,CAAC;AAEpD;;;;;;;;;GASG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAAE,QAAQ,CAAC,CAAC,sBAAsB,CAAC,EAAE,IAAI,CAAA;CAAE,CAAC;AAI5E;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,iBAAiB,IAAI,iBAAiB,GAAG,IAAI,CAwB5D;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,iBAAiB,EACvB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,UAAU,GACjC,IAAI,CAEN;AAED;;;;;;;;GAQG;AACH,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,iBAAiB,EACvB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,UAAU,GACjC,OAAO,CAAC,IAAI,CAAC,CAEf;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,iBAAiB,yUAgBpB,CAAC;AAEX;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,YAAY,IAAI,MAAM,IAAI,CAoBzC;AAGD;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,cAAc,CAE/F;AAED,+DAA+D;AAC/D,MAAM,MAAM,qBAAqB,GAC7B,QAAQ,GACR,UAAU,GACV,aAAa,GACb,cAAc,GACd,UAAU,GACV,WAAW,GACX,cAAc,GACd,YAAY,GACZ,QAAQ,GACR,YAAY,GACZ,eAAe,CAAC;AAEpB,mEAAmE;AACnE,MAAM,MAAM,sBAAsB,GAAG,SAAS,GAAG,UAAU,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,UAAU,GAAG,OAAO,GAAG,WAAW,CAAC;AAiB/H;;;;;;;;;;;;;GAaG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,qBAAqB,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,IAAI,CAQxG;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,sBAAsB,EAC9B,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,EACZ,cAAc,CAAC,EAAE,MAAM,IAAI,GAC1B,MAAM,IAAI,CAWZ;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CAAC,CAAC,EACvC,MAAM,EAAE,qBAAqB,EAC7B,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GACzB,OAAO,CAAC,CAAC,CAAC,CAOZ;AAED;;;;;;;;;GASG;AACH,wBAAgB,sBAAsB,CAAC,CAAC,EACtC,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GACzB,OAAO,CAAC,CAAC,CAAC,CAEZ"}