@powerlines/plugin-id 0.9.65 → 0.9.67

package/dist/_virtual/rolldown_runtime.cjs

@@ -0,0 +1 @@
+var e=Object.create,t=Object.defineProperty,n=Object.getOwnPropertyDescriptor,r=Object.getOwnPropertyNames,i=Object.getPrototypeOf,a=Object.prototype.hasOwnProperty,o=(e,i,o,s)=>{if(i&&typeof i==`object`||typeof i==`function`)for(var c=r(i),l=0,u=c.length,d;l<u;l++)d=c[l],!a.call(e,d)&&d!==o&&t(e,d,{get:(e=>i[e]).bind(null,d),enumerable:!(s=n(i,d))||s.enumerable});return e},s=(n,r,a)=>(a=n==null?{}:e(i(n)),o(r||!n||!n.__esModule?t(a,`default`,{value:n,enumerable:!0}):a,n));exports.__toESM=s;

package/dist/components/index.cjs

@@ -1 +1 @@
-const e=require(`../nanoid-BMwJGbL3.cjs`);require(`../components-BWLXb7a2.cjs`),exports.nanoidModule=e.t;
+const e=require(`./nanoid.cjs`);exports.nanoidModule=e.nanoidModule;

package/dist/components/index.d.cts

@@ -1,4 +1,2 @@
-import "../plugin-DAFqTL_r.cjs";
-import { t as nanoidModule } from "../nanoid-BEJDhi9o.cjs";
-import "../index-D6CnpA_r.cjs";
+import { nanoidModule } from "./nanoid.cjs";
 export { nanoidModule };

package/dist/components/index.d.mts

@@ -1,4 +1,2 @@
-import "../plugin-9oupXQGY.mjs";
-import { t as nanoidModule } from "../nanoid-BG_lCiEX.mjs";
-import "../index-DL0uimUT.mjs";
+import { nanoidModule } from "./nanoid.mjs";
 export { nanoidModule };

package/dist/components/index.mjs

@@ -1 +1 @@
-import{t as e}from"../nanoid-Clx2gSOJ.mjs";import"../components-CeJvJXAB.mjs";export{e as nanoidModule};
+import{nanoidModule as e}from"./nanoid.mjs";export{e as nanoidModule};

package/dist/components/nanoid.cjs

