@aidc-toolkit/utility 1.0.25-beta → 1.0.27-beta

package/dist/iterable-utility.js

@@ -0,0 +1,35 @@
+/**
+ * Map an input iterable to an output iterable that applies a transformer callback to each value in the input.
+ *
+ * @template TInput
+ * Input type.
+ *
+ * @template TOutput
+ * Output type.
+ *
+ * @param values
+ * Input values iterable.
+ *
+ * @param indexedCallback
+ * Callback to transform input value to output value.
+ *
+ * @returns
+ * Output values iterable.
+ */
+export function mapIterable(values, indexedCallback) {
+    return {
+        /**
+         * Iterable implementation.
+         *
+         * @yields
+         * Next output value.
+         */
+        *[Symbol.iterator]() {
+            let index = 0;
+            for (const value of values) {
+                yield indexedCallback(value, index++);
+            }
+        }
+    };
+}
+//# sourceMappingURL=iterable-utility.js.map

package/dist/iterable-utility.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"iterable-utility.js","sourceRoot":"","sources":["../src/iterable-utility.ts"],"names":[],"mappings":"AAoBA;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,WAAW,CAAkB,MAAwB,EAAE,eAAiD;IACpH,OAAO;QACH;;;;;WAKG;QACH,CAAE,CAAC,MAAM,CAAC,QAAQ,CAAC;YACf,IAAI,KAAK,GAAG,CAAC,CAAC;YAEd,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;gBACzB,MAAM,eAAe,CAAC,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;YAC1C,CAAC;QACL,CAAC;KACJ,CAAC;AACN,CAAC"}

package/dist/locale/en/locale-resources.d.ts

@@ -0,0 +1,33 @@
+declare const _default: {
+    readonly Transformer: {
+        readonly domainMustBeGreaterThanZero: "Domain {{domain, number}} must be greater than 0";
+        readonly tweakMustBeGreaterThanOrEqualToZero: "Tweak {{tweak, number}} must be greater than or equal to 0";
+        readonly valueMustBeGreaterThanOrEqualToZero: "Value {{value, number}} must be greater than or equal to 0";
+        readonly valueMustBeLessThan: "Value {{value, number}} must be less than {{domain, number}}";
+        readonly minimumValueMustBeGreaterThanOrEqualToZero: "Minimum value {{minimumValue, number}} must be greater than or equal to 0";
+        readonly maximumValueMustBeLessThan: "Maximum value {{maximumValue, number}} must be less than {{domain, number}}";
+    };
+    readonly RegExpValidator: {
+        readonly stringDoesNotMatchPattern: "String {{s}} does not match pattern";
+    };
+    readonly CharacterSetValidator: {
+        readonly firstZeroFirstCharacter: "Character set must support zero as first character";
+        readonly allNumericAllNumericCharacters: "Character set must support all numeric characters in sequence";
+        readonly stringMustNotBeAllNumeric: "String must not be all numeric";
+        readonly lengthMustBeGreaterThanOrEqualTo: "Length {{length, number}} must be greater than or equal to {{minimumLength, number}}";
+        readonly lengthMustBeLessThanOrEqualTo: "Length {{length, number}} must be less than or equal to {{maximumLength, number}}";
+        readonly lengthMustBeEqualTo: "Length {{length, number}} must be equal to {{exactLength, number}}";
+        readonly lengthOfComponentMustBeGreaterThanOrEqualTo: "Length {{length, number}} of {{component}} must be greater than or equal to {{minimumLength, number}}";
+        readonly lengthOfComponentMustBeLessThanOrEqualTo: "Length {{length, number}} of {{component}} must be less than or equal to {{maximumLength, number}}";
+        readonly lengthOfComponentMustBeEqualTo: "Length {{length, number}} of {{component}} must be equal to {{exactLength, number}}";
+        readonly invalidCharacterAtPosition: "Invalid character '{{c}}' at position {{position, number}}";
+        readonly invalidCharacterAtPositionOfComponent: "Invalid character '{{c}}' at position {{position, number}} of {{component}}";
+        readonly exclusionNotSupported: "Exclusion value of {{exclusion, number}} is not supported";
+        readonly endSequenceValueMustBeLessThanOrEqualTo: "End sequence value (start sequence value + count - 1) must be less than {{domain, number}}";
+    };
+    readonly RecordValidator: {
+        readonly typeNameKeyNotFound: "{{typeName}} \"{{key}}\" not found";
+    };
+};
+export default _default;
+//# sourceMappingURL=locale-resources.d.ts.map

package/dist/locale/en/locale-resources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"locale-resources.d.ts","sourceRoot":"","sources":["../../../src/locale/en/locale-resources.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,wBA8BW"}

package/dist/locale/en/locale-resources.js

