@powerlines/core 0.0.8

package/dist/types/plugin.d.cts

@@ -0,0 +1,218 @@
+import { CommandType } from "./commands.cjs";
+import { BuilderVariant, InferUnpluginOptions, UnpluginBuilderVariant } from "./unplugin.cjs";
+import { BuildPluginContext, PluginContext, UnresolvedContext } from "./context.cjs";
+import { EnvironmentConfig, EnvironmentResolvedConfig, PluginConfig, ResolvedConfig } from "./config.cjs";
+import { AnyFunction, MaybePromise } from "@stryke/types/base";
+import { ExternalIdResult, HookFilter, TransformResult } from "unplugin";
+import { ArrayValues } from "@stryke/types/array";
+import { LoadResult } from "rollup";
+
+//#region src/types/plugin.d.ts
+interface PluginHookObject<THookFunction extends AnyFunction, TFilter extends keyof HookFilter = never> {
+  /**
+   * The order in which the plugin should be applied.
+   */
+  order?: "pre" | "post" | null | undefined;
+  /**
+   * A filter to determine when the hook should be called.
+   */
+  filter?: Pick<HookFilter, TFilter>;
+  /**
+   * The hook function to be called.
+   */
+  handler: THookFunction;
+}
+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.
+ */
+interface TypesResult {
+  directives?: string[];
+  code: string;
+}
+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.
+   *
+   * @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.
+   *
+   * @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: (this: UnresolvedContext<TContext["config"]>) => MaybePromise<DeepPartial$1<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.
+   *
+   * @remarks
+   * This hook is called for each environment with a partially resolved environment config that already accounts for the default environment config values set at the root level. If plugins need to modify the config of a given environment, they should do it in this hook instead of the config hook. Leaving the config hook only for modifying the root default environment config.
+   *
+   * @see https://vitejs.dev/guide/api-plugin#configenvironment
+   *
+   * @param this - The build context.
+   * @param name - The name of the environment being configured.
+   * @param environment - The Vite-like environment object containing information about the current build environment.
+   * @returns A promise that resolves when the hook is complete.
+   */
+  configEnvironment: (this: TContext, name: string, environment: EnvironmentConfig) => MaybePromise<Partial<EnvironmentResolvedConfig> | undefined | null>;
+  /**
+   * A hook that is called when the plugin is resolved.
+   *
+   * @see https://vitejs.dev/guide/api-plugin#configresolved
+   *
+   * @param this - The build context.
+   * @returns A promise that resolves when the hook is complete.
+   */
+  configResolved: (this: TContext) => MaybePromise<void>;
+  /**
+   * A hook that is called to overwrite the generated declaration types file (.d.ts). The generated type definitions should describe the built-in modules/logic added during the `prepare` task.
+   *
+   * @param this - The build context.
+   * @param code - The source code to generate types for.
+   * @returns A promise that resolves when the hook is complete.
+   */
+  types: (this: TContext, code: string) => MaybePromise<TypesResult | string | undefined | null>;
+  /**
+   * A hook that is called at the start of the build process.
+   *
+   * @param this - The build context and unplugin build context.
+   * @returns A promise that resolves when the hook is complete.
+   */
+  buildStart: (this: BuildPluginContext<TContext["config"]> & TContext) => MaybePromise<void>;
+  /**
+   * A hook that is called at the end of the build process.
+   *
+   * @param this - The build context and unplugin build context.
+   * @returns A promise that resolves when the hook is complete.
+   */
+  buildEnd: (this: BuildPluginContext<TContext["config"]> & TContext) => MaybePromise<void>;
+  /**
+   * 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: (this: BuildPluginContext<TContext["config"]> & TContext, code: string, id: string) => MaybePromise<TransformResult>;
+  /**
+   * 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: (this: BuildPluginContext<TContext["config"]> & TContext, id: string) => MaybePromise<LoadResult>;
+  /**
+   * 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: (this: BuildPluginContext<TContext["config"]> & TContext, id: string, importer: string | undefined, options: {
+    isEntry: boolean;
+  }) => MaybePromise<string | ExternalIdResult | null | undefined>;
+  /**
+   * A hook that is called to write the bundle to disk.
+   *
+   * @param this - The build context.
+   * @returns A promise that resolves when the hook is complete.
+   */
+  writeBundle: (this: TContext) => MaybePromise<void>;
+};
+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$1<T> = { [K in keyof T]?: DeepPartial$1<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.
+   */
+  name: string;
+  /**
+   * An API object that can be used for inter-plugin communication.
+   *
+   * @see https://rollupjs.org/plugin-development/#direct-plugin-communication
+   */
+  api?: Record<string, any>;
+  /**
+   * Enforce plugin invocation tier similar to webpack loaders. Hooks ordering is still subject to the `order` property in the hook object.
+   *
+   * @remarks
+   * The Plugin invocation order is as follows:
+   * - `enforce: 'pre'` plugins
+   * - `order: 'pre'` plugin hooks
+   * - any other plugins (normal)
+   * - `order: 'post'` plugin hooks
+   * - `enforce: 'post'` plugins
+   *
+   * @see https://vitejs.dev/guide/api-plugin.html#plugin-ordering
+   * @see https://rollupjs.org/plugin-development/#build-hooks
+   * @see https://webpack.js.org/concepts/loaders/#enforce---pre-and-post
+   * @see https://esbuild.github.io/plugins/#concepts
+   */
+  enforce?: "pre" | "post";
+  /**
+   * A function to determine if two plugins are the same and can be de-duplicated.
+   *
+   * @remarks
+   * If this is not provided, plugins are de-duplicated by comparing their names.
+   *
+   * @param other - The other plugin to compare against.
+   * @returns `true` if the two plugins are the same, `false` otherwise.
+   */
+  dedupe?: false | ((other: Plugin<any>) => boolean);
+  /**
+   * A list of pre-requisite plugins that must be loaded before this plugin can be used.
+   */
+  /**
+   * Define environments where this plugin should be active. By default, the plugin is active in all environments.
+   *
+   * @param environment - The environment to check.
+   * @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$1<TContext["config"]> & Record<string, any>>> | (DeepPartial$1<TContext["config"]> & Record<string, any>);
+} & { [TBuilderVariant in BuilderVariant]?: InferUnpluginOptions<TContext, TBuilderVariant> };
+declare const PLUGIN_NON_HOOK_FIELDS: readonly ["name", "api", "enforce", "dedupe", "applyToEnvironment"];
+type PluginNonHookFields = ArrayValues<typeof PLUGIN_NON_HOOK_FIELDS> | UnpluginBuilderVariant;
+declare const PLUGIN_HOOKS_FIELDS: readonly ["new", "clean", "prepare", "lint", "test", "build", "docs", "deploy", "finalize", "config", "configEnvironment", "configResolved", "types", "buildStart", "buildEnd", "transform", "load", "resolveId", "writeBundle"];
+type PluginHookFields<TContext extends PluginContext = PluginContext> = keyof PluginHookFunctions<TContext>;
+declare const KNOWN_PLUGIN_FIELDS: readonly ["name", "api", "enforce", "dedupe", "applyToEnvironment", "new", "clean", "prepare", "lint", "test", "build", "docs", "deploy", "finalize", "config", "configEnvironment", "configResolved", "types", "buildStart", "buildEnd", "transform", "load", "resolveId", "writeBundle", ...BuilderVariant[]];
+type PluginFields = ArrayValues<typeof KNOWN_PLUGIN_FIELDS>;
+declare type __ΩPluginHookObject = any[];
+declare type __ΩPluginHook = any[];
+declare type __ΩTypesResult = any[];
+declare type __ΩPluginHookFunctions = any[];
+declare type __ΩPluginHooks = any[];
+declare type __ΩPlugin = any[];
+declare type __ΩPluginNonHookFields = any[];
+declare type __ΩPluginHookFields = any[];
+declare type __ΩPluginFields = any[];
+//#endregion
+export { KNOWN_PLUGIN_FIELDS, PLUGIN_HOOKS_FIELDS, PLUGIN_NON_HOOK_FIELDS, Plugin, PluginFields, PluginHook, PluginHookFields, PluginHookFunctions, PluginHookObject, PluginHooks, PluginNonHookFields, TypesResult, __ΩPlugin, __ΩPluginFields, __ΩPluginHook, __ΩPluginHookFields, __ΩPluginHookFunctions, __ΩPluginHookObject, __ΩPluginHooks, __ΩPluginNonHookFields, __ΩTypesResult };
+//# sourceMappingURL=plugin.d.cts.map

package/dist/types/plugin.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.cts","names":[],"sources":["../../src/types/plugin.ts"],"sourcesContent":[],"mappings":"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"}

package/dist/types/plugin.d.mts

@@ -0,0 +1,218 @@
+import { CommandType } from "./commands.mjs";
+import { BuilderVariant, InferUnpluginOptions, UnpluginBuilderVariant } from "./unplugin.mjs";
+import { BuildPluginContext, PluginContext, UnresolvedContext } from "./context.mjs";
+import { EnvironmentConfig, EnvironmentResolvedConfig, PluginConfig, ResolvedConfig } from "./config.mjs";
+import { ExternalIdResult, HookFilter, TransformResult } from "unplugin";
+import { AnyFunction, MaybePromise } from "@stryke/types/base";
+import { ArrayValues } from "@stryke/types/array";
+import { LoadResult } from "rollup";
+
+//#region src/types/plugin.d.ts
+interface PluginHookObject<THookFunction extends AnyFunction, TFilter extends keyof HookFilter = never> {
+  /**
+   * The order in which the plugin should be applied.
+   */
+  order?: "pre" | "post" | null | undefined;
+  /**
+   * A filter to determine when the hook should be called.
+   */
+  filter?: Pick<HookFilter, TFilter>;
+  /**
+   * The hook function to be called.
+   */
+  handler: THookFunction;
+}
+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.
+ */
+interface TypesResult {
+  directives?: string[];
+  code: string;
+}
+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.
+   *
+   * @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.
+   *
+   * @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: (this: UnresolvedContext<TContext["config"]>) => MaybePromise<DeepPartial$1<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.
+   *
+   * @remarks
+   * This hook is called for each environment with a partially resolved environment config that already accounts for the default environment config values set at the root level. If plugins need to modify the config of a given environment, they should do it in this hook instead of the config hook. Leaving the config hook only for modifying the root default environment config.
+   *
+   * @see https://vitejs.dev/guide/api-plugin#configenvironment
+   *
+   * @param this - The build context.
+   * @param name - The name of the environment being configured.
+   * @param environment - The Vite-like environment object containing information about the current build environment.
+   * @returns A promise that resolves when the hook is complete.
+   */
+  configEnvironment: (this: TContext, name: string, environment: EnvironmentConfig) => MaybePromise<Partial<EnvironmentResolvedConfig> | undefined | null>;
+  /**
+   * A hook that is called when the plugin is resolved.
+   *
+   * @see https://vitejs.dev/guide/api-plugin#configresolved
+   *
+   * @param this - The build context.
+   * @returns A promise that resolves when the hook is complete.
+   */
+  configResolved: (this: TContext) => MaybePromise<void>;
+  /**
+   * A hook that is called to overwrite the generated declaration types file (.d.ts). The generated type definitions should describe the built-in modules/logic added during the `prepare` task.
+   *
+   * @param this - The build context.
+   * @param code - The source code to generate types for.
+   * @returns A promise that resolves when the hook is complete.
+   */
+  types: (this: TContext, code: string) => MaybePromise<TypesResult | string | undefined | null>;
+  /**
+   * A hook that is called at the start of the build process.
+   *
+   * @param this - The build context and unplugin build context.
+   * @returns A promise that resolves when the hook is complete.
+   */
+  buildStart: (this: BuildPluginContext<TContext["config"]> & TContext) => MaybePromise<void>;
+  /**
+   * A hook that is called at the end of the build process.
+   *
+   * @param this - The build context and unplugin build context.
+   * @returns A promise that resolves when the hook is complete.
+   */
+  buildEnd: (this: BuildPluginContext<TContext["config"]> & TContext) => MaybePromise<void>;
+  /**
+   * 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: (this: BuildPluginContext<TContext["config"]> & TContext, code: string, id: string) => MaybePromise<TransformResult>;
+  /**
+   * 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: (this: BuildPluginContext<TContext["config"]> & TContext, id: string) => MaybePromise<LoadResult>;
+  /**
+   * 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: (this: BuildPluginContext<TContext["config"]> & TContext, id: string, importer: string | undefined, options: {
+    isEntry: boolean;
+  }) => MaybePromise<string | ExternalIdResult | null | undefined>;
+  /**
+   * A hook that is called to write the bundle to disk.
+   *
+   * @param this - The build context.
+   * @returns A promise that resolves when the hook is complete.
+   */
+  writeBundle: (this: TContext) => MaybePromise<void>;
+};
+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$1<T> = { [K in keyof T]?: DeepPartial$1<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.
+   */
+  name: string;
+  /**
+   * An API object that can be used for inter-plugin communication.
+   *
+   * @see https://rollupjs.org/plugin-development/#direct-plugin-communication
+   */
+  api?: Record<string, any>;
+  /**
+   * Enforce plugin invocation tier similar to webpack loaders. Hooks ordering is still subject to the `order` property in the hook object.
+   *
+   * @remarks
+   * The Plugin invocation order is as follows:
+   * - `enforce: 'pre'` plugins
+   * - `order: 'pre'` plugin hooks
+   * - any other plugins (normal)
+   * - `order: 'post'` plugin hooks
+   * - `enforce: 'post'` plugins
+   *
+   * @see https://vitejs.dev/guide/api-plugin.html#plugin-ordering
+   * @see https://rollupjs.org/plugin-development/#build-hooks
+   * @see https://webpack.js.org/concepts/loaders/#enforce---pre-and-post
+   * @see https://esbuild.github.io/plugins/#concepts
+   */
+  enforce?: "pre" | "post";
+  /**
+   * A function to determine if two plugins are the same and can be de-duplicated.
+   *
+   * @remarks
+   * If this is not provided, plugins are de-duplicated by comparing their names.
+   *
+   * @param other - The other plugin to compare against.
+   * @returns `true` if the two plugins are the same, `false` otherwise.
+   */
+  dedupe?: false | ((other: Plugin<any>) => boolean);
+  /**
+   * A list of pre-requisite plugins that must be loaded before this plugin can be used.
+   */
+  /**
+   * Define environments where this plugin should be active. By default, the plugin is active in all environments.
+   *
+   * @param environment - The environment to check.
+   * @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$1<TContext["config"]> & Record<string, any>>> | (DeepPartial$1<TContext["config"]> & Record<string, any>);
+} & { [TBuilderVariant in BuilderVariant]?: InferUnpluginOptions<TContext, TBuilderVariant> };
+declare const PLUGIN_NON_HOOK_FIELDS: readonly ["name", "api", "enforce", "dedupe", "applyToEnvironment"];
+type PluginNonHookFields = ArrayValues<typeof PLUGIN_NON_HOOK_FIELDS> | UnpluginBuilderVariant;
+declare const PLUGIN_HOOKS_FIELDS: readonly ["new", "clean", "prepare", "lint", "test", "build", "docs", "deploy", "finalize", "config", "configEnvironment", "configResolved", "types", "buildStart", "buildEnd", "transform", "load", "resolveId", "writeBundle"];
+type PluginHookFields<TContext extends PluginContext = PluginContext> = keyof PluginHookFunctions<TContext>;
+declare const KNOWN_PLUGIN_FIELDS: readonly ["name", "api", "enforce", "dedupe", "applyToEnvironment", "new", "clean", "prepare", "lint", "test", "build", "docs", "deploy", "finalize", "config", "configEnvironment", "configResolved", "types", "buildStart", "buildEnd", "transform", "load", "resolveId", "writeBundle", ...BuilderVariant[]];
+type PluginFields = ArrayValues<typeof KNOWN_PLUGIN_FIELDS>;
+declare type __ΩPluginHookObject = any[];
+declare type __ΩPluginHook = any[];
+declare type __ΩTypesResult = any[];
+declare type __ΩPluginHookFunctions = any[];
+declare type __ΩPluginHooks = any[];
+declare type __ΩPlugin = any[];
+declare type __ΩPluginNonHookFields = any[];
+declare type __ΩPluginHookFields = any[];
+declare type __ΩPluginFields = any[];
+//#endregion
+export { KNOWN_PLUGIN_FIELDS, PLUGIN_HOOKS_FIELDS, PLUGIN_NON_HOOK_FIELDS, Plugin, PluginFields, PluginHook, PluginHookFields, PluginHookFunctions, PluginHookObject, PluginHooks, PluginNonHookFields, TypesResult, __ΩPlugin, __ΩPluginFields, __ΩPluginHook, __ΩPluginHookFields, __ΩPluginHookFunctions, __ΩPluginHookObject, __ΩPluginHooks, __ΩPluginNonHookFields, __ΩTypesResult };
+//# sourceMappingURL=plugin.d.mts.map

package/dist/types/plugin.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.mts","names":[],"sources":["../../src/types/plugin.ts"],"sourcesContent":[],"mappings":"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"}

package/dist/types/plugin.mjs

@@ -0,0 +1,33 @@
+import { BUILDER_VARIANTS } from "./unplugin.mjs";
+import { SUPPORTED_COMMANDS } from "./commands.mjs";
+
+//#region src/types/plugin.ts
+const PLUGIN_NON_HOOK_FIELDS = [
+	"name",
+	"api",
+	"enforce",
+	"dedupe",
+	"applyToEnvironment"
+];
+const PLUGIN_HOOKS_FIELDS = [
+	...SUPPORTED_COMMANDS,
+	"config",
+	"configEnvironment",
+	"configResolved",
+	"types",
+	"buildStart",
+	"buildEnd",
+	"transform",
+	"load",
+	"resolveId",
+	"writeBundle"
+];
+const KNOWN_PLUGIN_FIELDS = [
+	...PLUGIN_NON_HOOK_FIELDS,
+	...PLUGIN_HOOKS_FIELDS,
+	...BUILDER_VARIANTS
+];
+
+//#endregion
+export { KNOWN_PLUGIN_FIELDS, PLUGIN_HOOKS_FIELDS, PLUGIN_NON_HOOK_FIELDS };
+//# sourceMappingURL=plugin.mjs.map

package/dist/types/plugin.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.mjs","names":[],"sources":["../../src/types/plugin.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                   ⚡ Storm Software - Powerlines\n\n This code was released as part of the Powerlines project. Powerlines\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/powerlines.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/powerlines\n Documentation:            https://docs.stormsoftware.com/projects/powerlines\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport type { ArrayValues } from \"@stryke/types/array\";\nimport type { AnyFunction, MaybePromise } from \"@stryke/types/base\";\nimport { LoadResult } from \"rollup\";\nimport type { ExternalIdResult, HookFilter, TransformResult } from \"unplugin\";\nimport type { CommandType } from \"./commands\";\nimport { SUPPORTED_COMMANDS } from \"./commands\";\nimport type {\n  EnvironmentConfig,\n  EnvironmentResolvedConfig,\n  PluginConfig,\n  ResolvedConfig\n} from \"./config\";\nimport type {\n  BuildPluginContext,\n  PluginContext,\n  UnresolvedContext\n} from \"./context\";\nimport type { BuilderVariant, UnpluginBuilderVariant } from \"./unplugin\";\nimport { BUILDER_VARIANTS, InferUnpluginOptions } from \"./unplugin\";\n\nexport interface PluginHookObject<\n  THookFunction extends AnyFunction,\n  TFilter extends keyof HookFilter = never\n> {\n  /**\n   * The order in which the plugin should be applied.\n   */\n  order?: \"pre\" | \"post\" | null | undefined;\n\n  /**\n   * A filter to determine when the hook should be called.\n   */\n  filter?: Pick<HookFilter, TFilter>;\n\n  /**\n   * The hook function to be called.\n   */\n  handler: THookFunction;\n}\n\nexport type PluginHook<\n  THookFunction extends AnyFunction,\n  TFilter extends keyof HookFilter = never\n> = THookFunction | PluginHookObject<THookFunction, TFilter>;\n\n/**\n * A result returned by the plugin from the `types` hook that describes the declaration types output file.\n */\nexport interface TypesResult {\n  directives?: string[];\n  code: string;\n}\n\nexport type PluginHookFunctions<TContext extends PluginContext> = {\n  [TCommandType in CommandType]: (this: TContext) => MaybePromise<void>;\n} & {\n  /**\n   * A function that returns configuration options to be merged with the build context's options.\n   *\n   * @remarks\n   * 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.\n   *\n   * @warning User plugins are resolved before running this hook so injecting other plugins inside the config hook will have no effect.\n   *\n   * @see https://vitejs.dev/guide/api-plugin#config\n   *\n   * @param this - The build context.\n   * @param config - The partial configuration object to be modified.\n   * @returns A promise that resolves to a partial configuration object.\n   */\n  config: (\n    this: UnresolvedContext<TContext[\"config\"]>\n  ) => MaybePromise<DeepPartial<TContext[\"config\"]> & Record<string, any>>;\n\n  /**\n   * 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.\n   *\n   * @remarks\n   * This hook is called for each environment with a partially resolved environment config that already accounts for the default environment config values set at the root level. If plugins need to modify the config of a given environment, they should do it in this hook instead of the config hook. Leaving the config hook only for modifying the root default environment config.\n   *\n   * @see https://vitejs.dev/guide/api-plugin#configenvironment\n   *\n   * @param this - The build context.\n   * @param name - The name of the environment being configured.\n   * @param environment - The Vite-like environment object containing information about the current build environment.\n   * @returns A promise that resolves when the hook is complete.\n   */\n  configEnvironment: (\n    this: TContext,\n    name: string,\n    environment: EnvironmentConfig\n  ) => MaybePromise<Partial<EnvironmentResolvedConfig> | undefined | null>;\n\n  /**\n   * A hook that is called when the plugin is resolved.\n   *\n   * @see https://vitejs.dev/guide/api-plugin#configresolved\n   *\n   * @param this - The build context.\n   * @returns A promise that resolves when the hook is complete.\n   */\n  configResolved: (this: TContext) => MaybePromise<void>;\n\n  /**\n   * A hook that is called to overwrite the generated declaration types file (.d.ts). The generated type definitions should describe the built-in modules/logic added during the `prepare` task.\n   *\n   * @param this - The build context.\n   * @param code - The source code to generate types for.\n   * @returns A promise that resolves when the hook is complete.\n   */\n  types: (\n    this: TContext,\n    code: string\n  ) => MaybePromise<TypesResult | string | undefined | null>;\n\n  /**\n   * A hook that is called at the start of the build process.\n   *\n   * @param this - The build context and unplugin build context.\n   * @returns A promise that resolves when the hook is complete.\n   */\n  buildStart: (\n    this: BuildPluginContext<TContext[\"config\"]> & TContext\n  ) => MaybePromise<void>;\n\n  /**\n   * A hook that is called at the end of the build process.\n   *\n   * @param this - The build context and unplugin build context.\n   * @returns A promise that resolves when the hook is complete.\n   */\n  buildEnd: (\n    this: BuildPluginContext<TContext[\"config\"]> & TContext\n  ) => MaybePromise<void>;\n\n  /**\n   * A hook that is called to transform the source code.\n   *\n   * @param this - The build context, unplugin build context, and unplugin context.\n   * @param code - The source code to transform.\n   * @param id - The identifier of the source code.\n   * @returns A promise that resolves when the hook is complete.\n   */\n  transform: (\n    this: BuildPluginContext<TContext[\"config\"]> & TContext,\n    code: string,\n    id: string\n  ) => MaybePromise<TransformResult>;\n\n  /**\n   * A hook that is called to load the source code.\n   *\n   * @param this - The build context, unplugin build context, and unplugin context.\n   * @param id - The identifier of the source code.\n   * @returns A promise that resolves when the hook is complete.\n   */\n  load: (\n    this: BuildPluginContext<TContext[\"config\"]> & TContext,\n    id: string\n  ) => MaybePromise<LoadResult>;\n\n  /**\n   * A hook that is called to resolve the identifier of the source code.\n   *\n   * @param this - The build context, unplugin build context, and unplugin context.\n   * @param id - The identifier of the source code.\n   * @param importer - The importer of the source code.\n   * @param options - The options for resolving the identifier.\n   * @returns A promise that resolves when the hook is complete.\n   */\n  resolveId: (\n    this: BuildPluginContext<TContext[\"config\"]> & TContext,\n    id: string,\n    importer: string | undefined,\n    options: { isEntry: boolean }\n  ) => MaybePromise<string | ExternalIdResult | null | undefined>;\n\n  /**\n   * A hook that is called to write the bundle to disk.\n   *\n   * @param this - The build context.\n   * @returns A promise that resolves when the hook is complete.\n   */\n  writeBundle: (this: TContext) => MaybePromise<void>;\n};\n\nexport type PluginHooks<TContext extends PluginContext> = {\n  [TPluginHook in keyof PluginHookFunctions<TContext>]?: PluginHook<\n    PluginHookFunctions<TContext>[TPluginHook]\n  >;\n} & {\n  transform: PluginHook<\n    PluginHookFunctions<TContext>[\"transform\"],\n    \"code\" | \"id\"\n  >;\n  load: PluginHook<PluginHookFunctions<TContext>[\"load\"], \"id\">;\n  resolveId: PluginHook<PluginHookFunctions<TContext>[\"resolveId\"], \"id\">;\n};\n\ntype DeepPartial<T> = {\n  [K in keyof T]?: DeepPartial<T[K]>;\n};\n\nexport type Plugin<\n  TContext extends PluginContext<ResolvedConfig> = PluginContext<ResolvedConfig>\n> = Partial<PluginHooks<TContext>> & {\n  /**\n   * The name of the plugin, for use in deduplication, error messages and logs.\n   */\n  name: string;\n\n  /**\n   * An API object that can be used for inter-plugin communication.\n   *\n   * @see https://rollupjs.org/plugin-development/#direct-plugin-communication\n   */\n  api?: Record<string, any>;\n\n  /**\n   * Enforce plugin invocation tier similar to webpack loaders. Hooks ordering is still subject to the `order` property in the hook object.\n   *\n   * @remarks\n   * The Plugin invocation order is as follows:\n   * - `enforce: 'pre'` plugins\n   * - `order: 'pre'` plugin hooks\n   * - any other plugins (normal)\n   * - `order: 'post'` plugin hooks\n   * - `enforce: 'post'` plugins\n   *\n   * @see https://vitejs.dev/guide/api-plugin.html#plugin-ordering\n   * @see https://rollupjs.org/plugin-development/#build-hooks\n   * @see https://webpack.js.org/concepts/loaders/#enforce---pre-and-post\n   * @see https://esbuild.github.io/plugins/#concepts\n   */\n  enforce?: \"pre\" | \"post\";\n\n  /**\n   * A function to determine if two plugins are the same and can be de-duplicated.\n   *\n   * @remarks\n   * If this is not provided, plugins are de-duplicated by comparing their names.\n   *\n   * @param other - The other plugin to compare against.\n   * @returns `true` if the two plugins are the same, `false` otherwise.\n   */\n  dedupe?: false | ((other: Plugin<any>) => boolean);\n\n  /**\n   * A list of pre-requisite plugins that must be loaded before this plugin can be used.\n   */\n  // dependsOn?: PluginConfig<TContext>[];\n\n  /**\n   * Define environments where this plugin should be active. By default, the plugin is active in all environments.\n   *\n   * @param environment - The environment to check.\n   * @returns `true` if the plugin should be active in the specified environment, `false` otherwise.\n   */\n  applyToEnvironment?: (\n    environment: EnvironmentResolvedConfig\n  ) => boolean | PluginConfig<TContext>;\n\n  /**\n   * A function that returns configuration options to be merged with the build context's options.\n   *\n   * @remarks\n   * 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.\n   *\n   * @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.\n   *\n   * @see https://vitejs.dev/guide/api-plugin#config\n   *\n   * @param this - The build context.\n   * @param config - The partial configuration object to be modified.\n   * @returns A promise that resolves to a partial configuration object.\n   */\n  config?:\n    | PluginHook<\n        (\n          this: UnresolvedContext<TContext[\"config\"]>\n        ) => MaybePromise<DeepPartial<TContext[\"config\"]> & Record<string, any>>\n      >\n    | (DeepPartial<TContext[\"config\"]> & Record<string, any>);\n} & {\n  [TBuilderVariant in BuilderVariant]?: InferUnpluginOptions<\n    TContext,\n    TBuilderVariant\n  >;\n};\n\nexport const PLUGIN_NON_HOOK_FIELDS = [\n  \"name\",\n  \"api\",\n  \"enforce\",\n  \"dedupe\",\n  \"applyToEnvironment\"\n] as const;\n\nexport type PluginNonHookFields =\n  | ArrayValues<typeof PLUGIN_NON_HOOK_FIELDS>\n  | UnpluginBuilderVariant;\n\nexport const PLUGIN_HOOKS_FIELDS = [\n  ...SUPPORTED_COMMANDS,\n  \"config\",\n  \"configEnvironment\",\n  \"configResolved\",\n  \"types\",\n  \"buildStart\",\n  \"buildEnd\",\n  \"transform\",\n  \"load\",\n  \"resolveId\",\n  \"writeBundle\"\n] as const;\n\nexport type PluginHookFields<TContext extends PluginContext = PluginContext> =\n  keyof PluginHookFunctions<TContext>;\n\nexport const KNOWN_PLUGIN_FIELDS = [\n  ...PLUGIN_NON_HOOK_FIELDS,\n  ...PLUGIN_HOOKS_FIELDS,\n  ...BUILDER_VARIANTS\n] as const;\n\nexport type PluginFields = ArrayValues<typeof KNOWN_PLUGIN_FIELDS>;\n"],"mappings":";;;;AAoTA,MAAa,yBAAyB;CACpC;CACA;CACA;CACA;CACA;CACD;AAMD,MAAa,sBAAsB;CACjC,GAAG;CACH;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACD;AAKD,MAAa,sBAAsB;CACjC,GAAG;CACH,GAAG;CACH,GAAG;CACJ"}

