@archipelago-js/react 0.1.0 → 0.2.0

package/README.md

@@ -1,6 +1,6 @@
 # @archipelago-js/react
 
-React bindings for Archipelago islands.
+React bindings for [Archipelago](https://github.com/robrace/archipelago) islands — server-rendered micro-frontends powered by Rails and React.
 
 ## Install
 
@@ -8,10 +8,254 @@ React bindings for Archipelago islands.
 yarn add @archipelago-js/react @archipelago-js/client react react-dom
 ```
 
-## API
+## 60-Second Quick Start
 
-- `bootArchipelagoIslands(registry)`
-- `useIslandProps(options?)`
-- `useIslandForm(options)`
-- `IslandProvider`
-- `ErrorBoundary`
+### 1. Rails View Helper
+
+Render an island from any ERB template:
+
+```erb
+<%= archipelago_island("TeamMembers", props: { team_id: @team.id }, stream: "team:#{@team.id}") %>
+```
+
+### 2. React Island Component
+
+Create `app/javascript/islands/TeamMembers.tsx`:
+
+```tsx
+import { useIslandProps, useIslandForm } from "@archipelago-js/react"
+
+export default function TeamMembers() {
+  const { props } = useIslandProps()
+  const form = useIslandForm({ initialData: { name: "" } })
+
+  return (
+    <div>
+      <h2>Team #{props.team_id}</h2>
+      <input
+        value={form.data.name}
+        onChange={(e) => form.setData("name", e.target.value)}
+      />
+      <button onClick={() => form.post("add_member")} disabled={form.processing}>
+        {form.recentlySuccessful ? "Added!" : "Add Member"}
+      </button>
+      {form.errors.name?.map((e) => <p key={e}>{e}</p>)}
+    </div>
+  )
+}
+```
+
+### 3. Boot Islands
+
+In your JS entry file:
+
+```tsx
+import { bootArchipelagoIslands } from "@archipelago-js/react"
+import TeamMembers from "../islands/TeamMembers"
+
+void bootArchipelagoIslands({
+  TeamMembers
+})
+```
+
+## Context
+
+Every island is wrapped in an `IslandProvider` that provides context via `useIslandContext()`:
+
+| Field       | Type                           | Description                                 |
+|-------------|--------------------------------|---------------------------------------------|
+| `component` | `string`                       | Island component name                       |
+| `params`    | `Record<string, unknown>`      | Server-side params embedded in the HTML     |
+| `instance`  | `string \| undefined`          | Optional instance identifier                |
+| `stream`    | `string \| undefined`          | ActionCable stream name for live updates    |
+| `state`     | `{ props, version }`           | Current props and version                   |
+| `setState`  | `Dispatch<SetStateAction<…>>`  | Update island state                         |
+
+`useIslandProps()` is the primary way to read props:
+
+```tsx
+const { props, setProps, version } = useIslandProps()
+```
+
+## Forms
+
+### `useIslandForm` (Controlled)
+
+The form hook manages data, errors, processing state, and submission:
+
+```tsx
+const form = useIslandForm({
+  initialData: { email: "", role: "member" },
+  clearFieldErrorsOnChange: true,
+  recentlySuccessfulDuration: 2000,
+  transform: (data) => ({ ...data, email: data.email.toLowerCase() }),
+  onSuccess: (response) => console.log("Saved!", response),
+  onError: (response) => console.log("Validation failed", response),
+  onFinish: () => console.log("Request complete")
+})
+```
+
+**Returned values:**
+
+| Property               | Type                                    | Description                                      |
+|------------------------|-----------------------------------------|--------------------------------------------------|
+| `data`                 | `TData`                                 | Current form data                                |
+| `setData(field, val)`  | `(field, value) => void`                | Set a field value                                |
+| `errors`               | `Record<string, string[]>`              | Field-keyed validation errors                    |
+| `setError(field, msg)` | `(field, message) => void`              | Manually set a field error                       |
+| `clearErrors(...f?)`   | `(...fields?) => void`                  | Clear all or specific errors                     |
+| `processing`           | `boolean`                               | True while request is in flight                  |
+| `wasSuccessful`        | `boolean`                               | True after an ok/redirect response               |
+| `recentlySuccessful`   | `boolean`                               | True for `recentlySuccessfulDuration` ms after success |
+| `progress`             | `{ percentage } \| null`                | Upload progress (future XHR support)             |
+| `transportError`       | `Error \| null`                         | Network/parse error (not a validation error)     |
+| `defaults(...)`        | Getter/setter for default values        | `defaults()` returns defaults; `defaults(next)` updates them |
+| `reset(...fields?)`    | `(...fields?) => void`                  | Reset all or specific fields to defaults         |
+| `resetAndClearErrors`  | `(...fields?) => void`                  | Reset data + clear errors                        |
+| `post(op, overrides?)` | `(operation, overrides?) => Promise`    | Submit with POST                                 |
+| `put` / `patch` / `delete` | Same as `post`                      | Submit with PUT / PATCH / DELETE                 |
+
+### `<IslandForm>` (Declarative / Uncontrolled)
+
+For simple forms that don't need keystroke-level control:
+
+```tsx
+import { IslandForm } from "@archipelago-js/react"
+
+<IslandForm operation="update_settings" method="patch" resetOnSuccess>
+  <input name="display_name" defaultValue={props.display_name} />
+  <button type="submit">Save</button>
+</IslandForm>
+```
+
+Render-prop children get access to the full form object:
+
+```tsx
+<IslandForm operation="create_post" method="post">
+  {(form) => (
+    <>
+      <input name="title" />
+      {form.errors.title?.map((e) => <span key={e}>{e}</span>)}
+      <button type="submit" disabled={form.processing}>
+        {form.recentlySuccessful ? "Created!" : "Create"}
+      </button>
+    </>
+  )}
+</IslandForm>
+```
+
+**Props:**
+
+| Prop                   | Type                     | Default   |
+|------------------------|--------------------------|-----------|
+| `operation`            | `string`                 | required  |
+| `method`               | `FormMethod`             | `"post"`  |
+| `transform`            | `(data) => data`         | —         |
+| `resetOnSuccess`       | `boolean`                | `false`   |
+| `clearErrorsOnSuccess` | `boolean`                | `false`   |
+| `fixedParams`          | `Record<string, unknown>`| —         |
+| `onSuccess`            | `(response) => void`     | —         |
+| `onError`              | `(response) => void`     | —         |
+| `onForbidden`          | `(response) => void`     | —         |
+| `onFinish`             | `(response?) => void`    | —         |
+
+## Streams (Live Updates via ActionCable)
+
+Islands with a `stream` attribute automatically subscribe to an ActionCable channel. When a broadcast arrives, `useIslandProps()` updates the props in real time.
+
+### Setup
+
+Assign an ActionCable consumer globally:
+
+```ts
+import { createConsumer } from "@rails/actioncable"
+window.Archipelago = { cable: createConsumer() }
+```
+
+### Server Broadcast
+
+```ruby
+Archipelago.broadcast("team:#{team.id}", props: { members: team.members.as_json })
+```
+
+### Custom Merge Logic
+
+Use `onLiveProps` to merge incoming props with the current state:
+
+```tsx
+const { props } = useIslandProps({
+  onLiveProps: (next, previous) => ({
+    ...previous,
+    members: next.members
+  })
+})
+```
+
+## Lazy Islands (`defineIslandLoader`)
+
+Code-split islands so their JavaScript is only fetched when the island appears in the DOM:
+
+```tsx
+import { defineIslandLoader, bootArchipelagoIslands } from "@archipelago-js/react"
+
+void bootArchipelagoIslands({
+  TeamMembers: defineIslandLoader(
+    () => import("../islands/TeamMembers"),
+    <div>Loading team...</div>  // optional fallback
+  )
+})
+```
+
+The Rails generator supports `--lazy_registry` to scaffold a lazy registry automatically:
+
+```bash
+bin/rails generate archipelago:install:react --lazy_registry
+```
+
+## Turbo Lifecycle
+
+Archipelago integrates seamlessly with Turbo Drive and Turbo Frames:
+
+- **`turbo:load`** / **`turbo:render`** / **`turbo:frame-load`** — Automatically boots any new `[data-island]` elements added to the page.
+- **`turbo:before-cache`** — All mounted islands are unmounted before Turbo caches the page, preventing stale React trees from persisting in the snapshot.
+- **MutationObserver** — A DOM observer detects dynamically inserted islands (e.g. from Turbo Streams or manual DOM manipulation) and boots them automatically.
+
+No extra configuration is needed. Just call `bootArchipelagoIslands(registry)` once in your entry file.
+
+## Error Handling
+
+### `FORM_ERROR`
+
+The `@archipelago-js/client` package exports a `FORM_ERROR` constant (`"_base"`) for base-level form errors:
+
+```tsx
+import { FORM_ERROR } from "@archipelago-js/client"
+
+{form.errors[FORM_ERROR]?.map((e) => <p key={e}>{e}</p>)}
+```
+
+### `ArchipelagoTransportError`
+
+Network failures, HTML responses, and JSON parse errors are wrapped in `ArchipelagoTransportError` (also exported from `@archipelago-js/client`). The form hook captures these into `form.transportError`.
+
+### `ErrorBoundary`
+
+Each island is wrapped in an `ErrorBoundary`. If an island crashes, the error is contained and other islands continue to function.
+
+## API Reference
+
+| Export                        | Package  | Description                              |
+|-------------------------------|----------|------------------------------------------|
+| `bootArchipelagoIslands`      | react    | Mount all `[data-island]` elements       |
+| `unmountArchipelagoIslands`   | react    | Tear down all mounted islands            |
+| `defineIslandLoader`          | react    | Create a lazy-loaded registry entry      |
+| `useIslandProps`              | react    | Read/subscribe to island props           |
+| `useIslandForm`               | react    | Controlled form state and submission     |
+| `IslandForm`                  | react    | Declarative form component               |
+| `IslandProvider`              | react    | Context provider (used internally)       |
+| `useIslandContext`            | react    | Access raw island context                |
+| `ErrorBoundary`               | react    | Per-island error boundary                |
+| `islandFetch`                 | client   | Low-level island RPC call                |
+| `FORM_ERROR`                  | client   | `"_base"` constant for base errors       |
+| `ArchipelagoTransportError`   | client   | Typed transport error class              |
+| `parseIslandResponse`         | client   | Parse raw JSON into typed response       |

package/dist/IslandForm.d.ts

@@ -0,0 +1,16 @@
+import React from "react";
+import { useIslandForm, type UseIslandFormCallbacks } from "./useIslandForm";
+type FormMethod = "post" | "put" | "patch" | "delete";
+type IslandFormRenderProps = ReturnType<typeof useIslandForm>;
+export interface IslandFormProps extends UseIslandFormCallbacks<Record<string, unknown>> {
+    operation: string;
+    method?: FormMethod;
+    transform?: (payload: Record<string, unknown>) => Record<string, unknown>;
+    resetOnSuccess?: boolean;
+    clearErrorsOnSuccess?: boolean;
+    fixedParams?: Record<string, unknown>;
+    className?: string;
+    children: React.ReactNode | ((form: IslandFormRenderProps) => React.ReactNode);
+}
+export declare function IslandForm({ operation, method, transform, resetOnSuccess, clearErrorsOnSuccess, fixedParams, className, children, onSuccess, onError, onForbidden, onFinish }: IslandFormProps): React.ReactElement;
+export {};

package/dist/IslandForm.js

@@ -0,0 +1,51 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { useCallback, useRef } from "react";
+import { useIslandForm } from "./useIslandForm";
+function formDataToObject(formData) {
+    const result = {};
+    formData.forEach((value, key) => {
+        const existing = result[key];
+        if (existing !== undefined) {
+            if (Array.isArray(existing)) {
+                existing.push(value);
+            }
+            else {
+                result[key] = [existing, value];
+            }
+        }
+        else {
+            result[key] = value;
+        }
+    });
+    return result;
+}
+export function IslandForm({ operation, method = "post", transform, resetOnSuccess = false, clearErrorsOnSuccess = false, fixedParams, className, children, onSuccess, onError, onForbidden, onFinish }) {
+    const formRef = useRef(null);
+    const form = useIslandForm({
+        initialData: {},
+        fixedParams,
+        transform,
+        onSuccess: (response) => {
+            if (resetOnSuccess) {
+                form.reset();
+                formRef.current?.reset();
+            }
+            if (clearErrorsOnSuccess) {
+                form.clearErrors();
+            }
+            onSuccess?.(response);
+        },
+        onError,
+        onForbidden,
+        onFinish
+    });
+    const handleSubmit = useCallback((event) => {
+        event.preventDefault();
+        const formData = new FormData(event.currentTarget);
+        const payload = formDataToObject(formData);
+        const submitFn = form[method];
+        submitFn(operation, { payload });
+    }, [form, method, operation]);
+    return (_jsx("form", { ref: formRef, onSubmit: handleSubmit, className: className, children: typeof children === "function" ? children(form) : children }));
+}
+//# sourceMappingURL=IslandForm.js.map

package/dist/IslandForm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IslandForm.js","sourceRoot":"","sources":["../src/IslandForm.tsx"],"names":[],"mappings":";AAAA,OAAc,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,OAAO,CAAA;AAElD,OAAO,EAAE,aAAa,EAA+B,MAAM,iBAAiB,CAAA;AAiB5E,SAAS,gBAAgB,CAAC,QAAkB;IAC1C,MAAM,MAAM,GAA4B,EAAE,CAAA;IAE1C,QAAQ,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;QAC9B,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,CAAA;QAC5B,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC3B,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAC5B,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;YACtB,CAAC;iBAAM,CAAC;gBACN,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAA;YACjC,CAAC;QACH,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAA;QACrB,CAAC;IACH,CAAC,CAAC,CAAA;IAEF,OAAO,MAAM,CAAA;AACf,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,EACzB,SAAS,EACT,MAAM,GAAG,MAAM,EACf,SAAS,EACT,cAAc,GAAG,KAAK,EACtB,oBAAoB,GAAG,KAAK,EAC5B,WAAW,EACX,SAAS,EACT,QAAQ,EACR,SAAS,EACT,OAAO,EACP,WAAW,EACX,QAAQ,EACQ;IAChB,MAAM,OAAO,GAAG,MAAM,CAAkB,IAAI,CAAC,CAAA;IAE7C,MAAM,IAAI,GAAG,aAAa,CAA0B;QAClD,WAAW,EAAE,EAAE;QACf,WAAW;QACX,SAAS;QACT,SAAS,EAAE,CAAC,QAAQ,EAAE,EAAE;YACtB,IAAI,cAAc,EAAE,CAAC;gBACnB,IAAI,CAAC,KAAK,EAAE,CAAA;gBACZ,OAAO,CAAC,OAAO,EAAE,KAAK,EAAE,CAAA;YAC1B,CAAC;YACD,IAAI,oBAAoB,EAAE,CAAC;gBACzB,IAAI,CAAC,WAAW,EAAE,CAAA;YACpB,CAAC;YACD,SAAS,EAAE,CAAC,QAAQ,CAAC,CAAA;QACvB,CAAC;QACD,OAAO;QACP,WAAW;QACX,QAAQ;KACT,CAAC,CAAA;IAEF,MAAM,YAAY,GAAG,WAAW,CAC9B,CAAC,KAAuC,EAAE,EAAE;QAC1C,KAAK,CAAC,cAAc,EAAE,CAAA;QAEtB,MAAM,QAAQ,GAAG,IAAI,QAAQ,CAAC,KAAK,CAAC,aAAa,CAAC,CAAA;QAClD,MAAM,OAAO,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAA;QAE1C,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,CAAA;QAC7B,QAAQ,CAAC,SAAS,EAAE,EAAE,OAAO,EAAE,CAAC,CAAA;IAClC,CAAC,EACD,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,CAAC,CAC1B,CAAA;IAED,OAAO,CACL,eAAM,GAAG,EAAE,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,SAAS,EAAE,SAAS,YAC7D,OAAO,QAAQ,KAAK,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,GACtD,CACR,CAAA;AACH,CAAC"}

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 export * from "./ErrorBoundary";
+export * from "./IslandForm";
 export * from "./actionCable";
 export * from "./bootstrapper";
 export * from "./context";

package/dist/index.js

@@ -1,4 +1,5 @@
 export * from "./ErrorBoundary";
+export * from "./IslandForm";
 export * from "./actionCable";
 export * from "./bootstrapper";
 export * from "./context";

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAA;AAC/B,cAAc,eAAe,CAAA;AAC7B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,WAAW,CAAA;AACzB,cAAc,iBAAiB,CAAA;AAC/B,cAAc,kBAAkB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAA;AAC/B,cAAc,cAAc,CAAA;AAC5B,cAAc,eAAe,CAAA;AAC7B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,WAAW,CAAA;AACzB,cAAc,iBAAiB,CAAA;AAC/B,cAAc,kBAAkB,CAAA"}

package/dist/useIslandForm.d.ts

@@ -1,21 +1,41 @@
+import { type IslandResponse } from "@archipelago-js/client";
 type SubmitOverrides = {
     payload?: Record<string, unknown>;
     navigate?: (location: string) => void;
 };
-export interface UseIslandFormOptions<TData extends Record<string, unknown>> {
+export interface UseIslandFormCallbacks<TData extends Record<string, unknown>> {
+    onSuccess?: (response: IslandResponse) => void;
+    onError?: (response: IslandResponse) => void;
+    onForbidden?: (response: IslandResponse) => void;
+    onFinish?: (response: IslandResponse | undefined) => void;
+}
+export interface UseIslandFormOptions<TData extends Record<string, unknown>> extends UseIslandFormCallbacks<TData> {
     initialData: TData;
     clearFieldErrorsOnChange?: boolean;
     fixedParams?: Record<string, unknown>;
+    recentlySuccessfulDuration?: number;
+    transform?: (payload: TData) => Record<string, unknown>;
 }
-export declare function useIslandForm<TData extends Record<string, unknown>>({ initialData, clearFieldErrorsOnChange, fixedParams }: UseIslandFormOptions<TData>): {
+export type UploadProgress = {
+    percentage: number;
+};
+export declare function useIslandForm<TData extends Record<string, unknown>>({ initialData, clearFieldErrorsOnChange, fixedParams, recentlySuccessfulDuration, transform, onSuccess, onError, onForbidden, onFinish }: UseIslandFormOptions<TData>): {
     data: TData;
     setData: <K extends keyof TData>(field: K, value: TData[K]) => void;
     errors: Record<string, string[]>;
+    setError: (field: keyof TData | string, message: string | string[]) => void;
+    clearErrors: (...fields: (keyof TData)[]) => void;
     processing: boolean;
-    post: (operation: string, overrides?: SubmitOverrides) => Promise<import("@archipelago-js/client").IslandResponse | undefined>;
-    put: (operation: string, overrides?: SubmitOverrides) => Promise<import("@archipelago-js/client").IslandResponse | undefined>;
-    patch: (operation: string, overrides?: SubmitOverrides) => Promise<import("@archipelago-js/client").IslandResponse | undefined>;
-    delete: (operation: string, overrides?: SubmitOverrides) => Promise<import("@archipelago-js/client").IslandResponse | undefined>;
-    reset: () => void;
+    wasSuccessful: boolean;
+    recentlySuccessful: boolean;
+    progress: UploadProgress | null;
+    transportError: Error | null;
+    defaults: (...args: [] | [Partial<TData>] | [keyof TData, TData[keyof TData]]) => TData;
+    reset: (...fields: (keyof TData)[]) => void;
+    resetAndClearErrors: (...fields: (keyof TData)[]) => void;
+    post: (operation: string, overrides?: SubmitOverrides) => Promise<IslandResponse | undefined>;
+    put: (operation: string, overrides?: SubmitOverrides) => Promise<IslandResponse | undefined>;
+    patch: (operation: string, overrides?: SubmitOverrides) => Promise<IslandResponse | undefined>;
+    delete: (operation: string, overrides?: SubmitOverrides) => Promise<IslandResponse | undefined>;
 };
 export {};

package/dist/useIslandForm.js

@@ -1,12 +1,37 @@
 import { islandFetch } from "@archipelago-js/client";
-import { useCallback, useMemo, useRef, useState } from "react";
+import { useCallback, useEffect, useMemo, useRef, useState } from "react";
 import { useIslandContext } from "./context";
-export function useIslandForm({ initialData, clearFieldErrorsOnChange = true, fixedParams = {} }) {
+function deepClone(value) {
+    if (typeof structuredClone === "function") {
+        return structuredClone(value);
+    }
+    return JSON.parse(JSON.stringify(value));
+}
+function isFormDataLike(value) {
+    return typeof FormData !== "undefined" && value instanceof FormData;
+}
+export function useIslandForm({ initialData, clearFieldErrorsOnChange = true, fixedParams = {}, recentlySuccessfulDuration = 2000, transform, onSuccess, onError, onForbidden, onFinish }) {
     const { component, params, stream, setState } = useIslandContext();
     const [data, setDataState] = useState(initialData);
     const [errors, setErrors] = useState({});
     const [processing, setProcessing] = useState(false);
+    const [wasSuccessful, setWasSuccessful] = useState(false);
+    const [recentlySuccessful, setRecentlySuccessful] = useState(false);
+    const [progress, setProgress] = useState(null);
+    const [transportError, setTransportError] = useState(null);
     const requestRef = useRef(null);
+    const defaultsRef = useRef(deepClone(initialData));
+    const recentlySuccessfulTimerRef = useRef(null);
+    const mountedRef = useRef(true);
+    useEffect(() => {
+        mountedRef.current = true;
+        return () => {
+            mountedRef.current = false;
+            if (recentlySuccessfulTimerRef.current) {
+                clearTimeout(recentlySuccessfulTimerRef.current);
+            }
+        };
+    }, []);
     const setData = useCallback((field, value) => {
         setDataState((previous) => ({
             ...previous,
@@ -23,72 +48,194 @@ export function useIslandForm({ initialData, clearFieldErrorsOnChange = true, fi
             });
         }
     }, [clearFieldErrorsOnChange]);
+    const clearErrors = useCallback((...fields) => {
+        if (fields.length === 0) {
+            setErrors({});
+            return;
+        }
+        setErrors((previous) => {
+            const next = { ...previous };
+            for (const field of fields) {
+                delete next[field];
+            }
+            return next;
+        });
+    }, []);
+    const setError = useCallback((field, message) => {
+        const messages = Array.isArray(message) ? message : [message];
+        setErrors((previous) => ({
+            ...previous,
+            [field]: messages
+        }));
+    }, []);
+    const defaults = useCallback((...args) => {
+        if (args.length === 0) {
+            return deepClone(defaultsRef.current);
+        }
+        if (args.length === 1 && typeof args[0] === "object") {
+            defaultsRef.current = deepClone({ ...defaultsRef.current, ...args[0] });
+            return defaultsRef.current;
+        }
+        if (args.length === 2) {
+            const [field, value] = args;
+            defaultsRef.current = deepClone({ ...defaultsRef.current, [field]: value });
+            return defaultsRef.current;
+        }
+        return deepClone(defaultsRef.current);
+    }, []);
+    const reset = useCallback((...fields) => {
+        if (fields.length === 0) {
+            setDataState(deepClone(defaultsRef.current));
+            setErrors({});
+            return;
+        }
+        setDataState((previous) => {
+            const next = { ...previous };
+            for (const field of fields) {
+                if (field in defaultsRef.current) {
+                    next[field] = deepClone(defaultsRef.current[field]);
+                }
+            }
+            return next;
+        });
+    }, []);
+    const resetAndClearErrors = useCallback((...fields) => {
+        reset(...fields);
+        clearErrors(...fields);
+    }, [reset, clearErrors]);
     const submit = useCallback(async (method, operation, overrides = {}) => {
         requestRef.current?.controller.abort();
         const controller = new AbortController();
         const requestId = (requestRef.current?.id ?? 0) + 1;
         requestRef.current = { id: requestId, controller };
         setProcessing(true);
-        const payload = method === "post" ? data : { ...data, _method: method };
+        setWasSuccessful(false);
+        setRecentlySuccessful(false);
+        setTransportError(null);
+        setProgress(null);
+        if (recentlySuccessfulTimerRef.current) {
+            clearTimeout(recentlySuccessfulTimerRef.current);
+            recentlySuccessfulTimerRef.current = null;
+        }
+        const rawPayload = method === "post" ? data : { ...data, _method: method };
+        const payload = transform ? transform(rawPayload) : rawPayload;
         try {
             const response = await islandFetch(component, operation, payload, {
                 signal: controller.signal,
                 fixedParams: {
                     ...params,
-                    ...fixedParams,
-                    ...(stream ? { __stream: stream } : {})
+                    ...fixedParams
                 },
                 overridePayload: overrides.payload,
-                navigate: overrides.navigate
+                navigate: overrides.navigate,
+                stream: stream ?? undefined
             });
             if (requestRef.current?.id !== requestId) {
                 return response;
             }
             if (response.status === "ok") {
                 setErrors({});
+                setWasSuccessful(true);
+                setRecentlySuccessful(true);
+                recentlySuccessfulTimerRef.current = setTimeout(() => {
+                    if (mountedRef.current) {
+                        setRecentlySuccessful(false);
+                    }
+                }, recentlySuccessfulDuration);
                 setState((previous) => ({
                     props: response.props,
                     version: typeof response.version === "number" && response.version > previous.version
                         ? response.version
                         : previous.version
                 }));
+                onSuccess?.(response);
+            }
+            if (response.status === "redirect") {
+                setWasSuccessful(true);
+                setRecentlySuccessful(true);
+                recentlySuccessfulTimerRef.current = setTimeout(() => {
+                    if (mountedRef.current) {
+                        setRecentlySuccessful(false);
+                    }
+                }, recentlySuccessfulDuration);
+                onSuccess?.(response);
             }
             if (response.status === "error") {
                 setErrors(response.errors);
+                onError?.(response);
             }
             if (response.status === "forbidden") {
                 setErrors({ _base: ["forbidden"] });
+                onForbidden?.(response);
             }
+            onFinish?.(response);
             return response;
         }
         catch (error) {
             if (error.name === "AbortError") {
                 return undefined;
             }
-            throw error;
+            if (requestRef.current?.id === requestId) {
+                setTransportError(error instanceof Error ? error : new Error(String(error)));
+            }
+            onFinish?.(undefined);
+            return undefined;
         }
         finally {
             if (requestRef.current?.id === requestId) {
                 setProcessing(false);
+                setProgress(null);
             }
         }
-    }, [component, data, fixedParams, params, setState, stream]);
-    const reset = useCallback(() => {
-        setDataState(initialData);
-        setErrors({});
-    }, [initialData]);
+    }, [
+        component,
+        data,
+        fixedParams,
+        onError,
+        onFinish,
+        onForbidden,
+        onSuccess,
+        params,
+        recentlySuccessfulDuration,
+        setState,
+        stream,
+        transform
+    ]);
     return useMemo(() => {
         return {
             data,
             setData,
             errors,
+            setError,
+            clearErrors,
             processing,
+            wasSuccessful,
+            recentlySuccessful,
+            progress,
+            transportError,
+            defaults,
+            reset,
+            resetAndClearErrors,
             post: (operation, overrides) => submit("post", operation, overrides),
             put: (operation, overrides) => submit("put", operation, overrides),
             patch: (operation, overrides) => submit("patch", operation, overrides),
-            delete: (operation, overrides) => submit("delete", operation, overrides),
-            reset
+            delete: (operation, overrides) => submit("delete", operation, overrides)
         };
-    }, [data, errors, processing, reset, setData, submit]);
+    }, [
+        clearErrors,
+        data,
+        defaults,
+        errors,
+        processing,
+        progress,
+        recentlySuccessful,
+        reset,
+        resetAndClearErrors,
+        setData,
+        setError,
+        submit,
+        transportError,
+        wasSuccessful
+    ]);
 }
 //# sourceMappingURL=useIslandForm.js.map

package/dist/useIslandForm.js.map

@@ -1 +1 @@
-{"version":3,"file":"useIslandForm.js","sourceRoot":"","sources":["../src/useIslandForm.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAA;AACpD,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAA;AAE9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAA;AAe5C,MAAM,UAAU,aAAa,CAAwC,EACnE,WAAW,EACX,wBAAwB,GAAG,IAAI,EAC/B,WAAW,GAAG,EAAE,EACY;IAC5B,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,gBAAgB,EAAE,CAAA;IAClE,MAAM,CAAC,IAAI,EAAE,YAAY,CAAC,GAAG,QAAQ,CAAQ,WAAW,CAAC,CAAA;IACzD,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,QAAQ,CAA2B,EAAE,CAAC,CAAA;IAClE,MAAM,CAAC,UAAU,EAAE,aAAa,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAA;IAEnD,MAAM,UAAU,GAAG,MAAM,CAAqD,IAAI,CAAC,CAAA;IAEnF,MAAM,OAAO,GAAG,WAAW,CACzB,CAAwB,KAAQ,EAAE,KAAe,EAAE,EAAE;QACnD,YAAY,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;YAC1B,GAAG,QAAQ;YACX,CAAC,KAAK,CAAC,EAAE,KAAK;SACf,CAAC,CAAC,CAAA;QAEH,IAAI,wBAAwB,EAAE,CAAC;YAC7B,SAAS,CAAC,CAAC,QAAQ,EAAE,EAAE;gBACrB,IAAI,CAAC,CAAC,KAAe,IAAI,QAAQ,CAAC,EAAE,CAAC;oBACnC,OAAO,QAAQ,CAAA;gBACjB,CAAC;gBAED,MAAM,IAAI,GAAG,EAAE,GAAG,QAAQ,EAAE,CAAA;gBAC5B,OAAO,IAAI,CAAC,KAAe,CAAC,CAAA;gBAC5B,OAAO,IAAI,CAAA;YACb,CAAC,CAAC,CAAA;QACJ,CAAC;IACH,CAAC,EACD,CAAC,wBAAwB,CAAC,CAC3B,CAAA;IAED,MAAM,MAAM,GAAG,WAAW,CACxB,KAAK,EAAE,MAAkB,EAAE,SAAiB,EAAE,YAA6B,EAAE,EAAE,EAAE;QAC/E,UAAU,CAAC,OAAO,EAAE,UAAU,CAAC,KAAK,EAAE,CAAA;QAEtC,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAA;QACxC,MAAM,SAAS,GAAG,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,IAAI,CAAC,CAAC,GAAG,CAAC,CAAA;QACnD,UAAU,CAAC,OAAO,GAAG,EAAE,EAAE,EAAE,SAAS,EAAE,UAAU,EAAE,CAAA;QAClD,aAAa,CAAC,IAAI,CAAC,CAAA;QAEnB,MAAM,OAAO,GAAG,MAAM,KAAK,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,CAAA;QAEvE,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,WAAW,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE;gBAChE,MAAM,EAAE,UAAU,CAAC,MAAM;gBACzB,WAAW,EAAE;oBACX,GAAG,MAAM;oBACT,GAAG,WAAW;oBACd,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;iBACxC;gBACD,eAAe,EAAE,SAAS,CAAC,OAAO;gBAClC,QAAQ,EAAE,SAAS,CAAC,QAAQ;aAC7B,CAAC,CAAA;YAEF,IAAI,UAAU,CAAC,OAAO,EAAE,EAAE,KAAK,SAAS,EAAE,CAAC;gBACzC,OAAO,QAAQ,CAAA;YACjB,CAAC;YAED,IAAI,QAAQ,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC;gBAC7B,SAAS,CAAC,EAAE,CAAC,CAAA;gBACb,QAAQ,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;oBACtB,KAAK,EAAE,QAAQ,CAAC,KAAK;oBACrB,OAAO,EACL,OAAO,QAAQ,CAAC,OAAO,KAAK,QAAQ,IAAI,QAAQ,CAAC,OAAO,GAAG,QAAQ,CAAC,OAAO;wBACzE,CAAC,CAAC,QAAQ,CAAC,OAAO;wBAClB,CAAC,CAAC,QAAQ,CAAC,OAAO;iBACvB,CAAC,CAAC,CAAA;YACL,CAAC;YAED,IAAI,QAAQ,CAAC,MAAM,KAAK,OAAO,EAAE,CAAC;gBAChC,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAA;YAC5B,CAAC;YAED,IAAI,QAAQ,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;gBACpC,SAAS,CAAC,EAAE,KAAK,EAAE,CAAC,WAAW,CAAC,EAAE,CAAC,CAAA;YACrC,CAAC;YAED,OAAO,QAAQ,CAAA;QACjB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAK,KAAsB,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;gBAClD,OAAO,SAAS,CAAA;YAClB,CAAC;YAED,MAAM,KAAK,CAAA;QACb,CAAC;gBAAS,CAAC;YACT,IAAI,UAAU,CAAC,OAAO,EAAE,EAAE,KAAK,SAAS,EAAE,CAAC;gBACzC,aAAa,CAAC,KAAK,CAAC,CAAA;YACtB,CAAC;QACH,CAAC;IACH,CAAC,EACD,CAAC,SAAS,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,CACzD,CAAA;IAED,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE;QAC7B,YAAY,CAAC,WAAW,CAAC,CAAA;QACzB,SAAS,CAAC,EAAE,CAAC,CAAA;IACf,CAAC,EAAE,CAAC,WAAW,CAAC,CAAC,CAAA;IAEjB,OAAO,OAAO,CAAC,GAAG,EAAE;QAClB,OAAO;YACL,IAAI;YACJ,OAAO;YACP,MAAM;YACN,UAAU;YACV,IAAI,EAAE,CAAC,SAAiB,EAAE,SAA2B,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,EAAE,SAAS,CAAC;YAC9F,GAAG,EAAE,CAAC,SAAiB,EAAE,SAA2B,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,EAAE,SAAS,EAAE,SAAS,CAAC;YAC5F,KAAK,EAAE,CAAC,SAAiB,EAAE,SAA2B,EAAE,EAAE,CACxD,MAAM,CAAC,OAAO,EAAE,SAAS,EAAE,SAAS,CAAC;YACvC,MAAM,EAAE,CAAC,SAAiB,EAAE,SAA2B,EAAE,EAAE,CACzD,MAAM,CAAC,QAAQ,EAAE,SAAS,EAAE,SAAS,CAAC;YACxC,KAAK;SACN,CAAA;IACH,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC,CAAA;AACxD,CAAC"}
+{"version":3,"file":"useIslandForm.js","sourceRoot":"","sources":["../src/useIslandForm.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@archipelago-js/react",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "React bindings for Archipelago islands",
   "license": "MIT",
   "type": "module",
@@ -24,7 +24,7 @@
     "typecheck": "tsc -p tsconfig.json --noEmit"
   },
   "peerDependencies": {
-    "@archipelago-js/client": "^0.1.0",
+    "@archipelago-js/client": "^0.2.0",
     "react": "^19.0.0",
     "react-dom": "^19.0.0"
   },