@powerlines/engine 0.9.1 → 0.9.3

package/dist/worker/execution-host.d.cts

@@ -1,10 +1,60 @@
-import { ExecutionOptions, InlineConfig } from "@powerlines/core";
+import { ExecutionOptions, InlineConfig, LogMeta } from "@powerlines/core";
+import { BirpcOptions } from "birpc";
+import { RpcCacheOptions } from "devframe/rpc";
+import { WsRpcChannelOptions } from "devframe/rpc/transports/ws-client";
+import { ConnectionMeta, DevToolsRpcClientFunctions, DevToolsRpcServerFunctions } from "devframe/types";
+//#region src/types/rpc.d.ts
+/**
+ * Payload for write log Rpc messages.
+ */
+interface LogPayload {
+  /**
+   * Metadata associated with the log message, excluding fields that are automatically added by the engine such as executionId, configIndex, environment, and timestamp. This can include custom fields relevant to the log entry, such as category, name, command, hook, plugin, and source.
+   */
+  meta: LogMeta;
+  /**
+   * The log message content, which can be a string or an array of strings representing the log entry. This field is required and should contain the actual message to be logged.
+   */
+  message: string;
+}
+interface RpcServerFunctions extends DevToolsRpcServerFunctions {
+  "powerlines:log": (payload: LogPayload) => void;
+}
+interface RpcClientFunctions extends DevToolsRpcClientFunctions {}
+//#endregion
+//#region src/types/config.d.ts
+interface EngineExecutionOptions extends ExecutionOptions {
+  /**
+   * The base URL for the dev server, which can be used by plugins to construct URLs for assets or API endpoints during development. This value is only relevant in "dev" mode and will be `undefined` in "build" mode.
+   */
+  baseURL: string;
+  /**
+   * Metadata for the connection used by the dev server, including the backend type and websocket configuration.
+   */
+  connection: ConnectionMeta;
+  /**
+   * Options for configuring the WebSocket RPC channel used for communication between the dev server and the client, which can be used by plugins to customize the behavior of the WebSocket connection, such as setting custom timeouts, retry strategies, or other options.
+   */
+  wsOptions?: Partial<WsRpcChannelOptions>;
+  /**
+   * Options for configuring the RPC client used for communication between the dev server and the client, which can be used by plugins to customize the behavior of the RPC client, such as setting custom timeouts, retry strategies, or other options.
+   */
+  rpcOptions?: Partial<BirpcOptions<RpcServerFunctions, RpcClientFunctions, boolean>>;
+  /**
+   * Options for configuring the RPC cache used for caching RPC responses between the dev server and the client, which can be used by plugins to customize the behavior of the RPC cache, such as setting custom cache keys, expiration times, or other options.
+   *
+   * @remarks
+   * This option can be set to `true` to enable caching with default options, or it can be set to a configuration object that allows for fine-grained control over the caching behavior.
+   */
+  cacheOptions?: boolean | Partial<RpcCacheOptions>;
+}
+//#endregion
 //#region src/types/api.d.ts
 interface ExecutionHostParams {
   /**
    * The execution options for the current execution instance
    */
-  options: ExecutionOptions;
+  options: EngineExecutionOptions;
   /**
    * The inline configuration for the current execution instance, which is the result of merging the user configuration with any configuration provided by plugins during the "config" hook.
    */

package/dist/worker/execution-host.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"execution-host.d.cts","names":[],"sources":["../../src/types/api.ts","../../src/execution-host.ts"],"mappings":";;UA4IiB,mBAAA;EC3FE;;;ED+FjB,OAAA,EAAS,gBAAA;EC/FQ;;;EDoGjB,YAAA,EAAc,YAAA;AAAA;;;cC5GH,KAAA,IAAK,MAAA,EAAsB,mBAAA,KAAtB,OAAA;AAAA,cACL,OAAA,IAAO,MAAA,EAAwB,mBAAA,KAAxB,OAAA;AAAA,cACP,MAAA,IAAM,MAAA,EAAuB,mBAAA,KAAvB,OAAA;AAAA,cACN,KAAA,IAAK,MAAA,EAAsB,mBAAA,KAAtB,OAAA;AAAA,cACL,IAAA,IAAI,MAAA,EAAqB,mBAAA,KAArB,OAAA;AAAA,cACJ,IAAA,IAAI,MAAA,EAAqB,mBAAA,KAArB,OAAA;AAAA,cACJ,KAAA,IAAK,MAAA,EAAsB,mBAAA,KAAtB,OAAA;AAAA,cACL,IAAA,IAAI,MAAA,EAAqB,mBAAA,KAArB,OAAA;AAAA,cACJ,MAAA,IAAM,MAAA,EAAuB,mBAAA,KAAvB,OAAA"}
+{"version":3,"file":"execution-host.d.cts","names":[],"sources":["../../src/types/rpc.ts","../../src/types/config.ts","../../src/types/api.ts","../../src/execution-host.ts"],"mappings":";;;;;;;;;UAqGiB,UAAA;ECjBK;;;EDqBpB,IAAA,EAAM,OAAA;ECfS;;;EDoBf,OAAA;AAAA;AAAA,UAGe,kBAAA,SAA2B,0BAAA;EAE1C,gBAAA,GAAmB,OAAA,EAAS,UAAA;AAAA;AAAA,UAGb,kBAAA,SAA2B,0BAAA;;;UChD3B,sBAAA,SAA+B,gBAAA;;;AAAhD;EAIE,OAAA;;;;EAKA,UAAA,EAAY,cAAA;EAWG;;;EANf,SAAA,GAAY,OAAA,CAAQ,mBAAA;EAea;;;EAVjC,UAAA,GAAa,OAAA,CACX,YAAA,CAAa,kBAAA,EAAoB,kBAAA;EApB2B;;;;;;EA6B9D,YAAA,aAAyB,OAAA,CAAQ,eAAA;AAAA;;;UCyClB,mBAAA;EClGG;;;EDsGlB,OAAA,EAAS,sBAAA;ECrG+B;;;ED0GxC,YAAA,EAAc,YAAA;AAAA;;;cC5GH,KAAA,IAAK,MAAA,EAAsB,mBAAA,KAAtB,OAAA;AAAA,cACL,OAAA,IAAO,MAAA,EAAwB,mBAAA,KAAxB,OAAA;AAAA,cACP,MAAA,IAAM,MAAA,EAAuB,mBAAA,KAAvB,OAAA;AAAA,cACN,KAAA,IAAK,MAAA,EAAsB,mBAAA,KAAtB,OAAA;AAAA,cACL,IAAA,IAAI,MAAA,EAAqB,mBAAA,KAArB,OAAA;AAAA,cACJ,IAAA,IAAI,MAAA,EAAqB,mBAAA,KAArB,OAAA;AAAA,cACJ,KAAA,IAAK,MAAA,EAAsB,mBAAA,KAAtB,OAAA;AAAA,cACL,IAAA,IAAI,MAAA,EAAqB,mBAAA,KAArB,OAAA;AAAA,cACJ,MAAA,IAAM,MAAA,EAAuB,mBAAA,KAAvB,OAAA"}

package/dist/worker/execution-host.d.mts

@@ -1,10 +1,60 @@
-import { ExecutionOptions, InlineConfig } from "@powerlines/core";
+import { ExecutionOptions, InlineConfig, LogMeta } from "@powerlines/core";
+import { RpcCacheManager, RpcCacheOptions } from "devframe/rpc";
+import { WsRpcChannelOptions } from "devframe/rpc/transports/ws-client";
+import { BirpcOptions } from "birpc";
+import { ConnectionMeta, DevToolsRpcClientFunctions, DevToolsRpcServerFunctions } from "devframe/types";
+//#region src/types/rpc.d.ts
+/**
+ * Payload for write log Rpc messages.
+ */
+interface LogPayload {
+  /**
+   * Metadata associated with the log message, excluding fields that are automatically added by the engine such as executionId, configIndex, environment, and timestamp. This can include custom fields relevant to the log entry, such as category, name, command, hook, plugin, and source.
+   */
+  meta: LogMeta;
+  /**
+   * The log message content, which can be a string or an array of strings representing the log entry. This field is required and should contain the actual message to be logged.
+   */
+  message: string;
+}
+interface RpcServerFunctions extends DevToolsRpcServerFunctions {
+  "powerlines:log": (payload: LogPayload) => void;
+}
+interface RpcClientFunctions extends DevToolsRpcClientFunctions {}
+//#endregion
+//#region src/types/config.d.ts
+interface EngineExecutionOptions extends ExecutionOptions {
+  /**
+   * The base URL for the dev server, which can be used by plugins to construct URLs for assets or API endpoints during development. This value is only relevant in "dev" mode and will be `undefined` in "build" mode.
+   */
+  baseURL: string;
+  /**
+   * Metadata for the connection used by the dev server, including the backend type and websocket configuration.
+   */
+  connection: ConnectionMeta;
+  /**
+   * Options for configuring the WebSocket RPC channel used for communication between the dev server and the client, which can be used by plugins to customize the behavior of the WebSocket connection, such as setting custom timeouts, retry strategies, or other options.
+   */
+  wsOptions?: Partial<WsRpcChannelOptions>;
+  /**
+   * Options for configuring the RPC client used for communication between the dev server and the client, which can be used by plugins to customize the behavior of the RPC client, such as setting custom timeouts, retry strategies, or other options.
+   */
+  rpcOptions?: Partial<BirpcOptions<RpcServerFunctions, RpcClientFunctions, boolean>>;
+  /**
+   * Options for configuring the RPC cache used for caching RPC responses between the dev server and the client, which can be used by plugins to customize the behavior of the RPC cache, such as setting custom cache keys, expiration times, or other options.
+   *
+   * @remarks
+   * This option can be set to `true` to enable caching with default options, or it can be set to a configuration object that allows for fine-grained control over the caching behavior.
+   */
+  cacheOptions?: boolean | Partial<RpcCacheOptions>;
+}
+//#endregion
 //#region src/types/api.d.ts
 interface ExecutionHostParams {
   /**
    * The execution options for the current execution instance
    */
-  options: ExecutionOptions;
+  options: EngineExecutionOptions;
   /**
    * The inline configuration for the current execution instance, which is the result of merging the user configuration with any configuration provided by plugins during the "config" hook.
    */

package/dist/worker/execution-host.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"execution-host.d.mts","names":[],"sources":["../../src/types/api.ts","../../src/execution-host.ts"],"mappings":";;UA4IiB,mBAAA;EC3FE;;;ED+FjB,OAAA,EAAS,gBAAA;EC/FQ;;;EDoGjB,YAAA,EAAc,YAAA;AAAA;;;cC5GH,KAAA,IAAK,MAAA,EAAsB,mBAAA,KAAtB,OAAA;AAAA,cACL,OAAA,IAAO,MAAA,EAAwB,mBAAA,KAAxB,OAAA;AAAA,cACP,MAAA,IAAM,MAAA,EAAuB,mBAAA,KAAvB,OAAA;AAAA,cACN,KAAA,IAAK,MAAA,EAAsB,mBAAA,KAAtB,OAAA;AAAA,cACL,IAAA,IAAI,MAAA,EAAqB,mBAAA,KAArB,OAAA;AAAA,cACJ,IAAA,IAAI,MAAA,EAAqB,mBAAA,KAArB,OAAA;AAAA,cACJ,KAAA,IAAK,MAAA,EAAsB,mBAAA,KAAtB,OAAA;AAAA,cACL,IAAA,IAAI,MAAA,EAAqB,mBAAA,KAArB,OAAA;AAAA,cACJ,MAAA,IAAM,MAAA,EAAuB,mBAAA,KAAvB,OAAA"}
+{"version":3,"file":"execution-host.d.mts","names":[],"sources":["../../src/types/rpc.ts","../../src/types/config.ts","../../src/types/api.ts","../../src/execution-host.ts"],"mappings":";;;;;;;;;UAqGiB,UAAA;ECjBK;;;EDqBpB,IAAA,EAAM,OAAA;ECfS;;;EDoBf,OAAA;AAAA;AAAA,UAGe,kBAAA,SAA2B,0BAAA;EAE1C,gBAAA,GAAmB,OAAA,EAAS,UAAA;AAAA;AAAA,UAGb,kBAAA,SAA2B,0BAAA;;;UChD3B,sBAAA,SAA+B,gBAAA;;;AAAhD;EAIE,OAAA;;;;EAKA,UAAA,EAAY,cAAA;EAWG;;;EANf,SAAA,GAAY,OAAA,CAAQ,mBAAA;EAea;;;EAVjC,UAAA,GAAa,OAAA,CACX,YAAA,CAAa,kBAAA,EAAoB,kBAAA;EApB2B;;;;;;EA6B9D,YAAA,aAAyB,OAAA,CAAQ,eAAA;AAAA;;;UCyClB,mBAAA;EClGG;;;EDsGlB,OAAA,EAAS,sBAAA;ECrG+B;;;ED0GxC,YAAA,EAAc,YAAA;AAAA;;;cC5GH,KAAA,IAAK,MAAA,EAAsB,mBAAA,KAAtB,OAAA;AAAA,cACL,OAAA,IAAO,MAAA,EAAwB,mBAAA,KAAxB,OAAA;AAAA,cACP,MAAA,IAAM,MAAA,EAAuB,mBAAA,KAAvB,OAAA;AAAA,cACN,KAAA,IAAK,MAAA,EAAsB,mBAAA,KAAtB,OAAA;AAAA,cACL,IAAA,IAAI,MAAA,EAAqB,mBAAA,KAArB,OAAA;AAAA,cACJ,IAAA,IAAI,MAAA,EAAqB,mBAAA,KAArB,OAAA;AAAA,cACJ,KAAA,IAAK,MAAA,EAAsB,mBAAA,KAAtB,OAAA;AAAA,cACL,IAAA,IAAI,MAAA,EAAqB,mBAAA,KAArB,OAAA;AAAA,cACJ,MAAA,IAAM,MAAA,EAAuB,mBAAA,KAAvB,OAAA"}

package/dist/worker/execution-host.mjs

@@ -13,7 +13,7 @@ import { installDependencies } from "@powerlines/core/lib/install-dependencies";
 import { writeMetaFile } from "@powerlines/core/lib/meta";
 import { initializeTsconfig, resolveTsconfig } from "@powerlines/core/lib/typescript/tsconfig";
 import { format, formatFolder as formatFolder$1 } from "@powerlines/core/lib/utilities/format";
-import { formatConfig } from "@powerlines/core/plugin-utils";
+import { consoleLogger, formatConfig } from "@powerlines/core/plugin-utils";
 import { toArray } from "@stryke/convert/to-array";
 import { createDirectory } from "@stryke/fs/helpers";
 import { isObject } from "@stryke/type-checks/is-object";
@@ -25,6 +25,19 @@ import { omit } from "@stryke/helpers/omit";
 import { isSetObject } from "@stryke/type-checks/is-set-object";
 import { PowerlinesExecutionContext } from "@powerlines/core/context/execution-context";
 import { resolvePluginConfig } from "@powerlines/core/lib/context-helpers";
