@powerlines/plugin-id 0.9.132 → 0.9.134

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

@@ -0,0 +1,69 @@
+import { CompilerOptions, TsConfigJson } from "@stryke/types/tsconfig";
+import ts from "typescript";
+
+//#region ../powerlines/src/types/tsconfig.d.ts
+type ReflectionMode = "default" | "explicit" | "never";
+type RawReflectionMode = ReflectionMode | "" | boolean | string | string[] | undefined;
+/**
+ * Defines the level of reflection to be used during the transpilation process.
+ *
+ * @remarks
+ * The level determines how much extra data is captured in the byte code for each type. This can be one of the following values:
+ * - `minimal` - Only the essential type information is captured.
+ * - `normal` - Additional type information is captured, including some contextual data.
+ * - `verbose` - All available type information is captured, including detailed contextual data.
+ */
+type ReflectionLevel = "minimal" | "normal" | "verbose";
+interface DeepkitOptions {
+  /**
+   * Either true to activate reflection for all files compiled using this tsconfig,
+   * or a list of globs/file paths relative to this tsconfig.json.
+   * Globs/file paths can be prefixed with a ! to exclude them.
+   */
+  reflection?: RawReflectionMode;
+  /**
+   * Defines the level of reflection to be used during the transpilation process.
+   *
+   * @remarks
+   * The level determines how much extra data is captured in the byte code for each type. This can be one of the following values:
+   * - `minimal` - Only the essential type information is captured.
+   * - `normal` - Additional type information is captured, including some contextual data.
+   * - `verbose` - All available type information is captured, including detailed contextual data.
+   */
+  reflectionLevel?: ReflectionLevel;
+}
+type TSCompilerOptions = CompilerOptions & DeepkitOptions;
+/**
+ * The TypeScript compiler configuration.
+ *
+ * @see https://www.typescriptlang.org/docs/handbook/tsconfig-json.html
+ */
+interface TSConfig extends Omit<TsConfigJson, "reflection"> {
+  /**
+   * Either true to activate reflection for all files compiled using this tsconfig,
+   * or a list of globs/file paths relative to this tsconfig.json.
+   * Globs/file paths can be prefixed with a ! to exclude them.
+   */
+  reflection?: RawReflectionMode;
+  /**
+   * Defines the level of reflection to be used during the transpilation process.
+   *
+   * @remarks
+   * The level determines how much extra data is captured in the byte code for each type. This can be one of the following values:
+   * - `minimal` - Only the essential type information is captured.
+   * - `normal` - Additional type information is captured, including some contextual data.
+   * - `verbose` - All available type information is captured, including detailed contextual data.
+   */
+  reflectionLevel?: ReflectionLevel;
+  /**
+   * Instructs the TypeScript compiler how to compile `.ts` files.
+   */
+  compilerOptions?: TSCompilerOptions;
+}
+type ParsedTypeScriptConfig = ts.ParsedCommandLine & {
+  originalTsconfigJson: TsConfigJson;
+  tsconfigJson: TSConfig;
+  tsconfigFilePath: string;
+};
+//#endregion
+export { ParsedTypeScriptConfig, TSConfig };

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

