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

package/dist/index.cjs

@@ -110,6 +110,7 @@ var localeStrings = {
     gs1CompanyPrefix: "GS1 Company Prefix",
     upcCompanyPrefix: "U.P.C. Company Prefix",
     gs18Prefix: "GS1-8 Prefix",
+    invalidPrefixType: "Invalid prefix type",
     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"`,
@@ -148,6 +149,7 @@ var localeStrings2 = {
     gs1CompanyPrefix: "Pr\xE9fixe de l'entreprise GS1",
     upcCompanyPrefix: "Pr\xE9fixe de l'entreprise U.P.C.",
     gs18Prefix: "Pr\xE9fixe GS1-8",
+    invalidPrefixType: "Type de pr\xE9fixe invalide",
     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"`,
@@ -725,7 +727,15 @@ var GTINLevel = /* @__PURE__ */ ((GTINLevel2) => {
 })(GTINLevel || {});
 var GTINValidator = class _GTINValidator extends AbstractNumericIdentificationKeyValidator {
   /**
-   * Zero-suppressed GTIN-12 validation parameters.
+   * Validation parameters for optional indicator digit.
+   */
+  static OPTIONAL_INDICATOR_DIGIT_VALIDATION = {
+    minimumLength: 0,
+    maximumLength: 1,
+    component: () => i18nextGS1.t("IdentificationKey.indicatorDigit")
+  };
+  /**
+   * Validation parameters for zero-suppressed GTIN-12.
    */
   static ZERO_SUPPRESSED_GTIN12_VALIDATION = {
     minimumLength: 8,
@@ -766,6 +776,35 @@ var GTINValidator = class _GTINValidator extends AbstractNumericIdentificationKe
   validatePrefix(partialIdentificationKey, positionOffset) {
     PrefixManager.validatePrefix(this.prefixType, false, false, partialIdentificationKey, true, true, positionOffset);
   }
+  /**
+   * Zero suppress a GTIN-12.
+   *
+   * @param gtin12
+   * GTIN-12.
+   *
+   * @returns
+   * Zero-suppressed GTIN-12.
+   */
+  static zeroSuppress(gtin12) {
+    GTIN12_VALIDATOR.validate(gtin12);
+    const d = Array.from(gtin12);
+    let zeroSuppressedGTIN12;
+    if (d[0] === "0" && d[6] === "0" && d[7] === "0") {
+      if (d[10] >= "5" && d[8] === "0" && d[9] === "0" && d[5] !== "0") {
+        zeroSuppressedGTIN12 = `0${d[1]}${d[2]}${d[3]}${d[4]}${d[5]}${d[10]}${d[11]}`;
+      } else if (d[5] === "0" && d[8] === "0" && d[9] === "0" && d[4] !== "0") {
+        zeroSuppressedGTIN12 = `0${d[1]}${d[2]}${d[3]}${d[4]}${d[10]}4${d[11]}`;
+      } else if (d[3] <= "2" && d[4] === "0" && d[5] === "0") {
+        zeroSuppressedGTIN12 = `0${d[1]}${d[2]}${d[8]}${d[9]}${d[10]}${d[3]}${d[11]}`;
+      } else if (d[3] >= "3" && d[4] === "0" && d[5] === "0" && d[8] === "0") {
+        zeroSuppressedGTIN12 = `0${d[1]}${d[2]}${d[3]}${d[9]}${d[10]}3${d[11]}`;
+      }
+    }
+    if (zeroSuppressedGTIN12 === void 0) {
+      throw new RangeError(i18nextGS1.t("IdentificationKey.invalidZeroSuppressibleGTIN12"));
+    }
+    return zeroSuppressedGTIN12;
+  }
   /**
    * Zero expand a zero-suppressed GTIN-12.
    *
@@ -796,6 +835,86 @@ var GTINValidator = class _GTINValidator extends AbstractNumericIdentificationKe
     GTIN12_VALIDATOR.validate(gtin12);
     return gtin12;
   }
+  /**
+   * Convert a GTIN of any length to a GTIN-14 with an optional indicator digit.
+   *
+   * @param indicatorDigit
+   * Indicator digit. If blank, assumes "0" if the GTIN is not already a GTIN-14.
+   *
+   * @param gtin
+   * GTIN.
+   *
+   * @returns
+   * GTIN-14.
+   */
+  static convertToGTIN14(indicatorDigit, gtin) {
+    GTINCreator.validateAny(gtin);
+    import_utility4.NUMERIC_CREATOR.validate(indicatorDigit, _GTINValidator.OPTIONAL_INDICATOR_DIGIT_VALIDATION);
+    const gtinLength = gtin.length;
+    let gtin14 = "0".repeat(14 /* GTIN14 */ - gtinLength) + gtin;
+    if (indicatorDigit.length !== 0 && indicatorDigit !== gtin14.charAt(0)) {
+      const partialGTIN14 = indicatorDigit + gtin14.substring(1, 14 /* GTIN14 */ - 1);
+      gtin14 = partialGTIN14 + checkDigit(partialGTIN14);
+    }
+    return gtin14;
+  }
+  /**
+   * Normalize a GTIN of any length.
+   * - A GTIN-14 that starts with six zeros or a GTIN-13 that starts with five zeros is normalized to GTIN-8.
+   * - A GTIN-14 that starts with two zeros or a GTIN-13 that starts with one zero is normalized to GTIN-12.
+   * - A GTIN-14 that starts with one zero is normalized to GTIN-13.
+   * - Otherwise, the GTIN is unchanged.
+   *
+   * @param gtin
+   * GTIN.
+   *
+   * @returns
+   * Normalized GTIN.
+   */
+  static normalize(gtin) {
+    const gtinLength = gtin.length;
+    let normalizedGTIN;
+    switch (gtinLength) {
+      case 13 /* GTIN13 */:
+        if (!gtin.startsWith("0")) {
+          normalizedGTIN = gtin;
+        } else if (!gtin.startsWith("00000")) {
+          normalizedGTIN = gtin.substring(1);
+        } else if (!gtin.startsWith("000000")) {
+          normalizedGTIN = gtin.substring(5);
+        } else {
+          throw new RangeError(i18nextGS1.t("IdentificationKey.invalidZeroSuppressedGTIN12AsGTIN13"));
+        }
+        break;
+      case 12 /* GTIN12 */:
+        normalizedGTIN = gtin;
+        break;
+      case 8 /* GTIN8 */:
+        if (!gtin.startsWith("0")) {
+          normalizedGTIN = gtin;
+        } else {
+          normalizedGTIN = _GTINValidator.zeroExpand(gtin);
+        }
+        break;
+      case 14 /* GTIN14 */:
+        if (!gtin.startsWith("0")) {
+          normalizedGTIN = gtin;
+        } else if (!gtin.startsWith("00")) {
+          normalizedGTIN = gtin.substring(1);
+        } else if (!gtin.startsWith("000000")) {
+          normalizedGTIN = gtin.substring(2);
+        } else if (!gtin.startsWith("0000000")) {
+          normalizedGTIN = gtin.substring(6);
+        } else {
+          throw new RangeError(i18nextGS1.t("IdentificationKey.invalidZeroSuppressedGTIN12AsGTIN14"));
+        }
+        break;
+      default:
+        throw new RangeError(i18nextGS1.t("IdentificationKey.invalidGTINLength"));
+    }
+    GTINCreator.validateAny(normalizedGTIN);
+    return normalizedGTIN;
+  }
   /**
    * Validate any GTIN, optionally against a level.
    *
@@ -1205,14 +1324,6 @@ var GTINCreator = class _GTINCreator extends (0, import_ts_mixer.Mixin)(GTINVali
     maximumLength: 1,
     component: () => i18nextGS1.t("IdentificationKey.indicatorDigit")
   };
-  /**
-   * Validation parameters for optional indicator digit.
-   */
-  static OPTIONAL_INDICATOR_DIGIT_VALIDATION = {
-    minimumLength: 0,
-    maximumLength: 1,
-    component: () => i18nextGS1.t("IdentificationKey.indicatorDigit")
-  };
   /**
    * Constructor. Called internally by {@link PrefixManager.gtinCreator}; should not be called by other code.
    *
@@ -1255,115 +1366,6 @@ var GTINCreator = class _GTINCreator extends (0, import_ts_mixer.Mixin)(GTINVali
       return partialIdentificationKey + checkDigit(partialIdentificationKey);
     });
   }
-  /**
-   * Zero suppress a GTIN-12.
-   *
-   * @param gtin12
-   * GTIN-12.
-   *
-   * @returns
-   * Zero-suppressed GTIN-12.
-   */
-  static zeroSuppress(gtin12) {
-    GTIN12_VALIDATOR.validate(gtin12);
-    const d = Array.from(gtin12);
-    let zeroSuppressedGTIN12;
-    if (d[0] === "0" && d[6] === "0" && d[7] === "0") {
-      if (d[10] >= "5" && d[8] === "0" && d[9] === "0" && d[5] !== "0") {
-        zeroSuppressedGTIN12 = `0${d[1]}${d[2]}${d[3]}${d[4]}${d[5]}${d[10]}${d[11]}`;
-      } else if (d[5] === "0" && d[8] === "0" && d[9] === "0" && d[4] !== "0") {
-        zeroSuppressedGTIN12 = `0${d[1]}${d[2]}${d[3]}${d[4]}${d[10]}4${d[11]}`;
-      } else if (d[3] <= "2" && d[4] === "0" && d[5] === "0") {
-        zeroSuppressedGTIN12 = `0${d[1]}${d[2]}${d[8]}${d[9]}${d[10]}${d[3]}${d[11]}`;
-      } else if (d[3] >= "3" && d[4] === "0" && d[5] === "0" && d[8] === "0") {
-        zeroSuppressedGTIN12 = `0${d[1]}${d[2]}${d[3]}${d[9]}${d[10]}3${d[11]}`;
-      }
-    }
-    if (zeroSuppressedGTIN12 === void 0) {
-      throw new RangeError(i18nextGS1.t("IdentificationKey.invalidZeroSuppressibleGTIN12"));
-    }
-    return zeroSuppressedGTIN12;
-  }
-  /**
-   * Convert a GTIN of any length to a GTIN-14 with an optional indicator digit.
-   *
-   * @param indicatorDigit
-   * Indicator digit. If blank, assumes "0" if the GTIN is not already a GTIN-14.
-   *
-   * @param gtin
-   * GTIN.
-   *
-   * @returns
-   * GTIN-14.
-   */
-  static convertToGTIN14(indicatorDigit, gtin) {
-    _GTINCreator.validateAny(gtin);
-    import_utility4.NUMERIC_CREATOR.validate(indicatorDigit, _GTINCreator.OPTIONAL_INDICATOR_DIGIT_VALIDATION);
-    const gtinLength = gtin.length;
-    let gtin14 = "0".repeat(14 /* GTIN14 */ - gtinLength) + gtin;
-    if (indicatorDigit.length !== 0 && indicatorDigit !== gtin14.charAt(0)) {
-      const partialGTIN14 = indicatorDigit + gtin14.substring(1, 14 /* GTIN14 */ - 1);
-      gtin14 = partialGTIN14 + checkDigit(partialGTIN14);
-    }
-    return gtin14;
-  }
-  /**
-   * Normalize a GTIN of any length.
-   * - A GTIN-14 that starts with six zeros or a GTIN-13 that starts with five zeros is normalized to GTIN-8.
-   * - A GTIN-14 that starts with two zeros or a GTIN-13 that starts with one zero is normalized to GTIN-12.
-   * - A GTIN-14 that starts with one zero is normalized to GTIN-13.
-   * - Otherwise, the GTIN is unchanged.
-   *
-   * @param gtin
-   * GTIN.
-   *
-   * @returns
-   * Normalized GTIN.
-   */
-  static normalize(gtin) {
-    const gtinLength = gtin.length;
-    let normalizedGTIN;
-    switch (gtinLength) {
-      case 13 /* GTIN13 */:
-        if (!gtin.startsWith("0")) {
-          normalizedGTIN = gtin;
-        } else if (!gtin.startsWith("00000")) {
-          normalizedGTIN = gtin.substring(1);
-        } else if (!gtin.startsWith("000000")) {
-          normalizedGTIN = gtin.substring(5);
-        } else {
-          throw new RangeError(i18nextGS1.t("IdentificationKey.invalidZeroSuppressedGTIN12AsGTIN13"));
-        }
-        break;
-      case 12 /* GTIN12 */:
-        normalizedGTIN = gtin;
-        break;
-      case 8 /* GTIN8 */:
-        if (!gtin.startsWith("0")) {
-          normalizedGTIN = gtin;
-        } else {
-          normalizedGTIN = _GTINCreator.zeroExpand(gtin);
-        }
-        break;
-      case 14 /* GTIN14 */:
-        if (!gtin.startsWith("0")) {
-          normalizedGTIN = gtin;
-        } else if (!gtin.startsWith("00")) {
-          normalizedGTIN = gtin.substring(1);
-        } else if (!gtin.startsWith("000000")) {
-          normalizedGTIN = gtin.substring(2);
-        } else if (!gtin.startsWith("0000000")) {
-          normalizedGTIN = gtin.substring(6);
-        } else {
-          throw new RangeError(i18nextGS1.t("IdentificationKey.invalidZeroSuppressedGTIN12AsGTIN14"));
-        }
-        break;
-      default:
-        throw new RangeError(i18nextGS1.t("IdentificationKey.invalidGTINLength"));
-    }
-    _GTINCreator.validateAny(normalizedGTIN);
-    return normalizedGTIN;
-  }
 };
 var NonGTINNumericIdentificationKeyCreator = class extends (0, import_ts_mixer.Mixin)(NonGTINNumericIdentificationKeyValidator, AbstractNumericIdentificationKeyCreator) {
   /**
@@ -1645,6 +1647,10 @@ var PrefixManager = class _PrefixManager {
    * GS1-8 Prefix if prefix type is {@link PrefixType.GS18Prefix}.
    */
   _gs18Prefix;
+  /**
+   * Default tweak factor.
+   */
+  _defaultTweakFactor;
   /**
    * Tweak factor.
    */
@@ -1673,6 +1679,7 @@ var PrefixManager = class _PrefixManager {
       this._gs18Prefix = gs1CompanyPrefix.substring(5);
       this._prefix = this._gs18Prefix;
     }
+    this._defaultTweakFactor = BigInt(`1${this.gs1CompanyPrefix}`);
     this.resetTweakFactor();
   }
   /**
@@ -1742,7 +1749,7 @@ var PrefixManager = class _PrefixManager {
    * Reset the tweak factor to its default (numeric value of the GS1 Company Prefix preceded by '1').
    */
   resetTweakFactor() {
-    this.tweakFactor = BigInt("1" + this.gs1CompanyPrefix);
+    this.tweakFactor = this._defaultTweakFactor;
   }
   /**
    * Get a prefix manager.
@@ -1769,6 +1776,9 @@ var PrefixManager = class _PrefixManager {
       case 2 /* GS18Prefix */:
         gs1CompanyPrefix = "00000" + prefix;
         break;
+      // eslint-disable-next-line @typescript-eslint/switch-exhaustiveness-check -- Method may be called by unsafe means.
+      default:
+        throw new RangeError(i18nextGS1.t("Prefix.invalidPrefixType"));
     }
     let prefixManager = _PrefixManager.PREFIX_MANAGERS_MAP.get(gs1CompanyPrefix);
     if (prefixManager === void 0) {

package/dist/index.d.cts

@@ -31,6 +31,7 @@ declare const localeStrings: {
         readonly gs1CompanyPrefix: "GS1 Company Prefix";
         readonly upcCompanyPrefix: "U.P.C. Company Prefix";
         readonly gs18Prefix: "GS1-8 Prefix";
+        readonly invalidPrefixType: "Invalid prefix type";
         readonly gs1CompanyPrefixCantStartWith0: "GS1 Company Prefix can't start with \"0\"";
         readonly gs1CompanyPrefixCantStartWith00000: "GS1 Company Prefix can't start with \"00000\"";
         readonly gs1CompanyPrefixCantStartWith000000: "GS1 Company Prefix can't start with \"000000\"";
@@ -78,6 +79,7 @@ declare const gs1Resources: {
                 readonly gs1CompanyPrefix: "GS1 Company Prefix";
                 readonly upcCompanyPrefix: "U.P.C. Company Prefix";
                 readonly gs18Prefix: "GS1-8 Prefix";
+                readonly invalidPrefixType: "Invalid prefix type";
                 readonly gs1CompanyPrefixCantStartWith0: "GS1 Company Prefix can't start with \"0\"";
                 readonly gs1CompanyPrefixCantStartWith00000: "GS1 Company Prefix can't start with \"00000\"";
                 readonly gs1CompanyPrefixCantStartWith000000: "GS1 Company Prefix can't start with \"000000\"";
@@ -116,6 +118,7 @@ declare const gs1Resources: {
                 readonly gs1CompanyPrefix: "Préfixe de l'entreprise GS1";
                 readonly upcCompanyPrefix: "Préfixe de l'entreprise U.P.C.";
                 readonly gs18Prefix: "Préfixe GS1-8";
+                readonly invalidPrefixType: "Type de préfixe invalide";
                 readonly gs1CompanyPrefixCantStartWith0: "Le préfixe de l'entreprise GS1 ne peut pas commencer par \"0\"";
                 readonly gs1CompanyPrefixCantStartWith00000: "Le préfixe de l'entreprise GS1 ne peut pas commencer par \"00000\"";
                 readonly gs1CompanyPrefixCantStartWith000000: "Le préfixe de l'entreprise GS1 ne peut pas commencer par \"000000\"";
@@ -333,7 +336,7 @@ interface IdentificationKeyValidation extends StringValidation {
  * Identification key validator. Validates an identification key against its definition in section 3 of the {@link
  * https://www.gs1.org/genspecs | GS1 General Specifications}.
  */
-interface IdentificationKeyValidator<V extends IdentificationKeyValidation = IdentificationKeyValidation> extends StringValidator<V> {
+interface IdentificationKeyValidator<TIdentificationKeyValidation extends IdentificationKeyValidation = IdentificationKeyValidation> extends StringValidator<TIdentificationKeyValidation> {
     /**
      * Get the identification key type. Per the GS1 General Specifications, the identification key type determines
      * the remaining properties.
@@ -366,12 +369,12 @@ interface IdentificationKeyValidator<V extends IdentificationKeyValidation = Ide
      * @param validation
      * Identification key validation parameters.
      */
-    validate: (identificationKey: string, validation?: V) => void;
+    validate: (identificationKey: string, validation?: TIdentificationKeyValidation) => void;
 }
 /**
  * Abstract identification key validator. Implements common functionality for an identification key validator.
  */
-declare abstract class AbstractIdentificationKeyValidator<V extends IdentificationKeyValidation = IdentificationKeyValidation> implements IdentificationKeyValidator<V> {
+declare abstract class AbstractIdentificationKeyValidator<TIdentificationKeyValidation extends IdentificationKeyValidation = IdentificationKeyValidation> implements IdentificationKeyValidator<TIdentificationKeyValidation> {
     private static readonly CHARACTER_SET_CREATORS;
     /**
      * Identification key type.
@@ -463,7 +466,7 @@ declare abstract class AbstractIdentificationKeyValidator<V extends Identificati
      * Position offset within a larger string.
      */
     protected validatePrefix(partialIdentificationKey: string, positionOffset?: number): void;
-    abstract validate(identificationKey: string, validation?: V): void;
+    abstract validate(identificationKey: string, validation?: TIdentificationKeyValidation): void;
 }
 /**
  * Leader type.
@@ -572,7 +575,11 @@ declare enum GTINLevel {
  */
 declare class GTINValidator extends AbstractNumericIdentificationKeyValidator {
     /**
-     * Zero-suppressed GTIN-12 validation parameters.
+     * Validation parameters for optional indicator digit.
+     */
+    private static readonly OPTIONAL_INDICATOR_DIGIT_VALIDATION;
+    /**
+     * Validation parameters for zero-suppressed GTIN-12.
      */
     private static readonly ZERO_SUPPRESSED_GTIN12_VALIDATION;
     /**
@@ -590,6 +597,16 @@ declare class GTINValidator extends AbstractNumericIdentificationKeyValidator {
      * @inheritDoc
      */
     protected validatePrefix(partialIdentificationKey: string, positionOffset?: number): void;
+    /**
+     * Zero suppress a GTIN-12.
+     *
+     * @param gtin12
+     * GTIN-12.
+     *
+     * @returns
+     * Zero-suppressed GTIN-12.
+     */
+    static zeroSuppress(gtin12: string): string;
     /**
      * Zero expand a zero-suppressed GTIN-12.
      *
@@ -600,6 +617,33 @@ declare class GTINValidator extends AbstractNumericIdentificationKeyValidator {
      * GTIN-12.
      */
     static zeroExpand(zeroSuppressedGTIN12: string): string;
+    /**
+     * Convert a GTIN of any length to a GTIN-14 with an optional indicator digit.
+     *
+     * @param indicatorDigit
+     * Indicator digit. If blank, assumes "0" if the GTIN is not already a GTIN-14.
+     *
+     * @param gtin
+     * GTIN.
+     *
+     * @returns
+     * GTIN-14.
+     */
+    static convertToGTIN14(indicatorDigit: string, gtin: string): string;
+    /**
+     * Normalize a GTIN of any length.
+     * - A GTIN-14 that starts with six zeros or a GTIN-13 that starts with five zeros is normalized to GTIN-8.
+     * - A GTIN-14 that starts with two zeros or a GTIN-13 that starts with one zero is normalized to GTIN-12.
+     * - A GTIN-14 that starts with one zero is normalized to GTIN-13.
+     * - Otherwise, the GTIN is unchanged.
+     *
+     * @param gtin
+     * GTIN.
+     *
+     * @returns
+     * Normalized GTIN.
+     */
+    static normalize(gtin: string): string;
     /**
      * Validate any GTIN, optionally against a level.
      *
@@ -895,7 +939,7 @@ interface NumericIdentificationKeyCreator extends NumericIdentificationKeyValida
      * @returns
      * Identification key(s).
      */
-    create: <T extends TransformerInput<number | bigint>>(valueOrValues: T, sparse?: boolean) => TransformerOutput<T, string>;
+    create: <TTransformerInput extends TransformerInput<number | bigint>>(valueOrValues: TTransformerInput, sparse?: boolean) => TransformerOutput<TTransformerInput, string>;
     /**
      * Create all identification keys for the prefix from `0` to `capacity - 1`.
      *
@@ -956,7 +1000,7 @@ declare abstract class AbstractNumericIdentificationKeyCreator extends AbstractI
     /**
      * @inheritDoc
      */
-    create<T extends TransformerInput<number | bigint>>(valueOrValues: T, sparse?: boolean): TransformerOutput<T, string>;
+    create<TTransformerInput extends TransformerInput<number | bigint>>(valueOrValues: TTransformerInput, sparse?: boolean): TransformerOutput<TTransformerInput, string>;
     /**
      * Create all identification keys from a partial identification key. Call is recursive until remaining reference
      * length is 0.
@@ -995,10 +1039,6 @@ declare class GTINCreator extends GTINCreator_base {
      * Validation parameters for required indicator digit.
      */
     private static readonly REQUIRED_INDICATOR_DIGIT_VALIDATION;
-    /**
-     * Validation parameters for optional indicator digit.
-     */
-    private static readonly OPTIONAL_INDICATOR_DIGIT_VALIDATION;
     /**
      * Constructor. Called internally by {@link PrefixManager.gtinCreator}; should not be called by other code.
      *
@@ -1029,44 +1069,7 @@ declare class GTINCreator extends GTINCreator_base {
      * @returns
      * GTIN-14(s).
      */
-    createGTIN14<T extends TransformerInput<number | bigint>>(indicatorDigit: string, valueOrValues: T, sparse?: boolean): TransformerOutput<T, string>;
-    /**
-     * Zero suppress a GTIN-12.
-     *
-     * @param gtin12
-     * GTIN-12.
-     *
-     * @returns
-     * Zero-suppressed GTIN-12.
-     */
-    static zeroSuppress(gtin12: string): string;
-    /**
-     * Convert a GTIN of any length to a GTIN-14 with an optional indicator digit.
-     *
-     * @param indicatorDigit
-     * Indicator digit. If blank, assumes "0" if the GTIN is not already a GTIN-14.
-     *
-     * @param gtin
-     * GTIN.
-     *
-     * @returns
-     * GTIN-14.
-     */
-    static convertToGTIN14(indicatorDigit: string, gtin: string): string;
-    /**
-     * Normalize a GTIN of any length.
-     * - A GTIN-14 that starts with six zeros or a GTIN-13 that starts with five zeros is normalized to GTIN-8.
-     * - A GTIN-14 that starts with two zeros or a GTIN-13 that starts with one zero is normalized to GTIN-12.
-     * - A GTIN-14 that starts with one zero is normalized to GTIN-13.
-     * - Otherwise, the GTIN is unchanged.
-     *
-     * @param gtin
-     * GTIN.
-     *
-     * @returns
-     * Normalized GTIN.
-     */
-    static normalize(gtin: string): string;
+    createGTIN14<TTransformerInput extends TransformerInput<number | bigint>>(indicatorDigit: string, valueOrValues: TTransformerInput, sparse?: boolean): TransformerOutput<TTransformerInput, string>;
 }
 declare const NonGTINNumericIdentificationKeyCreator_base: ts_mixer_dist_types_types_js.Class<any[], NonGTINNumericIdentificationKeyValidator & AbstractNumericIdentificationKeyCreator, typeof NonGTINNumericIdentificationKeyValidator & typeof AbstractNumericIdentificationKeyCreator>;
 /**
@@ -1145,7 +1148,7 @@ declare class SerializableNumericIdentificationKeyCreator extends SerializableNu
      * @returns
      * Serialized identification keys.
      */
-    createSerialized<T extends TransformerInput<string>>(value: number, serialComponentOrComponents: T, sparse?: boolean): TransformerOutput<T, string>;
+    createSerialized<TTransformerInput extends TransformerInput<string>>(value: number, serialComponentOrComponents: TTransformerInput, sparse?: boolean): TransformerOutput<TTransformerInput, string>;
     /**
      * Concatenate a base identification key with serial component(s).
      *
@@ -1158,7 +1161,7 @@ declare class SerializableNumericIdentificationKeyCreator extends SerializableNu
      * @returns
      * Serialized identification key(s).
      */
-    concatenate<T extends TransformerInput<string>>(baseIdentificationKey: string, serialComponentOrComponents: T): TransformerOutput<T, string>;
+    concatenate<TTransformerInput extends TransformerInput<string>>(baseIdentificationKey: string, serialComponentOrComponents: TTransformerInput): TransformerOutput<TTransformerInput, string>;
 }
 declare const NonNumericIdentificationKeyCreator_base: ts_mixer_dist_types_types_js.Class<any[], NonNumericIdentificationKeyValidator & AbstractIdentificationKeyCreator, typeof NonNumericIdentificationKeyValidator & typeof AbstractIdentificationKeyCreator>;
 /**
@@ -1202,7 +1205,7 @@ declare class NonNumericIdentificationKeyCreator extends NonNumericIdentificatio
      * @returns
      * Identification key(s).
      */
-    create<T extends TransformerInput<string>>(referenceOrReferences: T): TransformerOutput<T, string>;
+    create<TTransformerInput extends TransformerInput<string>>(referenceOrReferences: TTransformerInput): TransformerOutput<TTransformerInput, string>;
 }
 /**
  * Prefix manager. This is the core class for identification key creation.
@@ -1299,6 +1302,10 @@ declare class PrefixManager {
      * GS1-8 Prefix if prefix type is {@link PrefixType.GS18Prefix}.
      */
     private readonly _gs18Prefix;
+    /**
+     * Default tweak factor.
+     */
+    private readonly _defaultTweakFactor;
     /**
      * Tweak factor.
      */