@fieldia/core 0.30.0 → 0.31.0

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

@@ -0,0 +1,76 @@
+import type { Page } from '../format/page.mjs';
+import type { FormState } from './form.mjs';
+import type { Scheduler } from './scheduler.mjs';
+/**
+ * A page's time limits (`timeLimit` on the page and on a wizard's steps), the survey flow's part's: what each allows, when it
+ * warns and what it does as it runs out, and the countdown showing now — the page's while it runs, else the step on
+ * screen's. The form keeps when each started (`state.timers`, kept in its drafts) and which ran out (`state.timeUp`).
+ */
+/** The page's own limit's scope: a step's is its id. */
+export declare const WHOLE_FORM = "#form";
+/** A time limit as it is kept to: in ms, its warning's too, what it does. */
+export interface Limit {
+    scope: string;
+    ms: number;
+    warnMs: number;
+    then: 'send' | 'lock';
+}
+/** The countdown showing now. */
+export interface Countdown extends Limit {
+    /** When it started and ends, by the form's clock (ms). */
+    started: number;
+    ends: number;
+    /** What is left, in ms, never below 0. */
+    left: number;
+    /** Running, past its warning, or run out. */
+    stage: 'running' | 'warning' | 'up';
+}
+/** Whether a page of responses has a time limit: its own (`timeLimit`), or a step's. */
+export declare const timed: (page: Page) => boolean;
+/** Every time limit of a page, by scope: the page's (`#form`), each step's by its id. */
+export declare function limitsOf(page: Page): Record<string, Limit>;
+/** A limit's countdown, started then, read now. */
+export declare function countdownOf(limit: Limit, started: number, now: number): Countdown;
+/**
+ * The countdown showing now: the page's while it runs (or has run out), else the step's on screen; null where neither
+ * has started.
+ */
+export declare function countdownNow(page: Page, timers: Readonly<Record<string, number>>, step: string | null, now: number): Countdown | null;
+/** What a form's time limits ask of the form they are kept for. */
+export interface TimeHost {
+    readonly page: Page;
+    readonly scheduler: Scheduler;
+    /** Now, in ms, by the form's clock. */
+    clock(): number;
+    state(): FormState;
+    set(patch: Partial<FormState>): void;
+    /** The steps shown now, in their order. */
+    steps(): string[];
+    disposed(): boolean;
+    /** Keep a draft soon, where the form keeps drafts: a clock started is kept at once. */
+    keep(): void;
+}
+/** A form's time limits, kept (`keepTime`). */
+export interface TimeKit {
+    /** The page's limit started: its Start pressed. */
+    start(): void;
+    /** A step entered: its own limit, if any, starts the first time. */
+    entered(step: string): void;
+    /** Each started limit set to run out on time — at once, for one past its end. */
+    arm(): void;
+    /** Started again: no limit started, none set to run out. */
+    reset(): void;
+    /** The countdown showing now. */
+    countdown(): Countdown | null;
+    /** What a send tells of the page's limit: when it started, whether it ran out. */
+    told(): {
+        started?: string;
+        timeUp?: boolean;
+    };
+}
+/**
+ * A form's time limits: each started limit set to run out on the form's clock; as it does, its answers locked
+ * (`state.timeUp`) and — a step's that locks, on screen — the form gone on to the next step. A page's whose answers go
+ * as it runs out leaves the send to the viewer (or the app), which watches `timeUp`.
+ */
+export declare function keepTime(host: TimeHost): TimeKit;

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

