@powerlines/plugin-unbuild 0.5.36 → 0.5.38

package/dist/{index-DJ4XjbiZ.d.cts → index-CLa0ll-K.d.cts}

@@ -3,15 +3,18 @@ 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 { PreviewOptions, ResolvedPreviewOptions } from 'vite';
-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';
@@ -241,21 +244,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 {
     /**
@@ -269,27 +278,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).
      *
@@ -317,7 +332,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).
      *
@@ -390,7 +405,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).
      *
@@ -404,7 +419,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).
      *
@@ -412,7 +427,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).
      *
@@ -420,14 +435,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).
      *
@@ -435,7 +450,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).
      *
@@ -443,7 +458,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).
      *
@@ -465,7 +480,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).
      *
@@ -473,7 +488,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).
      *
@@ -520,24 +535,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.
      */
@@ -1011,6 +1045,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.
@@ -1145,6 +1183,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
      */
@@ -1314,7 +1393,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.
      *
@@ -1322,7 +1401,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.
      *
@@ -1372,7 +1451,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.
      *
@@ -1380,7 +1459,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-DJ4XjbiZ.d.ts → index-CLa0ll-K.d.ts}

@@ -3,15 +3,18 @@ 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 { PreviewOptions, ResolvedPreviewOptions } from 'vite';
-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';
@@ -241,21 +244,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 {
     /**
@@ -269,27 +278,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).
      *
@@ -317,7 +332,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).
      *
@@ -390,7 +405,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).
      *
@@ -404,7 +419,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).
      *
@@ -412,7 +427,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).
      *
@@ -420,14 +435,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).
      *
@@ -435,7 +450,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).
      *
@@ -443,7 +458,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).
      *
@@ -465,7 +480,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).
      *
@@ -473,7 +488,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).
      *
@@ -520,24 +535,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.
      */
@@ -1011,6 +1045,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.
@@ -1145,6 +1183,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
      */
@@ -1314,7 +1393,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.
      *
@@ -1322,7 +1401,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.
      *
@@ -1372,7 +1451,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.
      *
@@ -1380,7 +1459,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,11 +1,13 @@
-import { U as UnbuildPluginContext, a as UnbuildPluginOptions, P as Plugin } from './index-DJ4XjbiZ.cjs';
-export { b as UnbuildPluginResolvedConfig, d as __ΩUnbuildPluginContext, _ as __ΩUnbuildPluginOptions, c as __ΩUnbuildPluginResolvedConfig } from './index-DJ4XjbiZ.cjs';
+import { U as UnbuildPluginContext, a as UnbuildPluginOptions, P as Plugin } from './index-CLa0ll-K.cjs';
+export { b as UnbuildPluginResolvedConfig, d as __ΩUnbuildPluginContext, _ as __ΩUnbuildPluginOptions, c as __ΩUnbuildPluginResolvedConfig } from './index-CLa0ll-K.cjs';
 import '@storm-software/unbuild/types';
 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';
@@ -13,6 +15,7 @@ import '@storm-software/config/types';
 import '@stryke/types/configuration';
 import '@stryke/types/file';
 import 'vite';
+import '@stryke/fs/resolve';
 import 'node:fs';
 import '@stryke/types/array';
 import '@stryke/types/tsconfig';

package/dist/index.d.ts

@@ -1,11 +1,13 @@
-import { U as UnbuildPluginContext, a as UnbuildPluginOptions, P as Plugin } from './index-DJ4XjbiZ.js';
-export { b as UnbuildPluginResolvedConfig, d as __ΩUnbuildPluginContext, _ as __ΩUnbuildPluginOptions, c as __ΩUnbuildPluginResolvedConfig } from './index-DJ4XjbiZ.js';
+import { U as UnbuildPluginContext, a as UnbuildPluginOptions, P as Plugin } from './index-CLa0ll-K.js';
+export { b as UnbuildPluginResolvedConfig, d as __ΩUnbuildPluginContext, _ as __ΩUnbuildPluginOptions, c as __ΩUnbuildPluginResolvedConfig } from './index-CLa0ll-K.js';
 import '@storm-software/unbuild/types';
 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';
@@ -13,6 +15,7 @@ import '@storm-software/config/types';
 import '@stryke/types/configuration';
 import '@stryke/types/file';
 import 'vite';
+import '@stryke/fs/resolve';
 import 'node:fs';
 import '@stryke/types/array';
 import '@stryke/types/tsconfig';

package/dist/types/index.d.cts

@@ -1,10 +1,12 @@
-export { U as UnbuildPluginContext, a as UnbuildPluginOptions, b as UnbuildPluginResolvedConfig, d as __ΩUnbuildPluginContext, _ as __ΩUnbuildPluginOptions, c as __ΩUnbuildPluginResolvedConfig } from '../index-DJ4XjbiZ.cjs';
+export { U as UnbuildPluginContext, a as UnbuildPluginOptions, b as UnbuildPluginResolvedConfig, d as __ΩUnbuildPluginContext, _ as __ΩUnbuildPluginOptions, c as __ΩUnbuildPluginResolvedConfig } from '../index-CLa0ll-K.cjs';
 import '@storm-software/unbuild/types';
 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';
@@ -12,6 +14,7 @@ import '@storm-software/config/types';
 import '@stryke/types/configuration';
 import '@stryke/types/file';
 import 'vite';
+import '@stryke/fs/resolve';
 import 'node:fs';
 import '@stryke/types/array';
 import '@stryke/types/tsconfig';

package/dist/types/index.d.ts

@@ -1,10 +1,12 @@
-export { U as UnbuildPluginContext, a as UnbuildPluginOptions, b as UnbuildPluginResolvedConfig, d as __ΩUnbuildPluginContext, _ as __ΩUnbuildPluginOptions, c as __ΩUnbuildPluginResolvedConfig } from '../index-DJ4XjbiZ.js';
+export { U as UnbuildPluginContext, a as UnbuildPluginOptions, b as UnbuildPluginResolvedConfig, d as __ΩUnbuildPluginContext, _ as __ΩUnbuildPluginOptions, c as __ΩUnbuildPluginResolvedConfig } from '../index-CLa0ll-K.js';
 import '@storm-software/unbuild/types';
 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';
@@ -12,6 +14,7 @@ import '@storm-software/config/types';
 import '@stryke/types/configuration';
 import '@stryke/types/file';
 import 'vite';
+import '@stryke/fs/resolve';
 import 'node:fs';
 import '@stryke/types/array';
 import '@stryke/types/tsconfig';

package/dist/types/plugin.d.cts

@@ -1,10 +1,12 @@
-export { U as UnbuildPluginContext, a as UnbuildPluginOptions, b as UnbuildPluginResolvedConfig, d as __ΩUnbuildPluginContext, _ as __ΩUnbuildPluginOptions, c as __ΩUnbuildPluginResolvedConfig } from '../index-DJ4XjbiZ.cjs';
+export { U as UnbuildPluginContext, a as UnbuildPluginOptions, b as UnbuildPluginResolvedConfig, d as __ΩUnbuildPluginContext, _ as __ΩUnbuildPluginOptions, c as __ΩUnbuildPluginResolvedConfig } from '../index-CLa0ll-K.cjs';
 import '@storm-software/unbuild/types';
 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';
@@ -12,6 +14,7 @@ import '@storm-software/config/types';
 import '@stryke/types/configuration';
 import '@stryke/types/file';
 import 'vite';
+import '@stryke/fs/resolve';
 import 'node:fs';
 import '@stryke/types/array';
 import '@stryke/types/tsconfig';

package/dist/types/plugin.d.ts

@@ -1,10 +1,12 @@
-export { U as UnbuildPluginContext, a as UnbuildPluginOptions, b as UnbuildPluginResolvedConfig, d as __ΩUnbuildPluginContext, _ as __ΩUnbuildPluginOptions, c as __ΩUnbuildPluginResolvedConfig } from '../index-DJ4XjbiZ.js';
+export { U as UnbuildPluginContext, a as UnbuildPluginOptions, b as UnbuildPluginResolvedConfig, d as __ΩUnbuildPluginContext, _ as __ΩUnbuildPluginOptions, c as __ΩUnbuildPluginResolvedConfig } from '../index-CLa0ll-K.js';
 import '@storm-software/unbuild/types';
 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';
@@ -12,6 +14,7 @@ import '@storm-software/config/types';
 import '@stryke/types/configuration';
 import '@stryke/types/file';
 import 'vite';
+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-unbuild",
-  "version": "0.5.36",
+  "version": "0.5.38",
   "type": "module",
   "description": "A package containing a Powerlines plugin to build projects using Unbuild.",
   "repository": {
@@ -128,20 +128,20 @@
   "keywords": ["unbuild", "powerlines", "storm-software", "powerlines-plugin"],
   "dependencies": {
     "@storm-software/unbuild": "^0.57.48",
-    "@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.1",
     "unplugin": "^2.3.10"
   },
   "devDependencies": {
-    "@powerlines/nx": "^0.10.27",
-    "@powerlines/plugin-plugin": "^0.11.35",
+    "@powerlines/nx": "^0.10.29",
+    "@powerlines/plugin-plugin": "^0.11.37",
     "@types/node": "^24.10.1"
   },
   "publishConfig": { "access": "public" },
-  "gitHead": "5a6b8349dc29bf9e496ed5dee32c6cfb8d9bff4e"
+  "gitHead": "424d900c34fbbdf943895648419a6467d8eb4a8d"
 }