@fougere/react 0.2.0-alpha.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Fougere contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * `@fougere/react` — the four primitives, in React, for any host that renders it.
+ *
+ * It was extracted from `@fougere/next` once a second React host was on the table,
+ * and the extraction was cheap for a measurable reason: the hooks never imported
+ * Next. They reach `@fougere/app/client` and `react`, and talk to the server over
+ * `fetch` on same-origin paths — which is all a React app has in common with
+ * another React app.
+ *
+ * The Vue side has no counterpart on purpose. Nuxt's composables lean on
+ * `useAsyncData`, `useRequestFetch`, `useState` and `refreshNuxtData` — Nuxt's data
+ * layer, not Vue's — so a `@fougere/vue` would have to rebuild what Nuxt gives for
+ * free, and there is no second Vue host asking for it.
+ */
+export { useQuery, useCommand } from './useFougereData.js';
+export { useFormFor, type FormOptions } from './useFormFor.js';
+export { useCurrentUser, FougereSession } from './useCurrentUser.js';
+export { fetcher, CALL_ENDPOINT } from './transport.js';
+export type { CallInput, EntityClass, FormEntity, FormField, SessionView, } from '@fougere/app/client';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA;;;;;;;;;;;;;GAaG;AACH,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAE,KAAK,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC/D,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrE,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAExD,YAAY,EACV,SAAS,EACT,WAAW,EACX,UAAU,EACV,SAAS,EACT,WAAW,GACZ,MAAM,qBAAqB,CAAC"}

package/dist/index.js

@@ -0,0 +1,20 @@
+'use client';
+/**
+ * `@fougere/react` — the four primitives, in React, for any host that renders it.
+ *
+ * It was extracted from `@fougere/next` once a second React host was on the table,
+ * and the extraction was cheap for a measurable reason: the hooks never imported
+ * Next. They reach `@fougere/app/client` and `react`, and talk to the server over
+ * `fetch` on same-origin paths — which is all a React app has in common with
+ * another React app.
+ *
+ * The Vue side has no counterpart on purpose. Nuxt's composables lean on
+ * `useAsyncData`, `useRequestFetch`, `useState` and `refreshNuxtData` — Nuxt's data
+ * layer, not Vue's — so a `@fougere/vue` would have to rebuild what Nuxt gives for
+ * free, and there is no second Vue host asking for it.
+ */
+export { useQuery, useCommand } from './useFougereData.js';
+export { useFormFor } from './useFormFor.js';
+export { useCurrentUser, FougereSession } from './useCurrentUser.js';
+export { fetcher, CALL_ENDPOINT } from './transport.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AACb;;;;;;;;;;;;;GAaG;AACH,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAoB,MAAM,iBAAiB,CAAC;AAC/D,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrE,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/transport.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Kept as a re-export: the fetcher and the revalidation bus started here, and moving
+ * them into `@fougere/app/client` is what a second non-Nuxt client revealed — none
+ * of it was React. This file is the seam that used to hide that.
+ */
+export { fetcher, onRefetch, revalidate, CALL_ENDPOINT } from '@fougere/app/client';
+//# sourceMappingURL=transport.d.ts.map

package/dist/transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../src/transport.ts"],"names":[],"mappings":"AACA;;;;GAIG;AACH,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/transport.js

@@ -0,0 +1,8 @@
+'use client';
+/**
+ * Kept as a re-export: the fetcher and the revalidation bus started here, and moving
+ * them into `@fougere/app/client` is what a second non-Nuxt client revealed — none
+ * of it was React. This file is the seam that used to hide that.
+ */
+export { fetcher, onRefetch, revalidate, CALL_ENDPOINT } from '@fougere/app/client';
+//# sourceMappingURL=transport.js.map

package/dist/transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.js","sourceRoot":"","sources":["../src/transport.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AACb;;;;GAIG;AACH,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/useCurrentUser.d.ts

