@powerlines/engine 0.44.11 → 0.45.0

package/dist/index.cjs

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const require_chunk = require('./chunk-C0xms8kb.cjs');
-const require_engine_context = require('./engine-context-D1_U6xVC.cjs');
+const require_engine_context = require('./engine-context-CI_0NWIk.cjs');
 let _powerlines_core_constants = require("@powerlines/core/constants");
 let _stryke_convert_to_array = require("@stryke/convert/to-array");
 let _stryke_fs_resolve = require("@stryke/fs/resolve");
@@ -410,10 +410,11 @@ var PowerlinesEngine = class PowerlinesEngine {
 	* Create a new Powerlines Engine instance
 	*
 	* @param options - The options to initialize the context with
+	* @param initialConfig - The initial configuration for the context, which can be used to provide additional context or override certain configuration values during initialization. This is particularly useful when initializing the context from a CLI command, where the CLI flags can be passed as part of the initial configuration to ensure they are properly merged with the configuration file and made available to plugins during their setup and execution.
 	* @returns A new instance of the Powerlines Engine
 	*/
-	static async fromOptions(options) {
-		const api = new PowerlinesEngine(await require_engine_context.PowerlinesEngineContext.fromOptions(options));
+	static async init(options, initialConfig = {}) {
+		const api = new PowerlinesEngine(await require_engine_context.PowerlinesEngineContext.init(options, initialConfig));
 		const packagePath = await (0, _stryke_fs_resolve.resolvePackage)("@powerlines/engine");
 		if (!packagePath) throw new Error("Could not resolve `@powerlines/engine` package location.");
 		api.#worker = new Worker((0, _stryke_path_join.joinPaths)(packagePath, "./_internal/worker.mjs"), {
@@ -431,14 +432,6 @@ var PowerlinesEngine = class PowerlinesEngine {
 		return this.#context;
 	}
 	/**
-	* Create a new Powerlines Engine instance
-	*
-	* @param context - The Powerlines context
-	*/
-	constructor(context) {
-		this.#context = context;
-	}
-	/**
 	* Generate the Powerlines typescript declaration file
 	*
 	* @remarks
@@ -453,7 +446,8 @@ var PowerlinesEngine = class PowerlinesEngine {
 		inlineConfig.command ??= "types";
 		await Promise.all(this.#context.executions.map(async (execution) => this.#worker.types({
 			options: execution.options,
-			config: inlineConfig
+			initialConfig: this.#context.initialConfig,
+			inlineConfig
 		})));
 		this.context.debug("✔ Powerlines types generation has completed successfully");
 		timer();
@@ -473,7 +467,8 @@ var PowerlinesEngine = class PowerlinesEngine {
 		inlineConfig.command ??= "prepare";
 		await Promise.all(this.#context.executions.map(async (execution) => this.#worker.prepare({
 			options: execution.options,
-			config: inlineConfig
+			initialConfig: this.#context.initialConfig,
+			inlineConfig
 		})));
 		this.context.debug("✔ Powerlines preparation has completed successfully");
 		timer();
@@ -493,7 +488,8 @@ var PowerlinesEngine = class PowerlinesEngine {
 		inlineConfig.command ??= "new";
 		await Promise.all(this.#context.executions.map(async (execution) => this.#worker.new({
 			options: execution.options,
-			config: inlineConfig
+			initialConfig: this.#context.initialConfig,
+			inlineConfig
 		})));
 		this.context.debug("✔ Powerlines new command completed successfully");
 		timer();
@@ -513,7 +509,8 @@ var PowerlinesEngine = class PowerlinesEngine {
 		inlineConfig.command ??= "clean";
 		await Promise.all(this.#context.executions.map(async (execution) => this.#worker.clean({
 			options: execution.options,
-			config: inlineConfig
+			initialConfig: this.#context.initialConfig,
+			inlineConfig
 		})));
 		this.context.debug("✔ Powerlines cleaning completed successfully");
 		timer();
@@ -530,7 +527,8 @@ var PowerlinesEngine = class PowerlinesEngine {
 		inlineConfig.command ??= "lint";
 		await Promise.all(this.#context.executions.map(async (execution) => this.#worker.lint({
 			options: execution.options,
-			config: inlineConfig
+			initialConfig: this.#context.initialConfig,
+			inlineConfig
 		})));
 		this.context.debug("✔ Powerlines linting completed successfully");
 		timer();
@@ -550,7 +548,8 @@ var PowerlinesEngine = class PowerlinesEngine {
 		inlineConfig.command ??= "test";
 		await Promise.all(this.#context.executions.map(async (execution) => this.#worker.test({
 			options: execution.options,
-			config: inlineConfig
+			initialConfig: this.#context.initialConfig,
+			inlineConfig
 		})));
 		this.context.debug("✔ Powerlines testing completed successfully");
 		timer();
@@ -569,7 +568,8 @@ var PowerlinesEngine = class PowerlinesEngine {
 		this.context.info("📦 Building the Powerlines project");
 		await Promise.all(this.#context.executions.map(async (execution) => this.#worker.build({
 			options: execution.options,
-			config: inlineConfig
+			initialConfig: this.#context.initialConfig,
+			inlineConfig
 		})));
 		this.context.debug("✔ Powerlines build completed successfully");
 		timer();
@@ -586,7 +586,8 @@ var PowerlinesEngine = class PowerlinesEngine {
 		inlineConfig.command ??= "docs";
 		await Promise.all(this.#context.executions.map(async (execution) => this.#worker.docs({
 			options: execution.options,
-			config: inlineConfig
+			initialConfig: this.#context.initialConfig,
+			inlineConfig
 		})));
 		this.context.debug("✔ Powerlines documentation generation completed successfully");
 		timer();
@@ -605,7 +606,8 @@ var PowerlinesEngine = class PowerlinesEngine {
 		inlineConfig.command ??= "deploy";
 		await Promise.all(this.#context.executions.map(async (execution) => this.#worker.deploy({
 			options: execution.options,
-			config: inlineConfig
+			initialConfig: this.#context.initialConfig,
+			inlineConfig
 		})));
 		this.context.debug("✔ Powerlines deploy completed successfully");
 		timer();
@@ -632,6 +634,14 @@ var PowerlinesEngine = class PowerlinesEngine {
 		return this.finalize();
 	}
 	/**
+	* Create a new Powerlines Engine instance
+	*
+	* @param context - The Powerlines context
+	*/
+	constructor(context) {
+		this.#context = context;
+	}
+	/**
 	* Handle incoming IPC messages from the worker processes, routing them to the appropriate handlers based on the message type.
 	*
 	* @param message - The IPC message received from a worker process

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-import { BuildInlineConfig, CleanInlineConfig, DeployInlineConfig, DocsInlineConfig, Engine, EngineContext, EngineOptions, LintInlineConfig, NewInlineConfig, PrepareInlineConfig, TestInlineConfig, TypesInlineConfig } from "@powerlines/core";
+import { BuildInlineConfig, CleanInlineConfig, DeployInlineConfig, DocsInlineConfig, Engine, EngineContext, EngineOptions, InitialConfig, LintInlineConfig, NewInlineConfig, PrepareInlineConfig, TestInlineConfig, TypesInlineConfig } from "@powerlines/core";
 import { PartialKeys } from "@stryke/types/base";
 
 //#region src/index.d.ts
@@ -16,19 +16,14 @@ declare class PowerlinesEngine implements Engine, AsyncDisposable {
    * Create a new Powerlines Engine instance
    *
    * @param options - The options to initialize the context with
+   * @param initialConfig - The initial configuration for the context, which can be used to provide additional context or override certain configuration values during initialization. This is particularly useful when initializing the context from a CLI command, where the CLI flags can be passed as part of the initial configuration to ensure they are properly merged with the configuration file and made available to plugins during their setup and execution.
    * @returns A new instance of the Powerlines Engine
    */
-  static fromOptions(options: EngineOptions): Promise<PowerlinesEngine>;
+  static init(options: EngineOptions, initialConfig?: InitialConfig<any>): Promise<PowerlinesEngine>;
   /**
    * The Powerlines context
    */
   get context(): EngineContext;
-  /**
-   * Create a new Powerlines Engine instance
-   *
-   * @param context - The Powerlines context
-   */
-  protected constructor(context: EngineContext);
   /**
    * Generate the Powerlines typescript declaration file
    *
@@ -123,6 +118,12 @@ declare class PowerlinesEngine implements Engine, AsyncDisposable {
    * Asynchronous disposal method for the Powerlines Engine, which will call the finalize method to perform any necessary cleanup when the engine is disposed of.
    */
   [Symbol.asyncDispose](): Promise<void>;
+  /**
+   * Create a new Powerlines Engine instance
+   *
+   * @param context - The Powerlines context
+   */
+  protected constructor(context: EngineContext);
   /**
    * Handle incoming IPC messages from the worker processes, routing them to the appropriate handlers based on the message type.
    *

package/dist/index.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.cts","names":[],"sources":["../src/index.ts"],"mappings":";;;;;;AA+DA;;;;;;cAAa,gBAAA,YAA4B,MAAA,EAAQ,eAAA;EAAA;EAmEtC;;;;;;EAAA,OAlDW,WAAA,CAClB,OAAA,EAAS,aAAA,GACR,OAAA,CAAQ,gBAAA;EA0FY;;;EAAA,IAjEZ,OAAA,CAAA,GAAW,aAAA;EAkEJ;;;;;EAAA,UAzDT,WAAA,CAAa,OAAA,EAAS,aAAA;EA2Db;;;;;;;;EA/CL,KAAA,CACX,YAAA,GAAc,WAAA,CACZ,IAAA,CAAK,iBAAA,8BAIN,OAAA;EA4Ce;;;;;;;;EATL,OAAA,CACX,YAAA,GACI,WAAA,CAAY,IAAA,CAAK,mBAAA,8BACjB,WAAA,CAAY,IAAA,CAAK,iBAAA,8BACjB,WAAA,CAAY,IAAA,CAAK,eAAA,8BACjB,WAAA,CAAY,IAAA,CAAK,iBAAA,8BACjB,WAAA,CAAY,IAAA,CAAK,iBAAA,8BACjB,WAAA,CAAY,IAAA,CAAK,gBAAA,8BACjB,WAAA,CAAY,IAAA,CAAK,gBAAA,8BACjB,WAAA,CAAY,IAAA,CAAK,kBAAA,8BAEpB,OAAA;EA8DoB;;;;;;;;;EA9BV,GAAA,CAAI,YAAA,EAAc,WAAA,CAAY,eAAA,eAA2B,OAAA;EA8DnE;;;;;;;;;EAnCU,KAAA,CACX,YAAA,GACI,WAAA,CAAY,IAAA,CAAK,iBAAA,8BACjB,WAAA,CAAY,IAAA,CAAK,mBAAA,8BAEpB,OAAA;EA4Fa;;;;;;EAnEH,IAAA,CACX,YAAA,GACI,WAAA,CAAY,IAAA,CAAK,gBAAA,8BACjB,WAAA,CAAY,IAAA,CAAK,iBAAA,8BAEpB,OAAA;EAiIC;;;;;;;;;EArGS,IAAA,CACX,YAAA,GACI,WAAA,CAAY,IAAA,CAAK,gBAAA,8BACjB,WAAA,CAAY,IAAA,CAAK,iBAAA,8BAEpB,OAAA;EApPoC;;;;;;;;;EAgR1B,KAAA,CACX,YAAA,GAAc,WAAA,CACZ,IAAA,CAAK,iBAAA,8BAIN,OAAA;EAjOM;;;;;;EAyPI,IAAA,CACX,YAAA,GAAc,WAAA,CACZ,IAAA,CAAK,gBAAA,8BAIN,OAAA;EAlPD;;;;;;;;EAgRW,MAAA,CACX,YAAA,GAAc,WAAA,CACZ,IAAA,CAAK,kBAAA,8BAIN,OAAA;EA1OG;;;;;;;;EAsQO,QAAA,CAAA,GAAQ,OAAA;EAnQf;;;EAAA,CAgRQ,MAAA,CAAO,YAAA,KAAa,OAAA;EA/QhB;;;;;EAAA,QAwRJ,gBAAA;EAAA,QAuGA,cAAA;EAAA,QAsBA,kBAAA;EAAA,QAEA,gBAAA;EAAA,QAEA,mBAAA;AAAA"}
+{"version":3,"file":"index.d.cts","names":[],"sources":["../src/index.ts"],"mappings":";;;;;;AAgEA;;;;;;cAAa,gBAAA,YAA4B,MAAA,EAAQ,eAAA;EAAA;EA4DtC;;;;;;;EAAA,OA1CW,IAAA,CAClB,OAAA,EAAS,aAAA,EACT,aAAA,GAAe,aAAA,QACd,OAAA,CAAQ,gBAAA;EAkFO;;;EAAA,IAzDP,OAAA,CAAA,GAAW,aAAA;EA0DhB;;;;;;;;EA9CO,KAAA,CACX,YAAA,GAAc,WAAA,CACZ,IAAA,CAAK,iBAAA,8BAIN,OAAA;EA2CG;;;;;;;;EAPO,OAAA,CACX,YAAA,GACI,WAAA,CAAY,IAAA,CAAK,mBAAA,8BACjB,WAAA,CAAY,IAAA,CAAK,iBAAA,8BACjB,WAAA,CAAY,IAAA,CAAK,eAAA,8BACjB,WAAA,CAAY,IAAA,CAAK,iBAAA,8BACjB,WAAA,CAAY,IAAA,CAAK,iBAAA,8BACjB,WAAA,CAAY,IAAA,CAAK,gBAAA,8BACjB,WAAA,CAAY,IAAA,CAAK,gBAAA,8BACjB,WAAA,CAAY,IAAA,CAAK,kBAAA,8BAEpB,OAAA;EAiC4B;;;;;;;;;EAAlB,GAAA,CAAI,YAAA,EAAc,WAAA,CAAY,eAAA,eAA2B,OAAA;EA6DpD;;;;;;;;;EAjCL,KAAA,CACX,YAAA,GACI,WAAA,CAAY,IAAA,CAAK,iBAAA,8BACjB,WAAA,CAAY,IAAA,CAAK,mBAAA,8BAEpB,OAAA;EA+De;;;;;;EArCL,IAAA,CACX,YAAA,GACI,WAAA,CAAY,IAAA,CAAK,gBAAA,8BACjB,WAAA,CAAY,IAAA,CAAK,iBAAA,8BAEpB,OAAA;EAgGM;;;;;;;;;EAnEI,IAAA,CACX,YAAA,GACI,WAAA,CAAY,IAAA,CAAK,gBAAA,8BACjB,WAAA,CAAY,IAAA,CAAK,iBAAA,8BAEpB,OAAA;EAiJW;;;;;;;;;EApHD,KAAA,CACX,YAAA,GAAc,WAAA,CACZ,IAAA,CAAK,iBAAA,8BAIN,OAAA;EAlQQ;;;;;;EA2RE,IAAA,CACX,YAAA,GAAc,WAAA,CACZ,IAAA,CAAK,gBAAA,8BAIN,OAAA;EAtQmB;;;;;;;;EAqST,MAAA,CACX,YAAA,GAAc,WAAA,CACZ,IAAA,CAAK,kBAAA,8BAIN,OAAA;EAnPe;;;;;;;;EAgRL,QAAA,CAAA,GAAQ,OAAA;EA7QH;;;EAAA,CA0RJ,MAAA,CAAO,YAAA,KAAa,OAAA;EAzRX;;;;;EAAA,UAkSd,WAAA,CAAa,OAAA,EAAS,aAAA;EAhSR;;;;;EAAA,QAyST,gBAAA;EAAA,QAuGA,cAAA;EAAA,QAsBA,kBAAA;EAAA,QAEA,gBAAA;EAAA,QAEA,mBAAA;AAAA"}

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-import { BuildInlineConfig, CleanInlineConfig, DeployInlineConfig, DocsInlineConfig, Engine, EngineContext, EngineOptions, LintInlineConfig, NewInlineConfig, PrepareInlineConfig, TestInlineConfig, TypesInlineConfig } from "@powerlines/core";
+import { BuildInlineConfig, CleanInlineConfig, DeployInlineConfig, DocsInlineConfig, Engine, EngineContext, EngineOptions, InitialConfig, LintInlineConfig, NewInlineConfig, PrepareInlineConfig, TestInlineConfig, TypesInlineConfig } from "@powerlines/core";
 import { PartialKeys } from "@stryke/types/base";
 
 //#region src/index.d.ts
@@ -16,19 +16,14 @@ declare class PowerlinesEngine implements Engine, AsyncDisposable {
    * Create a new Powerlines Engine instance
    *
    * @param options - The options to initialize the context with
+   * @param initialConfig - The initial configuration for the context, which can be used to provide additional context or override certain configuration values during initialization. This is particularly useful when initializing the context from a CLI command, where the CLI flags can be passed as part of the initial configuration to ensure they are properly merged with the configuration file and made available to plugins during their setup and execution.
    * @returns A new instance of the Powerlines Engine
    */
-  static fromOptions(options: EngineOptions): Promise<PowerlinesEngine>;
+  static init(options: EngineOptions, initialConfig?: InitialConfig<any>): Promise<PowerlinesEngine>;
   /**
    * The Powerlines context
    */
   get context(): EngineContext;
-  /**
-   * Create a new Powerlines Engine instance
-   *
-   * @param context - The Powerlines context
-   */
-  protected constructor(context: EngineContext);
   /**
    * Generate the Powerlines typescript declaration file
    *
@@ -123,6 +118,12 @@ declare class PowerlinesEngine implements Engine, AsyncDisposable {
    * Asynchronous disposal method for the Powerlines Engine, which will call the finalize method to perform any necessary cleanup when the engine is disposed of.
    */
   [Symbol.asyncDispose](): Promise<void>;
+  /**
+   * Create a new Powerlines Engine instance
+   *
+   * @param context - The Powerlines context
+   */
+  protected constructor(context: EngineContext);
   /**
    * Handle incoming IPC messages from the worker processes, routing them to the appropriate handlers based on the message type.
    *

package/dist/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../src/index.ts"],"mappings":";;;;;;AA+DA;;;;;;cAAa,gBAAA,YAA4B,MAAA,EAAQ,eAAA;EAAA;EAmEtC;;;;;;EAAA,OAlDW,WAAA,CAClB,OAAA,EAAS,aAAA,GACR,OAAA,CAAQ,gBAAA;EA0FY;;;EAAA,IAjEZ,OAAA,CAAA,GAAW,aAAA;EAkEJ;;;;;EAAA,UAzDT,WAAA,CAAa,OAAA,EAAS,aAAA;EA2Db;;;;;;;;EA/CL,KAAA,CACX,YAAA,GAAc,WAAA,CACZ,IAAA,CAAK,iBAAA,8BAIN,OAAA;EA4Ce;;;;;;;;EATL,OAAA,CACX,YAAA,GACI,WAAA,CAAY,IAAA,CAAK,mBAAA,8BACjB,WAAA,CAAY,IAAA,CAAK,iBAAA,8BACjB,WAAA,CAAY,IAAA,CAAK,eAAA,8BACjB,WAAA,CAAY,IAAA,CAAK,iBAAA,8BACjB,WAAA,CAAY,IAAA,CAAK,iBAAA,8BACjB,WAAA,CAAY,IAAA,CAAK,gBAAA,8BACjB,WAAA,CAAY,IAAA,CAAK,gBAAA,8BACjB,WAAA,CAAY,IAAA,CAAK,kBAAA,8BAEpB,OAAA;EA8DoB;;;;;;;;;EA9BV,GAAA,CAAI,YAAA,EAAc,WAAA,CAAY,eAAA,eAA2B,OAAA;EA8DnE;;;;;;;;;EAnCU,KAAA,CACX,YAAA,GACI,WAAA,CAAY,IAAA,CAAK,iBAAA,8BACjB,WAAA,CAAY,IAAA,CAAK,mBAAA,8BAEpB,OAAA;EA4Fa;;;;;;EAnEH,IAAA,CACX,YAAA,GACI,WAAA,CAAY,IAAA,CAAK,gBAAA,8BACjB,WAAA,CAAY,IAAA,CAAK,iBAAA,8BAEpB,OAAA;EAiIC;;;;;;;;;EArGS,IAAA,CACX,YAAA,GACI,WAAA,CAAY,IAAA,CAAK,gBAAA,8BACjB,WAAA,CAAY,IAAA,CAAK,iBAAA,8BAEpB,OAAA;EApPoC;;;;;;;;;EAgR1B,KAAA,CACX,YAAA,GAAc,WAAA,CACZ,IAAA,CAAK,iBAAA,8BAIN,OAAA;EAjOM;;;;;;EAyPI,IAAA,CACX,YAAA,GAAc,WAAA,CACZ,IAAA,CAAK,gBAAA,8BAIN,OAAA;EAlPD;;;;;;;;EAgRW,MAAA,CACX,YAAA,GAAc,WAAA,CACZ,IAAA,CAAK,kBAAA,8BAIN,OAAA;EA1OG;;;;;;;;EAsQO,QAAA,CAAA,GAAQ,OAAA;EAnQf;;;EAAA,CAgRQ,MAAA,CAAO,YAAA,KAAa,OAAA;EA/QhB;;;;;EAAA,QAwRJ,gBAAA;EAAA,QAuGA,cAAA;EAAA,QAsBA,kBAAA;EAAA,QAEA,gBAAA;EAAA,QAEA,mBAAA;AAAA"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/index.ts"],"mappings":";;;;;;AAgEA;;;;;;cAAa,gBAAA,YAA4B,MAAA,EAAQ,eAAA;EAAA;EA4DtC;;;;;;;EAAA,OA1CW,IAAA,CAClB,OAAA,EAAS,aAAA,EACT,aAAA,GAAe,aAAA,QACd,OAAA,CAAQ,gBAAA;EAkFO;;;EAAA,IAzDP,OAAA,CAAA,GAAW,aAAA;EA0DhB;;;;;;;;EA9CO,KAAA,CACX,YAAA,GAAc,WAAA,CACZ,IAAA,CAAK,iBAAA,8BAIN,OAAA;EA2CG;;;;;;;;EAPO,OAAA,CACX,YAAA,GACI,WAAA,CAAY,IAAA,CAAK,mBAAA,8BACjB,WAAA,CAAY,IAAA,CAAK,iBAAA,8BACjB,WAAA,CAAY,IAAA,CAAK,eAAA,8BACjB,WAAA,CAAY,IAAA,CAAK,iBAAA,8BACjB,WAAA,CAAY,IAAA,CAAK,iBAAA,8BACjB,WAAA,CAAY,IAAA,CAAK,gBAAA,8BACjB,WAAA,CAAY,IAAA,CAAK,gBAAA,8BACjB,WAAA,CAAY,IAAA,CAAK,kBAAA,8BAEpB,OAAA;EAiC4B;;;;;;;;;EAAlB,GAAA,CAAI,YAAA,EAAc,WAAA,CAAY,eAAA,eAA2B,OAAA;EA6DpD;;;;;;;;;EAjCL,KAAA,CACX,YAAA,GACI,WAAA,CAAY,IAAA,CAAK,iBAAA,8BACjB,WAAA,CAAY,IAAA,CAAK,mBAAA,8BAEpB,OAAA;EA+De;;;;;;EArCL,IAAA,CACX,YAAA,GACI,WAAA,CAAY,IAAA,CAAK,gBAAA,8BACjB,WAAA,CAAY,IAAA,CAAK,iBAAA,8BAEpB,OAAA;EAgGM;;;;;;;;;EAnEI,IAAA,CACX,YAAA,GACI,WAAA,CAAY,IAAA,CAAK,gBAAA,8BACjB,WAAA,CAAY,IAAA,CAAK,iBAAA,8BAEpB,OAAA;EAiJW;;;;;;;;;EApHD,KAAA,CACX,YAAA,GAAc,WAAA,CACZ,IAAA,CAAK,iBAAA,8BAIN,OAAA;EAlQQ;;;;;;EA2RE,IAAA,CACX,YAAA,GAAc,WAAA,CACZ,IAAA,CAAK,gBAAA,8BAIN,OAAA;EAtQmB;;;;;;;;EAqST,MAAA,CACX,YAAA,GAAc,WAAA,CACZ,IAAA,CAAK,kBAAA,8BAIN,OAAA;EAnPe;;;;;;;;EAgRL,QAAA,CAAA,GAAQ,OAAA;EA7QH;;;EAAA,CA0RJ,MAAA,CAAO,YAAA,KAAa,OAAA;EAzRX;;;;;EAAA,UAkSd,WAAA,CAAa,OAAA,EAAS,aAAA;EAhSR;;;;;EAAA,QAyST,gBAAA;EAAA,QAuGA,cAAA;EAAA,QAsBA,kBAAA;EAAA,QAEA,gBAAA;EAAA,QAEA,mBAAA;AAAA"}

package/dist/index.mjs

@@ -1,4 +1,4 @@
-import { t as PowerlinesEngineContext } from "./engine-context-C-11i43N.mjs";
+import { t as PowerlinesEngineContext } from "./engine-context-_RMFwG4J.mjs";
 import { POWERLINES_API_FUNCTIONS } from "@powerlines/core/constants";
 import { toArray } from "@stryke/convert/to-array";
 import { resolvePackage } from "@stryke/fs/resolve";
@@ -408,10 +408,11 @@ var PowerlinesEngine = class PowerlinesEngine {
 	* Create a new Powerlines Engine instance
 	*
 	* @param options - The options to initialize the context with
+	* @param initialConfig - The initial configuration for the context, which can be used to provide additional context or override certain configuration values during initialization. This is particularly useful when initializing the context from a CLI command, where the CLI flags can be passed as part of the initial configuration to ensure they are properly merged with the configuration file and made available to plugins during their setup and execution.
 	* @returns A new instance of the Powerlines Engine
 	*/
-	static async fromOptions(options) {
-		const api = new PowerlinesEngine(await PowerlinesEngineContext.fromOptions(options));
+	static async init(options, initialConfig = {}) {
+		const api = new PowerlinesEngine(await PowerlinesEngineContext.init(options, initialConfig));
 		const packagePath = await resolvePackage("@powerlines/engine");
 		if (!packagePath) throw new Error("Could not resolve `@powerlines/engine` package location.");
 		api.#worker = new Worker$1(joinPaths(packagePath, "./_internal/worker.mjs"), {
@@ -429,14 +430,6 @@ var PowerlinesEngine = class PowerlinesEngine {
 		return this.#context;
 	}
 	/**
-	* Create a new Powerlines Engine instance
-	*
-	* @param context - The Powerlines context
-	*/
-	constructor(context) {
-		this.#context = context;
-	}
-	/**
 	* Generate the Powerlines typescript declaration file
 	*
 	* @remarks
@@ -451,7 +444,8 @@ var PowerlinesEngine = class PowerlinesEngine {
 		inlineConfig.command ??= "types";
 		await Promise.all(this.#context.executions.map(async (execution) => this.#worker.types({
 			options: execution.options,
-			config: inlineConfig
+			initialConfig: this.#context.initialConfig,
+			inlineConfig
 		})));
 		this.context.debug("✔ Powerlines types generation has completed successfully");
 		timer();
@@ -471,7 +465,8 @@ var PowerlinesEngine = class PowerlinesEngine {
 		inlineConfig.command ??= "prepare";
 		await Promise.all(this.#context.executions.map(async (execution) => this.#worker.prepare({
 			options: execution.options,
-			config: inlineConfig
+			initialConfig: this.#context.initialConfig,
+			inlineConfig
 		})));
 		this.context.debug("✔ Powerlines preparation has completed successfully");
 		timer();
@@ -491,7 +486,8 @@ var PowerlinesEngine = class PowerlinesEngine {
 		inlineConfig.command ??= "new";
 		await Promise.all(this.#context.executions.map(async (execution) => this.#worker.new({
 			options: execution.options,
-			config: inlineConfig
+			initialConfig: this.#context.initialConfig,
+			inlineConfig
 		})));
 		this.context.debug("✔ Powerlines new command completed successfully");
 		timer();
@@ -511,7 +507,8 @@ var PowerlinesEngine = class PowerlinesEngine {
 		inlineConfig.command ??= "clean";
 		await Promise.all(this.#context.executions.map(async (execution) => this.#worker.clean({
 			options: execution.options,
-			config: inlineConfig
+			initialConfig: this.#context.initialConfig,
+			inlineConfig
 		})));
 		this.context.debug("✔ Powerlines cleaning completed successfully");
 		timer();
@@ -528,7 +525,8 @@ var PowerlinesEngine = class PowerlinesEngine {
 		inlineConfig.command ??= "lint";
 		await Promise.all(this.#context.executions.map(async (execution) => this.#worker.lint({
 			options: execution.options,
-			config: inlineConfig
+			initialConfig: this.#context.initialConfig,
+			inlineConfig
 		})));
 		this.context.debug("✔ Powerlines linting completed successfully");
 		timer();
@@ -548,7 +546,8 @@ var PowerlinesEngine = class PowerlinesEngine {
 		inlineConfig.command ??= "test";
 		await Promise.all(this.#context.executions.map(async (execution) => this.#worker.test({
 			options: execution.options,
-			config: inlineConfig
+			initialConfig: this.#context.initialConfig,
+			inlineConfig
 		})));
 		this.context.debug("✔ Powerlines testing completed successfully");
 		timer();
@@ -567,7 +566,8 @@ var PowerlinesEngine = class PowerlinesEngine {
 		this.context.info("📦 Building the Powerlines project");
 		await Promise.all(this.#context.executions.map(async (execution) => this.#worker.build({
 			options: execution.options,
-			config: inlineConfig
+			initialConfig: this.#context.initialConfig,
+			inlineConfig
 		})));
 		this.context.debug("✔ Powerlines build completed successfully");
 		timer();
@@ -584,7 +584,8 @@ var PowerlinesEngine = class PowerlinesEngine {
 		inlineConfig.command ??= "docs";
 		await Promise.all(this.#context.executions.map(async (execution) => this.#worker.docs({
 			options: execution.options,
-			config: inlineConfig
+			initialConfig: this.#context.initialConfig,
+			inlineConfig
 		})));
 		this.context.debug("✔ Powerlines documentation generation completed successfully");
 		timer();
@@ -603,7 +604,8 @@ var PowerlinesEngine = class PowerlinesEngine {
 		inlineConfig.command ??= "deploy";
 		await Promise.all(this.#context.executions.map(async (execution) => this.#worker.deploy({
 			options: execution.options,
-			config: inlineConfig
+			initialConfig: this.#context.initialConfig,
+			inlineConfig
 		})));
 		this.context.debug("✔ Powerlines deploy completed successfully");
 		timer();
@@ -630,6 +632,14 @@ var PowerlinesEngine = class PowerlinesEngine {
 		return this.finalize();
 	}
 	/**
+	* Create a new Powerlines Engine instance
+	*
+	* @param context - The Powerlines context
+	*/
+	constructor(context) {
+		this.#context = context;
+	}
+	/**
 	* Handle incoming IPC messages from the worker processes, routing them to the appropriate handlers based on the message type.
 	*
 	* @param message - The IPC message received from a worker process