@@ -0,0 +1,32 @@
+export default {
+    Transformer: {
+        domainMustBeGreaterThanZero: "Domain {{domain, number}} must be greater than 0",
+        tweakMustBeGreaterThanOrEqualToZero: "Tweak {{tweak, number}} must be greater than or equal to 0",
+        valueMustBeGreaterThanOrEqualToZero: "Value {{value, number}} must be greater than or equal to 0",
+        valueMustBeLessThan: "Value {{value, number}} must be less than {{domain, number}}",
+        minimumValueMustBeGreaterThanOrEqualToZero: "Minimum value {{minimumValue, number}} must be greater than or equal to 0",
+        maximumValueMustBeLessThan: "Maximum value {{maximumValue, number}} must be less than {{domain, number}}"
+    },
+    RegExpValidator: {
+        stringDoesNotMatchPattern: "String {{s}} does not match pattern"
+    },
+    CharacterSetValidator: {
+        firstZeroFirstCharacter: "Character set must support zero as first character",
+        allNumericAllNumericCharacters: "Character set must support all numeric characters in sequence",
+        stringMustNotBeAllNumeric: "String must not be all numeric",
+        lengthMustBeGreaterThanOrEqualTo: "Length {{length, number}} must be greater than or equal to {{minimumLength, number}}",
+        lengthMustBeLessThanOrEqualTo: "Length {{length, number}} must be less than or equal to {{maximumLength, number}}",
+        lengthMustBeEqualTo: "Length {{length, number}} must be equal to {{exactLength, number}}",
+        lengthOfComponentMustBeGreaterThanOrEqualTo: "Length {{length, number}} of {{component}} must be greater than or equal to {{minimumLength, number}}",
+        lengthOfComponentMustBeLessThanOrEqualTo: "Length {{length, number}} of {{component}} must be less than or equal to {{maximumLength, number}}",
+        lengthOfComponentMustBeEqualTo: "Length {{length, number}} of {{component}} must be equal to {{exactLength, number}}",
+        invalidCharacterAtPosition: "Invalid character '{{c}}' at position {{position, number}}",
+        invalidCharacterAtPositionOfComponent: "Invalid character '{{c}}' at position {{position, number}} of {{component}}",
+        exclusionNotSupported: "Exclusion value of {{exclusion, number}} is not supported",
+        endSequenceValueMustBeLessThanOrEqualTo: "End sequence value (start sequence value + count - 1) must be less than {{domain, number}}"
+    },
+    RecordValidator: {
+        typeNameKeyNotFound: "{{typeName}} \"{{key}}\" not found"
+    }
+};
+//# sourceMappingURL=locale-resources.js.map

package/dist/locale/en/locale-resources.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"locale-resources.js","sourceRoot":"","sources":["../../../src/locale/en/locale-resources.ts"],"names":[],"mappings":"AAAA,eAAe;IACX,WAAW,EAAE;QACT,2BAA2B,EAAE,kDAAkD;QAC/E,mCAAmC,EAAE,4DAA4D;QACjG,mCAAmC,EAAE,4DAA4D;QACjG,mBAAmB,EAAE,8DAA8D;QACnF,0CAA0C,EAAE,2EAA2E;QACvH,0BAA0B,EAAE,6EAA6E;KAC5G;IACD,eAAe,EAAE;QACb,yBAAyB,EAAE,qCAAqC;KACnE;IACD,qBAAqB,EAAE;QACnB,uBAAuB,EAAE,oDAAoD;QAC7E,8BAA8B,EAAE,+DAA+D;QAC/F,yBAAyB,EAAE,gCAAgC;QAC3D,gCAAgC,EAAE,sFAAsF;QACxH,6BAA6B,EAAE,mFAAmF;QAClH,mBAAmB,EAAE,oEAAoE;QACzF,2CAA2C,EAAE,uGAAuG;QACpJ,wCAAwC,EAAE,oGAAoG;QAC9I,8BAA8B,EAAE,qFAAqF;QACrH,0BAA0B,EAAE,4DAA4D;QACxF,qCAAqC,EAAE,6EAA6E;QACpH,qBAAqB,EAAE,2DAA2D;QAClF,uCAAuC,EAAE,4FAA4F;KACxI;IACD,eAAe,EAAE;QACb,mBAAmB,EAAE,oCAAoC;KAC5D;CACK,CAAC"}

package/dist/locale/fr/locale-resources.d.ts

