@powerlines/core 0.14.5 → 0.15.1

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

@@ -0,0 +1,101 @@
+import { Plugin } from "../types/plugin.mjs";
+import { Logger, LoggerOptions } from "../types/logging.mjs";
+import { ExecutionContext, PluginContext } from "../types/context.mjs";
+import { EnvironmentResolvedConfig, ExecutionOptions, PluginConfig, ResolvedConfig } from "../types/config.mjs";
+import { PowerlinesContext } from "./context.mjs";
+import { PowerlinesEnvironmentContext } from "./environment-context.mjs";
+
+//#region src/context/execution-context.d.ts
+declare class PowerlinesExecutionContext<TResolvedConfig extends ResolvedConfig = ResolvedConfig, TSystemContext = unknown> extends PowerlinesContext<TResolvedConfig, TSystemContext> implements ExecutionContext<TResolvedConfig, TSystemContext> {
+  #private;
+  /**
+   * Create a new Storm context from the workspace root and user config.
+   *
+   * @param options - The execution options to create the context with.
+   * @param inlineConfig - The inline configuration for the context.
+   * @returns A promise that resolves to the new context.
+   */
+  static from<TResolvedConfig extends ResolvedConfig = ResolvedConfig, TSystemContext = unknown>(options: ExecutionOptions, inlineConfig?: TResolvedConfig["inlineConfig"], system?: TSystemContext): Promise<PowerlinesExecutionContext<TResolvedConfig, TSystemContext>>;
+  /**
+   * The unique identifier of the execution context, which can be used for logging and other purposes to distinguish between different executions in the same process.
+   */
+  get id(): string;
+  /**
+   * A record of all environments by name
+   */
+  get environments(): Record<string, PowerlinesEnvironmentContext<TResolvedConfig, TSystemContext>>;
+  get plugins(): Array<Plugin<PluginContext<TResolvedConfig, TSystemContext>>>;
+  /**
+   * Creates a new instance.
+   *
+   * @param options - The options to use for creating the context, including the resolved configuration and workspace settings.
+   */
+  protected constructor(options: ExecutionOptions);
+  /**
+   * A setter function to populate the inline config values provided during execution of the command, such as CLI flags or other parameters that may be relevant to the command being executed. This function can be used to update the context with the inline configuration values, which may be used during the configuration resolution process to ensure that the final configuration reflects both the user configuration and any inline configuration provided during execution.
+   *
+   * @param config - The inline configuration values to set.
+   * @returns A promise that resolves when the inline configuration values have been set.
+   */
+  setInlineConfig(config: TResolvedConfig["inlineConfig"]): Promise<void>;
+  /**
+   * Create a new logger instance
+   *
+   * @param options - The configuration options to use for the logger instance, which can be used to customize the appearance and behavior of the log messages generated by the logger. This is typically the name of the plugin or module that is creating the logger instance.
+   * @returns A logger client instance that can be used to generate log messages with consistent formatting and metadata.
+   */
+  createLogger(options: LoggerOptions): Logger;
+  /**
+   * Extend the base logger with additional configuration options
+   *
+   * @param options - The configuration options to extend the base logger with, which can be used to add additional metadata or customize the appearance of log messages generated by the logger. This is typically the name of the plugin or module that is creating the logger instance, as well as any additional metadata such as the plugin category or environment.
+   * @returns A new logger client instance that extends the base logger with the provided configuration options.
+   */
+  extendLogger(options: LoggerOptions): Logger;
+  /**
+   * A function to copy the context and update the fields for a specific environment
+   *
+   * @param environment - The environment configuration to use.
+   * @returns A new context instance with the updated environment.
+   */
+  createEnvironment(environment: EnvironmentResolvedConfig<TResolvedConfig>["environment"]): Promise<PowerlinesEnvironmentContext<TResolvedConfig, TSystemContext>>;
+  /**
+   * Update the context using a new inline configuration options
+   */
+  resolveConfig(): Promise<void>;
+  /**
+   * Get an environment by name, or the default environment if no name is provided
+   *
+   * @param name - The name of the environment to retrieve.
+   * @returns The requested environment context.
+   */
+  getEnvironment(name?: string): Promise<PowerlinesEnvironmentContext<TResolvedConfig, TSystemContext>>;
+  /**
+   * A safe version of `getEnvironment` that returns `undefined` if the environment is not found
+   *
+   * @param name - The name of the environment to retrieve.
+   * @returns The requested environment context or `undefined` if not found.
+   */
+  getEnvironmentSafe(name?: string): Promise<PowerlinesEnvironmentContext<TResolvedConfig, TSystemContext> | undefined>;
+  /**
+   * A function to merge all configured environments into a single context.
+   *
+   * @remarks
+   * If only one environment is configured, that environment will be returned directly.
+   *
+   * @returns A promise that resolves to a merged/global environment context.
+   */
+  toEnvironment(): Promise<PowerlinesEnvironmentContext<TResolvedConfig, TSystemContext>>;
+  /**
+   * A function used internally to add a plugin to the context and update the configuration options
+   *
+   * @danger
+   * This field is for internal use only and should not be accessed or modified directly. It is unstable and can be changed at anytime.
+   *
+   * @internal
+   */
+  unstable_addPlugin(plugin: PluginConfig<PluginContext<TResolvedConfig, TSystemContext>>): Promise<void>;
+}
+//#endregion
+export { PowerlinesExecutionContext };
+//# sourceMappingURL=execution-context.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"execution-context.d.mts","names":[],"sources":["../../src/context/execution-context.ts"],"mappings":";;;;;;;;cAkDa,0BAAA,yBACa,cAAA,GAAiB,cAAA,oCAGjC,iBAAA,CAAkB,eAAA,EAAiB,cAAA,aAChC,gBAAA,CAAiB,eAAA,EAAiB,cAAA;EAAA;;;;;AAL/C;;;SA2BsB,IAAA,yBACM,cAAA,GAAiB,cAAA,2BAAA,CAGzC,OAAA,EAAS,gBAAA,EACT,YAAA,GAAe,eAAA,kBACf,MAAA,GAAS,cAAA,GACR,OAAA,CAAQ,0BAAA,CAA2B,eAAA,EAAiB,cAAA;EAjCd;;;EAAA,IAsD9B,EAAA,CAAA;EAlDkC;;;EAAA,IAyDlC,YAAA,CAAA,GAAgB,MAAA,SAEzB,4BAAA,CAA6B,eAAA,EAAiB,cAAA;EAAA,IAKrC,OAAA,CAAA,GAAW,KAAA,CACpB,MAAA,CAAO,aAAA,CAAc,eAAA,EAAiB,cAAA;EArC7B;;;;;EAAA,UA+CF,WAAA,CAAa,OAAA,EAAS,gBAAA;EAhBiB;;;;;;EA0B1B,eAAA,CACpB,MAAA,EAAQ,eAAA,mBACP,OAAA;EAvBmB;;;;;;EA6CN,YAAA,CAAa,OAAA,EAAS,aAAA,GAAgB,MAAA;EAcA;;;;;;EAAtC,YAAA,CAAa,OAAA,EAAS,aAAA,GAAgB,MAAA;EAgGnB;;;;;;EAlFtB,iBAAA,CACX,WAAA,EAAa,yBAAA,CAA0B,eAAA,mBACtC,OAAA,CAAQ,4BAAA,CAA6B,eAAA,EAAiB,cAAA;EAuKvD;;;EAvFoB,aAAA,CAAA,GAAa,OAAA;EAyGjC;;;;;;EAlFW,cAAA,CAAe,IAAA,YAAa,OAAA,CAAA,4BAAA,CAAA,eAAA,EAAA,cAAA;EAnPjC;;;;;;EAgTK,kBAAA,CACX,IAAA,YACC,OAAA,CACD,4BAAA,CAA6B,eAAA,EAAiB,cAAA;EArThD;;;;;;;;EAsUa,aAAA,CAAA,GAAiB,OAAA,CAC5B,4BAAA,CAA6B,eAAA,EAAiB,cAAA;EA7S9C;;;;;;;;EA2UW,kBAAA,CACX,MAAA,EAAQ,YAAA,CAAa,aAAA,CAAc,eAAA,EAAiB,cAAA,KAAgB,OAAA;AAAA"}

