powerlines 0.23.10 → 0.24.1

package/dist/lib/{config-7Q2dBjJE.d.ts → config-DBIFdRoq.d.ts}

@@ -20,8 +20,10 @@ import { Worker } from 'jest-worker';
 import { Jiti } from 'jiti';
 import MagicString, { SourceMap } from 'magic-string';
 import { Range } from 'semver';
+import { Project } from 'ts-morph';
 import { TransformResult as TransformResult$1, ExternalIdResult, HookFilter, UnpluginOptions, UnpluginContext, UnpluginMessage, UnpluginBuildContext } from 'unplugin';
-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 { P as ParsedTypeScriptConfig, T as TSConfig } from './tsconfig-Bz-CiFqD.js';
 
@@ -112,21 +114,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 {
     /**
@@ -140,27 +148,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).
      *
@@ -188,7 +202,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).
      *
@@ -261,7 +275,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).
      *
@@ -275,7 +289,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).
      *
@@ -283,7 +297,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).
      *
@@ -291,14 +305,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).
      *
@@ -306,7 +320,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).
      *
@@ -314,7 +328,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).
      *
@@ -336,7 +350,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).
      *
@@ -344,7 +358,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).
      *
@@ -391,24 +405,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.
      */
@@ -1123,6 +1156,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
      */
@@ -1657,4 +1731,4 @@ type DeployInlineConfig<TUserConfig extends UserConfig = UserConfig> = InlineCon
     command: "deploy";
 };
 
-export { type BuildInlineConfig as $, type APIContext as A, type InferHookReturnType as B, type Context as C, type UnpluginBuildVariant as D, type ESBuildResolvedBuildConfig as E, type InferResolvedConfig as F, type InferUnpluginVariant as G, type HooksList as H, type InitialUserConfig as I, type BuildPlugin as J, type InferUserConfig as K, type LogFn as L, type MakeDirectoryOptions as M, type SourceFile as N, type TransformResult as O, type PowerlinesCommand as P, type WorkerProcess as Q, type ResolvePathOptions as R, type SelectHooksOptions as S, type TsupBuildConfig as T, type UnbuildBuildConfig as U, type VirtualFileSystemInterface as V, type WriteFileData as W, type PrepareInlineConfig as X, type NewInlineConfig as Y, type CleanInlineConfig as Z, __VFS_PATCH__ as _, type VirtualFileMetadata as a, type LintInlineConfig as a0, type DocsInlineConfig as a1, type DeployInlineConfig as a2, type ResolveFSOptions as b, type WriteFileOptions as c, __VFS_REVERT__ as d, type WorkspaceConfig as e, type ParsedUserConfig as f, type ResolvedEntryTypeDefinition as g, type RolldownResolvedBuildConfig as h, type RollupResolvedBuildConfig as i, type TsupResolvedBuildConfig as j, type UnbuildResolvedBuildConfig as k, type ViteResolvedBuildConfig as l, type ResolvedConfig as m, type EnvironmentContext as n, type Plugin as o, type PluginContext as p, type EnvironmentResolvedConfig as q, type EnvironmentContextPlugin as r, type HookKeys as s, type InferHookHandler as t, type MetaInfo as u, type Resolver as v, type VirtualFile as w, type PowerlinesWriteFileOptions as x, type InitContextOptions as y, type InferHookParameters as z };
+export { type BuildInlineConfig as $, type APIContext as A, type InferHookParameters as B, type Context as C, type InferHookReturnType as D, type ESBuildResolvedBuildConfig as E, type UnpluginBuildVariant as F, type InferResolvedConfig as G, type HooksList as H, type InitialUserConfig as I, type InferUnpluginVariant as J, type BuildPlugin as K, type LogFn as L, type MakeDirectoryOptions as M, type InferUserConfig as N, type SourceFile as O, type PowerlinesCommand as P, type WorkerProcess as Q, type ResolveOptions as R, type SelectHooksOptions as S, type TsupBuildConfig as T, type UnbuildBuildConfig as U, type VirtualFileSystemInterface as V, type WriteFileData as W, type PrepareInlineConfig as X, type NewInlineConfig as Y, type CleanInlineConfig as Z, __VFS_PATCH__ as _, type VirtualFileMetadata as a, type LintInlineConfig as a0, type DocsInlineConfig as a1, type DeployInlineConfig as a2, type ResolveFSOptions as b, type WriteFileOptions as c, __VFS_REVERT__ as d, type WorkspaceConfig as e, type ParsedUserConfig as f, type ResolvedEntryTypeDefinition as g, type RolldownResolvedBuildConfig as h, type RollupResolvedBuildConfig as i, type TsupResolvedBuildConfig as j, type UnbuildResolvedBuildConfig as k, type ViteResolvedBuildConfig as l, type ResolvedConfig as m, type EnvironmentContext as n, type Plugin as o, type PluginContext as p, type EnvironmentResolvedConfig as q, type EnvironmentContextPlugin as r, type HookKeys as s, type InferHookHandler as t, type MetaInfo as u, type Resolver as v, type TransformResult as w, type VirtualFile as x, type PowerlinesWriteFileOptions as y, type InitContextOptions as z };

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

