zod-compiler 0.1.1 → 1.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 wakita181009
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,40 +1,393 @@
-<div align="center">
-  <h1>⚡ <code>zod-compiler</code> ⚡</h1>
-</div>
+# zod-compiler
 
-### Speed up your Zod schemas
-```ts
-import z from 'zod';
+**Compile Zod schemas into zero-overhead validation functions at build time.**
 
-const schema = z.object({
-	title: z.string().min(3).max(64),
-	tags: z.array(z.string()).optional(),
-	...
+Keep your existing Zod schemas. Get **2-64x faster** validation. No code changes required.
+
+```typescript
+// vite.config.ts — add one line
+import zodCompiler from "zod-compiler/vite";
+export default defineConfig({
+  plugins: [zodCompiler({ autoDiscover: true })],
+});
+```
+
+```typescript
+// src/schemas.ts — write plain Zod, nothing else
+import { z } from "zod";
+
+export const UserSchema = z.object({
+  name: z.string().min(3),
+  email: z.email(),
+  age: z.number().int().positive(),
+});
+
+// Use it anywhere — tRPC, Hono, React Hook Form, etc.
+// At build time, zod-compiler compiles it to a 3-64x faster validator.
+```
+
+## Install
+
+```bash
+npm install zod-compiler zod@^4
+```
+
+| Runtime | Version |
+| ------- | ------- |
+| Node.js | 20+     |
+| Bun     | 1.3+    |
+| Deno    | 2.0+    |
+
+## Usage
+
+There are three ways to use zod-compiler. Choose the one that fits your project.
+
+### 1. autoDiscover (Recommended)
+
+The plugin automatically detects and compiles all exported Zod schemas at build time. No wrappers, no imports from `zod-compiler` in your source code.
+
+**vite.config.ts:**
+
+```typescript
+import zodCompiler from "zod-compiler/vite";
+
+export default defineConfig({
+  plugins: [zodCompiler({ autoDiscover: true })],
+});
+```
+
+**Your schema file stays pure Zod:**
+
+```typescript
+// src/schemas.ts
+import { z } from "zod";
+
+export const CreateUserSchema = z.object({
+  name: z.string().min(1).max(100),
+  email: z.email(),
+  age: z.number().int().min(0).max(150),
+  role: z.enum(["admin", "editor", "viewer"]),
+});
+
+export const UpdateUserSchema = z.object({
+  name: z.string().min(1).max(100).optional(),
+  email: z.email().optional(),
+});
+
+export const ListUsersSchema = z.object({
+  page: z.number().int().min(1).optional().default(1),
+  limit: z.number().int().min(1).max(100).optional().default(20),
+});
+```
+
+**Use them as usual:**
+
+```typescript
+const user = CreateUserSchema.parse(data); // throws on failure
+const result = CreateUserSchema.safeParse(data); // { success, data/error }
+```
+
+At build time, the plugin:
+
+1. Finds every file with `import ... from "zod"` (skips type-only imports)
+2. Executes the file and detects exported Zod schemas
+3. Compiles each schema into an optimized validator
+4. Replaces the export with a tree-shakeable IIFE that preserves the full Zod API
+
+**What "preserves the full Zod API" means:** The compiled schema inherits from the original Zod schema via `Object.create()`. So `._zod`, `.shape`, Standard Schema (`~standard`), `instanceof` checks — all still work. Libraries that accept Zod schemas (tRPC, Hono, React Hook Form) work without changes.
+
+### 2. compile() (Explicit)
+
+If you prefer explicit opt-in, wrap specific schemas with `compile()`:
+
+```typescript
+import { z } from "zod";
+import { compile } from "zod-compiler";
+
+const UserSchema = z.object({
+  name: z.string().min(3),
+  email: z.email(),
 });
 
