@fieldia/core 0.30.1 → 0.31.0

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

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

package/src/lib/record/link-values.d.mts

@@ -0,0 +1,31 @@
+import type { Field } from '../format/field.mjs';
+import type { Page } from '../format/page.mjs';
+import type { FormInner, FormJoin } from './joins.mjs';
+import { type Value, type Values } from './values.mjs';
+/**
+ * The link a page is opened with: its whole address, or only its `?…` part (`location.href`, `location.search`) — or
+ * its parameters by name, as an app read them itself.
+ */
+export type PageLink = string | Readonly<Record<string, string>>;
+/** A link's parameters by name, the first of each as written there, decoded; none for a link without them. */
+export declare function linkParams(link: PageLink): Map<string, string>;
+/**
+ * A parameter's words as its field holds a value — a number as a number, yes or no, a choice by one of its options'
+ * values, a day as 2026-10-20, a day and time as an instant — or undefined where they do not read so: never guessed.
+ */
+export declare function linkValue(field: Field, text: string): Value | undefined;
+/** The fields a page's link fills (`prefill.fromUrl`), each by the parameter that fills it. */
+export declare function prefilledFields(page: Page): Map<string, string>;
+/**
+ * What a page's link fills as the form starts (`prefill`): each field named, by its parameter's words read as the
+ * field reads them — left out where they do not read so, or where the field's own checks (its most characters, its
+ * pattern, its least and most, its days) would refuse them: a hidden field no one can put right never stops a send.
+ */
+export declare function linkValues(page: Page, link: PageLink | undefined): Values;
+/**
+ * The prefill part's side of a form (`prefill` on its page, joins.ts): the fields the link fills laid where a new record
+ * or response starts — as loaded ones are, never a change to save, never over what the form was given (`values`) or
+ * what the person changed — and laid again as another starts; the hidden ones, placed nowhere and seen by no one, sent
+ * with the answers all the same. The link is the form's `url`, else the page's own address.
+ */
+export declare function join(host: FormInner): FormJoin;

package/src/lib/record/link-values.d.ts

@@ -0,0 +1,31 @@
+import type { Field } from '../format/field';
+import type { Page } from '../format/page';
+import type { FormInner, FormJoin } from './joins';
+import { type Value, type Values } from './values';
+/**
+ * The link a page is opened with: its whole address, or only its `?…` part (`location.href`, `location.search`) — or
+ * its parameters by name, as an app read them itself.
+ */
+export type PageLink = string | Readonly<Record<string, string>>;
+/** A link's parameters by name, the first of each as written there, decoded; none for a link without them. */
+export declare function linkParams(link: PageLink): Map<string, string>;
+/**
+ * A parameter's words as its field holds a value — a number as a number, yes or no, a choice by one of its options'
+ * values, a day as 2026-10-20, a day and time as an instant — or undefined where they do not read so: never guessed.
+ */
+export declare function linkValue(field: Field, text: string): Value | undefined;
+/** The fields a page's link fills (`prefill.fromUrl`), each by the parameter that fills it. */
+export declare function prefilledFields(page: Page): Map<string, string>;
+/**
+ * What a page's link fills as the form starts (`prefill`): each field named, by its parameter's words read as the
+ * field reads them — left out where they do not read so, or where the field's own checks (its most characters, its
+ * pattern, its least and most, its days) would refuse them: a hidden field no one can put right never stops a send.
+ */
+export declare function linkValues(page: Page, link: PageLink | undefined): Values;
+/**
+ * The prefill part's side of a form (`prefill` on its page, joins.ts): the fields the link fills laid where a new record
+ * or response starts — as loaded ones are, never a change to save, never over what the form was given (`values`) or
+ * what the person changed — and laid again as another starts; the hidden ones, placed nowhere and seen by no one, sent
+ * with the answers all the same. The link is the form's `url`, else the page's own address.
+ */
+export declare function join(host: FormInner): FormJoin;

package/src/lib/record/link-values.js

