@powerlines/plugin-webpack 0.5.239 → 0.5.241

package/dist/powerlines/src/plugin-utils/helpers.cjs

@@ -0,0 +1,167 @@
+const require_rolldown_runtime = require('../../../_virtual/rolldown_runtime.cjs');
+const require_build = require('../types/build.cjs');
+const require_plugin = require('../types/plugin.cjs');
+let __stryke_type_checks_is_function = require("@stryke/type-checks/is-function");
+let __stryke_type_checks_is_set_object = require("@stryke/type-checks/is-set-object");
+let __stryke_type_checks_is_set_string = require("@stryke/type-checks/is-set-string");
+let __stryke_type_checks_is_undefined = require("@stryke/type-checks/is-undefined");
+
+//#region ../powerlines/src/plugin-utils/helpers.ts
+/**
+* Type guard to check if an object is a {@link Plugin}
+*
+* @param value - The object to check
+* @returns True if the object is a {@link Plugin}, false otherwise
+*/
+function isPlugin(value) {
+	return (0, __stryke_type_checks_is_set_object.isSetObject)(value) && "name" in value && (0, __stryke_type_checks_is_set_string.isSetString)(value.name) && ((0, __stryke_type_checks_is_undefined.isUndefined)(value.api) || "api" in value && (0, __stryke_type_checks_is_set_object.isSetObject)(value.api)) && ((0, __stryke_type_checks_is_undefined.isUndefined)(value.applyToEnvironment) || "applyToEnvironment" in value && (0, __stryke_type_checks_is_function.isFunction)(value.applyToEnvironment)) && ((0, __stryke_type_checks_is_undefined.isUndefined)(value.dedupe) || "dedupe" in value && (0, __stryke_type_checks_is_function.isFunction)(value.dedupe)) && require_plugin.PLUGIN_HOOKS_FIELDS.every((hook) => (0, __stryke_type_checks_is_undefined.isUndefined)(value[hook]) || hook in value && (isPluginHookFunction(value[hook]) || hook === "config" && (0, __stryke_type_checks_is_set_object.isSetObject)(value[hook]))) && require_build.BUILDER_VARIANTS.every((variant) => (0, __stryke_type_checks_is_undefined.isUndefined)(value[variant]) || variant in value && (0, __stryke_type_checks_is_set_object.isSetObject)(value[variant]));
+}
+/**
+* Type guard to check if an object is a {@link PluginConfigObject}
+*
+* @param value - The object to check
+* @returns True if the object is a {@link PluginConfigObject}, false otherwise
+*/
+function isPluginConfigObject(value) {
+	return (0, __stryke_type_checks_is_set_object.isSetObject)(value) && "plugin" in value && (((0, __stryke_type_checks_is_set_string.isSetString)(value.plugin) || (0, __stryke_type_checks_is_function.isFunction)(value.plugin)) && "options" in value && (0, __stryke_type_checks_is_set_object.isSetObject)(value.options) || isPlugin(value.plugin));
+}
+/**
+* Type guard to check if an object is a {@link PluginConfigTuple}
+*
+* @param value - The object to check
+* @returns True if the object is a {@link PluginConfigTuple}, false otherwise
+*/
+function isPluginConfigTuple(value) {
+	return Array.isArray(value) && (value.length === 1 || value.length === 2) && (((0, __stryke_type_checks_is_set_string.isSetString)(value[0]) || (0, __stryke_type_checks_is_function.isFunction)(value[0])) && value.length > 1 && (0, __stryke_type_checks_is_set_object.isSetObject)(value[1]) || isPlugin(value[0]));
+}
+/**
+* Type guard to check if an object is a {@link PluginConfig}
+*
+* @param value - The object to check
+* @returns True if the object is a {@link PluginConfig}, false otherwise
+*/
+function isPluginConfig(value) {
+	return (0, __stryke_type_checks_is_set_string.isSetString)(value) || (0, __stryke_type_checks_is_function.isFunction)(value) || isPlugin(value) || isPluginConfigObject(value) || isPluginConfigTuple(value) || Array.isArray(value) && value.every((item) => isPluginConfig(item));
+}
+/**
+* Type guard to check if an value is a {@link PluginHook} function
+*
+* @param value - The value to check
+* @returns True if the value is a {@link PluginHook} function, false otherwise
+*/
+function isPluginHookObject(value) {
+	return (0, __stryke_type_checks_is_set_object.isSetObject)(value) && "handler" in value && (0, __stryke_type_checks_is_function.isFunction)(value.handler);
+}
+/**
+* Type guard to check if an value is a {@link PluginHook} function
+*
+* @param value - The value to check
+* @returns True if the value is a {@link PluginHook} function, false otherwise
+*/
+function isPluginHookFunction(value) {
+	return (0, __stryke_type_checks_is_function.isFunction)(value) || isPluginHookObject(value);
+}
+/**
+* Type guard to check if an object is a {@link PluginHook}
+*
+* @param value - The object to check
+* @returns True if the object is a {@link PluginHook}, false otherwise
+*/
+function isPluginHook(value) {
+	return isPluginHookFunction(value) || isPluginHookObject(value);
+}
+/**
+* Extract the hook handler function from a plugin hook
+*
+* @param pluginHook - The plugin hook to extract the handler function from
+* @returns The hook handler function
+*/
+function getHookHandler(pluginHook) {
+	return (0, __stryke_type_checks_is_function.isFunction)(pluginHook) ? pluginHook : pluginHook.handler;
+}
+/**
+* Check if a hook is external.
+*
+* @param keys - The name of the hook to check.
+* @returns True if the hook is external, false otherwise.
+*/
+function isUnpluginHookKey(keys) {
+	return require_build.UNPLUGIN_BUILDER_VARIANTS.some((variant) => keys.startsWith(`${variant}:`));
+}
+/**
+* Check if a hook is internal.
+*
+* @param keys - The name of the hook to check.
+* @returns True if the hook is external, false otherwise.
+*/
+function isPluginHookField(keys) {
+	return !isUnpluginHookKey(keys) && require_plugin.PLUGIN_HOOKS_FIELDS.includes(keys);
+}
+/**
+* Check if a hook is external.
+*
+* @param field - The name of the hook to check.
+* @returns True if the hook is external, false otherwise.
+*/
+function isUnpluginHookField(field) {
+	return !isPluginHookField(field) && require_build.UNPLUGIN_BUILDER_VARIANTS.includes(field);
+}
+/**
+* Check if a plugin should be deduplicated.
+*
+* @param plugin - The plugin to check
+* @param plugins - The list of plugins to check against
+* @returns True if the plugin should be deduplicated, false otherwise
+*/
+function checkDedupe(plugin, plugins) {
+	return plugin.dedupe === false || plugins.some((p) => p.dedupe !== false && ((0, __stryke_type_checks_is_function.isFunction)(p.dedupe) && p.dedupe(plugin) || p.name === plugin.name));
+}
+/**
+* Add a plugin hook to the hooks list.
+*
+* @param context - The plugin context
+* @param plugin - The plugin to add the hook from
+* @param pluginHook - The plugin hook to add
+* @param hooksList - The list of hooks to add to
+*/
+function addPluginHook(context, plugin, pluginHook, hooksList) {
+	if (!checkDedupe(plugin, hooksList.map((hook) => hook.plugin).filter(Boolean))) {
+		const handler = ((...args) => getHookHandler(pluginHook).apply(context, args));
+		if (!handler) return;
+		hooksList.push({
+			plugin,
+			handler
+		});
+	}
+}
+/**
+* Check the provided {@link PluginConfig}, and return a stringified version of the invalid configuration. If an array is provided, check each item in the array.
+*
+* @param config - The plugin configuration to check
+* @returns Null if the configuration is valid, otherwise an array of stringified invalid configurations
+*/
+function findInvalidPluginConfig(config) {
+	if (isPluginConfig(config)) return null;
+	if (Array.isArray(config)) {
+		const invalidItems = [];
+		config.forEach((item) => {
+			const invalid = findInvalidPluginConfig(item);
+			if (invalid) invalidItems.push(...invalid.map((i) => JSON.stringify(i, null, 2)));
+		});
+		return invalidItems.length > 0 ? invalidItems : null;
+	}
+	return [JSON.stringify(config, null, 2)];
+}
+
+//#endregion
+exports.addPluginHook = addPluginHook;
+exports.checkDedupe = checkDedupe;
+exports.findInvalidPluginConfig = findInvalidPluginConfig;
+exports.isPlugin = isPlugin;
+exports.isPluginConfig = isPluginConfig;
+exports.isPluginConfigObject = isPluginConfigObject;
+exports.isPluginConfigTuple = isPluginConfigTuple;
+exports.isPluginHook = isPluginHook;
+exports.isPluginHookField = isPluginHookField;
+exports.isUnpluginHookField = isUnpluginHookField;
+exports.isUnpluginHookKey = isUnpluginHookKey;

