@powerlines/engine 0.15.19 → 0.15.21

package/dist/api/build.cjs

@@ -1,10 +1,10 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const require_chunk = require('../chunk-C0xms8kb.cjs');
 const require_api_prepare = require('./prepare.cjs');
-let _stryke_path_append = require("@stryke/path/append");
 let _powerlines_core = require("@powerlines/core");
 let _powerlines_core_lib_environment = require("@powerlines/core/lib/environment");
 let _stryke_fs_copy_file = require("@stryke/fs/copy-file");
+let _stryke_path_append = require("@stryke/path/append");
 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");

package/dist/api/build.d.mts

@@ -1,5 +1,5 @@
-import { r as EngineResolvedConfig } from "../config-BNe23XHx.mjs";
-import { r as EngineSystemContext } from "../context-DzgsMSWr.mjs";
+import { r as EngineResolvedConfig } from "../config-C9AD-erz.mjs";
+import { r as EngineSystemContext } from "../context-S3XH2DWP.mjs";
 import { ExecutionContext } from "@powerlines/core";
 
 //#region src/api/build.d.ts

package/dist/api/build.mjs

@@ -1,8 +1,8 @@
 import { prepare } from "./prepare.mjs";
-import { appendPath } from "@stryke/path/append";
 import { formatFolder } from "@powerlines/core";
 import { executeEnvironments } from "@powerlines/core/lib/environment";
 import { copyFiles } from "@stryke/fs/copy-file";
+import { appendPath } from "@stryke/path/append";
 import { relativePath } from "@stryke/path/file-path-fns";
 import { isParentPath } from "@stryke/path/is-parent-path";
 import { joinPaths } from "@stryke/path/join-paths";

package/dist/api/build.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"build.mjs","names":[],"sources":["../../src/api/build.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 {\n  EnvironmentContext,\n  ExecutionContext,\n  formatFolder\n} from \"@powerlines/core\";\nimport { executeEnvironments } from \"@powerlines/core/lib/environment\";\nimport { copyFiles } from \"@stryke/fs/copy-file\";\nimport { appendPath } from \"@stryke/path/append\";\nimport { relativePath } from \"@stryke/path/file-path-fns\";\nimport { isParentPath } from \"@stryke/path/is-parent-path\";\nimport { joinPaths } from \"@stryke/path/join-paths\";\nimport { replacePath } from \"@stryke/path/replace\";\nimport chalk from \"chalk\";\nimport { existsSync } from \"node:fs\";\nimport { EngineResolvedConfig } from \"../types/config\";\nimport { EngineSystemContext } from \"../types/context\";\nimport { prepare } from \"./prepare\";\n\nasync function handleBuild<\n  TResolvedConfig extends EngineResolvedConfig,\n  TSystemContext extends EngineSystemContext\n>(\n  context: ExecutionContext<TResolvedConfig, TSystemContext>,\n  env: EnvironmentContext<TResolvedConfig, TSystemContext>\n) {\n  await context.callHook(\"build\", {\n    environment: env,\n    order: \"pre\"\n  });\n\n  env.debug(\n    \"Formatting the generated entry files before the build process starts.\"\n  );\n  await formatFolder(env, env.entryPath);\n\n  await context.callHook(\"build\", {\n    environment: env,\n    order: \"normal\"\n  });\n\n  if (env.config.output.copy) {\n    env.debug(\"Copying project's files from build output directory.\");\n\n    const destinationPath = isParentPath(\n      appendPath(env.config.output.path, env.config.cwd),\n      appendPath(env.config.root, env.config.cwd)\n    )\n      ? joinPaths(\n          env.config.output.copy.path,\n          relativePath(\n            appendPath(env.config.root, env.config.cwd),\n            appendPath(env.config.output.path, env.config.cwd)\n          )\n        )\n      : joinPaths(env.config.output.copy.path, \"dist\");\n    const sourcePath = env.config.output.path;\n\n    if (existsSync(sourcePath) && sourcePath !== destinationPath) {\n      env.debug(\n        `Copying files from project's build output directory (${\n          env.config.output.path\n        }) to the project's copy/publish directory (${destinationPath}).`\n      );\n\n      await copyFiles(sourcePath, destinationPath);\n    } else {\n      env.warn(\n        `The source path for the copy operation ${\n          !existsSync(sourcePath)\n            ? \"does not exist\"\n            : \"is the same as the destination path\"\n        }. Source: ${sourcePath}, Destination: ${\n          destinationPath\n        }. Skipping copying of build output files.`\n      );\n    }\n\n    if (\n      env.config.output.copy.assets &&\n      Array.isArray(env.config.output.copy.assets)\n    ) {\n      await Promise.all(\n        env.config.output.copy.assets.map(async asset => {\n          env.trace(\n            `Copying asset(s): ${chalk.redBright(\n              env.config.cwd === asset.input\n                ? asset.glob\n                : appendPath(\n                    asset.glob,\n                    replacePath(asset.input, env.config.cwd)\n                  )\n            )} -> ${chalk.greenBright(\n              appendPath(asset.glob, replacePath(asset.output, env.config.cwd))\n            )} ${\n              Array.isArray(asset.ignore) && asset.ignore.length > 0\n                ? ` (ignoring: ${asset.ignore\n                    .map(i => chalk.yellowBright(i))\n                    .join(\", \")})`\n                : \"\"\n            }`\n          );\n\n          await env.fs.copy(asset, asset.output);\n        })\n      );\n    }\n  } else {\n    env.debug(\n      \"No copy configuration found for the project output. Skipping the copying of build output files.\"\n    );\n  }\n\n  await context.callHook(\"build\", {\n    environment: env,\n    order: \"post\"\n  });\n}\n\n/**\n * Build the project\n *\n * @param context - The execution context for the build process, which provides access to the project configuration, environment, and utility functions for performing the build. The context is used to manage the state and behavior of the build process, allowing for hooks to be called at different stages of the build and for environment-specific configurations to be applied.\n */\nexport async function build<\n  TResolvedConfig extends EngineResolvedConfig,\n  TSystemContext extends EngineSystemContext\n>(context: ExecutionContext<TResolvedConfig, TSystemContext>) {\n  const timer = context.timer(\"Building\");\n\n  await context.generateChecksum();\n  if (\n    context.meta.checksum !== context.persistedMeta?.checksum ||\n    context.config.skipCache\n  ) {\n    context.info(\n      !context.persistedMeta?.checksum\n        ? \"No previous build cache found. Preparing the project for the initial build.\"\n        : context.meta.checksum !== context.persistedMeta.checksum\n          ? \"The project has been modified since the last time `prepare` was ran. Re-preparing the project.\"\n          : \"The project is configured to skip cache. Re-preparing the project.\"\n    );\n\n    await prepare<TResolvedConfig, TSystemContext>(context);\n  }\n\n  if (context.config.singleBuild) {\n    await handleBuild<TResolvedConfig, TSystemContext>(\n      context,\n      await context.toEnvironment()\n    );\n  } else {\n    await executeEnvironments(context, async env => {\n      await handleBuild<TResolvedConfig, TSystemContext>(context, env);\n    });\n  }\n\n  timer();\n}\n"],"mappings":";;;;;;;;;;;;;AAoCA,eAAe,YAIb,SACA,KACA;AACA,OAAM,QAAQ,SAAS,SAAS;EAC9B,aAAa;EACb,OAAO;EACR,CAAC;AAEF,KAAI,MACF,wEACD;AACD,OAAM,aAAa,KAAK,IAAI,UAAU;AAEtC,OAAM,QAAQ,SAAS,SAAS;EAC9B,aAAa;EACb,OAAO;EACR,CAAC;AAEF,KAAI,IAAI,OAAO,OAAO,MAAM;AAC1B,MAAI,MAAM,uDAAuD;EAEjE,MAAM,kBAAkB,aACtB,WAAW,IAAI,OAAO,OAAO,MAAM,IAAI,OAAO,IAAI,EAClD,WAAW,IAAI,OAAO,MAAM,IAAI,OAAO,IAAI,CAC5C,GACG,UACE,IAAI,OAAO,OAAO,KAAK,MACvB,aACE,WAAW,IAAI,OAAO,MAAM,IAAI,OAAO,IAAI,EAC3C,WAAW,IAAI,OAAO,OAAO,MAAM,IAAI,OAAO,IAAI,CACnD,CACF,GACD,UAAU,IAAI,OAAO,OAAO,KAAK,MAAM,OAAO;EAClD,MAAM,aAAa,IAAI,OAAO,OAAO;AAErC,MAAI,WAAW,WAAW,IAAI,eAAe,iBAAiB;AAC5D,OAAI,MACF,wDACE,IAAI,OAAO,OAAO,KACnB,6CAA6C,gBAAgB,IAC/D;AAED,SAAM,UAAU,YAAY,gBAAgB;QAE5C,KAAI,KACF,0CACE,CAAC,WAAW,WAAW,GACnB,mBACA,sCACL,YAAY,WAAW,iBACtB,gBACD,2CACF;AAGH,MACE,IAAI,OAAO,OAAO,KAAK,UACvB,MAAM,QAAQ,IAAI,OAAO,OAAO,KAAK,OAAO,CAE5C,OAAM,QAAQ,IACZ,IAAI,OAAO,OAAO,KAAK,OAAO,IAAI,OAAM,UAAS;AAC/C,OAAI,MACF,qBAAqB,MAAM,UACzB,IAAI,OAAO,QAAQ,MAAM,QACrB,MAAM,OACN,WACE,MAAM,MACN,YAAY,MAAM,OAAO,IAAI,OAAO,IAAI,CACzC,CACN,CAAC,MAAM,MAAM,YACZ,WAAW,MAAM,MAAM,YAAY,MAAM,QAAQ,IAAI,OAAO,IAAI,CAAC,CAClE,CAAC,GACA,MAAM,QAAQ,MAAM,OAAO,IAAI,MAAM,OAAO,SAAS,IACjD,eAAe,MAAM,OAClB,KAAI,MAAK,MAAM,aAAa,EAAE,CAAC,CAC/B,KAAK,KAAK,CAAC,KACd,KAEP;AAED,SAAM,IAAI,GAAG,KAAK,OAAO,MAAM,OAAO;IACtC,CACH;OAGH,KAAI,MACF,kGACD;AAGH,OAAM,QAAQ,SAAS,SAAS;EAC9B,aAAa;EACb,OAAO;EACR,CAAC;;;;;;;AAQJ,eAAsB,MAGpB,SAA4D;CAC5D,MAAM,QAAQ,QAAQ,MAAM,WAAW;AAEvC,OAAM,QAAQ,kBAAkB;AAChC,KACE,QAAQ,KAAK,aAAa,QAAQ,eAAe,YACjD,QAAQ,OAAO,WACf;AACA,UAAQ,KACN,CAAC,QAAQ,eAAe,WACpB,gFACA,QAAQ,KAAK,aAAa,QAAQ,cAAc,WAC9C,mGACA,qEACP;AAED,QAAM,QAAyC,QAAQ;;AAGzD,KAAI,QAAQ,OAAO,YACjB,OAAM,YACJ,SACA,MAAM,QAAQ,eAAe,CAC9B;KAED,OAAM,oBAAoB,SAAS,OAAM,QAAO;AAC9C,QAAM,YAA6C,SAAS,IAAI;GAChE;AAGJ,QAAO"}
+{"version":3,"file":"build.mjs","names":[],"sources":["../../src/api/build.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 {\n  EnvironmentContext,\n  ExecutionContext,\n  formatFolder\n} from \"@powerlines/core\";\nimport { executeEnvironments } from \"@powerlines/core/lib/environment\";\nimport { copyFiles } from \"@stryke/fs/copy-file\";\nimport { appendPath } from \"@stryke/path/append\";\nimport { relativePath } from \"@stryke/path/file-path-fns\";\nimport { isParentPath } from \"@stryke/path/is-parent-path\";\nimport { joinPaths } from \"@stryke/path/join-paths\";\nimport { replacePath } from \"@stryke/path/replace\";\nimport chalk from \"chalk\";\nimport { existsSync } from \"node:fs\";\nimport { EngineResolvedConfig } from \"../types/config\";\nimport { EngineSystemContext } from \"../types/context\";\nimport { prepare } from \"./prepare\";\n\nasync function handleBuild<\n  TResolvedConfig extends EngineResolvedConfig,\n  TSystemContext extends EngineSystemContext\n>(\n  context: ExecutionContext<TResolvedConfig, TSystemContext>,\n  env: EnvironmentContext<TResolvedConfig, TSystemContext>\n) {\n  await context.callHook(\"build\", {\n    environment: env,\n    order: \"pre\"\n  });\n\n  env.debug(\n    \"Formatting the generated entry files before the build process starts.\"\n  );\n  await formatFolder(env, env.entryPath);\n\n  await context.callHook(\"build\", {\n    environment: env,\n    order: \"normal\"\n  });\n\n  if (env.config.output.copy) {\n    env.debug(\"Copying project's files from build output directory.\");\n\n    const destinationPath = isParentPath(\n      appendPath(env.config.output.path, env.config.cwd),\n      appendPath(env.config.root, env.config.cwd)\n    )\n      ? joinPaths(\n          env.config.output.copy.path,\n          relativePath(\n            appendPath(env.config.root, env.config.cwd),\n            appendPath(env.config.output.path, env.config.cwd)\n          )\n        )\n      : joinPaths(env.config.output.copy.path, \"dist\");\n    const sourcePath = env.config.output.path;\n\n    if (existsSync(sourcePath) && sourcePath !== destinationPath) {\n      env.debug(\n        `Copying files from project's build output directory (${\n          env.config.output.path\n        }) to the project's copy/publish directory (${destinationPath}).`\n      );\n\n      await copyFiles(sourcePath, destinationPath);\n    } else {\n      env.warn(\n        `The source path for the copy operation ${\n          !existsSync(sourcePath)\n            ? \"does not exist\"\n            : \"is the same as the destination path\"\n        }. Source: ${sourcePath}, Destination: ${\n          destinationPath\n        }. Skipping copying of build output files.`\n      );\n    }\n\n    if (\n      env.config.output.copy.assets &&\n      Array.isArray(env.config.output.copy.assets)\n    ) {\n      await Promise.all(\n        env.config.output.copy.assets.map(async asset => {\n          env.trace(\n            `Copying asset(s): ${chalk.redBright(\n              env.config.cwd === asset.input\n                ? asset.glob\n                : appendPath(\n                    asset.glob,\n                    replacePath(asset.input, env.config.cwd)\n                  )\n            )} -> ${chalk.greenBright(\n              appendPath(asset.glob, replacePath(asset.output, env.config.cwd))\n            )} ${\n              Array.isArray(asset.ignore) && asset.ignore.length > 0\n                ? ` (ignoring: ${asset.ignore\n                    .map(i => chalk.yellowBright(i))\n                    .join(\", \")})`\n                : \"\"\n            }`\n          );\n\n          await env.fs.copy(asset, asset.output);\n        })\n      );\n    }\n  } else {\n    env.debug(\n      \"No copy configuration found for the project output. Skipping the copying of build output files.\"\n    );\n  }\n\n  await context.callHook(\"build\", {\n    environment: env,\n    order: \"post\"\n  });\n}\n\n/**\n * Build the project\n *\n * @param context - The execution context for the build process, which provides access to the project configuration, environment, and utility functions for performing the build. The context is used to manage the state and behavior of the build process, allowing for hooks to be called at different stages of the build and for environment-specific configurations to be applied.\n */\nexport async function build<\n  TResolvedConfig extends EngineResolvedConfig,\n  TSystemContext extends EngineSystemContext\n>(context: ExecutionContext<TResolvedConfig, TSystemContext>) {\n  const timer = context.timer(\"Building\");\n\n  await context.generateChecksum();\n  if (\n    context.meta.checksum !== context.persistedMeta?.checksum ||\n    context.config.skipCache\n  ) {\n    context.info(\n      !context.persistedMeta?.checksum\n        ? \"No previous build cache found. Preparing the project for the initial build.\"\n        : context.meta.checksum !== context.persistedMeta.checksum\n          ? \"The project has been modified since the last time `prepare` was ran. Re-preparing the project.\"\n          : \"The project is configured to skip cache. Re-preparing the project.\"\n    );\n\n    await prepare<TResolvedConfig, TSystemContext>(context);\n  }\n\n  if (context.config.singleBuild) {\n    await handleBuild<TResolvedConfig, TSystemContext>(\n      context,\n      await context.toEnvironment()\n    );\n  } else {\n    await executeEnvironments(context, async env => {\n      await handleBuild<TResolvedConfig, TSystemContext>(context, env);\n    });\n  }\n\n  timer();\n}\n"],"mappings":";;;;;;;;;;;;;AAoCA,eAAe,YAIb,SACA,KACA;CACA,MAAM,QAAQ,SAAS,SAAS;EAC9B,aAAa;EACb,OAAO;CACT,CAAC;CAED,IAAI,MACF,uEACF;CACA,MAAM,aAAa,KAAK,IAAI,SAAS;CAErC,MAAM,QAAQ,SAAS,SAAS;EAC9B,aAAa;EACb,OAAO;CACT,CAAC;CAED,IAAI,IAAI,OAAO,OAAO,MAAM;EAC1B,IAAI,MAAM,sDAAsD;EAEhE,MAAM,kBAAkB,aACtB,WAAW,IAAI,OAAO,OAAO,MAAM,IAAI,OAAO,GAAG,GACjD,WAAW,IAAI,OAAO,MAAM,IAAI,OAAO,GAAG,CAC5C,IACI,UACE,IAAI,OAAO,OAAO,KAAK,MACvB,aACE,WAAW,IAAI,OAAO,MAAM,IAAI,OAAO,GAAG,GAC1C,WAAW,IAAI,OAAO,OAAO,MAAM,IAAI,OAAO,GAAG,CACnD,CACF,IACA,UAAU,IAAI,OAAO,OAAO,KAAK,MAAM,MAAM;EACjD,MAAM,aAAa,IAAI,OAAO,OAAO;EAErC,IAAI,WAAW,UAAU,KAAK,eAAe,iBAAiB;GAC5D,IAAI,MACF,wDACE,IAAI,OAAO,OAAO,KACnB,6CAA6C,gBAAgB,GAChE;GAEA,MAAM,UAAU,YAAY,eAAe;EAC7C,OACE,IAAI,KACF,0CACE,CAAC,WAAW,UAAU,IAClB,mBACA,sCACL,YAAY,WAAW,iBACtB,gBACD,0CACH;EAGF,IACE,IAAI,OAAO,OAAO,KAAK,UACvB,MAAM,QAAQ,IAAI,OAAO,OAAO,KAAK,MAAM,GAE3C,MAAM,QAAQ,IACZ,IAAI,OAAO,OAAO,KAAK,OAAO,IAAI,OAAM,UAAS;GAC/C,IAAI,MACF,qBAAqB,MAAM,UACzB,IAAI,OAAO,QAAQ,MAAM,QACrB,MAAM,OACN,WACE,MAAM,MACN,YAAY,MAAM,OAAO,IAAI,OAAO,GAAG,CACzC,CACN,EAAE,MAAM,MAAM,YACZ,WAAW,MAAM,MAAM,YAAY,MAAM,QAAQ,IAAI,OAAO,GAAG,CAAC,CAClE,EAAE,GACA,MAAM,QAAQ,MAAM,MAAM,KAAK,MAAM,OAAO,SAAS,IACjD,eAAe,MAAM,OAClB,KAAI,MAAK,MAAM,aAAa,CAAC,CAAC,EAC9B,KAAK,IAAI,EAAE,KACd,IAER;GAEA,MAAM,IAAI,GAAG,KAAK,OAAO,MAAM,MAAM;EACvC,CAAC,CACH;CAEJ,OACE,IAAI,MACF,iGACF;CAGF,MAAM,QAAQ,SAAS,SAAS;EAC9B,aAAa;EACb,OAAO;CACT,CAAC;AACH;;;;;;AAOA,eAAsB,MAGpB,SAA4D;CAC5D,MAAM,QAAQ,QAAQ,MAAM,UAAU;CAEtC,MAAM,QAAQ,iBAAiB;CAC/B,IACE,QAAQ,KAAK,aAAa,QAAQ,eAAe,YACjD,QAAQ,OAAO,WACf;EACA,QAAQ,KACN,CAAC,QAAQ,eAAe,WACpB,gFACA,QAAQ,KAAK,aAAa,QAAQ,cAAc,WAC9C,mGACA,oEACR;EAEA,MAAM,QAAyC,OAAO;CACxD;CAEA,IAAI,QAAQ,OAAO,aACjB,MAAM,YACJ,SACA,MAAM,QAAQ,cAAc,CAC9B;MAEA,MAAM,oBAAoB,SAAS,OAAM,QAAO;EAC9C,MAAM,YAA6C,SAAS,GAAG;CACjE,CAAC;CAGH,MAAM;AACR"}