@@ -0,0 +1,24 @@
+/**
+ * The session: resolved once server-side, handed down through the provider, read
+ * here as state. `refresh()` re-reads it after a client-side auth change (login,
+ * logout) — no page reload, no hand-rolled /api/me.
+ *
+ * `session` is the whole view (extensible context); `user` is its everyday
+ * projection. Nuxt hydrates through its own `useState` payload; React has no
+ * ambient equivalent, so a layout that already resolved the session passes it to
+ * `<FougereSession>` and the page arrives knowing its user. Without the provider
+ * the hook fetches once, which is correct and one round-trip slower.
+ */
+import { type ReactNode } from 'react';
+import type { SessionView } from '@fougere/app/client';
+export declare function FougereSession({ value, children }: {
+    value: SessionView;
+    children: ReactNode;
+}): import("react").FunctionComponentElement<import("react").ProviderProps<SessionView | null>>;
+export declare function useCurrentUser<TUser = Record<string, unknown>>(): {
+    session: SessionView;
+    user: TUser | null;
+    loggedIn: boolean;
+    refresh: () => Promise<void>;
+};
+//# sourceMappingURL=useCurrentUser.d.ts.map

package/dist/useCurrentUser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCurrentUser.d.ts","sourceRoot":"","sources":["../src/useCurrentUser.ts"],"names":[],"mappings":"AACA;;;;;;;;;;GAUG;AACH,OAAO,EAA8E,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AACnH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAIvD,wBAAgB,cAAc,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE;IAAE,KAAK,EAAE,WAAW,CAAC;IAAC,QAAQ,EAAE,SAAS,CAAA;CAAE,+FAE9F;AAED,wBAAgB,cAAc,CAAC,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;UAe1B,KAAK,GAAG,IAAI;;mBAXR,OAAO,CAAC,IAAI,CAAC;EAepD"}

package/dist/useCurrentUser.js

@@ -0,0 +1,36 @@
+'use client';
+/**
+ * The session: resolved once server-side, handed down through the provider, read
+ * here as state. `refresh()` re-reads it after a client-side auth change (login,
+ * logout) — no page reload, no hand-rolled /api/me.
+ *
+ * `session` is the whole view (extensible context); `user` is its everyday
+ * projection. Nuxt hydrates through its own `useState` payload; React has no
+ * ambient equivalent, so a layout that already resolved the session passes it to
+ * `<FougereSession>` and the page arrives knowing its user. Without the provider
+ * the hook fetches once, which is correct and one round-trip slower.
+ */
+import { createContext, createElement, useCallback, useContext, useEffect, useState } from 'react';
+const SessionContext = createContext(null);
+export function FougereSession({ value, children }) {
+    return createElement(SessionContext.Provider, { value }, children);
+}
+export function useCurrentUser() {
+    const hydrated = useContext(SessionContext);
+    const [session, setSession] = useState(hydrated ?? { user: null });
+    const refresh = useCallback(async () => {
+        const response = await fetch('/_fougere/session');
+        setSession((await response.json()));
+    }, []);
+    useEffect(() => {
+        if (!hydrated)
+            void refresh();
+    }, [hydrated, refresh]);
+    return {
+        session,
+        user: (session.user ?? null),
+        loggedIn: session.user != null,
+        refresh,
+    };
+}
+//# sourceMappingURL=useCurrentUser.js.map

package/dist/useCurrentUser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCurrentUser.js","sourceRoot":"","sources":["../src/useCurrentUser.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AACb;;;;;;;;;;GAUG;AACH,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,WAAW,EAAE,UAAU,EAAE,SAAS,EAAE,QAAQ,EAAkB,MAAM,OAAO,CAAC;AAGnH,MAAM,cAAc,GAAG,aAAa,CAAqB,IAAI,CAAC,CAAC;AAE/D,MAAM,UAAU,cAAc,CAAC,EAAE,KAAK,EAAE,QAAQ,EAA+C;IAC7F,OAAO,aAAa,CAAC,cAAc,CAAC,QAAQ,EAAE,EAAE,KAAK,EAAE,EAAE,QAAQ,CAAC,CAAC;AACrE,CAAC;AAED,MAAM,UAAU,cAAc;IAC5B,MAAM,QAAQ,GAAG,UAAU,CAAC,cAAc,CAAC,CAAC;IAC5C,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,QAAQ,CAAc,QAAQ,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IAEhF,MAAM,OAAO,GAAG,WAAW,CAAC,KAAK,IAAmB,EAAE;QACpD,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,mBAAmB,CAAC,CAAC;QAClD,UAAU,CAAC,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAgB,CAAC,CAAC;IACrD,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,QAAQ;YAAE,KAAK,OAAO,EAAE,CAAC;IAChC,CAAC,EAAE,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC;IAExB,OAAO;QACL,OAAO;QACP,IAAI,EAAE,CAAC,OAAO,CAAC,IAAI,IAAI,IAAI,CAAiB;QAC5C,QAAQ,EAAE,OAAO,CAAC,IAAI,IAAI,IAAI;QAC9B,OAAO;KACR,CAAC;AACJ,CAAC"}

