powerlines 0.23.10 → 0.24.0

package/dist/lib/{chunk-QABAD5RE.cjs → chunk-RNHKEPFD.cjs}

@@ -1,6 +1,7 @@
 'use strict';
 
 var chunk7VJ42H2I_cjs = require('./chunk-7VJ42H2I.cjs');
+var chunkSAS5EPBD_cjs = require('./chunk-SAS5EPBD.cjs');
 var chunkK3NBD5LL_cjs = require('./chunk-K3NBD5LL.cjs');
 var chunkJA4HSQRN_cjs = require('./chunk-JA4HSQRN.cjs');
 var chunkISBHXSDH_cjs = require('./chunk-ISBHXSDH.cjs');
@@ -27,6 +28,7 @@ var isSetObject = require('@stryke/type-checks/is-set-object');
 var isSetString = require('@stryke/type-checks/is-set-string');
 var isString = require('@stryke/type-checks/is-string');
 var uuid = require('@stryke/unique-id/uuid');
+var bundleRequire = require('bundle-require');
 var defu2 = require('defu');
 var joinPaths = require('@stryke/path/join-paths');
 var jiti = require('jiti');
@@ -35,9 +37,11 @@ var isUndefined = require('@stryke/type-checks/is-undefined');
 var $ = require('@stryke/capnp');
 var bufferToString = require('@stryke/convert/buffer-to-string');
 var buffer = require('@stryke/fs/buffer');
+var correctPath = require('@stryke/path/correct-path');
 var filePathFns = require('@stryke/path/file-path-fns');
 var prettyBytes = require('@stryke/string-format/pretty-bytes');
 var isBuffer = require('@stryke/type-checks/is-buffer');
+var flatCache = require('flat-cache');
 var buffer$1 = require('buffer');
 var _fs = require('fs');
 var prettier = require('prettier');
@@ -258,187 +262,6 @@ var FileMetadata = class _FileMetadata extends $__namespace.Struct {
     return "FileMetadata_" + super.toString();
   }
 };
