@fougere/svelte 0.16.0-alpha.0 → 0.16.3-alpha.0

package/dist/useFormFor.d.ts

@@ -1,6 +1,6 @@
 /** The form contract — state, validation, submission, error mapping. */
 import { type Readable, type Writable } from 'svelte/store';
-import { type FormEntity, type FormField } from '@fougere/app/client';
+import { type FormEntity, type FormField, type FormFieldName, type FormRow } from '@fougere/app/client';
 export interface FormOptions {
     /** Command the submit rides. Default: 'create'. */
     op?: string;
@@ -9,14 +9,14 @@ export interface FormOptions {
     /** 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[];
+export declare function useFormFor<E extends FormEntity>(entity: E, options?: FormOptions): {
+    fields: FormField<FormFieldName<E>>[];
     /** The same fields, keyed by name — spread `fieldsByName.email.attrs` on an input
      *  and the page states no rule of its own. */
-    fieldsByName: Record<string, FormField>;
-    values: Writable<Record<string, unknown>>;
-    errors: Writable<Record<string, string>>;
-    submit: () => Promise<T | null>;
+    fieldsByName: Partial<Record<FormFieldName<E>, FormField<FormFieldName<E>>>>;
+    values: Writable<Partial<FormRow<E>>>;
+    errors: Writable<Partial<Record<FormFieldName<E>, string>>>;
+    submit: () => Promise<FormRow<E> | null>;
     validator: () => boolean;
     valid: Readable<boolean>;
     /** `{ loading, error }` of the underlying command. */

package/dist/useFormFor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useFormFor.d.ts","sourceRoot":"","sources":["../src/useFormFor.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,OAAO,EAA0B,KAAK,QAAQ,EAAE,KAAK,QAAQ,EAAE,MAAM,cAAc,CAAC;AAEpF,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;;IAyCjG;kDAC8C;kBACkC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC;;;kBArBlF,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;qBAPpB,OAAO;;IAkC3B,sDAAsD;;EAGzD"}
+{"version":3,"file":"useFormFor.d.ts","sourceRoot":"","sources":["../src/useFormFor.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,OAAO,EAA0B,KAAK,QAAQ,EAAE,KAAK,QAAQ,EAAE,MAAM,cAAc,CAAC;AAEpF,OAAO,EAML,KAAK,UAAU,EAEf,KAAK,SAAS,EACd,KAAK,aAAa,EAClB,KAAK,OAAO,EAEb,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,SAAS,UAAU,EAAE,MAAM,EAAE,CAAC,EAAE,OAAO,GAAE,WAAgB;;IAoCjF;kDAC8C;kBACkC,OAAO,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,SAAS,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;;;kBAhBvH,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;qBAP7B,OAAO;;IA6B3B,sDAAsD;;EAGzD"}

package/dist/useFormFor.js

@@ -11,7 +11,7 @@ export function useFormFor(entity, options = {}) {
     const values = writable(Object.fromEntries(fields.map((field) => [field.name, options.initial?.[field.name] ?? field.default])));
     const errors = writable({});
     // 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.
+    // an address with no handler type behind it, and what it answers is the entity's row.
     const command = useCommand(facadeOf(entity), options.op ?? 'create');
     /** Local pre-verdict — same rules as the handler, saves a lost round-trip. */
     function validator() {
@@ -22,17 +22,12 @@ export function useFormFor(entity, options = {}) {
     async function submit() {
         if (!validator())
             return null;
-        try {
-            return (await command.execute({ params: options.params, input: payloadOf(entity, get(values)) }));
-        }
-        catch (err) {
-            const refusals = validationErrorsOf(err);
-            if (refusals) {
-                errors.set(errorsByField(refusals));
-                return null;
-            }
-            throw err;
-        }
+        const answer = await command.execute({ params: options.params, input: payloadOf(entity, get(values)) });
+        const failure = get(command).error;
+        const refusals = failure && validationErrorsOf(failure);
+        if (refusals)
+            errors.set(errorsByField(refusals));
+        return answer;
     }
     const valid = derived(errors, ($errors) => Object.keys($errors).length === 0);
     return {

package/dist/useFormFor.js.map

@@ -1 +1 @@
-{"version":3,"file":"useFormFor.js","sourceRoot":"","sources":["../src/useFormFor.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,EAAgC,MAAM,cAAc,CAAC;AACpF,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EACL,WAAW,EACX,QAAQ,EACR,aAAa,EACb,YAAY,EACZ,SAAS,GAGV,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AAW9D,MAAM,UAAU,UAAU,CAA8B,MAAkB,EAAE,OAAO,GAAgB,EAAE;IACnG,MAAM,SAAS,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;IACtC,MAAM,MAAM,GAAgB,YAAY,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAE5D,8EAA8E;IAC9E,gFAAgF;IAChF,MAAM,MAAM,GAAsC,QAAQ,CACxD,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,MAAM,GAAG,QAAQ,CAAyB,EAAE,CAAC,CAAC;IACpD,8FAA8F;IAC9F,kFAAkF;IAClF,MAAM,OAAO,GAAG,UAAU,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,EAAE,IAAI,QAAQ,CAAC,CAAC;IAErE,8EAA8E;IAC9E,SAAS,SAAS;QAChB,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QAC/D,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;QAE/D,OAAO,MAAM,CAAC,OAAO,CAAC;IACxB,CAAC;IAED,KAAK,UAAU,MAAM;QACnB,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,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAM,CAAC;QACzG,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,QAAQ,GAAG,kBAAkB,CAAC,GAAG,CAAC,CAAC;YACzC,IAAI,QAAQ,EAAE,CAAC;gBACb,MAAM,CAAC,GAAG,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC,CAAC;gBAEpC,OAAO,IAAI,CAAC;YACd,CAAC;YACD,MAAM,GAAG,CAAC;QACZ,CAAC;IACH,CAAC;IAED,MAAM,KAAK,GAAsB,OAAO,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC;IAEjG,OAAO;QACL,MAAM;QACN;sDAC8C;QAC9C,YAAY,EAAE,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAA8B;QACzG,MAAM;QACN,MAAM;QACN,MAAM;QACN,SAAS;QACT,KAAK;QACL,sDAAsD;QACtD,OAAO;KACR,CAAC;AACJ,CAAC"}
+{"version":3,"file":"useFormFor.js","sourceRoot":"","sources":["../src/useFormFor.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,EAAgC,MAAM,cAAc,CAAC;AACpF,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EACL,WAAW,EACX,QAAQ,EACR,aAAa,EACb,YAAY,EACZ,SAAS,GAOV,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AAW9D,MAAM,UAAU,UAAU,CAAuB,MAAS,EAAE,OAAO,GAAgB,EAAE;IACnF,MAAM,SAAS,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;IACtC,MAAM,MAAM,GAAG,YAAY,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAE/C,8EAA8E;IAC9E,gFAAgF;IAChF,MAAM,MAAM,GAA4B,QAAQ,CAC9C,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,CAAkB,CACzH,CAAC;IACF,MAAM,MAAM,GAAG,QAAQ,CAAgB,EAAE,CAAC,CAAC;IAC3C,8FAA8F;IAC9F,sFAAsF;IACtF,MAAM,OAAO,GAAG,UAAU,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,EAAE,IAAI,QAAQ,CAAC,CAAC;IAErE,8EAA8E;IAC9E,SAAS,SAAS;QAChB,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QAC/D,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,aAAa,CAAI,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;QAElE,OAAO,MAAM,CAAC,OAAO,CAAC;IACxB,CAAC;IAED,KAAK,UAAU,MAAM;QACnB,IAAI,CAAC,SAAS,EAAE;YAAE,OAAO,IAAI,CAAC;QAC9B,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,KAAK,EAAE,SAAS,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC;QACxG,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC;QACnC,MAAM,QAAQ,GAAG,OAAO,IAAI,kBAAkB,CAAC,OAAO,CAAC,CAAC;QACxD,IAAI,QAAQ;YAAE,MAAM,CAAC,GAAG,CAAC,aAAa,CAAI,QAAQ,CAAC,CAAC,CAAC;QAErD,OAAO,MAA2B,CAAC;IACrC,CAAC;IAED,MAAM,KAAK,GAAsB,OAAO,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC;IAEjG,OAAO;QACL,MAAM;QACN;sDAC8C;QAC9C,YAAY,EAAE,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAmE;QAC9I,MAAM;QACN,MAAM;QACN,MAAM;QACN,SAAS;QACT,KAAK;QACL,sDAAsD;QACtD,OAAO;KACR,CAAC;AACJ,CAAC"}

package/dist/useFougereData/CommandStore.d.ts

@@ -5,7 +5,8 @@ export interface CommandStore<T, Refused extends ErrorCode = ErrorCode> extends
     loading: boolean;
     error: FougereError<Refused> | null;
 }> {
-    execute(input?: CallInput): Promise<T>;
+    /** The answer, or `null` when the call was refused — the refusal is in `error`, and nothing is thrown. */
+    execute(input?: CallInput): Promise<T | null>;
 }
 export declare function useCommand<Handler, Address extends string, Op extends keyof Handler & string>(facade: FacadeName<Handler, Address>, op: Op): CommandStore<Answer<Handler, Op>, Refused<Address, Op>>;
 /** Read a store's current value without subscribing — used by `useFormFor`. */

package/dist/useFougereData/CommandStore.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CommandStore.d.ts","sourceRoot":"","sources":["../../src/useFougereData/CommandStore.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,GAAG,EAAE,KAAK,QAAQ,EAAE,MAAM,cAAc,CAAC;AAC5D,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtE,OAAO,EAA+F,KAAK,SAAS,EAAE,KAAK,MAAM,EAAE,KAAK,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAE9L,MAAM,WAAW,YAAY,CAAC,CAAC,EAAE,OAAO,SAAS,SAAS,GAAG,SAAS,CACpE,SAAQ,QAAQ,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,YAAY,CAAC,OAAO,CAAC,GAAG,IAAI,CAAA;CAAE,CAAC;IAC3E,OAAO,CAAC,KAAK,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;CACxC;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,GAAG,YAAY,CAAC,MAAM,CAAC,OAAO,EAAE,EAAE,CAAC,EAAE,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAsBvG;AAED,+EAA+E;AAC/E,OAAO,EAAE,GAAG,EAAE,CAAC"}
+{"version":3,"file":"CommandStore.d.ts","sourceRoot":"","sources":["../../src/useFougereData/CommandStore.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,GAAG,EAAE,KAAK,QAAQ,EAAE,MAAM,cAAc,CAAC;AAC5D,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtE,OAAO,EAA+F,KAAK,SAAS,EAAE,KAAK,MAAM,EAAE,KAAK,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAE9L,MAAM,WAAW,YAAY,CAAC,CAAC,EAAE,OAAO,SAAS,SAAS,GAAG,SAAS,CACpE,SAAQ,QAAQ,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,YAAY,CAAC,OAAO,CAAC,GAAG,IAAI,CAAA;CAAE,CAAC;IAC3E,0GAA0G;IAC1G,OAAO,CAAC,KAAK,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;CAC/C;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,GAAG,YAAY,CAAC,MAAM,CAAC,OAAO,EAAE,EAAE,CAAC,EAAE,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAuBvG;AAED,+EAA+E;AAC/E,OAAO,EAAE,GAAG,EAAE,CAAC"}

package/dist/useFougereData/CommandStore.js

@@ -17,7 +17,7 @@ export function useCommand(facade, op) {
             catch (err) {
                 const failure = asFougereError(err, entityKey, op);
                 store.set({ loading: false, error: failure });
-                throw failure;
+                return null;
             }
         },
     };

package/dist/useFougereData/CommandStore.js.map

@@ -1 +1 @@
-{"version":3,"file":"CommandStore.js","sourceRoot":"","sources":["../../src/useFougereData/CommandStore.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,GAAG,EAAiB,MAAM,cAAc,CAAC;AAE5D,OAAO,EAAE,cAAc,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,QAAQ,EAA8D,MAAM,qBAAqB,CAAC;AAO9L,MAAM,UAAU,UAAU,CAIxB,MAAoC,EAAE,EAAM;IAC5C,MAAM,SAAS,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC;IACpC,MAAM,KAAK,GAAG,QAAQ,CAAmD,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAE1G,OAAO;QACL,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,KAAK,CAAC,OAAO,CAAC,KAAiB;YAC7B,KAAK,CAAC,GAAG,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;YAC1C,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,CAAC,MAAM,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC,EAAE,YAAY,CAAC,KAAK,CAAC,CAAC,CAAwB,CAAC;gBACzG,2EAA2E;gBAC3E,UAAU,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC,CAAC;gBACnC,KAAK,CAAC,GAAG,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;gBAE3C,OAAO,MAAM,CAAC;YAChB,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,MAAM,OAAO,GAAG,cAAc,CAAC,GAAG,EAAE,SAAS,EAAE,EAAE,CAAC,CAAC;gBACnD,KAAK,CAAC,GAAG,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;gBAC9C,MAAM,OAAO,CAAC;YAChB,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC;AAED,+EAA+E;AAC/E,OAAO,EAAE,GAAG,EAAE,CAAC"}
+{"version":3,"file":"CommandStore.js","sourceRoot":"","sources":["../../src/useFougereData/CommandStore.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,GAAG,EAAiB,MAAM,cAAc,CAAC;AAE5D,OAAO,EAAE,cAAc,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,QAAQ,EAA8D,MAAM,qBAAqB,CAAC;AAQ9L,MAAM,UAAU,UAAU,CAIxB,MAAoC,EAAE,EAAM;IAC5C,MAAM,SAAS,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC;IACpC,MAAM,KAAK,GAAG,QAAQ,CAAmD,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAE1G,OAAO;QACL,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,KAAK,CAAC,OAAO,CAAC,KAAiB;YAC7B,KAAK,CAAC,GAAG,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;YAC1C,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,CAAC,MAAM,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC,EAAE,YAAY,CAAC,KAAK,CAAC,CAAC,CAAwB,CAAC;gBACzG,2EAA2E;gBAC3E,UAAU,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC,CAAC;gBACnC,KAAK,CAAC,GAAG,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;gBAE3C,OAAO,MAAM,CAAC;YAChB,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,MAAM,OAAO,GAAG,cAAc,CAAC,GAAG,EAAE,SAAS,EAAE,EAAE,CAAC,CAAC;gBACnD,KAAK,CAAC,GAAG,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;gBAE9C,OAAO,IAAI,CAAC;YACd,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC;AAED,+EAA+E;AAC/E,OAAO,EAAE,GAAG,EAAE,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fougere/svelte",
-  "version": "0.16.0-alpha.0",
+  "version": "0.16.3-alpha.0",
   "description": "Fougere's four primitives as Svelte stores — host-independent.",
   "keywords": [
     "fougere",
@@ -31,13 +31,13 @@
     "template"
   ],
   "dependencies": {
-    "@fougere/app": "0.16.0-alpha.0",
-    "@fougere/core": "0.16.0-alpha.0"
+    "@fougere/app": "0.16.3-alpha.0",
+    "@fougere/core": "0.16.3-alpha.0"
   },
   "devDependencies": {
     "svelte": "^5.53.4",
     "vitest": "^4.1.0",
-    "@fougere/schema": "0.16.0-alpha.0"
+    "@fougere/schema": "0.16.3-alpha.0"
   },
   "peerDependencies": {
     "svelte": "^5.0.0"

package/src/useFormFor.ts

@@ -8,7 +8,11 @@ import {
   formFieldsOf,
   payloadOf,
   type FormEntity,
+  type FormErrors,
   type FormField,
+  type FormFieldName,
+  type FormRow,
+  type FormValues,
 } from '@fougere/app/client';
 import { useCommand } from './useFougereData/CommandStore.js';
 
@@ -21,41 +25,36 @@ export interface FormOptions {
   params?: Record<string, string>;
 }
 
-export function useFormFor<T = Record<string, unknown>>(entity: FormEntity, options: FormOptions = {}) {
+export function useFormFor<E extends FormEntity>(entity: E, options: FormOptions = {}) {
   const entityKey = entityKeyOf(entity);
-  const fields: FormField[] = formFieldsOf(entity, entityKey);
+  const fields = formFieldsOf(entity, entityKey);
 
   // `initial` wins over the declared default: editing a row shows the row. On a
   // create form there is none, so the field opens on what is about to be written.
-  const values: Writable<Record<string, unknown>> = writable(
-    Object.fromEntries(fields.map((field) => [field.name, options.initial?.[field.name] ?? field.default])),
+  const values: Writable<FormValues<E>> = writable(
+    Object.fromEntries(fields.map((field) => [field.name, options.initial?.[field.name] ?? field.default])) as FormValues<E>,
   );
-  const errors = writable<Record<string, string>>({});
+  const errors = writable<FormErrors<E>>({});
   // 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.
+  // an address with no handler type behind it, and what it answers is the entity's row.
   const command = useCommand(facadeOf(entity), options.op ?? 'create');
 
   /** Local pre-verdict — same rules as the handler, saves a lost round-trip. */
   function validator(): boolean {
     const result = entity.validate(payloadOf(entity, get(values)));
-    errors.set(result.success ? {} : errorsByField(result.errors));
+    errors.set(result.success ? {} : errorsByField<E>(result.errors));
 
     return result.success;
   }
 
-  async function submit(): Promise<T | null> {
+  async function submit(): Promise<FormRow<E> | null> {
     if (!validator()) return null;
-    try {
-      return (await command.execute({ params: options.params, input: payloadOf(entity, get(values)) })) as T;
-    } catch (err) {
-      const refusals = validationErrorsOf(err);
-      if (refusals) {
-        errors.set(errorsByField(refusals));
+    const answer = await command.execute({ params: options.params, input: payloadOf(entity, get(values)) });
+    const failure = get(command).error;
+    const refusals = failure && validationErrorsOf(failure);
+    if (refusals) errors.set(errorsByField<E>(refusals));
 
-        return null;
-      }
-      throw err;
-    }
+    return answer as FormRow<E> | null;
   }
 
   const valid: Readable<boolean> = derived(errors, ($errors) => Object.keys($errors).length === 0);
@@ -64,7 +63,7 @@ export function useFormFor<T = Record<string, unknown>>(entity: FormEntity, opti
     fields,
     /** The same fields, keyed by name — spread `fieldsByName.email.attrs` on an input
      *  and the page states no rule of its own. */
-    fieldsByName: Object.fromEntries(fields.map((field) => [field.name, field])) as Record<string, FormField>,
+    fieldsByName: Object.fromEntries(fields.map((field) => [field.name, field])) as Partial<Record<FormFieldName<E>, FormField<FormFieldName<E>>>>,
     values,
     errors,
     submit,

package/src/useFougereData/CommandStore.ts

@@ -4,7 +4,8 @@ import { asFougereError, callOf, addressOf, fetcher, invocationOf, mountedKeys,
 
 export interface CommandStore<T, Refused extends ErrorCode = ErrorCode>
   extends Readable<{ loading: boolean; error: FougereError<Refused> | null }> {
-  execute(input?: CallInput): Promise<T>;
+  /** The answer, or `null` when the call was refused — the refusal is in `error`, and nothing is thrown. */
+  execute(input?: CallInput): Promise<T | null>;
 }
 
 export function useCommand<
@@ -17,7 +18,7 @@ export function useCommand<
 
   return {
     subscribe: store.subscribe,
-    async execute(input?: CallInput): Promise<Answer<Handler, Op>> {
+    async execute(input?: CallInput): Promise<Answer<Handler, Op> | null> {
       store.set({ loading: true, error: null });
       try {
         const result = (await sendCall(fetcher, callOf(facade, op), invocationOf(input))) as Answer<Handler, Op>;
@@ -29,7 +30,8 @@ export function useCommand<
       } catch (err) {
         const failure = asFougereError(err, entityKey, op);
         store.set({ loading: false, error: failure });
-        throw failure;
+
+        return null;
       }
     },
   };

package/template/scaffold.json

@@ -27,5 +27,6 @@
     "file": "vite.config.ts",
     "from": "@fougere/vite",
     "imported": "fougere"
-  }
+  },
+  "facade": { "kind": "kitAlias", "file": "vite.config.ts" }
 }