attaform 0.15.0 → 0.16.0

package/dist/zod-v4.d.mts

@@ -0,0 +1,104 @@
+import { z } from 'zod';
+import { F as FormKey, b as AbstractSchema, U as UseFormConfiguration, G as GenericForm, D as DeepPartial, c as DefaultValuesShape, ae as ValidateOnConfig, d as UseFormReturnType } from './shared/attaform.0Gxd_OOx.mjs';
+export { n as FieldMetaPayload, ac as Unset, am as isUnset, ao as unset } from './shared/attaform.0Gxd_OOx.mjs';
+export { A as AttaformErrorCode, i as injectForm, u as useRegister } from './shared/attaform.CVv9Oh0a.mjs';
+export { f as fieldMeta, w as withMeta } from './shared/attaform.BAuJTWuT.mjs';
+import { a as AttaformError } from './shared/attaform.B7rzpK1U.mjs';
+import 'vue';
+
+/**
+ * Wrap a Zod v4 `ZodObject` schema in an `AbstractSchema` factory.
+ *
+ * Most consumers never call this directly — `useForm` from
+ * `attaform/zod` does the wrapping automatically. Reach for
+ * it when you need an adapter outside of `useForm` (e.g. validating
+ * data with the same library used elsewhere in the form runtime, or
+ * exposing the adapter to a custom integration).
+ *
+ * Throws if the schema isn't Zod v4, or contains kinds the adapter
+ * cannot represent (`z.promise`, `z.custom`, `z.templateLiteral`,
+ * recursive `z.lazy(...)`).
+ */
+declare function zodV4Adapter<FormSchema extends z.ZodObject, Form extends z.infer<FormSchema>>(rootSchema: FormSchema): (formKey: FormKey) => AbstractSchema<Form, Form>;
+
+/**
+ * Thrown when a Zod schema includes a kind the form library cannot
+ * represent: `z.promise`, `z.custom`, `z.templateLiteral`, or a
+ * recursive `z.lazy(...)` that loops back into itself.
+ *
+ * The error message includes the dotted path of the offending node
+ * so you can locate it without traversing the whole schema.
+ */
+declare class UnsupportedSchemaError extends AttaformError {
+}
+
+/**
+ * The single file that reads Zod v4's internal `def` shape. Every other
+ * file in the zod-v4 adapter uses these public-shaped accessors — future
+ * Zod minor bumps that reshape internals touch only this file.
+ *
+ * Design principle: treat `schema.def.*` as an unstable surface, even when
+ * Zod's docs say otherwise. Each helper returns a narrow, well-typed slice;
+ * no adapter code outside this file does shape-based pattern matching on
+ * `def`.
+ */
+
+/**
+ * Stable kind discriminant for a Zod v4 schema. Returned by
+ * `kindOf(schema)`. Use when building a custom integration that
+ * needs to branch on schema shape — most consumers don't need this.
+ */
+type ZodKind = 'object' | 'array' | 'set' | 'record' | 'tuple' | 'union' | 'discriminated-union' | 'string' | 'number' | 'boolean' | 'bigint' | 'date' | 'enum' | 'literal' | 'null' | 'undefined' | 'any' | 'unknown' | 'optional' | 'nullable' | 'default' | 'pipe' | 'readonly' | 'nan' | 'void' | 'never' | 'lazy' | 'intersection' | 'catch' | 'promise' | 'custom' | 'template-literal';
+/**
+ * Inspect a Zod v4 schema and return its `ZodKind`. Returns
+ * `'unknown'` for non-Zod inputs and unrecognised shapes.
+ *
+ * Useful when writing introspection helpers that branch on schema
+ * structure (e.g. custom error formatters or doc generators).
+ */
+declare function kindOf(schema: unknown): ZodKind;
+/**
+ * Verify a schema is Zod v4. Throws a clear error if it's a v3
+ * schema mistakenly imported through `attaform/zod`.
+ *
+ * Most consumers never call this directly — the v4 adapter calls it
+ * internally on every schema. Reach for it only when wiring a custom
+ * adapter that needs the same guard.
+ */
+declare function assertZodVersion(schema: unknown): void;
+
+/**
+ * Zod v4 adapter entry point. Re-exports the adapter + the useForm
+ * wrapper that threads zod-v4-specific schema types through
+ * useAbstractForm.
+ */
+
+/**
+ * Create a form bound to a Zod v4 schema.
+ *
+ * ```ts
+ * import { useForm } from 'attaform/zod'
+ * import { z } from 'zod'
+ *
+ * const form = useForm({
+ *   schema: z.object({
+ *     email: z.email(),
+ *     password: z.string().min(8),
+ *   }),
+ *   defaultValues: { email: '' },
+ * })
+ * ```
+ *
+ * Returns a form API exposing `register`, `values`, `errors`,
+ * `fields`, `setValue`, `handleSubmit`, `meta`, field-array
+ * helpers, and more. See `UseFormReturnType` for the full
+ * surface.
+ *
+ * For Zod v3, import from `attaform/zod-v3` instead.
+ */
+declare function useForm<Schema extends z.ZodObject>(configuration: Omit<UseFormConfiguration<z.output<Schema> extends GenericForm ? z.output<Schema> : never, z.output<Schema> extends GenericForm ? z.output<Schema> : never, AbstractSchema<z.output<Schema> extends GenericForm ? z.output<Schema> : never, z.output<Schema> extends GenericForm ? z.output<Schema> : never>, DeepPartial<DefaultValuesShape<z.output<Schema> extends GenericForm ? z.output<Schema> : never>>>, 'schema' | 'validateOn' | 'debounceMs'> & {
+    schema: Schema;
+} & ValidateOnConfig): UseFormReturnType<z.output<Schema> extends GenericForm ? z.output<Schema> : never, z.output<Schema> extends GenericForm ? z.output<Schema> : never>;
+
+export { UnsupportedSchemaError, assertZodVersion, kindOf, useForm, zodV4Adapter as zodAdapter };
+export type { ZodKind };