package/dist/context/execution-context.mjs

@@ -0,0 +1,228 @@
+import { DEFAULT_ENVIRONMENT, GLOBAL_ENVIRONMENT } from "../constants/environments.mjs";
+import { resolvePlugins } from "../lib/plugins.mjs";
+import { PowerlinesContext } from "./context.mjs";
+import { PowerlinesEnvironmentContext } from "./environment-context.mjs";
+import { createDefaultEnvironment, createEnvironment } from "../lib/environment.mjs";
+import { existsSync } from "@stryke/fs/exists";
+import { readJsonFile } from "@stryke/fs/json";
+import chalk from "chalk";
+import { toArray } from "@stryke/convert/to-array";
+import { isObject } from "@stryke/type-checks/is-object";
+import { joinPaths } from "@stryke/path/join";
+import { deepClone } from "@stryke/helpers/deep-clone";
+
+//#region src/context/execution-context.ts
+var PowerlinesExecutionContext = class PowerlinesExecutionContext extends PowerlinesContext {
+	/**
+	* A record of all environments by name
+	*/
+	#environments = {};
+	/**
+	* The plugins added to this execution context, which may be used to track the plugins that have been added to the context and ensure that they are properly registered and executed during the build process. This field is for internal use only and should not be accessed or modified directly. It is unstable and can be changed at anytime.
+	*/
+	#plugins = [];
+	/**
+	* Create a new Storm context from the workspace root and user config.
+	*
+	* @param options - The execution options to create the context with.
+	* @param inlineConfig - The inline configuration for the context.
+	* @returns A promise that resolves to the new context.
+	*/
+	static async from(options, inlineConfig, system) {
+		const context = new PowerlinesExecutionContext(options);
+		if (system) context.system = system;
+		await context.init();
+		if (inlineConfig) await context.setInlineConfig(inlineConfig);
+		return context;
+	}
+	/**
+	* The unique identifier of the execution context, which can be used for logging and other purposes to distinguish between different executions in the same process.
+	*/
+	get id() {
+		return this.options.executionId;
+	}
+	/**
+	* A record of all environments by name
+	*/
+	get environments() {
+		return this.#environments;
+	}
+	get plugins() {
+		return this.#plugins;
+	}
+	/**
+	* Creates a new instance.
+	*
+	* @param options - The options to use for creating the context, including the resolved configuration and workspace settings.
+	*/
+	constructor(options) {
+		super(options);
+	}
+	/**
+	* A setter function to populate the inline config values provided during execution of the command, such as CLI flags or other parameters that may be relevant to the command being executed. This function can be used to update the context with the inline configuration values, which may be used during the configuration resolution process to ensure that the final configuration reflects both the user configuration and any inline configuration provided during execution.
+	*
+	* @param config - The inline configuration values to set.
+	* @returns A promise that resolves when the inline configuration values have been set.
+	*/
+	async setInlineConfig(config) {
+		await super.setInlineConfig(config);
+		if (this.inlineConfig.command === "new") {
+			const workspacePackageJsonPath = joinPaths(this.cwd, "package.json");
+			if (!existsSync(workspacePackageJsonPath)) throw new Error(`The workspace package.json file could not be found at ${workspacePackageJsonPath}`);
+			this.packageJson = await readJsonFile(workspacePackageJsonPath);
+		}
+	}
+	/**
+	* Create a new logger instance
+	*
+	* @param options - The configuration options to use for the logger instance, which can be used to customize the appearance and behavior of the log messages generated by the logger. This is typically the name of the plugin or module that is creating the logger instance.
+	* @returns A logger client instance that can be used to generate log messages with consistent formatting and metadata.
+	*/
+	createLogger(options) {
+		return super.createLogger({
+			...options,
+			executionId: this.id,
+			configIndex: this.options.configIndex
+		});
+	}
+	/**
+	* Extend the base logger with additional configuration options
+	*
+	* @param options - The configuration options to extend the base logger with, which can be used to add additional metadata or customize the appearance of log messages generated by the logger. This is typically the name of the plugin or module that is creating the logger instance, as well as any additional metadata such as the plugin category or environment.
+	* @returns A new logger client instance that extends the base logger with the provided configuration options.
+	*/
+	extendLogger(options) {
+		return super.extendLogger({
+			...options,
+			executionId: this.id,
+			configIndex: this.options.configIndex
+		});
+	}
+	/**
+	* A function to copy the context and update the fields for a specific environment
+	*
+	* @param environment - The environment configuration to use.
+	* @returns A new context instance with the updated environment.
+	*/
+	async createEnvironment(environment) {
+		const context = await PowerlinesEnvironmentContext.from(this, deepClone(this.options), deepClone(this.config), deepClone(this.overriddenConfig));
+		context.tsconfig = this.tsconfig;
+		context.system = this.system;
+		context.dependencies = deepClone(this.dependencies);
+		context.devDependencies = deepClone(this.devDependencies);
+		context.persistedMeta = deepClone(this.persistedMeta);
+		context.resolvePatterns = deepClone(this.resolvePatterns);
+		context.powerlinesPath ??= this.powerlinesPath;
+		context.resolver ??= this.resolver;
+		await context.setEnvironmentConfig(deepClone(environment));
+		context.plugins = [];
+		for (const plugin of this.plugins) await context.unstable_addPlugin(plugin);
+		for (const [key, value] of Object.entries(this)) if (![
+			"fs",
+			"system",
+			"options",
+			"config",
+			"inlineConfig",
+			"userConfig",
+			"pluginConfig",
+			"overriddenConfig",
+			"environmentConfig",
+			"dependencies",
+			"devDependencies",
+			"persistedMeta",
+			"packageJson",
+			"projectJson",
+			"tsconfig",
+			"resolver",
+			"plugins",
+			"environments"
+		].includes(key)) if (isObject(value) || Array.isArray(value)) context[key] = deepClone(value);
+		else context[key] = value;
+		return context;
+	}
+	/**
+	* Update the context using a new inline configuration options
+	*/
+	async resolveConfig() {
+		await super.resolveConfig();
+		await Promise.all(toArray(this.config.environments && Object.keys(this.config.environments).length > 0 ? Object.keys(this.config.environments).map((name) => createEnvironment(name, this.config)) : createDefaultEnvironment(this.config)).map(async (env) => {
+			this.#environments[env.name] = await this.createEnvironment(env);
+		}));
+	}
+	/**
+	* Get an environment by name, or the default environment if no name is provided
+	*
+	* @param name - The name of the environment to retrieve.
+	* @returns The requested environment context.
+	*/
+	async getEnvironment(name) {
+		let environment;
+		if (name) environment = this.environments[name];
+		if (Object.keys(this.environments).length === 1) {
+			environment = this.environments[Object.keys(this.environments)[0]];
+			this.trace({
+				meta: { category: "plugins" },
+				message: `Applying the only configured environment: ${chalk.bold.cyanBright(environment?.config.environment?.name)}`
+			});
+		}
+		if (!environment) {
+			if (name) throw new Error(`Environment "${name}" not found.`);
+			environment = await this.createEnvironment(createDefaultEnvironment(this.config));
+			this.warn({
+				meta: { category: "plugins" },
+				message: `No environment specified, and no default environment found. Using a temporary default environment: ${chalk.bold.cyanBright(environment.config.environment?.name)}`
+			});
+		}
+		return environment;
+	}
+	/**
+	* A safe version of `getEnvironment` that returns `undefined` if the environment is not found
+	*
+	* @param name - The name of the environment to retrieve.
+	* @returns The requested environment context or `undefined` if not found.
+	*/
+	async getEnvironmentSafe(name) {
+		try {
+			return await this.getEnvironment(name);
+		} catch {
+			return;
+		}
+	}
+	/**
+	* A function to merge all configured environments into a single context.
+	*
+	* @remarks
+	* If only one environment is configured, that environment will be returned directly.
+	*
+	* @returns A promise that resolves to a merged/global environment context.
+	*/
+	async toEnvironment() {
+		let environment;
+		if (Object.keys(this.environments).length > 1) {
+			environment = await this.createEnvironment(createEnvironment(GLOBAL_ENVIRONMENT, this.config));
+			this.debug({
+				meta: { category: "plugins" },
+				message: `Combined all ${Object.keys(this.environments).length} environments into a single global context.`
+			});
+		} else environment = await this.getEnvironment();
+		return environment;
+	}
+	/**
+	* A function used internally to add a plugin to the context and update the configuration options
+	*
+	* @danger
+	* This field is for internal use only and should not be accessed or modified directly. It is unstable and can be changed at anytime.
+	*
+	* @internal
+	*/
+	async unstable_addPlugin(plugin) {
+		this.plugins.push(...await resolvePlugins(this, plugin, { skipLogging: Object.keys(this.environments).filter((key) => key !== "default" && key !== "__global__").length > 0 }));
+		await Promise.all(Object.keys(this.environments).map(async (name) => {
+			await this.environments[name].unstable_addPlugin(plugin);
+		}));
+	}
+};
+
+//#endregion
+export { PowerlinesExecutionContext };
+//# sourceMappingURL=execution-context.mjs.map

