@fieldia/core 0.30.0 → 0.31.0

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

@@ -0,0 +1,110 @@
+import { fillMessage } from './messages.mjs';
+import { DONE } from './run.mjs';
+import { sameValue, structuredCopy } from './values.mjs';
+const wordsOf = (error) => (error instanceof Error ? error.message : String(error));
+/** The steps a press does that Fieldia cannot take back by itself: a copy, a delete, a form put back or closed, a page opened, an address, a post. */
+const BEYOND = /"do":"(duplicate|delete|reset|close|open|openUrl|post)"/;
+/**
+ * What a press did, read as it ends against the values it began with (`PressTaken.at`): each field it changed — a
+ * value worked out aside, which follows — and whether it saved them (the record holds no change left to save).
+ */
+export function pressDone(taken, now, fields, saved) {
+    const wrote = new Map();
+    for (const name of new Set([...Object.keys(taken.at), ...Object.keys(now)])) {
+        if (fields[name]?.compute || sameValue(taken.at[name], now[name]))
+            continue;
+        wrote.set(name, { before: (taken.at[name] ?? null), after: structuredCopy(now[name] ?? null) });
+    }
+    return { app: taken.app, ...(taken.archived !== undefined ? { archived: taken.archived } : {}), wrote, ...(wrote.size && saved ? { saved } : {}) };
+}
+/**
+ * Take back what a press did (`PressTaken`), as its toast's Undo asks: the app's own undos, latest first, each
+ * answered as a call is; the record it archived brought back, or the reverse; then the values its steps and the
+ * app's answers wrote put back — each only while it holds what they left, a change made since by anyone else staying
+ * — and saved again where the press saved. On the record the press was on: another shown since, nothing is done.
+ */
+export async function takeBack(kit, taken, scope) {
+    const { form, answered, recordStep, replaced, tell } = kit;
+    scope.generation ??= form.generation();
+    const ended = (stopped) => stopped ? { done: false, reason: stopped.reason, ...(stopped.message !== undefined ? { message: stopped.message } : {}), ...(stopped.error !== undefined ? { error: stopped.error } : {}) } : DONE;
+    try {
+        // The app's own, whatever record is shown now: what it answers is laid only on the one the press ended on.
+        for (const undo of [...taken.app].reverse()) {
+            let answer;
+            try {
+                answer = await undo();
+            }
+            catch (error) {
+                return ended({ reason: 'app', message: wordsOf(error), error });
+            }
+            if (!answer)
+                continue;
+            if (replaced(scope)) {
+                if (answer.say !== undefined)
+                    tell(null, typeof answer.say === 'string' ? answer.say : answer.say.message, (typeof answer.say === 'object' && answer.say.tone) || 'info');
+                continue;
+            }
+            const stopped = await answered(answer, scope);
+            if (stopped)
+                return ended(stopped);
+        }
+        if (taken.archived === undefined && !taken.wrote.size)
+            return DONE;
+        if (replaced(scope))
+            return ended(form.gone());
+        if (taken.archived !== undefined) {
+            const stopped = await recordStep(taken.archived ? 'unarchive' : 'archive', scope);
+            if (stopped)
+                return ended(stopped);
+        }
+        if (!taken.wrote.size)
+            return DONE;
+        const back = {};
+        for (const [name, { before, after }] of taken.wrote)
+            if (sameValue(form.values()[name], after))
+                back[name] = before;
+        if (Object.keys(back).length)
+            form.write(back, scope.chain);
+        return ended(taken.saved ? await form.save(scope.chain) : null);
+    }
+    catch (error) {
+        return ended({ reason: 'cannot', message: wordsOf(error), error });
+    }
+}
+/**
+ * A press that offers Undo has ended: the words it held are said — the last, once it ran whole, with Undo, where what
+ * it did can be taken back (its button's steps for it; else Fieldia's own taking back, where nothing it did is beyond
+ * it — a copy, a delete, a page opened, a post, the app's call answered with no undo; else the app's own undos) — or,
+ * with nothing said, "Done: {label}". Undo runs on the record the press ended on: another shown since, only the app's
+ * own undos run.
+ */
+export function offerUndo(inner, context) {
+    const { kit, source, scope, taken, result, offers } = context;
+    const { messages } = inner;
+    const host = kit.form.host;
+    const done = pressDone(taken, kit.form.values(), inner.fields, !kit.form.changed());
+    const beyond = taken.beyond ?? BEYOND.exec(JSON.stringify([source.steps ?? [], 'builtin' in source ? { do: source.builtin } : {}]))?.[1];
+    const did = taken.app.length > 0 || taken.archived !== undefined || done.wrote.size > 0;
+    const can = result.done && (Array.isArray(offers) || (offers === true ? did && beyond === undefined : taken.app.length > 0));
+    const said = [...taken.said];
+    const builtin = 'builtin' in source ? source.builtin : undefined;
+    const plain = builtin === 'archive' ? messages.pressArchived : builtin === 'unarchive' ? messages.pressUnarchived : fillMessage(messages, messages.pressDone, { label: source.label ?? '' });
+    const last = can ? (said.pop() ?? { message: plain, tone: 'success' }) : null;
+    for (const words of said)
+        host?.say(words.message, words.tone);
+    if (!last)
+        return;
+    const on = kit.form.generation();
+    const id = `${scope.id}.undo`;
+    host?.say(last.message, last.tone, {
+        undo: () => inner.track((async () => {
+            const again = { id, chain: [], typed: 'first', generation: on, ...(scope.recordIds ? { recordIds: [...scope.recordIds] } : {}) };
+            const steps = Array.isArray(offers) ? offers : [];
+            // Its steps, on the record the press ended on; else what it did, taken back.
+            const ended = Array.isArray(offers) ? (on === kit.form.generation() ? await kit.runSteps(offers, again) : { done: false, ...inner.replaced() }) : await takeBack(kit, offers === true ? done : { app: taken.app, wrote: new Map() }, again);
+            inner.emit('run', { id, steps, result: ended });
+            return ended;
+        })()),
+    });
+}
+//# sourceMappingURL=press-undo.mjs.map

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

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

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

