@powerlines/plugin-vite 0.14.27 → 0.14.28

package/dist/helpers/index.d.cts

@@ -1,17 +1,20 @@
 export { createVitePlugin } from './unplugin.cjs';
 import 'vite';
-import '../index-B7E0WZU6.cjs';
+import '../index-Duvi2T7H.cjs';
 import '@stryke/env/get-env-paths';
 import '@stryke/types/base';
 import '@stryke/types/package-json';
 import 'jiti';
+import 'magic-string';
 import 'semver';
+import 'ts-morph';
 import 'unplugin';
 import '@storm-software/build-tools/types';
 import '@storm-software/config-tools/types';
 import '@storm-software/config/types';
 import '@stryke/types/configuration';
 import '@stryke/types/file';
+import '@stryke/fs/resolve';
 import 'node:fs';
 import '@stryke/types/array';
 import '@stryke/types/tsconfig';

package/dist/helpers/index.d.ts

@@ -1,17 +1,20 @@
 export { createVitePlugin } from './unplugin.js';
 import 'vite';
-import '../index-B7E0WZU6.js';
+import '../index-Duvi2T7H.js';
 import '@stryke/env/get-env-paths';
 import '@stryke/types/base';
 import '@stryke/types/package-json';
 import 'jiti';
+import 'magic-string';
 import 'semver';
+import 'ts-morph';
 import 'unplugin';
 import '@storm-software/build-tools/types';
 import '@storm-software/config-tools/types';
 import '@storm-software/config/types';
 import '@stryke/types/configuration';
 import '@stryke/types/file';
+import '@stryke/fs/resolve';
 import 'node:fs';
 import '@stryke/types/array';
 import '@stryke/types/tsconfig';

package/dist/helpers/unplugin.d.cts

@@ -1,16 +1,19 @@
 import * as vite from 'vite';
-import { V as VitePluginContext } from '../index-B7E0WZU6.cjs';
+import { V as VitePluginContext } from '../index-Duvi2T7H.cjs';
 import '@stryke/env/get-env-paths';
 import '@stryke/types/base';
 import '@stryke/types/package-json';
 import 'jiti';
+import 'magic-string';
 import 'semver';
+import 'ts-morph';
 import 'unplugin';
 import '@storm-software/build-tools/types';
 import '@storm-software/config-tools/types';
 import '@storm-software/config/types';
 import '@stryke/types/configuration';
 import '@stryke/types/file';
+import '@stryke/fs/resolve';
 import 'node:fs';
 import '@stryke/types/array';
 import '@stryke/types/tsconfig';

package/dist/helpers/unplugin.d.ts

@@ -1,16 +1,19 @@
 import * as vite from 'vite';
-import { V as VitePluginContext } from '../index-B7E0WZU6.js';
+import { V as VitePluginContext } from '../index-Duvi2T7H.js';
 import '@stryke/env/get-env-paths';
 import '@stryke/types/base';
 import '@stryke/types/package-json';
 import 'jiti';
+import 'magic-string';
 import 'semver';
+import 'ts-morph';
 import 'unplugin';
 import '@storm-software/build-tools/types';
 import '@storm-software/config-tools/types';
 import '@storm-software/config/types';
 import '@stryke/types/configuration';
 import '@stryke/types/file';
+import '@stryke/fs/resolve';
 import 'node:fs';
 import '@stryke/types/array';
 import '@stryke/types/tsconfig';

package/dist/{index-B7E0WZU6.d.cts → index-Duvi2T7H.d.cts}

@@ -3,14 +3,17 @@ import { EnvPaths } from '@stryke/env/get-env-paths';
 import { MaybePromise, NonUndefined, FunctionLike } from '@stryke/types/base';
 import { PackageJson } from '@stryke/types/package-json';
 import { Jiti } from 'jiti';
+import { SourceMap } from 'magic-string';
 import { Range } from 'semver';
-import { UnpluginMessage, UnpluginContext, UnpluginBuildContext, TransformResult, ExternalIdResult, HookFilter, UnpluginOptions } from 'unplugin';
+import { Project } from 'ts-morph';
+import { UnpluginMessage, ExternalIdResult, UnpluginContext, UnpluginBuildContext, TransformResult as TransformResult$1, HookFilter, UnpluginOptions } from 'unplugin';
 import { Format } from '@storm-software/build-tools/types';
 import { LogLevelLabel } from '@storm-software/config-tools/types';
 import { StormWorkspaceConfig } from '@storm-software/config/types';
 import { TypeDefinitionParameter, TypeDefinition } from '@stryke/types/configuration';
 import { AssetGlob } from '@stryke/types/file';
