powerlines 0.36.29 → 0.37.0

package/dist/lib/{config-BSQhtJCR.d.ts → config-BLfOgflT.d.ts}

@@ -1,7 +1,7 @@
 import { Format } from '@storm-software/build-tools/types';
 import { LogLevelLabel } from '@storm-software/config-tools/types';
 import { StormWorkspaceConfig } from '@storm-software/config/types';
-import { NonUndefined, MaybePromise, FunctionLike } from '@stryke/types/base';
+import { NonUndefined, MaybePromise, AnyFunction } from '@stryke/types/base';
 import { TypeDefinition, TypeDefinitionParameter } from '@stryke/types/configuration';
 import { AssetGlob } from '@stryke/types/file';
 import { ResolvedConfig as ResolvedConfig$1, ConfigLayer } from 'c12';
@@ -13,7 +13,7 @@ import { BuildOptions as BuildOptions$1 } from '@storm-software/tsup/types';
 import { UnbuildOptions } from '@storm-software/unbuild/types';
 import { BuildOptions } from 'esbuild';
 import { RolldownOptions } from 'rolldown';
-import { RollupOptions, OutputOptions } from 'rollup';
+import { RollupOptions, OutputOptions, LoadResult } from 'rollup';
 import { UserConfig as UserConfig$2 } from 'tsdown';
 import { Configuration } from 'webpack';
 import { EnvPaths } from '@stryke/env/get-env-paths';
@@ -26,14 +26,14 @@ 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, UnpluginMessage, UnpluginBuildContext } from 'unplugin';
+import { UnpluginOptions as UnpluginOptions$1, HookFilter, UnpluginContextMeta, TransformResult as TransformResult$1, ExternalIdResult, UnpluginContext, UnpluginMessage, UnpluginBuildContext } from 'unplugin';
 import { V as VirtualFileSystemInterface, R as ResolveOptions, a as VirtualFile, W as WriteOptions, c as StoragePort, b as StoragePreset } from './fs-DkLcPGg-.js';
 import { ArrayValues } from '@stryke/types/array';
 import { P as ParsedTypeScriptConfig, T as TSConfig } from './tsconfig-Bz-CiFqD.js';
 
-type UnpluginBuildVariant = "rollup" | "webpack" | "rspack" | "vite" | "esbuild" | "farm" | "unloader" | "rolldown";
-type BuildVariant = UnpluginBuildVariant | "tsup" | "tsdown" | "unbuild";
-type InferUnpluginVariant<TBuildVariant extends BuildVariant> = TBuildVariant extends "tsup" ? "esbuild" : TBuildVariant extends "tsdown" ? "rolldown" : TBuildVariant extends "unbuild" ? "rollup" : TBuildVariant;
+type UnpluginBuilderVariant = "rollup" | "webpack" | "rspack" | "vite" | "esbuild" | "farm" | "unloader" | "rolldown" | "bun";
+type BuilderVariant = UnpluginBuilderVariant | "tsup" | "tsdown" | "unbuild";
+type InferUnpluginVariant<TBuildVariant extends BuilderVariant> = TBuildVariant extends "tsup" ? "esbuild" : TBuildVariant extends "tsdown" ? "rolldown" : TBuildVariant extends "unbuild" ? "rollup" : TBuildVariant;
 interface BuildConfig {
     /**
      * The platform to build the project for
@@ -268,7 +268,7 @@ type ResolvedConfig<TUserConfig extends UserConfig = UserConfig> = Omit<TUserCon
      * Configuration provided to build processes
      *
      * @remarks
-     * This configuration can be used by plugins during the `build` command. It will generally contain options specific to the selected {@link BuildVariant | build variant}.
+     * This configuration can be used by plugins during the `build` command. It will generally contain options specific to the selected {@link BuilderVariant | build variant}.
      */
     build: Omit<TUserConfig["build"], "override"> & Required<Pick<Required<TUserConfig["build"]>, "override">>;
     /**
@@ -288,9 +288,161 @@ type TsupResolvedConfig = ResolvedConfig<TsupUserConfig>;
 type TsdownResolvedConfig = ResolvedConfig<TsdownUserConfig>;
 type UnbuildResolvedConfig = ResolvedConfig<UnbuildUserConfig>;
 type FarmResolvedConfig = ResolvedConfig<FarmUserConfig>;
-type InferResolvedConfig<TBuildVariant extends BuildVariant | undefined> = TBuildVariant extends undefined ? ResolvedConfig : TBuildVariant extends "webpack" ? WebpackResolvedConfig : TBuildVariant extends "rspack" ? RspackResolvedConfig : TBuildVariant extends "vite" ? ViteResolvedConfig : TBuildVariant extends "esbuild" ? ESBuildResolvedConfig : TBuildVariant extends "unbuild" ? UnbuildResolvedConfig : TBuildVariant extends "tsup" ? TsupResolvedConfig : TBuildVariant extends "tsdown" ? TsdownResolvedConfig : TBuildVariant extends "rolldown" ? RolldownResolvedConfig : TBuildVariant extends "rollup" ? RollupResolvedConfig : TBuildVariant extends "farm" ? FarmResolvedConfig : ResolvedConfig;
+type InferResolvedConfig<TBuildVariant extends BuilderVariant | undefined> = TBuildVariant extends undefined ? ResolvedConfig : TBuildVariant extends "webpack" ? WebpackResolvedConfig : TBuildVariant extends "rspack" ? RspackResolvedConfig : TBuildVariant extends "vite" ? ViteResolvedConfig : TBuildVariant extends "esbuild" ? ESBuildResolvedConfig : TBuildVariant extends "unbuild" ? UnbuildResolvedConfig : TBuildVariant extends "tsup" ? TsupResolvedConfig : TBuildVariant extends "tsdown" ? TsdownResolvedConfig : TBuildVariant extends "rolldown" ? RolldownResolvedConfig : TBuildVariant extends "rollup" ? RollupResolvedConfig : TBuildVariant extends "farm" ? FarmResolvedConfig : ResolvedConfig;
+
+type CallHookOptions = SelectHooksOptions & (({
+    /**
+     * Whether to call the hooks sequentially or in parallel.
+     *
+     * @defaultValue true
+     */
+    sequential?: true;
+} & ({
+    /**
+     * How to handle multiple return values from hooks.
+     * - "merge": Merge all non-undefined return values (if they are objects).
+     * - "first": Return the first non-undefined value.
+     *
+     * @remarks
+     * Merging only works if the return values are objects.
+     *
+     * @defaultValue "merge"
+     */
+    result: "first";
+} | {
+    /**
+     * How to handle multiple return values from hooks.
+     * - "merge": Merge all non-undefined return values (if they are objects).
+     * - "first": Return the first non-undefined value.
+     *
+     * @remarks
+     * Merging only works if the return values are objects.
+     *
+     * @defaultValue "merge"
+     */
+    result?: "merge" | "last";
+    /**
+     * An indicator specifying if the results of the previous hook should be provided as the **first** parameter of the next hook function, or a function to process the result of the previous hook function and pass the returned value as the next hook's **first** parameter
+     */
+    asNextParam?: false | ((previousResult: any) => MaybePromise<any>);
+})) | {
+    /**
+     * Whether to call the hooks sequentially or in parallel.
+     */
+    sequential: false;
+});
 