@@ -0,0 +1,36 @@
+import type { Page } from '../format/page.mjs';
+import type { Value, Values } from './values.mjs';
+/**
+ * A quiz's results (`quiz` on a page): each question asked marked — right or wrong where it has right answers, its
+ * points of its most — and the score of them all. The form works them out as the answers are sent (`state.sent.quiz`),
+ * unless the app's source answered the send with its own (`SubmitResult.quiz`): a test that keeps its right answers out
+ * of the page marks them on its server.
+ */
+export interface QuizResults {
+    /** The points earned, of the most the questions asked could earn. */
+    score: number;
+    max: number;
+    /** Each question asked that earns points or has right answers, in the order it was asked. */
+    questions: QuizMark[];
+}
+/** One question's mark. */
+export interface QuizMark {
+    field: string;
+    /** Its points, of its most. */
+    points: number;
+    max: number;
+    /** Right or wrong where the question has right answers; null for one of points alone (its options' `score`). */
+    right: boolean | null;
+    /** Whether it was answered at all. */
+    answered: boolean;
+    /** The right answer, as a value of the field (a list of them for several), where the page shows it: for one answered wrongly or not at all. */
+    rightAnswer?: Value;
+    /** The question's own words for its answer: its feedback when right, or when wrong. */
+    feedback?: string;
+}
+/**
+ * A quiz's results for the answers sent, in the order the questions were asked (`asked`, the fields whose answers were
+ * sent: a question not shown, its step skipped, is none). Null where no question asked earns points or has right
+ * answers.
+ */
+export declare function quizResults(page: Page, values: Values, asked?: readonly string[]): QuizResults | null;

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