package/dist/api/clean.d.mts

@@ -1,5 +1,5 @@
-import { r as EngineResolvedConfig } from "../config-BNe23XHx.mjs";
-import { r as EngineSystemContext } from "../context-DzgsMSWr.mjs";
+import { r as EngineResolvedConfig } from "../config-C9AD-erz.mjs";
+import { r as EngineSystemContext } from "../context-S3XH2DWP.mjs";
 import { ExecutionContext } from "@powerlines/core";
 
 //#region src/api/clean.d.ts

package/dist/api/clean.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"clean.mjs","names":[],"sources":["../../src/api/clean.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 { ExecutionContext } from \"@powerlines/core\";\nimport { executeEnvironments } from \"@powerlines/core/lib/environment\";\nimport { joinPaths } from \"@stryke/path/join\";\nimport { EngineResolvedConfig } from \"../types/config\";\nimport { EngineSystemContext } from \"../types/context\";\nimport { prepare } from \"./prepare\";\n\n/**\n * Clean any previously prepared artifacts\n *\n * @param context - The execution context for the clean process, which provides access to the project configuration, environment, and utility functions for performing the clean operation. The context is used to manage the state and behavior of the clean process, allowing for hooks to be called at different stages of the clean and for environment-specific configurations to be applied.\n */\nexport async function clean<\n  TResolvedConfig extends EngineResolvedConfig,\n  TSystemContext extends EngineSystemContext\n>(context: ExecutionContext<TResolvedConfig, TSystemContext>) {\n  const timer = context.timer(\"Cleaning\");\n\n  await prepare<TResolvedConfig, TSystemContext>(context, true);\n  await executeEnvironments(context, async env => {\n    env.debug(\"Cleaning the project's dist and artifacts directories.\");\n\n    await env.fs.remove(joinPaths(env.config.cwd, env.config.output.path));\n    await env.fs.remove(\n      joinPaths(\n        env.config.cwd,\n        env.config.root,\n        env.config.output.artifactsPath\n      )\n    );\n\n    await context.callHook(\"clean\", {\n      environment: env,\n      sequential: false\n    });\n  });\n\n  timer();\n}\n"],"mappings":";;;;;;;;;;AA8BA,eAAsB,MAGpB,SAA4D;CAC5D,MAAM,QAAQ,QAAQ,MAAM,WAAW;AAEvC,OAAM,QAAyC,SAAS,KAAK;AAC7D,OAAM,oBAAoB,SAAS,OAAM,QAAO;AAC9C,MAAI,MAAM,yDAAyD;AAEnE,QAAM,IAAI,GAAG,OAAO,UAAU,IAAI,OAAO,KAAK,IAAI,OAAO,OAAO,KAAK,CAAC;AACtE,QAAM,IAAI,GAAG,OACX,UACE,IAAI,OAAO,KACX,IAAI,OAAO,MACX,IAAI,OAAO,OAAO,cACnB,CACF;AAED,QAAM,QAAQ,SAAS,SAAS;GAC9B,aAAa;GACb,YAAY;GACb,CAAC;GACF;AAEF,QAAO"}
+{"version":3,"file":"clean.mjs","names":[],"sources":["../../src/api/clean.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 { ExecutionContext } from \"@powerlines/core\";\nimport { executeEnvironments } from \"@powerlines/core/lib/environment\";\nimport { joinPaths } from \"@stryke/path/join\";\nimport { EngineResolvedConfig } from \"../types/config\";\nimport { EngineSystemContext } from \"../types/context\";\nimport { prepare } from \"./prepare\";\n\n/**\n * Clean any previously prepared artifacts\n *\n * @param context - The execution context for the clean process, which provides access to the project configuration, environment, and utility functions for performing the clean operation. The context is used to manage the state and behavior of the clean process, allowing for hooks to be called at different stages of the clean and for environment-specific configurations to be applied.\n */\nexport async function clean<\n  TResolvedConfig extends EngineResolvedConfig,\n  TSystemContext extends EngineSystemContext\n>(context: ExecutionContext<TResolvedConfig, TSystemContext>) {\n  const timer = context.timer(\"Cleaning\");\n\n  await prepare<TResolvedConfig, TSystemContext>(context, true);\n  await executeEnvironments(context, async env => {\n    env.debug(\"Cleaning the project's dist and artifacts directories.\");\n\n    await env.fs.remove(joinPaths(env.config.cwd, env.config.output.path));\n    await env.fs.remove(\n      joinPaths(\n        env.config.cwd,\n        env.config.root,\n        env.config.output.artifactsPath\n      )\n    );\n\n    await context.callHook(\"clean\", {\n      environment: env,\n      sequential: false\n    });\n  });\n\n  timer();\n}\n"],"mappings":";;;;;;;;;;AA8BA,eAAsB,MAGpB,SAA4D;CAC5D,MAAM,QAAQ,QAAQ,MAAM,UAAU;CAEtC,MAAM,QAAyC,SAAS,IAAI;CAC5D,MAAM,oBAAoB,SAAS,OAAM,QAAO;EAC9C,IAAI,MAAM,wDAAwD;EAElE,MAAM,IAAI,GAAG,OAAO,UAAU,IAAI,OAAO,KAAK,IAAI,OAAO,OAAO,IAAI,CAAC;EACrE,MAAM,IAAI,GAAG,OACX,UACE,IAAI,OAAO,KACX,IAAI,OAAO,MACX,IAAI,OAAO,OAAO,aACpB,CACF;EAEA,MAAM,QAAQ,SAAS,SAAS;GAC9B,aAAa;GACb,YAAY;EACd,CAAC;CACH,CAAC;CAED,MAAM;AACR"}

package/dist/api/create.d.mts

@@ -1,5 +1,5 @@
-import { r as EngineResolvedConfig } from "../config-BNe23XHx.mjs";
-import { r as EngineSystemContext } from "../context-DzgsMSWr.mjs";
+import { r as EngineResolvedConfig } from "../config-C9AD-erz.mjs";
+import { r as EngineSystemContext } from "../context-S3XH2DWP.mjs";
 import { ExecutionContext } from "@powerlines/core";
 
 //#region src/api/create.d.ts

