@powerlines/plugin-env 0.15.8 → 0.15.10

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

@@ -1,4 +1,6 @@
 import { ResolveOptions, VirtualFile, VirtualFileSystemInterface, WriteOptions } from "./fs.cjs";
+import { Plugin } from "./plugin.cjs";
+import { HooksList, InferHooksListItem } from "./hooks.cjs";
 import { ParsedTypeScriptConfig } from "./tsconfig.cjs";
 import { InlineConfig, LogFn, UserConfig, WorkspaceConfig } from "./config.cjs";
 import { EnvironmentResolvedConfig, ResolvedConfig, ResolvedEntryTypeDefinition } from "./resolved.cjs";
@@ -60,6 +62,9 @@ interface TransformResult$1 {
   code: string;
   map: SourceMap | null;
 }
+interface SelectHooksOptions {
+  order?: "pre" | "post" | "normal";
+}
 /**
  * Options for initializing or updating the context with new configuration values
  */
@@ -396,6 +401,112 @@ type Context<TResolvedConfig extends ResolvedConfig = ResolvedConfig> = Omit<Unr
    */
   config: TResolvedConfig;
 };
+interface APIContext<TResolvedConfig extends ResolvedConfig = ResolvedConfig> extends Context<TResolvedConfig> {
+  /**
+   * The expected plugins options for the Powerlines project.
+   *
+   * @remarks
+   * This is a record of plugin identifiers to their respective options. This field is populated by the Powerlines engine during both plugin initialization and the `init` command.
+   */
+  plugins: Plugin<PluginContext<TResolvedConfig>>[];
+  /**
+   * A function to add a plugin to the context and update the configuration options
+   */
+  addPlugin: (plugin: Plugin<PluginContext<TResolvedConfig>>) => Promise<void>;
+  /**
+   * A table for storing the current context for each configured environment
+   */
+  environments: Record<string, EnvironmentContext<TResolvedConfig>>;
+  /**
+   * Retrieves the context for a specific environment by name
+   *
+   * @throws Will throw an error if the environment does not exist
+   *
+   * @param name - The name of the environment to retrieve. If not provided, the default environment is returned.
+   * @returns A promise that resolves to the environment context.
+   *
+   * @example
+   * ```ts
+   * const devEnv = await apiContext.getEnvironment("development");
+   * const defaultEnv = await apiContext.getEnvironment();
+   * ```
+   */
+  getEnvironment: (name?: string) => Promise<EnvironmentContext<TResolvedConfig>>;
+  /**
+   * Safely retrieves the context for a specific environment by name
+   *
+   * @param name - The name of the environment to retrieve. If not provided, the default environment is returned.
+   * @returns A promise that resolves to the environment context, or undefined if the environment does not exist.
+   *
+   * @example
+   * ```ts
+   * const devEnv = await apiContext.getEnvironmentSafe("development");
+   * const defaultEnv = await apiContext.getEnvironmentSafe();
+   * ```
+   *
+   * @remarks
+   * This method is similar to `getEnvironment`, but it returns `undefined` instead of throwing an error if the specified environment does not exist.
+   * This can be useful in scenarios where the existence of an environment is optional or uncertain.
+   *
+   * ```ts
+   * const testEnv = await apiContext.getEnvironmentSafe("test");
+   * if (testEnv) {
+   *   // Environment exists, safe to use it
+   * } else {
+   *   // Environment does not exist, handle accordingly
+   * }
+   * ```
+   *
+   * Using this method helps avoid unhandled exceptions in cases where an environment might not be defined.
+   */
+  getEnvironmentSafe: (name?: string) => Promise<EnvironmentContext<TResolvedConfig> | undefined>;
+  /**
+   * A function to copy the context and update the fields for a specific environment
+   *
+   * @param environment - The environment configuration to use.
+   * @returns A new context instance with the updated environment.
+   */
+  in: (environment: EnvironmentResolvedConfig) => Promise<EnvironmentContext<TResolvedConfig>>;
+  /**
+   * A function to merge all configured environments into a single context
+   *
+   * @returns A promise that resolves to the merged environment context.
+   */
+  toEnvironment: () => Promise<EnvironmentContext<TResolvedConfig>>;
+}
+interface EnvironmentContextPlugin<TResolvedConfig extends ResolvedConfig = ResolvedConfig> {
+  plugin: Plugin<PluginContext<TResolvedConfig>>;
+  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.
+   *
+   * @remarks
+   * This is a record of plugin identifiers to their respective options. This field is populated by the Powerlines engine during both plugin initialization and the `init` command.
+   */
+  plugins: EnvironmentContextPlugin<TResolvedConfig>[];
+  /**
+   * A function to add a plugin to the context and update the configuration options
+   */
+  addPlugin: (plugin: Plugin<PluginContext<TResolvedConfig>>) => Promise<void>;
+  /**
+   * The environment specific resolved configuration
+   */
+  environment: EnvironmentResolvedConfig;
+  /**
+   * A table holding references to hook functions registered by plugins
+   */
+  hooks: HooksList<PluginContext<TResolvedConfig>>;
+  /**
+   * Retrieves the hook handlers for a specific hook name
+   */
+  selectHooks: <TKey extends string>(key: TKey, options?: SelectHooksOptions) => SelectHookResult<PluginContext<TResolvedConfig>, TKey>;
+}
 interface PluginContext<out TResolvedConfig extends ResolvedConfig = ResolvedConfig> extends Context<TResolvedConfig>, UnpluginContext {
   /**
    * The environment specific resolved configuration
@@ -410,5 +521,6 @@ 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;
 //#endregion
-export { BuildPluginContext, Context, LogLevel, PluginContext, UnresolvedContext };
+export { APIContext, BuildPluginContext, Context, EnvironmentContext, LogLevel, PluginContext, SelectHooksOptions, UnresolvedContext, WithUnpluginBuildContext };

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

@@ -1,6 +1,6 @@
 import { ResolveOptions, VirtualFile, VirtualFileSystemInterface, WriteOptions } from "./fs.mjs";
-import "./plugin.mjs";
-import "./hooks.mjs";
+import { Plugin } from "./plugin.mjs";
+import { HooksList, InferHooksListItem } from "./hooks.mjs";
 import { ParsedTypeScriptConfig } from "./tsconfig.mjs";
 import { InlineConfig, LogFn, UserConfig, WorkspaceConfig } from "./config.mjs";
 import { EnvironmentResolvedConfig, ResolvedConfig, ResolvedEntryTypeDefinition } from "./resolved.mjs";
@@ -62,6 +62,9 @@ interface TransformResult$1 {
   code: string;
   map: SourceMap | null;
 }
+interface SelectHooksOptions {
+  order?: "pre" | "post" | "normal";
+}
 /**
  * Options for initializing or updating the context with new configuration values
  */
@@ -398,6 +401,112 @@ type Context<TResolvedConfig extends ResolvedConfig = ResolvedConfig> = Omit<Unr
    */
   config: TResolvedConfig;
 };