@@ -0,0 +1,36 @@
+import type { Page } from '../format/page';
+import type { Value, Values } from './values';
+/**
+ * A quiz's results (`quiz` on a page): each question asked marked — right or wrong where it has right answers, its
+ * points of its most — and the score of them all. The form works them out as the answers are sent (`state.sent.quiz`),
+ * unless the app's source answered the send with its own (`SubmitResult.quiz`): a test that keeps its right answers out
+ * of the page marks them on its server.
+ */
+export interface QuizResults {
+    /** The points earned, of the most the questions asked could earn. */
+    score: number;
+    max: number;
+    /** Each question asked that earns points or has right answers, in the order it was asked. */
+    questions: QuizMark[];
+}
+/** One question's mark. */
+export interface QuizMark {
+    field: string;
+    /** Its points, of its most. */
+    points: number;
+    max: number;
+    /** Right or wrong where the question has right answers; null for one of points alone (its options' `score`). */
+    right: boolean | null;
+    /** Whether it was answered at all. */
+    answered: boolean;
+    /** The right answer, as a value of the field (a list of them for several), where the page shows it: for one answered wrongly or not at all. */
+    rightAnswer?: Value;
+    /** The question's own words for its answer: its feedback when right, or when wrong. */
+    feedback?: string;
+}
+/**
+ * A quiz's results for the answers sent, in the order the questions were asked (`asked`, the fields whose answers were
+ * sent: a question not shown, its step skipped, is none). Null where no question asked earns points or has right
+ * answers.
+ */
+export declare function quizResults(page: Page, values: Values, asked?: readonly string[]): QuizResults | null;

package/src/lib/record/quiz.js

@@ -0,0 +1,90 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.quizResults = quizResults;
+/** Sums of tenths and the like without a computer's crumbs: 0.1 + 0.2 is 0.3. */
+const tidy = (n) => Math.round(n * 1e9) / 1e9;
+const empty = (value) => value === null || value === undefined || value === '' || (Array.isArray(value) && value.length === 0);
+/** A word as a person may write it: its case and the spaces round and inside it aside. */
+const plain = (value) => String(value).trim().replace(/\s+/g, ' ').toLocaleLowerCase();
+/** What a question's quiz says, by its kind: its right answers and points, or null for a question that is none. */
+function quizOf(def) {
+    if (!def)
+        return null;
+    if (def.type === 'selection') {
+        const marked = def.options.some((option) => option.correct === true || option.score !== undefined);
+        return marked ? { options: def.options, answers: null, several: def.multiple === true } : null;
+    }
+    if ((def.type === 'char' || def.type === 'integer' || def.type === 'float') && def.quiz?.answers?.length)
+        return { options: null, answers: def.quiz.answers, several: false };
+    return null;
+}
+/** Whether a typed answer is one the question takes: a number by its value, words whatever their case and spaces. */
+function takes(answers, value, numeric) {
+    if (empty(value))
+        return false;
+    if (numeric)
+        return answers.some((answer) => Number(answer) === Number(value));
+    return answers.some((answer) => plain(answer) === plain(value));
+}
+/**
+ * A quiz's results for the answers sent, in the order the questions were asked (`asked`, the fields whose answers were
+ * sent: a question not shown, its step skipped, is none). Null where no question asked earns points or has right
+ * answers.
+ */
+function quizResults(page, values, asked = Object.keys(values)) {
+    const each = page.quiz?.points ?? 1;
+    const showRight = page.quiz?.rightAnswers !== false;
+    const questions = [];
+    for (const field of asked) {
+        const def = page.fields[field];
+        const quiz = quizOf(def);
+        if (!quiz || !def)
+            continue;
+        const answer = values[field];
+        const answered = !empty(answer);
+        const worth = def.quiz?.points ?? each;
+        let points = 0;
+        let max = 0;
+        let right = null;
+        let rightAnswer;
+        if (quiz.options) {
+            const chosen = quiz.several ? (Array.isArray(answer) ? answer : []) : answered ? [answer] : [];
+            const scored = quiz.options.some((option) => option.score !== undefined);
+            const correct = quiz.options.filter((option) => option.correct === true);
+            if (correct.length) {
+                // Several: right when exactly the right ones are chosen; one: right when the one chosen is a right one.
+                right = quiz.several ? chosen.length === correct.length && correct.every((option) => chosen.includes(option.value)) : chosen.length === 1 && correct.some((option) => option.value === chosen[0]);
+                rightAnswer = quiz.several ? correct.map((option) => option.value) : correct[0].value;
+            }
+            if (scored) {
+                // Points by the options chosen, as `scoreOf` counts them: the best of one, every one worth something of several.
+                points = chosen.reduce((sum, value) => sum + (quiz.options?.find((option) => option.value === value)?.score ?? 0), 0);
+                max = quiz.several ? quiz.options.reduce((sum, option) => sum + Math.max(0, option.score ?? 0), 0) : quiz.options.reduce((most, option) => Math.max(most, option.score ?? 0), 0);
+            }
+            else {
+                points = right ? worth : 0;
+                max = worth;
+            }
+        }
+        else if (quiz.answers) {
+            right = takes(quiz.answers, answer, def.type !== 'char');
+            points = right ? worth : 0;
+            max = worth;
+            rightAnswer = quiz.answers[0];
+        }
+        const feedback = right === null ? undefined : def.quiz?.feedback?.[right ? 'right' : 'wrong'];
+        questions.push({
+            field,
+            points: tidy(points),
+            max: tidy(max),
+            right,
+            answered,
+            ...(right === false && showRight && rightAnswer !== undefined ? { rightAnswer } : {}),
+            ...(feedback ? { feedback } : {}),
+        });
+    }
+    if (!questions.length)
+        return null;
+    return { score: tidy(questions.reduce((sum, mark) => sum + mark.points, 0)), max: tidy(questions.reduce((sum, mark) => sum + mark.max, 0)), questions };
+}
+//# sourceMappingURL=quiz.js.map

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

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

