react-form-action 2.11.0 → 2.12.0

package/dist/client.d.mts

@@ -1,4 +1,4 @@
-import { a as InvalidState, i as InitialState, n as FailureState, o as SuccessState, r as FormAction, t as ActionState } from "./createFormAction-4p5Fvn2A.mjs";
+import { a as FormAction, c as SuccessState, i as FailureState, o as InitialState, r as ActionState, s as InvalidState, t as Flatten } from "./formAction-0eiUHrXx.mjs";
 import React$1, { JSX, PropsWithChildren } from "react";
 import { $ZodErrorTree } from "zod/v4/core";
 //#region src/Action.d.ts
@@ -21,13 +21,13 @@ type ActionStatusFlags<T extends ActionState<unknown, unknown, unknown>["type"]
   isFailure: T extends "failure" ? true : false;
   isSuccess: T extends "success" ? true : false;
 };
-type ActionContextState<T extends ActionState<unknown, unknown, unknown>> = T & ActionStatusFlags<T["type"]> & {
+type ActionContextState<T extends ActionState<unknown, unknown, unknown>> = Flatten<T & ActionStatusFlags<T["type"]> & {
   /**
    * The dispatch function returned from React.useActionState()
    */
   action: (payload: FormData) => void;
   isPending: boolean;
-};
+}>;
 /**
  * NOTE: ActionContextState<ActionState<...>> would not allow discriminate the union inside of the ActionState.
  */
