@powerlines/plugin-id 0.9.125 → 0.9.127

package/dist/_virtual/rolldown_runtime.cjs

@@ -1 +1,29 @@
-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;
+//#region rolldown:runtime
+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 __copyProps = (to, from, except, desc) => {
+	if (from && typeof from === "object" || typeof from === "function") {
+		for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+			key = keys[i];
+			if (!__hasOwnProp.call(to, key) && key !== except) {
+				__defProp(to, key, {
+					get: ((k) => from[k]).bind(null, key),
+					enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+				});
+			}
+		}
+	}
+	return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
+	value: mod,
+	enumerable: true
+}) : target, mod));
+
+//#endregion
+
+exports.__toESM = __toESM;

package/dist/components/index.cjs

@@ -1 +1,3 @@
-const e=require(`./nanoid.cjs`);exports.nanoidModule=e.nanoidModule;
+const require_components_nanoid = require('./nanoid.cjs');
+
+exports.nanoidModule = require_components_nanoid.nanoidModule;

package/dist/components/index.mjs

@@ -1 +1,3 @@
-import{nanoidModule as e}from"./nanoid.mjs";export{e as nanoidModule};
+import { nanoidModule } from "./nanoid.mjs";
+
+export { nanoidModule };

package/dist/components/nanoid.cjs

@@ -1,11 +1,21 @@
-const e=require(`../powerlines/src/lib/utilities/file-header.cjs`);function t(t){return`
+const require_file_header = require('../powerlines/src/lib/utilities/file-header.cjs');
+
+//#region src/components/nanoid.ts
+/**
+* Generates the nanoid module content.
+*
+* @param context - The build context containing runtime information.
+* @returns A string representing the nanoid module code.
+*/
+function nanoidModule(context) {
+	return `
 /**
  * The ID module provides a set of utilities for generating unique identifiers.
  *
- * @module ${t.config.output.builtinPrefix}:id
+ * @module ${context.config.output.builtinPrefix}:id
  */
 
-${e.getFileHeader(t)}
+${require_file_header.getFileHeader(context)}
 
 /**
  * Generate a random string
@@ -87,4 +97,8 @@ export function uniqueId(param?: string | number | undefined, size?: number | un
     return id;
   }, "");
 }
-`}exports.nanoidModule=t;
+`;
+}
+
+//#endregion
+exports.nanoidModule = nanoidModule;

package/dist/components/nanoid.mjs

@@ -1,11 +1,21 @@
-import{getFileHeader as e}from"../powerlines/src/lib/utilities/file-header.mjs";function t(t){return`
+import { getFileHeader } from "../powerlines/src/lib/utilities/file-header.mjs";
+
+//#region src/components/nanoid.ts
+/**
+* Generates the nanoid module content.
+*
+* @param context - The build context containing runtime information.
+* @returns A string representing the nanoid module code.
+*/
+function nanoidModule(context) {
+	return `
 /**
  * The ID module provides a set of utilities for generating unique identifiers.
  *
- * @module ${t.config.output.builtinPrefix}:id
+ * @module ${context.config.output.builtinPrefix}:id
  */
 
-${e(t)}
+${getFileHeader(context)}
 
 /**
  * Generate a random string
@@ -87,4 +97,8 @@ export function uniqueId(param?: string | number | undefined, size?: number | un
     return id;
   }, "");
 }
-`}export{t as nanoidModule};
+`;
+}
+
+//#endregion
+export { nanoidModule };

package/dist/index.cjs

@@ -1 +1,44 @@
-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;
+Object.defineProperty(exports, '__esModule', { value: true });
+const require_rolldown_runtime = require('./_virtual/rolldown_runtime.cjs');
+const require_components_nanoid = require('./components/nanoid.cjs');
+require('./components/index.cjs');
+let __storm_software_config_tools_types = require("@storm-software/config-tools/types");
+let defu = require("defu");
+defu = require_rolldown_runtime.__toESM(defu);
+
+//#region src/index.ts
+/**
+* A Powerlines plugin to assist in developing other Powerlines plugins.
+*/
+function plugin(options = {}) {
+	return {
+		name: "id",
+		async config() {
+			this.log(__storm_software_config_tools_types.LogLevelLabel.TRACE, "Providing default configuration for the Powerlines `id` build plugin.");
+			const config = { id: (0, defu.default)(options, { type: "nanoid" }) };
+			if (!config.id.type || !["nanoid"].includes(config.id.type)) {
+				if (config.id.type) this.log(__storm_software_config_tools_types.LogLevelLabel.WARN, `Invalid ID generation type "${config.id.type}" specified. Defaulting to "nanoid".`);
+				config.id.type = "nanoid";
+			}
+			this.log(__storm_software_config_tools_types.LogLevelLabel.DEBUG, `Using ID generation library: ${config.id.type}`);
+			return config;
+		},
+		async prepare() {
+			this.log(__storm_software_config_tools_types.LogLevelLabel.TRACE, `Preparing the ID runtime artifacts for the Powerlines project.`);
+			let idModule;
+			switch (this.config.id.type) {
+				case "nanoid":
+				default:
+					idModule = require_components_nanoid.nanoidModule;
+					break;
+			}
+			await this.emitBuiltin(await Promise.resolve(idModule(this)), "id", "id.ts");
+		}
+	};
+}
+var src_default = plugin;
+
+//#endregion
+exports.default = src_default;
+exports.nanoidModule = require_components_nanoid.nanoidModule;
+exports.plugin = plugin;

package/dist/index.mjs

@@ -1 +1,39 @@
-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};
+import { nanoidModule } from "./components/nanoid.mjs";
+import "./components/index.mjs";
+import { LogLevelLabel } from "@storm-software/config-tools/types";
+import defu from "defu";
+
+//#region src/index.ts
+/**
+* A Powerlines plugin to assist in developing other Powerlines plugins.
+*/
+function plugin(options = {}) {
+	return {
+		name: "id",
+		async config() {
+			this.log(LogLevelLabel.TRACE, "Providing default configuration for the Powerlines `id` build plugin.");
+			const config = { id: defu(options, { type: "nanoid" }) };
+			if (!config.id.type || !["nanoid"].includes(config.id.type)) {
+				if (config.id.type) this.log(LogLevelLabel.WARN, `Invalid ID generation type "${config.id.type}" specified. Defaulting to "nanoid".`);
+				config.id.type = "nanoid";
+			}
+			this.log(LogLevelLabel.DEBUG, `Using ID generation library: ${config.id.type}`);
+			return config;
+		},
+		async prepare() {
+			this.log(LogLevelLabel.TRACE, `Preparing the ID runtime artifacts for the Powerlines project.`);
+			let idModule;
+			switch (this.config.id.type) {
+				case "nanoid":
+				default:
+					idModule = nanoidModule;
+					break;
+			}
+			await this.emitBuiltin(await Promise.resolve(idModule(this)), "id", "id.ts");
+		}
+	};
+}
+var src_default = plugin;
+
+//#endregion
+export { src_default as default, nanoidModule, plugin };

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

@@ -1,10 +1,22 @@
-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)}
+const require_rolldown_runtime = require('../../../../_virtual/rolldown_runtime.cjs');
+let __stryke_string_format_title_case = require("@stryke/string-format/title-case");
+
+//#region ../powerlines/src/lib/utilities/file-header.ts
+function getBaseFileHeader(context) {
+	return `
+// Generated with ${(0, __stryke_string_format_title_case.titleCase)(context.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 */
+`;
+}
+function getFileHeader(context, options = {}) {
+	const { directive = null, prettierIgnore = false } = options;
+	return `/* eslint-disable */
 // biome-ignore lint: disable
-${i?`// prettier-ignore`:``}${r?`\n\n${r}\n`:`
-`}
-${n(e)}
+${prettierIgnore ? `// prettier-ignore` : ""}${directive ? `\n\n${directive}\n` : "\n"}
+${getBaseFileHeader(context)}
+
+`;
+}
 
-`}exports.getFileHeader=r;
+//#endregion
+exports.getFileHeader = getFileHeader;

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