package/src/lib/record/quiz.mjs

@@ -0,0 +1,87 @@
+/** Sums of tenths and the like without a computer's crumbs: 0.1 + 0.2 is 0.3. */
+const tidy = (n) => Math.round(n * 1e9) / 1e9;
+const empty = (value) => value === null || value === undefined || value === '' || (Array.isArray(value) && value.length === 0);
+/** A word as a person may write it: its case and the spaces round and inside it aside. */
+const plain = (value) => String(value).trim().replace(/\s+/g, ' ').toLocaleLowerCase();
+/** What a question's quiz says, by its kind: its right answers and points, or null for a question that is none. */
+function quizOf(def) {
+    if (!def)
+        return null;
+    if (def.type === 'selection') {
+        const marked = def.options.some((option) => option.correct === true || option.score !== undefined);
+        return marked ? { options: def.options, answers: null, several: def.multiple === true } : null;
+    }
+    if ((def.type === 'char' || def.type === 'integer' || def.type === 'float') && def.quiz?.answers?.length)
+        return { options: null, answers: def.quiz.answers, several: false };
+    return null;
+}
+/** Whether a typed answer is one the question takes: a number by its value, words whatever their case and spaces. */
+function takes(answers, value, numeric) {
+    if (empty(value))
+        return false;
+    if (numeric)
+        return answers.some((answer) => Number(answer) === Number(value));
+    return answers.some((answer) => plain(answer) === plain(value));
+}
+/**
+ * A quiz's results for the answers sent, in the order the questions were asked (`asked`, the fields whose answers were
+ * sent: a question not shown, its step skipped, is none). Null where no question asked earns points or has right
+ * answers.
+ */
+export function quizResults(page, values, asked = Object.keys(values)) {
+    const each = page.quiz?.points ?? 1;
+    const showRight = page.quiz?.rightAnswers !== false;
+    const questions = [];
+    for (const field of asked) {
+        const def = page.fields[field];
+        const quiz = quizOf(def);
+        if (!quiz || !def)
+            continue;
+        const answer = values[field];
+        const answered = !empty(answer);
+        const worth = def.quiz?.points ?? each;
+        let points = 0;
+        let max = 0;
+        let right = null;
+        let rightAnswer;
+        if (quiz.options) {
+            const chosen = quiz.several ? (Array.isArray(answer) ? answer : []) : answered ? [answer] : [];
+            const scored = quiz.options.some((option) => option.score !== undefined);
+            const correct = quiz.options.filter((option) => option.correct === true);
+            if (correct.length) {
+                // Several: right when exactly the right ones are chosen; one: right when the one chosen is a right one.
+                right = quiz.several ? chosen.length === correct.length && correct.every((option) => chosen.includes(option.value)) : chosen.length === 1 && correct.some((option) => option.value === chosen[0]);
+                rightAnswer = quiz.several ? correct.map((option) => option.value) : correct[0].value;
+            }
+            if (scored) {
+                // Points by the options chosen, as `scoreOf` counts them: the best of one, every one worth something of several.
+                points = chosen.reduce((sum, value) => sum + (quiz.options?.find((option) => option.value === value)?.score ?? 0), 0);
+                max = quiz.several ? quiz.options.reduce((sum, option) => sum + Math.max(0, option.score ?? 0), 0) : quiz.options.reduce((most, option) => Math.max(most, option.score ?? 0), 0);
+            }
+            else {
+                points = right ? worth : 0;
+                max = worth;
+            }
+        }
+        else if (quiz.answers) {
+            right = takes(quiz.answers, answer, def.type !== 'char');
+            points = right ? worth : 0;
+            max = worth;
+            rightAnswer = quiz.answers[0];
+        }
+        const feedback = right === null ? undefined : def.quiz?.feedback?.[right ? 'right' : 'wrong'];
+        questions.push({
+            field,
+            points: tidy(points),
+            max: tidy(max),
+            right,
+            answered,
+            ...(right === false && showRight && rightAnswer !== undefined ? { rightAnswer } : {}),
+            ...(feedback ? { feedback } : {}),
+        });
+    }
+    if (!questions.length)
+        return null;
+    return { score: tidy(questions.reduce((sum, mark) => sum + mark.points, 0)), max: tidy(questions.reduce((sum, mark) => sum + mark.max, 0)), questions };
+}
+//# sourceMappingURL=quiz.mjs.map

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

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

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

