@powerlines/engine 0.49.34 → 0.49.36

package/dist/api/types.d.mts

@@ -1,5 +1,5 @@
-import { i as EngineResolvedConfig } from "../config-DXxu0y4t.mjs";
-import { r as EngineSystemContext } from "../context-C71mv_aw.mjs";
+import { EngineResolvedConfig } from "../types/config.mjs";
+import { EngineSystemContext } from "../types/context.mjs";
 import { ExecutionContext } from "@powerlines/core/types/context";
 
 //#region src/api/types.d.ts

package/dist/api.d.cts

@@ -1,4 +1,4 @@
-import { r as ExecutionApiParams } from "./index-QuLZgb8w.cjs";
+import { ExecutionApiParams } from "./types/api.cjs";
 import { ExecutionOptions } from "@powerlines/core";
 
 //#region src/api.d.ts

package/dist/api.d.mts

@@ -1,4 +1,4 @@
-import { r as ExecutionApiParams } from "./index-CBobV6Wm.mjs";
+import { ExecutionApiParams } from "./types/api.mjs";
 import { ExecutionOptions } from "@powerlines/core";
 
 //#region src/api.d.ts

package/dist/context/engine-context.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_chunk = require('../chunk-C_NdSu1c.cjs');
+const require_runtime = require('../_virtual/_rolldown/runtime.cjs');
 let _powerlines_core_plugin_utils = require("@powerlines/core/plugin-utils");
 let _stryke_convert_to_array = require("@stryke/convert/to-array");
 let _stryke_unique_id_uuid = require("@stryke/unique-id/uuid");
