@gnist/design-system 0.1.0

package/dist/utilities/validation/validation.cjs

@@ -0,0 +1,121 @@
+"use client";
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const index = require("../../translations/index.cjs");
+const regex = require("./regex.cjs");
+function getValidationMessage(result, messagePrefix, lang) {
+  if (!result) {
+    return "";
+  }
+  const firstError = result.errorMessages[0];
+  return [messagePrefix, firstError].map((message) => typeof message === "string" ? message : message(lang)).filter((x) => !!x).join(" ");
+}
+function stripWhitespace(value) {
+  return value.replace(regex.WHITE_SPACE, "");
+}
+function defaultPreValidation(value) {
+  if (typeof value === "string") {
+    return value.trim();
+  }
+  return value;
+}
+const defaultConfig = () => ({
+  steps: [],
+  preValidation: defaultPreValidation,
+  messagePrefix: "",
+  necessity: { isRequired: false }
+});
+const validation = (config) => ({
+  ...defaultConfig(),
+  ...config
+});
+function runValidation(rawValue, allValues, { necessity, preValidation, steps, showMessageImmediately }) {
+  const necessityConfig = typeof necessity === "function" ? necessity(allValues) : necessity;
+  const isRequired = necessityConfig.isRequired ?? false;
+  const value = preValidation(rawValue);
+  const valueIsMissing = value === void 0 || value === null || typeof value === "string" && value === "" || typeof value === "object" && Array.isArray(value) && !value.length;
+  if (valueIsMissing) {
+    return {
+      isValid: !isRequired,
+      value,
+      errorMessages: necessityConfig.isRequired ? [
+        necessityConfig.missingMessage ?? index.translate((t) => t.validation.defaultRequiredError)
+      ] : [],
+      showMessageImmediately: false
+    };
+  }
+  const validations = steps.map((f) => f(value, allValues));
+  return {
+    isValid: validations.every((x) => x.isValid),
+    value,
+    errorMessages: validations.filter((x) => !x.isValid).map((x) => x.errorMessage),
+    showMessageImmediately: (showMessageImmediately == null ? void 0 : showMessageImmediately(value)) ?? false
+  };
+}
+const required = (validator = validation(), message) => ({
+  ...validator,
+  necessity: {
+    isRequired: true,
+    missingMessage: message
+  }
+});
+const createObjectValidator = (validators) => (values) => {
+  const results = Object.fromEntries(Object.keys(values).map((key) => {
+    const typedKey = key;
+    return [
+      typedKey,
+      runValidation(values[typedKey], values, validators[typedKey])
+    ];
+  }));
+  const entries = Object.entries(results);
+  const isValid = entries.every(([, x]) => x.isValid);
+  return {
+    isValid,
+    transformed: Object.fromEntries(entries.map(([key, validation2]) => [key, validation2.value])),
+    validated: Object.fromEntries(entries.filter(([, validation2]) => validation2.isValid).map(([key, validation2]) => [key, validation2.value])),
+    validation: results
+  };
+};
+function initialUserInput(obj, validator) {
+  const validated = validator(obj);
+  return {
+    raw: obj,
+    showError: {},
+    ...validated
+  };
+}
+function getFieldNecessities(values, validators) {
+  const fieldNecessities = new Set(Object.keys(validators).map((x) => {
+    const necessity = validators[x].necessity;
+    const necessityConfig = typeof necessity === "function" ? necessity(values) : necessity;
+    return necessityConfig.isRequired ? "required" : "optional";
+  }));
+  return fieldNecessities.size === 1 ? Array.from(fieldNecessities)[0] : "mixed";
+}
+function addNecessityIndicator(values, validators, showNecessityOn, lang, helperText, field) {
+  if (!field) {
+    return helperText;
+  }
+  const allSameNecessity = getFieldNecessities(values, validators) !== "mixed";
+  if (allSameNecessity) {
+    return helperText;
+  }
+  const validation2 = validators[field];
+  const necessityConfig = typeof validation2.necessity === "function" ? validation2.necessity(values) : validation2.necessity;
+  if (showNecessityOn === "optional" && !necessityConfig.isRequired) {
+    return [index.translations[lang].validation.optional, helperText].filter((x) => !!x).join(". ");
+  }
+  if (showNecessityOn === "required" && necessityConfig.isRequired) {
+    return [index.translations[lang].validation.required, helperText].filter((x) => !!x).join(". ");
+  }
+  return helperText;
+}
+exports.addNecessityIndicator = addNecessityIndicator;
+exports.createObjectValidator = createObjectValidator;
+exports.getFieldNecessities = getFieldNecessities;
+exports.getValidationMessage = getValidationMessage;
+exports.initialUserInput = initialUserInput;
+exports.required = required;
+exports.runValidation = runValidation;
+exports.stripWhitespace = stripWhitespace;
+exports.validation = validation;

