@fieldia/core 0.27.0 → 0.29.0

package/src/lib/record/memory-clusters.js

@@ -0,0 +1,83 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.gridClusters = gridClusters;
+const filter_1 = require("./filter");
+const values_1 = require("./values");
+/**
+ * How a memory source answers `clusters` (its `clusters` option), for demos and tests: as a server gathers a map's
+ * records by a grid. The records the search finds in the view, each put in a square of the world as the map draws it
+ * at its zoom — `radius` pixels a side, the squares fixed to the world, so a record keeps its square as the map pans —
+ * and each square holding two or more one bubble: their middle, their count, the box they lie in (and their `weight`,
+ * added up, where asked). A square holding one is that record, standing alone, as a list's row gives it (the memory
+ * source's `row`: the fields asked, as this person may read them). Those the search finds with no place are counted
+ * (`unplaced`). `models` names the models it gathers; a map of any other is answered `false`, and loads its records as
+ * without it. A map that moved on (`signal`) is refused with an AbortError. Outside the one-tag script, as
+ * `alikeRecords` is.
+ *
+ *   createMemoryDataSource({ records, clusters: gridClusters({ models: ['home'] }) })
+ */
+function gridClusters(how = {}) {
+    return (request, records, row = (id, values) => ({ id, values: Object.fromEntries(request.fields.map((field) => [field, (0, values_1.structuredCopy)(values[field] ?? null)])) })) => {
+        if (request.signal?.aborted)
+            throw Object.assign(new Error('The map moved on'), { name: 'AbortError' });
+        if (how.models && !how.models.includes(request.model))
+            return false;
+        const world = 256 * 2 ** request.zoom;
+        const side = Math.max(1, request.radius);
+        const squares = new Map();
+        let unplaced = 0;
+        for (const [key, values] of Object.entries(records[request.model] ?? {})) {
+            const id = Number.isFinite(Number(key)) ? Number(key) : key;
+            if (request.filter.length && !(0, filter_1.matchesFilter)({ id, ...values }, request.filter))
+                continue;
+            const at = (0, filter_1.placeOf)(values, values[request.field], request.longitude);
+            if (!at || Math.abs(at.lat) > 90 || Math.abs(at.lng) > 180) {
+                unplaced++;
+                continue;
+            }
+            if (!inBox(at, request.bbox))
+                continue;
+            // Where it is drawn at this zoom (Web Mercator), in the world's pixels, then its square.
+            const sin = Math.min(0.9999, Math.max(-0.9999, Math.sin((at.lat * Math.PI) / 180)));
+            const x = ((at.lng + 180) / 360) * world;
+            const y = (0.5 - Math.log((1 + sin) / (1 - sin)) / (4 * Math.PI)) * world;
+            const name = `${Math.floor(x / side)}:${Math.floor(y / side)}`;
+            const square = squares.get(name);
+            const weight = request.weight ? Number(values[request.weight]) : 0;
+            const weighs = Number.isFinite(weight) ? weight : 0;
+            if (!square)
+                squares.set(name, { first: { id, values }, count: 1, lat: at.lat, lng: at.lng, box: { south: at.lat, west: at.lng, north: at.lat, east: at.lng }, weight: weighs });
+            else {
+                square.count++;
+                square.lat += at.lat;
+                square.lng += at.lng;
+                square.weight += weighs;
+                square.box = { south: Math.min(square.box.south, at.lat), west: Math.min(square.box.west, at.lng), north: Math.max(square.box.north, at.lat), east: Math.max(square.box.east, at.lng) };
+            }
+        }
+        const clusters = [];
+        const points = [];
+        for (const square of squares.values()) {
+            if (square.count === 1) {
+                points.push(row(square.first.id, square.first.values));
+                continue;
+            }
+            const round = (n) => Math.round(n * 1e6) / 1e6;
+            clusters.push({
+                lat: round(square.lat / square.count),
+                lng: round(square.lng / square.count),
+                count: square.count,
+                bbox: square.box,
+                ...(request.weight ? { weight: square.weight } : {}),
+            });
+        }
+        return { clusters, points, unplaced };
+    };
+}
+/** Whether a place lies in a box, its edges included: west beyond east crossing the antimeridian. */
+function inBox(at, box) {
+    if (at.lat < box.south || at.lat > box.north)
+        return false;
+    return box.west <= box.east ? at.lng >= box.west && at.lng <= box.east : at.lng >= box.west || at.lng <= box.east;
+}
+//# sourceMappingURL=memory-clusters.js.map