package/dist/powerlines/src/plugin-utils/helpers.mjs

@@ -0,0 +1,156 @@
+import { BUILDER_VARIANTS, UNPLUGIN_BUILDER_VARIANTS } from "../types/build.mjs";
+import { PLUGIN_HOOKS_FIELDS } from "../types/plugin.mjs";
+import { isFunction } from "@stryke/type-checks/is-function";
+import { isSetObject } from "@stryke/type-checks/is-set-object";
+import { isSetString } from "@stryke/type-checks/is-set-string";
+import { isUndefined } from "@stryke/type-checks/is-undefined";
+
+//#region ../powerlines/src/plugin-utils/helpers.ts
+/**
+* Type guard to check if an object is a {@link Plugin}
+*
+* @param value - The object to check
+* @returns True if the object is a {@link Plugin}, false otherwise
+*/
+function isPlugin(value) {
+	return isSetObject(value) && "name" in value && isSetString(value.name) && (isUndefined(value.api) || "api" in value && isSetObject(value.api)) && (isUndefined(value.applyToEnvironment) || "applyToEnvironment" in value && isFunction(value.applyToEnvironment)) && (isUndefined(value.dedupe) || "dedupe" in value && isFunction(value.dedupe)) && PLUGIN_HOOKS_FIELDS.every((hook) => isUndefined(value[hook]) || hook in value && (isPluginHookFunction(value[hook]) || hook === "config" && isSetObject(value[hook]))) && BUILDER_VARIANTS.every((variant) => isUndefined(value[variant]) || variant in value && isSetObject(value[variant]));
+}
+/**
+* Type guard to check if an object is a {@link PluginConfigObject}
+*
+* @param value - The object to check
+* @returns True if the object is a {@link PluginConfigObject}, false otherwise
+*/
+function isPluginConfigObject(value) {
+	return isSetObject(value) && "plugin" in value && ((isSetString(value.plugin) || isFunction(value.plugin)) && "options" in value && isSetObject(value.options) || isPlugin(value.plugin));
+}
+/**
+* Type guard to check if an object is a {@link PluginConfigTuple}
+*
+* @param value - The object to check
+* @returns True if the object is a {@link PluginConfigTuple}, false otherwise
+*/
+function isPluginConfigTuple(value) {
+	return Array.isArray(value) && (value.length === 1 || value.length === 2) && ((isSetString(value[0]) || isFunction(value[0])) && value.length > 1 && isSetObject(value[1]) || isPlugin(value[0]));
+}
+/**
+* Type guard to check if an object is a {@link PluginConfig}
+*
+* @param value - The object to check
+* @returns True if the object is a {@link PluginConfig}, false otherwise
+*/
+function isPluginConfig(value) {
+	return isSetString(value) || isFunction(value) || isPlugin(value) || isPluginConfigObject(value) || isPluginConfigTuple(value) || Array.isArray(value) && value.every((item) => isPluginConfig(item));
+}
+/**
+* Type guard to check if an value is a {@link PluginHook} function
+*
+* @param value - The value to check
+* @returns True if the value is a {@link PluginHook} function, false otherwise
+*/
+function isPluginHookObject(value) {
+	return isSetObject(value) && "handler" in value && isFunction(value.handler);
+}
+/**
+* Type guard to check if an value is a {@link PluginHook} function
+*
+* @param value - The value to check
+* @returns True if the value is a {@link PluginHook} function, false otherwise
+*/
+function isPluginHookFunction(value) {
+	return isFunction(value) || isPluginHookObject(value);
+}
+/**
+* Type guard to check if an object is a {@link PluginHook}
+*
+* @param value - The object to check
+* @returns True if the object is a {@link PluginHook}, false otherwise
+*/
+function isPluginHook(value) {
+	return isPluginHookFunction(value) || isPluginHookObject(value);
+}
+/**
+* Extract the hook handler function from a plugin hook
+*
+* @param pluginHook - The plugin hook to extract the handler function from
+* @returns The hook handler function
+*/
+function getHookHandler(pluginHook) {
+	return isFunction(pluginHook) ? pluginHook : pluginHook.handler;
+}
+/**
+* Check if a hook is external.
+*
+* @param keys - The name of the hook to check.
+* @returns True if the hook is external, false otherwise.
+*/
+function isUnpluginHookKey(keys) {
+	return UNPLUGIN_BUILDER_VARIANTS.some((variant) => keys.startsWith(`${variant}:`));
+}
+/**
+* Check if a hook is internal.
+*
+* @param keys - The name of the hook to check.
+* @returns True if the hook is external, false otherwise.
+*/
+function isPluginHookField(keys) {
+	return !isUnpluginHookKey(keys) && PLUGIN_HOOKS_FIELDS.includes(keys);
+}
+/**
+* Check if a hook is external.
+*
+* @param field - The name of the hook to check.
+* @returns True if the hook is external, false otherwise.
+*/
+function isUnpluginHookField(field) {
+	return !isPluginHookField(field) && UNPLUGIN_BUILDER_VARIANTS.includes(field);
+}
+/**
+* Check if a plugin should be deduplicated.
+*
+* @param plugin - The plugin to check
+* @param plugins - The list of plugins to check against
+* @returns True if the plugin should be deduplicated, false otherwise
+*/
+function checkDedupe(plugin, plugins) {
+	return plugin.dedupe === false || plugins.some((p) => p.dedupe !== false && (isFunction(p.dedupe) && p.dedupe(plugin) || p.name === plugin.name));
+}
+/**
+* Add a plugin hook to the hooks list.
+*
+* @param context - The plugin context
+* @param plugin - The plugin to add the hook from
+* @param pluginHook - The plugin hook to add
+* @param hooksList - The list of hooks to add to
+*/
+function addPluginHook(context, plugin, pluginHook, hooksList) {
+	if (!checkDedupe(plugin, hooksList.map((hook) => hook.plugin).filter(Boolean))) {
+		const handler = ((...args) => getHookHandler(pluginHook).apply(context, args));
+		if (!handler) return;
+		hooksList.push({
+			plugin,
+			handler
+		});
+	}
+}
+/**
+* Check the provided {@link PluginConfig}, and return a stringified version of the invalid configuration. If an array is provided, check each item in the array.
+*
+* @param config - The plugin configuration to check
+* @returns Null if the configuration is valid, otherwise an array of stringified invalid configurations
+*/
+function findInvalidPluginConfig(config) {
+	if (isPluginConfig(config)) return null;
+	if (Array.isArray(config)) {
+		const invalidItems = [];
+		config.forEach((item) => {
+			const invalid = findInvalidPluginConfig(item);
+			if (invalid) invalidItems.push(...invalid.map((i) => JSON.stringify(i, null, 2)));
+		});
+		return invalidItems.length > 0 ? invalidItems : null;
+	}
+	return [JSON.stringify(config, null, 2)];
+}
+
+//#endregion
+export { addPluginHook, checkDedupe, findInvalidPluginConfig, isPlugin, isPluginConfig, isPluginConfigObject, isPluginConfigTuple, isPluginHook, isPluginHookField, isUnpluginHookField, isUnpluginHookKey };