package/dist/context/execution-context.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-context.mjs","names":["#environments","#plugins"],"sources":["../../src/context/execution-context.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 { toArray } from \"@stryke/convert/to-array\";\nimport { existsSync } from \"@stryke/fs/exists\";\nimport { readJsonFile } from \"@stryke/fs/json\";\nimport { deepClone } from \"@stryke/helpers/deep-clone\";\nimport { joinPaths } from \"@stryke/path/join\";\nimport { isObject } from \"@stryke/type-checks/is-object\";\nimport { PackageJson } from \"@stryke/types/package-json\";\nimport chalk from \"chalk\";\nimport {\n  DEFAULT_ENVIRONMENT,\n  GLOBAL_ENVIRONMENT\n} from \"../constants/environments\";\nimport {\n  createDefaultEnvironment,\n  createEnvironment\n} from \"../lib/environment\";\nimport { resolvePlugins } from \"../lib/plugins\";\nimport type {\n  EnvironmentResolvedConfig,\n  ExecutionContext,\n  ExecutionOptions,\n  InferOverridableConfig,\n  Logger,\n  LoggerOptions,\n  Plugin,\n  PluginConfig,\n  PluginContext,\n  ResolvedConfig\n} from \"../types\";\nimport { PowerlinesContext } from \"./context\";\nimport { PowerlinesEnvironmentContext } from \"./environment-context\";\n\nexport class PowerlinesExecutionContext<\n  TResolvedConfig extends ResolvedConfig = ResolvedConfig,\n  TSystemContext = unknown\n>\n  extends PowerlinesContext<TResolvedConfig, TSystemContext>\n  implements ExecutionContext<TResolvedConfig, TSystemContext>\n{\n  /**\n   * A record of all environments by name\n   */\n  #environments: Record<\n    string,\n    PowerlinesEnvironmentContext<TResolvedConfig, TSystemContext>\n  > = {};\n\n  /**\n   * The plugins added to this execution context, which may be used to track the plugins that have been added to the context and ensure that they are properly registered and executed during the build process. This field is for internal use only and should not be accessed or modified directly. It is unstable and can be changed at anytime.\n   */\n  #plugins: Plugin<PluginContext<TResolvedConfig, TSystemContext>>[] = [];\n\n  /**\n   * Create a new Storm context from the workspace root and user config.\n   *\n   * @param options - The execution options to create the context with.\n   * @param inlineConfig - The inline configuration for the context.\n   * @returns A promise that resolves to the new context.\n   */\n  public static async from<\n    TResolvedConfig extends ResolvedConfig = ResolvedConfig,\n    TSystemContext = unknown\n  >(\n    options: ExecutionOptions,\n    inlineConfig?: TResolvedConfig[\"inlineConfig\"],\n    system?: TSystemContext\n  ): Promise<PowerlinesExecutionContext<TResolvedConfig, TSystemContext>> {\n    const context = new PowerlinesExecutionContext<\n      TResolvedConfig,\n      TSystemContext\n    >(options);\n    if (system) {\n      context.system = system;\n    }\n\n    await context.init();\n\n    if (inlineConfig) {\n      await context.setInlineConfig(inlineConfig);\n    }\n\n    return context;\n  }\n\n  /**\n   * The unique identifier of the execution context, which can be used for logging and other purposes to distinguish between different executions in the same process.\n   */\n  public get id(): string {\n    return this.options.executionId;\n  }\n\n  /**\n   * A record of all environments by name\n   */\n  public get environments(): Record<\n    string,\n    PowerlinesEnvironmentContext<TResolvedConfig, TSystemContext>\n  > {\n    return this.#environments;\n  }\n\n  public get plugins(): Array<\n    Plugin<PluginContext<TResolvedConfig, TSystemContext>>\n  > {\n    return this.#plugins;\n  }\n\n  /**\n   * Creates a new instance.\n   *\n   * @param options - The options to use for creating the context, including the resolved configuration and workspace settings.\n   */\n  protected constructor(options: ExecutionOptions) {\n    super(options);\n  }\n\n  /**\n   * A setter function to populate the inline config values provided during execution of the command, such as CLI flags or other parameters that may be relevant to the command being executed. This function can be used to update the context with the inline configuration values, which may be used during the configuration resolution process to ensure that the final configuration reflects both the user configuration and any inline configuration provided during execution.\n   *\n   * @param config - The inline configuration values to set.\n   * @returns A promise that resolves when the inline configuration values have been set.\n   */\n  public override async setInlineConfig(\n    config: TResolvedConfig[\"inlineConfig\"]\n  ): Promise<void> {\n    await super.setInlineConfig(config);\n    if (this.inlineConfig.command === \"new\") {\n      const workspacePackageJsonPath = joinPaths(this.cwd, \"package.json\");\n      if (!existsSync(workspacePackageJsonPath)) {\n        throw new Error(\n          `The workspace package.json file could not be found at ${workspacePackageJsonPath}`\n        );\n      }\n\n      this.packageJson = await readJsonFile<PackageJson>(\n        workspacePackageJsonPath\n      );\n    }\n  }\n\n  /**\n   * Create a new logger instance\n   *\n   * @param options - The configuration options to use for the logger instance, which can be used to customize the appearance and behavior of the log messages generated by the logger. This is typically the name of the plugin or module that is creating the logger instance.\n   * @returns A logger client instance that can be used to generate log messages with consistent formatting and metadata.\n   */\n  public override createLogger(options: LoggerOptions): Logger {\n    return super.createLogger({\n      ...options,\n      executionId: this.id,\n      configIndex: this.options.configIndex\n    });\n  }\n\n  /**\n   * Extend the base logger with additional configuration options\n   *\n   * @param options - The configuration options to extend the base logger with, which can be used to add additional metadata or customize the appearance of log messages generated by the logger. This is typically the name of the plugin or module that is creating the logger instance, as well as any additional metadata such as the plugin category or environment.\n   * @returns A new logger client instance that extends the base logger with the provided configuration options.\n   */\n  public override extendLogger(options: LoggerOptions): Logger {\n    return super.extendLogger({\n      ...options,\n      executionId: this.id,\n      configIndex: this.options.configIndex\n    });\n  }\n\n  /**\n   * A function to copy the context and update the fields for a specific environment\n   *\n   * @param environment - The environment configuration to use.\n   * @returns A new context instance with the updated environment.\n   */\n  public async createEnvironment(\n    environment: EnvironmentResolvedConfig<TResolvedConfig>[\"environment\"]\n  ): Promise<PowerlinesEnvironmentContext<TResolvedConfig, TSystemContext>> {\n    const context = await PowerlinesEnvironmentContext.from<\n      TResolvedConfig,\n      TSystemContext\n    >(\n      this,\n      deepClone(this.options),\n      deepClone(this.config) as TResolvedConfig,\n      deepClone(this.overriddenConfig) as InferOverridableConfig<\n        EnvironmentResolvedConfig<TResolvedConfig>\n      >\n    );\n\n    context.tsconfig = this.tsconfig;\n    context.system = this.system;\n\n    context.dependencies = deepClone<typeof this.dependencies>(\n      this.dependencies\n    );\n    context.devDependencies = deepClone<typeof this.devDependencies>(\n      this.devDependencies\n    );\n    context.persistedMeta = deepClone<typeof this.persistedMeta>(\n      this.persistedMeta\n    );\n    context.resolvePatterns = deepClone<typeof this.resolvePatterns>(\n      this.resolvePatterns\n    );\n\n    context.powerlinesPath ??= this.powerlinesPath;\n    context.resolver ??= this.resolver;\n\n    await context.setEnvironmentConfig(\n      deepClone(\n        environment\n      ) as EnvironmentResolvedConfig<TResolvedConfig>[\"environment\"]\n    );\n\n    context.plugins = [];\n    for (const plugin of this.plugins) {\n      await context.unstable_addPlugin(plugin);\n    }\n\n    for (const [key, value] of Object.entries(this)) {\n      if (\n        ![\n          \"fs\",\n          \"system\",\n          \"options\",\n          \"config\",\n          \"inlineConfig\",\n          \"userConfig\",\n          \"pluginConfig\",\n          \"overriddenConfig\",\n          \"environmentConfig\",\n          \"dependencies\",\n          \"devDependencies\",\n          \"persistedMeta\",\n          \"packageJson\",\n          \"projectJson\",\n          \"tsconfig\",\n          \"resolver\",\n          \"plugins\",\n          \"environments\"\n        ].includes(key)\n      ) {\n        if (isObject(value) || Array.isArray(value)) {\n          (context as any)[key] = deepClone(value);\n        } else {\n          (context as any)[key] = value;\n        }\n      }\n    }\n\n    return context;\n  }\n\n  /**\n   * Update the context using a new inline configuration options\n   */\n  public override async resolveConfig() {\n    await super.resolveConfig();\n\n    await Promise.all(\n      toArray(\n        this.config.environments &&\n          Object.keys(this.config.environments).length > 0\n          ? Object.keys(this.config.environments).map(name =>\n              createEnvironment(name, this.config)\n            )\n          : createDefaultEnvironment(this.config)\n      ).map(async env => {\n        this.#environments[env.name] = await this.createEnvironment(env);\n      })\n    );\n  }\n\n  /**\n   * Get an environment by name, or the default environment if no name is provided\n   *\n   * @param name - The name of the environment to retrieve.\n   * @returns The requested environment context.\n   */\n  public async getEnvironment(name?: string) {\n    let environment:\n      | PowerlinesEnvironmentContext<TResolvedConfig, TSystemContext>\n      | undefined;\n    if (name) {\n      environment = this.environments[name];\n    }\n\n    if (Object.keys(this.environments).length === 1) {\n      environment = this.environments[Object.keys(this.environments)[0]!];\n\n      this.trace({\n        meta: { category: \"plugins\" },\n        message: `Applying the only configured environment: ${chalk.bold.cyanBright(\n          environment?.config.environment?.name\n        )}`\n      });\n    }\n\n    if (!environment) {\n      if (name) {\n        throw new Error(`Environment \"${name}\" not found.`);\n      }\n\n      environment = await this.createEnvironment(\n        createDefaultEnvironment(this.config)\n      );\n\n      // environment = await PowerlinesEnvironmentContext.from<TResolvedConfig>(\n      //   deepClone(this.options),\n      //   deepClone(this.config) as TResolvedConfig,\n      //   deepClone(this.overriddenConfig) as InferOverridableConfig<\n      //     EnvironmentResolvedConfig<TResolvedConfig>\n      //   >,\n      //   deepClone(\n      //     createDefaultEnvironment(this.config)\n      //   ) as EnvironmentResolvedConfig<TResolvedConfig>[\"environment\"]\n      // );\n\n      // environment.plugins = [];\n      // for (const plugin of this.plugins) {\n      //   await environment.addPlugin(plugin);\n      // }\n\n      this.warn({\n        meta: { category: \"plugins\" },\n        message: `No environment specified, and no default environment found. Using a temporary default environment: ${chalk.bold.cyanBright(\n          environment.config.environment?.name\n        )}`\n      });\n    }\n\n    return environment;\n  }\n\n  /**\n   * A safe version of `getEnvironment` that returns `undefined` if the environment is not found\n   *\n   * @param name - The name of the environment to retrieve.\n   * @returns The requested environment context or `undefined` if not found.\n   */\n  public async getEnvironmentSafe(\n    name?: string\n  ): Promise<\n    PowerlinesEnvironmentContext<TResolvedConfig, TSystemContext> | undefined\n  > {\n    try {\n      return await this.getEnvironment(name);\n    } catch {\n      return undefined;\n    }\n  }\n\n  /**\n   * A function to merge all configured environments into a single context.\n   *\n   * @remarks\n   * If only one environment is configured, that environment will be returned directly.\n   *\n   * @returns A promise that resolves to a merged/global environment context.\n   */\n  public async toEnvironment(): Promise<\n    PowerlinesEnvironmentContext<TResolvedConfig, TSystemContext>\n  > {\n    let environment: PowerlinesEnvironmentContext<\n      TResolvedConfig,\n      TSystemContext\n    >;\n    if (Object.keys(this.environments).length > 1) {\n      environment = await this.createEnvironment(\n        createEnvironment<TResolvedConfig>(GLOBAL_ENVIRONMENT, this.config)\n      );\n\n      this.debug({\n        meta: { category: \"plugins\" },\n        message: `Combined all ${Object.keys(this.environments).length} environments into a single global context.`\n      });\n    } else {\n      environment = await this.getEnvironment();\n    }\n\n    return environment;\n  }\n\n  /**\n   * A function used internally to add a plugin to the context and update the configuration options\n   *\n   * @danger\n   * This field is for internal use only and should not be accessed or modified directly. It is unstable and can be changed at anytime.\n   *\n   * @internal\n   */\n  public async unstable_addPlugin(\n    plugin: PluginConfig<PluginContext<TResolvedConfig, TSystemContext>>\n  ) {\n    this.plugins.push(\n      ...(await resolvePlugins<TResolvedConfig, TSystemContext>(this, plugin, {\n        skipLogging:\n          Object.keys(this.environments).filter(\n            key => key !== DEFAULT_ENVIRONMENT && key !== GLOBAL_ENVIRONMENT\n          ).length > 0\n      }))\n    );\n\n    await Promise.all(\n      Object.keys(this.environments).map(async name => {\n        await this.environments[name]!.unstable_addPlugin(plugin);\n      })\n    );\n  }\n}\n"],"mappings":"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"}