package/dist/api/create.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"create.mjs","names":[],"sources":["../../src/api/create.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 { ExecutionContext } from \"@powerlines/core\";\nimport { executeEnvironments } from \"@powerlines/core/lib/environment\";\nimport { listFiles } from \"@stryke/fs/list-files\";\nimport { joinPaths } from \"@stryke/path/join\";\nimport Handlebars from \"handlebars\";\nimport { EngineResolvedConfig } from \"../types/config\";\nimport { EngineSystemContext } from \"../types/context\";\nimport { prepare } from \"./prepare\";\n\n/**\n * Create a new Powerlines project\n *\n * @param context - The execution context for the create process, which provides access to the project configuration, environment, and utility functions for performing the create operation. The context is used to manage the state and behavior of the create process, allowing for hooks to be called at different stages of the create and for environment-specific configurations to be applied.\n */\nexport async function create<\n  TResolvedConfig extends EngineResolvedConfig,\n  TSystemContext extends EngineSystemContext\n>(context: ExecutionContext<TResolvedConfig, TSystemContext>) {\n  const timer = context.timer(\"Create a New Project Generation\");\n\n  await prepare<TResolvedConfig, TSystemContext>(context, true);\n  await executeEnvironments(context, async env => {\n    env.debug(\"Initializing the processing options for the project.\");\n\n    await context.callHook(\"create\", {\n      environment: env,\n      order: \"pre\"\n    });\n\n    const files = await listFiles(\n      joinPaths(env.powerlinesPath, \"files/common/**/*.hbs\")\n    );\n    for (const file of files) {\n      env.trace(`Adding template file to project: ${file}`);\n\n      const template = Handlebars.compile(file);\n      await env.fs.write(\n        joinPaths(env.config.root, file.replace(\".hbs\", \"\")),\n        template(env)\n      );\n    }\n\n    await context.callHook(\"create\", {\n      environment: env,\n      order: \"normal\"\n    });\n\n    if (env.config.projectType === \"application\") {\n      const appFiles = await listFiles(\n        joinPaths(env.powerlinesPath, \"files/application/**/*.hbs\")\n      );\n      for (const file of appFiles) {\n        env.trace(`Adding application template file: ${file}`);\n\n        const template = Handlebars.compile(file);\n        await env.fs.write(\n          joinPaths(env.config.root, file.replace(\".hbs\", \"\")),\n          template(env)\n        );\n      }\n    } else {\n      const libFiles = await listFiles(\n        joinPaths(env.powerlinesPath, \"files/library/**/*.hbs\")\n      );\n      for (const file of libFiles) {\n        env.trace(`Adding library template file: ${file}`);\n\n        const template = Handlebars.compile(file);\n        await env.fs.write(\n          joinPaths(env.config.root, file.replace(\".hbs\", \"\")),\n          template(env)\n        );\n      }\n    }\n\n    await context.callHook(\"create\", {\n      environment: env,\n      order: \"post\"\n    });\n  });\n\n  timer();\n}\n"],"mappings":";;;;;;;;;;;;AAgCA,eAAsB,OAGpB,SAA4D;CAC5D,MAAM,QAAQ,QAAQ,MAAM,kCAAkC;AAE9D,OAAM,QAAyC,SAAS,KAAK;AAC7D,OAAM,oBAAoB,SAAS,OAAM,QAAO;AAC9C,MAAI,MAAM,uDAAuD;AAEjE,QAAM,QAAQ,SAAS,UAAU;GAC/B,aAAa;GACb,OAAO;GACR,CAAC;EAEF,MAAM,QAAQ,MAAM,UAClB,UAAU,IAAI,gBAAgB,wBAAwB,CACvD;AACD,OAAK,MAAM,QAAQ,OAAO;AACxB,OAAI,MAAM,oCAAoC,OAAO;GAErD,MAAM,WAAW,WAAW,QAAQ,KAAK;AACzC,SAAM,IAAI,GAAG,MACX,UAAU,IAAI,OAAO,MAAM,KAAK,QAAQ,QAAQ,GAAG,CAAC,EACpD,SAAS,IAAI,CACd;;AAGH,QAAM,QAAQ,SAAS,UAAU;GAC/B,aAAa;GACb,OAAO;GACR,CAAC;AAEF,MAAI,IAAI,OAAO,gBAAgB,eAAe;GAC5C,MAAM,WAAW,MAAM,UACrB,UAAU,IAAI,gBAAgB,6BAA6B,CAC5D;AACD,QAAK,MAAM,QAAQ,UAAU;AAC3B,QAAI,MAAM,qCAAqC,OAAO;IAEtD,MAAM,WAAW,WAAW,QAAQ,KAAK;AACzC,UAAM,IAAI,GAAG,MACX,UAAU,IAAI,OAAO,MAAM,KAAK,QAAQ,QAAQ,GAAG,CAAC,EACpD,SAAS,IAAI,CACd;;SAEE;GACL,MAAM,WAAW,MAAM,UACrB,UAAU,IAAI,gBAAgB,yBAAyB,CACxD;AACD,QAAK,MAAM,QAAQ,UAAU;AAC3B,QAAI,MAAM,iCAAiC,OAAO;IAElD,MAAM,WAAW,WAAW,QAAQ,KAAK;AACzC,UAAM,IAAI,GAAG,MACX,UAAU,IAAI,OAAO,MAAM,KAAK,QAAQ,QAAQ,GAAG,CAAC,EACpD,SAAS,IAAI,CACd;;;AAIL,QAAM,QAAQ,SAAS,UAAU;GAC/B,aAAa;GACb,OAAO;GACR,CAAC;GACF;AAEF,QAAO"}
+{"version":3,"file":"create.mjs","names":[],"sources":["../../src/api/create.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 { ExecutionContext } from \"@powerlines/core\";\nimport { executeEnvironments } from \"@powerlines/core/lib/environment\";\nimport { listFiles } from \"@stryke/fs/list-files\";\nimport { joinPaths } from \"@stryke/path/join\";\nimport Handlebars from \"handlebars\";\nimport { EngineResolvedConfig } from \"../types/config\";\nimport { EngineSystemContext } from \"../types/context\";\nimport { prepare } from \"./prepare\";\n\n/**\n * Create a new Powerlines project\n *\n * @param context - The execution context for the create process, which provides access to the project configuration, environment, and utility functions for performing the create operation. The context is used to manage the state and behavior of the create process, allowing for hooks to be called at different stages of the create and for environment-specific configurations to be applied.\n */\nexport async function create<\n  TResolvedConfig extends EngineResolvedConfig,\n  TSystemContext extends EngineSystemContext\n>(context: ExecutionContext<TResolvedConfig, TSystemContext>) {\n  const timer = context.timer(\"Create a New Project Generation\");\n\n  await prepare<TResolvedConfig, TSystemContext>(context, true);\n  await executeEnvironments(context, async env => {\n    env.debug(\"Initializing the processing options for the project.\");\n\n    await context.callHook(\"create\", {\n      environment: env,\n      order: \"pre\"\n    });\n\n    const files = await listFiles(\n      joinPaths(env.powerlinesPath, \"files/common/**/*.hbs\")\n    );\n    for (const file of files) {\n      env.trace(`Adding template file to project: ${file}`);\n\n      const template = Handlebars.compile(file);\n      await env.fs.write(\n        joinPaths(env.config.root, file.replace(\".hbs\", \"\")),\n        template(env)\n      );\n    }\n\n    await context.callHook(\"create\", {\n      environment: env,\n      order: \"normal\"\n    });\n\n    if (env.config.projectType === \"application\") {\n      const appFiles = await listFiles(\n        joinPaths(env.powerlinesPath, \"files/application/**/*.hbs\")\n      );\n      for (const file of appFiles) {\n        env.trace(`Adding application template file: ${file}`);\n\n        const template = Handlebars.compile(file);\n        await env.fs.write(\n          joinPaths(env.config.root, file.replace(\".hbs\", \"\")),\n          template(env)\n        );\n      }\n    } else {\n      const libFiles = await listFiles(\n        joinPaths(env.powerlinesPath, \"files/library/**/*.hbs\")\n      );\n      for (const file of libFiles) {\n        env.trace(`Adding library template file: ${file}`);\n\n        const template = Handlebars.compile(file);\n        await env.fs.write(\n          joinPaths(env.config.root, file.replace(\".hbs\", \"\")),\n          template(env)\n        );\n      }\n    }\n\n    await context.callHook(\"create\", {\n      environment: env,\n      order: \"post\"\n    });\n  });\n\n  timer();\n}\n"],"mappings":";;;;;;;;;;;;AAgCA,eAAsB,OAGpB,SAA4D;CAC5D,MAAM,QAAQ,QAAQ,MAAM,iCAAiC;CAE7D,MAAM,QAAyC,SAAS,IAAI;CAC5D,MAAM,oBAAoB,SAAS,OAAM,QAAO;EAC9C,IAAI,MAAM,sDAAsD;EAEhE,MAAM,QAAQ,SAAS,UAAU;GAC/B,aAAa;GACb,OAAO;EACT,CAAC;EAED,MAAM,QAAQ,MAAM,UAClB,UAAU,IAAI,gBAAgB,uBAAuB,CACvD;EACA,KAAK,MAAM,QAAQ,OAAO;GACxB,IAAI,MAAM,oCAAoC,MAAM;GAEpD,MAAM,WAAW,WAAW,QAAQ,IAAI;GACxC,MAAM,IAAI,GAAG,MACX,UAAU,IAAI,OAAO,MAAM,KAAK,QAAQ,QAAQ,EAAE,CAAC,GACnD,SAAS,GAAG,CACd;EACF;EAEA,MAAM,QAAQ,SAAS,UAAU;GAC/B,aAAa;GACb,OAAO;EACT,CAAC;EAED,IAAI,IAAI,OAAO,gBAAgB,eAAe;GAC5C,MAAM,WAAW,MAAM,UACrB,UAAU,IAAI,gBAAgB,4BAA4B,CAC5D;GACA,KAAK,MAAM,QAAQ,UAAU;IAC3B,IAAI,MAAM,qCAAqC,MAAM;IAErD,MAAM,WAAW,WAAW,QAAQ,IAAI;IACxC,MAAM,IAAI,GAAG,MACX,UAAU,IAAI,OAAO,MAAM,KAAK,QAAQ,QAAQ,EAAE,CAAC,GACnD,SAAS,GAAG,CACd;GACF;EACF,OAAO;GACL,MAAM,WAAW,MAAM,UACrB,UAAU,IAAI,gBAAgB,wBAAwB,CACxD;GACA,KAAK,MAAM,QAAQ,UAAU;IAC3B,IAAI,MAAM,iCAAiC,MAAM;IAEjD,MAAM,WAAW,WAAW,QAAQ,IAAI;IACxC,MAAM,IAAI,GAAG,MACX,UAAU,IAAI,OAAO,MAAM,KAAK,QAAQ,QAAQ,EAAE,CAAC,GACnD,SAAS,GAAG,CACd;GACF;EACF;EAEA,MAAM,QAAQ,SAAS,UAAU;GAC/B,aAAa;GACb,OAAO;EACT,CAAC;CACH,CAAC;CAED,MAAM;AACR"}

package/dist/api/deploy.d.mts

@@ -1,5 +1,5 @@
-import { r as EngineResolvedConfig } from "../config-BNe23XHx.mjs";
-import { r as EngineSystemContext } from "../context-DzgsMSWr.mjs";
+import { r as EngineResolvedConfig } from "../config-C9AD-erz.mjs";
+import { r as EngineSystemContext } from "../context-S3XH2DWP.mjs";
 import { ExecutionContext } from "@powerlines/core";
 
 //#region src/api/deploy.d.ts

package/dist/api/deploy.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"deploy.mjs","names":[],"sources":["../../src/api/deploy.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 { ExecutionContext } from \"@powerlines/core\";\nimport { executeEnvironments } from \"@powerlines/core/lib/environment\";\nimport { EngineResolvedConfig } from \"../types/config\";\nimport { EngineSystemContext } from \"../types/context\";\nimport { prepare } from \"./prepare\";\n\n/**\n * Deploy the project's source files to the target environment.\n *\n * @remarks\n * This function serves as the main entry point for the deployment process, orchestrating the execution of deployment hooks across different environments defined in the project configuration. It ensures that all relevant deployment operations are performed in a structured manner, allowing for pre-deployment, main deployment, and post-deployment hooks to be executed at the appropriate stages of the process. The function also utilizes a timer to measure the duration of the deployment operation, providing insights into the performance of the deployment process.\n *\n * @param context - The execution context for the deploy process, which provides access to the project configuration, environment, and utility functions for performing the deploy operation. The context is used to manage the state and behavior of the deploy process, allowing for hooks to be called at different stages of the deploy and for environment-specific configurations to be applied.\n */\nexport async function deploy<\n  TResolvedConfig extends EngineResolvedConfig,\n  TSystemContext extends EngineSystemContext\n>(context: ExecutionContext<TResolvedConfig, TSystemContext>) {\n  const timer = context.timer(\"Deployment\");\n\n  await prepare<TResolvedConfig, TSystemContext>(context);\n  await executeEnvironments(context, async env => {\n    await context.callHook(\"deploy\", {\n      environment: env\n    });\n  });\n\n  timer();\n}\n"],"mappings":";;;;;;;;;;;;AAgCA,eAAsB,OAGpB,SAA4D;CAC5D,MAAM,QAAQ,QAAQ,MAAM,aAAa;AAEzC,OAAM,QAAyC,QAAQ;AACvD,OAAM,oBAAoB,SAAS,OAAM,QAAO;AAC9C,QAAM,QAAQ,SAAS,UAAU,EAC/B,aAAa,KACd,CAAC;GACF;AAEF,QAAO"}
+{"version":3,"file":"deploy.mjs","names":[],"sources":["../../src/api/deploy.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 { ExecutionContext } from \"@powerlines/core\";\nimport { executeEnvironments } from \"@powerlines/core/lib/environment\";\nimport { EngineResolvedConfig } from \"../types/config\";\nimport { EngineSystemContext } from \"../types/context\";\nimport { prepare } from \"./prepare\";\n\n/**\n * Deploy the project's source files to the target environment.\n *\n * @remarks\n * This function serves as the main entry point for the deployment process, orchestrating the execution of deployment hooks across different environments defined in the project configuration. It ensures that all relevant deployment operations are performed in a structured manner, allowing for pre-deployment, main deployment, and post-deployment hooks to be executed at the appropriate stages of the process. The function also utilizes a timer to measure the duration of the deployment operation, providing insights into the performance of the deployment process.\n *\n * @param context - The execution context for the deploy process, which provides access to the project configuration, environment, and utility functions for performing the deploy operation. The context is used to manage the state and behavior of the deploy process, allowing for hooks to be called at different stages of the deploy and for environment-specific configurations to be applied.\n */\nexport async function deploy<\n  TResolvedConfig extends EngineResolvedConfig,\n  TSystemContext extends EngineSystemContext\n>(context: ExecutionContext<TResolvedConfig, TSystemContext>) {\n  const timer = context.timer(\"Deployment\");\n\n  await prepare<TResolvedConfig, TSystemContext>(context);\n  await executeEnvironments(context, async env => {\n    await context.callHook(\"deploy\", {\n      environment: env\n    });\n  });\n\n  timer();\n}\n"],"mappings":";;;;;;;;;;;;AAgCA,eAAsB,OAGpB,SAA4D;CAC5D,MAAM,QAAQ,QAAQ,MAAM,YAAY;CAExC,MAAM,QAAyC,OAAO;CACtD,MAAM,oBAAoB,SAAS,OAAM,QAAO;EAC9C,MAAM,QAAQ,SAAS,UAAU,EAC/B,aAAa,IACf,CAAC;CACH,CAAC;CAED,MAAM;AACR"}

