@powerlines/plugin-env 0.13.33 → 0.13.35

package/dist/babel/index.d.cts

@@ -1,10 +1,12 @@
 export { envBabelPlugin } from './plugin.cjs';
-import '../runtime-BReFBBeA.cjs';
+import '../runtime-DhSbEPND.cjs';
 import '@stryke/env/get-env-paths';
 import '@stryke/types/base';
 import '@stryke/types/package-json';
 import 'jiti';
+import 'magic-string';
 import 'semver';
+import 'ts-morph';
 import 'unplugin';
 import '@babel/core';
 import '@storm-software/build-tools/types';
@@ -14,7 +16,8 @@ import '@stryke/types/configuration';
 import '@stryke/types/file';
 import 'vite';
 import '@babel/helper-plugin-utils';
-import '../fs-B3t0EW52.cjs';
+import '../fs-Y3B84fcf.cjs';
+import '@stryke/fs/resolve';
 import 'node:fs';
 import '@stryke/types/array';
 import '@stryke/types/tsconfig';

package/dist/babel/index.d.ts

@@ -1,10 +1,12 @@
 export { envBabelPlugin } from './plugin.js';
-import '../runtime-CNb5EW2L.js';
+import '../runtime-CCwYDwEe.js';
 import '@stryke/env/get-env-paths';
 import '@stryke/types/base';
 import '@stryke/types/package-json';
 import 'jiti';
+import 'magic-string';
 import 'semver';
+import 'ts-morph';
 import 'unplugin';
 import '@babel/core';
 import '@storm-software/build-tools/types';
@@ -14,7 +16,8 @@ import '@stryke/types/configuration';
 import '@stryke/types/file';
 import 'vite';
 import '@babel/helper-plugin-utils';
-import '../fs-B3t0EW52.js';
+import '../fs-Y3B84fcf.js';
+import '@stryke/fs/resolve';
 import 'node:fs';
 import '@stryke/types/array';
 import '@stryke/types/tsconfig';

package/dist/babel/plugin.d.cts

@@ -1,10 +1,12 @@
-import { D as DeclareBabelTransformPluginReturn } from '../runtime-BReFBBeA.cjs';
+import { D as DeclareBabelTransformPluginReturn } from '../runtime-DhSbEPND.cjs';
 import { EnvPluginContext, EnvPluginResolvedConfig } from '../types/plugin.cjs';
 import '@stryke/env/get-env-paths';
 import '@stryke/types/base';
 import '@stryke/types/package-json';
 import 'jiti';
+import 'magic-string';
 import 'semver';
+import 'ts-morph';
 import 'unplugin';
 import '@babel/core';
 import '@storm-software/build-tools/types';
@@ -14,7 +16,8 @@ import '@stryke/types/configuration';
 import '@stryke/types/file';
 import 'vite';
 import '@babel/helper-plugin-utils';
-import '../fs-B3t0EW52.cjs';
+import '../fs-Y3B84fcf.cjs';
+import '@stryke/fs/resolve';
 import 'node:fs';
 import '@stryke/types/array';
 import '@stryke/types/tsconfig';

package/dist/babel/plugin.d.ts

@@ -1,10 +1,12 @@
-import { D as DeclareBabelTransformPluginReturn } from '../runtime-CNb5EW2L.js';
+import { D as DeclareBabelTransformPluginReturn } from '../runtime-CCwYDwEe.js';
 import { EnvPluginContext, EnvPluginResolvedConfig } from '../types/plugin.js';
 import '@stryke/env/get-env-paths';
 import '@stryke/types/base';
 import '@stryke/types/package-json';
 import 'jiti';
+import 'magic-string';
 import 'semver';
+import 'ts-morph';
 import 'unplugin';
 import '@babel/core';
 import '@storm-software/build-tools/types';
@@ -14,7 +16,8 @@ import '@stryke/types/configuration';
 import '@stryke/types/file';
 import 'vite';
 import '@babel/helper-plugin-utils';
