@fieldia/core 0.26.1 → 0.27.0

package/src/lib/record/form-limits.mjs

@@ -0,0 +1,224 @@
+import { choiceOptions, optionsField, optionsList } from '../format/choice-options.mjs';
+import { fill } from './messages.mjs';
+import { countsAsked, dayAlone, limitInstant, seatedFields } from './taking.mjs';
+import { isOwnZone } from './zones.mjs';
+/** What a form tells of its limits now: from the page, the clock, the options it shows and the source's last answer. */
+export function limitsNow(page, now, told, asking, optionsOf) {
+    const limits = page.data.kind === 'responses' ? page.limits : undefined;
+    const seats = {};
+    for (const [field, counted] of Object.entries(told?.perChoice ?? {})) {
+        const places = {};
+        for (const option of optionsOf(field)) {
+            if (option.seats === undefined)
+                continue;
+            const taken = Math.max(0, Number(counted?.[String(option.value)] ?? 0) || 0);
+            places[String(option.value)] = { seats: option.seats, taken, left: Math.max(0, option.seats - taken) };
+        }
+        if (Object.keys(places).length)
+            seats[field] = places;
+    }
+    if (!limits && !Object.keys(seats).length)
+        return null;
+    const opens = limits?.opens ? limitInstant(limits.opens, page.timeZone) : null;
+    const closes = limits?.closes ? limitInstant(limits.closes, page.timeZone, true) : null;
+    const max = limits?.maxResponses;
+    const responses = told?.responses;
+    const left = max !== undefined && typeof responses === 'number' ? Math.max(0, max - responses) : undefined;
+    const state = opens !== null && now < opens ? 'soon'
+        : closes !== null && now >= closes ? 'closed'
+            : asking ? 'asking'
+                : left === 0 ? 'full'
+                    : limits?.onePerPerson && (told?.mine ?? 0) >= 1 ? 'sent'
+                        : 'open';
+    return {
+        state,
+        ...(opens !== null ? { opens: new Date(opens).toISOString() } : {}),
+        ...(closes !== null ? { closes: new Date(closes).toISOString() } : {}),
+        ...(limits?.message ? { message: limits.message } : {}),
+        ...(left !== undefined ? { left } : {}),
+        seats,
+    };
+}
+/** The values a choice holds: one, several (a choice of many), or none. */
+const chosenOf = (value) => (Array.isArray(value) ? value : value === null || value === undefined ? [] : [value]);
+/**
+ * The options of a choice's value that are full now, in the order they are held: those `before` held too left out
+ * when given — a choice made now, not one held already.
+ */
+export function fullChosen(field, places, value, before) {
+    if (!places || field?.type !== 'selection')
+        return [];
+    const held = new Set(chosenOf(before).map(String));
+    return chosenOf(value)
+        .filter((one) => !(before !== undefined && held.has(String(one))) && places[String(one)]?.left === 0)
+        .map((one) => (field.options ?? []).find((option) => String(option.value) === String(one)) ?? { value: String(one), label: String(one) });
+}
+/** A form's limits: what it tells of them, and what it asks and refuses by them. */
+export function formLimits(host) {
+    const { page, scheduler, messages } = host;
+    /** The source's last answer to `limits`: null until it told. */
+    let counted = null;
+    let timer = null;
+    /** The choice fields whose own options have places. */
+    const seated = seatedFields(page);
+    /** A choice's options as shown: its own, or its app's list's once loaded. */
+    const optionsOf = (name) => {
+        const def = page.fields[name];
+        if (def?.type !== 'selection')
+            return [];
+        if (optionsList(def.optionsFrom))
+            return (host.started() ? host.state().choices[name]?.options : null) ?? [];
+        // Carried from an earlier question: its options, and the choice's own after them.
+        return optionsField(def.optionsFrom) ? choiceOptions(page.fields, name) : (def.options ?? []);
+    };
+    /** The choice fields with places now: those of the page's own, and of the app's lists whose options loaded with them. */
+    const seatedNow = () => [...seated, ...Object.keys(host.started() ? host.state().choices : {}).filter((name) => !seated.includes(name) && optionsOf(name).some((option) => option.seats !== undefined))];
+    const asks = () => !!host.dataSource?.limits && (countsAsked(page) || seatedNow().length > 0);
+    /** The page's counts asked as it opens and not told yet: nothing is typed meanwhile. */
+    let askingFirst = asks() && countsAsked(page);
+    const limitsHere = () => limitsNow(page, host.clock(), counted, askingFirst, optionsOf);
+    function show() {
+        const limits = limitsHere();
+        if (JSON.stringify(limits) !== JSON.stringify(host.state().limits ?? null))
+            host.set({ limits });
+        if (timer !== null)
+            scheduler.clearTimeout(timer);
+        timer = null;
+        const next = [limits?.opens, limits?.closes].map((at) => (at ? Date.parse(at) - host.clock() : -1)).filter((ms) => ms > 0).sort((a, b) => a - b)[0];
+        // Within the longest wait a timer keeps (24 days), while something listens: a page left open as it opens or closes
+        // says so then. (A form no one listens to keeps no timer that would hold a process open.)
+        if (next !== undefined && next < 2 ** 31 - 1 && !host.disposed() && host.listened())
+            timer = scheduler.setTimeout(show, next + 50);
+    }
+    async function ask() {
+        const source = host.dataSource;
+        if (!asks() || !source?.limits)
+            return show();
+        const shown = host.shownNow();
+        const user = host.user ? { user: { id: host.user.id, ...(host.user.name ? { name: host.user.name } : {}) } } : {};
+        // A source that never answers keeps no one from the questions for long: past 10 seconds they show, and its submit decides.
+        const waited = askingFirst
+            ? scheduler.setTimeout(() => {
+                if (!askingFirst || !shown())
+                    return;
+                askingFirst = false;
+                show();
+            }, 10000)
+            : null;
+        try {
+            const told = await source.limits({ pageId: page.id, model: page.data.kind === 'record' ? page.data.model : '', recordId: host.state().recordId, fields: seatedNow(), ...user });
+            if (!shown())
+                return;
+            counted = told ?? {};
+        }
+        catch {
+            // Not told: the page keeps to its dates alone, and the source's submit refuses as it would.
+            if (!shown())
+                return;
+        }
+        finally {
+            if (waited !== null)
+                scheduler.clearTimeout(waited);
+        }
+        askingFirst = false;
+        show();
+    }
+    return {
+        show,
+        ask,
+        asks,
+        uncounted: (name) => !counted?.perChoice?.[name],
+        async stillTaking(asked) {
+            if (!page.limits && !seatedNow().length)
+                return null;
+            await ask();
+            if (asked !== host.generation())
+                return { reason: 'save', message: host.replaced() };
+            const limits = limitsHere();
+            const why = limits && limits.state !== 'open' && limits.state !== 'asking' ? takingWords(page, limits, messages) : null;
+            if (!why)
+                return null;
+            const problem = { kind: 'rule', message: why };
+            host.set({ status: 'error', error: why, saveProblem: problem, conflict: null, limits });
+            return { reason: 'save', message: why };
+        },
+        refusedFull(name, value) {
+            const state = host.state();
+            const full = fullChosen(page.fields[name], state.limits?.seats[name], value, state.values[name]);
+            if (!full.length)
+                return false;
+            host.refuse(name, fill(messages.choiceFull, { option: full.map((option) => option.label).join(', ') }));
+            return true;
+        },
+        fullErrors(seen, errors) {
+            const state = host.state();
+            const found = {};
+            for (const [name, places] of Object.entries(state.limits?.seats ?? {})) {
+                const full = seen.has(name) && !errors[name] ? fullChosen(page.fields[name], places, state.values[name]) : [];
+                if (full.length)
+                    found[name] = fill(messages.choiceFilled, { option: full.map((option) => option.label).join(', ') });
+            }
+            return found;
+        },
+        heard(listening) {
+            if (listening) {
+                const limits = host.state().limits;
+                if (timer === null && (limits?.opens || limits?.closes))
+                    show();
+                return;
+            }
+            if (timer === null)
+                return;
+            scheduler.clearTimeout(timer);
+            timer = null;
+        },
+        dispose() {
+            if (timer !== null)
+                scheduler.clearTimeout(timer);
+            timer = null;
+        },
+    };
+}
+/**
+ * A day or a day and a time in words, in the messages' language, on the page's clock: "20 November 2026", "1 November
+ * 2026 at 09:00" — with the zone's short name where it is not the browser's own ("09:00 GMT+2").
+ */
+export function whenWords(written, at, messages, zone) {
+    if (dayAlone(written)) {
+        const [y, m, d] = written.split('-').map(Number);
+        return new Intl.DateTimeFormat(messages.locale, { year: 'numeric', month: 'long', day: 'numeric', timeZone: 'UTC', numberingSystem: 'latn' }).format(Date.UTC(y, m - 1, d));
+    }
+    const elsewhere = !!zone && !isOwnZone(zone);
+    return new Intl.DateTimeFormat(messages.locale, {
+        year: 'numeric',
+        month: 'long',
+        day: 'numeric',
+        hour: '2-digit',
+        minute: '2-digit',
+        hourCycle: 'h23',
+        numberingSystem: 'latn',
+        ...(zone ? { timeZone: zone } : {}),
+        ...(elsewhere ? { timeZoneName: 'short' } : {}),
+    }).format(at);
+}
+/**
+ * Why a page takes no answers now, in the messages' words — "This form opens on 1 November 2026 at 09:00.", "This form
+ * closed on 20 November 2026.", "This form has all the responses it takes.", "You have sent your answers to this form
+ * already." — or null while it takes them (or still asks).
+ */
+export function takingWords(page, limits, messages) {
+    const written = page.limits;
+    switch (limits?.state) {
+        case 'soon':
+            return written?.opens && limits.opens ? fill(messages.formOpens, { when: whenWords(written.opens, Date.parse(limits.opens), messages, page.timeZone) }) : null;
+        case 'closed':
+            return written?.closes && limits.closes ? fill(messages.formClosed, { when: whenWords(written.closes, Date.parse(limits.closes), messages, page.timeZone) }) : null;
+        case 'full':
+            return messages.formFull;
+        case 'sent':
+            return messages.formSent;
+        default:
+            return null;
+    }
+}
+//# sourceMappingURL=form-limits.mjs.map