@@ -1 +1,90 @@
-const e=require(`../nanoid-BMwJGbL3.cjs`);exports.nanoidModule=e.t;
+const e=require(`../powerlines/src/lib/utilities/file-header.cjs`);function t(t){return`
+/**
+ * The ID module provides a set of utilities for generating unique identifiers.
+ *
+ * @module ${t.config.output.builtinPrefix}:id
+ */
+
+${e.getFileHeader(t)}
+
+/**
+ * Generate a random string
+ *
+ * @param array - The array to fill with random values
+ * @returns The array filled with random values
+ */
+export function getRandom(array: Uint8Array) {
+  if (array === null) {
+    throw new StormError({ type: "general", code: 9 });
+  }
+
+  // Fill the array with random values
+  for (let i = 0; i < array.length; i++) {
+    array[i] = Math.floor(Math.random() * 256); // Random byte (0-255)
+  }
+
+  return array;
+}
+
+/**
+ * A platform agnostic version of the [nanoid](https://github.com/ai/nanoid) package with some modifications.
+ *
+ * @param size - The size of the string to generate. Defaults to 21 if not provided.
+ * @returns A unique identifier following the nanoid format
+ */
+export function uniqueId(size?: number | undefined): string;
+
+/**
+ * A platform agnostic version of the [nanoid](https://github.com/ai/nanoid) package with some modifications.
+ *
+ * @param prefix - The prefix to use for the unique identifier
+ * @param size - The size of the string to generate. Defaults to 21 if not provided.
+ * @returns A unique identifier following the nanoid format
+ */
+export function uniqueId(prefix?: string, size?: number | undefined): string;
+
+/**
+ * A platform agnostic version of the [nanoid](https://github.com/ai/nanoid) package with some modifications.
+ *
+ * @param param - The parameter to use for the unique identifier, can be a string or number
+ * @param size - The size of the string to generate. Defaults to 21 if not provided.
+ * @returns A unique identifier following the nanoid format
+ */
+export function uniqueId(param?: string | number | undefined, size?: number | undefined): string {
+  if (typeof param === "number") {
+    size = param;
+  } else if (!param || !size) {
+    size = 21; // Default size if not provided
+  }
+
+  // Use our custom getRandom function to fill a Uint8Array with random values.
+  const randomBytes = getRandom(new Uint8Array(typeof param === "string" ? size - (param.length + 1) : size));
+
+  let result = "";
+  if (typeof param === "string") {
+    // If the parameter is a string, use it as a prefix.
+    result = param + "_";
+  }
+
+  return result + randomBytes.reduce((id, byte) => {
+    // It is incorrect to use bytes exceeding the alphabet size.
+    // The following mask reduces the random byte in the 0-255 value
+    // range to the 0-63 value range. Therefore, adding hacks, such
+    // as empty string fallback or magic numbers, is unnecessary because
+    // the bitmask trims bytes down to the alphabet size.
+    byte &= 63;
+    if (byte < 36) {
+      // \`0-9a-z\`
+      id += byte.toString(36);
+    } else if (byte < 62) {
+      // \`A-Z\`
+      id += (byte - 26).toString(36).toUpperCase();
+    } else if (byte > 62) {
+      id += "-";
+    } else {
+      id += "_";
+    }
+    return id;
+  }, "");
+}
+`}exports.nanoidModule=t;

package/dist/components/nanoid.d.cts

@@ -1,3 +1,13 @@
-import "../plugin-DAFqTL_r.cjs";
-import { t as nanoidModule } from "../nanoid-BEJDhi9o.cjs";
+import { IdPluginContext } from "../types/plugin.cjs";
+
+//#region src/components/nanoid.d.ts
+
+/**
+ * Generates the nanoid module content.
+ *
+ * @param context - The build context containing runtime information.
+ * @returns A string representing the nanoid module code.
+ */
+declare function nanoidModule(context: IdPluginContext): string;
+//#endregion
 export { nanoidModule };

package/dist/components/nanoid.d.mts

@@ -1,3 +1,13 @@
-import "../plugin-9oupXQGY.mjs";
-import { t as nanoidModule } from "../nanoid-BG_lCiEX.mjs";
+import { IdPluginContext } from "../types/plugin.mjs";
+
+//#region src/components/nanoid.d.ts
+
+/**
+ * Generates the nanoid module content.
+ *
+ * @param context - The build context containing runtime information.
+ * @returns A string representing the nanoid module code.
+ */
+declare function nanoidModule(context: IdPluginContext): string;
+//#endregion
 export { nanoidModule };

package/dist/components/nanoid.mjs

