@firtoz/router-toolkit 7.0.2 → 8.0.0

package/dist/chunk-ZC6U3MIB.js

@@ -0,0 +1,189 @@
+import React, { createContext, useRef, useState, useCallback, useMemo } from 'react';
+import { href, useFetcher } from 'react-router';
+import { jsxs, jsx } from 'react/jsx-runtime';
+
+// src/ConcurrentSubmitterProvider.tsx
+function buildActionUrl(path, args) {
+  return args ? href(path, args) : href(path);
+}
+var ConcurrentSubmitterContext = createContext(
+  null
+);
+function FetcherRunner({
+  id,
+  pendingSubmit,
+  onSettle
+}) {
+  const fetcher = useFetcher({ key: id });
+  const submittedRef = useRef(false);
+  const settledRef = useRef(false);
+  const prevStateRef = useRef(fetcher.state);
+  React.useEffect(() => {
+    if (!pendingSubmit || submittedRef.current) return;
+    submittedRef.current = true;
+    if (pendingSubmit.kind === "json") {
+      fetcher.submit(pendingSubmit.data, {
+        action: pendingSubmit.actionUrl,
+        method: pendingSubmit.method,
+        encType: "application/json"
+      });
+    } else {
+      fetcher.submit(pendingSubmit.formData, {
+        action: pendingSubmit.actionUrl,
+        method: pendingSubmit.method,
+        encType: "multipart/form-data"
+      });
+    }
+  }, [pendingSubmit, fetcher.submit]);
+  React.useEffect(() => {
+    const wasWorking = prevStateRef.current === "submitting" || prevStateRef.current === "loading";
+    prevStateRef.current = fetcher.state;
+    if (wasWorking && fetcher.state === "idle" && !settledRef.current) {
+      settledRef.current = true;
+      if (fetcher.data !== void 0) {
+        onSettle(id, fetcher.data, void 0);
+      } else {
+        const err = fetcher.error ?? new Error("Submission failed");
+        onSettle(id, void 0, err);
+      }
+    }
+  }, [id, fetcher.state, fetcher.data, onSettle]);
+  return null;
+}
+function ConcurrentSubmitterProvider({
+  children
+}) {
+  const nextIdRef = useRef(0);
+  const [operationsState, setOperationsState] = useState({});
+  const onSettle = useCallback(
+    (id, data, error) => {
+      setOperationsState((prev) => {
+        const op = prev[id];
+        if (!op) return prev;
+        const { resolve, reject, pendingSubmit: _p, ...rest } = op;
+        if (error !== void 0) {
+          reject(error);
+          return {
+            ...prev,
+            [id]: {
+              ...rest,
+              status: "error",
+              error,
+              resolve,
+              reject
+            }
+          };
+        }
+        resolve(data);
+        return {
+          ...prev,
+          [id]: {
+            ...rest,
+            status: "done",
+            data,
+            resolve,
+            reject
+          }
+        };
+      });
+    },
+    []
+  );
+  const addJsonSubmission = useCallback(
+    (path, args, data, options = {}) => {
+      const id = `op-${++nextIdRef.current}`;
+      const method = options.method ?? "POST";
+      const actionUrl = buildActionUrl(path, args);
+      let resolve;
+      let reject;
+      const promise = new Promise((res, rej) => {
+        resolve = res;
+        reject = rej;
+      });
+      const pendingSubmit = {
+        kind: "json",
+        actionUrl,
+        method,
+        encType: "application/json",
+        data
+      };
+      const op = {
+        id,
+        status: "pending",
+        submittedData: data,
+        resolve,
+        reject,
+        pendingSubmit
+      };
+      setOperationsState((prev) => ({ ...prev, [id]: op }));
+      return { id, promise };
+    },
+    []
+  );
+  const addFormSubmission = useCallback(
+    (path, args, formData, submittedData, options = {}) => {
+      const id = `op-${++nextIdRef.current}`;
+      const method = options.method ?? "POST";
+      const actionUrl = buildActionUrl(path, args);
+      let resolve;
+      let reject;
+      const promise = new Promise((res, rej) => {
+        resolve = res;
+        reject = rej;
+      });
+      const pendingSubmit = {
+        kind: "form",
+        actionUrl,
+        method,
+        encType: "multipart/form-data",
+        formData
+      };
+      const op = {
+        id,
+        status: "pending",
+        submittedData,
+        resolve,
+        reject,
+        pendingSubmit
+      };
+      setOperationsState((prev) => ({ ...prev, [id]: op }));
+      return { id, promise };
+    },
+    []
+  );
+  const operations = useMemo(() => {
+    const result = {};
+    for (const [k, v] of Object.entries(operationsState)) {
+      const { resolve: _r, reject: _j, pendingSubmit: _p, ...rest } = v;
+      result[k] = rest;
+    }
+    return result;
+  }, [operationsState]);
+  const value = useMemo(
+    () => ({
+      operations,
+      addJsonSubmission,
+      addFormSubmission,
+      onSettle
+    }),
+    [operations, addJsonSubmission, addFormSubmission, onSettle]
+  );
+  return /* @__PURE__ */ jsxs(ConcurrentSubmitterContext.Provider, { value, children: [
+    children,
+    Object.entries(operationsState).map(
+      ([id, op]) => op.pendingSubmit && /* @__PURE__ */ jsx(
+        FetcherRunner,
+        {
+          id,
+          pendingSubmit: op.pendingSubmit,
+          onSettle
+        },
+        id
+      )
+    )
+  ] });
+}
+
+export { ConcurrentSubmitterContext, ConcurrentSubmitterProvider };
+//# sourceMappingURL=chunk-ZC6U3MIB.js.map
+//# sourceMappingURL=chunk-ZC6U3MIB.js.map