package/src/lib/record/memory-clusters.js.map

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

package/src/lib/record/memory-clusters.mjs

@@ -0,0 +1,80 @@
+import { matchesFilter, placeOf } from './filter.mjs';
+import { structuredCopy } from './values.mjs';
+/**
+ * How a memory source answers `clusters` (its `clusters` option), for demos and tests: as a server gathers a map's
+ * records by a grid. The records the search finds in the view, each put in a square of the world as the map draws it
+ * at its zoom — `radius` pixels a side, the squares fixed to the world, so a record keeps its square as the map pans —
+ * and each square holding two or more one bubble: their middle, their count, the box they lie in (and their `weight`,
+ * added up, where asked). A square holding one is that record, standing alone, as a list's row gives it (the memory
+ * source's `row`: the fields asked, as this person may read them). Those the search finds with no place are counted
+ * (`unplaced`). `models` names the models it gathers; a map of any other is answered `false`, and loads its records as
+ * without it. A map that moved on (`signal`) is refused with an AbortError. Outside the one-tag script, as
+ * `alikeRecords` is.
+ *
+ *   createMemoryDataSource({ records, clusters: gridClusters({ models: ['home'] }) })
+ */
+export function gridClusters(how = {}) {
+    return (request, records, row = (id, values) => ({ id, values: Object.fromEntries(request.fields.map((field) => [field, structuredCopy(values[field] ?? null)])) })) => {
+        if (request.signal?.aborted)
+            throw Object.assign(new Error('The map moved on'), { name: 'AbortError' });
+        if (how.models && !how.models.includes(request.model))
+            return false;
+        const world = 256 * 2 ** request.zoom;
+        const side = Math.max(1, request.radius);
+        const squares = new Map();
+        let unplaced = 0;
+        for (const [key, values] of Object.entries(records[request.model] ?? {})) {
+            const id = Number.isFinite(Number(key)) ? Number(key) : key;
+            if (request.filter.length && !matchesFilter({ id, ...values }, request.filter))
+                continue;
+            const at = placeOf(values, values[request.field], request.longitude);
+            if (!at || Math.abs(at.lat) > 90 || Math.abs(at.lng) > 180) {
+                unplaced++;
+                continue;
+            }
+            if (!inBox(at, request.bbox))
+                continue;
+            // Where it is drawn at this zoom (Web Mercator), in the world's pixels, then its square.
+            const sin = Math.min(0.9999, Math.max(-0.9999, Math.sin((at.lat * Math.PI) / 180)));
+            const x = ((at.lng + 180) / 360) * world;
+            const y = (0.5 - Math.log((1 + sin) / (1 - sin)) / (4 * Math.PI)) * world;
+            const name = `${Math.floor(x / side)}:${Math.floor(y / side)}`;
+            const square = squares.get(name);
+            const weight = request.weight ? Number(values[request.weight]) : 0;
+            const weighs = Number.isFinite(weight) ? weight : 0;
+            if (!square)
+                squares.set(name, { first: { id, values }, count: 1, lat: at.lat, lng: at.lng, box: { south: at.lat, west: at.lng, north: at.lat, east: at.lng }, weight: weighs });
+            else {
+                square.count++;
+                square.lat += at.lat;
+                square.lng += at.lng;
+                square.weight += weighs;
+                square.box = { south: Math.min(square.box.south, at.lat), west: Math.min(square.box.west, at.lng), north: Math.max(square.box.north, at.lat), east: Math.max(square.box.east, at.lng) };
+            }
+        }
+        const clusters = [];
+        const points = [];
+        for (const square of squares.values()) {
+            if (square.count === 1) {
+                points.push(row(square.first.id, square.first.values));
+                continue;
+            }
+            const round = (n) => Math.round(n * 1e6) / 1e6;
+            clusters.push({
+                lat: round(square.lat / square.count),
+                lng: round(square.lng / square.count),
+                count: square.count,
+                bbox: square.box,
+                ...(request.weight ? { weight: square.weight } : {}),
+            });
+        }
+        return { clusters, points, unplaced };
+    };
+}
+/** Whether a place lies in a box, its edges included: west beyond east crossing the antimeridian. */
+function inBox(at, box) {
+    if (at.lat < box.south || at.lat > box.north)
+        return false;
+    return box.west <= box.east ? at.lng >= box.west && at.lng <= box.east : at.lng >= box.west || at.lng <= box.east;
+}
+//# sourceMappingURL=memory-clusters.mjs.map