+import { titleCase } from "@stryke/string-format/title-case";
+import { uuid } from "@stryke/unique-id/uuid";
+import { createEventEmitter } from "@powerlines/core/lib/events";
+import { isNumber } from "@stryke/type-checks/is-number";
+import { isSet } from "@stryke/type-checks/is-set";
+import { StormURL } from "@stryke/url";
+import { createRpcStreamingClientHost } from "devframe/client";
+import { RpcCacheManager, RpcFunctionsCollectorBase } from "devframe/rpc";
+import { createRpcClient } from "devframe/rpc/client";
+import { createWsRpcChannel } from "devframe/rpc/transports/ws-client";
+import { promiseWithResolver } from "devframe/utils/promise";
+import { humanId } from "human-id";
+import { EventEmitter } from "node:events";
 
 //#region src/api/prepare.ts
 /**
@@ -337,6 +350,131 @@ async function types$1(context) {
 	timer();
 }
 
+//#endregion
+//#region src/helpers/rpc.ts
+function createWsRpcClientMode(baseURL, connectionMeta, events, clientRpc, authToken = humanId({
+	separator: "-",
+	capitalize: false
+}), rpcOptions = {}, wsOptions = {}) {
+	let isTrusted = false;
+	const trustedPromise = promiseWithResolver();
+	const url = isNumber(connectionMeta.websocket) || isSet(connectionMeta.websocket) && `${+connectionMeta.websocket}` === `${connectionMeta.websocket}` ? `${baseURL.protocol.replace("http", "ws")}//${baseURL.hostname}:${connectionMeta.websocket}` : connectionMeta.websocket;
+	const definitions = /* @__PURE__ */ new Map();
+	for (const name of connectionMeta.jsonSerializableMethods ?? []) definitions.set(name, { jsonSerializable: true });
+	const serverRpc = createRpcClient(clientRpc.functions, {
+		channel: createWsRpcChannel({
+			url,
+			authToken,
+			definitions,
+			...wsOptions
+		}),
+		rpcOptions
+	});
+	clientRpc.register({
+		name: "devframe:auth:revoked",
+		type: "event",
+		handler: () => {
+			isTrusted = false;
+			events.emit("rpc:is-trusted:updated", false);
+		}
+	});
+	let currentAuthToken = authToken;
+	async function requestTrustWithToken(token) {
+		currentAuthToken = token;
+		return true;
+	}
+	async function requestTrust() {
+		if (isTrusted) return true;
+		return requestTrustWithToken(currentAuthToken);
+	}
+	async function ensureTrusted(timeout = 6e4) {
+		if (isTrusted) trustedPromise.resolve(true);
+		if (timeout <= 0) return trustedPromise.promise;
+		let clear = () => {};
+		await Promise.race([trustedPromise.promise.then(clear), new Promise((resolve, reject) => {
+			const id = setTimeout(() => {
+				reject(/* @__PURE__ */ new Error("Timeout waiting for rpc to be trusted"));
+			}, timeout);
+			clear = () => clearTimeout(id);
+		})]);
+		return isTrusted;
+	}
+	return {
+		get isTrusted() {
+			return isTrusted;
+		},
+		requestTrust,
+		requestTrustWithToken,
+		ensureTrusted,
+		call: (...args) => {
+			return serverRpc.$call(...args);
+		},
+		callEvent: (...args) => {
+			return serverRpc.$callEvent(...args);
+		},
+		callOptional: (...args) => {
+			return serverRpc.$callOptional(...args);
+		}
+	};
+}
+const CONNECTION_AUTH_TOKEN_KEY = "__DEVTOOLS_CONNECTION_AUTH_TOKEN__";
+function createRpcClient$1(options) {
+	const baseURL = new StormURL(options.baseURL);
+	const cacheManager = new RpcCacheManager({
+		functions: [],
+		...typeof options.cacheOptions === "object" ? options.cacheOptions : {}
+	});
+	const context = { rpc: void 0 };
+	const clientRpc = new RpcFunctionsCollectorBase(context);
+	EventEmitter.setMaxListeners(100);
+	const events = createEventEmitter();
+	const mode = createWsRpcClientMode(baseURL, options.connection, events, clientRpc, void 0, {
+		...options.rpcOptions,
+		async onRequest(req, next, resolve) {
+			await options.rpcOptions?.onRequest?.call(this, req, next, resolve);
+			if (options.cacheOptions && cacheManager?.validate(req.m)) {
+				const cached = cacheManager.cached(req.m, req.a);
+				if (cached) return resolve(cached);
+				else {
+					const res = await next(req);
+					cacheManager?.apply(req, res);
+				}
+			} else await next(req);
+		}
+	}, options.wsOptions);
+	const rpc = {
+		events,
+		get isTrusted() {
+			return mode.isTrusted;
+		},
+		connectionMeta: options.connection,
+		ensureTrusted: mode.ensureTrusted,
+		requestTrust: mode.requestTrust,
+		requestTrustWithToken: async (token) => {
+			localStorage.setItem(CONNECTION_AUTH_TOKEN_KEY, token);
+			globalThis[CONNECTION_AUTH_TOKEN_KEY] = token;
+			return mode.requestTrustWithToken(token);
+		},
+		call: mode.call,
+		callEvent: mode.callEvent,
+		callOptional: mode.callOptional,
+		client: clientRpc,
+		sharedState: void 0,
+		streaming: void 0,
+		cacheManager
+	};
+	rpc.streaming = createRpcStreamingClientHost(rpc);
+	context.rpc = rpc;
+	mode.requestTrust();
+	try {
+		const bc = new BroadcastChannel("vite-devtools-auth");
+		bc.onmessage = (event) => {
+			if (event.data?.type === "auth-update" && event.data.authToken) rpc.requestTrustWithToken(event.data.authToken);
+		};
+	} catch {}
+	return rpc;
+}
+
 //#endregion
 //#region src/helpers/create-execution-host.ts
 /**
@@ -347,8 +485,28 @@ async function types$1(context) {
 */
 function createExecutionHost(methods) {
 	return Object.fromEntries(Object.entries(methods).map(([method, fn]) => [method, async (params) => {
-		const context = await PowerlinesExecutionContext.from(params.options, params.inlineConfig ?? {});
-		context.logger.info(`Starting ${method} execution (${params.options.executionId})`);
+		const { options, inlineConfig } = params;
+		let rpc;
+		if (options.baseURL && options.connection) rpc = createRpcClient$1(options);
+		else throw new Error(`Execution RPC client could not be created - Missing ${!options.baseURL ? `baseURL${options.connection ? ` and connection information` : ""}` : "connection"} or connection information.`);
+		const logFn = (meta, message) => {
+			consoleLogger(meta, message);
+			if (rpc) rpc.callEvent("powerlines:log", {
+				meta: {
+					category: "general",
+					...options,
+					...isSetObject(meta) ? meta : { type: meta },
+					logId: uuid(),
+					timestamp: Date.now()
+				},
+				message
+			});
+		};
+		const context = await PowerlinesExecutionContext.from({
+			...options,
+			logFn
+		}, inlineConfig ?? {}, { rpc });
+		context.logger.info(`Starting ${titleCase(options.framework?.name) || "Powerlines"} - ${titleCase(method)} execution (${options.executionId})`);
 		await resolvePluginConfig(context);
 		await fn(context);
 	}]));

package/dist/worker/execution-host.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"execution-host.mjs","names":["prepare","formatFolder","build","prepare","clean","prepare","joinPaths","create","prepare","joinPaths","deploy","prepare","docs","prepare","lint","prepare","test","prepare","types","prepare","executeTypes","executePrepare","executeCreate","executeClean","executeLint","executeTest","executeBuild","executeDocs","executeDeploy"],"sources":["../../src/api/prepare.ts","../../src/api/build.ts","../../src/api/clean.ts","../../src/api/create.ts","../../src/api/deploy.ts","../../src/api/docs.ts","../../src/api/lint.ts","../../src/api/test.ts","../../src/api/types.ts","../../src/helpers/create-execution-host.ts","../../src/execution-host.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                   ⚡ Storm Software - Powerlines\n\n This code was released as part of the Powerlines project. Powerlines\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/powerlines.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/powerlines\n Documentation:            https://docs.stormsoftware.com/projects/powerlines\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport type { ExecutionContext } from \"@powerlines/core\";\nimport { executeEnvironments } from \"@powerlines/core/lib/environment\";\nimport { handleTypes } from \"@powerlines/core/lib/generate-types\";\nimport { installDependencies } from \"@powerlines/core/lib/install-dependencies\";\nimport { writeMetaFile } from \"@powerlines/core/lib/meta\";\nimport {\n  initializeTsconfig,\n  resolveTsconfig\n} from \"@powerlines/core/lib/typescript/tsconfig\";\nimport { formatFolder } from \"@powerlines/core/lib/utilities/format\";\nimport { formatConfig } from \"@powerlines/core/plugin-utils\";\nimport { toArray } from \"@stryke/convert/to-array\";\nimport { createDirectory } from \"@stryke/fs/helpers\";\nimport { isObject } from \"@stryke/type-checks/is-object\";\nimport { EngineResolvedConfig } from \"../types/config\";\nimport { EngineSystemContext } from \"../types/context\";\n\n/**\n * Prepare the project\n *\n * @param context - The execution context for the build process, which provides access to the project configuration, environment, and utility functions for performing the build. The context is used to manage the state and behavior of the build process, allowing for hooks to be called at different stages of the build and for environment-specific configurations to be applied.\n */\nexport async function prepare<\n  TResolvedConfig extends EngineResolvedConfig,\n  TSystemContext extends EngineSystemContext\n>(\n  context: ExecutionContext<TResolvedConfig, TSystemContext>,\n  skipTypes = false\n) {\n  const timer = context.timer(\"Preparation\");\n\n  await executeEnvironments(context, async env => {\n    env.debug(\n      `Initializing the processing options for the Powerlines project.`\n    );\n\n    await context.callHook(\"configResolved\", {\n      environment: env,\n      order: \"pre\"\n    });\n\n    await initializeTsconfig<TResolvedConfig, TSystemContext>(env);\n\n    await context.callHook(\"configResolved\", {\n      environment: env,\n      order: \"normal\"\n    });\n\n    if (env.entry.length > 0) {\n      env.debug(\n        `The configuration provided ${\n          isObject(env.config.input)\n            ? Object.keys(env.config.input).length\n            : toArray(env.config.input).length\n        } entry point(s), Powerlines has found ${\n          env.entry.length\n        } entry files(s) for the ${env.config.title} project${\n          env.entry.length > 0 && env.entry.length < 10\n            ? `: \\n${env.entry\n                .map(\n                  entry =>\n                    `- ${entry.file}${\n                      entry.output ? ` -> ${entry.output}` : \"\"\n                    }`\n                )\n                .join(\" \\n\")}`\n            : \"\"\n        }`\n      );\n    } else {\n      env.warn(\n        `No entry files were found for the ${\n          env.config.title\n        } project. Please ensure this is correct. Powerlines plugins generally require at least one entry point to function properly.`\n      );\n    }\n\n    await resolveTsconfig<TResolvedConfig, TSystemContext>(env);\n    await installDependencies(env);\n\n    await context.callHook(\"configResolved\", {\n      environment: env,\n      order: \"post\"\n    });\n\n    env.trace({\n      meta: {\n        category: \"config\"\n      },\n      message: `Powerlines configuration after configResolved hook: \\n${formatConfig(\n        env.config\n      )}`\n    });\n\n    if (!env.fs.existsSync(env.cachePath)) {\n      await createDirectory(env.cachePath);\n    }\n\n    if (!env.fs.existsSync(env.dataPath)) {\n      await createDirectory(env.dataPath);\n    }\n\n    await context.callHook(\"prepare\", {\n      environment: env,\n      order: \"pre\"\n    });\n    await context.callHook(\"prepare\", {\n      environment: env,\n      order: \"normal\"\n    });\n\n    await context.callHook(\"prepare\", {\n      environment: env,\n      order: \"post\"\n    });\n\n    if (!skipTypes && env.config.output.types !== false) {\n      await handleTypes(context, env);\n    }\n\n    context.debug(\"Formatting files generated during the prepare step.\");\n\n    await Promise.all([\n      formatFolder(env, env.builtinsPath),\n      formatFolder(env, env.entryPath)\n    ]);\n\n    await writeMetaFile(env);\n    env.persistedMeta = env.meta;\n  });\n\n  timer();\n}\n","/* -------------------------------------------------------------------\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 {\n  EnvironmentContext,\n  ExecutionContext,\n  formatFolder\n} from \"@powerlines/core\";\nimport { executeEnvironments } from \"@powerlines/core/lib/environment\";\nimport { copyFiles } from \"@stryke/fs/copy-file\";\nimport { appendPath } from \"@stryke/path/append\";\nimport { relativePath } from \"@stryke/path/file-path-fns\";\nimport { isParentPath } from \"@stryke/path/is-parent-path\";\nimport { joinPaths } from \"@stryke/path/join-paths\";\nimport { replacePath } from \"@stryke/path/replace\";\nimport chalk from \"chalk\";\nimport { existsSync } from \"node:fs\";\nimport { EngineResolvedConfig } from \"../types/config\";\nimport { EngineSystemContext } from \"../types/context\";\nimport { prepare } from \"./prepare\";\n\nasync function handleBuild<\n  TResolvedConfig extends EngineResolvedConfig,\n  TSystemContext extends EngineSystemContext\n>(\n  context: ExecutionContext<TResolvedConfig, TSystemContext>,\n  env: EnvironmentContext<TResolvedConfig, TSystemContext>\n) {\n  await context.callHook(\"build\", {\n    environment: env,\n    order: \"pre\"\n  });\n\n  env.debug(\n    \"Formatting the generated entry files before the build process starts.\"\n  );\n  await formatFolder(env, env.entryPath);\n\n  await context.callHook(\"build\", {\n    environment: env,\n    order: \"normal\"\n  });\n\n  if (env.config.output.copy) {\n    env.debug(\"Copying project's files from build output directory.\");\n\n    const destinationPath = isParentPath(\n      appendPath(env.config.output.path, env.config.cwd),\n      appendPath(env.config.root, env.config.cwd)\n    )\n      ? joinPaths(\n          env.config.output.copy.path,\n          relativePath(\n            appendPath(env.config.root, env.config.cwd),\n            appendPath(env.config.output.path, env.config.cwd)\n          )\n        )\n      : joinPaths(env.config.output.copy.path, \"dist\");\n    const sourcePath = env.config.output.path;\n\n    if (existsSync(sourcePath) && sourcePath !== destinationPath) {\n      env.debug(\n        `Copying files from project's build output directory (${\n          env.config.output.path\n        }) to the project's copy/publish directory (${destinationPath}).`\n      );\n\n      await copyFiles(sourcePath, destinationPath);\n    } else {\n      env.warn(\n        `The source path for the copy operation ${\n          !existsSync(sourcePath)\n            ? \"does not exist\"\n            : \"is the same as the destination path\"\n        }. Source: ${sourcePath}, Destination: ${\n          destinationPath\n        }. Skipping copying of build output files.`\n      );\n    }\n\n    if (\n      env.config.output.copy.assets &&\n      Array.isArray(env.config.output.copy.assets)\n    ) {\n      await Promise.all(\n        env.config.output.copy.assets.map(async asset => {\n          env.trace(\n            `Copying asset(s): ${chalk.redBright(\n              env.config.cwd === asset.input\n                ? asset.glob\n                : appendPath(\n                    asset.glob,\n                    replacePath(asset.input, env.config.cwd)\n                  )\n            )} -> ${chalk.greenBright(\n              appendPath(asset.glob, replacePath(asset.output, env.config.cwd))\n            )} ${\n              Array.isArray(asset.ignore) && asset.ignore.length > 0\n                ? ` (ignoring: ${asset.ignore\n                    .map(i => chalk.yellowBright(i))\n                    .join(\", \")})`\n                : \"\"\n            }`\n          );\n\n          await env.fs.copy(asset, asset.output);\n        })\n      );\n    }\n  } else {\n    env.debug(\n      \"No copy configuration found for the project output. Skipping the copying of build output files.\"\n    );\n  }\n\n  await context.callHook(\"build\", {\n    environment: env,\n    order: \"post\"\n  });\n}\n\n/**\n * Build the project\n *\n * @param context - The execution context for the build process, which provides access to the project configuration, environment, and utility functions for performing the build. The context is used to manage the state and behavior of the build process, allowing for hooks to be called at different stages of the build and for environment-specific configurations to be applied.\n */\nexport async function build<\n  TResolvedConfig extends EngineResolvedConfig,\n  TSystemContext extends EngineSystemContext\n>(context: ExecutionContext<TResolvedConfig, TSystemContext>) {\n  const timer = context.timer(\"Building\");\n\n  await context.generateChecksum();\n  if (\n    context.meta.checksum !== context.persistedMeta?.checksum ||\n    context.config.skipCache\n  ) {\n    context.info(\n      !context.persistedMeta?.checksum\n        ? \"No previous build cache found. Preparing the project for the initial build.\"\n        : context.meta.checksum !== context.persistedMeta.checksum\n          ? \"The project has been modified since the last time `prepare` was ran. Re-preparing the project.\"\n          : \"The project is configured to skip cache. Re-preparing the project.\"\n    );\n\n    await prepare<TResolvedConfig, TSystemContext>(context);\n  }\n\n  if (context.config.singleBuild) {\n    await handleBuild<TResolvedConfig, TSystemContext>(\n      context,\n      await context.toEnvironment()\n    );\n  } else {\n    await executeEnvironments(context, async env => {\n      await handleBuild<TResolvedConfig, TSystemContext>(context, env);\n    });\n  }\n\n  timer();\n}\n","/* -------------------------------------------------------------------\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 { ExecutionContext } from \"@powerlines/core\";\nimport { executeEnvironments } from \"@powerlines/core/lib/environment\";\nimport { joinPaths } from \"@stryke/path/join\";\nimport { EngineResolvedConfig } from \"../types/config\";\nimport { EngineSystemContext } from \"../types/context\";\nimport { prepare } from \"./prepare\";\n\n/**\n * Clean any previously prepared artifacts\n *\n * @param context - The execution context for the clean process, which provides access to the project configuration, environment, and utility functions for performing the clean operation. The context is used to manage the state and behavior of the clean process, allowing for hooks to be called at different stages of the clean and for environment-specific configurations to be applied.\n */\nexport async function clean<\n  TResolvedConfig extends EngineResolvedConfig,\n  TSystemContext extends EngineSystemContext\n>(context: ExecutionContext<TResolvedConfig, TSystemContext>) {\n  const timer = context.timer(\"Cleaning\");\n\n  await prepare<TResolvedConfig, TSystemContext>(context, true);\n  await executeEnvironments(context, async env => {\n    env.debug(\"Cleaning the project's dist and artifacts directories.\");\n\n    await env.fs.remove(joinPaths(env.config.cwd, env.config.output.path));\n    await env.fs.remove(\n      joinPaths(\n        env.config.cwd,\n        env.config.root,\n        env.config.output.artifactsPath\n      )\n    );\n\n    await context.callHook(\"clean\", {\n      environment: env,\n      sequential: false\n    });\n  });\n\n  timer();\n}\n","/* -------------------------------------------------------------------\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 { ExecutionContext } from \"@powerlines/core\";\nimport { executeEnvironments } from \"@powerlines/core/lib/environment\";\nimport { listFiles } from \"@stryke/fs/list-files\";\nimport { joinPaths } from \"@stryke/path/join\";\nimport Handlebars from \"handlebars\";\nimport { EngineResolvedConfig } from \"../types/config\";\nimport { EngineSystemContext } from \"../types/context\";\nimport { prepare } from \"./prepare\";\n\n/**\n * Create a new Powerlines project\n *\n * @param context - The execution context for the create process, which provides access to the project configuration, environment, and utility functions for performing the create operation. The context is used to manage the state and behavior of the create process, allowing for hooks to be called at different stages of the create and for environment-specific configurations to be applied.\n */\nexport async function create<\n  TResolvedConfig extends EngineResolvedConfig,\n  TSystemContext extends EngineSystemContext\n>(context: ExecutionContext<TResolvedConfig, TSystemContext>) {\n  const timer = context.timer(\"Create a New Project Generation\");\n\n  await prepare<TResolvedConfig, TSystemContext>(context, true);\n  await executeEnvironments(context, async env => {\n    env.debug(\"Initializing the processing options for the project.\");\n\n    await context.callHook(\"create\", {\n      environment: env,\n      order: \"pre\"\n    });\n\n    const files = await listFiles(\n      joinPaths(env.powerlinesPath, \"files/common/**/*.hbs\")\n    );\n    for (const file of files) {\n      env.trace(`Adding template file to project: ${file}`);\n\n      const template = Handlebars.compile(file);\n      await env.fs.write(\n        joinPaths(env.config.root, file.replace(\".hbs\", \"\")),\n        template(env)\n      );\n    }\n\n    await context.callHook(\"create\", {\n      environment: env,\n      order: \"normal\"\n    });\n\n    if (env.config.projectType === \"application\") {\n      const appFiles = await listFiles(\n        joinPaths(env.powerlinesPath, \"files/application/**/*.hbs\")\n      );\n      for (const file of appFiles) {\n        env.trace(`Adding application template file: ${file}`);\n\n        const template = Handlebars.compile(file);\n        await env.fs.write(\n          joinPaths(env.config.root, file.replace(\".hbs\", \"\")),\n          template(env)\n        );\n      }\n    } else {\n      const libFiles = await listFiles(\n        joinPaths(env.powerlinesPath, \"files/library/**/*.hbs\")\n      );\n      for (const file of libFiles) {\n        env.trace(`Adding library template file: ${file}`);\n\n        const template = Handlebars.compile(file);\n        await env.fs.write(\n          joinPaths(env.config.root, file.replace(\".hbs\", \"\")),\n          template(env)\n        );\n      }\n    }\n\n    await context.callHook(\"create\", {\n      environment: env,\n      order: \"post\"\n    });\n  });\n\n  timer();\n}\n","/* -------------------------------------------------------------------\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 { ExecutionContext } from \"@powerlines/core\";\nimport { executeEnvironments } from \"@powerlines/core/lib/environment\";\nimport { EngineResolvedConfig } from \"../types/config\";\nimport { EngineSystemContext } from \"../types/context\";\nimport { prepare } from \"./prepare\";\n\n/**\n * Deploy the project's source files to the target environment.\n *\n * @remarks\n * This function serves as the main entry point for the deployment process, orchestrating the execution of deployment hooks across different environments defined in the project configuration. It ensures that all relevant deployment operations are performed in a structured manner, allowing for pre-deployment, main deployment, and post-deployment hooks to be executed at the appropriate stages of the process. The function also utilizes a timer to measure the duration of the deployment operation, providing insights into the performance of the deployment process.\n *\n * @param context - The execution context for the deploy process, which provides access to the project configuration, environment, and utility functions for performing the deploy operation. The context is used to manage the state and behavior of the deploy process, allowing for hooks to be called at different stages of the deploy and for environment-specific configurations to be applied.\n */\nexport async function deploy<\n  TResolvedConfig extends EngineResolvedConfig,\n  TSystemContext extends EngineSystemContext\n>(context: ExecutionContext<TResolvedConfig, TSystemContext>) {\n  const timer = context.timer(\"Deployment\");\n\n  await prepare<TResolvedConfig, TSystemContext>(context);\n  await executeEnvironments(context, async env => {\n    await context.callHook(\"deploy\", {\n      environment: env\n    });\n  });\n\n  timer();\n}\n","/* -------------------------------------------------------------------\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 { ExecutionContext } from \"@powerlines/core\";\nimport { executeEnvironments } from \"@powerlines/core/lib/environment\";\nimport { EngineResolvedConfig } from \"../types/config\";\nimport { EngineSystemContext } from \"../types/context\";\nimport { prepare } from \"./prepare\";\n\n/**\n * Generate the project's documentation.\n *\n * @remarks\n * This function serves as the main entry point for the documentation generation process, orchestrating the execution of documentation hooks across different environments defined in the project configuration. It ensures that all relevant documentation operations are performed in a structured manner, allowing for pre-documentation, main documentation, and post-documentation hooks to be executed at the appropriate stages of the process. The function also utilizes a timer to measure the duration of the documentation operation, providing insights into the performance of the documentation process.\n *\n * @param context - The execution context for the documentation process, which provides access to the project configuration, environment, and utility functions for performing the documentation operation. The context is used to manage the state and behavior of the documentation process, allowing for hooks to be called at different stages of the documentation and for environment-specific configurations to be applied.\n */\nexport async function docs<\n  TResolvedConfig extends EngineResolvedConfig,\n  TSystemContext extends EngineSystemContext\n>(context: ExecutionContext<TResolvedConfig, TSystemContext>) {\n  const timer = context.timer(\"Documentation\");\n\n  await prepare<TResolvedConfig, TSystemContext>(context);\n  await executeEnvironments(context, async env => {\n    await context.callHook(\"docs\", {\n      environment: env\n    });\n  });\n\n  timer();\n}\n","/* -------------------------------------------------------------------\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 { ExecutionContext } from \"@powerlines/core\";\nimport { executeEnvironments } from \"@powerlines/core/lib/environment\";\nimport { EngineResolvedConfig } from \"../types/config\";\nimport { EngineSystemContext } from \"../types/context\";\nimport { prepare } from \"./prepare\";\n\n/**\n * Lint the project's source files and report any issues found.\n *\n * @remarks\n * This function serves as the main entry point for the linting process, orchestrating the execution of linting hooks across different environments defined in the project configuration. It ensures that all relevant linting operations are performed in a structured manner, allowing for pre-linting, main linting, and post-linting hooks to be executed at the appropriate stages of the process. The function also utilizes a timer to measure the duration of the linting operation, providing insights into the performance of the linting process.\n *\n * @param context - The execution context for the lint process, which provides access to the project configuration, environment, and utility functions for performing the lint operation. The context is used to manage the state and behavior of the lint process, allowing for hooks to be called at different stages of the lint and for environment-specific configurations to be applied.\n */\nexport async function lint<\n  TResolvedConfig extends EngineResolvedConfig,\n  TSystemContext extends EngineSystemContext\n>(context: ExecutionContext<TResolvedConfig, TSystemContext>) {\n  const timer = context.timer(\"Linting\");\n\n  await prepare<TResolvedConfig, TSystemContext>(context);\n  await executeEnvironments(context, async env => {\n    await context.callHook(\"lint\", {\n      environment: env,\n      sequential: false\n    });\n  });\n\n  timer();\n}\n","/* -------------------------------------------------------------------\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 { ExecutionContext } from \"@powerlines/core\";\nimport { executeEnvironments } from \"@powerlines/core/lib/environment\";\nimport { EngineResolvedConfig } from \"../types/config\";\nimport { EngineSystemContext } from \"../types/context\";\nimport { prepare } from \"./prepare\";\n\n/**\n * Test the project's source files and report any issues found.\n *\n * @remarks\n * This function serves as the main entry point for the testing process, orchestrating the execution of testing hooks across different environments defined in the project configuration. It ensures that all relevant testing operations are performed in a structured manner, allowing for pre-testing, main testing, and post-testing hooks to be executed at the appropriate stages of the process. The function also utilizes a timer to measure the duration of the testing operation, providing insights into the performance of the testing process.\n *\n * @param context - The execution context for the test process, which provides access to the project configuration, environment, and utility functions for performing the test operation. The context is used to manage the state and behavior of the test process, allowing for hooks to be called at different stages of the test and for environment-specific configurations to be applied.\n */\nexport async function test<\n  TResolvedConfig extends EngineResolvedConfig,\n  TSystemContext extends EngineSystemContext\n>(context: ExecutionContext<TResolvedConfig, TSystemContext>) {\n  const timer = context.timer(\"Testing\");\n\n  await prepare(context);\n  await executeEnvironments(context, async env => {\n    await context.callHook(\"test\", {\n      environment: env,\n      sequential: false\n    });\n  });\n\n  timer();\n}\n","/* -------------------------------------------------------------------\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 { executeEnvironments } from \"@powerlines/core/lib/environment\";\nimport { handleTypes } from \"@powerlines/core/lib/generate-types\";\nimport { installDependencies } from \"@powerlines/core/lib/install-dependencies\";\nimport { writeMetaFile } from \"@powerlines/core/lib/meta\";\nimport {\n  initializeTsconfig,\n  resolveTsconfig\n} from \"@powerlines/core/lib/typescript/tsconfig\";\nimport { format } from \"@powerlines/core/lib/utilities/format\";\nimport { ExecutionContext } from \"@powerlines/core/types/context\";\nimport { formatLogMessage } from \"@storm-software/config-tools/logger\";\nimport { toArray } from \"@stryke/convert/to-array\";\nimport { createDirectory } from \"@stryke/fs/helpers\";\nimport { omit } from \"@stryke/helpers/omit\";\nimport { isObject } from \"@stryke/type-checks/is-object\";\nimport { isSetObject } from \"@stryke/type-checks/is-set-object\";\nimport { EngineResolvedConfig } from \"../types/config\";\nimport { EngineSystemContext } from \"../types/context\";\nimport { prepare } from \"./prepare\";\n\n/**\n * Generate runtime types for the Powerlines project.\n *\n * @remarks\n * This function is responsible for generating TypeScript declaration files based on the project's configuration and environment. It executes hooks at various stages of the type generation process, allowing for customization and extension by plugins. The generated types are formatted and written to the appropriate location in the project's file system, ensuring that they are available for use by other parts of the Powerlines system and by end-users of the project.\n *\n * @param context - The execution context for the build process, which provides access to the project configuration, environment, and utility functions for performing the build. The context is used to manage the state and behavior of the build process, allowing for hooks to be called at different stages of the build and for environment-specific configurations to be applied.\n */\nexport async function types<\n  TResolvedConfig extends EngineResolvedConfig,\n  TSystemContext extends EngineSystemContext\n>(context: ExecutionContext<TResolvedConfig, TSystemContext>) {\n  const timer = context.timer(\"Type Generation\");\n  context.debug(\n    \" Aggregating configuration options for the Powerlines project\"\n  );\n\n  await executeEnvironments(context, async env => {\n    env.debug(\n      `Initializing the processing options for the Powerlines project.`\n    );\n\n    await context.callHook(\"configResolved\", {\n      environment: env,\n      order: \"pre\"\n    });\n\n    await initializeTsconfig<TResolvedConfig, TSystemContext>(env);\n\n    await context.callHook(\"configResolved\", {\n      environment: env,\n      order: \"normal\"\n    });\n\n    if (env.entry.length > 0) {\n      env.debug(\n        `The configuration provided ${\n          isObject(env.config.input)\n            ? Object.keys(env.config.input).length\n            : toArray(env.config.input).length\n        } entry point(s), Powerlines has found ${\n          env.entry.length\n        } entry files(s) for the ${env.config.title} project${\n          env.entry.length > 0 && env.entry.length < 10\n            ? `: \\n${env.entry\n                .map(\n                  entry =>\n                    `- ${entry.file}${\n                      entry.output ? ` -> ${entry.output}` : \"\"\n                    }`\n                )\n                .join(\" \\n\")}`\n            : \"\"\n        }`\n      );\n    } else {\n      env.warn(\n        `No entry files were found for the ${\n          env.config.title\n        } project. Please ensure this is correct. Powerlines plugins generally require at least one entry point to function properly.`\n      );\n    }\n\n    await resolveTsconfig<TResolvedConfig, TSystemContext>(env);\n    await installDependencies(env);\n\n    await context.callHook(\"configResolved\", {\n      environment: env,\n      order: \"post\"\n    });\n\n    context.trace(\n      `Powerlines configuration has been resolved: \\n\\n${formatLogMessage({\n        ...env.config,\n        userConfig: isSetObject(env.config.userConfig)\n          ? omit(env.config.userConfig, [\"plugins\"])\n          : undefined,\n        inlineConfig: isSetObject(env.config.inlineConfig)\n          ? env.config.inlineConfig\n          : undefined,\n        plugins: env.plugins.map(plugin => plugin.name)\n      })}`\n    );\n\n    if (!env.fs.existsSync(env.cachePath)) {\n      await createDirectory(env.cachePath);\n    }\n\n    if (!env.fs.existsSync(env.dataPath)) {\n      await createDirectory(env.dataPath);\n    }\n\n    if (\n      env.config.skipCache === true ||\n      env.persistedMeta?.checksum !== env.meta.checksum\n    ) {\n      env.debug(\n        `Using previously prepared files as the meta checksum has not changed.`\n      );\n    } else {\n      env.info(\n        `Running \\`prepare\\` command as the meta checksum has changed since the last run.`\n      );\n\n      await prepare(context, true);\n    }\n\n    await handleTypes(context, env);\n\n    context.debug(\"Formatting files generated during the types step.\");\n\n    await format(env, env.typesPath, (await env.fs.read(env.typesPath)) ?? \"\");\n\n    await writeMetaFile(env);\n    env.persistedMeta = env.meta;\n  });\n\n  timer();\n}\n","/* -------------------------------------------------------------------\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 { PowerlinesExecutionContext } from \"@powerlines/core/context/execution-context\";\nimport { resolvePluginConfig } from \"@powerlines/core/lib/context-helpers\";\nimport { ExecutionHostParams } from \"../types/api\";\nimport { EngineResolvedConfig } from \"../types/config\";\nimport { EngineSystemContext } from \"../types/context\";\n\n/**\n * Creates an execution host with the provided methods. Each method will be wrapped to create an execution context and handle errors appropriately.\n *\n * @param methods - An object where keys are method names and values are functions that take an execution context and return a promise.\n * @returns An object with the same keys as the input methods, but each function is wrapped to create an execution context and handle errors.\n */\nexport function createExecutionHost<\n  TContext extends PowerlinesExecutionContext<\n    EngineResolvedConfig,\n    EngineSystemContext\n  > = PowerlinesExecutionContext<EngineResolvedConfig, EngineSystemContext>\n>(methods: Record<string, (context: TContext) => Promise<void>>) {\n  return Object.fromEntries(\n    Object.entries(methods).map(([method, fn]) => [\n      method,\n      async (params: ExecutionHostParams) => {\n        const context = (await PowerlinesExecutionContext.from(\n          params.options,\n          params.inlineConfig ?? {}\n        )) as TContext;\n        context.logger.info(\n          `Starting ${method} execution (${params.options.executionId})`\n        );\n\n        await resolvePluginConfig(context as PowerlinesExecutionContext<any>);\n\n        await fn(context);\n      }\n    ])\n  );\n}\n","/* -------------------------------------------------------------------\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 { build as executeBuild } from \"./api/build\";\nimport { clean as executeClean } from \"./api/clean\";\nimport { create as executeCreate } from \"./api/create\";\nimport { deploy as executeDeploy } from \"./api/deploy\";\nimport { docs as executeDocs } from \"./api/docs\";\nimport { lint as executeLint } from \"./api/lint\";\nimport { prepare as executePrepare } from \"./api/prepare\";\nimport { test as executeTest } from \"./api/test\";\nimport { types as executeTypes } from \"./api/types\";\nimport { createExecutionHost } from \"./helpers/create-execution-host\";\n\nconst executionHost = createExecutionHost({\n  types: executeTypes,\n  prepare: executePrepare,\n  create: executeCreate,\n  clean: executeClean,\n  lint: executeLint,\n  test: executeTest,\n  build: executeBuild,\n  docs: executeDocs,\n  deploy: executeDeploy\n});\n\nexport const types = executionHost.types;\nexport const prepare = executionHost.prepare;\nexport const create = executionHost.create;\nexport const clean = executionHost.clean;\nexport const lint = executionHost.lint;\nexport const test = executionHost.test;\nexport const build = executionHost.build;\nexport const docs = executionHost.docs;\nexport const deploy = executionHost.deploy;\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAwCA,eAAsBA,UAIpB,SACA,YAAY,OACZ;CACA,MAAM,QAAQ,QAAQ,MAAM,cAAc;AAE1C,OAAM,oBAAoB,SAAS,OAAM,QAAO;AAC9C,MAAI,MACF,kEACD;AAED,QAAM,QAAQ,SAAS,kBAAkB;GACvC,aAAa;GACb,OAAO;GACR,CAAC;AAEF,QAAM,mBAAoD,IAAI;AAE9D,QAAM,QAAQ,SAAS,kBAAkB;GACvC,aAAa;GACb,OAAO;GACR,CAAC;AAEF,MAAI,IAAI,MAAM,SAAS,EACrB,KAAI,MACF,8BACE,SAAS,IAAI,OAAO,MAAM,GACtB,OAAO,KAAK,IAAI,OAAO,MAAM,CAAC,SAC9B,QAAQ,IAAI,OAAO,MAAM,CAAC,OAC/B,wCACC,IAAI,MAAM,OACX,0BAA0B,IAAI,OAAO,MAAM,UAC1C,IAAI,MAAM,SAAS,KAAK,IAAI,MAAM,SAAS,KACvC,OAAO,IAAI,MACR,KACC,UACE,KAAK,MAAM,OACT,MAAM,SAAS,OAAO,MAAM,WAAW,KAE5C,CACA,KAAK,MAAM,KACd,KAEP;MAED,KAAI,KACF,qCACE,IAAI,OAAO,MACZ,8HACF;AAGH,QAAM,gBAAiD,IAAI;AAC3D,QAAM,oBAAoB,IAAI;AAE9B,QAAM,QAAQ,SAAS,kBAAkB;GACvC,aAAa;GACb,OAAO;GACR,CAAC;AAEF,MAAI,MAAM;GACR,MAAM,EACJ,UAAU,UACX;GACD,SAAS,yDAAyD,aAChE,IAAI,OACL;GACF,CAAC;AAEF,MAAI,CAAC,IAAI,GAAG,WAAW,IAAI,UAAU,CACnC,OAAM,gBAAgB,IAAI,UAAU;AAGtC,MAAI,CAAC,IAAI,GAAG,WAAW,IAAI,SAAS,CAClC,OAAM,gBAAgB,IAAI,SAAS;AAGrC,QAAM,QAAQ,SAAS,WAAW;GAChC,aAAa;GACb,OAAO;GACR,CAAC;AACF,QAAM,QAAQ,SAAS,WAAW;GAChC,aAAa;GACb,OAAO;GACR,CAAC;AAEF,QAAM,QAAQ,SAAS,WAAW;GAChC,aAAa;GACb,OAAO;GACR,CAAC;AAEF,MAAI,CAAC,aAAa,IAAI,OAAO,OAAO,UAAU,MAC5C,OAAM,YAAY,SAAS,IAAI;AAGjC,UAAQ,MAAM,sDAAsD;AAEpE,QAAM,QAAQ,IAAI,CAChBC,eAAa,KAAK,IAAI,aAAa,EACnCA,eAAa,KAAK,IAAI,UAAU,CACjC,CAAC;AAEF,QAAM,cAAc,IAAI;AACxB,MAAI,gBAAgB,IAAI;GACxB;AAEF,QAAO;;;;;ACjHT,eAAe,YAIb,SACA,KACA;AACA,OAAM,QAAQ,SAAS,SAAS;EAC9B,aAAa;EACb,OAAO;EACR,CAAC;AAEF,KAAI,MACF,wEACD;AACD,OAAM,aAAa,KAAK,IAAI,UAAU;AAEtC,OAAM,QAAQ,SAAS,SAAS;EAC9B,aAAa;EACb,OAAO;EACR,CAAC;AAEF,KAAI,IAAI,OAAO,OAAO,MAAM;AAC1B,MAAI,MAAM,uDAAuD;EAEjE,MAAM,kBAAkB,aACtB,WAAW,IAAI,OAAO,OAAO,MAAM,IAAI,OAAO,IAAI,EAClD,WAAW,IAAI,OAAO,MAAM,IAAI,OAAO,IAAI,CAC5C,GACG,UACE,IAAI,OAAO,OAAO,KAAK,MACvB,aACE,WAAW,IAAI,OAAO,MAAM,IAAI,OAAO,IAAI,EAC3C,WAAW,IAAI,OAAO,OAAO,MAAM,IAAI,OAAO,IAAI,CACnD,CACF,GACD,UAAU,IAAI,OAAO,OAAO,KAAK,MAAM,OAAO;EAClD,MAAM,aAAa,IAAI,OAAO,OAAO;AAErC,MAAI,WAAW,WAAW,IAAI,eAAe,iBAAiB;AAC5D,OAAI,MACF,wDACE,IAAI,OAAO,OAAO,KACnB,6CAA6C,gBAAgB,IAC/D;AAED,SAAM,UAAU,YAAY,gBAAgB;QAE5C,KAAI,KACF,0CACE,CAAC,WAAW,WAAW,GACnB,mBACA,sCACL,YAAY,WAAW,iBACtB,gBACD,2CACF;AAGH,MACE,IAAI,OAAO,OAAO,KAAK,UACvB,MAAM,QAAQ,IAAI,OAAO,OAAO,KAAK,OAAO,CAE5C,OAAM,QAAQ,IACZ,IAAI,OAAO,OAAO,KAAK,OAAO,IAAI,OAAM,UAAS;AAC/C,OAAI,MACF,qBAAqB,MAAM,UACzB,IAAI,OAAO,QAAQ,MAAM,QACrB,MAAM,OACN,WACE,MAAM,MACN,YAAY,MAAM,OAAO,IAAI,OAAO,IAAI,CACzC,CACN,CAAC,MAAM,MAAM,YACZ,WAAW,MAAM,MAAM,YAAY,MAAM,QAAQ,IAAI,OAAO,IAAI,CAAC,CAClE,CAAC,GACA,MAAM,QAAQ,MAAM,OAAO,IAAI,MAAM,OAAO,SAAS,IACjD,eAAe,MAAM,OAClB,KAAI,MAAK,MAAM,aAAa,EAAE,CAAC,CAC/B,KAAK,KAAK,CAAC,KACd,KAEP;AAED,SAAM,IAAI,GAAG,KAAK,OAAO,MAAM,OAAO;IACtC,CACH;OAGH,KAAI,MACF,kGACD;AAGH,OAAM,QAAQ,SAAS,SAAS;EAC9B,aAAa;EACb,OAAO;EACR,CAAC;;;;;;;AAQJ,eAAsBC,QAGpB,SAA4D;CAC5D,MAAM,QAAQ,QAAQ,MAAM,WAAW;AAEvC,OAAM,QAAQ,kBAAkB;AAChC,KACE,QAAQ,KAAK,aAAa,QAAQ,eAAe,YACjD,QAAQ,OAAO,WACf;AACA,UAAQ,KACN,CAAC,QAAQ,eAAe,WACpB,gFACA,QAAQ,KAAK,aAAa,QAAQ,cAAc,WAC9C,mGACA,qEACP;AAED,QAAMC,UAAyC,QAAQ;;AAGzD,KAAI,QAAQ,OAAO,YACjB,OAAM,YACJ,SACA,MAAM,QAAQ,eAAe,CAC9B;KAED,OAAM,oBAAoB,SAAS,OAAM,QAAO;AAC9C,QAAM,YAA6C,SAAS,IAAI;GAChE;AAGJ,QAAO;;;;;;;;;;AChJT,eAAsBC,QAGpB,SAA4D;CAC5D,MAAM,QAAQ,QAAQ,MAAM,WAAW;AAEvC,OAAMC,UAAyC,SAAS,KAAK;AAC7D,OAAM,oBAAoB,SAAS,OAAM,QAAO;AAC9C,MAAI,MAAM,yDAAyD;AAEnE,QAAM,IAAI,GAAG,OAAOC,YAAU,IAAI,OAAO,KAAK,IAAI,OAAO,OAAO,KAAK,CAAC;AACtE,QAAM,IAAI,GAAG,OACXA,YACE,IAAI,OAAO,KACX,IAAI,OAAO,MACX,IAAI,OAAO,OAAO,cACnB,CACF;AAED,QAAM,QAAQ,SAAS,SAAS;GAC9B,aAAa;GACb,YAAY;GACb,CAAC;GACF;AAEF,QAAO;;;;;;;;;;ACvBT,eAAsBC,SAGpB,SAA4D;CAC5D,MAAM,QAAQ,QAAQ,MAAM,kCAAkC;AAE9D,OAAMC,UAAyC,SAAS,KAAK;AAC7D,OAAM,oBAAoB,SAAS,OAAM,QAAO;AAC9C,MAAI,MAAM,uDAAuD;AAEjE,QAAM,QAAQ,SAAS,UAAU;GAC/B,aAAa;GACb,OAAO;GACR,CAAC;EAEF,MAAM,QAAQ,MAAM,UAClBC,YAAU,IAAI,gBAAgB,wBAAwB,CACvD;AACD,OAAK,MAAM,QAAQ,OAAO;AACxB,OAAI,MAAM,oCAAoC,OAAO;GAErD,MAAM,WAAW,WAAW,QAAQ,KAAK;AACzC,SAAM,IAAI,GAAG,MACXA,YAAU,IAAI,OAAO,MAAM,KAAK,QAAQ,QAAQ,GAAG,CAAC,EACpD,SAAS,IAAI,CACd;;AAGH,QAAM,QAAQ,SAAS,UAAU;GAC/B,aAAa;GACb,OAAO;GACR,CAAC;AAEF,MAAI,IAAI,OAAO,gBAAgB,eAAe;GAC5C,MAAM,WAAW,MAAM,UACrBA,YAAU,IAAI,gBAAgB,6BAA6B,CAC5D;AACD,QAAK,MAAM,QAAQ,UAAU;AAC3B,QAAI,MAAM,qCAAqC,OAAO;IAEtD,MAAM,WAAW,WAAW,QAAQ,KAAK;AACzC,UAAM,IAAI,GAAG,MACXA,YAAU,IAAI,OAAO,MAAM,KAAK,QAAQ,QAAQ,GAAG,CAAC,EACpD,SAAS,IAAI,CACd;;SAEE;GACL,MAAM,WAAW,MAAM,UACrBA,YAAU,IAAI,gBAAgB,yBAAyB,CACxD;AACD,QAAK,MAAM,QAAQ,UAAU;AAC3B,QAAI,MAAM,iCAAiC,OAAO;IAElD,MAAM,WAAW,WAAW,QAAQ,KAAK;AACzC,UAAM,IAAI,GAAG,MACXA,YAAU,IAAI,OAAO,MAAM,KAAK,QAAQ,QAAQ,GAAG,CAAC,EACpD,SAAS,IAAI,CACd;;;AAIL,QAAM,QAAQ,SAAS,UAAU;GAC/B,aAAa;GACb,OAAO;GACR,CAAC;GACF;AAEF,QAAO;;;;;;;;;;;;;ACnET,eAAsBC,SAGpB,SAA4D;CAC5D,MAAM,QAAQ,QAAQ,MAAM,aAAa;AAEzC,OAAMC,UAAyC,QAAQ;AACvD,OAAM,oBAAoB,SAAS,OAAM,QAAO;AAC9C,QAAM,QAAQ,SAAS,UAAU,EAC/B,aAAa,KACd,CAAC;GACF;AAEF,QAAO;;;;;;;;;;;;;ACbT,eAAsBC,OAGpB,SAA4D;CAC5D,MAAM,QAAQ,QAAQ,MAAM,gBAAgB;AAE5C,OAAMC,UAAyC,QAAQ;AACvD,OAAM,oBAAoB,SAAS,OAAM,QAAO;AAC9C,QAAM,QAAQ,SAAS,QAAQ,EAC7B,aAAa,KACd,CAAC;GACF;AAEF,QAAO;;;;;;;;;;;;;ACbT,eAAsBC,OAGpB,SAA4D;CAC5D,MAAM,QAAQ,QAAQ,MAAM,UAAU;AAEtC,OAAMC,UAAyC,QAAQ;AACvD,OAAM,oBAAoB,SAAS,OAAM,QAAO;AAC9C,QAAM,QAAQ,SAAS,QAAQ;GAC7B,aAAa;GACb,YAAY;GACb,CAAC;GACF;AAEF,QAAO;;;;;;;;;;;;;ACdT,eAAsBC,OAGpB,SAA4D;CAC5D,MAAM,QAAQ,QAAQ,MAAM,UAAU;AAEtC,OAAMC,UAAQ,QAAQ;AACtB,OAAM,oBAAoB,SAAS,OAAM,QAAO;AAC9C,QAAM,QAAQ,SAAS,QAAQ;GAC7B,aAAa;GACb,YAAY;GACb,CAAC;GACF;AAEF,QAAO;;;;;;;;;;;;;ACAT,eAAsBC,QAGpB,SAA4D;CAC5D,MAAM,QAAQ,QAAQ,MAAM,kBAAkB;AAC9C,SAAQ,MACN,gEACD;AAED,OAAM,oBAAoB,SAAS,OAAM,QAAO;AAC9C,MAAI,MACF,kEACD;AAED,QAAM,QAAQ,SAAS,kBAAkB;GACvC,aAAa;GACb,OAAO;GACR,CAAC;AAEF,QAAM,mBAAoD,IAAI;AAE9D,QAAM,QAAQ,SAAS,kBAAkB;GACvC,aAAa;GACb,OAAO;GACR,CAAC;AAEF,MAAI,IAAI,MAAM,SAAS,EACrB,KAAI,MACF,8BACE,SAAS,IAAI,OAAO,MAAM,GACtB,OAAO,KAAK,IAAI,OAAO,MAAM,CAAC,SAC9B,QAAQ,IAAI,OAAO,MAAM,CAAC,OAC/B,wCACC,IAAI,MAAM,OACX,0BAA0B,IAAI,OAAO,MAAM,UAC1C,IAAI,MAAM,SAAS,KAAK,IAAI,MAAM,SAAS,KACvC,OAAO,IAAI,MACR,KACC,UACE,KAAK,MAAM,OACT,MAAM,SAAS,OAAO,MAAM,WAAW,KAE5C,CACA,KAAK,MAAM,KACd,KAEP;MAED,KAAI,KACF,qCACE,IAAI,OAAO,MACZ,8HACF;AAGH,QAAM,gBAAiD,IAAI;AAC3D,QAAM,oBAAoB,IAAI;AAE9B,QAAM,QAAQ,SAAS,kBAAkB;GACvC,aAAa;GACb,OAAO;GACR,CAAC;AAEF,UAAQ,MACN,mDAAmD,iBAAiB;GAClE,GAAG,IAAI;GACP,YAAY,YAAY,IAAI,OAAO,WAAW,GAC1C,KAAK,IAAI,OAAO,YAAY,CAAC,UAAU,CAAC,GACxC;GACJ,cAAc,YAAY,IAAI,OAAO,aAAa,GAC9C,IAAI,OAAO,eACX;GACJ,SAAS,IAAI,QAAQ,KAAI,WAAU,OAAO,KAAK;GAChD,CAAC,GACH;AAED,MAAI,CAAC,IAAI,GAAG,WAAW,IAAI,UAAU,CACnC,OAAM,gBAAgB,IAAI,UAAU;AAGtC,MAAI,CAAC,IAAI,GAAG,WAAW,IAAI,SAAS,CAClC,OAAM,gBAAgB,IAAI,SAAS;AAGrC,MACE,IAAI,OAAO,cAAc,QACzB,IAAI,eAAe,aAAa,IAAI,KAAK,SAEzC,KAAI,MACF,wEACD;OACI;AACL,OAAI,KACF,mFACD;AAED,SAAMC,UAAQ,SAAS,KAAK;;AAG9B,QAAM,YAAY,SAAS,IAAI;AAE/B,UAAQ,MAAM,oDAAoD;AAElE,QAAM,OAAO,KAAK,IAAI,WAAY,MAAM,IAAI,GAAG,KAAK,IAAI,UAAU,IAAK,GAAG;AAE1E,QAAM,cAAc,IAAI;AACxB,MAAI,gBAAgB,IAAI;GACxB;AAEF,QAAO;;;;;;;;;;;AC7HT,SAAgB,oBAKd,SAA+D;AAC/D,QAAO,OAAO,YACZ,OAAO,QAAQ,QAAQ,CAAC,KAAK,CAAC,QAAQ,QAAQ,CAC5C,QACA,OAAO,WAAgC;EACrC,MAAM,UAAW,MAAM,2BAA2B,KAChD,OAAO,SACP,OAAO,gBAAgB,EAAE,CAC1B;AACD,UAAQ,OAAO,KACb,YAAY,OAAO,cAAc,OAAO,QAAQ,YAAY,GAC7D;AAED,QAAM,oBAAoB,QAA2C;AAErE,QAAM,GAAG,QAAQ;GAEpB,CAAC,CACH;;;;;ACxBH,MAAM,gBAAgB,oBAAoB;CACxC,OAAOC;CACP,SAASC;CACT,QAAQC;CACR,OAAOC;CACP,MAAMC;CACN,MAAMC;CACN,OAAOC;CACP,MAAMC;CACN,QAAQC;CACT,CAAC;AAEF,MAAa,QAAQ,cAAc;AACnC,MAAa,UAAU,cAAc;AACrC,MAAa,SAAS,cAAc;AACpC,MAAa,QAAQ,cAAc;AACnC,MAAa,OAAO,cAAc;AAClC,MAAa,OAAO,cAAc;AAClC,MAAa,QAAQ,cAAc;AACnC,MAAa,OAAO,cAAc;AAClC,MAAa,SAAS,cAAc"}
+{"version":3,"file":"execution-host.mjs","names":["prepare","formatFolder","build","prepare","clean","prepare","joinPaths","create","prepare","joinPaths","deploy","prepare","docs","prepare","lint","prepare","test","prepare","types","prepare","createDevframeRpcClient","createRpcClient","createRpcClient","executeTypes","executePrepare","executeCreate","executeClean","executeLint","executeTest","executeBuild","executeDocs","executeDeploy"],"sources":["../../src/api/prepare.ts","../../src/api/build.ts","../../src/api/clean.ts","../../src/api/create.ts","../../src/api/deploy.ts","../../src/api/docs.ts","../../src/api/lint.ts","../../src/api/test.ts","../../src/api/types.ts","../../src/helpers/rpc.ts","../../src/helpers/create-execution-host.ts","../../src/execution-host.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                   ⚡ Storm Software - Powerlines\n\n This code was released as part of the Powerlines project. Powerlines\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/powerlines.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/powerlines\n Documentation:            https://docs.stormsoftware.com/projects/powerlines\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport type { ExecutionContext } from \"@powerlines/core\";\nimport { executeEnvironments } from \"@powerlines/core/lib/environment\";\nimport { handleTypes } from \"@powerlines/core/lib/generate-types\";\nimport { installDependencies } from \"@powerlines/core/lib/install-dependencies\";\nimport { writeMetaFile } from \"@powerlines/core/lib/meta\";\nimport {\n  initializeTsconfig,\n  resolveTsconfig\n} from \"@powerlines/core/lib/typescript/tsconfig\";\nimport { formatFolder } from \"@powerlines/core/lib/utilities/format\";\nimport { formatConfig } from \"@powerlines/core/plugin-utils\";\nimport { toArray } from \"@stryke/convert/to-array\";\nimport { createDirectory } from \"@stryke/fs/helpers\";\nimport { isObject } from \"@stryke/type-checks/is-object\";\nimport { EngineResolvedConfig } from \"../types/config\";\nimport { EngineSystemContext } from \"../types/context\";\n\n/**\n * Prepare the project\n *\n * @param context - The execution context for the build process, which provides access to the project configuration, environment, and utility functions for performing the build. The context is used to manage the state and behavior of the build process, allowing for hooks to be called at different stages of the build and for environment-specific configurations to be applied.\n */\nexport async function prepare<\n  TResolvedConfig extends EngineResolvedConfig,\n  TSystemContext extends EngineSystemContext\n>(\n  context: ExecutionContext<TResolvedConfig, TSystemContext>,\n  skipTypes = false\n) {\n  const timer = context.timer(\"Preparation\");\n\n  await executeEnvironments(context, async env => {\n    env.debug(\n      `Initializing the processing options for the Powerlines project.`\n    );\n\n    await context.callHook(\"configResolved\", {\n      environment: env,\n      order: \"pre\"\n    });\n\n    await initializeTsconfig<TResolvedConfig, TSystemContext>(env);\n\n    await context.callHook(\"configResolved\", {\n      environment: env,\n      order: \"normal\"\n    });\n\n    if (env.entry.length > 0) {\n      env.debug(\n        `The configuration provided ${\n          isObject(env.config.input)\n            ? Object.keys(env.config.input).length\n            : toArray(env.config.input).length\n        } entry point(s), Powerlines has found ${\n          env.entry.length\n        } entry files(s) for the ${env.config.title} project${\n          env.entry.length > 0 && env.entry.length < 10\n            ? `: \\n${env.entry\n                .map(\n                  entry =>\n                    `- ${entry.file}${\n                      entry.output ? ` -> ${entry.output}` : \"\"\n                    }`\n                )\n                .join(\" \\n\")}`\n            : \"\"\n        }`\n      );\n    } else {\n      env.warn(\n        `No entry files were found for the ${\n          env.config.title\n        } project. Please ensure this is correct. Powerlines plugins generally require at least one entry point to function properly.`\n      );\n    }\n\n    await resolveTsconfig<TResolvedConfig, TSystemContext>(env);\n    await installDependencies(env);\n\n    await context.callHook(\"configResolved\", {\n      environment: env,\n      order: \"post\"\n    });\n\n    env.trace({\n      meta: {\n        category: \"config\"\n      },\n      message: `Powerlines configuration after configResolved hook: \\n${formatConfig(\n        env.config\n      )}`\n    });\n\n    if (!env.fs.existsSync(env.cachePath)) {\n      await createDirectory(env.cachePath);\n    }\n\n    if (!env.fs.existsSync(env.dataPath)) {\n      await createDirectory(env.dataPath);\n    }\n\n    await context.callHook(\"prepare\", {\n      environment: env,\n      order: \"pre\"\n    });\n    await context.callHook(\"prepare\", {\n      environment: env,\n      order: \"normal\"\n    });\n\n    await context.callHook(\"prepare\", {\n      environment: env,\n      order: \"post\"\n    });\n\n    if (!skipTypes && env.config.output.types !== false) {\n      await handleTypes(context, env);\n    }\n\n    context.debug(\"Formatting files generated during the prepare step.\");\n\n    await Promise.all([\n      formatFolder(env, env.builtinsPath),\n      formatFolder(env, env.entryPath)\n    ]);\n\n    await writeMetaFile(env);\n    env.persistedMeta = env.meta;\n  });\n\n  timer();\n}\n","/* -------------------------------------------------------------------\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 {\n  EnvironmentContext,\n  ExecutionContext,\n  formatFolder\n} from \"@powerlines/core\";\nimport { executeEnvironments } from \"@powerlines/core/lib/environment\";\nimport { copyFiles } from \"@stryke/fs/copy-file\";\nimport { appendPath } from \"@stryke/path/append\";\nimport { relativePath } from \"@stryke/path/file-path-fns\";\nimport { isParentPath } from \"@stryke/path/is-parent-path\";\nimport { joinPaths } from \"@stryke/path/join-paths\";\nimport { replacePath } from \"@stryke/path/replace\";\nimport chalk from \"chalk\";\nimport { existsSync } from \"node:fs\";\nimport { EngineResolvedConfig } from \"../types/config\";\nimport { EngineSystemContext } from \"../types/context\";\nimport { prepare } from \"./prepare\";\n\nasync function handleBuild<\n  TResolvedConfig extends EngineResolvedConfig,\n  TSystemContext extends EngineSystemContext\n>(\n  context: ExecutionContext<TResolvedConfig, TSystemContext>,\n  env: EnvironmentContext<TResolvedConfig, TSystemContext>\n) {\n  await context.callHook(\"build\", {\n    environment: env,\n    order: \"pre\"\n  });\n\n  env.debug(\n    \"Formatting the generated entry files before the build process starts.\"\n  );\n  await formatFolder(env, env.entryPath);\n\n  await context.callHook(\"build\", {\n    environment: env,\n    order: \"normal\"\n  });\n\n  if (env.config.output.copy) {\n    env.debug(\"Copying project's files from build output directory.\");\n\n    const destinationPath = isParentPath(\n      appendPath(env.config.output.path, env.config.cwd),\n      appendPath(env.config.root, env.config.cwd)\n    )\n      ? joinPaths(\n          env.config.output.copy.path,\n          relativePath(\n            appendPath(env.config.root, env.config.cwd),\n            appendPath(env.config.output.path, env.config.cwd)\n          )\n        )\n      : joinPaths(env.config.output.copy.path, \"dist\");\n    const sourcePath = env.config.output.path;\n\n    if (existsSync(sourcePath) && sourcePath !== destinationPath) {\n      env.debug(\n        `Copying files from project's build output directory (${\n          env.config.output.path\n        }) to the project's copy/publish directory (${destinationPath}).`\n      );\n\n      await copyFiles(sourcePath, destinationPath);\n    } else {\n      env.warn(\n        `The source path for the copy operation ${\n          !existsSync(sourcePath)\n            ? \"does not exist\"\n            : \"is the same as the destination path\"\n        }. Source: ${sourcePath}, Destination: ${\n          destinationPath\n        }. Skipping copying of build output files.`\n      );\n    }\n\n    if (\n      env.config.output.copy.assets &&\n      Array.isArray(env.config.output.copy.assets)\n    ) {\n      await Promise.all(\n        env.config.output.copy.assets.map(async asset => {\n          env.trace(\n            `Copying asset(s): ${chalk.redBright(\n              env.config.cwd === asset.input\n                ? asset.glob\n                : appendPath(\n                    asset.glob,\n                    replacePath(asset.input, env.config.cwd)\n                  )\n            )} -> ${chalk.greenBright(\n              appendPath(asset.glob, replacePath(asset.output, env.config.cwd))\n            )} ${\n              Array.isArray(asset.ignore) && asset.ignore.length > 0\n                ? ` (ignoring: ${asset.ignore\n                    .map(i => chalk.yellowBright(i))\n                    .join(\", \")})`\n                : \"\"\n            }`\n          );\n\n          await env.fs.copy(asset, asset.output);\n        })\n      );\n    }\n  } else {\n    env.debug(\n      \"No copy configuration found for the project output. Skipping the copying of build output files.\"\n    );\n  }\n\n  await context.callHook(\"build\", {\n    environment: env,\n    order: \"post\"\n  });\n}\n\n/**\n * Build the project\n *\n * @param context - The execution context for the build process, which provides access to the project configuration, environment, and utility functions for performing the build. The context is used to manage the state and behavior of the build process, allowing for hooks to be called at different stages of the build and for environment-specific configurations to be applied.\n */\nexport async function build<\n  TResolvedConfig extends EngineResolvedConfig,\n  TSystemContext extends EngineSystemContext\n>(context: ExecutionContext<TResolvedConfig, TSystemContext>) {\n  const timer = context.timer(\"Building\");\n\n  await context.generateChecksum();\n  if (\n    context.meta.checksum !== context.persistedMeta?.checksum ||\n    context.config.skipCache\n  ) {\n    context.info(\n      !context.persistedMeta?.checksum\n        ? \"No previous build cache found. Preparing the project for the initial build.\"\n        : context.meta.checksum !== context.persistedMeta.checksum\n          ? \"The project has been modified since the last time `prepare` was ran. Re-preparing the project.\"\n          : \"The project is configured to skip cache. Re-preparing the project.\"\n    );\n\n    await prepare<TResolvedConfig, TSystemContext>(context);\n  }\n\n  if (context.config.singleBuild) {\n    await handleBuild<TResolvedConfig, TSystemContext>(\n      context,\n      await context.toEnvironment()\n    );\n  } else {\n    await executeEnvironments(context, async env => {\n      await handleBuild<TResolvedConfig, TSystemContext>(context, env);\n    });\n  }\n\n  timer();\n}\n","/* -------------------------------------------------------------------\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 { ExecutionContext } from \"@powerlines/core\";\nimport { executeEnvironments } from \"@powerlines/core/lib/environment\";\nimport { joinPaths } from \"@stryke/path/join\";\nimport { EngineResolvedConfig } from \"../types/config\";\nimport { EngineSystemContext } from \"../types/context\";\nimport { prepare } from \"./prepare\";\n\n/**\n * Clean any previously prepared artifacts\n *\n * @param context - The execution context for the clean process, which provides access to the project configuration, environment, and utility functions for performing the clean operation. The context is used to manage the state and behavior of the clean process, allowing for hooks to be called at different stages of the clean and for environment-specific configurations to be applied.\n */\nexport async function clean<\n  TResolvedConfig extends EngineResolvedConfig,\n  TSystemContext extends EngineSystemContext\n>(context: ExecutionContext<TResolvedConfig, TSystemContext>) {\n  const timer = context.timer(\"Cleaning\");\n\n  await prepare<TResolvedConfig, TSystemContext>(context, true);\n  await executeEnvironments(context, async env => {\n    env.debug(\"Cleaning the project's dist and artifacts directories.\");\n\n    await env.fs.remove(joinPaths(env.config.cwd, env.config.output.path));\n    await env.fs.remove(\n      joinPaths(\n        env.config.cwd,\n        env.config.root,\n        env.config.output.artifactsPath\n      )\n    );\n\n    await context.callHook(\"clean\", {\n      environment: env,\n      sequential: false\n    });\n  });\n\n  timer();\n}\n","/* -------------------------------------------------------------------\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 { ExecutionContext } from \"@powerlines/core\";\nimport { executeEnvironments } from \"@powerlines/core/lib/environment\";\nimport { listFiles } from \"@stryke/fs/list-files\";\nimport { joinPaths } from \"@stryke/path/join\";\nimport Handlebars from \"handlebars\";\nimport { EngineResolvedConfig } from \"../types/config\";\nimport { EngineSystemContext } from \"../types/context\";\nimport { prepare } from \"./prepare\";\n\n/**\n * Create a new Powerlines project\n *\n * @param context - The execution context for the create process, which provides access to the project configuration, environment, and utility functions for performing the create operation. The context is used to manage the state and behavior of the create process, allowing for hooks to be called at different stages of the create and for environment-specific configurations to be applied.\n */\nexport async function create<\n  TResolvedConfig extends EngineResolvedConfig,\n  TSystemContext extends EngineSystemContext\n>(context: ExecutionContext<TResolvedConfig, TSystemContext>) {\n  const timer = context.timer(\"Create a New Project Generation\");\n\n  await prepare<TResolvedConfig, TSystemContext>(context, true);\n  await executeEnvironments(context, async env => {\n    env.debug(\"Initializing the processing options for the project.\");\n\n    await context.callHook(\"create\", {\n      environment: env,\n      order: \"pre\"\n    });\n\n    const files = await listFiles(\n      joinPaths(env.powerlinesPath, \"files/common/**/*.hbs\")\n    );\n    for (const file of files) {\n      env.trace(`Adding template file to project: ${file}`);\n\n      const template = Handlebars.compile(file);\n      await env.fs.write(\n        joinPaths(env.config.root, file.replace(\".hbs\", \"\")),\n        template(env)\n      );\n    }\n\n    await context.callHook(\"create\", {\n      environment: env,\n      order: \"normal\"\n    });\n\n    if (env.config.projectType === \"application\") {\n      const appFiles = await listFiles(\n        joinPaths(env.powerlinesPath, \"files/application/**/*.hbs\")\n      );\n      for (const file of appFiles) {\n        env.trace(`Adding application template file: ${file}`);\n\n        const template = Handlebars.compile(file);\n        await env.fs.write(\n          joinPaths(env.config.root, file.replace(\".hbs\", \"\")),\n          template(env)\n        );\n      }\n    } else {\n      const libFiles = await listFiles(\n        joinPaths(env.powerlinesPath, \"files/library/**/*.hbs\")\n      );\n      for (const file of libFiles) {\n        env.trace(`Adding library template file: ${file}`);\n\n        const template = Handlebars.compile(file);\n        await env.fs.write(\n          joinPaths(env.config.root, file.replace(\".hbs\", \"\")),\n          template(env)\n        );\n      }\n    }\n\n    await context.callHook(\"create\", {\n      environment: env,\n      order: \"post\"\n    });\n  });\n\n  timer();\n}\n","/* -------------------------------------------------------------------\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 { ExecutionContext } from \"@powerlines/core\";\nimport { executeEnvironments } from \"@powerlines/core/lib/environment\";\nimport { EngineResolvedConfig } from \"../types/config\";\nimport { EngineSystemContext } from \"../types/context\";\nimport { prepare } from \"./prepare\";\n\n/**\n * Deploy the project's source files to the target environment.\n *\n * @remarks\n * This function serves as the main entry point for the deployment process, orchestrating the execution of deployment hooks across different environments defined in the project configuration. It ensures that all relevant deployment operations are performed in a structured manner, allowing for pre-deployment, main deployment, and post-deployment hooks to be executed at the appropriate stages of the process. The function also utilizes a timer to measure the duration of the deployment operation, providing insights into the performance of the deployment process.\n *\n * @param context - The execution context for the deploy process, which provides access to the project configuration, environment, and utility functions for performing the deploy operation. The context is used to manage the state and behavior of the deploy process, allowing for hooks to be called at different stages of the deploy and for environment-specific configurations to be applied.\n */\nexport async function deploy<\n  TResolvedConfig extends EngineResolvedConfig,\n  TSystemContext extends EngineSystemContext\n>(context: ExecutionContext<TResolvedConfig, TSystemContext>) {\n  const timer = context.timer(\"Deployment\");\n\n  await prepare<TResolvedConfig, TSystemContext>(context);\n  await executeEnvironments(context, async env => {\n    await context.callHook(\"deploy\", {\n      environment: env\n    });\n  });\n\n  timer();\n}\n","/* -------------------------------------------------------------------\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 { ExecutionContext } from \"@powerlines/core\";\nimport { executeEnvironments } from \"@powerlines/core/lib/environment\";\nimport { EngineResolvedConfig } from \"../types/config\";\nimport { EngineSystemContext } from \"../types/context\";\nimport { prepare } from \"./prepare\";\n\n/**\n * Generate the project's documentation.\n *\n * @remarks\n * This function serves as the main entry point for the documentation generation process, orchestrating the execution of documentation hooks across different environments defined in the project configuration. It ensures that all relevant documentation operations are performed in a structured manner, allowing for pre-documentation, main documentation, and post-documentation hooks to be executed at the appropriate stages of the process. The function also utilizes a timer to measure the duration of the documentation operation, providing insights into the performance of the documentation process.\n *\n * @param context - The execution context for the documentation process, which provides access to the project configuration, environment, and utility functions for performing the documentation operation. The context is used to manage the state and behavior of the documentation process, allowing for hooks to be called at different stages of the documentation and for environment-specific configurations to be applied.\n */\nexport async function docs<\n  TResolvedConfig extends EngineResolvedConfig,\n  TSystemContext extends EngineSystemContext\n>(context: ExecutionContext<TResolvedConfig, TSystemContext>) {\n  const timer = context.timer(\"Documentation\");\n\n  await prepare<TResolvedConfig, TSystemContext>(context);\n  await executeEnvironments(context, async env => {\n    await context.callHook(\"docs\", {\n      environment: env\n    });\n  });\n\n  timer();\n}\n","/* -------------------------------------------------------------------\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 { ExecutionContext } from \"@powerlines/core\";\nimport { executeEnvironments } from \"@powerlines/core/lib/environment\";\nimport { EngineResolvedConfig } from \"../types/config\";\nimport { EngineSystemContext } from \"../types/context\";\nimport { prepare } from \"./prepare\";\n\n/**\n * Lint the project's source files and report any issues found.\n *\n * @remarks\n * This function serves as the main entry point for the linting process, orchestrating the execution of linting hooks across different environments defined in the project configuration. It ensures that all relevant linting operations are performed in a structured manner, allowing for pre-linting, main linting, and post-linting hooks to be executed at the appropriate stages of the process. The function also utilizes a timer to measure the duration of the linting operation, providing insights into the performance of the linting process.\n *\n * @param context - The execution context for the lint process, which provides access to the project configuration, environment, and utility functions for performing the lint operation. The context is used to manage the state and behavior of the lint process, allowing for hooks to be called at different stages of the lint and for environment-specific configurations to be applied.\n */\nexport async function lint<\n  TResolvedConfig extends EngineResolvedConfig,\n  TSystemContext extends EngineSystemContext\n>(context: ExecutionContext<TResolvedConfig, TSystemContext>) {\n  const timer = context.timer(\"Linting\");\n\n  await prepare<TResolvedConfig, TSystemContext>(context);\n  await executeEnvironments(context, async env => {\n    await context.callHook(\"lint\", {\n      environment: env,\n      sequential: false\n    });\n  });\n\n  timer();\n}\n","/* -------------------------------------------------------------------\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 { ExecutionContext } from \"@powerlines/core\";\nimport { executeEnvironments } from \"@powerlines/core/lib/environment\";\nimport { EngineResolvedConfig } from \"../types/config\";\nimport { EngineSystemContext } from \"../types/context\";\nimport { prepare } from \"./prepare\";\n\n/**\n * Test the project's source files and report any issues found.\n *\n * @remarks\n * This function serves as the main entry point for the testing process, orchestrating the execution of testing hooks across different environments defined in the project configuration. It ensures that all relevant testing operations are performed in a structured manner, allowing for pre-testing, main testing, and post-testing hooks to be executed at the appropriate stages of the process. The function also utilizes a timer to measure the duration of the testing operation, providing insights into the performance of the testing process.\n *\n * @param context - The execution context for the test process, which provides access to the project configuration, environment, and utility functions for performing the test operation. The context is used to manage the state and behavior of the test process, allowing for hooks to be called at different stages of the test and for environment-specific configurations to be applied.\n */\nexport async function test<\n  TResolvedConfig extends EngineResolvedConfig,\n  TSystemContext extends EngineSystemContext\n>(context: ExecutionContext<TResolvedConfig, TSystemContext>) {\n  const timer = context.timer(\"Testing\");\n\n  await prepare(context);\n  await executeEnvironments(context, async env => {\n    await context.callHook(\"test\", {\n      environment: env,\n      sequential: false\n    });\n  });\n\n  timer();\n}\n","/* -------------------------------------------------------------------\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 { executeEnvironments } from \"@powerlines/core/lib/environment\";\nimport { handleTypes } from \"@powerlines/core/lib/generate-types\";\nimport { installDependencies } from \"@powerlines/core/lib/install-dependencies\";\nimport { writeMetaFile } from \"@powerlines/core/lib/meta\";\nimport {\n  initializeTsconfig,\n  resolveTsconfig\n} from \"@powerlines/core/lib/typescript/tsconfig\";\nimport { format } from \"@powerlines/core/lib/utilities/format\";\nimport { ExecutionContext } from \"@powerlines/core/types/context\";\nimport { formatLogMessage } from \"@storm-software/config-tools/logger\";\nimport { toArray } from \"@stryke/convert/to-array\";\nimport { createDirectory } from \"@stryke/fs/helpers\";\nimport { omit } from \"@stryke/helpers/omit\";\nimport { isObject } from \"@stryke/type-checks/is-object\";\nimport { isSetObject } from \"@stryke/type-checks/is-set-object\";\nimport { EngineResolvedConfig } from \"../types/config\";\nimport { EngineSystemContext } from \"../types/context\";\nimport { prepare } from \"./prepare\";\n\n/**\n * Generate runtime types for the Powerlines project.\n *\n * @remarks\n * This function is responsible for generating TypeScript declaration files based on the project's configuration and environment. It executes hooks at various stages of the type generation process, allowing for customization and extension by plugins. The generated types are formatted and written to the appropriate location in the project's file system, ensuring that they are available for use by other parts of the Powerlines system and by end-users of the project.\n *\n * @param context - The execution context for the build process, which provides access to the project configuration, environment, and utility functions for performing the build. The context is used to manage the state and behavior of the build process, allowing for hooks to be called at different stages of the build and for environment-specific configurations to be applied.\n */\nexport async function types<\n  TResolvedConfig extends EngineResolvedConfig,\n  TSystemContext extends EngineSystemContext\n>(context: ExecutionContext<TResolvedConfig, TSystemContext>) {\n  const timer = context.timer(\"Type Generation\");\n  context.debug(\n    \" Aggregating configuration options for the Powerlines project\"\n  );\n\n  await executeEnvironments(context, async env => {\n    env.debug(\n      `Initializing the processing options for the Powerlines project.`\n    );\n\n    await context.callHook(\"configResolved\", {\n      environment: env,\n      order: \"pre\"\n    });\n\n    await initializeTsconfig<TResolvedConfig, TSystemContext>(env);\n\n    await context.callHook(\"configResolved\", {\n      environment: env,\n      order: \"normal\"\n    });\n\n    if (env.entry.length > 0) {\n      env.debug(\n        `The configuration provided ${\n          isObject(env.config.input)\n            ? Object.keys(env.config.input).length\n            : toArray(env.config.input).length\n        } entry point(s), Powerlines has found ${\n          env.entry.length\n        } entry files(s) for the ${env.config.title} project${\n          env.entry.length > 0 && env.entry.length < 10\n            ? `: \\n${env.entry\n                .map(\n                  entry =>\n                    `- ${entry.file}${\n                      entry.output ? ` -> ${entry.output}` : \"\"\n                    }`\n                )\n                .join(\" \\n\")}`\n            : \"\"\n        }`\n      );\n    } else {\n      env.warn(\n        `No entry files were found for the ${\n          env.config.title\n        } project. Please ensure this is correct. Powerlines plugins generally require at least one entry point to function properly.`\n      );\n    }\n\n    await resolveTsconfig<TResolvedConfig, TSystemContext>(env);\n    await installDependencies(env);\n\n    await context.callHook(\"configResolved\", {\n      environment: env,\n      order: \"post\"\n    });\n\n    context.trace(\n      `Powerlines configuration has been resolved: \\n\\n${formatLogMessage({\n        ...env.config,\n        userConfig: isSetObject(env.config.userConfig)\n          ? omit(env.config.userConfig, [\"plugins\"])\n          : undefined,\n        inlineConfig: isSetObject(env.config.inlineConfig)\n          ? env.config.inlineConfig\n          : undefined,\n        plugins: env.plugins.map(plugin => plugin.name)\n      })}`\n    );\n\n    if (!env.fs.existsSync(env.cachePath)) {\n      await createDirectory(env.cachePath);\n    }\n\n    if (!env.fs.existsSync(env.dataPath)) {\n      await createDirectory(env.dataPath);\n    }\n\n    if (\n      env.config.skipCache === true ||\n      env.persistedMeta?.checksum !== env.meta.checksum\n    ) {\n      env.debug(\n        `Using previously prepared files as the meta checksum has not changed.`\n      );\n    } else {\n      env.info(\n        `Running \\`prepare\\` command as the meta checksum has changed since the last run.`\n      );\n\n      await prepare(context, true);\n    }\n\n    await handleTypes(context, env);\n\n    context.debug(\"Formatting files generated during the types step.\");\n\n    await format(env, env.typesPath, (await env.fs.read(env.typesPath)) ?? \"\");\n\n    await writeMetaFile(env);\n    env.persistedMeta = env.meta;\n  });\n\n  timer();\n}\n","/* -------------------------------------------------------------------\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 { createEventEmitter } from \"@powerlines/core/lib/events\";\nimport { isNumber } from \"@stryke/type-checks/is-number\";\nimport { isSet } from \"@stryke/type-checks/is-set\";\nimport { StormURL } from \"@stryke/url\";\nimport { BirpcOptions } from \"birpc\";\nimport {\n  createRpcStreamingClientHost,\n  DevToolsClientRpcHost,\n  DevToolsRpcClientMode,\n  RpcClientEvents\n} from \"devframe/client\";\nimport { RpcCacheManager, RpcFunctionsCollectorBase } from \"devframe/rpc\";\nimport { createRpcClient as createDevframeRpcClient } from \"devframe/rpc/client\";\nimport {\n  createWsRpcChannel,\n  WsRpcChannelOptions\n} from \"devframe/rpc/transports/ws-client\";\nimport {\n  ConnectionMeta,\n  EventEmitter as DevFrameEventEmitter\n} from \"devframe/types\";\nimport { promiseWithResolver } from \"devframe/utils/promise\";\nimport { humanId } from \"human-id\";\nimport { EventEmitter } from \"node:events\";\nimport { RpcClientOptions } from \"../types/config\";\nimport {\n  RpcClient,\n  RpcClientFunctions,\n  RpcContext,\n  RpcServerFunctions\n} from \"../types/rpc\";\n\nfunction createWsRpcClientMode(\n  baseURL: StormURL,\n  connectionMeta: ConnectionMeta,\n  events: DevFrameEventEmitter<RpcClientEvents>,\n  clientRpc: DevToolsClientRpcHost,\n  authToken: string = humanId({ separator: \"-\", capitalize: false }),\n  rpcOptions: Partial<\n    BirpcOptions<RpcServerFunctions, RpcClientFunctions, boolean>\n  > = {},\n  wsOptions: Partial<WsRpcChannelOptions> = {}\n): DevToolsRpcClientMode {\n  let isTrusted = false;\n  const trustedPromise = promiseWithResolver<boolean>();\n  const url =\n    isNumber(connectionMeta.websocket) ||\n    (isSet(connectionMeta.websocket) &&\n      `${+connectionMeta.websocket}` === `${connectionMeta.websocket}`)\n      ? `${baseURL.protocol.replace(\"http\", \"ws\")}//${baseURL.hostname}:${connectionMeta.websocket}`\n      : (connectionMeta.websocket as string);\n\n  // Build a minimal `defs` map from the connection meta so the per-call\n  // wire serializer dispatches outgoing requests with the correct\n  // encoding (JSON for `jsonSerializable: true` methods; structured-\n  // clone for the rest).\n  const definitions = new Map<string, { jsonSerializable: true }>();\n  for (const name of connectionMeta.jsonSerializableMethods ?? [])\n    definitions.set(name, { jsonSerializable: true });\n\n  const serverRpc = createDevframeRpcClient<\n    RpcServerFunctions,\n    RpcClientFunctions\n  >(clientRpc.functions, {\n    channel: createWsRpcChannel({\n      url,\n      authToken,\n      definitions,\n      ...wsOptions\n    }),\n    rpcOptions\n  });\n\n  // Handle server-initiated auth revocation\n  clientRpc.register({\n    name: \"devframe:auth:revoked\",\n    type: \"event\",\n    handler: () => {\n      isTrusted = false;\n      events.emit(\"rpc:is-trusted:updated\", false);\n    }\n  });\n\n  let currentAuthToken = authToken;\n\n  async function requestTrustWithToken(token: string) {\n    currentAuthToken = token;\n\n    // const info = parseUA(navigator.userAgent);\n    // const ua = [\n    //   \"powerlines\",\n    //   \"1.0\",\n    //   \"|\",\n    //   info.os.name,\n    //   info.os.version,\n    //   info.device.type\n    // ]\n    //   .filter(i => i)\n    //   .join(\" \");\n\n    // const result = await serverRpc.$call(\"vite:anonymous:auth\", {\n    //   authToken: token,\n    //   ua,\n    //   origin: baseURL.origin\n    // });\n\n    // isTrusted = result.isTrusted;\n    // trustedPromise.resolve(isTrusted);\n    // events.emit(\"rpc:is-trusted:updated\", isTrusted);\n    // return result.isTrusted;\n\n    return true;\n  }\n\n  async function requestTrust() {\n    if (isTrusted) return true;\n    return requestTrustWithToken(currentAuthToken);\n  }\n\n  async function ensureTrusted(timeout = 60_000): Promise<boolean> {\n    if (isTrusted) trustedPromise.resolve(true);\n\n    if (timeout <= 0) return trustedPromise.promise;\n\n    let clear = () => {};\n    await Promise.race([\n      trustedPromise.promise.then(clear),\n      new Promise((resolve, reject) => {\n        const id = setTimeout(() => {\n          reject(new Error(\"Timeout waiting for rpc to be trusted\"));\n        }, timeout);\n        clear = () => clearTimeout(id);\n      })\n    ]);\n\n    return isTrusted;\n  }\n\n  return {\n    get isTrusted() {\n      return isTrusted;\n    },\n    requestTrust,\n    requestTrustWithToken,\n    ensureTrusted,\n    call: (...args: any): any => {\n      return serverRpc.$call(\n        // @ts-expect-error casting\n        ...args\n      );\n    },\n    callEvent: (...args: any): any => {\n      return serverRpc.$callEvent(\n        // @ts-expect-error casting\n        ...args\n      );\n    },\n    callOptional: (...args: any): any => {\n      return serverRpc.$callOptional(\n        // @ts-expect-error casting\n        ...args\n      );\n    }\n  };\n}\n\nconst CONNECTION_AUTH_TOKEN_KEY = \"__DEVTOOLS_CONNECTION_AUTH_TOKEN__\";\n\nexport function createRpcClient(options: RpcClientOptions) {\n  const baseURL = new StormURL(options.baseURL);\n\n  const cacheManager = new RpcCacheManager({\n    functions: [],\n    ...(typeof options.cacheOptions === \"object\" ? options.cacheOptions : {})\n  });\n  const context: RpcContext = {\n    rpc: undefined!\n  };\n\n  const clientRpc: DevToolsClientRpcHost = new RpcFunctionsCollectorBase<\n    RpcClientFunctions,\n    RpcContext\n  >(context);\n\n  EventEmitter.setMaxListeners(100);\n  const events = createEventEmitter<RpcClientEvents>();\n\n  const mode = createWsRpcClientMode(\n    baseURL,\n    options.connection,\n    events,\n    clientRpc,\n    undefined,\n    {\n      ...options.rpcOptions,\n      async onRequest(req, next, resolve) {\n        await options.rpcOptions?.onRequest?.call(this, req, next, resolve);\n        if (options.cacheOptions && cacheManager?.validate(req.m)) {\n          const cached = cacheManager.cached(req.m, req.a);\n          if (cached) {\n            return resolve(cached);\n          } else {\n            const res = await next(req);\n            cacheManager?.apply(req, res);\n          }\n        } else {\n          await next(req);\n        }\n      }\n    },\n    options.wsOptions\n  );\n\n  const rpc: RpcClient = {\n    events,\n    get isTrusted() {\n      return mode.isTrusted;\n    },\n    connectionMeta: options.connection,\n    ensureTrusted: mode.ensureTrusted,\n    requestTrust: mode.requestTrust,\n    requestTrustWithToken: async (token: string) => {\n      // Update stored token for future reconnections\n      localStorage.setItem(CONNECTION_AUTH_TOKEN_KEY, token);\n      (globalThis as any)[CONNECTION_AUTH_TOKEN_KEY] = token;\n      return mode.requestTrustWithToken(token);\n    },\n    call: mode.call,\n    callEvent: mode.callEvent,\n    callOptional: mode.callOptional,\n    client: clientRpc,\n    sharedState: undefined!,\n    streaming: undefined!,\n    cacheManager\n  };\n\n  // rpc.sharedState = createRpcSharedStateClientHost(rpc);\n  rpc.streaming = createRpcStreamingClientHost(rpc);\n\n  // @ts-expect-error assign to readonly property\n  context.rpc = rpc;\n  void mode.requestTrust();\n\n  // Listen for auth updates from other tabs (e.g., auth URL page)\n  try {\n    const bc = new BroadcastChannel(\"vite-devtools-auth\");\n    bc.onmessage = event => {\n      if (event.data?.type === \"auth-update\" && event.data.authToken) {\n        void rpc.requestTrustWithToken(event.data.authToken);\n      }\n    };\n  } catch {\n    // BroadcastChannel is not supported in all environments, so we can safely ignore errors here\n  }\n\n  return rpc;\n}\n","/* -------------------------------------------------------------------\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 { LogFnMeta } from \"@powerlines/core\";\nimport { PowerlinesExecutionContext } from \"@powerlines/core/context/execution-context\";\nimport { resolvePluginConfig } from \"@powerlines/core/lib/context-helpers\";\nimport { consoleLogger } from \"@powerlines/core/plugin-utils\";\nimport { titleCase } from \"@stryke/string-format/title-case\";\nimport { isSetObject } from \"@stryke/type-checks/is-set-object\";\nimport { uuid } from \"@stryke/unique-id/uuid\";\nimport { RpcClient } from \"../types\";\nimport { ExecutionHostParams } from \"../types/api\";\nimport { EngineResolvedConfig } from \"../types/config\";\nimport { EngineSystemContext } from \"../types/context\";\nimport { createRpcClient } from \"./rpc\";\n\n/**\n * Creates an execution host with the provided methods. Each method will be wrapped to create an execution context and handle errors appropriately.\n *\n * @param methods - An object where keys are method names and values are functions that take an execution context and return a promise.\n * @returns An object with the same keys as the input methods, but each function is wrapped to create an execution context and handle errors.\n */\nexport function createExecutionHost<\n  TContext extends PowerlinesExecutionContext<\n    EngineResolvedConfig,\n    EngineSystemContext\n  > = PowerlinesExecutionContext<EngineResolvedConfig, EngineSystemContext>\n>(methods: Record<string, (context: TContext) => Promise<void>>) {\n  return Object.fromEntries(\n    Object.entries(methods).map(([method, fn]) => [\n      method,\n      async (params: ExecutionHostParams) => {\n        const { options, inlineConfig } = params;\n\n        let rpc!: RpcClient;\n        if (options.baseURL && options.connection) {\n          rpc = createRpcClient(options);\n        } else {\n          throw new Error(\n            `Execution RPC client could not be created - Missing ${\n              !options.baseURL\n                ? `baseURL${options.connection ? ` and connection information` : \"\"}`\n                : \"connection\"\n            } or connection information.`\n          );\n        }\n\n        const logFn = (meta: LogFnMeta, message: string) => {\n          consoleLogger(meta, message);\n          if (rpc) {\n            void rpc.callEvent(\"powerlines:log\", {\n              meta: {\n                category: \"general\",\n                ...options,\n                ...(isSetObject(meta) ? meta : { type: meta }),\n                logId: uuid(),\n                timestamp: Date.now()\n              },\n              message\n            });\n          }\n        };\n\n        const context = (await PowerlinesExecutionContext.from<\n          EngineResolvedConfig,\n          EngineSystemContext\n        >({ ...options, logFn }, inlineConfig ?? {}, {\n          rpc\n        })) as TContext;\n\n        context.logger.info(\n          `Starting ${\n            titleCase(options.framework?.name) || \"Powerlines\"\n          } - ${titleCase(method)} execution (${options.executionId})`\n        );\n\n        await resolvePluginConfig(context as PowerlinesExecutionContext<any>);\n\n        await fn(context);\n      }\n    ])\n  );\n}\n","/* -------------------------------------------------------------------\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 { build as executeBuild } from \"./api/build\";\nimport { clean as executeClean } from \"./api/clean\";\nimport { create as executeCreate } from \"./api/create\";\nimport { deploy as executeDeploy } from \"./api/deploy\";\nimport { docs as executeDocs } from \"./api/docs\";\nimport { lint as executeLint } from \"./api/lint\";\nimport { prepare as executePrepare } from \"./api/prepare\";\nimport { test as executeTest } from \"./api/test\";\nimport { types as executeTypes } from \"./api/types\";\nimport { createExecutionHost } from \"./helpers/create-execution-host\";\n\nconst executionHost = createExecutionHost({\n  types: executeTypes,\n  prepare: executePrepare,\n  create: executeCreate,\n  clean: executeClean,\n  lint: executeLint,\n  test: executeTest,\n  build: executeBuild,\n  docs: executeDocs,\n  deploy: executeDeploy\n});\n\nexport const types = executionHost.types;\nexport const prepare = executionHost.prepare;\nexport const create = executionHost.create;\nexport const clean = executionHost.clean;\nexport const lint = executionHost.lint;\nexport const test = executionHost.test;\nexport const build = executionHost.build;\nexport const docs = executionHost.docs;\nexport const deploy = executionHost.deploy;\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAwCA,eAAsBA,UAIpB,SACA,YAAY,OACZ;CACA,MAAM,QAAQ,QAAQ,MAAM,cAAc;AAE1C,OAAM,oBAAoB,SAAS,OAAM,QAAO;AAC9C,MAAI,MACF,kEACD;AAED,QAAM,QAAQ,SAAS,kBAAkB;GACvC,aAAa;GACb,OAAO;GACR,CAAC;AAEF,QAAM,mBAAoD,IAAI;AAE9D,QAAM,QAAQ,SAAS,kBAAkB;GACvC,aAAa;GACb,OAAO;GACR,CAAC;AAEF,MAAI,IAAI,MAAM,SAAS,EACrB,KAAI,MACF,8BACE,SAAS,IAAI,OAAO,MAAM,GACtB,OAAO,KAAK,IAAI,OAAO,MAAM,CAAC,SAC9B,QAAQ,IAAI,OAAO,MAAM,CAAC,OAC/B,wCACC,IAAI,MAAM,OACX,0BAA0B,IAAI,OAAO,MAAM,UAC1C,IAAI,MAAM,SAAS,KAAK,IAAI,MAAM,SAAS,KACvC,OAAO,IAAI,MACR,KACC,UACE,KAAK,MAAM,OACT,MAAM,SAAS,OAAO,MAAM,WAAW,KAE5C,CACA,KAAK,MAAM,KACd,KAEP;MAED,KAAI,KACF,qCACE,IAAI,OAAO,MACZ,8HACF;AAGH,QAAM,gBAAiD,IAAI;AAC3D,QAAM,oBAAoB,IAAI;AAE9B,QAAM,QAAQ,SAAS,kBAAkB;GACvC,aAAa;GACb,OAAO;GACR,CAAC;AAEF,MAAI,MAAM;GACR,MAAM,EACJ,UAAU,UACX;GACD,SAAS,yDAAyD,aAChE,IAAI,OACL;GACF,CAAC;AAEF,MAAI,CAAC,IAAI,GAAG,WAAW,IAAI,UAAU,CACnC,OAAM,gBAAgB,IAAI,UAAU;AAGtC,MAAI,CAAC,IAAI,GAAG,WAAW,IAAI,SAAS,CAClC,OAAM,gBAAgB,IAAI,SAAS;AAGrC,QAAM,QAAQ,SAAS,WAAW;GAChC,aAAa;GACb,OAAO;GACR,CAAC;AACF,QAAM,QAAQ,SAAS,WAAW;GAChC,aAAa;GACb,OAAO;GACR,CAAC;AAEF,QAAM,QAAQ,SAAS,WAAW;GAChC,aAAa;GACb,OAAO;GACR,CAAC;AAEF,MAAI,CAAC,aAAa,IAAI,OAAO,OAAO,UAAU,MAC5C,OAAM,YAAY,SAAS,IAAI;AAGjC,UAAQ,MAAM,sDAAsD;AAEpE,QAAM,QAAQ,IAAI,CAChBC,eAAa,KAAK,IAAI,aAAa,EACnCA,eAAa,KAAK,IAAI,UAAU,CACjC,CAAC;AAEF,QAAM,cAAc,IAAI;AACxB,MAAI,gBAAgB,IAAI;GACxB;AAEF,QAAO;;;;;ACjHT,eAAe,YAIb,SACA,KACA;AACA,OAAM,QAAQ,SAAS,SAAS;EAC9B,aAAa;EACb,OAAO;EACR,CAAC;AAEF,KAAI,MACF,wEACD;AACD,OAAM,aAAa,KAAK,IAAI,UAAU;AAEtC,OAAM,QAAQ,SAAS,SAAS;EAC9B,aAAa;EACb,OAAO;EACR,CAAC;AAEF,KAAI,IAAI,OAAO,OAAO,MAAM;AAC1B,MAAI,MAAM,uDAAuD;EAEjE,MAAM,kBAAkB,aACtB,WAAW,IAAI,OAAO,OAAO,MAAM,IAAI,OAAO,IAAI,EAClD,WAAW,IAAI,OAAO,MAAM,IAAI,OAAO,IAAI,CAC5C,GACG,UACE,IAAI,OAAO,OAAO,KAAK,MACvB,aACE,WAAW,IAAI,OAAO,MAAM,IAAI,OAAO,IAAI,EAC3C,WAAW,IAAI,OAAO,OAAO,MAAM,IAAI,OAAO,IAAI,CACnD,CACF,GACD,UAAU,IAAI,OAAO,OAAO,KAAK,MAAM,OAAO;EAClD,MAAM,aAAa,IAAI,OAAO,OAAO;AAErC,MAAI,WAAW,WAAW,IAAI,eAAe,iBAAiB;AAC5D,OAAI,MACF,wDACE,IAAI,OAAO,OAAO,KACnB,6CAA6C,gBAAgB,IAC/D;AAED,SAAM,UAAU,YAAY,gBAAgB;QAE5C,KAAI,KACF,0CACE,CAAC,WAAW,WAAW,GACnB,mBACA,sCACL,YAAY,WAAW,iBACtB,gBACD,2CACF;AAGH,MACE,IAAI,OAAO,OAAO,KAAK,UACvB,MAAM,QAAQ,IAAI,OAAO,OAAO,KAAK,OAAO,CAE5C,OAAM,QAAQ,IACZ,IAAI,OAAO,OAAO,KAAK,OAAO,IAAI,OAAM,UAAS;AAC/C,OAAI,MACF,qBAAqB,MAAM,UACzB,IAAI,OAAO,QAAQ,MAAM,QACrB,MAAM,OACN,WACE,MAAM,MACN,YAAY,MAAM,OAAO,IAAI,OAAO,IAAI,CACzC,CACN,CAAC,MAAM,MAAM,YACZ,WAAW,MAAM,MAAM,YAAY,MAAM,QAAQ,IAAI,OAAO,IAAI,CAAC,CAClE,CAAC,GACA,MAAM,QAAQ,MAAM,OAAO,IAAI,MAAM,OAAO,SAAS,IACjD,eAAe,MAAM,OAClB,KAAI,MAAK,MAAM,aAAa,EAAE,CAAC,CAC/B,KAAK,KAAK,CAAC,KACd,KAEP;AAED,SAAM,IAAI,GAAG,KAAK,OAAO,MAAM,OAAO;IACtC,CACH;OAGH,KAAI,MACF,kGACD;AAGH,OAAM,QAAQ,SAAS,SAAS;EAC9B,aAAa;EACb,OAAO;EACR,CAAC;;;;;;;AAQJ,eAAsBC,QAGpB,SAA4D;CAC5D,MAAM,QAAQ,QAAQ,MAAM,WAAW;AAEvC,OAAM,QAAQ,kBAAkB;AAChC,KACE,QAAQ,KAAK,aAAa,QAAQ,eAAe,YACjD,QAAQ,OAAO,WACf;AACA,UAAQ,KACN,CAAC,QAAQ,eAAe,WACpB,gFACA,QAAQ,KAAK,aAAa,QAAQ,cAAc,WAC9C,mGACA,qEACP;AAED,QAAMC,UAAyC,QAAQ;;AAGzD,KAAI,QAAQ,OAAO,YACjB,OAAM,YACJ,SACA,MAAM,QAAQ,eAAe,CAC9B;KAED,OAAM,oBAAoB,SAAS,OAAM,QAAO;AAC9C,QAAM,YAA6C,SAAS,IAAI;GAChE;AAGJ,QAAO;;;;;;;;;;AChJT,eAAsBC,QAGpB,SAA4D;CAC5D,MAAM,QAAQ,QAAQ,MAAM,WAAW;AAEvC,OAAMC,UAAyC,SAAS,KAAK;AAC7D,OAAM,oBAAoB,SAAS,OAAM,QAAO;AAC9C,MAAI,MAAM,yDAAyD;AAEnE,QAAM,IAAI,GAAG,OAAOC,YAAU,IAAI,OAAO,KAAK,IAAI,OAAO,OAAO,KAAK,CAAC;AACtE,QAAM,IAAI,GAAG,OACXA,YACE,IAAI,OAAO,KACX,IAAI,OAAO,MACX,IAAI,OAAO,OAAO,cACnB,CACF;AAED,QAAM,QAAQ,SAAS,SAAS;GAC9B,aAAa;GACb,YAAY;GACb,CAAC;GACF;AAEF,QAAO;;;;;;;;;;ACvBT,eAAsBC,SAGpB,SAA4D;CAC5D,MAAM,QAAQ,QAAQ,MAAM,kCAAkC;AAE9D,OAAMC,UAAyC,SAAS,KAAK;AAC7D,OAAM,oBAAoB,SAAS,OAAM,QAAO;AAC9C,MAAI,MAAM,uDAAuD;AAEjE,QAAM,QAAQ,SAAS,UAAU;GAC/B,aAAa;GACb,OAAO;GACR,CAAC;EAEF,MAAM,QAAQ,MAAM,UAClBC,YAAU,IAAI,gBAAgB,wBAAwB,CACvD;AACD,OAAK,MAAM,QAAQ,OAAO;AACxB,OAAI,MAAM,oCAAoC,OAAO;GAErD,MAAM,WAAW,WAAW,QAAQ,KAAK;AACzC,SAAM,IAAI,GAAG,MACXA,YAAU,IAAI,OAAO,MAAM,KAAK,QAAQ,QAAQ,GAAG,CAAC,EACpD,SAAS,IAAI,CACd;;AAGH,QAAM,QAAQ,SAAS,UAAU;GAC/B,aAAa;GACb,OAAO;GACR,CAAC;AAEF,MAAI,IAAI,OAAO,gBAAgB,eAAe;GAC5C,MAAM,WAAW,MAAM,UACrBA,YAAU,IAAI,gBAAgB,6BAA6B,CAC5D;AACD,QAAK,MAAM,QAAQ,UAAU;AAC3B,QAAI,MAAM,qCAAqC,OAAO;IAEtD,MAAM,WAAW,WAAW,QAAQ,KAAK;AACzC,UAAM,IAAI,GAAG,MACXA,YAAU,IAAI,OAAO,MAAM,KAAK,QAAQ,QAAQ,GAAG,CAAC,EACpD,SAAS,IAAI,CACd;;SAEE;GACL,MAAM,WAAW,MAAM,UACrBA,YAAU,IAAI,gBAAgB,yBAAyB,CACxD;AACD,QAAK,MAAM,QAAQ,UAAU;AAC3B,QAAI,MAAM,iCAAiC,OAAO;IAElD,MAAM,WAAW,WAAW,QAAQ,KAAK;AACzC,UAAM,IAAI,GAAG,MACXA,YAAU,IAAI,OAAO,MAAM,KAAK,QAAQ,QAAQ,GAAG,CAAC,EACpD,SAAS,IAAI,CACd;;;AAIL,QAAM,QAAQ,SAAS,UAAU;GAC/B,aAAa;GACb,OAAO;GACR,CAAC;GACF;AAEF,QAAO;;;;;;;;;;;;;ACnET,eAAsBC,SAGpB,SAA4D;CAC5D,MAAM,QAAQ,QAAQ,MAAM,aAAa;AAEzC,OAAMC,UAAyC,QAAQ;AACvD,OAAM,oBAAoB,SAAS,OAAM,QAAO;AAC9C,QAAM,QAAQ,SAAS,UAAU,EAC/B,aAAa,KACd,CAAC;GACF;AAEF,QAAO;;;;;;;;;;;;;ACbT,eAAsBC,OAGpB,SAA4D;CAC5D,MAAM,QAAQ,QAAQ,MAAM,gBAAgB;AAE5C,OAAMC,UAAyC,QAAQ;AACvD,OAAM,oBAAoB,SAAS,OAAM,QAAO;AAC9C,QAAM,QAAQ,SAAS,QAAQ,EAC7B,aAAa,KACd,CAAC;GACF;AAEF,QAAO;;;;;;;;;;;;;ACbT,eAAsBC,OAGpB,SAA4D;CAC5D,MAAM,QAAQ,QAAQ,MAAM,UAAU;AAEtC,OAAMC,UAAyC,QAAQ;AACvD,OAAM,oBAAoB,SAAS,OAAM,QAAO;AAC9C,QAAM,QAAQ,SAAS,QAAQ;GAC7B,aAAa;GACb,YAAY;GACb,CAAC;GACF;AAEF,QAAO;;;;;;;;;;;;;ACdT,eAAsBC,OAGpB,SAA4D;CAC5D,MAAM,QAAQ,QAAQ,MAAM,UAAU;AAEtC,OAAMC,UAAQ,QAAQ;AACtB,OAAM,oBAAoB,SAAS,OAAM,QAAO;AAC9C,QAAM,QAAQ,SAAS,QAAQ;GAC7B,aAAa;GACb,YAAY;GACb,CAAC;GACF;AAEF,QAAO;;;;;;;;;;;;;ACAT,eAAsBC,QAGpB,SAA4D;CAC5D,MAAM,QAAQ,QAAQ,MAAM,kBAAkB;AAC9C,SAAQ,MACN,gEACD;AAED,OAAM,oBAAoB,SAAS,OAAM,QAAO;AAC9C,MAAI,MACF,kEACD;AAED,QAAM,QAAQ,SAAS,kBAAkB;GACvC,aAAa;GACb,OAAO;GACR,CAAC;AAEF,QAAM,mBAAoD,IAAI;AAE9D,QAAM,QAAQ,SAAS,kBAAkB;GACvC,aAAa;GACb,OAAO;GACR,CAAC;AAEF,MAAI,IAAI,MAAM,SAAS,EACrB,KAAI,MACF,8BACE,SAAS,IAAI,OAAO,MAAM,GACtB,OAAO,KAAK,IAAI,OAAO,MAAM,CAAC,SAC9B,QAAQ,IAAI,OAAO,MAAM,CAAC,OAC/B,wCACC,IAAI,MAAM,OACX,0BAA0B,IAAI,OAAO,MAAM,UAC1C,IAAI,MAAM,SAAS,KAAK,IAAI,MAAM,SAAS,KACvC,OAAO,IAAI,MACR,KACC,UACE,KAAK,MAAM,OACT,MAAM,SAAS,OAAO,MAAM,WAAW,KAE5C,CACA,KAAK,MAAM,KACd,KAEP;MAED,KAAI,KACF,qCACE,IAAI,OAAO,MACZ,8HACF;AAGH,QAAM,gBAAiD,IAAI;AAC3D,QAAM,oBAAoB,IAAI;AAE9B,QAAM,QAAQ,SAAS,kBAAkB;GACvC,aAAa;GACb,OAAO;GACR,CAAC;AAEF,UAAQ,MACN,mDAAmD,iBAAiB;GAClE,GAAG,IAAI;GACP,YAAY,YAAY,IAAI,OAAO,WAAW,GAC1C,KAAK,IAAI,OAAO,YAAY,CAAC,UAAU,CAAC,GACxC;GACJ,cAAc,YAAY,IAAI,OAAO,aAAa,GAC9C,IAAI,OAAO,eACX;GACJ,SAAS,IAAI,QAAQ,KAAI,WAAU,OAAO,KAAK;GAChD,CAAC,GACH;AAED,MAAI,CAAC,IAAI,GAAG,WAAW,IAAI,UAAU,CACnC,OAAM,gBAAgB,IAAI,UAAU;AAGtC,MAAI,CAAC,IAAI,GAAG,WAAW,IAAI,SAAS,CAClC,OAAM,gBAAgB,IAAI,SAAS;AAGrC,MACE,IAAI,OAAO,cAAc,QACzB,IAAI,eAAe,aAAa,IAAI,KAAK,SAEzC,KAAI,MACF,wEACD;OACI;AACL,OAAI,KACF,mFACD;AAED,SAAMC,UAAQ,SAAS,KAAK;;AAG9B,QAAM,YAAY,SAAS,IAAI;AAE/B,UAAQ,MAAM,oDAAoD;AAElE,QAAM,OAAO,KAAK,IAAI,WAAY,MAAM,IAAI,GAAG,KAAK,IAAI,UAAU,IAAK,GAAG;AAE1E,QAAM,cAAc,IAAI;AACxB,MAAI,gBAAgB,IAAI;GACxB;AAEF,QAAO;;;;;ACzGT,SAAS,sBACP,SACA,gBACA,QACA,WACA,YAAoB,QAAQ;CAAE,WAAW;CAAK,YAAY;CAAO,CAAC,EAClE,aAEI,EAAE,EACN,YAA0C,EAAE,EACrB;CACvB,IAAI,YAAY;CAChB,MAAM,iBAAiB,qBAA8B;CACrD,MAAM,MACJ,SAAS,eAAe,UAAU,IACjC,MAAM,eAAe,UAAU,IAC9B,GAAG,CAAC,eAAe,gBAAgB,GAAG,eAAe,cACnD,GAAG,QAAQ,SAAS,QAAQ,QAAQ,KAAK,CAAC,IAAI,QAAQ,SAAS,GAAG,eAAe,cAChF,eAAe;CAMtB,MAAM,8BAAc,IAAI,KAAyC;AACjE,MAAK,MAAM,QAAQ,eAAe,2BAA2B,EAAE,CAC7D,aAAY,IAAI,MAAM,EAAE,kBAAkB,MAAM,CAAC;CAEnD,MAAM,YAAYC,gBAGhB,UAAU,WAAW;EACrB,SAAS,mBAAmB;GAC1B;GACA;GACA;GACA,GAAG;GACJ,CAAC;EACF;EACD,CAAC;AAGF,WAAU,SAAS;EACjB,MAAM;EACN,MAAM;EACN,eAAe;AACb,eAAY;AACZ,UAAO,KAAK,0BAA0B,MAAM;;EAE/C,CAAC;CAEF,IAAI,mBAAmB;CAEvB,eAAe,sBAAsB,OAAe;AAClD,qBAAmB;AAyBnB,SAAO;;CAGT,eAAe,eAAe;AAC5B,MAAI,UAAW,QAAO;AACtB,SAAO,sBAAsB,iBAAiB;;CAGhD,eAAe,cAAc,UAAU,KAA0B;AAC/D,MAAI,UAAW,gBAAe,QAAQ,KAAK;AAE3C,MAAI,WAAW,EAAG,QAAO,eAAe;EAExC,IAAI,cAAc;AAClB,QAAM,QAAQ,KAAK,CACjB,eAAe,QAAQ,KAAK,MAAM,EAClC,IAAI,SAAS,SAAS,WAAW;GAC/B,MAAM,KAAK,iBAAiB;AAC1B,2BAAO,IAAI,MAAM,wCAAwC,CAAC;MACzD,QAAQ;AACX,iBAAc,aAAa,GAAG;IAC9B,CACH,CAAC;AAEF,SAAO;;AAGT,QAAO;EACL,IAAI,YAAY;AACd,UAAO;;EAET;EACA;EACA;EACA,OAAO,GAAG,SAAmB;AAC3B,UAAO,UAAU,MAEf,GAAG,KACJ;;EAEH,YAAY,GAAG,SAAmB;AAChC,UAAO,UAAU,WAEf,GAAG,KACJ;;EAEH,eAAe,GAAG,SAAmB;AACnC,UAAO,UAAU,cAEf,GAAG,KACJ;;EAEJ;;AAGH,MAAM,4BAA4B;AAElC,SAAgBC,kBAAgB,SAA2B;CACzD,MAAM,UAAU,IAAI,SAAS,QAAQ,QAAQ;CAE7C,MAAM,eAAe,IAAI,gBAAgB;EACvC,WAAW,EAAE;EACb,GAAI,OAAO,QAAQ,iBAAiB,WAAW,QAAQ,eAAe,EAAE;EACzE,CAAC;CACF,MAAM,UAAsB,EAC1B,KAAK,QACN;CAED,MAAM,YAAmC,IAAI,0BAG3C,QAAQ;AAEV,cAAa,gBAAgB,IAAI;CACjC,MAAM,SAAS,oBAAqC;CAEpD,MAAM,OAAO,sBACX,SACA,QAAQ,YACR,QACA,WACA,QACA;EACE,GAAG,QAAQ;EACX,MAAM,UAAU,KAAK,MAAM,SAAS;AAClC,SAAM,QAAQ,YAAY,WAAW,KAAK,MAAM,KAAK,MAAM,QAAQ;AACnE,OAAI,QAAQ,gBAAgB,cAAc,SAAS,IAAI,EAAE,EAAE;IACzD,MAAM,SAAS,aAAa,OAAO,IAAI,GAAG,IAAI,EAAE;AAChD,QAAI,OACF,QAAO,QAAQ,OAAO;SACjB;KACL,MAAM,MAAM,MAAM,KAAK,IAAI;AAC3B,mBAAc,MAAM,KAAK,IAAI;;SAG/B,OAAM,KAAK,IAAI;;EAGpB,EACD,QAAQ,UACT;CAED,MAAM,MAAiB;EACrB;EACA,IAAI,YAAY;AACd,UAAO,KAAK;;EAEd,gBAAgB,QAAQ;EACxB,eAAe,KAAK;EACpB,cAAc,KAAK;EACnB,uBAAuB,OAAO,UAAkB;AAE9C,gBAAa,QAAQ,2BAA2B,MAAM;AACtD,GAAC,WAAmB,6BAA6B;AACjD,UAAO,KAAK,sBAAsB,MAAM;;EAE1C,MAAM,KAAK;EACX,WAAW,KAAK;EAChB,cAAc,KAAK;EACnB,QAAQ;EACR,aAAa;EACb,WAAW;EACX;EACD;AAGD,KAAI,YAAY,6BAA6B,IAAI;AAGjD,SAAQ,MAAM;AACd,CAAK,KAAK,cAAc;AAGxB,KAAI;EACF,MAAM,KAAK,IAAI,iBAAiB,qBAAqB;AACrD,KAAG,aAAY,UAAS;AACtB,OAAI,MAAM,MAAM,SAAS,iBAAiB,MAAM,KAAK,UACnD,CAAK,IAAI,sBAAsB,MAAM,KAAK,UAAU;;SAGlD;AAIR,QAAO;;;;;;;;;;;AC5OT,SAAgB,oBAKd,SAA+D;AAC/D,QAAO,OAAO,YACZ,OAAO,QAAQ,QAAQ,CAAC,KAAK,CAAC,QAAQ,QAAQ,CAC5C,QACA,OAAO,WAAgC;EACrC,MAAM,EAAE,SAAS,iBAAiB;EAElC,IAAI;AACJ,MAAI,QAAQ,WAAW,QAAQ,WAC7B,OAAMC,kBAAgB,QAAQ;MAE9B,OAAM,IAAI,MACR,uDACE,CAAC,QAAQ,UACL,UAAU,QAAQ,aAAa,gCAAgC,OAC/D,aACL,6BACF;EAGH,MAAM,SAAS,MAAiB,YAAoB;AAClD,iBAAc,MAAM,QAAQ;AAC5B,OAAI,IACF,CAAK,IAAI,UAAU,kBAAkB;IACnC,MAAM;KACJ,UAAU;KACV,GAAG;KACH,GAAI,YAAY,KAAK,GAAG,OAAO,EAAE,MAAM,MAAM;KAC7C,OAAO,MAAM;KACb,WAAW,KAAK,KAAK;KACtB;IACD;IACD,CAAC;;EAIN,MAAM,UAAW,MAAM,2BAA2B,KAGhD;GAAE,GAAG;GAAS;GAAO,EAAE,gBAAgB,EAAE,EAAE,EAC3C,KACD,CAAC;AAEF,UAAQ,OAAO,KACb,YACE,UAAU,QAAQ,WAAW,KAAK,IAAI,aACvC,KAAK,UAAU,OAAO,CAAC,cAAc,QAAQ,YAAY,GAC3D;AAED,QAAM,oBAAoB,QAA2C;AAErE,QAAM,GAAG,QAAQ;GAEpB,CAAC,CACH;;;;;ACnEH,MAAM,gBAAgB,oBAAoB;CACxC,OAAOC;CACP,SAASC;CACT,QAAQC;CACR,OAAOC;CACP,MAAMC;CACN,MAAMC;CACN,OAAOC;CACP,MAAMC;CACN,QAAQC;CACT,CAAC;AAEF,MAAa,QAAQ,cAAc;AACnC,MAAa,UAAU,cAAc;AACrC,MAAa,SAAS,cAAc;AACpC,MAAa,QAAQ,cAAc;AACnC,MAAa,OAAO,cAAc;AAClC,MAAa,OAAO,cAAc;AAClC,MAAa,QAAQ,cAAc;AACnC,MAAa,OAAO,cAAc;AAClC,MAAa,SAAS,cAAc"}