@aidc-toolkit/utility 0.9.7-beta → 0.9.9-beta

package/dist/index.js

@@ -1,15 +1,16 @@
 // src/locale/i18n.ts
-import { i18nAddResourceBundle, i18nAssertValidResources, i18next } from "@aidc-toolkit/core";
+import { i18nAssertValidResources, i18nCoreInit } from "@aidc-toolkit/core";
+import i18next from "i18next";
 
-// src/locale/en/locale_strings.ts
+// src/locale/en/locale-strings.ts
 var localeStrings = {
   Transformer: {
     domainMustBeGreaterThanZero: "Domain {{domain}} must be greater than 0",
     tweakMustBeGreaterThanOrEqualToZero: "Tweak {{tweak}} must be greater than or equal to 0",
     valueMustBeGreaterThanOrEqualToZero: "Value {{value}} must be greater than or equal to 0",
     valueMustBeLessThan: "Value {{value}} must be less than {{domain}}",
-    minValueMustBeGreaterThanOrEqualToZero: "Minimum value {{minValue}} must be greater than or equal to 0",
-    maxValueMustBeLessThan: "Maximum value {{maxValue}} must be less than {{domain}}"
+    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"
@@ -35,15 +36,15 @@ var localeStrings = {
   }
 };
 
-// src/locale/fr/locale_strings.ts
+// src/locale/fr/locale-strings.ts
 var localeStrings2 = {
   Transformer: {
     domainMustBeGreaterThanZero: "Le domaine {{domain}} doit \xEAtre sup\xE9rieur \xE0 0",
     tweakMustBeGreaterThanOrEqualToZero: "Le r\xE9glage {{tweak}} doit \xEAtre sup\xE9rieur ou \xE9gal \xE0 0",
     valueMustBeGreaterThanOrEqualToZero: "La valeur {{value}} doit \xEAtre sup\xE9rieure ou \xE9gale \xE0 0",
     valueMustBeLessThan: "La valeur {{value}} doit \xEAtre inf\xE9rieure \xE0 {{domain}}",
-    minValueMustBeGreaterThanOrEqualToZero: "La valeur minimale {{minValue}} doit \xEAtre sup\xE9rieure ou \xE9gale \xE0 0",
-    maxValueMustBeLessThan: "La valeur maximale {{maxValue}} doit \xEAtre inf\xE9rieure \xE0 {{domain}}"
+    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"
@@ -72,389 +73,21 @@ var localeStrings2 = {
 // src/locale/i18n.ts
 var utilityNS = "aidct_utility";
 i18nAssertValidResources(localeStrings, "fr", localeStrings2);
-i18nAddResourceBundle("en", utilityNS, localeStrings);
-i18nAddResourceBundle("fr", utilityNS, localeStrings2);
-var i18n_default = i18next;
-
-// src/iterator_proxy.ts
-var IteratorProxyBase = class _IteratorProxyBase {
-  /**
-   * Convert an iteration source to an iterable.
-   *
-   * @param iterationSource
-   * Iteration source.
-   *
-   * @returns
-   * Iteration source if it is already an iterable, otherwise iteration source wrapped in an iterable.
-   */
-  static toIterable(iterationSource) {
-    return Symbol.iterator in iterationSource ? iterationSource : {
-      [Symbol.iterator]() {
-        return iterationSource;
-      }
-    };
-  }
-  /**
-   * Initial iterable.
-   */
-  _initialIterable;
-  /**
-   * Initial iterator.
-   */
-  _initialIterator;
-  /**
-   * Constructor.
-   *
-   * @param initialIterationSource
-   * Initial iteration source.
-   */
-  constructor(initialIterationSource) {
-    this._initialIterable = _IteratorProxyBase.toIterable(initialIterationSource);
-  }
-  /**
-   * Get the initial iterable.
-   */
-  get initialIterable() {
-    return this._initialIterable;
-  }
-  /**
-   * Get the initial iterator.
-   */
-  get initialIterator() {
-    if (this._initialIterator === void 0) {
-      this._initialIterator = this.initialIterable[Symbol.iterator]();
-    }
-    return this._initialIterator;
-  }
-  /**
-   * @inheritDoc
-   */
-  get [Symbol.toStringTag]() {
-    return "IteratorProxy";
-  }
-  /**
-   * @inheritDoc
-   */
-  [Symbol.dispose]() {
-  }
-  /**
-   * @inheritDoc
-   */
-  [Symbol.iterator]() {
-    return this;
-  }
-  /**
-   * Get the next result from the initial iterator.
-   *
-   * @param value
-   * Tuple value to be passed to Iterator.next().
-   *
-   * @returns
-   * Next result from the initial iterator.
-   */
-  initialNext(...value) {
-    return this.initialIterator.next(...value);
-  }
-  /**
-   * @inheritDoc
-   */
-  map(callback) {
-    return new IteratorMapProxy(this, callback);
-  }
-  /**
-   * @inheritDoc
-   */
-  flatMap(callback) {
-    return new IteratorFlatMapProxy(this, callback);
-  }
-  /**
-   * @inheritDoc
-   */
-  filter(predicate) {
-    return new IteratorFilterProxy(this, predicate, true);
-  }
-  /**
-   * @inheritDoc
-   */
-  take(limit) {
-    return new IteratorTakeProxy(this, limit);
-  }
-  /**
-   * @inheritDoc
-   */
-  drop(count) {
-    return new IteratorDropProxy(this, count);
-  }
-  /**
-   * @inheritDoc
-   */
-  reduce(callback, initialValue) {
-    let index = 0;
-    let result = initialValue;
-    for (const value of this) {
-      if (index === 0 && arguments.length === 1) {
-        result = value;
-      } else {
-        result = callback(result, value, index);
-      }
-      index++;
-    }
-    if (index === 0 && arguments.length === 1) {
-      throw new Error("reduce() of empty iterator with no initial value");
-    }
-    return result;
-  }
-  /**
-   * @inheritDoc
-   */
-  toArray() {
-    return Array.from(this);
-  }
-  /**
-   * @inheritDoc
-   */
-  forEach(callback) {
-    let index = 0;
-    for (const element of this) {
-      callback(element, index++);
-    }
-  }
-  /**
-   * @inheritDoc
-   */
-  some(predicate) {
-    return new IteratorFilterProxy(this, predicate, true).next().done !== true;
-  }
-  /**
-   * @inheritDoc
-   */
-  every(predicate) {
-    return new IteratorFilterProxy(this, predicate, false).next().done === true;
-  }
-  /**
-   * @inheritDoc
-   */
-  find(predicate) {
-    return new IteratorFilterProxy(this, predicate, true).next().value;
-  }
-};
-var IteratorProxyObject = class extends IteratorProxyBase {
-  /**
-   * @inheritDoc
-   */
-  next(...value) {
-    return this.initialNext(...value);
-  }
-};
-var IteratorMapProxyBase = class extends IteratorProxyBase {
-  /**
-   * Callback.
-   */
-  _callback;
-  /**
-   * Index into initial iteration source.
-   */
-  _index;
-  /**
-   * Constructor.
-   *
-   * @param initialIterationSource
-   * Initial iteration source.
-   *
-   * @param callback
-   * Callback.
-   */
-  constructor(initialIterationSource, callback) {
-    super(initialIterationSource);
-    this._callback = callback;
-    this._index = 0;
-  }
-  /**
-   * Get the next result from the intermediate iterator.
-   *
-   * @param value
-   * Tuple value to be passed to Iterator.next().
-   *
-   * @returns
-   * Next result from the intermediate iterator.
-   */
-  intermediateNext(...value) {
-    const initialResult = this.initialNext(...value);
-    return initialResult.done !== true ? {
-      value: this._callback(initialResult.value, this._index++)
-    } : {
-      done: true,
-      value: void 0
-    };
-  }
-};
-var IteratorMapProxy = class extends IteratorMapProxyBase {
-  /**
-   * @inheritDoc
-   */
-  next(...value) {
-    return this.intermediateNext(...value);
-  }
-};
-var IteratorFlatMapProxy = class extends IteratorMapProxyBase {
-  _intermediateIterator;
-  /**
-   * @inheritDoc
-   */
-  next(...value) {
-    let finalResult = void 0;
-    do {
-      if (this._intermediateIterator === void 0) {
-        const intermediateResult = this.intermediateNext(...value);
-        if (intermediateResult.done === true) {
-          finalResult = intermediateResult;
-        } else {
-          this._intermediateIterator = IteratorProxyBase.toIterable(intermediateResult.value)[Symbol.iterator]();
-        }
-      } else {
-        const pendingFinalResult = this._intermediateIterator.next();
-        if (pendingFinalResult.done === true) {
-          this._intermediateIterator = void 0;
-        } else {
-          finalResult = pendingFinalResult;
-        }
-      }
-    } while (finalResult === void 0);
-    return finalResult;
-  }
-};
-var IteratorFilterProxy = class extends IteratorProxyBase {
-  /**
-   * Predicate.
-   */
-  _predicate;
-  /**
-   * Expected truthy result of the predicate.
-   */
-  _expectedTruthy;
-  /**
-   * Index into iteration source.
-   */
-  _index;
-  /**
-   * Constructor.
-   *
-   * @param iterationSource
-   * Iteration source.
-   *
-   * @param predicate
-   * Predicate.
-   *
-   * @param expectedTruthy
-   * Expected truthy result of the predicate.
-   */
-  constructor(iterationSource, predicate, expectedTruthy) {
-    super(iterationSource);
-    this._predicate = predicate;
-    this._expectedTruthy = expectedTruthy;
-    this._index = 0;
-  }
-  /**
-   * @inheritDoc
-   */
-  next(...value) {
-    let result;
-    const expectedTruthy = this._expectedTruthy;
-    do {
-      result = this.initialNext(...value);
-    } while (result.done !== true && Boolean(this._predicate(result.value, this._index++)) !== expectedTruthy);
-    return result;
-  }
-};
-var IteratorCountProxyBase = class extends IteratorProxyObject {
-  /**
-   * Count.
-   */
-  _count;
-  /**
-   * Constructor.
-   *
-   * @param initialIterationSource
-   * Initial iteration source.
-   *
-   * @param count
-   * Count.
-   */
-  constructor(initialIterationSource, count) {
-    super(initialIterationSource);
-    if (!Number.isInteger(count) || count < 0) {
-      throw new RangeError("Count must be a positive integer");
-    }
-    this._count = count;
-  }
-  /**
-   * Determine if iterator is exhausted (by count or by iterator itself).
-   */
-  get exhausted() {
-    return this._count <= 0;
-  }
-  /**
-   * @inheritDoc
-   */
-  next(...value) {
-    const result = super.next(...value);
-    if (result.done !== true) {
-      this._count--;
-    } else {
-      this._count = 0;
-    }
-    return result;
-  }
-};
-var IteratorTakeProxy = class extends IteratorCountProxyBase {
-  /**
-   * @inheritDoc
-   */
-  next(...value) {
-    return !this.exhausted ? super.next(...value) : {
-      done: true,
-      value: void 0
-    };
-  }
-};
-var IteratorDropProxy = class extends IteratorCountProxyBase {
-  /**
-   * @inheritDoc
-   */
-  next(...value) {
-    while (!this.exhausted) {
-      super.next(...value);
-    }
-    return super.next(...value);
+var utilityResources = {
+  en: {
+    aidct_utility: localeStrings
+  },
+  fr: {
+    aidct_utility: localeStrings2
   }
 };
-function iteratorProxy() {
-  let supported;
-  try {
-    supported = process.env["NODE_ENV"] !== "test";
-  } catch (_e) {
-    supported = true;
-  }
-  if (supported) {
-    try {
-      Iterator.from([]);
-    } catch (_e) {
-      supported = false;
-    }
-  }
-  return supported ? Iterator : {
-    /**
-     * @inheritDoc
-     */
-    from(value) {
-      return value instanceof IteratorProxyBase ? value : new IteratorProxyObject(value);
-    }
-  };
+var i18nextUtility = i18next.createInstance();
+async function i18nUtilityInit(environment, debug = false) {
+  await i18nCoreInit(i18nextUtility, environment, debug, utilityNS, utilityResources);
 }
-var IteratorProxy = iteratorProxy();
 
-// src/sequencer.ts
-var Sequencer = class {
+// src/sequence.ts
+var Sequence = class {
   /**
    * Start value (inclusive).
    */
@@ -474,15 +107,11 @@ var Sequencer = class {
   /**
    * Minimum value (inclusive).
    */
-  _minValue;
+  _minimumValue;
   /**
    * Maximum value (inclusive).
    */
-  _maxValue;
-  /**
-   * Next value.
-   */
-  _nextValue;
+  _maximumValue;
   /**
    * Constructor.
    *
@@ -497,17 +126,15 @@ var Sequencer = class {
     this._startValue = BigInt(startValue);
     this._endValue = this._startValue + BigInt(count);
     this._count = count;
-    const ascending = count >= 0;
-    if (ascending) {
+    if (count >= 0) {
       this._nextDelta = 1n;
-      this._minValue = this._startValue;
-      this._maxValue = this._endValue - 1n;
+      this._minimumValue = this._startValue;
+      this._maximumValue = this._endValue - 1n;
     } else {
       this._nextDelta = -1n;
-      this._minValue = this._endValue + 1n;
-      this._maxValue = this._startValue;
+      this._minimumValue = this._endValue + 1n;
+      this._maximumValue = this._startValue;
     }
-    this._nextValue = this._startValue;
   }
   /**
    * Get the start value (inclusive).
@@ -530,55 +157,45 @@ var Sequencer = class {
   /**
    * Get the minimum value (inclusive).
    */
-  get minValue() {
-    return this._minValue;
+  get minimumValue() {
+    return this._minimumValue;
   }
   /**
    * Get the maximum value (inclusive).
    */
-  get maxValue() {
-    return this._maxValue;
+  get maximumValue() {
+    return this._maximumValue;
   }
   /**
    * Iterable implementation.
    *
-   * @returns
-   * this
-   */
-  [Symbol.iterator]() {
-    return this;
-  }
-  /**
-   * Iterator implementation.
-   *
-   * @returns
-   * Iterator result. If iterator is exhausted, the value is absolute value of the count.
+   * @yields
+   * Next value in sequence.
    */
-  next() {
-    const done = this._nextValue === this._endValue;
-    let result;
-    if (!done) {
-      result = {
-        value: this._nextValue
-      };
-      this._nextValue += this._nextDelta;
-    } else {
-      result = {
-        done: true,
-        value: Math.abs(this._count)
-      };
+  *[Symbol.iterator]() {
+    for (let value = this._startValue; value !== this._endValue; value += this._nextDelta) {
+      yield value;
     }
-    return result;
-  }
-  /**
-   * Reset the iterator.
-   */
-  reset() {
-    this._nextValue = this._startValue;
   }
 };
 
 // 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.
@@ -597,8 +214,7 @@ var Transformer = class _Transformer {
   constructor(domain) {
     this._domain = BigInt(domain);
     if (this._domain <= 0n) {
-      throw new RangeError(i18n_default.t("Transformer.domainMustBeGreaterThanZero", {
-        ns: utilityNS,
+      throw new RangeError(i18nextUtility.t("Transformer.domainMustBeGreaterThanZero", {
         domain
       }));
     }
@@ -647,52 +263,69 @@ var Transformer = class _Transformer {
    */
   validate(value) {
     if (value < 0n) {
-      throw new RangeError(i18n_default.t("Transformer.valueMustBeGreaterThanOrEqualToZero", {
-        ns: utilityNS,
+      throw new RangeError(i18nextUtility.t("Transformer.valueMustBeGreaterThanOrEqualToZero", {
         value
       }));
     }
     if (value >= this.domain) {
-      throw new RangeError(i18n_default.t("Transformer.valueMustBeLessThan", {
-        ns: utilityNS,
+      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") {
-      const valueN = BigInt(valueOrValues);
-      this.validate(valueN);
-      const transformedValue = this.doForward(valueN);
-      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", {
-          ns: utilityNS,
-          minValue: valueOrValues.minValue
+      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.maxValue >= this.domain) {
-        throw new RangeError(i18n_default.t("Transformer.maxValueMustBeLessThan", {
-          ns: utilityNS,
-          maxValue: valueOrValues.maxValue,
+      if (valueOrValues.maximumValue >= this.domain) {
+        throw new RangeError(i18nextUtility.t("Transformer.maximumValueMustBeLessThan", {
+          maximumValue: valueOrValues.maximumValue,
           domain: this.domain
         }));
       }
-      result = transformerCallback === void 0 ? IteratorProxy.from(valueOrValues).map((value) => this.doForward(value)) : IteratorProxy.from(valueOrValues).map((value, index) => transformerCallback(this.doForward(value), index));
+      result = transformerCallback === void 0 ? transformIterable(valueOrValues, (value) => this.doForward(value)) : transformIterable(valueOrValues, (value, index) => transformerCallback(this.doForward(value), index));
     } else {
-      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 transformerCallback(this.doForward(valueN), index);
-      });
+      result = transformerCallback === void 0 ? transformIterable(valueOrValues, (value) => this.validateDoForward(value)) : transformIterable(valueOrValues, (value, index) => this.validateDoForwardCallback(transformerCallback, value, index));
     }
     return result;
   }
@@ -756,10 +389,6 @@ var EncryptionTransformer = class _EncryptionTransformer extends Transformer {
    * Number of bytes covered by the domain.
    */
   _domainBytes;
-  /**
-   * Tweak.
-   */
-  _tweak;
   /**
    * Xor bytes array generated from the domain and tweak.
    */
@@ -788,24 +417,21 @@ var EncryptionTransformer = class _EncryptionTransformer extends Transformer {
   constructor(domain, tweak) {
     super(domain);
     if (tweak < 0n) {
-      throw new RangeError(i18n_default.t("Transformer.tweakMustBeGreaterThanOrEqualToZero", {
-        ns: utilityNS,
+      throw new RangeError(i18nextUtility.t("Transformer.tweakMustBeGreaterThanOrEqualToZero", {
         tweak
       }));
     }
     let domainBytes = 0;
-    for (let reducedDomainMinusOne = this.domain - 1n; reducedDomainMinusOne !== 0n; reducedDomainMinusOne = reducedDomainMinusOne >> 8n) {
+    for (let reducedDomainMinusOne = this.domain - 1n; reducedDomainMinusOne !== 0n; reducedDomainMinusOne >>= 8n) {
       domainBytes++;
     }
     this._domainBytes = domainBytes;
-    this._tweak = BigInt(tweak);
     const xorBytes = new Array();
     const bits = new Array();
     const inverseBits = new Array();
-    for (let reducedKey = this.domain * this.tweak * 603868999n; reducedKey !== 0n; reducedKey = reducedKey >> 8n) {
-      const keyByte = Number(reducedKey & 0xFFn);
-      xorBytes.unshift(keyByte);
-      const bitNumber = keyByte & 7;
+    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]);
     }
@@ -822,12 +448,6 @@ var EncryptionTransformer = class _EncryptionTransformer extends Transformer {
       this._rounds = xorBytes.length;
     }
   }
-  /**
-   * Get the tweak.
-   */
-  get tweak() {
-    return this._tweak;
-  }
   /**
    * Convert a value to a byte array big enough to handle the entire domain.
    *
@@ -839,10 +459,8 @@ var EncryptionTransformer = class _EncryptionTransformer extends Transformer {
    */
   valueToBytes(value) {
     const bytes = new Uint8Array(this._domainBytes);
-    let reducedValue = value;
-    for (let index = this._domainBytes - 1; index >= 0; index--) {
-      bytes[index] = Number(reducedValue & 0xFFn);
-      reducedValue = reducedValue >> 8n;
+    for (let index = this._domainBytes - 1, reducedValue = value; index >= 0 && reducedValue !== 0n; index--, reducedValue >>= 8n) {
+      bytes[index] = Number(BigInt.asUintN(8, reducedValue));
     }
     return bytes;
   }
@@ -980,7 +598,7 @@ var EncryptionTransformer = class _EncryptionTransformer extends Transformer {
   }
 };
 
-// src/reg_exp.ts
+// src/reg-exp.ts
 var RegExpValidator = class {
   /**
    * Regular expression.
@@ -1012,8 +630,7 @@ var RegExpValidator = class {
    * Error message.
    */
   createErrorMessage(s) {
-    return i18n_default.t("RegExpValidator.stringDoesNotMatchPattern", {
-      ns: utilityNS,
+    return i18nextUtility.t("RegExpValidator.stringDoesNotMatchPattern", {
       s
     });
   }
@@ -1069,9 +686,8 @@ var RecordValidator = class {
    * Record key.
    */
   validate(key) {
-    if (this.record[key] === void 0) {
-      throw new RangeError(i18n_default.t("RecordValidator.typeNameKeyNotFound", {
-        ns: utilityNS,
+    if (!(key in this.record)) {
+      throw new RangeError(i18nextUtility.t("RecordValidator.typeNameKeyNotFound", {
         typeName: this.typeName,
         key
       }));
@@ -1079,7 +695,7 @@ var RecordValidator = class {
   }
 };
 
-// src/character_set.ts
+// src/character-set.ts
 var Exclusion = /* @__PURE__ */ ((Exclusion2) => {
   Exclusion2[Exclusion2["None"] = 0] = "None";
   Exclusion2[Exclusion2["FirstZero"] = 1] = "FirstZero";
@@ -1098,9 +714,7 @@ var CharacterSetValidator = class _CharacterSetValidator {
      * Error message.
      */
     createErrorMessage(_s) {
-      return i18n_default.t("CharacterSetValidator.stringMustNotBeAllNumeric", {
-        ns: utilityNS
-      });
+      return i18nextUtility.t("CharacterSetValidator.stringMustNotBeAllNumeric");
     }
   }(/\D/);
   /**
@@ -1210,8 +824,7 @@ var CharacterSetValidator = class _CharacterSetValidator {
    */
   validateExclusion(exclusion) {
     if (exclusion !== 0 /* None */ && !this._exclusionSupport.includes(exclusion)) {
-      throw new RangeError(i18n_default.t("CharacterSetValidator.exclusionNotSupported", {
-        ns: utilityNS,
+      throw new RangeError(i18nextUtility.t("CharacterSetValidator.exclusionNotSupported", {
         exclusion
       }));
     }
@@ -1233,15 +846,13 @@ var CharacterSetValidator = class _CharacterSetValidator {
     if (minimumLength !== void 0 && length < minimumLength) {
       let errorMessage;
       if (maximumLength !== void 0 && maximumLength === minimumLength) {
-        errorMessage = i18n_default.t(validation?.component === void 0 ? "CharacterSetValidator.lengthMustBeEqualTo" : "CharacterSetValidator.lengthOfComponentMustBeEqualTo", {
-          ns: utilityNS,
+        errorMessage = i18nextUtility.t(validation?.component === void 0 ? "CharacterSetValidator.lengthMustBeEqualTo" : "CharacterSetValidator.lengthOfComponentMustBeEqualTo", {
           component: _CharacterSetValidator.componentToString(validation?.component),
           length,
           exactLength: minimumLength
         });
       } else {
-        errorMessage = i18n_default.t(validation?.component === void 0 ? "CharacterSetValidator.lengthMustBeGreaterThanOrEqualTo" : "CharacterSetValidator.lengthOfComponentMustBeGreaterThanOrEqualTo", {
-          ns: utilityNS,
+        errorMessage = i18nextUtility.t(validation?.component === void 0 ? "CharacterSetValidator.lengthMustBeGreaterThanOrEqualTo" : "CharacterSetValidator.lengthOfComponentMustBeGreaterThanOrEqualTo", {
           component: _CharacterSetValidator.componentToString(validation?.component),
           length,
           minimumLength
@@ -1250,8 +861,7 @@ var CharacterSetValidator = class _CharacterSetValidator {
       throw new RangeError(errorMessage);
     }
     if (maximumLength !== void 0 && length > maximumLength) {
-      throw new RangeError(i18n_default.t(validation?.component === void 0 ? "CharacterSetValidator.lengthMustBeLessThanOrEqualTo" : "CharacterSetValidator.lengthOfComponentMustBeLessThanOrEqualTo", {
-        ns: utilityNS,
+      throw new RangeError(i18nextUtility.t(validation?.component === void 0 ? "CharacterSetValidator.lengthMustBeLessThanOrEqualTo" : "CharacterSetValidator.lengthOfComponentMustBeLessThanOrEqualTo", {
         component: _CharacterSetValidator.componentToString(validation?.component),
         length,
         maximumLength
@@ -1259,8 +869,7 @@ var CharacterSetValidator = class _CharacterSetValidator {
     }
     const index = this.characterIndexes(s).findIndex((characterIndex) => characterIndex === void 0);
     if (index !== -1) {
-      throw new RangeError(i18n_default.t(validation?.component === void 0 ? "CharacterSetValidator.invalidCharacterAtPosition" : "CharacterSetValidator.invalidCharacterAtPositionOfComponent", {
-        ns: utilityNS,
+      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
@@ -1273,8 +882,7 @@ var CharacterSetValidator = class _CharacterSetValidator {
           break;
         case 1 /* FirstZero */:
           if (s.startsWith("0")) {
-            throw new RangeError(i18n_default.t(validation.component === void 0 ? "CharacterSetValidator.invalidCharacterAtPosition" : "CharacterSetValidator.invalidCharacterAtPositionOfComponent", {
-              ns: utilityNS,
+            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
@@ -1361,9 +969,7 @@ var CharacterSetCreator = class _CharacterSetCreator extends CharacterSetValidat
     exclusionDomains[0 /* None */] = exclusionNoneDomains;
     if (exclusionSupport.includes(1 /* FirstZero */)) {
       if (characterSet[0] !== "0") {
-        throw new RangeError(i18n_default.t("CharacterSetValidator.firstZeroFirstCharacter", {
-          ns: utilityNS
-        }));
+        throw new RangeError(i18nextUtility.t("CharacterSetValidator.firstZeroFirstCharacter"));
       }
       const exclusionFirstZeroDomains = new Array(_CharacterSetCreator.MAXIMUM_STRING_LENGTH + 1);
       exclusionFirstZeroDomains[0] = 0n;
@@ -1377,9 +983,7 @@ var CharacterSetCreator = class _CharacterSetCreator extends CharacterSetValidat
         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
-            }));
+            throw new RangeError(i18nextUtility.t("CharacterSetValidator.allNumericAllNumericCharacters"));
           }
           expectedNumberIndex = numberIndex + 1;
         }
@@ -1434,9 +1038,7 @@ var CharacterSetCreator = class _CharacterSetCreator extends CharacterSetValidat
     let shift;
     if (length === 0) {
       if (!shiftForward && value < 10n) {
-        throw new RangeError(i18n_default.t("CharacterSetValidator.stringMustNotBeAllNumeric", {
-          ns: utilityNS
-        }));
+        throw new RangeError(i18nextUtility.t("CharacterSetValidator.stringMustNotBeAllNumeric"));
       }
       shift = 10n;
     } else {
@@ -1460,15 +1062,13 @@ var CharacterSetCreator = class _CharacterSetCreator extends CharacterSetValidat
    */
   validateLength(length) {
     if (length < 0) {
-      throw new RangeError(i18n_default.t("CharacterSetValidator.lengthMustBeGreaterThanOrEqualTo", {
-        ns: utilityNS,
+      throw new RangeError(i18nextUtility.t("CharacterSetValidator.lengthMustBeGreaterThanOrEqualTo", {
         length,
         minimumLength: 0
       }));
     }
     if (length > _CharacterSetCreator.MAXIMUM_STRING_LENGTH) {
-      throw new RangeError(i18n_default.t("CharacterSetValidator.lengthMustBeLessThanOrEqualTo", {
-        ns: utilityNS,
+      throw new RangeError(i18nextUtility.t("CharacterSetValidator.lengthMustBeLessThanOrEqualTo", {
         length,
         maximumLength: _CharacterSetCreator.MAXIMUM_STRING_LENGTH
       }));
@@ -1516,7 +1116,7 @@ var CharacterSetCreator = class _CharacterSetCreator extends CharacterSetValidat
         }
         s = this.character(exclusion === 1 /* FirstZero */ ? Number(convertValue % this._characterSetSizeMinusOneN) + 1 : Number(convertValue % this._characterSetSizeN)) + s;
       }
-      return creatorCallback !== void 0 ? creatorCallback(s, index) : s;
+      return creatorCallback === void 0 ? s : creatorCallback(s, index);
     });
   }
   /**
@@ -1542,8 +1142,7 @@ var CharacterSetCreator = class _CharacterSetCreator extends CharacterSetValidat
     const characterSetSizeN = BigInt(this.characterSetSize);
     let value = this.characterIndexes(s).reduce((accumulator, characterIndex, index) => {
       if (characterIndex === void 0) {
-        throw new RangeError(i18n_default.t("CharacterSetValidator.invalidCharacterAtPosition", {
-          ns: utilityNS,
+        throw new RangeError(i18nextUtility.t("CharacterSetValidator.invalidCharacterAtPosition", {
           c: s.charAt(index),
           position: index + 1
         }));
@@ -1551,8 +1150,7 @@ var CharacterSetCreator = class _CharacterSetCreator extends CharacterSetValidat
       let value2;
       if (index === 0 && exclusion === 1 /* FirstZero */) {
         if (characterIndex === 0) {
-          throw new RangeError(i18n_default.t("CharacterSetValidator.invalidCharacterAtPosition", {
-            ns: utilityNS,
+          throw new RangeError(i18nextUtility.t("CharacterSetValidator.invalidCharacterAtPosition", {
             c: "0",
             position: 1
           }));
@@ -1677,11 +1275,30 @@ export {
   Exclusion,
   HEXADECIMAL_CREATOR,
   IdentityTransformer,
-  IteratorProxy,
   NUMERIC_CREATOR,
   RecordValidator,
   RegExpValidator,
-  Sequencer,
+  Sequence,
   Transformer,
-  utilityNS
+  i18nUtilityInit,
+  i18nextUtility,
+  transformIterable,
+  utilityNS,
+  utilityResources
 };
+/*!
+ * Copyright © 2024-2025 Dolphin Data Development Ltd. and AIDC Toolkit
+ * contributors
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */