docs: clarify isZodRawShape only supports Zod values for auto-wrap

felixweinberger · felixweinberger · commit 9576f20b2936 · 2026-04-16T23:40:14.000Z
diff --git a/packages/core/src/util/standardSchema.ts b/packages/core/src/util/standardSchema.ts
@@ -139,9 +139,10 @@ export function isStandardSchemaWithJSON(schema: unknown): schema is StandardSch
 }
 
 /**
- * Detects a "raw shape" — a plain object whose values are Zod (or other
- * Standard Schema) field schemas, e.g. `{ name: z.string() }`. Powers the
- * auto-wrap in {@linkcode normalizeRawShapeSchema}.
+ * Detects a "raw shape" — a plain object whose values are Zod field schemas,
+ * e.g. `{ name: z.string() }`. Powers the auto-wrap in
+ * {@linkcode normalizeRawShapeSchema}, which wraps with `z.object()`, so only
+ * Zod values are supported even though the predicate accepts any Standard Schema.
  *
  * @internal
  */

Original file line number	Diff line number	Diff line change
`@@ -139,9 +139,10 @@ export function isStandardSchemaWithJSON(schema: unknown): schema is StandardSch`
`139`	`139`	`}`
`140`	`140`
`141`	`141`	`/**`
`142`		`- * Detects a "raw shape" — a plain object whose values are Zod (or other`
`143`		- * Standard Schema) field schemas, e.g. `{ name: z.string() }`. Powers the
`144`		`- * auto-wrap in {@linkcode normalizeRawShapeSchema}.`
	`142`	`+ * Detects a "raw shape" — a plain object whose values are Zod field schemas,`
	`143`	+ * e.g. `{ name: z.string() }`. Powers the auto-wrap in
	`144`	+ * {@linkcode normalizeRawShapeSchema}, which wraps with `z.object()`, so only
	`145`	`+ * Zod values are supported even though the predicate accepts any Standard Schema.`
`145`	`146`	`*`
`146`	`147`	`* @internal`
`147`	`148`	`*/`