bytekit 0.1.12

package/dist/utils/helpers/FormUtils.js

@@ -0,0 +1,378 @@
+/**
+ * Form validation and management utilities
+ * Framework-agnostic form handling with built-in validators
+ */
+/**
+ * Built-in validators
+ */
+export const Validators = {
+    required: (value, message = "This field is required") => {
+        if (value === null || value === undefined || value === "") {
+            return message;
+        }
+        if (Array.isArray(value) && value.length === 0) {
+            return message;
+        }
+        return true;
+    },
+    minLength: (value, min, message) => {
+        if (typeof value !== "string")
+            return true;
+        if (value.length < min) {
+            return message || `Minimum length is ${min}`;
+        }
+        return true;
+    },
+    maxLength: (value, max, message) => {
+        if (typeof value !== "string")
+            return true;
+        if (value.length > max) {
+            return message || `Maximum length is ${max}`;
+        }
+        return true;
+    },
+    min: (value, min, message) => {
+        if (typeof value !== "number")
+            return true;
+        if (value < min) {
+            return message || `Minimum value is ${min}`;
+        }
+        return true;
+    },
+    max: (value, max, message) => {
+        if (typeof value !== "number")
+            return true;
+        if (value > max) {
+            return message || `Maximum value is ${max}`;
+        }
+        return true;
+    },
+    email: (value, message = "Invalid email address") => {
+        if (typeof value !== "string" || !value)
+            return true;
+        const emailRegex = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
+        return emailRegex.test(value) ? true : message;
+    },
+    url: (value, message = "Invalid URL") => {
+        if (typeof value !== "string" || !value)
+            return true;
+        try {
+            new URL(value);
+            return true;
+        }
+        catch {
+            return message;
+        }
+    },
+    pattern: (value, pattern, message) => {
+        if (typeof value !== "string" || !value)
+            return true;
+        return pattern.test(value) ? true : message || "Invalid format";
+    },
+    match: (value, other, message = "Fields do not match") => {
+        return value === other ? true : message;
+    },
+};
+/**
+ * Form validation and state management
+ */
+export class FormUtils {
+    state;
+    rules;
+    config;
+    validationTimeouts = new Map();
+    constructor(config) {
+        this.config = config;
+        this.rules = config.rules ?? {};
+        this.state = {
+            values: { ...config.initialValues },
+            errors: {},
+            touched: {},
+            dirty: {},
+            isValidating: false,
+            isValid: true,
+        };
+    }
+    /**
+     * Get current form state
+     */
+    getState() {
+        return { ...this.state };
+    }
+    /**
+     * Get field value
+     */
+    getValue(field) {
+        return this.state.values[field];
+    }
+    /**
+     * Set field value
+     */
+    setValue(field, value) {
+        this.state.values[field] = value;
+        this.state.dirty[field] = true;
+        if (this.config.validateOnChange) {
+            this.validateField(field);
+        }
+    }
+    /**
+     * Set multiple values
+     */
+    setValues(values) {
+        this.state.values = { ...this.state.values, ...values };
+        Object.keys(values).forEach((field) => {
+            this.state.dirty[field] = true;
+        });
+        if (this.config.validateOnChange) {
+            Object.keys(values).forEach((field) => {
+                this.validateField(field);
+            });
+        }
+    }
+    /**
+     * Mark field as touched
+     */
+    touchField(field) {
+        this.state.touched[field] = true;
+        if (this.config.validateOnBlur) {
+            this.validateField(field);
+        }
+    }
+    /**
+     * Reset form to initial state
+     */
+    reset() {
+        this.state = {
+            values: { ...this.config.initialValues },
+            errors: {},
+            touched: {},
+            dirty: {},
+            isValidating: false,
+            isValid: true,
+        };
+        this.validationTimeouts.forEach((timeout) => clearTimeout(timeout));
+        this.validationTimeouts.clear();
+    }
+    /**
+     * Validate single field
+     */
+    async validateField(field) {
+        const rule = this.rules[field];
+        if (!rule)
+            return null;
+        const value = this.state.values[field];
+        const errors = [];
+        // Required validation
+        if (rule.required) {
+            const result = Validators.required(value, typeof rule.required === "string" ? rule.required : undefined);
+            if (result !== true) {
+                errors.push(result);
+            }
+        }
+        // String validations
+        if (typeof value === "string") {
+            if (rule.minLength !== undefined) {
+                const result = Validators.minLength(value, typeof rule.minLength === "number"
+                    ? rule.minLength
+                    : parseInt(rule.minLength), typeof rule.minLength === "string"
+                    ? rule.minLength
+                    : undefined);
+                if (result !== true)
+                    errors.push(result);
+            }
+            if (rule.maxLength !== undefined) {
+                const result = Validators.maxLength(value, typeof rule.maxLength === "number"
+                    ? rule.maxLength
+                    : parseInt(rule.maxLength), typeof rule.maxLength === "string"
+                    ? rule.maxLength
+                    : undefined);
+                if (result !== true)
+                    errors.push(result);
+            }
+            if (rule.email) {
+                const result = Validators.email(value, typeof rule.email === "string" ? rule.email : undefined);
+                if (result !== true)
+                    errors.push(result);
+            }
+            if (rule.url) {
+                const result = Validators.url(value, typeof rule.url === "string" ? rule.url : undefined);
+                if (result !== true)
+                    errors.push(result);
+            }
+            if (rule.pattern) {
+                const pattern = typeof rule.pattern === "string"
+                    ? new RegExp(rule.pattern)
+                    : rule.pattern;
+                const result = Validators.pattern(value, pattern);
+                if (result !== true)
+                    errors.push(result);
+            }
+        }
+        // Number validations
+        if (typeof value === "number") {
+            if (rule.min !== undefined) {
+                const result = Validators.min(value, typeof rule.min === "number"
+                    ? rule.min
+                    : parseInt(rule.min), typeof rule.min === "string" ? rule.min : undefined);
+                if (result !== true)
+                    errors.push(result);
+            }
+            if (rule.max !== undefined) {
+                const result = Validators.max(value, typeof rule.max === "number"
+                    ? rule.max
+                    : parseInt(rule.max), typeof rule.max === "string" ? rule.max : undefined);
+                if (result !== true)
+                    errors.push(result);
+            }
+        }
+        // Custom validators
+        if (rule.custom) {
+            const validators = Array.isArray(rule.custom)
+                ? rule.custom
+                : [rule.custom];
+            for (const validator of validators) {
+                const result = validator(value);
+                if (result !== true) {
+                    errors.push(result);
+                }
+            }
+        }
+        // Async custom validators
+        if (rule.asyncCustom) {
+            const asyncValidators = Array.isArray(rule.asyncCustom)
+                ? rule.asyncCustom
+                : [rule.asyncCustom];
+            for (const validator of asyncValidators) {
+                const result = await validator(value);
+                if (result !== true) {
+                    errors.push(result);
+                }
+            }
+        }
+        const error = errors[0] || null;
+        this.state.errors[field] = error || "";
+        return error;
+    }
+    /**
+     * Validate all fields
+     */
+    async validate() {
+        this.state.isValidating = true;
+        const fieldErrors = [];
+        for (const field of Object.keys(this.rules)) {
+            const error = await this.validateField(field);
+            if (error) {
+                fieldErrors.push({
+                    field: field,
+                    message: error,
+                });
+            }
+        }
+        this.state.isValid = fieldErrors.length === 0;
+        this.state.isValidating = false;
+        if (fieldErrors.length > 0 && this.config.onError) {
+            this.config.onError(fieldErrors);
+        }
+        return fieldErrors;
+    }
+    /**
+     * Submit form
+     */
+    async submit() {
+        const errors = await this.validate();
+        if (errors.length === 0 && this.config.onSubmit) {
+            try {
+                await this.config.onSubmit(this.state.values);
+                return true;
+            }
+            catch (error) {
+                return false;
+            }
+        }
+        return errors.length === 0;
+    }
+    /**
+     * Get field error
+     */
+    getFieldError(field) {
+        return this.state.errors[field] || "";
+    }
+    /**
+     * Check if field has error
+     */
+    hasError(field) {
+        return !!this.state.errors[field];
+    }
+    /**
+     * Check if field is touched
+     */
+    isTouched(field) {
+        return !!this.state.touched[field];
+    }
+    /**
+     * Check if field is dirty
+     */
+    isDirty(field) {
+        return !!this.state.dirty[field];
+    }
+    /**
+     * Get all errors
+     */
+    getErrors() {
+        return { ...this.state.errors };
+    }
+    /**
+     * Clear field error
+     */
+    clearFieldError(field) {
+        this.state.errors[field] = "";
+    }
+    /**
+     * Clear all errors
+     */
+    clearErrors() {
+        this.state.errors = {};
+    }
+    /**
+     * Serialize form data
+     */
+    serialize() {
+        return { ...this.state.values };
+    }
+    /**
+     * Deserialize form data
+     */
+    deserialize(data) {
+        this.setValues(data);
+    }
+    /**
+     * Create form binding for framework integration
+     */
+    createBinding(field) {
+        return {
+            value: this.getValue(field),
+            onChange: (value) => this.setValue(field, value),
+            onBlur: () => this.touchField(field),
+            error: this.getFieldError(field),
+            touched: this.isTouched(field),
+            dirty: this.isDirty(field),
+        };
+    }
+    /**
+     * Create form bindings for all fields
+     */
+    createBindings() {
+        const bindings = {};
+        for (const field of Object.keys(this.state.values)) {
+            bindings[field] = this.createBinding(field);
+        }
+        return bindings;
+    }
+}
+/**
+ * Factory function for creating forms
+ */
+export function createForm(config) {
+    return new FormUtils(config);
+}
+//# sourceMappingURL=FormUtils.js.map