package/dist/powerlines/src/plugin-utils/paths.cjs

@@ -0,0 +1,36 @@
+const require_rolldown_runtime = require('../../../_virtual/rolldown_runtime.cjs');
+let __stryke_path_replace = require("@stryke/path/replace");
+
+//#region ../powerlines/src/plugin-utils/paths.ts
+/**
+* Replaces tokens in the given path string with their corresponding values from the context.
+*
+* @remarks
+* The following tokens are supported:
+* - `{workspaceRoot}` - The root directory of the workspace.
+* - `{root}` - The root directory of the project (same as `{projectRoot}`).
+* - `{projectRoot}` - The root directory of the project (same as `{root}`).
+* - `{sourceRoot}` - The source root directory of the project (usually `./src`).
+* - `{powerlinesPath}` - The directory where Powerlines is installed.
+* - `{cachePath}` - The environment's directory for cached files.
+* - `{dataPath}` - The environment's directory for data files.
+* - `{logPath}` - The environment's directory for log files.
+* - `{tempPath}` - The environment's directory for temporary files.
+* - `{configPath}` - The environment's directory for configuration files.
+* - `{outputPath}` - The configured output directory for the project.
+* - `{buildPath}` - The configured distribution directory for the project.
+* - `{artifactsPath}` - The configured directory for build artifacts.
+* - `{builtinPath}` - The configured directory for generated built-in plugins.
+* - `{entryPath}` - The configured directory for generated entry files.
+*
+* @param context - The context containing the values for the path tokens.
+* @param path - The path string with tokens to replace.
+* @returns The path string with tokens replaced by their corresponding values from the context.
+*/
+function replacePathTokens(context, path) {
+	if (!path) return path;
+	return path.replaceAll("{workspaceRoot}", context.workspaceConfig.workspaceRoot).replaceAll("{root}", context.config.projectRoot).replaceAll("{projectRoot}", context.config.projectRoot).replaceAll("{sourceRoot}", context.config.sourceRoot).replaceAll("{powerlinesPath}", context.powerlinesPath).replaceAll("{cachePath}", context.cachePath).replaceAll("{dataPath}", context.dataPath).replaceAll("{logPath}", context.envPaths.log).replaceAll("{tempPath}", context.envPaths.temp).replaceAll("{configPath}", context.envPaths.config).replaceAll("{outputPath}", context.config.output.outputPath).replaceAll("{buildPath}", context.config.output.buildPath).replaceAll("{artifactsPath}", (0, __stryke_path_replace.replacePath)(context.artifactsPath, context.workspaceConfig.workspaceRoot)).replaceAll("{builtinPath}", (0, __stryke_path_replace.replacePath)(context.builtinsPath, context.workspaceConfig.workspaceRoot)).replaceAll("{entryPath}", (0, __stryke_path_replace.replacePath)(context.entryPath, context.workspaceConfig.workspaceRoot));
+}
+
+//#endregion
+exports.replacePathTokens = replacePathTokens;

