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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aidc-toolkit/utility",
-  "version": "0.9.7-beta",
+  "version": "0.9.8-beta",
   "description": "Foundational utilities for AIDC Toolkit",
   "type": "module",
   "main": "dist/index.js",
@@ -25,7 +25,7 @@
     "test": "vitest run"
   },
   "devDependencies": {
-    "@aidc-toolkit/dev": "^0.9.7-beta",
+    "@aidc-toolkit/dev": "^0.9.8-beta",
     "eslint": "^9.16.0",
     "ts-node": "^10.9.2",
     "tsup": "^8.3.5",
@@ -33,7 +33,8 @@
     "vitest": "^2.1.8"
   },
   "dependencies": {
-    "@aidc-toolkit/core": "^0.9.7-beta",
-    "@rollup/rollup-linux-x64-gnu": "^4.28.1"
+    "@aidc-toolkit/core": "^0.9.8-beta",
+    "@rollup/rollup-linux-x64-gnu": "^4.28.1",
+    "i18next": "^24.1.0"
   }
 }

package/src/{character_set.ts → character-set.ts}

@@ -1,8 +1,7 @@
-import i18next, { utilityNS } from "./locale/i18n.js";
-import { RegExpValidator } from "./reg_exp.js";
+import { i18nextUtility } from "./locale/i18n.js";
+import { RegExpValidator } from "./reg-exp.js";
 import type { StringValidation, StringValidator } from "./string.js";
-import { Transformer } from "./transformer.js";
-import type { TransformerCallback, TransformerInput, TransformerOutput } from "./types.js";
+import { Transformer, type TransformerCallback, type TransformerInput, type TransformerOutput } from "./transformer.js";
 
 /**
  * Exclusion options for validating and creating strings based on character sets.
@@ -72,9 +71,7 @@ export class CharacterSetValidator implements StringValidator<CharacterSetValida
          * Error message.
          */
         protected override createErrorMessage(_s: string): string {
-            return i18next.t("CharacterSetValidator.stringMustNotBeAllNumeric", {
-                ns: utilityNS
-            });
+            return i18nextUtility.t("CharacterSetValidator.stringMustNotBeAllNumeric");
         }
     }(/\D/);
 
