@aidc-toolkit/gs1 1.0.25-beta → 1.0.26-beta

package/dist/index.d.cts

@@ -1,1949 +0,0 @@
-import { I18nEnvironment } from '@aidc-toolkit/core';
-import { Resource, i18n } from 'i18next';
-import { CharacterSetCreator, CharacterSetValidator, CharacterSetValidation, StringValidation, StringValidator, Exclusions, TransformerInput, TransformerOutput } from '@aidc-toolkit/utility';
-import * as ts_mixer_dist_types_types from 'ts-mixer/dist/types/types';
-
-declare const _default: {
-    readonly Check: {
-        readonly lengthOfStringForPriceOrWeightMustBeExactly: "Length {{length, number}} of string for price or weight must be 4 or 5";
-        readonly priceOrWeightComponent: "price or weight";
-        readonly lengthOfStringForCheckCharacterPairMustBeLessThanOrEqualTo: "Length {{length, number}} of string for check character pair must be less than or equal to {{maximumLength, number}}";
-    };
-    readonly Identifier: {
-        readonly identifierTypeLength: "{{identifierType}} must be {{length, number}} digits long";
-        readonly invalidCheckDigit: "Invalid check digit";
-        readonly invalidGTINLength: "GTIN must be 13, 12, 8, or 14 digits long";
-        readonly invalidGTIN14Length: "GTIN must be 14 digits long";
-        readonly invalidZeroSuppressedGTIN12: "Invalid zero-suppressed GTIN-12";
-        readonly invalidZeroSuppressibleGTIN12: "GTIN-12 not zero-suppressible";
-        readonly invalidZeroSuppressedGTIN12AsGTIN13: "Invalid zero-suppressed GTIN-12 as GTIN-13";
-        readonly invalidZeroSuppressedGTIN12AsGTIN14: "Invalid zero-suppressed GTIN-12 as GTIN-14";
-        readonly invalidGTIN13AtRetail: "GTIN-13 at retail consumer trade item level can't start with zero";
-        readonly invalidGTINAtRetail: "GTIN not supported at retail consumer trade item level";
-        readonly invalidGTINAtOtherThanRetail: "GTIN not supported at other than retail consumer trade item level";
-        readonly invalidRCNLength: "RCN length must match format length";
-        readonly invalidVariableMeasureRCNFormat: "Invalid variable measure RCN format";
-        readonly invalidVariableMeasureRCNPrefix: "Invalid variable measure RCN prefix";
-        readonly invalidVariableMeasurePriceOrWeight: "Invalid variable measure price or weight";
-        readonly indicatorDigit: "indicator digit";
-        readonly serialComponent: "serial component";
-        readonly reference: "reference";
-        readonly referenceCantBeAllNumeric: "Reference can't be all-numeric";
-        readonly invalidCheckCharacterPair: "Invalid check character pair";
-    };
-    readonly Prefix: {
-        readonly gs1CompanyPrefix: "GS1 Company Prefix";
-        readonly upcCompanyPrefix: "U.P.C. Company Prefix";
-        readonly gs18Prefix: "GS1-8 Prefix";
-        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\"";
-        readonly upcCompanyPrefixCantStartWith0000: "U.P.C. Company Prefix can't start with \"0000\"";
-        readonly gs18PrefixCantStartWith0: "GS1-8 Prefix can't start with \"0\"";
-        readonly identifierTypeNotSupportedByGS18Prefix: "{{identifierType}} not supported by GS1-8 Prefix";
-    };
-};
-
-declare const gs1NS = "aidct_gs1";
-/**
- * Locale strings type is extracted from the English locale strings object.
- */
-type GS1LocaleResources = typeof _default;
-/**
- * GS1 resources.
- */
-declare const gs1Resources: Resource;
-declare const i18nextGS1: i18n;
-/**
- * Initialize internationalization.
- *
- * @param environment
- * Environment in which the application is running.
- *
- * @param debug
- * Debug setting.
- *
- * @returns
- * Void promise.
- */
-declare function i18nGS1Init(environment: I18nEnvironment, debug?: boolean): Promise<void>;
-
-/**
- * GS1 AI encodable character set 82 creator as defined in section 7.11 of the {@link
- * https://ref.gs1.org/standards/genspecs/ | GS1 General Specifications}. Supports {@linkcode Exclusions.AllNumeric}.
- */
-declare const AI82_CREATOR: CharacterSetCreator;
-/**
- * GS1 AI encodable character set 82 validator as defined in section 7.11 of the {@link
- * https://ref.gs1.org/standards/genspecs/ | GS1 General Specifications}. Supports {@linkcode Exclusions.AllNumeric}.
- */
-declare const AI82_VALIDATOR: CharacterSetValidator;
-/**
- * GS1 AI encodable character set 39 creator as defined in section 7.11 of the {@link
- * https://ref.gs1.org/standards/genspecs/ | GS1 General Specifications}. Supports {@linkcode Exclusions.AllNumeric}.
- */
-declare const AI39_CREATOR: CharacterSetCreator;
-/**
- * GS1 AI encodable character set 39 validator as defined in section 7.11 of the {@link
- * https://ref.gs1.org/standards/genspecs/ | GS1 General Specifications}. Supports {@linkcode Exclusions.AllNumeric}.
- */
-declare const AI39_VALIDATOR: CharacterSetValidator;
-/**
- * GS1 AI encodable character set 64 validator as defined in section 7.11 of the {@link
- * https://ref.gs1.org/standards/genspecs/ | GS1 General Specifications}. Doesn't support any exclusions.
- */
-declare const AI64_VALIDATOR: CharacterSetValidator;
-
-/**
- * Calculate the check digit sum for a numeric string as per section 7.9.1 of the {@link
- * https://ref.gs1.org/standards/genspecs/ | GS1 General Specifications}.
- *
- * @param exchangeWeights
- * If true, start the weights at 1 instead of 3 on the right.
- *
- * @param s
- * Numeric string.
- *
- * @returns
- * Accumulated sum of each digit multiplied by the weight at its position.
- */
-declare function checkDigitSum(exchangeWeights: boolean, s: string): number;
-/**
- * Calculate the check digit for a numeric string as per section 7.9.1 of the {@link
- * https://ref.gs1.org/standards/genspecs/ | GS1 General Specifications}.
- *
- * @param s
- * Numeric string.
- *
- * @returns
- * Check digit 0-9 as a string.
- */
-declare function checkDigit(s: string): string;
-/**
- * Determine if a numeric string has a valid check digit.
- *
- * @param s
- * Numeric string with check digit.
- *
- * @returns
- * True if the check digit is valid.
- */
-declare function hasValidCheckDigit(s: string): boolean;
-/**
- * Calculate the price or weight check digit for a four-or five-digit numeric string as per sections 7.9.2-7.9.4 of the
- * {@link https://ref.gs1.org/standards/genspecs/ | GS1 General Specifications}.
- *
- * @param s
- * Numeric string exactly four or five characters long.
- *
- * @returns
- * Check digit 0-9 as a string.
- */
-declare function priceOrWeightCheckDigit(s: string): string;
-/**
- * Determine if a price or weight check digit is valid for numeric string.
- *
- * @param s
- * Numeric string exactly four or five characters long.
- *
- * @param checkDigit
- * Price or weight check digit.
- *
- * @returns
- * True if the check digit is valid.
- */
-declare function isValidPriceOrWeightCheckDigit(s: string, checkDigit: string): boolean;
-/**
- * Calculate the check character for a GS1 AI encodable character set 82 string as per section 7.9.5 of the {@link
- * https://ref.gs1.org/standards/genspecs/ | GS1 General Specifications}.
- *
- * @param s
- * GS1 AI encodable character set 82 string.
- *
- * @returns
- * Check character pair.
- */
-declare function checkCharacterPair(s: string): string;
-/**
- * Determine if a GS1 AI encodable character set 82 string has a valid check character pair.
- *
- * @param s
- * GS1 AI encodable character set 82 string with check character pair.
- *
- * @returns
- * True if the check character pair is valid.
- */
-declare function hasValidCheckCharacterPair(s: string): boolean;
-
-/**
- * Prefix types.
- */
-declare const PrefixTypes: {
-    /**
-     * GS1 Company Prefix.
-     */
-    readonly GS1CompanyPrefix: "GS1 Company Prefix";
-    /**
-     * U.P.C. Company Prefix.
-     */
-    readonly UPCCompanyPrefix: "U.P.C. Company Prefix";
-    /**
-     * GS1-8 Prefix.
-     */
-    readonly GS18Prefix: "GS1-8 Prefix";
-};
-/**
- * Prefix type key.
- */
-type PrefixTypeKey = keyof typeof PrefixTypes;
-/**
- * Prefix type.
- */
-type PrefixType = typeof PrefixTypes[PrefixTypeKey];
-
-/**
- * Prefix provider.
- */
-interface PrefixProvider {
-    /**
-     * Prefix type.
-     */
-    readonly prefixType: PrefixType;
-    /**
-     * Prefix appropriate to the prefix type.
-     */
-    readonly prefix: string;
-    /**
-     * Prefix as GS1 Company Prefix.
-     */
-    readonly gs1CompanyPrefix: string;
-    /**
-     * Prefix as U.P.C. Company Prefix if prefix type is {@linkcode PrefixTypes.UPCCompanyPrefix} or undefined if not.
-     */
-    readonly upcCompanyPrefix: string | undefined;
-    /**
-     * Prefix as GS1-8 Prefix if prefix type is {@linkcode PrefixTypes.GS18Prefix} or undefined if not.
-     */
-    readonly gs18Prefix: string | undefined;
-}
-
-/**
- * Prefix validation parameters.
- */
-interface PrefixValidation extends CharacterSetValidation {
-    /**
-     * Minimum length.
-     */
-    minimumLength: number;
-    /**
-     * Maximum length.
-     */
-    maximumLength: number;
-    /**
-     * Callback to localized prefix type name.
-     */
-    component: () => string;
-}
-/**
- * Prefix validator.
- */
-declare const PrefixValidator: {
-    readonly GS1_COMPANY_PREFIX_MINIMUM_LENGTH: 4;
-    readonly GS1_COMPANY_PREFIX_MAXIMUM_LENGTH: 12;
-    readonly UPC_COMPANY_PREFIX_MINIMUM_LENGTH: 6;
-    readonly UPC_COMPANY_PREFIX_MAXIMUM_LENGTH: 11;
-    readonly GS1_8_PREFIX_MINIMUM_LENGTH: 2;
-    readonly GS1_8_PREFIX_MAXIMUM_LENGTH: 7;
-    /**
-     * Validate a prefix.
-     *
-     * @param prefixType
-     * Prefix type.
-     *
-     * @param allowUPCCompanyPrefix
-     * If true, a U.P.C. Company Prefix expressed as a GS1 Company Prefix is permitted.
-     *
-     * @param allowGS18Prefix
-     * If true, a GS1-8 Prefix expressed as a GS1 Company Prefix is permitted.
-     *
-     * @param prefix
-     * Prefix.
-     *
-     * @param isFromIdentifier
-     * If true, the prefix is from an identifier and should be trimmed before its character set is validated.
-     *
-     * @param isNumericIdentifier
-     * If true, the prefix is from a numeric identifier and its character set will be validated by the caller.
-     *
-     * @param positionOffset
-     * Position offset within a larger string.
-     */
-    readonly validate: (prefixType: PrefixType, allowUPCCompanyPrefix: boolean, allowGS18Prefix: boolean, prefix: string, isFromIdentifier?: boolean, isNumericIdentifier?: boolean, positionOffset?: number) => void;
-    /**
-     * Normalize a prefix.
-     *
-     * @param prefixType
-     * Prefix type.
-     *
-     * @param prefix
-     * Prefix.
-     *
-     * @returns
-     * Prefix provider with normalized prefix type and prefix.
-     */
-    readonly normalize: (prefixType: PrefixType, prefix: string) => PrefixProvider;
-};
-
-/**
- * Character sets supported by the reference portion of an identifier or the serial component of a numeric identifier.
- */
-declare const ContentCharacterSets: {
-    /**
-     * Numeric.
-     */
-    readonly Numeric: "Numeric";
-    /**
-     * GS1 AI encodable character set 82.
-     */
-    readonly AI82: "AI82";
-    /**
-     * GS1 AI encodable character set 39.
-     */
-    readonly AI39: "AI39";
-};
-/**
- * Content character set key.
- */
-type ContentCharacterSetKey = keyof typeof ContentCharacterSets;
-/**
- * Content character set.
- */
-type ContentCharacterSet = typeof ContentCharacterSets[ContentCharacterSetKey];
-
-/**
- * Identifier types.
- */
-declare const IdentifierTypes: {
-    /**
-     * Global Trade Item Number.
-     */
-    readonly GTIN: "GTIN";
-    /**
-     * Global Location Number.
-     */
-    readonly GLN: "GLN";
-    /**
-     * Serial Shipping Container Code.
-     */
-    readonly SSCC: "SSCC";
-    /**
-     * Global Returnable Asset Identifier.
-     */
-    readonly GRAI: "GRAI";
-    /**
-     * Global Individual Asset Identifier.
-     */
-    readonly GIAI: "GIAI";
-    /**
-     * Global Service Relation Number.
-     */
-    readonly GSRN: "GSRN";
-    /**
-     * Global Document Type Identifier.
-     */
-    readonly GDTI: "GDTI";
-    /**
-     * Global Identification Number for Consignment.
-     */
-    readonly GINC: "GINC";
-    /**
-     * Global Shipment Identification Number.
-     */
-    readonly GSIN: "GSIN";
-    /**
-     * Global Coupon Number.
-     */
-    readonly GCN: "GCN";
-    /**
-     * Component/Part Identifier.
-     */
-    readonly CPID: "CPID";
-    /**
-     * Global Model Number.
-     */
-    readonly GMN: "GMN";
-};
-/**
- * Identifier type key.
- */
-type IdentifierTypeKey = keyof typeof IdentifierTypes;
-/**
- * Identifier type.
- */
-type IdentifierType = typeof IdentifierTypes[IdentifierTypeKey];
-
-/**
- * Numeric identifier type.
- */
-type NumericIdentifierType = typeof IdentifierTypes.GTIN | typeof IdentifierTypes.GLN | typeof IdentifierTypes.SSCC | typeof IdentifierTypes.GRAI | typeof IdentifierTypes.GSRN | typeof IdentifierTypes.GDTI | typeof IdentifierTypes.GSIN | typeof IdentifierTypes.GCN;
-/**
- * Leader type.
- */
-declare const LeaderTypes: {
-    /**
-     * No leader.
-     */
-    readonly None: "None";
-    /**
-     * Indicator digit (GTIN only).
-     */
-    readonly IndicatorDigit: "Indicator digit";
-    /**
-     * Extension digit (SSCC only).
-     */
-    readonly ExtensionDigit: "Extension digit";
-};
-/**
- * Leader type key.
- */
-type LeaderTypeKey = keyof typeof LeaderTypes;
-/**
- * Leader type.
- */
-type LeaderType = typeof LeaderTypes[LeaderTypeKey];
-
-/**
- * GTIN types. The numeric values are equal to the lengths of the GTIN types.
- */
-declare const GTINTypes: {
-    /**
-     * GTIN-13.
-     */
-    readonly GTIN13: 13;
-    /**
-     * GTIN-12.
-     */
-    readonly GTIN12: 12;
-    /**
-     * GTIN-8.
-     */
-    readonly GTIN8: 8;
-    /**
-     * GTIN-14.
-     */
-    readonly GTIN14: 14;
-};
-/**
- * GTIN type key.
- */
-type GTINTypeKey = keyof typeof GTINTypes;
-/**
- * GTIN type.
- */
-type GTINType = typeof GTINTypes[GTINTypeKey];
-/**
- * GTIN base type (all except GTIN-14).
- */
-type GTINBaseType = Exclude<GTINType, typeof GTINTypes.GTIN14>;
-/**
- * GTIN base types by prefix type.
- */
-declare const GTIN_BASE_TYPES: Readonly<Record<PrefixType, GTINBaseType>>;
-
-/**
- * Non-GTIN numeric identifier type.
- */
-type NonGTINNumericIdentifierType = Exclude<NumericIdentifierType, typeof IdentifierTypes.GTIN>;
-
-/**
- * Serializable numeric identifier type.
- */
-type SerializableNumericIdentifierType = typeof IdentifierTypes.GRAI | typeof IdentifierTypes.GDTI | typeof IdentifierTypes.GCN;
-
-/**
- * Non-numeric identifier type.
- */
-type NonNumericIdentifierType = Exclude<IdentifierType, NumericIdentifierType>;
-
-/**
- * Identifier descriptor. Instantiations of this type are used to parameterize validators and creators.
- */
-interface IdentifierDescriptor {
-    /**
-     * Identifier type. Per the GS1 General Specifications, the identifier type determines the remaining properties.
-     */
-    readonly identifierType: IdentifierType;
-    /**
-     * Prefix type supported by the identifier type. For all identifier types except the GTIN, this is a GS1 Company
-     * Prefix. For the GTIN, the prefix type determines the length.
-     */
-    readonly prefixType: PrefixType;
-    /**
-     * Length. For numeric identifier types, the length is fixed; for non-numeric identifier types, the length is the
-     * maximum.
-     */
-    readonly length: number;
-    /**
-     * Reference character set.
-     */
-    readonly referenceCharacterSet: ContentCharacterSet;
-}
-
-/**
- * Numeric identifier descriptor.
- */
-interface NumericIdentifierDescriptor extends IdentifierDescriptor {
-    /**
-     * @inheritDoc
-     */
-    readonly identifierType: NumericIdentifierType;
-    /**
-     * @inheritDoc
-     */
-    readonly referenceCharacterSet: typeof ContentCharacterSets.Numeric;
-    /**
-     * Leader type.
-     */
-    readonly leaderType: LeaderType;
-}
-
-/**
- * GTIN descriptor.
- */
-interface GTINDescriptor extends NumericIdentifierDescriptor {
-    /**
-     * @inheritDoc
-     */
-    readonly identifierType: typeof IdentifierTypes.GTIN;
-    /**
-     * @inheritDoc
-     */
-    readonly leaderType: typeof LeaderTypes.IndicatorDigit;
-}
-
-/**
- * Non-GTIN numeric identifier descriptor.
- */
-interface NonGTINNumericIdentifierDescriptor extends NumericIdentifierDescriptor {
-    /**
-     * @inheritDoc
-     */
-    readonly identifierType: NonGTINNumericIdentifierType;
-    /**
-     * @inheritDoc
-     */
-    readonly prefixType: typeof PrefixTypes.GS1CompanyPrefix;
-    /**
-     * @inheritDoc
-     */
-    readonly leaderType: Exclude<LeaderType, typeof LeaderTypes.IndicatorDigit>;
-}
-
-/**
- * Serializable numeric identifier descriptor.
- */
-interface SerializableNumericIdentifierDescriptor extends NonGTINNumericIdentifierDescriptor {
-    /**
-     * @inheritDoc
-     */
-    readonly identifierType: SerializableNumericIdentifierType;
-    /**
-     * @inheritDoc
-     */
-    readonly leaderType: typeof LeaderTypes.None;
-    /**
-     * Serial component length.
-     */
-    readonly serialComponentLength: number;
-    /**
-     * Serial component character set.
-     */
-    readonly serialComponentCharacterSet: ContentCharacterSet;
-}
-
-/**
- * Non-numeric identifier descriptor.
- */
-interface NonNumericIdentifierDescriptor extends IdentifierDescriptor {
-    /**
-     * @inheritDoc
-     */
-    readonly identifierType: NonNumericIdentifierType;
-    /**
-     * @inheritDoc
-     */
-    readonly prefixType: typeof PrefixTypes.GS1CompanyPrefix;
-    /**
-     * @inheritDoc
-     */
-    readonly referenceCharacterSet: Exclude<ContentCharacterSet, typeof ContentCharacterSets.Numeric>;
-    /**
-     * True if identifier requires a check character pair.
-     */
-    readonly requiresCheckCharacterPair: boolean;
-}
-
-/**
- * Identifier descriptor type based on identifier type type.
- *
- * @template TIdentifierType
- * Identifier type type.
- */
-type IdentifierTypeDescriptor<TIdentifierType extends IdentifierType> = TIdentifierType extends NonNumericIdentifierType ? NonNumericIdentifierDescriptor : TIdentifierType extends SerializableNumericIdentifierType ? SerializableNumericIdentifierDescriptor : TIdentifierType extends NonGTINNumericIdentifierType ? NonGTINNumericIdentifierDescriptor : TIdentifierType extends typeof IdentifierTypes.GTIN ? GTINDescriptor : IdentifierDescriptor;
-/**
- * Identifier descriptors entry type based on identifier type type.
- *
- * @template TIdentifierType
- * Identifier type type.
- */
-type IdentifierDescriptorsEntry<TIdentifierType extends IdentifierType> = TIdentifierType extends typeof IdentifierTypes.GTIN ? Readonly<Record<GTINBaseType, GTINDescriptor>> : IdentifierTypeDescriptor<TIdentifierType>;
-/**
- * Identifier descriptors record type.
- */
-type IdentifierDescriptorsRecord = {
-    [TIdentifierType in IdentifierType]: IdentifierDescriptorsEntry<TIdentifierType>;
-};
-/**
- * Identifier descriptors for all identifier types.
- */
-declare const IdentifierDescriptors: IdentifierDescriptorsRecord;
-/**
- * Determine if identifier descriptors or descriptor is GTIN descriptors.
- *
- * @param identifierDescriptorsOrDescriptor
- * Identifier descriptors or descriptor.
- *
- * @returns
- * True if GTIN descriptors.
- */
-declare function isGTINDescriptors(identifierDescriptorsOrDescriptor: IdentifierDescriptorsEntry<IdentifierType>): identifierDescriptorsOrDescriptor is Readonly<Record<GTINBaseType, GTINDescriptor>>;
-/**
- * Determine if identifier descriptor is a numeric identifier descriptor.
- *
- * @param identifierDescriptor
- * Identifier descriptor.
- *
- * @returns
- * True if identifier descriptor is a numeric identifier descriptor.
- */
-declare function isNumericIdentifierDescriptor(identifierDescriptor: IdentifierDescriptor): identifierDescriptor is NumericIdentifierDescriptor;
-/**
- * Determine if identifier descriptor is a GTIN descriptor.
- *
- * @param identifierDescriptor
- * Identifier descriptor.
- *
- * @returns
- * True if identifier descriptor is a GTIN descriptor.
- */
-declare function isGTINDescriptor(identifierDescriptor: IdentifierDescriptor): identifierDescriptor is GTINDescriptor;
-/**
- * Determine if identifier descriptor is a non-GTIN numeric identifier descriptor.
- *
- * @param identifierDescriptor
- * Identifier descriptor.
- *
- * @returns
- * True if identifier descriptor is a non-GTIN numeric identifier descriptor.
- */
-declare function isNonGTINNumericIdentifierDescriptor(identifierDescriptor: IdentifierDescriptor): identifierDescriptor is NonGTINNumericIdentifierDescriptor;
-/**
- * Determine if identifier descriptor is a serializable numeric identifier descriptor.
- *
- * @param identifierDescriptor
- * Identifier descriptor.
- *
- * @returns
- * True if identifier descriptor is a serializable numeric identifier descriptor.
- */
-declare function isSerializableNumericIdentifierDescriptor(identifierDescriptor: IdentifierDescriptor): identifierDescriptor is SerializableNumericIdentifierDescriptor;
-/**
- * Determine if identifier descriptor is a non-numeric identifier descriptor.
- *
- * @param identifierDescriptor
- * Identifier descriptor.
- *
- * @returns
- * True if identifier descriptor is a non-numeric identifier descriptor.
- */
-declare function isNonNumericIdentifierDescriptor(identifierDescriptor: IdentifierDescriptor): identifierDescriptor is NonNumericIdentifierDescriptor;
-
-/**
- * Identifier validation parameters.
- */
-interface IdentifierValidation extends StringValidation {
-}
-/**
- * Identifier validator. Validates an identifier against its definition in section 3 of the {@link
- * https://ref.gs1.org/standards/genspecs/ | GS1 General Specifications}.
- *
- * @template TIdentifierDescriptor
- * Identifier descriptor type.
- *
- * @template TIdentifierValidation
- * Identifier validation type.
- */
-interface IdentifierValidator<TIdentifierDescriptor extends IdentifierDescriptor = IdentifierDescriptor, TIdentifierValidation extends IdentifierValidation = IdentifierValidation> extends StringValidator<TIdentifierValidation> {
-    /**
-     * Get the identifier type. Per the GS1 General Specifications, the identifier type determines the remaining
-     * properties.
-     */
-    get identifierType(): TIdentifierDescriptor["identifierType"];
-    /**
-     * Get the prefix type supported by the identifier type. For all identifier types except the GTIN, this is a GS1
-     * Company Prefix. For the GTIN, the prefix type determines the length.
-     */
-    get prefixType(): TIdentifierDescriptor["prefixType"];
-    /**
-     * Get the length. For numeric identifier types, the length is fixed; for alphanumeric identifier types, the length
-     * is the maximum.
-     */
-    get length(): number;
-    /**
-     * Get the reference character set.
-     */
-    get referenceCharacterSet(): TIdentifierDescriptor["referenceCharacterSet"];
-    /**
-     * Get the reference creator.
-     */
-    get referenceCreator(): CharacterSetCreator;
-    /**
-     * Validate an identifier and throw an error if validation fails.
-     *
-     * @param identifier
-     * Identifier.
-     *
-     * @param validation
-     * Identifier validation parameters.
-     */
-    validate: (identifier: string, validation?: TIdentifierValidation) => void;
-}
-
-/**
- * Numeric identifier validation parameters.
- */
-interface NumericIdentifierValidation extends IdentifierValidation {
-    /**
-     * Position offset within a larger string. Some numeric identifier types have the prefix offset by one.
-     */
-    positionOffset?: number | undefined;
-}
-/**
- * Numeric identifier validator.
- *
- * @template TNumericIdentifierDescriptor
- * Numeric identifier descriptor type.
- */
-interface NumericIdentifierValidator<TNumericIdentifierDescriptor extends NumericIdentifierDescriptor = NumericIdentifierDescriptor> extends IdentifierValidator<TNumericIdentifierDescriptor, NumericIdentifierValidation> {
-    /**
-     * Get the leader type.
-     */
-    get leaderType(): TNumericIdentifierDescriptor["leaderType"];
-}
-
-/**
- * Abstract identifier validator. Implements common functionality for an identifier validator.
- *
- * @template TIdentifierDescriptor
- * Identifier descriptor type.
- *
- * @template TIdentifierValidation
- * Identifier validation type.
- */
-declare abstract class AbstractIdentifierValidator<TIdentifierDescriptor extends IdentifierDescriptor, TIdentifierValidation extends IdentifierValidation> implements IdentifierValidator<TIdentifierDescriptor, TIdentifierValidation> {
-    private static readonly CHARACTER_SET_CREATORS;
-    /**
-     * Identifier type.
-     */
-    private readonly _identifierType;
-    /**
-     * Length.
-     */
-    private readonly _length;
-    /**
-     * Reference character set.
-     */
-    private readonly _referenceCharacterSet;
-    /**
-     * Reference creator.
-     */
-    private readonly _referenceCreator;
-    /**
-     * Get the character set creator for a character set.
-     *
-     * @param characterSet
-     * Character set.
-     *
-     * @returns
-     * Character set creator.
-     */
-    protected static creatorFor(characterSet: ContentCharacterSet): CharacterSetCreator;
-    /**
-     * Constructor.
-     *
-     * @param identifierDescriptor
-     * Identifier descriptor.
-     */
-    protected constructor(identifierDescriptor: IdentifierDescriptor);
-    /**
-     * @inheritDoc
-     */
-    get identifierType(): TIdentifierDescriptor["identifierType"];
-    /**
-     * @inheritDoc
-     */
-    get prefixType(): TIdentifierDescriptor["prefixType"];
-    /**
-     * @inheritDoc
-     */
-    get length(): number;
-    /**
-     * @inheritDoc
-     */
-    get referenceCharacterSet(): TIdentifierDescriptor["referenceCharacterSet"];
-    /**
-     * @inheritDoc
-     */
-    get referenceCreator(): CharacterSetCreator;
-    /**
-     * Pad an identifier on the left with zero-value character for validation purposes. This is done to align an
-     * identifier with a position offset for any error message that may be thrown by the reference validator.
-     *
-     * @param identifier
-     * Identifier.
-     *
-     * @param positionOffset
-     * Position offset within a larger string.
-     *
-     * @returns
-     * Padded identifier.
-     */
-    protected padIdentifier(identifier: string, positionOffset?: number): string;
-    /**
-     * Validate the prefix within an identifier.
-     *
-     * @param partialIdentifier
-     * Partial identifier.
-     *
-     * @param positionOffset
-     * Position offset within a larger string.
-     */
-    protected validatePrefix(partialIdentifier: string, positionOffset?: number): void;
-    abstract validate(identifier: string, validation?: TIdentifierValidation): void;
-}
-
-/**
- * Abstract numeric identifier validator.
- *
- * @template TNumericIdentifierDescriptor
- * Numeric identifier descriptor type.
- */
-declare abstract class AbstractNumericIdentifierValidator<TNumericIdentifierDescriptor extends NumericIdentifierDescriptor> extends AbstractIdentifierValidator<TNumericIdentifierDescriptor, NumericIdentifierValidation> implements NumericIdentifierValidator<TNumericIdentifierDescriptor> {
-    /**
-     * Leader type.
-     */
-    private readonly _leaderType;
-    /**
-     * Prefix position, determined by the leader type.
-     */
-    private readonly _prefixPosition;
-    /**
-     * Constructor.
-     *
-     * @param identifierDescriptor
-     * Identifier descriptor.
-     */
-    constructor(identifierDescriptor: NumericIdentifierDescriptor);
-    /**
-     * @inheritDoc
-     */
-    get leaderType(): TNumericIdentifierDescriptor["leaderType"];
-    /**
-     * @inheritDoc
-     */
-    validate(identifier: string, validation?: NumericIdentifierValidation): void;
-}
-
-/**
- * Levels at which GTIN is to be validated.
- */
-declare const GTINLevels: {
-    /**
-     * Any level (level is ignored).
-     */
-    readonly Any: 0;
-    /**
-     * Retail consumer trade item level, supporting GTIN-13, GTIN-12 (optionally zero-suppressed), and GTIN-8.
-     */
-    readonly RetailConsumer: 1;
-    /**
-     * Other than retail consumer trade item level, supporting GTIN-13, GTIN-12 (not zero-suppressed), and GTIN-14.
-     */
-    readonly OtherThanRetailConsumer: 2;
-};
-/**
- * GTIN level key.
- */
-type GTINLevelKey = keyof typeof GTINLevels;
-/**
- * GTIN level.
- */
-type GTINLevel = typeof GTINLevels[GTINLevelKey];
-/**
- * Restricted Circulation Number reference.
- */
-interface RCNReference {
-    /**
-     * Item reference.
-     */
-    itemReference: number;
-    /**
-     * Price or weight (whole number only).
-     */
-    priceOrWeight: number;
-}
-/**
- * GTIN validator.
- */
-declare class GTINValidator extends AbstractNumericIdentifierValidator<GTINDescriptor> {
-    /**
-     * 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;
-    /**
-     * Prefix type.
-     */
-    private readonly _prefixType;
-    /**
-     * Constructor.
-     *
-     * @param gtinBaseType
-     * GTIN base type (all except GTIN-14).
-     */
-    constructor(gtinBaseType: GTINBaseType);
-    /**
-     * @inheritDoc
-     */
-    get prefixType(): PrefixType;
-    /**
-     * @inheritDoc
-     */
-    get gtinType(): GTINType;
-    /**
-     * @inheritDoc
-     */
-    protected validatePrefix(partialIdentifier: 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.
-     *
-     * @param zeroSuppressedGTIN12
-     * Zero-suppressed GTIN-12.
-     *
-     * @returns
-     * 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.
-     *
-     * @param gtin
-     * GTIN.
-     *
-     * @param gtinLevel
-     * Level at which GTIN is to be validated.
-     */
-    static validateAny(gtin: string, gtinLevel?: GTINLevel): void;
-    /**
-     * Validate a GTIN-14.
-     *
-     * @param gtin14
-     * GTIN-14.
-     */
-    static validateGTIN14(gtin14: string): void;
-    /**
-     * Parse a Restricted Circulation Number (RCN) using a variable measure trade item format. The format is a 12- or
-     * 13-character string (for RCN-12 or RCN-13 respectively), containing the following:
-     *
-     * - '2' - The first character of the RCN.
-     * - '0'-'9' - The second character of the RCN (RCN-13 only).
-     * - 'I' - One or more, in sequence, for the item reference.
-     * - 'P' - One or more, in sequence, for the price or weight.
-     * - 'V' - Zero or one, for the price or weight check digit.
-     * - 'C' - The check digit of the entire RCN.
-     *
-     * The 'I', 'P', and 'V' formats may be in any order.
-     *
-     * Some examples:
-     *
-     * - 2IIIIIVPPPPC - RCN-12 with a five-digit item reference, a price or weight check digit, and a four-digit price
-     * or weight.
-     * - 23IIIIVPPPPPC - RCN-13 with a four-digit item reference, a price or weight check digit, and a five-digit price
-     * or weight.
-     * - 2IIIIIIPPPPC - RCN-12 with a six-digit item reference and a four-digit price or eight.
-     * - 29IIIIIPPPPPC - RCN-13 with a five-digit item reference and a five-digit price or weight.
-     *
-     * @param format
-     * Format.
-     *
-     * @param rcn
-     * RCN.
-     *
-     * @returns
-     * RCN reference.
-     */
-    static parseVariableMeasureRCN(format: string, rcn: string): RCNReference;
-}
-
-/**
- * Non-GTIN numeric identifier validator.
- */
-declare class NonGTINNumericIdentifierValidator extends AbstractNumericIdentifierValidator<NonGTINNumericIdentifierDescriptor> {
-    /**
-     * Constructor.
-     *
-     * @param identifierType
-     * Identifier type.
-     */
-    constructor(identifierType: Exclude<NonGTINNumericIdentifierType, SerializableNumericIdentifierType>);
-}
-
-/**
- * Serializable numeric identifier validator. Validates both serialized and non-serialized forms of numeric identifiers
- * that support serialization.
- */
-declare class SerializableNumericIdentifierValidator extends AbstractNumericIdentifierValidator<SerializableNumericIdentifierDescriptor> {
-    /**
-     * Serial component length.
-     */
-    private readonly _serialComponentLength;
-    /**
-     * Serial component character set.
-     */
-    private readonly _serialComponentCharacterSet;
-    /**
-     * Serial component validation parameters.
-     */
-    private readonly _serialComponentValidation;
-    /**
-     * Serial component creator.
-     */
-    private readonly _serialComponentCreator;
-    /**
-     * Constructor.
-     *
-     * @param identifierType
-     * Identifier type.
-     */
-    constructor(identifierType: SerializableNumericIdentifierType);
-    /**
-     * Get the serial component length.
-     */
-    get serialComponentLength(): number;
-    /**
-     * Get the serial component character set.
-     */
-    get serialComponentCharacterSet(): ContentCharacterSet;
-    /**
-     * Get the serial component validation parameters.
-     */
-    protected get serialComponentValidation(): CharacterSetValidation;
-    /**
-     * Get the serial component creator.
-     */
-    get serialComponentCreator(): CharacterSetCreator;
-    /**
-     * @inheritDoc
-     */
-    validate(identifier: string, validation?: IdentifierValidation): void;
-}
-
-/**
- * Non-numeric identifier validation parameters.
- */
-interface NonNumericIdentifierValidation extends IdentifierValidation {
-    /**
-     * Exclusion support for reference. Prevents non-numeric identifier from being mistaken for numeric identifier.
-     */
-    exclusion?: typeof Exclusions.None | typeof Exclusions.AllNumeric | undefined;
-}
-/**
- * Non-numeric identifier validator.
- */
-declare class NonNumericIdentifierValidator extends AbstractIdentifierValidator<NonNumericIdentifierDescriptor, NonNumericIdentifierValidation> {
-    /**
-     * Validator to ensure that an identifier (minus check character pair) is not all numeric.
-     */
-    private static readonly NOT_ALL_NUMERIC_VALIDATOR;
-    /**
-     * True if the identifier requires a check character pair.
-     */
-    private readonly _requiresCheckCharacterPair;
-    /**
-     * Constructor.
-     *
-     * @param identifierType
-     * Identifier type.
-     */
-    constructor(identifierType: NonNumericIdentifierType);
-    /**
-     * Determine if the identifier requires a check character pair.
-     */
-    get requiresCheckCharacterPair(): boolean;
-    /**
-     * Validate a non-numeric identifier and throw an error if validation fails.
-     *
-     * @param identifier
-     * Identifier.
-     *
-     * @param validation
-     * Validation parameters.
-     */
-    validate(identifier: string, validation?: NonNumericIdentifierValidation): void;
-}
-
-/**
- * Identifier validator type based on identifier type type.
- *
- * @template TIdentifierType
- * Identifier type type.
- */
-type IdentifierTypeValidator<TIdentifierType extends IdentifierType> = TIdentifierType extends NonNumericIdentifierType ? NonNumericIdentifierValidator : TIdentifierType extends SerializableNumericIdentifierType ? SerializableNumericIdentifierValidator : TIdentifierType extends NonGTINNumericIdentifierType ? NonGTINNumericIdentifierValidator : TIdentifierType extends typeof IdentifierTypes.GTIN ? GTINValidator : IdentifierValidator;
-/**
- * Identifier validators entry type based on identifier type type.
- *
- * @template TIdentifierType
- * Identifier type type.
- */
-type IdentifierValidatorsEntry<TIdentifierType extends IdentifierType> = TIdentifierType extends typeof IdentifierTypes.GTIN ? Readonly<Record<GTINBaseType, GTINValidator>> : IdentifierTypeValidator<TIdentifierType>;
-/**
- * Identifier validators record type.
- */
-type IdentifierValidatorsRecord = {
-    [TIdentifierType in IdentifierType]: IdentifierValidatorsEntry<TIdentifierType>;
-};
-/**
- * Identifier validators for all identifier types.
- */
-declare const IdentifierValidators: IdentifierValidatorsRecord;
-/**
- * Determine if identifier validators or validator is GTIN validators.
- *
- * @param identifierValidatorsOrValidator
- * Identifier validators or validator.
- *
- * @returns
- * True if GTIN validators.
- */
-declare function isGTINValidators(identifierValidatorsOrValidator: IdentifierValidatorsEntry<IdentifierType>): identifierValidatorsOrValidator is Readonly<Record<GTINBaseType, GTINValidator>>;
-/**
- * Determine if identifier validator is a numeric identifier validator.
- *
- * @param identifierValidator
- * Identifier validator.
- *
- * @returns
- * True if identifier validator is a numeric identifier validator.
- */
-declare function isNumericIdentifierValidator(identifierValidator: IdentifierValidator): identifierValidator is NumericIdentifierValidator;
-/**
- * Determine if identifier validator is a GTIN validator.
- *
- * @param identifierValidator
- * Identifier validator.
- *
- * @returns
- * True if identifier validator is a GTIN validator.
- */
-declare function isGTINValidator(identifierValidator: IdentifierValidator): identifierValidator is GTINValidator;
-/**
- * Determine if identifier validator is a non-GTIN numeric identifier validator.
- *
- * @param identifierValidator
- * Identifier validator.
- *
- * @returns
- * True if identifier validator is a non-GTIN numeric identifier validator.
- */
-declare function isNonGTINNumericIdentifierValidator(identifierValidator: IdentifierValidator): identifierValidator is NonGTINNumericIdentifierValidator;
-/**
- * Determine if identifier validator is a serializable numeric identifier validator.
- *
- * @param identifierValidator
- * Identifier validator.
- *
- * @returns
- * True if identifier validator is a serializable numeric identifier validator.
- */
-declare function isSerializableNumericIdentifierValidator(identifierValidator: IdentifierValidator): identifierValidator is SerializableNumericIdentifierValidator;
-/**
- * Determine if identifier validator is a non-numeric identifier validator.
- *
- * @param identifierValidator
- * Identifier validator.
- *
- * @returns
- * True if identifier validator is a non-numeric identifier validator.
- */
-declare function isNonNumericIdentifierValidator(identifierValidator: IdentifierValidator): identifierValidator is NonNumericIdentifierValidator;
-
-/**
- * Identifier creator. Creates an identifier based on its definition in section 3 of the {@link
- * https://ref.gs1.org/standards/genspecs/ | GS1 General Specifications}.
- *
- * Keys are created based on a prefix defined in a prefix provider to which the identifier creator is bound.
- *
- * @template TIdentifierDescriptor
- * Identifier descriptor type.
- *
- * @template TIdentifierValidation
- * Identifier validation type.
- */
-interface IdentifierCreator<TIdentifierDescriptor extends IdentifierDescriptor = IdentifierDescriptor, TIdentifierValidation extends IdentifierValidation = IdentifierValidation> extends IdentifierValidator<TIdentifierDescriptor, TIdentifierValidation> {
-    /**
-     * Get the prefix provider to which this identifier creator is bound.
-     */
-    get prefixProvider(): PrefixProvider;
-    /**
-     * Get the prefix, equivalent to calling {@linkcode PrefixProvider.prefix | prefixProvider.prefix} for a GTIN or
-     * {@linkcode PrefixProvider.gs1CompanyPrefix | prefixProvider.gs1CompanyPrefix} for all other identifier types.
-     */
-    get prefix(): string;
-    /**
-     * Get the reference length.
-     */
-    get referenceLength(): number;
-}
-
-/**
- * Numeric identifier creator. Creates one or many numeric identifiers.
- *
- * @template TNumericIdentifierDescriptor
- * Numeric identifier descriptor type.
- */
-interface NumericIdentifierCreator<TNumericIdentifierDescriptor extends NumericIdentifierDescriptor = NumericIdentifierDescriptor> extends NumericIdentifierValidator<TNumericIdentifierDescriptor>, IdentifierCreator<TNumericIdentifierDescriptor, NumericIdentifierValidation> {
-    /**
-     * Get the capacity (`10**referenceLength`).
-     */
-    get capacity(): number;
-    /**
-     * Get the tweak for sparse creation.
-     */
-    get tweak(): bigint;
-    /**
-     * Set the tweak for sparse creation.
-     */
-    set tweak(value: bigint);
-    /**
-     * Create identifier(s) with reference(s) based on numeric value(s). The value(s) is/are converted to references of
-     * the appropriate length using the numeric creator.
-     *
-     * @template TTransformerInput
-     * Transformer input type.
-     *
-     * @param valueOrValues
-     * Numeric value(s).
-     *
-     * @param sparse
-     * If true, the value(s) are mapped to a sparse sequence resistant to discovery. Default is false.
-     *
-     * @returns
-     * Identifier(s).
-     */
-    create: <TTransformerInput extends TransformerInput<number | bigint>>(valueOrValues: TTransformerInput, sparse?: boolean) => TransformerOutput<TTransformerInput, string>;
-    /**
-     * Create all identifiers 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 Sequence(0, creator.capacity))`, this method is significantly
-     * faster.
-     *
-     * @returns
-     * All identifiers for the prefix.
-     */
-    createAll: () => Iterable<string>;
-}
-
-/**
- * Abstract identifier creator. Implements common functionality for an identifier creator, bound to a {@link
- * PrefixProvider | prefix provider}.
- *
- * @template TIdentifierDescriptor
- * Identifier descriptor type.
- *
- * @template TIdentifierValidation
- * Identifier validation type.
- */
-declare abstract class AbstractIdentifierCreator<TIdentifierDescriptor extends IdentifierDescriptor, TIdentifierValidation extends IdentifierValidation> implements IdentifierCreator<TIdentifierDescriptor, TIdentifierValidation> {
-    /**
-     * Prefix provider.
-     */
-    private _prefixProvider;
-    /**
-     * Reference length.
-     */
-    private _referenceLength;
-    /**
-     * Initialize the prefix provider. This method is in lieu of a constructor due to the mixin architecture.
-     *
-     * @param prefixProvider
-     * Prefix provider.
-     *
-     * @param prefix
-     * Prefix within prefix provider to use to calculate reference length.
-     *
-     * @param checkAllowance
-     * Number of characters to allow for check digit or check character pair.
-     */
-    protected init(prefixProvider: PrefixProvider, prefix: string, checkAllowance: number): void;
-    /**
-     * @inheritDoc
-     */
-    abstract get identifierType(): TIdentifierDescriptor["identifierType"];
-    /**
-     * @inheritDoc
-     */
-    abstract get prefixType(): TIdentifierDescriptor["prefixType"];
-    /**
-     * @inheritDoc
-     */
-    abstract get length(): number;
-    /**
-     * @inheritDoc
-     */
-    abstract get referenceCharacterSet(): TIdentifierDescriptor["referenceCharacterSet"];
-    /**
-     * @inheritDoc
-     */
-    abstract get referenceCreator(): CharacterSetCreator;
-    /**
-     * @inheritDoc
-     */
-    get prefixProvider(): PrefixProvider;
-    /**
-     * @inheritDoc
-     */
-    get prefix(): string;
-    /**
-     * @inheritDoc
-     */
-    get referenceLength(): number;
-    /**
-     * @inheritDoc
-     */
-    abstract validate(identifier: string, validation?: TIdentifierValidation): void;
-}
-
-/**
- * Abstract numeric identifier creator. Implements common functionality for a numeric identifier creator.
- *
- * @template TNumericIdentifierDescriptor
- * Numeric identifier descriptor type.
- */
-declare abstract class AbstractNumericIdentifierCreator<TNumericIdentifierDescriptor extends NumericIdentifierDescriptor> extends AbstractIdentifierCreator<TNumericIdentifierDescriptor, NumericIdentifierValidation> implements NumericIdentifierCreator<TNumericIdentifierDescriptor> {
-    /**
-     * Capacity.
-     */
-    private _capacity;
-    /**
-     * Tweak for sparse creation.
-     */
-    private _tweak;
-    /**
-     * Initialize the prefix provider. This method is in lieu of a constructor due to the mixin architecture.
-     *
-     * @param prefixProvider
-     * Prefix provider.
-     *
-     * @param prefix
-     * Prefix within prefix manager to use to calculate reference length.
-     */
-    protected init(prefixProvider: PrefixProvider, prefix: string): void;
-    /**
-     * Get the leader type.
-     */
-    abstract get leaderType(): LeaderType;
-    /**
-     * @inheritDoc
-     */
-    get capacity(): number;
-    /**
-     * @inheritDoc
-     */
-    get tweak(): bigint;
-    /**
-     * @inheritDoc
-     */
-    set tweak(value: bigint);
-    /**
-     * Build an identifier from a reference by merging it with the prefix and adding the check digit.
-     *
-     * @param reference
-     * Identifier reference.
-     *
-     * @returns
-     * Identifier.
-     */
-    private buildIdentifier;
-    /**
-     * @inheritDoc
-     */
-    create<TTransformerInput extends TransformerInput<number | bigint>>(valueOrValues: TTransformerInput, sparse?: boolean): TransformerOutput<TTransformerInput, string>;
-    /**
-     * Create all identifiers from a partial identifier. Call is recursive until remaining reference
-     * length is 0.
-     *
-     * @param partialIdentifier
-     * Partial identifier. Initial value is `this.prefix`.
-     *
-     * @param remainingReferenceLength
-     * Remaining reference length. Initial value is `this.referenceLength`.
-     *
-     * @param extensionWeight
-     * If this value is not zero, the identifier has an extension digit, this call is setting it, and this value is
-     * applied to the calculation of the check digit.
-     *
-     * @param weight
-     * If the extension weight is zero, this value is applied to the calculation of the check digit.
-     *
-     * @param partialCheckDigitSum
-     * Partial check digit sum for the partial identifier.
-     *
-     * @yields
-     * Identifier.
-     */
-    private static createAllPartial;
-    /**
-     * @inheritDoc
-     */
-    createAll(): Iterable<string>;
-}
-
-declare const GTINCreator_base: ts_mixer_dist_types_types.Class<any[], GTINValidator & AbstractNumericIdentifierCreator<NumericIdentifierDescriptor>, typeof GTINValidator & (abstract new () => AbstractNumericIdentifierCreator<NumericIdentifierDescriptor>)>;
-/**
- * GTIN creator. Applicable to GTIN-13, GTIN-12, and GTIN-8 types; no applicable to GTIN-14 type.
- */
-declare class GTINCreator extends GTINCreator_base {
-    /**
-     * Validation parameters for required indicator digit.
-     */
-    private static readonly REQUIRED_INDICATOR_DIGIT_VALIDATION;
-    /**
-     * Constructor. Typically called internally by a prefix manager but may be called by other code with another prefix
-     * provider type.
-     *
-     * @param prefixProvider
-     * Prefix provider.
-     *
-     * @param gtinBaseType
-     * GTIN base type (all except GTIN-14).
-     */
-    constructor(prefixProvider: PrefixProvider, gtinBaseType: GTINBaseType);
-    /**
-     * @inheritDoc
-     */
-    get prefix(): string;
-    /**
-     * 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}.
-     *
-     * @template TTransformerInput
-     * Transformer input type.
-     *
-     * @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<TTransformerInput extends TransformerInput<number | bigint>>(indicatorDigit: string, valueOrValues: TTransformerInput, sparse?: boolean): TransformerOutput<TTransformerInput, string>;
-    /**
-     * Create a Restricted Circulation Number (RCN) using a variable measure trade item format. See {@linkcode
-     * GTINValidator.parseVariableMeasureRCN} for format details.
-     *
-     * @param format
-     * Format.
-     *
-     * @param itemReference
-     * Item reference.
-     *
-     * @param priceOrWeight
-     * Price or weight (whole number only).
-     *
-     * @returns
-     * RCN-12 or RCN-13.
-     */
-    static createVariableMeasureRCN(format: string, itemReference: number, priceOrWeight: number): string;
-}
-
-declare const NonGTINNumericIdentifierCreator_base: ts_mixer_dist_types_types.Class<any[], NonGTINNumericIdentifierValidator & AbstractNumericIdentifierCreator<NumericIdentifierDescriptor>, typeof NonGTINNumericIdentifierValidator & (abstract new () => AbstractNumericIdentifierCreator<NumericIdentifierDescriptor>)>;
-/**
- * Non-GTIN numeric identifier creator.
- */
-declare class NonGTINNumericIdentifierCreator extends NonGTINNumericIdentifierCreator_base {
-    /**
-     * Constructor. Typically called internally by a prefix manager but may be called by other code with another prefix
-     * provider type.
-     *
-     * @param prefixProvider
-     * Prefix provider.
-     *
-     * @param identifierType
-     * Identifier type.
-     */
-    constructor(prefixProvider: PrefixProvider, identifierType: Exclude<NonGTINNumericIdentifierType, SerializableNumericIdentifierType>);
-}
-
-declare const SerializableNumericIdentifierCreator_base: ts_mixer_dist_types_types.Class<any[], SerializableNumericIdentifierValidator & AbstractNumericIdentifierCreator<NumericIdentifierDescriptor>, typeof SerializableNumericIdentifierValidator & (abstract new () => AbstractNumericIdentifierCreator<NumericIdentifierDescriptor>)>;
-/**
- * Serializable numeric identifier creator.
- */
-declare class SerializableNumericIdentifierCreator extends SerializableNumericIdentifierCreator_base {
-    /**
-     * Constructor. Typically called internally by a prefix manager but may be called by other code with another prefix
-     * provider type.
-     *
-     * @param prefixProvider
-     * Prefix provider.
-     *
-     * @param identifierType
-     * Identifier type.
-     */
-    constructor(prefixProvider: PrefixProvider, identifierType: SerializableNumericIdentifierType);
-    /**
-     * Concatenate a validated base identifier with serial component(s).
-     *
-     * @template TTransformerInput
-     * Transformer input type.
-     *
-     * @param baseIdentifier
-     * Base identifier.
-     *
-     * @param serialComponentOrComponents
-     * Serial component(s).
-     *
-     * @returns
-     * Serialized identifier(s).
-     */
-    private concatenateValidated;
-    /**
-     * Create serialized identifier(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 a numeric creator.
-     *
-     * @template TTransformerInput
-     * Transformer input type.
-     *
-     * @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 identifiers.
-     */
-    createSerialized<TTransformerInput extends TransformerInput<string>>(value: number, serialComponentOrComponents: TTransformerInput, sparse?: boolean): TransformerOutput<TTransformerInput, string>;
-    /**
-     * Concatenate a base identifier with serial component(s).
-     *
-     * @template TTransformerInput
-     * Transformer input type.
-     *
-     * @param baseIdentifier
-     * Base identifier.
-     *
-     * @param serialComponentOrComponents
-     * Serial component(s).
-     *
-     * @returns
-     * Serialized identifier(s).
-     */
-    concatenate<TTransformerInput extends TransformerInput<string>>(baseIdentifier: string, serialComponentOrComponents: TTransformerInput): TransformerOutput<TTransformerInput, string>;
-}
-
-declare const NonNumericIdentifierCreator_base: ts_mixer_dist_types_types.Class<any[], NonNumericIdentifierValidator & AbstractIdentifierCreator<IdentifierDescriptor, IdentifierValidation>, typeof NonNumericIdentifierValidator & (abstract new () => AbstractIdentifierCreator<IdentifierDescriptor, IdentifierValidation>)>;
-/**
- * Non-numeric identifier creator.
- */
-declare class NonNumericIdentifierCreator extends NonNumericIdentifierCreator_base {
-    /**
-     * Reference validation parameters.
-     */
-    private readonly _referenceValidation;
-    /**
-     * Constructor. Typically called internally by a prefix manager but may be called by other code with another prefix
-     * provider type.
-     *
-     * @param prefixProvider
-     * Prefix provider.
-     *
-     * @param identifierType
-     * Identifier type.
-     */
-    constructor(prefixProvider: PrefixProvider, identifierType: NonNumericIdentifierType);
-    /**
-     * Get the reference validation parameters.
-     */
-    protected get referenceValidation(): CharacterSetValidation;
-    /**
-     * Create identifier(s) with reference(s).
-     *
-     * @template TTransformerInput
-     * Transformer input type.
-     *
-     * @param referenceOrReferences
-     * Reference(s).
-     *
-     * @returns
-     * Identifier(s).
-     */
-    create<TTransformerInput extends TransformerInput<string>>(referenceOrReferences: TTransformerInput): TransformerOutput<TTransformerInput, string>;
-}
-
-/**
- * Determine the identifier creator type for an identifier type.
- *
- * @template TIdentifierType
- * Identifier type type.
- */
-type IdentifierTypeCreator<TIdentifierType extends IdentifierType> = TIdentifierType extends NonNumericIdentifierType ? NonNumericIdentifierCreator : TIdentifierType extends SerializableNumericIdentifierType ? SerializableNumericIdentifierCreator : TIdentifierType extends NonGTINNumericIdentifierType ? NonGTINNumericIdentifierCreator : TIdentifierType extends typeof IdentifierTypes.GTIN ? GTINCreator : IdentifierCreator;
-/**
- * Identifier creators entry type based on identifier type type.
- *
- * @template TIdentifierType
- * Identifier type type.
- */
-type IdentifierCreatorsEntry<TIdentifierType extends IdentifierType> = IdentifierTypeCreator<TIdentifierType>;
-/**
- * Identifier creators record type.
- */
-type IdentifierCreatorsRecord = {
-    [TIdentifierType in IdentifierType]: IdentifierCreatorsEntry<TIdentifierType>;
-};
-/**
- * Determine if identifier creator is a numeric identifier creator.
- *
- * @param identifierCreator
- * Identifier creator.
- *
- * @returns
- * True if identifier creator is a numeric identifier creator.
- */
-declare function isNumericIdentifierCreator(identifierCreator: IdentifierCreator): identifierCreator is NumericIdentifierCreator;
-/**
- * Determine if identifier creator is a GTIN creator.
- *
- * @param identifierCreator
- * Identifier creator.
- *
- * @returns
- * True if identifier creator is a GTIN creator.
- */
-declare function isGTINCreator(identifierCreator: IdentifierCreator): identifierCreator is GTINCreator;
-/**
- * Determine if identifier creator is a non-GTIN numeric identifier creator.
- *
- * @param identifierCreator
- * Identifier creator.
- *
- * @returns
- * True if identifier creator is a non-GTIN numeric identifier creator.
- */
-declare function isNonGTINNumericIdentifierCreator(identifierCreator: IdentifierCreator): identifierCreator is NonGTINNumericIdentifierCreator;
-/**
- * Determine if identifier creator is a serializable numeric identifier creator.
- *
- * @param identifierCreator
- * Identifier creator.
- *
- * @returns
- * True if identifier creator is a serializable numeric identifier creator.
- */
-declare function isSerializableNumericIdentifierCreator(identifierCreator: IdentifierCreator): identifierCreator is SerializableNumericIdentifierCreator;
-/**
- * Determine if identifier creator is a non-numeric identifier creator.
- *
- * @param identifierCreator
- * Identifier creator.
- *
- * @returns
- * True if identifier creator is a non-numeric identifier creator.
- */
-declare function isNonNumericIdentifierCreator(identifierCreator: IdentifierCreator): identifierCreator is NonNumericIdentifierCreator;
-
-/**
- * Prefix manager. This is the core class for identifier creation.
- *
- * A prefix manager may be constructed for any {@link PrefixType | prefix type}. Construction may be done directly or
- * via the static {@linkcode PrefixManager.get | get()} method, which allows for caching and reuse. As most applications
- * work with a limited number of prefixes for creating identifiers, caching and reuse may be a more efficient option.
- *
- * The prefix type and prefix are normalized before the prefix manager is constructed, so they may not match the input
- * values. For example, the GS1 Company Prefix 0614141 is equivalent to U.P.C. Company Prefix 614141; both result in a
- * prefix manager with prefix type equal to {@linkcode PrefixTypes.UPCCompanyPrefix} and prefix equal to "614141".
- *
- * To support the creation of sparse identifiers, a prefix manager maintains a {@link tweakFactor | tweak factor} which
- * is used, along with a type-specific multiplier, as the tweak when creating numeric identifiers. The default tweak
- * factor is the numeric value of the GS1 Company Prefix representation of the prefix preceded by '1' to ensure
- * uniqueness (i.e., so that prefixes 0 N1 N2 N3... and N1 N2 N3... produce different tweak factors). This is usually
- * sufficient for obfuscation, but as the sparse creation algorithm is reversible and as the GS1 Company Prefix is
- * discoverable via {@link https://www.gs1.org/services/verified-by-gs1 | Verified by GS1}, a user-defined tweak factor
- * should be used if a higher degree of obfuscation is required. When using a tweak factor other than the default, care
- * should be taken to restore it when resuming the application. A tweak factor of 0 creates a straight sequence.
- */
-declare class PrefixManager implements PrefixProvider {
-    /**
-     * Cached prefix managers, keyed by GS1 Company Prefix.
-     */
-    private static readonly PREFIX_MANAGERS_MAP;
-    /**
-     * Creator tweak factors. Different numeric identifier types have different tweak factors so that sparse creation
-     * generates different sequences for each.
-     */
-    private static readonly CREATOR_TWEAK_FACTORS;
-    /**
-     * Normalized prefix type.
-     */
-    private readonly _prefixType;
-    /**
-     * Normalized prefix.
-     */
-    private readonly _prefix;
-    /**
-     * Prefix as GS1 Company Prefix.
-     */
-    private readonly _gs1CompanyPrefix;
-    /**
-     * U.P.C. Company Prefix if prefix type is {@linkcode PrefixTypes.UPCCompanyPrefix}.
-     */
-    private readonly _upcCompanyPrefix;
-    /**
-     * GS1-8 Prefix if prefix type is {@linkcode PrefixTypes.GS18Prefix}.
-     */
-    private readonly _gs18Prefix;
-    /**
-     * Default tweak factor.
-     */
-    private readonly _defaultTweakFactor;
-    /**
-     * Tweak factor.
-     */
-    private _tweakFactor;
-    /**
-     * Cached identifier creators.
-     */
-    private readonly _identifierCreators;
-    /**
-     * Constructor.
-     *
-     * @param prefixType
-     * Prefix type.
-     *
-     * @param prefix
-     * Prefix.
-     */
-    constructor(prefixType: PrefixType, prefix: string);
-    /**
-     * Get the prefix type.
-     */
-    get prefixType(): PrefixType;
-    /**
-     * Get the prefix.
-     */
-    get prefix(): string;
-    /**
-     * Get the GS1 Company Prefix.
-     */
-    get gs1CompanyPrefix(): string;
-    /**
-     * Get the U.P.C. Company Prefix if prefix type is {@linkcode PrefixTypes.UPCCompanyPrefix} or undefined if not.
-     */
-    get upcCompanyPrefix(): string | undefined;
-    /**
-     * Get the GS1-8 Prefix if prefix type is {@linkcode PrefixTypes.GS18Prefix} or undefined if not.
-     */
-    get gs18Prefix(): string | undefined;
-    /**
-     * Set the tweak for an identifier creator if it's a numeric identifier creator.
-     *
-     * @param identifierCreator
-     * Identifier creator.
-     */
-    private setCreatorTweak;
-    /**
-     * Get the tweak factor.
-     */
-    get tweakFactor(): bigint;
-    /**
-     * Set the tweak factor.
-     *
-     * @param value
-     * Tweak factor.
-     */
-    set tweakFactor(value: number | bigint);
-    /**
-     * Reset the tweak factor to its default (numeric value of the GS1 Company Prefix preceded by '1').
-     */
-    resetTweakFactor(): void;
-    /**
-     * Get a prefix manager.
-     *
-     * @param prefixType
-     * Prefix type.
-     *
-     * @param prefix
-     * Prefix.
-     *
-     * @returns
-     * Prefix manager with normalized prefix type and prefix.
-     */
-    static get(prefixType: PrefixType, prefix: string): PrefixManager;
-    /**
-     * Get an identifier creator.
-     *
-     * @template TIdentifierType
-     * Identifier type type.
-     *
-     * @param identifierType
-     * Identifier type used to construct identifier creator.
-     *
-     * @param constructorParameter
-     * Second constructor parameter passed to constructor callback alongside this.
-     *
-     * @param ConstructorCallback
-     * Constructor callback.
-     *
-     * @returns
-     * Identifier creator.
-     */
-    private getIdentifierCreator;
-    /**
-     * Get non-GTIN numeric identifier creator.
-     *
-     * @param identifierType
-     * Identifier type used to construct identifier creator.
-     *
-     * @returns
-     * Identifier creator.
-     */
-    private getNonGTINNumericIdentifierCreator;
-    /**
-     * Get serialized numeric identifier creator.
-     *
-     * @param identifierType
-     * Identifier type used to construct identifier creator.
-     *
-     * @returns
-     * Identifier creator.
-     */
-    private getSerializableNumericIdentifierCreator;
-    /**
-     * Get non-numeric identifier creator.
-     *
-     * @param identifierType
-     * Identifier type used to construct identifier creator.
-     *
-     * @returns
-     * Identifier creator.
-     */
-    private getNonNumericIdentifierCreator;
-    /**
-     * Get GTIN creator.
-     */
-    get gtinCreator(): GTINCreator;
-    /**
-     * Get GLN creator.
-     */
-    get glnCreator(): NonGTINNumericIdentifierCreator;
-    /**
-     * Get SSCC creator.
-     */
-    get ssccCreator(): NonGTINNumericIdentifierCreator;
-    /**
-     * Get GRAI creator.
-     */
-    get graiCreator(): SerializableNumericIdentifierCreator;
-    /**
-     * Get GIAI creator.
-     */
-    get giaiCreator(): NonNumericIdentifierCreator;
-    /**
-     * Get GSRN creator.
-     */
-    get gsrnCreator(): NonGTINNumericIdentifierCreator;
-    /**
-     * Get GDTI creator.
-     */
-    get gdtiCreator(): SerializableNumericIdentifierCreator;
-    /**
-     * Get GINC creator.
-     */
-    get gincCreator(): NonNumericIdentifierCreator;
-    /**
-     * Get GSIN creator.
-     */
-    get gsinCreator(): NonGTINNumericIdentifierCreator;
-    /**
-     * Get GCN creator.
-     */
-    get gcnCreator(): SerializableNumericIdentifierCreator;
-    /**
-     * Get CPID creator.
-     */
-    get cpidCreator(): NonNumericIdentifierCreator;
-    /**
-     * Get GMN creator.
-     */
-    get gmnCreator(): NonNumericIdentifierCreator;
-}
-
-export { AI39_CREATOR, AI39_VALIDATOR, AI64_VALIDATOR, AI82_CREATOR, AI82_VALIDATOR, type ContentCharacterSet, type ContentCharacterSetKey, ContentCharacterSets, type GS1LocaleResources, type GTINBaseType, GTINCreator, type GTINDescriptor, type GTINLevel, GTINLevels, type GTINType, type GTINTypeKey, GTINTypes, GTINValidator, GTIN_BASE_TYPES, type IdentifierCreator, type IdentifierCreatorsEntry, type IdentifierCreatorsRecord, type IdentifierDescriptor, IdentifierDescriptors, type IdentifierDescriptorsEntry, type IdentifierDescriptorsRecord, type IdentifierType, type IdentifierTypeCreator, type IdentifierTypeDescriptor, type IdentifierTypeKey, type IdentifierTypeValidator, IdentifierTypes, type IdentifierValidation, type IdentifierValidator, IdentifierValidators, type IdentifierValidatorsEntry, type IdentifierValidatorsRecord, type LeaderType, type LeaderTypeKey, LeaderTypes, NonGTINNumericIdentifierCreator, type NonGTINNumericIdentifierDescriptor, type NonGTINNumericIdentifierType, NonGTINNumericIdentifierValidator, NonNumericIdentifierCreator, type NonNumericIdentifierDescriptor, type NonNumericIdentifierType, type NonNumericIdentifierValidation, NonNumericIdentifierValidator, type NumericIdentifierCreator, type NumericIdentifierDescriptor, type NumericIdentifierType, type NumericIdentifierValidation, type NumericIdentifierValidator, PrefixManager, type PrefixType, type PrefixTypeKey, PrefixTypes, type PrefixValidation, PrefixValidator, type RCNReference, SerializableNumericIdentifierCreator, type SerializableNumericIdentifierDescriptor, type SerializableNumericIdentifierType, SerializableNumericIdentifierValidator, checkCharacterPair, checkDigit, checkDigitSum, gs1NS, gs1Resources, hasValidCheckCharacterPair, hasValidCheckDigit, i18nGS1Init, i18nextGS1, isGTINCreator, isGTINDescriptor, isGTINDescriptors, isGTINValidator, isGTINValidators, isNonGTINNumericIdentifierCreator, isNonGTINNumericIdentifierDescriptor, isNonGTINNumericIdentifierValidator, isNonNumericIdentifierCreator, isNonNumericIdentifierDescriptor, isNonNumericIdentifierValidator, isNumericIdentifierCreator, isNumericIdentifierDescriptor, isNumericIdentifierValidator, isSerializableNumericIdentifierCreator, isSerializableNumericIdentifierDescriptor, isSerializableNumericIdentifierValidator, isValidPriceOrWeightCheckDigit, priceOrWeightCheckDigit };