@aidc-toolkit/utility 0.9.5 → 0.9.7-beta

package/dist/index.d.ts

@@ -1,8 +1,53 @@
+declare const utilityNS = "aidct_utility";
+
+/**
+ * Transformer input, one of:
+ *
+ * - T (primitive type)
+ * - Iterable<T>
+ *
+ * @template T
+ * Primitive type.
+ */
+type TransformerInput<T extends string | number | bigint | boolean> = T | Iterable<T>;
+/**
+ * Transformer callback, used to convert transformed value to its final value.
+ *
+ * @template TInput
+ * Type of input to callback.
+ *
+ * @template TOutput
+ * Type of output to callback.
+ *
+ * @param input
+ * Input value.
+ *
+ * @param index
+ * Index in sequence (0 for single transformation).
+ *
+ * @returns
+ * Output value.
+ */
+type TransformerCallback<TInput, TOutput> = (input: TInput, index: number) => TOutput;
+/**
+ * Transformer output, based on transformer input:
+ *
+ * - If type T is primitive type, result is type U.
+ * - If type T is Iterable type, result is type IterableIterator<U>.
+ *
+ * @template T
+ * Transformer input type.
+ *
+ * @template U
+ * Output base type.
+ */
+type TransformerOutput<T extends TransformerInput<string | number | bigint | boolean>, U> = T extends (T extends TransformerInput<infer V> ? V : never) ? U : IterableIterator<U>;
+
 /**
  * Iterator proxy. In environments where
  * {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Iterator#iterator_helpers |
- * iterator helpers} are supported, this references the {@link Iterator} variable directly. Otherwise, it references an
- * implementation of "from" that uses an internally-defined iterator proxy object.
+ * iterator helpers} are supported, this references the {@linkcode Iterator} variable directly. Otherwise, it references
+ * an implementation of "from" that uses an internally-defined iterator proxy object.
  *
  * Client applications should **not** rely on long-term availability of this variable as it will be removed once there
  * is widespread support for iterator helpers.
@@ -92,22 +137,6 @@ declare class Sequencer implements Iterable<bigint>, IterableIterator<bigint> {
     reset(): void;
 }
 
-/**
- * Transformation callback, used to convert transformed value to its final value.
- *
- * @template T
- * Type returned by callback.
- *
- * @param transformedValue
- * Transformed value.
- *
- * @param index
- * Index in sequence transformation (0 for single transformation).
- *
- * @returns
- * Final value.
- */
-type TransformationCallback<T> = (transformedValue: bigint, index: number) => T;
 /**
  * Transformer that transforms values in a numeric domain to values in a range equal to the domain or to another range
  * defined by a callback function. In other words, the domain determines valid input values and, without a callback, the
@@ -179,81 +208,39 @@ declare abstract class Transformer {
      */
     protected abstract doForward(value: bigint): bigint;
     /**
-     * Transform a value forward.
-     *
-     * @param value
-     * Value.
-     *
-     * @returns
-     * Transformed value.
-     */
-    forward(value: number | bigint): bigint;
-    /**
-     * Transform a value forward.
+     * Transform value(s) forward.
      *
      * @template T
-     * Type returned by transformation callback.
-     *
-     * @param value
-     * Value.
-     *
-     * @param transformationCallback
-     * Called after the value is transformed to convert it to its final value.
-     *
-     * @returns
-     * Value transformed into object.
-     */
-    forward<T>(value: number | bigint, transformationCallback: TransformationCallback<T>): T;
-    /**
-     * Transform values forward.
-     *
-     * @param values
-     * Values. If this is an instance of {@link Sequencer}, the minimum and maximum values are validated prior to
-     * transformation. Otherwise, the individual values are validated at the time of transformation.
-     *
-     * @returns
-     * Transformed values.
-     */
-    forward(values: Iterable<number | bigint>): IterableIterator<bigint>;
-    /**
-     * Transform values forward.
-     *
-     * @template T
-     * Type returned by transformation callback.
-     *
-     * @param values
-     * Values. If this is an instance of {@link Sequencer}, the minimum and maximum values are validated prior to
-     * transformation. Otherwise, the individual values are validated at the time of transformation.
-     *
-     * @param transformationCallback
-     * Called after each value is transformed to convert it to its final value.
-     *
-     * @returns
-     * Values transformed into objects.
-     */
-    forward<T>(values: Iterable<number | bigint>, transformationCallback: TransformationCallback<T>): IterableIterator<T>;
-    /**
-     * Transform a value or values forward. This signature exists to allow similar overloaded methods in other classes
-     * to call this method correctly.
+     * Value(s) input type.
      *
      * @param valueOrValues
+     * Value(s). If this is an instance of {@link Sequencer}, the minimum and maximum values are validated prior to
+     * transformation. Otherwise, the individual value(s) is/are validated at the time of transformation.
      *
      * @returns
+     * Transformed value(s).
      */