@@ -37,7 +37,7 @@ function isQuestion(label) {
     return /([?؟？⸮]|…|\.\.\.)\s*$/u.test(label);
 }
 /** Each language's quotation marks round a question its sentence names: “…” where it has none of its own here. */
-const QUOTES = { de: ['„', '“'], fr: ['« ', ' »'], ar: ['«', '»'] };
+const QUOTES = { de: ['„', '“'], fr: ['« ', ' »'], ar: ['«', '»'], fa: ['«', '»'] };
 /**
  * A label as a sentence names it: a question (`isQuestion`) between the language's quotation marks — "Please answer
  * “How was your visit?”", "“How many days?” must be at most 5" — and a name as written.

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

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

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

@@ -31,7 +31,7 @@ export function isQuestion(label) {
     return /([?؟？⸮]|…|\.\.\.)\s*$/u.test(label);
 }
 /** Each language's quotation marks round a question its sentence names: “…” where it has none of its own here. */
-const QUOTES = { de: ['„', '“'], fr: ['« ', ' »'], ar: ['«', '»'] };
+const QUOTES = { de: ['„', '“'], fr: ['« ', ' »'], ar: ['«', '»'], fa: ['«', '»'] };
 /**
  * A label as a sentence names it: a question (`isQuestion`) between the language's quotation marks — "Please answer
  * “How was your visit?”", "“How many days?” must be at most 5" — and a name as written.

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

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

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

@@ -3,7 +3,7 @@ import type { Field } from '../format/field.mjs';
 import type { JsonValue } from '../format/json.mjs';
 import type { MenuItem, Tone } from '../format/layout.mjs';
 import { type ExpressionEnv } from '../expression/expression.mjs';
-import type { ResolvedFilter } from './data-source.mjs';
+import type { PaidPayment, PaymentDue, PayRequest, ResolvedFilter } from './data-source.mjs';
 import type { Facet } from './search.mjs';
 import { type RecordId, type Value, type Values } from './values.mjs';
 /**
@@ -89,6 +89,46 @@ export interface ActionResult {
      * own, each pressed as theirs are. Read only by that menu; any other call's is left alone.
      */
     menu?: MenuItem[];
