@aidc-toolkit/gs1 0.9.5 → 0.9.7-beta

package/dist/index.cjs

@@ -23,7 +23,7 @@ __export(src_exports, {
   AI39_CREATOR: () => AI39_CREATOR,
   AI82_CREATOR: () => AI82_CREATOR,
   CPID_VALIDATOR: () => CPID_VALIDATOR,
-  CharacterSet: () => CharacterSet,
+  ContentCharacterSet: () => ContentCharacterSet,
   GCN_VALIDATOR: () => GCN_VALIDATOR,
   GDTI_VALIDATOR: () => GDTI_VALIDATOR,
   GIAI_VALIDATOR: () => GIAI_VALIDATOR,
@@ -57,11 +57,94 @@ __export(src_exports, {
   checkDigitSum: () => checkDigitSum,
   fiveDigitPriceWeightCheckDigit: () => fiveDigitPriceWeightCheckDigit,
   fourDigitPriceWeightCheckDigit: () => fourDigitPriceWeightCheckDigit,
+  gs1NS: () => gs1NS,
   hasValidCheckCharacterPair: () => hasValidCheckCharacterPair,
   hasValidCheckDigit: () => hasValidCheckDigit
 });
 module.exports = __toCommonJS(src_exports);
 
+// src/locale/i18n.ts
+var import_core = require("@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";
+(0, import_core.i18nAssertValidResources)(localeStrings, "fr", localeStrings2);
+(0, import_core.i18nAddResourceBundle)("en", gs1NS, localeStrings);
+(0, import_core.i18nAddResourceBundle)("fr", gs1NS, localeStrings2);
+var i18n_default = import_core.i18next;
+
 // src/character_set.ts
 var import_utility = require("@aidc-toolkit/utility");
 var AI82_CREATOR = new import_utility.CharacterSetCreator([
@@ -192,90 +275,6 @@ var AI39_CREATOR = new import_utility.CharacterSetCreator([
 
 // src/check.ts
 var import_utility2 = require("@aidc-toolkit/utility");
-
-// src/locale/i18n.ts
-var import_core = require("@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";
-(0, import_core.i18nAssertValidResources)(localeStrings, "fr", localeStrings2);
-(0, import_core.i18nAddResourceBundle)("en", gs1NS, localeStrings);
-(0, import_core.i18nAddResourceBundle)("fr", gs1NS, localeStrings2);
-var i18n_default = import_core.i18next;
-
-// src/check.ts
 var THREE_WEIGHT_RESULTS = [
   0,
   3,
@@ -481,12 +480,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 = [
     import_utility3.NUMERIC_CREATOR,
@@ -510,19 +509,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];
   }
   /**
@@ -545,7 +544,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
@@ -574,8 +573,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
@@ -591,7 +590,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.
@@ -858,9 +857,9 @@ var SerializableNumericIdentificationKeyValidator = class _SerializableNumericId
    */
   _serialComponentValidation;
   /**
-   * Serial component validator.
+   * Serial component creator.
    */
-  _serialComponentValidator;
+  _serialComponentCreator;
   /**
    * Constructor.
    *
@@ -887,7 +886,7 @@ var SerializableNumericIdentificationKeyValidator = class _SerializableNumericId
         ns: gs1NS
       })
     };
-    this._serialComponentValidator = _SerializableNumericIdentificationKeyValidator.validatorFor(serialComponentCharacterSet);
+    this._serialComponentCreator = _SerializableNumericIdentificationKeyValidator.creatorFor(serialComponentCharacterSet);
   }
   /**
    * Get the serial component length.
@@ -908,10 +907,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
@@ -919,7 +918,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);
     }
   }
 };
@@ -979,7 +978,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
       });
@@ -1037,12 +1036,6 @@ var AbstractIdentificationKeyCreator = class {
     this._prefixManager = prefixManager;
     this._referenceLength = this.length - prefix.length - checkAllowance;
   }
-  /**
-   * @inheritDoc
-   */
-  get referenceCreator() {
-    return this.referenceValidator;
-  }
   /**
    * @inheritDoc
    */
@@ -1115,7 +1108,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 import_utility3.NUMERIC_CREATOR.create(this.referenceLength, valueOrValues, import_utility3.Exclusion.None, sparse ? this.tweak : void 0, (reference) => this.buildIdentificationKey(reference));
   }
@@ -1213,7 +1208,22 @@ var GTINCreator = class _GTINCreator extends (0, import_ts_mixer.Mixin)(GTINVali
   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) {
     import_utility3.NUMERIC_CREATOR.validate(indicatorDigit, _GTINCreator.REQUIRED_INDICATOR_DIGIT_VALIDATION);
     return import_utility3.NUMERIC_CREATOR.create(13 /* GTIN13 */ - this.prefixManager.gs1CompanyPrefix.length - 1, valueOrValues, import_utility3.Exclusion.None, sparse ? this.tweak : void 0, (reference) => {
@@ -1386,30 +1396,66 @@ var SerializableNumericIdentificationKeyCreator = class extends (0, import_ts_mi
     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 = import_utility3.IteratorProxy.from(serialComponent).map((serialComponent2) => this.concatenateValidated(baseIdentificationKey, serialComponent2));
+      result = import_utility3.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 (0, import_ts_mixer.Mixin)(NonNumericIdentificationKeyValidator, AbstractIdentificationKeyCreator) {
@@ -1448,15 +1494,36 @@ var NonNumericIdentificationKeyCreator = class extends (0, import_ts_mixer.Mixin
       })
     };
   }
-  // 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 = import_utility3.IteratorProxy.from(referenceOrReferences).map((reference) => this.create(reference));
+      result = import_utility3.IteratorProxy.from(referenceOrReferences).map(validateAndCreate);
     }
     return result;
   }
@@ -1938,7 +2005,7 @@ var PrefixManager = class _PrefixManager {
   AI39_CREATOR,
   AI82_CREATOR,
   CPID_VALIDATOR,
-  CharacterSet,
+  ContentCharacterSet,
   GCN_VALIDATOR,
   GDTI_VALIDATOR,
   GIAI_VALIDATOR,
@@ -1972,6 +2039,7 @@ var PrefixManager = class _PrefixManager {
   checkDigitSum,
   fiveDigitPriceWeightCheckDigit,
   fourDigitPriceWeightCheckDigit,
+  gs1NS,
   hasValidCheckCharacterPair,
   hasValidCheckDigit
 });