powerlines 0.37.30 → 0.37.32

package/dist/{chunk-YL3OE2WO.js → chunk-DFHVFK5Q.js}

@@ -3,7 +3,6 @@ import { BUILDER_VARIANTS, UNPLUGIN_BUILDER_VARIANTS } from './chunk-NITQ5IYP.js
 import { __name } from './chunk-7QVYU63E.js';
 import { transformAsync } from '@babel/core';
 import { formatLogMessage } from '@storm-software/config-tools/logger/console';
-import { LogLevelLabel } from '@storm-software/config-tools/types';
 import { toArray } from '@stryke/convert/to-array';
 import { createDirectorySync, createDirectory } from '@stryke/fs/helpers';
 import { install } from '@stryke/fs/install';
@@ -26,6 +25,7 @@ import chalk5 from 'chalk';
 import Handlebars from 'handlebars';
 import { declare } from '@babel/helper-plugin-utils';
 import * as t from '@babel/types';
+import { LogLevelLabel } from '@storm-software/config-tools/types';
 import ts, { flattenDiagnosticMessageText } from 'typescript';
 import defu7, { createDefu, defu } from 'defu';
 import { InMemoryFileSystemHost, Project } from 'ts-morph';
@@ -78,6 +78,11 @@ import { unlink } from 'node:fs/promises';
 import { resolve } from 'node:path';
 import '@stryke/fs/remove-file';
 
