@rsc-kit/core 0.12.0 → 0.13.1

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@rsc-kit/core",
-  "version": "0.12.0",
-  "description": "React Server Components on any JavaScript server: a Vite plugin that discovers the route tree, and a host adapter that serves it.",
+  "version": "0.13.1",
+  "description": "React Server Components as a Vite plugin. Routing, streaming, server actions, typed urls and build-time prerendering — deploy to Bun, Node, Workers, Vercel or Deno.",
   "license": "MIT",
   "type": "module",
   "sideEffects": false,
@@ -61,10 +61,6 @@
       "types": "./dist/js/router.d.ts",
       "default": "./dist/js/router.js"
     },
-    "./useForm": {
-      "types": "./dist/js/useForm.d.ts",
-      "default": "./dist/js/useForm.js"
-    },
     "./usePathname": {
       "types": "./dist/js/usePathname.d.ts",
       "default": "./dist/js/usePathname.js"
@@ -180,6 +176,14 @@
     "./useAppUpdate": {
       "types": "./dist/js/useAppUpdate.d.ts",
       "default": "./dist/js/useAppUpdate.js"
+    },
+    "./form-encoding": {
+      "types": "./dist/js/formEncoding.d.ts",
+      "default": "./dist/js/formEncoding.js"
+    },
+    "./useField": {
+      "types": "./dist/js/Form.d.ts",
+      "default": "./dist/js/Form.js"
     }
   },
   "peerDependencies": {

package/dist/js/useForm.d.ts

@@ -1,42 +0,0 @@
-import type { StandardSchemaV1 } from "./standardSchema";
-type SetDataFn<T> = {
-    <K extends keyof T>(field: K, value: T[K]): void;
-    (values: Partial<T>): void;
-};
-export interface UseFormReturn<T extends Record<string, unknown>> {
-    data: T;
-    setData: SetDataFn<T>;
-    errors: Partial<Record<keyof T & string, string[]>>;
-    error: (field: keyof T & string) => string | undefined;
-    hasErrors: boolean;
-    pending: boolean;
-    processing: boolean;
-    wasSuccessful: boolean;
-    recentlySuccessful: boolean;
-    clearErrors: (...fields: (keyof T & string)[]) => void;
-    reset: (...fields: (keyof T)[]) => void;
-    setDefaults: (values?: Partial<T>) => void;
-    transform: (fn: (data: T) => Record<string, unknown>) => void;
-    submit: (action: (formData: FormData) => Promise<unknown>, optimistic?: () => void) => Promise<void>;
-}
-/**
- * Serialize form state into FormData for a server action.
- *
- * Exported for testing: this is the contract between useForm and the action —
- * booleans become "1"/"0" so PHP sees something truthy, arrays repeat under
- * `key[]`, Files pass through untouched for native uploads, and null/undefined
- * are dropped rather than sent as the string "null".
- */
-export declare function buildFormData(data: Record<string, unknown>): FormData;
-export declare function useForm<T extends Record<string, unknown>>(initialValues: T, options?: {
-    /**
-     * Check the fields before submitting, with any Standard Schema — Zod,
-     * Valibot, ArkType.
-     *
-     * A failure fills `errors` and the action is never called. A courtesy, not
-     * a control: the action is reachable without this form, so the server
-     * still has to check.
-     */
-    schema?: StandardSchemaV1;
-}): UseFormReturn<T>;
-export {};

package/dist/js/useForm.js

@@ -1,164 +0,0 @@
-"use client";
-import { useState, useRef, useCallback, useTransition } from "react";
-import { ServerValidationError, ServerDumpError } from "./errors";
-import { validateWith } from "./standardSchema";
-/**
- * Serialize form state into FormData for a server action.
- *
- * Exported for testing: this is the contract between useForm and the action —
- * booleans become "1"/"0" so PHP sees something truthy, arrays repeat under
- * `key[]`, Files pass through untouched for native uploads, and null/undefined
- * are dropped rather than sent as the string "null".
- */
-export function buildFormData(data) {
-    const formData = new FormData();
-    for (const [key, val] of Object.entries(data)) {
-        if (val === null || val === undefined) {
-            continue;
-        }
-        if (val instanceof File) {
-            formData.append(key, val);
-        }
-        else if (typeof val === "boolean") {
-            formData.append(key, val ? "1" : "0");
-        }
-        else if (Array.isArray(val)) {
-            for (const item of val) {
-                formData.append(`${key}[]`, String(item));
-            }
-        }
-        else {
-            formData.append(key, String(val));
-        }
-    }
-    return formData;
-}
-export function useForm(initialValues, options = {}) {
-    const [data, setDataState] = useState(initialValues);
-    const [errors, setErrors] = useState({});
-    const [wasSuccessful, setWasSuccessful] = useState(false);
-    const [recentlySuccessful, setRecentlySuccessful] = useState(false);
-    const [isPending, startTransition] = useTransition();
-    const defaultsRef = useRef({ ...initialValues });
-    const transformRef = useRef(null);
-    const recentTimerRef = useRef(undefined);
-    const setData = useCallback((fieldOrValues, value) => {
-        if (typeof fieldOrValues === "object") {
-            setDataState((prev) => ({ ...prev, ...fieldOrValues }));
-        }
-        else {
-            setDataState((prev) => ({ ...prev, [fieldOrValues]: value }));
-        }
-    }, []);
-    const error = useCallback((field) => errors[field]?.[0], [errors]);
-    const clearErrors = useCallback((...fields) => {
-        if (fields.length === 0) {
-            setErrors({});
-        }
-        else {
-            setErrors((prev) => {
-                const next = { ...prev };
-                for (const f of fields) {
-                    delete next[f];
-                }
-                return next;
-            });
-        }
-    }, []);
-    const reset = useCallback((...fields) => {
-        if (fields.length === 0) {
-            setDataState({ ...defaultsRef.current });
-        }
-        else {
-            setDataState((prev) => {
-                const next = { ...prev };
-                for (const f of fields) {
-                    next[f] = defaultsRef.current[f];
-                }
-                return next;
-            });
-        }
-        clearErrors();
-    }, [clearErrors]);
-    const setDefaults = useCallback((values) => {
-        if (values) {
-            defaultsRef.current = { ...defaultsRef.current, ...values };
-        }
-        else {
-            defaultsRef.current = { ...data };
-        }
-    }, [data, options.schema]);
-    const transformFn = useCallback((fn) => {
-        transformRef.current = fn;
-    }, []);
-    const submit = useCallback((action, optimistic) => {
-        return new Promise((resolve, reject) => {
-            startTransition(async () => {
-                try {
-                    // Before the optimistic update, so a rejected form never shows the
-                    // row it was going to add.
-                    const invalid = await validateWith(options.schema, data);
-                    if (invalid) {
-                        setErrors(invalid);
-                        resolve();
-                        return;
-                    }
-                    // Call optimistic updater inside the transition so React's
-                    // useOptimistic picks it up and auto-reverts on settle.
-                    optimistic?.();
-                    const payload = transformRef.current ? transformRef.current(data) : data;
-                    const formData = buildFormData(payload);
-                    setErrors({});
-                    const result = await action(formData);
-                    const answer = result;
-                    // An action built with createActionClient returns its failures
-                    // rather than throwing them, because a rejected server action is
-                    // serialised opaquely and the fields it named would be lost.
-                    if (answer?.validationErrors) {
-                        setErrors(answer.validationErrors);
-                        resolve();
-                        return;
-                    }
-                    if (answer?.serverError) {
-                        reject(new Error(answer.serverError));
-                        return;
-                    }
-                    setWasSuccessful(true);
-                    setRecentlySuccessful(true);
-                    if (recentTimerRef.current) {
-                        clearTimeout(recentTimerRef.current);
-                    }
-                    recentTimerRef.current = setTimeout(() => setRecentlySuccessful(false), 2000);
-                    resolve();
-                }
-                catch (err) {
-                    if (err instanceof ServerValidationError) {
-                        setErrors(err.errors);
-                    }
-                    if (err instanceof ServerDumpError) {
-                        resolve();
-                        return;
-                    }
-                    reject(err);
-                }
-            });
-        });
-    }, [data]);
-    return {
-        data,
-        setData,
-        errors: errors,
-        error,
-        hasErrors: Object.keys(errors).length > 0,
-        pending: isPending,
-        processing: isPending,
-        wasSuccessful,
-        recentlySuccessful,
-        clearErrors,
-        reset,
-        setDefaults,
-        transform: transformFn,
-        submit,
-    };
-}
-//# sourceMappingURL=useForm.js.map

package/dist/js/useForm.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"useForm.js","sourceRoot":"","sources":["../../src/js/useForm.ts"],"names":[],"mappings":"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","sourcesContent":["\"use client\";\n\nimport { useState, useRef, useCallback, useTransition } from \"react\";\nimport { ServerValidationError, ServerDumpError } from \"./errors\";\nimport { validateWith } from \"./standardSchema\";\nimport type { StandardSchemaV1 } from \"./standardSchema\";\n\ntype SetDataFn<T> = {\n  <K extends keyof T>(field: K, value: T[K]): void;\n  (values: Partial<T>): void;\n};\n\nexport interface UseFormReturn<T extends Record<string, unknown>> {\n  data: T;\n  setData: SetDataFn<T>;\n  errors: Partial<Record<keyof T & string, string[]>>;\n  error: (field: keyof T & string) => string | undefined;\n  hasErrors: boolean;\n  pending: boolean;\n  processing: boolean;\n  wasSuccessful: boolean;\n  recentlySuccessful: boolean;\n  clearErrors: (...fields: (keyof T & string)[]) => void;\n  reset: (...fields: (keyof T)[]) => void;\n  setDefaults: (values?: Partial<T>) => void;\n  transform: (fn: (data: T) => Record<string, unknown>) => void;\n  submit: (action: (formData: FormData) => Promise<unknown>, optimistic?: () => void) => Promise<void>;\n}\n\n/**\n * Serialize form state into FormData for a server action.\n *\n * Exported for testing: this is the contract between useForm and the action —\n * booleans become \"1\"/\"0\" so PHP sees something truthy, arrays repeat under\n * `key[]`, Files pass through untouched for native uploads, and null/undefined\n * are dropped rather than sent as the string \"null\".\n */\nexport function buildFormData(data: Record<string, unknown>): FormData {\n  const formData = new FormData();\n\n  for (const [key, val] of Object.entries(data)) {\n    if (val === null || val === undefined) {\n      continue;\n    }\n    if (val instanceof File) {\n      formData.append(key, val);\n    } else if (typeof val === \"boolean\") {\n      formData.append(key, val ? \"1\" : \"0\");\n    } else if (Array.isArray(val)) {\n      for (const item of val) {\n        formData.append(`${key}[]`, String(item));\n      }\n    } else {\n      formData.append(key, String(val));\n    }\n  }\n\n  return formData;\n}\n\nexport function useForm<T extends Record<string, unknown>>(\n  initialValues: T,\n  options: {\n    /**\n     * Check the fields before submitting, with any Standard Schema — Zod,\n     * Valibot, ArkType.\n     *\n     * A failure fills `errors` and the action is never called. A courtesy, not\n     * a control: the action is reachable without this form, so the server\n     * still has to check.\n     */\n    schema?: StandardSchemaV1\n  } = {},\n): UseFormReturn<T> {\n  const [data, setDataState] = useState<T>(initialValues);\n  const [errors, setErrors] = useState<Record<string, string[]>>({});\n  const [wasSuccessful, setWasSuccessful] = useState(false);\n  const [recentlySuccessful, setRecentlySuccessful] = useState(false);\n  const [isPending, startTransition] = useTransition();\n\n  const defaultsRef = useRef<T>({ ...initialValues });\n  const transformRef = useRef<((data: T) => Record<string, unknown>) | null>(null);\n  const recentTimerRef = useRef<ReturnType<typeof setTimeout> | undefined>(undefined);\n\n  const setData: SetDataFn<T> = useCallback(\n    (fieldOrValues: keyof T | Partial<T>, value?: unknown) => {\n      if (typeof fieldOrValues === \"object\") {\n        setDataState((prev) => ({ ...prev, ...fieldOrValues }));\n      } else {\n        setDataState((prev) => ({ ...prev, [fieldOrValues]: value as T[keyof T] }));\n      }\n    },\n    []\n  );\n\n  const error = useCallback(\n    (field: keyof T & string): string | undefined => errors[field]?.[0],\n    [errors]\n  );\n\n  const clearErrors = useCallback(\n    (...fields: (keyof T & string)[]) => {\n      if (fields.length === 0) {\n        setErrors({});\n      } else {\n        setErrors((prev) => {\n          const next = { ...prev };\n          for (const f of fields) {\n            delete next[f];\n          }\n          return next;\n        });\n      }\n    },\n    []\n  );\n\n  const reset = useCallback(\n    (...fields: (keyof T)[]) => {\n      if (fields.length === 0) {\n        setDataState({ ...defaultsRef.current });\n      } else {\n        setDataState((prev) => {\n          const next = { ...prev };\n          for (const f of fields) {\n            next[f] = defaultsRef.current[f];\n          }\n          return next;\n        });\n      }\n      clearErrors();\n    },\n    [clearErrors]\n  );\n\n  const setDefaults = useCallback(\n    (values?: Partial<T>) => {\n      if (values) {\n        defaultsRef.current = { ...defaultsRef.current, ...values };\n      } else {\n        defaultsRef.current = { ...data };\n      }\n    },\n    [data, options.schema]\n  );\n\n  const transformFn = useCallback(\n    (fn: (data: T) => Record<string, unknown>) => {\n      transformRef.current = fn;\n    },\n    []\n  );\n\n  const submit = useCallback(\n    (action: (formData: FormData) => Promise<unknown>, optimistic?: () => void): Promise<void> => {\n      return new Promise<void>((resolve, reject) => {\n        startTransition(async () => {\n          try {\n            // Before the optimistic update, so a rejected form never shows the\n            // row it was going to add.\n            const invalid = await validateWith(options.schema, data);\n\n            if (invalid) {\n              setErrors(invalid);\n              resolve();\n\n              return;\n            }\n\n            // Call optimistic updater inside the transition so React's\n            // useOptimistic picks it up and auto-reverts on settle.\n            optimistic?.();\n\n            const payload = transformRef.current ? transformRef.current(data) : data;\n            const formData = buildFormData(payload);\n\n            setErrors({});\n\n            const result = await action(formData);\n            const answer = result as\n              | { validationErrors?: Record<string, string[]>; serverError?: string }\n              | undefined\n\n            // An action built with createActionClient returns its failures\n            // rather than throwing them, because a rejected server action is\n            // serialised opaquely and the fields it named would be lost.\n            if (answer?.validationErrors) {\n              setErrors(answer.validationErrors);\n              resolve();\n\n              return;\n            }\n\n            if (answer?.serverError) {\n              reject(new Error(answer.serverError));\n\n              return;\n            }\n\n            setWasSuccessful(true);\n            setRecentlySuccessful(true);\n\n            if (recentTimerRef.current) {\n              clearTimeout(recentTimerRef.current);\n            }\n            recentTimerRef.current = setTimeout(() => setRecentlySuccessful(false), 2000);\n\n            resolve();\n          } catch (err) {\n            if (err instanceof ServerValidationError) {\n              setErrors(err.errors);\n            }\n            if (err instanceof ServerDumpError) {\n              resolve();\n              return;\n            }\n            reject(err);\n          }\n        });\n      });\n    },\n    [data]\n  );\n\n  return {\n    data,\n    setData,\n    errors: errors as Partial<Record<keyof T & string, string[]>>,\n    error,\n    hasErrors: Object.keys(errors).length > 0,\n    pending: isPending,\n    processing: isPending,\n    wasSuccessful,\n    recentlySuccessful,\n    clearErrors,\n    reset,\n    setDefaults,\n    transform: transformFn,\n    submit,\n  };\n}\n"]}