@conform-to/dom 1.19.0 → 1.19.1

package/README.md

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

package/dist/formdata.d.ts

@@ -126,12 +126,12 @@ export declare function parseSubmission(formData: FormData | URLSearchParams, op
      * The name of the submit button field that indicates the submission intent.
      * Defaults to `__INTENT__`.
      */
-    intentName?: string;
+    intentName?: string | undefined;
     /**
      * A function to exclude specific form fields from being parsed.
      * Return `true` to skip the entry.
      */
-    skipEntry?: (name: string) => boolean;
+    skipEntry?: ((name: string) => boolean) | undefined;
     /**
      * Whether to strip empty values (empty strings, empty files, arrays with all empty values)
      * from the submission payload. Defaults to `false`.
@@ -140,7 +140,7 @@ export declare function parseSubmission(formData: FormData | URLSearchParams, op
      * 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;
+    stripEmptyValues?: boolean | undefined;
 }): Submission;
 /**
  * Creates a SubmissionResult object from a submission, adding validation results and target values.
@@ -174,16 +174,30 @@ export declare function parseSubmission(formData: FormData | URLSearchParams, op
  * })
  * ```
  */
+export declare function report(submission: Submission, options?: {
+    keepFiles?: false;
+    error?: null;
+    value?: Record<string, FormValue> | null;
+    hideFields?: string[];
+    reset?: boolean;
+}): SubmissionResult<never, Exclude<JsonPrimitive | FormDataEntryValue, File>>;
+export declare function report(submission: Submission, options: {
+    keepFiles: true;
+    error?: null;
+    value?: Record<string, FormValue> | null;
+    hideFields?: string[];
+    reset?: boolean;
+}): SubmissionResult<never>;
 export declare function report<ErrorShape>(submission: Submission, options: {
     keepFiles?: false;
-    error: CustomError<ErrorShape>;
+    error: CustomError<ErrorShape> | null;
     value?: Record<string, FormValue> | null;
     hideFields?: string[];
     reset?: boolean;
 }): SubmissionResult<ErrorShape, Exclude<JsonPrimitive | FormDataEntryValue, File>>;
 export declare function report<ErrorShape>(submission: Submission, options: {
     keepFiles: true;
-    error: CustomError<ErrorShape>;
+    error: CustomError<ErrorShape> | null;
     value?: Record<string, FormValue> | null;
     hideFields?: string[];
     reset?: boolean;
@@ -202,20 +216,6 @@ export declare function report(submission: Submission, options: {
     hideFields?: string[];
     reset?: boolean;
 }): SubmissionResult<string[]>;
-export declare function report(submission: Submission, options?: {
-    keepFiles?: false;
-    error?: null;
-    value?: Record<string, FormValue> | null;
-    hideFields?: string[];
-    reset?: boolean;
-}): SubmissionResult<never, Exclude<JsonPrimitive | FormDataEntryValue, File>>;
-export declare function report(submission: Submission, options: {
-    keepFiles: true;
-    error?: null;
-    value?: Record<string, FormValue> | null;
-    hideFields?: string[];
-    reset?: boolean;
-}): SubmissionResult<never>;
 export declare function report<ErrorShape>(submission: Submission, options?: {
     keepFiles?: boolean;
     error?: CustomError<ErrorShape> | null;
@@ -256,12 +256,12 @@ formData: FormData | URLSearchParams | FormValue | null, options?: {
      * An object representing the default values of the form to compare against.
      * Defaults to an empty object if not provided.
      */
-    defaultValue?: unknown;
+    defaultValue?: unknown | undefined;
     /**
      * The name of the submit button that triggered the submission.
      * It will be excluded from the dirty comparison.
      */
-    intentName?: string;
+    intentName?: string | undefined;
     /**
      * A function to serialize values in defaultValue before comparing them to the form data.
      * If not provided, a default serializer is used that behaves as follows:
@@ -276,7 +276,7 @@ formData: FormData | URLSearchParams | FormValue | null, options?: {
      * - Date:
      *   - Converted to UTC datetime string without trailing `Z` (e.g. `2026-01-01T12:00:00.000`)
      */
-    serialize?: CustomSerialize;
+    serialize?: CustomSerialize | undefined;
     /**
      * A function to exclude specific fields from the comparison.
      * Useful for ignoring hidden inputs like CSRF tokens or internal fields added by frameworks
@@ -289,7 +289,7 @@ formData: FormData | URLSearchParams | FormValue | null, options?: {
      * });
      * ```
      */
-    skipEntry?: (name: string) => boolean;
+    skipEntry?: ((name: string) => boolean) | undefined;
 }): boolean | undefined;
 /**
  * Convert an unknown value into something acceptable for HTML form submission.

package/dist/formdata.js

@@ -292,8 +292,8 @@ function isEmptyValue(value) {
     return value.size === 0 && value.name === '';
   }
   if (Array.isArray(value)) {
-    // If array is empty or all items are empty, consider it empty
-    return value.length === 0 || value.every(item => isEmptyValue(item));
+    // If all items are empty, consider it empty
+    return value.every(item => isEmptyValue(item));
   }
   return false;
 }

package/dist/formdata.mjs

@@ -288,8 +288,8 @@ function isEmptyValue(value) {
     return value.size === 0 && value.name === '';
   }
   if (Array.isArray(value)) {
-    // If array is empty or all items are empty, consider it empty
-    return value.length === 0 || value.every(item => isEmptyValue(item));
+    // If all items are empty, consider it empty
+    return value.every(item => isEmptyValue(item));
   }
   return false;
 }

package/dist/future/index.d.ts

@@ -1,6 +1,6 @@
 export type { Serialize, CustomSerialize, FieldName, FormValue, FormError, Submission, SubmissionResult, ValidationAttributes, } from '../types';
 export { DEFAULT_INTENT_NAME, getFormData, isDirty, normalize, parseSubmission, parsePath, formatPath, appendPath, getRelativePath, getPathValue, setPathValue, report, defaultSerialize, getFieldValue, normalizeFormError, } from '../formdata';
-export { isPlainObject, deepEqual } from '../util';
+export { isPlainObject, deepEqual, serializeHtmlPattern } from '../util';
 export { isFieldElement, isGlobalInstance, updateField, createFileList, createGlobalFormsObserver, dispatchInternalUpdateEvent, focus, change, blur, getFormAction, getFormEncType, getFormMethod, requestSubmit, requestIntent, } from '../dom';
 export { formatIssues } from '../standard-schema';
 //# sourceMappingURL=index.d.ts.map

package/dist/future/index.js

@@ -26,6 +26,7 @@ exports.report = formdata.report;
 exports.setPathValue = formdata.setPathValue;
 exports.deepEqual = util.deepEqual;
 exports.isPlainObject = util.isPlainObject;
+exports.serializeHtmlPattern = util.serializeHtmlPattern;
 exports.blur = dom.blur;
 exports.change = dom.change;
 exports.createFileList = dom.createFileList;

package/dist/future/index.mjs

@@ -1,4 +1,4 @@
 export { DEFAULT_INTENT_NAME, appendPath, defaultSerialize, formatPath, getFieldValue, getFormData, getPathValue, getRelativePath, isDirty, normalize, normalizeFormError, parsePath, parseSubmission, report, setPathValue } from '../formdata.mjs';
-export { deepEqual, isPlainObject } from '../util.mjs';
+export { deepEqual, isPlainObject, serializeHtmlPattern } from '../util.mjs';
 export { blur, change, createFileList, createGlobalFormsObserver, dispatchInternalUpdateEvent, focus, getFormAction, getFormEncType, getFormMethod, isFieldElement, isGlobalInstance, requestIntent, requestSubmit, updateField } from '../dom.mjs';
 export { formatIssues } from '../standard-schema.mjs';

package/dist/types.d.ts

@@ -86,15 +86,15 @@ export type SubmissionResult<ErrorShape = string[], ValueType extends JsonPrimit
     /**
      * The target value of the submission. Defined only when the target value is different from the submitted value.
      */
-    targetValue?: Record<string, FormValue<ValueType>>;
+    targetValue?: Record<string, FormValue<ValueType>> | undefined;
     /**
      * Validation errors for `targetValue` when present, otherwise for the original payload.
      */
-    error?: FormError<ErrorShape> | null;
+    error?: FormError<ErrorShape> | null | undefined;
     /**
      * Indicates whether the form should be reset to its initial state.
      */
-    reset?: boolean;
+    reset?: boolean | undefined;
 };
 /** The name of an input field with type information for TypeScript inference. */
 export type FieldName<FieldShape> = string & {

package/dist/util.d.ts

@@ -16,4 +16,16 @@ export declare function stripFiles<Type extends string | number | boolean | File
  * Helper to get readable type name for error messages
  */
 export declare function getTypeName(value: unknown): string;
+/**
+ * Combines multiple regex patterns into a single HTML pattern attribute.
+ *
+ * This is done by putting each input pattern into a lookahead assertion
+ * and stripping all flags.
+ *
+ * Returns undefined if any pattern is case-insensitive, since transforming
+ * it to a case-sensitive pattern is a non-trivial operation.
+ *
+ * Example: [/[A-Z]/, /[0-9]/] -> '^(?=.*(?:[A-Z]))(?=.*(?:[0-9])).*$'
+ */
+export declare function serializeHtmlPattern(pattern: RegExp | RegExp[]): string | undefined;
 //# sourceMappingURL=util.d.ts.map

package/dist/util.js

@@ -91,10 +91,36 @@ function getTypeName(value) {
   return typeof value;
 }
 
+/**
+ * Combines multiple regex patterns into a single HTML pattern attribute.
+ *
+ * This is done by putting each input pattern into a lookahead assertion
+ * and stripping all flags.
+ *
+ * Returns undefined if any pattern is case-insensitive, since transforming
+ * it to a case-sensitive pattern is a non-trivial operation.
+ *
+ * Example: [/[A-Z]/, /[0-9]/] -> '^(?=.*(?:[A-Z]))(?=.*(?:[0-9])).*$'
+ */
+function serializeHtmlPattern(pattern) {
+  var patterns = Array.isArray(pattern) ? pattern : [pattern];
+  if (patterns.length === 0 || patterns.some(p => p.flags.includes('i'))) {
+    return undefined;
+  }
+  var serializedPattern = "^".concat(patterns.map(p => "(?=.*(?:".concat(p.source, "))")).join(''), ".*$");
+  try {
+    new RegExp(serializedPattern, 'v');
+  } catch (_unused) {
+    return undefined;
+  }
+  return serializedPattern;
+}
+
 exports.clone = clone;
 exports.deepEqual = deepEqual;
 exports.generateId = generateId;
 exports.getTypeName = getTypeName;
 exports.invariant = invariant;
 exports.isPlainObject = isPlainObject;
+exports.serializeHtmlPattern = serializeHtmlPattern;
 exports.stripFiles = stripFiles;

package/dist/util.mjs

@@ -87,4 +87,29 @@ function getTypeName(value) {
   return typeof value;
 }
 
-export { clone, deepEqual, generateId, getTypeName, invariant, isPlainObject, stripFiles };
+/**
+ * Combines multiple regex patterns into a single HTML pattern attribute.
+ *
+ * This is done by putting each input pattern into a lookahead assertion
+ * and stripping all flags.
+ *
+ * Returns undefined if any pattern is case-insensitive, since transforming
+ * it to a case-sensitive pattern is a non-trivial operation.
+ *
+ * Example: [/[A-Z]/, /[0-9]/] -> '^(?=.*(?:[A-Z]))(?=.*(?:[0-9])).*$'
+ */
+function serializeHtmlPattern(pattern) {
+  var patterns = Array.isArray(pattern) ? pattern : [pattern];
+  if (patterns.length === 0 || patterns.some(p => p.flags.includes('i'))) {
+    return undefined;
+  }
+  var serializedPattern = "^".concat(patterns.map(p => "(?=.*(?:".concat(p.source, "))")).join(''), ".*$");
+  try {
+    new RegExp(serializedPattern, 'v');
+  } catch (_unused) {
+    return undefined;
+  }
+  return serializedPattern;
+}
+
+export { clone, deepEqual, generateId, getTypeName, invariant, isPlainObject, serializeHtmlPattern, stripFiles };

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.19.0",
+  "version": "1.19.1",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
   "types": "./dist/index.d.ts",