@powerlines/nx 0.10.45 → 0.10.47

package/dist/{chunk-TCMZZXZF.mjs → chunk-JLOTTRGF.mjs}

@@ -19,6 +19,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';
@@ -37,38 +38,40 @@ 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 { 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 { 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 * 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 { 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)) {
@@ -330,7 +333,9 @@ async function callHook(context, hook, options, ...args) {
         if (!isFunction(handler)) {
           throw new Error(`Plugin hook handler for hook "${hook}" is not a function.`);
         }
-        return Promise.resolve(handler.apply(null, ...args));
+        return Promise.resolve(handler.apply(null, [
+          ...args
+        ]));
       }));
     } else {
       for (const handler of handlers) {
@@ -338,7 +343,9 @@ async function callHook(context, hook, options, ...args) {
           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(handler.apply(null, [
+            ...args
+          ])));
           if (options?.result === "first" && isSet(results[results.length - 1])) {
             break;
           }
@@ -350,12 +357,22 @@ async function callHook(context, hook, options, ...args) {
             sequenceArgs[0] = isFunction(options.asNextParam) ? await Promise.resolve(options.asNextParam(results[0])) : results[0];
           }
           const result = await Promise.resolve(
-            // eslint-disable-next-line ts/no-unsafe-call
-            handler.apply(null, ...sequenceArgs)
+            // eslint-disable-next-line ts/no-unsafe-call, no-useless-call
+            handler.apply(null, [
+              ...sequenceArgs
+            ])
           );
-          results = [
-            result
-          ];
+          if (result) {
+            if (options?.result === "last") {
+              results = [
+                result
+              ];
+            } else {
+              results = [
+                defu(result, results[0] ?? {})
+              ];
+            }
+          }
         }
       }
     }
@@ -521,33 +538,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 +593,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 +642,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 +786,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) {
@@ -1353,7 +1355,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);
     }
   }
   /**
@@ -1536,7 +1538,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 +1551,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.
@@ -2050,15 +2056,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,15 +2076,15 @@ 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);
   }
   /**
@@ -2111,17 +2117,26 @@ 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({
+      path: this.#normalizeId(path),
+      importer,
+      options
+    });
     let result;
     if (!this.#context.config.skipCache) {
-      result = this.resolverCache.get(this.#normalizeId(id));
+      result = this.resolverCache.get(resolverCacheKey);
       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)) {
@@ -2130,8 +2145,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);
@@ -2140,18 +2155,18 @@ var VirtualFileSystem = class _VirtualFileSystem {
           break;
         }
       }
-      try {
-        result = await resolve$1(id, {
-          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(this.#normalizeId(id), result);
-      }
+    if (result && !this.#context.config.skipCache) {
+      this.resolverCache.set(resolverCacheKey, result);
     }
     return result;
   }
@@ -2172,17 +2187,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)) {
@@ -2191,8 +2210,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);
@@ -2201,18 +2220,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;
   }
@@ -2312,7 +2331,8 @@ var PowerlinesContext = class _PowerlinesContext {
   #fs;
   #tsconfig;
   #program;
-  #resolvePatterns = [];
+  #parserCache;
+  #requestCache;
   #getConfigProps(config = {}) {
     return {
       variant: config.build?.variant,
@@ -2336,7 +2356,8 @@ var PowerlinesContext = class _PowerlinesContext {
       lint: config.lint,
       transform: config.transform,
       build: config.build,
-      framework: config.framework
+      framework: config.framework,
+      ...config
     };
   }
   /**
@@ -2384,6 +2405,10 @@ var PowerlinesContext = class _PowerlinesContext {
   */
   resolver;
   /**
+  * The resolved configuration options
+  */
+  resolvePatterns = [];
+  /**
   * Internal context fields and methods
   *
   * @internal
@@ -2415,7 +2440,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
@@ -2556,6 +2581,123 @@ 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 result = await fetchRequest(input, options);
+    if (!this.config.skipCache && !options.skipCache) {
+      try {
+        this.requestCache.set(cacheKey, {
+          body: await result.text(),
+          status: result.status,
+          statusText: result.statusText,
+          headers: Object.fromEntries(result.headers.entries())
+        });
+      } catch {
+      }
+    }
+    return result;
+  }
+  /**
+  * 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
@@ -2571,9 +2713,26 @@ var PowerlinesContext = class _PowerlinesContext {
   * @param options - Additional resolution options.
   * @returns A promise that resolves to the resolved module path.
   */