+    /**
+     * How to take back what the app just did, for a one-tap press (a follow-up marked done, a message sent with a few
+     * seconds to call it back): its words are said with Undo, and Undo calls this — the app reopens the follow-up,
+     * cancels the send — answering as a call is answered (values, words, a reload…). Offered for a few seconds.
+     */
+    undo?: AppUndo;
+}
+/** The app's own way to take back what it did for a press (`ActionResult.undo`): answered as a call is. */
+export type AppUndo = () => void | ActionResult | Promise<void | ActionResult>;
+/** The runner's own ways a press's Undo takes it back with (press-undo.ts, the undo part). */
+export interface UndoKit {
+    form: RunForm;
+    answered(answer: ActionResult, scope: RunScope): Promise<Stopped | null>;
+    recordStep(name: 'archive' | 'unarchive' | 'duplicate' | 'delete', scope: RunScope): Promise<Stopped | null>;
+    replaced(scope: RunScope): boolean;
+    tell(scope: RunScope | null, message: string, tone: Tone): void;
+    runSteps(steps: readonly ActionStep[], scope: RunScope, inner?: boolean): Promise<RunResult>;
+}
+/** Undo, offered with the words a press said (`ActionHost.say`'s third): pressed, it takes back what the press did. */
+export interface SayUndo {
+    undo(): Promise<RunResult>;
+}
+/**
+ * What a press that offers Undo keeps as it runs (a button's or a menu item's `undo`, or the app answering with one):
+ * the words it says, held to be said as it ends — the last with Undo — and what Fieldia needs to take it back. What it
+ * wrote is read by the undo part as it ends (press-undo.ts), against the values it began with.
+ */
+export interface PressTaken {
+    said: {
+        message: string;
+        tone: Tone;
+    }[];
+    /** The app's own undos, from its answers, in the order given. */
+    app: AppUndo[];
+    /** The form's values as the press began. */
+    at: Values;
+    /** It archived the record (true) or brought it back (false). */
+    archived?: boolean;
+    /** The app's call answered with no undo: Fieldia cannot take that back by itself. */
+    beyond?: string;
 }
 /**
  * A file the app hands back from an action: its name and kind, and where it is — its address on the app's server, its
@@ -163,7 +203,8 @@ export interface OpenResult {
  */
 export interface ActionHost {
     open(request: OpenRequest): Promise<OpenResult>;
-    say(message: string, tone: Tone): void;
+    /** Words to say, in a tone; with `undo`, a one-tap press's: Undo beside them for a few seconds, pressed, takes it back. */
+    say(message: string, tone: Tone, undo?: SayUndo): void;
     /** A question, answered Yes (true) or No; `how` says what kind, for a host that asks some differently. */
     ask(message: string, how?: AskHow): Promise<boolean>;
     /** Close the dialog or panel this form was opened in. */
@@ -182,14 +223,24 @@ export interface ActionHost {
      * is given one that posts in that record's. False: nothing heard them.
      */
     post?(message: PostedMessage): boolean | void | Promise<boolean | void>;
+    /**
+     * The payment step a send waits on (a page's `payment`): show what is due, and settle once it is paid — through the
+     * data source's `pay`, in the person's press — or with null once the person goes back to the answers: nothing is sent.
+     * Left out, the form asks the source's `pay` itself.
+     */
+    pay?(due: PaymentDue, request: PayRequest): Promise<PaidPayment | null>;
 }
 /**
  * How a question is asked. `discard`: its Yes lets go of the person's work not
  * saved ("Discard your changes?"), so a host words Yes as Discard and puts the
- * focus on Cancel: Enter keeps the work.
+ * focus on Cancel: Enter keeps the work. `yes`: what answering Yes does, in
+ * words its Yes button says — a button's `confirm` is answered by the button's
+ * own words, Archive by Archive, "Paste 40 rows: change 7 and add 33?" by
+ * Paste 40 rows —, never a bare OK.
  */
 export interface AskHow {
     discard?: boolean;
+    yes?: string;
 }
 /**
  * Why a run stopped: a check found problems (`check`), a question was
@@ -218,10 +269,14 @@ export interface RunResult {
     /** What the app or the host threw, when that stopped it. */
     error?: unknown;
 }
