@aidc-toolkit/gs1 0.9.1 → 0.9.3

package/.idea/runConfigurations/eslint.xml

@@ -0,0 +1,12 @@
+<component name="ProjectRunConfigurationManager">
+  <configuration default="false" name="eslint" type="js.build_tools.npm" nameIsGenerated="true">
+    <package-json value="$PROJECT_DIR$/package.json" />
+    <command value="run" />
+    <scripts>
+      <script value="eslint" />
+    </scripts>
+    <node-interpreter value="project" />
+    <envs />
+    <method v="2" />
+  </configuration>
+</component>

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/gs1",
-  "version": "0.9.1",
+  "version": "0.9.3",
   "description": "GS1 AIDC Toolkit",
   "type": "module",
   "main": "dist/index.js",
@@ -21,25 +21,21 @@
   "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",
-    "@aidc-toolkit/utility": "^0.9.1",
-    "i18next": "^23.15.1",
+    "@aidc-toolkit/core": "^0.9.3",
+    "@aidc-toolkit/utility": "^0.9.3",
+    "i18next": "^23.16.5",
     "ts-mixer": "^6.0.4"
   }
 }

package/src/check.ts

@@ -55,17 +55,15 @@ export function checkDigitSum(exchangeWeights: boolean, s: string): number {
     let weight3 = (s.length + Number(exchangeWeights)) % 2 === 0;
 
     // Calculate sum of each character value multiplied by the weight at its position.
-    // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
-    return NUMERIC_CREATOR.characterIndexes(s).reduce((accumulator, characterIndex, index) => {
+    return NUMERIC_CREATOR.characterIndexes(s).reduce<number>((accumulator, characterIndex, index) => {
         if (characterIndex === undefined) {
             throw new RangeError(`Invalid character '${s.charAt(index)}' at position ${index + 1}`);
         }
 
         weight3 = !weight3;
 
-        // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
-        return accumulator! + (weight3 ? THREE_WEIGHT_RESULTS[characterIndex] : characterIndex);
-    }, 0)!;
+        return accumulator + (weight3 ? THREE_WEIGHT_RESULTS[characterIndex] : characterIndex);
+    }, 0);
 }
 
 /**
@@ -118,16 +116,14 @@ function priceWeightSum(weightsResults: ReadonlyArray<readonly number[]>, s: str
     const characterIndexes = NUMERIC_CREATOR.characterIndexes(s);
 
     // Calculate sum of each weight result for each digit at its position.
-    // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
-    return characterIndexes.reduce((accumulator, characterIndex, index) => {
+    return characterIndexes.reduce<number>((accumulator, characterIndex, index) => {
         if (characterIndex === undefined) {
             throw new RangeError(`Invalid character '${s.charAt(index)}' at position ${index + 1}`);
         }
 
         // Add the weight result of the character index to the accumulator.
-        // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
-        return accumulator! + weightsResults[index][characterIndex];
-    }, 0)!;
+        return accumulator + weightsResults[index][characterIndex];
+    }, 0);
 }
 
 /**
@@ -196,15 +192,13 @@ export function checkCharacterPair(s: string): string {
     }
 
     // Calculate sum of each character value multiplied by the weight at its position, mod 1021.
-    // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
-    const checkCharacterPairSum = AI82_CREATOR.characterIndexes(s).reduce((accumulator, characterIndex, index) => {
+    const checkCharacterPairSum = AI82_CREATOR.characterIndexes(s).reduce<number>((accumulator, characterIndex, index) => {
         if (characterIndex === undefined) {
             throw new RangeError(`Invalid character '${s.charAt(index)}' at position ${index + 1}`);
         }
 
-        // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
-        return accumulator! + characterIndex * CHECK_CHARACTER_WEIGHTS[weightIndexStart + index];
-    }, 0)! % 1021;
+        return accumulator + characterIndex * CHECK_CHARACTER_WEIGHTS[weightIndexStart + index];
+    }, 0) % 1021;
 
     const checkCharacterPairSumMod32 = checkCharacterPairSum % 32;
 

package/src/idkey.ts

@@ -131,7 +131,7 @@ export enum CharacterSet {
 export interface IdentificationKeyValidation extends StringValidation {
     /**
      * 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;
 }
@@ -170,7 +170,7 @@ export interface IdentificationKeyValidator<V extends IdentificationKeyValidatio
     get referenceValidator(): CharacterSetValidator;
 
     /**
-     * Validate an identification key and throw an exception if validation fails.
+     * Validate an identification key and throw an error if validation fails.
      *
      * @param identificationKey
      * Identification key.
@@ -185,6 +185,10 @@ export interface IdentificationKeyValidator<V extends IdentificationKeyValidatio
  * Abstract identification key validator. Implements common functionality for an identification key validator.
  */
 abstract class AbstractIdentificationKeyValidator<V extends IdentificationKeyValidation = IdentificationKeyValidation> implements IdentificationKeyValidator<V> {
+    private static readonly CHARACTER_SET_CREATORS = [
+        NUMERIC_CREATOR, AI82_CREATOR, AI39_CREATOR
+    ];
+
     /**
      * Identification key type.
      */
@@ -206,7 +210,7 @@ abstract class AbstractIdentificationKeyValidator<V extends IdentificationKeyVal
     private readonly _referenceCharacterSet: CharacterSet;
 
     /**
-     * Character set validator.
+     * Reference validator.
      */
     private readonly _referenceValidator: CharacterSetValidator;
 
@@ -220,23 +224,7 @@ abstract class AbstractIdentificationKeyValidator<V extends IdentificationKeyVal
      * Character set validator.
      */
     protected static validatorFor(characterSet: CharacterSet): CharacterSetValidator {
-        let characterSetValidator: CharacterSetValidator;
-
-        switch (characterSet) {
-            case CharacterSet.Numeric:
-                characterSetValidator = NUMERIC_CREATOR;
-                break;
-
-            case CharacterSet.AI82:
-                characterSetValidator = AI82_CREATOR;
-                break;
-
-            case CharacterSet.AI39:
-                characterSetValidator = AI39_CREATOR;
-                break;
-        }
-
-        return characterSetValidator;
+        return AbstractIdentificationKeyValidator.CHARACTER_SET_CREATORS[characterSet];
     }
 
     /**
@@ -298,7 +286,7 @@ abstract class AbstractIdentificationKeyValidator<V extends IdentificationKeyVal
     }
 
     /**
-     * Pad an identification key on the left with zeroes for validation purposes. This is done to align an
+     * Pad an identification key on the left with zero-value character for validation purposes. This is done to align an
      * identification key with a position offset for any error message that may be thrown by the reference validator.
      *
      * @param identificationKey
@@ -310,9 +298,9 @@ abstract class AbstractIdentificationKeyValidator<V extends IdentificationKeyVal
      * @returns
      * Padded identification key.
      */
-    protected static padIdentificationKey(identificationKey: string, validation: IdentificationKeyValidation | undefined): string {
+    protected padIdentificationKey(identificationKey: string, validation: IdentificationKeyValidation | undefined): string {
         // Identification key is returned as is if position offset is undefined.
-        return validation?.positionOffset === undefined ? identificationKey : "0".repeat(validation.positionOffset).concat(identificationKey);
+        return validation?.positionOffset === undefined ? identificationKey : this.referenceValidator.character(0).repeat(validation.positionOffset).concat(identificationKey);
     }
 
     /**
@@ -427,7 +415,7 @@ abstract class AbstractNumericIdentificationKeyValidator extends AbstractIdentif
         }
 
         // Validating the check digit will also validate the characters.
-        if (!hasValidCheckDigit(AbstractIdentificationKeyValidator.padIdentificationKey(identificationKey, validation))) {
+        if (!hasValidCheckDigit(this.padIdentificationKey(identificationKey, validation))) {
             throw new RangeError(i18next.t("IdentificationKey.invalidCheckDigit", {
                 ns: gs1NS
             }));
@@ -711,7 +699,7 @@ export class SerializableNumericIdentificationKeyValidator extends NonGTINNumeri
     private readonly _serialComponentCharacterSet: CharacterSet;
 
     /**
-     * Serial component character set validation parameters.
+     * Serial component validation parameters.
      */
     private readonly _serialComponentValidation: CharacterSetValidation;
 
@@ -855,7 +843,7 @@ export class NonNumericIdentificationKeyValidator extends AbstractIdentification
     }
 
     /**
-     * Validate a non-numeric identification key and throw an exception if validation fails.
+     * Validate a non-numeric identification key and throw an error if validation fails.
      *
      * @param identificationKey
      * Identification key.
@@ -874,7 +862,7 @@ export class NonNumericIdentificationKeyValidator extends AbstractIdentification
                 positionOffset: validation?.positionOffset
             });
         // Validating the check character pair will also validate the characters.
-        } else if (!hasValidCheckCharacterPair(AbstractIdentificationKeyValidator.padIdentificationKey(identificationKey, validation))) {
+        } else if (!hasValidCheckCharacterPair(this.padIdentificationKey(identificationKey, validation))) {
             throw new RangeError(i18next.t("IdentificationKey.invalidCheckCharacterPair", {
                 ns: gs1NS
             }));
@@ -1002,12 +990,12 @@ abstract class AbstractIdentificationKeyCreator implements IdentificationKeyCrea
     /**
      * Prefix manager.
      */
-    private _prefixManager?: PrefixManager;
+    private _prefixManager!: PrefixManager;
 
     /**
      * Reference length.
      */
-    private _referenceLength?: number;
+    private _referenceLength!: number;
 
     /**
      * Initialize the prefix manager. This method is in lieu of a constructor due to the mixin architecture.
@@ -1022,12 +1010,6 @@ abstract class AbstractIdentificationKeyCreator implements IdentificationKeyCrea
      * Number of characters to allow for check digit or check character pair.
      */
     protected init(prefixManager: PrefixManager, prefix: string, checkAllowance: number): void {
-        // Verify that prefix manager has not already been assigned.
-        if (this._prefixManager !== undefined) {
-            // Should never get here.
-            throw new Error("Not supported");
-        }
-
         this._prefixManager = prefixManager;
 
         // Reference length allows for prefix and optionally check digit or check character pair.
@@ -1055,9 +1037,7 @@ abstract class AbstractIdentificationKeyCreator implements IdentificationKeyCrea
      * @inheritDoc
      */
     get prefixManager(): PrefixManager {
-        // Prefix manager is expected to have been initialized by this point.
-        // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
-        return this._prefixManager!;
+        return this._prefixManager;
     }
 
     /**
@@ -1071,8 +1051,7 @@ abstract class AbstractIdentificationKeyCreator implements IdentificationKeyCrea
      * @inheritDoc
      */
     get referenceLength(): number {
-        // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
-        return this._referenceLength!;
+        return this._referenceLength;
     }
 
     abstract validate(identificationKey: string, validation?: IdentificationKeyValidation): void;
@@ -1138,7 +1117,7 @@ abstract class AbstractNumericIdentificationKeyCreator extends AbstractIdentific
     /**
      * Capacity.
      */
-    private _capacity?: number;
+    private _capacity!: number;
 
     /**
      * Tweak for sparse creation.
@@ -1167,8 +1146,7 @@ abstract class AbstractNumericIdentificationKeyCreator extends AbstractIdentific
      * @inheritDoc
      */
     get capacity(): number {
-        // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
-        return this._capacity!;
+        return this._capacity;
     }
 
     /**
@@ -1210,7 +1188,7 @@ abstract class AbstractNumericIdentificationKeyCreator extends AbstractIdentific
      */
     create(values: Iterable<number | bigint>, sparse?: boolean): IterableIterator<string>;
 
-    // eslint-disable-next-line jsdoc/require-jsdoc
+    // eslint-disable-next-line jsdoc/require-jsdoc -- Implementation of overloaded signatures.
     create(valueOrValues: number | bigint | Iterable<number | bigint>, sparse = false): string | IterableIterator<string> {
         return NUMERIC_CREATOR.create(this.referenceLength, valueOrValues, Exclusion.None, sparse ? this.tweak : undefined, reference => this.buildIdentificationKey(reference));
     }
@@ -1368,7 +1346,7 @@ export class GTINCreator extends Mixin(GTINValidator, AbstractNumericIdentificat
      */
     createGTIN14(indicatorDigit: string, values: Iterable<number | bigint>, sparse?: boolean): IterableIterator<string>;
 
-    // eslint-disable-next-line jsdoc/require-jsdoc
+    // eslint-disable-next-line jsdoc/require-jsdoc -- Implementation of overloaded signatures.
     createGTIN14(indicatorDigit: string, valueOrValues: number | bigint | Iterable<number | bigint>, sparse = false): string | IterableIterator<string> {
         NUMERIC_CREATOR.validate(indicatorDigit, GTINCreator.REQUIRED_INDICATOR_DIGIT_VALIDATION);
 
@@ -1492,7 +1470,7 @@ export class GTINCreator extends Mixin(GTINValidator, AbstractNumericIdentificat
                 break;
 
             case GTINType.GTIN8 as number:
-                if (gtin.charAt(0) !== "0") {
+                if (!gtin.startsWith("0")) {
                     // GTIN is GTIN-8.
                     normalizedGTIN = gtin;
                 } else {
@@ -1625,7 +1603,7 @@ export class SerializableNumericIdentificationKeyCreator extends Mixin(Serializa
      */
     private concatenateValidated(baseIdentificationKey: string, serialComponents: Iterable<string>): IterableIterator<string>;
 
-    // eslint-disable-next-line jsdoc/require-jsdoc
+    // eslint-disable-next-line jsdoc/require-jsdoc -- Implementation of overloaded signatures.
     private concatenateValidated(baseIdentificationKey: string, serialComponent: string | Iterable<string>): string | IterableIterator<string> {
         let result: string | IterableIterator<string>;
 
@@ -1676,7 +1654,7 @@ export class SerializableNumericIdentificationKeyCreator extends Mixin(Serializa
      */
     createSerialized(value: number, serialComponents: Iterable<string>, sparse?: boolean): IterableIterator<string>;
 
-    // eslint-disable-next-line jsdoc/require-jsdoc
+    // eslint-disable-next-line jsdoc/require-jsdoc -- Implementation of overloaded signatures.
     createSerialized(value: number, serialComponent: string | Iterable<string>, sparse = false): string | IterableIterator<string> {
         return this.concatenateValidated(this.create(value, sparse), serialComponent);
     }
@@ -1709,7 +1687,7 @@ export class SerializableNumericIdentificationKeyCreator extends Mixin(Serializa
      */
     concatenate(baseIdentificationKey: string, serialComponents: Iterable<string>): IterableIterator<string>;
 
-    // eslint-disable-next-line jsdoc/require-jsdoc
+    // eslint-disable-next-line jsdoc/require-jsdoc -- Implementation of overloaded signatures.
     concatenate(baseIdentificationKey: string, serialComponent: string | Iterable<string>): string | IterableIterator<string> {
         this.validate(baseIdentificationKey);
 
@@ -1722,7 +1700,7 @@ export class SerializableNumericIdentificationKeyCreator extends Mixin(Serializa
  */
 export class NonNumericIdentificationKeyCreator extends Mixin(NonNumericIdentificationKeyValidator, AbstractIdentificationKeyCreator) {
     /**
-     * Reference character set validation parameters.
+     * Reference validation parameters.
      */
     private readonly _referenceValidation: CharacterSetValidation;
 
@@ -1782,7 +1760,7 @@ export class NonNumericIdentificationKeyCreator extends Mixin(NonNumericIdentifi
      */
     create(references: Iterable<string>): IterableIterator<string>;
 
-    // eslint-disable-next-line jsdoc/require-jsdoc
+    // eslint-disable-next-line jsdoc/require-jsdoc -- Implementation of overloaded signatures.
     create(referenceOrReferences: string | Iterable<string>): string | IterableIterator<string> {
         let result: string | IterableIterator<string>;
 
@@ -1800,6 +1778,26 @@ export class NonNumericIdentificationKeyCreator extends Mixin(NonNumericIdentifi
     }
 }
 
+/**
+ * Prefix validation parameters.
+ */
+interface PrefixValidation extends CharacterSetValidation {
+    /**
+     * Minimum length.
+     */
+    minimumLength: number;
+
+    /**
+     * Maximum length.
+     */
+    maximumLength: number;
+
+    /**
+     * Callback to localized prefix type name.
+     */
+    component: () => string;
+}
+
 /**
  * Prefix manager. This is the core class for identification key creation.
  *
@@ -1860,7 +1858,7 @@ export class PrefixManager {
     /**
      * Validation parameters for GS1 Company Prefix.
      */
-    private static readonly GS1_COMPANY_PREFIX_VALIDATION: CharacterSetValidation = {
+    private static readonly GS1_COMPANY_PREFIX_VALIDATION: PrefixValidation = {
         minimumLength: PrefixManager.GS1_COMPANY_PREFIX_MINIMUM_LENGTH,
         maximumLength: PrefixManager.GS1_COMPANY_PREFIX_MAXIMUM_LENGTH,
         component: () => i18next.t("Prefix.gs1CompanyPrefix", {
@@ -1871,7 +1869,7 @@ export class PrefixManager {
     /**
      * Validation parameters for U.P.C. Company Prefix expressed as GS1 Company Prefix.
      */
-    private static readonly UPC_COMPANY_PREFIX_AS_GS1_COMPANY_PREFIX_VALIDATION: CharacterSetValidation = {
+    private static readonly UPC_COMPANY_PREFIX_AS_GS1_COMPANY_PREFIX_VALIDATION: PrefixValidation = {
         minimumLength: PrefixManager.UPC_COMPANY_PREFIX_MINIMUM_LENGTH + 1,
         maximumLength: PrefixManager.UPC_COMPANY_PREFIX_MAXIMUM_LENGTH + 1,
         component: () => i18next.t("Prefix.gs1CompanyPrefix", {
@@ -1882,7 +1880,7 @@ export class PrefixManager {
     /**
      * Validation parameters for GS1-8 Prefix expressed as GS1 Company Prefix.
      */
-    private static readonly GS1_8_PREFIX_AS_GS1_COMPANY_PREFIX_VALIDATION: CharacterSetValidation = {
+    private static readonly GS1_8_PREFIX_AS_GS1_COMPANY_PREFIX_VALIDATION: PrefixValidation = {
         minimumLength: PrefixManager.GS1_8_PREFIX_MINIMUM_LENGTH + 5,
         maximumLength: PrefixManager.GS1_8_PREFIX_MAXIMUM_LENGTH + 5,
         component: () => i18next.t("Prefix.gs1CompanyPrefix", {
@@ -1893,7 +1891,7 @@ export class PrefixManager {
     /**
      * Validation parameters for U.P.C. Company Prefix.
      */
-    private static readonly UPC_COMPANY_PREFIX_VALIDATION: CharacterSetValidation = {
+    private static readonly UPC_COMPANY_PREFIX_VALIDATION: PrefixValidation = {
         minimumLength: PrefixManager.UPC_COMPANY_PREFIX_MINIMUM_LENGTH,
         maximumLength: PrefixManager.UPC_COMPANY_PREFIX_MAXIMUM_LENGTH,
         component: () => i18next.t("Prefix.upcCompanyPrefix", {
@@ -1904,7 +1902,7 @@ export class PrefixManager {
     /**
      * Validation parameters for GS1-8 Prefix.
      */
-    private static readonly GS1_8_PREFIX_VALIDATION: CharacterSetValidation = {
+    private static readonly GS1_8_PREFIX_VALIDATION: PrefixValidation = {
         minimumLength: PrefixManager.GS1_8_PREFIX_MINIMUM_LENGTH,
         maximumLength: PrefixManager.GS1_8_PREFIX_MAXIMUM_LENGTH,
         component: () => i18next.t("Prefix.gs18Prefix", {
@@ -1916,7 +1914,7 @@ export class PrefixManager {
      * Creator tweak factors. Different numeric identification key types have different tweak factors so that sparse
      * creation generates different sequences for each.
      */
-    private static readonly CREATOR_TWEAK_FACTORS_MAP = new Map<IdentificationKeyType, bigint>([
+    private static readonly CREATOR_TWEAK_FACTORS_MAP: ReadonlyMap<IdentificationKeyType, bigint> = new Map([
         [IdentificationKeyType.GTIN, 1987n],
         [IdentificationKeyType.GLN, 4241n],
         [IdentificationKeyType.SSCC, 8087n],
@@ -2058,9 +2056,9 @@ export class PrefixManager {
         if (this._tweakFactor !== tweakFactor) {
             this._tweakFactor = tweakFactor;
 
-            this._identificationKeyCreatorsMap.forEach((creator) => {
+            for (const creator of this._identificationKeyCreatorsMap.values()) {
                 this.setCreatorTweak(creator);
-            });
+            }
         }
     }
 
@@ -2138,7 +2136,7 @@ export class PrefixManager {
      * Position offset within a larger string.
      */
     static validatePrefix(prefixType: PrefixType, allowUPCCompanyPrefix: boolean, allowGS18Prefix: boolean, prefix: string, isFromIdentificationKey = false, isNumericIdentificationKey = false, positionOffset?: number): void {
-        let baseValidation: CharacterSetValidation;
+        let baseValidation: PrefixValidation;
 
         // Validate the prefix type and determine the prefix validation parameters.
         switch (prefixType) {
@@ -2189,7 +2187,7 @@ export class PrefixManager {
                 break;
         }
 
-        const mergedValidation: CharacterSetValidation = {
+        const mergedValidation: PrefixValidation = {
             ...baseValidation,
             positionOffset
         };
@@ -2199,8 +2197,7 @@ export class PrefixManager {
             NUMERIC_CREATOR.validate(prefix, mergedValidation);
         } else if (!isNumericIdentificationKey) {
             // Validate only the minimum length, allowing at least one character for the (possibly non-numeric) reference.
-            // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
-            NUMERIC_CREATOR.validate(prefix.substring(0, Math.min(mergedValidation.minimumLength!, prefix.length - 1)), mergedValidation);
+            NUMERIC_CREATOR.validate(prefix.substring(0, Math.min(mergedValidation.minimumLength, prefix.length - 1)), mergedValidation);
         }
     }
 
@@ -2230,6 +2227,8 @@ export class PrefixManager {
             creator = constructorCallback();
 
             this.setCreatorTweak(creator);
+
+            this._identificationKeyCreatorsMap.set(identificationKeyType, creator);
         }
 
         return creator;

package/src/locale/fr/locale_strings.ts

@@ -0,0 +1,34 @@
+export const localeStrings = {
+    Check: {
+        lengthOfStringForCheckCharacterPairMustBeLessThanOrEqualTo: "La longueur {{length}} de la chaîne pour la paire de caractères de vérification doit être inférieure ou égale à {{maximum Length}}"
+    },
+    IdentificationKey: {
+        identificationKeyTypeLength: "{{identificationKeyType}} doit comporter {{length}} chiffres",
+        invalidCheckDigit: "Chiffre de contrôle non valide",
+        invalidGTINLength: "Le GTIN doit comporter 13, 12, 8 ou 14 chiffres",
+        invalidGTIN14Length: "Le GTIN doit comporter 14 chiffres",
+        invalidZeroSuppressedGTIN12: "Code GTIN-12 non valide avec zéro supprimé",
+        invalidZeroSuppressibleGTIN12: "Le GTIN-12 ne peut pas être supprimé par zéro",
+        invalidZeroSuppressedGTIN12AsGTIN13: "GTIN-12 non valide avec zéro supprimé en tant que GTIN-13",
+        invalidZeroSuppressedGTIN12AsGTIN14: "GTIN-12 non valide avec zéro supprimé en tant que GTIN-14",
+        invalidGTIN13AtRetail: "Le GTIN-13 au niveau des articles de consommation au détail ne peut pas commencer par zéro",
+        invalidGTINAtRetail: "Le GTIN n'est pas pris en charge au niveau des articles de consommation au détail",
+        invalidGTINAtOtherThanRetail: "Le GTIN n'est pas pris en charge à d'autres niveaux que ceux des articles de consommation au détail",
+        indicatorDigit: "chiffre indicateur",
+        serialComponent: "composant série",
+        reference: "référence",
+        referenceCantBeAllNumeric: "La référence ne peut pas être entièrement numérique",
+        invalidCheckCharacterPair: "Paire de caractères de contrôle non valide"
+    },
+    Prefix: {
+        gs1CompanyPrefix: "Préfixe de l'entreprise GS1",
+        upcCompanyPrefix: "Préfixe de l'entreprise U.P.C.",
+        gs18Prefix: "Préfixe GS1-8",
+        gs1CompanyPrefixCantStartWith0: "Le préfixe de l'entreprise GS1 ne peut pas commencer par \"0\"",
+        gs1CompanyPrefixCantStartWith00000: "Le préfixe de l'entreprise GS1 ne peut pas commencer par \"00000\"",
+        gs1CompanyPrefixCantStartWith000000: "Le préfixe de l'entreprise GS1 ne peut pas commencer par \"000000\"",
+        upcCompanyPrefixCantStartWith0000: "Le préfixe de l'entreprise U.P.C. ne peut pas commencer par \"0000\"",
+        gs18PrefixCantStartWith0: "Le préfixe GS1-8 ne peut pas commencer par \"0\"",
+        identificationKeyTypeNotSupportedByGS18Prefix: "{{identificationKeyType}} non pris en charge par le préfixe GS1-8"
+    }
+} 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 gs1NS = "aidct_gs1";
 
+i18nAssertValidResources(enLocaleStrings, "fr", frLocaleStrings);
+
 i18nAddResourceBundle("en", gs1NS, enLocaleStrings);
+i18nAddResourceBundle("fr", gs1NS, frLocaleStrings);
 
 export default i18next;

package/src/locale/i18next.d.ts

@@ -1,6 +1,12 @@
 import type { localeStrings } from "./en/locale_strings.js";
 
+/**
+ * Internationalization module.
+ */
 declare module "i18next" {
+    /**
+     * Custom type options for this package.
+     */
     interface CustomTypeOptions {
         resources: {
             // Extract the type from the English locale strings object.

package/test/check.test.ts

@@ -40,48 +40,42 @@ describe("Check digit", () => {
 });
 
 describe("Price/weight check digit", () => {
-    // eslint-disable-next-line jsdoc/require-jsdoc
     function weight2Minus(characterIndex: number): number {
         const product = characterIndex * 2;
 
         return (product - Math.trunc(product / 10)) % 10;
     }
 
-    // eslint-disable-next-line jsdoc/require-jsdoc
     function weight3(characterIndex: number): number {
         return characterIndex * 3 % 10;
     }
 
-    // eslint-disable-next-line jsdoc/require-jsdoc
     function weight5Plus(characterIndex: number): number {
         const product = characterIndex * 5;
 
         return (product + Math.trunc(product / 10)) % 10;
     }
 
-    // eslint-disable-next-line jsdoc/require-jsdoc
     function weight5Minus(characterIndex: number): number {
         const product = characterIndex * 5;
 
         return (product - Math.trunc(product / 10)) % 10;
     }
 
-    // eslint-disable-next-line jsdoc/require-jsdoc
     function testFourDigitPriceWeightCheckDigit(s: string): void {
-        const characterIndexes = NUMERIC_CREATOR.characterIndexes(s);
+        // All character indexes are known to be defined.
+        const characterIndexes = NUMERIC_CREATOR.characterIndexes(s) as number[];
 
-        // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
-        const sum = weight2Minus(characterIndexes[0]!) + weight2Minus(characterIndexes[1]!) + weight3(characterIndexes[2]!) + weight5Minus(characterIndexes[3]!);
+        const sum = weight2Minus(characterIndexes[0]) + weight2Minus(characterIndexes[1]) + weight3(characterIndexes[2]) + weight5Minus(characterIndexes[3]);
 
         expect(fourDigitPriceWeightCheckDigit(s)).toBe(NUMERIC_CREATOR.character(sum * 3 % 10));
     }
 
-    // eslint-disable-next-line jsdoc/require-jsdoc
     function testFiveDigitPriceWeightCheckDigit(s: string): void {
-        const characterIndexes = NUMERIC_CREATOR.characterIndexes(s);
+        // All character indexes are known to be defined.
+        const characterIndexes = NUMERIC_CREATOR.characterIndexes(s) as number[];
 
-        // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
-        const sum = weight5Plus(characterIndexes[0]!) + weight2Minus(characterIndexes[1]!) + weight5Minus(characterIndexes[2]!) + weight5Plus(characterIndexes[3]!) + weight2Minus(characterIndexes[4]!);
+        const sum = weight5Plus(characterIndexes[0]) + weight2Minus(characterIndexes[1]) + weight5Minus(characterIndexes[2]) + weight5Plus(characterIndexes[3]) + weight2Minus(characterIndexes[4]);
 
         expect(weight5Minus(Number(fiveDigitPriceWeightCheckDigit(s)))).toBe(9 - (sum + 9) % 10);
     }

package/test/idkey.test.ts

@@ -17,7 +17,8 @@ import {
     GSRN_VALIDATOR,
     GTIN12_VALIDATOR,
     GTIN13_VALIDATOR,
-    GTIN8_VALIDATOR, GTIN_VALIDATORS,
+    GTIN8_VALIDATOR,
+    GTIN_VALIDATORS,
     GTINCreator,
     GTINLevel,
     GTINType,
@@ -42,7 +43,6 @@ import {
 
 await i18nInit(I18NEnvironment.CLI, true);
 
-// eslint-disable-next-line jsdoc/require-jsdoc
 function creatorFor(characterSet: CharacterSet): CharacterSetCreator {
     let creator: CharacterSetCreator;
 
@@ -63,14 +63,12 @@ function creatorFor(characterSet: CharacterSet): CharacterSetCreator {
     return creator;
 }
 
-// eslint-disable-next-line jsdoc/require-jsdoc
 function validateIdentificationKeyValidator(creator: IdentificationKeyValidator, identificationKeyType: IdentificationKeyType, prefixType: PrefixType, length: number): void {
     expect(creator.identificationKeyType).toBe(identificationKeyType);
     expect(creator.prefixType).toBe(prefixType);
     expect(creator.length).toBe(length);
 }
 
-// eslint-disable-next-line jsdoc/require-jsdoc
 function validateNumericIdentificationKeyValidator(validator: NumericIdentificationKeyValidator, isCreator: boolean, identificationKeyType: IdentificationKeyType, prefixType: PrefixType, length: number, leaderType: LeaderType): void {
     validateIdentificationKeyValidator(validator, identificationKeyType, prefixType, length);
 
@@ -83,7 +81,6 @@ function validateNumericIdentificationKeyValidator(validator: NumericIdentificat
     }
 }
 
-// eslint-disable-next-line jsdoc/require-jsdoc
 function validateGTINValidator(validator: GTINValidator, isCreator: boolean, gtinType: GTINType): void {
     let prefixType: PrefixType;
 
@@ -109,12 +106,10 @@ function validateGTINValidator(validator: GTINValidator, isCreator: boolean, gti
     expect(validator.gtinType).toBe(gtinType);
 }
 
-// eslint-disable-next-line jsdoc/require-jsdoc
 function validateNonGTINNumericIdentificationKeyValidator<T extends NonGTINNumericIdentificationKeyValidator>(validator: T, isCreator: boolean, identificationKeyType: IdentificationKeyType, length: number, leaderType: LeaderType): void {
     validateNumericIdentificationKeyValidator(validator, isCreator, identificationKeyType, PrefixType.GS1CompanyPrefix, length, leaderType);
 }
 
-// eslint-disable-next-line jsdoc/require-jsdoc
 function validateSerializableNumericIdentificationKeyValidator(validator: SerializableNumericIdentificationKeyValidator, isCreator: boolean, identificationKeyType: IdentificationKeyType, length: number, leaderType: LeaderType, serialLength: number, serialCharacterSet: CharacterSet): void {
     validateNonGTINNumericIdentificationKeyValidator(validator, isCreator, identificationKeyType, length, leaderType);
 
@@ -129,7 +124,6 @@ function validateSerializableNumericIdentificationKeyValidator(validator: Serial
     }
 }
 
-// eslint-disable-next-line jsdoc/require-jsdoc
 function validateNonNumericIdentificationKeyValidator(validator: NonNumericIdentificationKeyValidator, isCreator: boolean, identificationKeyType: IdentificationKeyType, length: number, referenceCharacterSet: CharacterSet, requiresCheckCharacterPair: boolean): void {
     validateIdentificationKeyValidator(validator, identificationKeyType, PrefixType.GS1CompanyPrefix, length);
 
@@ -169,7 +163,6 @@ describe("Validators", () => {
     });
 });
 
-// eslint-disable-next-line jsdoc/require-jsdoc
 function validateIdentificationKeyCreators(prefixManager: PrefixManager): void {
     let gtinType: GTINType;
 
@@ -190,9 +183,23 @@ function validateIdentificationKeyCreators(prefixManager: PrefixManager): void {
             break;
     }
 
+    expect(prefixManager.gtinCreator).toBe(prefixManager.gtinCreator);
+
     validateGTINValidator(prefixManager.gtinCreator, true, gtinType);
 
     if (prefixManager.prefixType !== PrefixType.GS18Prefix) {
+        expect(prefixManager.glnCreator).toBe(prefixManager.glnCreator);
+        expect(prefixManager.ssccCreator).toBe(prefixManager.ssccCreator);
+        expect(prefixManager.graiCreator).toBe(prefixManager.graiCreator);
+        expect(prefixManager.giaiCreator).toBe(prefixManager.giaiCreator);
+        expect(prefixManager.gsrnCreator).toBe(prefixManager.gsrnCreator);
+        expect(prefixManager.gdtiCreator).toBe(prefixManager.gdtiCreator);
+        expect(prefixManager.gincCreator).toBe(prefixManager.gincCreator);
+        expect(prefixManager.gsinCreator).toBe(prefixManager.gsinCreator);
+        expect(prefixManager.gcnCreator).toBe(prefixManager.gcnCreator);
+        expect(prefixManager.cpidCreator).toBe(prefixManager.cpidCreator);
+        expect(prefixManager.gmnCreator).toBe(prefixManager.gmnCreator);
+
         validateNonGTINNumericIdentificationKeyValidator(prefixManager.glnCreator, true, IdentificationKeyType.GLN, 13, LeaderType.None);
         validateNonGTINNumericIdentificationKeyValidator(prefixManager.ssccCreator, true, IdentificationKeyType.SSCC, 18, LeaderType.ExtensionDigit);
         validateSerializableNumericIdentificationKeyValidator(prefixManager.graiCreator, true, IdentificationKeyType.GRAI, 13, LeaderType.None, 16, CharacterSet.AI82);
@@ -222,7 +229,6 @@ function validateIdentificationKeyCreators(prefixManager: PrefixManager): void {
 describe("Prefix manager", () => {
     let prefixManager: PrefixManager;
 
-    // eslint-disable-next-line jsdoc/require-jsdoc
     function validateGTINStartsWithPrefix(length: number): void {
         expect(prefixManager.gtinCreator.length).toBe(length);
 
@@ -237,7 +243,6 @@ describe("Prefix manager", () => {
         expect(gtin14.length).toBe(14);
     }
 
-    // eslint-disable-next-line jsdoc/require-jsdoc
     function validateNonGTINStartsWithGS1CompanyPrefix(): void {
         const gln = prefixManager.glnCreator.create(0);
 
@@ -383,14 +388,12 @@ describe("Sparse creation", () => {
     prefixManager.resetTweakFactor();
 });
 
-// eslint-disable-next-line jsdoc/require-jsdoc
 function testIdentificationKeyCreatorCallback(callback?: () => void): void {
     if (callback !== undefined) {
         callback();
     }
 }
 
-// eslint-disable-next-line jsdoc/require-jsdoc
 function testNumericIdentificationKeyCreator(creator: NumericIdentificationKeyCreator, preTestCallback?: () => void, postTestCallback?: () => void): void {
     describe(creator.identificationKeyType === IdentificationKeyType.GTIN ? `${creator.identificationKeyType}-${creator.length}` : creator.identificationKeyType, () => {
         testIdentificationKeyCreatorCallback(preTestCallback);
@@ -405,7 +408,6 @@ function testNumericIdentificationKeyCreator(creator: NumericIdentificationKeyCr
         const referenceSubstringStart = prefixSubstringEnd;
         const referenceSubstringEnd = referenceSubstringStart + referenceLength - prefixSubstringStart;
 
-        // eslint-disable-next-line jsdoc/require-jsdoc
         function validate(identificationKey: string, index: number, sparse: boolean): void {
             expect(() => {
                 creator.validate(identificationKey);
@@ -505,11 +507,18 @@ function testNumericIdentificationKeyCreator(creator: NumericIdentificationKeyCr
             }).toThrow("Invalid character 'O' at position 3");
         });
 
+        test("Position offset", () => {
+            expect(() => {
+                creator.validate(creator.create(0), {
+                    positionOffset: 4
+                });
+            }).not.toThrow(RangeError);
+        });
+
         testIdentificationKeyCreatorCallback(postTestCallback);
     });
 }
 
-// eslint-disable-next-line jsdoc/require-jsdoc
 function testGTINCreator(creator: GTINCreator): void {
     testNumericIdentificationKeyCreator(creator, () => {
         test("Length", () => {
@@ -538,7 +547,6 @@ function testGTINCreator(creator: GTINCreator): void {
         const referenceSubstringStart = prefixSubstringEnd;
         const referenceSubstringEnd = referenceSubstringStart + referenceLength;
 
-        // eslint-disable-next-line jsdoc/require-jsdoc
         function validate(gtin: string, index: number, sparse: boolean): void {
             expect(() => {
                 GTINCreator.validateGTIN14(gtin);
@@ -746,7 +754,6 @@ function testGTINCreator(creator: GTINCreator): void {
     });
 }
 
-// eslint-disable-next-line jsdoc/require-jsdoc
 function testGTINValidationAndNormalization(): void {
     describe("GTIN validation and normalization", () => {
         test("Validation", () => {
@@ -861,12 +868,10 @@ function testGTINValidationAndNormalization(): void {
     });
 }
 
-// eslint-disable-next-line jsdoc/require-jsdoc
 function testNonGTINNumericIdentificationKeyCreator(creator: NonGTINNumericIdentificationKeyCreator, preTestCallback?: () => void, postTestCallback?: () => void): void {
     testNumericIdentificationKeyCreator(creator, preTestCallback, postTestCallback);
 }
 
-// eslint-disable-next-line jsdoc/require-jsdoc
 function testSerializableNumericIdentificationKeyCreator(creator: SerializableNumericIdentificationKeyCreator): void {
     testNonGTINNumericIdentificationKeyCreator(creator, undefined, () => {
         test("Serialization", () => {
@@ -922,7 +927,6 @@ function testSerializableNumericIdentificationKeyCreator(creator: SerializableNu
 
 const TEST_REFERENCE_LENGTH = 2;
 
-// eslint-disable-next-line jsdoc/require-jsdoc
 function testNonNumericIdentificationKeyCreator<T extends NonNumericIdentificationKeyCreator>(creator: T): void {
     describe(creator.identificationKeyType, () => {
         const prefix = creator.prefix;
@@ -983,6 +987,14 @@ function testNonNumericIdentificationKeyCreator<T extends NonNumericIdentificati
             expect(sequenceCount).toBe(referenceCount);
         });
 
+        test("Position offset", () => {
+            expect(() => {
+                creator.validate(creator.create("ABC123"), {
+                    positionOffset: 4
+                });
+            }).not.toThrow(RangeError);
+        });
+
         test("Not all numeric", () => {
             expect(() => {
                 creator.validate(creator.create("01234"), {