@fieldia/core 0.24.0 → 0.25.0

package/src/lib/format/version.d.ts

@@ -1,11 +1,11 @@
 /** The page format version this build reads and writes. */
-export declare const FORMAT_VERSION: "0.3";
+export declare const FORMAT_VERSION: "0.4";
 /**
  * Every format Fieldia has had, oldest first; the last is FORMAT_VERSION. A page in an older one is brought up to date
  * by `upgradePage`, step by step (`PAGE_UPGRADES`), wherever it is read: `checkPage`, `validatePage`, the viewer, the
  * designer. A release that changes what a page may say adds its version here (see the format's docs, "Versions").
  */
-export declare const FORMAT_VERSIONS: readonly ["0.1", "0.2", "0.3"];
+export declare const FORMAT_VERSIONS: readonly ["0.1", "0.2", "0.3", "0.4"];
 /** A format Fieldia has had: a page may say any of them, and is read in the current one. */
 export type FormatVersion = (typeof FORMAT_VERSIONS)[number];
 /** Which of two format versions is newer: below 0 when `a` is older, 0 when they are the same, null when either is not a version. */

package/src/lib/format/version.js

@@ -4,13 +4,13 @@ exports.FORMAT_VERSIONS = exports.FORMAT_VERSION = void 0;
 exports.compareFormats = compareFormats;
 exports.formatProblem = formatProblem;
 /** The page format version this build reads and writes. */
-exports.FORMAT_VERSION = '0.3';
+exports.FORMAT_VERSION = '0.4';
 /**
  * Every format Fieldia has had, oldest first; the last is FORMAT_VERSION. A page in an older one is brought up to date
  * by `upgradePage`, step by step (`PAGE_UPGRADES`), wherever it is read: `checkPage`, `validatePage`, the viewer, the
  * designer. A release that changes what a page may say adds its version here (see the format's docs, "Versions").
  */