package/dist/powerlines/src/plugin-utils/paths.mjs

@@ -0,0 +1,35 @@
+import { replacePath } from "@stryke/path/replace";
+
+//#region ../powerlines/src/plugin-utils/paths.ts
+/**
+* Replaces tokens in the given path string with their corresponding values from the context.
+*
+* @remarks
+* The following tokens are supported:
+* - `{workspaceRoot}` - The root directory of the workspace.
+* - `{root}` - The root directory of the project (same as `{projectRoot}`).
+* - `{projectRoot}` - The root directory of the project (same as `{root}`).
+* - `{sourceRoot}` - The source root directory of the project (usually `./src`).
+* - `{powerlinesPath}` - The directory where Powerlines is installed.
+* - `{cachePath}` - The environment's directory for cached files.
+* - `{dataPath}` - The environment's directory for data files.
+* - `{logPath}` - The environment's directory for log files.
+* - `{tempPath}` - The environment's directory for temporary files.
+* - `{configPath}` - The environment's directory for configuration files.
+* - `{outputPath}` - The configured output directory for the project.
+* - `{buildPath}` - The configured distribution directory for the project.
+* - `{artifactsPath}` - The configured directory for build artifacts.
+* - `{builtinPath}` - The configured directory for generated built-in plugins.
+* - `{entryPath}` - The configured directory for generated entry files.
+*
+* @param context - The context containing the values for the path tokens.
+* @param path - The path string with tokens to replace.
+* @returns The path string with tokens replaced by their corresponding values from the context.
+*/
+function replacePathTokens(context, path) {
+	if (!path) return path;
+	return path.replaceAll("{workspaceRoot}", context.workspaceConfig.workspaceRoot).replaceAll("{root}", context.config.projectRoot).replaceAll("{projectRoot}", context.config.projectRoot).replaceAll("{sourceRoot}", context.config.sourceRoot).replaceAll("{powerlinesPath}", context.powerlinesPath).replaceAll("{cachePath}", context.cachePath).replaceAll("{dataPath}", context.dataPath).replaceAll("{logPath}", context.envPaths.log).replaceAll("{tempPath}", context.envPaths.temp).replaceAll("{configPath}", context.envPaths.config).replaceAll("{outputPath}", context.config.output.outputPath).replaceAll("{buildPath}", context.config.output.buildPath).replaceAll("{artifactsPath}", replacePath(context.artifactsPath, context.workspaceConfig.workspaceRoot)).replaceAll("{builtinPath}", replacePath(context.builtinsPath, context.workspaceConfig.workspaceRoot)).replaceAll("{entryPath}", replacePath(context.entryPath, context.workspaceConfig.workspaceRoot));
+}
+
+//#endregion
+export { replacePathTokens };

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

