@aidc-toolkit/utility 1.0.23-beta → 1.0.25-beta

package/src/character-set.ts

@@ -1,9 +1,9 @@
-import { type Exclusion, Exclusions } from "./exclusion.js";
-import type { IndexedCallback } from "./iterable-utility.js";
-import { i18nextUtility } from "./locale/i18n.js";
-import { RegExpValidator } from "./reg-exp.js";
-import type { StringValidation, StringValidator } from "./string.js";
-import { Transformer, type TransformerInput, type TransformerOutput } from "./transformer.js";
+import { type Exclusion, Exclusions } from "./exclusion";
+import type { IndexedCallback } from "./iterable-utility";
+import { i18nextUtility } from "./locale/i18n";
+import { RegExpValidator } from "./reg-exp";
+import type { StringValidation, StringValidator } from "./string";
+import { Transformer, type TransformerInput, type TransformerOutput } from "./transformer";
 
 /**
  * Character set validation parameters.
@@ -81,7 +81,7 @@ export class CharacterSetValidator implements StringValidator<CharacterSetValida
      * set.
      *
      * @param exclusionSupport
-     * Exclusions supported by the character set. All character sets implicitly support {@link Exclusions.None}.
+     * Exclusions supported by the character set. All character sets implicitly support {@linkcode Exclusions.None}.
      */
     constructor(characterSet: readonly string[], ...exclusionSupport: readonly Exclusion[]) {
         this._characterSet = characterSet;
@@ -324,7 +324,7 @@ export class CharacterSetCreator extends CharacterSetValidator {
     private readonly _characterSetSizeMinusOneN: bigint;
 
     /**
-     * Domains for every length for every supported {@link Exclusions}.
+     * Domains for every length for every supported {@linkcode Exclusions}.
      */
     private readonly _exclusionDomains: ReadonlyArray<readonly bigint[]>;
 
@@ -341,7 +341,7 @@ export class CharacterSetCreator extends CharacterSetValidator {
      * set.
      *
      * @param exclusionSupport
-     * Exclusions supported by the character set. All character sets implicitly support {@link Exclusions.None}.
+     * Exclusions supported by the character set. All character sets implicitly support {@linkcode Exclusions.None}.
      */
     constructor(characterSet: readonly string[], ...exclusionSupport: readonly Exclusion[]) {
         super(characterSet, ...exclusionSupport);
@@ -488,7 +488,7 @@ export class CharacterSetCreator extends CharacterSetValidator {
     }
 
     /**
-     * Validate that a length is less than or equal to {@link MAXIMUM_STRING_LENGTH}. If not, an error is thrown.
+     * Validate that a length is less than or equal to {@linkcode MAXIMUM_STRING_LENGTH}. If not, an error is thrown.
      *
      * @param length
      * Length.
@@ -523,7 +523,8 @@ export class CharacterSetCreator extends CharacterSetValidator {
      * Numeric value(s) of the string(s).
      *
      * @param exclusion
-     * String(s) to be excluded from the range of outputs. See {@link Exclusions} for possible values and their meaning.
+     * String(s) to be excluded from the range of outputs. See {@linkcode Exclusions} for possible values and their
+     * meaning.
      *
      * @param tweak
      * If provided, the numerical value of the string(s) is/are "tweaked" using an {@link EncryptionTransformer |
@@ -553,7 +554,7 @@ export class CharacterSetCreator extends CharacterSetValidator {
 
                 if (exclusion === Exclusions.AllNumeric && convertValue >= allZerosValue) {
                     // Value to convert is shifted by the number of all-numeric strings that occur at or prior to it.
-                    convertValue = convertValue + this.allNumericShift(true, length, convertValue - allZerosValue);
+                    convertValue += this.allNumericShift(true, length, convertValue - allZerosValue);
                 }
 
                 // Build string from right to left excluding the first character.
@@ -581,7 +582,7 @@ export class CharacterSetCreator extends CharacterSetValidator {
      * String.
      *
      * @param exclusion
-     * Strings excluded from the range of inputs. See {@link Exclusions} for possible values and their meaning.
+     * Strings excluded from the range of inputs. See {@linkcode Exclusions} for possible values and their meaning.
      *
      * @param tweak
      * If provided, the numerical value of the string was "tweaked" using an {@link EncryptionTransformer | encryption
@@ -640,19 +641,19 @@ export class CharacterSetCreator extends CharacterSetValidator {
 }
 
 /**
- * Numeric creator. Character set is 0-9. Supports {@link Exclusions.FirstZero}.
+ * Numeric creator. Character set is 0-9. Supports {@linkcode Exclusions.FirstZero}.
  */
 export const NUMERIC_CREATOR = new CharacterSetCreator([
     "0", "1", "2", "3", "4", "5", "6", "7", "8", "9"
 ], Exclusions.FirstZero);
 
 /**
- * Numeric validator. Character set is 0-9. Supports {@link Exclusions.FirstZero}.
+ * Numeric validator. Character set is 0-9. Supports {@linkcode Exclusions.FirstZero}.
  */
 export const NUMERIC_VALIDATOR = NUMERIC_CREATOR as CharacterSetValidator;
 
 /**
- * Hexadecimal creator. Character set is 0-9, A-F. Supports {@link Exclusions.FirstZero} and {@link
+ * Hexadecimal creator. Character set is 0-9, A-F. Supports {@linkcode Exclusions.FirstZero} and {@linkcode
  * Exclusions.AllNumeric}.
  */
 export const HEXADECIMAL_CREATOR = new CharacterSetCreator([
@@ -661,7 +662,7 @@ export const HEXADECIMAL_CREATOR = new CharacterSetCreator([
 ], Exclusions.FirstZero, Exclusions.AllNumeric);
 
 /**
- * Hexadecimal validator. Character set is 0-9, A-F. Supports {@link Exclusions.FirstZero} and {@link
+ * Hexadecimal validator. Character set is 0-9, A-F. Supports {@linkcode Exclusions.FirstZero} and {@linkcode
  * Exclusions.AllNumeric}.
  */
 export const HEXADECIMAL_VALIDATOR = HEXADECIMAL_CREATOR as CharacterSetValidator;
@@ -680,7 +681,7 @@ export const ALPHABETIC_CREATOR = new CharacterSetCreator([
 export const ALPHABETIC_VALIDATOR = ALPHABETIC_CREATOR as CharacterSetValidator;
 
 /**
- * Alphanumeric creator. Character set is 0-9, A-Z. Supports {@link Exclusions.FirstZero} and {@link
+ * Alphanumeric creator. Character set is 0-9, A-Z. Supports {@linkcode Exclusions.FirstZero} and {@linkcode
  * Exclusions.AllNumeric}.
  */
 export const ALPHANUMERIC_CREATOR = new CharacterSetCreator([
@@ -690,7 +691,7 @@ export const ALPHANUMERIC_CREATOR = new CharacterSetCreator([
 ], Exclusions.FirstZero, Exclusions.AllNumeric);
 
 /**
- * Alphanumeric validator. Character set is 0-9, A-Z. Supports {@link Exclusions.FirstZero} and {@link
+ * Alphanumeric validator. Character set is 0-9, A-Z. Supports {@linkcode Exclusions.FirstZero} and {@linkcode
  * Exclusions.AllNumeric}.
  */
 export const ALPHANUMERIC_VALIDATOR = ALPHANUMERIC_CREATOR as CharacterSetValidator;

package/src/exclusion.ts

@@ -18,7 +18,12 @@ export const Exclusions = {
     AllNumeric: 2
 } as const;
 
+/**
+ * Exclusion key.
+ */
+export type ExclusionKey = keyof typeof Exclusions;
+
 /**
  * Exclusion.
  */
-export type Exclusion = typeof Exclusions[keyof typeof Exclusions];
+export type Exclusion = typeof Exclusions[ExclusionKey];

package/src/index.ts

@@ -14,12 +14,12 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-export * from "./locale/i18n.js";
-export * from "./sequence.js";
-export * from "./iterable-utility.js";
-export * from "./transformer.js";
-export type * from "./string.js";
-export * from "./reg-exp.js";
-export * from "./record.js";
-export * from "./exclusion.js";
-export * from "./character-set.js";
+export * from "./locale/i18n";
+export * from "./sequence";
+export * from "./iterable-utility";
+export * from "./transformer";
+export type * from "./string";
+export * from "./reg-exp";
+export * from "./record";
+export * from "./exclusion";
+export * from "./character-set";

package/src/locale/i18n.ts

@@ -1,7 +1,7 @@
-import { i18nAssertValidResources, i18nCoreInit, type I18nEnvironment } from "@aidc-toolkit/core";
+import { i18nCoreInit, type I18nEnvironment } from "@aidc-toolkit/core";
 import i18next, { type i18n, type Resource } from "i18next";
-import enLocaleResources from "./en/locale-resources.js";
-import frLocaleResources from "./fr/locale-resources.js";
+import enLocaleResources from "./en/locale-resources";
+import frLocaleResources from "./fr/locale-resources";
 
 export const utilityNS = "aidct_utility";
 
@@ -10,8 +10,6 @@ export const utilityNS = "aidct_utility";
  */
 export type UtilityLocaleResources = typeof enLocaleResources;
 
-i18nAssertValidResources(enLocaleResources, "fr", frLocaleResources);
-
 /**
  * Utility resources.
  */

package/src/locale/i18next.d.ts

@@ -1,4 +1,4 @@
-import type { UtilityLocaleResources } from "./i18n.js";
+import type { UtilityLocaleResources } from "./i18n";
 
 /**
  * Internationalization module.

package/src/record.ts

@@ -1,5 +1,5 @@
-import { i18nextUtility } from "./locale/i18n.js";
-import type { StringValidator } from "./string.js";
+import { i18nextUtility } from "./locale/i18n";
+import type { StringValidator } from "./string";
 
 /**
  * Record validator. Validation is performed against a record with a string key type and throws an error if the key is

package/src/reg-exp.ts

@@ -1,14 +1,14 @@
-import { i18nextUtility } from "./locale/i18n.js";
-import type { StringValidator } from "./string.js";
+import { i18nextUtility } from "./locale/i18n";
+import type { StringValidator } from "./string";
 
 /**
  * Regular expression validator. The regular expression applies to the full string only if constructed as such. For
- * example, <code>&#x2F;\d&#x2A;&#x2F;</code> (0 or more digits) matches every string, <code>&#x2F;\d+&#x2F;</code>
- * (1 or more digits) matches strings with at least one digit, <code>&#x2F;^\d&#x2A;$&#x2F;</code> matches strings that
- * are all digits or empty, and <code>&#x2F;^\d+$&#x2F;</code> matches strings that are all digits and not empty.
+ * example, <code>&#x2F;\d&#x2A;&#x2F;</code> (0 or more digits) matches every string, <code>&#x2F;\d+&#x2F;</code> (1
+ * or more digits) matches strings with at least one digit, <code>&#x2F;^\d&#x2A;$&#x2F;</code> matches strings that are
+ * all digits or empty, and <code>&#x2F;^\d+$&#x2F;</code> matches strings that are all digits and not empty.
  *
- * Clients of this class are recommended to override the {@link createErrorMessage} method create a more suitable error
- * message for their use case.
+ * Clients of this class are recommended to override the {@linkcode createErrorMessage | createErrorMessage()} method
+ * to create a more suitable error message for their use case.
  */
 export class RegExpValidator implements StringValidator {
     /**

package/src/string.ts

@@ -8,10 +8,10 @@ export interface StringValidation {
 /**
  * String validator interface.
  *
- * @template V
+ * @template TStringValidation
  * String validation type.
  */
-export interface StringValidator<V extends StringValidation = StringValidation> {
+export interface StringValidator<TStringValidation extends StringValidation = StringValidation> {
     /**
      * Validate a string and throw an error if validation fails.
      *
@@ -21,5 +21,5 @@ export interface StringValidator<V extends StringValidation = StringValidation>
      * @param validation
      * String validation parameters.
      */
-    validate: (s: string, validation?: V) => void;
+    validate: (s: string, validation?: TStringValidation) => void;
 }

package/src/transformer.ts

@@ -1,6 +1,6 @@
-import { type IndexedCallback, mapIterable } from "./iterable-utility.js";
-import { i18nextUtility } from "./locale/i18n.js";
-import { Sequence } from "./sequence.js";
+import { type IndexedCallback, mapIterable } from "./iterable-utility";
+import { i18nextUtility } from "./locale/i18n";
+import { Sequence } from "./sequence";
 
 /**
  * Transformer primitive type.
@@ -43,11 +43,12 @@ export type TransformerOutput<TTransformerInput extends TransformerInput<Transfo
  * into values in the same domain, typically for storage in a database where the data type and length are already fixed
  * and exfiltration of the data can have significant repercussions.
  *
- * Two subclasses are supported directly by this class: {@link IdentityTransformer} (which operates based on a domain
- * only) and {@link EncryptionTransformer} (which operates based on a domain and a tweak). If an application is expected
- * to make repeated use of a transformer with the same domain and (optional) tweak and can't manage the transformer
- * object, an in-memory cache is available via the {@link get} method. Properties in {@link IdentityTransformer} and
- * {@link EncryptionTransformer} are read-only once constructed, so there is no issue with their shared use.
+ * Two subclasses are supported directly by this class: {@linkcode IdentityTransformer} (which operates based on a
+ * domain only) and {@linkcode EncryptionTransformer} (which operates based on a domain and a tweak). If an application
+ * is expected to make repeated use of a transformer with the same domain and (optional) tweak and can't manage the
+ * transformer object, an in-memory cache is available via the {@linkcode get | get()} method. Properties in {@linkcode
+ * IdentityTransformer} and {@linkcode EncryptionTransformer} are read-only once constructed, so there is no issue with
+ * their shared use.
  */
 export abstract class Transformer {
     /**
@@ -77,10 +78,10 @@ export abstract class Transformer {
     }
 
     /**
-     * Get a transformer, constructing it if necessary. The type returned is {@link IdentityTransformer} if tweak is
-     * undefined, {@link EncryptionTransformer} if tweak is defined. Note that although an {@link EncryptionTransformer}
-     * with a zero tweak operates as an {@link IdentityTransformer}, {@link EncryptionTransformer} is still the type
-     * returned if a zero tweak is explicitly specified.
+     * Get a transformer, constructing it if necessary. The type returned is {@linkcode IdentityTransformer} if tweak is
+     * undefined, {@linkcode EncryptionTransformer} if tweak is defined. Note that although an {@linkcode
+     * EncryptionTransformer} with a zero tweak operates as an {@linkcode IdentityTransformer}, {@linkcode
+     * EncryptionTransformer} is still the type returned if a zero tweak is explicitly specified.
      *
      * @param domain
      * Domain.
@@ -89,7 +90,7 @@ export abstract class Transformer {
      * Tweak.
      *
      * @returns
-     * {@link IdentityTransformer} if tweak is undefined, {@link EncryptionTransformer} if tweak is defined.
+     * {@linkcode IdentityTransformer} if tweak is undefined, {@linkcode EncryptionTransformer} if tweak is defined.
      */
     static get(domain: number | bigint, tweak?: number | bigint): Transformer {
         const domainN = BigInt(domain);
@@ -195,7 +196,7 @@ export abstract class Transformer {
      * Value(s) input type.
      *
      * @param valueOrValues
-     * Value(s). If this is an instance of {@link Sequence}, the minimum and maximum values are validated prior to
+     * Value(s). If this is an instance of {@linkcode Sequence}, the minimum and maximum values are validated prior to
      * transformation. Otherwise, the individual value(s) is/are validated at the time of transformation.
      *
      * @returns
@@ -213,7 +214,7 @@ export abstract class Transformer {
      * Transformation callback output type.
      *
      * @param valueOrValues
-     * Value(s). If this is an instance of {@link Sequence}, the minimum and maximum values are validated prior to
+     * Value(s). If this is an instance of {@linkcode Sequence}, the minimum and maximum values are validated prior to
      * transformation. Otherwise, the individual value(s) is/are validated at the time of transformation.
      *
      * @param transformerCallback
@@ -305,9 +306,9 @@ export class IdentityTransformer extends Transformer {
 /**
  * Encryption transformer. Values are transformed using repeated shuffle and xor operations, similar to those found in
  * many cryptography algorithms, particularly AES. While sufficient for obfuscation of numeric sequences (e.g., serial
- * number generation, below), if true format-preserving encryption is required, a more robust algorithm such as
- * {@link https://doi.org/10.6028/NIST.SP.800-38Gr1-draft | FF1} is recommended. Furthermore, no work has been done to
- * mitigate {@link https://timing.attacks.cr.yp.to/index.html | timing attacks} for key detection.
+ * number generation, below), if true format-preserving encryption is required, a more robust algorithm such as {@link
+ * https://doi.org/10.6028/NIST.SP.800-38Gr1.2pd | FF1} is recommended. Furthermore, no work has been done to mitigate
+ * {@link https://timing.attacks.cr.yp.to/index.html | timing attacks} for key detection.
  *
  * The purpose of the encryption transformer is to generate pseudo-random values in a deterministic manner to obscure
  * the sequence of values generated over time. A typical example is for serial number generation, where knowledge of the

package/test/record.test.ts

@@ -9,7 +9,9 @@ describe("Record validator", () => {
         ValueD: "D"
     } as const;
 
-    type StringIndex = typeof StringIndexes[keyof typeof StringIndexes];
+    type StringIndexKey = keyof typeof StringIndexes;
+
+    type StringIndex = typeof StringIndexes[StringIndexKey];
 
     const stringRecord: Record<StringIndex, string> = {
         [StringIndexes.ValueA]: "This is for Value A",

package/tsup.config.ts

@@ -0,0 +1,3 @@
+import { tsupConfigAIDCToolkit } from "@aidc-toolkit/dev";
+
+export default tsupConfigAIDCToolkit;

package/typedoc.json

@@ -3,7 +3,5 @@
   "extends": [
     "@aidc-toolkit/dev/typedoc.json"
   ],
-  "name": "Utility",
-  "tsconfig": "node_modules/@aidc-toolkit/dev/tsconfig-build-dev.json",
-  "gitRevision": "main"
+  "name": "Utility"
 }

package/dist/character-set.d.ts

@@ -1,307 +0,0 @@
-import { type Exclusion } from "./exclusion.js";
-import type { IndexedCallback } from "./iterable-utility.js";
-import type { StringValidation, StringValidator } from "./string.js";
-import { type TransformerInput, type TransformerOutput } from "./transformer.js";
-/**
- * Character set validation parameters.
- */
-export interface CharacterSetValidation extends StringValidation {
-    /**
-     * Minimum length. If defined and the string is less than this length, an error is thrown.
-     */
-    minimumLength?: number | undefined;
-    /**
-     * Maximum length. If defined and the string is greater than this length, an error is thrown.
-     */
-    maximumLength?: number | undefined;
-    /**
-     * Exclusion from the string. If defined and the string is within the exclusion range, an error is thrown.
-     */
-    exclusion?: Exclusion | undefined;
-    /**
-     * Position offset within a larger string. Strings are sometimes composed of multiple substrings; this parameter
-     * ensures that the error notes the proper position in the string.
-     */
-    positionOffset?: number | undefined;
-    /**
-     * Name of component, typically but not exclusively within a larger string. This parameter ensure that the
-     * error notes the component that triggered it. Value may be a string or a callback that returns a string, the
-     * latter allowing for localization changes.
-     */
-    component?: string | (() => string) | undefined;
-}
-/**
- * Character set validator. Validates a string against a specified character set.
- */
-export declare class CharacterSetValidator implements StringValidator<CharacterSetValidation> {
-    private static readonly NOT_ALL_NUMERIC_VALIDATOR;
-    /**
-     * Character set.
-     */
-    private readonly _characterSet;
-    /**
-     * Character set map, mapping each character in the character set to its index such that
-     * `_characterSetMap.get(_characterSet[index]) === index`.
-     */
-    private readonly _characterSetMap;
-    /**
-     * Exclusions supported by the character set.
-     */
-    private readonly _exclusionSupport;
-    /**
-     * Constructor.
-     *
-     * @param characterSet
-     * Character set. Each element is a single-character string, unique within the array, that defines the character
-     * set.
-     *
-     * @param exclusionSupport
-     * Exclusions supported by the character set. All character sets implicitly support {@link Exclusions.None}.
-     */
-    constructor(characterSet: readonly string[], ...exclusionSupport: readonly Exclusion[]);
-    /**
-     * Get the character set.
-     */
-    get characterSet(): readonly string[];
-    /**
-     * Get the character set size.
-     */
-    get characterSetSize(): number;
-    /**
-     * Get the exclusions supported by the character set.
-     */
-    get exclusionSupport(): readonly Exclusion[];
-    /**
-     * Get the character at an index.
-     *
-     * @param index
-     * Index into the character set.
-     *
-     * @returns
-     * Character at the index.
-     */
-    character(index: number): string;
-    /**
-     * Get the index for a character.
-     *
-     * @param c
-     * Character.
-     *
-     * @returns
-     * Index for the character or undefined if the character is not in the character set.
-     */
-    characterIndex(c: string): number | undefined;
-    /**
-     * Get the indexes for all characters in a string.
-     *
-     * @param s
-     * String.
-     *
-     * @returns
-     * Array of indexes for each character or undefined if the character is not in the character set.
-     */
-    characterIndexes(s: string): ReadonlyArray<number | undefined>;
-    /**
-     * Convert a component definition to a string or undefined. Checks the type of the component and makes the callback
-     * if required.
-     *
-     * @param component
-     * Component definition as a string, callback, or undefined.
-     *
-     * @returns
-     * Component as a string or undefined.
-     */
-    private static componentToString;
-    /**
-     * Validate that an exclusion is supported. If not, an error is thrown.
-     *
-     * @param exclusion
-     * Exclusion.
-     */
-    protected validateExclusion(exclusion: Exclusion): void;
-    /**
-     * Validate a string. If the string violates the character set or any of the character set validation parameters, an
-     * error is thrown.
-     *
-     * @param s
-     * String.
-     *
-     * @param validation
-     * Character set validation parameters.
-     */
-    validate(s: string, validation?: CharacterSetValidation): void;
-}
-/**
- * Character set creator. Maps numeric values to strings using the character set as digits.
- */
-export declare class CharacterSetCreator extends CharacterSetValidator {
-    /**
-     * Maximum string length supported.
-     */
-    static readonly MAXIMUM_STRING_LENGTH = 40;
-    /**
-     * Powers of 10 from 1 (`10**0`) to `10**MAXIMUM_STRING_LENGTH`.
-     */
-    private static readonly _powersOf10;
-    /**
-     * Create powers of a given base from 1 (`base**0`) to `base**MAXIMUM_STRING_LENGTH`.
-     *
-     * @param base
-     * Number base.
-     *
-     * @returns
-     * Array of powers of base.
-     */
-    private static createPowersOf;
-    /**
-     * Get a power of 10.
-     *
-     * @param power
-     * Power.
-     *
-     * @returns
-     * `10**power`.
-     */
-    static powerOf10(power: number): bigint;
-    /**
-     * Character set size as big integer, cached for performance purposes.
-     */
-    private readonly _characterSetSizeN;
-    /**
-     * Character set size minus 1 as big integer, cached for performance purposes.
-     */
-    private readonly _characterSetSizeMinusOneN;
-    /**
-     * Domains for every length for every supported {@link Exclusions}.
-     */
-    private readonly _exclusionDomains;
-    /**
-     * Values that would generate all zeros in the created string.
-     */
-    private readonly _allZerosValues;
-    /**
-     * Constructor.
-     *
-     * @param characterSet
-     * Character set. Each element is a single-character string, unique within the array, that defines the character
-     * set.
-     *
-     * @param exclusionSupport
-     * Exclusions supported by the character set. All character sets implicitly support {@link Exclusions.None}.
-     */
-    constructor(characterSet: readonly string[], ...exclusionSupport: readonly Exclusion[]);
-    /**
-     * Get a power of character set size.
-     *
-     * @param power
-     * Power.
-     *
-     * @returns
-     * `characterSetSize**power`.
-     */
-    private powerOfSize;
-    /**
-     * Determine the shift required to skip all all-numeric strings up to the value.
-     *
-     * @param shiftForward
-     * True to shift forward (value to string), false to shift backward (string to value).
-     *
-     * @param length
-     * Length of string for which to get the all-numeric shift.
-     *
-     * @param value
-     * Value for which to get the all-numeric shift.
-     *
-     * @returns
-     * Shift required to skip all all-numeric strings.
-     */
-    private allNumericShift;
-    /**
-     * Validate that a length is less than or equal to {@link MAXIMUM_STRING_LENGTH}. If not, an error is thrown.
-     *
-     * @param length
-     * Length.
-     */
-    private validateLength;
-    /**
-     * Create string(s) by mapping value(s) to the equivalent characters in the character set across the length of the
-     * string.
-     *
-     * @template TTransformerInput
-     * Transformer input type.
-     *
-     * @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 Exclusions} 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<TTransformerInput extends TransformerInput<number | bigint>>(length: number, valueOrValues: TTransformerInput, exclusion?: Exclusion, tweak?: number | bigint, creatorCallback?: IndexedCallback<string, string>): TransformerOutput<TTransformerInput, string>;
-    /**
-     * Determine the value for a string.
-     *
-     * @param s
-     * String.
-     *
-     * @param exclusion
-     * Strings excluded from the range of inputs. See {@link Exclusions} for possible values and their meaning.
-     *
-     * @param tweak
-     * If provided, the numerical value of the string was "tweaked" using an {@link EncryptionTransformer | encryption
-     * transformer}.
-     *
-     * @returns
-     * Numeric value of the string.
-     */
-    valueFor(s: string, exclusion?: Exclusion, tweak?: number | bigint): bigint;
-}
-/**
- * Numeric creator. Character set is 0-9. Supports {@link Exclusions.FirstZero}.
- */
-export declare const NUMERIC_CREATOR: CharacterSetCreator;
-/**
- * Numeric validator. Character set is 0-9. Supports {@link Exclusions.FirstZero}.
- */
-export declare const NUMERIC_VALIDATOR: CharacterSetValidator;
-/**
- * Hexadecimal creator. Character set is 0-9, A-F. Supports {@link Exclusions.FirstZero} and {@link
- * Exclusions.AllNumeric}.
- */
-export declare const HEXADECIMAL_CREATOR: CharacterSetCreator;
-/**
- * Hexadecimal validator. Character set is 0-9, A-F. Supports {@link Exclusions.FirstZero} and {@link
- * Exclusions.AllNumeric}.
- */
-export declare const HEXADECIMAL_VALIDATOR: CharacterSetValidator;
-/**
- * Alphabetic creator. Character set is A-Z.
- */
-export declare const ALPHABETIC_CREATOR: CharacterSetCreator;
-/**
- * Alphabetic validator. Character set is A-Z.
- */
-export declare const ALPHABETIC_VALIDATOR: CharacterSetValidator;
-/**
- * Alphanumeric creator. Character set is 0-9, A-Z. Supports {@link Exclusions.FirstZero} and {@link
- * Exclusions.AllNumeric}.
- */
-export declare const ALPHANUMERIC_CREATOR: CharacterSetCreator;
-/**
- * Alphanumeric validator. Character set is 0-9, A-Z. Supports {@link Exclusions.FirstZero} and {@link
- * Exclusions.AllNumeric}.
- */
-export declare const ALPHANUMERIC_VALIDATOR: CharacterSetValidator;
-//# sourceMappingURL=character-set.d.ts.map

package/dist/character-set.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"character-set.d.ts","sourceRoot":"","sources":["../src/character-set.ts"],"names":[],"mappings":"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"}