@conform-to/dom 1.8.1 → 1.9.0

package/dist/future/index.d.ts

@@ -0,0 +1,5 @@
+export type { Serialize, FormValue, FormError, Submission, SubmissionResult, ValidationAttributes, } from '../types';
+export { DEFAULT_INTENT_NAME, getFormData, isDirty, parseSubmission, getPathSegments, formatPathSegments, appendPathSegment, getRelativePath, getValueAtPath, setValueAtPath, report, serialize, } from '../formdata';
+export { isPlainObject, deepEqual } from '../util';
+export { isFieldElement, isGlobalInstance, updateField, createFileList, createSubmitEvent, createGlobalFormsObserver, focus, change, blur, getFormAction, getFormEncType, getFormMethod, requestSubmit, requestIntent, } from '../dom';
+//# sourceMappingURL=index.d.ts.map

package/dist/future/index.js

@@ -0,0 +1,38 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var formdata = require('../formdata.js');
+var util = require('../util.js');
+var dom = require('../dom.js');
+
+
+
+exports.DEFAULT_INTENT_NAME = formdata.DEFAULT_INTENT_NAME;
+exports.appendPathSegment = formdata.appendPathSegment;
+exports.formatPathSegments = formdata.formatPathSegments;
+exports.getFormData = formdata.getFormData;
+exports.getPathSegments = formdata.getPathSegments;
+exports.getRelativePath = formdata.getRelativePath;
+exports.getValueAtPath = formdata.getValueAtPath;
+exports.isDirty = formdata.isDirty;
+exports.parseSubmission = formdata.parseSubmission;
+exports.report = formdata.report;
+exports.serialize = formdata.serialize;
+exports.setValueAtPath = formdata.setValueAtPath;
+exports.deepEqual = util.deepEqual;
+exports.isPlainObject = util.isPlainObject;
+exports.blur = dom.blur;
+exports.change = dom.change;
+exports.createFileList = dom.createFileList;
+exports.createGlobalFormsObserver = dom.createGlobalFormsObserver;
+exports.createSubmitEvent = dom.createSubmitEvent;
+exports.focus = dom.focus;
+exports.getFormAction = dom.getFormAction;
+exports.getFormEncType = dom.getFormEncType;
+exports.getFormMethod = dom.getFormMethod;
+exports.isFieldElement = dom.isFieldElement;
+exports.isGlobalInstance = dom.isGlobalInstance;
+exports.requestIntent = dom.requestIntent;
+exports.requestSubmit = dom.requestSubmit;
+exports.updateField = dom.updateField;

package/dist/future/index.mjs

@@ -0,0 +1,3 @@
+export { DEFAULT_INTENT_NAME, appendPathSegment, formatPathSegments, getFormData, getPathSegments, getRelativePath, getValueAtPath, isDirty, parseSubmission, report, serialize, setValueAtPath } from '../formdata.mjs';
+export { deepEqual, isPlainObject } from '../util.mjs';
+export { blur, change, createFileList, createGlobalFormsObserver, createSubmitEvent, focus, getFormAction, getFormEncType, getFormMethod, isFieldElement, isGlobalInstance, requestIntent, requestSubmit, updateField } from '../dom.mjs';

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 export { type Combine, type Constraint, type ControlButtonProps, type FormId, type FieldName, type DefaultValue, type FormValue, type FormOptions, type FormState, type FormContext, type SubscriptionSubject, type SubscriptionScope, createFormContext as unstable_createFormContext, } from './form';
-export { type FieldElement, isFieldElement, updateField as unstable_updateField, createFileList, createGlobalFormsObserver as unstable_createGlobalFormsObserver, focus as unstable_focus, change as unstable_change, blur as unstable_blur, } from './dom';
+export { type FieldElement, isFieldElement, isGlobalInstance, updateField as unstable_updateField, createFileList, } from './dom';
 export { type Submission, type SubmissionResult, type Intent, INTENT, STATE, serializeIntent, parse, } from './submission';
