@powerlines/nx 0.13.124 → 0.13.126

package/dist/src/base/base-executor.d.mts

@@ -1,11 +1,11 @@
 import __tsdown_shims_path from 'node:path';
 import __tsdown_shims_url from 'node:url';
 import { BaseExecutorSchema } from "./base-executor.schema.mjs";
+import { ExecutionOptions, FrameworkOptions, InlineConfig } from "powerlines";
 import { ExecutorContext, PromiseExecutor } from "@nx/devkit";
 import { StormWorkspaceConfig } from "@storm-software/config/types";
 import { BaseExecutorResult } from "@storm-software/workspace-tools/types";
 import { DeepPartial } from "@stryke/types/base";
-import { ExecutionOptions, InlineConfig } from "powerlines";
 
 //#region src/base/base-executor.d.ts
 type PowerlinesExecutorContext<TExecutorSchema extends BaseExecutorSchema = BaseExecutorSchema> = ExecutorContext & {
@@ -16,6 +16,36 @@ type PowerlinesExecutorContext<TExecutorSchema extends BaseExecutorSchema = Base
   workspaceConfig: StormWorkspaceConfig;
 };
 type PowerlinesExecutorApi = (inlineConfig: InlineConfig) => Promise<void>;
+interface WithExecutorOptions {
+  /**
+   * The import path for the executor API module, which is used to dynamically import the API function that will be called during execution. This value should be a string representing the module path, and it defaults to "powerlines/api" if not provided. The specified module should export a default function that matches the expected signature for the executor API, which will be invoked with the execution parameters when the executor is run.
+   *
+   * @defaultValue "powerlines/api"
+   */
+  importPath?: string;
+  /**
+   * Default options to be merged with the execution options, which can be used to provide default values for certain execution parameters or to override specific options for all executions of the executor. This value should be an object that matches the shape of the `ExecutionOptions` type, and it will be merged with the options provided during execution to create the final set of options that will be passed to the executor API function.
+   *
+   * @remarks
+   * This can be useful for setting default values for options that are commonly used across multiple executions, or for providing a consistent set of options for all executions of the executor without requiring the caller to specify them each time.
+   */
+  defaultOptions?: DeepPartial<ExecutionOptions>;
+  /**
+   * Details about the framework being used in the current execution, which can be used by plugins and other parts of the system to customize behavior based on the framework.
+   *
+   * @remarks
+   * This should only be used by framework plugins to ensure the correct framework name is applied
+   *
+   * @defaultValue
+   * ```ts
+   * {
+   *   name: "powerlines",
+   *   orgId: "storm-software"
+   * }
+   * ```
+   */
+  framework?: FrameworkOptions;
+}
 /**
  * A utility function to create a Powerlines executor that can be used with the `withRunExecutor` function.
  *
@@ -24,10 +54,10 @@ type PowerlinesExecutorApi = (inlineConfig: InlineConfig) => Promise<void>;
  *
  * @param command - The command that the executor will handle (e.g., "new", "prepare", "build", etc.).
  * @param executorFn - The function that will be executed when the command is run.
- * @param defaultOptions - Default options to be merged with the execution options.
+ * @param options - Additional options for configuring the executor, such as the import path for the API module and default execution options.
  * @returns A Promise that resolves to the result of the executor function.
  */
-declare function withExecutor<TExecutorSchema extends BaseExecutorSchema = BaseExecutorSchema>(command: string, executorFn: (context: PowerlinesExecutorContext<TExecutorSchema>, api: PowerlinesExecutorApi) => Promise<BaseExecutorResult | null | undefined> | BaseExecutorResult | null | undefined, defaultOptions?: DeepPartial<ExecutionOptions>): PromiseExecutor<TExecutorSchema>;
+declare function withExecutor<TExecutorSchema extends BaseExecutorSchema = BaseExecutorSchema>(command: string, executorFn: (context: PowerlinesExecutorContext<TExecutorSchema>, api: PowerlinesExecutorApi) => Promise<BaseExecutorResult | null | undefined> | BaseExecutorResult | null | undefined, options?: WithExecutorOptions): PromiseExecutor<TExecutorSchema>;
 //#endregion
-export { PowerlinesExecutorApi, PowerlinesExecutorContext, withExecutor };
+export { PowerlinesExecutorApi, PowerlinesExecutorContext, WithExecutorOptions, withExecutor };
 //# sourceMappingURL=base-executor.d.mts.map

package/dist/src/base/base-executor.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"base-executor.d.mts","names":[],"sources":["../../../src/base/base-executor.ts"],"mappings":";;;;;;;;;;KA0CY,yBAAA,yBACc,kBAAA,GAAqB,kBAAA,IAC3C,eAAA;EACF,WAAA;EACA,OAAA;EACA,OAAA,EAAS,eAAA;EACT,YAAA,EAAc,YAAA;EACd,eAAA,EAAiB,oBAAA;AAAA;AAAA,KAGP,qBAAA,IACV,YAAA,EAAc,YAAA,KACX,OAAO;;;AAZZ;;;;;;;;;iBAyBgB,YAAA,yBACU,kBAAA,GAAqB,kBAAA,CAAA,CAE7C,OAAA,UACA,UAAA,GACE,OAAA,EAAS,yBAAA,CAA0B,eAAA,GACnC,GAAA,EAAK,qBAAA,KAEH,OAAA,CAAQ,kBAAA,uBACR,kBAAA,qBAGJ,cAAA,GAAgB,WAAA,CAAY,gBAAA,IAC3B,eAAA,CAAgB,eAAA"}
+{"version":3,"file":"base-executor.d.mts","names":[],"sources":["../../../src/base/base-executor.ts"],"mappings":";;;;;;;;;;KA6CY,yBAAA,yBACc,kBAAA,GAAqB,kBAAA,IAC3C,eAAA;EACF,WAAA;EACA,OAAA;EACA,OAAA,EAAS,eAAA;EACT,YAAA,EAAc,YAAA;EACd,eAAA,EAAiB,oBAAA;AAAA;AAAA,KAGP,qBAAA,IACV,YAAA,EAAc,YAAA,KACX,OAAO;AAAA,UAEK,mBAAA;;AAdjB;;;;EAoBE,UAAA;EAlBE;;;;;;EA0BF,cAAA,GAAiB,WAAA,CAAY,gBAAA;EA3BL;;;;;;;;;;;;AAMa;AAGvC;EAkCE,SAAA,GAAY,gBAAA;AAAA;;;;;;AAhCF;AAEZ;;;;;iBA4CgB,YAAA,yBACU,kBAAA,GAAqB,kBAAA,CAAA,CAE7C,OAAA,UACA,UAAA,GACE,OAAA,EAAS,yBAAA,CAA0B,eAAA,GACnC,GAAA,EAAK,qBAAA,KAEH,OAAA,CAAQ,kBAAA,uBACR,kBAAA,qBAGJ,OAAA,GAAS,mBAAA,GACR,eAAA,CAAgB,eAAA"}

package/dist/src/base/base-executor.d.ts

@@ -3,7 +3,7 @@ import { ExecutorContext, PromiseExecutor } from "@nx/devkit";
 import { StormWorkspaceConfig } from "@storm-software/config/types";
 import { BaseExecutorResult } from "@storm-software/workspace-tools/types";
 import { DeepPartial } from "@stryke/types/base";
-import { ExecutionOptions, InlineConfig } from "powerlines";
+import { ExecutionOptions, FrameworkOptions, InlineConfig } from "powerlines";
 
 //#region src/base/base-executor.d.ts
 type PowerlinesExecutorContext<TExecutorSchema extends BaseExecutorSchema = BaseExecutorSchema> = ExecutorContext & {
@@ -14,6 +14,36 @@ type PowerlinesExecutorContext<TExecutorSchema extends BaseExecutorSchema = Base
   workspaceConfig: StormWorkspaceConfig;
 };
 type PowerlinesExecutorApi = (inlineConfig: InlineConfig) => Promise<void>;
+interface WithExecutorOptions {
+  /**
+   * The import path for the executor API module, which is used to dynamically import the API function that will be called during execution. This value should be a string representing the module path, and it defaults to "powerlines/api" if not provided. The specified module should export a default function that matches the expected signature for the executor API, which will be invoked with the execution parameters when the executor is run.
+   *
+   * @defaultValue "powerlines/api"
+   */
+  importPath?: string;
+  /**
+   * Default options to be merged with the execution options, which can be used to provide default values for certain execution parameters or to override specific options for all executions of the executor. This value should be an object that matches the shape of the `ExecutionOptions` type, and it will be merged with the options provided during execution to create the final set of options that will be passed to the executor API function.
+   *
+   * @remarks
+   * This can be useful for setting default values for options that are commonly used across multiple executions, or for providing a consistent set of options for all executions of the executor without requiring the caller to specify them each time.
+   */
+  defaultOptions?: DeepPartial<ExecutionOptions>;
+  /**
+   * Details about the framework being used in the current execution, which can be used by plugins and other parts of the system to customize behavior based on the framework.
+   *
+   * @remarks
+   * This should only be used by framework plugins to ensure the correct framework name is applied
+   *
+   * @defaultValue
+   * ```ts
+   * {
+   *   name: "powerlines",
+   *   orgId: "storm-software"
+   * }
+   * ```
+   */
+  framework?: FrameworkOptions;
+}
 /**
  * A utility function to create a Powerlines executor that can be used with the `withRunExecutor` function.
  *
@@ -22,10 +52,10 @@ type PowerlinesExecutorApi = (inlineConfig: InlineConfig) => Promise<void>;
  *
  * @param command - The command that the executor will handle (e.g., "new", "prepare", "build", etc.).
  * @param executorFn - The function that will be executed when the command is run.
- * @param defaultOptions - Default options to be merged with the execution options.
+ * @param options - Additional options for configuring the executor, such as the import path for the API module and default execution options.
  * @returns A Promise that resolves to the result of the executor function.
  */
-declare function withExecutor<TExecutorSchema extends BaseExecutorSchema = BaseExecutorSchema>(command: string, executorFn: (context: PowerlinesExecutorContext<TExecutorSchema>, api: PowerlinesExecutorApi) => Promise<BaseExecutorResult | null | undefined> | BaseExecutorResult | null | undefined, defaultOptions?: DeepPartial<ExecutionOptions>): PromiseExecutor<TExecutorSchema>;
+declare function withExecutor<TExecutorSchema extends BaseExecutorSchema = BaseExecutorSchema>(command: string, executorFn: (context: PowerlinesExecutorContext<TExecutorSchema>, api: PowerlinesExecutorApi) => Promise<BaseExecutorResult | null | undefined> | BaseExecutorResult | null | undefined, options?: WithExecutorOptions): PromiseExecutor<TExecutorSchema>;
 //#endregion
-export { PowerlinesExecutorApi, PowerlinesExecutorContext, withExecutor };
+export { PowerlinesExecutorApi, PowerlinesExecutorContext, WithExecutorOptions, withExecutor };
 //# sourceMappingURL=base-executor.d.ts.map

