powerlines 0.20.0 → 0.22.0

package/dist/lib/{chunk-ARCFV3IJ.cjs → chunk-LPA7UJIR.cjs}

@@ -2,13 +2,13 @@
 
 var chunk2NZADVP5_cjs = require('./chunk-2NZADVP5.cjs');
 var chunk4NHFXDTQ_cjs = require('./chunk-4NHFXDTQ.cjs');
-var chunkTNHDC2ZQ_cjs = require('./chunk-TNHDC2ZQ.cjs');
-var chunk7K7JH3DF_cjs = require('./chunk-7K7JH3DF.cjs');
+var chunk7XHBIYIN_cjs = require('./chunk-7XHBIYIN.cjs');
+var chunkULJVBW4L_cjs = require('./chunk-ULJVBW4L.cjs');
 var chunkBQU53ZNB_cjs = require('./chunk-BQU53ZNB.cjs');
 var chunkXW5TELHB_cjs = require('./chunk-XW5TELHB.cjs');
 var chunkJA4HSQRN_cjs = require('./chunk-JA4HSQRN.cjs');
 var chunk3OCI4TH7_cjs = require('./chunk-3OCI4TH7.cjs');
-var chunkOTBLE55Z_cjs = require('./chunk-OTBLE55Z.cjs');
+var chunkMPCVQK2D_cjs = require('./chunk-MPCVQK2D.cjs');
 var chunkUSNT2KNT_cjs = require('./chunk-USNT2KNT.cjs');
 var types = require('@storm-software/config-tools/types');
 var getWorkspaceRoot = require('@stryke/fs/get-workspace-root');
@@ -33,7 +33,7 @@ var isSet = require('@stryke/type-checks/is-set');
 var isSetObject = require('@stryke/type-checks/is-set-object');
 var isSetString = require('@stryke/type-checks/is-set-string');
 var chalk4 = require('chalk');
-var defu3 = require('defu');
+var defu2 = require('defu');
 var Handlebars = require('handlebars');
 var helperPluginUtils = require('@babel/helper-plugin-utils');
 var t = require('@babel/types');
@@ -52,17 +52,19 @@ var isNull = require('@stryke/type-checks/is-null');
 var isString = require('@stryke/type-checks/is-string');
 var uuid = require('@stryke/unique-id/uuid');
 var oxcParser = require('oxc-parser');
-var isUndefined = require('@stryke/type-checks/is-undefined');
-var jiti = require('jiti');
+var $ = require('@stryke/capnp');
 var bufferToString = require('@stryke/convert/buffer-to-string');
-var isParentPath = require('@stryke/path/is-parent-path');
+var buffer = require('@stryke/fs/buffer');
 var prettyBytes = require('@stryke/string-format/pretty-bytes');
 var isBuffer = require('@stryke/type-checks/is-buffer');
-var memfs = require('memfs');
-var buffer = require('buffer');
+var buffer$1 = require('buffer');
 var fs = require('fs');
 var prettier = require('prettier');
+var isUndefined = require('@stryke/type-checks/is-undefined');
+var isParentPath = require('@stryke/path/is-parent-path');
+var volume = require('memfs/lib/node/volume');
 var unionfs = require('unionfs');
+var jiti = require('jiti');
 var isObject = require('@stryke/type-checks/is-object');
 var ts = require('typescript');
 var _package = require('@stryke/string-format/package');
@@ -90,9 +92,10 @@ function _interopNamespace(e) {
 }
 
 var chalk4__default = /*#__PURE__*/_interopDefault(chalk4);
-var defu3__default = /*#__PURE__*/_interopDefault(defu3);
+var defu2__default = /*#__PURE__*/_interopDefault(defu2);
 var Handlebars__default = /*#__PURE__*/_interopDefault(Handlebars);
 var t__namespace = /*#__PURE__*/_interopNamespace(t);
+var $__namespace = /*#__PURE__*/_interopNamespace($);
 var fs__default = /*#__PURE__*/_interopDefault(fs);
 var ts__default = /*#__PURE__*/_interopDefault(ts);
 