@@ -1 +1,90 @@
-import{t as e}from"../nanoid-Clx2gSOJ.mjs";export{e as nanoidModule};
+import{getFileHeader as e}from"../powerlines/src/lib/utilities/file-header.mjs";function t(t){return`
+/**
+ * The ID module provides a set of utilities for generating unique identifiers.
+ *
+ * @module ${t.config.output.builtinPrefix}:id
+ */
+
+${e(t)}
+
+/**
+ * Generate a random string
+ *
+ * @param array - The array to fill with random values
+ * @returns The array filled with random values
+ */
+export function getRandom(array: Uint8Array) {
+  if (array === null) {
+    throw new StormError({ type: "general", code: 9 });
+  }
+
+  // Fill the array with random values
+  for (let i = 0; i < array.length; i++) {
+    array[i] = Math.floor(Math.random() * 256); // Random byte (0-255)
+  }
+
+  return array;
+}
+
+/**
+ * A platform agnostic version of the [nanoid](https://github.com/ai/nanoid) package with some modifications.
+ *
+ * @param size - The size of the string to generate. Defaults to 21 if not provided.
+ * @returns A unique identifier following the nanoid format
+ */
+export function uniqueId(size?: number | undefined): string;
+
+/**
+ * A platform agnostic version of the [nanoid](https://github.com/ai/nanoid) package with some modifications.
+ *
+ * @param prefix - The prefix to use for the unique identifier
+ * @param size - The size of the string to generate. Defaults to 21 if not provided.
+ * @returns A unique identifier following the nanoid format
+ */
+export function uniqueId(prefix?: string, size?: number | undefined): string;
+
+/**
+ * A platform agnostic version of the [nanoid](https://github.com/ai/nanoid) package with some modifications.
+ *
+ * @param param - The parameter to use for the unique identifier, can be a string or number
+ * @param size - The size of the string to generate. Defaults to 21 if not provided.
+ * @returns A unique identifier following the nanoid format
+ */
+export function uniqueId(param?: string | number | undefined, size?: number | undefined): string {
+  if (typeof param === "number") {
+    size = param;
+  } else if (!param || !size) {
+    size = 21; // Default size if not provided
+  }
+
+  // Use our custom getRandom function to fill a Uint8Array with random values.
+  const randomBytes = getRandom(new Uint8Array(typeof param === "string" ? size - (param.length + 1) : size));
+
+  let result = "";
+  if (typeof param === "string") {
+    // If the parameter is a string, use it as a prefix.
+    result = param + "_";
+  }
+
+  return result + randomBytes.reduce((id, byte) => {
+    // It is incorrect to use bytes exceeding the alphabet size.
+    // The following mask reduces the random byte in the 0-255 value
+    // range to the 0-63 value range. Therefore, adding hacks, such
+    // as empty string fallback or magic numbers, is unnecessary because
+    // the bitmask trims bytes down to the alphabet size.
+    byte &= 63;
+    if (byte < 36) {
+      // \`0-9a-z\`
+      id += byte.toString(36);
+    } else if (byte < 62) {
+      // \`A-Z\`
+      id += (byte - 26).toString(36).toUpperCase();
+    } else if (byte > 62) {
+      id += "-";
+    } else {
+      id += "_";
+    }
+    return id;
+  }, "");
+}
+`}export{t as nanoidModule};

package/dist/index.cjs