@@ -0,0 +1,33 @@
+declare const _default: {
+    readonly Transformer: {
+        readonly domainMustBeGreaterThanZero: "Le domaine {{domain, number}} doit être supérieur à 0";
+        readonly tweakMustBeGreaterThanOrEqualToZero: "Le réglage {{tweak, number}} doit être supérieur ou égal à 0";
+        readonly valueMustBeGreaterThanOrEqualToZero: "La valeur {{value, number}} doit être supérieure ou égale à 0";
+        readonly valueMustBeLessThan: "La valeur {{value, number}} doit être inférieure à {{domain, number}}";
+        readonly minimumValueMustBeGreaterThanOrEqualToZero: "La valeur minimale {{minimumValue, number}} doit être supérieure ou égale à 0";
+        readonly maximumValueMustBeLessThan: "La valeur maximale {{maximumValue, number}} doit être inférieure à {{domain, number}}";
+    };
+    readonly RegExpValidator: {
+        readonly stringDoesNotMatchPattern: "La chaîne {{s}} ne correspond pas au modèle";
+    };
+    readonly CharacterSetValidator: {
+        readonly firstZeroFirstCharacter: "Le jeu de caractères doit prendre en charge zéro comme premier caractère";
+        readonly allNumericAllNumericCharacters: "Le jeu de caractères doit prendre en charge tous les caractères numériques en séquence";
+        readonly stringMustNotBeAllNumeric: "La chaîne ne doit pas être entièrement numérique";
+        readonly lengthMustBeGreaterThanOrEqualTo: "La longueur {{length, number}} doit être supérieure ou égale à {{minimumLength, number}}";
+        readonly lengthMustBeLessThanOrEqualTo: "La longueur {{length, number}} doit être inférieure ou égale à {{maximumLength, number}}";
+        readonly lengthMustBeEqualTo: "La longueur {{length, number}} doit être égale à {{exactLength, number}}";
+        readonly lengthOfComponentMustBeGreaterThanOrEqualTo: "La longueur {{length, number}} de {{component}} doit être supérieure ou égale à {{minimumLength, number}}";
+        readonly lengthOfComponentMustBeLessThanOrEqualTo: "La longueur {{length, number}} de {{component}} doit être inférieure ou égale à {{maximumLength, number}}";
+        readonly lengthOfComponentMustBeEqualTo: "La longueur {{length, number}} de {{component}} doit être égale à {{exactLength, number}}";
+        readonly invalidCharacterAtPosition: "Caractère non valide '{{c}}' à la position {{position, number}}";
+        readonly invalidCharacterAtPositionOfComponent: "Caractère non valide '{{c}}' à la position {{position, number}} de {{component}}";
+        readonly exclusionNotSupported: "La valeur d'exclusion de {{exclusion, number}} n'est pas prise en charge";
+        readonly endSequenceValueMustBeLessThanOrEqualTo: "La valeur de la séquence de fin (valeur de la séquence de début + nombre - 1) doit être inférieure à {{domain, number}}";
+    };
+    readonly RecordValidator: {
+        readonly typeNameKeyNotFound: "{{typeName}} \"{{key}}\" introuvable";
+    };
+};
+export default _default;
+//# sourceMappingURL=locale-resources.d.ts.map

package/dist/locale/fr/locale-resources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"locale-resources.d.ts","sourceRoot":"","sources":["../../../src/locale/fr/locale-resources.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,wBA8BW"}

package/dist/locale/fr/locale-resources.js

@@ -0,0 +1,32 @@
+export default {
+    Transformer: {
+        domainMustBeGreaterThanZero: "Le domaine {{domain, number}} doit être supérieur à 0",
+        tweakMustBeGreaterThanOrEqualToZero: "Le réglage {{tweak, number}} doit être supérieur ou égal à 0",
+        valueMustBeGreaterThanOrEqualToZero: "La valeur {{value, number}} doit être supérieure ou égale à 0",
+        valueMustBeLessThan: "La valeur {{value, number}} doit être inférieure à {{domain, number}}",
+        minimumValueMustBeGreaterThanOrEqualToZero: "La valeur minimale {{minimumValue, number}} doit être supérieure ou égale à 0",
+        maximumValueMustBeLessThan: "La valeur maximale {{maximumValue, number}} doit être inférieure à {{domain, number}}"
+    },
+    RegExpValidator: {
+        stringDoesNotMatchPattern: "La chaîne {{s}} ne correspond pas au modèle"
+    },
+    CharacterSetValidator: {
+        firstZeroFirstCharacter: "Le jeu de caractères doit prendre en charge zéro comme premier caractère",
+        allNumericAllNumericCharacters: "Le jeu de caractères doit prendre en charge tous les caractères numériques en séquence",
+        stringMustNotBeAllNumeric: "La chaîne ne doit pas être entièrement numérique",
+        lengthMustBeGreaterThanOrEqualTo: "La longueur {{length, number}} doit être supérieure ou égale à {{minimumLength, number}}",
+        lengthMustBeLessThanOrEqualTo: "La longueur {{length, number}} doit être inférieure ou égale à {{maximumLength, number}}",
+        lengthMustBeEqualTo: "La longueur {{length, number}} doit être égale à {{exactLength, number}}",
+        lengthOfComponentMustBeGreaterThanOrEqualTo: "La longueur {{length, number}} de {{component}} doit être supérieure ou égale à {{minimumLength, number}}",
+        lengthOfComponentMustBeLessThanOrEqualTo: "La longueur {{length, number}} de {{component}} doit être inférieure ou égale à {{maximumLength, number}}",
+        lengthOfComponentMustBeEqualTo: "La longueur {{length, number}} de {{component}} doit être égale à {{exactLength, number}}",
+        invalidCharacterAtPosition: "Caractère non valide '{{c}}' à la position {{position, number}}",
+        invalidCharacterAtPositionOfComponent: "Caractère non valide '{{c}}' à la position {{position, number}} de {{component}}",
+        exclusionNotSupported: "La valeur d'exclusion de {{exclusion, number}} n'est pas prise en charge",
+        endSequenceValueMustBeLessThanOrEqualTo: "La valeur de la séquence de fin (valeur de la séquence de début + nombre - 1) doit être inférieure à {{domain, number}}"
+    },
+    RecordValidator: {
+        typeNameKeyNotFound: "{{typeName}} \"{{key}}\" introuvable"
+    }
+};
+//# sourceMappingURL=locale-resources.js.map

