@fieldia/core 0.30.1 → 0.31.0

package/src/lib/record/survey-kit.mjs

@@ -0,0 +1,96 @@
+import { askedInOrder, drawOrder, drawsOrder } from './order.mjs';
+import { quizResults } from './quiz.mjs';
+import { keepTime, WHOLE_FORM } from './timing.mjs';
+/**
+ * The survey flow's side of a form (joins.ts), made as the form is: the draw made where the page draws and the form has
+ * none yet — its first step the drawn one's while the person has not moved — and what a response is sent with told
+ * (`around`: the order shown, when the page's clock started and whether it ran out).
+ */
+export function join(host) {
+    const { page, form } = host;
+    const drawn = drawsOrder(page);
+    const time = keepTime({ page, scheduler: host.scheduler, clock: () => form.now().getTime(), state: () => form.getState(), set: host.set, steps: () => form.steps(), disposed: host.disposed, keep: host.keep });
+    const user = form.user()?.id;
+    const seed = host.options.seed ?? (user != null ? String(user) : null);
+    /** Each part's parts, by its id — what a draw kept in a draft may name — and the part each sits in. */
+    const partsOf = new Map();
+    const parents = new Map();
+    const walk = (node) => {
+        const children = Array.isArray(node.children) ? node.children : [];
+        if (node.id)
+            partsOf.set(node.id, new Set(children.map((child) => child.id ?? '')));
+        for (const child of children)
+            if (node.id && child.id)
+                parents.set(child.id, node.id);
+        children.forEach(walk);
+    };
+    walk(page.layout);
+    let undrawn = new Set();
+    /** The steps and the parts left out, as an order has them. */
+    function take(order) {
+        undrawn = new Set();
+        for (const [id, list] of Object.entries(order ?? {}))
+            for (const part of partsOf.get(id) ?? [])
+                if (!list.includes(part))
+                    undrawn.add(part);
+        host.order((page.layout.type === 'wizard' && order?.[page.layout.id]) || null);
+    }
+    const draw = () => drawOrder(page, seed ?? Math.random().toString(36).slice(2));
+    /** An order set, the first step the drawn one's while the person has not moved. */
+    function placed(order) {
+        const was = form.steps()[0];
+        take(order);
+        host.set({ order, ...(form.getState().step === was ? { step: form.steps()[0] ?? null } : {}) });
+    }
+    /** What a response is sent with of them: the order shown, when the page's clock started and whether it ran out. */
+    const told = () => {
+        const order = form.getState().order;
+        return { ...(order ? { order: order } : {}), ...time.told() };
+    };
+    const kit = {
+        hides: (id) => undrawn.has(id),
+        locks(id) {
+            const up = form.getState().timeUp;
+            if (!up.length)
+                return false;
+            if (up.includes(WHOLE_FORM))
+                return true;
+            for (let at = id; at; at = parents.get(at))
+                if (up.includes(at))
+                    return true;
+            return false;
+        },
+        kept() {
+            const state = form.getState();
+            return {
+                ...(state.order ? { order: state.order } : {}),
+                ...(Object.keys(state.timers).length ? { timers: Object.fromEntries(Object.entries(state.timers).map(([scope, at]) => [scope, new Date(at).toISOString()])) } : {}),
+            };
+        },
+        lay(draft) {
+            // Its draw, where every part it names is still the page's with the parts it lists.
+            const kept = Object.entries(draft.order ?? {}).filter(([id, list]) => partsOf.has(id) && Array.isArray(list) && list.every((one) => partsOf.get(id)?.has(one)));
+            if (drawn && kept.length)
+                placed(Object.fromEntries(kept));
+            const timers = Object.entries(draft.timers ?? {}).filter(([, at]) => typeof at === 'string' && !Number.isNaN(Date.parse(at)));
+            if (timers.length) {
+                host.set({ timers: { ...form.getState().timers, ...Object.fromEntries(timers.map(([scope, at]) => [scope, Date.parse(at)])) } });
+                time.arm();
+            }
+        },
+        around: (kind, sent, go) => go(kind === 'submit' ? { ...sent, ...told() } : sent),
+        reset() {
+            time.reset();
+            host.set({ timers: {}, timeUp: [] });
+            placed(drawn ? (seed === null ? draw() : form.getState().order ?? draw()) : null);
+        },
+        entered: (step) => time.entered(step),
+        start: () => time.start(),
+        countdown: () => time.countdown(),
+        marked: (values) => (page.quiz ? quizResults(page, values, askedInOrder(page, (form.getState().order ?? null), values)) ?? undefined : undefined),
+    };
+    if (drawn && !form.getState().order)
+        placed(draw());
+    return kit;
+}
+//# sourceMappingURL=survey-kit.mjs.map

