@warlock.js/seal 5.30.0 → 5.32.0

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

@@ -6,164 +6,169 @@ For the picking guide (`v.string` vs `v.scalar` vs `v.literal`), see the `pick-s
 
 ## Length
 
-| Method | Args | JSON Schema | Example |
-|---|---|---|---|
-| `.min(n, msg?)` | min length, inclusive | `minLength: n` | `v.string().min(3)` |
-| `.minLength(n, msg?)` | alias for `.min()` | `minLength: n` | `v.string().minLength(3)` |
-| `.max(n, msg?)` | max length, inclusive | `maxLength: n` | `v.string().max(120)` |
-| `.maxLength(n, msg?)` | alias for `.max()` | `maxLength: n` | `v.string().maxLength(120)` |
-| `.length(n, msg?)` | exact length | `minLength=maxLength=n` | `v.string().length(10)` |
-| `.lengthBetween(a, b, msg?)` | min and max length | `minLength: a, maxLength: b` | `v.string().lengthBetween(5, 30)` |
+| Method                       | Args                  | JSON Schema                  | Example                           |
+| ---------------------------- | --------------------- | ---------------------------- | --------------------------------- |
+| `.min(n, msg?)`              | min length, inclusive | `minLength: n`               | `v.string().min(3)`               |
+| `.minLength(n, msg?)`        | alias for `.min()`    | `minLength: n`               | `v.string().minLength(3)`         |
+| `.max(n, msg?)`              | max length, inclusive | `maxLength: n`               | `v.string().max(120)`             |
+| `.maxLength(n, msg?)`        | alias for `.max()`    | `maxLength: n`               | `v.string().maxLength(120)`       |
+| `.length(n, msg?)`           | exact length          | `minLength=maxLength=n`      | `v.string().length(10)`           |
+| `.lengthBetween(a, b, msg?)` | min and max length    | `minLength: a, maxLength: b` | `v.string().lengthBetween(5, 30)` |
 
 ## Format
 
-| Method | Pattern | JSON Schema | Example |
-|---|---|---|---|
-| `.email(msg?)` | RFC-flavored regex | `format: "email"` | `v.string().email()` |
-| `.url(msg?)` | http/https URL | `format: "uri"` | `v.string().url()` |
-| `.pattern(re, msg?)` | custom regex | `pattern: re.source` | `v.string().pattern(/^[A-Z]/)` |
-| `.alpha(msg?)` | letters only | — | `v.string().alpha()` |
-| `.alphanumeric(msg?)` | letters + digits | — | `v.string().alphanumeric()` |
-| `.numeric(msg?)` | digits only (string) | — | `v.string().numeric()` |
-| `.withoutWhitespace(msg?)` | no spaces/tabs/newlines | — | `v.string().withoutWhitespace()` |
-| `.creditCard(msg?)` | credit-card-shaped | — | `v.string().creditCard()` |
-| `.ip(msg?)` | IPv4 or IPv6 | `format: "ipv4"` | `v.string().ip()` |
-| `.ip4(msg?)` | IPv4 only | `format: "ipv4"` | `v.string().ip4()` |
-| `.ip6(msg?)` | IPv6 only | `format: "ipv6"` | `v.string().ip6()` |
-| `.strongPassword(minLen?, msg?)` | 8+ chars, upper+lower+digit+symbol | — | `v.string().strongPassword(12)` |
+| Method                           | Pattern                            | JSON Schema          | Example                          |
+| -------------------------------- | ---------------------------------- | -------------------- | -------------------------------- |
+| `.email(msg?)`                   | RFC-flavored regex                 | `format: "email"`    | `v.string().email()`             |
+| `.url(msg?)`                     | http/https URL                     | `format: "uri"`      | `v.string().url()`               |
+| `.pattern(re, msg?)`             | custom regex                       | `pattern: re.source` | `v.string().pattern(/^[A-Z]/)`   |
+| `.alpha(msg?)`                   | letters only                       | —                    | `v.string().alpha()`             |
+| `.alphanumeric(msg?)`            | letters + digits                   | —                    | `v.string().alphanumeric()`      |
+| `.numeric(msg?)`                 | digits only (string)               | —                    | `v.string().numeric()`           |
+| `.withoutWhitespace(msg?)`       | no spaces/tabs/newlines            | —                    | `v.string().withoutWhitespace()` |
+| `.creditCard(msg?)`              | credit-card-shaped                 | —                    | `v.string().creditCard()`        |
+| `.ip(msg?)`                      | IPv4 or IPv6                       | `format: "ipv4"`     | `v.string().ip()`                |
+| `.ip4(msg?)`                     | IPv4 only                          | `format: "ipv4"`     | `v.string().ip4()`               |
+| `.ip6(msg?)`                     | IPv6 only                          | `format: "ipv6"`     | `v.string().ip6()`               |
+| `.strongPassword(minLen?, msg?)` | 8+ chars, upper+lower+digit+symbol | —                    | `v.string().strongPassword(12)`  |
 
 ## ID formats
 
-| Method | Args | JSON Schema | Example |
-|---|---|---|---|
-| `.uuid(version?, msg?)` | UUID, any version or restrict to 1/3/4/5/6/7 | `format: "uuid"` | `v.string().uuid(4)` |
-| `.cuid({ version?: 1\|2 }?)` | CUID2 default (24 chars, lowercase); v1 legacy | `pattern: …` | `v.string().cuid()` |
-| `.ulid(msg?)` | 26 chars, Crockford base32 (no I/L/O/U) | `pattern: …` | `v.string().ulid()` |
-| `.nanoid(length?, msg?)` | URL-safe alphabet, default length 21 | `pattern: …` | `v.string().nanoid(21)` |
+| Method                       | Args                                           | JSON Schema      | Example                 |
+| ---------------------------- | ---------------------------------------------- | ---------------- | ----------------------- |
+| `.uuid(version?, msg?)`      | UUID, any version or restrict to 1/3/4/5/6/7   | `format: "uuid"` | `v.string().uuid(4)`    |
+| `.cuid({ version?: 1\|2 }?)` | CUID2 default (24 chars, lowercase); v1 legacy | `pattern: …`     | `v.string().cuid()`     |
+| `.ulid(msg?)`                | 26 chars, Crockford base32 (no I/L/O/U)        | `pattern: …`     | `v.string().ulid()`     |
+| `.nanoid(length?, msg?)`     | URL-safe alphabet, default length 21           | `pattern: …`     | `v.string().nanoid(21)` |
 
 UUID validation is RFC 4122 strict — the variant nibble (8/9/a/b at position 17) is checked, so "looks-like-UUID-but-not-valid" inputs are rejected. CUID defaults to **CUID2** since CUID1 is deprecated by its original author; pass `{ version: 1 }` only for legacy data. nanoid's alphabet is fixed (`A-Za-z0-9_-`) — for custom alphabets use `.pattern()` directly.
 
 ## Word count
 
-| Method | Args | Example |
-|---|---|---|
-| `.words(n, msg?)` | exact word count | `v.string().words(5)` |
-| `.minWords(n, msg?)` | min words | `v.string().minWords(3)` |
-| `.maxWords(n, msg?)` | max words | `v.string().maxWords(50)` |
+| Method               | Args             | Example                   |
+| -------------------- | ---------------- | ------------------------- |
+| `.words(n, msg?)`    | exact word count | `v.string().words(5)`     |
+| `.minWords(n, msg?)` | min words        | `v.string().minWords(3)`  |
+| `.maxWords(n, msg?)` | max words        | `v.string().maxWords(50)` |
 
 ## Content
 
-| Method | Args | Example |
-|---|---|---|
-| `.startsWith(s, msg?)` | prefix check | `v.string().startsWith("https://")` |
-| `.endsWith(s, msg?)` | suffix check | `v.string().endsWith(".pdf")` |
-| `.contains(s, msg?)` | substring check | `v.string().contains("@")` |
+| Method                  | Args              | Example                                 |
+| ----------------------- | ----------------- | --------------------------------------- |
+| `.startsWith(s, msg?)`  | prefix check      | `v.string().startsWith("https://")`     |
+| `.endsWith(s, msg?)`    | suffix check      | `v.string().endsWith(".pdf")`           |
+| `.contains(s, msg?)`    | substring check   | `v.string().contains("@")`              |
 | `.notContains(s, msg?)` | inverse substring | `v.string().notContains("javascript:")` |
 
 ## Color
 
-| Method | Accepts | Example |
-|---|---|---|
-| `.color(msg?)` | any valid CSS color | `v.string().color()` |
-| `.hexColor(msg?)` | `#rgb`, `#rrggbb` | `v.string().hexColor()` |
-| `.rgbColor(msg?)` | `rgb(r,g,b)` | — |
-| `.rgbaColor(msg?)` | `rgba(r,g,b,a)` | — |
-| `.hslColor(msg?)` | `hsl(h,s,l)` | — |
-| `.lightColor(msg?)` | luminance-based | — |
-| `.darkColor(msg?)` | luminance-based | — |
+| Method              | Accepts             | Example                 |
+| ------------------- | ------------------- | ----------------------- |
+| `.color(msg?)`      | any valid CSS color | `v.string().color()`    |
+| `.hexColor(msg?)`   | `#rgb`, `#rrggbb`   | `v.string().hexColor()` |
+| `.rgbColor(msg?)`   | `rgb(r,g,b)`        | —                       |
+| `.rgbaColor(msg?)`  | `rgba(r,g,b,a)`     | —                       |
+| `.hslColor(msg?)`   | `hsl(h,s,l)`        | —                       |
+| `.lightColor(msg?)` | luminance-based     | —                       |
+| `.darkColor(msg?)`  | luminance-based     | —                       |
 
 JSON Schema: `format: "color"` for `.hexColor()`; the others map to `format: "color"` only via `.hexColor()` — for OpenAPI consumers expecting strict format, prefer `.hexColor()`.
 
 ## Case mutators (pre-validation)
 