-  async resolveId(id, importer, options = {}) {
-    if (this.fs.isVirtual(id)) {
-      const result = await this.fs.resolve(id, importer, options);
+  async resolve(id, importer, options = {}) {
+    let moduleId = id;
+    if (this.config.build.alias) {
+      if (Array.isArray(this.config.build.alias)) {
+        const alias = this.config.build.alias.find((a) => match(moduleId, [
+          a.find
+        ]));
+        if (alias) {
+          moduleId = alias.replacement;
+        }
+      } else if (isSetObject(this.config.build.alias) && this.config.build.alias[id]) {
+        moduleId = this.config.build.alias[id];
+      }
+    }
+    if (this.fs.isVirtual(moduleId)) {
+      const result = await this.fs.resolve(moduleId, importer, {
+        conditions: this.config.build.conditions,
+        extensions: this.config.build.extensions,
+        ...options
+      });
       if (!result) {
         return void 0;
       }
@@ -2583,28 +2742,28 @@ var PowerlinesContext = class _PowerlinesContext {
       };
     }
     if (this.config.build.skipNodeModulesBundle) {
-      if (match(id, this.#resolvePatterns) || match(id, this.config.build.noExternal)) {
+      if (match(moduleId, this.resolvePatterns) || match(moduleId, this.config.build.noExternal)) {
         return void 0;
       }
-      if (match(id, this.config.build.external) || id.startsWith("node:")) {
+      if (match(moduleId, this.config.build.external) || moduleId.startsWith("node:")) {
         return {
-          id,
+          id: moduleId,
           external: true
         };
       }
-      if (!/^[A-Z]:[/\\]|^\.{0,2}\/|^\.{1,2}$/.test(id)) {
+      if (!/^[A-Z]:[/\\]|^\.{0,2}\/|^\.{1,2}$/.test(moduleId)) {
         return {
-          id,
+          id: moduleId,
           external: true
         };
       }
     } else {
-      if (match(id, this.config.build.noExternal)) {
+      if (match(moduleId, this.config.build.noExternal)) {
         return void 0;
       }
-      if (match(id, this.config.build.external) || id.startsWith("node:")) {
+      if (match(moduleId, this.config.build.external) || moduleId.startsWith("node:")) {
         return {
-          id,
+          id: moduleId,
           external: true
         };
       }
@@ -2777,6 +2936,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.
@@ -2798,26 +2977,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.
@@ -3030,9 +3189,11 @@ function createPluginContext(plugin, environment) {
   }, "normalizeMessage");
   const log = environment.extendLog(plugin.name);
   const callHookFn = /* @__PURE__ */ __name(async (hook, options, ...args) => {
-    return callHook(environment, hook, {
+    return environment.$$internal.api.callHook(hook, {
       sequential: true,
-      ...options
+      result: "merge",
+      ...options,
+      environment
     }, ...args);
   }, "callHookFn");
   return new Proxy({}, {
@@ -3415,7 +3576,11 @@ var PowerlinesAPI = class _PowerlinesAPI {
     this.#context = context;
   }
   /**
-  * Initialize the Powerlines API
+  * Initialize a Powerlines API instance
+  *
+  * @param workspaceRoot - The directory of the underlying workspace the Powerlines project exists in
+  * @param config - An object containing the configuration required to run Powerlines tasks.
+  * @returns A new instance of the Powerlines API
   */
   static async from(workspaceRoot, config) {
     const api = new _PowerlinesAPI(await PowerlinesAPIContext.from(workspaceRoot, config));
@@ -3543,9 +3708,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)) {
@@ -3559,7 +3728,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)) {
@@ -3573,7 +3745,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)) {
@@ -3585,15 +3760,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) {
@@ -3630,7 +3814,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,
@@ -3641,14 +3825,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", {