powerlines 0.42.29 → 0.42.30

package/dist/{api-DX4IemwF.mjs → api-BQswQ9mT.mjs}

@@ -1,8 +1,7 @@
-import { n as createProgram } from "./ts-morph-B85ZbV1Q.mjs";
 import { t as utils_exports } from "./utils.mjs";
 import { t as plugin_utils_exports } from "./plugin-utils.mjs";
-import { d as writeMetaFile, f as callHook, p as mergeConfigs, t as PowerlinesAPIContext } from "./api-context-p1enWkF-.mjs";
-import { a as isIncludeMatchFound, i as getTsconfigFilePath, r as getParsedTypeScriptConfig } from "./tsconfig-DoV1dUYg.mjs";
+import { d as writeMetaFile, f as callHook, p as mergeConfigs, t as PowerlinesAPIContext } from "./api-context-AY_byIdN.mjs";
+import { a as isIncludeMatchFound, i as getTsconfigFilePath, r as getParsedTypeScriptConfig } from "./tsconfig-B8RooiIp.mjs";
 import { formatLogMessage } from "@storm-software/config-tools/logger/console";
 import { toArray } from "@stryke/convert/to-array";
 import { copyFiles } from "@stryke/fs/copy-file";
@@ -18,7 +17,8 @@ import { appendPath } from "@stryke/path/append";
 import { findFileName, findFilePath, relativePath } from "@stryke/path/file-path-fns";
 import { isParentPath } from "@stryke/path/is-parent-path";
 import { joinPaths } from "@stryke/path/join-paths";
-import { replaceExtension, replacePath } from "@stryke/path/replace";
+import { replacePath } from "@stryke/path/replace";
+import { titleCase } from "@stryke/string-format/title-case";
 import { isError } from "@stryke/type-checks/is-error";
 import { isFunction } from "@stryke/type-checks/is-function";
 import { isNumber } from "@stryke/type-checks/is-number";
@@ -31,22 +31,21 @@ import { isString } from "@stryke/type-checks/is-string";
 import chalk from "chalk";
 import defu$1 from "defu";
 import Handlebars from "handlebars";
+import { isParentPath as isParentPath$1 } from "@stryke/path";
 import { prettyBytes } from "@stryke/string-format/pretty-bytes";
 import { match } from "bundle-require";
-import { DiagnosticCategory } from "ts-morph";
+import { createBundle } from "dts-buddy";
 import { getPackageName, getPackageVersion, hasPackageVersion } from "@stryke/string-format/package";
 import { readJsonFile } from "@stryke/fs/json";
 import { getObjectDiff } from "@donedeal0/superdiff";
 import { StormJSON } from "@stryke/json/storm-json";
-import { titleCase } from "@stryke/string-format/title-case";
 
 //#region package.json
 var name = "powerlines";
-var version = "0.42.29";
+var version = "0.42.30";
 
 //#endregion
 //#region src/_internal/helpers/generate-types.ts