package/src/lib/record/survey-kit.mjs.map

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

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

@@ -0,0 +1,16 @@
+import type { Page } from '../format/page.mjs';
+import { type Part } from '../parts.mjs';
+import type * as SurveyFlowModule from './surveyflow-part.mjs';
+/** The survey flow's form code (surveyflow-part.ts). */
+export type FormSurveyPart = typeof SurveyFlowModule;
+/**
+ * A survey's flow, the form's code of it — a quiz's results marked as its answers go, the order drawn for each
+ * respondent, a page's time limits (survey-kit.ts) — loaded by a form whose page has any (`surveyFlow`), and before such
+ * a page is drawn: in the one-tag script, one script with the viewer's (fieldia.surveyflow.js).
+ */
+export declare const formSurveyPart: Part<FormSurveyPart>;
+/**
+ * Whether a page goes through a survey's flow: a quiz, a review before sending, one question at a time, a time limit, or
+ * a part that draws its order or some of its questions. What each of them asks is the part's to tell.
+ */
+export declare const surveyFlow: (page: Page) => boolean;

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

@@ -0,0 +1,16 @@
+import type { Page } from '../format/page';
+import { type Part } from '../parts';
+import type * as SurveyFlowModule from './surveyflow-part';
+/** The survey flow's form code (surveyflow-part.ts). */
+export type FormSurveyPart = typeof SurveyFlowModule;
+/**
+ * A survey's flow, the form's code of it — a quiz's results marked as its answers go, the order drawn for each
+ * respondent, a page's time limits (survey-kit.ts) — loaded by a form whose page has any (`surveyFlow`), and before such
+ * a page is drawn: in the one-tag script, one script with the viewer's (fieldia.surveyflow.js).
+ */
+export declare const formSurveyPart: Part<FormSurveyPart>;
+/**
+ * Whether a page goes through a survey's flow: a quiz, a review before sending, one question at a time, a time limit, or
+ * a part that draws its order or some of its questions. What each of them asks is the part's to tell.
+ */
+export declare const surveyFlow: (page: Page) => boolean;

package/src/lib/record/survey.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.surveyFlow = exports.formSurveyPart = void 0;
+const parts_1 = require("../parts");
+/**
+ * A survey's flow, the form's code of it — a quiz's results marked as its answers go, the order drawn for each
+ * respondent, a page's time limits (survey-kit.ts) — loaded by a form whose page has any (`surveyFlow`), and before such
+ * a page is drawn: in the one-tag script, one script with the viewer's (fieldia.surveyflow.js).
+ */
+exports.formSurveyPart = (0, parts_1.lazyPart)('surveyflow', () => Promise.resolve().then(() => require('./surveyflow-part')));
+/**
+ * Whether a page goes through a survey's flow: a quiz, a review before sending, one question at a time, a time limit, or
+ * a part that draws its order or some of its questions. What each of them asks is the part's to tell.
+ */
+const surveyFlow = (page) => !!(page.quiz || page.review || page.flow || page.timeLimit) || /"order":"random"|"(draw|timeLimit)":/.test(JSON.stringify(page.layout));
+exports.surveyFlow = surveyFlow;
+//# sourceMappingURL=survey.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"survey.js","sourceRoot":"","sources":["../../../../../../libs/core/src/lib/record/survey.ts"],"names":[],"mappings":";;;AACA,oCAA+C;AAM/C;;;;GAIG;AACU,QAAA,cAAc,GAAyB,IAAA,gBAAQ,EAAC,YAAY,EAAE,GAAG,EAAE,sCAAQ,mBAAmB,EAAC,CAAC,CAAC;AAE9G;;;GAGG;AACI,MAAM,UAAU,GAAG,CAAC,IAAU,EAAW,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,sCAAsC,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;AAA9K,QAAA,UAAU,cAAoK"}

