@conform-to/dom 1.17.0 → 1.18.0

package/dist/form.mjs

@@ -1,5 +1,5 @@
 import { objectSpread2 as _objectSpread2 } from './_virtual/_rollupPluginBabelHelpers.mjs';
-import { appendPathSegment, getValueAtPath, isPrefix, setValueAtPath, getFormData, getPathSegments, getRelativePath, formatPathSegments } from './formdata.mjs';
+import { appendPath, getPathValue, isPathPrefix, setPathValue, getFormData, parsePath, getRelativePath, formatPath } from './formdata.mjs';
 import { getFormAction, getFormEncType, getFormMethod, isFieldElement, requestSubmit, isDirtyInput, updateField } from './dom.mjs';
 import { generateId, clone, isPlainObject, invariant } from './util.mjs';
 import { serialize, flatten, setListState, setListValue, setState, normalize, INTENT, serializeIntent, root, getSubmissionContext } from './submission.mjs';
@@ -39,7 +39,7 @@ function getDefaultKey(defaultValue, prefix) {
     var [key, value] = _ref2;
     if (Array.isArray(value)) {
       for (var i = 0; i < value.length; i++) {
-        result[appendPathSegment(key, i)] = generateId();
+        result[appendPath(key, i)] = generateId();
       }
     }
     return result;
@@ -72,7 +72,7 @@ function handleIntent(meta, intent, fields, initialized) {
           validated,
           value
         } = intent.payload;
-        var _name2 = appendPathSegment(intent.payload.name, intent.payload.index);
+        var _name2 = appendPath(intent.payload.name, intent.payload.index);
         if (typeof value !== 'undefined') {
           updateValue(meta, _name2 !== null && _name2 !== void 0 ? _name2 : '', value);
         }
@@ -101,8 +101,8 @@ function handleIntent(meta, intent, fields, initialized) {
       }
     case 'reset':
       {
-        var _name3 = appendPathSegment(intent.payload.name, intent.payload.index);
-        var _value = getValueAtPath(meta.defaultValue, _name3);
+        var _name3 = appendPath(intent.payload.name, intent.payload.index);
+        var _value = getPathValue(meta.defaultValue, _name3);
         updateValue(meta, _name3, _value);
         if (_name3) {
           setState(meta.validated, _name3, () => undefined);
@@ -137,7 +137,7 @@ function handleIntent(meta, intent, fields, initialized) {
   var validatedFields = (_fields$filter = fields === null || fields === void 0 ? void 0 : fields.filter(name => meta.validated[name])) !== null && _fields$filter !== void 0 ? _fields$filter : [];
   meta.error = Object.entries(meta.error).reduce((result, _ref3) => {
     var [name, error] = _ref3;
-    if (meta.validated[name] || validatedFields.some(field => isPrefix(name, field))) {
+    if (meta.validated[name] || validatedFields.some(field => isPathPrefix(name, field))) {
       result[name] = error;
     }
     return result;
@@ -155,8 +155,8 @@ function updateValue(meta, name, value) {
   meta.initialValue = clone(meta.initialValue);
   meta.value = clone(meta.value);
   meta.key = clone(meta.key);
-  setValueAtPath(meta.initialValue, name, () => value);
-  setValueAtPath(meta.value, name, () => value);
+  setPathValue(meta.initialValue, name, () => value);
+  setPathValue(meta.value, name, () => value);
   if (isPlainObject(value) || Array.isArray(value)) {
     setState(meta.key, name, () => undefined);
     Object.assign(meta.key, getDefaultKey(value, name));
@@ -181,11 +181,11 @@ function createValueProxy(value) {
     if (name === '') {
       return val;
     }
-    var path = getPathSegments(name);
-    var basename = formatPathSegments(path.slice(0, -1));
-    var key = formatPathSegments(path.slice(-1));
+    var path = parsePath(name);
+    var basename = formatPath(path.slice(0, -1));
+    var key = formatPath(path.slice(-1));
     var parentValue = proxy[basename];
-    return getValueAtPath(parentValue, key);
+    return getPathValue(parentValue, key);
   });
 }
 function createConstraintProxy(constraint) {
@@ -193,7 +193,7 @@ function createConstraintProxy(constraint) {
     var _result;
     var result = constraint[name];
     if (!result) {
-      var path = getPathSegments(name);
+      var path = parsePath(name);
       for (var i = path.length - 1; i >= 0; i--) {
         var segment = path[i];
 
@@ -206,7 +206,7 @@ function createConstraintProxy(constraint) {
           break;
         }
       }
-      var alternative = formatPathSegments(path);
+      var alternative = formatPath(path);
       if (name !== alternative) {
         result = proxy[alternative];
       }
@@ -217,11 +217,11 @@ function createConstraintProxy(constraint) {
 function createKeyProxy(key) {
   return createStateProxy((name, proxy) => {
     var currentKey = key[name];
-    var segments = getPathSegments(name);
+    var segments = parsePath(name);
     if (segments.length === 0) {
       return currentKey;
     }
-    var parentKey = proxy[formatPathSegments(segments.slice(0, -1))];
+    var parentKey = proxy[formatPath(segments.slice(0, -1))];
     if (typeof parentKey === 'undefined') {
       return currentKey;
     }
@@ -235,7 +235,7 @@ function createValidProxy(error) {
       return keys.length === 0;
     }
     for (var key of keys) {
-      if (isPrefix(key, name) && typeof error[key] !== 'undefined') {
+      if (isPathPrefix(key, name) && typeof error[key] !== 'undefined') {
         return false;
       }
     }
@@ -266,7 +266,7 @@ function shouldNotify(prev, next, cache, scope) {
     var names = (_scope$name = scope.name) !== null && _scope$name !== void 0 ? _scope$name : [];
     var list = prefixes.length === 0 ? names : Array.from(new Set([...Object.keys(prev), ...Object.keys(next)]));
     var _loop = function _loop(_name4) {
-        if (prefixes.length === 0 || names.includes(_name4) || prefixes.some(prefix => isPrefix(_name4, prefix))) {
+        if (prefixes.length === 0 || names.includes(_name4) || prefixes.some(prefix => isPathPrefix(_name4, prefix))) {
           var _cache$_name;
           (_cache$_name = cache[_name4]) !== null && _cache$_name !== void 0 ? _cache$_name : cache[_name4] = compareFn(prev[_name4], next[_name4]);
           if (cache[_name4]) {
@@ -576,13 +576,13 @@ function createFormContext(options) {
       switch (intent.type) {
         case 'update':
           {
-            var _name5 = appendPathSegment(intent.payload.name, intent.payload.index);
-            var baseSegments = getPathSegments(_name5);
+            var _name5 = appendPath(intent.payload.name, intent.payload.index);
+            var baseSegments = parsePath(_name5);
             for (var element of formElement.elements) {
               if (isFieldElement(element)) {
                 var paths = getRelativePath(element.name, baseSegments);
                 if (paths) {
-                  var value = getValueAtPath(intent.payload.value, paths);
+                  var value = getPathValue(intent.payload.value, paths);
                   var inputValue = typeof value === 'string' || Array.isArray(value) && value.every(item => typeof item === 'string') ? value : undefined;
                   if (typeof inputValue !== 'undefined' || _name5 === '' && paths.length > 1) {
                     updateField(element, {
@@ -599,10 +599,10 @@ function createFormContext(options) {
           }
         case 'reset':
           {
-            var prefix = appendPathSegment(intent.payload.name, intent.payload.index);
+            var prefix = appendPath(intent.payload.name, intent.payload.index);
             for (var _element of formElement.elements) {
-              if (isFieldElement(_element) && _element.name && isPrefix(_element.name, prefix)) {
-                var _value2 = getValueAtPath(meta.defaultValue, _element.name);
+              if (isFieldElement(_element) && _element.name && isPathPrefix(_element.name, prefix)) {
+                var _value2 = getPathValue(meta.defaultValue, _element.name);
                 var defaultValue = typeof _value2 === 'string' || Array.isArray(_value2) && _value2.every(item => typeof item === 'string') ? _value2 : undefined;
                 if (typeof defaultValue === 'undefined' && !_element.dataset.conform && 'defaultValue' in _element && !isDirtyInput(_element)) {
                   continue;

package/dist/formdata.d.ts

@@ -14,23 +14,23 @@ export declare function getFormData(form: HTMLFormElement, submitter?: HTMLEleme
  *
  * @example
  * ```js
- * getPathSegments("object.key");       // → ['object', 'key']
- * getPathSegments("array[0].content"); // → ['array', 0, 'content']
- * getPathSegments("todos[]");          // → ['todos', '']
+ * parsePath("object.key");       // → ['object', 'key']
+ * parsePath("array[0].content"); // → ['array', 0, 'content']
+ * parsePath("todos[]");          // → ['todos', '']
  * ```
  */
-export declare function getPathSegments(path: string | undefined): Array<string | number>;
+export declare function parsePath(path: string | undefined): Array<string | number>;
 /**
  * Returns a formatted name from the path segments based on the dot and bracket notation.
  *
  * @example
  * ```js
- * formatPathSegments(['object', 'key']); // → "object.key"
- * formatPathSegments(['array', 0, 'content']); // → "array[0].content"
- * formatPathSegments(['todos', '']); // → "todos[]"
+ * formatPath(['object', 'key']); // → "object.key"
+ * formatPath(['array', 0, 'content']); // → "array[0].content"
+ * formatPath(['todos', '']); // → "todos[]"
  * ```
  */
-export declare function formatPathSegments(segments: Readonly<Array<string | number>>): string;
+export declare function formatPath(segments: Readonly<Array<string | number>>): string;
 /**
  * Append one more segment onto an existing path string.
  *
@@ -39,26 +39,26 @@ export declare function formatPathSegments(segments: Readonly<Array<string | num
  * - segment = `number`     ⇒ bracket notation "[n]"
  * - segment = `string`     ⇒ dot-notation ".prop"
  */
-export declare function appendPathSegment(path: string | undefined, segment: string | number | undefined): string;
+export declare function appendPath(path: string | undefined, segment: string | number | undefined): string;
 /**
  * Returns true if `prefix` is a valid leading path of `name`.
  *
  * @example
  * ```js
- * isPrefix("foo.bar.baz", "foo.bar")        // → true
- * isPrefix("foo.bar[3].baz", "foo.bar[3]")  // → true
- * isPrefix("foo.bar[3].baz", "foo.bar")     // → true
- * isPrefix("foo.bar[3].baz", "foo.baz")     // → false
- * isPrefix("foo", "foo.bar")                // → false
+ * isPathPrefix("foo.bar.baz", "foo.bar")        // → true
+ * isPathPrefix("foo.bar[3].baz", "foo.bar[3]")  // → true
+ * isPathPrefix("foo.bar[3].baz", "foo.bar")     // → true
+ * isPathPrefix("foo.bar[3].baz", "foo.baz")     // → false
+ * isPathPrefix("foo", "foo.bar")                // → false
  * ```
  */
-export declare function isPrefix(name: string, prefix: string): boolean;
+export declare function isPathPrefix(name: string, prefix: string): boolean;
 /**
- * Return the segments of `fullPathStr` that come after the `baseSegments` prefix.
+ * Return the segments of `fullPath` that come after the `basePath` prefix.
  *
- * @param fullPathStr     Full path as a dot/bracket string
- * @param basePath    Base path, already parsed into segments
- * @returns               The “tail” segments, or `null` if `fullPathStr` isn’t nested under `baseSegments`
+ * @param fullPath     Full path as a dot/bracket string or array of segments
+ * @param basePath     Base path as a dot/bracket string or array of segments
+ * @returns               The “tail” segments, or `null` if `fullPath` isn’t nested under `basePath`
  *
  * @example
  * ```js
@@ -67,18 +67,18 @@ export declare function isPrefix(name: string, prefix: string): boolean;
  * getRelativePath("foo", ["foo","bar"])             // → null
  * ```
  */
-export declare function getRelativePath(name: string, basePath: Array<string | number>): Array<string | number> | null;
+export declare function getRelativePath(fullPath: string | Array<string | number>, basePath: string | Array<string | number>): Array<string | number> | null;
 /**
  * Assign a value to a target object by following the path segments.
  */
-export declare function setValueAtPath<T extends Record<string, any>>(target: T, pathOrSegments: string | Array<string | number>, valueOrFn: unknown | ((current: unknown) => unknown), options?: {
+export declare function setPathValue<T extends Record<string, any>>(target: T, pathOrSegments: string | Array<string | number>, valueOrFn: unknown | ((current: unknown) => unknown), options?: {
     clone?: boolean;
     silent?: boolean;
 }): T;
 /**
  * Retrive the value from a target object by following the path segments.
  */
-export declare function getValueAtPath(target: unknown, pathOrSegments: string | Array<string | number>): unknown;
+export declare function getPathValue(target: unknown, pathOrSegments: string | Array<string | number>): unknown;
 /**
  * Parse `FormData` or `URLSearchParams` into a submission object.
  * This function structures the form values based on the naming convention.
@@ -122,8 +122,11 @@ export declare function parseSubmission(formData: FormData | URLSearchParams, op
     skipEntry?: (name: string) => boolean;
     /**
      * Whether to strip empty values (empty strings, empty files, arrays with all empty values)
-     * from the submission payload. Defaults to `true`.
-     * Set to `false` to preserve empty values in the payload.
+     * from the submission payload. Defaults to `false`.
+     *
+     * @deprecated This option will be removed in a future minor release.
+     * If you are using a schema library like Zod or Valibot, our integration
+     * already strips empty values for you. There is no need to use this option.
      */
     stripEmptyValues?: boolean;
 }): Submission;
@@ -252,7 +255,7 @@ formData: FormData | URLSearchParams | FormValue | null, options?: {
      * - number / bigint:
      *   - Converted to string using `.toString()`
      * - Date:
-     *   - Converted to ISO string using `.toISOString()`
+     *   - Converted to UTC datetime string without trailing `Z` (e.g. `2026-01-01T12:00:00.000`)
      */
     serialize?: (value: unknown, defaultSerialize: Serialize) => SerializedValue | null | undefined;
     /**
@@ -278,13 +281,25 @@ formData: FormData | URLSearchParams | FormValue | null, options?: {
  * - null -> '' (empty string)
  * - boolean -> 'on' | '' (checked semantics)
  * - number | bigint -> value.toString()
- * - Date -> value.toISOString()
+ * - Date -> value.toISOString() without trailing `Z`
  * - File -> File
  * - FileList -> File[]
  * - Array -> string[] or File[] if all items serialize to the same kind; otherwise undefined
  * - anything else -> undefined
  */
 export declare function serialize(value: unknown): SerializedValue | null | undefined;
+/**
+ * Recursively serializes a value using the provided serialize function,
+ * collapsing empty leaves (`null`, `''`, empty files) to `undefined`
+ * and removing empty containers (objects with no remaining keys, empty arrays).
+ *
+ * When serialize returns `undefined` for a value (i.e. it can't be represented
+ * as form data), the raw value is kept and recursed into if it's an object or array.
+ *
+ * Single-element arrays where the element is a string or undefined are unwrapped
+ * to handle the case where a multi-value field (e.g. checkboxes) has only one value.
+ */
+export declare function normalize(value: unknown, serializeValue?: Serialize): unknown;
 /**
  * Retrieve a field value from FormData with optional type guards.
  *

package/dist/formdata.js

@@ -39,12 +39,12 @@ function getFormData(form, submitter) {
  *
  * @example
  * ```js
- * getPathSegments("object.key");       // → ['object', 'key']
- * getPathSegments("array[0].content"); // → ['array', 0, 'content']
- * getPathSegments("todos[]");          // → ['todos', '']
+ * parsePath("object.key");       // → ['object', 'key']
+ * parsePath("array[0].content"); // → ['array', 0, 'content']
+ * parsePath("todos[]");          // → ['todos', '']
  * ```
  */
-function getPathSegments(path) {
+function parsePath(path) {
   if (!path) return [];
   var tokenRegex = /([^.[\]]+)|\[(\d*)\]/g;
   var segments = [];
@@ -85,13 +85,13 @@ function getPathSegments(path) {
  *
  * @example
  * ```js
- * formatPathSegments(['object', 'key']); // → "object.key"
- * formatPathSegments(['array', 0, 'content']); // → "array[0].content"
- * formatPathSegments(['todos', '']); // → "todos[]"
+ * formatPath(['object', 'key']); // → "object.key"
+ * formatPath(['array', 0, 'content']); // → "array[0].content"
+ * formatPath(['todos', '']); // → "todos[]"
  * ```
  */
-function formatPathSegments(segments) {
-  return segments.reduce((path, segment) => appendPathSegment(path, segment), '');
+function formatPath(segments) {
+  return segments.reduce((path, segment) => appendPath(path, segment), '');
 }
 
 /**
@@ -102,7 +102,7 @@ function formatPathSegments(segments) {
  * - segment = `number`     ⇒ bracket notation "[n]"
  * - segment = `string`     ⇒ dot-notation ".prop"
  */
-function appendPathSegment(path, segment) {
+function appendPath(path, segment) {
   // 1) nothing to append
   if (typeof segment === 'undefined') {
     return path !== null && path !== void 0 ? path : '';
@@ -128,23 +128,23 @@ function appendPathSegment(path, segment) {
  *
  * @example
  * ```js
- * isPrefix("foo.bar.baz", "foo.bar")        // → true
- * isPrefix("foo.bar[3].baz", "foo.bar[3]")  // → true
- * isPrefix("foo.bar[3].baz", "foo.bar")     // → true
- * isPrefix("foo.bar[3].baz", "foo.baz")     // → false
- * isPrefix("foo", "foo.bar")                // → false
+ * isPathPrefix("foo.bar.baz", "foo.bar")        // → true
+ * isPathPrefix("foo.bar[3].baz", "foo.bar[3]")  // → true
+ * isPathPrefix("foo.bar[3].baz", "foo.bar")     // → true
+ * isPathPrefix("foo.bar[3].baz", "foo.baz")     // → false
+ * isPathPrefix("foo", "foo.bar")                // → false
  * ```
  */
-function isPrefix(name, prefix) {
-  return getRelativePath(name, getPathSegments(prefix)) !== null;
+function isPathPrefix(name, prefix) {
+  return getRelativePath(name, parsePath(prefix)) !== null;
 }
 
 /**
- * Return the segments of `fullPathStr` that come after the `baseSegments` prefix.
+ * Return the segments of `fullPath` that come after the `basePath` prefix.
  *
- * @param fullPathStr     Full path as a dot/bracket string
- * @param basePath    Base path, already parsed into segments
- * @returns               The “tail” segments, or `null` if `fullPathStr` isn’t nested under `baseSegments`
+ * @param fullPath     Full path as a dot/bracket string or array of segments
+ * @param basePath     Base path as a dot/bracket string or array of segments
+ * @returns               The “tail” segments, or `null` if `fullPath` isn’t nested under `basePath`
  *
  * @example
  * ```js
@@ -153,12 +153,13 @@ function isPrefix(name, prefix) {
  * getRelativePath("foo", ["foo","bar"])             // → null
  * ```
  */
-function getRelativePath(name, basePath) {
-  var fullPath = getPathSegments(name);
+function getRelativePath(fullPath, basePath) {
+  var fullPathSegments = typeof fullPath === 'string' ? parsePath(fullPath) : fullPath;
+  var basePathSegments = typeof basePath === 'string' ? parsePath(basePath) : basePath;
 
   // if full is at least as long *and* starts with the base…
-  if (fullPath.length >= basePath.length && basePath.every((segment, i) => segment === fullPath[i])) {
-    return fullPath.slice(basePath.length);
+  if (fullPathSegments.length >= basePathSegments.length && basePathSegments.every((segment, i) => segment === fullPathSegments[i])) {
+    return fullPathSegments.slice(basePathSegments.length);
   }
   return null;
 }
@@ -166,11 +167,11 @@ function getRelativePath(name, basePath) {
 /**
  * Assign a value to a target object by following the path segments.
  */
-function setValueAtPath(target, pathOrSegments, valueOrFn) {
+function setPathValue(target, pathOrSegments, valueOrFn) {
   var options = arguments.length > 3 && arguments[3] !== undefined ? arguments[3] : {};
   try {
     // 1) normalize + validate path
-    var segments = typeof pathOrSegments === 'string' ? getPathSegments(pathOrSegments) : pathOrSegments;
+    var segments = typeof pathOrSegments === 'string' ? parsePath(pathOrSegments) : pathOrSegments;
     if (segments.length === 0) {
       throw new Error('Cannot set value at the object root');
     }
@@ -222,9 +223,9 @@ function setValueAtPath(target, pathOrSegments, valueOrFn) {
 /**
  * Retrive the value from a target object by following the path segments.
  */
-function getValueAtPath(target, pathOrSegments) {
+function getPathValue(target, pathOrSegments) {
   var pointer = target;
-  var segments = typeof pathOrSegments === 'string' ? getPathSegments(pathOrSegments) : pathOrSegments;
+  var segments = typeof pathOrSegments === 'string' ? parsePath(pathOrSegments) : pathOrSegments;
   for (var segment of segments) {
     if (segment === '') {
       throw new Error("Cannot access empty segment \"[]\" in \"".concat(pathOrSegments, "\""));
@@ -302,7 +303,7 @@ function parseSubmission(formData, options) {
     if (_name !== intentName && !(options !== null && options !== void 0 && (_options$skipEntry = options.skipEntry) !== null && _options$skipEntry !== void 0 && _options$skipEntry.call(options, _name))) {
       var _options$stripEmptyVa;
       var _value = formData.getAll(_name);
-      var segments = getPathSegments(_name);
+      var segments = parsePath(_name);
 
       // If the name ends with [], remove the empty segment and keep the full array
       // Otherwise, unwrap single values
@@ -311,9 +312,7 @@ function parseSubmission(formData, options) {
       } else {
         _value = _value.length > 1 ? _value : _value[0];
       }
-
-      // Check if the value is empty and should be skipped (defaults to true)
-      var stripEmptyValues = (_options$stripEmptyVa = options === null || options === void 0 ? void 0 : options.stripEmptyValues) !== null && _options$stripEmptyVa !== void 0 ? _options$stripEmptyVa : true;
+      var stripEmptyValues = (_options$stripEmptyVa = options === null || options === void 0 ? void 0 : options.stripEmptyValues) !== null && _options$stripEmptyVa !== void 0 ? _options$stripEmptyVa : false;
       if (stripEmptyValues) {
         // For arrays, filter out individual empty items
         if (Array.isArray(_value)) {
@@ -323,7 +322,7 @@ function parseSubmission(formData, options) {
           _value = undefined;
         }
       }
-      setValueAtPath(submission.payload, segments, _value, {
+      setPathValue(submission.payload, segments, _value, {
         silent: true // Avoid errors if the path is invalid
       });
       submission.fields.push(_name);
@@ -399,10 +398,10 @@ function report(submission) {
   var targetValue = typeof options.value === 'undefined' || submission.payload === options.value && !options.reset ? undefined : options.value && !options.keepFiles ? util.stripFiles(options.value) : (_options$value = options.value) !== null && _options$value !== void 0 ? _options$value : {};
   if (options.hideFields) {
     for (var _name3 of options.hideFields) {
-      var path = getPathSegments(_name3);
-      setValueAtPath(submission.payload, path, undefined);
+      var path = parsePath(_name3);
+      setPathValue(submission.payload, path, undefined);
       if (targetValue) {
-        setValueAtPath(targetValue, path, undefined);
+        setPathValue(targetValue, path, undefined);
       }
     }
   }
@@ -452,58 +451,8 @@ formData, options) {
     skipEntry: options === null || options === void 0 ? void 0 : options.skipEntry
   }).payload : formData;
   var defaultValue = options === null || options === void 0 ? void 0 : options.defaultValue;
-  var serializeData = value => {
-    if (options !== null && options !== void 0 && options.serialize) {
-      return options.serialize(value, serialize);
-    }
-    return serialize(value);
-  };
-  function normalize(data) {
-    var value = serializeData(data);
-    if (typeof value === 'undefined') {
-      value = data;
-    }
-
-    // Removes empty strings, so that both empty string, empty file, null and undefined are treated as the same
-    if (value === '' || value === null) {
-      return undefined;
-    }
-    if (dom.isGlobalInstance(value, 'File')) {
-      // Remove empty File as well, which happens if no File was selected
-      if (value.name === '' && value.size === 0) {
-        return undefined;
-      }
-
-      // If the value is a File, no need to serialize it
-      return value;
-    }
-    if (Array.isArray(value)) {
-      if (value.length === 0) {
-        return undefined;
-      }
-      var array = value.map(normalize);
-      if (array.length === 1 && (typeof array[0] === 'string' || array[0] === undefined)) {
-        return array[0];
-      }
-      return array;
-    }
-    if (util.isPlainObject(value)) {
-      var entries = Object.entries(value).reduce((list, _ref) => {
-        var [key, value] = _ref;
-        var normalizedValue = normalize(value);
-        if (typeof normalizedValue !== 'undefined') {
-          list.push([key, normalizedValue]);
-        }
-        return list;
-      }, []);
-      if (entries.length === 0) {
-        return undefined;
-      }
-      return Object.fromEntries(entries);
-    }
-    return value;
-  }
-  return !util.deepEqual(normalize(formValue), normalize(defaultValue));
+  var serializeValue = options !== null && options !== void 0 && options.serialize ? value => options.serialize(value, serialize) : serialize;
+  return !util.deepEqual(normalize(formValue, serializeValue), normalize(defaultValue, serializeValue));
 }
 
 /**
@@ -515,7 +464,7 @@ formData, options) {
  * - null -> '' (empty string)
  * - boolean -> 'on' | '' (checked semantics)
  * - number | bigint -> value.toString()
- * - Date -> value.toISOString()
+ * - Date -> value.toISOString() without trailing `Z`
  * - File -> File
  * - FileList -> File[]
  * - Array -> string[] or File[] if all items serialize to the same kind; otherwise undefined
@@ -533,7 +482,7 @@ function serialize(value) {
       return value.toString();
     }
     if (value instanceof Date) {
-      return value.toISOString();
+      return value.toISOString().slice(0, -1);
     }
     if (dom.isGlobalInstance(value, 'File')) {
       return value;
@@ -576,6 +525,59 @@ function serialize(value) {
   return serializePrimitive(value);
 }
 
+/**
+ * Recursively serializes a value using the provided serialize function,
+ * collapsing empty leaves (`null`, `''`, empty files) to `undefined`
+ * and removing empty containers (objects with no remaining keys, empty arrays).
+ *
+ * When serialize returns `undefined` for a value (i.e. it can't be represented
+ * as form data), the raw value is kept and recursed into if it's an object or array.
+ *
+ * Single-element arrays where the element is a string or undefined are unwrapped
+ * to handle the case where a multi-value field (e.g. checkboxes) has only one value.
+ */
+function normalize(value) {
+  var serializeValue = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : serialize;
+  var data = serializeValue(value);
+  if (typeof data === 'undefined') {
+    data = value;
+  }
+  if (data === '' || data === null) {
+    return undefined;
+  }
+  if (dom.isGlobalInstance(data, 'File')) {
+    if (data.name === '' && data.size === 0) {
+      return undefined;
+    }
+    return data;
+  }
+  if (Array.isArray(data)) {
+    if (data.length === 0) {
+      return undefined;
+    }
+    var array = data.map(item => normalize(item, serializeValue));
+    if (array.length === 1 && (typeof array[0] === 'string' || array[0] === undefined)) {
+      return array[0];
+    }
+    return array;
+  }
+  if (util.isPlainObject(data)) {
+    var entries = Object.entries(data).reduce((list, _ref) => {
+      var [key, value] = _ref;
+      var normalizedValue = normalize(value, serializeValue);
+      if (typeof normalizedValue !== 'undefined') {
+        list.push([key, normalizedValue]);
+      }
+      return list;
+    }, []);
+    if (entries.length === 0) {
+      return undefined;
+    }
+    return Object.fromEntries(entries);
+  }
+  return data;
+}
+
 /**
  * Retrieve a field value from FormData with optional type guards.
  *
@@ -609,11 +611,9 @@ function getFieldValue(formData, name, options) {
     // Get value based on array option
     value = array ? formData.getAll(name) : formData.get(name);
   } else {
-    // Parse formData and use getValueAtPath
-    var _submission = parseSubmission(formData, {
-      stripEmptyValues: false
-    });
-    value = getValueAtPath(_submission.payload, name);
+    // Parse formData and use getPathValue
+    var _submission = parseSubmission(formData);
+    value = getPathValue(_submission.payload, name);
   }
 
   // If optional and value is undefined, skip validation and return early
@@ -648,16 +648,17 @@ function getFieldValue(formData, name, options) {
 }
 
 exports.DEFAULT_INTENT_NAME = DEFAULT_INTENT_NAME;
-exports.appendPathSegment = appendPathSegment;
-exports.formatPathSegments = formatPathSegments;
+exports.appendPath = appendPath;
+exports.formatPath = formatPath;
 exports.getFieldValue = getFieldValue;
 exports.getFormData = getFormData;
-exports.getPathSegments = getPathSegments;
+exports.getPathValue = getPathValue;
 exports.getRelativePath = getRelativePath;
-exports.getValueAtPath = getValueAtPath;
 exports.isDirty = isDirty;
-exports.isPrefix = isPrefix;
+exports.isPathPrefix = isPathPrefix;
+exports.normalize = normalize;
+exports.parsePath = parsePath;
 exports.parseSubmission = parseSubmission;
 exports.report = report;
 exports.serialize = serialize;
-exports.setValueAtPath = setValueAtPath;
+exports.setPathValue = setPathValue;