@mapples/form 1.0.1

package/dist/state/index.js

@@ -0,0 +1,249 @@
+import { cloneDeep, get, set, groupBy, isEqual, some } from 'lodash';
+/**
+ * FormState manages the state of a form including values, validation, history, and subscriptions.
+ * It provides methods to get/set values, validate data, manage history for undo/redo functionality,
+ * and subscribe to value changes.
+ *
+ * @template T - The type of the form data object
+ * @public
+ */
+class FormState {
+    values;
+    validationSchema;
+    subscriptions = new Map();
+    formHistorySubscriptions = new Map();
+    errors = null;
+    history = [];
+    historyIndex = -1;
+    historyItems;
+    historyItemThrottle;
+    saveCounter = 0;
+    filterHistoryKeys;
+    /**
+     * Creates a new FormState instance.
+     *
+     * @param initialValues - The initial values for the form
+     * @param validationSchema - Optional Yup validation schema
+     * @param historyItems - Number of history items to keep for undo/redo (0 to disable)
+     * @param historyItemThrottle - Throttle for saving history items (every Nth change)
+     * @param filterHistoryKeys - Array of field paths to exclude from history tracking
+     */
+    constructor(initialValues, validationSchema, historyItems = 0, historyItemThrottle = 5, filterHistoryKeys = []) {
+        this.values = cloneDeep(initialValues);
+        this.validationSchema = validationSchema;
+        this.historyItems = historyItems;
+        this.historyItemThrottle = historyItemThrottle;
+        this.filterHistoryKeys = filterHistoryKeys;
+        if (this.historyItems > 0) {
+            this.history = [cloneDeep(initialValues)];
+            this.historyIndex = 0;
+        }
+    }
+    /**
+     * Gets a deep copy of all form values.
+     *
+     * @returns A deep copy of the current form values
+     */
+    getValues() {
+        return cloneDeep(this.values);
+    }
+    /**
+     * Sets validation errors for the form.
+     *
+     * @param errors - Validation errors organized by field path
+     */
+    setErrors(errors) {
+        this.errors = errors;
+    }
+    /**
+     * Gets the current validation errors.
+     *
+     * @returns Current validation errors or null if no errors
+     */
+    getErrors() {
+        return this.errors;
+    }
+    /**
+     * Sets all form values and triggers subscriptions.
+     *
+     * @param values - New values to set for the form
+     */
+    setValues(values) {
+        this.values = cloneDeep(values);
+        this.saveToHistory();
+        this.subscriptions.forEach((subscription) => {
+            subscription.cb(subscription.path
+                ? get(this.getValues(), subscription.path)
+                : this.getValues());
+        });
+    }
+    /**
+     * Sets a value at a specific path and triggers subscriptions.
+     *
+     * @template V - The type of value being set
+     * @param path - Dot notation path to the field (e.g., 'user.name')
+     * @param value - The value to set at the specified path
+     */
+    setValue(path, value) {
+        set(this.values, path, value);
+        if (!some(this.filterHistoryKeys, (value) => {
+            return path.includes(value);
+        })) {
+            this.saveToHistory();
+        }
+        this.subscriptions.forEach((subscription) => {
+            subscription.cb(subscription.path
+                ? get(this.getValues(), subscription.path)
+                : this.getValues());
+        });
+    }
+    /**
+     * Subscribes to form value changes.
+     *
+     * @template V - The type of value being subscribed to
+     * @param cb - Callback function to execute when values change
+     * @param path - Optional path to subscribe to a specific field
+     * @returns Unsubscribe function to remove the subscription
+     */
+    subscribeOnChange(cb, path) {
+        const id = this.generateListenerId();
+        this.subscriptions.set(id, {
+            cb: cb,
+            path,
+        });
+        return this.unsubscribeOnChange(id);
+    }
+    /**
+     * Subscribes to form history changes (undo/redo operations).
+     *
+     * @param cb - Callback function to execute when history changes
+     * @returns Unsubscribe function to remove the subscription
+     */
+    subscribeOnHistoryChange(cb) {
+        const id = this.generateListenerId();
+        this.formHistorySubscriptions.set(id, cb);
+        return this.unsubscribeOnHistoryChange(id);
+    }
+    /**
+     * Gets a value at a specific path or all values if no path is provided.
+     *
+     * @template V - The type of value to return
+     * @param path - Optional dot notation path to the field
+     * @returns The value at the specified path or all form values
+     */
+    getValue(path) {
+        return cloneDeep(path ? get(this.getValues(), path) : this.getValues());
+    }
+    /**
+     * Validates the form using the provided validation schema.
+     *
+     * @throws {Record<string, ValidationError[]>} Throws validation errors if validation fails
+     */
+    async validate() {
+        try {
+            await this.validationSchema?.validate(this.getValues(), {
+                abortEarly: false,
+            });
+        }
+        catch (error) {
+            const errors = this.remapValidationError(error);
+            this.setErrors(errors);
+            throw errors;
+        }
+    }
+    saveToHistory() {
+        if (this.historyItems === 0)
+            return;
+        this.saveCounter++;
+        if (this.saveCounter % this.historyItemThrottle !== 0)
+            return;
+        const currentValues = cloneDeep(this.values);
+        const diff = isEqual(this.history[this.history.length - 1], currentValues);
+        if (this.history.length > 0 && diff) {
+            return;
+        }
+        if (this.historyIndex < this.history.length - 1) {
+            this.history = this.history.slice(0, this.historyIndex + 1);
+        }
+        this.history.push(currentValues);
+        if (this.history.length > this.historyItems) {
+            this.history = this.history.slice(-this.historyItems);
+            this.historyIndex = this.history.length - 1;
+        }
+        else {
+            this.historyIndex = this.history.length - 1;
+        }
+    }
+    /**
+     * Moves to the previous state in the form history (undo operation).
+     *
+     * @returns True if the operation was successful, false if no previous state exists
+     */
+    prev() {
+        if (!this.canPrev())
+            return false;
+        this.historyIndex--;
+        this.values = cloneDeep(this.history[this.historyIndex]);
+        this.notifySubscriptions();
+        this.notifyHistorySubscriptions();
+        return true;
+    }
+    /**
+     * Moves to the next state in the form history (redo operation).
+     *
+     * @returns True if the operation was successful, false if no next state exists
+     */
+    next() {
+        if (!this.canNext())
+            return false;
+        this.historyIndex++;
+        this.values = cloneDeep(this.history[this.historyIndex]);
+        this.notifySubscriptions();
+        this.notifyHistorySubscriptions();
+        return true;
+    }
+    /**
+     * Checks if there is a previous state available for undo operation.
+     *
+     * @returns True if undo operation is possible
+     */
+    canPrev() {
+        return this.historyItems > 0 && this.historyIndex > 0;
+    }
+    /**
+     * Checks if there is a next state available for redo operation.
+     *
+     * @returns True if redo operation is possible
+     */
+    canNext() {
+        return this.historyItems > 0 && this.historyIndex < this.history.length - 1;
+    }
+    notifySubscriptions() {
+        this.subscriptions.forEach((subscription) => {
+            subscription.cb(subscription.path
+                ? get(this.getValues(), subscription.path)
+                : this.getValues());
+        });
+    }
+    notifyHistorySubscriptions() {
+        this.formHistorySubscriptions.forEach((callback) => {
+            callback();
+        });
+    }
+    remapValidationError(error) {
+        return groupBy(error.inner, 'path');
+    }
+    unsubscribeOnChange(id) {
+        return () => this.subscriptions.delete(id);
+    }
+    unsubscribeOnHistoryChange(id) {
+        return () => this.formHistorySubscriptions.delete(id);
+    }
+    generateListenerId() {
+        const date = new Date().getTime().toString(36);
+        const random = Math.random().toString(36).substring(2, 15);
+        return `${date}-${random}`;
+    }
+}
+export default FormState;
+//# sourceMappingURL=index.js.map