@@ -0,0 +1,69 @@
+import { CompilerOptions, TsConfigJson } from "@stryke/types/tsconfig";
+import ts from "typescript";
+
+//#region ../powerlines/src/types/tsconfig.d.ts
+type ReflectionMode = "default" | "explicit" | "never";
+type RawReflectionMode = ReflectionMode | "" | boolean | string | string[] | undefined;
+/**
+ * Defines the level of reflection to be used during the transpilation process.
+ *
+ * @remarks
+ * The level determines how much extra data is captured in the byte code for each type. This can be one of the following values:
+ * - `minimal` - Only the essential type information is captured.
+ * - `normal` - Additional type information is captured, including some contextual data.
+ * - `verbose` - All available type information is captured, including detailed contextual data.
+ */
+type ReflectionLevel = "minimal" | "normal" | "verbose";
+interface DeepkitOptions {
+  /**
+   * Either true to activate reflection for all files compiled using this tsconfig,
+   * or a list of globs/file paths relative to this tsconfig.json.
+   * Globs/file paths can be prefixed with a ! to exclude them.
+   */
+  reflection?: RawReflectionMode;
+  /**
+   * Defines the level of reflection to be used during the transpilation process.
+   *
+   * @remarks
+   * The level determines how much extra data is captured in the byte code for each type. This can be one of the following values:
+   * - `minimal` - Only the essential type information is captured.
+   * - `normal` - Additional type information is captured, including some contextual data.
+   * - `verbose` - All available type information is captured, including detailed contextual data.
+   */
+  reflectionLevel?: ReflectionLevel;
+}
+type TSCompilerOptions = CompilerOptions & DeepkitOptions;
+/**
+ * The TypeScript compiler configuration.
+ *
+ * @see https://www.typescriptlang.org/docs/handbook/tsconfig-json.html
+ */
+interface TSConfig extends Omit<TsConfigJson, "reflection"> {
+  /**
+   * Either true to activate reflection for all files compiled using this tsconfig,
+   * or a list of globs/file paths relative to this tsconfig.json.
+   * Globs/file paths can be prefixed with a ! to exclude them.
+   */
+  reflection?: RawReflectionMode;
+  /**
+   * Defines the level of reflection to be used during the transpilation process.
+   *
+   * @remarks
+   * The level determines how much extra data is captured in the byte code for each type. This can be one of the following values:
+   * - `minimal` - Only the essential type information is captured.
+   * - `normal` - Additional type information is captured, including some contextual data.
+   * - `verbose` - All available type information is captured, including detailed contextual data.
+   */
+  reflectionLevel?: ReflectionLevel;
+  /**
+   * Instructs the TypeScript compiler how to compile `.ts` files.
+   */
+  compilerOptions?: TSCompilerOptions;
+}
+type ParsedTypeScriptConfig = ts.ParsedCommandLine & {
+  originalTsconfigJson: TsConfigJson;
+  tsconfigJson: TSConfig;
+  tsconfigFilePath: string;
+};
+//#endregion
+export { ParsedTypeScriptConfig, TSConfig };

package/dist/types/index.cjs

@@ -1,2 +0,0 @@
-require('../plugin-pBKbb5K9.cjs');
-require('../types-o3zWarRp.cjs');

package/dist/types/index.d.cts

