@aidc-toolkit/gs1 1.0.46 → 1.0.47

package/dist/index.d.cts

@@ -1,6 +1,6 @@
 import { I18nLanguageDetector, Hyperlink, AbstractConstructor, AppData, Cache, AppDataStorage, HTTPFetch } from '@aidc-toolkit/core';
 import { Resource, i18n, ParseKeys } from 'i18next';
-import { CharacterSetCreator, CharacterSetValidator, CharacterSetValidation, StringValidation, StringValidator, Exclusions, TransformerInput, TransformerOutput } from '@aidc-toolkit/utility';
+import { CharacterSetCreator, CharacterSetValidator, CharacterSetValidation, StringValidation, StringValidator, Exclusions } from '@aidc-toolkit/utility';
 
 declare const _default: {
     AI64CharacterSetValidator: {
@@ -1400,23 +1400,36 @@ interface NumericIdentifierCreator<TNumericIdentifierType extends NumericIdentif
      * 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 {@linkcode 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: {
+        /**
+         * Create an identifier 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.
+         *
+         * @returns
+         * Identifier.
+         */
+        (value: number | bigint, sparse?: boolean): string;
+        /**
+         * Create identifiers 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.
+         *
+         * @returns
+         * Identifiers.
+         */
+        (values: Iterable<number | bigint>, sparse?: boolean): Iterable<string>;
+    };
     /**
      * Create all identifiers for the prefix from `0` to `capacity - 1`.
      *
@@ -1466,25 +1479,39 @@ declare class GTINCreator extends GTINCreator_base {
      */
     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}.
+     * Create GTIN-14 with an indicator digit and reference based on a numeric value. The value is converted to a
+     * reference of the appropriate length using {@linkcode NUMERIC_CREATOR}.
+     *
+     * @param indicatorDigit
+     * Indicator digit.
+     *
+     * @param value
+     * Numeric value.
      *
-     * @template TTransformerInput
-     * Transformer input type.
+     * @param sparse
+     * If true, the value is mapped to a sparse sequence resistant to discovery.
+     *
+     * @returns
+     * GTIN-14.
+     */
+    createGTIN14(indicatorDigit: string, value: number | bigint, sparse?: boolean): string;
+    /**
+     * Create 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}.
      *
      * @param indicatorDigit
      * Indicator digit.
      *
-     * @param valueOrValues
-     * Numeric value(s).
+     * @param values
+     * Numeric values.
      *
      * @param sparse
-     * If true, the value(s) is/are mapped to a sparse sequence resistant to discovery. Default is false.
+     * If true, the values are mapped to a sparse sequence resistant to discovery.
      *
      * @returns
-     * GTIN-14(s).
+     * GTIN-14s.
      */
-    createGTIN14<TTransformerInput extends TransformerInput<number | bigint>>(indicatorDigit: string, valueOrValues: TTransformerInput, sparse?: boolean): TransformerOutput<TTransformerInput, string>;
+    createGTIN14(indicatorDigit: string, values: Iterable<number | bigint>, sparse?: boolean): Iterable<string>;
 }
 
 /**
@@ -1510,41 +1537,65 @@ declare const SerializableNumericIdentifierCreator_base: abstract new (...args:
 declare class SerializableNumericIdentifierCreator extends SerializableNumericIdentifierCreator_base {
     #private;
     /**
-     * Create serialized identifier(s) with a reference based on a numeric value concatenated with serial component(s).
+     * Create a serialized identifier with a reference based on a numeric value concatenated with a serial component.
      * The value is converted to a reference of the appropriate length using {@linkcode NUMERIC_CREATOR}.
      *
-     * @template TTransformerInput
-     * Transformer input type.
+     * @param value
+     * Numeric value of the reference.
+     *
+     * @param serialComponent
+     * Serial component.
+     *
+     * @param sparse
+     * If true, the value is mapped to a sparse sequence resistant to discovery.
+     *
+     * @returns
+     * Serialized identifier.
+     */
+    createSerialized(value: number | bigint, serialComponent: string, sparse?: boolean): string;
+    /**
+     * Create serialized identifiers with a reference based on a numeric value concatenated with serial components. 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 serialComponents
+     * Serial components.
      *
      * @param sparse
-     * If true, the value is mapped to a sparse sequence resistant to discovery. Default is false.
+     * If true, the value is mapped to a sparse sequence resistant to discovery.
      *
      * @returns
      * Serialized identifiers.
      */
-    createSerialized<TTransformerInput extends TransformerInput<string>>(value: number, serialComponentOrComponents: TTransformerInput, sparse?: boolean): TransformerOutput<TTransformerInput, string>;
+    createSerialized(value: number | bigint, serialComponents: Iterable<string>, sparse?: boolean): Iterable<string>;
     /**
-     * Concatenate a base identifier with serial component(s).
+     * Concatenate a base identifier with a serial component.
+     *
+     * @param baseIdentifier
+     * Base identifier.
+     *
+     * @param serialComponent
+     * Serial component.
      *
-     * @template TTransformerInput
-     * Transformer input type.
+     * @returns
+     * Serialized identifier.
+     */
+    concatenate(baseIdentifier: string, serialComponent: string): string;
+    /**
+     * Concatenate a base identifier with serial components.
      *
      * @param baseIdentifier
      * Base identifier.
      *
-     * @param serialComponentOrComponents
-     * Serial component(s).
+     * @param serialComponents
+     * Serial components.
      *
      * @returns
-     * Serialized identifier(s).
+     * Serialized identifiers.
      */
-    concatenate<TTransformerInput extends TransformerInput<string>>(baseIdentifier: string, serialComponentOrComponents: TTransformerInput): TransformerOutput<TTransformerInput, string>;
+    concatenate(baseIdentifier: string, serialComponents: Iterable<string>): Iterable<string>;
 }
 
 /**
@@ -1587,18 +1638,25 @@ declare class NonNumericIdentifierCreator extends NonNumericIdentifierCreator_ba
      */
     protected get referenceValidation(): CharacterSetValidation;
     /**
-     * Create identifier(s) with reference(s).
+     * Create an identifier with a reference.
+     *
+     * @param reference
+     * Reference.
      *
-     * @template TTransformerInput
-     * Transformer input type.
+     * @returns
+     * Identifier.
+     */
+    create(reference: string): string;
+    /**
+     * Create identifiers with references.
      *
-     * @param referenceOrReferences
-     * Reference(s).
+     * @param references
+     * References.
      *
      * @returns
-     * Identifier(s).
+     * Identifiers.
      */