package/dist/utilities/validation/validation.d.ts

@@ -0,0 +1,185 @@
+import { Language } from "../../translations/types.js";
+/**
+ * Result of a validation.
+ */
+export interface ValidationResult<T> {
+    /**
+     * Status of the validation. True if all validators passed, false otherwise.
+     */
+    isValid: boolean;
+    /**
+     * Individual validation step's messages, e.g. "Cannot exceed 20 characters" or "Must contain at least one capital letter"
+     */
+    errorMessages: ValidationMessage[];
+    /**
+     * Whether validation should be shown immediately, instead of waiting for the user to leave the form field
+     */
+    showMessageImmediately: boolean;
+    /**
+     * The value that was validated, after transformation according to the validator's `preValidation` function.
+     */
+    value: T;
+}
+/**
+ * Get the validation message, if any, for a given {@link ValidationResult}.
+ * Combines the field's message prefix and the message from the first failed validation step.
+ *
+ * @param result The {@link ValidationResult} for a form field
+ * @param messagePrefix The validation message prefix for a form field
+ * @returns A validation message (empty string if no errors)
+ */
+export declare function getValidationMessage(result: ValidationResult<unknown> | undefined, messagePrefix: ValidationMessage, lang: Language): string;
+/**
+ * Result of a validation step
+ */
+export interface ValidationStepResult {
+    isValid: boolean;
+    errorMessage: ValidationMessage;
+}
+/**
+ * Validation step function
+ */
+export type ValidationStep<T, TAll> = (value: T, allValues: TAll) => ValidationStepResult;
+export type ValidationMessage = string | ((lang: Language) => string);
+export interface NecessityConfig {
+    isRequired: boolean;
+    missingMessage?: ValidationMessage;
+}
+/**
+ * Configuration object for a validation pipeline
+ */
+export interface ValidatorConfig<T, TAll> {
+    /**
+     * A list of validation steps which are run from left to right
+     */
+    steps: ValidationStep<T, TAll>[];
+    /**
+     * A function that transforms the value before validation. If not supplied, the default is value.trim() for string values.
+     */
+    preValidation: (value: T) => T;
+    /**
+     * A function which, if it returns true, shows the error message immediately instead of waiting for user to move on to the next field.
+     */
+    showMessageImmediately?: (value: T) => boolean;
+    /**
+     * Validation message prefix, e.g. "Invalid name."
+     */
+    messagePrefix: ValidationMessage;
+    /**
+     * Necessity of the field (required or optional)
+     */
+    necessity: NecessityConfig | ((values: TAll) => NecessityConfig);
+}
+export declare function stripWhitespace(value: string): string;
+/**
+ * Create a complete validation config using supplied partial config and the default config.
+ * @param config Configuration for the validation pipeline. Is merged with default config.
+ * @returns A {@link ValidatorConfig} that can be run using runValidation on input values
+ *
+ * @example
+ export const validateRegNo = validation({
+    steps: [hasLength(REG_NO_FULL_LENGTH), matchesRegex(REG_NO_PATTERN)],
+    preValidation: stripWhitespace,
+});
+ */
+export declare const validation: <T, TAll>(config?: Partial<ValidatorConfig<T, TAll>>) => ValidatorConfig<T, TAll>;
+export declare function runValidation<T, TAll>(rawValue: T, allValues: TAll, { necessity, preValidation, steps, showMessageImmediately, }: ValidatorConfig<T, TAll>): ValidationResult<T>;
+/**
+ * Modifies a validator to make the field required.
+ *
+ * @param validator A {@link ValidatorConfig} describing a validation
+ * @param message Validation message when the value is missing
+ * @returns The modified validator config
+ */
+export declare const required: <T, TAll>(validator?: ValidatorConfig<T, TAll>, message?: ValidationMessage) => ValidatorConfig<T, TAll>;
+/**
+ * Validator map. Each property is a validator for the corresponding property in the input object.
+ */
+export type ValidatorMap<T> = {
+    [K in keyof T]: ValidatorConfig<T[K], T>;
+};
+/**
+ * Validation data object. Each property contains validation results for the corresponding property in the input object.
+ */
+export type ValidationData<T> = {
+    [K in keyof T]: ValidationResult<T[K]>;
+};
+/**
+ * Object validation options
+ */
+export interface ObjectValidationOptions {
+    /**
+     * Whether to show necessity indicator on required or optional form fields. By default, indicator will
+     * be shown on the least used type of filed. E.g. if there are more required fields than optional,
+     * indicator will be shown on optional fields.
+     *
+     * If all properties have the same necessity, the indicator will not be shown regardless of this setting.
+     */
+    showNecessityOn: "required" | "optional";
+}
+/**
+ * Result of object validation.
+ */
+export type ObjectValidationResult<T> = {
+    /**
+     * Overall validity of the object. True if all properties are valid.
+     */
+    isValid: boolean;
+    /**
+     * Validation data for all properties
+     */
+    validation: ValidationData<T>;
+    /**
+     * Transformed properties (e.g. without leading/trailing whitespace)
+     */
+    transformed?: T;
+    /**
+     * Valid, transformed properties (e.g. without leading/trailing whitespace)
+     */
+    validated: Partial<T>;
+} & ({
+    isValid: true;
+    validated: T;
+} | {
+    isValid: false;
+});
+/**
+ * Object validator function
+ */
+export type ObjectValidator<T> = (object: T) => ObjectValidationResult<T>;
+/**
+ * Create a validation function for an object, given a validation map for properties of that object
+ * @param validators A {@link ValidatorMap} to validate against
+ * @returns A validation function that can be run on input objects and returns a {@link ObjectValidationResult}
+ */
+export declare const createObjectValidator: <T extends object>(validators: ValidatorMap<T>) => ObjectValidator<T>;
+export type ShouldShowError<T> = {
+    [K in keyof T]?: boolean;
+};
+/**
+ * A representation of user input of multiple properties with validation
+ */
+export type UserInput<T> = {
+    /**
+     * The raw user input
+     */
+    raw: T;
+    /**
+     * Map of whether to show error message for a given field
+     */
+    showError: ShouldShowError<T>;
+} & ObjectValidationResult<T>;
+/**
+ * Create the initial {@link UserInput} representation given an object of user input
+ * @param obj The raw user input
+ * @returns Initial validation state, before running validation
+ */
+export declare function initialUserInput<T>(obj: T, validator: ObjectValidator<T>): UserInput<T>;
+/**
+ * Figure out if an object validator has only required fields, only optional fields, or a mix of both
+ * @param validators The {@link ValidatorMap} for an object
+ * @returns "required" if only required fields, "optional" if only optional fields, otherwise "mixed".
+ */
+export declare function getFieldNecessities<T>(values: T, validators: ValidatorMap<T>): "optional" | "required" | "mixed";
+export declare function addNecessityIndicator<T>(values: T, validators: ValidatorMap<T>, showNecessityOn: "required" | "optional", lang: Language, helperText?: string, field?: keyof T): string | undefined;
+//# sourceMappingURL=validation.d.ts.map