package/dist/src/base/base-executor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"base-executor.d.ts","names":[],"sources":["../../../src/base/base-executor.ts"],"mappings":";;;;;;;;KA0CY,yBAAA,yBACc,kBAAA,GAAqB,kBAAA,IAC3C,eAAA;EACF,WAAA;EACA,OAAA;EACA,OAAA,EAAS,eAAA;EACT,YAAA,EAAc,YAAA;EACd,eAAA,EAAiB,oBAAA;AAAA;AAAA,KAGP,qBAAA,IACV,YAAA,EAAc,YAAA,KACX,OAAO;;;;;;;;;;;;iBAaI,YAAA,yBACU,kBAAA,GAAqB,kBAAA,CAAA,CAE7C,OAAA,UACA,UAAA,GACE,OAAA,EAAS,yBAAA,CAA0B,eAAA,GACnC,GAAA,EAAK,qBAAA,KAEH,OAAA,CAAQ,kBAAA,uBACR,kBAAA,qBAGJ,cAAA,GAAgB,WAAA,CAAY,gBAAA,IAC3B,eAAA,CAAgB,eAAA"}
+{"version":3,"file":"base-executor.d.ts","names":[],"sources":["../../../src/base/base-executor.ts"],"mappings":";;;;;;;;KA6CY,yBAAA,yBACc,kBAAA,GAAqB,kBAAA,IAC3C,eAAA;EACF,WAAA;EACA,OAAA;EACA,OAAA,EAAS,eAAA;EACT,YAAA,EAAc,YAAA;EACd,eAAA,EAAiB,oBAAA;AAAA;AAAA,KAGP,qBAAA,IACV,YAAA,EAAc,YAAA,KACX,OAAO;AAAA,UAEK,mBAAA;EARD;;;;;EAcd,UAAA;EAnB6C;;;;;;EA2B7C,cAAA,GAAiB,WAAA,CAAY,gBAAA;EAtBf;;;;AACuB;AAGvC;;;;;;;;AAEY;EAgCV,SAAA,GAAY,gBAAA;AAAA;;;;;;;;;;;;iBAcE,YAAA,yBACU,kBAAA,GAAqB,kBAAA,CAAA,CAE7C,OAAA,UACA,UAAA,GACE,OAAA,EAAS,yBAAA,CAA0B,eAAA,GACnC,GAAA,EAAK,qBAAA,KAEH,OAAA,CAAQ,kBAAA,uBACR,kBAAA,qBAGJ,OAAA,GAAS,mBAAA,GACR,eAAA,CAAgB,eAAA"}

package/dist/src/base/base-executor.js