package/dist/api/docs.d.mts

@@ -1,5 +1,5 @@
-import { r as EngineResolvedConfig } from "../config-BNe23XHx.mjs";
-import { r as EngineSystemContext } from "../context-DzgsMSWr.mjs";
+import { r as EngineResolvedConfig } from "../config-C9AD-erz.mjs";
+import { r as EngineSystemContext } from "../context-S3XH2DWP.mjs";
 import { ExecutionContext } from "@powerlines/core";
 
 //#region src/api/docs.d.ts

package/dist/api/docs.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"docs.mjs","names":[],"sources":["../../src/api/docs.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 { ExecutionContext } from \"@powerlines/core\";\nimport { executeEnvironments } from \"@powerlines/core/lib/environment\";\nimport { EngineResolvedConfig } from \"../types/config\";\nimport { EngineSystemContext } from \"../types/context\";\nimport { prepare } from \"./prepare\";\n\n/**\n * Generate the project's documentation.\n *\n * @remarks\n * This function serves as the main entry point for the documentation generation process, orchestrating the execution of documentation hooks across different environments defined in the project configuration. It ensures that all relevant documentation operations are performed in a structured manner, allowing for pre-documentation, main documentation, and post-documentation hooks to be executed at the appropriate stages of the process. The function also utilizes a timer to measure the duration of the documentation operation, providing insights into the performance of the documentation process.\n *\n * @param context - The execution context for the documentation process, which provides access to the project configuration, environment, and utility functions for performing the documentation operation. The context is used to manage the state and behavior of the documentation process, allowing for hooks to be called at different stages of the documentation and for environment-specific configurations to be applied.\n */\nexport async function docs<\n  TResolvedConfig extends EngineResolvedConfig,\n  TSystemContext extends EngineSystemContext\n>(context: ExecutionContext<TResolvedConfig, TSystemContext>) {\n  const timer = context.timer(\"Documentation\");\n\n  await prepare<TResolvedConfig, TSystemContext>(context);\n  await executeEnvironments(context, async env => {\n    await context.callHook(\"docs\", {\n      environment: env\n    });\n  });\n\n  timer();\n}\n"],"mappings":";;;;;;;;;;;;AAgCA,eAAsB,KAGpB,SAA4D;CAC5D,MAAM,QAAQ,QAAQ,MAAM,gBAAgB;AAE5C,OAAM,QAAyC,QAAQ;AACvD,OAAM,oBAAoB,SAAS,OAAM,QAAO;AAC9C,QAAM,QAAQ,SAAS,QAAQ,EAC7B,aAAa,KACd,CAAC;GACF;AAEF,QAAO"}
+{"version":3,"file":"docs.mjs","names":[],"sources":["../../src/api/docs.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 { ExecutionContext } from \"@powerlines/core\";\nimport { executeEnvironments } from \"@powerlines/core/lib/environment\";\nimport { EngineResolvedConfig } from \"../types/config\";\nimport { EngineSystemContext } from \"../types/context\";\nimport { prepare } from \"./prepare\";\n\n/**\n * Generate the project's documentation.\n *\n * @remarks\n * This function serves as the main entry point for the documentation generation process, orchestrating the execution of documentation hooks across different environments defined in the project configuration. It ensures that all relevant documentation operations are performed in a structured manner, allowing for pre-documentation, main documentation, and post-documentation hooks to be executed at the appropriate stages of the process. The function also utilizes a timer to measure the duration of the documentation operation, providing insights into the performance of the documentation process.\n *\n * @param context - The execution context for the documentation process, which provides access to the project configuration, environment, and utility functions for performing the documentation operation. The context is used to manage the state and behavior of the documentation process, allowing for hooks to be called at different stages of the documentation and for environment-specific configurations to be applied.\n */\nexport async function docs<\n  TResolvedConfig extends EngineResolvedConfig,\n  TSystemContext extends EngineSystemContext\n>(context: ExecutionContext<TResolvedConfig, TSystemContext>) {\n  const timer = context.timer(\"Documentation\");\n\n  await prepare<TResolvedConfig, TSystemContext>(context);\n  await executeEnvironments(context, async env => {\n    await context.callHook(\"docs\", {\n      environment: env\n    });\n  });\n\n  timer();\n}\n"],"mappings":";;;;;;;;;;;;AAgCA,eAAsB,KAGpB,SAA4D;CAC5D,MAAM,QAAQ,QAAQ,MAAM,eAAe;CAE3C,MAAM,QAAyC,OAAO;CACtD,MAAM,oBAAoB,SAAS,OAAM,QAAO;EAC9C,MAAM,QAAQ,SAAS,QAAQ,EAC7B,aAAa,IACf,CAAC;CACH,CAAC;CAED,MAAM;AACR"}

package/dist/api/lint.d.mts

@@ -1,5 +1,5 @@
-import { r as EngineResolvedConfig } from "../config-BNe23XHx.mjs";
-import { r as EngineSystemContext } from "../context-DzgsMSWr.mjs";
+import { r as EngineResolvedConfig } from "../config-C9AD-erz.mjs";
+import { r as EngineSystemContext } from "../context-S3XH2DWP.mjs";
 import { ExecutionContext } from "@powerlines/core";
 
 //#region src/api/lint.d.ts

package/dist/api/lint.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"lint.mjs","names":[],"sources":["../../src/api/lint.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 { ExecutionContext } from \"@powerlines/core\";\nimport { executeEnvironments } from \"@powerlines/core/lib/environment\";\nimport { EngineResolvedConfig } from \"../types/config\";\nimport { EngineSystemContext } from \"../types/context\";\nimport { prepare } from \"./prepare\";\n\n/**\n * Lint the project's source files and report any issues found.\n *\n * @remarks\n * This function serves as the main entry point for the linting process, orchestrating the execution of linting hooks across different environments defined in the project configuration. It ensures that all relevant linting operations are performed in a structured manner, allowing for pre-linting, main linting, and post-linting hooks to be executed at the appropriate stages of the process. The function also utilizes a timer to measure the duration of the linting operation, providing insights into the performance of the linting process.\n *\n * @param context - The execution context for the lint process, which provides access to the project configuration, environment, and utility functions for performing the lint operation. The context is used to manage the state and behavior of the lint process, allowing for hooks to be called at different stages of the lint and for environment-specific configurations to be applied.\n */\nexport async function lint<\n  TResolvedConfig extends EngineResolvedConfig,\n  TSystemContext extends EngineSystemContext\n>(context: ExecutionContext<TResolvedConfig, TSystemContext>) {\n  const timer = context.timer(\"Linting\");\n\n  await prepare<TResolvedConfig, TSystemContext>(context);\n  await executeEnvironments(context, async env => {\n    await context.callHook(\"lint\", {\n      environment: env,\n      sequential: false\n    });\n  });\n\n  timer();\n}\n"],"mappings":";;;;;;;;;;;;AAgCA,eAAsB,KAGpB,SAA4D;CAC5D,MAAM,QAAQ,QAAQ,MAAM,UAAU;AAEtC,OAAM,QAAyC,QAAQ;AACvD,OAAM,oBAAoB,SAAS,OAAM,QAAO;AAC9C,QAAM,QAAQ,SAAS,QAAQ;GAC7B,aAAa;GACb,YAAY;GACb,CAAC;GACF;AAEF,QAAO"}
+{"version":3,"file":"lint.mjs","names":[],"sources":["../../src/api/lint.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 { ExecutionContext } from \"@powerlines/core\";\nimport { executeEnvironments } from \"@powerlines/core/lib/environment\";\nimport { EngineResolvedConfig } from \"../types/config\";\nimport { EngineSystemContext } from \"../types/context\";\nimport { prepare } from \"./prepare\";\n\n/**\n * Lint the project's source files and report any issues found.\n *\n * @remarks\n * This function serves as the main entry point for the linting process, orchestrating the execution of linting hooks across different environments defined in the project configuration. It ensures that all relevant linting operations are performed in a structured manner, allowing for pre-linting, main linting, and post-linting hooks to be executed at the appropriate stages of the process. The function also utilizes a timer to measure the duration of the linting operation, providing insights into the performance of the linting process.\n *\n * @param context - The execution context for the lint process, which provides access to the project configuration, environment, and utility functions for performing the lint operation. The context is used to manage the state and behavior of the lint process, allowing for hooks to be called at different stages of the lint and for environment-specific configurations to be applied.\n */\nexport async function lint<\n  TResolvedConfig extends EngineResolvedConfig,\n  TSystemContext extends EngineSystemContext\n>(context: ExecutionContext<TResolvedConfig, TSystemContext>) {\n  const timer = context.timer(\"Linting\");\n\n  await prepare<TResolvedConfig, TSystemContext>(context);\n  await executeEnvironments(context, async env => {\n    await context.callHook(\"lint\", {\n      environment: env,\n      sequential: false\n    });\n  });\n\n  timer();\n}\n"],"mappings":";;;;;;;;;;;;AAgCA,eAAsB,KAGpB,SAA4D;CAC5D,MAAM,QAAQ,QAAQ,MAAM,SAAS;CAErC,MAAM,QAAyC,OAAO;CACtD,MAAM,oBAAoB,SAAS,OAAM,QAAO;EAC9C,MAAM,QAAQ,SAAS,QAAQ;GAC7B,aAAa;GACb,YAAY;EACd,CAAC;CACH,CAAC;CAED,MAAM;AACR"}

package/dist/api/prepare.cjs

@@ -1,13 +1,13 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const require_chunk = require('../chunk-C0xms8kb.cjs');
-let _powerlines_core_plugin_utils = require("@powerlines/core/plugin-utils");
-let _stryke_convert_to_array = require("@stryke/convert/to-array");
 let _powerlines_core_lib_environment = require("@powerlines/core/lib/environment");
 let _powerlines_core_lib_generate_types = require("@powerlines/core/lib/generate-types");
 let _powerlines_core_lib_install_dependencies = require("@powerlines/core/lib/install-dependencies");
 let _powerlines_core_lib_meta = require("@powerlines/core/lib/meta");
 let _powerlines_core_lib_typescript_tsconfig = require("@powerlines/core/lib/typescript/tsconfig");
 let _powerlines_core_lib_utilities_format = require("@powerlines/core/lib/utilities/format");
+let _powerlines_core_plugin_utils = require("@powerlines/core/plugin-utils");
+let _stryke_convert_to_array = require("@stryke/convert/to-array");
 let _stryke_fs_helpers = require("@stryke/fs/helpers");
 let _stryke_type_checks_is_object = require("@stryke/type-checks/is-object");
 

package/dist/api/prepare.d.mts

@@ -1,5 +1,5 @@
-import { r as EngineResolvedConfig } from "../config-BNe23XHx.mjs";
-import { r as EngineSystemContext } from "../context-DzgsMSWr.mjs";
+import { r as EngineResolvedConfig } from "../config-C9AD-erz.mjs";
+import { r as EngineSystemContext } from "../context-S3XH2DWP.mjs";
 import { ExecutionContext } from "@powerlines/core";
 
 //#region src/api/prepare.d.ts

package/dist/api/prepare.mjs

@@ -1,11 +1,11 @@
-import { formatConfig } from "@powerlines/core/plugin-utils";
-import { toArray } from "@stryke/convert/to-array";
 import { executeEnvironments } from "@powerlines/core/lib/environment";
 import { handleTypes } from "@powerlines/core/lib/generate-types";
 import { installDependencies } from "@powerlines/core/lib/install-dependencies";
 import { writeMetaFile } from "@powerlines/core/lib/meta";
 import { initializeTsconfig, resolveTsconfig } from "@powerlines/core/lib/typescript/tsconfig";
 import { formatFolder } from "@powerlines/core/lib/utilities/format";
+import { formatConfig } from "@powerlines/core/plugin-utils";
+import { toArray } from "@stryke/convert/to-array";
 import { createDirectory } from "@stryke/fs/helpers";
 import { isObject } from "@stryke/type-checks/is-object";
 

