@aidc-toolkit/utility 0.9.11-beta → 0.9.13-beta

package/dist/index.cjs

@@ -1,1345 +1,4 @@
-"use strict";
-var __create = Object.create;
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getProtoOf = Object.getPrototypeOf;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
-  // If the importer is in node compatibility mode or this is not an ESM
-  // file that has been converted to a CommonJS file using a Babel-
-  // compatible transform (i.e. "__esModule" has not been set), then set
-  // "default" to the CommonJS "module.exports" for node compatibility.
-  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
-  mod
-));
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-
-// src/index.ts
-var index_exports = {};
-__export(index_exports, {
-  ALPHABETIC_CREATOR: () => ALPHABETIC_CREATOR,
-  ALPHANUMERIC_CREATOR: () => ALPHANUMERIC_CREATOR,
-  CharacterSetCreator: () => CharacterSetCreator,
-  CharacterSetValidator: () => CharacterSetValidator,
-  EncryptionTransformer: () => EncryptionTransformer,
-  Exclusion: () => Exclusion,
-  HEXADECIMAL_CREATOR: () => HEXADECIMAL_CREATOR,
-  IdentityTransformer: () => IdentityTransformer,
-  NUMERIC_CREATOR: () => NUMERIC_CREATOR,
-  RecordValidator: () => RecordValidator,
-  RegExpValidator: () => RegExpValidator,
-  Sequence: () => Sequence,
-  Transformer: () => Transformer,
-  i18nUtilityInit: () => i18nUtilityInit,
-  i18nextUtility: () => i18nextUtility,
-  transformIterable: () => transformIterable,
-  utilityNS: () => utilityNS,
-  utilityResources: () => utilityResources
-});
-module.exports = __toCommonJS(index_exports);
-
-// src/locale/i18n.ts
-var import_core = require("@aidc-toolkit/core");
-var import_i18next = __toESM(require("i18next"), 1);
-
-// 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}}",
-    minimumValueMustBeGreaterThanOrEqualToZero: "Minimum value {{minimumValue}} must be greater than or equal to 0",
-    maximumValueMustBeLessThan: "Maximum value {{maximumValue}} 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}}",
-    minimumValueMustBeGreaterThanOrEqualToZero: "La valeur minimale {{minimumValue}} doit \xEAtre sup\xE9rieure ou \xE9gale \xE0 0",
-    maximumValueMustBeLessThan: "La valeur maximale {{maximumValue}} 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";
-(0, import_core.i18nAssertValidResources)(localeStrings, "fr", localeStrings2);
-var utilityResources = {
-  en: {
-    aidct_utility: localeStrings
-  },
-  fr: {
-    aidct_utility: localeStrings2
-  }
-};
-var i18nextUtility = import_i18next.default.createInstance();
-async function i18nUtilityInit(environment, debug = false) {
-  await (0, import_core.i18nCoreInit)(i18nextUtility, environment, debug, utilityNS, utilityResources);
-}
-
-// src/sequence.ts
-var Sequence = class {
-  /**
-   * Start value (inclusive).
-   */
-  _startValue;
-  /**
-   * End value (exclusive).
-   */
-  _endValue;
-  /**
-   * Count of values.
-   */
-  _count;
-  /**
-   * Delta to the next value; equal to the sign of the count.
-   */
-  _nextDelta;
-  /**
-   * Minimum value (inclusive).
-   */
-  _minimumValue;
-  /**
-   * Maximum value (inclusive).
-   */
-  _maximumValue;
-  /**
-   * Constructor.
-   *
-   * @param startValue
-   * Start value.
-   *
-   * @param count
-   * Count of values. If count is zero or positive, iteration ascends from start value, otherwise it descends from
-   * start value.
-   */
-  constructor(startValue, count) {
-    this._startValue = BigInt(startValue);
-    this._endValue = this._startValue + BigInt(count);
-    this._count = count;
-    if (count >= 0) {
-      this._nextDelta = 1n;
-      this._minimumValue = this._startValue;
-      this._maximumValue = this._endValue - 1n;
-    } else {
-      this._nextDelta = -1n;
-      this._minimumValue = this._endValue + 1n;
-      this._maximumValue = this._startValue;
-    }
-  }
-  /**
-   * Get the start value (inclusive).
-   */
-  get startValue() {
-    return this._startValue;
-  }
-  /**
-   * Get the end value (exclusive).
-   */
-  get endValue() {
-    return this._endValue;
-  }
-  /**
-   * Get the count of values.
-   */
-  get count() {
-    return this._count;
-  }
-  /**
-   * Get the minimum value (inclusive).
-   */
-  get minimumValue() {
-    return this._minimumValue;
-  }
-  /**
-   * Get the maximum value (inclusive).
-   */
-  get maximumValue() {
-    return this._maximumValue;
-  }
-  /**
-   * Iterable implementation.
-   *
-   * @yields
-   * Next value in sequence.
-   */
-  *[Symbol.iterator]() {
-    for (let value = this._startValue; value !== this._endValue; value += this._nextDelta) {
-      yield value;
-    }
-  }
-};
-
-// src/transformer.ts
-function transformIterable(values, transformerCallback) {
-  return {
-    /**
-     * Iterable implementation.
-     *
-     * @yields
-     * Next output value.
-     */
-    *[Symbol.iterator]() {
-      let index = 0;
-      for (const value of values) {
-        yield transformerCallback(value, index++);
-      }
-    }
-  };
-}
-var Transformer = class _Transformer {
-  /**
-   * Transformers cache, mapping a domain to another map, which maps an optional tweak to a transformer.
-   */
-  static TRANSFORMER_MAPS_MAP = /* @__PURE__ */ new Map();
-  /**
-   * Domain.
-   */
-  _domain;
-  /**
-   * Constructor.
-   *
-   * @param domain
-   * Domain.
-   */
-  constructor(domain) {
-    this._domain = BigInt(domain);
-    if (this._domain <= 0n) {
-      throw new RangeError(i18nextUtility.t("Transformer.domainMustBeGreaterThanZero", {
-        domain
-      }));
-    }
-  }
-  /**
-   * 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.
-   *
-   * @param domain
-   * Domain.
-   *
-   * @param tweak
-   * Tweak.
-   *
-   * @returns
-   * {@link IdentityTransformer} if tweak is undefined, {@link EncryptionTransformer} if tweak is defined.
-   */
-  static get(domain, tweak) {
-    const domainN = BigInt(domain);
-    let transformersMap = _Transformer.TRANSFORMER_MAPS_MAP.get(domainN);
-    if (transformersMap === void 0) {
-      transformersMap = /* @__PURE__ */ new Map();
-      _Transformer.TRANSFORMER_MAPS_MAP.set(domainN, transformersMap);
-    }
-    const tweakN = tweak === void 0 ? void 0 : BigInt(tweak);
-    let transformer = transformersMap.get(tweakN);
-    if (transformer === void 0) {
-      transformer = tweakN === void 0 ? new IdentityTransformer(domainN) : new EncryptionTransformer(domainN, tweakN);
-      transformersMap.set(tweakN, transformer);
-    }
-    return transformer;
-  }
-  /**
-   * Get the domain.
-   */
-  get domain() {
-    return this._domain;
-  }
-  /**
-   * Validate that a value is within the domain.
-   *
-   * @param value
-   * Value.
-   */
-  validate(value) {
-    if (value < 0n) {
-      throw new RangeError(i18nextUtility.t("Transformer.valueMustBeGreaterThanOrEqualToZero", {
-        value
-      }));
-    }
-    if (value >= this.domain) {
-      throw new RangeError(i18nextUtility.t("Transformer.valueMustBeLessThan", {
-        value,
-        domain: this.domain
-      }));
-    }
-  }
-  /**
-   * Validate that a value is within the domain and do the work of transforming it forward.
-   *
-   * @param value
-   * Value.
-   *
-   * @returns
-   * Transformed value.
-   */
-  validateDoForward(value) {
-    const valueN = BigInt(value);
-    this.validate(valueN);
-    return this.doForward(valueN);
-  }
-  /**
-   * Validate that a value is within the domain, do the work of transforming it forward, and apply a callback.
-   *
-   * @param transformerCallback
-   * Called after each value is transformed to convert it to its final value.
-   *
-   * @param value
-   * Value.
-   *
-   * @param index
-   * Index in sequence (0 for single transformation).
-   *
-   * @returns
-   * Transformed value.
-   */
-  validateDoForwardCallback(transformerCallback, value, index) {
-    return transformerCallback(this.validateDoForward(value), index);
-  }
-  // eslint-disable-next-line jsdoc/require-jsdoc -- Implementation of overloaded signatures.
-  forward(valueOrValues, transformerCallback) {
-    let result;
-    if (typeof valueOrValues !== "object") {
-      result = transformerCallback === void 0 ? this.validateDoForward(valueOrValues) : this.validateDoForwardCallback(transformerCallback, valueOrValues, 0);
-    } else if (valueOrValues instanceof Sequence) {
-      if (valueOrValues.minimumValue < 0n) {
-        throw new RangeError(i18nextUtility.t("Transformer.minimumValueMustBeGreaterThanOrEqualToZero", {
-          minimumValue: valueOrValues.minimumValue
-        }));
-      }
-      if (valueOrValues.maximumValue >= this.domain) {
-        throw new RangeError(i18nextUtility.t("Transformer.maximumValueMustBeLessThan", {
-          maximumValue: valueOrValues.maximumValue,
-          domain: this.domain
-        }));
-      }
-      result = transformerCallback === void 0 ? transformIterable(valueOrValues, (value) => this.doForward(value)) : transformIterable(valueOrValues, (value, index) => transformerCallback(this.doForward(value), index));
-    } else {
-      result = transformerCallback === void 0 ? transformIterable(valueOrValues, (value) => this.validateDoForward(value)) : transformIterable(valueOrValues, (value, index) => this.validateDoForwardCallback(transformerCallback, value, index));
-    }
-    return result;
-  }
-  /**
-   * Transform a value in reverse.
-   *
-   * @param transformedValue
-   * Transformed value.
-   *
-   * @returns
-   * Value.
-   */
-  reverse(transformedValue) {
-    const transformedValueN = BigInt(transformedValue);
-    this.validate(transformedValueN);
-    return this.doReverse(transformedValueN);
-  }
-};
-var IdentityTransformer = class extends Transformer {
-  /**
-   * @inheritDoc
-   */
-  doForward(value) {
-    return value;
-  }
-  /**
-   * @inheritDoc
-   */
-  doReverse(transformedValue) {
-    return transformedValue;
-  }
-};
-var EncryptionTransformer = class _EncryptionTransformer extends Transformer {
-  /**
-   * Individual bits, pre-calculated for performance.
-   */
-  static BITS = new Uint8Array([
-    1,
-    2,
-    4,
-    8,
-    16,
-    32,
-    64,
-    128
-  ]);
-  /**
-   * Inverse individual bits, pre-calculated for performance.
-   */
-  static INVERSE_BITS = new Uint8Array([
-    254,
-    253,
-    251,
-    247,
-    239,
-    223,
-    191,
-    127
-  ]);
-  /**
-   * Number of bytes covered by the domain.
-   */
-  _domainBytes;
-  /**
-   * Xor bytes array generated from the domain and tweak.
-   */
-  _xorBytes;
-  /**
-   * Bits array generated from the domain and tweak.
-   */
-  _bits;
-  /**
-   * Inverse bits array generated from the domain and tweak.
-   */
-  _inverseBits;
-  /**
-   * Number of rounds (length of arrays) generated from the domain and tweak.
-   */
-  _rounds;
-  /**
-   * Constructor.
-   *
-   * @param domain
-   * Domain.
-   *
-   * @param tweak
-   * Tweak.
-   */
-  constructor(domain, tweak) {
-    super(domain);
-    if (tweak < 0n) {
-      throw new RangeError(i18nextUtility.t("Transformer.tweakMustBeGreaterThanOrEqualToZero", {
-        tweak
-      }));
-    }
-    let domainBytes = 0;
-    for (let reducedDomainMinusOne = this.domain - 1n; reducedDomainMinusOne !== 0n; reducedDomainMinusOne >>= 8n) {
-      domainBytes++;
-    }
-    this._domainBytes = domainBytes;
-    const xorBytes = new Array();
-    const bits = new Array();
-    const inverseBits = new Array();
-    for (let reducedKey = this.domain * BigInt(tweak) * 603868999n; reducedKey !== 0n; reducedKey >>= 8n) {
-      xorBytes.unshift(Number(BigInt.asUintN(8, reducedKey)));
-      const bitNumber = Number(BigInt.asUintN(3, reducedKey));
-      bits.push(_EncryptionTransformer.BITS[bitNumber]);
-      inverseBits.push(_EncryptionTransformer.INVERSE_BITS[bitNumber]);
-    }
-    if (domainBytes === 1) {
-      const domainMask = _EncryptionTransformer.BITS.filter((bit) => bit < domain).reduce((accumulator, bit) => accumulator | bit, 0);
-      this._xorBytes = new Uint8Array([xorBytes.reduce((accumulator, xorByte) => accumulator ^ xorByte, 0) & domainMask]);
-      this._bits = new Uint8Array([_EncryptionTransformer.BITS[0]]);
-      this._inverseBits = new Uint8Array([_EncryptionTransformer.INVERSE_BITS[0]]);
-      this._rounds = 1;
-    } else {
-      this._xorBytes = new Uint8Array(xorBytes);
-      this._bits = new Uint8Array(bits);
-      this._inverseBits = new Uint8Array(inverseBits);
-      this._rounds = xorBytes.length;
-    }
-  }
-  /**
-   * Convert a value to a byte array big enough to handle the entire domain.
-   *
-   * @param value
-   * Value.
-   *
-   * @returns
-   * Big-endian byte array equivalent to the value.
-   */
-  valueToBytes(value) {
-    const bytes = new Uint8Array(this._domainBytes);
-    for (let index = this._domainBytes - 1, reducedValue = value; index >= 0 && reducedValue !== 0n; index--, reducedValue >>= 8n) {
-      bytes[index] = Number(BigInt.asUintN(8, reducedValue));
-    }
-    return bytes;
-  }
-  /**
-   * Convert a byte array to a value.
-   *
-   * @param bytes
-   * Big-endian byte array equivalent to the value.
-   *
-   * @returns
-   * Value.
-   */
-  static bytesToValue(bytes) {
-    return bytes.reduce((accumulator, byte) => accumulator << 8n | BigInt(byte), 0n);
-  }
-  /**
-   * Shuffle a byte array.
-   *
-   * The input array to the forward operation (output from the reverse operation) is `bytes` and the output array from
-   * the forward operation (input to the reverse operation) is `bytes'`.
-   *
-   * The shuffle operation starts by testing the bit at `bits[round]` for each `byte` in `bytes`. The indexes for all
-   * bytes with that bit set are put into one array (`shuffleIndexes1`) and the rest are put into another
-   * (`shuffleIndexes0`). The two arrays are concatenated and used to shuffle the input array, using their values
-   * (`shuffleIndex`) and the indexes of those values (`index`) in the concatenated array.
-   *
-   * Forward shuffling moves the entry at `shuffleIndex` to the `index` position.
-   *
-   * Reverse shuffling moves the entry at `index` to the `shuffleIndex` position.
-   *
-   * As each byte is moved, the bit at `bits[round]` is preserved in its original position. This ensures that the
-   * process is reversible.
-   *
-   * @param bytes
-   * Byte array.
-   *
-   * @param round
-   * Round number.
-   *
-   * @param forward
-   * True if operating forward (encrypting), false if operating in reverse (decrypting).
-   *
-   * @returns
-   * Shuffled byte array.
-   */
-  shuffle(bytes, round, forward) {
-    const bytesLength = bytes.length;
-    const determinants = new Uint8Array(bytesLength);
-    const shuffleIndexes1 = new Array();
-    const shuffleIndexes0 = new Array();
-    const bit = this._bits[round];
-    bytes.forEach((byte, index) => {
-      const determinant = byte & bit;
-      determinants[index] = determinant;
-      (determinant !== 0 ? shuffleIndexes1 : shuffleIndexes0).push(index);
-    });
-    const inverseBit = this._inverseBits[round];
-    const shuffleBytes = new Uint8Array(bytesLength);
-    [...shuffleIndexes1, ...shuffleIndexes0].forEach((shuffleIndex, index) => {
-      if (forward) {
-        shuffleBytes[index] = bytes[shuffleIndex] & inverseBit | determinants[index];
-      } else {
-        shuffleBytes[shuffleIndex] = bytes[index] & inverseBit | determinants[shuffleIndex];
-      }
-    });
-    return shuffleBytes;
-  }
-  /**
-   * Xor a byte array.
-   *
-   * The input array to the forward operation (output from the reverse operation) is `bytes` and the output array from
-   * the forward operation (input to the reverse operation) is `bytes'`.
-   *
-   * Forward:
-   * - `bytes'[0] = bytes[0] ^ xorBytes[round]`
-   * - `bytes'[1] = bytes[1] ^ bytes'[0]`
-   * - `bytes'[2] = bytes[2] ^ bytes'[1]`
-   * - `...`
-   * - `bytes'[domainBytes - 1] = bytes[domainBytes - 1] ^ bytes'[domainBytes - 2]`
-   *
-   * Reverse:
-   * - `bytes[0] = bytes'[0] ^ xorBytes[round]`
-   * - `bytes[1] = bytes'[1] ^ bytes'[0]`
-   * - `bytes[2] = bytes'[2] ^ bytes'[1]`
-   * - `...`
-   * - `bytes[domainBytes - 1] = bytes'[domainBytes - 1] ^ bytes'[domainBytes - 2]`
-   *
-   * @param bytes
-   * Byte array.
-   *
-   * @param round
-   * Round number.
-   *
-   * @param forward
-   * True if operating forward (encrypting), false if operating in reverse (decrypting).
-   *
-   * @returns
-   * Xored byte array.
-   */
-  xor(bytes, round, forward) {
-    let cumulativeXorByte = this._xorBytes[round];
-    return bytes.map((byte) => {
-      const xorByte = byte ^ cumulativeXorByte;
-      cumulativeXorByte = forward ? xorByte : byte;
-      return xorByte;
-    });
-  }
-  /**
-   * @inheritDoc
-   */
-  doForward(value) {
-    let bytes = this.valueToBytes(value);
-    let transformedValue;
-    do {
-      for (let round = 0; round < this._rounds; round++) {
-        bytes = this.xor(this.shuffle(bytes, round, true), round, true);
-      }
-      transformedValue = _EncryptionTransformer.bytesToValue(bytes);
-    } while (transformedValue >= this.domain);
-    return transformedValue;
-  }
-  /**
-   * @inheritDoc
-   */
-  doReverse(transformedValue) {
-    let bytes = this.valueToBytes(transformedValue);
-    let value;
-    do {
-      for (let round = this._rounds - 1; round >= 0; round--) {
-        bytes = this.shuffle(this.xor(bytes, round, false), round, false);
-      }
-      value = _EncryptionTransformer.bytesToValue(bytes);
-    } while (value >= this.domain);
-    return value;
-  }
-};
-
-// src/reg-exp.ts
-var RegExpValidator = class {
-  /**
-   * Regular expression.
-   */
-  _regExp;
-  /**
-   * Constructor.
-   *
-   * @param regExp
-   * Regular expression. See {@link RegExpValidator | class documentation} for notes.
-   */
-  constructor(regExp) {
-    this._regExp = regExp;
-  }
-  /**
-   * Get the regular expression.
-   */
-  get regExp() {
-    return this._regExp;
-  }
-  /**
-   * Create an error message for a string. The generic error message is sufficient for many use cases but a more
-   * domain-specific error message, possibly including the pattern itself, is often required.
-   *
-   * @param s
-   * String.
-   *
-   * @returns
-   * Error message.
-   */
-  createErrorMessage(s) {
-    return i18nextUtility.t("RegExpValidator.stringDoesNotMatchPattern", {
-      s
-    });
-  }
-  /**
-   * @inheritDoc
-   */
-  validate(s) {
-    if (!this._regExp.test(s)) {
-      throw new RangeError(this.createErrorMessage(s));
-    }
-  }
-};
-
-// src/record.ts
-var RecordValidator = class {
-  /**
-   * Type name for error message.
-   */
-  _typeName;
-  /**
-   * Record in which to look up keys.
-   */
-  _record;
-  /**
-   * Constructor.
-   *
-   * @param typeName
-   * Type name for error message.
-   *
-   * @param record
-   * Record in which to look up keys.
-   */
-  constructor(typeName, record) {
-    this._typeName = typeName;
-    this._record = record;
-  }
-  /**
-   * Get the type name.
-   */
-  get typeName() {
-    return this._typeName;
-  }
-  /**
-   * Get the record.
-   */
-  get record() {
-    return this._record;
-  }
-  /**
-   * Validate a key by looking it up in the record.
-   *
-   * @param key
-   * Record key.
-   */
-  validate(key) {
-    if (!(key in this.record)) {
-      throw new RangeError(i18nextUtility.t("RecordValidator.typeNameKeyNotFound", {
-        typeName: this.typeName,
-        key
-      }));
-    }
-  }
-};
-
-// src/character-set.ts
-var Exclusion = /* @__PURE__ */ ((Exclusion2) => {
-  Exclusion2[Exclusion2["None"] = 0] = "None";
-  Exclusion2[Exclusion2["FirstZero"] = 1] = "FirstZero";
-  Exclusion2[Exclusion2["AllNumeric"] = 2] = "AllNumeric";
-  return Exclusion2;
-})(Exclusion || {});
-var CharacterSetValidator = class _CharacterSetValidator {
-  static NOT_ALL_NUMERIC_VALIDATOR = new class extends RegExpValidator {
-    /**
-     * Create an error message for an all-numeric string.
-     *
-     * @param _s
-     * String.
-     *
-     * @returns
-     * Error message.
-     */
-    createErrorMessage(_s) {
-      return i18nextUtility.t("CharacterSetValidator.stringMustNotBeAllNumeric");
-    }
-  }(/\D/);
-  /**
-   * Character set.
-   */
-  _characterSet;
-  /**
-   * Character set map, mapping each character in the character set to its index such that
-   * `_characterSetMap.get(_characterSet[index]) === index`.
-   */
-  _characterSetMap;
-  /**
-   * Exclusions supported by the character set.
-   */
-  _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 Exclusion.None}.
-   */
-  constructor(characterSet, ...exclusionSupport) {
-    this._characterSet = characterSet;
-    const characterSetMap = /* @__PURE__ */ new Map();
-    characterSet.forEach((c, index) => {
-      characterSetMap.set(c, index);
-    });
-    this._characterSetMap = characterSetMap;
-    this._exclusionSupport = exclusionSupport;
-  }
-  /**
-   * Get the character set.
-   */
-  get characterSet() {
-    return this._characterSet;
-  }
-  /**
-   * Get the character set size.
-   */
-  get characterSetSize() {
-    return this._characterSet.length;
-  }
-  /**
-   * Get the exclusions supported by the character set.
-   */
-  get exclusionSupport() {
-    return this._exclusionSupport;
-  }
-  /**
-   * Get the character at an index.
-   *
-   * @param index
-   * Index into the character set.
-   *
-   * @returns
-   * Character at the index.
-   */
-  character(index) {
-    return this._characterSet[index];
-  }
-  /**
-   * 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) {
-    return this._characterSetMap.get(c);
-  }
-  /**
-   * 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) {
-    return s.split("").map((c) => this._characterSetMap.get(c));
-  }
-  /**
-   * 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.
-   */
-  static componentToString(component) {
-    return typeof component === "function" ? component() : component;
-  }
-  /**
-   * Validate that an exclusion is supported. If not, an error is thrown.
-   *
-   * @param exclusion
-   * Exclusion.
-   */
-  validateExclusion(exclusion) {
-    if (exclusion !== 0 /* None */ && !this._exclusionSupport.includes(exclusion)) {
-      throw new RangeError(i18nextUtility.t("CharacterSetValidator.exclusionNotSupported", {
-        exclusion
-      }));
-    }
-  }
-  /**
-   * 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, validation) {
-    const length = s.length;
-    const minimumLength = validation?.minimumLength;
-    const maximumLength = validation?.maximumLength;
-    if (minimumLength !== void 0 && length < minimumLength) {
-      let errorMessage;
-      if (maximumLength !== void 0 && maximumLength === minimumLength) {
-        errorMessage = i18nextUtility.t(validation?.component === void 0 ? "CharacterSetValidator.lengthMustBeEqualTo" : "CharacterSetValidator.lengthOfComponentMustBeEqualTo", {
-          component: _CharacterSetValidator.componentToString(validation?.component),
-          length,
-          exactLength: minimumLength
-        });
-      } else {
-        errorMessage = i18nextUtility.t(validation?.component === void 0 ? "CharacterSetValidator.lengthMustBeGreaterThanOrEqualTo" : "CharacterSetValidator.lengthOfComponentMustBeGreaterThanOrEqualTo", {
-          component: _CharacterSetValidator.componentToString(validation?.component),
-          length,
-          minimumLength
-        });
-      }
-      throw new RangeError(errorMessage);
-    }
-    if (maximumLength !== void 0 && length > maximumLength) {
-      throw new RangeError(i18nextUtility.t(validation?.component === void 0 ? "CharacterSetValidator.lengthMustBeLessThanOrEqualTo" : "CharacterSetValidator.lengthOfComponentMustBeLessThanOrEqualTo", {
-        component: _CharacterSetValidator.componentToString(validation?.component),
-        length,
-        maximumLength
-      }));
-    }
-    const index = this.characterIndexes(s).findIndex((characterIndex) => characterIndex === void 0);
-    if (index !== -1) {
-      throw new RangeError(i18nextUtility.t(validation?.component === void 0 ? "CharacterSetValidator.invalidCharacterAtPosition" : "CharacterSetValidator.invalidCharacterAtPositionOfComponent", {
-        component: _CharacterSetValidator.componentToString(validation?.component),
-        c: s.charAt(index),
-        position: index + (validation?.positionOffset ?? 0) + 1
-      }));
-    }
-    if (validation?.exclusion !== void 0) {
-      this.validateExclusion(validation.exclusion);
-      switch (validation.exclusion) {
-        case 0 /* None */:
-          break;
-        case 1 /* FirstZero */:
-          if (s.startsWith("0")) {
-            throw new RangeError(i18nextUtility.t(validation.component === void 0 ? "CharacterSetValidator.invalidCharacterAtPosition" : "CharacterSetValidator.invalidCharacterAtPositionOfComponent", {
-              component: _CharacterSetValidator.componentToString(validation.component),
-              c: "0",
-              position: (validation.positionOffset ?? 0) + 1
-            }));
-          }
-          break;
-        case 2 /* AllNumeric */:
-          _CharacterSetValidator.NOT_ALL_NUMERIC_VALIDATOR.validate(s);
-          break;
-      }
-    }
-  }
-};
-var CharacterSetCreator = class _CharacterSetCreator extends CharacterSetValidator {
-  /**
-   * Maximum string length supported.
-   */
-  static MAXIMUM_STRING_LENGTH = 40;
-  /**
-   * Powers of 10 from 1 (`10**0`) to `10**MAXIMUM_STRING_LENGTH`.
-   */
-  static _powersOf10 = _CharacterSetCreator.createPowersOf(10);
-  /**
-   * 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.
-   */
-  static createPowersOf(base) {
-    const powersOf = new Array(this.MAXIMUM_STRING_LENGTH + 1);
-    const baseN = BigInt(base);
-    for (let index = 0, powerOf = 1n; index <= this.MAXIMUM_STRING_LENGTH; index++, powerOf *= baseN) {
-      powersOf[index] = powerOf;
-    }
-    return powersOf;
-  }
-  /**
-   * Get a power of 10.
-   *
-   * @param power
-   * Power.
-   *
-   * @returns
-   * `10**power`.
-   */
-  static powerOf10(power) {
-    return this._powersOf10[power];
-  }
-  /**
-   * Character set size as big integer, cached for performance purposes.
-   */
-  _characterSetSizeN;
-  /**
-   * Character set size minus 1 as big integer, cached for performance purposes.
-   */
-  _characterSetSizeMinusOneN;
-  /**
-   * Domains for every length for every supported {@link Exclusion}.
-   */
-  _exclusionDomains;
-  /**
-   * Values that would generate all zeros in the created string.
-   */
-  _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 Exclusion.None}.
-   */
-  constructor(characterSet, ...exclusionSupport) {
-    super(characterSet, ...exclusionSupport);
-    this._characterSetSizeN = BigInt(this.characterSetSize);
-    this._characterSetSizeMinusOneN = BigInt(this.characterSetSize - 1);
-    const exclusionDomains = [];
-    const exclusionNoneDomains = _CharacterSetCreator.createPowersOf(this.characterSetSize);
-    exclusionDomains[0 /* None */] = exclusionNoneDomains;
-    if (exclusionSupport.includes(1 /* FirstZero */)) {
-      if (characterSet[0] !== "0") {
-        throw new RangeError(i18nextUtility.t("CharacterSetValidator.firstZeroFirstCharacter"));
-      }
-      const exclusionFirstZeroDomains = new Array(_CharacterSetCreator.MAXIMUM_STRING_LENGTH + 1);
-      exclusionFirstZeroDomains[0] = 0n;
-      for (let index = 1; index <= _CharacterSetCreator.MAXIMUM_STRING_LENGTH; index++) {
-        exclusionFirstZeroDomains[index] = this._characterSetSizeMinusOneN * exclusionNoneDomains[index - 1];
-      }
-      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(i18nextUtility.t("CharacterSetValidator.allNumericAllNumericCharacters"));
-          }
-          expectedNumberIndex = numberIndex + 1;
-        }
-      };
-      var validateNumberIndexes = validateNumberIndexes2;
-      const exclusionAllNumericDomains = new Array(_CharacterSetCreator.MAXIMUM_STRING_LENGTH + 1);
-      const numberIndexes = this.characterIndexes("0123456789");
-      validateNumberIndexes2(numberIndexes);
-      const zeroIndex = BigInt(numberIndexes[0]);
-      const allZerosValues = new Array(_CharacterSetCreator.MAXIMUM_STRING_LENGTH + 1);
-      let allZerosValue = 0n;
-      for (let index = 0; index <= _CharacterSetCreator.MAXIMUM_STRING_LENGTH; index++) {
-        exclusionAllNumericDomains[index] = exclusionNoneDomains[index] - _CharacterSetCreator.powerOf10(index);
-        allZerosValues[index] = allZerosValue;
-        allZerosValue = allZerosValue * this._characterSetSizeN + zeroIndex;
-      }
-      this._allZerosValues = allZerosValues;
-      exclusionDomains[2 /* AllNumeric */] = exclusionAllNumericDomains;
-    } else {
-      this._allZerosValues = [];
-    }
-    this._exclusionDomains = exclusionDomains;
-  }
-  /**
-   * Get a power of character set size.
-   *
-   * @param power
-   * Power.
-   *
-   * @returns
-   * `characterSetSize**power`.
-   */
-  powerOfSize(power) {
-    return this._exclusionDomains[0 /* None */][power];
-  }
-  /**
-   * 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.
-   */
-  allNumericShift(shiftForward, length, value) {
-    let shift;
-    if (length === 0) {
-      if (!shiftForward && value < 10n) {
-        throw new RangeError(i18nextUtility.t("CharacterSetValidator.stringMustNotBeAllNumeric"));
-      }
-      shift = 10n;
-    } else {
-      const powerOfSize = this.powerOfSize(length);
-      const powerOf10 = _CharacterSetCreator.powerOf10(length);
-      const gap = shiftForward ? powerOfSize - powerOf10 : powerOfSize;
-      const gaps = value / gap;
-      if (gaps >= 10n) {
-        shift = _CharacterSetCreator.powerOf10(length + 1);
-      } else {
-        shift = gaps * powerOf10 + this.allNumericShift(shiftForward, length - 1, value - gaps * gap);
-      }
-    }
-    return shift;
-  }
-  /**
-   * Validate that a length is less than or equal to {@link MAXIMUM_STRING_LENGTH}. If not, an error is thrown.
-   *
-   * @param length
-   * Length.
-   */
-  validateLength(length) {
-    if (length < 0) {
-      throw new RangeError(i18nextUtility.t("CharacterSetValidator.lengthMustBeGreaterThanOrEqualTo", {
-        length,
-        minimumLength: 0
-      }));
-    }
-    if (length > _CharacterSetCreator.MAXIMUM_STRING_LENGTH) {
-      throw new RangeError(i18nextUtility.t("CharacterSetValidator.lengthMustBeLessThanOrEqualTo", {
-        length,
-        maximumLength: _CharacterSetCreator.MAXIMUM_STRING_LENGTH
-      }));
-    }
-  }
-  /**
-   * 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;
-    const transformer = Transformer.get(this._exclusionDomains[exclusion][length], tweak);
-    return transformer.forward(valueOrValues, (transformedValue, index) => {
-      let s = "";
-      if (length !== 0) {
-        let convertValue = transformedValue;
-        if (exclusion === 2 /* AllNumeric */ && convertValue >= allZerosValue) {
-          convertValue = convertValue + this.allNumericShift(true, length, convertValue - allZerosValue);
-        }
-        for (let position = length - 1; position > 0; position--) {
-          const nextConvertValue = convertValue / this._characterSetSizeN;
-          s = this.character(Number(convertValue - nextConvertValue * this._characterSetSizeN)) + s;
-          convertValue = nextConvertValue;
-        }
-        s = this.character(exclusion === 1 /* FirstZero */ ? Number(convertValue % this._characterSetSizeMinusOneN) + 1 : Number(convertValue % this._characterSetSizeN)) + s;
-      }
-      return creatorCallback === void 0 ? s : creatorCallback(s, index);
-    });
-  }
-  /**
-   * Determine the value for a string.
-   *
-   * @param s
-   * String.
-   *
-   * @param exclusion
-   * Strings excluded from the range of inputs. See {@link Exclusion} 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, exclusion = 0 /* None */, tweak) {
-    const length = s.length;
-    this.validateLength(length);
-    this.validateExclusion(exclusion);
-    const characterSetSizeN = BigInt(this.characterSetSize);
-    let value = this.characterIndexes(s).reduce((accumulator, characterIndex, index) => {
-      if (characterIndex === void 0) {
-        throw new RangeError(i18nextUtility.t("CharacterSetValidator.invalidCharacterAtPosition", {
-          c: s.charAt(index),
-          position: index + 1
-        }));
-      }
-      let value2;
-      if (index === 0 && exclusion === 1 /* FirstZero */) {
-        if (characterIndex === 0) {
-          throw new RangeError(i18nextUtility.t("CharacterSetValidator.invalidCharacterAtPosition", {
-            c: "0",
-            position: 1
-          }));
-        }
-        value2 = BigInt(characterIndex - 1);
-      } else {
-        value2 = accumulator * characterSetSizeN + BigInt(characterIndex);
-      }
-      return value2;
-    }, 0n);
-    if (exclusion === 2 /* AllNumeric */) {
-      const allZerosValue = this._allZerosValues[length];
-      if (value >= allZerosValue) {
-        value -= this.allNumericShift(false, length, value - allZerosValue);
-      }
-    }
-    return Transformer.get(this._exclusionDomains[exclusion][length], tweak).reverse(value);
-  }
-};
-var NUMERIC_CREATOR = new CharacterSetCreator([
-  "0",
-  "1",
-  "2",
-  "3",
-  "4",
-  "5",
-  "6",
-  "7",
-  "8",
-  "9"
-], 1 /* FirstZero */);
-var HEXADECIMAL_CREATOR = new CharacterSetCreator([
-  "0",
-  "1",
-  "2",
-  "3",
-  "4",
-  "5",
-  "6",
-  "7",
-  "8",
-  "9",
-  "A",
-  "B",
-  "C",
-  "D",
-  "E",
-  "F"
-], 1 /* FirstZero */, 2 /* AllNumeric */);
-var ALPHABETIC_CREATOR = new CharacterSetCreator([
-  "A",
-  "B",
-  "C",
-  "D",
-  "E",
-  "F",
-  "G",
-  "H",
-  "I",
-  "J",
-  "K",
-  "L",
-  "M",
-  "N",
-  "O",
-  "P",
-  "Q",
-  "R",
-  "S",
-  "T",
-  "U",
-  "V",
-  "W",
-  "X",
-  "Y",
-  "Z"
-]);
-var ALPHANUMERIC_CREATOR = new CharacterSetCreator([
-  "0",
-  "1",
-  "2",
-  "3",
-  "4",
-  "5",
-  "6",
-  "7",
-  "8",
-  "9",
-  "A",
-  "B",
-  "C",
-  "D",
-  "E",
-  "F",
-  "G",
-  "H",
-  "I",
-  "J",
-  "K",
-  "L",
-  "M",
-  "N",
-  "O",
-  "P",
-  "Q",
-  "R",
-  "S",
-  "T",
-  "U",
-  "V",
-  "W",
-  "X",
-  "Y",
-  "Z"
-], 1 /* FirstZero */, 2 /* AllNumeric */);
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  ALPHABETIC_CREATOR,
-  ALPHANUMERIC_CREATOR,
-  CharacterSetCreator,
-  CharacterSetValidator,
-  EncryptionTransformer,
-  Exclusion,
-  HEXADECIMAL_CREATOR,
-  IdentityTransformer,
-  NUMERIC_CREATOR,
-  RecordValidator,
-  RegExpValidator,
-  Sequence,
-  Transformer,
-  i18nUtilityInit,
-  i18nextUtility,
-  transformIterable,
-  utilityNS,
-  utilityResources
-});
+"use strict";var R=Object.create;var y=Object.defineProperty;var C=Object.getOwnPropertyDescriptor;var q=Object.getOwnPropertyNames;var U=Object.getPrototypeOf,G=Object.prototype.hasOwnProperty;var F=(i,e)=>{for(var t in e)y(i,t,{get:e[t],enumerable:!0})},A=(i,e,t,r)=>{if(e&&typeof e=="object"||typeof e=="function")for(let n of q(e))!G.call(i,n)&&n!==t&&y(i,n,{get:()=>e[n],enumerable:!(r=C(e,n))||r.enumerable});return i};var Z=(i,e,t)=>(t=i!=null?R(U(i)):{},A(e||!i||!i.__esModule?y(t,"default",{value:i,enumerable:!0}):t,i)),D=i=>A(y({},"__esModule",{value:!0}),i);var j={};F(j,{ALPHABETIC_CREATOR:()=>H,ALPHANUMERIC_CREATOR:()=>X,CharacterSetCreator:()=>f,CharacterSetValidator:()=>M,EncryptionTransformer:()=>N,Exclusion:()=>L,HEXADECIMAL_CREATOR:()=>k,IdentityTransformer:()=>S,NUMERIC_CREATOR:()=>z,RecordValidator:()=>w,RegExpValidator:()=>x,Sequence:()=>T,Transformer:()=>g,i18nUtilityInit:()=>P,i18nextUtility:()=>u,transformIterable:()=>b,utilityNS:()=>V,utilityResources:()=>O});module.exports=D(j);var E=require("@aidc-toolkit/core"),B=Z(require("i18next"),1);var _={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}}",minimumValueMustBeGreaterThanOrEqualToZero:"Minimum value {{minimumValue}} must be greater than or equal to 0",maximumValueMustBeLessThan:"Maximum value {{maximumValue}} 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'}};var v={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}}",minimumValueMustBeGreaterThanOrEqualToZero:"La valeur minimale {{minimumValue}} doit \xEAtre sup\xE9rieure ou \xE9gale \xE0 0",maximumValueMustBeLessThan:"La valeur maximale {{maximumValue}} 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'}};var V="aidct_utility";(0,E.i18nAssertValidResources)(_,"fr",v);var O={en:{aidct_utility:_},fr:{aidct_utility:v}},u=B.default.createInstance();async function P(i,e=!1){await(0,E.i18nCoreInit)(u,i,e,V,O)}var T=class{_startValue;_endValue;_count;_nextDelta;_minimumValue;_maximumValue;constructor(e,t){this._startValue=BigInt(e),this._endValue=this._startValue+BigInt(t),this._count=t,t>=0?(this._nextDelta=1n,this._minimumValue=this._startValue,this._maximumValue=this._endValue-1n):(this._nextDelta=-1n,this._minimumValue=this._endValue+1n,this._maximumValue=this._startValue)}get startValue(){return this._startValue}get endValue(){return this._endValue}get count(){return this._count}get minimumValue(){return this._minimumValue}get maximumValue(){return this._maximumValue}*[Symbol.iterator](){for(let e=this._startValue;e!==this._endValue;e+=this._nextDelta)yield e}};function b(i,e){return{*[Symbol.iterator](){let t=0;for(let r of i)yield e(r,t++)}}}var g=class i{static TRANSFORMER_MAPS_MAP=new Map;_domain;constructor(e){if(this._domain=BigInt(e),this._domain<=0n)throw new RangeError(u.t("Transformer.domainMustBeGreaterThanZero",{domain:e}))}static get(e,t){let r=BigInt(e),n=i.TRANSFORMER_MAPS_MAP.get(r);n===void 0&&(n=new Map,i.TRANSFORMER_MAPS_MAP.set(r,n));let a=t===void 0?void 0:BigInt(t),o=n.get(a);return o===void 0&&(o=a===void 0?new S(r):new N(r,a),n.set(a,o)),o}get domain(){return this._domain}validate(e){if(e<0n)throw new RangeError(u.t("Transformer.valueMustBeGreaterThanOrEqualToZero",{value:e}));if(e>=this.domain)throw new RangeError(u.t("Transformer.valueMustBeLessThan",{value:e,domain:this.domain}))}validateDoForward(e){let t=BigInt(e);return this.validate(t),this.doForward(t)}validateDoForwardCallback(e,t,r){return e(this.validateDoForward(t),r)}forward(e,t){let r;if(typeof e!="object")r=t===void 0?this.validateDoForward(e):this.validateDoForwardCallback(t,e,0);else if(e instanceof T){if(e.minimumValue<0n)throw new RangeError(u.t("Transformer.minimumValueMustBeGreaterThanOrEqualToZero",{minimumValue:e.minimumValue}));if(e.maximumValue>=this.domain)throw new RangeError(u.t("Transformer.maximumValueMustBeLessThan",{maximumValue:e.maximumValue,domain:this.domain}));r=t===void 0?b(e,n=>this.doForward(n)):b(e,(n,a)=>t(this.doForward(n),a))}else r=t===void 0?b(e,n=>this.validateDoForward(n)):b(e,(n,a)=>this.validateDoForwardCallback(t,n,a));return r}reverse(e){let t=BigInt(e);return this.validate(t),this.doReverse(t)}},S=class extends g{doForward(e){return e}doReverse(e){return e}},N=class i extends g{static BITS=new Uint8Array([1,2,4,8,16,32,64,128]);static INVERSE_BITS=new Uint8Array([254,253,251,247,239,223,191,127]);_domainBytes;_xorBytes;_bits;_inverseBits;_rounds;constructor(e,t){if(super(e),t<0n)throw new RangeError(u.t("Transformer.tweakMustBeGreaterThanOrEqualToZero",{tweak:t}));let r=0;for(let s=this.domain-1n;s!==0n;s>>=8n)r++;this._domainBytes=r;let n=new Array,a=new Array,o=new Array;for(let s=this.domain*BigInt(t)*603868999n;s!==0n;s>>=8n){n.unshift(Number(BigInt.asUintN(8,s)));let l=Number(BigInt.asUintN(3,s));a.push(i.BITS[l]),o.push(i.INVERSE_BITS[l])}if(r===1){let s=i.BITS.filter(l=>l<e).reduce((l,h)=>l|h,0);this._xorBytes=new Uint8Array([n.reduce((l,h)=>l^h,0)&s]),this._bits=new Uint8Array([i.BITS[0]]),this._inverseBits=new Uint8Array([i.INVERSE_BITS[0]]),this._rounds=1}else this._xorBytes=new Uint8Array(n),this._bits=new Uint8Array(a),this._inverseBits=new Uint8Array(o),this._rounds=n.length}valueToBytes(e){let t=new Uint8Array(this._domainBytes);for(let r=this._domainBytes-1,n=e;r>=0&&n!==0n;r--,n>>=8n)t[r]=Number(BigInt.asUintN(8,n));return t}static bytesToValue(e){return e.reduce((t,r)=>t<<8n|BigInt(r),0n)}shuffle(e,t,r){let n=e.length,a=new Uint8Array(n),o=new Array,s=new Array,l=this._bits[t];e.forEach((m,c)=>{let p=m&l;a[c]=p,(p!==0?o:s).push(c)});let h=this._inverseBits[t],d=new Uint8Array(n);return[...o,...s].forEach((m,c)=>{r?d[c]=e[m]&h|a[c]:d[m]=e[c]&h|a[m]}),d}xor(e,t,r){let n=this._xorBytes[t];return e.map(a=>{let o=a^n;return n=r?o:a,o})}doForward(e){let t=this.valueToBytes(e),r;do{for(let n=0;n<this._rounds;n++)t=this.xor(this.shuffle(t,n,!0),n,!0);r=i.bytesToValue(t)}while(r>=this.domain);return r}doReverse(e){let t=this.valueToBytes(e),r;do{for(let n=this._rounds-1;n>=0;n--)t=this.shuffle(this.xor(t,n,!1),n,!1);r=i.bytesToValue(t)}while(r>=this.domain);return r}};var x=class{_regExp;constructor(e){this._regExp=e}get regExp(){return this._regExp}createErrorMessage(e){return u.t("RegExpValidator.stringDoesNotMatchPattern",{s:e})}validate(e){if(!this._regExp.test(e))throw new RangeError(this.createErrorMessage(e))}};var w=class{_typeName;_record;constructor(e,t){this._typeName=e,this._record=t}get typeName(){return this._typeName}get record(){return this._record}validate(e){if(!(e in this.record))throw new RangeError(u.t("RecordValidator.typeNameKeyNotFound",{typeName:this.typeName,key:e}))}};var L=(r=>(r[r.None=0]="None",r[r.FirstZero=1]="FirstZero",r[r.AllNumeric=2]="AllNumeric",r))(L||{}),M=class i{static NOT_ALL_NUMERIC_VALIDATOR=new class extends x{createErrorMessage(e){return u.t("CharacterSetValidator.stringMustNotBeAllNumeric")}}(/\D/);_characterSet;_characterSetMap;_exclusionSupport;constructor(e,...t){this._characterSet=e;let r=new Map;e.forEach((n,a)=>{r.set(n,a)}),this._characterSetMap=r,this._exclusionSupport=t}get characterSet(){return this._characterSet}get characterSetSize(){return this._characterSet.length}get exclusionSupport(){return this._exclusionSupport}character(e){return this._characterSet[e]}characterIndex(e){return this._characterSetMap.get(e)}characterIndexes(e){return Array.from(e).map(t=>this._characterSetMap.get(t))}static componentToString(e){return typeof e=="function"?e():e}validateExclusion(e){if(e!==0&&!this._exclusionSupport.includes(e))throw new RangeError(u.t("CharacterSetValidator.exclusionNotSupported",{exclusion:e}))}validate(e,t){let r=e.length,n=t?.minimumLength,a=t?.maximumLength;if(n!==void 0&&r<n){let s;throw a!==void 0&&a===n?s=u.t(t?.component===void 0?"CharacterSetValidator.lengthMustBeEqualTo":"CharacterSetValidator.lengthOfComponentMustBeEqualTo",{component:i.componentToString(t?.component),length:r,exactLength:n}):s=u.t(t?.component===void 0?"CharacterSetValidator.lengthMustBeGreaterThanOrEqualTo":"CharacterSetValidator.lengthOfComponentMustBeGreaterThanOrEqualTo",{component:i.componentToString(t?.component),length:r,minimumLength:n}),new RangeError(s)}if(a!==void 0&&r>a)throw new RangeError(u.t(t?.component===void 0?"CharacterSetValidator.lengthMustBeLessThanOrEqualTo":"CharacterSetValidator.lengthOfComponentMustBeLessThanOrEqualTo",{component:i.componentToString(t?.component),length:r,maximumLength:a}));let o=this.characterIndexes(e).findIndex(s=>s===void 0);if(o!==-1)throw new RangeError(u.t(t?.component===void 0?"CharacterSetValidator.invalidCharacterAtPosition":"CharacterSetValidator.invalidCharacterAtPositionOfComponent",{component:i.componentToString(t?.component),c:e.charAt(o),position:o+(t?.positionOffset??0)+1}));if(t?.exclusion!==void 0)switch(this.validateExclusion(t.exclusion),t.exclusion){case 0:break;case 1:if(e.startsWith("0"))throw new RangeError(u.t(t.component===void 0?"CharacterSetValidator.invalidCharacterAtPosition":"CharacterSetValidator.invalidCharacterAtPositionOfComponent",{component:i.componentToString(t.component),c:"0",position:(t.positionOffset??0)+1}));break;case 2:i.NOT_ALL_NUMERIC_VALIDATOR.validate(e);break}}},f=class i extends M{static MAXIMUM_STRING_LENGTH=40;static _powersOf10=i.createPowersOf(10);static createPowersOf(e){let t=new Array(this.MAXIMUM_STRING_LENGTH+1),r=BigInt(e);for(let n=0,a=1n;n<=this.MAXIMUM_STRING_LENGTH;n++,a*=r)t[n]=a;return t}static powerOf10(e){return this._powersOf10[e]}_characterSetSizeN;_characterSetSizeMinusOneN;_exclusionDomains;_allZerosValues;constructor(e,...t){super(e,...t),this._characterSetSizeN=BigInt(this.characterSetSize),this._characterSetSizeMinusOneN=BigInt(this.characterSetSize-1);let r=[],n=i.createPowersOf(this.characterSetSize);if(r[0]=n,t.includes(1)){if(e[0]!=="0")throw new RangeError(u.t("CharacterSetValidator.firstZeroFirstCharacter"));let o=new Array(i.MAXIMUM_STRING_LENGTH+1);o[0]=0n;for(let s=1;s<=i.MAXIMUM_STRING_LENGTH;s++)o[s]=this._characterSetSizeMinusOneN*n[s-1];r[1]=o}if(t.includes(2)){let s=function(c){let p=c[0];for(let I of c){if(I===void 0||I!==p)throw new RangeError(u.t("CharacterSetValidator.allNumericAllNumericCharacters"));p=I+1}};var a=s;let o=new Array(i.MAXIMUM_STRING_LENGTH+1),l=this.characterIndexes("0123456789");s(l);let h=BigInt(l[0]),d=new Array(i.MAXIMUM_STRING_LENGTH+1),m=0n;for(let c=0;c<=i.MAXIMUM_STRING_LENGTH;c++)o[c]=n[c]-i.powerOf10(c),d[c]=m,m=m*this._characterSetSizeN+h;this._allZerosValues=d,r[2]=o}else this._allZerosValues=[];this._exclusionDomains=r}powerOfSize(e){return this._exclusionDomains[0][e]}allNumericShift(e,t,r){let n;if(t===0){if(!e&&r<10n)throw new RangeError(u.t("CharacterSetValidator.stringMustNotBeAllNumeric"));n=10n}else{let a=this.powerOfSize(t),o=i.powerOf10(t),s=e?a-o:a,l=r/s;l>=10n?n=i.powerOf10(t+1):n=l*o+this.allNumericShift(e,t-1,r-l*s)}return n}validateLength(e){if(e<0)throw new RangeError(u.t("CharacterSetValidator.lengthMustBeGreaterThanOrEqualTo",{length:e,minimumLength:0}));if(e>i.MAXIMUM_STRING_LENGTH)throw new RangeError(u.t("CharacterSetValidator.lengthMustBeLessThanOrEqualTo",{length:e,maximumLength:i.MAXIMUM_STRING_LENGTH}))}create(e,t,r=0,n,a){this.validateLength(e),this.validateExclusion(r);let o=r===2?this._allZerosValues[e]:0n;return g.get(this._exclusionDomains[r][e],n).forward(t,(l,h)=>{let d="";if(e!==0){let m=l;r===2&&m>=o&&(m=m+this.allNumericShift(!0,e,m-o));for(let c=e-1;c>0;c--){let p=m/this._characterSetSizeN;d=this.character(Number(m-p*this._characterSetSizeN))+d,m=p}d=this.character(r===1?Number(m%this._characterSetSizeMinusOneN)+1:Number(m%this._characterSetSizeN))+d}return a===void 0?d:a(d,h)})}valueFor(e,t=0,r){let n=e.length;this.validateLength(n),this.validateExclusion(t);let a=BigInt(this.characterSetSize),o=this.characterIndexes(e).reduce((s,l,h)=>{if(l===void 0)throw new RangeError(u.t("CharacterSetValidator.invalidCharacterAtPosition",{c:e.charAt(h),position:h+1}));let d;if(h===0&&t===1){if(l===0)throw new RangeError(u.t("CharacterSetValidator.invalidCharacterAtPosition",{c:"0",position:1}));d=BigInt(l-1)}else d=s*a+BigInt(l);return d},0n);if(t===2){let s=this._allZerosValues[n];o>=s&&(o-=this.allNumericShift(!1,n,o-s))}return g.get(this._exclusionDomains[t][n],r).reverse(o)}},z=new f(["0","1","2","3","4","5","6","7","8","9"],1),k=new f(["0","1","2","3","4","5","6","7","8","9","A","B","C","D","E","F"],1,2),H=new f(["A","B","C","D","E","F","G","H","I","J","K","L","M","N","O","P","Q","R","S","T","U","V","W","X","Y","Z"]),X=new f(["0","1","2","3","4","5","6","7","8","9","A","B","C","D","E","F","G","H","I","J","K","L","M","N","O","P","Q","R","S","T","U","V","W","X","Y","Z"],1,2);0&&(module.exports={ALPHABETIC_CREATOR,ALPHANUMERIC_CREATOR,CharacterSetCreator,CharacterSetValidator,EncryptionTransformer,Exclusion,HEXADECIMAL_CREATOR,IdentityTransformer,NUMERIC_CREATOR,RecordValidator,RegExpValidator,Sequence,Transformer,i18nUtilityInit,i18nextUtility,transformIterable,utilityNS,utilityResources});
 /*!
  * Copyright © 2024-2025 Dolphin Data Development Ltd. and AIDC Toolkit
  * contributors