-import { PathLike, StatSyncOptions, Stats, RmDirOptions, RmOptions, Mode, MakeDirectoryOptions as MakeDirectoryOptions$1, PathOrFileDescriptor, WriteFileOptions as WriteFileOptions$1 } from 'node:fs';
+import { ResolveOptions as ResolveOptions$1 } from '@stryke/fs/resolve';
+import { StatSyncOptions, Stats, RmDirOptions, RmOptions, Mode, MakeDirectoryOptions as MakeDirectoryOptions$1, WriteFileOptions as WriteFileOptions$1 } from 'node:fs';
 import { ArrayValues } from '@stryke/types/array';
 import { TsConfigJson, CompilerOptions } from '@stryke/types/tsconfig';
 import ts from 'typescript';
@@ -240,21 +243,27 @@ interface PowerlinesWriteFileOptions extends ResolveFSOptions {
 type NodeWriteFileOptions = WriteFileOptions$1;
 type WriteFileOptions = NodeWriteFileOptions | PowerlinesWriteFileOptions;
 type WriteFileData = string | NodeJS.ArrayBufferView | VirtualFileData;
-interface ResolvePathOptions extends ResolveFSOptions {
+interface ResolveOptions extends ResolveOptions$1 {
     /**
-     * Should the resolved path include the file extension?
-     *
-     * @defaultValue true
+     * If true, the module is being resolved as an entry point.
+     */
+    isEntry?: boolean;
+    /**
+     * If true, the resolver will skip using the cache when resolving modules.
+     */
+    skipCache?: boolean;
+    /**
+     * An array of external modules or patterns to exclude from resolution.
      */
-    withExtension?: boolean;
+    external?: (string | RegExp)[];
     /**
-     * The paths to search for the file.
+     * An array of modules or patterns to include in the resolution, even if they are marked as external.
      */
-    paths?: string[];
+    noExternal?: (string | RegExp)[];
     /**
-     * The type of the path to resolve.
+     * An array of patterns to match when resolving modules.
      */
-    pathType?: "file" | "directory";
+    skipNodeModulesBundle?: boolean;
 }
 interface VirtualFileSystemInterface {
     /**
@@ -268,27 +277,33 @@ interface VirtualFileSystemInterface {
     /**
      * The underlying file metadata.
      */
-    metadata: Record<string, VirtualFileMetadata | undefined>;
+    metadata: Readonly<Record<string, VirtualFileMetadata>>;
+    /**
+     * A map of file paths to their module ids.
+     */
+    ids: Readonly<Record<string, string>>;
     /**
      * A map of module ids to their file paths.
      */
-    ids: Record<string, string>;
+    paths: Readonly<Record<string, string>>;
     /**
      * 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 importer - The importer path, if any.
      * @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 importer - The importer path, if any.
      * @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;
     /**
      * Checks if a file exists in the virtual file system (VFS).
      *
@@ -316,7 +331,7 @@ interface VirtualFileSystemInterface {
      * @param pathOrId - The path or id of the file.
      * @returns The metadata of the file if it exists, otherwise undefined.
      */
-    getMetadata: (pathOrId: PathLike) => VirtualFileMetadata | undefined;
+    getMetadata: (pathOrId: string) => VirtualFileMetadata | undefined;
     /**
      * Gets the stats of a file in the virtual file system (VFS).
      *
@@ -389,7 +404,7 @@ interface VirtualFileSystemInterface {
      * @param path - The path to the file to remove.
      * @returns A promise that resolves when the file is removed.
      */
-    unlinkSync: (path: PathLike, options?: ResolveFSOptions) => void;
+    unlinkSync: (path: string, options?: ResolveFSOptions) => void;
     /**
      * Asynchronously removes a file or symbolic link in the virtual file system (VFS).
      *
@@ -403,7 +418,7 @@ interface VirtualFileSystemInterface {
      * @param path - The path to create the directory at.
      * @param options - Options for creating the directory.
      */
-    rmdirSync: (path: PathLike, options?: RmDirOptions & ResolveFSOptions) => any;
+    rmdirSync: (path: string, options?: RmDirOptions & ResolveFSOptions) => any;
     /**
      * Removes a directory in the virtual file system (VFS).
      *
@@ -411,7 +426,7 @@ interface 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: PathLike, options?: RmDirOptions & ResolveFSOptions) => Promise<void>;
+    rmdir: (path: string, options?: RmDirOptions & ResolveFSOptions) => Promise<void>;
     /**
      * Removes a file or directory in the virtual file system (VFS).
      *
@@ -419,14 +434,14 @@ interface VirtualFileSystemInterface {
      * @param options - Options for removing the file or directory.
      * @returns A promise that resolves when the file or directory is removed.
      */
-    rm: (path: PathLike, options?: RmOptions & ResolveFSOptions) => Promise<void>;
+    rm: (path: string, options?: 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: PathLike, options?: RmOptions & ResolveFSOptions) => void;
+    rmSync: (path: string, options?: RmOptions & ResolveFSOptions) => void;
     /**
      * Creates a directory in the virtual file system (VFS).
      *
@@ -434,7 +449,7 @@ interface 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: PathLike, options?: MakeDirectoryOptions) => string | undefined;
+    mkdirSync: (path: string, options?: MakeDirectoryOptions) => string | undefined;
     /**
      * Creates a directory in the virtual file system (VFS).
      *
@@ -442,7 +457,7 @@ interface 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: PathLike, options?: MakeDirectoryOptions) => Promise<string | undefined>;
+    mkdir: (path: string, options?: MakeDirectoryOptions) => Promise<string | undefined>;
     /**
      * Reads a file from the virtual file system (VFS).
      *
@@ -464,7 +479,7 @@ interface 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>;
     /**
      * Writes a file to the virtual file system (VFS).
      *
@@ -472,7 +487,7 @@ interface 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;
     /**
      * Moves a file from one path to another in the virtual file system (VFS).
      *
@@ -519,24 +534,43 @@ interface VirtualFileSystemInterface {
      * 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.
      */
-    resolve: (pathOrId: string, options?: ResolvePathOptions) => string | false;
+    realpathSync: (pathOrId: string) => string;
     /**
-     * Formats a path to match the virtual file system (VFS) structure.
+     * A helper function to resolve modules using the Jiti resolver
      *
-     * @param path - The path to format.
-     * @returns The formatted path.
+     * @remarks
+     * This function can be used to resolve modules relative to the project root directory.
+     *
+     * @example
+     * ```ts
+     * const resolvedPath = 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.
      */
-    formatPath: (path: string) => string;
+    resolve: (id: string, importer?: string, options?: ResolveOptions) => Promise<string | undefined>;
     /**
-     * Resolves a path or id to a file path in the virtual file system.
+     * A synchronous helper function to resolve modules using the Jiti resolver
      *
-     * @param pathOrId - The path or id of the file to resolve.
-     * @returns The resolved path of the file if it exists, otherwise false.
+     * @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.
      */
-    realpathSync: (pathOrId: string) => string;
+    resolveSync: (id: string, importer?: string, options?: ResolveOptions) => string | undefined;
     /**
      * Disposes of the virtual file system (VFS), writes any virtual file changes to disk, and releases any associated resources.
      */
@@ -1010,6 +1044,10 @@ interface MetaInfo {
 interface Resolver extends Jiti {
     plugin: Jiti;
 }
+interface TransformResult {
+    code: string;
+    map: SourceMap | null;
+}
 interface InitContextOptions {
     /**
      * If false, the plugin will be loaded after all other plugins.
@@ -1144,6 +1182,47 @@ interface UnresolvedContext<TResolvedConfig extends ResolvedConfig = ResolvedCon
      * The builtin module id that exist in the Powerlines virtual file system
      */
     builtins: string[];
+    /**
+     * 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.
+     */
+    program: Project;
+    /**
+     * A 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 = 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.
+     */
+    resolveId: (id: string, importer?: string, options?: ResolveOptions) => Promise<ExternalIdResult | undefined>;
+    /**
+     * A helper function to load modules using the Jiti resolver
+     *
+     * @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.
+     */
+    load: (id: string) => Promise<TransformResult | undefined>;
     /**
      * The Powerlines builtin virtual files
      */
@@ -1313,7 +1392,7 @@ interface BasePluginHookFunctions<TContext extends PluginContext = PluginContext
      * @param id - The identifier of the source code.
      * @returns A promise that resolves when the hook is complete.
      */
-    transform: (this: BuildPluginContext<TContext["config"]> & TContext, code: string, id: string) => MaybePromise<TransformResult>;
+    transform: (this: BuildPluginContext<TContext["config"]> & TContext, code: string, id: string) => MaybePromise<TransformResult$1>;
     /**
      * A hook that is called to load the source code.
      *
@@ -1321,7 +1400,7 @@ interface BasePluginHookFunctions<TContext extends PluginContext = PluginContext
      * @param id - The identifier of the source code.
      * @returns A promise that resolves when the hook is complete.
      */
-    load: (this: BuildPluginContext<TContext["config"]> & TContext, id: string) => MaybePromise<TransformResult>;
+    load: (this: BuildPluginContext<TContext["config"]> & TContext, id: string) => MaybePromise<TransformResult$1>;
     /**
      * A hook that is called to resolve the identifier of the source code.
      *
@@ -1371,7 +1450,7 @@ type PluginHooks<TContext extends PluginContext = PluginContext> = {
      * @param id - The identifier of the source code.
      * @returns A promise that resolves when the hook is complete.
      */
-    transform: PluginHook<(this: BuildPluginContext<TContext["config"]> & TContext, code: string, id: string) => MaybePromise<TransformResult>, "code" | "id">;
+    transform: PluginHook<(this: BuildPluginContext<TContext["config"]> & TContext, code: string, id: string) => MaybePromise<TransformResult$1>, "code" | "id">;
     /**
      * A hook that is called to load the source code.
      *
@@ -1379,7 +1458,7 @@ type PluginHooks<TContext extends PluginContext = PluginContext> = {
      * @param id - The identifier of the source code.
      * @returns A promise that resolves when the hook is complete.
      */
-    load: PluginHook<(this: BuildPluginContext<TContext["config"]> & TContext, id: string) => MaybePromise<TransformResult>, "id">;
+    load: PluginHook<(this: BuildPluginContext<TContext["config"]> & TContext, id: string) => MaybePromise<TransformResult$1>, "id">;
     /**
      * A hook that is called to resolve the identifier of the source code.
      *

package/dist/{index-B7E0WZU6.d.ts → index-Duvi2T7H.d.ts}

@@ -3,14 +3,17 @@ import { EnvPaths } from '@stryke/env/get-env-paths';
 import { MaybePromise, NonUndefined, FunctionLike } from '@stryke/types/base';
 import { PackageJson } from '@stryke/types/package-json';
 import { Jiti } from 'jiti';
+import { SourceMap } from 'magic-string';
 import { Range } from 'semver';
-import { UnpluginMessage, UnpluginContext, UnpluginBuildContext, TransformResult, ExternalIdResult, HookFilter, UnpluginOptions } from 'unplugin';
+import { Project } from 'ts-morph';
+import { UnpluginMessage, ExternalIdResult, UnpluginContext, UnpluginBuildContext, TransformResult as TransformResult$1, HookFilter, UnpluginOptions } from 'unplugin';
 import { Format } from '@storm-software/build-tools/types';
 import { LogLevelLabel } from '@storm-software/config-tools/types';
 import { StormWorkspaceConfig } from '@storm-software/config/types';
 import { TypeDefinitionParameter, TypeDefinition } from '@stryke/types/configuration';
 import { AssetGlob } from '@stryke/types/file';
-import { PathLike, StatSyncOptions, Stats, RmDirOptions, RmOptions, Mode, MakeDirectoryOptions as MakeDirectoryOptions$1, PathOrFileDescriptor, WriteFileOptions as WriteFileOptions$1 } from 'node:fs';
+import { ResolveOptions as ResolveOptions$1 } from '@stryke/fs/resolve';
+import { StatSyncOptions, Stats, RmDirOptions, RmOptions, Mode, MakeDirectoryOptions as MakeDirectoryOptions$1, WriteFileOptions as WriteFileOptions$1 } from 'node:fs';
 import { ArrayValues } from '@stryke/types/array';
 import { TsConfigJson, CompilerOptions } from '@stryke/types/tsconfig';
 import ts from 'typescript';
@@ -240,21 +243,27 @@ interface PowerlinesWriteFileOptions extends ResolveFSOptions {
 type NodeWriteFileOptions = WriteFileOptions$1;
 type WriteFileOptions = NodeWriteFileOptions | PowerlinesWriteFileOptions;
 type WriteFileData = string | NodeJS.ArrayBufferView | VirtualFileData;
-interface ResolvePathOptions extends ResolveFSOptions {
+interface ResolveOptions extends ResolveOptions$1 {
     /**
-     * Should the resolved path include the file extension?
-     *
-     * @defaultValue true
+     * If true, the module is being resolved as an entry point.
+     */
+    isEntry?: boolean;
+    /**
+     * If true, the resolver will skip using the cache when resolving modules.
+     */
+    skipCache?: boolean;
+    /**
+     * An array of external modules or patterns to exclude from resolution.
      */
-    withExtension?: boolean;
+    external?: (string | RegExp)[];
     /**
-     * The paths to search for the file.
+     * An array of modules or patterns to include in the resolution, even if they are marked as external.
      */
-    paths?: string[];
+    noExternal?: (string | RegExp)[];
     /**
-     * The type of the path to resolve.
+     * An array of patterns to match when resolving modules.
      */
-    pathType?: "file" | "directory";
+    skipNodeModulesBundle?: boolean;
 }
 interface VirtualFileSystemInterface {
     /**
@@ -268,27 +277,33 @@ interface VirtualFileSystemInterface {
     /**
      * The underlying file metadata.
      */
-    metadata: Record<string, VirtualFileMetadata | undefined>;
+    metadata: Readonly<Record<string, VirtualFileMetadata>>;
+    /**
+     * A map of file paths to their module ids.
+     */
+    ids: Readonly<Record<string, string>>;
     /**
      * A map of module ids to their file paths.
      */
-    ids: Record<string, string>;
+    paths: Readonly<Record<string, string>>;
     /**
      * 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 importer - The importer path, if any.
      * @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 importer - The importer path, if any.
      * @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;
     /**
      * Checks if a file exists in the virtual file system (VFS).
      *
@@ -316,7 +331,7 @@ interface VirtualFileSystemInterface {
      * @param pathOrId - The path or id of the file.
      * @returns The metadata of the file if it exists, otherwise undefined.
      */
-    getMetadata: (pathOrId: PathLike) => VirtualFileMetadata | undefined;
+    getMetadata: (pathOrId: string) => VirtualFileMetadata | undefined;
     /**
      * Gets the stats of a file in the virtual file system (VFS).
      *
@@ -389,7 +404,7 @@ interface VirtualFileSystemInterface {
      * @param path - The path to the file to remove.
      * @returns A promise that resolves when the file is removed.
      */
-    unlinkSync: (path: PathLike, options?: ResolveFSOptions) => void;
+    unlinkSync: (path: string, options?: ResolveFSOptions) => void;
     /**
      * Asynchronously removes a file or symbolic link in the virtual file system (VFS).
      *
@@ -403,7 +418,7 @@ interface VirtualFileSystemInterface {
      * @param path - The path to create the directory at.
      * @param options - Options for creating the directory.
      */
-    rmdirSync: (path: PathLike, options?: RmDirOptions & ResolveFSOptions) => any;
+    rmdirSync: (path: string, options?: RmDirOptions & ResolveFSOptions) => any;
     /**
      * Removes a directory in the virtual file system (VFS).
      *
@@ -411,7 +426,7 @@ interface 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: PathLike, options?: RmDirOptions & ResolveFSOptions) => Promise<void>;
+    rmdir: (path: string, options?: RmDirOptions & ResolveFSOptions) => Promise<void>;
     /**
      * Removes a file or directory in the virtual file system (VFS).
      *
@@ -419,14 +434,14 @@ interface VirtualFileSystemInterface {
      * @param options - Options for removing the file or directory.
      * @returns A promise that resolves when the file or directory is removed.
      */
-    rm: (path: PathLike, options?: RmOptions & ResolveFSOptions) => Promise<void>;
+    rm: (path: string, options?: 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: PathLike, options?: RmOptions & ResolveFSOptions) => void;
+    rmSync: (path: string, options?: RmOptions & ResolveFSOptions) => void;
     /**
      * Creates a directory in the virtual file system (VFS).
      *
@@ -434,7 +449,7 @@ interface 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: PathLike, options?: MakeDirectoryOptions) => string | undefined;
+    mkdirSync: (path: string, options?: MakeDirectoryOptions) => string | undefined;
     /**
      * Creates a directory in the virtual file system (VFS).
      *
@@ -442,7 +457,7 @@ interface 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: PathLike, options?: MakeDirectoryOptions) => Promise<string | undefined>;
+    mkdir: (path: string, options?: MakeDirectoryOptions) => Promise<string | undefined>;
     /**
      * Reads a file from the virtual file system (VFS).
      *
@@ -464,7 +479,7 @@ interface 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>;
     /**
      * Writes a file to the virtual file system (VFS).
      *
@@ -472,7 +487,7 @@ interface 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;
     /**
      * Moves a file from one path to another in the virtual file system (VFS).
      *
@@ -519,24 +534,43 @@ interface VirtualFileSystemInterface {
      * 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.
      */
-    resolve: (pathOrId: string, options?: ResolvePathOptions) => string | false;
+    realpathSync: (pathOrId: string) => string;
     /**
-     * Formats a path to match the virtual file system (VFS) structure.
+     * A helper function to resolve modules using the Jiti resolver
      *
-     * @param path - The path to format.
-     * @returns The formatted path.
+     * @remarks
+     * This function can be used to resolve modules relative to the project root directory.
+     *
+     * @example
+     * ```ts
+     * const resolvedPath = 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.
      */
-    formatPath: (path: string) => string;
+    resolve: (id: string, importer?: string, options?: ResolveOptions) => Promise<string | undefined>;
     /**
-     * Resolves a path or id to a file path in the virtual file system.
+     * A synchronous helper function to resolve modules using the Jiti resolver
      *
-     * @param pathOrId - The path or id of the file to resolve.
-     * @returns The resolved path of the file if it exists, otherwise false.
+     * @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.
      */
-    realpathSync: (pathOrId: string) => string;
+    resolveSync: (id: string, importer?: string, options?: ResolveOptions) => string | undefined;
     /**
      * Disposes of the virtual file system (VFS), writes any virtual file changes to disk, and releases any associated resources.
      */
@@ -1010,6 +1044,10 @@ interface MetaInfo {
 interface Resolver extends Jiti {
     plugin: Jiti;
 }
+interface TransformResult {
+    code: string;
+    map: SourceMap | null;
+}
 interface InitContextOptions {
     /**
      * If false, the plugin will be loaded after all other plugins.
@@ -1144,6 +1182,47 @@ interface UnresolvedContext<TResolvedConfig extends ResolvedConfig = ResolvedCon
      * The builtin module id that exist in the Powerlines virtual file system
      */
     builtins: string[];
+    /**
+     * 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.
+     */
+    program: Project;
+    /**
+     * A 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 = 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.
+     */
+    resolveId: (id: string, importer?: string, options?: ResolveOptions) => Promise<ExternalIdResult | undefined>;
+    /**
+     * A helper function to load modules using the Jiti resolver
+     *
+     * @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.
+     */
+    load: (id: string) => Promise<TransformResult | undefined>;
     /**
      * The Powerlines builtin virtual files
      */
@@ -1313,7 +1392,7 @@ interface BasePluginHookFunctions<TContext extends PluginContext = PluginContext
      * @param id - The identifier of the source code.
      * @returns A promise that resolves when the hook is complete.
      */
-    transform: (this: BuildPluginContext<TContext["config"]> & TContext, code: string, id: string) => MaybePromise<TransformResult>;
+    transform: (this: BuildPluginContext<TContext["config"]> & TContext, code: string, id: string) => MaybePromise<TransformResult$1>;
     /**
      * A hook that is called to load the source code.
      *
@@ -1321,7 +1400,7 @@ interface BasePluginHookFunctions<TContext extends PluginContext = PluginContext
      * @param id - The identifier of the source code.
      * @returns A promise that resolves when the hook is complete.
      */
-    load: (this: BuildPluginContext<TContext["config"]> & TContext, id: string) => MaybePromise<TransformResult>;
+    load: (this: BuildPluginContext<TContext["config"]> & TContext, id: string) => MaybePromise<TransformResult$1>;
     /**
      * A hook that is called to resolve the identifier of the source code.
      *
@@ -1371,7 +1450,7 @@ type PluginHooks<TContext extends PluginContext = PluginContext> = {
      * @param id - The identifier of the source code.
      * @returns A promise that resolves when the hook is complete.
      */
-    transform: PluginHook<(this: BuildPluginContext<TContext["config"]> & TContext, code: string, id: string) => MaybePromise<TransformResult>, "code" | "id">;
+    transform: PluginHook<(this: BuildPluginContext<TContext["config"]> & TContext, code: string, id: string) => MaybePromise<TransformResult$1>, "code" | "id">;
     /**
      * A hook that is called to load the source code.
      *
@@ -1379,7 +1458,7 @@ type PluginHooks<TContext extends PluginContext = PluginContext> = {
      * @param id - The identifier of the source code.
      * @returns A promise that resolves when the hook is complete.
      */
-    load: PluginHook<(this: BuildPluginContext<TContext["config"]> & TContext, id: string) => MaybePromise<TransformResult>, "id">;
+    load: PluginHook<(this: BuildPluginContext<TContext["config"]> & TContext, id: string) => MaybePromise<TransformResult$1>, "id">;
     /**
      * A hook that is called to resolve the identifier of the source code.
      *

package/dist/index.d.cts

@@ -1,18 +1,21 @@
-import { V as VitePluginContext, a as VitePluginOptions, P as Plugin } from './index-B7E0WZU6.cjs';
-export { b as VitePluginResolvedConfig, d as __ΩVitePluginContext, _ as __ΩVitePluginOptions, c as __ΩVitePluginResolvedConfig } from './index-B7E0WZU6.cjs';
+import { V as VitePluginContext, a as VitePluginOptions, P as Plugin } from './index-Duvi2T7H.cjs';
+export { b as VitePluginResolvedConfig, d as __ΩVitePluginContext, _ as __ΩVitePluginOptions, c as __ΩVitePluginResolvedConfig } from './index-Duvi2T7H.cjs';
 export { createVitePlugin } from './helpers/unplugin.cjs';
 import 'vite';
 import '@stryke/env/get-env-paths';
 import '@stryke/types/base';
 import '@stryke/types/package-json';
 import 'jiti';
+import 'magic-string';
 import 'semver';
+import 'ts-morph';
 import 'unplugin';
 import '@storm-software/build-tools/types';
 import '@storm-software/config-tools/types';
 import '@storm-software/config/types';
 import '@stryke/types/configuration';
 import '@stryke/types/file';
+import '@stryke/fs/resolve';
 import 'node:fs';
 import '@stryke/types/array';
 import '@stryke/types/tsconfig';

package/dist/index.d.ts

@@ -1,18 +1,21 @@
-import { V as VitePluginContext, a as VitePluginOptions, P as Plugin } from './index-B7E0WZU6.js';
-export { b as VitePluginResolvedConfig, d as __ΩVitePluginContext, _ as __ΩVitePluginOptions, c as __ΩVitePluginResolvedConfig } from './index-B7E0WZU6.js';
+import { V as VitePluginContext, a as VitePluginOptions, P as Plugin } from './index-Duvi2T7H.js';
+export { b as VitePluginResolvedConfig, d as __ΩVitePluginContext, _ as __ΩVitePluginOptions, c as __ΩVitePluginResolvedConfig } from './index-Duvi2T7H.js';
 export { createVitePlugin } from './helpers/unplugin.js';
 import 'vite';
 import '@stryke/env/get-env-paths';
 import '@stryke/types/base';
 import '@stryke/types/package-json';
 import 'jiti';
+import 'magic-string';
 import 'semver';
+import 'ts-morph';
 import 'unplugin';
 import '@storm-software/build-tools/types';
 import '@storm-software/config-tools/types';
 import '@storm-software/config/types';
 import '@stryke/types/configuration';
 import '@stryke/types/file';
+import '@stryke/fs/resolve';
 import 'node:fs';
 import '@stryke/types/array';
 import '@stryke/types/tsconfig';

package/dist/types/index.d.cts

@@ -1,16 +1,19 @@
-export { V as VitePluginContext, a as VitePluginOptions, b as VitePluginResolvedConfig, d as __ΩVitePluginContext, _ as __ΩVitePluginOptions, c as __ΩVitePluginResolvedConfig } from '../index-B7E0WZU6.cjs';
+export { V as VitePluginContext, a as VitePluginOptions, b as VitePluginResolvedConfig, d as __ΩVitePluginContext, _ as __ΩVitePluginOptions, c as __ΩVitePluginResolvedConfig } from '../index-Duvi2T7H.cjs';
 import 'vite';
 import '@stryke/env/get-env-paths';
 import '@stryke/types/base';
 import '@stryke/types/package-json';
 import 'jiti';
+import 'magic-string';
 import 'semver';
+import 'ts-morph';
 import 'unplugin';
 import '@storm-software/build-tools/types';
 import '@storm-software/config-tools/types';
 import '@storm-software/config/types';
 import '@stryke/types/configuration';
 import '@stryke/types/file';
+import '@stryke/fs/resolve';
 import 'node:fs';
 import '@stryke/types/array';
 import '@stryke/types/tsconfig';

package/dist/types/index.d.ts

@@ -1,16 +1,19 @@
-export { V as VitePluginContext, a as VitePluginOptions, b as VitePluginResolvedConfig, d as __ΩVitePluginContext, _ as __ΩVitePluginOptions, c as __ΩVitePluginResolvedConfig } from '../index-B7E0WZU6.js';
+export { V as VitePluginContext, a as VitePluginOptions, b as VitePluginResolvedConfig, d as __ΩVitePluginContext, _ as __ΩVitePluginOptions, c as __ΩVitePluginResolvedConfig } from '../index-Duvi2T7H.js';
 import 'vite';
 import '@stryke/env/get-env-paths';
 import '@stryke/types/base';
 import '@stryke/types/package-json';
 import 'jiti';
+import 'magic-string';
 import 'semver';
+import 'ts-morph';
 import 'unplugin';
 import '@storm-software/build-tools/types';
 import '@storm-software/config-tools/types';
 import '@storm-software/config/types';
 import '@stryke/types/configuration';
 import '@stryke/types/file';
+import '@stryke/fs/resolve';
 import 'node:fs';
 import '@stryke/types/array';
 import '@stryke/types/tsconfig';

package/dist/types/plugin.d.cts

@@ -1,16 +1,19 @@
-export { V as VitePluginContext, a as VitePluginOptions, b as VitePluginResolvedConfig, d as __ΩVitePluginContext, _ as __ΩVitePluginOptions, c as __ΩVitePluginResolvedConfig } from '../index-B7E0WZU6.cjs';
+export { V as VitePluginContext, a as VitePluginOptions, b as VitePluginResolvedConfig, d as __ΩVitePluginContext, _ as __ΩVitePluginOptions, c as __ΩVitePluginResolvedConfig } from '../index-Duvi2T7H.cjs';
 import 'vite';
 import '@stryke/env/get-env-paths';
 import '@stryke/types/base';
 import '@stryke/types/package-json';
 import 'jiti';
+import 'magic-string';
 import 'semver';
+import 'ts-morph';
 import 'unplugin';
 import '@storm-software/build-tools/types';
 import '@storm-software/config-tools/types';
 import '@storm-software/config/types';
 import '@stryke/types/configuration';
 import '@stryke/types/file';
+import '@stryke/fs/resolve';
 import 'node:fs';
 import '@stryke/types/array';
 import '@stryke/types/tsconfig';

package/dist/types/plugin.d.ts

@@ -1,16 +1,19 @@
-export { V as VitePluginContext, a as VitePluginOptions, b as VitePluginResolvedConfig, d as __ΩVitePluginContext, _ as __ΩVitePluginOptions, c as __ΩVitePluginResolvedConfig } from '../index-B7E0WZU6.js';
+export { V as VitePluginContext, a as VitePluginOptions, b as VitePluginResolvedConfig, d as __ΩVitePluginContext, _ as __ΩVitePluginOptions, c as __ΩVitePluginResolvedConfig } from '../index-Duvi2T7H.js';
 import 'vite';
 import '@stryke/env/get-env-paths';
 import '@stryke/types/base';
 import '@stryke/types/package-json';
 import 'jiti';
+import 'magic-string';
 import 'semver';
+import 'ts-morph';
 import 'unplugin';
 import '@storm-software/build-tools/types';
 import '@storm-software/config-tools/types';
 import '@storm-software/config/types';
 import '@stryke/types/configuration';
 import '@stryke/types/file';
+import '@stryke/fs/resolve';
 import 'node:fs';
 import '@stryke/types/array';
 import '@stryke/types/tsconfig';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@powerlines/plugin-vite",
-  "version": "0.14.27",
+  "version": "0.14.28",
   "type": "module",
   "description": "A package containing a Powerlines plugin to assist in developing other Powerlines plugins.",
   "repository": {
@@ -132,21 +132,21 @@
     "rolldown-vite": { "optional": true }
   },
   "dependencies": {
-    "@stryke/fs": "^0.32.13",
-    "@stryke/path": "^0.19.2",
-    "@stryke/type-checks": "^0.3.12",
-    "@stryke/types": "^0.10.2",
+    "@stryke/fs": "^0.33.0",
+    "@stryke/path": "^0.20.0",
+    "@stryke/type-checks": "^0.3.15",
+    "@stryke/types": "^0.10.5",
     "defu": "^6.1.4",
     "jiti": "^2.6.1",
-    "powerlines": "^0.23.10"
+    "powerlines": "^0.24.0"
   },
   "devDependencies": {
     "vite": "^7.2.4",
     "rolldown-vite": "^7.2.7",
-    "@powerlines/nx": "^0.10.27",
-    "@powerlines/plugin-plugin": "^0.11.35",
+    "@powerlines/nx": "^0.10.28",
+    "@powerlines/plugin-plugin": "^0.11.36",
     "@types/node": "^24.10.1"
   },
   "publishConfig": { "access": "public" },
-  "gitHead": "5a6b8349dc29bf9e496ed5dee32c6cfb8d9bff4e"
+  "gitHead": "73acce2067b9d81822a59cb03a4b1e7fa8873bf9"
 }