-import '../fs-B3t0EW52.js';
+import '../fs-Y3B84fcf.js';
+import '@stryke/fs/resolve';
 import 'node:fs';
 import '@stryke/types/array';
 import '@stryke/types/tsconfig';

package/dist/components/env.d.cts

@@ -1,8 +1,9 @@
 import { Children as Children$1, SourceFileProps as SourceFileProps$1 } from '@alloy-js/core';
 import { Children } from '@alloy-js/core/jsx-runtime';
-import { O as OutputModeType } from '../fs-B3t0EW52.cjs';
+import { O as OutputModeType } from '../fs-Y3B84fcf.cjs';
 import { InterfaceDeclarationProps } from '@alloy-js/typescript';
 import { ReflectionClass } from '@deepkit/type';
+import '@stryke/fs/resolve';
 import 'node:fs';
 
 /**

package/dist/components/env.d.ts

@@ -1,8 +1,9 @@
 import { Children as Children$1, SourceFileProps as SourceFileProps$1 } from '@alloy-js/core';
 import { Children } from '@alloy-js/core/jsx-runtime';
-import { O as OutputModeType } from '../fs-B3t0EW52.js';
+import { O as OutputModeType } from '../fs-Y3B84fcf.js';
 import { InterfaceDeclarationProps } from '@alloy-js/typescript';
 import { ReflectionClass } from '@deepkit/type';
+import '@stryke/fs/resolve';
 import 'node:fs';
 
 /**

package/dist/components/index.d.cts

@@ -1,7 +1,8 @@
 export { EnvBuiltin, EnvBuiltinProps, EnvTypeDefinition, __ΩEnvBuiltinProps } from './env.cjs';
 import '@alloy-js/core';
 import '@alloy-js/core/jsx-runtime';
-import '../fs-B3t0EW52.cjs';
+import '../fs-Y3B84fcf.cjs';
+import '@stryke/fs/resolve';
 import 'node:fs';
 import '@alloy-js/typescript';
 import '@deepkit/type';

package/dist/components/index.d.ts

@@ -1,7 +1,8 @@
 export { EnvBuiltin, EnvBuiltinProps, EnvTypeDefinition, __ΩEnvBuiltinProps } from './env.js';
 import '@alloy-js/core';
 import '@alloy-js/core/jsx-runtime';
-import '../fs-B3t0EW52.js';
+import '../fs-Y3B84fcf.js';
+import '@stryke/fs/resolve';
 import 'node:fs';
 import '@alloy-js/typescript';
 import '@deepkit/type';

package/dist/{fs-B3t0EW52.d.cts → fs-Y3B84fcf.d.cts}

@@ -1,4 +1,5 @@
-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';
 
 declare const __VFS_PATCH__ = "__VFS_PATCH__";
 declare const __VFS_REVERT__ = "__VFS_REVERT__";
@@ -87,21 +88,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 {
     /**
@@ -115,27 +122,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).
      *
@@ -163,7 +176,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).
      *
@@ -236,7 +249,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).
      *
@@ -250,7 +263,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).
      *
@@ -258,7 +271,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).
      *
@@ -266,14 +279,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).
      *
@@ -281,7 +294,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).
      *
@@ -289,7 +302,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).
      *
@@ -311,7 +324,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).
      *
@@ -319,7 +332,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).
      *
@@ -366,28 +379,47 @@ 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.
      */
     dispose: () => Promise<void>;
 }
 
-export type { OutputModeType as O, PowerlinesWriteFileOptions as P, VirtualFileSystemInterface as V, VirtualFile as a };
+export type { OutputModeType as O, PowerlinesWriteFileOptions as P, ResolveOptions as R, VirtualFileSystemInterface as V, VirtualFile as a };

package/dist/{fs-B3t0EW52.d.ts → fs-Y3B84fcf.d.ts}