package/dist/useFormFor.d.ts

@@ -0,0 +1,29 @@
+import { FougereError } from '@fougere/core/contract';
+import { type FormEntity, type FormField } from '@fougere/app/client';
+export interface FormOptions {
+    /** Command the submit rides. Default: 'create'. */
+    op?: string;
+    /** Initial values (edit mode: the loaded entity). */
+    initial?: Record<string, unknown>;
+    /** Call params designating the target (edit mode: { id }). */
+    params?: Record<string, string>;
+}
+export declare function useFormFor<T = Record<string, unknown>>(entity: FormEntity, options?: FormOptions): {
+    fields: FormField[];
+    /**
+     * The same fields, keyed by name — a form that lays its inputs out by hand binds
+     * one at a time (`{...fieldsByName.email.attrs}`) and still states no rule of its
+     * own. Without it, a page retypes `type="email"` next to a card that already says
+     * `format: 'email'`, and the browser enforces the page rather than the declaration.
+     */
+    fieldsByName: Record<string, FormField>;
+    values: Record<string, unknown>;
+    setValue: (name: string, value: unknown) => void;
+    errors: Record<string, string>;
+    submit: () => Promise<T | null>;
+    loading: boolean;
+    /** Non-validation failure of the last submit (unreachable host, conflict…). */
+    error: FougereError | null;
+    valid: boolean;
+};
+//# sourceMappingURL=useFormFor.d.ts.map

package/dist/useFormFor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFormFor.d.ts","sourceRoot":"","sources":["../src/useFormFor.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAE,YAAY,EAAa,MAAM,wBAAwB,CAAC;AACjE,OAAO,EAML,KAAK,UAAU,EACf,KAAK,SAAS,EACf,MAAM,qBAAqB,CAAC;AAG7B,MAAM,WAAW,WAAW;IAC1B,mDAAmD;IACnD,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,qDAAqD;IACrD,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,8DAA8D;IAC9D,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACjC;AAED,wBAAgB,UAAU,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,GAAE,WAAgB;;IAkDjG;;;;;OAKG;;;qBAzC+B,MAAM,SAAS,OAAO;;kBAgBrB,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;;IAgCpD,+EAA+E;;;EAIlF"}

package/dist/useFormFor.js

