powerlines 0.27.0 → 0.29.0

package/dist/plugin-utils/{context-y3G_SQPM.d.cts → context-BwokDIBz.d.cts}

@@ -1,10 +1,13 @@
 import { EnvPaths } from '@stryke/env/get-env-paths';
+import { FetchRequestOptions } from '@stryke/http/fetch';
 import { MaybePromise, NonUndefined, FunctionLike, DeepPartial as DeepPartial$1 } from '@stryke/types/base';
 import { PackageJson } from '@stryke/types/package-json';
 import { Jiti } from 'jiti';
 import { SourceMap } from 'magic-string';
+import { ParserOptions, ParseResult } from 'oxc-parser';
 import { Range } from 'semver';
 import { Project } from 'ts-morph';
+import { RequestInfo, Response } from 'undici';
 import { TransformResult as TransformResult$1, ExternalIdResult, HookFilter, UnpluginOptions, UnpluginContext, UnpluginBuildContext, UnpluginMessage } from 'unplugin';
 import { Format } from '@storm-software/build-tools/types';
 import { LogLevelLabel } from '@storm-software/config-tools/types';
@@ -18,7 +21,7 @@ import ts from 'typescript';
 import { ArrayValues } from '@stryke/types/array';
 
 type UnpluginBuildVariant = "rollup" | "webpack" | "rspack" | "vite" | "esbuild" | "farm" | "unloader" | "rolldown";