package/dist/locale/fr/locale-resources.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"locale-resources.js","sourceRoot":"","sources":["../../../src/locale/fr/locale-resources.ts"],"names":[],"mappings":"AAAA,eAAe;IACX,WAAW,EAAE;QACT,2BAA2B,EAAE,uDAAuD;QACpF,mCAAmC,EAAE,8DAA8D;QACnG,mCAAmC,EAAE,+DAA+D;QACpG,mBAAmB,EAAE,uEAAuE;QAC5F,0CAA0C,EAAE,+EAA+E;QAC3H,0BAA0B,EAAE,uFAAuF;KACtH;IACD,eAAe,EAAE;QACb,yBAAyB,EAAE,6CAA6C;KAC3E;IACD,qBAAqB,EAAE;QACnB,uBAAuB,EAAE,0EAA0E;QACnG,8BAA8B,EAAE,wFAAwF;QACxH,yBAAyB,EAAE,kDAAkD;QAC7E,gCAAgC,EAAE,0FAA0F;QAC5H,6BAA6B,EAAE,0FAA0F;QACzH,mBAAmB,EAAE,0EAA0E;QAC/F,2CAA2C,EAAE,2GAA2G;QACxJ,wCAAwC,EAAE,2GAA2G;QACrJ,8BAA8B,EAAE,2FAA2F;QAC3H,0BAA0B,EAAE,iEAAiE;QAC7F,qCAAqC,EAAE,kFAAkF;QACzH,qBAAqB,EAAE,0EAA0E;QACjG,uCAAuC,EAAE,yHAAyH;KACrK;IACD,eAAe,EAAE;QACb,mBAAmB,EAAE,sCAAsC;KAC9D;CACK,CAAC"}

package/dist/locale/i18n.d.ts

@@ -0,0 +1,27 @@
+import { type I18nEnvironment } from "@aidc-toolkit/core";
+import { type i18n, type Resource } from "i18next";
+import enLocaleResources from "./en/locale-resources.js";
+export declare const utilityNS = "aidct_utility";
+/**
+ * Locale strings type is extracted from the English locale strings object.
+ */
+export type UtilityLocaleResources = typeof enLocaleResources;
+/**
+ * Utility resources.
+ */
+export declare const utilityResources: Resource;
+export declare const i18nextUtility: i18n;
+/**
+ * Initialize internationalization.
+ *
+ * @param environment
+ * Environment in which the application is running.
+ *
+ * @param debug
+ * Debug setting.
+ *
+ * @returns
+ * Void promise.
+ */
+export declare function i18nUtilityInit(environment: I18nEnvironment, debug?: boolean): Promise<void>;
+//# sourceMappingURL=i18n.d.ts.map

package/dist/locale/i18n.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"i18n.d.ts","sourceRoot":"","sources":["../../src/locale/i18n.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACxE,OAAgB,EAAE,KAAK,IAAI,EAAE,KAAK,QAAQ,EAAE,MAAM,SAAS,CAAC;AAC5D,OAAO,iBAAiB,MAAM,0BAA0B,CAAC;AAGzD,eAAO,MAAM,SAAS,kBAAkB,CAAC;AAEzC;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG,OAAO,iBAAiB,CAAC;AAE9D;;GAEG;AACH,eAAO,MAAM,gBAAgB,EAAE,QAO9B,CAAC;AAGF,eAAO,MAAM,cAAc,EAAE,IAA+B,CAAC;AAE7D;;;;;;;;;;;GAWG;AACH,wBAAsB,eAAe,CAAC,WAAW,EAAE,eAAe,EAAE,KAAK,UAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAEhG"}

package/dist/locale/i18n.js