@@ -0,0 +1,78 @@
+'use client';
+/**
+ * The form contract — state, validation, submission, error mapping. Never a
+ * widget: the page owns the rendering, this owns the mechanics.
+ *
+ * The cycle composes the other primitives: fields from the io axes, local
+ * pre-judgment with the same rules the handler enforces (one declaration, both
+ * sides), submission through the command (so the entity link revalidates mounted
+ * queries), and per-field errors in the same `{ path, message }` shape whoever
+ * judged.
+ *
+ * One visible difference from the Vue composable, and it is React's, not ours:
+ * Vue hands back a reactive object a template mutates in place, React state is
+ * replaced rather than mutated, so `setValue` is part of the contract here.
+ */
+import { useCallback, useMemo, useState } from 'react';
+import { FougereError, ErrorCode } from '@fougere/core/contract';
+import { entityKeyOf, errorsByField, formFieldsOf, payloadOf, } from '@fougere/app/client';
+import { useCommand } from './useFougereData.js';
+export function useFormFor(entity, options = {}) {
+    const entityKey = entityKeyOf(entity);
+    const fields = useMemo(() => formFieldsOf(entity, entityKey), [entity, entityKey]);
+    // `initial` wins over the declared default: editing a row shows the row, including
+    // a value the author deliberately changed away from that default. On a create form
+    // there is no `initial`, so the field opens on what is about to be written — the
+    // schema's own literal, shown rather than guessed by the page.
+    const [values, setValues] = useState(() => Object.fromEntries(fields.map((field) => [field.name, options.initial?.[field.name] ?? field.default])));
+    const [errors, setErrors] = useState({});
+    const command = useCommand(entity, options.op ?? 'create');
+    const setValue = useCallback((name, value) => {
+        setValues((current) => ({ ...current, [name]: value }));
+    }, []);
+    /** Local pre-judgment — same rules as the handler, saves a lost round-trip. */
+    const judge = useCallback(() => {
+        const result = entity.validate(payloadOf(values));
+        setErrors(result.success ? {} : errorsByField(result.errors));
+        return result.success;
+    }, [entity, values]);
+    /**
+     * Judge locally, then send through the command. Returns the created/updated value,
+     * or null when a judge (either side) rejected — the errors land per field either
+     * way, the form never knows who judged.
+     */
+    const submit = useCallback(async () => {
+        if (!judge())
+            return null;
+        try {
+            return await command.execute({ params: options.params, body: payloadOf(values) });
+        }
+        catch (err) {
+            if (err instanceof FougereError && err.code === ErrorCode.VALIDATION_FAILED && Array.isArray(err.details)) {
+                setErrors(errorsByField(err.details));
+                return null;
+            }
+            throw err;
+        }
+    }, [judge, command, options.params, values]);
+    const fieldsByName = useMemo(() => Object.fromEntries(fields.map((field) => [field.name, field])), [fields]);
+    return {
+        fields,
+        /**
+         * The same fields, keyed by name — a form that lays its inputs out by hand binds
+         * one at a time (`{...fieldsByName.email.attrs}`) and still states no rule of its
+         * own. Without it, a page retypes `type="email"` next to a card that already says
+         * `format: 'email'`, and the browser enforces the page rather than the declaration.
+         */
+        fieldsByName,
+        values,
+        setValue,
+        errors,
+        submit,
+        loading: command.loading,
+        /** Non-validation failure of the last submit (unreachable host, conflict…). */
+        error: command.error,
+        valid: Object.keys(errors).length === 0,
+    };
+}
+//# sourceMappingURL=useFormFor.js.map

package/dist/useFormFor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFormFor.js","sourceRoot":"","sources":["../src/useFormFor.ts"],"names":[],"mappings":"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"}

package/dist/useFougereData.d.ts

@@ -0,0 +1,19 @@
+import type { FougereError } from '@fougere/core/contract';
+import { type CallInput, type EntityClass } from '@fougere/app/client';
+export declare function useQuery<T = Record<string, unknown>>(entity: EntityClass, op: string, input?: CallInput, opts?: {
+    immediate?: boolean;
+}): {
+    data: T | null;
+    items: T[];
+    total: number | undefined;
+    hasMore: boolean | undefined;
+    loading: boolean;
+    error: FougereError | null;
+    refresh: () => Promise<void>;
+};
+export declare function useCommand<T = unknown>(entity: EntityClass, op: string): {
+    execute: (input?: CallInput) => Promise<T>;
+    loading: boolean;
+    error: FougereError | null;
+};
+//# sourceMappingURL=useFougereData.d.ts.map

package/dist/useFougereData.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFougereData.d.ts","sourceRoot":"","sources":["../src/useFougereData.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAWL,KAAK,SAAS,EACd,KAAK,WAAW,EACjB,MAAM,qBAAqB,CAAC;AAG7B,wBAAgB,QAAQ,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAClD,MAAM,EAAE,WAAW,EACnB,EAAE,EAAE,MAAM,EACV,KAAK,CAAC,EAAE,SAAS,EACjB,IAAI,CAAC,EAAE;IAAE,SAAS,CAAC,EAAE,OAAO,CAAA;CAAE;;;;;;;mBAYQ,OAAO,CAAC,IAAI,CAAC;EAiCpD;AAED,wBAAgB,UAAU,CAAC,CAAC,GAAG,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,EAAE,EAAE,MAAM;sBAMpD,SAAS,KAAG,OAAO,CAAC,CAAC,CAAC;;;EAqBxC"}

package/dist/useFougereData.js

