@rsc-kit/core 0.30.7 → 0.30.9

package/dist/action.d.ts

@@ -177,6 +177,13 @@ type InputOf<S> = S extends StandardSchemaV1<infer I, unknown> ? I : unknown;
  * it, which is how a form calls the same action. Without a schema, anything.
  */
 export type Action<Raw, Data, Refusal = never> = unknown extends Raw ? (input?: unknown) => Promise<ActionResult<Data, Refusal>> : undefined extends Raw ? (input?: Raw | FormData) => Promise<ActionResult<Data, Refusal>> : (input: Raw | FormData) => Promise<ActionResult<Data, Refusal>>;
+/**
+ * What `.query()` returns: the same three cases as an action, without the
+ * FormData a form posts. A query is read with arguments, so a key the schema
+ * does not have fails the typecheck rather than the read - it was
+ * `(input?: unknown)`, and `getLogs({ team: 1, nonsense: true })` compiled.
+ */
+export type Query<Raw, Data> = unknown extends Raw ? (input?: unknown) => Promise<Data> : undefined extends Raw ? (input?: Raw) => Promise<Data> : (input: Raw) => Promise<Data>;
 export interface ActionBuilder<Ctx extends Record<string, unknown>, Input, Raw = unknown, Refusal = never> {
     /** Add a step, and whatever context it contributes. */
     use<Extra extends Record<string, unknown> = Record<string, never>>(middleware: (args: {
@@ -222,7 +229,7 @@ export interface ActionBuilder<Ctx extends Record<string, unknown>, Input, Raw =
     query<Data>(fn: (args: {
         input: Input;
         ctx: Ctx;
-    }) => Promise<Data> | Data, options?: QueryOptions): (input?: unknown) => Promise<Delivered<Data>>;
+    }) => Promise<Data> | Data, options?: QueryOptions): Query<Raw, Delivered<Data>>;
 }
 export interface ActionClientOptions {
     /**

package/dist/action.js.map

@@ -1 +1 @@
-{"version":3,"file":"action.js","sourceRoot":"","sources":["../src/action.ts"],"names":[],"mappings":"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","sourcesContent":["// Server actions with a schema, middleware, and types that follow from both.\n//\n//     export const action = createActionClient({ onError: report })\n//\n//     export const createPost = action\n//       .use(async ({ next }) => next({ ctx: { user: await currentUser() } }))\n//       .input(z.object({ title: z.string().min(3) }))\n//       .handler(async ({ input, ctx }) => savePost(ctx.user.id, input.title))\n//\n// `input` is typed from the schema and `ctx` from every middleware that ran, so\n// the handler is checked against both without either being written down twice.\n//\n// The built action RETURNS its failures rather than throwing them, and that is\n// not a style choice. React serialises a rejected server action opaquely —\n// production strips the message and leaves a digest — so a thrown validation\n// error reaches the browser as \"an error occurred\" and the fields it named are\n// gone. A returned object crosses the boundary intact.\n//\n// Distinct from `middleware.ts` in a route directory, which decides whether a\n// page may render. This wraps one action. They are different questions: an\n// action is reachable without any page, which is why it defends itself.\n\nimport { validateWith, type StandardSchemaV1 } from './js/standardSchema.js'\nimport { decodeFormData } from './js/formEncoding.js'\nimport { markQuery, QueryValidationError, type QueryOptions } from './query.js'\nimport { isRedirectSignal } from './redirectDigest.js'\nimport { isNotFoundSignal } from './notFound.js'\nimport { ServerAuthenticationError, ServerAuthorizationError, type Redirected } from './js/errors.js'\n\n/**\n * What an action answers with. One of `data`, `validationErrors`,\n * `serverError` and `redirected` is set; `refusal` only ever beside\n * `serverError`.\n */\nexport interface ActionResult<Data, Refusal = never> {\n  /** What the handler returned. */\n  data?: Data\n  /** Field name to messages, in the shape a form already renders. */\n  validationErrors?: Record<string, string[]>\n  /**\n   * The action did not happen, as a message the browser may see: a refusal's\n   * own message - see `refuse()` - or something unexpected, reduced by\n   * `onError` to one that says nothing a stranger should not see.\n   */\n  serverError?: string\n  /**\n   * What a refusal said beside its message - the things blocking a delete,\n   * say - checked against the schema the action declared with `.refusal()`\n   * and typed from it. Set only by `refuse()`, here or on the backend.\n   */\n  refusal?: Refusal\n  /**\n   * Where the action sent the visitor. Set by the client, which has already\n   * started the navigation: the page is on its way there, and there is\n   * nothing for the caller to do. Never set on the server side of the call.\n   */\n  redirected?: string\n}\n\n/**\n * A middleware that neither continued nor refused.\n *\n * Never reported through `onError`: that reduces an error to a message for the\n * browser, and this one is for whoever wrote the middleware. A check that\n * forgot to call `next()` would otherwise look exactly like a check that\n * passed.\n */\nexport class ActionMisuse extends Error {\n  constructor(message: string) {\n    super(message)\n    this.name = 'ActionMisuse'\n  }\n}\n\n/** Refuse from inside a handler, naming the fields. */\n/**\n * Marks a refusal so it survives a bundle seam.\n *\n * A property rather than `instanceof`, for the reason this project keeps\n * running into: an app's actions are bundled separately from the engine, so\n * each gets its own copy of this module and its own copy of the class.\n * `instanceof` compares identity across that seam and is simply false — and\n * the refusal is then reported as a server error, so the form shows \"Something\n * went wrong\" instead of naming the fields. Everything works; nothing logs.\n *\n * Symbol.for, so the two copies agree on the key as well as the value.\n */\nconst VALIDATION_MARK = Symbol.for('@rsc-kit/core.action-validation')\n\n/**\n * Set on every function a client builds, so the build can tell them from a\n * bare \"use server\" export. The difference is the middleware: a bare export\n * runs with nothing checking who called it, and nothing else in the app\n * would ever say so. Symbol.for, because the build reads the mark from the\n * bundled copy of this module and the app's actions were built by another.\n */\nconst CLIENT_MARK = Symbol.for('@rsc-kit/core.action-client')\n\n/** Whether a server action was built by createActionClient, and so ran its chain. */\nexport function isClientBuilt(fn: unknown): boolean {\n  return typeof fn === 'function' && (fn as unknown as Record<symbol, unknown>)[CLIENT_MARK] === true\n}\n\nfunction markClientBuilt<F extends Function>(fn: F): F {\n  Object.defineProperty(fn, CLIENT_MARK, { value: true })\n\n  return fn\n}\n\nexport class ActionValidationError extends Error {\n  public readonly errors: Record<string, string[]>\n\n  constructor(errors: Record<string, string[]>) {\n    super('Validation failed')\n    this.name = 'ActionValidationError'\n    this.errors = errors\n    ;(this as unknown as Record<symbol, boolean>)[VALIDATION_MARK] = true\n  }\n}\n\n/** Whether this is a refusal, whichever copy of the class built it. */\nexport function isActionValidationError(error: unknown): error is ActionValidationError {\n  return (\n    typeof error === 'object' &&\n    error !== null &&\n    (error as Record<symbol, unknown>)[VALIDATION_MARK] === true\n  )\n}\n\n/**\n * The field errors a handler may report, keyed by its own input's fields.\n *\n * `''` is the whole submission — for a refusal that is about no field in\n * particular, which is where the form already looks for one.\n */\nexport type FieldErrorsFor<Input> = Partial<\n  Record<(Input extends object ? keyof Input & string : string) | '', string | string[]>\n>\n\nconst REFUSAL_MARK = Symbol.for('@rsc-kit/core.action-refusal')\n\n/**\n * What a handler's data is, without the redirect a generated stub's type adds.\n *\n * A stub is typed `Promise<T | Redirected>` for the browser, where a redirected\n * call resolves with `{ redirected }`. Called from a handler it runs on the\n * server, where the redirect is thrown and travels as one, so its result is\n * only ever `T` - and `data` would say `T | Redirected`, a case the client\n * reports beside `data` and never inside it. Only a member that is exactly\n * `Redirected` goes: data that merely has a `redirected` field stays.\n */\nexport type Delivered<T> = T extends Redirected ? (Redirected extends T ? never : T) : T\n\n/**\n * An action declining to do what it was asked, on purpose, with a message for\n * the person who asked and - optionally - data the page can act on: the\n * records blocking a delete, the plan a quota belongs to.\n *\n * Not a validation error: the input was fine, the state of things says no.\n * And not a failure: its message is meant to be seen, so it is never\n * replaced by `onError`'s \"Something went wrong.\". It arrives as the result's\n * `serverError`, which is where a form's `formError` already reads, and its\n * data as `refusal`.\n */\nexport class ActionRefusal extends Error {\n  public readonly data: unknown\n  /** The status a request that is not an action - a page, a form posted without javascript - answers with. */\n  public readonly refusalStatus: number\n\n  constructor(message: string, data?: unknown, status = 409) {\n    super(message)\n    this.name = 'ActionRefusal'\n    this.data = data\n    this.refusalStatus = status\n    ;(this as unknown as Record<symbol, boolean>)[REFUSAL_MARK] = true\n  }\n}\n\n/** Whether this is a refusal, whichever copy of the class built it. */\nexport function isActionRefusal(error: unknown): error is ActionRefusal {\n  return typeof error === 'object' && error !== null && (error as Record<symbol, unknown>)[REFUSAL_MARK] === true\n}\n\n/**\n * Decline, with a message to show and optional data to act on. Throws.\n *\n *     if (attached.length) refuse('Still in use', { blockers: attached })\n *\n * From a handler, a middleware or anything they call. The data reaches the\n * page only when the action declares its shape with `.refusal(schema)`, and\n * only once it matches - see ActionResult.refusal. Inside a handler, the\n * `refuse` it is given is typed to that schema; this one takes anything.\n */\nexport function refuse(message: string, data?: unknown, options: { status?: number } = {}): never {\n  throw new ActionRefusal(message, data, options.status)\n}\n\n/**\n * What a handler is given.\n *\n * `fieldErrors` is here as well as exported on its own, and the one here is\n * the one to use: it is typed to this handler's input, so a field the schema\n * does not have is a type error rather than an error the form never shows.\n * The bare export takes any string, for the rare check that runs outside a\n * handler.\n */\nexport interface HandlerArgs<Input, Ctx, Refusal = never> {\n  input: Input\n  ctx: Ctx\n  /**\n   * Decline, with a message and the data the action declared with\n   * `.refusal(schema)`. Throws; write `return refuse(...)`, as with\n   * fieldErrors.\n   */\n  refuse: [Refusal] extends [never]\n    ? (message: string) => never\n    : (message: string, data: Refusal, options?: { status?: number }) => never\n  /**\n   * Fail with errors on this input's fields. Throws; nothing after it runs.\n   *\n   * Write `return fieldErrors(...)`. It throws either way, but TypeScript does\n   * not treat a never-return as terminating when the callee is a destructured\n   * binding — only a declaration or an explicitly annotated variable — so\n   * without the return, a value checked on the line above is still possibly\n   * undefined on the line below. The return is what lets the type narrow.\n   */\n  fieldErrors: (errors: FieldErrorsFor<Input>) => never\n}\n\n/**\n * Fail with field errors the form can show.\n *\n * For what a schema cannot know — a name already taken, a balance too low.\n * Throws, so the handler stops where it is; the action turns it into a\n * returned result on the way out.\n *\n * Untyped by field, because it has no handler to take the input from. Inside\n * one, use the `fieldErrors` the handler is given instead.\n */\nexport function fieldErrors(errors: Record<string, string[] | string>): never {\n  const normalised: Record<string, string[]> = {}\n\n  for (const [field, message] of Object.entries(errors)) {\n    normalised[field] = Array.isArray(message) ? message : [message]\n  }\n\n  throw new ActionValidationError(normalised)\n}\n\n/**\n * What `next()` hands back, carrying what the step added.\n *\n * The context a middleware contributes cannot be inferred from the arguments\n * it passes to `next` — TypeScript infers from a function's return, not from a\n * call inside it. So `next` returns this, the middleware returns it, and the\n * addition is read off the middleware's own return type.\n */\nexport interface MiddlewareResult<Extra> {\n  readonly ctx: Extra\n  readonly value: unknown\n}\n\n/**\n * A step that runs before the handler.\n *\n * It calls `next` to continue, optionally adding to the context, and what it\n * adds shows up in the handler's types. Returning without calling `next` — or\n * throwing — stops the action, which is how a check refuses.\n */\nexport type ActionMiddleware<Ctx, Extra extends Record<string, unknown>> = (args: {\n  ctx: Ctx\n  next: <E extends Record<string, unknown> = Record<string, never>>(\n    opts?: { ctx?: E },\n  ) => Promise<MiddlewareResult<E>>\n}) => Promise<MiddlewareResult<Extra>>\n\ntype Output<S> = S extends StandardSchemaV1<unknown, infer O> ? O : never\n\n/** What a caller may pass, before the schema parses it. */\ntype InputOf<S> = S extends StandardSchemaV1<infer I, unknown> ? I : unknown\n\n/**\n * A built action, as its callers see it.\n *\n * Typed from the schema's input when there is one, so a call with the wrong\n * shape fails the typecheck rather than the validation - and FormData beside\n * it, which is how a form calls the same action. Without a schema, anything.\n */\nexport type Action<Raw, Data, Refusal = never> = unknown extends Raw\n  ? (input?: unknown) => Promise<ActionResult<Data, Refusal>>\n  : undefined extends Raw\n    ? (input?: Raw | FormData) => Promise<ActionResult<Data, Refusal>>\n    : (input: Raw | FormData) => Promise<ActionResult<Data, Refusal>>\n\nexport interface ActionBuilder<Ctx extends Record<string, unknown>, Input, Raw = unknown, Refusal = never> {\n  /** Add a step, and whatever context it contributes. */\n  use<Extra extends Record<string, unknown> = Record<string, never>>(\n    middleware: (args: {\n      ctx: Ctx\n      next: <E extends Record<string, unknown> = Record<string, never>>(\n        opts?: { ctx?: E },\n      ) => Promise<MiddlewareResult<E>>\n    }) => Promise<MiddlewareResult<Extra>>,\n  ): ActionBuilder<Ctx & Extra, Input, Raw, Refusal>\n  /** Parse and check what the caller sent. The handler's `input` follows. */\n  input<S extends StandardSchemaV1>(schema: S): ActionBuilder<Ctx, Output<S>, InputOf<S>, Refusal>\n  /**\n   * The shape of what a refusal may carry - see `refuse()`. The page gets\n   * `result.refusal` typed from it, and only data that matches it: data that\n   * does not is a bug in the server, answered as one.\n   */\n  refusal<S extends StandardSchemaV1>(schema: S): ActionBuilder<Ctx, Input, Raw, Output<S>>\n  /**\n   * The body.\n   *\n   * What the caller gets is always the result object: `data`, or a\n   * refusal, or - when the action redirected - `redirected`, set by the\n   * client once the navigation is under way. Always an object, so a caller\n   * reading `result.validationErrors` after a redirect reads undefined and\n   * not a TypeError inside a transition, which unmounts the root.\n   */\n  handler<Data>(\n    fn: (args: HandlerArgs<Input, Ctx, Refusal>) => Promise<Data> | Data,\n  ): Action<Raw, Delivered<Data>, Refusal>\n  /**\n   * The body of a READ, sharing this client's middleware and schema.\n   *\n   *     export const getPosts = client.input(filter).query(async ({ input, ctx }) =>\n   *       db.posts(ctx.user.id, input))\n   *\n   * The same builder as `handler`, and deliberately so: an app configures its\n   * auth check and its error reporting once, and both a mutation and a read go\n   * through them.\n   *\n   * It fails differently, though, and that is not an oversight. An action\n   * RETURNS its failures because React serialises a rejection opaquely. A query\n   * is handed to a cache library as a fetcher, and every one of them reports\n   * failure by rejection — so this returns the data directly and throws, and\n   * the endpoint carries the message across for it.\n   */\n  query<Data>(\n    fn: (args: { input: Input; ctx: Ctx }) => Promise<Data> | Data,\n    options?: QueryOptions,\n  ): (input?: unknown) => Promise<Delivered<Data>>\n}\n\nexport interface ActionClientOptions {\n  /**\n   * What the browser is told when something unexpected throws.\n   *\n   * Everything reaching here is a bug or an outage, and its message may say\n   * more than a stranger should see — a query, a path, a host. Returning a\n   * fixed string is the safe default; return the message only for errors you\n   * raised deliberately.\n   */\n  onError?: (error: unknown) => string\n}\n\nconst GENERIC = 'Something went wrong.'\n\n/**\n * Whether the backend turned this caller away: not signed in, not allowed, or\n * nothing there for them. Each carries a message written for the person.\n */\nfunction turnedAway(error: unknown): error is Error {\n  return (\n    error instanceof ServerAuthenticationError || error instanceof ServerAuthorizationError || isNotFoundSignal(error)\n  )\n}\n\n/**\n * FormData in, a plain object out — what a schema expects to be handed.\n *\n * The form's own decoder, so the object validated here is the object the\n * browser validated. This had a flat decoder of its own: `items[0].name`\n * stayed a key spelled exactly that, `<Form>` had already parsed it into an\n * array, and a nested form passed in the browser and failed on the server\n * with the fields it named gone.\n */\nconst fromFormData = (body: FormData, schema: unknown): Record<string, unknown> => decodeFormData(body, schema)\n\nexport function createActionClient(\n  options: ActionClientOptions = {},\n): ActionBuilder<Record<never, never>, undefined> {\n  const report = options.onError ?? (() => GENERIC)\n\n  function build<Ctx extends Record<string, unknown>, Input>(\n    middlewares: ActionMiddleware<never, never>[],\n    schema: StandardSchemaV1 | null,\n    refusalSchema: StandardSchemaV1 | null = null,\n  ): ActionBuilder<Ctx, Input> {\n      /**\n       * Validate, run the chain, call the body.\n       *\n       * Shared by both terminals, which is the point of putting a read on this\n       * builder at all: one set of middleware, one schema, one place the auth\n       * check lives. Refusals leave by throwing, and each terminal decides what\n       * that should look like from the outside.\n       */\n    const pipeline = async (\n      raw: unknown,\n      fn: (args: HandlerArgs<never, never>) => unknown,\n    ): Promise<unknown> => {\n      const value = raw instanceof FormData ? fromFormData(raw, schema) : raw\n\n      if (schema) {\n        const invalid = await validateWith(schema, value)\n\n        if (invalid) throw new ActionValidationError(invalid)\n      }\n\n      const parsed = schema\n        ? ((await schema['~standard'].validate(value)).value as Input)\n        : (value as Input)\n\n      // Composed inside-out so the first `use` is the outermost — it sees the\n      // others run, which is what makes timing and cleanup possible rather\n      // than only checks.\n      let ctx = {} as Ctx\n      let index = 0\n\n      const run = async (): Promise<unknown> => {\n        const middleware = middlewares[index++]\n\n        if (!middleware) {\n          return await fn({\n            input: parsed as never,\n            ctx: ctx as never,\n            // The same function as the export; the type on the way in is what\n            // is different, and the type is the handler's input.\n            fieldErrors: fieldErrors as never,\n            refuse: refuse as never,\n          })\n        }\n\n        let continued = false\n\n        const result = await (middleware as unknown as ActionMiddleware<Ctx, Record<string, unknown>>)({\n          ctx,\n          next: (async (opts?: { ctx?: Record<string, unknown> }) => {\n            continued = true\n            ctx = { ...ctx, ...(opts?.ctx ?? {}) } as Ctx\n\n            return { ctx, value: await run() }\n          }) as never,\n        })\n\n        // Silence is not refusal. A middleware that neither called next() nor\n        // threw has done nothing, and guessing which it meant turns a\n        // forgotten `return` into a check that quietly passes.\n        if (!continued) {\n          throw new ActionMisuse(\n            'A middleware returned without calling next(). Call it to continue, or throw to refuse.',\n          )\n        }\n\n        return (result as { value?: unknown })?.value\n      }\n\n      return await run()\n    }\n\n    /**\n     * A refusal as the page gets it: its message, always - it was written to\n     * be seen - and its data only once the declared schema has checked it.\n     * Data with no schema to check it, or that fails the schema, never\n     * reaches the browser: the first is said in the server's log, the second\n     * is a bug in the server, returned as the error each terminal reports.\n     */\n    const refusalResult = async (error: ActionRefusal): Promise<ActionResult<never, unknown> | Error> => {\n      if (error.data === undefined) return { serverError: error.message }\n\n      if (!refusalSchema) {\n        console.error(\n          `[rsc-kit] An action refused with data, and declares no .refusal(schema) for it - the message was sent, the data was not: ${error.message}`,\n        )\n\n        return { serverError: error.message }\n      }\n\n      const checked = await refusalSchema['~standard'].validate(error.data)\n\n      if (checked.issues) {\n        return new Error(\n          `An action refused with data its .refusal(schema) does not accept: ${checked.issues.map((issue) => issue.message).join('; ')}`,\n        )\n      }\n\n      return { serverError: error.message, refusal: checked.value }\n    }\n\n    return {\n      use(middleware) {\n        return build([...middlewares, middleware as never], schema, refusalSchema) as never\n      },\n      input(next) {\n        return build(middlewares, next, refusalSchema) as never\n      },\n      refusal(next) {\n        return build(middlewares, schema, next) as never\n      },\n      handler(fn) {\n        // Delivered is a type-only difference from what the body returns:\n        // the value is passed through as it is.\n        return markClientBuilt(async (raw?: unknown) => {\n          try {\n            return { data: (await pipeline(raw, fn)) as Awaited<ReturnType<typeof fn>> }\n          } catch (error) {\n            // Past onError deliberately — see ActionMisuse.\n            if (error instanceof ActionMisuse) throw error\n\n            // A redirect is an instruction, not a failure: it has to reach\n            // the host, which answers the action with the destination. Caught\n            // here it became { serverError: 'Something went wrong.' } - a\n            // login that succeeded and then showed an error.\n            if (isRedirectSignal(error)) throw error\n\n            if (isActionValidationError(error)) {\n              return { validationErrors: error.errors }\n            }\n\n            if (isActionRefusal(error)) {\n              const refused = await refusalResult(error)\n\n              return (refused instanceof Error ? { serverError: report(refused) } : refused) as ActionResult<never>\n            }\n\n            // Turned away by the backend - not signed in, not allowed, no such\n            // record - is an answer too, and its message is meant to be seen.\n            // Not rethrown as a redirect is: the action endpoint answers a\n            // throw with a 500, and the form would show nothing at all.\n            if (turnedAway(error)) return { serverError: error.message }\n\n            return { serverError: report(error) }\n          }\n        }) as never\n      },\n      query(fn, options) {\n        const read = async (raw?: unknown) => {\n          try {\n            return await pipeline(raw, fn)\n          } catch (error) {\n            if (error instanceof ActionMisuse) throw error\n            if (isRedirectSignal(error)) throw error\n\n            // Left as they are, as a redirect is. A page that reads through a\n            // query answers 401, 403 or its not-found page, as it does calling\n            // the backend directly; the read endpoint answers the same statuses.\n            if (turnedAway(error)) throw error\n\n            // Thrown, not returned. A cache library reports failure by\n            // rejection, so a query that answered with an error-shaped object\n            // would look like a successful read of something odd.\n            if (isActionValidationError(error)) {\n              throw new QueryValidationError(error.errors)\n            }\n\n            // Its own message, as an action's is, and its checked data on\n            // the error for a fetcher that wants it.\n            if (isActionRefusal(error)) {\n              const refused = await refusalResult(error)\n\n              if (refused instanceof Error) throw new Error(report(refused))\n\n              throw Object.assign(new Error(refused.serverError), {\n                refusal: refused.refusal,\n                refusalStatus: error.refusalStatus,\n              })\n            }\n\n            throw new Error(report(error))\n          }\n        }\n\n        return markClientBuilt(markQuery(read, options)) as (input?: unknown) => Promise<never>\n      },\n    }\n  }\n\n  return build([], null)\n}\n"]}
+{"version":3,"file":"action.js","sourceRoot":"","sources":["../src/action.ts"],"names":[],"mappings":"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","sourcesContent":["// Server actions with a schema, middleware, and types that follow from both.\n//\n//     export const action = createActionClient({ onError: report })\n//\n//     export const createPost = action\n//       .use(async ({ next }) => next({ ctx: { user: await currentUser() } }))\n//       .input(z.object({ title: z.string().min(3) }))\n//       .handler(async ({ input, ctx }) => savePost(ctx.user.id, input.title))\n//\n// `input` is typed from the schema and `ctx` from every middleware that ran, so\n// the handler is checked against both without either being written down twice.\n//\n// The built action RETURNS its failures rather than throwing them, and that is\n// not a style choice. React serialises a rejected server action opaquely —\n// production strips the message and leaves a digest — so a thrown validation\n// error reaches the browser as \"an error occurred\" and the fields it named are\n// gone. A returned object crosses the boundary intact.\n//\n// Distinct from `middleware.ts` in a route directory, which decides whether a\n// page may render. This wraps one action. They are different questions: an\n// action is reachable without any page, which is why it defends itself.\n\nimport { validateWith, type StandardSchemaV1 } from './js/standardSchema.js'\nimport { decodeFormData } from './js/formEncoding.js'\nimport { markQuery, QueryValidationError, type QueryOptions } from './query.js'\nimport { isRedirectSignal } from './redirectDigest.js'\nimport { isNotFoundSignal } from './notFound.js'\nimport { ServerAuthenticationError, ServerAuthorizationError, type Redirected } from './js/errors.js'\n\n/**\n * What an action answers with. One of `data`, `validationErrors`,\n * `serverError` and `redirected` is set; `refusal` only ever beside\n * `serverError`.\n */\nexport interface ActionResult<Data, Refusal = never> {\n  /** What the handler returned. */\n  data?: Data\n  /** Field name to messages, in the shape a form already renders. */\n  validationErrors?: Record<string, string[]>\n  /**\n   * The action did not happen, as a message the browser may see: a refusal's\n   * own message - see `refuse()` - or something unexpected, reduced by\n   * `onError` to one that says nothing a stranger should not see.\n   */\n  serverError?: string\n  /**\n   * What a refusal said beside its message - the things blocking a delete,\n   * say - checked against the schema the action declared with `.refusal()`\n   * and typed from it. Set only by `refuse()`, here or on the backend.\n   */\n  refusal?: Refusal\n  /**\n   * Where the action sent the visitor. Set by the client, which has already\n   * started the navigation: the page is on its way there, and there is\n   * nothing for the caller to do. Never set on the server side of the call.\n   */\n  redirected?: string\n}\n\n/**\n * A middleware that neither continued nor refused.\n *\n * Never reported through `onError`: that reduces an error to a message for the\n * browser, and this one is for whoever wrote the middleware. A check that\n * forgot to call `next()` would otherwise look exactly like a check that\n * passed.\n */\nexport class ActionMisuse extends Error {\n  constructor(message: string) {\n    super(message)\n    this.name = 'ActionMisuse'\n  }\n}\n\n/** Refuse from inside a handler, naming the fields. */\n/**\n * Marks a refusal so it survives a bundle seam.\n *\n * A property rather than `instanceof`, for the reason this project keeps\n * running into: an app's actions are bundled separately from the engine, so\n * each gets its own copy of this module and its own copy of the class.\n * `instanceof` compares identity across that seam and is simply false — and\n * the refusal is then reported as a server error, so the form shows \"Something\n * went wrong\" instead of naming the fields. Everything works; nothing logs.\n *\n * Symbol.for, so the two copies agree on the key as well as the value.\n */\nconst VALIDATION_MARK = Symbol.for('@rsc-kit/core.action-validation')\n\n/**\n * Set on every function a client builds, so the build can tell them from a\n * bare \"use server\" export. The difference is the middleware: a bare export\n * runs with nothing checking who called it, and nothing else in the app\n * would ever say so. Symbol.for, because the build reads the mark from the\n * bundled copy of this module and the app's actions were built by another.\n */\nconst CLIENT_MARK = Symbol.for('@rsc-kit/core.action-client')\n\n/** Whether a server action was built by createActionClient, and so ran its chain. */\nexport function isClientBuilt(fn: unknown): boolean {\n  return typeof fn === 'function' && (fn as unknown as Record<symbol, unknown>)[CLIENT_MARK] === true\n}\n\nfunction markClientBuilt<F extends Function>(fn: F): F {\n  Object.defineProperty(fn, CLIENT_MARK, { value: true })\n\n  return fn\n}\n\nexport class ActionValidationError extends Error {\n  public readonly errors: Record<string, string[]>\n\n  constructor(errors: Record<string, string[]>) {\n    super('Validation failed')\n    this.name = 'ActionValidationError'\n    this.errors = errors\n    ;(this as unknown as Record<symbol, boolean>)[VALIDATION_MARK] = true\n  }\n}\n\n/** Whether this is a refusal, whichever copy of the class built it. */\nexport function isActionValidationError(error: unknown): error is ActionValidationError {\n  return (\n    typeof error === 'object' &&\n    error !== null &&\n    (error as Record<symbol, unknown>)[VALIDATION_MARK] === true\n  )\n}\n\n/**\n * The field errors a handler may report, keyed by its own input's fields.\n *\n * `''` is the whole submission — for a refusal that is about no field in\n * particular, which is where the form already looks for one.\n */\nexport type FieldErrorsFor<Input> = Partial<\n  Record<(Input extends object ? keyof Input & string : string) | '', string | string[]>\n>\n\nconst REFUSAL_MARK = Symbol.for('@rsc-kit/core.action-refusal')\n\n/**\n * What a handler's data is, without the redirect a generated stub's type adds.\n *\n * A stub is typed `Promise<T | Redirected>` for the browser, where a redirected\n * call resolves with `{ redirected }`. Called from a handler it runs on the\n * server, where the redirect is thrown and travels as one, so its result is\n * only ever `T` - and `data` would say `T | Redirected`, a case the client\n * reports beside `data` and never inside it. Only a member that is exactly\n * `Redirected` goes: data that merely has a `redirected` field stays.\n */\nexport type Delivered<T> = T extends Redirected ? (Redirected extends T ? never : T) : T\n\n/**\n * An action declining to do what it was asked, on purpose, with a message for\n * the person who asked and - optionally - data the page can act on: the\n * records blocking a delete, the plan a quota belongs to.\n *\n * Not a validation error: the input was fine, the state of things says no.\n * And not a failure: its message is meant to be seen, so it is never\n * replaced by `onError`'s \"Something went wrong.\". It arrives as the result's\n * `serverError`, which is where a form's `formError` already reads, and its\n * data as `refusal`.\n */\nexport class ActionRefusal extends Error {\n  public readonly data: unknown\n  /** The status a request that is not an action - a page, a form posted without javascript - answers with. */\n  public readonly refusalStatus: number\n\n  constructor(message: string, data?: unknown, status = 409) {\n    super(message)\n    this.name = 'ActionRefusal'\n    this.data = data\n    this.refusalStatus = status\n    ;(this as unknown as Record<symbol, boolean>)[REFUSAL_MARK] = true\n  }\n}\n\n/** Whether this is a refusal, whichever copy of the class built it. */\nexport function isActionRefusal(error: unknown): error is ActionRefusal {\n  return typeof error === 'object' && error !== null && (error as Record<symbol, unknown>)[REFUSAL_MARK] === true\n}\n\n/**\n * Decline, with a message to show and optional data to act on. Throws.\n *\n *     if (attached.length) refuse('Still in use', { blockers: attached })\n *\n * From a handler, a middleware or anything they call. The data reaches the\n * page only when the action declares its shape with `.refusal(schema)`, and\n * only once it matches - see ActionResult.refusal. Inside a handler, the\n * `refuse` it is given is typed to that schema; this one takes anything.\n */\nexport function refuse(message: string, data?: unknown, options: { status?: number } = {}): never {\n  throw new ActionRefusal(message, data, options.status)\n}\n\n/**\n * What a handler is given.\n *\n * `fieldErrors` is here as well as exported on its own, and the one here is\n * the one to use: it is typed to this handler's input, so a field the schema\n * does not have is a type error rather than an error the form never shows.\n * The bare export takes any string, for the rare check that runs outside a\n * handler.\n */\nexport interface HandlerArgs<Input, Ctx, Refusal = never> {\n  input: Input\n  ctx: Ctx\n  /**\n   * Decline, with a message and the data the action declared with\n   * `.refusal(schema)`. Throws; write `return refuse(...)`, as with\n   * fieldErrors.\n   */\n  refuse: [Refusal] extends [never]\n    ? (message: string) => never\n    : (message: string, data: Refusal, options?: { status?: number }) => never\n  /**\n   * Fail with errors on this input's fields. Throws; nothing after it runs.\n   *\n   * Write `return fieldErrors(...)`. It throws either way, but TypeScript does\n   * not treat a never-return as terminating when the callee is a destructured\n   * binding — only a declaration or an explicitly annotated variable — so\n   * without the return, a value checked on the line above is still possibly\n   * undefined on the line below. The return is what lets the type narrow.\n   */\n  fieldErrors: (errors: FieldErrorsFor<Input>) => never\n}\n\n/**\n * Fail with field errors the form can show.\n *\n * For what a schema cannot know — a name already taken, a balance too low.\n * Throws, so the handler stops where it is; the action turns it into a\n * returned result on the way out.\n *\n * Untyped by field, because it has no handler to take the input from. Inside\n * one, use the `fieldErrors` the handler is given instead.\n */\nexport function fieldErrors(errors: Record<string, string[] | string>): never {\n  const normalised: Record<string, string[]> = {}\n\n  for (const [field, message] of Object.entries(errors)) {\n    normalised[field] = Array.isArray(message) ? message : [message]\n  }\n\n  throw new ActionValidationError(normalised)\n}\n\n/**\n * What `next()` hands back, carrying what the step added.\n *\n * The context a middleware contributes cannot be inferred from the arguments\n * it passes to `next` — TypeScript infers from a function's return, not from a\n * call inside it. So `next` returns this, the middleware returns it, and the\n * addition is read off the middleware's own return type.\n */\nexport interface MiddlewareResult<Extra> {\n  readonly ctx: Extra\n  readonly value: unknown\n}\n\n/**\n * A step that runs before the handler.\n *\n * It calls `next` to continue, optionally adding to the context, and what it\n * adds shows up in the handler's types. Returning without calling `next` — or\n * throwing — stops the action, which is how a check refuses.\n */\nexport type ActionMiddleware<Ctx, Extra extends Record<string, unknown>> = (args: {\n  ctx: Ctx\n  next: <E extends Record<string, unknown> = Record<string, never>>(\n    opts?: { ctx?: E },\n  ) => Promise<MiddlewareResult<E>>\n}) => Promise<MiddlewareResult<Extra>>\n\ntype Output<S> = S extends StandardSchemaV1<unknown, infer O> ? O : never\n\n/** What a caller may pass, before the schema parses it. */\ntype InputOf<S> = S extends StandardSchemaV1<infer I, unknown> ? I : unknown\n\n/**\n * A built action, as its callers see it.\n *\n * Typed from the schema's input when there is one, so a call with the wrong\n * shape fails the typecheck rather than the validation - and FormData beside\n * it, which is how a form calls the same action. Without a schema, anything.\n */\nexport type Action<Raw, Data, Refusal = never> = unknown extends Raw\n  ? (input?: unknown) => Promise<ActionResult<Data, Refusal>>\n  : undefined extends Raw\n    ? (input?: Raw | FormData) => Promise<ActionResult<Data, Refusal>>\n    : (input: Raw | FormData) => Promise<ActionResult<Data, Refusal>>\n\n/**\n * What `.query()` returns: the same three cases as an action, without the\n * FormData a form posts. A query is read with arguments, so a key the schema\n * does not have fails the typecheck rather than the read - it was\n * `(input?: unknown)`, and `getLogs({ team: 1, nonsense: true })` compiled.\n */\nexport type Query<Raw, Data> = unknown extends Raw\n  ? (input?: unknown) => Promise<Data>\n  : undefined extends Raw\n    ? (input?: Raw) => Promise<Data>\n    : (input: Raw) => Promise<Data>\n\nexport interface ActionBuilder<Ctx extends Record<string, unknown>, Input, Raw = unknown, Refusal = never> {\n  /** Add a step, and whatever context it contributes. */\n  use<Extra extends Record<string, unknown> = Record<string, never>>(\n    middleware: (args: {\n      ctx: Ctx\n      next: <E extends Record<string, unknown> = Record<string, never>>(\n        opts?: { ctx?: E },\n      ) => Promise<MiddlewareResult<E>>\n    }) => Promise<MiddlewareResult<Extra>>,\n  ): ActionBuilder<Ctx & Extra, Input, Raw, Refusal>\n  /** Parse and check what the caller sent. The handler's `input` follows. */\n  input<S extends StandardSchemaV1>(schema: S): ActionBuilder<Ctx, Output<S>, InputOf<S>, Refusal>\n  /**\n   * The shape of what a refusal may carry - see `refuse()`. The page gets\n   * `result.refusal` typed from it, and only data that matches it: data that\n   * does not is a bug in the server, answered as one.\n   */\n  refusal<S extends StandardSchemaV1>(schema: S): ActionBuilder<Ctx, Input, Raw, Output<S>>\n  /**\n   * The body.\n   *\n   * What the caller gets is always the result object: `data`, or a\n   * refusal, or - when the action redirected - `redirected`, set by the\n   * client once the navigation is under way. Always an object, so a caller\n   * reading `result.validationErrors` after a redirect reads undefined and\n   * not a TypeError inside a transition, which unmounts the root.\n   */\n  handler<Data>(\n    fn: (args: HandlerArgs<Input, Ctx, Refusal>) => Promise<Data> | Data,\n  ): Action<Raw, Delivered<Data>, Refusal>\n  /**\n   * The body of a READ, sharing this client's middleware and schema.\n   *\n   *     export const getPosts = client.input(filter).query(async ({ input, ctx }) =>\n   *       db.posts(ctx.user.id, input))\n   *\n   * The same builder as `handler`, and deliberately so: an app configures its\n   * auth check and its error reporting once, and both a mutation and a read go\n   * through them.\n   *\n   * It fails differently, though, and that is not an oversight. An action\n   * RETURNS its failures because React serialises a rejection opaquely. A query\n   * is handed to a cache library as a fetcher, and every one of them reports\n   * failure by rejection — so this returns the data directly and throws, and\n   * the endpoint carries the message across for it.\n   */\n  query<Data>(\n    fn: (args: { input: Input; ctx: Ctx }) => Promise<Data> | Data,\n    options?: QueryOptions,\n  ): Query<Raw, Delivered<Data>>\n}\n\nexport interface ActionClientOptions {\n  /**\n   * What the browser is told when something unexpected throws.\n   *\n   * Everything reaching here is a bug or an outage, and its message may say\n   * more than a stranger should see — a query, a path, a host. Returning a\n   * fixed string is the safe default; return the message only for errors you\n   * raised deliberately.\n   */\n  onError?: (error: unknown) => string\n}\n\nconst GENERIC = 'Something went wrong.'\n\n/**\n * Whether the backend turned this caller away: not signed in, not allowed, or\n * nothing there for them. Each carries a message written for the person.\n */\nfunction turnedAway(error: unknown): error is Error {\n  return (\n    error instanceof ServerAuthenticationError || error instanceof ServerAuthorizationError || isNotFoundSignal(error)\n  )\n}\n\n/**\n * FormData in, a plain object out — what a schema expects to be handed.\n *\n * The form's own decoder, so the object validated here is the object the\n * browser validated. This had a flat decoder of its own: `items[0].name`\n * stayed a key spelled exactly that, `<Form>` had already parsed it into an\n * array, and a nested form passed in the browser and failed on the server\n * with the fields it named gone.\n */\nconst fromFormData = (body: FormData, schema: unknown): Record<string, unknown> => decodeFormData(body, schema)\n\nexport function createActionClient(\n  options: ActionClientOptions = {},\n): ActionBuilder<Record<never, never>, undefined> {\n  const report = options.onError ?? (() => GENERIC)\n\n  function build<Ctx extends Record<string, unknown>, Input>(\n    middlewares: ActionMiddleware<never, never>[],\n    schema: StandardSchemaV1 | null,\n    refusalSchema: StandardSchemaV1 | null = null,\n  ): ActionBuilder<Ctx, Input> {\n      /**\n       * Validate, run the chain, call the body.\n       *\n       * Shared by both terminals, which is the point of putting a read on this\n       * builder at all: one set of middleware, one schema, one place the auth\n       * check lives. Refusals leave by throwing, and each terminal decides what\n       * that should look like from the outside.\n       */\n    const pipeline = async (\n      raw: unknown,\n      fn: (args: HandlerArgs<never, never>) => unknown,\n    ): Promise<unknown> => {\n      const value = raw instanceof FormData ? fromFormData(raw, schema) : raw\n\n      if (schema) {\n        const invalid = await validateWith(schema, value)\n\n        if (invalid) throw new ActionValidationError(invalid)\n      }\n\n      const parsed = schema\n        ? ((await schema['~standard'].validate(value)).value as Input)\n        : (value as Input)\n\n      // Composed inside-out so the first `use` is the outermost — it sees the\n      // others run, which is what makes timing and cleanup possible rather\n      // than only checks.\n      let ctx = {} as Ctx\n      let index = 0\n\n      const run = async (): Promise<unknown> => {\n        const middleware = middlewares[index++]\n\n        if (!middleware) {\n          return await fn({\n            input: parsed as never,\n            ctx: ctx as never,\n            // The same function as the export; the type on the way in is what\n            // is different, and the type is the handler's input.\n            fieldErrors: fieldErrors as never,\n            refuse: refuse as never,\n          })\n        }\n\n        let continued = false\n\n        const result = await (middleware as unknown as ActionMiddleware<Ctx, Record<string, unknown>>)({\n          ctx,\n          next: (async (opts?: { ctx?: Record<string, unknown> }) => {\n            continued = true\n            ctx = { ...ctx, ...(opts?.ctx ?? {}) } as Ctx\n\n            return { ctx, value: await run() }\n          }) as never,\n        })\n\n        // Silence is not refusal. A middleware that neither called next() nor\n        // threw has done nothing, and guessing which it meant turns a\n        // forgotten `return` into a check that quietly passes.\n        if (!continued) {\n          throw new ActionMisuse(\n            'A middleware returned without calling next(). Call it to continue, or throw to refuse.',\n          )\n        }\n\n        return (result as { value?: unknown })?.value\n      }\n\n      return await run()\n    }\n\n    /**\n     * A refusal as the page gets it: its message, always - it was written to\n     * be seen - and its data only once the declared schema has checked it.\n     * Data with no schema to check it, or that fails the schema, never\n     * reaches the browser: the first is said in the server's log, the second\n     * is a bug in the server, returned as the error each terminal reports.\n     */\n    const refusalResult = async (error: ActionRefusal): Promise<ActionResult<never, unknown> | Error> => {\n      if (error.data === undefined) return { serverError: error.message }\n\n      if (!refusalSchema) {\n        console.error(\n          `[rsc-kit] An action refused with data, and declares no .refusal(schema) for it - the message was sent, the data was not: ${error.message}`,\n        )\n\n        return { serverError: error.message }\n      }\n\n      const checked = await refusalSchema['~standard'].validate(error.data)\n\n      if (checked.issues) {\n        return new Error(\n          `An action refused with data its .refusal(schema) does not accept: ${checked.issues.map((issue) => issue.message).join('; ')}`,\n        )\n      }\n\n      return { serverError: error.message, refusal: checked.value }\n    }\n\n    return {\n      use(middleware) {\n        return build([...middlewares, middleware as never], schema, refusalSchema) as never\n      },\n      input(next) {\n        return build(middlewares, next, refusalSchema) as never\n      },\n      refusal(next) {\n        return build(middlewares, schema, next) as never\n      },\n      handler(fn) {\n        // Delivered is a type-only difference from what the body returns:\n        // the value is passed through as it is.\n        return markClientBuilt(async (raw?: unknown) => {\n          try {\n            return { data: (await pipeline(raw, fn)) as Awaited<ReturnType<typeof fn>> }\n          } catch (error) {\n            // Past onError deliberately — see ActionMisuse.\n            if (error instanceof ActionMisuse) throw error\n\n            // A redirect is an instruction, not a failure: it has to reach\n            // the host, which answers the action with the destination. Caught\n            // here it became { serverError: 'Something went wrong.' } - a\n            // login that succeeded and then showed an error.\n            if (isRedirectSignal(error)) throw error\n\n            if (isActionValidationError(error)) {\n              return { validationErrors: error.errors }\n            }\n\n            if (isActionRefusal(error)) {\n              const refused = await refusalResult(error)\n\n              return (refused instanceof Error ? { serverError: report(refused) } : refused) as ActionResult<never>\n            }\n\n            // Turned away by the backend - not signed in, not allowed, no such\n            // record - is an answer too, and its message is meant to be seen.\n            // Not rethrown as a redirect is: the action endpoint answers a\n            // throw with a 500, and the form would show nothing at all.\n            if (turnedAway(error)) return { serverError: error.message }\n\n            return { serverError: report(error) }\n          }\n        }) as never\n      },\n      query(fn, options) {\n        const read = async (raw?: unknown) => {\n          try {\n            return await pipeline(raw, fn)\n          } catch (error) {\n            if (error instanceof ActionMisuse) throw error\n            if (isRedirectSignal(error)) throw error\n\n            // Left as they are, as a redirect is. A page that reads through a\n            // query answers 401, 403 or its not-found page, as it does calling\n            // the backend directly; the read endpoint answers the same statuses.\n            if (turnedAway(error)) throw error\n\n            // Thrown, not returned. A cache library reports failure by\n            // rejection, so a query that answered with an error-shaped object\n            // would look like a successful read of something odd.\n            if (isActionValidationError(error)) {\n              throw new QueryValidationError(error.errors)\n            }\n\n            // Its own message, as an action's is, and its checked data on\n            // the error for a fetcher that wants it.\n            if (isActionRefusal(error)) {\n              const refused = await refusalResult(error)\n\n              if (refused instanceof Error) throw new Error(report(refused))\n\n              throw Object.assign(new Error(refused.serverError), {\n                refusal: refused.refusal,\n                refusalStatus: error.refusalStatus,\n              })\n            }\n\n            throw new Error(report(error))\n          }\n        }\n\n        return markClientBuilt(markQuery(read, options)) as never\n      },\n    }\n  }\n\n  return build([], null)\n}\n"]}

package/dist/js/Form.js

@@ -2,7 +2,7 @@
 import { jsx as _jsx } from "react/jsx-runtime";
 import { createContext, useCallback, useContext, useEffect, useLayoutEffect, useMemo, useRef, useActionState, useState, useSyncExternalStore, useTransition, } from "react";
 import { submitForm } from "../formSubmit";
-import { ServerValidationError, ServerDumpError, ServerRedirectError, redirectedTo } from "./errors";
+import { ActionRefusedError, ServerValidationError, ServerDumpError, ServerRedirectError, redirectedTo } from "./errors";
 import { buildFormData, decodeFormData } from "./formEncoding";
 import { createFormStore } from "./formStore";
 import { validateWith } from "./standardSchema";
@@ -488,6 +488,13 @@ export default function Form({ action, method: methodProp, defaultValues, store:
                     setErrors(err.errors);
                     onError?.(err.errors);
                 }
+                else if (err instanceof ActionRefusedError) {
+                    // A backend turned a generated stub down: its message, written for
+                    // the person asking, is the form's error.
+                    setErrors({ "": [err.message] });
+                    setRefusal(null);
+                    onError?.({}, err);
+                }
                 else if (err instanceof ServerDumpError) {
                     // Dump overlay is already shown — silently swallow
                 }

package/dist/js/Form.js.map

@@ -1 +1 @@
-{"version":3,"file":"Form.js","sourceRoot":"","sources":["../../src/js/Form.tsx"],"names":[],"mappings":"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","sourcesContent":["\"use client\";\n\nimport type { Route } from \"../routes.js\";\nimport {\n  type FormHTMLAttributes,\n  type FormEvent,\n  type ReactNode,\n  type Ref,\n  createContext,\n  useCallback,\n  useContext,\n  useEffect,\n  useLayoutEffect,\n  useMemo,\n  useRef,\n  useActionState,\n  useState,\n  useSyncExternalStore,\n  useTransition,\n} from \"react\";\nimport { submitForm } from \"../formSubmit\";\nimport { ServerValidationError, ServerDumpError, ServerRedirectError, redirectedTo } from \"./errors\";\nimport { buildFormData, decodeFormData } from \"./formEncoding\";\nimport { createFormStore } from \"./formStore\";\nimport type { FormStore } from \"./formStore\";\nimport { validateWith } from \"./standardSchema\";\nimport type { StandardSchemaV1 } from \"./standardSchema\";\n\n/**\n * How long a blur that leaves the form waits before checking the field. A\n * dialog's exit animation is shorter than this; a form still on screen after\n * it is one somebody is looking at.\n */\nconst LEAVE_FORM_SETTLE_MS = 300;\n\ntype PrefetchStrategy = \"hover\" | \"mount\" | \"none\";\n\n/**\n * What `field(name)` hands a control, spread straight onto it.\n *\n * The same four things react-hook-form's `<Controller>` gives, because it is\n * the same job: a component with no native control behind it needs a value and\n * a way to report a new one.\n */\ninterface FieldBinding<V> {\n  name: string;\n  value: V;\n  /**\n   * Either shape: a DOM event, or the value itself.\n   *\n   * A native input passes the event; a Radix select or a rich editor passes\n   * what was chosen. A binder understanding only one of them would work on\n   * half the controls anyone actually uses.\n   */\n  onChange: (next: V | { target: { value: V } }) => void;\n  onBlur: () => void;\n}\n\n/**\n * A field's name: one the form declared, suggested by the editor - or any\n * path, because a nested or indexed field (`address.city`, `items[0].name`)\n * is a real name no defaultValues object can declare. The typo that matters\n * is caught on `field()`, which is closed to the declared names.\n */\ntype FieldPath<T> = (keyof T & string) | (string & {});\n\ninterface FormRenderProps<\n  T extends Record<string, unknown> = Record<string, unknown>,\n  Refusal = unknown,\n> {\n  pending: boolean;\n  /** What is being submitted, while it is. */\n  data: T;\n  /**\n   * A field's error, or undefined: the one way to read one.\n   *\n   *     {error('title') && <p>{error('title')}</p>}\n   *     <Field data-invalid={!!error('title')}>\n   *\n   * Nested paths join with dots - `error('address.city')`, the key a Standard\n   * Schema issue for that field produces. A field is checked when it is left\n   * and when the form is submitted, so an error never appears on a field\n   * nobody has reached yet.\n   */\n  error: (field: FieldPath<T>) => string | undefined;\n  /**\n   * The refusal that is not about a field: the action's `serverError` - a\n   * 402, a 409, \"that slot was just taken\" - or a validation message for the\n   * form as a whole. Undefined otherwise. Cleared by the next submit, by a\n   * success, and by `clearErrors()` and `reset()`, like a field's.\n   *\n   *     {formError && <p role=\"alert\">{formError}</p>}\n   *\n   * Only what the action returned: a failure thrown on the way, the network\n   * or a crash, goes to `onError` as before, where a production message is\n   * React's stand-in and not something to show.\n   */\n  formError: string | undefined;\n  /**\n   * What the action's refusal carried beside `formError` - the records\n   * blocking a delete, say - when the action refused with `refuse()` and\n   * declared its shape with `.refusal(schema)`. Typed from the form's\n   * `action` in its render prop; in a component below, `useForm<T, R>()`.\n   * Goes when `formError` does.\n   */\n  formRefusal: Refusal | undefined;\n  clearErrors: (...fields: FieldPath<T>[]) => void;\n  reset: () => void;\n  /**\n   * Whether anything differs from what the form started with.\n   *\n   * For the Save button that stays quiet until there is something to save,\n   * and the Discard that appears beside it. Read from the form itself - a\n   * snapshot of its FormData on mount, compared on every input - so an\n   * uncontrolled field counts, which nothing outside the form can do. A\n   * successful submit makes the current values the new baseline; `reset()`\n   * goes back to the first one.\n   */\n  dirty: boolean;\n  /** Whether the last submit was accepted. */\n  succeeded: boolean;\n  /**\n   * The same thing, for two seconds.\n   *\n   * The \"Saved ✓\" that appears and fades. Worth having as state rather than a\n   * timer in every form that wants one, because the timer has to be cleared\n   * when the component goes away and that is the part people forget.\n   */\n  recentlySucceeded: boolean;\n  /**\n   * Bind one field so this component holds its value.\n   *\n   * Most fields need nothing: they are uncontrolled, the DOM holds the value,\n   * and it is read back as FormData on submit. Reach for this when the DOM\n   * cannot hold it for you — a control with no native element behind it, or a\n   * value you want to read as it is typed:\n   *\n   *     <Input {...field('title')} />\n   *     <span>{field('body').value.length}/100</span>\n   *\n   * A bound field is still an ordinary named input, so it arrives in FormData\n   * with everything else. Nothing merges; there is one source of truth.\n   */\n  field: <K extends keyof T & string>(name: K) => FieldBinding<T[K]>;\n}\n\n/** What a form can submit to: a url, or a server action. */\ntype FormAction = Route | ((formData: FormData) => Promise<unknown>);\n\n/**\n * What the action's refusal carries, read off the action itself - its\n * `.refusal(schema)` - so `formRefusal` is typed without a cast. Unknown for a\n * url, or for an action that does not say.\n */\ntype RefusalOf<A> = A extends (...args: never[]) => Promise<infer R>\n  ? R extends { refusal?: infer F }\n    ? F\n    : unknown\n  : unknown;\n\ninterface FormProps<\n  T extends Record<string, unknown> = Record<string, unknown>,\n  A extends FormAction = FormAction,\n> extends Omit<\n  FormHTMLAttributes<HTMLFormElement>,\n  \"action\" | \"method\" | \"children\" | \"onSubmit\" | \"onError\"\n> {\n  action: A;\n  method?: \"get\" | \"post\";\n  /**\n   * The <form> element, for a caller that needs it - to focus, to scroll to,\n   * to hand a library. The form keeps its own handle beside it; a caller's\n   * never replaces it.\n   */\n  ref?: Ref<HTMLFormElement>;\n  /**\n   * Starting values for fields bound with `field()`.\n   *\n   * Uncontrolled fields do not need this — they take React's own\n   * `defaultValue`, and the DOM keeps whatever is typed into them.\n   */\n  defaultValues?: Partial<T>;\n  /**\n   * A store created above this form, from `useFormStore()`.\n   *\n   * For the one case the context cannot reach: something that is not a\n   * descendant — a top bar showing unsaved changes, a sidebar preview — needs\n   * the values to exist above both of them. Create the store where they share\n   * an ancestor and hand it down.\n   *\n   * Without it the form makes its own, which is what almost every form wants.\n   */\n  store?: FormStore;\n  prefetch?: PrefetchStrategy;\n  cacheFor?: number;\n  replace?: boolean;\n  preserveScroll?: boolean;\n  resetOnSuccess?: boolean;\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, so a mistake\n   * costs no round trip. It is a courtesy and not a control: the same action\n   * is reachable without this form, so the server still has to check.\n   */\n  schema?: StandardSchemaV1;\n  /** Transform form data before submitting to the server action. */\n  transform?: (data: T) => Record<string, unknown>;\n  /** Called inside the transition with typed form data. Use it to call your useOptimistic setter. */\n  optimistic?: (data: T) => void;\n  onSuccess?: (result: unknown) => void;\n  /**\n   * Called when a submit does not succeed.\n   *\n   * Validation failures arrive as field errors, with no second argument.\n   * Anything else arrives as an empty error map and the thrown value — there\n   * are no field errors to report, but the form still has to say so.\n   */\n  onError?: (errors: Record<string, string[]>, error?: unknown) => void;\n  onSubmit?: (formData: FormData) => void | false;\n  children: ReactNode | ((form: FormRenderProps<T, RefusalOf<A>>) => ReactNode);\n}\n\n/**\n * What an action built with createActionClient answers with.\n *\n * Recognised rather than thrown, because React serialises a rejected server\n * action opaquely: production strips the message and the fields it named are\n * gone. A returned object crosses intact, so a form reads it.\n */\nfunction resultOf(\n  value: unknown,\n): { errors?: Record<string, string[]>; serverError?: string; refusal?: unknown; redirected?: string } | null {\n  if (typeof value !== \"object\" || value === null) return null;\n\n  const result = value as {\n    validationErrors?: Record<string, string[]>;\n    serverError?: string;\n    refusal?: unknown;\n    redirected?: string;\n  };\n\n  if (result.validationErrors) return { errors: result.validationErrors };\n  if (result.serverError) return { serverError: result.serverError, refusal: result.refusal };\n  if (typeof result.redirected === \"string\") return { redirected: result.redirected };\n\n  return null;\n}\n\nconst FormStatusContext = createContext<FormRenderProps>({\n  pending: false,\n  data: {},\n  dirty: false,\n  error: () => undefined,\n  formError: undefined,\n  formRefusal: undefined,\n  clearErrors: () => {},\n  reset: () => {},\n  succeeded: false,\n  recentlySucceeded: false,\n  // Outside a Form there is nothing holding a value, so a binding that reported\n  // one would be lying. Name only, which is the part that is still true.\n  field: ((name: string) => ({\n    name,\n    value: \"\",\n    onChange: () => {},\n    onBlur: () => {},\n  })) as FormRenderProps[\"field\"],\n});\n\n/**\n * The store, on its own context.\n *\n * Separate from the status context because that one holds a fresh object every\n * render, so anything reading it re-renders with the form. The store is stable\n * for the life of the form, which is what lets a subscriber below it re-render\n * alone.\n */\nconst FormStoreContext = createContext<{\n  store: FormStore;\n  touch: (name: string) => void;\n} | null>(null);\n\n/**\n * A value store created above the form rather than by it.\n *\n *     const store = useFormStore({ title: '' })\n *\n *     <TopBar store={store} />              // not inside the form\n *     <Form action={save} store={store}>…</Form>\n *\n * For the one case the context cannot reach. `<Form>` makes its own otherwise,\n * and almost every form should let it — this exists so that a component which\n * is not a descendant can still read the values, which is the flexibility\n * react-hook-form and TanStack Form get from `useForm()` being yours to call.\n *\n * Deliberately not reactive itself: creating the store does not subscribe to\n * it, so the component holding it does not re-render on every keystroke and\n * take the whole subtree with it. Read a field from it with `useField(name, store)`.\n */\nexport function useFormStore<T extends Record<string, unknown>>(\n  initial: Partial<T> = {},\n): FormStore {\n  const ref = useRef<FormStore | null>(null);\n\n  ref.current ??= createFormStore({ ...initial });\n\n  return ref.current;\n}\n\n/**\n * The form this component is inside: the same object `<Form>`'s render prop\n * gets, so a field split into its own component is written exactly as it\n * was inline.\n *\n *     function Title() {\n *       const { field, error } = useForm()\n *\n *       return (\n *         <>\n *           <input name=\"title\" />\n *           {error('title') && <p>{error('title')}</p>}\n *         </>\n *       )\n *     }\n *\n * Not React's `useFormStatus`, which is a different hook with a different\n * answer - which is why this one is not called that.\n */\nexport function useForm<\n  T extends Record<string, unknown> = Record<string, unknown>,\n  Refusal = unknown,\n>(): FormRenderProps<T, Refusal> {\n  return useContext(FormStatusContext) as FormRenderProps<T, Refusal>;\n}\n\n/**\n * One field, subscribed on its own - for a large controlled form.\n *\n * The same two words as everywhere else, for one name: `field` to spread,\n * `error` to show. The component re-renders when this field changes and at no\n * other time, where `useForm()` re-renders with the whole form. Reach for it\n * when re-rendering all of a form per keystroke is real:\n *\n *     function Title() {\n *       const { field, error } = useField('title')\n *\n *       return <Input {...field} aria-invalid={!!error} />\n *     }\n *\n * Given a store, it reads a form from outside it - see useFormStore.\n */\nexport function useField(\n  name: string,\n  store?: FormStore,\n): { field: FieldBinding<string>; error: string | undefined } {\n  const ctx = useContext(FormStoreContext);\n  const status = useContext(FormStatusContext);\n\n  if (!ctx && !store) {\n    throw new Error(\n      \"useField() was called outside a <Form>. It reads that form's values, so there has to be one above it.\",\n    );\n  }\n\n  const source = store ?? ctx!.store;\n  const touch = ctx?.touch;\n\n  const value = useSyncExternalStore(\n    source.subscribe,\n    () => (source.get(name) ?? \"\") as string,\n    () => \"\",\n  );\n\n  return {\n    field: {\n      name,\n      value,\n      onChange: (next) => {\n        source.set(\n          name,\n          typeof next === \"object\" && next !== null && \"target\" in next\n            ? (next as { target: { value: string } }).target.value\n            : next,\n        );\n      },\n      onBlur: () => void touch?.(name),\n    },\n    error: status.error(name as never),\n  };\n}\n\n/**\n * submitForm bound to an action, once per action.\n *\n * Bound on every render, it was a fresh function with a fresh promise for\n * its bound arguments each time - and React, seating a posted form's state\n * during the server render, suspends on that promise until it settles, then\n * renders the component again, which bound again. A render that never\n * finished, on every page a form was posted to without javascript. One\n * bound function per action, and the promise settles once.\n */\nconst boundSubmits = new WeakMap<Function, (previous: unknown, formData: FormData) => Promise<unknown>>();\n\nfunction boundSubmit(action: (formData: FormData) => Promise<unknown>) {\n  let bound = boundSubmits.get(action);\n\n  if (!bound) {\n    bound = submitForm.bind(null, action);\n    boundSubmits.set(action, bound);\n  }\n\n  return bound;\n}\n\n/**\n * A form's values as one comparable string.\n *\n * FormData in document order, a file by its name and size: enough to say\n * whether anything changed, which is all `dirty` asks.\n */\nfunction serializeForm(form: HTMLFormElement): string {\n  const parts: string[] = [];\n\n  for (const [name, value] of new FormData(form)) {\n    parts.push(\n      name + \"=\" + (typeof value === \"string\" ? value : \"file:\" + value.name + \":\" + value.size),\n    );\n  }\n\n  return parts.join(\"\\n\");\n}\n\n/**\n * Also exported by name, and re-exported below, because both spellings are in\n * use: `import Form from` and `import { Form } from`.\n */\nexport default function Form<\n  T extends Record<string, unknown> = Record<string, unknown>,\n  A extends FormAction = FormAction,\n>({\n  action,\n  method: methodProp,\n  defaultValues,\n  store: providedStore,\n  prefetch = \"hover\",\n  cacheFor,\n  replace = false,\n  preserveScroll = false,\n  resetOnSuccess = true,\n  schema,\n  transform,\n  optimistic,\n  onSuccess,\n  onError,\n  onSubmit,\n  children,\n  ref: callerRef,\n  ...rest\n}: FormProps<T, A>) {\n  const isGetForm = typeof action === \"string\";\n  const method = methodProp ?? (isGetForm ? \"get\" : \"post\");\n\n  // The answer to this form posted without a runtime, seated by React into\n  // the form that posted it - which is the only way a visitor with no\n  // javascript sees a refusal. Registered through submitForm, bound to the\n  // action, because React hands a form-state action a (previous, formData)\n  // pair and the action takes the FormData alone. On the server a plain\n  // function - a closure, not a server reference - cannot be bound into a\n  // form; the form falls back to the action itself, and posts nothing\n  // seatable, which is all a closure could ever have done.\n  const bindable =\n    typeof action === \"function\" && (typeof window !== \"undefined\" || \"$$FORM_ACTION\" in action);\n  const [posted, formAction] = useActionState(\n    bindable ? boundSubmit(action as (formData: FormData) => Promise<unknown>) : async () => null,\n    null as unknown,\n  );\n  const postedRefusal = resultOf(posted);\n  const [errors, setErrors] = useState<Record<string, string[]>>(() => postedRefusal?.errors ?? {});\n  // A refusal's data, tied to the exact form-level error it came with: when\n  // that entry is cleared or replaced - the next submit, a success,\n  // clearErrors() - the data goes with it, without every place that touches\n  // the errors having to know.\n  const [refusal, setRefusal] = useState<{ for: string[]; data: unknown } | null>(null);\n  const [touched, setTouched] = useState<Record<string, boolean>>({});\n\n  /**\n   * Mark a field visited, and check it.\n   *\n   * Checking on blur rather than on every keystroke, because an error that\n   * appears while someone is halfway through typing an email address is a form\n   * arguing with them. Leaving the field is the moment they have finished\n   * saying what they meant.\n   *\n   * The whole object is validated and only this field's issues are kept: a\n   * Standard Schema has no notion of one field, and filtering by path is the\n   * honest way to ask it about one. Everything else's errors are left as they\n   * were, so blurring an empty field does not light up the rest of the form.\n   */\n  const touch = useCallback(\n    async (name: string) => {\n      setTouched((prev) => (prev[name] ? prev : { ...prev, [name]: true }));\n\n      if (!schema || !formRef.current) return;\n\n      const invalid = await validateWith(\n        schema,\n        decodeFormData(new FormData(formRef.current), schema),\n      );\n\n      setErrors((prev) => {\n        const next = { ...prev };\n\n        if (invalid?.[name]) next[name] = invalid[name];\n        else delete next[name];\n\n        return next;\n      });\n    },\n    [schema],\n  );\n\n  const [succeeded, setSucceeded] = useState(false);\n  const [recentlySucceeded, setRecentlySucceeded] = useState(false);\n  const recentTimer = useRef<ReturnType<typeof setTimeout> | undefined>(\n    undefined,\n  );\n\n  // Cleared on unmount: a timer that fires into a component that has gone is\n  // the warning nobody reads and the leak nobody finds.\n  useEffect(() => () => clearTimeout(recentTimer.current), []);\n\n  // Only the fields someone bound. Everything else is the DOM's.\n  //\n  // A store rather than state, so a component using `useField` can re-render\n  // for one field while this one does not. See formStore.ts.\n  const storeRef = useRef<FormStore | null>(null);\n\n  storeRef.current ??= createFormStore({\n    ...(defaultValues as Record<string, unknown> | undefined),\n  });\n\n  const store = providedStore ?? storeRef.current;\n\n  // Which names the render prop read through `field()`. A change to one of\n  // those has to re-render this component, because that is where the value is\n  // being displayed; a change to anything else does not, which is what lets a\n  // `useField` child stand on its own.\n  const readHere = useRef(new Set<string>());\n  const [, bump] = useState(0);\n\n  useEffect(\n    () =>\n      store.subscribe((name) => {\n        if (name === \"\" || readHere.current.has(name)) bump((n) => n + 1);\n      }),\n    [store],\n  );\n  const [currentData, setCurrentData] = useState<T>({} as T);\n  const [isPending, startTransition] = useTransition();\n  const formRef = useRef<HTMLFormElement>(null);\n  // Read by the delayed blur check, which runs after the render that set it:\n  // the value its closure captured is the one from before the submit began.\n  const pendingRef = useRef(false);\n  pendingRef.current = isPending;\n\n  // A reset owed by a successful submit, performed in the commit that ends\n  // it. The action resolves a tick before React commits its transition - the\n  // result, whatever the action revalidated, pending going false - and a\n  // reset done on resolve was a DOM write with a frame of its own: a chat's\n  // composer emptied before the reply it was answered with appeared. In a\n  // layout effect of the commit where pending turns false, it lands in the\n  // same frame as the result, before the browser paints.\n  const resetOwed = useRef<{ result: unknown } | null>(null);\n\n  // What the form started with, as its FormData reads: the baseline `dirty`\n  // is measured against. Taken on mount, retaken after a successful submit.\n  const baseline = useRef<string | null>(null);\n  const [dirty, setDirty] = useState(false);\n  // Only a form that reads `dirty` pays for it: the flip from clean to dirty\n  // is a render of the whole form, and a field that subscribes for itself\n  // is promised that typing in it renders it alone.\n  const dirtyRead = useRef(false);\n\n  const snapshot = useCallback(() => {\n    if (!formRef.current) return;\n\n    baseline.current = serializeForm(formRef.current);\n    setDirty(false);\n  }, []);\n\n  const measureDirty = useCallback(() => {\n    if (!dirtyRead.current || !formRef.current || baseline.current === null) return;\n\n    const now = serializeForm(formRef.current) !== baseline.current;\n\n    setDirty((was) => (was === now ? was : now));\n  }, []);\n\n  useEffect(snapshot, [snapshot]);\n\n  // A bound control with no native element behind it changes through the\n  // store, not through an input event - a Radix select - so the store is\n  // watched too. Its input, if it has one, is read back with the rest. In\n  // a microtask: the fields subscribed before this effect ran, so React's\n  // own flush of their update is queued ahead of the measure, and the\n  // element is read after it was written.\n  useEffect(() => store.subscribe(() => queueMicrotask(measureDirty)), [store, measureDirty]);\n\n  // A reset writes every bound field at once, through a render of this\n  // component; the measure has to read the elements after that commit,\n  // and a microtask queued during the reset ran before it. Marked here,\n  // measured by the effect below once the render lands.\n  const remeasure = useRef(false);\n\n  useEffect(() => {\n    if (!remeasure.current) return;\n\n    remeasure.current = false;\n    measureDirty();\n  });\n\n  useLayoutEffect(() => {\n    const owed = resetOwed.current;\n\n    if (!owed || isPending) return;\n\n    resetOwed.current = null;\n    store.reset();\n    formRef.current?.reset();\n    setTouched({});\n    setCurrentData({} as T);\n    snapshot();\n    // After the reset, as it always ran: an onSuccess that fills or focuses a\n    // field must not have the reset undo it.\n    onSuccess?.(owed.result);\n  });\n\n  // Both handles, one element. React 19 hands a function component its ref\n  // as a prop, and spread after the form's own it replaced it - every\n  // FormData read then found null. A caller's ref is filled beside ours.\n  const attachForm = useCallback(\n    (element: HTMLFormElement | null) => {\n      formRef.current = element;\n\n      if (typeof callerRef === \"function\") callerRef(element);\n      else if (callerRef) callerRef.current = element;\n    },\n    [callerRef],\n  );\n\n  const error = useCallback(\n    (field: FieldPath<T>): string | undefined => errors[field]?.[0],\n    [errors],\n  );\n\n  const clearErrors = useCallback((...fields: FieldPath<T>[]) => {\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  // The store first, then the DOM. A bound field renders from the store, so\n  // a DOM reset alone put its default in the element for one frame and the\n  // typed value back on the next render: a port's Discard left the name as\n  // typed while the dirty flag went clean beside it.\n  const resetForm = useCallback(() => {\n    remeasure.current = true;\n    store.reset();\n    formRef.current?.reset();\n    setErrors({});\n    setCurrentData({} as T);\n    queueMicrotask(measureDirty);\n  }, [store, measureDirty]);\n\n  useEffect(() => {\n    if (isGetForm && prefetch === \"mount\") {\n      const fn = (window as any).__rsc_prefetch;\n      fn?.(action, cacheFor);\n    }\n  }, [isGetForm, prefetch, action, cacheFor]);\n\n  const doPrefetch = useCallback(() => {\n    if (!isGetForm) return;\n    const fn = (window as any).__rsc_prefetch;\n    fn?.(action as string, cacheFor);\n  }, [isGetForm, action, cacheFor]);\n\n  const handleSubmit = useCallback(\n    async (e: FormEvent<HTMLFormElement>) => {\n      e.preventDefault();\n      const formData = new FormData(e.currentTarget);\n      const data = decodeFormData<T>(formData, schema);\n      setCurrentData(data);\n\n      if (onSubmit?.(formData) === false) {\n        return;\n      }\n\n      if (isGetForm && method === \"get\") {\n        const url = new URL(action as string, window.location.origin);\n        for (const [key, value] of formData.entries()) {\n          if (typeof value === \"string\" && value !== \"\") {\n            url.searchParams.set(key, value);\n          }\n        }\n\n        const path = url.pathname + url.search;\n        const shell = action as string;\n        const nav = (window as any).__rsc_navigate;\n        const prefetched = (window as any).__rsc_is_prefetched;\n\n        // The route without its query is that route's shell: the layout, the\n        // chrome, and whatever it renders with nothing to show yet. Prefetching\n        // on hover put it in the cache, so going there first costs no request\n        // and puts the page on screen while the real query is still running.\n        //\n        // The query itself is never prefetched. It is the expensive half, and\n        // hovering a search button is not a reason to run someone's search.\n        if (path !== shell && prefetched?.(shell)) {\n          // Awaited rather than raced: navigate() aborts whatever is in flight,\n          // so starting the real one first would cancel the shell before it\n          // could render. It is a cache hit, so this is a render, not a wait.\n          Promise.resolve(nav?.(shell, { replace, preserveScroll })).then(() =>\n            // Replaces, so the shell does not become a back-button stop of its\n            // own — the pair leaves exactly one entry behind.\n            nav?.(path, { replace: true, preserveScroll }),\n          );\n\n          return;\n        }\n\n        nav?.(path, { replace, preserveScroll });\n        return;\n      }\n\n      const serverAction = action as (formData: FormData) => Promise<unknown>;\n\n      // Rebuilt rather than edited: transform returns the values to send, so\n      // whatever was in the form and is not in the result should not go.\n      if (transform) {\n        for (const key of [...formData.keys()]) formData.delete(key);\n\n        for (const [key, value] of buildFormData(transform(data))) {\n          formData.append(key, value);\n        }\n      }\n\n      setErrors({});\n\n      // Before the transition, so a failure neither runs the optimistic\n      // update nor leaves the form looking like it is submitting.\n      const invalid = await validateWith(schema, data);\n\n      if (invalid) {\n        setErrors(invalid);\n        onError?.(invalid);\n\n        return;\n      }\n\n      startTransition(async () => {\n        try {\n          // Call optimistic updater inside the transition so React's\n          // useOptimistic picks it up and auto-reverts on settle.\n          optimistic?.(data);\n\n          // Whatever an earlier call noted is not this action's: a redirect\n          // from another form, or from an action no form was waiting for - a\n          // logout button - is left behind until someone reads it, and the\n          // next form to succeed took it for its own and skipped onSuccess.\n          redirectedTo();\n\n          const result = await serverAction(formData);\n          const refused = resultOf(result);\n          // Read every time, which is what clears it. Behind the || below it\n          // went unread whenever the answer already said \"redirected\", and\n          // stayed for the next form.\n          const redirected = redirectedTo();\n\n          // The action answered with somewhere to go, and callServer has\n          // already started the navigation. Not an error for a form to\n          // show, and not a save to announce either: signing in and going\n          // to the dashboard is the whole success.\n          if (refused?.redirected !== undefined || redirected !== null) return;\n\n          if (refused) {\n            if (refused.errors) {\n              setErrors(refused.errors);\n              onError?.(refused.errors);\n            } else {\n              // Under the form's own key, so every place that clears the\n              // errors clears it too.\n              const formLevel = [refused.serverError ?? \"The action was refused.\"];\n\n              setErrors({ \"\": formLevel });\n              setRefusal(refused.refusal === undefined ? null : { for: formLevel, data: refused.refusal });\n              onError?.({}, new Error(refused.serverError));\n            }\n\n            return;\n          }\n\n          // Owed, not done: see resetOwed. Saved, so what is in the form is\n          // what the server has - measured after the reset where there is one.\n          if (resetOnSuccess) resetOwed.current = { result };\n          else snapshot();\n\n          setErrors({});\n          setSucceeded(true);\n          setRecentlySucceeded(true);\n\n          clearTimeout(recentTimer.current);\n          recentTimer.current = setTimeout(\n            () => setRecentlySucceeded(false),\n            2_000,\n          );\n\n          if (!resetOnSuccess) onSuccess?.(result);\n        } catch (err) {\n          // A redirect no longer arrives here - callServer resolves after\n          // performing it - but an action called through something older\n          // than that still may.\n          if (err instanceof ServerRedirectError) return;\n\n          if (err instanceof ServerValidationError) {\n            setErrors(err.errors);\n            onError?.(err.errors);\n          } else if (err instanceof ServerDumpError) {\n            // Dump overlay is already shown — silently swallow\n          } else if (onError) {\n            // Not rethrown. A rejected action never settles, and until it\n            // settles React keeps the optimistic update on screen — so an\n            // unexpected failure left the row showing as though the write had\n            // worked. Settling is what takes it back.\n            onError({}, err);\n          } else {\n            // Nothing is handling it, and swallowing here would lose it\n            // entirely — the reason this used to rethrow.\n            console.error(\"[rsc-kit] form submit failed\", err);\n          }\n        }\n      });\n    },\n    [\n      action,\n      isGetForm,\n      method,\n      replace,\n      preserveScroll,\n      resetOnSuccess,\n      store,\n      schema,\n      transform,\n      optimistic,\n      onSubmit,\n      onSuccess,\n      onError,\n    ],\n  );\n\n  const field = useCallback(\n    <K extends keyof T & string>(name: K): FieldBinding<T[K]> => {\n      // Recorded during render, deliberately: this is how the form knows which\n      // values it is the one displaying. Idempotent, so a double render in\n      // development records the same name twice and means the same thing.\n      readHere.current.add(name);\n\n      return {\n        name,\n        value: (store.get(name) ?? \"\") as T[K],\n        onChange: (next: unknown) => {\n          const value =\n            typeof next === \"object\" && next !== null && \"target\" in next\n              ? (next as { target: { value: string } }).target.value\n              : next;\n\n          store.set(name, value);\n        },\n        onBlur: () => void touch(name),\n      };\n    },\n    [store, touch],\n  );\n\n\n  // Stable, so a subscriber below does not re-render because this one did.\n  const storeContext = useMemo(() => ({ store, touch }), [store, touch]);\n\n  const formStatus: FormRenderProps<T, RefusalOf<A>> = {\n    pending: isPending,\n    data: currentData,\n    get dirty() {\n      dirtyRead.current = true;\n\n      return dirty;\n    },\n    succeeded,\n    recentlySucceeded,\n    field,\n    error,\n    formError: errors[\"\"]?.[0],\n    formRefusal: (refusal && errors[\"\"] === refusal.for ? refusal.data : undefined) as RefusalOf<A> | undefined,\n    clearErrors,\n    reset: resetForm,\n  };\n\n  return (\n    <FormStoreContext.Provider value={storeContext}>\n      <FormStatusContext.Provider value={formStatus as FormRenderProps}>\n        <form\n          ref={attachForm}\n          // On the element as well as in the handler, which is what makes this\n          // work before hydration. React emits a form a browser can submit on its\n          // own for a server action, and an ordinary action/method pair for a\n          // url — so a submit that happens before the javascript arrives still\n          // reaches the server.\n          //\n          // The two do not fight: handleSubmit calls preventDefault() first, and\n          // React does not run a form action when the submit event was cancelled.\n          // So the enhanced path wins whenever there is one, and the native path\n          // is what is left when there is not.\n          action={(bindable ? formAction : action) as never}\n          // Only for a url. React sets the method itself for a server action, and\n          // passing one alongside is what it warns about.\n          method={isGetForm ? method : undefined}\n          onSubmit={handleSubmit}\n          // Every keystroke and every toggle, from any control in the form,\n          // uncontrolled ones included: React's onInput here is the bubbling\n          // `input` event. A caller's own handler still runs.\n          onInput={(event) => {\n            rest.onInput?.(event);\n            measureDirty();\n          }}\n          onChange={(event) => {\n            rest.onChange?.(event);\n            measureDirty();\n          }}\n          // On the form, not only on the bound fields. `focusout` bubbles where\n          // `blur` does not, so React's onBlur here sees every control that was\n          // left — including the uncontrolled ones, which are most of them and\n          // would otherwise never be marked touched at all.\n          onBlur={(event) => {\n            const target = event.target as unknown as {\n              name?: string;\n              value?: string;\n            };\n            const name = target.name;\n\n            if (!name) return;\n\n            // Leaving a field is the moment to check it; leaving the form is\n            // not the same moment. Focus going to nothing, or to something\n            // outside the form, is a click on the page - most often a dialog\n            // closing - and an error painted into a dialog as it animates out\n            // reads as a submit that nobody made. An empty field left that way\n            // is not checked at all. One with something in it is, but only\n            // once the dust settles: if the form is gone or hidden by then, it\n            // was a dialog closing, and nobody is there to read the error.\n            const left = event.relatedTarget as Node | null;\n            const stillInForm = !!left && !!formRef.current?.contains(left);\n\n            if (stillInForm) {\n              void touch(name);\n\n              return;\n            }\n\n            if (!target.value) return;\n\n            setTimeout(() => {\n              const form = formRef.current;\n\n              if (\n                !form ||\n                !form.isConnected ||\n                form.getClientRects().length === 0\n              )\n                return;\n              // A submit in flight is not a dialog closing, and its answer is\n              // the verdict on every field. On iOS a tap on the submit button\n              // does not focus it, so the last field's blur arrives here as\n              // \"left the form\" - and by now the fields may be disabled for\n              // the pending submit, missing from its data, and judged absent:\n              // \"last name is required\" flashed on the way to the next step.\n              if (pendingRef.current) return;\n              // Nor a field disabled by now, for the same reason: its value is\n              // not in the form's data, so it would always read as missing.\n              if ((event.target as { disabled?: boolean }).disabled) return;\n              if (\n                form.closest(\n                  \"[hidden], [aria-hidden='true'], [data-ending-style], [data-closed]\",\n                )\n              )\n                return;\n\n              void touch(name);\n            }, LEAVE_FORM_SETTLE_MS);\n          }}\n          onMouseEnter={prefetch === \"hover\" ? doPrefetch : undefined}\n          data-pending={isPending ? \"\" : undefined}\n          {...rest}\n        >\n          {typeof children === \"function\" ? children(formStatus) : children}\n        </form>\n      </FormStatusContext.Provider>\n    </FormStoreContext.Provider>\n  );\n}\n\n// Also by name, because both spellings are in use: `import Form` and\n// `import { Form }`. This was a re-export of \"./Form\" — from inside Form.tsx,\n// so the module named itself. It survived on the bundler tolerating a circular\n// self-reference, left over from when a separate barrel re-exported a\n// FormComponent.tsx that a case-insensitive filesystem would not let be called\n// Form.ts. There is one file now, and it can just export what it declares.\nexport { Form };\n"]}
+{"version":3,"file":"Form.js","sourceRoot":"","sources":["../../src/js/Form.tsx"],"names":[],"mappings":"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","sourcesContent":["\"use client\";\n\nimport type { Route } from \"../routes.js\";\nimport {\n  type FormHTMLAttributes,\n  type FormEvent,\n  type ReactNode,\n  type Ref,\n  createContext,\n  useCallback,\n  useContext,\n  useEffect,\n  useLayoutEffect,\n  useMemo,\n  useRef,\n  useActionState,\n  useState,\n  useSyncExternalStore,\n  useTransition,\n} from \"react\";\nimport { submitForm } from \"../formSubmit\";\nimport { ActionRefusedError, ServerValidationError, ServerDumpError, ServerRedirectError, redirectedTo } from \"./errors\";\nimport { buildFormData, decodeFormData } from \"./formEncoding\";\nimport { createFormStore } from \"./formStore\";\nimport type { FormStore } from \"./formStore\";\nimport { validateWith } from \"./standardSchema\";\nimport type { StandardSchemaV1 } from \"./standardSchema\";\n\n/**\n * How long a blur that leaves the form waits before checking the field. A\n * dialog's exit animation is shorter than this; a form still on screen after\n * it is one somebody is looking at.\n */\nconst LEAVE_FORM_SETTLE_MS = 300;\n\ntype PrefetchStrategy = \"hover\" | \"mount\" | \"none\";\n\n/**\n * What `field(name)` hands a control, spread straight onto it.\n *\n * The same four things react-hook-form's `<Controller>` gives, because it is\n * the same job: a component with no native control behind it needs a value and\n * a way to report a new one.\n */\ninterface FieldBinding<V> {\n  name: string;\n  value: V;\n  /**\n   * Either shape: a DOM event, or the value itself.\n   *\n   * A native input passes the event; a Radix select or a rich editor passes\n   * what was chosen. A binder understanding only one of them would work on\n   * half the controls anyone actually uses.\n   */\n  onChange: (next: V | { target: { value: V } }) => void;\n  onBlur: () => void;\n}\n\n/**\n * A field's name: one the form declared, suggested by the editor - or any\n * path, because a nested or indexed field (`address.city`, `items[0].name`)\n * is a real name no defaultValues object can declare. The typo that matters\n * is caught on `field()`, which is closed to the declared names.\n */\ntype FieldPath<T> = (keyof T & string) | (string & {});\n\ninterface FormRenderProps<\n  T extends Record<string, unknown> = Record<string, unknown>,\n  Refusal = unknown,\n> {\n  pending: boolean;\n  /** What is being submitted, while it is. */\n  data: T;\n  /**\n   * A field's error, or undefined: the one way to read one.\n   *\n   *     {error('title') && <p>{error('title')}</p>}\n   *     <Field data-invalid={!!error('title')}>\n   *\n   * Nested paths join with dots - `error('address.city')`, the key a Standard\n   * Schema issue for that field produces. A field is checked when it is left\n   * and when the form is submitted, so an error never appears on a field\n   * nobody has reached yet.\n   */\n  error: (field: FieldPath<T>) => string | undefined;\n  /**\n   * The refusal that is not about a field: the action's `serverError` - a\n   * 402, a 409, \"that slot was just taken\" - or a validation message for the\n   * form as a whole. Undefined otherwise. Cleared by the next submit, by a\n   * success, and by `clearErrors()` and `reset()`, like a field's.\n   *\n   *     {formError && <p role=\"alert\">{formError}</p>}\n   *\n   * Only what the action returned: a failure thrown on the way, the network\n   * or a crash, goes to `onError` as before, where a production message is\n   * React's stand-in and not something to show.\n   */\n  formError: string | undefined;\n  /**\n   * What the action's refusal carried beside `formError` - the records\n   * blocking a delete, say - when the action refused with `refuse()` and\n   * declared its shape with `.refusal(schema)`. Typed from the form's\n   * `action` in its render prop; in a component below, `useForm<T, R>()`.\n   * Goes when `formError` does.\n   */\n  formRefusal: Refusal | undefined;\n  clearErrors: (...fields: FieldPath<T>[]) => void;\n  reset: () => void;\n  /**\n   * Whether anything differs from what the form started with.\n   *\n   * For the Save button that stays quiet until there is something to save,\n   * and the Discard that appears beside it. Read from the form itself - a\n   * snapshot of its FormData on mount, compared on every input - so an\n   * uncontrolled field counts, which nothing outside the form can do. A\n   * successful submit makes the current values the new baseline; `reset()`\n   * goes back to the first one.\n   */\n  dirty: boolean;\n  /** Whether the last submit was accepted. */\n  succeeded: boolean;\n  /**\n   * The same thing, for two seconds.\n   *\n   * The \"Saved ✓\" that appears and fades. Worth having as state rather than a\n   * timer in every form that wants one, because the timer has to be cleared\n   * when the component goes away and that is the part people forget.\n   */\n  recentlySucceeded: boolean;\n  /**\n   * Bind one field so this component holds its value.\n   *\n   * Most fields need nothing: they are uncontrolled, the DOM holds the value,\n   * and it is read back as FormData on submit. Reach for this when the DOM\n   * cannot hold it for you — a control with no native element behind it, or a\n   * value you want to read as it is typed:\n   *\n   *     <Input {...field('title')} />\n   *     <span>{field('body').value.length}/100</span>\n   *\n   * A bound field is still an ordinary named input, so it arrives in FormData\n   * with everything else. Nothing merges; there is one source of truth.\n   */\n  field: <K extends keyof T & string>(name: K) => FieldBinding<T[K]>;\n}\n\n/** What a form can submit to: a url, or a server action. */\ntype FormAction = Route | ((formData: FormData) => Promise<unknown>);\n\n/**\n * What the action's refusal carries, read off the action itself - its\n * `.refusal(schema)` - so `formRefusal` is typed without a cast. Unknown for a\n * url, or for an action that does not say.\n */\ntype RefusalOf<A> = A extends (...args: never[]) => Promise<infer R>\n  ? R extends { refusal?: infer F }\n    ? F\n    : unknown\n  : unknown;\n\ninterface FormProps<\n  T extends Record<string, unknown> = Record<string, unknown>,\n  A extends FormAction = FormAction,\n> extends Omit<\n  FormHTMLAttributes<HTMLFormElement>,\n  \"action\" | \"method\" | \"children\" | \"onSubmit\" | \"onError\"\n> {\n  action: A;\n  method?: \"get\" | \"post\";\n  /**\n   * The <form> element, for a caller that needs it - to focus, to scroll to,\n   * to hand a library. The form keeps its own handle beside it; a caller's\n   * never replaces it.\n   */\n  ref?: Ref<HTMLFormElement>;\n  /**\n   * Starting values for fields bound with `field()`.\n   *\n   * Uncontrolled fields do not need this — they take React's own\n   * `defaultValue`, and the DOM keeps whatever is typed into them.\n   */\n  defaultValues?: Partial<T>;\n  /**\n   * A store created above this form, from `useFormStore()`.\n   *\n   * For the one case the context cannot reach: something that is not a\n   * descendant — a top bar showing unsaved changes, a sidebar preview — needs\n   * the values to exist above both of them. Create the store where they share\n   * an ancestor and hand it down.\n   *\n   * Without it the form makes its own, which is what almost every form wants.\n   */\n  store?: FormStore;\n  prefetch?: PrefetchStrategy;\n  cacheFor?: number;\n  replace?: boolean;\n  preserveScroll?: boolean;\n  resetOnSuccess?: boolean;\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, so a mistake\n   * costs no round trip. It is a courtesy and not a control: the same action\n   * is reachable without this form, so the server still has to check.\n   */\n  schema?: StandardSchemaV1;\n  /** Transform form data before submitting to the server action. */\n  transform?: (data: T) => Record<string, unknown>;\n  /** Called inside the transition with typed form data. Use it to call your useOptimistic setter. */\n  optimistic?: (data: T) => void;\n  onSuccess?: (result: unknown) => void;\n  /**\n   * Called when a submit does not succeed.\n   *\n   * Validation failures arrive as field errors, with no second argument.\n   * Anything else arrives as an empty error map and the thrown value — there\n   * are no field errors to report, but the form still has to say so.\n   */\n  onError?: (errors: Record<string, string[]>, error?: unknown) => void;\n  onSubmit?: (formData: FormData) => void | false;\n  children: ReactNode | ((form: FormRenderProps<T, RefusalOf<A>>) => ReactNode);\n}\n\n/**\n * What an action built with createActionClient answers with.\n *\n * Recognised rather than thrown, because React serialises a rejected server\n * action opaquely: production strips the message and the fields it named are\n * gone. A returned object crosses intact, so a form reads it.\n */\nfunction resultOf(\n  value: unknown,\n): { errors?: Record<string, string[]>; serverError?: string; refusal?: unknown; redirected?: string } | null {\n  if (typeof value !== \"object\" || value === null) return null;\n\n  const result = value as {\n    validationErrors?: Record<string, string[]>;\n    serverError?: string;\n    refusal?: unknown;\n    redirected?: string;\n  };\n\n  if (result.validationErrors) return { errors: result.validationErrors };\n  if (result.serverError) return { serverError: result.serverError, refusal: result.refusal };\n  if (typeof result.redirected === \"string\") return { redirected: result.redirected };\n\n  return null;\n}\n\nconst FormStatusContext = createContext<FormRenderProps>({\n  pending: false,\n  data: {},\n  dirty: false,\n  error: () => undefined,\n  formError: undefined,\n  formRefusal: undefined,\n  clearErrors: () => {},\n  reset: () => {},\n  succeeded: false,\n  recentlySucceeded: false,\n  // Outside a Form there is nothing holding a value, so a binding that reported\n  // one would be lying. Name only, which is the part that is still true.\n  field: ((name: string) => ({\n    name,\n    value: \"\",\n    onChange: () => {},\n    onBlur: () => {},\n  })) as FormRenderProps[\"field\"],\n});\n\n/**\n * The store, on its own context.\n *\n * Separate from the status context because that one holds a fresh object every\n * render, so anything reading it re-renders with the form. The store is stable\n * for the life of the form, which is what lets a subscriber below it re-render\n * alone.\n */\nconst FormStoreContext = createContext<{\n  store: FormStore;\n  touch: (name: string) => void;\n} | null>(null);\n\n/**\n * A value store created above the form rather than by it.\n *\n *     const store = useFormStore({ title: '' })\n *\n *     <TopBar store={store} />              // not inside the form\n *     <Form action={save} store={store}>…</Form>\n *\n * For the one case the context cannot reach. `<Form>` makes its own otherwise,\n * and almost every form should let it — this exists so that a component which\n * is not a descendant can still read the values, which is the flexibility\n * react-hook-form and TanStack Form get from `useForm()` being yours to call.\n *\n * Deliberately not reactive itself: creating the store does not subscribe to\n * it, so the component holding it does not re-render on every keystroke and\n * take the whole subtree with it. Read a field from it with `useField(name, store)`.\n */\nexport function useFormStore<T extends Record<string, unknown>>(\n  initial: Partial<T> = {},\n): FormStore {\n  const ref = useRef<FormStore | null>(null);\n\n  ref.current ??= createFormStore({ ...initial });\n\n  return ref.current;\n}\n\n/**\n * The form this component is inside: the same object `<Form>`'s render prop\n * gets, so a field split into its own component is written exactly as it\n * was inline.\n *\n *     function Title() {\n *       const { field, error } = useForm()\n *\n *       return (\n *         <>\n *           <input name=\"title\" />\n *           {error('title') && <p>{error('title')}</p>}\n *         </>\n *       )\n *     }\n *\n * Not React's `useFormStatus`, which is a different hook with a different\n * answer - which is why this one is not called that.\n */\nexport function useForm<\n  T extends Record<string, unknown> = Record<string, unknown>,\n  Refusal = unknown,\n>(): FormRenderProps<T, Refusal> {\n  return useContext(FormStatusContext) as FormRenderProps<T, Refusal>;\n}\n\n/**\n * One field, subscribed on its own - for a large controlled form.\n *\n * The same two words as everywhere else, for one name: `field` to spread,\n * `error` to show. The component re-renders when this field changes and at no\n * other time, where `useForm()` re-renders with the whole form. Reach for it\n * when re-rendering all of a form per keystroke is real:\n *\n *     function Title() {\n *       const { field, error } = useField('title')\n *\n *       return <Input {...field} aria-invalid={!!error} />\n *     }\n *\n * Given a store, it reads a form from outside it - see useFormStore.\n */\nexport function useField(\n  name: string,\n  store?: FormStore,\n): { field: FieldBinding<string>; error: string | undefined } {\n  const ctx = useContext(FormStoreContext);\n  const status = useContext(FormStatusContext);\n\n  if (!ctx && !store) {\n    throw new Error(\n      \"useField() was called outside a <Form>. It reads that form's values, so there has to be one above it.\",\n    );\n  }\n\n  const source = store ?? ctx!.store;\n  const touch = ctx?.touch;\n\n  const value = useSyncExternalStore(\n    source.subscribe,\n    () => (source.get(name) ?? \"\") as string,\n    () => \"\",\n  );\n\n  return {\n    field: {\n      name,\n      value,\n      onChange: (next) => {\n        source.set(\n          name,\n          typeof next === \"object\" && next !== null && \"target\" in next\n            ? (next as { target: { value: string } }).target.value\n            : next,\n        );\n      },\n      onBlur: () => void touch?.(name),\n    },\n    error: status.error(name as never),\n  };\n}\n\n/**\n * submitForm bound to an action, once per action.\n *\n * Bound on every render, it was a fresh function with a fresh promise for\n * its bound arguments each time - and React, seating a posted form's state\n * during the server render, suspends on that promise until it settles, then\n * renders the component again, which bound again. A render that never\n * finished, on every page a form was posted to without javascript. One\n * bound function per action, and the promise settles once.\n */\nconst boundSubmits = new WeakMap<Function, (previous: unknown, formData: FormData) => Promise<unknown>>();\n\nfunction boundSubmit(action: (formData: FormData) => Promise<unknown>) {\n  let bound = boundSubmits.get(action);\n\n  if (!bound) {\n    bound = submitForm.bind(null, action);\n    boundSubmits.set(action, bound);\n  }\n\n  return bound;\n}\n\n/**\n * A form's values as one comparable string.\n *\n * FormData in document order, a file by its name and size: enough to say\n * whether anything changed, which is all `dirty` asks.\n */\nfunction serializeForm(form: HTMLFormElement): string {\n  const parts: string[] = [];\n\n  for (const [name, value] of new FormData(form)) {\n    parts.push(\n      name + \"=\" + (typeof value === \"string\" ? value : \"file:\" + value.name + \":\" + value.size),\n    );\n  }\n\n  return parts.join(\"\\n\");\n}\n\n/**\n * Also exported by name, and re-exported below, because both spellings are in\n * use: `import Form from` and `import { Form } from`.\n */\nexport default function Form<\n  T extends Record<string, unknown> = Record<string, unknown>,\n  A extends FormAction = FormAction,\n>({\n  action,\n  method: methodProp,\n  defaultValues,\n  store: providedStore,\n  prefetch = \"hover\",\n  cacheFor,\n  replace = false,\n  preserveScroll = false,\n  resetOnSuccess = true,\n  schema,\n  transform,\n  optimistic,\n  onSuccess,\n  onError,\n  onSubmit,\n  children,\n  ref: callerRef,\n  ...rest\n}: FormProps<T, A>) {\n  const isGetForm = typeof action === \"string\";\n  const method = methodProp ?? (isGetForm ? \"get\" : \"post\");\n\n  // The answer to this form posted without a runtime, seated by React into\n  // the form that posted it - which is the only way a visitor with no\n  // javascript sees a refusal. Registered through submitForm, bound to the\n  // action, because React hands a form-state action a (previous, formData)\n  // pair and the action takes the FormData alone. On the server a plain\n  // function - a closure, not a server reference - cannot be bound into a\n  // form; the form falls back to the action itself, and posts nothing\n  // seatable, which is all a closure could ever have done.\n  const bindable =\n    typeof action === \"function\" && (typeof window !== \"undefined\" || \"$$FORM_ACTION\" in action);\n  const [posted, formAction] = useActionState(\n    bindable ? boundSubmit(action as (formData: FormData) => Promise<unknown>) : async () => null,\n    null as unknown,\n  );\n  const postedRefusal = resultOf(posted);\n  const [errors, setErrors] = useState<Record<string, string[]>>(() => postedRefusal?.errors ?? {});\n  // A refusal's data, tied to the exact form-level error it came with: when\n  // that entry is cleared or replaced - the next submit, a success,\n  // clearErrors() - the data goes with it, without every place that touches\n  // the errors having to know.\n  const [refusal, setRefusal] = useState<{ for: string[]; data: unknown } | null>(null);\n  const [touched, setTouched] = useState<Record<string, boolean>>({});\n\n  /**\n   * Mark a field visited, and check it.\n   *\n   * Checking on blur rather than on every keystroke, because an error that\n   * appears while someone is halfway through typing an email address is a form\n   * arguing with them. Leaving the field is the moment they have finished\n   * saying what they meant.\n   *\n   * The whole object is validated and only this field's issues are kept: a\n   * Standard Schema has no notion of one field, and filtering by path is the\n   * honest way to ask it about one. Everything else's errors are left as they\n   * were, so blurring an empty field does not light up the rest of the form.\n   */\n  const touch = useCallback(\n    async (name: string) => {\n      setTouched((prev) => (prev[name] ? prev : { ...prev, [name]: true }));\n\n      if (!schema || !formRef.current) return;\n\n      const invalid = await validateWith(\n        schema,\n        decodeFormData(new FormData(formRef.current), schema),\n      );\n\n      setErrors((prev) => {\n        const next = { ...prev };\n\n        if (invalid?.[name]) next[name] = invalid[name];\n        else delete next[name];\n\n        return next;\n      });\n    },\n    [schema],\n  );\n\n  const [succeeded, setSucceeded] = useState(false);\n  const [recentlySucceeded, setRecentlySucceeded] = useState(false);\n  const recentTimer = useRef<ReturnType<typeof setTimeout> | undefined>(\n    undefined,\n  );\n\n  // Cleared on unmount: a timer that fires into a component that has gone is\n  // the warning nobody reads and the leak nobody finds.\n  useEffect(() => () => clearTimeout(recentTimer.current), []);\n\n  // Only the fields someone bound. Everything else is the DOM's.\n  //\n  // A store rather than state, so a component using `useField` can re-render\n  // for one field while this one does not. See formStore.ts.\n  const storeRef = useRef<FormStore | null>(null);\n\n  storeRef.current ??= createFormStore({\n    ...(defaultValues as Record<string, unknown> | undefined),\n  });\n\n  const store = providedStore ?? storeRef.current;\n\n  // Which names the render prop read through `field()`. A change to one of\n  // those has to re-render this component, because that is where the value is\n  // being displayed; a change to anything else does not, which is what lets a\n  // `useField` child stand on its own.\n  const readHere = useRef(new Set<string>());\n  const [, bump] = useState(0);\n\n  useEffect(\n    () =>\n      store.subscribe((name) => {\n        if (name === \"\" || readHere.current.has(name)) bump((n) => n + 1);\n      }),\n    [store],\n  );\n  const [currentData, setCurrentData] = useState<T>({} as T);\n  const [isPending, startTransition] = useTransition();\n  const formRef = useRef<HTMLFormElement>(null);\n  // Read by the delayed blur check, which runs after the render that set it:\n  // the value its closure captured is the one from before the submit began.\n  const pendingRef = useRef(false);\n  pendingRef.current = isPending;\n\n  // A reset owed by a successful submit, performed in the commit that ends\n  // it. The action resolves a tick before React commits its transition - the\n  // result, whatever the action revalidated, pending going false - and a\n  // reset done on resolve was a DOM write with a frame of its own: a chat's\n  // composer emptied before the reply it was answered with appeared. In a\n  // layout effect of the commit where pending turns false, it lands in the\n  // same frame as the result, before the browser paints.\n  const resetOwed = useRef<{ result: unknown } | null>(null);\n\n  // What the form started with, as its FormData reads: the baseline `dirty`\n  // is measured against. Taken on mount, retaken after a successful submit.\n  const baseline = useRef<string | null>(null);\n  const [dirty, setDirty] = useState(false);\n  // Only a form that reads `dirty` pays for it: the flip from clean to dirty\n  // is a render of the whole form, and a field that subscribes for itself\n  // is promised that typing in it renders it alone.\n  const dirtyRead = useRef(false);\n\n  const snapshot = useCallback(() => {\n    if (!formRef.current) return;\n\n    baseline.current = serializeForm(formRef.current);\n    setDirty(false);\n  }, []);\n\n  const measureDirty = useCallback(() => {\n    if (!dirtyRead.current || !formRef.current || baseline.current === null) return;\n\n    const now = serializeForm(formRef.current) !== baseline.current;\n\n    setDirty((was) => (was === now ? was : now));\n  }, []);\n\n  useEffect(snapshot, [snapshot]);\n\n  // A bound control with no native element behind it changes through the\n  // store, not through an input event - a Radix select - so the store is\n  // watched too. Its input, if it has one, is read back with the rest. In\n  // a microtask: the fields subscribed before this effect ran, so React's\n  // own flush of their update is queued ahead of the measure, and the\n  // element is read after it was written.\n  useEffect(() => store.subscribe(() => queueMicrotask(measureDirty)), [store, measureDirty]);\n\n  // A reset writes every bound field at once, through a render of this\n  // component; the measure has to read the elements after that commit,\n  // and a microtask queued during the reset ran before it. Marked here,\n  // measured by the effect below once the render lands.\n  const remeasure = useRef(false);\n\n  useEffect(() => {\n    if (!remeasure.current) return;\n\n    remeasure.current = false;\n    measureDirty();\n  });\n\n  useLayoutEffect(() => {\n    const owed = resetOwed.current;\n\n    if (!owed || isPending) return;\n\n    resetOwed.current = null;\n    store.reset();\n    formRef.current?.reset();\n    setTouched({});\n    setCurrentData({} as T);\n    snapshot();\n    // After the reset, as it always ran: an onSuccess that fills or focuses a\n    // field must not have the reset undo it.\n    onSuccess?.(owed.result);\n  });\n\n  // Both handles, one element. React 19 hands a function component its ref\n  // as a prop, and spread after the form's own it replaced it - every\n  // FormData read then found null. A caller's ref is filled beside ours.\n  const attachForm = useCallback(\n    (element: HTMLFormElement | null) => {\n      formRef.current = element;\n\n      if (typeof callerRef === \"function\") callerRef(element);\n      else if (callerRef) callerRef.current = element;\n    },\n    [callerRef],\n  );\n\n  const error = useCallback(\n    (field: FieldPath<T>): string | undefined => errors[field]?.[0],\n    [errors],\n  );\n\n  const clearErrors = useCallback((...fields: FieldPath<T>[]) => {\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  // The store first, then the DOM. A bound field renders from the store, so\n  // a DOM reset alone put its default in the element for one frame and the\n  // typed value back on the next render: a port's Discard left the name as\n  // typed while the dirty flag went clean beside it.\n  const resetForm = useCallback(() => {\n    remeasure.current = true;\n    store.reset();\n    formRef.current?.reset();\n    setErrors({});\n    setCurrentData({} as T);\n    queueMicrotask(measureDirty);\n  }, [store, measureDirty]);\n\n  useEffect(() => {\n    if (isGetForm && prefetch === \"mount\") {\n      const fn = (window as any).__rsc_prefetch;\n      fn?.(action, cacheFor);\n    }\n  }, [isGetForm, prefetch, action, cacheFor]);\n\n  const doPrefetch = useCallback(() => {\n    if (!isGetForm) return;\n    const fn = (window as any).__rsc_prefetch;\n    fn?.(action as string, cacheFor);\n  }, [isGetForm, action, cacheFor]);\n\n  const handleSubmit = useCallback(\n    async (e: FormEvent<HTMLFormElement>) => {\n      e.preventDefault();\n      const formData = new FormData(e.currentTarget);\n      const data = decodeFormData<T>(formData, schema);\n      setCurrentData(data);\n\n      if (onSubmit?.(formData) === false) {\n        return;\n      }\n\n      if (isGetForm && method === \"get\") {\n        const url = new URL(action as string, window.location.origin);\n        for (const [key, value] of formData.entries()) {\n          if (typeof value === \"string\" && value !== \"\") {\n            url.searchParams.set(key, value);\n          }\n        }\n\n        const path = url.pathname + url.search;\n        const shell = action as string;\n        const nav = (window as any).__rsc_navigate;\n        const prefetched = (window as any).__rsc_is_prefetched;\n\n        // The route without its query is that route's shell: the layout, the\n        // chrome, and whatever it renders with nothing to show yet. Prefetching\n        // on hover put it in the cache, so going there first costs no request\n        // and puts the page on screen while the real query is still running.\n        //\n        // The query itself is never prefetched. It is the expensive half, and\n        // hovering a search button is not a reason to run someone's search.\n        if (path !== shell && prefetched?.(shell)) {\n          // Awaited rather than raced: navigate() aborts whatever is in flight,\n          // so starting the real one first would cancel the shell before it\n          // could render. It is a cache hit, so this is a render, not a wait.\n          Promise.resolve(nav?.(shell, { replace, preserveScroll })).then(() =>\n            // Replaces, so the shell does not become a back-button stop of its\n            // own — the pair leaves exactly one entry behind.\n            nav?.(path, { replace: true, preserveScroll }),\n          );\n\n          return;\n        }\n\n        nav?.(path, { replace, preserveScroll });\n        return;\n      }\n\n      const serverAction = action as (formData: FormData) => Promise<unknown>;\n\n      // Rebuilt rather than edited: transform returns the values to send, so\n      // whatever was in the form and is not in the result should not go.\n      if (transform) {\n        for (const key of [...formData.keys()]) formData.delete(key);\n\n        for (const [key, value] of buildFormData(transform(data))) {\n          formData.append(key, value);\n        }\n      }\n\n      setErrors({});\n\n      // Before the transition, so a failure neither runs the optimistic\n      // update nor leaves the form looking like it is submitting.\n      const invalid = await validateWith(schema, data);\n\n      if (invalid) {\n        setErrors(invalid);\n        onError?.(invalid);\n\n        return;\n      }\n\n      startTransition(async () => {\n        try {\n          // Call optimistic updater inside the transition so React's\n          // useOptimistic picks it up and auto-reverts on settle.\n          optimistic?.(data);\n\n          // Whatever an earlier call noted is not this action's: a redirect\n          // from another form, or from an action no form was waiting for - a\n          // logout button - is left behind until someone reads it, and the\n          // next form to succeed took it for its own and skipped onSuccess.\n          redirectedTo();\n\n          const result = await serverAction(formData);\n          const refused = resultOf(result);\n          // Read every time, which is what clears it. Behind the || below it\n          // went unread whenever the answer already said \"redirected\", and\n          // stayed for the next form.\n          const redirected = redirectedTo();\n\n          // The action answered with somewhere to go, and callServer has\n          // already started the navigation. Not an error for a form to\n          // show, and not a save to announce either: signing in and going\n          // to the dashboard is the whole success.\n          if (refused?.redirected !== undefined || redirected !== null) return;\n\n          if (refused) {\n            if (refused.errors) {\n              setErrors(refused.errors);\n              onError?.(refused.errors);\n            } else {\n              // Under the form's own key, so every place that clears the\n              // errors clears it too.\n              const formLevel = [refused.serverError ?? \"The action was refused.\"];\n\n              setErrors({ \"\": formLevel });\n              setRefusal(refused.refusal === undefined ? null : { for: formLevel, data: refused.refusal });\n              onError?.({}, new Error(refused.serverError));\n            }\n\n            return;\n          }\n\n          // Owed, not done: see resetOwed. Saved, so what is in the form is\n          // what the server has - measured after the reset where there is one.\n          if (resetOnSuccess) resetOwed.current = { result };\n          else snapshot();\n\n          setErrors({});\n          setSucceeded(true);\n          setRecentlySucceeded(true);\n\n          clearTimeout(recentTimer.current);\n          recentTimer.current = setTimeout(\n            () => setRecentlySucceeded(false),\n            2_000,\n          );\n\n          if (!resetOnSuccess) onSuccess?.(result);\n        } catch (err) {\n          // A redirect no longer arrives here - callServer resolves after\n          // performing it - but an action called through something older\n          // than that still may.\n          if (err instanceof ServerRedirectError) return;\n\n          if (err instanceof ServerValidationError) {\n            setErrors(err.errors);\n            onError?.(err.errors);\n          } else if (err instanceof ActionRefusedError) {\n            // A backend turned a generated stub down: its message, written for\n            // the person asking, is the form's error.\n            setErrors({ \"\": [err.message] });\n            setRefusal(null);\n            onError?.({}, err);\n          } else if (err instanceof ServerDumpError) {\n            // Dump overlay is already shown — silently swallow\n          } else if (onError) {\n            // Not rethrown. A rejected action never settles, and until it\n            // settles React keeps the optimistic update on screen — so an\n            // unexpected failure left the row showing as though the write had\n            // worked. Settling is what takes it back.\n            onError({}, err);\n          } else {\n            // Nothing is handling it, and swallowing here would lose it\n            // entirely — the reason this used to rethrow.\n            console.error(\"[rsc-kit] form submit failed\", err);\n          }\n        }\n      });\n    },\n    [\n      action,\n      isGetForm,\n      method,\n      replace,\n      preserveScroll,\n      resetOnSuccess,\n      store,\n      schema,\n      transform,\n      optimistic,\n      onSubmit,\n      onSuccess,\n      onError,\n    ],\n  );\n\n  const field = useCallback(\n    <K extends keyof T & string>(name: K): FieldBinding<T[K]> => {\n      // Recorded during render, deliberately: this is how the form knows which\n      // values it is the one displaying. Idempotent, so a double render in\n      // development records the same name twice and means the same thing.\n      readHere.current.add(name);\n\n      return {\n        name,\n        value: (store.get(name) ?? \"\") as T[K],\n        onChange: (next: unknown) => {\n          const value =\n            typeof next === \"object\" && next !== null && \"target\" in next\n              ? (next as { target: { value: string } }).target.value\n              : next;\n\n          store.set(name, value);\n        },\n        onBlur: () => void touch(name),\n      };\n    },\n    [store, touch],\n  );\n\n\n  // Stable, so a subscriber below does not re-render because this one did.\n  const storeContext = useMemo(() => ({ store, touch }), [store, touch]);\n\n  const formStatus: FormRenderProps<T, RefusalOf<A>> = {\n    pending: isPending,\n    data: currentData,\n    get dirty() {\n      dirtyRead.current = true;\n\n      return dirty;\n    },\n    succeeded,\n    recentlySucceeded,\n    field,\n    error,\n    formError: errors[\"\"]?.[0],\n    formRefusal: (refusal && errors[\"\"] === refusal.for ? refusal.data : undefined) as RefusalOf<A> | undefined,\n    clearErrors,\n    reset: resetForm,\n  };\n\n  return (\n    <FormStoreContext.Provider value={storeContext}>\n      <FormStatusContext.Provider value={formStatus as FormRenderProps}>\n        <form\n          ref={attachForm}\n          // On the element as well as in the handler, which is what makes this\n          // work before hydration. React emits a form a browser can submit on its\n          // own for a server action, and an ordinary action/method pair for a\n          // url — so a submit that happens before the javascript arrives still\n          // reaches the server.\n          //\n          // The two do not fight: handleSubmit calls preventDefault() first, and\n          // React does not run a form action when the submit event was cancelled.\n          // So the enhanced path wins whenever there is one, and the native path\n          // is what is left when there is not.\n          action={(bindable ? formAction : action) as never}\n          // Only for a url. React sets the method itself for a server action, and\n          // passing one alongside is what it warns about.\n          method={isGetForm ? method : undefined}\n          onSubmit={handleSubmit}\n          // Every keystroke and every toggle, from any control in the form,\n          // uncontrolled ones included: React's onInput here is the bubbling\n          // `input` event. A caller's own handler still runs.\n          onInput={(event) => {\n            rest.onInput?.(event);\n            measureDirty();\n          }}\n          onChange={(event) => {\n            rest.onChange?.(event);\n            measureDirty();\n          }}\n          // On the form, not only on the bound fields. `focusout` bubbles where\n          // `blur` does not, so React's onBlur here sees every control that was\n          // left — including the uncontrolled ones, which are most of them and\n          // would otherwise never be marked touched at all.\n          onBlur={(event) => {\n            const target = event.target as unknown as {\n              name?: string;\n              value?: string;\n            };\n            const name = target.name;\n\n            if (!name) return;\n\n            // Leaving a field is the moment to check it; leaving the form is\n            // not the same moment. Focus going to nothing, or to something\n            // outside the form, is a click on the page - most often a dialog\n            // closing - and an error painted into a dialog as it animates out\n            // reads as a submit that nobody made. An empty field left that way\n            // is not checked at all. One with something in it is, but only\n            // once the dust settles: if the form is gone or hidden by then, it\n            // was a dialog closing, and nobody is there to read the error.\n            const left = event.relatedTarget as Node | null;\n            const stillInForm = !!left && !!formRef.current?.contains(left);\n\n            if (stillInForm) {\n              void touch(name);\n\n              return;\n            }\n\n            if (!target.value) return;\n\n            setTimeout(() => {\n              const form = formRef.current;\n\n              if (\n                !form ||\n                !form.isConnected ||\n                form.getClientRects().length === 0\n              )\n                return;\n              // A submit in flight is not a dialog closing, and its answer is\n              // the verdict on every field. On iOS a tap on the submit button\n              // does not focus it, so the last field's blur arrives here as\n              // \"left the form\" - and by now the fields may be disabled for\n              // the pending submit, missing from its data, and judged absent:\n              // \"last name is required\" flashed on the way to the next step.\n              if (pendingRef.current) return;\n              // Nor a field disabled by now, for the same reason: its value is\n              // not in the form's data, so it would always read as missing.\n              if ((event.target as { disabled?: boolean }).disabled) return;\n              if (\n                form.closest(\n                  \"[hidden], [aria-hidden='true'], [data-ending-style], [data-closed]\",\n                )\n              )\n                return;\n\n              void touch(name);\n            }, LEAVE_FORM_SETTLE_MS);\n          }}\n          onMouseEnter={prefetch === \"hover\" ? doPrefetch : undefined}\n          data-pending={isPending ? \"\" : undefined}\n          {...rest}\n        >\n          {typeof children === \"function\" ? children(formStatus) : children}\n        </form>\n      </FormStatusContext.Provider>\n    </FormStoreContext.Provider>\n  );\n}\n\n// Also by name, because both spellings are in use: `import Form` and\n// `import { Form }`. This was a re-export of \"./Form\" — from inside Form.tsx,\n// so the module named itself. It survived on the bundler tolerating a circular\n// self-reference, left over from when a separate barrel re-exported a\n// FormComponent.tsx that a case-insensitive filesystem would not let be called\n// Form.ts. There is one file now, and it can just export what it declares.\nexport { Form };\n"]}

package/dist/js/createViteRscApp.js

@@ -17,7 +17,7 @@ import { createElement, startTransition } from "react";
 import { createRoot, hydrateRoot } from "react-dom/client";
 import { activityMarkersIn } from "./activityMarkers";
 import { ActivityRoot } from "./ActivityRouter";
-import { ServerRedirectError, noteRedirected, throwForFailedAction } from "./errors";
+import { ActionRefusedError, ServerRedirectError, ServerValidationError, noteRedirected, refusalOf, throwForFailedAction, } from "./errors";
 import { fetchPagePayload } from "./pagePayload";
 import { inlinePayload } from "./inlinePayload";
 import { claimRead, setQueryCodec } from "./queryClient";
@@ -151,7 +151,16 @@ export async function createViteRscApp(container = document, interceptEntries =
             throw err;
         }
         const answer = await createFromReadableStream(res.body, { callServer });
-        return unwrapRevalidated(answer, from);
+        const result = unwrapRevalidated(answer, from);
+        // The backend turned the call down. Thrown, so the code after the await
+        // does not take it for what it asked for; the message came in the answer
+        // because React strips the message of anything the server throws.
+        const refused = refusalOf(result);
+        if (refused?.errors)
+            throw new ServerValidationError(refused.message, refused.errors);
+        if (refused)
+            throw new ActionRefusedError(refused.message, refused.status);
+        return result;
     }
     /**
      * Put anything the action re-rendered on screen, and hand back its result.