package/dist/state/index.js.map

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

package/dist/types/index.d.ts

@@ -0,0 +1,71 @@
+import { RefObject } from 'react';
+import { ObjectSchema, ValidationError } from 'yup';
+import FormState from '../state';
+/**
+ * Represents any possible value type that can be stored in a form field.
+ * @public
+ */
+export type AnyValue = string | number | object | boolean | null | symbol;
+/**
+ * Callback function type for form value subscriptions.
+ * @template T - The type of value being subscribed to
+ * @param value - The current value
+ * @public
+ */
+export type SubscriptionCallBack<T> = (value: T) => void;
+/**
+ * Configuration for subscribing to form value changes.
+ * @template T - The type of value being subscribed to
+ * @public
+ */
+export interface ValueSubscription<T = AnyValue> {
+    /** Optional path to a specific field. If not provided, subscribes to the entire form */
+    path?: string;
+    /** Callback function to execute when the value changes */
+    cb: SubscriptionCallBack<T>;
+}
+/**
+ * Context type that provides form state and methods to child components.
+ * @template T - The type of the form data object
+ * @public
+ */
+export interface FormContextType<T extends object> {
+    /** The form state instance containing all form data and methods */
+    form: FormState<T> | null;
+    /** Object tracking which fields have been touched by the user */
+    touched: Record<keyof T, boolean>;
+    /** Function to submit the form, triggering validation and onSubmit callback */
+    submitForm: () => void;
+    /** Boolean indicating if the form is currently being submitted */
+    submitting: boolean;
+    /** Validation errors organized by field path */
+    validationErrors: Record<string, ValidationError[]> | null;
+    /** Function to validate the form without submitting */
+    validate: () => void;
+    /** Function to mark a specific field as touched */
+    touch: (fieldName: string) => void;
+}
+/**
+ * Props for the Form component.
+ * @template T - The type of the form data object
+ * @public
+ */
+export interface FormProps<T extends object> {
+    /** Initial values for the form fields */
+    initialValues: T;
+    /** Optional Yup validation schema for form validation */
+    validationSchema?: ObjectSchema<T>;
+    /** Callback function called when the form is successfully submitted */
+    onSubmit?: (value: T) => void | Promise<void>;
+    /** Optional ref to access the FormState instance directly */
+    ref?: RefObject<FormState<T> | null>;
+    /** Number of history items to keep for undo/redo functionality (0 to disable) */
+    historyItems?: number;
+    /** Throttle for saving history items (every Nth change) */
+    historyItemThrottle?: number;
+    /** Array of field paths to exclude from history tracking */
+    filterHistoryKeys?: string[];
+    /** Callback function called whenever form values change */
+    onChange?: (value: T) => void;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAElC,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,KAAK,CAAC;AAEpD,OAAO,SAAS,MAAM,UAAU,CAAC;AAEjC;;;GAGG;AACH,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,MAAM,CAAC;AAE1E;;;;;GAKG;AACH,MAAM,MAAM,oBAAoB,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,CAAC;AAEzD;;;;GAIG;AACH,MAAM,WAAW,iBAAiB,CAAC,CAAC,GAAG,QAAQ;IAC7C,wFAAwF;IACxF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,0DAA0D;IAC1D,EAAE,EAAE,oBAAoB,CAAC,CAAC,CAAC,CAAC;CAC7B;AAED;;;;GAIG;AACH,MAAM,WAAW,eAAe,CAAC,CAAC,SAAS,MAAM;IAC/C,mEAAmE;IACnE,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAC1B,iEAAiE;IACjE,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,CAAC;IAClC,+EAA+E;IAC/E,UAAU,EAAE,MAAM,IAAI,CAAC;IACvB,kEAAkE;IAClE,UAAU,EAAE,OAAO,CAAC;IACpB,gDAAgD;IAChD,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,EAAE,CAAC,GAAG,IAAI,CAAC;IAC3D,uDAAuD;IACvD,QAAQ,EAAE,MAAM,IAAI,CAAC;IACrB,mDAAmD;IACnD,KAAK,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;CACpC;AAED;;;;GAIG;AACH,MAAM,WAAW,SAAS,CAAC,CAAC,SAAS,MAAM;IACzC,yCAAyC;IACzC,aAAa,EAAE,CAAC,CAAC;IACjB,yDAAyD;IACzD,gBAAgB,CAAC,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC;IACnC,uEAAuE;IACvE,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9C,6DAA6D;IAC7D,GAAG,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IACrC,iFAAiF;IACjF,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,2DAA2D;IAC3D,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,4DAA4D;IAC5D,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC7B,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,CAAC;CAC/B"}

package/dist/types/index.js

@@ -0,0 +1 @@
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":""}

package/dist/utils/index.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Compares two objects and returns the differences between them.
+ * This utility function performs a deep comparison and returns an object
+ * containing the differences between the two input objects.
+ *
+ * @template T - The type of objects being compared
+ * @param obj1 - First object to compare
+ * @param obj2 - Second object to compare
+ * @param excludeKeys - Array of keys to exclude from comparison (optional)
+ * @returns Object containing diff keys and values, empty object if no differences
+ *
+ * @example
+ * ```tsx
+ * const obj1 = { name: 'John', age: 30, city: 'NYC' };
+ * const obj2 = { name: 'Jane', age: 30, city: 'LA' };
+ * const diff = objectDiff(obj1, obj2, ['age']); // Excludes age from comparison
+ * // Result: { name: { _value: { from: 'John', to: 'Jane' } }, city: { _value: { from: 'NYC', to: 'LA' } } }
+ * ```
+ *
+ * @public
+ */
+export declare function objectDiff<T>(obj1: T, obj2: T, excludeKeys?: string[]): Record<string, any>;
+/**
+ * Checks if an object is empty (has no enumerable properties).
+ * This utility function determines whether an object has any own enumerable properties.
+ *
+ * @param obj - Object to check
+ * @returns True if object is empty (no enumerable properties), false otherwise
+ *
+ * @example
+ * ```tsx
+ * isEmpty({}); // true
+ * isEmpty({ name: 'John' }); // false
+ * isEmpty({ length: 0 }); // false (has enumerable property)
+ * ```
+ *
+ * @public
+ */
+export declare function isEmpty(obj: Record<string, any>): boolean;
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAC1B,IAAI,EAAE,CAAC,EACP,IAAI,EAAE,CAAC,EACP,WAAW,GAAE,MAAM,EAAO,GACzB,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAuErB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,CAEzD"}

package/dist/utils/index.js

@@ -0,0 +1,95 @@
+/**
+ * Compares two objects and returns the differences between them.
+ * This utility function performs a deep comparison and returns an object
+ * containing the differences between the two input objects.
+ *
+ * @template T - The type of objects being compared
+ * @param obj1 - First object to compare
+ * @param obj2 - Second object to compare
+ * @param excludeKeys - Array of keys to exclude from comparison (optional)
+ * @returns Object containing diff keys and values, empty object if no differences
+ *
+ * @example
+ * ```tsx
+ * const obj1 = { name: 'John', age: 30, city: 'NYC' };
+ * const obj2 = { name: 'Jane', age: 30, city: 'LA' };
+ * const diff = objectDiff(obj1, obj2, ['age']); // Excludes age from comparison
+ * // Result: { name: { _value: { from: 'John', to: 'Jane' } }, city: { _value: { from: 'NYC', to: 'LA' } } }
+ * ```
+ *
+ * @public
+ */
+export function objectDiff(obj1, obj2, excludeKeys = []) {
+    const diff = {};
+    // Handle primitive types and null/undefined
+    if (obj1 === obj2) {
+        return {}; // No difference
+    }
+    // Handle null/undefined cases
+    if (obj1 == null || obj2 == null) {
+        return { _value: { from: obj1, to: obj2 } }; // Different
+    }
+    // Handle different types
+    if (typeof obj1 !== typeof obj2) {
+        return { _value: { from: obj1, to: obj2 } }; // Different
+    }
+    // Handle arrays
+    if (Array.isArray(obj1) && Array.isArray(obj2)) {
+        if (obj1.length !== obj2.length) {
+            return { _value: { from: obj1, to: obj2 } }; // Different lengths
+        }
+        for (let i = 0; i < obj1.length; i++) {
+            const elementDiff = objectDiff(obj1[i], obj2[i]);
+            if (Object.keys(elementDiff).length > 0) {
+                diff[i.toString()] = elementDiff;
+            }
+        }
+        return diff;
+    }
+    // Handle objects
+    if (typeof obj1 === 'object' && typeof obj2 === 'object') {
+        const keys1 = Object.keys(obj1).filter((key) => !excludeKeys.includes(key));
+        const keys2 = Object.keys(obj2).filter((key) => !excludeKeys.includes(key));
+        // Check for keys in obj1 but not in obj2
+        for (const key of keys1) {
+            if (!keys2.includes(key)) {
+                diff[key] = { removed: obj1[key] };
+            }
+            else {
+                const valueDiff = objectDiff(obj1[key], obj2[key], excludeKeys);
+                if (Object.keys(valueDiff).length > 0) {
+                    diff[key] = valueDiff;
+                }
+            }
+        }
+        // Check for keys in obj2 but not in obj1
+        for (const key of keys2) {
+            if (!keys1.includes(key)) {
+                diff[key] = { added: obj2[key] };
+            }
+        }
+        return diff;
+    }
+    // For all other cases (primitives that are not equal)
+    return { _value: { from: obj1, to: obj2 } };
+}
+/**
+ * Checks if an object is empty (has no enumerable properties).
+ * This utility function determines whether an object has any own enumerable properties.
+ *
+ * @param obj - Object to check
+ * @returns True if object is empty (no enumerable properties), false otherwise
+ *
+ * @example
+ * ```tsx
+ * isEmpty({}); // true
+ * isEmpty({ name: 'John' }); // false
+ * isEmpty({ length: 0 }); // false (has enumerable property)
+ * ```
+ *
+ * @public
+ */
+export function isEmpty(obj) {
+    return Object.keys(obj).length === 0;
+}
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,UAAU,CACxB,IAAO,EACP,IAAO,EACP,cAAwB,EAAE;IAE1B,MAAM,IAAI,GAAwB,EAAE,CAAC;IAErC,4CAA4C;IAC5C,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;QAClB,OAAO,EAAE,CAAC,CAAC,gBAAgB;IAC7B,CAAC;IAED,8BAA8B;IAC9B,IAAI,IAAI,IAAI,IAAI,IAAI,IAAI,IAAI,IAAI,EAAE,CAAC;QACjC,OAAO,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC,YAAY;IAC3D,CAAC;IAED,yBAAyB;IACzB,IAAI,OAAO,IAAI,KAAK,OAAO,IAAI,EAAE,CAAC;QAChC,OAAO,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC,YAAY;IAC3D,CAAC;IAED,gBAAgB;IAChB,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QAC/C,IAAI,IAAI,CAAC,MAAM,KAAK,IAAI,CAAC,MAAM,EAAE,CAAC;YAChC,OAAO,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC,oBAAoB;QACnE,CAAC;QAED,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACrC,MAAM,WAAW,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;YACjD,IAAI,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACxC,IAAI,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,GAAG,WAAW,CAAC;YACnC,CAAC;QACH,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAED,iBAAiB;IACjB,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QACzD,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,IAAc,CAAC,CAAC,MAAM,CAC9C,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,WAAW,CAAC,QAAQ,CAAC,GAAG,CAAC,CACpC,CAAC;QACF,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,IAAc,CAAC,CAAC,MAAM,CAC9C,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,WAAW,CAAC,QAAQ,CAAC,GAAG,CAAC,CACpC,CAAC;QAEF,yCAAyC;QACzC,KAAK,MAAM,GAAG,IAAI,KAAK,EAAE,CAAC;YACxB,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;gBACzB,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,EAAG,IAAY,CAAC,GAAG,CAAC,EAAE,CAAC;YAC9C,CAAC;iBAAM,CAAC;gBACN,MAAM,SAAS,GAAG,UAAU,CACzB,IAAY,CAAC,GAAG,CAAC,EACjB,IAAY,CAAC,GAAG,CAAC,EAClB,WAAW,CACZ,CAAC;gBACF,IAAI,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBACtC,IAAI,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC;gBACxB,CAAC;YACH,CAAC;QACH,CAAC;QAED,yCAAyC;QACzC,KAAK,MAAM,GAAG,IAAI,KAAK,EAAE,CAAC;YACxB,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;gBACzB,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,EAAG,IAAY,CAAC,GAAG,CAAC,EAAE,CAAC;YAC5C,CAAC;QACH,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAED,sDAAsD;IACtD,OAAO,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,CAAC;AAC9C,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,OAAO,CAAC,GAAwB;IAC9C,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC;AACvC,CAAC"}

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@mapples/form",
+  "version": "1.0.1",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc --p tsconfig.build.json",
+    "lint": "eslint .",
+    "type-check": "tsc --noEmit",
+    "clean": "rm -rf dist"
+  },
+  "author": {
+    "name": "Oleksandr Soloviov",
+    "url": "https://mapples.org/people/olek_soloviov"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/mapplesorg/mapples-open-kit.git",
+    "directory": "packages/@mapples/form"
+  },
+  "dependencies": {
+    "lodash": "^4.17.21"
+  },
+  "peerDependencies": {
+    "react": ">=18.0.0 <20.0.0",
+    "react-native": ">=0.71.0",
+    "yup": "^1.6.0"
+  },
+  "devDependencies": {
+    "@types/lodash": "^4.17.0",
+    "@types/react": ">=18.0.0 <20.0.0",
+    "typescript": "~5.9.2"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "package.json"
+  ]
+}