powerlines 0.9.0 → 0.10.1

package/dist/lib/{config-BOPIY57U.d.cts → config-AuIGsUck.d.cts}

@@ -23,6 +23,7 @@ import { Range } from 'semver';
 import { TransformResult, ExternalIdResult, HookFilter, UnpluginOptions, UnpluginContext, UnpluginBuildContext } from 'unplugin';
 import { ArrayValues } from '@stryke/types/array';
 import { P as ParsedTypeScriptConfig, T as TSConfig } from './tsconfig-Bz-CiFqD.cjs';
+import { PrimitiveJsonValue } from '@stryke/json/types';
 import { Volume } from 'memfs';
 import { StatSyncOptions, Stats, PathLike, RmDirOptions, RmOptions, Mode, MakeDirectoryOptions as MakeDirectoryOptions$1, PathOrFileDescriptor, WriteFileOptions as WriteFileOptions$1 } from 'node:fs';
 import { IUnionFs } from 'unionfs';
@@ -424,30 +425,57 @@ declare const __VFS_REVERT__ = "__VFS_REVERT__";
 declare const __VFS_CACHE__ = "__VFS_CACHE__";
 declare const __VFS_VIRTUAL__ = "__VFS_VIRTUAL__";
 declare const __VFS_UNIFIED__ = "__VFS_UNIFIED__";
+type OutputModeType = "fs" | "virtual";
 interface VirtualFile {
     /**
-     * A virtual path to the file in the virtual file system.
+     * The unique identifier for the virtual file.
+     *
+     * @remarks
+     * If no specific id is provided, it defaults to the file's {@link path}.
      */
-    path: string;
+    id: string;
     /**
-     * The contents of the virtual file.
+     * Additional metadata associated with the virtual file.
      */
-    contents: string;
-}
-interface VirtualBuiltinFile extends VirtualFile {
+    details: Record<string, PrimitiveJsonValue>;
     /**
-     * The unique identifier for the virtual file.
+     * The variant of the file.
      *
      * @remarks
-     * This property is read-only and is set when the file is created.
+     * This string represents the purpose/function of the file in the virtual file system. A potential list of variants includes:
+     * - `builtin`: Indicates that the file is a built-in module provided by the system.
+     * - `entry`: Indicates that the file is an entry point for execution.
+     * - `normal`: Indicates that the file is a standard file without any special role.
      */
-    id: string;
+    variant: string;
+    /**
+     * The output mode of the file.
+     *
+     * @remarks
+     * This indicates whether the file is intended to be written to the actual file system (`fs`) or kept in the virtual file system (`virtual`).
+     */
+    mode: OutputModeType;
+    /**
+     * A virtual (or actual) path to the file in the file system.
+     */
+    path: string;
+    /**
+     * The contents of the file.
+     */
+    code: string | NodeJS.ArrayBufferView;
 }
-type OutputModeType = "fs" | "virtual";
+type VirtualFileSystemMetadata = Pick<VirtualFile, "id" | "details" | "variant" | "mode">;
 interface ResolveFSOptions {
     mode?: OutputModeType;
 }
 type MakeDirectoryOptions = (Mode | MakeDirectoryOptions$1) & ResolveFSOptions;
+interface PowerlinesWriteFileOptions extends ResolveFSOptions {
+    skipFormat?: boolean;
+}
+type NodeWriteFileOptions = WriteFileOptions$1;
+type WriteFileOptions = NodeWriteFileOptions | PowerlinesWriteFileOptions;
+type PowerLinesWriteFileData = Partial<Omit<VirtualFile, "path" | "mode" | "code">> & Pick<VirtualFile, "code">;
+type WriteFileData = string | NodeJS.ArrayBufferView | PowerLinesWriteFileData;
 interface ResolvePathOptions extends ResolveFSOptions {
     /**
      * Should the resolved path include the file extension?
@@ -464,82 +492,63 @@ interface ResolvePathOptions extends ResolveFSOptions {
      */
     type?: "file" | "directory";
 }