package/dist/utilities/validation/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../../src/utilities/validation/validation.ts"],"names":[],"mappings":"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"}

package/dist/utilities/validation/validation.js

@@ -0,0 +1,121 @@
+"use client";
+import { translate, translations } from "../../translations/index.js";
+import { WHITE_SPACE } from "./regex.js";
+function getValidationMessage(result, messagePrefix, lang) {
+  if (!result) {
+    return "";
+  }
+  const firstError = result.errorMessages[0];
+  return [messagePrefix, firstError].map((message) => typeof message === "string" ? message : message(lang)).filter((x) => !!x).join(" ");
+}
+function stripWhitespace(value) {
+  return value.replace(WHITE_SPACE, "");
+}
+function defaultPreValidation(value) {
+  if (typeof value === "string") {
+    return value.trim();
+  }
+  return value;
+}
+const defaultConfig = () => ({
+  steps: [],
+  preValidation: defaultPreValidation,
+  messagePrefix: "",
+  necessity: { isRequired: false }
+});
+const validation = (config) => ({
+  ...defaultConfig(),
+  ...config
+});
+function runValidation(rawValue, allValues, { necessity, preValidation, steps, showMessageImmediately }) {
+  const necessityConfig = typeof necessity === "function" ? necessity(allValues) : necessity;
+  const isRequired = necessityConfig.isRequired ?? false;
+  const value = preValidation(rawValue);
+  const valueIsMissing = value === void 0 || value === null || typeof value === "string" && value === "" || typeof value === "object" && Array.isArray(value) && !value.length;
+  if (valueIsMissing) {
+    return {
+      isValid: !isRequired,
+      value,
+      errorMessages: necessityConfig.isRequired ? [
+        necessityConfig.missingMessage ?? translate((t) => t.validation.defaultRequiredError)
+      ] : [],
+      showMessageImmediately: false
+    };
+  }
+  const validations = steps.map((f) => f(value, allValues));
+  return {
+    isValid: validations.every((x) => x.isValid),
+    value,
+    errorMessages: validations.filter((x) => !x.isValid).map((x) => x.errorMessage),
+    showMessageImmediately: (showMessageImmediately == null ? void 0 : showMessageImmediately(value)) ?? false
+  };
+}
+const required = (validator = validation(), message) => ({
+  ...validator,
+  necessity: {
+    isRequired: true,
+    missingMessage: message
+  }
+});
+const createObjectValidator = (validators) => (values) => {
+  const results = Object.fromEntries(Object.keys(values).map((key) => {
+    const typedKey = key;
+    return [
+      typedKey,
+      runValidation(values[typedKey], values, validators[typedKey])
+    ];
+  }));
+  const entries = Object.entries(results);
+  const isValid = entries.every(([, x]) => x.isValid);
+  return {
+    isValid,
+    transformed: Object.fromEntries(entries.map(([key, validation2]) => [key, validation2.value])),
+    validated: Object.fromEntries(entries.filter(([, validation2]) => validation2.isValid).map(([key, validation2]) => [key, validation2.value])),
+    validation: results
+  };
+};
+function initialUserInput(obj, validator) {
+  const validated = validator(obj);
+  return {
+    raw: obj,
+    showError: {},
+    ...validated
+  };
+}
+function getFieldNecessities(values, validators) {
+  const fieldNecessities = new Set(Object.keys(validators).map((x) => {
+    const necessity = validators[x].necessity;
+    const necessityConfig = typeof necessity === "function" ? necessity(values) : necessity;
+    return necessityConfig.isRequired ? "required" : "optional";
+  }));
+  return fieldNecessities.size === 1 ? Array.from(fieldNecessities)[0] : "mixed";
+}
+function addNecessityIndicator(values, validators, showNecessityOn, lang, helperText, field) {
+  if (!field) {
+    return helperText;
+  }
+  const allSameNecessity = getFieldNecessities(values, validators) !== "mixed";
+  if (allSameNecessity) {
+    return helperText;
+  }
+  const validation2 = validators[field];
+  const necessityConfig = typeof validation2.necessity === "function" ? validation2.necessity(values) : validation2.necessity;
+  if (showNecessityOn === "optional" && !necessityConfig.isRequired) {
+    return [translations[lang].validation.optional, helperText].filter((x) => !!x).join(". ");
+  }
+  if (showNecessityOn === "required" && necessityConfig.isRequired) {
+    return [translations[lang].validation.required, helperText].filter((x) => !!x).join(". ");
+  }
+  return helperText;
+}
+export {
+  addNecessityIndicator,
+  createObjectValidator,
+  getFieldNecessities,
+  getValidationMessage,
+  initialUserInput,
+  required,
+  runValidation,
+  stripWhitespace,
+  validation
+};