@@ -0,0 +1,34 @@
+import { i18nCoreInit } from "@aidc-toolkit/core";
+import i18next from "i18next";
+import enLocaleResources from "./en/locale-resources.js";
+import frLocaleResources from "./fr/locale-resources.js";
+export const utilityNS = "aidct_utility";
+/**
+ * Utility resources.
+ */
+export const utilityResources = {
+    en: {
+        aidct_utility: enLocaleResources
+    },
+    fr: {
+        aidct_utility: frLocaleResources
+    }
+};
+// Explicit type is necessary because type can't be inferred without additional references.
+export const i18nextUtility = i18next.createInstance();
+/**
+ * Initialize internationalization.
+ *
+ * @param environment
+ * Environment in which the application is running.
+ *
+ * @param debug
+ * Debug setting.
+ *
+ * @returns
+ * Void promise.
+ */
+export async function i18nUtilityInit(environment, debug = false) {
+    await i18nCoreInit(i18nextUtility, environment, debug, utilityNS, utilityResources);
+}
+//# sourceMappingURL=i18n.js.map

package/dist/locale/i18n.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"i18n.js","sourceRoot":"","sources":["../../src/locale/i18n.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAwB,MAAM,oBAAoB,CAAC;AACxE,OAAO,OAAqC,MAAM,SAAS,CAAC;AAC5D,OAAO,iBAAiB,MAAM,0BAA0B,CAAC;AACzD,OAAO,iBAAiB,MAAM,0BAA0B,CAAC;AAEzD,MAAM,CAAC,MAAM,SAAS,GAAG,eAAe,CAAC;AAOzC;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAa;IACtC,EAAE,EAAE;QACA,aAAa,EAAE,iBAAiB;KACnC;IACD,EAAE,EAAE;QACA,aAAa,EAAE,iBAAiB;KACnC;CACJ,CAAC;AAEF,2FAA2F;AAC3F,MAAM,CAAC,MAAM,cAAc,GAAS,OAAO,CAAC,cAAc,EAAE,CAAC;AAE7D;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,WAA4B,EAAE,KAAK,GAAG,KAAK;IAC7E,MAAM,YAAY,CAAC,cAAc,EAAE,WAAW,EAAE,KAAK,EAAE,SAAS,EAAE,gBAAgB,CAAC,CAAC;AACxF,CAAC"}

package/dist/record.d.ts

@@ -0,0 +1,37 @@
+import type { StringValidator } from "./string.js";
+/**
+ * Record validator. Validation is performed against a record with a string key type and throws an error if the key is
+ * not found.
+ *
+ * @template T
+ * Property type.
+ */
+export declare class RecordValidator<T> implements StringValidator {
+    #private;
+    /**
+     * Constructor.
+     *
+     * @param typeName
+     * Type name for error message.
+     *
+     * @param record
+     * Record in which to look up keys.
+     */
+    constructor(typeName: string, record: Readonly<Record<string, T>>);
+    /**
+     * Get the type name.
+     */
+    get typeName(): string;
+    /**
+     * Get the record.
+     */
+    get record(): Readonly<Record<string, T>>;
+    /**
+     * Validate a key by looking it up in the record.
+     *
+     * @param key
+     * Record key.
+     */
+    validate(key: string): void;
+}
+//# sourceMappingURL=record.d.ts.map

package/dist/record.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"record.d.ts","sourceRoot":"","sources":["../src/record.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD;;;;;;GAMG;AACH,qBAAa,eAAe,CAAC,CAAC,CAAE,YAAW,eAAe;;IAWtD;;;;;;;;OAQG;gBACS,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IAKjE;;OAEG;IACH,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED;;OAEG;IACH,IAAI,MAAM,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAExC;IAED;;;;;OAKG;IACH,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;CAQ9B"}

package/dist/record.js

@@ -0,0 +1,58 @@
+import { i18nextUtility } from "./locale/i18n.js";
+/**
+ * Record validator. Validation is performed against a record with a string key type and throws an error if the key is
+ * not found.
+ *
+ * @template T
+ * Property type.
+ */
+export class RecordValidator {
+    /**
+     * Type name for error message.
+     */
+    #typeName;
+    /**
+     * Record in which to look up keys.
+     */
+    #record;
+    /**
+     * Constructor.
+     *
+     * @param typeName
+     * Type name for error message.
+     *
+     * @param record
+     * Record in which to look up keys.
+     */
+    constructor(typeName, record) {
+        this.#typeName = typeName;
+        this.#record = record;
+    }
+    /**
+     * Get the type name.
+     */
+    get typeName() {
+        return this.#typeName;
+    }
+    /**
+     * Get the record.
+     */
+    get record() {
+        return this.#record;
+    }
+    /**
+     * Validate a key by looking it up in the record.
+     *
+     * @param key
+     * Record key.
+     */
+    validate(key) {
+        if (!(key in this.record)) {
+            throw new RangeError(i18nextUtility.t("RecordValidator.typeNameKeyNotFound", {
+                typeName: this.typeName,
+                key
+            }));
+        }
+    }
+}
+//# sourceMappingURL=record.js.map

