powerlines 0.19.5 → 0.21.0

package/dist/lib/entry.cjs

@@ -1,39 +1,39 @@
 'use strict';
 
-var chunkOTBLE55Z_cjs = require('./chunk-OTBLE55Z.cjs');
+var chunkMPCVQK2D_cjs = require('./chunk-MPCVQK2D.cjs');
 require('./chunk-USNT2KNT.cjs');
 
 
 
 Object.defineProperty(exports, "getUniqueEntries", {
   enumerable: true,
-  get: function () { return chunkOTBLE55Z_cjs.getUniqueEntries; }
+  get: function () { return chunkMPCVQK2D_cjs.getUniqueEntries; }
 });
 Object.defineProperty(exports, "resolveEntries", {
   enumerable: true,
-  get: function () { return chunkOTBLE55Z_cjs.resolveEntries; }
+  get: function () { return chunkMPCVQK2D_cjs.resolveEntries; }
 });
 Object.defineProperty(exports, "resolveEntriesSync", {
   enumerable: true,
-  get: function () { return chunkOTBLE55Z_cjs.resolveEntriesSync; }
+  get: function () { return chunkMPCVQK2D_cjs.resolveEntriesSync; }
 });
 Object.defineProperty(exports, "resolveEntry", {
   enumerable: true,
-  get: function () { return chunkOTBLE55Z_cjs.resolveEntry; }
+  get: function () { return chunkMPCVQK2D_cjs.resolveEntry; }
 });
 Object.defineProperty(exports, "resolveEntryInput", {
   enumerable: true,
-  get: function () { return chunkOTBLE55Z_cjs.resolveEntryInput; }
+  get: function () { return chunkMPCVQK2D_cjs.resolveEntryInput; }
 });
 Object.defineProperty(exports, "resolveEntryInputFile", {
   enumerable: true,
-  get: function () { return chunkOTBLE55Z_cjs.resolveEntryInputFile; }
+  get: function () { return chunkMPCVQK2D_cjs.resolveEntryInputFile; }
 });
 Object.defineProperty(exports, "resolveEntryOutput", {
   enumerable: true,
-  get: function () { return chunkOTBLE55Z_cjs.resolveEntryOutput; }
+  get: function () { return chunkMPCVQK2D_cjs.resolveEntryOutput; }
 });
 Object.defineProperty(exports, "resolveVirtualEntry", {
   enumerable: true,
-  get: function () { return chunkOTBLE55Z_cjs.resolveVirtualEntry; }
+  get: function () { return chunkMPCVQK2D_cjs.resolveVirtualEntry; }
 });

package/dist/lib/entry.d.cts

@@ -1,5 +1,5 @@
 import { TypeDefinition, TypeDefinitionParameter } from '@stryke/types/configuration';
-import { C as Context, R as ResolvedEntryTypeDefinition } from './config-LK_Wl1SU.cjs';
+import { C as Context, g as ResolvedEntryTypeDefinition } from './config-7vXtXiGg.cjs';
 import '@storm-software/build-tools/types';
 import '@storm-software/config-tools/types';
 import '@storm-software/config/types';
@@ -28,9 +28,7 @@ import './tsconfig-Bz-CiFqD.cjs';
 import '@stryke/types/tsconfig';
 import 'typescript';
 import '@stryke/json/types';
-import 'memfs';
 import 'node:fs';
-import 'unionfs';
 
 declare function resolveEntryInputFile(context: Context, typeDefinition: TypeDefinition): string;
 declare function resolveEntryInput(context: Context, typeDefinition: TypeDefinition): TypeDefinition;

package/dist/lib/entry.d.ts

@@ -1,5 +1,5 @@
 import { TypeDefinition, TypeDefinitionParameter } from '@stryke/types/configuration';
