@powerlines/plugin-id 0.9.7 → 0.9.8

package/dist/chunk-FBBMZ4NC.cjs

@@ -0,0 +1,7 @@
+'use strict';/*****************************************
+*
+*      ⚡ Built by Storm Software
+*
+*****************************************/
+
+var c=Object.defineProperty;var d=(a,b)=>c(a,"name",{value:b,configurable:true});exports.a=d;

package/dist/chunk-UCUR73HG.js

@@ -0,0 +1,7 @@
+/*****************************************
+*
+*      ⚡ Built by Storm Software
+*
+*****************************************/
+
+var c=Object.defineProperty;var d=(a,b)=>c(a,"name",{value:b,configurable:true});export{d as a};

package/dist/components/index.cjs

@@ -0,0 +1 @@
+'use strict';var nanoid=require('./nanoid');Object.keys(nanoid).forEach(function(k){if(k!=='default'&&!Object.prototype.hasOwnProperty.call(exports,k))Object.defineProperty(exports,k,{enumerable:true,get:function(){return nanoid[k]}})});

package/dist/components/index.d.cts

@@ -0,0 +1,22 @@
+export { nanoidModule } from './nanoid.cjs';
+import '../index-CZ8NfQGb.cjs';
+import '@storm-software/build-tools/types';
+import '@storm-software/config-tools/types';
+import '@storm-software/config/types';
+import '@stryke/types/base';
+import '@stryke/types/configuration';
+import '@stryke/types/file';
+import 'vite';
+import '@stryke/env/get-env-paths';
+import '@stryke/types/package-json';
+import 'jiti';
+import 'oxc-parser';
+import 'semver';
+import 'unplugin';
+import '@stryke/types/tsconfig';
+import 'typescript';
+import '@stryke/json/types';
+import 'memfs';
+import 'node:fs';
+import 'unionfs';
+import '@stryke/types/array';

package/dist/components/index.d.ts

@@ -0,0 +1,22 @@
+export { nanoidModule } from './nanoid.js';
+import '../index-CZ8NfQGb.js';
+import '@storm-software/build-tools/types';
+import '@storm-software/config-tools/types';
+import '@storm-software/config/types';
+import '@stryke/types/base';
+import '@stryke/types/configuration';
+import '@stryke/types/file';
+import 'vite';
+import '@stryke/env/get-env-paths';
+import '@stryke/types/package-json';
+import 'jiti';
+import 'oxc-parser';
+import 'semver';
+import 'unplugin';
+import '@stryke/types/tsconfig';
+import 'typescript';
+import '@stryke/json/types';
+import 'memfs';
+import 'node:fs';
+import 'unionfs';
+import '@stryke/types/array';

package/dist/components/index.js

@@ -0,0 +1 @@
+export*from'./nanoid';

package/dist/components/nanoid.cjs

@@ -0,0 +1,96 @@
+'use strict';var chunkFBBMZ4NC_cjs=require('../chunk-FBBMZ4NC.cjs'),fileHeader=require('powerlines/lib/utilities/file-header');/*****************************************
+*
+*      ⚡ Built by Storm Software
+*
+*****************************************/
+
+function s(e){return `
+/**
+ * The ID module provides a set of utilities for generating unique identifiers.
+ *
+ * @module ${e.config.output.builtinPrefix}:id
+ */
+
+${fileHeader.getFileHeader(e)}
+
+/**
+ * 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;
+  }, "");
+}
+`}chunkFBBMZ4NC_cjs.a(s,"nanoidModule");exports.nanoidModule=s;

package/dist/components/nanoid.d.cts

@@ -0,0 +1,31 @@
+import { a as IdPluginContext } from '../index-CZ8NfQGb.cjs';
+import '@storm-software/build-tools/types';
+import '@storm-software/config-tools/types';
+import '@storm-software/config/types';
+import '@stryke/types/base';
+import '@stryke/types/configuration';
+import '@stryke/types/file';
+import 'vite';
+import '@stryke/env/get-env-paths';
+import '@stryke/types/package-json';
+import 'jiti';
+import 'oxc-parser';
+import 'semver';
+import 'unplugin';
+import '@stryke/types/tsconfig';
+import 'typescript';
+import '@stryke/json/types';
+import 'memfs';
+import 'node:fs';
+import 'unionfs';
+import '@stryke/types/array';
+
+/**
+ * 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;
+
+export { nanoidModule };

package/dist/components/nanoid.d.ts

@@ -0,0 +1,31 @@
+import { a as IdPluginContext } from '../index-CZ8NfQGb.js';
+import '@storm-software/build-tools/types';
+import '@storm-software/config-tools/types';
+import '@storm-software/config/types';
+import '@stryke/types/base';
+import '@stryke/types/configuration';
+import '@stryke/types/file';
+import 'vite';
+import '@stryke/env/get-env-paths';
+import '@stryke/types/package-json';
+import 'jiti';
+import 'oxc-parser';
+import 'semver';
+import 'unplugin';
+import '@stryke/types/tsconfig';
+import 'typescript';
+import '@stryke/json/types';
+import 'memfs';
+import 'node:fs';
+import 'unionfs';
+import '@stryke/types/array';
+
+/**
+ * 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;
+
+export { nanoidModule };

package/dist/components/nanoid.js

@@ -0,0 +1,96 @@
+import {a}from'../chunk-UCUR73HG.js';import {getFileHeader}from'powerlines/lib/utilities/file-header';/*****************************************
+*
+*      ⚡ Built by Storm Software
+*
+*****************************************/
+
+function u(e){return `
+/**
+ * The ID module provides a set of utilities for generating unique identifiers.
+ *
+ * @module ${e.config.output.builtinPrefix}:id
+ */
+
+${getFileHeader(e)}
+
+/**
+ * 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;
+  }, "");
+}
+`}a(u,"nanoidModule");export{u as nanoidModule};