package/dist/record.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"record.js","sourceRoot":"","sources":["../src/record.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAGlD;;;;;;GAMG;AACH,MAAM,OAAO,eAAe;IACxB;;OAEG;IACM,SAAS,CAAS;IAE3B;;OAEG;IACM,OAAO,CAA8B;IAE9C;;;;;;;;OAQG;IACH,YAAY,QAAgB,EAAE,MAAmC;QAC7D,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC;QAC1B,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;IAC1B,CAAC;IAED;;OAEG;IACH,IAAI,QAAQ;QACR,OAAO,IAAI,CAAC,SAAS,CAAC;IAC1B,CAAC;IAED;;OAEG;IACH,IAAI,MAAM;QACN,OAAO,IAAI,CAAC,OAAO,CAAC;IACxB,CAAC;IAED;;;;;OAKG;IACH,QAAQ,CAAC,GAAW;QAChB,IAAI,CAAC,CAAC,GAAG,IAAI,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;YACxB,MAAM,IAAI,UAAU,CAAC,cAAc,CAAC,CAAC,CAAC,qCAAqC,EAAE;gBACzE,QAAQ,EAAE,IAAI,CAAC,QAAQ;gBACvB,GAAG;aACN,CAAC,CAAC,CAAC;QACR,CAAC;IACL,CAAC;CACJ"}

package/dist/reg-exp.d.ts

@@ -0,0 +1,40 @@
+import type { StringValidator } from "./string.js";
+/**
+ * Regular expression validator. The regular expression applies to the full string only if constructed as such. For
+ * example, <code>&#x2F;\d&#x2A;&#x2F;</code> (0 or more digits) matches every string, <code>&#x2F;\d+&#x2F;</code> (1
+ * or more digits) matches strings with at least one digit, <code>&#x2F;^\d&#x2A;$&#x2F;</code> matches strings that are
+ * all digits or empty, and <code>&#x2F;^\d+$&#x2F;</code> matches strings that are all digits and not empty.
+ *
+ * Clients of this class are recommended to override the {@linkcode createErrorMessage | createErrorMessage()} method
+ * to create a more suitable error message for their use case.
+ */
+export declare class RegExpValidator implements StringValidator {
+    #private;
+    /**
+     * Constructor.
+     *
+     * @param regExp
+     * Regular expression. See {@link RegExpValidator | class documentation} for notes.
+     */
+    constructor(regExp: RegExp);
+    /**
+     * Get the regular expression.
+     */
+    get regExp(): RegExp;
+    /**
+     * Create an error message for a string. The generic error message is sufficient for many use cases but a more
+     * domain-specific error message, possibly including the pattern itself, is often required.
+     *
+     * @param s
+     * String.
+     *
+     * @returns
+     * Error message.
+     */
+    protected createErrorMessage(s: string): string;
+    /**
+     * @inheritDoc
+     */
+    validate(s: string): void;
+}
+//# sourceMappingURL=reg-exp.d.ts.map

package/dist/reg-exp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reg-exp.d.ts","sourceRoot":"","sources":["../src/reg-exp.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD;;;;;;;;GAQG;AACH,qBAAa,eAAgB,YAAW,eAAe;;IAMnD;;;;;OAKG;gBACS,MAAM,EAAE,MAAM;IAI1B;;OAEG;IACH,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED;;;;;;;;;OASG;IACH,SAAS,CAAC,kBAAkB,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM;IAM/C;;OAEG;IACH,QAAQ,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI;CAK5B"}

package/dist/reg-exp.js

@@ -0,0 +1,55 @@
+import { i18nextUtility } from "./locale/i18n.js";
+/**
+ * Regular expression validator. The regular expression applies to the full string only if constructed as such. For
+ * example, <code>&#x2F;\d&#x2A;&#x2F;</code> (0 or more digits) matches every string, <code>&#x2F;\d+&#x2F;</code> (1
+ * or more digits) matches strings with at least one digit, <code>&#x2F;^\d&#x2A;$&#x2F;</code> matches strings that are
+ * all digits or empty, and <code>&#x2F;^\d+$&#x2F;</code> matches strings that are all digits and not empty.
+ *
+ * Clients of this class are recommended to override the {@linkcode createErrorMessage | createErrorMessage()} method
+ * to create a more suitable error message for their use case.
+ */
+export class RegExpValidator {
+    /**
+     * Regular expression.
+     */
+    #regExp;
+    /**
+     * Constructor.
+     *
+     * @param regExp
+     * Regular expression. See {@link RegExpValidator | class documentation} for notes.
+     */
+    constructor(regExp) {
+        this.#regExp = regExp;
+    }
+    /**
+     * Get the regular expression.
+     */
+    get regExp() {
+        return this.#regExp;
+    }
+    /**
+     * Create an error message for a string. The generic error message is sufficient for many use cases but a more
+     * domain-specific error message, possibly including the pattern itself, is often required.
+     *
+     * @param s
+     * String.
+     *
+     * @returns
+     * Error message.
+     */
+    createErrorMessage(s) {
+        return i18nextUtility.t("RegExpValidator.stringDoesNotMatchPattern", {
+            s
+        });
+    }
+    /**
+     * @inheritDoc
+     */
+    validate(s) {
+        if (!this.#regExp.test(s)) {
+            throw new RangeError(this.createErrorMessage(s));
+        }
+    }
+}
+//# sourceMappingURL=reg-exp.js.map