package/dist/context/index.cjs

@@ -0,0 +1,12 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_context_base_context = require('./base-context.cjs');
+const require_context_context = require('./context.cjs');
+const require_context_plugin_context = require('./plugin-context.cjs');
+const require_context_environment_context = require('./environment-context.cjs');
+const require_context_execution_context = require('./execution-context.cjs');
+
+exports.PowerlinesBaseContext = require_context_base_context.PowerlinesBaseContext;
+exports.PowerlinesContext = require_context_context.PowerlinesContext;
+exports.PowerlinesEnvironmentContext = require_context_environment_context.PowerlinesEnvironmentContext;
+exports.PowerlinesExecutionContext = require_context_execution_context.PowerlinesExecutionContext;
+exports.createPluginContext = require_context_plugin_context.createPluginContext;

package/dist/context/index.d.cts

@@ -0,0 +1,6 @@
+import { PowerlinesBaseContext } from "./base-context.cjs";
+import { PowerlinesContext } from "./context.cjs";
+import { PowerlinesEnvironmentContext } from "./environment-context.cjs";
+import { PowerlinesExecutionContext } from "./execution-context.cjs";
+import { createPluginContext } from "./plugin-context.cjs";
+export { PowerlinesBaseContext, PowerlinesContext, PowerlinesEnvironmentContext, PowerlinesExecutionContext, createPluginContext };