@@ -0,0 +1,76 @@
+import type { Page } from '../format/page';
+import type { FormState } from './form';
+import type { Scheduler } from './scheduler';
+/**
+ * A page's time limits (`timeLimit` on the page and on a wizard's steps), the survey flow's part's: what each allows, when it
+ * warns and what it does as it runs out, and the countdown showing now — the page's while it runs, else the step on
+ * screen's. The form keeps when each started (`state.timers`, kept in its drafts) and which ran out (`state.timeUp`).
+ */
+/** The page's own limit's scope: a step's is its id. */
+export declare const WHOLE_FORM = "#form";
+/** A time limit as it is kept to: in ms, its warning's too, what it does. */
+export interface Limit {
+    scope: string;
+    ms: number;
+    warnMs: number;
+    then: 'send' | 'lock';
+}
+/** The countdown showing now. */
+export interface Countdown extends Limit {
+    /** When it started and ends, by the form's clock (ms). */
+    started: number;
+    ends: number;
+    /** What is left, in ms, never below 0. */
+    left: number;
+    /** Running, past its warning, or run out. */
+    stage: 'running' | 'warning' | 'up';
+}
+/** Whether a page of responses has a time limit: its own (`timeLimit`), or a step's. */
+export declare const timed: (page: Page) => boolean;
+/** Every time limit of a page, by scope: the page's (`#form`), each step's by its id. */
+export declare function limitsOf(page: Page): Record<string, Limit>;
+/** A limit's countdown, started then, read now. */
+export declare function countdownOf(limit: Limit, started: number, now: number): Countdown;
+/**
+ * The countdown showing now: the page's while it runs (or has run out), else the step's on screen; null where neither
+ * has started.
+ */
+export declare function countdownNow(page: Page, timers: Readonly<Record<string, number>>, step: string | null, now: number): Countdown | null;
+/** What a form's time limits ask of the form they are kept for. */
+export interface TimeHost {
+    readonly page: Page;
+    readonly scheduler: Scheduler;
+    /** Now, in ms, by the form's clock. */
+    clock(): number;
+    state(): FormState;
+    set(patch: Partial<FormState>): void;
+    /** The steps shown now, in their order. */
+    steps(): string[];
+    disposed(): boolean;
+    /** Keep a draft soon, where the form keeps drafts: a clock started is kept at once. */
+    keep(): void;
+}
+/** A form's time limits, kept (`keepTime`). */
+export interface TimeKit {
+    /** The page's limit started: its Start pressed. */
+    start(): void;
+    /** A step entered: its own limit, if any, starts the first time. */
+    entered(step: string): void;
+    /** Each started limit set to run out on time — at once, for one past its end. */
+    arm(): void;
+    /** Started again: no limit started, none set to run out. */
+    reset(): void;
+    /** The countdown showing now. */
+    countdown(): Countdown | null;
+    /** What a send tells of the page's limit: when it started, whether it ran out. */
+    told(): {
+        started?: string;
+        timeUp?: boolean;
+    };
+}
+/**
+ * A form's time limits: each started limit set to run out on the form's clock; as it does, its answers locked
+ * (`state.timeUp`) and — a step's that locks, on screen — the form gone on to the next step. A page's whose answers go
+ * as it runs out leaves the send to the viewer (or the app), which watches `timeUp`.
+ */
+export declare function keepTime(host: TimeHost): TimeKit;

package/src/lib/record/timing.js

