powerlines 0.23.10 → 0.24.1

package/dist/lib/{chunk-XG4CC73V.js → chunk-KFWMKDJQ.js}

@@ -1,7 +1,8 @@
 import { CACHE_HASH_LENGTH, PROJECT_ROOT_HASH_LENGTH, getPrefixedProjectRootHash } from './chunk-FQLZZYYO.js';
+import { createProgram } from './chunk-YQ3ODCHV.js';
 import { loadWorkspaceConfig, loadUserConfigFile } from './chunk-XBM7FHNK.js';
 import { extendLog, createLog } from './chunk-ENRLU4UR.js';
-import { resolveEntriesSync, getUniqueEntries } from './chunk-XZFEHPYE.js';
+import { resolveEntriesSync, getUniqueEntries, replacePathTokens } from './chunk-XZFEHPYE.js';
 import { __name } from './chunk-SHUYVCID.js';
 import { LogLevelLabel } from '@storm-software/config-tools/types';
 import { toArray } from '@stryke/convert/to-array';
@@ -9,7 +10,7 @@ import { getEnvPaths } from '@stryke/env/get-env-paths';
 import { existsSync } from '@stryke/fs/exists';
 import { relativeToWorkspaceRoot } from '@stryke/fs/get-workspace-root';
 import { readJsonFile } from '@stryke/fs/json';
-import { resolvePackage } from '@stryke/fs/resolve';
+import { getResolutionCombinations, resolve, resolveSync, resolvePackage } from '@stryke/fs/resolve';
 import { hashDirectory } from '@stryke/hash/hash-files';
 import { murmurhash } from '@stryke/hash/murmurhash';
 import { getUnique } from '@stryke/helpers/get-unique';
@@ -25,6 +26,7 @@ import { isSetObject } from '@stryke/type-checks/is-set-object';
 import { isSetString } from '@stryke/type-checks/is-set-string';
 import { isString } from '@stryke/type-checks/is-string';
 import { uuid } from '@stryke/unique-id/uuid';
+import { tsconfigPathsToRegExp, match } from 'bundle-require';
 import defu2 from 'defu';
 import { joinPaths as joinPaths$1 } from '@stryke/path/join-paths';
 import { createJiti } from 'jiti';
@@ -33,9 +35,11 @@ import { isUndefined } from '@stryke/type-checks/is-undefined';
 import * as $ from '@stryke/capnp';
 import { bufferToString } from '@stryke/convert/buffer-to-string';
 import { readFileBuffer, readFileBufferSync, writeFileBuffer } from '@stryke/fs/buffer';
-import { findFileDotExtensionSafe, findFilePath } from '@stryke/path/file-path-fns';
+import { toAbsolutePath } from '@stryke/path/correct-path';
+import { findFilePath, findFileDotExtensionSafe } from '@stryke/path/file-path-fns';
 import { prettyBytes } from '@stryke/string-format/pretty-bytes';
 import { isBuffer } from '@stryke/type-checks/is-buffer';
+import { create } from 'flat-cache';
 import { Blob } from 'node:buffer';
 import _fs from 'node:fs';
 import { resolveConfig, format } from 'prettier';
@@ -232,187 +236,6 @@ var FileMetadata = class _FileMetadata extends $.Struct {
     return "FileMetadata_" + super.toString();
   }
 };