@@ -1,10 +1,21 @@
-import{titleCase as e}from"@stryke/string-format/title-case";function t(t){return`
-// Generated with ${e(t.config.framework)}
+import { titleCase } from "@stryke/string-format/title-case";
+
+//#region ../powerlines/src/lib/utilities/file-header.ts
+function getBaseFileHeader(context) {
+	return `
+// Generated with ${titleCase(context.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 */
+`;
+}
+function getFileHeader(context, options = {}) {
+	const { directive = null, prettierIgnore = false } = options;
+	return `/* eslint-disable */
 // biome-ignore lint: disable
-${i?`// prettier-ignore`:``}${r?`\n\n${r}\n`:`
-`}
-${t(e)}
+${prettierIgnore ? `// prettier-ignore` : ""}${directive ? `\n\n${directive}\n` : "\n"}
+${getBaseFileHeader(context)}
+
+`;
+}
 
-`}export{n as getFileHeader};
+//#endregion
+export { getFileHeader };

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

@@ -78,10 +78,18 @@ interface ParseOptions extends ParserOptions {
    */
   allowReturnOutsideFunction?: boolean;
 }
+interface EmitOptions extends WriteOptions {
+  /**
+   * If true, will emit the file using {@link UnpluginBuildContext.emitFile | the bundler's emit function}.
+   */
+  emitWithBundler?: boolean;
+  needsCodeReference?: Parameters<UnpluginBuildContext["emitFile"]>[0]["needsCodeReference"];
+  originalFileName?: Parameters<UnpluginBuildContext["emitFile"]>[0]["originalFileName"];
+}
 /**
  * Options for emitting entry virtual files
  */