-const getModuleCommentBlockRegex = (moduleId) => new RegExp(`\\/\\*\\*(?s:.)*?@module\\s+${moduleId}(?s:.)*?\\*\\/\\s+`);
 /**
 * Formats the generated TypeScript types source code.
 *
@@ -57,37 +56,6 @@ function formatTypes(code = "") {
 	return code.replaceAll("#private;", "").replace(/__Ω/g, "");
 }
 /**
-* Formats a generated TypeScript module in the types source code.
-*
-* @param context - The Powerlines context.
-* @param id - The module ID for the generated TypeScript module.
-* @param code - The generated TypeScript module code.
-* @returns The formatted TypeScript module code.
-*/
-async function formatTypesModule(context, id, code) {
-	const moduleComment = code.match(getModuleCommentBlockRegex(`${context.config.framework}:${id}`))?.find((comment) => isSetString(comment?.trim()));
-	const ast = await context.parse(code, {
-		lang: "dts",
-		astType: "ts"
-	});
-	return {
-		code: `${moduleComment ? `
-${moduleComment.trim()}` : ""}
-declare module "${context.config.framework}:${id}" {
-  ${ast.module.staticImports.filter((staticImport) => !match(staticImport.moduleRequest.value, context.config.resolve.external) && !staticImport.moduleRequest.value.startsWith("node:")).map((staticImport) => {
-			return `import type { ${staticImport.entries.map((entry) => `${entry.importName.name}${entry.localName.value ? ` as ${entry.localName.value}` : ""}`).join(", ")} } from "${staticImport.moduleRequest.value}"; `;
-		}).join("\n")}
-
-  ${ast.module.staticImports.filter((staticImport) => !match(staticImport.moduleRequest.value, context.config.resolve.external) && !staticImport.moduleRequest.value.startsWith("node:")).reduce((ret, staticImport) => {
-			return `import type { ${staticImport.entries.map((entry) => `${entry.importName.name}${entry.localName.value ? ` as ${entry.localName.value}` : ""}`).join(", ")} } from "${staticImport.moduleRequest.value}";${ret.replaceAll(new RegExp(`^import.*from\\s+['"]${staticImport.moduleRequest.value}['"]\\s*;?$`, "gm"), "")}`;
-		}, code).replace(moduleComment ?? "", "").replaceAll(/^\s*export\s*declare\s*/gm, "export ").replaceAll(/^\s*declare\s*/gm, "").replaceAll(/^\s*export\s*\{\s*\}/gm, "").replaceAll(/^\s*export\s*=\s*/gm, "export default ").replaceAll(/^\s*export\s*\{/gm, "export {").replaceAll(/^\s*export\s*default\s*\{/gm, "export default {").replaceAll(/^\s*export\s*function\s*/gm, "export function ").replaceAll(/^\s*export\s*class\s*/gm, "export class ").replaceAll(/^\s*export\s*interface\s*/gm, "export interface ").replaceAll(/^\s*export\s*type\s*/gm, "export type ").replaceAll(/^\s*export\s*enum\s*/gm, "export enum ").replaceAll(/^\s*export\s*namespace\s*/gm, "export namespace ")}${ast.module.staticExports.length === 0 ? `
-  export {};` : ""}
-}
-`,
-		directives: ast.module.staticImports.filter((staticImport) => match(staticImport.moduleRequest.value, context.config.resolve.external) || staticImport.moduleRequest.value.startsWith("node:")).map((staticImport) => staticImport.moduleRequest.value)
-	};
-}
-/**
 * Emits TypeScript declaration types for the provided files using the given TypeScript configuration.
 *
 * @param context - The context containing options and environment paths.
@@ -103,8 +71,15 @@ async function emitBuiltinTypes(context, files) {
 		};
 	}
 	context.debug(`Running the TypeScript compiler for ${files.length} generated built-in module files.`);
-	const program = createProgram(context, {
-		skipAddingFilesFromTsConfig: true,
+	let result = await createBundle({
+		context,
+		project: context.tsconfig.tsconfigFilePath,
+		output: context.typesPath,
+		include: files.map((file) => appendPath(file, context.workspaceConfig.workspaceRoot)),
+		modules: (await context.getBuiltins()).reduce((ret, file) => {
+			ret[`${context.config.framework}:${file.id}`] = file.path;
+			return ret;
+		}, {}),
 		compilerOptions: {
 			declaration: true,
 			declarationMap: false,
@@ -116,40 +91,24 @@ async function emitBuiltinTypes(context, files) {
 			tsBuildInfoFile: void 0
 		}
 	});
-	program.addSourceFilesAtPaths(files);
-	const emitResult = program.emitToMemory({ emitOnlyDtsFiles: true });
-	const diagnostics = emitResult.getDiagnostics();
-	if (diagnostics && diagnostics.length > 0) if (diagnostics.some((d) => d.getCategory() === DiagnosticCategory.Error)) throw new Error(`The Typescript emit process failed while generating built-in types: \n ${diagnostics.filter((d) => d.getCategory() === DiagnosticCategory.Error).map((d) => `-${d.getSourceFile() ? `${d.getSourceFile()?.getFilePath()}:` : ""} ${String(d.getMessageText())} (at ${d.getStart()}:${d.getLength()})`).join("\n")}`);
-	else if (diagnostics.some((d) => d.getCategory() === DiagnosticCategory.Warning)) context.warn(`The Typescript emit process completed with warnings while generating built-in types: \n ${diagnostics.filter((d) => d.getCategory() === DiagnosticCategory.Warning).map((d) => `-${d.getSourceFile() ? `${d.getSourceFile()?.getFilePath()}:` : ""} ${String(d.getMessageText())} (at ${d.getStart()}:${d.getLength()})`).join("\n")}`);
-	else context.debug(`The Typescript emit process completed with diagnostic messages while generating built-in types: \n ${diagnostics.map((d) => `-${d.getSourceFile() ? `${d.getSourceFile()?.getFilePath()}:` : ""} ${String(d.getMessageText())} (at ${d.getStart()}:${d.getLength()})`).join("\n")}`);
-	const emittedFiles = emitResult.getFiles();
-	context.debug(`The TypeScript compiler emitted ${emittedFiles.length} files for built-in types.`);
-	if (emittedFiles.length === 0) {
-		context.warn("The TypeScript compiler did not emit any files for built-in types. This may indicate an issue with the TypeScript configuration or the provided files.");
-		return {
-			code: "",
-			directives: []
-		};
-	}
-	let result = "";
-	const directives = [];
-	for (const emittedFile of emittedFiles) {
-		context.trace(`Processing emitted type declaration file: ${emittedFile.filePath}`);
-		const filePath = appendPath(emittedFile.filePath, context.workspaceConfig.workspaceRoot);
-		if (!filePath.endsWith(".map") && findFileName(filePath) !== "tsconfig.tsbuildinfo" && isParentPath(filePath, context.builtinsPath)) {
-			const moduleId = replaceExtension(replacePath(replacePath(filePath, context.builtinsPath), replacePath(context.builtinsPath, context.workspaceConfig.workspaceRoot)), "", { fullExtension: true });
-			if (context.builtins.includes(moduleId)) {
-				const formatted = await formatTypesModule(context, moduleId, emittedFile.text);
-				result += formatted.code;
-				directives.push(...formatted.directives);
+	result = formatTypes(result);
+	for (const file of files.map((file) => appendPath(file, context.workspaceConfig.workspaceRoot)).filter((file) => isParentPath$1(file, context.builtinsPath))) {
+		const content = await context.fs.read(file);
+		if (isSetString(content)) {
+			const moduleComment = content.match(new RegExp(`\\/\\*\\*(?s:.)*?@module\\s+${context.config.framework}:(?:${context.builtins.join("|")})(?s:.)*?\\*\\/\\s+`))?.find((comment) => isSetString(comment?.trim()));
+			if (moduleComment) {
+				context.debug(`Adding module-level comment for the built-in module types declaration for file: ${file}`);
+				const metadata = context.fs.getMetadata(file);
+				if (metadata?.id) result = result.replace(`declare module "${context.config.framework}:${metadata.id}" {`, `${moduleComment.trim()}
+declare module "${context.config.framework}:${metadata.id}" {`);
 			}
 		}
 	}
-	result = await (0, utils_exports.format)(context, context.typesPath, formatTypes(result));
+	result = await (0, utils_exports.format)(context, context.typesPath, result);
 	context.debug(`A TypeScript declaration file (size: ${prettyBytes(new Blob(toArray(result)).size)}) emitted for the built-in modules types.`);
 	return {
 		code: result,
-		directives
+		directives: []
 	};
 }
 
@@ -326,8 +285,9 @@ var PowerlinesAPI = class PowerlinesAPI {
 			addPlugin: api.#addPlugin.bind(api)
 		};
 		api.context.info(`🔌 The Powerlines Engine v${version} has started`);
-		for (const plugin of api.context.config.plugins ?? []) await api.#addPlugin(plugin);
+		for (const plugin of api.context.config.plugins.flat(10) ?? []) await api.#addPlugin(plugin);
 		if (api.context.plugins.length === 0) api.context.warn("No Powerlines plugins were specified in the options. Please ensure this is correct, as it is generally not recommended.");
+		else api.context.info(`🔌 Loaded ${api.context.plugins.length} ${titleCase(api.context.config.framework)} plugin${api.context.plugins.length > 1 ? "s" : ""}: \n\n${api.context.plugins.map((plugin, index) => ` ${index + 1}. ${(0, utils_exports.colorText)(plugin.name)}`).join("\n")}`);
 		const pluginConfig = await api.callHook("config", {
 			environment: await api.context.getEnvironment(),
 			sequential: true,
@@ -898,4 +858,4 @@ ${formatTypes(code)}
 
 //#endregion
 export { name as n, version as r, PowerlinesAPI as t };
-//# sourceMappingURL=api-DX4IemwF.mjs.map
+//# sourceMappingURL=api-BQswQ9mT.mjs.map

package/dist/api-BQswQ9mT.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-BQswQ9mT.mjs","names":["isParentPath","#context","#addPlugin","packageJson.version","#executeEnvironments","defu","#types","#handleBuild","#getEnvironments","#initPlugin","#resolvePlugin","isPlugin","isPluginConfig"],"sources":["../package.json","../src/_internal/helpers/generate-types.ts","../src/_internal/helpers/install.ts","../src/_internal/helpers/install-dependencies.ts","../src/_internal/helpers/resolve-tsconfig.ts","../src/api.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 { isParentPath } from \"@stryke/path\";\nimport { appendPath } from \"@stryke/path/append\";\nimport { replacePath } from \"@stryke/path/replace\";\nimport { prettyBytes } from \"@stryke/string-format/pretty-bytes\";\nimport { isSetString } from \"@stryke/type-checks/is-set-string\";\nimport { match } from \"bundle-require\";\nimport { createBundle } from \"dts-buddy\";\nimport { Context } from \"../../types\";\nimport { format } from \"../../utils\";\n\n/**\n * Formats the generated TypeScript types source code.\n *\n * @param code - The generated TypeScript code.\n * @returns The formatted TypeScript code.\n */\nexport function formatTypes(code = \"\"): string {\n  return code.replaceAll(\"#private;\", \"\").replace(/__Ω/g, \"\");\n}\n\n/**\n * Formats a generated TypeScript module in the types source code.\n *\n * @param context - The Powerlines context.\n * @param id - The module ID for the generated TypeScript module.\n * @param code - The generated TypeScript module code.\n * @returns The formatted TypeScript module code.\n */\nexport async function formatTypesModule(\n  context: Context,\n  id: string,\n  code: string\n): Promise<{ code: string; directives: string[] }> {\n  const ast = await context.parse(code, {\n    lang: \"dts\",\n    astType: \"ts\"\n  });\n\n  return {\n    code: `declare module \"${context.config.framework}:${id}\" {\n  ${ast.module.staticImports\n    .filter(\n      staticImport =>\n        !match(\n          staticImport.moduleRequest.value,\n          context.config.resolve.external\n        ) && !staticImport.moduleRequest.value.startsWith(\"node:\")\n    )\n    .map(staticImport => {\n      return `import type { ${staticImport.entries\n        .map(\n          entry =>\n            `${entry.importName.name}${entry.localName.value ? ` as ${entry.localName.value}` : \"\"}`\n        )\n        .join(\", \")} } from \"${staticImport.moduleRequest.value}\"; `;\n    })\n    .join(\"\\n\")}\n\n  ${ast.module.staticImports\n    .filter(\n      staticImport =>\n        !match(\n          staticImport.moduleRequest.value,\n          context.config.resolve.external\n        ) && !staticImport.moduleRequest.value.startsWith(\"node:\")\n    )\n    .reduce((ret, staticImport) => {\n      return `import type { ${staticImport.entries\n        .map(\n          entry =>\n            `${entry.importName.name}${entry.localName.value ? ` as ${entry.localName.value}` : \"\"}`\n        )\n        .join(\n          \", \"\n        )} } from \"${staticImport.moduleRequest.value}\";${ret.replaceAll(\n        new RegExp(\n          `^import.*from\\\\s+['\"]${staticImport.moduleRequest.value}['\"]\\\\s*;?$`,\n          \"gm\"\n        ),\n        \"\"\n      )}`;\n    }, code)\n    .replaceAll(/^\\s*export\\s*declare\\s*/gm, \"export \")\n    .replaceAll(/^\\s*declare\\s*/gm, \"\")\n    .replaceAll(/^\\s*export\\s*\\{\\s*\\}/gm, \"\")\n    .replaceAll(/^\\s*export\\s*=\\s*/gm, \"export default \")\n    .replaceAll(/^\\s*export\\s*\\{/gm, \"export {\")\n    .replaceAll(/^\\s*export\\s*default\\s*\\{/gm, \"export default {\")\n    .replaceAll(/^\\s*export\\s*function\\s*/gm, \"export function \")\n    .replaceAll(/^\\s*export\\s*class\\s*/gm, \"export class \")\n    .replaceAll(/^\\s*export\\s*interface\\s*/gm, \"export interface \")\n    .replaceAll(/^\\s*export\\s*type\\s*/gm, \"export type \")\n    .replaceAll(/^\\s*export\\s*enum\\s*/gm, \"export enum \")\n    .replaceAll(/^\\s*export\\s*namespace\\s*/gm, \"export namespace \")}${\n    ast.module.staticExports.length === 0\n      ? `\n  export {};`\n      : \"\"\n  }\n}\n`,\n    directives: ast.module.staticImports\n      .filter(\n        staticImport =>\n          match(\n            staticImport.moduleRequest.value,\n            context.config.resolve.external\n          ) || staticImport.moduleRequest.value.startsWith(\"node:\")\n      )\n      .map(staticImport => staticImport.moduleRequest.value)\n  };\n}\n\n/**\n * Emits TypeScript declaration types for the provided files using the given TypeScript configuration.\n *\n * @param context - The context containing options and environment paths.\n * @param files - The list of files to generate types for.\n * @returns A promise that resolves to the generated TypeScript declaration types.\n */\nexport async function emitBuiltinTypes<TContext extends Context>(\n  context: TContext,\n  files: string[]\n): Promise<{ code: string; directives: string[] }> {\n  if (files.length === 0) {\n    context.debug(\n      \"No files provided for TypeScript types generation. Typescript compilation for built-in modules will be skipped.\"\n    );\n    return { code: \"\", directives: [] };\n  }\n\n  context.debug(\n    `Running the TypeScript compiler for ${\n      files.length\n    } generated built-in module files.`\n  );\n\n  let result = await createBundle({\n    context,\n    project: context.tsconfig.tsconfigFilePath,\n    output: context.typesPath,\n    include: files.map(file =>\n      appendPath(file, context.workspaceConfig.workspaceRoot)\n    ),\n    modules: (await context.getBuiltins()).reduce(\n      (ret, file) => {\n        ret[`${context.config.framework}:${file.id}`] = file.path;\n        return ret;\n      },\n      {} as Record<string, string>\n    ),\n    compilerOptions: {\n      declaration: true,\n      declarationMap: false,\n      emitDeclarationOnly: true,\n      sourceMap: false,\n      outDir: replacePath(\n        context.builtinsPath,\n        context.workspaceConfig.workspaceRoot\n      ),\n      composite: false,\n      incremental: false,\n      tsBuildInfoFile: undefined\n    }\n  });\n\n  result = formatTypes(result);\n  for (const file of files\n    .map(file => appendPath(file, context.workspaceConfig.workspaceRoot))\n    .filter(file => isParentPath(file, context.builtinsPath))) {\n    const content = await context.fs.read(file);\n    if (isSetString(content)) {\n      const moduleComment = content\n        .match(\n          new RegExp(\n            `\\\\/\\\\*\\\\*(?s:.)*?@module\\\\s+${\n              context.config.framework\n            }:(?:${context.builtins.join(\"|\")})(?s:.)*?\\\\*\\\\/\\\\s+`\n          )\n        )\n        ?.find(comment => isSetString(comment?.trim()));\n\n      if (moduleComment) {\n        context.debug(\n          `Adding module-level comment for the built-in module types declaration for file: ${file}`\n        );\n\n        const metadata = context.fs.getMetadata(file);\n        if (metadata?.id) {\n          result = result.replace(\n            `declare module \"${context.config.framework}:${metadata.id}\" {`,\n            `${moduleComment.trim()}\ndeclare module \"${context.config.framework}:${metadata.id}\" {`\n          );\n        }\n      }\n    }\n  }\n\n  result = await format(context, context.typesPath, result);\n\n  context.debug(\n    `A TypeScript declaration file (size: ${prettyBytes(\n      new Blob(toArray(result)).size\n    )}) emitted for the built-in modules types.`\n  );\n\n  return { code: result, directives: [] };\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 { install } from \"@stryke/fs/install\";\nimport {\n  doesPackageMatch,\n  getPackageListing,\n  isPackageListed\n} from \"@stryke/fs/package-fns\";\nimport {\n  getPackageName,\n  getPackageVersion,\n  hasPackageVersion\n} from \"@stryke/string-format/package\";\nimport { isNumber } from \"@stryke/type-checks/is-number\";\nimport type { Context } from \"../../types\";\n\n/**\n * Installs a package if it is not already installed.\n *\n * @param context - The resolved options\n * @param packageName - The name of the package to install\n * @param dev - Whether to install the package as a dev dependency\n */\nexport async function installPackage(\n  context: Context,\n  packageName: string,\n  dev = false\n) {\n  if (\n    !(await isPackageListed(getPackageName(packageName), {\n      cwd: context.config.root\n    }))\n  ) {\n    if (context.config.autoInstall) {\n      context.warn(\n        `The package \"${packageName}\" is not installed. It will be installed automatically.`\n      );\n\n      const result = await install(packageName, {\n        cwd: context.config.root,\n        dev\n      });\n      if (isNumber(result.exitCode) && result.exitCode > 0) {\n        context.error(result.stderr);\n        throw new Error(\n          `An error occurred while installing the package \"${packageName}\"`\n        );\n      }\n    } else {\n      context.warn(\n        `The package \"${packageName}\" is not installed. Since the \"autoInstall\" option is set to false, it will not be installed automatically.`\n      );\n    }\n  } else if (\n    hasPackageVersion(packageName) &&\n    !process.env.POWERLINES_SKIP_VERSION_CHECK\n  ) {\n    const isMatching = await doesPackageMatch(\n      getPackageName(packageName),\n      getPackageVersion(packageName)!,\n      context.config.root\n    );\n    if (!isMatching) {\n      const packageListing = await getPackageListing(\n        getPackageName(packageName),\n        {\n          cwd: context.config.root\n        }\n      );\n      if (\n        !packageListing?.version.startsWith(\"catalog:\") &&\n        !packageListing?.version.startsWith(\"workspace:\")\n      ) {\n        context.warn(\n          `The package \"${getPackageName(packageName)}\" is installed but does not match the expected version ${getPackageVersion(\n            packageName\n          )} (installed version: ${packageListing?.version || \"<Unknown>\"}). Please ensure this is intentional before proceeding. Note: You can skip this validation with the \"STORM_STACK_SKIP_VERSION_CHECK\" environment variable.`\n        );\n      }\n    }\n  }\n}\n\n/**\n * Installs a package if it is not already installed.\n *\n * @param context - The resolved options\n * @param packages - The list of packages to install\n */\nexport async function installPackages(\n  context: Context,\n  packages: Array<{ name: string; dev?: boolean }>\n) {\n  return Promise.all(\n    packages.map(async pkg => installPackage(context, pkg.name, pkg.dev))\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 { getPackageName } from \"@stryke/string-format/package\";\nimport { Context } from \"../../types\";\nimport { installPackage } from \"./install\";\n\n/**\n * Install missing project dependencies.\n *\n * @param context - The build context.\n */\nexport async function installDependencies<TContext extends Context = Context>(\n  context: TContext\n): Promise<void> {\n  context.debug(`Checking and installing missing project dependencies.`);\n\n  context.dependencies ??= {};\n  context.devDependencies ??= {};\n\n  if (\n    Object.keys(context.dependencies).length === 0 &&\n    Object.keys(context.devDependencies).length === 0\n  ) {\n    context.debug(\n      `No dependencies or devDependencies to install. Skipping installation step.`\n    );\n    return;\n  }\n\n  context.debug(\n    `The following packages are required: \\nDependencies: \\n${Object.entries(\n      context.dependencies\n    )\n      .map(([name, version]) => `- ${name}@${String(version)}`)\n      .join(\" \\n\")}\\n\\nDevDependencies: \\n${Object.entries(\n      context.devDependencies\n    )\n      .map(([name, version]) => `- ${name}@${String(version)}`)\n      .join(\" \\n\")}`\n  );\n\n  await Promise.all([\n    Promise.all(\n      Object.entries(context.dependencies).map(async ([name, version]) =>\n        installPackage(\n          context,\n          `${getPackageName(name)}@${String(version)}`,\n          false\n        )\n      )\n    ),\n    Promise.all(\n      Object.entries(context.devDependencies).map(async ([name, version]) =>\n        installPackage(\n          context,\n          `${getPackageName(name)}@${String(version)}`,\n          true\n        )\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 type { Diff, ObjectData } from \"@donedeal0/superdiff\";\nimport { getObjectDiff } from \"@donedeal0/superdiff\";\nimport { readJsonFile } from \"@stryke/fs/json\";\nimport { isPackageExists } from \"@stryke/fs/package-fns\";\nimport { StormJSON } from \"@stryke/json/storm-json\";\nimport {\n  findFileName,\n  findFilePath,\n  relativePath\n} from \"@stryke/path/file-path-fns\";\nimport { joinPaths } from \"@stryke/path/join-paths\";\nimport { titleCase } from \"@stryke/string-format/title-case\";\nimport { TsConfigJson } from \"@stryke/types/tsconfig\";\nimport chalk from \"chalk\";\nimport type { EnvironmentContext } from \"../../types\";\nimport { ResolvedConfig } from \"../../types\";\nimport {\n  getParsedTypeScriptConfig,\n  getTsconfigFilePath,\n  isIncludeMatchFound\n} from \"../../typescript/tsconfig\";\n\nexport function getTsconfigDtsPath<\n  TResolvedConfig extends ResolvedConfig = ResolvedConfig\n>(context: EnvironmentContext<TResolvedConfig>): string {\n  const dtsRelativePath = joinPaths(\n    relativePath(\n      joinPaths(context.workspaceConfig.workspaceRoot, context.config.root),\n      findFilePath(context.typesPath)\n    ),\n    findFileName(context.typesPath)\n  );\n\n  return dtsRelativePath;\n}\n\nasync function resolveTsconfigChanges<\n  TResolvedConfig extends ResolvedConfig = ResolvedConfig\n>(context: EnvironmentContext<TResolvedConfig>): Promise<TsConfigJson> {\n  const tsconfig = getParsedTypeScriptConfig(\n    context.workspaceConfig.workspaceRoot,\n    context.config.root,\n    context.config.tsconfig,\n    context.config.tsconfigRaw\n  );\n\n  const tsconfigFilePath = getTsconfigFilePath(\n    context.workspaceConfig.workspaceRoot,\n    context.config.root,\n    context.config.tsconfig\n  );\n\n  const tsconfigJson = await readJsonFile<TsConfigJson>(tsconfigFilePath);\n  tsconfigJson.compilerOptions ??= {};\n\n  if (context.config.output.dts !== false) {\n    const dtsRelativePath = getTsconfigDtsPath(context);\n\n    if (\n      !tsconfigJson.include?.some(filePattern =>\n        isIncludeMatchFound(filePattern, [context.typesPath, dtsRelativePath])\n      )\n    ) {\n      tsconfigJson.include ??= [];\n      tsconfigJson.include.push(\n        dtsRelativePath.startsWith(\"./\")\n          ? dtsRelativePath.slice(2)\n          : dtsRelativePath\n      );\n    }\n  }\n\n  if (\n    !tsconfig.options.lib?.some(lib =>\n      [\n        \"lib.esnext.d.ts\",\n        \"lib.es2021.d.ts\",\n        \"lib.es2022.d.ts\",\n        \"lib.es2023.d.ts\"\n      ].includes(lib.toLowerCase())\n    )\n  ) {\n    tsconfigJson.compilerOptions.lib ??= [];\n    tsconfigJson.compilerOptions.lib.push(\"esnext\");\n  }\n\n  // if (tsconfig.options.module !== ts.ModuleKind.ESNext) {\n  //   tsconfigJson.compilerOptions.module = \"ESNext\";\n  // }\n\n  // if (\n  //   !tsconfig.options.target ||\n  //   ![\n  //     ts.ScriptTarget.ESNext,\n  //     ts.ScriptTarget.ES2024,\n  //     ts.ScriptTarget.ES2023,\n  //     ts.ScriptTarget.ES2022,\n  //     ts.ScriptTarget.ES2021\n  //   ].includes(tsconfig.options.target)\n  // ) {\n  //   tsconfigJson.compilerOptions.target = \"ESNext\";\n  // }\n\n  // if (tsconfig.options.moduleResolution !== ts.ModuleResolutionKind.Bundler) {\n  //   tsconfigJson.compilerOptions.moduleResolution = \"Bundler\";\n  // }\n\n  // if (tsconfig.options.moduleDetection !== ts.ModuleDetectionKind.Force) {\n  //   tsconfigJson.compilerOptions.moduleDetection = \"force\";\n  // }\n\n  // if (tsconfig.options.allowSyntheticDefaultImports !== true) {\n  //   tsconfigJson.compilerOptions.allowSyntheticDefaultImports = true;\n  // }\n\n  // if (tsconfig.options.noImplicitOverride !== true) {\n  //   tsconfigJson.compilerOptions.noImplicitOverride = true;\n  // }\n\n  // if (tsconfig.options.noUncheckedIndexedAccess !== true) {\n  //   tsconfigJson.compilerOptions.noUncheckedIndexedAccess = true;\n  // }\n\n  // if (tsconfig.options.skipLibCheck !== true) {\n  //   tsconfigJson.compilerOptions.skipLibCheck = true;\n  // }\n\n  // if (tsconfig.options.resolveJsonModule !== true) {\n  //   tsconfigJson.compilerOptions.resolveJsonModule = true;\n  // }\n\n  // if (tsconfig.options.verbatimModuleSyntax !== false) {\n  //   tsconfigJson.compilerOptions.verbatimModuleSyntax = false;\n  // }\n\n  // if (tsconfig.options.allowJs !== true) {\n  //   tsconfigJson.compilerOptions.allowJs = true;\n  // }\n\n  // if (tsconfig.options.declaration !== true) {\n  //   tsconfigJson.compilerOptions.declaration = true;\n  // }\n\n  if (tsconfig.options.esModuleInterop !== true) {\n    tsconfigJson.compilerOptions.esModuleInterop = true;\n  }\n\n  if (tsconfig.options.isolatedModules !== true) {\n    tsconfigJson.compilerOptions.isolatedModules = true;\n  }\n\n  if (context.config.platform === \"node\") {\n    if (\n      !tsconfig.options.types?.some(\n        type =>\n          type.toLowerCase() === \"node\" || type.toLowerCase() === \"@types/node\"\n      )\n    ) {\n      tsconfigJson.compilerOptions.types ??= [];\n      tsconfigJson.compilerOptions.types.push(\"node\");\n    }\n  }\n\n  return tsconfigJson;\n}\n\nexport async function initializeTsconfig<\n  TResolvedConfig extends ResolvedConfig = ResolvedConfig,\n  TContext extends EnvironmentContext<TResolvedConfig> =\n    EnvironmentContext<TResolvedConfig>\n>(context: TContext): Promise<void> {\n  context.debug(\n    \"Initializing TypeScript configuration (tsconfig.json) for the Powerlines project.\"\n  );\n\n  if (!isPackageExists(\"typescript\")) {\n    throw new Error(\n      'The TypeScript package is not installed. Please install the package using the command: \"npm install typescript --save-dev\"'\n    );\n  }\n\n  const tsconfigFilePath = getTsconfigFilePath(\n    context.workspaceConfig.workspaceRoot,\n    context.config.root,\n    context.config.tsconfig\n  );\n\n  context.tsconfig.originalTsconfigJson =\n    await readJsonFile<TsConfigJson>(tsconfigFilePath);\n\n  context.tsconfig.tsconfigJson =\n    await resolveTsconfigChanges<TResolvedConfig>(context);\n\n  context.debug(\n    \"Writing updated TypeScript configuration (tsconfig.json) file to disk.\"\n  );\n\n  await context.fs.write(\n    tsconfigFilePath,\n    StormJSON.stringify(context.tsconfig.tsconfigJson)\n  );\n\n  context.tsconfig = getParsedTypeScriptConfig(\n    context.workspaceConfig.workspaceRoot,\n    context.config.root,\n    context.config.tsconfig,\n    context.config.tsconfigRaw,\n    context.tsconfig.originalTsconfigJson\n  );\n}\n\nexport async function resolveTsconfig<\n  TResolvedConfig extends ResolvedConfig = ResolvedConfig,\n  TContext extends EnvironmentContext<TResolvedConfig> =\n    EnvironmentContext<TResolvedConfig>\n>(context: TContext): Promise<void> {\n  const updateTsconfigJson = await readJsonFile<TsConfigJson>(\n    context.tsconfig.tsconfigFilePath\n  );\n  if (\n    updateTsconfigJson?.compilerOptions?.types &&\n    Array.isArray(updateTsconfigJson.compilerOptions.types) &&\n    !updateTsconfigJson.compilerOptions.types.length\n  ) {\n    // If the types array is empty, we can safely remove it\n    delete updateTsconfigJson.compilerOptions.types;\n  }\n\n  const result = getObjectDiff(\n    context.tsconfig.originalTsconfigJson as NonNullable<ObjectData>,\n    updateTsconfigJson as ObjectData,\n    {\n      ignoreArrayOrder: true,\n      showOnly: {\n        statuses: [\"added\", \"deleted\", \"updated\"],\n        granularity: \"deep\"\n      }\n    }\n  );\n\n  const changes = [] as {\n    field: string;\n    status: \"added\" | \"deleted\" | \"updated\";\n    previous: string;\n    current: string;\n  }[];\n  const getChanges = (difference: Diff, property?: string) => {\n    if (\n      difference.status === \"added\" ||\n      difference.status === \"deleted\" ||\n      difference.status === \"updated\"\n    ) {\n      if (difference.diff) {\n        for (const diff of difference.diff) {\n          getChanges(\n            diff,\n            property\n              ? `${property}.${difference.property}`\n              : difference.property\n          );\n        }\n      } else {\n        changes.push({\n          field: property\n            ? `${property}.${difference.property}`\n            : difference.property,\n          status: difference.status,\n          previous:\n            difference.status === \"added\"\n              ? \"---\"\n              : StormJSON.stringify(difference.previousValue),\n          current:\n            difference.status === \"deleted\"\n              ? \"---\"\n              : StormJSON.stringify(difference.currentValue)\n        });\n      }\n    }\n  };\n\n  for (const diff of result.diff) {\n    getChanges(diff);\n  }\n\n  if (changes.length > 0) {\n    context.warn(\n      `Updating the following configuration values in \"${context.tsconfig.tsconfigFilePath}\" file:\n\n    ${changes\n      .map(\n        (change, i) => `${chalk.bold.whiteBright(\n          `${i + 1}. ${titleCase(change.status)} the ${change.field} field: `\n        )}\n    ${chalk.red(` - Previous: ${change.previous} `)}\n    ${chalk.green(` - Updated: ${change.current} `)}\n  `\n      )\n      .join(\"\\n\")}\n    `\n    );\n  }\n\n  await context.fs.write(\n    context.tsconfig.tsconfigFilePath,\n    StormJSON.stringify(updateTsconfigJson)\n  );\n\n  context.tsconfig = getParsedTypeScriptConfig(\n    context.workspaceConfig.workspaceRoot,\n    context.config.root,\n    context.config.tsconfig\n  );\n  if (!context.tsconfig) {\n    throw new Error(\"Failed to parse the TypeScript configuration file.\");\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 { Unstable_APIContext } from \"@powerlines/core/types/_internal\";\nimport { formatLogMessage } from \"@storm-software/config-tools/logger/console\";\nimport { toArray } from \"@stryke/convert/to-array\";\nimport { copyFiles } from \"@stryke/fs/copy-file\";\nimport { existsSync } from \"@stryke/fs/exists\";\nimport { createDirectory, removeDirectory } from \"@stryke/fs/helpers\";\nimport { install } from \"@stryke/fs/install\";\nimport { listFiles } from \"@stryke/fs/list-files\";\nimport { isPackageExists } from \"@stryke/fs/package-fns\";\nimport { resolvePackage } from \"@stryke/fs/resolve\";\nimport { getUnique } from \"@stryke/helpers/get-unique\";\nimport { omit } from \"@stryke/helpers/omit\";\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 { titleCase } from \"@stryke/string-format/title-case\";\nimport { isError } from \"@stryke/type-checks/is-error\";\nimport { isFunction } from \"@stryke/type-checks/is-function\";\nimport { isNumber } from \"@stryke/type-checks/is-number\";\nimport { isObject } from \"@stryke/type-checks/is-object\";\nimport { isPromiseLike } from \"@stryke/type-checks/is-promise\";\nimport { isSet } from \"@stryke/type-checks/is-set\";\nimport { isSetObject } from \"@stryke/type-checks/is-set-object\";\nimport { isSetString } from \"@stryke/type-checks/is-set-string\";\nimport { isString } from \"@stryke/type-checks/is-string\";\nimport { MaybePromise, PartialKeys, RequiredKeys } from \"@stryke/types/base\";\nimport chalk from \"chalk\";\nimport defu from \"defu\";\nimport Handlebars from \"handlebars\";\nimport packageJson from \"../package.json\" assert { type: \"json\" };\nimport {\n  emitBuiltinTypes,\n  formatTypes\n} from \"./_internal/helpers/generate-types\";\nimport { callHook, mergeConfigs } from \"./_internal/helpers/hooks\";\nimport { installDependencies } from \"./_internal/helpers/install-dependencies\";\nimport { writeMetaFile } from \"./_internal/helpers/meta\";\nimport {\n  initializeTsconfig,\n  resolveTsconfig\n} from \"./_internal/helpers/resolve-tsconfig\";\nimport { PowerlinesAPIContext } from \"./context/api-context\";\nimport {\n  checkDedupe,\n  findInvalidPluginConfig,\n  isPlugin,\n  isPluginConfig,\n  isPluginConfigObject,\n  isPluginConfigTuple\n} from \"./plugin-utils\";\nimport type {\n  API,\n  APIContext,\n  BuildInlineConfig,\n  CallHookOptions,\n  CleanInlineConfig,\n  DeployInlineConfig,\n  DocsInlineConfig,\n  EnvironmentContext,\n  EnvironmentResolvedConfig,\n  InferHookParameters,\n  InitialUserConfig,\n  LintInlineConfig,\n  NewInlineConfig,\n  Plugin,\n  PluginConfig,\n  PluginConfigObject,\n  PluginConfigTuple,\n  PluginContext,\n  PluginFactory,\n  PrepareInlineConfig,\n  ResolvedConfig,\n  TypesInlineConfig,\n  TypesResult\n} from \"./types\";\nimport {\n  colorText,\n  format,\n  formatFolder,\n  getTypescriptFileHeader\n} from \"./utils\";\n\n/**\n * The Powerlines API class\n *\n * @remarks\n * This class is responsible for managing the Powerlines project lifecycle, including initialization, building, and finalization.\n *\n * @public\n */\nexport class PowerlinesAPI<\n  TResolvedConfig extends ResolvedConfig = ResolvedConfig\n>\n  implements API<TResolvedConfig>, AsyncDisposable\n{\n  /**\n   * The Powerlines context\n   */\n  #context: Unstable_APIContext<TResolvedConfig>;\n\n  /**\n   * The Powerlines context\n   */\n  public get context(): APIContext<TResolvedConfig> {\n    return this.#context;\n  }\n\n  /**\n   * Create a new Powerlines API instance\n   *\n   * @param context - The Powerlines context\n   */\n  private constructor(context: APIContext<TResolvedConfig>) {\n    this.#context = context as Unstable_APIContext<TResolvedConfig>;\n  }\n\n  /**\n   * Initialize a Powerlines API instance\n   *\n   * @param workspaceRoot - The directory of the underlying workspace the Powerlines project exists in\n   * @param config - An object containing the configuration required to run Powerlines tasks.\n   * @returns A new instance of the Powerlines API\n   */\n  public static async from<\n    TResolvedConfig extends ResolvedConfig = ResolvedConfig\n  >(\n    workspaceRoot: string,\n    config: InitialUserConfig<TResolvedConfig[\"userConfig\"]>\n  ): Promise<PowerlinesAPI<TResolvedConfig>> {\n    const api = new PowerlinesAPI<TResolvedConfig>(\n      await PowerlinesAPIContext.from(workspaceRoot, config)\n    );\n    api.#context.$$internal = {\n      api,\n      addPlugin: api.#addPlugin.bind(api)\n    };\n\n    api.context.info(\n      `🔌 The Powerlines Engine v${packageJson.version} has started`\n    );\n\n    for (const plugin of api.context.config.plugins.flat(10) ?? []) {\n      await api.#addPlugin(plugin);\n    }\n\n    if (api.context.plugins.length === 0) {\n      api.context.warn(\n        \"No Powerlines plugins were specified in the options. Please ensure this is correct, as it is generally not recommended.\"\n      );\n    } else {\n      api.context.info(\n        `🔌 Loaded ${api.context.plugins.length} ${titleCase(\n          api.context.config.framework\n        )} plugin${api.context.plugins.length > 1 ? \"s\" : \"\"}: \\n\\n${api.context.plugins\n          .map((plugin, index) => ` ${index + 1}. ${colorText(plugin.name)}`)\n          .join(\"\\n\")}`\n      );\n    }\n\n    const pluginConfig = await api.callHook(\"config\", {\n      environment: await api.context.getEnvironment(),\n      sequential: true,\n      result: \"merge\",\n      merge: mergeConfigs\n    });\n    await api.context.withUserConfig(\n      pluginConfig as TResolvedConfig[\"userConfig\"],\n      { isHighPriority: false }\n    );\n\n    return api;\n  }\n\n  /**\n   * Generate the Powerlines typescript declaration file\n   *\n   * @remarks\n   * This method will only generate the typescript declaration file for the Powerlines project. It is generally recommended to run the full `prepare` command, which will run this method as part of its process.\n   *\n   * @param inlineConfig - The inline configuration for the types command\n   */\n  public async types(\n    inlineConfig: PartialKeys<TypesInlineConfig, \"command\"> = {\n      command: \"types\"\n    }\n  ) {\n    this.context.info(\n      \" 🏗️  Generating typescript declarations for the Powerlines project\"\n    );\n\n    this.context.debug(\n      \" Aggregating configuration options for the Powerlines project\"\n    );\n\n    inlineConfig.command ??= \"types\";\n\n    await this.context.withInlineConfig(\n      inlineConfig as RequiredKeys<TypesInlineConfig, \"command\">\n    );\n    await this.#executeEnvironments(async context => {\n      context.debug(\n        `Initializing the processing options for the Powerlines project.`\n      );\n\n      await this.callHook(\"configResolved\", {\n        environment: context,\n        order: \"pre\"\n      });\n\n      await initializeTsconfig<TResolvedConfig>(context);\n\n      await this.callHook(\"configResolved\", {\n        environment: context,\n        order: \"normal\"\n      });\n\n      if (context.entry.length > 0) {\n        context.debug(\n          `The configuration provided ${\n            isObject(context.config.input)\n              ? Object.keys(context.config.input).length\n              : toArray(context.config.input).length\n          } entry point(s), Powerlines has found ${\n            context.entry.length\n          } entry files(s) for the ${context.config.title} project${\n            context.entry.length > 0 && context.entry.length < 10\n              ? `: \\n${context.entry\n                  .map(\n                    entry =>\n                      `- ${entry.file}${\n                        entry.output ? ` -> ${entry.output}` : \"\"\n                      }`\n                  )\n                  .join(\" \\n\")}`\n              : \"\"\n          }`\n        );\n      } else {\n        context.warn(\n          `No entry files were found for the ${\n            context.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>(context);\n      await installDependencies(context);\n\n      await this.callHook(\"configResolved\", {\n        environment: context,\n        order: \"post\"\n      });\n\n      context.trace(\n        `Powerlines configuration has been resolved: \\n\\n${formatLogMessage({\n          ...context.config,\n          userConfig: isSetObject(context.config.userConfig)\n            ? omit(context.config.userConfig, [\"plugins\"])\n            : undefined,\n          inlineConfig: isSetObject(context.config.inlineConfig)\n            ? omit(context.config.inlineConfig, [\"plugins\"])\n            : undefined,\n          plugins: context.plugins.map(plugin => plugin.plugin.name)\n        })}`\n      );\n\n      if (!context.fs.existsSync(context.cachePath)) {\n        await createDirectory(context.cachePath);\n      }\n\n      if (!context.fs.existsSync(context.dataPath)) {\n        await createDirectory(context.dataPath);\n      }\n\n      if (\n        context.config.skipCache === true ||\n        context.persistedMeta?.checksum !== context.meta.checksum\n      ) {\n        context.debug(\n          `Using previously prepared files as the meta checksum has not changed.`\n        );\n      } else {\n        context.info(\n          `Running \\`prepare\\` command as the meta checksum has changed since the last run.`\n        );\n\n        await this.prepare(\n          defu(\n            {\n              output: {\n                types: false\n              }\n            },\n            inlineConfig\n          ) as PrepareInlineConfig<TResolvedConfig>\n        );\n      }\n\n      await this.#types(context);\n\n      this.context.debug(\"Formatting files generated during the types step.\");\n\n      await format(\n        context,\n        context.typesPath,\n        (await context.fs.read(context.typesPath)) ?? \"\"\n      );\n\n      await writeMetaFile(context);\n      context.persistedMeta = context.meta;\n    });\n\n    this.context.debug(\n      \"✔ Powerlines types generation has completed successfully\"\n    );\n  }\n\n  /**\n   * Prepare the Powerlines API\n   *\n   * @remarks\n   * This method will prepare the Powerlines API for use, initializing any necessary resources.\n   *\n   * @param inlineConfig - The inline configuration for the prepare command\n   */\n  public async prepare(\n    inlineConfig:\n      | PartialKeys<PrepareInlineConfig, \"command\">\n      | PartialKeys<TypesInlineConfig, \"command\">\n      | PartialKeys<NewInlineConfig, \"command\">\n      | PartialKeys<CleanInlineConfig, \"command\">\n      | PartialKeys<BuildInlineConfig, \"command\">\n      | PartialKeys<LintInlineConfig, \"command\">\n      | PartialKeys<DocsInlineConfig, \"command\">\n      | PartialKeys<DeployInlineConfig, \"command\"> = { command: \"prepare\" }\n  ) {\n    this.context.info(\" 🏗️  Preparing the Powerlines project\");\n\n    this.context.debug(\n      \" Aggregating configuration options for the Powerlines project\"\n    );\n\n    inlineConfig.command ??= \"prepare\";\n\n    await this.context.withInlineConfig(\n      inlineConfig as RequiredKeys<PrepareInlineConfig, \"command\">\n    );\n    await this.#executeEnvironments(async context => {\n      context.debug(\n        `Initializing the processing options for the Powerlines project.`\n      );\n\n      await this.callHook(\"configResolved\", {\n        environment: context,\n        order: \"pre\"\n      });\n\n      await initializeTsconfig<TResolvedConfig>(context);\n\n      await this.callHook(\"configResolved\", {\n        environment: context,\n        order: \"normal\"\n      });\n\n      if (context.entry.length > 0) {\n        context.debug(\n          `The configuration provided ${\n            isObject(context.config.input)\n              ? Object.keys(context.config.input).length\n              : toArray(context.config.input).length\n          } entry point(s), Powerlines has found ${\n            context.entry.length\n          } entry files(s) for the ${context.config.title} project${\n            context.entry.length > 0 && context.entry.length < 10\n              ? `: \\n${context.entry\n                  .map(\n                    entry =>\n                      `- ${entry.file}${\n                        entry.output ? ` -> ${entry.output}` : \"\"\n                      }`\n                  )\n                  .join(\" \\n\")}`\n              : \"\"\n          }`\n        );\n      } else {\n        context.warn(\n          `No entry files were found for the ${\n            context.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>(context);\n      await installDependencies(context);\n\n      await this.callHook(\"configResolved\", {\n        environment: context,\n        order: \"post\"\n      });\n\n      context.trace(\n        `Powerlines configuration has been resolved: \\n\\n${formatLogMessage({\n          ...context.config,\n          userConfig: isSetObject(context.config.userConfig)\n            ? omit(context.config.userConfig, [\"plugins\"])\n            : undefined,\n          inlineConfig: isSetObject(context.config.inlineConfig)\n            ? omit(context.config.inlineConfig, [\"plugins\"])\n            : undefined,\n          plugins: context.plugins.map(plugin => plugin.plugin.name)\n        })}`\n      );\n\n      if (!context.fs.existsSync(context.cachePath)) {\n        await createDirectory(context.cachePath);\n      }\n\n      if (!context.fs.existsSync(context.dataPath)) {\n        await createDirectory(context.dataPath);\n      }\n\n      await this.callHook(\"prepare\", {\n        environment: context,\n        order: \"pre\"\n      });\n      await this.callHook(\"prepare\", {\n        environment: context,\n        order: \"normal\"\n      });\n\n      await this.callHook(\"prepare\", {\n        environment: context,\n        order: \"post\"\n      });\n\n      if (context.config.output.types !== false) {\n        await this.#types(context);\n      }\n\n      this.context.debug(\"Formatting files generated during the prepare step.\");\n\n      await Promise.all([\n        formatFolder(context, context.builtinsPath),\n        formatFolder(context, context.entryPath)\n      ]);\n\n      await writeMetaFile(context);\n      context.persistedMeta = context.meta;\n    });\n\n    this.context.debug(\"✔ Powerlines preparation has completed successfully\");\n  }\n\n  /**\n   * Create a new Powerlines project\n   *\n   * @remarks\n   * This method will create a new Powerlines project in the current directory.\n   *\n   * @param inlineConfig - The inline configuration for the new command\n   * @returns A promise that resolves when the project has been created\n   */\n  public async new(inlineConfig: PartialKeys<NewInlineConfig, \"command\">) {\n    this.context.info(\" 🆕 Creating a new Powerlines project\");\n\n    inlineConfig.command ??= \"new\";\n\n    await this.prepare(\n      inlineConfig as RequiredKeys<NewInlineConfig, \"command\">\n    );\n    await this.#executeEnvironments(async context => {\n      context.debug(\n        \"Initializing the processing options for the Powerlines project.\"\n      );\n\n      await this.callHook(\"new\", {\n        environment: context,\n        order: \"pre\"\n      });\n\n      const files = await listFiles(\n        joinPaths(context.powerlinesPath, \"files/common/**/*.hbs\")\n      );\n      for (const file of files) {\n        context.trace(`Adding template file to project: ${file}`);\n\n        const template = Handlebars.compile(file);\n        await context.fs.write(\n          joinPaths(context.config.root, file.replace(\".hbs\", \"\")),\n          template(context)\n        );\n      }\n\n      await this.callHook(\"new\", {\n        environment: context,\n        order: \"normal\"\n      });\n\n      if (context.config.projectType === \"application\") {\n        const files = await listFiles(\n          joinPaths(context.powerlinesPath, \"files/application/**/*.hbs\")\n        );\n        for (const file of files) {\n          context.trace(`Adding application template file: ${file}`);\n\n          const template = Handlebars.compile(file);\n          await context.fs.write(\n            joinPaths(context.config.root, file.replace(\".hbs\", \"\")),\n            template(context)\n          );\n        }\n      } else {\n        const files = await listFiles(\n          joinPaths(context.powerlinesPath, \"files/library/**/*.hbs\")\n        );\n        for (const file of files) {\n          context.trace(`Adding library template file: ${file}`);\n\n          const template = Handlebars.compile(file);\n          await context.fs.write(\n            joinPaths(context.config.root, file.replace(\".hbs\", \"\")),\n            template(context)\n          );\n        }\n      }\n\n      await this.callHook(\"new\", {\n        environment: context,\n        order: \"post\"\n      });\n    });\n\n    this.context.debug(\"✔ Powerlines new command completed successfully\");\n  }\n\n  /**\n   * Clean any previously prepared artifacts\n   *\n   * @remarks\n   * This method will remove the previous Powerlines artifacts from the project.\n   *\n   * @param inlineConfig - The inline configuration for the clean command\n   * @returns A promise that resolves when the clean command has completed\n   */\n  public async clean(\n    inlineConfig:\n      | PartialKeys<CleanInlineConfig, \"command\">\n      | PartialKeys<PrepareInlineConfig, \"command\"> = {\n      command: \"clean\"\n    }\n  ) {\n    this.context.info(\" 🧹 Cleaning the previous Powerlines artifacts\");\n\n    inlineConfig.command ??= \"clean\";\n\n    await this.prepare(\n      inlineConfig as RequiredKeys<CleanInlineConfig, \"command\">\n    );\n    await this.#executeEnvironments(async context => {\n      context.debug(\"Cleaning the project's dist and artifacts directories.\");\n\n      await context.fs.remove(\n        joinPaths(\n          context.workspaceConfig.workspaceRoot,\n          context.config.output.path\n        )\n      );\n      await context.fs.remove(\n        joinPaths(\n          context.workspaceConfig.workspaceRoot,\n          context.config.root,\n          context.config.output.artifactsPath\n        )\n      );\n\n      await this.callHook(\"clean\", {\n        environment: context,\n        sequential: false\n      });\n    });\n\n    this.context.debug(\"✔ Powerlines cleaning completed successfully\");\n  }\n\n  /**\n   * Lint the project\n   *\n   * @param inlineConfig - The inline configuration for the lint command\n   * @returns A promise that resolves when the lint command has completed\n   */\n  public async lint(\n    inlineConfig:\n      | PartialKeys<LintInlineConfig, \"command\">\n      | PartialKeys<BuildInlineConfig, \"command\"> = { command: \"lint\" }\n  ) {\n    this.context.info(\" 📝 Linting the Powerlines project\");\n\n    inlineConfig.command ??= \"lint\";\n    await this.prepare(\n      inlineConfig as RequiredKeys<LintInlineConfig, \"command\">\n    );\n    await this.#executeEnvironments(async context => {\n      await this.callHook(\"lint\", {\n        environment: context,\n        sequential: false\n      });\n    });\n\n    this.context.debug(\"✔ Powerlines linting completed successfully\");\n  }\n\n  /**\n   * Build the project\n   *\n   * @remarks\n   * This method will build the Powerlines project, generating the necessary artifacts.\n   *\n   * @param inlineConfig - The inline configuration for the build command\n   * @returns A promise that resolves when the build command has completed\n   */\n  public async build(\n    inlineConfig: PartialKeys<BuildInlineConfig, \"command\"> = {\n      command: \"build\"\n    }\n  ) {\n    this.context.info(\" 📦  Building the Powerlines project\");\n\n    await this.context.generateChecksum();\n    if (\n      this.context.meta.checksum !== this.context.persistedMeta?.checksum ||\n      this.context.config.skipCache\n    ) {\n      this.context.info(\n        !this.context.persistedMeta?.checksum\n          ? \"No previous build cache found. Preparing the project for the initial build.\"\n          : this.context.meta.checksum !== this.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      inlineConfig.command ??= \"build\";\n\n      await this.prepare(\n        inlineConfig as RequiredKeys<BuildInlineConfig, \"command\">\n      );\n    }\n\n    if (this.context.config.singleBuild) {\n      await this.#handleBuild(await this.#context.toEnvironment());\n    } else {\n      await this.#executeEnvironments(async context => {\n        await this.#handleBuild(context);\n      });\n    }\n\n    this.context.debug(\"✔ Powerlines build completed successfully\");\n  }\n\n  /**\n   * Prepare the documentation for the project\n   *\n   * @param inlineConfig - The inline configuration for the docs command\n   * @returns A promise that resolves when the documentation generation has completed\n   */\n  public async docs(inlineConfig: DocsInlineConfig = { command: \"docs\" }) {\n    this.context.info(\n      \" 📓 Generating documentation for the Powerlines project\"\n    );\n\n    inlineConfig.command ??= \"docs\";\n    await this.prepare(\n      inlineConfig as RequiredKeys<DocsInlineConfig, \"command\">\n    );\n    await this.#executeEnvironments(async context => {\n      context.debug(\n        \"Writing documentation for the Powerlines project artifacts.\"\n      );\n\n      inlineConfig.command ??= \"docs\";\n\n      await this.prepare(\n        inlineConfig as RequiredKeys<DocsInlineConfig, \"command\">\n      );\n      await this.#executeEnvironments(async context => {\n        await this.callHook(\"docs\", {\n          environment: context\n        });\n      });\n    });\n\n    this.context.debug(\n      \"✔ Powerlines documentation generation completed successfully\"\n    );\n  }\n\n  /**\n   * Deploy the project source code\n   *\n   * @remarks\n   * This method will prepare and build the Powerlines project, generating the necessary artifacts for the deployment.\n   *\n   * @param inlineConfig - The inline configuration for the deploy command\n   */\n  public async deploy(\n    inlineConfig: PartialKeys<DeployInlineConfig, \"command\"> = {\n      command: \"deploy\"\n    }\n  ) {\n    this.context.info(\" 🚀 Deploying the Powerlines project\");\n\n    inlineConfig.command ??= \"deploy\";\n\n    await this.prepare(\n      inlineConfig as RequiredKeys<DeployInlineConfig, \"command\">\n    );\n    await this.#executeEnvironments(async context => {\n      await this.callHook(\"deploy\", { environment: context });\n    });\n\n    this.context.debug(\"✔ Powerlines deploy completed successfully\");\n  }\n\n  /**\n   * Finalization process\n   *\n   * @remarks\n   * This step includes any final processes or clean up required by Powerlines. It will be run after each Powerlines command.\n   *\n   * @returns A promise that resolves when the finalization process has completed\n   */\n  public async finalize() {\n    this.context.info(\" 🏁 Powerlines finalization processes started\");\n\n    await this.#executeEnvironments(async context => {\n      await this.callHook(\"finalize\", { environment: context });\n      await context.fs.dispose();\n\n      if (\n        existsSync(context.cachePath) &&\n        !(await listFiles(joinPaths(context.cachePath, \"**/*\")))?.length\n      ) {\n        await removeDirectory(context.cachePath);\n      }\n    });\n\n    this.context.debug(\"✔ Powerlines finalization completed successfully\");\n  }\n\n  /**\n   * Invokes the configured plugin hooks\n   *\n   * @remarks\n   * By default, it will call the `\"pre\"`, `\"normal\"`, and `\"post\"` ordered hooks in sequence\n   *\n   * @param hook - The hook to call\n   * @param options - The options to provide to the hook\n   * @param args - The arguments to pass to the hook\n   * @returns The result of the hook call\n   */\n  public async callHook<TKey extends string>(\n    hook: TKey,\n    options: CallHookOptions & {\n      environment?: string | EnvironmentContext<TResolvedConfig>;\n    },\n    ...args: InferHookParameters<PluginContext<TResolvedConfig>, TKey>\n  ) {\n    return callHook<TResolvedConfig, TKey>(\n      isSetObject(options?.environment)\n        ? options.environment\n        : await this.#context.getEnvironment(options?.environment),\n      hook,\n      { sequential: true, ...options },\n      ...args\n    );\n  }\n\n  /**\n   * Dispose of the Powerlines API instance\n   *\n   * @remarks\n   * This method will finalize the Powerlines API instance, cleaning up any resources used.\n   */\n  public async [Symbol.asyncDispose]() {\n    await this.finalize();\n  }\n\n  async #handleBuild(context: EnvironmentContext<TResolvedConfig>) {\n    await this.callHook(\"build\", {\n      environment: context,\n      order: \"pre\"\n    });\n\n    context.debug(\n      \"Formatting the generated entry files before the build process starts.\"\n    );\n    await formatFolder(context, context.entryPath);\n\n    await this.callHook(\"build\", {\n      environment: context,\n      order: \"normal\"\n    });\n\n    if (context.config.output.copy) {\n      context.debug(\"Copying project's files from build output directory.\");\n\n      const destinationPath = isParentPath(\n        appendPath(\n          context.config.output.path,\n          context.workspaceConfig.workspaceRoot\n        ),\n        appendPath(context.config.root, context.workspaceConfig.workspaceRoot)\n      )\n        ? joinPaths(\n            context.config.output.copy.path,\n            relativePath(\n              appendPath(\n                context.config.root,\n                context.workspaceConfig.workspaceRoot\n              ),\n              appendPath(\n                context.config.output.path,\n                context.workspaceConfig.workspaceRoot\n              )\n            )\n          )\n        : joinPaths(context.config.output.copy.path, \"dist\");\n      const sourcePath = appendPath(\n        context.config.output.path,\n        context.workspaceConfig.workspaceRoot\n      );\n\n      if (existsSync(sourcePath) && sourcePath !== destinationPath) {\n        context.debug(\n          `Copying files from project's build output directory (${\n            context.config.output.path\n          }) to the project's copy/publish directory (${destinationPath}).`\n        );\n\n        await copyFiles(sourcePath, destinationPath);\n      } else {\n        context.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        context.config.output.copy.assets &&\n        Array.isArray(context.config.output.copy.assets)\n      ) {\n        await Promise.all(\n          context.config.output.copy.assets.map(async asset => {\n            context.trace(\n              `Copying asset(s): ${chalk.redBright(\n                context.workspaceConfig.workspaceRoot === asset.input\n                  ? asset.glob\n                  : appendPath(\n                      asset.glob,\n                      replacePath(\n                        asset.input,\n                        context.workspaceConfig.workspaceRoot\n                      )\n                    )\n              )} -> ${chalk.greenBright(\n                appendPath(\n                  asset.glob,\n                  replacePath(\n                    asset.output,\n                    context.workspaceConfig.workspaceRoot\n                  )\n                )\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 context.fs.copy(asset, asset.output);\n          })\n        );\n      }\n    } else {\n      context.debug(\n        \"No copy configuration found for the project output. Skipping the copying of build output files.\"\n      );\n    }\n\n    await this.callHook(\"build\", {\n      environment: context,\n      order: \"post\"\n    });\n  }\n\n  /**\n   * Get the configured environments\n   *\n   * @returns The configured environments\n   */\n  async #getEnvironments() {\n    if (\n      !this.context.config.environments ||\n      Object.keys(this.context.config.environments).length <= 1\n    ) {\n      this.context.debug(\n        \"No environments are configured for this Powerlines project. Using the default environment.\"\n      );\n\n      return [await this.context.getEnvironment()];\n    }\n\n    this.context.debug(\n      `Found ${Object.keys(this.context.config.environments).length} configured environment(s) for this Powerlines project.`\n    );\n\n    return (\n      await Promise.all(\n        Object.entries(this.context.config.environments).map(\n          async ([name, config]) => {\n            const environment = await this.context.getEnvironmentSafe(name);\n            if (!environment) {\n              const resolvedEnvironment = await this.callHook(\n                \"configEnvironment\",\n                {\n                  environment: name\n                },\n                name,\n                config\n              );\n\n              if (resolvedEnvironment) {\n                this.context.environments[name] = await this.context.in(\n                  resolvedEnvironment as EnvironmentResolvedConfig\n                );\n              }\n            }\n\n            return this.context.environments[name];\n          }\n        )\n      )\n    ).filter(context => isSet(context));\n  }\n\n  /**\n   * Execute a handler function for each environment\n   *\n   * @param handle - The handler function to execute for each environment\n   */\n  async #executeEnvironments(\n    handle: (context: EnvironmentContext<TResolvedConfig>) => MaybePromise<void>\n  ) {\n    await Promise.all(\n      (await this.#getEnvironments()).map(async context => {\n        return Promise.resolve(handle(context));\n      })\n    );\n  }\n\n  /**\n   * Add a Powerlines plugin used in the build process\n   *\n   * @param config - The import path of the plugin to add\n   */\n  async #addPlugin(config: PluginConfig<PluginContext<TResolvedConfig>>) {\n    if (config) {\n      const result = await this.#initPlugin(config);\n      if (!result) {\n        return;\n      }\n\n      for (const plugin of result) {\n        this.context.debug(\n          `Successfully initialized the ${chalk.bold.cyanBright(\n            plugin.name\n          )} plugin`\n        );\n\n        await this.context.addPlugin(plugin);\n      }\n    }\n  }\n\n  /**\n   * Initialize a Powerlines plugin\n   *\n   * @param config - The configuration for the plugin\n   * @returns The initialized plugin instance, or null if the plugin was a duplicate\n   * @throws Will throw an error if the plugin cannot be found or is invalid\n   */\n  async #initPlugin(\n    config: PluginConfig<PluginContext<TResolvedConfig>>\n  ): Promise<Plugin<PluginContext<TResolvedConfig>>[] | null> {\n    let awaited = config;\n    if (isPromiseLike(config)) {\n      awaited = (await Promise.resolve(config as Promise<any>)) as PluginConfig<\n        PluginContext<TResolvedConfig>\n      >;\n    }\n\n    if (!isPluginConfig<PluginContext<TResolvedConfig>>(awaited)) {\n      const invalid = findInvalidPluginConfig(awaited);\n\n      throw new Error(\n        `Invalid ${\n          invalid && invalid.length > 1 ? \"plugins\" : \"plugin\"\n        } specified in the configuration - ${\n          invalid && invalid.length > 0\n            ? JSON.stringify(awaited)\n            : invalid?.join(\"\\n\\n\")\n        } \\n\\nPlease ensure the value is one of the following: \\n - an instance of \\`Plugin\\` \\n - a plugin name \\n - an object with the \\`plugin\\` and \\`options\\` properties \\n - a tuple array with the plugin and options \\n - a factory function that returns a plugin or array of plugins \\n - an array of plugins or plugin configurations`\n      );\n    }\n\n    let plugins!: Plugin<PluginContext<TResolvedConfig>>[];\n    if (isPlugin<PluginContext<TResolvedConfig>>(awaited)) {\n      plugins = [awaited];\n    } else if (isFunction(awaited)) {\n      plugins = toArray(await Promise.resolve(awaited()));\n    } else if (isString(awaited)) {\n      const resolved = await this.#resolvePlugin(awaited);\n      if (isFunction(resolved)) {\n        plugins = toArray(await Promise.resolve(resolved()));\n      } else {\n        plugins = toArray(resolved);\n      }\n    } else if (\n      Array.isArray(awaited) &&\n      (awaited as PluginContext<TResolvedConfig>[]).every(\n        isPlugin<PluginContext<TResolvedConfig>>\n      )\n    ) {\n      plugins = awaited as Plugin<PluginContext<TResolvedConfig>>[];\n    } else if (\n      Array.isArray(awaited) &&\n      (awaited as PluginConfig<PluginContext<TResolvedConfig>>[]).every(\n        isPluginConfig<PluginContext<TResolvedConfig>>\n      )\n    ) {\n      plugins = [];\n      for (const pluginConfig of awaited as PluginConfig<\n        PluginContext<TResolvedConfig>\n      >[]) {\n        const initialized = await this.#initPlugin(pluginConfig);\n        if (initialized) {\n          plugins.push(...initialized);\n        }\n      }\n    } else if (\n      isPluginConfigTuple<PluginContext<TResolvedConfig>>(awaited) ||\n      isPluginConfigObject<PluginContext<TResolvedConfig>>(awaited)\n    ) {\n      let pluginConfig!:\n        | string\n        | PluginFactory<PluginContext<TResolvedConfig>>\n        | Plugin<PluginContext<TResolvedConfig>>;\n      let pluginOptions: any;\n\n      if (isPluginConfigTuple<PluginContext<TResolvedConfig>>(awaited)) {\n        pluginConfig = awaited[0] as Plugin<PluginContext<TResolvedConfig>>;\n        pluginOptions =\n          (awaited as PluginConfigTuple)?.length === 2 ? awaited[1] : undefined;\n      } else {\n        pluginConfig = (awaited as PluginConfigObject).plugin as Plugin<\n          PluginContext<TResolvedConfig>\n        >;\n        pluginOptions = (awaited as PluginConfigObject).options;\n      }\n\n      if (isSetString(pluginConfig)) {\n        const resolved = await this.#resolvePlugin(pluginConfig);\n        if (isFunction(resolved)) {\n          plugins = toArray(\n            await Promise.resolve(\n              pluginOptions ? resolved(pluginOptions) : resolved()\n            )\n          );\n        } else {\n          plugins = toArray(resolved);\n        }\n      } else if (isFunction(pluginConfig)) {\n        plugins = toArray(await Promise.resolve(pluginConfig(pluginOptions)));\n      } else if (\n        Array.isArray(pluginConfig) &&\n        pluginConfig.every(isPlugin<PluginContext<TResolvedConfig>>)\n      ) {\n        plugins = pluginConfig;\n      } else if (isPlugin<PluginContext<TResolvedConfig>>(pluginConfig)) {\n        plugins = toArray(pluginConfig);\n      }\n    }\n\n    if (!plugins) {\n      throw new Error(\n        `The plugin configuration ${JSON.stringify(awaited)} is invalid. This configuration must point to a valid Powerlines plugin module.`\n      );\n    }\n\n    if (\n      plugins.length > 0 &&\n      !plugins.every(isPlugin<PluginContext<TResolvedConfig>>)\n    ) {\n      throw new Error(\n        `The plugin option ${JSON.stringify(plugins)} does not export a valid module. This configuration must point to a valid Powerlines plugin module.`\n      );\n    }\n\n    const result = [] as Plugin<PluginContext<TResolvedConfig>>[];\n    for (const plugin of plugins) {\n      if (checkDedupe<TResolvedConfig>(plugin, this.context.plugins)) {\n        this.context.trace(\n          `Duplicate ${chalk.bold.cyanBright(\n            plugin.name\n          )} plugin dependency detected - Skipping initialization.`\n        );\n      } else {\n        result.push(plugin);\n\n        this.context.trace(\n          `Initializing the ${chalk.bold.cyanBright(plugin.name)} plugin...`\n        );\n      }\n    }\n\n    return result;\n  }\n\n  async #resolvePlugin<TOptions>(\n    pluginPath: string\n  ): Promise<\n    | Plugin<PluginContext<TResolvedConfig>>\n    | Plugin<PluginContext<TResolvedConfig>>[]\n    | ((\n        options?: TOptions\n      ) => MaybePromise<\n        | Plugin<PluginContext<TResolvedConfig>>\n        | Plugin<PluginContext<TResolvedConfig>>[]\n      >)\n  > {\n    if (\n      pluginPath.startsWith(\"@\") &&\n      pluginPath.split(\"/\").filter(Boolean).length > 2\n    ) {\n      const splits = pluginPath.split(\"/\").filter(Boolean);\n      pluginPath = `${splits[0]}/${splits[1]}`;\n    }\n\n    const isInstalled = isPackageExists(pluginPath, {\n      paths: [\n        this.context.workspaceConfig.workspaceRoot,\n        this.context.config.root\n      ]\n    });\n    if (!isInstalled && this.context.config.autoInstall) {\n      this.#context.warn(\n        `The plugin package \"${\n          pluginPath\n        }\" is not installed. It will be installed automatically.`\n      );\n\n      const result = await install(pluginPath, {\n        cwd: this.context.config.root\n      });\n      if (isNumber(result.exitCode) && result.exitCode > 0) {\n        this.#context.error(result.stderr);\n\n        throw new Error(\n          `An error occurred while installing the build plugin package \"${\n            pluginPath\n          }\" `\n        );\n      }\n    }\n\n    try {\n      // First check if the package has a \"plugin\" subdirectory - @scope/package/plugin\n      const module = await this.context.resolver.plugin.import<{\n        plugin?:\n          | Plugin<PluginContext<TResolvedConfig>>\n          | ((\n              options?: TOptions\n            ) => MaybePromise<Plugin<PluginContext<TResolvedConfig>>>);\n        default?:\n          | Plugin<PluginContext<TResolvedConfig>>\n          | ((\n              options?: TOptions\n            ) => MaybePromise<Plugin<PluginContext<TResolvedConfig>>>);\n      }>(\n        this.context.resolver.plugin.esmResolve(joinPaths(pluginPath, \"plugin\"))\n      );\n\n      const result = module.plugin ?? module.default;\n      if (!result) {\n        throw new Error(\n          `The plugin package \"${pluginPath}\" does not export a valid module.`\n        );\n      }\n\n      return result;\n    } catch (error) {\n      try {\n        const module = await this.context.resolver.plugin.import<{\n          plugin?:\n            | Plugin<PluginContext<TResolvedConfig>>\n            | ((\n                options?: TOptions\n              ) => MaybePromise<Plugin<PluginContext<TResolvedConfig>>>);\n          default?:\n            | Plugin<PluginContext<TResolvedConfig>>\n            | ((\n                options?: TOptions\n              ) => MaybePromise<Plugin<PluginContext<TResolvedConfig>>>);\n        }>(this.context.resolver.plugin.esmResolve(pluginPath));\n\n        const result = module.plugin ?? module.default;\n        if (!result) {\n          throw new Error(\n            `The plugin package \"${pluginPath}\" does not export a valid module.`\n          );\n        }\n\n        return result;\n      } catch {\n        if (!isInstalled) {\n          throw new Error(\n            `The plugin package \"${\n              pluginPath\n            }\" is not installed. Please install the package using the command: \"npm install ${\n              pluginPath\n            } --save-dev\"`\n          );\n        } else {\n          throw new Error(\n            `An error occurred while importing the build plugin package \"${\n              pluginPath\n            }\":\n${isError(error) ? error.message : String(error)}\n\nNote: Please ensure the plugin package's default export is a class that extends \\`Plugin\\` with a constructor that excepts a single arguments of type \\`PluginOptions\\`.`\n          );\n        }\n      }\n    }\n  }\n\n  /**\n   * Generate the Powerlines TypeScript declaration file\n   *\n   * @remarks\n   * This method will generate the TypeScript declaration file for the Powerlines project, including any types provided by plugins.\n   *\n   * @param context - The environment context to use for generating the TypeScript declaration file\n   * @returns A promise that resolves when the TypeScript declaration file has been generated\n   */\n  async #types(context: EnvironmentContext<TResolvedConfig>) {\n    context.debug(\n      `Preparing the TypeScript definitions for the Powerlines project.`\n    );\n\n    if (context.fs.existsSync(context.typesPath)) {\n      await context.fs.remove(context.typesPath);\n    }\n\n    const typescriptPath = await resolvePackage(\"typescript\");\n    if (!typescriptPath) {\n      throw new Error(\n        \"Could not resolve TypeScript package location. Please ensure TypeScript is installed.\"\n      );\n    }\n\n    context.debug(\n      \"Running TypeScript compiler for built-in runtime module files.\"\n    );\n\n    let { code, directives } = await emitBuiltinTypes(\n      context,\n      (await context.getBuiltins()).reduce<string[]>((ret, builtin) => {\n        const formatted = replacePath(\n          builtin.path,\n          context.workspaceConfig.workspaceRoot\n        );\n        if (!ret.includes(formatted)) {\n          ret.push(formatted);\n        }\n\n        return ret;\n      }, [])\n    );\n\n    context.debug(\n      `Generating TypeScript declaration file ${context.typesPath}.`\n    );\n\n    const merge = async (\n      currentResult: string | TypesResult,\n      previousResult: string | TypesResult\n    ): Promise<string | TypesResult> => {\n      if (\n        !isSetString(currentResult) &&\n        !isSetObject(currentResult) &&\n        !isSetString(previousResult) &&\n        !isSetObject(previousResult)\n      ) {\n        return { code, directives };\n      }\n\n      const previous = (\n        await format(\n          context,\n          context.typesPath,\n          isSetString(previousResult)\n            ? previousResult\n            : isSetObject(previousResult)\n              ? previousResult.code\n              : \"\"\n        )\n      )\n        .trim()\n        .replace(code, \"\")\n        .trim();\n      const current = (\n        await format(\n          context,\n          context.typesPath,\n          isSetString(currentResult)\n            ? currentResult\n            : isSetObject(currentResult)\n              ? currentResult.code\n              : \"\"\n        )\n      )\n        .trim()\n        .replace(previous, \"\")\n        .trim()\n        .replace(code, \"\")\n        .trim();\n\n      return {\n        directives: [\n          ...(isSetObject(currentResult) && currentResult.directives\n            ? currentResult.directives\n            : []),\n          ...(isSetObject(previousResult) && previousResult.directives\n            ? previousResult.directives\n            : [])\n        ],\n        code: await format(\n          context,\n          context.typesPath,\n          `${\n            !previous.includes(getTypescriptFileHeader(context)) &&\n            !current.includes(getTypescriptFileHeader(context))\n              ? `${code}\\n`\n              : \"\"\n          }${previous}\\n${current}`.trim()\n        )\n      };\n    };\n    const asNextParam = (\n      previousResult: string | TypesResult | null | undefined\n    ) => (isObject(previousResult) ? previousResult.code : previousResult);\n\n    let result = await this.callHook(\n      \"types\",\n      {\n        environment: context,\n        sequential: true,\n        order: \"pre\",\n        result: \"merge\",\n        merge,\n        asNextParam\n      },\n      code\n    );\n    if (result) {\n      if (isSetObject(result)) {\n        code = result.code;\n        if (Array.isArray(result.directives) && result.directives.length > 0) {\n          directives = getUnique([...directives, ...result.directives]).filter(\n            Boolean\n          );\n        }\n      } else if (isSetString(result)) {\n        code = result;\n      }\n    }\n\n    result = await this.callHook(\n      \"types\",\n      {\n        environment: context,\n        sequential: true,\n        order: \"normal\",\n        result: \"merge\",\n        merge,\n        asNextParam\n      },\n      code\n    );\n    if (result) {\n      if (isSetObject(result)) {\n        code = result.code;\n        if (Array.isArray(result.directives) && result.directives.length > 0) {\n          directives = getUnique([...directives, ...result.directives]).filter(\n            Boolean\n          );\n        }\n      } else if (isSetString(result)) {\n        code = result;\n      }\n    }\n\n    result = await this.callHook(\n      \"types\",\n      {\n        environment: context,\n        sequential: true,\n        order: \"post\",\n        result: \"merge\",\n        merge,\n        asNextParam\n      },\n      code\n    );\n    if (result) {\n      if (isSetObject(result)) {\n        code = result.code;\n        if (Array.isArray(result.directives) && result.directives.length > 0) {\n          directives = getUnique([...directives, ...result.directives]).filter(\n            Boolean\n          );\n        }\n      } else if (isSetString(result)) {\n        code = result;\n      }\n    }\n\n    if (isSetString(code?.trim()) || directives.length > 0) {\n      await context.fs.write(\n        context.typesPath,\n        `${\n          directives.length > 0\n            ? `${directives.map(directive => `/// <reference types=\"${directive}\" />`).join(\"\\n\")}\n\n`\n            : \"\"\n        }${getTypescriptFileHeader(context, { directive: null, prettierIgnore: false })}\n\n${formatTypes(code)}\n`\n      );\n    }\n\n    // else {\n    //   const dtsRelativePath = getTsconfigDtsPath(context);\n    //   if (\n    //     context.tsconfig.tsconfigJson.include &&\n    //     isIncludeMatchFound(\n    //       dtsRelativePath,\n    //       context.tsconfig.tsconfigJson.include\n    //     )\n    //   ) {\n    //     const normalizedDtsRelativePath = dtsRelativePath.startsWith(\"./\")\n    //       ? dtsRelativePath.slice(2)\n    //       : dtsRelativePath;\n    //     context.tsconfig.tsconfigJson.include =\n    //       context.tsconfig.tsconfigJson.include.filter(\n    //         includeValue =>\n    //           includeValue?.toString() !== normalizedDtsRelativePath\n    //       );\n\n    //     await context.fs.write(\n    //       context.tsconfig.tsconfigFilePath,\n    //       JSON.stringify(context.tsconfig.tsconfigJson, null, 2)\n    //     );\n    //   }\n    // }\n\n    // // Re-resolve the tsconfig to ensure it is up to date\n    // context.tsconfig = getParsedTypeScriptConfig(\n    //   context.workspaceConfig.workspaceRoot,\n    //   context.config.root,\n    //   context.config.tsconfig\n    // );\n    // if (!context.tsconfig) {\n    //   throw new Error(\"Failed to parse the TypeScript configuration file.\");\n    // }\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;ACmCA,SAAgB,YAAY,OAAO,IAAY;AAC7C,QAAO,KAAK,WAAW,aAAa,GAAG,CAAC,QAAQ,QAAQ,GAAG;;;;;;;;;AAuG7D,eAAsB,iBACpB,SACA,OACiD;AACjD,KAAI,MAAM,WAAW,GAAG;AACtB,UAAQ,MACN,kHACD;AACD,SAAO;GAAE,MAAM;GAAI,YAAY,EAAE;GAAE;;AAGrC,SAAQ,MACN,uCACE,MAAM,OACP,mCACF;CAED,IAAI,SAAS,MAAM,aAAa;EAC9B;EACA,SAAS,QAAQ,SAAS;EAC1B,QAAQ,QAAQ;EAChB,SAAS,MAAM,KAAI,SACjB,WAAW,MAAM,QAAQ,gBAAgB,cAAc,CACxD;EACD,UAAU,MAAM,QAAQ,aAAa,EAAE,QACpC,KAAK,SAAS;AACb,OAAI,GAAG,QAAQ,OAAO,UAAU,GAAG,KAAK,QAAQ,KAAK;AACrD,UAAO;KAET,EAAE,CACH;EACD,iBAAiB;GACf,aAAa;GACb,gBAAgB;GAChB,qBAAqB;GACrB,WAAW;GACX,QAAQ,YACN,QAAQ,cACR,QAAQ,gBAAgB,cACzB;GACD,WAAW;GACX,aAAa;GACb,iBAAiB;GAClB;EACF,CAAC;AAEF,UAAS,YAAY,OAAO;AAC5B,MAAK,MAAM,QAAQ,MAChB,KAAI,SAAQ,WAAW,MAAM,QAAQ,gBAAgB,cAAc,CAAC,CACpE,QAAO,SAAQA,eAAa,MAAM,QAAQ,aAAa,CAAC,EAAE;EAC3D,MAAM,UAAU,MAAM,QAAQ,GAAG,KAAK,KAAK;AAC3C,MAAI,YAAY,QAAQ,EAAE;GACxB,MAAM,gBAAgB,QACnB,MACC,IAAI,OACF,+BACE,QAAQ,OAAO,UAChB,MAAM,QAAQ,SAAS,KAAK,IAAI,CAAC,qBACnC,CACF,EACC,MAAK,YAAW,YAAY,SAAS,MAAM,CAAC,CAAC;AAEjD,OAAI,eAAe;AACjB,YAAQ,MACN,mFAAmF,OACpF;IAED,MAAM,WAAW,QAAQ,GAAG,YAAY,KAAK;AAC7C,QAAI,UAAU,GACZ,UAAS,OAAO,QACd,mBAAmB,QAAQ,OAAO,UAAU,GAAG,SAAS,GAAG,MAC3D,GAAG,cAAc,MAAM,CAAC;kBAClB,QAAQ,OAAO,UAAU,GAAG,SAAS,GAAG,KAC/C;;;;AAMT,UAAS,gCAAa,SAAS,QAAQ,WAAW,OAAO;AAEzD,SAAQ,MACN,wCAAwC,YACtC,IAAI,KAAK,QAAQ,OAAO,CAAC,CAAC,KAC3B,CAAC,2CACH;AAED,QAAO;EAAE,MAAM;EAAQ,YAAY,EAAE;EAAE;;;;;;;;;;;;AC3LzC,eAAsB,eACpB,SACA,aACA,MAAM,OACN;AACA,KACE,CAAE,MAAM,gBAAgB,eAAe,YAAY,EAAE,EACnD,KAAK,QAAQ,OAAO,MACrB,CAAC,CAEF,KAAI,QAAQ,OAAO,aAAa;AAC9B,UAAQ,KACN,gBAAgB,YAAY,yDAC7B;EAED,MAAM,SAAS,MAAM,QAAQ,aAAa;GACxC,KAAK,QAAQ,OAAO;GACpB;GACD,CAAC;AACF,MAAI,SAAS,OAAO,SAAS,IAAI,OAAO,WAAW,GAAG;AACpD,WAAQ,MAAM,OAAO,OAAO;AAC5B,SAAM,IAAI,MACR,mDAAmD,YAAY,GAChE;;OAGH,SAAQ,KACN,gBAAgB,YAAY,6GAC7B;UAGH,kBAAkB,YAAY,IAC9B,CAAC,QAAQ,IAAI,+BAOb;MAAI,CALe,MAAM,iBACvB,eAAe,YAAY,EAC3B,kBAAkB,YAAY,EAC9B,QAAQ,OAAO,KAChB,EACgB;GACf,MAAM,iBAAiB,MAAM,kBAC3B,eAAe,YAAY,EAC3B,EACE,KAAK,QAAQ,OAAO,MACrB,CACF;AACD,OACE,CAAC,gBAAgB,QAAQ,WAAW,WAAW,IAC/C,CAAC,gBAAgB,QAAQ,WAAW,aAAa,CAEjD,SAAQ,KACN,gBAAgB,eAAe,YAAY,CAAC,yDAAyD,kBACnG,YACD,CAAC,uBAAuB,gBAAgB,WAAW,YAAY,4JACjE;;;;;;;;;;;;AClET,eAAsB,oBACpB,SACe;AACf,SAAQ,MAAM,wDAAwD;AAEtE,SAAQ,iBAAiB,EAAE;AAC3B,SAAQ,oBAAoB,EAAE;AAE9B,KACE,OAAO,KAAK,QAAQ,aAAa,CAAC,WAAW,KAC7C,OAAO,KAAK,QAAQ,gBAAgB,CAAC,WAAW,GAChD;AACA,UAAQ,MACN,6EACD;AACD;;AAGF,SAAQ,MACN,0DAA0D,OAAO,QAC/D,QAAQ,aACT,CACE,KAAK,CAAC,MAAM,aAAa,KAAK,KAAK,GAAG,OAAO,QAAQ,GAAG,CACxD,KAAK,MAAM,CAAC,yBAAyB,OAAO,QAC7C,QAAQ,gBACT,CACE,KAAK,CAAC,MAAM,aAAa,KAAK,KAAK,GAAG,OAAO,QAAQ,GAAG,CACxD,KAAK,MAAM,GACf;AAED,OAAM,QAAQ,IAAI,CAChB,QAAQ,IACN,OAAO,QAAQ,QAAQ,aAAa,CAAC,IAAI,OAAO,CAAC,MAAM,aACrD,eACE,SACA,GAAG,eAAe,KAAK,CAAC,GAAG,OAAO,QAAQ,IAC1C,MACD,CACF,CACF,EACD,QAAQ,IACN,OAAO,QAAQ,QAAQ,gBAAgB,CAAC,IAAI,OAAO,CAAC,MAAM,aACxD,eACE,SACA,GAAG,eAAe,KAAK,CAAC,GAAG,OAAO,QAAQ,IAC1C,KACD,CACF,CACF,CACF,CAAC;;;;;ACpCJ,SAAgB,mBAEd,SAAsD;AAStD,QARwB,UACtB,aACE,UAAU,QAAQ,gBAAgB,eAAe,QAAQ,OAAO,KAAK,EACrE,aAAa,QAAQ,UAAU,CAChC,EACD,aAAa,QAAQ,UAAU,CAChC;;AAKH,eAAe,uBAEb,SAAqE;CACrE,MAAM,WAAW,0BACf,QAAQ,gBAAgB,eACxB,QAAQ,OAAO,MACf,QAAQ,OAAO,UACf,QAAQ,OAAO,YAChB;CAQD,MAAM,eAAe,MAAM,aANF,oBACvB,QAAQ,gBAAgB,eACxB,QAAQ,OAAO,MACf,QAAQ,OAAO,SAChB,CAEsE;AACvE,cAAa,oBAAoB,EAAE;AAEnC,KAAI,QAAQ,OAAO,OAAO,QAAQ,OAAO;EACvC,MAAM,kBAAkB,mBAAmB,QAAQ;AAEnD,MACE,CAAC,aAAa,SAAS,MAAK,gBAC1B,oBAAoB,aAAa,CAAC,QAAQ,WAAW,gBAAgB,CAAC,CACvE,EACD;AACA,gBAAa,YAAY,EAAE;AAC3B,gBAAa,QAAQ,KACnB,gBAAgB,WAAW,KAAK,GAC5B,gBAAgB,MAAM,EAAE,GACxB,gBACL;;;AAIL,KACE,CAAC,SAAS,QAAQ,KAAK,MAAK,QAC1B;EACE;EACA;EACA;EACA;EACD,CAAC,SAAS,IAAI,aAAa,CAAC,CAC9B,EACD;AACA,eAAa,gBAAgB,QAAQ,EAAE;AACvC,eAAa,gBAAgB,IAAI,KAAK,SAAS;;AA4DjD,KAAI,SAAS,QAAQ,oBAAoB,KACvC,cAAa,gBAAgB,kBAAkB;AAGjD,KAAI,SAAS,QAAQ,oBAAoB,KACvC,cAAa,gBAAgB,kBAAkB;AAGjD,KAAI,QAAQ,OAAO,aAAa,QAC9B;MACE,CAAC,SAAS,QAAQ,OAAO,MACvB,SACE,KAAK,aAAa,KAAK,UAAU,KAAK,aAAa,KAAK,cAC3D,EACD;AACA,gBAAa,gBAAgB,UAAU,EAAE;AACzC,gBAAa,gBAAgB,MAAM,KAAK,OAAO;;;AAInD,QAAO;;AAGT,eAAsB,mBAIpB,SAAkC;AAClC,SAAQ,MACN,oFACD;AAED,KAAI,CAAC,gBAAgB,aAAa,CAChC,OAAM,IAAI,MACR,+HACD;CAGH,MAAM,mBAAmB,oBACvB,QAAQ,gBAAgB,eACxB,QAAQ,OAAO,MACf,QAAQ,OAAO,SAChB;AAED,SAAQ,SAAS,uBACf,MAAM,aAA2B,iBAAiB;AAEpD,SAAQ,SAAS,eACf,MAAM,uBAAwC,QAAQ;AAExD,SAAQ,MACN,yEACD;AAED,OAAM,QAAQ,GAAG,MACf,kBACA,UAAU,UAAU,QAAQ,SAAS,aAAa,CACnD;AAED,SAAQ,WAAW,0BACjB,QAAQ,gBAAgB,eACxB,QAAQ,OAAO,MACf,QAAQ,OAAO,UACf,QAAQ,OAAO,aACf,QAAQ,SAAS,qBAClB;;AAGH,eAAsB,gBAIpB,SAAkC;CAClC,MAAM,qBAAqB,MAAM,aAC/B,QAAQ,SAAS,iBAClB;AACD,KACE,oBAAoB,iBAAiB,SACrC,MAAM,QAAQ,mBAAmB,gBAAgB,MAAM,IACvD,CAAC,mBAAmB,gBAAgB,MAAM,OAG1C,QAAO,mBAAmB,gBAAgB;CAG5C,MAAM,SAAS,cACb,QAAQ,SAAS,sBACjB,oBACA;EACE,kBAAkB;EAClB,UAAU;GACR,UAAU;IAAC;IAAS;IAAW;IAAU;GACzC,aAAa;GACd;EACF,CACF;CAED,MAAM,UAAU,EAAE;CAMlB,MAAM,cAAc,YAAkB,aAAsB;AAC1D,MACE,WAAW,WAAW,WACtB,WAAW,WAAW,aACtB,WAAW,WAAW,UAEtB,KAAI,WAAW,KACb,MAAK,MAAM,QAAQ,WAAW,KAC5B,YACE,MACA,WACI,GAAG,SAAS,GAAG,WAAW,aAC1B,WAAW,SAChB;MAGH,SAAQ,KAAK;GACX,OAAO,WACH,GAAG,SAAS,GAAG,WAAW,aAC1B,WAAW;GACf,QAAQ,WAAW;GACnB,UACE,WAAW,WAAW,UAClB,QACA,UAAU,UAAU,WAAW,cAAc;GACnD,SACE,WAAW,WAAW,YAClB,QACA,UAAU,UAAU,WAAW,aAAa;GACnD,CAAC;;AAKR,MAAK,MAAM,QAAQ,OAAO,KACxB,YAAW,KAAK;AAGlB,KAAI,QAAQ,SAAS,EACnB,SAAQ,KACN,mDAAmD,QAAQ,SAAS,iBAAiB;;MAErF,QACC,KACE,QAAQ,MAAM,GAAG,MAAM,KAAK,YAC3B,GAAG,IAAI,EAAE,IAAI,UAAU,OAAO,OAAO,CAAC,OAAO,OAAO,MAAM,UAC3D,CAAC;MACJ,MAAM,IAAI,gBAAgB,OAAO,SAAS,GAAG,CAAC;MAC9C,MAAM,MAAM,eAAe,OAAO,QAAQ,GAAG,CAAC;IAE7C,CACA,KAAK,KAAK,CAAC;MAEb;AAGH,OAAM,QAAQ,GAAG,MACf,QAAQ,SAAS,kBACjB,UAAU,UAAU,mBAAmB,CACxC;AAED,SAAQ,WAAW,0BACjB,QAAQ,gBAAgB,eACxB,QAAQ,OAAO,MACf,QAAQ,OAAO,SAChB;AACD,KAAI,CAAC,QAAQ,SACX,OAAM,IAAI,MAAM,qDAAqD;;;;;;;;;;;;;AC7NzE,IAAa,gBAAb,MAAa,cAIb;;;;CAIE;;;;CAKA,IAAW,UAAuC;AAChD,SAAO,MAAKC;;;;;;;CAQd,AAAQ,YAAY,SAAsC;AACxD,QAAKA,UAAW;;;;;;;;;CAUlB,aAAoB,KAGlB,eACA,QACyC;EACzC,MAAM,MAAM,IAAI,cACd,MAAM,qBAAqB,KAAK,eAAe,OAAO,CACvD;AACD,OAAIA,QAAS,aAAa;GACxB;GACA,WAAW,KAAIC,UAAW,KAAK,IAAI;GACpC;AAED,MAAI,QAAQ,KACV,6BAA6BC,QAAoB,cAClD;AAED,OAAK,MAAM,UAAU,IAAI,QAAQ,OAAO,QAAQ,KAAK,GAAG,IAAI,EAAE,CAC5D,OAAM,KAAID,UAAW,OAAO;AAG9B,MAAI,IAAI,QAAQ,QAAQ,WAAW,EACjC,KAAI,QAAQ,KACV,0HACD;MAED,KAAI,QAAQ,KACV,aAAa,IAAI,QAAQ,QAAQ,OAAO,GAAG,UACzC,IAAI,QAAQ,OAAO,UACpB,CAAC,SAAS,IAAI,QAAQ,QAAQ,SAAS,IAAI,MAAM,GAAG,QAAQ,IAAI,QAAQ,QACtE,KAAK,QAAQ,UAAU,IAAI,QAAQ,EAAE,iCAAc,OAAO,KAAK,GAAG,CAClE,KAAK,KAAK,GACd;EAGH,MAAM,eAAe,MAAM,IAAI,SAAS,UAAU;GAChD,aAAa,MAAM,IAAI,QAAQ,gBAAgB;GAC/C,YAAY;GACZ,QAAQ;GACR,OAAO;GACR,CAAC;AACF,QAAM,IAAI,QAAQ,eAChB,cACA,EAAE,gBAAgB,OAAO,CAC1B;AAED,SAAO;;;;;;;;;;CAWT,MAAa,MACX,eAA0D,EACxD,SAAS,SACV,EACD;AACA,OAAK,QAAQ,KACX,sEACD;AAED,OAAK,QAAQ,MACX,gEACD;AAED,eAAa,YAAY;AAEzB,QAAM,KAAK,QAAQ,iBACjB,aACD;AACD,QAAM,MAAKE,oBAAqB,OAAM,YAAW;AAC/C,WAAQ,MACN,kEACD;AAED,SAAM,KAAK,SAAS,kBAAkB;IACpC,aAAa;IACb,OAAO;IACR,CAAC;AAEF,SAAM,mBAAoC,QAAQ;AAElD,SAAM,KAAK,SAAS,kBAAkB;IACpC,aAAa;IACb,OAAO;IACR,CAAC;AAEF,OAAI,QAAQ,MAAM,SAAS,EACzB,SAAQ,MACN,8BACE,SAAS,QAAQ,OAAO,MAAM,GAC1B,OAAO,KAAK,QAAQ,OAAO,MAAM,CAAC,SAClC,QAAQ,QAAQ,OAAO,MAAM,CAAC,OACnC,wCACC,QAAQ,MAAM,OACf,0BAA0B,QAAQ,OAAO,MAAM,UAC9C,QAAQ,MAAM,SAAS,KAAK,QAAQ,MAAM,SAAS,KAC/C,OAAO,QAAQ,MACZ,KACC,UACE,KAAK,MAAM,OACT,MAAM,SAAS,OAAO,MAAM,WAAW,KAE5C,CACA,KAAK,MAAM,KACd,KAEP;OAED,SAAQ,KACN,qCACE,QAAQ,OAAO,MAChB,8HACF;AAGH,SAAM,gBAAiC,QAAQ;AAC/C,SAAM,oBAAoB,QAAQ;AAElC,SAAM,KAAK,SAAS,kBAAkB;IACpC,aAAa;IACb,OAAO;IACR,CAAC;AAEF,WAAQ,MACN,mDAAmD,iBAAiB;IAClE,GAAG,QAAQ;IACX,YAAY,YAAY,QAAQ,OAAO,WAAW,GAC9C,KAAK,QAAQ,OAAO,YAAY,CAAC,UAAU,CAAC,GAC5C;IACJ,cAAc,YAAY,QAAQ,OAAO,aAAa,GAClD,KAAK,QAAQ,OAAO,cAAc,CAAC,UAAU,CAAC,GAC9C;IACJ,SAAS,QAAQ,QAAQ,KAAI,WAAU,OAAO,OAAO,KAAK;IAC3D,CAAC,GACH;AAED,OAAI,CAAC,QAAQ,GAAG,WAAW,QAAQ,UAAU,CAC3C,OAAM,gBAAgB,QAAQ,UAAU;AAG1C,OAAI,CAAC,QAAQ,GAAG,WAAW,QAAQ,SAAS,CAC1C,OAAM,gBAAgB,QAAQ,SAAS;AAGzC,OACE,QAAQ,OAAO,cAAc,QAC7B,QAAQ,eAAe,aAAa,QAAQ,KAAK,SAEjD,SAAQ,MACN,wEACD;QACI;AACL,YAAQ,KACN,mFACD;AAED,UAAM,KAAK,QACTC,OACE,EACE,QAAQ,EACN,OAAO,OACR,EACF,EACD,aACD,CACF;;AAGH,SAAM,MAAKC,MAAO,QAAQ;AAE1B,QAAK,QAAQ,MAAM,oDAAoD;AAEvE,mCACE,SACA,QAAQ,WACP,MAAM,QAAQ,GAAG,KAAK,QAAQ,UAAU,IAAK,GAC/C;AAED,SAAM,cAAc,QAAQ;AAC5B,WAAQ,gBAAgB,QAAQ;IAChC;AAEF,OAAK,QAAQ,MACX,2DACD;;;;;;;;;;CAWH,MAAa,QACX,eAQiD,EAAE,SAAS,WAAW,EACvE;AACA,OAAK,QAAQ,KAAK,yCAAyC;AAE3D,OAAK,QAAQ,MACX,gEACD;AAED,eAAa,YAAY;AAEzB,QAAM,KAAK,QAAQ,iBACjB,aACD;AACD,QAAM,MAAKF,oBAAqB,OAAM,YAAW;AAC/C,WAAQ,MACN,kEACD;AAED,SAAM,KAAK,SAAS,kBAAkB;IACpC,aAAa;IACb,OAAO;IACR,CAAC;AAEF,SAAM,mBAAoC,QAAQ;AAElD,SAAM,KAAK,SAAS,kBAAkB;IACpC,aAAa;IACb,OAAO;IACR,CAAC;AAEF,OAAI,QAAQ,MAAM,SAAS,EACzB,SAAQ,MACN,8BACE,SAAS,QAAQ,OAAO,MAAM,GAC1B,OAAO,KAAK,QAAQ,OAAO,MAAM,CAAC,SAClC,QAAQ,QAAQ,OAAO,MAAM,CAAC,OACnC,wCACC,QAAQ,MAAM,OACf,0BAA0B,QAAQ,OAAO,MAAM,UAC9C,QAAQ,MAAM,SAAS,KAAK,QAAQ,MAAM,SAAS,KAC/C,OAAO,QAAQ,MACZ,KACC,UACE,KAAK,MAAM,OACT,MAAM,SAAS,OAAO,MAAM,WAAW,KAE5C,CACA,KAAK,MAAM,KACd,KAEP;OAED,SAAQ,KACN,qCACE,QAAQ,OAAO,MAChB,8HACF;AAGH,SAAM,gBAAiC,QAAQ;AAC/C,SAAM,oBAAoB,QAAQ;AAElC,SAAM,KAAK,SAAS,kBAAkB;IACpC,aAAa;IACb,OAAO;IACR,CAAC;AAEF,WAAQ,MACN,mDAAmD,iBAAiB;IAClE,GAAG,QAAQ;IACX,YAAY,YAAY,QAAQ,OAAO,WAAW,GAC9C,KAAK,QAAQ,OAAO,YAAY,CAAC,UAAU,CAAC,GAC5C;IACJ,cAAc,YAAY,QAAQ,OAAO,aAAa,GAClD,KAAK,QAAQ,OAAO,cAAc,CAAC,UAAU,CAAC,GAC9C;IACJ,SAAS,QAAQ,QAAQ,KAAI,WAAU,OAAO,OAAO,KAAK;IAC3D,CAAC,GACH;AAED,OAAI,CAAC,QAAQ,GAAG,WAAW,QAAQ,UAAU,CAC3C,OAAM,gBAAgB,QAAQ,UAAU;AAG1C,OAAI,CAAC,QAAQ,GAAG,WAAW,QAAQ,SAAS,CAC1C,OAAM,gBAAgB,QAAQ,SAAS;AAGzC,SAAM,KAAK,SAAS,WAAW;IAC7B,aAAa;IACb,OAAO;IACR,CAAC;AACF,SAAM,KAAK,SAAS,WAAW;IAC7B,aAAa;IACb,OAAO;IACR,CAAC;AAEF,SAAM,KAAK,SAAS,WAAW;IAC7B,aAAa;IACb,OAAO;IACR,CAAC;AAEF,OAAI,QAAQ,OAAO,OAAO,UAAU,MAClC,OAAM,MAAKE,MAAO,QAAQ;AAG5B,QAAK,QAAQ,MAAM,sDAAsD;AAEzE,SAAM,QAAQ,IAAI,iCACH,SAAS,QAAQ,aAAa,kCAC9B,SAAS,QAAQ,UAAU,CACzC,CAAC;AAEF,SAAM,cAAc,QAAQ;AAC5B,WAAQ,gBAAgB,QAAQ;IAChC;AAEF,OAAK,QAAQ,MAAM,sDAAsD;;;;;;;;;;;CAY3E,MAAa,IAAI,cAAuD;AACtE,OAAK,QAAQ,KAAK,wCAAwC;AAE1D,eAAa,YAAY;AAEzB,QAAM,KAAK,QACT,aACD;AACD,QAAM,MAAKF,oBAAqB,OAAM,YAAW;AAC/C,WAAQ,MACN,kEACD;AAED,SAAM,KAAK,SAAS,OAAO;IACzB,aAAa;IACb,OAAO;IACR,CAAC;GAEF,MAAM,QAAQ,MAAM,UAClB,UAAU,QAAQ,gBAAgB,wBAAwB,CAC3D;AACD,QAAK,MAAM,QAAQ,OAAO;AACxB,YAAQ,MAAM,oCAAoC,OAAO;IAEzD,MAAM,WAAW,WAAW,QAAQ,KAAK;AACzC,UAAM,QAAQ,GAAG,MACf,UAAU,QAAQ,OAAO,MAAM,KAAK,QAAQ,QAAQ,GAAG,CAAC,EACxD,SAAS,QAAQ,CAClB;;AAGH,SAAM,KAAK,SAAS,OAAO;IACzB,aAAa;IACb,OAAO;IACR,CAAC;AAEF,OAAI,QAAQ,OAAO,gBAAgB,eAAe;IAChD,MAAM,QAAQ,MAAM,UAClB,UAAU,QAAQ,gBAAgB,6BAA6B,CAChE;AACD,SAAK,MAAM,QAAQ,OAAO;AACxB,aAAQ,MAAM,qCAAqC,OAAO;KAE1D,MAAM,WAAW,WAAW,QAAQ,KAAK;AACzC,WAAM,QAAQ,GAAG,MACf,UAAU,QAAQ,OAAO,MAAM,KAAK,QAAQ,QAAQ,GAAG,CAAC,EACxD,SAAS,QAAQ,CAClB;;UAEE;IACL,MAAM,QAAQ,MAAM,UAClB,UAAU,QAAQ,gBAAgB,yBAAyB,CAC5D;AACD,SAAK,MAAM,QAAQ,OAAO;AACxB,aAAQ,MAAM,iCAAiC,OAAO;KAEtD,MAAM,WAAW,WAAW,QAAQ,KAAK;AACzC,WAAM,QAAQ,GAAG,MACf,UAAU,QAAQ,OAAO,MAAM,KAAK,QAAQ,QAAQ,GAAG,CAAC,EACxD,SAAS,QAAQ,CAClB;;;AAIL,SAAM,KAAK,SAAS,OAAO;IACzB,aAAa;IACb,OAAO;IACR,CAAC;IACF;AAEF,OAAK,QAAQ,MAAM,kDAAkD;;;;;;;;;;;CAYvE,MAAa,MACX,eAEkD,EAChD,SAAS,SACV,EACD;AACA,OAAK,QAAQ,KAAK,iDAAiD;AAEnE,eAAa,YAAY;AAEzB,QAAM,KAAK,QACT,aACD;AACD,QAAM,MAAKA,oBAAqB,OAAM,YAAW;AAC/C,WAAQ,MAAM,yDAAyD;AAEvE,SAAM,QAAQ,GAAG,OACf,UACE,QAAQ,gBAAgB,eACxB,QAAQ,OAAO,OAAO,KACvB,CACF;AACD,SAAM,QAAQ,GAAG,OACf,UACE,QAAQ,gBAAgB,eACxB,QAAQ,OAAO,MACf,QAAQ,OAAO,OAAO,cACvB,CACF;AAED,SAAM,KAAK,SAAS,SAAS;IAC3B,aAAa;IACb,YAAY;IACb,CAAC;IACF;AAEF,OAAK,QAAQ,MAAM,+CAA+C;;;;;;;;CASpE,MAAa,KACX,eAEgD,EAAE,SAAS,QAAQ,EACnE;AACA,OAAK,QAAQ,KAAK,qCAAqC;AAEvD,eAAa,YAAY;AACzB,QAAM,KAAK,QACT,aACD;AACD,QAAM,MAAKA,oBAAqB,OAAM,YAAW;AAC/C,SAAM,KAAK,SAAS,QAAQ;IAC1B,aAAa;IACb,YAAY;IACb,CAAC;IACF;AAEF,OAAK,QAAQ,MAAM,8CAA8C;;;;;;;;;;;CAYnE,MAAa,MACX,eAA0D,EACxD,SAAS,SACV,EACD;AACA,OAAK,QAAQ,KAAK,uCAAuC;AAEzD,QAAM,KAAK,QAAQ,kBAAkB;AACrC,MACE,KAAK,QAAQ,KAAK,aAAa,KAAK,QAAQ,eAAe,YAC3D,KAAK,QAAQ,OAAO,WACpB;AACA,QAAK,QAAQ,KACX,CAAC,KAAK,QAAQ,eAAe,WACzB,gFACA,KAAK,QAAQ,KAAK,aAAa,KAAK,QAAQ,cAAc,WACxD,mGACA,qEACP;AAED,gBAAa,YAAY;AAEzB,SAAM,KAAK,QACT,aACD;;AAGH,MAAI,KAAK,QAAQ,OAAO,YACtB,OAAM,MAAKG,YAAa,MAAM,MAAKN,QAAS,eAAe,CAAC;MAE5D,OAAM,MAAKG,oBAAqB,OAAM,YAAW;AAC/C,SAAM,MAAKG,YAAa,QAAQ;IAChC;AAGJ,OAAK,QAAQ,MAAM,4CAA4C;;;;;;;;CASjE,MAAa,KAAK,eAAiC,EAAE,SAAS,QAAQ,EAAE;AACtE,OAAK,QAAQ,KACX,0DACD;AAED,eAAa,YAAY;AACzB,QAAM,KAAK,QACT,aACD;AACD,QAAM,MAAKH,oBAAqB,OAAM,YAAW;AAC/C,WAAQ,MACN,8DACD;AAED,gBAAa,YAAY;AAEzB,SAAM,KAAK,QACT,aACD;AACD,SAAM,MAAKA,oBAAqB,OAAM,YAAW;AAC/C,UAAM,KAAK,SAAS,QAAQ,EAC1B,aAAa,SACd,CAAC;KACF;IACF;AAEF,OAAK,QAAQ,MACX,+DACD;;;;;;;;;;CAWH,MAAa,OACX,eAA2D,EACzD,SAAS,UACV,EACD;AACA,OAAK,QAAQ,KAAK,uCAAuC;AAEzD,eAAa,YAAY;AAEzB,QAAM,KAAK,QACT,aACD;AACD,QAAM,MAAKA,oBAAqB,OAAM,YAAW;AAC/C,SAAM,KAAK,SAAS,UAAU,EAAE,aAAa,SAAS,CAAC;IACvD;AAEF,OAAK,QAAQ,MAAM,6CAA6C;;;;;;;;;;CAWlE,MAAa,WAAW;AACtB,OAAK,QAAQ,KAAK,gDAAgD;AAElE,QAAM,MAAKA,oBAAqB,OAAM,YAAW;AAC/C,SAAM,KAAK,SAAS,YAAY,EAAE,aAAa,SAAS,CAAC;AACzD,SAAM,QAAQ,GAAG,SAAS;AAE1B,OACE,WAAW,QAAQ,UAAU,IAC7B,EAAE,MAAM,UAAU,UAAU,QAAQ,WAAW,OAAO,CAAC,GAAG,OAE1D,OAAM,gBAAgB,QAAQ,UAAU;IAE1C;AAEF,OAAK,QAAQ,MAAM,mDAAmD;;;;;;;;;;;;;CAcxE,MAAa,SACX,MACA,SAGA,GAAG,MACH;AACA,SAAO,SACL,YAAY,SAAS,YAAY,GAC7B,QAAQ,cACR,MAAM,MAAKH,QAAS,eAAe,SAAS,YAAY,EAC5D,MACA;GAAE,YAAY;GAAM,GAAG;GAAS,EAChC,GAAG,KACJ;;;;;;;;CASH,OAAc,OAAO,gBAAgB;AACnC,QAAM,KAAK,UAAU;;CAGvB,OAAMM,YAAa,SAA8C;AAC/D,QAAM,KAAK,SAAS,SAAS;GAC3B,aAAa;GACb,OAAO;GACR,CAAC;AAEF,UAAQ,MACN,wEACD;AACD,wCAAmB,SAAS,QAAQ,UAAU;AAE9C,QAAM,KAAK,SAAS,SAAS;GAC3B,aAAa;GACb,OAAO;GACR,CAAC;AAEF,MAAI,QAAQ,OAAO,OAAO,MAAM;AAC9B,WAAQ,MAAM,uDAAuD;GAErE,MAAM,kBAAkB,aACtB,WACE,QAAQ,OAAO,OAAO,MACtB,QAAQ,gBAAgB,cACzB,EACD,WAAW,QAAQ,OAAO,MAAM,QAAQ,gBAAgB,cAAc,CACvE,GACG,UACE,QAAQ,OAAO,OAAO,KAAK,MAC3B,aACE,WACE,QAAQ,OAAO,MACf,QAAQ,gBAAgB,cACzB,EACD,WACE,QAAQ,OAAO,OAAO,MACtB,QAAQ,gBAAgB,cACzB,CACF,CACF,GACD,UAAU,QAAQ,OAAO,OAAO,KAAK,MAAM,OAAO;GACtD,MAAM,aAAa,WACjB,QAAQ,OAAO,OAAO,MACtB,QAAQ,gBAAgB,cACzB;AAED,OAAI,WAAW,WAAW,IAAI,eAAe,iBAAiB;AAC5D,YAAQ,MACN,wDACE,QAAQ,OAAO,OAAO,KACvB,6CAA6C,gBAAgB,IAC/D;AAED,UAAM,UAAU,YAAY,gBAAgB;SAE5C,SAAQ,KACN,0CACE,CAAC,WAAW,WAAW,GACnB,mBACA,sCACL,YAAY,WAAW,iBACtB,gBACD,2CACF;AAGH,OACE,QAAQ,OAAO,OAAO,KAAK,UAC3B,MAAM,QAAQ,QAAQ,OAAO,OAAO,KAAK,OAAO,CAEhD,OAAM,QAAQ,IACZ,QAAQ,OAAO,OAAO,KAAK,OAAO,IAAI,OAAM,UAAS;AACnD,YAAQ,MACN,qBAAqB,MAAM,UACzB,QAAQ,gBAAgB,kBAAkB,MAAM,QAC5C,MAAM,OACN,WACE,MAAM,MACN,YACE,MAAM,OACN,QAAQ,gBAAgB,cACzB,CACF,CACN,CAAC,MAAM,MAAM,YACZ,WACE,MAAM,MACN,YACE,MAAM,QACN,QAAQ,gBAAgB,cACzB,CACF,CACF,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,UAAM,QAAQ,GAAG,KAAK,OAAO,MAAM,OAAO;KAC1C,CACH;QAGH,SAAQ,MACN,kGACD;AAGH,QAAM,KAAK,SAAS,SAAS;GAC3B,aAAa;GACb,OAAO;GACR,CAAC;;;;;;;CAQJ,OAAMC,kBAAmB;AACvB,MACE,CAAC,KAAK,QAAQ,OAAO,gBACrB,OAAO,KAAK,KAAK,QAAQ,OAAO,aAAa,CAAC,UAAU,GACxD;AACA,QAAK,QAAQ,MACX,6FACD;AAED,UAAO,CAAC,MAAM,KAAK,QAAQ,gBAAgB,CAAC;;AAG9C,OAAK,QAAQ,MACX,SAAS,OAAO,KAAK,KAAK,QAAQ,OAAO,aAAa,CAAC,OAAO,yDAC/D;AAED,UACE,MAAM,QAAQ,IACZ,OAAO,QAAQ,KAAK,QAAQ,OAAO,aAAa,CAAC,IAC/C,OAAO,CAAC,MAAM,YAAY;AAExB,OAAI,CADgB,MAAM,KAAK,QAAQ,mBAAmB,KAAK,EAC7C;IAChB,MAAM,sBAAsB,MAAM,KAAK,SACrC,qBACA,EACE,aAAa,MACd,EACD,MACA,OACD;AAED,QAAI,oBACF,MAAK,QAAQ,aAAa,QAAQ,MAAM,KAAK,QAAQ,GACnD,oBACD;;AAIL,UAAO,KAAK,QAAQ,aAAa;IAEpC,CACF,EACD,QAAO,YAAW,MAAM,QAAQ,CAAC;;;;;;;CAQrC,OAAMJ,oBACJ,QACA;AACA,QAAM,QAAQ,KACX,MAAM,MAAKI,iBAAkB,EAAE,IAAI,OAAM,YAAW;AACnD,UAAO,QAAQ,QAAQ,OAAO,QAAQ,CAAC;IACvC,CACH;;;;;;;CAQH,OAAMN,UAAW,QAAsD;AACrE,MAAI,QAAQ;GACV,MAAM,SAAS,MAAM,MAAKO,WAAY,OAAO;AAC7C,OAAI,CAAC,OACH;AAGF,QAAK,MAAM,UAAU,QAAQ;AAC3B,SAAK,QAAQ,MACX,gCAAgC,MAAM,KAAK,WACzC,OAAO,KACR,CAAC,SACH;AAED,UAAM,KAAK,QAAQ,UAAU,OAAO;;;;;;;;;;;CAY1C,OAAMA,WACJ,QAC0D;EAC1D,IAAI,UAAU;AACd,MAAI,cAAc,OAAO,CACvB,WAAW,MAAM,QAAQ,QAAQ,OAAuB;AAK1D,MAAI,0CAAgD,QAAQ,EAAE;GAC5D,MAAM,4DAAkC,QAAQ;AAEhD,SAAM,IAAI,MACR,WACE,WAAW,QAAQ,SAAS,IAAI,YAAY,SAC7C,oCACC,WAAW,QAAQ,SAAS,IACxB,KAAK,UAAU,QAAQ,GACvB,SAAS,KAAK,OAAO,CAC1B,0UACF;;EAGH,IAAI;AACJ,yCAA6C,QAAQ,CACnD,WAAU,CAAC,QAAQ;WACV,WAAW,QAAQ,CAC5B,WAAU,QAAQ,MAAM,QAAQ,QAAQ,SAAS,CAAC,CAAC;WAC1C,SAAS,QAAQ,EAAE;GAC5B,MAAM,WAAW,MAAM,MAAKC,cAAe,QAAQ;AACnD,OAAI,WAAW,SAAS,CACtB,WAAU,QAAQ,MAAM,QAAQ,QAAQ,UAAU,CAAC,CAAC;OAEpD,WAAU,QAAQ,SAAS;aAG7B,MAAM,QAAQ,QAAQ,IACrB,QAA6C,MAC5CC,8BACD,CAED,WAAU;WAEV,MAAM,QAAQ,QAAQ,IACrB,QAA2D,MAC1DC,oCACD,EACD;AACA,aAAU,EAAE;AACZ,QAAK,MAAM,gBAAgB,SAEtB;IACH,MAAM,cAAc,MAAM,MAAKH,WAAY,aAAa;AACxD,QAAI,YACF,SAAQ,KAAK,GAAG,YAAY;;2DAIoB,QAAQ,mDACP,QAAQ,EAC7D;GACA,IAAI;GAIJ,IAAI;AAEJ,qDAAwD,QAAQ,EAAE;AAChE,mBAAe,QAAQ;AACvB,oBACG,SAA+B,WAAW,IAAI,QAAQ,KAAK;UACzD;AACL,mBAAgB,QAA+B;AAG/C,oBAAiB,QAA+B;;AAGlD,OAAI,YAAY,aAAa,EAAE;IAC7B,MAAM,WAAW,MAAM,MAAKC,cAAe,aAAa;AACxD,QAAI,WAAW,SAAS,CACtB,WAAU,QACR,MAAM,QAAQ,QACZ,gBAAgB,SAAS,cAAc,GAAG,UAAU,CACrD,CACF;QAED,WAAU,QAAQ,SAAS;cAEpB,WAAW,aAAa,CACjC,WAAU,QAAQ,MAAM,QAAQ,QAAQ,aAAa,cAAc,CAAC,CAAC;YAErE,MAAM,QAAQ,aAAa,IAC3B,aAAa,MAAMC,8BAAyC,CAE5D,WAAU;+CACwC,aAAa,CAC/D,WAAU,QAAQ,aAAa;;AAInC,MAAI,CAAC,QACH,OAAM,IAAI,MACR,4BAA4B,KAAK,UAAU,QAAQ,CAAC,iFACrD;AAGH,MACE,QAAQ,SAAS,KACjB,CAAC,QAAQ,MAAMA,8BAAyC,CAExD,OAAM,IAAI,MACR,qBAAqB,KAAK,UAAU,QAAQ,CAAC,qGAC9C;EAGH,MAAM,SAAS,EAAE;AACjB,OAAK,MAAM,UAAU,QACnB,2CAAiC,QAAQ,KAAK,QAAQ,QAAQ,CAC5D,MAAK,QAAQ,MACX,aAAa,MAAM,KAAK,WACtB,OAAO,KACR,CAAC,wDACH;OACI;AACL,UAAO,KAAK,OAAO;AAEnB,QAAK,QAAQ,MACX,oBAAoB,MAAM,KAAK,WAAW,OAAO,KAAK,CAAC,YACxD;;AAIL,SAAO;;CAGT,OAAMD,cACJ,YAUA;AACA,MACE,WAAW,WAAW,IAAI,IAC1B,WAAW,MAAM,IAAI,CAAC,OAAO,QAAQ,CAAC,SAAS,GAC/C;GACA,MAAM,SAAS,WAAW,MAAM,IAAI,CAAC,OAAO,QAAQ;AACpD,gBAAa,GAAG,OAAO,GAAG,GAAG,OAAO;;EAGtC,MAAM,cAAc,gBAAgB,YAAY,EAC9C,OAAO,CACL,KAAK,QAAQ,gBAAgB,eAC7B,KAAK,QAAQ,OAAO,KACrB,EACF,CAAC;AACF,MAAI,CAAC,eAAe,KAAK,QAAQ,OAAO,aAAa;AACnD,SAAKT,QAAS,KACZ,uBACE,WACD,yDACF;GAED,MAAM,SAAS,MAAM,QAAQ,YAAY,EACvC,KAAK,KAAK,QAAQ,OAAO,MAC1B,CAAC;AACF,OAAI,SAAS,OAAO,SAAS,IAAI,OAAO,WAAW,GAAG;AACpD,UAAKA,QAAS,MAAM,OAAO,OAAO;AAElC,UAAM,IAAI,MACR,gEACE,WACD,IACF;;;AAIL,MAAI;GAEF,MAAM,SAAS,MAAM,KAAK,QAAQ,SAAS,OAAO,OAYhD,KAAK,QAAQ,SAAS,OAAO,WAAW,UAAU,YAAY,SAAS,CAAC,CACzE;GAED,MAAM,SAAS,OAAO,UAAU,OAAO;AACvC,OAAI,CAAC,OACH,OAAM,IAAI,MACR,uBAAuB,WAAW,mCACnC;AAGH,UAAO;WACA,OAAO;AACd,OAAI;IACF,MAAM,SAAS,MAAM,KAAK,QAAQ,SAAS,OAAO,OAW/C,KAAK,QAAQ,SAAS,OAAO,WAAW,WAAW,CAAC;IAEvD,MAAM,SAAS,OAAO,UAAU,OAAO;AACvC,QAAI,CAAC,OACH,OAAM,IAAI,MACR,uBAAuB,WAAW,mCACnC;AAGH,WAAO;WACD;AACN,QAAI,CAAC,YACH,OAAM,IAAI,MACR,uBACE,WACD,iFACC,WACD,cACF;QAED,OAAM,IAAI,MACR,+DACE,WACD;EACX,QAAQ,MAAM,GAAG,MAAM,UAAU,OAAO,MAAM,CAAC;;0KAGtC;;;;;;;;;;;;;CAeT,OAAMK,MAAO,SAA8C;AACzD,UAAQ,MACN,mEACD;AAED,MAAI,QAAQ,GAAG,WAAW,QAAQ,UAAU,CAC1C,OAAM,QAAQ,GAAG,OAAO,QAAQ,UAAU;AAI5C,MAAI,CADmB,MAAM,eAAe,aAAa,CAEvD,OAAM,IAAI,MACR,wFACD;AAGH,UAAQ,MACN,iEACD;EAED,IAAI,EAAE,MAAM,eAAe,MAAM,iBAC/B,UACC,MAAM,QAAQ,aAAa,EAAE,QAAkB,KAAK,YAAY;GAC/D,MAAM,YAAY,YAChB,QAAQ,MACR,QAAQ,gBAAgB,cACzB;AACD,OAAI,CAAC,IAAI,SAAS,UAAU,CAC1B,KAAI,KAAK,UAAU;AAGrB,UAAO;KACN,EAAE,CAAC,CACP;AAED,UAAQ,MACN,0CAA0C,QAAQ,UAAU,GAC7D;EAED,MAAM,QAAQ,OACZ,eACA,mBACkC;AAClC,OACE,CAAC,YAAY,cAAc,IAC3B,CAAC,YAAY,cAAc,IAC3B,CAAC,YAAY,eAAe,IAC5B,CAAC,YAAY,eAAe,CAE5B,QAAO;IAAE;IAAM;IAAY;GAG7B,MAAM,YACJ,gCACE,SACA,QAAQ,WACR,YAAY,eAAe,GACvB,iBACA,YAAY,eAAe,GACzB,eAAe,OACf,GACP,EAEA,MAAM,CACN,QAAQ,MAAM,GAAG,CACjB,MAAM;GACT,MAAM,WACJ,gCACE,SACA,QAAQ,WACR,YAAY,cAAc,GACtB,gBACA,YAAY,cAAc,GACxB,cAAc,OACd,GACP,EAEA,MAAM,CACN,QAAQ,UAAU,GAAG,CACrB,MAAM,CACN,QAAQ,MAAM,GAAG,CACjB,MAAM;AAET,UAAO;IACL,YAAY,CACV,GAAI,YAAY,cAAc,IAAI,cAAc,aAC5C,cAAc,aACd,EAAE,EACN,GAAI,YAAY,eAAe,IAAI,eAAe,aAC9C,eAAe,aACf,EAAE,CACP;IACD,MAAM,gCACJ,SACA,QAAQ,WACR,GACE,CAAC,SAAS,oDAAiC,QAAQ,CAAC,IACpD,CAAC,QAAQ,oDAAiC,QAAQ,CAAC,GAC/C,GAAG,KAAK,MACR,KACH,SAAS,IAAI,UAAU,MAAM,CACjC;IACF;;EAEH,MAAM,eACJ,mBACI,SAAS,eAAe,GAAG,eAAe,OAAO;EAEvD,IAAI,SAAS,MAAM,KAAK,SACtB,SACA;GACE,aAAa;GACb,YAAY;GACZ,OAAO;GACP,QAAQ;GACR;GACA;GACD,EACD,KACD;AACD,MAAI,QACF;OAAI,YAAY,OAAO,EAAE;AACvB,WAAO,OAAO;AACd,QAAI,MAAM,QAAQ,OAAO,WAAW,IAAI,OAAO,WAAW,SAAS,EACjE,cAAa,UAAU,CAAC,GAAG,YAAY,GAAG,OAAO,WAAW,CAAC,CAAC,OAC5D,QACD;cAEM,YAAY,OAAO,CAC5B,QAAO;;AAIX,WAAS,MAAM,KAAK,SAClB,SACA;GACE,aAAa;GACb,YAAY;GACZ,OAAO;GACP,QAAQ;GACR;GACA;GACD,EACD,KACD;AACD,MAAI,QACF;OAAI,YAAY,OAAO,EAAE;AACvB,WAAO,OAAO;AACd,QAAI,MAAM,QAAQ,OAAO,WAAW,IAAI,OAAO,WAAW,SAAS,EACjE,cAAa,UAAU,CAAC,GAAG,YAAY,GAAG,OAAO,WAAW,CAAC,CAAC,OAC5D,QACD;cAEM,YAAY,OAAO,CAC5B,QAAO;;AAIX,WAAS,MAAM,KAAK,SAClB,SACA;GACE,aAAa;GACb,YAAY;GACZ,OAAO;GACP,QAAQ;GACR;GACA;GACD,EACD,KACD;AACD,MAAI,QACF;OAAI,YAAY,OAAO,EAAE;AACvB,WAAO,OAAO;AACd,QAAI,MAAM,QAAQ,OAAO,WAAW,IAAI,OAAO,WAAW,SAAS,EACjE,cAAa,UAAU,CAAC,GAAG,YAAY,GAAG,OAAO,WAAW,CAAC,CAAC,OAC5D,QACD;cAEM,YAAY,OAAO,CAC5B,QAAO;;AAIX,MAAI,YAAY,MAAM,MAAM,CAAC,IAAI,WAAW,SAAS,EACnD,OAAM,QAAQ,GAAG,MACf,QAAQ,WACR,GACE,WAAW,SAAS,IAChB,GAAG,WAAW,KAAI,cAAa,yBAAyB,UAAU,MAAM,CAAC,KAAK,KAAK,CAAC;;IAGpF,gDACqB,SAAS;GAAE,WAAW;GAAM,gBAAgB;GAAO,CAAC,CAAC;;EAEtF,YAAY,KAAK,CAAC;EAEb"}

