@aidc-toolkit/gs1 0.9.5 → 0.9.6-beta

package/dist/index.cjs

@@ -510,19 +510,19 @@ var AbstractIdentificationKeyValidator = class _AbstractIdentificationKeyValidat
    */
   _referenceCharacterSet;
   /**
-   * Reference validator.
+   * Reference creator.
    */
-  _referenceValidator;
+  _referenceCreator;
   /**
-   * Get the character set validator for a character set.
+   * Get the character set creator for a character set.
    *
    * @param characterSet
    * Character set.
    *
    * @returns
-   * Character set validator.
+   * Character set creator.
    */
-  static validatorFor(characterSet) {
+  static creatorFor(characterSet) {
     return _AbstractIdentificationKeyValidator.CHARACTER_SET_CREATORS[characterSet];
   }
   /**
@@ -545,7 +545,7 @@ var AbstractIdentificationKeyValidator = class _AbstractIdentificationKeyValidat
     this._prefixType = prefixType;
     this._length = length;
     this._referenceCharacterSet = referenceCharacterSet;
-    this._referenceValidator = _AbstractIdentificationKeyValidator.validatorFor(referenceCharacterSet);
+    this._referenceCreator = _AbstractIdentificationKeyValidator.creatorFor(referenceCharacterSet);
   }
   /**
    * @inheritDoc
@@ -574,8 +574,8 @@ var AbstractIdentificationKeyValidator = class _AbstractIdentificationKeyValidat
   /**
    * @inheritDoc
    */
-  get referenceValidator() {
-    return this._referenceValidator;
+  get referenceCreator() {
+    return this._referenceCreator;
   }
   /**
    * Pad an identification key on the left with zero-value character for validation purposes. This is done to align an
@@ -591,7 +591,7 @@ var AbstractIdentificationKeyValidator = class _AbstractIdentificationKeyValidat
    * Padded identification key.
    */
   padIdentificationKey(identificationKey, validation) {
-    return validation?.positionOffset === void 0 ? identificationKey : this.referenceValidator.character(0).repeat(validation.positionOffset).concat(identificationKey);
+    return validation?.positionOffset === void 0 ? identificationKey : this.referenceCreator.character(0).repeat(validation.positionOffset).concat(identificationKey);
   }
   /**
    * Validate the prefix within an identification key.
@@ -858,9 +858,9 @@ var SerializableNumericIdentificationKeyValidator = class _SerializableNumericId
    */
   _serialComponentValidation;
   /**
-   * Serial component validator.
+   * Serial component creator.
    */
-  _serialComponentValidator;
+  _serialComponentCreator;
   /**
    * Constructor.
    *
@@ -887,7 +887,7 @@ var SerializableNumericIdentificationKeyValidator = class _SerializableNumericId
         ns: gs1NS
       })
     };
-    this._serialComponentValidator = _SerializableNumericIdentificationKeyValidator.validatorFor(serialComponentCharacterSet);
+    this._serialComponentCreator = _SerializableNumericIdentificationKeyValidator.creatorFor(serialComponentCharacterSet);
   }
   /**
    * Get the serial component length.
@@ -908,10 +908,10 @@ var SerializableNumericIdentificationKeyValidator = class _SerializableNumericId
     return this._serialComponentValidation;
   }
   /**
-   * Get the serial component validator.
+   * Get the serial component creator.
    */
-  get serialComponentValidator() {
-    return this._serialComponentValidator;
+  get serialComponentCreator() {
+    return this._serialComponentCreator;
   }
   /**
    * @inheritDoc
@@ -919,7 +919,7 @@ var SerializableNumericIdentificationKeyValidator = class _SerializableNumericId
   validate(identificationKey, validation) {
     super.validate(identificationKey.substring(0, this.length), validation);
     if (identificationKey.length > this.length) {
-      this.serialComponentValidator.validate(identificationKey.substring(this.length), this._serialComponentValidation);
+      this.serialComponentCreator.validate(identificationKey.substring(this.length), this._serialComponentValidation);
     }
   }
 };
@@ -979,7 +979,7 @@ var NonNumericIdentificationKeyValidator = class _NonNumericIdentificationKeyVal
     const partialIdentificationKey = this.requiresCheckCharacterPair ? identificationKey.substring(0, identificationKey.length - 2) : identificationKey;
     super.validatePrefix(partialIdentificationKey, validation?.positionOffset);
     if (!this.requiresCheckCharacterPair) {
-      this.referenceValidator.validate(identificationKey, {
+      this.referenceCreator.validate(identificationKey, {
         maximumLength: this.length,
         positionOffset: validation?.positionOffset
       });
@@ -1037,12 +1037,6 @@ var AbstractIdentificationKeyCreator = class {
     this._prefixManager = prefixManager;
     this._referenceLength = this.length - prefix.length - checkAllowance;
   }
-  /**
-   * @inheritDoc
-   */
-  get referenceCreator() {
-    return this.referenceValidator;
-  }
   /**
    * @inheritDoc
    */
@@ -1115,7 +1109,9 @@ var AbstractNumericIdentificationKeyCreator = class _AbstractNumericIdentificati
     const partialIdentificationKey = this.leaderType === 2 /* ExtensionDigit */ ? reference.substring(0, 1) + this.prefix + reference.substring(1) : this.prefix + reference;
     return partialIdentificationKey + checkDigit(partialIdentificationKey);
   }
-  // eslint-disable-next-line jsdoc/require-jsdoc -- Implementation of overloaded signatures.
+  /**
+   * @inheritDoc
+   */
   create(valueOrValues, sparse = false) {
     return import_utility3.NUMERIC_CREATOR.create(this.referenceLength, valueOrValues, import_utility3.Exclusion.None, sparse ? this.tweak : void 0, (reference) => this.buildIdentificationKey(reference));
   }
@@ -1213,7 +1209,22 @@ var GTINCreator = class _GTINCreator extends (0, import_ts_mixer.Mixin)(GTINVali
   get prefix() {
     return this.prefixManager.prefix;
   }
-  // eslint-disable-next-line jsdoc/require-jsdoc -- Implementation of overloaded signatures.
+  /**
+   * Create GTIN-14(s) with an indicator digit and reference(s) based on numeric value(s). The value(s) is/are
+   * converted to reference(s) of the appropriate length using {@linkcode NUMERIC_CREATOR}.
+   *
+   * @param indicatorDigit
+   * Indicator digit.
+   *
+   * @param valueOrValues
+   * Numeric value(s).
+   *
+   * @param sparse
+   * If true, the value(s) is/are mapped to a sparse sequence resistant to discovery. Default is false.
+   *
+   * @returns
+   * GTIN-14(s).
+   */
   createGTIN14(indicatorDigit, valueOrValues, sparse = false) {
     import_utility3.NUMERIC_CREATOR.validate(indicatorDigit, _GTINCreator.REQUIRED_INDICATOR_DIGIT_VALIDATION);
     return import_utility3.NUMERIC_CREATOR.create(13 /* GTIN13 */ - this.prefixManager.gs1CompanyPrefix.length - 1, valueOrValues, import_utility3.Exclusion.None, sparse ? this.tweak : void 0, (reference) => {
@@ -1386,30 +1397,66 @@ var SerializableNumericIdentificationKeyCreator = class extends (0, import_ts_mi
     this.init(prefixManager, prefixManager.gs1CompanyPrefix);
   }
   /**
-   * Get the serial component creator.
+   * Concatenate a validated base identification key with serial component(s).
+   *
+   * @param baseIdentificationKey
+   * Base identification key.
+   *
+   * @param serialComponentOrComponents
+   * Serial component(s).
+   *
+   * @returns
+   * Serialized identification key(s).
    */
-  get serialComponentCreator() {
-    return this.serialComponentValidator;
-  }
-  // eslint-disable-next-line jsdoc/require-jsdoc -- Implementation of overloaded signatures.
-  concatenateValidated(baseIdentificationKey, serialComponent) {
+  concatenateValidated(baseIdentificationKey, serialComponentOrComponents) {
     let result;
-    if (typeof serialComponent === "string") {
-      this.serialComponentCreator.validate(serialComponent, this.serialComponentValidation);
-      result = baseIdentificationKey + serialComponent;
+    const serialComponentCreator = this.serialComponentCreator;
+    const serialComponentValidation = this.serialComponentValidation;
+    function validateAndConcatenate(serialComponent) {
+      serialComponentCreator.validate(serialComponent, serialComponentValidation);
+      return baseIdentificationKey + serialComponent;
+    }
+    if (typeof serialComponentOrComponents !== "object") {
+      result = validateAndConcatenate(serialComponentOrComponents);
     } else {
-      result = import_utility3.IteratorProxy.from(serialComponent).map((serialComponent2) => this.concatenateValidated(baseIdentificationKey, serialComponent2));
+      result = import_utility3.IteratorProxy.from(serialComponentOrComponents).map(validateAndConcatenate);
     }
     return result;
   }
-  // eslint-disable-next-line jsdoc/require-jsdoc -- Implementation of overloaded signatures.
-  createSerialized(value, serialComponent, sparse = false) {
-    return this.concatenateValidated(this.create(value, sparse), serialComponent);
+  /**
+   * Create serialized identification key(s) with a reference based on a numeric value concatenated with serial
+   * component(s). The value is converted to a reference of the appropriate length using {@linkcode NUMERIC_CREATOR}.
+   *
+   * @param value
+   * Numeric value of the reference.
+   *
+   * @param serialComponentOrComponents
+   * Serial component(s).
+   *
+   * @param sparse
+   * If true, the value is mapped to a sparse sequence resistant to discovery. Default is false.
+   *
+   * @returns
+   * Serialized identification keys.
+   */
+  createSerialized(value, serialComponentOrComponents, sparse) {
+    return this.concatenateValidated(this.create(value, sparse), serialComponentOrComponents);
   }
-  // eslint-disable-next-line jsdoc/require-jsdoc -- Implementation of overloaded signatures.
-  concatenate(baseIdentificationKey, serialComponent) {
+  /**
+   * Concatenate a base identification key with serial component(s).
+   *
+   * @param baseIdentificationKey
+   * Base identification key.
+   *
+   * @param serialComponentOrComponents
+   * Serial component(s).
+   *
+   * @returns
+   * Serialized identification key(s).
+   */
+  concatenate(baseIdentificationKey, serialComponentOrComponents) {
     this.validate(baseIdentificationKey);
-    return this.concatenateValidated(baseIdentificationKey, serialComponent);
+    return this.concatenateValidated(baseIdentificationKey, serialComponentOrComponents);
   }
 };
 var NonNumericIdentificationKeyCreator = class extends (0, import_ts_mixer.Mixin)(NonNumericIdentificationKeyValidator, AbstractIdentificationKeyCreator) {
@@ -1448,15 +1495,36 @@ var NonNumericIdentificationKeyCreator = class extends (0, import_ts_mixer.Mixin
       })
     };
   }
-  // eslint-disable-next-line jsdoc/require-jsdoc -- Implementation of overloaded signatures.
+  /**
+   * Get the reference validation parameters.
+   */
+  get referenceValidation() {
+    return this._referenceValidation;
+  }
+  /**
+   * Create identification key(s) with reference(s).
+   *
+   * @param referenceOrReferences
+   * Reference(s).
+   *
+   * @returns
+   * Identification key(s).
+   */
   create(referenceOrReferences) {
     let result;
-    if (typeof referenceOrReferences === "string") {
-      this.referenceValidator.validate(referenceOrReferences, this._referenceValidation);
-      const partialIdentificationKey = this.prefix + referenceOrReferences;
-      result = this.requiresCheckCharacterPair ? partialIdentificationKey + checkCharacterPair(partialIdentificationKey) : partialIdentificationKey;
+    const referenceCreator = this.referenceCreator;
+    const referenceValidation = this.referenceValidation;
+    const prefix = this.prefix;
+    const requiresCheckCharacterPair = this.requiresCheckCharacterPair;
+    function validateAndCreate(reference) {
+      referenceCreator.validate(reference, referenceValidation);
+      const partialIdentificationKey = prefix + reference;
+      return requiresCheckCharacterPair ? partialIdentificationKey + checkCharacterPair(partialIdentificationKey) : partialIdentificationKey;
+    }
+    if (typeof referenceOrReferences !== "object") {
+      result = validateAndCreate(referenceOrReferences);
     } else {
-      result = import_utility3.IteratorProxy.from(referenceOrReferences).map((reference) => this.create(reference));
+      result = import_utility3.IteratorProxy.from(referenceOrReferences).map(validateAndCreate);
     }
     return result;
   }

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-import { CharacterSetCreator, StringValidation, StringValidator, CharacterSetValidator, CharacterSetValidation, Exclusion } from '@aidc-toolkit/utility';
+import { CharacterSetCreator, StringValidation, StringValidator, CharacterSetValidation, Exclusion, TransformerInput, TransformerOutput } from '@aidc-toolkit/utility';
 import * as ts_mixer_dist_types_types_js from 'ts-mixer/dist/types/types.js';
 
 /**
@@ -216,7 +216,7 @@ interface IdentificationKeyValidator<V extends IdentificationKeyValidation = Ide
     /**
      * Get the reference validator.
      */
-    get referenceValidator(): CharacterSetValidator;
+    get referenceCreator(): CharacterSetCreator;
     /**
      * Validate an identification key and throw an error if validation fails.
      *
@@ -250,19 +250,19 @@ declare abstract class AbstractIdentificationKeyValidator<V extends Identificati
      */
     private readonly _referenceCharacterSet;
     /**
-     * Reference validator.
+     * Reference creator.
      */
-    private readonly _referenceValidator;
+    private readonly _referenceCreator;
     /**
-     * Get the character set validator for a character set.
+     * Get the character set creator for a character set.
      *
      * @param characterSet
      * Character set.
      *
      * @returns
-     * Character set validator.
+     * Character set creator.
      */
-    protected static validatorFor(characterSet: CharacterSet): CharacterSetValidator;
+    protected static creatorFor(characterSet: CharacterSet): CharacterSetCreator;
     /**
      * Constructor.
      *
@@ -298,7 +298,7 @@ declare abstract class AbstractIdentificationKeyValidator<V extends Identificati
     /**
      * @inheritDoc
      */
-    get referenceValidator(): CharacterSetValidator;
+    get referenceCreator(): CharacterSetCreator;
     /**
      * Pad an identification key on the left with zero-value character for validation purposes. This is done to align an
      * identification key with a position offset for any error message that may be thrown by the reference validator.
@@ -514,9 +514,9 @@ declare class SerializableNumericIdentificationKeyValidator extends NonGTINNumer
      */
     private readonly _serialComponentValidation;
     /**
-     * Serial component validator.
+     * Serial component creator.
      */
-    private readonly _serialComponentValidator;
+    private readonly _serialComponentCreator;
     /**
      * Constructor.
      *
@@ -546,9 +546,9 @@ declare class SerializableNumericIdentificationKeyValidator extends NonGTINNumer
      */
     protected get serialComponentValidation(): CharacterSetValidation;
     /**
-     * Get the serial component validator.
+     * Get the serial component creator.
      */
-    get serialComponentValidator(): CharacterSetValidator;
+    get serialComponentCreator(): CharacterSetCreator;
     /**
      * @inheritDoc
      */
@@ -674,10 +674,6 @@ declare const GMN_VALIDATOR: NonNumericIdentificationKeyValidator;
  * Keys are created based on a prefix defined in a prefix manager to which the identification key creator is bound.
  */
 interface IdentificationKeyCreator extends IdentificationKeyValidator {
-    /**
-     * Get the reference creator.
-     */
-    get referenceCreator(): CharacterSetCreator;
     /**
      * Get the prefix manager to which this identification key creator is bound.
      */
@@ -723,11 +719,7 @@ declare abstract class AbstractIdentificationKeyCreator implements Identificatio
     abstract get prefixType(): PrefixType;
     abstract get length(): number;
     abstract get referenceCharacterSet(): CharacterSet;
-    abstract get referenceValidator(): CharacterSetValidator;
-    /**
-     * @inheritDoc
-     */
-    get referenceCreator(): CharacterSetCreator;
+    abstract get referenceCreator(): CharacterSetCreator;
     /**
      * @inheritDoc
      */
@@ -750,36 +742,20 @@ interface NumericIdentificationKeyCreator extends NumericIdentificationKeyValida
      * Get the capacity (`10**referenceLength`).
      */
     get capacity(): number;
-    create: {
-        /**
-         * Create an identification key with a reference based on a numeric value. The value is converted to a reference of
-         * the appropriate length using {@linkcode NUMERIC_CREATOR}.
-         *
-         * @param value
-         * Numeric value.
-         *
-         * @param sparse
-         * If true, the value is mapped to a sparse sequence resistant to discovery. Default is false.
-         *
-         * @returns
-         * Identification key.
-         */
-        (value: number | bigint, sparse?: boolean): string;
-        /**
-         * Create identification keys with references based on numeric values. The values are converted to references of
-         * the appropriate length using {@linkcode NUMERIC_CREATOR}.
-         *
-         * @param values
-         * Numeric values.
-         *
-         * @param sparse
-         * If true, the values are mapped to a sparse sequence resistant to discovery. Default is false.
-         *
-         * @returns
-         * Identification keys.
-         */
-        (values: Iterable<number | bigint>, sparse?: boolean): IterableIterator<string>;
-    };
+    /**
+     * Create identification key(s) with reference(s) based on numeric value(s). The value(s) is/are converted to
+     * references of the appropriate length using {@linkcode NUMERIC_CREATOR}.
+     *
+     * @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
+     * Identification key(s).
+     */
+    create: <T extends TransformerInput<number | bigint>>(valueOrValues: T, sparse?: boolean) => TransformerOutput<T, string>;
     /**
      * Create all identification keys for the prefix from `0` to `capacity - 1`.
      *
@@ -839,11 +815,7 @@ declare abstract class AbstractNumericIdentificationKeyCreator extends AbstractI
     /**
      * @inheritDoc
      */
-    create(value: number | bigint, sparse?: boolean): string;
-    /**
-     * @inheritDoc
-     */
-    create(values: Iterable<number | bigint>, sparse?: boolean): IterableIterator<string>;
+    create<T extends TransformerInput<number | bigint>>(valueOrValues: T, sparse?: boolean): TransformerOutput<T, string>;
     /**
      * Create all identification keys from a partial identification key. Call is recursive until remaining reference
      * length is 0.
@@ -901,41 +873,22 @@ declare class GTINCreator extends GTINCreator_base {
      */
     get prefix(): string;
     /**
-     * Create a GTIN-14 with an indicator digit and a reference based on a numeric value. The value is converted to a
-     * reference of the appropriate length using {@linkcode NUMERIC_CREATOR}.
+     * Create GTIN-14(s) with an indicator digit and reference(s) based on numeric value(s). The value(s) is/are
+     * converted to reference(s) of the appropriate length using {@linkcode NUMERIC_CREATOR}.
      *
      * @param indicatorDigit
      * Indicator digit.
      *
-     * @param value
-     * Numeric value of the reference.
+     * @param valueOrValues
+     * Numeric value(s).
      *
      * @param sparse
-     * If true, the value is mapped to a sparse sequence resistant to discovery. Default is false.
+     * If true, the value(s) is/are mapped to a sparse sequence resistant to discovery. Default is false.
      *
      * @returns
-     * GTIN-14.
+     * GTIN-14(s).
      */
-    createGTIN14(indicatorDigit: string, value: number | bigint, sparse?: boolean): string;
-    /**
-     * Create multiple GTIN-14s with an indicator digit and references based on numeric values. The values are converted
-     * to references of the appropriate length using {@linkcode NUMERIC_CREATOR}.
-     *
-     * The implementation uses {@link CharacterSetCreator.create}, so the values are created only as needed.
-     *
-     * @param indicatorDigit
-     * Indicator digit.
-     *
-     * @param values
-     * Values.
-     *
-     * @param sparse
-     * If true, the values are mapped to a sparse sequence resistant to discovery. Default is false.
-     *
-     * @returns
-     * Iterable iterator over created GTIN-14s.
-     */
-    createGTIN14(indicatorDigit: string, values: Iterable<number | bigint>, sparse?: boolean): IterableIterator<string>;
+    createGTIN14<T extends TransformerInput<number | bigint>>(indicatorDigit: string, valueOrValues: T, sparse?: boolean): TransformerOutput<T, string>;
     /**
      * Zero suppress a GTIN-12.
      *
@@ -1023,48 +976,27 @@ declare class SerializableNumericIdentificationKeyCreator extends SerializableNu
      */
     constructor(prefixManager: PrefixManager, identificationKeyType: IdentificationKeyType, length: number, serialComponentLength: number, serialComponentCharacterSet: CharacterSet);
     /**
-     * Get the serial component creator.
-     */
-    get serialComponentCreator(): CharacterSetCreator;
-    /**
-     * Concatenate a validated base identification key with a serial component.
+     * Concatenate a validated base identification key with serial component(s).
      *
      * @param baseIdentificationKey
      * Base identification key.
      *
-     * @param serialComponent
-     * Serial component.
+     * @param serialComponentOrComponents
+     * Serial component(s).
      *
      * @returns
-     * Serialized identification key.
+     * Serialized identification key(s).
      */
     private concatenateValidated;
     /**
-     * Create a serialized identification key with a reference based on a numeric value and a serial component. The
-     * value is converted to a reference of the appropriate length using {@linkcode NUMERIC_CREATOR}.
-     *
-     * @param value
-     * Numeric value of the references.
-     *
-     * @param serialComponent
-     * Serial component.
-     *
-     * @param sparse
-     * If true, the value is mapped to a sparse sequence resistant to discovery. Default is false.
-     *
-     * @returns
-     * Serialized identification key.
-     */
-    createSerialized(value: number, serialComponent: string, sparse?: boolean): string;
-    /**
-     * Create multiple serialized identification keys with a reference based on a numeric value and multiple serial
-     * components. The value is converted to a reference of the appropriate length using {@linkcode NUMERIC_CREATOR}.
+     * Create serialized identification key(s) with a reference based on a numeric value concatenated with serial
+     * component(s). The value is converted to a reference of the appropriate length using {@linkcode NUMERIC_CREATOR}.
      *
      * @param value
-     * Numeric value.
+     * Numeric value of the reference.
      *
-     * @param serialComponents
-     * Serial components.
+     * @param serialComponentOrComponents
+     * Serial component(s).
      *
      * @param sparse
      * If true, the value is mapped to a sparse sequence resistant to discovery. Default is false.
@@ -1072,33 +1004,20 @@ declare class SerializableNumericIdentificationKeyCreator extends SerializableNu
      * @returns
      * Serialized identification keys.
      */
-    createSerialized(value: number, serialComponents: Iterable<string>, sparse?: boolean): IterableIterator<string>;
-    /**
-     * Concatenate a base identification key with a serial component.
-     *
-     * @param baseIdentificationKey
-     * Base identification key.
-     *
-     * @param serialComponent
-     * Serial component.
-     *
-     * @returns
-     * Serialized identification key.
-     */
-    concatenate(baseIdentificationKey: string, serialComponent: string): string;
+    createSerialized<T extends TransformerInput<string>>(value: number, serialComponentOrComponents: T, sparse?: boolean): TransformerOutput<T, string>;
     /**
-     * Concatenate a base identification key with multiple serial components.
+     * Concatenate a base identification key with serial component(s).
      *
      * @param baseIdentificationKey
      * Base identification key.
      *
-     * @param serialComponents
-     * Serial components.
+     * @param serialComponentOrComponents
+     * Serial component(s).
      *
      * @returns
-     * Serialized identification keys.
+     * Serialized identification key(s).
      */
-    concatenate(baseIdentificationKey: string, serialComponents: Iterable<string>): IterableIterator<string>;
+    concatenate<T extends TransformerInput<string>>(baseIdentificationKey: string, serialComponentOrComponents: T): TransformerOutput<T, string>;
 }
 declare const NonNumericIdentificationKeyCreator_base: ts_mixer_dist_types_types_js.Class<any[], NonNumericIdentificationKeyValidator & AbstractIdentificationKeyCreator, typeof NonNumericIdentificationKeyValidator & typeof AbstractIdentificationKeyCreator>;
 /**
@@ -1130,25 +1049,19 @@ declare class NonNumericIdentificationKeyCreator extends NonNumericIdentificatio
      */
     constructor(prefixManager: PrefixManager, identificationKeyType: IdentificationKeyType, length: number, referenceCharacterSet: CharacterSet, requiresCheckCharacterPair?: boolean);
     /**
-     * Create an identification key with a reference.
-     *
-     * @param reference
-     * Reference.
-     *
-     * @returns
-     * Identification key.
+     * Get the reference validation parameters.
      */
-    create(reference: string): string;
+    protected get referenceValidation(): CharacterSetValidation;
     /**
-     * Create multiple identification keys with references.
+     * Create identification key(s) with reference(s).
      *
-     * @param references
-     * References.
+     * @param referenceOrReferences
+     * Reference(s).
      *
      * @returns
-     * Identification keys.
+     * Identification key(s).
      */
-    create(references: Iterable<string>): IterableIterator<string>;
+    create<T extends TransformerInput<string>>(referenceOrReferences: T): TransformerOutput<T, string>;
 }
 /**
  * Prefix manager. This is the core class for identification key creation.