-export { getFormData, getPaths, formatPaths, isPrefix, isGlobalInstance, deepEqual as unstable_deepEqual, isDirty as unstable_isDirty, } from './formdata';
+export { getFormData, getPathSegments as getPaths, formatPathSegments as formatPaths, isPrefix, } from './formdata';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -12,19 +12,13 @@ var formdata = require('./formdata.js');
 exports.unstable_createFormContext = form.createFormContext;
 exports.createFileList = dom.createFileList;
 exports.isFieldElement = dom.isFieldElement;
-exports.unstable_blur = dom.blur;
-exports.unstable_change = dom.change;
-exports.unstable_createGlobalFormsObserver = dom.createGlobalFormsObserver;
-exports.unstable_focus = dom.focus;
+exports.isGlobalInstance = dom.isGlobalInstance;
 exports.unstable_updateField = dom.updateField;
 exports.INTENT = submission.INTENT;
 exports.STATE = submission.STATE;
 exports.parse = submission.parse;
 exports.serializeIntent = submission.serializeIntent;
-exports.formatPaths = formdata.formatPaths;
+exports.formatPaths = formdata.formatPathSegments;
 exports.getFormData = formdata.getFormData;
-exports.getPaths = formdata.getPaths;
-exports.isGlobalInstance = formdata.isGlobalInstance;
+exports.getPaths = formdata.getPathSegments;
 exports.isPrefix = formdata.isPrefix;
-exports.unstable_deepEqual = formdata.deepEqual;
-exports.unstable_isDirty = formdata.isDirty;

package/dist/index.mjs

@@ -1,4 +1,4 @@
 export { createFormContext as unstable_createFormContext } from './form.mjs';
-export { createFileList, isFieldElement, blur as unstable_blur, change as unstable_change, createGlobalFormsObserver as unstable_createGlobalFormsObserver, focus as unstable_focus, updateField as unstable_updateField } from './dom.mjs';
+export { createFileList, isFieldElement, isGlobalInstance, updateField as unstable_updateField } from './dom.mjs';
 export { INTENT, STATE, parse, serializeIntent } from './submission.mjs';
-export { formatPaths, getFormData, getPaths, isGlobalInstance, isPrefix, deepEqual as unstable_deepEqual, isDirty as unstable_isDirty } from './formdata.mjs';
+export { formatPathSegments as formatPaths, getFormData, getPathSegments as getPaths, isPrefix } from './formdata.mjs';

package/dist/submission.d.ts

@@ -136,4 +136,17 @@ export declare const root: unique symbol;
 export declare function setState(state: Record<string, unknown>, name: string, valueFn: (value: unknown) => unknown): void;
 export declare function setListState(state: Record<string, unknown>, intent: InsertIntent | RemoveIntent | ReorderIntent, getDefaultValue?: (defaultValue: any) => any): void;
 export declare function serialize<Schema>(defaultValue: Schema): FormValue<Schema>;
+/**
+ * Normalize value by removing empty object or array, empty string and null values
+ */
+export declare function normalize<Type extends Record<string, unknown>>(value: Type, acceptFile?: boolean): Type | undefined;
+export declare function normalize<Type extends Array<unknown>>(value: Type, acceptFile?: boolean): Type | undefined;
+export declare function normalize(value: unknown, acceptFile?: boolean): unknown | undefined;
+/**
+ * Flatten a tree into a dictionary
+ */
+export declare function flatten(data: unknown, options?: {
+    resolve?: (data: unknown) => unknown;
+    prefix?: string;
+}): Record<string, unknown>;
 //# sourceMappingURL=submission.d.ts.map

package/dist/submission.js

@@ -3,6 +3,7 @@
 Object.defineProperty(exports, '__esModule', { value: true });
 
 var _rollupPluginBabelHelpers = require('./_virtual/_rollupPluginBabelHelpers.js');
+var dom = require('./dom.js');
 var formdata = require('./formdata.js');
 var util = require('./util.js');
 
