powerlines 0.23.10 → 0.24.0

package/dist/lib/index.d.cts

@@ -4,22 +4,22 @@ export { PowerlinesContext } from './contexts/context.cjs';
 export { PowerlinesEnvironmentContext } from './contexts/environment-context.cjs';
 export { createPluginContext } from './contexts/plugin-context.cjs';
 export { getUniqueEntries, resolveEntries, resolveEntriesSync, resolveEntry, resolveEntryInput, resolveEntryInputFile, resolveEntryOutput, resolveVirtualEntry } from './entry.cjs';
-import fs, { PathLike, ObjectEncodingOptions, PathOrFileDescriptor, Stats, StatSyncOptions } from 'node:fs';
-import { V as VirtualFileSystemInterface, C as Context, a as VirtualFileMetadata, R as ResolvePathOptions, b as ResolveFSOptions, M as MakeDirectoryOptions, W as WriteFileData, c as WriteFileOptions, _ as __VFS_PATCH__, d as __VFS_REVERT__ } from './config-BnJpgcGr.cjs';
+import { FlatCache } from 'flat-cache';
+import fs, { ObjectEncodingOptions, Stats, StatSyncOptions } from 'node:fs';
+import { V as VirtualFileSystemInterface, C as Context, a as VirtualFileMetadata, R as ResolveOptions, b as ResolveFSOptions, M as MakeDirectoryOptions, W as WriteFileData, c as WriteFileOptions, _ as __VFS_PATCH__, d as __VFS_REVERT__ } from './config-D8KrE7SZ.cjs';
 export { CreateLogOptions, __ΩCreateLogOptions, createLog, extendLog } from './logger.cjs';
 export { IsolatedDeclarationsResult, __ΩIsolatedDeclarationsResult, isolatedDeclarations } from './typescript/isolated-decl.cjs';
 export { SourcesMap, __ΩSourcesMap, createVirtualCompilerHost, createVirtualProgram, getDefaultCompilerOptions, loadLibFiles } from './typescript/program.cjs';
 export { createProgram } from './typescript/ts-morph.cjs';
 export { findIncludeMatch, findMatch, getParsedTypeScriptConfig, getTsconfigFilePath, isIncludeMatchFound, isMatchFound } from './typescript/tsconfig.cjs';
 export { createUnpluginFactory } from './unplugin/factory.cjs';
+export { combineContexts } from './unplugin/helpers.cjs';
 export { CreateUnpluginOptions, __ΩCreateUnpluginOptions, createUnplugin } from './unplugin/plugin.cjs';
-export { ResolveIdArgs, ResolveIdOptions, __ΩResolveIdArgs, __ΩResolveIdOptions, handleResolveId } from './unplugin/resolve-id.cjs';
 export { bundle } from './utilities/bundle.cjs';
 export { getCache, setCache } from './utilities/cache.cjs';
 export { FileHeaderOptions, __ΩFileHeaderOptions, getBaseFileHeader, getFileHeader } from './utilities/file-header.cjs';
 export { CACHE_HASH_LENGTH, CreateContextOptions, PROJECT_ROOT_HASH_LENGTH, __ΩCreateContextOptions, discoverTemplates, getPersistedMeta, getPrefixedProjectRootHash, writeMetaFile } from './utilities/meta.cjs';
 export { resolve } from './utilities/resolve.cjs';
-export { resolvePath } from './utilities/resolve-path.cjs';
 export { getMagicString, getSourceFile, getString } from './utilities/source-file.cjs';
 export { generateSourceMap } from './utilities/source-map.cjs';
 export { Worker, WorkerOptions, __ΩWorkerOptions, createWorker } from './utilities/worker.cjs';
@@ -28,9 +28,10 @@ import 'jiti';
 import '@stryke/env/get-env-paths';
 import '@stryke/types/package-json';
 import 'semver';
+import 'ts-morph';
 import 'unplugin';
-import './internal-BeR8fOB1.cjs';
-import './api-Cm51oVbC.cjs';
+import './internal-CaGANOWK.cjs';
+import './api-BRMITKt-.cjs';
 import './tsconfig-Bz-CiFqD.cjs';
 import '@stryke/types/tsconfig';
 import 'typescript';