-type EmitEntryOptions = WriteOptions & Omit<ResolvedEntryTypeDefinition, "file">;
+type EmitEntryOptions = EmitOptions & Omit<ResolvedEntryTypeDefinition, "file">;
 /**
  * The unresolved Powerlines context.
  *
@@ -292,6 +300,22 @@ interface UnresolvedContext<TResolvedConfig extends ResolvedConfig = ResolvedCon
    * The Powerlines builtin virtual files
    */
   getBuiltins: () => Promise<VirtualFile[]>;
+  /**
+   * Resolves a file and writes it to the VFS if it does not already exist
+   *
+   * @param code - The source code of the file
+   * @param path - The path to write the file to
+   * @param options - Additional options for writing the file
+   */
+  emit: (code: string, path: string, options?: EmitOptions) => Promise<void>;
+  /**
+   * Synchronously resolves a file and writes it to the VFS if it does not already exist
+   *
+   * @param code - The source code of the file
+   * @param path - The path to write the file to
+   * @param options - Additional options for writing the file
+   */
+  emitSync: (code: string, path: string, options?: EmitOptions) => void;
   /**
    * Resolves a builtin virtual file and writes it to the VFS if it does not already exist
    *
@@ -300,7 +324,16 @@ interface UnresolvedContext<TResolvedConfig extends ResolvedConfig = ResolvedCon
    * @param path - An optional path to write the builtin file to
    * @param options - Additional options for writing the builtin file
    */
-  emitBuiltin: (code: string, id: string, path?: string, options?: WriteOptions) => Promise<void>;
+  emitBuiltin: (code: string, id: string, path?: string, options?: EmitOptions) => Promise<void>;
+  /**
+   * Synchronously resolves a builtin virtual file and writes it to the VFS if it does not already exist
+   *
+   * @param code - The source code of the builtin file
+   * @param id - The unique identifier of the builtin file
+   * @param path - An optional path to write the builtin file to
+   * @param options - Additional options for writing the builtin file
+   */
+  emitBuiltinSync: (code: string, id: string, path?: string, options?: EmitOptions) => void;
   /**
    * Resolves a entry virtual file and writes it to the VFS if it does not already exist
    *
@@ -309,6 +342,14 @@ interface UnresolvedContext<TResolvedConfig extends ResolvedConfig = ResolvedCon
    * @param options - Additional options for writing the entry file
    */
   emitEntry: (code: string, path: string, options?: EmitEntryOptions) => Promise<void>;
+  /**
+   * Synchronously resolves a entry virtual file and writes it to the VFS if it does not already exist
+   *
+   * @param code - The source code of the entry file
+   * @param path - An optional path to write the entry file to
+   * @param options - Additional options for writing the entry file
+   */
+  emitEntrySync: (code: string, path: string, options?: EmitEntryOptions) => void;
   /**
    * A function to update the context fields using a new user configuration options
    */

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

@@ -80,10 +80,18 @@ interface ParseOptions extends ParserOptions {
    */
   allowReturnOutsideFunction?: boolean;
 }
+interface EmitOptions extends WriteOptions {
+  /**
+   * If true, will emit the file using {@link UnpluginBuildContext.emitFile | the bundler's emit function}.
+   */
+  emitWithBundler?: boolean;
+  needsCodeReference?: Parameters<UnpluginBuildContext["emitFile"]>[0]["needsCodeReference"];
+  originalFileName?: Parameters<UnpluginBuildContext["emitFile"]>[0]["originalFileName"];
+}
 /**
  * Options for emitting entry virtual files
  */
-type EmitEntryOptions = WriteOptions & Omit<ResolvedEntryTypeDefinition, "file">;
+type EmitEntryOptions = EmitOptions & Omit<ResolvedEntryTypeDefinition, "file">;
 /**
  * The unresolved Powerlines context.
  *
@@ -294,6 +302,22 @@ interface UnresolvedContext<TResolvedConfig extends ResolvedConfig = ResolvedCon
    * The Powerlines builtin virtual files
    */
   getBuiltins: () => Promise<VirtualFile[]>;
+  /**
+   * Resolves a file and writes it to the VFS if it does not already exist
+   *
+   * @param code - The source code of the file
+   * @param path - The path to write the file to
+   * @param options - Additional options for writing the file
+   */
+  emit: (code: string, path: string, options?: EmitOptions) => Promise<void>;
+  /**
+   * Synchronously resolves a file and writes it to the VFS if it does not already exist
+   *
+   * @param code - The source code of the file
+   * @param path - The path to write the file to
+   * @param options - Additional options for writing the file
+   */
+  emitSync: (code: string, path: string, options?: EmitOptions) => void;
   /**
    * Resolves a builtin virtual file and writes it to the VFS if it does not already exist
    *
@@ -302,7 +326,16 @@ interface UnresolvedContext<TResolvedConfig extends ResolvedConfig = ResolvedCon
    * @param path - An optional path to write the builtin file to
    * @param options - Additional options for writing the builtin file
    */