package/dist/zod-v4.d.ts

@@ -0,0 +1,104 @@
+import { z } from 'zod';
+import { F as FormKey, b as AbstractSchema, U as UseFormConfiguration, G as GenericForm, D as DeepPartial, c as DefaultValuesShape, ae as ValidateOnConfig, d as UseFormReturnType } from './shared/attaform.0Gxd_OOx.js';
+export { n as FieldMetaPayload, ac as Unset, am as isUnset, ao as unset } from './shared/attaform.0Gxd_OOx.js';
+export { A as AttaformErrorCode, i as injectForm, u as useRegister } from './shared/attaform.CWCx2r0x.js';
+export { f as fieldMeta, w as withMeta } from './shared/attaform.ls_7jBYc.js';
+import { a as AttaformError } from './shared/attaform.B7rzpK1U.js';
+import 'vue';
+
+/**
+ * Wrap a Zod v4 `ZodObject` schema in an `AbstractSchema` factory.
+ *
+ * Most consumers never call this directly — `useForm` from
+ * `attaform/zod` does the wrapping automatically. Reach for
+ * it when you need an adapter outside of `useForm` (e.g. validating
+ * data with the same library used elsewhere in the form runtime, or
+ * exposing the adapter to a custom integration).
+ *
+ * Throws if the schema isn't Zod v4, or contains kinds the adapter
+ * cannot represent (`z.promise`, `z.custom`, `z.templateLiteral`,
+ * recursive `z.lazy(...)`).
+ */
+declare function zodV4Adapter<FormSchema extends z.ZodObject, Form extends z.infer<FormSchema>>(rootSchema: FormSchema): (formKey: FormKey) => AbstractSchema<Form, Form>;
+
+/**
+ * Thrown when a Zod schema includes a kind the form library cannot
+ * represent: `z.promise`, `z.custom`, `z.templateLiteral`, or a
+ * recursive `z.lazy(...)` that loops back into itself.
+ *
+ * The error message includes the dotted path of the offending node
+ * so you can locate it without traversing the whole schema.
+ */
+declare class UnsupportedSchemaError extends AttaformError {
+}
+
+/**
+ * The single file that reads Zod v4's internal `def` shape. Every other
+ * file in the zod-v4 adapter uses these public-shaped accessors — future
+ * Zod minor bumps that reshape internals touch only this file.
+ *
+ * Design principle: treat `schema.def.*` as an unstable surface, even when
+ * Zod's docs say otherwise. Each helper returns a narrow, well-typed slice;
+ * no adapter code outside this file does shape-based pattern matching on
+ * `def`.
+ */
+
+/**
+ * Stable kind discriminant for a Zod v4 schema. Returned by
+ * `kindOf(schema)`. Use when building a custom integration that
+ * needs to branch on schema shape — most consumers don't need this.
+ */
+type ZodKind = 'object' | 'array' | 'set' | 'record' | 'tuple' | 'union' | 'discriminated-union' | 'string' | 'number' | 'boolean' | 'bigint' | 'date' | 'enum' | 'literal' | 'null' | 'undefined' | 'any' | 'unknown' | 'optional' | 'nullable' | 'default' | 'pipe' | 'readonly' | 'nan' | 'void' | 'never' | 'lazy' | 'intersection' | 'catch' | 'promise' | 'custom' | 'template-literal';
+/**
+ * Inspect a Zod v4 schema and return its `ZodKind`. Returns
+ * `'unknown'` for non-Zod inputs and unrecognised shapes.
+ *
+ * Useful when writing introspection helpers that branch on schema
+ * structure (e.g. custom error formatters or doc generators).
+ */
+declare function kindOf(schema: unknown): ZodKind;
+/**
+ * Verify a schema is Zod v4. Throws a clear error if it's a v3
+ * schema mistakenly imported through `attaform/zod`.
+ *
+ * Most consumers never call this directly — the v4 adapter calls it
+ * internally on every schema. Reach for it only when wiring a custom
+ * adapter that needs the same guard.
+ */
+declare function assertZodVersion(schema: unknown): void;
+
+/**
+ * Zod v4 adapter entry point. Re-exports the adapter + the useForm
+ * wrapper that threads zod-v4-specific schema types through
+ * useAbstractForm.
+ */
+
+/**
+ * Create a form bound to a Zod v4 schema.
+ *
+ * ```ts
+ * import { useForm } from 'attaform/zod'
+ * import { z } from 'zod'
+ *
+ * const form = useForm({
+ *   schema: z.object({
+ *     email: z.email(),
+ *     password: z.string().min(8),
+ *   }),
+ *   defaultValues: { email: '' },
+ * })
+ * ```
+ *
+ * Returns a form API exposing `register`, `values`, `errors`,
+ * `fields`, `setValue`, `handleSubmit`, `meta`, field-array
+ * helpers, and more. See `UseFormReturnType` for the full
+ * surface.
+ *
+ * For Zod v3, import from `attaform/zod-v3` instead.
+ */
+declare function useForm<Schema extends z.ZodObject>(configuration: Omit<UseFormConfiguration<z.output<Schema> extends GenericForm ? z.output<Schema> : never, z.output<Schema> extends GenericForm ? z.output<Schema> : never, AbstractSchema<z.output<Schema> extends GenericForm ? z.output<Schema> : never, z.output<Schema> extends GenericForm ? z.output<Schema> : never>, DeepPartial<DefaultValuesShape<z.output<Schema> extends GenericForm ? z.output<Schema> : never>>>, 'schema' | 'validateOn' | 'debounceMs'> & {
+    schema: Schema;
+} & ValidateOnConfig): UseFormReturnType<z.output<Schema> extends GenericForm ? z.output<Schema> : never, z.output<Schema> extends GenericForm ? z.output<Schema> : never>;
+
+export { UnsupportedSchemaError, assertZodVersion, kindOf, useForm, zodV4Adapter as zodAdapter };
+export type { ZodKind };

package/dist/zod-v4.mjs

@@ -0,0 +1,4 @@
+export { U as UnsupportedSchemaError, a as assertZodVersion, f as fieldMeta, k as kindOf, u as useForm, w as withMeta, z as zodAdapter } from './shared/attaform.CvOXSpCb.mjs';
+export { A as AttaformErrorCode, i as injectForm, a as isUnset, u as unset } from './shared/attaform.DILbdvfo.mjs';
+export { u as useRegister } from './shared/attaform.BfMxsfmE.mjs';
+//# sourceMappingURL=zod-v4.mjs.map

package/dist/zod-v4.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"zod-v4.mjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;"}