@@ -1 +1 @@
-Object.defineProperty(exports,`__esModule`,{value:!0});var e=Object.create,t=Object.defineProperty,n=Object.getOwnPropertyDescriptor,r=Object.getOwnPropertyNames,i=Object.getPrototypeOf,a=Object.prototype.hasOwnProperty,o=(e,i,o,s)=>{if(i&&typeof i==`object`||typeof i==`function`)for(var c=r(i),l=0,u=c.length,d;l<u;l++)d=c[l],!a.call(e,d)&&d!==o&&t(e,d,{get:(e=>i[e]).bind(null,d),enumerable:!(s=n(i,d))||s.enumerable});return e},s=(n,r,a)=>(a=n==null?{}:e(i(n)),o(r||!n||!n.__esModule?t(a,`default`,{value:n,enumerable:!0}):a,n));const c=require(`./nanoid-BMwJGbL3.cjs`);require(`./components-BWLXb7a2.cjs`),require(`./plugin-pBKbb5K9.cjs`),require(`./types-o3zWarRp.cjs`);let l=require(`@storm-software/config-tools/types`),u=require(`defu`);u=s(u);function d(e={}){return{name:`id`,async config(){this.log(l.LogLevelLabel.TRACE,"Providing default configuration for the Powerlines `id` build plugin.");let t={id:(0,u.default)(e,{type:`nanoid`})};return(!t.id.type||![`nanoid`].includes(t.id.type))&&(t.id.type&&this.log(l.LogLevelLabel.WARN,`Invalid ID generation type "${t.id.type}" specified. Defaulting to "nanoid".`),t.id.type=`nanoid`),this.log(l.LogLevelLabel.DEBUG,`Using ID generation library: ${t.id.type}`),t},async prepare(){this.log(l.LogLevelLabel.TRACE,`Preparing the ID runtime artifacts for the Powerlines project.`);let e;switch(this.config.id.type){case`nanoid`:default:e=c.t;break}await this.emitBuiltin(await Promise.resolve(e(this)),`id`,`id.ts`)}}}var f=d;exports.default=f,exports.nanoidModule=c.t,exports.plugin=d,exports.t=s;
+Object.defineProperty(exports,`__esModule`,{value:!0});const e=require(`./_virtual/rolldown_runtime.cjs`),t=require(`./components/nanoid.cjs`);require(`./components/index.cjs`);let n=require(`@storm-software/config-tools/types`),r=require(`defu`);r=e.__toESM(r);function i(e={}){return{name:`id`,async config(){this.log(n.LogLevelLabel.TRACE,"Providing default configuration for the Powerlines `id` build plugin.");let t={id:(0,r.default)(e,{type:`nanoid`})};return(!t.id.type||![`nanoid`].includes(t.id.type))&&(t.id.type&&this.log(n.LogLevelLabel.WARN,`Invalid ID generation type "${t.id.type}" specified. Defaulting to "nanoid".`),t.id.type=`nanoid`),this.log(n.LogLevelLabel.DEBUG,`Using ID generation library: ${t.id.type}`),t},async prepare(){this.log(n.LogLevelLabel.TRACE,`Preparing the ID runtime artifacts for the Powerlines project.`);let e;switch(this.config.id.type){case`nanoid`:default:e=t.nanoidModule;break}await this.emitBuiltin(await Promise.resolve(e(this)),`id`,`id.ts`)}}}var a=i;exports.default=a,exports.nanoidModule=t.nanoidModule,exports.plugin=i;

package/dist/index.d.cts

@@ -1,7 +1,6 @@
-import { a as UniqueIdFormatType, c as __ΩIdPluginResolvedConfig, d as Plugin, i as IdPluginUserConfig, l as __ΩIdPluginUserConfig, n as IdPluginOptions, o as __ΩIdPluginContext, r as IdPluginResolvedConfig, s as __ΩIdPluginOptions, t as IdPluginContext, u as __ΩUniqueIdFormatType } from "./plugin-DAFqTL_r.cjs";
-import { t as nanoidModule } from "./nanoid-BEJDhi9o.cjs";
-import "./index-D6CnpA_r.cjs";
-import "./index-D4ELpJXS.cjs";
+import { Plugin } from "./powerlines/src/types/plugin.cjs";
+import { IdPluginContext, IdPluginOptions, IdPluginResolvedConfig, IdPluginUserConfig, UniqueIdFormatType, __ΩIdPluginContext, __ΩIdPluginOptions, __ΩIdPluginResolvedConfig, __ΩIdPluginUserConfig, __ΩUniqueIdFormatType } from "./types/plugin.cjs";
+import { nanoidModule } from "./components/nanoid.cjs";
 
 //#region src/index.d.ts
 

package/dist/index.d.mts

@@ -1,10 +1,10 @@
-import { a as UniqueIdFormatType, c as __ΩIdPluginResolvedConfig, d as Plugin, i as IdPluginUserConfig, l as __ΩIdPluginUserConfig, n as IdPluginOptions, o as __ΩIdPluginContext, r as IdPluginResolvedConfig, s as __ΩIdPluginOptions, t as IdPluginContext, u as __ΩUniqueIdFormatType } from "./plugin-9oupXQGY.mjs";
-import { t as nanoidModule } from "./nanoid-BG_lCiEX.mjs";
-import "./index-DL0uimUT.mjs";
-import "./index-9iG2qHLe.mjs";
+import { Plugin } from "./powerlines/src/types/plugin.mjs";
+import { IdPluginContext, IdPluginOptions, IdPluginResolvedConfig, IdPluginUserConfig, UniqueIdFormatType, __ΩIdPluginContext, __ΩIdPluginOptions, __ΩIdPluginResolvedConfig, __ΩIdPluginUserConfig, __ΩUniqueIdFormatType } from "./types/plugin.mjs";
+import { nanoidModule } from "./components/nanoid.mjs";
+import "./components/index.mjs";
+import "./types/index.mjs";
 
 //#region src/index.d.ts