@@ -32,7 +33,7 @@ function getSubmissionContext(body) {
       return 1; // continue
     }
     context.fields.add(name);
-    formdata.setValue(context.payload, name, prev => {
+    formdata.setValueAtPath(context.payload, name, prev => {
       if (!prev) {
         return next;
       } else if (Array.isArray(prev)) {
@@ -40,6 +41,8 @@ function getSubmissionContext(body) {
       } else {
         return [prev, next];
       }
+    }, {
+      silent: true
     });
   };
   for (var [name, next] of body.entries()) {
@@ -54,11 +57,11 @@ function parse(payload, options) {
     switch (intent.type) {
       case 'update':
         {
-          var name = formdata.formatName(intent.payload.name, intent.payload.index);
+          var name = formdata.appendPathSegment(intent.payload.name, intent.payload.index);
           var _value = intent.payload.value;
           if (typeof intent.payload.value !== 'undefined') {
             if (name) {
-              formdata.setValue(context.payload, name, () => _value);
+              formdata.setValueAtPath(context.payload, name, () => _value);
             } else {
               context.payload = _value;
             }
@@ -67,9 +70,9 @@ function parse(payload, options) {
         }
       case 'reset':
         {
-          var _name = formdata.formatName(intent.payload.name, intent.payload.index);
+          var _name = formdata.appendPathSegment(intent.payload.name, intent.payload.index);
           if (_name) {
-            formdata.setValue(context.payload, _name, () => undefined);
+            formdata.setValueAtPath(context.payload, _name, () => undefined);
           } else {
             context.payload = {};
           }
@@ -124,17 +127,17 @@ function replySubmission(context) {
   }
   if ('hideFields' in options && options.hideFields) {
     for (var name of options.hideFields) {
-      var _value2 = formdata.getValue(context.payload, name);
+      var _value2 = formdata.getValueAtPath(context.payload, name);
       if (typeof _value2 !== 'undefined') {
-        formdata.setValue(context.payload, name, () => undefined);
+        formdata.setValueAtPath(context.payload, name, () => undefined);
       }
     }
   }
-  var extraError = 'formErrors' in options || 'fieldErrors' in options ? formdata.normalize(_rollupPluginBabelHelpers.objectSpread2({
+  var extraError = 'formErrors' in options || 'fieldErrors' in options ? normalize(_rollupPluginBabelHelpers.objectSpread2({
     '': (_options$formErrors = options.formErrors) !== null && _options$formErrors !== void 0 ? _options$formErrors : null
   }, options.fieldErrors)) : null;
   var error = context.error || extraError ? _rollupPluginBabelHelpers.objectSpread2(_rollupPluginBabelHelpers.objectSpread2({}, context.error), extraError) : undefined;
-  var initialValue = (_ref = formdata.normalize(context.payload,
+  var initialValue = (_ref = normalize(context.payload,
   // We can't serialize the file and send it back from the server, but we can preserve it in the client
   typeof document !== 'undefined'
   // We need the file on the client because it's treated as the form value
@@ -198,7 +201,7 @@ function updateList(list, intent) {
   }
 }
 function setListValue(data, intent) {
-  formdata.setValue(data, intent.payload.name, value => {
+  formdata.setValueAtPath(data, intent.payload.name, value => {
     var list = value !== null && value !== void 0 ? value : [];
     updateList(list, intent);
     return list;
@@ -216,7 +219,7 @@ function setState(state, name, valueFn) {
   var _loop2 = function _loop2() {
     var value = state[_key];
     if (formdata.isPrefix(_key, name) && _key !== name) {
-      formdata.setValue(target, _key, currentValue => {
+      formdata.setValueAtPath(target, _key, currentValue => {
         if (typeof currentValue === 'undefined') {
           return value;
         }
@@ -236,10 +239,10 @@ function setState(state, name, valueFn) {
   for (var _key of keys) {
     _loop2();
   }
-  var result = valueFn(formdata.getValue(target, name));
-  Object.assign(state, formdata.flatten(result, {
+  var result = valueFn(formdata.getValueAtPath(target, name));
+  Object.assign(state, flatten(result, {
     resolve(data) {
-      if (formdata.isPlainObject(data) || Array.isArray(data)) {
+      if (util.isPlainObject(data) || Array.isArray(data)) {
         var _data$root;
         // @ts-expect-error
         return (_data$root = data[root]) !== null && _data$root !== void 0 ? _data$root : null;
@@ -269,7 +272,7 @@ function setListState(state, intent, getDefaultValue) {
   });
 }
 function serialize(defaultValue) {
-  if (formdata.isPlainObject(defaultValue)) {
+  if (util.isPlainObject(defaultValue)) {
     // @ts-expect-error FIXME
     return Object.entries(defaultValue).reduce((result, _ref2) => {
       var [key, value] = _ref2;
@@ -294,11 +297,74 @@ function serialize(defaultValue) {
   }
 }
 
+/**
+ * Normalize value by removing empty object or array, empty string and null values
+ */
+
+function normalize(value) {
+  var acceptFile = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : true;
+  if (util.isPlainObject(value)) {
+    var obj = Object.keys(value).sort().reduce((result, key) => {
+      var data = normalize(value[key], acceptFile);
+      if (typeof data !== 'undefined') {
+        result[key] = data;
+      }
+      return result;
+    }, {});
+    if (Object.keys(obj).length === 0) {
+      return;
+    }
+    return obj;
+  }
+  if (Array.isArray(value)) {
+    if (value.length === 0) {
+      return undefined;
+    }
+    return value.map(item => normalize(item, acceptFile));
+  }
+  if (typeof value === 'string' && value === '' || value === null || dom.isGlobalInstance(value, 'File') && (!acceptFile || value.size === 0)) {
+    return;
+  }
+  return value;
+}
+
+/**
+ * Flatten a tree into a dictionary
+ */
+function flatten(data) {
+  var _options$resolve;
+  var options = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};
+  var result = {};
+  var resolve = (_options$resolve = options.resolve) !== null && _options$resolve !== void 0 ? _options$resolve : data => data;
+  function process(data, prefix) {
+    var value = normalize(resolve(data));
+    if (typeof value !== 'undefined') {
+      result[prefix] = value;
+    }
+    if (Array.isArray(data)) {
+      for (var i = 0; i < data.length; i++) {
+        process(data[i], "".concat(prefix, "[").concat(i, "]"));
+      }
+    } else if (util.isPlainObject(data)) {
+      for (var [_key2, _value3] of Object.entries(data)) {
+        process(_value3, prefix ? "".concat(prefix, ".").concat(_key2) : _key2);
+      }
+    }
+  }
+  if (data) {
+    var _options$prefix;
+    process(data, (_options$prefix = options.prefix) !== null && _options$prefix !== void 0 ? _options$prefix : '');
+  }
+  return result;
+}
+
 exports.INTENT = INTENT;
 exports.STATE = STATE;
 exports.createSubmission = createSubmission;
+exports.flatten = flatten;
 exports.getIntent = getIntent;
 exports.getSubmissionContext = getSubmissionContext;
+exports.normalize = normalize;
 exports.parse = parse;
 exports.replySubmission = replySubmission;
 exports.root = root;

package/dist/submission.mjs

@@ -1,6 +1,7 @@
 import { objectSpread2 as _objectSpread2 } from './_virtual/_rollupPluginBabelHelpers.mjs';
-import { formatName, setValue, isPlainObject, getValue, normalize, flatten, isPrefix } from './formdata.mjs';
-import { invariant } from './util.mjs';
+import { isGlobalInstance } from './dom.mjs';
+import { appendPathSegment, setValueAtPath, getValueAtPath, isPrefix } from './formdata.mjs';
+import { isPlainObject, invariant } from './util.mjs';
 
 /**
  * The name to be used when submitting a form control
@@ -28,7 +29,7 @@ function getSubmissionContext(body) {
       return 1; // continue
     }
     context.fields.add(name);
-    setValue(context.payload, name, prev => {
+    setValueAtPath(context.payload, name, prev => {
       if (!prev) {
         return next;
       } else if (Array.isArray(prev)) {
@@ -36,6 +37,8 @@ function getSubmissionContext(body) {
       } else {
         return [prev, next];
       }
+    }, {
+      silent: true
     });
   };
   for (var [name, next] of body.entries()) {
@@ -50,11 +53,11 @@ function parse(payload, options) {
     switch (intent.type) {
       case 'update':
         {
-          var name = formatName(intent.payload.name, intent.payload.index);
+          var name = appendPathSegment(intent.payload.name, intent.payload.index);
           var _value = intent.payload.value;
           if (typeof intent.payload.value !== 'undefined') {
             if (name) {
-              setValue(context.payload, name, () => _value);
+              setValueAtPath(context.payload, name, () => _value);
             } else {
               context.payload = _value;
             }
@@ -63,9 +66,9 @@ function parse(payload, options) {
         }
       case 'reset':
         {
-          var _name = formatName(intent.payload.name, intent.payload.index);
+          var _name = appendPathSegment(intent.payload.name, intent.payload.index);
           if (_name) {
-            setValue(context.payload, _name, () => undefined);
+            setValueAtPath(context.payload, _name, () => undefined);
           } else {
             context.payload = {};
           }
@@ -120,9 +123,9 @@ function replySubmission(context) {
   }
   if ('hideFields' in options && options.hideFields) {
     for (var name of options.hideFields) {
-      var _value2 = getValue(context.payload, name);
+      var _value2 = getValueAtPath(context.payload, name);
       if (typeof _value2 !== 'undefined') {
-        setValue(context.payload, name, () => undefined);
+        setValueAtPath(context.payload, name, () => undefined);
       }
     }
   }
@@ -194,7 +197,7 @@ function updateList(list, intent) {
   }
 }
 function setListValue(data, intent) {
-  setValue(data, intent.payload.name, value => {
+  setValueAtPath(data, intent.payload.name, value => {
     var list = value !== null && value !== void 0 ? value : [];
     updateList(list, intent);
     return list;
@@ -212,7 +215,7 @@ function setState(state, name, valueFn) {
   var _loop2 = function _loop2() {
     var value = state[_key];
     if (isPrefix(_key, name) && _key !== name) {
-      setValue(target, _key, currentValue => {
+      setValueAtPath(target, _key, currentValue => {
         if (typeof currentValue === 'undefined') {
           return value;
         }
@@ -232,7 +235,7 @@ function setState(state, name, valueFn) {
   for (var _key of keys) {
     _loop2();
   }
-  var result = valueFn(getValue(target, name));
+  var result = valueFn(getValueAtPath(target, name));
   Object.assign(state, flatten(result, {
     resolve(data) {
       if (isPlainObject(data) || Array.isArray(data)) {
@@ -290,4 +293,65 @@ function serialize(defaultValue) {
   }
 }
 
-export { INTENT, STATE, createSubmission, getIntent, getSubmissionContext, parse, replySubmission, root, serialize, serializeIntent, setListState, setListValue, setState, updateList };
+/**
+ * Normalize value by removing empty object or array, empty string and null values
+ */
+
+function normalize(value) {
+  var acceptFile = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : true;
+  if (isPlainObject(value)) {
+    var obj = Object.keys(value).sort().reduce((result, key) => {
+      var data = normalize(value[key], acceptFile);
+      if (typeof data !== 'undefined') {
+        result[key] = data;
+      }
+      return result;
+    }, {});
+    if (Object.keys(obj).length === 0) {
+      return;
+    }
+    return obj;
+  }
+  if (Array.isArray(value)) {
+    if (value.length === 0) {
+      return undefined;
+    }
+    return value.map(item => normalize(item, acceptFile));
+  }
+  if (typeof value === 'string' && value === '' || value === null || isGlobalInstance(value, 'File') && (!acceptFile || value.size === 0)) {
+    return;
+  }
+  return value;
+}
+
+/**
+ * Flatten a tree into a dictionary
+ */
+function flatten(data) {
+  var _options$resolve;
+  var options = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};
+  var result = {};
+  var resolve = (_options$resolve = options.resolve) !== null && _options$resolve !== void 0 ? _options$resolve : data => data;
+  function process(data, prefix) {
+    var value = normalize(resolve(data));
+    if (typeof value !== 'undefined') {
+      result[prefix] = value;
+    }
+    if (Array.isArray(data)) {
+      for (var i = 0; i < data.length; i++) {
+        process(data[i], "".concat(prefix, "[").concat(i, "]"));
+      }
+    } else if (isPlainObject(data)) {
+      for (var [_key2, _value3] of Object.entries(data)) {
+        process(_value3, prefix ? "".concat(prefix, ".").concat(_key2) : _key2);
+      }
+    }
+  }
+  if (data) {
+    var _options$prefix;
+    process(data, (_options$prefix = options.prefix) !== null && _options$prefix !== void 0 ? _options$prefix : '');
+  }
+  return result;
+}
+
+export { INTENT, STATE, createSubmission, flatten, getIntent, getSubmissionContext, normalize, parse, replySubmission, root, serialize, serializeIntent, setListState, setListValue, setState, updateList };

package/dist/types.d.ts

@@ -0,0 +1,99 @@
+/**
+ * Valid JSON primitive types.
+ */
+export type JsonPrimitive = string | number | boolean | null;
+/**
+ * The form value of a submission. This is usually constructed from a FormData or URLSearchParams.
+ * It may contains JSON primitives if the value is updated based on a form intent.
+ */
+export type FormValue<Type extends JsonPrimitive | FormDataEntryValue = JsonPrimitive | FormDataEntryValue> = Type | FormValue<Type | null>[] | {
+    [key: string]: FormValue<Type>;
+};
+/**
+ * Form error object that contains both form errors and field errors.
+ */
+export type FormError<ErrorShape = string> = {
+    /**
+     * The error of the form.
+     */
+    formErrors: ErrorShape[];
+    /**
+     * The field errors based on the field name.
+     */
+    fieldErrors: Record<string, ErrorShape[]>;
+};
+/**
+ * Structured data parsed from a form submission.
+ */
+export type Submission<ValueType extends JsonPrimitive | FormDataEntryValue = JsonPrimitive | FormDataEntryValue> = {
+    /**
+     * The submitted values mapped by field name.
+     * Supports nested names like `user.email` or indexed names like `items[0].id`.
+     */
+    payload: Record<string, FormValue<ValueType>>;
+    /**
+     * The list of field names present in the FormData or URLSearchParams.
+     */
+    fields: string[];
+    /**
+     * The submission intent, usually set by the name/value of the button that triggered the submission.
+     */
+    intent: string | null;
+};
+/**
+ * The result of a submission.
+ */
+export type SubmissionResult<ErrorShape = string, ValueType extends JsonPrimitive | FormDataEntryValue = JsonPrimitive | FormDataEntryValue> = {
+    /**
+     * The original submission data.
+     */
+    submission: Submission<ValueType>;
+    /**
+     * The intended value of the submission. Defined only when the intended value is different from the submitted value.
+     */
+    intendedValue?: Record<string, FormValue<ValueType>> | null;
+    /**
+     * Validation errors for `intendedValue` when present, otherwise for the original payload.
+     */
+    error?: FormError<ErrorShape> | null;
+};
+/**
+ * The input attributes with related to the Constraint Validation API
+ * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Constraint_validation
+ */
+export type ValidationAttributes = {
+    required?: boolean;
+    minLength?: number;
+    maxLength?: number;
+    min?: string | number;
+    max?: string | number;
+    step?: string | number;
+    multiple?: boolean;
+    pattern?: string;
+};
+/**
+ * A type helper that makes sure the FormError type is serializable.
+ * Used only to strip `File` type from the Form Shape at the moment.
+ */
+export type Serializable<T> = T extends File ? undefined : T extends Array<infer U> ? Serializable<U>[] : T extends object ? {
+    [K in keyof T]: Serializable<T[K]>;
+} : T;
+/**
+ * Converts an arbitrary value into a {@link SerializedValue}.
+ *
+ * This function is used to prepare field values for submission,
+ * ensuring they are compatible with the browser's `FormData` API.
+ *
+ * @param value - The original value to serialize.
+ * @returns A `SerializedValue` if the input can be represented in `FormData`,
+ *          or `undefined` if it cannot be serialized.
+ */
+export type Serialize = (value: unknown) => SerializedValue | undefined;
+/**
+ * A value that can be serialized into `FormData`.
+ *
+ * - `string` and `File` are supported natively by `FormData`.
+ * - Arrays allow representing multi-value fields.
+ */
+export type SerializedValue = string | string[] | File | File[];
+//# sourceMappingURL=types.d.ts.map

package/dist/util.d.ts

@@ -1,4 +1,15 @@
+import type { FormValue } from './types';
 export declare function invariant(expectedCondition: boolean, message: string): asserts expectedCondition;
 export declare function generateId(): string;
 export declare function clone<Data>(data: Data): Data;
+/**
+ * Check if the value is a plain object
+ */
+export declare function isPlainObject(obj: unknown): obj is Record<string | number | symbol, unknown>;
+/**
+ * A utility function that performs a deep equality check between two values.
+ * It handles plain objects, arrays, and primitive values only.
+ */
+export declare function deepEqual(left: unknown, right: unknown): boolean;
+export declare function stripFiles<Type extends string | number | boolean | File | null>(value: Record<string, FormValue<Type>>): Record<string, FormValue<Exclude<Type, File>>>;
 //# sourceMappingURL=util.d.ts.map

package/dist/util.js

@@ -14,6 +14,73 @@ function clone(data) {
   return JSON.parse(JSON.stringify(data));
 }
 
+/**
+ * Check if the value is a plain object
+ */
+function isPlainObject(obj) {
+  return !!obj && obj.constructor === Object && Object.getPrototypeOf(obj) === Object.prototype;
+}
+
+/**
+ * A utility function that performs a deep equality check between two values.
+ * It handles plain objects, arrays, and primitive values only.
+ */
+function deepEqual(left, right) {
+  if (Object.is(left, right)) {
+    return true;
+  }
+  if (left == null || right == null) {
+    return false;
+  }
+
+  // Compare plain objects
+  if (isPlainObject(left) && isPlainObject(right)) {
+    var prevKeys = Object.keys(left);
+    var nextKeys = Object.keys(right);
+    if (prevKeys.length !== nextKeys.length) {
+      return false;
+    }
+    for (var key of prevKeys) {
+      if (!Object.prototype.hasOwnProperty.call(right, key) || !deepEqual(left[key], right[key])) {
+        return false;
+      }
+    }
+    return true;
+  }
+
+  // Compare arrays
+  if (Array.isArray(left) && Array.isArray(right)) {
+    if (left.length !== right.length) {
+      return false;
+    }
+    for (var i = 0; i < left.length; i++) {
+      if (!deepEqual(left[i], right[i])) {
+        return false;
+      }
+    }
+    return true;
+  }
+  return false;
+}
+
+/*
+ * Removes File object from the FormValue.
+ * Used to avoid serialzing/sending File object back to the client.
+ */
+function stripFiles(value) {
+  var json = JSON.stringify(value, (_, value) => {
+    // If the current value is a File, return undefined to omit it
+    if (typeof File !== 'undefined' && value instanceof File) {
+      return undefined;
+    }
+    return value;
+  });
+  return JSON.parse(json);
+}
+
 exports.clone = clone;
+exports.deepEqual = deepEqual;
 exports.generateId = generateId;
 exports.invariant = invariant;
+exports.isPlainObject = isPlainObject;
+exports.stripFiles = stripFiles;