package/dist/utils/helpers/FormUtils.js.map

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

package/dist/utils/helpers/ObjectUtils.d.ts

@@ -0,0 +1,102 @@
+/**
+ * Object manipulation utilities for everyday development tasks
+ */
+export declare class ObjectUtils {
+    /**
+     * Check if value is empty (null, undefined, empty string, empty array, empty object)
+     */
+    static isEmpty(value: unknown): boolean;
+    /**
+     * Check if value is NOT empty
+     */
+    static isNotEmpty(value: unknown): boolean;
+    /**
+     * Deep clone an object
+     */
+    static deepClone<T>(obj: T): T;
+    /**
+     * Shallow merge objects (right overwrites left)
+     */
+    static merge<T extends Record<string, unknown>>(...objects: Partial<T>[]): T;
+    /**
+     * Deep merge objects (recursive)
+     */
+    static deepMerge(...objects: Array<Record<string, unknown>>): Record<string, unknown>;
+    /**
+     * Pick specific keys from object
+     */
+    static pick<T extends Record<string, unknown>, K extends keyof T>(obj: T, keys: K[]): Partial<T>;
+    /**
+     * Omit specific keys from object
+     */
+    static omit<T extends Record<string, unknown>, K extends keyof T>(obj: T, keys: K[]): Partial<T>;
+    /**
+     * Get nested value using dot notation
+     */
+    static get<T = unknown>(obj: Record<string, unknown>, path: string, defaultValue?: T): T;
+    /**
+     * Set nested value using dot notation
+     */
+    static set(obj: Record<string, unknown>, path: string, value: unknown): Record<string, unknown>;
+    /**
+     * Flatten nested object
+     */
+    static flatten(obj: Record<string, unknown>, prefix?: string): Record<string, unknown>;
+    /**
+     * Unflatten object (reverse of flatten)
+     */
+    static unflatten(obj: Record<string, unknown>): Record<string, unknown>;
+    /**
+     * Filter object by predicate
+     */
+    static filter<T extends Record<string, unknown>>(obj: T, predicate: (key: string, value: unknown) => boolean): Partial<T>;
+    /**
+     * Map object values
+     */
+    static mapValues<T extends Record<string, unknown>, R>(obj: T, mapper: (value: unknown, key: string) => R): Record<string, R>;
+    /**
+     * Check if object has all keys
+     */
+    static hasKeys<T extends Record<string, unknown>>(obj: T, keys: (keyof T)[]): boolean;
+    /**
+     * Check if object has any of the keys
+     */
+    static hasAnyKey<T extends Record<string, unknown>>(obj: T, keys: (keyof T)[]): boolean;
+    /**
+     * Invert object keys and values
+     */
+    static invert<T extends Record<string, string | number>>(obj: T): Record<string | number, string>;
+    /**
+     * Group array of objects by key
+     */
+    static groupBy<T extends Record<string, unknown>>(arr: T[], key: keyof T): Record<string, T[]>;
+    /**
+     * Index array of objects by key
+     */
+    static indexBy<T extends Record<string, unknown>>(arr: T[], key: keyof T): Record<string, T>;
+    /**
+     * Check if two objects are deeply equal
+     */
+    static deepEqual(a: unknown, b: unknown): boolean;
+    /**
+     * Get object size (number of keys)
+     */
+    static size(obj: Record<string, unknown>): number;
+    /**
+     * Convert object to array of [key, value] pairs
+     */
+    static entries<T extends Record<string, unknown>>(obj: T): Array<[string, unknown]>;
+    /**
+     * Convert array of [key, value] pairs to object
+     */
+    static fromEntries(entries: Array<[string, unknown]>): Record<string, unknown>;
+    /**
+     * Assign properties from source to target (like Object.assign)
+     */
+    static assign<T extends Record<string, unknown>>(target: T, ...sources: Partial<T>[]): T;
+    /**
+     * Create object from keys with same value
+     */
+    static fromKeys<T extends string | number>(keys: T[], value: unknown): Record<T, unknown>;
+}
+//# sourceMappingURL=ObjectUtils.d.ts.map

package/dist/utils/helpers/ObjectUtils.d.ts.map

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