@@ -0,0 +1,112 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.timed = exports.WHOLE_FORM = void 0;
+exports.limitsOf = limitsOf;
+exports.countdownOf = countdownOf;
+exports.countdownNow = countdownNow;
+exports.keepTime = keepTime;
+/**
+ * A page's time limits (`timeLimit` on the page and on a wizard's steps), the survey flow's part's: what each allows, when it
+ * warns and what it does as it runs out, and the countdown showing now — the page's while it runs, else the step on
+ * screen's. The form keeps when each started (`state.timers`, kept in its drafts) and which ran out (`state.timeUp`).
+ */
+/** The page's own limit's scope: a step's is its id. */
+exports.WHOLE_FORM = '#form';
+const MINUTE = 60_000;
+function limitOf(scope, limit, step) {
+    const ms = limit.minutes * MINUTE;
+    return { scope, ms, warnMs: (limit.warn ?? Math.min(1, limit.minutes / 5)) * MINUTE, then: limit.then ?? (step ? 'lock' : 'send') };
+}
+/** Whether a page of responses has a time limit: its own (`timeLimit`), or a step's. */
+const timed = (page) => page.data.kind === 'responses' && (!!page.timeLimit || (page.layout.type === 'wizard' && page.layout.children.some((step) => !!step.timeLimit)));
+exports.timed = timed;
+/** Every time limit of a page, by scope: the page's (`#form`), each step's by its id. */
+function limitsOf(page) {
+    const out = {};
+    if (page.data.kind !== 'responses')
+        return out;
+    if (page.timeLimit)
+        out[exports.WHOLE_FORM] = limitOf(exports.WHOLE_FORM, page.timeLimit, false);
+    if (page.layout.type === 'wizard')
+        for (const step of page.layout.children)
+            if (step.timeLimit)
+                out[step.id] = limitOf(step.id, step.timeLimit, true);
+    return out;
+}
+/** A limit's countdown, started then, read now. */
+function countdownOf(limit, started, now) {
+    const ends = started + limit.ms;
+    const left = Math.max(0, ends - now);
+    return { ...limit, started, ends, left, stage: left === 0 ? 'up' : left <= limit.warnMs ? 'warning' : 'running' };
+}
+/**
+ * The countdown showing now: the page's while it runs (or has run out), else the step's on screen; null where neither
+ * has started.
+ */
+function countdownNow(page, timers, step, now) {
+    const limits = limitsOf(page);
+    const whole = limits[exports.WHOLE_FORM];
+    if (whole && timers[exports.WHOLE_FORM] !== undefined)
+        return countdownOf(whole, timers[exports.WHOLE_FORM], now);
+    const own = step ? limits[step] : undefined;
+    if (own && timers[own.scope] !== undefined)
+        return countdownOf(own, timers[own.scope], now);
+    return null;
+}
+/**
+ * A form's time limits: each started limit set to run out on the form's clock; as it does, its answers locked
+ * (`state.timeUp`) and — a step's that locks, on screen — the form gone on to the next step. A page's whose answers go
+ * as it runs out leaves the send to the viewer (or the app), which watches `timeUp`.
+ */
+function keepTime(host) {
+    const { page, scheduler } = host;
+    const limits = limitsOf(page);
+    const running = new Map();
+    const begin = (scope) => {
+        const state = host.state();
+        if (!limits[scope] || state.timers[scope] !== undefined)
+            return;
+        host.set({ timers: { ...state.timers, [scope]: host.clock() } });
+        kit.arm();
+        host.keep();
+    };
+    function ranOut(scope) {
+        running.delete(scope);
+        const state = host.state();
+        if (host.disposed() || state.timeUp.includes(scope) || state.sent)
+            return;
+        const shown = host.steps();
+        const following = scope !== exports.WHOLE_FORM && limits[scope].then === 'lock' && state.step === scope ? shown[shown.indexOf(scope) + 1] : undefined;
+        host.set({ timeUp: [...state.timeUp, scope], ...(following ? { step: following, errors: {} } : {}) });
+    }
+    const kit = {
+        start: () => begin(exports.WHOLE_FORM),
+        entered: (step) => begin(step),
+        arm() {
+            const state = host.state();
+            for (const [scope, limit] of Object.entries(limits)) {
+                const started = state.timers[scope];
+                if (started === undefined || state.timeUp.includes(scope) || running.has(scope))
+                    continue;
+                running.set(scope, scheduler.setTimeout(() => ranOut(scope), Math.max(0, started + limit.ms - host.clock())));
+            }
+        },
+        reset() {
+            for (const timer of running.values())
+                scheduler.clearTimeout(timer);
+            running.clear();
+        },
+        countdown() {
+            const state = host.state();
+            const now = countdownNow(page, state.timers, state.step, host.clock());
+            return now && state.timeUp.includes(now.scope) ? { ...now, left: 0, stage: 'up' } : now;
+        },
+        told() {
+            const state = host.state();
+            const started = state.timers[exports.WHOLE_FORM];
+            return started !== undefined ? { started: new Date(started).toISOString(), timeUp: state.timeUp.includes(exports.WHOLE_FORM) } : state.timeUp.length ? { timeUp: false } : {};
+        },
+    };
+    return kit;
+}
+//# sourceMappingURL=timing.js.map

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

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

