@aidc-toolkit/gs1 0.9.8-beta → 0.9.10-beta

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aidc-toolkit/gs1",
-  "version": "0.9.8-beta",
+  "version": "0.9.10-beta",
   "description": "GS1 AIDC Toolkit",
   "type": "module",
   "main": "dist/index.js",
@@ -20,23 +20,22 @@
   },
   "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.8-beta",
-    "eslint": "^9.16.0",
-    "i18next": "^24.1.0",
+    "@aidc-toolkit/dev": "^0.9.10-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.8-beta",
-    "@aidc-toolkit/utility": "^0.9.8-beta",
-    "@rollup/rollup-linux-x64-gnu": "^4.28.1",
+    "@aidc-toolkit/core": "^0.9.10-beta",
+    "@aidc-toolkit/utility": "^0.9.10-beta",
+    "i18next": "^24.2.1",
     "ts-mixer": "^6.0.4"
   }
 }

package/src/idkey.ts

@@ -1054,7 +1054,7 @@ export interface NumericIdentificationKeyCreator extends NumericIdentificationKe
      * Create all identification keys for the prefix from `0` to `capacity - 1`.
      *
      * The implementation creates the strings only as needed using an internal generator function. Although the result
-     * is equivalent to calling `creator.create(new Sequencer(0, creator.capacity - 1))`, this method is significantly
+     * is equivalent to calling `creator.create(new Sequence(0, creator.capacity))`, this method is significantly
      * faster.
      *
      * @returns
@@ -1524,6 +1524,7 @@ export class SerializableNumericIdentificationKeyCreator extends Mixin(Serializa
             result = transformIterable(serialComponentOrComponents, validateAndConcatenate);
         }
 
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion -- Type determination is handled above.
         return result as TransformerOutput<T, string>;
     }
 
@@ -1655,6 +1656,7 @@ export class NonNumericIdentificationKeyCreator extends Mixin(NonNumericIdentifi
             result = transformIterable(referenceOrReferences, validateAndCreate);
         }
 
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion -- Type determination is handled above.
         return result as TransformerOutput<T, string>;
     }
 }