+// package.json
+var name = "powerlines";
+var version = "0.37.31";
+var package_default = {
+  version};
 function resolveModulePath(nodePath, state) {
   if (!t.isStringLiteral(nodePath.node)) {
     return;
@@ -117,8 +122,8 @@ function matchesPattern(state, calleePath, pattern) {
   if (!t.isIdentifier(node) || pattern.includes(".")) {
     return false;
   }
-  const name = pattern.split(".")[0];
-  return node.name === name;
+  const name2 = pattern.split(".")[0];
+  return node.name === name2;
 }
 __name(matchesPattern, "matchesPattern");
 var importVisitors = {
@@ -452,13 +457,13 @@ async function installDependencies(context) {
   }
   context.log(LogLevelLabel.DEBUG, `The following packages are required: 
 Dependencies: 
-${Object.entries(context.dependencies).map(([name, version]) => `- ${name}@${String(version)}`).join(" \n")}
+${Object.entries(context.dependencies).map(([name2, version2]) => `- ${name2}@${String(version2)}`).join(" \n")}
 
 DevDependencies: 
-${Object.entries(context.devDependencies).map(([name, version]) => `- ${name}@${String(version)}`).join(" \n")}`);
+${Object.entries(context.devDependencies).map(([name2, version2]) => `- ${name2}@${String(version2)}`).join(" \n")}`);
   await Promise.all([
-    Promise.all(Object.entries(context.dependencies).map(async ([name, version]) => installPackage(context, `${getPackageName(name)}@${String(version)}`, false))),
-    Promise.all(Object.entries(context.devDependencies).map(async ([name, version]) => installPackage(context, `${getPackageName(name)}@${String(version)}`, true)))
+    Promise.all(Object.entries(context.dependencies).map(async ([name2, version2]) => installPackage(context, `${getPackageName(name2)}@${String(version2)}`, false))),
+    Promise.all(Object.entries(context.devDependencies).map(async ([name2, version2]) => installPackage(context, `${getPackageName(name2)}@${String(version2)}`, true)))
   ]);
 }
 __name(installDependencies, "installDependencies");
@@ -677,9 +682,9 @@ var DEFAULT_ENVIRONMENT = "default";
 var GLOBAL_ENVIRONMENT = "__global__";
 
 // src/internal/helpers/environment.ts
-function createEnvironment(name, userConfig) {
-  return defu7(userConfig.environments?.[name] ?? {}, {
-    name,
+function createEnvironment(name2, userConfig) {
+  return defu7(userConfig.environments?.[name2] ?? {}, {
+    name: name2,
     title: userConfig.title || titleCase(userConfig.name),
     ssr: false,
     mainFields: userConfig.build?.platform === "browser" ? [
@@ -907,19 +912,39 @@ function resolveEntry(context, typeDefinition) {
   };
 }
 __name(resolveEntry, "resolveEntry");
+function isTypeDefinition(entry) {
+  return !isString(entry) && entry.file !== void 0;
+}
+__name(isTypeDefinition, "isTypeDefinition");
+function isResolvedEntryTypeDefinition(entry) {
+  return isTypeDefinition(entry) && entry.input !== void 0 && entry.output !== void 0;
+}
+__name(isResolvedEntryTypeDefinition, "isResolvedEntryTypeDefinition");
 function resolveEntriesSync(context, typeDefinitions) {
-  return typeDefinitions.map((entry) => isString(entry) ? replacePathTokens(context, entry) : replacePathTokens(context, entry.file)).map((typeDefinition) => {
-    const parsed = parseTypeDefinition(typeDefinition);
-    const filePath = appendPath(parsed.file, context.config.projectRoot);
+  return typeDefinitions.map((entry) => {
+    if (isResolvedEntryTypeDefinition(entry)) {
+      return {
+        ...entry,
+        file: replacePathTokens(context, entry.file)
+      };
+    }
+    let typeDefinition;
+    if (isString(entry)) {
+      typeDefinition = parseTypeDefinition(replacePathTokens(context, entry));
+    } else {
+      typeDefinition = entry;
+      typeDefinition.file = replacePathTokens(context, typeDefinition.file);
+    }
+    const filePath = appendPath(typeDefinition.file, context.config.projectRoot);
     if (isFile(filePath)) {
       return resolveEntry(context, {
         file: replacePath(filePath, context.config.projectRoot),
-        name: parsed.name
+        name: typeDefinition.name
       });
     }
     return listFilesSync(filePath).map((file) => resolveEntry(context, {
       file,
-      name: parsed.name
+      name: typeDefinition.name
     }));
   }).flat().filter(Boolean);
 }
@@ -1152,7 +1177,7 @@ FileMetadata._Properties = $.CompositeList(FileMetadata_KeyValuePair);
 FileSystem._Ids = $.CompositeList(FileId);
 FileSystem._Storage = $.CompositeList(FileStorage);
 FileSystem._Metadata = $.CompositeList(FileMetadata);
-var createLog = /* @__PURE__ */ __name((name, options = {}) => {
+var createLog = /* @__PURE__ */ __name((name2, options = {}) => {
   const logLevel = options.logLevel === null ? LogLevelLabel.SILENT : options.logLevel || LogLevelLabel.INFO;
   if (logLevel === LogLevelLabel.SILENT) {
     return noop;
@@ -1163,7 +1188,7 @@ var createLog = /* @__PURE__ */ __name((name, options = {}) => {
   return (type, ...args) => getLogFn(getLogLevel(type), {
     ...options,
     logLevel
-  })(`${chalk5.bold.hex(getColor("brand", options))(`${name ? kebabCase(name) : ""}${options.name ? `${name ? chalk5.gray(" > ") : ""}${kebabCase(options.name)}` : ""}${chalk5.gray(" > ")}`)}${args.join(" ")} `.trim());
+  })(`${chalk5.bold.hex(getColor("brand", options))(`${name2 ? kebabCase(name2) : ""}${options.name ? `${name2 ? chalk5.gray(" > ") : ""}${kebabCase(options.name)}` : ""}${chalk5.gray(" > ")}`)}${args.join(" ")} `.trim());
 }, "createLog");
 var BADGE_COLORS = [
   "#00A0DD",
@@ -1189,8 +1214,8 @@ var BADGE_COLORS = [
   "#34D399",
   "#8B5CF6"
 ];
-var extendLog = /* @__PURE__ */ __name((logFn, name) => {
-  return (type, ...args) => logFn(type, ` ${chalk5.inverse.hex(BADGE_COLORS[name.split("").map((char) => char.charCodeAt(0)).reduce((ret, charCode) => ret + charCode, 0) % BADGE_COLORS.length] || BADGE_COLORS[0])(` ${titleCase(name)} `)}  ${args.join(" ")} `);
+var extendLog = /* @__PURE__ */ __name((logFn, name2) => {
+  return (type, ...args) => logFn(type, ` ${chalk5.inverse.hex(BADGE_COLORS[name2.split("").map((char) => char.charCodeAt(0)).reduce((ret, charCode) => ret + charCode, 0) % BADGE_COLORS.length] || BADGE_COLORS[0])(` ${titleCase(name2)} `)}  ${args.join(" ")} `);
 }, "extendLog");
 async function format(path, data) {
   let code = data;
@@ -1849,12 +1874,12 @@ var VirtualFileSystem = class _VirtualFileSystem {
             }
             let metadata;
             if (fs._hasMetadata()) {
-              metadata = fs.metadata.find((meta) => meta.id === (id?.id ?? file.path));
+              metadata = fs.metadata.find((meta) => meta.id === result.#normalizeId(id?.id ?? file.path));
             }
             await result.write(file.path, file.code, {
               meta: {
-                id: id?.id || metadata?.id,
-                type: metadata?.type,
+                id: result.#normalizeId(id?.id ?? metadata?.id ?? file.path),
+                type: metadata?.type || "normal",
                 properties: metadata?._hasProperties() ? metadata?.properties.values().reduce((ret, kvp) => {
                   ret[kvp.key] = kvp.value;
                   return ret;
@@ -1865,37 +1890,6 @@ var VirtualFileSystem = class _VirtualFileSystem {
           }
         }));
       }
-      if (result.#metadata && Object.keys(result.#metadata).length > 0) {
-        result.#log(LogLevelLabel.DEBUG, `Preparing to load ${Object.keys(result.#metadata).length} previously stored metadata records...`);
-        const entry = Object.entries(result.#metadata).filter(([, meta]) => meta && meta.type === "entry").map(([path, meta]) => {
-          if (meta.properties) {
-            const typeDefinition = {
-              file: path
-            };
-            if (isSetString(meta.properties.name)) {
-              typeDefinition.name = meta.properties.name;
-            }
-            if (isSetString(meta.properties["input.file"]) || isSetString(meta.properties["input.name"])) {
-              typeDefinition.input ??= {};
-              if (isSetString(meta.properties["input.file"])) {
-                typeDefinition.input.file = meta.properties["input.file"];
-              }
-              if (isSetString(meta.properties["input.name"])) {
-                typeDefinition.input.name = meta.properties["input.name"];
-              }
-            }
-            if (isSetString(meta.properties.output)) {
-              typeDefinition.output = meta.properties.output;
-            }
-            return typeDefinition;
-          }
-          return null;
-        }).filter(Boolean);
-        result.#log(LogLevelLabel.DEBUG, `Loaded ${entry.length} entry type definitions from VFS metadata.`);
-        context.entry = entry;
-      } else {
-        result.#log(LogLevelLabel.DEBUG, "No previously stored metadata records were found on the local system.");
-      }
     } else {
       const message = new $.Message();
       result = new _VirtualFileSystem(context, message.initRoot(FileSystem));
@@ -1926,11 +1920,11 @@ var VirtualFileSystem = class _VirtualFileSystem {
             }
             let metadata;
             if (fs._hasMetadata()) {
-              metadata = fs.metadata.find((meta) => meta.id === (id?.id ?? file.path));
+              metadata = fs.metadata.find((meta) => meta.id === result.#normalizeId(id?.id ?? file.path));
             }
             result.writeSync(file.path, file.code, {
               meta: {
-                id: id?.id || metadata?.id,
+                id: result.#normalizeId(id?.id ?? metadata?.id ?? file.path),
                 type: metadata?.type,
                 properties: metadata?._hasProperties() ? metadata?.properties.values().reduce((ret, kvp) => {
                   ret[kvp.key] = kvp.value;
@@ -1942,37 +1936,6 @@ var VirtualFileSystem = class _VirtualFileSystem {
           }
         });
       }
-      if (result.#metadata && Object.keys(result.#metadata).length > 0) {
-        result.#log(LogLevelLabel.DEBUG, `Preparing to load ${Object.keys(result.#metadata).length} previously stored metadata records...`);
-        const entry = Object.entries(result.#metadata).filter(([, meta]) => meta && meta.type === "entry").map(([path, meta]) => {
-          if (meta.properties) {
-            const typeDefinition = {
-              file: path
-            };
-            if (isSetString(meta.properties.name)) {
-              typeDefinition.name = meta.properties.name;
-            }
-            if (isSetString(meta.properties["input.file"]) || isSetString(meta.properties["input.name"])) {
-              typeDefinition.input ??= {};
-              if (isSetString(meta.properties["input.file"])) {
-                typeDefinition.input.file = meta.properties["input.file"];
-              }
-              if (isSetString(meta.properties["input.name"])) {
-                typeDefinition.input.name = meta.properties["input.name"];
-              }
-            }
-            if (isSetString(meta.properties.output)) {
-              typeDefinition.output = meta.properties.output;
-            }
-            return typeDefinition;
-          }
-          return null;
-        }).filter(Boolean);
-        result.#log(LogLevelLabel.DEBUG, `Loaded ${entry.length} entry type definitions from VFS metadata.`);
-        context.entry = entry;
-      } else {
-        result.#log(LogLevelLabel.DEBUG, "No previously stored metadata records were found on the local system.");
-      }
     } else {
       const message = new $.Message();
       result = new _VirtualFileSystem(context, message.initRoot(FileSystem));
@@ -2109,20 +2072,6 @@ var VirtualFileSystem = class _VirtualFileSystem {
         };
         return ret;
       }, {});
-      if (context.config.skipCache !== true) {
-        Object.entries(this.#metadata).filter(([, value]) => value.type === "entry").forEach(([id, value]) => {
-          this.#context.entry ??= [];
-          this.#context.entry.push({
-            file: id,
-            name: value.properties.name,
-            output: value.properties.output,
-            input: value.properties["input.file"] ? {
-              file: value.properties["input.file"],
-              name: value.properties["input.name"]
-            } : void 0
-          });
-        });
-      }
     }
     this.#ids = {};
     this.#paths = {};
