powerlines 0.19.5 → 0.21.0

package/dist/lib/{chunk-DX4TFRS3.js → chunk-43VJVIL2.js}

@@ -1,12 +1,12 @@
 import { writeFile } from './chunk-TANQDHYY.js';
 import { getFileHeader } from './chunk-GANVMM73.js';
-import { __VFS_CACHE__, __VFS_RESOLVER__, __VFS_VIRTUAL__, __VFS_UNIFIED__, __VFS_INIT__, __VFS_REVERT__, CACHE_HASH_LENGTH, PROJECT_ROOT_HASH_LENGTH, getPrefixedProjectRootHash, getChecksum, writeMetaFile } from './chunk-GRJJZ5VJ.js';
-import { handleResolveId } from './chunk-WFUO3YPK.js';
+import { CACHE_HASH_LENGTH, PROJECT_ROOT_HASH_LENGTH, getPrefixedProjectRootHash, getChecksum, writeMetaFile } from './chunk-YH5GOJS3.js';
+import { handleResolveId } from './chunk-L4NEN725.js';
 import { getParsedTypeScriptConfig, getTsconfigFilePath, isIncludeMatchFound } from './chunk-YOENMDZY.js';
 import { loadWorkspaceConfig, loadUserConfigFile } from './chunk-ZPIKFR7Z.js';
 import { extendLog, createLog } from './chunk-ENRLU4UR.js';
 import { getString } from './chunk-M263EZ4F.js';
-import { resolveEntriesSync, getUniqueEntries } from './chunk-SM3S7DYW.js';
+import { resolveEntriesSync, getUniqueEntries, replacePathTokens } from './chunk-BHDQZ6YX.js';
 import { __name } from './chunk-SHUYVCID.js';
 import { LogLevelLabel } from '@storm-software/config-tools/types';
 import { relativeToWorkspaceRoot, getWorkspaceRoot } from '@stryke/fs/get-workspace-root';
@@ -21,7 +21,7 @@ import { install } from '@stryke/fs/install';
 import { listFiles } from '@stryke/fs/list-files';
 import { isPackageExists, isPackageListed, doesPackageMatch, getPackageListing } from '@stryke/fs/package-fns';
 import { resolvePackage } from '@stryke/fs/resolve';
-import { joinPaths } from '@stryke/path/join-paths';
+import { joinPaths as joinPaths$1 } from '@stryke/path/join-paths';
 import { replacePath } from '@stryke/path/replace';
 import { isError } from '@stryke/type-checks/is-error';
 import { isFunction } from '@stryke/type-checks/is-function';
@@ -31,7 +31,7 @@ import { isSet } from '@stryke/type-checks/is-set';
 import { isSetObject } from '@stryke/type-checks/is-set-object';
 import { isSetString } from '@stryke/type-checks/is-set-string';
 import chalk4 from 'chalk';
-import defu3, { defu } from 'defu';
+import defu2, { defu } from 'defu';
 import Handlebars from 'handlebars';
 import { declare } from '@babel/helper-plugin-utils';
 import * as t from '@babel/types';
@@ -43,24 +43,26 @@ import { getUnique } from '@stryke/helpers/get-unique';
 import { omit } from '@stryke/helpers/omit';
 import { StormJSON } from '@stryke/json/storm-json';
 import { appendPath } from '@stryke/path/append';
-import { findFilePath, findFileDotExtensionSafe, hasFileExtension, relativePath, findFileName } from '@stryke/path/file-path-fns';
+import { findFileDotExtensionSafe, findFilePath, hasFileExtension, relativePath, findFileName } from '@stryke/path/file-path-fns';
 import { isAbsolutePath, isAbsolute } from '@stryke/path/is-type';
-import { joinPaths as joinPaths$1 } from '@stryke/path/join';
+import { joinPaths } from '@stryke/path/join';
 import { isNull } from '@stryke/type-checks/is-null';
 import { isString } from '@stryke/type-checks/is-string';
 import { uuid } from '@stryke/unique-id/uuid';
 import { parseAsync } from 'oxc-parser';
-import { isUndefined } from '@stryke/type-checks/is-undefined';
-import { createJiti } from 'jiti';
+import * as $ from '@stryke/capnp';
 import { bufferToString } from '@stryke/convert/buffer-to-string';
-import { isParentPath } from '@stryke/path/is-parent-path';
+import { readFileBuffer, readFileBufferSync, writeFileBuffer } from '@stryke/fs/buffer';
 import { prettyBytes } from '@stryke/string-format/pretty-bytes';
 import { isBuffer } from '@stryke/type-checks/is-buffer';
-import { Volume } from 'memfs';
 import { Blob } from 'node:buffer';
 import fs from 'node:fs';
 import { resolveConfig, format } from 'prettier';
+import { isUndefined } from '@stryke/type-checks/is-undefined';
+import { isParentPath } from '@stryke/path/is-parent-path';
+import { Volume } from 'memfs/lib/node/volume';
 import { Union } from 'unionfs';
+import { createJiti } from 'jiti';
 import { isObject } from '@stryke/type-checks/is-object';
 import ts, { createProgram, createCompilerHost, getPreEmitDiagnostics, getLineAndCharacterOfPosition, flattenDiagnosticMessageText } from 'typescript';
 import { getPackageName, hasPackageVersion, getPackageVersion } from '@stryke/string-format/package';
