@fougere/react 0.9.3-alpha.0 → 0.11.0-alpha.0

package/dist/index.d.ts

@@ -1,5 +1,6 @@
 /** `@fougere/react` — the four primitives, in React, for any host that renders it. */
 export { useQuery, useCommand } from './useFougereData.js';
+export { facade, facadeOf } from '@fougere/app/client';
 export { useFormFor, type FormOptions } from './useFormFor.js';
 export { useCurrentUser, FougereSession } from './useCurrentUser.js';
 export { fetcher, CALL_ENDPOINT } from './transport.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,sFAAsF;AACtF,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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,sFAAsF;AACtF,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAE3D,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AACvD,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

@@ -1,6 +1,8 @@
 'use client';
 /** `@fougere/react` — the four primitives, in React, for any host that renders it. */
 export { useQuery, useCommand } from './useFougereData.js';
+// The facade a page names, and the one an entity class names for a form.
+export { facade, facadeOf } from '@fougere/app/client';
 export { useFormFor } from './useFormFor.js';
 export { useCurrentUser, FougereSession } from './useCurrentUser.js';
 export { fetcher, CALL_ENDPOINT } from './transport.js';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AACb,sFAAsF;AACtF,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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AACb,sFAAsF;AACtF,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAC3D,yEAAyE;AACzE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AACvD,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/useFormFor.d.ts

@@ -20,7 +20,7 @@ export declare function useFormFor<T = Record<string, unknown>>(entity: FormEnti
     submit: () => Promise<T | null>;
     loading: boolean;
     /** Non-validation failure of the last submit (unreachable host, conflict…). */
-    error: import("@fougere/core/contract").FougereError | null;
+    error: import("@fougere/core/contract").FougereError<import("@fougere/core/contract").ErrorCode> | null;
     valid: boolean;
 };
 //# sourceMappingURL=useFormFor.d.ts.map

package/dist/useFormFor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useFormFor.d.ts","sourceRoot":"","sources":["../src/useFormFor.ts"],"names":[],"mappings":"AAIA,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;;IA+CjG;;;OAGG;;;qBApC+B,MAAM,SAAS,OAAO;;kBAYrB,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;;IA+BpD,+EAA+E;;;EAIlF"}
+{"version":3,"file":"useFormFor.d.ts","sourceRoot":"","sources":["../src/useFormFor.ts"],"names":[],"mappings":"AAIA,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;;IAiDjG;;;OAGG;;;qBApC+B,MAAM,SAAS,OAAO;;kBAYrB,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;;IA+BpD,+EAA+E;;;EAIlF"}

package/dist/useFormFor.js

@@ -2,7 +2,7 @@
 /** The form contract — state, validation, submission, error mapping. */
 import { useCallback, useMemo, useState } from 'react';
 import { validationErrorsOf } from '@fougere/core/contract';
