@warlock.js/seal 5.10.0 → 5.11.0

package/llms-full.txt

@@ -1553,19 +1553,28 @@ Picking guide is in [`@warlock.js/seal/pick-seal-primitive/SKILL.md`](@warlock.j
 
 ## Strict equality
 
-| Method | Effect |
-|---|---|
-| `.mustBeTrue(msg?)` | strictly `=== true` (rejects `"yes"`, `1`, `"on"`) |
-| `.mustBeFalse(msg?)` | strictly `=== false` |
+| Method               | Effect                                             |
+| -------------------- | -------------------------------------------------- |
+| `.mustBeTrue(msg?)`  | strictly `=== true` (rejects `"yes"`, `1`, `"on"`) |
+| `.mustBeFalse(msg?)` | strictly `=== false`                               |
 
 Use these when the field is a real boolean checkbox value — e.g. "agree to terms" must be exactly `true`, not a truthy string.
 
 ## Form-style coercion — `accepted` / `declined`
 
-The "accepted" rules treat `true`, `"yes"`, `"on"`, `1`, `"1"`, `"true"` as accepted. "Declined" treats their counterparts (`false`, `"no"`, `"off"`, `0`, etc.) as declined. Designed for form inputs where a checkbox/radio arrives as a string.
-
-| Method | Effect |
-|---|---|
+Calling `.accepted()`/`.declined()` (or any conditional variant) opts `v.boolean()` into
+form-boolean parsing: a mutator runs before the type rule and converts the accepted set
+(`1`, `"1"`, `true`, `"true"`, `"yes"`, `"y"`, `"on"`, `"Yes"`, `"Y"`, `"On"`) to `true` and
+the declined set (`0`, `"0"`, `false`, `"false"`, `"no"`, `"n"`, `"off"`, `"No"`, `"N"`,
+`"Off"`) to `false`; any other value passes through unchanged and still fails the type rule.
+So `v.boolean().accepted()` given `"yes"` is valid **and its output is the real boolean
+`true`** — not the original string. Designed for form inputs where a checkbox/radio arrives
+as a string. `v.scalar().accepted()` runs the same accepted/declined rule but keeps the raw
+value untouched (no boolean type rule, no parsing mutator) — use it when you want the
+pass/fail check without normalizing the output.
+
+| Method            | Effect                 |
+| ----------------- | ---------------------- |
 | `.accepted(msg?)` | value must be accepted |
 | `.declined(msg?)` | value must be declined |
 
@@ -1576,10 +1585,10 @@ string `"true"`, and bare `v.boolean()` is strict by default — it rejects that
 `.coerce()` when a schema validates `request.query`:
 
 ```ts
-v.object({ active: v.boolean().coerce() })   // "true" → true, passes
+v.object({ active: v.boolean().coerce() }); // "true" → true, passes
 ```
 
-It converts *exactly* `"true"` / `"1"` / `1` → `true` and `"false"` / `"0"` / `0` → `false`.
+It converts _exactly_ `"true"` / `"1"` / `1` → `true` and `"false"` / `"0"` / `0` → `false`.
 Case-sensitive, no trimming — anything else (`"yes"`, `"on"`, `"TRUE"`, `""`, `2`) passes
 through unchanged and still fails the type rule. That's the line between this and
 `accepted()`/`declined()` below: `.coerce()` is for the narrow, exact query-string
@@ -1589,23 +1598,23 @@ serialization; `accepted()`/`declined()` are for broader form-style truthy strin
 
 ## Conditional variants — accepted
 
-| Method | Args | Effect |
-|---|---|---|
-| `.acceptedIf(field, value, msg?)` | sibling field equals value | must be accepted in that case |
+| Method                                | Args                       | Effect                              |
+| ------------------------------------- | -------------------------- | ----------------------------------- |
+| `.acceptedIf(field, value, msg?)`     | sibling field equals value | must be accepted in that case       |
 | `.acceptedUnless(field, value, msg?)` | sibling field equals value | must be accepted unless that's true |
-| `.acceptedIfRequired(field, msg?)` | sibling field is required | — |
-| `.acceptedIfPresent(field, msg?)` | sibling field is present | — |
-| `.acceptedWithout(field, msg?)` | sibling field is absent | — |
+| `.acceptedIfRequired(field, msg?)`    | sibling field is required  | —                                   |
+| `.acceptedIfPresent(field, msg?)`     | sibling field is present   | —                                   |
+| `.acceptedWithout(field, msg?)`       | sibling field is absent    | —                                   |
 
 ## Conditional variants — declined
 
-| Method | Args | Effect |
-|---|---|---|
-| `.declinedIf(field, value, msg?)` | sibling field equals value | must be declined in that case |
+| Method                                | Args                       | Effect                              |
+| ------------------------------------- | -------------------------- | ----------------------------------- |
+| `.declinedIf(field, value, msg?)`     | sibling field equals value | must be declined in that case       |
 | `.declinedUnless(field, value, msg?)` | sibling field equals value | must be declined unless that's true |
-| `.declinedIfRequired(field, msg?)` | — | — |
-| `.declinedIfPresent(field, msg?)` | — | — |
-| `.declinedWithout(field, msg?)` | — | — |
+| `.declinedIfRequired(field, msg?)`    | —                          | —                                   |
+| `.declinedIfPresent(field, msg?)`     | —                          | —                                   |
+| `.declinedWithout(field, msg?)`       | —                          | —                                   |
 
 All conditional variants only run inside `v.object` — sibling resolution silently passes otherwise.
 
@@ -1620,27 +1629,27 @@ All conditional variants only run inside `v.object` — sibling resolution silen
 
 ```ts
 // Strict consent checkbox
-v.boolean().mustBeTrue("You must accept the terms")
+v.boolean().mustBeTrue("You must accept the terms");
 
 // Form-style "remember me" — accepts "on" / true / 1
-v.boolean().accepted().optional()
+v.boolean().accepted().optional();
 
 // Cross-field — newsletter must be accepted if subscriptionType = "premium"
 v.object({
   subscriptionType: v.string().oneOf(["free", "premium"]),
   newsletter: v.boolean().acceptedIf("subscriptionType", "premium"),
-})
+});
 
 // Marketing opt-in — declined unless region is GDPR-exempt
 v.object({
   region: v.string(),
   marketingOptIn: v.boolean().declinedUnless("region", "US"),
-})
+});
 
 // Query-string flag — ?active=true
 v.object({
   active: v.boolean().coerce(),
-})
+});
 ```
 
 

package/package.json

@@ -22,7 +22,7 @@
   ],
   "author": "hassanzohdy",
   "license": "MIT",