package/src/lib/record/timing.mjs

@@ -0,0 +1,104 @@
+/**
+ * A page's time limits (`timeLimit` on the page and on a wizard's steps), the survey flow's part's: what each allows, when it
+ * warns and what it does as it runs out, and the countdown showing now — the page's while it runs, else the step on
+ * screen's. The form keeps when each started (`state.timers`, kept in its drafts) and which ran out (`state.timeUp`).
+ */
+/** The page's own limit's scope: a step's is its id. */
+export const WHOLE_FORM = '#form';
+const MINUTE = 60_000;
+function limitOf(scope, limit, step) {
+    const ms = limit.minutes * MINUTE;
+    return { scope, ms, warnMs: (limit.warn ?? Math.min(1, limit.minutes / 5)) * MINUTE, then: limit.then ?? (step ? 'lock' : 'send') };
+}
+/** Whether a page of responses has a time limit: its own (`timeLimit`), or a step's. */
+export const timed = (page) => page.data.kind === 'responses' && (!!page.timeLimit || (page.layout.type === 'wizard' && page.layout.children.some((step) => !!step.timeLimit)));
+/** Every time limit of a page, by scope: the page's (`#form`), each step's by its id. */
+export function limitsOf(page) {
+    const out = {};
+    if (page.data.kind !== 'responses')
+        return out;
+    if (page.timeLimit)
+        out[WHOLE_FORM] = limitOf(WHOLE_FORM, page.timeLimit, false);
+    if (page.layout.type === 'wizard')
+        for (const step of page.layout.children)
+            if (step.timeLimit)
+                out[step.id] = limitOf(step.id, step.timeLimit, true);
+    return out;
+}
+/** A limit's countdown, started then, read now. */
+export function countdownOf(limit, started, now) {
+    const ends = started + limit.ms;
+    const left = Math.max(0, ends - now);
+    return { ...limit, started, ends, left, stage: left === 0 ? 'up' : left <= limit.warnMs ? 'warning' : 'running' };
+}
+/**
+ * The countdown showing now: the page's while it runs (or has run out), else the step's on screen; null where neither
+ * has started.
+ */
+export function countdownNow(page, timers, step, now) {
+    const limits = limitsOf(page);
+    const whole = limits[WHOLE_FORM];
+    if (whole && timers[WHOLE_FORM] !== undefined)
+        return countdownOf(whole, timers[WHOLE_FORM], now);
+    const own = step ? limits[step] : undefined;
+    if (own && timers[own.scope] !== undefined)
+        return countdownOf(own, timers[own.scope], now);
+    return null;
+}
+/**
+ * A form's time limits: each started limit set to run out on the form's clock; as it does, its answers locked
+ * (`state.timeUp`) and — a step's that locks, on screen — the form gone on to the next step. A page's whose answers go
+ * as it runs out leaves the send to the viewer (or the app), which watches `timeUp`.
+ */
+export function keepTime(host) {
+    const { page, scheduler } = host;
+    const limits = limitsOf(page);
+    const running = new Map();
+    const begin = (scope) => {
+        const state = host.state();
+        if (!limits[scope] || state.timers[scope] !== undefined)
+            return;
+        host.set({ timers: { ...state.timers, [scope]: host.clock() } });
+        kit.arm();
+        host.keep();
+    };
+    function ranOut(scope) {
+        running.delete(scope);
+        const state = host.state();
+        if (host.disposed() || state.timeUp.includes(scope) || state.sent)
+            return;
+        const shown = host.steps();
+        const following = scope !== WHOLE_FORM && limits[scope].then === 'lock' && state.step === scope ? shown[shown.indexOf(scope) + 1] : undefined;
+        host.set({ timeUp: [...state.timeUp, scope], ...(following ? { step: following, errors: {} } : {}) });
+    }
+    const kit = {
+        start: () => begin(WHOLE_FORM),
+        entered: (step) => begin(step),
+        arm() {
+            const state = host.state();
+            for (const [scope, limit] of Object.entries(limits)) {
+                const started = state.timers[scope];
+                if (started === undefined || state.timeUp.includes(scope) || running.has(scope))
+                    continue;
+                running.set(scope, scheduler.setTimeout(() => ranOut(scope), Math.max(0, started + limit.ms - host.clock())));
+            }
+        },
+        reset() {
+            for (const timer of running.values())
+                scheduler.clearTimeout(timer);
+            running.clear();
+        },
+        countdown() {
+            const state = host.state();
+            const now = countdownNow(page, state.timers, state.step, host.clock());
+            return now && state.timeUp.includes(now.scope) ? { ...now, left: 0, stage: 'up' } : now;
+        },
+        told() {
+            const state = host.state();
+            const started = state.timers[WHOLE_FORM];
+            return started !== undefined ? { started: new Date(started).toISOString(), timeUp: state.timeUp.includes(WHOLE_FORM) } : state.timeUp.length ? { timeUp: false } : {};
+        },
+    };
+    return kit;
+}
+//# sourceMappingURL=timing.mjs.map

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

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

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