-import { C as Context, R as ResolvedEntryTypeDefinition } from './config-CnPcoKqT.js';
+import { C as Context, g as ResolvedEntryTypeDefinition } from './config-B9aVEiiX.js';
 import '@storm-software/build-tools/types';
 import '@storm-software/config-tools/types';
 import '@storm-software/config/types';
@@ -28,9 +28,7 @@ import './tsconfig-Bz-CiFqD.js';
 import '@stryke/types/tsconfig';
 import 'typescript';
 import '@stryke/json/types';
-import 'memfs';
 import 'node:fs';
-import 'unionfs';
 
 declare function resolveEntryInputFile(context: Context, typeDefinition: TypeDefinition): string;
 declare function resolveEntryInput(context: Context, typeDefinition: TypeDefinition): TypeDefinition;

package/dist/lib/entry.js

@@ -1,2 +1,2 @@
-export { getUniqueEntries, resolveEntries, resolveEntriesSync, resolveEntry, resolveEntryInput, resolveEntryInputFile, resolveEntryOutput, resolveVirtualEntry } from './chunk-SM3S7DYW.js';
+export { getUniqueEntries, resolveEntries, resolveEntriesSync, resolveEntry, resolveEntryInput, resolveEntryInputFile, resolveEntryOutput, resolveVirtualEntry } from './chunk-BHDQZ6YX.js';
 import './chunk-SHUYVCID.js';

package/dist/lib/{hooks-DX1o8l6J.d.ts → hooks-BxUBzqCb.d.ts}