-var ChunkData = class extends $__namespace.Struct {
-  static {
-    chunkUSNT2KNT_cjs.__name(this, "ChunkData");
-  }
-  static _capnp = {
-    displayName: "ChunkData",
-    id: "84076f13b057f83a",
-    size: new $__namespace.ObjectSize(8, 4)
-  };
-  /**
-  * An additional name for the file.
-  *
-  */
-  get id() {
-    return $__namespace.utils.getText(0, this);
-  }
-  set id(value) {
-    $__namespace.utils.setText(0, value, this);
-  }
-  /**
-  * Files that are implicitly loaded after one of the specified files.
-  *
-  */
-  get name() {
-    return $__namespace.utils.getText(1, this);
-  }
-  set name(value) {
-    $__namespace.utils.setText(1, value, this);
-  }
-  _adoptImplicitlyLoadedAfterOneOf(value) {
-    $__namespace.utils.adopt(value, $__namespace.utils.getPointer(2, this));
-  }
-  _disownImplicitlyLoadedAfterOneOf() {
-    return $__namespace.utils.disown(this.implicitlyLoadedAfterOneOf);
-  }
-  /**
-  * The importer of the file.
-  *
-  */
-  get implicitlyLoadedAfterOneOf() {
-    return $__namespace.utils.getList(2, $__namespace.TextList, this);
-  }
-  _hasImplicitlyLoadedAfterOneOf() {
-    return !$__namespace.utils.isNull($__namespace.utils.getPointer(2, this));
-  }
-  _initImplicitlyLoadedAfterOneOf(length) {
-    return $__namespace.utils.initList(2, $__namespace.TextList, length, this);
-  }
-  set implicitlyLoadedAfterOneOf(value) {
-    $__namespace.utils.copyFrom(value, $__namespace.utils.getPointer(2, this));
-  }
-  /**
-  * The signature preservation mode for the file.
-  *
-  */
-  get importer() {
-    return $__namespace.utils.getText(3, this);
-  }
-  set importer(value) {
-    $__namespace.utils.setText(3, value, this);
-  }
-  get preserveSignature() {
-    return $__namespace.utils.getUint16(0, this);
-  }
-  set preserveSignature(value) {
-    $__namespace.utils.setUint16(0, value, this);
-  }
-  toString() {
-    return "ChunkData_" + super.toString();
-  }
-};
-var PrebuiltData = class extends $__namespace.Struct {
-  static {
-    chunkUSNT2KNT_cjs.__name(this, "PrebuiltData");
-  }
-  static _capnp = {
-    displayName: "PrebuiltData",
-    id: "c5b1a6ca696328ee",
-    size: new $__namespace.ObjectSize(0, 4)
-  };
-  /**
-  * An additional name for the file.
-  *
-  */
-  get id() {
-    return $__namespace.utils.getText(0, this);
-  }
-  set id(value) {
-    $__namespace.utils.setText(0, value, this);
-  }
-  /**
-  * The file exports.
-  *
-  */
-  get name() {
-    return $__namespace.utils.getText(1, this);
-  }
-  set name(value) {
-    $__namespace.utils.setText(1, value, this);
-  }
-  _adoptExports(value) {
-    $__namespace.utils.adopt(value, $__namespace.utils.getPointer(2, this));
-  }
-  _disownExports() {
-    return $__namespace.utils.disown(this.exports);
-  }
-  /**
-  * The source map for the file.
-  *
-  */
-  get exports() {
-    return $__namespace.utils.getList(2, $__namespace.TextList, this);
-  }
-  _hasExports() {
-    return !$__namespace.utils.isNull($__namespace.utils.getPointer(2, this));
-  }
-  _initExports(length) {
-    return $__namespace.utils.initList(2, $__namespace.TextList, length, this);
-  }
-  set exports(value) {
-    $__namespace.utils.copyFrom(value, $__namespace.utils.getPointer(2, this));
-  }
-  get map() {
-    return $__namespace.utils.getText(3, this);
-  }
-  set map(value) {
-    $__namespace.utils.setText(3, value, this);
-  }
-  toString() {
-    return "PrebuiltData_" + super.toString();
-  }
-};
-var AssetData = class extends $__namespace.Struct {
-  static {
-    chunkUSNT2KNT_cjs.__name(this, "AssetData");
-  }
-  static _capnp = {
-    displayName: "AssetData",
-    id: "da660c6c1fa4c830",
-    size: new $__namespace.ObjectSize(8, 3)
-  };
-  /**
-  * An additional name for the file.
-  *
-  */
-  get id() {
-    return $__namespace.utils.getText(0, this);
-  }
-  set id(value) {
-    $__namespace.utils.setText(0, value, this);
-  }
-  /**
-  * Indicates whether the file needs a code reference.
-  *
-  */
-  get name() {
-    return $__namespace.utils.getText(1, this);
-  }
-  set name(value) {
-    $__namespace.utils.setText(1, value, this);
-  }
-  /**
-  * The original file name before any transformations.
-  *
-  */
-  get needsCodeReference() {
-    return $__namespace.utils.getBit(0, this);
-  }
-  set needsCodeReference(value) {
-    $__namespace.utils.setBit(0, value, this);
-  }
-  get originalFileName() {
-    return $__namespace.utils.getText(2, this);
-  }
-  set originalFileName(value) {
-    $__namespace.utils.setText(2, value, this);
-  }
-  toString() {
-    return "AssetData_" + super.toString();
-  }
-};
 var FileId = class extends $__namespace.Struct {
   static {
     chunkUSNT2KNT_cjs.__name(this, "FileId");
@@ -504,14 +327,11 @@ var FileSystem = class _FileSystem extends $__namespace.Struct {
   static _capnp = {
     displayName: "FileSystem",
     id: "ae0c23d43e56abcf",
-    size: new $__namespace.ObjectSize(0, 6)
+    size: new $__namespace.ObjectSize(0, 3)
   };
   static _Ids;
   static _Files;
   static _Metadata;
-  static _Assets;
-  static _Chunks;
-  static _Prebuilt;
   _adoptIds(value) {
     $__namespace.utils.adopt(value, $__namespace.utils.getPointer(0, this));
   }
@@ -566,60 +386,6 @@ var FileSystem = class _FileSystem extends $__namespace.Struct {
   set metadata(value) {
     $__namespace.utils.copyFrom(value, $__namespace.utils.getPointer(2, this));
   }
-  _adoptAssets(value) {
-    $__namespace.utils.adopt(value, $__namespace.utils.getPointer(3, this));
-  }
-  _disownAssets() {
-    return $__namespace.utils.disown(this.assets);
-  }
-  get assets() {
-    return $__namespace.utils.getList(3, _FileSystem._Assets, this);
-  }
-  _hasAssets() {
-    return !$__namespace.utils.isNull($__namespace.utils.getPointer(3, this));
-  }
-  _initAssets(length) {
-    return $__namespace.utils.initList(3, _FileSystem._Assets, length, this);
-  }
-  set assets(value) {
-    $__namespace.utils.copyFrom(value, $__namespace.utils.getPointer(3, this));
-  }
-  _adoptChunks(value) {
-    $__namespace.utils.adopt(value, $__namespace.utils.getPointer(4, this));
-  }
-  _disownChunks() {
-    return $__namespace.utils.disown(this.chunks);
-  }
-  get chunks() {
-    return $__namespace.utils.getList(4, _FileSystem._Chunks, this);
-  }
-  _hasChunks() {
-    return !$__namespace.utils.isNull($__namespace.utils.getPointer(4, this));
-  }
-  _initChunks(length) {
-    return $__namespace.utils.initList(4, _FileSystem._Chunks, length, this);
-  }
-  set chunks(value) {
-    $__namespace.utils.copyFrom(value, $__namespace.utils.getPointer(4, this));
-  }
-  _adoptPrebuilt(value) {
-    $__namespace.utils.adopt(value, $__namespace.utils.getPointer(5, this));
-  }
-  _disownPrebuilt() {
-    return $__namespace.utils.disown(this.prebuilt);
-  }
-  get prebuilt() {
-    return $__namespace.utils.getList(5, _FileSystem._Prebuilt, this);
-  }
-  _hasPrebuilt() {
-    return !$__namespace.utils.isNull($__namespace.utils.getPointer(5, this));
-  }
-  _initPrebuilt(length) {
-    return $__namespace.utils.initList(5, _FileSystem._Prebuilt, length, this);
-  }
-  set prebuilt(value) {
-    $__namespace.utils.copyFrom(value, $__namespace.utils.getPointer(5, this));
-  }
   toString() {
     return "FileSystem_" + super.toString();
   }
@@ -628,9 +394,6 @@ FileMetadata._Properties = $__namespace.CompositeList(FileMetadata_KeyValuePair)
 FileSystem._Ids = $__namespace.CompositeList(FileId);
 FileSystem._Files = $__namespace.CompositeList(FileData);
 FileSystem._Metadata = $__namespace.CompositeList(FileMetadata);
-FileSystem._Assets = $__namespace.CompositeList(AssetData);
-FileSystem._Chunks = $__namespace.CompositeList(ChunkData);
-FileSystem._Prebuilt = $__namespace.CompositeList(PrebuiltData);
 
 // src/types/fs.ts
 var __VFS_PATCH__ = "__VFS_PATCH__";
@@ -640,13 +403,9 @@ function isBufferEncoding(options) {
 }
 chunkUSNT2KNT_cjs.__name(isBufferEncoding, "isBufferEncoding");
 function isPowerlinesWriteFileOptions(options) {
-  return !isBufferEncoding(options) && isSetObject.isSetObject(options) && ("skipFormat" in options || "mode" in options && (options.mode === "fs" || options.mode === "virtual"));
+  return !isBufferEncoding(options) && isSetObject.isSetObject(options) && "mode" in options && (options.mode === "fs" || options.mode === "virtual");
 }
 chunkUSNT2KNT_cjs.__name(isPowerlinesWriteFileOptions, "isPowerlinesWriteFileOptions");
-function isNodeWriteFileOptions(options) {
-  return !isUndefined.isUndefined(options) && (isBufferEncoding(options) || !isPowerlinesWriteFileOptions(options));
-}
-chunkUSNT2KNT_cjs.__name(isNodeWriteFileOptions, "isNodeWriteFileOptions");
 function isVirtualFileData(obj) {
   return !!(isSetObject.isSetObject(obj) && "code" in obj && obj.code);
 }
@@ -783,6 +542,18 @@ function patchFS(originalFS, vfs) {
   };
 }
 chunkUSNT2KNT_cjs.__name(patchFS, "patchFS");
+function isValidId(id, prefix = "powerlines") {
+  return id.replace(/^\\0/, "").startsWith(`${prefix.replace(/:$/, "")}`);
+}
+chunkUSNT2KNT_cjs.__name(isValidId, "isValidId");
+function normalizeId(id, prefix = "powerlines") {
+  return `${prefix.replace(/:$/, "")}:${toFilePath(id).replace(new RegExp(`^${prefix.replace(/:$/, "")}:`), "").replace(/^\\0/, "").replace(filePathFns.findFileDotExtensionSafe(toFilePath(id)), "")}`;
+}
+chunkUSNT2KNT_cjs.__name(normalizeId, "normalizeId");
+function normalizePath(path, builtinsPath, prefix = "powerlines") {
+  return isValidId(toFilePath(path), prefix) ? normalizeId(toFilePath(path), prefix).replace(new RegExp(`^${prefix.replace(/:$/, "")}:`), builtinsPath) : toFilePath(path);
+}
+chunkUSNT2KNT_cjs.__name(normalizePath, "normalizePath");
 var UnifiedFS = class _UnifiedFS extends unionfs.Union {
   static {
     chunkUSNT2KNT_cjs.__name(this, "UnifiedFS");
@@ -959,9 +730,9 @@ var VirtualFileSystem = class _VirtualFileSystem {
   */
   #paths;
   /**
-  * A map of virtual file paths to their underlying file content.
+  * A cache for module resolution results.
   */
-  #cachedResolver = /* @__PURE__ */ new Map();
+  #resolverCache;
   /**
   * The unified volume that combines the virtual file system with the real file system.
   *
@@ -996,189 +767,35 @@ var VirtualFileSystem = class _VirtualFileSystem {
   * @returns `true` if the path exists, otherwise `false`.
   */
   #existsSync(path) {
-    const formattedPath = this.formatPath(path);
-    return this.#unifiedFS.virtual.existsSync(formattedPath) || this.#unifiedFS.physical.existsSync(formattedPath) || this.#unifiedFS.resolveFS(path).existsSync(formattedPath);
-  }
-  /**
-  * 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.
-  */
-  #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"), ".*")}$`);
-  }
-  /**
-  * Formats a file id by removing the file extension and prepending the runtime prefix.
-  *
-  * @param id - The file ID to format.
-  * @returns The formatted file ID.
-  */
-  #formatId(id) {
-    const formattedId = toFilePath(id);
-    return `${this.#context.config.output.builtinPrefix}:${formattedId.replace(new RegExp(`^${this.#context.config.output.builtinPrefix}:`), "").replace(/^\\0/, "").replace(filePathFns.findFileDotExtensionSafe(formattedId), "")}`;
-  }
-  /**
-  * Resolves an id parameter to a corresponding virtual file path in the virtual file system (VFS).
-  *
-  * @param id - The id to resolve.
-  * @returns The resolved file id if it exists, otherwise undefined.
-  */
-  #resolveId(id) {
-    if (this.#ids[this.#formatId(id)]) {
-      return this.#ids[this.#formatId(id)] || false;
-    }
-    return false;
-  }
-  /**
-  * Resolves a path parameter to a corresponding virtual file path in the virtual file system (VFS).
-  *
-  * @param path - The path to resolve.
-  * @param options - Optional parameters for resolving the path.
-  * @returns The resolved file path if it exists, otherwise undefined.
-  */
-  #resolvePath(path, options = {}) {
-    if (isType.isAbsolutePath(path)) {
-      if (this.#existsSync(path)) {
-        return path;
-      }
-      const result = this.#checkVariants(path);
-      if (result) {
-        return result;
-      }
-    }
-    for (const parentPath of this.#resolveParentPaths(path, options.paths)) {
-      const request = joinPaths.joinPaths(parentPath, path);
-      if (this.#existsSync(request)) {
-        return request;
-      }
-      const result = this.#checkVariants(request);
-      if (result) {
-        return result;
-      }
-    }
-    return false;
-  }
-  /**
-  * 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.
-  */
-  #resolveParentPaths(request, parents = []) {
-    let paths = [
-      this.#context.workspaceConfig.workspaceRoot,
-      joinPaths.joinPaths(this.#context.workspaceConfig.workspaceRoot, this.#context.config.projectRoot)
-    ];
-    if (this.#context.tsconfig.options.paths) {
-      paths = this.#context.tsconfig.options.paths ? Object.keys(this.#context.tsconfig.options.paths).filter((tsconfigPath) => request.startsWith(tsconfigPath.replaceAll("*", ""))).map((tsconfigPath) => this.#context.tsconfig.options.paths?.[tsconfigPath]).flat().reduce((ret, path) => {
-        if (path && !ret.includes(joinPaths.joinPaths(this.#context.workspaceConfig.workspaceRoot, path))) {
-          ret.push(joinPaths.joinPaths(this.#context.workspaceConfig.workspaceRoot, path));
-        }
-        return ret;
-      }, paths) : paths;
-    }
-    return paths.reduce((ret, path) => {
-      if (!ret.includes(path)) {
-        ret.push(path);
-      }
-      return ret;
-    }, parents.filter(Boolean).map((p) => this.formatPath(p)));
-  }
-  /**
-  * Clears the resolver cache for a given path.
-  *
-  * @param path - The path to clear the resolver cache for.
-  */
-  #clearResolverCache(path) {
-    this.#cachedResolver.keys().filter((key) => key.startsWith(toFilePath(path))).forEach((key) => this.#cachedResolver.delete(key));
+    return this.#unifiedFS.virtual.existsSync(this.#normalizePath(path)) || this.#unifiedFS.physical.existsSync(this.#normalizePath(path)) || this.#unifiedFS.resolveFS(path).existsSync(this.#normalizePath(path));
   }
   /**
-  * Check if the file exists with different variants (index, extensions).
+  * Normalizes a given module id by resolving it against the built-ins path.
   *
-  * @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 id - The module id to normalize.
+  * @returns The normalized module id.
   */
-  #checkVariants(request, parentPath) {
-    const path = parentPath ? joinPaths.joinPaths(parentPath, request) : request;
-    let file = this.#checkExtensions(path);
-    if (file) {
-      return file;
-    }
-    file = this.#checkIndex(path);
-    if (file) {
-      return file;
-    }
-    return false;
+  #normalizeId(id) {
+    return normalizeId(id, this.#context.config.output.builtinPrefix);
   }
   /**
-  * Check if the index file exists in the given request path.
+  * Normalizes a given path by resolving it against the project root, workspace root, and built-ins path.
   *
-  * @param request - The request path to check.
-  * @returns The index file path if it exists, otherwise false.
+  * @param path - The path to normalize.
+  * @returns The normalized path.
   */
-  #checkIndex(request) {
-    let file = joinPaths.joinPaths(request, "index");
-    if (this.#existsSync(file)) {
-      return file;
-    }
-    file = this.#checkExtensions(file);
-    if (file) {
-      return file;
-    }
-    return false;
+  #normalizePath(path) {
+    return normalizePath(path, this.#context.builtinsPath, this.#context.config.output.builtinPrefix);
   }
   /**
-  * Check if the file exists with different extensions.
+  * Builds a regular expression from a string pattern for path matching.
   *
-  * @param request - The request path to check.
-  * @returns The file path if it exists with any of the checked extensions, otherwise false.
+  * @param path - The string pattern to convert.
+  * @returns A regular expression for matching paths.
   */
-  #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;
-    }
-    return false;
+  #buildRegex(path) {
+    const token = "::GLOBSTAR::";
+    return new RegExp(`^${this.#normalizePath(path).replace(/\*\*/g, token).replace(/[.+^${}()|[\]\\]/g, "\\$&").replace(/\*/g, "[^/]*").replace(/\?/g, "[^/]").replace(new RegExp(token, "g"), ".*")}$`);
   }
   /**
   * Creates a virtual file system (VFS) that is backed up to a Cap'n Proto message buffer.
@@ -1187,8 +804,8 @@ var VirtualFileSystem = class _VirtualFileSystem {
   * @returns A promise that resolves to a new virtual file system instance.
   */
   static async create(context) {
-    if (!context.config.skipCache && exists.existsSync(joinPaths.joinPaths(context.cachePath, "fs.bin"))) {
-      const buffer$1 = await buffer.readFileBuffer(joinPaths.joinPaths(context.cachePath, "fs.bin"));
+    if (!context.config.skipCache && exists.existsSync(joinPaths.joinPaths(context.dataPath, "fs.bin"))) {
+      const buffer$1 = await buffer.readFileBuffer(joinPaths.joinPaths(context.dataPath, "fs.bin"));
       const message2 = new $__namespace.Message(buffer$1, false);
       return new _VirtualFileSystem(context, message2.getRoot(FileSystem));
     }
@@ -1202,8 +819,8 @@ var VirtualFileSystem = class _VirtualFileSystem {
   * @returns A new virtual file system instance.
   */
   static createSync(context) {
-    if (!context.config.skipCache && exists.existsSync(joinPaths.joinPaths(context.cachePath, "fs.bin"))) {
-      const buffer$1 = buffer.readFileBufferSync(joinPaths.joinPaths(context.cachePath, "fs.bin"));
+    if (!context.config.skipCache && exists.existsSync(joinPaths.joinPaths(context.dataPath, "fs.bin"))) {
+      const buffer$1 = buffer.readFileBufferSync(joinPaths.joinPaths(context.dataPath, "fs.bin"));
       const message2 = new $__namespace.Message(buffer$1, false);
       return new _VirtualFileSystem(context, message2.getRoot(FileSystem));
     }
@@ -1214,19 +831,43 @@ var VirtualFileSystem = class _VirtualFileSystem {
   * A map of file ids to their metadata.
   */
   get metadata() {
-    return this.#metadata;
+    return new Proxy(this.#metadata, {
+      get: /* @__PURE__ */ chunkUSNT2KNT_cjs.__name((target, prop) => {
+        return target[this.#normalizeId(prop)];
+      }, "get")
+    });
   }
   /**
-  * A map of module ids to their file paths.
+  * A map of file paths to their module ids.
   */
   get ids() {
-    return this.#ids;
+    return new Proxy(this.#paths, {
+      get: /* @__PURE__ */ chunkUSNT2KNT_cjs.__name((target, prop) => {
+        return target[this.#normalizePath(prop)];
+      }, "get")
+    });
   }
   /**
-  * A map of virtual file paths to their IDs.
+  * A map of module ids to their file paths.
   */
   get paths() {
-    return this.#paths;
+    return new Proxy(this.#paths, {
+      get: /* @__PURE__ */ chunkUSNT2KNT_cjs.__name((target, prop) => {
+        return target[this.#normalizeId(prop)];
+      }, "get")
+    });
+  }
+  get resolverCache() {
+    if (!this.#resolverCache) {
+      this.#resolverCache = flatCache.create({
+        cacheId: "module-resolution",
+        cacheDir: this.#context.cachePath,
+        ttl: 60 * 60 * 1e3,
+        lruSize: 5e3,
+        persistInterval: 100
+      });
+    }
+    return this.#resolverCache;
   }
   /**
   * Creates a new instance of the {@link VirtualFileSystem}.
@@ -1271,17 +912,13 @@ var VirtualFileSystem = class _VirtualFileSystem {
   * Check if a path or id corresponds to a virtual file **(does not actually exists on disk)**.
   *
   * @param pathOrId - The path or id to check.
-  * @param options - Optional parameters for resolving the path.
   * @returns Whether the path or id corresponds to a virtual file **(does not actually exists on disk)**.
   */
-  isVirtual(pathOrId, options = {}) {
+  isVirtual(pathOrId, importer, options = {}) {
     if (!pathOrId) {
       return false;
     }
-    const resolvedPath = this.resolve(pathOrId, {
-      ...options,
-      pathType: "file"
-    });
+    const resolvedPath = this.resolveSync(pathOrId, importer, options);
     if (!resolvedPath) {
       return false;
     }
@@ -1291,17 +928,13 @@ var VirtualFileSystem = class _VirtualFileSystem {
   * Check if a path or id corresponds to a file written to the file system **(actually exists on disk)**.
   *
   * @param pathOrId - The path or id to check.
-  * @param options - Optional parameters for resolving the path.
   * @returns Whether the path or id corresponds to a file written to the file system **(actually exists on disk)**.
   */
-  isPhysical(pathOrId, options = {}) {
+  isPhysical(pathOrId, importer, options = {}) {
     if (!pathOrId) {
       return false;
     }
-    const resolvedPath = this.resolve(pathOrId, {
-      ...options,
-      pathType: "file"
-    });
+    const resolvedPath = this.resolveSync(pathOrId, importer, options);
     if (!resolvedPath) {
       return false;
     }
@@ -1323,16 +956,17 @@ var VirtualFileSystem = class _VirtualFileSystem {
   * @param path - The path to create the directory at.
   */
   unlinkSync(path, options) {
-    const formattedPath = toFilePath(path);
-    if (!this.isFile(formattedPath)) {
+    if (!this.isFile(this.#normalizePath(path))) {
       return;
     }
-    this.#log(types.LogLevelLabel.TRACE, `Synchronously removing file: ${formattedPath}`);
-    this.#unifiedFS.resolveFS(path, options).unlinkSync(formattedPath);
-    if (this.paths[formattedPath] && this.metadata[this.paths[formattedPath]]) {
-      delete this.metadata[this.paths[formattedPath]];
+    this.#log(types.LogLevelLabel.TRACE, `Synchronously removing file: ${this.#normalizePath(path)}`);
+    this.#unifiedFS.resolveFS(path, options).unlinkSync(this.#normalizePath(path));
+    if (this.#ids[this.#normalizePath(path)] && this.#metadata[this.#ids[this.#normalizePath(path)]]) {
+      delete this.#metadata[this.#ids[this.#normalizePath(path)]];
+      delete this.#ids[this.#normalizePath(path)];
+      delete this.#paths[this.#normalizeId(path)];
+      this.#resolverCache.delete(this.#normalizePath(path));
     }
-    this.#clearResolverCache(formattedPath);
   }
   /**
   * Removes a file in the virtual file system (VFS).
@@ -1340,19 +974,17 @@ var VirtualFileSystem = class _VirtualFileSystem {
   * @param path - The path to create the directory at.
   */
   async unlink(path, options) {
-    const formattedPath = toFilePath(path);
-    if (!this.isFile(formattedPath)) {
+    if (!this.isFile(this.#normalizePath(path))) {
       return;
     }
-    this.#log(types.LogLevelLabel.TRACE, `Removing file: ${formattedPath}`);
+    this.#log(types.LogLevelLabel.TRACE, `Removing file: ${this.#normalizePath(path)}`);
     if (isFunction.isFunction(this.#unifiedFS.resolveFS(path, options).promises.unlink)) {
-      await this.#unifiedFS.resolveFS(path, options).promises.unlink(formattedPath);
-      if (this.paths[formattedPath] && this.metadata[this.paths[formattedPath]]) {
-        delete this.metadata[this.paths[formattedPath]];
+      await this.#unifiedFS.resolveFS(path, options).promises.unlink(this.#normalizePath(path));
+      if (this.#ids[this.#normalizePath(path)] && this.#metadata[this.#ids[this.#normalizePath(path)]]) {
+        delete this.#metadata[this.#ids[this.#normalizePath(path)]];
       }
-      this.#clearResolverCache(formattedPath);
     } else {
-      this.unlinkSync(formattedPath, options);
+      this.unlinkSync(this.#normalizePath(path), options);
     }
   }
   /**
@@ -1362,15 +994,13 @@ var VirtualFileSystem = class _VirtualFileSystem {
   * @param options - Options for creating the directory.
   */
   rmdirSync(path, options = {}) {
-    const formattedPath = toFilePath(path);
-    if (!this.isDirectory(formattedPath)) {
+    if (!this.isDirectory(this.#normalizePath(path))) {
       return;
     }
-    this.#log(types.LogLevelLabel.TRACE, `Synchronously removing directory: ${formattedPath}`);
-    this.#unifiedFS.resolveFS(path, options).rmdirSync(formattedPath, defu2__default.default(options, {
+    this.#log(types.LogLevelLabel.TRACE, `Synchronously removing directory: ${this.#normalizePath(path)}`);
+    this.#unifiedFS.resolveFS(path, options).rmdirSync(this.#normalizePath(path), defu2__default.default(options, {
       recursive: true
     }));
-    this.#clearResolverCache(formattedPath);
   }
   /**
   * Removes a directory in the virtual file system (VFS).
@@ -1380,19 +1010,17 @@ var VirtualFileSystem = class _VirtualFileSystem {
   * @returns A promise that resolves to the path of the created directory, or undefined if the directory could not be created.
   */
   async rmdir(path, options = {}) {
-    const formattedPath = toFilePath(path);
-    if (!this.isDirectory(formattedPath)) {
+    if (!this.isDirectory(this.#normalizePath(path))) {
       return;
     }
-    this.#log(types.LogLevelLabel.TRACE, `Removing directory: ${formattedPath}`);
+    this.#log(types.LogLevelLabel.TRACE, `Removing directory: ${this.#normalizePath(path)}`);
     if (isFunction.isFunction(this.#unifiedFS.resolveFS(path, options).promises.rm)) {
-      await this.#unifiedFS.resolveFS(path, options).promises.rm(formattedPath, defu2__default.default(options, {
+      await this.#unifiedFS.resolveFS(path, options).promises.rm(this.#normalizePath(path), defu2__default.default(options, {
         force: true,
         recursive: true
       }));
-      this.#clearResolverCache(formattedPath);
     } else {
-      this.rmdirSync(formattedPath, defu2__default.default(options ?? {}, {
+      this.rmdirSync(this.#normalizePath(path), defu2__default.default(options ?? {}, {
         force: true,
         recursive: true
       }));
@@ -1406,11 +1034,11 @@ var VirtualFileSystem = class _VirtualFileSystem {
   * @returns A promise that resolves when the file is removed.
   */
   async rm(path, options = {}) {
-    this.#log(types.LogLevelLabel.TRACE, `Removing: ${toFilePath(path)}`);
-    if (this.isDirectory(path)) {
-      return this.rmdir(path, options);
+    this.#log(types.LogLevelLabel.TRACE, `Removing: ${this.#normalizePath(path)}`);
+    if (this.isDirectory(this.#normalizePath(path))) {
+      return this.rmdir(this.#normalizePath(path), options);
     }
-    return this.unlink(path, options);
+    return this.unlink(this.#normalizePath(path), options);
   }
   /**
   * Synchronously removes a file or directory in the virtual file system (VFS).
@@ -1419,11 +1047,11 @@ var VirtualFileSystem = class _VirtualFileSystem {
   * @param options - Options for removing the file or directory.
   */
   rmSync(path, options = {}) {
-    this.#log(types.LogLevelLabel.TRACE, `Removing: ${toFilePath(path)}`);
-    if (this.isDirectory(path)) {
-      return this.rmdirSync(path, options);
+    this.#log(types.LogLevelLabel.TRACE, `Removing: ${this.#normalizePath(path)}`);
+    if (this.isDirectory(this.#normalizePath(path))) {
+      return this.rmdirSync(this.#normalizePath(path), options);
     }
-    return this.unlinkSync(path, options);
+    return this.unlinkSync(this.#normalizePath(path), options);
   }
   /**
   * Creates a directory in the virtual file system (VFS).
@@ -1433,9 +1061,9 @@ var VirtualFileSystem = class _VirtualFileSystem {
   * @returns A promise that resolves to the path of the created directory, or undefined if the directory could not be created.
   */
   mkdirSync(path, options = {}) {
-    const filePath = toFilePath(path);
-    this.#clearResolverCache(filePath);
-    return this.#unifiedFS.resolveFS(filePath, options).mkdirSync(filePath, defu2__default.default(options ?? {}, {
+    return this.#unifiedFS.resolveFS(this.#normalizePath(path), options).mkdirSync(this.#normalizePath(path), defu2__default.default(omit.omit(options, [
+      "mode"
+    ]), {
       recursive: true
     }));
   }
@@ -1448,17 +1076,19 @@ var VirtualFileSystem = class _VirtualFileSystem {
   */
   async mkdir(path, options = {}) {
     let result;
-    const filePath = toFilePath(path);
-    if (isFunction.isFunction(this.#unifiedFS.resolveFS(filePath, options).promises.mkdir)) {
-      result = await this.#unifiedFS.resolveFS(filePath, options).promises.mkdir(filePath, defu2__default.default(options ?? {}, {
+    if (isFunction.isFunction(this.#unifiedFS.resolveFS(this.#normalizePath(path), options).promises.mkdir)) {
+      result = await this.#unifiedFS.resolveFS(this.#normalizePath(path), options).promises.mkdir(this.#normalizePath(path), defu2__default.default(omit.omit(options, [
+        "mode"
+      ]), {
         recursive: true
       }));
     } else {
-      result = this.#unifiedFS.resolveFS(filePath, options).mkdirSync(filePath, defu2__default.default(options ?? {}, {
+      result = this.#unifiedFS.resolveFS(this.#normalizePath(path), options).mkdirSync(this.#normalizePath(path), defu2__default.default(omit.omit(options, [
+        "mode"
+      ]), {
         recursive: true
       }));
     }
-    this.#clearResolverCache(filePath);
     return result;
   }
   /**
@@ -1470,17 +1100,15 @@ var VirtualFileSystem = class _VirtualFileSystem {
   async glob(patterns) {
     const results = [];
     for (const pattern of toArray.toArray(patterns)) {
-      const normalized = this.formatPath(pattern);
+      const normalized = this.#normalizePath(pattern);
       if (!/[*?[\]{}]/.test(normalized) && !normalized.includes("**")) {
-        const resolved = this.resolve(normalized, {
-          pathType: "file"
-        });
+        const resolved = this.resolveSync(normalized);
         if (resolved && !results.includes(resolved)) {
           results.push(resolved);
         }
         continue;
       }
-      const absPattern = isType.isAbsolutePath(normalized) ? normalized : this.formatPath(joinPaths.joinPaths(this.#context.workspaceConfig.workspaceRoot, normalized));
+      const absPattern = isType.isAbsolutePath(normalized) ? normalized : this.#normalizePath(joinPaths.joinPaths(this.#context.workspaceConfig.workspaceRoot, normalized));
       const firstGlobIdx = absPattern.search(/[*?[\]{}]/);
       const baseDir = firstGlobIdx === -1 ? filePathFns.findFilePath(absPattern) : absPattern.slice(0, Math.max(0, absPattern.lastIndexOf("/", firstGlobIdx)));
       const stack = [
@@ -1495,7 +1123,7 @@ var VirtualFileSystem = class _VirtualFileSystem {
           continue;
         }
         for (const entry of entries) {
-          const full = this.formatPath(joinPaths.joinPaths(dir, entry));
+          const full = this.#normalizePath(joinPaths.joinPaths(dir, entry));
           let stats;
           try {
             stats = this.#unifiedFS.lstatSync(full);
@@ -1507,9 +1135,7 @@ var VirtualFileSystem = class _VirtualFileSystem {
             stack.push(full);
           } else if (stats.isFile()) {
             if (this.#buildRegex(absPattern).test(full)) {
-              const resolved = this.resolve(full, {
-                pathType: "file"
-              });
+              const resolved = this.resolveSync(full);
               if (resolved && !results.includes(resolved)) {
                 results.push(resolved);
               }
@@ -1529,17 +1155,15 @@ var VirtualFileSystem = class _VirtualFileSystem {
   globSync(patterns) {
     const results = [];
     for (const pattern of toArray.toArray(patterns)) {
-      const normalized = this.formatPath(pattern);
+      const normalized = this.#normalizePath(pattern);
       if (!/[*?[\]{}]/.test(normalized) && !normalized.includes("**")) {
-        const resolved = this.resolve(normalized, {
-          pathType: "file"
-        });
+        const resolved = this.resolveSync(normalized);
         if (resolved && !results.includes(resolved)) {
           results.push(resolved);
         }
         continue;
       }
-      const absPattern = isType.isAbsolutePath(normalized) ? normalized : this.formatPath(joinPaths.joinPaths(this.#context.workspaceConfig.workspaceRoot, normalized));
+      const absPattern = isType.isAbsolutePath(normalized) ? normalized : this.#normalizePath(joinPaths.joinPaths(this.#context.workspaceConfig.workspaceRoot, normalized));
       const firstGlobIdx = absPattern.search(/[*?[\]{}]/);
       const baseDir = firstGlobIdx === -1 ? filePathFns.findFilePath(absPattern) : absPattern.slice(0, Math.max(0, absPattern.lastIndexOf("/", firstGlobIdx)));
       const stack = [
@@ -1554,7 +1178,7 @@ var VirtualFileSystem = class _VirtualFileSystem {
           continue;
         }
         for (const entry of entries) {
-          const full = this.formatPath(joinPaths.joinPaths(dir, entry));
+          const full = this.#normalizePath(joinPaths.joinPaths(dir, entry));
           let stats;
           try {
             stats = this.#unifiedFS.lstatSync(full);
@@ -1566,9 +1190,7 @@ var VirtualFileSystem = class _VirtualFileSystem {
             stack.push(full);
           } else if (stats.isFile()) {
             if (this.#buildRegex(absPattern).test(full)) {
-              const resolved = this.resolve(full, {
-                pathType: "file"
-              });
+              const resolved = this.resolveSync(full);
               if (resolved && !results.includes(resolved)) {
                 results.push(resolved);
               }
@@ -1638,21 +1260,15 @@ var VirtualFileSystem = class _VirtualFileSystem {
   * @returns A promise that resolves to the contents of the file as a string, or undefined if the file does not exist.
   */
   async readFile(pathOrId, options = "utf8") {
-    if (!pathOrId) {
-      return void 0;
-    }
-    const filePath = this.resolve(toFilePath(pathOrId), {
-      pathType: "file"
-    });
-    if (filePath) {
+    const filePath = await this.resolve(pathOrId);
+    if (filePath && this.isFile(filePath)) {
       let result;
       if (isFunction.isFunction(this.#unifiedFS.resolveFS(filePath).promises.readFile)) {
         result = (await this.#unifiedFS.resolveFS(filePath).promises.readFile(filePath, options))?.toString("utf8");
       } else {
         result = this.#unifiedFS.resolveFS(filePath).readFileSync(filePath, options);
       }
-      const content = isBuffer.isBuffer(result) ? bufferToString.bufferToString(result) : result;
-      return content;
+      return isBuffer.isBuffer(result) ? bufferToString.bufferToString(result) : result;
     }
     return void 0;
   }
@@ -1663,16 +1279,10 @@ var VirtualFileSystem = class _VirtualFileSystem {
   * @returns The contents of the file as a string, or undefined if the file does not exist.
   */
   readFileSync(pathOrId, options = "utf8") {
-    if (!pathOrId) {
-      return void 0;
-    }
-    const filePath = this.resolve(toFilePath(pathOrId), {
-      pathType: "file"
-    });
-    if (filePath) {
+    const filePath = this.resolveSync(pathOrId);
+    if (filePath && this.isFile(filePath)) {
       const result = this.#unifiedFS.resolveFS(filePath).readFileSync(filePath, options);
-      const content = isBuffer.isBuffer(result) ? bufferToString.bufferToString(result) : result;
-      return content;
+      return isBuffer.isBuffer(result) ? bufferToString.bufferToString(result) : result;
     }
     return void 0;
   }
@@ -1685,34 +1295,40 @@ var VirtualFileSystem = class _VirtualFileSystem {
   * @returns A promise that resolves when the file is written.
   */
   async writeFile(path, data = "", options = "utf8") {
-    const formattedPath = this.formatPath(path);
-    if (!this.isDirectory(filePathFns.findFilePath(formattedPath))) {
-      await this.mkdir(filePathFns.findFilePath(formattedPath), isPowerlinesWriteFileOptions(options) ? options : void 0);
+    if (!this.isDirectory(filePathFns.findFilePath(this.#normalizePath(path)))) {
+      await this.mkdir(filePathFns.findFilePath(this.#normalizePath(path)), isPowerlinesWriteFileOptions(options) ? options : void 0);
     }
-    let code = isVirtualFileData(data) ? data.code : data;
+    const metadata = isVirtualFileData(data) ? data : {};
+    metadata.id = this.#normalizeId(path);
+    let code = isVirtualFileData(data) ? metadata.code : data;
     if ((!isPowerlinesWriteFileOptions(options) || !options.skipFormat) && isSetString.isSetString(code)) {
-      const resolvedConfig = await prettier.resolveConfig(formattedPath);
+      const resolvedConfig = await prettier.resolveConfig(this.#normalizePath(path));
       if (resolvedConfig) {
         code = await prettier.format(code, {
-          absolutePath: formattedPath,
+          absolutePath: this.#normalizePath(path),
           ...resolvedConfig
         });
       }
     }
-    const outputMode = this.#unifiedFS.resolveMode(formattedPath, isPowerlinesWriteFileOptions(options) ? options : void 0);
-    this.#log(types.LogLevelLabel.TRACE, `Writing ${formattedPath} file to the ${outputMode === "fs" ? "" : "virtual "}file system (size: ${prettyBytes.prettyBytes(new buffer$1.Blob(toArray.toArray(code)).size)})`);
-    this.metadata[formattedPath] = {
+    const outputMode = this.#unifiedFS.resolveMode(this.#normalizePath(path), isPowerlinesWriteFileOptions(options) ? options : void 0);
+    this.#log(types.LogLevelLabel.TRACE, `Writing ${this.#normalizePath(path)} file to the ${outputMode === "fs" ? "" : "virtual "}file system (size: ${prettyBytes.prettyBytes(new buffer$1.Blob(toArray.toArray(code)).size)})`);
+    this.#metadata[metadata.id] = {
       mode: outputMode,
       variant: "normal",
       timestamp: Date.now(),
-      ...isVirtualFileData(data) ? data : {}
+      ...metadata
     };
-    this.#clearResolverCache(formattedPath);
-    const ifs = this.#unifiedFS.resolveFS(formattedPath, isPowerlinesWriteFileOptions(options) ? options : void 0);
+    this.#paths[metadata.id] = this.#normalizePath(path);
+    this.#ids[this.#normalizePath(path)] = metadata.id;
+    const ifs = this.#unifiedFS.resolveFS(this.#normalizePath(path), isPowerlinesWriteFileOptions(options) ? options : void 0);
     if (isFunction.isFunction(ifs.promises.writeFile)) {
-      return ifs.promises.writeFile(formattedPath, code, isNodeWriteFileOptions(options) ? options : "utf8");
+      return ifs.promises.writeFile(this.#normalizePath(path), code, isSetObject.isSetObject(options) ? omit.omit(options, [
+        "mode"
+      ]) : "utf8");
     }
-    return ifs.writeFileSync(formattedPath, code, isNodeWriteFileOptions(options) ? options : "utf8");
+    return ifs.writeFileSync(this.#normalizePath(path), code, isSetObject.isSetObject(options) ? omit.omit(options, [
+      "mode"
+    ]) : "utf8");
   }
   /**
   * Synchronously writes a file to the virtual file system (VFS).
@@ -1722,21 +1338,23 @@ var VirtualFileSystem = class _VirtualFileSystem {
   * @param options - Optional parameters for writing the file.
   */
   writeFileSync(path, data = "", options = "utf8") {
-    const formattedPath = this.formatPath(path);
-    if (!this.isDirectory(filePathFns.findFilePath(formattedPath))) {
-      this.mkdirSync(filePathFns.findFilePath(formattedPath), isPowerlinesWriteFileOptions(options) ? options : void 0);
-    }
-    const code = isVirtualFileData(data) ? data.code : data;
-    const outputMode = this.#unifiedFS.resolveMode(formattedPath, isPowerlinesWriteFileOptions(options) ? options : void 0);
-    this.#log(types.LogLevelLabel.TRACE, `Writing ${formattedPath} file to the ${outputMode === "fs" ? "" : "virtual "}file system (size: ${prettyBytes.prettyBytes(new buffer$1.Blob(toArray.toArray(code)).size)})`);
-    this.metadata[formattedPath] = {
+    if (!this.isDirectory(filePathFns.findFilePath(this.#normalizePath(path)))) {
+      this.mkdirSync(filePathFns.findFilePath(this.#normalizePath(path)), isPowerlinesWriteFileOptions(options) ? options : void 0);
+    }
+    const metadata = isVirtualFileData(data) ? data : {};
+    metadata.id = this.#normalizeId(path);
+    const code = isVirtualFileData(data) ? metadata.code : data;
+    const outputMode = this.#unifiedFS.resolveMode(this.#normalizePath(path), isPowerlinesWriteFileOptions(options) ? options : void 0);
+    this.#log(types.LogLevelLabel.TRACE, `Writing ${this.#normalizePath(path)} file to the ${outputMode === "fs" ? "" : "virtual "}file system (size: ${prettyBytes.prettyBytes(new buffer$1.Blob(toArray.toArray(code)).size)})`);
+    this.#metadata[metadata.id] = {
       mode: outputMode,
       variant: "normal",
       timestamp: Date.now(),
-      ...isVirtualFileData(data) ? data : {}
+      ...metadata
     };
-    this.#clearResolverCache(formattedPath);
-    const writeStream = this.#unifiedFS.resolveFS(formattedPath, isPowerlinesWriteFileOptions(options) ? options : void 0).createWriteStream(formattedPath);
+    this.#paths[metadata.id] = this.#normalizePath(path);
+    this.#ids[this.#normalizePath(path)] = metadata.id;
+    const writeStream = this.#unifiedFS.resolveFS(this.#normalizePath(path), isPowerlinesWriteFileOptions(options) ? options : void 0).createWriteStream(this.#normalizePath(path));
     try {
       writeStream.write(code);
     } finally {
@@ -1750,7 +1368,7 @@ var VirtualFileSystem = class _VirtualFileSystem {
   * @returns `true` if the file exists, otherwise `false`.
   */
   existsSync(pathOrId) {
-    return this.resolve(pathOrId) !== false;
+    return !!this.resolveSync(pathOrId);
   }
   /**
   * Retrieves the metadata of a file in the virtual file system (VFS).
@@ -1759,7 +1377,7 @@ var VirtualFileSystem = class _VirtualFileSystem {
   * @returns The metadata of the file, or undefined if the file does not exist.
   */
   getMetadata(pathOrId) {
-    const resolved = this.resolve(pathOrId);
+    const resolved = this.resolveSync(pathOrId);
     if (resolved && this.metadata[resolved]) {
       return this.metadata[resolved];
     }
@@ -1775,7 +1393,7 @@ var VirtualFileSystem = class _VirtualFileSystem {
   * @returns `true` if the file exists, otherwise `false`.
   */
   isFile(pathOrId) {
-    const resolved = this.resolve(pathOrId);
+    const resolved = this.resolveSync(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()));
   }
   /**
@@ -1785,7 +1403,7 @@ var VirtualFileSystem = class _VirtualFileSystem {
   * @returns `true` if the directory exists, otherwise `false`.
   */
   isDirectory(pathOrId) {
-    const resolved = this.resolve(pathOrId);
+    const resolved = this.resolveSync(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()));
   }
   /**
@@ -1795,7 +1413,7 @@ var VirtualFileSystem = class _VirtualFileSystem {
   * @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.#unifiedFS.resolveFS(pathOrId).promises.stat(this.resolve(toFilePath(pathOrId)) || toFilePath(pathOrId), options);
+    return this.#unifiedFS.resolveFS(pathOrId).promises.stat(await this.resolve(pathOrId) || pathOrId, options);
   }
   /**
   * Synchronously retrieves the status of a file in the virtual file system (VFS).
@@ -1804,7 +1422,7 @@ var VirtualFileSystem = class _VirtualFileSystem {
   * @returns The file's status information, or false if the file does not exist.
   */
   statSync(pathOrId) {
-    return this.#unifiedFS.resolveFS(pathOrId).statSync(this.resolve(toFilePath(pathOrId)) || toFilePath(pathOrId));
+    return this.#unifiedFS.resolveFS(pathOrId).statSync(this.resolveSync(pathOrId) || pathOrId);
   }
   /**
   * Retrieves the status of a symbolic link in the virtual file system (VFS).
@@ -1813,7 +1431,7 @@ var VirtualFileSystem = class _VirtualFileSystem {
   * @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.#unifiedFS.resolveFS(pathOrId).promises.lstat(this.resolve(toFilePath(pathOrId)) || toFilePath(pathOrId), options);
+    return this.#unifiedFS.resolveFS(pathOrId).promises.lstat(await this.resolve(pathOrId) || pathOrId, options);
   }
   /**
   * Synchronously retrieves the status of a symbolic link in the virtual file system (VFS).
@@ -1822,7 +1440,7 @@ var VirtualFileSystem = class _VirtualFileSystem {
   * @returns The symbolic link's status information, or false if the link does not exist.
   */
   lstatSync(pathOrId, options) {
-    return this.#unifiedFS.resolveFS(pathOrId).lstatSync(this.resolve(toFilePath(pathOrId)) || toFilePath(pathOrId), options);
+    return this.#unifiedFS.resolveFS(pathOrId).lstatSync(this.resolveSync(pathOrId) || pathOrId, options);
   }
   /**
   * Resolves a path or ID to its real path in the virtual file system (VFS).
@@ -1831,52 +1449,113 @@ var VirtualFileSystem = class _VirtualFileSystem {
   * @returns The resolved real path if it exists, otherwise undefined.
   */
   realpathSync(pathOrId) {
-    const filePath = this.resolve(toFilePath(pathOrId));
+    const filePath = this.resolveSync(pathOrId);
     if (!filePath) {
-      throw new Error(`File not found: ${toFilePath(pathOrId)}`);
+      throw new Error(`File not found: ${pathOrId}`);
     }
     return filePath;
   }
   /**
-  * Resolves a path or ID parameter to a corresponding virtual file path in the virtual file system (VFS).
+  * A helper function to resolve modules 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.
+  * @remarks
+  * This function can be used to resolve modules relative to the project root directory.
+  *
+  * @example
+  * ```ts
+  * const resolved = await context.resolvePath("some-module", "/path/to/importer");
+  * ```
+  *
+  * @param id - The module to resolve.
+  * @param importer - An optional path to the importer module.
+  * @param options - Additional resolution options.
+  * @returns A promise that resolves to the resolved module path.
   */
-  resolve(pathOrId, options = {}) {
-    const formattedPathOrId = toFilePath(pathOrId);
-    const resolverKey = `${formattedPathOrId}${options.withExtension ? "-ext" : ""}${options.paths ? `-${murmurhash.murmurhash(options.paths)}` : ""}${options.pathType ? `-${options.pathType}` : ""}`;
-    if (this.#cachedResolver.has(resolverKey)) {
-      return this.#cachedResolver.get(resolverKey);
-    }
-    let result = this.#resolveId(formattedPathOrId);
-    if (!result) {
-      result = this.#resolvePath(formattedPathOrId, options);
+  async resolve(id, importer, options = {}) {
+    let result = this.resolverCache.get(this.#normalizeId(id));
+    if (result) {
+      return result;
     }
+    result = this.paths[this.#normalizeId(id)];
     if (!result) {
-      result = false;
+      const paths = options.paths ?? [];
+      if (importer && !paths.includes(importer)) {
+        paths.push(importer);
+      }
+      paths.push(this.#context.workspaceConfig.workspaceRoot);
+      paths.push(joinPaths.joinPaths(this.#context.workspaceConfig.workspaceRoot, this.#context.config.projectRoot));
+      paths.push(joinPaths.joinPaths(this.#context.workspaceConfig.workspaceRoot, this.#context.config.sourceRoot));
+      paths.push(...Object.keys(this.#context.tsconfig.options.paths ?? {}).filter((tsconfigPath) => id.startsWith(tsconfigPath.replace(/\*$/, ""))).map((tsconfigPath) => this.#context.tsconfig.options.paths?.[tsconfigPath]).flat().filter(Boolean).map((tsconfigPath) => append.appendPath(tsconfigPath, this.#context.workspaceConfig.workspaceRoot)));
+      for (const combination of resolve.getResolutionCombinations(id, {
+        paths
+      })) {
+        if (this.#existsSync(combination)) {
+          result = combination;
+        }
+      }
+      try {
+        result = await resolve.resolve(id, {
+          paths
+        });
+      } catch {
+      }
     }
-    if (result && options.withExtension === false) {
-      return result.replace(/\.[m|c]?[t|j]sx?$/, "");
+    if (result) {
+      result = correctPath.toAbsolutePath(append.appendPath(result, this.#context.config.projectRoot), this.#context.workspaceConfig.workspaceRoot);
+      this.resolverCache.set(this.#normalizeId(id), result);
     }
-    this.#cachedResolver.set(resolverKey, result);
     return result;
   }
   /**
-  * Converts a relative path to an absolute path based on the workspace and project root.
+  * A synchronous helper function to resolve modules using the Jiti resolver
   *
-  * @param path - The relative path to convert.
-  * @returns The absolute path.
+  * @remarks
+  * This function can be used to resolve modules relative to the project root directory.
+  *
+  * @example
+  * ```ts
+  * const resolvedPath = context.resolveSync("some-module", "/path/to/importer");
+  * ```
+  *
+  * @param id - The module to resolve.
+  * @param importer - An optional path to the importer module.
+  * @param options - Additional resolution options.
+  * @returns The resolved module path.
   */
-  formatPath(path) {
-    const formattedPath = toFilePath(path);
-    if (isType.isAbsolutePath(formattedPath) || formattedPath.startsWith(this.#context.workspaceConfig.workspaceRoot)) {
-      return formattedPath;
-    } else if (formattedPath.startsWith(this.#context.config.projectRoot)) {
-      return joinPaths.joinPaths(this.#context.workspaceConfig.workspaceRoot, formattedPath);
+  resolveSync(id, importer, options = {}) {
+    let result = this.resolverCache.get(this.#normalizeId(id));
+    if (result) {
+      return result;
     }
-    return formattedPath;
+    result = this.paths[this.#normalizeId(id)];
+    if (!result) {
+      const paths = options.paths ?? [];
+      if (importer && !paths.includes(importer)) {
+        paths.push(importer);
+      }
+      paths.push(this.#context.workspaceConfig.workspaceRoot);
+      paths.push(joinPaths.joinPaths(this.#context.workspaceConfig.workspaceRoot, this.#context.config.projectRoot));
+      paths.push(joinPaths.joinPaths(this.#context.workspaceConfig.workspaceRoot, this.#context.config.sourceRoot));
+      paths.push(...Object.keys(this.#context.tsconfig?.options?.paths ?? {}).filter((tsconfigPath) => id.startsWith(tsconfigPath.replace(/\*$/, ""))).map((tsconfigPath) => this.#context.tsconfig?.options?.paths?.[tsconfigPath]).flat().filter(Boolean).map((tsconfigPath) => append.appendPath(tsconfigPath, this.#context.workspaceConfig.workspaceRoot)));
+      for (const combination of resolve.getResolutionCombinations(id, {
+        paths
+      })) {
+        if (this.#existsSync(combination)) {
+          result = combination;
+        }
+      }
+      try {
+        result = resolve.resolveSync(id, {
+          paths
+        });
+      } catch {
+      }
+    }
+    if (result) {
+      result = correctPath.toAbsolutePath(append.appendPath(result, this.#context.config.projectRoot), this.#context.workspaceConfig.workspaceRoot);
+      this.resolverCache.set(this.#normalizeId(id), result);
+    }
+    return result;
   }
   /**
   * Disposes of the virtual file system (VFS) by saving its state to disk.
@@ -1885,7 +1564,7 @@ var VirtualFileSystem = class _VirtualFileSystem {
     if (!this.#isDisposed) {
       this.#isDisposed = true;
       this.#log(types.LogLevelLabel.DEBUG, "Disposing virtual file system...");
-      await this.unlink(joinPaths.joinPaths(this.#context.cachePath, "fs.bin"));
+      await this.unlink(joinPaths.joinPaths(this.#context.dataPath, "fs.bin"));
       const message = new $__namespace.Message();
       const fs2 = message.initRoot(FileSystem);
       const virtualFS = this.#unifiedFS.toJSON();
@@ -1894,7 +1573,7 @@ var VirtualFileSystem = class _VirtualFileSystem {
       virtualFiles.forEach(([path, code], index) => {
         const fd = files.get(index);
         fd.path = path;
-        fd.code = code;
+        fd.code = code || "";
       });
       const ids = fs2._initIds(Object.keys(this.ids).length);
       Object.entries(this.ids).forEach(([id, path], index) => {
@@ -1918,7 +1597,9 @@ var VirtualFileSystem = class _VirtualFileSystem {
           });
         }
       });
-      await buffer.writeFileBuffer(joinPaths.joinPaths(this.#context.cachePath, "fs.bin"), message.toArrayBuffer());
+      await buffer.writeFileBuffer(joinPaths.joinPaths(this.#context.dataPath, "fs.bin"), message.toArrayBuffer());
+      this.#resolverCache.save(true);
+      this.#log(types.LogLevelLabel.DEBUG, "Virtual file system disposed.");
     }
   }
   /**
@@ -1967,6 +1648,8 @@ var PowerlinesContext = class _PowerlinesContext {
   #envPaths;
   #fs;
   #tsconfig;
+  #program;
+  #resolvePatterns = [];
   #getConfigProps(config = {}) {
     return {
       variant: config.build?.variant,
@@ -2058,7 +1741,7 @@ var PowerlinesContext = class _PowerlinesContext {
   */
   get tsconfig() {
     if (!this.#tsconfig) {
-      this.#tsconfig = {
+      this.tsconfig = {
         tsconfigFilePath: this.config.tsconfig
       };
     }
@@ -2069,6 +1752,7 @@ var PowerlinesContext = class _PowerlinesContext {
   */
   set tsconfig(value) {
     this.#tsconfig = value;
+    this.#resolvePatterns = bundleRequire.tsconfigPathsToRegExp(value?.options?.paths ?? {});
   }
   /**
   * The virtual file system interface for the project
@@ -2193,6 +1877,106 @@ var PowerlinesContext = class _PowerlinesContext {
     return Object.values(this.fs.metadata).filter((meta) => meta && meta.type === "builtin").map((meta) => meta?.id).filter(Boolean);
   }
   /**
+  * The {@link Project} instance used for type reflection and module manipulation
+  *
+  * @see https://ts-morph.com/
+  *
+  * @remarks
+  * This instance is created lazily on first access.
+  */
+  get program() {
+    if (!this.#program) {
+      this.#program = chunkSAS5EPBD_cjs.createProgram(this, {
+        skipAddingFilesFromTsConfig: true
+      });
+    }
+    return this.#program;
+  }
+  /**
+  * A helper function to resolve modules in the Virtual File System
+  *
+  * @remarks
+  * This function can be used to resolve modules relative to the project root directory.
+  *
+  * @example
+  * ```ts
+  * const resolved = await context.resolve("some-module", "/path/to/importer");
+  * ```
+  *
+  * @param id - The module to resolve.
+  * @param importer - An optional path to the importer module.
+  * @param options - Additional resolution options.
+  * @returns A promise that resolves to the resolved module path.
+  */
+  async resolveId(id, importer, options = {}) {
+    if (this.fs.isVirtual(id)) {
+      const result = await this.fs.resolve(id, importer, options);
+      if (!result) {
+        return void 0;
+      }
+      return {
+        id: `\0${result}`,
+        external: this.config.projectType !== "application"
+      };
+    }
+    if (this.config.build.skipNodeModulesBundle) {
+      if (bundleRequire.match(id, this.#resolvePatterns) || bundleRequire.match(id, this.config.build.noExternal)) {
+        return void 0;
+      }
+      if (bundleRequire.match(id, this.config.build.external) || id.startsWith("node:")) {
+        return {
+          id,
+          external: true
+        };
+      }
+      if (!/^[A-Z]:[/\\]|^\.{0,2}\/|^\.{1,2}$/.test(id)) {
+        return {
+          id,
+          external: true
+        };
+      }
+    } else {
+      if (bundleRequire.match(id, this.config.build.noExternal)) {
+        return void 0;
+      }
+      if (bundleRequire.match(id, this.config.build.external) || id.startsWith("node:")) {
+        return {
+          id,
+          external: true
+        };
+      }
+    }
+    return void 0;
+  }
+  /**
+  * A helper function to load modules from the Virtual File System
+  *
+  * @remarks
+  * This function can be used to load modules relative to the project root directory.
+  *
+  * @example
+  * ```ts
+  * const module = await context.load("some-module", "/path/to/importer");
+  * ```
+  *
+  * @param id - The module to load.
+  * @returns A promise that resolves to the loaded module.
+  */
+  async load(id) {
+    const resolvedId = await this.fs.resolve(id);
+    if (!resolvedId) {
+      return void 0;
+    }
+    const code = await this.fs.readFile(resolvedId);
+    if (!code) {
+      return void 0;
+    }
+    return {
+      code,
+      map: null
+    };
+  }
+  /**
   * Get the builtin virtual files that exist in the Powerlines virtual file system
   */
   async getBuiltins() {
@@ -2529,6 +2313,24 @@ var PowerlinesContext = class _PowerlinesContext {
       ret.push(plugin);
       return ret;
     }, []);
+    if (this.config.tsconfig) {
+      this.config.tsconfig = chunkISBHXSDH_cjs.replacePathTokens(this, this.config.tsconfig);
+    }
+    if (this.config.output.dts) {
+      this.config.output.dts = chunkISBHXSDH_cjs.replacePathTokens(this, this.config.output.dts);
+    }
+    if (this.config.build.polyfill) {
+      this.config.build.polyfill = this.config.build.polyfill.map((polyfill) => chunkISBHXSDH_cjs.replacePathTokens(this, polyfill));
+    }
+    if (this.config.output.assets) {
+      this.config.output.assets = this.config.output.assets.map((asset) => ({
+        ...asset,
+        glob: chunkISBHXSDH_cjs.replacePathTokens(this, asset.glob),
+        ignore: asset.ignore ? asset.ignore.map((ignore) => chunkISBHXSDH_cjs.replacePathTokens(this, ignore)) : void 0,
+        input: chunkISBHXSDH_cjs.replacePathTokens(this, asset.input),
+        output: chunkISBHXSDH_cjs.replacePathTokens(this, asset.output)
+      }));
+    }
     this.#fs ??= await VirtualFileSystem.create(this);
   }
   mergeUserConfig(from = {}, into = this.config.userConfig ?? {}) {
@@ -2554,7 +2356,6 @@ var PowerlinesContext = class _PowerlinesContext {
 
 exports.PowerlinesContext = PowerlinesContext;
 exports.VirtualFileSystem = VirtualFileSystem;
-exports.__VFS_PATCH__ = __VFS_PATCH__;
 exports.__VFS_REVERT__ = __VFS_REVERT__;
 exports.addPluginHook = addPluginHook;
 exports.checkDedupe = checkDedupe;