@@ -0,0 +1,9 @@
+import { type Part } from '../parts.mjs';
+import type * as UndoModule from './undo-part.mjs';
+/** The undo part: Undo and Redo through a record's changes (history-steps.ts), and a one-tap press said with Undo and taken back (press-undo.ts). */
+export type PressUndoPart = typeof UndoModule;
+/**
+ * Undo, loaded as a person first changes a record (Ctrl+Z walks the changes), with a page whose buttons offer it, or as
+ * an answer first brings one.
+ */
+export declare const pressUndoPart: Part<PressUndoPart>;

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

@@ -0,0 +1,9 @@
+import { type Part } from '../parts';
+import type * as UndoModule from './undo-part';
+/** The undo part: Undo and Redo through a record's changes (history-steps.ts), and a one-tap press said with Undo and taken back (press-undo.ts). */
+export type PressUndoPart = typeof UndoModule;
+/**
+ * Undo, loaded as a person first changes a record (Ctrl+Z walks the changes), with a page whose buttons offer it, or as
+ * an answer first brings one.
+ */
+export declare const pressUndoPart: Part<PressUndoPart>;

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

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.pressUndoPart = void 0;
+const parts_1 = require("../parts");
+/**
+ * Undo, loaded as a person first changes a record (Ctrl+Z walks the changes), with a page whose buttons offer it, or as
+ * an answer first brings one.
+ */
+exports.pressUndoPart = (0, parts_1.lazyPart)('undo', () => Promise.resolve().then(() => require('./undo-part')));
+//# sourceMappingURL=undo-later.js.map

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

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

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

@@ -0,0 +1,7 @@
+import { lazyPart } from '../parts.mjs';
+/**
+ * Undo, loaded as a person first changes a record (Ctrl+Z walks the changes), with a page whose buttons offer it, or as
+ * an answer first brings one.
+ */
+export const pressUndoPart = lazyPart('undo', () => import('./undo-part.mjs'));
+//# sourceMappingURL=undo-later.mjs.map

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

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

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

@@ -0,0 +1,8 @@
+/**
+ * The undo part (parts.ts): Undo and Redo walking a record's changes as the form keeps them (history-steps.ts), asked
+ * for as the first is kept; and a one-tap press that offers Undo (a button's or a menu item's `undo`, or the app
+ * answering with one) said with Undo once it ends, and taken back when it is pressed (press-undo.ts). Loaded through
+ * `pressUndoPart` (undo-later.ts).
+ */
+export { offerUndo, takeBack } from './press-undo.mjs';
+export { nextSteps, takeNoted, takeStep } from './history-steps.mjs';

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