@@ -2075,6 +2077,7 @@ export class PrefixManager {
      * Identification key creator.
      */
     private getIdentificationKeyCreator<T extends IdentificationKeyCreator>(identificationKeyType: IdentificationKeyType, constructorCallback: () => T): T {
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion -- Type is paired with constructor callback.
         let creator = this._identificationKeyCreatorsMap.get(identificationKeyType) as (T | undefined);
 
         if (creator === undefined) {

package/src/index.ts

@@ -1,3 +1,19 @@
+/*!
+ * 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.
+ */
 export * from "./locale/i18n.js";
 export * from "./character-set.js";
 export * from "./check.js";

package/src/locale/i18n.ts

@@ -1,6 +1,6 @@
 import { i18nAssertValidResources, i18nCoreInit, type I18NEnvironment } from "@aidc-toolkit/core";
 import { i18nUtilityInit, utilityResources } from "@aidc-toolkit/utility";
-import i18next from "i18next";
+import i18next, { type i18n } from "i18next";
 import { localeStrings as enLocaleStrings } from "./en/locale-strings.js";
 import { localeStrings as frLocaleStrings } from "./fr/locale-strings.js";
 
@@ -25,7 +25,8 @@ export const gs1Resources = {
     }
 };
 
-export const i18nextGS1 = i18next.createInstance();
+// Explicit type is necessary to work around bug in type discovery with linked packages.
+export const i18nextGS1: i18n = i18next.createInstance();
 
 /**
  * Initialize internationalization.

package/test/idkey.test.ts

@@ -1,5 +1,5 @@
 import { I18NEnvironment } from "@aidc-toolkit/core";
-import { CharacterSetCreator, Exclusion, NUMERIC_CREATOR, Sequencer } from "@aidc-toolkit/utility";
+import { CharacterSetCreator, Exclusion, NUMERIC_CREATOR, Sequence } from "@aidc-toolkit/utility";
 import { describe, expect, test } from "vitest";
 import {
     AI39_CREATOR,
@@ -379,8 +379,8 @@ describe("Sparse creation", () => {
 
     prefixManager.tweakFactor = 0;
 
-    const sparseGTINs = Array.from(prefixManager.gtinCreator.create(new Sequencer(0, 10), true));
-    const straightGTINs = Array.from(prefixManager.gtinCreator.create(new Sequencer(0, 10)));
+    const sparseGTINs = Array.from(prefixManager.gtinCreator.create(new Sequence(0, 10), true));
+    const straightGTINs = Array.from(prefixManager.gtinCreator.create(new Sequence(0, 10)));
 
     test("Tweak factor 0", () => {
         expect(sparseGTINs).toStrictEqual(straightGTINs);
@@ -424,7 +424,7 @@ function testNumericIdentificationKeyCreator(creator: NumericIdentificationKeyCr
             expect(creator.referenceLength).toBe(referenceLength);
             expect(creator.capacity).toBe(Number(CharacterSetCreator.powerOf10(referenceLength)));
 
-            const sequenceIterator = Iterator.from(creator.create(new Sequencer(0, referenceCount)));
+            const sequenceIterator = Iterator.from(creator.create(new Sequence(0, referenceCount)));
 
             let allCount = 0;
 
@@ -463,10 +463,10 @@ function testNumericIdentificationKeyCreator(creator: NumericIdentificationKeyCr
 
             let sequenceCount = 0;
 
-            Iterator.from(creator.create(new Sequencer(0, sparseReferenceCount), true)).forEach((identificationKey, index) => {
+            Iterator.from(creator.create(new Sequence(0, sparseReferenceCount), true)).forEach((identificationKey, index) => {
                 validate(identificationKey, index, true);
 
-                sequential = sequential && Number((hasExtensionDigit ? identificationKey.charAt(0) : "") + identificationKey.substring(referenceSubstringStart, referenceSubstringEnd)) === index;
+                sequential &&= Number((hasExtensionDigit ? identificationKey.charAt(0) : "") + identificationKey.substring(referenceSubstringStart, referenceSubstringEnd)) === index;
 
                 expect(sequenceSet.has(identificationKey)).toBe(false);
                 sequenceSet.add(identificationKey);
@@ -564,7 +564,7 @@ function testGTINCreator(creator: GTINCreator): void {
         test("GTIN-14 straight", () => {
             let sequenceCount = 0;
 
-            Iterator.from(creator.createGTIN14("5", new Sequencer(0, referenceCount))).forEach((gtin, index) => {
+            Iterator.from(creator.createGTIN14("5", new Sequence(0, referenceCount))).forEach((gtin, index) => {
                 expect(Number(gtin.substring(referenceSubstringStart, referenceSubstringEnd))).toBe(index);
 
                 validate(gtin, index, false);
@@ -597,8 +597,8 @@ function testGTINCreator(creator: GTINCreator): void {
 
             let sequenceCount = 0;
 
-            Iterator.from(creator.createGTIN14("5", new Sequencer(0, sparseReferenceCount), true)).forEach((gtin, index) => {
-                sequential = sequential && Number(gtin.substring(referenceSubstringStart, referenceSubstringEnd)) === index;
+            Iterator.from(creator.createGTIN14("5", new Sequence(0, sparseReferenceCount), true)).forEach((gtin, index) => {
+                sequential &&= Number(gtin.substring(referenceSubstringStart, referenceSubstringEnd)) === index;
 
                 validate(gtin, index, true);
 
@@ -942,7 +942,7 @@ function testNonNumericIdentificationKeyCreator(creator: NonNumericIdentificatio
 
             let sequenceCount = 0;
 
-            Iterator.from(creator.create(creator.referenceCreator.create(TEST_REFERENCE_LENGTH, new Sequencer(0, referenceCount)))).forEach((identificationKey, index) => {
+            Iterator.from(creator.create(creator.referenceCreator.create(TEST_REFERENCE_LENGTH, new Sequence(0, referenceCount)))).forEach((identificationKey, index) => {
                 expect(() => {
                     creator.validate(identificationKey);
                 }).not.toThrow(RangeError);
@@ -966,14 +966,14 @@ function testNonNumericIdentificationKeyCreator(creator: NonNumericIdentificatio
 
             let sequenceCount = 0;
 
-            Iterator.from(creator.create(creator.referenceCreator.create(TEST_REFERENCE_LENGTH, new Sequencer(0, referenceCount), Exclusion.None, 123456n))).forEach((identificationKey, index) => {
+            Iterator.from(creator.create(creator.referenceCreator.create(TEST_REFERENCE_LENGTH, new Sequence(0, referenceCount), Exclusion.None, 123456n))).forEach((identificationKey, index) => {
                 expect(() => {
                     creator.validate(identificationKey);
                 }).not.toThrow(RangeError);
 
                 expect(Number(creator.referenceCreator.valueFor(identificationKey.substring(referenceSubstringStart, referenceSubstringEnd), Exclusion.None, 123456n))).toBe(index);
 
-                sequential = sequential && Number(creator.referenceCreator.valueFor(identificationKey.substring(referenceSubstringStart, referenceSubstringEnd))) === index;
+                sequential &&= Number(creator.referenceCreator.valueFor(identificationKey.substring(referenceSubstringStart, referenceSubstringEnd))) === index;
 
                 expect(identificationKey.length).toBeLessThanOrEqual(creator.length);
                 expect(identificationKey.substring(0, prefixLength)).toBe(prefix);