@powerlines/plugin-pulumi 0.2.6 → 0.2.7

package/dist/{index-DrS7lbM7.d.cts → index-CBY94ymB.d.cts}

@@ -9,9 +9,12 @@ import { PreviewOptions, ResolvedPreviewOptions } from 'vite';
 import { EnvPaths } from '@stryke/env/get-env-paths';
 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 { PathLike, StatSyncOptions, Stats, RmDirOptions, RmOptions, Mode, MakeDirectoryOptions as MakeDirectoryOptions$1, PathOrFileDescriptor, WriteFileOptions as WriteFileOptions$1 } from 'node:fs';
+import { Project } from 'ts-morph';
+import { UnpluginMessage, ExternalIdResult, UnpluginContext, UnpluginBuildContext, TransformResult as TransformResult$1, HookFilter, UnpluginOptions } from 'unplugin';
+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 { TsConfigJson, CompilerOptions } from '@stryke/types/tsconfig';
 import ts from 'typescript';
 import { ArrayValues } from '@stryke/types/array';
@@ -239,21 +242,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 {
     /**
@@ -267,27 +276,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).
      *
@@ -315,7 +330,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).
      *
@@ -388,7 +403,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).
      *
@@ -402,7 +417,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).
      *
@@ -410,7 +425,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).
      *
@@ -418,14 +433,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).
      *
@@ -433,7 +448,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).
      *
@@ -441,7 +456,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).
      *
@@ -463,7 +478,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).
      *
@@ -471,7 +486,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).
      *
@@ -518,24 +533,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.
      */
@@ -1007,6 +1041,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.
@@ -1141,6 +1179,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
      */
@@ -1310,7 +1389,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.
      *
@@ -1318,7 +1397,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.
      *
@@ -1368,7 +1447,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.
      *
@@ -1376,7 +1455,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-DrS7lbM7.d.ts → index-CBY94ymB.d.ts}

@@ -9,9 +9,12 @@ import { PreviewOptions, ResolvedPreviewOptions } from 'vite';
 import { EnvPaths } from '@stryke/env/get-env-paths';
 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 { PathLike, StatSyncOptions, Stats, RmDirOptions, RmOptions, Mode, MakeDirectoryOptions as MakeDirectoryOptions$1, PathOrFileDescriptor, WriteFileOptions as WriteFileOptions$1 } from 'node:fs';
+import { Project } from 'ts-morph';
+import { UnpluginMessage, ExternalIdResult, UnpluginContext, UnpluginBuildContext, TransformResult as TransformResult$1, HookFilter, UnpluginOptions } from 'unplugin';
+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 { TsConfigJson, CompilerOptions } from '@stryke/types/tsconfig';
 import ts from 'typescript';
 import { ArrayValues } from '@stryke/types/array';
