powerlines 0.37.31 → 0.37.32

package/dist/{chunk-ST65VKTR.cjs → chunk-3ZV6MOMH.cjs}

@@ -5,7 +5,6 @@ var chunkV5WOGN7O_cjs = require('./chunk-V5WOGN7O.cjs');
 var chunkPK6SKIKE_cjs = require('./chunk-PK6SKIKE.cjs');
 var core = require('@babel/core');
 var console = require('@storm-software/config-tools/logger/console');
-var types = require('@storm-software/config-tools/types');
 var toArray = require('@stryke/convert/to-array');
 var helpers = require('@stryke/fs/helpers');
 var install = require('@stryke/fs/install');
@@ -28,6 +27,7 @@ var chalk5 = require('chalk');
 var Handlebars = require('handlebars');
 var helperPluginUtils = require('@babel/helper-plugin-utils');
 var t = require('@babel/types');
+var types = require('@storm-software/config-tools/types');
 var ts = require('typescript');
 var defu7 = require('defu');
 var tsMorph = require('ts-morph');
@@ -107,6 +107,11 @@ var ts__default = /*#__PURE__*/_interopDefault(ts);
 var defu7__default = /*#__PURE__*/_interopDefault(defu7);
 var $__namespace = /*#__PURE__*/_interopNamespace($);
 
+// package.json
+var name = "powerlines";
+var version = "0.37.31";
+var package_default = {
+  version};
 function resolveModulePath(nodePath, state) {
   if (!t__namespace.isStringLiteral(nodePath.node)) {
     return;
@@ -146,8 +151,8 @@ function matchesPattern(state, calleePath, pattern) {
   if (!t__namespace.isIdentifier(node) || pattern.includes(".")) {
     return false;
   }
-  const name = pattern.split(".")[0];
-  return node.name === name;
+  const name2 = pattern.split(".")[0];
+  return node.name === name2;
 }
 chunkPK6SKIKE_cjs.__name(matchesPattern, "matchesPattern");
 var importVisitors = {
@@ -481,13 +486,13 @@ async function installDependencies(context) {
   }
   context.log(types.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, `${_package.getPackageName(name)}@${String(version)}`, false))),
-    Promise.all(Object.entries(context.devDependencies).map(async ([name, version]) => installPackage(context, `${_package.getPackageName(name)}@${String(version)}`, true)))
+    Promise.all(Object.entries(context.dependencies).map(async ([name2, version2]) => installPackage(context, `${_package.getPackageName(name2)}@${String(version2)}`, false))),
+    Promise.all(Object.entries(context.devDependencies).map(async ([name2, version2]) => installPackage(context, `${_package.getPackageName(name2)}@${String(version2)}`, true)))
   ]);
 }
 chunkPK6SKIKE_cjs.__name(installDependencies, "installDependencies");
@@ -706,9 +711,9 @@ var DEFAULT_ENVIRONMENT = "default";
 var GLOBAL_ENVIRONMENT = "__global__";
 
 // src/internal/helpers/environment.ts
-function createEnvironment(name, userConfig) {
-  return defu7__default.default(userConfig.environments?.[name] ?? {}, {
-    name,
+function createEnvironment(name2, userConfig) {
+  return defu7__default.default(userConfig.environments?.[name2] ?? {}, {
+    name: name2,
     title: userConfig.title || titleCase.titleCase(userConfig.name),
     ssr: false,
     mainFields: userConfig.build?.platform === "browser" ? [
@@ -936,19 +941,39 @@ function resolveEntry(context, typeDefinition) {
   };
 }
 chunkPK6SKIKE_cjs.__name(resolveEntry, "resolveEntry");
+function isTypeDefinition(entry) {
+  return !isString.isString(entry) && entry.file !== void 0;
+}
+chunkPK6SKIKE_cjs.__name(isTypeDefinition, "isTypeDefinition");
+function isResolvedEntryTypeDefinition(entry) {
+  return isTypeDefinition(entry) && entry.input !== void 0 && entry.output !== void 0;
+}
+chunkPK6SKIKE_cjs.__name(isResolvedEntryTypeDefinition, "isResolvedEntryTypeDefinition");
 function resolveEntriesSync(context, typeDefinitions) {
-  return typeDefinitions.map((entry) => isString.isString(entry) ? replacePathTokens(context, entry) : replacePathTokens(context, entry.file)).map((typeDefinition) => {
-    const parsed = parseTypeDefinition.parseTypeDefinition(typeDefinition);
-    const filePath = append.appendPath(parsed.file, context.config.projectRoot);
+  return typeDefinitions.map((entry) => {
+    if (isResolvedEntryTypeDefinition(entry)) {
+      return {
+        ...entry,
+        file: replacePathTokens(context, entry.file)
+      };
+    }
+    let typeDefinition;
+    if (isString.isString(entry)) {
+      typeDefinition = parseTypeDefinition.parseTypeDefinition(replacePathTokens(context, entry));
+    } else {
+      typeDefinition = entry;
+      typeDefinition.file = replacePathTokens(context, typeDefinition.file);
+    }
+    const filePath = append.appendPath(typeDefinition.file, context.config.projectRoot);
     if (isFile.isFile(filePath)) {
       return resolveEntry(context, {
         file: replace.replacePath(filePath, context.config.projectRoot),
-        name: parsed.name
+        name: typeDefinition.name
       });
     }
     return listFiles.listFilesSync(filePath).map((file) => resolveEntry(context, {
       file,
-      name: parsed.name
+      name: typeDefinition.name
     }));
   }).flat().filter(Boolean);
 }
@@ -1181,7 +1206,7 @@ FileMetadata._Properties = $__namespace.CompositeList(FileMetadata_KeyValuePair)
 FileSystem._Ids = $__namespace.CompositeList(FileId);
 FileSystem._Storage = $__namespace.CompositeList(FileStorage);
 FileSystem._Metadata = $__namespace.CompositeList(FileMetadata);
-var createLog = /* @__PURE__ */ chunkPK6SKIKE_cjs.__name((name, options = {}) => {
+var createLog = /* @__PURE__ */ chunkPK6SKIKE_cjs.__name((name2, options = {}) => {
   const logLevel = options.logLevel === null ? types.LogLevelLabel.SILENT : options.logLevel || types.LogLevelLabel.INFO;
   if (logLevel === types.LogLevelLabel.SILENT) {
     return noop.noop;
@@ -1192,7 +1217,7 @@ var createLog = /* @__PURE__ */ chunkPK6SKIKE_cjs.__name((name, options = {}) =>
   return (type, ...args) => logger.getLogFn(logger.getLogLevel(type), {
     ...options,
     logLevel
-  })(`${chalk5__default.default.bold.hex(colors.getColor("brand", options))(`${name ? kebabCase.kebabCase(name) : ""}${options.name ? `${name ? chalk5__default.default.gray(" > ") : ""}${kebabCase.kebabCase(options.name)}` : ""}${chalk5__default.default.gray(" > ")}`)}${args.join(" ")} `.trim());
+  })(`${chalk5__default.default.bold.hex(colors.getColor("brand", options))(`${name2 ? kebabCase.kebabCase(name2) : ""}${options.name ? `${name2 ? chalk5__default.default.gray(" > ") : ""}${kebabCase.kebabCase(options.name)}` : ""}${chalk5__default.default.gray(" > ")}`)}${args.join(" ")} `.trim());
 }, "createLog");
 var BADGE_COLORS = [
   "#00A0DD",
@@ -1218,8 +1243,8 @@ var BADGE_COLORS = [
   "#34D399",
   "#8B5CF6"
 ];
-var extendLog = /* @__PURE__ */ chunkPK6SKIKE_cjs.__name((logFn, name) => {
-  return (type, ...args) => logFn(type, ` ${chalk5__default.default.inverse.hex(BADGE_COLORS[name.split("").map((char) => char.charCodeAt(0)).reduce((ret, charCode) => ret + charCode, 0) % BADGE_COLORS.length] || BADGE_COLORS[0])(` ${titleCase.titleCase(name)} `)}  ${args.join(" ")} `);
+var extendLog = /* @__PURE__ */ chunkPK6SKIKE_cjs.__name((logFn, name2) => {
+  return (type, ...args) => logFn(type, ` ${chalk5__default.default.inverse.hex(BADGE_COLORS[name2.split("").map((char) => char.charCodeAt(0)).reduce((ret, charCode) => ret + charCode, 0) % BADGE_COLORS.length] || BADGE_COLORS[0])(` ${titleCase.titleCase(name2)} `)}  ${args.join(" ")} `);
 }, "extendLog");
 async function format(path, data) {
   let code = data;
@@ -1878,12 +1903,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;
@@ -1894,37 +1919,6 @@ var VirtualFileSystem = class _VirtualFileSystem {
           }
         }));
       }
-      if (result.#metadata && Object.keys(result.#metadata).length > 0) {
-        result.#log(types.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.isSetString(meta.properties.name)) {
-              typeDefinition.name = meta.properties.name;
-            }
-            if (isSetString.isSetString(meta.properties["input.file"]) || isSetString.isSetString(meta.properties["input.name"])) {
-              typeDefinition.input ??= {};
-              if (isSetString.isSetString(meta.properties["input.file"])) {
-                typeDefinition.input.file = meta.properties["input.file"];
-              }
-              if (isSetString.isSetString(meta.properties["input.name"])) {
-                typeDefinition.input.name = meta.properties["input.name"];
-              }
-            }
-            if (isSetString.isSetString(meta.properties.output)) {
-              typeDefinition.output = meta.properties.output;
-            }
-            return typeDefinition;
-          }
-          return null;
-        }).filter(Boolean);
-        result.#log(types.LogLevelLabel.DEBUG, `Loaded ${entry.length} entry type definitions from VFS metadata.`);
-        context.entry = entry;
-      } else {
-        result.#log(types.LogLevelLabel.DEBUG, "No previously stored metadata records were found on the local system.");
-      }
     } else {
       const message = new $__namespace.Message();
       result = new _VirtualFileSystem(context, message.initRoot(FileSystem));
@@ -1955,11 +1949,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;
@@ -1971,37 +1965,6 @@ var VirtualFileSystem = class _VirtualFileSystem {
           }
         });
       }
-      if (result.#metadata && Object.keys(result.#metadata).length > 0) {
-        result.#log(types.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.isSetString(meta.properties.name)) {
-              typeDefinition.name = meta.properties.name;
-            }
-            if (isSetString.isSetString(meta.properties["input.file"]) || isSetString.isSetString(meta.properties["input.name"])) {
-              typeDefinition.input ??= {};
-              if (isSetString.isSetString(meta.properties["input.file"])) {
-                typeDefinition.input.file = meta.properties["input.file"];
-              }
-              if (isSetString.isSetString(meta.properties["input.name"])) {
-                typeDefinition.input.name = meta.properties["input.name"];
-              }
-            }
-            if (isSetString.isSetString(meta.properties.output)) {
-              typeDefinition.output = meta.properties.output;
-            }
-            return typeDefinition;
-          }
-          return null;
-        }).filter(Boolean);
-        result.#log(types.LogLevelLabel.DEBUG, `Loaded ${entry.length} entry type definitions from VFS metadata.`);
-        context.entry = entry;
-      } else {
-        result.#log(types.LogLevelLabel.DEBUG, "No previously stored metadata records were found on the local system.");
-      }
     } else {
       const message = new $__namespace.Message();
       result = new _VirtualFileSystem(context, message.initRoot(FileSystem));
@@ -2138,20 +2101,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 = {};
@@ -2845,8 +2794,8 @@ var VirtualFileSystem = class _VirtualFileSystem {
 };
 var PROJECT_ROOT_HASH_LENGTH = 45;
 var CACHE_HASH_LENGTH = 62;
-function getPrefixedProjectRootHash(name, projectRootHash) {
-  const combined = `${kebabCase.kebabCase(name)}_${projectRootHash}`;
+function getPrefixedProjectRootHash(name2, projectRootHash) {
+  const combined = `${kebabCase.kebabCase(name2)}_${projectRootHash}`;
   return combined.length > PROJECT_ROOT_HASH_LENGTH ? combined.slice(0, PROJECT_ROOT_HASH_LENGTH) : combined;
 }
 chunkPK6SKIKE_cjs.__name(getPrefixedProjectRootHash, "getPrefixedProjectRootHash");
@@ -2882,9 +2831,7 @@ var PowerlinesContext = class _PowerlinesContext {
   *
   * @internal
   */
-  #internal = {
-    entry: []
-  };
+  #internal = {};
   #workspaceConfig;
   #checksum = null;
   #buildId = uuid.uuid();
@@ -3005,13 +2952,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.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.toArray(this.config.entry) : entry);
   }
   /**
   * The TypeScript configuration parsed from the tsconfig file
@@ -3211,6 +3153,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.isSetString(meta.properties.name)) {
+          typeDefinition.name = meta.properties.name;
+        }
+        if (isSetString.isSetString(meta.properties["input.file"]) || isSetString.isSetString(meta.properties["input.name"])) {
+          typeDefinition.input ??= {};
+          if (isSetString.isSetString(meta.properties["input.file"])) {
+            typeDefinition.input.file = meta.properties["input.file"];
+          }
+          if (isSetString.isSetString(meta.properties["input.name"])) {
+            typeDefinition.input.name = meta.properties["input.name"];
+          }
+        }
+        if (isSetString.isSetString(meta.properties.output)) {
+          typeDefinition.output = meta.properties.output;
+        }
+        return typeDefinition;
+      }
+      return void 0;
+    }).filter(Boolean);
+  }
+  /**
   * A function to perform HTTP fetch requests
   *
   * @remarks
@@ -3468,14 +3439,6 @@ var PowerlinesContext = class _PowerlinesContext {
   */
   async emitEntry(code, path, options = {}) {
     const entryPath = append.appendPath(replace.replacePath(replace.replacePath(replace.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__default.default({
       meta: {
         type: "entry",
@@ -3500,14 +3463,6 @@ var PowerlinesContext = class _PowerlinesContext {
   */
   emitEntrySync(code, path, options = {}) {
     const entryPath = append.appendPath(replace.replacePath(replace.replacePath(replace.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__default.default({
       meta: {
         type: "entry",
@@ -3649,8 +3604,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.isNull(this.config.logLevel) ? "silent" : this.config.logLevel
     });
@@ -3661,8 +3616,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
@@ -4286,7 +4241,7 @@ var PowerlinesAPIContext = class _PowerlinesAPIContext extends PowerlinesContext
   */
   async init(config = {}) {
     await super.init(config);
-    await Promise.all(toArray.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.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);
     }));
   }
@@ -4322,8 +4277,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);
     }));
   }
   /**
@@ -4335,8 +4290,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);
     }));
   }
   /**
@@ -4346,8 +4301,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);
     }));
   }
   /**
@@ -4356,18 +4311,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(types.LogLevelLabel.DEBUG, `Applying the only configured environment: ${chalk5__default.default.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(types.LogLevelLabel.WARN, `No environment specified, and no default environment found. Using a temporary default environment: ${chalk5__default.default.bold.cyanBright(environment?.environment.name)}`);
@@ -4380,9 +4335,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;
     }
@@ -4461,14 +4416,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(types.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(),
@@ -4491,11 +4446,11 @@ var PowerlinesAPI = class _PowerlinesAPI {
   async prepare(inlineConfig = {
     command: "prepare"
   }) {
-    this.context.log(types.LogLevelLabel.TRACE, " \u{1F3D7}\uFE0F  Preparing the Powerlines project");
-    this.context.log(types.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(types.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"
@@ -4505,7 +4460,7 @@ var PowerlinesAPI = class _PowerlinesAPI {
         environment: context,
         order: "normal"
       });
-      context.log(types.LogLevelLabel.DEBUG, `The configuration provided ${toArray.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.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);
@@ -4513,7 +4468,7 @@ ${context.entry.map((entry) => `- ${entry.file}${entry.output ? ` -> ${entry.out
         environment: context,
         order: "post"
       });
-      context.log(types.LogLevelLabel.TRACE, `Powerlines configuration has been resolved: 
+      context.trace(`Powerlines configuration has been resolved: 
 
 ${console.formatLogMessage(context.config)}`);
       if (!context.fs.existsSync(context.cachePath)) {
@@ -4531,11 +4486,11 @@ ${console.formatLogMessage(context.config)}`);
         order: "normal"
       });
       if (context.config.output.dts !== false) {
-        context.log(types.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(types.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 core.transformAsync(file.code.toString(), {
             highlightCode: true,
@@ -4568,7 +4523,7 @@ ${console.formatLogMessage(context.config)}`);
             context.warn(`File ID is missing for a built-in runtime file at ${file.path}.`);
             file.id = replace.replacePath(replace.replacePath(file.path, context.workspaceConfig.workspaceRoot), context.builtinsPath);
           }
-          context.log(types.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;
         }));
@@ -4587,9 +4542,9 @@ ${console.formatLogMessage(context.config)}`);
           []
           // [joinPaths(typescriptPath, "lib", "lib.esnext.full.d.ts")]
         );
-        context.log(types.LogLevelLabel.TRACE, "Parsing TypeScript configuration for the Powerlines project.");
-        let types$1 = await emitTypes(context, files);
-        context.log(types.LogLevelLabel.TRACE, `Generating TypeScript declaration file ${context.dtsPath}.`);
+        context.debug("Parsing TypeScript configuration for the Powerlines project.");
+        let types = await emitTypes(context, files);
+        context.debug(`Generating TypeScript declaration file ${context.dtsPath}.`);
         const directives = [];
         const asNextParam = /* @__PURE__ */ chunkPK6SKIKE_cjs.__name((previousResult) => isObject.isObject(previousResult) ? previousResult.code : previousResult, "asNextParam");
         let result = await this.callHook("types", {
@@ -4598,15 +4553,15 @@ ${console.formatLogMessage(context.config)}`);
           order: "pre",
           result: "merge",
           asNextParam
-        }, types$1);
+        }, types);
         if (result) {
           if (isSetObject.isSetObject(result)) {
-            types$1 = result.code;
+            types = result.code;
             if (Array.isArray(result.directives) && result.directives.length > 0) {
               directives.push(...result.directives);
             }
           } else if (isSetString.isSetString(result)) {
-            types$1 = result;
+            types = result;
           }
         }
         result = await this.callHook("types", {
@@ -4615,15 +4570,15 @@ ${console.formatLogMessage(context.config)}`);
           order: "normal",
           result: "merge",
           asNextParam
-        }, types$1);
+        }, types);
         if (result) {
           if (isSetObject.isSetObject(result)) {
-            types$1 = result.code;
+            types = result.code;
             if (Array.isArray(result.directives) && result.directives.length > 0) {
               directives.push(...result.directives);
             }
           } else if (isSetString.isSetString(result)) {
-            types$1 = result;
+            types = result;
           }
         }
         result = await this.callHook("types", {
@@ -4632,18 +4587,18 @@ ${console.formatLogMessage(context.config)}`);
           order: "post",
           result: "merge",
           asNextParam
-        }, types$1);
+        }, types);
         if (result) {
           if (isSetObject.isSetObject(result)) {
-            types$1 = result.code;
+            types = result.code;
             if (Array.isArray(result.directives) && result.directives.length > 0) {
               directives.push(...result.directives);
             }
           } else if (isSetString.isSetString(result)) {
-            types$1 = result;
+            types = result;
           }
         }
-        if (types$1?.trim() || directives.length > 0) {
+        if (types?.trim() || directives.length > 0) {
           await context.fs.write(context.dtsPath, `${directives ? `${directives.map((directive) => `/// <reference types="${directive}" />`).join("\n")}
 
 ` : ""}${getFileHeader(context, {
@@ -4651,7 +4606,7 @@ ${console.formatLogMessage(context.config)}`);
             prettierIgnore: false
           })}
 
-${formatTypes(types$1)}
+${formatTypes(types)}
 `);
         } else {
           const dtsRelativePath = getTsconfigDtsPath(context);
@@ -4666,7 +4621,7 @@ ${formatTypes(types$1)}
       if (!context.tsconfig) {
         throw new Error("Failed to parse the TypeScript configuration file.");
       }
-      this.context.log(types.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)
@@ -4678,7 +4633,7 @@ ${formatTypes(types$1)}
       await writeMetaFile(context);
       context.persistedMeta = context.meta;
     });
-    this.context.log(types.LogLevelLabel.INFO, "Powerlines API has been prepared successfully");
+    this.context.info("\u2714 Powerlines preparation has completed successfully");
   }
   /**
   * Create a new Powerlines project
@@ -4690,17 +4645,17 @@ ${formatTypes(types$1)}
   * @returns A promise that resolves when the project has been created
   */
   async new(inlineConfig) {
-    this.context.log(types.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(types.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.listFiles(joinPaths.joinPaths(context.powerlinesPath, "files/common/**/*.hbs"));
       for (const file of files) {
-        context.log(types.LogLevelLabel.TRACE, `Adding template file: ${file}`);
+        context.trace(`Adding template file to project: ${file}`);
         const template = Handlebars__default.default.compile(file);
         await context.fs.write(joinPaths.joinPaths(context.config.projectRoot, file.replace(".hbs", "")), template(context));
       }
@@ -4711,14 +4666,14 @@ ${formatTypes(types$1)}
       if (context.config.projectType === "application") {
         const files2 = await listFiles.listFiles(joinPaths.joinPaths(context.powerlinesPath, "files/application/**/*.hbs"));
         for (const file of files2) {
-          context.log(types.LogLevelLabel.TRACE, `Adding application template file: ${file}`);
+          context.trace(`Adding application template file: ${file}`);
           const template = Handlebars__default.default.compile(file);
           await context.fs.write(joinPaths.joinPaths(context.config.projectRoot, file.replace(".hbs", "")), template(context));
         }
       } else {
         const files2 = await listFiles.listFiles(joinPaths.joinPaths(context.powerlinesPath, "files/library/**/*.hbs"));
         for (const file of files2) {
-          context.log(types.LogLevelLabel.TRACE, `Adding library template file: ${file}`);
+          context.trace(`Adding library template file: ${file}`);
           const template = Handlebars__default.default.compile(file);
           await context.fs.write(joinPaths.joinPaths(context.config.projectRoot, file.replace(".hbs", "")), template(context));
         }
@@ -4728,7 +4683,7 @@ ${formatTypes(types$1)}
         order: "post"
       });
     });
-    this.context.log(types.LogLevelLabel.TRACE, "Powerlines - New command completed");
+    this.context.debug("\u2714 Powerlines new command completed successfully");
   }
   /**
   * Clean any previously prepared artifacts
@@ -4742,10 +4697,10 @@ ${formatTypes(types$1)}
   async clean(inlineConfig = {
     command: "clean"
   }) {
-    this.context.log(types.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(types.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.joinPaths(context.workspaceConfig.workspaceRoot, context.config.output.buildPath));
       await context.fs.remove(joinPaths.joinPaths(context.workspaceConfig.workspaceRoot, context.config.projectRoot, context.config.output.artifactsPath));
       await this.callHook("clean", {
@@ -4753,7 +4708,7 @@ ${formatTypes(types$1)}
         sequential: false
       });
     });
-    this.context.log(types.LogLevelLabel.TRACE, "Powerlines - Clean command completed");
+    this.context.debug("\u2714 Powerlines cleaning completed successfully");
   }
   /**
   * Lint the project
@@ -4764,7 +4719,7 @@ ${formatTypes(types$1)}
   async lint(inlineConfig = {
     command: "lint"
   }) {
-    this.context.log(types.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) {
@@ -4774,7 +4729,7 @@ ${formatTypes(types$1)}
         });
       }
     });
-    this.context.log(types.LogLevelLabel.TRACE, "Powerlines linting completed");
+    this.context.debug("\u2714 Powerlines linting completed successfully");
   }
   /**
   * Build the project
@@ -4788,7 +4743,7 @@ ${formatTypes(types$1)}
   async build(inlineConfig = {
     command: "build"
   }) {
-    this.context.log(types.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());
@@ -4797,7 +4752,7 @@ ${formatTypes(types$1)}
         await this.#handleBuild(context);
       });
     }
-    this.context.log(types.LogLevelLabel.TRACE, "Powerlines build completed");
+    this.context.debug("\u2714 Powerlines build completed successfully");
   }
   /**
   * Prepare the documentation for the project
@@ -4808,10 +4763,10 @@ ${formatTypes(types$1)}
   async docs(inlineConfig = {
     command: "docs"
   }) {
-    this.context.log(types.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(types.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", {
@@ -4819,7 +4774,7 @@ ${formatTypes(types$1)}
         });
       });
     });
-    this.#context.log(types.LogLevelLabel.TRACE, "Powerlines documentation generation completed");
+    this.context.debug("\u2714 Powerlines documentation generation completed successfully");
   }
   /**
   * Deploy the project source code
@@ -4832,14 +4787,14 @@ ${formatTypes(types$1)}
   async deploy(inlineConfig = {
     command: "deploy"
   }) {
-    this.context.log(types.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(types.LogLevelLabel.TRACE, "Powerlines deploy completed");
+    this.context.debug("\u2714 Powerlines deploy completed successfully");
   }
   /**
   * Finalization process
@@ -4850,14 +4805,14 @@ ${formatTypes(types$1)}
   * @returns A promise that resolves when the finalization process has completed
   */
   async finalize() {
-    this.context.log(types.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(types.LogLevelLabel.TRACE, "Powerlines finalize execution completed");
+    this.context.debug("\u2714 Powerlines finalization completed successfully");
   }
   /**
   * Invokes the configured plugin hooks
@@ -4898,12 +4853,12 @@ ${formatTypes(types$1)}
       const sourcePath = append.appendPath(context.config.output.buildPath, context.workspaceConfig.workspaceRoot);
       const destinationPath = joinPaths.joinPaths(append.appendPath(context.config.output.outputPath, context.workspaceConfig.workspaceRoot), "dist");
       if (context.fs.existsSync(sourcePath) && sourcePath !== destinationPath) {
-        context.log(types.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(types.LogLevelLabel.DEBUG, `Copying asset(s): ${chalk5__default.default.redBright(context.workspaceConfig.workspaceRoot === asset.input ? asset.glob : joinPaths.joinPaths(replace.replacePath(asset.input, context.workspaceConfig.workspaceRoot), asset.glob))} -> ${chalk5__default.default.greenBright(joinPaths.joinPaths(replace.replacePath(asset.output, context.workspaceConfig.workspaceRoot), asset.glob))} ${Array.isArray(asset.ignore) && asset.ignore.length > 0 ? ` (ignoring: ${asset.ignore.map((i) => chalk5__default.default.yellowBright(i)).join(", ")})` : ""}`);
+      context.trace(`Copying asset(s): ${chalk5__default.default.redBright(context.workspaceConfig.workspaceRoot === asset.input ? asset.glob : joinPaths.joinPaths(replace.replacePath(asset.input, context.workspaceConfig.workspaceRoot), asset.glob))} -> ${chalk5__default.default.greenBright(joinPaths.joinPaths(replace.replacePath(asset.output, context.workspaceConfig.workspaceRoot), asset.glob))} ${Array.isArray(asset.ignore) && asset.ignore.length > 0 ? ` (ignoring: ${asset.ignore.map((i) => chalk5__default.default.yellowBright(i)).join(", ")})` : ""}`);
       await context.fs.copy(asset, asset.output);
     }));
     await this.callHook("build", {
@@ -4918,23 +4873,23 @@ ${formatTypes(types$1)}
   */
   async #getEnvironments() {
     if (!this.context.config.environments || Object.keys(this.context.config.environments).length <= 1) {
-      this.context.log(types.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(types.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.isSet(context));
   }
   /**
@@ -4959,7 +4914,7 @@ ${formatTypes(types$1)}
         return;
       }
       for (const plugin of result) {
-        this.context.log(types.LogLevelLabel.DEBUG, `Successfully initialized the ${chalk5__default.default.bold.cyanBright(plugin.name)} plugin`);
+        this.context.debug(`Successfully initialized the ${chalk5__default.default.bold.cyanBright(plugin.name)} plugin`);
         await this.context.addPlugin(plugin);
       }
     }
@@ -5046,10 +5001,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(types.LogLevelLabel.TRACE, `Duplicate ${chalk5__default.default.bold.cyanBright(plugin.name)} plugin dependency detected - Skipping initialization.`);
+        this.context.trace(`Duplicate ${chalk5__default.default.bold.cyanBright(plugin.name)} plugin dependency detected - Skipping initialization.`);
       } else {
         result.push(plugin);
-        this.context.log(types.LogLevelLabel.TRACE, `Initializing the ${chalk5__default.default.bold.cyanBright(plugin.name)} plugin...`);
+        this.context.trace(`Initializing the ${chalk5__default.default.bold.cyanBright(plugin.name)} plugin...`);
       }
     }
     return result;
@@ -5066,12 +5021,12 @@ Please ensure the value is one of the following:
       ]
     });
     if (!isInstalled && this.context.config.skipInstalls !== true) {
-      this.#context.log(types.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.install(pluginPath, {
         cwd: this.context.config.projectRoot
       });
       if (isNumber.isNumber(result.exitCode) && result.exitCode > 0) {
-        this.#context.log(types.LogLevelLabel.ERROR, result.stderr);
+        this.#context.error(result.stderr);
         throw new Error(`An error occurred while installing the build plugin package "${pluginPath}" `);
       }
     }
@@ -5115,5 +5070,7 @@ exports.combineContexts = combineContexts;
 exports.createLog = createLog;
 exports.extendLog = extendLog;
 exports.isUnpluginBuilderVariant = isUnpluginBuilderVariant;
-//# sourceMappingURL=chunk-ST65VKTR.cjs.map
-//# sourceMappingURL=chunk-ST65VKTR.cjs.map
+exports.name = name;
+exports.version = version;
+//# sourceMappingURL=chunk-3ZV6MOMH.cjs.map
+//# sourceMappingURL=chunk-3ZV6MOMH.cjs.map