-| Method | Effect | Example |
-|---|---|---|
-| `.uppercase()` | "Hello" → "HELLO" | `v.string().uppercase()` |
-| `.lowercase()` | "Hello" → "hello" | — |
-| `.capitalize()` | "hello world" → "Hello world" | — |
-| `.titleCase()` | "hello world" → "Hello World" | — |
-| `.camelCase()` | "hello world" → "helloWorld" | — |
-| `.pascalCase()` | "hello world" → "HelloWorld" | — |
-| `.snakeCase()` | "hello world" → "hello_world" | — |
-| `.kebabCase()` | "hello world" → "hello-world" | — |
+| Method          | Effect                        | Example                  |
+| --------------- | ----------------------------- | ------------------------ |
+| `.uppercase()`  | "Hello" → "HELLO"             | `v.string().uppercase()` |
+| `.lowercase()`  | "Hello" → "hello"             | —                        |
+| `.capitalize()` | "hello world" → "Hello world" | —                        |
+| `.titleCase()`  | "hello world" → "Hello World" | —                        |
+| `.camelCase()`  | "hello world" → "helloWorld"  | —                        |
+| `.pascalCase()` | "hello world" → "HelloWorld"  | —                        |
+| `.snakeCase()`  | "hello world" → "hello_world" | —                        |
+| `.kebabCase()`  | "hello world" → "hello-world" | —                        |
 
 ## Trim & whitespace mutators
 
-| Method | Args | Effect |
-|---|---|---|
-| `.trim(needle?)` | default = space | trim both ends |
-| `.ltrim(needle?)` | — | trim left only |
-| `.rtrim(needle?)` | — | trim right only |
-| `.trimMultipleWhitespace()` | — | "a   b" → "a b" |
-| `.padStart(len, char?)` | char default = " " | left-pad to length |
-| `.padEnd(len, char?)` | char default = " " | right-pad to length |
+| Method                      | Args               | Effect              |
+| --------------------------- | ------------------ | ------------------- |
+| `.trim(needle?)`            | default = space    | trim both ends      |
+| `.ltrim(needle?)`           | —                  | trim left only      |
+| `.rtrim(needle?)`           | —                  | trim right only     |
+| `.trimMultipleWhitespace()` | —                  | "a b" → "a b"       |
+| `.padStart(len, char?)`     | char default = " " | left-pad to length  |
+| `.padEnd(len, char?)`       | char default = " " | right-pad to length |
 
 ## Replace, append, modify mutators
 