-  "version": "5.10.0",
+  "version": "5.11.0",
   "main": "./cjs/index.cjs",
   "module": "./esm/index.mjs",
   "types": "./esm/index.d.mts",

package/skills/pick-seal-primitive/boolean-methods.md

@@ -13,7 +13,16 @@ Use these when the field is a real boolean checkbox value — e.g. "agree to ter
 
 ## Form-style coercion — `accepted` / `declined`
 
-The "accepted" rules treat `true`, `"yes"`, `"on"`, `1`, `"1"`, `"true"` as accepted. "Declined" treats their counterparts (`false`, `"no"`, `"off"`, `0`, etc.) as declined. Designed for form inputs where a checkbox/radio arrives as a string.
+Calling `.accepted()`/`.declined()` (or any conditional variant) opts `v.boolean()` into
+form-boolean parsing: a mutator runs before the type rule and converts the accepted set
+(`1`, `"1"`, `true`, `"true"`, `"yes"`, `"y"`, `"on"`, `"Yes"`, `"Y"`, `"On"`) to `true` and
+the declined set (`0`, `"0"`, `false`, `"false"`, `"no"`, `"n"`, `"off"`, `"No"`, `"N"`,
+`"Off"`) to `false`; any other value passes through unchanged and still fails the type rule.
+So `v.boolean().accepted()` given `"yes"` is valid **and its output is the real boolean
+`true`** — not the original string. Designed for form inputs where a checkbox/radio arrives
+as a string. `v.scalar().accepted()` runs the same accepted/declined rule but keeps the raw
+value untouched (no boolean type rule, no parsing mutator) — use it when you want the
+pass/fail check without normalizing the output.
 
 | Method            | Effect                 |
 | ----------------- | ---------------------- |