package/src/lib/record/form-limits.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"form-limits.mjs","sourceRoot":"","sources":["../../../../../../libs/core/src/lib/record/form-limits.ts"],"names":[],"mappings":"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"}

package/src/lib/record/form.d.mts

@@ -1,10 +1,15 @@
 import type { ActionStep } from '../format/actions.mjs';
 import type { Field, LineField, Option, PropertyDefinition } from '../format/field.mjs';
 import type { Page } from '../format/page.mjs';
+import type { PageEnding } from '../format/endings.mjs';
 import type { JsonValue } from '../format/json.mjs';
+import { type FunctionTable } from '../expression/functions.mjs';
+import { type AppFunctions } from '../expression/app-functions.mjs';
+import { type AskedFor } from './compute.mjs';
 import { type FieldTone, type LineState } from './cells.mjs';
 import { type Messages } from './messages.mjs';
-import { type DataSource, type RecordChanges, type RecordPermissions, type RecordVersion, type ResolvedFilter, type SaveProblem, type BotReport, type SlotsResult, type UploadFile, type DuplicateMatch, type MergeResult } from './data-source.mjs';
+import { type DataSource, type RecordChanges, type RecordPermissions, type RecordVersion, type ResolvedFilter, type SaveProblem, type BotReport, type SlotsResult, type UploadFile, type DuplicateMatch, type MergeResult, type SavedDraft } from './data-source.mjs';
+import { type FormLimits } from './taking.mjs';
 import { type WaitsFor } from './waits.mjs';
 import { type FileUpload, type UploadHow } from './uploads.mjs';
 import { type Scheduler } from './scheduler.mjs';