package/dist/chunk-ZC6U3MIB.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/ConcurrentSubmitterProvider.tsx"],"names":[],"mappings":"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","file":"chunk-ZC6U3MIB.js","sourcesContent":["/**\n * @fileoverview Global provider for concurrent form submissions via React Router fetchers.\n *\n * Mounts components that use useFetcher with unique keys so each submission goes through\n * the framework (correct .data URL and turbo-stream decoding). Path/args are per submission.\n *\n * @example\n * ```tsx\n * // Root:\n * <ConcurrentSubmitterProvider>\n *   <Outlet />\n * </ConcurrentSubmitterProvider>\n *\n * // Anywhere: use useConcurrentSubmitter() from \"./useConcurrentSubmitter\"\n * ```\n */\n\nimport React, {\n\tuseCallback,\n\tuseMemo,\n\tuseRef,\n\tuseState,\n\tcreateContext,\n} from \"react\";\nimport { href, useFetcher } from \"react-router\";\nimport type { SubmitTarget } from \"react-router\";\n\n/** Status of a single concurrent submission */\nexport type OperationStatus = \"pending\" | \"done\" | \"error\";\n\n/** One tracked submission: pending → done (or error). Includes submitted payload for optimistic UI. */\nexport type Operation<TResponse = unknown, TFormData = unknown> = {\n\tid: string;\n\tstatus: OperationStatus;\n\t/** Data that was sent (for optimistic display while pending, or to show what was submitted) */\n\tsubmittedData: TFormData;\n\t/** Response from the action when status is \"done\" */\n\tdata?: TResponse;\n\terror?: unknown;\n};\n\n/** Result of submitJson / submitFormData: id to look up in operations, promise to await */\nexport type SubmitJsonResult<T> = {\n\tid: string;\n\tpromise: Promise<T>;\n};\n\n/** Optional serializable payload for FormData submissions (for display in operations list). */\nexport type FormDataSubmittedData = Record<string, unknown>;\n\nexport type SubmitJsonOptions = {\n\tmethod?: \"POST\" | \"PUT\" | \"PATCH\" | \"DELETE\";\n};\n\nexport type SubmitFormDataOptions = {\n\theaders?: HeadersInit;\n\tmethod?: \"POST\" | \"PUT\" | \"PATCH\" | \"DELETE\";\n};\n\ntype PendingJson = {\n\tkind: \"json\";\n\tactionUrl: string;\n\tmethod: string;\n\tencType: \"application/json\";\n\tdata: unknown;\n};\n\ntype PendingForm = {\n\tkind: \"form\";\n\tactionUrl: string;\n\tmethod: string;\n\tencType: \"multipart/form-data\";\n\tformData: FormData;\n};\n\ntype PendingSubmit = PendingJson | PendingForm;\n\ntype OperationState = Operation<unknown, unknown> & {\n\tresolve: (value: unknown) => void;\n\treject: (error: unknown) => void;\n\tpendingSubmit?: PendingSubmit;\n};\n\nfunction buildActionUrl(path: string, args?: Record<string, string>): string {\n\t// biome-ignore lint/suspicious/noExplicitAny: path is dynamic from caller\n\treturn args ? href(path as any, args as any) : (href(path as any) as string);\n}\n\ntype ContextValue = {\n\toperations: Record<string, Operation<unknown, unknown>>;\n\taddJsonSubmission: (\n\t\tpath: string,\n\t\targs: Record<string, string> | undefined,\n\t\tdata: unknown,\n\t\toptions?: SubmitJsonOptions,\n\t) => SubmitJsonResult<unknown>;\n\taddFormSubmission: (\n\t\tpath: string,\n\t\targs: Record<string, string> | undefined,\n\t\tformData: FormData,\n\t\tsubmittedData: FormDataSubmittedData,\n\t\toptions?: SubmitFormDataOptions,\n\t) => SubmitJsonResult<unknown>;\n\tonSettle: (id: string, data?: unknown, error?: unknown) => void;\n};\n\nexport const ConcurrentSubmitterContext = createContext<ContextValue | null>(\n\tnull,\n);\n\nfunction FetcherRunner({\n\tid,\n\tpendingSubmit,\n\tonSettle,\n}: {\n\tid: string;\n\tpendingSubmit: PendingSubmit;\n\tonSettle: (id: string, data?: unknown, error?: unknown) => void;\n}) {\n\tconst fetcher = useFetcher({ key: id });\n\tconst submittedRef = useRef(false);\n\tconst settledRef = useRef(false);\n\tconst prevStateRef = useRef(fetcher.state);\n\n\tReact.useEffect(() => {\n\t\tif (!pendingSubmit || submittedRef.current) return;\n\t\tsubmittedRef.current = true;\n\n\t\tif (pendingSubmit.kind === \"json\") {\n\t\t\tfetcher.submit(pendingSubmit.data as SubmitTarget, {\n\t\t\t\taction: pendingSubmit.actionUrl,\n\t\t\t\tmethod: pendingSubmit.method as \"POST\" | \"PUT\" | \"PATCH\" | \"DELETE\",\n\t\t\t\tencType: \"application/json\",\n\t\t\t});\n\t\t} else {\n\t\t\tfetcher.submit(pendingSubmit.formData, {\n\t\t\t\taction: pendingSubmit.actionUrl,\n\t\t\t\tmethod: pendingSubmit.method as \"POST\" | \"PUT\" | \"PATCH\" | \"DELETE\",\n\t\t\t\tencType: \"multipart/form-data\",\n\t\t\t});\n\t\t}\n\t}, [pendingSubmit, fetcher.submit]);\n\n\tReact.useEffect(() => {\n\t\tconst wasWorking =\n\t\t\tprevStateRef.current === \"submitting\" ||\n\t\t\tprevStateRef.current === \"loading\";\n\t\tprevStateRef.current = fetcher.state;\n\n\t\tif (wasWorking && fetcher.state === \"idle\" && !settledRef.current) {\n\t\t\tsettledRef.current = true;\n\t\t\tif (fetcher.data !== undefined) {\n\t\t\t\tonSettle(id, fetcher.data, undefined);\n\t\t\t} else {\n\t\t\t\tconst err =\n\t\t\t\t\t(fetcher as { error?: unknown }).error ??\n\t\t\t\t\tnew Error(\"Submission failed\");\n\t\t\t\tonSettle(id, undefined, err);\n\t\t\t}\n\t\t}\n\t}, [id, fetcher.state, fetcher.data, onSettle]);\n\n\treturn null;\n}\n\nexport function ConcurrentSubmitterProvider({\n\tchildren,\n}: {\n\tchildren: React.ReactNode;\n}) {\n\tconst nextIdRef = useRef(0);\n\tconst [operationsState, setOperationsState] = useState<\n\t\tRecord<string, OperationState>\n\t>({});\n\n\tconst onSettle = useCallback(\n\t\t(id: string, data?: unknown, error?: unknown) => {\n\t\t\tsetOperationsState((prev) => {\n\t\t\t\tconst op = prev[id];\n\t\t\t\tif (!op) return prev;\n\t\t\t\tconst { resolve, reject, pendingSubmit: _p, ...rest } = op;\n\t\t\t\tif (error !== undefined) {\n\t\t\t\t\treject(error);\n\t\t\t\t\treturn {\n\t\t\t\t\t\t...prev,\n\t\t\t\t\t\t[id]: {\n\t\t\t\t\t\t\t...rest,\n\t\t\t\t\t\t\tstatus: \"error\" as OperationStatus,\n\t\t\t\t\t\t\terror,\n\t\t\t\t\t\t\tresolve,\n\t\t\t\t\t\t\treject,\n\t\t\t\t\t\t},\n\t\t\t\t\t};\n\t\t\t\t}\n\t\t\t\tresolve(data);\n\t\t\t\treturn {\n\t\t\t\t\t...prev,\n\t\t\t\t\t[id]: {\n\t\t\t\t\t\t...rest,\n\t\t\t\t\t\tstatus: \"done\" as OperationStatus,\n\t\t\t\t\t\tdata,\n\t\t\t\t\t\tresolve,\n\t\t\t\t\t\treject,\n\t\t\t\t\t},\n\t\t\t\t};\n\t\t\t});\n\t\t},\n\t\t[],\n\t);\n\n\tconst addJsonSubmission = useCallback(\n\t\t(\n\t\t\tpath: string,\n\t\t\targs: Record<string, string> | undefined,\n\t\t\tdata: unknown,\n\t\t\toptions: SubmitJsonOptions = {},\n\t\t): SubmitJsonResult<unknown> => {\n\t\t\tconst id = `op-${++nextIdRef.current}`;\n\t\t\tconst method = options.method ?? \"POST\";\n\t\t\tconst actionUrl = buildActionUrl(path, args);\n\n\t\t\tlet resolve!: (value: unknown) => void;\n\t\t\tlet reject!: (error: unknown) => void;\n\t\t\tconst promise = new Promise<unknown>((res, rej) => {\n\t\t\t\tresolve = res;\n\t\t\t\treject = rej;\n\t\t\t});\n\n\t\t\tconst pendingSubmit: PendingJson = {\n\t\t\t\tkind: \"json\",\n\t\t\t\tactionUrl,\n\t\t\t\tmethod,\n\t\t\t\tencType: \"application/json\",\n\t\t\t\tdata,\n\t\t\t};\n\n\t\t\tconst op: OperationState = {\n\t\t\t\tid,\n\t\t\t\tstatus: \"pending\",\n\t\t\t\tsubmittedData: data as Record<string, unknown>,\n\t\t\t\tresolve,\n\t\t\t\treject,\n\t\t\t\tpendingSubmit,\n\t\t\t};\n\n\t\t\tsetOperationsState((prev) => ({ ...prev, [id]: op }));\n\t\t\treturn { id, promise };\n\t\t},\n\t\t[],\n\t);\n\n\tconst addFormSubmission = useCallback(\n\t\t(\n\t\t\tpath: string,\n\t\t\targs: Record<string, string> | undefined,\n\t\t\tformData: FormData,\n\t\t\tsubmittedData: FormDataSubmittedData,\n\t\t\toptions: SubmitFormDataOptions = {},\n\t\t): SubmitJsonResult<unknown> => {\n\t\t\tconst id = `op-${++nextIdRef.current}`;\n\t\t\tconst method = options.method ?? \"POST\";\n\t\t\tconst actionUrl = buildActionUrl(path, args);\n\n\t\t\tlet resolve!: (value: unknown) => void;\n\t\t\tlet reject!: (error: unknown) => void;\n\t\t\tconst promise = new Promise<unknown>((res, rej) => {\n\t\t\t\tresolve = res;\n\t\t\t\treject = rej;\n\t\t\t});\n\n\t\t\tconst pendingSubmit: PendingForm = {\n\t\t\t\tkind: \"form\",\n\t\t\t\tactionUrl,\n\t\t\t\tmethod,\n\t\t\t\tencType: \"multipart/form-data\",\n\t\t\t\tformData,\n\t\t\t};\n\n\t\t\tconst op: OperationState = {\n\t\t\t\tid,\n\t\t\t\tstatus: \"pending\",\n\t\t\t\tsubmittedData,\n\t\t\t\tresolve,\n\t\t\t\treject,\n\t\t\t\tpendingSubmit,\n\t\t\t};\n\n\t\t\tsetOperationsState((prev) => ({ ...prev, [id]: op }));\n\t\t\treturn { id, promise };\n\t\t},\n\t\t[],\n\t);\n\n\tconst operations = useMemo(() => {\n\t\tconst result: Record<string, Operation<unknown, unknown>> = {};\n\t\tfor (const [k, v] of Object.entries(operationsState)) {\n\t\t\tconst { resolve: _r, reject: _j, pendingSubmit: _p, ...rest } = v;\n\t\t\tresult[k] = rest;\n\t\t}\n\t\treturn result;\n\t}, [operationsState]);\n\n\tconst value = useMemo<ContextValue>(\n\t\t() => ({\n\t\t\toperations,\n\t\t\taddJsonSubmission,\n\t\t\taddFormSubmission,\n\t\t\tonSettle,\n\t\t}),\n\t\t[operations, addJsonSubmission, addFormSubmission, onSettle],\n\t);\n\n\treturn (\n\t\t<ConcurrentSubmitterContext.Provider value={value}>\n\t\t\t{children}\n\t\t\t{Object.entries(operationsState).map(\n\t\t\t\t([id, op]) =>\n\t\t\t\t\top.pendingSubmit && (\n\t\t\t\t\t\t<FetcherRunner\n\t\t\t\t\t\t\tkey={id}\n\t\t\t\t\t\t\tid={id}\n\t\t\t\t\t\t\tpendingSubmit={op.pendingSubmit}\n\t\t\t\t\t\t\tonSettle={onSettle}\n\t\t\t\t\t\t/>\n\t\t\t\t\t),\n\t\t\t)}\n\t\t</ConcurrentSubmitterContext.Provider>\n\t);\n}\n"]}