@@ -1,4 +1,5 @@
-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';
 
 declare const __VFS_PATCH__ = "__VFS_PATCH__";
 declare const __VFS_REVERT__ = "__VFS_REVERT__";
@@ -87,21 +88,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 {
     /**
@@ -115,27 +122,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).
      *
@@ -163,7 +176,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).
      *
@@ -236,7 +249,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).
      *
@@ -250,7 +263,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).
      *
@@ -258,7 +271,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).
      *
@@ -266,14 +279,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).
      *
@@ -281,7 +294,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).
      *
@@ -289,7 +302,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).
      *
@@ -311,7 +324,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).
      *
@@ -319,7 +332,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).
      *
@@ -366,28 +379,47 @@ 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.
      */
     dispose: () => Promise<void>;
 }
 
-export type { OutputModeType as O, PowerlinesWriteFileOptions as P, VirtualFileSystemInterface as V, VirtualFile as a };
+export type { OutputModeType as O, PowerlinesWriteFileOptions as P, ResolveOptions as R, VirtualFileSystemInterface as V, VirtualFile as a };

package/dist/helpers/index.d.cts

@@ -3,12 +3,14 @@ export { getEnvDefaultTypeDefinition, getEnvReflectionsPath, getEnvTypeReflectio
 export { BaseEnv, BaseSecrets, CreateEnvReflectionOptions, __ΩCreateEnvReflectionOptions, createEnvReflection, createSecretsReflection, mergeEnvReflections, mergeSecretsReflections, reflectEnv, reflectSecrets } from './reflect.cjs';
 export { formatEnvField, removeEnvPrefix } from './source-file-env.cjs';
 export { createTemplateReflection } from './template-helpers.cjs';
-import '../runtime-BReFBBeA.cjs';
+import '../runtime-DhSbEPND.cjs';
 import '@stryke/env/get-env-paths';
 import '@stryke/types/base';
 import '@stryke/types/package-json';
 import 'jiti';
+import 'magic-string';
 import 'semver';
+import 'ts-morph';
 import 'unplugin';
 import '@babel/core';
 import '@storm-software/build-tools/types';
@@ -18,7 +20,8 @@ import '@stryke/types/configuration';
 import '@stryke/types/file';
 import 'vite';
 import '@babel/helper-plugin-utils';
-import '../fs-B3t0EW52.cjs';
+import '../fs-Y3B84fcf.cjs';
+import '@stryke/fs/resolve';
 import 'node:fs';
 import '@stryke/types/array';
 import '@stryke/types/tsconfig';

package/dist/helpers/index.d.ts

@@ -3,12 +3,14 @@ export { getEnvDefaultTypeDefinition, getEnvReflectionsPath, getEnvTypeReflectio
 export { BaseEnv, BaseSecrets, CreateEnvReflectionOptions, __ΩCreateEnvReflectionOptions, createEnvReflection, createSecretsReflection, mergeEnvReflections, mergeSecretsReflections, reflectEnv, reflectSecrets } from './reflect.js';
 export { formatEnvField, removeEnvPrefix } from './source-file-env.js';
 export { createTemplateReflection } from './template-helpers.js';
-import '../runtime-CNb5EW2L.js';
+import '../runtime-CCwYDwEe.js';
 import '@stryke/env/get-env-paths';
 import '@stryke/types/base';
 import '@stryke/types/package-json';
 import 'jiti';
+import 'magic-string';
 import 'semver';
+import 'ts-morph';
 import 'unplugin';
 import '@babel/core';
 import '@storm-software/build-tools/types';
@@ -18,7 +20,8 @@ import '@stryke/types/configuration';
 import '@stryke/types/file';
 import 'vite';
 import '@babel/helper-plugin-utils';
-import '../fs-B3t0EW52.js';
+import '../fs-Y3B84fcf.js';
+import '@stryke/fs/resolve';
 import 'node:fs';
 import '@stryke/types/array';
 import '@stryke/types/tsconfig';