package/dist/context/index.d.mts

@@ -0,0 +1,6 @@
+import { PowerlinesBaseContext } from "./base-context.mjs";
+import { PowerlinesContext } from "./context.mjs";
+import { PowerlinesEnvironmentContext } from "./environment-context.mjs";
+import { PowerlinesExecutionContext } from "./execution-context.mjs";
+import { createPluginContext } from "./plugin-context.mjs";
+export { PowerlinesBaseContext, PowerlinesContext, PowerlinesEnvironmentContext, PowerlinesExecutionContext, createPluginContext };

package/dist/context/index.mjs

@@ -0,0 +1,7 @@
+import { PowerlinesBaseContext } from "./base-context.mjs";
+import { PowerlinesContext } from "./context.mjs";
+import { createPluginContext } from "./plugin-context.mjs";
+import { PowerlinesEnvironmentContext } from "./environment-context.mjs";
+import { PowerlinesExecutionContext } from "./execution-context.mjs";
+
+export { PowerlinesBaseContext, PowerlinesContext, PowerlinesEnvironmentContext, PowerlinesExecutionContext, createPluginContext };

package/dist/context/plugin-context.cjs

@@ -0,0 +1,83 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_runtime = require('../_virtual/_rolldown/runtime.cjs');
+let _stryke_type_checks_is_set_object = require("@stryke/type-checks/is-set-object");
+let _stryke_type_checks_is_string = require("@stryke/type-checks/is-string");
+
+//#region src/context/plugin-context.ts
+/**
+* Create a Proxy-based PluginContext
+*
+* @param pluginId - The unique identifier of the plugin
+* @param plugin - The plugin instance
+* @param environment - The environment context
+* @returns The proxied plugin context
+*/
+function createPluginContext(pluginId, plugin, environment) {
+	const logger = environment.extendLogger({ plugin: plugin.name });
+	const normalizeMessage = (message) => {
+		return {
+			meta: {
+				...(0, _stryke_type_checks_is_set_object.isSetObject)(message) ? message.meta : {},
+				environment: environment.config.environment.name,
+				plugin: plugin.name
+			},
+			message: (0, _stryke_type_checks_is_string.isString)(message) ? message : message.message
+		};
+	};
+	return new Proxy({}, {
+		get(_, prop) {
+			if (prop === "environment") return environment;
+			if (prop === "id") return pluginId;
+			if (prop === "logger") return logger;
+			if (prop === "log") return (type, message) => {
+				logger.log(type, normalizeMessage(message));
+			};
+			if (prop === "fatal") return (message) => {
+				logger.error(normalizeMessage(message));
+			};
+			if (prop === "error") return (message) => {
+				logger.error(normalizeMessage(message));
+			};
+			if (prop === "warn") return (message) => {
+				logger.warn(normalizeMessage(message));
+			};
+			if (prop === "info") return (message) => {
+				logger.info(normalizeMessage(message));
+			};
+			if (prop === "debug") return (message) => {
+				logger.debug(normalizeMessage(message));
+			};
+			if (prop === "trace") return (message) => {
+				logger.trace(normalizeMessage(message));
+			};
+			return environment[prop];
+		},
+		set(_, prop, value) {
+			if (prop === "unstable_addPlugin") {
+				logger.warn("Plugins should not be calling the 'addPlugin' function directly. This function is meant to be used internally by Powerlines and may cause unexpected behavior if used incorrectly.");
+				return false;
+			}
+			if ([
+				"id",
+				"environment",
+				"config",
+				"log",
+				"logger",
+				"error",
+				"warn",
+				"plugins",
+				"hooks",
+				"fs",
+				"selectHooks"
+			].includes(prop)) {
+				logger.warn(`Cannot set the read-only "${String(prop)}" property`);
+				return false;
+			}
+			environment[prop] = value;
+			return true;
+		}
+	});
+}
+
+//#endregion
+exports.createPluginContext = createPluginContext;

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