-| Method | Args | Example |
-|---|---|---|
-| `.replace(search, replace)` | string or RegExp + string | — |
-| `.replaceAll(search, replace)` | string or RegExp + string | — |
-| `.append(suffix)` | string | "foo" → "foobar" via `.append("bar")` |
-| `.prepend(prefix)` | string | "foo" → "barfoo" via `.prepend("bar")` |
-| `.reverse()` | — | "abc" → "cba" |
-| `.repeat(count)` | number | "ab" → "ababab" via `.repeat(3)` |
-| `.truncate(maxLen, suffix?)` | suffix default = "…" | "long text" → "long…" |
-| `.mask(start, end?, char?)` | char default = "*" | "1234567890" → "12******90" |
+| Method                         | Args                      | Example                                |
+| ------------------------------ | ------------------------- | -------------------------------------- |
+| `.replace(search, replace)`    | string or RegExp + string | —                                      |
+| `.replaceAll(search, replace)` | string or RegExp + string | —                                      |
+| `.append(suffix)`              | string                    | "foo" → "foobar" via `.append("bar")`  |
+| `.prepend(prefix)`             | string                    | "foo" → "barfoo" via `.prepend("bar")` |
+| `.reverse()`                   | —                         | "abc" → "cba"                          |
+| `.repeat(count)`               | number                    | "ab" → "ababab" via `.repeat(3)`       |
+| `.truncate(maxLen, suffix?)`   | suffix default = "…"      | "long text" → "long…"                  |
+| `.mask(start, end?, char?)`    | char default = "*"        | "1234567890" → "12******90"            |
 
 ## Filter mutators
 
-| Method | Effect |
-|---|---|
-| `.toAlpha()` | strip non-letters |
-| `.toAlphanumeric()` | strip non-alphanumerics |
-| `.removeSpecialCharacters()` | keep alphanumerics + whitespace |
-| `.removeNumbers()` | strip digits |
-| `.stripTags()` | strip HTML tags via a naive `<...>` regex — **not** an XSS sanitizer; `.safeHtml()` is a deprecated alias |
-| `.htmlEscape()` | `<` → `&lt;` etc |
-| `.unescapeHtml()` | reverse `htmlEscape()` |
+| Method                       | Effect                                                                                                    |
+| ---------------------------- | --------------------------------------------------------------------------------------------------------- |
+| `.toAlpha()`                 | strip non-letters                                                                                         |
+| `.toAlphanumeric()`          | strip non-alphanumerics                                                                                   |
+| `.removeSpecialCharacters()` | keep alphanumerics + whitespace                                                                           |
+| `.removeNumbers()`           | strip digits                                                                                              |
+| `.stripTags()`               | strip HTML tags via a naive `<...>` regex — **not** an XSS sanitizer; `.safeHtml()` is a deprecated alias |
+| `.htmlEscape()`              | `<` → `&lt;` etc                                                                                          |
+| `.unescapeHtml()`            | reverse `htmlEscape()`                                                                                    |
 
 ## Encoding mutators
 
-| Method | Effect |
-|---|---|
-| `.base64Encode()` | utf8 → base64 |
-| `.base64Decode()` | base64 → utf8 |
-| `.urlEncode()` | percent-encode |
-| `.urlDecode()` | percent-decode |
-| `.slug()` | "Hello World!" → "hello-world" |
-| `.toString()` | coerce non-string input to string |
+| Method            | Effect                            |
+| ----------------- | --------------------------------- |
+| `.base64Encode()` | utf8 → base64                     |
+| `.base64Decode()` | base64 → utf8                     |
+| `.urlEncode()`    | percent-encode                    |
+| `.urlDecode()`    | percent-decode                    |
+| `.slug()`         | "Hello World!" → "hello-world"    |
+| `.toString()`     | coerce non-string input to string |
 
 ## Mutator vs transformer
 
-The methods above are **all mutators** — they reshape the value *before* validation rules run. If you want post-validation reshaping, attach via `.addTransformer(fn)` (see the `compose-seal-modifiers` topic).
+The methods above are **all mutators** — they reshape the value _before_ validation rules run. If you want post-validation reshaping, attach via `.addTransformer(fn)` (see the `compose-seal-modifiers` topic).
 
-Practical implication: `v.string().min(3).trim()` runs `min(3)` against the *un-trimmed* input. To check trimmed length, mutate first: `v.string().trim().min(3)`.
+Practical implication: `v.string().min(3).trim()` runs `min(3)` against the _un-trimmed_ input. To check trimmed length, mutate first: `v.string().trim().min(3)`.
 
 ## Common chains
 
 ```ts
 // Email field
-v.string().email()
+v.string().email();
 
 // Username
-v.string().min(3).max(30).alphanumeric().lowercase()
+v.string().min(3).max(30).alphanumeric().lowercase();
 
 // Slug from title
-v.string().slug()
+v.string().slug();
 
 // Strong password
-v.string().strongPassword(12)
+v.string().strongPassword(12);
 
 // URL with strict format
-v.string().url().startsWith("https://")
+v.string().url().startsWith("https://");
 
 // Tag-stripped HTML body (not XSS-safe — sanitize with DOMPurify/sanitize-html before rendering untrusted rich text)
-v.string().stripTags().min(1)
+v.string().stripTags().min(1);
 
 // Masked phone for response
-v.string().pattern(/^\+\d{8,}$/).mask(3, -2)
+v.string()
+  .pattern(/^\+\d{8,}$/)
+  .mask(3, -2);
 
 // Optional with default
-v.string().email().default("guest@example.com").optional()
+v.string().email().default("guest@example.com").optional();
 ```
+
+The standalone `replaceMutator` and `replaceAllMutator` preserve the stringified
+value when called without a context or replacement options.

package/skills/seal-basics/SKILL.md

@@ -5,7 +5,7 @@ description: "Start here for @warlock.js/seal schemas, validation, parsing, and
 
 # Validate with seal
 
-Schema-first validation. Single entry point: the `v` factory. Every validator chains, composes, and infers. Schemas double as runtime validators *and* type-level shapes via `Infer<typeof schema>`, and ship `~standard` so any Standard-Schema-aware consumer accepts them directly.
+Schema-first validation. Single entry point: the `v` factory. Every validator chains, composes, and infers. Schemas double as runtime validators _and_ type-level shapes via `Infer<typeof schema>`, and ship `~standard` so any Standard-Schema-aware consumer accepts them directly.
 
 > This skill is the seal **map** — read it first, then load the specific skill for the task.
 
@@ -33,9 +33,9 @@ type User = Infer<typeof userSchema>;
 
 const result = await validate(userSchema, input);
 if (result.isValid) {
-  result.data;      // typed, post-transformer
+  result.data; // typed, post-transformer
 } else {
-  result.errors;    // [{ type, error, input }, ...]
+  result.errors; // [{ type, error, input }, ...]
 }
 ```
 
@@ -91,13 +91,13 @@ const schema = v.object({
   status: v.enum(Status).optional().default(Status.ACTIVE),
 });
 
-type In  = Infer.Input<typeof schema>;
+type In = Infer.Input<typeof schema>;
 // { email?: string; status?: Status }     ← caller may omit both
 
 type Out = Infer.Output<typeof schema>;
 // { email?: string; status: Status }      ← default fired for status
 
-type Default = Infer<typeof schema>;       // alias for Infer.Input
+type Default = Infer<typeof schema>; // alias for Infer.Input
 ```
 
 Both flavours widen with `| null` when `.nullable()` is set.