@@ -199,7 +202,7 @@ var moduleResolverBabelPlugin = /* @__PURE__ */ chunkUSNT2KNT_cjs.__name((contex
 }, "moduleResolverBabelPlugin");
 var DEFAULT_ENVIRONMENT = "default";
 function createEnvironment(name, userConfig) {
-  return defu3__default.default(userConfig.environments?.[name] ?? {}, {
+  return defu2__default.default(userConfig.environments?.[name] ?? {}, {
     name,
     title: userConfig.title || titleCase.titleCase(userConfig.name),
     ssr: false,
@@ -242,94 +245,232 @@ function createDefaultEnvironment(userConfig) {
   return createEnvironment(DEFAULT_ENVIRONMENT, userConfig);
 }
 chunkUSNT2KNT_cjs.__name(createDefaultEnvironment, "createDefaultEnvironment");
-
-// src/types/commands.ts
-var SUPPORTED_COMMANDS = [
-  "new",
-  "clean",
-  "prepare",
-  "lint",
-  "test",
-  "build",
-  "docs",
-  "release",
-  "finalize"
-];
-
-// src/plugin-utils/helpers.ts
-function isPlugin(value) {
-  return isSetObject.isSetObject(value) && "name" in value && isSetString.isSetString(value.name) && (isUndefined.isUndefined(value.applyToEnvironment) || "applyToEnvironment" in value && isFunction.isFunction(value.applyToEnvironment)) && (isUndefined.isUndefined(value.dedupe) || "dedupe" in value && isFunction.isFunction(value.dedupe)) && (isUndefined.isUndefined(value.dependsOn) || "dependsOn" in value && Array.isArray(value.dependsOn) && value.dependsOn.every(isPluginConfig)) && SUPPORTED_COMMANDS.every((command) => isUndefined.isUndefined(value[command]) || command in value && (isFunction.isFunction(value[command]) || isSetObject.isSetObject(value[command]) && "handler" in value[command] && isFunction.isFunction(value[command].handler)));
-}
-chunkUSNT2KNT_cjs.__name(isPlugin, "isPlugin");
-function isPluginConfigObject(value) {
-  return isSetObject.isSetObject(value) && "plugin" in value && ((isSetString.isSetString(value.plugin) || isFunction.isFunction(value.plugin)) && "options" in value && isSetObject.isSetObject(value.options) || isPlugin(value.plugin));
-}
-chunkUSNT2KNT_cjs.__name(isPluginConfigObject, "isPluginConfigObject");
-function isPluginConfigTuple(value) {
-  return Array.isArray(value) && (value.length === 1 || value.length === 2) && ((isSetString.isSetString(value[0]) || isFunction.isFunction(value[0])) && value.length > 1 && isSetObject.isSetObject(value[1]) || isPlugin(value[0]));
-}
-chunkUSNT2KNT_cjs.__name(isPluginConfigTuple, "isPluginConfigTuple");
-function isPluginConfig(value) {
-  return isSetString.isSetString(value) || isFunction.isFunction(value) || isPlugin(value) || isPluginConfigObject(value) || isPluginConfigTuple(value);
-}
-chunkUSNT2KNT_cjs.__name(isPluginConfig, "isPluginConfig");
-function isPluginHookFunction(value) {
-  return isFunction.isFunction(value) || isSetObject.isSetObject(value) && "handler" in value && isFunction.isFunction(value.handler);
-}
-chunkUSNT2KNT_cjs.__name(isPluginHookFunction, "isPluginHookFunction");
-function isPluginHookObject(value) {
-  return isSetObject.isSetObject(value) && "handler" in value && isFunction.isFunction(value.handler);
-}
-chunkUSNT2KNT_cjs.__name(isPluginHookObject, "isPluginHookObject");
-function isPluginHook(value) {
-  return isPluginHookFunction(value) || isPluginHookObject(value);
-}
-chunkUSNT2KNT_cjs.__name(isPluginHook, "isPluginHook");
-function getHookHandler(pluginHook) {
-  return isFunction.isFunction(pluginHook) ? pluginHook : pluginHook.handler;
-}
-chunkUSNT2KNT_cjs.__name(getHookHandler, "getHookHandler");
-function isHookExternal(hook) {
-  return hook.startsWith("vite:") || hook.startsWith("esbuild:") || hook.startsWith("rolldown:") || hook.startsWith("rollup:") || hook.startsWith("webpack:") || hook.startsWith("rspack:") || hook.startsWith("farm:");
-}
-chunkUSNT2KNT_cjs.__name(isHookExternal, "isHookExternal");
-function checkDedupe(plugin, plugins) {
-  return plugin.dedupe === false || plugins.some((p) => p.dedupe !== false && (isFunction.isFunction(p.dedupe) && p.dedupe(plugin) || p.name === plugin.name));
-}
-chunkUSNT2KNT_cjs.__name(checkDedupe, "checkDedupe");
-function addPluginHook(context, plugin, pluginHook, hooksList) {
-  if (!checkDedupe(plugin, hooksList.map((hook) => hook.plugin))) {
-    hooksList.push(isFunction.isFunction(pluginHook) ? {
-      plugin,
-      handler: getHookHandler(pluginHook).bind(context)
-    } : {
-      plugin,
-      ...pluginHook,
-      handler: getHookHandler(pluginHook).bind(context)
-    });
+BigInt("0xa56c61324b9d6e49");
+var FileMetadata_KeyValuePair = class extends $__namespace.Struct {
+  static {
+    chunkUSNT2KNT_cjs.__name(this, "FileMetadata_KeyValuePair");
   }
-}
-chunkUSNT2KNT_cjs.__name(addPluginHook, "addPluginHook");
-function resolveOptions(options) {
-  return defu3__default.default(options, {
-    interopDefault: true,
-    fsCache: options.mode !== "development" ? joinPaths.joinPaths(options.cacheDir, "jiti") : false,
-    moduleCache: options.mode !== "development"
-  });
-}
-chunkUSNT2KNT_cjs.__name(resolveOptions, "resolveOptions");
-function createPluginResolver(options) {
-  return jiti.createJiti(joinPaths.joinPaths(options.workspaceRoot, options.projectRoot), resolveOptions({
-    ...options
-  }));
-}
-chunkUSNT2KNT_cjs.__name(createPluginResolver, "createPluginResolver");
-function createResolver(options) {
-  const baseResolver = jiti.createJiti(joinPaths.joinPaths(options.workspaceRoot, options.projectRoot), resolveOptions(options));
-  baseResolver.plugin = createPluginResolver(options);
-  return baseResolver;
-}
-chunkUSNT2KNT_cjs.__name(createResolver, "createResolver");
+  static _capnp = {
+    displayName: "KeyValuePair",
+    id: "eabb26cf58b2a14c",
+    size: new $__namespace.ObjectSize(0, 2)
+  };
+  get key() {
+    return $__namespace.utils.getText(0, this);
+  }
+  set key(value) {
+    $__namespace.utils.setText(0, value, this);
+  }
+  get value() {
+    return $__namespace.utils.getText(1, this);
+  }
+  set value(value) {
+    $__namespace.utils.setText(1, value, this);
+  }
+  toString() {
+    return "FileMetadata_KeyValuePair_" + super.toString();
+  }
+};
+var FileMetadata = class _FileMetadata extends $__namespace.Struct {
+  static {
+    chunkUSNT2KNT_cjs.__name(this, "FileMetadata");
+  }
+  static KeyValuePair = FileMetadata_KeyValuePair;
+  static _capnp = {
+    displayName: "FileMetadata",
+    id: "8e2cab5d7e28c7b3",
+    size: new $__namespace.ObjectSize(0, 4),
+    defaultVariant: "normal"
+  };
+  static _Properties;
+  /**
+  * The variant of the file.
+  *
+  */
+  get id() {
+    return $__namespace.utils.getText(0, this);
+  }
+  set id(value) {
+    $__namespace.utils.setText(0, value, this);
+  }
+  /**
+  * The output mode of the file.
+  *
+  */
+  get variant() {
+    return $__namespace.utils.getText(1, this, _FileMetadata._capnp.defaultVariant);
+  }
+  set variant(value) {
+    $__namespace.utils.setText(1, value, this);
+  }
+  /**
+  * Additional metadata associated with the file.
+  *
+  */
+  get mode() {
+    return $__namespace.utils.getText(2, this);
+  }
+  set mode(value) {
+    $__namespace.utils.setText(2, value, this);
+  }
+  _adoptProperties(value) {
+    $__namespace.utils.adopt(value, $__namespace.utils.getPointer(3, this));
+  }
+  _disownProperties() {
+    return $__namespace.utils.disown(this.properties);
+  }
+  get properties() {
+    return $__namespace.utils.getList(3, _FileMetadata._Properties, this);
+  }
+  _hasProperties() {
+    return !$__namespace.utils.isNull($__namespace.utils.getPointer(3, this));
+  }
+  _initProperties(length) {
+    return $__namespace.utils.initList(3, _FileMetadata._Properties, length, this);
+  }
+  set properties(value) {
+    $__namespace.utils.copyFrom(value, $__namespace.utils.getPointer(3, this));
+  }
+  toString() {
+    return "FileMetadata_" + super.toString();
+  }
+};
+var FileIdentifier = class extends $__namespace.Struct {
+  static {
+    chunkUSNT2KNT_cjs.__name(this, "FileIdentifier");
+  }
+  static _capnp = {
+    displayName: "FileIdentifier",
+    id: "e12b8732389d7406",
+    size: new $__namespace.ObjectSize(0, 2)
+  };
+  /**
+  * An additional identifier for the file.
+  *
+  */
+  get path() {
+    return $__namespace.utils.getText(0, this);
+  }
+  set path(value) {
+    $__namespace.utils.setText(0, value, this);
+  }
+  get id() {
+    return $__namespace.utils.getText(1, this);
+  }
+  set id(value) {
+    $__namespace.utils.setText(1, value, this);
+  }
+  toString() {
+    return "FileIdentifier_" + super.toString();
+  }
+};
+var FileData = class extends $__namespace.Struct {
+  static {
+    chunkUSNT2KNT_cjs.__name(this, "FileData");
+  }
+  static _capnp = {
+    displayName: "FileData",
+    id: "fa6725c8a360f9a2",
+    size: new $__namespace.ObjectSize(0, 2)
+  };
+  /**
+  * The contents of the file.
+  *
+  */
+  get path() {
+    return $__namespace.utils.getText(0, this);
+  }
+  set path(value) {
+    $__namespace.utils.setText(0, value, this);
+  }
+  get content() {
+    return $__namespace.utils.getText(1, this);
+  }
+  set content(value) {
+    $__namespace.utils.setText(1, value, this);
+  }
+  toString() {
+    return "FileData_" + super.toString();
+  }
+};
+var FileSystemData = class _FileSystemData extends $__namespace.Struct {
+  static {
+    chunkUSNT2KNT_cjs.__name(this, "FileSystemData");
+  }
+  static _capnp = {
+    displayName: "FileSystemData",
+    id: "aaa72a672ac0732f",
+    size: new $__namespace.ObjectSize(0, 3)
+  };
+  static _Ids;
+  static _Metadata;
+  static _Files;
+  _adoptIds(value) {
+    $__namespace.utils.adopt(value, $__namespace.utils.getPointer(0, this));
+  }
+  _disownIds() {
+    return $__namespace.utils.disown(this.ids);
+  }
+  get ids() {
+    return $__namespace.utils.getList(0, _FileSystemData._Ids, this);
+  }
+  _hasIds() {
+    return !$__namespace.utils.isNull($__namespace.utils.getPointer(0, this));
+  }
+  _initIds(length) {
+    return $__namespace.utils.initList(0, _FileSystemData._Ids, length, this);
+  }
+  set ids(value) {
+    $__namespace.utils.copyFrom(value, $__namespace.utils.getPointer(0, this));
+  }
+  _adoptMetadata(value) {
+    $__namespace.utils.adopt(value, $__namespace.utils.getPointer(1, this));
+  }
+  _disownMetadata() {
+    return $__namespace.utils.disown(this.metadata);
+  }
+  get metadata() {
+    return $__namespace.utils.getList(1, _FileSystemData._Metadata, this);
+  }
+  _hasMetadata() {
+    return !$__namespace.utils.isNull($__namespace.utils.getPointer(1, this));
+  }
+  _initMetadata(length) {
+    return $__namespace.utils.initList(1, _FileSystemData._Metadata, length, this);
+  }
+  set metadata(value) {
+    $__namespace.utils.copyFrom(value, $__namespace.utils.getPointer(1, this));
+  }
+  _adoptFiles(value) {
+    $__namespace.utils.adopt(value, $__namespace.utils.getPointer(2, this));
+  }
+  _disownFiles() {
+    return $__namespace.utils.disown(this.files);
+  }
+  get files() {
+    return $__namespace.utils.getList(2, _FileSystemData._Files, this);
+  }
+  _hasFiles() {
+    return !$__namespace.utils.isNull($__namespace.utils.getPointer(2, this));
+  }
+  _initFiles(length) {
+    return $__namespace.utils.initList(2, _FileSystemData._Files, length, this);
+  }
+  set files(value) {
+    $__namespace.utils.copyFrom(value, $__namespace.utils.getPointer(2, this));
+  }
+  toString() {
+    return "FileSystemData_" + super.toString();
+  }
+};
+FileMetadata._Properties = $__namespace.CompositeList(FileMetadata_KeyValuePair);
+FileSystemData._Ids = $__namespace.CompositeList(FileIdentifier);
+FileSystemData._Metadata = $__namespace.CompositeList(FileMetadata);
+FileSystemData._Files = $__namespace.CompositeList(FileData);
+
+// src/types/vfs.ts
+var __VFS_PATCH__ = Symbol("__VFS_PATCH__");
+var __VFS_REVERT__ = Symbol("__VFS_REVERT__");
 function isBufferEncoding(options) {
   return isSetString.isSetString(options) || options === null;
 }
@@ -478,46 +619,201 @@ function patchFS(originalFS, vfs) {
   };
 }
 chunkUSNT2KNT_cjs.__name(patchFS, "patchFS");
-var VirtualFileSystem = class {
+var UnifiedFS = class _UnifiedFS extends unionfs.Union {
   static {
-    chunkUSNT2KNT_cjs.__name(this, "VirtualFileSystem");
+    chunkUSNT2KNT_cjs.__name(this, "UnifiedFS");
   }
   /**
   * The internal map of virtual files.
   */
-  #meta = {};
+  #virtualFS = new volume.Volume();
   /**
-  * A map of unique identifiers to their virtual file paths.
+  * The physical file system.
   */
-  #ids = {};
+  #physicalFS = cloneFS(fs__default.default);
   /**
-  * A map of virtual file paths to their underlying file content.
+  * The context of the unified file system.
   */
-  #cachedFS = /* @__PURE__ */ new Map();
+  #context;
+  static create(context, data) {
+    let result = new _UnifiedFS(context, data);
+    result = result.use(result.#physicalFS);
+    if (result.#context.config.output.mode !== "fs") {
+      result = result.use(result.#virtualFS);
+    }
+    return result;
+  }
   /**
-  * A map of virtual file paths to their underlying file content.
+  * Gets the virtual file system (VFS).
   */
-  #cachedResolver = /* @__PURE__ */ new Map();
+  get virtual() {
+    return this.#virtualFS;
+  }
   /**
-  * The internal map of virtual files.
+  * Gets the physical file system (FS).
   */
-  #virtualFS = new memfs.Volume();
+  get physical() {
+    return this.#physicalFS;
+  }
   /**
-  * The physical file system.
+  * Creates a new instance of the 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.
   */
-  #fs = cloneFS(fs__default.default);
+  constructor(context, data) {
+    super();
+    this.#context = context;
+    if (!this.#physicalFS.existsSync(this.#context.dataPath)) {
+      this.#physicalFS.mkdirSync(this.#context.dataPath, {
+        recursive: true
+      });
+    }
+    if (!this.#physicalFS.existsSync(this.#context.cachePath)) {
+      this.#physicalFS.mkdirSync(this.#context.cachePath, {
+        recursive: true
+      });
+    }
+    if (!this.#physicalFS.existsSync(join.joinPaths(this.#context.workspaceConfig.workspaceRoot, this.#context.config.output.outputPath))) {
+      this.#physicalFS.mkdirSync(join.joinPaths(this.#context.workspaceConfig.workspaceRoot, this.#context.config.output.outputPath), {
+        recursive: true
+      });
+    }
+    if (this.#context.config.output.mode !== "fs") {
+      this.#virtualFS = volume.Volume.fromJSON(data._hasFiles() && data.files.length > 0 ? data.files.values().reduce((ret, file) => {
+        ret[file.path] = file.content;
+        return ret;
+      }, {}) : {});
+      if (!this.#virtualFS.existsSync(this.#context.artifactsPath)) {
+        this.#virtualFS.mkdirSync(this.#context.artifactsPath, {
+          recursive: true
+        });
+      }
+      if (!this.#virtualFS.existsSync(this.#context.builtinsPath)) {
+        this.#virtualFS.mkdirSync(this.#context.builtinsPath, {
+          recursive: true
+        });
+      }
+      if (!this.#virtualFS.existsSync(this.#context.entryPath)) {
+        this.#virtualFS.mkdirSync(this.#context.entryPath, {
+          recursive: true
+        });
+      }
+      if (!this.#virtualFS.existsSync(this.#context.dtsPath)) {
+        this.#virtualFS.mkdirSync(this.#context.dtsPath, {
+          recursive: true
+        });
+      }
+    } else if (this.#context.config.projectType === "application") {
+      if (!this.#physicalFS.existsSync(this.#context.artifactsPath)) {
+        this.#physicalFS.mkdirSync(this.#context.artifactsPath, {
+          recursive: true
+        });
+      }
+      if (!this.#physicalFS.existsSync(this.#context.builtinsPath)) {
+        this.#physicalFS.mkdirSync(this.#context.builtinsPath, {
+          recursive: true
+        });
+      }
+      if (!this.#physicalFS.existsSync(this.#context.entryPath)) {
+        this.#physicalFS.mkdirSync(this.#context.entryPath, {
+          recursive: true
+        });
+      }
+      if (!this.#physicalFS.existsSync(this.#context.dtsPath)) {
+        this.#physicalFS.mkdirSync(this.#context.dtsPath, {
+          recursive: true
+        });
+      }
+    }
+  }
+  /**
+  * Select the file system module to use for the operation based on the path or URL.
+  *
+  * @param pathOrUrl - The path to perform the file system operation on.
+  * @param options - Options for the operation, such as output mode.
+  * @returns The file system module used for the operation.
+  */
+  resolveFS(pathOrUrl, options = {}) {
+    const mode = this.resolveMode(pathOrUrl, options);
+    if (mode === "virtual") {
+      return {
+        ...this.#virtualFS,
+        mode: "virtual"
+      };
+    } else if (mode === "fs") {
+      return {
+        ...this.#physicalFS,
+        mode: "fs"
+      };
+    }
+    return {
+      ...this,
+      mode: this.#context.config.output.mode
+    };
+  }
+  /**
+  * Select the file system module to use for the operation based on the path or URL.
+  *
+  * @param pathOrUrl - The path to perform the file system operation on.
+  * @param options - Options for the operation, such as output mode.
+  * @returns The file system module used for the operation.
+  */
+  resolveMode(pathOrUrl, options = {}) {
+    if (options.mode === "virtual" && this.#context.config.output.mode !== "fs" && isParentPath.isParentPath(toFilePath(pathOrUrl), this.#context.artifactsPath)) {
+      return "virtual";
+    } else if (options.mode === "fs" || this.#context.config.output.mode === "fs" || isParentPath.isParentPath(toFilePath(pathOrUrl), this.#context.dataPath) || isParentPath.isParentPath(toFilePath(pathOrUrl), this.#context.cachePath) || isParentPath.isParentPath(toFilePath(pathOrUrl), join.joinPaths(this.#context.workspaceConfig.workspaceRoot, this.#context.config.output.outputPath))) {
+      return "fs";
+    }
+    return void 0;
+  }
+  /**
+  * Serializes the virtual file system (VFS) to a JSON object.
+  *
+  * @returns A JSON representation of the virtual file system.
+  */
+  toJSON() {
+    return this.#virtualFS.toJSON();
+  }
+};
+
+// src/lib/fs/vfs.ts
+var VirtualFileSystem = class _VirtualFileSystem {
+  static {
+    chunkUSNT2KNT_cjs.__name(this, "VirtualFileSystem");
+  }
+  /**
+  * A map of virtual file IDs to their associated metadata.
+  */
+  #metadata;
+  /**
+  * A map of virtual file IDs to their underlying file paths.
+  */
+  #ids;
+  /**
+  * A map of underlying file paths to their virtual file IDs.
+  */
+  #paths;
+  /**
+  * A map of virtual file paths to their underlying file content.
+  */
+  #cachedResolver = /* @__PURE__ */ new Map();
   /**
   * The unified volume that combines the virtual file system with the real file system.
   *
   * @remarks
   * This volume allows for seamless access to both virtual and real files.
   */
-  #unifiedFS = new unionfs.Union();
+  #unifiedFS;
   /**
   * Indicator specifying if the file system module is patched
   */
   #isPatched = false;
   /**
+  * Indicator specifying if the virtual file system (VFS) is disposed
+  */
+  #isDisposed = false;
+  /**
   * Function to revert require patch
   */
   #revert;
@@ -537,160 +833,275 @@ var VirtualFileSystem = class {
   */
   #existsSync(path) {
     const formattedPath = this.formatPath(path);
-    return this.#virtualFS.existsSync(formattedPath) || this.#fs.existsSync(formattedPath) || this.resolveFS(path).existsSync(formattedPath);
+    return this.#unifiedFS.virtual.existsSync(formattedPath) || this.#unifiedFS.physical.existsSync(formattedPath) || this.#unifiedFS.resolveFS(path).existsSync(formattedPath);
   }
   /**
-  * Exposes the internal VFS map for advanced usage.
+  * Builds a regular expression from a string pattern for path matching.
+  *
+  * @param strPattern - The string pattern to convert.
+  * @returns A regular expression for matching paths.
   */
-  get [chunkTNHDC2ZQ_cjs.__VFS_CACHE__]() {
-    return this.#cachedFS;
+  #buildRegex(strPattern) {
+    const token = "::GLOBSTAR::";
+    return new RegExp(`^${this.formatPath(strPattern).replace(/\*\*/g, token).replace(/[.+^${}()|[\]\\]/g, "\\$&").replace(/\*/g, "[^/]*").replace(/\?/g, "[^/]").replace(new RegExp(token, "g"), ".*")}$`);
   }
   /**
-  * Exposes the internal VFS resolver cache for advanced usage.
+  * Formats a file id by removing the file extension and prepending the runtime prefix.
+  *
+  * @param id - The file ID to format.
+  * @returns The formatted file ID.
   */
-  get [chunkTNHDC2ZQ_cjs.__VFS_RESOLVER__]() {
-    return this.#cachedResolver;
+  #formatId(id) {
+    const formattedId = toFilePath(id);
+    return `${this.#context.config.output.builtinPrefix}:${formattedId.replace(new RegExp(`^${this.#context.config.output.builtinPrefix}:`), "").replace(/^\\0/, "").replace(filePathFns.findFileDotExtensionSafe(formattedId), "")}`;
   }
   /**
-  * Exposes the internal VFS map for advanced usage.
+  * Resolves an id parameter to a corresponding virtual file path in the virtual file system (VFS).
+  *
+  * @param id - The id to resolve.
+  * @returns The resolved file id if it exists, otherwise undefined.
   */
-  get [chunkTNHDC2ZQ_cjs.__VFS_VIRTUAL__]() {
-    return this.#virtualFS;
+  #resolveId(id) {
+    if (this.#ids[this.#formatId(id)]) {
+      return this.#ids[this.#formatId(id)] || false;
+    }
+    return false;
   }
   /**
-  * Exposes the internal UFS map for advanced usage.
+  * Resolves a path parameter to a corresponding virtual file path in the virtual file system (VFS).
+  *
+  * @param path - The path to resolve.
+  * @param options - Optional parameters for resolving the path.
+  * @returns The resolved file path if it exists, otherwise undefined.
   */
-  get [chunkTNHDC2ZQ_cjs.__VFS_UNIFIED__]() {
-    return this.#unifiedFS;
+  #resolvePath(path, options = {}) {
+    if (isType.isAbsolutePath(path)) {
+      if (this.#existsSync(path)) {
+        return path;
+      }
+      const result = this.#checkVariants(path);
+      if (result) {
+        return result;
+      }
+    }
+    for (const parentPath of this.#resolveParentPaths(path, options.paths)) {
+      const request = joinPaths.joinPaths(parentPath, path);
+      if (this.#existsSync(request)) {
+        return request;
+      }
+      const result = this.#checkVariants(request);
+      if (result) {
+        return result;
+      }
+    }
+    return false;
   }
   /**
-  * A proxy to access the underlying file metadata.
+  * Resolves parent paths for a given request.
+  *
+  * @param request - The request path to resolve parent paths for.
+  * @param parents - An optional array of parent paths to consider.
+  * @returns An array of resolved parent paths.
   */
-  get meta() {
-    return new Proxy(this.#meta, {
-      get: /* @__PURE__ */ chunkUSNT2KNT_cjs.__name((target, prop) => {
-        if (target[prop]) {
-          return {
-            id: prop,
-            mode: this.#virtualFS.existsSync(prop) ? "virtual" : this.#fs.existsSync(prop) ? "fs" : this.#context.config.output.mode,
-            details: {},
-            variant: "normal",
-            ...target[prop]
-          };
+  #resolveParentPaths(request, parents = []) {
+    let paths = [
+      this.#context.workspaceConfig.workspaceRoot,
+      joinPaths.joinPaths(this.#context.workspaceConfig.workspaceRoot, this.#context.config.projectRoot)
+    ];
+    if (this.#context.tsconfig.options.paths) {
+      paths = this.#context.tsconfig.options.paths ? Object.keys(this.#context.tsconfig.options.paths).filter((tsconfigPath) => request.startsWith(tsconfigPath.replaceAll("*", ""))).map((tsconfigPath) => this.#context.tsconfig.options.paths?.[tsconfigPath]).flat().reduce((ret, path) => {
+        if (path && !ret.includes(joinPaths.joinPaths(this.#context.workspaceConfig.workspaceRoot, path))) {
+          ret.push(joinPaths.joinPaths(this.#context.workspaceConfig.workspaceRoot, path));
         }
-        return void 0;
-      }, "get"),
-      set: /* @__PURE__ */ chunkUSNT2KNT_cjs.__name((target, prop, value) => {
-        target[prop] = value;
-        this.#ids[value.id || prop] = prop;
-        return true;
-      }, "set"),
-      deleteProperty: /* @__PURE__ */ chunkUSNT2KNT_cjs.__name((target, prop) => {
-        delete this.#ids[target[prop]?.id || prop];
-        delete target[prop];
-        return true;
-      }, "deleteProperty")
-    });
+        return ret;
+      }, paths) : paths;
+    }
+    return paths.reduce((ret, path) => {
+      if (!ret.includes(path)) {
+        ret.push(path);
+      }
+      return ret;
+    }, parents.filter(Boolean).map((p) => this.formatPath(p)));
   }
   /**
-  * A map of module ids to their file paths.
+  * Clears the resolver cache for a given path.
+  *
+  * @param path - The path to clear the resolver cache for.
   */
-  get ids() {
-    return this.#ids;
+  #clearResolverCache(path) {
+    this.#cachedResolver.keys().filter((key) => key.startsWith(toFilePath(path))).forEach((key) => this.#cachedResolver.delete(key));
   }
   /**
-  * Creates a new instance of the VirtualFileSystem.
+  * Check if the file exists with different variants (index, extensions).
   *
-  * @param context - The context of the virtual file system, typically containing options and logging functions.
-  * @param serialized - A map of files/file contents to populate in cache
+  * @param request - The request path to check.
+  * @param parentPath - An optional parent path to prepend to the request.
+  * @returns The file path if it exists, otherwise false.
   */
-  constructor(context, serialized = {}) {
-    this.#context = context;
-    this.#cachedFS = /* @__PURE__ */ new Map();
-    this.#meta = Object.fromEntries(Object.entries(serialized.virtualFilesMeta ?? {}));
-    this.#ids = Object.fromEntries(Object.entries(this.#meta).map(([path, data]) => [
-      data.id || path,
-      path
-    ]));
-    if (!this.#fs.existsSync(this.#context.dataPath)) {
-      this.#fs.mkdirSync(this.#context.dataPath, {
-        recursive: true
-      });
+  #checkVariants(request, parentPath) {
+    const path = parentPath ? joinPaths.joinPaths(parentPath, request) : request;
+    let file = this.#checkExtensions(path);
+    if (file) {
+      return file;
     }
-    if (!this.#fs.existsSync(this.#context.cachePath)) {
-      this.#fs.mkdirSync(this.#context.cachePath, {
-        recursive: true
-      });
+    file = this.#checkIndex(path);
+    if (file) {
+      return file;
     }
-    if (!this.#fs.existsSync(joinPaths.joinPaths(this.#context.workspaceConfig.workspaceRoot, this.#context.config.output.outputPath))) {
-      this.#fs.mkdirSync(joinPaths.joinPaths(this.#context.workspaceConfig.workspaceRoot, this.#context.config.output.outputPath), {
-        recursive: true
-      });
+    return false;
+  }
+  /**
+  * Check if the index file exists in the given request path.
+  *
+  * @param request - The request path to check.
+  * @returns The index file path if it exists, otherwise false.
+  */
+  #checkIndex(request) {
+    let file = joinPaths.joinPaths(request, "index");
+    if (this.#existsSync(file)) {
+      return file;
     }