package/dist/{api-DjxroNtE.cjs → api-D7HzHvkw.cjs}

@@ -1,9 +1,8 @@
 const require_chunk = require('./chunk-AIJqnxB6.cjs');
-const require_ts_morph = require('./ts-morph-Cf4wz3E0.cjs');
 const require_utils = require('./utils.cjs');
 const require_plugin_utils = require('./plugin-utils.cjs');
-const require_api_context = require('./api-context-BSrRdlnu.cjs');
-const require_tsconfig = require('./tsconfig-ChmbpAO7.cjs');
+const require_api_context = require('./api-context-BTrJUKNX.cjs');
+const require_tsconfig = require('./tsconfig-B0kfe_iM.cjs');
 let _storm_software_config_tools_logger_console = require("@storm-software/config-tools/logger/console");
 let _stryke_convert_to_array = require("@stryke/convert/to-array");
 let _stryke_fs_copy_file = require("@stryke/fs/copy-file");
@@ -20,6 +19,7 @@ let _stryke_path_file_path_fns = require("@stryke/path/file-path-fns");
 let _stryke_path_is_parent_path = require("@stryke/path/is-parent-path");
 let _stryke_path_join_paths = require("@stryke/path/join-paths");
 let _stryke_path_replace = require("@stryke/path/replace");