@@ -52,9 +53,9 @@ import 'rollup';
 import 'webpack';
 import 'jest-worker';
 import 'magic-string';
+import '@stryke/fs/resolve';
 import '@stryke/types/array';
-import 'ts-morph';
-import './unplugin-ppAOzR__.cjs';
+import './unplugin-bUSyjd0S.cjs';
 
 /**
  * Represents a virtual file system (VFS) that stores files and their associated metadata in virtual memory.
@@ -81,15 +82,16 @@ declare class VirtualFileSystem implements VirtualFileSystemInterface {
     /**
      * A map of file ids to their metadata.
      */
-    get metadata(): Record<string, VirtualFileMetadata>;
+    get metadata(): Readonly<Record<string, VirtualFileMetadata>>;
     /**
-     * A map of module ids to their file paths.
+     * A map of file paths to their module ids.
      */
-    get ids(): Record<string, string>;
+    get ids(): Readonly<Record<string, string>>;
     /**
-     * A map of virtual file paths to their IDs.
+     * A map of module ids to their file paths.
      */
-    get paths(): Record<string, string>;
+    get paths(): Readonly<Record<string, string>>;
+    protected get resolverCache(): FlatCache;
     /**
      * Creates a new instance of the {@link VirtualFileSystem}.
      *
@@ -101,18 +103,16 @@ declare class VirtualFileSystem implements VirtualFileSystemInterface {
      * Check if a path or id corresponds to a virtual file **(does not actually exists on disk)**.
      *
      * @param pathOrId - The path or id to check.
-     * @param options - Optional parameters for resolving the path.
      * @returns Whether the path or id corresponds to a virtual file **(does not actually exists on disk)**.
      */
-    isVirtual(pathOrId: string, options?: ResolvePathOptions): boolean;
+    isVirtual(pathOrId: string, importer?: string, options?: ResolveOptions): boolean;
     /**
      * Check if a path or id corresponds to a file written to the file system **(actually exists on disk)**.
      *
      * @param pathOrId - The path or id to check.
-     * @param options - Optional parameters for resolving the path.
      * @returns Whether the path or id corresponds to a file written to the file system **(actually exists on disk)**.
      */
-    isPhysical(pathOrId: string, options?: ResolvePathOptions): boolean;
+    isPhysical(pathOrId: string, importer?: string, options?: ResolveOptions): boolean;
     /**
      * Lists files in a given path.
      *
@@ -130,20 +130,20 @@ declare class VirtualFileSystem implements VirtualFileSystemInterface {
      *
      * @param path - The path to create the directory at.
      */
-    unlinkSync(path: fs.PathLike, options?: ResolveFSOptions): void;
+    unlinkSync(path: string, options?: ResolveFSOptions): void;
     /**
      * Removes a file in the virtual file system (VFS).
      *
      * @param path - The path to create the directory at.
      */
-    unlink(path: fs.PathLike, options?: ResolveFSOptions): Promise<void>;
+    unlink(path: string, options?: ResolveFSOptions): Promise<void>;
     /**
      * Removes a directory in the virtual file system (VFS).
      *
      * @param path - The path to create the directory at.
      * @param options - Options for creating the directory.
      */
-    rmdirSync(path: fs.PathLike, options?: fs.RmDirOptions & ResolveFSOptions): void;
+    rmdirSync(path: string, options?: fs.RmDirOptions & ResolveFSOptions): void;
     /**
      * Removes a directory in the virtual file system (VFS).
      *
@@ -151,7 +151,7 @@ declare class VirtualFileSystem implements VirtualFileSystemInterface {
      * @param options - Options for creating the directory.
      * @returns A promise that resolves to the path of the created directory, or undefined if the directory could not be created.
      */
-    rmdir(path: fs.PathLike, options?: fs.RmDirOptions & ResolveFSOptions): Promise<void>;
+    rmdir(path: string, options?: fs.RmDirOptions & ResolveFSOptions): Promise<void>;
     /**
      * Removes a file in the virtual file system (VFS).
      *
@@ -159,14 +159,14 @@ declare class VirtualFileSystem implements VirtualFileSystemInterface {
      * @param options - Options for removing the file.
      * @returns A promise that resolves when the file is removed.
      */