@@ -1,5 +1,5 @@
 import { Jiti } from 'jiti';
-import { C as Context, e as WorkspaceConfig, P as PowerlinesCommand, f as ParsedUserConfig } from './config-BnJpgcGr.cjs';
+import { C as Context, e as WorkspaceConfig, P as PowerlinesCommand, f as ParsedUserConfig } from './config-D8KrE7SZ.cjs';
 import '@storm-software/build-tools/types';
 import '@storm-software/config-tools/types';
 import '@storm-software/config/types';
@@ -21,7 +21,9 @@ import '@stryke/types/package-json';
 import 'jest-worker';
 import 'magic-string';
 import 'semver';
+import 'ts-morph';
 import 'unplugin';
+import '@stryke/fs/resolve';
 import 'node:fs';
 import '@stryke/types/array';
 import './tsconfig-Bz-CiFqD.cjs';

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

@@ -1,5 +1,5 @@
 import { Jiti } from 'jiti';
-import { C as Context, e as WorkspaceConfig, P as PowerlinesCommand, f as ParsedUserConfig } from './config-7Q2dBjJE.js';
+import { C as Context, e as WorkspaceConfig, P as PowerlinesCommand, f as ParsedUserConfig } from './config-DBIFdRoq.js';
 import '@storm-software/build-tools/types';
 import '@storm-software/config-tools/types';
 import '@storm-software/config/types';
@@ -21,7 +21,9 @@ import '@stryke/types/package-json';
 import 'jest-worker';
 import 'magic-string';
 import 'semver';
+import 'ts-morph';
 import 'unplugin';
+import '@stryke/fs/resolve';
 import 'node:fs';
 import '@stryke/types/array';
 import './tsconfig-Bz-CiFqD.js';

package/dist/lib/contexts/api-context.cjs

@@ -1,10 +1,11 @@
 'use strict';
 
-var chunkVLOUSKRX_cjs = require('../chunk-VLOUSKRX.cjs');
-require('../chunk-I6TJUFA6.cjs');
+var chunkVMLQATMA_cjs = require('../chunk-VMLQATMA.cjs');
+require('../chunk-AA6RBP44.cjs');
 require('../chunk-B3EE3VHZ.cjs');
-require('../chunk-QABAD5RE.cjs');
+require('../chunk-RNHKEPFD.cjs');
 require('../chunk-7VJ42H2I.cjs');
+require('../chunk-SAS5EPBD.cjs');
 require('../chunk-K3NBD5LL.cjs');
 require('../chunk-JA4HSQRN.cjs');
 require('../chunk-ISBHXSDH.cjs');
@@ -14,5 +15,5 @@ require('../chunk-USNT2KNT.cjs');
 
 Object.defineProperty(exports, "PowerlinesAPIContext", {
   enumerable: true,
-  get: function () { return chunkVLOUSKRX_cjs.PowerlinesAPIContext; }
+  get: function () { return chunkVMLQATMA_cjs.PowerlinesAPIContext; }
 });

package/dist/lib/contexts/api-context.d.cts

@@ -1,4 +1,4 @@
-import { m as ResolvedConfig, A as APIContext, I as InitialUserConfig, n as EnvironmentContext, L as LogFn, o as Plugin, p as PluginContext, e as WorkspaceConfig, q as EnvironmentResolvedConfig } from '../config-BnJpgcGr.cjs';
+import { m as ResolvedConfig, A as APIContext, I as InitialUserConfig, n as EnvironmentContext, L as LogFn, o as Plugin, p as PluginContext, e as WorkspaceConfig, q as EnvironmentResolvedConfig } from '../config-D8KrE7SZ.cjs';
 import { PowerlinesContext } from './context.cjs';
 import '@storm-software/build-tools/types';
 import '@storm-software/config-tools/types';