package/src/lib/record/memory-clusters.mjs.map

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

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

@@ -1,7 +1,8 @@
 import type { Option, PropertyDefinition } from '../format/field.mjs';
-import type { DataSource, OptionsRequest, SubmitRequest, SubmitResult, RecordPermissions, RecordVersion, UploadFile, SlotsRequest, SlotsResult, DuplicatesRequest, DuplicatesResult, LimitsResult, StoredDraft, SaveDraftRequest } from './data-source.mjs';
+import type { DataSource, OptionsRequest, SubmitRequest, SubmitResult, ListedRecord, RecordPermissions, RecordVersion, UploadFile, SlotsRequest, SlotsResult, DuplicatesRequest, DuplicatesResult, LimitsResult, StoredDraft, SaveDraftRequest, ApprovalEntry, SuggestRequest, SuggestResult, RewriteRequest, RewriteResult, SearchToFilterRequest, SearchToFilterResult, ClustersRequest, ClustersResult } from './data-source.mjs';
 import { type Scheduler } from './scheduler.mjs';
 import { type MemoryKept } from './memory-kept.mjs';
+import { type MemoryApprovalRoute } from './memory-approvals.mjs';
 import { type FileValue, type RecordId, type Values } from './values.mjs';
 export interface MemoryDataSourceOptions {
     /** Records by model, then by id. */
@@ -114,14 +115,52 @@ export interface MemoryDataSourceOptions {
     }>;
     /** The link "Continue later" answers with, made from the draft's key — the app's own address with it: none without it. */
     draftLink?: (key: string, request: SaveDraftRequest) => string;
+    /**
+     * How `approvals` answers, by model: the way a record is approved — its levels, who may approve each, any one or all
+     * of them, in turn or together, and whether it is sent for approval now — worked out from the record; null where it
+     * needs none (an order under its limit). The source keeps each decision as an approval engine would and works out
+     * where each level stands; the person deciding is the form's `user`, matched to an approver by id, else by name.
+     * Without it, no record needs approval.
+     */
+    approvals?: Record<string, (values: Values, id: RecordId) => MemoryApprovalRoute | null | undefined>;
+    /** Each record's approval history to start from, by `model:id`, oldest first: what was decided before. */
+    approvalHistory?: Record<string, ApprovalEntry[]>;
+    /**
+     * The language a text kept in several (`{ ar, en }`) is read in where this source says it as one — a link's name, a
+     * list's order — as an app's server reads it in its person's language: their tag ("ar"), the first typed where it has
+     * none in it, or where this is left out. A search finds a link by its name in any of its languages.
+     */
+    language?: string;
+    /**
+     * What answers AI help, from the records the source keeps — `assistStandIn()` is a stand-in with no model, reading
+     * words by their patterns, for demos and tests. Each member given makes the source's member of that name; without
+     * it the source has none, so what asks for it is hidden, as with any source.
+     */
+    assist?: MemoryAssist;
+    /**
+     * How `clusters` answers: a list's map's records gathered where they crowd, worked out from the records the source
+     * keeps — `gridClusters()` gathers them by a grid, as a server does — or `false` for the map to load them and gather
+     * them itself. `row` gives a record standing alone as a list's row is: the fields asked, as this person may read
+     * them. Without it, the source has no `clusters`, and every map gathers its records in the browser.
+     */
+    clusters?: (request: ClustersRequest, records: Readonly<Record<string, Record<string, Values>>>, row: (id: RecordId, values: Values) => ListedRecord) => ClustersResult | false | Promise<ClustersResult | false>;
+}
+/** What a memory source's AI help answers with (`MemoryDataSourceOptions.assist`): each given, from its records. */
+export interface MemoryAssist {
+    suggest?(request: SuggestRequest, records: Readonly<Record<string, Record<string, Values>>>): SuggestResult | Promise<SuggestResult>;
+    rewrite?(request: RewriteRequest, records: Readonly<Record<string, Record<string, Values>>>): RewriteResult | Promise<RewriteResult>;
+    searchToFilter?(request: SearchToFilterRequest, records: Readonly<Record<string, Record<string, Values>>>): SearchToFilterResult | Promise<SearchToFilterResult>;
 }