@@ -109,15 +109,15 @@ Both flavours widen with `| null` when `.nullable()` is set.
 
 ## Pick a skill
 
-| If the task is about… | Load |
-| --- | --- |
-| Picking the right primitive (`v.string` vs `v.scalar`, `v.literal` vs `v.enum`, `v.date` vs `v.instanceof(Date)`) | The `pick-seal-primitive` topic |
-| Building object / array / record / tuple / union schemas, discriminated unions, recursive schemas | The `define-structural-shape` topic |
-| Modifiers — `.required` / `.optional` / `.nullable` / `.default` / `.catch` / `.omit`, transformer vs mutator pipelines, membership rules | The `compose-seal-modifiers` topic |
-| Reading `ValidationResult`, branching on `error.type`, error message customization, translation | The `handle-seal-errors` topic |
-| Generating JSON Schema for OpenAI strict / OpenAPI / draft-07 | The `generate-json-schema` topic |
-| Why a `StandardSchemaV1<T>` slot accepts/rejects a schema, the phantom-intersection design, `Result<unknown>` errors | The `bridge-standard-schema` topic |
-| Authoring custom seal plugins to add validator methods | The `extend-seal-with-plugins` topic |
+| If the task is about…                                                                                                                                         | Load                                 |
+| ------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------ |
+| Picking the right primitive (`v.string` vs `v.scalar`, `v.literal` vs `v.enum`, `v.date` vs `v.instanceof(Date)`)                                             | The `pick-seal-primitive` topic      |
+| Building object / array / record / tuple / union schemas, discriminated unions, recursive schemas                                                             | The `define-structural-shape` topic  |
+| Modifiers — `.required` / `.optional` / `.nullable` / `.default` / `.catch` / `.omit`, transformer vs mutator pipelines, membership rules                     | The `compose-seal-modifiers` topic   |
+| Reading `ValidationResult`, branching on `error.type`, error message customization, translation                                                               | The `handle-seal-errors` topic       |
+| Generating JSON Schema for OpenAI strict / OpenAPI / draft-07                                                                                                 | The `generate-json-schema` topic     |
+| Why a `StandardSchemaV1<T>` slot accepts/rejects a schema, object input/output class parameters and primitive factory intersections, `Result<unknown>` errors | The `bridge-standard-schema` topic   |
+| Authoring custom seal plugins to add validator methods                                                                                                        | The `extend-seal-with-plugins` topic |
 
 ## Things NOT to do
 

