@aidc-toolkit/gs1 0.9.5 → 0.9.7-beta

package/dist/index.js

@@ -1,3 +1,85 @@
+// src/locale/i18n.ts
+import { i18nAddResourceBundle, i18nAssertValidResources, i18next } from "@aidc-toolkit/core";
+
+// src/locale/en/locale_strings.ts
+var localeStrings = {
+  Check: {
+    lengthOfStringForCheckCharacterPairMustBeLessThanOrEqualTo: "Length {{length}} of string for check character pair must be less than or equal to {{maximumLength}}"
+  },
+  IdentificationKey: {
+    identificationKeyTypeLength: "{{identificationKeyType}} must be {{length}} digits long",
+    invalidCheckDigit: "Invalid check digit",
+    invalidGTINLength: "GTIN must be 13, 12, 8, or 14 digits long",
+    invalidGTIN14Length: "GTIN must be 14 digits long",
+    invalidZeroSuppressedGTIN12: "Invalid zero-suppressed GTIN-12",
+    invalidZeroSuppressibleGTIN12: "GTIN-12 not zero-suppressible",
+    invalidZeroSuppressedGTIN12AsGTIN13: "Invalid zero-suppressed GTIN-12 as GTIN-13",
+    invalidZeroSuppressedGTIN12AsGTIN14: "Invalid zero-suppressed GTIN-12 as GTIN-14",
+    invalidGTIN13AtRetail: "GTIN-13 at retail consumer trade item level can't start with zero",
+    invalidGTINAtRetail: "GTIN not supported at retail consumer trade item level",
+    invalidGTINAtOtherThanRetail: "GTIN not supported at other than retail consumer trade item level",
+    indicatorDigit: "indicator digit",
+    serialComponent: "serial component",
+    reference: "reference",
+    referenceCantBeAllNumeric: "Reference can't be all-numeric",
+    invalidCheckCharacterPair: "Invalid check character pair"
+  },
+  Prefix: {
+    gs1CompanyPrefix: "GS1 Company Prefix",
+    upcCompanyPrefix: "U.P.C. Company Prefix",
+    gs18Prefix: "GS1-8 Prefix",
+    gs1CompanyPrefixCantStartWith0: `GS1 Company Prefix can't start with "0"`,
+    gs1CompanyPrefixCantStartWith00000: `GS1 Company Prefix can't start with "00000"`,
+    gs1CompanyPrefixCantStartWith000000: `GS1 Company Prefix can't start with "000000"`,
+    upcCompanyPrefixCantStartWith0000: `U.P.C. Company Prefix can't start with "0000"`,
+    gs18PrefixCantStartWith0: `GS1-8 Prefix can't start with "0"`,
+    identificationKeyTypeNotSupportedByGS18Prefix: "{{identificationKeyType}} not supported by GS1-8 Prefix"
+  }
+};
+
+// src/locale/fr/locale_strings.ts
+var localeStrings2 = {
+  Check: {
+    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: {
+    identificationKeyTypeLength: "{{identificationKeyType}} doit comporter {{length}} chiffres",
+    invalidCheckDigit: "Chiffre de contr\xF4le 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\xE9ro supprim\xE9",
+    invalidZeroSuppressibleGTIN12: "Le GTIN-12 ne peut pas \xEAtre supprim\xE9 par z\xE9ro",
+    invalidZeroSuppressedGTIN12AsGTIN13: "GTIN-12 non valide avec z\xE9ro supprim\xE9 en tant que GTIN-13",
+    invalidZeroSuppressedGTIN12AsGTIN14: "GTIN-12 non valide avec z\xE9ro supprim\xE9 en tant que GTIN-14",
+    invalidGTIN13AtRetail: "Le GTIN-13 au niveau des articles de consommation au d\xE9tail ne peut pas commencer par z\xE9ro",
+    invalidGTINAtRetail: "Le GTIN n'est pas pris en charge au niveau des articles de consommation au d\xE9tail",
+    invalidGTINAtOtherThanRetail: "Le GTIN n'est pas pris en charge \xE0 d'autres niveaux que ceux des articles de consommation au d\xE9tail",
+    indicatorDigit: "chiffre indicateur",
+    serialComponent: "composant s\xE9rie",
+    reference: "r\xE9f\xE9rence",
+    referenceCantBeAllNumeric: "La r\xE9f\xE9rence ne peut pas \xEAtre enti\xE8rement num\xE9rique",
+    invalidCheckCharacterPair: "Paire de caract\xE8res de contr\xF4le non valide"
+  },
+  Prefix: {
+    gs1CompanyPrefix: "Pr\xE9fixe de l'entreprise GS1",
+    upcCompanyPrefix: "Pr\xE9fixe de l'entreprise U.P.C.",
+    gs18Prefix: "Pr\xE9fixe GS1-8",
+    gs1CompanyPrefixCantStartWith0: `Le pr\xE9fixe de l'entreprise GS1 ne peut pas commencer par "0"`,
+    gs1CompanyPrefixCantStartWith00000: `Le pr\xE9fixe de l'entreprise GS1 ne peut pas commencer par "00000"`,
+    gs1CompanyPrefixCantStartWith000000: `Le pr\xE9fixe de l'entreprise GS1 ne peut pas commencer par "000000"`,
+    upcCompanyPrefixCantStartWith0000: `Le pr\xE9fixe de l'entreprise U.P.C. ne peut pas commencer par "0000"`,
+    gs18PrefixCantStartWith0: 'Le pr\xE9fixe GS1-8 ne peut pas commencer par "0"',
+    identificationKeyTypeNotSupportedByGS18Prefix: "{{identificationKeyType}} non pris en charge par le pr\xE9fixe GS1-8"
+  }
+};
+
+// src/locale/i18n.ts
+var gs1NS = "aidct_gs1";
+i18nAssertValidResources(localeStrings, "fr", localeStrings2);
+i18nAddResourceBundle("en", gs1NS, localeStrings);
+i18nAddResourceBundle("fr", gs1NS, localeStrings2);
+var i18n_default = i18next;
+
 // src/character_set.ts
 import { CharacterSetCreator, Exclusion } from "@aidc-toolkit/utility";
 var AI82_CREATOR = new CharacterSetCreator([
@@ -128,90 +210,6 @@ var AI39_CREATOR = new CharacterSetCreator([
 
 // src/check.ts
 import { NUMERIC_CREATOR } from "@aidc-toolkit/utility";
-
-// src/locale/i18n.ts
-import { i18nAddResourceBundle, i18nAssertValidResources, i18next } from "@aidc-toolkit/core";
-
-// src/locale/en/locale_strings.ts
-var localeStrings = {
-  Check: {
-    lengthOfStringForCheckCharacterPairMustBeLessThanOrEqualTo: "Length {{length}} of string for check character pair must be less than or equal to {{maximumLength}}"
-  },
-  IdentificationKey: {
-    identificationKeyTypeLength: "{{identificationKeyType}} must be {{length}} digits long",
-    invalidCheckDigit: "Invalid check digit",
-    invalidGTINLength: "GTIN must be 13, 12, 8, or 14 digits long",
-    invalidGTIN14Length: "GTIN must be 14 digits long",
-    invalidZeroSuppressedGTIN12: "Invalid zero-suppressed GTIN-12",
-    invalidZeroSuppressibleGTIN12: "GTIN-12 not zero-suppressible",
-    invalidZeroSuppressedGTIN12AsGTIN13: "Invalid zero-suppressed GTIN-12 as GTIN-13",
-    invalidZeroSuppressedGTIN12AsGTIN14: "Invalid zero-suppressed GTIN-12 as GTIN-14",
-    invalidGTIN13AtRetail: "GTIN-13 at retail consumer trade item level can't start with zero",
-    invalidGTINAtRetail: "GTIN not supported at retail consumer trade item level",
-    invalidGTINAtOtherThanRetail: "GTIN not supported at other than retail consumer trade item level",
-    indicatorDigit: "indicator digit",
-    serialComponent: "serial component",
-    reference: "reference",
-    referenceCantBeAllNumeric: "Reference can't be all-numeric",
-    invalidCheckCharacterPair: "Invalid check character pair"
-  },
-  Prefix: {
-    gs1CompanyPrefix: "GS1 Company Prefix",
-    upcCompanyPrefix: "U.P.C. Company Prefix",
-    gs18Prefix: "GS1-8 Prefix",
-    gs1CompanyPrefixCantStartWith0: `GS1 Company Prefix can't start with "0"`,
-    gs1CompanyPrefixCantStartWith00000: `GS1 Company Prefix can't start with "00000"`,
-    gs1CompanyPrefixCantStartWith000000: `GS1 Company Prefix can't start with "000000"`,
-    upcCompanyPrefixCantStartWith0000: `U.P.C. Company Prefix can't start with "0000"`,
-    gs18PrefixCantStartWith0: `GS1-8 Prefix can't start with "0"`,
-    identificationKeyTypeNotSupportedByGS18Prefix: "{{identificationKeyType}} not supported by GS1-8 Prefix"
-  }
-};
-
-// src/locale/fr/locale_strings.ts
-var localeStrings2 = {
-  Check: {
-    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: {
-    identificationKeyTypeLength: "{{identificationKeyType}} doit comporter {{length}} chiffres",
-    invalidCheckDigit: "Chiffre de contr\xF4le 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\xE9ro supprim\xE9",
-    invalidZeroSuppressibleGTIN12: "Le GTIN-12 ne peut pas \xEAtre supprim\xE9 par z\xE9ro",
-    invalidZeroSuppressedGTIN12AsGTIN13: "GTIN-12 non valide avec z\xE9ro supprim\xE9 en tant que GTIN-13",
-    invalidZeroSuppressedGTIN12AsGTIN14: "GTIN-12 non valide avec z\xE9ro supprim\xE9 en tant que GTIN-14",
-    invalidGTIN13AtRetail: "Le GTIN-13 au niveau des articles de consommation au d\xE9tail ne peut pas commencer par z\xE9ro",
-    invalidGTINAtRetail: "Le GTIN n'est pas pris en charge au niveau des articles de consommation au d\xE9tail",
-    invalidGTINAtOtherThanRetail: "Le GTIN n'est pas pris en charge \xE0 d'autres niveaux que ceux des articles de consommation au d\xE9tail",
-    indicatorDigit: "chiffre indicateur",
-    serialComponent: "composant s\xE9rie",
-    reference: "r\xE9f\xE9rence",
-    referenceCantBeAllNumeric: "La r\xE9f\xE9rence ne peut pas \xEAtre enti\xE8rement num\xE9rique",
-    invalidCheckCharacterPair: "Paire de caract\xE8res de contr\xF4le non valide"
-  },
-  Prefix: {
-    gs1CompanyPrefix: "Pr\xE9fixe de l'entreprise GS1",
-    upcCompanyPrefix: "Pr\xE9fixe de l'entreprise U.P.C.",
-    gs18Prefix: "Pr\xE9fixe GS1-8",
-    gs1CompanyPrefixCantStartWith0: `Le pr\xE9fixe de l'entreprise GS1 ne peut pas commencer par "0"`,
-    gs1CompanyPrefixCantStartWith00000: `Le pr\xE9fixe de l'entreprise GS1 ne peut pas commencer par "00000"`,
-    gs1CompanyPrefixCantStartWith000000: `Le pr\xE9fixe de l'entreprise GS1 ne peut pas commencer par "000000"`,
-    upcCompanyPrefixCantStartWith0000: `Le pr\xE9fixe de l'entreprise U.P.C. ne peut pas commencer par "0000"`,
-    gs18PrefixCantStartWith0: 'Le pr\xE9fixe GS1-8 ne peut pas commencer par "0"',
-    identificationKeyTypeNotSupportedByGS18Prefix: "{{identificationKeyType}} non pris en charge par le pr\xE9fixe GS1-8"
-  }
-};
-
-// src/locale/i18n.ts
-var gs1NS = "aidct_gs1";
-i18nAssertValidResources(localeStrings, "fr", localeStrings2);
-i18nAddResourceBundle("en", gs1NS, localeStrings);
-i18nAddResourceBundle("fr", gs1NS, localeStrings2);
-var i18n_default = i18next;
-
-// src/check.ts
 var THREE_WEIGHT_RESULTS = [
   0,
   3,
@@ -423,12 +421,12 @@ var PrefixType = /* @__PURE__ */ ((PrefixType2) => {
   PrefixType2[PrefixType2["GS18Prefix"] = 2] = "GS18Prefix";
   return PrefixType2;
 })(PrefixType || {});
-var CharacterSet = /* @__PURE__ */ ((CharacterSet2) => {
-  CharacterSet2[CharacterSet2["Numeric"] = 0] = "Numeric";
-  CharacterSet2[CharacterSet2["AI82"] = 1] = "AI82";
-  CharacterSet2[CharacterSet2["AI39"] = 2] = "AI39";
-  return CharacterSet2;
-})(CharacterSet || {});
+var ContentCharacterSet = /* @__PURE__ */ ((ContentCharacterSet2) => {
+  ContentCharacterSet2[ContentCharacterSet2["Numeric"] = 0] = "Numeric";
+  ContentCharacterSet2[ContentCharacterSet2["AI82"] = 1] = "AI82";
+  ContentCharacterSet2[ContentCharacterSet2["AI39"] = 2] = "AI39";
+  return ContentCharacterSet2;
+})(ContentCharacterSet || {});
 var AbstractIdentificationKeyValidator = class _AbstractIdentificationKeyValidator {
   static CHARACTER_SET_CREATORS = [
     NUMERIC_CREATOR2,
@@ -452,19 +450,19 @@ var AbstractIdentificationKeyValidator = class _AbstractIdentificationKeyValidat
    */
   _referenceCharacterSet;
   /**
-   * Reference validator.
+   * Reference creator.
    */
-  _referenceValidator;
+  _referenceCreator;
   /**
-   * Get the character set validator for a character set.
+   * Get the character set creator for a character set.
    *
    * @param characterSet
    * Character set.
    *
    * @returns
-   * Character set validator.
+   * Character set creator.
    */
-  static validatorFor(characterSet) {
+  static creatorFor(characterSet) {
     return _AbstractIdentificationKeyValidator.CHARACTER_SET_CREATORS[characterSet];
   }
   /**
@@ -487,7 +485,7 @@ var AbstractIdentificationKeyValidator = class _AbstractIdentificationKeyValidat
     this._prefixType = prefixType;
     this._length = length;
     this._referenceCharacterSet = referenceCharacterSet;
-    this._referenceValidator = _AbstractIdentificationKeyValidator.validatorFor(referenceCharacterSet);
+    this._referenceCreator = _AbstractIdentificationKeyValidator.creatorFor(referenceCharacterSet);
   }
   /**
    * @inheritDoc
@@ -516,8 +514,8 @@ var AbstractIdentificationKeyValidator = class _AbstractIdentificationKeyValidat
   /**
    * @inheritDoc
    */
-  get referenceValidator() {
-    return this._referenceValidator;
+  get referenceCreator() {
+    return this._referenceCreator;
   }
   /**
    * Pad an identification key on the left with zero-value character for validation purposes. This is done to align an
@@ -533,7 +531,7 @@ var AbstractIdentificationKeyValidator = class _AbstractIdentificationKeyValidat
    * Padded identification key.
    */
   padIdentificationKey(identificationKey, validation) {
-    return validation?.positionOffset === void 0 ? identificationKey : this.referenceValidator.character(0).repeat(validation.positionOffset).concat(identificationKey);
+    return validation?.positionOffset === void 0 ? identificationKey : this.referenceCreator.character(0).repeat(validation.positionOffset).concat(identificationKey);
   }
   /**
    * Validate the prefix within an identification key.
@@ -800,9 +798,9 @@ var SerializableNumericIdentificationKeyValidator = class _SerializableNumericId
    */
   _serialComponentValidation;
   /**
-   * Serial component validator.
+   * Serial component creator.
    */
-  _serialComponentValidator;
+  _serialComponentCreator;
   /**
    * Constructor.
    *
@@ -829,7 +827,7 @@ var SerializableNumericIdentificationKeyValidator = class _SerializableNumericId
         ns: gs1NS
       })
     };
-    this._serialComponentValidator = _SerializableNumericIdentificationKeyValidator.validatorFor(serialComponentCharacterSet);
+    this._serialComponentCreator = _SerializableNumericIdentificationKeyValidator.creatorFor(serialComponentCharacterSet);
   }
   /**
    * Get the serial component length.
@@ -850,10 +848,10 @@ var SerializableNumericIdentificationKeyValidator = class _SerializableNumericId
     return this._serialComponentValidation;
   }
   /**
-   * Get the serial component validator.
+   * Get the serial component creator.
    */
-  get serialComponentValidator() {
-    return this._serialComponentValidator;
+  get serialComponentCreator() {
+    return this._serialComponentCreator;
   }
   /**
    * @inheritDoc
@@ -861,7 +859,7 @@ var SerializableNumericIdentificationKeyValidator = class _SerializableNumericId
   validate(identificationKey, validation) {
     super.validate(identificationKey.substring(0, this.length), validation);
     if (identificationKey.length > this.length) {
-      this.serialComponentValidator.validate(identificationKey.substring(this.length), this._serialComponentValidation);
+      this.serialComponentCreator.validate(identificationKey.substring(this.length), this._serialComponentValidation);
     }
   }
 };
@@ -921,7 +919,7 @@ var NonNumericIdentificationKeyValidator = class _NonNumericIdentificationKeyVal
     const partialIdentificationKey = this.requiresCheckCharacterPair ? identificationKey.substring(0, identificationKey.length - 2) : identificationKey;
     super.validatePrefix(partialIdentificationKey, validation?.positionOffset);
     if (!this.requiresCheckCharacterPair) {
-      this.referenceValidator.validate(identificationKey, {
+      this.referenceCreator.validate(identificationKey, {
         maximumLength: this.length,
         positionOffset: validation?.positionOffset
       });
@@ -979,12 +977,6 @@ var AbstractIdentificationKeyCreator = class {
     this._prefixManager = prefixManager;
     this._referenceLength = this.length - prefix.length - checkAllowance;
   }
-  /**
-   * @inheritDoc
-   */
-  get referenceCreator() {
-    return this.referenceValidator;
-  }
   /**
    * @inheritDoc
    */
@@ -1057,7 +1049,9 @@ var AbstractNumericIdentificationKeyCreator = class _AbstractNumericIdentificati
     const partialIdentificationKey = this.leaderType === 2 /* ExtensionDigit */ ? reference.substring(0, 1) + this.prefix + reference.substring(1) : this.prefix + reference;
     return partialIdentificationKey + checkDigit(partialIdentificationKey);
   }
-  // eslint-disable-next-line jsdoc/require-jsdoc -- Implementation of overloaded signatures.
+  /**
+   * @inheritDoc
+   */
   create(valueOrValues, sparse = false) {
     return NUMERIC_CREATOR2.create(this.referenceLength, valueOrValues, Exclusion2.None, sparse ? this.tweak : void 0, (reference) => this.buildIdentificationKey(reference));
   }
@@ -1155,7 +1149,22 @@ var GTINCreator = class _GTINCreator extends Mixin(GTINValidator, AbstractNumeri
   get prefix() {
     return this.prefixManager.prefix;
   }
-  // eslint-disable-next-line jsdoc/require-jsdoc -- Implementation of overloaded signatures.
+  /**
+   * Create GTIN-14(s) with an indicator digit and reference(s) based on numeric value(s). The value(s) is/are
+   * converted to reference(s) of the appropriate length using {@linkcode NUMERIC_CREATOR}.
+   *
+   * @param indicatorDigit
+   * Indicator digit.
+   *
+   * @param valueOrValues
+   * Numeric value(s).
+   *
+   * @param sparse
+   * If true, the value(s) is/are mapped to a sparse sequence resistant to discovery. Default is false.
+   *
+   * @returns
+   * GTIN-14(s).
+   */
   createGTIN14(indicatorDigit, valueOrValues, sparse = false) {
     NUMERIC_CREATOR2.validate(indicatorDigit, _GTINCreator.REQUIRED_INDICATOR_DIGIT_VALIDATION);
     return NUMERIC_CREATOR2.create(13 /* GTIN13 */ - this.prefixManager.gs1CompanyPrefix.length - 1, valueOrValues, Exclusion2.None, sparse ? this.tweak : void 0, (reference) => {
@@ -1328,30 +1337,66 @@ var SerializableNumericIdentificationKeyCreator = class extends Mixin(Serializab
     this.init(prefixManager, prefixManager.gs1CompanyPrefix);
   }
   /**
-   * Get the serial component creator.
+   * Concatenate a validated base identification key with serial component(s).
+   *
+   * @param baseIdentificationKey
+   * Base identification key.
+   *
+   * @param serialComponentOrComponents
+   * Serial component(s).
+   *
+   * @returns
+   * Serialized identification key(s).
    */
-  get serialComponentCreator() {
-    return this.serialComponentValidator;
-  }
-  // eslint-disable-next-line jsdoc/require-jsdoc -- Implementation of overloaded signatures.
-  concatenateValidated(baseIdentificationKey, serialComponent) {
+  concatenateValidated(baseIdentificationKey, serialComponentOrComponents) {
     let result;
-    if (typeof serialComponent === "string") {
-      this.serialComponentCreator.validate(serialComponent, this.serialComponentValidation);
-      result = baseIdentificationKey + serialComponent;
+    const serialComponentCreator = this.serialComponentCreator;
+    const serialComponentValidation = this.serialComponentValidation;
+    function validateAndConcatenate(serialComponent) {
+      serialComponentCreator.validate(serialComponent, serialComponentValidation);
+      return baseIdentificationKey + serialComponent;
+    }
+    if (typeof serialComponentOrComponents !== "object") {
+      result = validateAndConcatenate(serialComponentOrComponents);
     } else {
-      result = IteratorProxy.from(serialComponent).map((serialComponent2) => this.concatenateValidated(baseIdentificationKey, serialComponent2));
+      result = IteratorProxy.from(serialComponentOrComponents).map(validateAndConcatenate);
     }
     return result;
   }
-  // eslint-disable-next-line jsdoc/require-jsdoc -- Implementation of overloaded signatures.
-  createSerialized(value, serialComponent, sparse = false) {
-    return this.concatenateValidated(this.create(value, sparse), serialComponent);
+  /**
+   * Create serialized identification key(s) with a reference based on a numeric value concatenated with serial
+   * component(s). The value is converted to a reference of the appropriate length using {@linkcode NUMERIC_CREATOR}.
+   *
+   * @param value
+   * Numeric value of the reference.
+   *
+   * @param serialComponentOrComponents
+   * Serial component(s).
+   *
+   * @param sparse
+   * If true, the value is mapped to a sparse sequence resistant to discovery. Default is false.
+   *
+   * @returns
+   * Serialized identification keys.
+   */
+  createSerialized(value, serialComponentOrComponents, sparse) {
+    return this.concatenateValidated(this.create(value, sparse), serialComponentOrComponents);
   }
-  // eslint-disable-next-line jsdoc/require-jsdoc -- Implementation of overloaded signatures.
-  concatenate(baseIdentificationKey, serialComponent) {
+  /**
+   * Concatenate a base identification key with serial component(s).
+   *
+   * @param baseIdentificationKey
+   * Base identification key.
+   *
+   * @param serialComponentOrComponents
+   * Serial component(s).
+   *
+   * @returns
+   * Serialized identification key(s).
+   */
+  concatenate(baseIdentificationKey, serialComponentOrComponents) {
     this.validate(baseIdentificationKey);
-    return this.concatenateValidated(baseIdentificationKey, serialComponent);
+    return this.concatenateValidated(baseIdentificationKey, serialComponentOrComponents);
   }
 };
 var NonNumericIdentificationKeyCreator = class extends Mixin(NonNumericIdentificationKeyValidator, AbstractIdentificationKeyCreator) {
@@ -1390,15 +1435,36 @@ var NonNumericIdentificationKeyCreator = class extends Mixin(NonNumericIdentific
       })
     };
   }
-  // eslint-disable-next-line jsdoc/require-jsdoc -- Implementation of overloaded signatures.
+  /**
+   * Get the reference validation parameters.
+   */
+  get referenceValidation() {
+    return this._referenceValidation;
+  }
+  /**
+   * Create identification key(s) with reference(s).
+   *
+   * @param referenceOrReferences
+   * Reference(s).
+   *
+   * @returns
+   * Identification key(s).
+   */
   create(referenceOrReferences) {
     let result;
-    if (typeof referenceOrReferences === "string") {
-      this.referenceValidator.validate(referenceOrReferences, this._referenceValidation);
-      const partialIdentificationKey = this.prefix + referenceOrReferences;
-      result = this.requiresCheckCharacterPair ? partialIdentificationKey + checkCharacterPair(partialIdentificationKey) : partialIdentificationKey;
+    const referenceCreator = this.referenceCreator;
+    const referenceValidation = this.referenceValidation;
+    const prefix = this.prefix;
+    const requiresCheckCharacterPair = this.requiresCheckCharacterPair;
+    function validateAndCreate(reference) {
+      referenceCreator.validate(reference, referenceValidation);
+      const partialIdentificationKey = prefix + reference;
+      return requiresCheckCharacterPair ? partialIdentificationKey + checkCharacterPair(partialIdentificationKey) : partialIdentificationKey;
+    }
+    if (typeof referenceOrReferences !== "object") {
+      result = validateAndCreate(referenceOrReferences);
     } else {
-      result = IteratorProxy.from(referenceOrReferences).map((reference) => this.create(reference));
+      result = IteratorProxy.from(referenceOrReferences).map(validateAndCreate);
     }
     return result;
   }
@@ -1879,7 +1945,7 @@ export {
   AI39_CREATOR,
   AI82_CREATOR,
   CPID_VALIDATOR,
-  CharacterSet,
+  ContentCharacterSet,
   GCN_VALIDATOR,
   GDTI_VALIDATOR,
   GIAI_VALIDATOR,
@@ -1913,6 +1979,7 @@ export {
   checkDigitSum,
   fiveDigitPriceWeightCheckDigit,
   fourDigitPriceWeightCheckDigit,
+  gs1NS,
   hasValidCheckCharacterPair,
   hasValidCheckDigit
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aidc-toolkit/gs1",
-  "version": "0.9.5",
+  "version": "0.9.7-beta",
   "description": "GS1 AIDC Toolkit",
   "type": "module",
   "main": "dist/index.js",
@@ -19,24 +19,23 @@
     "url": "https://www.linkedin.com/in/kdean"
   },
   "scripts": {
-    "eslint": "eslint .",
+    "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",
     "test": "vitest run"
   },
   "devDependencies": {
-    "@aidc-toolkit/dev": "^0.9.5",
-    "eslint": "^9.15.0",
+    "@aidc-toolkit/dev": "^0.9.7-beta",
+    "eslint": "^9.16.0",
     "ts-node": "^10.9.2",
     "tsup": "^8.3.5",
-    "typescript": "^5.6.3",
-    "vitest": "^2.1.5"
+    "typescript": "^5.7.2",
+    "vitest": "^2.1.8"
   },
   "dependencies": {
-    "@aidc-toolkit/core": "^0.9.5",
-    "@aidc-toolkit/utility": "^0.9.5",
-    "@rollup/rollup-linux-x64-gnu": "^4.27.3",
-    "i18next": "^23.16.8",
+    "@aidc-toolkit/core": "^0.9.7-beta",
+    "@aidc-toolkit/utility": "^0.9.7-beta",
+    "@rollup/rollup-linux-x64-gnu": "^4.28.1",
     "ts-mixer": "^6.0.4"
   }
 }