package/src/lib/record/survey.mjs

@@ -0,0 +1,13 @@
+import { lazyPart } from '../parts.mjs';
+/**
+ * A survey's flow, the form's code of it — a quiz's results marked as its answers go, the order drawn for each
+ * respondent, a page's time limits (survey-kit.ts) — loaded by a form whose page has any (`surveyFlow`), and before such
+ * a page is drawn: in the one-tag script, one script with the viewer's (fieldia.surveyflow.js).
+ */
+export const formSurveyPart = lazyPart('surveyflow', () => import('./surveyflow-part.mjs'));
+/**
+ * Whether a page goes through a survey's flow: a quiz, a review before sending, one question at a time, a time limit, or
+ * a part that draws its order or some of its questions. What each of them asks is the part's to tell.
+ */
+export const surveyFlow = (page) => !!(page.quiz || page.review || page.flow || page.timeLimit) || /"order":"random"|"(draw|timeLimit)":/.test(JSON.stringify(page.layout));
+//# sourceMappingURL=survey.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"survey.mjs","sourceRoot":"","sources":["../../../../../../libs/core/src/lib/record/survey.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAa,MAAM,UAAU,CAAC;AAM/C;;;;GAIG;AACH,MAAM,CAAC,MAAM,cAAc,GAAyB,QAAQ,CAAC,YAAY,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC,CAAC;AAE9G;;;GAGG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,IAAU,EAAW,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,sCAAsC,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC"}

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

@@ -0,0 +1,9 @@
+/**
+ * A survey's flow, the form's part of it (survey.ts, `formSurveyPart`): a quiz's results marked as its answers are sent
+ * (quiz.ts), the order drawn for each respondent (order.ts), a page's time limits (timing.ts), kept together for a form
+ * (survey-kit.ts). In the one-tag script, one script with the viewer's part of it (fieldia.surveyflow.js).
+ */
+export { quizResults } from './quiz.mjs';
+export { drawOrder, askedInOrder } from './order.mjs';
+export { limitsOf, countdownNow, keepTime } from './timing.mjs';
+export { join } from './survey-kit.mjs';

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