package/dist/types/tsconfig.d.cts

@@ -0,0 +1,77 @@
+import { CompilerOptions, TsConfigJson } from "@stryke/types/tsconfig";
+import ts from "typescript";
+
+//#region src/types/tsconfig.d.ts
+type ReflectionMode = "default" | "explicit" | "never";
+type RawReflectionMode = ReflectionMode | "" | boolean | string | string[] | undefined;
+/**
+ * Defines the level of reflection to be used during the transpilation process.
+ *
+ * @remarks
+ * The level determines how much extra data is captured in the byte code for each type. This can be one of the following values:
+ * - `minimal` - Only the essential type information is captured.
+ * - `normal` - Additional type information is captured, including some contextual data.
+ * - `verbose` - All available type information is captured, including detailed contextual data.
+ */
+type ReflectionLevel = "minimal" | "normal" | "verbose";
+interface DeepkitOptions {
+  /**
+   * Either true to activate reflection for all files compiled using this tsconfig,
+   * or a list of globs/file paths relative to this tsconfig.json.
+   * Globs/file paths can be prefixed with a ! to exclude them.
+   */
+  reflection?: RawReflectionMode;
+  /**
+   * Defines the level of reflection to be used during the transpilation process.
+   *
+   * @remarks
+   * The level determines how much extra data is captured in the byte code for each type. This can be one of the following values:
+   * - `minimal` - Only the essential type information is captured.
+   * - `normal` - Additional type information is captured, including some contextual data.
+   * - `verbose` - All available type information is captured, including detailed contextual data.
+   */
+  reflectionLevel?: ReflectionLevel;
+}
+type TSCompilerOptions = CompilerOptions & DeepkitOptions;
+/**
+ * The TypeScript compiler configuration.
+ *
+ * @see https://www.typescriptlang.org/docs/handbook/tsconfig-json.html
+ */
+interface TSConfig extends Omit<TsConfigJson, "reflection"> {
+  /**
+   * Either true to activate reflection for all files compiled using this tsconfig,
+   * or a list of globs/file paths relative to this tsconfig.json.
+   * Globs/file paths can be prefixed with a ! to exclude them.
+   */
+  reflection?: RawReflectionMode;
+  /**
+   * Defines the level of reflection to be used during the transpilation process.
+   *
+   * @remarks
+   * The level determines how much extra data is captured in the byte code for each type. This can be one of the following values:
+   * - `minimal` - Only the essential type information is captured.
+   * - `normal` - Additional type information is captured, including some contextual data.
+   * - `verbose` - All available type information is captured, including detailed contextual data.
+   */
+  reflectionLevel?: ReflectionLevel;
+  /**
+   * Instructs the TypeScript compiler how to compile `.ts` files.
+   */
+  compilerOptions?: TSCompilerOptions;
+}
+type ParsedTypeScriptConfig = ts.ParsedCommandLine & {
+  originalTsconfigJson: TsConfigJson;
+  tsconfigJson: TSConfig;
+  tsconfigFilePath: string;
+};
+declare type __ΩReflectionMode = any[];
+declare type __ΩRawReflectionMode = any[];
+declare type __ΩReflectionLevel = any[];
+declare type __ΩDeepkitOptions = any[];
+declare type __ΩTSCompilerOptions = any[];
+declare type __ΩTSConfig = any[];
+declare type __ΩParsedTypeScriptConfig = any[];
+//#endregion
+export { DeepkitOptions, ParsedTypeScriptConfig, RawReflectionMode, ReflectionLevel, ReflectionMode, TSCompilerOptions, TSConfig, __ΩDeepkitOptions, __ΩParsedTypeScriptConfig, __ΩRawReflectionMode, __ΩReflectionLevel, __ΩReflectionMode, __ΩTSCompilerOptions, __ΩTSConfig };
+//# sourceMappingURL=tsconfig.d.cts.map

package/dist/types/tsconfig.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tsconfig.d.cts","names":[],"sources":["../../src/types/tsconfig.ts"],"sourcesContent":[],"mappings":";;;;KAqBY,cAAA;KACA,iBAAA,GACR;AAFJ;AACA;AAiBA;AAEA;AAoBA;AAOA;;;;AAsBoB,KAnDR,eAAA,GAmDQ,SAAA,GAAA,QAAA,GAAA,SAAA;AAtBc,UA3BjB,cAAA,CA2BiB;EAAI;AAyBtC;;;;EAEwB,UAAA,CAAA,EAhDT,iBAgDS;;;;;;;;;;oBArCJ;;KAGR,iBAAA,GAAoB,kBAAkB;;;;;;UAOjC,QAAA,SAAiB,KAAK;;;;;;eAMxB;;;;;;;;;;oBAWK;;;;oBAKA;;KAGR,sBAAA,GAAyB,EAAA,CAAG;wBAChB;gBACR"}