-type BuildVariant = UnpluginBuildVariant | "tsup" | "unbuild";
+type BuildVariant = UnpluginBuildVariant | "tsup" | "tsdown" | "unbuild";
 interface BuildConfig {
     /**
      * The platform to build the project for
@@ -220,6 +223,18 @@ interface StorageAdapter {
      * @param key - The key whose value should be removed.
      */
     removeSync: (key: string) => void;
+    /**
+     * Creates a directory at the specified path.
+     *
+     * @param dirPath - The path of the directory to create.
+     */
+    mkdir: (dirPath: string) => Promise<void>;
+    /**
+     * Synchronously creates a directory at the specified path.
+     *
+     * @param dirPath - The path of the directory to create.
+     */
+    mkdirSync: (dirPath: string) => void;
     /**
      * Remove all entries from the storage that match the provided base path.
      *
@@ -246,6 +261,34 @@ interface StorageAdapter {
      * @returns The list of keys.
      */
     listSync: (base?: string) => string[];
+    /**
+     * 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`.
+     */
+    isDirectory: (key: string) => Promise<boolean>;
+    /**
+     * 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: string) => boolean;
+    /**
+     * 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`.
+     */
+    isFile: (key: string) => Promise<boolean>;
+    /**
+     * 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: string) => boolean;
     /**
      * Releases any resources held by the storage adapter.
      */
@@ -381,6 +424,34 @@ interface VirtualFileSystemInterface {
      * @returns `true` if the file is virtual, otherwise `false`.
      */
     isVirtual: (path: string) => boolean;
+    /**
+     * 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`.
+     */
+    isDirectory: (key: string) => Promise<boolean>;
+    /**
+     * 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: string) => boolean;
+    /**
+     * 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`.
+     */
+    isFile: (key: string) => Promise<boolean>;
+    /**
+     * 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: string) => boolean;
     /**
      * Gets the metadata of a file in the virtual file system (VFS).
      *
@@ -446,6 +517,18 @@ interface VirtualFileSystemInterface {
      * @param options - Options for writing the file.
      */
     writeSync: (path: string, data: string, options?: WriteOptions) => void;
+    /**
+     * Creates a directory at the specified path.
+     *
+     * @param dirPath - The path of the directory to create.
+     */
+    mkdir: (dirPath: string) => Promise<void>;
+    /**
+     * Synchronously creates a directory at the specified path.
+     *
+     * @param dirPath - The path of the directory to create.
+     */
+    mkdirSync: (dirPath: string) => void;
     /**
      * Moves a file from one path to another in the virtual file system (VFS).
      *
@@ -466,28 +549,28 @@ interface VirtualFileSystemInterface {
      * @param srcPath - The source path to copy
      * @param destPath - The destination path to copy to
      */
-    copy: (srcPath: string, destPath: string) => Promise<void>;
+    copy: (srcPath: string | URL | Omit<AssetGlob, "output">, destPath: string | URL) => Promise<void>;
     /**
      * Synchronously copies a file from one path to another in the virtual file system (VFS).
      *
      * @param srcPath - The source path to copy
      * @param destPath - The destination path to copy to
      */
-    copySync: (srcPath: string, destPath: string) => void;
+    copySync: (srcPath: string | URL | Omit<AssetGlob, "output">, destPath: string | URL) => void;
     /**
      * Glob files in the virtual file system (VFS) based on the provided pattern(s).
      *
      * @param pattern - A pattern (or multiple patterns) to use to determine the file paths to return
      * @returns An array of file paths matching the provided pattern(s)
      */
-    glob: (pattern: string | string[]) => Promise<string[]>;
+    glob: (patterns: string | Omit<AssetGlob, "output"> | (string | Omit<AssetGlob, "output">)[]) => Promise<string[]>;
     /**
      * Synchronously glob files in the virtual file system (VFS) based on the provided pattern(s).
      *
      * @param pattern - A pattern (or multiple patterns) to use to determine the file paths to return
      * @returns An array of file paths matching the provided pattern(s)
      */
-    globSync: (pattern: string | string[]) => string[];
+    globSync: (patterns: string | Omit<AssetGlob, "output"> | (string | Omit<AssetGlob, "output">)[]) => string[];
     /**
      * A helper function to resolve modules using the Jiti resolver
      *
@@ -558,7 +641,7 @@ type OutputResolvedConfig = Required<Omit<OutputConfig, "assets" | "storage"> &
 /**
  * The resolved options for the Powerlines project configuration.
  */
-type ResolvedConfig<TUserConfig extends UserConfig = UserConfig> = Omit<TUserConfig, "name" | "title" | "plugins" | "mode" | "environments" | "platform" | "tsconfig" | "lint" | "test" | "build" | "transform" | "deploy" | "variant" | "type" | "output" | "logLevel" | "framework"> & Required<Pick<TUserConfig, "name" | "title" | "plugins" | "mode" | "environments" | "tsconfig" | "lint" | "test" | "build" | "transform" | "deploy" | "framework">> & {
+type ResolvedConfig<TUserConfig extends UserConfig = UserConfig> = Omit<TUserConfig, "name" | "title" | "plugins" | "mode" | "environments" | "platform" | "tsconfig" | "lint" | "test" | "build" | "transform" | "deploy" | "variant" | "type" | "output" | "logLevel" | "framework" | "sourceRoot"> & Required<Pick<TUserConfig, "name" | "title" | "plugins" | "mode" | "environments" | "tsconfig" | "lint" | "test" | "build" | "transform" | "deploy" | "framework" | "sourceRoot">> & {
     /**
      * The configuration options that were provided inline to the Powerlines CLI.
      */
@@ -929,6 +1012,22 @@ type PluginConfig<TContext extends PluginContext = PluginContext> = string | Plu
 type PartialPlugin<in out TContext extends PluginContext = PluginContext> = DeepPartial$1<Plugin<TContext>>;
 type PartialPluginFactory<in out TContext extends PluginContext = PluginContext, TOptions = any> = (options: TOptions) => MaybePromise<PartialPlugin<TContext>>;
 type ProjectType = "application" | "library";
+interface DeployConfig {
+    /**
+     * The deployment variant being used by the Powerlines engine.
+     *
+     * @example
+     * ```ts
+     * export default defineConfig({
+     *  deploy: {
+     *    variant: "cloudflare"
+     *  }
+     * });
+     *
+     * ```
+     */
+    variant?: string;
+}
 interface OutputConfig {
     /**
      * The path to output the final compiled files to
@@ -1013,6 +1112,13 @@ interface BaseConfig {
      * Configuration for the output of the build process
      */
     output?: OutputConfig;
+    /**
+     * Configuration for cleaning the build artifacts
+     *
+     * @remarks
+     * If set to `false`, the cleaning process will be disabled.
+     */
+    clean?: Record<string, any> | false;
     /**
      * Configuration for linting the source code
      *
@@ -1051,7 +1157,7 @@ interface BaseConfig {
      * @remarks
      * If set to `false`, the deployment will be disabled.
      */
-    deploy?: Record<string, any> | false;
+    deploy?: DeployConfig | false;
     /**
      * The path to the tsconfig file to be used by the compiler
      *
@@ -1178,7 +1284,7 @@ interface CommonUserConfig extends BaseConfig {
      */
     framework?: string;
 }
-type UserConfig<TBuildConfig extends BuildConfig = BuildConfig, TBuildResolvedConfig extends BuildResolvedConfig = BuildResolvedConfig, TBuildVariant extends string = any> = Omit<CommonUserConfig, "build"> & {
+interface UserConfig<TBuildConfig extends BuildConfig = BuildConfig, TBuildResolvedConfig extends BuildResolvedConfig = BuildResolvedConfig, TBuildVariant extends string = any> extends Omit<CommonUserConfig, "build"> {
     /**
      * Configuration provided to build processes
      *
@@ -1198,7 +1304,7 @@ type UserConfig<TBuildConfig extends BuildConfig = BuildConfig, TBuildResolvedCo
          */
         override?: Partial<TBuildResolvedConfig>;
     };
-};
+}
 type PowerlinesCommand = "new" | "prepare" | "build" | "lint" | "test" | "docs" | "deploy" | "clean";
 /**
  * The configuration provided while executing Powerlines commands.
@@ -1251,6 +1357,18 @@ interface InitContextOptions {
      */
     isHighPriority: boolean;
 }
+interface FetchOptions extends FetchRequestOptions {
+    /**
+     * An indicator specifying that the request should bypass any caching
+     */
+    skipCache?: boolean;
+}
+interface ParseOptions extends ParserOptions {
+    /**
+     * When true this allows return statements to be outside functions to e.g. support parsing CommonJS code.
+     */
+    allowReturnOutsideFunction?: boolean;
+}
 /**
  * The unresolved Powerlines context.
  *
@@ -1267,6 +1385,7 @@ interface UnresolvedContext<TResolvedConfig extends ResolvedConfig = ResolvedCon
      */
     config: Omit<TResolvedConfig["userConfig"], "build" | "output"> & Required<Pick<TResolvedConfig["userConfig"], "build" | "output">> & {
         projectRoot: NonUndefined<TResolvedConfig["userConfig"]["root"]>;
+        sourceRoot: NonUndefined<TResolvedConfig["userConfig"]["sourceRoot"]>;
         output: TResolvedConfig["output"];
     };
     /**
@@ -1386,6 +1505,44 @@ interface UnresolvedContext<TResolvedConfig extends ResolvedConfig = ResolvedCon
      * This instance is created lazily on first access.
      */
     program: Project;
+    /**
+     * 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.
+     */
+    fetch: (input: RequestInfo, options?: FetchOptions) => Promise<Response>;
+    /**
+     * 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.
+     */
+    parse: (code: string, options?: ParseOptions) => Promise<ParseResult>;
     /**
      * A helper function to resolve modules using the Jiti resolver
      *
@@ -1485,6 +1642,6 @@ interface PluginContext<out TResolvedConfig extends ResolvedConfig = ResolvedCon
      */
     logger: LogFn;
 }
-type BuildPluginContext<TResolvedConfig extends ResolvedConfig = ResolvedConfig> = PluginContext<TResolvedConfig> & Omit<UnpluginBuildContext, "parse">;
+type BuildPluginContext<TResolvedConfig extends ResolvedConfig = ResolvedConfig> = UnpluginBuildContext & PluginContext<TResolvedConfig>;
 
 export type { BuildVariant as B, ConfigResult as C, ExternalPluginHookFunctions as E, GenerateTypesResult as G, PluginContext as P, ResolvedConfig as R, UnresolvedContext as U, Plugin as a, PluginFactory as b, PartialPlugin as c, PartialPluginFactory as d, BasePluginHookFunctions as e, PluginHookFunctions as f, PluginHookObject as g, PluginConfigObject as h, PluginConfigTuple as i, PluginConfig as j, PluginHook as k, EnvironmentConfig as l, EnvironmentResolvedConfig as m };

package/dist/plugin-utils/{context-y3G_SQPM.d.ts → context-BwokDIBz.d.ts}

@@ -1,10 +1,13 @@
 import { EnvPaths } from '@stryke/env/get-env-paths';
+import { FetchRequestOptions } from '@stryke/http/fetch';
 import { MaybePromise, NonUndefined, FunctionLike, DeepPartial as DeepPartial$1 } from '@stryke/types/base';
 import { PackageJson } from '@stryke/types/package-json';
 import { Jiti } from 'jiti';
 import { SourceMap } from 'magic-string';
+import { ParserOptions, ParseResult } from 'oxc-parser';
 import { Range } from 'semver';
 import { Project } from 'ts-morph';
+import { RequestInfo, Response } from 'undici';
 import { TransformResult as TransformResult$1, ExternalIdResult, HookFilter, UnpluginOptions, UnpluginContext, UnpluginBuildContext, UnpluginMessage } from 'unplugin';
 import { Format } from '@storm-software/build-tools/types';
 import { LogLevelLabel } from '@storm-software/config-tools/types';
@@ -18,7 +21,7 @@ import ts from 'typescript';
 import { ArrayValues } from '@stryke/types/array';
 
 type UnpluginBuildVariant = "rollup" | "webpack" | "rspack" | "vite" | "esbuild" | "farm" | "unloader" | "rolldown";
-type BuildVariant = UnpluginBuildVariant | "tsup" | "unbuild";
+type BuildVariant = UnpluginBuildVariant | "tsup" | "tsdown" | "unbuild";
 interface BuildConfig {
     /**
      * The platform to build the project for
@@ -220,6 +223,18 @@ interface StorageAdapter {
      * @param key - The key whose value should be removed.
      */
     removeSync: (key: string) => void;
+    /**
+     * Creates a directory at the specified path.
+     *
+     * @param dirPath - The path of the directory to create.
+     */
+    mkdir: (dirPath: string) => Promise<void>;
+    /**
+     * Synchronously creates a directory at the specified path.
+     *
+     * @param dirPath - The path of the directory to create.
+     */
+    mkdirSync: (dirPath: string) => void;
     /**
      * Remove all entries from the storage that match the provided base path.
      *
@@ -246,6 +261,34 @@ interface StorageAdapter {
      * @returns The list of keys.
      */
     listSync: (base?: string) => string[];
+    /**
+     * 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`.
+     */
+    isDirectory: (key: string) => Promise<boolean>;
+    /**
+     * 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: string) => boolean;
+    /**
+     * 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`.
+     */
+    isFile: (key: string) => Promise<boolean>;
+    /**
+     * 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: string) => boolean;
     /**
      * Releases any resources held by the storage adapter.
      */
@@ -381,6 +424,34 @@ interface VirtualFileSystemInterface {
      * @returns `true` if the file is virtual, otherwise `false`.
      */
     isVirtual: (path: string) => boolean;
+    /**
+     * 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`.
+     */
+    isDirectory: (key: string) => Promise<boolean>;
+    /**
+     * 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: string) => boolean;
+    /**
+     * 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`.
+     */
+    isFile: (key: string) => Promise<boolean>;
+    /**
+     * 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: string) => boolean;
     /**
      * Gets the metadata of a file in the virtual file system (VFS).
      *
@@ -446,6 +517,18 @@ interface VirtualFileSystemInterface {
      * @param options - Options for writing the file.
      */
     writeSync: (path: string, data: string, options?: WriteOptions) => void;
+    /**
+     * Creates a directory at the specified path.
+     *
+     * @param dirPath - The path of the directory to create.
+     */
+    mkdir: (dirPath: string) => Promise<void>;
+    /**
+     * Synchronously creates a directory at the specified path.
+     *
+     * @param dirPath - The path of the directory to create.
+     */
+    mkdirSync: (dirPath: string) => void;
     /**
      * Moves a file from one path to another in the virtual file system (VFS).
      *
@@ -466,28 +549,28 @@ interface VirtualFileSystemInterface {
      * @param srcPath - The source path to copy
      * @param destPath - The destination path to copy to
      */
-    copy: (srcPath: string, destPath: string) => Promise<void>;
+    copy: (srcPath: string | URL | Omit<AssetGlob, "output">, destPath: string | URL) => Promise<void>;
     /**
      * Synchronously copies a file from one path to another in the virtual file system (VFS).
      *
      * @param srcPath - The source path to copy
      * @param destPath - The destination path to copy to
      */
-    copySync: (srcPath: string, destPath: string) => void;
+    copySync: (srcPath: string | URL | Omit<AssetGlob, "output">, destPath: string | URL) => void;
     /**
      * Glob files in the virtual file system (VFS) based on the provided pattern(s).
      *
      * @param pattern - A pattern (or multiple patterns) to use to determine the file paths to return
      * @returns An array of file paths matching the provided pattern(s)
      */
-    glob: (pattern: string | string[]) => Promise<string[]>;
+    glob: (patterns: string | Omit<AssetGlob, "output"> | (string | Omit<AssetGlob, "output">)[]) => Promise<string[]>;
     /**
      * Synchronously glob files in the virtual file system (VFS) based on the provided pattern(s).
      *
      * @param pattern - A pattern (or multiple patterns) to use to determine the file paths to return
      * @returns An array of file paths matching the provided pattern(s)
      */
-    globSync: (pattern: string | string[]) => string[];
+    globSync: (patterns: string | Omit<AssetGlob, "output"> | (string | Omit<AssetGlob, "output">)[]) => string[];
     /**
      * A helper function to resolve modules using the Jiti resolver
      *
@@ -558,7 +641,7 @@ type OutputResolvedConfig = Required<Omit<OutputConfig, "assets" | "storage"> &
 /**
  * The resolved options for the Powerlines project configuration.
  */
-type ResolvedConfig<TUserConfig extends UserConfig = UserConfig> = Omit<TUserConfig, "name" | "title" | "plugins" | "mode" | "environments" | "platform" | "tsconfig" | "lint" | "test" | "build" | "transform" | "deploy" | "variant" | "type" | "output" | "logLevel" | "framework"> & Required<Pick<TUserConfig, "name" | "title" | "plugins" | "mode" | "environments" | "tsconfig" | "lint" | "test" | "build" | "transform" | "deploy" | "framework">> & {
+type ResolvedConfig<TUserConfig extends UserConfig = UserConfig> = Omit<TUserConfig, "name" | "title" | "plugins" | "mode" | "environments" | "platform" | "tsconfig" | "lint" | "test" | "build" | "transform" | "deploy" | "variant" | "type" | "output" | "logLevel" | "framework" | "sourceRoot"> & Required<Pick<TUserConfig, "name" | "title" | "plugins" | "mode" | "environments" | "tsconfig" | "lint" | "test" | "build" | "transform" | "deploy" | "framework" | "sourceRoot">> & {
     /**
      * The configuration options that were provided inline to the Powerlines CLI.
      */
@@ -929,6 +1012,22 @@ type PluginConfig<TContext extends PluginContext = PluginContext> = string | Plu
 type PartialPlugin<in out TContext extends PluginContext = PluginContext> = DeepPartial$1<Plugin<TContext>>;
 type PartialPluginFactory<in out TContext extends PluginContext = PluginContext, TOptions = any> = (options: TOptions) => MaybePromise<PartialPlugin<TContext>>;
 type ProjectType = "application" | "library";
+interface DeployConfig {
+    /**
+     * The deployment variant being used by the Powerlines engine.
+     *
+     * @example
+     * ```ts
+     * export default defineConfig({
+     *  deploy: {
+     *    variant: "cloudflare"
+     *  }
+     * });
+     *
+     * ```
+     */
+    variant?: string;
+}
 interface OutputConfig {
     /**
      * The path to output the final compiled files to
@@ -1013,6 +1112,13 @@ interface BaseConfig {
      * Configuration for the output of the build process
      */
     output?: OutputConfig;
+    /**
+     * Configuration for cleaning the build artifacts
+     *
+     * @remarks
+     * If set to `false`, the cleaning process will be disabled.
+     */
+    clean?: Record<string, any> | false;
     /**
      * Configuration for linting the source code
      *
@@ -1051,7 +1157,7 @@ interface BaseConfig {
      * @remarks
      * If set to `false`, the deployment will be disabled.
      */
-    deploy?: Record<string, any> | false;
+    deploy?: DeployConfig | false;
     /**
      * The path to the tsconfig file to be used by the compiler
      *
@@ -1178,7 +1284,7 @@ interface CommonUserConfig extends BaseConfig {
      */
     framework?: string;
 }
-type UserConfig<TBuildConfig extends BuildConfig = BuildConfig, TBuildResolvedConfig extends BuildResolvedConfig = BuildResolvedConfig, TBuildVariant extends string = any> = Omit<CommonUserConfig, "build"> & {
+interface UserConfig<TBuildConfig extends BuildConfig = BuildConfig, TBuildResolvedConfig extends BuildResolvedConfig = BuildResolvedConfig, TBuildVariant extends string = any> extends Omit<CommonUserConfig, "build"> {
     /**
      * Configuration provided to build processes
      *
@@ -1198,7 +1304,7 @@ type UserConfig<TBuildConfig extends BuildConfig = BuildConfig, TBuildResolvedCo
          */
         override?: Partial<TBuildResolvedConfig>;
     };
-};
+}
 type PowerlinesCommand = "new" | "prepare" | "build" | "lint" | "test" | "docs" | "deploy" | "clean";
 /**
  * The configuration provided while executing Powerlines commands.
@@ -1251,6 +1357,18 @@ interface InitContextOptions {
      */
     isHighPriority: boolean;
 }
+interface FetchOptions extends FetchRequestOptions {
+    /**
+     * An indicator specifying that the request should bypass any caching
+     */
+    skipCache?: boolean;
+}
+interface ParseOptions extends ParserOptions {
+    /**
+     * When true this allows return statements to be outside functions to e.g. support parsing CommonJS code.
+     */
+    allowReturnOutsideFunction?: boolean;
+}
 /**
  * The unresolved Powerlines context.
  *
@@ -1267,6 +1385,7 @@ interface UnresolvedContext<TResolvedConfig extends ResolvedConfig = ResolvedCon
      */
     config: Omit<TResolvedConfig["userConfig"], "build" | "output"> & Required<Pick<TResolvedConfig["userConfig"], "build" | "output">> & {
         projectRoot: NonUndefined<TResolvedConfig["userConfig"]["root"]>;
+        sourceRoot: NonUndefined<TResolvedConfig["userConfig"]["sourceRoot"]>;
         output: TResolvedConfig["output"];
     };
     /**
@@ -1386,6 +1505,44 @@ interface UnresolvedContext<TResolvedConfig extends ResolvedConfig = ResolvedCon
      * This instance is created lazily on first access.
      */
     program: Project;
+    /**
+     * 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.
+     */
+    fetch: (input: RequestInfo, options?: FetchOptions) => Promise<Response>;
+    /**
+     * 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.
+     */
+    parse: (code: string, options?: ParseOptions) => Promise<ParseResult>;
     /**
      * A helper function to resolve modules using the Jiti resolver
      *
@@ -1485,6 +1642,6 @@ interface PluginContext<out TResolvedConfig extends ResolvedConfig = ResolvedCon
      */
     logger: LogFn;
 }
-type BuildPluginContext<TResolvedConfig extends ResolvedConfig = ResolvedConfig> = PluginContext<TResolvedConfig> & Omit<UnpluginBuildContext, "parse">;
+type BuildPluginContext<TResolvedConfig extends ResolvedConfig = ResolvedConfig> = UnpluginBuildContext & PluginContext<TResolvedConfig>;
 
 export type { BuildVariant as B, ConfigResult as C, ExternalPluginHookFunctions as E, GenerateTypesResult as G, PluginContext as P, ResolvedConfig as R, UnresolvedContext as U, Plugin as a, PluginFactory as b, PartialPlugin as c, PartialPluginFactory as d, BasePluginHookFunctions as e, PluginHookFunctions as f, PluginHookObject as g, PluginConfigObject as h, PluginConfigTuple as i, PluginConfig as j, PluginHook as k, EnvironmentConfig as l, EnvironmentResolvedConfig as m };

package/dist/plugin-utils/context-helpers.cjs

@@ -1,15 +1,17 @@
 'use strict';
 
-var chunkNFXNZFMN_cjs = require('./chunk-NFXNZFMN.cjs');
-require('./chunk-USNT2KNT.cjs');
+var chunkDUIPLC7F_cjs = require('./chunk-DUIPLC7F.cjs');
+require('./chunk-PK6SKIKE.cjs');
 
 
 
 Object.defineProperty(exports, "getOrganizationName", {
   enumerable: true,
-  get: function () { return chunkNFXNZFMN_cjs.getOrganizationName; }
+  get: function () { return chunkDUIPLC7F_cjs.getOrganizationName; }
 });
 Object.defineProperty(exports, "getWorkspaceName", {
   enumerable: true,
-  get: function () { return chunkNFXNZFMN_cjs.getWorkspaceName; }
+  get: function () { return chunkDUIPLC7F_cjs.getWorkspaceName; }
 });
+//# sourceMappingURL=context-helpers.cjs.map
+//# sourceMappingURL=context-helpers.cjs.map

package/dist/plugin-utils/context-helpers.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"context-helpers.cjs"}

package/dist/plugin-utils/context-helpers.d.cts

@@ -1,11 +1,14 @@
-import { U as UnresolvedContext } from './context-y3G_SQPM.cjs';
+import { U as UnresolvedContext } from './context-BwokDIBz.cjs';
 import '@stryke/env/get-env-paths';
+import '@stryke/http/fetch';
 import '@stryke/types/base';
 import '@stryke/types/package-json';
 import 'jiti';
 import 'magic-string';
+import 'oxc-parser';
 import 'semver';
 import 'ts-morph';
+import 'undici';
 import 'unplugin';
 import '@storm-software/build-tools/types';
 import '@storm-software/config-tools/types';