@powerlines/plugin-tsc 0.2.35 → 0.2.37

package/dist/helpers/index.d.cts

@@ -1,5 +1,5 @@
 export { typeCheck } from './type-check.cjs';
-import '../plugin-Ds-xu1R1.cjs';
+import '../plugin-ya8wkjpy.cjs';
 import '@stryke/types/base';
 import 'unplugin';
 import '@stryke/types/array';
@@ -12,7 +12,10 @@ import 'vite';
 import '@stryke/env/get-env-paths';
 import '@stryke/types/package-json';
 import 'jiti';
+import 'magic-string';
 import 'semver';
+import 'ts-morph';
+import '@stryke/fs/resolve';
 import 'node:fs';
 import '@stryke/types/tsconfig';
 import 'typescript';

package/dist/helpers/index.d.ts

@@ -1,5 +1,5 @@
 export { typeCheck } from './type-check.js';
-import '../plugin-Ds-xu1R1.js';
+import '../plugin-ya8wkjpy.js';
 import '@stryke/types/base';
 import 'unplugin';
 import '@stryke/types/array';
@@ -12,7 +12,10 @@ import 'vite';
 import '@stryke/env/get-env-paths';
 import '@stryke/types/package-json';
 import 'jiti';
+import 'magic-string';
 import 'semver';
+import 'ts-morph';
+import '@stryke/fs/resolve';
 import 'node:fs';
 import '@stryke/types/tsconfig';
 import 'typescript';

package/dist/helpers/type-check.d.cts

@@ -1,4 +1,4 @@
-import { C as Context } from '../plugin-Ds-xu1R1.cjs';
+import { C as Context } from '../plugin-ya8wkjpy.cjs';
 import '@stryke/types/base';
 import 'unplugin';
 import '@stryke/types/array';
@@ -11,7 +11,10 @@ import 'vite';
 import '@stryke/env/get-env-paths';
 import '@stryke/types/package-json';
 import 'jiti';
+import 'magic-string';
 import 'semver';
+import 'ts-morph';
+import '@stryke/fs/resolve';
 import 'node:fs';
 import '@stryke/types/tsconfig';
 import 'typescript';

package/dist/helpers/type-check.d.ts

@@ -1,4 +1,4 @@
-import { C as Context } from '../plugin-Ds-xu1R1.js';
+import { C as Context } from '../plugin-ya8wkjpy.js';
 import '@stryke/types/base';
 import 'unplugin';
 import '@stryke/types/array';
@@ -11,7 +11,10 @@ import 'vite';
 import '@stryke/env/get-env-paths';
 import '@stryke/types/package-json';
 import 'jiti';
+import 'magic-string';
 import 'semver';
+import 'ts-morph';
+import '@stryke/fs/resolve';
 import 'node:fs';
 import '@stryke/types/tsconfig';
 import 'typescript';

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-import { P as Plugin } from './plugin-Ds-xu1R1.cjs';
+import { P as Plugin } from './plugin-ya8wkjpy.cjs';
 import { TypeScriptCompilerPluginContext, TypeScriptCompilerPluginOptions } from './types/plugin.cjs';
 export { TypeScriptCompilerPluginResolvedConfig, TypeScriptCompilerPluginUserConfig, __ΩTypeScriptCompilerPluginContext, __ΩTypeScriptCompilerPluginOptions, __ΩTypeScriptCompilerPluginResolvedConfig, __ΩTypeScriptCompilerPluginUserConfig } from './types/plugin.cjs';
 export { typeCheck } from './helpers/type-check.cjs';
@@ -14,7 +14,10 @@ import 'vite';
 import '@stryke/env/get-env-paths';
 import '@stryke/types/package-json';
 import 'jiti';
+import 'magic-string';
 import 'semver';
+import 'ts-morph';
+import '@stryke/fs/resolve';
 import 'node:fs';
 import '@stryke/types/tsconfig';
 import 'typescript';

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { P as Plugin } from './plugin-Ds-xu1R1.js';
+import { P as Plugin } from './plugin-ya8wkjpy.js';
 import { TypeScriptCompilerPluginContext, TypeScriptCompilerPluginOptions } from './types/plugin.js';
 export { TypeScriptCompilerPluginResolvedConfig, TypeScriptCompilerPluginUserConfig, __ΩTypeScriptCompilerPluginContext, __ΩTypeScriptCompilerPluginOptions, __ΩTypeScriptCompilerPluginResolvedConfig, __ΩTypeScriptCompilerPluginUserConfig } from './types/plugin.js';
 export { typeCheck } from './helpers/type-check.js';