@@ -9,7 +9,7 @@ let _powerlines_core_context_base_context = require("@powerlines/core/context/ba
 let _stryke_env_get_env_paths = require("@stryke/env/get-env-paths");
 let _stryke_string_format_kebab_case = require("@stryke/string-format/kebab-case");
 let valibot = require("valibot");
-valibot = require_chunk.__toESM(valibot, 1);
+valibot = require_runtime.__toESM(valibot, 1);
 
 //#region src/context/engine-context.ts
 var PowerlinesEngineContext = class PowerlinesEngineContext extends _powerlines_core_context_base_context.PowerlinesBaseContext {

package/dist/context/engine-context.d.cts

@@ -1,2 +1,53 @@
-import { t as PowerlinesEngineContext } from "../engine-context-DDbpdZHC.cjs";
-export { PowerlinesEngineContext };
+import { EngineOptions } from "../types/config.cjs";
+import { EngineContext, EngineExecutionItem } from "../types/context.cjs";
+import { FrameworkOptions, InlineConfig, LogFn, LoggerOptions } from "@powerlines/core";
+import { ConnectionMeta, DevToolsHost, DevToolsNodeContext } from "devframe/types";
+import { PowerlinesBaseContext } from "@powerlines/core/context/base-context";
+import { EnvPaths } from "@stryke/env/get-env-paths";
+
+//#region src/context/engine-context.d.ts
+declare class PowerlinesEngineContext<TSystemContext = unknown> extends PowerlinesBaseContext<TSystemContext> implements EngineContext<TSystemContext> {
+  #private;
+  options: EngineOptions;
+  connection: ConnectionMeta;
+  /**
+   * Creates a new instance of the PowerlinesEngineContext class.
+   *
+   * @param options - The options to initialize the context with.
+   * @returns A promise that resolves to an instance of the PowerlinesEngineContext class.
+   */
+  static from<TSystemContext = unknown>(options: EngineOptions, host: DevToolsHost, connection: ConnectionMeta): Promise<PowerlinesEngineContext<TSystemContext>>;
+  createLogger(options?: LoggerOptions, logFn?: LogFn): import("@powerlines/core").Logger;
+  get executions(): EngineExecutionItem[];
+  get devtools(): DevToolsNodeContext;
+  get envPaths(): EnvPaths;
+  get framework(): FrameworkOptions;
+  get orgId(): string;
+  /**
+   * Creates a new Context instance.
+   *
+   * @param options - The options to use for creating the context, including the resolved configuration and workspace settings.
+   * @param connection - The connection metadata for the dev server.
+   */
+  protected constructor(options: EngineOptions, connection: ConnectionMeta);
+  /**
+   * Initialize the context with the provided configuration options
+   *
+   * @remarks
+   * This method will set up the resolver and load the user configuration file based on the provided options. It is called during the construction of the context and can also be called when cloning the context to ensure that the new context has the same configuration and resolver setup.
+   *
+   * @param command - The path to the execution configuration to load and run, which can be used to specify different execution configurations for different commands or scenarios.
+   * @param inlineConfig - Additional configuration options provided at runtime, which can override or supplement the options defined in the user configuration file.
+   */
+  loadExecutions(command: string, inlineConfig: InlineConfig): Promise<EngineExecutionItem[]>;
+  /**
+   * Complete an execution by removing it from the list of active executions based on the provided invocation ID and execution ID. This method is typically called when an execution has finished or has been terminated, allowing the context to clean up any resources associated with that execution and update its internal state accordingly.
+   *
+   * @param invocationId - The unique identifier for the invocation of the execution to be completed.
+   * @param executionId - The unique identifier for the specific execution to be completed.
+   */
+  completeExecution(invocationId: string, executionId: string): void;
+}
+//#endregion
+export { PowerlinesEngineContext };
+//# sourceMappingURL=engine-context.d.cts.map

package/dist/context/engine-context.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine-context.d.cts","names":[],"sources":["../../src/context/engine-context.ts"],"mappings":";;;;;;;;cAoDa,uBAAA,mCACH,qBAAA,CAAsB,cAAA,aACnB,aAAA,CAAc,cAAA;EAAA;EAkIP,OAAA,EAAS,aAAA;EAClB,UAAA,EAAY,cAAA;EArIa;;;;;;EAAA,OAgBd,IAAA,2BAClB,OAAA,EAAS,aAAA,EACT,IAAA,EAAM,YAAA,EACN,UAAA,EAAY,cAAA,GACX,OAAA,CAAQ,uBAAA,CAAwB,cAAA;EA8DnB,YAAA,CAAa,OAAA,GAAS,aAAA,EAAoB,KAAA,GAAQ,KAAA,8BAAK,MAAA;EAAA,IAe5D,UAAA,IAAc,mBAAA;EAAA,IAId,QAAA,IAAY,mBAAA;EAAA,IAIZ,QAAA,IAAY,QAAA;EAAA,IAQZ,SAAA,IAAa,gBAAA;EAAA,IAQb,KAAA;EAxBc;;;;;;EAAA,UAkChB,WAAA,CACS,OAAA,EAAS,aAAA,EAClB,UAAA,EAAY,cAAA;EAiBV;;;;;;;;;EAHE,cAAA,CACX,OAAA,UACA,YAAA,EAAc,YAAA,GACb,OAAA,CAAQ,mBAAA;EApJc;;;;;;EA6NlB,iBAAA,CAAkB,YAAA,UAAsB,WAAA;AAAA"}

package/dist/context/engine-context.d.mts

@@ -1,2 +1,53 @@
-import { t as PowerlinesEngineContext } from "../engine-context-CaPJFek0.mjs";
-export { PowerlinesEngineContext };
+import { EngineOptions } from "../types/config.mjs";
+import { EngineContext, EngineExecutionItem } from "../types/context.mjs";
+import { FrameworkOptions, InlineConfig, LogFn, LoggerOptions } from "@powerlines/core";
+import { PowerlinesBaseContext } from "@powerlines/core/context/base-context";
+import { EnvPaths } from "@stryke/env/get-env-paths";
+import { ConnectionMeta, DevToolsHost, DevToolsNodeContext } from "devframe/types";
+
+//#region src/context/engine-context.d.ts
+declare class PowerlinesEngineContext<TSystemContext = unknown> extends PowerlinesBaseContext<TSystemContext> implements EngineContext<TSystemContext> {
+  #private;
+  options: EngineOptions;
+  connection: ConnectionMeta;
+  /**
+   * Creates a new instance of the PowerlinesEngineContext class.
+   *
+   * @param options - The options to initialize the context with.
+   * @returns A promise that resolves to an instance of the PowerlinesEngineContext class.
+   */
+  static from<TSystemContext = unknown>(options: EngineOptions, host: DevToolsHost, connection: ConnectionMeta): Promise<PowerlinesEngineContext<TSystemContext>>;
+  createLogger(options?: LoggerOptions, logFn?: LogFn): import("@powerlines/core").Logger;
+  get executions(): EngineExecutionItem[];
+  get devtools(): DevToolsNodeContext;
+  get envPaths(): EnvPaths;
+  get framework(): FrameworkOptions;
+  get orgId(): string;
+  /**
+   * Creates a new Context instance.
+   *
+   * @param options - The options to use for creating the context, including the resolved configuration and workspace settings.
+   * @param connection - The connection metadata for the dev server.
+   */
+  protected constructor(options: EngineOptions, connection: ConnectionMeta);
+  /**
+   * Initialize the context with the provided configuration options
+   *
+   * @remarks
+   * This method will set up the resolver and load the user configuration file based on the provided options. It is called during the construction of the context and can also be called when cloning the context to ensure that the new context has the same configuration and resolver setup.
+   *
+   * @param command - The path to the execution configuration to load and run, which can be used to specify different execution configurations for different commands or scenarios.
+   * @param inlineConfig - Additional configuration options provided at runtime, which can override or supplement the options defined in the user configuration file.
+   */
+  loadExecutions(command: string, inlineConfig: InlineConfig): Promise<EngineExecutionItem[]>;
+  /**
+   * Complete an execution by removing it from the list of active executions based on the provided invocation ID and execution ID. This method is typically called when an execution has finished or has been terminated, allowing the context to clean up any resources associated with that execution and update its internal state accordingly.
+   *
+   * @param invocationId - The unique identifier for the invocation of the execution to be completed.
+   * @param executionId - The unique identifier for the specific execution to be completed.
+   */
+  completeExecution(invocationId: string, executionId: string): void;
+}
+//#endregion
+export { PowerlinesEngineContext };
+//# sourceMappingURL=engine-context.d.mts.map

package/dist/context/engine-context.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine-context.d.mts","names":[],"sources":["../../src/context/engine-context.ts"],"mappings":";;;;;;;;cAoDa,uBAAA,mCACH,qBAAA,CAAsB,cAAA,aACnB,aAAA,CAAc,cAAA;EAAA;EAkIP,OAAA,EAAS,aAAA;EAClB,UAAA,EAAY,cAAA;EArIa;;;;;;EAAA,OAgBd,IAAA,2BAClB,OAAA,EAAS,aAAA,EACT,IAAA,EAAM,YAAA,EACN,UAAA,EAAY,cAAA,GACX,OAAA,CAAQ,uBAAA,CAAwB,cAAA;EA8DnB,YAAA,CAAa,OAAA,GAAS,aAAA,EAAoB,KAAA,GAAQ,KAAA,8BAAK,MAAA;EAAA,IAe5D,UAAA,IAAc,mBAAA;EAAA,IAId,QAAA,IAAY,mBAAA;EAAA,IAIZ,QAAA,IAAY,QAAA;EAAA,IAQZ,SAAA,IAAa,gBAAA;EAAA,IAQb,KAAA;EAxBc;;;;;;EAAA,UAkChB,WAAA,CACS,OAAA,EAAS,aAAA,EAClB,UAAA,EAAY,cAAA;EAiBV;;;;;;;;;EAHE,cAAA,CACX,OAAA,UACA,YAAA,EAAc,YAAA,GACb,OAAA,CAAQ,mBAAA;EApJc;;;;;;EA6NlB,iBAAA,CAAkB,YAAA,UAAsB,WAAA;AAAA"}

package/dist/context/index.d.cts

@@ -1,2 +1,2 @@
-import { t as PowerlinesEngineContext } from "../engine-context-DDbpdZHC.cjs";
+import { PowerlinesEngineContext } from "./engine-context.cjs";
 export { PowerlinesEngineContext };

package/dist/context/index.d.mts

@@ -1,2 +1,2 @@
-import { t as PowerlinesEngineContext } from "../engine-context-CaPJFek0.mjs";
+import { PowerlinesEngineContext } from "./engine-context.mjs";
 export { PowerlinesEngineContext };

package/dist/engine.cjs

@@ -1,6 +1,263 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_engine = require('./engine-BKEDCOCb.cjs');
+const require_runtime = require('./_virtual/_rolldown/runtime.cjs');
+const require_execution_api_worker = require('./_internal/execution-api-worker.cjs');
+const require_context_engine_context = require('./context/engine-context.cjs');
+let node_events = require("node:events");
+let devframe_node = require("devframe/node");
+let get_port_please = require("get-port-please");
+let h3 = require("h3");
+let sirv = require("sirv");
+sirv = require_runtime.__toESM(sirv, 1);
 
-exports.PowerlinesEngine = require_engine.PowerlinesEngine;
-exports.createContext = require_engine.createContext;
-exports.createEngine = require_engine.createEngine;
+//#region src/engine.ts
+/**
+* The Powerlines process' orchestration and coordination API.
+*
+* @public
+*/
+var PowerlinesEngine = class {
+	/**
+	* The Powerlines context
+	*/
+	#context;
+	/**
+	* The execution host, which provides methods to call the execution API functions from the engine context. This allows the engine to invoke commands and other API functions during the execution of Powerlines commands, enabling communication between the engine and the execution contexts.
+	*/
+	#api;
+	/**
+	* The Powerlines context
+	*/
+	get context() {
+		return this.#context;
+	}
+	/**
+	* The execution host, which provides methods to call the execution API functions from the engine context. This allows the engine to invoke commands and other API functions during the execution of Powerlines commands, enabling communication between the engine and the execution contexts.
+	*/
+	get api() {
+		return this.#api;
+	}
+	/**
+	* Create a new Powerlines Engine instance
+	*
+	* @param context - The Powerlines context
+	* @param api - The API host for the execution workers
+	* @returns A new instance of the Powerlines Engine
+	*/
+	constructor(context, api) {
+		this.#context = context;
+		this.#api = api;
+	}
+	/**
+	* Create a new Powerlines project
+	*
+	* @remarks
+	* This method will create a new Powerlines project in the current directory.
+	*
+	* @param inlineConfig - The inline configuration for the create command
+	* @returns A promise that resolves when the project has been created
+	*/
+	async create(inlineConfig) {
+		const timer = this.context.timer("Create");
+		this.context.info("🆕 Creating a new project");
+		await this.execute("create", inlineConfig);
+		this.context.debug("✔ Create command completed successfully");
+		timer();
+	}
+	/**
+	* Generate the Powerlines typescript declaration file
+	*
+	* @remarks
+	* This method will only generate the typescript declaration file for the Powerlines project. It is generally recommended to run the full `prepare` command, which will run this method as part of its process.
+	*
+	* @param inlineConfig - The inline configuration for the types command
+	*/
+	async types(inlineConfig) {
+		const timer = this.context.timer("Types");
+		this.context.info("🏗️  Generating typescript declarations for the project");
+		await this.execute("types", inlineConfig);
+		this.context.debug("✔ Types generation has completed successfully");
+		timer();
+	}
+	/**
+	* Prepare the Powerlines API
+	*
+	* @remarks
+	* This method will prepare the Powerlines API for use, initializing any necessary resources.
+	*
+	* @param inlineConfig - The inline configuration for the prepare command
+	*/
+	async prepare(inlineConfig) {
+		const timer = this.context.timer("Prepare");
+		this.context.info("🏗️ Preparing the project");
+		await this.execute("prepare", inlineConfig);
+		this.context.debug("✔ Preparation has completed successfully");
+		timer();
+	}
+	/**
+	* Clean any previously prepared artifacts
+	*
+	* @remarks
+	* This method will remove the previous Powerlines artifacts from the project.
+	*
+	* @param inlineConfig - The inline configuration for the clean command
+	* @returns A promise that resolves when the clean command has completed
+	*/
+	async clean(inlineConfig) {
+		const timer = this.context.timer("Clean");
+		this.context.info("🧹 Cleaning the previous artifacts");
+		await this.execute("clean", inlineConfig);
+		this.context.debug("✔ Cleaning completed successfully");
+		timer();
+	}
+	/**
+	* Lint the project
+	*
+	* @param inlineConfig - The inline configuration for the lint command
+	* @returns A promise that resolves when the lint command has completed
+	*/
+	async lint(inlineConfig) {
+		const timer = this.context.timer("Lint");
+		this.context.info("📝 Linting the project");
+		await this.execute("lint", inlineConfig);
+		this.context.debug("✔ Linting completed successfully");
+		timer();
+	}
+	/**
+	* Test the project
+	*
+	* @remarks
+	* This method will run the tests for the Powerlines project.
+	*
+	* @param inlineConfig - The inline configuration for the test command
+	* @returns A promise that resolves when the test command has completed
+	*/
+	async test(inlineConfig) {
+		const timer = this.context.timer("Test");
+		this.context.info("🧪 Running tests for the project");
+		await this.execute("test", inlineConfig);
+		this.context.debug("✔ Testing completed successfully");
+		timer();
+	}
+	/**
+	* Build the project
+	*
+	* @remarks
+	* This method will build the Powerlines project, generating the necessary artifacts.
+	*
+	* @param inlineConfig - The inline configuration for the build command
+	* @returns A promise that resolves when the build command has completed
+	*/
+	async build(inlineConfig) {
+		const timer = this.context.timer("Build");
+		this.context.info("📦 Building the project");
+		await this.execute("build", inlineConfig);
+		this.context.debug("✔ Build completed successfully");
+		timer();
+	}
+	/**
+	* Prepare the documentation for the project
+	*
+	* @param inlineConfig - The inline configuration for the docs command
+	* @returns A promise that resolves when the documentation generation has completed
+	*/
+	async docs(inlineConfig) {
+		const timer = this.context.timer("Docs");
+		this.context.info("📓 Generating documentation for the project");
+		await this.execute("docs", inlineConfig);
+		this.context.debug("✔ Documentation generation completed successfully");
+		timer();
+	}
+	/**
+	* Deploy the project source code
+	*
+	* @remarks
+	* This method will prepare and build the Powerlines project, generating the necessary artifacts for the deployment.
+	*
+	* @param inlineConfig - The inline configuration for the deploy command
+	* @returns A promise that resolves when the deploy command has completed
+	*/
+	async deploy(inlineConfig) {
+		const timer = this.context.timer("Deploy");
+		this.context.info("🚀 Deploying the project");
+		await this.execute("deploy", inlineConfig);
+		this.context.debug("✔ Deployment completed successfully");
+		timer();
+	}
+	/**
+	* Finalization/cleanup processing for the Powerlines API
+	*
+	* @remarks
+	* This step includes any final processes or clean up required by Powerlines. It will be run after each Powerlines command.
+	*
+	* @returns A promise that resolves when the finalization process has completed
+	*/
+	async finalize() {
+		const timer = this.context.timer("Finalize");
+		this.context.info("🏁 Finalization processes started");
+		await this.api.finalize();
+		this.context.debug("✔ Finalization completed successfully");
+		timer();
+	}
+	/**
+	* Asynchronous disposal method for the Powerlines Engine, which will call the finalize method to perform any necessary cleanup when the engine is disposed of.
+	*/
+	async [Symbol.asyncDispose]() {
+		return this.finalize();
+	}
+	/**
+	* Execute a Powerlines command based on the provided execution path and inline configuration, loading the necessary executions from the context and managing their lifecycle.
+	*
+	* @remarks
+	* This method will load the executions for the specified command and inline configuration, then execute each one while managing their lifecycle, including handling their completion and any errors that may occur during execution.
+	*
+	* @param command - The path to the execution configuration to load and run, which can be used to specify different execution configurations for different commands or scenarios.
+	* @param inlineConfig - Additional configuration options provided at runtime, which can override or supplement the options defined in the user configuration file.
+	* @returns A promise that resolves when all executions for the specified command have completed
+	*/
+	async execute(command, inlineConfig) {
+		await Promise.all((await this.context.loadExecutions(command, inlineConfig)).map(async (execution) => {
+			try {
+				await this.api.execute(command, execution.options, inlineConfig);
+			} catch (error) {
+				this.context.error(`Execution of method "${command}" failed for execution with invocation ID "${execution.invocationId}" and execution ID "${execution.options.executionId}": \n\n${error instanceof Error ? error.stack || error.message : String(error)}`);
+				throw error;
+			} finally {
+				this.context.completeExecution(execution.invocationId, execution.options.executionId);
+			}
+		}));
+	}
+};
+async function createContext(options) {
+	const port = options.port ?? await (0, get_port_please.getPort)({
+		host: options.host || "localhost",
+		random: true
+	});
+	const app = (0, h3.createApp)();
+	const host = (0, devframe_node.createH3DevToolsHost)({
+		appName: options.framework?.name || "powerlines",
+		origin: `http://${options.host || "localhost"}:${port}`,
+		mount: (base, dir) => {
+			app.use(base, (0, h3.fromNodeMiddleware)((0, sirv.default)(dir, {
+				dev: true,
+				single: true
+			})));
+		}
+	});
+	return require_context_engine_context.PowerlinesEngineContext.from(options, host, {
+		backend: "websocket",
+		websocket: port
+	});
+}
+async function createEngine(options, apiPath = "@powerlines/engine/api") {
+	node_events.EventEmitter.setMaxListeners(Infinity);
+	const context = await createContext(options);
+	return new PowerlinesEngine(context, await require_execution_api_worker.ExecutionApiWorker.from(apiPath, {
+		root: options.root,
+		context
+	}));
+}
+
+//#endregion
+exports.PowerlinesEngine = PowerlinesEngine;
+exports.createContext = createContext;
+exports.createEngine = createEngine;

package/dist/engine.d.cts

@@ -1,2 +1,143 @@
-import { n as createContext, r as createEngine, t as PowerlinesEngine } from "./engine-B5pbfMyg.cjs";
-export { PowerlinesEngine, createContext, createEngine };
+import { EngineOptions } from "./types/config.cjs";
+import { EngineContext } from "./types/context.cjs";
+import { Engine } from "./types/api.cjs";
+import { PowerlinesEngineContext } from "./context/engine-context.cjs";
+import { ExecutionApiWorker } from "./_internal/execution-api-worker.cjs";
+import { BuildInlineConfig, CleanInlineConfig, CreateInlineConfig, DeployInlineConfig, DocsInlineConfig, InlineConfig, LintInlineConfig, PrepareInlineConfig, TestInlineConfig, TypesInlineConfig } from "@powerlines/core";
+
+//#region src/engine.d.ts
+/**
+ * The Powerlines process' orchestration and coordination API.
+ *
+ * @public
+ */
+declare class PowerlinesEngine implements Engine, AsyncDisposable {
+  #private;
+  /**
+   * The Powerlines context
+   */
+  get context(): EngineContext;
+  /**
+   * The execution host, which provides methods to call the execution API functions from the engine context. This allows the engine to invoke commands and other API functions during the execution of Powerlines commands, enabling communication between the engine and the execution contexts.
+   */
+  get api(): ExecutionApiWorker;
+  /**
+   * Create a new Powerlines Engine instance
+   *
+   * @param context - The Powerlines context
+   * @param api - The API host for the execution workers
+   * @returns A new instance of the Powerlines Engine
+   */
+  constructor(context: EngineContext, api: ExecutionApiWorker);
+  /**
+   * Create a new Powerlines project
+   *
+   * @remarks
+   * This method will create a new Powerlines project in the current directory.
+   *
+   * @param inlineConfig - The inline configuration for the create command
+   * @returns A promise that resolves when the project has been created
+   */
+  create(inlineConfig: CreateInlineConfig): Promise<void>;
+  /**
+   * Generate the Powerlines typescript declaration file
+   *
+   * @remarks
+   * This method will only generate the typescript declaration file for the Powerlines project. It is generally recommended to run the full `prepare` command, which will run this method as part of its process.
+   *
+   * @param inlineConfig - The inline configuration for the types command
+   */
+  types(inlineConfig: TypesInlineConfig): Promise<void>;
+  /**
+   * Prepare the Powerlines API
+   *
+   * @remarks
+   * This method will prepare the Powerlines API for use, initializing any necessary resources.
+   *
+   * @param inlineConfig - The inline configuration for the prepare command
+   */
+  prepare(inlineConfig: PrepareInlineConfig): Promise<void>;
+  /**
+   * Clean any previously prepared artifacts
+   *
+   * @remarks
+   * This method will remove the previous Powerlines artifacts from the project.
+   *
+   * @param inlineConfig - The inline configuration for the clean command
+   * @returns A promise that resolves when the clean command has completed
+   */
+  clean(inlineConfig: CleanInlineConfig): Promise<void>;
+  /**
+   * Lint the project
+   *
+   * @param inlineConfig - The inline configuration for the lint command
+   * @returns A promise that resolves when the lint command has completed
+   */
+  lint(inlineConfig: LintInlineConfig): Promise<void>;
+  /**
+   * Test the project
+   *
+   * @remarks
+   * This method will run the tests for the Powerlines project.
+   *
+   * @param inlineConfig - The inline configuration for the test command
+   * @returns A promise that resolves when the test command has completed
+   */
+  test(inlineConfig: TestInlineConfig): Promise<void>;
+  /**
+   * Build the project
+   *
+   * @remarks
+   * This method will build the Powerlines project, generating the necessary artifacts.
+   *
+   * @param inlineConfig - The inline configuration for the build command
+   * @returns A promise that resolves when the build command has completed
+   */
+  build(inlineConfig: BuildInlineConfig): Promise<void>;
+  /**
+   * Prepare the documentation for the project
+   *
+   * @param inlineConfig - The inline configuration for the docs command
+   * @returns A promise that resolves when the documentation generation has completed
+   */
+  docs(inlineConfig: DocsInlineConfig): Promise<void>;
+  /**
+   * Deploy the project source code
+   *
+   * @remarks
+   * This method will prepare and build the Powerlines project, generating the necessary artifacts for the deployment.
+   *
+   * @param inlineConfig - The inline configuration for the deploy command
+   * @returns A promise that resolves when the deploy command has completed
+   */
+  deploy(inlineConfig: DeployInlineConfig): Promise<void>;
+  /**
+   * Finalization/cleanup processing for the Powerlines API
+   *
+   * @remarks
+   * This step includes any final processes or clean up required by Powerlines. It will be run after each Powerlines command.
+   *
+   * @returns A promise that resolves when the finalization process has completed
+   */
+  finalize(): Promise<void>;
+  /**
+   * 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>;
+  /**
+   * Execute a Powerlines command based on the provided execution path and inline configuration, loading the necessary executions from the context and managing their lifecycle.
+   *
+   * @remarks
+   * This method will load the executions for the specified command and inline configuration, then execute each one while managing their lifecycle, including handling their completion and any errors that may occur during execution.
+   *
+   * @param command - The path to the execution configuration to load and run, which can be used to specify different execution configurations for different commands or scenarios.
+   * @param inlineConfig - Additional configuration options provided at runtime, which can override or supplement the options defined in the user configuration file.
+   * @returns A promise that resolves when all executions for the specified command have completed
+   */
+  protected execute(command: string, inlineConfig: InlineConfig): Promise<void>;
+}
+declare function createContext(options: EngineOptions): Promise<PowerlinesEngineContext<unknown>>;
+declare function createEngine(options: EngineOptions, apiPath?: string): Promise<PowerlinesEngine>;
+//#endregion
+export { PowerlinesEngine, createContext, createEngine };
+//# sourceMappingURL=engine.d.cts.map

package/dist/engine.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.cts","names":[],"sources":["../src/engine.ts"],"mappings":";;;;;;;;;;AA8CA;;;cAAa,gBAAA,YAA4B,MAAA,EAAQ,eAAA;EAAA;EAgCnB;;;EAAA,IAlBjB,OAAA,IAAW,aAAA;EAkDW;;;EAAA,IA3CtB,GAAA,IAAO,kBAAA;EAgFe;;;;;;;cArEd,OAAA,EAAS,aAAA,EAAe,GAAA,EAAK,kBAAA;EA2IhB;;;;;;;;;EA7HnB,MAAA,CAAO,YAAA,EAAc,kBAAA,GAAkB,OAAA;EA9CL;;;;;;;;EAgElC,KAAA,CAAM,YAAA,EAAc,iBAAA,GAAiB,OAAA;EA3ChC;;;;;;;;EA6DL,OAAA,CAAQ,YAAA,EAAc,mBAAA,GAAmB,OAAA;EApCF;;;;;;;;;EAuDvC,KAAA,CAAM,YAAA,EAAc,iBAAA,GAAiB,OAAA;EAAjB;;;;;;EAgBpB,IAAA,CAAK,YAAA,EAAc,gBAAA,GAAgB,OAAA;EAmBnC;;;;;;;;;EAAA,IAAA,CAAK,YAAA,EAAc,gBAAA,GAAgB,OAAA;EAmC9B;;;;;;;;;EAhBL,KAAA,CAAM,YAAA,EAAc,iBAAA,GAAiB,OAAA;EAkEhB;;;;;;EAlDrB,IAAA,CAAK,YAAA,EAAc,gBAAA,GAAgB,OAAA;EAgEmB;AA8BrE;;;;;;;;EA3Ee,MAAA,CAAO,YAAA,EAAc,kBAAA,GAAkB,OAAA;EA2ElB;;;;AAAsB;AAuB1D;;;EAhFe,QAAA,IAAQ,OAAA;EAkFa;;;EAAA,CArEpB,MAAA,CAAO,YAAA,KAAa,OAAA;EAoEzB;;;;;;AACyB;;;;EADzB,UAtDO,OAAA,CAAQ,OAAA,UAAiB,YAAA,EAAc,YAAA,GAAY,OAAA;AAAA;AAAA,iBA8B/C,aAAA,CAAc,OAAA,EAAS,aAAA,GAAa,OAAA,CAAA,uBAAA;AAAA,iBAuBpC,YAAA,CACpB,OAAA,EAAS,aAAA,EACT,OAAA,YAAkC,OAAA,CAAA,gBAAA"}