package/dist/utilities/validation/validationSteps.cjs

@@ -0,0 +1,19 @@
+"use client";
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const index = require("../../translations/index.cjs");
+const hasLength = (length, characterType = "characters") => (value) => ({
+  isValid: value.length === length,
+  errorMessage: index.translate((t) => t.validation.errors.invalidLength(length, t.validation[characterType]))
+});
+const maxLength = (length, characterType = "characters") => (value) => ({
+  isValid: value.length <= length,
+  errorMessage: index.translate((t) => t.validation.errors.invalidMaxLength(length, t.validation[characterType]))
+});
+const matchesRegex = (regex, errorMessage) => (value) => ({
+  isValid: regex.test(value),
+  errorMessage
+});
+exports.hasLength = hasLength;
+exports.matchesRegex = matchesRegex;
+exports.maxLength = maxLength;

package/dist/utilities/validation/validationSteps.d.ts

@@ -0,0 +1,5 @@
+import { ValidationMessage, ValidationStepResult } from "./validation.js";
+export declare const hasLength: (length: number, characterType?: "digits" | "characters") => (value: string) => ValidationStepResult;
+export declare const maxLength: (length: number, characterType?: "digits" | "characters") => (value: string) => ValidationStepResult;
+export declare const matchesRegex: (regex: RegExp, errorMessage: ValidationMessage) => (value: string) => ValidationStepResult;
+//# sourceMappingURL=validationSteps.d.ts.map