@@ -239,21 +242,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 {
     /**
@@ -267,27 +276,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).
      *
@@ -315,7 +330,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).
      *
@@ -388,7 +403,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).
      *
@@ -402,7 +417,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).
      *
@@ -410,7 +425,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).
      *
@@ -418,14 +433,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).
      *
@@ -433,7 +448,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).
      *
@@ -441,7 +456,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).
      *
@@ -463,7 +478,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).
      *
@@ -471,7 +486,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).
      *
@@ -518,24 +533,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.
      */
@@ -1007,6 +1041,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.
@@ -1141,6 +1179,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
      */
@@ -1310,7 +1389,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.
      *
@@ -1318,7 +1397,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.
      *
@@ -1368,7 +1447,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.
      *
@@ -1376,7 +1455,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,5 +1,5 @@
-import { P as PulumiPluginContext, a as PulumiPluginOptions, b as Plugin } from './index-DrS7lbM7.cjs';
-export { c as PulumiPluginBaseOptions, f as PulumiPluginCreateStackInlineOptions, g as PulumiPluginCreateStackLocalOptions, e as PulumiPluginCreateStackOptions, d as PulumiPluginExistingStackOptions, j as PulumiPluginResolvedConfig, h as PulumiPluginResolvedOptions, i as PulumiPluginUserConfig, _ as __ΩPulumiPluginBaseOptions, s as __ΩPulumiPluginContext, m as __ΩPulumiPluginCreateStackInlineOptions, n as __ΩPulumiPluginCreateStackLocalOptions, l as __ΩPulumiPluginCreateStackOptions, k as __ΩPulumiPluginExistingStackOptions, o as __ΩPulumiPluginOptions, r as __ΩPulumiPluginResolvedConfig, p as __ΩPulumiPluginResolvedOptions, q as __ΩPulumiPluginUserConfig } from './index-DrS7lbM7.cjs';
+import { P as PulumiPluginContext, a as PulumiPluginOptions, b as Plugin } from './index-CBY94ymB.cjs';
+export { c as PulumiPluginBaseOptions, f as PulumiPluginCreateStackInlineOptions, g as PulumiPluginCreateStackLocalOptions, e as PulumiPluginCreateStackOptions, d as PulumiPluginExistingStackOptions, j as PulumiPluginResolvedConfig, h as PulumiPluginResolvedOptions, i as PulumiPluginUserConfig, _ as __ΩPulumiPluginBaseOptions, s as __ΩPulumiPluginContext, m as __ΩPulumiPluginCreateStackInlineOptions, n as __ΩPulumiPluginCreateStackLocalOptions, l as __ΩPulumiPluginCreateStackOptions, k as __ΩPulumiPluginExistingStackOptions, o as __ΩPulumiPluginOptions, r as __ΩPulumiPluginResolvedConfig, p as __ΩPulumiPluginResolvedOptions, q as __ΩPulumiPluginUserConfig } from './index-CBY94ymB.cjs';
 import '@pulumi/pulumi/automation';
 import '@storm-software/build-tools/types';
 import '@storm-software/config-tools/types';
@@ -11,8 +11,11 @@ import 'vite';
 import '@stryke/env/get-env-paths';
 import '@stryke/types/package-json';
 import 'jiti';
+import 'magic-string';
 import 'semver';
+import 'ts-morph';
 import 'unplugin';
+import '@stryke/fs/resolve';
 import 'node:fs';
 import '@stryke/types/tsconfig';
 import 'typescript';

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { P as PulumiPluginContext, a as PulumiPluginOptions, b as Plugin } from './index-DrS7lbM7.js';
-export { c as PulumiPluginBaseOptions, f as PulumiPluginCreateStackInlineOptions, g as PulumiPluginCreateStackLocalOptions, e as PulumiPluginCreateStackOptions, d as PulumiPluginExistingStackOptions, j as PulumiPluginResolvedConfig, h as PulumiPluginResolvedOptions, i as PulumiPluginUserConfig, _ as __ΩPulumiPluginBaseOptions, s as __ΩPulumiPluginContext, m as __ΩPulumiPluginCreateStackInlineOptions, n as __ΩPulumiPluginCreateStackLocalOptions, l as __ΩPulumiPluginCreateStackOptions, k as __ΩPulumiPluginExistingStackOptions, o as __ΩPulumiPluginOptions, r as __ΩPulumiPluginResolvedConfig, p as __ΩPulumiPluginResolvedOptions, q as __ΩPulumiPluginUserConfig } from './index-DrS7lbM7.js';
+import { P as PulumiPluginContext, a as PulumiPluginOptions, b as Plugin } from './index-CBY94ymB.js';
+export { c as PulumiPluginBaseOptions, f as PulumiPluginCreateStackInlineOptions, g as PulumiPluginCreateStackLocalOptions, e as PulumiPluginCreateStackOptions, d as PulumiPluginExistingStackOptions, j as PulumiPluginResolvedConfig, h as PulumiPluginResolvedOptions, i as PulumiPluginUserConfig, _ as __ΩPulumiPluginBaseOptions, s as __ΩPulumiPluginContext, m as __ΩPulumiPluginCreateStackInlineOptions, n as __ΩPulumiPluginCreateStackLocalOptions, l as __ΩPulumiPluginCreateStackOptions, k as __ΩPulumiPluginExistingStackOptions, o as __ΩPulumiPluginOptions, r as __ΩPulumiPluginResolvedConfig, p as __ΩPulumiPluginResolvedOptions, q as __ΩPulumiPluginUserConfig } from './index-CBY94ymB.js';
 import '@pulumi/pulumi/automation';
 import '@storm-software/build-tools/types';
 import '@storm-software/config-tools/types';
@@ -11,8 +11,11 @@ import 'vite';
 import '@stryke/env/get-env-paths';
 import '@stryke/types/package-json';
 import 'jiti';
+import 'magic-string';
 import 'semver';
+import 'ts-morph';
 import 'unplugin';
+import '@stryke/fs/resolve';
 import 'node:fs';
 import '@stryke/types/tsconfig';
 import 'typescript';

package/dist/types/index.d.cts

@@ -1,4 +1,4 @@
-export { c as PulumiPluginBaseOptions, P as PulumiPluginContext, f as PulumiPluginCreateStackInlineOptions, g as PulumiPluginCreateStackLocalOptions, e as PulumiPluginCreateStackOptions, d as PulumiPluginExistingStackOptions, a as PulumiPluginOptions, j as PulumiPluginResolvedConfig, h as PulumiPluginResolvedOptions, i as PulumiPluginUserConfig, _ as __ΩPulumiPluginBaseOptions, s as __ΩPulumiPluginContext, m as __ΩPulumiPluginCreateStackInlineOptions, n as __ΩPulumiPluginCreateStackLocalOptions, l as __ΩPulumiPluginCreateStackOptions, k as __ΩPulumiPluginExistingStackOptions, o as __ΩPulumiPluginOptions, r as __ΩPulumiPluginResolvedConfig, p as __ΩPulumiPluginResolvedOptions, q as __ΩPulumiPluginUserConfig } from '../index-DrS7lbM7.cjs';
+export { c as PulumiPluginBaseOptions, P as PulumiPluginContext, f as PulumiPluginCreateStackInlineOptions, g as PulumiPluginCreateStackLocalOptions, e as PulumiPluginCreateStackOptions, d as PulumiPluginExistingStackOptions, a as PulumiPluginOptions, j as PulumiPluginResolvedConfig, h as PulumiPluginResolvedOptions, i as PulumiPluginUserConfig, _ as __ΩPulumiPluginBaseOptions, s as __ΩPulumiPluginContext, m as __ΩPulumiPluginCreateStackInlineOptions, n as __ΩPulumiPluginCreateStackLocalOptions, l as __ΩPulumiPluginCreateStackOptions, k as __ΩPulumiPluginExistingStackOptions, o as __ΩPulumiPluginOptions, r as __ΩPulumiPluginResolvedConfig, p as __ΩPulumiPluginResolvedOptions, q as __ΩPulumiPluginUserConfig } from '../index-CBY94ymB.cjs';
 import '@pulumi/pulumi/automation';
 import '@storm-software/build-tools/types';
 import '@storm-software/config-tools/types';
@@ -10,8 +10,11 @@ import 'vite';
 import '@stryke/env/get-env-paths';
 import '@stryke/types/package-json';
 import 'jiti';
+import 'magic-string';
 import 'semver';
+import 'ts-morph';
 import 'unplugin';
+import '@stryke/fs/resolve';
 import 'node:fs';
 import '@stryke/types/tsconfig';
 import 'typescript';

package/dist/types/index.d.ts

@@ -1,4 +1,4 @@
-export { c as PulumiPluginBaseOptions, P as PulumiPluginContext, f as PulumiPluginCreateStackInlineOptions, g as PulumiPluginCreateStackLocalOptions, e as PulumiPluginCreateStackOptions, d as PulumiPluginExistingStackOptions, a as PulumiPluginOptions, j as PulumiPluginResolvedConfig, h as PulumiPluginResolvedOptions, i as PulumiPluginUserConfig, _ as __ΩPulumiPluginBaseOptions, s as __ΩPulumiPluginContext, m as __ΩPulumiPluginCreateStackInlineOptions, n as __ΩPulumiPluginCreateStackLocalOptions, l as __ΩPulumiPluginCreateStackOptions, k as __ΩPulumiPluginExistingStackOptions, o as __ΩPulumiPluginOptions, r as __ΩPulumiPluginResolvedConfig, p as __ΩPulumiPluginResolvedOptions, q as __ΩPulumiPluginUserConfig } from '../index-DrS7lbM7.js';
+export { c as PulumiPluginBaseOptions, P as PulumiPluginContext, f as PulumiPluginCreateStackInlineOptions, g as PulumiPluginCreateStackLocalOptions, e as PulumiPluginCreateStackOptions, d as PulumiPluginExistingStackOptions, a as PulumiPluginOptions, j as PulumiPluginResolvedConfig, h as PulumiPluginResolvedOptions, i as PulumiPluginUserConfig, _ as __ΩPulumiPluginBaseOptions, s as __ΩPulumiPluginContext, m as __ΩPulumiPluginCreateStackInlineOptions, n as __ΩPulumiPluginCreateStackLocalOptions, l as __ΩPulumiPluginCreateStackOptions, k as __ΩPulumiPluginExistingStackOptions, o as __ΩPulumiPluginOptions, r as __ΩPulumiPluginResolvedConfig, p as __ΩPulumiPluginResolvedOptions, q as __ΩPulumiPluginUserConfig } from '../index-CBY94ymB.js';
 import '@pulumi/pulumi/automation';
 import '@storm-software/build-tools/types';
 import '@storm-software/config-tools/types';
@@ -10,8 +10,11 @@ import 'vite';
 import '@stryke/env/get-env-paths';
 import '@stryke/types/package-json';
 import 'jiti';
+import 'magic-string';
 import 'semver';
+import 'ts-morph';
 import 'unplugin';
+import '@stryke/fs/resolve';
 import 'node:fs';
 import '@stryke/types/tsconfig';
 import 'typescript';

package/dist/types/plugin.d.cts

@@ -1,5 +1,5 @@
 import '@pulumi/pulumi/automation';
-export { c as PulumiPluginBaseOptions, P as PulumiPluginContext, f as PulumiPluginCreateStackInlineOptions, g as PulumiPluginCreateStackLocalOptions, e as PulumiPluginCreateStackOptions, d as PulumiPluginExistingStackOptions, a as PulumiPluginOptions, j as PulumiPluginResolvedConfig, h as PulumiPluginResolvedOptions, i as PulumiPluginUserConfig, _ as __ΩPulumiPluginBaseOptions, s as __ΩPulumiPluginContext, m as __ΩPulumiPluginCreateStackInlineOptions, n as __ΩPulumiPluginCreateStackLocalOptions, l as __ΩPulumiPluginCreateStackOptions, k as __ΩPulumiPluginExistingStackOptions, o as __ΩPulumiPluginOptions, r as __ΩPulumiPluginResolvedConfig, p as __ΩPulumiPluginResolvedOptions, q as __ΩPulumiPluginUserConfig } from '../index-DrS7lbM7.cjs';
+export { c as PulumiPluginBaseOptions, P as PulumiPluginContext, f as PulumiPluginCreateStackInlineOptions, g as PulumiPluginCreateStackLocalOptions, e as PulumiPluginCreateStackOptions, d as PulumiPluginExistingStackOptions, a as PulumiPluginOptions, j as PulumiPluginResolvedConfig, h as PulumiPluginResolvedOptions, i as PulumiPluginUserConfig, _ as __ΩPulumiPluginBaseOptions, s as __ΩPulumiPluginContext, m as __ΩPulumiPluginCreateStackInlineOptions, n as __ΩPulumiPluginCreateStackLocalOptions, l as __ΩPulumiPluginCreateStackOptions, k as __ΩPulumiPluginExistingStackOptions, o as __ΩPulumiPluginOptions, r as __ΩPulumiPluginResolvedConfig, p as __ΩPulumiPluginResolvedOptions, q as __ΩPulumiPluginUserConfig } from '../index-CBY94ymB.cjs';
 import '@storm-software/build-tools/types';
 import '@storm-software/config-tools/types';
 import '@storm-software/config/types';
@@ -10,8 +10,11 @@ import 'vite';
 import '@stryke/env/get-env-paths';
 import '@stryke/types/package-json';
 import 'jiti';
+import 'magic-string';
 import 'semver';
+import 'ts-morph';
 import 'unplugin';
+import '@stryke/fs/resolve';
 import 'node:fs';
 import '@stryke/types/tsconfig';
 import 'typescript';

package/dist/types/plugin.d.ts

@@ -1,5 +1,5 @@
 import '@pulumi/pulumi/automation';
-export { c as PulumiPluginBaseOptions, P as PulumiPluginContext, f as PulumiPluginCreateStackInlineOptions, g as PulumiPluginCreateStackLocalOptions, e as PulumiPluginCreateStackOptions, d as PulumiPluginExistingStackOptions, a as PulumiPluginOptions, j as PulumiPluginResolvedConfig, h as PulumiPluginResolvedOptions, i as PulumiPluginUserConfig, _ as __ΩPulumiPluginBaseOptions, s as __ΩPulumiPluginContext, m as __ΩPulumiPluginCreateStackInlineOptions, n as __ΩPulumiPluginCreateStackLocalOptions, l as __ΩPulumiPluginCreateStackOptions, k as __ΩPulumiPluginExistingStackOptions, o as __ΩPulumiPluginOptions, r as __ΩPulumiPluginResolvedConfig, p as __ΩPulumiPluginResolvedOptions, q as __ΩPulumiPluginUserConfig } from '../index-DrS7lbM7.js';
+export { c as PulumiPluginBaseOptions, P as PulumiPluginContext, f as PulumiPluginCreateStackInlineOptions, g as PulumiPluginCreateStackLocalOptions, e as PulumiPluginCreateStackOptions, d as PulumiPluginExistingStackOptions, a as PulumiPluginOptions, j as PulumiPluginResolvedConfig, h as PulumiPluginResolvedOptions, i as PulumiPluginUserConfig, _ as __ΩPulumiPluginBaseOptions, s as __ΩPulumiPluginContext, m as __ΩPulumiPluginCreateStackInlineOptions, n as __ΩPulumiPluginCreateStackLocalOptions, l as __ΩPulumiPluginCreateStackOptions, k as __ΩPulumiPluginExistingStackOptions, o as __ΩPulumiPluginOptions, r as __ΩPulumiPluginResolvedConfig, p as __ΩPulumiPluginResolvedOptions, q as __ΩPulumiPluginUserConfig } from '../index-CBY94ymB.js';
 import '@storm-software/build-tools/types';
 import '@storm-software/config-tools/types';
 import '@storm-software/config/types';
@@ -10,8 +10,11 @@ import 'vite';
 import '@stryke/env/get-env-paths';
 import '@stryke/types/package-json';
 import 'jiti';
+import 'magic-string';
 import 'semver';
+import 'ts-morph';
 import 'unplugin';
+import '@stryke/fs/resolve';
 import 'node:fs';
 import '@stryke/types/tsconfig';
 import 'typescript';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@powerlines/plugin-pulumi",
-  "version": "0.2.6",
+  "version": "0.2.7",
   "type": "module",
   "description": "A Powerlines plugin to transform source code to be platform agnostic using pulumi.",
   "repository": {
@@ -99,21 +99,21 @@
   "files": ["dist/**/*"],
   "keywords": ["pulumi", "powerlines", "storm-software", "powerlines-plugin"],
   "dependencies": {
-    "@stryke/type-checks": "^0.3.12",
-    "@stryke/path": "^0.19.2",
-    "@stryke/fs": "^0.32.13",
-    "@stryke/helpers": "^0.9.4",
-    "@stryke/types": "^0.10.2",
-    "@stryke/string-format": "^0.12.2",
+    "@stryke/type-checks": "^0.3.15",
+    "@stryke/path": "^0.20.0",
+    "@stryke/fs": "^0.33.0",
+    "@stryke/helpers": "^0.9.7",
+    "@stryke/types": "^0.10.5",
+    "@stryke/string-format": "^0.12.5",
     "@pulumi/pulumi": "^3.208.0",
     "defu": "^6.1.4",
-    "powerlines": "^0.23.10",
+    "powerlines": "^0.24.0",
     "typescript": "^5.9.3"
   },
   "devDependencies": {
-    "@powerlines/nx": "^0.10.27",
+    "@powerlines/nx": "^0.10.28",
     "@types/node": "^24.10.1"
   },
   "publishConfig": { "access": "public" },
-  "gitHead": "5a6b8349dc29bf9e496ed5dee32c6cfb8d9bff4e"
+  "gitHead": "73acce2067b9d81822a59cb03a4b1e7fa8873bf9"
 }