package/dist/reg-exp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reg-exp.js","sourceRoot":"","sources":["../src/reg-exp.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAGlD;;;;;;;;GAQG;AACH,MAAM,OAAO,eAAe;IACxB;;OAEG;IACM,OAAO,CAAS;IAEzB;;;;;OAKG;IACH,YAAY,MAAc;QACtB,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;IAC1B,CAAC;IAED;;OAEG;IACH,IAAI,MAAM;QACN,OAAO,IAAI,CAAC,OAAO,CAAC;IACxB,CAAC;IAED;;;;;;;;;OASG;IACO,kBAAkB,CAAC,CAAS;QAClC,OAAO,cAAc,CAAC,CAAC,CAAC,2CAA2C,EAAE;YACjE,CAAC;SACJ,CAAC,CAAC;IACP,CAAC;IAED;;OAEG;IACH,QAAQ,CAAC,CAAS;QACd,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;YACxB,MAAM,IAAI,UAAU,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,CAAC;QACrD,CAAC;IACL,CAAC;CACJ"}

package/dist/sequence.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Sequence. Defines an ascending or descending sequence of big integers implemented as an iterable.
+ */
+export declare class Sequence implements Iterable<bigint> {
+    #private;
+    /**
+     * Constructor.
+     *
+     * @param startValue
+     * Start value.
+     *
+     * @param count
+     * Count of values. If count is zero or positive, iteration ascends from start value, otherwise it descends from
+     * start value.
+     */
+    constructor(startValue: number | bigint, count: number);
+    /**
+     * Get the start value (inclusive).
+     */
+    get startValue(): bigint;
+    /**
+     * Get the end value (exclusive).
+     */
+    get endValue(): bigint;
+    /**
+     * Get the count of values.
+     */
+    get count(): number;
+    /**
+     * Get the minimum value (inclusive).
+     */
+    get minimumValue(): bigint;
+    /**
+     * Get the maximum value (inclusive).
+     */
+    get maximumValue(): bigint;
+    /**
+     * Iterable implementation.
+     *
+     * @yields
+     * Next value in sequence.
+     */
+    [Symbol.iterator](): Generator<bigint>;
+}
+//# sourceMappingURL=sequence.d.ts.map

package/dist/sequence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sequence.d.ts","sourceRoot":"","sources":["../src/sequence.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,qBAAa,QAAS,YAAW,QAAQ,CAAC,MAAM,CAAC;;IA+B7C;;;;;;;;;OASG;gBACS,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE,KAAK,EAAE,MAAM;IAgBtD;;OAEG;IACH,IAAI,UAAU,IAAI,MAAM,CAEvB;IAED;;OAEG;IACH,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED;;OAEG;IACH,IAAI,KAAK,IAAI,MAAM,CAElB;IAED;;OAEG;IACH,IAAI,YAAY,IAAI,MAAM,CAEzB;IAED;;OAEG;IACH,IAAI,YAAY,IAAI,MAAM,CAEzB;IAED;;;;;OAKG;IACD,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,SAAS,CAAC,MAAM,CAAC;CAK3C"}

package/dist/sequence.js