package/dist/chunk-ZMRGBYFH.js

@@ -0,0 +1,3 @@
+
+//# sourceMappingURL=chunk-ZMRGBYFH.js.map
+//# sourceMappingURL=chunk-ZMRGBYFH.js.map

package/dist/chunk-ZMRGBYFH.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"chunk-ZMRGBYFH.js"}

package/dist/formAction.d.ts

@@ -0,0 +1,290 @@
+import { MaybeError } from '@firtoz/maybe-error';
+import { ActionFunctionArgs } from 'react-router';
+import { z } from 'zod';
+
+/**
+ * @fileoverview Type-safe form action utility for React Router 7
+ *
+ * This module provides a wrapper for React Router actions that handles form data and JSON
+ * validation using Zod schemas and provides structured error handling with MaybeError.
+ *
+ * Supports both:
+ * - **JSON requests** (`Content-Type: application/json`) - parsed with `request.json()` and validated directly
+ * - **FormData requests** (`multipart/form-data` or `application/x-www-form-urlencoded`) - parsed with `request.formData()` and validated with zod-form-data
+ *
+ * ## Overview
+ *
+ * `formAction` is designed to work seamlessly with `useDynamicSubmitter` and `useDynamicFetcher`
+ * to provide end-to-end type safety for your React Router forms.
+ *
+ * @example
+ * ### Basic Route Setup (`app/routes/auth.login.tsx`)
+ *
+ * ```typescript
+ * import { z } from "zod";
+ * import { formAction, type RoutePath } from "@firtoz/router-toolkit";
+ * import { success, fail } from "@firtoz/maybe-error";
+ *
+ * // 1. Export the route path for type inference
+ * export const route: RoutePath<"/auth/login"> = "/auth/login";
+ *
+ * // 2. Define your form schema with Zod
+ * export const formSchema = z.object({
+ *   email: z.string().email("Please enter a valid email"),
+ *   password: z.string().min(8, "Password must be at least 8 characters"),
+ *   rememberMe: z.boolean().optional().default(false),
+ * });
+ *
+ * // 3. Create the action with formAction
+ * export const action = formAction({
+ *   schema: formSchema,
+ *   handler: async ({ request }, data) => {
+ *     // data is fully typed: { email: string, password: string, rememberMe: boolean }
+ *     try {
+ *       const user = await authenticateUser(data.email, data.password);
+ *       if (data.rememberMe) {
+ *         await createPersistentSession(user.id);
+ *       }
+ *       return success({ user });
+ *     } catch (error) {
+ *       return fail("Invalid email or password");
+ *     }
+ *   },
+ * });
+ * ```
+ *
+ * @example
+ * ### Using with useDynamicSubmitter
+ *
+ * The route above can be used with `useDynamicSubmitter` for type-safe form submissions:
+ *
+ * ```tsx
+ * import { useDynamicSubmitter } from "@firtoz/router-toolkit";
+ *
+ * function LoginForm() {
+ *   const submitter = useDynamicSubmitter<typeof import("./auth.login")>("/auth/login");
+ *
+ *   // Option 1: Submit as JSON (defaults to POST)
+ *   const handleLoginJson = async () => {
+ *     await submitter.submitJson({
+ *       email: "user@example.com",
+ *       password: "secret123",
+ *       rememberMe: true,
+ *     });
+ *   };
+ *
+ *   // Option 2: Use the Form component (defaults to POST)
+ *   return (
+ *     <submitter.Form>
+ *       <input name="email" type="email" placeholder="Email" />
+ *       <input name="password" type="password" placeholder="Password" />
+ *       <label>
+ *         <input name="rememberMe" type="checkbox" /> Remember me
+ *       </label>
+ *       <button disabled={submitter.state !== "idle"}>
+ *         {submitter.state === "submitting" ? "Logging in..." : "Login"}
+ *       </button>
+ *
+ *       {submitter.data && !submitter.data.success && (
+ *         <div className="error">
+ *           {submitter.data.error.type === "validation"
+ *             ? "Please check your inputs"
+ *             : submitter.data.error.type === "handler"
+ *               ? submitter.data.error.error // "Invalid email or password"
+ *               : "An unexpected error occurred"}
+ *         </div>
+ *       )}
+ *     </submitter.Form>
+ *   );
+ * }
+ * ```
+ *
+ * @example
+ * ### Combined loader + action route (`app/routes/admin.posts.$id.tsx`)
+ *
+ * You can combine `formAction` with a loader for full CRUD operations:
+ *
+ * ```typescript
+ * import { z } from "zod";
+ * import { formAction, type RoutePath } from "@firtoz/router-toolkit";
+ * import { success, fail } from "@firtoz/maybe-error";
+ * import type { LoaderFunctionArgs } from "react-router";
+ *
+ * export const route: RoutePath<"/admin/posts/:id"> = "/admin/posts/:id";
+ *
+ * // Loader for fetching data (used with useDynamicFetcher)
+ * export const loader = async ({ params }: LoaderFunctionArgs) => {
+ *   const post = await db.posts.findUnique({ where: { id: params.id } });
+ *   return { post };
+ * };
+ *
+ * // Form schema for updates
+ * export const formSchema = z.object({
+ *   title: z.string().min(1, "Title is required"),
+ *   content: z.string().min(10, "Content must be at least 10 characters"),
+ *   published: z.boolean().optional().default(false),
+ * });
+ *
+ * // Action for handling form submissions (used with useDynamicSubmitter)
+ * export const action = formAction({
+ *   schema: formSchema,
+ *   handler: async ({ params }, data) => {
+ *     const updated = await db.posts.update({
+ *       where: { id: params.id },
+ *       data,
+ *     });
+ *     return success({ post: updated });
+ *   },
+ * });
+ * ```
+ *
+ * @example
+ * ### Full CRUD component using both hooks
+ *
+ * ```tsx
+ * import { useDynamicFetcher, useDynamicSubmitter } from "@firtoz/router-toolkit";
+ * import { useEffect } from "react";
+ *
+ * function PostEditor({ postId }: { postId: string }) {
+ *   // Fetch post data
+ *   const fetcher = useDynamicFetcher<typeof import("./admin.posts.$id")>(
+ *     "/admin/posts/:id",
+ *     { id: postId }
+ *   );
+ *
+ *   // Submit updates
+ *   const submitter = useDynamicSubmitter<typeof import("./admin.posts.$id")>(
+ *     "/admin/posts/:id",
+ *     { id: postId }
+ *   );
+ *
+ *   useEffect(() => {
+ *     fetcher.load();
+ *   }, [fetcher.load]);
+ *
+ *   if (fetcher.state === "loading" && !fetcher.data) {
+ *     return <div>Loading...</div>;
+ *   }
+ *
+ *   const post = fetcher.data?.post;
+ *
+ *   return (
+ *     <submitter.Form method="PUT">
+ *       <input name="title" defaultValue={post?.title} />
+ *       <textarea name="content" defaultValue={post?.content} />
+ *       <label>
+ *         <input name="published" type="checkbox" defaultChecked={post?.published} />
+ *         Published
+ *       </label>
+ *       <button disabled={submitter.state !== "idle"}>
+ *         {submitter.state === "submitting" ? "Saving..." : "Save"}
+ *       </button>
+ *     </submitter.Form>
+ *   );
+ * }
+ * ```
+ */
+
+/**
+ * Error types that can be returned by formAction
+ */
+type FormActionError<TError, TSchema extends z.ZodTypeAny> = {
+    type: "validation";
+    error: ReturnType<typeof z.treeifyError<z.infer<TSchema>>>;
+} | {
+    type: "handler";
+    error: TError;
+} | {
+    type: "unknown";
+};
+/**
+ * Configuration object for formAction
+ *
+ * @template TSchema - The Zod schema type for form validation
+ * @template TResult - The success result type from the handler
+ * @template TError - The error type that the handler can return
+ * @template ActionArgs - The action function arguments type (defaults to ActionFunctionArgs)
+ */
+interface FormActionConfig<TSchema extends z.ZodTypeAny, TResult = undefined, TError = string, ActionArgs extends ActionFunctionArgs = ActionFunctionArgs> {
+    /**
+     * Zod schema to validate the form data against
+     */
+    schema: TSchema;
+    /**
+     * Handler function that processes the validated form data
+     *
+     * @param args - The original action function arguments
+     * @param data - The validated form data (typed according to the schema)
+     * @returns A promise that resolves to a MaybeError with the result or error
+     */
+    handler: (args: ActionArgs, data: z.infer<TSchema>) => Promise<MaybeError<TResult, TError>>;
+}
+/**
+ * Creates a type-safe form action handler that validates form data or JSON and provides structured error handling.
+ *
+ * This function wraps a React Router action to:
+ * 1. Detect content type (JSON vs FormData) from the request headers
+ * 2. Parse and validate the request body using a Zod schema
+ * 3. Call the provided handler with validated data
+ * 4. Return structured errors for validation failures, handler errors, or unknown errors
+ * 5. Preserve React Router Response objects (redirects, etc.) by re-throwing them
+ *
+ * **Content-Type handling:**
+ * - `application/json`: Uses `request.json()` and validates directly with the schema
+ * - `multipart/form-data` or `application/x-www-form-urlencoded`: Uses `request.formData()` and validates with zod-form-data
+ *
+ * @template TSchema - The Zod schema type for form validation
+ * @template TResult - The success result type from the handler (defaults to undefined)
+ * @template TError - The error type that the handler can return (defaults to string)
+ * @template ActionArgs - The action function arguments type (defaults to ActionFunctionArgs)
+ *
+ * @param config - Configuration object containing schema and handler
+ * @returns An action function that can be used with React Router
+ *
+ * @example
+ * ```typescript
+ * import { z } from "zod";
+ * import { formAction } from "@firtoz/router-toolkit";
+ * import { success, fail } from "@firtoz/maybe-error";
+ *
+ * const loginSchema = z.object({
+ *   email: z.string().email("Invalid email format"),
+ *   password: z.string().min(8, "Password must be at least 8 characters"),
+ * });
+ *
+ * export const action = formAction({
+ *   schema: loginSchema,
+ *   handler: async (args, data) => {
+ *     try {
+ *       const user = await authenticateUser(data.email, data.password);
+ *       return success(user);
+ *     } catch (error) {
+ *       return fail("Invalid credentials");
+ *     }
+ *   },
+ * });
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // In your component, handle the different error types:
+ * const actionData = useActionData<typeof action>();
+ *
+ * if (actionData && !actionData.success) {
+ *   switch (actionData.error.type) {
+ *     case "validation":
+ *       // Handle validation errors - actionData.error.error contains field-specific errors
+ *       break;
+ *     case "handler":
+ *       // Handle business logic errors - actionData.error.error contains your custom error
+ *       break;
+ *     case "unknown":
+ *       // Handle unexpected errors
+ *       break;
+ *   }
+ * }
+ * ```
+ */
+declare const formAction: <TSchema extends z.ZodTypeAny, TResult = undefined, TError = string, ActionArgs extends ActionFunctionArgs = ActionFunctionArgs>({ schema, handler, }: FormActionConfig<TSchema, TResult, TError, ActionArgs>) => (args: ActionArgs) => Promise<MaybeError<TResult, FormActionError<TError, TSchema>>>;
+
+export { type FormActionConfig, type FormActionError, formAction };