package/dist/api/prepare.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"prepare.mjs","names":[],"sources":["../../src/api/prepare.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                   ⚡ Storm Software - Powerlines\n\n This code was released as part of the Powerlines project. Powerlines\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/powerlines.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/powerlines\n Documentation:            https://docs.stormsoftware.com/projects/powerlines\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport type { ExecutionContext } from \"@powerlines/core\";\nimport { executeEnvironments } from \"@powerlines/core/lib/environment\";\nimport { handleTypes } from \"@powerlines/core/lib/generate-types\";\nimport { installDependencies } from \"@powerlines/core/lib/install-dependencies\";\nimport { writeMetaFile } from \"@powerlines/core/lib/meta\";\nimport {\n  initializeTsconfig,\n  resolveTsconfig\n} from \"@powerlines/core/lib/typescript/tsconfig\";\nimport { formatFolder } from \"@powerlines/core/lib/utilities/format\";\nimport { formatConfig } from \"@powerlines/core/plugin-utils\";\nimport { toArray } from \"@stryke/convert/to-array\";\nimport { createDirectory } from \"@stryke/fs/helpers\";\nimport { isObject } from \"@stryke/type-checks/is-object\";\nimport { EngineResolvedConfig } from \"../types/config\";\nimport { EngineSystemContext } from \"../types/context\";\n\n/**\n * Prepare the project\n *\n * @param context - The execution context for the build process, which provides access to the project configuration, environment, and utility functions for performing the build. The context is used to manage the state and behavior of the build process, allowing for hooks to be called at different stages of the build and for environment-specific configurations to be applied.\n */\nexport async function prepare<\n  TResolvedConfig extends EngineResolvedConfig,\n  TSystemContext extends EngineSystemContext\n>(\n  context: ExecutionContext<TResolvedConfig, TSystemContext>,\n  skipTypes = false\n) {\n  const timer = context.timer(\"Preparation\");\n\n  await executeEnvironments(context, async env => {\n    env.debug(\n      `Initializing the processing options for the Powerlines project.`\n    );\n\n    await context.callHook(\"configResolved\", {\n      environment: env,\n      order: \"pre\"\n    });\n\n    await initializeTsconfig<TResolvedConfig, TSystemContext>(env);\n\n    await context.callHook(\"configResolved\", {\n      environment: env,\n      order: \"normal\"\n    });\n\n    if (env.entry.length > 0) {\n      env.debug(\n        `The configuration provided ${\n          isObject(env.config.input)\n            ? Object.keys(env.config.input).length\n            : toArray(env.config.input).length\n        } entry point(s), Powerlines has found ${\n          env.entry.length\n        } entry files(s) for the ${env.config.title} project${\n          env.entry.length > 0 && env.entry.length < 10\n            ? `: \\n${env.entry\n                .map(\n                  entry =>\n                    `- ${entry.file}${\n                      entry.output ? ` -> ${entry.output}` : \"\"\n                    }`\n                )\n                .join(\" \\n\")}`\n            : \"\"\n        }`\n      );\n    } else {\n      env.warn(\n        `No entry files were found for the ${\n          env.config.title\n        } project. Please ensure this is correct. Powerlines plugins generally require at least one entry point to function properly.`\n      );\n    }\n\n    await resolveTsconfig<TResolvedConfig, TSystemContext>(env);\n    await installDependencies(env);\n\n    await context.callHook(\"configResolved\", {\n      environment: env,\n      order: \"post\"\n    });\n\n    env.trace({\n      meta: {\n        category: \"config\"\n      },\n      message: `Powerlines configuration after configResolved hook: \\n${formatConfig(\n        env.config\n      )}`\n    });\n\n    if (!env.fs.existsSync(env.cachePath)) {\n      await createDirectory(env.cachePath);\n    }\n\n    if (!env.fs.existsSync(env.dataPath)) {\n      await createDirectory(env.dataPath);\n    }\n\n    await context.callHook(\"prepare\", {\n      environment: env,\n      order: \"pre\"\n    });\n    await context.callHook(\"prepare\", {\n      environment: env,\n      order: \"normal\"\n    });\n\n    await context.callHook(\"prepare\", {\n      environment: env,\n      order: \"post\"\n    });\n\n    if (!skipTypes && env.config.output.types !== false) {\n      await handleTypes(context, env);\n    }\n\n    context.debug(\"Formatting files generated during the prepare step.\");\n\n    await Promise.all([\n      formatFolder(env, env.builtinsPath),\n      formatFolder(env, env.entryPath)\n    ]);\n\n    await writeMetaFile(env);\n    env.persistedMeta = env.meta;\n  });\n\n  timer();\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AAwCA,eAAsB,QAIpB,SACA,YAAY,OACZ;CACA,MAAM,QAAQ,QAAQ,MAAM,cAAc;AAE1C,OAAM,oBAAoB,SAAS,OAAM,QAAO;AAC9C,MAAI,MACF,kEACD;AAED,QAAM,QAAQ,SAAS,kBAAkB;GACvC,aAAa;GACb,OAAO;GACR,CAAC;AAEF,QAAM,mBAAoD,IAAI;AAE9D,QAAM,QAAQ,SAAS,kBAAkB;GACvC,aAAa;GACb,OAAO;GACR,CAAC;AAEF,MAAI,IAAI,MAAM,SAAS,EACrB,KAAI,MACF,8BACE,SAAS,IAAI,OAAO,MAAM,GACtB,OAAO,KAAK,IAAI,OAAO,MAAM,CAAC,SAC9B,QAAQ,IAAI,OAAO,MAAM,CAAC,OAC/B,wCACC,IAAI,MAAM,OACX,0BAA0B,IAAI,OAAO,MAAM,UAC1C,IAAI,MAAM,SAAS,KAAK,IAAI,MAAM,SAAS,KACvC,OAAO,IAAI,MACR,KACC,UACE,KAAK,MAAM,OACT,MAAM,SAAS,OAAO,MAAM,WAAW,KAE5C,CACA,KAAK,MAAM,KACd,KAEP;MAED,KAAI,KACF,qCACE,IAAI,OAAO,MACZ,8HACF;AAGH,QAAM,gBAAiD,IAAI;AAC3D,QAAM,oBAAoB,IAAI;AAE9B,QAAM,QAAQ,SAAS,kBAAkB;GACvC,aAAa;GACb,OAAO;GACR,CAAC;AAEF,MAAI,MAAM;GACR,MAAM,EACJ,UAAU,UACX;GACD,SAAS,yDAAyD,aAChE,IAAI,OACL;GACF,CAAC;AAEF,MAAI,CAAC,IAAI,GAAG,WAAW,IAAI,UAAU,CACnC,OAAM,gBAAgB,IAAI,UAAU;AAGtC,MAAI,CAAC,IAAI,GAAG,WAAW,IAAI,SAAS,CAClC,OAAM,gBAAgB,IAAI,SAAS;AAGrC,QAAM,QAAQ,SAAS,WAAW;GAChC,aAAa;GACb,OAAO;GACR,CAAC;AACF,QAAM,QAAQ,SAAS,WAAW;GAChC,aAAa;GACb,OAAO;GACR,CAAC;AAEF,QAAM,QAAQ,SAAS,WAAW;GAChC,aAAa;GACb,OAAO;GACR,CAAC;AAEF,MAAI,CAAC,aAAa,IAAI,OAAO,OAAO,UAAU,MAC5C,OAAM,YAAY,SAAS,IAAI;AAGjC,UAAQ,MAAM,sDAAsD;AAEpE,QAAM,QAAQ,IAAI,CAChB,aAAa,KAAK,IAAI,aAAa,EACnC,aAAa,KAAK,IAAI,UAAU,CACjC,CAAC;AAEF,QAAM,cAAc,IAAI;AACxB,MAAI,gBAAgB,IAAI;GACxB;AAEF,QAAO"}
+{"version":3,"file":"prepare.mjs","names":[],"sources":["../../src/api/prepare.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                   ⚡ Storm Software - Powerlines\n\n This code was released as part of the Powerlines project. Powerlines\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/powerlines.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/powerlines\n Documentation:            https://docs.stormsoftware.com/projects/powerlines\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport type { ExecutionContext } from \"@powerlines/core\";\nimport { executeEnvironments } from \"@powerlines/core/lib/environment\";\nimport { handleTypes } from \"@powerlines/core/lib/generate-types\";\nimport { installDependencies } from \"@powerlines/core/lib/install-dependencies\";\nimport { writeMetaFile } from \"@powerlines/core/lib/meta\";\nimport {\n  initializeTsconfig,\n  resolveTsconfig\n} from \"@powerlines/core/lib/typescript/tsconfig\";\nimport { formatFolder } from \"@powerlines/core/lib/utilities/format\";\nimport { formatConfig } from \"@powerlines/core/plugin-utils\";\nimport { toArray } from \"@stryke/convert/to-array\";\nimport { createDirectory } from \"@stryke/fs/helpers\";\nimport { isObject } from \"@stryke/type-checks/is-object\";\nimport { EngineResolvedConfig } from \"../types/config\";\nimport { EngineSystemContext } from \"../types/context\";\n\n/**\n * Prepare the project\n *\n * @param context - The execution context for the build process, which provides access to the project configuration, environment, and utility functions for performing the build. The context is used to manage the state and behavior of the build process, allowing for hooks to be called at different stages of the build and for environment-specific configurations to be applied.\n */\nexport async function prepare<\n  TResolvedConfig extends EngineResolvedConfig,\n  TSystemContext extends EngineSystemContext\n>(\n  context: ExecutionContext<TResolvedConfig, TSystemContext>,\n  skipTypes = false\n) {\n  const timer = context.timer(\"Preparation\");\n\n  await executeEnvironments(context, async env => {\n    env.debug(\n      `Initializing the processing options for the Powerlines project.`\n    );\n\n    await context.callHook(\"configResolved\", {\n      environment: env,\n      order: \"pre\"\n    });\n\n    await initializeTsconfig<TResolvedConfig, TSystemContext>(env);\n\n    await context.callHook(\"configResolved\", {\n      environment: env,\n      order: \"normal\"\n    });\n\n    if (env.entry.length > 0) {\n      env.debug(\n        `The configuration provided ${\n          isObject(env.config.input)\n            ? Object.keys(env.config.input).length\n            : toArray(env.config.input).length\n        } entry point(s), Powerlines has found ${\n          env.entry.length\n        } entry files(s) for the ${env.config.title} project${\n          env.entry.length > 0 && env.entry.length < 10\n            ? `: \\n${env.entry\n                .map(\n                  entry =>\n                    `- ${entry.file}${\n                      entry.output ? ` -> ${entry.output}` : \"\"\n                    }`\n                )\n                .join(\" \\n\")}`\n            : \"\"\n        }`\n      );\n    } else {\n      env.warn(\n        `No entry files were found for the ${\n          env.config.title\n        } project. Please ensure this is correct. Powerlines plugins generally require at least one entry point to function properly.`\n      );\n    }\n\n    await resolveTsconfig<TResolvedConfig, TSystemContext>(env);\n    await installDependencies(env);\n\n    await context.callHook(\"configResolved\", {\n      environment: env,\n      order: \"post\"\n    });\n\n    env.trace({\n      meta: {\n        category: \"config\"\n      },\n      message: `Powerlines configuration after configResolved hook: \\n${formatConfig(\n        env.config\n      )}`\n    });\n\n    if (!env.fs.existsSync(env.cachePath)) {\n      await createDirectory(env.cachePath);\n    }\n\n    if (!env.fs.existsSync(env.dataPath)) {\n      await createDirectory(env.dataPath);\n    }\n\n    await context.callHook(\"prepare\", {\n      environment: env,\n      order: \"pre\"\n    });\n    await context.callHook(\"prepare\", {\n      environment: env,\n      order: \"normal\"\n    });\n\n    await context.callHook(\"prepare\", {\n      environment: env,\n      order: \"post\"\n    });\n\n    if (!skipTypes && env.config.output.types !== false) {\n      await handleTypes(context, env);\n    }\n\n    context.debug(\"Formatting files generated during the prepare step.\");\n\n    await Promise.all([\n      formatFolder(env, env.builtinsPath),\n      formatFolder(env, env.entryPath)\n    ]);\n\n    await writeMetaFile(env);\n    env.persistedMeta = env.meta;\n  });\n\n  timer();\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AAwCA,eAAsB,QAIpB,SACA,YAAY,OACZ;CACA,MAAM,QAAQ,QAAQ,MAAM,aAAa;CAEzC,MAAM,oBAAoB,SAAS,OAAM,QAAO;EAC9C,IAAI,MACF,iEACF;EAEA,MAAM,QAAQ,SAAS,kBAAkB;GACvC,aAAa;GACb,OAAO;EACT,CAAC;EAED,MAAM,mBAAoD,GAAG;EAE7D,MAAM,QAAQ,SAAS,kBAAkB;GACvC,aAAa;GACb,OAAO;EACT,CAAC;EAED,IAAI,IAAI,MAAM,SAAS,GACrB,IAAI,MACF,8BACE,SAAS,IAAI,OAAO,KAAK,IACrB,OAAO,KAAK,IAAI,OAAO,KAAK,EAAE,SAC9B,QAAQ,IAAI,OAAO,KAAK,EAAE,OAC/B,wCACC,IAAI,MAAM,OACX,0BAA0B,IAAI,OAAO,MAAM,UAC1C,IAAI,MAAM,SAAS,KAAK,IAAI,MAAM,SAAS,KACvC,OAAO,IAAI,MACR,KACC,UACE,KAAK,MAAM,OACT,MAAM,SAAS,OAAO,MAAM,WAAW,IAE7C,EACC,KAAK,KAAK,MACb,IAER;OAEA,IAAI,KACF,qCACE,IAAI,OAAO,MACZ,6HACH;EAGF,MAAM,gBAAiD,GAAG;EAC1D,MAAM,oBAAoB,GAAG;EAE7B,MAAM,QAAQ,SAAS,kBAAkB;GACvC,aAAa;GACb,OAAO;EACT,CAAC;EAED,IAAI,MAAM;GACR,MAAM,EACJ,UAAU,SACZ;GACA,SAAS,yDAAyD,aAChE,IAAI,MACN;EACF,CAAC;EAED,IAAI,CAAC,IAAI,GAAG,WAAW,IAAI,SAAS,GAClC,MAAM,gBAAgB,IAAI,SAAS;EAGrC,IAAI,CAAC,IAAI,GAAG,WAAW,IAAI,QAAQ,GACjC,MAAM,gBAAgB,IAAI,QAAQ;EAGpC,MAAM,QAAQ,SAAS,WAAW;GAChC,aAAa;GACb,OAAO;EACT,CAAC;EACD,MAAM,QAAQ,SAAS,WAAW;GAChC,aAAa;GACb,OAAO;EACT,CAAC;EAED,MAAM,QAAQ,SAAS,WAAW;GAChC,aAAa;GACb,OAAO;EACT,CAAC;EAED,IAAI,CAAC,aAAa,IAAI,OAAO,OAAO,UAAU,OAC5C,MAAM,YAAY,SAAS,GAAG;EAGhC,QAAQ,MAAM,qDAAqD;EAEnE,MAAM,QAAQ,IAAI,CAChB,aAAa,KAAK,IAAI,YAAY,GAClC,aAAa,KAAK,IAAI,SAAS,CACjC,CAAC;EAED,MAAM,cAAc,GAAG;EACvB,IAAI,gBAAgB,IAAI;CAC1B,CAAC;CAED,MAAM;AACR"}

package/dist/api/test.d.mts

@@ -1,5 +1,5 @@
-import { r as EngineResolvedConfig } from "../config-BNe23XHx.mjs";
-import { r as EngineSystemContext } from "../context-DzgsMSWr.mjs";
+import { r as EngineResolvedConfig } from "../config-C9AD-erz.mjs";
+import { r as EngineSystemContext } from "../context-S3XH2DWP.mjs";
 import { ExecutionContext } from "@powerlines/core";
 
 //#region src/api/test.d.ts

package/dist/api/test.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"test.mjs","names":[],"sources":["../../src/api/test.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 { ExecutionContext } from \"@powerlines/core\";\nimport { executeEnvironments } from \"@powerlines/core/lib/environment\";\nimport { EngineResolvedConfig } from \"../types/config\";\nimport { EngineSystemContext } from \"../types/context\";\nimport { prepare } from \"./prepare\";\n\n/**\n * Test the project's source files and report any issues found.\n *\n * @remarks\n * This function serves as the main entry point for the testing process, orchestrating the execution of testing hooks across different environments defined in the project configuration. It ensures that all relevant testing operations are performed in a structured manner, allowing for pre-testing, main testing, and post-testing hooks to be executed at the appropriate stages of the process. The function also utilizes a timer to measure the duration of the testing operation, providing insights into the performance of the testing process.\n *\n * @param context - The execution context for the test process, which provides access to the project configuration, environment, and utility functions for performing the test operation. The context is used to manage the state and behavior of the test process, allowing for hooks to be called at different stages of the test and for environment-specific configurations to be applied.\n */\nexport async function test<\n  TResolvedConfig extends EngineResolvedConfig,\n  TSystemContext extends EngineSystemContext\n>(context: ExecutionContext<TResolvedConfig, TSystemContext>) {\n  const timer = context.timer(\"Testing\");\n\n  await prepare(context);\n  await executeEnvironments(context, async env => {\n    await context.callHook(\"test\", {\n      environment: env,\n      sequential: false\n    });\n  });\n\n  timer();\n}\n"],"mappings":";;;;;;;;;;;;AAgCA,eAAsB,KAGpB,SAA4D;CAC5D,MAAM,QAAQ,QAAQ,MAAM,UAAU;AAEtC,OAAM,QAAQ,QAAQ;AACtB,OAAM,oBAAoB,SAAS,OAAM,QAAO;AAC9C,QAAM,QAAQ,SAAS,QAAQ;GAC7B,aAAa;GACb,YAAY;GACb,CAAC;GACF;AAEF,QAAO"}
+{"version":3,"file":"test.mjs","names":[],"sources":["../../src/api/test.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 { ExecutionContext } from \"@powerlines/core\";\nimport { executeEnvironments } from \"@powerlines/core/lib/environment\";\nimport { EngineResolvedConfig } from \"../types/config\";\nimport { EngineSystemContext } from \"../types/context\";\nimport { prepare } from \"./prepare\";\n\n/**\n * Test the project's source files and report any issues found.\n *\n * @remarks\n * This function serves as the main entry point for the testing process, orchestrating the execution of testing hooks across different environments defined in the project configuration. It ensures that all relevant testing operations are performed in a structured manner, allowing for pre-testing, main testing, and post-testing hooks to be executed at the appropriate stages of the process. The function also utilizes a timer to measure the duration of the testing operation, providing insights into the performance of the testing process.\n *\n * @param context - The execution context for the test process, which provides access to the project configuration, environment, and utility functions for performing the test operation. The context is used to manage the state and behavior of the test process, allowing for hooks to be called at different stages of the test and for environment-specific configurations to be applied.\n */\nexport async function test<\n  TResolvedConfig extends EngineResolvedConfig,\n  TSystemContext extends EngineSystemContext\n>(context: ExecutionContext<TResolvedConfig, TSystemContext>) {\n  const timer = context.timer(\"Testing\");\n\n  await prepare(context);\n  await executeEnvironments(context, async env => {\n    await context.callHook(\"test\", {\n      environment: env,\n      sequential: false\n    });\n  });\n\n  timer();\n}\n"],"mappings":";;;;;;;;;;;;AAgCA,eAAsB,KAGpB,SAA4D;CAC5D,MAAM,QAAQ,QAAQ,MAAM,SAAS;CAErC,MAAM,QAAQ,OAAO;CACrB,MAAM,oBAAoB,SAAS,OAAM,QAAO;EAC9C,MAAM,QAAQ,SAAS,QAAQ;GAC7B,aAAa;GACb,YAAY;EACd,CAAC;CACH,CAAC;CAED,MAAM;AACR"}