@@ -0,0 +1,132 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.linkParams = linkParams;
+exports.linkValue = linkValue;
+exports.prefilledFields = prefilledFields;
+exports.linkValues = linkValues;
+exports.join = join;
+const check_1 = require("./check");
+const values_1 = require("./values");
+/** A part of a link as written, `+` and `%xx` read: a part that does not decode is kept as written. */
+const decoded = (text) => {
+    try {
+        return decodeURIComponent(text.replace(/\+/g, ' '));
+    }
+    catch {
+        return text;
+    }
+};
+/** A link's parameters by name, the first of each as written there, decoded; none for a link without them. */
+function linkParams(link) {
+    const params = new Map();
+    if (typeof link !== 'string') {
+        for (const [name, value] of Object.entries(link))
+            if (typeof value === 'string')
+                params.set(name, value);
+        return params;
+    }
+    const query = (link.includes('?') ? link.slice(link.indexOf('?') + 1) : link.includes('=') ? link : '').split('#')[0];
+    for (const pair of query.split('&')) {
+        const at = pair.indexOf('=');
+        const name = decoded(at < 0 ? pair : pair.slice(0, at));
+        if (name && !params.has(name))
+            params.set(name, decoded(at < 0 ? '' : pair.slice(at + 1)));
+    }
+    return params;
+}
+/** The most a link's words fill a line of text with: longer is no campaign's, broker's or unit's name, and is left out. */
+const MOST = 500;
+/**
+ * A parameter's words as its field holds a value — a number as a number, yes or no, a choice by one of its options'
+ * values, a day as 2026-10-20, a day and time as an instant — or undefined where they do not read so: never guessed.
+ */
+function linkValue(field, text) {
+    const words = text.trim();
+    if (!words)
+        return undefined;
+    switch (field.type) {
+        case 'char':
+        case 'text':
+            return words.length <= MOST ? words : undefined;
+        case 'integer':
+            return /^-?\d{1,15}$/.test(words) ? Number(words) : undefined;
+        case 'float':
+        case 'monetary':
+            return /^-?\d{1,15}(\.\d+)?$/.test(words) ? Number(words) : undefined;
+        case 'boolean':
+            return /^(1|true|yes|on)$/i.test(words) ? true : /^(0|false|no|off)$/i.test(words) ? false : undefined;
+        case 'selection':
+            return field.options?.find((option) => String(option.value) === words)?.value;
+        case 'date':
+            return /^\d{4}-\d{2}-\d{2}$/.test(words) && !Number.isNaN(Date.parse(words)) && new Date(Date.parse(words)).toISOString().startsWith(words) ? words : undefined;
+        case 'datetime':
+            // An instant with its offset, or in UTC: a day and time alone names no moment.
+            return /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}(:\d{2}(\.\d{1,3})?)?(Z|[+-]\d{2}:\d{2})$/.test(words) && !Number.isNaN(Date.parse(words)) ? new Date(Date.parse(words)).toISOString() : undefined;
+        default:
+            return undefined;
+    }
+}
+/** The fields a page's link fills (`prefill.fromUrl`), each by the parameter that fills it. */
+function prefilledFields(page) {
+    const filled = new Map();
+    for (const one of page.prefill?.fromUrl ?? []) {
+        const [param, field] = typeof one === 'string' ? [one, one] : [one.param, one.field];
+        if (!filled.has(field))
+            filled.set(field, param);
+    }
+    return filled;
+}
+/**
+ * What a page's link fills as the form starts (`prefill`): each field named, by its parameter's words read as the
+ * field reads them — left out where they do not read so, or where the field's own checks (its most characters, its
+ * pattern, its least and most, its days) would refuse them: a hidden field no one can put right never stops a send.
+ */
+function linkValues(page, link) {
+    const values = {};
+    if (!page.prefill || link === undefined)
+        return values;
+    const params = linkParams(link);
+    for (const [name, param] of prefilledFields(page)) {
+        const field = page.fields[name];
+        const text = params.get(param);
+        if (!field || text === undefined)
+            continue;
+        const value = linkValue(field, text);
+        if (value !== undefined && (0, check_1.checkValue)(field, value, false) === undefined)
+            values[name] = value;
+    }
+    return values;
+}
+/**
+ * The prefill part's side of a form (`prefill` on its page, joins.ts): the fields the link fills laid where a new record
+ * or response starts — as loaded ones are, never a change to save, never over what the form was given (`values`) or
+ * what the person changed — and laid again as another starts; the hidden ones, placed nowhere and seen by no one, sent
+ * with the answers all the same. The link is the form's `url`, else the page's own address.
+ */
+function join(host) {
+    const { form, page, options } = host;
+    const placed = new Set((JSON.stringify(page.layout).match(/"field":"[^"]+"/g) ?? []).map((one) => one.slice(9, -1)));
+    const lay = () => {
+        const state = form.getState();
+        if (state.recordId != null)
+            return;
+        const link = linkValues(page, options.url ?? globalThis.location?.href);
+        for (const name of Object.keys(link))
+            if (state.dirty.includes(name) || (options.values && name in options.values))
+                delete link[name];
+        form.setValues(link, { stored: true });
+    };
+    lay();
+    return {
+        reset: lay,
+        // In the answers themselves: what the response is sent with is what its ending reads, what the form tells, and what
+        // an app's checkout is handed before it goes.
+        values(answers) {
+            const values = form.getState().values;
+            for (const name of prefilledFields(page).keys())
+                if (!placed.has(name) && !(name in answers))
+                    answers[name] = (0, values_1.structuredCopy)(values[name] ?? null);
+        },
+    };
+}
+//# sourceMappingURL=link-values.js.map

package/src/lib/record/link-values.js.map

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

package/src/lib/record/link-values.mjs

@@ -0,0 +1,125 @@
+import { checkValue } from './check.mjs';
+import { structuredCopy } from './values.mjs';
+/** A part of a link as written, `+` and `%xx` read: a part that does not decode is kept as written. */
+const decoded = (text) => {
+    try {
+        return decodeURIComponent(text.replace(/\+/g, ' '));
+    }
+    catch {
+        return text;
+    }
+};
+/** A link's parameters by name, the first of each as written there, decoded; none for a link without them. */
+export function linkParams(link) {
+    const params = new Map();
+    if (typeof link !== 'string') {
+        for (const [name, value] of Object.entries(link))
+            if (typeof value === 'string')
+                params.set(name, value);
+        return params;
+    }
+    const query = (link.includes('?') ? link.slice(link.indexOf('?') + 1) : link.includes('=') ? link : '').split('#')[0];
+    for (const pair of query.split('&')) {
+        const at = pair.indexOf('=');
+        const name = decoded(at < 0 ? pair : pair.slice(0, at));
+        if (name && !params.has(name))
+            params.set(name, decoded(at < 0 ? '' : pair.slice(at + 1)));
+    }
+    return params;
+}
+/** The most a link's words fill a line of text with: longer is no campaign's, broker's or unit's name, and is left out. */
+const MOST = 500;
+/**
+ * A parameter's words as its field holds a value — a number as a number, yes or no, a choice by one of its options'
+ * values, a day as 2026-10-20, a day and time as an instant — or undefined where they do not read so: never guessed.
+ */
+export function linkValue(field, text) {
+    const words = text.trim();
+    if (!words)
+        return undefined;
+    switch (field.type) {
+        case 'char':
+        case 'text':
+            return words.length <= MOST ? words : undefined;
+        case 'integer':
+            return /^-?\d{1,15}$/.test(words) ? Number(words) : undefined;
+        case 'float':
+        case 'monetary':
+            return /^-?\d{1,15}(\.\d+)?$/.test(words) ? Number(words) : undefined;
+        case 'boolean':
+            return /^(1|true|yes|on)$/i.test(words) ? true : /^(0|false|no|off)$/i.test(words) ? false : undefined;
+        case 'selection':
+            return field.options?.find((option) => String(option.value) === words)?.value;
+        case 'date':
+            return /^\d{4}-\d{2}-\d{2}$/.test(words) && !Number.isNaN(Date.parse(words)) && new Date(Date.parse(words)).toISOString().startsWith(words) ? words : undefined;
+        case 'datetime':
+            // An instant with its offset, or in UTC: a day and time alone names no moment.
+            return /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}(:\d{2}(\.\d{1,3})?)?(Z|[+-]\d{2}:\d{2})$/.test(words) && !Number.isNaN(Date.parse(words)) ? new Date(Date.parse(words)).toISOString() : undefined;
+        default:
+            return undefined;
+    }
+}
+/** The fields a page's link fills (`prefill.fromUrl`), each by the parameter that fills it. */
+export function prefilledFields(page) {
+    const filled = new Map();
+    for (const one of page.prefill?.fromUrl ?? []) {
+        const [param, field] = typeof one === 'string' ? [one, one] : [one.param, one.field];
+        if (!filled.has(field))
+            filled.set(field, param);
+    }
+    return filled;
+}
+/**
+ * What a page's link fills as the form starts (`prefill`): each field named, by its parameter's words read as the
+ * field reads them — left out where they do not read so, or where the field's own checks (its most characters, its
+ * pattern, its least and most, its days) would refuse them: a hidden field no one can put right never stops a send.
+ */
+export function linkValues(page, link) {
+    const values = {};
+    if (!page.prefill || link === undefined)
+        return values;
+    const params = linkParams(link);
+    for (const [name, param] of prefilledFields(page)) {
+        const field = page.fields[name];
+        const text = params.get(param);
+        if (!field || text === undefined)
+            continue;
+        const value = linkValue(field, text);
+        if (value !== undefined && checkValue(field, value, false) === undefined)
+            values[name] = value;
+    }
+    return values;
+}
+/**
+ * The prefill part's side of a form (`prefill` on its page, joins.ts): the fields the link fills laid where a new record
+ * or response starts — as loaded ones are, never a change to save, never over what the form was given (`values`) or
+ * what the person changed — and laid again as another starts; the hidden ones, placed nowhere and seen by no one, sent
+ * with the answers all the same. The link is the form's `url`, else the page's own address.
+ */
+export function join(host) {
+    const { form, page, options } = host;
+    const placed = new Set((JSON.stringify(page.layout).match(/"field":"[^"]+"/g) ?? []).map((one) => one.slice(9, -1)));
+    const lay = () => {
+        const state = form.getState();
+        if (state.recordId != null)
+            return;
+        const link = linkValues(page, options.url ?? globalThis.location?.href);
+        for (const name of Object.keys(link))
+            if (state.dirty.includes(name) || (options.values && name in options.values))
+                delete link[name];
+        form.setValues(link, { stored: true });
+    };
+    lay();
+    return {
+        reset: lay,
+        // In the answers themselves: what the response is sent with is what its ending reads, what the form tells, and what
+        // an app's checkout is handed before it goes.
+        values(answers) {
+            const values = form.getState().values;
+            for (const name of prefilledFields(page).keys())
+                if (!placed.has(name) && !(name in answers))
+                    answers[name] = structuredCopy(values[name] ?? null);
+        },
+    };
+}
+//# sourceMappingURL=link-values.mjs.map

package/src/lib/record/link-values.mjs.map

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

package/src/lib/record/live-later.d.mts

@@ -0,0 +1,15 @@
+import { type Part } from '../parts.mjs';
+import type { FormJoin } from './joins.mjs';
+import type * as LiveModule from './live-part.mjs';
+/** The live part: a record's changes made elsewhere and who else has it open (live.ts), asked of the data source. */
+export type RecordLivePart = typeof LiveModule;
+/**
+ * The record shown made live, one of the parts that join a form (joins.ts) — loaded as a form is made whose source has
+ * `subscribe` or `presence`: never for an app whose source has neither.
+ */
+export declare const recordLivePart: Part<RecordLivePart>;
+/** The form's record made live: `watch` as what is shown changes, `stop` as the form goes. */
+export interface LiveRecord extends FormJoin {
+    watch(): void;
+    stop(): void;
+}

package/src/lib/record/live-later.d.ts

@@ -0,0 +1,15 @@
+import { type Part } from '../parts';
+import type { FormJoin } from './joins';
+import type * as LiveModule from './live-part';
+/** The live part: a record's changes made elsewhere and who else has it open (live.ts), asked of the data source. */
+export type RecordLivePart = typeof LiveModule;
+/**
+ * The record shown made live, one of the parts that join a form (joins.ts) — loaded as a form is made whose source has
+ * `subscribe` or `presence`: never for an app whose source has neither.
+ */
+export declare const recordLivePart: Part<RecordLivePart>;
+/** The form's record made live: `watch` as what is shown changes, `stop` as the form goes. */
+export interface LiveRecord extends FormJoin {
+    watch(): void;
+    stop(): void;
+}

package/src/lib/record/live-later.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.recordLivePart = void 0;
+const parts_1 = require("../parts");
+/**
+ * The record shown made live, one of the parts that join a form (joins.ts) — loaded as a form is made whose source has
+ * `subscribe` or `presence`: never for an app whose source has neither.
+ */
+exports.recordLivePart = (0, parts_1.lazyPart)('live', () => Promise.resolve().then(() => require('./live-part')));
+//# sourceMappingURL=live-later.js.map

package/src/lib/record/live-later.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"live-later.js","sourceRoot":"","sources":["../../../../../../libs/core/src/lib/record/live-later.ts"],"names":[],"mappings":";;;AAAA,oCAA+C;AAO/C;;;GAGG;AACU,QAAA,cAAc,GAAyB,IAAA,gBAAQ,EAAC,MAAM,EAAE,GAAG,EAAE,sCAAQ,aAAa,EAAC,CAAC,CAAC"}

package/src/lib/record/live-later.mjs

@@ -0,0 +1,7 @@
+import { lazyPart } from '../parts.mjs';
+/**
+ * The record shown made live, one of the parts that join a form (joins.ts) — loaded as a form is made whose source has
+ * `subscribe` or `presence`: never for an app whose source has neither.
+ */
+export const recordLivePart = lazyPart('live', () => import('./live-part.mjs'));
+//# sourceMappingURL=live-later.mjs.map

package/src/lib/record/live-later.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"live-later.mjs","sourceRoot":"","sources":["../../../../../../libs/core/src/lib/record/live-later.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAa,MAAM,UAAU,CAAC;AAO/C;;;GAGG;AACH,MAAM,CAAC,MAAM,cAAc,GAAyB,QAAQ,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC"}

package/src/lib/record/live-part.d.mts

@@ -0,0 +1,6 @@
+/**
+ * The live part (parts.ts): a record's changes made elsewhere laid on it or waiting as a conflict, and who else has it
+ * open (live.ts) — asked of the data source's `subscribe` and `presence`. One of the parts that join a form (joins.ts),
+ * loaded through `recordLivePart` (live-later.ts) as a form is made whose source has either.
+ */
+export { join, liveRecord } from './live.mjs';

package/src/lib/record/live-part.d.ts

@@ -0,0 +1,6 @@
+/**
+ * The live part (parts.ts): a record's changes made elsewhere laid on it or waiting as a conflict, and who else has it
+ * open (live.ts) — asked of the data source's `subscribe` and `presence`. One of the parts that join a form (joins.ts),
+ * loaded through `recordLivePart` (live-later.ts) as a form is made whose source has either.
+ */
+export { join, liveRecord } from './live';

package/src/lib/record/live-part.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.liveRecord = exports.join = void 0;
+/**
+ * The live part (parts.ts): a record's changes made elsewhere laid on it or waiting as a conflict, and who else has it
+ * open (live.ts) — asked of the data source's `subscribe` and `presence`. One of the parts that join a form (joins.ts),
+ * loaded through `recordLivePart` (live-later.ts) as a form is made whose source has either.
+ */
+var live_1 = require("./live");
+Object.defineProperty(exports, "join", { enumerable: true, get: function () { return live_1.join; } });
+Object.defineProperty(exports, "liveRecord", { enumerable: true, get: function () { return live_1.liveRecord; } });
+//# sourceMappingURL=live-part.js.map

package/src/lib/record/live-part.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"live-part.js","sourceRoot":"","sources":["../../../../../../libs/core/src/lib/record/live-part.ts"],"names":[],"mappings":";;;AAAA;;;;GAIG;AACH,+BAA0C;AAAjC,4FAAA,IAAI,OAAA;AAAE,kGAAA,UAAU,OAAA"}

package/src/lib/record/live-part.mjs

@@ -0,0 +1,7 @@
+/**
+ * The live part (parts.ts): a record's changes made elsewhere laid on it or waiting as a conflict, and who else has it
+ * open (live.ts) — asked of the data source's `subscribe` and `presence`. One of the parts that join a form (joins.ts),
+ * loaded through `recordLivePart` (live-later.ts) as a form is made whose source has either.
+ */
+export { join, liveRecord } from './live.mjs';
+//# sourceMappingURL=live-part.mjs.map

package/src/lib/record/live-part.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"live-part.mjs","sourceRoot":"","sources":["../../../../../../libs/core/src/lib/record/live-part.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC"}

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

@@ -0,0 +1,8 @@
+import type { FormInner } from './joins.mjs';
+import type { LiveRecord } from './live-later.mjs';
+/**
+ * The live part's side of a form (joins.ts): the record shown watched once it is loaded (`loaded`: at once where it was
+ * loaded before the part came), again as the form's state changes (`changed`), and let go with the form (`dispose`).
+ */
+export declare function join(context: FormInner): LiveRecord;
+export declare function liveRecord(context: FormInner): LiveRecord;

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

@@ -0,0 +1,8 @@
+import type { FormInner } from './joins';
+import type { LiveRecord } from './live-later';
+/**
+ * The live part's side of a form (joins.ts): the record shown watched once it is loaded (`loaded`: at once where it was
+ * loaded before the part came), again as the form's state changes (`changed`), and let go with the form (`dispose`).
+ */
+export declare function join(context: FormInner): LiveRecord;
+export declare function liveRecord(context: FormInner): LiveRecord;

package/src/lib/record/live.js

@@ -0,0 +1,133 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.join = join;
+exports.liveRecord = liveRecord;
+const data_source_1 = require("./data-source");
+const messages_1 = require("./messages");
+const form_1 = require("./form");
+const values_1 = require("./values");
+/**
+ * The record a form shows, made live (the data source's `subscribe` and `presence`): its changes made elsewhere asked
+ * for once it has an id, and who else has it open asked again as this person starts or stops changing it (`editing`).
+ * A change arriving waits for a save of the form's on its way (its answer may be that very change), and one carrying the
+ * form's own version is let go; without its values, the record is read again. Where the person changed nothing, it is
+ * laid on the record as stored, told (`arrived`) and said; after a change of theirs, it waits as the conflict a save would
+ * meet, their typing untouched. Nothing arriving for a record no longer shown is laid on the one shown.
+ */
+/**
+ * What stops a push: the source's own, or the one it gives once it is ready (the one-tag script's memory source asked
+ * before its members came).
+ */
+const stopOf = (given) => (typeof given === 'function' ? given : () => void Promise.resolve(given).then((stop) => typeof stop === 'function' && stop()));
+/**
+ * The live part's side of a form (joins.ts): the record shown watched once it is loaded (`loaded`: at once where it was
+ * loaded before the part came), again as the form's state changes (`changed`), and let go with the form (`dispose`).
+ */
+function join(context) {
+    const live = liveRecord(context);
+    return { ...live, loaded: live.watch, changed: live.watch, dispose: live.stop };
+}
+function liveRecord(context) {
+    const { page, fields } = context;
+    // A page of responses has no record to watch.
+    if (page.data.kind !== 'record')
+        return { watch: () => undefined, stop: () => undefined };
+    const source = context.options.dataSource;
+    const model = page.data.model;
+    let watchedId = null;
+    let watchedAt = -1;
+    let editing = false;
+    let stopChanges = null;
+    let stopPresence = null;
+    async function arrived(change, shown) {
+        const state = context.state();
+        const id = state.recordId;
+        const { messages } = context;
+        const say = (words, tone) => context.options.host?.say(words, tone);
+        if (change.type === 'deleted')
+            return say(change.by ? (0, messages_1.fillMessage)(messages, messages.deletedBy, { name: change.by }) : messages.deletedElsewhere, 'warning');
+        if (change.type !== 'record')
+            return;
+        await context.settled();
+        const ours = (version) => !!version && !!context.state().version && version.token === context.state().version?.token;
+        if (!shown() || ours(change.version))
+            return;
+        let theirs = change.values;
+        let version = change.version;
+        if (!theirs && source.load) {
+            const now = (0, data_source_1.loadedRecordOf)(await context.track(source.load({ model, id, fields })));
+            if (!shown())
+                return;
+            theirs = now.values;
+            version = now.version ?? version;
+        }
+        if (!theirs || ours(version))
+            return;
+        const told = {};
+        for (const [name, value] of Object.entries(theirs))
+            if (fields[name])
+                told[name] = (0, values_1.structuredCopy)(value);
+        const baseline = context.baseline();
+        const changed = Object.keys(fields).filter((name) => name in told && !context.same(name, baseline[name], told[name]));
+        const by = version?.by ?? change.by;
+        const at = version?.at ?? change.at;
+        const when = { ...(by ? { by } : {}), ...(at ? { at } : {}) };
+        // The person's work would be lost by laying their values over the record: it waits, as a save would meet it.
+        if ((0, form_1.unsavedWork)(context.state())) {
+            context.set({ conflict: context.conflictOf({ version: version ?? { token: '', ...when }, theirs: told }) });
+            context.emit('arrived', { recordId: id, ...when, fields: changed, conflict: true });
+            return;
+        }
+        if (changed.length)
+            context.store(Object.fromEntries(changed.map((name) => [name, told[name]])));
+        if (version)
+            context.set({ version });
+        if (!changed.length)
+            return;
+        context.emit('arrived', { recordId: id, ...when, fields: changed, conflict: false });
+        // Who changed what, said: "Mona Adel changed Price."
+        const labels = changed.map((name) => page.fields[name]?.label ?? name).join(', ');
+        say(by ? (0, messages_1.fill)(messages.changedBy, { name: by, fields: labels }) : (0, messages_1.fill)(messages.changedElsewhere, { fields: labels }), 'info');
+    }
+    return {
+        watch() {
+            const state = context.state();
+            if (state.status === 'loading')
+                return;
+            const id = state.recordId;
+            const again = id !== watchedId || context.generation() !== watchedAt;
+            const editingNow = state.dirty.length > 0;
+            if (!again && editingNow === editing)
+                return;
+            watchedId = id;
+            watchedAt = context.generation();
+            if (again) {
+                stopChanges?.();
+                stopChanges = null;
+                if (state.present?.length)
+                    context.set({ present: [] });
+            }
+            stopPresence?.();
+            stopPresence = null;
+            editing = editingNow;
+            if (id == null)
+                return;
+            const shown = context.shownNow();
+            if (again && source.subscribe)
+                stopChanges = stopOf(source.subscribe({ model, id, fields }, (change) => void (shown() && arrived(change, shown))));
+            if (source.presence) {
+                const me = context.options.user;
+                stopPresence = stopOf(source.presence({ model, id, ...(me ? { user: { id: me.id, ...(me.name ? { name: me.name } : {}) } } : {}), editing }, (people) => {
+                    if (shown())
+                        context.set({ present: people.filter((one) => !me || String(one.id) !== String(me.id)) });
+                }));
+            }
+        },
+        stop() {
+            stopChanges?.();
+            stopPresence?.();
+            stopChanges = stopPresence = null;
+        },
+    };
+}
+//# sourceMappingURL=live.js.map