package/dist/utilities/validation/validationSteps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validationSteps.d.ts","sourceRoot":"","sources":["../../../src/utilities/validation/validationSteps.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAE1E,eAAO,MAAM,SAAS,WACT,MAAM,kBAAiB,QAAQ,GAAG,YAAY,aAC/C,MAAM,KAAG,oBAQf,CAAC;AAEP,eAAO,MAAM,SAAS,WACT,MAAM,kBAAiB,QAAQ,GAAG,YAAY,aAC/C,MAAM,KAAG,oBAQf,CAAC;AAEP,eAAO,MAAM,YAAY,UACb,MAAM,gBAAgB,iBAAiB,aACvC,MAAM,KAAG,oBAGf,CAAC"}

package/dist/utilities/validation/validationSteps.js

@@ -0,0 +1,19 @@
+"use client";
+import { translate } from "../../translations/index.js";
+const hasLength = (length, characterType = "characters") => (value) => ({
+  isValid: value.length === length,
+  errorMessage: translate((t) => t.validation.errors.invalidLength(length, t.validation[characterType]))
+});
+const maxLength = (length, characterType = "characters") => (value) => ({
+  isValid: value.length <= length,
+  errorMessage: translate((t) => t.validation.errors.invalidMaxLength(length, t.validation[characterType]))
+});
+const matchesRegex = (regex, errorMessage) => (value) => ({
+  isValid: regex.test(value),
+  errorMessage
+});
+export {
+  hasLength,
+  matchesRegex,
+  maxLength
+};

package/dist/utilities/validation/validators.cjs