+/** The members of AI help a memory source has only where its `assist` answers them. */
+type AssistMembers = 'suggest' | 'rewrite' | 'searchToFilter';
 /**
  * Every member of a data source but `exportRecords` and `importRecords`: a
  * memory source leaves an export and an import to the browser, as a source
  * without a server of its own does. A test or a demo gives it one by setting
- * it.
+ * it. AI help's (`suggest`, `rewrite`, `searchToFilter`) where its `assist`
+ * option answers them. `clusters` is there where its option says how it answers.
  */
-export interface MemoryDataSource extends Required<Omit<DataSource, 'exportRecords' | 'importRecords'>>, Pick<DataSource, 'exportRecords' | 'importRecords'> {
+export interface MemoryDataSource extends Required<Omit<DataSource, 'exportRecords' | 'importRecords' | AssistMembers | 'clusters'>>, Pick<DataSource, 'exportRecords' | 'importRecords' | AssistMembers | 'clusters'> {
     readonly records: Record<string, Record<string, Values>>;
     /**
      * The records said to be someone else for one another, by model: each pair of ids, in the order kept, through
@@ -158,3 +197,4 @@ export interface MemoryDataSource extends Required<Omit<DataSource, 'exportRecor
 export declare function createMemoryDataSource(options?: MemoryDataSourceOptions): MemoryDataSource;
 /** A memory source's members, working on what it keeps (`memoryKept`): the one-tag script's memory part. */
 export declare function memorySource(options: MemoryDataSourceOptions, kept: MemoryKept): MemoryDataSource;
+export {};

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

@@ -1,7 +1,8 @@
 import type { Option, PropertyDefinition } from '../format/field';
-import type { DataSource, OptionsRequest, SubmitRequest, SubmitResult, RecordPermissions, RecordVersion, UploadFile, SlotsRequest, SlotsResult, DuplicatesRequest, DuplicatesResult, LimitsResult, StoredDraft, SaveDraftRequest } from './data-source';
+import type { DataSource, OptionsRequest, SubmitRequest, SubmitResult, ListedRecord, RecordPermissions, RecordVersion, UploadFile, SlotsRequest, SlotsResult, DuplicatesRequest, DuplicatesResult, LimitsResult, StoredDraft, SaveDraftRequest, ApprovalEntry, SuggestRequest, SuggestResult, RewriteRequest, RewriteResult, SearchToFilterRequest, SearchToFilterResult, ClustersRequest, ClustersResult } from './data-source';
 import { type Scheduler } from './scheduler';
 import { type MemoryKept } from './memory-kept';
+import { type MemoryApprovalRoute } from './memory-approvals';
 import { type FileValue, type RecordId, type Values } from './values';
 export interface MemoryDataSourceOptions {
     /** Records by model, then by id. */
@@ -114,14 +115,52 @@ export interface MemoryDataSourceOptions {
     }>;
     /** The link "Continue later" answers with, made from the draft's key — the app's own address with it: none without it. */
     draftLink?: (key: string, request: SaveDraftRequest) => string;
+    /**
+     * How `approvals` answers, by model: the way a record is approved — its levels, who may approve each, any one or all
+     * of them, in turn or together, and whether it is sent for approval now — worked out from the record; null where it
+     * needs none (an order under its limit). The source keeps each decision as an approval engine would and works out
+     * where each level stands; the person deciding is the form's `user`, matched to an approver by id, else by name.
+     * Without it, no record needs approval.
+     */
+    approvals?: Record<string, (values: Values, id: RecordId) => MemoryApprovalRoute | null | undefined>;
+    /** Each record's approval history to start from, by `model:id`, oldest first: what was decided before. */
+    approvalHistory?: Record<string, ApprovalEntry[]>;
+    /**
+     * The language a text kept in several (`{ ar, en }`) is read in where this source says it as one — a link's name, a
+     * list's order — as an app's server reads it in its person's language: their tag ("ar"), the first typed where it has
+     * none in it, or where this is left out. A search finds a link by its name in any of its languages.
+     */
+    language?: string;
+    /**
+     * What answers AI help, from the records the source keeps — `assistStandIn()` is a stand-in with no model, reading
+     * words by their patterns, for demos and tests. Each member given makes the source's member of that name; without
+     * it the source has none, so what asks for it is hidden, as with any source.
+     */
+    assist?: MemoryAssist;
+    /**
+     * How `clusters` answers: a list's map's records gathered where they crowd, worked out from the records the source
+     * keeps — `gridClusters()` gathers them by a grid, as a server does — or `false` for the map to load them and gather
+     * them itself. `row` gives a record standing alone as a list's row is: the fields asked, as this person may read
+     * them. Without it, the source has no `clusters`, and every map gathers its records in the browser.
+     */
+    clusters?: (request: ClustersRequest, records: Readonly<Record<string, Record<string, Values>>>, row: (id: RecordId, values: Values) => ListedRecord) => ClustersResult | false | Promise<ClustersResult | false>;
+}
+/** What a memory source's AI help answers with (`MemoryDataSourceOptions.assist`): each given, from its records. */
+export interface MemoryAssist {
+    suggest?(request: SuggestRequest, records: Readonly<Record<string, Record<string, Values>>>): SuggestResult | Promise<SuggestResult>;
+    rewrite?(request: RewriteRequest, records: Readonly<Record<string, Record<string, Values>>>): RewriteResult | Promise<RewriteResult>;
+    searchToFilter?(request: SearchToFilterRequest, records: Readonly<Record<string, Record<string, Values>>>): SearchToFilterResult | Promise<SearchToFilterResult>;
 }
+/** The members of AI help a memory source has only where its `assist` answers them. */
+type AssistMembers = 'suggest' | 'rewrite' | 'searchToFilter';
 /**
  * Every member of a data source but `exportRecords` and `importRecords`: a
  * memory source leaves an export and an import to the browser, as a source
  * without a server of its own does. A test or a demo gives it one by setting
- * it.
+ * it. AI help's (`suggest`, `rewrite`, `searchToFilter`) where its `assist`
+ * option answers them. `clusters` is there where its option says how it answers.
  */
-export interface MemoryDataSource extends Required<Omit<DataSource, 'exportRecords' | 'importRecords'>>, Pick<DataSource, 'exportRecords' | 'importRecords'> {
+export interface MemoryDataSource extends Required<Omit<DataSource, 'exportRecords' | 'importRecords' | AssistMembers | 'clusters'>>, Pick<DataSource, 'exportRecords' | 'importRecords' | AssistMembers | 'clusters'> {
     readonly records: Record<string, Record<string, Values>>;
     /**
      * The records said to be someone else for one another, by model: each pair of ids, in the order kept, through
@@ -158,3 +197,4 @@ export interface MemoryDataSource extends Required<Omit<DataSource, 'exportRecor
 export declare function createMemoryDataSource(options?: MemoryDataSourceOptions): MemoryDataSource;
 /** A memory source's members, working on what it keeps (`memoryKept`): the one-tag script's memory part. */
 export declare function memorySource(options: MemoryDataSourceOptions, kept: MemoryKept): MemoryDataSource;
+export {};

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

@@ -8,6 +8,7 @@ const filter_1 = require("./filter");
 const periods_1 = require("./periods");
 const scheduler_1 = require("./scheduler");
 const memory_kept_1 = require("./memory-kept");
+const memory_approvals_1 = require("./memory-approvals");
 const values_1 = require("./values");
 /**
  * A data source that keeps everything in memory. It implements the whole
@@ -21,6 +22,14 @@ function createMemoryDataSource(options = {}) {
 function memorySource(options, kept) {
     const { records, notDuplicatePairs, responses, calls, elsewhere, drafts, table, versionOf, moveOn } = kept;
     let draftIds = 0;
+    /** A record's approvals, as an approval engine keeps them (memory-approvals.ts). */
+    const approving = (0, memory_approvals_1.memoryApprovals)({
+        routes: options.approvals,
+        history: options.approvalHistory,
+        table,
+        moved: (model, id, by) => (options.versions ? moveOn(model, id, by) : undefined),
+        now: () => new Date().toISOString(),
+    });
     /** Properties added in place, by the list and the definitions the app gave for the record they were added to. */
     const addedDefinitions = new Map();
     // A new line's id comes after every line id of the records given (kept from an earlier visit, say), never one of them.
@@ -46,10 +55,23 @@ function memorySource(options, kept) {
     };
     /** A version and permissions, where this source keeps them. */
     const told = (version, can) => ({ ...(version ? { version } : {}), ...(can ? { can } : {}) });
+    /** A record as a list's row gives it: the fields asked, as this person may read them, with its version and what they may do. */
+    const row = (model, id, values, fields) => {
+        const can = permissions(model, id);
+        return { id, values: readable(Object.fromEntries(fields.map((field) => [field, (0, values_1.structuredCopy)(values[field] ?? null)])), can), ...told(versionOf(model, id), can) };
+    };
     const pause = () => (options.delayMs ? (0, scheduler_1.wait)(options.delayMs, options.scheduler) : Promise.resolve());
+    /** A record's name, or its names in each language it is kept in (`{ ar, en }`). */
+    const nameOf = (model, id) => table(model)[String(id)]?.[options.labelField?.[model] ?? 'name'];
     const labelOf = (model, id) => {
-        const value = table(model)[String(id)]?.[options.labelField?.[model] ?? 'name'];
-        return typeof value === 'string' ? value : String(id);
+        const value = nameOf(model, id);
+        const name = oneText(value, options.language);
+        return typeof name === 'string' ? name : String(id);
+    };
+    /** Every name a record goes by: its name, in each of its languages. */
+    const namesOf = (model, record) => {
+        const value = nameOf(model, record.id);
+        return value !== null && typeof value === 'object' && !Array.isArray(value) ? Object.values(value).filter((name) => typeof name === 'string') : [record.label];
     };
     /** A linked record with what its model shows besides its name. */
     const shown = (model, record) => {
@@ -85,7 +107,7 @@ function memorySource(options, kept) {
     /** A record as a filter reads it: its values and its own `id`, which a field of its own named id comes before. */
     const withId = (key, values) => ({ id: asId(key), ...values });
     /** The stored records a filter keeps. */
-    const matchingRows = (model, filter) => Object.entries(table(model)).filter(([key, values]) => (0, filter_1.matchesFilter)(withId(key, values), filter)).map(([, values]) => values);
+    const matchingRows = (model, filter) => Object.entries(table(model)).filter(([key, values]) => passes(withId(key, values), filter)).map(([, values]) => values);
     /** A save, as a backend makes one: refused where the person may not, or over a newer version; else stored, its version moved on. */
     function write(request) {
         if (request.id !== null && table(request.model)[String(request.id)]) {
@@ -158,7 +180,7 @@ function memorySource(options, kept) {
         }
         return counted;
     }
-    return {
+    const source = {
         records,
         notDuplicatePairs,
         responses,
@@ -188,6 +210,14 @@ function memorySource(options, kept) {
             const link = request.later && options.draftLink ? options.draftLink(key, request) : undefined;
             return { key, ...(link ? { link } : {}) };
         },
+        // A map's records gathered as the option says, each record standing alone as a list's row is.
+        ...(options.clusters && {
+            async clusters(request) {
+                calls.push({ method: 'clusters', request });
+                await pause();
+                return options.clusters(request, records, (id, values) => row(request.model, id, values, request.fields));
+            },
+        }),
         async loadDraft(request) {
             calls.push({ method: 'loadDraft', request });
             await pause();
@@ -197,6 +227,16 @@ function memorySource(options, kept) {
             const { pageId: _page, later: _later, ...draft } = (0, values_1.structuredCopy)(kept);
             return draft;
         },
+        async approvals(request) {
+            calls.push({ method: 'approvals', request });
+            await pause();
+            return approving.approvals(request);
+        },
+        async decide(request) {
+            calls.push({ method: 'decide', request });
+            await pause();
+            return approving.decide(request);
+        },
         async load(request) {
             calls.push({ method: 'load', request });
             await pause();
@@ -279,12 +319,12 @@ function memorySource(options, kept) {
             // Found as a person writes it: in any case, with Arabic letters in any of their forms and digits in any script.
             const query = findable(request.query.trim());
             return Object.entries(table(request.model))
-                .filter(([key, values]) => (0, filter_1.matchesFilter)(withId(key, values), request.filter ?? []))
+                .filter(([key, values]) => passes(withId(key, values), request.filter ?? []))
                 .map(([key]) => ({ id: asId(key), label: labelOf(request.model, asId(key)) }))
                 // By its name, or a tree's record by its whole path: "Portal\Sprint", "Portal / Sprint"; asked exactly, the name or path itself.
                 .filter((record) => request.exact
-                ? findable(record.label) === query || findable(pathWords(request.model, record.id)) === query
-                : findable(record.label).includes(query) || findable(pathWords(request.model, record.id)).includes(query))
+                ? namesOf(request.model, record).some((name) => findable(name) === query) || findable(pathWords(request.model, record.id)) === query
+                : namesOf(request.model, record).some((name) => findable(name).includes(query)) || findable(pathWords(request.model, record.id)).includes(query))
                 .slice(0, request.limit ?? 8)
                 .map((record) => shown(request.model, record));
         },
@@ -292,14 +332,14 @@ function memorySource(options, kept) {
             calls.push({ method: 'list', request });
             await pause();
             const matching = Object.entries(table(request.model))
-                .filter(([key, values]) => (0, filter_1.matchesFilter)(withId(key, values), request.filter))
+                .filter(([key, values]) => passes(withId(key, values), request.filter))
                 .map(([key, values]) => ({ id: asId(key), values }));
             matching.sort((a, b) => {
                 for (const order of request.sort) {
                     // Nearest first: by how far each is, those with no place last.
                     const compared = order.near
                         ? compareValues((0, filter_1.distanceFrom)(a.values, order.field, order.near), (0, filter_1.distanceFrom)(b.values, order.field, order.near))
-                        : compareValues(a.values[order.field], b.values[order.field]);
+                        : compareValues(oneText(a.values[order.field], options.language), oneText(b.values[order.field], options.language));
                     // Empty last, whichever way the rest goes.
                     if (compared.empty)
                         return compared.result;
@@ -310,18 +350,14 @@ function memorySource(options, kept) {
             });
             return {
                 total: matching.length,
-                records: matching.slice(request.offset, request.offset + request.limit).map(({ id, values }) => {
-                    const can = permissions(request.model, id);
-                    const shownValues = readable(Object.fromEntries(request.fields.map((field) => [field, (0, values_1.structuredCopy)(values[field] ?? null)])), can);
-                    return { id, values: shownValues, ...told(versionOf(request.model, id), can) };
-                }),
+                records: matching.slice(request.offset, request.offset + request.limit).map(({ id, values }) => row(request.model, id, values, request.fields)),
                 ...(request.allIds ? { allIds: matching.map(({ id }) => id) } : {}),
             };
         },
         async groups(request) {
             calls.push({ method: 'groups', request });
             await pause();
-            return groupRows(matchingRows(request.model, request.filter), request.field, request).map(({ rows: _rows, ...group }) => group);
+            return groupRows(matchingRows(request.model, request.filter), request.field, request, options.language).map(({ rows: _rows, ...group }) => group);
         },
         async slots(request) {
             calls.push({ method: 'slots', request });
@@ -398,7 +434,7 @@ function memorySource(options, kept) {
             const rows = matchingRows(request.model, request.filter);
             const result = { count: rows.length, ...totalsOver(rows, request) };
             if (request.groupBy)
-                result.groups = groupRows(rows, request.groupBy, request).map(({ rows: under, ...group }) => ({ ...group, ...totalsOver(under, request) }));
+                result.groups = groupRows(rows, request.groupBy, request, options.language).map(({ rows: under, ...group }) => ({ ...group, ...totalsOver(under, request) }));
             return result;
         },
         async upload(file, request) {
@@ -525,6 +561,34 @@ function memorySource(options, kept) {
             addedDefinitions.set(`${request.list}:${JSON.stringify(own)}`, (0, values_1.structuredCopy)(request.definitions.filter((d) => !own.some((o) => o.name === d.name))));
         },
     };
+    // AI help's members, where the app gave what answers them (`assist`): each called as a server would be, after the
+    // source's pause, from the records it keeps.
+    const assist = options.assist;
+    if (assist?.suggest) {
+        const answer = assist.suggest.bind(assist);
+        source.suggest = async (request) => {
+            calls.push({ method: 'suggest', request });
+            await pause();
+            return answer(request, records);
+        };
+    }
+    if (assist?.rewrite) {
+        const answer = assist.rewrite.bind(assist);
+        source.rewrite = async (request) => {
+            calls.push({ method: 'rewrite', request });
+            await pause();
+            return answer(request, records);
+        };
+    }
+    if (assist?.searchToFilter) {
+        const answer = assist.searchToFilter.bind(assist);
+        source.searchToFilter = async (request) => {
+            calls.push({ method: 'searchToFilter', request });
+            await pause();
+            return answer(request, records);
+        };
+    }
+    return source;
 }
 /** The highest numeric id of a line among the records given — their tables of lines, and lines inside lines — or 0. */
 function highestLineId(records) {
@@ -558,6 +622,27 @@ function pathOf(value) {
     const kept = names?.filter((name) => typeof name === 'string' && name.trim() !== '');
     return kept?.length ? kept : null;
 }
+/** A text kept in several languages: texts keyed by their languages' tags, { ar, en }. */
+const inLanguages = (value) => value !== null && typeof value === 'object' && !Array.isArray(value) && Object.keys(value).length > 0 && Object.entries(value).every(([tag, text]) => typeof text === 'string' && /^[a-z]{2,3}(-[a-z\d]{2,8})*$/i.test(tag));
+/**
+ * Whether a record passes a filter (`matchesFilter`), a text it keeps in several languages read in each of them: the
+ * record as it reads in one of its languages passes — "villa" finds { ar: "فيلا", en: "Villa" }, "فيلا" too — as a
+ * server's search finds a text in any language it keeps.
+ */
+function passes(values, filter) {
+    const texts = Object.entries(values).filter((entry) => inLanguages(entry[1]));
+    if (!texts.length)
+        return (0, filter_1.matchesFilter)(values, filter);
+    const tags = new Set(texts.flatMap(([, value]) => Object.keys(value)));
+    return [...tags].some((tag) => (0, filter_1.matchesFilter)({ ...values, ...Object.fromEntries(texts.map(([name, value]) => [name, value[tag] ?? null])) }, filter));
+}
+/** A text kept in several languages ({ ar, en }) as one, in `language` (the first typed where it has none there); any other value as it is. */
+function oneText(value, language = '') {
+    if (value === null || typeof value !== 'object' || Array.isArray(value) || 'id' in value || !Object.values(value).every((text) => typeof text === 'string'))
+        return value;
+    const texts = value;
+    return texts[language]?.trim() ? texts[language] : (Object.values(texts).find((text) => text.trim()) ?? null);
+}
 /** Two values in order: a link by its label, text by the reader's rules, numbers by size; `empty` says one of them had nothing. */
 function compareValues(a, b) {
     const blank = (v) => v === null || v === undefined || v === '';
@@ -570,15 +655,16 @@ function compareValues(a, b) {
     return { result: String(x).localeCompare(String(y)), empty: false };
 }
 /**
- * Records under each value of a field: a link's by its record, a record of links (a many2many) under each of its
+ * Records under each value of a field (a text kept in several languages by its text in `language`): a link's by its record, a record of links (a many2many) under each of its
  * links, as a server groups tags; nothing as its own group, last; the rest by their labels. With `interval`, a date's
  * by the span it falls in, its first day the group's value and label, in time order.
  */
-function groupRows(rows, field, by = {}) {
+function groupRows(rows, field, by = {}, language) {
     const grouped = new Map();
     const isLink = (item) => item !== null && typeof item === 'object' && !Array.isArray(item) && 'id' in item;
     for (const values of rows) {
-        const held = values[field] ?? null;
+        // A text kept in several languages, grouped by its text in the source's language.
+        const held = (inLanguages(values[field]) ? oneText(values[field], language) : values[field]) ?? null;
         // Links: the record under each one; none, under nothing.
         const each = Array.isArray(held) && !by.interval && held.every(isLink) ? (held.length ? held : [null]) : [held];
         for (const raw of each) {