-    create<TTransformerInput extends TransformerInput<string>>(referenceOrReferences: TTransformerInput): TransformerOutput<TTransformerInput, string>;
+    create(references: Iterable<string>): Iterable<string>;
 }
 
 /**

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import { I18nLanguageDetector, Hyperlink, AbstractConstructor, AppData, Cache, AppDataStorage, HTTPFetch } from '@aidc-toolkit/core';
 import { Resource, i18n, ParseKeys } from 'i18next';
-import { CharacterSetCreator, CharacterSetValidator, CharacterSetValidation, StringValidation, StringValidator, Exclusions, TransformerInput, TransformerOutput } from '@aidc-toolkit/utility';
+import { CharacterSetCreator, CharacterSetValidator, CharacterSetValidation, StringValidation, StringValidator, Exclusions } from '@aidc-toolkit/utility';
 
 declare const _default: {
     AI64CharacterSetValidator: {
@@ -1400,23 +1400,36 @@ interface NumericIdentifierCreator<TNumericIdentifierType extends NumericIdentif
      * 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 {@linkcode 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: {
+        /**
+         * Create an identifier 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.
+         *
+         * @returns
+         * Identifier.
+         */
+        (value: number | bigint, sparse?: boolean): string;
+        /**
+         * Create identifiers 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.
+         *
+         * @returns
+         * Identifiers.
+         */
+        (values: Iterable<number | bigint>, sparse?: boolean): Iterable<string>;
+    };
     /**
      * Create all identifiers for the prefix from `0` to `capacity - 1`.
      *
@@ -1466,25 +1479,39 @@ declare class GTINCreator extends GTINCreator_base {
      */
     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}.
+     * Create GTIN-14 with an indicator digit and reference based on a numeric value. The value is converted to a
+     * reference of the appropriate length using {@linkcode NUMERIC_CREATOR}.
+     *
+     * @param indicatorDigit
+     * Indicator digit.
+     *
+     * @param value
+     * Numeric value.
      *
-     * @template TTransformerInput
-     * Transformer input type.
+     * @param sparse
+     * If true, the value is mapped to a sparse sequence resistant to discovery.
+     *
+     * @returns
+     * GTIN-14.
+     */
+    createGTIN14(indicatorDigit: string, value: number | bigint, sparse?: boolean): string;
+    /**
+     * Create 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}.
      *
      * @param indicatorDigit
      * Indicator digit.
      *
-     * @param valueOrValues
-     * Numeric value(s).
+     * @param values
+     * Numeric values.
      *
      * @param sparse
-     * If true, the value(s) is/are mapped to a sparse sequence resistant to discovery. Default is false.
+     * If true, the values are mapped to a sparse sequence resistant to discovery.
      *
      * @returns
-     * GTIN-14(s).
+     * GTIN-14s.
      */