-    rm(path: fs.PathLike, options?: fs.RmOptions & ResolveFSOptions): Promise<void>;
+    rm(path: string, options?: fs.RmOptions & ResolveFSOptions): Promise<void>;
     /**
      * Synchronously removes a file or directory in the virtual file system (VFS).
      *
      * @param path - The path to the file or directory to remove.
      * @param options - Options for removing the file or directory.
      */
-    rmSync(path: fs.PathLike, options?: fs.RmOptions & ResolveFSOptions): void;
+    rmSync(path: string, options?: fs.RmOptions & ResolveFSOptions): void;
     /**
      * Creates a directory in the virtual file system (VFS).
      *
@@ -174,7 +174,7 @@ declare class VirtualFileSystem implements VirtualFileSystemInterface {
      * @param options - Options for creating the directory.
      * @returns A promise that resolves to the path of the created directory, or undefined if the directory could not be created.
      */
-    mkdirSync(path: fs.PathLike, options?: MakeDirectoryOptions): string | undefined;
+    mkdirSync(path: string, options?: MakeDirectoryOptions): string | undefined;
     /**
      * Creates a directory in the virtual file system (VFS).
      *
@@ -182,7 +182,7 @@ declare class VirtualFileSystem implements VirtualFileSystemInterface {
      * @param options - Options for creating the directory.
      * @returns A promise that resolves to the path of the created directory, or undefined if the directory could not be created.
      */
-    mkdir(path: fs.PathLike, options?: MakeDirectoryOptions): Promise<string | undefined>;
+    mkdir(path: string, options?: MakeDirectoryOptions): Promise<string | undefined>;
     /**
      * Glob files in the virtual file system (VFS) based on the provided pattern(s).
      *
@@ -232,7 +232,7 @@ declare class VirtualFileSystem implements VirtualFileSystemInterface {
      * @param options - Options for listing files, such as encoding and recursion.
      * @returns An array of file names in the specified path.
      */