-  emitBuiltin: (code: string, id: string, path?: string, options?: WriteOptions) => Promise<void>;
+  emitBuiltin: (code: string, id: string, path?: string, options?: EmitOptions) => Promise<void>;
+  /**
+   * Synchronously resolves a builtin virtual file and writes it to the VFS if it does not already exist
+   *
+   * @param code - The source code of the builtin file
+   * @param id - The unique identifier of the builtin file
+   * @param path - An optional path to write the builtin file to
+   * @param options - Additional options for writing the builtin file
+   */
+  emitBuiltinSync: (code: string, id: string, path?: string, options?: EmitOptions) => void;
   /**
    * Resolves a entry virtual file and writes it to the VFS if it does not already exist
    *
@@ -311,6 +344,14 @@ interface UnresolvedContext<TResolvedConfig extends ResolvedConfig = ResolvedCon
    * @param options - Additional options for writing the entry file
    */
   emitEntry: (code: string, path: string, options?: EmitEntryOptions) => Promise<void>;
+  /**
+   * Synchronously resolves a entry virtual file and writes it to the VFS if it does not already exist
+   *
+   * @param code - The source code of the entry file
+   * @param path - An optional path to write the entry file to
+   * @param options - Additional options for writing the entry file
+   */
+  emitEntrySync: (code: string, path: string, options?: EmitEntryOptions) => void;
   /**
    * A function to update the context fields using a new user configuration options
    */

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

@@ -13,6 +13,13 @@ interface StorageAdapter {
    * A name identifying the storage adapter type.
    */
   name: string;
+  /**
+   * The storage preset for the adapter.
+   *
+   * @remarks
+   * This can be used as an alternate way to identify the type of storage being used.
+   */
+  preset?: StoragePreset | null;
   /**
    * Checks if a key exists in the storage.
    *
@@ -207,6 +214,13 @@ interface WriteOptions {
    * @defaultValue false
    */
   skipFormat?: boolean;
+  /**
+   * The storage preset or adapter name for the output file.
+   *
+   * @remarks
+   * If not specified, the output mode will be determined by the provided `output.mode` value.
+   */
+  storage?: StoragePreset | string;
   /**
    * Additional metadata for the file.
    */

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

@@ -13,6 +13,13 @@ interface StorageAdapter {
    * A name identifying the storage adapter type.
    */
   name: string;
+  /**
+   * The storage preset for the adapter.
+   *
+   * @remarks
+   * This can be used as an alternate way to identify the type of storage being used.
+   */
+  preset?: StoragePreset | null;
   /**
    * Checks if a key exists in the storage.
    *
@@ -207,6 +214,13 @@ interface WriteOptions {
    * @defaultValue false
    */
   skipFormat?: boolean;
+  /**
+   * The storage preset or adapter name for the output file.
+   *
+   * @remarks
+   * If not specified, the output mode will be determined by the provided `output.mode` value.
+   */
+  storage?: StoragePreset | string;
   /**
    * Additional metadata for the file.
    */

package/dist/types/index.mjs

@@ -1 +1 @@
-export{};
+export {  };

package/dist/types/plugin.mjs

@@ -1 +1 @@
-export{};
+export {  };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@powerlines/plugin-id",
-  "version": "0.9.125",
+  "version": "0.9.127",
   "type": "module",
   "description": "A Powerlines plugin that provides unique identifier generation capabilities at runtime by adding the `id` builtin module.",
   "repository": {
@@ -129,15 +129,15 @@
   "keywords": ["powerlines", "storm-software", "powerlines-plugin"],
   "dependencies": {
     "@storm-software/config-tools": "^1.188.74",
-    "@stryke/path": "^0.24.0",
+    "@stryke/path": "^0.24.1",
     "defu": "^6.1.4",
-    "powerlines": "^0.36.21"
+    "powerlines": "^0.36.23"
   },
   "devDependencies": {
-    "@powerlines/nx": "^0.11.47",
+    "@powerlines/nx": "^0.11.49",
     "@storm-software/tsup": "^0.2.72",
     "@types/node": "^24.10.4"
   },
   "publishConfig": { "access": "public" },
-  "gitHead": "b16324cf857ea5743fd7ad06e18607b1ba32abe0"
+  "gitHead": "be47e546b48b9a82e460b5c5d4f02fb66e821f18"
 }