@fougere/svelte 0.16.2-alpha.0 → 0.16.4-alpha.0

package/dist/index.d.ts

@@ -3,7 +3,8 @@ export { useCommand } from './useFougereData/CommandStore.js';
 export { useQuery } from './useFougereData/QueryStore.js';
 export { facade, facadeOf } from '@fougere/app/client';
 export { useFormFor, type FormOptions } from './useFormFor.js';
+export { cellOf, summaryOf, tableColumnsOf } from '@fougere/app/client';
 export { useCurrentUser } from './useCurrentUser.js';
 export { fetcher, CALL_ENDPOINT } from '@fougere/app/client';
-export type { CallInput, EntityClass, FormEntity, FormField, SessionView, } from '@fougere/app/client';
+export type { CallInput, EntityClass, FormEntity, FormField, SessionView, TableColumn, } from '@fougere/app/client';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,wFAAwF;AACxF,OAAO,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AAC9D,OAAO,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAC;AAE1D,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,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAE7D,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":"AAAA,wFAAwF;AACxF,OAAO,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AAC9D,OAAO,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAC;AAE1D,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,KAAK,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC/D,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACxE,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAE7D,YAAY,EACV,SAAS,EACT,WAAW,EACX,UAAU,EACV,SAAS,EACT,WAAW,EACX,WAAW,GACZ,MAAM,qBAAqB,CAAC"}

package/dist/index.js