-    this.#unifiedFS = this.#unifiedFS.use(this.#fs);
-    if (this.#context.config.output.mode !== "fs") {
-      if (serialized?.virtualFiles && Object.keys(serialized.virtualFiles).length > 0) {
-        this.#virtualFS = memfs.Volume.fromJSON(serialized.virtualFiles);
-      }
-      if (!this.#virtualFS.existsSync(this.#context.artifactsPath)) {
-        this.#virtualFS.mkdirSync(this.#context.artifactsPath, {
-          recursive: true
-        });
-      }
-      if (!this.#virtualFS.existsSync(this.#context.builtinsPath)) {
-        this.#virtualFS.mkdirSync(this.#context.builtinsPath, {
-          recursive: true
-        });
-      }
-      if (!this.#virtualFS.existsSync(this.#context.entryPath)) {
-        this.#virtualFS.mkdirSync(this.#context.entryPath, {
-          recursive: true
-        });
-      }
-      if (!this.#virtualFS.existsSync(this.#context.dtsPath)) {
-        this.#virtualFS.mkdirSync(this.#context.dtsPath, {
-          recursive: true
-        });
-      }
-      this.#unifiedFS = this.#unifiedFS.use(this.#virtualFS);
-    } else if (this.#context.config.projectType === "application") {
-      if (!this.#fs.existsSync(this.#context.artifactsPath)) {
-        this.#fs.mkdirSync(this.#context.artifactsPath, {
-          recursive: true
-        });
-      }
-      if (!this.#fs.existsSync(this.#context.builtinsPath)) {
-        this.#fs.mkdirSync(this.#context.builtinsPath, {
-          recursive: true
-        });
-      }
-      if (!this.#fs.existsSync(this.#context.entryPath)) {
-        this.#fs.mkdirSync(this.#context.entryPath, {
-          recursive: true
-        });
-      }
-      if (!this.#fs.existsSync(this.#context.dtsPath)) {
-        this.#fs.mkdirSync(this.#context.dtsPath, {
-          recursive: true
-        });
-      }
+    file = this.#checkExtensions(file);
+    if (file) {
+      return file;
+    }
+    return false;
+  }
+  /**
+  * Check if the file exists with different extensions.
+  *
+  * @param request - The request path to check.
+  * @returns The file path if it exists with any of the checked extensions, otherwise false.
+  */
+  #checkExtensions(request) {
+    let file = `${request}.ts`;
+    if (this.#existsSync(file)) {
+      return file;
+    }
+    file = `${request}.mts`;
+    if (this.#existsSync(file)) {
+      return file;
+    }
+    file = `${request}.cts`;
+    if (this.#existsSync(file)) {
+      return file;
+    }
+    file = `${request}.tsx`;
+    if (this.#existsSync(file)) {
+      return file;
+    }
+    file = `${request}.js`;
+    if (this.#existsSync(file)) {
+      return file;
+    }
+    file = `${request}.mjs`;
+    if (this.#existsSync(file)) {
+      return file;
     }