@@ -14,7 +14,10 @@ import 'vite';
 import '@stryke/env/get-env-paths';
 import '@stryke/types/package-json';
 import 'jiti';
+import 'magic-string';
 import 'semver';
+import 'ts-morph';
+import '@stryke/fs/resolve';
 import 'node:fs';
 import '@stryke/types/tsconfig';
 import 'typescript';

package/dist/{plugin-Ds-xu1R1.d.cts → plugin-ya8wkjpy.d.cts}

@@ -1,5 +1,5 @@
 import { MaybePromise, NonUndefined, FunctionLike } from '@stryke/types/base';
-import { UnpluginMessage, UnpluginContext, UnpluginBuildContext, TransformResult, ExternalIdResult, HookFilter, UnpluginOptions } from 'unplugin';
+import { UnpluginMessage, ExternalIdResult, UnpluginContext, UnpluginBuildContext, TransformResult as TransformResult$1, HookFilter, UnpluginOptions } from 'unplugin';
 import { ArrayValues } from '@stryke/types/array';
 import { Format } from '@storm-software/build-tools/types';
 import { LogLevelLabel } from '@storm-software/config-tools/types';
@@ -10,8 +10,11 @@ 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 { PathLike, StatSyncOptions, Stats, RmDirOptions, RmOptions, Mode, MakeDirectoryOptions as MakeDirectoryOptions$1, PathOrFileDescriptor, WriteFileOptions as WriteFileOptions$1 } from 'node:fs';
+import { Project } from 'ts-morph';
+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';
 