-interface PluginHookObject<THookFunction extends FunctionLike, TFilter extends keyof HookFilter = never> {
+/**
+ * Powerlines API Interface
+ */
+interface API<TResolvedConfig extends ResolvedConfig = ResolvedConfig> {
+    /**
+     * The Powerlines shared API context
+     */
+    context: APIContext<TResolvedConfig>;
+    /**
+     * Prepare the Powerlines API
+     *
+     * @remarks
+     * This method will prepare the Powerlines API for use, initializing any necessary resources.
+     *
+     * @param inlineConfig - The inline configuration for the prepare command
+     */
+    prepare: (inlineConfig: PrepareInlineConfig | NewInlineConfig | CleanInlineConfig | BuildInlineConfig | LintInlineConfig | DocsInlineConfig | DeployInlineConfig) => Promise<void>;
+    /**
+     * Create a new Powerlines project
+     *
+     * @remarks
+     * This method will create a new Powerlines project in the current directory.
+     *
+     * @param inlineConfig - The inline configuration for the new command
+     * @returns A promise that resolves when the project has been created
+     */
+    new: (inlineConfig: NewInlineConfig) => Promise<void>;
+    /**
+     * Clean any previously prepared artifacts
+     *
+     * @remarks
+     * This method will remove the previous Powerlines artifacts from the project.
+     *
+     * @param inlineConfig - The inline configuration for the clean command
+     * @returns A promise that resolves when the clean command has completed
+     */
+    clean: (inlineConfig: CleanInlineConfig | PrepareInlineConfig) => Promise<void>;
+    /**
+     * Lint the project source code
+     *
+     * @param inlineConfig - The inline configuration for the lint command
+     * @returns A promise that resolves when the lint command has completed
+     */
+    lint: (inlineConfig: LintInlineConfig) => Promise<void>;
+    /**
+     * Build the project
+     *
+     * @remarks
+     * This method will build the Powerlines project, generating the necessary artifacts.
+     *
+     * @param inlineConfig - The inline configuration for the build command
+     * @returns A promise that resolves when the build command has completed
+     */
+    build: (inlineConfig: BuildInlineConfig) => Promise<void>;
+    /**
+     * Prepare the documentation for the project
+     *
+     * @param inlineConfig - The inline configuration for the docs command
+     * @returns A promise that resolves when the documentation generation has completed
+     */
+    docs: (inlineConfig: DocsInlineConfig) => Promise<void>;
+    /**
+     * Deploy the project source code
+     *
+     * @remarks
+     * This method will prepare and build the Powerlines project, generating the necessary artifacts for the deployment.
+     *
+     * @param inlineConfig - The inline configuration for the deploy command
+     */
+    deploy: (inlineConfig: DeployInlineConfig) => Promise<void>;
+    /**
+     * Finalization process
+     *
+     * @remarks
+     * This step includes any final processes or clean up required by Powerlines. It will be run after each Powerlines command.
+     *
+     * @returns A promise that resolves when the finalization process has completed
+     */
+    finalize: () => Promise<void>;
+    /**
+     * Invokes the configured plugin hooks
+     *
+     * @remarks
+     * By default, it will call the `"pre"`, `"normal"`, and `"post"` ordered hooks in sequence
+     *
+     * @param hook - The hook to call
+     * @param options - The options to provide to the hook
+     * @param args - The arguments to pass to the hook
+     * @returns The result of the hook call
+     */
+    callHook: <TKey extends string>(hook: TKey, options: CallHookOptions & {
+        environment?: string | EnvironmentContext<TResolvedConfig>;
+    }, ...args: InferHookParameters<PluginContext<TResolvedConfig>, TKey>) => Promise<InferHookReturnType<PluginContext<TResolvedConfig>, TKey> | undefined>;
+}
+
+interface UnpluginOptions<TUnpluginBuilderVariant extends UnpluginBuilderVariant = UnpluginBuilderVariant> extends UnpluginOptions$1 {
+    /**
+     * An API object that can be used for inter-plugin communication.
+     *
+     * @see https://rollupjs.org/plugin-development/#direct-plugin-communication
+     */
+    api: API<InferResolvedConfig<TUnpluginBuilderVariant>>;
+}
+type InferUnpluginOptions<TContext extends Context = Context, TBuilderVariant extends BuilderVariant = BuilderVariant, TUnpluginVariant extends InferUnpluginVariant<TBuilderVariant> = InferUnpluginVariant<TBuilderVariant>> = {
+    [TKey in keyof Required<UnpluginOptions<TUnpluginVariant>>[TUnpluginVariant]]?: Required<UnpluginOptions<TUnpluginVariant>>[TUnpluginVariant][TKey] extends infer THandler | {
+        handler: infer THandler;
+    } ? THandler extends (this: infer TOriginalContext, ...args: infer TArgs) => infer TReturn ? PluginHook<(this: TOriginalContext & TContext, ...args: TArgs) => MaybePromise<TReturn>, keyof HookFilter> : Required<UnpluginOptions<TUnpluginVariant>>[TUnpluginVariant][TKey] : Required<UnpluginOptions<TUnpluginVariant>>[TUnpluginVariant][TKey];
+};
+type UnpluginFactory<TUnpluginBuilderVariant extends UnpluginBuilderVariant> = (options: Partial<InferUserConfig<TUnpluginBuilderVariant>>, meta: UnpluginContextMeta) => UnpluginOptions;
+
+interface PluginHookObject<THookFunction extends AnyFunction, TFilter extends keyof HookFilter = never> {
     /**
      * The order in which the plugin should be applied.
      */
@@ -304,7 +456,7 @@ interface PluginHookObject<THookFunction extends FunctionLike, TFilter extends k
      */
     handler: THookFunction;
 }
-type PluginHook<THookFunction extends FunctionLike, TFilter extends keyof HookFilter = never> = THookFunction | PluginHookObject<THookFunction, TFilter>;
+type PluginHook<THookFunction extends AnyFunction, TFilter extends keyof HookFilter = never> = THookFunction | PluginHookObject<THookFunction, TFilter>;
 /**
  * A result returned by the plugin from the `types` hook that describes the declaration types output file.
  */
@@ -312,11 +464,9 @@ interface TypesResult {
     directives?: string[];
     code: string;
 }
-type DeepPartial<T> = {
-    [K in keyof T]?: DeepPartial<T[K]>;
-};
-type ConfigResult<TContext extends PluginContext = PluginContext> = DeepPartial<TContext["config"]> & Record<string, any>;
-interface BasePluginHookFunctions<TContext extends PluginContext = PluginContext> extends Record<CommandType, (this: TContext) => MaybePromise<void>> {
+type PluginHookFunctions<TContext extends PluginContext> = {
+    [TCommandType in CommandType]: (this: TContext) => MaybePromise<void>;
+} & {
     /**
      * A function that returns configuration options to be merged with the build context's options.
      *
@@ -331,7 +481,7 @@ interface BasePluginHookFunctions<TContext extends PluginContext = PluginContext
      * @param config - The partial configuration object to be modified.
      * @returns A promise that resolves to a partial configuration object.
      */
-    config: (this: UnresolvedContext<TContext["config"]>) => MaybePromise<ConfigResult<TContext>>;
+    config: (this: UnresolvedContext<TContext["config"]>) => MaybePromise<DeepPartial<TContext["config"]> & Record<string, any>>;
     /**
      * Modify environment configs before it's resolved. The hook can either mutate the passed-in environment config directly, or return a partial config object that will be deeply merged into existing config.
      *
@@ -393,7 +543,7 @@ interface BasePluginHookFunctions<TContext extends PluginContext = PluginContext
      * @param id - The identifier of the source code.
      * @returns A promise that resolves when the hook is complete.
      */
-    load: (this: BuildPluginContext<TContext["config"]> & TContext, id: string) => MaybePromise<TransformResult$1>;
+    load: (this: BuildPluginContext<TContext["config"]> & TContext, id: string) => MaybePromise<LoadResult>;
     /**
      * A hook that is called to resolve the identifier of the source code.
      *
@@ -413,67 +563,18 @@ interface BasePluginHookFunctions<TContext extends PluginContext = PluginContext
      * @returns A promise that resolves when the hook is complete.
      */
     writeBundle: (this: TContext) => MaybePromise<void>;
-}
-type BuildPlugin<TContext extends PluginContext = PluginContext, TBuildVariant extends UnpluginBuildVariant = UnpluginBuildVariant, TOptions extends Required<UnpluginOptions>[TBuildVariant] = Required<UnpluginOptions>[TBuildVariant]> = {
-    [TKey in keyof TOptions]: TOptions[TKey] extends FunctionLike ? (this: ThisParameterType<TOptions[TKey]> & TContext, ...args: Parameters<TOptions[TKey]>) => ReturnType<TOptions[TKey]> | MaybePromise<ReturnType<TOptions[TKey]>> : TOptions[TKey];
-};
-type ExternalPluginHookFunctionsVariant<TContext extends PluginContext = PluginContext, TBuildVariant extends UnpluginBuildVariant = UnpluginBuildVariant> = {
-    [TKey in keyof BuildPlugin<TContext, TBuildVariant> & string as `${TBuildVariant}:${TKey}`]: BuildPlugin<TContext, TBuildVariant>[TKey];
 };
-type ExternalPluginHookFunctions<TContext extends PluginContext> = ExternalPluginHookFunctionsVariant<TContext, "vite"> & ExternalPluginHookFunctionsVariant<TContext, "esbuild"> & ExternalPluginHookFunctionsVariant<TContext, "rolldown"> & ExternalPluginHookFunctionsVariant<TContext, "rollup"> & ExternalPluginHookFunctionsVariant<TContext, "webpack"> & ExternalPluginHookFunctionsVariant<TContext, "rspack"> & ExternalPluginHookFunctionsVariant<TContext, "farm">;
-type PluginHookFunctions<TContext extends PluginContext = PluginContext> = BasePluginHookFunctions<TContext> & ExternalPluginHookFunctions<TContext>;
-type PluginHooks<TContext extends PluginContext = PluginContext> = {
-    [TKey in keyof BasePluginHookFunctions<TContext>]: PluginHook<BasePluginHookFunctions<TContext>[TKey]>;
+type PluginHooks<TContext extends PluginContext> = {
+    [TPluginHook in keyof PluginHookFunctions<TContext>]?: PluginHook<PluginHookFunctions<TContext>[TPluginHook]>;
 } & {
-    /**
-     * A function that returns configuration options to be merged with the build context's options.
-     *
-     * @remarks
-     * Modify config before it's resolved. The hook can either mutate {@link Context.config} on the passed-in context directly, or return a partial config object that will be deeply merged into existing config.
-     *
-     * @warning User plugins are resolved before running this hook so injecting other plugins inside the config hook will have no effect. If you want to add plugins, consider doing so in the {@link Plugin.dependsOn} property instead.
-     *
-     * @see https://vitejs.dev/guide/api-plugin#config
-     *
-     * @param this - The build context.
-     * @param config - The partial configuration object to be modified.
-     * @returns A promise that resolves to a partial configuration object.
-     */
-    config: PluginHook<(this: UnresolvedContext<TContext["config"]>) => MaybePromise<ConfigResult<TContext>>> | ConfigResult<TContext>;
-    /**
-     * A hook that is called to transform the source code.
-     *
-     * @param this - The build context, unplugin build context, and unplugin context.
-     * @param code - The source code to transform.
-     * @param id - The identifier of the source code.
-     * @returns A promise that resolves when the hook is complete.
-     */
-    transform: PluginHook<(this: BuildPluginContext<TContext["config"]> & TContext, code: string, id: string) => MaybePromise<TransformResult$1>, "code" | "id">;
-    /**
-     * A hook that is called to load the source code.
-     *
-     * @param this - The build context, unplugin build context, and unplugin context.
-     * @param id - The identifier of the source code.
-     * @returns A promise that resolves when the hook is complete.
-     */
-    load: PluginHook<(this: BuildPluginContext<TContext["config"]> & TContext, id: string) => MaybePromise<TransformResult$1>, "id">;
-    /**
-     * A hook that is called to resolve the identifier of the source code.
-     *
-     * @param this - The build context, unplugin build context, and unplugin context.
-     * @param id - The identifier of the source code.
-     * @param importer - The importer of the source code.
-     * @param options - The options for resolving the identifier.
-     * @returns A promise that resolves when the hook is complete.
-     */
-    resolveId: PluginHook<(this: BuildPluginContext<TContext["config"]> & TContext, id: string, importer: string | undefined, options: {
-        isEntry: boolean;
-    }) => MaybePromise<string | ExternalIdResult | null | undefined>, "id">;
+    transform: PluginHook<PluginHookFunctions<TContext>["transform"], "code" | "id">;
+    load: PluginHook<PluginHookFunctions<TContext>["load"], "id">;
+    resolveId: PluginHook<PluginHookFunctions<TContext>["resolveId"], "id">;
 };
-type PluginBuildPlugins<TContext extends PluginContext = PluginContext> = {
-    [TBuildVariant in UnpluginBuildVariant]?: BuildPlugin<TContext, TBuildVariant>;
+type DeepPartial<T> = {
+    [K in keyof T]?: DeepPartial<T[K]>;
 };
-interface Plugin<TContext extends PluginContext<ResolvedConfig> = PluginContext<ResolvedConfig>> extends Partial<PluginHooks<TContext>>, PluginBuildPlugins<TContext> {
+type Plugin<TContext extends PluginContext<ResolvedConfig> = PluginContext<ResolvedConfig>> = Partial<PluginHooks<TContext>> & {
     /**
      * The name of the plugin, for use in deduplication, error messages and logs.
      */
@@ -521,36 +622,60 @@ interface Plugin<TContext extends PluginContext<ResolvedConfig> = PluginContext<
      * @returns `true` if the plugin should be active in the specified environment, `false` otherwise.
      */
     applyToEnvironment?: (environment: EnvironmentResolvedConfig) => boolean | PluginConfig<TContext>;
-}
+    /**
+     * A function that returns configuration options to be merged with the build context's options.
+     *
+     * @remarks
+     * Modify config before it's resolved. The hook can either mutate {@link Context.config} on the passed-in context directly, or return a partial config object that will be deeply merged into existing config.
+     *
+     * @warning User plugins are resolved before running this hook so injecting other plugins inside the config hook will have no effect. If you want to add plugins, consider doing so in the {@link Plugin.dependsOn} property instead.
+     *
+     * @see https://vitejs.dev/guide/api-plugin#config
+     *
+     * @param this - The build context.
+     * @param config - The partial configuration object to be modified.
+     * @returns A promise that resolves to a partial configuration object.
+     */
+    config?: PluginHook<(this: UnresolvedContext<TContext["config"]>) => MaybePromise<DeepPartial<TContext["config"]> & Record<string, any>>> | (DeepPartial<TContext["config"]> & Record<string, any>);
+} & {
+    [TBuilderVariant in BuilderVariant]?: InferUnpluginOptions<TContext, TBuilderVariant>;
+};
+type PluginHookFields<TContext extends PluginContext = PluginContext> = keyof PluginHookFunctions<TContext>;
 
-type BaseHooks<TContext extends PluginContext = PluginContext> = BasePluginHookFunctions<TContext>;
-type BaseHookKeys<TContext extends PluginContext = PluginContext> = keyof BaseHooks<TContext>;
-type ExternalHooks<TContext extends PluginContext = PluginContext> = ExternalPluginHookFunctions<TContext>;
-type ExternalHookKeys<TContext extends PluginContext = PluginContext> = keyof ExternalHooks<TContext>;
-type Hooks<TContext extends PluginContext = PluginContext> = PluginHookFunctions<TContext>;
-type HookKeys<TContext extends PluginContext = PluginContext> = keyof Hooks<TContext>;
-interface BaseHooksListItem<TContext extends PluginContext = PluginContext, TKey extends BaseHookKeys<TContext> = BaseHookKeys<TContext>> extends PluginHookObject<BaseHooks<TContext>[TKey]> {
+type HookListOrders = "preOrdered" | "preEnforced" | "normal" | "postEnforced" | "postOrdered";
+type UnpluginHookFunctions<TContext extends PluginContext = PluginContext, TUnpluginBuilderVariant extends UnpluginBuilderVariant = UnpluginBuilderVariant, TField extends keyof Required<UnpluginOptions$1>[TUnpluginBuilderVariant] = keyof Required<UnpluginOptions$1>[TUnpluginBuilderVariant]> = Required<UnpluginOptions$1>[TUnpluginBuilderVariant][TField] extends infer THandler | {
+    handler: infer THandler;
+} ? THandler extends (this: infer THandlerOriginalContext, ...args: infer THandlerArgs) => infer THandlerReturn ? (this: THandlerOriginalContext & WithUnpluginBuildContext<TContext>, ...args: THandlerArgs) => THandlerReturn : THandler extends {
+    handler: infer THandlerFunction;
+} ? THandlerFunction extends (this: infer THandlerFunctionOriginalContext, ...args: infer THandlerFunctionArgs) => infer THandlerFunctionReturn ? (this: THandlerFunctionOriginalContext & WithUnpluginBuildContext<TContext>, ...args: THandlerFunctionArgs) => THandlerFunctionReturn : never : never : never;
+interface PluginHooksListItem<TContext extends PluginContext = PluginContext, TFields extends PluginHookFields<TContext> = PluginHookFields<TContext>> {
     plugin: Plugin<TContext>;
+    handler: PluginHookFunctions<TContext>[TFields];
 }
-interface BaseHooksList<TContext extends PluginContext = PluginContext, TKey extends BaseHookKeys<TContext> = BaseHookKeys<TContext>> {
-    preOrdered?: BaseHooksListItem<TContext, TKey>[];
-    preEnforced?: BaseHooksListItem<TContext, TKey>[];
-    normal?: BaseHooksListItem<TContext, TKey>[];
-    postEnforced?: BaseHooksListItem<TContext, TKey>[];
-    postOrdered?: BaseHooksListItem<TContext, TKey>[];
-}
-interface ExternalHooksListItem<TContext extends PluginContext = PluginContext, TKey extends ExternalHookKeys<TContext> = ExternalHookKeys<TContext>> {
+type PluginHooksList<TContext extends PluginContext = PluginContext, TFields extends PluginHookFields<TContext> = PluginHookFields<TContext>> = {
+    [TKey in HookListOrders]?: PluginHooksListItem<TContext, TFields>[] | undefined;
+};
+interface UnpluginHooksListItem<TContext extends PluginContext = PluginContext, TUnpluginBuilderVariant extends UnpluginBuilderVariant = UnpluginBuilderVariant, TField extends keyof Required<UnpluginOptions$1>[TUnpluginBuilderVariant] = keyof Required<UnpluginOptions$1>[TUnpluginBuilderVariant]> {
     plugin: Plugin<TContext>;
-    handler: ExternalHooks<TContext>[TKey];
+    handler: UnpluginHookFunctions<TContext, TUnpluginBuilderVariant, TField>;
 }
+type UnpluginHookList<TContext extends PluginContext = PluginContext, TUnpluginBuilderVariant extends UnpluginBuilderVariant = UnpluginBuilderVariant, TField extends keyof UnpluginOptions$1[TUnpluginBuilderVariant] = keyof UnpluginOptions$1[TUnpluginBuilderVariant]> = {
+    [TKey in HookListOrders]?: UnpluginHooksListItem<TContext, TUnpluginBuilderVariant, TField>[] | undefined;
+};
+type UnpluginHookVariantField<TContext extends PluginContext = PluginContext, TUnpluginBuilderVariant extends UnpluginBuilderVariant = UnpluginBuilderVariant> = {
+    [TKey in keyof UnpluginOptions$1[TUnpluginBuilderVariant]]?: UnpluginHookList<TContext, TUnpluginBuilderVariant, TKey>;
+};
+type UnpluginHookVariant<TContext extends PluginContext = PluginContext> = {
+    [TKey in UnpluginBuilderVariant]?: UnpluginHookVariantField<TContext, TKey>;
+};
+type HookFields<TContext extends PluginContext = PluginContext> = PluginHookFields<TContext> | UnpluginBuilderVariant;
 type HooksList<TContext extends PluginContext = PluginContext> = {
-    [TKey in BaseHookKeys<TContext>]?: BaseHooksList<TContext, TKey>;
-} & {
-    [TKey in ExternalHookKeys<TContext>]?: ExternalHooksListItem<TContext, TKey>[];
+    [TField in HookFields<TContext>]?: TField extends PluginHookFields<TContext> ? PluginHooksList<TContext, TField> : TField extends UnpluginBuilderVariant ? UnpluginHookVariant<TContext>[TField] : never;
 };
-type InferHookHandler<TContext extends PluginContext, TKey extends HookKeys<TContext>> = Hooks<TContext>[TKey];
-type InferHookReturnType<TContext extends PluginContext, TKey extends HookKeys<TContext>> = ReturnType<InferHookHandler<TContext, TKey>> extends Promise<infer U> ? U extends Promise<infer V> ? V : U : ReturnType<InferHookHandler<TContext, TKey>>;
-type InferHookParameters<TContext extends PluginContext, TKey extends HookKeys<TContext>> = Parameters<InferHookHandler<TContext, TKey>>;
+type InferHooksListItem<TContext extends PluginContext, TKey extends string> = TKey extends `${infer TUnpluginBuilderVariant}:${infer TUnpluginField}` ? TUnpluginBuilderVariant extends UnpluginBuilderVariant ? TUnpluginField extends keyof Required<UnpluginOptions$1>[TUnpluginBuilderVariant] ? UnpluginHooksListItem<TContext, TUnpluginBuilderVariant, TUnpluginField> : never : never : TKey extends keyof PluginHookFunctions<TContext> ? PluginHooksListItem<TContext, TKey> : never;
+type InferHookFunction<TContext extends PluginContext, TKey extends string> = TKey extends `${infer TUnpluginBuilderVariant}:${infer TUnpluginField}` ? TUnpluginBuilderVariant extends UnpluginBuilderVariant ? TUnpluginField extends keyof Required<UnpluginOptions$1>[TUnpluginBuilderVariant] ? UnpluginHookFunctions<TContext, TUnpluginBuilderVariant, TUnpluginField> : never : never : TKey extends keyof PluginHookFunctions<TContext> ? PluginHookFunctions<TContext>[TKey] : never;
+type InferHookReturnType<TContext extends PluginContext, TKey extends string> = ReturnType<InferHookFunction<TContext, TKey>>;
+type InferHookParameters<TContext extends PluginContext, TKey extends string> = Parameters<InferHookFunction<TContext, TKey>>;
 
 type WorkerProcess<TExposedMethods extends ReadonlyArray<string>> = {
     [K in TExposedMethods[number]]: (data: any) => Promise<any>;
@@ -1028,10 +1153,10 @@ interface EnvironmentContextPlugin<TResolvedConfig extends ResolvedConfig = Reso
     plugin: Plugin<PluginContext<TResolvedConfig>>;
     context: PluginContext<TResolvedConfig>;
 }
-interface SelectHooksResult<TResolvedConfig extends ResolvedConfig, TKey extends HookKeys<PluginContext<TResolvedConfig>>> {
-    handle: Hooks[TKey];
-    context: PluginContext<TResolvedConfig>;
-}
+type SelectHookResultItem<TContext extends PluginContext, TKey extends string> = InferHooksListItem<TContext, TKey> & {
+    context: TContext;
+};
+type SelectHookResult<TContext extends PluginContext, TKey extends string> = SelectHookResultItem<TContext, TKey>[];
 interface EnvironmentContext<TResolvedConfig extends ResolvedConfig = ResolvedConfig> extends Context<TResolvedConfig> {
     /**
      * The expected plugins options for the Powerlines project.
@@ -1055,7 +1180,7 @@ interface EnvironmentContext<TResolvedConfig extends ResolvedConfig = ResolvedCo
     /**
      * Retrieves the hook handlers for a specific hook name
      */
-    selectHooks: <TKey extends HookKeys<PluginContext<TResolvedConfig>>>(hook: TKey, options?: SelectHooksOptions) => SelectHooksResult<TResolvedConfig, TKey>[];
+    selectHooks: <TKey extends string>(key: TKey, options?: SelectHooksOptions) => SelectHookResult<PluginContext<TResolvedConfig>, TKey>;
 }
 interface PluginContext<out TResolvedConfig extends ResolvedConfig = ResolvedConfig> extends Context<TResolvedConfig>, UnpluginContext {
     /**
@@ -1071,6 +1196,7 @@ interface PluginContext<out TResolvedConfig extends ResolvedConfig = ResolvedCon
     logger: LogFn;
 }
 type BuildPluginContext<TResolvedConfig extends ResolvedConfig = ResolvedConfig> = UnpluginBuildContext & PluginContext<TResolvedConfig>;
+type WithUnpluginBuildContext<TContext extends PluginContext> = UnpluginBuildContext & TContext;
 
 type LogFn = (type: LogLevelLabel, ...args: string[]) => void;
 /**
@@ -1430,7 +1556,7 @@ type UnbuildUserConfig = UserConfig<UnbuildBuildConfig, UnbuildResolvedBuildConf
 type TsupUserConfig = UserConfig<TsupBuildConfig, TsupResolvedBuildConfig, "tsup">;
 type TsdownUserConfig = UserConfig<TsdownBuildConfig, TsdownResolvedBuildConfig, "tsdown">;
 type FarmUserConfig = UserConfig<FarmBuildConfig, FarmResolvedBuildConfig, "farm">;
-type InferUserConfig<TBuildVariant extends BuildVariant | undefined> = TBuildVariant extends "webpack" ? WebpackUserConfig : TBuildVariant extends "rspack" ? RspackUserConfig : TBuildVariant extends "vite" ? ViteUserConfig : TBuildVariant extends "esbuild" ? ESBuildUserConfig : TBuildVariant extends "unbuild" ? UnbuildUserConfig : TBuildVariant extends "tsup" ? TsupUserConfig : TBuildVariant extends "tsdown" ? TsdownUserConfig : TBuildVariant extends "rolldown" ? RolldownUserConfig : TBuildVariant extends "rollup" ? RollupUserConfig : TBuildVariant extends "farm" ? FarmUserConfig : UserConfig;
+type InferUserConfig<TBuilderVariant extends BuilderVariant | undefined> = TBuilderVariant extends "webpack" ? WebpackUserConfig : TBuilderVariant extends "rspack" ? RspackUserConfig : TBuilderVariant extends "vite" ? ViteUserConfig : TBuilderVariant extends "esbuild" ? ESBuildUserConfig : TBuilderVariant extends "unbuild" ? UnbuildUserConfig : TBuilderVariant extends "tsup" ? TsupUserConfig : TBuilderVariant extends "tsdown" ? TsdownUserConfig : TBuilderVariant extends "rolldown" ? RolldownUserConfig : TBuilderVariant extends "rollup" ? RollupUserConfig : TBuilderVariant extends "farm" ? FarmUserConfig : UserConfig;
 type InitialUserConfig<TUserConfig extends UserConfig = UserConfig> = Partial<TUserConfig> & {
     root: string;
 };
@@ -1500,4 +1626,4 @@ type DeployInlineConfig<TUserConfig extends UserConfig = UserConfig> = InlineCon
     command: "deploy";
 };
 
-export type { APIContext as A, BuildPlugin as B, Context as C, InferUserConfig as D, ESBuildResolvedBuildConfig as E, FetchOptions as F, SourceFile as G, HooksList as H, InitialUserConfig as I, WorkerProcess as J, PrepareInlineConfig as K, LogFn as L, MetaInfo as M, NewInlineConfig as N, CleanInlineConfig as O, PowerlinesCommand as P, BuildInlineConfig as Q, ResolvedEntryTypeDefinition as R, SelectHooksOptions as S, TsdownResolvedBuildConfig as T, UnbuildBuildConfig as U, ViteResolvedBuildConfig as V, WorkspaceConfig as W, LintInlineConfig as X, DocsInlineConfig as Y, DeployInlineConfig as Z, ParsedUserConfig as a, RolldownResolvedBuildConfig as b, RollupResolvedBuildConfig as c, TsupBuildConfig as d, TsupResolvedBuildConfig as e, UnbuildResolvedBuildConfig as f, ResolvedConfig as g, Plugin as h, PluginContext as i, EnvironmentResolvedConfig as j, InitContextOptions as k, EnvironmentContext as l, EnvironmentContextPlugin as m, HookKeys as n, SelectHooksResult as o, Resolver as p, ParseOptions as q, TransformResult as r, EmitOptions as s, EmitEntryOptions as t, PluginConfig as u, InferHookParameters as v, InferHookReturnType as w, UnpluginBuildVariant as x, InferResolvedConfig as y, InferUnpluginVariant as z };
+export type { APIContext as A, UnpluginFactory as B, Context as C, SourceFile as D, ESBuildResolvedBuildConfig as E, FetchOptions as F, WorkerProcess as G, HooksList as H, InitialUserConfig as I, LogFn as L, MetaInfo as M, PowerlinesCommand as P, ResolvedEntryTypeDefinition as R, SelectHooksOptions as S, TsdownResolvedBuildConfig as T, UnbuildBuildConfig as U, ViteResolvedBuildConfig as V, WorkspaceConfig as W, ParsedUserConfig as a, RolldownResolvedBuildConfig as b, RollupResolvedBuildConfig as c, TsupBuildConfig as d, TsupResolvedBuildConfig as e, UnbuildResolvedBuildConfig as f, ResolvedConfig as g, Plugin as h, PluginContext as i, EnvironmentResolvedConfig as j, InitContextOptions as k, EnvironmentContext as l, EnvironmentContextPlugin as m, SelectHookResult as n, Resolver as o, ParseOptions as p, TransformResult as q, EmitOptions as r, EmitEntryOptions as s, API as t, PluginConfig as u, CallHookOptions as v, InferHookParameters as w, InferHookReturnType as x, UnpluginBuilderVariant as y, UnpluginOptions as z };