-    readdir(pathOrId: PathLike, options?: {
+    readdir(pathOrId: string, options?: {
         encoding: BufferEncoding | null;
         withFileTypes?: false | undefined;
         recursive?: boolean | undefined;
@@ -243,7 +243,7 @@ declare class VirtualFileSystem implements VirtualFileSystemInterface {
      * @param pathOrId - The path or ID of the file to read.
      * @returns A promise that resolves to the contents of the file as a string, or undefined if the file does not exist.
      */
-    readFile(pathOrId: PathLike, options?: (ObjectEncodingOptions & {
+    readFile(pathOrId: string, options?: (ObjectEncodingOptions & {
         flag?: string | undefined;
     }) | BufferEncoding): Promise<string | undefined>;
     /**
@@ -252,7 +252,7 @@ declare class VirtualFileSystem implements VirtualFileSystemInterface {
      * @param pathOrId - The path or ID of the file to read.
      * @returns The contents of the file as a string, or undefined if the file does not exist.
      */
-    readFileSync(pathOrId: PathLike, options?: (fs.ObjectEncodingOptions & {
+    readFileSync(pathOrId: string, options?: (fs.ObjectEncodingOptions & {
         flag?: string | undefined;
     }) | BufferEncoding | null): string | undefined;
     /**
@@ -263,7 +263,7 @@ declare class VirtualFileSystem implements VirtualFileSystemInterface {
      * @param options - Optional parameters for writing the file.
      * @returns A promise that resolves when the file is written.
      */
-    writeFile(path: PathOrFileDescriptor, data?: WriteFileData, options?: WriteFileOptions): Promise<void>;
+    writeFile(path: string, data?: WriteFileData, options?: WriteFileOptions): Promise<void>;
     /**
      * Synchronously writes a file to the virtual file system (VFS).
      *
@@ -271,21 +271,21 @@ declare class VirtualFileSystem implements VirtualFileSystemInterface {
      * @param data - The contents of the file.
      * @param options - Optional parameters for writing the file.
      */
-    writeFileSync(path: PathOrFileDescriptor, data?: WriteFileData, options?: WriteFileOptions): void;
+    writeFileSync(path: string, data?: WriteFileData, options?: WriteFileOptions): void;
     /**
      * Synchronously checks if a file exists in the virtual file system (VFS).
      *
      * @param pathOrId - The path or ID of the file to check.
      * @returns `true` if the file exists, otherwise `false`.
      */
-    existsSync(pathOrId: PathLike): boolean;
+    existsSync(pathOrId: string): boolean;
     /**
      * Retrieves the metadata of a file in the virtual file system (VFS).
      *
      * @param pathOrId - The path or ID of the file to retrieve metadata for.
      * @returns The metadata of the file, or undefined if the file does not exist.
      */
-    getMetadata(pathOrId: PathLike): VirtualFileMetadata | undefined;
+    getMetadata(pathOrId: string): VirtualFileMetadata | undefined;
     /**
      * Checks if a file exists in the virtual file system (VFS).
      *
@@ -295,21 +295,21 @@ declare class VirtualFileSystem implements VirtualFileSystemInterface {
      * @param pathOrId - The path of the file to check.
      * @returns `true` if the file exists, otherwise `false`.
      */
-    isFile(pathOrId: PathLike): boolean;
+    isFile(pathOrId: string): boolean;
     /**
      * Checks if a directory exists in the virtual file system (VFS).
      *
      * @param pathOrId - The path of the directory to check.
      * @returns `true` if the directory exists, otherwise `false`.
      */
-    isDirectory(pathOrId: PathLike): boolean;
+    isDirectory(pathOrId: string): boolean;
     /**
      * Retrieves the status of a file in the virtual file system (VFS).
      *
      * @param pathOrId - The path or ID of the file to retrieve status for.
      * @returns A promise that resolves to the file's status information, or false if the file does not exist.
      */
-    stat(pathOrId: PathLike, options?: fs.StatOptions & {
+    stat(pathOrId: string, options?: fs.StatOptions & {
         bigint?: false | undefined;
     }): Promise<Stats>;
     /**
@@ -318,14 +318,14 @@ declare class VirtualFileSystem implements VirtualFileSystemInterface {
      * @param pathOrId - The path or ID of the file to retrieve status for.
      * @returns The file's status information, or false if the file does not exist.
      */
-    statSync(pathOrId: PathLike): Stats;
+    statSync(pathOrId: string): Stats;
     /**
      * Retrieves the status of a symbolic link in the virtual file system (VFS).
      *
      * @param pathOrId - The path or ID of the symbolic link to retrieve status for.
      * @returns A promise that resolves to the symbolic link's status information, or false if the link does not exist.
      */
-    lstat(pathOrId: PathLike, options?: fs.StatOptions & {
+    lstat(pathOrId: string, options?: fs.StatOptions & {
         bigint?: false | undefined;
     }): Promise<Stats>;
     /**
@@ -334,7 +334,7 @@ declare class VirtualFileSystem implements VirtualFileSystemInterface {
      * @param pathOrId - The path or ID of the symbolic link to retrieve status for.
      * @returns The symbolic link's status information, or false if the link does not exist.
      */
-    lstatSync(pathOrId: PathLike, options?: StatSyncOptions & {
+    lstatSync(pathOrId: string, options?: StatSyncOptions & {
         bigint?: false | undefined;
         throwIfNoEntry: false;
     }): Stats | undefined;
@@ -344,22 +344,41 @@ declare class VirtualFileSystem implements VirtualFileSystemInterface {
      * @param pathOrId - The path or ID to resolve.
      * @returns The resolved real path if it exists, otherwise undefined.
      */
-    realpathSync(pathOrId: PathLike): string;
+    realpathSync(pathOrId: string): string;
     /**
-     * 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: PathLike, options?: ResolvePathOptions): string | false;
+    resolve(id: string, importer?: string, options?: ResolveOptions): Promise<string | undefined>;
     /**
-     * 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
+     *
+     * @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 path - The relative path to convert.
-     * @returns The absolute path.
+     * @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: PathOrFileDescriptor): string;
+    resolveSync(id: string, importer?: string, options?: ResolveOptions): string | undefined;
     /**
      * Disposes of the virtual file system (VFS) by saving its state to disk.
      */

package/dist/lib/index.d.ts

@@ -4,22 +4,22 @@ export { PowerlinesContext } from './contexts/context.js';
 export { PowerlinesEnvironmentContext } from './contexts/environment-context.js';
 export { createPluginContext } from './contexts/plugin-context.js';
 export { getUniqueEntries, resolveEntries, resolveEntriesSync, resolveEntry, resolveEntryInput, resolveEntryInputFile, resolveEntryOutput, resolveVirtualEntry } from './entry.js';
-import fs, { PathLike, ObjectEncodingOptions, PathOrFileDescriptor, Stats, StatSyncOptions } from 'node:fs';
-import { V as VirtualFileSystemInterface, C as Context, a as VirtualFileMetadata, R as ResolvePathOptions, b as ResolveFSOptions, M as MakeDirectoryOptions, W as WriteFileData, c as WriteFileOptions, _ as __VFS_PATCH__, d as __VFS_REVERT__ } from './config-7Q2dBjJE.js';
+import { FlatCache } from 'flat-cache';
+import fs, { ObjectEncodingOptions, Stats, StatSyncOptions } from 'node:fs';
+import { V as VirtualFileSystemInterface, C as Context, a as VirtualFileMetadata, R as ResolveOptions, b as ResolveFSOptions, M as MakeDirectoryOptions, W as WriteFileData, c as WriteFileOptions, _ as __VFS_PATCH__, d as __VFS_REVERT__ } from './config-DBIFdRoq.js';
 export { CreateLogOptions, __ΩCreateLogOptions, createLog, extendLog } from './logger.js';
 export { IsolatedDeclarationsResult, __ΩIsolatedDeclarationsResult, isolatedDeclarations } from './typescript/isolated-decl.js';
 export { SourcesMap, __ΩSourcesMap, createVirtualCompilerHost, createVirtualProgram, getDefaultCompilerOptions, loadLibFiles } from './typescript/program.js';
 export { createProgram } from './typescript/ts-morph.js';
 export { findIncludeMatch, findMatch, getParsedTypeScriptConfig, getTsconfigFilePath, isIncludeMatchFound, isMatchFound } from './typescript/tsconfig.js';
 export { createUnpluginFactory } from './unplugin/factory.js';
+export { combineContexts } from './unplugin/helpers.js';
 export { CreateUnpluginOptions, __ΩCreateUnpluginOptions, createUnplugin } from './unplugin/plugin.js';
-export { ResolveIdArgs, ResolveIdOptions, __ΩResolveIdArgs, __ΩResolveIdOptions, handleResolveId } from './unplugin/resolve-id.js';
 export { bundle } from './utilities/bundle.js';
 export { getCache, setCache } from './utilities/cache.js';
 export { FileHeaderOptions, __ΩFileHeaderOptions, getBaseFileHeader, getFileHeader } from './utilities/file-header.js';
 export { CACHE_HASH_LENGTH, CreateContextOptions, PROJECT_ROOT_HASH_LENGTH, __ΩCreateContextOptions, discoverTemplates, getPersistedMeta, getPrefixedProjectRootHash, writeMetaFile } from './utilities/meta.js';
 export { resolve } from './utilities/resolve.js';
-export { resolvePath } from './utilities/resolve-path.js';
 export { getMagicString, getSourceFile, getString } from './utilities/source-file.js';
 export { generateSourceMap } from './utilities/source-map.js';
 export { Worker, WorkerOptions, __ΩWorkerOptions, createWorker } from './utilities/worker.js';
@@ -28,9 +28,10 @@ import 'jiti';
 import '@stryke/env/get-env-paths';
 import '@stryke/types/package-json';
 import 'semver';
+import 'ts-morph';
 import 'unplugin';
-import './internal-BEygquYh.js';
-import './api-mja4jirh.js';
+import './internal-1qCyw7bA.js';
+import './api-CDUN9en8.js';
 import './tsconfig-Bz-CiFqD.js';
 import '@stryke/types/tsconfig';
 import 'typescript';
@@ -52,9 +53,9 @@ import 'rollup';
 import 'webpack';
 import 'jest-worker';
 import 'magic-string';
+import '@stryke/fs/resolve';
 import '@stryke/types/array';
-import 'ts-morph';
-import './unplugin-CbbNDduM.js';
+import './unplugin-CEeJqADD.js';
 
 /**
  * Represents a virtual file system (VFS) that stores files and their associated metadata in virtual memory.
@@ -81,15 +82,16 @@ declare class VirtualFileSystem implements VirtualFileSystemInterface {
     /**
      * A map of file ids to their metadata.
      */
-    get metadata(): Record<string, VirtualFileMetadata>;
+    get metadata(): Readonly<Record<string, VirtualFileMetadata>>;
     /**
-     * A map of module ids to their file paths.
+     * A map of file paths to their module ids.
      */
-    get ids(): Record<string, string>;
+    get ids(): Readonly<Record<string, string>>;
     /**
-     * A map of virtual file paths to their IDs.
+     * A map of module ids to their file paths.
      */
-    get paths(): Record<string, string>;
+    get paths(): Readonly<Record<string, string>>;
+    protected get resolverCache(): FlatCache;
     /**
      * Creates a new instance of the {@link VirtualFileSystem}.
      *
@@ -101,18 +103,16 @@ declare class VirtualFileSystem implements VirtualFileSystemInterface {
      * Check if a path or id corresponds to a virtual file **(does not actually exists on disk)**.
      *
      * @param pathOrId - The path or id to check.
-     * @param options - Optional parameters for resolving the path.
      * @returns Whether the path or id corresponds to a virtual file **(does not actually exists on disk)**.
      */
-    isVirtual(pathOrId: string, options?: ResolvePathOptions): boolean;
+    isVirtual(pathOrId: string, importer?: string, options?: ResolveOptions): boolean;
     /**
      * Check if a path or id corresponds to a file written to the file system **(actually exists on disk)**.
      *
      * @param pathOrId - The path or id to check.
-     * @param options - Optional parameters for resolving the path.
      * @returns Whether the path or id corresponds to a file written to the file system **(actually exists on disk)**.
      */
-    isPhysical(pathOrId: string, options?: ResolvePathOptions): boolean;
+    isPhysical(pathOrId: string, importer?: string, options?: ResolveOptions): boolean;
     /**
      * Lists files in a given path.
      *
@@ -130,20 +130,20 @@ declare class VirtualFileSystem implements VirtualFileSystemInterface {
      *
      * @param path - The path to create the directory at.
      */
-    unlinkSync(path: fs.PathLike, options?: ResolveFSOptions): void;
+    unlinkSync(path: string, options?: ResolveFSOptions): void;
     /**
      * Removes a file in the virtual file system (VFS).
      *
      * @param path - The path to create the directory at.
      */
-    unlink(path: fs.PathLike, options?: ResolveFSOptions): Promise<void>;
+    unlink(path: string, options?: ResolveFSOptions): Promise<void>;
     /**
      * Removes a directory in the virtual file system (VFS).
      *
      * @param path - The path to create the directory at.
      * @param options - Options for creating the directory.
      */
-    rmdirSync(path: fs.PathLike, options?: fs.RmDirOptions & ResolveFSOptions): void;
+    rmdirSync(path: string, options?: fs.RmDirOptions & ResolveFSOptions): void;
     /**
      * Removes a directory in the virtual file system (VFS).
      *
@@ -151,7 +151,7 @@ declare class VirtualFileSystem implements VirtualFileSystemInterface {
      * @param options - Options for creating the directory.
      * @returns A promise that resolves to the path of the created directory, or undefined if the directory could not be created.
      */
-    rmdir(path: fs.PathLike, options?: fs.RmDirOptions & ResolveFSOptions): Promise<void>;
+    rmdir(path: string, options?: fs.RmDirOptions & ResolveFSOptions): Promise<void>;
     /**
      * Removes a file in the virtual file system (VFS).
      *
@@ -159,14 +159,14 @@ declare class VirtualFileSystem implements VirtualFileSystemInterface {
      * @param options - Options for removing the file.
      * @returns A promise that resolves when the file is removed.
      */
-    rm(path: fs.PathLike, options?: fs.RmOptions & ResolveFSOptions): Promise<void>;
+    rm(path: string, options?: fs.RmOptions & ResolveFSOptions): Promise<void>;
     /**
      * Synchronously removes a file or directory in the virtual file system (VFS).
      *
      * @param path - The path to the file or directory to remove.
      * @param options - Options for removing the file or directory.
      */
-    rmSync(path: fs.PathLike, options?: fs.RmOptions & ResolveFSOptions): void;
+    rmSync(path: string, options?: fs.RmOptions & ResolveFSOptions): void;
     /**
      * Creates a directory in the virtual file system (VFS).
      *
@@ -174,7 +174,7 @@ declare class VirtualFileSystem implements VirtualFileSystemInterface {
      * @param options - Options for creating the directory.
      * @returns A promise that resolves to the path of the created directory, or undefined if the directory could not be created.
      */
-    mkdirSync(path: fs.PathLike, options?: MakeDirectoryOptions): string | undefined;
+    mkdirSync(path: string, options?: MakeDirectoryOptions): string | undefined;
     /**
      * Creates a directory in the virtual file system (VFS).
      *
@@ -182,7 +182,7 @@ declare class VirtualFileSystem implements VirtualFileSystemInterface {
      * @param options - Options for creating the directory.
      * @returns A promise that resolves to the path of the created directory, or undefined if the directory could not be created.
      */
-    mkdir(path: fs.PathLike, options?: MakeDirectoryOptions): Promise<string | undefined>;
+    mkdir(path: string, options?: MakeDirectoryOptions): Promise<string | undefined>;
     /**
      * Glob files in the virtual file system (VFS) based on the provided pattern(s).
      *
@@ -232,7 +232,7 @@ declare class VirtualFileSystem implements VirtualFileSystemInterface {
      * @param options - Options for listing files, such as encoding and recursion.
      * @returns An array of file names in the specified path.
      */
-    readdir(pathOrId: PathLike, options?: {
+    readdir(pathOrId: string, options?: {
         encoding: BufferEncoding | null;
         withFileTypes?: false | undefined;
         recursive?: boolean | undefined;
@@ -243,7 +243,7 @@ declare class VirtualFileSystem implements VirtualFileSystemInterface {
      * @param pathOrId - The path or ID of the file to read.
      * @returns A promise that resolves to the contents of the file as a string, or undefined if the file does not exist.
      */
-    readFile(pathOrId: PathLike, options?: (ObjectEncodingOptions & {
+    readFile(pathOrId: string, options?: (ObjectEncodingOptions & {
         flag?: string | undefined;
     }) | BufferEncoding): Promise<string | undefined>;
     /**
@@ -252,7 +252,7 @@ declare class VirtualFileSystem implements VirtualFileSystemInterface {
      * @param pathOrId - The path or ID of the file to read.
      * @returns The contents of the file as a string, or undefined if the file does not exist.
      */
-    readFileSync(pathOrId: PathLike, options?: (fs.ObjectEncodingOptions & {
+    readFileSync(pathOrId: string, options?: (fs.ObjectEncodingOptions & {
         flag?: string | undefined;
     }) | BufferEncoding | null): string | undefined;
     /**
@@ -263,7 +263,7 @@ declare class VirtualFileSystem implements VirtualFileSystemInterface {
      * @param options - Optional parameters for writing the file.
      * @returns A promise that resolves when the file is written.
      */
-    writeFile(path: PathOrFileDescriptor, data?: WriteFileData, options?: WriteFileOptions): Promise<void>;
+    writeFile(path: string, data?: WriteFileData, options?: WriteFileOptions): Promise<void>;
     /**
      * Synchronously writes a file to the virtual file system (VFS).
      *
@@ -271,21 +271,21 @@ declare class VirtualFileSystem implements VirtualFileSystemInterface {
      * @param data - The contents of the file.
      * @param options - Optional parameters for writing the file.
      */
-    writeFileSync(path: PathOrFileDescriptor, data?: WriteFileData, options?: WriteFileOptions): void;
+    writeFileSync(path: string, data?: WriteFileData, options?: WriteFileOptions): void;
     /**
      * Synchronously checks if a file exists in the virtual file system (VFS).
      *
      * @param pathOrId - The path or ID of the file to check.
      * @returns `true` if the file exists, otherwise `false`.
      */
-    existsSync(pathOrId: PathLike): boolean;
+    existsSync(pathOrId: string): boolean;
     /**
      * Retrieves the metadata of a file in the virtual file system (VFS).
      *
      * @param pathOrId - The path or ID of the file to retrieve metadata for.
      * @returns The metadata of the file, or undefined if the file does not exist.
      */
-    getMetadata(pathOrId: PathLike): VirtualFileMetadata | undefined;
+    getMetadata(pathOrId: string): VirtualFileMetadata | undefined;
     /**
      * Checks if a file exists in the virtual file system (VFS).
      *
@@ -295,21 +295,21 @@ declare class VirtualFileSystem implements VirtualFileSystemInterface {
      * @param pathOrId - The path of the file to check.
      * @returns `true` if the file exists, otherwise `false`.
      */
-    isFile(pathOrId: PathLike): boolean;
+    isFile(pathOrId: string): boolean;
     /**
      * Checks if a directory exists in the virtual file system (VFS).
      *
      * @param pathOrId - The path of the directory to check.
      * @returns `true` if the directory exists, otherwise `false`.
      */
-    isDirectory(pathOrId: PathLike): boolean;
+    isDirectory(pathOrId: string): boolean;
     /**
      * Retrieves the status of a file in the virtual file system (VFS).
      *
      * @param pathOrId - The path or ID of the file to retrieve status for.
      * @returns A promise that resolves to the file's status information, or false if the file does not exist.
      */
-    stat(pathOrId: PathLike, options?: fs.StatOptions & {
+    stat(pathOrId: string, options?: fs.StatOptions & {
         bigint?: false | undefined;
     }): Promise<Stats>;
     /**
@@ -318,14 +318,14 @@ declare class VirtualFileSystem implements VirtualFileSystemInterface {
      * @param pathOrId - The path or ID of the file to retrieve status for.
      * @returns The file's status information, or false if the file does not exist.
      */
-    statSync(pathOrId: PathLike): Stats;
+    statSync(pathOrId: string): Stats;
     /**
      * Retrieves the status of a symbolic link in the virtual file system (VFS).
      *
      * @param pathOrId - The path or ID of the symbolic link to retrieve status for.
      * @returns A promise that resolves to the symbolic link's status information, or false if the link does not exist.
      */
-    lstat(pathOrId: PathLike, options?: fs.StatOptions & {
+    lstat(pathOrId: string, options?: fs.StatOptions & {
         bigint?: false | undefined;
     }): Promise<Stats>;
     /**
@@ -334,7 +334,7 @@ declare class VirtualFileSystem implements VirtualFileSystemInterface {
      * @param pathOrId - The path or ID of the symbolic link to retrieve status for.
      * @returns The symbolic link's status information, or false if the link does not exist.
      */
-    lstatSync(pathOrId: PathLike, options?: StatSyncOptions & {
+    lstatSync(pathOrId: string, options?: StatSyncOptions & {
         bigint?: false | undefined;
         throwIfNoEntry: false;
     }): Stats | undefined;
@@ -344,22 +344,41 @@ declare class VirtualFileSystem implements VirtualFileSystemInterface {
      * @param pathOrId - The path or ID to resolve.
      * @returns The resolved real path if it exists, otherwise undefined.
      */
-    realpathSync(pathOrId: PathLike): string;
+    realpathSync(pathOrId: string): string;
     /**
-     * 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: PathLike, options?: ResolvePathOptions): string | false;
+    resolve(id: string, importer?: string, options?: ResolveOptions): Promise<string | undefined>;
     /**
-     * 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
+     *
+     * @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 path - The relative path to convert.
-     * @returns The absolute path.
+     * @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: PathOrFileDescriptor): string;
+    resolveSync(id: string, importer?: string, options?: ResolveOptions): string | undefined;
     /**
      * Disposes of the virtual file system (VFS) by saving its state to disk.
      */