@fieldia/core 0.24.0 → 0.25.0

package/src/lib/record/form.mjs

@@ -14,6 +14,7 @@ import { rolesAllow } from './roles.mjs';
 import { compileFieldTone, compileTable } from './cells.mjs';
 import { fill, MESSAGES } from './messages.mjs';
 import { loadedRecordOf, saveProblemOf, } from './data-source.mjs';
+import { waitingOn, workedOutFrom } from './waits.mjs';
 import { createUploads, fileBytesIn, uploadGoing, withoutFileBytes } from './uploads.mjs';
 import { hostScheduler } from './scheduler.mjs';
 import { createMoments, createRunner } from './run.mjs';
@@ -158,6 +159,8 @@ function innerForm(options, within, place, outer) {
     const editingNow = () => editing && !(started && state.can?.edit === false);
     const about = () => ({ recordId: started ? state.recordId : (options.recordId ?? null), user: options.user, editing: editingNow(), context: options.context, parent: parentContext });
     const computed = compileComputed(page, today, about);
+    /** Each value worked out from others — by the page, or by the app as the lines change — and what it waits for. */
+    const workedOut = workedOutFrom(page, !!options.dataSource?.onchange && page.data.kind === 'record', !!options.parent);
     const setWhen = compileSetWhen(page, today, about);
     /** The saved forms placed on the page, by the part's id: each one's answers sit under its name, as JSON. */
     const parts = new Map();
@@ -317,6 +320,13 @@ function innerForm(options, within, place, outer) {
      * for is still the one shown, as it was. A save's answer, a call's, an onchange's, a name looked up, a line's
      * dialog, a record step's — none is laid on another record, nor over the values the person's Discard let go.
      */
+    /** The data source with a member a record's page asks of it, and the page's model: refused where either is missing. */
+    function recordSource(member) {
+        const source = options.dataSource;
+        if (page.data.kind !== 'record' || !source?.[member])
+            throw new Error(`The data source has no ${member}()`);
+        return [source, page.data.model];
+    }
     function shownNow() {
         const at = generation;
         const reset = resets;
@@ -2020,6 +2030,13 @@ function innerForm(options, within, place, outer) {
         leave: (how) => Promise.resolve(letGo(how)),
         leaveNow: (how = {}) => (outer ? outer.leaveNow(how) : atOnce(how)),
         recordShown: shownNow,
+        relatedFilter(id) {
+            const node = index.get(id)?.source;
+            if (node?.type !== 'related' || state.recordId == null)
+                return null;
+            const related = node;
+            return [{ field: related.field, op: '=', value: state.recordId }, ...(related.filter ? resolveFilter(related.filter, context()) : [])];
+        },
         post,
         setEditing(next) {
             if (next === editing)
@@ -2032,6 +2049,10 @@ function innerForm(options, within, place, outer) {
         loadChoices,
         loadDefinitions,
         addDefinition,
+        waitsFor(name) {
+            const from = workedOut.get(name);
+            return from ? waitingOn(page, from, state.values, state.unread) : null;
+        },
         problem(name) {
             fieldDef(name);
             // Only a field someone can see is asked anything, and required wherever it is shown so.
@@ -2110,6 +2131,7 @@ function innerForm(options, within, place, outer) {
         save: () => track(save()),
         canUpload: () => typeof options.dataSource?.upload === 'function',
         today,
+        recordReads: (id, values, fields) => recordContext(values, fields ?? page.fields, { recordId: id, user: options.user, editing: false, context: options.context }),
         canFindSlots: () => typeof options.dataSource?.slots === 'function',
         findSlots(field, ask) {
             const source = options.dataSource;
@@ -2130,6 +2152,28 @@ function innerForm(options, within, place, outer) {
                 values: structuredCopy(state.values),
             });
         },
+        canFindDuplicates: () => !!(page.data.kind === 'record' && page.duplicates?.fields?.length && options.dataSource?.duplicates),
+        async findDuplicates() {
+            const [source, model] = recordSource('duplicates');
+            const fields = (page.duplicates?.fields ?? []).filter((name) => page.fields[name] && !isEmpty(page.fields[name], state.values[name]));
+            const recordId = state.recordId;
+            // Nothing typed in any of them: nothing asked.
+            if (!fields.length)
+                return [];
+            const { matches } = await source.duplicates({ model, recordId, values: structuredCopy(state.values), fields });
+            // Never the record itself, whatever the source says; the likest first where it scores them.
+            const others = (matches ?? []).filter((match) => match && String(match.id) !== String(recordId));
+            return others.every((match) => typeof match.score === 'number') ? others.sort((a, b) => b.score - a.score) : others;
+        },
+        canMerge: () => !!(page.data.kind === 'record' && options.dataSource?.merge && options.dataSource.load),
+        async readRecord(id) {
+            const [source, model] = recordSource('load');
+            return loadedRecordOf(await source.load({ model, id, fields: page.fields })).values;
+        },
+        async merge(request) {
+            const [source, model] = recordSource('merge');
+            return source.merge({ model, keepId: request.keepId, mergeIds: [...request.mergeIds], values: structuredCopy(request.values), fields: page.fields });
+        },
         upload: (field, files, how = {}) => uploads.start(field, files, how),
         uploading: (field) => state.uploads.filter((upload) => upload.field === field && !upload.line),
         cancelUpload(id) {
@@ -2806,6 +2850,12 @@ function indexLayout(root) {
             else if (node.type === 'form') {
                 add(node, parent, 'form', { invisible: node.invisible, readonly: node.readonly });
             }
+            else if (node.type === 'related') {
+                add(node, parent, 'other', { invisible: node.invisible });
+                // A row's buttons: their roles here, hidden with the list, their condition read by it on each row's record.
+                for (const button of node.rowButtons ?? [])
+                    add(button, node.id, 'button', {});
+            }
             else {
                 add(node, parent, 'other', { invisible: node.invisible });
             }
@@ -2832,6 +2882,9 @@ function indexLayout(root) {
         // A list holds no fields of its own record: only the buttons for what is selected.
         for (const button of root.actions ?? [])
             add(button, root.id, 'button', { invisible: button.invisible });
+        // A row's buttons: their roles here, their condition read by the list on each row's record, which the form does not hold.
+        for (const button of root.rowButtons ?? [])
+            add(button, root.id, 'button', {});
     }
     else {
         // The title and statusbar show fields too, so they are validated like