@aidc-toolkit/utility 0.9.1 → 0.9.3

package/eslint.config.js

@@ -1,18 +1,3 @@
-import tseslint from "typescript-eslint";
-import js from "@eslint/js";
-import stylistic from "@stylistic/eslint-plugin";
-import jsdoc from "eslint-plugin-jsdoc";
-import esLintConfigLove from "eslint-config-love";
 import { esLintConfigAIDCToolkit } from "@aidc-toolkit/dev";
 
-export default tseslint.config(
-    {
-        ignores: ["eslint.config.js", "dist"]
-    },
-    js.configs.recommended,
-    ...tseslint.configs.strictTypeChecked,
-    stylistic.configs["recommended-flat"],
-    jsdoc.configs["flat/recommended-typescript"],
-    esLintConfigLove,
-    esLintConfigAIDCToolkit
-);
+export default esLintConfigAIDCToolkit;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aidc-toolkit/utility",
-  "version": "0.9.1",
+  "version": "0.9.3",
   "description": "Foundational utilities for AIDC Toolkit",
   "type": "module",
   "main": "dist/index.js",
@@ -21,23 +21,19 @@
   "scripts": {
     "eslint": "eslint .",
     "build": "tsup src/index.ts --clean --format cjs,esm --dts",
-    "build-dev": "npm run build && tsc src/index.ts --outDir dist --target esnext --moduleResolution nodenext --module nodenext --emitDeclarationOnly --declaration --declarationMap",
+    "build-doc": "npm run build && tsc src/index.ts --outDir dist --target esnext --moduleResolution nodenext --module nodenext --emitDeclarationOnly --declaration --declarationMap",
     "test": "vitest run"
   },
   "devDependencies": {
-    "@aidc-toolkit/dev": "^0.9.1",
-    "@eslint/js": "^9.11.1",
-    "@stylistic/eslint-plugin": "^2.8.0",
-    "eslint-config-love": "^71.0.0",
-    "eslint-plugin-jsdoc": "^50.3.0",
+    "@aidc-toolkit/dev": "^0.9.3",
+    "eslint": "^9.14.0",
     "ts-node": "^10.9.2",
-    "tsup": "^8.3.0",
-    "typescript": "^5.6.2",
-    "typescript-eslint": "^8.7.0",
-    "vitest": "^2.1.1"
+    "tsup": "^8.3.5",
+    "typescript": "^5.6.3",
+    "vitest": "^2.1.5"
   },
   "dependencies": {
-    "@aidc-toolkit/core": "^0.9.1",
-    "i18next": "^23.15.1"
+    "@aidc-toolkit/core": "^0.9.3",
+    "i18next": "^23.16.5"
   }
 }

package/src/character_set.ts