@@ -238,21 +241,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 {
     /**
@@ -266,27 +275,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).
      *
@@ -314,7 +329,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).
      *
@@ -387,7 +402,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).
      *
@@ -401,7 +416,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).
      *
@@ -409,7 +424,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).
      *
@@ -417,14 +432,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).
      *
@@ -432,7 +447,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).
      *
@@ -440,7 +455,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).
      *
@@ -462,7 +477,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).
      *
@@ -470,7 +485,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).
      *
@@ -517,24 +532,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.
      */
@@ -1006,6 +1040,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.
@@ -1140,6 +1178,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
      */
@@ -1309,7 +1388,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.
      *
@@ -1317,7 +1396,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.
      *
@@ -1367,7 +1446,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.
      *
@@ -1375,7 +1454,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/{plugin-Ds-xu1R1.d.ts → plugin-ya8wkjpy.d.ts}

@@ -1,5 +1,5 @@
 import { MaybePromise, NonUndefined, FunctionLike } from '@stryke/types/base';
-import { UnpluginMessage, UnpluginContext, UnpluginBuildContext, TransformResult, ExternalIdResult, HookFilter, UnpluginOptions } from 'unplugin';
+import { UnpluginMessage, ExternalIdResult, UnpluginContext, UnpluginBuildContext, TransformResult as TransformResult$1, HookFilter, UnpluginOptions } from 'unplugin';
 import { ArrayValues } from '@stryke/types/array';
 import { Format } from '@storm-software/build-tools/types';
 import { LogLevelLabel } from '@storm-software/config-tools/types';
@@ -10,8 +10,11 @@ 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 { PathLike, StatSyncOptions, Stats, RmDirOptions, RmOptions, Mode, MakeDirectoryOptions as MakeDirectoryOptions$1, PathOrFileDescriptor, WriteFileOptions as WriteFileOptions$1 } from 'node:fs';
+import { Project } from 'ts-morph';
+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';
 
@@ -238,21 +241,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 {
     /**
@@ -266,27 +275,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).
      *
@@ -314,7 +329,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).
      *
@@ -387,7 +402,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).
      *
@@ -401,7 +416,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).
      *
@@ -409,7 +424,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).
      *
@@ -417,14 +432,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).
      *
@@ -432,7 +447,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).
      *
@@ -440,7 +455,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).
      *
@@ -462,7 +477,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).
      *
@@ -470,7 +485,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).
      *
@@ -517,24 +532,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.
      */
@@ -1006,6 +1040,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.
@@ -1140,6 +1178,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
      */
@@ -1309,7 +1388,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.
      *
@@ -1317,7 +1396,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.
      *
@@ -1367,7 +1446,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.
      *
@@ -1375,7 +1454,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/types/index.d.cts

@@ -1,5 +1,5 @@
 export { TypeScriptCompilerPluginContext, TypeScriptCompilerPluginOptions, TypeScriptCompilerPluginResolvedConfig, TypeScriptCompilerPluginUserConfig, __ΩTypeScriptCompilerPluginContext, __ΩTypeScriptCompilerPluginOptions, __ΩTypeScriptCompilerPluginResolvedConfig, __ΩTypeScriptCompilerPluginUserConfig } from './plugin.cjs';
-import '../plugin-Ds-xu1R1.cjs';
+import '../plugin-ya8wkjpy.cjs';
 import '@stryke/types/base';
 import 'unplugin';
 import '@stryke/types/array';
@@ -12,7 +12,10 @@ import 'vite';
 import '@stryke/env/get-env-paths';
 import '@stryke/types/package-json';
 import 'jiti';
+import 'magic-string';
 import 'semver';
+import 'ts-morph';
+import '@stryke/fs/resolve';
 import 'node:fs';
 import '@stryke/types/tsconfig';
 import 'typescript';

package/dist/types/index.d.ts

@@ -1,5 +1,5 @@
 export { TypeScriptCompilerPluginContext, TypeScriptCompilerPluginOptions, TypeScriptCompilerPluginResolvedConfig, TypeScriptCompilerPluginUserConfig, __ΩTypeScriptCompilerPluginContext, __ΩTypeScriptCompilerPluginOptions, __ΩTypeScriptCompilerPluginResolvedConfig, __ΩTypeScriptCompilerPluginUserConfig } from './plugin.js';
-import '../plugin-Ds-xu1R1.js';
+import '../plugin-ya8wkjpy.js';
 import '@stryke/types/base';
 import 'unplugin';
 import '@stryke/types/array';
@@ -12,7 +12,10 @@ import 'vite';
 import '@stryke/env/get-env-paths';
 import '@stryke/types/package-json';
 import 'jiti';
+import 'magic-string';
 import 'semver';
+import 'ts-morph';
+import '@stryke/fs/resolve';
 import 'node:fs';
 import '@stryke/types/tsconfig';
 import 'typescript';

package/dist/types/plugin.d.cts

@@ -1,4 +1,4 @@
-import { R as ResolvedConfig, a as PluginContext, U as UserConfig } from '../plugin-Ds-xu1R1.cjs';
+import { R as ResolvedConfig, a as PluginContext, U as UserConfig } from '../plugin-ya8wkjpy.cjs';
 import ts from 'typescript';
 import '@stryke/types/base';
 import 'unplugin';
@@ -12,7 +12,10 @@ import 'vite';
 import '@stryke/env/get-env-paths';
 import '@stryke/types/package-json';
 import 'jiti';
+import 'magic-string';
 import 'semver';
+import 'ts-morph';
+import '@stryke/fs/resolve';
 import 'node:fs';
 import '@stryke/types/tsconfig';
 

package/dist/types/plugin.d.ts

@@ -1,4 +1,4 @@
-import { R as ResolvedConfig, a as PluginContext, U as UserConfig } from '../plugin-Ds-xu1R1.js';
+import { R as ResolvedConfig, a as PluginContext, U as UserConfig } from '../plugin-ya8wkjpy.js';
 import ts from 'typescript';
 import '@stryke/types/base';
 import 'unplugin';
@@ -12,7 +12,10 @@ import 'vite';
 import '@stryke/env/get-env-paths';
 import '@stryke/types/package-json';
 import 'jiti';
+import 'magic-string';
 import 'semver';
+import 'ts-morph';
+import '@stryke/fs/resolve';
 import 'node:fs';
 import '@stryke/types/tsconfig';
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@powerlines/plugin-tsc",
-  "version": "0.2.35",
+  "version": "0.2.37",
   "type": "module",
   "description": "A package containing the TypeScript compiler plugin for Powerlines.",
   "repository": {
@@ -128,13 +128,13 @@
   "keywords": ["tsc", "powerlines", "storm-software", "powerlines-plugin"],
   "dependencies": {
     "defu": "^6.1.4",
-    "powerlines": "^0.23.10",
+    "powerlines": "^0.24.1",
     "typescript": "^5.9.3"
   },
   "devDependencies": {
-    "@powerlines/nx": "^0.10.27",
+    "@powerlines/nx": "^0.10.29",
     "@types/node": "^24.10.1"
   },
   "publishConfig": { "access": "public" },
-  "gitHead": "5a6b8349dc29bf9e496ed5dee32c6cfb8d9bff4e"
+  "gitHead": "424d900c34fbbdf943895648419a6467d8eb4a8d"
 }