package/dist/api/types.cjs

@@ -1,18 +1,18 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const require_chunk = require('../chunk-C0xms8kb.cjs');
 const require_api_prepare = require('./prepare.cjs');
-let _stryke_convert_to_array = require("@stryke/convert/to-array");
-let _stryke_type_checks_is_set_object = require("@stryke/type-checks/is-set-object");
 let _powerlines_core_lib_environment = require("@powerlines/core/lib/environment");
 let _powerlines_core_lib_generate_types = require("@powerlines/core/lib/generate-types");
 let _powerlines_core_lib_install_dependencies = require("@powerlines/core/lib/install-dependencies");
 let _powerlines_core_lib_meta = require("@powerlines/core/lib/meta");
 let _powerlines_core_lib_typescript_tsconfig = require("@powerlines/core/lib/typescript/tsconfig");
 let _powerlines_core_lib_utilities_format = require("@powerlines/core/lib/utilities/format");
+let _stryke_convert_to_array = require("@stryke/convert/to-array");
 let _stryke_fs_helpers = require("@stryke/fs/helpers");
 let _stryke_type_checks_is_object = require("@stryke/type-checks/is-object");
 let _storm_software_config_tools_logger = require("@storm-software/config-tools/logger");
 let _stryke_helpers_omit = require("@stryke/helpers/omit");
