@warlock.js/seal 5.25.0 → 5.26.0

package/CHANGELOG.md

@@ -4,6 +4,12 @@ All notable changes to `@warlock.js/seal` are documented in this file.
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/). `@warlock.js/*` packages are released in lockstep — every package shares the same version number, so a version below may list only the changes that affected this package.
 
+## 5.26.0 - 2026-09-30
+
+### Changed
+
+- Lockstep release; package APIs are unchanged.
+
 ## 5.25.0 - 2026-09-28
 
 ### Fixed

package/llms-full.txt

@@ -189,10 +189,9 @@ v.string().min(3).trim()
 ## `.required()` / `.optional()` / `.present()`
 
 ```ts
-v.string()             // already required inside v.object — no need to call .required()
+v.string()             // already required inside v.object
 v.string().optional()  // type: string | undefined — { isOptional: true } brand
 v.string().present()   // must exist, may be "" / null
-v.string().required()  // explicit form — same behavior, redundant
 ```
 
 **Required is the default inside `v.object`.** Most schemas read cleaner without `.required()` — `Infer<>` already shows what's required (no `?`) vs optional (`?`). Calling `.required()` explicitly is harmless and accepted, but the canonical seal style is to skip it. Keep `.optional()` explicit (it changes behavior); skip `.required()` (it doesn't).
@@ -200,7 +199,6 @@ v.string().required()  // explicit form — same behavior, redundant
 The `{ isOptional: true }` brand survives chaining (`.optional().min(3)` is still optional) and `Infer<>` reads it to make the key optional.
 
 **When `.required()` is still useful:**
-- Visual contrast next to `.optional()` siblings when you want the asymmetry to be loud — style call.
 - It's not needed for conditional rules — `.requiredIf(field, value)` and friends *replace* the default required-condition slot, so they work standalone.
 
 Conditional variants (run inside `v.object` only):
@@ -397,7 +395,7 @@ Validators are **immutable by default**. Every chain method returns a clone:
 
 ```ts
 const baseString = v.string();
-const required = baseString.required();
+const short = baseString.min(3);
 // baseString is unchanged
 ```
 
@@ -406,7 +404,7 @@ This matters because schemas are often shared (`Model.schema = v.object({...})`)
 Toggle in-place with the `.mutable` getter (rare):
 
 ```ts
-const schema = v.string().mutable.required().min(3);
+const schema = v.string().mutable.min(3);
 // Same instance throughout — useful when building dynamically
 ```
 
@@ -749,8 +747,8 @@ The default is to **reject** unknown keys, which is what you want for inbound pa
 
 ```ts
 const publicArticle = v.object({
-  id: v.string().required(),
-  title: v.string().required(),
+  id: v.string(),
+  title: v.string(),
 }).stripUnknown();
 
 const { isValid, data } = await v.validate(publicArticle, record);
@@ -2200,7 +2198,7 @@ import { object } from "@warlock.js/seal/object";
 import { string } from "@warlock.js/seal/string";
 
 const commentSchema = object({
-  comment: string().trim().required().minLength(3),
+  comment: string().trim().minLength(3),
 });
 
 const result = await commentSchema["~standard"].validate({

package/llms.txt

@@ -7,7 +7,7 @@
 ## Skills
 
 - [bridge-standard-schema](@warlock.js/seal/bridge-standard-schema/SKILL.md): (no description)
-- [compose-seal-modifiers](@warlock.js/seal/compose-seal-modifiers/SKILL.md): (no description)
+- [compose-seal-modifiers](@warlock.js/seal/compose-seal-modifiers/SKILL.md): Apply cross-cutting modifiers — `.optional` / `.nullable` / `.default` / `.catch` / `.omit` / membership rules — plus the mutator-vs-transformer pipeline and `Infer.Input` vs `Infer.Output`. Triggers: `.optional`, `.required`, `.nullable`, `.default`, `.catch`, `.present`, `.requiredIf`, `.requiredWith`, `.in`, `.oneOf`, `.notIn`, `.omit`, `.attribute`, `.mutable`, `.addMutator`, `Infer.Input`, `Infer.Output`; "mark field optional in seal", "default value in schema", "mutator vs transformer", "when does .catch fire"; typical import `import { v, type Infer } from "@warlock.js/seal"`. Skip: primitives — `@warlock.js/seal/pick-seal-primitive/SKILL.md`; containers — `@warlock.js/seal/define-structural-shape/SKILL.md`; errors — `@warlock.js/seal/handle-seal-errors/SKILL.md`; competing `zod` `.optional`/`.default`.
 - [define-structural-shape](@warlock.js/seal/define-structural-shape/SKILL.md): (no description)
 - [extend-seal-with-plugins](@warlock.js/seal/extend-seal-with-plugins/SKILL.md): (no description)
 - [generate-json-schema](@warlock.js/seal/generate-json-schema/SKILL.md): (no description)

package/package.json

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