react-form-action 2.1.0 → 2.2.0

package/README.md

@@ -328,7 +328,7 @@ export function UpdateUserForm() {
 
 Use the `createComponents(action)` helper to create components which use the ActionContext and have types bound to the action type.
 
-### `<FielError>` Component
+#### `<FielError>` Component
 
 ```tsx
 "use client";
@@ -338,7 +338,7 @@ import { Form, createComponents } from "react-form-action/client";
 
 import { authAction } from "./actions";
 
-export const signUp = authAction
+export const signUpAction = authAction
   .input(
     z
       .object({
@@ -357,13 +357,13 @@ export const signUp = authAction
     return null;
   });
 
-// 🌟 The FieldError is now bound do the signUp input schema which allows autocompletion for its "name" prop
+// 🌟 The FieldError is now bound do the signUpAction input schema which allows autocompletion for its "name" prop
 // ⚠️ Usable only with actions created with the formAction builder
-const { FieldError } = createComponents(signUp);
+const { FieldError } = createComponents(signUpAction);
 
 export function SignUpForm() {
   return (
-    <Action action={signUp} initialData={null}>
+    <Action action={signUpAction} initialData={null}>
       <Form>
         {/* 1️⃣ When the "name" prop is ommited, the top-level error will be rendered e.g.:
           "Passwords don't match" */}
@@ -378,6 +378,48 @@ export function SignUpForm() {
 }
 ```
 
+#### `<Success>`
+
+#### When children are JSX
+
+```tsx
+import { Action, createComponents } from "react-form-action/client";
+
+const { Success } = createComponents(signUpAction);
+
+function MyForm() {
+  return (
+    <Action action={signUpAction}>
+      <Success>
+        {/* 👉 The message will render only after the action has succeeded */}
+        <p>You've been signed up!</p>
+      </Success>
+    </Action>
+  );
+}
+```
+
+#### When children is a render prop
+
+```tsx
+import { createComponents } from "react-form-action/client";
+
+const { Success } = createComponents(signUpAction);
+
+function Label({children}: PropsWithChildren) {
+  return (
+    <Success>
+      {({ isSuccess, data }) => (
+        {/* 👉 With a render prop, the children are always mounted, regardles of the isSuccess flag */}
+        <label className={isSuccess ? "green" : ""}>
+          {children}
+        </label>
+      )}
+    </Success>
+  );
+};
+```
+
 ### `<Pending>`
 
 Render children when the action is pending:
@@ -389,7 +431,7 @@ import { Action, Pending } from "react-form-action/client";
 
 import { Spinner } from "./components";
 
-return function MyForm() {
+function MyForm() {
   return (
     <Action action={action}>
       {/* 👉 Unlike the React.useFormStatus() hook, we don't need here the <form> element at all. */}
@@ -399,7 +441,7 @@ return function MyForm() {
       </Pending>
     </Action>
   );
-};
+}
 ```
 
 #### When children is a render prop
@@ -407,7 +449,7 @@ return function MyForm() {
 ```tsx
 import { Pending } from "react-form-action/client";
 
-return function SubmitButton() {
+function SubmitButton() {
   return (
     <Pending>
       {({ isPending }) => (

package/dist/client.d.mts

@@ -64,6 +64,13 @@ declare function createComponents<Data, Error, ValidationError extends ZodFormat
     FieldError: ({ name, }: PropsWithChildren<{
         name?: "" | InferZodErrorPaths<ValidationError>;
     }>) => false | React__default.JSX.Element;
+    Success: ({ children, }: PropsWithChildren | RP<{
+        isSuccess: false;
+        data: Data | null;
+    } | {
+        isSuccess: true;
+        data: Data;
+    }>) => React__default.ReactNode;
 };
 
 declare function FormStatus({ children, }: RenderProp<ReturnType<typeof useFormStatus>>): React.ReactNode;

package/dist/client.mjs

@@ -1 +1 @@
-"use client";import{a as c}from"./chunk-HL47DG4L.mjs";import f from"react";import{createContext as E,use as x}from"react";import{useActionState as y}from"react";var p={isInitial:!1,isInvalid:!1,isFailure:!1,isSuccess:!1},m=E(null);function a(t){let o=x(m);if(!o)throw new Error("ActionContext must be initialized before use. Is your useActionContext hook wrapped with an <Action> Component?");return o}function g({children:t,action:o,initialData:e,permalink:n}){let[r,i,s]=y(o,c(e),n),d=r.type==="initial"?{...r,...p,action:i,isPending:s,isInitial:!0}:r.type==="invalid"?{...r,...p,action:i,isPending:s,isInvalid:!0}:r.type==="failure"?{...r,...p,action:i,isPending:s,isFailure:!0}:{...r,...p,action:i,isPending:s,isSuccess:!0};return f.createElement(m,{value:d},t)}import S,{startTransition as A}from"react";function V({autoReset:t=!1,...o}){let{action:e}=a();return S.createElement("form",{...t?{action:e}:{onSubmit:r=>{r.preventDefault();let i=r.currentTarget;A(()=>{e(new FormData(i))})}},...o})}import C from"react";import u from"react";var F=".",P=Object.freeze({_errors:Object.freeze([])});function l({errors:t,name:o="",children:e=({errors:n})=>u.createElement(u.Fragment,null,n[0])}){if(o.length===0)return e({errors:t._errors});let n=o.split(F),r=t;for(;n.length;){let i=n.shift();r=r[i]??P}return e({errors:r._errors})}function $(t){function o({name:e}){let{isInvalid:n,validationError:r}=a(t);return n&&C.createElement(l,{errors:r,name:e})}return{FieldError:o}}import{useFormStatus as h}from"react-dom";function X({children:t}){return t(h())}function q({children:t}){let{isPending:o}=a();return typeof t=="function"?t({isPending:o}):o&&t}export{g as Action,V as Form,X as FormStatus,q as Pending,l as ZodFieldError,$ as createComponents,a as useActionContext};
+"use client";import{a as c}from"./chunk-HL47DG4L.mjs";import f from"react";import{createContext as E,use as x}from"react";import{useActionState as y}from"react";var p={isInitial:!1,isInvalid:!1,isFailure:!1,isSuccess:!1},u=E(null);function a(t){let o=x(u);if(!o)throw new Error("ActionContext must be initialized before use. Is your useActionContext hook wrapped with an <Action> Component?");return o}function g({children:t,action:o,initialData:i,permalink:e}){let[r,n,s]=y(o,c(i),e),d=r.type==="initial"?{...r,...p,action:n,isPending:s,isInitial:!0}:r.type==="invalid"?{...r,...p,action:n,isPending:s,isInvalid:!0}:r.type==="failure"?{...r,...p,action:n,isPending:s,isFailure:!0}:{...r,...p,action:n,isPending:s,isSuccess:!0};return f.createElement(u,{value:d},t)}import S,{startTransition as A}from"react";function R({autoReset:t=!1,...o}){let{action:i}=a();return S.createElement("form",{...t?{action:i}:{onSubmit:r=>{r.preventDefault();let n=r.currentTarget;A(()=>{i(new FormData(n))})}},...o})}import C from"react";import m from"react";var F=".",P=Object.freeze({_errors:Object.freeze([])});function l({errors:t,name:o="",children:i=({errors:e})=>m.createElement(m.Fragment,null,e[0])}){if(o.length===0)return i({errors:t._errors});let e=o.split(F),r=t;for(;e.length;){let n=e.shift();r=r[n]??P}return i({errors:r._errors})}function $(t){function o({name:e}){let{isInvalid:r,validationError:n}=a(t);return r&&C.createElement(l,{errors:n,name:e})}function i({children:e}){let{isSuccess:r,data:n}=a(t);return typeof e=="function"?e(r?{isSuccess:r,data:n}:{isSuccess:r,data:n}):r&&e}return{FieldError:o,Success:i}}import{useFormStatus as h}from"react-dom";function X({children:t}){return t(h())}function q({children:t}){let{isPending:o}=a();return typeof t=="function"?t({isPending:o}):o&&t}export{g as Action,R as Form,X as FormStatus,q as Pending,l as ZodFieldError,$ as createComponents,a as useActionContext};

package/package.json

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