react-form-action 2.0.0 → 2.1.0

package/README.md

@@ -40,7 +40,7 @@ npm i react-form-action zod-form-data
 #### 1️⃣ Create a Server Action
 
 ```tsx
-// app/subscibe/action.ts
+// app/subscribe/action.ts
 "use server";
 
 import { formAction } from "react-form-action";
@@ -56,7 +56,7 @@ export const subscribeAction = formAction
 #### 2️⃣ Create a Client Form Component
 
 ```tsx
-// app/subscibe/SubscribeForm.tsx
+// app/subscribe/SubscribeForm.tsx
 "use client";
 
 import {
@@ -107,12 +107,10 @@ function SubmitButton() {
 #### 3️⃣ Render the form on a Page
 
 ```tsx
-// app/subscibe/page.tsx
+// app/subscribe/page.tsx
 
 import { SubscribeForm } from "./SubscribeForm";
 
-function SuccessMessage() {}
-
 export function Page() {
   return <SubscribeForm />;
 }
@@ -384,6 +382,8 @@ export function SignUpForm() {
 
 Render children when the action is pending:
 
+#### When children are JSX
+
 ```tsx
 import { Action, Pending } from "react-form-action/client";
 
@@ -394,9 +394,29 @@ return function MyForm() {
     <Action action={action}>
       {/* 👉 Unlike the React.useFormStatus() hook, we don't need here the <form> element at all. */}
       <Pending>
+        {/* 👉 The spinner will UNMOUNT when the action is NOT pending */}
         <Spinner />
       </Pending>
     </Action>
   );
 };
 ```
+
+#### When children is a render prop
+
+```tsx
+import { Pending } from "react-form-action/client";
+
+return function SubmitButton() {
+  return (
+    <Pending>
+      {({ isPending }) => (
+        {/* 👉 With a render prop, the children are always mounted, regardles of the isPending flag */}
+        <button type="submit" disabled={isPending}>
+          {isPending ? "Submitting..." : "Submit"}
+        </button>
+      )}
+    </Pending>
+  );
+};
+```

package/dist/client.d.mts

@@ -1,8 +1,8 @@
 import * as React from 'react';
-import React__default, { PropsWithChildren, FormHTMLAttributes } from 'react';
-import { b as FormAction, A as ActionState, a as InitialState, I as InvalidState, F as FailureState, S as SuccessState } from './createFormAction-277e6e21.js';
+import React__default, { PropsWithChildren, JSX } from 'react';
+import { F as FormAction, A as ActionState, I as InitialState, a as InvalidState, b as FailureState, S as SuccessState } from './createFormAction-CX4Fk5xA.mjs';
 import { ZodFormattedError } from 'zod';
-import { RenderProp } from 'react-render-prop-type';
+import { RenderProp, RP } from 'react-render-prop-type';
 import { useFormStatus } from 'react-dom';
 
 type ActionProps<Data, Error, ValidationError> = PropsWithChildren<{
@@ -33,7 +33,7 @@ type SpreadActionContext<Data = unknown, Error = unknown, ValidationError = unkn
 declare function useActionContext<Data, Error, ValidationError>(action?: FormAction<Data, Error, ValidationError>): SpreadActionContext<Data, Error, ValidationError>;
 declare function Action<Data, Error, ValidationError>({ children, action: formAction, initialData, permalink, }: ActionProps<Data, Error, ValidationError>): React__default.JSX.Element;
 
-type ActionFormProps = Omit<FormHTMLAttributes<HTMLFormElement>, "action"> & {
+type FormProps = Omit<JSX.IntrinsicElements["form"], "action"> & {
     /**
      * Opt-in into automatic form reset by using the form "action" prop.
      * By default, the onSubmit with a custom transition which opts-out of the implicit form reset.
@@ -42,7 +42,7 @@ type ActionFormProps = Omit<FormHTMLAttributes<HTMLFormElement>, "action"> & {
      */
     autoReset?: boolean;
 };
-declare function ActionForm({ autoReset, ...props }: ActionFormProps): React__default.JSX.Element;
+declare function Form({ autoReset, ...props }: FormProps): JSX.Element;
 
 declare const SEPARATOR: ".";
 type Paths<Err> = {
@@ -61,8 +61,8 @@ declare function ZodFieldError<Errors extends ZodFormattedError<any>>({ errors,
  * Creates a typed components for actions created with the formAction builder.
  */
 declare function createComponents<Data, Error, ValidationError extends ZodFormattedError<any>>(action: FormAction<Data, Error, ValidationError>): {
-    FieldError: ({ name, }: React__default.PropsWithChildren<{
-        name?: "" | InferZodErrorPaths<ValidationError> | undefined;
+    FieldError: ({ name, }: PropsWithChildren<{
+        name?: "" | InferZodErrorPaths<ValidationError>;
     }>) => false | React__default.JSX.Element;
 };
 
@@ -71,6 +71,8 @@ declare function FormStatus({ children, }: RenderProp<ReturnType<typeof useFormS
 /**
  * Conditionally renders the children, when the form action is in the "pending" state.
  */
-declare function Pending({ children }: PropsWithChildren): React.ReactNode;
+declare function Pending({ children, }: PropsWithChildren | RP<{
+    isPending: boolean;
+}>): React.ReactNode;
 
-export { Action, ActionContextState, ActionForm, ActionFormProps, ActionProps, FormStatus, InferZodErrorPaths, Paths, Pending, ZodFieldError, ZodFieldErrorProps, createComponents, useActionContext };
+export { Action, type ActionContextState, type ActionProps, Form, type FormProps, FormStatus, type InferZodErrorPaths, type Paths, Pending, ZodFieldError, type ZodFieldErrorProps, createComponents, useActionContext };

package/dist/client.mjs

@@ -1 +1 @@
-"use client";import{a as p}from"./chunk-HL47DG4L.mjs";import f from"react";import{createContext as E,use as x}from"react";import{useActionState as A}from"react";var c={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 v({children:t,action:o,initialData:e,permalink:n}){let[r,i,s]=A(o,p(e),n),d=r.type==="initial"?{...r,...c,action:i,isPending:s,isInitial:!0}:r.type==="invalid"?{...r,...c,action:i,isPending:s,isInvalid:!0}:r.type==="failure"?{...r,...c,action:i,isPending:s,isFailure:!0}:{...r,...c,action:i,isPending:s,isSuccess:!0};return f.createElement(m,{value:d},t)}import F,{startTransition as y}from"react";function b({autoReset:t=!1,...o}){let{action:e}=a();return F.createElement("form",{...t?{action:e}:{onSubmit:r=>{r.preventDefault();let i=r.currentTarget;y(()=>{e(new FormData(i))})}},...o})}import h from"react";import l from"react";var S=".",P=Object.freeze({_errors:Object.freeze([])});function u({errors:t,name:o="",children:e=({errors:n})=>l.createElement(l.Fragment,null,n[0])}){if(o.length===0)return e({errors:t._errors});let n=o.split(S),r=t;for(;n.length;){let i=n.shift();r=r[i]??P}return e({errors:r._errors})}function L(t){function o({name:e}){let{isInvalid:n,validationError:r}=a(t);return n&&h.createElement(u,{errors:r,name:e})}return{FieldError:o}}import{useFormStatus as C}from"react-dom";function $({children:t}){return t(C())}function G({children:t}){let{isPending:o}=a();return o&&t}export{v as Action,b as ActionForm,$ as FormStatus,G as Pending,u as ZodFieldError,L 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},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};

package/dist/{createFormAction-277e6e21.d.ts → createFormAction-CX4Fk5xA.d.mts}

@@ -31,4 +31,4 @@ declare function createFormAction<Data, Error = Data, ValidationError = Record<s
     invalid: (validationError: ValidationError) => InvalidState<ValidationError>;
 }) => FormAction<Data, Error, ValidationError, Payload>): (state: ActionState<Data, Error, ValidationError>, payload: Payload) => Promise<ActionState<Data, Error, ValidationError>>;
 
-export { ActionState as A, FailureState as F, InvalidState as I, SuccessState as S, InitialState as a, FormAction as b, createFormAction as c, initial as i };
+export { type ActionState as A, type FormAction as F, type InitialState as I, type SuccessState as S, type InvalidState as a, type FailureState as b, createFormAction as c, initial as i };

package/dist/index.d.mts

@@ -1,5 +1,5 @@
-import { A as ActionState, I as InvalidState, F as FailureState, S as SuccessState } from './createFormAction-277e6e21.js';
-export { b as FormAction, a as InitialState, c as createFormAction, i as initial } from './createFormAction-277e6e21.js';
+import { A as ActionState, a as InvalidState, b as FailureState, S as SuccessState } from './createFormAction-CX4Fk5xA.mjs';
+export { F as FormAction, I as InitialState, c as createFormAction, i as initial } from './createFormAction-CX4Fk5xA.mjs';
 import { ZodTypeAny, ZodType, ZodObject, ZodRawShape, objectUtil, z, ZodSchema, ZodEffects } from 'zod';
 
 declare const emptyInput: unique symbol;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-form-action",
-  "version": "2.0.0",
+  "version": "2.1.0",
   "description": "State management helpers for the react form actions.",
   "repository": {
     "type": "git",
@@ -23,14 +23,14 @@
     ".": {
       "import": "./dist/index.mjs",
       "module": "./dist/index.mjs",
-      "default": "./dist/index.mjs",
-      "types": "./dist/index.d.mts"
+      "types": "./dist/index.d.mts",
+      "default": "./dist/index.mjs"
     },
     "./client": {
       "import": "./dist/client.mjs",
       "module": "./dist/client.mjs",
-      "default": "./dist/client.mjs",
-      "types": "./dist/client.d.mts"
+      "types": "./dist/client.d.mts",
+      "default": "./dist/client.mjs"
     }
   },
   "keywords": [
@@ -58,14 +58,14 @@
     "@types/react": "^19.0.0",
     "@types/react-dom": "^19.0.1",
     "@vitejs/plugin-react": "^4.3.4",
-    "happy-dom": "^15.11.7",
-    "npm-check-updates": "^17.1.11",
+    "happy-dom": "^16.0.0",
+    "npm-check-updates": "^17.1.12",
     "prettier": "^3.4.2",
     "react": "^19.0.0",
     "react-dom": "^19.0.0",
-    "react-render-prop-type": "^0.1.0",
-    "tsup": "^7.2.0",
-    "typescript": "^5.2.2",
+    "react-render-prop-type": "^1.0.0",
+    "tsup": "^8.3.5",
+    "typescript": "^5.7.2",
     "vitest": "^1.3.1",
     "zod": "^3.23.8",
     "zod-form-data": "^2.0.2"