-    createGTIN14<TTransformerInput extends TransformerInput<number | bigint>>(indicatorDigit: string, valueOrValues: TTransformerInput, sparse?: boolean): TransformerOutput<TTransformerInput, string>;
+    createGTIN14(indicatorDigit: string, values: Iterable<number | bigint>, sparse?: boolean): Iterable<string>;
 }
 
 /**
@@ -1510,41 +1537,65 @@ declare const SerializableNumericIdentifierCreator_base: abstract new (...args:
 declare class SerializableNumericIdentifierCreator extends SerializableNumericIdentifierCreator_base {
     #private;
     /**
-     * Create serialized identifier(s) with a reference based on a numeric value concatenated with serial component(s).
+     * Create a serialized identifier with a reference based on a numeric value concatenated with a serial component.
      * The value is converted to a reference of the appropriate length using {@linkcode NUMERIC_CREATOR}.
      *
-     * @template TTransformerInput
-     * Transformer input type.
+     * @param value
+     * Numeric value of the reference.
+     *
+     * @param serialComponent
+     * Serial component.
+     *
+     * @param sparse
+     * If true, the value is mapped to a sparse sequence resistant to discovery.
+     *
+     * @returns
+     * Serialized identifier.
+     */
+    createSerialized(value: number | bigint, serialComponent: string, sparse?: boolean): string;
+    /**
+     * Create serialized identifiers with a reference based on a numeric value concatenated with serial components. 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 serialComponents
+     * Serial components.
      *
      * @param sparse
-     * If true, the value is mapped to a sparse sequence resistant to discovery. Default is false.
+     * If true, the value is mapped to a sparse sequence resistant to discovery.
      *
      * @returns
      * Serialized identifiers.
      */
-    createSerialized<TTransformerInput extends TransformerInput<string>>(value: number, serialComponentOrComponents: TTransformerInput, sparse?: boolean): TransformerOutput<TTransformerInput, string>;
+    createSerialized(value: number | bigint, serialComponents: Iterable<string>, sparse?: boolean): Iterable<string>;
     /**
-     * Concatenate a base identifier with serial component(s).
+     * Concatenate a base identifier with a serial component.
+     *
+     * @param baseIdentifier
+     * Base identifier.
+     *
+     * @param serialComponent
+     * Serial component.
      *
-     * @template TTransformerInput
-     * Transformer input type.
+     * @returns
+     * Serialized identifier.
+     */
+    concatenate(baseIdentifier: string, serialComponent: string): string;
+    /**
+     * Concatenate a base identifier with serial components.
      *
      * @param baseIdentifier
      * Base identifier.
      *
-     * @param serialComponentOrComponents
-     * Serial component(s).
+     * @param serialComponents
+     * Serial components.
      *
      * @returns
-     * Serialized identifier(s).
+     * Serialized identifiers.
      */
-    concatenate<TTransformerInput extends TransformerInput<string>>(baseIdentifier: string, serialComponentOrComponents: TTransformerInput): TransformerOutput<TTransformerInput, string>;
+    concatenate(baseIdentifier: string, serialComponents: Iterable<string>): Iterable<string>;
 }
 
 /**
@@ -1587,18 +1638,25 @@ declare class NonNumericIdentifierCreator extends NonNumericIdentifierCreator_ba
      */
     protected get referenceValidation(): CharacterSetValidation;
     /**
-     * Create identifier(s) with reference(s).
+     * Create an identifier with a reference.
+     *
+     * @param reference
+     * Reference.
      *
-     * @template TTransformerInput
-     * Transformer input type.
+     * @returns
+     * Identifier.
+     */
+    create(reference: string): string;
+    /**
+     * Create identifiers with references.
      *
-     * @param referenceOrReferences
-     * Reference(s).
+     * @param references
+     * References.
      *
      * @returns
-     * Identifier(s).
+     * Identifiers.
      */
-    create<TTransformerInput extends TransformerInput<string>>(referenceOrReferences: TTransformerInput): TransformerOutput<TTransformerInput, string>;
+    create(references: Iterable<string>): Iterable<string>;
 }
 
 /**