-
 /**
  * A Powerlines plugin to assist in developing other Powerlines plugins.
  */

package/dist/index.mjs

@@ -1 +1 @@
-import{t as e}from"./nanoid-Clx2gSOJ.mjs";import"./components-CeJvJXAB.mjs";import"./plugin-BjiGfRHE.mjs";import"./types-n6NgD0QK.mjs";import{LogLevelLabel as t}from"@storm-software/config-tools/types";import n from"defu";function r(r={}){return{name:`id`,async config(){this.log(t.TRACE,"Providing default configuration for the Powerlines `id` build plugin.");let e={id:n(r,{type:`nanoid`})};return(!e.id.type||![`nanoid`].includes(e.id.type))&&(e.id.type&&this.log(t.WARN,`Invalid ID generation type "${e.id.type}" specified. Defaulting to "nanoid".`),e.id.type=`nanoid`),this.log(t.DEBUG,`Using ID generation library: ${e.id.type}`),e},async prepare(){this.log(t.TRACE,`Preparing the ID runtime artifacts for the Powerlines project.`);let n;switch(this.config.id.type){case`nanoid`:default:n=e;break}await this.emitBuiltin(await Promise.resolve(n(this)),`id`,`id.ts`)}}}var i=r;export{i as default,e as nanoidModule,r as plugin};
+import{nanoidModule as e}from"./components/nanoid.mjs";import"./components/index.mjs";import{LogLevelLabel as t}from"@storm-software/config-tools/types";import n from"defu";function r(r={}){return{name:`id`,async config(){this.log(t.TRACE,"Providing default configuration for the Powerlines `id` build plugin.");let e={id:n(r,{type:`nanoid`})};return(!e.id.type||![`nanoid`].includes(e.id.type))&&(e.id.type&&this.log(t.WARN,`Invalid ID generation type "${e.id.type}" specified. Defaulting to "nanoid".`),e.id.type=`nanoid`),this.log(t.DEBUG,`Using ID generation library: ${e.id.type}`),e},async prepare(){this.log(t.TRACE,`Preparing the ID runtime artifacts for the Powerlines project.`);let n;switch(this.config.id.type){case`nanoid`:default:n=e;break}await this.emitBuiltin(await Promise.resolve(n(this)),`id`,`id.ts`)}}}var i=r;export{i as default,e as nanoidModule,r as plugin};

package/dist/powerlines/src/lib/utilities/file-header.cjs

@@ -0,0 +1,10 @@
+const e=require(`../../../../_virtual/rolldown_runtime.cjs`);let t=require(`@stryke/string-format/title-case`);function n(e){return`
+// Generated with ${(0,t.titleCase)(e.config.framework)}
+// Note: Do not edit this file manually - it will be overwritten automatically
+`}function r(e,t={}){let{directive:r=null,prettierIgnore:i=!1}=t;return`/* eslint-disable */
+// biome-ignore lint: disable
+${i?`// prettier-ignore`:``}${r?`\n\n${r}\n`:`
+`}
+${n(e)}
+
+`}exports.getFileHeader=r;

package/dist/powerlines/src/lib/utilities/file-header.mjs