-    this.#log = chunkJA4HSQRN_cjs.extendLog(this.#context.log, "virtual-file-system");
+    file = `${request}.cjs`;
+    if (this.#existsSync(file)) {
+      return file;
+    }
+    file = `${request}.jsx`;
+    if (this.#existsSync(file)) {
+      return file;
+    }
+    file = `${request}.json`;
+    if (this.#existsSync(file)) {
+      return file;
+    }
+    file = `${request}.d.ts`;
+    if (this.#existsSync(file)) {
+      return file;
+    }
+    return false;
   }
-  [chunkTNHDC2ZQ_cjs.__VFS_INIT__]() {
-    if (!this.#isPatched && this.#context.config.output.mode !== "fs") {
-      this.#revert = patchFS(fs__default.default, this);
-      this.#isPatched = true;
+  /**
+  * 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 async create(context) {
+    if (!context.config.skipCache && exists.existsSync(joinPaths.joinPaths(context.cachePath, "fs.bin"))) {
+      const buffer$1 = await buffer.readFileBuffer(joinPaths.joinPaths(context.cachePath, "fs.bin"));
+      const message2 = new $__namespace.Message(buffer$1, false);
+      return new _VirtualFileSystem(context, message2.getRoot(FileSystemData));
     }
+    const message = new $__namespace.Message();
+    return new _VirtualFileSystem(context, message.initRoot(FileSystemData));
   }
-  [chunkTNHDC2ZQ_cjs.__VFS_REVERT__]() {
-    if (this.#isPatched && this.#context.config.output.mode !== "fs") {
-      if (!this.#revert) {
-        throw new Error("Attempting to revert File System patch prior to calling `__init__` function");
-      }
-      this.#revert?.();
-      this.#isPatched = false;
+  /**
+  * 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) {
+    if (!context.config.skipCache && exists.existsSync(joinPaths.joinPaths(context.cachePath, "fs.bin"))) {
+      const buffer$1 = buffer.readFileBufferSync(joinPaths.joinPaths(context.cachePath, "fs.bin"));
+      const message2 = new $__namespace.Message(buffer$1, false);
+      return new _VirtualFileSystem(context, message2.getRoot(FileSystemData));
+    }
+    const message = new $__namespace.Message();
+    return new _VirtualFileSystem(context, message.initRoot(FileSystemData));
+  }
+  /**
+  * A map of file ids to their metadata.
+  */
+  get metadata() {
+    return this.#metadata;
+  }
+  /**
+  * A map of module ids to their file paths.
+  */
+  get ids() {
+    return this.#ids;
+  }
+  /**
+  * A map of virtual file paths to their IDs.
+  */
+  get paths() {
+    return this.#paths;
+  }
+  /**
+  * 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.
+  */
+  constructor(context, data) {
+    this.#context = context;
+    this.#unifiedFS = UnifiedFS.create(context, data);
+    this.#metadata = {};
+    if (data._hasMetadata()) {
+      this.#metadata = data.metadata.values().reduce((ret, data2) => {
+        ret[data2.id] = {
+          id: data2.id,
+          variant: data2.variant,
+          mode: data2.mode,
+          properties: data2._hasProperties() ? data2.properties.values().reduce((ret2, item) => {
+            ret2[item.key] = item.value;
+            return ret2;
+          }, {}) : {}
+        };
+        return ret;
+      }, {});
+    }
+    this.#ids = {};
+    this.#paths = {};
+    if (data._hasIds()) {
+      this.#ids = data.ids.values().reduce((ret, data2) => {
+        ret[data2.id] ??= data2.path;
+        ret[data2.path] ??= data2.path;
+        return ret;
+      }, {});
+      this.#paths = data.ids.values().reduce((ret, data2) => {
+        ret[data2.path] ??= data2.id;
+        return ret;
+      }, {});
     }
+    this.#log = chunkJA4HSQRN_cjs.extendLog(this.#context.log, "file-system");
   }
   /**
   * Check if a path or id corresponds to a virtual file **(does not actually exists on disk)**.
@@ -710,7 +1121,7 @@ var VirtualFileSystem = class {
     if (!resolvedPath) {
       return false;
     }
-    return this.meta[resolvedPath]?.mode === "virtual";
+    return this.metadata[resolvedPath]?.mode === "virtual";
   }
   /**
   * Check if a path or id corresponds to a file written to the file system **(actually exists on disk)**.
@@ -719,7 +1130,7 @@ var VirtualFileSystem = class {
   * @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)**.
   */
