@gobing-ai/ts-runtime 0.3.20 → 0.3.22

package/dist/file-system-cf.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"file-system-cf.d.ts","sourceRoot":"","sources":["../src/file-system-cf.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAIhD;;;;;GAKG;AACH,wBAAgB,kBAAkB,IAAI,UAAU,CA8C/C"}
+{"version":3,"file":"file-system-cf.d.ts","sourceRoot":"","sources":["../src/file-system-cf.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAIhD;;;;;GAKG;AACH,wBAAgB,kBAAkB,IAAI,UAAU,CAkD/C"}

package/dist/file-system-cf.js

@@ -48,6 +48,9 @@ export function createCfFileSystem() {
         deleteFile: (_path) => {
             throw new Error(`FileSystem.deleteFile: ${UNSUPPORTED}`);
         },
+        rename: (_src, _dest) => {
+            throw new Error(`FileSystem.rename: ${UNSUPPORTED}`);
+        },
         createWriteStream: (_path) => {
             throw new Error(`FileSystem.createWriteStream: ${UNSUPPORTED}`);
         },

package/dist/file-system-node.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"file-system-node.d.ts","sourceRoot":"","sources":["../src/file-system-node.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAgBH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEhD;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,UAAU,CAuD9D;AAWD;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAaxD"}
+{"version":3,"file":"file-system-node.d.ts","sourceRoot":"","sources":["../src/file-system-node.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAiBH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEhD;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,UAAU,CA2D9D;AAWD;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAaxD"}

package/dist/file-system-node.js

@@ -9,7 +9,7 @@
  * `node:fs` fully, so this works on both runtimes without a Bun-specific
  * variant.
  */
-import { appendFileSync, cpSync, createWriteStream, existsSync, mkdirSync, readdirSync, readFileSync, rmSync, statSync, writeFileSync, } from 'node:fs';
+import { appendFileSync, cpSync, createWriteStream, existsSync, mkdirSync, readdirSync, readFileSync, renameSync, rmSync, statSync, writeFileSync, } from 'node:fs';
 import { dirname, resolve as resolvePath } from 'node:path';
 /**
  * Create a {@link FileSystem} backed by `node:fs`.
@@ -38,13 +38,16 @@ export function createNodeFileSystem(root) {
         deleteFile: (path) => {
             rmSync(path, { recursive: true, force: true });
         },
-        createWriteStream: (path) => {
-            ensureParentDir(path);
-            return createWriteStream(path, { flags: 'a' });
+        rename: (src, dest) => {
+            renameSync(src, dest);
         },
         copy: (src, dest) => {
             cpSync(src, dest, { recursive: true });
         },
+        createWriteStream: (path) => {
+            ensureParentDir(path);
+            return createWriteStream(path, { flags: 'a' });
+        },
         stat: (path) => {
             try {
                 const s = statSync(path);

package/dist/file-system.d.ts

@@ -30,6 +30,8 @@ export interface FileSystem {
     readDir(path: string): string[] | Promise<string[]>;
     /** Delete a file or directory recursively. */
     deleteFile(path: string): void | Promise<void>;
+    /** Atomically rename a file or directory. */
+    rename(src: string, dest: string): void | Promise<void>;
     /** Recursively copy a file or directory. */
     copy(src: string, dest: string): void | Promise<void>;
     /** Get file or directory stats. Returns `null` if the path doesn't exist. */

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

@@ -1 +1 @@
-{"version":3,"file":"file-system.d.ts","sourceRoot":"","sources":["../src/file-system.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,MAAM,WAAW,QAAQ;IACrB,MAAM,IAAI,OAAO,CAAC;IAClB,WAAW,IAAI,OAAO,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,UAAU;IACvB,mCAAmC;IACnC,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAEjD,+DAA+D;IAC/D,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAEjD,kEAAkE;IAClE,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE/D,iEAAiE;IACjE,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEhE,kFAAkF;IAClF,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE9C,2DAA2D;IAC3D,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAEpD,8CAA8C;IAC9C,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE/C,4CAA4C;IAC5C,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEtD,6EAA6E;IAC7E,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAC;IAE/D,6FAA6F;IAC7F,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG;QAAE,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,GAAG,IAAI,IAAI,CAAA;KAAE,CAAC;IAE7E,0DAA0D;IAC1D,OAAO,CAAC,GAAG,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC;IAEvC,2CAA2C;IAC3C,cAAc,IAAI,MAAM,CAAC;CAC5B"}
+{"version":3,"file":"file-system.d.ts","sourceRoot":"","sources":["../src/file-system.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,MAAM,WAAW,QAAQ;IACrB,MAAM,IAAI,OAAO,CAAC;IAClB,WAAW,IAAI,OAAO,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,UAAU;IACvB,mCAAmC;IACnC,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAEjD,+DAA+D;IAC/D,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAEjD,kEAAkE;IAClE,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE/D,iEAAiE;IACjE,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEhE,kFAAkF;IAClF,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE9C,2DAA2D;IAC3D,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAEpD,8CAA8C;IAC9C,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE/C,6CAA6C;IAC7C,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAExD,4CAA4C;IAC5C,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtD,6EAA6E;IAC7E,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAC;IAE/D,6FAA6F;IAC7F,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG;QAAE,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,GAAG,IAAI,IAAI,CAAA;KAAE,CAAC;IAE7E,0DAA0D;IAC1D,OAAO,CAAC,GAAG,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC;IAEvC,2CAA2C;IAC3C,cAAc,IAAI,MAAM,CAAC;CAC5B"}

package/dist/fs.d.ts

@@ -1,113 +1,24 @@
-/** Portable file stat interface — mirrors the subset of `node:fs.Stats` used by the runtime. */
-export interface FileStat {
-    isFile(): boolean;
-    isDirectory(): boolean;
-    size: number;
-    mtimeMs: number;
-}
-/** Write-only append stream for log output. */
-export interface LogStream {
-    write(chunk: string): void;
-    end(): void;
-}
-/** @deprecated Use {@link import('./file-system').FileSystem} instead — the new interface has union return types and does not require a separate SyncFileSystem. */
-export interface FileSystem {
-    readFile(path: string): Promise<string>;
-    writeFile(path: string, content: string): Promise<void>;
-    appendFile(path: string, content: string): Promise<void>;
-    mkdir(path: string): Promise<void>;
-    exists(path: string): Promise<boolean>;
-    readDir(path: string): Promise<string[]>;
-    unlink(path: string): Promise<void>;
-    stat(path: string): Promise<FileStat | null>;
-    realpath(path: string): Promise<string>;
-    copy(src: string, dest: string): Promise<void>;
-    rename(src: string, dest: string): Promise<void>;
-    createLogStream(path: string): LogStream;
-}
-/** @deprecated Use {@link import('./file-system').FileSystem} instead — its union return types make a separate sync interface unnecessary. */
-export interface SyncFileSystem {
-    readFile(path: string): string;
-    writeFile(path: string, content: string): void;
-    mkdir(path: string): void;
-    exists(path: string): boolean;
-    readDir(path: string): string[];
-    stat(path: string): FileStat | null;
-    unlink(path: string): void;
-}
-/** {@link FileSystem} backed by `node:fs/promises`. Lazy-loads the module to avoid top-level import cost. */
-/** @deprecated Use createNodeFileSystem() from './file-system-node' instead. */
-export declare class NodeFileSystem implements FileSystem {
-    readFile(path: string): Promise<string>;
-    writeFile(path: string, content: string): Promise<void>;
-    appendFile(path: string, content: string): Promise<void>;
-    mkdir(path: string): Promise<void>;
-    exists(path: string): Promise<boolean>;
-    readDir(path: string): Promise<string[]>;
-    unlink(path: string): Promise<void>;
-    stat(path: string): Promise<FileStat | null>;
-    realpath(path: string): Promise<string>;
-    copy(src: string, dest: string): Promise<void>;
-    rename(src: string, dest: string): Promise<void>;
-    createLogStream(path: string): LogStream;
-}
-/** {@link SyncFileSystem} backed by `node:fs` synchronous APIs. */
-/** @deprecated Use createNodeFileSystem() from './file-system-node' instead — its FileSystem interface has union return types, eliminating the need for a separate sync implementation. */
-export declare class NodeSyncFileSystem implements SyncFileSystem {
-    readFile(path: string): string;
-    writeFile(path: string, content: string): void;
-    mkdir(path: string): void;
-    exists(path: string): boolean;
-    readDir(path: string): string[];
-    stat(path: string): FileStat | null;
-    unlink(path: string): void;
-}
-/** {@link FileSystem} stub for Cloudflare Workers — all file operations throw. Use D1, KV, or R2 instead. */
-/** @deprecated Use createCfFileSystem() from './file-system-cf' instead. */
-export declare class CloudflareFileSystem implements FileSystem {
-    readFile(path: string): Promise<string>;
-    writeFile(path: string, _content: string): Promise<void>;
-    appendFile(path: string, _content: string): Promise<void>;
-    mkdir(_path: string): Promise<void>;
-    exists(_path: string): Promise<boolean>;
-    readDir(path: string): Promise<string[]>;
-    unlink(path: string): Promise<void>;
-    stat(_path: string): Promise<FileStat | null>;
-    realpath(path: string): Promise<string>;
-    copy(src: string, _dest: string): Promise<void>;
-    rename(src: string, _dest: string): Promise<void>;
-    createLogStream(path: string): LogStream;
-}
-/** Swaps the active global file system, returning a restore function for the previous instance. */
-/** @deprecated Use RuntimeFactory.createFileSystem() or ctx.require('fileSystem') instead. The global swap is replaced by factory-based DI. */
-export declare function setFileSystem(fileSystem: FileSystem): () => void;
-/** Returns the currently active global {@link FileSystem} instance. */
-/** @deprecated Use RuntimeFactory.createFileSystem() or ctx.require('fileSystem') instead. */
-export declare function getFs(): FileSystem;
+import type { FileSystem as CanonicalFileSystem } from './file-system';
 /** Creates parent directories for a file path before writing. */
-export declare function ensureDirForFile(path: string, fs?: FileSystem): Promise<void>;
-/** Synchronous variant of {@link ensureDirForFile}. */
-/** @deprecated The new createNodeFileSystem() handles parent-directory creation internally. */
-export declare function ensureDirForFileSync(path: string, fs: SyncFileSystem): void;
+export declare function ensureDirForFile(path: string, fs?: CanonicalFileSystem): Promise<void>;
 /** Atomically writes a file by writing to a temp path then renaming, avoiding partial writes on crash. */
-export declare function atomicWriteFile(path: string, content: string, fs?: FileSystem): Promise<void>;
+export declare function atomicWriteFile(path: string, content: string, fs?: CanonicalFileSystem): Promise<void>;
 /** Atomically writes a value as JSON with trailing newline. */
-export declare function atomicWriteJson(path: string, value: unknown, fs?: FileSystem): Promise<void>;
+export declare function atomicWriteJson(path: string, value: unknown, fs?: CanonicalFileSystem): Promise<void>;
 /** Reads and parses a JSON file. */
-export declare function readJsonFile<T = unknown>(path: string, fs?: FileSystem): Promise<T>;
+export declare function readJsonFile<T = unknown>(path: string, fs?: CanonicalFileSystem): Promise<T>;
 /** Writes a value as JSON with 2-space indentation and trailing newline. */
-export declare function writeJsonFile(path: string, value: unknown, fs?: FileSystem): Promise<void>;
-/** Recursively walks a directory, returning sorted paths to all files, optionally excluding entries by name. */
-export declare function walkDir(path: string, fs?: FileSystem, exclude?: Set<string>): Promise<string[]>;
+export declare function writeJsonFile(path: string, value: unknown, fs?: CanonicalFileSystem): Promise<void>;
+/**
+ * Recursively walks a directory, returning sorted paths to all files,
+ * optionally excluding entries by name.
+ */
+export declare function walkDir(path: string, fs?: CanonicalFileSystem, exclude?: Set<string>): Promise<string[]>;
 /**
- * Walks up from `startDir` looking for a `package.json` or `bun.lock` to locate the project root.
- *
- * @deprecated Use {@link import('./file-system-node').findProjectRoot} (or `createNodeFileSystem().getProjectRoot()`).
- * This delegates to the single shared implementation.
+ * Creates a writable stream for append-only output at the given path.
  */
-export declare function getProjectRoot(startDir?: string): string;
-/** Resolves path segments relative to the project root. */
-export declare function resolveProjectPath(...segments: string[]): string;
-/** Creates a {@link LogStream} at the given path using the active file system. */
-export declare function createLogStream(path: string, fs?: FileSystem): LogStream;
+export declare function createLogStream(path: string, fs?: CanonicalFileSystem): {
+    write(chunk: string): void;
+    end(): void;
+};
 //# sourceMappingURL=fs.d.ts.map

package/dist/fs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fs.d.ts","sourceRoot":"","sources":["../src/fs.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"fs.d.ts","sourceRoot":"","sources":["../src/fs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,IAAI,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAGvE,iEAAiE;AACjE,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,GAAE,mBAA4C,GAAG,OAAO,CAAC,IAAI,CAAC,CAEpH;AAED,0GAA0G;AAC1G,wBAAsB,eAAe,CACjC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,EAAE,GAAE,mBAA4C,GACjD,OAAO,CAAC,IAAI,CAAC,CAKf;AAED,+DAA+D;AAC/D,wBAAsB,eAAe,CACjC,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,OAAO,EACd,EAAE,GAAE,mBAA4C,GACjD,OAAO,CAAC,IAAI,CAAC,CAEf;AAED,oCAAoC;AACpC,wBAAsB,YAAY,CAAC,CAAC,GAAG,OAAO,EAC1C,IAAI,EAAE,MAAM,EACZ,EAAE,GAAE,mBAA4C,GACjD,OAAO,CAAC,CAAC,CAAC,CAEZ;AAED,4EAA4E;AAC5E,wBAAsB,aAAa,CAC/B,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,OAAO,EACd,EAAE,GAAE,mBAA4C,GACjD,OAAO,CAAC,IAAI,CAAC,CAEf;AAED;;;GAGG;AACH,wBAAsB,OAAO,CACzB,IAAI,EAAE,MAAM,EACZ,EAAE,GAAE,mBAA4C,EAChD,OAAO,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,GACtB,OAAO,CAAC,MAAM,EAAE,CAAC,CAcnB;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC3B,IAAI,EAAE,MAAM,EACZ,EAAE,GAAE,mBAA4C,GACjD;IAAE,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,GAAG,IAAI,IAAI,CAAA;CAAE,CAE7C"}

package/dist/fs.js

@@ -1,247 +1,33 @@
-import { mkdirSync, readdirSync, readFileSync, rmSync, statSync, writeFileSync } from 'node:fs';
-import { findProjectRoot } from './file-system-node.js';
-import { dirnamePath, getProcessCwd, joinPath, resolvePath } from './path.js';
-let fsPromisesModule = null;
-let fsModule = null;
-function nodeFsPromises() {
-    fsPromisesModule ??= import('node:fs/promises');
-    return fsPromisesModule;
-}
-function nodeFs() {
-    fsModule ??= import('node:fs');
-    return fsModule;
-}
-/** {@link FileSystem} backed by `node:fs/promises`. Lazy-loads the module to avoid top-level import cost. */
-/** @deprecated Use createNodeFileSystem() from './file-system-node.js' instead. */
-export class NodeFileSystem {
-    async readFile(path) {
-        const { readFile } = await nodeFsPromises();
-        return await readFile(path, 'utf-8');
-    }
-    async writeFile(path, content) {
-        const { writeFile } = await nodeFsPromises();
-        await ensureDirForFile(path, this);
-        await writeFile(path, content, 'utf-8');
-    }
-    async appendFile(path, content) {
-        const { appendFile } = await nodeFsPromises();
-        await ensureDirForFile(path, this);
-        await appendFile(path, content, 'utf-8');
-    }
-    async mkdir(path) {
-        const { mkdir } = await nodeFsPromises();
-        await mkdir(path, { recursive: true });
-    }
-    async exists(path) {
-        const { access } = await nodeFsPromises();
-        try {
-            await access(path);
-            return true;
-        }
-        catch {
-            return false;
-        }
-    }
-    async readDir(path) {
-        const { readdir } = await nodeFsPromises();
-        return await readdir(path);
-    }
-    async unlink(path) {
-        const { rm } = await nodeFsPromises();
-        await rm(path, { recursive: true, force: true });
-    }
-    async stat(path) {
-        const { stat } = await nodeFsPromises();
-        try {
-            const value = await stat(path);
-            return {
-                isFile: () => value.isFile(),
-                isDirectory: () => value.isDirectory(),
-                size: value.size,
-                mtimeMs: value.mtimeMs,
-            };
-        }
-        catch {
-            return null;
-        }
-    }
-    async realpath(path) {
-        const { realpath } = await nodeFsPromises();
-        return await realpath(path);
-    }
-    async copy(src, dest) {
-        const { cp } = await nodeFsPromises();
-        await cp(src, dest, { recursive: true });
-    }
-    async rename(src, dest) {
-        const { rename } = await nodeFsPromises();
-        await rename(src, dest);
-    }
-    createLogStream(path) {
-        return new LazyNodeLogStream(path);
-    }
-}
-/** {@link SyncFileSystem} backed by `node:fs` synchronous APIs. */
-/** @deprecated Use createNodeFileSystem() from './file-system-node.js' instead — its FileSystem interface has union return types, eliminating the need for a separate sync implementation. */
-export class NodeSyncFileSystem {
-    readFile(path) {
-        return readFileSync(path, 'utf-8');
-    }
-    writeFile(path, content) {
-        ensureDirForFileSync(path, this);
-        writeFileSync(path, content, 'utf-8');
-    }
-    mkdir(path) {
-        mkdirSync(path, { recursive: true });
-    }
-    exists(path) {
-        try {
-            return this.stat(path) !== null;
-        }
-        catch {
-            return false;
-        }
-    }
-    readDir(path) {
-        return readdirSync(path);
-    }
-    stat(path) {
-        try {
-            const value = statSync(path);
-            return {
-                isFile: () => value.isFile(),
-                isDirectory: () => value.isDirectory(),
-                size: value.size,
-                mtimeMs: value.mtimeMs,
-            };
-        }
-        catch {
-            return null;
-        }
-    }
-    unlink(path) {
-        rmSync(path, { recursive: true, force: true });
-    }
-}
-class LazyNodeLogStream {
-    ready;
-    ended = false;
-    // Single serialized chain: every write/end is appended here, so the underlying stream observes
-    // them in call order regardless of how the resolving microtasks interleave. A per-write `shift()`
-    // off a shared buffer (the previous approach) could reorder writes that arrived in the same tick.
-    tail;
-    constructor(path) {
-        this.ready = nodeFs().then(({ createWriteStream, mkdirSync }) => {
-            mkdirSync(dirnamePath(path), { recursive: true });
-            const stream = createWriteStream(path, { flags: 'a' });
-            return {
-                write: (chunk) => stream.write(chunk),
-                end: () => stream.end(),
-            };
-        });
-        this.tail = this.ready;
-    }
-    write(chunk) {
-        if (this.ended)
-            return;
-        this.tail = this.tail.then(() => this.ready.then((stream) => stream.write(chunk)));
-    }
-    end() {
-        if (this.ended)
-            return;
-        this.ended = true;
-        this.tail = this.tail.then(() => this.ready.then((stream) => stream.end()));
-    }
-}
-const CLOUDFLARE_FS_ERROR = 'FileSystem is not available on Cloudflare Workers. Use D1, KV, or R2.';
-/** {@link FileSystem} stub for Cloudflare Workers — all file operations throw. Use D1, KV, or R2 instead. */
-/** @deprecated Use createCfFileSystem() from './file-system-cf.js' instead. */
-export class CloudflareFileSystem {
-    async readFile(path) {
-        throw unsupportedCloudflareFs('readFile', path);
-    }
-    async writeFile(path, _content) {
-        throw unsupportedCloudflareFs('writeFile', path);
-    }
-    async appendFile(path, _content) {
-        throw unsupportedCloudflareFs('appendFile', path);
-    }
-    async mkdir(_path) {
-        return;
-    }
-    async exists(_path) {
-        return false;
-    }
-    async readDir(path) {
-        throw unsupportedCloudflareFs('readDir', path);
-    }
-    async unlink(path) {
-        throw unsupportedCloudflareFs('unlink', path);
-    }
-    async stat(_path) {
-        return null;
-    }
-    async realpath(path) {
-        return resolveProjectPath(path);
-    }
-    async copy(src, _dest) {
-        throw unsupportedCloudflareFs('copy', src);
-    }
-    async rename(src, _dest) {
-        throw unsupportedCloudflareFs('rename', src);
-    }
-    createLogStream(path) {
-        throw unsupportedCloudflareFs('createLogStream', path);
-    }
-}
-function unsupportedCloudflareFs(operation, path) {
-    return new Error(`CloudflareFileSystem.${operation} failed for "${path}": ${CLOUDFLARE_FS_ERROR}`);
-}
-let activeFileSystem = new NodeFileSystem();
-/** Swaps the active global file system, returning a restore function for the previous instance. */
-/** @deprecated Use RuntimeFactory.createFileSystem() or ctx.require('fileSystem') instead. The global swap is replaced by factory-based DI. */
-export function setFileSystem(fileSystem) {
-    const previous = activeFileSystem;
-    activeFileSystem = fileSystem;
-    return () => {
-        activeFileSystem = previous;
-    };
-}
-/** Returns the currently active global {@link FileSystem} instance. */
-/** @deprecated Use RuntimeFactory.createFileSystem() or ctx.require('fileSystem') instead. */
-export function getFs() {
-    return activeFileSystem;
-}
+import { createNodeFileSystem } from './file-system-node.js';
+import { dirnamePath, joinPath } from './path.js';
 /** Creates parent directories for a file path before writing. */
-export async function ensureDirForFile(path, fs = getFs()) {
-    await fs.mkdir(dirnamePath(path));
-}
-/** Synchronous variant of {@link ensureDirForFile}. */
-/** @deprecated The new createNodeFileSystem() handles parent-directory creation internally. */
-export function ensureDirForFileSync(path, fs) {
-    fs.mkdir(dirnamePath(path));
+export async function ensureDirForFile(path, fs = createNodeFileSystem()) {
+    await fs.ensureDir(dirnamePath(path));
 }
 /** Atomically writes a file by writing to a temp path then renaming, avoiding partial writes on crash. */
-export async function atomicWriteFile(path, content, fs = getFs()) {
+export async function atomicWriteFile(path, content, fs = createNodeFileSystem()) {
     await ensureDirForFile(path, fs);
     const tempPath = `${path}.${getProcessPid()}.${uniqueToken()}.tmp`;
     await fs.writeFile(tempPath, content);
     await fs.rename(tempPath, path);
 }
 /** Atomically writes a value as JSON with trailing newline. */
-export async function atomicWriteJson(path, value, fs = getFs()) {
+export async function atomicWriteJson(path, value, fs = createNodeFileSystem()) {
     await atomicWriteFile(path, `${JSON.stringify(value, null, 2)}\n`, fs);
 }
 /** Reads and parses a JSON file. */
-export async function readJsonFile(path, fs = getFs()) {
+export async function readJsonFile(path, fs = createNodeFileSystem()) {
     return JSON.parse(await fs.readFile(path));
 }
 /** Writes a value as JSON with 2-space indentation and trailing newline. */
-export async function writeJsonFile(path, value, fs = getFs()) {
+export async function writeJsonFile(path, value, fs = createNodeFileSystem()) {
     await fs.writeFile(path, `${JSON.stringify(value, null, 2)}\n`);
 }
-/** Recursively walks a directory, returning sorted paths to all files, optionally excluding entries by name. */
-export async function walkDir(path, fs = getFs(), exclude) {
+/**
+ * Recursively walks a directory, returning sorted paths to all files,
+ * optionally excluding entries by name.
+ */
+export async function walkDir(path, fs = createNodeFileSystem(), exclude) {
     const entries = (await fs.readDir(path)).sort();
     const result = [];
     for (const entry of entries) {
@@ -259,27 +45,14 @@ export async function walkDir(path, fs = getFs(), exclude) {
     return result;
 }
 /**
- * Walks up from `startDir` looking for a `package.json` or `bun.lock` to locate the project root.
- *
- * @deprecated Use {@link import('./file-system-node.js').findProjectRoot} (or `createNodeFileSystem().getProjectRoot()`).
- * This delegates to the single shared implementation.
+ * Creates a writable stream for append-only output at the given path.
  */
-export function getProjectRoot(startDir = getProcessCwd()) {
-    return findProjectRoot(startDir);
-}
-/** Resolves path segments relative to the project root. */
-export function resolveProjectPath(...segments) {
-    return resolvePath(getProjectRoot(), ...segments);
-}
-/** Creates a {@link LogStream} at the given path using the active file system. */
-export function createLogStream(path, fs = getFs()) {
-    return fs.createLogStream(path);
+export function createLogStream(path, fs = createNodeFileSystem()) {
+    return fs.createWriteStream(path);
 }
 function getProcessPid() {
     return globalThis.process?.pid ?? 0;
 }
-// Two writers to the same path in the same millisecond must not share a temp name, or one clobbers
-// the other before rename. randomUUID disambiguates; Date.now keeps names sortable for debugging.
 function uniqueToken() {
     return `${Date.now()}.${crypto.randomUUID()}`;
 }

package/dist/index.d.ts

@@ -5,7 +5,7 @@ export { D1NotConfiguredError } from './db-errors';
 export type { FileStat, FileSystem } from './file-system';
 export { createCfFileSystem } from './file-system-cf';
 export { createNodeFileSystem, findProjectRoot } from './file-system-node';
-export { atomicWriteFile, atomicWriteJson, CloudflareFileSystem, createLogStream, ensureDirForFile, ensureDirForFileSync, type FileSystem as LegacyFileSystem, getFs, getProjectRoot, NodeFileSystem, NodeSyncFileSystem, readJsonFile, resolveProjectPath, type SyncFileSystem, setFileSystem, walkDir, writeJsonFile, } from './fs';
+export { atomicWriteFile, atomicWriteJson, createLogStream, ensureDirForFile, readJsonFile, walkDir, writeJsonFile, } from './fs';
 export * from './path';
 export { _resetRuntimeFactory, isCloudflareWorkerRuntime, loadRuntimeFactory } from './platform';
 export type { OutputPolicy, PipeProcess, PipeProcessOptions, ProcessEventDetail, ProcessEventSink, ProcessEvents, ProcessExecutorConfig, ProcessExitReason, ProcessOptions, ProcessResult, ProcessSignal, TracerPort, } from './process-executor';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,OAAO,EAAE,+BAA+B,EAAE,MAAM,WAAW,CAAC;AAC5D,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACnD,YAAY,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC3E,OAAO,EACH,eAAe,EACf,eAAe,EACf,oBAAoB,EACpB,eAAe,EACf,gBAAgB,EAChB,oBAAoB,EACpB,KAAK,UAAU,IAAI,gBAAgB,EACnC,KAAK,EACL,cAAc,EACd,cAAc,EACd,kBAAkB,EAClB,YAAY,EACZ,kBAAkB,EAClB,KAAK,cAAc,EACnB,aAAa,EACb,OAAO,EACP,aAAa,GAChB,MAAM,MAAM,CAAC;AACd,cAAc,QAAQ,CAAC;AACvB,OAAO,EAAE,oBAAoB,EAAE,yBAAyB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AACjG,YAAY,EACR,YAAY,EACZ,WAAW,EACX,kBAAkB,EAClB,kBAAkB,EAClB,gBAAgB,EAChB,aAAa,EACb,qBAAqB,EACrB,iBAAiB,EACjB,cAAc,EACd,aAAa,EACb,aAAa,EACb,UAAU,GACb,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC;AACxD,YAAY,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAC1E,cAAc,qBAAqB,CAAC;AACpC,cAAc,SAAS,CAAC;AAIxB,OAAO,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAExG;;;GAGG;AACH,MAAM,MAAM,mBAAmB,GAAG,YAAY,CAAC,cAAc,oBAAoB,EAAE,sBAAsB,CAAC,CAAC;AAE3G;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,YAAY,CAAC,cAAc,oBAAoB,EAAE,qBAAqB,CAAC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,OAAO,EAAE,+BAA+B,EAAE,MAAM,WAAW,CAAC;AAC5D,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACnD,YAAY,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC3E,OAAO,EACH,eAAe,EACf,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,YAAY,EACZ,OAAO,EACP,aAAa,GAChB,MAAM,MAAM,CAAC;AACd,cAAc,QAAQ,CAAC;AACvB,OAAO,EAAE,oBAAoB,EAAE,yBAAyB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AACjG,YAAY,EACR,YAAY,EACZ,WAAW,EACX,kBAAkB,EAClB,kBAAkB,EAClB,gBAAgB,EAChB,aAAa,EACb,qBAAqB,EACrB,iBAAiB,EACjB,cAAc,EACd,aAAa,EACb,aAAa,EACb,UAAU,GACb,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC;AACxD,YAAY,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAC1E,cAAc,qBAAqB,CAAC;AACpC,cAAc,SAAS,CAAC;AAIxB,OAAO,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAExG;;;GAGG;AACH,MAAM,MAAM,mBAAmB,GAAG,YAAY,CAAC,cAAc,oBAAoB,EAAE,sBAAsB,CAAC,CAAC;AAE3G;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,YAAY,CAAC,cAAc,oBAAoB,EAAE,qBAAqB,CAAC,CAAC"}

package/dist/index.js

@@ -4,7 +4,7 @@ export { createRuntimeContextFromFactory } from './context.js';
 export { D1NotConfiguredError } from './db-errors.js';
 export { createCfFileSystem } from './file-system-cf.js';
 export { createNodeFileSystem, findProjectRoot } from './file-system-node.js';
-export { atomicWriteFile, atomicWriteJson, CloudflareFileSystem, createLogStream, ensureDirForFile, ensureDirForFileSync, getFs, getProjectRoot, NodeFileSystem, NodeSyncFileSystem, readJsonFile, resolveProjectPath, setFileSystem, walkDir, writeJsonFile, } from './fs.js';
+export { atomicWriteFile, atomicWriteJson, createLogStream, ensureDirForFile, readJsonFile, walkDir, writeJsonFile, } from './fs.js';
 export * from './path.js';
 export { _resetRuntimeFactory, isCloudflareWorkerRuntime, loadRuntimeFactory } from './platform.js';
 export { ProcessExecutor } from './process-executor.js';

package/dist/process-executor.d.ts

@@ -24,6 +24,8 @@ export interface ProcessOptions {
     label?: string;
     rejectOnError?: boolean;
     forceBuffered?: boolean;
+    /** AbortSignal forwarded to execa as `cancelSignal` — aborts the child process when fired. */
+    signal?: AbortSignal;
 }
 /** Result of a completed child process, including exit code, captured output, and duration. */
 export interface ProcessResult {

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

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

package/dist/process-executor.js

@@ -29,6 +29,7 @@ export class ProcessExecutor {
             rejectOnError: options.rejectOnError ?? false,
             outputPolicy: this.config.output,
             forceBuffered: options.forceBuffered ?? false,
+            signal: options.signal,
         });
         const startedAt = Date.now();
         this.emitProcessEvent('process.started', {
@@ -291,6 +292,7 @@ function buildExecaOptions(opts) {
         ...(opts.env !== undefined ? { env: opts.env } : {}),
         ...(opts.timeout !== undefined ? { timeout: opts.timeout } : {}),
         ...(opts.maxOutput !== undefined ? { maxBuffer: opts.maxOutput } : {}),
+        ...(opts.signal !== undefined ? { cancelSignal: opts.signal } : {}),
     };
 }
 function asString(value) {

package/dist/schema-validation.d.ts

@@ -35,10 +35,10 @@ export interface StructuredConfigLoadOptions {
      */
     resolve?: (specifier: string, from: string) => string;
     /**
-     * File system used to read the config and local schema files. Defaults to the
-     * deprecated `getFs()` global; supply a {@link FileSystem} from the runtime factory
-     * (`createNodeFileSystem()`) to route reads through the factory path or to inject a
-     * virtual file system in tests.
+     * File system used to read the config and local schema files. Defaults to
+     * `createNodeFileSystem()`; supply a {@link FileSystem} from the runtime factory
+     * to route reads through a different adapter or to inject a virtual file system
+     * in tests.
      */
     fileSystem?: Pick<FileSystem, 'readFile'>;
 }

package/dist/schema-validation.js

@@ -1,5 +1,5 @@
 import { parse as parseYaml } from 'yaml';
-import { getFs } from './fs.js';
+import { createNodeFileSystem } from './file-system-node.js';
 import { dirnamePath, getProcessCwd, isAbsolutePath, joinPath } from './path.js';
 /** Default time budget for a single remote schema fetch. */
 const REMOTE_SCHEMA_FETCH_TIMEOUT_MS = 5_000;
@@ -16,7 +16,7 @@ export class StructuredConfigSchemaError extends Error {
 }
 /** Reads a config file from disk, parses it (YAML or JSON), and validates against its declared `$schema`. */
 export async function loadStructuredConfig(path, options = {}) {
-    const content = await (options.fileSystem ?? getFs()).readFile(path);
+    const content = await (options.fileSystem ?? createNodeFileSystem()).readFile(path);
     return await parseStructuredConfig(content, path, options);
 }
 /** Parses a config string (YAML or JSON) and validates against its declared `$schema` if present. */
@@ -216,7 +216,7 @@ async function readSchema(schemaLocation, options) {
         }
         return await readBoundedBody(response, schemaLocation);
     }
-    return await (options.fileSystem ?? getFs()).readFile(schemaLocation);
+    return await (options.fileSystem ?? createNodeFileSystem()).readFile(schemaLocation);
 }
 /**
  * Read a response body under a hard byte cap. `Content-Length` is a fast-path reject, but servers

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@gobing-ai/ts-runtime",
-    "version": "0.3.20",
+    "version": "0.3.22",
     "description": "@gobing-ai/ts-runtime — Runtime abstractions for Bun, Node, and Cloudflare Workers.",
     "keywords": [
         "typescript",
@@ -58,13 +58,13 @@
         "release": "echo 'Manual publish is disabled. Releases go through GitHub Actions via Trusted Publishing — push a tag: git tag @gobing-ai/ts-runtime-v<version> && git push --tags' && exit 1"
     },
     "dependencies": {
-        "@gobing-ai/ts-utils": "^0.3.20",
+        "@gobing-ai/ts-utils": "^0.3.22",
         "execa": "^9.5.0",
         "yaml": "^2.7.0",
         "zod": "^4.1.0"
     },
     "devDependencies": {
-        "@gobing-ai/ts-db": "^0.3.20",
+        "@gobing-ai/ts-db": "^0.3.22",
         "@types/bun": "1.3.14"
     },
     "publishConfig": {

package/src/file-system-cf.ts

@@ -61,6 +61,10 @@ export function createCfFileSystem(): FileSystem {
             throw new Error(`FileSystem.deleteFile: ${UNSUPPORTED}`);
         },
 
+        rename: (_src: string, _dest: string): never => {
+            throw new Error(`FileSystem.rename: ${UNSUPPORTED}`);
+        },
+
         createWriteStream: (_path: string): never => {
             throw new Error(`FileSystem.createWriteStream: ${UNSUPPORTED}`);
         },

package/src/file-system-node.ts

@@ -18,6 +18,7 @@ import {
     mkdirSync,
     readdirSync,
     readFileSync,
+    renameSync,
     rmSync,
     statSync,
     writeFileSync,
@@ -63,15 +64,19 @@ export function createNodeFileSystem(root?: string): FileSystem {
             rmSync(path, { recursive: true, force: true });
         },
 
-        createWriteStream: (path: string) => {
-            ensureParentDir(path);
-            return createWriteStream(path, { flags: 'a' });
+        rename: (src: string, dest: string) => {
+            renameSync(src, dest);
         },
 
         copy: (src: string, dest: string) => {
             cpSync(src, dest, { recursive: true });
         },
 
+        createWriteStream: (path: string) => {
+            ensureParentDir(path);
+            return createWriteStream(path, { flags: 'a' });
+        },
+
         stat: (path: string) => {
             try {
                 const s = statSync(path);

package/src/file-system.ts

@@ -38,9 +38,11 @@ export interface FileSystem {
     /** Delete a file or directory recursively. */
     deleteFile(path: string): void | Promise<void>;
 
+    /** Atomically rename a file or directory. */
+    rename(src: string, dest: string): void | Promise<void>;
+
     /** Recursively copy a file or directory. */
     copy(src: string, dest: string): void | Promise<void>;
-
     /** Get file or directory stats. Returns `null` if the path doesn't exist. */
     stat(path: string): FileStat | null | Promise<FileStat | null>;
 

package/src/fs.ts

@@ -1,315 +1,17 @@
-import { mkdirSync, readdirSync, readFileSync, rmSync, statSync, writeFileSync } from 'node:fs';
-import { findProjectRoot } from './file-system-node';
-import { dirnamePath, getProcessCwd, joinPath, resolvePath } from './path';
-
-/** Portable file stat interface — mirrors the subset of `node:fs.Stats` used by the runtime. */
-export interface FileStat {
-    isFile(): boolean;
-    isDirectory(): boolean;
-    size: number;
-    mtimeMs: number;
-}
-
-/** Write-only append stream for log output. */
-export interface LogStream {
-    write(chunk: string): void;
-    end(): void;
-}
-
-/** @deprecated Use {@link import('./file-system').FileSystem} instead — the new interface has union return types and does not require a separate SyncFileSystem. */
-export interface FileSystem {
-    readFile(path: string): Promise<string>;
-    writeFile(path: string, content: string): Promise<void>;
-    appendFile(path: string, content: string): Promise<void>;
-    mkdir(path: string): Promise<void>;
-    exists(path: string): Promise<boolean>;
-    readDir(path: string): Promise<string[]>;
-    unlink(path: string): Promise<void>;
-    stat(path: string): Promise<FileStat | null>;
-    realpath(path: string): Promise<string>;
-    copy(src: string, dest: string): Promise<void>;
-    rename(src: string, dest: string): Promise<void>;
-    createLogStream(path: string): LogStream;
-}
-
-/** @deprecated Use {@link import('./file-system').FileSystem} instead — its union return types make a separate sync interface unnecessary. */
-export interface SyncFileSystem {
-    readFile(path: string): string;
-    writeFile(path: string, content: string): void;
-    mkdir(path: string): void;
-    exists(path: string): boolean;
-    readDir(path: string): string[];
-    stat(path: string): FileStat | null;
-    unlink(path: string): void;
-}
-
-type NodeFsPromises = typeof import('node:fs/promises');
-type NodeFs = typeof import('node:fs');
-
-let fsPromisesModule: Promise<NodeFsPromises> | null = null;
-let fsModule: Promise<NodeFs> | null = null;
-
-function nodeFsPromises(): Promise<NodeFsPromises> {
-    fsPromisesModule ??= import('node:fs/promises');
-    return fsPromisesModule;
-}
-
-function nodeFs(): Promise<NodeFs> {
-    fsModule ??= import('node:fs');
-    return fsModule;
-}
-
-/** {@link FileSystem} backed by `node:fs/promises`. Lazy-loads the module to avoid top-level import cost. */
-/** @deprecated Use createNodeFileSystem() from './file-system-node' instead. */
-export class NodeFileSystem implements FileSystem {
-    async readFile(path: string): Promise<string> {
-        const { readFile } = await nodeFsPromises();
-        return await readFile(path, 'utf-8');
-    }
-
-    async writeFile(path: string, content: string): Promise<void> {
-        const { writeFile } = await nodeFsPromises();
-        await ensureDirForFile(path, this);
-        await writeFile(path, content, 'utf-8');
-    }
-
-    async appendFile(path: string, content: string): Promise<void> {
-        const { appendFile } = await nodeFsPromises();
-        await ensureDirForFile(path, this);
-        await appendFile(path, content, 'utf-8');
-    }
-
-    async mkdir(path: string): Promise<void> {
-        const { mkdir } = await nodeFsPromises();
-        await mkdir(path, { recursive: true });
-    }
-
-    async exists(path: string): Promise<boolean> {
-        const { access } = await nodeFsPromises();
-        try {
-            await access(path);
-            return true;
-        } catch {
-            return false;
-        }
-    }
-
-    async readDir(path: string): Promise<string[]> {
-        const { readdir } = await nodeFsPromises();
-        return await readdir(path);
-    }
-
-    async unlink(path: string): Promise<void> {
-        const { rm } = await nodeFsPromises();
-        await rm(path, { recursive: true, force: true });
-    }
-
-    async stat(path: string): Promise<FileStat | null> {
-        const { stat } = await nodeFsPromises();
-        try {
-            const value = await stat(path);
-            return {
-                isFile: () => value.isFile(),
-                isDirectory: () => value.isDirectory(),
-                size: value.size,
-                mtimeMs: value.mtimeMs,
-            };
-        } catch {
-            return null;
-        }
-    }
-
-    async realpath(path: string): Promise<string> {
-        const { realpath } = await nodeFsPromises();
-        return await realpath(path);
-    }
-
-    async copy(src: string, dest: string): Promise<void> {
-        const { cp } = await nodeFsPromises();
-        await cp(src, dest, { recursive: true });
-    }
-
-    async rename(src: string, dest: string): Promise<void> {
-        const { rename } = await nodeFsPromises();
-        await rename(src, dest);
-    }
-
-    createLogStream(path: string): LogStream {
-        return new LazyNodeLogStream(path);
-    }
-}
-
-/** {@link SyncFileSystem} backed by `node:fs` synchronous APIs. */
-/** @deprecated Use createNodeFileSystem() from './file-system-node' instead — its FileSystem interface has union return types, eliminating the need for a separate sync implementation. */
-export class NodeSyncFileSystem implements SyncFileSystem {
-    readFile(path: string): string {
-        return readFileSync(path, 'utf-8');
-    }
-
-    writeFile(path: string, content: string): void {
-        ensureDirForFileSync(path, this);
-        writeFileSync(path, content, 'utf-8');
-    }
-
-    mkdir(path: string): void {
-        mkdirSync(path, { recursive: true });
-    }
-
-    exists(path: string): boolean {
-        try {
-            return this.stat(path) !== null;
-        } catch {
-            return false;
-        }
-    }
-
-    readDir(path: string): string[] {
-        return readdirSync(path);
-    }
-
-    stat(path: string): FileStat | null {
-        try {
-            const value = statSync(path);
-            return {
-                isFile: () => value.isFile(),
-                isDirectory: () => value.isDirectory(),
-                size: value.size,
-                mtimeMs: value.mtimeMs,
-            };
-        } catch {
-            return null;
-        }
-    }
-
-    unlink(path: string): void {
-        rmSync(path, { recursive: true, force: true });
-    }
-}
-
-class LazyNodeLogStream implements LogStream {
-    private readonly ready: Promise<{
-        write: (chunk: string) => void;
-        end: () => void;
-    }>;
-    private ended = false;
-    // Single serialized chain: every write/end is appended here, so the underlying stream observes
-    // them in call order regardless of how the resolving microtasks interleave. A per-write `shift()`
-    // off a shared buffer (the previous approach) could reorder writes that arrived in the same tick.
-    private tail: Promise<unknown>;
-
-    constructor(path: string) {
-        this.ready = nodeFs().then(({ createWriteStream, mkdirSync }) => {
-            mkdirSync(dirnamePath(path), { recursive: true });
-            const stream = createWriteStream(path, { flags: 'a' });
-            return {
-                write: (chunk: string) => stream.write(chunk),
-                end: () => stream.end(),
-            };
-        });
-        this.tail = this.ready;
-    }
-
-    write(chunk: string): void {
-        if (this.ended) return;
-        this.tail = this.tail.then(() => this.ready.then((stream) => stream.write(chunk)));
-    }
-
-    end(): void {
-        if (this.ended) return;
-        this.ended = true;
-        this.tail = this.tail.then(() => this.ready.then((stream) => stream.end()));
-    }
-}
-
-const CLOUDFLARE_FS_ERROR = 'FileSystem is not available on Cloudflare Workers. Use D1, KV, or R2.';
-
-/** {@link FileSystem} stub for Cloudflare Workers — all file operations throw. Use D1, KV, or R2 instead. */
-/** @deprecated Use createCfFileSystem() from './file-system-cf' instead. */
-export class CloudflareFileSystem implements FileSystem {
-    async readFile(path: string): Promise<string> {
-        throw unsupportedCloudflareFs('readFile', path);
-    }
-
-    async writeFile(path: string, _content: string): Promise<void> {
-        throw unsupportedCloudflareFs('writeFile', path);
-    }
-
-    async appendFile(path: string, _content: string): Promise<void> {
-        throw unsupportedCloudflareFs('appendFile', path);
-    }
-
-    async mkdir(_path: string): Promise<void> {
-        return;
-    }
-
-    async exists(_path: string): Promise<boolean> {
-        return false;
-    }
-
-    async readDir(path: string): Promise<string[]> {
-        throw unsupportedCloudflareFs('readDir', path);
-    }
-
-    async unlink(path: string): Promise<void> {
-        throw unsupportedCloudflareFs('unlink', path);
-    }
-
-    async stat(_path: string): Promise<FileStat | null> {
-        return null;
-    }
-
-    async realpath(path: string): Promise<string> {
-        return resolveProjectPath(path);
-    }
-
-    async copy(src: string, _dest: string): Promise<void> {
-        throw unsupportedCloudflareFs('copy', src);
-    }
-
-    async rename(src: string, _dest: string): Promise<void> {
-        throw unsupportedCloudflareFs('rename', src);
-    }
-
-    createLogStream(path: string): LogStream {
-        throw unsupportedCloudflareFs('createLogStream', path);
-    }
-}
-
-function unsupportedCloudflareFs(operation: string, path: string): Error {
-    return new Error(`CloudflareFileSystem.${operation} failed for "${path}": ${CLOUDFLARE_FS_ERROR}`);
-}
-
-let activeFileSystem: FileSystem = new NodeFileSystem();
-
-/** Swaps the active global file system, returning a restore function for the previous instance. */
-/** @deprecated Use RuntimeFactory.createFileSystem() or ctx.require('fileSystem') instead. The global swap is replaced by factory-based DI. */
-export function setFileSystem(fileSystem: FileSystem): () => void {
-    const previous = activeFileSystem;
-    activeFileSystem = fileSystem;
-    return () => {
-        activeFileSystem = previous;
-    };
-}
-
-/** Returns the currently active global {@link FileSystem} instance. */
-/** @deprecated Use RuntimeFactory.createFileSystem() or ctx.require('fileSystem') instead. */
-export function getFs(): FileSystem {
-    return activeFileSystem;
-}
-
+import type { FileSystem as CanonicalFileSystem } from './file-system';
+import { createNodeFileSystem } from './file-system-node';
+import { dirnamePath, joinPath } from './path';
 /** Creates parent directories for a file path before writing. */
-export async function ensureDirForFile(path: string, fs = getFs()): Promise<void> {
-    await fs.mkdir(dirnamePath(path));
-}
-
-/** Synchronous variant of {@link ensureDirForFile}. */
-/** @deprecated The new createNodeFileSystem() handles parent-directory creation internally. */
-export function ensureDirForFileSync(path: string, fs: SyncFileSystem): void {
-    fs.mkdir(dirnamePath(path));
+export async function ensureDirForFile(path: string, fs: CanonicalFileSystem = createNodeFileSystem()): Promise<void> {
+    await fs.ensureDir(dirnamePath(path));
 }
 
 /** Atomically writes a file by writing to a temp path then renaming, avoiding partial writes on crash. */
-export async function atomicWriteFile(path: string, content: string, fs = getFs()): Promise<void> {
+export async function atomicWriteFile(
+    path: string,
+    content: string,
+    fs: CanonicalFileSystem = createNodeFileSystem(),
+): Promise<void> {
     await ensureDirForFile(path, fs);
     const tempPath = `${path}.${getProcessPid()}.${uniqueToken()}.tmp`;
     await fs.writeFile(tempPath, content);
@@ -317,22 +19,40 @@ export async function atomicWriteFile(path: string, content: string, fs = getFs(
 }
 
 /** Atomically writes a value as JSON with trailing newline. */
-export async function atomicWriteJson(path: string, value: unknown, fs = getFs()): Promise<void> {
+export async function atomicWriteJson(
+    path: string,
+    value: unknown,
+    fs: CanonicalFileSystem = createNodeFileSystem(),
+): Promise<void> {
     await atomicWriteFile(path, `${JSON.stringify(value, null, 2)}\n`, fs);
 }
 
 /** Reads and parses a JSON file. */
-export async function readJsonFile<T = unknown>(path: string, fs = getFs()): Promise<T> {
+export async function readJsonFile<T = unknown>(
+    path: string,
+    fs: CanonicalFileSystem = createNodeFileSystem(),
+): Promise<T> {
     return JSON.parse(await fs.readFile(path)) as T;
 }
 
 /** Writes a value as JSON with 2-space indentation and trailing newline. */
-export async function writeJsonFile(path: string, value: unknown, fs = getFs()): Promise<void> {
+export async function writeJsonFile(
+    path: string,
+    value: unknown,
+    fs: CanonicalFileSystem = createNodeFileSystem(),
+): Promise<void> {
     await fs.writeFile(path, `${JSON.stringify(value, null, 2)}\n`);
 }
 
-/** Recursively walks a directory, returning sorted paths to all files, optionally excluding entries by name. */
-export async function walkDir(path: string, fs = getFs(), exclude?: Set<string>): Promise<string[]> {
+/**
+ * Recursively walks a directory, returning sorted paths to all files,
+ * optionally excluding entries by name.
+ */
+export async function walkDir(
+    path: string,
+    fs: CanonicalFileSystem = createNodeFileSystem(),
+    exclude?: Set<string>,
+): Promise<string[]> {
     const entries = (await fs.readDir(path)).sort();
     const result: string[] = [];
     for (const entry of entries) {
@@ -349,31 +69,19 @@ export async function walkDir(path: string, fs = getFs(), exclude?: Set<string>)
 }
 
 /**
- * Walks up from `startDir` looking for a `package.json` or `bun.lock` to locate the project root.
- *
- * @deprecated Use {@link import('./file-system-node').findProjectRoot} (or `createNodeFileSystem().getProjectRoot()`).
- * This delegates to the single shared implementation.
+ * Creates a writable stream for append-only output at the given path.
  */
-export function getProjectRoot(startDir = getProcessCwd()): string {
-    return findProjectRoot(startDir);
-}
-
-/** Resolves path segments relative to the project root. */
-export function resolveProjectPath(...segments: string[]): string {
-    return resolvePath(getProjectRoot(), ...segments);
-}
-
-/** Creates a {@link LogStream} at the given path using the active file system. */
-export function createLogStream(path: string, fs = getFs()): LogStream {
-    return fs.createLogStream(path);
+export function createLogStream(
+    path: string,
+    fs: CanonicalFileSystem = createNodeFileSystem(),
+): { write(chunk: string): void; end(): void } {
+    return fs.createWriteStream(path);
 }
 
 function getProcessPid(): number {
     return (globalThis as { process?: { pid?: number } }).process?.pid ?? 0;
 }
 
-// Two writers to the same path in the same millisecond must not share a temp name, or one clobbers
-// the other before rename. randomUUID disambiguates; Date.now keeps names sortable for debugging.
 function uniqueToken(): string {
     return `${Date.now()}.${crypto.randomUUID()}`;
 }

package/src/index.ts

@@ -8,19 +8,9 @@ export { createNodeFileSystem, findProjectRoot } from './file-system-node';
 export {
     atomicWriteFile,
     atomicWriteJson,
-    CloudflareFileSystem,
     createLogStream,
     ensureDirForFile,
-    ensureDirForFileSync,
-    type FileSystem as LegacyFileSystem,
-    getFs,
-    getProjectRoot,
-    NodeFileSystem,
-    NodeSyncFileSystem,
     readJsonFile,
-    resolveProjectPath,
-    type SyncFileSystem,
-    setFileSystem,
     walkDir,
     writeJsonFile,
 } from './fs';

package/src/process-executor.ts

@@ -26,6 +26,8 @@ export interface ProcessOptions {
     label?: string;
     rejectOnError?: boolean;
     forceBuffered?: boolean;
+    /** AbortSignal forwarded to execa as `cancelSignal` — aborts the child process when fired. */
+    signal?: AbortSignal;
 }
 
 /** Result of a completed child process, including exit code, captured output, and duration. */
@@ -130,6 +132,7 @@ export class ProcessExecutor {
             rejectOnError: options.rejectOnError ?? false,
             outputPolicy: this.config.output,
             forceBuffered: options.forceBuffered ?? false,
+            signal: options.signal,
         });
         const startedAt = Date.now();
         this.emitProcessEvent('process.started', {
@@ -442,6 +445,7 @@ function buildExecaOptions(opts: {
     rejectOnError: boolean;
     outputPolicy: OutputPolicy | undefined;
     forceBuffered: boolean;
+    signal?: AbortSignal;
 }): ExecaOptions {
     const canStream =
         !opts.forceBuffered &&
@@ -457,6 +461,7 @@ function buildExecaOptions(opts: {
         ...(opts.env !== undefined ? { env: opts.env } : {}),
         ...(opts.timeout !== undefined ? { timeout: opts.timeout } : {}),
         ...(opts.maxOutput !== undefined ? { maxBuffer: opts.maxOutput } : {}),
+        ...(opts.signal !== undefined ? { cancelSignal: opts.signal } : {}),
     };
 }
 

package/src/schema-validation.ts

@@ -1,6 +1,6 @@
 import { parse as parseYaml } from 'yaml';
 import type { FileSystem } from './file-system';
-import { getFs } from './fs';
+import { createNodeFileSystem } from './file-system-node';
 import { dirnamePath, getProcessCwd, isAbsolutePath, joinPath } from './path';
 
 /** Default time budget for a single remote schema fetch. */
@@ -47,10 +47,10 @@ export interface StructuredConfigLoadOptions {
      */
     resolve?: (specifier: string, from: string) => string;
     /**
-     * File system used to read the config and local schema files. Defaults to the
-     * deprecated `getFs()` global; supply a {@link FileSystem} from the runtime factory
-     * (`createNodeFileSystem()`) to route reads through the factory path or to inject a
-     * virtual file system in tests.
+     * File system used to read the config and local schema files. Defaults to
+     * `createNodeFileSystem()`; supply a {@link FileSystem} from the runtime factory
+     * to route reads through a different adapter or to inject a virtual file system
+     * in tests.
      */
     fileSystem?: Pick<FileSystem, 'readFile'>;
 }
@@ -68,7 +68,7 @@ export class StructuredConfigSchemaError extends Error {
 
 /** Reads a config file from disk, parses it (YAML or JSON), and validates against its declared `$schema`. */
 export async function loadStructuredConfig(path: string, options: StructuredConfigLoadOptions = {}): Promise<unknown> {
-    const content = await (options.fileSystem ?? getFs()).readFile(path);
+    const content = await (options.fileSystem ?? createNodeFileSystem()).readFile(path);
     return await parseStructuredConfig(content, path, options);
 }
 
@@ -360,7 +360,7 @@ async function readSchema(schemaLocation: string, options: StructuredConfigLoadO
         }
         return await readBoundedBody(response, schemaLocation);
     }
-    return await (options.fileSystem ?? getFs()).readFile(schemaLocation);
+    return await (options.fileSystem ?? createNodeFileSystem()).readFile(schemaLocation);
 }
 
 /**