package/dist/formAction.js

@@ -0,0 +1,3 @@
+export { formAction } from './chunk-5MOCOBGV.js';
+//# sourceMappingURL=formAction.js.map
+//# sourceMappingURL=formAction.js.map

package/dist/formAction.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"formAction.js"}

package/dist/index.d.ts

@@ -0,0 +1,18 @@
+export { ConcurrentSubmitterContext, ConcurrentSubmitterProvider, FormDataSubmittedData, Operation, OperationStatus, SubmitFormDataOptions, SubmitJsonOptions, SubmitJsonResult } from './ConcurrentSubmitterProvider.js';
+export { FormActionConfig, FormActionError, formAction } from './formAction.js';
+export * from '@firtoz/maybe-error';
+export { Func } from './types/Func.js';
+export { HrefArgs } from './types/HrefArgs.js';
+export { RegisterPages } from './types/RegisterPages.js';
+export { RoutePath } from './types/RoutePath.js';
+export { ActionResult, RouteWithActionModule } from './types/RouteWithActionModule.js';
+export { RouteWithLoaderModule } from './types/RouteWithLoaderModule.js';
+export { useCachedFetch } from './useCachedFetch.js';
+export { UseConcurrentSubmitterReturn, useConcurrentSubmitter } from './useConcurrentSubmitter.js';
+export { useDynamicFetcher } from './useDynamicFetcher.js';
+export { useDynamicSubmitter } from './useDynamicSubmitter.js';
+export { useFetcherStateChanged } from './useFetcherStateChanged.js';
+import 'react/jsx-runtime';
+import 'react';
+import 'react-router';
+import 'zod';