-// ❌ slow!
-const { success, data, error } = schema.safeParse(input);
+export const validateUser = compile(UserSchema);
+
+// In dev: falls back to Zod's runtime validation
+// After build: uses AOT-compiled optimized code
+validateUser.parse(data);
+validateUser.safeParse(data);
+```
+
+`compile()` and `autoDiscover` coexist — `compile()` schemas are detected first, then `autoDiscover` picks up remaining plain Zod exports.
 
-// 🚀
-import zc from 'zod-compiler';
-const compiledSchema = zc.compile(schema);
+### 3. CLI (No Bundler)
 
-const { success, data, error } = compiledSchema.safeParse(input);
+Generate optimized validation files from the command line:
+
+```bash
+# Single file
+npx zod-compiler generate src/schemas.ts -o src/schemas.compiled.ts
+
+# Directory
+npx zod-compiler generate src/ -o src/compiled/
+
+# Watch mode
+npx zod-compiler generate src/ --watch
 ```
 
-### Export your Zod schemas to TypeScript types
-```ts
-console.log(zc.types(schema));
-// export type Schema = {
-//     title: string;
-//     tags?: string[];
-//     ...
-// };
+## Build Plugin
+
+### Supported Build Tools
+
+| Build Tool | Import                                            |
+| ---------- | ------------------------------------------------- |
+| Vite       | `import zodCompiler from "zod-compiler/vite"`     |
+| webpack    | `import zodCompiler from "zod-compiler/webpack"`  |
+| esbuild    | `import zodCompiler from "zod-compiler/esbuild"`  |
+| Rollup     | `import zodCompiler from "zod-compiler/rollup"`   |
+| Rolldown   | `import zodCompiler from "zod-compiler/rolldown"` |
+| rspack     | `import zodCompiler from "zod-compiler/rspack"`   |
+| Bun        | `import zodCompiler from "zod-compiler/bun"`      |
+| Farm       | `import zodCompiler from "zod-compiler/farm"`     |
+
+### Options
+
+| Option         | Type                          | Default   | Description                                                                                                                                                                               |
+| -------------- | ----------------------------- | --------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `autoDiscover` | `boolean`                     | `false`   | Auto-detect all exported Zod schemas without `compile()`                                                                                                                                  |
+| `include`      | `string[]`                    | —         | Only process files matching these substrings                                                                                                                                              |
+| `exclude`      | `string[]`                    | —         | Skip files matching these substrings                                                                                                                                                      |
+| `zodCompat`    | `boolean`                     | `true`    | Preserve Zod API via `Object.create()`. Set `false` for smaller output                                                                                                                    |
+| `verbose`      | `boolean`                     | `false`   | Log per-schema compilation status during build                                                                                                                                            |
+| `apply`        | `"build" \| "serve" \| "all"` | `"build"` | **Vite only**: when the plugin runs. Defaults to production builds only — dev servers and Vitest use the Zod fallback (correct, just uncompiled). Set `"all"` to also compile in dev/test |
+
+```typescript
+zodCompiler({
+  autoDiscover: true,
+  include: ["src/schemas"],
+  verbose: true,
+});
 ```
 