@@ -0,0 +1,18 @@
+import { Plugin } from "../types/plugin.cjs";
+import { PluginContext } from "../types/context.cjs";
+import { ResolvedConfig } from "../types/config.cjs";
+import { PowerlinesEnvironmentContext } from "./environment-context.cjs";
+
+//#region src/context/plugin-context.d.ts
+/**
+ * Create a Proxy-based PluginContext
+ *
+ * @param pluginId - The unique identifier of the plugin
+ * @param plugin - The plugin instance
+ * @param environment - The environment context
+ * @returns The proxied plugin context
+ */
+declare function createPluginContext<TResolvedConfig extends ResolvedConfig = ResolvedConfig, TSystemContext = unknown>(pluginId: string, plugin: Plugin<PluginContext<TResolvedConfig, TSystemContext>>, environment: PowerlinesEnvironmentContext<TResolvedConfig, TSystemContext>): PluginContext<TResolvedConfig, TSystemContext>;
+//#endregion
+export { createPluginContext };
+//# sourceMappingURL=plugin-context.d.cts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-context.d.cts","names":[],"sources":["../../src/context/plugin-context.ts"],"mappings":";;;;;;;;;;;AAuCA;;;iBAAgB,mBAAA,yBACU,cAAA,GAAiB,cAAA,2BAAA,CAGzC,QAAA,UACA,MAAA,EAAQ,MAAA,CAAO,aAAA,CAAc,eAAA,EAAiB,cAAA,IAC9C,WAAA,EAAa,4BAAA,CAA6B,eAAA,EAAiB,cAAA,IAC1D,aAAA,CAAc,eAAA,EAAiB,cAAA"}

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