package/dist/index.js

@@ -0,0 +1,16 @@
+import './chunk-2RLEUOSR.js';
+import './chunk-2W5QFQTE.js';
+export { useCachedFetch } from './chunk-OQGTU34H.js';
+export { useConcurrentSubmitter } from './chunk-QZDEBX3D.js';
+export { useDynamicFetcher } from './chunk-HX57TC2S.js';
+export { useDynamicSubmitter } from './chunk-JJN6GBJL.js';
+export { useFetcherStateChanged } from './chunk-W5R7YYHR.js';
+export { ConcurrentSubmitterContext, ConcurrentSubmitterProvider } from './chunk-ZC6U3MIB.js';
+export { formAction } from './chunk-5MOCOBGV.js';
+import './chunk-YYJDSKJG.js';
+import './chunk-ZMRGBYFH.js';
+import './chunk-MKH4ZP5U.js';
+import './chunk-S4QCJFVR.js';
+import './chunk-R6HEJ5E5.js';
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}

package/dist/types/Func.d.ts

@@ -0,0 +1,3 @@
+type Func = (...args: any[]) => unknown;
+
+export type { Func };

package/dist/types/Func.js

@@ -0,0 +1,3 @@
+import '../chunk-YYJDSKJG.js';
+//# sourceMappingURL=Func.js.map
+//# sourceMappingURL=Func.js.map