+let _stryke_string_format_title_case = require("@stryke/string-format/title-case");
 let _stryke_type_checks_is_error = require("@stryke/type-checks/is-error");
 let _stryke_type_checks_is_function = require("@stryke/type-checks/is-function");
 let _stryke_type_checks_is_number = require("@stryke/type-checks/is-number");
@@ -35,22 +35,21 @@ let defu = require("defu");
 defu = require_chunk.__toESM(defu);
 let handlebars = require("handlebars");
 handlebars = require_chunk.__toESM(handlebars);
+let _stryke_path = require("@stryke/path");
 let _stryke_string_format_pretty_bytes = require("@stryke/string-format/pretty-bytes");
 let bundle_require = require("bundle-require");
-let ts_morph = require("ts-morph");
+let dts_buddy = require("dts-buddy");
 let _stryke_string_format_package = require("@stryke/string-format/package");
 let _stryke_fs_json = require("@stryke/fs/json");
 let _donedeal0_superdiff = require("@donedeal0/superdiff");
 let _stryke_json_storm_json = require("@stryke/json/storm-json");
-let _stryke_string_format_title_case = require("@stryke/string-format/title-case");
 
 //#region package.json
 var name = "powerlines";
-var version = "0.42.29";
+var version = "0.42.30";
 
 //#endregion
 //#region src/_internal/helpers/generate-types.ts
