@powerlines/nx 0.10.46 → 0.10.48

package/dist/{chunk-R6ECHVU4.mjs → chunk-22IQ22WZ.mjs}

@@ -3,13 +3,12 @@ import { __name } from './chunk-O6YSETKJ.mjs';
 import { getLogFn, getLogLevel, writeError } from '@storm-software/config-tools/logger';
 import { withRunExecutor } from '@storm-software/workspace-tools/base/base-executor';
 import { isError } from '@stryke/type-checks/is-error';
-import defu6, { defu } from 'defu';
+import defu6, { createDefu, defu } from 'defu';
 import { transformAsync } from '@babel/core';
 import { formatLogMessage } from '@storm-software/config-tools/logger/console';
 import { LogLevelLabel } from '@storm-software/config-tools/types';
 import { toArray } from '@stryke/convert/to-array';
-import { copyFiles } from '@stryke/fs/copy-file';
-import { createDirectory } from '@stryke/fs/helpers';
+import { createDirectorySync, createDirectory } from '@stryke/fs/helpers';
 import { install } from '@stryke/fs/install';
 import { listFilesSync, listFiles } from '@stryke/fs/list-files';
 import { isPackageExists, isPackageListed, doesPackageMatch, getPackageListing } from '@stryke/fs/package-fns';
@@ -19,6 +18,7 @@ import { joinPaths as joinPaths$1 } from '@stryke/path/join-paths';
 import { replacePath, replaceExtension } from '@stryke/path/replace';
 import { isFunction } from '@stryke/type-checks/is-function';
 import { isNumber } from '@stryke/type-checks/is-number';
+import { isObject } from '@stryke/type-checks/is-object';
 import { isPromiseLike } from '@stryke/type-checks/is-promise';
 import { isSet } from '@stryke/type-checks/is-set';
 import { isSetObject } from '@stryke/type-checks/is-set-object';
@@ -28,8 +28,8 @@ import Handlebars from 'handlebars';
 import { declare } from '@babel/helper-plugin-utils';
 import * as t from '@babel/types';
 import ts, { flattenDiagnosticMessageText } from 'typescript';
-import { joinPaths } from '@stryke/path/join';
 import { InMemoryFileSystemHost, Project } from 'ts-morph';
+import { isString } from '@stryke/type-checks/is-string';
 import { getPackageName, hasPackageVersion, getPackageVersion } from '@stryke/string-format/package';
 import { getObjectDiff } from '@donedeal0/superdiff';
 import { readJsonFile, readJsonFileSync } from '@stryke/fs/json';
@@ -37,38 +37,41 @@ import { StormJSON } from '@stryke/json/storm-json';
 import { hasFileExtension, findFilePath, findFileName, relativePath, findFileDotExtensionSafe } from '@stryke/path/file-path-fns';
 import { titleCase } from '@stryke/string-format/title-case';
 import { existsSync, exists } from '@stryke/fs/exists';
-import { writeFileSync, writeFile as writeFile$1 } from '@stryke/fs/write-file';
-import { resolveConfig, format } from 'prettier';
 import { getEnvPaths } from '@stryke/env/get-env-paths';
 import { relativeToWorkspaceRoot } from '@stryke/fs/get-workspace-root';
 import { hashDirectory } from '@stryke/hash/hash-files';
 import { murmurhash } from '@stryke/hash/murmurhash';
 import { getUnique, getUniqueBy } from '@stryke/helpers/get-unique';
 import { omit } from '@stryke/helpers/omit';
+import { fetchRequest } from '@stryke/http/fetch';
 import { isAbsolutePath, isAbsolute } from '@stryke/path/is-type';
+import { joinPaths } from '@stryke/path/join';
 import { isNull } from '@stryke/type-checks/is-null';
-import { isString } from '@stryke/type-checks/is-string';
 import { uuid } from '@stryke/unique-id/uuid';
 import { tsconfigPathsToRegExp, match } from 'bundle-require';
+import { create } from 'flat-cache';
+import { parse } from 'oxc-parser';
+import { Agent, setGlobalDispatcher, interceptors, Response } from 'undici';
 import { createJiti } from 'jiti';
 import { isUndefined } from '@stryke/type-checks/is-undefined';
 import { parseTypeDefinition } from '@stryke/convert/parse-type-definition';
-import { isFile } from '@stryke/fs/is-file';
+import { isDirectory, isFile } from '@stryke/fs/is-file';
 import * as $ from '@stryke/capnp';
 import { readFileBuffer, readFileBufferSync, writeFileBuffer } from '@stryke/fs/buffer';
-import { correctPath, toAbsolutePath } from '@stryke/path/correct-path';
 import { isParentPath } from '@stryke/path/is-parent-path';
 import { prettyBytes } from '@stryke/string-format/pretty-bytes';
-import { create } from 'flat-cache';
 import { Blob } from 'node:buffer';
+import { fileURLToPath } from 'node:url';
+import { resolveConfig, format } from 'prettier';
 import { getColor } from '@storm-software/config-tools/utilities/colors';
 import { noop } from '@stryke/helpers/noop';
+import { correctPath } from '@stryke/path/correct-path';
 import { slash } from '@stryke/path/slash';
 import { readFileSync, readFile } from '@stryke/fs/read-file';
+import { writeFileSync, writeFile } from '@stryke/fs/write-file';
 import { unlinkSync } from 'node:fs';
 import { unlink } from 'node:fs/promises';
 import { resolve } from 'node:path';