package/dist/types/Func.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"Func.js"}

package/dist/types/HrefArgs.d.ts

@@ -0,0 +1,8 @@
+import { RegisterPages } from './RegisterPages.js';
+import 'react-router';
+
+type Equal<X, Y> = (<T>() => T extends X ? 1 : 2) extends <T>() => T extends Y ? 1 : 2 ? true : false;
+type ToArgs<Params extends Record<string, string | undefined>> = Equal<Params, {}> extends true ? [] : Partial<Params> extends Params ? [Params] | [] : [Params];
+type HrefArgs<T extends keyof RegisterPages> = ToArgs<RegisterPages[T]["params"]>;
+
+export type { HrefArgs };

package/dist/types/HrefArgs.js

@@ -0,0 +1,3 @@
+import '../chunk-ZMRGBYFH.js';
+//# sourceMappingURL=HrefArgs.js.map
+//# sourceMappingURL=HrefArgs.js.map

package/dist/types/HrefArgs.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"HrefArgs.js"}

package/dist/types/RegisterPages.d.ts

@@ -0,0 +1,11 @@
+import { Register } from 'react-router';
+
+type AnyParams = Record<string, string | undefined>;
+type AnyPages = Record<string, {
+    params: AnyParams;
+}>;
+type RegisterPages = Register extends {
+    pages: infer Registered extends AnyPages;
+} ? Registered : AnyPages;
+
+export type { RegisterPages };