-var ChunkData = class extends $.Struct {
-  static {
-    __name(this, "ChunkData");
-  }
-  static _capnp = {
-    displayName: "ChunkData",
-    id: "84076f13b057f83a",
-    size: new $.ObjectSize(8, 4)
-  };
-  /**
-  * An additional name for the file.
-  *
-  */
-  get id() {
-    return $.utils.getText(0, this);
-  }
-  set id(value) {
-    $.utils.setText(0, value, this);
-  }
-  /**
-  * Files that are implicitly loaded after one of the specified files.
-  *
-  */
-  get name() {
-    return $.utils.getText(1, this);
-  }
-  set name(value) {
-    $.utils.setText(1, value, this);
-  }
-  _adoptImplicitlyLoadedAfterOneOf(value) {
-    $.utils.adopt(value, $.utils.getPointer(2, this));
-  }
-  _disownImplicitlyLoadedAfterOneOf() {
-    return $.utils.disown(this.implicitlyLoadedAfterOneOf);
-  }
-  /**
-  * The importer of the file.
-  *
-  */
-  get implicitlyLoadedAfterOneOf() {
-    return $.utils.getList(2, $.TextList, this);
-  }
-  _hasImplicitlyLoadedAfterOneOf() {
-    return !$.utils.isNull($.utils.getPointer(2, this));
-  }
-  _initImplicitlyLoadedAfterOneOf(length) {
-    return $.utils.initList(2, $.TextList, length, this);
-  }
-  set implicitlyLoadedAfterOneOf(value) {
-    $.utils.copyFrom(value, $.utils.getPointer(2, this));
-  }
-  /**
-  * The signature preservation mode for the file.
-  *
-  */
-  get importer() {
-    return $.utils.getText(3, this);
-  }
-  set importer(value) {
-    $.utils.setText(3, value, this);
-  }
-  get preserveSignature() {
-    return $.utils.getUint16(0, this);
-  }
-  set preserveSignature(value) {
-    $.utils.setUint16(0, value, this);
-  }
-  toString() {
-    return "ChunkData_" + super.toString();
-  }
-};
-var PrebuiltData = class extends $.Struct {
-  static {
-    __name(this, "PrebuiltData");
-  }
-  static _capnp = {
-    displayName: "PrebuiltData",
-    id: "c5b1a6ca696328ee",
-    size: new $.ObjectSize(0, 4)
-  };
-  /**
-  * An additional name for the file.
-  *
-  */
-  get id() {
-    return $.utils.getText(0, this);
-  }
-  set id(value) {
-    $.utils.setText(0, value, this);
-  }
-  /**
-  * The file exports.
-  *
-  */
-  get name() {
-    return $.utils.getText(1, this);
-  }
-  set name(value) {
-    $.utils.setText(1, value, this);
-  }
-  _adoptExports(value) {
-    $.utils.adopt(value, $.utils.getPointer(2, this));
-  }
-  _disownExports() {
-    return $.utils.disown(this.exports);
-  }
-  /**
-  * The source map for the file.
-  *
-  */
-  get exports() {
-    return $.utils.getList(2, $.TextList, this);
-  }
-  _hasExports() {
-    return !$.utils.isNull($.utils.getPointer(2, this));
-  }
-  _initExports(length) {
-    return $.utils.initList(2, $.TextList, length, this);
-  }
-  set exports(value) {
-    $.utils.copyFrom(value, $.utils.getPointer(2, this));
-  }
-  get map() {
-    return $.utils.getText(3, this);
-  }
-  set map(value) {
-    $.utils.setText(3, value, this);
-  }
-  toString() {
-    return "PrebuiltData_" + super.toString();
-  }
-};
-var AssetData = class extends $.Struct {
-  static {
-    __name(this, "AssetData");
-  }
-  static _capnp = {
-    displayName: "AssetData",
-    id: "da660c6c1fa4c830",
-    size: new $.ObjectSize(8, 3)
-  };
-  /**
-  * An additional name for the file.
-  *
-  */
-  get id() {
-    return $.utils.getText(0, this);
-  }
-  set id(value) {
-    $.utils.setText(0, value, this);
-  }
-  /**
-  * Indicates whether the file needs a code reference.
-  *
-  */
-  get name() {
-    return $.utils.getText(1, this);
-  }
-  set name(value) {
-    $.utils.setText(1, value, this);
-  }
-  /**
-  * The original file name before any transformations.
-  *
-  */
-  get needsCodeReference() {
-    return $.utils.getBit(0, this);
-  }
-  set needsCodeReference(value) {
-    $.utils.setBit(0, value, this);
-  }
-  get originalFileName() {
-    return $.utils.getText(2, this);
-  }
-  set originalFileName(value) {
-    $.utils.setText(2, value, this);
-  }
-  toString() {
-    return "AssetData_" + super.toString();
-  }
-};
 var FileId = class extends $.Struct {
   static {
     __name(this, "FileId");
@@ -478,14 +301,11 @@ var FileSystem = class _FileSystem extends $.Struct {
   static _capnp = {
     displayName: "FileSystem",
     id: "ae0c23d43e56abcf",
-    size: new $.ObjectSize(0, 6)
+    size: new $.ObjectSize(0, 3)
   };
   static _Ids;
   static _Files;
   static _Metadata;
-  static _Assets;
-  static _Chunks;
-  static _Prebuilt;
   _adoptIds(value) {
     $.utils.adopt(value, $.utils.getPointer(0, this));
   }
@@ -540,60 +360,6 @@ var FileSystem = class _FileSystem extends $.Struct {
   set metadata(value) {
     $.utils.copyFrom(value, $.utils.getPointer(2, this));
   }
-  _adoptAssets(value) {
-    $.utils.adopt(value, $.utils.getPointer(3, this));
-  }
-  _disownAssets() {
-    return $.utils.disown(this.assets);
-  }
-  get assets() {
-    return $.utils.getList(3, _FileSystem._Assets, this);
-  }
-  _hasAssets() {
-    return !$.utils.isNull($.utils.getPointer(3, this));
-  }
-  _initAssets(length) {
-    return $.utils.initList(3, _FileSystem._Assets, length, this);
-  }
-  set assets(value) {
-    $.utils.copyFrom(value, $.utils.getPointer(3, this));
-  }
-  _adoptChunks(value) {
-    $.utils.adopt(value, $.utils.getPointer(4, this));
-  }
-  _disownChunks() {
-    return $.utils.disown(this.chunks);
-  }
-  get chunks() {
-    return $.utils.getList(4, _FileSystem._Chunks, this);
-  }
-  _hasChunks() {
-    return !$.utils.isNull($.utils.getPointer(4, this));
-  }
-  _initChunks(length) {
-    return $.utils.initList(4, _FileSystem._Chunks, length, this);
-  }
-  set chunks(value) {
-    $.utils.copyFrom(value, $.utils.getPointer(4, this));
-  }
-  _adoptPrebuilt(value) {
-    $.utils.adopt(value, $.utils.getPointer(5, this));
-  }
-  _disownPrebuilt() {
-    return $.utils.disown(this.prebuilt);
-  }
-  get prebuilt() {
-    return $.utils.getList(5, _FileSystem._Prebuilt, this);
-  }
-  _hasPrebuilt() {
-    return !$.utils.isNull($.utils.getPointer(5, this));
-  }
-  _initPrebuilt(length) {
-    return $.utils.initList(5, _FileSystem._Prebuilt, length, this);
-  }
-  set prebuilt(value) {
-    $.utils.copyFrom(value, $.utils.getPointer(5, this));
-  }
   toString() {
     return "FileSystem_" + super.toString();
   }
@@ -602,9 +368,6 @@ FileMetadata._Properties = $.CompositeList(FileMetadata_KeyValuePair);
 FileSystem._Ids = $.CompositeList(FileId);
 FileSystem._Files = $.CompositeList(FileData);
 FileSystem._Metadata = $.CompositeList(FileMetadata);
-FileSystem._Assets = $.CompositeList(AssetData);
-FileSystem._Chunks = $.CompositeList(ChunkData);
-FileSystem._Prebuilt = $.CompositeList(PrebuiltData);
 
 // src/types/fs.ts
 var __VFS_PATCH__ = "__VFS_PATCH__";
@@ -614,13 +377,9 @@ function isBufferEncoding(options) {
 }
 __name(isBufferEncoding, "isBufferEncoding");
 function isPowerlinesWriteFileOptions(options) {
-  return !isBufferEncoding(options) && isSetObject(options) && ("skipFormat" in options || "mode" in options && (options.mode === "fs" || options.mode === "virtual"));
+  return !isBufferEncoding(options) && isSetObject(options) && "mode" in options && (options.mode === "fs" || options.mode === "virtual");
 }
 __name(isPowerlinesWriteFileOptions, "isPowerlinesWriteFileOptions");
-function isNodeWriteFileOptions(options) {
-  return !isUndefined(options) && (isBufferEncoding(options) || !isPowerlinesWriteFileOptions(options));
-}
-__name(isNodeWriteFileOptions, "isNodeWriteFileOptions");
 function isVirtualFileData(obj) {
   return !!(isSetObject(obj) && "code" in obj && obj.code);
 }
@@ -757,6 +516,18 @@ function patchFS(originalFS, vfs) {
   };
 }
 __name(patchFS, "patchFS");
+function isValidId(id, prefix = "powerlines") {
+  return id.replace(/^\\0/, "").startsWith(`${prefix.replace(/:$/, "")}`);
+}
+__name(isValidId, "isValidId");
+function normalizeId(id, prefix = "powerlines") {
+  return `${prefix.replace(/:$/, "")}:${toFilePath(id).replace(new RegExp(`^${prefix.replace(/:$/, "")}:`), "").replace(/^\\0/, "").replace(findFileDotExtensionSafe(toFilePath(id)), "")}`;
+}
+__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);
+}
+__name(normalizePath, "normalizePath");
 var UnifiedFS = class _UnifiedFS extends Union {
   static {
     __name(this, "UnifiedFS");
@@ -933,9 +704,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.
   *
@@ -970,189 +741,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(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$1(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$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 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$1(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$1(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.
@@ -1161,8 +778,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 && existsSync(joinPaths$1(context.cachePath, "fs.bin"))) {
-      const buffer = await readFileBuffer(joinPaths$1(context.cachePath, "fs.bin"));
+    if (!context.config.skipCache && existsSync(joinPaths$1(context.dataPath, "fs.bin"))) {
+      const buffer = await readFileBuffer(joinPaths$1(context.dataPath, "fs.bin"));
       const message2 = new $.Message(buffer, false);
       return new _VirtualFileSystem(context, message2.getRoot(FileSystem));
     }
@@ -1176,8 +793,8 @@ var VirtualFileSystem = class _VirtualFileSystem {
   * @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"));
+    if (!context.config.skipCache && existsSync(joinPaths$1(context.dataPath, "fs.bin"))) {
+      const buffer = readFileBufferSync(joinPaths$1(context.dataPath, "fs.bin"));
       const message2 = new $.Message(buffer, false);
       return new _VirtualFileSystem(context, message2.getRoot(FileSystem));
     }
@@ -1188,19 +805,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__ */ __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__ */ __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__ */ __name((target, prop) => {
+        return target[this.#normalizeId(prop)];
+      }, "get")
+    });
+  }
+  get resolverCache() {
+    if (!this.#resolverCache) {
+      this.#resolverCache = 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}.
@@ -1245,17 +886,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;
     }
@@ -1265,17 +902,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;
     }
@@ -1297,16 +930,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(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(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).
@@ -1314,19 +948,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(LogLevelLabel.TRACE, `Removing file: ${formattedPath}`);
+    this.#log(LogLevelLabel.TRACE, `Removing file: ${this.#normalizePath(path)}`);
     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]];
+      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);
     }
   }
   /**
@@ -1336,15 +968,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(LogLevelLabel.TRACE, `Synchronously removing directory: ${formattedPath}`);
-    this.#unifiedFS.resolveFS(path, options).rmdirSync(formattedPath, defu2(options, {
+    this.#log(LogLevelLabel.TRACE, `Synchronously removing directory: ${this.#normalizePath(path)}`);
+    this.#unifiedFS.resolveFS(path, options).rmdirSync(this.#normalizePath(path), defu2(options, {
       recursive: true
     }));
-    this.#clearResolverCache(formattedPath);
   }
   /**
   * Removes a directory in the virtual file system (VFS).
@@ -1354,19 +984,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(LogLevelLabel.TRACE, `Removing directory: ${formattedPath}`);
+    this.#log(LogLevelLabel.TRACE, `Removing directory: ${this.#normalizePath(path)}`);
     if (isFunction(this.#unifiedFS.resolveFS(path, options).promises.rm)) {
-      await this.#unifiedFS.resolveFS(path, options).promises.rm(formattedPath, defu2(options, {
+      await this.#unifiedFS.resolveFS(path, options).promises.rm(this.#normalizePath(path), defu2(options, {
         force: true,
         recursive: true
       }));
-      this.#clearResolverCache(formattedPath);
     } else {
-      this.rmdirSync(formattedPath, defu2(options ?? {}, {
+      this.rmdirSync(this.#normalizePath(path), defu2(options ?? {}, {
         force: true,
         recursive: true
       }));
@@ -1380,11 +1008,11 @@ var VirtualFileSystem = class _VirtualFileSystem {
   * @returns A promise that resolves when the file is removed.
   */
   async rm(path, options = {}) {
-    this.#log(LogLevelLabel.TRACE, `Removing: ${toFilePath(path)}`);
-    if (this.isDirectory(path)) {
-      return this.rmdir(path, options);
+    this.#log(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).
@@ -1393,11 +1021,11 @@ var VirtualFileSystem = class _VirtualFileSystem {
   * @param options - Options for removing the file or directory.
   */
   rmSync(path, options = {}) {
-    this.#log(LogLevelLabel.TRACE, `Removing: ${toFilePath(path)}`);
-    if (this.isDirectory(path)) {
-      return this.rmdirSync(path, options);
+    this.#log(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).
@@ -1407,9 +1035,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(options ?? {}, {
+    return this.#unifiedFS.resolveFS(this.#normalizePath(path), options).mkdirSync(this.#normalizePath(path), defu2(omit(options, [
+      "mode"
+    ]), {
       recursive: true
     }));
   }
@@ -1422,17 +1050,19 @@ var VirtualFileSystem = class _VirtualFileSystem {
   */
   async mkdir(path, options = {}) {
     let result;
-    const filePath = toFilePath(path);
-    if (isFunction(this.#unifiedFS.resolveFS(filePath, options).promises.mkdir)) {
-      result = await this.#unifiedFS.resolveFS(filePath, options).promises.mkdir(filePath, defu2(options ?? {}, {
+    if (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(omit(options, [
+        "mode"
+      ]), {
         recursive: true
       }));
     } else {
-      result = this.#unifiedFS.resolveFS(filePath, options).mkdirSync(filePath, defu2(options ?? {}, {
+      result = this.#unifiedFS.resolveFS(this.#normalizePath(path), options).mkdirSync(this.#normalizePath(path), defu2(omit(options, [
+        "mode"
+      ]), {
         recursive: true
       }));
     }
-    this.#clearResolverCache(filePath);
     return result;
   }
   /**
@@ -1444,17 +1074,15 @@ var VirtualFileSystem = class _VirtualFileSystem {
   async glob(patterns) {
     const results = [];
     for (const pattern of 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 = isAbsolutePath(normalized) ? normalized : this.formatPath(joinPaths$1(this.#context.workspaceConfig.workspaceRoot, normalized));
+      const absPattern = isAbsolutePath(normalized) ? normalized : this.#normalizePath(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 = [
@@ -1469,7 +1097,7 @@ var VirtualFileSystem = class _VirtualFileSystem {
           continue;
         }
         for (const entry of entries) {
-          const full = this.formatPath(joinPaths$1(dir, entry));
+          const full = this.#normalizePath(joinPaths$1(dir, entry));
           let stats;
           try {
             stats = this.#unifiedFS.lstatSync(full);
@@ -1481,9 +1109,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);
               }
@@ -1503,17 +1129,15 @@ var VirtualFileSystem = class _VirtualFileSystem {
   globSync(patterns) {
     const results = [];
     for (const pattern of 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 = isAbsolutePath(normalized) ? normalized : this.formatPath(joinPaths$1(this.#context.workspaceConfig.workspaceRoot, normalized));
+      const absPattern = isAbsolutePath(normalized) ? normalized : this.#normalizePath(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 = [
@@ -1528,7 +1152,7 @@ var VirtualFileSystem = class _VirtualFileSystem {
           continue;
         }
         for (const entry of entries) {
-          const full = this.formatPath(joinPaths$1(dir, entry));
+          const full = this.#normalizePath(joinPaths$1(dir, entry));
           let stats;
           try {
             stats = this.#unifiedFS.lstatSync(full);
@@ -1540,9 +1164,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);
               }
@@ -1612,21 +1234,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(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(result) ? bufferToString(result) : result;
-      return content;
+      return isBuffer(result) ? bufferToString(result) : result;
     }
     return void 0;
   }
@@ -1637,16 +1253,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(result) ? bufferToString(result) : result;
-      return content;
+      return isBuffer(result) ? bufferToString(result) : result;
     }
     return void 0;
   }
@@ -1659,34 +1269,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(findFilePath(formattedPath))) {
-      await this.mkdir(findFilePath(formattedPath), isPowerlinesWriteFileOptions(options) ? options : void 0);
+    if (!this.isDirectory(findFilePath(this.#normalizePath(path)))) {
+      await this.mkdir(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(code)) {
-      const resolvedConfig = await resolveConfig(formattedPath);
+      const resolvedConfig = await resolveConfig(this.#normalizePath(path));
       if (resolvedConfig) {
         code = await format(code, {
-          absolutePath: formattedPath,
+          absolutePath: this.#normalizePath(path),
           ...resolvedConfig
         });
       }
     }
-    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.metadata[formattedPath] = {
+    const outputMode = this.#unifiedFS.resolveMode(this.#normalizePath(path), isPowerlinesWriteFileOptions(options) ? options : void 0);
+    this.#log(LogLevelLabel.TRACE, `Writing ${this.#normalizePath(path)} file to the ${outputMode === "fs" ? "" : "virtual "}file system (size: ${prettyBytes(new Blob(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(ifs.promises.writeFile)) {
-      return ifs.promises.writeFile(formattedPath, code, isNodeWriteFileOptions(options) ? options : "utf8");
+      return ifs.promises.writeFile(this.#normalizePath(path), code, isSetObject(options) ? omit(options, [
+        "mode"
+      ]) : "utf8");
     }
-    return ifs.writeFileSync(formattedPath, code, isNodeWriteFileOptions(options) ? options : "utf8");
+    return ifs.writeFileSync(this.#normalizePath(path), code, isSetObject(options) ? omit(options, [
+      "mode"
+    ]) : "utf8");
   }
   /**
   * Synchronously writes a file to the virtual file system (VFS).
@@ -1696,21 +1312,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(findFilePath(formattedPath))) {
-      this.mkdirSync(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(LogLevelLabel.TRACE, `Writing ${formattedPath} file to the ${outputMode === "fs" ? "" : "virtual "}file system (size: ${prettyBytes(new Blob(toArray(code)).size)})`);
-    this.metadata[formattedPath] = {
+    if (!this.isDirectory(findFilePath(this.#normalizePath(path)))) {
+      this.mkdirSync(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(LogLevelLabel.TRACE, `Writing ${this.#normalizePath(path)} file to the ${outputMode === "fs" ? "" : "virtual "}file system (size: ${prettyBytes(new Blob(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 {
@@ -1724,7 +1342,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).
@@ -1733,7 +1351,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];
     }
@@ -1749,7 +1367,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()));
   }
   /**
@@ -1759,7 +1377,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()));
   }
   /**
@@ -1769,7 +1387,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).
@@ -1778,7 +1396,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).
@@ -1787,7 +1405,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).
@@ -1796,7 +1414,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).
@@ -1805,52 +1423,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(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$1(this.#context.workspaceConfig.workspaceRoot, this.#context.config.projectRoot));
+      paths.push(joinPaths$1(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) => appendPath(tsconfigPath, this.#context.workspaceConfig.workspaceRoot)));
+      for (const combination of getResolutionCombinations(id, {
+        paths
+      })) {
+        if (this.#existsSync(combination)) {
+          result = combination;
+        }
+      }
+      try {
+        result = await resolve(id, {
+          paths
+        });
+      } catch {
+      }
     }
-    if (result && options.withExtension === false) {
-      return result.replace(/\.[m|c]?[t|j]sx?$/, "");
+    if (result) {
+      result = toAbsolutePath(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 (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);
+  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$1(this.#context.workspaceConfig.workspaceRoot, this.#context.config.projectRoot));
+      paths.push(joinPaths$1(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) => appendPath(tsconfigPath, this.#context.workspaceConfig.workspaceRoot)));
+      for (const combination of getResolutionCombinations(id, {
+        paths
+      })) {
+        if (this.#existsSync(combination)) {
+          result = combination;
+        }
+      }
+      try {
+        result = resolveSync(id, {
+          paths
+        });
+      } catch {
+      }
+    }
+    if (result) {
+      result = toAbsolutePath(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.
@@ -1859,7 +1538,7 @@ var VirtualFileSystem = class _VirtualFileSystem {
     if (!this.#isDisposed) {
       this.#isDisposed = true;
       this.#log(LogLevelLabel.DEBUG, "Disposing virtual file system...");
-      await this.unlink(joinPaths$1(this.#context.cachePath, "fs.bin"));
+      await this.unlink(joinPaths$1(this.#context.dataPath, "fs.bin"));
       const message = new $.Message();
       const fs2 = message.initRoot(FileSystem);
       const virtualFS = this.#unifiedFS.toJSON();
@@ -1868,7 +1547,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) => {
@@ -1892,7 +1571,9 @@ var VirtualFileSystem = class _VirtualFileSystem {
           });
         }
       });
-      await writeFileBuffer(joinPaths$1(this.#context.cachePath, "fs.bin"), message.toArrayBuffer());
+      await writeFileBuffer(joinPaths$1(this.#context.dataPath, "fs.bin"), message.toArrayBuffer());
+      this.#resolverCache.save(true);
+      this.#log(LogLevelLabel.DEBUG, "Virtual file system disposed.");
     }
   }
   /**
@@ -1941,6 +1622,8 @@ var PowerlinesContext = class _PowerlinesContext {
   #envPaths;
   #fs;
   #tsconfig;
+  #program;
+  #resolvePatterns = [];
   #getConfigProps(config = {}) {
     return {
       variant: config.build?.variant,
@@ -2032,7 +1715,7 @@ var PowerlinesContext = class _PowerlinesContext {
   */
   get tsconfig() {
     if (!this.#tsconfig) {
-      this.#tsconfig = {
+      this.tsconfig = {
         tsconfigFilePath: this.config.tsconfig
       };
     }
@@ -2043,6 +1726,7 @@ var PowerlinesContext = class _PowerlinesContext {
   */
   set tsconfig(value) {
     this.#tsconfig = value;
+    this.#resolvePatterns = tsconfigPathsToRegExp(value?.options?.paths ?? {});
   }
   /**
   * The virtual file system interface for the project
@@ -2167,6 +1851,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 = 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 (match(id, this.#resolvePatterns) || match(id, this.config.build.noExternal)) {
+        return void 0;
+      }
+      if (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 (match(id, this.config.build.noExternal)) {
+        return void 0;
+      }
+      if (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() {
@@ -2503,6 +2287,24 @@ var PowerlinesContext = class _PowerlinesContext {
       ret.push(plugin);
       return ret;
     }, []);
+    if (this.config.tsconfig) {
+      this.config.tsconfig = replacePathTokens(this, this.config.tsconfig);
+    }
+    if (this.config.output.dts) {
+      this.config.output.dts = replacePathTokens(this, this.config.output.dts);
+    }
+    if (this.config.build.polyfill) {
+      this.config.build.polyfill = this.config.build.polyfill.map((polyfill) => replacePathTokens(this, polyfill));
+    }
+    if (this.config.output.assets) {
+      this.config.output.assets = this.config.output.assets.map((asset) => ({
+        ...asset,
+        glob: replacePathTokens(this, asset.glob),
+        ignore: asset.ignore ? asset.ignore.map((ignore) => replacePathTokens(this, ignore)) : void 0,
+        input: replacePathTokens(this, asset.input),
+        output: replacePathTokens(this, asset.output)
+      }));
+    }
     this.#fs ??= await VirtualFileSystem.create(this);
   }
   mergeUserConfig(from = {}, into = this.config.userConfig ?? {}) {
@@ -2526,4 +2328,4 @@ var PowerlinesContext = class _PowerlinesContext {
   }
 };
 
-export { PowerlinesContext, VirtualFileSystem, __VFS_PATCH__, __VFS_REVERT__, addPluginHook, checkDedupe, getHookHandler, isHookExternal, isPlugin, isPluginConfig, isPluginConfigObject, isPluginConfigTuple, isPluginHook };
+export { PowerlinesContext, VirtualFileSystem, __VFS_REVERT__, addPluginHook, checkDedupe, getHookHandler, isHookExternal, isPlugin, isPluginConfig, isPluginConfigObject, isPluginConfigTuple, isPluginHook };