package/cjs/object--LXRt5RF.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"object--LXRt5RF.cjs","names":["BaseValidator","BaseValidator","objectRule","unknownKeyRule","setKeyPath","wrapNullableStrict"],"sources":["../../../../../../../packages/seal/src/mutators/object-mutators.ts","../../../../../../../packages/seal/src/validators/computed-validator.ts","../../../../../../../packages/seal/src/validators/object-validator.ts","../../../../../../../packages/seal/src/object.ts"],"sourcesContent":["import { trim } from \"@mongez/reinforcements\";\nimport { isPlainObject } from \"@mongez/supportive-is\";\nimport type { Mutator } from \"../types\";\n\n/** Strip unknown keys from object */\nexport const stripUnknownMutator: Mutator = async (value, context) => {\n  const allowedKeys = [\n    ...(context?.ctx.schema ? Object.keys(context.ctx.schema) : []),\n    ...(context?.options.allowedKeys ?? []),\n  ];\n\n  const result: Record<string, any> = {};\n\n  for (const key in value) {\n    if (allowedKeys.includes(key)) {\n      result[key] = value[key];\n    }\n  }\n\n  return result;\n};\n\n/** Trim all string values in object */\nexport const objectTrimMutator: Mutator = async (value, context) => {\n  if (!isPlainObject(value)) return value;\n\n  const result: Record<string, any> = {};\n  const recursive = context?.options.recursive ?? false;\n\n  for (const key in value) {\n    const item = value[key];\n\n    if (recursive) {\n      if (Array.isArray(item)) {\n        result[key] = await Promise.all(\n          item.map(async (i: any) =>\n            typeof i === \"string\" ? trim(i) : await objectTrimMutator(i, context),\n          ),\n        );\n      } else if (isPlainObject(item)) {\n        result[key] = await objectTrimMutator(item, context);\n      } else {\n        result[key] = typeof item === \"string\" ? trim(item) : item;\n      }\n    } else {\n      result[key] = typeof item === \"string\" ? trim(item) : item;\n    }\n  }\n\n  return result;\n};\n\n/** Parse JSON string */\nexport const jsonMutator: Mutator = async (value) => {\n  try {\n    return JSON.parse(value);\n  } catch {\n    return value;\n  }\n};\n","import type { SchemaContext, ValidationResult } from \"../types\";\nimport { BaseValidator } from \"./base-validator\";\nimport type { JsonSchemaResult, JsonSchemaTarget } from \"../standard-schema/json-schema\";\n\n/**\n * Callback function for computed fields\n * Receives validated & mutated data and full schema context\n */\nexport type ComputedCallback<TResult = any> = (\n  data: any,\n  context: SchemaContext,\n) => TResult | Promise<TResult>;\n\n/**\n * Computed field validator\n *\n * Computes a value based on other validated fields in the schema.\n * The computed value is persisted and can optionally be validated.\n *\n * @example\n * ```ts\n * // Basic computed field\n * const schema = v.object({\n *   title: v.string().required(),\n *   slug: v.computed(data => slugify(data.title)),\n * });\n *\n * // With result validation\n * const schema = v.object({\n *   title: v.string().required(),\n *   slug: v.computed(\n *     data => slugify(data.title),\n *     v.string().minLength(3)\n *   ),\n * });\n *\n * // Async computation\n * const schema = v.object({\n *   image: v.string().url(),\n *   thumbnail: v.computed(async data => {\n *     return await generateThumbnail(data.image);\n *   }),\n * });\n * ```\n */\nexport class ComputedValidator<TResult = any> extends BaseValidator {\n  /**\n   * Create a new computed field validator\n   *\n   * @param callback - Function to compute the value from validated data\n   * @param resultValidator - Optional validator to validate the computed result\n   */\n  public constructor(\n    protected callback: ComputedCallback<TResult>,\n    protected resultValidator?: BaseValidator,\n  ) {\n    super();\n  }\n\n  /**\n   * Execute the callback and optionally validate the result\n   */\n  public async validate(data: any, context: SchemaContext): Promise<ValidationResult> {\n    try {\n      // Execute the callback with validated data\n      const result = await this.callback(data, context);\n\n      // Optionally validate the computed result\n      if (this.resultValidator) {\n        const validation = await this.resultValidator.validate(result, context);\n\n        if (!validation.isValid) {\n          return {\n            isValid: false,\n            errors: validation.errors,\n            data: undefined,\n          };\n        }\n\n        return {\n          isValid: true,\n          errors: [],\n          data: validation.data,\n        };\n      }\n\n      // No validation - return computed result directly\n      return {\n        isValid: true,\n        errors: [],\n        data: result,\n      };\n    } catch (error) {\n      // Handle callback execution errors\n      return {\n        isValid: false,\n        errors: [\n          {\n            type: \"computed\",\n            error: error instanceof Error ? error.message : \"Computed field callback failed\",\n            input: context.path,\n          },\n        ],\n        data: undefined,\n      };\n    }\n  }\n\n  /**\n   * Clone this validator with all its configuration\n   * Critical for ObjectValidator.clone(), extend(), merge(), etc.\n   */\n  public override clone(): this {\n    const cloned = super.clone();\n\n    // Copy ComputedValidator-specific properties\n    cloned.callback = this.callback; // Functions are safe to copy by reference\n    cloned.resultValidator = this.resultValidator?.clone(); // Deep clone validator\n\n    return cloned;\n  }\n\n  /**\n   * Computed fields don't have a specific type to match\n   */\n  public matchesType(value: any): boolean {\n    return true; // Computed fields accept any input (they generate their own value)\n  }\n\n  /**\n   * @inheritdoc\n   *\n   * Computed fields are server-side runtime values — they have no input schema\n   * and cannot be represented in JSON Schema. Calling this method is always a\n   * programming error.\n   *\n   * @throws Error Always throws — computed/managed fields have no JSON Schema representation.\n   */\n  public override toJsonSchema(_target: JsonSchemaTarget = \"draft-2020-12\"): JsonSchemaResult {\n    throw new Error(\n      `[Seal] toJsonSchema() is not supported on ComputedValidator / ManagedValidator. ` +\n      `Computed fields are runtime-only and have no input JSON Schema representation. ` +\n      `ObjectValidator.toJsonSchema() automatically skips computed fields — ` +\n      `do not call toJsonSchema() on a computed validator directly.`,\n    );\n  }\n}\n","import { except } from \"@mongez/reinforcements\";\nimport { isPlainObject } from \"@mongez/supportive-is\";\nimport { setKeyPath } from \"../helpers/path-helpers\";\nimport { objectTrimMutator, stripUnknownMutator } from \"../mutators/object-mutators\";\nimport { objectRule } from \"../rules/common/type-rules\";\nimport { unknownKeyRule } from \"../rules/common/unknown-key\";\nimport type { JsonSchemaResult, JsonSchemaTarget } from \"../standard-schema/json-schema\";\nimport { applyNullable, wrapNullableStrict } from \"../standard-schema/json-schema\";\nimport type { Schema, SchemaContext, ValidationResult } from \"../types\";\nimport type { InferInputObjectShape, InferOutputObjectShape } from \"../types/inference-types\";\nimport { BaseValidator } from \"./base-validator\";\nimport { ComputedValidator } from \"./computed-validator\";\n\n/**\n * Object validator class with generic schema type for proper type inference.\n *\n * Threads two distinct inferred shapes into `BaseValidator`'s `TInput`/`TOutput`:\n *\n * - `TInput`  = `InferInputObjectShape<TSchema>`  — what `~standard.validate()`\n *               accepts (caller's pre-validation payload; defaults/catches make\n *               keys optional)\n * - `TOutput` = `InferOutputObjectShape<TSchema>` — what `~standard.validate()`\n *               returns on success (post-default, post-catch shape; guaranteed\n *               keys are required)\n *\n * Both helpers are used directly (not the full `Infer.*` walker) to avoid a\n * recursive class-base evaluation that would otherwise occur when the\n * brand-aware widening tries to inspect the class type.\n */\nexport class ObjectValidator<TSchema extends Schema = Schema> extends BaseValidator<\n  InferInputObjectShape<TSchema>,\n  InferOutputObjectShape<TSchema>\n> {\n  protected shouldAllowUnknown = false;\n  protected allowedKeys: string[] = [];\n  protected hasUnknownKeyRule = false;\n\n  public constructor(\n    public schema: TSchema,\n    errorMessage?: string,\n  ) {\n    super();\n    this.addMutableRule(objectRule, errorMessage);\n  }\n\n  /**\n   * Check if value is an object type (plain object, not array or date)\n   */\n  public matchesType(value: any): boolean {\n    return isPlainObject(value);\n  }\n\n  /** Strip unknown keys from the data */\n  public stripUnknown() {\n    const validator = this.instance;\n    return validator.addMutator(stripUnknownMutator, {\n      get allowedKeys() {\n        return validator.allowedKeys;\n      },\n    });\n  }\n\n  /** Add list of allowed keys that could be in the data but not necessarily validated */\n  public allow(...keys: string[]) {\n    const validator = this.instance;\n    validator.allowedKeys.push(...keys);\n    return validator;\n  }\n\n  /** Trim values of the object properties */\n  public trim(recursive = true) {\n    const validator = this.instance;\n    return validator.addMutator(objectTrimMutator, { recursive });\n  }\n\n  /** Whether to allow unknown properties\n   * Please note it will allow only unknown direct children keys, not nested children keys\n   */\n  public allowUnknown(allow = true) {\n    const validator = this.instance;\n    validator.shouldAllowUnknown = allow;\n    return validator;\n  }\n\n  /**\n   * Create a copy of this object validator with the same configuration\n   * Copies schema, rules, mutators, transformers, and object-specific settings\n   *\n   * @returns A new ObjectValidator instance with copied configuration\n   *\n   * @example\n   * ```ts\n   * const baseUser = v.object({ name: v.string() }).allowUnknown();\n   * const userCopy = baseUser.clone();\n   * // userCopy has the same schema and allowUnknown setting\n   * ```\n   */\n  public override clone(keys?: string[]): this {\n    // Get cloned instance with all BaseValidator properties\n    const cloned = super.clone();\n\n    // Clone schema with deep copy of validators\n    const newSchema = {} as TSchema;\n    for (const [key, validator] of Object.entries(this.schema)) {\n      if (keys && !keys.includes(key)) continue;\n      (newSchema as Schema)[key] = validator.clone();\n    }\n\n    cloned.schema = newSchema;\n\n    // Add ObjectValidator-specific properties\n    cloned.shouldAllowUnknown = this.shouldAllowUnknown;\n    cloned.allowedKeys = [...this.allowedKeys];\n    // NOTE: hasUnknownKeyRule is intentionally NOT copied.\n    // Each clone must add its own unknownKeyRule on first validate()\n    // so it holds references to its own schema/allowedKeys, not the original's.\n\n    return cloned;\n  }\n\n  /**\n   * Extend this schema with additional fields\n   * Clones the current validator and adds new fields to the schema\n   * **Keeps original configuration** (allowUnknown, stripUnknown, etc.)\n   *\n   * If an ObjectValidator is provided, only its schema is used - its configuration is ignored.\n   * This is useful for creating reusable field collections that can be added to different schemas.\n   *\n   * @param schemaOrValidator - Plain schema object or ObjectValidator to extend with\n   * @returns A new ObjectValidator with merged schema and original configuration\n   *\n   * @example\n   * ```ts\n   * // Extend with plain schema\n   * const baseUser = v.object({\n   *   name: v.string().required(),\n   *   email: v.string().email().required()\n   * }).allowUnknown();\n   *\n   * const adminUser = baseUser.extend({\n   *   role: v.string().in(['admin', 'superadmin']).required()\n   * });\n   * // adminUser has: name, email, role\n   * // adminUser keeps: allowUnknown() from base ✅\n   *\n   * // Extend with ObjectValidator (only schema is used)\n   * const auditFields = v.object({\n   *   createdAt: v.date().required(),\n   *   updatedAt: v.date().required()\n   * }).stripUnknown(); // This config is ignored!\n   *\n   * const fullUser = baseUser.extend(auditFields);\n   * // fullUser has: name, email, createdAt, updatedAt\n   * // fullUser keeps: allowUnknown() from base (NOT stripUnknown from auditFields) ✅\n   *\n   * // Chain multiple extends\n   * const complexSchema = baseUser\n   *   .extend(auditFields)\n   *   .extend({ metadata: v.object({}) });\n   * ```\n   */\n  public extend<TExtension extends Schema>(\n    schemaOrValidator: TExtension | ObjectValidator<TExtension>,\n  ): ObjectValidator<TSchema & TExtension> {\n    // Clone current validator to preserve original\n    const extended = this.clone() as any;\n\n    // Extract schema from parameter\n    const schemaToAdd =\n      schemaOrValidator instanceof ObjectValidator ? schemaOrValidator.schema : schemaOrValidator;\n\n    // Merge schemas with cloned validators (later fields override earlier ones)\n    for (const [key, validator] of Object.entries(schemaToAdd)) {\n      (extended.schema as Schema)[key] = validator.clone();\n    }\n\n    return extended as ObjectValidator<TSchema & TExtension>;\n  }\n\n  /**\n   * Merge with another ObjectValidator\n   * Clones current validator, merges schemas, and **overrides configuration** with other validator's config\n   *\n   * Unlike extend(), merge() combines both schemas AND configurations.\n   * The other validator's configuration (allowUnknown, stripUnknown, etc.) takes precedence.\n   *\n   * @param validator - Another ObjectValidator to merge with\n   * @returns A new ObjectValidator with merged schema and configuration\n   *\n   * @example\n   * ```ts\n   * const baseUser = v.object({\n   *   name: v.string().required()\n   * }).allowUnknown();\n   *\n   * const timestamps = v.object({\n   *   createdAt: v.date().required(),\n   *   updatedAt: v.date().required()\n   * }).stripUnknown();\n   *\n   * const merged = baseUser.merge(timestamps);\n   * // merged has: name, createdAt, updatedAt\n   * // merged config: stripUnknown() from timestamps (overrides allowUnknown) ✅\n   *\n   * // Chain multiple merges\n   * const full = baseUser.merge(timestamps).merge(softDeleteSchema);\n   * ```\n   */\n  public merge<TMerge extends Schema>(\n    validator: ObjectValidator<TMerge>,\n  ): ObjectValidator<TSchema & TMerge> {\n    // Clone current validator\n    const merged = this.clone() as any;\n\n    // Merge schemas with cloned validators (later fields override earlier ones)\n    for (const [key, schemaValidator] of Object.entries(validator.schema)) {\n      (merged.schema as Schema)[key] = schemaValidator.clone();\n    }\n\n    // Override configuration with other validator's config\n    merged.shouldAllowUnknown = validator.shouldAllowUnknown;\n    merged.allowedKeys = [...merged.allowedKeys, ...validator.allowedKeys];\n\n    // Append rules, mutators, transformers from other validator\n    merged.rules.push(...validator.rules);\n    merged.mutators.push(...validator.mutators);\n    merged.dataTransformers.push(...validator.dataTransformers);\n\n    // Merge attributes text (later wins)\n    merged.attributesText = {\n      ...merged.attributesText,\n      ...validator.attributesText,\n    };\n\n    merged.translatedAttributes = {\n      ...merged.translatedAttributes,\n      ...validator.translatedAttributes,\n    };\n\n    return merged as ObjectValidator<TSchema & TMerge>;\n  }\n\n  /**\n   * Create a new schema with only the specified fields\n   * Clones the current validator and keeps only the selected fields\n   * **Preserves all configuration** (allowUnknown, stripUnknown, etc.)\n   *\n   * @param keys - Field names to keep in the schema\n   * @returns A new ObjectValidator with only the picked fields\n   *\n   * @example\n   * ```ts\n   * const fullUser = v.object({\n   *   id: v.int().required(),\n   *   name: v.string().required(),\n   *   email: v.string().email().required(),\n   *   password: v.string().required(),\n   *   role: v.string()\n   * }).allowUnknown();\n   *\n   * // For login - only need email and password\n   * const loginSchema = fullUser.pick('email', 'password');\n   * // loginSchema has: { email, password }\n   * // loginSchema keeps: allowUnknown() ✅\n   *\n   * // For public profile\n   * const publicSchema = fullUser.pick('id', 'name', 'role');\n   * // publicSchema has: { id, name, role }\n   * ```\n   */\n  public pick<K extends keyof TSchema>(...keys: K[]): ObjectValidator<Pick<TSchema, K>> {\n    // Clone current validator\n    const picked = this.clone() as any;\n\n    // Create new schema with only picked keys\n    const newSchema = {} as Pick<TSchema, K>;\n    for (const key of keys) {\n      if (key in picked.schema) {\n        (newSchema as any)[key] = picked.schema[key];\n      }\n    }\n\n    picked.schema = newSchema;\n\n    return picked as ObjectValidator<Pick<TSchema, K>>;\n  }\n\n  /**\n   * Mark all or the given schema fields as optional\n   */\n  public partial<K extends keyof TSchema>(...keys: K[]) {\n    const validationSchema = this.clone();\n\n    if (keys.length === 0) {\n      keys = Object.keys(validationSchema.schema) as K[];\n    }\n\n    for (const [key, validator] of Object.entries(validationSchema.schema)) {\n      if (keys.length === 0 || keys.includes(key as K)) {\n        (validationSchema.schema as Schema)[key] = validator.optional();\n      }\n    }\n\n    return validationSchema;\n  }\n\n  /**\n   * Make the all or the given fields as required\n   */\n  public requiredFields<K extends keyof TSchema>(...keys: K[]) {\n    const validationSchema = this.clone();\n\n    if (keys.length === 0) {\n      keys = Object.keys(validationSchema.schema) as K[];\n    }\n\n    for (const [key, validator] of Object.entries(validationSchema.schema)) {\n      if (keys.length === 0 || keys.includes(key as K)) {\n        (validationSchema.schema as Schema)[key] = validator.required();\n      }\n    }\n\n    return validationSchema;\n  }\n\n  /**\n   * Create a new schema excluding the specified fields\n   * Clones the current validator and removes the specified fields\n   * **Preserves all configuration** (allowUnknown, stripUnknown, etc.)\n   *\n   * @param keys - Field names to exclude from the schema\n   * @returns A new ObjectValidator without the excluded fields\n   *\n   * @example\n   * ```ts\n   * const fullUser = v.object({\n   *   id: v.int().required(),\n   *   name: v.string().required(),\n   *   email: v.string().email().required(),\n   *   password: v.string().required(),\n   *   role: v.string()\n   * }).allowUnknown();\n   *\n   * // For updates - exclude id\n   * const updateSchema = fullUser.without('id');\n   * // updateSchema has: { name, email, password, role }\n   * // updateSchema keeps: allowUnknown() ✅\n   *\n   * // For public API - exclude sensitive fields\n   * const publicSchema = fullUser.without('password', 'role');\n   * // publicSchema has: { id, name, email }\n   *\n   * // Combine with other methods\n   * const patchSchema = fullUser.without('id', 'password');\n   * // patchSchema has: { name, email, role }\n   * ```\n   */\n  public without<K extends keyof TSchema>(...keys: K[]): ObjectValidator<Omit<TSchema, K>> {\n    // Clone current validator\n    const filtered = this.clone() as any;\n\n    // Create new schema excluding specified keys\n    const newSchema = {} as Omit<TSchema, K>;\n    for (const key in filtered.schema) {\n      if (!keys.includes(key as any)) {\n        (newSchema as any)[key] = filtered.schema[key];\n      }\n    }\n\n    filtered.schema = newSchema;\n\n    return filtered as ObjectValidator<Omit<TSchema, K>>;\n  }\n\n  /** Mutate the data */\n  public mutate(data: any, context: SchemaContext) {\n    if (!isPlainObject(data)) return data;\n    return super.mutate({ ...data }, context);\n  }\n\n  /** Validate the data */\n  public async validate(\n    data: any,\n    context: SchemaContext = { path: \"\" } as SchemaContext,\n  ): Promise<ValidationResult> {\n    context.schema = this.schema;\n    const mutatedData = await this.mutate(data, context);\n\n    // Check for unknown properties\n    if (this.shouldAllowUnknown === false && !this.hasUnknownKeyRule) {\n      this.hasUnknownKeyRule = true;\n      const rule = this.addMutableRule(unknownKeyRule, undefined, {\n        allowedKeys: this.allowedKeys,\n        schema: this.schema,\n      });\n\n      this.setRuleAttributesList(rule);\n    }\n\n    const result = await super.validate(mutatedData, context);\n\n    if (result.isValid === false) return result;\n\n    // Absent (no default) or null (nullable) inputs short-circuit here —\n    // BaseValidator.validate already resolved the outcome, so recursing into\n    // the shape below would wrongly re-run required checks against `undefined`.\n    if (mutatedData === undefined || mutatedData === null) return result;\n\n    // ═══════════════════════════════════════════════════════════\n    // PHASE 1: Validate user input fields (skip computed/managed)\n    // ═══════════════════════════════════════════════════════════\n    const errors: ValidationResult[\"errors\"] = [];\n    const validatedData: any = {};\n\n    // Child validators settle in completion order, so errors are collected per\n    // field and flattened in declared schema order for deterministic output.\n    const fieldErrors: Array<ValidationResult[\"errors\"]> = [];\n\n    const userInputEntries = Object.entries(this.schema).filter(\n      ([, validator]) => !this.isComputedValidator(validator),\n    );\n\n    const validationPromises = userInputEntries.map(async ([key, validator], index) => {\n      const isPresent = mutatedData?.[key] !== undefined;\n      const value = isPresent ? mutatedData[key] : validator.getDefaultValue();\n\n      const childContext: SchemaContext = {\n        ...context,\n        parent: mutatedData,\n        value,\n        key,\n        path: setKeyPath(context.path, key),\n        valueIsDefault: !isPresent && value !== undefined,\n      };\n\n      const childResult = await validator.validate(value, childContext);\n\n      // Only include in validated data if not omitted\n      if (childResult.data !== undefined && !validator.isOmitted()) {\n        validatedData[key] = childResult.data;\n      }\n\n      if (childResult.isValid === false) {\n        fieldErrors[index] = childResult.errors;\n      }\n    });\n\n    await Promise.all(validationPromises);\n\n    for (const childErrors of fieldErrors) {\n      if (childErrors) {\n        errors.push(...childErrors);\n      }\n    }\n\n    // If Phase 1 failed, return early\n    if (errors.length > 0) {\n      return {\n        isValid: false,\n        errors,\n        data: undefined,\n      };\n    }\n\n    // ═══════════════════════════════════════════════════════════\n    // PHASE 2: Execute computed/managed fields with validated data\n    // ═══════════════════════════════════════════════════════════\n    const computedFields = this.getComputedFields();\n\n    const computedErrors: Array<ValidationResult[\"errors\"]> = [];\n\n    const computedPromises = Object.entries(computedFields).map(async ([key, validator], index) => {\n      const childContext: SchemaContext = {\n        ...context,\n        parent: validatedData,\n        value: undefined, // Computed fields don't have input value\n      };\n\n      // Execute computed callback with validated data\n      const childResult = await validator.validate(validatedData, childContext);\n\n      // Only include in final data if not omitted\n      if (childResult.data !== undefined && !validator.isOmitted()) {\n        validatedData[key] = childResult.data;\n      }\n\n      if (childResult.isValid === false) {\n        computedErrors[index] = childResult.errors;\n      }\n    });\n\n    await Promise.all(computedPromises);\n\n    for (const childErrors of computedErrors) {\n      if (childErrors) {\n        errors.push(...childErrors);\n      }\n    }\n\n    // If Phase 2 failed, return early\n    if (errors.length > 0) {\n      return {\n        isValid: false,\n        errors,\n        data: undefined,\n      };\n    }\n\n    // Fields were assigned in the order their validators finished; re-emit\n    // them in declared schema order so the output shape is deterministic.\n    const orderedData: any = {};\n\n    for (const key of Object.keys(this.schema)) {\n      if (key in validatedData) {\n        orderedData[key] = validatedData[key];\n      }\n    }\n\n    // Remove undefined values\n    const cleanedData = removeUndefinedValues(orderedData);\n\n    const transformedData = await this.startTransformationPipeline(cleanedData, context);\n\n    const output =\n      this.shouldAllowUnknown === false\n        ? transformedData\n        : {\n            ...transformedData,\n            ...except(mutatedData, Object.keys(this.schema)),\n          };\n\n    return {\n      isValid: true,\n      errors: [],\n      data: output,\n    };\n  }\n\n  /**\n   * Check if a validator is a computed or managed field\n   * ManagedValidator extends ComputedValidator, so instanceof catches both\n   */\n  private isComputedValidator(validator: BaseValidator): boolean {\n    return validator instanceof ComputedValidator;\n  }\n\n  /**\n   * Get all computed/managed fields from the schema\n   */\n  private getComputedFields(): Record<string, ComputedValidator> {\n    const computed: Record<string, ComputedValidator> = {};\n\n    for (const [key, validator] of Object.entries(this.schema)) {\n      if (validator instanceof ComputedValidator) {\n        computed[key] = validator;\n      }\n    }\n\n    return computed;\n  }\n\n  /**\n   * @inheritdoc\n   *\n   * Recursively generates JSON Schema for all input fields in the schema.\n   * Computed/managed fields are skipped — they have no input representation.\n   *\n   * **Standard targets** (`draft-2020-12`, `draft-07`, `openapi-3.0`):\n   * - Fields marked `.optional()` are excluded from `required`.\n   *\n   * **`openai-strict` target** (OpenAI Structured Outputs):\n   * - ALL fields appear in `required` — OpenAI rejects schemas with optional fields.\n   * - Optional fields are instead expressed as nullable types:\n   *   `{ type: [\"string\", \"null\"] }` so the model can output `null` for them.\n   * - Recursively applies `openai-strict` to all nested objects.\n   *\n   * @example\n   * ```ts\n   * v.object({\n   *   name: v.string().required(),\n   *   age: v.int().optional(),\n   * }).toJsonSchema(\"draft-2020-12\")\n   * // → { type: \"object\",\n   * //     properties: { name: { type: \"string\" }, age: { type: \"integer\" } },\n   * //     required: [\"name\"], additionalProperties: false }\n   *\n   * v.object({\n   *   name: v.string().required(),\n   *   age: v.int().optional(),\n   * }).toJsonSchema(\"openai-strict\")\n   * // → { type: \"object\",\n   * //     properties: { name: { type: \"string\" }, age: { type: [\"integer\", \"null\"] } },\n   * //     required: [\"name\", \"age\"],   ← all fields\n   * //     additionalProperties: false }\n   * ```\n   */\n  public override toJsonSchema(target: JsonSchemaTarget = \"draft-2020-12\"): JsonSchemaResult {\n    const properties: Record<string, JsonSchemaResult> = {};\n    const required: string[] = [];\n    const isOpenAIStrict = target === \"openai-strict\";\n\n    for (const [key, validator] of Object.entries(this.schema)) {\n      // Skip computed/managed — runtime-only, no input schema\n      if (validator instanceof ComputedValidator) continue;\n\n      let fieldSchema = validator.toJsonSchema(target);\n\n      if (isOpenAIStrict) {\n        // OpenAI strict: every field must be in required.\n        // Optional fields are expressed as nullable rather than absent.\n        if (validator.isOptional) {\n          fieldSchema = wrapNullableStrict(fieldSchema);\n        }\n        required.push(key);\n      } else {\n        // Standard JSON Schema: only non-optional fields go in required\n        if (!validator.isOptional) {\n          required.push(key);\n        }\n      }\n\n      properties[key] = fieldSchema;\n    }\n\n    const schema: JsonSchemaResult = { type: \"object\", properties };\n\n    if (required.length > 0) schema.required = required;\n    if (!this.shouldAllowUnknown) schema.additionalProperties = false;\n    if (this.isNullable) applyNullable(schema, target);\n\n    return schema;\n  }\n}\n\n/** Recursively remove undefined values from an object */\nfunction removeUndefinedValues(obj: any, visited = new WeakMap<object, any>()): any {\n  // Handle primitives and null\n  if (obj === null) {\n    return obj;\n  }\n\n  // Handle arrays\n  if (Array.isArray(obj)) {\n    return obj.map((item) => removeUndefinedValues(item, visited));\n  }\n\n  // Skip non-plain objects (class instances, Dates, Buffers, etc.)\n  if (!isPlainObject(obj)) {\n    return obj;\n  }\n\n  // Handle circular references - return already processed result\n  if (visited.has(obj)) {\n    return visited.get(obj);\n  }\n\n  // Process plain objects\n  const result: any = {};\n  visited.set(obj, result); // Mark as processing BEFORE recursion\n\n  for (const [key, value] of Object.entries(obj)) {\n    if (value !== undefined) {\n      result[key] = removeUndefinedValues(value, visited);\n    }\n  }\n\n  return result;\n}\n","import type { StandardSchemaV1 } from \"./standard-schema/types\";\nimport type { Schema } from \"./types\";\nimport type { Infer } from \"./types/inference-types\";\nimport { ObjectValidator } from \"./validators/object-validator\";\n\n// Keep both runtime chain methods and their declaration augmentations in\n// this standalone entry, without loading the complete validator factory.\nexport { equalityConditionalMethodsApplied } from \"./validators/methods/equality-conditional-methods\";\nexport { forbiddenMethodsApplied } from \"./validators/methods/forbidden-methods\";\nexport { presentMethodsApplied } from \"./validators/methods/present-methods\";\nexport { requiredMethodsApplied } from \"./validators/methods/required-methods\";\nexport { ObjectValidator };\n\n/** Create an object schema without importing the complete `v` factory. */\nexport const object = <T extends Schema>(schema: T, errorMessage?: string) =>\n  new ObjectValidator<T>(schema, errorMessage) as ObjectValidator<T> &\n    StandardSchemaV1<Infer<ObjectValidator<T>>>;\n"],"mappings":"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"}