@@ -0,0 +1,10 @@
+import{titleCase as e}from"@stryke/string-format/title-case";function t(t){return`
+// Generated with ${e(t.config.framework)}
+// Note: Do not edit this file manually - it will be overwritten automatically
+`}function n(e,n={}){let{directive:r=null,prettierIgnore:i=!1}=n;return`/* eslint-disable */
+// biome-ignore lint: disable
+${i?`// prettier-ignore`:``}${r?`\n\n${r}\n`:`
+`}
+${t(e)}
+
+`}export{n as getFileHeader};

package/dist/powerlines/src/types/babel.d.mts

@@ -0,0 +1,2 @@
+import "./context.mjs";
+import "./config.mjs";

package/dist/powerlines/src/types/build.d.cts

@@ -0,0 +1,139 @@
+//#region ../powerlines/src/types/build.d.ts
+
+type UnpluginBuildVariant = "rollup" | "webpack" | "rspack" | "vite" | "esbuild" | "farm" | "unloader" | "rolldown";
+interface BuildConfig {
+  /**
+   * The platform to build the project for
+   *
+   * @defaultValue "neutral"
+   */
+  platform?: "node" | "browser" | "neutral";
+  /**
+   * Array of strings indicating the polyfills to include for the build.
+   *
+   * @remarks
+   * This option allows you to specify which polyfills should be included in the build process to ensure compatibility with the target environment. The paths for the polyfills can use placeholder tokens (the `replacePathTokens` helper function will be used to resolve the actual values).
+   *
+   * @example
+   * ```ts
+   * {
+   *   polyfill: ['{projectRoot}/custom-polyfill.ts']
+   * }
+   * ```
+   */
+  polyfill?: string[];
+  /**
+   * Array of strings indicating the order in which fields in a package.json file should be resolved to determine the entry point for a module.
+   *
+   * @defaultValue `['browser', 'module', 'jsnext:main', 'jsnext']`
+   */
+  mainFields?: string[];
+  /**
+   * Array of strings indicating what conditions should be used for module resolution.
+   */
+  conditions?: string[];
+  /**
+   * Array of strings indicating what file extensions should be used for module resolution.
+   *
+   * @defaultValue `['.mjs', '.js', '.mts', '.ts', '.jsx', '.tsx', '.json']`
+   */
+  extensions?: string[];
+  /**
+   * Array of strings indicating what modules should be deduplicated to a single version in the build.
+   *
+   * @remarks
+   * This option is useful for ensuring that only one version of a module is included in the bundle, which can help reduce bundle size and avoid conflicts.
+   */
+  dedupe?: string[];
+  /**
+   * Array of strings or regular expressions that indicate what modules are builtin for the environment.
+   */
+  builtins?: (string | RegExp)[];
+  /**
+   * Define global variable replacements.
+   *
+   * @remarks
+   * This option allows you to specify global constants that will be replaced in the code during the build process. It is similar to the `define` option in esbuild and Vite, enabling you to replace specific identifiers with constant expressions at build time.
+   *
+   * @example
+   * ```ts
+   * {
+   *   define: {
+   *     __VERSION__: '"1.0.0"',
+   *     __DEV__: 'process.env.NODE_ENV !== "production"'
+   *   }
+   * }
+   * ```
+   *
+   * @see https://esbuild.github.io/api/#define
+   * @see https://vitejs.dev/config/build-options.html#define
+   * @see https://github.com/rollup/plugins/tree/master/packages/replace
+   */
+  define?: Record<string, any>;
+  /**
+   * Global variables that will have import statements injected where necessary
+   *
+   * @remarks
+   * This option allows you to specify global variables that should be automatically imported from specified modules whenever they are used in the code. This is particularly useful for polyfilling Node.js globals in a browser environment.
+   *
+   * @example
+   * ```ts
+   * {
+   *   inject: {
+   *     process: 'process/browser',
+   *     Buffer: ['buffer', 'Buffer'],
+   *   }
+   * }
+   * ```
+   *
+   * @see https://github.com/rollup/plugins/tree/master/packages/inject
+   */
+  inject?: Record<string, string | string[]>;
+  /**
+   * The alias mappings to use for module resolution during the build process.
+   *
+   * @remarks
+   * This option allows you to define custom path aliases for modules, which can be useful for simplifying imports and managing dependencies.
+   *
+   * @example
+   * ```ts
+   * {
+   *   alias: {
+   *     "@utils": "./src/utils",
+   *     "@components": "./src/components"
+   *   }
+   * }
+   * ```
+   *
+   * @see https://github.com/rollup/plugins/tree/master/packages/alias
+   */
+  alias?: Record<string, string> | Array<{
+    find: string | RegExp;
+    replacement: string;
+  }>;
+  /**
+   * A list of modules that should not be bundled, even if they are external dependencies.
+   *
+   * @remarks
+   * This option is useful for excluding specific modules from the bundle, such as Node.js built-in modules or other libraries that should not be bundled.
+   */
+  external?: (string | RegExp)[];
+  /**
+   * A list of modules that should always be bundled, even if they are external dependencies.
+   */
+  noExternal?: (string | RegExp)[];
+  /**
+   * Should the Powerlines CLI processes skip bundling the `node_modules` directory?
+   */
+  skipNodeModulesBundle?: boolean;
+  /**
+   * An optional set of override options to apply to the selected build variant.
+   *
+   * @remarks
+   * This option allows you to provide configuration options with the guarantee that they will **not** be overridden and will take precedence over other build configurations.
+   */
+  override?: Record<string, any>;
+}
+type BuildResolvedConfig = Omit<BuildConfig, "override">;
+//#endregion
+export { BuildConfig, BuildResolvedConfig, UnpluginBuildVariant };