-type WriteFileOptions = WriteFileOptions$1 & ResolveFSOptions;
-interface WriteBuiltinFileOptions extends ResolveFSOptions {
-    skipFormat?: boolean;
-}
 interface VirtualFileSystemInterface {
     [__VFS_INIT__]: () => void;
     [__VFS_REVERT__]: () => void;
     /**
-     * The underlying builtin module Ids.
+     * The underlying file metadata.
      */
-    builtinIdMap: Map<string, string>;
+    meta: Record<string, VirtualFileSystemMetadata | undefined>;
     /**
-     * Checks if a path or ID corresponds to a builtin file.
-     *
-     * @param id - The id of the builtin file to check against.
-     * @param pathOrId - The path or id of the file to check.
-     * @returns Whether the path or ID corresponds to a builtin file.
-     */
-    isMatchingBuiltinId: (id: string, pathOrId: string) => boolean;
-    /**
-     * Checks if a provided string is a valid builtin ID (does not need to already be created in the file system).
-     *
-     * @param id - The ID to check.
-     * @returns Whether the ID is a valid builtin ID.
+     * A map of module ids to their file paths.
      */
-    isValidBuiltinId: (id: string) => boolean;
+    ids: Record<string, string>;
     /**
-     * Check if a path or ID corresponds to a virtual file.
+     * 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 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.
+     * @returns Whether the path or id corresponds to a virtual file **(does not actually exists on disk)**.
      */
-    isVirtualFile: (pathOrId: string, options?: ResolvePathOptions) => boolean;
+    isVirtual: (pathOrId: string, options?: ResolvePathOptions) => boolean;
     /**
-     * Check if a path exists within one of the directories specified in the tsconfig.json's `path` field.
-     *
-     * @see https://www.typescriptlang.org/tsconfig#paths
+     * 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.
-     * @returns Whether the path or ID corresponds to a virtual file.
-     */
-    isTsconfigPath: (pathOrId: string) => boolean;
-    /**
-     * Checks if a given path or ID corresponds to a builtin module file.
-     */
-    isBuiltinFile: (pathOrID: string, options?: ResolvePathOptions) => boolean;
-    /**
-     * Returns a list of builtin module files in the virtual file system.
-     */
-    listBuiltinFiles: () => Promise<VirtualBuiltinFile[]>;
-    /**
-     * Checks if a file exists in the virtual file system (VFS).
+     * @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)**.
      */
-    existsSync: (pathOrId: string) => boolean;
+    isFs: (pathOrId: string, options?: ResolvePathOptions) => boolean;
     /**
      * Checks if a file exists in the virtual file system (VFS).
      *
      * @param path - The path of the file to check.
      * @returns `true` if the file exists, otherwise `false`.
      */
-    fileExistsSync: (path: string) => boolean;
+    isFile: (path: string) => boolean;
     /**
      * Checks if a directory exists in the virtual file system (VFS).
      *
      * @param path - The path of the directory to check.
      * @returns `true` if the directory exists, otherwise `false`.
      */
-    directoryExistsSync: (path: string) => boolean;
+    isDirectory: (path: string) => boolean;
     /**
-     * Checks if a path exists in the virtual file system (VFS).
+     * Check if a path exists within one of the directories specified in the tsconfig.json's `path` field.
      *
-     * @param path - The path to check.
-     * @returns `true` if the path exists, otherwise `false`.
+     * @see https://www.typescriptlang.org/tsconfig#paths
+     *
+     * @param pathOrId - The path or id to check.
+     * @returns Whether the path or id corresponds to a virtual file.
+     */
+    isTsconfigPath: (pathOrId: string) => boolean;
+    /**
+     * Checks if a file exists in the virtual file system (VFS).
+     *
+     * @param pathOrId - The path or id of the file.
+     * @returns `true` if the file exists, otherwise `false`.
      */
-    pathExistsSync: (path: string) => boolean;
+    existsSync: (pathOrId: string) => boolean;
     /**
      * Gets the stats of a file in the virtual file system (VFS).
      *
@@ -675,71 +684,28 @@ interface VirtualFileSystemInterface {
     /**
      * Writes a file to the virtual file system (VFS).
      *
-     * @param file - The path to the file.
+     * @param path - The path to the file.
      * @param data - The contents of the file.
      * @param options - Optional parameters for writing the file.
      * @returns A promise that resolves when the file is written.
      */
-    writeFile: (file: PathOrFileDescriptor, data: string | NodeJS.ArrayBufferView, options?: WriteFileOptions) => Promise<void>;
+    writeFile: (path: PathOrFileDescriptor, data?: WriteFileData, options?: WriteFileOptions) => Promise<void>;
     /**
      * Writes a file to the virtual file system (VFS).
      *
-     * @param file - The path to the file.
+     * @param path - The path to the file.
      * @param data - The contents of the file.
      * @param options - Optional parameters for writing the file.
      */
-    writeFileSync: (file: PathOrFileDescriptor, data: string | NodeJS.ArrayBufferView, options?: WriteFileOptions) => void;
-    /**
-     * Adds a builtin module file to the virtual file system.
-     *
-     * @param id - The unique identifier for the builtin module file.
-     * @param path - The path to the builtin module file.
-     * @param contents - The contents of the builtin module file.
-     * @param options - Optional parameters for writing the builtin module file.
-     */
-    writeBuiltinFile: (id: string, path: string, contents: string, options?: WriteBuiltinFileOptions) => Promise<void>;
-    /**
-     * Adds an entry file to the virtual file system.
-     *
-     * @param name - The unique identifier for the entry file.
-     * @param contents - The contents of the entry file.
-     * @param options - Optional parameters for writing the entry file.
-     */
-    writeEntryFile: (name: string, contents: string, options?: WriteBuiltinFileOptions) => Promise<void>;
+    writeFileSync: (path: PathOrFileDescriptor, data?: WriteFileData, options?: WriteFileOptions) => void;
     /**
-     * Writes a file to disk from the physical file system (on disk).
-     *
-     * @param path - The path to the file to write.
-     * @param contents - The contents of the file to write.
-     * @param options - Optional parameters for writing the file.
-     * @returns A promise that resolves when the file is written.
-     */
-    writeFileToDisk: (path: string, contents: string, options?: {
-        skipFormat?: boolean;
-    }) => Promise<void>;
-    /**
-     * Resolves a path or ID to a file path in the virtual file system.
+     * Resolves a path or id to a file path in the virtual file system.
      *
      * @param pathOrId - The path or id of the file to resolve.
      * @param options - Optional parameters for resolving the path.
      * @returns The resolved path of the file if it exists, otherwise false.
      */
-    resolvePath: (pathOrId: string, options?: ResolvePathOptions) => string | false;
-    /**
-     * Resolves a path or ID to a file path in the virtual file system.
-     *
-     * @param pathOrId - The path or id of the file to resolve.
-     * @returns The resolved path of the file if it exists, otherwise false.
-     */
-    realpathSync: (pathOrId: string) => string;
-    /**
-     * Resolves a path or ID to a builtin module file id in the virtual file system.
-     *
-     * @param pathOrId - The path or id of the file to resolve.
-     * @param paths - Optional array of paths to search for the file.
-     * @returns The resolved id of the builtin module file if it exists, otherwise false.
-     */
-    resolveId: (pathOrId: string) => string | false;
+    resolve: (pathOrId: string, options?: ResolvePathOptions) => string | false;
     /**
      * Resolves a path based on TypeScript's `tsconfig.json` paths.
      *
@@ -758,6 +724,19 @@ interface VirtualFileSystemInterface {
      * @returns The resolved package name if it exists, otherwise undefined.
      */
     resolveTsconfigPathPackage: (path: string) => string | false;
+    /**
+     * Resolves a path or id to a file path in the virtual file system.
+     *
+     * @param pathOrId - The path or id of the file to resolve.
+     * @returns The resolved path of the file if it exists, otherwise false.
+     */
+    realpathSync: (pathOrId: string) => string;
+    /**
+     * Retrieves a partial metadata mapping of all files in the virtual file system (VFS).
+     *
+     * @returns A record mapping file paths to their partial metadata.
+     */
+    getPartialMeta: () => Record<string, Partial<VirtualFileSystemMetadata>>;
     /**
      * A map of cached file paths to their underlying file content.
      */
@@ -915,6 +894,31 @@ interface Context<TResolvedConfig extends ResolvedConfig = ResolvedConfig> {
      * The Jiti module resolver
      */
     resolver: Resolver;
+    /**
+     * The builtin module id that exist in the Powerlines virtual file system
+     */
+    builtins: string[];
+    /**
+     * The Powerlines builtin virtual files
+     */
+    getBuiltins: () => Promise<VirtualFile[]>;
+    /**
+     * Resolves a builtin virtual file and writes it to the VFS if it does not already exist
+     *
+     * @param code - The source code of the builtin file
+     * @param id - The unique identifier of the builtin file
+     * @param path - An optional path to write the builtin file to
+     * @param options - Options for writing the file
+     */
+    writeBuiltin: (code: string, id: string, path?: string, options?: PowerlinesWriteFileOptions) => Promise<void>;
+    /**
+     * Resolves a entry virtual file and writes it to the VFS if it does not already exist
+     *
+     * @param code - The source code of the entry file
+     * @param path - An optional path to write the entry file to
+     * @param options - Options for writing the file
+     */
+    writeEntry: (code: string, path: string, options?: PowerlinesWriteFileOptions) => Promise<void>;
     /**
      * Parses the source code and returns a {@link ParseResult} object.
      */

package/dist/lib/{config-Chd_3Uh3.d.ts → config-B_WTwd49.d.ts}

@@ -23,6 +23,7 @@ import { Range } from 'semver';
 import { TransformResult, ExternalIdResult, HookFilter, UnpluginOptions, UnpluginContext, UnpluginBuildContext } from 'unplugin';
 import { ArrayValues } from '@stryke/types/array';
 import { P as ParsedTypeScriptConfig, T as TSConfig } from './tsconfig-Bz-CiFqD.js';
+import { PrimitiveJsonValue } from '@stryke/json/types';
 import { Volume } from 'memfs';
 import { StatSyncOptions, Stats, PathLike, RmDirOptions, RmOptions, Mode, MakeDirectoryOptions as MakeDirectoryOptions$1, PathOrFileDescriptor, WriteFileOptions as WriteFileOptions$1 } from 'node:fs';
 import { IUnionFs } from 'unionfs';
@@ -424,30 +425,57 @@ declare const __VFS_REVERT__ = "__VFS_REVERT__";
 declare const __VFS_CACHE__ = "__VFS_CACHE__";
 declare const __VFS_VIRTUAL__ = "__VFS_VIRTUAL__";
 declare const __VFS_UNIFIED__ = "__VFS_UNIFIED__";
+type OutputModeType = "fs" | "virtual";
 interface VirtualFile {
     /**
-     * A virtual path to the file in the virtual file system.
+     * The unique identifier for the virtual file.
+     *
+     * @remarks
+     * If no specific id is provided, it defaults to the file's {@link path}.
      */
-    path: string;
+    id: string;
     /**
-     * The contents of the virtual file.
+     * Additional metadata associated with the virtual file.
      */
-    contents: string;
-}
-interface VirtualBuiltinFile extends VirtualFile {
+    details: Record<string, PrimitiveJsonValue>;
     /**
-     * The unique identifier for the virtual file.
+     * The variant of the file.
      *
      * @remarks
-     * This property is read-only and is set when the file is created.
+     * This string represents the purpose/function of the file in the virtual file system. A potential list of variants includes:
+     * - `builtin`: Indicates that the file is a built-in module provided by the system.
+     * - `entry`: Indicates that the file is an entry point for execution.
+     * - `normal`: Indicates that the file is a standard file without any special role.
      */
-    id: string;
+    variant: string;
+    /**
+     * The output mode of the file.
+     *
+     * @remarks
+     * This indicates whether the file is intended to be written to the actual file system (`fs`) or kept in the virtual file system (`virtual`).
+     */
+    mode: OutputModeType;
+    /**
+     * A virtual (or actual) path to the file in the file system.
+     */
+    path: string;
+    /**
+     * The contents of the file.
+     */
+    code: string | NodeJS.ArrayBufferView;
 }
-type OutputModeType = "fs" | "virtual";
+type VirtualFileSystemMetadata = Pick<VirtualFile, "id" | "details" | "variant" | "mode">;
 interface ResolveFSOptions {
     mode?: OutputModeType;
 }
 type MakeDirectoryOptions = (Mode | MakeDirectoryOptions$1) & ResolveFSOptions;
+interface PowerlinesWriteFileOptions extends ResolveFSOptions {
+    skipFormat?: boolean;
+}
+type NodeWriteFileOptions = WriteFileOptions$1;
+type WriteFileOptions = NodeWriteFileOptions | PowerlinesWriteFileOptions;
+type PowerLinesWriteFileData = Partial<Omit<VirtualFile, "path" | "mode" | "code">> & Pick<VirtualFile, "code">;
+type WriteFileData = string | NodeJS.ArrayBufferView | PowerLinesWriteFileData;
 interface ResolvePathOptions extends ResolveFSOptions {
     /**
      * Should the resolved path include the file extension?
@@ -464,82 +492,63 @@ interface ResolvePathOptions extends ResolveFSOptions {
      */
     type?: "file" | "directory";
 }
-type WriteFileOptions = WriteFileOptions$1 & ResolveFSOptions;
-interface WriteBuiltinFileOptions extends ResolveFSOptions {
-    skipFormat?: boolean;
-}
 interface VirtualFileSystemInterface {
     [__VFS_INIT__]: () => void;
     [__VFS_REVERT__]: () => void;
     /**
-     * The underlying builtin module Ids.
+     * The underlying file metadata.
      */
-    builtinIdMap: Map<string, string>;
+    meta: Record<string, VirtualFileSystemMetadata | undefined>;
     /**
-     * Checks if a path or ID corresponds to a builtin file.
-     *
-     * @param id - The id of the builtin file to check against.
-     * @param pathOrId - The path or id of the file to check.
-     * @returns Whether the path or ID corresponds to a builtin file.
-     */
-    isMatchingBuiltinId: (id: string, pathOrId: string) => boolean;
-    /**
-     * Checks if a provided string is a valid builtin ID (does not need to already be created in the file system).
-     *
-     * @param id - The ID to check.
-     * @returns Whether the ID is a valid builtin ID.
+     * A map of module ids to their file paths.
      */
-    isValidBuiltinId: (id: string) => boolean;
+    ids: Record<string, string>;
     /**
-     * Check if a path or ID corresponds to a virtual file.
+     * 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 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.
+     * @returns Whether the path or id corresponds to a virtual file **(does not actually exists on disk)**.
      */
-    isVirtualFile: (pathOrId: string, options?: ResolvePathOptions) => boolean;
+    isVirtual: (pathOrId: string, options?: ResolvePathOptions) => boolean;
     /**
-     * Check if a path exists within one of the directories specified in the tsconfig.json's `path` field.
-     *
-     * @see https://www.typescriptlang.org/tsconfig#paths
+     * 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.
-     * @returns Whether the path or ID corresponds to a virtual file.
-     */
-    isTsconfigPath: (pathOrId: string) => boolean;
-    /**
-     * Checks if a given path or ID corresponds to a builtin module file.
-     */
-    isBuiltinFile: (pathOrID: string, options?: ResolvePathOptions) => boolean;
-    /**
-     * Returns a list of builtin module files in the virtual file system.
-     */
-    listBuiltinFiles: () => Promise<VirtualBuiltinFile[]>;
-    /**
-     * Checks if a file exists in the virtual file system (VFS).
+     * @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)**.
      */
-    existsSync: (pathOrId: string) => boolean;
+    isFs: (pathOrId: string, options?: ResolvePathOptions) => boolean;
     /**
      * Checks if a file exists in the virtual file system (VFS).
      *
      * @param path - The path of the file to check.
      * @returns `true` if the file exists, otherwise `false`.
      */
-    fileExistsSync: (path: string) => boolean;
+    isFile: (path: string) => boolean;
     /**
      * Checks if a directory exists in the virtual file system (VFS).
      *
      * @param path - The path of the directory to check.
      * @returns `true` if the directory exists, otherwise `false`.
      */
-    directoryExistsSync: (path: string) => boolean;
+    isDirectory: (path: string) => boolean;
     /**
-     * Checks if a path exists in the virtual file system (VFS).
+     * Check if a path exists within one of the directories specified in the tsconfig.json's `path` field.
      *
-     * @param path - The path to check.
-     * @returns `true` if the path exists, otherwise `false`.
+     * @see https://www.typescriptlang.org/tsconfig#paths
+     *
+     * @param pathOrId - The path or id to check.
+     * @returns Whether the path or id corresponds to a virtual file.
+     */
+    isTsconfigPath: (pathOrId: string) => boolean;
+    /**
+     * Checks if a file exists in the virtual file system (VFS).
+     *
+     * @param pathOrId - The path or id of the file.
+     * @returns `true` if the file exists, otherwise `false`.
      */
-    pathExistsSync: (path: string) => boolean;
+    existsSync: (pathOrId: string) => boolean;
     /**
      * Gets the stats of a file in the virtual file system (VFS).
      *
@@ -675,71 +684,28 @@ interface VirtualFileSystemInterface {
     /**
      * Writes a file to the virtual file system (VFS).
      *
-     * @param file - The path to the file.
+     * @param path - The path to the file.
      * @param data - The contents of the file.
      * @param options - Optional parameters for writing the file.
      * @returns A promise that resolves when the file is written.
      */
-    writeFile: (file: PathOrFileDescriptor, data: string | NodeJS.ArrayBufferView, options?: WriteFileOptions) => Promise<void>;
+    writeFile: (path: PathOrFileDescriptor, data?: WriteFileData, options?: WriteFileOptions) => Promise<void>;
     /**
      * Writes a file to the virtual file system (VFS).
      *
-     * @param file - The path to the file.
+     * @param path - The path to the file.
      * @param data - The contents of the file.
      * @param options - Optional parameters for writing the file.
      */
-    writeFileSync: (file: PathOrFileDescriptor, data: string | NodeJS.ArrayBufferView, options?: WriteFileOptions) => void;
-    /**
-     * Adds a builtin module file to the virtual file system.
-     *
-     * @param id - The unique identifier for the builtin module file.
-     * @param path - The path to the builtin module file.
-     * @param contents - The contents of the builtin module file.
-     * @param options - Optional parameters for writing the builtin module file.
-     */
-    writeBuiltinFile: (id: string, path: string, contents: string, options?: WriteBuiltinFileOptions) => Promise<void>;
-    /**
-     * Adds an entry file to the virtual file system.
-     *
-     * @param name - The unique identifier for the entry file.
-     * @param contents - The contents of the entry file.
-     * @param options - Optional parameters for writing the entry file.
-     */
-    writeEntryFile: (name: string, contents: string, options?: WriteBuiltinFileOptions) => Promise<void>;
+    writeFileSync: (path: PathOrFileDescriptor, data?: WriteFileData, options?: WriteFileOptions) => void;
     /**
-     * Writes a file to disk from the physical file system (on disk).
-     *
-     * @param path - The path to the file to write.
-     * @param contents - The contents of the file to write.
-     * @param options - Optional parameters for writing the file.
-     * @returns A promise that resolves when the file is written.
-     */
-    writeFileToDisk: (path: string, contents: string, options?: {
-        skipFormat?: boolean;
-    }) => Promise<void>;
-    /**
-     * Resolves a path or ID to a file path in the virtual file system.
+     * Resolves a path or id to a file path in the virtual file system.
      *
      * @param pathOrId - The path or id of the file to resolve.
      * @param options - Optional parameters for resolving the path.
      * @returns The resolved path of the file if it exists, otherwise false.
      */
-    resolvePath: (pathOrId: string, options?: ResolvePathOptions) => string | false;
-    /**
-     * Resolves a path or ID to a file path in the virtual file system.
-     *
-     * @param pathOrId - The path or id of the file to resolve.
-     * @returns The resolved path of the file if it exists, otherwise false.
-     */
-    realpathSync: (pathOrId: string) => string;
-    /**
-     * Resolves a path or ID to a builtin module file id in the virtual file system.
-     *
-     * @param pathOrId - The path or id of the file to resolve.
-     * @param paths - Optional array of paths to search for the file.
-     * @returns The resolved id of the builtin module file if it exists, otherwise false.
-     */
-    resolveId: (pathOrId: string) => string | false;
+    resolve: (pathOrId: string, options?: ResolvePathOptions) => string | false;
     /**
      * Resolves a path based on TypeScript's `tsconfig.json` paths.
      *
@@ -758,6 +724,19 @@ interface VirtualFileSystemInterface {
      * @returns The resolved package name if it exists, otherwise undefined.
      */
     resolveTsconfigPathPackage: (path: string) => string | false;
+    /**
+     * Resolves a path or id to a file path in the virtual file system.
+     *
+     * @param pathOrId - The path or id of the file to resolve.
+     * @returns The resolved path of the file if it exists, otherwise false.
+     */
+    realpathSync: (pathOrId: string) => string;
+    /**
+     * Retrieves a partial metadata mapping of all files in the virtual file system (VFS).
+     *
+     * @returns A record mapping file paths to their partial metadata.
+     */
+    getPartialMeta: () => Record<string, Partial<VirtualFileSystemMetadata>>;
     /**
      * A map of cached file paths to their underlying file content.
      */
@@ -915,6 +894,31 @@ interface Context<TResolvedConfig extends ResolvedConfig = ResolvedConfig> {
      * The Jiti module resolver
      */
     resolver: Resolver;
+    /**
+     * The builtin module id that exist in the Powerlines virtual file system
+     */
+    builtins: string[];
+    /**
+     * The Powerlines builtin virtual files
+     */
+    getBuiltins: () => Promise<VirtualFile[]>;
+    /**
+     * Resolves a builtin virtual file and writes it to the VFS if it does not already exist
+     *
+     * @param code - The source code of the builtin file
+     * @param id - The unique identifier of the builtin file
+     * @param path - An optional path to write the builtin file to
+     * @param options - Options for writing the file
+     */
+    writeBuiltin: (code: string, id: string, path?: string, options?: PowerlinesWriteFileOptions) => Promise<void>;
+    /**
+     * Resolves a entry virtual file and writes it to the VFS if it does not already exist
+     *
+     * @param code - The source code of the entry file
+     * @param path - An optional path to write the entry file to
+     * @param options - Options for writing the file
+     */
+    writeEntry: (code: string, path: string, options?: PowerlinesWriteFileOptions) => Promise<void>;
     /**
      * Parses the source code and returns a {@link ParseResult} object.
      */

package/dist/lib/config-file.d.cts

@@ -1,5 +1,5 @@
 import { Jiti } from 'jiti';
-import { C as Context, W as WorkspaceConfig, P as PowerlinesCommand, a as ParsedUserConfig } from './config-BOPIY57U.cjs';
+import { C as Context, W as WorkspaceConfig, P as PowerlinesCommand, a as ParsedUserConfig } from './config-AuIGsUck.cjs';
 import '@storm-software/build-tools/types';
 import '@storm-software/config-tools/types';
 import '@storm-software/config/types';
@@ -26,6 +26,7 @@ import '@stryke/types/array';
 import './tsconfig-Bz-CiFqD.cjs';
 import '@stryke/types/tsconfig';
 import 'typescript';
+import '@stryke/json/types';
 import 'memfs';
 import 'node:fs';
 import 'unionfs';

package/dist/lib/config-file.d.ts

@@ -1,5 +1,5 @@
 import { Jiti } from 'jiti';
-import { C as Context, W as WorkspaceConfig, P as PowerlinesCommand, a as ParsedUserConfig } from './config-Chd_3Uh3.js';
+import { C as Context, W as WorkspaceConfig, P as PowerlinesCommand, a as ParsedUserConfig } from './config-B_WTwd49.js';
 import '@storm-software/build-tools/types';
 import '@storm-software/config-tools/types';
 import '@storm-software/config/types';
@@ -26,6 +26,7 @@ import '@stryke/types/array';
 import './tsconfig-Bz-CiFqD.js';
 import '@stryke/types/tsconfig';
 import 'typescript';
+import '@stryke/json/types';
 import 'memfs';
 import 'node:fs';
 import 'unionfs';