@aidc-toolkit/utility 0.9.5 → 0.9.6-beta

package/dist/index.cjs

@@ -699,28 +699,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", {
@@ -735,16 +721,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;
@@ -1426,17 +1412,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;
@@ -1523,8 +1513,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;
@@ -1543,7 +1555,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;
     });
   }
   /**

package/dist/index.d.cts

@@ -1,8 +1,51 @@
+/**
+ * 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 +135,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 +206,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.
-     *
-     * @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.
+     * Transform value(s) 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 +684,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 +777,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 +837,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 };

package/dist/index.d.ts

@@ -1,8 +1,51 @@
+/**
+ * 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 +135,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 +206,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.
-     *
-     * @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.
+     * Transform value(s) 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 +684,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 +777,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 +837,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 };