-import { isObject } from '@stryke/type-checks/is-object';
 
 function resolveModulePath(nodePath, state) {
   if (!t.isStringLiteral(nodePath.node)) {
@@ -184,13 +187,16 @@ var VirtualFileSystemHost = class extends InMemoryFileSystemHost {
     this.#context.fs.removeSync(path);
   }
   readDirSync(dirPath) {
+    if (!this.#context.fs.isDirectorySync(dirPath)) {
+      return [];
+    }
     return this.#context.fs.listSync(dirPath).reduce((ret, entry) => {
-      const fullPath = this.#context.fs.resolveSync(joinPaths(dirPath, entry));
+      const fullPath = this.#context.fs.resolveSync(entry);
       if (fullPath) {
         ret.push({
           name: entry,
-          isDirectory: this.#context.fs.existsSync(fullPath),
-          isFile: this.#context.fs.existsSync(fullPath),
+          isDirectory: this.#context.fs.isDirectorySync(fullPath),
+          isFile: this.#context.fs.isFileSync(fullPath),
           isSymlink: false
         });
       }
@@ -198,14 +204,14 @@ var VirtualFileSystemHost = class extends InMemoryFileSystemHost {
     }, []);
   }
   async readFile(filePath) {
-    if (!this.#context.fs.existsSync(filePath)) {
-      throw new Error(`File not found: '${filePath}'. Please check the path and try again.`);
+    if (!this.#context.fs.isFileSync(filePath)) {
+      return "";
     }
     return await this.#context.fs.read(filePath);
   }
   readFileSync(filePath) {
-    if (!this.#context.fs.existsSync(filePath)) {
-      throw new Error(`File not found: '${filePath}'. Please check the path and try again.`);
+    if (!this.#context.fs.isFileSync(filePath)) {
+      return "";
     }
     return this.#context.fs.readSync(filePath);
   }
@@ -215,9 +221,11 @@ var VirtualFileSystemHost = class extends InMemoryFileSystemHost {
   writeFileSync(filePath, fileText) {
     this.#context.fs.writeSync(filePath, fileText);
   }
-  async mkdir(_dirPath) {
+  async mkdir(dirPath) {
+    await this.#context.fs.mkdir(dirPath);
   }
-  mkdirSync(_dirPath) {
+  mkdirSync(dirPath) {
+    this.#context.fs.mkdirSync(dirPath);
   }
   async move(srcPath, destPath) {
     await this.#context.fs.move(srcPath, destPath);
@@ -232,16 +240,16 @@ var VirtualFileSystemHost = class extends InMemoryFileSystemHost {
     this.#context.fs.copySync(srcPath, destPath);
   }
   async fileExists(filePath) {
-    return this.#context.fs.exists(filePath);
+    return this.#context.fs.isFile(filePath);
   }
   fileExistsSync(filePath) {
-    return this.#context.fs.existsSync(filePath);
+    return this.#context.fs.isFileSync(filePath);
   }
   async directoryExists(dirPath) {
-    return this.#context.fs.exists(dirPath);
+    return this.#context.fs.isDirectory(dirPath);
   }
   directoryExistsSync(dirPath) {
-    return this.#context.fs.existsSync(dirPath);
+    return this.#context.fs.isDirectorySync(dirPath);
   }
   realpathSync(path) {
     return this.#context.fs.resolveSync(path) || path;
@@ -320,6 +328,14 @@ ${diagnosticMessage.length > 5e3 ? `${diagnosticMessage.slice(0, 5e3)}...` : dia
   return formatTypes(builtinModules);
 }
 __name(emitTypes, "emitTypes");
+var mergeResults = createDefu((obj, key, value) => {
+  if (isString(obj[key]) && isString(value)) {
+    obj[key] = `${obj[key] || ""}
+${value || ""}`.trim();
+    return true;
+  }
+  return false;
+});
 async function callHook(context, hook, options, ...args) {
   const handlers = context.selectHooks(hook, options);
   if (handlers.length > 0) {
@@ -327,18 +343,28 @@ async function callHook(context, hook, options, ...args) {
     let results = [];
     if (options?.sequential === false) {
       results = await Promise.all(handlers.map(async (handler) => {
-        if (!isFunction(handler)) {
+        if (!isFunction(handler.handle)) {
           throw new Error(`Plugin hook handler for hook "${hook}" is not a function.`);
         }
-        return Promise.resolve(handler.apply(null, ...args));
+        return Promise.resolve(
+          // eslint-disable-next-line ts/no-unsafe-call
+          handler.handle.apply(handler.context, [
+            ...args
+          ])
+        );
       }));
     } else {
       for (const handler of handlers) {
-        if (!isFunction(handler)) {
+        if (!isFunction(handler.handle)) {
           throw new Error(`Plugin hook handler for hook "${hook}" is not a function.`);
         }
         if (options?.result === "first" || options?.asNextParam === false) {
-          results.push(await Promise.resolve(handler.apply(null, ...args)));
+          results.push(await Promise.resolve(
+            // eslint-disable-next-line ts/no-unsafe-call
+            handler.handle.apply(handler.context, [
+              ...args
+            ])
+          ));
           if (options?.result === "first" && isSet(results[results.length - 1])) {
             break;
           }
@@ -351,11 +377,26 @@ async function callHook(context, hook, options, ...args) {
           }
           const result = await Promise.resolve(
             // eslint-disable-next-line ts/no-unsafe-call
-            handler.apply(null, ...sequenceArgs)
+            handler.handle.apply(handler.context, [
+              ...sequenceArgs
+            ])
           );
-          results = [
-            result
-          ];
+          if (result) {
+            if (options?.result === "last") {
+              results = [
+                result
+              ];
+            } else if (isString(result)) {
+              results = [
+                `${isString(results[0]) ? results[0] || "" : ""}
+${result || ""}`.trim()
+              ];
+            } else if (isObject(result)) {
+              results = [
+                mergeResults(result, results[0] ?? {})
+              ];
+            }
+          }
         }
       }
     }
@@ -521,33 +562,20 @@ ${parsedCommandLine.errors.map((error) => `- ${(error.category !== void 0 && err
   };
 }
 __name(getParsedTypeScriptConfig, "getParsedTypeScriptConfig");
-async function writeFile(log, filepath, content, skipFormat = false) {
-  try {
-    if (skipFormat) {
-      await writeFile$1(filepath, content);
-    } else {
-      const config = await resolveConfig(filepath);
-      const formatted = await format(content, {
-        ...config ?? {},
-        filepath
-      });
-      await writeFile$1(filepath, formatted || "");
-    }
-  } catch (error) {
-    log(LogLevelLabel.ERROR, `Failed to write file ${filepath} to disk 
-${error?.message ? error.message : ""}`);
-  }
-}
-__name(writeFile, "writeFile");
 
 // ../powerlines/src/internal/helpers/resolve-tsconfig.ts
+function getTsconfigDtsPath(context) {
+  const dtsRelativePath = joinPaths$1(relativePath(joinPaths$1(context.workspaceConfig.workspaceRoot, context.config.projectRoot), findFilePath(context.dtsPath)), findFileName(context.dtsPath));
+  return dtsRelativePath;
+}
+__name(getTsconfigDtsPath, "getTsconfigDtsPath");
 async function resolveTsconfigChanges(context) {
   const tsconfig = getParsedTypeScriptConfig(context.workspaceConfig.workspaceRoot, context.config.projectRoot, context.config.tsconfig, context.config.tsconfigRaw);
   const tsconfigFilePath = getTsconfigFilePath(context.workspaceConfig.workspaceRoot, context.config.projectRoot, context.config.tsconfig);
   const tsconfigJson = await readJsonFile(tsconfigFilePath);
   tsconfigJson.compilerOptions ??= {};
   if (context.config.output.dts !== false) {
-    const dtsRelativePath = joinPaths$1(relativePath(joinPaths$1(context.workspaceConfig.workspaceRoot, context.config.projectRoot), findFilePath(context.dtsPath)), findFileName(context.dtsPath));
+    const dtsRelativePath = getTsconfigDtsPath(context);
     if (!tsconfigJson.include?.some((filePattern) => isIncludeMatchFound(filePattern, [
       context.dtsPath,
       dtsRelativePath
@@ -589,7 +617,7 @@ async function initializeTsconfig(context) {
   context.tsconfig.originalTsconfigJson = await readJsonFile(tsconfigFilePath);
   context.tsconfig.tsconfigJson = await resolveTsconfigChanges(context);
   context.log(LogLevelLabel.TRACE, "Writing updated TypeScript configuration (tsconfig.json) file to disk.");
-  await writeFile(context.log, tsconfigFilePath, StormJSON.stringify(context.tsconfig.tsconfigJson));
+  await context.fs.write(tsconfigFilePath, StormJSON.stringify(context.tsconfig.tsconfigJson));
   context.tsconfig = getParsedTypeScriptConfig(context.workspaceConfig.workspaceRoot, context.config.projectRoot, context.config.tsconfig, context.config.tsconfigRaw, context.tsconfig.originalTsconfigJson);
 }
 __name(initializeTsconfig, "initializeTsconfig");
@@ -638,13 +666,11 @@ async function resolveTsconfig(context) {
   `).join("\n")}
     `);
   }
-  await writeFile(context.log, context.tsconfig.tsconfigFilePath, StormJSON.stringify(updateTsconfigJson));
+  await context.fs.write(context.tsconfig.tsconfigFilePath, StormJSON.stringify(updateTsconfigJson));
   context.tsconfig = getParsedTypeScriptConfig(context.workspaceConfig.workspaceRoot, context.config.projectRoot, context.config.tsconfig);
   if (!context.tsconfig) {
     throw new Error("Failed to parse the TypeScript configuration file.");
   }
-  context.tsconfig.tsconfigJson.compilerOptions ??= {};
-  context.tsconfig.tsconfigJson.compilerOptions.strict = false;
 }
 __name(resolveTsconfig, "resolveTsconfig");
 var DEFAULT_ENVIRONMENT = "default";
@@ -784,7 +810,7 @@ function replacePathTokens(context, path) {
   if (!path) {
     return path;
   }
-  return path.replaceAll("{workspaceRoot}", context.workspaceConfig.workspaceRoot).replaceAll("{root}", context.config.projectRoot).replaceAll("{projectRoot}", context.config.projectRoot).replaceAll("{powerlinesPath}", context.powerlinesPath).replaceAll("{cachePath}", context.cachePath).replaceAll("{dataPath}", context.dataPath).replaceAll("{logPath}", context.envPaths.log).replaceAll("{tempPath}", context.envPaths.temp).replaceAll("{configPath}", context.envPaths.config).replaceAll("{outputPath}", context.config.output.outputPath).replaceAll("{buildPath}", context.config.output.buildPath).replaceAll("{artifactsPath}", replacePath(context.artifactsPath, context.workspaceConfig.workspaceRoot)).replaceAll("{builtinPath}", replacePath(context.builtinsPath, context.workspaceConfig.workspaceRoot)).replaceAll("{entryPath}", replacePath(context.entryPath, context.workspaceConfig.workspaceRoot));
+  return path.replaceAll("{workspaceRoot}", context.workspaceConfig.workspaceRoot).replaceAll("{root}", context.config.projectRoot).replaceAll("{projectRoot}", context.config.projectRoot).replaceAll("{sourceRoot}", context.config.sourceRoot).replaceAll("{powerlinesPath}", context.powerlinesPath).replaceAll("{cachePath}", context.cachePath).replaceAll("{dataPath}", context.dataPath).replaceAll("{logPath}", context.envPaths.log).replaceAll("{tempPath}", context.envPaths.temp).replaceAll("{configPath}", context.envPaths.config).replaceAll("{outputPath}", context.config.output.outputPath).replaceAll("{buildPath}", context.config.output.buildPath).replaceAll("{artifactsPath}", replacePath(context.artifactsPath, context.workspaceConfig.workspaceRoot)).replaceAll("{builtinPath}", replacePath(context.builtinsPath, context.workspaceConfig.workspaceRoot)).replaceAll("{entryPath}", replacePath(context.entryPath, context.workspaceConfig.workspaceRoot));
 }
 __name(replacePathTokens, "replacePathTokens");
 function resolveEntryInputFile(context, typeDefinition) {
@@ -1125,20 +1151,17 @@ function normalizePath(path, builtinsPath, prefix = "powerlines") {
   return isAbsolutePath(path) ? path : isValidId(toFilePath(path), prefix) ? normalizeId(toFilePath(path), prefix).replace(new RegExp(`^${prefix.replace(/:$/, "")}:`), builtinsPath) : toFilePath(path);
 }
 __name(normalizePath, "normalizePath");
-function normalizeKey(key, sep = ":") {
-  if (!key) {
-    return "";
-  }
-  return key.replace(/[:/\\]/g, sep).replace(/^[:/\\]|[:/\\]$/g, "");
-}
-__name(normalizeKey, "normalizeKey");
-function filterKeyByBase(key, base) {
-  if (base) {
-    return key.startsWith(base) && key[key.length - 1] !== "$";
-  }
-  return key[key.length - 1] !== "$";
+function normalizeGlobPatterns(workspaceRoot, patterns) {
+  return getUnique(toArray(patterns).map((pattern) => {
+    if (isSetObject(pattern) && (isSetString(pattern.input) || isSetString(pattern.glob))) {
+      return joinPaths(pattern.input || workspaceRoot, pattern.glob || "**/*");
+    } else if (!isSetString(pattern)) {
+      return void 0;
+    }
+    return pattern;
+  }).filter(isSetString));
 }
-__name(filterKeyByBase, "filterKeyByBase");
+__name(normalizeGlobPatterns, "normalizeGlobPatterns");
 var BaseStorageAdapter = class {
   static {
     __name(this, "BaseStorageAdapter");
@@ -1193,6 +1216,21 @@ var BaseStorageAdapter = class {
     }
   }
   /**
+  * Synchronously creates a directory at the specified path.
+  *
+  * @param _ - The path of the directory to create.
+  */
+  mkdirSync(_) {
+  }
+  /**
+  * Creates a directory at the specified path.
+  *
+  * @param dirPath - The path of the directory to create.
+  */
+  async mkdir(dirPath) {
+    return Promise.resolve(this.mkdirSync(dirPath));
+  }
+  /**
   * Asynchronously removes a key from the storage.
   *
   * @param key - The key to remove.
@@ -1241,6 +1279,42 @@ var BaseStorageAdapter = class {
     return this.listSync(base);
   }
   /**
+  * Synchronously checks if the given key is a directory.
+  *
+  * @param _ - The key to check.
+  * @returns `true` if the key is a directory, otherwise `false`.
+  */
+  isDirectorySync(_) {
+    return false;
+  }
+  /**
+  * Checks if the given key is a directory.
+  *
+  * @param key - The key to check.
+  * @returns A promise that resolves to `true` if the key is a directory, otherwise `false`.
+  */
+  async isDirectory(key) {
+    return Promise.resolve(this.isDirectorySync(key));
+  }
+  /**
+  * Synchronously checks if the given key is a file.
+  *
+  * @param key - The key to check.
+  * @returns `true` if the key is a file, otherwise `false`.
+  */
+  isFileSync(key) {
+    return this.existsSync(key) && !this.isDirectorySync(key);
+  }
+  /**
+  * Checks if the given key is a file.
+  *
+  * @param key - The key to check.
+  * @returns A promise that resolves to `true` if the key is a file, otherwise `false`.
+  */
+  async isFile(key) {
+    return Promise.resolve(this.isFileSync(key));
+  }
+  /**
   * Disposes of the storage adapter, releasing any held resources.
   *
   * @returns A promise that resolves when the disposal is complete.
@@ -1353,7 +1427,7 @@ var FileSystemStorageAdapter = class extends BaseStorageAdapter {
   */
   async set(key, value) {
     if (!this.options.isReadOnly) {
-      return writeFile$1(this.resolve(key), value);
+      return writeFile(this.resolve(key), value);
     }
   }
   /**
@@ -1381,6 +1455,22 @@ var FileSystemStorageAdapter = class extends BaseStorageAdapter {
     }
   }
   /**
+  * Synchronously creates a directory at the specified path.
+  *
+  * @param dirPath - The path of the directory to create.
+  */
+  mkdirSync(dirPath) {
+    createDirectorySync(this.resolve(dirPath));
+  }
+  /**
+  * Creates a directory at the specified path.
+  *
+  * @param dirPath - The path of the directory to create.
+  */
+  async mkdir(dirPath) {
+    await createDirectory(this.resolve(dirPath));
+  }
+  /**
   * Lists all keys under a given base path synchronously.
   *
   * @param base - The base path to list keys from.
@@ -1406,6 +1496,24 @@ var FileSystemStorageAdapter = class extends BaseStorageAdapter {
       ignore: this.options.ignore
     }).catch(ignoreNotfound).then((r) => r || []);
   }
+  /**
+  * Synchronously checks if the given key is a directory.
+  *
+  * @param key - The key to check.
+  * @returns `true` if the key is a directory, otherwise `false`.
+  */
+  isDirectorySync(key) {
+    return isDirectory(this.resolve(key));
+  }
+  /**
+  * Synchronously checks if the given key is a file.
+  *
+  * @param key - The key to check.
+  * @returns `true` if the key is a file, otherwise `false`.
+  */
+  isFileSync(key) {
+    return !isFile(this.resolve(key));
+  }
 };
 var VirtualStorageAdapter = class extends BaseStorageAdapter {
   static {
@@ -1536,7 +1644,11 @@ var VirtualFileSystem = class _VirtualFileSystem {
   * @returns The normalized module id.
   */
   #normalizeId(id) {
-    return normalizeId(id, this.#context.config.output.builtinPrefix);
+    let normalized = id;
+    if (isParentPath(normalized, this.#context.builtinsPath)) {
+      normalized = replacePath(normalized, this.#context.builtinsPath);
+    }
+    return normalizeId(normalized, this.#context.config.output.builtinPrefix);
   }
   /**
   * Normalizes a given path by resolving it against the project root, workspace root, and built-ins path.
@@ -1545,7 +1657,7 @@ var VirtualFileSystem = class _VirtualFileSystem {
   * @returns The normalized path.
   */
   #normalizePath(path) {
-    return normalizePath(path, this.#context.builtinsPath, this.#context.config.output.builtinPrefix);
+    return normalizePath(path.includes("{") || path.includes("}") ? replacePathTokens(this.#context, path) : path, this.#context.builtinsPath, this.#context.config.output.builtinPrefix);
   }
   /**
   * Builds a regular expression from a string pattern for path matching.
@@ -1772,26 +1884,65 @@ var VirtualFileSystem = class _VirtualFileSystem {
     return this.#getStorage(resolved)?.adapter?.name === "virtual";
   }
   /**
+  * Checks if a path is a directory in the virtual file system (VFS).
+  *
+  * @param path - The path to check.
+  * @returns `true` if the path is a directory, otherwise `false`.
+  */
+  isDirectorySync(path) {
+    const resolved = this.resolveSync(path);
+    if (!resolved) {
+      return false;
+    }
+    return !!(this.existsSync(resolved) && this.#getStorage(resolved)?.adapter?.isDirectorySync(resolved));
+  }
+  /**
+  * Checks if a path is a directory in the virtual file system (VFS).
+  *
+  * @param path - The path to check.
+  * @returns `true` if the path is a directory, otherwise `false`.
+  */
+  async isDirectory(path) {
+    const resolved = await this.resolve(path);
+    if (!resolved) {
+      return false;
+    }
+    return !!(await this.exists(resolved) && await this.#getStorage(resolved)?.adapter?.isDirectory(resolved));
+  }
+  /**
+  * Checks if a path is a file in the virtual file system (VFS).
+  *
+  * @param path - The path to check.
+  * @returns `true` if the path is a file, otherwise `false`.
+  */
+  isFileSync(path) {
+    const resolved = this.resolveSync(path);
+    if (!resolved) {
+      return false;
+    }
+    return this.#getStorage(resolved)?.adapter?.isFileSync(resolved) ?? false;
+  }
+  /**
+  * Checks if a path is a file in the virtual file system (VFS).
+  *
+  * @param path - The path to check.
+  * @returns `true` if the path is a file, otherwise `false`.
+  */
+  async isFile(path) {
+    const resolved = await this.resolve(path);
+    if (!resolved) {
+      return false;
+    }
+    return await this.#getStorage(resolved)?.adapter?.isFile(resolved) ?? false;
+  }
+  /**
   * Lists files in a given path.
   *
   * @param path - The path to list files from.
   * @returns An array of file names in the specified path.
   */
   listSync(path) {
-    let maskedMounts = [];
-    const allKeys = [];
-    for (const storage of this.#getStorages(path, true)) {
-      for (const key of storage.adapter.listSync(storage.relativeBase)) {
-        if (!maskedMounts.some((p) => `${storage.base}${normalizeKey(key)}`.startsWith(p))) {
-          allKeys.push(`${storage.base}${normalizeKey(key)}`);
-        }
-      }
-      maskedMounts = [
-        storage.base,
-        ...maskedMounts.filter((p) => !p.startsWith(storage.base))
-      ];
-    }
-    return allKeys.filter((key) => filterKeyByBase(key, path));
+    return getUnique(this.#getStorages(path, true).map((storage) => storage.adapter.listSync(storage.relativeBase ? storage.base ? appendPath(storage.relativeBase, storage.base) : storage.relativeBase : storage.base)).flat());
   }
   /**
   * Lists files in a given path.
@@ -1800,20 +1951,7 @@ var VirtualFileSystem = class _VirtualFileSystem {
   * @returns An array of file names in the specified path.
   */
   async list(path) {
-    let maskedMounts = [];
-    const allKeys = [];
-    for (const storage of this.#getStorages(path, true)) {
-      for (const key of await storage.adapter.list(storage.relativeBase)) {
-        if (!maskedMounts.some((p) => `${storage.base}${normalizeKey(key)}`.startsWith(p))) {
-          allKeys.push(`${storage.base}${normalizeKey(key)}`);
-        }
-      }
-      maskedMounts = [
-        storage.base,
-        ...maskedMounts.filter((p) => !p.startsWith(storage.base))
-      ];
-    }
-    return allKeys.filter((key) => filterKeyByBase(key, path));
+    return getUnique((await Promise.all(this.#getStorages(path, true).map(async (storage) => storage.adapter.list(storage.relativeBase ? storage.base ? appendPath(storage.relativeBase, storage.base) : storage.relativeBase : storage.base)))).flat());
   }
   /**
   * Removes a file in the virtual file system (VFS).
@@ -1865,12 +2003,16 @@ var VirtualFileSystem = class _VirtualFileSystem {
   */
   async glob(patterns) {
     const results = [];
-    for (const pattern of toArray(patterns)) {
+    for (const pattern of normalizeGlobPatterns(this.#context.workspaceConfig.workspaceRoot, patterns)) {
       const normalized = this.#normalizePath(pattern);
       if (!/[*?[\]{}]/.test(normalized) && !normalized.includes("**")) {
-        const resolved = this.resolveSync(normalized);
-        if (resolved && !results.includes(resolved)) {
-          results.push(resolved);
+        if (this.isDirectorySync(normalized)) {
+          results.push(...await this.list(normalized));
+        } else {
+          const resolved = await this.resolve(normalized);
+          if (resolved && !results.includes(resolved)) {
+            results.push(resolved);
+          }
         }
         continue;
       }
@@ -1896,12 +2038,16 @@ var VirtualFileSystem = class _VirtualFileSystem {
   */
   globSync(patterns) {
     const results = [];
-    for (const pattern of toArray(patterns)) {
+    for (const pattern of normalizeGlobPatterns(this.#context.workspaceConfig.workspaceRoot, patterns)) {
       const normalized = this.#normalizePath(pattern);
       if (!/[*?[\]{}]/.test(normalized) && !normalized.includes("**")) {
-        const resolved = this.resolveSync(normalized);
-        if (resolved && !results.includes(resolved)) {
-          results.push(resolved);
+        if (this.isDirectorySync(normalized)) {
+          results.push(...this.listSync(normalized));
+        } else {
+          const resolved = this.resolveSync(normalized);
+          if (resolved && !results.includes(resolved)) {
+            results.push(resolved);
+          }
         }
         continue;
       }
@@ -1927,20 +2073,27 @@ var VirtualFileSystem = class _VirtualFileSystem {
   * @param destPath - The destination path to copy to
   */
   async copy(srcPath, destPath) {
-    if (hasFileExtension(srcPath)) {
-      const content = await this.read(srcPath);
+    const src = srcPath instanceof URL ? fileURLToPath(srcPath) : srcPath;
+    const dest = destPath instanceof URL ? fileURLToPath(destPath) : destPath;
+    if (!isSetString(src) && (!isSetObject(src) || !isSetString(src.input)) || !isSetString(dest)) {
+      return;
+    }
+    const sourceStr = isString(src) ? src : src.input ? src.input : this.#context.workspaceConfig.workspaceRoot;
+    const source = await this.resolve(sourceStr);
+    if (!source) {
+      return;
+    }
+    if (this.isDirectorySync(source) || isSetString(src) && src.includes("*") || isSetObject(src) && isSetString(src.glob)) {
+      await Promise.all((await this.glob(src)).map(async (file) => {
+        return this.copy(file, appendPath(replacePath(file, sourceStr), dest));
+      }));
+    } else {
+      const content = await this.read(source);
       if (content !== void 0) {
-        await this.write(hasFileExtension(destPath) ? destPath : joinPaths$1(destPath, findFileName(srcPath)), content);
+        await this.write(this.#normalizePath(dest), content, {
+          skipFormat: true
+        });
       }
-    } else {
-      await Promise.all((await this.list(srcPath)).map(async (file) => {
-        const relativePath2 = file.replace(this.#normalizePath(srcPath), "");
-        const destinationPath = this.#normalizePath(appendPath(destPath, relativePath2));
-        const content = await this.read(file);
-        if (content !== void 0) {
-          await this.write(destinationPath, content);
-        }
-      }));
     }
   }
   /**
@@ -1950,20 +2103,27 @@ var VirtualFileSystem = class _VirtualFileSystem {
   * @param destPath - The destination path to copy to
   */
   copySync(srcPath, destPath) {
-    if (hasFileExtension(srcPath)) {
-      const content = this.readSync(srcPath);
+    const src = srcPath instanceof URL ? fileURLToPath(srcPath) : srcPath;
+    const dest = destPath instanceof URL ? fileURLToPath(destPath) : destPath;
+    if (!isSetString(src) && (!isSetObject(src) || !isSetString(src.input)) || !isSetString(dest)) {
+      return;
+    }
+    const sourceStr = isString(src) ? src : src.input ? src.input : this.#context.workspaceConfig.workspaceRoot;
+    const source = this.resolveSync(sourceStr);
+    if (!source) {
+      return;
+    }
+    if (this.isDirectorySync(source) || isSetString(src) && src.includes("*") || isSetObject(src) && isSetString(src.glob)) {
+      this.globSync(src).map((file) => {
+        return this.copySync(file, appendPath(findFilePath(replacePath(file, sourceStr)), dest));
+      });
+    } else {
+      const content = this.readSync(source);
       if (content !== void 0) {
-        this.writeSync(hasFileExtension(destPath) ? destPath : joinPaths$1(destPath, findFileName(srcPath)), content);
+        this.writeSync(this.#normalizePath(hasFileExtension(dest) ? dest : appendPath(findFileName(source), dest)), content, {
+          skipFormat: true
+        });
       }
-    } else {
-      this.listSync(srcPath).forEach((file) => {
-        const relativePath2 = file.replace(this.#normalizePath(srcPath), "");
-        const destinationPath = this.#normalizePath(appendPath(destPath, relativePath2));
-        const content = this.readSync(file);
-        if (content !== void 0) {
-          this.writeSync(destinationPath, content);
-        }
-      });
     }
   }
   /**
@@ -2050,15 +2210,15 @@ var VirtualFileSystem = class _VirtualFileSystem {
       }
     }
     const { relativeKey, adapter } = this.#getStorage(path);
-    this.#log(LogLevelLabel.TRACE, `Writing ${this.#normalizePath(path)} to ${adapter.name === "virtual" ? "the virtual file system" : adapter.name === "file-system" ? "the local file system" : adapter.name} (size: ${prettyBytes(new Blob(toArray(code)).size)})`);
-    const id = options?.meta?.id || this.#normalizeId(path);
+    this.#log(LogLevelLabel.TRACE, `Writing ${this.#normalizePath(relativeKey)} to ${adapter.name === "virtual" ? "the virtual file system" : adapter.name === "file-system" ? "the local file system" : adapter.name} (size: ${prettyBytes(new Blob(toArray(code)).size)})`);
+    const id = options?.meta?.id || this.#normalizeId(relativeKey);
     this.#metadata[id] = {
       variant: "normal",
       timestamp: Date.now(),
       ...options.meta ?? {}
     };
-    this.#paths[id] = this.#normalizePath(path);
-    this.#ids[this.#normalizePath(path)] = id;
+    this.#paths[id] = this.#normalizePath(relativeKey);
+    this.#ids[this.#normalizePath(relativeKey)] = id;
     return adapter.set(relativeKey, code);
   }
   /**
@@ -2070,18 +2230,34 @@ var VirtualFileSystem = class _VirtualFileSystem {
   */
   writeSync(path, data = "", options = {}) {
     const { relativeKey, adapter } = this.#getStorage(path);
-    this.#log(LogLevelLabel.TRACE, `Writing ${this.#normalizePath(path)} file to ${adapter.name === "virtual" ? "the virtual file system" : adapter.name === "file-system" ? "the local file system" : adapter.name} (size: ${prettyBytes(new Blob(toArray(data)).size)})`);
-    const id = options?.meta?.id || this.#normalizeId(path);
+    this.#log(LogLevelLabel.TRACE, `Writing ${this.#normalizePath(relativeKey)} file to ${adapter.name === "virtual" ? "the virtual file system" : adapter.name === "file-system" ? "the local file system" : adapter.name} (size: ${prettyBytes(new Blob(toArray(data)).size)})`);
+    const id = options?.meta?.id || this.#normalizeId(relativeKey);
     this.#metadata[id] = {
       variant: "normal",
       timestamp: Date.now(),
       ...options.meta ?? {}
     };
-    this.#paths[id] = this.#normalizePath(path);
-    this.#ids[this.#normalizePath(path)] = id;
+    this.#paths[id] = this.#normalizePath(relativeKey);
+    this.#ids[this.#normalizePath(relativeKey)] = id;
     return adapter.setSync(relativeKey, data);
   }
   /**
+  * Synchronously creates a directory at the specified path.
+  *
+  * @param dirPath - The path of the directory to create.
+  */
+  mkdirSync(dirPath) {
+    return this.#getStorage(dirPath)?.adapter?.mkdirSync(dirPath);
+  }
+  /**
+  * Creates a directory at the specified path.
+  *
+  * @param path - The path of the directory to create.
+  */
+  async mkdir(path) {
+    return this.#getStorage(path)?.adapter?.mkdir(path);
+  }
+  /**
   * Retrieves the metadata of a file in the virtual file system (VFS).
   *
   * @param pathOrId - The path or ID of the file to retrieve metadata for.
@@ -2111,11 +2287,15 @@ var VirtualFileSystem = class _VirtualFileSystem {
   * @returns A promise that resolves to the resolved module path.
   */
   async resolve(id, importer, options = {}) {
-    if (isAbsolutePath(id)) {
-      return id;
+    let path = id;
+    if (path.includes("{") || path.includes("}")) {
+      path = replacePathTokens(this.#context, path);
+    }
+    if (isAbsolutePath(path)) {
+      return path;
     }
     const resolverCacheKey = murmurhash({
-      id: this.#normalizeId(id),
+      path: this.#normalizeId(path),
       importer,
       options
     });
@@ -2126,7 +2306,7 @@ var VirtualFileSystem = class _VirtualFileSystem {
         return result;
       }
     }
-    result = this.paths[this.#normalizeId(id)];
+    result = this.paths[this.#normalizeId(path)];
     if (!result) {
       const paths = options.paths ?? [];
       if (importer && !paths.includes(importer)) {
@@ -2135,8 +2315,8 @@ var VirtualFileSystem = class _VirtualFileSystem {
       paths.push(this.#context.workspaceConfig.workspaceRoot);
       paths.push(appendPath(this.#context.config.projectRoot, this.#context.workspaceConfig.workspaceRoot));
       paths.push(appendPath(this.#context.config.sourceRoot, this.#context.workspaceConfig.workspaceRoot));
-      paths.push(...Object.keys(this.#context.tsconfig.options.paths ?? {}).filter((tsconfigPath) => id.startsWith(tsconfigPath.replace(/\*$/, ""))).map((tsconfigPath) => this.#context.tsconfig.options.paths?.[tsconfigPath]).flat().filter(Boolean).map((tsconfigPath) => appendPath(tsconfigPath, this.#context.workspaceConfig.workspaceRoot)));
-      for (const combination of getResolutionCombinations(id, {
+      paths.push(...Object.keys(this.#context.tsconfig?.options?.paths ?? {}).filter((tsconfigPath) => path.startsWith(tsconfigPath.replace(/\*$/, ""))).map((tsconfigPath) => this.#context.tsconfig?.options?.paths?.[tsconfigPath]).flat().filter(Boolean).map((tsconfigPath) => appendPath(tsconfigPath, this.#context.workspaceConfig.workspaceRoot)));
+      for (const combination of getResolutionCombinations(path, {
         paths
       })) {
         const { relativeKey, adapter } = this.#getStorage(combination);
@@ -2145,19 +2325,18 @@ var VirtualFileSystem = class _VirtualFileSystem {
           break;
         }
       }
-      try {
-        result = await resolve$1(id, {
-          ...options,
-          paths
-        });
-      } catch {
+      if (!result) {
+        try {
+          result = await resolve$1(path, {
+            ...options,
+            paths
+          });
+        } catch {
+        }
       }
     }
-    if (result) {
-      result = toAbsolutePath(appendPath(result, this.#context.config.projectRoot), this.#context.workspaceConfig.workspaceRoot);
-      if (!this.#context.config.skipCache) {
-        this.resolverCache.set(resolverCacheKey, result);
-      }
+    if (result && !this.#context.config.skipCache) {
+      this.resolverCache.set(resolverCacheKey, result);
     }
     return result;
   }
@@ -2178,17 +2357,21 @@ var VirtualFileSystem = class _VirtualFileSystem {
   * @returns The resolved module path.
   */
   resolveSync(id, importer, options = {}) {
-    if (isAbsolutePath(id)) {
-      return id;
+    let path = id;
+    if (path.includes("{") || path.includes("}")) {
+      path = replacePathTokens(this.#context, path);
+    }
+    if (isAbsolutePath(path)) {
+      return path;
     }
     let result;
     if (!this.#context.config.skipCache) {
-      result = this.resolverCache.get(this.#normalizeId(id));
+      result = this.resolverCache.get(this.#normalizeId(path));
       if (result) {
         return result;
       }
     }
-    result = this.paths[this.#normalizeId(id)];
+    result = this.paths[this.#normalizeId(path)];
     if (!result) {
       const paths = options.paths ?? [];
       if (importer && !paths.includes(importer)) {
@@ -2197,8 +2380,8 @@ var VirtualFileSystem = class _VirtualFileSystem {
       paths.push(this.#context.workspaceConfig.workspaceRoot);
       paths.push(appendPath(this.#context.config.projectRoot, this.#context.workspaceConfig.workspaceRoot));
       paths.push(appendPath(this.#context.config.sourceRoot, this.#context.workspaceConfig.workspaceRoot));
-      paths.push(...Object.keys(this.#context.tsconfig.options.paths ?? {}).filter((tsconfigPath) => id.startsWith(tsconfigPath.replace(/\*$/, ""))).map((tsconfigPath) => this.#context.tsconfig.options.paths?.[tsconfigPath]).flat().filter(Boolean).map((tsconfigPath) => appendPath(tsconfigPath, this.#context.workspaceConfig.workspaceRoot)));
-      for (const combination of getResolutionCombinations(id, {
+      paths.push(...Object.keys(this.#context.tsconfig?.options?.paths ?? {}).filter((tsconfigPath) => path.startsWith(tsconfigPath.replace(/\*$/, ""))).map((tsconfigPath) => this.#context.tsconfig?.options?.paths?.[tsconfigPath]).flat().filter(Boolean).map((tsconfigPath) => appendPath(tsconfigPath, this.#context.workspaceConfig.workspaceRoot)));
+      for (const combination of getResolutionCombinations(path, {
         paths
       })) {
         const { relativeKey, adapter } = this.#getStorage(combination);
@@ -2207,18 +2390,18 @@ var VirtualFileSystem = class _VirtualFileSystem {
           break;
         }
       }
-      try {
-        result = resolveSync(id, {
-          paths
-        });
-      } catch {
+      if (!result) {
+        try {
+          result = resolveSync(path, {
+            ...options,
+            paths
+          });
+        } catch {
+        }
       }
     }
-    if (result) {
-      result = toAbsolutePath(appendPath(result, this.#context.config.projectRoot), this.#context.workspaceConfig.workspaceRoot);
-      if (!this.#context.config.skipCache) {
-        this.resolverCache.set(this.#normalizeId(id), result);
-      }
+    if (result && !this.#context.config.skipCache) {
+      this.resolverCache.set(this.#normalizeId(path), result);
     }
     return result;
   }
@@ -2299,16 +2482,29 @@ var VirtualFileSystem = class _VirtualFileSystem {
 
 // ../powerlines/src/lib/contexts/context.ts
 var configCache = /* @__PURE__ */ new WeakMap();
+var agent = new Agent({
+  keepAliveTimeout: 1e4
+});
+setGlobalDispatcher(agent.compose(interceptors.retry({
+  maxRetries: 3,
+  minTimeout: 1e3,
+  maxTimeout: 1e4,
+  timeoutFactor: 2,
+  retryAfter: true
+})));
 var PowerlinesContext = class _PowerlinesContext {
   static {
     __name(this, "PowerlinesContext");
   }
   /**
-  * Internal reference to the API instance
+  * Internal references storage
+  *
+  * @danger
+  * This field is for internal use only and should not be accessed or modified directly. It is unstable and can be changed at anytime.
   *
   * @internal
   */
-  #api;
+  #internal = {};
   #workspaceConfig;
   #checksum = null;
   #buildId = uuid();
@@ -2318,7 +2514,8 @@ var PowerlinesContext = class _PowerlinesContext {
   #fs;
   #tsconfig;
   #program;
-  #resolvePatterns = [];
+  #parserCache;
+  #requestCache;
   #getConfigProps(config = {}) {
     return {
       variant: config.build?.variant,
@@ -2342,7 +2539,8 @@ var PowerlinesContext = class _PowerlinesContext {
       lint: config.lint,
       transform: config.transform,
       build: config.build,
-      framework: config.framework
+      framework: config.framework,
+      ...config
     };
   }
   /**
@@ -2390,14 +2588,30 @@ var PowerlinesContext = class _PowerlinesContext {
   */
   resolver;
   /**
+  * The resolved configuration options
+  */
+  resolvePatterns = [];
+  /**
   * Internal context fields and methods
   *
+  * @danger
+  * This field is for internal use only and should not be accessed or modified directly. It is unstable and can be changed at anytime.
+  *
   * @internal
   */
   get $$internal() {
-    return {
-      api: this.#api
-    };
+    return this.#internal;
+  }
+  /**
+  * Internal context fields and methods
+  *
+  * @danger
+  * This field is for internal use only and should not be accessed or modified directly. It is unstable and can be changed at anytime.
+  *
+  * @internal
+  */
+  set $$internal(value) {
+    this.#internal = value;
   }
   /**
   * The resolved entry type definitions for the project
@@ -2421,7 +2635,7 @@ var PowerlinesContext = class _PowerlinesContext {
   */
   set tsconfig(value) {
     this.#tsconfig = value;
-    this.#resolvePatterns = tsconfigPathsToRegExp(value?.options?.paths ?? {});
+    this.resolvePatterns = tsconfigPathsToRegExp(value?.options?.paths ?? {});
   }
   /**
   * The virtual file system interface for the project
@@ -2562,6 +2776,131 @@ var PowerlinesContext = class _PowerlinesContext {
     return this.#program;
   }
   /**
+  * Gets the parser cache.
+  */
+  get parserCache() {
+    if (!this.#parserCache) {
+      this.#parserCache = create({
+        cacheId: "parser",
+        cacheDir: this.cachePath,
+        ttl: 2 * 60 * 60 * 1e3,
+        lruSize: 5e3,
+        persistInterval: 250
+      });
+    }
+    return this.#parserCache;
+  }
+  /**
+  * Gets the request cache.
+  */
+  get requestCache() {
+    if (!this.#requestCache) {
+      this.#requestCache = create({
+        cacheId: "http",
+        cacheDir: this.cachePath,
+        ttl: 5 * 60 * 1e3,
+        lruSize: 5e3,
+        persistInterval: 250
+      });
+    }
+    return this.#requestCache;
+  }
+  /**
+  * A function to perform HTTP fetch requests
+  *
+  * @remarks
+  * This function uses a caching layer to avoid duplicate requests during the Powerlines process.
+  *
+  * @example
+  * ```ts
+  * const response = await context.fetch("https://api.example.com/data");
+  * const data = await response.json();
+  * ```
+  *
+  * @see https://github.com/nodejs/undici
+  *
+  * @param input - The URL to fetch.
+  * @param options - The fetch request options.
+  * @returns A promise that resolves to a response returned by the fetch.
+  */
+  async fetch(input, options = {}) {
+    const cacheKey = murmurhash({
+      input: input.toString(),
+      options: JSON.stringify(options)
+    });
+    if (!this.config.skipCache && !options.skipCache) {
+      const cached = this.requestCache.get(cacheKey);
+      if (cached) {
+        return new Response(cached.body, {
+          status: cached.status,
+          statusText: cached.statusText,
+          headers: cached.headers
+        });
+      }
+    }
+    const response = await fetchRequest(input, {
+      timeout: 12e3,
+      ...options
+    });
+    const result = {
+      body: await response.text(),
+      status: response.status,
+      statusText: response.statusText,
+      headers: Object.fromEntries(response.headers.entries())
+    };
+    if (!this.config.skipCache && !options.skipCache) {
+      try {
+        this.requestCache.set(cacheKey, result);
+      } catch {
+      }
+    }
+    return new Response(result.body, {
+      status: result.status,
+      statusText: result.statusText,
+      headers: result.headers
+    });
+  }
+  /**
+  * Parse code using [Oxc-Parser](https://github.com/oxc/oxc) into an (ESTree-compatible)[https://github.com/estree/estree] AST object.
+  *
+  * @remarks
+  * This function can be used to parse TypeScript code into an AST for further analysis or transformation.
+  *
+  * @example
+  * ```ts
+  * const ast = context.parse("const x: number = 42;");
+  * ```
+  *
+  * @see https://rollupjs.org/plugin-development/#this-parse
+  * @see https://github.com/oxc/oxc
+  *
+  * @param code - The source code to parse.
+  * @param options - The options to pass to the parser.
+  * @returns An (ESTree-compatible)[https://github.com/estree/estree] AST object.
+  */
+  async parse(code, options = {}) {
+    const cacheKey = murmurhash({
+      code,
+      options
+    });
+    let result;
+    if (!this.config.skipCache) {
+      result = this.parserCache.get(cacheKey);
+      if (result) {
+        return result;
+      }
+    }
+    result = await parse(`source.${options.lang || "ts"}`, code, {
+      ...options,
+      sourceType: "module",
+      showSemanticErrors: this.config.mode === "development"
+    });
+    if (!this.config.skipCache) {
+      this.parserCache.set(cacheKey, result);
+    }
+    return result;
+  }
+  /**
   * A helper function to resolve modules in the Virtual File System
   *
   * @remarks
@@ -2606,7 +2945,7 @@ var PowerlinesContext = class _PowerlinesContext {
       };
     }
     if (this.config.build.skipNodeModulesBundle) {
-      if (match(moduleId, this.#resolvePatterns) || match(moduleId, this.config.build.noExternal)) {
+      if (match(moduleId, this.resolvePatterns) || match(moduleId, this.config.build.noExternal)) {
         return void 0;
       }
       if (match(moduleId, this.config.build.external) || moduleId.startsWith("node:")) {
@@ -2800,6 +3139,26 @@ var PowerlinesContext = class _PowerlinesContext {
     return extendLog(this.log, name);
   }
   /**
+  * Generates a checksum representing the current context state
+  *
+  * @param root - The root directory of the project to generate the checksum for
+  * @returns A promise that resolves to a string representing the checksum
+  */
+  async generateChecksum(root = this.config.projectRoot) {
+    this.#checksum = await hashDirectory(root, {
+      ignore: [
+        "node_modules",
+        ".git",
+        ".nx",
+        ".cache",
+        ".storm",
+        "tmp",
+        "dist"
+      ]
+    });
+    return this.#checksum;
+  }
+  /**
   * Creates a new StormContext instance.
   *
   * @param workspaceConfig - The workspace configuration.
@@ -2821,26 +3180,6 @@ var PowerlinesContext = class _PowerlinesContext {
   */
   logFn;
   /**
-  * Generates a checksum representing the current context state
-  *
-  * @param root - The root directory of the project to generate the checksum for
-  * @returns A promise that resolves to a string representing the checksum
-  */
-  async generateChecksum(root = this.config.projectRoot) {
-    this.#checksum = await hashDirectory(root, {
-      ignore: [
-        "node_modules",
-        ".git",
-        ".nx",
-        ".cache",
-        ".storm",
-        "tmp",
-        "dist"
-      ]
-    });
-    return this.#checksum;
-  }
-  /**
   * Initialize the context with the provided configuration options
   *
   * @param config - The partial user configuration to use for initialization.
@@ -3213,36 +3552,90 @@ var PowerlinesEnvironmentContext = class _PowerlinesEnvironmentContext extends P
   * Retrieves the hook handlers for a specific hook name
   */
   selectHooks(hook, options) {
-    const handlers = [];
+    const result = [];
     if (this.hooks[hook]) {
       if (!isHookExternal(hook)) {
         const hooks = this.hooks[hook];
         if (options?.order) {
           if (options?.order === "pre") {
-            handlers.push(...(hooks.preOrdered ?? []).map((h) => h.handler));
-            handlers.push(...(hooks.preEnforced ?? []).map((h) => h.handler));
+            result.push(...(hooks.preOrdered ?? []).map((h) => {
+              const plugin = this.plugins.find((p) => p.plugin.name === h.plugin.name);
+              if (!plugin) {
+                throw new Error(`Could not find plugin context for plugin "${h.plugin.name}".`);
+              }
+              return {
+                handle: h.handler,
+                context: plugin.context
+              };
+            }));
+            result.push(...(hooks.preEnforced ?? []).map((h) => {
+              const plugin = this.plugins.find((p) => p.plugin.name === h.plugin.name);
+              if (!plugin) {
+                throw new Error(`Could not find plugin context for plugin "${h.plugin.name}".`);
+              }
+              return {
+                handle: h.handler,
+                context: plugin.context
+              };
+            }));
           } else if (options?.order === "post") {
-            handlers.push(...(hooks.postOrdered ?? []).map((h) => h.handler));
-            handlers.push(...(hooks.postEnforced ?? []).map((h) => h.handler));
+            result.push(...(hooks.postOrdered ?? []).map((h) => {
+              const plugin = this.plugins.find((p) => p.plugin.name === h.plugin.name);
+              if (!plugin) {
+                throw new Error(`Could not find plugin context for plugin "${h.plugin.name}".`);
+              }
+              return {
+                handle: h.handler,
+                context: plugin.context
+              };
+            }));
+            result.push(...(hooks.postEnforced ?? []).map((h) => {
+              const plugin = this.plugins.find((p) => p.plugin.name === h.plugin.name);
+              if (!plugin) {
+                throw new Error(`Could not find plugin context for plugin "${h.plugin.name}".`);
+              }
+              return {
+                handle: h.handler,
+                context: plugin.context
+              };
+            }));
           } else {
-            handlers.push(...(hooks.normal ?? []).map((h) => h.handler));
+            result.push(...(hooks.normal ?? []).map((h) => {
+              const plugin = this.plugins.find((p) => p.plugin.name === h.plugin.name);
+              if (!plugin) {
+                throw new Error(`Could not find plugin context for plugin "${h.plugin.name}".`);
+              }
+              return {
+                handle: h.handler,
+                context: plugin.context
+              };
+            }));
           }
         } else {
-          handlers.push(...this.selectHooks(hook, {
+          result.push(...this.selectHooks(hook, {
             order: "pre"
           }));
-          handlers.push(...this.selectHooks(hook, {
+          result.push(...this.selectHooks(hook, {
             order: "normal"
           }));
-          handlers.push(...this.selectHooks(hook, {
+          result.push(...this.selectHooks(hook, {
             order: "post"
           }));
         }
       } else {
-        handlers.push(...this.hooks[hook].map((h) => h.handler));
+        result.push(...this.hooks[hook].map((h) => {
+          const plugin = this.plugins.find((p) => p.plugin.name === h.plugin.name);
+          if (!plugin) {
+            throw new Error(`Could not find plugin context for plugin "${h.plugin.name}".`);
+          }
+          return {
+            handle: h.handler,
+            context: plugin.context
+          };
+        }));
       }
     }
-    return handlers;
+    return result;
   }
   constructor(config, workspaceConfig) {
     super(workspaceConfig);
@@ -3275,6 +3668,31 @@ var PowerlinesAPIContext = class _PowerlinesAPIContext extends PowerlinesContext
     return context;
   }
   /**
+  * Internal context fields and methods
+  *
+  * @danger
+  * This field is for internal use only and should not be accessed or modified directly. It is unstable and can be changed at anytime.
+  *
+  * @internal
+  */
+  get $$internal() {
+    return super.$$internal;
+  }
+  /**
+  * Internal context fields and methods
+  *
+  * @danger
+  * This field is for internal use only and should not be accessed or modified directly. It is unstable and can be changed at anytime.
+  *
+  * @internal
+  */
+  set $$internal(value) {
+    super.$$internal = value;
+    for (const environment of Object.values(this.environments)) {
+      environment.$$internal = super.$$internal;
+    }
+  }
+  /**
   * A record of all environments by name
   */
   get environments() {
@@ -3448,7 +3866,9 @@ var PowerlinesAPI = class _PowerlinesAPI {
   */
   static async from(workspaceRoot, config) {
     const api = new _PowerlinesAPI(await PowerlinesAPIContext.from(workspaceRoot, config));
-    api.#context.$$internal.api = api;
+    api.#context.$$internal = {
+      api
+    };
     for (const plugin of api.context.config.plugins ?? []) {
       await api.#addPlugin(plugin);
     }
@@ -3572,9 +3992,13 @@ ${formatLogMessage(context.config)}`);
         let generatedTypes = await emitTypes(context, files);
         context.log(LogLevelLabel.TRACE, `Generating TypeScript declaration file ${context.dtsPath}.`);
         const directives = [];
+        const asNextParam = /* @__PURE__ */ __name((previousResult) => isObject(previousResult) ? previousResult.code : previousResult, "asNextParam");
         let result = await this.callHook("generateTypes", {
           environment: context,
-          order: "pre"
+          sequential: true,
+          order: "pre",
+          result: "merge",
+          asNextParam
         }, generatedTypes);
         if (result) {
           if (isSetObject(result)) {
@@ -3588,7 +4012,10 @@ ${formatLogMessage(context.config)}`);
         }
         result = await this.callHook("generateTypes", {
           environment: context,
-          order: "normal"
+          sequential: true,
+          order: "normal",
+          result: "merge",
+          asNextParam
         }, generatedTypes);
         if (result) {
           if (isSetObject(result)) {
@@ -3602,7 +4029,10 @@ ${formatLogMessage(context.config)}`);
         }
         result = await this.callHook("generateTypes", {
           environment: context,
-          order: "post"
+          sequential: true,
+          order: "post",
+          result: "merge",
+          asNextParam
         }, generatedTypes);
         if (result) {
           if (isSetObject(result)) {
@@ -3614,15 +4044,24 @@ ${formatLogMessage(context.config)}`);
             generatedTypes = result;
           }
         }
-        await context.fs.write(context.dtsPath, `${directives ? `${directives.map((directive) => `/// <reference types="${directive}" />`).join("\n")}
+        if (generatedTypes?.trim() || directives.length > 0) {
+          await context.fs.write(context.dtsPath, `${directives ? `${directives.map((directive) => `/// <reference types="${directive}" />`).join("\n")}
 
 ` : ""}${getFileHeader(context, {
-          directive: null,
-          prettierIgnore: false
-        })}
+            directive: null,
+            prettierIgnore: false
+          })}
 
 ${formatTypes(generatedTypes)}
 `);
+        } else {
+          const dtsRelativePath = getTsconfigDtsPath(context);
+          if (context.tsconfig.tsconfigJson.include && isIncludeMatchFound(dtsRelativePath, context.tsconfig.tsconfigJson.include)) {
+            const normalizedDtsRelativePath = dtsRelativePath.startsWith("./") ? dtsRelativePath.slice(2) : dtsRelativePath;
+            context.tsconfig.tsconfigJson.include = context.tsconfig.tsconfigJson.include.filter((includeValue) => includeValue?.toString() !== normalizedDtsRelativePath);
+            await context.fs.write(context.tsconfig.tsconfigFilePath, JSON.stringify(context.tsconfig.tsconfigJson, null, 2));
+          }
+        }
       }
       context.tsconfig = getParsedTypeScriptConfig(context.workspaceConfig.workspaceRoot, context.config.projectRoot, context.config.tsconfig);
       if (!context.tsconfig) {
@@ -3659,7 +4098,7 @@ ${formatTypes(generatedTypes)}
       for (const file of files) {
         context.log(LogLevelLabel.TRACE, `Adding template file: ${file}`);
         const template = Handlebars.compile(file);
-        await writeFile(context.log, joinPaths$1(context.config.projectRoot, file.replace(".hbs", "")), template(context));
+        await context.fs.write(joinPaths$1(context.config.projectRoot, file.replace(".hbs", "")), template(context));
       }
       await this.callHook("new", {
         environment: context,
@@ -3670,14 +4109,14 @@ ${formatTypes(generatedTypes)}
         for (const file of files2) {
           context.log(LogLevelLabel.TRACE, `Adding application template file: ${file}`);
           const template = Handlebars.compile(file);
-          await writeFile(context.log, joinPaths$1(context.config.projectRoot, file.replace(".hbs", "")), template(context));
+          await context.fs.write(joinPaths$1(context.config.projectRoot, file.replace(".hbs", "")), template(context));
         }
       } else {
         const files2 = await listFiles(joinPaths$1(context.powerlinesPath, "files/library/**/*.hbs"));
         for (const file of files2) {
           context.log(LogLevelLabel.TRACE, `Adding library template file: ${file}`);
           const template = Handlebars.compile(file);
-          await writeFile(context.log, joinPaths$1(context.config.projectRoot, file.replace(".hbs", "")), template(context));
+          await context.fs.write(joinPaths$1(context.config.projectRoot, file.replace(".hbs", "")), template(context));
         }
       }
       await this.callHook("new", {
@@ -3761,15 +4200,12 @@ ${formatTypes(generatedTypes)}
         const destinationPath = joinPaths$1(appendPath(context.config.output.outputPath, context.workspaceConfig.workspaceRoot), "dist");
         if (sourcePath !== destinationPath) {
           context.log(LogLevelLabel.INFO, `Copying build output files from project's build directory (${context.config.output.buildPath}) to the workspace's output directory (${context.config.output.outputPath}).`);
-          await copyFiles({
-            input: sourcePath,
-            glob: "**/*"
-          }, destinationPath);
+          await context.fs.copy(sourcePath, destinationPath);
         }
       }
       await Promise.all(context.config.output.assets.map(async (asset) => {
         context.log(LogLevelLabel.DEBUG, `Copying asset(s): ${chalk5.redBright(context.workspaceConfig.workspaceRoot === asset.input ? asset.glob : joinPaths$1(replacePath(asset.input, context.workspaceConfig.workspaceRoot), asset.glob))} -> ${chalk5.greenBright(joinPaths$1(replacePath(asset.output, context.workspaceConfig.workspaceRoot), asset.glob))} ${Array.isArray(asset.ignore) && asset.ignore.length > 0 ? ` (ignoring: ${asset.ignore.map((i) => chalk5.yellowBright(i)).join(", ")})` : ""}`);
-        await copyFiles(asset, asset.output);
+        await context.fs.copy(asset, asset.output);
       }));
       await this.callHook("build", {
         environment: context,