-const getModuleCommentBlockRegex = (moduleId) => new RegExp(`\\/\\*\\*(?s:.)*?@module\\s+${moduleId}(?s:.)*?\\*\\/\\s+`);
 /**
 * Formats the generated TypeScript types source code.
 *
@@ -61,37 +60,6 @@ function formatTypes(code = "") {
 	return code.replaceAll("#private;", "").replace(/__Ω/g, "");
 }
 /**
-* Formats a generated TypeScript module in the types source code.
-*
-* @param context - The Powerlines context.
-* @param id - The module ID for the generated TypeScript module.
-* @param code - The generated TypeScript module code.
-* @returns The formatted TypeScript module code.
-*/
-async function formatTypesModule(context, id, code) {
-	const moduleComment = code.match(getModuleCommentBlockRegex(`${context.config.framework}:${id}`))?.find((comment) => (0, _stryke_type_checks_is_set_string.isSetString)(comment?.trim()));
-	const ast = await context.parse(code, {
-		lang: "dts",
-		astType: "ts"
-	});
-	return {
-		code: `${moduleComment ? `
-${moduleComment.trim()}` : ""}
-declare module "${context.config.framework}:${id}" {
-  ${ast.module.staticImports.filter((staticImport) => !(0, bundle_require.match)(staticImport.moduleRequest.value, context.config.resolve.external) && !staticImport.moduleRequest.value.startsWith("node:")).map((staticImport) => {
-			return `import type { ${staticImport.entries.map((entry) => `${entry.importName.name}${entry.localName.value ? ` as ${entry.localName.value}` : ""}`).join(", ")} } from "${staticImport.moduleRequest.value}"; `;
-		}).join("\n")}
-
-  ${ast.module.staticImports.filter((staticImport) => !(0, bundle_require.match)(staticImport.moduleRequest.value, context.config.resolve.external) && !staticImport.moduleRequest.value.startsWith("node:")).reduce((ret, staticImport) => {
-			return `import type { ${staticImport.entries.map((entry) => `${entry.importName.name}${entry.localName.value ? ` as ${entry.localName.value}` : ""}`).join(", ")} } from "${staticImport.moduleRequest.value}";${ret.replaceAll(new RegExp(`^import.*from\\s+['"]${staticImport.moduleRequest.value}['"]\\s*;?$`, "gm"), "")}`;
-		}, code).replace(moduleComment ?? "", "").replaceAll(/^\s*export\s*declare\s*/gm, "export ").replaceAll(/^\s*declare\s*/gm, "").replaceAll(/^\s*export\s*\{\s*\}/gm, "").replaceAll(/^\s*export\s*=\s*/gm, "export default ").replaceAll(/^\s*export\s*\{/gm, "export {").replaceAll(/^\s*export\s*default\s*\{/gm, "export default {").replaceAll(/^\s*export\s*function\s*/gm, "export function ").replaceAll(/^\s*export\s*class\s*/gm, "export class ").replaceAll(/^\s*export\s*interface\s*/gm, "export interface ").replaceAll(/^\s*export\s*type\s*/gm, "export type ").replaceAll(/^\s*export\s*enum\s*/gm, "export enum ").replaceAll(/^\s*export\s*namespace\s*/gm, "export namespace ")}${ast.module.staticExports.length === 0 ? `
-  export {};` : ""}
-}
-`,
-		directives: ast.module.staticImports.filter((staticImport) => (0, bundle_require.match)(staticImport.moduleRequest.value, context.config.resolve.external) || staticImport.moduleRequest.value.startsWith("node:")).map((staticImport) => staticImport.moduleRequest.value)
-	};
-}
-/**
 * Emits TypeScript declaration types for the provided files using the given TypeScript configuration.
 *
 * @param context - The context containing options and environment paths.
@@ -107,8 +75,15 @@ async function emitBuiltinTypes(context, files) {
 		};
 	}
 	context.debug(`Running the TypeScript compiler for ${files.length} generated built-in module files.`);
-	const program = require_ts_morph.createProgram(context, {
-		skipAddingFilesFromTsConfig: true,
+	let result = await (0, dts_buddy.createBundle)({
+		context,
+		project: context.tsconfig.tsconfigFilePath,
+		output: context.typesPath,
+		include: files.map((file) => (0, _stryke_path_append.appendPath)(file, context.workspaceConfig.workspaceRoot)),
+		modules: (await context.getBuiltins()).reduce((ret, file) => {
+			ret[`${context.config.framework}:${file.id}`] = file.path;
+			return ret;
+		}, {}),
 		compilerOptions: {
 			declaration: true,
 			declarationMap: false,
@@ -120,40 +95,24 @@ async function emitBuiltinTypes(context, files) {
 			tsBuildInfoFile: void 0
 		}
 	});
-	program.addSourceFilesAtPaths(files);
-	const emitResult = program.emitToMemory({ emitOnlyDtsFiles: true });
-	const diagnostics = emitResult.getDiagnostics();
-	if (diagnostics && diagnostics.length > 0) if (diagnostics.some((d) => d.getCategory() === ts_morph.DiagnosticCategory.Error)) throw new Error(`The Typescript emit process failed while generating built-in types: \n ${diagnostics.filter((d) => d.getCategory() === ts_morph.DiagnosticCategory.Error).map((d) => `-${d.getSourceFile() ? `${d.getSourceFile()?.getFilePath()}:` : ""} ${String(d.getMessageText())} (at ${d.getStart()}:${d.getLength()})`).join("\n")}`);
-	else if (diagnostics.some((d) => d.getCategory() === ts_morph.DiagnosticCategory.Warning)) context.warn(`The Typescript emit process completed with warnings while generating built-in types: \n ${diagnostics.filter((d) => d.getCategory() === ts_morph.DiagnosticCategory.Warning).map((d) => `-${d.getSourceFile() ? `${d.getSourceFile()?.getFilePath()}:` : ""} ${String(d.getMessageText())} (at ${d.getStart()}:${d.getLength()})`).join("\n")}`);
-	else context.debug(`The Typescript emit process completed with diagnostic messages while generating built-in types: \n ${diagnostics.map((d) => `-${d.getSourceFile() ? `${d.getSourceFile()?.getFilePath()}:` : ""} ${String(d.getMessageText())} (at ${d.getStart()}:${d.getLength()})`).join("\n")}`);
-	const emittedFiles = emitResult.getFiles();
-	context.debug(`The TypeScript compiler emitted ${emittedFiles.length} files for built-in types.`);
-	if (emittedFiles.length === 0) {
-		context.warn("The TypeScript compiler did not emit any files for built-in types. This may indicate an issue with the TypeScript configuration or the provided files.");
-		return {
-			code: "",
-			directives: []
-		};
-	}
-	let result = "";
-	const directives = [];
-	for (const emittedFile of emittedFiles) {
-		context.trace(`Processing emitted type declaration file: ${emittedFile.filePath}`);
-		const filePath = (0, _stryke_path_append.appendPath)(emittedFile.filePath, context.workspaceConfig.workspaceRoot);
-		if (!filePath.endsWith(".map") && (0, _stryke_path_file_path_fns.findFileName)(filePath) !== "tsconfig.tsbuildinfo" && (0, _stryke_path_is_parent_path.isParentPath)(filePath, context.builtinsPath)) {
-			const moduleId = (0, _stryke_path_replace.replaceExtension)((0, _stryke_path_replace.replacePath)((0, _stryke_path_replace.replacePath)(filePath, context.builtinsPath), (0, _stryke_path_replace.replacePath)(context.builtinsPath, context.workspaceConfig.workspaceRoot)), "", { fullExtension: true });
-			if (context.builtins.includes(moduleId)) {
-				const formatted = await formatTypesModule(context, moduleId, emittedFile.text);
-				result += formatted.code;
-				directives.push(...formatted.directives);
+	result = formatTypes(result);
+	for (const file of files.map((file) => (0, _stryke_path_append.appendPath)(file, context.workspaceConfig.workspaceRoot)).filter((file) => (0, _stryke_path.isParentPath)(file, context.builtinsPath))) {
+		const content = await context.fs.read(file);
+		if ((0, _stryke_type_checks_is_set_string.isSetString)(content)) {
+			const moduleComment = content.match(new RegExp(`\\/\\*\\*(?s:.)*?@module\\s+${context.config.framework}:(?:${context.builtins.join("|")})(?s:.)*?\\*\\/\\s+`))?.find((comment) => (0, _stryke_type_checks_is_set_string.isSetString)(comment?.trim()));
+			if (moduleComment) {
+				context.debug(`Adding module-level comment for the built-in module types declaration for file: ${file}`);
+				const metadata = context.fs.getMetadata(file);
+				if (metadata?.id) result = result.replace(`declare module "${context.config.framework}:${metadata.id}" {`, `${moduleComment.trim()}
+declare module "${context.config.framework}:${metadata.id}" {`);
 			}
 		}
 	}
-	result = await (0, require_utils.utils_exports.format)(context, context.typesPath, formatTypes(result));
+	result = await (0, require_utils.utils_exports.format)(context, context.typesPath, result);
 	context.debug(`A TypeScript declaration file (size: ${(0, _stryke_string_format_pretty_bytes.prettyBytes)(new Blob((0, _stryke_convert_to_array.toArray)(result)).size)}) emitted for the built-in modules types.`);
 	return {
 		code: result,
-		directives
+		directives: []
 	};
 }
 
@@ -330,8 +289,9 @@ var PowerlinesAPI = class PowerlinesAPI {
 			addPlugin: api.#addPlugin.bind(api)
 		};
 		api.context.info(`🔌 The Powerlines Engine v${version} has started`);
-		for (const plugin of api.context.config.plugins ?? []) await api.#addPlugin(plugin);
+		for (const plugin of api.context.config.plugins.flat(10) ?? []) await api.#addPlugin(plugin);
 		if (api.context.plugins.length === 0) api.context.warn("No Powerlines plugins were specified in the options. Please ensure this is correct, as it is generally not recommended.");
+		else api.context.info(`🔌 Loaded ${api.context.plugins.length} ${(0, _stryke_string_format_title_case.titleCase)(api.context.config.framework)} plugin${api.context.plugins.length > 1 ? "s" : ""}: \n\n${api.context.plugins.map((plugin, index) => ` ${index + 1}. ${(0, require_utils.utils_exports.colorText)(plugin.name)}`).join("\n")}`);
 		const pluginConfig = await api.callHook("config", {
 			environment: await api.context.getEnvironment(),
 			sequential: true,
@@ -918,5 +878,4 @@ Object.defineProperty(exports, 'version', {
   get: function () {
     return version;
   }
-});
-//# sourceMappingURL=api-DjxroNtE.cjs.map
+});