-import { entityKeyOf, errorsByField, formFieldsOf, payloadOf, } from '@fougere/app/client';
+import { entityKeyOf, errorsByField, facadeOf, formFieldsOf, payloadOf, } from '@fougere/app/client';
 import { useCommand } from './useFougereData.js';
 export function useFormFor(entity, options = {}) {
     const entityKey = entityKeyOf(entity);
@@ -13,7 +13,9 @@ export function useFormFor(entity, options = {}) {
     // 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');
+    // A form is designated by its ENTITY — it is a set of fields — so the facade it submits to is
+    // an address with no handler type behind it, and `T` stays the caller's to state.
+    const command = useCommand(facadeOf(entity), options.op ?? 'create');
     const setValue = useCallback((name, value) => {
         setValues((current) => ({ ...current, [name]: value }));
     }, []);
@@ -28,7 +30,7 @@ export function useFormFor(entity, options = {}) {
         if (!validator())
             return null;
         try {
-            return await command.execute({ params: options.params, input: payloadOf(values) });
+            return (await command.execute({ params: options.params, input: payloadOf(values) }));
         }
         catch (err) {
             const refusals = validationErrorsOf(err);

package/dist/useFormFor.js.map

@@ -1 +1 @@
-{"version":3,"file":"useFormFor.js","sourceRoot":"","sources":["../src/useFormFor.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"useFormFor.js","sourceRoot":"","sources":["../src/useFormFor.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AACb,wEAAwE;AACxE,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AACvD,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EACL,WAAW,EACX,aAAa,EACb,QAAQ,EACR,YAAY,EACZ,SAAS,GAGV,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAWjD,MAAM,UAAU,UAAU,CAA8B,MAAkB,EAAE,OAAO,GAAgB,EAAE;IACnG,MAAM,SAAS,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;IACtC,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,YAAY,CAAC,MAAM,EAAE,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC;IAEnF,mFAAmF;IACnF,mFAAmF;IACnF,iFAAiF;IACjF,+DAA+D;IAC/D,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,QAAQ,CAA0B,GAAG,EAAE,CACjE,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CACxG,CAAC;IACF,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,QAAQ,CAAyB,EAAE,CAAC,CAAC;IACjE,8FAA8F;IAC9F,kFAAkF;IAClF,MAAM,OAAO,GAAG,UAAU,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,EAAE,IAAI,QAAQ,CAAC,CAAC;IAErE,MAAM,QAAQ,GAAG,WAAW,CAAC,CAAC,IAAY,EAAE,KAAc,EAAE,EAAE;QAC5D,SAAS,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,OAAO,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;IAC1D,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,8EAA8E;IAC9E,MAAM,SAAS,GAAG,WAAW,CAAC,GAAY,EAAE;QAC1C,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC;QAClD,SAAS,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;QAC9D,OAAO,MAAM,CAAC,OAAO,CAAC;IACxB,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAErB,uDAAuD;IACvD,MAAM,MAAM,GAAG,WAAW,CAAC,KAAK,IAAuB,EAAE;QACvD,IAAI,CAAC,SAAS,EAAE;YAAE,OAAO,IAAI,CAAC;QAC9B,IAAI,CAAC;YACH,OAAO,CAAC,MAAM,OAAO,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,KAAK,EAAE,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC,CAAM,CAAC;QAC5F,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,QAAQ,GAAG,kBAAkB,CAAC,GAAG,CAAC,CAAC;YACzC,IAAI,QAAQ,EAAE,CAAC;gBACb,SAAS,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC,CAAC;gBACnC,OAAO,IAAI,CAAC;YACd,CAAC;YACD,MAAM,GAAG,CAAC;QACZ,CAAC;IACH,CAAC,EAAE,CAAC,SAAS,EAAE,OAAO,EAAE,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAEjD,MAAM,YAAY,GAAG,OAAO,CAC1B,GAAG,EAAE,CAAC,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAA8B,EACjG,CAAC,MAAM,CAAC,CACT,CAAC;IAEF,OAAO;QACL,MAAM;QACN;;;WAGG;QACH,YAAY;QACZ,MAAM;QACN,QAAQ;QACR,MAAM;QACN,MAAM;QACN,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,+EAA+E;QAC/E,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,KAAK,CAAC;KACxC,CAAC;AACJ,CAAC"}

package/dist/useFougereData.d.ts

@@ -1,19 +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?: {
+import { type CallInput, type Answer, type Refused, type FacadeName, type Rows } from '@fougere/app/client';
+export declare function useQuery<Handler, Address extends string, Op extends keyof Handler & string>(facade: FacadeName<Handler, Address>, op: Op, input?: CallInput, opts?: {
     immediate?: boolean;
 }): {
-    data: T | null;
-    items: T[];
+    data: Answer<Handler, Op> | null;
+    items: Rows<Answer<Handler, Op>>[];
     total: number | undefined;
     hasMore: boolean | undefined;
     loading: boolean;
-    error: FougereError | null;
+    error: FougereError<Refused<Address, Op>> | null;
     refresh: () => Promise<void>;
 };
-export declare function useCommand<T = unknown>(entity: EntityClass, op: string): {
-    execute: (input?: CallInput) => Promise<T>;
+export declare function useCommand<Handler, Address extends string, Op extends keyof Handler & string>(facade: FacadeName<Handler, Address>, op: Op): {
+    execute: (input?: CallInput) => Promise<Answer<Handler, Op>>;
     loading: boolean;
-    error: FougereError | null;
+    error: FougereError<Refused<Address, Op>> | null;
 };
 //# sourceMappingURL=useFougereData.d.ts.map

package/dist/useFougereData.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useFougereData.d.ts","sourceRoot":"","sources":["../src/useFougereData.ts"],"names":[],"mappings":"AAMA,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"}
+{"version":3,"file":"useFougereData.d.ts","sourceRoot":"","sources":["../src/useFougereData.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAWL,KAAK,SAAS,EACd,KAAK,MAAM,EACX,KAAK,OAAO,EACZ,KAAK,UAAU,EACf,KAAK,IAAI,EACV,MAAM,qBAAqB,CAAC;AAG7B,wBAAgB,QAAQ,CACtB,OAAO,EACP,OAAO,SAAS,MAAM,EACtB,EAAE,SAAS,MAAM,OAAO,GAAG,MAAM,EAEjC,MAAM,EAAE,UAAU,CAAC,OAAO,EAAE,OAAO,CAAC,EACpC,EAAE,EAAE,EAAE,EACN,KAAK,CAAC,EAAE,SAAS,EACjB,IAAI,CAAC,EAAE;IAAE,SAAS,CAAC,EAAE,OAAO,CAAA;CAAE;;;;;;;mBAaQ,OAAO,CAAC,IAAI,CAAC;EAiCpD;AAED,wBAAgB,UAAU,CACxB,OAAO,EACP,OAAO,SAAS,MAAM,EACtB,EAAE,SAAS,MAAM,OAAO,GAAG,MAAM,EACjC,MAAM,EAAE,UAAU,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,EAAE,EAAE,EAAE;sBAO3B,SAAS,KAAG,OAAO,qBAAU;;;EAqB/C"}

package/dist/useFougereData.js

@@ -4,10 +4,10 @@
  * to a Frond, in Vue.
  */
 import { useCallback, useEffect, useState } from 'react';
-import { asFougereError, callOf, entityKeyOf, invocationOf, itemsOf, mountedKeys, pageOf, queryKeyOf, sendCall, trackQuery, } from '@fougere/app/client';
+import { asFougereError, callOf, addressOf, 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);
+export function useQuery(facade, op, input, opts) {
+    const entityKey = addressOf(facade);
     // 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);
@@ -19,7 +19,7 @@ export function useQuery(entity, op, input, opts) {
         setLoading(true);
         setError(null);
         try {
-            setData((await sendCall(fetcher, callOf(entity, op), invocationOf(input))));
+            setData((await sendCall(fetcher, callOf(facade, op), invocationOf(input))));
         }
         catch (err) {
             setError(asFougereError(err, entityKey, op));
@@ -50,15 +50,15 @@ export function useQuery(entity, op, input, opts) {
         refresh,
     };
 }
-export function useCommand(entity, op) {
-    const entityKey = entityKeyOf(entity);
+export function useCommand(facade, op) {
+    const entityKey = addressOf(facade);
     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)));
+            const result = (await sendCall(fetcher, callOf(facade, op), invocationOf(input)));
             // The link: same entity designated on both sides → revalidate its queries.
             revalidate(mountedKeys(entityKey));
             return result;

package/dist/useFougereData.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fougere/react",
-  "version": "0.9.3-alpha.0",
+  "version": "0.11.0-alpha.0",
   "description": "Fougere's four primitives as React hooks — host-independent.",
   "keywords": [
     "fougere",
@@ -27,11 +27,12 @@
   },
   "files": [
     "dist",
-    "src"
+    "src",
+    "template"
   ],
   "dependencies": {
-    "@fougere/core": "0.9.3-alpha.0",
-    "@fougere/app": "0.9.3-alpha.0"
+    "@fougere/core": "0.11.0-alpha.0",
+    "@fougere/app": "0.11.0-alpha.0"
   },
   "devDependencies": {
     "@types/react": "^19.2.2",
@@ -40,7 +41,7 @@
     "@testing-library/react": "^16.3.0",
     "jsdom": "^27.0.0",
     "react-dom": "19.2.8",
-    "@fougere/schema": "0.9.3-alpha.0"
+    "@fougere/schema": "0.11.0-alpha.0"
   },
   "peerDependencies": {
     "react": "^18.3.0 || ^19.0.0"

package/src/index.ts

@@ -1,6 +1,8 @@
 'use client';
 /** `@fougere/react` — the four primitives, in React, for any host that renders it. */
 export { useQuery, useCommand } from './useFougereData.js';
+// The facade a page names, and the one an entity class names for a form.
+export { facade, facadeOf } from '@fougere/app/client';
 export { useFormFor, type FormOptions } from './useFormFor.js';
 export { useCurrentUser, FougereSession } from './useCurrentUser.js';
 export { fetcher, CALL_ENDPOINT } from './transport.js';

package/src/useFormFor.ts

@@ -5,9 +5,9 @@ import { validationErrorsOf } from '@fougere/core/contract';
 import {
   entityKeyOf,
   errorsByField,
+  facadeOf,
   formFieldsOf,
   payloadOf,
-  type EntityClass,
   type FormEntity,
   type FormField,
 } from '@fougere/app/client';
@@ -34,7 +34,9 @@ export function useFormFor<T = Record<string, unknown>>(entity: FormEntity, opti
     Object.fromEntries(fields.map((field) => [field.name, options.initial?.[field.name] ?? field.default])),
   );
   const [errors, setErrors] = useState<Record<string, string>>({});
-  const command = useCommand<T>(entity as EntityClass, options.op ?? 'create');
+  // A form is designated by its ENTITY — it is a set of fields — so the facade it submits to is
+  // an address with no handler type behind it, and `T` stays the caller's to state.
+  const command = useCommand(facadeOf(entity), options.op ?? 'create');
 
   const setValue = useCallback((name: string, value: unknown) => {
     setValues((current) => ({ ...current, [name]: value }));
@@ -51,7 +53,7 @@ export function useFormFor<T = Record<string, unknown>>(entity: FormEntity, opti
   const submit = useCallback(async (): Promise<T | null> => {
     if (!validator()) return null;
     try {
-      return await command.execute({ params: options.params, input: payloadOf(values) });
+      return (await command.execute({ params: options.params, input: payloadOf(values) })) as T;
     } catch (err) {
       const refusals = validationErrorsOf(err);
       if (refusals) {

package/src/useFougereData.ts

@@ -8,7 +8,7 @@ import type { FougereError } from '@fougere/core/contract';
 import {
   asFougereError,
   callOf,
-  entityKeyOf,
+  addressOf,
   invocationOf,
   itemsOf,
   mountedKeys,
@@ -17,33 +17,41 @@ import {
   sendCall,
   trackQuery,
   type CallInput,
-  type EntityClass,
+  type Answer,
+  type Refused,
+  type FacadeName,
+  type Rows,
 } from '@fougere/app/client';
 import { fetcher, onRefetch, revalidate } from './transport.js';
 
-export function useQuery<T = Record<string, unknown>>(
-  entity: EntityClass,
-  op: string,
+export function useQuery<
+  Handler,
+  Address extends string,
+  Op extends keyof Handler & string,
+>(
+  facade: FacadeName<Handler, Address>,
+  op: Op,
   input?: CallInput,
   opts?: { immediate?: boolean },
 ) {
-  const entityKey = entityKeyOf(entity);
+  type Answered = Answer<Handler, Op>;
+  const entityKey = addressOf(facade);
   // 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<T | null>(null);
+  const [data, setData] = useState<Answered | null>(null);
   const [loading, setLoading] = useState(immediate);
-  const [error, setError] = useState<FougereError | null>(null);
+  const [error, setError] = useState<FougereError<Refused<Address, Op>> | null>(null);
 
   const refresh = useCallback(async (): Promise<void> => {
     setLoading(true);
     setError(null);
     try {
-      setData((await sendCall(fetcher, callOf(entity, op), invocationOf(input))) as T);
+      setData((await sendCall(fetcher, callOf(facade, op), invocationOf(input))) as Answered);
     } catch (err) {
-      setError(asFougereError(err, entityKey, op));
+      setError(asFougereError(err, entityKey, op) as FougereError<Refused<Address, Op>>);
     } finally {
       setLoading(false);
     }
@@ -63,7 +71,7 @@ export function useQuery<T = Record<string, unknown>>(
 
   return {
     data,
-    items: itemsOf<T>(data),
+    items: itemsOf<Rows<Answered>>(data),
     total: pageOf(data).total,
     hasMore: pageOf(data).hasMore,
     loading,
@@ -72,22 +80,27 @@ export function useQuery<T = Record<string, unknown>>(
   };
 }
 
-export function useCommand<T = unknown>(entity: EntityClass, op: string) {
-  const entityKey = entityKeyOf(entity);
+export function useCommand<
+  Handler,
+  Address extends string,
+  Op extends keyof Handler & string,
+>(facade: FacadeName<Handler, Address>, op: Op) {
+  type Answered = Answer<Handler, Op>;
+  const entityKey = addressOf(facade);
   const [loading, setLoading] = useState(false);
-  const [error, setError] = useState<FougereError | null>(null);
+  const [error, setError] = useState<FougereError<Refused<Address, Op>> | null>(null);
 
   const execute = useCallback(
-    async (input?: CallInput): Promise<T> => {
+    async (input?: CallInput): Promise<Answered> => {
       setLoading(true);
       setError(null);
       try {
-        const result = (await sendCall(fetcher, callOf(entity, op), invocationOf(input))) as T;
+        const result = (await sendCall(fetcher, callOf(facade, op), invocationOf(input))) as Answered;
         // The link: same entity designated on both sides → revalidate its queries.
         revalidate(mountedKeys(entityKey));
         return result;
       } catch (err) {
-        const failure = asFougereError(err, entityKey, op);
+        const failure = asFougereError(err, entityKey, op) as FougereError<Refused<Address, Op>>;
         setError(failure);
         throw failure;
       } finally {

package/template/index.html

@@ -0,0 +1,5 @@
+<!doctype html>
+<html lang="en">
+  <head><meta charset="utf-8" /><title>Fougere</title></head>
+  <body><div id="root"></div><script type="module" src="/src/main.tsx"></script></body>
+</html>

package/template/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "fougere-app",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "vite",
+    "build": "vite build"
+  },
+  "dependencies": {
+    "@fougere/core": "latest",
+    "@fougere/react": "latest",
+    "@fougere/schema": "latest",
+    "@fougere/defaults": "latest",
+    "@fougere/container": "latest",
+    "better-sqlite3": "^13.0.3",
+    "kysely": "^0.28.17",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0"
+  },
+  "devDependencies": {
+    "@fougere/vite": "latest",
+    "@vitejs/plugin-react": "^5.0.0",
+    "vite": "^8.0.0"
+  }
+}

package/template/src/App.tsx

@@ -0,0 +1,21 @@
+import { useQuery } from '@fougere/react';
+// Written by the scan: one export per address, carrying the handler that answers there.
+// Replace `post` with a facade your own frond serves.
+import { post } from '@fronds/facade';
+
+/**
+ * One read. `items` is typed by what the handler's `list` answers, and `error.code` by what
+ * it can refuse — neither is written here, and neither can drift from the handler.
+ */
+export default function App() {
+  const { items, loading, error } = useQuery(post, 'list');
+
+  return (
+    <main style={{ maxWidth: 720, margin: '3rem auto', fontFamily: 'system-ui' }}>
+      <h1>Fougere</h1>
+      {loading && <p>Loading…</p>}
+      {error && <p style={{ color: '#b00' }}>{error.message}</p>}
+      {items.map((row) => <pre key={String(row.id)}>{JSON.stringify(row, null, 2)}</pre>)}
+    </main>
+  );
+}

package/template/src/main.tsx

@@ -0,0 +1,4 @@
+import { createRoot } from 'react-dom/client';
+import App from './App.js';
+
+createRoot(document.getElementById('root')!).render(<App />);

package/template/tsconfig.json

@@ -0,0 +1,21 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "Bundler",
+    "jsx": "react-jsx",
+    "strict": true,
+    "noEmit": true,
+    "types": [
+      "node"
+    ],
+    "paths": {
+      "@fronds/facade": [
+        "./.fougere/facade.generated.ts"
+      ]
+    }
+  },
+  "include": [
+    "src"
+  ]
+}

package/template/vite.config.ts

@@ -0,0 +1,14 @@
+import { defineConfig } from 'vite';
+import { fougere } from '@fougere/vite';
+import react from '@vitejs/plugin-react';
+
+/**
+ * `fougere()` states the two things any Vite-built host must know: the packages a boot loads
+ * at runtime, and a minifier that keeps class names — designation reads a class's `name`, and
+ * a renamed one designates an entity nobody hosts. It also writes `@fronds/facade`.
+ */
+export default defineConfig({
+  // Fronds are shared at the workspace root, two levels up from apps/<name>.
+  root: '.',
+  plugins: [fougere(), react()],
+});