@@ -200,8 +197,7 @@ export class CharacterSetValidator implements StringValidator<CharacterSetValida
      */
     protected validateExclusion(exclusion: Exclusion): void {
         if (exclusion !== Exclusion.None && !this._exclusionSupport.includes(exclusion)) {
-            throw new RangeError(i18next.t("CharacterSetValidator.exclusionNotSupported", {
-                ns: utilityNS,
+            throw new RangeError(i18nextUtility.t("CharacterSetValidator.exclusionNotSupported", {
                 exclusion
             }));
         }
@@ -227,15 +223,13 @@ export class CharacterSetValidator implements StringValidator<CharacterSetValida
             let errorMessage: string;
 
             if (maximumLength !== undefined && maximumLength === minimumLength) {
-                errorMessage = i18next.t(validation?.component === undefined ? "CharacterSetValidator.lengthMustBeEqualTo" : "CharacterSetValidator.lengthOfComponentMustBeEqualTo", {
-                    ns: utilityNS,
+                errorMessage = i18nextUtility.t(validation?.component === undefined ? "CharacterSetValidator.lengthMustBeEqualTo" : "CharacterSetValidator.lengthOfComponentMustBeEqualTo", {
                     component: CharacterSetValidator.componentToString(validation?.component),
                     length,
                     exactLength: minimumLength
                 });
             } else {
-                errorMessage = i18next.t(validation?.component === undefined ? "CharacterSetValidator.lengthMustBeGreaterThanOrEqualTo" : "CharacterSetValidator.lengthOfComponentMustBeGreaterThanOrEqualTo", {
-                    ns: utilityNS,
+                errorMessage = i18nextUtility.t(validation?.component === undefined ? "CharacterSetValidator.lengthMustBeGreaterThanOrEqualTo" : "CharacterSetValidator.lengthOfComponentMustBeGreaterThanOrEqualTo", {
                     component: CharacterSetValidator.componentToString(validation?.component),
                     length,
                     minimumLength
@@ -246,8 +240,7 @@ export class CharacterSetValidator implements StringValidator<CharacterSetValida
         }
 
         if (maximumLength !== undefined && length > maximumLength) {
-            throw new RangeError(i18next.t(validation?.component === undefined ? "CharacterSetValidator.lengthMustBeLessThanOrEqualTo" : "CharacterSetValidator.lengthOfComponentMustBeLessThanOrEqualTo", {
-                ns: utilityNS,
+            throw new RangeError(i18nextUtility.t(validation?.component === undefined ? "CharacterSetValidator.lengthMustBeLessThanOrEqualTo" : "CharacterSetValidator.lengthOfComponentMustBeLessThanOrEqualTo", {
                 component: CharacterSetValidator.componentToString(validation?.component),
                 length,
                 maximumLength
@@ -258,8 +251,7 @@ export class CharacterSetValidator implements StringValidator<CharacterSetValida
         const index = this.characterIndexes(s).findIndex(characterIndex => characterIndex === undefined);
 
         if (index !== -1) {
-            throw new RangeError(i18next.t(validation?.component === undefined ? "CharacterSetValidator.invalidCharacterAtPosition" : "CharacterSetValidator.invalidCharacterAtPositionOfComponent", {
-                ns: utilityNS,
+            throw new RangeError(i18nextUtility.t(validation?.component === undefined ? "CharacterSetValidator.invalidCharacterAtPosition" : "CharacterSetValidator.invalidCharacterAtPositionOfComponent", {
                 component: CharacterSetValidator.componentToString(validation?.component),
                 c: s.charAt(index),
                 position: index + (validation?.positionOffset ?? 0) + 1
@@ -275,8 +267,7 @@ export class CharacterSetValidator implements StringValidator<CharacterSetValida
 
                 case Exclusion.FirstZero:
                     if (s.startsWith("0")) {
-                        throw new RangeError(i18next.t(validation.component === undefined ? "CharacterSetValidator.invalidCharacterAtPosition" : "CharacterSetValidator.invalidCharacterAtPositionOfComponent", {
-                            ns: utilityNS,
+                        throw new RangeError(i18nextUtility.t(validation.component === undefined ? "CharacterSetValidator.invalidCharacterAtPosition" : "CharacterSetValidator.invalidCharacterAtPositionOfComponent", {
                             component: CharacterSetValidator.componentToString(validation.component),
                             c: "0",
                             position: (validation.positionOffset ?? 0) + 1
@@ -384,9 +375,7 @@ export class CharacterSetCreator extends CharacterSetValidator {
 
         if (exclusionSupport.includes(Exclusion.FirstZero)) {
             if (characterSet[0] !== "0") {
-                throw new RangeError(i18next.t("CharacterSetValidator.firstZeroFirstCharacter", {
-                    ns: utilityNS
-                }));
+                throw new RangeError(i18nextUtility.t("CharacterSetValidator.firstZeroFirstCharacter"));
             }
 
             const exclusionFirstZeroDomains = new Array<bigint>(CharacterSetCreator.MAXIMUM_STRING_LENGTH + 1);
@@ -417,9 +406,7 @@ export class CharacterSetCreator extends CharacterSetValidator {
                 // Make sure that all numeric characters are present and in sequence.
                 for (const numberIndex of numberIndexes) {
                     if (numberIndex === undefined || numberIndex !== expectedNumberIndex) {
-                        throw new RangeError(i18next.t("CharacterSetValidator.allNumericAllNumericCharacters", {
-                            ns: utilityNS
-                        }));
+                        throw new RangeError(i18nextUtility.t("CharacterSetValidator.allNumericAllNumericCharacters"));
                     }
 
                     expectedNumberIndex = numberIndex + 1;
@@ -491,9 +478,7 @@ export class CharacterSetCreator extends CharacterSetValidator {
         if (length === 0) {
             if (!shiftForward && value < 10n) {
                 // If calculation gets this far, string is all-numeric.
-                throw new RangeError(i18next.t("CharacterSetValidator.stringMustNotBeAllNumeric", {
-                    ns: utilityNS
-                }));
+                throw new RangeError(i18nextUtility.t("CharacterSetValidator.stringMustNotBeAllNumeric"));
             }
 
             // Now dealing with individual characters; shift by 10 to skip numeric characters.
@@ -528,16 +513,14 @@ export class CharacterSetCreator extends CharacterSetValidator {
      */
     private validateLength(length: number): void {
         if (length < 0) {
-            throw new RangeError(i18next.t("CharacterSetValidator.lengthMustBeGreaterThanOrEqualTo", {
-                ns: utilityNS,
+            throw new RangeError(i18nextUtility.t("CharacterSetValidator.lengthMustBeGreaterThanOrEqualTo", {
                 length,
                 minimumLength: 0
             }));
         }
 
         if (length > CharacterSetCreator.MAXIMUM_STRING_LENGTH) {
-            throw new RangeError(i18next.t("CharacterSetValidator.lengthMustBeLessThanOrEqualTo", {
-                ns: utilityNS,
+            throw new RangeError(i18nextUtility.t("CharacterSetValidator.lengthMustBeLessThanOrEqualTo", {
                 length,
                 maximumLength: CharacterSetCreator.MAXIMUM_STRING_LENGTH
             }));
@@ -633,8 +616,7 @@ export class CharacterSetCreator extends CharacterSetValidator {
         // Convert string to its value character by character.
         let value = this.characterIndexes(s).reduce((accumulator, characterIndex, index) => {
             if (characterIndex === undefined) {
-                throw new RangeError(i18next.t("CharacterSetValidator.invalidCharacterAtPosition", {
-                    ns: utilityNS,
+                throw new RangeError(i18nextUtility.t("CharacterSetValidator.invalidCharacterAtPosition", {
                     c: s.charAt(index),
                     position: index + 1
                 }));
@@ -644,8 +626,7 @@ export class CharacterSetCreator extends CharacterSetValidator {
 
             if (index === 0 && exclusion === Exclusion.FirstZero) {
                 if (characterIndex === 0) {
-                    throw new RangeError(i18next.t("CharacterSetValidator.invalidCharacterAtPosition", {
-                        ns: utilityNS,
+                    throw new RangeError(i18nextUtility.t("CharacterSetValidator.invalidCharacterAtPosition", {
                         c: "0",
                         position: 1
                     }));

package/src/index.ts

@@ -1,9 +1,7 @@
-export { utilityNS } from "./locale/i18n.js";
-export type * from "./types.js";
-export * from "./iterator_proxy.js";
+export * from "./locale/i18n.js";
 export * from "./sequencer.js";
 export * from "./transformer.js";
 export type * from "./string.js";
-export * from "./reg_exp.js";
+export * from "./reg-exp.js";
 export * from "./record.js";
-export * from "./character_set.js";
+export * from "./character-set.js";

package/src/locale/i18n.ts

@@ -1,12 +1,43 @@
-import { i18nAddResourceBundle, i18nAssertValidResources, i18next } from "@aidc-toolkit/core";
-import { localeStrings as enLocaleStrings } from "./en/locale_strings.js";
-import { localeStrings as frLocaleStrings } from "./fr/locale_strings.js";
+import { i18nAssertValidResources, i18nCoreInit, type I18NEnvironment } from "@aidc-toolkit/core";
+import i18next, { type Resource } from "i18next";
+import { localeStrings as enLocaleStrings } from "./en/locale-strings.js";
+import { localeStrings as frLocaleStrings } from "./fr/locale-strings.js";
 
 export const utilityNS = "aidct_utility";
 
+/**
+ * Locale strings type is extracted from the English locale strings object.
+ */
+export type UtilityLocaleStrings = typeof enLocaleStrings;
+
 i18nAssertValidResources(enLocaleStrings, "fr", frLocaleStrings);
 
-i18nAddResourceBundle("en", utilityNS, enLocaleStrings);
-i18nAddResourceBundle("fr", utilityNS, frLocaleStrings);
+/**
+ * Utility resources.
+ */
+export const utilityResources: Resource = {
+    en: {
+        aidct_utility: enLocaleStrings
+    },
+    fr: {
+        aidct_utility: frLocaleStrings
+    }
+};
+
+export const i18nextUtility = i18next.createInstance();
 
-export default i18next;
+/**
+ * Initialize internationalization.
+ *
+ * @param environment
+ * Environment in which the application is running.
+ *
+ * @param debug
+ * Debug setting.
+ *
+ * @returns
+ * Void promise.
+ */
+export async function i18nUtilityInit(environment: I18NEnvironment, debug = false): Promise<void> {
+    await i18nCoreInit(i18nextUtility, environment, debug, utilityNS, utilityResources);
+}

package/src/locale/i18next.d.ts

@@ -1,4 +1,4 @@
-import type { localeStrings } from "./en/locale_strings.js";
+import type { UtilityLocaleStrings } from "./i18n.js";
 
 /**
  * Internationalization module.
@@ -8,9 +8,9 @@ declare module "i18next" {
      * Custom type options for this package.
      */
     interface CustomTypeOptions {
+        defaultNS: "aidct_utility";
         resources: {
-            // Extract the type from the English locale strings object.
-            aidct_utility: typeof localeStrings;
+            aidct_utility: UtilityLocaleStrings;
         };
     }
 }

package/src/record.ts

@@ -1,4 +1,4 @@
-import i18next, { utilityNS } from "./locale/i18n.js";
+import { i18nextUtility } from "./locale/i18n.js";
 import type { StringValidator } from "./string.js";
 
 /**
@@ -51,9 +51,8 @@ export class RecordValidator<T> implements StringValidator {
      * Record key.
      */
     validate(key: string): void {
-        if (this.record[key] === undefined) {
-            throw new RangeError(i18next.t("RecordValidator.typeNameKeyNotFound", {
-                ns: utilityNS,
+        if (!(key in this.record)) {
+            throw new RangeError(i18nextUtility.t("RecordValidator.typeNameKeyNotFound", {
                 typeName: this.typeName,
                 key
             }));

package/src/{reg_exp.ts → reg-exp.ts}

@@ -1,4 +1,4 @@
-import i18next, { utilityNS } from "./locale/i18n.js";
+import { i18nextUtility } from "./locale/i18n.js";
 import type { StringValidator } from "./string.js";
 
 /**
@@ -44,8 +44,7 @@ export class RegExpValidator implements StringValidator {
      * Error message.
      */
     protected createErrorMessage(s: string): string {
-        return i18next.t("RegExpValidator.stringDoesNotMatchPattern", {
-            ns: utilityNS,
+        return i18nextUtility.t("RegExpValidator.stringDoesNotMatchPattern", {
             s
         });
     }

package/src/sequencer.ts

@@ -1,7 +1,7 @@
 /**
- * Sequencer. Defines an ascending or descending sequence of big integers implemented as an iterable iterator.
+ * Sequencer. Defines an ascending or descending sequence of big integers implemented as an iterable.
  */
-export class Sequencer implements Iterable<bigint>, IterableIterator<bigint> {
+export class Sequencer implements Iterable<bigint> {
     /**
      * Start value (inclusive).
      */
@@ -32,11 +32,6 @@ export class Sequencer implements Iterable<bigint>, IterableIterator<bigint> {
      */
     private readonly _maxValue: bigint;
 
-    /**
-     * Next value.
-     */
-    private _nextValue: bigint;
-
     /**
      * Constructor.
      *
@@ -52,9 +47,7 @@ export class Sequencer implements Iterable<bigint>, IterableIterator<bigint> {
         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;
@@ -63,8 +56,6 @@ export class Sequencer implements Iterable<bigint>, IterableIterator<bigint> {
             this._minValue = this._endValue + 1n;
             this._maxValue = this._startValue;
         }
-
-        this._nextValue = this._startValue;
     }
 
     /**
@@ -105,45 +96,12 @@ export class Sequencer implements Iterable<bigint>, IterableIterator<bigint> {
     /**
      * Iterable implementation.
      *
-     * @returns
-     * this
-     */
-    [Symbol.iterator](): this {
-        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(): IteratorResult<bigint, number> {
-        const done = this._nextValue === this._endValue;
-
-        let result: IteratorResult<bigint, number>;
-
-        if (!done) {
-            result = {
-                value: this._nextValue
-            };
-
-            this._nextValue += this._nextDelta;
-        } else {
-            result = {
-                done: true,
-                value: Math.abs(this._count)
-            };
+    * [Symbol.iterator](): Generator<bigint> {
+        for (let value = this._startValue; value !== this._endValue; value += this._nextDelta) {
+            yield value;
         }
-
-        return result;
-    }
-
-    /**
-     * Reset the iterator.
-     */
-    reset(): void {
-        // Reset simply returns to the start.
-        this._nextValue = this._startValue;
     }
 }

package/src/transformer.ts

@@ -1,7 +1,75 @@
-import { IteratorProxy } from "./iterator_proxy.js";
-import i18next, { utilityNS } from "./locale/i18n.js";
+import { i18nextUtility } from "./locale/i18n.js";
 import { Sequencer } from "./sequencer.js";
-import type { TransformerCallback, TransformerInput, TransformerOutput } from "./types.js";
+
+/**
+ * Transformer input, one of:
+ *
+ * - T (primitive type)
+ * - Iterable<T>
+ *
+ * @template T
+ * Primitive type.
+ */
+export type TransformerInput<T extends string | number | bigint | boolean> = T | Iterable<T>;
+
+/**
+ * Transformer callback, used to convert transformed value to its final value.
+ *
+ * @template TInput
+ * Type of input to callback.
+ *
+ * @template TOutput
+ * Type of output to callback.
+ *
+ * @param input
+ * Input value.
+ *
+ * @param index
+ * Index in sequence (0 for single transformation).
+ *
+ * @returns
+ * Output value.
+ */
+export type TransformerCallback<TInput, TOutput> = (input: TInput, index: number) => TOutput;
+
+/**
+ * Transformer output, based on transformer input:
+ *
+ * - If type T is primitive, result is type TOutput.
+ * - If type T is Iterable, result is type Iterable<TOutput>.
+ *
+ * @template T
+ * Transformer input type.
+ *
+ * @template TOutput
+ * Output base type.
+ */
+export type TransformerOutput<T extends TransformerInput<string | number | bigint | boolean>, TOutput> =
+    T extends (T extends TransformerInput<infer TInput> ? TInput : never) ? TOutput : Iterable<TOutput>;
+
+/**
+ * Transform an iterable by applying a transformer callback to each entry.
+ *
+ * @param iterable
+ * Input iterable.
+ *
+ * @param transformerCallback
+ * Callback to transform input value to output value.
+ *
+ * @returns
+ * Output iterable.
+ */
+export function transformIterable<TInput, TOutput>(iterable: Iterable<TInput>, transformerCallback: TransformerCallback<TInput, TOutput>): Iterable<TOutput> {
+    return {
+        * [Symbol.iterator](): Generator<TOutput> {
+            let index = 0;
+
+            for (const input of iterable) {
+                yield transformerCallback(input, index++);
+            }
+        }
+    };
+}
 
 /**
  * Transformer that transforms values in a numeric domain to values in a range equal to the domain or to another range
@@ -41,8 +109,7 @@ export abstract class Transformer {
         this._domain = BigInt(domain);
 
         if (this._domain <= 0n) {
-            throw new RangeError(i18next.t("Transformer.domainMustBeGreaterThanZero", {
-                ns: utilityNS,
+            throw new RangeError(i18nextUtility.t("Transformer.domainMustBeGreaterThanZero", {
                 domain
             }));
         }
@@ -100,15 +167,13 @@ export abstract class Transformer {
      */
     private validate(value: bigint): void {
         if (value < 0n) {
-            throw new RangeError(i18next.t("Transformer.valueMustBeGreaterThanOrEqualToZero", {
-                ns: utilityNS,
+            throw new RangeError(i18nextUtility.t("Transformer.valueMustBeGreaterThanOrEqualToZero", {
                 value
             }));
         }
 
         if (value >= this.domain) {
-            throw new RangeError(i18next.t("Transformer.valueMustBeLessThan", {
-                ns: utilityNS,
+            throw new RangeError(i18nextUtility.t("Transformer.valueMustBeLessThan", {
                 value,
                 domain: this.domain
             }));
@@ -165,7 +230,7 @@ export abstract class Transformer {
     // eslint-disable-next-line jsdoc/require-jsdoc -- Implementation of overloaded signatures.
     forward<T extends TransformerInput<number | bigint>, U>(valueOrValues: T, transformerCallback?: TransformerCallback<bigint, U>): TransformerOutput<T, U> {
         // TODO Refactor type when https://github.com/microsoft/TypeScript/pull/56941 released.
-        let result: bigint | U | IterableIterator<bigint> | IterableIterator<U>;
+        let result: bigint | U | Iterable<bigint> | Iterable<U>;
 
         if (typeof valueOrValues !== "object") {
             const valueN = BigInt(valueOrValues);
@@ -177,39 +242,41 @@ export abstract class Transformer {
             result = transformerCallback === undefined ? transformedValue : transformerCallback(transformedValue, 0);
         } else if (valueOrValues instanceof Sequencer) {
             if (valueOrValues.minValue < 0n) {
-                throw new RangeError(i18next.t("Transformer.minValueMustBeGreaterThanOrEqualToZero", {
-                    ns: utilityNS,
+                throw new RangeError(i18nextUtility.t("Transformer.minValueMustBeGreaterThanOrEqualToZero", {
                     minValue: valueOrValues.minValue
                 }));
             }
 
             if (valueOrValues.maxValue >= this.domain) {
-                throw new RangeError(i18next.t("Transformer.maxValueMustBeLessThan", {
-                    ns: utilityNS,
+                throw new RangeError(i18nextUtility.t("Transformer.maxValueMustBeLessThan", {
                     maxValue: valueOrValues.maxValue,
                     domain: this.domain
                 }));
             }
 
-            result = transformerCallback === undefined ?
-                IteratorProxy.from(valueOrValues).map(value => this.doForward(value)) :
-                IteratorProxy.from(valueOrValues).map((value, index) => transformerCallback(this.doForward(value), index));
+            if (transformerCallback === undefined) {
+                result = transformIterable(valueOrValues, value => this.doForward(value));
+            } else {
+                result = transformIterable(valueOrValues, (value, index) => transformerCallback(this.doForward(value), index));
+            }
         } else {
-            result = transformerCallback === undefined ?
-                IteratorProxy.from(valueOrValues).map((value) => {
+            if (transformerCallback === undefined) {
+                result = transformIterable(valueOrValues, (value) => {
                     const valueN = BigInt(value);
 
                     this.validate(valueN);
 
                     return this.doForward(valueN);
-                }) :
-                IteratorProxy.from(valueOrValues).map((value, index) => {
+                });
+            } else {
+                result = transformIterable(valueOrValues, (value, index) => {
                     const valueN = BigInt(value);
 
                     this.validate(valueN);
 
                     return transformerCallback(this.doForward(valueN), index);
                 });
+            }
         }
 
         // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion -- Type determination is handled above.
@@ -342,8 +409,7 @@ export class EncryptionTransformer extends Transformer {
         super(domain);
 
         if (tweak < 0n) {
-            throw new RangeError(i18next.t("Transformer.tweakMustBeGreaterThanOrEqualToZero", {
-                ns: utilityNS,
+            throw new RangeError(i18nextUtility.t("Transformer.tweakMustBeGreaterThanOrEqualToZero", {
                 tweak
             }));
         }

package/test/{character_set.test.ts → character-set.test.ts}

@@ -1,4 +1,4 @@
-import { I18NEnvironment, i18nInit } from "@aidc-toolkit/core";
+import { I18NEnvironment } from "@aidc-toolkit/core";
 import { describe, expect, test } from "vitest";
 import {
     ALPHABETIC_CREATOR,
@@ -6,11 +6,12 @@ import {
     CharacterSetCreator,
     Exclusion,
     HEXADECIMAL_CREATOR,
+    i18nUtilityInit,
     NUMERIC_CREATOR,
     Sequencer
 } from "../src/index.js";
 
-await i18nInit(I18NEnvironment.CLI);
+await i18nUtilityInit(I18NEnvironment.CLI);
 
 function testCharacterSetCreator(name: string, characterSetCreator: CharacterSetCreator, characterSetSize: number, length: number, excludeFirstZero: boolean, excludeAllNumeric: boolean): void {
     describe(name, () => {

package/test/record.test.ts

@@ -1,8 +1,8 @@
-import { I18NEnvironment, i18nInit } from "@aidc-toolkit/core";
+import { I18NEnvironment } from "@aidc-toolkit/core";
 import { describe, expect, test } from "vitest";
-import { RecordValidator } from "../src/index.js";
+import { i18nUtilityInit, RecordValidator } from "../src/index.js";
 
-await i18nInit(I18NEnvironment.CLI);
+await i18nUtilityInit(I18NEnvironment.CLI);
 
 describe("Record validator", () => {
     enum StringEnum {

package/test/{reg_exp.test.ts → reg-exp.test.ts}

@@ -1,8 +1,8 @@
-import { I18NEnvironment, i18nInit } from "@aidc-toolkit/core";
+import { I18NEnvironment } from "@aidc-toolkit/core";
 import { describe, expect, test } from "vitest";
-import { RegExpValidator } from "../src/index.js";
+import { i18nUtilityInit, RegExpValidator } from "../src/index.js";
 
-await i18nInit(I18NEnvironment.CLI);
+await i18nUtilityInit(I18NEnvironment.CLI);
 
 describe("Regular expression validator", () => {
     test("Validation", () => {

package/test/sequencer.test.ts

@@ -1,8 +1,8 @@
-import { I18NEnvironment, i18nInit } from "@aidc-toolkit/core";
+import { I18NEnvironment } from "@aidc-toolkit/core";
 import { describe, expect, test } from "vitest";
-import { Sequencer } from "../src/index.js";
+import { i18nUtilityInit, Sequencer } from "../src/index.js";
 
-await i18nInit(I18NEnvironment.CLI);
+await i18nUtilityInit(I18NEnvironment.CLI);
 
 describe("Sequence", () => {
     const sequencer1 = new Sequencer(10, 20);
@@ -22,7 +22,7 @@ describe("Sequence", () => {
         expect(sequencer2.maxValue).toBe(29n);
     });
 
-    test("Iteration", () => {
+    function iterate(): void {
         let expectedValue: bigint;
         let count: number;
 
@@ -49,24 +49,13 @@ describe("Sequence", () => {
         }
 
         expect(count).toBe(20);
-    });
-
-    test("Reset", () => {
-        let expectedValue: bigint;
-        let count: number;
-
-        expectedValue = 10n;
-        count = 0;
-
-        sequencer1.reset();
+    }
 
-        for (const value of Iterator.from(sequencer1)) {
-            expect(value).toBe(expectedValue);
-
-            expectedValue++;
-            count++;
-        }
+    test("Iteration", () => {
+        iterate();
+    });
 
-        expect(count).toBe(20);
+    test("Repeat", () => {
+        iterate();
     });
 });