@storm-software/unbuild 0.16.0 → 0.17.0

package/README.md

@@ -21,7 +21,7 @@ This package is part of the <b>⚡Storm-Ops</b> monorepo. The Storm-Ops packages
 
 <h3 align="center">💻 Visit <a href="https://stormsoftware.com" target="_blank">stormsoftware.com</a> to stay up to date with this developer</h3><br />
 
-[![Version](https://img.shields.io/badge/version-0.15.2-1fb2a6.svg?style=for-the-badge&color=1fb2a6)](https://prettier.io/)&nbsp;[![Nx](https://img.shields.io/badge/Nx-17.0.2-lightgrey?style=for-the-badge&logo=nx&logoWidth=20&&color=1fb2a6)](http://nx.dev/)&nbsp;[![NextJs](https://img.shields.io/badge/Next.js-14.0.2-lightgrey?style=for-the-badge&logo=nextdotjs&logoWidth=20&color=1fb2a6)](https://nextjs.org/)&nbsp;[![Commitizen friendly](https://img.shields.io/badge/commitizen-friendly-brightgreen.svg?style=for-the-badge&logo=commitlint&color=1fb2a6)](http://commitizen.github.io/cz-cli/)&nbsp;![Semantic-Release](https://img.shields.io/badge/%20%20%F0%9F%93%A6%F0%9F%9A%80-semantic--release-e10079.svg?style=for-the-badge&color=1fb2a6)&nbsp;[![documented with Fumadocs](https://img.shields.io/badge/documented_with-fumadocs-success.svg?style=for-the-badge&logo=readthedocs&color=1fb2a6)](https://fumadocs.vercel.app/)&nbsp;![GitHub Workflow Status (with event)](https://img.shields.io/github/actions/workflow/status/storm-software/storm-ops/cr.yml?style=for-the-badge&logo=github-actions&color=1fb2a6)
+[![Version](https://img.shields.io/badge/version-0.16.0-1fb2a6.svg?style=for-the-badge&color=1fb2a6)](https://prettier.io/)&nbsp;[![Nx](https://img.shields.io/badge/Nx-17.0.2-lightgrey?style=for-the-badge&logo=nx&logoWidth=20&&color=1fb2a6)](http://nx.dev/)&nbsp;[![NextJs](https://img.shields.io/badge/Next.js-14.0.2-lightgrey?style=for-the-badge&logo=nextdotjs&logoWidth=20&color=1fb2a6)](https://nextjs.org/)&nbsp;[![Commitizen friendly](https://img.shields.io/badge/commitizen-friendly-brightgreen.svg?style=for-the-badge&logo=commitlint&color=1fb2a6)](http://commitizen.github.io/cz-cli/)&nbsp;![Semantic-Release](https://img.shields.io/badge/%20%20%F0%9F%93%A6%F0%9F%9A%80-semantic--release-e10079.svg?style=for-the-badge&color=1fb2a6)&nbsp;[![documented with Fumadocs](https://img.shields.io/badge/documented_with-fumadocs-success.svg?style=for-the-badge&logo=readthedocs&color=1fb2a6)](https://fumadocs.vercel.app/)&nbsp;![GitHub Workflow Status (with event)](https://img.shields.io/github/actions/workflow/status/storm-software/storm-ops/cr.yml?style=for-the-badge&logo=github-actions&color=1fb2a6)
 
 <!-- prettier-ignore-start -->
 <!-- markdownlint-disable -->

package/bin/unbuild.cjs

@@ -0,0 +1,607 @@
+#!/usr/bin/env node
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+
+// bin/unbuild.ts
+var import_create_storm_config2 = require("@storm-software/config-tools/create-storm-config");
+var import_console4 = require("@storm-software/config-tools/logger/console");
+var import_find_workspace_root2 = require("@storm-software/config-tools/utilities/find-workspace-root");
+var import_process_handler = require("@storm-software/config-tools/utilities/process-handler");
+var import_commander = require("commander");
+
+// src/build.ts
+var import_node2 = require("@humanfs/node");
+var import_devkit3 = require("@nx/devkit");
+var import_js = require("@nx/js");
+var import_buildable_libs_utils3 = require("@nx/js/src/utils/buildable-libs-utils");
+var import_build_tools = require("@storm-software/build-tools");
+var import_create_storm_config = require("@storm-software/config-tools/create-storm-config");
+var import_console3 = require("@storm-software/config-tools/logger/console");
+var import_get_log_level = require("@storm-software/config-tools/logger/get-log-level");
+var import_types = require("@storm-software/config-tools/types");
+var import_correct_paths = require("@storm-software/config-tools/utilities/correct-paths");
+var import_defu = __toESM(require("defu"), 1);
+var import_node_path3 = require("path");
+var import_find_workspace_root = require("nx/src/utils/find-workspace-root");
+var import_unbuild = require("unbuild");
+
+// src/clean.ts
+var import_node = require("@humanfs/node");
+var import_console = require("@storm-software/config-tools/logger/console");
+async function clean(name = "Unbuild", directory, config) {
+  (0, import_console.writeDebug)(` \u{1F9F9}  Cleaning ${name} output path: ${directory}`, config);
+  const stopwatch = (0, import_console.getStopwatch)(`${name} output clean`);
+  await import_node.hfs.deleteAll(directory);
+  stopwatch();
+}
+__name(clean, "clean");
+
+// src/plugins/analyze.ts
+var import_config_tools = require("@storm-software/config-tools");
+var formatBytes = /* @__PURE__ */ __name((bytes) => {
+  if (bytes === 0) return "0 Byte";
+  const k = 1e3;
+  const dm = 3;
+  const sizes = [
+    "Bytes",
+    "KB",
+    "MB",
+    "GB"
+  ];
+  const i = Math.floor(Math.log(bytes) / Math.log(k));
+  return `${parseFloat((bytes / k ** i).toFixed(dm))} ${sizes[i]}`;
+}, "formatBytes");
+var analyzePlugin = /* @__PURE__ */ __name((options, resolvedOptions) => {
+  return {
+    name: "storm:analyzer",
+    renderChunk(source, chunk) {
+      const sourceBytes = formatBytes(source.length);
+      const fileName = chunk.fileName;
+      (0, import_config_tools.writeInfo)(` - ${fileName} ${sourceBytes}`, resolvedOptions.config);
+    }
+  };
+}, "analyzePlugin");
+
+// src/plugins/on-error.ts
+var import_config_tools2 = require("@storm-software/config-tools");
+var onErrorPlugin = /* @__PURE__ */ __name((options, resolvedOptions) => ({
+  name: "storm:on-error",
+  buildEnd(error) {
+    if (error) {
+      (0, import_config_tools2.writeError)(`The following errors occurred during the build:
+${error ? error.message : "Unknown build error"}
+
+    `, resolvedOptions.config);
+      throw new Error("Storm unbuild process failed with errors.");
+    }
+  },
+  renderError(error) {
+    (0, import_config_tools2.writeError)(`The following errors occurred during the build:
+${error ? error.message : "Unknown build error"}
+
+  `, resolvedOptions.config);
+    throw new Error("Storm unbuild process failed with errors.");
+  }
+}), "onErrorPlugin");
+
+// src/plugins/swc.ts
+var swcPlugin = /* @__PURE__ */ __name((options, resolvedOptions) => {
+  const { transform } = require("@swc/core");
+  return {
+    name: "storm:swc",
+    transform(code, filename) {
+      return transform(code, {
+        filename,
+        jsc: {
+          transform: {
+            react: {
+              runtime: "automatic"
+            }
+          }
+        }
+      });
+    }
+  };
+}, "swcPlugin");
+
+// src/plugins/tsc.ts
+var import_devkit2 = require("@nx/devkit");
+var import_buildable_libs_utils2 = require("@nx/js/src/utils/buildable-libs-utils");
+var import_compiler_helper_dependency = require("@nx/js/src/utils/compiler-helper-dependency");
+var import_rollup_plugin_typescript2 = __toESM(require("rollup-plugin-typescript2"), 1);
+
+// src/utilities/helpers.ts
+var import_devkit = require("@nx/devkit");
+var import_buildable_libs_utils = require("@nx/js/src/utils/buildable-libs-utils");
+var import_console2 = require("@storm-software/config-tools/logger/console");
+var import_node_path = require("path");
+var import_node_url = require("url");
+var import_typescript = __toESM(require("typescript"), 1);
+async function loadConfig(configPath) {
+  if (!/\.(js|mjs)$/.test((0, import_node_path.extname)(configPath))) {
+    throw new Error("Unsupported config file format");
+  }
+  return import((0, import_node_url.pathToFileURL)(configPath).toString()).then((config) => config.default);
+}
+__name(loadConfig, "loadConfig");
+async function createTsCompilerOptions(config, tsConfigPath, projectRoot, dependencies) {
+  const tsConfigFile = import_typescript.default.readConfigFile((0, import_devkit.joinPathFragments)(config.workspaceRoot, projectRoot, tsConfigPath), import_typescript.default.sys.readFile);
+  const tsConfig = import_typescript.default.parseJsonConfigFileContent(tsConfigFile.config, import_typescript.default.sys, (0, import_node_path.dirname)((0, import_devkit.joinPathFragments)(config.workspaceRoot, projectRoot, tsConfigPath)));
+  const compilerOptions = {
+    rootDir: projectRoot,
+    declaration: true,
+    paths: (0, import_buildable_libs_utils.computeCompilerOptionsPaths)(tsConfig, dependencies ?? [])
+  };
+  (0, import_console2.writeTrace)(compilerOptions, config);
+  return compilerOptions;
+}
+__name(createTsCompilerOptions, "createTsCompilerOptions");
+
+// src/plugins/tsc.ts
+var tscPlugin = /* @__PURE__ */ __name(async (options, resolvedOptions) => {
+  const projectGraph = await (0, import_devkit2.createProjectGraphAsync)({
+    exitOnError: true
+  });
+  const result = (0, import_buildable_libs_utils2.calculateProjectBuildableDependencies)(void 0, projectGraph, resolvedOptions.config.workspaceRoot, resolvedOptions.projectName, process.env.NX_TASK_TARGET_TARGET || "build", process.env.NX_TASK_TARGET_CONFIGURATION || "production", true);
+  let dependencies = result.dependencies;
+  const tsLibDependency = (0, import_compiler_helper_dependency.getHelperDependency)(import_compiler_helper_dependency.HelperDependency.tsc, resolvedOptions.tsconfig, dependencies, projectGraph, true);
+  if (tsLibDependency) {
+    dependencies = dependencies.filter((deps) => deps.name !== tsLibDependency.name);
+    dependencies.push(tsLibDependency);
+  }
+  return (0, import_rollup_plugin_typescript2.default)({
+    check: options.emitTypes !== false,
+    tsconfig: resolvedOptions.tsconfig,
+    tsconfigOverride: {
+      compilerOptions: await createTsCompilerOptions(resolvedOptions.config, resolvedOptions.tsconfig, resolvedOptions.projectRoot, dependencies)
+    }
+  });
+}, "tscPlugin");
+
+// src/plugins/type-definitions.ts
+var import_node_path2 = require("path");
+var typeDefinitions = /* @__PURE__ */ __name((options, resolvedOptions) => ({
+  name: "storm:dts-bundle",
+  async generateBundle(_opts, bundle) {
+    for (const file of Object.values(bundle)) {
+      if (file.type === "asset" || !file.isEntry || file.facadeModuleId == null) {
+        continue;
+      }
+      const hasDefaultExport = file.exports.includes("default");
+      const entrySourceFileName = (0, import_node_path2.relative)(options.projectRoot, file.facadeModuleId);
+      const entrySourceDtsName = entrySourceFileName.replace(/\.[cm]?[jt]sx?$/, "");
+      const dtsFileName = file.fileName.replace(/\.[cm]?js$/, ".d.ts");
+      const relativeSourceDtsName = JSON.stringify("./" + entrySourceDtsName);
+      const dtsFileSource = hasDefaultExport ? `
+export * from ${relativeSourceDtsName};
+export { default } from ${relativeSourceDtsName};
+            ` : `export * from ${relativeSourceDtsName};
+`;
+      this.emitFile({
+        type: "asset",
+        fileName: dtsFileName,
+        source: dtsFileSource
+      });
+    }
+  }
+}), "typeDefinitions");
+
+// src/config.ts
+var getDefaultBuildPlugins = /* @__PURE__ */ __name(async (options, resolvedOptions) => Promise.all([
+  analyzePlugin(options, resolvedOptions),
+  swcPlugin(options, resolvedOptions),
+  typeDefinitions(options, resolvedOptions),
+  tscPlugin(options, resolvedOptions),
+  onErrorPlugin(options, resolvedOptions)
+].map((plugin) => Promise.resolve(plugin))), "getDefaultBuildPlugins");
+
+// src/build.ts
+async function resolveOptions(options) {
+  const projectRoot = options.projectRoot;
+  if (!projectRoot) {
+    throw new Error("Cannot find project root");
+  }
+  const outputPath = options.outputPath || (0, import_correct_paths.joinPaths)("dist", projectRoot);
+  const workspaceRoot = (0, import_find_workspace_root.findWorkspaceRoot)(projectRoot);
+  if (!workspaceRoot) {
+    throw new Error("Cannot find workspace root");
+  }
+  const config = await (0, import_create_storm_config.loadStormConfig)(workspaceRoot.dir);
+  (0, import_console3.writeDebug)("  \u2699\uFE0F   Resolving build options", config);
+  const stopwatch = (0, import_console3.getStopwatch)("Build options resolution");
+  if (options.configPath) {
+    const configFile = await loadConfig(options.configPath);
+    if (configFile) {
+      options = (0, import_defu.default)(options, configFile);
+    }
+  }
+  const projectGraph = await (0, import_devkit3.createProjectGraphAsync)({
+    exitOnError: true
+  });
+  const projectJsonPath = (0, import_correct_paths.joinPaths)(config.workspaceRoot, projectRoot, "project.json");
+  if (!await import_node2.hfs.isFile(projectJsonPath)) {
+    throw new Error("Cannot find project.json configuration");
+  }
+  const projectJson = await import_node2.hfs.json(projectJsonPath);
+  const projectName = projectJson.name;
+  const packageJsonPath = (0, import_correct_paths.joinPaths)(workspaceRoot.dir, projectRoot, "package.json");
+  if (!await import_node2.hfs.isFile(packageJsonPath)) {
+    throw new Error("Cannot find package.json configuration");
+  }
+  const packageJson = await import_node2.hfs.json(packageJsonPath);
+  let tsconfig = options.tsconfig;
+  if (!tsconfig) {
+    tsconfig = (0, import_correct_paths.joinPaths)(workspaceRoot.dir, projectRoot, "tsconfig.json");
+  }
+  if (!await import_node2.hfs.isFile(tsconfig)) {
+    throw new Error("Cannot find tsconfig.json configuration");
+  }
+  let sourceRoot = projectJson.sourceRoot;
+  if (!sourceRoot) {
+    sourceRoot = (0, import_correct_paths.joinPaths)(projectRoot, "src");
+  }
+  if (!await import_node2.hfs.isDirectory(sourceRoot)) {
+    throw new Error("Cannot find sourceRoot directory");
+  }
+  const projectConfigurations = (0, import_devkit3.readProjectsConfigurationFromProjectGraph)(projectGraph);
+  if (!projectConfigurations?.projects?.[projectName]) {
+    throw new Error("The Build process failed because the project does not have a valid configuration in the project.json file. Check if the file exists in the root of the project.");
+  }
+  const result = (0, import_buildable_libs_utils3.calculateProjectBuildableDependencies)(void 0, projectGraph, workspaceRoot.dir, projectName, process.env.NX_TASK_TARGET_TARGET || "build", process.env.NX_TASK_TARGET_CONFIGURATION || "production", true);
+  let dependencies = result.dependencies;
+  const tsLibDependency = (0, import_js.getHelperDependency)(import_js.HelperDependency.tsc, tsconfig, dependencies, projectGraph, true);
+  if (tsLibDependency) {
+    dependencies = dependencies.filter((deps) => deps.name !== tsLibDependency.name);
+    dependencies.push(tsLibDependency);
+  }
+  const resolvedOptions = {
+    name: projectName,
+    config,
+    projectRoot,
+    sourceRoot,
+    projectName,
+    tsconfig,
+    clean: false,
+    entries: [
+      {
+        builder: "mkdist",
+        input: `.${sourceRoot.replace(projectRoot, "")}`,
+        outDir: (0, import_correct_paths.joinPaths)((0, import_node_path3.relative)((0, import_correct_paths.joinPaths)(config.workspaceRoot, projectRoot), config.workspaceRoot).replaceAll("\\", "/"), outputPath, "dist").replaceAll("\\", "/"),
+        declaration: options.emitTypes !== false,
+        format: "esm"
+      },
+      {
+        builder: "mkdist",
+        input: `.${sourceRoot.replace(projectRoot, "")}`,
+        outDir: (0, import_correct_paths.joinPaths)((0, import_node_path3.relative)((0, import_correct_paths.joinPaths)(config.workspaceRoot, projectRoot), config.workspaceRoot).replaceAll("\\", "/"), outputPath, "dist").replaceAll("\\", "/"),
+        declaration: options.emitTypes !== false,
+        format: "cjs",
+        ext: "cjs"
+      }
+    ],
+    declaration: options.emitTypes !== false ? "compatible" : false,
+    failOnWarn: false,
+    sourcemap: options.sourcemap ?? !!options.debug,
+    outDir: outputPath,
+    parallel: true,
+    stub: false,
+    stubOptions: {
+      jiti: {}
+    },
+    externals: options.external ?? [],
+    dependencies: [],
+    peerDependencies: [],
+    devDependencies: [],
+    hooks: {},
+    alias: {},
+    replace: {},
+    rollup: {
+      replace: {},
+      alias: {},
+      json: {},
+      commonjs: {
+        sourceMap: options.sourcemap ?? true
+      },
+      emitCJS: true,
+      cjsBridge: true,
+      dts: {
+        respectExternal: true,
+        tsconfig
+      },
+      output: {
+        banner: options.banner || `
+//      \u26A1 Built by Storm Software
+  `,
+        footer: options.footer
+      },
+      resolve: {
+        preferBuiltins: true,
+        extensions: [
+          ".cjs",
+          ".mjs",
+          ".js",
+          ".jsx",
+          ".ts",
+          ".tsx",
+          ".json"
+        ]
+      },
+      esbuild: {
+        minify: !!options.minify,
+        splitting: options.splitting !== false,
+        treeShaking: options.treeShaking !== false,
+        color: true,
+        logLevel: config.logLevel === import_types.LogLevelLabel.FATAL ? import_types.LogLevelLabel.ERROR : (0, import_get_log_level.isVerbose)() ? "verbose" : config.logLevel
+      }
+    }
+  };
+  dependencies = dependencies.filter((dep) => dep.node.type === "npm" || dep.node.type === "lib" || dep.node.type === "app");
+  if (dependencies.length > 0) {
+    resolvedOptions.dependencies = dependencies.map((dep) => dep.name);
+  }
+  if (packageJson.devDependencies) {
+    resolvedOptions.devDependencies = Object.keys(packageJson.devDependencies);
+  }
+  if (packageJson.peerDependencies) {
+    resolvedOptions.peerDependencies = Object.keys(packageJson.peerDependencies);
+  }
+  if (options.rollup) {
+    let rollup = {};
+    if (typeof options.rollup === "string") {
+      const rollupFile = await loadConfig(options.rollup);
+      if (rollupFile) {
+        rollup = rollupFile;
+      }
+    } else {
+      rollup = options.rollup;
+    }
+    resolvedOptions.rollup = (0, import_defu.default)(resolvedOptions.rollup ?? {}, rollup);
+  }
+  resolvedOptions.hooks = {
+    "rollup:options": /* @__PURE__ */ __name(async (ctx, opts) => {
+      opts.plugins = options.plugins ?? await getDefaultBuildPlugins(options, resolvedOptions);
+    }, "rollup:options")
+  };
+  stopwatch();
+  return resolvedOptions;
+}
+__name(resolveOptions, "resolveOptions");
+async function generatePackageJson(options) {
+  if (options.generatePackageJson !== false && await import_node2.hfs.isFile((0, import_correct_paths.joinPaths)(options.projectRoot, "package.json"))) {
+    (0, import_console3.writeDebug)("  \u270D\uFE0F   Writing package.json file", options.config);
+    const stopwatch = (0, import_console3.getStopwatch)("Write package.json file");
+    const packageJsonPath = (0, import_correct_paths.joinPaths)(options.projectRoot, "project.json");
+    if (!await import_node2.hfs.isFile(packageJsonPath)) {
+      throw new Error("Cannot find package.json configuration");
+    }
+    let packageJson = await import_node2.hfs.json((0, import_correct_paths.joinPaths)(options.config.workspaceRoot, options.projectRoot, "package.json"));
+    if (!packageJson) {
+      throw new Error("Cannot find package.json configuration file");
+    }
+    packageJson = await (0, import_build_tools.addPackageDependencies)(options.config.workspaceRoot, options.projectRoot, options.projectName, packageJson);
+    packageJson = await (0, import_build_tools.addWorkspacePackageJsonFields)(options.config, options.projectRoot, options.sourceRoot, options.projectName, false, packageJson);
+    packageJson = await (0, import_build_tools.addPackageJsonExports)(options.sourceRoot, packageJson);
+    await (0, import_devkit3.writeJsonFile)((0, import_correct_paths.joinPaths)(options.outDir, "package.json"), packageJson);
+    stopwatch();
+  }
+  return options;
+}
+__name(generatePackageJson, "generatePackageJson");
+async function executeUnbuild(options) {
+  (0, import_console3.writeDebug)(`  \u{1F680}  Running ${options.name} (${options.projectRoot}) build`, options.config);
+  const stopwatch = (0, import_console3.getStopwatch)(`${options.name} (${options.projectRoot}) build`);
+  try {
+    await (0, import_unbuild.build)(options.projectRoot, false, {
+      ...options,
+      rootDir: options.projectRoot
+    });
+  } finally {
+    stopwatch();
+  }
+  return options;
+}
+__name(executeUnbuild, "executeUnbuild");
+async function copyBuildAssets(options) {
+  (0, import_console3.writeDebug)(`  \u{1F4CB}  Copying asset files to output directory: ${options.outDir}`, options.config);
+  const stopwatch = (0, import_console3.getStopwatch)(`${options.name} asset copy`);
+  await (0, import_build_tools.copyAssets)(options.config, options.assets ?? [], options.outDir, options.projectRoot, options.projectName, options.sourceRoot, options.generatePackageJson, options.includeSrc);
+  stopwatch();
+  return options;
+}
+__name(copyBuildAssets, "copyBuildAssets");
+async function cleanOutputPath(options) {
+  if (options.clean !== false && options.outDir) {
+    await clean(options.name, options.outDir, options.config);
+  }
+  return options;
+}
+__name(cleanOutputPath, "cleanOutputPath");
+async function build(options) {
+  (0, import_console3.writeDebug)(` \u26A1  Executing Storm Unbuild pipeline`);
+  const stopwatch = (0, import_console3.getStopwatch)("Unbuild pipeline");
+  try {
+    const resolvedOptions = await resolveOptions(options);
+    await cleanOutputPath(resolvedOptions);
+    await generatePackageJson(resolvedOptions);
+    await executeUnbuild(resolvedOptions);
+    await copyBuildAssets(resolvedOptions);
+    (0, import_console3.writeSuccess)(`  \u{1F3C1}  The ${resolvedOptions.name} build completed successfully`, resolvedOptions.config);
+  } catch (error) {
+    (0, import_console3.writeFatal)("  \u274C  Fatal errors occurred during the build that could not be recovered from. The build process has been terminated.");
+    throw error;
+  } finally {
+    stopwatch();
+  }
+}
+__name(build, "build");
+
+// bin/unbuild.ts
+async function createProgram(config) {
+  try {
+    (0, import_console4.writeInfo)("\u26A1 Running Storm Unbuild pipeline", config);
+    const root = (0, import_find_workspace_root2.findWorkspaceRootSafe)();
+    process.env.STORM_WORKSPACE_ROOT ??= root;
+    process.env.NX_WORKSPACE_ROOT_PATH ??= root;
+    root && process.chdir(root);
+    const program = new import_commander.Command("storm-unbuild");
+    program.version("1.0.0", "-v --version", "display CLI version");
+    program.description("\u26A1 Run the Storm Unbuild pipeline").showHelpAfterError().showSuggestionAfterError();
+    const projectRootOption = new import_commander.Option("-p --project-root <path>", "The path to the root of the project to build. This path is defined relative to the workspace root.").makeOptionMandatory(true);
+    const sourceRootOption = new import_commander.Option("-s --source-root <path>", "The path of the project's source folder to build");
+    const nameOption = new import_commander.Option("-n --name <value>", "The name of the project to build");
+    const outputPathOption = new import_commander.Option("-o --output-path <path>", "The path of the project's source folder to build").default("dist/{projectRoot}");
+    const platformOption = new import_commander.Option("-p --platform <value>", "The platform to build the distribution for").choices([
+      "node",
+      "neutral",
+      "browser"
+    ]).default("node");
+    const formatOption = new import_commander.Option("-f, --format <value...>", "The format to build the distribution in").choices([
+      "esm",
+      "cjs",
+      "iife"
+    ]).argParser((value, previous) => {
+      if (previous === void 0) {
+        return [
+          value
+        ];
+      } else if (!previous.includes(value)) {
+        previous.push(value);
+      }
+      return previous;
+    }).default("esm");
+    const cleanOption = new import_commander.Option("-c --clean", "Should the output directory be cleaned before building").default(true);
+    const noCleanOption = new import_commander.Option("--no-clean", "Should the output directory be cleaned before building").default(false);
+    const bundleOption = new import_commander.Option("-b --bundle", "Should the output be bundled").default(true);
+    const noBundleOption = new import_commander.Option("--no-bundle", "Should the output be bundled").default(false);
+    const targetOption = new import_commander.Option("-t --target <value>", "The target to build the distribution for").choices([
+      "ESNext",
+      "ES2015",
+      "ES2016",
+      "ES2017",
+      "ES2018",
+      "ES2019",
+      "ES2020",
+      "ES2021",
+      "ES2022",
+      "ES2023"
+    ]).default("ESNext");
+    const watchOption = new import_commander.Option("-w --watch", "Should the build process watch for changes").default(false);
+    const debugOption = new import_commander.Option("-d --debug", "Should the build process run in debug mode").default(false);
+    const bannerOption = new import_commander.Option("--banner <value>", "The banner to prepend to the output");
+    const footerOption = new import_commander.Option("--footer <value>", "The footer to prepend to the output");
+    const splittingOption = new import_commander.Option("--splitting", "Should the output be split into multiple files").default(true);
+    const treeShakingOption = new import_commander.Option("--tree-shaking", "Should tree shaking be enabled").default(true);
+    const generatePackageJsonOption = new import_commander.Option("--generate-package-json", "Should a package.json be generated for the output").default(true);
+    const emitOnAllOption = new import_commander.Option("--emit-on-all", "Should the output be emitted on all platforms").default(false);
+    const metafileOption = new import_commander.Option("--metafile", "Should a metafile be generated for the output").default(true);
+    const minifyOption = new import_commander.Option("--minify", "Should the output be minified").default(true);
+    const includeSrcOption = new import_commander.Option("--include-src", "Should the source files be included in the output").default(false);
+    const verboseOption = new import_commander.Option("--verbose", "Should the build process be verbose").default(false);
+    const emitTypesOption = new import_commander.Option("--emit-types", "Should types be emitted for the output").default(true);
+    program.command("build", {
+      isDefault: true
+    }).alias("bundle").description("Run a TypeScript build using Unbuild.").addOption(nameOption).addOption(projectRootOption).addOption(sourceRootOption).addOption(outputPathOption).addOption(platformOption).addOption(formatOption).addOption(targetOption).addOption(bundleOption).addOption(noBundleOption).addOption(cleanOption).addOption(noCleanOption).addOption(watchOption).addOption(debugOption).addOption(bannerOption).addOption(footerOption).addOption(splittingOption).addOption(treeShakingOption).addOption(generatePackageJsonOption).addOption(emitOnAllOption).addOption(metafileOption).addOption(minifyOption).addOption(includeSrcOption).addOption(verboseOption).addOption(emitTypesOption).action(buildAction(config));
+    program.command("clean").alias("clear").description("Clean the output directory of the project. This command will remove the 'dist' folder.").addOption(nameOption).action(cleanAction(config));
+    return program;
+  } catch (e) {
+    (0, import_console4.writeFatal)(`A fatal error occurred while running the program: ${e.message}`, config);
+    process.exit(1);
+  }
+}
+__name(createProgram, "createProgram");
+var buildAction = /* @__PURE__ */ __name((config) => async (options) => {
+  try {
+    await build({
+      ...options,
+      sourcemap: !!options.debug,
+      replace: {},
+      alias: {},
+      stub: false,
+      watchOptions: {
+        buildDelay: 5e3,
+        chokidar: {},
+        clearScreen: true,
+        skipWrite: true
+      },
+      stubOptions: {
+        jiti: {}
+      },
+      dependencies: [],
+      peerDependencies: [],
+      devDependencies: [],
+      rollup: {
+        emitCJS: false,
+        watch: false,
+        cjsBridge: false,
+        dts: {
+          respectExternal: true
+        },
+        replace: {},
+        alias: {},
+        resolve: {},
+        json: {},
+        commonjs: {},
+        esbuild: {
+          target: options.target,
+          format: "esm",
+          platform: options.platform,
+          minify: options.minify,
+          treeShaking: options.treeShaking
+        }
+      }
+    });
+  } catch (e) {
+    (0, import_console4.writeFatal)(`A fatal error occurred while cleaning the Unbuild output directory: ${e.message}`, config);
+    (0, import_process_handler.exitWithError)(config);
+    process.exit(1);
+  }
+}, "buildAction");
+var cleanAction = /* @__PURE__ */ __name((config) => async (options) => {
+  try {
+    await clean(options.name, options.output, config);
+  } catch (e) {
+    (0, import_console4.writeFatal)(`A fatal error occurred while cleaning the ESBuild output directory: ${e.message}`, config);
+    (0, import_process_handler.exitWithError)(config);
+    process.exit(1);
+  }
+}, "cleanAction");
+void (async () => {
+  const config = await (0, import_create_storm_config2.loadStormConfig)();
+  const stopwatch = (0, import_console4.getStopwatch)("Storm ESBuild executable");
+  try {
+    (0, import_process_handler.handleProcess)(config);
+    const program = await createProgram(config);
+    await program.parseAsync(process.argv);
+    (0, import_console4.writeSuccess)(`\u{1F389}  Storm ESBuild executable has completed successfully!`, config);
+    (0, import_process_handler.exitWithSuccess)(config);
+  } catch (error) {
+    (0, import_console4.writeFatal)(`A fatal error occurred while running Storm ESBuild executable: 
+
+${error.message}`, config);
+    (0, import_process_handler.exitWithError)(config);
+    process.exit(1);
+  } finally {
+    stopwatch();
+  }
+})();

package/package.json

@@ -1 +1 @@
-{"name":"@storm-software/unbuild","version":"0.16.0","type":"module","description":"A package containing `unbuild` utilities for building Storm Software libraries and applications","repository":{"type":"github","url":"https://github.com/storm-software/storm-ops.git","directory":"packages/unbuild"},"homepage":"https://stormsoftware.com","bugs":"https://github.com/storm-software/storm-ops/issues","author":{"name":"Storm Software","email":"contact@stormsoftware.com","url":"https://stormsoftware.com"},"maintainers":[{"name":"Storm Software","email":"contact@stormsoftware.com","url":"https://stormsoftware.com"},{"name":"Pat Sullivan","email":"admin@stormsoftware.com","url":"https://patsullivan.org"}],"contributors":[{"name":"Storm Software","email":"contact@stormsoftware.com","url":"https://stormsoftware.com"}],"funding":{"type":"github","url":"https://github.com/sponsors/storm-software"},"license":"Apache-2.0","private":false,"packageManager":"pnpm@9.15.2","engines":{"node":">=22.4.0","pnpm":">=9.15.2"},"bin":{"storm-unbuild":"./bin/unbuild.js","storm-unbuild-cjs":"./bin/unbuild.cjs","storm-unbuild-esm":"./bin/unbuild.js"},"main":"./dist/index.cjs","module":"./dist/index.js","exports":{"./package.json":"./package.json","./types":{"import":{"types":"./dist/types.d.ts","default":"./dist/types.js"},"require":{"types":"./dist/types.d.cts","default":"./dist/types.cjs"},"default":{"types":"./dist/types.d.ts","default":"./dist/types.js"}},"./index":{"import":{"types":"./dist/index.d.ts","default":"./dist/index.js"},"require":{"types":"./dist/index.d.cts","default":"./dist/index.cjs"},"default":{"types":"./dist/index.d.ts","default":"./dist/index.js"}},".":{"import":{"types":"./dist/index.d.ts","default":"./dist/index.js"},"require":{"types":"./dist/index.d.cts","default":"./dist/index.cjs"},"default":{"types":"./dist/index.d.ts","default":"./dist/index.js"}},"./config":{"import":{"types":"./dist/config.d.ts","default":"./dist/config.js"},"require":{"types":"./dist/config.d.cts","default":"./dist/config.cjs"},"default":{"types":"./dist/config.d.ts","default":"./dist/config.js"}},"./clean":{"import":{"types":"./dist/clean.d.ts","default":"./dist/clean.js"},"require":{"types":"./dist/clean.d.cts","default":"./dist/clean.cjs"},"default":{"types":"./dist/clean.d.ts","default":"./dist/clean.js"}},"./build":{"import":{"types":"./dist/build/index.d.ts","default":"./dist/build/index.js"},"require":{"types":"./dist/build/index.d.cts","default":"./dist/build/index.cjs"},"default":{"types":"./dist/build/index.d.ts","default":"./dist/build/index.js"}},"./plugins/*":{"import":{"types":"./dist/plugins/*.d.ts","default":"./dist/plugins/*.js"},"require":{"types":"./dist/plugins/*.d.cts","default":"./dist/plugins/*.cjs"},"default":{"types":"./dist/plugins/*.d.ts","default":"./dist/plugins/*.js"}}},"types":"./dist/index.d.ts","files":["dist/**/*"],"keywords":["acidic","cyclone-ui","monorepo","storm","storm-ops","storm-stack","sullivanpj","unbuild"],"peerDependencies":{"@nx/devkit":"^20.3.1","@nx/js":"^20.3.1","@storm-software/build-tools":"workspace:*","@storm-software/config-tools":"workspace:*","@swc/core":"1.7.26","nx":"^20.3.1","rollup":"^4.29.1","typescript":"^5.7.2","unbuild":"^3.2.0"},"peerDependenciesMeta":{"@nx/devkit":{"optional":false},"@nx/js":{"optional":false},"@storm-software/build-tools":{"optional":false},"@storm-software/config-tools":{"optional":false},"@swc/core":{"optional":true},"nx":{"optional":false},"rollup":{"optional":false},"typescript":{"optional":false},"unbuild":{"optional":false}},"dependencies":{"@humanfs/node":"^0.16.6","commander":"^12.1.0","defu":"6.1.4","rollup":"^4.29.1","rollup-plugin-typescript2":"0.36.0"},"devDependencies":{"@nx/devkit":"^20.3.1","@nx/js":"^20.3.1","@storm-software/build-tools":"0.124.0","@storm-software/config":"1.93.0","@storm-software/config-tools":"1.132.0","@swc/core":"1.7.26","@types/node":"^22.10.2","nx":"^20.3.1","tsup":"8.3.5","typescript":"^5.7.2","unbuild":"^3.2.0"},"publishConfig":{"access":"public"},"sideEffects":false}
+{"name":"@storm-software/unbuild","version":"0.17.0","type":"module","description":"A package containing `unbuild` utilities for building Storm Software libraries and applications","repository":{"type":"github","url":"https://github.com/storm-software/storm-ops.git","directory":"packages/unbuild"},"homepage":"https://stormsoftware.com","bugs":"https://github.com/storm-software/storm-ops/issues","author":{"name":"Storm Software","email":"contact@stormsoftware.com","url":"https://stormsoftware.com"},"maintainers":[{"name":"Storm Software","email":"contact@stormsoftware.com","url":"https://stormsoftware.com"},{"name":"Pat Sullivan","email":"admin@stormsoftware.com","url":"https://patsullivan.org"}],"contributors":[{"name":"Storm Software","email":"contact@stormsoftware.com","url":"https://stormsoftware.com"}],"funding":{"type":"github","url":"https://github.com/sponsors/storm-software"},"license":"Apache-2.0","private":false,"packageManager":"pnpm@9.15.2","engines":{"node":">=22.4.0","pnpm":">=9.15.2"},"bin":{"storm-unbuild":"./bin/unbuild.js","storm-unbuild-cjs":"./bin/unbuild.cjs","storm-unbuild-esm":"./bin/unbuild.js"},"main":"./dist/index.cjs","module":"./dist/index.js","exports":{"./package.json":"./package.json","./types":{"import":{"types":"./dist/types.d.ts","default":"./dist/types.js"},"require":{"types":"./dist/types.d.cts","default":"./dist/types.cjs"},"default":{"types":"./dist/types.d.ts","default":"./dist/types.js"}},"./index":{"import":{"types":"./dist/index.d.ts","default":"./dist/index.js"},"require":{"types":"./dist/index.d.cts","default":"./dist/index.cjs"},"default":{"types":"./dist/index.d.ts","default":"./dist/index.js"}},".":{"import":{"types":"./dist/index.d.ts","default":"./dist/index.js"},"require":{"types":"./dist/index.d.cts","default":"./dist/index.cjs"},"default":{"types":"./dist/index.d.ts","default":"./dist/index.js"}},"./config":{"import":{"types":"./dist/config.d.ts","default":"./dist/config.js"},"require":{"types":"./dist/config.d.cts","default":"./dist/config.cjs"},"default":{"types":"./dist/config.d.ts","default":"./dist/config.js"}},"./clean":{"import":{"types":"./dist/clean.d.ts","default":"./dist/clean.js"},"require":{"types":"./dist/clean.d.cts","default":"./dist/clean.cjs"},"default":{"types":"./dist/clean.d.ts","default":"./dist/clean.js"}},"./build":{"import":{"types":"./dist/build/index.d.ts","default":"./dist/build/index.js"},"require":{"types":"./dist/build/index.d.cts","default":"./dist/build/index.cjs"},"default":{"types":"./dist/build/index.d.ts","default":"./dist/build/index.js"}},"./plugins/*":{"import":{"types":"./dist/plugins/*.d.ts","default":"./dist/plugins/*.js"},"require":{"types":"./dist/plugins/*.d.cts","default":"./dist/plugins/*.cjs"},"default":{"types":"./dist/plugins/*.d.ts","default":"./dist/plugins/*.js"}}},"types":"./dist/index.d.ts","files":["dist/**/*"],"keywords":["acidic","cyclone-ui","monorepo","storm","storm-ops","storm-stack","sullivanpj","unbuild"],"peerDependencies":{"@nx/devkit":"^20.3.1","@nx/js":"^20.3.1","@storm-software/build-tools":"workspace:*","@storm-software/config-tools":"workspace:*","@swc/core":"1.7.26","nx":"^20.3.1","rollup":"^4.29.1","typescript":"^5.7.2","unbuild":"^3.2.0"},"peerDependenciesMeta":{"@nx/devkit":{"optional":false},"@nx/js":{"optional":false},"@storm-software/build-tools":{"optional":false},"@storm-software/config-tools":{"optional":false},"@swc/core":{"optional":true},"nx":{"optional":false},"rollup":{"optional":false},"typescript":{"optional":false},"unbuild":{"optional":false}},"dependencies":{"@humanfs/node":"^0.16.6","commander":"^12.1.0","defu":"6.1.4","rollup":"^4.29.1","rollup-plugin-typescript2":"0.36.0"},"devDependencies":{"@nx/devkit":"^20.3.1","@nx/js":"^20.3.1","@storm-software/build-tools":"0.124.1","@storm-software/config":"1.93.1","@storm-software/config-tools":"1.132.1","@swc/core":"1.7.26","@types/node":"^22.10.2","nx":"^20.3.1","tsup":"8.3.5","typescript":"^5.7.2","unbuild":"^3.2.0"},"publishConfig":{"access":"public"},"sideEffects":false}