@@ -1,4 +1,4 @@
-import { S as SelectHooksOptions } from './config-CnPcoKqT.js';
+import { S as SelectHooksOptions } from './config-B9aVEiiX.js';
 
 type CallHookOptions = SelectHooksOptions & ({
     /**

package/dist/lib/{hooks-BD2rDhpA.d.cts → hooks-cvv50JDh.d.cts}

@@ -1,4 +1,4 @@
-import { S as SelectHooksOptions } from './config-LK_Wl1SU.cjs';
+import { S as SelectHooksOptions } from './config-7vXtXiGg.cjs';
 
 type CallHookOptions = SelectHooksOptions & ({
     /**

package/dist/lib/index.cjs

@@ -4,26 +4,26 @@ require('./chunk-EJ25PQEL.cjs');
 var chunkJG4IL7XL_cjs = require('./chunk-JG4IL7XL.cjs');
 var chunkVQ7CXQLT_cjs = require('./chunk-VQ7CXQLT.cjs');
 var chunkT6KEXFRH_cjs = require('./chunk-T6KEXFRH.cjs');
-var chunk37W2ZDLA_cjs = require('./chunk-37W2ZDLA.cjs');
-var chunkET5QBFGZ_cjs = require('./chunk-ET5QBFGZ.cjs');
+var chunkE2MVGKGH_cjs = require('./chunk-E2MVGKGH.cjs');
+var chunkFN7673NC_cjs = require('./chunk-FN7673NC.cjs');
 var chunkMZJWK36Q_cjs = require('./chunk-MZJWK36Q.cjs');
 require('./chunk-RJ4277VZ.cjs');
 var chunkH7A5QVLY_cjs = require('./chunk-H7A5QVLY.cjs');
 require('./chunk-VVSEE3JE.cjs');
-var chunk4AMFNBTX_cjs = require('./chunk-4AMFNBTX.cjs');
+var chunkLPA7UJIR_cjs = require('./chunk-LPA7UJIR.cjs');
 var chunk2NZADVP5_cjs = require('./chunk-2NZADVP5.cjs');
 var chunk4NHFXDTQ_cjs = require('./chunk-4NHFXDTQ.cjs');
-var chunkTNHDC2ZQ_cjs = require('./chunk-TNHDC2ZQ.cjs');
-var chunkUDJ37BEE_cjs = require('./chunk-UDJ37BEE.cjs');
-var chunk7K7JH3DF_cjs = require('./chunk-7K7JH3DF.cjs');
+var chunk7XHBIYIN_cjs = require('./chunk-7XHBIYIN.cjs');
+var chunkVGSV2BEL_cjs = require('./chunk-VGSV2BEL.cjs');
+var chunkULJVBW4L_cjs = require('./chunk-ULJVBW4L.cjs');
 var chunkIBPA3VN5_cjs = require('./chunk-IBPA3VN5.cjs');
 var chunkBQU53ZNB_cjs = require('./chunk-BQU53ZNB.cjs');
 var chunkXW5TELHB_cjs = require('./chunk-XW5TELHB.cjs');
 var chunkCGYAL3S2_cjs = require('./chunk-CGYAL3S2.cjs');
 var chunkJA4HSQRN_cjs = require('./chunk-JA4HSQRN.cjs');
 var chunk3OCI4TH7_cjs = require('./chunk-3OCI4TH7.cjs');
-require('./chunk-POOHWK7C.cjs');
-var chunkOTBLE55Z_cjs = require('./chunk-OTBLE55Z.cjs');
+require('./chunk-27VJFYDM.cjs');
+var chunkMPCVQK2D_cjs = require('./chunk-MPCVQK2D.cjs');
 require('./chunk-USNT2KNT.cjs');
 
 
@@ -50,11 +50,11 @@ Object.defineProperty(exports, "setCache", {
 });
 Object.defineProperty(exports, "resolve", {
   enumerable: true,
-  get: function () { return chunk37W2ZDLA_cjs.resolve; }
+  get: function () { return chunkE2MVGKGH_cjs.resolve; }
 });
 Object.defineProperty(exports, "bundle", {
   enumerable: true,
-  get: function () { return chunkET5QBFGZ_cjs.bundle; }
+  get: function () { return chunkFN7673NC_cjs.bundle; }
 });
 Object.defineProperty(exports, "resolvePath", {
   enumerable: true,
@@ -64,9 +64,13 @@ Object.defineProperty(exports, "isolatedDeclarations", {
   enumerable: true,
   get: function () { return chunkH7A5QVLY_cjs.isolatedDeclarations; }
 });
+Object.defineProperty(exports, "VirtualFileSystem", {
+  enumerable: true,
+  get: function () { return chunkLPA7UJIR_cjs.VirtualFileSystem; }
+});
 Object.defineProperty(exports, "createUnpluginFactory", {
   enumerable: true,
-  get: function () { return chunk4AMFNBTX_cjs.createUnpluginFactory; }
+  get: function () { return chunkLPA7UJIR_cjs.createUnpluginFactory; }
 });
 Object.defineProperty(exports, "writeFile", {
   enumerable: true,
@@ -82,39 +86,39 @@ Object.defineProperty(exports, "getFileHeader", {
 });
 Object.defineProperty(exports, "CACHE_HASH_LENGTH", {
   enumerable: true,
-  get: function () { return chunkTNHDC2ZQ_cjs.CACHE_HASH_LENGTH; }
+  get: function () { return chunk7XHBIYIN_cjs.CACHE_HASH_LENGTH; }
 });
 Object.defineProperty(exports, "PROJECT_ROOT_HASH_LENGTH", {
   enumerable: true,
-  get: function () { return chunkTNHDC2ZQ_cjs.PROJECT_ROOT_HASH_LENGTH; }
+  get: function () { return chunk7XHBIYIN_cjs.PROJECT_ROOT_HASH_LENGTH; }
 });
 Object.defineProperty(exports, "discoverTemplates", {
   enumerable: true,
-  get: function () { return chunkTNHDC2ZQ_cjs.discoverTemplates; }
+  get: function () { return chunk7XHBIYIN_cjs.discoverTemplates; }
 });
 Object.defineProperty(exports, "getChecksum", {
   enumerable: true,
-  get: function () { return chunkTNHDC2ZQ_cjs.getChecksum; }
+  get: function () { return chunk7XHBIYIN_cjs.getChecksum; }
 });
 Object.defineProperty(exports, "getPersistedMeta", {
   enumerable: true,
-  get: function () { return chunkTNHDC2ZQ_cjs.getPersistedMeta; }
+  get: function () { return chunk7XHBIYIN_cjs.getPersistedMeta; }
 });
 Object.defineProperty(exports, "getPrefixedProjectRootHash", {
   enumerable: true,
-  get: function () { return chunkTNHDC2ZQ_cjs.getPrefixedProjectRootHash; }
+  get: function () { return chunk7XHBIYIN_cjs.getPrefixedProjectRootHash; }
 });
 Object.defineProperty(exports, "writeMetaFile", {
   enumerable: true,
-  get: function () { return chunkTNHDC2ZQ_cjs.writeMetaFile; }
+  get: function () { return chunk7XHBIYIN_cjs.writeMetaFile; }
 });
 Object.defineProperty(exports, "createUnplugin", {
   enumerable: true,
-  get: function () { return chunkUDJ37BEE_cjs.createUnplugin; }
+  get: function () { return chunkVGSV2BEL_cjs.createUnplugin; }
 });
 Object.defineProperty(exports, "handleResolveId", {
   enumerable: true,
-  get: function () { return chunk7K7JH3DF_cjs.handleResolveId; }
+  get: function () { return chunkULJVBW4L_cjs.handleResolveId; }
 });
 Object.defineProperty(exports, "SourcesMap", {
   enumerable: true,
@@ -194,33 +198,33 @@ Object.defineProperty(exports, "getString", {
 });
 Object.defineProperty(exports, "getUniqueEntries", {
   enumerable: true,
-  get: function () { return chunkOTBLE55Z_cjs.getUniqueEntries; }
+  get: function () { return chunkMPCVQK2D_cjs.getUniqueEntries; }
 });
 Object.defineProperty(exports, "resolveEntries", {
   enumerable: true,
-  get: function () { return chunkOTBLE55Z_cjs.resolveEntries; }
+  get: function () { return chunkMPCVQK2D_cjs.resolveEntries; }
 });
 Object.defineProperty(exports, "resolveEntriesSync", {
   enumerable: true,
-  get: function () { return chunkOTBLE55Z_cjs.resolveEntriesSync; }
+  get: function () { return chunkMPCVQK2D_cjs.resolveEntriesSync; }
 });
 Object.defineProperty(exports, "resolveEntry", {
   enumerable: true,
-  get: function () { return chunkOTBLE55Z_cjs.resolveEntry; }
+  get: function () { return chunkMPCVQK2D_cjs.resolveEntry; }
 });
 Object.defineProperty(exports, "resolveEntryInput", {
   enumerable: true,
-  get: function () { return chunkOTBLE55Z_cjs.resolveEntryInput; }
+  get: function () { return chunkMPCVQK2D_cjs.resolveEntryInput; }
 });
 Object.defineProperty(exports, "resolveEntryInputFile", {
   enumerable: true,
-  get: function () { return chunkOTBLE55Z_cjs.resolveEntryInputFile; }
+  get: function () { return chunkMPCVQK2D_cjs.resolveEntryInputFile; }
 });
 Object.defineProperty(exports, "resolveEntryOutput", {
   enumerable: true,
-  get: function () { return chunkOTBLE55Z_cjs.resolveEntryOutput; }
+  get: function () { return chunkMPCVQK2D_cjs.resolveEntryOutput; }
 });
 Object.defineProperty(exports, "resolveVirtualEntry", {
   enumerable: true,
-  get: function () { return chunkOTBLE55Z_cjs.resolveVirtualEntry; }
+  get: function () { return chunkMPCVQK2D_cjs.resolveVirtualEntry; }
 });

package/dist/lib/index.d.cts

@@ -1,6 +1,8 @@
 export { PartiallyResolvedContext, loadUserConfigFile, loadWorkspaceConfig } from './config-file.cjs';
 export { createProgram } from './create-program.cjs';
 export { getUniqueEntries, resolveEntries, resolveEntriesSync, resolveEntry, resolveEntryInput, resolveEntryInputFile, resolveEntryOutput, resolveVirtualEntry } from './entry.cjs';
+import fs, { PathLike, ObjectEncodingOptions, PathOrFileDescriptor, Stats, StatSyncOptions } from 'node:fs';
+import { V as VirtualFileSystemInterface, C as Context, a as VirtualFileMetadata, R as ResolvePathOptions, b as ResolveFSOptions, M as MakeDirectoryOptions, W as WriteFileData, c as WriteFileOptions, _ as __VFS_PATCH__, d as __VFS_REVERT__ } from './config-7vXtXiGg.cjs';
 export { CreateLogOptions, createLog, extendLog } from './logger.cjs';
 export { IsolatedDeclarationsResult, isolatedDeclarations } from './typescript/isolated-decl.cjs';
 export { SourcesMap, createVirtualCompilerHost, createVirtualProgram, getDefaultCompilerOptions, loadLibFiles } from './typescript/program.cjs';
@@ -19,12 +21,12 @@ export { generateSourceMap } from './utilities/source-map.cjs';
 export { Worker, WorkerOptions, createWorker } from './utilities/worker.cjs';
 export { writeFile } from './utilities/write-file.cjs';
 import 'jiti';
-import './config-LK_Wl1SU.cjs';
+import 'ts-morph';
+import '@stryke/types/configuration';
 import '@storm-software/build-tools/types';
 import '@storm-software/config-tools/types';
 import '@storm-software/config/types';
 import '@stryke/types/base';
-import '@stryke/types/configuration';
 import '@stryke/types/file';
 import 'c12';
 import 'vite';
@@ -48,8 +50,325 @@ import './tsconfig-Bz-CiFqD.cjs';
 import '@stryke/types/tsconfig';
 import 'typescript';
 import '@stryke/json/types';
-import 'memfs';
-import 'node:fs';
-import 'unionfs';
-import 'ts-morph';
-import './hooks-BD2rDhpA.cjs';
+import './hooks-cvv50JDh.cjs';
+
+/**
+ * Represents a virtual file system (VFS) that stores files and their associated metadata in virtual memory.
+ *
+ * @remarks
+ * This class provides methods to manage virtual files, check their existence, retrieve their content, and manipulate the virtual file system. It allows for efficient file management and retrieval without relying on the actual file system.
+ */
+declare class VirtualFileSystem implements VirtualFileSystemInterface {
+    #private;
+    /**
+     * Creates a virtual file system (VFS) that is backed up to a Cap'n Proto message buffer.
+     *
+     * @param context - The context of the virtual file system, typically containing options and logging functions.
+     * @returns A promise that resolves to a new virtual file system instance.
+     */
+    static create(context: Context): Promise<VirtualFileSystem>;
+    /**
+     * Synchronously creates a virtual file system (VFS) that is backed up to a Cap'n Proto message buffer.
+     *
+     * @param context - The context of the virtual file system, typically containing options and logging functions.
+     * @returns A new virtual file system instance.
+     */
+    static createSync(context: Context): VirtualFileSystem;
+    /**
+     * A map of file ids to their metadata.
+     */
+    get metadata(): Record<string, VirtualFileMetadata>;
+    /**
+     * A map of module ids to their file paths.
+     */
+    get ids(): Record<string, string>;
+    /**
+     * A map of virtual file paths to their IDs.
+     */
+    get paths(): Record<string, string>;
+    /**
+     * Creates a new instance of the {@link VirtualFileSystem}.
+     *
+     * @param context - The context of the virtual file system, typically containing options and logging functions.
+     * @param data - A buffer containing the serialized virtual file system data.
+     */
+    private constructor();
+    /**
+     * Check if a path or id corresponds to a virtual file **(does not actually exists on disk)**.
+     *
+     * @param pathOrId - The path or id to check.
+     * @param options - Optional parameters for resolving the path.
+     * @returns Whether the path or id corresponds to a virtual file **(does not actually exists on disk)**.
+     */
+    isVirtual(pathOrId: string, options?: ResolvePathOptions): boolean;
+    /**
+     * Check if a path or id corresponds to a file written to the file system **(actually exists on disk)**.
+     *
+     * @param pathOrId - The path or id to check.
+     * @param options - Optional parameters for resolving the path.
+     * @returns Whether the path or id corresponds to a file written to the file system **(actually exists on disk)**.
+     */
+    isPhysical(pathOrId: string, options?: ResolvePathOptions): boolean;
+    /**
+     * Lists files in a given path.
+     *
+     * @param path - The path to list files from.
+     * @param options - Options for listing files, such as encoding and recursion.
+     * @returns An array of file names in the specified path.
+     */
+    readdirSync(path: fs.PathLike, options?: {
+        encoding: BufferEncoding | null;
+        withFileTypes?: false | undefined;
+        recursive?: boolean | undefined;
+    } | BufferEncoding): string[];
+    /**
+     * Removes a file in the virtual file system (VFS).
+     *
+     * @param path - The path to create the directory at.
+     */
+    unlinkSync(path: fs.PathLike, options?: ResolveFSOptions): void;
+    /**
+     * Removes a file in the virtual file system (VFS).
+     *
+     * @param path - The path to create the directory at.
+     */
+    unlink(path: fs.PathLike, options?: ResolveFSOptions): Promise<void>;
+    /**
+     * Removes a directory in the virtual file system (VFS).
+     *
+     * @param path - The path to create the directory at.
+     * @param options - Options for creating the directory.
+     */
+    rmdirSync(path: fs.PathLike, options?: fs.RmDirOptions & ResolveFSOptions): void;
+    /**
+     * Removes a directory in the virtual file system (VFS).
+     *
+     * @param path - The path to create the directory at.
+     * @param options - Options for creating the directory.
+     * @returns A promise that resolves to the path of the created directory, or undefined if the directory could not be created.
+     */
+    rmdir(path: fs.PathLike, options?: fs.RmDirOptions & ResolveFSOptions): Promise<void>;
+    /**
+     * Removes a file in the virtual file system (VFS).
+     *
+     * @param path - The path to the file to remove.
+     * @param options - Options for removing the file.
+     * @returns A promise that resolves when the file is removed.
+     */
+    rm(path: fs.PathLike, options?: fs.RmOptions & ResolveFSOptions): Promise<void>;
+    /**
+     * Synchronously removes a file or directory in the virtual file system (VFS).
+     *
+     * @param path - The path to the file or directory to remove.
+     * @param options - Options for removing the file or directory.
+     */
+    rmSync(path: fs.PathLike, options?: fs.RmOptions & ResolveFSOptions): void;
+    /**
+     * Creates a directory in the virtual file system (VFS).
+     *
+     * @param path - The path to create the directory at.
+     * @param options - Options for creating the directory.
+     * @returns A promise that resolves to the path of the created directory, or undefined if the directory could not be created.
+     */
+    mkdirSync(path: fs.PathLike, options?: MakeDirectoryOptions): string | undefined;
+    /**
+     * Creates a directory in the virtual file system (VFS).
+     *
+     * @param path - The path to create the directory at.
+     * @param options - Options for creating the directory.
+     * @returns A promise that resolves to the path of the created directory, or undefined if the directory could not be created.
+     */
+    mkdir(path: fs.PathLike, options?: MakeDirectoryOptions): Promise<string | undefined>;
+    /**
+     * Glob files in the virtual file system (VFS) based on the provided pattern(s).
+     *
+     * @param patterns - A pattern (or multiple patterns) to use to determine the file paths to return
+     * @returns An array of file paths matching the provided pattern(s)
+     */
+    glob(patterns: string | string[]): Promise<string[]>;
+    /**
+     * Synchronously glob files in the virtual file system (VFS) based on the provided pattern(s).
+     *
+     * @param patterns - A pattern (or multiple patterns) to use to determine the file paths to return
+     * @returns An array of file paths matching the provided pattern(s)
+     */
+    globSync(patterns: string | string[]): string[];
+    /**
+     * Moves a file from one path to another in the virtual file system (VFS).
+     *
+     * @param srcPath - The source path to move
+     * @param destPath - The destination path to move to
+     */
+    move(srcPath: string, destPath: string): Promise<void>;
+    /**
+     * Synchronously moves a file from one path to another in the virtual file system (VFS).
+     *
+     * @param srcPath - The source path to move
+     * @param destPath - The destination path to move to
+     */
+    moveSync(srcPath: string, destPath: string): void;
+    /**
+     * Copies a file from one path to another in the virtual file system (VFS).
+     *
+     * @param srcPath - The source path to copy
+     * @param destPath - The destination path to copy to
+     */
+    copy(srcPath: string, destPath: string): Promise<void>;
+    /**
+     * Synchronously copies a file from one path to another in the virtual file system (VFS).
+     *
+     * @param srcPath - The source path to copy
+     * @param destPath - The destination path to copy to
+     */
+    copySync(srcPath: string, destPath: string): void;
+    /**
+     * Lists files in a given path.
+     *
+     * @param pathOrId - The path to list files from.
+     * @param options - Options for listing files, such as encoding and recursion.
+     * @returns An array of file names in the specified path.
+     */
+    readdir(pathOrId: PathLike, options?: {
+        encoding: BufferEncoding | null;
+        withFileTypes?: false | undefined;
+        recursive?: boolean | undefined;
+    } | BufferEncoding): Promise<string[]>;
+    /**
+     * Asynchronously reads a file from the virtual file system (VFS).
+     *
+     * @param pathOrId - The path or ID of the file to read.
+     * @returns A promise that resolves to the contents of the file as a string, or undefined if the file does not exist.
+     */
+    readFile(pathOrId: PathLike, options?: (ObjectEncodingOptions & {
+        flag?: string | undefined;
+    }) | BufferEncoding): Promise<string | undefined>;
+    /**
+     * Synchronously reads a file from the virtual file system (VFS).
+     *
+     * @param pathOrId - The path or ID of the file to read.
+     * @returns The contents of the file as a string, or undefined if the file does not exist.
+     */
+    readFileSync(pathOrId: PathLike, options?: (fs.ObjectEncodingOptions & {
+        flag?: string | undefined;
+    }) | BufferEncoding | null): string | undefined;
+    /**
+     * Writes a file to the virtual file system (VFS).
+     *
+     * @param path - The path to the file.
+     * @param data - The contents of the file.
+     * @param options - Optional parameters for writing the file.
+     * @returns A promise that resolves when the file is written.
+     */
+    writeFile(path: PathOrFileDescriptor, data?: WriteFileData, options?: WriteFileOptions): Promise<void>;
+    /**
+     * Synchronously writes a file to the virtual file system (VFS).
+     *
+     * @param path - The file to write.
+     * @param data - The contents of the file.
+     * @param options - Optional parameters for writing the file.
+     */
+    writeFileSync(path: PathOrFileDescriptor, data?: WriteFileData, options?: WriteFileOptions): void;
+    /**
+     * Synchronously checks if a file exists in the virtual file system (VFS).
+     *
+     * @param pathOrId - The path or ID of the file to check.
+     * @returns `true` if the file exists, otherwise `false`.
+     */
+    existsSync(pathOrId: PathLike): boolean;
+    /**
+     * Retrieves the metadata of a file in the virtual file system (VFS).
+     *
+     * @param pathOrId - The path or ID of the file to retrieve metadata for.
+     * @returns The metadata of the file, or undefined if the file does not exist.
+     */
+    getMetadata(pathOrId: PathLike): VirtualFileMetadata | undefined;
+    /**
+     * Checks if a file exists in the virtual file system (VFS).
+     *
+     * @remarks
+     * This is a base method used by {@link existsSync} - it does not try to resolve the path prior to checking if it exists or not.
+     *
+     * @param pathOrId - The path of the file to check.
+     * @returns `true` if the file exists, otherwise `false`.
+     */
+    isFile(pathOrId: PathLike): boolean;
+    /**
+     * Checks if a directory exists in the virtual file system (VFS).
+     *
+     * @param pathOrId - The path of the directory to check.
+     * @returns `true` if the directory exists, otherwise `false`.
+     */
+    isDirectory(pathOrId: PathLike): boolean;
+    /**
+     * Retrieves the status of a file in the virtual file system (VFS).
+     *
+     * @param pathOrId - The path or ID of the file to retrieve status for.
+     * @returns A promise that resolves to the file's status information, or false if the file does not exist.
+     */
+    stat(pathOrId: PathLike, options?: fs.StatOptions & {
+        bigint?: false | undefined;
+    }): Promise<Stats>;
+    /**
+     * Synchronously retrieves the status of a file in the virtual file system (VFS).
+     *
+     * @param pathOrId - The path or ID of the file to retrieve status for.
+     * @returns The file's status information, or false if the file does not exist.
+     */
+    statSync(pathOrId: PathLike): Stats;
+    /**
+     * Retrieves the status of a symbolic link in the virtual file system (VFS).
+     *
+     * @param pathOrId - The path or ID of the symbolic link to retrieve status for.
+     * @returns A promise that resolves to the symbolic link's status information, or false if the link does not exist.
+     */
+    lstat(pathOrId: PathLike, options?: fs.StatOptions & {
+        bigint?: false | undefined;
+    }): Promise<Stats>;
+    /**
+     * Synchronously retrieves the status of a symbolic link in the virtual file system (VFS).
+     *
+     * @param pathOrId - The path or ID of the symbolic link to retrieve status for.
+     * @returns The symbolic link's status information, or false if the link does not exist.
+     */
+    lstatSync(pathOrId: PathLike, options?: StatSyncOptions & {
+        bigint?: false | undefined;
+        throwIfNoEntry: false;
+    }): Stats | undefined;
+    /**
+     * Resolves a path or ID to its real path in the virtual file system (VFS).
+     *
+     * @param pathOrId - The path or ID to resolve.
+     * @returns The resolved real path if it exists, otherwise undefined.
+     */
+    realpathSync(pathOrId: PathLike): string;
+    /**
+     * Resolves a path or ID parameter to a corresponding virtual file path in the virtual file system (VFS).
+     *
+     * @param pathOrId - The path or ID to resolve.
+     * @param options - Optional parameters for resolving the path, such as whether to include the file extension.
+     * @returns The resolved file path if it exists, otherwise undefined.
+     */
+    resolve(pathOrId: PathLike, options?: ResolvePathOptions): string | false;
+    /**
+     * Converts a relative path to an absolute path based on the workspace and project root.
+     *
+     * @param path - The relative path to convert.
+     * @returns The absolute path.
+     */
+    formatPath(path: PathOrFileDescriptor): string;
+    /**
+     * Disposes of the virtual file system (VFS) by saving its state to disk.
+     */
+    dispose(): Promise<void>;
+    /**
+     * Initializes the virtual file system (VFS) by patching the file system module if necessary.
+     */
+    [__VFS_PATCH__](): void;
+    /**
+     * Reverts the file system module to its original state if it was previously patched.
+     */
+    [__VFS_REVERT__](): void;
+    [Symbol.asyncDispose](): Promise<void>;
+}
+
+export { VirtualFileSystem };