@conform-to/dom 1.12.0 → 1.13.0

package/README.md

@@ -7,7 +7,7 @@
  ╚══════╝  ╚═════╝  ╚═╝  ╚══╝ ╚═╝        ╚═════╝  ╚═╝   ╚═╝ ╚═╝   ╚═╝
 ```
 
-Version 1.12.0 / License MIT / Copyright (c) 2025 Edmund Hung
+Version 1.13.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.d.ts

@@ -84,6 +84,11 @@ export declare function focus(element: HTMLInputElement | HTMLSelectElement | HT
 export declare function blur(element: HTMLInputElement | HTMLSelectElement | HTMLTextAreaElement): void;
 export declare function normalizeStringValues(value: unknown): string[] | undefined;
 export declare function normalizeFileValues(value: unknown): FileList | undefined;
+/**
+ * Retrieves the default value of a form field element by reading the DOM's
+ * defaultValue, defaultChecked, or defaultSelected properties.
+ */
+export declare function getFieldDefaultValue(element: HTMLInputElement | HTMLSelectElement | HTMLTextAreaElement): string | string[] | File | File[] | FileList | null;
 /**
  * Updates the DOM element with the provided value and defaultValue.
  * If the value or defaultValue is undefined, it will keep the current value instead

package/dist/dom.js

@@ -405,6 +405,43 @@ function normalizeFileValues(value) {
   throw new Error('Expected File, FileList or File[] for file input');
 }
 
+/**
+ * Retrieves the default value of a form field element by reading the DOM's
+ * defaultValue, defaultChecked, or defaultSelected properties.
+ */
+function getFieldDefaultValue(element) {
+  if (isInputElement(element)) {
+    switch (element.type) {
+      case 'file':
+        {
+          return null;
+        }
+      case 'checkbox':
+      case 'radio':
+        {
+          if (element.defaultChecked) {
+            return element.value;
+          }
+          return null;
+        }
+    }
+  } else if (isSelectElement(element)) {
+    if (element.multiple) {
+      var values = [];
+      for (var option of element.options) {
+        if (option.defaultSelected) {
+          values.push(option.value);
+        }
+      }
+      return values;
+    } else {
+      var selectedOption = Array.from(element.options).find(option => option.defaultSelected);
+      return selectedOption ? selectedOption.value : null;
+    }
+  }
+  return element.defaultValue;
+}
+
 /**
  * Updates the DOM element with the provided value and defaultValue.
  * If the value or defaultValue is undefined, it will keep the current value instead
@@ -552,6 +589,7 @@ exports.createFileList = createFileList;
 exports.createGlobalFormsObserver = createGlobalFormsObserver;
 exports.createSubmitEvent = createSubmitEvent;
 exports.focus = focus;
+exports.getFieldDefaultValue = getFieldDefaultValue;
 exports.getFormAction = getFormAction;
 exports.getFormEncType = getFormEncType;
 exports.getFormMethod = getFormMethod;

package/dist/dom.mjs

@@ -401,6 +401,43 @@ function normalizeFileValues(value) {
   throw new Error('Expected File, FileList or File[] for file input');
 }
 
+/**
+ * Retrieves the default value of a form field element by reading the DOM's
+ * defaultValue, defaultChecked, or defaultSelected properties.
+ */
+function getFieldDefaultValue(element) {
+  if (isInputElement(element)) {
+    switch (element.type) {
+      case 'file':
+        {
+          return null;
+        }
+      case 'checkbox':
+      case 'radio':
+        {
+          if (element.defaultChecked) {
+            return element.value;
+          }
+          return null;
+        }
+    }
+  } else if (isSelectElement(element)) {
+    if (element.multiple) {
+      var values = [];
+      for (var option of element.options) {
+        if (option.defaultSelected) {
+          values.push(option.value);
+        }
+      }
+      return values;
+    } else {
+      var selectedOption = Array.from(element.options).find(option => option.defaultSelected);
+      return selectedOption ? selectedOption.value : null;
+    }
+  }
+  return element.defaultValue;
+}
+
 /**
  * Updates the DOM element with the provided value and defaultValue.
  * If the value or defaultValue is undefined, it will keep the current value instead
@@ -542,4 +579,4 @@ function isDirtyInput(element) {
   return false;
 }
 
-export { blur, change, createFileList, createGlobalFormsObserver, createSubmitEvent, focus, getFormAction, getFormEncType, getFormMethod, isDirtyInput, isFieldElement, isGlobalInstance, isInputElement, isSelectElement, isSubmitter, isTextAreaElement, normalizeFileValues, normalizeStringValues, requestIntent, requestSubmit, updateField };
+export { blur, change, createFileList, createGlobalFormsObserver, createSubmitEvent, focus, getFieldDefaultValue, getFormAction, getFormEncType, getFormMethod, isDirtyInput, isFieldElement, isGlobalInstance, isInputElement, isSelectElement, isSubmitter, isTextAreaElement, normalizeFileValues, normalizeStringValues, requestIntent, requestSubmit, updateField };

package/dist/future/index.d.ts

@@ -1,6 +1,6 @@
 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';
+export { isFieldElement, isGlobalInstance, updateField, createFileList, createSubmitEvent, createGlobalFormsObserver, focus, change, blur, getFieldDefaultValue, getFormAction, getFormEncType, getFormMethod, requestSubmit, requestIntent, } from '../dom';
 export { formatIssues } from '../standard-schema';
 //# sourceMappingURL=index.d.ts.map

package/dist/future/index.js

@@ -29,6 +29,7 @@ exports.createFileList = dom.createFileList;
 exports.createGlobalFormsObserver = dom.createGlobalFormsObserver;
 exports.createSubmitEvent = dom.createSubmitEvent;
 exports.focus = dom.focus;
+exports.getFieldDefaultValue = dom.getFieldDefaultValue;
 exports.getFormAction = dom.getFormAction;
 exports.getFormEncType = dom.getFormEncType;
 exports.getFormMethod = dom.getFormMethod;

package/dist/future/index.mjs

@@ -1,4 +1,4 @@
 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';
+export { blur, change, createFileList, createGlobalFormsObserver, createSubmitEvent, focus, getFieldDefaultValue, getFormAction, getFormEncType, getFormMethod, isFieldElement, isGlobalInstance, requestIntent, requestSubmit, updateField } from '../dom.mjs';
 export { formatIssues } from '../standard-schema.mjs';

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