@@ -0,0 +1,85 @@
+'use client';
+/**
+ * The couple — useQuery (reads) and useCommand (writes), the two dual gestures of
+ * a page talking to a Frond, in React.
+ *
+ * What the gestures ARE lives in `@fougere/app/client` and is shared with Vue:
+ * designation is class + verb, the cache key derives from designation plus input,
+ * and a successful command on an entity revalidates every mounted query on that
+ * entity. Nothing of that is restated here — this file is `useState` for the
+ * values, `useEffect` for the mount, and the bus in `transport.ts` where Nuxt
+ * calls `refreshNuxtData`.
+ */
+import { useCallback, useEffect, useState } from 'react';
+import { asFougereError, callOf, entityKeyOf, invocationOf, itemsOf, mountedKeys, pageOf, queryKeyOf, sendCall, trackQuery, } from '@fougere/app/client';
+import { fetcher, onRefetch, revalidate } from './transport.js';
+export function useQuery(entity, op, input, opts) {
+    const entityKey = entityKeyOf(entity);
+    // The key IS the dependency: an input literal is a new object on every render, so
+    // depending on it directly would refetch forever. Its serialization is stable.
+    const key = queryKeyOf(entityKey, op, input);
+    const immediate = opts?.immediate !== false;
+    const [data, setData] = useState(null);
+    const [loading, setLoading] = useState(immediate);
+    const [error, setError] = useState(null);
+    const refresh = useCallback(async () => {
+        setLoading(true);
+        setError(null);
+        try {
+            setData((await sendCall(fetcher, callOf(entity, op), invocationOf(input))));
+        }
+        catch (err) {
+            setError(asFougereError(err, entityKey, op));
+        }
+        finally {
+            setLoading(false);
+        }
+        // `key` stands for (entity, op, input) — see above.
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [key]);
+    useEffect(() => {
+        const untrack = trackQuery(entityKey, key);
+        const off = onRefetch(key, () => void refresh());
+        if (immediate)
+            void refresh();
+        return () => {
+            untrack();
+            off();
+        };
+    }, [entityKey, key, immediate, refresh]);
+    return {
+        data,
+        items: itemsOf(data),
+        total: pageOf(data).total,
+        hasMore: pageOf(data).hasMore,
+        loading,
+        error,
+        refresh,
+    };
+}
+export function useCommand(entity, op) {
+    const entityKey = entityKeyOf(entity);
+    const [loading, setLoading] = useState(false);
+    const [error, setError] = useState(null);
+    const execute = useCallback(async (input) => {
+        setLoading(true);
+        setError(null);
+        try {
+            const result = (await sendCall(fetcher, callOf(entity, op), invocationOf(input)));
+            // The link: same entity designated on both sides → revalidate its queries.
+            revalidate(mountedKeys(entityKey));
+            return result;
+        }
+        catch (err) {
+            const failure = asFougereError(err, entityKey, op);
+            setError(failure);
+            throw failure;
+        }
+        finally {
+            setLoading(false);
+        }
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [entityKey, op]);
+    return { execute, loading, error };
+}
+//# sourceMappingURL=useFougereData.js.map

package/dist/useFougereData.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFougereData.js","sourceRoot":"","sources":["../src/useFougereData.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@fougere/react",
+  "version": "0.2.0-alpha.0",
+  "description": "Fougere's four primitives as React hooks — host-independent.",
+  "keywords": [
+    "fougere",
+    "react",
+    "hooks",
+    "typescript",
+    "fullstack",
+    "rpc"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/chok/fougere.git",
+    "directory": "packages/app/react"
+  },
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@fougere/app": "0.2.0-alpha.0",
+    "@fougere/core": "0.2.0-alpha.0"
+  },
+  "devDependencies": {
+    "@types/react": "^19.2.2",
+    "react": "19.2.8",
+    "vitest": "^4.1.0",
+    "@testing-library/react": "^16.3.0",
+    "jsdom": "^27.0.0",
+    "react-dom": "19.2.8",
+    "@fougere/schema": "0.2.0-alpha.0"
+  },
+  "peerDependencies": {
+    "react": "^18.3.0 || ^19.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "rm -rf dist && tsc",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit -p tsconfig.test.json"
+  }
+}