powerlines 0.23.10 → 0.24.0

package/dist/lib/{chunk-4EIXDLFP.cjs → chunk-SAS5EPBD.cjs}

@@ -18,7 +18,7 @@ var VirtualFileSystemHost = class VirtualFileSystemHost2 extends tsMorph.InMemor
   }
   readDirSync(dirPath) {
     return this.#fs.readdirSync(dirPath).reduce((ret, entry) => {
-      const fullPath = this.#fs.resolve(join.joinPaths(dirPath, entry));
+      const fullPath = this.#fs.resolveSync(join.joinPaths(dirPath, entry));
       if (fullPath) {
         ret.push({
           name: entry,
@@ -79,7 +79,7 @@ var VirtualFileSystemHost = class VirtualFileSystemHost2 extends tsMorph.InMemor
     return this.#fs.isDirectory(dirPath);
   }
   realpathSync(path) {
-    return this.#fs.resolve(path) || path;
+    return this.#fs.resolveSync(path) || path;
   }
   getCurrentDirectory() {
     return "/";
@@ -91,14 +91,16 @@ var VirtualFileSystemHost = class VirtualFileSystemHost2 extends tsMorph.InMemor
     return this.#fs.globSync(patterns);
   }
 };
-function createProgram(context) {
-  return new tsMorph.Project({
+function createProgram(context, override) {
+  const project = new tsMorph.Project({
     compilerOptions: {
       ...context.tsconfig.options
     },
     tsConfigFilePath: context.tsconfig.tsconfigFilePath,
-    fileSystem: new VirtualFileSystemHost(context.fs)
+    fileSystem: new VirtualFileSystemHost(context.fs),
+    ...override
   });
+  return project;
 }
 chunkUSNT2KNT_cjs.__name(createProgram, "createProgram");
 

package/dist/lib/{chunk-EUDKQWSB.js → chunk-VHLINWXG.js}

@@ -1,11 +1,10 @@
-import { resolvePath } from './chunk-NWAD7K4D.js';
 import { extractESBuildConfig } from './chunk-AOHJEL2Q.js';
 import { __name } from './chunk-SHUYVCID.js';
 import { LogLevelLabel } from '@storm-software/config-tools/types';
 import { build } from 'esbuild';
 
 async function bundle(context, file, overrides = {}) {
-  const path = await resolvePath(context, file);
+  const path = await context.fs.resolve(file);
   if (!path || !context.fs.existsSync(path)) {
     throw new Error(`Module not found: "${file}". Please check the path and try again.`);
   }

package/dist/lib/{chunk-VLOUSKRX.cjs → chunk-VMLQATMA.cjs}

@@ -1,7 +1,7 @@
 'use strict';
 
-var chunkI6TJUFA6_cjs = require('./chunk-I6TJUFA6.cjs');
-var chunkQABAD5RE_cjs = require('./chunk-QABAD5RE.cjs');
+var chunkAA6RBP44_cjs = require('./chunk-AA6RBP44.cjs');
+var chunkRNHKEPFD_cjs = require('./chunk-RNHKEPFD.cjs');
 var chunkK3NBD5LL_cjs = require('./chunk-K3NBD5LL.cjs');
 var chunkUSNT2KNT_cjs = require('./chunk-USNT2KNT.cjs');
 var types = require('@storm-software/config-tools/types');
@@ -64,7 +64,7 @@ function createDefaultEnvironment(userConfig) {
 chunkUSNT2KNT_cjs.__name(createDefaultEnvironment, "createDefaultEnvironment");
 
 // src/lib/contexts/api-context.ts
-var PowerlinesAPIContext = class _PowerlinesAPIContext extends chunkQABAD5RE_cjs.PowerlinesContext {
+var PowerlinesAPIContext = class _PowerlinesAPIContext extends chunkRNHKEPFD_cjs.PowerlinesContext {
   static {
     chunkUSNT2KNT_cjs.__name(this, "PowerlinesAPIContext");
   }
@@ -127,7 +127,7 @@ var PowerlinesAPIContext = class _PowerlinesAPIContext extends chunkQABAD5RE_cjs
     if (this.environments[environment.name]) {
       context = this.environments[environment.name];
     } else {
-      context = await chunkI6TJUFA6_cjs.PowerlinesEnvironmentContext.fromConfig(this.workspaceConfig, this.config);
+      context = await chunkAA6RBP44_cjs.PowerlinesEnvironmentContext.fromConfig(this.workspaceConfig, this.config);
     }
     if (isSetObject.isSetObject(this.config.inlineConfig)) {
       await context.withInlineConfig(this.config.inlineConfig);

package/dist/lib/{chunk-IBPA3VN5.cjs → chunk-WUYK74EH.cjs}

@@ -54,7 +54,7 @@ async function createVirtualProgram(rootNames, context, compilerOptions = {}) {
     ...ts__default.default.sys,
     realpath: /* @__PURE__ */ chunkUSNT2KNT_cjs.__name((path) => {
       if (context.fs.existsSync(path)) {
-        return context.fs.resolve(path);
+        return context.fs.resolveSync(path);
       }
       return ts__default.default.sys.realpath?.(path) ?? path;
     }, "realpath"),
@@ -109,7 +109,7 @@ async function createVirtualProgram(rootNames, context, compilerOptions = {}) {
     },
     resolvePath: /* @__PURE__ */ chunkUSNT2KNT_cjs.__name((fileName) => {
       if (context.fs.existsSync(fileName)) {
-        return context.fs.resolve(fileName);
+        return context.fs.resolveSync(fileName);
       }
       return ts__default.default.sys.resolvePath(fileName);
     }, "resolvePath"),
@@ -136,7 +136,7 @@ function createVirtualCompilerHost(context, sys, compilerOptions) {
       // getDefaultLibLocation: () => '/',
       getNewLine: /* @__PURE__ */ chunkUSNT2KNT_cjs.__name(() => sys.newLine, "getNewLine"),
       getSourceFile: /* @__PURE__ */ chunkUSNT2KNT_cjs.__name((fileName, languageVersionOrOptions) => {
-        const resolved = context.fs.resolve(fileName);
+        const resolved = context.fs.resolveSync(fileName);
         if (resolved && context.fs.existsSync(resolved)) {
           return context.fs.readFileSync(resolved);
         }

package/dist/lib/{chunk-RD5AUWXN.js → chunk-YQ3ODCHV.js}

@@ -16,7 +16,7 @@ var VirtualFileSystemHost = class VirtualFileSystemHost2 extends InMemoryFileSys
   }
   readDirSync(dirPath) {
     return this.#fs.readdirSync(dirPath).reduce((ret, entry) => {
-      const fullPath = this.#fs.resolve(joinPaths(dirPath, entry));
+      const fullPath = this.#fs.resolveSync(joinPaths(dirPath, entry));
       if (fullPath) {
         ret.push({
           name: entry,
@@ -77,7 +77,7 @@ var VirtualFileSystemHost = class VirtualFileSystemHost2 extends InMemoryFileSys
     return this.#fs.isDirectory(dirPath);
   }
   realpathSync(path) {
-    return this.#fs.resolve(path) || path;
+    return this.#fs.resolveSync(path) || path;
   }
   getCurrentDirectory() {
     return "/";
@@ -89,14 +89,16 @@ var VirtualFileSystemHost = class VirtualFileSystemHost2 extends InMemoryFileSys
     return this.#fs.globSync(patterns);
   }
 };
-function createProgram(context) {
-  return new Project({
+function createProgram(context, override) {
+  const project = new Project({
     compilerOptions: {
       ...context.tsconfig.options
     },
     tsConfigFilePath: context.tsconfig.tsconfigFilePath,
-    fileSystem: new VirtualFileSystemHost(context.fs)
+    fileSystem: new VirtualFileSystemHost(context.fs),
+    ...override
   });
+  return project;
 }
 __name(createProgram, "createProgram");
 

package/dist/lib/{config-BnJpgcGr.d.cts → config-D8KrE7SZ.d.cts}

@@ -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.cjs';
 
@@ -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 };