@powerlines/plugin-alloy 0.18.7 → 0.18.9

package/dist/powerlines/src/types/plugin.d.cts

@@ -1,14 +1,16 @@
-import { UnpluginBuildVariant } from "./build.cjs";
+import { BuilderVariant } from "./build.cjs";
 import { CommandType } from "./commands.cjs";
 import { EnvironmentResolvedConfig, ResolvedConfig } from "./resolved.cjs";
+import { InferUnpluginOptions } from "./unplugin.cjs";
 import { EnvironmentConfig, PluginConfig } from "./config.cjs";
 import { BuildPluginContext, PluginContext, UnresolvedContext } from "./context.cjs";
-import { FunctionLike, MaybePromise } from "@stryke/types/base";
-import { ExternalIdResult, HookFilter, TransformResult, UnpluginOptions } from "unplugin";
+import { AnyFunction, MaybePromise } from "@stryke/types/base";
+import { ExternalIdResult, HookFilter, TransformResult } from "unplugin";
+import { LoadResult } from "rollup";
 import { ArrayValues } from "@stryke/types/array";
 
 //#region ../powerlines/src/types/plugin.d.ts
-interface PluginHookObject<THookFunction extends FunctionLike, TFilter extends keyof HookFilter = never> {
+interface PluginHookObject<THookFunction extends AnyFunction, TFilter extends keyof HookFilter = never> {
   /**
    * The order in which the plugin should be applied.
    */
@@ -22,7 +24,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.
  */
@@ -30,9 +32,7 @@ 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.
    *
@@ -47,7 +47,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.
    *
@@ -109,7 +109,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>;
+  load: (this: BuildPluginContext<TContext["config"]> & TContext, id: string) => MaybePromise<LoadResult>;
   /**
    * A hook that is called to resolve the identifier of the source code.
    *
@@ -129,56 +129,14 @@ 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$1 extends UnpluginBuildVariant = UnpluginBuildVariant, TOptions extends Required<UnpluginOptions>[TBuildVariant$1] = Required<UnpluginOptions>[TBuildVariant$1]> = { [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 PluginHooks<TContext extends PluginContext = PluginContext> = { [TKey in keyof BasePluginHookFunctions<TContext>]: PluginHook<BasePluginHookFunctions<TContext>[TKey]> } & {
-  /**
-   * 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>, "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>, "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">;
 };
-type PluginBuildPlugins<TContext extends PluginContext = PluginContext> = { [TBuildVariant in UnpluginBuildVariant]?: BuildPlugin<TContext, TBuildVariant> };
-interface Plugin<TContext extends PluginContext<ResolvedConfig> = PluginContext<ResolvedConfig>> extends Partial<PluginHooks<TContext>>, PluginBuildPlugins<TContext> {
+type PluginHooks<TContext extends PluginContext> = { [TPluginHook in keyof PluginHookFunctions<TContext>]?: PluginHook<PluginHookFunctions<TContext>[TPluginHook]> } & {
+  transform: PluginHook<PluginHookFunctions<TContext>["transform"], "code" | "id">;
+  load: PluginHook<PluginHookFunctions<TContext>["load"], "id">;
+  resolveId: PluginHook<PluginHookFunctions<TContext>["resolveId"], "id">;
+};
+type DeepPartial<T> = { [K in keyof T]?: DeepPartial<T[K]> };
+type Plugin<TContext extends PluginContext<ResolvedConfig> = PluginContext<ResolvedConfig>> = Partial<PluginHooks<TContext>> & {
   /**
    * The name of the plugin, for use in deduplication, error messages and logs.
    */
@@ -226,6 +184,22 @@ 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>;
 //#endregion
-export { Plugin };
+export { Plugin, PluginHook, PluginHookFields, PluginHookFunctions };

package/dist/powerlines/src/types/plugin.d.mts

@@ -1,14 +1,16 @@
-import { UnpluginBuildVariant } from "./build.mjs";
+import { BuilderVariant } from "./build.mjs";
 import { CommandType } from "./commands.mjs";
 import { EnvironmentResolvedConfig, ResolvedConfig } from "./resolved.mjs";
+import { InferUnpluginOptions } from "./unplugin.mjs";
 import { EnvironmentConfig, PluginConfig } from "./config.mjs";
 import { BuildPluginContext, PluginContext, UnresolvedContext } from "./context.mjs";
-import { FunctionLike, MaybePromise } from "@stryke/types/base";
-import { ExternalIdResult, HookFilter, TransformResult, UnpluginOptions } from "unplugin";
+import { AnyFunction, MaybePromise } from "@stryke/types/base";
+import { ExternalIdResult, HookFilter, TransformResult } from "unplugin";
+import { LoadResult } from "rollup";
 import { ArrayValues } from "@stryke/types/array";
 
 //#region ../powerlines/src/types/plugin.d.ts
-interface PluginHookObject<THookFunction extends FunctionLike, TFilter extends keyof HookFilter = never> {
+interface PluginHookObject<THookFunction extends AnyFunction, TFilter extends keyof HookFilter = never> {
   /**
    * The order in which the plugin should be applied.
    */
@@ -22,7 +24,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.
  */
@@ -30,9 +32,7 @@ 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.
    *
@@ -47,7 +47,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.
    *
@@ -109,7 +109,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>;
+  load: (this: BuildPluginContext<TContext["config"]> & TContext, id: string) => MaybePromise<LoadResult>;
   /**
    * A hook that is called to resolve the identifier of the source code.
    *
@@ -129,56 +129,14 @@ 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$1 extends UnpluginBuildVariant = UnpluginBuildVariant, TOptions extends Required<UnpluginOptions>[TBuildVariant$1] = Required<UnpluginOptions>[TBuildVariant$1]> = { [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 PluginHooks<TContext extends PluginContext = PluginContext> = { [TKey in keyof BasePluginHookFunctions<TContext>]: PluginHook<BasePluginHookFunctions<TContext>[TKey]> } & {
-  /**
-   * 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>, "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>, "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">;
 };
-type PluginBuildPlugins<TContext extends PluginContext = PluginContext> = { [TBuildVariant in UnpluginBuildVariant]?: BuildPlugin<TContext, TBuildVariant> };
-interface Plugin<TContext extends PluginContext<ResolvedConfig> = PluginContext<ResolvedConfig>> extends Partial<PluginHooks<TContext>>, PluginBuildPlugins<TContext> {
+type PluginHooks<TContext extends PluginContext> = { [TPluginHook in keyof PluginHookFunctions<TContext>]?: PluginHook<PluginHookFunctions<TContext>[TPluginHook]> } & {
+  transform: PluginHook<PluginHookFunctions<TContext>["transform"], "code" | "id">;
+  load: PluginHook<PluginHookFunctions<TContext>["load"], "id">;
+  resolveId: PluginHook<PluginHookFunctions<TContext>["resolveId"], "id">;
+};
+type DeepPartial<T> = { [K in keyof T]?: DeepPartial<T[K]> };
+type Plugin<TContext extends PluginContext<ResolvedConfig> = PluginContext<ResolvedConfig>> = Partial<PluginHooks<TContext>> & {
   /**
    * The name of the plugin, for use in deduplication, error messages and logs.
    */
@@ -226,6 +184,22 @@ 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>;
 //#endregion
-export { Plugin };
+export { Plugin, PluginHook, PluginHookFields, PluginHookFunctions };

package/dist/powerlines/src/types/resolved.d.cts

@@ -1,4 +1,5 @@
-import { EnvironmentConfig, InlineConfig, OutputConfig, UserConfig } from "./config.cjs";
+import { BuilderVariant } from "./build.cjs";
+import { ESBuildUserConfig, EnvironmentConfig, FarmUserConfig, InlineConfig, OutputConfig, RolldownUserConfig, RollupUserConfig, RspackUserConfig, TsdownUserConfig, TsupUserConfig, UnbuildUserConfig, UserConfig as UserConfig$1, ViteUserConfig, WebpackUserConfig } from "./config.cjs";
 import { NonUndefined } from "@stryke/types/base";
 import { TypeDefinition } from "@stryke/types/configuration";
 import { AssetGlob } from "@stryke/types/file";
@@ -32,7 +33,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" | "organization" | "compatibilityDate" | "plugins" | "mode" | "environments" | "platform" | "tsconfig" | "lint" | "test" | "build" | "transform" | "deploy" | "variant" | "type" | "output" | "logLevel" | "framework" | "sourceRoot"> & Required<Pick<TUserConfig, "name" | "title" | "organization" | "compatibilityDate" | "plugins" | "mode" | "environments" | "tsconfig" | "lint" | "test" | "build" | "transform" | "deploy" | "framework" | "sourceRoot">> & {
+type ResolvedConfig<TUserConfig extends UserConfig$1 = UserConfig$1> = Omit<TUserConfig, "name" | "title" | "organization" | "compatibilityDate" | "plugins" | "mode" | "environments" | "platform" | "tsconfig" | "lint" | "test" | "build" | "transform" | "deploy" | "variant" | "type" | "output" | "logLevel" | "framework" | "sourceRoot"> & Required<Pick<TUserConfig, "name" | "title" | "organization" | "compatibilityDate" | "plugins" | "mode" | "environments" | "tsconfig" | "lint" | "test" | "build" | "transform" | "deploy" | "framework" | "sourceRoot">> & {
   /**
    * The configuration options that were provided inline to the Powerlines CLI.
    */
@@ -67,7 +68,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">>;
   /**
@@ -77,5 +78,16 @@ type ResolvedConfig<TUserConfig extends UserConfig = UserConfig> = Omit<TUserCon
    */
   logLevel: "error" | "warn" | "info" | "debug" | "trace" | null;
 };
+type ViteResolvedConfig = ResolvedConfig<ViteUserConfig>;
+type WebpackResolvedConfig = ResolvedConfig<WebpackUserConfig>;
+type RspackResolvedConfig = ResolvedConfig<RspackUserConfig>;
+type ESBuildResolvedConfig = ResolvedConfig<ESBuildUserConfig>;
+type RollupResolvedConfig = ResolvedConfig<RollupUserConfig>;
+type RolldownResolvedConfig = ResolvedConfig<RolldownUserConfig>;
+type TsupResolvedConfig = ResolvedConfig<TsupUserConfig>;
+type TsdownResolvedConfig = ResolvedConfig<TsdownUserConfig>;
+type UnbuildResolvedConfig = ResolvedConfig<UnbuildUserConfig>;
+type FarmResolvedConfig = ResolvedConfig<FarmUserConfig>;
+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;
 //#endregion
-export { EnvironmentResolvedConfig, ResolvedConfig, ResolvedEntryTypeDefinition };
+export { EnvironmentResolvedConfig, InferResolvedConfig, ResolvedConfig, ResolvedEntryTypeDefinition };

package/dist/powerlines/src/types/resolved.d.mts

@@ -1,4 +1,5 @@
-import { EnvironmentConfig, InlineConfig, OutputConfig, UserConfig } from "./config.mjs";
+import { BuilderVariant } from "./build.mjs";
+import { ESBuildUserConfig, EnvironmentConfig, FarmUserConfig, InlineConfig, OutputConfig, RolldownUserConfig, RollupUserConfig, RspackUserConfig, TsdownUserConfig, TsupUserConfig, UnbuildUserConfig, UserConfig as UserConfig$1, ViteUserConfig, WebpackUserConfig } from "./config.mjs";
 import { NonUndefined } from "@stryke/types/base";
 import { TypeDefinition } from "@stryke/types/configuration";
 import { AssetGlob } from "@stryke/types/file";
@@ -32,7 +33,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" | "organization" | "compatibilityDate" | "plugins" | "mode" | "environments" | "platform" | "tsconfig" | "lint" | "test" | "build" | "transform" | "deploy" | "variant" | "type" | "output" | "logLevel" | "framework" | "sourceRoot"> & Required<Pick<TUserConfig, "name" | "title" | "organization" | "compatibilityDate" | "plugins" | "mode" | "environments" | "tsconfig" | "lint" | "test" | "build" | "transform" | "deploy" | "framework" | "sourceRoot">> & {
+type ResolvedConfig<TUserConfig extends UserConfig$1 = UserConfig$1> = Omit<TUserConfig, "name" | "title" | "organization" | "compatibilityDate" | "plugins" | "mode" | "environments" | "platform" | "tsconfig" | "lint" | "test" | "build" | "transform" | "deploy" | "variant" | "type" | "output" | "logLevel" | "framework" | "sourceRoot"> & Required<Pick<TUserConfig, "name" | "title" | "organization" | "compatibilityDate" | "plugins" | "mode" | "environments" | "tsconfig" | "lint" | "test" | "build" | "transform" | "deploy" | "framework" | "sourceRoot">> & {
   /**
    * The configuration options that were provided inline to the Powerlines CLI.
    */
@@ -67,7 +68,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">>;
   /**
@@ -77,5 +78,16 @@ type ResolvedConfig<TUserConfig extends UserConfig = UserConfig> = Omit<TUserCon
    */
   logLevel: "error" | "warn" | "info" | "debug" | "trace" | null;
 };
+type ViteResolvedConfig = ResolvedConfig<ViteUserConfig>;
+type WebpackResolvedConfig = ResolvedConfig<WebpackUserConfig>;
+type RspackResolvedConfig = ResolvedConfig<RspackUserConfig>;
+type ESBuildResolvedConfig = ResolvedConfig<ESBuildUserConfig>;
+type RollupResolvedConfig = ResolvedConfig<RollupUserConfig>;
+type RolldownResolvedConfig = ResolvedConfig<RolldownUserConfig>;
+type TsupResolvedConfig = ResolvedConfig<TsupUserConfig>;
+type TsdownResolvedConfig = ResolvedConfig<TsdownUserConfig>;
+type UnbuildResolvedConfig = ResolvedConfig<UnbuildUserConfig>;
+type FarmResolvedConfig = ResolvedConfig<FarmUserConfig>;
+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;
 //#endregion
-export { EnvironmentResolvedConfig, ResolvedConfig, ResolvedEntryTypeDefinition };
+export { EnvironmentResolvedConfig, InferResolvedConfig, ResolvedConfig, ResolvedEntryTypeDefinition };

package/dist/powerlines/src/types/unplugin.d.cts

@@ -0,0 +1,22 @@
+import { BuilderVariant, InferUnpluginVariant, UnpluginBuilderVariant } from "./build.cjs";
+import { InferResolvedConfig } from "./resolved.cjs";
+import { API } from "./api.cjs";
+import { PluginHook } from "./plugin.cjs";
+import { Context } from "./context.cjs";
+import { MaybePromise } from "@stryke/types/base";
+import { HookFilter, UnpluginOptions } from "unplugin";
+
+//#region ../powerlines/src/types/unplugin.d.ts
+interface UnpluginOptions$1<TUnpluginBuilderVariant extends UnpluginBuilderVariant = UnpluginBuilderVariant> extends UnpluginOptions {
+  /**
+   * 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$1<TUnpluginVariant>>[TUnpluginVariant]]?: Required<UnpluginOptions$1<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$1<TUnpluginVariant>>[TUnpluginVariant][TKey] : Required<UnpluginOptions$1<TUnpluginVariant>>[TUnpluginVariant][TKey] };
+//#endregion
+export { InferUnpluginOptions };

package/dist/powerlines/src/types/unplugin.d.mts

@@ -0,0 +1,22 @@
+import { BuilderVariant, InferUnpluginVariant, UnpluginBuilderVariant } from "./build.mjs";
+import { InferResolvedConfig } from "./resolved.mjs";
+import { API } from "./api.mjs";
+import { PluginHook } from "./plugin.mjs";
+import { Context } from "./context.mjs";
+import { MaybePromise } from "@stryke/types/base";
+import { HookFilter, UnpluginOptions } from "unplugin";
+
+//#region ../powerlines/src/types/unplugin.d.ts
+interface UnpluginOptions$1<TUnpluginBuilderVariant extends UnpluginBuilderVariant = UnpluginBuilderVariant> extends UnpluginOptions {
+  /**
+   * 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$1<TUnpluginVariant>>[TUnpluginVariant]]?: Required<UnpluginOptions$1<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$1<TUnpluginVariant>>[TUnpluginVariant][TKey] : Required<UnpluginOptions$1<TUnpluginVariant>>[TUnpluginVariant][TKey] };
+//#endregion
+export { InferUnpluginOptions };

package/dist/types/components.d.cts

@@ -101,9 +101,7 @@ interface TypescriptFileImportItem {
   alias?: string;
   type?: boolean;
 }
-type TypescriptFileImports = Record<string, null | Array<TypescriptFileImportItem | string>> & {
-  $builtins?: Record<string, null | Array<TypescriptFileImportItem | string>>;
-};
+type TypescriptFileImports = Record<string, null | Array<TypescriptFileImportItem | string>>;
 interface SourceFileHeaderProps extends ComponentProps {
   /**
    * If true, disables the ESLint directive at the top of the file.

package/dist/types/components.d.mts

@@ -101,9 +101,7 @@ interface TypescriptFileImportItem {
   alias?: string;
   type?: boolean;
 }
-type TypescriptFileImports = Record<string, null | Array<TypescriptFileImportItem | string>> & {
-  $builtins?: Record<string, null | Array<TypescriptFileImportItem | string>>;
-};
+type TypescriptFileImports = Record<string, null | Array<TypescriptFileImportItem | string>>;
 interface SourceFileHeaderProps extends ComponentProps {
   /**
    * If true, disables the ESLint directive at the top of the file.

package/dist/typescript/components/builtin-file.d.cts

@@ -1,6 +1,6 @@
 import { TSDocModuleProps } from "./tsdoc.cjs";
 import { TypescriptFileProps } from "./typescript-file.cjs";
-import * as _alloy_js_core7 from "@alloy-js/core";
+import * as _alloy_js_core12 from "@alloy-js/core";
 
 //#region src/typescript/components/builtin-file.d.ts
 type BuiltinFileProps = Omit<TypescriptFileProps, "path"> & Omit<TSDocModuleProps, "name"> & {
@@ -28,7 +28,7 @@ type BuiltinFileProps = Omit<TypescriptFileProps, "path"> & Omit<TSDocModuleProp
  * @param props - The properties for the source file.
  * @returns The rendered source file component.
  */
-declare function BuiltinFile(props: BuiltinFileProps): _alloy_js_core7.Children;
+declare function BuiltinFile(props: BuiltinFileProps): _alloy_js_core12.Children;
 declare type __ΩBuiltinFileProps = any[];
 //#endregion
 export { BuiltinFile, BuiltinFileProps, __ΩBuiltinFileProps };

package/dist/typescript/components/builtin-file.d.mts

@@ -1,6 +1,6 @@
 import { TSDocModuleProps } from "./tsdoc.mjs";
 import { TypescriptFileProps } from "./typescript-file.mjs";
-import * as _alloy_js_core16 from "@alloy-js/core";
+import * as _alloy_js_core15 from "@alloy-js/core";
 
 //#region src/typescript/components/builtin-file.d.ts
 type BuiltinFileProps = Omit<TypescriptFileProps, "path"> & Omit<TSDocModuleProps, "name"> & {
@@ -28,7 +28,7 @@ type BuiltinFileProps = Omit<TypescriptFileProps, "path"> & Omit<TSDocModuleProp
  * @param props - The properties for the source file.
  * @returns The rendered source file component.
  */
-declare function BuiltinFile(props: BuiltinFileProps): _alloy_js_core16.Children;
+declare function BuiltinFile(props: BuiltinFileProps): _alloy_js_core15.Children;
 declare type __ΩBuiltinFileProps = any[];
 //#endregion
 export { BuiltinFile, BuiltinFileProps, __ΩBuiltinFileProps };

package/dist/typescript/components/dynamic-import-statement.d.cts

@@ -1,4 +1,4 @@
-import * as _alloy_js_core13 from "@alloy-js/core";
+import * as _alloy_js_core7 from "@alloy-js/core";
 import { VarDeclarationProps } from "@alloy-js/typescript";
 
 //#region src/typescript/components/dynamic-import-statement.d.ts
@@ -26,7 +26,7 @@ interface DynamicImportStatementProps extends Omit<VarDeclarationProps, "initial
  * @param props - The properties for the dynamic import statement.
  * @returns A `VarDeclaration` component representing the dynamic import statement.
  */
-declare function DynamicImportStatement(props: DynamicImportStatementProps): _alloy_js_core13.Children;
+declare function DynamicImportStatement(props: DynamicImportStatementProps): _alloy_js_core7.Children;
 declare type __ΩDynamicImportStatementProps = any[];
 //#endregion
 export { DynamicImportStatement, DynamicImportStatementProps, __ΩDynamicImportStatementProps };

package/dist/typescript/components/dynamic-import-statement.d.mts

@@ -1,4 +1,4 @@
-import * as _alloy_js_core15 from "@alloy-js/core";
+import * as _alloy_js_core16 from "@alloy-js/core";
 import { VarDeclarationProps } from "@alloy-js/typescript";
 
 //#region src/typescript/components/dynamic-import-statement.d.ts
@@ -26,7 +26,7 @@ interface DynamicImportStatementProps extends Omit<VarDeclarationProps, "initial
  * @param props - The properties for the dynamic import statement.
  * @returns A `VarDeclaration` component representing the dynamic import statement.
  */
-declare function DynamicImportStatement(props: DynamicImportStatementProps): _alloy_js_core15.Children;
+declare function DynamicImportStatement(props: DynamicImportStatementProps): _alloy_js_core16.Children;
 declare type __ΩDynamicImportStatementProps = any[];
 //#endregion
 export { DynamicImportStatement, DynamicImportStatementProps, __ΩDynamicImportStatementProps };

package/dist/typescript/components/entry-file.d.cts

@@ -1,6 +1,6 @@
 import { ResolvedEntryTypeDefinition } from "../../powerlines/src/types/resolved.cjs";
 import { TypescriptFileProps } from "./typescript-file.cjs";
-import * as _alloy_js_core4 from "@alloy-js/core";
+import * as _alloy_js_core8 from "@alloy-js/core";
 
 //#region src/typescript/components/entry-file.d.ts
 type EntryFileProps = TypescriptFileProps & {
@@ -21,7 +21,7 @@ type EntryFileProps = TypescriptFileProps & {
  * @param props - The properties for the source file.
  * @returns The rendered source file component.
  */
-declare function EntryFile(props: EntryFileProps): _alloy_js_core4.Children;
+declare function EntryFile(props: EntryFileProps): _alloy_js_core8.Children;
 declare type __ΩEntryFileProps = any[];
 //#endregion
 export { EntryFile, EntryFileProps, __ΩEntryFileProps };

package/dist/typescript/components/tsdoc-reflection.d.cts

@@ -1,18 +1,18 @@
 import { TSDocProps } from "./tsdoc.cjs";
-import * as _alloy_js_core14 from "@alloy-js/core";
+import * as _alloy_js_core0 from "@alloy-js/core";
 
 //#region src/typescript/components/tsdoc-reflection.d.ts
 /**
  * Generates a TypeScript interface property for the given reflection class.
  */
-declare function TSDocReflectionClass<T extends Record<string, any> = Record<string, any>>(props: TSDocProps): _alloy_js_core14.Children;
+declare function TSDocReflectionClass<T extends Record<string, any> = Record<string, any>>(props: TSDocProps): _alloy_js_core0.Children;
 /**
  * Generates a TypeScript interface property for the given reflection class.
  */
-declare function TSDocReflectionProperty(props: TSDocProps): _alloy_js_core14.Children;
+declare function TSDocReflectionProperty(props: TSDocProps): _alloy_js_core0.Children;
 /**
  * Generates a TypeScript interface property for the given reflection class.
  */
-declare function TSDocReflectionMethod(props: TSDocProps): _alloy_js_core14.Children;
+declare function TSDocReflectionMethod(props: TSDocProps): _alloy_js_core0.Children;
 //#endregion
 export { TSDocReflectionClass, TSDocReflectionMethod, TSDocReflectionProperty };

package/dist/typescript/components/typescript-file.cjs

@@ -152,13 +152,13 @@ function TypescriptFileHeader(props) {
 * @returns The rendered source file header.
 */
 function TypescriptFileHeaderImports(props) {
-	const { imports } = props;
+	const { imports, builtinImports } = props;
 	const context = require_core_contexts_context.usePowerlines();
 	const sourceFile = (0, __alloy_js_typescript.useSourceFile)();
 	const scope = props.scope ?? sourceFile.scope;
 	return (0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.Show, {
 		get when() {
-			return scope.importedModules.size > 0 || !!imports && Object.keys(imports).length > 0;
+			return scope.importedModules.size > 0 || !!builtinImports && Object.keys(builtinImports).length > 0 || !!imports && Object.keys(imports).length > 0;
 		},
 		get children() {
 			return [
@@ -171,19 +171,25 @@ function TypescriptFileHeaderImports(props) {
 							get each() {
 								return Object.entries(imports ?? {});
 							},
-							children: ([module$1, imported]) => {
-								if (module$1 === "$builtins") return (0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.For, {
-									get each() {
-										return Object.entries(imported ?? {});
-									},
-									children: ([builtinModule, builtinImports]) => __alloy_js_core.code`import ${builtinImports === null ? "" : ` from ${builtinImports.filter((i) => !(0, __stryke_type_checks_is_string.isString)(i) && i.default).map((i) => i.alias ? i.alias : i.name).join(", ") + (builtinImports.filter((i) => !(0, __stryke_type_checks_is_string.isString)(i) && i.default).length > 0 && builtinImports.filter((i) => (0, __stryke_type_checks_is_string.isString)(i) || !i.default).length > 0 ? ", " : "") + (builtinImports.filter((i) => (0, __stryke_type_checks_is_string.isString)(i) || !i.default).length > 0 ? `{ ${builtinImports.map((i) => (0, __stryke_type_checks_is_string.isString)(i) ? i : i.alias ? `${i.name} as ${i.alias}` : i.name).join(", ")} }` : "")} `} "${builtinModule.includes(":") ? builtinModule : `${context.config.output.builtinPrefix}:${builtinModule}`}";`
-								});
-								const normalImports = imported;
+							children: ([module$1, normalImports]) => {
 								return __alloy_js_core.code`import ${normalImports === null ? "" : ` from ${normalImports.filter((i) => !(0, __stryke_type_checks_is_string.isString)(i) && i.default).map((i) => i.alias ? i.alias : i.name).join(", ") + (normalImports.filter((i) => !(0, __stryke_type_checks_is_string.isString)(i) && i.default).length > 0 && normalImports.filter((i) => (0, __stryke_type_checks_is_string.isString)(i) || !i.default).length > 0 ? ", " : "") + (normalImports.filter((i) => (0, __stryke_type_checks_is_string.isString)(i) || !i.default).length > 0 ? `{ ${normalImports.map((i) => (0, __stryke_type_checks_is_string.isString)(i) ? i : i.alias ? `${i.name} as ${i.alias}` : i.name).join(", ")} }` : "")} `} "${module$1}";`;
 							}
 						});
 					}
 				}),
+				(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.Show, {
+					get when() {
+						return builtinImports && Object.keys(builtinImports).length > 0;
+					},
+					get children() {
+						return (0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.For, {
+							get each() {
+								return Object.entries(builtinImports ?? {});
+							},
+							children: ([builtinModule, builtinImports$1]) => __alloy_js_core.code`import ${builtinImports$1 === null ? "" : ` from ${builtinImports$1.filter((i) => !(0, __stryke_type_checks_is_string.isString)(i) && i.default).map((i) => i.alias ? i.alias : i.name).join(", ") + (builtinImports$1.filter((i) => !(0, __stryke_type_checks_is_string.isString)(i) && i.default).length > 0 && builtinImports$1.filter((i) => (0, __stryke_type_checks_is_string.isString)(i) || !i.default).length > 0 ? ", " : "") + (builtinImports$1.filter((i) => (0, __stryke_type_checks_is_string.isString)(i) || !i.default).length > 0 ? `{ ${builtinImports$1.map((i) => (0, __stryke_type_checks_is_string.isString)(i) ? i : i.alias ? `${i.name} as ${i.alias}` : i.name).join(", ")} }` : "")} `} "${builtinModule.includes(":") ? builtinModule : `${context.config.output.builtinPrefix}:${builtinModule}`}";`
+						});
+					}
+				}),
 				(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.Show, {
 					get when() {
 						return scope.importedModules.size > 0;