@@ -0,0 +1,8 @@
+/**
+ * The undo part (parts.ts): Undo and Redo walking a record's changes as the form keeps them (history-steps.ts), asked
+ * for as the first is kept; and a one-tap press that offers Undo (a button's or a menu item's `undo`, or the app
+ * answering with one) said with Undo once it ends, and taken back when it is pressed (press-undo.ts). Loaded through
+ * `pressUndoPart` (undo-later.ts).
+ */
+export { offerUndo, takeBack } from './press-undo';
+export { nextSteps, takeNoted, takeStep } from './history-steps';

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

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.takeStep = exports.takeNoted = exports.nextSteps = exports.takeBack = exports.offerUndo = void 0;
+/**
+ * The undo part (parts.ts): Undo and Redo walking a record's changes as the form keeps them (history-steps.ts), asked
+ * for as the first is kept; and a one-tap press that offers Undo (a button's or a menu item's `undo`, or the app
+ * answering with one) said with Undo once it ends, and taken back when it is pressed (press-undo.ts). Loaded through
+ * `pressUndoPart` (undo-later.ts).
+ */
+var press_undo_1 = require("./press-undo");
+Object.defineProperty(exports, "offerUndo", { enumerable: true, get: function () { return press_undo_1.offerUndo; } });
+Object.defineProperty(exports, "takeBack", { enumerable: true, get: function () { return press_undo_1.takeBack; } });
+var history_steps_1 = require("./history-steps");
+Object.defineProperty(exports, "nextSteps", { enumerable: true, get: function () { return history_steps_1.nextSteps; } });
+Object.defineProperty(exports, "takeNoted", { enumerable: true, get: function () { return history_steps_1.takeNoted; } });
+Object.defineProperty(exports, "takeStep", { enumerable: true, get: function () { return history_steps_1.takeStep; } });
+//# sourceMappingURL=undo-part.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"undo-part.js","sourceRoot":"","sources":["../../../../../../libs/core/src/lib/record/undo-part.ts"],"names":[],"mappings":";;;AAAA;;;;;GAKG;AACH,2CAAmD;AAA1C,uGAAA,SAAS,OAAA;AAAE,sGAAA,QAAQ,OAAA;AAC5B,iDAAiE;AAAxD,0GAAA,SAAS,OAAA;AAAE,0GAAA,SAAS,OAAA;AAAE,yGAAA,QAAQ,OAAA"}

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

@@ -0,0 +1,9 @@
+/**
+ * The undo part (parts.ts): Undo and Redo walking a record's changes as the form keeps them (history-steps.ts), asked
+ * for as the first is kept; and a one-tap press that offers Undo (a button's or a menu item's `undo`, or the app
+ * answering with one) said with Undo once it ends, and taken back when it is pressed (press-undo.ts). Loaded through
+ * `pressUndoPart` (undo-later.ts).
+ */
+export { offerUndo, takeBack } from './press-undo.mjs';
+export { nextSteps, takeNoted, takeStep } from './history-steps.mjs';
+//# sourceMappingURL=undo-part.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"undo-part.mjs","sourceRoot":"","sources":["../../../../../../libs/core/src/lib/record/undo-part.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC"}

package/src/lib/record/upload-to-later.d.mts

@@ -0,0 +1,10 @@
+import type { UploadedFile, UploadFile, UploadRequest } from './data-source.mjs';
+import type { UploadToOptions } from './upload-to.mjs';
+/**
+ * A data source's `upload` for a plain endpoint (upload-to.ts): what an app writes once, at once — its work in the files
+ * part, which a page with a file field loads before it is drawn, asked for here as the first file goes. A page with no
+ * file never downloads it.
+ *
+ *   upload: uploadTo({ url: '/api/files', headers: { 'X-CSRF-Token': token } })
+ */
+export declare function uploadTo(options: UploadToOptions): (file: UploadFile, request: UploadRequest) => Promise<UploadedFile>;

package/src/lib/record/upload-to-later.d.ts