-  isFs(pathOrId, options = {}) {
+  isPhysical(pathOrId, options = {}) {
     if (!pathOrId) {
       return false;
     }
@@ -730,18 +1141,7 @@ var VirtualFileSystem = class {
     if (!resolvedPath) {
       return false;
     }
-    return this.meta[resolvedPath]?.mode === "fs";
-  }
-  /**
-  * Check if a path exists within one of the directories specified in the tsconfig.json's `path` field.
-  *
-  * @see https://www.typescriptlang.org/tsconfig#paths
-  *
-  * @param pathOrId - The path or ID to check.
-  * @returns Whether the path or ID corresponds to a virtual file.
-  */
-  isTsconfigPath(pathOrId) {
-    return !!this.#context.tsconfig.options.paths && Object.keys(this.#context.tsconfig.options.paths).some((path) => pathOrId.startsWith(path.replaceAll("*", "")));
+    return this.metadata[resolvedPath]?.mode === "fs";
   }
   /**
   * Lists files in a given path.
@@ -751,7 +1151,7 @@ var VirtualFileSystem = class {
   * @returns An array of file names in the specified path.
   */
   readdirSync(path, options = "utf8") {
-    return this.resolveFS(path).readdirSync(toFilePath(path), options);
+    return this.#unifiedFS.resolveFS(path).readdirSync(toFilePath(path), options);
   }
   /**
   * Removes a file in the virtual file system (VFS).
@@ -764,9 +1164,11 @@ var VirtualFileSystem = class {
       return;
     }
     this.#log(types.LogLevelLabel.TRACE, `Synchronously removing file: ${formattedPath}`);
-    this.resolveFS(path, options).unlinkSync(formattedPath);
-    this.#cachedFS.delete(formattedPath);
-    this.clearResolverCache(formattedPath);
+    this.#unifiedFS.resolveFS(path, options).unlinkSync(formattedPath);
+    if (this.paths[formattedPath] && this.metadata[this.paths[formattedPath]]) {
+      delete this.metadata[this.paths[formattedPath]];
+    }
+    this.#clearResolverCache(formattedPath);
   }
   /**
   * Removes a file in the virtual file system (VFS).
@@ -779,10 +1181,12 @@ var VirtualFileSystem = class {
       return;
     }
     this.#log(types.LogLevelLabel.TRACE, `Removing file: ${formattedPath}`);
-    if (isFunction.isFunction(this.resolveFS(path, options).promises.unlink)) {
-      await this.resolveFS(path, options).promises.unlink(formattedPath);
-      this.#cachedFS.delete(formattedPath);
-      this.clearResolverCache(formattedPath);
+    if (isFunction.isFunction(this.#unifiedFS.resolveFS(path, options).promises.unlink)) {
+      await this.#unifiedFS.resolveFS(path, options).promises.unlink(formattedPath);
+      if (this.paths[formattedPath] && this.metadata[this.paths[formattedPath]]) {
+        delete this.metadata[this.paths[formattedPath]];
+      }
+      this.#clearResolverCache(formattedPath);
     } else {
       this.unlinkSync(formattedPath, options);
     }
@@ -799,11 +1203,10 @@ var VirtualFileSystem = class {
       return;
     }
     this.#log(types.LogLevelLabel.TRACE, `Synchronously removing directory: ${formattedPath}`);
-    this.resolveFS(path, options).rmdirSync(formattedPath, defu3__default.default(options, {
+    this.#unifiedFS.resolveFS(path, options).rmdirSync(formattedPath, defu2__default.default(options, {
       recursive: true
     }));
-    this.#cachedFS.delete(formattedPath);
-    this.clearResolverCache(formattedPath);
+    this.#clearResolverCache(formattedPath);
   }
   /**
   * Removes a directory in the virtual file system (VFS).
@@ -818,15 +1221,14 @@ var VirtualFileSystem = class {
       return;
     }
     this.#log(types.LogLevelLabel.TRACE, `Removing directory: ${formattedPath}`);
-    if (isFunction.isFunction(this.resolveFS(path, options).promises.rm)) {
-      await this.resolveFS(path, options).promises.rm(formattedPath, defu3__default.default(options, {
+    if (isFunction.isFunction(this.#unifiedFS.resolveFS(path, options).promises.rm)) {
+      await this.#unifiedFS.resolveFS(path, options).promises.rm(formattedPath, defu2__default.default(options, {
         force: true,
         recursive: true
       }));
-      this.#cachedFS.delete(formattedPath);
-      this.clearResolverCache(formattedPath);
+      this.#clearResolverCache(formattedPath);
     } else {
-      this.rmdirSync(formattedPath, defu3__default.default(options ?? {}, {
+      this.rmdirSync(formattedPath, defu2__default.default(options ?? {}, {
         force: true,
         recursive: true
       }));
@@ -868,8 +1270,8 @@ var VirtualFileSystem = class {
   */
   mkdirSync(path, options = {}) {
     const filePath = toFilePath(path);
-    this.clearResolverCache(filePath);
-    return this.resolveFS(filePath, options).mkdirSync(filePath, defu3__default.default(options ?? {}, {
+    this.#clearResolverCache(filePath);
+    return this.#unifiedFS.resolveFS(filePath, options).mkdirSync(filePath, defu2__default.default(options ?? {}, {
       recursive: true
     }));
   }
@@ -883,16 +1285,16 @@ var VirtualFileSystem = class {
   async mkdir(path, options = {}) {
     let result;
     const filePath = toFilePath(path);
-    if (isFunction.isFunction(this.resolveFS(filePath, options).promises.mkdir)) {
-      result = await this.resolveFS(filePath, options).promises.mkdir(filePath, defu3__default.default(options ?? {}, {
+    if (isFunction.isFunction(this.#unifiedFS.resolveFS(filePath, options).promises.mkdir)) {
+      result = await this.#unifiedFS.resolveFS(filePath, options).promises.mkdir(filePath, defu2__default.default(options ?? {}, {
         recursive: true
       }));
     } else {
-      result = this.resolveFS(filePath, options).mkdirSync(filePath, defu3__default.default(options ?? {}, {
+      result = this.#unifiedFS.resolveFS(filePath, options).mkdirSync(filePath, defu2__default.default(options ?? {}, {
         recursive: true
       }));
     }
-    this.clearResolverCache(filePath);
+    this.#clearResolverCache(filePath);
     return result;
   }
   /**
@@ -940,7 +1342,7 @@ var VirtualFileSystem = class {
           if (stats.isDirectory()) {
             stack.push(full);
           } else if (stats.isFile()) {
-            if (this.buildRegex(absPattern).test(full)) {
+            if (this.#buildRegex(absPattern).test(full)) {
               const resolved = this.resolve(full, {
                 type: "file"
               });
@@ -999,7 +1401,7 @@ var VirtualFileSystem = class {
           if (stats.isDirectory()) {
             stack.push(full);
           } else if (stats.isFile()) {
-            if (this.buildRegex(absPattern).test(full)) {
+            if (this.#buildRegex(absPattern).test(full)) {
               const resolved = this.resolve(full, {
                 type: "file"
               });
@@ -1063,7 +1465,7 @@ var VirtualFileSystem = class {
   * @returns An array of file names in the specified path.
   */
   async readdir(pathOrId, options = "utf8") {
-    return this.resolveFS(pathOrId).promises.readdir(toFilePath(pathOrId), options);
+    return this.#unifiedFS.resolveFS(pathOrId).promises.readdir(toFilePath(pathOrId), options);
   }
   /**
   * Asynchronously reads a file from the virtual file system (VFS).
@@ -1079,17 +1481,13 @@ var VirtualFileSystem = class {
       type: "file"
     });
     if (filePath) {
-      if (this.#cachedFS.has(filePath)) {
-        return this.#cachedFS.get(filePath);
-      }
       let result;
-      if (isFunction.isFunction(this.resolveFS(filePath).promises.readFile)) {
-        result = (await this.resolveFS(filePath).promises.readFile(filePath, options))?.toString("utf8");
+      if (isFunction.isFunction(this.#unifiedFS.resolveFS(filePath).promises.readFile)) {
+        result = (await this.#unifiedFS.resolveFS(filePath).promises.readFile(filePath, options))?.toString("utf8");
       } else {
-        result = this.resolveFS(filePath).readFileSync(filePath, options);
+        result = this.#unifiedFS.resolveFS(filePath).readFileSync(filePath, options);
       }
       const content = isBuffer.isBuffer(result) ? bufferToString.bufferToString(result) : result;
-      this.#cachedFS.set(filePath, content);
       return content;
     }
     return void 0;
@@ -1108,12 +1506,8 @@ var VirtualFileSystem = class {
       type: "file"
     });
     if (filePath) {
-      if (this.#cachedFS.has(filePath)) {
-        return this.#cachedFS.get(filePath);
-      }
-      const result = this.resolveFS(filePath).readFileSync(filePath, options);
+      const result = this.#unifiedFS.resolveFS(filePath).readFileSync(filePath, options);
       const content = isBuffer.isBuffer(result) ? bufferToString.bufferToString(result) : result;
-      this.#cachedFS.set(filePath, content);
       return content;
     }
     return void 0;
@@ -1141,17 +1535,15 @@ var VirtualFileSystem = class {
         });
       }
     }
-    const outputMode = this.resolveOutputMode(formattedPath, isPowerlinesWriteFileOptions(options) ? options : void 0);
-    this.#log(types.LogLevelLabel.TRACE, `Writing ${formattedPath} file to the ${outputMode === "fs" ? "" : "virtual "}file system (size: ${prettyBytes.prettyBytes(new buffer.Blob(toArray.toArray(code)).size)})`);
-    this.meta[formattedPath] = {
-      path: formattedPath,
-      code,
+    const outputMode = this.#unifiedFS.resolveMode(formattedPath, isPowerlinesWriteFileOptions(options) ? options : void 0);
+    this.#log(types.LogLevelLabel.TRACE, `Writing ${formattedPath} file to the ${outputMode === "fs" ? "" : "virtual "}file system (size: ${prettyBytes.prettyBytes(new buffer$1.Blob(toArray.toArray(code)).size)})`);
+    this.metadata[formattedPath] = {
       mode: outputMode,
       variant: "normal",
       ...isPowerLinesWriteFileData(data) ? data : {}
     };
-    this.clearResolverCache(formattedPath);
-    const ifs = this.resolveFS(formattedPath, isPowerlinesWriteFileOptions(options) ? options : void 0);
+    this.#clearResolverCache(formattedPath);
+    const ifs = this.#unifiedFS.resolveFS(formattedPath, isPowerlinesWriteFileOptions(options) ? options : void 0);
     if (isFunction.isFunction(ifs.promises.writeFile)) {
       return ifs.promises.writeFile(formattedPath, code, isNodeWriteFileOptions(options) ? options : "utf8");
     }
@@ -1170,17 +1562,15 @@ var VirtualFileSystem = class {
       this.mkdirSync(filePathFns.findFilePath(formattedPath), isPowerlinesWriteFileOptions(options) ? options : void 0);
     }
     const code = isPowerLinesWriteFileData(data) ? data.code : data;
-    const outputMode = this.resolveOutputMode(formattedPath, isPowerlinesWriteFileOptions(options) ? options : void 0);
-    this.#log(types.LogLevelLabel.TRACE, `Writing ${formattedPath} file to the ${outputMode === "fs" ? "" : "virtual "}file system (size: ${prettyBytes.prettyBytes(new buffer.Blob(toArray.toArray(code)).size)})`);
-    this.meta[formattedPath] = {
-      path: formattedPath,
-      code,
+    const outputMode = this.#unifiedFS.resolveMode(formattedPath, isPowerlinesWriteFileOptions(options) ? options : void 0);
+    this.#log(types.LogLevelLabel.TRACE, `Writing ${formattedPath} file to the ${outputMode === "fs" ? "" : "virtual "}file system (size: ${prettyBytes.prettyBytes(new buffer$1.Blob(toArray.toArray(code)).size)})`);
+    this.metadata[formattedPath] = {
       mode: outputMode,
       variant: "normal",
       ...isPowerLinesWriteFileData(data) ? data : {}
     };
-    this.clearResolverCache(formattedPath);
-    const writeStream = this.resolveFS(formattedPath, isPowerlinesWriteFileOptions(options) ? options : void 0).createWriteStream(formattedPath);
+    this.#clearResolverCache(formattedPath);
+    const writeStream = this.#unifiedFS.resolveFS(formattedPath, isPowerlinesWriteFileOptions(options) ? options : void 0).createWriteStream(formattedPath);
     try {
       writeStream.write(code);
     } finally {
@@ -1204,8 +1594,8 @@ var VirtualFileSystem = class {
   */
   getMetadata(pathOrId) {
     const resolved = this.resolve(pathOrId);
-    if (resolved && this.meta[resolved]) {
-      return this.meta[resolved];
+    if (resolved && this.metadata[resolved]) {
+      return this.metadata[resolved];
     }
     return void 0;
   }
@@ -1217,361 +1607,265 @@ var VirtualFileSystem = class {
   *
   * @param pathOrId - The path of the file to check.
   * @returns `true` if the file exists, otherwise `false`.
-  */
-  isFile(pathOrId) {
-    const resolved = this.resolve(pathOrId);
-    return !!(resolved && (this.#virtualFS.existsSync(resolved) && this.#virtualFS.lstatSync(resolved).isFile() || this.#fs.existsSync(resolved) && this.#fs.lstatSync(resolved).isFile() || this.resolveFS(resolved).existsSync(resolved) && this.resolveFS(resolved).lstatSync(resolved).isFile()));
-  }
-  /**
-  * 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) {
-    const resolved = this.resolve(pathOrId);
-    return !!(resolved && (this.#virtualFS.existsSync(resolved) && this.#virtualFS.lstatSync(resolved).isDirectory() || this.#fs.existsSync(resolved) && this.#fs.lstatSync(resolved).isDirectory() || this.resolveFS(resolved).existsSync(resolved) && this.resolveFS(resolved).lstatSync(resolved).isDirectory()));
-  }
-  /**
-  * 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.
-  */
-  async stat(pathOrId, options) {
-    return this.resolveFS(pathOrId).promises.stat(this.resolve(toFilePath(pathOrId)) || toFilePath(pathOrId), options);
-  }
-  /**
-  * 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) {
-    return this.resolveFS(pathOrId).statSync(this.resolve(toFilePath(pathOrId)) || toFilePath(pathOrId));
-  }
-  /**
-  * 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.
-  */
-  async lstat(pathOrId, options) {
-    return this.resolveFS(pathOrId).promises.lstat(this.resolve(toFilePath(pathOrId)) || toFilePath(pathOrId), options);
-  }
-  /**
-  * 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, options) {
-    return this.resolveFS(pathOrId).lstatSync(this.resolve(toFilePath(pathOrId)) || toFilePath(pathOrId), options);
-  }
-  /**
-  * Resolves a path based on TypeScript's `tsconfig.json` paths.
-  *
-  * @see https://www.typescriptlang.org/tsconfig#paths
-  *
-  * @param path - The path to check.
-  * @returns The resolved file path if it exists, otherwise undefined.
-  */
-  resolveTsconfigPath(path) {
-    if (this.#context.tsconfig.options.paths) {
-      for (const tsconfigPathKey of Object.keys(this.#context.tsconfig.options.paths).filter((tsconfigPath) => path.startsWith(tsconfigPath.replaceAll("*", "")))) {
-        const resolvedPath = this.#context.tsconfig.options.paths[tsconfigPathKey]?.find((tsconfigPath) => this.resolvePath(joinPaths.joinPaths(this.#context.workspaceConfig.workspaceRoot, tsconfigPath.replaceAll("*", ""), path.replace(tsconfigPathKey.replaceAll("*", ""), ""))) || this.formatPath(tsconfigPath) === this.formatPath(path));
-        if (resolvedPath) {
-          return this.formatPath(resolvedPath) === this.formatPath(path) ? this.formatPath(resolvedPath) : this.resolvePath(joinPaths.joinPaths(this.#context.workspaceConfig.workspaceRoot, resolvedPath.replaceAll("*", ""), path.replace(tsconfigPathKey.replaceAll("*", ""), "")));
-        }
-      }
-    }
-    return false;
-  }
-  /**
-  * Resolves a path based on TypeScript's `tsconfig.json` paths.
-  *
-  * @see https://www.typescriptlang.org/tsconfig#paths
-  *
-  * @param path - The path to check.
-  * @returns The resolved file path if it exists, otherwise undefined.
-  */
-  resolveTsconfigPathPackage(path) {
-    if (this.#context.tsconfig.options.paths) {
-      const tsconfigPathKeys = Object.keys(this.#context.tsconfig.options.paths).filter((tsconfigPath) => path.startsWith(tsconfigPath.replaceAll("*", "")));
-      if (tsconfigPathKeys.length > 0 && tsconfigPathKeys[0]) {
-        return tsconfigPathKeys[0].replace(/\/\*$/, "");
-      }
-    }
-    return false;
-  }
-  /**
-  * 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) {
-    const filePath = this.resolve(toFilePath(pathOrId));
-    if (!filePath) {
-      throw new Error(`File not found: ${toFilePath(pathOrId)}`);
-    }
-    return filePath;
-  }
-  /**
-  * 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, options = {}) {
-    const formattedPathOrId = toFilePath(pathOrId);
-    const resolverKey = `${formattedPathOrId}${options.withExtension ? "-ext" : ""}${options.paths ? `-${murmurhash.murmurhash(options.paths)}` : ""}${options.type ? `-${options.type}` : ""}`;
-    if (this.#cachedResolver.has(resolverKey)) {
-      return this.#cachedResolver.get(resolverKey);
-    }
-    let result = this.resolveId(formattedPathOrId);
-    if (!result) {
-      result = this.resolvePath(formattedPathOrId, options);
-    }
-    if (!result) {
-      result = false;
-    }
-    if (result && options.withExtension === false) {
-      return result.replace(/\.[m|c]?[t|j]sx?$/, "");
-    }
-    this.#cachedResolver.set(resolverKey, result);
-    return result;
-  }
-  /**
-  * Retrieves the partial metadata for all files in the virtual file system (VFS).
-  *
-  * @returns A record containing the partial metadata for all files.
-  */
-  getPartialMeta() {
-    return Object.fromEntries(Object.entries(this.#meta).filter(([_, data]) => isSetObject.isSetObject(data)));
-  }
-  buildRegex(strPattern) {
-    const token = "::GLOBSTAR::";
-    return new RegExp(`^${this.formatPath(strPattern).replace(/\*\*/g, token).replace(/[.+^${}()|[\]\\]/g, "\\$&").replace(/\*/g, "[^/]*").replace(/\?/g, "[^/]").replace(new RegExp(token, "g"), ".*")}$`);
-  }
-  /**
-  * 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) {
-    const formattedPath = toFilePath(path);
-    if (isType.isAbsolutePath(formattedPath) || formattedPath.startsWith(this.#context.workspaceConfig.workspaceRoot)) {
-      return formattedPath;
-    } else if (formattedPath.startsWith(this.#context.config.projectRoot)) {
-      return joinPaths.joinPaths(this.#context.workspaceConfig.workspaceRoot, formattedPath);
-    }
-    return formattedPath;
-  }
-  /**
-  * Formats a file id by removing the file extension and prepending the runtime prefix.
-  *
-  * @param id - The file ID to format.
-  * @returns The formatted file ID.
-  */
-  formatId(id) {
-    const formattedId = toFilePath(id);
-    return `${this.#context.config.output.builtinPrefix}:${formattedId.replace(new RegExp(`^${this.#context.config.output.builtinPrefix}:`), "").replace(/^\\0/, "").replace(filePathFns.findFileDotExtensionSafe(formattedId), "")}`;
-  }
-  /**
-  * Resolves an id parameter to a corresponding virtual file path in the virtual file system (VFS).
-  *
-  * @param id - The id to resolve.
-  * @returns The resolved file id if it exists, otherwise undefined.
-  */
-  resolveId(id) {
-    if (this.#ids[this.formatId(id)]) {
-      return this.#ids[this.formatId(id)] || false;
-    }
-    return false;
-  }
-  /**
-  * Resolves a path parameter to a corresponding virtual file path in the virtual file system (VFS).
-  *
-  * @param path - The path to resolve.
-  * @param options - Optional parameters for resolving the path.
-  * @returns The resolved file path if it exists, otherwise undefined.
-  */
-  resolvePath(path, options = {}) {
-    if (isType.isAbsolutePath(path)) {
-      if (this.#existsSync(path)) {
-        return path;
-      }
-      const result = this.checkVariants(path);
-      if (result) {
-        return result;
-      }
-    }
-    for (const parentPath of this.resolveParentPaths(path, options.paths)) {
-      const request = joinPaths.joinPaths(parentPath, path);
-      if (this.#existsSync(request)) {
-        return request;
-      }
-      const result = this.checkVariants(request);
-      if (result) {
-        return result;
-      }
-    }
-    return false;
-  }
-  resolveParentPaths(request, parents = []) {
-    let paths = [
-      this.#context.workspaceConfig.workspaceRoot,
-      joinPaths.joinPaths(this.#context.workspaceConfig.workspaceRoot, this.#context.config.projectRoot)
-    ];
-    if (this.#context.tsconfig.options.paths) {
-      paths = this.#context.tsconfig.options.paths ? Object.keys(this.#context.tsconfig.options.paths).filter((tsconfigPath) => request.startsWith(tsconfigPath.replaceAll("*", ""))).map((tsconfigPath) => this.#context.tsconfig.options.paths?.[tsconfigPath]).flat().reduce((ret, path) => {
-        if (path && !ret.includes(joinPaths.joinPaths(this.#context.workspaceConfig.workspaceRoot, path))) {
-          ret.push(joinPaths.joinPaths(this.#context.workspaceConfig.workspaceRoot, path));
-        }
-        return ret;
-      }, paths) : paths;
-    }
-    return paths.reduce((ret, path) => {
-      if (!ret.includes(path)) {
-        ret.push(path);
-      }
-      return ret;
-    }, parents.filter(Boolean).map((p) => this.formatPath(p)));
+  */
+  isFile(pathOrId) {
+    const resolved = this.resolve(pathOrId);
+    return !!(resolved && (this.#unifiedFS.virtual.existsSync(resolved) && this.#unifiedFS.virtual.lstatSync(resolved).isFile() || this.#unifiedFS.physical.existsSync(resolved) && this.#unifiedFS.physical.lstatSync(resolved).isFile() || this.#unifiedFS.resolveFS(resolved).existsSync(resolved) && this.#unifiedFS.resolveFS(resolved).lstatSync(resolved).isFile()));
   }
   /**
-  * Select the file system module to use for the operation based on the path or URL.
+  * Checks if a directory exists in the virtual file system (VFS).
   *
-  * @param pathOrUrl - The path to perform the file system operation on.
-  * @param options - Options for the operation, such as output mode.
-  * @returns The file system module used for the operation.
+  * @param pathOrId - The path of the directory to check.
+  * @returns `true` if the directory exists, otherwise `false`.
   */
-  resolveFS(pathOrUrl, options = {}) {
-    const mode = this.resolveOutputMode(pathOrUrl, options);
-    if (mode === "virtual") {
-      return this.#virtualFS;
-    } else if (mode === "fs") {
-      return this.#fs;
-    }
-    return this.#unifiedFS;
+  isDirectory(pathOrId) {
+    const resolved = this.resolve(pathOrId);
+    return !!(resolved && (this.#unifiedFS.virtual.existsSync(resolved) && this.#unifiedFS.virtual.lstatSync(resolved).isDirectory() || this.#unifiedFS.physical.existsSync(resolved) && this.#unifiedFS.physical.lstatSync(resolved).isDirectory() || this.#unifiedFS.resolveFS(resolved).existsSync(resolved) && this.#unifiedFS.resolveFS(resolved).lstatSync(resolved).isDirectory()));
   }
   /**
-  * Select the file system module to use for the operation based on the path or URL.
+  * Retrieves the status of a file in the virtual file system (VFS).
   *
-  * @param pathOrUrl - The path to perform the file system operation on.
-  * @param options - Options for the operation, such as output mode.
-  * @returns The file system module used for the operation.
+  * @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.
   */
-  resolveOutputMode(pathOrUrl, options = {}) {
-    if (options.mode === "virtual" && this.#context.config.output.mode !== "fs" && isParentPath.isParentPath(toFilePath(pathOrUrl), this.#context.artifactsPath)) {
-      return "virtual";
-    } else if (options.mode === "fs" || this.#context.config.output.mode === "fs" || isParentPath.isParentPath(toFilePath(pathOrUrl), this.#context.dataPath) || isParentPath.isParentPath(toFilePath(pathOrUrl), this.#context.cachePath) || isParentPath.isParentPath(toFilePath(pathOrUrl), joinPaths.joinPaths(this.#context.workspaceConfig.workspaceRoot, this.#context.config.output.outputPath))) {
-      return "fs";
-    }
-    return void 0;
+  async stat(pathOrId, options) {
+    return this.#unifiedFS.resolveFS(pathOrId).promises.stat(this.resolve(toFilePath(pathOrId)) || toFilePath(pathOrId), options);
   }
   /**
-  * Clears the resolver cache for a given path.
+  * Synchronously retrieves the status of a file in the virtual file system (VFS).
   *
-  * @param path - The path to clear the resolver cache for.
+  * @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.
   */
-  clearResolverCache(path) {
-    this.#cachedResolver.keys().filter((key) => key.startsWith(toFilePath(path))).forEach((key) => this.#cachedResolver.delete(key));
+  statSync(pathOrId) {
+    return this.#unifiedFS.resolveFS(pathOrId).statSync(this.resolve(toFilePath(pathOrId)) || toFilePath(pathOrId));
   }
   /**
-  * Check if the file exists with different variants (index, extensions).
+  * Retrieves the status of a symbolic link in the virtual file system (VFS).
   *
-  * @param request - The request path to check.
-  * @param parentPath - An optional parent path to prepend to the request.
-  * @returns The file path if it exists, otherwise false.
+  * @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.
   */
-  checkVariants(request, parentPath) {
-    const path = parentPath ? joinPaths.joinPaths(parentPath, request) : request;
-    let file = this.checkExtensions(path);
-    if (file) {
-      return file;
-    }
-    file = this.checkIndex(path);
-    if (file) {
-      return file;
-    }
-    return false;
+  async lstat(pathOrId, options) {
+    return this.#unifiedFS.resolveFS(pathOrId).promises.lstat(this.resolve(toFilePath(pathOrId)) || toFilePath(pathOrId), options);
   }
   /**
-  * Check if the index file exists in the given request path.
+  * Synchronously retrieves the status of a symbolic link in the virtual file system (VFS).
   *
-  * @param request - The request path to check.
-  * @returns The index file path if it exists, otherwise false.
+  * @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.
   */
-  checkIndex(request) {
-    let file = joinPaths.joinPaths(request, "index");
-    if (this.#existsSync(file)) {
-      return file;
-    }
-    file = this.checkExtensions(file);
-    if (file) {
-      return file;
-    }
-    return false;
+  lstatSync(pathOrId, options) {
+    return this.#unifiedFS.resolveFS(pathOrId).lstatSync(this.resolve(toFilePath(pathOrId)) || toFilePath(pathOrId), options);
   }
   /**
-  * Check if the file exists with different extensions.
+  * Resolves a path or ID to its real path in the virtual file system (VFS).
   *
-  * @param request - The request path to check.
-  * @param vfs - The file system module to use for checking file existence.
-  * @returns The file path if it exists with any of the checked extensions, otherwise false.
+  * @param pathOrId - The path or ID to resolve.
+  * @returns The resolved real path if it exists, otherwise undefined.
   */
-  checkExtensions(request) {
-    let file = `${request}.ts`;
-    if (this.#existsSync(file)) {
-      return file;
-    }
-    file = `${request}.mts`;
-    if (this.#existsSync(file)) {
-      return file;
+  realpathSync(pathOrId) {
+    const filePath = this.resolve(toFilePath(pathOrId));
+    if (!filePath) {
+      throw new Error(`File not found: ${toFilePath(pathOrId)}`);
     }
-    file = `${request}.cts`;
-    if (this.#existsSync(file)) {
-      return file;
+    return filePath;
+  }
+  /**
+  * 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, options = {}) {
+    const formattedPathOrId = toFilePath(pathOrId);
+    const resolverKey = `${formattedPathOrId}${options.withExtension ? "-ext" : ""}${options.paths ? `-${murmurhash.murmurhash(options.paths)}` : ""}${options.type ? `-${options.type}` : ""}`;
+    if (this.#cachedResolver.has(resolverKey)) {
+      return this.#cachedResolver.get(resolverKey);
     }
-    file = `${request}.tsx`;
-    if (this.#existsSync(file)) {
-      return file;
+    let result = this.#resolveId(formattedPathOrId);
+    if (!result) {
+      result = this.#resolvePath(formattedPathOrId, options);
     }
-    file = `${request}.js`;
-    if (this.#existsSync(file)) {
-      return file;
+    if (!result) {
+      result = false;
     }
-    file = `${request}.mjs`;
-    if (this.#existsSync(file)) {
-      return file;
+    if (result && options.withExtension === false) {
+      return result.replace(/\.[m|c]?[t|j]sx?$/, "");
     }
-    file = `${request}.cjs`;
-    if (this.#existsSync(file)) {
-      return file;
+    this.#cachedResolver.set(resolverKey, result);
+    return result;
+  }
+  /**
+  * 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) {
+    const formattedPath = toFilePath(path);
+    if (isType.isAbsolutePath(formattedPath) || formattedPath.startsWith(this.#context.workspaceConfig.workspaceRoot)) {
+      return formattedPath;
+    } else if (formattedPath.startsWith(this.#context.config.projectRoot)) {
+      return joinPaths.joinPaths(this.#context.workspaceConfig.workspaceRoot, formattedPath);
     }
-    file = `${request}.jsx`;
-    if (this.#existsSync(file)) {
-      return file;
+    return formattedPath;
+  }
+  /**
+  * Disposes of the virtual file system (VFS) by saving its state to disk.
+  */
+  async dispose() {
+    if (!this.#isDisposed) {
+      this.#isDisposed = true;
+      this.#log(types.LogLevelLabel.DEBUG, "Disposing virtual file system...");
+      await this.unlink(joinPaths.joinPaths(this.#context.cachePath, "fs.bin"));
+      const message = new $__namespace.Message();
+      const data = message.initRoot(FileSystemData);
+      const virtualFS = this.#unifiedFS.toJSON();
+      const files = data._initFiles(Object.keys(virtualFS).length);
+      Object.entries(virtualFS).filter(([_, content]) => content).forEach(([path, content], index) => {
+        const fileData = files.get(index);
+        fileData.path = path;
+        fileData.content = content;
+      });
+      const ids = data._initIds(Object.keys(this.ids).length);
+      Object.entries(this.ids).forEach(([id, path], index) => {
+        const fileId = ids.get(index);
+        fileId.id = id;
+        fileId.path = path;
+      });
+      const metadata = data._initMetadata(Object.keys(this.metadata).length);
+      Object.entries(this.metadata).forEach(([id, value], index) => {
+        const fileMetadata = metadata.get(index);
+        fileMetadata.id = id;
+        fileMetadata.mode = value.mode;
+        fileMetadata.variant = value.variant;
+        if (value.properties) {
+          const props = fileMetadata._initProperties(Object.keys(value.properties).length);
+          Object.entries(value.properties).forEach(([key, val], propIndex) => {
+            const propData = props.get(propIndex);
+            propData.key = key;
+            propData.value = val;
+          });
+        }
+      });
+      await buffer.writeFileBuffer(joinPaths.joinPaths(this.#context.cachePath, "fs.bin"), message.toArrayBuffer());
     }
-    file = `${request}.json`;
-    if (this.#existsSync(file)) {
-      return file;
+  }
+  /**
+  * Initializes the virtual file system (VFS) by patching the file system module if necessary.
+  */
+  [__VFS_PATCH__]() {
+    if (!this.#isPatched && this.#context.config.output.mode !== "fs") {
+      this.#revert = patchFS(fs__default.default, this);
+      this.#isPatched = true;
     }
-    file = `${request}.d.ts`;
-    if (this.#existsSync(file)) {
-      return file;
+  }
+  /**
+  * Reverts the file system module to its original state if it was previously patched.
+  */
+  [__VFS_REVERT__]() {
+    if (this.#isPatched && this.#context.config.output.mode !== "fs") {
+      if (!this.#revert) {
+        throw new Error("Attempting to revert File System patch prior to calling `__init__` function");
+      }
+      this.#revert?.();
+      this.#isPatched = false;
     }
-    return false;
+  }
+  async [Symbol.asyncDispose]() {
+    return this.dispose();
   }
 };
-function createVfs(context) {
-  const vfs = new VirtualFileSystem(context);
-  return vfs;
+
+// src/types/commands.ts
+var SUPPORTED_COMMANDS = [
+  "new",
+  "clean",
+  "prepare",
+  "lint",
+  "test",
+  "build",
+  "docs",
+  "deploy",
+  "finalize"
+];
+
+// src/plugin-utils/helpers.ts
+function isPlugin(value) {
+  return isSetObject.isSetObject(value) && "name" in value && isSetString.isSetString(value.name) && (isUndefined.isUndefined(value.applyToEnvironment) || "applyToEnvironment" in value && isFunction.isFunction(value.applyToEnvironment)) && (isUndefined.isUndefined(value.dedupe) || "dedupe" in value && isFunction.isFunction(value.dedupe)) && (isUndefined.isUndefined(value.dependsOn) || "dependsOn" in value && Array.isArray(value.dependsOn) && value.dependsOn.every(isPluginConfig)) && SUPPORTED_COMMANDS.every((command) => isUndefined.isUndefined(value[command]) || command in value && (isFunction.isFunction(value[command]) || isSetObject.isSetObject(value[command]) && "handler" in value[command] && isFunction.isFunction(value[command].handler)));
+}
+chunkUSNT2KNT_cjs.__name(isPlugin, "isPlugin");
+function isPluginConfigObject(value) {
+  return isSetObject.isSetObject(value) && "plugin" in value && ((isSetString.isSetString(value.plugin) || isFunction.isFunction(value.plugin)) && "options" in value && isSetObject.isSetObject(value.options) || isPlugin(value.plugin));
+}
+chunkUSNT2KNT_cjs.__name(isPluginConfigObject, "isPluginConfigObject");
+function isPluginConfigTuple(value) {
+  return Array.isArray(value) && (value.length === 1 || value.length === 2) && ((isSetString.isSetString(value[0]) || isFunction.isFunction(value[0])) && value.length > 1 && isSetObject.isSetObject(value[1]) || isPlugin(value[0]));
 }
-chunkUSNT2KNT_cjs.__name(createVfs, "createVfs");
+chunkUSNT2KNT_cjs.__name(isPluginConfigTuple, "isPluginConfigTuple");
+function isPluginConfig(value) {
+  return isSetString.isSetString(value) || isFunction.isFunction(value) || isPlugin(value) || isPluginConfigObject(value) || isPluginConfigTuple(value);
+}
+chunkUSNT2KNT_cjs.__name(isPluginConfig, "isPluginConfig");
+function isPluginHookFunction(value) {
+  return isFunction.isFunction(value) || isSetObject.isSetObject(value) && "handler" in value && isFunction.isFunction(value.handler);
+}
+chunkUSNT2KNT_cjs.__name(isPluginHookFunction, "isPluginHookFunction");
+function isPluginHookObject(value) {
+  return isSetObject.isSetObject(value) && "handler" in value && isFunction.isFunction(value.handler);
+}
+chunkUSNT2KNT_cjs.__name(isPluginHookObject, "isPluginHookObject");
+function isPluginHook(value) {
+  return isPluginHookFunction(value) || isPluginHookObject(value);
+}
+chunkUSNT2KNT_cjs.__name(isPluginHook, "isPluginHook");
+function getHookHandler(pluginHook) {
+  return isFunction.isFunction(pluginHook) ? pluginHook : pluginHook.handler;
+}
+chunkUSNT2KNT_cjs.__name(getHookHandler, "getHookHandler");
+function isHookExternal(hook) {
+  return hook.startsWith("vite:") || hook.startsWith("esbuild:") || hook.startsWith("rolldown:") || hook.startsWith("rollup:") || hook.startsWith("webpack:") || hook.startsWith("rspack:") || hook.startsWith("farm:");
+}
+chunkUSNT2KNT_cjs.__name(isHookExternal, "isHookExternal");
+function checkDedupe(plugin, plugins) {
+  return plugin.dedupe === false || plugins.some((p) => p.dedupe !== false && (isFunction.isFunction(p.dedupe) && p.dedupe(plugin) || p.name === plugin.name));
+}
+chunkUSNT2KNT_cjs.__name(checkDedupe, "checkDedupe");
+function addPluginHook(context, plugin, pluginHook, hooksList) {
+  if (!checkDedupe(plugin, hooksList.map((hook) => hook.plugin))) {
+    hooksList.push(isFunction.isFunction(pluginHook) ? {
+      plugin,
+      handler: getHookHandler(pluginHook).bind(context)
+    } : {
+      plugin,
+      ...pluginHook,
+      handler: getHookHandler(pluginHook).bind(context)
+    });
+  }
+}
+chunkUSNT2KNT_cjs.__name(addPluginHook, "addPluginHook");
+function resolveOptions(options) {
+  return defu2__default.default(options, {
+    interopDefault: true,
+    fsCache: options.mode !== "development" ? joinPaths.joinPaths(options.cacheDir, "jiti") : false,
+    moduleCache: options.mode !== "development"
+  });
+}
+chunkUSNT2KNT_cjs.__name(resolveOptions, "resolveOptions");
+function createPluginResolver(options) {
+  return jiti.createJiti(joinPaths.joinPaths(options.workspaceRoot, options.projectRoot), resolveOptions({
+    ...options
+  }));
+}
+chunkUSNT2KNT_cjs.__name(createPluginResolver, "createPluginResolver");
+function createResolver(options) {
+  const baseResolver = jiti.createJiti(joinPaths.joinPaths(options.workspaceRoot, options.projectRoot), resolveOptions(options));
+  baseResolver.plugin = createPluginResolver(options);
+  return baseResolver;
+}
+chunkUSNT2KNT_cjs.__name(createResolver, "createResolver");
 
 // src/internal/contexts/context.ts
 var configCache = /* @__PURE__ */ new WeakMap();
@@ -1662,7 +1956,7 @@ var PowerlinesContext = class _PowerlinesContext {
   * The resolved entry type definitions for the project
   */
   get entry() {
-    return chunkOTBLE55Z_cjs.resolveEntriesSync(this, toArray.toArray(this.config.entry));
+    return chunkMPCVQK2D_cjs.resolveEntriesSync(this, toArray.toArray(this.config.entry));
   }
   /**
   * The TypeScript configuration parsed from the tsconfig file
@@ -1686,7 +1980,7 @@ var PowerlinesContext = class _PowerlinesContext {
   */
   get fs() {
     if (!this.#fs) {
-      this.#fs = createVfs(this);
+      this.#fs = VirtualFileSystem.createSync(this);
     }
     return this.#fs;
   }
@@ -1709,13 +2003,11 @@ var PowerlinesContext = class _PowerlinesContext {
         workspaceRoot: this.workspaceConfig?.workspaceRoot,
         projectRoot: this.config?.projectRoot
       }, {
-        maxLength: chunkTNHDC2ZQ_cjs.PROJECT_ROOT_HASH_LENGTH
+        maxLength: chunk7XHBIYIN_cjs.PROJECT_ROOT_HASH_LENGTH
       }),
       configHash: murmurhash.murmurhash(this.config, {
-        maxLength: chunkTNHDC2ZQ_cjs.CACHE_HASH_LENGTH
-      }),
-      builtinIdMap: {},
-      virtualFiles: {}
+        maxLength: chunk7XHBIYIN_cjs.CACHE_HASH_LENGTH
+      })
     };
   }
   /**
@@ -1774,7 +2066,7 @@ var PowerlinesContext = class _PowerlinesContext {
   * Get the path to the data directory for the project
   */
   get dataPath() {
-    return join.joinPaths(this.envPaths.data, "projects", chunkTNHDC2ZQ_cjs.getPrefixedProjectRootHash(this.config.name, this.meta.projectRootHash));
+    return join.joinPaths(this.envPaths.data, "projects", chunk7XHBIYIN_cjs.getPrefixedProjectRootHash(this.config.name, this.meta.projectRootHash));
   }
   /**
   * Get the path to the cache directory for the project
@@ -1784,7 +2076,7 @@ var PowerlinesContext = class _PowerlinesContext {
       checksum: this.#checksum,
       config: this.meta.configHash
     }, {
-      maxLength: chunkTNHDC2ZQ_cjs.CACHE_HASH_LENGTH
+      maxLength: chunk7XHBIYIN_cjs.CACHE_HASH_LENGTH
     }));
   }
   /**
@@ -1803,13 +2095,13 @@ var PowerlinesContext = class _PowerlinesContext {
   * The builtin module id that exist in the Powerlines virtual file system
   */
   get builtins() {
-    return Object.values(this.fs.meta).filter((meta) => meta && meta.variant === "builtin").map((meta) => meta?.id).filter(Boolean);
+    return Object.values(this.fs.metadata).filter((meta) => meta && meta.variant === "builtin").map((meta) => meta?.id).filter(Boolean);
   }
   /**
-  * Get the project root relative to the workspace root
+  * Get the builtin virtual files that exist in the Powerlines virtual file system
   */
   async getBuiltins() {
-    return Promise.all(Object.entries(this.fs.meta).filter(([, meta]) => meta && meta.variant === "builtin").map(async ([path, meta]) => {
+    return Promise.all(Object.entries(this.fs.metadata).filter(([, meta]) => meta && meta.variant === "builtin").map(async ([path, meta]) => {
       const code = await this.fs.readFile(path);
       return {
         ...meta,
@@ -1829,7 +2121,7 @@ var PowerlinesContext = class _PowerlinesContext {
     return this.fs.writeFile(isType.isAbsolute(path) ? path : append.appendPath(path, this.entryPath), {
       code,
       variant: "entry"
-    }, defu3__default.default(options, {
+    }, defu2__default.default(options, {
       mode: this.config.output.mode
     }));
   }
@@ -1846,7 +2138,7 @@ var PowerlinesContext = class _PowerlinesContext {
       id,
       code,
       variant: "builtin"
-    }, defu3__default.default(options, {
+    }, defu2__default.default(options, {
       mode: this.config.output.mode
     }));
   }
@@ -1868,7 +2160,7 @@ var PowerlinesContext = class _PowerlinesContext {
         options
       });
     }
-    const result = await oxcParser.parseAsync(id, code, defu3__default.default(options ?? {}, {
+    const result = await oxcParser.parseAsync(id, code, defu2__default.default(options ?? {}, {
       lang: filePathFns.hasFileExtension(id) ? void 0 : "ts",
       astType: filePathFns.hasFileExtension(id) ? void 0 : "ts",
       sourceType: "module",
@@ -2037,7 +2329,7 @@ ${result.errors.map((error) => `  [${error.severity}] ${error.message}${error.co
       if (exists.existsSync(packageJsonPath)) {
         this.packageJson = await json.readJsonFile(packageJsonPath);
       }
-      this.#checksum = await chunkTNHDC2ZQ_cjs.getChecksum(cacheKey.projectRoot);
+      this.#checksum = await chunk7XHBIYIN_cjs.getChecksum(cacheKey.projectRoot);
       this.resolver = createResolver({
         workspaceRoot: this.workspaceConfig.workspaceRoot,
         projectRoot: cacheKey.projectRoot,
@@ -2056,7 +2348,7 @@ ${result.errors.map((error) => `  [${error.severity}] ${error.message}${error.co
       });
     }
     if (isSetObject.isSetObject(config)) {
-      this.resolvedConfig = defu3__default.default({
+      this.resolvedConfig = defu2__default.default({
         inlineConfig: this.config.inlineConfig,
         userConfig: this.config.userConfig
       }, options.isHighPriority ? this.#getConfigProps(config) : {}, {
@@ -2117,7 +2409,7 @@ ${result.errors.map((error) => `  [${error.severity}] ${error.message}${error.co
         }
       });
     }
-    this.config.entry = chunkOTBLE55Z_cjs.getUniqueEntries(this.config.entry);
+    this.config.entry = chunkMPCVQK2D_cjs.getUniqueEntries(this.config.entry);
     if (this.config.name?.startsWith("@") && this.config.name.split("/").filter(Boolean).length > 1) {
       this.config.name = this.config.name.split("/").filter(Boolean)[1];
     }
@@ -2150,9 +2442,10 @@ ${result.errors.map((error) => `  [${error.severity}] ${error.message}${error.co
       ret.push(plugin);
       return ret;
     }, []);
+    this.#fs ??= await VirtualFileSystem.create(this);
   }
   mergeUserConfig(from = {}, into = this.config.userConfig ?? {}) {
-    this.config.userConfig = defu3__default.default({
+    this.config.userConfig = defu2__default.default({
       entry: Array.isArray(from.entry) && from.entry.length > 0 ? from.entry : Array.isArray(into?.entry) && into.entry.length > 0 ? into.entry : []
     }, omit.omit(from ?? {}, [
       "entry"
@@ -2207,7 +2500,7 @@ async function callHook(context, hook, options, ...args) {
     if (definedResults.length > 0) {
       let mergedResult = void 0;
       for (const result of definedResults) {
-        mergedResult = defu3.defu(result, mergedResult ?? {});
+        mergedResult = defu2.defu(result, mergedResult ?? {});
       }
       return mergedResult;
     }
@@ -2517,7 +2810,7 @@ async function emitTypes(context, tsconfig, files) {
   const emitResult = program.emit(void 0, (fileName, text, _, __, sourceFiles, _data) => {
     const sourceFile = sourceFiles?.[0];
     if (sourceFile?.fileName && !fileName.endsWith(".map")) {
-      if (context.builtins.some((file) => file === sourceFile.fileName || context.fs.meta[file]?.id && context.fs.meta[file]?.id === sourceFile.fileName)) {
+      if (context.builtins.some((file) => file === sourceFile.fileName || context.fs.metadata[file]?.id && context.fs.metadata[file]?.id === sourceFile.fileName)) {
         builtinModules += `
 declare module "${context.fs.resolve(sourceFile.fileName)}" {
     ${text.trim().replace(/^\s*export\s*declare\s*/gm, "export ").replace(/^\s*declare\s*/gm, "")}
@@ -2836,11 +3129,14 @@ ${context.entry.map((entry) => `- ${entry.input.file || entry.file}${entry.outpu
       await resolveTsconfig(context);
       await installDependencies(context);
       await this.callPostHook(context, "configResolved");
+      if (context.config.build.polyfill) {
+        context.config.build.polyfill = context.config.build.polyfill.map((polyfill) => chunkMPCVQK2D_cjs.replacePathTokens(context, polyfill));
+      }
       context.log(types.LogLevelLabel.TRACE, `Powerlines configuration has been resolved: 
 
 ${console.formatLogMessage(context.config)}`);
-      context.fs[chunkTNHDC2ZQ_cjs.__VFS_INIT__]();
-      await chunkTNHDC2ZQ_cjs.writeMetaFile(context);
+      context.fs[__VFS_PATCH__]();
+      await chunk7XHBIYIN_cjs.writeMetaFile(context);
       context.persistedMeta = context.meta;
       if (!exists.existsSync(context.cachePath)) {
         await helpers.createDirectory(context.cachePath);
@@ -2899,7 +3195,7 @@ ${console.formatLogMessage(context.config)}`);
           joinPaths.joinPaths(typescriptPath, "lib", "lib.esnext.full.d.ts")
         ]);
         context.log(types.LogLevelLabel.TRACE, "Parsing TypeScript configuration for the Powerlines project.");
-        const resolvedTsconfig = chunkBQU53ZNB_cjs.getParsedTypeScriptConfig(context.workspaceConfig.workspaceRoot, context.config.projectRoot, context.tsconfig.tsconfigFilePath, defu3__default.default({
+        const resolvedTsconfig = chunkBQU53ZNB_cjs.getParsedTypeScriptConfig(context.workspaceConfig.workspaceRoot, context.config.projectRoot, context.tsconfig.tsconfigFilePath, defu2__default.default({
           compilerOptions: {
             strict: false,
             noEmit: false,
@@ -2970,8 +3266,8 @@ ${formatTypes(generatedTypes)}
         throw new Error("Failed to parse the TypeScript configuration file.");
       }
       await this.callPostHook(context, "prepare");
-      await chunkTNHDC2ZQ_cjs.writeMetaFile(context);
-      context.fs[chunkTNHDC2ZQ_cjs.__VFS_REVERT__]();
+      await chunk7XHBIYIN_cjs.writeMetaFile(context);
+      context.fs[__VFS_REVERT__]();
     });
     this.context.log(types.LogLevelLabel.INFO, "Powerlines API has been prepared successfully");
   }
@@ -3101,22 +3397,22 @@ ${formatTypes(generatedTypes)}
     this.#context.log(types.LogLevelLabel.TRACE, "Powerlines documentation generation completed");
   }
   /**
-  * Release the project
+  * Deploy the project source code
   *
   * @remarks
-  * This method will prepare and build the Powerlines project, generating the necessary artifacts for release.
+  * This method will prepare and build the Powerlines project, generating the necessary artifacts for the deployment.
   *
-  * @param inlineConfig - The inline configuration for the release command
+  * @param inlineConfig - The inline configuration for the deploy command
   */
-  async release(inlineConfig = {
-    command: "release"
+  async deploy(inlineConfig = {
+    command: "deploy"
   }) {
-    this.context.log(types.LogLevelLabel.INFO, "\u{1F4E6} Releasing the Powerlines project");
+    this.context.log(types.LogLevelLabel.INFO, "\u{1F4E6} Deploying the Powerlines project");
     await this.prepare(inlineConfig);
     await this.#executeEnvironments(async (context) => {
-      await this.callHook(context, "release");
+      await this.callHook(context, "deploy");
     });
-    this.context.log(types.LogLevelLabel.TRACE, "Powerlines release completed");
+    this.context.log(types.LogLevelLabel.TRACE, "Powerlines deploy completed");
   }
   /**
   * Finalization process
@@ -3130,7 +3426,8 @@ ${formatTypes(generatedTypes)}
     this.context.log(types.LogLevelLabel.TRACE, "Powerlines finalize execution started");
     await this.#executeEnvironments(async (context) => {
       await this.callHook(context, "finalize");
-      context.fs[chunkTNHDC2ZQ_cjs.__VFS_REVERT__]();
+      context.fs[__VFS_REVERT__]();
+      await context.fs.dispose();
     });
     this.context.log(types.LogLevelLabel.TRACE, "Powerlines finalize execution completed");
   }
@@ -3418,7 +3715,7 @@ function createUnpluginFactory(variant, decorate) {
       async function resolveId(id, importer, options = {
         isEntry: false
       }) {
-        return chunk7K7JH3DF_cjs.handleResolveId(api.context, {
+        return chunkULJVBW4L_cjs.handleResolveId(api.context, {
           id,
           importer,
           options
@@ -3509,4 +3806,5 @@ function createUnpluginFactory(variant, decorate) {
 }
 chunkUSNT2KNT_cjs.__name(createUnpluginFactory, "createUnpluginFactory");
 
+exports.VirtualFileSystem = VirtualFileSystem;
 exports.createUnpluginFactory = createUnpluginFactory;