-    forward(valueOrValues: number | bigint | Iterable<number | bigint>): bigint | IterableIterator<bigint>;
+    forward<T extends TransformerInput<number | bigint>>(valueOrValues: T): TransformerOutput<T, bigint>;
     /**
-     * Transform a value or values forward. This signature exists to allow similar overloaded methods in other classes
-     * to call this method correctly.
+     * Transform value(s) forward, optionally applying a transformation.
      *
      * @template T
+     * Value(s) input type.
+     *
+     * @template U
+     * Transformation callback output type.
      *
      * @param valueOrValues
+     * Value(s). If this is an instance of {@link Sequencer}, the minimum and maximum values are validated prior to
+     * transformation. Otherwise, the individual value(s) is/are validated at the time of transformation.
      *
-     * @param transformationCallback
+     * @param transformerCallback
+     * Called after each value is transformed to convert it to its final value.
      *
      * @returns
+     * Transformed value(s).
      */
-    forward<T>(valueOrValues: number | bigint | Iterable<number | bigint>, transformationCallback: TransformationCallback<T>): T | IterableIterator<T>;
+    forward<T extends TransformerInput<number | bigint>, U>(valueOrValues: T, transformerCallback: TransformerCallback<bigint, U>): TransformerOutput<T, U>;
     /**
      * Do the work of transforming a value in reverse.
      *
@@ -699,19 +686,6 @@ declare class CharacterSetValidator implements StringValidator<CharacterSetValid
      */
     validate(s: string, validation?: CharacterSetValidation): void;
 }
-/**
- * Creation callback, used to convert created string to its final value.
- *
- * @param s
- * Created string.
- *
- * @param index
- * Index in sequence creation (0 for single creation).
- *
- * @returns
- * Final value.
- */
-type CreationCallback = (s: string, index: number) => string;
 /**
  * Character set creator. Maps numeric values to strings using the character set as digits.
  */