@@ -0,0 +1,18 @@
+import { Plugin } from "../types/plugin.mjs";
+import { PluginContext } from "../types/context.mjs";
+import { ResolvedConfig } from "../types/config.mjs";
+import { PowerlinesEnvironmentContext } from "./environment-context.mjs";
+
+//#region src/context/plugin-context.d.ts
+/**
+ * Create a Proxy-based PluginContext
+ *
+ * @param pluginId - The unique identifier of the plugin
+ * @param plugin - The plugin instance
+ * @param environment - The environment context
+ * @returns The proxied plugin context
+ */
+declare function createPluginContext<TResolvedConfig extends ResolvedConfig = ResolvedConfig, TSystemContext = unknown>(pluginId: string, plugin: Plugin<PluginContext<TResolvedConfig, TSystemContext>>, environment: PowerlinesEnvironmentContext<TResolvedConfig, TSystemContext>): PluginContext<TResolvedConfig, TSystemContext>;
+//#endregion
+export { createPluginContext };
+//# sourceMappingURL=plugin-context.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-context.d.mts","names":[],"sources":["../../src/context/plugin-context.ts"],"mappings":";;;;;;;;;;;AAuCA;;;iBAAgB,mBAAA,yBACU,cAAA,GAAiB,cAAA,2BAAA,CAGzC,QAAA,UACA,MAAA,EAAQ,MAAA,CAAO,aAAA,CAAc,eAAA,EAAiB,cAAA,IAC9C,WAAA,EAAa,4BAAA,CAA6B,eAAA,EAAiB,cAAA,IAC1D,aAAA,CAAc,eAAA,EAAiB,cAAA"}

package/dist/context/plugin-context.mjs

@@ -0,0 +1,82 @@
+import { isSetObject } from "@stryke/type-checks/is-set-object";
+import { isString } from "@stryke/type-checks/is-string";
+
+//#region src/context/plugin-context.ts
+/**
+* Create a Proxy-based PluginContext
+*
+* @param pluginId - The unique identifier of the plugin
+* @param plugin - The plugin instance
+* @param environment - The environment context
+* @returns The proxied plugin context
+*/
+function createPluginContext(pluginId, plugin, environment) {
+	const logger = environment.extendLogger({ plugin: plugin.name });
+	const normalizeMessage = (message) => {
+		return {
+			meta: {
+				...isSetObject(message) ? message.meta : {},
+				environment: environment.config.environment.name,
+				plugin: plugin.name
+			},
+			message: isString(message) ? message : message.message
+		};
+	};
+	return new Proxy({}, {
+		get(_, prop) {
+			if (prop === "environment") return environment;
+			if (prop === "id") return pluginId;
+			if (prop === "logger") return logger;
+			if (prop === "log") return (type, message) => {
+				logger.log(type, normalizeMessage(message));
+			};
+			if (prop === "fatal") return (message) => {
+				logger.error(normalizeMessage(message));
+			};
+			if (prop === "error") return (message) => {
+				logger.error(normalizeMessage(message));
+			};
+			if (prop === "warn") return (message) => {
+				logger.warn(normalizeMessage(message));
+			};
+			if (prop === "info") return (message) => {
+				logger.info(normalizeMessage(message));
+			};
+			if (prop === "debug") return (message) => {
+				logger.debug(normalizeMessage(message));
+			};
+			if (prop === "trace") return (message) => {
+				logger.trace(normalizeMessage(message));
+			};
+			return environment[prop];
+		},
+		set(_, prop, value) {
+			if (prop === "unstable_addPlugin") {
+				logger.warn("Plugins should not be calling the 'addPlugin' function directly. This function is meant to be used internally by Powerlines and may cause unexpected behavior if used incorrectly.");
+				return false;
+			}
+			if ([
+				"id",
+				"environment",
+				"config",
+				"log",
+				"logger",
+				"error",
+				"warn",
+				"plugins",
+				"hooks",
+				"fs",
+				"selectHooks"
+			].includes(prop)) {
+				logger.warn(`Cannot set the read-only "${String(prop)}" property`);
+				return false;
+			}
+			environment[prop] = value;
+			return true;
+		}
+	});
+}
+
+//#endregion
+export { createPluginContext };
+//# sourceMappingURL=plugin-context.mjs.map