@@ -58,13 +58,17 @@ declare const noError: Readonly<{
 declare function ZodFieldError<Errors extends $ZodErrorTree<object>, Name extends "" | InferZodErrorPaths<Errors> = "">({ errors, name, children }: ZodFieldErrorProps<Errors, Name>): React$1.ReactNode;
 //#endregion
 //#region src/createComponents.d.ts
+type Reducers<State = unknown> = Record<string, (state: State) => unknown>;
+type InferFieldProps<T extends Reducers<any>> = { [K in keyof T]: ReturnType<T[K]>; };
 /**
  * Creates a typed components for actions created with the formAction builder.
  */
-declare function createComponents<Data, Error, ValidationError extends $ZodErrorTree<any>, Args extends unknown[] = []>(action: FormAction<Data, Error, ValidationError, FormData, Args>): {
+declare function createComponents<Data, Error, ValidationError extends $ZodErrorTree<any>, Args extends unknown[] = [], FieldReducers extends Reducers<SpreadActionContext<Data, Error, ValidationError>> = Reducers<SpreadActionContext<Data, Error, ValidationError>>>(action: FormAction<Data, Error, ValidationError, FormData, Args>, options?: {
+  fieldProps?: FieldReducers;
+}): {
   FieldError: <Name extends "" | InferZodErrorPaths<ValidationError>>({ name, children }: {
     name: Name;
-    children?: (props: ZodFieldErrorChildrenProps<Name>) => React$1.ReactNode;
+    children?: (props: Flatten<ZodFieldErrorChildrenProps<Name> & InferFieldProps<FieldReducers>>) => React$1.ReactNode;
   }) => React$1.JSX.Element;
   Success: ({ children }: PropsWithChildren | {
     children?: (props: {
@@ -108,4 +112,4 @@ declare function Pending({ children }: PropsWithChildren | {
   }) => React.ReactNode;
 }): import("react").ReactNode;
 //#endregion
-export { Action, ActionContextState, ActionProps, Form, FormProps, InferZodErrorPaths, Paths, Pending, ZodFieldError, ZodFieldErrorChildrenProps, ZodFieldErrorProps, createComponents, noError, useActionContext };
+export { Action, ActionContextState, ActionProps, Form, FormProps, InferZodErrorPaths, Paths, Pending, SpreadActionContext, ZodFieldError, ZodFieldErrorChildrenProps, ZodFieldErrorProps, createComponents, noError, useActionContext };

package/dist/client.mjs

@@ -1 +1 @@
-"use client";import{n as e,t}from"./createFormAction-BwMYAzm2.mjs";import{createContext as n,startTransition as r,use as i,useActionState as a}from"react";import{Fragment as o,jsx as s}from"react/jsx-runtime";const c={isInitial:!1,isInvalid:!1,isFailure:!1,isSuccess:!1},l=n(null);function u(e){let t=i(l);if(!t)throw Error(`ActionContext must be initialized before use. Is your useActionContext hook wrapped with an <Action> Component?`);return t}function d({children:n,action:r,initialData:i,args:o,permalink:u,validate:d}){let f=o?r.bind(null,...o):r,[p,m,h]=a(async(e,n)=>{if(d){let r=await t(({invalid:e,success:t})=>async(n,r)=>{let i=d(r);return i?e(i):t(!0)})(e,n);if(r.type===`invalid`)return r}return f(e,n)},e(i),u),g=p.type===`initial`?{...p,...c,action:m,isPending:h,isInitial:!0}:p.type===`invalid`?{...p,...c,action:m,isPending:h,isInvalid:!0}:p.type===`failure`?{...p,...c,action:m,isPending:h,isFailure:!0}:{...p,...c,action:m,isPending:h,isSuccess:!0};return s(l,{value:g,children:n})}const f=Object.freeze({errors:Object.freeze([])});function p({errors:e,name:t,children:n=({error:e})=>s(o,{children:e})}){if(t.length===0)return n({name:t,error:e.errors[0],errors:e.errors});let r=t.split(`.`),i=e;for(let e of r){if(!i.properties){i=f;break}i=i.properties[e]??f}return n({name:t,error:i.errors[0],errors:i.errors})}function m(e){function t({name:t,children:n}){let{isInvalid:r,validationError:i}=u(e);return s(p,{errors:i??f,name:t,children:n??(({error:e})=>r&&s(o,{children:e}))})}function n({children:t}){let{isSuccess:n,data:r}=u(e);return typeof t==`function`?t({isSuccess:n,data:r}):n&&t}function r({children:t}){let{isInvalid:n,validationError:r}=u(e);return typeof t==`function`?t({isInvalid:n,validationError:r}):n&&t}return{FieldError:t,Success:n,Invalid:r}}function h({autoReset:e=!1,...t}){let{action:n}=u();return s(`form`,{...e?{action:n}:{onSubmit:e=>{e.preventDefault();let t=e.currentTarget;r(()=>{n(new FormData(t))})}},...t})}function g({children:e}){let{isPending:t}=u();return typeof e==`function`?e({isPending:t}):t&&e}export{d as Action,h as Form,g as Pending,p as ZodFieldError,m as createComponents,f as noError,u as useActionContext};
+"use client";import{n as e,t}from"./createFormAction-BwMYAzm2.mjs";import{createContext as n,startTransition as r,use as i,useActionState as a}from"react";import{Fragment as o,jsx as s}from"react/jsx-runtime";const c={isInitial:!1,isInvalid:!1,isFailure:!1,isSuccess:!1},l=n(null);function u(e){let t=i(l);if(!t)throw Error(`ActionContext must be initialized before use. Is your useActionContext hook wrapped with an <Action> Component?`);return t}function d({children:n,action:r,initialData:i,args:o,permalink:u,validate:d}){let f=o?r.bind(null,...o):r,[p,m,h]=a(async(e,n)=>{if(d){let r=await t(({invalid:e,success:t})=>async(n,r)=>{let i=d(r);return i?e(i):t(!0)})(e,n);if(r.type===`invalid`)return r}return f(e,n)},e(i),u),g=p.type===`initial`?{...p,...c,action:m,isPending:h,isInitial:!0}:p.type===`invalid`?{...p,...c,action:m,isPending:h,isInvalid:!0}:p.type===`failure`?{...p,...c,action:m,isPending:h,isFailure:!0}:{...p,...c,action:m,isPending:h,isSuccess:!0};return s(l,{value:g,children:n})}const f=Object.freeze({errors:Object.freeze([])});function p({errors:e,name:t,children:n=({error:e})=>s(o,{children:e})}){if(t.length===0)return n({name:t,error:e.errors[0],errors:e.errors});let r=t.split(`.`),i=e;for(let e of r){if(!i.properties){i=f;break}i=i.properties[e]??f}return n({name:t,error:i.errors[0],errors:i.errors})}function m(e,t={}){function n({name:n,children:r}){let i=u(e),{isInvalid:a,validationError:c}=i,l=({error:e})=>a&&s(o,{children:e}),d=Object.fromEntries(Object.entries(t.fieldProps??{}).map(([e,t])=>[e,t(i)])),m=r??l;return s(p,{errors:c??f,name:n,children:e=>m({...e,...d})})}function r({children:t}){let{isSuccess:n,data:r}=u(e);return typeof t==`function`?t({isSuccess:n,data:r}):n&&t}function i({children:t}){let{isInvalid:n,validationError:r}=u(e);return typeof t==`function`?t({isInvalid:n,validationError:r}):n&&t}return{FieldError:n,Success:r,Invalid:i}}function h({autoReset:e=!1,...t}){let{action:n}=u();return s(`form`,{...e?{action:n}:{onSubmit:e=>{e.preventDefault();let t=e.currentTarget;r(()=>{n(new FormData(t))})}},...t})}function g({children:e}){let{isPending:t}=u();return typeof e==`function`?e({isPending:t}):t&&e}export{d as Action,h as Form,g as Pending,p as ZodFieldError,m as createComponents,f as noError,u as useActionContext};

package/dist/formAction-0eiUHrXx.d.mts

@@ -0,0 +1,90 @@
+import { ZodObject, ZodTuple, ZodType, z } from "zod/v4";
+import { $ZodErrorTree, $ZodShape, $ZodType } from "zod/v4/core";
+//#region src/createFormAction.d.ts
+type InitialState<T> = {
+  type: "initial";
+  data: T;
+  error: null;
+  validationError: null;
+};
+type InvalidState<T> = {
+  type: "invalid";
+  data: null;
+  error: null;
+  validationError: T;
+};
+type FailureState<T> = {
+  type: "failure";
+  data: null;
+  error: T;
+  validationError: null;
+};
+type SuccessState<T> = {
+  type: "success";
+  data: T;
+  error: null;
+  validationError: null;
+};
+type ActionState<Data, Error, ValidationError = Record<string, never>> = InitialState<Data> | InvalidState<ValidationError> | FailureState<Error> | SuccessState<Data>;
+type FormAction<Data, Error = Data, ValidationError = Record<string, never>, Payload = FormData, Arguments extends unknown[] = []> = (...args: [...Arguments, state: ActionState<Data, Error, ValidationError>, payload: Payload]) => Promise<ActionState<Data, Error, ValidationError>>;
+declare function initial<Data>(data: Data): InitialState<Data>;
+declare function createFormAction<Data, Error = Data, ValidationError = Record<string, never>, Payload = FormData, Arguments extends [...unknown[]] = []>(formAction: (params: {
+  success: (data: Data) => SuccessState<Data>;
+  failure: (error: Error) => FailureState<Error>;
+  invalid: (validationError: ValidationError) => InvalidState<ValidationError>;
+}, ...args: Arguments) => FormAction<Data, Error, ValidationError, Payload>): (...args: [...Arguments, state: ActionState<Data, Error, ValidationError>, payload: Payload]) => Promise<ActionState<Data, Error, ValidationError>>;
+//#endregion
+//#region src/formAction.d.ts
+declare const emptyInput: unique symbol;
+type EmptyInput = typeof emptyInput;
+type Flatten<T> = Identity<{ [K in keyof T]: T[K]; }>;
+type Identity<T> = T;
+type ErrorHandler<Context, Err, Args> = (params: {
+  error: unknown;
+  ctx: Context;
+  args: Args;
+}) => Promise<Err>;
+type InitialContext = Record<"formData", FormData>;
+/**
+ * Action without schema has no input.
+ */
+type Action<Data, Context, Args extends unknown[]> = (params: {
+  args: Args;
+  ctx: Context;
+}) => Promise<Data>;
+/**
+ * Action with schema will get parsed formData as the input.
+ */
+type SchemaAction<Data, Context, Args extends unknown[], Schema extends ZodType> = (params: {
+  args: Args;
+  ctx: Context;
+  input: z.output<Schema>;
+}) => Promise<Data>;
+type FormActionBuilder<Schema extends ZodType | EmptyInput, Args extends $ZodType[] = [], TErr = unknown, Context = InitialContext, PlainArgs extends unknown[] = z.output<ZodTuple<Args, null>>> = {
+  args: <T extends [$ZodType, ...$ZodType[]]>(args: T) => FormActionBuilder<Schema, [...Args, ...T], TErr, Context>;
+  input: <T extends ZodObject>(newInput: T extends ZodObject ? T : "The schema output must be an object.") => FormActionBuilder<Schema extends ZodObject<infer O1 extends $ZodShape> ? T extends ZodObject<infer O2 extends $ZodShape> ? ZodObject<O1 & O2> : never : T, Args, TErr, Context>;
+  /**
+   * A finishing call on the builder completing your action.
+   * @param action async function to execute. It will receive parsed formData as input, when the builder was initialized with a schema.
+   * @returns runnable server action exportable from a module.
+   */
+  run: Schema extends ZodType ? <Data>(action: SchemaAction<Data, Flatten<Context>, PlainArgs, Schema>) => (...args: [...PlainArgs, state: ActionState<Data, TErr, $ZodErrorTree<z.output<Schema>> & $ZodErrorTree<PlainArgs>>, payload: FormData]) => Promise<Flatten<InvalidState<$ZodErrorTree<z.output<Schema>> & $ZodErrorTree<PlainArgs>> | FailureState<TErr> | SuccessState<Data>>> : <Data>(action: Action<Data, Flatten<Context>, PlainArgs>) => (...args: [...PlainArgs, state: ActionState<Data, TErr, $ZodErrorTree<PlainArgs>>, payload: FormData]) => Promise<Flatten<InvalidState<$ZodErrorTree<PlainArgs>> | FailureState<TErr> | SuccessState<Data>>>;
+  /**
+   * A chainable context enhancing helper.
+   * @param middleware A function which receives the current context, and returns an object which will be added to the context.
+   * @returns FormActionBuilder
+   */
+  use: <NewContext extends Record<string, unknown>>(middleware: ({ ctx }: {
+    ctx: Context;
+  }) => Promise<NewContext>) => FormActionBuilder<Schema, Args, TErr, Context & NewContext>;
+  /**
+   * A chainable error handler to handle errors thrown while running the action passed to .run().
+   * It does not receive errors thrown from the context/middleware.
+   * @param processError A function which receives action's errors.
+   * @returns FormActionBuilder
+   */
+  error: <TErr>(processError: ErrorHandler<Context, TErr, PlainArgs>) => FormActionBuilder<Schema, Args, TErr, Context>;
+};
+declare const formAction: FormActionBuilder<typeof emptyInput, [], unknown, InitialContext, []>;
+//#endregion
+export { FormAction as a, SuccessState as c, FailureState as i, createFormAction as l, formAction as n, InitialState as o, ActionState as r, InvalidState as s, Flatten as t, initial as u };

package/dist/index.d.mts

@@ -1,66 +1,11 @@
-import { a as InvalidState, c as initial, i as InitialState, n as FailureState, o as SuccessState, r as FormAction, s as createFormAction, t as ActionState } from "./createFormAction-4p5Fvn2A.mjs";
-import { ZodObject, ZodTuple, ZodType, z } from "zod/v4";
-import { ZodObject as ZodObject$1, z as z$1 } from "zod";
-import { $ZodErrorTree, $ZodShape, $ZodType } from "zod/v4/core";
-//#region src/formAction.d.ts
-declare const emptyInput: unique symbol;
-type EmptyInput = typeof emptyInput;
-type Flatten<T> = Identity<{ [K in keyof T]: T[K]; }>;
-type Identity<T> = T;
-type ErrorHandler<Context, Err, Args> = (params: {
-  error: unknown;
-  ctx: Context;
-  args: Args;
-}) => Promise<Err>;
-type InitialContext = Record<"formData", FormData>;
-/**
- * Action without schema has no input.
- */
-type Action<Data, Context, Args extends unknown[]> = (params: {
-  args: Args;
-  ctx: Context;
-}) => Promise<Data>;
-/**
- * Action with schema will get parsed formData as the input.
- */
-type SchemaAction<Data, Context, Args extends unknown[], Schema extends ZodType> = (params: {
-  args: Args;
-  ctx: Context;
-  input: z.output<Schema>;
-}) => Promise<Data>;
-type FormActionBuilder<Schema extends ZodType | EmptyInput, Args extends $ZodType[] = [], TErr = unknown, Context = InitialContext, PlainArgs extends unknown[] = z.output<ZodTuple<Args, null>>> = {
-  args: <T extends [$ZodType, ...$ZodType[]]>(args: T) => FormActionBuilder<Schema, [...Args, ...T], TErr, Context>;
-  input: <T extends ZodObject>(newInput: T extends ZodObject ? T : "The schema output must be an object.") => FormActionBuilder<Schema extends ZodObject<infer O1 extends $ZodShape> ? T extends ZodObject<infer O2 extends $ZodShape> ? ZodObject<O1 & O2> : never : T, Args, TErr, Context>;
-  /**
-   * A finishing call on the builder completing your action.
-   * @param action async function to execute. It will receive parsed formData as input, when the builder was initialized with a schema.
-   * @returns runnable server action exportable from a module.
-   */
-  run: Schema extends ZodType ? <Data>(action: SchemaAction<Data, Flatten<Context>, PlainArgs, Schema>) => (...args: [...PlainArgs, state: ActionState<Data, TErr, $ZodErrorTree<z.output<Schema>> & $ZodErrorTree<PlainArgs>>, payload: FormData]) => Promise<Flatten<InvalidState<$ZodErrorTree<z.output<Schema>> & $ZodErrorTree<PlainArgs>> | FailureState<TErr> | SuccessState<Data>>> : <Data>(action: Action<Data, Flatten<Context>, PlainArgs>) => (...args: [...PlainArgs, state: ActionState<Data, TErr, $ZodErrorTree<PlainArgs>>, payload: FormData]) => Promise<Flatten<InvalidState<$ZodErrorTree<PlainArgs>> | FailureState<TErr> | SuccessState<Data>>>;
-  /**
-   * A chainable context enhancing helper.
-   * @param middleware A function which receives the current context, and returns an object which will be added to the context.
-   * @returns FormActionBuilder
-   */
-  use: <NewContext extends Record<string, unknown>>(middleware: ({ ctx }: {
-    ctx: Context;
-  }) => Promise<NewContext>) => FormActionBuilder<Schema, Args, TErr, Context & NewContext>;
-  /**
-   * A chainable error handler to handle errors thrown while running the action passed to .run().
-   * It does not receive errors thrown from the context/middleware.
-   * @param processError A function which receives action's errors.
-   * @returns FormActionBuilder
-   */
-  error: <TErr>(processError: ErrorHandler<Context, TErr, PlainArgs>) => FormActionBuilder<Schema, Args, TErr, Context>;
-};
-declare const formAction: FormActionBuilder<typeof emptyInput, [], unknown, InitialContext, []>;
-//#endregion
+import { a as FormAction, c as SuccessState, i as FailureState, l as createFormAction, n as formAction, o as InitialState, r as ActionState, s as InvalidState, t as Flatten, u as initial } from "./formAction-0eiUHrXx.mjs";
+import { ZodObject, z } from "zod";
 //#region src/validateSchema.d.ts
 /**
  * A helper to make a validate function for the client validation with <Action validate={} /> prop.
  * @param schema z.object(...) schema
  * @returns validate function
  */
-declare function validateSchema<T extends ZodObject$1>(schema: T): (formData: FormData) => z$1.core.$ZodErrorTree<z$1.TypeOf<T>, string> | null;
+declare function validateSchema<T extends ZodObject>(schema: T): (formData: FormData) => z.core.$ZodErrorTree<z.TypeOf<T>, string> | null;
 //#endregion
-export { ActionState, FailureState, FormAction, InitialState, InvalidState, SuccessState, createFormAction, formAction, initial, validateSchema };
+export { ActionState, FailureState, Flatten, FormAction, InitialState, InvalidState, SuccessState, createFormAction, formAction, initial, validateSchema };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-form-action",
-  "version": "2.11.0",
+  "version": "2.12.0",
   "description": "State management helpers for the react form actions.",
   "repository": {
     "type": "git",

package/dist/createFormAction-4p5Fvn2A.d.mts

@@ -1,35 +0,0 @@
-//#region src/createFormAction.d.ts
-type InitialState<T> = {
-  type: "initial";
-  data: T;
-  error: null;
-  validationError: null;
-};
-type InvalidState<T> = {
-  type: "invalid";
-  data: null;
-  error: null;
-  validationError: T;
-};
-type FailureState<T> = {
-  type: "failure";
-  data: null;
-  error: T;
-  validationError: null;
-};
-type SuccessState<T> = {
-  type: "success";
-  data: T;
-  error: null;
-  validationError: null;
-};
-type ActionState<Data, Error, ValidationError = Record<string, never>> = InitialState<Data> | InvalidState<ValidationError> | FailureState<Error> | SuccessState<Data>;
-type FormAction<Data, Error = Data, ValidationError = Record<string, never>, Payload = FormData, Arguments extends unknown[] = []> = (...args: [...Arguments, state: ActionState<Data, Error, ValidationError>, payload: Payload]) => Promise<ActionState<Data, Error, ValidationError>>;
-declare function initial<Data>(data: Data): InitialState<Data>;
-declare function createFormAction<Data, Error = Data, ValidationError = Record<string, never>, Payload = FormData, Arguments extends [...unknown[]] = []>(formAction: (params: {
-  success: (data: Data) => SuccessState<Data>;
-  failure: (error: Error) => FailureState<Error>;
-  invalid: (validationError: ValidationError) => InvalidState<ValidationError>;
-}, ...args: Arguments) => FormAction<Data, Error, ValidationError, Payload>): (...args: [...Arguments, state: ActionState<Data, Error, ValidationError>, payload: Payload]) => Promise<ActionState<Data, Error, ValidationError>>;
-//#endregion
-export { InvalidState as a, initial as c, InitialState as i, FailureState as n, SuccessState as o, FormAction as r, createFormAction as s, ActionState as t };