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

package/dist/index.js

@@ -1,9 +1,13 @@
 // src/locale/i18n.ts
-import { i18nAddResourceBundle, i18nAssertValidResources, i18next } from "@aidc-toolkit/core";
+import { i18nAssertValidResources, i18nCoreInit } from "@aidc-toolkit/core";
+import { i18nUtilityInit, utilityResources } from "@aidc-toolkit/utility";
+import i18next from "i18next";
 
-// src/locale/en/locale_strings.ts
+// src/locale/en/locale-strings.ts
 var localeStrings = {
   Check: {
+    lengthOfStringForPriceOrWeightMustBeExactly: "Length {{length}} of string for price or weight sum must be exactly {{exactLength}}",
+    priceOrWeightComponent: "price or weight",
     lengthOfStringForCheckCharacterPairMustBeLessThanOrEqualTo: "Length {{length}} of string for check character pair must be less than or equal to {{maximumLength}}"
   },
   IdentificationKey: {
@@ -37,9 +41,11 @@ var localeStrings = {
   }
 };
 
-// src/locale/fr/locale_strings.ts
+// src/locale/fr/locale-strings.ts
 var localeStrings2 = {
   Check: {
+    lengthOfStringForPriceOrWeightMustBeExactly: "La longueur {{longueur}} de la cha\xEEne pour le prix ou la somme du poids doit \xEAtre exactement {{exactLength}}",
+    priceOrWeightComponent: "prix ou poids",
     lengthOfStringForCheckCharacterPairMustBeLessThanOrEqualTo: "La longueur {{length}} de la cha\xEEne pour la paire de caract\xE8res de v\xE9rification doit \xEAtre inf\xE9rieure ou \xE9gale \xE0 {{maximum Length}}"
   },
   IdentificationKey: {
@@ -76,11 +82,21 @@ var localeStrings2 = {
 // src/locale/i18n.ts
 var gs1NS = "aidct_gs1";
 i18nAssertValidResources(localeStrings, "fr", localeStrings2);
-i18nAddResourceBundle("en", gs1NS, localeStrings);
-i18nAddResourceBundle("fr", gs1NS, localeStrings2);
-var i18n_default = i18next;
+var gs1Resources = {
+  en: {
+    aidct_gs1: localeStrings
+  },
+  fr: {
+    aidct_gs1: localeStrings2
+  }
+};
+var i18nextGS1 = i18next.createInstance();
+async function i18nGS1Init(environment, debug = false) {
+  await i18nUtilityInit(environment, debug);
+  await i18nCoreInit(i18nextGS1, environment, debug, gs1NS, utilityResources, gs1Resources);
+}
 
-// src/character_set.ts
+// src/character-set.ts
 import { CharacterSetCreator, Exclusion } from "@aidc-toolkit/utility";
 var AI82_CREATOR = new CharacterSetCreator([
   "!",
@@ -209,7 +225,7 @@ var AI39_CREATOR = new CharacterSetCreator([
 ], Exclusion.AllNumeric);
 
 // src/check.ts
-import { NUMERIC_CREATOR } from "@aidc-toolkit/utility";
+import { NUMERIC_CREATOR, utilityNS } from "@aidc-toolkit/utility";
 var THREE_WEIGHT_RESULTS = [
   0,
   3,
@@ -274,7 +290,11 @@ function checkDigitSum(exchangeWeights, s) {
   let weight3 = (s.length + Number(exchangeWeights)) % 2 === 0;
   return NUMERIC_CREATOR.characterIndexes(s).reduce((accumulator, characterIndex, index) => {
     if (characterIndex === void 0) {
-      throw new RangeError(`Invalid character '${s.charAt(index)}' at position ${index + 1}`);
+      throw new RangeError(i18nextGS1.t("CharacterSetValidator.invalidCharacterAtPosition", {
+        ns: utilityNS,
+        c: s.charAt(index),
+        position: index + 1
+      }));
     }
     weight3 = !weight3;
     return accumulator + (weight3 ? THREE_WEIGHT_RESULTS[characterIndex] : characterIndex);
@@ -288,12 +308,20 @@ function hasValidCheckDigit(s) {
 }
 function priceWeightSum(weightsResults, s) {
   if (s.length !== weightsResults.length) {
-    throw new RangeError(`String for price or weight sum must be exactly ${weightsResults.length} characters`);
+    throw new RangeError(i18nextGS1.t("Check.lengthOfStringForPriceOrWeightMustBeExactly", {
+      length: s.length,
+      exactLength: weightsResults.length
+    }));
   }
   const characterIndexes = NUMERIC_CREATOR.characterIndexes(s);
   return characterIndexes.reduce((accumulator, characterIndex, index) => {
     if (characterIndex === void 0) {
-      throw new RangeError(`Invalid character '${s.charAt(index)}' at position ${index + 1}`);
+      throw new RangeError(i18nextGS1.t("CharacterSetValidator.invalidCharacterAtPositionOfComponent", {
+        ns: utilityNS,
+        c: s.charAt(index),
+        position: index + 1,
+        component: i18nextGS1.t("Check.priceOrWeightComponent")
+      }));
     }
     return accumulator + weightsResults[index][characterIndex];
   }, 0);
@@ -371,15 +399,18 @@ var CHECK_CHARACTERS = [
 function checkCharacterPair(s) {
   const weightIndexStart = CHECK_CHARACTER_WEIGHTS.length - s.length;
   if (weightIndexStart < 0) {
-    throw new RangeError(i18n_default.t("Check.lengthOfStringForCheckCharacterPairMustBeLessThanOrEqualTo", {
-      ns: gs1NS,
+    throw new RangeError(i18nextGS1.t("Check.lengthOfStringForCheckCharacterPairMustBeLessThanOrEqualTo", {
       length: s.length,
       maximumLength: CHECK_CHARACTER_WEIGHTS.length
     }));
   }
   const checkCharacterPairSum = AI82_CREATOR.characterIndexes(s).reduce((accumulator, characterIndex, index) => {
     if (characterIndex === void 0) {
-      throw new RangeError(`Invalid character '${s.charAt(index)}' at position ${index + 1}`);
+      throw new RangeError(i18nextGS1.t("CharacterSetValidator.invalidCharacterAtPosition", {
+        ns: utilityNS,
+        c: s.charAt(index),
+        position: index + 1
+      }));
     }
     return accumulator + characterIndex * CHECK_CHARACTER_WEIGHTS[weightIndexStart + index];
   }, 0) % 1021;
@@ -395,9 +426,9 @@ function hasValidCheckCharacterPair(s) {
 import {
   CharacterSetCreator as CharacterSetCreator2,
   Exclusion as Exclusion2,
-  IteratorProxy,
   NUMERIC_CREATOR as NUMERIC_CREATOR2,
-  RegExpValidator
+  RegExpValidator,
+  transformIterable
 } from "@aidc-toolkit/utility";
 import { Mixin } from "ts-mixer";
 var IdentificationKeyType = /* @__PURE__ */ ((IdentificationKeyType2) => {
@@ -597,16 +628,13 @@ var AbstractNumericIdentificationKeyValidator = class extends AbstractIdentifica
       super.validatePrefix(identificationKey.substring(this._prefixPosition), validation?.positionOffset === void 0 ? this._prefixPosition : validation.positionOffset + this._prefixPosition);
     }
     if (identificationKey.length !== this.length) {
-      throw new RangeError(i18n_default.t("IdentificationKey.identificationKeyTypeLength", {
-        ns: gs1NS,
+      throw new RangeError(i18nextGS1.t("IdentificationKey.identificationKeyTypeLength", {
         identificationKeyType: this.identificationKeyType,
         length: this.length
       }));
     }
     if (!hasValidCheckDigit(this.padIdentificationKey(identificationKey, validation))) {
-      throw new RangeError(i18n_default.t("IdentificationKey.invalidCheckDigit", {
-        ns: gs1NS
-      }));
+      throw new RangeError(i18nextGS1.t("IdentificationKey.invalidCheckDigit"));
     }
   }
 };
@@ -691,9 +719,7 @@ var GTINValidator = class _GTINValidator extends AbstractNumericIdentificationKe
       }
     }
     if (gtin12 === void 0) {
-      throw new RangeError(i18n_default.t("IdentificationKey.invalidZeroSuppressedGTIN12", {
-        ns: gs1NS
-      }));
+      throw new RangeError(i18nextGS1.t("IdentificationKey.invalidZeroSuppressedGTIN12"));
     }
     GTIN12_VALIDATOR.validate(gtin12);
     return gtin12;
@@ -713,9 +739,7 @@ var GTINValidator = class _GTINValidator extends AbstractNumericIdentificationKe
     switch (gtin.length) {
       case 13 /* GTIN13 */:
         if (gtin.startsWith("0")) {
-          throw new RangeError(i18n_default.t("IdentificationKey.invalidGTIN13AtRetail", {
-            ns: gs1NS
-          }));
+          throw new RangeError(i18nextGS1.t("IdentificationKey.invalidGTIN13AtRetail"));
         }
         PrefixManager.validatePrefix(0 /* GS1CompanyPrefix */, false, false, gtin, true, true);
         gtinLevelRestriction = 0 /* Any */;
@@ -737,19 +761,13 @@ var GTINValidator = class _GTINValidator extends AbstractNumericIdentificationKe
         gtinLevelRestriction = 2 /* OtherThanRetailConsumer */;
         break;
       default:
-        throw new RangeError(i18n_default.t("IdentificationKey.invalidGTINLength", {
-          ns: gs1NS
-        }));
+        throw new RangeError(i18nextGS1.t("IdentificationKey.invalidGTINLength"));
     }
     if (!hasValidCheckDigit(lengthValidatedGTIN)) {
-      throw new RangeError(i18n_default.t("IdentificationKey.invalidCheckDigit", {
-        ns: gs1NS
-      }));
+      throw new RangeError(i18nextGS1.t("IdentificationKey.invalidCheckDigit"));
     }
     if (gtinLevel !== 0 /* Any */ && gtinLevelRestriction !== 0 /* Any */ && gtinLevelRestriction !== gtinLevel) {
-      throw new RangeError(i18n_default.t(gtinLevel === 1 /* RetailConsumer */ ? "IdentificationKey.invalidGTINAtRetail" : "IdentificationKey.invalidGTINAtOtherThanRetail", {
-        ns: gs1NS
-      }));
+      throw new RangeError(i18nextGS1.t(gtinLevel === 1 /* RetailConsumer */ ? "IdentificationKey.invalidGTINAtRetail" : "IdentificationKey.invalidGTINAtOtherThanRetail"));
     }
   }
   /**
@@ -760,9 +778,7 @@ var GTINValidator = class _GTINValidator extends AbstractNumericIdentificationKe
    */
   static validateGTIN14(gtin14) {
     if (gtin14.length !== 14 /* GTIN14 */) {
-      throw new RangeError(i18n_default.t("IdentificationKey.invalidGTIN14Length", {
-        ns: gs1NS
-      }));
+      throw new RangeError(i18nextGS1.t("IdentificationKey.invalidGTIN14Length"));
     }
     GTINCreator.validateAny(gtin14);
   }
@@ -823,9 +839,7 @@ var SerializableNumericIdentificationKeyValidator = class _SerializableNumericId
     this._serialComponentValidation = {
       minimumLength: 1,
       maximumLength: serialComponentLength,
-      component: () => i18n_default.t("IdentificationKey.serialComponent", {
-        ns: gs1NS
-      })
+      component: () => i18nextGS1.t("IdentificationKey.serialComponent")
     };
     this._serialComponentCreator = _SerializableNumericIdentificationKeyValidator.creatorFor(serialComponentCharacterSet);
   }
@@ -872,9 +886,7 @@ var NonNumericIdentificationKeyValidator = class _NonNumericIdentificationKeyVal
      * @inheritDoc
      */
     createErrorMessage(_s) {
-      return i18n_default.t("IdentificationKey.referenceCantBeAllNumeric", {
-        ns: gs1NS
-      });
+      return i18nextGS1.t("IdentificationKey.referenceCantBeAllNumeric");
     }
   }(/\D/);
   /**
@@ -924,9 +936,7 @@ var NonNumericIdentificationKeyValidator = class _NonNumericIdentificationKeyVal
         positionOffset: validation?.positionOffset
       });
     } else if (!hasValidCheckCharacterPair(this.padIdentificationKey(identificationKey, validation))) {
-      throw new RangeError(i18n_default.t("IdentificationKey.invalidCheckCharacterPair", {
-        ns: gs1NS
-      }));
+      throw new RangeError(i18nextGS1.t("IdentificationKey.invalidCheckCharacterPair"));
     }
     if (validation?.exclusion === Exclusion2.AllNumeric) {
       _NonNumericIdentificationKeyValidator.NOT_ALL_NUMERIC_VALIDATOR.validate(partialIdentificationKey);
@@ -1104,9 +1114,14 @@ var AbstractNumericIdentificationKeyCreator = class _AbstractNumericIdentificati
   createAll() {
     const hasExtensionDigit = this.leaderType === 2 /* ExtensionDigit */;
     const prefix = this.prefix;
+    const length = this.length;
     const referenceLength = this.referenceLength;
     const startWeight = 3 - 2 * ((referenceLength + 1 - Number(hasExtensionDigit)) % 2);
-    return _AbstractNumericIdentificationKeyCreator.createAllPartial(prefix, referenceLength, hasExtensionDigit ? 3 - 2 * this.length % 2 : 0, startWeight, checkDigitSum(startWeight === 3, prefix));
+    return {
+      [Symbol.iterator]() {
+        return _AbstractNumericIdentificationKeyCreator.createAllPartial(prefix, referenceLength, hasExtensionDigit ? 3 - 2 * length % 2 : 0, startWeight, checkDigitSum(startWeight === 3, prefix));
+      }
+    };
   }
 };
 var GTINCreator = class _GTINCreator extends Mixin(GTINValidator, AbstractNumericIdentificationKeyCreator) {
@@ -1116,9 +1131,7 @@ var GTINCreator = class _GTINCreator extends Mixin(GTINValidator, AbstractNumeri
   static REQUIRED_INDICATOR_DIGIT_VALIDATION = {
     minimumLength: 1,
     maximumLength: 1,
-    component: () => i18n_default.t("IdentificationKey.indicatorDigit", {
-      ns: gs1NS
-    })
+    component: () => i18nextGS1.t("IdentificationKey.indicatorDigit")
   };
   /**
    * Validation parameters for optional indicator digit.
@@ -1126,9 +1139,7 @@ var GTINCreator = class _GTINCreator extends Mixin(GTINValidator, AbstractNumeri
   static OPTIONAL_INDICATOR_DIGIT_VALIDATION = {
     minimumLength: 0,
     maximumLength: 1,
-    component: () => i18n_default.t("IdentificationKey.indicatorDigit", {
-      ns: gs1NS
-    })
+    component: () => i18nextGS1.t("IdentificationKey.indicatorDigit")
   };
   /**
    * Constructor. Called internally by {@link PrefixManager.gtinCreator}; should not be called by other code.
@@ -1197,9 +1208,7 @@ var GTINCreator = class _GTINCreator extends Mixin(GTINValidator, AbstractNumeri
       }
     }
     if (zeroSuppressedGTIN12 === void 0) {
-      throw new RangeError(i18n_default.t("IdentificationKey.invalidZeroSuppressibleGTIN12", {
-        ns: gs1NS
-      }));
+      throw new RangeError(i18nextGS1.t("IdentificationKey.invalidZeroSuppressibleGTIN12"));
     }
     return zeroSuppressedGTIN12;
   }
@@ -1251,9 +1260,7 @@ var GTINCreator = class _GTINCreator extends Mixin(GTINValidator, AbstractNumeri
         } else if (!gtin.startsWith("000000")) {
           normalizedGTIN = gtin.substring(5);
         } else {
-          throw new RangeError(i18n_default.t("IdentificationKey.invalidZeroSuppressedGTIN12AsGTIN13", {
-            ns: gs1NS
-          }));
+          throw new RangeError(i18nextGS1.t("IdentificationKey.invalidZeroSuppressedGTIN12AsGTIN13"));
         }
         break;
       case 12 /* GTIN12 */:
@@ -1276,15 +1283,11 @@ var GTINCreator = class _GTINCreator extends Mixin(GTINValidator, AbstractNumeri
         } else if (!gtin.startsWith("0000000")) {
           normalizedGTIN = gtin.substring(6);
         } else {
-          throw new RangeError(i18n_default.t("IdentificationKey.invalidZeroSuppressedGTIN12AsGTIN14", {
-            ns: gs1NS
-          }));
+          throw new RangeError(i18nextGS1.t("IdentificationKey.invalidZeroSuppressedGTIN12AsGTIN14"));
         }
         break;
       default:
-        throw new RangeError(i18n_default.t("IdentificationKey.invalidGTINLength", {
-          ns: gs1NS
-        }));
+        throw new RangeError(i18nextGS1.t("IdentificationKey.invalidGTINLength"));
     }
     _GTINCreator.validateAny(normalizedGTIN);
     return normalizedGTIN;
@@ -1359,7 +1362,7 @@ var SerializableNumericIdentificationKeyCreator = class extends Mixin(Serializab
     if (typeof serialComponentOrComponents !== "object") {
       result = validateAndConcatenate(serialComponentOrComponents);
     } else {
-      result = IteratorProxy.from(serialComponentOrComponents).map(validateAndConcatenate);
+      result = transformIterable(serialComponentOrComponents, validateAndConcatenate);
     }
     return result;
   }
@@ -1430,9 +1433,7 @@ var NonNumericIdentificationKeyCreator = class extends Mixin(NonNumericIdentific
       minimumLength: 1,
       // Maximum reference length has to account for prefix and check character pair.
       maximumLength: this.referenceLength,
-      component: () => i18n_default.t("IdentificationKey.reference", {
-        ns: gs1NS
-      })
+      component: () => i18nextGS1.t("IdentificationKey.reference")
     };
   }
   /**
@@ -1464,7 +1465,7 @@ var NonNumericIdentificationKeyCreator = class extends Mixin(NonNumericIdentific
     if (typeof referenceOrReferences !== "object") {
       result = validateAndCreate(referenceOrReferences);
     } else {
-      result = IteratorProxy.from(referenceOrReferences).map(validateAndCreate);
+      result = transformIterable(referenceOrReferences, validateAndCreate);
     }
     return result;
   }
@@ -1504,9 +1505,7 @@ var PrefixManager = class _PrefixManager {
   static GS1_COMPANY_PREFIX_VALIDATION = {
     minimumLength: _PrefixManager.GS1_COMPANY_PREFIX_MINIMUM_LENGTH,
     maximumLength: _PrefixManager.GS1_COMPANY_PREFIX_MAXIMUM_LENGTH,
-    component: () => i18n_default.t("Prefix.gs1CompanyPrefix", {
-      ns: gs1NS
-    })
+    component: () => i18nextGS1.t("Prefix.gs1CompanyPrefix")
   };
   /**
    * Validation parameters for U.P.C. Company Prefix expressed as GS1 Company Prefix.
@@ -1514,9 +1513,7 @@ var PrefixManager = class _PrefixManager {
   static UPC_COMPANY_PREFIX_AS_GS1_COMPANY_PREFIX_VALIDATION = {
     minimumLength: _PrefixManager.UPC_COMPANY_PREFIX_MINIMUM_LENGTH + 1,
     maximumLength: _PrefixManager.UPC_COMPANY_PREFIX_MAXIMUM_LENGTH + 1,
-    component: () => i18n_default.t("Prefix.gs1CompanyPrefix", {
-      ns: gs1NS
-    })
+    component: () => i18nextGS1.t("Prefix.gs1CompanyPrefix")
   };
   /**
    * Validation parameters for GS1-8 Prefix expressed as GS1 Company Prefix.
@@ -1524,9 +1521,7 @@ var PrefixManager = class _PrefixManager {
   static GS1_8_PREFIX_AS_GS1_COMPANY_PREFIX_VALIDATION = {
     minimumLength: _PrefixManager.GS1_8_PREFIX_MINIMUM_LENGTH + 5,
     maximumLength: _PrefixManager.GS1_8_PREFIX_MAXIMUM_LENGTH + 5,
-    component: () => i18n_default.t("Prefix.gs1CompanyPrefix", {
-      ns: gs1NS
-    })
+    component: () => i18nextGS1.t("Prefix.gs1CompanyPrefix")
   };
   /**
    * Validation parameters for U.P.C. Company Prefix.
@@ -1534,9 +1529,7 @@ var PrefixManager = class _PrefixManager {
   static UPC_COMPANY_PREFIX_VALIDATION = {
     minimumLength: _PrefixManager.UPC_COMPANY_PREFIX_MINIMUM_LENGTH,
     maximumLength: _PrefixManager.UPC_COMPANY_PREFIX_MAXIMUM_LENGTH,
-    component: () => i18n_default.t("Prefix.upcCompanyPrefix", {
-      ns: gs1NS
-    })
+    component: () => i18nextGS1.t("Prefix.upcCompanyPrefix")
   };
   /**
    * Validation parameters for GS1-8 Prefix.
@@ -1544,9 +1537,7 @@ var PrefixManager = class _PrefixManager {
   static GS1_8_PREFIX_VALIDATION = {
     minimumLength: _PrefixManager.GS1_8_PREFIX_MINIMUM_LENGTH,
     maximumLength: _PrefixManager.GS1_8_PREFIX_MAXIMUM_LENGTH,
-    component: () => i18n_default.t("Prefix.gs18Prefix", {
-      ns: gs1NS
-    })
+    component: () => i18nextGS1.t("Prefix.gs18Prefix")
   };
   /**
    * Creator tweak factors. Different numeric identification key types have different tweak factors so that sparse
@@ -1746,37 +1737,27 @@ var PrefixManager = class _PrefixManager {
           baseValidation = _PrefixManager.GS1_COMPANY_PREFIX_VALIDATION;
         } else if (!prefix.startsWith("00000")) {
           if (!allowUPCCompanyPrefix) {
-            throw new RangeError(i18n_default.t("Prefix.gs1CompanyPrefixCantStartWith0", {
-              ns: gs1NS
-            }));
+            throw new RangeError(i18nextGS1.t("Prefix.gs1CompanyPrefixCantStartWith0"));
           }
           baseValidation = _PrefixManager.UPC_COMPANY_PREFIX_AS_GS1_COMPANY_PREFIX_VALIDATION;
         } else if (!prefix.startsWith("000000")) {
           if (!allowGS18Prefix) {
-            throw new RangeError(i18n_default.t("Prefix.gs1CompanyPrefixCantStartWith00000", {
-              ns: gs1NS
-            }));
+            throw new RangeError(i18nextGS1.t("Prefix.gs1CompanyPrefixCantStartWith00000"));
           }
           baseValidation = _PrefixManager.GS1_8_PREFIX_AS_GS1_COMPANY_PREFIX_VALIDATION;
         } else {
-          throw new RangeError(i18n_default.t("Prefix.gs1CompanyPrefixCantStartWith000000", {
-            ns: gs1NS
-          }));
+          throw new RangeError(i18nextGS1.t("Prefix.gs1CompanyPrefixCantStartWith000000"));
         }
         break;
       case 1 /* UPCCompanyPrefix */:
         if (prefix.startsWith("0000")) {
-          throw new RangeError(i18n_default.t("Prefix.upcCompanyPrefixCantStartWith0000", {
-            ns: gs1NS
-          }));
+          throw new RangeError(i18nextGS1.t("Prefix.upcCompanyPrefixCantStartWith0000"));
         }
         baseValidation = _PrefixManager.UPC_COMPANY_PREFIX_VALIDATION;
         break;
       case 2 /* GS18Prefix */:
         if (prefix.startsWith("0")) {
-          throw new RangeError(i18n_default.t("Prefix.gs18PrefixCantStartWith0", {
-            ns: gs1NS
-          }));
+          throw new RangeError(i18nextGS1.t("Prefix.gs18PrefixCantStartWith0"));
         }
         baseValidation = _PrefixManager.GS1_8_PREFIX_VALIDATION;
         break;
@@ -1807,8 +1788,7 @@ var PrefixManager = class _PrefixManager {
     let creator = this._identificationKeyCreatorsMap.get(identificationKeyType);
     if (creator === void 0) {
       if (this.prefixType === 2 /* GS18Prefix */ && identificationKeyType !== "GTIN" /* GTIN */) {
-        throw new RangeError(i18n_default.t("Prefix.identificationKeyTypeNotSupportedByGS18Prefix", {
-          ns: gs1NS,
+        throw new RangeError(i18nextGS1.t("Prefix.identificationKeyTypeNotSupportedByGS18Prefix", {
           identificationKeyType
         }));
       }
@@ -1980,6 +1960,25 @@ export {
   fiveDigitPriceWeightCheckDigit,
   fourDigitPriceWeightCheckDigit,
   gs1NS,
+  gs1Resources,
   hasValidCheckCharacterPair,
-  hasValidCheckDigit
+  hasValidCheckDigit,
+  i18nGS1Init,
+  i18nextGS1
 };
+/*!
+ * Copyright © 2024-2025 Dolphin Data Development Ltd. and AIDC Toolkit
+ * contributors
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aidc-toolkit/gs1",
-  "version": "0.9.7-beta",
+  "version": "0.9.9-beta",
   "description": "GS1 AIDC Toolkit",
   "type": "module",
   "main": "dist/index.js",
@@ -20,22 +20,23 @@
   },
   "scripts": {
     "lint": "eslint .",
-    "build": "tsup src/index.ts --clean --format cjs,esm --dts",
-    "build-doc": "npm run build && tsc src/index.ts --outDir dist --target esnext --moduleResolution nodenext --module nodenext --emitDeclarationOnly --declaration --declarationMap",
+    "build-dist": "tsup src/index.ts --clean --format cjs,esm --dts",
+    "build-doc": "npm run build-dist && tsc src/index.ts --outDir dist --target esnext --moduleResolution nodenext --module nodenext --emitDeclarationOnly --declaration --declarationMap",
     "test": "vitest run"
   },
   "devDependencies": {
-    "@aidc-toolkit/dev": "^0.9.7-beta",
-    "eslint": "^9.16.0",
+    "@aidc-toolkit/dev": "^0.9.9-beta",
+    "eslint": "^9.17.0",
     "ts-node": "^10.9.2",
     "tsup": "^8.3.5",
     "typescript": "^5.7.2",
     "vitest": "^2.1.8"
   },
   "dependencies": {
-    "@aidc-toolkit/core": "^0.9.7-beta",
-    "@aidc-toolkit/utility": "^0.9.7-beta",
-    "@rollup/rollup-linux-x64-gnu": "^4.28.1",
+    "@aidc-toolkit/core": "^0.9.9-beta",
+    "@aidc-toolkit/utility": "^0.9.9-beta",
+    "@rollup/rollup-linux-x64-gnu": "^4.29.1",
+    "i18next": "^24.2.0",
     "ts-mixer": "^6.0.4"
   }
 }

package/src/check.ts

@@ -1,6 +1,6 @@
-import { NUMERIC_CREATOR } from "@aidc-toolkit/utility";
-import { AI82_CREATOR } from "./character_set.js";
-import i18next, { gs1NS } from "./locale/i18n.js";
+import { NUMERIC_CREATOR, utilityNS } from "@aidc-toolkit/utility";
+import { AI82_CREATOR } from "./character-set.js";
+import { i18nextGS1 } from "./locale/i18n.js";
 
 /**
  * Results of multiplying digits by 3.
@@ -57,7 +57,11 @@ export function checkDigitSum(exchangeWeights: boolean, s: string): number {
     // Calculate sum of each character value multiplied by the weight at its position.
     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}`);
+            throw new RangeError(i18nextGS1.t("CharacterSetValidator.invalidCharacterAtPosition", {
+                ns: utilityNS,
+                c: s.charAt(index),
+                position: index + 1
+            }));
         }
 
         weight3 = !weight3;
@@ -109,7 +113,10 @@ export function hasValidCheckDigit(s: string): boolean {
  */
 function priceWeightSum(weightsResults: ReadonlyArray<readonly number[]>, s: string): number {
     if (s.length !== weightsResults.length) {
-        throw new RangeError(`String for price or weight sum must be exactly ${weightsResults.length} characters`);
+        throw new RangeError(i18nextGS1.t("Check.lengthOfStringForPriceOrWeightMustBeExactly", {
+            length: s.length,
+            exactLength: weightsResults.length
+        }));
     }
 
     // The value of each character is its index in the character set.
@@ -118,7 +125,12 @@ function priceWeightSum(weightsResults: ReadonlyArray<readonly number[]>, s: str
     // Calculate sum of each weight result for each digit at its position.
     return characterIndexes.reduce<number>((accumulator, characterIndex, index) => {
         if (characterIndex === undefined) {
-            throw new RangeError(`Invalid character '${s.charAt(index)}' at position ${index + 1}`);
+            throw new RangeError(i18nextGS1.t("CharacterSetValidator.invalidCharacterAtPositionOfComponent", {
+                ns: utilityNS,
+                c: s.charAt(index),
+                position: index + 1,
+                component: i18nextGS1.t("Check.priceOrWeightComponent")
+            }));
         }
 
         // Add the weight result of the character index to the accumulator.
@@ -184,8 +196,7 @@ export function checkCharacterPair(s: string): string {
     const weightIndexStart = CHECK_CHARACTER_WEIGHTS.length - s.length;
 
     if (weightIndexStart < 0) {
-        throw new RangeError(i18next.t("Check.lengthOfStringForCheckCharacterPairMustBeLessThanOrEqualTo", {
-            ns: gs1NS,
+        throw new RangeError(i18nextGS1.t("Check.lengthOfStringForCheckCharacterPairMustBeLessThanOrEqualTo", {
             length: s.length,
             maximumLength: CHECK_CHARACTER_WEIGHTS.length
         }));
@@ -194,7 +205,11 @@ export function checkCharacterPair(s: string): string {
     // Calculate sum of each character value multiplied by the weight at its position, mod 1021.
     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}`);
+            throw new RangeError(i18nextGS1.t("CharacterSetValidator.invalidCharacterAtPosition", {
+                ns: utilityNS,
+                c: s.charAt(index),
+                position: index + 1
+            }));
         }
 
         return accumulator + characterIndex * CHECK_CHARACTER_WEIGHTS[weightIndexStart + index];