package/dist/context/plugin-context.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-context.mjs","names":[],"sources":["../../src/context/plugin-context.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 { isSetObject } from \"@stryke/type-checks/is-set-object\";\nimport { isString } from \"@stryke/type-checks/is-string\";\nimport { UnpluginMessage } from \"unplugin\";\nimport type {\n  EnvironmentContext,\n  LoggerMessage,\n  LogLevel,\n  Plugin,\n  PluginContext,\n  ResolvedConfig\n} from \"../types\";\nimport { PowerlinesEnvironmentContext } from \"./environment-context\";\n\n/**\n * Create a Proxy-based PluginContext\n *\n * @param pluginId - The unique identifier of the plugin\n * @param plugin - The plugin instance\n * @param environment - The environment context\n * @returns The proxied plugin context\n */\nexport function createPluginContext<\n  TResolvedConfig extends ResolvedConfig = ResolvedConfig,\n  TSystemContext = unknown\n>(\n  pluginId: string,\n  plugin: Plugin<PluginContext<TResolvedConfig, TSystemContext>>,\n  environment: PowerlinesEnvironmentContext<TResolvedConfig, TSystemContext>\n): PluginContext<TResolvedConfig, TSystemContext> {\n  const logger = environment.extendLogger({\n    plugin: plugin.name\n  });\n\n  const normalizeMessage = (\n    message: string | UnpluginMessage\n  ): LoggerMessage => {\n    return {\n      meta: {\n        ...(isSetObject(message) ? message.meta : {}),\n        environment: environment.config.environment.name,\n        plugin: plugin.name\n      },\n      message: isString(message) ? message : message.message\n    };\n  };\n\n  return new Proxy({} as PluginContext<TResolvedConfig, TSystemContext>, {\n    get(_, prop) {\n      if (prop === \"environment\") {\n        return environment;\n      }\n\n      if (prop === \"id\") {\n        return pluginId;\n      }\n\n      if (prop === \"logger\") {\n        return logger;\n      }\n\n      if (prop === \"log\") {\n        return (type: LogLevel, message: string | UnpluginMessage) => {\n          logger.log(type, normalizeMessage(message));\n        };\n      }\n\n      if (prop === \"fatal\") {\n        return (message: string | UnpluginMessage) => {\n          logger.error(normalizeMessage(message));\n        };\n      }\n\n      if (prop === \"error\") {\n        return (message: string | UnpluginMessage) => {\n          logger.error(normalizeMessage(message));\n        };\n      }\n\n      if (prop === \"warn\") {\n        return (message: string | UnpluginMessage) => {\n          logger.warn(normalizeMessage(message));\n        };\n      }\n\n      if (prop === \"info\") {\n        return (message: string | UnpluginMessage) => {\n          logger.info(normalizeMessage(message));\n        };\n      }\n\n      if (prop === \"debug\") {\n        return (message: string | UnpluginMessage) => {\n          logger.debug(normalizeMessage(message));\n        };\n      }\n\n      if (prop === \"trace\") {\n        return (message: string | UnpluginMessage) => {\n          logger.trace(normalizeMessage(message));\n        };\n      }\n\n      return environment[\n        prop as keyof EnvironmentContext<TResolvedConfig, TSystemContext>\n      ];\n    },\n    set(_, prop, value) {\n      if (prop === \"unstable_addPlugin\") {\n        logger.warn(\n          \"Plugins should not be calling the 'addPlugin' function directly. This function is meant to be used internally by Powerlines and may cause unexpected behavior if used incorrectly.\"\n        );\n        return false;\n      }\n\n      if (\n        [\n          \"id\",\n          \"environment\",\n          \"config\",\n          \"log\",\n          \"logger\",\n          \"error\",\n          \"warn\",\n          \"plugins\",\n          \"hooks\",\n          \"fs\",\n          \"selectHooks\"\n        ].includes(prop as string)\n      ) {\n        logger.warn(`Cannot set the read-only \"${String(prop)}\" property`);\n\n        return false;\n      }\n\n      (environment as Record<string, any>)[prop as string] = value;\n      return true;\n    }\n  });\n}\n"],"mappings":";;;;;;;;;;;;AAuCA,SAAgB,oBAId,UACA,QACA,aACgD;CAChD,MAAM,SAAS,YAAY,aAAa,EACtC,QAAQ,OAAO,MAChB,CAAC;CAEF,MAAM,oBACJ,YACkB;AAClB,SAAO;GACL,MAAM;IACJ,GAAI,YAAY,QAAQ,GAAG,QAAQ,OAAO,EAAE;IAC5C,aAAa,YAAY,OAAO,YAAY;IAC5C,QAAQ,OAAO;IAChB;GACD,SAAS,SAAS,QAAQ,GAAG,UAAU,QAAQ;GAChD;;AAGH,QAAO,IAAI,MAAM,EAAE,EAAoD;EACrE,IAAI,GAAG,MAAM;AACX,OAAI,SAAS,cACX,QAAO;AAGT,OAAI,SAAS,KACX,QAAO;AAGT,OAAI,SAAS,SACX,QAAO;AAGT,OAAI,SAAS,MACX,SAAQ,MAAgB,YAAsC;AAC5D,WAAO,IAAI,MAAM,iBAAiB,QAAQ,CAAC;;AAI/C,OAAI,SAAS,QACX,SAAQ,YAAsC;AAC5C,WAAO,MAAM,iBAAiB,QAAQ,CAAC;;AAI3C,OAAI,SAAS,QACX,SAAQ,YAAsC;AAC5C,WAAO,MAAM,iBAAiB,QAAQ,CAAC;;AAI3C,OAAI,SAAS,OACX,SAAQ,YAAsC;AAC5C,WAAO,KAAK,iBAAiB,QAAQ,CAAC;;AAI1C,OAAI,SAAS,OACX,SAAQ,YAAsC;AAC5C,WAAO,KAAK,iBAAiB,QAAQ,CAAC;;AAI1C,OAAI,SAAS,QACX,SAAQ,YAAsC;AAC5C,WAAO,MAAM,iBAAiB,QAAQ,CAAC;;AAI3C,OAAI,SAAS,QACX,SAAQ,YAAsC;AAC5C,WAAO,MAAM,iBAAiB,QAAQ,CAAC;;AAI3C,UAAO,YACL;;EAGJ,IAAI,GAAG,MAAM,OAAO;AAClB,OAAI,SAAS,sBAAsB;AACjC,WAAO,KACL,qLACD;AACD,WAAO;;AAGT,OACE;IACE;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACA;IACD,CAAC,SAAS,KAAe,EAC1B;AACA,WAAO,KAAK,6BAA6B,OAAO,KAAK,CAAC,YAAY;AAElE,WAAO;;AAGT,GAAC,YAAoC,QAAkB;AACvD,UAAO;;EAEV,CAAC"}