+let _stryke_type_checks_is_set_object = require("@stryke/type-checks/is-set-object");
 
 //#region src/api/types.ts
 /**

package/dist/api/types.d.mts

@@ -1,5 +1,5 @@
-import { r as EngineResolvedConfig } from "../config-BNe23XHx.mjs";
-import { r as EngineSystemContext } from "../context-DzgsMSWr.mjs";
+import { r as EngineResolvedConfig } from "../config-C9AD-erz.mjs";
+import { r as EngineSystemContext } from "../context-S3XH2DWP.mjs";
 import { ExecutionContext } from "@powerlines/core/types/context";
 
 //#region src/api/types.d.ts

package/dist/api/types.mjs

@@ -1,16 +1,16 @@
 import { prepare } from "./prepare.mjs";
-import { toArray } from "@stryke/convert/to-array";
-import { isSetObject } from "@stryke/type-checks/is-set-object";
 import { executeEnvironments } from "@powerlines/core/lib/environment";
 import { handleTypes } from "@powerlines/core/lib/generate-types";
 import { installDependencies } from "@powerlines/core/lib/install-dependencies";
 import { writeMetaFile } from "@powerlines/core/lib/meta";
 import { initializeTsconfig, resolveTsconfig } from "@powerlines/core/lib/typescript/tsconfig";
 import { format } from "@powerlines/core/lib/utilities/format";
+import { toArray } from "@stryke/convert/to-array";
 import { createDirectory } from "@stryke/fs/helpers";
 import { isObject } from "@stryke/type-checks/is-object";
 import { formatLogMessage } from "@storm-software/config-tools/logger";
 import { omit } from "@stryke/helpers/omit";
+import { isSetObject } from "@stryke/type-checks/is-set-object";
 
 //#region src/api/types.ts
 /**

package/dist/api/types.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"types.mjs","names":[],"sources":["../../src/api/types.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 { executeEnvironments } from \"@powerlines/core/lib/environment\";\nimport { handleTypes } from \"@powerlines/core/lib/generate-types\";\nimport { installDependencies } from \"@powerlines/core/lib/install-dependencies\";\nimport { writeMetaFile } from \"@powerlines/core/lib/meta\";\nimport {\n  initializeTsconfig,\n  resolveTsconfig\n} from \"@powerlines/core/lib/typescript/tsconfig\";\nimport { format } from \"@powerlines/core/lib/utilities/format\";\nimport { ExecutionContext } from \"@powerlines/core/types/context\";\nimport { formatLogMessage } from \"@storm-software/config-tools/logger\";\nimport { toArray } from \"@stryke/convert/to-array\";\nimport { createDirectory } from \"@stryke/fs/helpers\";\nimport { omit } from \"@stryke/helpers/omit\";\nimport { isObject } from \"@stryke/type-checks/is-object\";\nimport { isSetObject } from \"@stryke/type-checks/is-set-object\";\nimport { EngineResolvedConfig } from \"../types/config\";\nimport { EngineSystemContext } from \"../types/context\";\nimport { prepare } from \"./prepare\";\n\n/**\n * Generate runtime types for the Powerlines project.\n *\n * @remarks\n * This function is responsible for generating TypeScript declaration files based on the project's configuration and environment. It executes hooks at various stages of the type generation process, allowing for customization and extension by plugins. The generated types are formatted and written to the appropriate location in the project's file system, ensuring that they are available for use by other parts of the Powerlines system and by end-users of the project.\n *\n * @param context - The execution context for the build process, which provides access to the project configuration, environment, and utility functions for performing the build. The context is used to manage the state and behavior of the build process, allowing for hooks to be called at different stages of the build and for environment-specific configurations to be applied.\n */\nexport async function types<\n  TResolvedConfig extends EngineResolvedConfig,\n  TSystemContext extends EngineSystemContext\n>(context: ExecutionContext<TResolvedConfig, TSystemContext>) {\n  const timer = context.timer(\"Type Generation\");\n  context.debug(\n    \" Aggregating configuration options for the Powerlines project\"\n  );\n\n  await executeEnvironments(context, async env => {\n    env.debug(\n      `Initializing the processing options for the Powerlines project.`\n    );\n\n    await context.callHook(\"configResolved\", {\n      environment: env,\n      order: \"pre\"\n    });\n\n    await initializeTsconfig<TResolvedConfig, TSystemContext>(env);\n\n    await context.callHook(\"configResolved\", {\n      environment: env,\n      order: \"normal\"\n    });\n\n    if (env.entry.length > 0) {\n      env.debug(\n        `The configuration provided ${\n          isObject(env.config.input)\n            ? Object.keys(env.config.input).length\n            : toArray(env.config.input).length\n        } entry point(s), Powerlines has found ${\n          env.entry.length\n        } entry files(s) for the ${env.config.title} project${\n          env.entry.length > 0 && env.entry.length < 10\n            ? `: \\n${env.entry\n                .map(\n                  entry =>\n                    `- ${entry.file}${\n                      entry.output ? ` -> ${entry.output}` : \"\"\n                    }`\n                )\n                .join(\" \\n\")}`\n            : \"\"\n        }`\n      );\n    } else {\n      env.warn(\n        `No entry files were found for the ${\n          env.config.title\n        } project. Please ensure this is correct. Powerlines plugins generally require at least one entry point to function properly.`\n      );\n    }\n\n    await resolveTsconfig<TResolvedConfig, TSystemContext>(env);\n    await installDependencies(env);\n\n    await context.callHook(\"configResolved\", {\n      environment: env,\n      order: \"post\"\n    });\n\n    context.trace(\n      `Powerlines configuration has been resolved: \\n\\n${formatLogMessage({\n        ...env.config,\n        userConfig: isSetObject(env.config.userConfig)\n          ? omit(env.config.userConfig, [\"plugins\"])\n          : undefined,\n        inlineConfig: isSetObject(env.config.inlineConfig)\n          ? env.config.inlineConfig\n          : undefined,\n        plugins: env.plugins.map(plugin => plugin.name)\n      })}`\n    );\n\n    if (!env.fs.existsSync(env.cachePath)) {\n      await createDirectory(env.cachePath);\n    }\n\n    if (!env.fs.existsSync(env.dataPath)) {\n      await createDirectory(env.dataPath);\n    }\n\n    if (\n      env.config.skipCache === true ||\n      env.persistedMeta?.checksum !== env.meta.checksum\n    ) {\n      env.debug(\n        `Using previously prepared files as the meta checksum has not changed.`\n      );\n    } else {\n      env.info(\n        `Running \\`prepare\\` command as the meta checksum has changed since the last run.`\n      );\n\n      await prepare(context, true);\n    }\n\n    await handleTypes(context, env);\n\n    context.debug(\"Formatting files generated during the types step.\");\n\n    await format(env, env.typesPath, (await env.fs.read(env.typesPath)) ?? \"\");\n\n    await writeMetaFile(env);\n    env.persistedMeta = env.meta;\n  });\n\n  timer();\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AA8CA,eAAsB,MAGpB,SAA4D;CAC5D,MAAM,QAAQ,QAAQ,MAAM,kBAAkB;AAC9C,SAAQ,MACN,gEACD;AAED,OAAM,oBAAoB,SAAS,OAAM,QAAO;AAC9C,MAAI,MACF,kEACD;AAED,QAAM,QAAQ,SAAS,kBAAkB;GACvC,aAAa;GACb,OAAO;GACR,CAAC;AAEF,QAAM,mBAAoD,IAAI;AAE9D,QAAM,QAAQ,SAAS,kBAAkB;GACvC,aAAa;GACb,OAAO;GACR,CAAC;AAEF,MAAI,IAAI,MAAM,SAAS,EACrB,KAAI,MACF,8BACE,SAAS,IAAI,OAAO,MAAM,GACtB,OAAO,KAAK,IAAI,OAAO,MAAM,CAAC,SAC9B,QAAQ,IAAI,OAAO,MAAM,CAAC,OAC/B,wCACC,IAAI,MAAM,OACX,0BAA0B,IAAI,OAAO,MAAM,UAC1C,IAAI,MAAM,SAAS,KAAK,IAAI,MAAM,SAAS,KACvC,OAAO,IAAI,MACR,KACC,UACE,KAAK,MAAM,OACT,MAAM,SAAS,OAAO,MAAM,WAAW,KAE5C,CACA,KAAK,MAAM,KACd,KAEP;MAED,KAAI,KACF,qCACE,IAAI,OAAO,MACZ,8HACF;AAGH,QAAM,gBAAiD,IAAI;AAC3D,QAAM,oBAAoB,IAAI;AAE9B,QAAM,QAAQ,SAAS,kBAAkB;GACvC,aAAa;GACb,OAAO;GACR,CAAC;AAEF,UAAQ,MACN,mDAAmD,iBAAiB;GAClE,GAAG,IAAI;GACP,YAAY,YAAY,IAAI,OAAO,WAAW,GAC1C,KAAK,IAAI,OAAO,YAAY,CAAC,UAAU,CAAC,GACxC;GACJ,cAAc,YAAY,IAAI,OAAO,aAAa,GAC9C,IAAI,OAAO,eACX;GACJ,SAAS,IAAI,QAAQ,KAAI,WAAU,OAAO,KAAK;GAChD,CAAC,GACH;AAED,MAAI,CAAC,IAAI,GAAG,WAAW,IAAI,UAAU,CACnC,OAAM,gBAAgB,IAAI,UAAU;AAGtC,MAAI,CAAC,IAAI,GAAG,WAAW,IAAI,SAAS,CAClC,OAAM,gBAAgB,IAAI,SAAS;AAGrC,MACE,IAAI,OAAO,cAAc,QACzB,IAAI,eAAe,aAAa,IAAI,KAAK,SAEzC,KAAI,MACF,wEACD;OACI;AACL,OAAI,KACF,mFACD;AAED,SAAM,QAAQ,SAAS,KAAK;;AAG9B,QAAM,YAAY,SAAS,IAAI;AAE/B,UAAQ,MAAM,oDAAoD;AAElE,QAAM,OAAO,KAAK,IAAI,WAAY,MAAM,IAAI,GAAG,KAAK,IAAI,UAAU,IAAK,GAAG;AAE1E,QAAM,cAAc,IAAI;AACxB,MAAI,gBAAgB,IAAI;GACxB;AAEF,QAAO"}
+{"version":3,"file":"types.mjs","names":[],"sources":["../../src/api/types.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 { executeEnvironments } from \"@powerlines/core/lib/environment\";\nimport { handleTypes } from \"@powerlines/core/lib/generate-types\";\nimport { installDependencies } from \"@powerlines/core/lib/install-dependencies\";\nimport { writeMetaFile } from \"@powerlines/core/lib/meta\";\nimport {\n  initializeTsconfig,\n  resolveTsconfig\n} from \"@powerlines/core/lib/typescript/tsconfig\";\nimport { format } from \"@powerlines/core/lib/utilities/format\";\nimport { ExecutionContext } from \"@powerlines/core/types/context\";\nimport { formatLogMessage } from \"@storm-software/config-tools/logger\";\nimport { toArray } from \"@stryke/convert/to-array\";\nimport { createDirectory } from \"@stryke/fs/helpers\";\nimport { omit } from \"@stryke/helpers/omit\";\nimport { isObject } from \"@stryke/type-checks/is-object\";\nimport { isSetObject } from \"@stryke/type-checks/is-set-object\";\nimport { EngineResolvedConfig } from \"../types/config\";\nimport { EngineSystemContext } from \"../types/context\";\nimport { prepare } from \"./prepare\";\n\n/**\n * Generate runtime types for the Powerlines project.\n *\n * @remarks\n * This function is responsible for generating TypeScript declaration files based on the project's configuration and environment. It executes hooks at various stages of the type generation process, allowing for customization and extension by plugins. The generated types are formatted and written to the appropriate location in the project's file system, ensuring that they are available for use by other parts of the Powerlines system and by end-users of the project.\n *\n * @param context - The execution context for the build process, which provides access to the project configuration, environment, and utility functions for performing the build. The context is used to manage the state and behavior of the build process, allowing for hooks to be called at different stages of the build and for environment-specific configurations to be applied.\n */\nexport async function types<\n  TResolvedConfig extends EngineResolvedConfig,\n  TSystemContext extends EngineSystemContext\n>(context: ExecutionContext<TResolvedConfig, TSystemContext>) {\n  const timer = context.timer(\"Type Generation\");\n  context.debug(\n    \" Aggregating configuration options for the Powerlines project\"\n  );\n\n  await executeEnvironments(context, async env => {\n    env.debug(\n      `Initializing the processing options for the Powerlines project.`\n    );\n\n    await context.callHook(\"configResolved\", {\n      environment: env,\n      order: \"pre\"\n    });\n\n    await initializeTsconfig<TResolvedConfig, TSystemContext>(env);\n\n    await context.callHook(\"configResolved\", {\n      environment: env,\n      order: \"normal\"\n    });\n\n    if (env.entry.length > 0) {\n      env.debug(\n        `The configuration provided ${\n          isObject(env.config.input)\n            ? Object.keys(env.config.input).length\n            : toArray(env.config.input).length\n        } entry point(s), Powerlines has found ${\n          env.entry.length\n        } entry files(s) for the ${env.config.title} project${\n          env.entry.length > 0 && env.entry.length < 10\n            ? `: \\n${env.entry\n                .map(\n                  entry =>\n                    `- ${entry.file}${\n                      entry.output ? ` -> ${entry.output}` : \"\"\n                    }`\n                )\n                .join(\" \\n\")}`\n            : \"\"\n        }`\n      );\n    } else {\n      env.warn(\n        `No entry files were found for the ${\n          env.config.title\n        } project. Please ensure this is correct. Powerlines plugins generally require at least one entry point to function properly.`\n      );\n    }\n\n    await resolveTsconfig<TResolvedConfig, TSystemContext>(env);\n    await installDependencies(env);\n\n    await context.callHook(\"configResolved\", {\n      environment: env,\n      order: \"post\"\n    });\n\n    context.trace(\n      `Powerlines configuration has been resolved: \\n\\n${formatLogMessage({\n        ...env.config,\n        userConfig: isSetObject(env.config.userConfig)\n          ? omit(env.config.userConfig, [\"plugins\"])\n          : undefined,\n        inlineConfig: isSetObject(env.config.inlineConfig)\n          ? env.config.inlineConfig\n          : undefined,\n        plugins: env.plugins.map(plugin => plugin.name)\n      })}`\n    );\n\n    if (!env.fs.existsSync(env.cachePath)) {\n      await createDirectory(env.cachePath);\n    }\n\n    if (!env.fs.existsSync(env.dataPath)) {\n      await createDirectory(env.dataPath);\n    }\n\n    if (\n      env.config.skipCache === true ||\n      env.persistedMeta?.checksum !== env.meta.checksum\n    ) {\n      env.debug(\n        `Using previously prepared files as the meta checksum has not changed.`\n      );\n    } else {\n      env.info(\n        `Running \\`prepare\\` command as the meta checksum has changed since the last run.`\n      );\n\n      await prepare(context, true);\n    }\n\n    await handleTypes(context, env);\n\n    context.debug(\"Formatting files generated during the types step.\");\n\n    await format(env, env.typesPath, (await env.fs.read(env.typesPath)) ?? \"\");\n\n    await writeMetaFile(env);\n    env.persistedMeta = env.meta;\n  });\n\n  timer();\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AA8CA,eAAsB,MAGpB,SAA4D;CAC5D,MAAM,QAAQ,QAAQ,MAAM,iBAAiB;CAC7C,QAAQ,MACN,+DACF;CAEA,MAAM,oBAAoB,SAAS,OAAM,QAAO;EAC9C,IAAI,MACF,iEACF;EAEA,MAAM,QAAQ,SAAS,kBAAkB;GACvC,aAAa;GACb,OAAO;EACT,CAAC;EAED,MAAM,mBAAoD,GAAG;EAE7D,MAAM,QAAQ,SAAS,kBAAkB;GACvC,aAAa;GACb,OAAO;EACT,CAAC;EAED,IAAI,IAAI,MAAM,SAAS,GACrB,IAAI,MACF,8BACE,SAAS,IAAI,OAAO,KAAK,IACrB,OAAO,KAAK,IAAI,OAAO,KAAK,EAAE,SAC9B,QAAQ,IAAI,OAAO,KAAK,EAAE,OAC/B,wCACC,IAAI,MAAM,OACX,0BAA0B,IAAI,OAAO,MAAM,UAC1C,IAAI,MAAM,SAAS,KAAK,IAAI,MAAM,SAAS,KACvC,OAAO,IAAI,MACR,KACC,UACE,KAAK,MAAM,OACT,MAAM,SAAS,OAAO,MAAM,WAAW,IAE7C,EACC,KAAK,KAAK,MACb,IAER;OAEA,IAAI,KACF,qCACE,IAAI,OAAO,MACZ,6HACH;EAGF,MAAM,gBAAiD,GAAG;EAC1D,MAAM,oBAAoB,GAAG;EAE7B,MAAM,QAAQ,SAAS,kBAAkB;GACvC,aAAa;GACb,OAAO;EACT,CAAC;EAED,QAAQ,MACN,mDAAmD,iBAAiB;GAClE,GAAG,IAAI;GACP,YAAY,YAAY,IAAI,OAAO,UAAU,IACzC,KAAK,IAAI,OAAO,YAAY,CAAC,SAAS,CAAC,IACvC;GACJ,cAAc,YAAY,IAAI,OAAO,YAAY,IAC7C,IAAI,OAAO,eACX;GACJ,SAAS,IAAI,QAAQ,KAAI,WAAU,OAAO,IAAI;EAChD,CAAC,GACH;EAEA,IAAI,CAAC,IAAI,GAAG,WAAW,IAAI,SAAS,GAClC,MAAM,gBAAgB,IAAI,SAAS;EAGrC,IAAI,CAAC,IAAI,GAAG,WAAW,IAAI,QAAQ,GACjC,MAAM,gBAAgB,IAAI,QAAQ;EAGpC,IACE,IAAI,OAAO,cAAc,QACzB,IAAI,eAAe,aAAa,IAAI,KAAK,UAEzC,IAAI,MACF,uEACF;OACK;GACL,IAAI,KACF,kFACF;GAEA,MAAM,QAAQ,SAAS,IAAI;EAC7B;EAEA,MAAM,YAAY,SAAS,GAAG;EAE9B,QAAQ,MAAM,mDAAmD;EAEjE,MAAM,OAAO,KAAK,IAAI,WAAY,MAAM,IAAI,GAAG,KAAK,IAAI,SAAS,KAAM,EAAE;EAEzE,MAAM,cAAc,GAAG;EACvB,IAAI,gBAAgB,IAAI;CAC1B,CAAC;CAED,MAAM;AACR"}

package/dist/{api-Cdw4v0W4.d.mts → api-B2dWvRMM.d.mts}

@@ -1,12 +1,11 @@
-import { t as EngineExecutionOptions } from "./config-BNe23XHx.mjs";
-import { t as EngineContext } from "./context-DzgsMSWr.mjs";
+import { t as EngineExecutionOptions } from "./config-C9AD-erz.mjs";
+import { t as EngineContext } from "./context-S3XH2DWP.mjs";
 import { BuildInlineConfig, CleanInlineConfig, CreateInlineConfig, DeployInlineConfig, DocsInlineConfig, InlineConfig, LintInlineConfig, PrepareInlineConfig, TestInlineConfig, TypesInlineConfig } from "@powerlines/core";
 import { EXECUTION_API_METHODS } from "@powerlines/core/constants/api";
 
 //#region src/types/utils.d.ts
-type Worker<TParams, TExposedMethods extends ReadonlyArray<string>> = { [K in TExposedMethods[number]]: (params: TParams) => Promise<void> } & {
-  close: () => void;
-  end: () => Promise<void>;
+type Worker<TParams extends any[], TExposedMethods extends ReadonlyArray<string>> = { [K in TExposedMethods[number]]: (...params: TParams) => Promise<void> } & {
+  finalize: () => Promise<void>;
 };
 //#endregion
 //#region src/types/api.d.ts
@@ -106,6 +105,10 @@ interface ExecutionInterface {
   finalize: () => Promise<void>;
 }
 interface ExecutionHostParams {
+  /**
+   * The {@link MessagePort} used for communication between the execution host and the engine. This port will be used to send and receive messages, allowing the execution host to invoke API methods and return results to the engine.
+   */
+  port: MessagePort;
   /**
    * The execution options for the current execution instance
    */
@@ -115,7 +118,7 @@ interface ExecutionHostParams {
    */
   inlineConfig: InlineConfig;
 }
-type ExecutionHost<TExecutionAPI extends ReadonlyArray<string>> = Worker<ExecutionHostParams, TExecutionAPI>;
+type ExecutionHost<TExecutionAPI extends ReadonlyArray<string>> = Worker<[EngineExecutionOptions, InlineConfig], TExecutionAPI>;
 type PowerlinesExecutionHost = ExecutionHost<typeof EXECUTION_API_METHODS>;
 /**
  * The Engine interface represents the Powerlines process' orchestration and coordination API.
@@ -132,4 +135,4 @@ interface Engine<TExecutionAPI extends ReadonlyArray<string>> extends ExecutionI
 }
 //#endregion
 export { PowerlinesExecutionHost as a, ExecutionInterface as i, ExecutionHost as n, Worker as o, ExecutionHostParams as r, Engine as t };
-//# sourceMappingURL=api-Cdw4v0W4.d.mts.map
+//# sourceMappingURL=api-B2dWvRMM.d.mts.map

package/dist/api-B2dWvRMM.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-B2dWvRMM.d.mts","names":[],"sources":["../src/types/utils.ts","../src/types/api.ts"],"mappings":";;;;;;KAkBY,MAAA,gDAEc,aAAA,oBAElB,eAAA,eAA8B,MAAA,EAAQ,OAAA,KAAY,OAAA;EAExD,QAAA,QAAgB,OAAA;AAAA;;;;AANlB;;;;;UCuBiB,kBAAA;EDnByC;;;;;;;;EC4BxD,OAAA,GAAU,YAAA,EAAc,mBAAA,KAAwB,OAAA;ED5BZ;;;;;;AAEb;;ECoCvB,KAAA,GAAQ,YAAA,EAAc,iBAAA,KAAsB,OAAA;;AAnB9C;;;;;;;;EA8BE,MAAA,GAAS,YAAA,EAAc,kBAAA,KAAuB,OAAA;EAWxB;;;;;;;;;EAAtB,KAAA,GAAQ,YAAA,EAAc,iBAAA,KAAsB,OAAA;EA6CrB;;;;;;EArCvB,IAAA,GAAO,YAAA,EAAc,gBAAA,KAAqB,OAAA;EAxChC;;;;;;EAgDV,IAAA,GAAO,YAAA,EAAc,gBAAA,KAAqB,OAAA;EA3BnB;;;;;;;;;EAsCvB,KAAA,GAAQ,YAAA,EAAc,iBAAA,KAAsB,OAAA;EAnBF;;;;;;EA2B1C,IAAA,GAAO,YAAA,EAAc,gBAAA,KAAqB,OAAA;EARlC;;;;;;;;EAkBR,MAAA,GAAS,YAAA,EAAc,kBAAA,KAAuB,OAAA;EAAA;;;;AAUvB;AAGzB;;;EAHE,QAAA,QAAgB,OAAA;AAAA;AAAA,UAGD,mBAAA;EAcW;;;EAV1B,IAAA,EAAM,WAAA;EAKN;;;EAAA,OAAA,EAAS,sBAAA;EAKiB;AAAA;AAG5B;EAHE,YAAA,EAAc,YAAA;AAAA;AAAA,KAGJ,aAAA,uBAAoC,aAAA,YAAyB,MAAA,EACtE,sBAAA,EAAwB,YAAA,GACzB,aAAA;AAAA,KAGU,uBAAA,GAA0B,aAAa,QAC1C,qBAAA;;;;UAMQ,MAAA,uBACO,aAAA,kBACd,kBAAA;EAd+D;;;EAkBvE,OAAA,EAAS,aAAA;EAhBI;AAAA;AAGf;EAkBE,IAAA,EAAM,aAAA,CAAc,aAAA;AAAA"}

package/dist/{api-6w4hZL6n.d.cts → api-DgxYwNuZ.d.cts}

@@ -4,9 +4,8 @@ import { BuildInlineConfig, CleanInlineConfig, CreateInlineConfig, DeployInlineC
 import { EXECUTION_API_METHODS } from "@powerlines/core/constants/api";
 
 //#region src/types/utils.d.ts
-type Worker<TParams, TExposedMethods extends ReadonlyArray<string>> = { [K in TExposedMethods[number]]: (params: TParams) => Promise<void> } & {
-  close: () => void;
-  end: () => Promise<void>;
+type Worker<TParams extends any[], TExposedMethods extends ReadonlyArray<string>> = { [K in TExposedMethods[number]]: (...params: TParams) => Promise<void> } & {
+  finalize: () => Promise<void>;
 };
 //#endregion
 //#region src/types/api.d.ts
@@ -106,6 +105,10 @@ interface ExecutionInterface {
   finalize: () => Promise<void>;
 }
 interface ExecutionHostParams {
+  /**
+   * The {@link MessagePort} used for communication between the execution host and the engine. This port will be used to send and receive messages, allowing the execution host to invoke API methods and return results to the engine.
+   */
+  port: MessagePort;
   /**
    * The execution options for the current execution instance
    */
@@ -115,7 +118,7 @@ interface ExecutionHostParams {
    */
   inlineConfig: InlineConfig;
 }
-type ExecutionHost<TExecutionAPI extends ReadonlyArray<string>> = Worker<ExecutionHostParams, TExecutionAPI>;
+type ExecutionHost<TExecutionAPI extends ReadonlyArray<string>> = Worker<[EngineExecutionOptions, InlineConfig], TExecutionAPI>;
 type PowerlinesExecutionHost = ExecutionHost<typeof EXECUTION_API_METHODS>;
 /**
  * The Engine interface represents the Powerlines process' orchestration and coordination API.
@@ -132,4 +135,4 @@ interface Engine<TExecutionAPI extends ReadonlyArray<string>> extends ExecutionI
 }
 //#endregion
 export { PowerlinesExecutionHost as a, ExecutionInterface as i, ExecutionHost as n, Worker as o, ExecutionHostParams as r, Engine as t };
-//# sourceMappingURL=api-6w4hZL6n.d.cts.map
+//# sourceMappingURL=api-DgxYwNuZ.d.cts.map

package/dist/api-DgxYwNuZ.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-DgxYwNuZ.d.cts","names":[],"sources":["../src/types/utils.ts","../src/types/api.ts"],"mappings":";;;;;;KAkBY,MAAA,gDAEc,aAAA,oBAElB,eAAA,eAA8B,MAAA,EAAQ,OAAA,KAAY,OAAA;EAExD,QAAA,QAAgB,OAAA;AAAA;;;;AANlB;;;;;UCuBiB,kBAAA;EDnByC;;;;;;;;EC4BxD,OAAA,GAAU,YAAA,EAAc,mBAAA,KAAwB,OAAA;ED5BZ;;;;;;AAEb;;ECoCvB,KAAA,GAAQ,YAAA,EAAc,iBAAA,KAAsB,OAAA;;AAnB9C;;;;;;;;EA8BE,MAAA,GAAS,YAAA,EAAc,kBAAA,KAAuB,OAAA;EAWxB;;;;;;;;;EAAtB,KAAA,GAAQ,YAAA,EAAc,iBAAA,KAAsB,OAAA;EA6CrB;;;;;;EArCvB,IAAA,GAAO,YAAA,EAAc,gBAAA,KAAqB,OAAA;EAxChC;;;;;;EAgDV,IAAA,GAAO,YAAA,EAAc,gBAAA,KAAqB,OAAA;EA3BnB;;;;;;;;;EAsCvB,KAAA,GAAQ,YAAA,EAAc,iBAAA,KAAsB,OAAA;EAnBF;;;;;;EA2B1C,IAAA,GAAO,YAAA,EAAc,gBAAA,KAAqB,OAAA;EARlC;;;;;;;;EAkBR,MAAA,GAAS,YAAA,EAAc,kBAAA,KAAuB,OAAA;EAAA;;;;AAUvB;AAGzB;;;EAHE,QAAA,QAAgB,OAAA;AAAA;AAAA,UAGD,mBAAA;EAcW;;;EAV1B,IAAA,EAAM,WAAA;EAKN;;;EAAA,OAAA,EAAS,sBAAA;EAKiB;AAAA;AAG5B;EAHE,YAAA,EAAc,YAAA;AAAA;AAAA,KAGJ,aAAA,uBAAoC,aAAA,YAAyB,MAAA,EACtE,sBAAA,EAAwB,YAAA,GACzB,aAAA;AAAA,KAGU,uBAAA,GAA0B,aAAa,QAC1C,qBAAA;;;;UAMQ,MAAA,uBACO,aAAA,kBACd,kBAAA;EAd+D;;;EAkBvE,OAAA,EAAS,aAAA;EAhBI;AAAA;AAGf;EAkBE,IAAA,EAAM,aAAA,CAAc,aAAA;AAAA"}

package/dist/{execution-host.cjs → api.cjs}

@@ -10,7 +10,7 @@ const require_api_test = require('./api/test.cjs');
 const require_api_types = require('./api/types.cjs');
 const require_helpers_create_execution_host = require('./helpers/create-execution-host.cjs');
 
-//#region src/execution-host.ts
+//#region src/api.ts
 const executionHost = require_helpers_create_execution_host.createExecutionHost({
 	types: require_api_types.types,
 	prepare: require_api_prepare.prepare,

package/dist/{execution-host.d.mts → api.d.cts}

@@ -1,5 +1,5 @@
-import { r as ExecutionHostParams } from "./api-Cdw4v0W4.mjs";
-//#region src/execution-host.d.ts
+import { r as ExecutionHostParams } from "./api-DgxYwNuZ.cjs";
+//#region src/api.d.ts
 declare const types: ((params: ExecutionHostParams) => Promise<void>) | undefined;
 declare const prepare: ((params: ExecutionHostParams) => Promise<void>) | undefined;
 declare const create: ((params: ExecutionHostParams) => Promise<void>) | undefined;
@@ -11,4 +11,4 @@ declare const docs: ((params: ExecutionHostParams) => Promise<void>) | undefined
 declare const deploy: ((params: ExecutionHostParams) => Promise<void>) | undefined;
 //#endregion
 export { build, clean, create, deploy, docs, lint, prepare, test, types };
-//# sourceMappingURL=execution-host.d.mts.map
+//# sourceMappingURL=api.d.cts.map

package/dist/api.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.cts","names":[],"sources":["../src/api.ts"],"mappings":";;cAyCa,KAAA,IAAK,MAAA,EAAsB,mBAAA,KAAtB,OAAA;AAAA,cACL,OAAA,IAAO,MAAA,EAAwB,mBAAA,KAAxB,OAAA;AAAA,cACP,MAAA,IAAM,MAAA,EAAuB,mBAAA,KAAvB,OAAA;AAAA,cACN,KAAA,IAAK,MAAA,EAAsB,mBAAA,KAAtB,OAAA;AAAA,cACL,IAAA,IAAI,MAAA,EAAqB,mBAAA,KAArB,OAAA;AAAA,cACJ,IAAA,IAAI,MAAA,EAAqB,mBAAA,KAArB,OAAA;AAAA,cACJ,KAAA,IAAK,MAAA,EAAsB,mBAAA,KAAtB,OAAA;AAAA,cACL,IAAA,IAAI,MAAA,EAAqB,mBAAA,KAArB,OAAA;AAAA,cACJ,MAAA,IAAM,MAAA,EAAuB,mBAAA,KAAvB,OAAA"}

package/dist/{execution-host.d.cts → api.d.mts}

@@ -1,5 +1,5 @@
-import { r as ExecutionHostParams } from "./api-6w4hZL6n.cjs";
-//#region src/execution-host.d.ts
+import { r as ExecutionHostParams } from "./api-B2dWvRMM.mjs";
+//#region src/api.d.ts
 declare const types: ((params: ExecutionHostParams) => Promise<void>) | undefined;
 declare const prepare: ((params: ExecutionHostParams) => Promise<void>) | undefined;
 declare const create: ((params: ExecutionHostParams) => Promise<void>) | undefined;
@@ -11,4 +11,4 @@ declare const docs: ((params: ExecutionHostParams) => Promise<void>) | undefined
 declare const deploy: ((params: ExecutionHostParams) => Promise<void>) | undefined;
 //#endregion
 export { build, clean, create, deploy, docs, lint, prepare, test, types };
-//# sourceMappingURL=execution-host.d.cts.map
+//# sourceMappingURL=api.d.mts.map

package/dist/api.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.mts","names":[],"sources":["../src/api.ts"],"mappings":";;cAyCa,KAAA,IAAK,MAAA,EAAsB,mBAAA,KAAtB,OAAA;AAAA,cACL,OAAA,IAAO,MAAA,EAAwB,mBAAA,KAAxB,OAAA;AAAA,cACP,MAAA,IAAM,MAAA,EAAuB,mBAAA,KAAvB,OAAA;AAAA,cACN,KAAA,IAAK,MAAA,EAAsB,mBAAA,KAAtB,OAAA;AAAA,cACL,IAAA,IAAI,MAAA,EAAqB,mBAAA,KAArB,OAAA;AAAA,cACJ,IAAA,IAAI,MAAA,EAAqB,mBAAA,KAArB,OAAA;AAAA,cACJ,KAAA,IAAK,MAAA,EAAsB,mBAAA,KAAtB,OAAA;AAAA,cACL,IAAA,IAAI,MAAA,EAAqB,mBAAA,KAArB,OAAA;AAAA,cACJ,MAAA,IAAM,MAAA,EAAuB,mBAAA,KAAvB,OAAA"}