@@ -40,7 +45,10 @@ export interface FormState {
     readonly skipped: readonly string[];
     /** Why the last save was refused, until the next one starts or the form is reset. */
     readonly saveProblem: SaveProblem | null;
-    /** The choices loaded from the app's lists, by field: those of a selection with `optionsFrom`, once asked for. */
+    /**
+     * The choices loaded from the app's lists: those of a selection with `optionsFrom`, once asked for — by field, and a
+     * table line's by its cell's path (`field.lineKey.subfield`).
+     */
     readonly choices: Readonly<Record<string, Choices>>;
     /** The definitions loaded for a properties field with `definitionsFrom`, by field, once asked for. */
     readonly definitions: Readonly<Record<string, Definitions>>;
@@ -81,6 +89,47 @@ export interface FormState {
      * value it held as the box was entered; validate and save refuse with the words until the text is fixed.
      */
     readonly unread: Readonly<Record<string, UnreadText>>;
+    /**
+     * A page of responses sent: the answers as they went, with what the app's source answered — the id it gave the
+     * response and the values it added (`SubmitResult`). What its ending reads (`form.ending()`, `{id}`). Null until a
+     * send, and again once the form starts a new response (`reset`).
+     */
+    readonly sent?: SentResponse | null;
+    /**
+     * Values worked out from an app's function that asks its server (`functions`) with no answer yet, by path (a
+     * line's `field.lineKey.subfield`): waiting for it (`{}`) — the value empty meanwhile, a save waiting for it — or
+     * why it did not come (`failed`), which a save asks again and, failing, is stopped by under its field.
+     */
+    readonly asked: Readonly<Record<string, AskedFor>>;
+    /**
+     * Words said under a choice whose chosen options a change of other answers no longer offers — hidden by their
+     * condition, no longer picked where they are carried from, or no longer in the app's list as a field it changes with
+     * changed — by path (a field, or a table line's `field.lineKey.subfield`): they were taken out of its answer. Until
+     * that value is written again, its line goes, or another record is shown.
+     */
+    readonly takenOut: Readonly<Record<string, string>>;
+    /**
+     * When the page takes answers and each choice's places, as its `limits`, its options' `seats`, the form's clock and
+     * the data source's `limits` tell: whether it takes them now (`state`), when it opens and closes, the responses it
+     * takes still, and each choice's places left. Null on a page with neither.
+     */
+    readonly limits?: FormLimits | null;
+    /**
+     * The draft kept on the app's server (`saveDraft`) that these answers continue: its `key`, once the source gave one
+     * (the viewer's `resume`, or the first draft kept); `missing` when the key the form was given named no draft — it
+     * starts empty. Null while none is.
+     */
+    readonly resume?: {
+        readonly key: string;
+        readonly missing?: boolean;
+    } | null;
+}
+/** A response sent, as `FormState.sent` keeps it. */
+export interface SentResponse {
+    /** The id the app's source gave the response ("B-1043"), or null where it gave none. */
+    readonly id: RecordId | null;
+    /** The answers as they were sent, with the values the source added (`SubmitResult.values`) laid over them. */
+    readonly values: Readonly<Values>;
 }
 /** How a search for a link's records is asked (`form.search`, `form.searchLine`). */
 export interface SearchOptions {
@@ -235,6 +284,16 @@ export interface FormEvents {
         recordId: RecordId | null;
         message: PostedMessage;
     };
+    /**
+     * A draft was kept on the app's server (`saveDraft`): its key — what a link to continue from carries — and whether the
+     * person pressed "Continue later" (`later`), with the source's answer.
+     */
+    draft: {
+        key: string;
+        savedAt: string;
+        later: boolean;
+        saved: SavedDraft;
+    };
 }
 export interface FormOptions {
     page: Page;
@@ -254,11 +313,24 @@ export interface FormOptions {
     host?: ActionHost;
     /** How a question is asked when there is no host. Without either, a question goes on as though answered Yes. */
     confirm?: (message: string) => boolean | Promise<boolean>;
+    /**
+     * Keep what is typed as a draft, offered again the next time the page opens: in `store` (the browser's localStorage
+     * fits) — or, on a page with `continueLater` whose data source has `saveDraft` and `loadDraft`, on the app's server,
+     * the store keeping only its key (such a page keeps its drafts there without this too). A draft keeps the wizard's
+     * step and text typed that does not read yet. `restore`: `ask` (the default) offers it, `auto` lays it at once.
+     */
     drafts?: {
         store: DraftStore;
         restore?: 'auto' | 'ask';
         delayMs?: number;
     };
+    /**
+     * The key of a draft kept on the app's server (`saveDraft`) to continue from — what the link the app made after
+     * "Continue later" carries: loaded through the source's `loadDraft` as the form opens, its answers, its wizard step
+     * and its text typed that does not read laid as they were. A key that names none starts the form empty
+     * (`resume.missing`). Without the source's `loadDraft`, it is let be.
+     */
+    resume?: string;
     autosave?: {
         delayMs: number;
     };
@@ -294,6 +366,21 @@ export interface FormOptions {
         fields: Readonly<Record<string, Field | LineField>>;
         id?: RecordId | null;
     };
+    /**
+     * How a field's value reads inside the page's own words — a `{field}` in a label, a help, a choice, a step's title, a
+     * button, an ending — and so inside the form's messages that name a label ("How was your visit to Zamalek? is
+     * required"). The viewer gives its own, as each field shows its value at rest: a choice by its label, money with its
+     * currency, a day in the page's order. Left out, a choice by its label, a link by its name, a yes or no as Yes or No,
+     * anything else as it is held.
+     */
+    valueWords?: (field: Field, value: Value | undefined, values: Readonly<Values>) => string;
+    /**
+     * The app's own functions, which the page's expressions call by name besides Fieldia's: `vatRate(country)`. Each a
+     * plain function, or `{ call, takes, values, gives, tip }`. One that asks the app's server gives a promise: a value
+     * worked out from it waits while it is asked — once for the same values, for the record shown — and a save waits
+     * for it; a condition reading it does not hold meanwhile. A name a page cannot call is refused as the form is made.
+     */
+    functions?: AppFunctions;
 }
 /** The person using a form, as the app knows them. */
 export interface FormUser {
@@ -304,6 +391,16 @@ export interface FormUser {
 }
 export interface Form {
     readonly page: Page;
+    /** The app's own functions as the page's expressions call them (`FormOptions.functions`): for what reads its conditions apart. */
+    readonly functions?: FunctionTable;
+    /**
+     * A table line's cell's form (@fieldia/widgets' `lineForm`): the table and the line it is the form of, whose values,
+     * choices and words taken out of them are the line's own. Left out of a record's own form.
+     */
+    readonly line?: {
+        readonly field: string;
+        readonly key: string;
+    };
     getState(): FormState;
     subscribe(listener: (state: FormState) => void): () => void;
     load(): Promise<void>;
@@ -324,7 +421,10 @@ export interface Form {
     node(id: string): NodeState;
     /** Whether the record is being edited, as conditions read `editing`: a view that locks it to be read says false, and parts follow. */
     setEditing(editing: boolean): void;
-    /** Whether a field is read-only whatever the conditions say: by its definition, or for this person by what the record's source said (`can`). */
+    /**
+     * Whether a field is read-only whatever the conditions say: by its definition, for this person by what the record's
+     * source said (`can`), or signed by a signature kept (`FileValue.signed`).
+     */
     fieldReadonly(name: string): boolean;
     /** What a field would be told if the form were checked now, or null when it passes. Nothing is shown. */
     problem(field: string): string | null;
@@ -381,6 +481,20 @@ export interface Form {
     validate(): boolean;
     save(): Promise<boolean>;
     reset(): void;
+    /**
+     * Words of the page's with each `{field}` showing the value the form holds now, as `valueWords` writes it — a label's,
+     * a help's, a step's title, a button's: "How was your visit to {branch}?" reads "How was your visit to Zamalek?". A
+     * name that is no field of the page shows nothing.
+     */
+    words(text: string): string;
+    /**
+     * The ending a page of responses shows now its answers are sent (`FormState.sent`): the first of the page's
+     * `endings` whose `when` holds on the answers as sent, with what the source added and the response's `id`, else the
+     * first with no `when`; null before a send, on a page with none, or where none holds.
+     */
+    ending(): PageEnding | null;
+    /** An ending's words, its `{field}`s and `{id}` filled in from the response sent (`FormState.sent`), as `words` writes them. */
+    endingWords(text: string): string;
     changes(): RecordChanges;
     addLine(field: string, values?: Values): string;
     updateLine(field: string, key: string, name: string, value: Value): void;
@@ -448,9 +562,32 @@ export interface Form {
     /**
      * Load, or load again, the choices of a selection whose options come from
      * the app's list (`optionsFrom`). Once loaded, they load again by themselves
-     * when a field they change with changes; the latest answer wins.
+     * when a field they change with changes; the latest answer wins, and a
+     * choice it no longer offers after the person, a step or the app changed
+     * that field is taken out and said (`FormState.takenOut`). A value a record
+     * comes in with is kept, and its save says why. A table line's, by its
+     * cell's path (`field.lineKey.subfield`), are asked by the line's values and
+     * shared with every line where the columns they change with hold the same,
+     * for the record shown; once loaded, they follow those columns on that line.
      */
     loadChoices(field: string): void;
+    /**
+     * A table line's choices from the app's list, as they are asked for that line, with `values` laid over it — a row
+     * pasted on it, its connection read first. `key` null: a line not added yet, by the values one added now starts with.
+     */
+    lineChoices(field: string, key: string | null, subfield: string, values?: Values): Promise<Option[]>;
+    /**
+     * The options a choice offers now: its own — or those its list gave (`optionsFrom.list`), or those picked in the
+     * question they are carried from (`optionsFrom.field`), its own after them — less those whose condition hides them
+     * (`options[].invisible`). A table line's by its cell's path (`field.lineKey.subfield`), its conditions read on that
+     * line. Null for a field that is no choice.
+     */
+    offered(field: string): readonly Option[] | null;
+    /**
+     * Whether a choice's options change with the record's answers: a condition on one, or carried from another question.
+     * A table line's by its cell's path: a condition on one of its column's options.
+     */
+    offersChange(field: string): boolean;
     /**
      * Load, or load again, the definitions of a properties field whose
      * definitions come from a linked record (`definitionsFrom`). Once loaded,
@@ -543,6 +680,19 @@ export interface Form {
     on<E extends keyof FormEvents>(event: E, listener: (event: FormEvents[E]) => void): () => void;
     restoreDraft(): void;
     discardDraft(): void;
+    /** Whether the page offers "Continue later": it says `continueLater`, and its data source has `saveDraft`. */
+    canContinueLater(): boolean;
+    /**
+     * "Continue later": what is typed read first (`settle`), then the answers so far — their wizard step, text that does
+     * not read kept as typed — kept on the app's server through `saveDraft` (`later: true`): its answer, the key, and the
+     * link the app made to continue from and its words. Rejects where the source refused, or has no `saveDraft`.
+     */
+    continueLater(): Promise<SavedDraft>;
+    /**
+     * Ask the data source's `limits` again — how many responses the page took, this person's, each choice's takers — and
+     * show what it tells (`limits`). The form asks it itself as it opens, before its answers go, and after they went.
+     */
+    refreshLimits(): Promise<void>;
     /**
      * Whether a file picked for a file or picture field is stored at once,
      * through the data source's `upload`. False without one: a file then
@@ -551,6 +701,16 @@ export interface Form {
     canUpload(): boolean;
     /** Today, as 2026-10-15, on the clock of the page's time zone — the browser's own where it names none — by the form's clock (`now`). */
     today(): string;
+    /** Now, by the form's clock (`now`): the computer's own where the app gave none. A signature's when. */
+    now(): Date;
+    /** The person using the form, as the app named them (`user`); null where it named none. */
+    user(): FormUser | null;
+    /**
+     * The answers shown now, by field, in the page's order: a field placed on the page — or a saved form's answers, by its
+     * name — not hidden by its condition, its roles or the record's source, nor in a step passed over with Skip. What a
+     * signature that signs every answer signs.
+     */
+    shownFields(): string[];
     /**
      * A record of the page's model as conditions read it, the form's own way: its values (a link as its id), its `id`,
      * the person using the form (`user`), the app's `context`, and `editing` false — for what reads conditions on records
@@ -581,6 +741,15 @@ export interface Form {
      * record shown as it was asked (`recordShown`).
      */
     findDuplicates(): Promise<DuplicateMatch[]>;
+    /** Whether the source keeps "It's someone new" itself, on the app's server: it has `notDuplicates` and `markNotDuplicate`, both. */
+    keepsNotDuplicates(): boolean;
+    /**
+     * The records said to be someone else for the record shown, asked of the source's `notDuplicates`: none while it is
+     * new. Rejects where the source has no `notDuplicates`. Its answer is for the record shown as it was asked.
+     */
+    notDuplicates(): Promise<RecordId[]>;
+    /** Keep that `matchId` is someone else for the record shown, through the source's `markNotDuplicate`: refused while it is new. */
+    markNotDuplicate(matchId: RecordId): Promise<void>;
     /** Whether records of the page's model can be merged: its source has `merge`, and `load` to read the others. */
     canMerge(): boolean;
     /** Another record of the page's model, as its source loads it, its values alone: the form is left as it is. For a merge's screen. */