package/dist/types/RegisterPages.js

@@ -0,0 +1,3 @@
+import '../chunk-MKH4ZP5U.js';
+//# sourceMappingURL=RegisterPages.js.map
+//# sourceMappingURL=RegisterPages.js.map

package/dist/types/RegisterPages.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"RegisterPages.js"}

package/dist/types/RoutePath.d.ts

@@ -0,0 +1,6 @@
+import { RegisterPages } from './RegisterPages.js';
+import 'react-router';
+
+type RoutePath<TPath extends keyof RegisterPages> = TPath;
+
+export type { RoutePath };

package/dist/types/RoutePath.js

@@ -0,0 +1,3 @@
+import '../chunk-S4QCJFVR.js';
+//# sourceMappingURL=RoutePath.js.map
+//# sourceMappingURL=RoutePath.js.map

package/dist/types/RoutePath.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"RoutePath.js"}

package/dist/types/RouteWithActionModule.d.ts

@@ -0,0 +1,18 @@
+import { Func } from './Func.js';
+import { RegisterPages } from './RegisterPages.js';
+import { z } from 'zod';
+import 'react-router';
+
+/**
+ * Route module shape for type-safe form actions: route path, action handler, and form schema.
+ * Use with useDynamicSubmitter and useConcurrentSubmitter.
+ */
+type RouteWithActionModule = {
+    route: keyof RegisterPages;
+    action: Func;
+    formSchema: z.ZodType;
+};
+/** Action result type inferred from the route module's action */
+type ActionResult<TModule extends RouteWithActionModule> = Awaited<ReturnType<TModule["action"]>>;
+
+export type { ActionResult, RouteWithActionModule };

package/dist/types/RouteWithActionModule.js

@@ -0,0 +1,3 @@
+import '../chunk-R6HEJ5E5.js';
+//# sourceMappingURL=RouteWithActionModule.js.map
+//# sourceMappingURL=RouteWithActionModule.js.map

package/dist/types/RouteWithActionModule.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"RouteWithActionModule.js"}