@@ -1,3 +1,2 @@
-import { a as UniqueIdFormatType, c as __ΩIdPluginResolvedConfig, 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-mX-X7dCb.cjs";
-import "../index-D4ELpJXS.cjs";
+import { IdPluginContext, IdPluginOptions, IdPluginResolvedConfig, IdPluginUserConfig, UniqueIdFormatType, __ΩIdPluginContext, __ΩIdPluginOptions, __ΩIdPluginResolvedConfig, __ΩIdPluginUserConfig, __ΩUniqueIdFormatType } from "./plugin.cjs";
 export { IdPluginContext, IdPluginOptions, IdPluginResolvedConfig, IdPluginUserConfig, UniqueIdFormatType, __ΩIdPluginContext, __ΩIdPluginOptions, __ΩIdPluginResolvedConfig, __ΩIdPluginUserConfig, __ΩUniqueIdFormatType };

package/dist/types/index.d.mts

@@ -1,3 +1,2 @@
-import { a as UniqueIdFormatType, c as __ΩIdPluginResolvedConfig, 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-C39QU9V6.mjs";
-import "../index-9iG2qHLe.mjs";
+import { IdPluginContext, IdPluginOptions, IdPluginResolvedConfig, IdPluginUserConfig, UniqueIdFormatType, __ΩIdPluginContext, __ΩIdPluginOptions, __ΩIdPluginResolvedConfig, __ΩIdPluginUserConfig, __ΩUniqueIdFormatType } from "./plugin.mjs";
 export { IdPluginContext, IdPluginOptions, IdPluginResolvedConfig, IdPluginUserConfig, UniqueIdFormatType, __ΩIdPluginContext, __ΩIdPluginOptions, __ΩIdPluginResolvedConfig, __ΩIdPluginUserConfig, __ΩUniqueIdFormatType };

package/dist/types/index.mjs

@@ -1,4 +1 @@
-import "../plugin-ifZVa20V.mjs";
-import "../types-U3zd8PTP.mjs";
-
 export {  };

package/dist/types/plugin.cjs

@@ -1 +0,0 @@
-require('../plugin-pBKbb5K9.cjs');

package/dist/types/plugin.d.cts

@@ -1,2 +1,38 @@
-import { a as UniqueIdFormatType, c as __ΩIdPluginResolvedConfig, 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-mX-X7dCb.cjs";
+import { ResolvedConfig } from "../powerlines/src/types/resolved.cjs";
+import { PluginContext } from "../powerlines/src/types/context.cjs";
+import { UserConfig } from "../powerlines/src/types/config.cjs";
+
+//#region src/types/plugin.d.ts
+type UniqueIdFormatType = "nanoid";
+interface IdPluginOptions {
+  /**
+   * The type of ID generation format to use
+   *
+   * @remarks
+   * This value is used to determine which ID generation format to use. It can be one of the following:
+   * - [nanoid](https://github.com/ai/nanoid)
+   *
+   * @defaultValue "nanoid"
+   */
+  type?: UniqueIdFormatType;
+}
+interface IdPluginUserConfig extends UserConfig {
+  /**
+   * Options for the ID plugin.
+   */
+  id?: IdPluginOptions;
+}
+interface IdPluginResolvedConfig extends ResolvedConfig {
+  /**
+   * Options for the ID plugin.
+   */
+  id: Required<IdPluginOptions>;
+}
+type IdPluginContext<TResolvedConfig extends IdPluginResolvedConfig = IdPluginResolvedConfig> = PluginContext<TResolvedConfig>;
+declare type __ΩUniqueIdFormatType = any[];
+declare type __ΩIdPluginOptions = any[];
+declare type __ΩIdPluginUserConfig = any[];
+declare type __ΩIdPluginResolvedConfig = any[];
+declare type __ΩIdPluginContext = any[];
+//#endregion
 export { IdPluginContext, IdPluginOptions, IdPluginResolvedConfig, IdPluginUserConfig, UniqueIdFormatType, __ΩIdPluginContext, __ΩIdPluginOptions, __ΩIdPluginResolvedConfig, __ΩIdPluginUserConfig, __ΩUniqueIdFormatType };

package/dist/types/plugin.d.mts

@@ -1,2 +1,38 @@
-import { a as UniqueIdFormatType, c as __ΩIdPluginResolvedConfig, 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-C39QU9V6.mjs";
+import { ResolvedConfig } from "../powerlines/src/types/resolved.mjs";
+import { PluginContext } from "../powerlines/src/types/context.mjs";
+import { UserConfig } from "../powerlines/src/types/config.mjs";
+
+//#region src/types/plugin.d.ts
+type UniqueIdFormatType = "nanoid";
+interface IdPluginOptions {
+  /**
+   * The type of ID generation format to use
+   *
+   * @remarks
+   * This value is used to determine which ID generation format to use. It can be one of the following:
+   * - [nanoid](https://github.com/ai/nanoid)
+   *
+   * @defaultValue "nanoid"
+   */
+  type?: UniqueIdFormatType;
+}
+interface IdPluginUserConfig extends UserConfig {
+  /**
+   * Options for the ID plugin.
+   */
+  id?: IdPluginOptions;
+}
+interface IdPluginResolvedConfig extends ResolvedConfig {
+  /**
+   * Options for the ID plugin.
+   */
+  id: Required<IdPluginOptions>;
+}
+type IdPluginContext<TResolvedConfig extends IdPluginResolvedConfig = IdPluginResolvedConfig> = PluginContext<TResolvedConfig>;
+declare type __ΩUniqueIdFormatType = any[];
+declare type __ΩIdPluginOptions = any[];
+declare type __ΩIdPluginUserConfig = any[];
+declare type __ΩIdPluginResolvedConfig = any[];
+declare type __ΩIdPluginContext = any[];
+//#endregion
 export { IdPluginContext, IdPluginOptions, IdPluginResolvedConfig, IdPluginUserConfig, UniqueIdFormatType, __ΩIdPluginContext, __ΩIdPluginOptions, __ΩIdPluginResolvedConfig, __ΩIdPluginUserConfig, __ΩUniqueIdFormatType };

package/dist/types/plugin.mjs

@@ -1,3 +1 @@
-import "../plugin-ifZVa20V.mjs";
-
 export {  };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@powerlines/plugin-id",
-  "version": "0.9.132",
+  "version": "0.9.134",
   "type": "module",
   "description": "A Powerlines plugin that provides unique identifier generation capabilities at runtime by adding the `id` builtin module.",
   "repository": {
@@ -131,13 +131,13 @@
     "@storm-software/config-tools": "^1.188.75",
     "@stryke/path": "^0.24.1",
     "defu": "^6.1.4",
-    "powerlines": "^0.36.27"
+    "powerlines": "^0.36.29"
   },
   "devDependencies": {
-    "@powerlines/nx": "^0.11.53",
+    "@powerlines/nx": "^0.11.55",
     "@storm-software/tsup": "^0.2.73",
     "@types/node": "^24.10.4"
   },
   "publishConfig": { "access": "public" },
-  "gitHead": "fbc59ce584fd0f78d90d2dbaa18f9c9267bd3b61"
+  "gitHead": "bfbde2cda62a5307013bf11d1ef6a8500bcbc4b1"
 }

package/dist/components-kh0CpIG2.mjs

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

package/dist/index-9iG2qHLe.d.mts

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

package/dist/index-D4ELpJXS.d.cts

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

package/dist/index-D6CnpA_r.d.cts

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

package/dist/index-DL0uimUT.d.mts

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

package/dist/nanoid-BnZ5rqH7.d.cts

@@ -1,13 +0,0 @@
-import { t as IdPluginContext } from "./plugin-mX-X7dCb.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 as t };

package/dist/nanoid-CDBSPS2R.d.mts

@@ -1,13 +0,0 @@
-import { t as IdPluginContext } from "./plugin-C39QU9V6.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 as t };

package/dist/nanoid-Ck7ultxE.mjs

@@ -1,122 +0,0 @@
-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 getFileHeader(context, options = {}) {
-	const { directive = null, prettierIgnore = false } = options;
-	return `/* eslint-disable */
-// biome-ignore lint: disable
-${prettierIgnore ? `// prettier-ignore` : ""}${directive ? `\n\n${directive}\n` : "\n"}
-${getBaseFileHeader(context)}
-
-`;
-}
-
-//#endregion
-//#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 ${context.config.output.builtinPrefix}:id
- */
-
-${getFileHeader(context)}
-
-/**
- * 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;
-  }, "");
-}
-`;
-}
-
-//#endregion
-export { nanoidModule as t };

package/dist/nanoid-DvIF2L1a.cjs

@@ -1,128 +0,0 @@
-const require_index = require('./index.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 getFileHeader(context, options = {}) {
-	const { directive = null, prettierIgnore = false } = options;
-	return `/* eslint-disable */
-// biome-ignore lint: disable
-${prettierIgnore ? `// prettier-ignore` : ""}${directive ? `\n\n${directive}\n` : "\n"}
-${getBaseFileHeader(context)}
-
-`;
-}
-
-//#endregion
-//#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 ${context.config.output.builtinPrefix}:id
- */
-
-${getFileHeader(context)}
-
-/**
- * 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;
-  }, "");
-}
-`;
-}
-
-//#endregion
-Object.defineProperty(exports, 'nanoidModule', {
-  enumerable: true,
-  get: function () {
-    return nanoidModule;
-  }
-});