@@ -170,7 +172,7 @@ var moduleResolverBabelPlugin = /* @__PURE__ */ __name((context) => {
 }, "moduleResolverBabelPlugin");
 var DEFAULT_ENVIRONMENT = "default";
 function createEnvironment(name, userConfig) {
-  return defu3(userConfig.environments?.[name] ?? {}, {
+  return defu2(userConfig.environments?.[name] ?? {}, {
     name,
     title: userConfig.title || titleCase(userConfig.name),
     ssr: false,
@@ -213,94 +215,232 @@ function createDefaultEnvironment(userConfig) {
   return createEnvironment(DEFAULT_ENVIRONMENT, userConfig);
 }
 __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(value) && "name" in value && isSetString(value.name) && (isUndefined(value.applyToEnvironment) || "applyToEnvironment" in value && isFunction(value.applyToEnvironment)) && (isUndefined(value.dedupe) || "dedupe" in value && isFunction(value.dedupe)) && (isUndefined(value.dependsOn) || "dependsOn" in value && Array.isArray(value.dependsOn) && value.dependsOn.every(isPluginConfig)) && SUPPORTED_COMMANDS.every((command) => isUndefined(value[command]) || command in value && (isFunction(value[command]) || isSetObject(value[command]) && "handler" in value[command] && isFunction(value[command].handler)));
-}
-__name(isPlugin, "isPlugin");
-function isPluginConfigObject(value) {
-  return isSetObject(value) && "plugin" in value && ((isSetString(value.plugin) || isFunction(value.plugin)) && "options" in value && isSetObject(value.options) || isPlugin(value.plugin));
-}
-__name(isPluginConfigObject, "isPluginConfigObject");
-function isPluginConfigTuple(value) {
-  return Array.isArray(value) && (value.length === 1 || value.length === 2) && ((isSetString(value[0]) || isFunction(value[0])) && value.length > 1 && isSetObject(value[1]) || isPlugin(value[0]));
-}
-__name(isPluginConfigTuple, "isPluginConfigTuple");
-function isPluginConfig(value) {
-  return isSetString(value) || isFunction(value) || isPlugin(value) || isPluginConfigObject(value) || isPluginConfigTuple(value);
-}
-__name(isPluginConfig, "isPluginConfig");
-function isPluginHookFunction(value) {
-  return isFunction(value) || isSetObject(value) && "handler" in value && isFunction(value.handler);
-}
-__name(isPluginHookFunction, "isPluginHookFunction");
-function isPluginHookObject(value) {
-  return isSetObject(value) && "handler" in value && isFunction(value.handler);
-}
-__name(isPluginHookObject, "isPluginHookObject");
-function isPluginHook(value) {
-  return isPluginHookFunction(value) || isPluginHookObject(value);
-}
-__name(isPluginHook, "isPluginHook");
-function getHookHandler(pluginHook) {
-  return isFunction(pluginHook) ? pluginHook : pluginHook.handler;
-}
-__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:");
-}
-__name(isHookExternal, "isHookExternal");
-function checkDedupe(plugin, plugins) {
-  return plugin.dedupe === false || plugins.some((p) => p.dedupe !== false && (isFunction(p.dedupe) && p.dedupe(plugin) || p.name === plugin.name));
-}
-__name(checkDedupe, "checkDedupe");
-function addPluginHook(context, plugin, pluginHook, hooksList) {
-  if (!checkDedupe(plugin, hooksList.map((hook) => hook.plugin))) {
-    hooksList.push(isFunction(pluginHook) ? {
-      plugin,
-      handler: getHookHandler(pluginHook).bind(context)
-    } : {
-      plugin,
-      ...pluginHook,
-      handler: getHookHandler(pluginHook).bind(context)
-    });
+BigInt("0xa56c61324b9d6e49");
+var FileMetadata_KeyValuePair = class extends $.Struct {
+  static {
+    __name(this, "FileMetadata_KeyValuePair");
   }
-}
-__name(addPluginHook, "addPluginHook");
-function resolveOptions(options) {
-  return defu3(options, {
-    interopDefault: true,
-    fsCache: options.mode !== "development" ? joinPaths(options.cacheDir, "jiti") : false,
-    moduleCache: options.mode !== "development"
-  });
-}
-__name(resolveOptions, "resolveOptions");
-function createPluginResolver(options) {
-  return createJiti(joinPaths(options.workspaceRoot, options.projectRoot), resolveOptions({
-    ...options
-  }));
-}
-__name(createPluginResolver, "createPluginResolver");
-function createResolver(options) {
-  const baseResolver = createJiti(joinPaths(options.workspaceRoot, options.projectRoot), resolveOptions(options));
-  baseResolver.plugin = createPluginResolver(options);
-  return baseResolver;
-}
-__name(createResolver, "createResolver");
+  static _capnp = {
+    displayName: "KeyValuePair",
+    id: "eabb26cf58b2a14c",
+    size: new $.ObjectSize(0, 2)
+  };
+  get key() {
+    return $.utils.getText(0, this);
+  }
+  set key(value) {
+    $.utils.setText(0, value, this);
+  }
+  get value() {
+    return $.utils.getText(1, this);
+  }
+  set value(value) {
+    $.utils.setText(1, value, this);
+  }
+  toString() {
+    return "FileMetadata_KeyValuePair_" + super.toString();
+  }
+};
+var FileMetadata = class _FileMetadata extends $.Struct {
+  static {
+    __name(this, "FileMetadata");
+  }
+  static KeyValuePair = FileMetadata_KeyValuePair;
+  static _capnp = {
+    displayName: "FileMetadata",
+    id: "8e2cab5d7e28c7b3",
+    size: new $.ObjectSize(0, 4),
+    defaultVariant: "normal"
+  };
+  static _Properties;
+  /**
+  * The variant of the file.
+  *
+  */
+  get id() {
+    return $.utils.getText(0, this);
+  }
+  set id(value) {
+    $.utils.setText(0, value, this);
+  }
+  /**
+  * The output mode of the file.
+  *
+  */
+  get variant() {
+    return $.utils.getText(1, this, _FileMetadata._capnp.defaultVariant);
+  }
+  set variant(value) {
+    $.utils.setText(1, value, this);
+  }
+  /**
+  * Additional metadata associated with the file.
+  *
+  */
+  get mode() {
+    return $.utils.getText(2, this);
+  }
+  set mode(value) {
+    $.utils.setText(2, value, this);
+  }
+  _adoptProperties(value) {
+    $.utils.adopt(value, $.utils.getPointer(3, this));
+  }
+  _disownProperties() {
+    return $.utils.disown(this.properties);
+  }
+  get properties() {
+    return $.utils.getList(3, _FileMetadata._Properties, this);
+  }
+  _hasProperties() {
+    return !$.utils.isNull($.utils.getPointer(3, this));
+  }
+  _initProperties(length) {
+    return $.utils.initList(3, _FileMetadata._Properties, length, this);
+  }
+  set properties(value) {
+    $.utils.copyFrom(value, $.utils.getPointer(3, this));
+  }
+  toString() {
+    return "FileMetadata_" + super.toString();
+  }
+};
+var FileIdentifier = class extends $.Struct {
+  static {
+    __name(this, "FileIdentifier");
+  }
+  static _capnp = {
+    displayName: "FileIdentifier",
+    id: "e12b8732389d7406",
+    size: new $.ObjectSize(0, 2)
+  };
+  /**
+  * An additional identifier for the file.
+  *
+  */
+  get path() {
+    return $.utils.getText(0, this);
+  }
+  set path(value) {
+    $.utils.setText(0, value, this);
+  }
+  get id() {
+    return $.utils.getText(1, this);
+  }
+  set id(value) {
+    $.utils.setText(1, value, this);
+  }
+  toString() {
+    return "FileIdentifier_" + super.toString();
+  }
+};
+var FileData = class extends $.Struct {
+  static {
+    __name(this, "FileData");
+  }
+  static _capnp = {
+    displayName: "FileData",
+    id: "fa6725c8a360f9a2",
+    size: new $.ObjectSize(0, 2)
+  };
+  /**
+  * The contents of the file.
+  *
+  */
+  get path() {
+    return $.utils.getText(0, this);
+  }
+  set path(value) {
+    $.utils.setText(0, value, this);
+  }
+  get content() {
+    return $.utils.getText(1, this);
+  }
+  set content(value) {
+    $.utils.setText(1, value, this);
+  }
+  toString() {
+    return "FileData_" + super.toString();
+  }
+};
+var FileSystemData = class _FileSystemData extends $.Struct {
+  static {
+    __name(this, "FileSystemData");
+  }
+  static _capnp = {
+    displayName: "FileSystemData",
+    id: "aaa72a672ac0732f",
+    size: new $.ObjectSize(0, 3)
+  };
+  static _Ids;
+  static _Metadata;
+  static _Files;
+  _adoptIds(value) {
+    $.utils.adopt(value, $.utils.getPointer(0, this));
+  }
+  _disownIds() {
+    return $.utils.disown(this.ids);
+  }
+  get ids() {
+    return $.utils.getList(0, _FileSystemData._Ids, this);
+  }
+  _hasIds() {
+    return !$.utils.isNull($.utils.getPointer(0, this));
+  }
+  _initIds(length) {
+    return $.utils.initList(0, _FileSystemData._Ids, length, this);
+  }
+  set ids(value) {
+    $.utils.copyFrom(value, $.utils.getPointer(0, this));
+  }
+  _adoptMetadata(value) {
+    $.utils.adopt(value, $.utils.getPointer(1, this));
+  }
+  _disownMetadata() {
+    return $.utils.disown(this.metadata);
+  }
+  get metadata() {
+    return $.utils.getList(1, _FileSystemData._Metadata, this);
+  }
+  _hasMetadata() {
+    return !$.utils.isNull($.utils.getPointer(1, this));
+  }
+  _initMetadata(length) {
+    return $.utils.initList(1, _FileSystemData._Metadata, length, this);
+  }
+  set metadata(value) {
+    $.utils.copyFrom(value, $.utils.getPointer(1, this));
+  }
+  _adoptFiles(value) {
+    $.utils.adopt(value, $.utils.getPointer(2, this));
+  }
+  _disownFiles() {
+    return $.utils.disown(this.files);
+  }
+  get files() {
+    return $.utils.getList(2, _FileSystemData._Files, this);
+  }
+  _hasFiles() {
+    return !$.utils.isNull($.utils.getPointer(2, this));
+  }
+  _initFiles(length) {
+    return $.utils.initList(2, _FileSystemData._Files, length, this);
+  }
+  set files(value) {
+    $.utils.copyFrom(value, $.utils.getPointer(2, this));
+  }
+  toString() {
+    return "FileSystemData_" + super.toString();
+  }
+};
+FileMetadata._Properties = $.CompositeList(FileMetadata_KeyValuePair);
+FileSystemData._Ids = $.CompositeList(FileIdentifier);
+FileSystemData._Metadata = $.CompositeList(FileMetadata);
+FileSystemData._Files = $.CompositeList(FileData);
+
+// src/types/vfs.ts
+var __VFS_PATCH__ = Symbol("__VFS_PATCH__");
+var __VFS_REVERT__ = Symbol("__VFS_REVERT__");
 function isBufferEncoding(options) {
   return isSetString(options) || options === null;
 }
@@ -449,46 +589,201 @@ function patchFS(originalFS, vfs) {
   };
 }
 __name(patchFS, "patchFS");
-var VirtualFileSystem = class {
+var UnifiedFS = class _UnifiedFS extends Union {
   static {
-    __name(this, "VirtualFileSystem");
+    __name(this, "UnifiedFS");
   }
   /**
   * The internal map of virtual files.
   */
-  #meta = {};
+  #virtualFS = new Volume();
   /**
-  * A map of unique identifiers to their virtual file paths.
+  * The physical file system.
   */
-  #ids = {};
+  #physicalFS = cloneFS(fs);
   /**
-  * 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 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);
+  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(joinPaths(this.#context.workspaceConfig.workspaceRoot, this.#context.config.output.outputPath))) {
+      this.#physicalFS.mkdirSync(joinPaths(this.#context.workspaceConfig.workspaceRoot, this.#context.config.output.outputPath), {
+        recursive: true
+      });
+    }
+    if (this.#context.config.output.mode !== "fs") {
+      this.#virtualFS = 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(toFilePath(pathOrUrl), this.#context.artifactsPath)) {
+      return "virtual";
+    } else if (options.mode === "fs" || this.#context.config.output.mode === "fs" || isParentPath(toFilePath(pathOrUrl), this.#context.dataPath) || isParentPath(toFilePath(pathOrUrl), this.#context.cachePath) || isParentPath(toFilePath(pathOrUrl), 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 {
+    __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 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;
@@ -508,160 +803,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 [__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 [__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(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 [__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 [__VFS_UNIFIED__]() {
-    return this.#unifiedFS;
+  #resolvePath(path, options = {}) {
+    if (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$1(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__ */ __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$1(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$1(this.#context.workspaceConfig.workspaceRoot, path))) {
+          ret.push(joinPaths$1(this.#context.workspaceConfig.workspaceRoot, path));
         }
-        return void 0;
-      }, "get"),
-      set: /* @__PURE__ */ __name((target, prop, value) => {
-        target[prop] = value;
-        this.#ids[value.id || prop] = prop;
-        return true;
-      }, "set"),
-      deleteProperty: /* @__PURE__ */ __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$1(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(this.#context.workspaceConfig.workspaceRoot, this.#context.config.output.outputPath))) {
-      this.#fs.mkdirSync(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$1(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 = 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;
+    }
+    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;
     }
-    this.#log = extendLog(this.#context.log, "virtual-file-system");
+    return false;
   }
-  [__VFS_INIT__]() {
-    if (!this.#isPatched && this.#context.config.output.mode !== "fs") {
-      this.#revert = patchFS(fs, 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 && existsSync(joinPaths$1(context.cachePath, "fs.bin"))) {
+      const buffer = await readFileBuffer(joinPaths$1(context.cachePath, "fs.bin"));
+      const message2 = new $.Message(buffer, false);
+      return new _VirtualFileSystem(context, message2.getRoot(FileSystemData));
     }
+    const message = new $.Message();
+    return new _VirtualFileSystem(context, message.initRoot(FileSystemData));
   }
-  [__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 && existsSync(joinPaths$1(context.cachePath, "fs.bin"))) {
+      const buffer = readFileBufferSync(joinPaths$1(context.cachePath, "fs.bin"));
+      const message2 = new $.Message(buffer, false);
+      return new _VirtualFileSystem(context, message2.getRoot(FileSystemData));
+    }
+    const message = new $.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 = extendLog(this.#context.log, "file-system");
   }
   /**
   * Check if a path or id corresponds to a virtual file **(does not actually exists on disk)**.
@@ -681,7 +1091,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)**.
@@ -690,7 +1100,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;
     }
@@ -701,18 +1111,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.
@@ -722,7 +1121,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).
@@ -735,9 +1134,11 @@ var VirtualFileSystem = class {
       return;
     }
     this.#log(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).
@@ -750,10 +1151,12 @@ var VirtualFileSystem = class {
       return;
     }
     this.#log(LogLevelLabel.TRACE, `Removing file: ${formattedPath}`);
-    if (isFunction(this.resolveFS(path, options).promises.unlink)) {
-      await this.resolveFS(path, options).promises.unlink(formattedPath);
-      this.#cachedFS.delete(formattedPath);
-      this.clearResolverCache(formattedPath);
+    if (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);
     }
@@ -770,11 +1173,10 @@ var VirtualFileSystem = class {
       return;
     }
     this.#log(LogLevelLabel.TRACE, `Synchronously removing directory: ${formattedPath}`);
-    this.resolveFS(path, options).rmdirSync(formattedPath, defu3(options, {
+    this.#unifiedFS.resolveFS(path, options).rmdirSync(formattedPath, defu2(options, {
       recursive: true
     }));
-    this.#cachedFS.delete(formattedPath);
-    this.clearResolverCache(formattedPath);
+    this.#clearResolverCache(formattedPath);
   }
   /**
   * Removes a directory in the virtual file system (VFS).
@@ -789,15 +1191,14 @@ var VirtualFileSystem = class {
       return;
     }
     this.#log(LogLevelLabel.TRACE, `Removing directory: ${formattedPath}`);
-    if (isFunction(this.resolveFS(path, options).promises.rm)) {
-      await this.resolveFS(path, options).promises.rm(formattedPath, defu3(options, {
+    if (isFunction(this.#unifiedFS.resolveFS(path, options).promises.rm)) {
+      await this.#unifiedFS.resolveFS(path, options).promises.rm(formattedPath, defu2(options, {
         force: true,
         recursive: true
       }));
-      this.#cachedFS.delete(formattedPath);
-      this.clearResolverCache(formattedPath);
+      this.#clearResolverCache(formattedPath);
     } else {
-      this.rmdirSync(formattedPath, defu3(options ?? {}, {
+      this.rmdirSync(formattedPath, defu2(options ?? {}, {
         force: true,
         recursive: true
       }));
@@ -839,8 +1240,8 @@ var VirtualFileSystem = class {
   */
   mkdirSync(path, options = {}) {
     const filePath = toFilePath(path);
-    this.clearResolverCache(filePath);
-    return this.resolveFS(filePath, options).mkdirSync(filePath, defu3(options ?? {}, {
+    this.#clearResolverCache(filePath);
+    return this.#unifiedFS.resolveFS(filePath, options).mkdirSync(filePath, defu2(options ?? {}, {
       recursive: true
     }));
   }
@@ -854,16 +1255,16 @@ var VirtualFileSystem = class {
   async mkdir(path, options = {}) {
     let result;
     const filePath = toFilePath(path);
-    if (isFunction(this.resolveFS(filePath, options).promises.mkdir)) {
-      result = await this.resolveFS(filePath, options).promises.mkdir(filePath, defu3(options ?? {}, {
+    if (isFunction(this.#unifiedFS.resolveFS(filePath, options).promises.mkdir)) {
+      result = await this.#unifiedFS.resolveFS(filePath, options).promises.mkdir(filePath, defu2(options ?? {}, {
         recursive: true
       }));
     } else {
-      result = this.resolveFS(filePath, options).mkdirSync(filePath, defu3(options ?? {}, {
+      result = this.#unifiedFS.resolveFS(filePath, options).mkdirSync(filePath, defu2(options ?? {}, {
         recursive: true
       }));
     }
-    this.clearResolverCache(filePath);
+    this.#clearResolverCache(filePath);
     return result;
   }
   /**
@@ -885,7 +1286,7 @@ var VirtualFileSystem = class {
         }
         continue;
       }
-      const absPattern = isAbsolutePath(normalized) ? normalized : this.formatPath(joinPaths(this.#context.workspaceConfig.workspaceRoot, normalized));
+      const absPattern = isAbsolutePath(normalized) ? normalized : this.formatPath(joinPaths$1(this.#context.workspaceConfig.workspaceRoot, normalized));
       const firstGlobIdx = absPattern.search(/[*?[\]{}]/);
       const baseDir = firstGlobIdx === -1 ? findFilePath(absPattern) : absPattern.slice(0, Math.max(0, absPattern.lastIndexOf("/", firstGlobIdx)));
       const stack = [
@@ -900,7 +1301,7 @@ var VirtualFileSystem = class {
           continue;
         }
         for (const entry of entries) {
-          const full = this.formatPath(joinPaths(dir, entry));
+          const full = this.formatPath(joinPaths$1(dir, entry));
           let stats;
           try {
             stats = this.#unifiedFS.lstatSync(full);
@@ -911,7 +1312,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"
               });
@@ -944,7 +1345,7 @@ var VirtualFileSystem = class {
         }
         continue;
       }
-      const absPattern = isAbsolutePath(normalized) ? normalized : this.formatPath(joinPaths(this.#context.workspaceConfig.workspaceRoot, normalized));
+      const absPattern = isAbsolutePath(normalized) ? normalized : this.formatPath(joinPaths$1(this.#context.workspaceConfig.workspaceRoot, normalized));
       const firstGlobIdx = absPattern.search(/[*?[\]{}]/);
       const baseDir = firstGlobIdx === -1 ? findFilePath(absPattern) : absPattern.slice(0, Math.max(0, absPattern.lastIndexOf("/", firstGlobIdx)));
       const stack = [
@@ -959,7 +1360,7 @@ var VirtualFileSystem = class {
           continue;
         }
         for (const entry of entries) {
-          const full = this.formatPath(joinPaths(dir, entry));
+          const full = this.formatPath(joinPaths$1(dir, entry));
           let stats;
           try {
             stats = this.#unifiedFS.lstatSync(full);
@@ -970,7 +1371,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"
               });
@@ -1034,7 +1435,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).
@@ -1050,17 +1451,13 @@ var VirtualFileSystem = class {
       type: "file"
     });
     if (filePath) {
-      if (this.#cachedFS.has(filePath)) {
-        return this.#cachedFS.get(filePath);
-      }
       let result;
-      if (isFunction(this.resolveFS(filePath).promises.readFile)) {
-        result = (await this.resolveFS(filePath).promises.readFile(filePath, options))?.toString("utf8");
+      if (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(result) ? bufferToString(result) : result;
-      this.#cachedFS.set(filePath, content);
       return content;
     }
     return void 0;
@@ -1079,12 +1476,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(result) ? bufferToString(result) : result;
-      this.#cachedFS.set(filePath, content);
       return content;
     }
     return void 0;
@@ -1112,17 +1505,15 @@ var VirtualFileSystem = class {
         });
       }
     }
-    const outputMode = this.resolveOutputMode(formattedPath, isPowerlinesWriteFileOptions(options) ? options : void 0);
+    const outputMode = this.#unifiedFS.resolveMode(formattedPath, isPowerlinesWriteFileOptions(options) ? options : void 0);
     this.#log(LogLevelLabel.TRACE, `Writing ${formattedPath} file to the ${outputMode === "fs" ? "" : "virtual "}file system (size: ${prettyBytes(new Blob(toArray(code)).size)})`);
-    this.meta[formattedPath] = {
-      path: formattedPath,
-      code,
+    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(ifs.promises.writeFile)) {
       return ifs.promises.writeFile(formattedPath, code, isNodeWriteFileOptions(options) ? options : "utf8");
     }
@@ -1141,17 +1532,15 @@ var VirtualFileSystem = class {
       this.mkdirSync(findFilePath(formattedPath), isPowerlinesWriteFileOptions(options) ? options : void 0);
     }
     const code = isPowerLinesWriteFileData(data) ? data.code : data;
-    const outputMode = this.resolveOutputMode(formattedPath, isPowerlinesWriteFileOptions(options) ? options : void 0);
+    const outputMode = this.#unifiedFS.resolveMode(formattedPath, isPowerlinesWriteFileOptions(options) ? options : void 0);
     this.#log(LogLevelLabel.TRACE, `Writing ${formattedPath} file to the ${outputMode === "fs" ? "" : "virtual "}file system (size: ${prettyBytes(new Blob(toArray(code)).size)})`);
-    this.meta[formattedPath] = {
-      path: formattedPath,
-      code,
+    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 {
@@ -1175,8 +1564,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;
   }
@@ -1186,363 +1575,267 @@ var VirtualFileSystem = class {
   * @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) {
-    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(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(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(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(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 (isAbsolutePath(formattedPath) || formattedPath.startsWith(this.#context.workspaceConfig.workspaceRoot)) {
-      return formattedPath;
-    } else if (formattedPath.startsWith(this.#context.config.projectRoot)) {
-      return 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(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 (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(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(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(this.#context.workspaceConfig.workspaceRoot, path))) {
-          ret.push(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)));
+  * @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.#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(toFilePath(pathOrUrl), this.#context.artifactsPath)) {
-      return "virtual";
-    } else if (options.mode === "fs" || this.#context.config.output.mode === "fs" || isParentPath(toFilePath(pathOrUrl), this.#context.dataPath) || isParentPath(toFilePath(pathOrUrl), this.#context.cachePath) || isParentPath(toFilePath(pathOrUrl), 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(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(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(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 (isAbsolutePath(formattedPath) || formattedPath.startsWith(this.#context.workspaceConfig.workspaceRoot)) {
+      return formattedPath;
+    } else if (formattedPath.startsWith(this.#context.config.projectRoot)) {
+      return joinPaths$1(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(LogLevelLabel.DEBUG, "Disposing virtual file system...");
+      await this.unlink(joinPaths$1(this.#context.cachePath, "fs.bin"));
+      const message = new $.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 writeFileBuffer(joinPaths$1(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, 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(value) && "name" in value && isSetString(value.name) && (isUndefined(value.applyToEnvironment) || "applyToEnvironment" in value && isFunction(value.applyToEnvironment)) && (isUndefined(value.dedupe) || "dedupe" in value && isFunction(value.dedupe)) && (isUndefined(value.dependsOn) || "dependsOn" in value && Array.isArray(value.dependsOn) && value.dependsOn.every(isPluginConfig)) && SUPPORTED_COMMANDS.every((command) => isUndefined(value[command]) || command in value && (isFunction(value[command]) || isSetObject(value[command]) && "handler" in value[command] && isFunction(value[command].handler)));
+}
+__name(isPlugin, "isPlugin");
+function isPluginConfigObject(value) {
+  return isSetObject(value) && "plugin" in value && ((isSetString(value.plugin) || isFunction(value.plugin)) && "options" in value && isSetObject(value.options) || isPlugin(value.plugin));
+}
+__name(isPluginConfigObject, "isPluginConfigObject");
+function isPluginConfigTuple(value) {
+  return Array.isArray(value) && (value.length === 1 || value.length === 2) && ((isSetString(value[0]) || isFunction(value[0])) && value.length > 1 && isSetObject(value[1]) || isPlugin(value[0]));
+}
+__name(isPluginConfigTuple, "isPluginConfigTuple");
+function isPluginConfig(value) {
+  return isSetString(value) || isFunction(value) || isPlugin(value) || isPluginConfigObject(value) || isPluginConfigTuple(value);
+}
+__name(isPluginConfig, "isPluginConfig");
+function isPluginHookFunction(value) {
+  return isFunction(value) || isSetObject(value) && "handler" in value && isFunction(value.handler);
+}
+__name(isPluginHookFunction, "isPluginHookFunction");
+function isPluginHookObject(value) {
+  return isSetObject(value) && "handler" in value && isFunction(value.handler);
+}
+__name(isPluginHookObject, "isPluginHookObject");
+function isPluginHook(value) {
+  return isPluginHookFunction(value) || isPluginHookObject(value);
+}
+__name(isPluginHook, "isPluginHook");
+function getHookHandler(pluginHook) {
+  return isFunction(pluginHook) ? pluginHook : pluginHook.handler;
+}
+__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:");
+}
+__name(isHookExternal, "isHookExternal");
+function checkDedupe(plugin, plugins) {
+  return plugin.dedupe === false || plugins.some((p) => p.dedupe !== false && (isFunction(p.dedupe) && p.dedupe(plugin) || p.name === plugin.name));
+}
+__name(checkDedupe, "checkDedupe");
+function addPluginHook(context, plugin, pluginHook, hooksList) {
+  if (!checkDedupe(plugin, hooksList.map((hook) => hook.plugin))) {
+    hooksList.push(isFunction(pluginHook) ? {
+      plugin,
+      handler: getHookHandler(pluginHook).bind(context)
+    } : {
+      plugin,
+      ...pluginHook,
+      handler: getHookHandler(pluginHook).bind(context)
+    });
+  }
+}
+__name(addPluginHook, "addPluginHook");
+function resolveOptions(options) {
+  return defu2(options, {
+    interopDefault: true,
+    fsCache: options.mode !== "development" ? joinPaths$1(options.cacheDir, "jiti") : false,
+    moduleCache: options.mode !== "development"
+  });
 }
-__name(createVfs, "createVfs");
+__name(resolveOptions, "resolveOptions");
+function createPluginResolver(options) {
+  return createJiti(joinPaths$1(options.workspaceRoot, options.projectRoot), resolveOptions({
+    ...options
+  }));
+}
+__name(createPluginResolver, "createPluginResolver");
+function createResolver(options) {
+  const baseResolver = createJiti(joinPaths$1(options.workspaceRoot, options.projectRoot), resolveOptions(options));
+  baseResolver.plugin = createPluginResolver(options);
+  return baseResolver;
+}
+__name(createResolver, "createResolver");
 
 // src/internal/contexts/context.ts
 var configCache = /* @__PURE__ */ new WeakMap();
@@ -1582,7 +1875,6 @@ var PowerlinesContext = class _PowerlinesContext {
       lint: config.lint,
       transform: config.transform,
       build: config.build,
-      override: config.override,
       framework: config.framework
     };
   }
@@ -1658,7 +1950,7 @@ var PowerlinesContext = class _PowerlinesContext {
   */
   get fs() {
     if (!this.#fs) {
-      this.#fs = createVfs(this);
+      this.#fs = VirtualFileSystem.createSync(this);
     }
     return this.#fs;
   }
@@ -1685,9 +1977,7 @@ var PowerlinesContext = class _PowerlinesContext {
       }),
       configHash: murmurhash(this.config, {
         maxLength: CACHE_HASH_LENGTH
-      }),
-      builtinIdMap: {},
-      virtualFiles: {}
+      })
     };
   }
   /**
@@ -1728,31 +2018,31 @@ var PowerlinesContext = class _PowerlinesContext {
   * Get the path to the artifacts directory for the project
   */
   get artifactsPath() {
-    return joinPaths$1(this.workspaceConfig.workspaceRoot, this.config.projectRoot, this.config.output.artifactsFolder);
+    return joinPaths(this.workspaceConfig.workspaceRoot, this.config.projectRoot, this.config.output.artifactsFolder);
   }
   /**
   * Get the path to the builtin modules used by the project
   */
   get builtinsPath() {
-    return joinPaths$1(this.artifactsPath, "builtins");
+    return joinPaths(this.artifactsPath, "builtins");
   }
   /**
   * Get the path to the entry directory for the project
   */
   get entryPath() {
-    return joinPaths$1(this.artifactsPath, "entry");
+    return joinPaths(this.artifactsPath, "entry");
   }
   /**
   * Get the path to the data directory for the project
   */
   get dataPath() {
-    return joinPaths$1(this.envPaths.data, "projects", getPrefixedProjectRootHash(this.config.name, this.meta.projectRootHash));
+    return joinPaths(this.envPaths.data, "projects", getPrefixedProjectRootHash(this.config.name, this.meta.projectRootHash));
   }
   /**
   * Get the path to the cache directory for the project
   */
   get cachePath() {
-    return joinPaths$1(this.envPaths.cache, "projects", murmurhash({
+    return joinPaths(this.envPaths.cache, "projects", murmurhash({
       checksum: this.#checksum,
       config: this.meta.configHash
     }, {
@@ -1763,7 +2053,7 @@ var PowerlinesContext = class _PowerlinesContext {
   * Get the path to the generated declaration file for the project
   */
   get dtsPath() {
-    return this.config.output.dts ? appendPath(this.config.output.dts, this.workspaceConfig.workspaceRoot) : joinPaths$1(this.workspaceConfig.workspaceRoot, this.config.projectRoot, "storm.d.ts");
+    return this.config.output.dts ? appendPath(this.config.output.dts, this.workspaceConfig.workspaceRoot) : joinPaths(this.workspaceConfig.workspaceRoot, this.config.projectRoot, "storm.d.ts");
   }
   /**
   * Get the project root relative to the workspace root
@@ -1775,13 +2065,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,
@@ -1801,7 +2091,7 @@ var PowerlinesContext = class _PowerlinesContext {
     return this.fs.writeFile(isAbsolute(path) ? path : appendPath(path, this.entryPath), {
       code,
       variant: "entry"
-    }, defu3(options, {
+    }, defu2(options, {
       mode: this.config.output.mode
     }));
   }
@@ -1814,11 +2104,11 @@ var PowerlinesContext = class _PowerlinesContext {
   * @param options - Optional write file options
   */
   async writeBuiltin(code, id, path, options = {}) {
-    return this.fs.writeFile(path ? isAbsolute(path) ? path : joinPaths$1(this.builtinsPath, path) : appendPath(id, this.builtinsPath), {
+    return this.fs.writeFile(path ? isAbsolute(path) ? path : joinPaths(this.builtinsPath, path) : appendPath(id, this.builtinsPath), {
       id,
       code,
       variant: "builtin"
-    }, defu3(options, {
+    }, defu2(options, {
       mode: this.config.output.mode
     }));
   }
@@ -1840,7 +2130,7 @@ var PowerlinesContext = class _PowerlinesContext {
         options
       });
     }
-    const result = await parseAsync(id, code, defu3(options ?? {}, {
+    const result = await parseAsync(id, code, defu2(options ?? {}, {
       lang: hasFileExtension(id) ? void 0 : "ts",
       astType: hasFileExtension(id) ? void 0 : "ts",
       sourceType: "module",
@@ -1878,7 +2168,7 @@ ${result.errors.map((error) => `  [${error.severity}] ${error.message}${error.co
   }) {
     this.config.inlineConfig = inlineConfig;
     if (inlineConfig.command === "new") {
-      const workspacePackageJsonPath = joinPaths$1(this.workspaceConfig.workspaceRoot, "package.json");
+      const workspacePackageJsonPath = joinPaths(this.workspaceConfig.workspaceRoot, "package.json");
       if (!existsSync(workspacePackageJsonPath)) {
         throw new Error(`The workspace package.json file could not be found at ${workspacePackageJsonPath}`);
       }
@@ -2001,11 +2291,11 @@ ${result.errors.map((error) => `  [${error.severity}] ${error.message}${error.co
       this.resolver = result.resolver;
       this.mergeUserConfig(result.userConfig.config, this.config.userConfig);
     } else {
-      const projectJsonPath = joinPaths$1(cacheKey.projectRoot, "project.json");
+      const projectJsonPath = joinPaths(cacheKey.projectRoot, "project.json");
       if (existsSync(projectJsonPath)) {
         this.projectJson = await readJsonFile(projectJsonPath);
       }
-      const packageJsonPath = joinPaths$1(cacheKey.projectRoot, "package.json");
+      const packageJsonPath = joinPaths(cacheKey.projectRoot, "package.json");
       if (existsSync(packageJsonPath)) {
         this.packageJson = await readJsonFile(packageJsonPath);
       }
@@ -2028,7 +2318,7 @@ ${result.errors.map((error) => `  [${error.severity}] ${error.message}${error.co
       });
     }
     if (isSetObject(config)) {
-      this.resolvedConfig = defu3({
+      this.resolvedConfig = defu2({
         inlineConfig: this.config.inlineConfig,
         userConfig: this.config.userConfig
       }, options.isHighPriority ? this.#getConfigProps(config) : {}, {
@@ -2045,11 +2335,11 @@ ${result.errors.map((error) => `  [${error.severity}] ${error.message}${error.co
         tsconfig: appendPath("tsconfig.json", cacheKey.projectRoot),
         sourceRoot: this.projectJson?.sourceRoot || appendPath("src", cacheKey.projectRoot),
         output: {
-          outputPath: joinPaths$1("dist", cacheKey.projectRoot),
+          outputPath: joinPaths("dist", cacheKey.projectRoot),
           mode: "virtual",
-          dts: joinPaths$1(cacheKey.projectRoot, `${config.framework ?? "powerlines"}.d.ts`),
+          dts: joinPaths(cacheKey.projectRoot, `${config.framework ?? "powerlines"}.d.ts`),
           builtinPrefix: config.framework ?? "powerlines",
-          artifactsFolder: joinPaths$1(cacheKey.projectRoot, `.${config.framework ?? "powerlines"}`),
+          artifactsFolder: joinPaths(cacheKey.projectRoot, `.${config.framework ?? "powerlines"}`),
           assets: [
             {
               glob: "LICENSE"
@@ -2084,9 +2374,9 @@ ${result.errors.map((error) => `  [${error.severity}] ${error.message}${error.co
           eslint: {}
         },
         build: {
-          target: "esnext"
-        },
-        override: {}
+          target: "esnext",
+          override: {}
+        }
       });
     }
     this.config.entry = getUniqueEntries(this.config.entry);
@@ -2106,12 +2396,12 @@ ${result.errors.map((error) => `  [${error.severity}] ${error.message}${error.co
     ] : [
       "esm"
     ])));
-    this.config.output.outputPath ??= joinPaths$1("dist", this.config.projectRoot || ".");
+    this.config.output.outputPath ??= joinPaths("dist", this.config.projectRoot || ".");
     this.config.output.assets = getUnique(this.config.output.assets.map((asset) => {
       return {
         glob: isSetObject(asset) ? asset.glob : asset,
         input: isString(asset) || !asset.input || asset.input === "." || asset.input === "/" || asset.input === "./" ? this.workspaceConfig.workspaceRoot : appendPath(asset.input, this.workspaceConfig.workspaceRoot),
-        output: appendPath(isSetObject(asset) && asset.output ? joinPaths$1(this.config.output.outputPath, replacePath(asset.output, this.config.output.outputPath)) : this.config.output.outputPath, this.workspaceConfig.workspaceRoot),
+        output: appendPath(isSetObject(asset) && asset.output ? joinPaths(this.config.output.outputPath, replacePath(asset.output, this.config.output.outputPath)) : this.config.output.outputPath, this.workspaceConfig.workspaceRoot),
         ignore: isSetObject(asset) && asset.ignore ? toArray(asset.ignore) : void 0
       };
     }));
@@ -2122,9 +2412,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({
+    this.config.userConfig = defu2({
       entry: Array.isArray(from.entry) && from.entry.length > 0 ? from.entry : Array.isArray(into?.entry) && into.entry.length > 0 ? into.entry : []
     }, omit(from ?? {}, [
       "entry"
@@ -2489,7 +2780,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, "")}
@@ -2588,8 +2879,8 @@ async function resolveTsconfigChanges(context) {
     tsconfigJson.compilerOptions.emitDecoratorMetadata = true;
   }
   if (context.config.output.dts) {
-    const dtsFilePath = context.config.output.dts ? context.config.output.dts.startsWith(context.workspaceConfig.workspaceRoot) ? context.config.output.dts : joinPaths(context.workspaceConfig.workspaceRoot, context.config.output.dts) : joinPaths(context.workspaceConfig.workspaceRoot, context.config.projectRoot, "storm.d.ts");
-    const dtsRelativePath = joinPaths(relativePath(joinPaths(context.workspaceConfig.workspaceRoot, context.config.projectRoot), findFilePath(dtsFilePath)), findFileName(dtsFilePath));
+    const dtsFilePath = context.config.output.dts ? context.config.output.dts.startsWith(context.workspaceConfig.workspaceRoot) ? context.config.output.dts : joinPaths$1(context.workspaceConfig.workspaceRoot, context.config.output.dts) : joinPaths$1(context.workspaceConfig.workspaceRoot, context.config.projectRoot, "storm.d.ts");
+    const dtsRelativePath = joinPaths$1(relativePath(joinPaths$1(context.workspaceConfig.workspaceRoot, context.config.projectRoot), findFilePath(dtsFilePath)), findFileName(dtsFilePath));
     if (!tsconfigJson.include?.some((filePattern) => isIncludeMatchFound(filePattern, [
       dtsFilePath,
       dtsRelativePath,
@@ -2808,10 +3099,13 @@ ${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) => replacePathTokens(context, polyfill));
+      }
       context.log(LogLevelLabel.TRACE, `Powerlines configuration has been resolved: 
 
 ${formatLogMessage(context.config)}`);
-      context.fs[__VFS_INIT__]();
+      context.fs[__VFS_PATCH__]();
       await writeMetaFile(context);
       context.persistedMeta = context.meta;
       if (!existsSync(context.cachePath)) {
@@ -2868,10 +3162,10 @@ ${formatLogMessage(context.config)}`);
           }
           return ret;
         }, [
-          joinPaths(typescriptPath, "lib", "lib.esnext.full.d.ts")
+          joinPaths$1(typescriptPath, "lib", "lib.esnext.full.d.ts")
         ]);
         context.log(LogLevelLabel.TRACE, "Parsing TypeScript configuration for the Powerlines project.");
-        const resolvedTsconfig = getParsedTypeScriptConfig(context.workspaceConfig.workspaceRoot, context.config.projectRoot, context.tsconfig.tsconfigFilePath, defu3({
+        const resolvedTsconfig = getParsedTypeScriptConfig(context.workspaceConfig.workspaceRoot, context.config.projectRoot, context.tsconfig.tsconfigFilePath, defu2({
           compilerOptions: {
             strict: false,
             noEmit: false,
@@ -2886,7 +3180,7 @@ ${formatLogMessage(context.config)}`);
           ],
           include: files
         }, context.config.tsconfigRaw ?? {}));
-        resolvedTsconfig.options.configFilePath = joinPaths(context.workspaceConfig.workspaceRoot, context.tsconfig.tsconfigFilePath);
+        resolvedTsconfig.options.configFilePath = joinPaths$1(context.workspaceConfig.workspaceRoot, context.tsconfig.tsconfigFilePath);
         resolvedTsconfig.options.pathsBasePath = context.workspaceConfig.workspaceRoot;
         resolvedTsconfig.options.suppressOutputPathCheck = true;
         let generatedTypes = await emitTypes(context, resolvedTsconfig, files);
@@ -2962,26 +3256,26 @@ ${formatTypes(generatedTypes)}
     await this.#executeEnvironments(async (context) => {
       context.log(LogLevelLabel.TRACE, `Initializing the processing options for the Powerlines project.`);
       await this.callPreHook(context, "new");
-      const files = await listFiles(joinPaths(context.powerlinesPath, "files/common/**/*.hbs"));
+      const files = await listFiles(joinPaths$1(context.powerlinesPath, "files/common/**/*.hbs"));
       for (const file of files) {
         context.log(LogLevelLabel.TRACE, `Adding template file: ${file}`);
         const template = Handlebars.compile(file);
-        await writeFile(context.log, joinPaths(context.config.projectRoot, file.replace(".hbs", "")), template(context));
+        await writeFile(context.log, joinPaths$1(context.config.projectRoot, file.replace(".hbs", "")), template(context));
       }
       await this.callNormalHook(context, "new");
       if (context.config.projectType === "application") {
-        const files2 = await listFiles(joinPaths(context.powerlinesPath, "files/application/**/*.hbs"));
+        const files2 = await listFiles(joinPaths$1(context.powerlinesPath, "files/application/**/*.hbs"));
         for (const file of files2) {
           context.log(LogLevelLabel.TRACE, `Adding application template file: ${file}`);
           const template = Handlebars.compile(file);
-          await writeFile(context.log, joinPaths(context.config.projectRoot, file.replace(".hbs", "")), template(context));
+          await writeFile(context.log, joinPaths$1(context.config.projectRoot, file.replace(".hbs", "")), template(context));
         }
       } else {
-        const files2 = await listFiles(joinPaths(context.powerlinesPath, "files/library/**/*.hbs"));
+        const files2 = await listFiles(joinPaths$1(context.powerlinesPath, "files/library/**/*.hbs"));
         for (const file of files2) {
           context.log(LogLevelLabel.TRACE, `Adding library template file: ${file}`);
           const template = Handlebars.compile(file);
-          await writeFile(context.log, joinPaths(context.config.projectRoot, file.replace(".hbs", "")), template(context));
+          await writeFile(context.log, joinPaths$1(context.config.projectRoot, file.replace(".hbs", "")), template(context));
         }
       }
       await this.callPostHook(context, "new");
@@ -3045,7 +3339,7 @@ ${formatTypes(generatedTypes)}
       await this.callPreHook(context, "build");
       await this.callNormalHook(context, "build");
       await Promise.all(context.config.output.assets.map(async (asset) => {
-        context.log(LogLevelLabel.DEBUG, `Copying asset(s): ${chalk4.redBright(context.workspaceConfig.workspaceRoot === asset.input ? asset.glob : joinPaths(replacePath(asset.input, context.workspaceConfig.workspaceRoot), asset.glob))} -> ${chalk4.greenBright(joinPaths(replacePath(asset.output, context.workspaceConfig.workspaceRoot), asset.glob))} ${Array.isArray(asset.ignore) && asset.ignore.length > 0 ? ` (ignoring: ${asset.ignore.map((i) => chalk4.yellowBright(i)).join(", ")})` : ""}`);
+        context.log(LogLevelLabel.DEBUG, `Copying asset(s): ${chalk4.redBright(context.workspaceConfig.workspaceRoot === asset.input ? asset.glob : joinPaths$1(replacePath(asset.input, context.workspaceConfig.workspaceRoot), asset.glob))} -> ${chalk4.greenBright(joinPaths$1(replacePath(asset.output, context.workspaceConfig.workspaceRoot), asset.glob))} ${Array.isArray(asset.ignore) && asset.ignore.length > 0 ? ` (ignoring: ${asset.ignore.map((i) => chalk4.yellowBright(i)).join(", ")})` : ""}`);
         await copyFiles(asset, asset.output);
       }));
       await this.callPostHook(context, "build");
@@ -3073,22 +3367,22 @@ ${formatTypes(generatedTypes)}
     this.#context.log(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(LogLevelLabel.INFO, "\u{1F4E6} Releasing the Powerlines project");
+    this.context.log(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(LogLevelLabel.TRACE, "Powerlines release completed");
+    this.context.log(LogLevelLabel.TRACE, "Powerlines deploy completed");
   }
   /**
   * Finalization process
@@ -3103,6 +3397,7 @@ ${formatTypes(generatedTypes)}
     await this.#executeEnvironments(async (context) => {
       await this.callHook(context, "finalize");
       context.fs[__VFS_REVERT__]();
+      await context.fs.dispose();
     });
     this.context.log(LogLevelLabel.TRACE, "Powerlines finalize execution completed");
   }
@@ -3333,7 +3628,7 @@ ${formatTypes(generatedTypes)}
       }
     }
     try {
-      const module = await this.context.resolver.plugin.import(this.context.resolver.plugin.esmResolve(joinPaths(pluginPath, "plugin")));
+      const module = await this.context.resolver.plugin.import(this.context.resolver.plugin.esmResolve(joinPaths$1(pluginPath, "plugin")));
       const result = module.plugin ?? module.default;
       if (!result) {
         throw new Error(`The plugin package "${pluginPath}" does not export a valid module.`);
@@ -3481,4 +3776,4 @@ function createUnpluginFactory(variant, decorate) {
 }
 __name(createUnpluginFactory, "createUnpluginFactory");
 
-export { createUnpluginFactory };
+export { VirtualFileSystem, createUnpluginFactory };