-## Installation
-```shell
-$ npm i --save zod-compiler
+> **Note:** Vitest runs Vite in serve mode, so with the default `apply: "build"`
+> the plugin is inactive during tests and validators fall back to Zod. Pass
+> `apply: "all"` if your tests should exercise the compiled validators.
+
+### Bundle Size & Cross-File Dedup
+
+Generated validators share a small runtime helper layer (`__mkv` validator
+wrapper, issue factories like `__zaTS`/`__zaIT`, and well-known regexes for
+`email`, `uuid`, `cuid`, `ipv4`, etc.).
+
+On bundlers that support virtual modules — **Vite, Rollup, Rolldown, esbuild,
+Farm, Bun** — the plugin imports these helpers from
+`virtual:zod-compiler/runtime`, so the bundler emits a single bundle-wide copy
+regardless of how many files reference them. webpack and rspack fall back to
+self-contained file-level helpers (a few hundred bytes per file) since they
+reject the `virtual:` URI scheme at the resolver layer.
+
+The result: a 5-file project with 10 schemas all using `z.email()` and
+`z.uuid()` produces a bundle where each shared regex appears exactly **once**.
+Set `zodCompat: false` to additionally drop the original Zod schema reference
+when you don't need `instanceof` / `.shape` access on the compiled output.
+
+### autoDiscover: Side Effects Warning
+
+With `autoDiscover`, the plugin executes files to inspect their exports. If a file imports Zod AND has side effects (starts a server, connects to a database), those side effects run at build time.
+
+**Fix:** Use `include` to limit which files are scanned:
+
+```typescript
+zodCompiler({
+  autoDiscover: true,
+  include: ["src/schemas", "src/validators"],
+});
 ```
 
-Requires **Zod 3.x** and **TypeScript 5.x** to be installed.
+### autoDiscover vs compile()
+
+|                              | autoDiscover                        | compile()                                   |
+| ---------------------------- | ----------------------------------- | ------------------------------------------- |
+| Source code changes          | None                                | Wrap each schema                            |
+| `zod-compiler` import needed | No                                  | Yes                                         |
+| What gets compiled           | All exported Zod schemas            | Only wrapped schemas                        |
+| Build-time file execution    | Files with `import ... from "zod"`  | Files with `import ... from "zod-compiler"` |
+| Best for                     | New projects, framework integration | Gradual adoption, selective optimization    |
+
+## Framework Examples
+
+### tRPC
+
+```typescript
+// src/schemas.ts
+import { z } from "zod";
+
+export const CreateUserSchema = z.object({
+  name: z.string().min(1).max(100),
+  email: z.email(),
+  age: z.number().int().min(0).max(150),
+});
+
+// src/router.ts
+import { CreateUserSchema } from "./schemas";
+
+export const appRouter = t.router({
+  createUser: t.procedure.input(CreateUserSchema).mutation(({ input }) => createUser(input)),
+});
+```
+
+With `autoDiscover: true`, `CreateUserSchema` is compiled at build time. The tRPC router uses the optimized version automatically. No `.input(compile(CreateUserSchema))` needed.
+
+### Hono
+
+```typescript
+import { Hono } from "hono";
+import { zValidator } from "@hono/zod-validator";
+import { UserSchema } from "./schemas";
+
+const app = new Hono();
+
+app.post("/users", zValidator("json", UserSchema), (c) => {
+  const user = c.req.valid("json");
+  return c.json(user);
+});
+```
+
+### React Hook Form
+
+```typescript
+import { useForm } from "react-hook-form";
+import { zodResolver } from "@hookform/resolvers/zod";
+import { UserSchema } from "./schemas";
+
+function UserForm() {
+  const form = useForm({
+    resolver: zodResolver(UserSchema),
+  });
+  // ...
+}
+```
+
+### Any Standard Schema Consumer
+
+zod-compiler compiled schemas implement [Standard Schema](https://standardschema.dev) via prototype chain. Any library that accepts Standard Schema validators works automatically.
+
+## Schema Diagnostics
+
+Analyze your schemas before compiling — check coverage, Fast Path eligibility, and get actionable hints:
+
+```bash
+npx zod-compiler check src/schemas.ts
+```
+
+Output:
+
+```
+src/schemas.ts
+
+  CreateUserSchema  [Fast Path]  100% compiled  (5 checks)
+  ├─ name: string (min_length, max_length)
+  ├─ email: string (string_format[email])
+  ├─ age: number (number_format[safeint], greater_than)
+  └─ role: enum
+
+  OrderSchema  [Slow Path]  85% compiled  (3 checks)
+  ├─ id: string (string_format[uuid])
+  └─ metadata: object
+      └─ audit: fallback(transform)
+         Hint: Consider z.pipe() to keep inner schema compilable
+
+  Summary: 2 schemas | 1 Fast Path, 1 Slow Path | 8/9 nodes (88.9%)
+```
+
+### CI Integration
+
+```bash
+# JSON output
+npx zod-compiler check src/schemas.ts --json
+
+# Fail if any schema below 80% coverage
+npx zod-compiler check src/schemas.ts --json --fail-under 80
+```
+
+| Flag                 | Description                             |
+| -------------------- | --------------------------------------- |
+| `--json`             | Structured JSON output                  |
+| `--fail-under <pct>` | Exit code 1 if coverage below threshold |
+| `--no-color`         | Disable colored output                  |
+
+## What Gets Compiled
+
+### Fully Compiled (3-64x faster)
+
+`string`, `number`, `bigint`, `boolean`, `null`, `undefined`, `any`, `unknown`, `literal`, `enum`, `date`, `object`, `array`, `tuple`, `record`, `set`, `map`, `union`, `discriminatedUnion`, `intersection`, `pipe` (non-transform), `optional`, `nullable`, `readonly`, `default`, `catch`, `coerce`, `templateLiteral`, `symbol`, `void`, `nan`, `never`, `lazy` (self-recursive)
+
+All standard Zod checks are supported: `min`, `max`, `length`, `email`, `url`, `uuid`, `regex`, `int`, `positive`, `negative`, `multipleOf`, `int32`, `uint32`, `float32`, `float64`, `includes`, `startsWith`, `endsWith`, and more.
+
+### Falls Back to Zod (Still Works, Not Faster)
+
+These types contain JavaScript closures that cannot be compiled to static code:
+
+| Type                     | Why                                  | Alternative                             |
+| ------------------------ | ------------------------------------ | --------------------------------------- |
+| `transform`              | Runtime data transformation function | Use `z.pipe()` when possible            |
+| `refine` / `superRefine` | Custom validation closures           | Use built-in checks when possible       |
+| `custom`                 | Arbitrary validation logic           | —                                       |
+| `preprocess`             | Input preprocessing function         | Use `z.coerce` when possible            |
+| `lazy` (non-recursive)   | Cannot resolve inner type            | Use self-referencing lazy for recursion |
+
+**Partial fallback:** If an object has 10 properties and 1 uses `transform`, the other 9 are still compiled. Only the `transform` property falls back to Zod.
+
+**Tip:** Run `npx zod-compiler check` to see exactly which parts of your schemas are compiled and which fall back.
+
+## Benchmarks
+
+5-way comparison: **Zod v3** vs **Zod v4** vs **zod-compiler** vs **[Typia](https://typia.io/)** vs **[AJV](https://ajv.js.org/)**
+
+| Scenario                            | Zod v3 | Zod v4 | **zod-compiler** | Typia | AJV   | vs Zod v4 |
+| ----------------------------------- | ------ | ------ | ---------------- | ----- | ----- | --------- |
+| simple string                       | 8.7M   | 10.0M  | **11.0M**        | 11.0M | 11.1M | 1.1x      |
+| string (min/max)                    | 8.3M   | 6.0M   | **11.1M**        | 11.3M | 9.5M  | 1.8x      |
+| number (int+positive)               | 8.2M   | 5.8M   | **10.9M**        | 10.7M | 10.9M | 1.9x      |
+| enum                                | 8.0M   | 9.5M   | **10.6M**        | 10.6M | 10.5M | 1.1x      |
+| bigint (min/max)                    | 8.0M   | 6.0M   | **10.9M**        | —     | —     | 1.8x      |
+| tuple [string, int, bool]           | 4.0M   | 4.4M   | **10.5M**        | 10.8M | 10.5M | 2.4x      |
+| record\<string, number\>            | 2.3M   | 1.9M   | **5.4M**         | 7.5M  | 9.4M  | 2.8x      |
+| set\<string\> (5 items)             | 2.7M   | 1.6M   | **9.8M**         | —     | —     | 6.3x      |
+| set\<string\> (20 items)            | 1.0M   | 475K   | **7.7M**         | —     | —     | **16x**   |
+| map\<string, number\> (5 entries)   | 1.5M   | 946K   | **8.5M**         | —     | —     | 9.0x      |
+| map\<string, number\> (20 entries)  | 490K   | 238K   | **5.2M**         | —     | —     | **22x**   |
+| pipe (non-transform)                | 6.3M   | 3.8M   | **10.8M**        | —     | —     | 2.8x      |
+| discriminatedUnion (3 variants)     | 2.3M   | 2.9M   | **9.8M**         | 10.4M | 5.6M  | 3.4x      |
+| medium object (valid)               | 1.3M   | 1.7M   | **5.4M**         | 7.3M  | 5.0M  | 3.1x      |
+| medium object (invalid)             | 351K   | 65K    | **471K**         | 2.1M  | 5.6M  | 7.3x      |
+| large object (10 items)             | 82K    | 111K   | **4.0M**         | 4.1M  | 834K  | **36x**   |
+| large object (100 items)            | 9.0K   | 11.6K  | **676K**         | 808K  | 89K   | **58x**   |
+| recursive tree (7 nodes)            | 424K   | 1.5M   | **6.4M**         | 8.1M  | 3.1M  | 4.1x      |
+| recursive tree (121 nodes)          | 24K    | 101K   | **741K**         | 1.4M  | 250K  | 7.4x      |
+| event log (combined)                | 260K   | 479K   | **4.5M**         | —     | —     | 9.4x      |
+| partial fallback obj (transform)    | 817K   | 1.4M   | **3.3M**         | —     | —     | 2.3x      |
+| partial fallback arr 10 (transform) | 88K    | 139K   | **841K**         | —     | —     | 6.1x      |
+| partial fallback arr 50 (transform) | 18K    | 28K    | **175K**         | —     | —     | 6.3x      |
+
+_ops/s, higher is better. "—" = not supported by the library. Measured with `vitest bench` on Apple M-series._
+
+Performance scales with schema complexity. Nested objects and arrays see the biggest gains because zod-compiler eliminates per-node traversal overhead. `discriminatedUnion` uses O(1) `switch` dispatch instead of Zod's sequential trial. Partial fallback schemas (containing `transform`/`refine`) still show 2-6x speedups.
+
+```bash
+pnpm bench   # run locally
+```
+
+### Performance Architecture
+
+For eligible schemas, zod-compiler generates a **two-phase validator**:
+
+1. **Fast Path** — A single `&&` expression chain that validates the entire input with zero allocations. Valid input returns immediately.
+2. **Slow Path** — Error-collecting validation that only runs when the Fast Path fails.
+
+Additional optimizations: check ordering (cheap checks first), pre-compiled regex, Set-based enum lookups, small enum inlining (`===` for 1-3 values).
+
+Run `npx zod-compiler check --json` to see which schemas qualify for Fast Path.
+
+## Acknowledgements
+
+zod-compiler started as a fork of [zod-aot](https://github.com/wakita181009/zod-aot) by [@wakita181009](https://github.com/wakita181009). The compilation pipeline, build-plugin integration, and benchmark suite originate from that project.

package/dist/cli/commands/check.d.ts

@@ -0,0 +1,9 @@
+export interface CheckOptions {
+    inputs: string[];
+    json: boolean;
+    failUnder: number | undefined;
+    noColor: boolean;
+    autoDiscover: boolean;
+}
+export declare function runCheck(options: CheckOptions): Promise<void>;
+//# sourceMappingURL=check.d.ts.map

package/dist/cli/commands/check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"check.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/check.ts"],"names":[],"mappings":"AAiFA,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,IAAI,EAAE,OAAO,CAAC;IACd,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,EAAE,OAAO,CAAC;CACvB;AAED,wBAAsB,QAAQ,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAqHnE"}

package/dist/cli/commands/check.js

@@ -0,0 +1,150 @@
+import fs from "node:fs";
+import path from "node:path";
+import process from "node:process";
+import { diagnoseSchema } from "#src/core/diagnostic.js";
+import { extractSchema } from "#src/core/extract/index.js";
+import { discoverSchemas } from "#src/discovery.js";
+import { getErrorMessage } from "../errors.js";
+import { createColors, logger } from "../logger.js";
+// ─── Tree Rendering ─────────────────────────────────────────────────────────
+function renderTree(node, c, prefix = "", isLast = true) {
+    const lines = [];
+    const connector = prefix === "" ? "" : isLast ? "└─ " : "├─ ";
+    const childPrefix = prefix === "" ? "" : prefix + (isLast ? "   " : "│  ");
+    const statusIcon = node.status === "compiled" ? `${c.green}✓${c.reset}` : `${c.red}✗${c.reset}`;
+    const typeLabel = `${c.bold}${node.type}${c.reset}`;
+    const pathLabel = node.path && node.path !== "(root)" ? ` ${c.dim}${node.path}${c.reset}` : "";
+    const reasonLabel = node.status === "fallback" && node.reason ? ` ${c.yellow}(${node.reason})${c.reset}` : "";
+    lines.push(`${prefix}${connector}${statusIcon} ${typeLabel}${pathLabel}${reasonLabel}`);
+    if (node.status === "fallback" && node.hint) {
+        const hintPrefix = `${childPrefix}   `;
+        lines.push(`${hintPrefix}${c.dim}hint: ${node.hint}${c.reset}`);
+    }
+    for (const [i, child] of node.children.entries()) {
+        const last = i === node.children.length - 1;
+        lines.push(...renderTree(child, c, childPrefix, last));
+    }
+    return lines;
+}
+function buildJsonReport(filePath, results) {
+    return {
+        file: filePath,
+        schemas: results.map(({ exportName, diagnostic }) => {
+            const report = {
+                exportName,
+                coverage: {
+                    total: diagnostic.total,
+                    compilable: diagnostic.compilable,
+                    percent: diagnostic.coveragePct,
+                },
+                fastPath: { eligible: diagnostic.fastPathEligible },
+                fallbacks: diagnostic.fallbacks,
+            };
+            if (diagnostic.fastPathBlocker) {
+                report.fastPath.blocker = diagnostic.fastPathBlocker;
+            }
+            return report;
+        }),
+    };
+}
+export async function runCheck(options) {
+    // biome-ignore lint/suspicious/noConsole: CLI output
+    const out = console.log;
+    // biome-ignore lint/suspicious/noConsole: CLI output
+    const err = console.error;
+    const colorEnabled = !options.noColor && process.stdout.isTTY === true;
+    const c = createColors(colorEnabled);
+    const files = [];
+    for (const input of options.inputs) {
+        const absPath = path.resolve(input);
+        const stat = await fs.promises.stat(absPath).catch(() => null);
+        if (!stat) {
+            logger.error(`File not found: ${input}`);
+            process.exit(1);
+        }
+        if (stat.isDirectory()) {
+            logger.error("check command expects file paths, not directories.");
+            process.exit(1);
+        }
+        files.push(absPath);
+    }
+    const allJsonReports = [];
+    let minCoverage = 100;
+    let schemasProcessed = 0;
+    for (const filePath of files) {
+        const relPath = path.relative(process.cwd(), filePath);
+        let schemas;
+        try {
+            schemas = await discoverSchemas(filePath, { autoDiscover: options.autoDiscover });
+        }
+        catch (e) {
+            logger.error(`Failed to load ${relPath}: ${getErrorMessage(e)}`);
+            process.exit(1);
+        }
+        if (schemas.length === 0) {
+            const hint = options.autoDiscover
+                ? "no Zod schemas exported"
+                : "no compile() calls found (use --auto-discover to scan plain Zod exports)";
+            logger.warn(`${relPath}: ${hint}`);
+            continue;
+        }
+        const results = [];
+        for (const s of schemas) {
+            let ir;
+            try {
+                ir = extractSchema(s.schema);
+            }
+            catch (e) {
+                err(`${c.red}error${c.reset} Failed to extract "${s.exportName}" in ${relPath}: ${getErrorMessage(e)}`);
+                continue;
+            }
+            const diagnostic = diagnoseSchema(ir);
+            results.push({ exportName: s.exportName, diagnostic });
+            schemasProcessed++;
+            if (diagnostic.coveragePct < minCoverage) {
+                minCoverage = diagnostic.coveragePct;
+            }
+        }
+        if (options.json) {
+            allJsonReports.push(buildJsonReport(relPath, results));
+        }
+        else {
+            out(`\n${c.bold}${relPath}${c.reset}`);
+            for (const { exportName, diagnostic } of results) {
+                const pctColor = diagnostic.coveragePct === 100 ? c.green : c.yellow;
+                const fpLabel = diagnostic.fastPathEligible
+                    ? `${c.green}Fast Path: eligible${c.reset}`
+                    : `${c.yellow}Fast Path: ineligible${c.reset}${c.dim} (${diagnostic.fastPathBlocker})${c.reset}`;
+                out(`\n  ${c.cyan}${exportName}${c.reset} — ${pctColor}${diagnostic.coveragePct}%${c.reset} compiled (${diagnostic.compilable}/${diagnostic.total} nodes) | ${fpLabel}`);
+                const treeLines = renderTree(diagnostic.root, c, "    ");
+                for (const line of treeLines) {
+                    out(line);
+                }
+                if (diagnostic.fallbacks.length > 0) {
+                    out(`\n    ${c.yellow}Fallbacks:${c.reset}`);
+                    for (const fb of diagnostic.fallbacks) {
+                        out(`      ${c.red}✗${c.reset} ${fb.path} — ${fb.reason}`);
+                        out(`        ${c.dim}${fb.hint}${c.reset}`);
+                    }
+                }
+            }
+        }
+    }
+    if (options.json) {
+        out(JSON.stringify(allJsonReports, null, 2));
+    }
+    if (options.failUnder !== undefined) {
+        if (schemasProcessed === 0) {
+            logger.error("No schemas were analyzed — cannot satisfy --fail-under");
+            process.exit(1);
+        }
+        if (minCoverage < options.failUnder) {
+            logger.error(`Coverage ${minCoverage}% is below threshold ${options.failUnder}%`);
+            process.exit(1);
+        }
+    }
+    else if (schemasProcessed === 0) {
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=check.js.map

package/dist/cli/commands/check.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"check.js","sourceRoot":"","sources":["../../../src/cli/commands/check.ts"],"names":[],"mappings":"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"}

package/dist/cli/commands/generate.d.ts

@@ -0,0 +1,33 @@
+export interface GenerateOptions {
+    inputs: string[];
+    output: string | undefined;
+    zodCompat?: boolean | undefined;
+    autoDiscover?: boolean | undefined;
+}
+export interface GenerateFileResult {
+    filePath: string;
+    outputPath: string;
+    schemaCount: number;
+    schemaNames: string[];
+}
+/**
+ * Check if a filename is a schema file candidate.
+ * Shared filter logic used by both findSchemaFiles and isWatchTarget.
+ */
+export declare function isSchemaFile(fileName: string): boolean;
+/**
+ * Resolve input paths to a list of source files.
+ * If a path is a directory, find all .ts files (excluding .compiled.ts, .test.ts, node_modules).
+ */
+export declare function resolveInputFiles(inputs: string[]): Promise<string[]>;
+export declare function findSchemaFiles(dir: string): Promise<string[]>;
+/**
+ * Generate compiled output for a single source file.
+ * Returns null if no compile() calls are found.
+ */
+export declare function generateFile(filePath: string, outputFlag: string | undefined, options?: {
+    zodCompat?: boolean | undefined;
+    autoDiscover?: boolean | undefined;
+}): Promise<GenerateFileResult | null>;
+export declare function runGenerate(options: GenerateOptions): Promise<void>;
+//# sourceMappingURL=generate.d.ts.map

package/dist/cli/commands/generate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/generate.ts"],"names":[],"mappings":"AAWA,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,SAAS,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAChC,YAAY,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CACpC;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAStD;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAqB3E;AAED,wBAAsB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAmBpE;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAChC,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,OAAO,CAAC,EAAE;IACR,SAAS,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAChC,YAAY,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CACpC,GACA,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAwCpC;AAED,wBAAsB,WAAW,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CA8CzE"}