@@ -0,0 +1,76 @@
+"use client";
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const index = require("../../translations/index.cjs");
+const regex = require("./regex.cjs");
+const validation = require("./validation.cjs");
+const validationSteps = require("./validationSteps.cjs");
+const texts = index.sliceTranslate((t) => t.validation.errors);
+const noValidation = () => validation.validation();
+const validAddress = validation.validation({
+  steps: [
+    validationSteps.matchesRegex(regex.VALID_ADDRESS, texts((t) => t.invalidCharacters))
+  ]
+});
+const validZipCode = validation.validation({
+  steps: [
+    validationSteps.matchesRegex(regex.VALID_DIGITS, texts((t) => t.onlyDigits)),
+    validationSteps.hasLength(4, "digits")
+  ],
+  showMessageImmediately: (x) => x.length > 4
+});
+const validEmail = validation.validation({
+  steps: [
+    validationSteps.matchesRegex(regex.VALID_EMAIL, texts((t) => t.invalidEmail))
+  ]
+});
+const validName = validation.validation({
+  steps: [
+    validationSteps.maxLength(50),
+    validationSteps.matchesRegex(regex.VALID_NAME, texts((t) => t.invalidNameRegex))
+  ],
+  showMessageImmediately: (x) => x.length > 50,
+  messagePrefix: texts((t) => t.invalidName)
+});
+const validCellPhoneNumber = validation.validation({
+  steps: [
+    validationSteps.matchesRegex(regex.VALID_FIRST_CELL_PHONE_DIGIT, texts((t) => t.invalidCellPhoneFirstDigit)),
+    validationSteps.matchesRegex(regex.VALID_DIGITS, texts((t) => t.onlyDigits)),
+    validationSteps.hasLength(8, "digits")
+  ],
+  preValidation: validation.stripWhitespace,
+  showMessageImmediately: (x) => x.length > 8 || !regex.VALID_FIRST_CELL_PHONE_DIGIT.test(x),
+  messagePrefix: texts((t) => t.invalidPhoneNumber)
+});
+const validRegistrationNumber = validation.validation({
+  steps: [
+    validationSteps.matchesRegex(regex.REG_NO_FULL_PATTERN, texts((t) => t.invalidRegistrationNumber))
+  ],
+  preValidation: (x) => validation.stripWhitespace(x).toUpperCase(),
+  showMessageImmediately: (x) => x.length > regex.REG_NO_FULL_LENGTH
+});
+const mustBeChecked = (message) => validation.validation({
+  steps: [
+    (isChecked) => ({
+      isValid: isChecked,
+      errorMessage: message
+    })
+  ]
+});
+const atLeastOneMustBeChecked = (message) => validation.validation({
+  steps: [
+    (selected) => ({
+      isValid: selected.length > 0,
+      errorMessage: message
+    })
+  ]
+});
+exports.atLeastOneMustBeChecked = atLeastOneMustBeChecked;
+exports.mustBeChecked = mustBeChecked;
+exports.noValidation = noValidation;
+exports.validAddress = validAddress;
+exports.validCellPhoneNumber = validCellPhoneNumber;
+exports.validEmail = validEmail;
+exports.validName = validName;
+exports.validRegistrationNumber = validRegistrationNumber;
+exports.validZipCode = validZipCode;

package/dist/utilities/validation/validators.d.ts

@@ -0,0 +1,10 @@
+export declare const noValidation: <T, TAll>() => import("./validation.js").ValidatorConfig<T, TAll>;
+export declare const validAddress: import("./validation.js").ValidatorConfig<string, unknown>;
+export declare const validZipCode: import("./validation.js").ValidatorConfig<string, unknown>;
+export declare const validEmail: import("./validation.js").ValidatorConfig<string, unknown>;
+export declare const validName: import("./validation.js").ValidatorConfig<string, unknown>;
+export declare const validCellPhoneNumber: import("./validation.js").ValidatorConfig<string, unknown>;
+export declare const validRegistrationNumber: import("./validation.js").ValidatorConfig<string, unknown>;
+export declare const mustBeChecked: <T>(message: string) => import("./validation.js").ValidatorConfig<boolean, T>;
+export declare const atLeastOneMustBeChecked: <T, TVal>(message: string) => import("./validation.js").ValidatorConfig<TVal[], T>;
+//# sourceMappingURL=validators.d.ts.map