@@ -4,6 +4,7 @@ export { useQuery } from './useFougereData/QueryStore.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 { cellOf, summaryOf, tableColumnsOf } from '@fougere/app/client';
 export { useCurrentUser } from './useCurrentUser.js';
 export { fetcher, CALL_ENDPOINT } from '@fougere/app/client';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,wFAAwF;AACxF,OAAO,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AAC9D,OAAO,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAC;AAC1D,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,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,wFAAwF;AACxF,OAAO,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AAC9D,OAAO,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAC;AAC1D,yEAAyE;AACzE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,UAAU,EAAoB,MAAM,iBAAiB,CAAC;AAC/D,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACxE,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC"}

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, type FormRow } from '@fougere/app/client';
+import { type Choice, type FormEntity, type FormField, type FormFieldName, type FormRow } from '@fougere/app/client';
 export interface FormOptions {
     /** Command the submit rides. Default: 'create'. */
     op?: string;
@@ -10,12 +10,14 @@ export interface FormOptions {
     params?: Record<string, string>;
 }
 export declare function useFormFor<E extends FormEntity>(entity: E, options?: FormOptions): {
-    fields: FormField[];
+    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>;
+    fieldsByName: Partial<Record<FormFieldName<E>, FormField<FormFieldName<E>>>>;
     values: Writable<Partial<FormRow<E>>>;
-    errors: Writable<Partial<Record<keyof FormRow<E> & string, string>>>;
+    errors: Writable<Partial<Record<FormFieldName<E>, string>>>;
+    choices: Writable<Partial<Record<FormFieldName<E>, Choice[]>>>;
+    search: (name: FormFieldName<E>, text?: string) => Promise<void>;
     submit: () => Promise<FormRow<E> | null>;
     validator: () => boolean;
     valid: Readable<boolean>;

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,EAEf,KAAK,SAAS,EACd,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;;IAyCjF;kDAC8C;kBACkC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC;;;kBArBlF,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;qBAP7B,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,EAQL,KAAK,MAAM,EACX,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;;IAiDjF;kDAC8C;kBACkC,OAAO,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,SAAS,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;;;;mBAnCpH,aAAa,CAAC,CAAC,CAAC,oBAAc,OAAO,CAAC,IAAI,CAAC;kBAmB9C,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;qBAP7B,OAAO;;IA+B3B,sDAAsD;;EAGzD"}

package/dist/useFormFor.js

@@ -1,7 +1,7 @@
 /** The form contract — state, validation, submission, error mapping. */
 import { writable, derived, get } from 'svelte/store';
 import { validationErrorsOf } from '@fougere/core/contract';
-import { entityKeyOf, facadeOf, errorsByField, formFieldsOf, payloadOf, } from '@fougere/app/client';
+import { Choices, entityKeyOf, fetcher, facadeOf, errorsByField, formFieldsOf, payloadOf, } from '@fougere/app/client';
 import { useCommand } from './useFougereData/CommandStore.js';
 export function useFormFor(entity, options = {}) {
     const entityKey = entityKeyOf(entity);
@@ -13,6 +13,20 @@ export function useFormFor(entity, options = {}) {
     // 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 what it answers is the entity's row.
     const command = useCommand(facadeOf(entity), options.op ?? 'create');
+    const choices = writable({});
+    /** What a reference field offers: its first rows, or those whose label contains `text`. */
+    async function search(name, text = '') {
+        const reference = fields.find((field) => field.name === name)?.reference;
+        if (!reference)
+            return;
+        const found = await Choices.of(fetcher, reference, text);
+        choices.update((current) => ({ ...current, [name]: found }));
+    }
+    if (typeof window !== 'undefined') {
+        for (const field of fields)
+            if (field.reference)
+                void search(field.name);
+    }
     /** Local pre-verdict — same rules as the handler, saves a lost round-trip. */
     function validator() {
         const result = entity.validate(payloadOf(entity, get(values)));
@@ -22,17 +36,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 {
@@ -42,6 +51,8 @@ export function useFormFor(entity, options = {}) {
         fieldsByName: Object.fromEntries(fields.map((field) => [field.name, field])),
         values,
         errors,
+        choices,
+        search,
         submit,
         validator,
         valid,

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,GAMV,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,GAAgB,YAAY,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAE5D,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,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,CAAe,CAAC;QAClH,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,CAAI,QAAQ,CAAC,CAAC,CAAC;gBAEvC,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":"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"}

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.2-alpha.0",
+  "version": "0.16.4-alpha.0",
   "description": "Fougere's four primitives as Svelte stores — host-independent.",
   "keywords": [
     "fougere",
@@ -31,13 +31,13 @@
     "template"
   ],
   "dependencies": {
-    "@fougere/app": "0.16.2-alpha.0",
-    "@fougere/core": "0.16.2-alpha.0"
+    "@fougere/app": "0.16.4-alpha.0",
+    "@fougere/core": "0.16.4-alpha.0"
   },
   "devDependencies": {
     "svelte": "^5.53.4",
     "vitest": "^4.1.0",
-    "@fougere/schema": "0.16.2-alpha.0"
+    "@fougere/schema": "0.16.4-alpha.0"
   },
   "peerDependencies": {
     "svelte": "^5.0.0"

package/src/index.ts

@@ -4,6 +4,7 @@ export { useQuery } from './useFougereData/QueryStore.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 { cellOf, summaryOf, tableColumnsOf } from '@fougere/app/client';
 export { useCurrentUser } from './useCurrentUser.js';
 export { fetcher, CALL_ENDPOINT } from '@fougere/app/client';
 
@@ -13,4 +14,5 @@ export type {
   FormEntity,
   FormField,
   SessionView,
+  TableColumn,
 } from '@fougere/app/client';

package/src/useFormFor.ts

@@ -2,14 +2,18 @@
 import { writable, derived, get, type Readable, type Writable } from 'svelte/store';
 import { validationErrorsOf } from '@fougere/core/contract';
 import {
+  Choices,
   entityKeyOf,
+  fetcher,
   facadeOf,
   errorsByField,
   formFieldsOf,
   payloadOf,
+  type Choice,
   type FormEntity,
   type FormErrors,
   type FormField,
+  type FormFieldName,
   type FormRow,
   type FormValues,
 } from '@fougere/app/client';
@@ -26,7 +30,7 @@ export interface 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.
@@ -37,6 +41,19 @@ export function useFormFor<E extends FormEntity>(entity: E, options: FormOptions
   // 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 what it answers is the entity's row.
   const command = useCommand(facadeOf(entity), options.op ?? 'create');
+  const choices = writable<Partial<Record<FormFieldName<E>, Choice[]>>>({});
+
+  /** What a reference field offers: its first rows, or those whose label contains `text`. */
+  async function search(name: FormFieldName<E>, text = ''): Promise<void> {
+    const reference = fields.find((field) => field.name === name)?.reference;
+    if (!reference) return;
+    const found = await Choices.of(fetcher, reference, text);
+    choices.update((current) => ({ ...current, [name]: found }));
+  }
+
+  if (typeof window !== 'undefined') {
+    for (const field of fields) if (field.reference) void search(field.name);
+  }
 
   /** Local pre-verdict — same rules as the handler, saves a lost round-trip. */
   function validator(): boolean {
@@ -48,17 +65,12 @@ export function useFormFor<E extends FormEntity>(entity: E, options: FormOptions
 
   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 FormRow<E>;
-    } catch (err) {
-      const refusals = validationErrorsOf(err);
-      if (refusals) {
-        errors.set(errorsByField<E>(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);
@@ -67,9 +79,11 @@ export function useFormFor<E extends FormEntity>(entity: E, options: FormOptions
     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,
+    choices,
+    search,
     submit,
     validator,
     valid,

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

@@ -15,6 +15,7 @@
     "@fougere/schema": "latest",
     "@fougere/defaults": "latest",
     "@fougere/container": "latest",
+    "@fougere/log": "latest",
     "better-sqlite3": "^13.0.3",
     "kysely": "^0.28.17",
     "@fougere/svelte": "latest"
@@ -27,5 +28,6 @@
     "file": "vite.config.ts",
     "from": "@fougere/vite",
     "imported": "fougere"
-  }
+  },
+  "facade": { "kind": "kitAlias", "file": "vite.config.ts" }
 }