@jayoncode/form-intelligence-zod

Form Intelligence — Zod

Bridge Zod schemas into @jayoncode/form-intelligence.

The problem

Your API already speaks Zod, but the form keeps a second copy of the rules (required, email(), custom checks). Schemas drift; the UI rejects what the server accepts (or the opposite).

The solution

zodAdapter(schema) plugs a Zod object into createForm({ schema }). One schema for types, parse, and field errors — while Form Intelligence still runs rules, drafts, wizards, and submit.

What you get

Capability	Detail
Drop-in schema	schema: zodAdapter(z.object({ ... }))
Path mapping	Zod issue paths → form paths (address.city); form-level → _form
Nested objects	Works with object / array-shaped issues
With core workflows	Combine with rules, workflow.autosave, validateOn, onSubmit, plugins
Typed values	Keep inferring types from your Zod schema in app code

Does not replace Form Intelligence — it feeds the validation pipeline so you don’t re-encode constraints.

Behavior notes

• First error per path wins. safeParseAsync can report multiple issues for the same path; only the first one encountered is kept.
• Validate-only. zodAdapter() returns a SchemaAdapter — it validates values and returns { path: message }. It does not make createForm infer TValues from your Zod schema; keep inferring types in your own code with z.infer<typeof schema> and pass them via initialValues / the TValues generic.

Install

npm install @jayoncode/form-intelligence @jayoncode/form-intelligence-zod zod

Usage

import { createForm, when } from "@jayoncode/form-intelligence";
import { zodAdapter } from "@jayoncode/form-intelligence-zod";
import { z } from "zod";

const checkoutSchema = z.object({
  plan: z.enum(["starter", "enterprise"]),
  email: z.string().email(),
  seatCount: z.number().int().positive().optional(),
});

const form = createForm({
  initialValues: { plan: "starter", email: "", seatCount: undefined },
  schema: zodAdapter(checkoutSchema),
  validateOn: "onBlur",
  rules: [when("plan").equals("enterprise").show("seatCount").require("seatCount")],
  workflow: {
    autosave: { enabled: true, debounceMs: 800, onSave: (v) => api.saveDraft(v) },
  },
  async onSubmit(values) {
    await api.checkout(values);
  },
});

Docs

https://itsjayoncode.github.io/joc/packages/form-intelligence/modules/adapters

License

MIT JayOnCode