@conform-to/dom 1.9.1 → 1.10.0

package/README.md

@@ -7,7 +7,7 @@
  ╚══════╝  ╚═════╝  ╚═╝  ╚══╝ ╚═╝        ╚═════╝  ╚═╝   ╚═╝ ╚═╝   ╚═╝
 ```
 
-Version 1.9.1 / License MIT / Copyright (c) 2025 Edmund Hung
+Version 1.10.0 / License MIT / Copyright (c) 2025 Edmund Hung
 
 Progressively enhance HTML forms with React. Build resilient, type-safe forms with no hassle using web standards.
 

package/dist/dom.js

@@ -397,7 +397,7 @@ function normalizeStringValues(value) {
 function normalizeFileValues(value) {
   if (typeof value === 'undefined') return undefined;
   if (value === null) return createFileList([]);
-  if (isGlobalInstance(value, 'File')) return createFileList([value]);
+  if (isGlobalInstance(value, 'File')) return createFileList(value.name === '' && value.size === 0 ? [] : [value]);
   if (isGlobalInstance(value, 'FileList')) return value;
   if (Array.isArray(value) && value.every(item => isGlobalInstance(item, 'File'))) {
     return createFileList(value);

package/dist/dom.mjs

@@ -393,7 +393,7 @@ function normalizeStringValues(value) {
 function normalizeFileValues(value) {
   if (typeof value === 'undefined') return undefined;
   if (value === null) return createFileList([]);
-  if (isGlobalInstance(value, 'File')) return createFileList([value]);
+  if (isGlobalInstance(value, 'File')) return createFileList(value.name === '' && value.size === 0 ? [] : [value]);
   if (isGlobalInstance(value, 'FileList')) return value;
   if (Array.isArray(value) && value.every(item => isGlobalInstance(item, 'File'))) {
     return createFileList(value);

package/dist/formdata.d.ts

@@ -217,7 +217,7 @@ formData: FormData | URLSearchParams | FormValue | null, options?: {
      * - Date:
      *   - Converted to ISO string using `.toISOString()`
      */
-    serialize?: (value: unknown, defaultSerialize: Serialize) => SerializedValue | undefined;
+    serialize?: (value: unknown, defaultSerialize: Serialize) => SerializedValue | null | undefined;
     /**
      * A function to exclude specific fields from the comparison.
      * Useful for ignoring hidden inputs like CSRF tokens or internal fields added by frameworks
@@ -247,5 +247,5 @@ formData: FormData | URLSearchParams | FormValue | null, options?: {
  * - Array -> string[] or File[] if all items serialize to the same kind; otherwise undefined
  * - anything else -> undefined
  */
-export declare function serialize(value: unknown): SerializedValue | undefined;
+export declare function serialize(value: unknown): SerializedValue | null | undefined;
 //# sourceMappingURL=formdata.d.ts.map

package/dist/formdata.js

@@ -395,11 +395,13 @@ formData, options) {
     return serialize(value);
   };
   function normalize(data) {
-    var _serializeData;
-    var value = (_serializeData = serializeData(data)) !== null && _serializeData !== void 0 ? _serializeData : data;
+    var value = serializeData(data);
+    if (typeof value === 'undefined') {
+      value = data;
+    }
 
-    // Removes empty strings, so that bpth empty string and undefined are treated as the same
-    if (value === '') {
+    // 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')) {
@@ -457,12 +459,9 @@ formData, options) {
  */
 function serialize(value) {
   function serializePrimitive(value) {
-    if (typeof value === 'string') {
+    if (typeof value === 'string' || value === null) {
       return value;
     }
-    if (value === null) {
-      return '';
-    }
     if (typeof value === 'boolean') {
       return value ? 'on' : '';
     }
@@ -484,11 +483,13 @@ function serialize(value) {
       if (typeof serialized === 'undefined') {
         return;
       }
-      if (typeof serialized === 'string') {
+
+      // It is unclear what `null` in a file array should mean, so we treat it as a string instead
+      if (typeof serialized === 'string' || serialized === null) {
         if (files.length > 0) {
           return;
         }
-        _options.push(serialized);
+        _options.push(serialized !== null && serialized !== void 0 ? serialized : '');
       } else {
         if (_options.length > 0) {
           return;

package/dist/formdata.mjs

@@ -391,11 +391,13 @@ formData, options) {
     return serialize(value);
   };
   function normalize(data) {
-    var _serializeData;
-    var value = (_serializeData = serializeData(data)) !== null && _serializeData !== void 0 ? _serializeData : data;
+    var value = serializeData(data);
+    if (typeof value === 'undefined') {
+      value = data;
+    }
 
-    // Removes empty strings, so that bpth empty string and undefined are treated as the same
-    if (value === '') {
+    // 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 (isGlobalInstance(value, 'File')) {
@@ -453,12 +455,9 @@ formData, options) {
  */
 function serialize(value) {
   function serializePrimitive(value) {
-    if (typeof value === 'string') {
+    if (typeof value === 'string' || value === null) {
       return value;
     }
-    if (value === null) {
-      return '';
-    }
     if (typeof value === 'boolean') {
       return value ? 'on' : '';
     }
@@ -480,11 +479,13 @@ function serialize(value) {
       if (typeof serialized === 'undefined') {
         return;
       }
-      if (typeof serialized === 'string') {
+
+      // It is unclear what `null` in a file array should mean, so we treat it as a string instead
+      if (typeof serialized === 'string' || serialized === null) {
         if (files.length > 0) {
           return;
         }
-        _options.push(serialized);
+        _options.push(serialized !== null && serialized !== void 0 ? serialized : '');
       } else {
         if (_options.length > 0) {
           return;

package/dist/types.d.ts

@@ -88,7 +88,7 @@ export type Serializable<T> = T extends File ? undefined : T extends Array<infer
  * @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;
+export type Serialize = (value: unknown) => SerializedValue | null | undefined;
 /**
  * A value that can be serialized into `FormData`.
  *

package/package.json

@@ -3,7 +3,7 @@
   "description": "A set of opinionated helpers built on top of the Constraint Validation API",
   "homepage": "https://conform.guide",
   "license": "MIT",
-  "version": "1.9.1",
+  "version": "1.10.0",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
   "types": "./dist/index.d.ts",