@@ -0,0 +1,104 @@
+import { ResolvedConfig } from "./resolved.cjs";
+import { InferHookParameters, InferHookReturnType } from "./hooks.cjs";
+import { CallHookOptions } from "../internal/helpers/hooks.cjs";
+import { BuildInlineConfig, CleanInlineConfig, DeployInlineConfig, DocsInlineConfig, LintInlineConfig, NewInlineConfig, PrepareInlineConfig } from "./config.cjs";
+import { APIContext, EnvironmentContext, PluginContext } from "./context.cjs";
+
+//#region ../powerlines/src/types/api.d.ts
+
+/**
+ * Powerlines API Interface
+ */
+interface API<TResolvedConfig extends ResolvedConfig = ResolvedConfig> {
+  /**
+   * The Powerlines shared API context
+   */
+  context: APIContext<TResolvedConfig>;
+  /**
+   * Prepare the Powerlines API
+   *
+   * @remarks
+   * This method will prepare the Powerlines API for use, initializing any necessary resources.
+   *
+   * @param inlineConfig - The inline configuration for the prepare command
+   */
+  prepare: (inlineConfig: PrepareInlineConfig | NewInlineConfig | CleanInlineConfig | BuildInlineConfig | LintInlineConfig | DocsInlineConfig | DeployInlineConfig) => Promise<void>;
+  /**
+   * Create a new Powerlines project
+   *
+   * @remarks
+   * This method will create a new Powerlines project in the current directory.
+   *
+   * @param inlineConfig - The inline configuration for the new command
+   * @returns A promise that resolves when the project has been created
+   */
+  new: (inlineConfig: NewInlineConfig) => Promise<void>;
+  /**
+   * Clean any previously prepared artifacts
+   *
+   * @remarks
+   * This method will remove the previous Powerlines artifacts from the project.
+   *
+   * @param inlineConfig - The inline configuration for the clean command
+   * @returns A promise that resolves when the clean command has completed
+   */
+  clean: (inlineConfig: CleanInlineConfig | PrepareInlineConfig) => Promise<void>;
+  /**
+   * Lint the project source code
+   *
+   * @param inlineConfig - The inline configuration for the lint command
+   * @returns A promise that resolves when the lint command has completed
+   */
+  lint: (inlineConfig: LintInlineConfig) => Promise<void>;
+  /**
+   * Build the project
+   *
+   * @remarks
+   * This method will build the Powerlines project, generating the necessary artifacts.
+   *
+   * @param inlineConfig - The inline configuration for the build command
+   * @returns A promise that resolves when the build command has completed
+   */
+  build: (inlineConfig: BuildInlineConfig) => Promise<void>;
+  /**
+   * Prepare the documentation for the project
+   *
+   * @param inlineConfig - The inline configuration for the docs command
+   * @returns A promise that resolves when the documentation generation has completed
+   */
+  docs: (inlineConfig: DocsInlineConfig) => Promise<void>;
+  /**
+   * Deploy the project source code
+   *
+   * @remarks
+   * This method will prepare and build the Powerlines project, generating the necessary artifacts for the deployment.
+   *
+   * @param inlineConfig - The inline configuration for the deploy command
+   */
+  deploy: (inlineConfig: DeployInlineConfig) => Promise<void>;
+  /**
+   * Finalization process
+   *
+   * @remarks
+   * This step includes any final processes or clean up required by Powerlines. It will be run after each Powerlines command.
+   *
+   * @returns A promise that resolves when the finalization process has completed
+   */
+  finalize: () => Promise<void>;
+  /**
+   * Invokes the configured plugin hooks
+   *
+   * @remarks
+   * By default, it will call the `"pre"`, `"normal"`, and `"post"` ordered hooks in sequence
+   *
+   * @param hook - The hook to call
+   * @param options - The options to provide to the hook
+   * @param args - The arguments to pass to the hook
+   * @returns The result of the hook call
+   */
+  callHook: <TKey extends string>(hook: TKey, options: CallHookOptions & {
+    environment?: string | EnvironmentContext<TResolvedConfig>;
+  }, ...args: InferHookParameters<PluginContext<TResolvedConfig>, TKey>) => Promise<InferHookReturnType<PluginContext<TResolvedConfig>, TKey> | undefined>;
+}
+//#endregion
+export { API };

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

