fix: align DOM checkbox and radio parsing with browsers

README.md

@@ -265,7 +265,7 @@ Compatibility with the old project is intentional.
 - Name paths define output shape (`person.name.first`).
 - Array and indexed syntax is preserved (`items[]`, `items[5].name`).
 - Rails-style names are supported (`rails[field][value]`).
-- Checkbox/radio `"true"` and `"false"` quirks are preserved.
+- DOM extraction follows native browser form submission semantics for checkbox and radio values.
 - Unsafe key path segments (`__proto__`, `prototype`, `constructor`) are rejected by default.
 - This library does data shaping, not JSON/XML serialization.
 
@@ -274,7 +274,7 @@ Compatibility with the old project is intentional.
 These boundaries are intentional and are used for issue triage.
 
 - Sparse indexes are compacted in first-seen order (`items[5]`, `items[8]` -> `items[0]`, `items[1]`).
-- Type inference is minimal by design; only legacy checkbox/radio `"true"` and `"false"` coercion is built in.
+- Type inference is minimal by design; DOM extraction keeps native string values instead of coercing checkbox/radio fields.
 - `formToObject` reads successful form control values, not option labels. Disabled controls (including disabled fieldset descendants) and button-like inputs are excluded unless you explicitly opt in to disabled values.
 - `extractPairs`/`formToObject` support `nodeCallback`; return `SKIP_NODE` to exclude a node entirely, or `{ name|key, value }` to inject a custom entry.
 - Parser inputs reject unsafe path segments by default. Use `allowUnsafePathSegments: true` only with trusted inputs.

apps/docs/test/standard-variants.test.tsx

@@ -74,7 +74,6 @@ describe("standard playground variants", () => {
       errorMessage: null,
       parsedPayload: {
         person: {
-          approved: false,
           city: "lancre",
           guild: "witches",
           name: { first: "Esme", last: "Weatherwax" },

docs/api.md

@@ -224,10 +224,9 @@ export function form2js(
 ### Behavior notes
 
 - `select name="colors[]"` is emitted as key `colors` (the trailing `[]` is removed for selects).
-- Legacy checkbox/radio quirks are preserved:
-  - checked `"true"` -> `true`
-  - unchecked `"true"` -> `false`
-  - checked `"false"` (radio/checkbox) -> `false`
+- Checkbox and radio values follow native browser form submission semantics:
+  - checked controls emit their string `value`
+  - unchecked controls are omitted
 - Button-like inputs (`button`, `reset`, `submit`, `image`) are excluded from extraction.
 - Can merge multiple roots (`NodeList`, arrays, `HTMLCollection`) into one object.
 - If callback returns `SKIP_NODE`, that node is excluded from extraction entirely.

packages/dom/src/index.ts

@@ -208,29 +208,7 @@ function getFieldValue(fieldNode: Node, getDisabled: boolean): unknown {
 
       switch (inputType) {
         case "radio":
-          if (fieldNode.checked && fieldNode.value === "false") {
-            return false;
-          }
-
-          if (fieldNode.checked && fieldNode.value === "true") {
-            return true;
-          }
-
-          if (fieldNode.checked) {
-            return fieldNode.value;
-          }
-
-          return null;
-
         case "checkbox":
-          if (fieldNode.checked && fieldNode.value === "true") {
-            return true;
-          }
-
-          if (!fieldNode.checked && fieldNode.value === "true") {
-            return false;
-          }
-
           if (fieldNode.checked) {
             return fieldNode.value;
           }

packages/dom/test/dom.test.ts

@@ -116,11 +116,14 @@ describe("extractPairs", () => {
 });
 
 describe("formToObject", () => {
-  it("keeps legacy checkbox and radio coercion quirks", () => {
+  it("keeps checkbox and radio values aligned with native form submission", () => {
     document.body.innerHTML = `
       <form id="testForm">
-        <input type="checkbox" name="person.agree" value="true" />
-        <input type="radio" name="person.optOut" value="false" checked />
+        <input type="checkbox" name="person.checkboxTrueChecked" value="true" checked />
+        <input type="checkbox" name="person.checkboxTrueUnchecked" value="true" />
+        <input type="checkbox" name="person.checkboxFalseChecked" value="false" checked />
+        <input type="checkbox" name="person.checkboxFalseUnchecked" value="false" />
+        <input type="radio" name="person.radio" value="false" checked />
       </form>
     `;
 
@@ -129,8 +132,9 @@ describe("formToObject", () => {
 
     expect(result).toEqual({
       person: {
-        agree: false,
-        optOut: false
+        checkboxTrueChecked: "true",
+        checkboxFalseChecked: "false",
+        radio: "false"
       }
     });
   });