@@ -2456,12 +2405,12 @@ var VirtualFileSystem = class _VirtualFileSystem {
   */
   async read(path) {
     const filePath = await this.resolve(path);
-    if (!filePath) {
+    if (!filePath || !this.existsSync(filePath)) {
       return void 0;
     }
-    const { relativeKey, adapter } = this.#getStorage(filePath);
+    const { adapter } = this.#getStorage(filePath);
     this.#log(LogLevelLabel.TRACE, `Reading ${adapter.name} file: ${filePath}`);
-    return await adapter.get(relativeKey) ?? void 0;
+    return await adapter.get(filePath) ?? void 0;
   }
   /**
   * Synchronously reads a file from the virtual file system (VFS).
@@ -2471,12 +2420,12 @@ var VirtualFileSystem = class _VirtualFileSystem {
   */
   readSync(path) {
     const filePath = this.resolveSync(path);
-    if (!filePath) {
+    if (!filePath || !this.existsSync(filePath)) {
       return void 0;
     }
-    const { relativeKey, adapter } = this.#getStorage(filePath);
+    const { adapter } = this.#getStorage(filePath);
     this.#log(LogLevelLabel.TRACE, `Reading ${adapter.name} file: ${filePath}`);
-    return adapter.getSync(relativeKey) ?? void 0;
+    return adapter.getSync(filePath) ?? void 0;
   }
   /**
   * Writes a file to the virtual file system (VFS).
@@ -2816,8 +2765,8 @@ var VirtualFileSystem = class _VirtualFileSystem {
 };
 var PROJECT_ROOT_HASH_LENGTH = 45;
 var CACHE_HASH_LENGTH = 62;
-function getPrefixedProjectRootHash(name, projectRootHash) {
-  const combined = `${kebabCase(name)}_${projectRootHash}`;
+function getPrefixedProjectRootHash(name2, projectRootHash) {
+  const combined = `${kebabCase(name2)}_${projectRootHash}`;
   return combined.length > PROJECT_ROOT_HASH_LENGTH ? combined.slice(0, PROJECT_ROOT_HASH_LENGTH) : combined;
 }
 __name(getPrefixedProjectRootHash, "getPrefixedProjectRootHash");
@@ -2853,9 +2802,7 @@ var PowerlinesContext = class _PowerlinesContext {
   *
   * @internal
   */
-  #internal = {
-    entry: []
-  };
+  #internal = {};
   #workspaceConfig;
   #checksum = null;
   #buildId = uuid();
@@ -2976,13 +2923,8 @@ var PowerlinesContext = class _PowerlinesContext {
   * The resolved entry type definitions for the project
   */
   get entry() {
-    return resolveEntriesSync(this, !this.$$internal.entry || this.$$internal.entry.length === 0 ? toArray(this.config.entry) : this.$$internal.entry);
-  }
-  /**
-  * Sets the resolved entry type definitions for the project
-  */
-  set entry(value) {
-    this.$$internal.entry = value;
+    const entry = this._entry;
+    return resolveEntriesSync(this, !entry || entry.length === 0 ? toArray(this.config.entry) : entry);
   }
   /**
   * The TypeScript configuration parsed from the tsconfig file
@@ -3182,6 +3124,35 @@ var PowerlinesContext = class _PowerlinesContext {
     return this.#requestCache;
   }
   /**
+  * The entry points that exist in the Powerlines virtual file system
+  */
+  get _entry() {
+    return Object.entries(this.fs.metadata).filter(([, meta]) => meta && meta.type === "entry").map(([path, meta]) => {
+      if (meta.properties) {
+        const typeDefinition = {
+          file: path
+        };
+        if (isSetString(meta.properties.name)) {
+          typeDefinition.name = meta.properties.name;
+        }
+        if (isSetString(meta.properties["input.file"]) || isSetString(meta.properties["input.name"])) {
+          typeDefinition.input ??= {};
+          if (isSetString(meta.properties["input.file"])) {
+            typeDefinition.input.file = meta.properties["input.file"];
+          }
+          if (isSetString(meta.properties["input.name"])) {
+            typeDefinition.input.name = meta.properties["input.name"];
+          }
+        }
+        if (isSetString(meta.properties.output)) {
+          typeDefinition.output = meta.properties.output;
+        }
+        return typeDefinition;
+      }
+      return void 0;
+    }).filter(Boolean);
+  }
+  /**
   * A function to perform HTTP fetch requests
   *
   * @remarks
@@ -3439,14 +3410,6 @@ var PowerlinesContext = class _PowerlinesContext {
   */
   async emitEntry(code, path, options = {}) {
     const entryPath = appendPath(replacePath(replacePath(replacePath(path, this.entryPath), this.config.projectRoot), this.workspaceConfig.workspaceRoot), this.entryPath);
-    if (this.$$internal.entry) {
-      this.$$internal.entry.push({
-        name: options.name,
-        file: entryPath,
-        input: options.input,
-        output: options.output
-      });
-    }
     return this.emit(code, entryPath, defu7({
       meta: {
         type: "entry",
@@ -3471,14 +3434,6 @@ var PowerlinesContext = class _PowerlinesContext {
   */
   emitEntrySync(code, path, options = {}) {
     const entryPath = appendPath(replacePath(replacePath(replacePath(path, this.entryPath), this.config.projectRoot), this.workspaceConfig.workspaceRoot), this.entryPath);
-    if (this.$$internal.entry) {
-      this.$$internal.entry.push({
-        name: options?.name,
-        file: entryPath,
-        input: options?.input,
-        output: options?.output
-      });
-    }
     return this.emitSync(code, entryPath, defu7({
       meta: {
         type: "entry",
@@ -3620,8 +3575,8 @@ var PowerlinesContext = class _PowerlinesContext {
   * @param name - The name to use for the logger instance
   * @returns A logger function
   */
-  createLog(name = null) {
-    return createLog(name, {
+  createLog(name2 = null) {
+    return createLog(name2, {
       ...this.config,
       logLevel: isNull(this.config.logLevel) ? "silent" : this.config.logLevel
     });
@@ -3632,8 +3587,8 @@ var PowerlinesContext = class _PowerlinesContext {
   * @param name - The name to use for the extended logger instance
   * @returns A logger function
   */
-  extendLog(name) {
-    return extendLog(this.log, name);
+  extendLog(name2) {
+    return extendLog(this.log, name2);
   }
   /**
   * Generates a checksum representing the current context state
@@ -4257,7 +4212,7 @@ var PowerlinesAPIContext = class _PowerlinesAPIContext extends PowerlinesContext
   */
   async init(config = {}) {
     await super.init(config);
-    await Promise.all(toArray(this.config.userConfig.environments && Object.keys(this.config.userConfig.environments).length > 0 ? Object.keys(this.config.userConfig.environments).map((name) => createEnvironment(name, this.config.userConfig)) : createDefaultEnvironment(this.config.userConfig)).map(async (env) => {
+    await Promise.all(toArray(this.config.userConfig.environments && Object.keys(this.config.userConfig.environments).length > 0 ? Object.keys(this.config.userConfig.environments).map((name2) => createEnvironment(name2, this.config.userConfig)) : createDefaultEnvironment(this.config.userConfig)).map(async (env) => {
       this.#environments[env.name] = await this.in(env);
     }));
   }
@@ -4293,8 +4248,8 @@ var PowerlinesAPIContext = class _PowerlinesAPIContext extends PowerlinesContext
     isHighPriority: true
   }) {
     await super.withUserConfig(userConfig, options);
-    await Promise.all(Object.keys(this.#environments).map(async (name) => {
-      await this.#environments[name].withUserConfig(userConfig, options);
+    await Promise.all(Object.keys(this.#environments).map(async (name2) => {
+      await this.#environments[name2].withUserConfig(userConfig, options);
     }));
   }
   /**
@@ -4306,8 +4261,8 @@ var PowerlinesAPIContext = class _PowerlinesAPIContext extends PowerlinesContext
     isHighPriority: true
   }) {
     await super.withInlineConfig(inlineConfig, options);
-    await Promise.all(Object.keys(this.#environments).map(async (name) => {
-      await this.#environments[name].withInlineConfig(inlineConfig, options);
+    await Promise.all(Object.keys(this.#environments).map(async (name2) => {
+      await this.#environments[name2].withInlineConfig(inlineConfig, options);
     }));
   }
   /**
@@ -4317,8 +4272,8 @@ var PowerlinesAPIContext = class _PowerlinesAPIContext extends PowerlinesContext
   */
   async addPlugin(plugin) {
     this.plugins.push(plugin);
-    await Promise.all(Object.keys(this.environments).map(async (name) => {
-      await this.environments[name].addPlugin(plugin);
+    await Promise.all(Object.keys(this.environments).map(async (name2) => {
+      await this.environments[name2].addPlugin(plugin);
     }));
   }
   /**
@@ -4327,18 +4282,18 @@ var PowerlinesAPIContext = class _PowerlinesAPIContext extends PowerlinesContext
   * @param name - The name of the environment to retrieve.
   * @returns The requested environment context.
   */
-  async getEnvironment(name) {
+  async getEnvironment(name2) {
     let environment;
-    if (name) {
-      environment = this.environments[name];
+    if (name2) {
+      environment = this.environments[name2];
     }
     if (Object.keys(this.environments).length === 1) {
       environment = this.environments[Object.keys(this.environments)[0]];
       this.log(LogLevelLabel.DEBUG, `Applying the only configured environment: ${chalk5.bold.cyanBright(environment?.environment.name)}`);
     }
     if (!environment) {
-      if (name) {
-        throw new Error(`Environment "${name}" not found.`);
+      if (name2) {
+        throw new Error(`Environment "${name2}" not found.`);
       }
       environment = await this.in(createDefaultEnvironment(this.config.userConfig));
       this.log(LogLevelLabel.WARN, `No environment specified, and no default environment found. Using a temporary default environment: ${chalk5.bold.cyanBright(environment?.environment.name)}`);
@@ -4351,9 +4306,9 @@ var PowerlinesAPIContext = class _PowerlinesAPIContext extends PowerlinesContext
   * @param name - The name of the environment to retrieve.
   * @returns The requested environment context or `undefined` if not found.
   */
-  async getEnvironmentSafe(name) {
+  async getEnvironmentSafe(name2) {
     try {
-      return await this.getEnvironment(name);
+      return await this.getEnvironment(name2);
     } catch {
       return void 0;
     }
@@ -4432,14 +4387,14 @@ var PowerlinesAPI = class _PowerlinesAPI {
     const api = new _PowerlinesAPI(await PowerlinesAPIContext.from(workspaceRoot, config));
     api.#context.$$internal = {
       api,
-      addPlugin: api.#addPlugin.bind(api),
-      entry: []
+      addPlugin: api.#addPlugin.bind(api)
     };
+    api.context.info(`\u{1F50C} The Powerlines v${package_default.version} engine has started`);
     for (const plugin of api.context.config.plugins ?? []) {
       await api.#addPlugin(plugin);
     }
     if (api.context.plugins.length === 0) {
-      api.context.log(LogLevelLabel.WARN, "No Powerlines plugins were specified in the options. Please ensure this is correct, as it is generally not recommended.");
+      api.context.warn("No Powerlines plugins were specified in the options. Please ensure this is correct, as it is generally not recommended.");
     }
     const pluginConfig = await api.callHook("config", {
       environment: await api.context.getEnvironment(),
@@ -4462,11 +4417,11 @@ var PowerlinesAPI = class _PowerlinesAPI {
   async prepare(inlineConfig = {
     command: "prepare"
   }) {
-    this.context.log(LogLevelLabel.TRACE, " \u{1F3D7}\uFE0F  Preparing the Powerlines project");
-    this.context.log(LogLevelLabel.TRACE, " \u2699\uFE0F  Aggregating configuration options for the Powerlines project");
+    this.context.info(" \u{1F3D7}\uFE0F  Preparing the Powerlines project");
+    this.context.debug(" \u2699\uFE0F  Aggregating configuration options for the Powerlines project");
     await this.context.withInlineConfig(inlineConfig);
     await this.#executeEnvironments(async (context) => {
-      context.log(LogLevelLabel.TRACE, `Initializing the processing options for the Powerlines project.`);
+      context.debug(`Initializing the processing options for the Powerlines project.`);
       await this.callHook("configResolved", {
         environment: context,
         order: "pre"
@@ -4476,7 +4431,7 @@ var PowerlinesAPI = class _PowerlinesAPI {
         environment: context,
         order: "normal"
       });
-      context.log(LogLevelLabel.DEBUG, `The configuration provided ${toArray(context.config.entry).length} entry point(s), Powerlines has found ${context.entry.length} entry files(s) for the ${context.config.title} project${context.entry.length > 0 && context.entry.length < 10 ? `: 
+      context.debug(`The configuration provided ${toArray(context.config.entry).length} entry point(s), Powerlines has found ${context.entry.length} entry files(s) for the ${context.config.title} project${context.entry.length > 0 && context.entry.length < 10 ? `: 
 ${context.entry.map((entry) => `- ${entry.file}${entry.output ? ` -> ${entry.output}` : ""}`).join(" \n")}` : ""}.`);
       await resolveTsconfig(context);
       await installDependencies(context);
@@ -4484,7 +4439,7 @@ ${context.entry.map((entry) => `- ${entry.file}${entry.output ? ` -> ${entry.out
         environment: context,
         order: "post"
       });
-      context.log(LogLevelLabel.TRACE, `Powerlines configuration has been resolved: 
+      context.trace(`Powerlines configuration has been resolved: 
 
 ${formatLogMessage(context.config)}`);
       if (!context.fs.existsSync(context.cachePath)) {
@@ -4502,11 +4457,11 @@ ${formatLogMessage(context.config)}`);
         order: "normal"
       });
       if (context.config.output.dts !== false) {
-        context.log(LogLevelLabel.TRACE, `Preparing the TypeScript definitions for the Powerlines project.`);
+        context.debug(`Preparing the TypeScript definitions for the Powerlines project.`);
         if (context.fs.existsSync(context.dtsPath)) {
           await context.fs.remove(context.dtsPath);
         }
-        context.log(LogLevelLabel.TRACE, "Transforming built-ins runtime modules files.");
+        context.debug("Transforming built-ins runtime modules files.");
         const builtinFilePaths = await Promise.all((await context.getBuiltins()).map(async (file) => {
           const result2 = await transformAsync(file.code.toString(), {
             highlightCode: true,
@@ -4539,7 +4494,7 @@ ${formatLogMessage(context.config)}`);
             context.warn(`File ID is missing for a built-in runtime file at ${file.path}.`);
             file.id = replacePath(replacePath(file.path, context.workspaceConfig.workspaceRoot), context.builtinsPath);
           }
-          context.log(LogLevelLabel.TRACE, `Writing transformed built-in runtime file ${file.id}.`);
+          context.trace(`Writing transformed built-in runtime file ${file.id}.`);
           await context.emitBuiltin(result2.code, file.id);
           return file.path;
         }));
@@ -4558,9 +4513,9 @@ ${formatLogMessage(context.config)}`);
           []
           // [joinPaths(typescriptPath, "lib", "lib.esnext.full.d.ts")]
         );
-        context.log(LogLevelLabel.TRACE, "Parsing TypeScript configuration for the Powerlines project.");
+        context.debug("Parsing TypeScript configuration for the Powerlines project.");
         let types = await emitTypes(context, files);
-        context.log(LogLevelLabel.TRACE, `Generating TypeScript declaration file ${context.dtsPath}.`);
+        context.debug(`Generating TypeScript declaration file ${context.dtsPath}.`);
         const directives = [];
         const asNextParam = /* @__PURE__ */ __name((previousResult) => isObject(previousResult) ? previousResult.code : previousResult, "asNextParam");
         let result = await this.callHook("types", {
@@ -4637,7 +4592,7 @@ ${formatTypes(types)}
       if (!context.tsconfig) {
         throw new Error("Failed to parse the TypeScript configuration file.");
       }
-      this.context.log(LogLevelLabel.DEBUG, "Formatting files generated during the prepare step.");
+      this.context.debug("Formatting files generated during the prepare step.");
       await Promise.all([
         formatFolder(context, context.builtinsPath),
         formatFolder(context, context.entryPath)
@@ -4649,7 +4604,7 @@ ${formatTypes(types)}
       await writeMetaFile(context);
       context.persistedMeta = context.meta;
     });
-    this.context.log(LogLevelLabel.INFO, "Powerlines API has been prepared successfully");
+    this.context.info("\u2714 Powerlines preparation has completed successfully");
   }
   /**
   * Create a new Powerlines project
@@ -4661,17 +4616,17 @@ ${formatTypes(types)}
   * @returns A promise that resolves when the project has been created
   */
   async new(inlineConfig) {
-    this.context.log(LogLevelLabel.INFO, "\u{1F195} Creating a new Powerlines project");
+    this.context.info("\u{1F195} Creating a new Powerlines project");
     await this.prepare(inlineConfig);
     await this.#executeEnvironments(async (context) => {
-      context.log(LogLevelLabel.TRACE, `Initializing the processing options for the Powerlines project.`);
+      context.debug("Initializing the processing options for the Powerlines project.");
       await this.callHook("new", {
         environment: context,
         order: "pre"
       });
       const files = await listFiles(joinPaths$1(context.powerlinesPath, "files/common/**/*.hbs"));
       for (const file of files) {
-        context.log(LogLevelLabel.TRACE, `Adding template file: ${file}`);
+        context.trace(`Adding template file to project: ${file}`);
         const template = Handlebars.compile(file);
         await context.fs.write(joinPaths$1(context.config.projectRoot, file.replace(".hbs", "")), template(context));
       }
@@ -4682,14 +4637,14 @@ ${formatTypes(types)}
       if (context.config.projectType === "application") {
         const files2 = await listFiles(joinPaths$1(context.powerlinesPath, "files/application/**/*.hbs"));
         for (const file of files2) {
-          context.log(LogLevelLabel.TRACE, `Adding application template file: ${file}`);
+          context.trace(`Adding application template file: ${file}`);
           const template = Handlebars.compile(file);
           await context.fs.write(joinPaths$1(context.config.projectRoot, file.replace(".hbs", "")), template(context));
         }
       } else {
         const files2 = await listFiles(joinPaths$1(context.powerlinesPath, "files/library/**/*.hbs"));
         for (const file of files2) {
-          context.log(LogLevelLabel.TRACE, `Adding library template file: ${file}`);
+          context.trace(`Adding library template file: ${file}`);
           const template = Handlebars.compile(file);
           await context.fs.write(joinPaths$1(context.config.projectRoot, file.replace(".hbs", "")), template(context));
         }
@@ -4699,7 +4654,7 @@ ${formatTypes(types)}
         order: "post"
       });
     });
-    this.context.log(LogLevelLabel.TRACE, "Powerlines - New command completed");
+    this.context.debug("\u2714 Powerlines new command completed successfully");
   }
   /**
   * Clean any previously prepared artifacts
@@ -4713,10 +4668,10 @@ ${formatTypes(types)}
   async clean(inlineConfig = {
     command: "clean"
   }) {
-    this.context.log(LogLevelLabel.INFO, "\u{1F9F9} Cleaning the previous Powerlines artifacts");
+    this.context.info("\u{1F9F9} Cleaning the previous Powerlines artifacts");
     await this.prepare(inlineConfig);
     await this.#executeEnvironments(async (context) => {
-      this.context.log(LogLevelLabel.TRACE, "Cleaning the project's dist and artifacts directories.");
+      context.debug("Cleaning the project's dist and artifacts directories.");
       await context.fs.remove(joinPaths$1(context.workspaceConfig.workspaceRoot, context.config.output.buildPath));
       await context.fs.remove(joinPaths$1(context.workspaceConfig.workspaceRoot, context.config.projectRoot, context.config.output.artifactsPath));
       await this.callHook("clean", {
@@ -4724,7 +4679,7 @@ ${formatTypes(types)}
         sequential: false
       });
     });
-    this.context.log(LogLevelLabel.TRACE, "Powerlines - Clean command completed");
+    this.context.debug("\u2714 Powerlines cleaning completed successfully");
   }
   /**
   * Lint the project
@@ -4735,7 +4690,7 @@ ${formatTypes(types)}
   async lint(inlineConfig = {
     command: "lint"
   }) {
-    this.context.log(LogLevelLabel.INFO, "\u{1F4CB} Linting the Powerlines project");
+    this.context.info("\u{1F4CB} Linting the Powerlines project");
     await this.prepare(inlineConfig);
     await this.#executeEnvironments(async (context) => {
       if (context.config.lint !== false) {
@@ -4745,7 +4700,7 @@ ${formatTypes(types)}
         });
       }
     });
-    this.context.log(LogLevelLabel.TRACE, "Powerlines linting completed");
+    this.context.debug("\u2714 Powerlines linting completed successfully");
   }
   /**
   * Build the project
@@ -4759,7 +4714,7 @@ ${formatTypes(types)}
   async build(inlineConfig = {
     command: "build"
   }) {
-    this.context.log(LogLevelLabel.INFO, "\u{1F4E6}  Building the Powerlines project");
+    this.context.info("\u{1F4E6}  Building the Powerlines project");
     await this.prepare(inlineConfig);
     if (this.context.config.singleBuild) {
       await this.#handleBuild(await this.#context.toEnvironment());
@@ -4768,7 +4723,7 @@ ${formatTypes(types)}
         await this.#handleBuild(context);
       });
     }
-    this.context.log(LogLevelLabel.TRACE, "Powerlines build completed");
+    this.context.debug("\u2714 Powerlines build completed successfully");
   }
   /**
   * Prepare the documentation for the project
@@ -4779,10 +4734,10 @@ ${formatTypes(types)}
   async docs(inlineConfig = {
     command: "docs"
   }) {
-    this.context.log(LogLevelLabel.INFO, "\u{1F4D3} Generating documentation for the Powerlines project");
+    this.context.info("\u{1F4D3} Generating documentation for the Powerlines project");
     await this.prepare(inlineConfig);
     await this.#executeEnvironments(async (context) => {
-      context.log(LogLevelLabel.TRACE, "Writing documentation for the Powerlines project artifacts.");
+      context.debug("Writing documentation for the Powerlines project artifacts.");
       await this.prepare(inlineConfig);
       await this.#executeEnvironments(async (context2) => {
         await this.callHook("docs", {
@@ -4790,7 +4745,7 @@ ${formatTypes(types)}
         });
       });
     });
-    this.#context.log(LogLevelLabel.TRACE, "Powerlines documentation generation completed");
+    this.context.debug("\u2714 Powerlines documentation generation completed successfully");
   }
   /**
   * Deploy the project source code
@@ -4803,14 +4758,14 @@ ${formatTypes(types)}
   async deploy(inlineConfig = {
     command: "deploy"
   }) {
-    this.context.log(LogLevelLabel.INFO, "\u{1F4E6} Deploying the Powerlines project");
+    this.context.info("\u{1F680} Deploying the Powerlines project");
     await this.prepare(inlineConfig);
     await this.#executeEnvironments(async (context) => {
       await this.callHook("deploy", {
         environment: context
       });
     });
-    this.context.log(LogLevelLabel.TRACE, "Powerlines deploy completed");
+    this.context.debug("\u2714 Powerlines deploy completed successfully");
   }
   /**
   * Finalization process
@@ -4821,14 +4776,14 @@ ${formatTypes(types)}
   * @returns A promise that resolves when the finalization process has completed
   */
   async finalize() {
-    this.context.log(LogLevelLabel.TRACE, "Powerlines finalize execution started");
+    this.context.info("\u{1F3C1} Powerlines finalization processes started");
     await this.#executeEnvironments(async (context) => {
       await this.callHook("finalize", {
         environment: context
       });
       await context.fs.dispose();
     });
-    this.context.log(LogLevelLabel.TRACE, "Powerlines finalize execution completed");
+    this.context.debug("\u2714 Powerlines finalization completed successfully");
   }
   /**
   * Invokes the configured plugin hooks
@@ -4869,12 +4824,12 @@ ${formatTypes(types)}
       const sourcePath = appendPath(context.config.output.buildPath, context.workspaceConfig.workspaceRoot);
       const destinationPath = joinPaths$1(appendPath(context.config.output.outputPath, context.workspaceConfig.workspaceRoot), "dist");
       if (context.fs.existsSync(sourcePath) && sourcePath !== destinationPath) {
-        context.log(LogLevelLabel.INFO, `Copying build output files from project's build directory (${context.config.output.buildPath}) to the workspace's output directory (${context.config.output.outputPath}).`);
+        context.debug(`Copying build output files from project's build directory (${context.config.output.buildPath}) to the workspace's output directory (${context.config.output.outputPath}).`);
         await context.fs.copy(sourcePath, destinationPath);
       }
     }
     await Promise.all(context.config.output.assets.map(async (asset) => {
-      context.log(LogLevelLabel.DEBUG, `Copying asset(s): ${chalk5.redBright(context.workspaceConfig.workspaceRoot === asset.input ? asset.glob : joinPaths$1(replacePath(asset.input, context.workspaceConfig.workspaceRoot), asset.glob))} -> ${chalk5.greenBright(joinPaths$1(replacePath(asset.output, context.workspaceConfig.workspaceRoot), asset.glob))} ${Array.isArray(asset.ignore) && asset.ignore.length > 0 ? ` (ignoring: ${asset.ignore.map((i) => chalk5.yellowBright(i)).join(", ")})` : ""}`);
+      context.trace(`Copying asset(s): ${chalk5.redBright(context.workspaceConfig.workspaceRoot === asset.input ? asset.glob : joinPaths$1(replacePath(asset.input, context.workspaceConfig.workspaceRoot), asset.glob))} -> ${chalk5.greenBright(joinPaths$1(replacePath(asset.output, context.workspaceConfig.workspaceRoot), asset.glob))} ${Array.isArray(asset.ignore) && asset.ignore.length > 0 ? ` (ignoring: ${asset.ignore.map((i) => chalk5.yellowBright(i)).join(", ")})` : ""}`);
       await context.fs.copy(asset, asset.output);
     }));
     await this.callHook("build", {
@@ -4889,23 +4844,23 @@ ${formatTypes(types)}
   */
   async #getEnvironments() {
     if (!this.context.config.environments || Object.keys(this.context.config.environments).length <= 1) {
-      this.context.log(LogLevelLabel.DEBUG, "No environments are configured for this Powerlines project. Using the default environment.");
+      this.context.debug("No environments are configured for this Powerlines project. Using the default environment.");
       return [
         await this.context.getEnvironment()
       ];
     }
-    this.context.log(LogLevelLabel.DEBUG, `Found ${Object.keys(this.context.config.environments).length} configured environment(s) for this Powerlines project.`);
-    return (await Promise.all(Object.entries(this.context.config.environments).map(async ([name, config]) => {
-      const environment = await this.context.getEnvironmentSafe(name);
+    this.context.debug(`Found ${Object.keys(this.context.config.environments).length} configured environment(s) for this Powerlines project.`);
+    return (await Promise.all(Object.entries(this.context.config.environments).map(async ([name2, config]) => {
+      const environment = await this.context.getEnvironmentSafe(name2);
       if (!environment) {
         const resolvedEnvironment = await this.callHook("configEnvironment", {
-          environment: name
-        }, name, config);
+          environment: name2
+        }, name2, config);
         if (resolvedEnvironment) {
-          this.context.environments[name] = await this.context.in(resolvedEnvironment);
+          this.context.environments[name2] = await this.context.in(resolvedEnvironment);
         }
       }
-      return this.context.environments[name];
+      return this.context.environments[name2];
     }))).filter((context) => isSet(context));
   }
   /**
@@ -4930,7 +4885,7 @@ ${formatTypes(types)}
         return;
       }
       for (const plugin of result) {
-        this.context.log(LogLevelLabel.DEBUG, `Successfully initialized the ${chalk5.bold.cyanBright(plugin.name)} plugin`);
+        this.context.debug(`Successfully initialized the ${chalk5.bold.cyanBright(plugin.name)} plugin`);
         await this.context.addPlugin(plugin);
       }
     }
@@ -5017,10 +4972,10 @@ Please ensure the value is one of the following:
     const result = [];
     for (const plugin of plugins) {
       if (checkDedupe(plugin, this.context.plugins)) {
-        this.context.log(LogLevelLabel.TRACE, `Duplicate ${chalk5.bold.cyanBright(plugin.name)} plugin dependency detected - Skipping initialization.`);
+        this.context.trace(`Duplicate ${chalk5.bold.cyanBright(plugin.name)} plugin dependency detected - Skipping initialization.`);
       } else {
         result.push(plugin);
-        this.context.log(LogLevelLabel.TRACE, `Initializing the ${chalk5.bold.cyanBright(plugin.name)} plugin...`);
+        this.context.trace(`Initializing the ${chalk5.bold.cyanBright(plugin.name)} plugin...`);
       }
     }
     return result;
@@ -5037,12 +4992,12 @@ Please ensure the value is one of the following:
       ]
     });
     if (!isInstalled && this.context.config.skipInstalls !== true) {
-      this.#context.log(LogLevelLabel.WARN, `The plugin package "${pluginPath}" is not installed. It will be installed automatically.`);
+      this.#context.warn(`The plugin package "${pluginPath}" is not installed. It will be installed automatically.`);
       const result = await install(pluginPath, {
         cwd: this.context.config.projectRoot
       });
       if (isNumber(result.exitCode) && result.exitCode > 0) {
-        this.#context.log(LogLevelLabel.ERROR, result.stderr);
+        this.#context.error(result.stderr);
         throw new Error(`An error occurred while installing the build plugin package "${pluginPath}" `);
       }
     }
@@ -5075,6 +5030,6 @@ Note: Please ensure the plugin package's default export is a class that extends
   }
 };
 
-export { FileId, FileMetadata, FileMetadata_KeyValuePair, FileStorage, FileSystem, PowerlinesAPI, _capnpFileId, combineContexts, createLog, extendLog, isUnpluginBuilderVariant };
-//# sourceMappingURL=chunk-YL3OE2WO.js.map
-//# sourceMappingURL=chunk-YL3OE2WO.js.map
+export { FileId, FileMetadata, FileMetadata_KeyValuePair, FileStorage, FileSystem, PowerlinesAPI, _capnpFileId, combineContexts, createLog, extendLog, isUnpluginBuilderVariant, name, version };
+//# sourceMappingURL=chunk-DFHVFK5Q.js.map
+//# sourceMappingURL=chunk-DFHVFK5Q.js.map