@@ -28,29 +28,29 @@ export enum Exclusion {
  */
 export interface CharacterSetValidation extends StringValidation {
     /**
-     * Minimum length. If defined and the string is less than this length, an exception is thrown.
+     * Minimum length. If defined and the string is less than this length, an error is thrown.
      */
     minimumLength?: number | undefined;
 
     /**
-     * Maximum length. If defined and the string is greater than this length, an exception is thrown.
+     * Maximum length. If defined and the string is greater than this length, an error is thrown.
      */
     maximumLength?: number | undefined;
 
     /**
-     * Exclusion from the string. If defined and the string is within the exclusion range, an exception is thrown.
+     * Exclusion from the string. If defined and the string is within the exclusion range, an error is thrown.
      */
     exclusion?: Exclusion | undefined;
 
     /**
      * Position offset within a larger string. Strings are sometimes composed of multiple substrings; this parameter
-     * ensures that the exception notes the proper position in the string.
+     * ensures that the error notes the proper position in the string.
      */
     positionOffset?: number | undefined;
 
     /**
      * Name of component, typically but not exclusively within a larger string. This parameter ensure that the
-     * exception notes the component that triggered it. Value may be a string or a callback that returns a string, the
+     * error notes the component that triggered it. Value may be a string or a callback that returns a string, the
      * latter allowing for localization changes.
      */
     component?: string | (() => string) | undefined;
@@ -86,7 +86,7 @@ export class CharacterSetValidator implements StringValidator<CharacterSetValida
      * Character set map, mapping each character in the character set to its index such that
      * `_characterSetMap.get(_characterSet[index]) === index`.
      */
-    private readonly _characterSetMap: Map<string, number>;
+    private readonly _characterSetMap: ReadonlyMap<string, number>;
 
     /**
      * Exclusions supported by the character set.
@@ -106,7 +106,13 @@ export class CharacterSetValidator implements StringValidator<CharacterSetValida
     constructor(characterSet: readonly string[], ...exclusionSupport: readonly Exclusion[]) {
         this._characterSet = characterSet;
 
-        this._characterSetMap = new Map(characterSet.map((c, index) => [c, index]));
+        const characterSetMap = new Map<string, number>();
+
+        characterSet.forEach((c, index) => {
+            characterSetMap.set(c, index);
+        });
+
+        this._characterSetMap = characterSetMap;
 
         this._exclusionSupport = exclusionSupport;
     }
@@ -186,7 +192,7 @@ export class CharacterSetValidator implements StringValidator<CharacterSetValida
     }
 
     /**
-     * Validate that an exclusion is supported. If not, an exception is thrown.
+     * Validate that an exclusion is supported. If not, an error is thrown.
      *
      * @param exclusion
      * Exclusion.
@@ -202,7 +208,7 @@ export class CharacterSetValidator implements StringValidator<CharacterSetValida
 
     /**
      * Validate a string. If the string violates the character set or any of the character set validation parameters, an
-     * exception is thrown.
+     * error is thrown.
      *
      * @param s
      * String.
@@ -263,6 +269,9 @@ export class CharacterSetValidator implements StringValidator<CharacterSetValida
             this.validateExclusion(validation.exclusion);
 
             switch (validation.exclusion) {
+                case Exclusion.None:
+                    break;
+
                 case Exclusion.FirstZero:
                     if (s.startsWith("0")) {
                         throw new RangeError(i18next.t(validation.component === undefined ? "CharacterSetValidator.invalidCharacterAtPosition" : "CharacterSetValidator.invalidCharacterAtPositionOfComponent", {
@@ -357,12 +366,12 @@ export class CharacterSetCreator extends CharacterSetValidator {
     /**
      * Domains for every length for every supported {@link Exclusion}.
      */
-    private readonly _exclusionDomains: ReadonlyArray<readonly bigint[] | undefined>;
+    private readonly _exclusionDomains: ReadonlyArray<readonly bigint[]>;
 
     /**
      * Values that would generate all zeros in the created string.
      */
-    private readonly _allZerosValues: readonly bigint[] | undefined;
+    private readonly _allZerosValues: readonly bigint[];
 
     /**
      * Constructor.
@@ -380,12 +389,20 @@ export class CharacterSetCreator extends CharacterSetValidator {
         this._characterSetSizeN = BigInt(this.characterSetSize);
         this._characterSetSizeMinusOneN = BigInt(this.characterSetSize - 1);
 
+        const exclusionDomains: Array<readonly bigint[]> = [];
+
         const exclusionNoneDomains = CharacterSetCreator.createPowersOf(this.characterSetSize);
 
-        let exclusionFirstZeroDomains: bigint[] | undefined;
+        exclusionDomains[Exclusion.None] = exclusionNoneDomains;
 
         if (exclusionSupport.includes(Exclusion.FirstZero)) {
-            exclusionFirstZeroDomains = new Array<bigint>(CharacterSetCreator.MAXIMUM_STRING_LENGTH + 1);
+            if (characterSet[0] !== "0") {
+                throw new RangeError(i18next.t("CharacterSetValidator.firstZeroFirstCharacter", {
+                    ns: utilityNS
+                }));
+            }
+
+            const exclusionFirstZeroDomains = new Array<bigint>(CharacterSetCreator.MAXIMUM_STRING_LENGTH + 1);
 
             // Exclusion of first zero mathematically prohibits length of 0.
             exclusionFirstZeroDomains[0] = 0n;
@@ -394,16 +411,30 @@ export class CharacterSetCreator extends CharacterSetValidator {
                 // Domain excludes zero as the first character and so works with previous exclusion none domain.
                 exclusionFirstZeroDomains[index] = this._characterSetSizeMinusOneN * exclusionNoneDomains[index - 1];
             }
-        }
 
-        let exclusionAllNumericDomains: bigint[] | undefined;
+            exclusionDomains[Exclusion.FirstZero] = exclusionFirstZeroDomains;
+        }
 
         if (exclusionSupport.includes(Exclusion.AllNumeric)) {
-            exclusionAllNumericDomains = new Array<bigint>(CharacterSetCreator.MAXIMUM_STRING_LENGTH + 1);
+            const exclusionAllNumericDomains = new Array<bigint>(CharacterSetCreator.MAXIMUM_STRING_LENGTH + 1);
+
+            const numberIndexes = this.characterIndexes("0123456789");
+
+            let expectedNumberIndex = numberIndexes[0];
+
+            // 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
+                    }));
+                }
+
+                expectedNumberIndex = numberIndex + 1;
+            }
 
             // Zero index is the all-zero value for a single-character string.
-            // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
-            const zeroIndex = BigInt(this.characterIndex("0")!);
+            const zeroIndex = BigInt((numberIndexes as number[])[0]);
 
             const allZerosValues = new Array<bigint>(CharacterSetCreator.MAXIMUM_STRING_LENGTH + 1);
             let allZerosValue = 0n;
@@ -419,13 +450,14 @@ export class CharacterSetCreator extends CharacterSetValidator {
             }
 
             this._allZerosValues = allZerosValues;
+
+            exclusionDomains[Exclusion.AllNumeric] = exclusionAllNumericDomains;
+        } else {
+            // Empty array obviates need for non-null assertion while still forcing error if indexed due to a bug.
+            this._allZerosValues = [];
         }
 
-        this._exclusionDomains = [
-            exclusionNoneDomains,
-            exclusionFirstZeroDomains,
-            exclusionAllNumericDomains
-        ];
+        this._exclusionDomains = exclusionDomains;
     }
 
     /**
@@ -438,8 +470,7 @@ export class CharacterSetCreator extends CharacterSetValidator {
      * `characterSetSize**power`.
      */
     private powerOfSize(power: number): bigint {
-        // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
-        return this._exclusionDomains[Exclusion.None]![power];
+        return this._exclusionDomains[Exclusion.None][power];
     }
 
     /**
@@ -493,7 +524,7 @@ export class CharacterSetCreator extends CharacterSetValidator {
     }
 
     /**
-     * Validate that a length is less than or equal to {@link MAXIMUM_STRING_LENGTH}. If not, an exception is thrown.
+     * Validate that a length is less than or equal to {@link MAXIMUM_STRING_LENGTH}. If not, an error is thrown.
      *
      * @param length
      * Length.
@@ -584,16 +615,15 @@ export class CharacterSetCreator extends CharacterSetValidator {
      */
     create(length: number, valueOrValues: number | bigint | Iterable<number | bigint>, exclusion?: Exclusion, tweak?: number | bigint, creationCallback?: CreationCallback): string | IterableIterator<string>;
 
-    // eslint-disable-next-line jsdoc/require-jsdoc
+    // eslint-disable-next-line jsdoc/require-jsdoc -- Implementation of overloaded signatures.
     create(length: number, valueOrValues: number | bigint | Iterable<number | bigint>, exclusion: Exclusion = Exclusion.None, tweak?: number | bigint, creationCallback?: CreationCallback): string | IterableIterator<string> {
         this.validateLength(length);
         this.validateExclusion(exclusion);
 
-        // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
-        const allZerosValue = exclusion === Exclusion.AllNumeric ? this._allZerosValues![length] : undefined;
+        // Zero value obviates need for non-null assertion.
+        const allZerosValue = exclusion === Exclusion.AllNumeric ? this._allZerosValues[length] : 0n;
 
-        // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
-        const transformer = Transformer.get(this._exclusionDomains[exclusion]![length], tweak);
+        const transformer = Transformer.get(this._exclusionDomains[exclusion][length], tweak);
 
         return transformer.forward(valueOrValues, (transformedValue, index) => {
             let s = "";
@@ -602,11 +632,9 @@ export class CharacterSetCreator extends CharacterSetValidator {
             if (length !== 0) {
                 let convertValue = transformedValue;
 
-                // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
-                if (exclusion === Exclusion.AllNumeric && convertValue >= allZerosValue!) {
+                if (exclusion === Exclusion.AllNumeric && convertValue >= allZerosValue) {
                     // Value to convert is shifted by the number of all-numeric strings that occur at or prior to it.
-                    // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
-                    convertValue = convertValue + this.allNumericShift(true, length, convertValue - allZerosValue!);
+                    convertValue = convertValue + this.allNumericShift(true, length, convertValue - allZerosValue);
                 }
 
                 // Build string from right to left excluding the first character.
@@ -682,8 +710,7 @@ export class CharacterSetCreator extends CharacterSetValidator {
         }, 0n);
 
         if (exclusion === Exclusion.AllNumeric) {
-            // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
-            const allZerosValue = this._allZerosValues![length];
+            const allZerosValue = this._allZerosValues[length];
 
             if (value >= allZerosValue) {
                 // Call will ensure that string is not all-numeric.
@@ -691,8 +718,7 @@ export class CharacterSetCreator extends CharacterSetValidator {
             }
         }
 
-        // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
-        return Transformer.get(this._exclusionDomains[exclusion]![length], tweak).reverse(value);
+        return Transformer.get(this._exclusionDomains[exclusion][length], tweak).reverse(value);
     }
 }
 

package/src/locale/en/locale_strings.ts

@@ -11,6 +11,8 @@ export const localeStrings = {
         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}}",

package/src/locale/fr/locale_strings.ts

@@ -0,0 +1,32 @@
+export const localeStrings = {
+    Transformer: {
+        domainMustBeGreaterThanZero: "Le domaine {{domain}} doit être supérieur à 0",
+        tweakMustBeGreaterThanOrEqualToZero: "Le réglage {{tweak}} doit être supérieur ou égal à 0",
+        valueMustBeGreaterThanOrEqualToZero: "La valeur {{value}} doit être supérieure ou égale à 0",
+        valueMustBeLessThan: "La valeur {{value}} doit être inférieure à {{domain}}",
+        minValueMustBeGreaterThanOrEqualToZero: "La valeur minimale {{minValue}} doit être supérieure ou égale à 0",
+        maxValueMustBeLessThan: "La valeur maximale {{maxValue}} doit être inférieure à {{domain}}"
+    },
+    RegExpValidator: {
+        stringDoesNotMatchPattern: "La chaîne {{s}} ne correspond pas au modèle"
+    },
+    CharacterSetValidator: {
+        firstZeroFirstCharacter: "Le jeu de caractères doit prendre en charge zéro comme premier caractère",
+        allNumericAllNumericCharacters: "Le jeu de caractères doit prendre en charge tous les caractères numériques en séquence",
+        stringMustNotBeAllNumeric: "La chaîne ne doit pas être entièrement numérique",
+        lengthMustBeGreaterThanOrEqualTo: "La longueur {{length}} doit être supérieure ou égale à {{minimumLength}}",
+        lengthMustBeLessThanOrEqualTo: "La longueur {{length}} doit être inférieure ou égale à {{maximumLength}}",
+        lengthMustBeEqualTo: "La longueur {{length}} doit être égale à {{exactLength}}",
+        lengthOfComponentMustBeGreaterThanOrEqualTo: "La longueur {{length}} de {{component}} doit être supérieure ou égale à {{minimumLength}}",
+        lengthOfComponentMustBeLessThanOrEqualTo: "La longueur {{length}} de {{component}} doit être inférieure ou égale à {{maximumLength}}",
+        lengthOfComponentMustBeEqualTo: "La longueur {{length}} de {{component}} doit être égale à {{exactLength}}",
+        invalidCharacterAtPosition: "Caractère non valide '{{c}}' à la position {{position}}",
+        invalidCharacterAtPositionOfComponent: "Caractère non valide '{{c}}' à la position {{position}} de {{component}}",
+        exclusionNotSupported: "La valeur d'exclusion de {{exclusion}} n'est pas prise en charge",
+        invalidTweakWithAllNumericExclusion: "Le réglage ne doit pas être utilisé avec une exclusion entièrement numérique",
+        endSequenceValueMustBeLessThanOrEqualTo: "La valeur de la séquence de fin (valeur de la séquence de début + nombre - 1) doit être inférieure à {{domaine}}"
+    },
+    RecordValidator: {
+        typeNameKeyNotFound: "{{typeName}} \"{{key}}\" introuvable"
+    }
+} as const;

package/src/locale/i18n.ts

@@ -1,8 +1,12 @@
-import { i18nAddResourceBundle, i18next } from "@aidc-toolkit/core";
+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";
 
 export const utilityNS = "aidct_utility";
 
+i18nAssertValidResources(enLocaleStrings, "fr", frLocaleStrings);
+
 i18nAddResourceBundle("en", utilityNS, enLocaleStrings);
+i18nAddResourceBundle("fr", utilityNS, frLocaleStrings);
 
 export default i18next;

package/src/record.ts

@@ -2,8 +2,8 @@ import i18next, { utilityNS } from "./locale/i18n.js";
 import type { StringValidator } from "./string.js";
 
 /**
- * Record validator. Validation is performed against a record with a string key type and throws an exception if the key
- * is not found.
+ * Record validator. Validation is performed against a record with a string key type and throws an error if the key is
+ * not found.
  */
 export class RecordValidator<T> implements StringValidator {
     /**

package/src/string.ts

@@ -10,7 +10,7 @@ export interface StringValidation {
  */
 export interface StringValidator<V extends StringValidation = StringValidation> {
     /**
-     * Validate a string and throw an exception if validation fails.
+     * Validate a string and throw an error if validation fails.
      *
      * @param s
      * String.

package/src/transformer.ts

@@ -513,9 +513,7 @@ export class EncryptionTransformer extends Transformer {
      * Value.
      */
     private static bytesToValue(bytes: Uint8Array): bigint {
-        return bytes.reduce((accumulator, byte) => {
-            return accumulator << 8n | BigInt(byte);
-        }, 0n);
+        return bytes.reduce((accumulator, byte) => accumulator << 8n | BigInt(byte), 0n);
     }
 
     /**

package/test/character_set.test.ts

@@ -2,16 +2,16 @@ import { I18NEnvironment, i18nInit } from "@aidc-toolkit/core";
 import { describe, expect, test } from "vitest";
 import {
     ALPHABETIC_CREATOR,
-    ALPHANUMERIC_CREATOR, Sequencer,
+    ALPHANUMERIC_CREATOR,
     CharacterSetCreator,
     Exclusion,
     HEXADECIMAL_CREATOR,
-    NUMERIC_CREATOR
+    NUMERIC_CREATOR,
+    Sequencer
 } from "../src/index.js";
 
 await i18nInit(I18NEnvironment.CLI, true);
 
-// eslint-disable-next-line jsdoc/require-jsdoc
 function testCharacterSetCreator(name: string, characterSetCreator: CharacterSetCreator, characterSetSize: number, length: number, excludeFirstZero: boolean, excludeAllNumeric: boolean): void {
     describe(name, () => {
         test("Character set", () => {
@@ -45,7 +45,6 @@ function testCharacterSetCreator(name: string, characterSetCreator: CharacterSet
             expect(characterSetCreator.exclusionSupport.includes(Exclusion.AllNumeric)).toBe(excludeAllNumeric);
         });
 
-        // eslint-disable-next-line jsdoc/require-jsdoc
         function testCreate(exclusion: Exclusion): void {
             let domain: number;
 
@@ -154,17 +153,41 @@ function testCharacterSetCreator(name: string, characterSetCreator: CharacterSet
             test("Create sequence, exclude all numeric", () => {
                 testCreate(Exclusion.AllNumeric);
 
+                // eslint-disable-next-line @typescript-eslint/no-non-null-assertion -- Nine is known to be present in the character set.
+                const afterNine = characterSetCreator.character(characterSetCreator.characterIndex("9")! + 1);
+
                 expect(() => characterSetCreator.valueFor("0000", Exclusion.AllNumeric)).toThrow("String must not be all numeric");
-                // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
-                expect(() => characterSetCreator.valueFor("000" + characterSetCreator.character(characterSetCreator.characterIndex("9")! + 1), Exclusion.AllNumeric)).not.toThrow(RangeError);
+                expect(() => characterSetCreator.valueFor(`000${afterNine}`, Exclusion.AllNumeric)).not.toThrow(RangeError);
                 expect(() => characterSetCreator.valueFor("9999", Exclusion.AllNumeric)).toThrow("String must not be all numeric");
-                // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
-                expect(() => characterSetCreator.valueFor("999" + characterSetCreator.character(characterSetCreator.characterIndex("9")! + 1), Exclusion.AllNumeric)).not.toThrow(RangeError);
+                expect(() => characterSetCreator.valueFor(`999${afterNine}`, Exclusion.AllNumeric)).not.toThrow(RangeError);
             });
         }
     });
 }
 
+describe("Exclusion", () => {
+    test("First zero", () => {
+        expect(() => new CharacterSetCreator([
+            "0", "1", "2", "3", "4", "5", "6", "7", "8", "9"
+        ], Exclusion.FirstZero)).not.toThrow(RangeError);
+        expect(() => new CharacterSetCreator([
+            "1", "2", "3", "4", "5", "6", "7", "8", "9", "0"
+        ], Exclusion.FirstZero)).toThrow("Character set must support zero as first character");
+    });
+
+    test("All numeric", () => {
+        expect(() => new CharacterSetCreator([
+            "!", "#", "/", "0", "1", "2", "3", "4", "5", "6", "7", "8", "9", "A", "B", "C", "D"
+        ], Exclusion.AllNumeric)).not.toThrow(RangeError);
+        expect(() => new CharacterSetCreator([
+            "!", "#", "/", "0", "1", "2", "3", "A", "B", "C", "D"
+        ], Exclusion.AllNumeric)).toThrow("Character set must support all numeric characters in sequence");
+        expect(() => new CharacterSetCreator([
+            "!", "#", "/", "1", "2", "3", "4", "5", "6", "7", "8", "9", "0", "A", "B", "C", "D"
+        ], Exclusion.AllNumeric)).toThrow("Character set must support all numeric characters in sequence");
+    });
+});
+
 testCharacterSetCreator("Numeric", NUMERIC_CREATOR, 10, 4, true, false);
 testCharacterSetCreator("Hexadecimal", HEXADECIMAL_CREATOR, 16, 4, true, true);
 testCharacterSetCreator("Alphabetic", ALPHABETIC_CREATOR, 26, 3, false, false);

package/test/record.test.ts

@@ -5,7 +5,6 @@ import { RecordValidator } from "../src/index.js";
 await i18nInit(I18NEnvironment.CLI, true);
 
 describe("Record validator", () => {
-    // eslint-disable-next-line jsdoc/require-jsdoc
     enum StringEnum {
         ValueA = "A",
         ValueB = "B",

package/test/reg_exp.test.ts

@@ -34,7 +34,6 @@ describe("Regular expression validator", () => {
     test("Error message", () => {
         expect(() => {
             new class extends RegExpValidator {
-                // eslint-disable-next-line jsdoc/require-jsdoc
                 protected override createErrorMessage(s: string): string {
                     return `Failed to validate "${s}"`;
                 }

package/test/transformer.test.ts

@@ -1,10 +1,9 @@
 import { I18NEnvironment, i18nInit } from "@aidc-toolkit/core";
 import { describe, expect, test } from "vitest";
-import { Sequencer, EncryptionTransformer, IdentityTransformer, Transformer } from "../src/index.js";
+import { EncryptionTransformer, IdentityTransformer, Sequencer, Transformer } from "../src/index.js";
 
 await i18nInit(I18NEnvironment.CLI, true);
 
-// eslint-disable-next-line jsdoc/require-jsdoc
 function testTransformer(domain: number, tweak?: number, callback?: (value: bigint, forwardValue: bigint) => void): void {
     const transformer = Transformer.get(domain, tweak);
 
@@ -120,13 +119,9 @@ describe("Encryption", () => {
     });
 
     test("Byte boundary", () => {
-        // eslint-disable-next-line @typescript-eslint/dot-notation
         expect((Transformer.get(256n, 1n) as EncryptionTransformer)["_domainBytes"]).toBe(1);
-        // eslint-disable-next-line @typescript-eslint/dot-notation
         expect((Transformer.get(257n, 1n) as EncryptionTransformer)["_domainBytes"]).toBe(2);
-        // eslint-disable-next-line @typescript-eslint/dot-notation
         expect((Transformer.get(65536n, 1n) as EncryptionTransformer)["_domainBytes"]).toBe(2);
-        // eslint-disable-next-line @typescript-eslint/dot-notation
         expect((Transformer.get(65537n, 1n) as EncryptionTransformer)["_domainBytes"]).toBe(3);
 
         testTransformer(256, 1);