-/** What a run is for: the id calls carry, the records chosen in a list. */
+/**
+ * What a run is for: the id calls carry, the records chosen in a list, and the words of what set it off (a menu item's
+ * label), which an `ask` step's Yes says: answered Yes, the run goes on doing it.
+ */
 export interface RunContext {
     id?: string;
     recordIds?: RecordId[];
+    yes?: string;
 }
 /** A step stopped: why, and which (a step of an `open`'s `then`, the deepest). */
 export interface Stopped {
@@ -256,6 +311,8 @@ export interface RunScope {
      * reads a box under the person's keys.
      */
     typed?: 'first' | 'read';
+    /** The words of what set the run off — a button's label, a menu item's — which its `ask` steps' Yes says. */
+    yes?: string;
     /**
      * What the run's own steps wrote since its last save, by field: what it held
      * before the first of them, whether that was the person's own change, and
@@ -266,6 +323,8 @@ export interface RunScope {
         mine: boolean;
         after: Value;
     }>;
+    /** A press that offers Undo: what it said and did, to be taken back (`PressTaken`). */
+    taken?: PressTaken;
 }
 /** What a run reaches its form by: the form gives these. */
 export interface RunForm {
@@ -297,7 +356,8 @@ export interface RunForm {
      * stops — text left in a box that does not read, said under its box as a check says it.
      */
     typedFirst(): Promise<Stopped | null>;
-    save(chain: readonly string[]): Promise<Stopped | null>;
+    /** `yes`: the words of what set it off, which its `beforeSave` questions' Yes says. */
+    save(chain: readonly string[], yes?: string): Promise<Stopped | null>;
     /** The number of the record shown now: each record shown — opened, loaded again, a new one — has its own. */
     generation(): number;
     /** Why a run stops whose record was replaced while it went on. */
@@ -317,7 +377,7 @@ export interface RunForm {
     /** Run `show` of the host while `chain` is the run's, so a tab it shows knows who showed it. */
     showing(chain: readonly string[], show: () => void): void;
     host?: ActionHost;
-    confirm?: (message: string) => boolean | Promise<boolean>;
+    confirm?: (message: string, how?: AskHow) => boolean | Promise<boolean>;
     onAction?: OnAction;
     /** The app answered a call. */
     answered(request: ActionRequest, result: ActionResult | undefined): void;
@@ -362,10 +422,13 @@ export interface RunForm {
     barred?(right: 'edit' | 'archive' | 'duplicate' | 'delete'): string | null;
 }
 export declare const DONE: RunResult;
+/** What a press that offers Undo starts keeping (`RunScope.taken`), from the values it begins with. */
+export declare const takenNow: (at?: Values) => PressTaken;
 /** Steps run against one form. Expressions are read once and kept. */
 export declare function createRunner(form: RunForm): {
     runSteps: (steps: readonly ActionStep[], scope: RunScope, inner?: boolean) => Promise<RunResult>;
-    ask: (message: string) => Promise<boolean>;
+    ask: (message: string, yes?: string) => Promise<boolean>;
+    kit: UndoKit;
 };
 /**
  * One run of each moment at a time. A moment set off by a step of its own
@@ -375,4 +438,4 @@ export declare function createRunner(form: RunForm): {
  * meanwhile; the others (beforeSave, afterSave) do not run — a save made
  * meanwhile goes ahead without them, so nothing waits on itself.
  */
-export declare function createMoments(run: (key: string, steps: readonly ActionStep[], chain: readonly string[], on?: number) => Promise<RunResult>, now?: () => number): (key: string, steps: readonly ActionStep[] | undefined, chain: readonly string[], again: boolean) => Promise<RunResult>;
+export declare function createMoments(run: (key: string, steps: readonly ActionStep[], chain: readonly string[], on?: number, yes?: string) => Promise<RunResult>, now?: () => number): (key: string, steps: readonly ActionStep[] | undefined, chain: readonly string[], again: boolean, yes?: string) => Promise<RunResult>;