@fieldia/core 0.26.1 → 0.28.0

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

@@ -34,7 +34,7 @@ export interface DataSource {
     list?(request: ListRequest): Promise<ListResult>;
     /** How many records fall under each value of a field, for a list's Group By. */
     groups?(request: GroupRequest): Promise<Group[]>;
-    /** The choices of one of the app's lists, for a selection with `optionsFrom`. */
+    /** The choices of one of the app's lists, for a selection with `optionsFrom` — a page's field, or a table's line by its values. */
     options?(request: OptionsRequest): Promise<Option[]>;
     /** The definitions of a properties field with `definitionsFrom`: those the linked record keeps. */
     definitions?(request: OptionsRequest): Promise<PropertyDefinition[]>;
@@ -132,6 +132,120 @@ export interface DataSource {
      * with why) and nothing changes. Without it, possible duplicates offer no Merge.
      */
     merge?(request: MergeRequest): Promise<MergeResult | void>;
+    /**
+     * The records a person said are someone else for this one ("It's someone new"), by id: asked as a saved record is
+     * shown, before its possible duplicates are said, so one let be on another device stays let be here. A pair: answer
+     * from either side where you keep them so. With `markNotDuplicate`, these are kept on your server; without both,
+     * in the person's browser (the viewer's `preferences`), as before. To fail, throw: what the browser kept is read.
+     */
+    notDuplicates?(request: NotDuplicatesRequest): Promise<RecordId[]>;
+    /**
+     * Keep that a record found is someone else for this one: the person pressed "It's someone new" on a saved record,
+     * or saved a new one after pressing it (once for each). Never said as its duplicate again, on any device. Refused
+     * (thrown), the browser keeps it instead, as without this.
+     */
+    markNotDuplicate?(request: MarkNotDuplicateRequest): Promise<void>;
+    /**
+     * How many answers a page has taken, for its `limits` and its options' `seats`: the responses sent so far (what
+     * `maxResponses` counts), this person's (what `onePerPerson` counts), and for each choice field asked how many hold
+     * each of its options. Asked as the page opens — a closed or full form says so before anything is typed — and again
+     * just before its answers are sent. Without it, the page keeps to its dates alone and shows no places left; its
+     * `submit` (or `save`) refuses as it would.
+     */
+    limits?(request: LimitsRequest): Promise<LimitsResult>;
+    /**
+     * Keep a page's answers so far on the app's server, to continue from on this device or another: as they are typed
+     * (a moment after typing stops), as a wizard's step is entered, and when the person presses "Continue later"
+     * (`later`). The first time `key` is null: answer with the key the draft is kept under, and on "Continue later" a
+     * `link` to continue from (the app makes it, with the key in it) and words of the app's own ("We emailed you the
+     * link"). The answers kept are the app's to see — where people stopped, what they had written. Without it, drafts
+     * stay in the browser's store (`drafts`), as before, and no "Continue later" shows.
+     */
+    saveDraft?(request: SaveDraftRequest): Promise<SavedDraft>;
+    /** A draft kept by `saveDraft`, by its key: what the viewer's `resume` opens. Null when there is none (sent, or gone). */
+    loadDraft?(request: LoadDraftRequest): Promise<StoredDraft | null>;
+}
+/** Whose possible duplicates were let be: what `notDuplicates` is asked. */
+export interface NotDuplicatesRequest {
+    model: string;
+    /** The record shown, saved. */
+    recordId: RecordId;
+}
+/** A record found, said to be someone else for this one: what `markNotDuplicate` is asked. */
+export interface MarkNotDuplicateRequest {
+    model: string;
+    /** The record shown, saved. */
+    recordId: RecordId;
+    /** The record found like it, which is someone else. */
+    matchId: RecordId;
+}
+/** What `limits` is asked: the page, the record (whose own choice is no other's place) and the choice fields with places. */
+export interface LimitsRequest {
+    pageId: string;
+    /** The page's model; empty for a page of responses. */
+    model: string;
+    /** The record edited, whose own choices are not counted as another's; null for a new one or a response. */
+    recordId: RecordId | null;
+    /** The choice fields whose options have `seats`, by name: count how many hold each option. */
+    fields: string[];
+    /** The person as the app told the form (`user`), where it did: a server knows them by its own sign-in first. */
+    user?: {
+        id: RecordId | null;
+        name?: string;
+    };
+}
+/** How many answers a page has taken. Each part is told where the source knows it; one left out is not kept to. */
+export interface LimitsResult {
+    /** The responses (or records) sent so far: what the page's `maxResponses` counts. */
+    responses?: number;
+    /** Those this person sent: one or more refuses another where the page says `onePerPerson`. */
+    mine?: number;
+    /** For each field asked, by option value: how many answers hold it (the record edited not counted). */
+    perChoice?: Record<string, Record<string, number>>;
+}
+/** A page's answers so far, as a draft keeps them: on the app's server (`saveDraft`) or in the browser's store. */
+export interface StoredDraft {
+    /** The answers, as typed so far: where files are stored apart, no file's bytes. */
+    values: Values;
+    /** The wizard's step on screen, which the draft opens at again. */
+    step?: string | null;
+    /** The optional steps passed over with Skip. */
+    skipped?: string[];
+    /** Text typed that does not read yet, by its box's path, kept as it was typed and said again as the draft opens. */
+    unread?: Record<string, {
+        text: string;
+        message: string;
+    }>;
+    /** The fields the person answered (changed), in the page's order: where they got to. */
+    answered?: string[];
+    /** When it was kept, as ISO. */
+    savedAt: string;
+}
+/** What `saveDraft` is asked: the draft, and the key it was kept under before. */
+export interface SaveDraftRequest {
+    pageId: string;
+    /** The page's model; empty for a page of responses. */
+    model: string;
+    /** The record edited; null for a new one or a response. */
+    recordId: RecordId | null;
+    /** The key the source gave this draft before; null the first time: answer with a new one. */
+    key: string | null;
+    draft: StoredDraft;
+    /** The person pressed "Continue later": the app may send them the link now, and answers with it. */
+    later?: boolean;
+}
+/** A draft kept on the server: its key, and after "Continue later" the link to continue from and the app's own words. */
+export interface SavedDraft {
+    key: string;
+    /** The address to continue from, with the key in it, as the app makes it: shown with Copy. */
+    link?: string;
+    /** Words of the app's own, said as they are: "We emailed the link to mona@example.com." */
+    message?: string;
+}
+/** What `loadDraft` is asked: the page, and the key the draft was kept under. */
+export interface LoadDraftRequest {
+    pageId: string;
+    key: string;
 }
 /** Many records made at once, each with its own values: a list's Import. */
 export interface CreateManyRequest {
@@ -339,8 +453,16 @@ export interface ArchiveRequest extends RecordRequest {
 export interface OptionsRequest {
     /** The list's name, from the field's `optionsFrom.list`. */
     list: string;
-    /** Every value of the form, for a list that changes with another field (`dependsOn`). */
+    /**
+     * Every value of the form, for a list that changes with another field (`dependsOn`). For a table's line, the line's
+     * values: its connection, for its tools.
+     */
     values: Values;
+    /**
+     * For a table's line — or a form editing one in a dialog — the values of the record it is on, which a line's list
+     * may change with (`parent.` in its `dependsOn`). Left out for a page's own field.
+     */
+    parent?: Values;
 }
 export interface CreateRequest {
     model: string;
@@ -380,6 +502,8 @@ export interface SaveRequest {
      * the record as it is now.
      */
     version?: RecordVersion;
+    /** The key of the draft these changes were kept in on the server (`saveDraft`): the source may let it go. */
+    draft?: string;
 }
 export interface SaveResult {
     id: RecordId;
@@ -491,7 +615,11 @@ export interface GroupRequest extends GroupInterval {
     field: string;
     filter: ResolvedFilter[];
 }
-/** The records under one value of a field: a link's by its id, and those with none as a group of their own (value null). */
+/**
+ * The records under one value of a field: a link's by its id, a record of links (a many2many) under each of its links
+ * — tags counted as a server groups them, a list's filter counting each — and those with none as a group of their own
+ * (value null).
+ */
 export interface Group {
     value: JsonValue;
     label: string;
@@ -606,6 +734,8 @@ export interface SubmitRequest {
     values: Values;
     /** On a page with a bot check (`botCheck`): what it saw, for the app to decide on. The page never refuses a send for it. */
     bot?: BotReport;
+    /** The key of the draft these answers were kept in on the server (`saveDraft`): the source may let it go, or mark it sent. */
+    draft?: string;
 }
 /**
  * What a page's bot check saw as its answers were sent. A person never fills the hidden box and takes longer than a
@@ -623,7 +753,14 @@ export interface BotReport {
     captcha?: string | null;
 }
 export interface SubmitResult {
+    /** The id the app gave the response: a booking's reference ("B-1043"), a ticket's number. An ending's words say it as `{id}`. */
     id?: RecordId;
+    /**
+     * Values the app worked out as it kept the response, by the page's fields — a reference field it filled in, the time
+     * it confirmed — laid over the answers sent where an ending reads them (its `when` and its `{field}`s). The form's
+     * answers themselves stay as they were sent.
+     */
+    values?: Values;
 }
 /**
  * What changed, using the operation names Odoo gives its x2many commands, so

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":"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"}
+{"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.map

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

package/src/lib/record/day-words.d.mts

@@ -0,0 +1,10 @@
+import type { DateOrder } from './input-rules.mjs';
+import type { Messages } from './messages.mjs';
+/**
+ * A day a message names, written as the page's date boxes write one: in the page's order (`messages.dateOrder`, set on
+ * a form's own messages from its page's `look.dateOrder`: day first unless it says) and its language — "20 Oct 2026",
+ * "Oct 20, 2026", "2026-10-20". One rule for every message that names a day: a day's earliest and latest (limits.ts),
+ * the days a form opens and closes (form-limits.ts, which writes a time after it on the page's clock). As written
+ * where it reads as no day.
+ */
+export declare function dayWords(day: string, messages: Pick<Messages, 'locale' | 'dateOrder'>, order?: DateOrder): string;

package/src/lib/record/day-words.d.ts

@@ -0,0 +1,10 @@
+import type { DateOrder } from './input-rules';
+import type { Messages } from './messages';
+/**
+ * A day a message names, written as the page's date boxes write one: in the page's order (`messages.dateOrder`, set on
+ * a form's own messages from its page's `look.dateOrder`: day first unless it says) and its language — "20 Oct 2026",
+ * "Oct 20, 2026", "2026-10-20". One rule for every message that names a day: a day's earliest and latest (limits.ts),
+ * the days a form opens and closes (form-limits.ts, which writes a time after it on the page's clock). As written
+ * where it reads as no day.
+ */
+export declare function dayWords(day: string, messages: Pick<Messages, 'locale' | 'dateOrder'>, order?: DateOrder): string;

package/src/lib/record/day-words.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.dayWords = dayWords;
+/**
+ * A day a message names, written as the page's date boxes write one: in the page's order (`messages.dateOrder`, set on
+ * a form's own messages from its page's `look.dateOrder`: day first unless it says) and its language — "20 Oct 2026",
+ * "Oct 20, 2026", "2026-10-20". One rule for every message that names a day: a day's earliest and latest (limits.ts),
+ * the days a form opens and closes (form-limits.ts, which writes a time after it on the page's clock). As written
+ * where it reads as no day.
+ */
+function dayWords(day, messages, order = messages.dateOrder ?? 'dmy') {
+    const at = Date.parse(`${day}T00:00Z`);
+    if (order === 'ymd' || Number.isNaN(at))
+        return day;
+    // English as the boxes write it, the day first.
+    const format = new Intl.DateTimeFormat(messages.locale === 'en' ? 'en-GB' : messages.locale, { day: 'numeric', month: 'short', year: 'numeric', numberingSystem: 'latn', timeZone: 'UTC' });
+    if (order === 'dmy')
+        return format.format(at);
+    const parts = format.formatToParts(at);
+    const part = (type) => parts.find((one) => one.type === type)?.value ?? '';
+    return `${part('month')} ${part('day')}, ${part('year')}`;
+}
+//# sourceMappingURL=day-words.js.map

package/src/lib/record/day-words.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"day-words.js","sourceRoot":"","sources":["../../../../../../libs/core/src/lib/record/day-words.ts"],"names":[],"mappings":";;AAUA,4BASC;AAhBD;;;;;;GAMG;AACH,SAAgB,QAAQ,CAAC,GAAW,EAAE,QAAgD,EAAE,QAAmB,QAAQ,CAAC,SAAS,IAAI,KAAK;IACpI,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,SAAS,CAAC,CAAC;IACvC,IAAI,KAAK,KAAK,KAAK,IAAI,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;QAAE,OAAO,GAAG,CAAC;IACpD,gDAAgD;IAChD,MAAM,MAAM,GAAG,IAAI,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,EAAE,EAAE,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC;IAC5L,IAAI,KAAK,KAAK,KAAK;QAAE,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAC9C,MAAM,KAAK,GAAG,MAAM,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC;IACvC,MAAM,IAAI,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,KAAK,IAAI,CAAC,EAAE,KAAK,IAAI,EAAE,CAAC;IACnF,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;AAC5D,CAAC"}

package/src/lib/record/day-words.mjs

@@ -0,0 +1,20 @@
+/**
+ * A day a message names, written as the page's date boxes write one: in the page's order (`messages.dateOrder`, set on
+ * a form's own messages from its page's `look.dateOrder`: day first unless it says) and its language — "20 Oct 2026",
+ * "Oct 20, 2026", "2026-10-20". One rule for every message that names a day: a day's earliest and latest (limits.ts),
+ * the days a form opens and closes (form-limits.ts, which writes a time after it on the page's clock). As written
+ * where it reads as no day.
+ */
+export function dayWords(day, messages, order = messages.dateOrder ?? 'dmy') {
+    const at = Date.parse(`${day}T00:00Z`);
+    if (order === 'ymd' || Number.isNaN(at))
+        return day;
+    // English as the boxes write it, the day first.
+    const format = new Intl.DateTimeFormat(messages.locale === 'en' ? 'en-GB' : messages.locale, { day: 'numeric', month: 'short', year: 'numeric', numberingSystem: 'latn', timeZone: 'UTC' });
+    if (order === 'dmy')
+        return format.format(at);
+    const parts = format.formatToParts(at);
+    const part = (type) => parts.find((one) => one.type === type)?.value ?? '';
+    return `${part('month')} ${part('day')}, ${part('year')}`;
+}
+//# sourceMappingURL=day-words.mjs.map

package/src/lib/record/day-words.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"day-words.mjs","sourceRoot":"","sources":["../../../../../../libs/core/src/lib/record/day-words.ts"],"names":[],"mappings":"AAGA;;;;;;GAMG;AACH,MAAM,UAAU,QAAQ,CAAC,GAAW,EAAE,QAAgD,EAAE,QAAmB,QAAQ,CAAC,SAAS,IAAI,KAAK;IACpI,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,SAAS,CAAC,CAAC;IACvC,IAAI,KAAK,KAAK,KAAK,IAAI,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;QAAE,OAAO,GAAG,CAAC;IACpD,gDAAgD;IAChD,MAAM,MAAM,GAAG,IAAI,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,EAAE,EAAE,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC;IAC5L,IAAI,KAAK,KAAK,KAAK;QAAE,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAC9C,MAAM,KAAK,GAAG,MAAM,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC;IACvC,MAAM,IAAI,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,KAAK,IAAI,CAAC,EAAE,KAAK,IAAI,EAAE,CAAC;IACnF,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;AAC5D,CAAC"}

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

@@ -0,0 +1,19 @@
+import type { StoredDraft } from './data-source.mjs';
+/**
+ * Drafts: what is typed kept to be offered again, in the browser's store (`drafts.store`) or on the app's server (the
+ * data source's `saveDraft` and `loadDraft`), the store keeping only its key then. A draft keeps the answers, the
+ * wizard's step and the optional steps passed over, and text typed that does not read yet, as it was typed.
+ */
+/** A draft as the browser's store keeps it: the draft itself, or — kept on the app's server — its key. */
+export type KeptDraft = StoredDraft | {
+    savedAt: string;
+    key: string;
+};
+/** A draft read back from the browser's store, of this Fieldia or an older one (answers alone); null for none, or words that are none. */
+export declare function draftRead(raw: string | null): KeptDraft | null;
+/**
+ * The step a draft opens at: its own where it applies still, else the nearest before it that does — never one after
+ * it, whose questions were not reached — and the first that applies for a draft that names none (or one the page
+ * no longer has). Null for a page with no steps.
+ */
+export declare function resumeStep(steps: readonly string[], applies: readonly string[], step: string | null | undefined): string | null;

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

@@ -0,0 +1,19 @@
+import type { StoredDraft } from './data-source';
+/**
+ * Drafts: what is typed kept to be offered again, in the browser's store (`drafts.store`) or on the app's server (the
+ * data source's `saveDraft` and `loadDraft`), the store keeping only its key then. A draft keeps the answers, the
+ * wizard's step and the optional steps passed over, and text typed that does not read yet, as it was typed.
+ */
+/** A draft as the browser's store keeps it: the draft itself, or — kept on the app's server — its key. */
+export type KeptDraft = StoredDraft | {
+    savedAt: string;
+    key: string;
+};
+/** A draft read back from the browser's store, of this Fieldia or an older one (answers alone); null for none, or words that are none. */
+export declare function draftRead(raw: string | null): KeptDraft | null;
+/**
+ * The step a draft opens at: its own where it applies still, else the nearest before it that does — never one after
+ * it, whose questions were not reached — and the first that applies for a draft that names none (or one the page
+ * no longer has). Null for a page with no steps.
+ */
+export declare function resumeStep(steps: readonly string[], applies: readonly string[], step: string | null | undefined): string | null;

package/src/lib/record/drafts.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.draftRead = draftRead;
+exports.resumeStep = resumeStep;
+/** A draft read back from the browser's store, of this Fieldia or an older one (answers alone); null for none, or words that are none. */
+function draftRead(raw) {
+    if (!raw)
+        return null;
+    try {
+        const read = JSON.parse(raw);
+        if (!read || typeof read !== 'object' || typeof read['savedAt'] !== 'string')
+            return null;
+        if (typeof read['key'] === 'string')
+            return { savedAt: read['savedAt'], key: read['key'] };
+        return read['values'] && typeof read['values'] === 'object' && !Array.isArray(read['values']) ? read : null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * The step a draft opens at: its own where it applies still, else the nearest before it that does — never one after
+ * it, whose questions were not reached — and the first that applies for a draft that names none (or one the page
+ * no longer has). Null for a page with no steps.
+ */
+function resumeStep(steps, applies, step) {
+    if (!steps.length)
+        return null;
+    const at = step ? steps.indexOf(step) : -1;
+    for (let i = at; i >= 0; i--)
+        if (applies.includes(steps[i]))
+            return steps[i];
+    return applies[0] ?? steps[0];
+}
+//# sourceMappingURL=drafts.js.map

package/src/lib/record/drafts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"drafts.js","sourceRoot":"","sources":["../../../../../../libs/core/src/lib/record/drafts.ts"],"names":[],"mappings":";;AAYA,8BAUC;AAOD,gCAKC;AAvBD,0IAA0I;AAC1I,SAAgB,SAAS,CAAC,GAAkB;IAC1C,IAAI,CAAC,GAAG;QAAE,OAAO,IAAI,CAAC;IACtB,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAmC,CAAC;QAC/D,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,QAAQ;YAAE,OAAO,IAAI,CAAC;QAC1F,IAAI,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,QAAQ;YAAE,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QAC3F,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,OAAO,IAAI,CAAC,QAAQ,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAE,IAA+B,CAAC,CAAC,CAAC,IAAI,CAAC;IAC1I,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,SAAgB,UAAU,CAAC,KAAwB,EAAE,OAA0B,EAAE,IAA+B;IAC9G,IAAI,CAAC,KAAK,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IAC/B,MAAM,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3C,KAAK,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE;QAAE,IAAI,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YAAE,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC;IAC9E,OAAO,OAAO,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC;AAChC,CAAC"}

package/src/lib/record/drafts.mjs

@@ -0,0 +1,31 @@
+/** A draft read back from the browser's store, of this Fieldia or an older one (answers alone); null for none, or words that are none. */
+export function draftRead(raw) {
+    if (!raw)
+        return null;
+    try {
+        const read = JSON.parse(raw);
+        if (!read || typeof read !== 'object' || typeof read['savedAt'] !== 'string')
+            return null;
+        if (typeof read['key'] === 'string')
+            return { savedAt: read['savedAt'], key: read['key'] };
+        return read['values'] && typeof read['values'] === 'object' && !Array.isArray(read['values']) ? read : null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * The step a draft opens at: its own where it applies still, else the nearest before it that does — never one after
+ * it, whose questions were not reached — and the first that applies for a draft that names none (or one the page
+ * no longer has). Null for a page with no steps.
+ */
+export function resumeStep(steps, applies, step) {
+    if (!steps.length)
+        return null;
+    const at = step ? steps.indexOf(step) : -1;
+    for (let i = at; i >= 0; i--)
+        if (applies.includes(steps[i]))
+            return steps[i];
+    return applies[0] ?? steps[0];
+}
+//# sourceMappingURL=drafts.mjs.map

package/src/lib/record/drafts.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"drafts.mjs","sourceRoot":"","sources":["../../../../../../libs/core/src/lib/record/drafts.ts"],"names":[],"mappings":"AAWA,0IAA0I;AAC1I,MAAM,UAAU,SAAS,CAAC,GAAkB;IAC1C,IAAI,CAAC,GAAG;QAAE,OAAO,IAAI,CAAC;IACtB,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAmC,CAAC;QAC/D,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,QAAQ;YAAE,OAAO,IAAI,CAAC;QAC1F,IAAI,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,QAAQ;YAAE,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QAC3F,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,OAAO,IAAI,CAAC,QAAQ,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAE,IAA+B,CAAC,CAAC,CAAC,IAAI,CAAC;IAC1I,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,UAAU,CAAC,KAAwB,EAAE,OAA0B,EAAE,IAA+B;IAC9G,IAAI,CAAC,KAAK,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IAC/B,MAAM,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3C,KAAK,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE;QAAE,IAAI,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YAAE,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC;IAC9E,OAAO,OAAO,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC;AAChC,CAAC"}

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

@@ -43,4 +43,8 @@ export declare function recordContext(values: Values, fields: Record<string, Fie
  * same name comes first.
  */
 export declare function lineContext(values: Values, fields: Record<string, LineField>, parent: Record<string, unknown>, id?: RecordId | null): Record<string, unknown>;
-export declare function expressionEnv(values: Values, fields: Record<string, Field | LineField>, today: () => string): ExpressionEnv;
+/** What a form hands every expression of the app's own: its functions, and the answers of those that ask (`ExpressionEnv`). */
+export type AppReads = Pick<ExpressionEnv, 'functions' | 'answer'>;
+/** The name of the record a link field holds: a currency's "EGP". */
+export declare function nameIn(values: Values, field: string): string | undefined;
+export declare function expressionEnv(values: Values, fields: Record<string, Field | LineField>, today: () => string, app?: AppReads): ExpressionEnv;

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

@@ -43,4 +43,8 @@ export declare function recordContext(values: Values, fields: Record<string, Fie
  * same name comes first.
  */
 export declare function lineContext(values: Values, fields: Record<string, LineField>, parent: Record<string, unknown>, id?: RecordId | null): Record<string, unknown>;
-export declare function expressionEnv(values: Values, fields: Record<string, Field | LineField>, today: () => string): ExpressionEnv;
+/** What a form hands every expression of the app's own: its functions, and the answers of those that ask (`ExpressionEnv`). */
+export type AppReads = Pick<ExpressionEnv, 'functions' | 'answer'>;
+/** The name of the record a link field holds: a currency's "EGP". */
+export declare function nameIn(values: Values, field: string): string | undefined;
+export declare function expressionEnv(values: Values, fields: Record<string, Field | LineField>, today: () => string, app?: AppReads): ExpressionEnv;

package/src/lib/record/env.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.builtIns = builtIns;
 exports.recordContext = recordContext;
 exports.lineContext = lineContext;
+exports.nameIn = nameIn;
 exports.expressionEnv = expressionEnv;
 const values_1 = require("./values");
 /**
@@ -45,10 +46,17 @@ function lineContext(values, fields, parent, id = null) {
             delete names[name];
     return { ...names, ...(0, values_1.expressionContext)(values, fields) };
 }
-function expressionEnv(values, fields, today) {
+/** The name of the record a link field holds: a currency's "EGP". */
+function nameIn(values, field) {
+    const value = values[field];
+    return value !== null && typeof value === 'object' && !Array.isArray(value) && typeof value.label === 'string' ? value.label : undefined;
+}
+function expressionEnv(values, fields, today, app = {}) {
     const rows = new Map();
     return {
+        ...app,
         today,
+        nameOf: (field) => nameIn(values, field),
         lines(name) {
             const def = fields[name];
             if (def?.type !== 'one2many')

package/src/lib/record/env.js.map

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

package/src/lib/record/env.mjs

@@ -39,10 +39,17 @@ export function lineContext(values, fields, parent, id = null) {
             delete names[name];
     return { ...names, ...expressionContext(values, fields) };
 }
-export function expressionEnv(values, fields, today) {
+/** The name of the record a link field holds: a currency's "EGP". */
+export function nameIn(values, field) {
+    const value = values[field];
+    return value !== null && typeof value === 'object' && !Array.isArray(value) && typeof value.label === 'string' ? value.label : undefined;
+}
+export function expressionEnv(values, fields, today, app = {}) {
     const rows = new Map();
     return {
+        ...app,
         today,
+        nameOf: (field) => nameIn(values, field),
         lines(name) {
             const def = fields[name];
             if (def?.type !== 'one2many')

package/src/lib/record/env.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"env.mjs","sourceRoot":"","sources":["../../../../../../libs/core/src/lib/record/env.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,iBAAiB,EAAE,QAAQ,EAAyC,MAAM,UAAU,CAAC;AAE9F;;;;;;;GAOG;AACH,MAAM,UAAU,QAAQ,CACtB,MAA+B,EAC/B,QAAyB,EACzB,IAAmF,EACnF,OAAO,GAAG,IAAI,EACd,UAA+C,EAAE,EACjD,MAAgC;IAEhC,MAAM,KAAK,GAA4B;QACrC,EAAE,EAAE,QAAQ,IAAI,IAAI;QACpB,IAAI,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,IAAI,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,IAAI,IAAI,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE;QACzF,OAAO;QACP,OAAO;QACP,qEAAqE;QACrE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC9B,CAAC;IACF,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,IAAI,IAAI,IAAI,MAAM;YAAE,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC;IAC9E,OAAO,KAAK,CAAC;AACf,CAAC;AAmBD,yGAAyG;AACzG,MAAM,UAAU,aAAa,CAAC,MAAc,EAAE,MAAyC,EAAE,KAAY;IACnG,OAAO,EAAE,GAAG,QAAQ,CAAC,MAAM,EAAE,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,GAAG,iBAAiB,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC;AAC/I,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,MAAc,EAAE,MAAiC,EAAE,MAA+B,EAAE,KAAsB,IAAI;IACxI,uFAAuF;IACvF,kDAAkD;IAClD,MAAM,KAAK,GAA4B,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,QAAQ,CAAC,EAAE,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,MAAM,CAAC,SAAS,CAAC,IAAI,EAAE,EAAE,CAAC;IACvJ,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,IAAI,IAAI,IAAI,MAAM;YAAE,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC;IAC9E,OAAO,EAAE,GAAG,KAAK,EAAE,GAAG,iBAAiB,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC;AAC5D,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,MAAc,EAAE,MAAyC,EAAE,KAAmB;IAC1G,MAAM,IAAI,GAAG,IAAI,GAAG,EAAqC,CAAC;IAC1D,OAAO;QACL,KAAK;QACL,KAAK,CAAC,IAAI;YACR,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;YACzB,IAAI,GAAG,EAAE,IAAI,KAAK,UAAU;gBAAE,OAAO,SAAS,CAAC;YAC/C,IAAI,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAC3B,IAAI,CAAC,KAAK,EAAE,CAAC;gBACX,MAAM,KAAK,GAAG,CAAE,MAAM,CAAC,IAAI,CAAmB,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC,CAAC;gBAC5G,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,iBAAiB,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;gBACxE,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;YACxB,CAAC;YACD,OAAO,KAAK,CAAC;QACf,CAAC;KACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"env.mjs","sourceRoot":"","sources":["../../../../../../libs/core/src/lib/record/env.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,78 @@
+import type { Option } from '../format/field.mjs';
+import type { Page } from '../format/page.mjs';
+import type { DataSource, LimitsResult } from './data-source.mjs';
+import type { FormState, FormUser } from './form.mjs';
+import { type Messages } from './messages.mjs';
+import type { Stopped } from './run.mjs';
+import type { Scheduler } from './scheduler.mjs';
+import { type FormLimits, type Seats } from './taking.mjs';
+import type { DateOrder } from './input-rules.mjs';
+import type { Value } from './values.mjs';
+/**
+ * A form's limits (the limits part): when the page takes answers and each choice's places, worked out from the page,
+ * the form's clock and the data source's counts — asked as it opens, again before its answers go and after — a full
+ * choice refused when picked or held. A form on a page with `limits` or options with `seats` (or an app's list whose
+ * options come with them) makes this from the part as it comes (form.ts, `limitsCode`); before, it takes answers as a
+ * page without limits does, and a save waits for it.
+ */
+/** What the limits ask of the form they are made for. */
+export interface LimitsHost {
+    readonly page: Page;
+    readonly dataSource: DataSource | undefined;
+    readonly user: FormUser | undefined;
+    readonly messages: Messages;
+    readonly scheduler: Scheduler;
+    state(): FormState;
+    set(patch: Partial<FormState>): void;
+    /** Now, in ms, by the form's clock. */
+    clock(): number;
+    /** Whether the form has its state yet: a list's choices are read from it once it has. */
+    started(): boolean;
+    /** Whether what is asked now still lands on the record shown, when it answers. */
+    shownNow(): () => boolean;
+    /** The record shown's generation: another shown since a save started, it is told so. */
+    generation(): number;
+    /** The words a save says when another record was shown since it started. */
+    replaced(): string;
+    /** Whether something listens to the form: a page left open is told as it opens or closes then. */
+    listened(): boolean;
+    disposed(): boolean;
+    /** Words said under a field until it changes from what it holds, as a refused save's are. */
+    refuse(name: string, message: string): void;
+}
+/** A form's limits, made for it (`formLimits`). */
+export interface Limits {
+    /** The limits shown as they are now, and the next moment they change of themselves awaited. */
+    show(): void;
+    /** Ask the source's `limits` again and show what it tells, on the record it was asked for. */
+    ask(): Promise<void>;
+    /** Whether the form asks the source for counts: a source that tells them, and something to count. */
+    asks(): boolean;
+    /** Whether the counts of a choice of an app's list whose options came with places were never told. */
+    uncounted(name: string): boolean;
+    /** Whether the page takes these answers now, asked of the source again: why not, as a save's problem, or null. */
+    stillTaking(asked: number): Promise<Stopped | null>;
+    /** A choice of a full option, picked by the person, refused under its field: the field keeps what it held. */
+    refusedFull(name: string, value: Value): boolean;
+    /** A choice held whose places filled up since it was picked, said under it: never sent. */
+    fullErrors(seen: ReadonlySet<string>, errors: Readonly<Record<string, string>>): Record<string, string>;
+    /** Something listens now, or no longer does: the timer for the page opening or closing kept, or let go. */
+    heard(listening: boolean): void;
+    dispose(): void;
+}
+/** What a form tells of its limits now: from the page, the clock, the options it shows and the source's last answer. */
+export declare function limitsNow(page: Page, now: number, told: LimitsResult | null, asking: boolean, optionsOf: (field: string) => readonly Option[]): FormLimits | null;
+/**
+ * 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 declare function fullChosen(field: Page['fields'][string] | undefined, places: Readonly<Record<string, Seats>> | undefined, value: Value | undefined, before?: Value | undefined): Option[];
+/** A form's limits: what it tells of them, and what it asks and refuses by them. */
+export declare function formLimits(host: LimitsHost): Limits;
+/**
+ * A day or a day and a time in words, as the page's date boxes write one (`dayWords`): in its order (`order`, the
+ * page's `look.dateOrder`, else the messages'), its language, on its clock — "20 Nov 2026", "1 Nov 2026, 09:00" — with
+ * the zone's short name where it is not the browser's own ("09:00 EET").
+ */
+export declare function whenWords(written: string, at: number, messages: Messages, zone?: string, order?: DateOrder): string;
+export declare function takingWords(page: Page, limits: FormLimits | null | undefined, messages: Messages): string | null;