@@ -0,0 +1,9 @@
+/**
+ * A survey's flow, the form's part of it (survey.ts, `formSurveyPart`): a quiz's results marked as its answers are sent
+ * (quiz.ts), the order drawn for each respondent (order.ts), a page's time limits (timing.ts), kept together for a form
+ * (survey-kit.ts). In the one-tag script, one script with the viewer's part of it (fieldia.surveyflow.js).
+ */
+export { quizResults } from './quiz';
+export { drawOrder, askedInOrder } from './order';
+export { limitsOf, countdownNow, keepTime } from './timing';
+export { join } from './survey-kit';

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

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.join = exports.keepTime = exports.countdownNow = exports.limitsOf = exports.askedInOrder = exports.drawOrder = exports.quizResults = void 0;
+/**
+ * A survey's flow, the form's part of it (survey.ts, `formSurveyPart`): a quiz's results marked as its answers are sent
+ * (quiz.ts), the order drawn for each respondent (order.ts), a page's time limits (timing.ts), kept together for a form
+ * (survey-kit.ts). In the one-tag script, one script with the viewer's part of it (fieldia.surveyflow.js).
+ */
+var quiz_1 = require("./quiz");
+Object.defineProperty(exports, "quizResults", { enumerable: true, get: function () { return quiz_1.quizResults; } });
+var order_1 = require("./order");
+Object.defineProperty(exports, "drawOrder", { enumerable: true, get: function () { return order_1.drawOrder; } });
+Object.defineProperty(exports, "askedInOrder", { enumerable: true, get: function () { return order_1.askedInOrder; } });
+var timing_1 = require("./timing");
+Object.defineProperty(exports, "limitsOf", { enumerable: true, get: function () { return timing_1.limitsOf; } });
+Object.defineProperty(exports, "countdownNow", { enumerable: true, get: function () { return timing_1.countdownNow; } });
+Object.defineProperty(exports, "keepTime", { enumerable: true, get: function () { return timing_1.keepTime; } });
+var survey_kit_1 = require("./survey-kit");
+Object.defineProperty(exports, "join", { enumerable: true, get: function () { return survey_kit_1.join; } });
+//# sourceMappingURL=surveyflow-part.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"surveyflow-part.js","sourceRoot":"","sources":["../../../../../../libs/core/src/lib/record/surveyflow-part.ts"],"names":[],"mappings":";;;AAAA;;;;GAIG;AACH,+BAAqC;AAA5B,mGAAA,WAAW,OAAA;AACpB,iCAAkD;AAAzC,kGAAA,SAAS,OAAA;AAAE,qGAAA,YAAY,OAAA;AAChC,mCAA4D;AAAnD,kGAAA,QAAQ,OAAA;AAAE,sGAAA,YAAY,OAAA;AAAE,kGAAA,QAAQ,OAAA;AACzC,2CAAoC;AAA3B,kGAAA,IAAI,OAAA"}

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