@@ -12,6 +12,7 @@ let _storm_software_config_tools_logger = require("@storm-software/config-tools/
 let _storm_software_workspace_tools_base_base_executor = require("@storm-software/workspace-tools/base/base-executor");
 let _stryke_helpers_omit = require("@stryke/helpers/omit");
 let _stryke_path_join = require("@stryke/path/join");
+let _stryke_string_format_kebab_case = require("@stryke/string-format/kebab-case");
 let _stryke_string_format_title_case = require("@stryke/string-format/title-case");
 let _stryke_type_checks_is_error = require("@stryke/type-checks/is-error");
 let _stryke_type_checks_is_set = require("@stryke/type-checks/is-set");
@@ -20,6 +21,7 @@ let _stryke_type_checks_is_set_object = require("@stryke/type-checks/is-set-obje
 let defu = require("defu");
 defu = require_runtime.__toESM(defu);
 let jiti = require("jiti");
+let powerlines = require("powerlines");
 
 //#region src/base/base-executor.ts
 /**
@@ -30,19 +32,22 @@ let jiti = require("jiti");
 *
 * @param command - The command that the executor will handle (e.g., "new", "prepare", "build", etc.).
 * @param executorFn - The function that will be executed when the command is run.
-* @param defaultOptions - Default options to be merged with the execution options.
+* @param options - Additional options for configuring the executor, such as the import path for the API module and default execution options.
 * @returns A Promise that resolves to the result of the executor function.
 */
-function withExecutor(command, executorFn, defaultOptions = {}) {
-	return (0, _storm_software_workspace_tools_base_base_executor.withRunExecutor)(`Powerlines - ${(0, _stryke_string_format_title_case.titleCase)(command)} executor`, async (options, context, workspaceConfig) => {
-		if (!context.projectName) throw new Error(`The Powerlines - ${(0, _stryke_string_format_title_case.titleCase)(command)} executor requires \`projectName\` on the context object.`);
-		if (!context.projectName || !context.projectsConfigurations?.projects || !context.projectsConfigurations.projects[context.projectName] || !context.projectsConfigurations.projects[context.projectName]?.root) throw new Error(`The Powerlines - ${(0, _stryke_string_format_title_case.titleCase)(command)} executor requires \`projectsConfigurations\` on the context object.`);
+function withExecutor(command, executorFn, options = {}) {
+	const { importPath = "powerlines/api", defaultOptions = {}, framework = {} } = options;
+	framework.name ??= "powerlines";
+	framework.orgId ??= "storm-software";
+	return (0, _storm_software_workspace_tools_base_base_executor.withRunExecutor)(`${(0, _stryke_string_format_title_case.titleCase)(framework.name)} - ${(0, _stryke_string_format_title_case.titleCase)(command)} executor`, async (options, context, workspaceConfig) => {
+		if (!context.projectName) throw new Error(`The ${(0, _stryke_string_format_title_case.titleCase)(framework.name)} - ${(0, _stryke_string_format_title_case.titleCase)(command)} executor requires \`projectName\` on the context object.`);
+		if (!context.projectName || !context.projectsConfigurations?.projects || !context.projectsConfigurations.projects[context.projectName] || !context.projectsConfigurations.projects[context.projectName]?.root) throw new Error(`The ${(0, _stryke_string_format_title_case.titleCase)(framework.name)} - ${(0, _stryke_string_format_title_case.titleCase)(command)} executor requires \`projectsConfigurations\` on the context object.`);
 		const projectConfig = context.projectsConfigurations.projects[context.projectName];
 		const jiti$1 = (0, jiti.createJiti)(context.root, {
 			cache: false,
 			tsconfigPaths: true
 		});
-		const api = await jiti$1.import(jiti$1.esmResolve("powerlines/api")).then((mod) => mod.default);
+		const api = await jiti$1.import(jiti$1.esmResolve(importPath)).then((mod) => mod.default);
 		try {
 			return await Promise.resolve(executorFn((0, defu.default)({
 				projectName: context.projectName,
@@ -90,21 +95,18 @@ function withExecutor(command, executorFn, defaultOptions = {}) {
 				]))
 			}, context), async (inlineConfig) => api({
 				options: (0, defu.default)(defaultOptions, {
-					executionId: `${context.projectName}-${command}-${options.configIndex}`,
+					executionId: (0, powerlines.formatExecutionId)(inlineConfig.name || context.projectName || projectConfig.root, command, options.configIndex ?? 0),
 					cwd: context.root,
 					root: projectConfig.root,
-					configFile: options.configFile || options.config || (0, _stryke_path_join.joinPaths)(projectConfig.root, "powerlines.config.ts"),
+					configFile: options.configFile || options.config || (0, _stryke_path_join.joinPaths)(projectConfig.root, `${(0, _stryke_string_format_kebab_case.kebabCase)(framework.name)}.config.ts`),
 					configIndex: options.configIndex,
-					framework: {
-						name: "powerlines",
-						orgId: "storm-software"
-					}
+					framework
 				}),
 				command,
 				inlineConfig
 			})));
 		} catch (error) {
-			(0, _storm_software_config_tools_logger.writeError)(`An error occurred while executing the Powerlines - ${(0, _stryke_string_format_title_case.titleCase)(command)} executor: ${(0, _stryke_type_checks_is_error.isError)(error) ? `${error.message}
+			(0, _storm_software_config_tools_logger.writeError)(`An error occurred while executing the ${(0, _stryke_string_format_title_case.titleCase)(framework.name)} - ${(0, _stryke_string_format_title_case.titleCase)(command)} executor: ${(0, _stryke_type_checks_is_error.isError)(error) ? `${error.message}
 
 ${error.stack}` : "Unknown error"}`);
 			return { success: false };

package/dist/src/base/base-executor.mjs

@@ -10,6 +10,7 @@ import { writeError } from "@storm-software/config-tools/logger";
 import { withRunExecutor } from "@storm-software/workspace-tools/base/base-executor";
 import { omit } from "@stryke/helpers/omit";
 import { joinPaths } from "@stryke/path/join";
+import { kebabCase } from "@stryke/string-format/kebab-case";
 import { titleCase } from "@stryke/string-format/title-case";
 import { isError } from "@stryke/type-checks/is-error";
 import { isSet } from "@stryke/type-checks/is-set";
@@ -17,6 +18,7 @@ import { isSetArray } from "@stryke/type-checks/is-set-array";
 import { isSetObject } from "@stryke/type-checks/is-set-object";
 import defu from "defu";
 import { createJiti } from "jiti";
+import { formatExecutionId } from "powerlines";
 
 //#region src/base/base-executor.ts
 /**
@@ -27,19 +29,22 @@ import { createJiti } from "jiti";
 *
 * @param command - The command that the executor will handle (e.g., "new", "prepare", "build", etc.).
 * @param executorFn - The function that will be executed when the command is run.
-* @param defaultOptions - Default options to be merged with the execution options.
+* @param options - Additional options for configuring the executor, such as the import path for the API module and default execution options.
 * @returns A Promise that resolves to the result of the executor function.
 */
-function withExecutor(command, executorFn, defaultOptions = {}) {
-	return withRunExecutor(`Powerlines - ${titleCase(command)} executor`, async (options, context, workspaceConfig) => {
-		if (!context.projectName) throw new Error(`The Powerlines - ${titleCase(command)} executor requires \`projectName\` on the context object.`);
-		if (!context.projectName || !context.projectsConfigurations?.projects || !context.projectsConfigurations.projects[context.projectName] || !context.projectsConfigurations.projects[context.projectName]?.root) throw new Error(`The Powerlines - ${titleCase(command)} executor requires \`projectsConfigurations\` on the context object.`);
+function withExecutor(command, executorFn, options = {}) {
+	const { importPath = "powerlines/api", defaultOptions = {}, framework = {} } = options;
+	framework.name ??= "powerlines";
+	framework.orgId ??= "storm-software";
+	return withRunExecutor(`${titleCase(framework.name)} - ${titleCase(command)} executor`, async (options, context, workspaceConfig) => {
+		if (!context.projectName) throw new Error(`The ${titleCase(framework.name)} - ${titleCase(command)} executor requires \`projectName\` on the context object.`);
+		if (!context.projectName || !context.projectsConfigurations?.projects || !context.projectsConfigurations.projects[context.projectName] || !context.projectsConfigurations.projects[context.projectName]?.root) throw new Error(`The ${titleCase(framework.name)} - ${titleCase(command)} executor requires \`projectsConfigurations\` on the context object.`);
 		const projectConfig = context.projectsConfigurations.projects[context.projectName];
 		const jiti = createJiti(context.root, {
 			cache: false,
 			tsconfigPaths: true
 		});
-		const api = await jiti.import(jiti.esmResolve("powerlines/api")).then((mod) => mod.default);
+		const api = await jiti.import(jiti.esmResolve(importPath)).then((mod) => mod.default);
 		try {
 			return await Promise.resolve(executorFn(defu({
 				projectName: context.projectName,
@@ -87,21 +92,18 @@ function withExecutor(command, executorFn, defaultOptions = {}) {
 				]))
 			}, context), async (inlineConfig) => api({
 				options: defu(defaultOptions, {
-					executionId: `${context.projectName}-${command}-${options.configIndex}`,
+					executionId: formatExecutionId(inlineConfig.name || context.projectName || projectConfig.root, command, options.configIndex ?? 0),
 					cwd: context.root,
 					root: projectConfig.root,
-					configFile: options.configFile || options.config || joinPaths(projectConfig.root, "powerlines.config.ts"),
+					configFile: options.configFile || options.config || joinPaths(projectConfig.root, `${kebabCase(framework.name)}.config.ts`),
 					configIndex: options.configIndex,
-					framework: {
-						name: "powerlines",
-						orgId: "storm-software"
-					}
+					framework
 				}),
 				command,
 				inlineConfig
 			})));
 		} catch (error) {
-			writeError(`An error occurred while executing the Powerlines - ${titleCase(command)} executor: ${isError(error) ? `${error.message}
+			writeError(`An error occurred while executing the ${titleCase(framework.name)} - ${titleCase(command)} executor: ${isError(error) ? `${error.message}
 
 ${error.stack}` : "Unknown error"}`);
 			return { success: false };

package/dist/src/base/base-executor.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"base-executor.mjs","names":[],"sources":["../../../src/base/base-executor.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 { ExecutorContext, PromiseExecutor } from \"@nx/devkit\";\nimport { writeError } from \"@storm-software/config-tools/logger\";\nimport { StormWorkspaceConfig } from \"@storm-software/config/types\";\nimport { withRunExecutor } from \"@storm-software/workspace-tools/base/base-executor\";\nimport { BaseExecutorResult } from \"@storm-software/workspace-tools/types\";\nimport { omit } from \"@stryke/helpers/omit\";\nimport { joinPaths } from \"@stryke/path/join\";\nimport { titleCase } from \"@stryke/string-format/title-case\";\nimport { isError } from \"@stryke/type-checks/is-error\";\nimport { isSet } from \"@stryke/type-checks/is-set\";\nimport { isSetArray } from \"@stryke/type-checks/is-set-array\";\nimport { isSetObject } from \"@stryke/type-checks/is-set-object\";\nimport type { DeepPartial } from \"@stryke/types/base\";\nimport defu from \"defu\";\nimport { createJiti } from \"jiti\";\nimport type {\n  ExecutionApiParams,\n  ExecutionOptions,\n  InlineConfig,\n  Mode,\n  OutputConfig\n} from \"powerlines\";\nimport { BaseExecutorSchema } from \"./base-executor.schema\";\n\nexport type PowerlinesExecutorContext<\n  TExecutorSchema extends BaseExecutorSchema = BaseExecutorSchema\n> = ExecutorContext & {\n  projectName: string;\n  command: string;\n  options: TExecutorSchema;\n  inlineConfig: InlineConfig;\n  workspaceConfig: StormWorkspaceConfig;\n};\n\nexport type PowerlinesExecutorApi = (\n  inlineConfig: InlineConfig\n) => Promise<void>;\n\n/**\n * A utility function to create a Powerlines executor that can be used with the `withRunExecutor` function.\n *\n * @remarks\n * This function is designed to simplify the creation of Powerlines executors by providing a consistent interface and error handling.\n *\n * @param command - The command that the executor will handle (e.g., \"new\", \"prepare\", \"build\", etc.).\n * @param executorFn - The function that will be executed when the command is run.\n * @param defaultOptions - Default options to be merged with the execution options.\n * @returns A Promise that resolves to the result of the executor function.\n */\nexport function withExecutor<\n  TExecutorSchema extends BaseExecutorSchema = BaseExecutorSchema\n>(\n  command: string,\n  executorFn: (\n    context: PowerlinesExecutorContext<TExecutorSchema>,\n    api: PowerlinesExecutorApi\n  ) =>\n    | Promise<BaseExecutorResult | null | undefined>\n    | BaseExecutorResult\n    | null\n    | undefined,\n  defaultOptions: DeepPartial<ExecutionOptions> = {}\n): PromiseExecutor<TExecutorSchema> {\n  return withRunExecutor(\n    `Powerlines - ${titleCase(command)} executor`,\n    async (\n      options: TExecutorSchema,\n      context: ExecutorContext,\n      workspaceConfig: StormWorkspaceConfig\n    ): Promise<BaseExecutorResult | null | undefined> => {\n      if (!context.projectName) {\n        throw new Error(\n          `The Powerlines - ${titleCase(command)} executor requires \\`projectName\\` on the context object.`\n        );\n      }\n\n      if (\n        !context.projectName ||\n        !context.projectsConfigurations?.projects ||\n        !context.projectsConfigurations.projects[context.projectName] ||\n        !context.projectsConfigurations.projects[context.projectName]?.root\n      ) {\n        throw new Error(\n          `The Powerlines - ${titleCase(command)} executor requires \\`projectsConfigurations\\` on the context object.`\n        );\n      }\n\n      const projectConfig =\n        context.projectsConfigurations.projects[context.projectName]!;\n\n      const jiti = createJiti(context.root, {\n        cache: false,\n        tsconfigPaths: true\n      });\n      const api = await jiti\n        .import<{\n          default: (params: ExecutionApiParams) => Promise<void>;\n        }>(jiti.esmResolve(\"powerlines/api\"))\n        .then(mod => mod.default);\n\n      try {\n        return await Promise.resolve(\n          executorFn(\n            defu(\n              {\n                projectName: context.projectName,\n                options,\n                workspaceConfig,\n                command,\n                inlineConfig: defu(\n                  {\n                    name: context.projectName,\n                    command,\n                    root: projectConfig.root,\n                    configFile: options.configFile || options.config,\n                    configIndex: options.configIndex,\n                    projectType: projectConfig.projectType,\n                    mode: options.mode as Mode,\n                    output: {\n                      path: options.outputPath,\n                      copy:\n                        options.copyPath === false\n                          ? false\n                          : {\n                              path: options.copyPath,\n                              assets: options.assets\n                            },\n                      minify: options.minify,\n                      sourceMap: options.sourceMap\n                    } as OutputConfig,\n                    resolve:\n                      isSetArray(options.external) ||\n                      isSetArray(options.noExternal) ||\n                      isSet(options.skipNodeModulesBundle)\n                        ? {\n                            external: isSetArray(options.external)\n                              ? options.external\n                              : undefined,\n                            noExternal: isSetArray(options.noExternal)\n                              ? options.noExternal\n                              : undefined,\n                            skipNodeModulesBundle: isSet(\n                              options.skipNodeModulesBundle\n                            )\n                              ? options.skipNodeModulesBundle\n                              : undefined\n                          }\n                        : undefined,\n                    define: isSetObject(options.define)\n                      ? options.define\n                      : undefined,\n                    assets: isSetObject(options.assets)\n                      ? options.assets\n                      : undefined\n                  },\n                  omit(options, [\n                    \"config\",\n                    \"configFile\",\n                    \"outputPath\",\n                    \"copyPath\",\n                    \"sourceMap\",\n                    \"minify\",\n                    \"format\",\n                    \"external\",\n                    \"noExternal\",\n                    \"skipNodeModulesBundle\",\n                    \"mode\",\n                    \"define\",\n                    \"assets\"\n                  ])\n                ) as InlineConfig\n              },\n              context\n            ),\n            async (inlineConfig: InlineConfig) =>\n              api({\n                // eslint-disable-next-line ts/no-unnecessary-type-assertion\n                options: defu(defaultOptions, {\n                  executionId: `${context.projectName}-${command}-${options.configIndex}`,\n                  cwd: context.root,\n                  root: projectConfig.root,\n                  configFile:\n                    options.configFile ||\n                    options.config ||\n                    joinPaths(projectConfig.root, \"powerlines.config.ts\"),\n                  configIndex: options.configIndex,\n                  framework: {\n                    name: \"powerlines\",\n                    orgId: \"storm-software\"\n                  }\n                }) as ExecutionOptions,\n                command,\n                inlineConfig\n              })\n          )\n        );\n      } catch (error) {\n        writeError(\n          `An error occurred while executing the Powerlines - ${titleCase(\n            command\n          )} executor: ${\n            isError(error)\n              ? `${error.message}\n\n${error.stack}`\n              : \"Unknown error\"\n          }`\n        );\n\n        return { success: false };\n      }\n    },\n    {\n      skipReadingConfig: false,\n      hooks: {\n        applyDefaultOptions: (options: Partial<TExecutorSchema>) => {\n          options.copyPath ??= \"dist/{projectRoot}\";\n\n          return options as TExecutorSchema;\n        }\n      }\n    }\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAmEA,SAAgB,aAGd,SACA,YAQA,iBAAgD,CAAC,GACf;CAClC,OAAO,gBACL,gBAAgB,UAAU,OAAO,EAAE,YACnC,OACE,SACA,SACA,oBACmD;EACnD,IAAI,CAAC,QAAQ,aACX,MAAM,IAAI,MACR,oBAAoB,UAAU,OAAO,EAAE,0DACzC;EAGF,IACE,CAAC,QAAQ,eACT,CAAC,QAAQ,wBAAwB,YACjC,CAAC,QAAQ,uBAAuB,SAAS,QAAQ,gBACjD,CAAC,QAAQ,uBAAuB,SAAS,QAAQ,cAAc,MAE/D,MAAM,IAAI,MACR,oBAAoB,UAAU,OAAO,EAAE,qEACzC;EAGF,MAAM,gBACJ,QAAQ,uBAAuB,SAAS,QAAQ;EAElD,MAAM,OAAO,WAAW,QAAQ,MAAM;GACpC,OAAO;GACP,eAAe;EACjB,CAAC;EACD,MAAM,MAAM,MAAM,KACf,OAEE,KAAK,WAAW,gBAAgB,CAAC,EACnC,MAAK,QAAO,IAAI,OAAO;EAE1B,IAAI;GACF,OAAO,MAAM,QAAQ,QACnB,WACE,KACE;IACE,aAAa,QAAQ;IACrB;IACA;IACA;IACA,cAAc,KACZ;KACE,MAAM,QAAQ;KACd;KACA,MAAM,cAAc;KACpB,YAAY,QAAQ,cAAc,QAAQ;KAC1C,aAAa,QAAQ;KACrB,aAAa,cAAc;KAC3B,MAAM,QAAQ;KACd,QAAQ;MACN,MAAM,QAAQ;MACd,MACE,QAAQ,aAAa,QACjB,QACA;OACE,MAAM,QAAQ;OACd,QAAQ,QAAQ;MAClB;MACN,QAAQ,QAAQ;MAChB,WAAW,QAAQ;KACrB;KACA,SACE,WAAW,QAAQ,QAAQ,KAC3B,WAAW,QAAQ,UAAU,KAC7B,MAAM,QAAQ,qBAAqB,IAC/B;MACE,UAAU,WAAW,QAAQ,QAAQ,IACjC,QAAQ,WACR;MACJ,YAAY,WAAW,QAAQ,UAAU,IACrC,QAAQ,aACR;MACJ,uBAAuB,MACrB,QAAQ,qBACV,IACI,QAAQ,wBACR;KACN,IACA;KACN,QAAQ,YAAY,QAAQ,MAAM,IAC9B,QAAQ,SACR;KACJ,QAAQ,YAAY,QAAQ,MAAM,IAC9B,QAAQ,SACR;IACN,GACA,KAAK,SAAS;KACZ;KACA;KACA;KACA;KACA;KACA;KACA;KACA;KACA;KACA;KACA;KACA;KACA;IACF,CAAC,CACH;GACF,GACA,OACF,GACA,OAAO,iBACL,IAAI;IAEF,SAAS,KAAK,gBAAgB;KAC5B,aAAa,GAAG,QAAQ,YAAY,GAAG,QAAQ,GAAG,QAAQ;KAC1D,KAAK,QAAQ;KACb,MAAM,cAAc;KACpB,YACE,QAAQ,cACR,QAAQ,UACR,UAAU,cAAc,MAAM,sBAAsB;KACtD,aAAa,QAAQ;KACrB,WAAW;MACT,MAAM;MACN,OAAO;KACT;IACF,CAAC;IACD;IACA;GACF,CAAC,CACL,CACF;EACF,SAAS,OAAO;GACd,WACE,sDAAsD,UACpD,OACF,EAAE,aACA,QAAQ,KAAK,IACT,GAAG,MAAM,QAAQ;;EAE/B,MAAM,UACQ,iBAER;GAEA,OAAO,EAAE,SAAS,MAAM;EAC1B;CACF,GACA;EACE,mBAAmB;EACnB,OAAO,EACL,sBAAsB,YAAsC;GAC1D,QAAQ,aAAa;GAErB,OAAO;EACT,EACF;CACF,CACF;AACF"}
+{"version":3,"file":"base-executor.mjs","names":[],"sources":["../../../src/base/base-executor.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 { ExecutorContext, PromiseExecutor } from \"@nx/devkit\";\nimport { writeError } from \"@storm-software/config-tools/logger\";\nimport { StormWorkspaceConfig } from \"@storm-software/config/types\";\nimport { withRunExecutor } from \"@storm-software/workspace-tools/base/base-executor\";\nimport { BaseExecutorResult } from \"@storm-software/workspace-tools/types\";\nimport { omit } from \"@stryke/helpers/omit\";\nimport { joinPaths } from \"@stryke/path/join\";\nimport { kebabCase } from \"@stryke/string-format/kebab-case\";\nimport { titleCase } from \"@stryke/string-format/title-case\";\nimport { isError } from \"@stryke/type-checks/is-error\";\nimport { isSet } from \"@stryke/type-checks/is-set\";\nimport { isSetArray } from \"@stryke/type-checks/is-set-array\";\nimport { isSetObject } from \"@stryke/type-checks/is-set-object\";\nimport type { DeepPartial } from \"@stryke/types/base\";\nimport defu from \"defu\";\nimport { createJiti } from \"jiti\";\nimport type {\n  ExecutionApiParams,\n  ExecutionOptions,\n  FrameworkOptions,\n  InlineConfig,\n  Mode,\n  OutputConfig\n} from \"powerlines\";\nimport { formatExecutionId } from \"powerlines\";\nimport { BaseExecutorSchema } from \"./base-executor.schema\";\n\nexport type PowerlinesExecutorContext<\n  TExecutorSchema extends BaseExecutorSchema = BaseExecutorSchema\n> = ExecutorContext & {\n  projectName: string;\n  command: string;\n  options: TExecutorSchema;\n  inlineConfig: InlineConfig;\n  workspaceConfig: StormWorkspaceConfig;\n};\n\nexport type PowerlinesExecutorApi = (\n  inlineConfig: InlineConfig\n) => Promise<void>;\n\nexport interface WithExecutorOptions {\n  /**\n   * The import path for the executor API module, which is used to dynamically import the API function that will be called during execution. This value should be a string representing the module path, and it defaults to \"powerlines/api\" if not provided. The specified module should export a default function that matches the expected signature for the executor API, which will be invoked with the execution parameters when the executor is run.\n   *\n   * @defaultValue \"powerlines/api\"\n   */\n  importPath?: string;\n\n  /**\n   * Default options to be merged with the execution options, which can be used to provide default values for certain execution parameters or to override specific options for all executions of the executor. This value should be an object that matches the shape of the `ExecutionOptions` type, and it will be merged with the options provided during execution to create the final set of options that will be passed to the executor API function.\n   *\n   * @remarks\n   * This can be useful for setting default values for options that are commonly used across multiple executions, or for providing a consistent set of options for all executions of the executor without requiring the caller to specify them each time.\n   */\n  defaultOptions?: DeepPartial<ExecutionOptions>;\n\n  /**\n   * Details about the framework being used in the current execution, which can be used by plugins and other parts of the system to customize behavior based on the framework.\n   *\n   * @remarks\n   * This should only be used by framework plugins to ensure the correct framework name is applied\n   *\n   * @defaultValue\n   * ```ts\n   * {\n   *   name: \"powerlines\",\n   *   orgId: \"storm-software\"\n   * }\n   * ```\n   */\n  framework?: FrameworkOptions;\n}\n\n/**\n * A utility function to create a Powerlines executor that can be used with the `withRunExecutor` function.\n *\n * @remarks\n * This function is designed to simplify the creation of Powerlines executors by providing a consistent interface and error handling.\n *\n * @param command - The command that the executor will handle (e.g., \"new\", \"prepare\", \"build\", etc.).\n * @param executorFn - The function that will be executed when the command is run.\n * @param options - Additional options for configuring the executor, such as the import path for the API module and default execution options.\n * @returns A Promise that resolves to the result of the executor function.\n */\nexport function withExecutor<\n  TExecutorSchema extends BaseExecutorSchema = BaseExecutorSchema\n>(\n  command: string,\n  executorFn: (\n    context: PowerlinesExecutorContext<TExecutorSchema>,\n    api: PowerlinesExecutorApi\n  ) =>\n    | Promise<BaseExecutorResult | null | undefined>\n    | BaseExecutorResult\n    | null\n    | undefined,\n  options: WithExecutorOptions = {}\n): PromiseExecutor<TExecutorSchema> {\n  const {\n    importPath = \"powerlines/api\",\n    defaultOptions = {},\n    framework = {} as FrameworkOptions\n  } = options;\n\n  framework.name ??= \"powerlines\";\n  framework.orgId ??= \"storm-software\";\n\n  return withRunExecutor(\n    `${titleCase(framework.name)} - ${titleCase(command)} executor`,\n    async (\n      options: TExecutorSchema,\n      context: ExecutorContext,\n      workspaceConfig: StormWorkspaceConfig\n    ): Promise<BaseExecutorResult | null | undefined> => {\n      if (!context.projectName) {\n        throw new Error(\n          `The ${titleCase(framework.name)} - ${titleCase(\n            command\n          )} executor requires \\`projectName\\` on the context object.`\n        );\n      }\n\n      if (\n        !context.projectName ||\n        !context.projectsConfigurations?.projects ||\n        !context.projectsConfigurations.projects[context.projectName] ||\n        !context.projectsConfigurations.projects[context.projectName]?.root\n      ) {\n        throw new Error(\n          `The ${titleCase(framework.name)} - ${titleCase(\n            command\n          )} executor requires \\`projectsConfigurations\\` on the context object.`\n        );\n      }\n\n      const projectConfig =\n        context.projectsConfigurations.projects[context.projectName]!;\n\n      const jiti = createJiti(context.root, {\n        cache: false,\n        tsconfigPaths: true\n      });\n      const api = await jiti\n        .import<{\n          default: (params: ExecutionApiParams) => Promise<void>;\n        }>(jiti.esmResolve(importPath))\n        .then(mod => mod.default);\n\n      try {\n        return await Promise.resolve(\n          executorFn(\n            defu(\n              {\n                projectName: context.projectName,\n                options,\n                workspaceConfig,\n                command,\n                inlineConfig: defu(\n                  {\n                    name: context.projectName,\n                    command,\n                    root: projectConfig.root,\n                    configFile: options.configFile || options.config,\n                    configIndex: options.configIndex,\n                    projectType: projectConfig.projectType,\n                    mode: options.mode as Mode,\n                    output: {\n                      path: options.outputPath,\n                      copy:\n                        options.copyPath === false\n                          ? false\n                          : {\n                              path: options.copyPath,\n                              assets: options.assets\n                            },\n                      minify: options.minify,\n                      sourceMap: options.sourceMap\n                    } as OutputConfig,\n                    resolve:\n                      isSetArray(options.external) ||\n                      isSetArray(options.noExternal) ||\n                      isSet(options.skipNodeModulesBundle)\n                        ? {\n                            external: isSetArray(options.external)\n                              ? options.external\n                              : undefined,\n                            noExternal: isSetArray(options.noExternal)\n                              ? options.noExternal\n                              : undefined,\n                            skipNodeModulesBundle: isSet(\n                              options.skipNodeModulesBundle\n                            )\n                              ? options.skipNodeModulesBundle\n                              : undefined\n                          }\n                        : undefined,\n                    define: isSetObject(options.define)\n                      ? options.define\n                      : undefined,\n                    assets: isSetObject(options.assets)\n                      ? options.assets\n                      : undefined\n                  },\n                  omit(options, [\n                    \"config\",\n                    \"configFile\",\n                    \"outputPath\",\n                    \"copyPath\",\n                    \"sourceMap\",\n                    \"minify\",\n                    \"format\",\n                    \"external\",\n                    \"noExternal\",\n                    \"skipNodeModulesBundle\",\n                    \"mode\",\n                    \"define\",\n                    \"assets\"\n                  ])\n                ) as InlineConfig\n              },\n              context\n            ),\n            async (inlineConfig: InlineConfig) =>\n              api({\n                options: defu(defaultOptions, {\n                  executionId: formatExecutionId(\n                    inlineConfig.name ||\n                      context.projectName ||\n                      projectConfig.root,\n                    command,\n                    options.configIndex ?? 0\n                  ),\n                  cwd: context.root,\n                  root: projectConfig.root,\n                  configFile:\n                    options.configFile ||\n                    options.config ||\n                    joinPaths(\n                      projectConfig.root,\n                      `${kebabCase(framework.name)}.config.ts`\n                    ),\n                  configIndex: options.configIndex,\n                  framework\n                }) as ExecutionOptions,\n                command,\n                inlineConfig\n              })\n          )\n        );\n      } catch (error) {\n        writeError(\n          `An error occurred while executing the ${titleCase(\n            framework.name\n          )} - ${titleCase(command)} executor: ${\n            isError(error)\n              ? `${error.message}\n\n${error.stack}`\n              : \"Unknown error\"\n          }`\n        );\n\n        return { success: false };\n      }\n    },\n    {\n      skipReadingConfig: false,\n      hooks: {\n        applyDefaultOptions: (options: Partial<TExecutorSchema>) => {\n          options.copyPath ??= \"dist/{projectRoot}\";\n\n          return options as TExecutorSchema;\n        }\n      }\n    }\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAuGA,SAAgB,aAGd,SACA,YAQA,UAA+B,CAAC,GACE;CAClC,MAAM,EACJ,aAAa,kBACb,iBAAiB,CAAC,GAClB,YAAY,CAAC,MACX;CAEJ,UAAU,SAAS;CACnB,UAAU,UAAU;CAEpB,OAAO,gBACL,GAAG,UAAU,UAAU,IAAI,EAAE,KAAK,UAAU,OAAO,EAAE,YACrD,OACE,SACA,SACA,oBACmD;EACnD,IAAI,CAAC,QAAQ,aACX,MAAM,IAAI,MACR,OAAO,UAAU,UAAU,IAAI,EAAE,KAAK,UACpC,OACF,EAAE,0DACJ;EAGF,IACE,CAAC,QAAQ,eACT,CAAC,QAAQ,wBAAwB,YACjC,CAAC,QAAQ,uBAAuB,SAAS,QAAQ,gBACjD,CAAC,QAAQ,uBAAuB,SAAS,QAAQ,cAAc,MAE/D,MAAM,IAAI,MACR,OAAO,UAAU,UAAU,IAAI,EAAE,KAAK,UACpC,OACF,EAAE,qEACJ;EAGF,MAAM,gBACJ,QAAQ,uBAAuB,SAAS,QAAQ;EAElD,MAAM,OAAO,WAAW,QAAQ,MAAM;GACpC,OAAO;GACP,eAAe;EACjB,CAAC;EACD,MAAM,MAAM,MAAM,KACf,OAEE,KAAK,WAAW,UAAU,CAAC,EAC7B,MAAK,QAAO,IAAI,OAAO;EAE1B,IAAI;GACF,OAAO,MAAM,QAAQ,QACnB,WACE,KACE;IACE,aAAa,QAAQ;IACrB;IACA;IACA;IACA,cAAc,KACZ;KACE,MAAM,QAAQ;KACd;KACA,MAAM,cAAc;KACpB,YAAY,QAAQ,cAAc,QAAQ;KAC1C,aAAa,QAAQ;KACrB,aAAa,cAAc;KAC3B,MAAM,QAAQ;KACd,QAAQ;MACN,MAAM,QAAQ;MACd,MACE,QAAQ,aAAa,QACjB,QACA;OACE,MAAM,QAAQ;OACd,QAAQ,QAAQ;MAClB;MACN,QAAQ,QAAQ;MAChB,WAAW,QAAQ;KACrB;KACA,SACE,WAAW,QAAQ,QAAQ,KAC3B,WAAW,QAAQ,UAAU,KAC7B,MAAM,QAAQ,qBAAqB,IAC/B;MACE,UAAU,WAAW,QAAQ,QAAQ,IACjC,QAAQ,WACR;MACJ,YAAY,WAAW,QAAQ,UAAU,IACrC,QAAQ,aACR;MACJ,uBAAuB,MACrB,QAAQ,qBACV,IACI,QAAQ,wBACR;KACN,IACA;KACN,QAAQ,YAAY,QAAQ,MAAM,IAC9B,QAAQ,SACR;KACJ,QAAQ,YAAY,QAAQ,MAAM,IAC9B,QAAQ,SACR;IACN,GACA,KAAK,SAAS;KACZ;KACA;KACA;KACA;KACA;KACA;KACA;KACA;KACA;KACA;KACA;KACA;KACA;IACF,CAAC,CACH;GACF,GACA,OACF,GACA,OAAO,iBACL,IAAI;IACF,SAAS,KAAK,gBAAgB;KAC5B,aAAa,kBACX,aAAa,QACX,QAAQ,eACR,cAAc,MAChB,SACA,QAAQ,eAAe,CACzB;KACA,KAAK,QAAQ;KACb,MAAM,cAAc;KACpB,YACE,QAAQ,cACR,QAAQ,UACR,UACE,cAAc,MACd,GAAG,UAAU,UAAU,IAAI,EAAE,WAC/B;KACF,aAAa,QAAQ;KACrB;IACF,CAAC;IACD;IACA;GACF,CAAC,CACL,CACF;EACF,SAAS,OAAO;GACd,WACE,yCAAyC,UACvC,UAAU,IACZ,EAAE,KAAK,UAAU,OAAO,EAAE,aACxB,QAAQ,KAAK,IACT,GAAG,MAAM,QAAQ;;EAE/B,MAAM,UACQ,iBAER;GAEA,OAAO,EAAE,SAAS,MAAM;EAC1B;CACF,GACA;EACE,mBAAmB;EACnB,OAAO,EACL,sBAAsB,YAAsC;GAC1D,QAAQ,aAAa;GAErB,OAAO;EACT,EACF;CACF,CACF;AACF"}

package/dist/src/base/index.d.mts

@@ -1,4 +1,4 @@
 import __tsdown_shims_path from 'node:path';
 import __tsdown_shims_url from 'node:url';
-import { PowerlinesExecutorApi, PowerlinesExecutorContext, withExecutor } from "./base-executor.mjs";
-export { PowerlinesExecutorApi, PowerlinesExecutorContext, withExecutor };
+import { PowerlinesExecutorApi, PowerlinesExecutorContext, WithExecutorOptions, withExecutor } from "./base-executor.mjs";
+export { PowerlinesExecutorApi, PowerlinesExecutorContext, WithExecutorOptions, withExecutor };

package/dist/src/base/index.d.ts

@@ -1,2 +1,2 @@
-import { PowerlinesExecutorApi, PowerlinesExecutorContext, withExecutor } from "./base-executor.js";
-export { PowerlinesExecutorApi, PowerlinesExecutorContext, withExecutor };
+import { PowerlinesExecutorApi, PowerlinesExecutorContext, WithExecutorOptions, withExecutor } from "./base-executor.js";
+export { PowerlinesExecutorApi, PowerlinesExecutorContext, WithExecutorOptions, withExecutor };

package/dist/src/{base-executor-0AtMZrSx.mjs → base-executor-B1RffQX6.mjs}

@@ -1,3 +1,4 @@
+import { kebabCase } from "@stryke/string-format/kebab-case";
 import { titleCase } from "@stryke/string-format/title-case";
 import { isError } from "@stryke/type-checks/is-error";
 import { isSetObject } from "@stryke/type-checks/is-set-object";
@@ -9,6 +10,7 @@ import { joinPaths } from "@stryke/path/join";
 import { isSet } from "@stryke/type-checks/is-set";
 import { isSetArray } from "@stryke/type-checks/is-set-array";
 import { createJiti } from "jiti";
+import { formatExecutionId } from "powerlines";
 
 //#region src/base/base-executor.ts
 /**
@@ -19,19 +21,22 @@ import { createJiti } from "jiti";
 *
 * @param command - The command that the executor will handle (e.g., "new", "prepare", "build", etc.).
 * @param executorFn - The function that will be executed when the command is run.
-* @param defaultOptions - Default options to be merged with the execution options.
+* @param options - Additional options for configuring the executor, such as the import path for the API module and default execution options.
 * @returns A Promise that resolves to the result of the executor function.
 */
-function withExecutor(command, executorFn, defaultOptions = {}) {
-	return withRunExecutor(`Powerlines - ${titleCase(command)} executor`, async (options, context, workspaceConfig) => {
-		if (!context.projectName) throw new Error(`The Powerlines - ${titleCase(command)} executor requires \`projectName\` on the context object.`);
-		if (!context.projectName || !context.projectsConfigurations?.projects || !context.projectsConfigurations.projects[context.projectName] || !context.projectsConfigurations.projects[context.projectName]?.root) throw new Error(`The Powerlines - ${titleCase(command)} executor requires \`projectsConfigurations\` on the context object.`);
+function withExecutor(command, executorFn, options = {}) {
+	const { importPath = "powerlines/api", defaultOptions = {}, framework = {} } = options;
+	framework.name ??= "powerlines";
+	framework.orgId ??= "storm-software";
+	return withRunExecutor(`${titleCase(framework.name)} - ${titleCase(command)} executor`, async (options, context, workspaceConfig) => {
+		if (!context.projectName) throw new Error(`The ${titleCase(framework.name)} - ${titleCase(command)} executor requires \`projectName\` on the context object.`);
+		if (!context.projectName || !context.projectsConfigurations?.projects || !context.projectsConfigurations.projects[context.projectName] || !context.projectsConfigurations.projects[context.projectName]?.root) throw new Error(`The ${titleCase(framework.name)} - ${titleCase(command)} executor requires \`projectsConfigurations\` on the context object.`);
 		const projectConfig = context.projectsConfigurations.projects[context.projectName];
 		const jiti = createJiti(context.root, {
 			cache: false,
 			tsconfigPaths: true
 		});
-		const api = await jiti.import(jiti.esmResolve("powerlines/api")).then((mod) => mod.default);
+		const api = await jiti.import(jiti.esmResolve(importPath)).then((mod) => mod.default);
 		try {
 			return await Promise.resolve(executorFn(defu({
 				projectName: context.projectName,
@@ -79,21 +84,18 @@ function withExecutor(command, executorFn, defaultOptions = {}) {
 				]))
 			}, context), async (inlineConfig) => api({
 				options: defu(defaultOptions, {
-					executionId: `${context.projectName}-${command}-${options.configIndex}`,
+					executionId: formatExecutionId(inlineConfig.name || context.projectName || projectConfig.root, command, options.configIndex ?? 0),
 					cwd: context.root,
 					root: projectConfig.root,
-					configFile: options.configFile || options.config || joinPaths(projectConfig.root, "powerlines.config.ts"),
+					configFile: options.configFile || options.config || joinPaths(projectConfig.root, `${kebabCase(framework.name)}.config.ts`),
 					configIndex: options.configIndex,
-					framework: {
-						name: "powerlines",
-						orgId: "storm-software"
-					}
+					framework
 				}),
 				command,
 				inlineConfig
 			})));
 		} catch (error) {
-			writeError(`An error occurred while executing the Powerlines - ${titleCase(command)} executor: ${isError(error) ? `${error.message}
+			writeError(`An error occurred while executing the ${titleCase(framework.name)} - ${titleCase(command)} executor: ${isError(error) ? `${error.message}
 
 ${error.stack}` : "Unknown error"}`);
 			return { success: false };
@@ -109,4 +111,4 @@ ${error.stack}` : "Unknown error"}`);
 
 //#endregion
 export { withExecutor as t };
-//# sourceMappingURL=base-executor-0AtMZrSx.mjs.map
+//# sourceMappingURL=base-executor-B1RffQX6.mjs.map

package/dist/src/base-executor-B1RffQX6.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-executor-B1RffQX6.mjs","names":[],"sources":["../../src/base/base-executor.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 { ExecutorContext, PromiseExecutor } from \"@nx/devkit\";\nimport { writeError } from \"@storm-software/config-tools/logger\";\nimport { StormWorkspaceConfig } from \"@storm-software/config/types\";\nimport { withRunExecutor } from \"@storm-software/workspace-tools/base/base-executor\";\nimport { BaseExecutorResult } from \"@storm-software/workspace-tools/types\";\nimport { omit } from \"@stryke/helpers/omit\";\nimport { joinPaths } from \"@stryke/path/join\";\nimport { kebabCase } from \"@stryke/string-format/kebab-case\";\nimport { titleCase } from \"@stryke/string-format/title-case\";\nimport { isError } from \"@stryke/type-checks/is-error\";\nimport { isSet } from \"@stryke/type-checks/is-set\";\nimport { isSetArray } from \"@stryke/type-checks/is-set-array\";\nimport { isSetObject } from \"@stryke/type-checks/is-set-object\";\nimport type { DeepPartial } from \"@stryke/types/base\";\nimport defu from \"defu\";\nimport { createJiti } from \"jiti\";\nimport type {\n  ExecutionApiParams,\n  ExecutionOptions,\n  FrameworkOptions,\n  InlineConfig,\n  Mode,\n  OutputConfig\n} from \"powerlines\";\nimport { formatExecutionId } from \"powerlines\";\nimport { BaseExecutorSchema } from \"./base-executor.schema\";\n\nexport type PowerlinesExecutorContext<\n  TExecutorSchema extends BaseExecutorSchema = BaseExecutorSchema\n> = ExecutorContext & {\n  projectName: string;\n  command: string;\n  options: TExecutorSchema;\n  inlineConfig: InlineConfig;\n  workspaceConfig: StormWorkspaceConfig;\n};\n\nexport type PowerlinesExecutorApi = (\n  inlineConfig: InlineConfig\n) => Promise<void>;\n\nexport interface WithExecutorOptions {\n  /**\n   * The import path for the executor API module, which is used to dynamically import the API function that will be called during execution. This value should be a string representing the module path, and it defaults to \"powerlines/api\" if not provided. The specified module should export a default function that matches the expected signature for the executor API, which will be invoked with the execution parameters when the executor is run.\n   *\n   * @defaultValue \"powerlines/api\"\n   */\n  importPath?: string;\n\n  /**\n   * Default options to be merged with the execution options, which can be used to provide default values for certain execution parameters or to override specific options for all executions of the executor. This value should be an object that matches the shape of the `ExecutionOptions` type, and it will be merged with the options provided during execution to create the final set of options that will be passed to the executor API function.\n   *\n   * @remarks\n   * This can be useful for setting default values for options that are commonly used across multiple executions, or for providing a consistent set of options for all executions of the executor without requiring the caller to specify them each time.\n   */\n  defaultOptions?: DeepPartial<ExecutionOptions>;\n\n  /**\n   * Details about the framework being used in the current execution, which can be used by plugins and other parts of the system to customize behavior based on the framework.\n   *\n   * @remarks\n   * This should only be used by framework plugins to ensure the correct framework name is applied\n   *\n   * @defaultValue\n   * ```ts\n   * {\n   *   name: \"powerlines\",\n   *   orgId: \"storm-software\"\n   * }\n   * ```\n   */\n  framework?: FrameworkOptions;\n}\n\n/**\n * A utility function to create a Powerlines executor that can be used with the `withRunExecutor` function.\n *\n * @remarks\n * This function is designed to simplify the creation of Powerlines executors by providing a consistent interface and error handling.\n *\n * @param command - The command that the executor will handle (e.g., \"new\", \"prepare\", \"build\", etc.).\n * @param executorFn - The function that will be executed when the command is run.\n * @param options - Additional options for configuring the executor, such as the import path for the API module and default execution options.\n * @returns A Promise that resolves to the result of the executor function.\n */\nexport function withExecutor<\n  TExecutorSchema extends BaseExecutorSchema = BaseExecutorSchema\n>(\n  command: string,\n  executorFn: (\n    context: PowerlinesExecutorContext<TExecutorSchema>,\n    api: PowerlinesExecutorApi\n  ) =>\n    | Promise<BaseExecutorResult | null | undefined>\n    | BaseExecutorResult\n    | null\n    | undefined,\n  options: WithExecutorOptions = {}\n): PromiseExecutor<TExecutorSchema> {\n  const {\n    importPath = \"powerlines/api\",\n    defaultOptions = {},\n    framework = {} as FrameworkOptions\n  } = options;\n\n  framework.name ??= \"powerlines\";\n  framework.orgId ??= \"storm-software\";\n\n  return withRunExecutor(\n    `${titleCase(framework.name)} - ${titleCase(command)} executor`,\n    async (\n      options: TExecutorSchema,\n      context: ExecutorContext,\n      workspaceConfig: StormWorkspaceConfig\n    ): Promise<BaseExecutorResult | null | undefined> => {\n      if (!context.projectName) {\n        throw new Error(\n          `The ${titleCase(framework.name)} - ${titleCase(\n            command\n          )} executor requires \\`projectName\\` on the context object.`\n        );\n      }\n\n      if (\n        !context.projectName ||\n        !context.projectsConfigurations?.projects ||\n        !context.projectsConfigurations.projects[context.projectName] ||\n        !context.projectsConfigurations.projects[context.projectName]?.root\n      ) {\n        throw new Error(\n          `The ${titleCase(framework.name)} - ${titleCase(\n            command\n          )} executor requires \\`projectsConfigurations\\` on the context object.`\n        );\n      }\n\n      const projectConfig =\n        context.projectsConfigurations.projects[context.projectName]!;\n\n      const jiti = createJiti(context.root, {\n        cache: false,\n        tsconfigPaths: true\n      });\n      const api = await jiti\n        .import<{\n          default: (params: ExecutionApiParams) => Promise<void>;\n        }>(jiti.esmResolve(importPath))\n        .then(mod => mod.default);\n\n      try {\n        return await Promise.resolve(\n          executorFn(\n            defu(\n              {\n                projectName: context.projectName,\n                options,\n                workspaceConfig,\n                command,\n                inlineConfig: defu(\n                  {\n                    name: context.projectName,\n                    command,\n                    root: projectConfig.root,\n                    configFile: options.configFile || options.config,\n                    configIndex: options.configIndex,\n                    projectType: projectConfig.projectType,\n                    mode: options.mode as Mode,\n                    output: {\n                      path: options.outputPath,\n                      copy:\n                        options.copyPath === false\n                          ? false\n                          : {\n                              path: options.copyPath,\n                              assets: options.assets\n                            },\n                      minify: options.minify,\n                      sourceMap: options.sourceMap\n                    } as OutputConfig,\n                    resolve:\n                      isSetArray(options.external) ||\n                      isSetArray(options.noExternal) ||\n                      isSet(options.skipNodeModulesBundle)\n                        ? {\n                            external: isSetArray(options.external)\n                              ? options.external\n                              : undefined,\n                            noExternal: isSetArray(options.noExternal)\n                              ? options.noExternal\n                              : undefined,\n                            skipNodeModulesBundle: isSet(\n                              options.skipNodeModulesBundle\n                            )\n                              ? options.skipNodeModulesBundle\n                              : undefined\n                          }\n                        : undefined,\n                    define: isSetObject(options.define)\n                      ? options.define\n                      : undefined,\n                    assets: isSetObject(options.assets)\n                      ? options.assets\n                      : undefined\n                  },\n                  omit(options, [\n                    \"config\",\n                    \"configFile\",\n                    \"outputPath\",\n                    \"copyPath\",\n                    \"sourceMap\",\n                    \"minify\",\n                    \"format\",\n                    \"external\",\n                    \"noExternal\",\n                    \"skipNodeModulesBundle\",\n                    \"mode\",\n                    \"define\",\n                    \"assets\"\n                  ])\n                ) as InlineConfig\n              },\n              context\n            ),\n            async (inlineConfig: InlineConfig) =>\n              api({\n                options: defu(defaultOptions, {\n                  executionId: formatExecutionId(\n                    inlineConfig.name ||\n                      context.projectName ||\n                      projectConfig.root,\n                    command,\n                    options.configIndex ?? 0\n                  ),\n                  cwd: context.root,\n                  root: projectConfig.root,\n                  configFile:\n                    options.configFile ||\n                    options.config ||\n                    joinPaths(\n                      projectConfig.root,\n                      `${kebabCase(framework.name)}.config.ts`\n                    ),\n                  configIndex: options.configIndex,\n                  framework\n                }) as ExecutionOptions,\n                command,\n                inlineConfig\n              })\n          )\n        );\n      } catch (error) {\n        writeError(\n          `An error occurred while executing the ${titleCase(\n            framework.name\n          )} - ${titleCase(command)} executor: ${\n            isError(error)\n              ? `${error.message}\n\n${error.stack}`\n              : \"Unknown error\"\n          }`\n        );\n\n        return { success: false };\n      }\n    },\n    {\n      skipReadingConfig: false,\n      hooks: {\n        applyDefaultOptions: (options: Partial<TExecutorSchema>) => {\n          options.copyPath ??= \"dist/{projectRoot}\";\n\n          return options as TExecutorSchema;\n        }\n      }\n    }\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AAuGA,SAAgB,aAGd,SACA,YAQA,UAA+B,CAAC,GACE;CAClC,MAAM,EACJ,aAAa,kBACb,iBAAiB,CAAC,GAClB,YAAY,CAAC,MACX;CAEJ,UAAU,SAAS;CACnB,UAAU,UAAU;CAEpB,OAAO,gBACL,GAAG,UAAU,UAAU,IAAI,EAAE,KAAK,UAAU,OAAO,EAAE,YACrD,OACE,SACA,SACA,oBACmD;EACnD,IAAI,CAAC,QAAQ,aACX,MAAM,IAAI,MACR,OAAO,UAAU,UAAU,IAAI,EAAE,KAAK,UACpC,OACF,EAAE,0DACJ;EAGF,IACE,CAAC,QAAQ,eACT,CAAC,QAAQ,wBAAwB,YACjC,CAAC,QAAQ,uBAAuB,SAAS,QAAQ,gBACjD,CAAC,QAAQ,uBAAuB,SAAS,QAAQ,cAAc,MAE/D,MAAM,IAAI,MACR,OAAO,UAAU,UAAU,IAAI,EAAE,KAAK,UACpC,OACF,EAAE,qEACJ;EAGF,MAAM,gBACJ,QAAQ,uBAAuB,SAAS,QAAQ;EAElD,MAAM,OAAO,WAAW,QAAQ,MAAM;GACpC,OAAO;GACP,eAAe;EACjB,CAAC;EACD,MAAM,MAAM,MAAM,KACf,OAEE,KAAK,WAAW,UAAU,CAAC,EAC7B,MAAK,QAAO,IAAI,OAAO;EAE1B,IAAI;GACF,OAAO,MAAM,QAAQ,QACnB,WACE,KACE;IACE,aAAa,QAAQ;IACrB;IACA;IACA;IACA,cAAc,KACZ;KACE,MAAM,QAAQ;KACd;KACA,MAAM,cAAc;KACpB,YAAY,QAAQ,cAAc,QAAQ;KAC1C,aAAa,QAAQ;KACrB,aAAa,cAAc;KAC3B,MAAM,QAAQ;KACd,QAAQ;MACN,MAAM,QAAQ;MACd,MACE,QAAQ,aAAa,QACjB,QACA;OACE,MAAM,QAAQ;OACd,QAAQ,QAAQ;MAClB;MACN,QAAQ,QAAQ;MAChB,WAAW,QAAQ;KACrB;KACA,SACE,WAAW,QAAQ,QAAQ,KAC3B,WAAW,QAAQ,UAAU,KAC7B,MAAM,QAAQ,qBAAqB,IAC/B;MACE,UAAU,WAAW,QAAQ,QAAQ,IACjC,QAAQ,WACR;MACJ,YAAY,WAAW,QAAQ,UAAU,IACrC,QAAQ,aACR;MACJ,uBAAuB,MACrB,QAAQ,qBACV,IACI,QAAQ,wBACR;KACN,IACA;KACN,QAAQ,YAAY,QAAQ,MAAM,IAC9B,QAAQ,SACR;KACJ,QAAQ,YAAY,QAAQ,MAAM,IAC9B,QAAQ,SACR;IACN,GACA,KAAK,SAAS;KACZ;KACA;KACA;KACA;KACA;KACA;KACA;KACA;KACA;KACA;KACA;KACA;KACA;IACF,CAAC,CACH;GACF,GACA,OACF,GACA,OAAO,iBACL,IAAI;IACF,SAAS,KAAK,gBAAgB;KAC5B,aAAa,kBACX,aAAa,QACX,QAAQ,eACR,cAAc,MAChB,SACA,QAAQ,eAAe,CACzB;KACA,KAAK,QAAQ;KACb,MAAM,cAAc;KACpB,YACE,QAAQ,cACR,QAAQ,UACR,UACE,cAAc,MACd,GAAG,UAAU,UAAU,IAAI,EAAE,WAC/B;KACF,aAAa,QAAQ;KACrB;IACF,CAAC;IACD;IACA;GACF,CAAC,CACL,CACF;EACF,SAAS,OAAO;GACd,WACE,yCAAyC,UACvC,UAAU,IACZ,EAAE,KAAK,UAAU,OAAO,EAAE,aACxB,QAAQ,KAAK,IACT,GAAG,MAAM,QAAQ;;EAE/B,MAAM,UACQ,iBAER;GAEA,OAAO,EAAE,SAAS,MAAM;EAC1B;CACF,GACA;EACE,mBAAmB;EACnB,OAAO,EACL,sBAAsB,YAAsC;GAC1D,QAAQ,aAAa;GAErB,OAAO;EACT,EACF;CACF,CACF;AACF"}

package/dist/src/{base-executor-BIhn6u5E.js → base-executor-CHEFLBQ-.js}

@@ -1,4 +1,5 @@
 const require_chunk = require('./chunk-C_NdSu1c.js');
+let _stryke_string_format_kebab_case = require("@stryke/string-format/kebab-case");
 let _stryke_string_format_title_case = require("@stryke/string-format/title-case");
 let _stryke_type_checks_is_error = require("@stryke/type-checks/is-error");
 let _stryke_type_checks_is_set_object = require("@stryke/type-checks/is-set-object");
@@ -11,6 +12,7 @@ let _stryke_path_join = require("@stryke/path/join");
 let _stryke_type_checks_is_set = require("@stryke/type-checks/is-set");
 let _stryke_type_checks_is_set_array = require("@stryke/type-checks/is-set-array");
 let jiti = require("jiti");
+let powerlines = require("powerlines");
 
 //#region src/base/base-executor.ts
 /**
@@ -21,19 +23,22 @@ let jiti = require("jiti");
 *
 * @param command - The command that the executor will handle (e.g., "new", "prepare", "build", etc.).
 * @param executorFn - The function that will be executed when the command is run.
-* @param defaultOptions - Default options to be merged with the execution options.
+* @param options - Additional options for configuring the executor, such as the import path for the API module and default execution options.
 * @returns A Promise that resolves to the result of the executor function.
 */
-function withExecutor(command, executorFn, defaultOptions = {}) {
-	return (0, _storm_software_workspace_tools_base_base_executor.withRunExecutor)(`Powerlines - ${(0, _stryke_string_format_title_case.titleCase)(command)} executor`, async (options, context, workspaceConfig) => {
-		if (!context.projectName) throw new Error(`The Powerlines - ${(0, _stryke_string_format_title_case.titleCase)(command)} executor requires \`projectName\` on the context object.`);
-		if (!context.projectName || !context.projectsConfigurations?.projects || !context.projectsConfigurations.projects[context.projectName] || !context.projectsConfigurations.projects[context.projectName]?.root) throw new Error(`The Powerlines - ${(0, _stryke_string_format_title_case.titleCase)(command)} executor requires \`projectsConfigurations\` on the context object.`);
+function withExecutor(command, executorFn, options = {}) {
+	const { importPath = "powerlines/api", defaultOptions = {}, framework = {} } = options;
+	framework.name ??= "powerlines";
+	framework.orgId ??= "storm-software";
+	return (0, _storm_software_workspace_tools_base_base_executor.withRunExecutor)(`${(0, _stryke_string_format_title_case.titleCase)(framework.name)} - ${(0, _stryke_string_format_title_case.titleCase)(command)} executor`, async (options, context, workspaceConfig) => {
+		if (!context.projectName) throw new Error(`The ${(0, _stryke_string_format_title_case.titleCase)(framework.name)} - ${(0, _stryke_string_format_title_case.titleCase)(command)} executor requires \`projectName\` on the context object.`);
+		if (!context.projectName || !context.projectsConfigurations?.projects || !context.projectsConfigurations.projects[context.projectName] || !context.projectsConfigurations.projects[context.projectName]?.root) throw new Error(`The ${(0, _stryke_string_format_title_case.titleCase)(framework.name)} - ${(0, _stryke_string_format_title_case.titleCase)(command)} executor requires \`projectsConfigurations\` on the context object.`);
 		const projectConfig = context.projectsConfigurations.projects[context.projectName];
 		const jiti$1 = (0, jiti.createJiti)(context.root, {
 			cache: false,
 			tsconfigPaths: true
 		});
-		const api = await jiti$1.import(jiti$1.esmResolve("powerlines/api")).then((mod) => mod.default);
+		const api = await jiti$1.import(jiti$1.esmResolve(importPath)).then((mod) => mod.default);
 		try {
 			return await Promise.resolve(executorFn((0, defu.default)({
 				projectName: context.projectName,
@@ -81,21 +86,18 @@ function withExecutor(command, executorFn, defaultOptions = {}) {
 				]))
 			}, context), async (inlineConfig) => api({
 				options: (0, defu.default)(defaultOptions, {
-					executionId: `${context.projectName}-${command}-${options.configIndex}`,
+					executionId: (0, powerlines.formatExecutionId)(inlineConfig.name || context.projectName || projectConfig.root, command, options.configIndex ?? 0),
 					cwd: context.root,
 					root: projectConfig.root,
-					configFile: options.configFile || options.config || (0, _stryke_path_join.joinPaths)(projectConfig.root, "powerlines.config.ts"),
+					configFile: options.configFile || options.config || (0, _stryke_path_join.joinPaths)(projectConfig.root, `${(0, _stryke_string_format_kebab_case.kebabCase)(framework.name)}.config.ts`),
 					configIndex: options.configIndex,
-					framework: {
-						name: "powerlines",
-						orgId: "storm-software"
-					}
+					framework
 				}),
 				command,
 				inlineConfig
 			})));
 		} catch (error) {
-			(0, _storm_software_config_tools_logger.writeError)(`An error occurred while executing the Powerlines - ${(0, _stryke_string_format_title_case.titleCase)(command)} executor: ${(0, _stryke_type_checks_is_error.isError)(error) ? `${error.message}
+			(0, _storm_software_config_tools_logger.writeError)(`An error occurred while executing the ${(0, _stryke_string_format_title_case.titleCase)(framework.name)} - ${(0, _stryke_string_format_title_case.titleCase)(command)} executor: ${(0, _stryke_type_checks_is_error.isError)(error) ? `${error.message}
 
 ${error.stack}` : "Unknown error"}`);
 			return { success: false };

package/dist/src/executors/build/executor.js

@@ -1,4 +1,4 @@
-const require_base_executor = require('../../base-executor-BIhn6u5E.js');
+const require_base_executor = require('../../base-executor-CHEFLBQ-.js');
 
 //#region src/executors/build/executor.ts
 async function executorFn(context, api) {

package/dist/src/executors/build/executor.mjs

@@ -1,4 +1,4 @@
-import { t as withExecutor } from "../../base-executor-0AtMZrSx.mjs";
+import { t as withExecutor } from "../../base-executor-B1RffQX6.mjs";
 
 //#region src/executors/build/executor.ts
 async function executorFn(context, api) {

package/dist/src/executors/clean/executor.js

@@ -1,4 +1,4 @@
-const require_base_executor = require('../../base-executor-BIhn6u5E.js');
+const require_base_executor = require('../../base-executor-CHEFLBQ-.js');
 
 //#region src/executors/clean/executor.ts
 async function executorFn(context, api) {

package/dist/src/executors/clean/executor.mjs

@@ -1,4 +1,4 @@
-import { t as withExecutor } from "../../base-executor-0AtMZrSx.mjs";
+import { t as withExecutor } from "../../base-executor-B1RffQX6.mjs";
 
 //#region src/executors/clean/executor.ts
 async function executorFn(context, api) {

package/dist/src/executors/docs/executor.js

@@ -1,4 +1,4 @@
-const require_base_executor = require('../../base-executor-BIhn6u5E.js');
+const require_base_executor = require('../../base-executor-CHEFLBQ-.js');
 
 //#region src/executors/docs/executor.ts
 async function executorFn(context, api) {

package/dist/src/executors/docs/executor.mjs

@@ -1,4 +1,4 @@
-import { t as withExecutor } from "../../base-executor-0AtMZrSx.mjs";
+import { t as withExecutor } from "../../base-executor-B1RffQX6.mjs";
 
 //#region src/executors/docs/executor.ts
 async function executorFn(context, api) {

package/dist/src/executors/lint/executor.js

@@ -1,4 +1,4 @@
-const require_base_executor = require('../../base-executor-BIhn6u5E.js');
+const require_base_executor = require('../../base-executor-CHEFLBQ-.js');
 
 //#region src/executors/lint/executor.ts
 async function executorFn(context, api) {

package/dist/src/executors/lint/executor.mjs

@@ -1,4 +1,4 @@
-import { t as withExecutor } from "../../base-executor-0AtMZrSx.mjs";
+import { t as withExecutor } from "../../base-executor-B1RffQX6.mjs";
 
 //#region src/executors/lint/executor.ts
 async function executorFn(context, api) {

package/dist/src/executors/prepare/executor.js

@@ -1,4 +1,4 @@
-const require_base_executor = require('../../base-executor-BIhn6u5E.js');
+const require_base_executor = require('../../base-executor-CHEFLBQ-.js');
 
 //#region src/executors/prepare/executor.ts
 async function executorFn(context, api) {

package/dist/src/executors/prepare/executor.mjs

@@ -1,4 +1,4 @@
-import { t as withExecutor } from "../../base-executor-0AtMZrSx.mjs";
+import { t as withExecutor } from "../../base-executor-B1RffQX6.mjs";
 
 //#region src/executors/prepare/executor.ts
 async function executorFn(context, api) {

package/dist/src/helpers/plugin-utilities.js

@@ -9,6 +9,7 @@ const __TSDOWN_SHIM_DIRNAME__ = /* @__PURE__ */ __tsdown_shims_path.dirname(__TS
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const require_runtime = require('../_virtual/_rolldown/runtime.js');
 const require_helpers_constants = require('./constants.js');
+let _stryke_string_format_kebab_case = require("@stryke/string-format/kebab-case");
 let _stryke_string_format_title_case = require("@stryke/string-format/title-case");
 let _stryke_type_checks_is_error = require("@stryke/type-checks/is-error");
 let _stryke_type_checks_is_set_object = require("@stryke/type-checks/is-set-object");
@@ -22,7 +23,6 @@ let _stryke_env_environment_checks = require("@stryke/env/environment-checks");
 let _stryke_env_get_env_paths = require("@stryke/env/get-env-paths");
 let _stryke_fs_exists = require("@stryke/fs/exists");
 let _stryke_path_join_paths = require("@stryke/path/join-paths");
-let _stryke_string_format_kebab_case = require("@stryke/string-format/kebab-case");
 let _stryke_type_checks_is_set_string = require("@stryke/type-checks/is-set-string");
 let node_fs_promises = require("node:fs/promises");
 let nx_src_config_nx_json_js = require("nx/src/config/nx-json.js");

package/dist/src/helpers/plugin-utilities.mjs

@@ -7,6 +7,7 @@ const __TSDOWN_SHIM_FILENAME__ = /* @__PURE__ */ __tsdown_shims_url.fileURLToPat
 const __TSDOWN_SHIM_DIRNAME__ = /* @__PURE__ */ __tsdown_shims_path.dirname(__TSDOWN_SHIM_FILENAME__)
 
 import { CONFIG_INPUTS } from "./constants.mjs";
+import { kebabCase } from "@stryke/string-format/kebab-case";
 import { titleCase } from "@stryke/string-format/title-case";
 import { isError } from "@stryke/type-checks/is-error";
 import { isSetObject } from "@stryke/type-checks/is-set-object";
@@ -19,7 +20,6 @@ import { isDevelopment } from "@stryke/env/environment-checks";
 import { getEnvPaths } from "@stryke/env/get-env-paths";
 import { existsSync } from "@stryke/fs/exists";
 import { joinPaths } from "@stryke/path/join-paths";
-import { kebabCase } from "@stryke/string-format/kebab-case";
 import { isSetString } from "@stryke/type-checks/is-set-string";
 import { readFile } from "node:fs/promises";
 import { readNxJson } from "nx/src/config/nx-json.js";

package/dist/src/index.d.mts

@@ -1,7 +1,7 @@
 import __tsdown_shims_path from 'node:path';
 import __tsdown_shims_url from 'node:url';
-import { PowerlinesExecutorApi, PowerlinesExecutorContext, withExecutor } from "./base/base-executor.mjs";
+import { PowerlinesExecutorApi, PowerlinesExecutorContext, WithExecutorOptions, withExecutor } from "./base/base-executor.mjs";
 import { CONFIG_INPUTS } from "./helpers/constants.mjs";
 import { NxPluginOptions } from "./types/plugin.mjs";
 import { CreateNxPluginOptions, createNxPlugin, getNxPluginInputs, getNxTargetInputs } from "./helpers/plugin-utilities.mjs";
-export { CONFIG_INPUTS, CreateNxPluginOptions, NxPluginOptions, PowerlinesExecutorApi, PowerlinesExecutorContext, createNxPlugin, getNxPluginInputs, getNxTargetInputs, withExecutor };
+export { CONFIG_INPUTS, CreateNxPluginOptions, NxPluginOptions, PowerlinesExecutorApi, PowerlinesExecutorContext, WithExecutorOptions, createNxPlugin, getNxPluginInputs, getNxTargetInputs, withExecutor };

package/dist/src/index.d.ts

@@ -1,5 +1,5 @@
-import { PowerlinesExecutorApi, PowerlinesExecutorContext, withExecutor } from "./base/base-executor.js";
+import { PowerlinesExecutorApi, PowerlinesExecutorContext, WithExecutorOptions, withExecutor } from "./base/base-executor.js";
 import { CONFIG_INPUTS } from "./helpers/constants.js";
 import { NxPluginOptions } from "./types/plugin.js";
 import { CreateNxPluginOptions, createNxPlugin, getNxPluginInputs, getNxTargetInputs } from "./helpers/plugin-utilities.js";
-export { CONFIG_INPUTS, CreateNxPluginOptions, NxPluginOptions, PowerlinesExecutorApi, PowerlinesExecutorContext, createNxPlugin, getNxPluginInputs, getNxTargetInputs, withExecutor };
+export { CONFIG_INPUTS, CreateNxPluginOptions, NxPluginOptions, PowerlinesExecutorApi, PowerlinesExecutorContext, WithExecutorOptions, createNxPlugin, getNxPluginInputs, getNxTargetInputs, withExecutor };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@powerlines/nx",
-  "version": "0.13.124",
+  "version": "0.13.126",
   "private": false,
   "description": "A Nx plugin to support Powerlines development in Nx monorepos.",
   "repository": {
@@ -174,10 +174,10 @@
   ],
   "dependencies": {
     "@nx/devkit": "^22.7.5",
-    "@storm-software/build-tools": "^0.158.195",
-    "@storm-software/config": "^1.137.67",
-    "@storm-software/config-tools": "^1.190.35",
-    "@storm-software/workspace-tools": "^1.296.13",
+    "@storm-software/build-tools": "^0.158.196",
+    "@storm-software/config": "^1.137.68",
+    "@storm-software/config-tools": "^1.190.36",
+    "@storm-software/workspace-tools": "^1.296.14",
     "@stryke/env": "^0.20.96",
     "@stryke/fs": "^0.33.79",
     "@stryke/hash": "^0.13.32",
@@ -187,13 +187,13 @@
     "@stryke/type-checks": "^0.6.12",
     "defu": "^6.1.7",
     "jiti": "^2.7.0",
-    "powerlines": "^0.47.86"
+    "powerlines": "^0.47.88"
   },
   "devDependencies": {
     "@nx/workspace": "22.7.5",
-    "@storm-software/testing-tools": "^1.119.188",
-    "@storm-software/tsup": "^0.2.193",
-    "@storm-software/untyped": "^0.24.177",
+    "@storm-software/testing-tools": "^1.119.189",
+    "@storm-software/tsup": "^0.2.194",
+    "@storm-software/untyped": "^0.24.178",
     "@stryke/types": "^0.12.7",
     "@types/node": "^25.9.1",
     "eslint-flat-config-utils": "^2.1.4",
@@ -206,5 +206,5 @@
   "publishConfig": { "access": "public" },
   "executors": "./executors.json",
   "generators": "./generators.json",
-  "gitHead": "2a7208605db4b9d25c7e6462fe44deb0284e3b8c"
+  "gitHead": "8712f695515d4d33d5bcfe8c460580d83f321c0e"
 }

package/dist/src/base-executor-0AtMZrSx.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"base-executor-0AtMZrSx.mjs","names":[],"sources":["../../src/base/base-executor.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 { ExecutorContext, PromiseExecutor } from \"@nx/devkit\";\nimport { writeError } from \"@storm-software/config-tools/logger\";\nimport { StormWorkspaceConfig } from \"@storm-software/config/types\";\nimport { withRunExecutor } from \"@storm-software/workspace-tools/base/base-executor\";\nimport { BaseExecutorResult } from \"@storm-software/workspace-tools/types\";\nimport { omit } from \"@stryke/helpers/omit\";\nimport { joinPaths } from \"@stryke/path/join\";\nimport { titleCase } from \"@stryke/string-format/title-case\";\nimport { isError } from \"@stryke/type-checks/is-error\";\nimport { isSet } from \"@stryke/type-checks/is-set\";\nimport { isSetArray } from \"@stryke/type-checks/is-set-array\";\nimport { isSetObject } from \"@stryke/type-checks/is-set-object\";\nimport type { DeepPartial } from \"@stryke/types/base\";\nimport defu from \"defu\";\nimport { createJiti } from \"jiti\";\nimport type {\n  ExecutionApiParams,\n  ExecutionOptions,\n  InlineConfig,\n  Mode,\n  OutputConfig\n} from \"powerlines\";\nimport { BaseExecutorSchema } from \"./base-executor.schema\";\n\nexport type PowerlinesExecutorContext<\n  TExecutorSchema extends BaseExecutorSchema = BaseExecutorSchema\n> = ExecutorContext & {\n  projectName: string;\n  command: string;\n  options: TExecutorSchema;\n  inlineConfig: InlineConfig;\n  workspaceConfig: StormWorkspaceConfig;\n};\n\nexport type PowerlinesExecutorApi = (\n  inlineConfig: InlineConfig\n) => Promise<void>;\n\n/**\n * A utility function to create a Powerlines executor that can be used with the `withRunExecutor` function.\n *\n * @remarks\n * This function is designed to simplify the creation of Powerlines executors by providing a consistent interface and error handling.\n *\n * @param command - The command that the executor will handle (e.g., \"new\", \"prepare\", \"build\", etc.).\n * @param executorFn - The function that will be executed when the command is run.\n * @param defaultOptions - Default options to be merged with the execution options.\n * @returns A Promise that resolves to the result of the executor function.\n */\nexport function withExecutor<\n  TExecutorSchema extends BaseExecutorSchema = BaseExecutorSchema\n>(\n  command: string,\n  executorFn: (\n    context: PowerlinesExecutorContext<TExecutorSchema>,\n    api: PowerlinesExecutorApi\n  ) =>\n    | Promise<BaseExecutorResult | null | undefined>\n    | BaseExecutorResult\n    | null\n    | undefined,\n  defaultOptions: DeepPartial<ExecutionOptions> = {}\n): PromiseExecutor<TExecutorSchema> {\n  return withRunExecutor(\n    `Powerlines - ${titleCase(command)} executor`,\n    async (\n      options: TExecutorSchema,\n      context: ExecutorContext,\n      workspaceConfig: StormWorkspaceConfig\n    ): Promise<BaseExecutorResult | null | undefined> => {\n      if (!context.projectName) {\n        throw new Error(\n          `The Powerlines - ${titleCase(command)} executor requires \\`projectName\\` on the context object.`\n        );\n      }\n\n      if (\n        !context.projectName ||\n        !context.projectsConfigurations?.projects ||\n        !context.projectsConfigurations.projects[context.projectName] ||\n        !context.projectsConfigurations.projects[context.projectName]?.root\n      ) {\n        throw new Error(\n          `The Powerlines - ${titleCase(command)} executor requires \\`projectsConfigurations\\` on the context object.`\n        );\n      }\n\n      const projectConfig =\n        context.projectsConfigurations.projects[context.projectName]!;\n\n      const jiti = createJiti(context.root, {\n        cache: false,\n        tsconfigPaths: true\n      });\n      const api = await jiti\n        .import<{\n          default: (params: ExecutionApiParams) => Promise<void>;\n        }>(jiti.esmResolve(\"powerlines/api\"))\n        .then(mod => mod.default);\n\n      try {\n        return await Promise.resolve(\n          executorFn(\n            defu(\n              {\n                projectName: context.projectName,\n                options,\n                workspaceConfig,\n                command,\n                inlineConfig: defu(\n                  {\n                    name: context.projectName,\n                    command,\n                    root: projectConfig.root,\n                    configFile: options.configFile || options.config,\n                    configIndex: options.configIndex,\n                    projectType: projectConfig.projectType,\n                    mode: options.mode as Mode,\n                    output: {\n                      path: options.outputPath,\n                      copy:\n                        options.copyPath === false\n                          ? false\n                          : {\n                              path: options.copyPath,\n                              assets: options.assets\n                            },\n                      minify: options.minify,\n                      sourceMap: options.sourceMap\n                    } as OutputConfig,\n                    resolve:\n                      isSetArray(options.external) ||\n                      isSetArray(options.noExternal) ||\n                      isSet(options.skipNodeModulesBundle)\n                        ? {\n                            external: isSetArray(options.external)\n                              ? options.external\n                              : undefined,\n                            noExternal: isSetArray(options.noExternal)\n                              ? options.noExternal\n                              : undefined,\n                            skipNodeModulesBundle: isSet(\n                              options.skipNodeModulesBundle\n                            )\n                              ? options.skipNodeModulesBundle\n                              : undefined\n                          }\n                        : undefined,\n                    define: isSetObject(options.define)\n                      ? options.define\n                      : undefined,\n                    assets: isSetObject(options.assets)\n                      ? options.assets\n                      : undefined\n                  },\n                  omit(options, [\n                    \"config\",\n                    \"configFile\",\n                    \"outputPath\",\n                    \"copyPath\",\n                    \"sourceMap\",\n                    \"minify\",\n                    \"format\",\n                    \"external\",\n                    \"noExternal\",\n                    \"skipNodeModulesBundle\",\n                    \"mode\",\n                    \"define\",\n                    \"assets\"\n                  ])\n                ) as InlineConfig\n              },\n              context\n            ),\n            async (inlineConfig: InlineConfig) =>\n              api({\n                // eslint-disable-next-line ts/no-unnecessary-type-assertion\n                options: defu(defaultOptions, {\n                  executionId: `${context.projectName}-${command}-${options.configIndex}`,\n                  cwd: context.root,\n                  root: projectConfig.root,\n                  configFile:\n                    options.configFile ||\n                    options.config ||\n                    joinPaths(projectConfig.root, \"powerlines.config.ts\"),\n                  configIndex: options.configIndex,\n                  framework: {\n                    name: \"powerlines\",\n                    orgId: \"storm-software\"\n                  }\n                }) as ExecutionOptions,\n                command,\n                inlineConfig\n              })\n          )\n        );\n      } catch (error) {\n        writeError(\n          `An error occurred while executing the Powerlines - ${titleCase(\n            command\n          )} executor: ${\n            isError(error)\n              ? `${error.message}\n\n${error.stack}`\n              : \"Unknown error\"\n          }`\n        );\n\n        return { success: false };\n      }\n    },\n    {\n      skipReadingConfig: false,\n      hooks: {\n        applyDefaultOptions: (options: Partial<TExecutorSchema>) => {\n          options.copyPath ??= \"dist/{projectRoot}\";\n\n          return options as TExecutorSchema;\n        }\n      }\n    }\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;AAmEA,SAAgB,aAGd,SACA,YAQA,iBAAgD,CAAC,GACf;CAClC,OAAO,gBACL,gBAAgB,UAAU,OAAO,EAAE,YACnC,OACE,SACA,SACA,oBACmD;EACnD,IAAI,CAAC,QAAQ,aACX,MAAM,IAAI,MACR,oBAAoB,UAAU,OAAO,EAAE,0DACzC;EAGF,IACE,CAAC,QAAQ,eACT,CAAC,QAAQ,wBAAwB,YACjC,CAAC,QAAQ,uBAAuB,SAAS,QAAQ,gBACjD,CAAC,QAAQ,uBAAuB,SAAS,QAAQ,cAAc,MAE/D,MAAM,IAAI,MACR,oBAAoB,UAAU,OAAO,EAAE,qEACzC;EAGF,MAAM,gBACJ,QAAQ,uBAAuB,SAAS,QAAQ;EAElD,MAAM,OAAO,WAAW,QAAQ,MAAM;GACpC,OAAO;GACP,eAAe;EACjB,CAAC;EACD,MAAM,MAAM,MAAM,KACf,OAEE,KAAK,WAAW,gBAAgB,CAAC,EACnC,MAAK,QAAO,IAAI,OAAO;EAE1B,IAAI;GACF,OAAO,MAAM,QAAQ,QACnB,WACE,KACE;IACE,aAAa,QAAQ;IACrB;IACA;IACA;IACA,cAAc,KACZ;KACE,MAAM,QAAQ;KACd;KACA,MAAM,cAAc;KACpB,YAAY,QAAQ,cAAc,QAAQ;KAC1C,aAAa,QAAQ;KACrB,aAAa,cAAc;KAC3B,MAAM,QAAQ;KACd,QAAQ;MACN,MAAM,QAAQ;MACd,MACE,QAAQ,aAAa,QACjB,QACA;OACE,MAAM,QAAQ;OACd,QAAQ,QAAQ;MAClB;MACN,QAAQ,QAAQ;MAChB,WAAW,QAAQ;KACrB;KACA,SACE,WAAW,QAAQ,QAAQ,KAC3B,WAAW,QAAQ,UAAU,KAC7B,MAAM,QAAQ,qBAAqB,IAC/B;MACE,UAAU,WAAW,QAAQ,QAAQ,IACjC,QAAQ,WACR;MACJ,YAAY,WAAW,QAAQ,UAAU,IACrC,QAAQ,aACR;MACJ,uBAAuB,MACrB,QAAQ,qBACV,IACI,QAAQ,wBACR;KACN,IACA;KACN,QAAQ,YAAY,QAAQ,MAAM,IAC9B,QAAQ,SACR;KACJ,QAAQ,YAAY,QAAQ,MAAM,IAC9B,QAAQ,SACR;IACN,GACA,KAAK,SAAS;KACZ;KACA;KACA;KACA;KACA;KACA;KACA;KACA;KACA;KACA;KACA;KACA;KACA;IACF,CAAC,CACH;GACF,GACA,OACF,GACA,OAAO,iBACL,IAAI;IAEF,SAAS,KAAK,gBAAgB;KAC5B,aAAa,GAAG,QAAQ,YAAY,GAAG,QAAQ,GAAG,QAAQ;KAC1D,KAAK,QAAQ;KACb,MAAM,cAAc;KACpB,YACE,QAAQ,cACR,QAAQ,UACR,UAAU,cAAc,MAAM,sBAAsB;KACtD,aAAa,QAAQ;KACrB,WAAW;MACT,MAAM;MACN,OAAO;KACT;IACF,CAAC;IACD;IACA;GACF,CAAC,CACL,CACF;EACF,SAAS,OAAO;GACd,WACE,sDAAsD,UACpD,OACF,EAAE,aACA,QAAQ,KAAK,IACT,GAAG,MAAM,QAAQ;;EAE/B,MAAM,UACQ,iBAER;GAEA,OAAO,EAAE,SAAS,MAAM;EAC1B;CACF,GACA;EACE,mBAAmB;EACnB,OAAO,EACL,sBAAsB,YAAsC;GAC1D,QAAQ,aAAa;GAErB,OAAO;EACT,EACF;CACF,CACF;AACF"}