Improve library docs

Author: colinhacks

packages/docs/content/library-authors.mdx

@@ -190,17 +190,6 @@ inferSchema(z.string());
 // => ZodString
 ```
 
-The result is now fully and properly typed, you can extract & use the inferred type of the schema:
-
-```ts
-function parseData<T extends z.ZodTypeAny>(data: unknown, schema: T): z.output<T> {
-  return schema.parse(data);
-}
-
-parseData("sup", z.string());
-// => string
-```
-
 To constrain the input schema to a specific subclass:
 
 ```ts
@@ -231,3 +220,13 @@ inferSchema(z.number());
 // // Type 'number' is not assignable to type 'string'
 ```
 
+To parse data with the schema, use the top-level `z.parse`/`z.safeParse`/`z.parseAsync`/`z.safeParseAsync` functions. The `z.core.$ZodType` subclass has no methods on it. The usual parsing methods are implemented by Zod and Zod Mini, but are not available in Zod Core.
+
+```ts
+function parseData<T extends z.core.$ZodType>(data: unknown, schema: T): z.output<T> {
+  return z.parse(schema, data);
+}
+
+parseData("sup", z.string());
+// => string
+```

packages/zod/src/v4/locales/en.ts

@@ -73,7 +73,7 @@ const error: errors.$ZodErrorMap = (issue) => {
   switch (issue.code) {
     case "invalid_type":
       return `Invalid input: expected ${issue.expected}, received ${parsedType(issue.input)}`;
-    // return `Invalid input: expected ${issue.expected}, received ${util.getParsedType(issue.input)}`;
+
     case "invalid_value":
       if (issue.values.length === 1) return `Invalid input: expected ${util.stringifyPrimitive(issue.values[0])}`;
       return `Invalid option: expected one of ${util.joinValues(issue.values, "|")}`;

play.ts

@@ -1,3 +1,3 @@
 import { z } from "zod/v4";
 
-console.dir(z.string(), { depth: null });
+z;