@@ -0,0 +1,10 @@
+import type { UploadedFile, UploadFile, UploadRequest } from './data-source';
+import type { UploadToOptions } from './upload-to';
+/**
+ * A data source's `upload` for a plain endpoint (upload-to.ts): what an app writes once, at once — its work in the files
+ * part, which a page with a file field loads before it is drawn, asked for here as the first file goes. A page with no
+ * file never downloads it.
+ *
+ *   upload: uploadTo({ url: '/api/files', headers: { 'X-CSRF-Token': token } })
+ */
+export declare function uploadTo(options: UploadToOptions): (file: UploadFile, request: UploadRequest) => Promise<UploadedFile>;

package/src/lib/record/upload-to-later.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.uploadTo = uploadTo;
+const uploads_1 = require("./uploads");
+/**
+ * A data source's `upload` for a plain endpoint (upload-to.ts): what an app writes once, at once — its work in the files
+ * part, which a page with a file field loads before it is drawn, asked for here as the first file goes. A page with no
+ * file never downloads it.
+ *
+ *   upload: uploadTo({ url: '/api/files', headers: { 'X-CSRF-Token': token } })
+ */
+function uploadTo(options) {
+    return (file, request) => uploads_1.formUploadsPart.load().then((part) => part.uploadTo(options)(file, request));
+}
+//# sourceMappingURL=upload-to-later.js.map

package/src/lib/record/upload-to-later.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload-to-later.js","sourceRoot":"","sources":["../../../../../../libs/core/src/lib/record/upload-to-later.ts"],"names":[],"mappings":";;AAWA,4BAEC;AAXD,uCAA4C;AAE5C;;;;;;GAMG;AACH,SAAgB,QAAQ,CAAC,OAAwB;IAC/C,OAAO,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,CAAC,yBAAe,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;AACzG,CAAC"}

package/src/lib/record/upload-to-later.mjs

@@ -0,0 +1,12 @@
+import { formUploadsPart } from './uploads.mjs';
+/**
+ * A data source's `upload` for a plain endpoint (upload-to.ts): what an app writes once, at once — its work in the files
+ * part, which a page with a file field loads before it is drawn, asked for here as the first file goes. A page with no
+ * file never downloads it.
+ *
+ *   upload: uploadTo({ url: '/api/files', headers: { 'X-CSRF-Token': token } })
+ */
+export function uploadTo(options) {
+    return (file, request) => formUploadsPart.load().then((part) => part.uploadTo(options)(file, request));
+}
+//# sourceMappingURL=upload-to-later.mjs.map

package/src/lib/record/upload-to-later.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload-to-later.mjs","sourceRoot":"","sources":["../../../../../../libs/core/src/lib/record/upload-to-later.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAE5C;;;;;;GAMG;AACH,MAAM,UAAU,QAAQ,CAAC,OAAwB;IAC/C,OAAO,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,CAAC,eAAe,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;AACzG,CAAC"}

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

@@ -92,6 +92,11 @@ export interface UploadsHost {
     } | undefined, value: Value, quiet: boolean): void;
     changed(uploads: readonly FileUpload[]): void;
     track<T>(promise: Promise<T>): Promise<T>;
+    /**
+     * An upload through the parts that join the form (form.ts): on a page with an offline outbox, a file the network
+     * could not take comes back as its bytes, kept in its field to go with the send.
+     */
+    through<T>(kind: 'upload', file: UploadFile, send: (file: UploadFile) => Promise<T>): Promise<T | null>;
 }
 /** A file on its way, as the uploads keep it (the state shows each as a `FileUpload`). */
 export interface Entry {

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

@@ -92,6 +92,11 @@ export interface UploadsHost {
     } | undefined, value: Value, quiet: boolean): void;
     changed(uploads: readonly FileUpload[]): void;
     track<T>(promise: Promise<T>): Promise<T>;
+    /**
+     * An upload through the parts that join the form (form.ts): on a page with an offline outbox, a file the network
+     * could not take comes back as its bytes, kept in its field to go with the send.
+     */
+    through<T>(kind: 'upload', file: UploadFile, send: (file: UploadFile) => Promise<T>): Promise<T | null>;
 }
 /** A file on its way, as the uploads keep it (the state shows each as a `FileUpload`). */
 export interface Entry {