package/dist/powerlines/src/types/build.d.mts

@@ -0,0 +1,139 @@
+//#region ../powerlines/src/types/build.d.ts
+
+type UnpluginBuildVariant = "rollup" | "webpack" | "rspack" | "vite" | "esbuild" | "farm" | "unloader" | "rolldown";
+interface BuildConfig {
+  /**
+   * The platform to build the project for
+   *
+   * @defaultValue "neutral"
+   */
+  platform?: "node" | "browser" | "neutral";
+  /**
+   * Array of strings indicating the polyfills to include for the build.
+   *
+   * @remarks
+   * This option allows you to specify which polyfills should be included in the build process to ensure compatibility with the target environment. The paths for the polyfills can use placeholder tokens (the `replacePathTokens` helper function will be used to resolve the actual values).
+   *
+   * @example
+   * ```ts
+   * {
+   *   polyfill: ['{projectRoot}/custom-polyfill.ts']
+   * }
+   * ```
+   */
+  polyfill?: string[];
+  /**
+   * Array of strings indicating the order in which fields in a package.json file should be resolved to determine the entry point for a module.
+   *
+   * @defaultValue `['browser', 'module', 'jsnext:main', 'jsnext']`
+   */
+  mainFields?: string[];
+  /**
+   * Array of strings indicating what conditions should be used for module resolution.
+   */
+  conditions?: string[];
+  /**
+   * Array of strings indicating what file extensions should be used for module resolution.
+   *
+   * @defaultValue `['.mjs', '.js', '.mts', '.ts', '.jsx', '.tsx', '.json']`
+   */
+  extensions?: string[];
+  /**
+   * Array of strings indicating what modules should be deduplicated to a single version in the build.
+   *
+   * @remarks
+   * This option is useful for ensuring that only one version of a module is included in the bundle, which can help reduce bundle size and avoid conflicts.
+   */
+  dedupe?: string[];
+  /**
+   * Array of strings or regular expressions that indicate what modules are builtin for the environment.
+   */
+  builtins?: (string | RegExp)[];
+  /**
+   * Define global variable replacements.
+   *
+   * @remarks
+   * This option allows you to specify global constants that will be replaced in the code during the build process. It is similar to the `define` option in esbuild and Vite, enabling you to replace specific identifiers with constant expressions at build time.
+   *
+   * @example
+   * ```ts
+   * {
+   *   define: {
+   *     __VERSION__: '"1.0.0"',
+   *     __DEV__: 'process.env.NODE_ENV !== "production"'
+   *   }
+   * }
+   * ```
+   *
+   * @see https://esbuild.github.io/api/#define
+   * @see https://vitejs.dev/config/build-options.html#define
+   * @see https://github.com/rollup/plugins/tree/master/packages/replace
+   */
+  define?: Record<string, any>;
+  /**
+   * Global variables that will have import statements injected where necessary
+   *
+   * @remarks
+   * This option allows you to specify global variables that should be automatically imported from specified modules whenever they are used in the code. This is particularly useful for polyfilling Node.js globals in a browser environment.
+   *
+   * @example
+   * ```ts
+   * {
+   *   inject: {
+   *     process: 'process/browser',
+   *     Buffer: ['buffer', 'Buffer'],
+   *   }
+   * }
+   * ```
+   *
+   * @see https://github.com/rollup/plugins/tree/master/packages/inject
+   */
+  inject?: Record<string, string | string[]>;
+  /**
+   * The alias mappings to use for module resolution during the build process.
+   *
+   * @remarks
+   * This option allows you to define custom path aliases for modules, which can be useful for simplifying imports and managing dependencies.
+   *
+   * @example
+   * ```ts
+   * {
+   *   alias: {
+   *     "@utils": "./src/utils",
+   *     "@components": "./src/components"
+   *   }
+   * }
+   * ```
+   *
+   * @see https://github.com/rollup/plugins/tree/master/packages/alias
+   */
+  alias?: Record<string, string> | Array<{
+    find: string | RegExp;
+    replacement: string;
+  }>;
+  /**
+   * A list of modules that should not be bundled, even if they are external dependencies.
+   *
+   * @remarks
+   * This option is useful for excluding specific modules from the bundle, such as Node.js built-in modules or other libraries that should not be bundled.
+   */
+  external?: (string | RegExp)[];
+  /**
+   * A list of modules that should always be bundled, even if they are external dependencies.
+   */
+  noExternal?: (string | RegExp)[];
+  /**
+   * Should the Powerlines CLI processes skip bundling the `node_modules` directory?
+   */
+  skipNodeModulesBundle?: boolean;
+  /**
+   * An optional set of override options to apply to the selected build variant.
+   *
+   * @remarks
+   * This option allows you to provide configuration options with the guarantee that they will **not** be overridden and will take precedence over other build configurations.
+   */
+  override?: Record<string, any>;
+}
+type BuildResolvedConfig = Omit<BuildConfig, "override">;
+//#endregion
+export { BuildConfig, BuildResolvedConfig, UnpluginBuildVariant };

package/dist/powerlines/src/types/commands.d.cts

@@ -0,0 +1,8 @@
+import { MaybePromise } from "@stryke/types/base";
+import { ArrayValues } from "@stryke/types/array";
+
+//#region ../powerlines/src/types/commands.d.ts
+declare const SUPPORTED_COMMANDS: readonly ["new", "clean", "prepare", "lint", "test", "build", "docs", "deploy", "finalize"];
+type CommandType = ArrayValues<typeof SUPPORTED_COMMANDS>;
+//#endregion
+export { CommandType };

package/dist/powerlines/src/types/commands.d.mts

@@ -0,0 +1,9 @@
+import "./context.mjs";
+import { MaybePromise } from "@stryke/types/base";
+import { ArrayValues } from "@stryke/types/array";
+
+//#region ../powerlines/src/types/commands.d.ts
+declare const SUPPORTED_COMMANDS: readonly ["new", "clean", "prepare", "lint", "test", "build", "docs", "deploy", "finalize"];
+type CommandType = ArrayValues<typeof SUPPORTED_COMMANDS>;
+//#endregion
+export { CommandType };