@@ -0,0 +1,10 @@
+/**
+ * A survey's flow, the form's part of it (survey.ts, `formSurveyPart`): a quiz's results marked as its answers are sent
+ * (quiz.ts), the order drawn for each respondent (order.ts), a page's time limits (timing.ts), kept together for a form
+ * (survey-kit.ts). In the one-tag script, one script with the viewer's part of it (fieldia.surveyflow.js).
+ */
+export { quizResults } from './quiz.mjs';
+export { drawOrder, askedInOrder } from './order.mjs';
+export { limitsOf, countdownNow, keepTime } from './timing.mjs';
+export { join } from './survey-kit.mjs';
+//# sourceMappingURL=surveyflow-part.mjs.map

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

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

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":";;;AA2CA,4BAMC;AAGD,kCAIC;AAMD,oCAOC;AAsCD,4BA8CC;AApJD;;;;GAIG;AAEH,wDAAwD;AAC3C,QAAA,UAAU,GAAG,OAAO,CAAC;AAClC,MAAM,MAAM,GAAG,MAAM,CAAC;AAqBtB,SAAS,OAAO,CAAC,KAAa,EAAE,KAAgB,EAAE,IAAa;IAC7D,MAAM,EAAE,GAAG,KAAK,CAAC,OAAO,GAAG,MAAM,CAAC;IAClC,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,GAAG,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;AACtI,CAAC;AAED,wFAAwF;AACjF,MAAM,KAAK,GAAG,CAAC,IAAU,EAAW,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,WAAW,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;AAAlL,QAAA,KAAK,SAA6K;AAE/L,yFAAyF;AACzF,SAAgB,QAAQ,CAAC,IAAU;IACjC,MAAM,GAAG,GAA0B,EAAE,CAAC;IACtC,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,WAAW;QAAE,OAAO,GAAG,CAAC;IAC/C,IAAI,IAAI,CAAC,SAAS;QAAE,GAAG,CAAC,kBAAU,CAAC,GAAG,OAAO,CAAC,kBAAU,EAAE,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;IACjF,IAAI,IAAI,CAAC,MAAM,CAAC,IAAI,KAAK,QAAQ;QAAE,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,MAAM,CAAC,QAAQ;YAAE,IAAI,IAAI,CAAC,SAAS;gBAAE,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;IACtJ,OAAO,GAAG,CAAC;AACb,CAAC;AAED,mDAAmD;AACnD,SAAgB,WAAW,CAAC,KAAY,EAAE,OAAe,EAAE,GAAW;IACpE,MAAM,IAAI,GAAG,OAAO,GAAG,KAAK,CAAC,EAAE,CAAC;IAChC,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,GAAG,GAAG,CAAC,CAAC;IACrC,OAAO,EAAE,GAAG,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC;AACpH,CAAC;AAED;;;GAGG;AACH,SAAgB,YAAY,CAAC,IAAU,EAAE,MAAwC,EAAE,IAAmB,EAAE,GAAW;IACjH,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC9B,MAAM,KAAK,GAAG,MAAM,CAAC,kBAAU,CAAC,CAAC;IACjC,IAAI,KAAK,IAAI,MAAM,CAAC,kBAAU,CAAC,KAAK,SAAS;QAAE,OAAO,WAAW,CAAC,KAAK,EAAE,MAAM,CAAC,kBAAU,CAAC,EAAE,GAAG,CAAC,CAAC;IAClG,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC5C,IAAI,GAAG,IAAI,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,SAAS;QAAE,OAAO,WAAW,CAAC,GAAG,EAAE,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC,CAAC;IAC5F,OAAO,IAAI,CAAC;AACd,CAAC;AAiCD;;;;GAIG;AACH,SAAgB,QAAQ,CAAC,IAAc;IACrC,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,IAAI,CAAC;IACjC,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC9B,MAAM,OAAO,GAAG,IAAI,GAAG,EAAmB,CAAC;IAC3C,MAAM,KAAK,GAAG,CAAC,KAAa,EAAE,EAAE;QAC9B,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC;QAC3B,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,SAAS;YAAE,OAAO;QAChE,IAAI,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,EAAE,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,EAAE,IAAI,CAAC,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC;QACjE,GAAG,CAAC,GAAG,EAAE,CAAC;QACV,IAAI,CAAC,IAAI,EAAE,CAAC;IACd,CAAC,CAAC;IACF,SAAS,MAAM,CAAC,KAAa;QAC3B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACtB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC;QAC3B,IAAI,IAAI,CAAC,QAAQ,EAAE,IAAI,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,IAAI;YAAE,OAAO;QAC1E,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC;QAC3B,MAAM,SAAS,GAAG,KAAK,KAAK,kBAAU,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,KAAK,MAAM,IAAI,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAC9I,IAAI,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;IACxG,CAAC;IACD,MAAM,GAAG,GAAY;QACnB,KAAK,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,kBAAU,CAAC;QAC9B,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC;QAC9B,GAAG;YACD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC;YAC3B,KAAK,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;gBACpD,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gBACpC,IAAI,OAAO,KAAK,SAAS,IAAI,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC;oBAAE,SAAS;gBAC1F,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,SAAS,CAAC,UAAU,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,GAAG,KAAK,CAAC,EAAE,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC;YAChH,CAAC;QACH,CAAC;QACD,KAAK;YACH,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,MAAM,EAAE;gBAAE,SAAS,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;YACpE,OAAO,CAAC,KAAK,EAAE,CAAC;QAClB,CAAC;QACD,SAAS;YACP,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC;YAC3B,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,EAAE,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;YACvE,OAAO,GAAG,IAAI,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,GAAG,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC;QAC1F,CAAC;QACD,IAAI;YACF,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC;YAC3B,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC,kBAAU,CAAC,CAAC;YACzC,OAAO,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,IAAI,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,kBAAU,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACxK,CAAC;KACF,CAAC;IACF,OAAO,GAAG,CAAC;AACb,CAAC"}

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