@@ -0,0 +1,96 @@
+/**
+ * Sequence. Defines an ascending or descending sequence of big integers implemented as an iterable.
+ */
+export class Sequence {
+    /**
+     * Start value (inclusive).
+     */
+    #startValue;
+    /**
+     * End value (exclusive).
+     */
+    #endValue;
+    /**
+     * Count of values.
+     */
+    #count;
+    /**
+     * Delta to the next value; equal to the sign of the count.
+     */
+    #nextDelta;
+    /**
+     * Minimum value (inclusive).
+     */
+    #minimumValue;
+    /**
+     * Maximum value (inclusive).
+     */
+    #maximumValue;
+    /**
+     * Constructor.
+     *
+     * @param startValue
+     * Start value.
+     *
+     * @param count
+     * Count of values. If count is zero or positive, iteration ascends from start value, otherwise it descends from
+     * start value.
+     */
+    constructor(startValue, count) {
+        this.#startValue = BigInt(startValue);
+        this.#endValue = this.#startValue + BigInt(count);
+        this.#count = count;
+        if (count >= 0) {
+            this.#nextDelta = 1n;
+            this.#minimumValue = this.#startValue;
+            this.#maximumValue = this.#endValue - 1n;
+        }
+        else {
+            this.#nextDelta = -1n;
+            this.#minimumValue = this.#endValue + 1n;
+            this.#maximumValue = this.#startValue;
+        }
+    }
+    /**
+     * Get the start value (inclusive).
+     */
+    get startValue() {
+        return this.#startValue;
+    }
+    /**
+     * Get the end value (exclusive).
+     */
+    get endValue() {
+        return this.#endValue;
+    }
+    /**
+     * Get the count of values.
+     */
+    get count() {
+        return this.#count;
+    }
+    /**
+     * Get the minimum value (inclusive).
+     */
+    get minimumValue() {
+        return this.#minimumValue;
+    }
+    /**
+     * Get the maximum value (inclusive).
+     */
+    get maximumValue() {
+        return this.#maximumValue;
+    }
+    /**
+     * Iterable implementation.
+     *
+     * @yields
+     * Next value in sequence.
+     */
+    *[Symbol.iterator]() {
+        for (let value = this.#startValue; value !== this.#endValue; value += this.#nextDelta) {
+            yield value;
+        }
+    }
+}
+//# sourceMappingURL=sequence.js.map

package/dist/sequence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sequence.js","sourceRoot":"","sources":["../src/sequence.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,OAAO,QAAQ;IACjB;;OAEG;IACM,WAAW,CAAS;IAE7B;;OAEG;IACM,SAAS,CAAS;IAE3B;;OAEG;IACM,MAAM,CAAS;IAExB;;OAEG;IACM,UAAU,CAAW;IAE9B;;OAEG;IACM,aAAa,CAAS;IAE/B;;OAEG;IACM,aAAa,CAAS;IAE/B;;;;;;;;;OASG;IACH,YAAY,UAA2B,EAAE,KAAa;QAClD,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC;QACtC,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;QAClD,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;QAEpB,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;YACb,IAAI,CAAC,UAAU,GAAG,EAAE,CAAC;YACrB,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,WAAW,CAAC;YACtC,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,SAAS,GAAG,EAAE,CAAC;QAC7C,CAAC;aAAM,CAAC;YACJ,IAAI,CAAC,UAAU,GAAG,CAAC,EAAE,CAAC;YACtB,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,SAAS,GAAG,EAAE,CAAC;YACzC,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,WAAW,CAAC;QAC1C,CAAC;IACL,CAAC;IAED;;OAEG;IACH,IAAI,UAAU;QACV,OAAO,IAAI,CAAC,WAAW,CAAC;IAC5B,CAAC;IAED;;OAEG;IACH,IAAI,QAAQ;QACR,OAAO,IAAI,CAAC,SAAS,CAAC;IAC1B,CAAC;IAED;;OAEG;IACH,IAAI,KAAK;QACL,OAAO,IAAI,CAAC,MAAM,CAAC;IACvB,CAAC;IAED;;OAEG;IACH,IAAI,YAAY;QACZ,OAAO,IAAI,CAAC,aAAa,CAAC;IAC9B,CAAC;IAED;;OAEG;IACH,IAAI,YAAY;QACZ,OAAO,IAAI,CAAC,aAAa,CAAC;IAC9B,CAAC;IAED;;;;;OAKG;IACH,CAAE,CAAC,MAAM,CAAC,QAAQ,CAAC;QACf,KAAK,IAAI,KAAK,GAAG,IAAI,CAAC,WAAW,EAAE,KAAK,KAAK,IAAI,CAAC,SAAS,EAAE,KAAK,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACpF,MAAM,KAAK,CAAC;QAChB,CAAC;IACL,CAAC;CACJ"}

package/dist/string.d.ts

@@ -0,0 +1,25 @@
+/**
+ * String validation interface. To ensure signature compatibility in implementing classes, string validation is
+ * controlled by validation interfaces specific to each validator type.
+ */
+export interface StringValidation {
+}
+/**
+ * String validator interface.
+ *
+ * @template TStringValidation
+ * String validation type.
+ */
+export interface StringValidator<TStringValidation extends StringValidation = StringValidation> {
+    /**
+     * Validate a string and throw an error if validation fails.
+     *
+     * @param s
+     * String.
+     *
+     * @param validation
+     * String validation parameters.
+     */
+    validate: (s: string, validation?: TStringValidation) => void;
+}
+//# sourceMappingURL=string.d.ts.map

package/dist/string.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"string.d.ts","sourceRoot":"","sources":["../src/string.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,gBAAgB;CAChC;AAED;;;;;GAKG;AACH,MAAM,WAAW,eAAe,CAAC,iBAAiB,SAAS,gBAAgB,GAAG,gBAAgB;IAC1F;;;;;;;;OAQG;IACH,QAAQ,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,iBAAiB,KAAK,IAAI,CAAC;CACjE"}