How colinhacks/zod works
Zod is a TypeScript-first schema-validation library. The principal workflow is that a developer defines a schema, supplies input to its parse API, and receives validated, typed output or structured issues; async parsing is also supported. The v4 core provides schema construction, checks and parsing, with separate classic and mini APIs, JSON Schema conversion, and optional compilation. The repository also retains a v3 implementation. Edges for documented user-facing behavior cite the README; internal links rely on the supplied source excerpts or SOURCE INDEX references, so unsampled internals are not expanded into speculative call chains.
Main entry points: schemas.ts Schema Types · checks.ts Validation Checks · api.ts Schema Builders · compile.ts AOT Compiler
Components 19
Schema APIs
- Classic API
packages/zod/src/v4/classic/index.ts - Mini API
packages/zod/src/v4/mini/schemas.ts - Schema Builders
packages/zod/src/v4/core/api.ts
Validation Core
- Schema Types
packages/zod/src/v4/core/schemas.ts - Validation Checks
packages/zod/src/v4/core/checks.ts - Parser
packages/zod/src/v4/core/parse.ts - Issue Handling
packages/zod/src/v4/core/errors.ts - Format Patterns
packages/zod/src/v4/core/regexes.ts - Core Utilities
packages/zod/src/v4/core/util.ts - Schema Memoizer
packages/zod/src/v4/core/memoizer.ts - Schema Registry
packages/zod/src/v4/core/registries.ts
Output Extensions
- Standard Schema
packages/zod/src/v4/core/standard-schema.ts - JSON Schema
packages/zod/src/v4/core/to-json-schema.ts - JSON Schema Processing
packages/zod/src/v4/core/json-schema-processors.ts - AOT Compiler
packages/zod/src/v4/core/compile.ts - Compile Entry
packages/zod/src/compile.ts
Compatibility
- V3 Schemas
packages/zod/src/v3/types.ts - V3 Errors
packages/zod/src/v3/ZodError.ts
Other components
- Developer
Connections 20
- Developer → Classic API: defines schema
README.md - Developer → Classic API: submits input
README.md - Classic API → Schema Builders: builds schemas
- Mini API → Schema Types: builds schemas
packages/zod/src/v4/mini/schemas.ts - Schema Builders → Schema Types: constructs
packages/zod/src/v4/core/api.ts - Schema Builders → Validation Checks: constructs checks
packages/zod/src/v4/core/api.ts - Schema Types → Parser: invokes parser
packages/zod/src/v4/core/schemas.ts - Validation Checks → Schema Types: checks schema values
packages/zod/src/v4/core/checks.ts - Validation Checks → Format Patterns: uses patterns
packages/zod/src/v4/core/checks.ts - Validation Checks → Core Utilities: uses helpers
packages/zod/src/v4/core/checks.ts - Schema Types → Issue Handling: uses issue types
packages/zod/src/v4/core/schemas.ts - Schema Types → Core Utilities: uses helpers
packages/zod/src/v4/core/schemas.ts - Compile Entry → AOT Compiler: exposes compilation
packages/zod/src/compile.ts - AOT Compiler → Schema Memoizer: detects recursion
packages/zod/src/v4/core/compile.ts - AOT Compiler → Schema Types: compiles schemas
packages/zod/src/v4/core/compile.ts - JSON Schema → Schema Types: converts schemas
packages/zod/src/v4/core/schemas.ts - JSON Schema Processing → Schema Types: processes schemas
packages/zod/src/v4/core/schemas.ts - Schema Registry → Schema Types: registers metadata
packages/zod/src/v4/core/registries.ts - Developer → V3 Schemas: uses legacy API
- V3 Schemas → V3 Errors: reports validation issues