+interface APIContext<TResolvedConfig extends ResolvedConfig = ResolvedConfig> extends Context<TResolvedConfig> {
+  /**
+   * The expected plugins options for the Powerlines project.
+   *
+   * @remarks
+   * This is a record of plugin identifiers to their respective options. This field is populated by the Powerlines engine during both plugin initialization and the `init` command.
+   */
+  plugins: Plugin<PluginContext<TResolvedConfig>>[];
+  /**
+   * A function to add a plugin to the context and update the configuration options
+   */
+  addPlugin: (plugin: Plugin<PluginContext<TResolvedConfig>>) => Promise<void>;
+  /**
+   * A table for storing the current context for each configured environment
+   */
+  environments: Record<string, EnvironmentContext<TResolvedConfig>>;
+  /**
+   * Retrieves the context for a specific environment by name
+   *
+   * @throws Will throw an error if the environment does not exist
+   *
+   * @param name - The name of the environment to retrieve. If not provided, the default environment is returned.
+   * @returns A promise that resolves to the environment context.
+   *
+   * @example
+   * ```ts
+   * const devEnv = await apiContext.getEnvironment("development");
+   * const defaultEnv = await apiContext.getEnvironment();
+   * ```
+   */
+  getEnvironment: (name?: string) => Promise<EnvironmentContext<TResolvedConfig>>;
+  /**
+   * Safely retrieves the context for a specific environment by name
+   *
+   * @param name - The name of the environment to retrieve. If not provided, the default environment is returned.
+   * @returns A promise that resolves to the environment context, or undefined if the environment does not exist.
+   *
+   * @example
+   * ```ts
+   * const devEnv = await apiContext.getEnvironmentSafe("development");
+   * const defaultEnv = await apiContext.getEnvironmentSafe();
+   * ```
+   *
+   * @remarks
+   * This method is similar to `getEnvironment`, but it returns `undefined` instead of throwing an error if the specified environment does not exist.
+   * This can be useful in scenarios where the existence of an environment is optional or uncertain.
+   *
+   * ```ts
+   * const testEnv = await apiContext.getEnvironmentSafe("test");
+   * if (testEnv) {
+   *   // Environment exists, safe to use it
+   * } else {
+   *   // Environment does not exist, handle accordingly
+   * }
+   * ```
+   *
+   * Using this method helps avoid unhandled exceptions in cases where an environment might not be defined.
+   */
+  getEnvironmentSafe: (name?: string) => Promise<EnvironmentContext<TResolvedConfig> | undefined>;
+  /**
+   * A function to copy the context and update the fields for a specific environment
+   *
+   * @param environment - The environment configuration to use.
+   * @returns A new context instance with the updated environment.
+   */
+  in: (environment: EnvironmentResolvedConfig) => Promise<EnvironmentContext<TResolvedConfig>>;
+  /**
+   * A function to merge all configured environments into a single context
+   *
+   * @returns A promise that resolves to the merged environment context.
+   */
+  toEnvironment: () => Promise<EnvironmentContext<TResolvedConfig>>;
+}
+interface EnvironmentContextPlugin<TResolvedConfig extends ResolvedConfig = ResolvedConfig> {
+  plugin: Plugin<PluginContext<TResolvedConfig>>;
+  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.
+   *
+   * @remarks
+   * This is a record of plugin identifiers to their respective options. This field is populated by the Powerlines engine during both plugin initialization and the `init` command.
+   */
+  plugins: EnvironmentContextPlugin<TResolvedConfig>[];
+  /**
+   * A function to add a plugin to the context and update the configuration options
+   */
+  addPlugin: (plugin: Plugin<PluginContext<TResolvedConfig>>) => Promise<void>;
+  /**
+   * The environment specific resolved configuration
+   */
+  environment: EnvironmentResolvedConfig;
+  /**
+   * A table holding references to hook functions registered by plugins
+   */
+  hooks: HooksList<PluginContext<TResolvedConfig>>;
+  /**
+   * Retrieves the hook handlers for a specific hook name
+   */
+  selectHooks: <TKey extends string>(key: TKey, options?: SelectHooksOptions) => SelectHookResult<PluginContext<TResolvedConfig>, TKey>;
+}
 interface PluginContext<out TResolvedConfig extends ResolvedConfig = ResolvedConfig> extends Context<TResolvedConfig>, UnpluginContext {
   /**
    * The environment specific resolved configuration
@@ -412,5 +521,6 @@ 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;
 //#endregion
-export { BuildPluginContext, Context, EmitEntryOptions, EmitOptions, FetchOptions, InitContextOptions, LogLevel, MetaInfo, ParseOptions, PluginContext, Resolver, TransformResult$1 as TransformResult, UnresolvedContext };
+export { APIContext, BuildPluginContext, Context, EmitEntryOptions, EmitOptions, EnvironmentContext, EnvironmentContextPlugin, FetchOptions, InitContextOptions, LogLevel, MetaInfo, ParseOptions, PluginContext, Resolver, SelectHookResult, SelectHookResultItem, SelectHooksOptions, TransformResult$1 as TransformResult, UnresolvedContext, WithUnpluginBuildContext };

package/dist/powerlines/src/types/context.mjs

@@ -293,6 +293,59 @@ const __ΩContext = [
 	"Context",
 	"\"w!c\"Pe\"!o$\".%o##Pe#!4&?'MKw(y"
 ];
+const __ΩEnvironmentContextPlugin = [
+	"ResolvedConfig",
+	"TResolvedConfig",
+	"Plugin",
+	"plugin",
+	() => __ΩPluginContext,
+	"context",
+	"EnvironmentContextPlugin",
+	"\"w!c\"P\"w#4$e\"!o%\"4&Mw'y"
+];
+const __ΩSelectHookResultItem = [
+	"TContext",
+	"TKey",
+	"InferHooksListItem",
+	"context",
+	"SelectHookResultItem",
+	"b!b\"P\"w#Pe#!4$MKw%y"
+];
+const __ΩSelectHookResult = [
+	"TContext",
+	"TKey",
+	() => __ΩSelectHookResultItem,
+	"SelectHookResult",
+	"b!b\"e!!e!\"o##Fw$y"
+];
+const __ΩEnvironmentContext = [
+	"ResolvedConfig",
+	"TResolvedConfig",
+	() => __ΩContext,
+	() => __ΩEnvironmentContextPlugin,
+	"plugins",
+	"The expected plugins options for the Powerlines project.",
+	"Plugin",
+	"plugin",
+	"",
+	"addPlugin",
+	"A function to add a plugin to the context and update the configuration options",
+	"EnvironmentResolvedConfig",
+	"environment",
+	"The environment specific resolved configuration",
+	"HooksList",
+	"hooks",
+	"A table holding references to hook functions registered by plugins",
+	"key",
+	() => __ΩSelectHooksOptions,
+	"options",
+	() => __ΩSelectHookResult,
+	() => __ΩPluginContext,
+	"selectHooks",
+	"Retrieves the hook handlers for a specific hook name",
+	"EnvironmentContext",
+	"\"w!c\"Pe\"!o#\"e\"!o$\"F4%?&P\"w'2($`/)4*?+\"w,4-?.\"w/40?1P\"22n3248e#!o6\"\"o5#/)47?8Mw9y"
+];
 const __ΩPluginContext = [
 	"ResolvedConfig",
 	"TResolvedConfig",
@@ -308,4 +361,4 @@ const __ΩPluginContext = [
 ];
 
 //#endregion
-export { __ΩContext, __ΩEmitEntryOptions, __ΩEmitOptions, __ΩFetchOptions, __ΩInitContextOptions, __ΩLogLevel, __ΩMetaInfo, __ΩParseOptions, __ΩPluginContext, __ΩResolver, __ΩSelectHooksOptions, __ΩTransformResult, __ΩUnresolvedContext };
+export { __ΩContext, __ΩEmitEntryOptions, __ΩEmitOptions, __ΩEnvironmentContext, __ΩEnvironmentContextPlugin, __ΩFetchOptions, __ΩInitContextOptions, __ΩLogLevel, __ΩMetaInfo, __ΩParseOptions, __ΩPluginContext, __ΩResolver, __ΩSelectHookResult, __ΩSelectHookResultItem, __ΩSelectHooksOptions, __ΩTransformResult, __ΩUnresolvedContext };

package/dist/powerlines/src/types/hooks.cjs

@@ -1,5 +1,11 @@
+const require_build = require('./build.cjs');
 
 //#region ../powerlines/src/types/hooks.ts
+const __ΩRequired = [
+	"T",
+	"Required",
+	"l+e#!e\"!fRb!Pde\"!gN##w\"y"
+];
 const __ΩReturnType = [
 	"T",
 	"args",
@@ -14,39 +20,52 @@ const __ΩParameters = [
 	"Parameters",
 	"l>e\"!R!RPde#!Ph\"!@2\"\"/#qk#'QRb!Pde\"!p)w$y"
 ];
-const __ΩHooks = [
+const __ΩUnpluginHookFunctions = [
 	"PluginContext",
 	"TContext",
-	"PluginHookFunctions",
-	"Hooks",
-	"\"w!c\"\"w#w$y"
+	() => require_build.__ΩUnpluginBuilderVariant,
+	"TUnpluginBuilderVariant",
+	() => __ΩRequired,
+	"TField",
+	() => __ΩRequired,
+	"handler",
+	"this",
+	"args",
+	"",
+	"WithUnpluginBuildContext",
+	"UnpluginHookFunctions",
+	"l½PPe$!\"w,K2)e#\"@2*e##/+RPPe$!\"w,K2)e#\"@2*e##/+R!RPddde#!Ph\"!2)h\"\"@2*h\"#/+qk:QQRPde#!pSR!RPde#!Ph\"!4(MqkqyQRPde%!p{RPddde#!Ph\"!2)h\"\"@2*h\"#/+qk#QRPde#!p•R!R\"w!c\"n#c$!o%\"e!\"fgc&Pd!o'\"e\"\"fe\"#fPh\"!Ph#!4(MJqk³»Qw-y"
 ];
-const __ΩInferHookHandler = [
+const __ΩInferHookFunction = [
 	"TContext",
 	"TKey",
-	() => __ΩHooks,
-	"InferHookHandler",
-	"b!b\"e!!o#\"e!\"fw$y"
+	":",
+	() => require_build.__ΩUnpluginBuilderVariant,
+	() => __ΩRequired,
+	() => __ΩUnpluginHookFunctions,
+	"PluginHookFunctions",
+	"InferHookFunction",
+	"l™e-!e(!e$!o&$R!RPe#!!o%\"e'!fgqk#0QRPde'\"p2R!RPe#!n$qkEMQRPde#!pOR\"w'e$!fR!RPe#!\"w'gqkckQRPde%!pmRPdde#!Ph\"!.#h\"\"Sqk[{QRb!b\"Pde\"\"pƒw(y"
 ];
 const __ΩInferHookReturnType = [
 	"TContext",
 	"TKey",
 	() => __ΩReturnType,
-	() => __ΩInferHookHandler,
+	() => __ΩInferHookFunction,
 	"InferHookReturnType",
-	"lUe\"!Re$!RPde#!h!!`qk#'QRPde#!p+Re$!RPde#!h!!`qk:BQRb!b\"Pde\"!e\"\"o$#o#\"pFw%y"
+	"b!b\"e!!e!\"o$#o#\"w%y"
 ];
 const __ΩInferHookParameters = [
 	"TContext",
 	"TKey",
 	() => __ΩParameters,
-	() => __ΩInferHookHandler,
+	() => __ΩInferHookFunction,
 	"InferHookParameters",
 	"b!b\"e!!e!\"o$#o#\"w%y"
 ];
 
 //#endregion
-exports.__ΩHooks = __ΩHooks;
-exports.__ΩInferHookHandler = __ΩInferHookHandler;
+exports.__ΩInferHookFunction = __ΩInferHookFunction;
 exports.__ΩInferHookParameters = __ΩInferHookParameters;
-exports.__ΩInferHookReturnType = __ΩInferHookReturnType;
+exports.__ΩInferHookReturnType = __ΩInferHookReturnType;
+exports.__ΩUnpluginHookFunctions = __ΩUnpluginHookFunctions;

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

@@ -0,0 +1,32 @@
+import { UnpluginBuilderVariant } from "./build.cjs";
+import { Plugin, PluginHookFields, PluginHookFunctions } from "./plugin.cjs";
+import { PluginContext, WithUnpluginBuildContext } from "./context.cjs";
+import { UnpluginOptions } from "unplugin";
+
+//#region ../powerlines/src/types/hooks.d.ts
+type HookListOrders = "preOrdered" | "preEnforced" | "normal" | "postEnforced" | "postOrdered";
+type UnpluginHookFunctions<TContext extends PluginContext = PluginContext, TUnpluginBuilderVariant$1 extends UnpluginBuilderVariant = UnpluginBuilderVariant, TField$1 extends keyof Required<UnpluginOptions>[TUnpluginBuilderVariant$1] = keyof Required<UnpluginOptions>[TUnpluginBuilderVariant$1]> = Required<UnpluginOptions>[TUnpluginBuilderVariant$1][TField$1] 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];
+}
+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$1 extends UnpluginBuilderVariant = UnpluginBuilderVariant, TField$1 extends keyof Required<UnpluginOptions>[TUnpluginBuilderVariant$1] = keyof Required<UnpluginOptions>[TUnpluginBuilderVariant$1]> {
+  plugin: Plugin<TContext>;
+  handler: UnpluginHookFunctions<TContext, TUnpluginBuilderVariant$1, TField$1>;
+}
+type UnpluginHookList<TContext extends PluginContext = PluginContext, TUnpluginBuilderVariant$1 extends UnpluginBuilderVariant = UnpluginBuilderVariant, TField$1 extends keyof UnpluginOptions[TUnpluginBuilderVariant$1] = keyof UnpluginOptions[TUnpluginBuilderVariant$1]> = { [TKey in HookListOrders]?: UnpluginHooksListItem<TContext, TUnpluginBuilderVariant$1, TField$1>[] | undefined };
+type UnpluginHookVariantField<TContext extends PluginContext = PluginContext, TUnpluginBuilderVariant$1 extends UnpluginBuilderVariant = UnpluginBuilderVariant> = { [TKey in keyof UnpluginOptions[TUnpluginBuilderVariant$1]]?: UnpluginHookList<TContext, TUnpluginBuilderVariant$1, 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> = { [TField in HookFields<TContext>]?: TField extends PluginHookFields<TContext> ? PluginHooksList<TContext, TField> : TField extends UnpluginBuilderVariant ? UnpluginHookVariant<TContext>[TField] : never };
+type InferHooksListItem<TContext extends PluginContext, TKey$1 extends string> = TKey$1 extends `${infer TUnpluginBuilderVariant}:${infer TUnpluginField}` ? TUnpluginBuilderVariant extends UnpluginBuilderVariant ? TUnpluginField extends keyof Required<UnpluginOptions>[TUnpluginBuilderVariant] ? UnpluginHooksListItem<TContext, TUnpluginBuilderVariant, TUnpluginField> : never : never : TKey$1 extends keyof PluginHookFunctions<TContext> ? PluginHooksListItem<TContext, TKey$1> : never;
+type InferHookFunction<TContext extends PluginContext, TKey$1 extends string> = TKey$1 extends `${infer TUnpluginBuilderVariant}:${infer TUnpluginField}` ? TUnpluginBuilderVariant extends UnpluginBuilderVariant ? TUnpluginField extends keyof Required<UnpluginOptions>[TUnpluginBuilderVariant] ? UnpluginHookFunctions<TContext, TUnpluginBuilderVariant, TUnpluginField> : never : never : TKey$1 extends keyof PluginHookFunctions<TContext> ? PluginHookFunctions<TContext>[TKey$1] : never;
+type InferHookReturnType<TContext extends PluginContext, TKey$1 extends string> = ReturnType<InferHookFunction<TContext, TKey$1>>;
+type InferHookParameters<TContext extends PluginContext, TKey$1 extends string> = Parameters<InferHookFunction<TContext, TKey$1>>;
+//#endregion
+export { HooksList, InferHookParameters, InferHookReturnType, InferHooksListItem };

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

@@ -1,2 +1,32 @@
-import "./plugin.mjs";
-import "./context.mjs";
+import { UnpluginBuilderVariant } from "./build.mjs";
+import { Plugin, PluginHookFields, PluginHookFunctions } from "./plugin.mjs";
+import { PluginContext, WithUnpluginBuildContext } from "./context.mjs";
+import { UnpluginOptions } from "unplugin";
+
+//#region ../powerlines/src/types/hooks.d.ts
+type HookListOrders = "preOrdered" | "preEnforced" | "normal" | "postEnforced" | "postOrdered";
+type UnpluginHookFunctions<TContext extends PluginContext = PluginContext, TUnpluginBuilderVariant$1 extends UnpluginBuilderVariant = UnpluginBuilderVariant, TField$1 extends keyof Required<UnpluginOptions>[TUnpluginBuilderVariant$1] = keyof Required<UnpluginOptions>[TUnpluginBuilderVariant$1]> = Required<UnpluginOptions>[TUnpluginBuilderVariant$1][TField$1] 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];
+}
+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$1 extends UnpluginBuilderVariant = UnpluginBuilderVariant, TField$1 extends keyof Required<UnpluginOptions>[TUnpluginBuilderVariant$1] = keyof Required<UnpluginOptions>[TUnpluginBuilderVariant$1]> {
+  plugin: Plugin<TContext>;
+  handler: UnpluginHookFunctions<TContext, TUnpluginBuilderVariant$1, TField$1>;
+}
+type UnpluginHookList<TContext extends PluginContext = PluginContext, TUnpluginBuilderVariant$1 extends UnpluginBuilderVariant = UnpluginBuilderVariant, TField$1 extends keyof UnpluginOptions[TUnpluginBuilderVariant$1] = keyof UnpluginOptions[TUnpluginBuilderVariant$1]> = { [TKey in HookListOrders]?: UnpluginHooksListItem<TContext, TUnpluginBuilderVariant$1, TField$1>[] | undefined };
+type UnpluginHookVariantField<TContext extends PluginContext = PluginContext, TUnpluginBuilderVariant$1 extends UnpluginBuilderVariant = UnpluginBuilderVariant> = { [TKey in keyof UnpluginOptions[TUnpluginBuilderVariant$1]]?: UnpluginHookList<TContext, TUnpluginBuilderVariant$1, 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> = { [TField in HookFields<TContext>]?: TField extends PluginHookFields<TContext> ? PluginHooksList<TContext, TField> : TField extends UnpluginBuilderVariant ? UnpluginHookVariant<TContext>[TField] : never };
+type InferHooksListItem<TContext extends PluginContext, TKey$1 extends string> = TKey$1 extends `${infer TUnpluginBuilderVariant}:${infer TUnpluginField}` ? TUnpluginBuilderVariant extends UnpluginBuilderVariant ? TUnpluginField extends keyof Required<UnpluginOptions>[TUnpluginBuilderVariant] ? UnpluginHooksListItem<TContext, TUnpluginBuilderVariant, TUnpluginField> : never : never : TKey$1 extends keyof PluginHookFunctions<TContext> ? PluginHooksListItem<TContext, TKey$1> : never;
+type InferHookFunction<TContext extends PluginContext, TKey$1 extends string> = TKey$1 extends `${infer TUnpluginBuilderVariant}:${infer TUnpluginField}` ? TUnpluginBuilderVariant extends UnpluginBuilderVariant ? TUnpluginField extends keyof Required<UnpluginOptions>[TUnpluginBuilderVariant] ? UnpluginHookFunctions<TContext, TUnpluginBuilderVariant, TUnpluginField> : never : never : TKey$1 extends keyof PluginHookFunctions<TContext> ? PluginHookFunctions<TContext>[TKey$1] : never;
+type InferHookReturnType<TContext extends PluginContext, TKey$1 extends string> = ReturnType<InferHookFunction<TContext, TKey$1>>;
+type InferHookParameters<TContext extends PluginContext, TKey$1 extends string> = Parameters<InferHookFunction<TContext, TKey$1>>;
+//#endregion
+export { HookFields, HookListOrders, HooksList, InferHookFunction, InferHookParameters, InferHookReturnType, InferHooksListItem, PluginHooksList, PluginHooksListItem, UnpluginHookFunctions, UnpluginHookList, UnpluginHookVariant, UnpluginHookVariantField, UnpluginHooksListItem };

package/dist/powerlines/src/types/hooks.mjs

@@ -1,4 +1,11 @@
+import { __ΩUnpluginBuilderVariant } from "./build.mjs";
+
 //#region ../powerlines/src/types/hooks.ts
+const __ΩRequired = [
+	"T",
+	"Required",
+	"l+e#!e\"!fRb!Pde\"!gN##w\"y"
+];
 const __ΩReturnType = [
 	"T",
 	"args",
@@ -13,36 +20,49 @@ const __ΩParameters = [
 	"Parameters",
 	"l>e\"!R!RPde#!Ph\"!@2\"\"/#qk#'QRb!Pde\"!p)w$y"
 ];
-const __ΩHooks = [
+const __ΩUnpluginHookFunctions = [
 	"PluginContext",
 	"TContext",
-	"PluginHookFunctions",
-	"Hooks",
-	"\"w!c\"\"w#w$y"
+	() => __ΩUnpluginBuilderVariant,
+	"TUnpluginBuilderVariant",
+	() => __ΩRequired,
+	"TField",
+	() => __ΩRequired,
+	"handler",
+	"this",
+	"args",
+	"",
+	"WithUnpluginBuildContext",
+	"UnpluginHookFunctions",
+	"l½PPe$!\"w,K2)e#\"@2*e##/+RPPe$!\"w,K2)e#\"@2*e##/+R!RPddde#!Ph\"!2)h\"\"@2*h\"#/+qk:QQRPde#!pSR!RPde#!Ph\"!4(MqkqyQRPde%!p{RPddde#!Ph\"!2)h\"\"@2*h\"#/+qk#QRPde#!p•R!R\"w!c\"n#c$!o%\"e!\"fgc&Pd!o'\"e\"\"fe\"#fPh\"!Ph#!4(MJqk³»Qw-y"
 ];
-const __ΩInferHookHandler = [
+const __ΩInferHookFunction = [
 	"TContext",
 	"TKey",
-	() => __ΩHooks,
-	"InferHookHandler",
-	"b!b\"e!!o#\"e!\"fw$y"
+	":",
+	() => __ΩUnpluginBuilderVariant,
+	() => __ΩRequired,
+	() => __ΩUnpluginHookFunctions,
+	"PluginHookFunctions",
+	"InferHookFunction",
+	"l™e-!e(!e$!o&$R!RPe#!!o%\"e'!fgqk#0QRPde'\"p2R!RPe#!n$qkEMQRPde#!pOR\"w'e$!fR!RPe#!\"w'gqkckQRPde%!pmRPdde#!Ph\"!.#h\"\"Sqk[{QRb!b\"Pde\"\"pƒw(y"
 ];
 const __ΩInferHookReturnType = [
 	"TContext",
 	"TKey",
 	() => __ΩReturnType,
-	() => __ΩInferHookHandler,
+	() => __ΩInferHookFunction,
 	"InferHookReturnType",
-	"lUe\"!Re$!RPde#!h!!`qk#'QRPde#!p+Re$!RPde#!h!!`qk:BQRb!b\"Pde\"!e\"\"o$#o#\"pFw%y"
+	"b!b\"e!!e!\"o$#o#\"w%y"
 ];
 const __ΩInferHookParameters = [
 	"TContext",
 	"TKey",
 	() => __ΩParameters,
-	() => __ΩInferHookHandler,
+	() => __ΩInferHookFunction,
 	"InferHookParameters",
 	"b!b\"e!!e!\"o$#o#\"w%y"
 ];
 
 //#endregion
-export { __ΩHooks, __ΩInferHookHandler, __ΩInferHookParameters, __ΩInferHookReturnType };
+export { __ΩInferHookFunction, __ΩInferHookParameters, __ΩInferHookReturnType, __ΩUnpluginHookFunctions };

package/dist/powerlines/src/types/index.cjs

@@ -3,9 +3,9 @@ const require_config = require('./config.cjs');
 const require_resolved = require('./resolved.cjs');
 const require_context = require('./context.cjs');
 const require_build = require('./build.cjs');
+const require_hooks = require('./hooks.cjs');
+const require_api = require('./api.cjs');
+const require_unplugin = require('./unplugin.cjs');
 const require_commands = require('./commands.cjs');
 const require_plugin = require('./plugin.cjs');
 const require_babel = require('./babel.cjs');
-const require_hooks = require('./hooks.cjs');
-require('./api.cjs');
-require('./unplugin.cjs');

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

@@ -1,12 +1,12 @@
 import { ResolveOptions, StorageAdapter, StoragePort, StoragePreset, VirtualFile, VirtualFileData, VirtualFileMetadata, VirtualFileSystemInterface, WriteOptions } from "./fs.mjs";
-import { BuildConfig, BuildResolvedConfig, UnpluginBuildVariant } from "./build.mjs";
+import { BuildConfig, BuildResolvedConfig, BuilderVariant, ESBuildBuildConfig, ESBuildResolvedBuildConfig, FarmBuildConfig, FarmResolvedBuildConfig, InferUnpluginVariant, RolldownBuildConfig, RolldownResolvedBuildConfig, RollupBuildConfig, RollupBuildOutputConfig, RollupResolvedBuildConfig, RspackBuildConfig, RspackResolvedBuildConfig, TsdownBuildConfig, TsdownResolvedBuildConfig, TsupBuildConfig, TsupResolvedBuildConfig, UnbuildBuildConfig, UnbuildResolvedBuildConfig, UnpluginBuilderVariant, ViteBuildConfig, ViteResolvedBuildConfig, WebpackBuildConfig, WebpackResolvedBuildConfig } from "./build.mjs";
 import { CommandType, SUPPORTED_COMMANDS } from "./commands.mjs";
-import { BasePluginHookFunctions, BuildPlugin, ConfigResult, Plugin, PluginBuildPlugins, PluginHook, PluginHookObject, PluginHooks, TypesResult } from "./plugin.mjs";
-import "./hooks.mjs";
+import { API } from "./api.mjs";
+import { InferUnpluginOptions, UnpluginOptions } from "./unplugin.mjs";
+import { Plugin, PluginHook, PluginHookFields, PluginHookFunctions, PluginHookObject, PluginHooks, TypesResult } from "./plugin.mjs";
+import { HookFields, HookListOrders, HooksList, InferHookFunction, InferHookParameters, InferHookReturnType, InferHooksListItem, PluginHooksList, PluginHooksListItem, UnpluginHookFunctions, UnpluginHookList, UnpluginHookVariant, UnpluginHookVariantField, UnpluginHooksListItem } from "./hooks.mjs";
 import { DeepkitOptions, ParsedTypeScriptConfig, RawReflectionMode, ReflectionLevel, ReflectionMode, TSCompilerOptions, TSConfig } from "./tsconfig.mjs";
-import { BuildPluginContext, Context, EmitEntryOptions, EmitOptions, FetchOptions, InitContextOptions, LogLevel, MetaInfo, ParseOptions, PluginContext, Resolver, TransformResult, UnresolvedContext } from "./context.mjs";
+import { APIContext, BuildPluginContext, Context, EmitEntryOptions, EmitOptions, EnvironmentContext, EnvironmentContextPlugin, FetchOptions, InitContextOptions, LogLevel, MetaInfo, ParseOptions, PluginContext, Resolver, SelectHookResult, SelectHookResultItem, SelectHooksOptions, TransformResult, UnresolvedContext, WithUnpluginBuildContext } from "./context.mjs";
 import { BabelPluginPass, BabelTransformPlugin, BabelTransformPluginFilter, BabelTransformPluginOptions, DeclareBabelTransformPluginReturn } from "./babel.mjs";
-import { BabelUserConfig, BaseConfig, CommonUserConfig, DeployConfig, EnvironmentConfig, InlineConfig, LogFn, OutputConfig, PluginConfig, PluginConfigObject, PluginConfigTuple, PluginFactory, PowerlinesCommand, ProjectType, UserConfig, WorkspaceConfig } from "./config.mjs";
-import { BabelResolvedConfig, EnvironmentResolvedConfig, OutputResolvedConfig, ResolvedAssetGlob, ResolvedConfig, ResolvedEntryTypeDefinition } from "./resolved.mjs";
-import "./api.mjs";
-import "./unplugin.mjs";
+import { BabelUserConfig, BaseConfig, BuildInlineConfig, CleanInlineConfig, CommonUserConfig, DeployConfig, DeployInlineConfig, DocsInlineConfig, ESBuildUserConfig, EnvironmentConfig, FarmUserConfig, InlineConfig, LintInlineConfig, LogFn, NewInlineConfig, OutputConfig, PluginConfig, PluginConfigObject, PluginConfigTuple, PluginFactory, PowerlinesCommand, PrepareInlineConfig, ProjectType, RolldownUserConfig, RollupUserConfig, RspackUserConfig, TsdownUserConfig, TsupUserConfig, UnbuildUserConfig, UserConfig, ViteUserConfig, WebpackUserConfig, WorkspaceConfig } from "./config.mjs";
+import { BabelResolvedConfig, ESBuildResolvedConfig, EnvironmentResolvedConfig, FarmResolvedConfig, InferResolvedConfig, OutputResolvedConfig, ResolvedAssetGlob, ResolvedConfig, ResolvedEntryTypeDefinition, RolldownResolvedConfig, RollupResolvedConfig, RspackResolvedConfig, TsdownResolvedConfig, TsupResolvedConfig, UnbuildResolvedConfig, ViteResolvedConfig, WebpackResolvedConfig } from "./resolved.mjs";

package/dist/powerlines/src/types/index.mjs

@@ -1,13 +1,13 @@
 import { __ΩStorageAdapter, __ΩStoragePort, __ΩStoragePreset } from "./fs.mjs";
-import { __ΩBabelUserConfig, __ΩBaseConfig, __ΩCommonUserConfig, __ΩDeployConfig, __ΩEnvironmentConfig, __ΩLogFn, __ΩOutputConfig, __ΩPluginConfig, __ΩPluginConfigObject, __ΩPluginConfigTuple, __ΩPluginFactory, __ΩProjectType, __ΩUserConfig, __ΩWorkspaceConfig } from "./config.mjs";
+import { __ΩBabelUserConfig, __ΩBaseConfig, __ΩBuildInlineConfig, __ΩCleanInlineConfig, __ΩCommonUserConfig, __ΩDeployConfig, __ΩDeployInlineConfig, __ΩDocsInlineConfig, __ΩEnvironmentConfig, __ΩInlineConfig, __ΩLintInlineConfig, __ΩLogFn, __ΩNewInlineConfig, __ΩOutputConfig, __ΩPluginConfig, __ΩPluginConfigObject, __ΩPluginConfigTuple, __ΩPluginFactory, __ΩPowerlinesCommand, __ΩPrepareInlineConfig, __ΩProjectType, __ΩUserConfig, __ΩWorkspaceConfig } from "./config.mjs";
 import { __ΩBabelResolvedConfig, __ΩOutputResolvedConfig, __ΩResolvedAssetGlob, __ΩResolvedConfig, __ΩResolvedEntryTypeDefinition } from "./resolved.mjs";
-import { __ΩContext, __ΩEmitEntryOptions, __ΩEmitOptions, __ΩFetchOptions, __ΩInitContextOptions, __ΩLogLevel, __ΩMetaInfo, __ΩParseOptions, __ΩPluginContext, __ΩResolver, __ΩSelectHooksOptions, __ΩTransformResult, __ΩUnresolvedContext } from "./context.mjs";
-import { UNPLUGIN_BUILD_VARIANTS, __ΩBuildConfig, __ΩBuildResolvedConfig, __ΩESBuildResolvedBuildConfig } from "./build.mjs";
+import { __ΩContext, __ΩEmitEntryOptions, __ΩEmitOptions, __ΩEnvironmentContext, __ΩEnvironmentContextPlugin, __ΩFetchOptions, __ΩInitContextOptions, __ΩLogLevel, __ΩMetaInfo, __ΩParseOptions, __ΩPluginContext, __ΩResolver, __ΩSelectHookResult, __ΩSelectHookResultItem, __ΩSelectHooksOptions, __ΩTransformResult, __ΩUnresolvedContext } from "./context.mjs";
+import { BUILDER_VARIANTS, UNPLUGIN_BUILDER_VARIANTS, __ΩBuildConfig, __ΩBuildResolvedConfig, __ΩESBuildResolvedBuildConfig, __ΩUnpluginBuilderVariant } from "./build.mjs";
+import { __ΩInferHookFunction, __ΩInferHookParameters, __ΩInferHookReturnType, __ΩUnpluginHookFunctions } from "./hooks.mjs";
+import { __ΩAPI } from "./api.mjs";
+import { __ΩInferUnpluginOptions, __ΩUnpluginOptions } from "./unplugin.mjs";
 import { SUPPORTED_COMMANDS } from "./commands.mjs";
-import { KNOWN_HOOKS, PLUGIN_NON_HOOK_FIELDS, __ΩBasePluginHookFunctions, __ΩBuildPlugin, __ΩConfigResult, __ΩPlugin, __ΩPluginBuildPlugins, __ΩPluginHook, __ΩPluginHookObject, __ΩPluginHooks } from "./plugin.mjs";
+import { PLUGIN_HOOKS_FIELDS, PLUGIN_NON_HOOK_FIELDS, __ΩPlugin, __ΩPluginHook, __ΩPluginHookFunctions, __ΩPluginHookObject, __ΩPluginHooks } from "./plugin.mjs";
 import { __ΩBabelPluginPass, __ΩBabelTransformPlugin, __ΩBabelTransformPluginBuilder, __ΩBabelTransformPluginBuilderParams, __ΩBabelTransformPluginFilter, __ΩBabelTransformPluginOptions, __ΩDeclareBabelTransformPluginReturn, __ΩImportSpecifier, __ΩResolvedBabelTransformPluginOptions } from "./babel.mjs";
-import { __ΩHooks, __ΩInferHookHandler, __ΩInferHookParameters, __ΩInferHookReturnType } from "./hooks.mjs";
-import "./api.mjs";
-import "./unplugin.mjs";
 
 export {  };