package/dist/utilities/validation/validators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validators.d.ts","sourceRoot":"","sources":["../../../src/utilities/validation/validators.ts"],"names":[],"mappings":"AAeA,eAAO,MAAM,YAAY,GAAI,CAAC,EAAE,IAAI,yDAA4B,CAAC;AAEjE,eAAO,MAAM,YAAY,4DAOvB,CAAC;AAEH,eAAO,MAAM,YAAY,4DASvB,CAAC;AAEH,eAAO,MAAM,UAAU,4DAOrB,CAAC;AAEH,eAAO,MAAM,SAAS,4DAUpB,CAAC;AAEH,eAAO,MAAM,oBAAoB,4DAgB/B,CAAC;AAEH,eAAO,MAAM,uBAAuB,4DASlC,CAAC;AAEH,eAAO,MAAM,aAAa,GAAI,CAAC,WAAW,MAAM,0DAQ1C,CAAC;AAEP,eAAO,MAAM,uBAAuB,GAAI,CAAC,EAAE,IAAI,WAAW,MAAM,yDAQ1D,CAAC"}

package/dist/utilities/validation/validators.js

@@ -0,0 +1,76 @@
+"use client";
+import { sliceTranslate } from "../../translations/index.js";
+import { VALID_ADDRESS, VALID_DIGITS, VALID_EMAIL, VALID_NAME, VALID_FIRST_CELL_PHONE_DIGIT, REG_NO_FULL_PATTERN, REG_NO_FULL_LENGTH } from "./regex.js";
+import { validation, stripWhitespace } from "./validation.js";
+import { matchesRegex, hasLength, maxLength } from "./validationSteps.js";
+const texts = sliceTranslate((t) => t.validation.errors);
+const noValidation = () => validation();
+const validAddress = validation({
+  steps: [
+    matchesRegex(VALID_ADDRESS, texts((t) => t.invalidCharacters))
+  ]
+});
+const validZipCode = validation({
+  steps: [
+    matchesRegex(VALID_DIGITS, texts((t) => t.onlyDigits)),
+    hasLength(4, "digits")
+  ],
+  showMessageImmediately: (x) => x.length > 4
+});
+const validEmail = validation({
+  steps: [
+    matchesRegex(VALID_EMAIL, texts((t) => t.invalidEmail))
+  ]
+});
+const validName = validation({
+  steps: [
+    maxLength(50),
+    matchesRegex(VALID_NAME, texts((t) => t.invalidNameRegex))
+  ],
+  showMessageImmediately: (x) => x.length > 50,
+  messagePrefix: texts((t) => t.invalidName)
+});
+const validCellPhoneNumber = validation({
+  steps: [
+    matchesRegex(VALID_FIRST_CELL_PHONE_DIGIT, texts((t) => t.invalidCellPhoneFirstDigit)),
+    matchesRegex(VALID_DIGITS, texts((t) => t.onlyDigits)),
+    hasLength(8, "digits")
+  ],
+  preValidation: stripWhitespace,
+  showMessageImmediately: (x) => x.length > 8 || !VALID_FIRST_CELL_PHONE_DIGIT.test(x),
+  messagePrefix: texts((t) => t.invalidPhoneNumber)
+});
+const validRegistrationNumber = validation({
+  steps: [
+    matchesRegex(REG_NO_FULL_PATTERN, texts((t) => t.invalidRegistrationNumber))
+  ],
+  preValidation: (x) => stripWhitespace(x).toUpperCase(),
+  showMessageImmediately: (x) => x.length > REG_NO_FULL_LENGTH
+});
+const mustBeChecked = (message) => validation({
+  steps: [
+    (isChecked) => ({
+      isValid: isChecked,
+      errorMessage: message
+    })
+  ]
+});
+const atLeastOneMustBeChecked = (message) => validation({
+  steps: [
+    (selected) => ({
+      isValid: selected.length > 0,
+      errorMessage: message
+    })
+  ]
+});
+export {
+  atLeastOneMustBeChecked,
+  mustBeChecked,
+  noValidation,
+  validAddress,
+  validCellPhoneNumber,
+  validEmail,
+  validName,
+  validRegistrationNumber,
+  validZipCode
+};