@fieldia/core 0.30.1 → 0.31.1

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

@@ -0,0 +1,37 @@
+import type { StoredDraft } from './data-source';
+import type { FormInner, FormJoin } from './joins';
+import { type QuizResults } from './quiz';
+import type { Values } from './values';
+import { type Countdown } from './timing';
+/**
+ * A survey's draw and clocks, kept for a form by the survey flow's part (survey.ts, `formSurveyPart`): the order drawn for each
+ * respondent and the parts it leaves out (order.ts), and a page's time limits (timing.ts) — what the form asks of them
+ * at its moments: a part hidden or locked, a draft kept and laid, a send told, a response started again, a step entered.
+ */
+/** A form's survey draw and clocks (`join`; `form.joined('surveyflow')`): its hooks into the form, and its own. */
+export interface SurveyKit extends FormJoin {
+    /** Whether a part was left out by the draw: never shown, asked, required or sent. */
+    hides(id: string): boolean;
+    /** Whether a part's time ran out — the page's, or that of the step it is on: locked, its checks refusing nothing. */
+    locks(id: string): boolean;
+    /** What a draft keeps of them: the draw, the clocks' starts. */
+    kept(): Pick<StoredDraft, 'order' | 'timers'>;
+    /** A draft laid: its draw where the page still has it, its clocks going on from their starts. */
+    lay(draft: StoredDraft): void;
+    /** Started again, a new respondent: drawn anew (unless the app or the person's id is the seed), no clock running, on the first step drawn. */
+    reset(): void;
+    /** A step entered: its own clock starts the first time. */
+    entered(step: string): void;
+    /** The page's clock started: its Start pressed. */
+    start(): void;
+    /** The countdown showing now. */
+    countdown(): Countdown | null;
+    /** A quiz's results for the answers as sent (`quiz` on the page), in the order they were asked; undefined where it has none. */
+    marked(values: Values): QuizResults | undefined;
+}
+/**
+ * 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 declare function join(host: FormInner): SurveyKit;

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

@@ -0,0 +1,110 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.join = join;
+const order_1 = require("./order");
+const quiz_1 = require("./quiz");
+const timing_1 = require("./timing");
+/**
+ * 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).
+ */
+function join(host) {
+    const { page, form } = host;
+    const drawn = (0, order_1.drawsOrder)(page);
+    const time = (0, timing_1.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 = () => (0, order_1.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() };
+    };
+    /** The answers and the step last kept while a clock runs. */
+    let keptAs = [];
+    const kit = {
+        hides: (id) => undrawn.has(id),
+        locks(id) {
+            const up = form.getState().timeUp;
+            if (!up.length)
+                return false;
+            if (up.includes(timing_1.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),
+        changed() {
+            // While a clock runs, each answer given is kept at once, never a moment later: a reload loses nothing typed, nor
+            // gains the time it took. Nothing once sent, or started again with nothing given.
+            const state = form.getState();
+            if (state.sent || !state.dirty.length || !Object.keys(state.timers).length || (state.values === keptAs[0] && state.step === keptAs[1]))
+                return;
+            keptAs = [state.values, state.step];
+            host.keep();
+        },
+        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 ? (0, quiz_1.quizResults)(page, values, (0, order_1.askedInOrder)(page, (form.getState().order ?? null), values)) ?? undefined : undefined),
+    };
+    if (drawn && !form.getState().order)
+        placed(draw());
+    return kit;
+}
+//# sourceMappingURL=survey-kit.js.map

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

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

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

@@ -0,0 +1,107 @@
+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() };
+    };
+    /** The answers and the step last kept while a clock runs. */
+    let keptAs = [];
+    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),
+        changed() {
+            // While a clock runs, each answer given is kept at once, never a moment later: a reload loses nothing typed, nor
+            // gains the time it took. Nothing once sent, or started again with nothing given.
+            const state = form.getState();
+            if (state.sent || !state.dirty.length || !Object.keys(state.timers).length || (state.values === keptAs[0] && state.step === keptAs[1]))
+                return;
+            keptAs = [state.values, state.step];
+            host.keep();
+        },
+        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;