@@ -805,70 +779,29 @@ declare class CharacterSetCreator extends CharacterSetValidator {
      */
     private validateLength;
     /**
-     * Create a string by mapping a value to the equivalent characters in the character set across the length of the
+     * Create string(s) by mapping value(s) to the equivalent characters in the character set across the length of the
      * string.
      *
      * @param length
      * Required string length.
      *
-     * @param value
-     * Numeric value of the string.
-     *
-     * @param exclusion
-     * Strings to be excluded from the range of outputs. See {@link Exclusion} for possible values and their meaning.
-     *
-     * @param tweak
-     * If provided, the numerical value of the string is "tweaked" using an {@link EncryptionTransformer | encryption
-     * transformer}.
-     *
-     * @param creationCallback
-     * If provided, called after the string is constructed to create the final value.
-     *
-     * @returns
-     * String created from the value.
-     */
-    create(length: number, value: number | bigint, exclusion?: Exclusion, tweak?: number | bigint, creationCallback?: CreationCallback): string;
-    /**
-     * Create multiple strings by mapping each value to the equivalent characters in the character set across the length
-     * of the string. Equivalent to calling this method for each individual value.
-     *
-     * @param length
-     * Required string length.
-     *
-     * @param values
-     * Numeric values of the strings.
-     *
-     * @param exclusion
-     * Strings to be excluded from the range of outputs. See {@link Exclusion} for possible values and their meaning.
-     *
-     * @param tweak
-     * If provided, the numerical value of the strings are "tweaked" using an {@link EncryptionTransformer | encryption
-     * transformer}.
-     *
-     * @param creationCallback
-     * If provided, called after each string is constructed to create the final value.
-     *
-     * @returns
-     * Iterable iterator over strings created from the values.
-     */
-    create(length: number, values: Iterable<number | bigint>, exclusion?: Exclusion, tweak?: number | bigint, creationCallback?: CreationCallback): IterableIterator<string>;
-    /**
-     * Create a string or multiple strings. This signature exists to allow similar overloaded methods in other classes
-     * to call this method correctly.
-     *
-     * @param length
-     *
      * @param valueOrValues
+     * Numeric value(s) of the string(s).
      *
      * @param exclusion
+     * String(s) to be excluded from the range of outputs. See {@link Exclusion} for possible values and their meaning.
      *
      * @param tweak
+     * If provided, the numerical value of the string(s) is/are "tweaked" using an {@link EncryptionTransformer |
+     * encryption transformer}.
      *
-     * @param creationCallback
+     * @param creatorCallback
+     * If provided, called after each string is constructed to create the final value.
      *
      * @returns
+     * String(s) created from the value(s).
      */
-    create(length: number, valueOrValues: number | bigint | Iterable<number | bigint>, exclusion?: Exclusion, tweak?: number | bigint, creationCallback?: CreationCallback): string | IterableIterator<string>;
+    create<T extends TransformerInput<number | bigint>>(length: number, valueOrValues: T, exclusion?: Exclusion, tweak?: number | bigint, creatorCallback?: TransformerCallback<string, string>): TransformerOutput<T, string>;
     /**
      * Determine the value for a string.
      *
@@ -906,4 +839,4 @@ declare const ALPHABETIC_CREATOR: CharacterSetCreator;
  */
 declare const ALPHANUMERIC_CREATOR: CharacterSetCreator;
 
-export { ALPHABETIC_CREATOR, ALPHANUMERIC_CREATOR, CharacterSetCreator, type CharacterSetValidation, CharacterSetValidator, type CreationCallback, EncryptionTransformer, Exclusion, HEXADECIMAL_CREATOR, IdentityTransformer, IteratorProxy, NUMERIC_CREATOR, RecordValidator, RegExpValidator, Sequencer, type StringValidation, type StringValidator, type TransformationCallback, Transformer };
+export { ALPHABETIC_CREATOR, ALPHANUMERIC_CREATOR, CharacterSetCreator, type CharacterSetValidation, CharacterSetValidator, EncryptionTransformer, Exclusion, HEXADECIMAL_CREATOR, IdentityTransformer, IteratorProxy, NUMERIC_CREATOR, RecordValidator, RegExpValidator, Sequencer, type StringValidation, type StringValidator, Transformer, type TransformerCallback, type TransformerInput, type TransformerOutput, utilityNS };

package/dist/index.js

@@ -1,3 +1,81 @@
+// src/locale/i18n.ts
+import { i18nAddResourceBundle, i18nAssertValidResources, i18next } from "@aidc-toolkit/core";
+
+// src/locale/en/locale_strings.ts
+var localeStrings = {
+  Transformer: {
+    domainMustBeGreaterThanZero: "Domain {{domain}} must be greater than 0",
+    tweakMustBeGreaterThanOrEqualToZero: "Tweak {{tweak}} must be greater than or equal to 0",
+    valueMustBeGreaterThanOrEqualToZero: "Value {{value}} must be greater than or equal to 0",
+    valueMustBeLessThan: "Value {{value}} must be less than {{domain}}",
+    minValueMustBeGreaterThanOrEqualToZero: "Minimum value {{minValue}} must be greater than or equal to 0",
+    maxValueMustBeLessThan: "Maximum value {{maxValue}} must be less than {{domain}}"
+  },
+  RegExpValidator: {
+    stringDoesNotMatchPattern: "String {{s}} does not match pattern"
+  },
+  CharacterSetValidator: {
+    firstZeroFirstCharacter: "Character set must support zero as first character",
+    allNumericAllNumericCharacters: "Character set must support all numeric characters in sequence",
+    stringMustNotBeAllNumeric: "String must not be all numeric",
+    lengthMustBeGreaterThanOrEqualTo: "Length {{length}} must be greater than or equal to {{minimumLength}}",
+    lengthMustBeLessThanOrEqualTo: "Length {{length}} must be less than or equal to {{maximumLength}}",
+    lengthMustBeEqualTo: "Length {{length}} must be equal to {{exactLength}}",
+    lengthOfComponentMustBeGreaterThanOrEqualTo: "Length {{length}} of {{component}} must be greater than or equal to {{minimumLength}}",
+    lengthOfComponentMustBeLessThanOrEqualTo: "Length {{length}} of {{component}} must be less than or equal to {{maximumLength}}",
+    lengthOfComponentMustBeEqualTo: "Length {{length}} of {{component}} must be equal to {{exactLength}}",
+    invalidCharacterAtPosition: "Invalid character '{{c}}' at position {{position}}",
+    invalidCharacterAtPositionOfComponent: "Invalid character '{{c}}' at position {{position}} of {{component}}",
+    exclusionNotSupported: "Exclusion value of {{exclusion}} is not supported",
+    invalidTweakWithAllNumericExclusion: "Tweak must not be used with all-numeric exclusion",
+    endSequenceValueMustBeLessThanOrEqualTo: "End sequence value (start sequence value + count - 1) must be less than {{domain}}"
+  },
+  RecordValidator: {
+    typeNameKeyNotFound: '{{typeName}} "{{key}}" not found'
+  }
+};
+
+// src/locale/fr/locale_strings.ts
+var localeStrings2 = {
+  Transformer: {
+    domainMustBeGreaterThanZero: "Le domaine {{domain}} doit \xEAtre sup\xE9rieur \xE0 0",
+    tweakMustBeGreaterThanOrEqualToZero: "Le r\xE9glage {{tweak}} doit \xEAtre sup\xE9rieur ou \xE9gal \xE0 0",
+    valueMustBeGreaterThanOrEqualToZero: "La valeur {{value}} doit \xEAtre sup\xE9rieure ou \xE9gale \xE0 0",
+    valueMustBeLessThan: "La valeur {{value}} doit \xEAtre inf\xE9rieure \xE0 {{domain}}",
+    minValueMustBeGreaterThanOrEqualToZero: "La valeur minimale {{minValue}} doit \xEAtre sup\xE9rieure ou \xE9gale \xE0 0",
+    maxValueMustBeLessThan: "La valeur maximale {{maxValue}} doit \xEAtre inf\xE9rieure \xE0 {{domain}}"
+  },
+  RegExpValidator: {
+    stringDoesNotMatchPattern: "La cha\xEEne {{s}} ne correspond pas au mod\xE8le"
+  },
+  CharacterSetValidator: {
+    firstZeroFirstCharacter: "Le jeu de caract\xE8res doit prendre en charge z\xE9ro comme premier caract\xE8re",
+    allNumericAllNumericCharacters: "Le jeu de caract\xE8res doit prendre en charge tous les caract\xE8res num\xE9riques en s\xE9quence",
+    stringMustNotBeAllNumeric: "La cha\xEEne ne doit pas \xEAtre enti\xE8rement num\xE9rique",
+    lengthMustBeGreaterThanOrEqualTo: "La longueur {{length}} doit \xEAtre sup\xE9rieure ou \xE9gale \xE0 {{minimumLength}}",
+    lengthMustBeLessThanOrEqualTo: "La longueur {{length}} doit \xEAtre inf\xE9rieure ou \xE9gale \xE0 {{maximumLength}}",
+    lengthMustBeEqualTo: "La longueur {{length}} doit \xEAtre \xE9gale \xE0 {{exactLength}}",
+    lengthOfComponentMustBeGreaterThanOrEqualTo: "La longueur {{length}} de {{component}} doit \xEAtre sup\xE9rieure ou \xE9gale \xE0 {{minimumLength}}",
+    lengthOfComponentMustBeLessThanOrEqualTo: "La longueur {{length}} de {{component}} doit \xEAtre inf\xE9rieure ou \xE9gale \xE0 {{maximumLength}}",
+    lengthOfComponentMustBeEqualTo: "La longueur {{length}} de {{component}} doit \xEAtre \xE9gale \xE0 {{exactLength}}",
+    invalidCharacterAtPosition: "Caract\xE8re non valide '{{c}}' \xE0 la position {{position}}",
+    invalidCharacterAtPositionOfComponent: "Caract\xE8re non valide '{{c}}' \xE0 la position {{position}} de {{component}}",
+    exclusionNotSupported: "La valeur d'exclusion de {{exclusion}} n'est pas prise en charge",
+    invalidTweakWithAllNumericExclusion: "Le r\xE9glage ne doit pas \xEAtre utilis\xE9 avec une exclusion enti\xE8rement num\xE9rique",
+    endSequenceValueMustBeLessThanOrEqualTo: "La valeur de la s\xE9quence de fin (valeur de la s\xE9quence de d\xE9but + nombre - 1) doit \xEAtre inf\xE9rieure \xE0 {{domaine}}"
+  },
+  RecordValidator: {
+    typeNameKeyNotFound: '{{typeName}} "{{key}}" introuvable'
+  }
+};
+
+// src/locale/i18n.ts
+var utilityNS = "aidct_utility";
+i18nAssertValidResources(localeStrings, "fr", localeStrings2);
+i18nAddResourceBundle("en", utilityNS, localeStrings);
+i18nAddResourceBundle("fr", utilityNS, localeStrings2);
+var i18n_default = i18next;
+
 // src/iterator_proxy.ts
 var IteratorProxyBase = class _IteratorProxyBase {
   /**
@@ -500,84 +578,6 @@ var Sequencer = class {
   }
 };
 
-// src/locale/i18n.ts
-import { i18nAddResourceBundle, i18nAssertValidResources, i18next } from "@aidc-toolkit/core";
-
-// src/locale/en/locale_strings.ts
-var localeStrings = {
-  Transformer: {
-    domainMustBeGreaterThanZero: "Domain {{domain}} must be greater than 0",
-    tweakMustBeGreaterThanOrEqualToZero: "Tweak {{tweak}} must be greater than or equal to 0",
-    valueMustBeGreaterThanOrEqualToZero: "Value {{value}} must be greater than or equal to 0",
-    valueMustBeLessThan: "Value {{value}} must be less than {{domain}}",
-    minValueMustBeGreaterThanOrEqualToZero: "Minimum value {{minValue}} must be greater than or equal to 0",
-    maxValueMustBeLessThan: "Maximum value {{maxValue}} must be less than {{domain}}"
-  },
-  RegExpValidator: {
-    stringDoesNotMatchPattern: "String {{s}} does not match pattern"
-  },
-  CharacterSetValidator: {
-    firstZeroFirstCharacter: "Character set must support zero as first character",
-    allNumericAllNumericCharacters: "Character set must support all numeric characters in sequence",
-    stringMustNotBeAllNumeric: "String must not be all numeric",
-    lengthMustBeGreaterThanOrEqualTo: "Length {{length}} must be greater than or equal to {{minimumLength}}",
-    lengthMustBeLessThanOrEqualTo: "Length {{length}} must be less than or equal to {{maximumLength}}",
-    lengthMustBeEqualTo: "Length {{length}} must be equal to {{exactLength}}",
-    lengthOfComponentMustBeGreaterThanOrEqualTo: "Length {{length}} of {{component}} must be greater than or equal to {{minimumLength}}",
-    lengthOfComponentMustBeLessThanOrEqualTo: "Length {{length}} of {{component}} must be less than or equal to {{maximumLength}}",
-    lengthOfComponentMustBeEqualTo: "Length {{length}} of {{component}} must be equal to {{exactLength}}",
-    invalidCharacterAtPosition: "Invalid character '{{c}}' at position {{position}}",
-    invalidCharacterAtPositionOfComponent: "Invalid character '{{c}}' at position {{position}} of {{component}}",
-    exclusionNotSupported: "Exclusion value of {{exclusion}} is not supported",
-    invalidTweakWithAllNumericExclusion: "Tweak must not be used with all-numeric exclusion",
-    endSequenceValueMustBeLessThanOrEqualTo: "End sequence value (start sequence value + count - 1) must be less than {{domain}}"
-  },
-  RecordValidator: {
-    typeNameKeyNotFound: '{{typeName}} "{{key}}" not found'
-  }
-};
-
-// src/locale/fr/locale_strings.ts
-var localeStrings2 = {
-  Transformer: {
-    domainMustBeGreaterThanZero: "Le domaine {{domain}} doit \xEAtre sup\xE9rieur \xE0 0",
-    tweakMustBeGreaterThanOrEqualToZero: "Le r\xE9glage {{tweak}} doit \xEAtre sup\xE9rieur ou \xE9gal \xE0 0",
-    valueMustBeGreaterThanOrEqualToZero: "La valeur {{value}} doit \xEAtre sup\xE9rieure ou \xE9gale \xE0 0",
-    valueMustBeLessThan: "La valeur {{value}} doit \xEAtre inf\xE9rieure \xE0 {{domain}}",
-    minValueMustBeGreaterThanOrEqualToZero: "La valeur minimale {{minValue}} doit \xEAtre sup\xE9rieure ou \xE9gale \xE0 0",
-    maxValueMustBeLessThan: "La valeur maximale {{maxValue}} doit \xEAtre inf\xE9rieure \xE0 {{domain}}"
-  },
-  RegExpValidator: {
-    stringDoesNotMatchPattern: "La cha\xEEne {{s}} ne correspond pas au mod\xE8le"
-  },
-  CharacterSetValidator: {
-    firstZeroFirstCharacter: "Le jeu de caract\xE8res doit prendre en charge z\xE9ro comme premier caract\xE8re",
-    allNumericAllNumericCharacters: "Le jeu de caract\xE8res doit prendre en charge tous les caract\xE8res num\xE9riques en s\xE9quence",
-    stringMustNotBeAllNumeric: "La cha\xEEne ne doit pas \xEAtre enti\xE8rement num\xE9rique",
-    lengthMustBeGreaterThanOrEqualTo: "La longueur {{length}} doit \xEAtre sup\xE9rieure ou \xE9gale \xE0 {{minimumLength}}",
-    lengthMustBeLessThanOrEqualTo: "La longueur {{length}} doit \xEAtre inf\xE9rieure ou \xE9gale \xE0 {{maximumLength}}",
-    lengthMustBeEqualTo: "La longueur {{length}} doit \xEAtre \xE9gale \xE0 {{exactLength}}",
-    lengthOfComponentMustBeGreaterThanOrEqualTo: "La longueur {{length}} de {{component}} doit \xEAtre sup\xE9rieure ou \xE9gale \xE0 {{minimumLength}}",
-    lengthOfComponentMustBeLessThanOrEqualTo: "La longueur {{length}} de {{component}} doit \xEAtre inf\xE9rieure ou \xE9gale \xE0 {{maximumLength}}",
-    lengthOfComponentMustBeEqualTo: "La longueur {{length}} de {{component}} doit \xEAtre \xE9gale \xE0 {{exactLength}}",
-    invalidCharacterAtPosition: "Caract\xE8re non valide '{{c}}' \xE0 la position {{position}}",
-    invalidCharacterAtPositionOfComponent: "Caract\xE8re non valide '{{c}}' \xE0 la position {{position}} de {{component}}",
-    exclusionNotSupported: "La valeur d'exclusion de {{exclusion}} n'est pas prise en charge",
-    invalidTweakWithAllNumericExclusion: "Le r\xE9glage ne doit pas \xEAtre utilis\xE9 avec une exclusion enti\xE8rement num\xE9rique",
-    endSequenceValueMustBeLessThanOrEqualTo: "La valeur de la s\xE9quence de fin (valeur de la s\xE9quence de d\xE9but + nombre - 1) doit \xEAtre inf\xE9rieure \xE0 {{domaine}}"
-  },
-  RecordValidator: {
-    typeNameKeyNotFound: '{{typeName}} "{{key}}" introuvable'
-  }
-};
-
-// src/locale/i18n.ts
-var utilityNS = "aidct_utility";
-i18nAssertValidResources(localeStrings, "fr", localeStrings2);
-i18nAddResourceBundle("en", utilityNS, localeStrings);
-i18nAddResourceBundle("fr", utilityNS, localeStrings2);
-var i18n_default = i18next;
-
 // src/transformer.ts
 var Transformer = class _Transformer {
   /**
@@ -660,28 +660,14 @@ var Transformer = class _Transformer {
       }));
     }
   }
-  /**
-   * Transform a value or values forward.
-   *
-   * @template T
-   * Type returned by transformation callback.
-   *
-   * @param valueOrValues
-   * Value(s).
-   *
-   * @param transformationCallback
-   * Called after value(s) is/are transformed to convert it/them to its/their final value(s).
-   *
-   * @returns
-   * Value(s) transformed into object(s).
-   */
-  forward(valueOrValues, transformationCallback) {
+  // eslint-disable-next-line jsdoc/require-jsdoc -- Implementation of overloaded signatures.
+  forward(valueOrValues, transformerCallback) {
     let result;
     if (typeof valueOrValues !== "object") {
       const valueN = BigInt(valueOrValues);
       this.validate(valueN);
       const transformedValue = this.doForward(valueN);
-      result = transformationCallback === void 0 ? transformedValue : transformationCallback(transformedValue, 0);
+      result = transformerCallback === void 0 ? transformedValue : transformerCallback(transformedValue, 0);
     } else if (valueOrValues instanceof Sequencer) {
       if (valueOrValues.minValue < 0n) {
         throw new RangeError(i18n_default.t("Transformer.minValueMustBeGreaterThanOrEqualToZero", {
@@ -696,16 +682,16 @@ var Transformer = class _Transformer {
           domain: this.domain
         }));
       }
-      result = transformationCallback === void 0 ? IteratorProxy.from(valueOrValues).map((value) => this.doForward(value)) : IteratorProxy.from(valueOrValues).map((value, index) => transformationCallback(this.doForward(value), index));
+      result = transformerCallback === void 0 ? IteratorProxy.from(valueOrValues).map((value) => this.doForward(value)) : IteratorProxy.from(valueOrValues).map((value, index) => transformerCallback(this.doForward(value), index));
     } else {
-      result = transformationCallback === void 0 ? IteratorProxy.from(valueOrValues).map((value) => {
+      result = transformerCallback === void 0 ? IteratorProxy.from(valueOrValues).map((value) => {
         const valueN = BigInt(value);
         this.validate(valueN);
         return this.doForward(valueN);
       }) : IteratorProxy.from(valueOrValues).map((value, index) => {
         const valueN = BigInt(value);
         this.validate(valueN);
-        return transformationCallback(this.doForward(valueN), index);
+        return transformerCallback(this.doForward(valueN), index);
       });
     }
     return result;
@@ -1387,17 +1373,21 @@ var CharacterSetCreator = class _CharacterSetCreator extends CharacterSetValidat
       exclusionDomains[1 /* FirstZero */] = exclusionFirstZeroDomains;
     }
     if (exclusionSupport.includes(2 /* AllNumeric */)) {
+      let validateNumberIndexes2 = function(numberIndexes2) {
+        let expectedNumberIndex = numberIndexes2[0];
+        for (const numberIndex of numberIndexes2) {
+          if (numberIndex === void 0 || numberIndex !== expectedNumberIndex) {
+            throw new RangeError(i18n_default.t("CharacterSetValidator.allNumericAllNumericCharacters", {
+              ns: utilityNS
+            }));
+          }
+          expectedNumberIndex = numberIndex + 1;
+        }
+      };
+      var validateNumberIndexes = validateNumberIndexes2;
       const exclusionAllNumericDomains = new Array(_CharacterSetCreator.MAXIMUM_STRING_LENGTH + 1);
       const numberIndexes = this.characterIndexes("0123456789");
-      let expectedNumberIndex = numberIndexes[0];
-      for (const numberIndex of numberIndexes) {
-        if (numberIndex === void 0 || numberIndex !== expectedNumberIndex) {
-          throw new RangeError(i18n_default.t("CharacterSetValidator.allNumericAllNumericCharacters", {
-            ns: utilityNS
-          }));
-        }
-        expectedNumberIndex = numberIndex + 1;
-      }
+      validateNumberIndexes2(numberIndexes);
       const zeroIndex = BigInt(numberIndexes[0]);
       const allZerosValues = new Array(_CharacterSetCreator.MAXIMUM_STRING_LENGTH + 1);
       let allZerosValue = 0n;
@@ -1484,8 +1474,30 @@ var CharacterSetCreator = class _CharacterSetCreator extends CharacterSetValidat
       }));
     }
   }
-  // eslint-disable-next-line jsdoc/require-jsdoc -- Implementation of overloaded signatures.
-  create(length, valueOrValues, exclusion = 0 /* None */, tweak, creationCallback) {
+  /**
+   * Create string(s) by mapping value(s) to the equivalent characters in the character set across the length of the
+   * string.
+   *
+   * @param length
+   * Required string length.
+   *
+   * @param valueOrValues
+   * Numeric value(s) of the string(s).
+   *
+   * @param exclusion
+   * String(s) to be excluded from the range of outputs. See {@link Exclusion} for possible values and their meaning.
+   *
+   * @param tweak
+   * If provided, the numerical value of the string(s) is/are "tweaked" using an {@link EncryptionTransformer |
+   * encryption transformer}.
+   *
+   * @param creatorCallback
+   * If provided, called after each string is constructed to create the final value.
+   *
+   * @returns
+   * String(s) created from the value(s).
+   */
+  create(length, valueOrValues, exclusion = 0 /* None */, tweak, creatorCallback) {
     this.validateLength(length);
     this.validateExclusion(exclusion);
     const allZerosValue = exclusion === 2 /* AllNumeric */ ? this._allZerosValues[length] : 0n;
@@ -1504,7 +1516,7 @@ var CharacterSetCreator = class _CharacterSetCreator extends CharacterSetValidat
         }
         s = this.character(exclusion === 1 /* FirstZero */ ? Number(convertValue % this._characterSetSizeMinusOneN) + 1 : Number(convertValue % this._characterSetSizeN)) + s;
       }
-      return creationCallback !== void 0 ? creationCallback(s, index) : s;
+      return creatorCallback !== void 0 ? creatorCallback(s, index) : s;
     });
   }
   /**
@@ -1670,5 +1682,6 @@ export {
   RecordValidator,
   RegExpValidator,
   Sequencer,
-  Transformer
+  Transformer,
+  utilityNS
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aidc-toolkit/utility",
-  "version": "0.9.5",
+  "version": "0.9.7-beta",
   "description": "Foundational utilities for AIDC Toolkit",
   "type": "module",
   "main": "dist/index.js",
@@ -19,22 +19,21 @@
     "url": "https://www.linkedin.com/in/kdean"
   },
   "scripts": {
-    "eslint": "eslint .",
+    "lint": "eslint .",
     "build": "tsup src/index.ts --clean --format cjs,esm --dts",
     "build-doc": "npm run build && tsc src/index.ts --outDir dist --target esnext --moduleResolution nodenext --module nodenext --emitDeclarationOnly --declaration --declarationMap",
     "test": "vitest run"
   },
   "devDependencies": {
-    "@aidc-toolkit/dev": "^0.9.5",
-    "eslint": "^9.15.0",
+    "@aidc-toolkit/dev": "^0.9.7-beta",
+    "eslint": "^9.16.0",
     "ts-node": "^10.9.2",
     "tsup": "^8.3.5",
-    "typescript": "^5.6.3",
-    "vitest": "^2.1.5"
+    "typescript": "^5.7.2",
+    "vitest": "^2.1.8"
   },
   "dependencies": {
-    "@aidc-toolkit/core": "^0.9.5",
-    "@rollup/rollup-linux-x64-gnu": "^4.27.3",
-    "i18next": "^23.16.8"
+    "@aidc-toolkit/core": "^0.9.7-beta",
+    "@rollup/rollup-linux-x64-gnu": "^4.28.1"
   }
 }