@@ -22,14 +22,16 @@ import 'jest-worker';
 import 'jiti';
 import 'magic-string';
 import 'semver';
+import 'ts-morph';
 import 'unplugin';
+import '@stryke/fs/resolve';
 import 'node:fs';
 import '@stryke/types/array';
 import '../tsconfig-Bz-CiFqD.cjs';
 import '@stryke/types/tsconfig';
 import 'typescript';
-import '../internal-BeR8fOB1.cjs';
-import '../api-Cm51oVbC.cjs';
+import '../internal-CaGANOWK.cjs';
+import '../api-BRMITKt-.cjs';
 
 declare class PowerlinesAPIContext<TResolvedConfig extends ResolvedConfig = ResolvedConfig> extends PowerlinesContext<TResolvedConfig> implements APIContext<TResolvedConfig> {
     #private;

package/dist/lib/contexts/api-context.d.ts

@@ -1,4 +1,4 @@
-import { m as ResolvedConfig, A as APIContext, I as InitialUserConfig, n as EnvironmentContext, L as LogFn, o as Plugin, p as PluginContext, e as WorkspaceConfig, q as EnvironmentResolvedConfig } from '../config-7Q2dBjJE.js';
+import { m as ResolvedConfig, A as APIContext, I as InitialUserConfig, n as EnvironmentContext, L as LogFn, o as Plugin, p as PluginContext, e as WorkspaceConfig, q as EnvironmentResolvedConfig } from '../config-DBIFdRoq.js';
 import { PowerlinesContext } from './context.js';
 import '@storm-software/build-tools/types';
 import '@storm-software/config-tools/types';
@@ -22,14 +22,16 @@ import 'jest-worker';
 import 'jiti';
 import 'magic-string';
 import 'semver';
+import 'ts-morph';
 import 'unplugin';
+import '@stryke/fs/resolve';
 import 'node:fs';
 import '@stryke/types/array';
 import '../tsconfig-Bz-CiFqD.js';
 import '@stryke/types/tsconfig';
 import 'typescript';
-import '../internal-BEygquYh.js';
-import '../api-mja4jirh.js';
+import '../internal-1qCyw7bA.js';
+import '../api-CDUN9en8.js';
 
 declare class PowerlinesAPIContext<TResolvedConfig extends ResolvedConfig = ResolvedConfig> extends PowerlinesContext<TResolvedConfig> implements APIContext<TResolvedConfig> {
     #private;

package/dist/lib/contexts/api-context.js

@@ -1,8 +1,9 @@
-export { PowerlinesAPIContext } from '../chunk-HNOAMIRO.js';
-import '../chunk-OJ5XFCZN.js';
+export { PowerlinesAPIContext } from '../chunk-7CVPZOH4.js';
+import '../chunk-DFW5FGEO.js';
 import '../chunk-KFJCWNVG.js';
-import '../chunk-XG4CC73V.js';
+import '../chunk-KFWMKDJQ.js';
 import '../chunk-FQLZZYYO.js';
+import '../chunk-YQ3ODCHV.js';
 import '../chunk-XBM7FHNK.js';
 import '../chunk-ENRLU4UR.js';
 import '../chunk-XZFEHPYE.js';

package/dist/lib/contexts/context.cjs

@@ -1,7 +1,8 @@
 'use strict';
 
-var chunkQABAD5RE_cjs = require('../chunk-QABAD5RE.cjs');
+var chunkRNHKEPFD_cjs = require('../chunk-RNHKEPFD.cjs');
 require('../chunk-7VJ42H2I.cjs');
+require('../chunk-SAS5EPBD.cjs');
 require('../chunk-K3NBD5LL.cjs');
 require('../chunk-JA4HSQRN.cjs');
 require('../chunk-ISBHXSDH.cjs');
@@ -11,5 +12,5 @@ require('../chunk-USNT2KNT.cjs');
 
 Object.defineProperty(exports, "PowerlinesContext", {
   enumerable: true,
-  get: function () { return chunkQABAD5RE_cjs.PowerlinesContext; }
+  get: function () { return chunkRNHKEPFD_cjs.PowerlinesContext; }
 });

package/dist/lib/contexts/context.d.cts

@@ -1,9 +1,10 @@
 import { EnvPaths } from '@stryke/env/get-env-paths';
 import { PackageJson } from '@stryke/types/package-json';
 import { Range } from 'semver';
-import { UnpluginMessage } from 'unplugin';
-import { m as ResolvedConfig, C as Context, I as InitialUserConfig, u as MetaInfo, v as Resolver, g as ResolvedEntryTypeDefinition, V as VirtualFileSystemInterface, L as LogFn, e as WorkspaceConfig, w as VirtualFile, x as PowerlinesWriteFileOptions, y as InitContextOptions } from '../config-BnJpgcGr.cjs';
-import { a as UNSAFE_ContextInternal } from '../internal-BeR8fOB1.cjs';
+import { Project } from 'ts-morph';
+import { ExternalIdResult, UnpluginMessage } from 'unplugin';
+import { m as ResolvedConfig, C as Context, I as InitialUserConfig, u as MetaInfo, v as Resolver, g as ResolvedEntryTypeDefinition, V as VirtualFileSystemInterface, L as LogFn, e as WorkspaceConfig, R as ResolveOptions, w as TransformResult, x as VirtualFile, y as PowerlinesWriteFileOptions, z as InitContextOptions } from '../config-D8KrE7SZ.cjs';
+import { a as UNSAFE_ContextInternal } from '../internal-CaGANOWK.cjs';
 import { P as ParsedTypeScriptConfig } from '../tsconfig-Bz-CiFqD.cjs';
 import '@storm-software/build-tools/types';
 import '@storm-software/config-tools/types';
@@ -24,9 +25,10 @@ import 'webpack';
 import 'jest-worker';
 import 'jiti';
 import 'magic-string';
+import '@stryke/fs/resolve';
 import 'node:fs';
 import '@stryke/types/array';
-import '../api-Cm51oVbC.cjs';
+import '../api-BRMITKt-.cjs';
 import '@stryke/types/tsconfig';
 import 'typescript';
 
@@ -146,6 +148,47 @@ declare class PowerlinesContext<TResolvedConfig extends ResolvedConfig = Resolve
      * The builtin module id that exist in the Powerlines virtual file system
      */
     get 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.
+     */
+    get program(): Project;
+    /**
+     * A helper function to resolve modules in the Virtual File System
+     *
+     * @remarks
+     * This function can be used to resolve modules relative to the project root directory.
+     *
+     * @example
+     * ```ts
+     * const resolved = 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 from the Virtual File System
+     *
+     * @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>;
     /**
      * Get the builtin virtual files that exist in the Powerlines virtual file system
      */

package/dist/lib/contexts/context.d.ts

@@ -1,9 +1,10 @@
 import { EnvPaths } from '@stryke/env/get-env-paths';
 import { PackageJson } from '@stryke/types/package-json';
 import { Range } from 'semver';
-import { UnpluginMessage } from 'unplugin';
-import { m as ResolvedConfig, C as Context, I as InitialUserConfig, u as MetaInfo, v as Resolver, g as ResolvedEntryTypeDefinition, V as VirtualFileSystemInterface, L as LogFn, e as WorkspaceConfig, w as VirtualFile, x as PowerlinesWriteFileOptions, y as InitContextOptions } from '../config-7Q2dBjJE.js';
-import { a as UNSAFE_ContextInternal } from '../internal-BEygquYh.js';
+import { Project } from 'ts-morph';
+import { ExternalIdResult, UnpluginMessage } from 'unplugin';
+import { m as ResolvedConfig, C as Context, I as InitialUserConfig, u as MetaInfo, v as Resolver, g as ResolvedEntryTypeDefinition, V as VirtualFileSystemInterface, L as LogFn, e as WorkspaceConfig, R as ResolveOptions, w as TransformResult, x as VirtualFile, y as PowerlinesWriteFileOptions, z as InitContextOptions } from '../config-DBIFdRoq.js';
+import { a as UNSAFE_ContextInternal } from '../internal-1qCyw7bA.js';
 import { P as ParsedTypeScriptConfig } from '../tsconfig-Bz-CiFqD.js';
 import '@storm-software/build-tools/types';
 import '@storm-software/config-tools/types';
@@ -24,9 +25,10 @@ import 'webpack';
 import 'jest-worker';
 import 'jiti';
 import 'magic-string';
+import '@stryke/fs/resolve';
 import 'node:fs';
 import '@stryke/types/array';
-import '../api-mja4jirh.js';
+import '../api-CDUN9en8.js';
 import '@stryke/types/tsconfig';
 import 'typescript';
 
@@ -146,6 +148,47 @@ declare class PowerlinesContext<TResolvedConfig extends ResolvedConfig = Resolve
      * The builtin module id that exist in the Powerlines virtual file system
      */
     get 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.
+     */
+    get program(): Project;
+    /**
+     * A helper function to resolve modules in the Virtual File System
+     *
+     * @remarks
+     * This function can be used to resolve modules relative to the project root directory.
+     *
+     * @example
+     * ```ts
+     * const resolved = 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 from the Virtual File System
+     *
+     * @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>;
     /**
      * Get the builtin virtual files that exist in the Powerlines virtual file system
      */

package/dist/lib/contexts/context.js

@@ -1,5 +1,6 @@
-export { PowerlinesContext } from '../chunk-XG4CC73V.js';
+export { PowerlinesContext } from '../chunk-KFWMKDJQ.js';
 import '../chunk-FQLZZYYO.js';
+import '../chunk-YQ3ODCHV.js';
 import '../chunk-XBM7FHNK.js';
 import '../chunk-ENRLU4UR.js';
 import '../chunk-XZFEHPYE.js';

package/dist/lib/contexts/environment-context.cjs

@@ -1,9 +1,10 @@
 'use strict';
 
-var chunkI6TJUFA6_cjs = require('../chunk-I6TJUFA6.cjs');
+var chunkAA6RBP44_cjs = require('../chunk-AA6RBP44.cjs');
 require('../chunk-B3EE3VHZ.cjs');
-require('../chunk-QABAD5RE.cjs');
+require('../chunk-RNHKEPFD.cjs');
 require('../chunk-7VJ42H2I.cjs');
+require('../chunk-SAS5EPBD.cjs');
 require('../chunk-K3NBD5LL.cjs');
 require('../chunk-JA4HSQRN.cjs');
 require('../chunk-ISBHXSDH.cjs');
@@ -13,5 +14,5 @@ require('../chunk-USNT2KNT.cjs');
 
 Object.defineProperty(exports, "PowerlinesEnvironmentContext", {
   enumerable: true,
-  get: function () { return chunkI6TJUFA6_cjs.PowerlinesEnvironmentContext; }
+  get: function () { return chunkAA6RBP44_cjs.PowerlinesEnvironmentContext; }
 });

package/dist/lib/contexts/environment-context.d.cts

@@ -1,4 +1,4 @@
-import { m as ResolvedConfig, n as EnvironmentContext, e as WorkspaceConfig, q as EnvironmentResolvedConfig, r as EnvironmentContextPlugin, H as HooksList, p as PluginContext, o as Plugin, s as HookKeys, S as SelectHooksOptions, t as InferHookHandler } from '../config-BnJpgcGr.cjs';
+import { m as ResolvedConfig, n as EnvironmentContext, e as WorkspaceConfig, q as EnvironmentResolvedConfig, r as EnvironmentContextPlugin, H as HooksList, p as PluginContext, o as Plugin, s as HookKeys, S as SelectHooksOptions, t as InferHookHandler } from '../config-D8KrE7SZ.cjs';
 import { PowerlinesContext } from './context.cjs';
 import '@storm-software/build-tools/types';
 import '@storm-software/config-tools/types';
@@ -22,14 +22,16 @@ import 'jest-worker';
 import 'jiti';
 import 'magic-string';
 import 'semver';
+import 'ts-morph';
 import 'unplugin';
+import '@stryke/fs/resolve';
 import 'node:fs';
 import '@stryke/types/array';
 import '../tsconfig-Bz-CiFqD.cjs';
 import '@stryke/types/tsconfig';
 import 'typescript';
-import '../internal-BeR8fOB1.cjs';
-import '../api-Cm51oVbC.cjs';
+import '../internal-CaGANOWK.cjs';
+import '../api-BRMITKt-.cjs';
 
 declare class PowerlinesEnvironmentContext<TResolvedConfig extends ResolvedConfig = ResolvedConfig> extends PowerlinesContext<TResolvedConfig> implements EnvironmentContext<TResolvedConfig> {
     #private;