@@ -0,0 +1,104 @@
+import { ResolvedConfig } from "./resolved.mjs";
+import { InferHookParameters, InferHookReturnType } from "./hooks.mjs";
+import { CallHookOptions } from "../internal/helpers/hooks.mjs";
+import { BuildInlineConfig, CleanInlineConfig, DeployInlineConfig, DocsInlineConfig, LintInlineConfig, NewInlineConfig, PrepareInlineConfig } from "./config.mjs";
+import { APIContext, EnvironmentContext, PluginContext } from "./context.mjs";
+
+//#region ../powerlines/src/types/api.d.ts
+
+/**
+ * Powerlines API Interface
+ */
+interface API<TResolvedConfig extends ResolvedConfig = ResolvedConfig> {
+  /**
+   * The Powerlines shared API context
+   */
+  context: APIContext<TResolvedConfig>;
+  /**
+   * Prepare the Powerlines API
+   *
+   * @remarks
+   * This method will prepare the Powerlines API for use, initializing any necessary resources.
+   *
+   * @param inlineConfig - The inline configuration for the prepare command
+   */
+  prepare: (inlineConfig: PrepareInlineConfig | NewInlineConfig | CleanInlineConfig | BuildInlineConfig | LintInlineConfig | DocsInlineConfig | DeployInlineConfig) => Promise<void>;
+  /**
+   * Create a new Powerlines project
+   *
+   * @remarks
+   * This method will create a new Powerlines project in the current directory.
+   *
+   * @param inlineConfig - The inline configuration for the new command
+   * @returns A promise that resolves when the project has been created
+   */
+  new: (inlineConfig: NewInlineConfig) => Promise<void>;
+  /**
+   * Clean any previously prepared artifacts
+   *
+   * @remarks
+   * This method will remove the previous Powerlines artifacts from the project.
+   *
+   * @param inlineConfig - The inline configuration for the clean command
+   * @returns A promise that resolves when the clean command has completed
+   */
+  clean: (inlineConfig: CleanInlineConfig | PrepareInlineConfig) => Promise<void>;
+  /**
+   * Lint the project source code
+   *
+   * @param inlineConfig - The inline configuration for the lint command
+   * @returns A promise that resolves when the lint command has completed
+   */
+  lint: (inlineConfig: LintInlineConfig) => Promise<void>;
+  /**
+   * Build the project
+   *
+   * @remarks
+   * This method will build the Powerlines project, generating the necessary artifacts.
+   *
+   * @param inlineConfig - The inline configuration for the build command
+   * @returns A promise that resolves when the build command has completed
+   */
+  build: (inlineConfig: BuildInlineConfig) => Promise<void>;
+  /**
+   * Prepare the documentation for the project
+   *
+   * @param inlineConfig - The inline configuration for the docs command
+   * @returns A promise that resolves when the documentation generation has completed
+   */
+  docs: (inlineConfig: DocsInlineConfig) => Promise<void>;
+  /**
+   * Deploy the project source code
+   *
+   * @remarks
+   * This method will prepare and build the Powerlines project, generating the necessary artifacts for the deployment.
+   *
+   * @param inlineConfig - The inline configuration for the deploy command
+   */
+  deploy: (inlineConfig: DeployInlineConfig) => Promise<void>;
+  /**
+   * Finalization process
+   *
+   * @remarks
+   * This step includes any final processes or clean up required by Powerlines. It will be run after each Powerlines command.
+   *
+   * @returns A promise that resolves when the finalization process has completed
+   */
+  finalize: () => Promise<void>;
+  /**
+   * Invokes the configured plugin hooks
+   *
+   * @remarks
+   * By default, it will call the `"pre"`, `"normal"`, and `"post"` ordered hooks in sequence
+   *
+   * @param hook - The hook to call
+   * @param options - The options to provide to the hook
+   * @param args - The arguments to pass to the hook
+   * @returns The result of the hook call
+   */
+  callHook: <TKey extends string>(hook: TKey, options: CallHookOptions & {
+    environment?: string | EnvironmentContext<TResolvedConfig>;
+  }, ...args: InferHookParameters<PluginContext<TResolvedConfig>, TKey>) => Promise<InferHookReturnType<PluginContext<TResolvedConfig>, TKey> | undefined>;
+}
+//#endregion
+export { API };

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

@@ -0,0 +1,2 @@
+import "./config.mjs";
+import "./context.mjs";

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

@@ -0,0 +1,23 @@
+
+//#region ../powerlines/src/types/build.ts
+const UNPLUGIN_BUILDER_VARIANTS = [
+	"rollup",
+	"webpack",
+	"rspack",
+	"vite",
+	"esbuild",
+	"farm",
+	"unloader",
+	"rolldown",
+	"bun"
+];
+const BUILDER_VARIANTS = [
+	...UNPLUGIN_BUILDER_VARIANTS,
+	"tsup",
+	"tsdown",
+	"unbuild"
+];
+
+//#endregion
+exports.BUILDER_VARIANTS = BUILDER_VARIANTS;
+exports.UNPLUGIN_BUILDER_VARIANTS = UNPLUGIN_BUILDER_VARIANTS;