-exports.FORMAT_VERSIONS = ['0.1', '0.2', '0.3'];
+exports.FORMAT_VERSIONS = ['0.1', '0.2', '0.3', '0.4'];
 /** `major.minor` as two numbers, or null when it is not a version at all. */
 function parts(version) {
     const match = typeof version === 'string' ? /^(\d+)\.(\d+)$/.exec(version) : null;

package/src/lib/format/version.js.map

@@ -1 +1 @@
-{"version":3,"file":"version.js","sourceRoot":"","sources":["../../../../../../libs/core/src/lib/format/version.ts"],"names":[],"mappings":";;;AAoBA,wCAIC;AAMD,sCAQC;AAtCD,2DAA2D;AAC9C,QAAA,cAAc,GAAG,KAAc,CAAC;AAE7C;;;;GAIG;AACU,QAAA,eAAe,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,CAAsC,CAAC;AAK1F,6EAA6E;AAC7E,SAAS,KAAK,CAAC,OAAgB;IAC7B,MAAM,KAAK,GAAG,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,gBAAgB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAClF,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AAC7D,CAAC;AAED,qIAAqI;AACrI,SAAgB,cAAc,CAAC,CAAU,EAAE,CAAU;IACnD,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACpC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IAC1B,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;AACpC,CAAC;AAED;;;GAGG;AACH,SAAgB,aAAa,CAAC,OAAgB,EAAE,WAA8B,uBAAe;IAC3F,MAAM,OAAO,GAAG,QAAQ,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAC9C,IAAI,OAAO,KAAK,OAAO;QAAE,OAAO,IAAI,CAAC;IACrC,MAAM,QAAQ,GAAG,cAAc,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAClD,IAAI,QAAQ,KAAK,IAAI;QAAE,OAAO,wDAAwD,OAAO,oBAAoB,CAAC;IAClH,IAAI,QAAQ,GAAG,CAAC;QAAE,OAAO,0BAA0B,OAAiB,oCAAoC,OAAO,8BAA8B,CAAC;IAC9I,IAAI,QAAQ,CAAC,QAAQ,CAAC,OAAiB,CAAC;QAAE,OAAO,0BAA0B,OAAiB,oCAAoC,OAAO,EAAE,CAAC;IAC1I,OAAO,UAAU,OAAiB,mDAAmD,OAAO,EAAE,CAAC;AACjG,CAAC"}
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../../../../../libs/core/src/lib/format/version.ts"],"names":[],"mappings":";;;AAoBA,wCAIC;AAMD,sCAQC;AAtCD,2DAA2D;AAC9C,QAAA,cAAc,GAAG,KAAc,CAAC;AAE7C;;;;GAIG;AACU,QAAA,eAAe,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAsC,CAAC;AAKjG,6EAA6E;AAC7E,SAAS,KAAK,CAAC,OAAgB;IAC7B,MAAM,KAAK,GAAG,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,gBAAgB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAClF,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AAC7D,CAAC;AAED,qIAAqI;AACrI,SAAgB,cAAc,CAAC,CAAU,EAAE,CAAU;IACnD,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACpC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IAC1B,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;AACpC,CAAC;AAED;;;GAGG;AACH,SAAgB,aAAa,CAAC,OAAgB,EAAE,WAA8B,uBAAe;IAC3F,MAAM,OAAO,GAAG,QAAQ,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAC9C,IAAI,OAAO,KAAK,OAAO;QAAE,OAAO,IAAI,CAAC;IACrC,MAAM,QAAQ,GAAG,cAAc,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAClD,IAAI,QAAQ,KAAK,IAAI;QAAE,OAAO,wDAAwD,OAAO,oBAAoB,CAAC;IAClH,IAAI,QAAQ,GAAG,CAAC;QAAE,OAAO,0BAA0B,OAAiB,oCAAoC,OAAO,8BAA8B,CAAC;IAC9I,IAAI,QAAQ,CAAC,QAAQ,CAAC,OAAiB,CAAC;QAAE,OAAO,0BAA0B,OAAiB,oCAAoC,OAAO,EAAE,CAAC;IAC1I,OAAO,UAAU,OAAiB,mDAAmD,OAAO,EAAE,CAAC;AACjG,CAAC"}

package/src/lib/format/version.mjs

@@ -1,11 +1,11 @@
 /** The page format version this build reads and writes. */
-export const FORMAT_VERSION = '0.3';
+export const FORMAT_VERSION = '0.4';
 /**
  * Every format Fieldia has had, oldest first; the last is FORMAT_VERSION. A page in an older one is brought up to date
  * by `upgradePage`, step by step (`PAGE_UPGRADES`), wherever it is read: `checkPage`, `validatePage`, the viewer, the
  * designer. A release that changes what a page may say adds its version here (see the format's docs, "Versions").
  */
-export const FORMAT_VERSIONS = ['0.1', '0.2', '0.3'];
+export const FORMAT_VERSIONS = ['0.1', '0.2', '0.3', '0.4'];
 /** `major.minor` as two numbers, or null when it is not a version at all. */
 function parts(version) {
     const match = typeof version === 'string' ? /^(\d+)\.(\d+)$/.exec(version) : null;

package/src/lib/format/version.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"version.mjs","sourceRoot":"","sources":["../../../../../../libs/core/src/lib/format/version.ts"],"names":[],"mappings":"AAAA,2DAA2D;AAC3D,MAAM,CAAC,MAAM,cAAc,GAAG,KAAc,CAAC;AAE7C;;;;GAIG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,CAAsC,CAAC;AAK1F,6EAA6E;AAC7E,SAAS,KAAK,CAAC,OAAgB;IAC7B,MAAM,KAAK,GAAG,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,gBAAgB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAClF,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AAC7D,CAAC;AAED,qIAAqI;AACrI,MAAM,UAAU,cAAc,CAAC,CAAU,EAAE,CAAU;IACnD,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACpC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IAC1B,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;AACpC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,OAAgB,EAAE,WAA8B,eAAe;IAC3F,MAAM,OAAO,GAAG,QAAQ,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAC9C,IAAI,OAAO,KAAK,OAAO;QAAE,OAAO,IAAI,CAAC;IACrC,MAAM,QAAQ,GAAG,cAAc,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAClD,IAAI,QAAQ,KAAK,IAAI;QAAE,OAAO,wDAAwD,OAAO,oBAAoB,CAAC;IAClH,IAAI,QAAQ,GAAG,CAAC;QAAE,OAAO,0BAA0B,OAAiB,oCAAoC,OAAO,8BAA8B,CAAC;IAC9I,IAAI,QAAQ,CAAC,QAAQ,CAAC,OAAiB,CAAC;QAAE,OAAO,0BAA0B,OAAiB,oCAAoC,OAAO,EAAE,CAAC;IAC1I,OAAO,UAAU,OAAiB,mDAAmD,OAAO,EAAE,CAAC;AACjG,CAAC"}
+{"version":3,"file":"version.mjs","sourceRoot":"","sources":["../../../../../../libs/core/src/lib/format/version.ts"],"names":[],"mappings":"AAAA,2DAA2D;AAC3D,MAAM,CAAC,MAAM,cAAc,GAAG,KAAc,CAAC;AAE7C;;;;GAIG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAsC,CAAC;AAKjG,6EAA6E;AAC7E,SAAS,KAAK,CAAC,OAAgB;IAC7B,MAAM,KAAK,GAAG,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,gBAAgB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAClF,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AAC7D,CAAC;AAED,qIAAqI;AACrI,MAAM,UAAU,cAAc,CAAC,CAAU,EAAE,CAAU;IACnD,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACpC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IAC1B,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;AACpC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,OAAgB,EAAE,WAA8B,eAAe;IAC3F,MAAM,OAAO,GAAG,QAAQ,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAC9C,IAAI,OAAO,KAAK,OAAO;QAAE,OAAO,IAAI,CAAC;IACrC,MAAM,QAAQ,GAAG,cAAc,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAClD,IAAI,QAAQ,KAAK,IAAI;QAAE,OAAO,wDAAwD,OAAO,oBAAoB,CAAC;IAClH,IAAI,QAAQ,GAAG,CAAC;QAAE,OAAO,0BAA0B,OAAiB,oCAAoC,OAAO,8BAA8B,CAAC;IAC9I,IAAI,QAAQ,CAAC,QAAQ,CAAC,OAAiB,CAAC;QAAE,OAAO,0BAA0B,OAAiB,oCAAoC,OAAO,EAAE,CAAC;IAC1I,OAAO,UAAU,OAAiB,mDAAmD,OAAO,EAAE,CAAC;AACjG,CAAC"}

package/src/lib/record/data-source.d.mts

@@ -99,6 +99,121 @@ export interface DataSource {
     exportRecords?(request: ExportRequest): Promise<ExportedFile | {
         message: string;
     } | false>;
+    /**
+     * Make many records at once, each with its own values: a list's Import of
+     * a file's rows, a thousand at a time. Answer for each record asked for,
+     * in its order: the id it was made with, or why it was not made, in the
+     * person's words. Without it, the list saves each in turn (`save` with no
+     * id).
+     */
+    createMany?(request: CreateManyRequest): Promise<CreateManyResult>;
+    /**
+     * Take a list's Import on the server, in place of the browser: a file too
+     * big for one, or a server that imports its own way. Asked once the person
+     * has matched the file's columns to the page's fields, before a row is
+     * checked: answer `{ message }` when the server takes the file (the list
+     * says it: "Your file is being imported: you will get an email"), or
+     * `false` to let the browser import it after all, as it does without this.
+     */
+    importRecords?(request: ImportRequest): Promise<{
+        message: string;
+    } | false>;
+    /**
+     * Records like the one typed, for a page's possible duplicates (`duplicates`): asked a moment after a person stops
+     * typing in a field it names, as a saved record is opened, and as a record is saved — with the fields it names that
+     * hold a value. Answer with the records that have the same phone, email or id, or a name close enough, each with
+     * the fields it matched on; never the record itself. Without it, nothing is asked and nothing shows.
+     */
+    duplicates?(request: DuplicatesRequest): Promise<DuplicatesResult>;
+    /**
+     * Merge records into one, as a person chose on a possible duplicate's Merge: `keepId` kept, holding the values
+     * picked for each field, and `mergeIds` gone. Moving what was theirs — messages, activities, the records that link
+     * to them — to the one kept is the source's work; the page says it will happen. Refuse with `saveRefused` (a `rule`,
+     * with why) and nothing changes. Without it, possible duplicates offer no Merge.
+     */
+    merge?(request: MergeRequest): Promise<MergeResult | void>;
+}
+/** Many records made at once, each with its own values: a list's Import. */
+export interface CreateManyRequest {
+    model: string;
+    /** Each record's values, in the file's order: what its row fills in, and the page's defaults for the rest. Links as `{ id, label }`. */
+    records: Values[];
+    /** The fields' definitions, as a save gets them. */
+    fields: Fields;
+}
+export interface CreateManyResult {
+    /**
+     * One answer for each record asked for, in the same order: the id it was made with, or why it was not made — and,
+     * where the source has it, the problem as a save would throw it (a field's own words). A record left unanswered is
+     * taken as not made.
+     */
+    records: ({
+        id: RecordId;
+    } | {
+        message: string;
+        problem?: SaveProblem;
+    })[];
+}
+/** A file a list's Import hands to the server, its columns matched to the page's fields. */
+export interface ImportRequest {
+    model: string;
+    /** The file as the person picked it: a browser's File fits. */
+    file: UploadFile;
+    /** Each column of the file, in its order — its header's words, and the field it fills, null where it is left out. */
+    columns: {
+        header: string;
+        field: string | null;
+    }[];
+    /** How many rows it holds under its header. */
+    rows: number;
+    /** The fields' definitions, as a save gets them. */
+    fields: Fields;
+    /** The page's language and the order it writes dates in, so a server reads the cells as the page would. */
+    locale: string;
+    dateOrder: 'dmy' | 'mdy' | 'ymd';
+}
+/** Records like the one typed: what `duplicates` is asked. */
+export interface DuplicatesRequest {
+    model: string;
+    /** The record typed, never its own duplicate; null while it is new. */
+    recordId: RecordId | null;
+    /** Every value of the form, as typed: a phone kept as E.164 where the page reads phones the world over. */
+    values: Values;
+    /** The fields to compare it by, by name: those the page names (`duplicates.fields`) that hold a value now. */
+    fields: string[];
+}
+/** A record like the one typed. */
+export interface DuplicateMatch {
+    id: RecordId;
+    /** Its name, as people know it: "Nile Traders". */
+    name: string;
+    /**
+     * What it matched on: the names of the fields asked that it holds the same (`phone`, `email`), or a name close to
+     * the one typed (the name's field). Each is said under that field's box; words of the source's own ("the same
+     * address") are said as they are.
+     */
+    why: string[];
+    /** How alike, from 0 to 1, where the source tells: the likest first. */
+    score?: number;
+}
+export interface DuplicatesResult {
+    matches: DuplicateMatch[];
+}
+/** Records merged into one: what `merge` is asked. */
+export interface MergeRequest {
+    model: string;
+    /** The record kept. */
+    keepId: RecordId;
+    /** The records merged into it, then gone. */
+    mergeIds: RecordId[];
+    /** The kept record's values, as picked on the merge's screen for each field the records held apart. */
+    values: Values;
+    /** The page's fields, so the source knows each link's model, as a save does. */
+    fields: Fields;
+}
+/** What a merge may tell: words of the source's own about it, said once it is done ("4 messages moved"). */
+export interface MergeResult {
+    message?: string;
 }
 /** The same value written in a field of each record: a list's bulk edit. */
 export interface WriteManyRequest {
@@ -629,3 +744,9 @@ export interface SlotsResult {
     /** The minutes a booking lasts, when the source knows better than the page: the service's own length. */
     length?: number;
 }
+/**
+ * A new record's save, made from its values alone — as a list's Import saves a row where the source has no
+ * `createMany`, and a memory source makes each of `createMany`'s: every value in `values`, the links of a many2many
+ * as one `set`, the rest as changes.
+ */
+export declare function newRecordSave(model: string, fields: Fields, values: Values): SaveRequest;

package/src/lib/record/data-source.d.ts

@@ -99,6 +99,121 @@ export interface DataSource {
     exportRecords?(request: ExportRequest): Promise<ExportedFile | {
         message: string;
     } | false>;
+    /**
+     * Make many records at once, each with its own values: a list's Import of
+     * a file's rows, a thousand at a time. Answer for each record asked for,
+     * in its order: the id it was made with, or why it was not made, in the
+     * person's words. Without it, the list saves each in turn (`save` with no
+     * id).
+     */
+    createMany?(request: CreateManyRequest): Promise<CreateManyResult>;
+    /**
+     * Take a list's Import on the server, in place of the browser: a file too
+     * big for one, or a server that imports its own way. Asked once the person
+     * has matched the file's columns to the page's fields, before a row is
+     * checked: answer `{ message }` when the server takes the file (the list
+     * says it: "Your file is being imported: you will get an email"), or
+     * `false` to let the browser import it after all, as it does without this.
+     */
+    importRecords?(request: ImportRequest): Promise<{
+        message: string;
+    } | false>;
+    /**
+     * Records like the one typed, for a page's possible duplicates (`duplicates`): asked a moment after a person stops
+     * typing in a field it names, as a saved record is opened, and as a record is saved — with the fields it names that
+     * hold a value. Answer with the records that have the same phone, email or id, or a name close enough, each with
+     * the fields it matched on; never the record itself. Without it, nothing is asked and nothing shows.
+     */
+    duplicates?(request: DuplicatesRequest): Promise<DuplicatesResult>;
+    /**
+     * Merge records into one, as a person chose on a possible duplicate's Merge: `keepId` kept, holding the values
+     * picked for each field, and `mergeIds` gone. Moving what was theirs — messages, activities, the records that link
+     * to them — to the one kept is the source's work; the page says it will happen. Refuse with `saveRefused` (a `rule`,
+     * with why) and nothing changes. Without it, possible duplicates offer no Merge.
+     */
+    merge?(request: MergeRequest): Promise<MergeResult | void>;
+}
+/** Many records made at once, each with its own values: a list's Import. */
+export interface CreateManyRequest {
+    model: string;
+    /** Each record's values, in the file's order: what its row fills in, and the page's defaults for the rest. Links as `{ id, label }`. */
+    records: Values[];
+    /** The fields' definitions, as a save gets them. */
+    fields: Fields;
+}
+export interface CreateManyResult {
+    /**
+     * One answer for each record asked for, in the same order: the id it was made with, or why it was not made — and,
+     * where the source has it, the problem as a save would throw it (a field's own words). A record left unanswered is
+     * taken as not made.
+     */
+    records: ({
+        id: RecordId;
+    } | {
+        message: string;
+        problem?: SaveProblem;
+    })[];
+}
+/** A file a list's Import hands to the server, its columns matched to the page's fields. */
+export interface ImportRequest {
+    model: string;
+    /** The file as the person picked it: a browser's File fits. */
+    file: UploadFile;
+    /** Each column of the file, in its order — its header's words, and the field it fills, null where it is left out. */
+    columns: {
+        header: string;
+        field: string | null;
+    }[];
+    /** How many rows it holds under its header. */
+    rows: number;
+    /** The fields' definitions, as a save gets them. */
+    fields: Fields;
+    /** The page's language and the order it writes dates in, so a server reads the cells as the page would. */
+    locale: string;
+    dateOrder: 'dmy' | 'mdy' | 'ymd';
+}
+/** Records like the one typed: what `duplicates` is asked. */
+export interface DuplicatesRequest {
+    model: string;
+    /** The record typed, never its own duplicate; null while it is new. */
+    recordId: RecordId | null;
+    /** Every value of the form, as typed: a phone kept as E.164 where the page reads phones the world over. */
+    values: Values;
+    /** The fields to compare it by, by name: those the page names (`duplicates.fields`) that hold a value now. */
+    fields: string[];
+}
+/** A record like the one typed. */
+export interface DuplicateMatch {
+    id: RecordId;
+    /** Its name, as people know it: "Nile Traders". */
+    name: string;
+    /**
+     * What it matched on: the names of the fields asked that it holds the same (`phone`, `email`), or a name close to
+     * the one typed (the name's field). Each is said under that field's box; words of the source's own ("the same
+     * address") are said as they are.
+     */
+    why: string[];
+    /** How alike, from 0 to 1, where the source tells: the likest first. */
+    score?: number;
+}
+export interface DuplicatesResult {
+    matches: DuplicateMatch[];
+}
+/** Records merged into one: what `merge` is asked. */
+export interface MergeRequest {
+    model: string;
+    /** The record kept. */
+    keepId: RecordId;
+    /** The records merged into it, then gone. */
+    mergeIds: RecordId[];
+    /** The kept record's values, as picked on the merge's screen for each field the records held apart. */
+    values: Values;
+    /** The page's fields, so the source knows each link's model, as a save does. */
+    fields: Fields;
+}
+/** What a merge may tell: words of the source's own about it, said once it is done ("4 messages moved"). */
+export interface MergeResult {
+    message?: string;
 }
 /** The same value written in a field of each record: a list's bulk edit. */
 export interface WriteManyRequest {
@@ -629,3 +744,9 @@ export interface SlotsResult {
     /** The minutes a booking lasts, when the source knows better than the page: the service's own length. */
     length?: number;
 }
+/**
+ * A new record's save, made from its values alone — as a list's Import saves a row where the source has no
+ * `createMany`, and a memory source makes each of `createMany`'s: every value in `values`, the links of a many2many
+ * as one `set`, the rest as changes.
+ */
+export declare function newRecordSave(model: string, fields: Fields, values: Values): SaveRequest;

package/src/lib/record/data-source.js

@@ -5,6 +5,7 @@ exports.loadedRecord = loadedRecord;
 exports.loadedRecordOf = loadedRecordOf;
 exports.saveRefused = saveRefused;
 exports.saveProblemOf = saveProblemOf;
+exports.newRecordSave = newRecordSave;
 /** What `load` returns to tell a record's version, or what this person may do with it, beside its values. */
 function loadedRecord(values, more = {}) {
     return { $loaded: true, values, ...(more.version ? { version: more.version } : {}), ...(more.can ? { can: more.can } : {}) };
@@ -45,4 +46,19 @@ function saveProblemOf(error) {
         return { kind: 'network', message };
     return { kind: 'other', message };
 }
+/**
+ * A new record's save, made from its values alone — as a list's Import saves a row where the source has no
+ * `createMany`, and a memory source makes each of `createMany`'s: every value in `values`, the links of a many2many
+ * as one `set`, the rest as changes.
+ */
+function newRecordSave(model, fields, values) {
+    const changes = { values: {}, lines: {}, links: {} };
+    for (const [name, value] of Object.entries(values)) {
+        if (fields[name]?.type === 'many2many')
+            changes.links[name] = [{ op: 'set', ids: Array.isArray(value) ? value.map((record) => record.id) : [] }];
+        else
+            changes.values[name] = value;
+    }
+    return { model, id: null, fields, changes, values };
+}
 //# sourceMappingURL=data-source.js.map

package/src/lib/record/data-source.js.map

@@ -1 +1 @@
-{"version":3,"file":"data-source.js","sourceRoot":"","sources":["../../../../../../libs/core/src/lib/record/data-source.ts"],"names":[],"mappings":";;;AA6MA,oCAEC;AAGD,wCAGC;AAwYD,kCAEC;AAGD,sCAMC;AA5ZD,6GAA6G;AAC7G,SAAgB,YAAY,CAAC,MAAc,EAAE,OAA6D,EAAE;IAC1G,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;AAC/H,CAAC;AAED,6HAA6H;AAC7H,SAAgB,cAAc,CAAC,MAA6B;IAC1D,MAAM,MAAM,GAAG,MAA+B,CAAC;IAC/C,OAAO,MAAM,CAAC,OAAO,KAAK,IAAI,IAAI,MAAM,CAAC,MAAM,KAAK,IAAI,IAAI,OAAO,MAAM,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAE,MAAuB,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAgB,EAAE,CAAC;AACzK,CAAC;AAsXD;;;;;GAKG;AACH,MAAa,aAAc,SAAQ,KAAK;IAC7B,QAAQ,CAAe;IACvB,OAAO,CAAc;IAC9B,YAAY,QAAsB,EAAE,OAAO,GAAG,sDAAsD;QAClG,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;QAC5B,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,OAAO,GAAG,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC;IACzD,CAAC;CACF;AATD,sCASC;AAED,8EAA8E;AAC9E,SAAgB,WAAW,CAAC,OAAoB;IAC9C,OAAO,MAAM,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;AAChE,CAAC;AAED,wGAAwG;AACxG,SAAgB,aAAa,CAAC,KAAc;IAC1C,MAAM,OAAO,GAAI,KAA0C,EAAE,OAAO,CAAC;IACrE,IAAI,OAAO,IAAI,OAAO,OAAO,CAAC,IAAI,KAAK,QAAQ;QAAE,OAAO,OAAO,CAAC;IAChE,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACvE,IAAI,KAAK,YAAY,SAAS,IAAI,4BAA4B,CAAC,IAAI,CAAC,OAAO,CAAC;QAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC;IAClH,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;AACpC,CAAC"}
+{"version":3,"file":"data-source.js","sourceRoot":"","sources":["../../../../../../libs/core/src/lib/record/data-source.ts"],"names":[],"mappings":"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"}

package/src/lib/record/data-source.mjs

@@ -37,4 +37,19 @@ export function saveProblemOf(error) {
         return { kind: 'network', message };
     return { kind: 'other', message };
 }
+/**
+ * A new record's save, made from its values alone — as a list's Import saves a row where the source has no
+ * `createMany`, and a memory source makes each of `createMany`'s: every value in `values`, the links of a many2many
+ * as one `set`, the rest as changes.
+ */
+export function newRecordSave(model, fields, values) {
+    const changes = { values: {}, lines: {}, links: {} };
+    for (const [name, value] of Object.entries(values)) {
+        if (fields[name]?.type === 'many2many')
+            changes.links[name] = [{ op: 'set', ids: Array.isArray(value) ? value.map((record) => record.id) : [] }];
+        else
+            changes.values[name] = value;
+    }
+    return { model, id: null, fields, changes, values };
+}
 //# sourceMappingURL=data-source.mjs.map

package/src/lib/record/data-source.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"data-source.mjs","sourceRoot":"","sources":["../../../../../../libs/core/src/lib/record/data-source.ts"],"names":[],"mappings":"AA4MA,6GAA6G;AAC7G,MAAM,UAAU,YAAY,CAAC,MAAc,EAAE,OAA6D,EAAE;IAC1G,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;AAC/H,CAAC;AAED,6HAA6H;AAC7H,MAAM,UAAU,cAAc,CAAC,MAA6B;IAC1D,MAAM,MAAM,GAAG,MAA+B,CAAC;IAC/C,OAAO,MAAM,CAAC,OAAO,KAAK,IAAI,IAAI,MAAM,CAAC,MAAM,KAAK,IAAI,IAAI,OAAO,MAAM,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAE,MAAuB,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAgB,EAAE,CAAC;AACzK,CAAC;AAsXD;;;;;GAKG;AACH,MAAM,OAAO,aAAc,SAAQ,KAAK;IAC7B,QAAQ,CAAe;IACvB,OAAO,CAAc;IAC9B,YAAY,QAAsB,EAAE,OAAO,GAAG,sDAAsD;QAClG,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;QAC5B,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,OAAO,GAAG,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC;IACzD,CAAC;CACF;AAED,8EAA8E;AAC9E,MAAM,UAAU,WAAW,CAAC,OAAoB;IAC9C,OAAO,MAAM,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;AAChE,CAAC;AAED,wGAAwG;AACxG,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,MAAM,OAAO,GAAI,KAA0C,EAAE,OAAO,CAAC;IACrE,IAAI,OAAO,IAAI,OAAO,OAAO,CAAC,IAAI,KAAK,QAAQ;QAAE,OAAO,OAAO,CAAC;IAChE,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACvE,IAAI,KAAK,YAAY,SAAS,IAAI,4BAA4B,CAAC,IAAI,CAAC,OAAO,CAAC;QAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC;IAClH,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;AACpC,CAAC"}
+{"version":3,"file":"data-source.mjs","sourceRoot":"","sources":["../../../../../../libs/core/src/lib/record/data-source.ts"],"names":[],"mappings":"AA6TA,6GAA6G;AAC7G,MAAM,UAAU,YAAY,CAAC,MAAc,EAAE,OAA6D,EAAE;IAC1G,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;AAC/H,CAAC;AAED,6HAA6H;AAC7H,MAAM,UAAU,cAAc,CAAC,MAA6B;IAC1D,MAAM,MAAM,GAAG,MAA+B,CAAC;IAC/C,OAAO,MAAM,CAAC,OAAO,KAAK,IAAI,IAAI,MAAM,CAAC,MAAM,KAAK,IAAI,IAAI,OAAO,MAAM,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAE,MAAuB,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAgB,EAAE,CAAC;AACzK,CAAC;AAsXD;;;;;GAKG;AACH,MAAM,OAAO,aAAc,SAAQ,KAAK;IAC7B,QAAQ,CAAe;IACvB,OAAO,CAAc;IAC9B,YAAY,QAAsB,EAAE,OAAO,GAAG,sDAAsD;QAClG,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;QAC5B,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,OAAO,GAAG,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC;IACzD,CAAC;CACF;AAED,8EAA8E;AAC9E,MAAM,UAAU,WAAW,CAAC,OAAoB;IAC9C,OAAO,MAAM,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;AAChE,CAAC;AAED,wGAAwG;AACxG,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,MAAM,OAAO,GAAI,KAA0C,EAAE,OAAO,CAAC;IACrE,IAAI,OAAO,IAAI,OAAO,OAAO,CAAC,IAAI,KAAK,QAAQ;QAAE,OAAO,OAAO,CAAC;IAChE,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACvE,IAAI,KAAK,YAAY,SAAS,IAAI,4BAA4B,CAAC,IAAI,CAAC,OAAO,CAAC;QAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC;IAClH,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;AACpC,CAAC;AA2CD;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,KAAa,EAAE,MAAc,EAAE,MAAc;IACzE,MAAM,OAAO,GAAkB,EAAE,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;IACpE,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QACnD,IAAI,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,KAAK,WAAW;YAAE,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAE,KAAyB,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;;YACjK,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC;IACpC,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;AACtD,CAAC"}

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

@@ -4,7 +4,8 @@ import type { Page } from '../format/page.mjs';
 import type { JsonValue } from '../format/json.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 SaveProblem, type BotReport, type SlotsResult, type UploadFile } 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 } from './data-source.mjs';
+import { type WaitsFor } from './waits.mjs';
 import { type FileUpload, type UploadHow } from './uploads.mjs';
 import { type Scheduler } from './scheduler.mjs';
 import { type ActionHost, type ActionRequest, type ActionResult, type OnAction, type PostedMessage, type RunContext, type RunResult } from './run.mjs';
@@ -327,6 +328,14 @@ export interface Form {
     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;
+    /**
+     * What a value worked out from others waits for while one of them holds text that does not read (`unread`): a
+     * total of the page's own (`compute`) over a table whose line says "abc" in its Quantity, or an amount the app
+     * works out as the lines change (read-only, from a source with an onchange) — the line, as people count them, and
+     * its cell. Shown, it is a dash said in words, as the table's own total waits: never an amount worked out from the
+     * value that text replaced. Null when it shows its value.
+     */
+    waitsFor(field: string): WaitsFor | null;
     /**
      * Keep text a person left in a box that does not read (`FormState.unread`), by its path — `field`, or a line's
      * `field.lineKey.subfield` — with why in words; null once it reads, or is let go. Nothing is shown until the box
@@ -424,6 +433,12 @@ export interface Form {
      * (docs/plans/wave1-contract.md, section 10, part 2).
      */
     recordShown(): () => boolean;
+    /**
+     * What a related list (a `related` part, by its id) asks the data source's `list` for, on the record shown: the
+     * records whose link is this record, and that its own `filter` lets through, each `valueFrom` read from this record.
+     * Null before the record's first save — nothing points at it yet — and for no related list of that id.
+     */
+    relatedFilter(id: string): ResolvedFilter[] | null;
     /**
      * Post words in the record's conversation, as a `post` step does: through
      * the form's host when it has a way to, else told to the form's own
@@ -532,6 +547,13 @@ 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;
+    /**
+     * 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
+     * the form does not hold, such as a list's rows (their `rowTones`, `rowBold` and `rowButtons`). Of another model — a
+     * related list's rows — with that model's `fields` (the related list's own).
+     */
+    recordReads(id: RecordId | null, values: Values, fields?: Record<string, Field | LineField>): Record<string, unknown>;
     /** Whether a date and time drawn as booking slots can ask for its free times: the data source has `slots`. */
     canFindSlots(): boolean;
     /**
@@ -546,6 +568,28 @@ export interface Form {
         length?: number;
         between?: number;
     }): Promise<SlotsResult>;
+    /** Whether the page asks for possible duplicates: a record's page naming fields in `duplicates`, its source with `duplicates`. */
+    canFindDuplicates(): boolean;
+    /**
+     * Records like the one shown, asked of the data source's `duplicates` with the fields the page names that hold a
+     * value now — none, and nothing is asked — and every value of the form: the matches, the likest first where the
+     * source scores them, never the record itself. Rejects where the source has no `duplicates`. Its answer is for the
+     * record shown as it was asked (`recordShown`).
+     */
+    findDuplicates(): Promise<DuplicateMatch[]>;
+    /** 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. */
+    readRecord(id: RecordId): Promise<Values>;
+    /**
+     * Merge records of the page's model into one through the source's `merge`: `keepId` kept with `values`, `mergeIds`
+     * gone. The form is left as it is: show the record kept (`openRecord`, `load`) once it is done.
+     */
+    merge(request: {
+        keepId: RecordId;
+        mergeIds: RecordId[];
+        values: Values;
+    }): Promise<MergeResult | void>;
     /**
      * Store files picked for a file or picture field — or a field on a table's
      * line (`how.line`) — through the data source's `upload`, each as soon as

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

@@ -4,7 +4,8 @@ import type { Page } from '../format/page';
 import type { JsonValue } from '../format/json';
 import { type FieldTone, type LineState } from './cells';
 import { type Messages } from './messages';
-import { type DataSource, type RecordChanges, type RecordPermissions, type RecordVersion, type SaveProblem, type BotReport, type SlotsResult, type UploadFile } from './data-source';
+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';
+import { type WaitsFor } from './waits';
 import { type FileUpload, type UploadHow } from './uploads';
 import { type Scheduler } from './scheduler';
 import { type ActionHost, type ActionRequest, type ActionResult, type OnAction, type PostedMessage, type RunContext, type RunResult } from './run';
@@ -327,6 +328,14 @@ export interface Form {
     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;
+    /**
+     * What a value worked out from others waits for while one of them holds text that does not read (`unread`): a
+     * total of the page's own (`compute`) over a table whose line says "abc" in its Quantity, or an amount the app
+     * works out as the lines change (read-only, from a source with an onchange) — the line, as people count them, and
+     * its cell. Shown, it is a dash said in words, as the table's own total waits: never an amount worked out from the
+     * value that text replaced. Null when it shows its value.
+     */
+    waitsFor(field: string): WaitsFor | null;
     /**
      * Keep text a person left in a box that does not read (`FormState.unread`), by its path — `field`, or a line's
      * `field.lineKey.subfield` — with why in words; null once it reads, or is let go. Nothing is shown until the box
@@ -424,6 +433,12 @@ export interface Form {
      * (docs/plans/wave1-contract.md, section 10, part 2).
      */
     recordShown(): () => boolean;
+    /**
+     * What a related list (a `related` part, by its id) asks the data source's `list` for, on the record shown: the
+     * records whose link is this record, and that its own `filter` lets through, each `valueFrom` read from this record.
+     * Null before the record's first save — nothing points at it yet — and for no related list of that id.
+     */
+    relatedFilter(id: string): ResolvedFilter[] | null;
     /**
      * Post words in the record's conversation, as a `post` step does: through
      * the form's host when it has a way to, else told to the form's own
@@ -532,6 +547,13 @@ 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;
+    /**
+     * 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
+     * the form does not hold, such as a list's rows (their `rowTones`, `rowBold` and `rowButtons`). Of another model — a
+     * related list's rows — with that model's `fields` (the related list's own).
+     */
+    recordReads(id: RecordId | null, values: Values, fields?: Record<string, Field | LineField>): Record<string, unknown>;
     /** Whether a date and time drawn as booking slots can ask for its free times: the data source has `slots`. */
     canFindSlots(): boolean;
     /**
@@ -546,6 +568,28 @@ export interface Form {
         length?: number;
         between?: number;
     }): Promise<SlotsResult>;
+    /** Whether the page asks for possible duplicates: a record's page naming fields in `duplicates`, its source with `duplicates`. */
+    canFindDuplicates(): boolean;
+    /**
+     * Records like the one shown, asked of the data source's `duplicates` with the fields the page names that hold a
+     * value now — none, and nothing is asked — and every value of the form: the matches, the likest first where the
+     * source scores them, never the record itself. Rejects where the source has no `duplicates`. Its answer is for the
+     * record shown as it was asked (`recordShown`).
+     */
+    findDuplicates(): Promise<DuplicateMatch[]>;
+    /** 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. */
+    readRecord(id: RecordId): Promise<Values>;
+    /**
+     * Merge records of the page's model into one through the source's `merge`: `keepId` kept with `values`, `mergeIds`
+     * gone. The form is left as it is: show the record kept (`openRecord`, `load`) once it is done.
+     */
+    merge(request: {
+        keepId: RecordId;
+        mergeIds: RecordId[];
+        values: Values;
+    }): Promise<MergeResult | void>;
     /**
      * Store files picked for a file or picture field — or a field on a table's
      * line (`how.line`) — through the data source's `upload`, each as soon as