@classytic/labs 0.6.0 → 0.7.0

package/dist/domains/accounting/document-desk/model.mjs

@@ -0,0 +1,1448 @@
+import { defineLabModel } from "../../../model/define.mjs";
+import { formatMoney } from "../../../model/money.mjs";
+import { isRefusal, refuse } from "../../../model/index.mjs";
+import { z } from "zod";
+import { parseAmount } from "@classytic/stage/math/answer";
+import { EQUATION_TERMS, equationChange, termPosition } from "@classytic/stage/finance/accounting";
+
+//#region src/domains/accounting/document-desk/model.ts
+/**
+* The document desk: the first page of the books, where an accountant decides what counts and what proves it.
+*
+* Three modes, one lab, the lesson picks with `mode`:
+*
+* - `sort`: event or transaction. One card at a time; the learner says whether it is a transaction. The equation
+*   then answers: a transaction moves its terms and both sides still agree; an event moves nothing.
+* - `identify`: name the document. A document drawn as the NCTB book prints it, title hidden; the learner names
+*   its kind and, when it has two parties, who issued it. The feedback names the clue.
+* - `fill`: fill a voucher. A short story; the learner picks the voucher type and fills its date, party, account
+*   head and amount, then checks. Each field is marked on its own, with a why for a wrong one.
+* - `journal`: into the journals. A document drawn as in identify mode; the learner picks the journal it belongs in
+*   (purchases, sales, purchase returns, sales returns, cash receipts, cash payments or general), then fills that
+*   journal's row in the book's columns. The row lands in the journal; a journal whose documents are all in shows
+*   its total and the month-end posting its amount column names.
+*
+* Every word the learner reads as content (card text, reasons, document kinds, party names, field names, the
+* equation's term names, feedback sentences) is a prop, so a Bangla lesson passes its own; the lab's buttons stay
+* English. The equation check (`equationChange`) and reading a written amount (`parseAmount`, Bangla digits and
+* lakh grouping included) come from stage.
+*/
+const DOC_KINDS = [
+	"invoice",
+	"cash-memo",
+	"debit-note",
+	"credit-note",
+	"debit-voucher",
+	"credit-voucher"
+];
+const FILL_FIELDS = [
+	"kind",
+	"date",
+	"party",
+	"account",
+	"amount"
+];
+const KIND_LABEL = {
+	invoice: "Invoice",
+	"cash-memo": "Cash memo",
+	"debit-note": "Debit note",
+	"credit-note": "Credit note",
+	"debit-voucher": "Debit voucher",
+	"credit-voucher": "Credit voucher"
+};
+const KIND_CLUE = {
+	invoice: "Goods sold on credit, listed with quantity and rate, and the seller's name at the top: an invoice, sent by the seller.",
+	"cash-memo": "A sale paid for on the spot: a cash memo, given by the seller with the goods.",
+	"debit-note": "Goods sent back to the seller, and \"we have debited your account\": a debit note, sent by the buyer who returns them.",
+	"credit-note": "The seller accepts the returned goods, \"we have credited your account\": a credit note, sent by the seller.",
+	"debit-voucher": "Money paid out: a debit voucher, the business's own proof of a payment.",
+	"credit-voucher": "Money received: a credit voucher, the business's own proof of a receipt."
+};
+const TERM_LABEL = {
+	assets: "Assets",
+	liabilities: "Liabilities",
+	capital: "Capital",
+	drawings: "Drawings",
+	revenue: "Revenue",
+	expenses: "Expenses"
+};
+const FIELD_LABEL = {
+	particulars: "Particulars",
+	qty: "Qty",
+	rate: "Rate",
+	amount: "Amount",
+	total: "Total",
+	less: "Less",
+	to: "To",
+	date: "Date",
+	ref: "No.",
+	party: "Name",
+	paidTo: "Paid to",
+	receivedFrom: "Received from",
+	account: "Account head",
+	voucherType: "Voucher",
+	terms: "Terms",
+	/** The general journal's account pickers: named for the account, not the amount column above them. */
+	debitAccount: "Debit account",
+	creditAccount: "Credit account"
+};
+const PHRASE = {
+	transaction: "Transaction",
+	event: "Not a transaction",
+	nothingMoved: "Nothing in the equation moved.",
+	stillEqual: "Both sides moved by the same amount, so they still agree.",
+	left: "Left side",
+	right: "Right side",
+	kindQuestion: "What is this document?",
+	issuerQuestion: "Who issued it?",
+	journalQuestion: "Which journal does it go in?",
+	notThisJournal: "Not this journal.",
+	monthEnd: "Posted at month end:"
+};
+const JOURNALS = [
+	"purchases",
+	"sales",
+	"purchase-returns",
+	"sales-returns",
+	"cash-receipts",
+	"cash-payments",
+	"general"
+];
+const JOURNAL_FIELDS = [
+	"date",
+	"party",
+	"ref",
+	"debit",
+	"amount"
+];
+/** The fields a journal's row asks for, in its column order. */
+function journalFields(journal) {
+	if (journal === "general") return [
+		"date",
+		"debit",
+		"party",
+		"amount"
+	];
+	if (journal === "cash-receipts" || journal === "cash-payments") return [
+		"date",
+		"party",
+		"amount"
+	];
+	return [
+		"date",
+		"party",
+		"ref",
+		"amount"
+	];
+}
+const JOURNAL_LABEL = {
+	purchases: "Purchases journal",
+	sales: "Sales journal",
+	"purchase-returns": "Purchase returns journal",
+	"sales-returns": "Sales returns journal",
+	"cash-receipts": "Cash receipts journal",
+	"cash-payments": "Cash payments journal",
+	general: "General journal"
+};
+const JOURNAL_CLUE = {
+	purchases: "Goods for resale bought on credit, entered from the supplier's invoice.",
+	sales: "Goods sold on credit, entered from the invoice the business sends its customer.",
+	"purchase-returns": "Goods sent back to a supplier, entered from the debit note the business sends.",
+	"sales-returns": "Goods a customer sends back, entered from the credit note the business issues.",
+	"cash-receipts": "Every receipt of cash.",
+	"cash-payments": "Every payment of cash.",
+	general: "Anything no special journal takes, such as an asset bought on credit for the business to use."
+};
+/**
+* Column headings, as the book prints them (formats.md, Journal ch6). In a special journal `debit` and `credit`
+* are the two lines of its one amount column, which name its month-end posting; in the general journal they head
+* its two amount columns and `dr`/`cr` end its debit and credit lines.
+*/
+const HEADING_KEYS = [
+	"date",
+	"party",
+	"terms",
+	"ref",
+	"folio",
+	"debit",
+	"credit",
+	"dr",
+	"cr"
+];
+const JOURNAL_HEADING = {
+	purchases: {
+		date: "Date",
+		party: "Credit account",
+		terms: "Terms",
+		ref: "Invoice No.",
+		folio: "L.F.",
+		debit: "Purchases A/c Dr",
+		credit: "Accounts payable A/c Cr"
+	},
+	sales: {
+		date: "Date",
+		party: "Debit account",
+		ref: "Invoice No.",
+		folio: "L.F.",
+		debit: "Accounts receivable A/c Dr",
+		credit: "Sales A/c Cr"
+	},
+	"purchase-returns": {
+		date: "Date",
+		party: "Debit account",
+		ref: "Debit note No.",
+		folio: "L.F.",
+		debit: "Accounts payable A/c Dr",
+		credit: "Purchase returns A/c Cr"
+	},
+	"sales-returns": {
+		date: "Date",
+		party: "Credit account",
+		ref: "Credit note No.",
+		folio: "L.F.",
+		debit: "Sales returns A/c Dr",
+		credit: "Accounts receivable A/c Cr"
+	},
+	"cash-receipts": {
+		date: "Date",
+		party: "Credit account",
+		folio: "L.F.",
+		debit: "Cash A/c Dr"
+	},
+	"cash-payments": {
+		date: "Date",
+		party: "Debit account",
+		folio: "L.F.",
+		credit: "Cash A/c Cr"
+	},
+	general: {
+		date: "Date",
+		party: "Particulars",
+		folio: "L.F.",
+		debit: "Debit",
+		credit: "Credit",
+		dr: "Dr",
+		cr: "Cr"
+	}
+};
+/** Which documents a journal can take, seen from the business (`ours`: the business issued it). */
+function journalTakes(journal, kind, ours) {
+	switch (journal) {
+		case "purchases": return kind === "invoice" && !ours;
+		case "sales": return kind === "invoice" && ours;
+		case "purchase-returns": return kind === "debit-note" && ours;
+		case "sales-returns": return kind === "credit-note" && ours;
+		case "cash-receipts": return kind === "credit-voucher" || kind === "cash-memo" && ours;
+		case "cash-payments": return kind === "debit-voucher" || kind === "cash-memo" && !ours;
+		case "general": return true;
+	}
+}
+const DEFAULT_CARDS = [
+	{
+		id: "fridge",
+		text: "The shop buys a fridge for $32,000 in cash.",
+		transaction: true,
+		effects: [{
+			term: "assets",
+			label: "Fridge",
+			delta: 32e3
+		}, {
+			term: "assets",
+			label: "Cash",
+			delta: -32e3
+		}],
+		reason: "It changes what the business owns, and it can be measured in money."
+	},
+	{
+		id: "order",
+		text: "A customer phones to order $5,000 of goods for next week.",
+		transaction: false,
+		reason: "An order is only a promise. No goods or money have moved yet."
+	},
+	{
+		id: "computer",
+		text: "The shop buys a computer on credit from Tech Mart for $45,000.",
+		transaction: true,
+		effects: [{
+			term: "assets",
+			label: "Computer",
+			delta: 45e3
+		}, {
+			term: "liabilities",
+			label: "Tech Mart",
+			delta: 45e3
+		}],
+		reason: "An asset came in and the shop now owes Tech Mart. Paying later still counts."
+	},
+	{
+		id: "hire",
+		text: "The owner hires a cashier who starts work next month.",
+		transaction: false,
+		reason: "No work has been done and nothing is owed yet, so the business has not changed."
+	},
+	{
+		id: "rent",
+		text: "The shop pays this month's rent, $4,000, in cash.",
+		transaction: true,
+		effects: [{
+			term: "assets",
+			label: "Cash",
+			delta: -4e3
+		}, {
+			term: "expenses",
+			label: "Rent",
+			delta: 4e3
+		}],
+		reason: "Cash left the business to pay for something it used up: an expense."
+	}
+];
+const DEFAULT_DOCUMENTS = [
+	{
+		id: "sale-on-credit",
+		kind: "invoice",
+		from: "Green Leaf Traders",
+		to: "Mitu Stationers",
+		date: "5 March",
+		ref: "214",
+		rows: [{
+			label: "Exercise books",
+			qty: 200,
+			rate: 40,
+			amount: 8e3
+		}, {
+			label: "Gel pens",
+			qty: 100,
+			rate: 15,
+			amount: 1500
+		}],
+		less: [{
+			label: "Trade discount 5%",
+			amount: 475
+		}],
+		total: 9025,
+		note: "Payment due within 30 days."
+	},
+	{
+		id: "counter-sale",
+		kind: "cash-memo",
+		from: "Mitu Stationers",
+		to: "Rafi Ahmed",
+		date: "6 March",
+		ref: "088",
+		rows: [{
+			label: "Geometry box",
+			qty: 2,
+			rate: 250,
+			amount: 500
+		}, {
+			label: "Notebooks",
+			qty: 4,
+			rate: 60,
+			amount: 240
+		}],
+		total: 740,
+		note: "Paid in cash. Thank you!"
+	},
+	{
+		id: "books-returned",
+		kind: "debit-note",
+		from: "Mitu Stationers",
+		to: "Green Leaf Traders",
+		date: "9 March",
+		ref: "12",
+		rows: [{
+			label: "Exercise books returned, torn covers",
+			qty: 20,
+			rate: 40,
+			amount: 800
+		}],
+		total: 800,
+		note: "We have debited your account with the above amount."
+	},
+	{
+		id: "return-accepted",
+		kind: "credit-note",
+		from: "Green Leaf Traders",
+		to: "Mitu Stationers",
+		date: "11 March",
+		ref: "31",
+		rows: [{
+			label: "Exercise books returned, torn covers",
+			qty: 20,
+			rate: 40,
+			amount: 800
+		}],
+		total: 800,
+		note: "We have credited your account with the above amount."
+	},
+	{
+		id: "power-bill",
+		kind: "debit-voucher",
+		from: "Mitu Stationers",
+		to: "City Power Ltd",
+		date: "14 March",
+		ref: "7",
+		rows: [{
+			label: "Electricity bill for March",
+			amount: 2400
+		}],
+		total: 2400,
+		note: "Approved by the manager."
+	}
+];
+/** journal mode: one month of Mitu Stationers' documents (two purchases, so a total appears mid-way). */
+const DEFAULT_JOURNAL_DOCUMENTS = [
+	{
+		id: "stock-bought",
+		kind: "invoice",
+		from: "Green Leaf Traders",
+		to: "Mitu Stationers",
+		date: "5 March",
+		ref: "214",
+		rows: [{
+			label: "Exercise books",
+			qty: 200,
+			rate: 40,
+			amount: 8e3
+		}, {
+			label: "Gel pens",
+			qty: 100,
+			rate: 15,
+			amount: 1500
+		}],
+		less: [{
+			label: "Trade discount 5%",
+			amount: 475
+		}],
+		total: 9025,
+		terms: "2/10, net 30",
+		journal: "purchases"
+	},
+	{
+		id: "school-order",
+		kind: "invoice",
+		from: "Mitu Stationers",
+		to: "Lake View School",
+		date: "8 March",
+		ref: "61",
+		rows: [{
+			label: "Drawing books",
+			qty: 50,
+			rate: 80,
+			amount: 4e3
+		}],
+		total: 4e3,
+		terms: "net 30",
+		journal: "sales"
+	},
+	{
+		id: "torn-books",
+		kind: "debit-note",
+		from: "Mitu Stationers",
+		to: "Green Leaf Traders",
+		date: "9 March",
+		ref: "12",
+		rows: [{
+			label: "Exercise books returned, torn covers",
+			qty: 20,
+			rate: 40,
+			amount: 800
+		}],
+		total: 800,
+		journal: "purchase-returns"
+	},
+	{
+		id: "school-return",
+		kind: "credit-note",
+		from: "Mitu Stationers",
+		to: "Lake View School",
+		date: "12 March",
+		ref: "5",
+		rows: [{
+			label: "Drawing books returned, wrong size",
+			qty: 5,
+			rate: 80,
+			amount: 400
+		}],
+		total: 400,
+		journal: "sales-returns"
+	},
+	{
+		id: "shop-fridge",
+		kind: "invoice",
+		from: "Cool Home Electronics",
+		to: "Mitu Stationers",
+		date: "15 March",
+		ref: "77",
+		rows: [{
+			label: "Fridge for the shop",
+			qty: 1,
+			rate: 32e3,
+			amount: 32e3
+		}],
+		total: 32e3,
+		terms: "net 60",
+		journal: "general",
+		debit: "Fridge",
+		options: { debit: [
+			"Fridge",
+			"Purchases",
+			"Cash"
+		] },
+		why: { journal: "Kept for the shop to use, not stock to resell." }
+	},
+	{
+		id: "paper-bought",
+		kind: "invoice",
+		from: "Paper House",
+		to: "Mitu Stationers",
+		date: "18 March",
+		ref: "388",
+		rows: [{
+			label: "Printing paper (reams)",
+			qty: 20,
+			rate: 300,
+			amount: 6e3
+		}],
+		total: 6e3,
+		terms: "net 30",
+		journal: "purchases"
+	}
+];
+const DEFAULT_VOUCHERS = [{
+	story: "On 12 March, Mitu Stationers paid $1,800 in cash to Bright Cleaners for cleaning the shop.",
+	kind: "debit-voucher",
+	business: "Mitu Stationers",
+	fields: {
+		date: "12 March",
+		party: "Bright Cleaners",
+		account: "Cleaning expenses",
+		amount: 1800
+	},
+	options: {
+		date: [
+			"10 March",
+			"12 March",
+			"15 March"
+		],
+		party: ["Bright Cleaners", "Mitu Stationers"],
+		account: [
+			"Cleaning expenses",
+			"Cash",
+			"Accounts receivable",
+			"Sales"
+		]
+	},
+	why: {}
+}, {
+	story: "On 15 March, Mitu Stationers received $5,000 in cash from Rafi Ahmed, who owed the shop for goods.",
+	kind: "credit-voucher",
+	business: "Mitu Stationers",
+	fields: {
+		date: "15 March",
+		party: "Rafi Ahmed",
+		account: "Accounts receivable",
+		amount: 5e3
+	},
+	options: {
+		date: [
+			"12 March",
+			"15 March",
+			"20 March"
+		],
+		party: ["Rafi Ahmed", "Mitu Stationers"],
+		account: [
+			"Cleaning expenses",
+			"Cash",
+			"Accounts receivable",
+			"Sales"
+		]
+	},
+	why: {}
+}];
+const text = (max = 240) => z.string().trim().min(1).max(max);
+const id = z.string().trim().min(1).max(40).regex(/^[a-z0-9-]+$/, "ids are lower-case words joined by hyphens");
+const money = z.number().finite().nonnegative();
+const termSchema = z.enum([
+	"assets",
+	"liabilities",
+	"capital",
+	"drawings",
+	"revenue",
+	"expenses"
+]);
+const kindSchema = z.enum(DOC_KINDS);
+const partial = (keys) => z.object(Object.fromEntries(keys.map((k) => [k, text().optional()])));
+const choiceList = z.array(text(80)).min(2).max(8).optional();
+const cardSchema = z.object({
+	id,
+	text: text(),
+	transaction: z.boolean(),
+	effects: z.array(z.object({
+		term: termSchema,
+		label: text(60),
+		delta: z.number().finite().refine((v) => v !== 0, "a change cannot be zero")
+	})).max(6).optional(),
+	reason: text()
+});
+const documentSchema = z.object({
+	id,
+	kind: kindSchema,
+	from: text(80),
+	to: text(80).optional(),
+	date: text(40).optional(),
+	ref: text(40).optional(),
+	rows: z.array(z.object({
+		label: text(80),
+		qty: z.number().finite().positive().optional(),
+		rate: money.optional(),
+		amount: money
+	})).min(1).max(8),
+	less: z.array(z.object({
+		label: text(80),
+		amount: money
+	})).max(3).optional(),
+	total: money,
+	terms: text(40).optional(),
+	note: text().optional(),
+	clue: text().optional(),
+	journal: z.enum(JOURNALS).optional(),
+	why: z.union([text(), partial(["journal", ...JOURNAL_FIELDS])]).optional(),
+	debit: text(80).optional(),
+	credit: text(80).optional(),
+	options: z.object({
+		date: choiceList,
+		party: choiceList,
+		ref: choiceList,
+		debit: choiceList
+	}).optional()
+});
+const voucherSchema = z.object({
+	story: text(400),
+	kind: z.enum(["debit-voucher", "credit-voucher"]),
+	business: text(80).optional(),
+	fields: z.object({
+		date: text(40),
+		party: text(80),
+		account: text(80),
+		amount: money.positive()
+	}),
+	options: z.object({
+		date: choiceList,
+		party: choiceList,
+		account: choiceList
+	}).default({}),
+	why: partial(FILL_FIELDS).default({})
+});
+const documentDeskParamsSchema = z.object({
+	mode: z.enum([
+		"sort",
+		"identify",
+		"fill",
+		"journal"
+	]).default("sort").describe("sort: event or transaction; identify: name the document; fill: fill a voucher; journal: enter documents in the journals"),
+	cards: z.array(cardSchema).min(1).max(12).default(DEFAULT_CARDS).describe("sort mode: { id, text, transaction, effects?: [{ term, label, delta }], reason }, one at a time"),
+	documents: z.array(documentSchema).min(1).max(8).optional().describe("identify and journal modes: { id, kind, from, to?, date?, ref?, rows: [{ label, qty?, rate?, amount }], less?, total, terms?, note?, clue?; journal mode also journal, why? (text, or { journal?, date?, party?, ref?, debit?, amount? }), debit? and credit? (general journal only), options? { date?, party?, ref?, debit? } }. Each mode has its own default set."),
+	business: text(80).optional().describe("journal mode: the business whose books these are; left out, it is the one name on every document"),
+	journalLabels: partial(JOURNALS).default({}).describe("journal mode: each journal as the lesson names it"),
+	journalHeadings: z.object(Object.fromEntries(JOURNALS.map((j) => [j, partial(HEADING_KEYS).optional()]))).default({}).describe("journal mode: per journal, its column headings { date, party, terms, ref, folio, debit, credit, dr, cr }; a special journal's debit/credit are its amount column's two lines"),
+	journalClues: partial(JOURNALS).default({}).describe("journal mode: what each journal takes, the feedback when it is picked"),
+	kinds: z.array(kindSchema).min(2).max(6).default([...DOC_KINDS]).describe("identify mode: the document kinds offered as answers, in this order"),
+	vouchers: z.array(voucherSchema).min(1).max(6).default(DEFAULT_VOUCHERS).describe("fill mode: { story, kind, business?, fields: { date, party, account, amount }, options?: { date?, party?, account? }, why? }"),
+	accounts: z.array(text(80)).max(8).default([]).describe("fill mode: account heads to choose from when a voucher gives none of its own; journal mode: added to the general journal debit choices"),
+	kindLabels: partial(DOC_KINDS).default({}).describe("each document kind as the lesson names it"),
+	kindClues: partial(DOC_KINDS).default({}).describe("the clue the feedback names for each kind"),
+	termLabels: partial(EQUATION_TERMS).default({}).describe("each equation term's name as the lesson writes it"),
+	fieldLabels: partial(Object.keys(FIELD_LABEL)).default({}).describe("words printed on documents and the voucher form: particulars, qty, rate, amount, paidTo, …"),
+	phrases: partial(Object.keys(PHRASE)).default({}).describe("answer names and feedback sentences: transaction, event, nothingMoved, stillEqual, …"),
+	currency: z.string().min(1).max(6).default("$").describe("printed before amounts; Tk groups in lakhs")
+});
+const BLANK = {
+	kind: "",
+	date: "",
+	party: "",
+	account: "",
+	amount: "",
+	ref: ""
+};
+const money$ = (s, v) => formatMoney(v, { currency: s.currency });
+/** A change as the equation shows it: "+$32,000" or "−$32,000". */
+function signedMoney(currency, v) {
+	return `${v < 0 ? "−" : "+"}${formatMoney(Math.abs(v), { currency })}`;
+}
+function sameText(a, b) {
+	const norm = (x) => x.trim().replace(/\s+/g, " ").toLowerCase();
+	return norm(a) === norm(b);
+}
+function amountMark(written, answer) {
+	if (written.trim() === "") return "wrong";
+	const value = parseAmount(written);
+	if (isRefusal(value)) return "unreadable";
+	return Math.abs(value - answer) < .005 ? "right" : "wrong";
+}
+function fieldMark(v, draft, field) {
+	if (field === "amount") return amountMark(draft.amount, v.fields.amount);
+	const answer = field === "kind" ? v.kind : v.fields[field];
+	return sameText(draft[field], answer) ? "right" : "wrong";
+}
+function unionOf(values) {
+	return [...new Set(values.map((x) => x.trim()))];
+}
+const draftKey = (f) => f === "debit" ? "account" : f;
+function journalMark(e, draft, field) {
+	if (field === "amount") return amountMark(draft.amount, e.answer.amount);
+	return sameText(draft[draftKey(field)], e.answer[field]) ? "right" : "wrong";
+}
+function booksOf(s, st) {
+	const landed = (i) => i < st.index || i === st.index && st.done;
+	return JOURNALS.flatMap((journal) => {
+		const all = s.entries.map((e, i) => ({
+			e,
+			i
+		})).filter(({ e }) => e.journal === journal);
+		if (all.length === 0) return [];
+		const rows = all.filter(({ i }) => landed(i)).map(({ e }) => ({
+			id: e.id,
+			date: e.answer.date,
+			party: e.answer.party,
+			ref: e.answer.ref,
+			debit: e.answer.debit,
+			terms: e.terms,
+			amount: e.answer.amount
+		}));
+		return [{
+			journal,
+			rows,
+			complete: rows.length === all.length,
+			total: rows.reduce((sum, r) => sum + r.amount, 0)
+		}];
+	});
+}
+/** journal: the row is open (the right journal is picked) and its journal has this column. */
+function rowAsks(s, st, field) {
+	const e = s.mode === "journal" ? s.entries[st.index] : undefined;
+	return !!e && st.pick === e.journal && e.fields.includes(field);
+}
+/** A row field's name: its column heading in the journal (the general journal's credit line for `party`). */
+function journalFieldLabel(s, journal, field) {
+	const h = s.journalHeadings[journal];
+	switch (field) {
+		case "date": return h.date;
+		case "party": return journal === "general" ? s.labels.creditAccount : h.party;
+		case "ref": return h.ref ?? s.labels.ref;
+		case "debit": return journal === "general" ? s.labels.debitAccount : h.debit ?? s.labels.account;
+		case "amount": return s.labels.amount;
+	}
+}
+function rowLabel(s, st, field) {
+	return journalFieldLabel(s, s.entries[st.index]?.journal ?? "purchases", field);
+}
+const documentDeskModel = defineLabModel({
+	id: "document-desk",
+	params: documentDeskParamsSchema,
+	resolve(p) {
+		const termLabel = (t) => p.termLabels[t] ?? TERM_LABEL[t];
+		const kindLabels = Object.fromEntries(DOC_KINDS.map((k) => [k, p.kindLabels[k] ?? KIND_LABEL[k]]));
+		const labels = {
+			...FIELD_LABEL,
+			...p.fieldLabels
+		};
+		const phrases = {
+			...PHRASE,
+			...p.phrases
+		};
+		const unique = (ids) => new Set(ids).size === ids.length;
+		if (!unique(p.cards.map((c) => c.id))) return refuse("duplicate-id", "Each card needs its own id.");
+		const cards = [];
+		for (const card of p.cards) {
+			const effects = card.effects ?? [];
+			if (!card.transaction && effects.length > 0) {
+				return refuse("event-has-effects", `"${card.id}" is not a transaction, so nothing in the equation can move: remove its effects.`);
+			}
+			if (card.transaction && effects.length === 0) {
+				return refuse("transaction-needs-effects", `"${card.id}" is a transaction: give the terms it moves.`);
+			}
+			const moved = equationChange(effects.map((e) => ({
+				term: e.term,
+				delta: e.delta
+			})));
+			if (!moved.balanced) {
+				return refuse("effects-unbalanced", `"${card.id}" moves the left side by ${moved.left} and the right side by ${moved.right}; a transaction keeps them equal.`);
+			}
+			cards.push({
+				id: card.id,
+				text: card.text,
+				transaction: card.transaction,
+				reason: card.reason,
+				effects: effects.map((e) => ({
+					term: e.term,
+					termLabel: termLabel(e.term),
+					side: termPosition(e.term) === "left" ? "left" : "right",
+					label: e.label,
+					delta: e.delta
+				})),
+				moved: {
+					left: moved.left,
+					right: moved.right
+				}
+			});
+		}
+		const docs = p.documents ?? (p.mode === "journal" ? DEFAULT_JOURNAL_DOCUMENTS : DEFAULT_DOCUMENTS);
+		if (!unique(docs.map((d) => d.id))) return refuse("duplicate-id", "Each document needs its own id.");
+		if (!unique(p.kinds)) return refuse("duplicate-kind", "Offer each document kind once.");
+		const documents = [];
+		for (const doc of docs) {
+			if (!p.kinds.includes(doc.kind)) {
+				return refuse("kind-not-offered", `"${doc.id}" is a ${doc.kind}, which is not among the kinds offered.`);
+			}
+			if (doc.to !== undefined && sameText(doc.to, doc.from)) {
+				return refuse("same-parties", `"${doc.id}" names ${doc.from} as both parties.`);
+			}
+			for (const row of doc.rows) {
+				if (row.qty !== undefined && row.rate !== undefined && Math.abs(row.qty * row.rate - row.amount) >= .005) {
+					return refuse("row-mismatch", `"${doc.id}": ${row.label} is ${row.qty} × ${row.rate}, not ${row.amount}.`);
+				}
+			}
+			const gross = doc.rows.reduce((sum, r) => sum + r.amount, 0);
+			const less = (doc.less ?? []).reduce((sum, r) => sum + r.amount, 0);
+			if (Math.abs(gross - less - doc.total) >= .005) {
+				return refuse("total-mismatch", `"${doc.id}": the rows come to ${gross - less}, not ${doc.total}.`);
+			}
+			documents.push({
+				...doc,
+				title: kindLabels[doc.kind],
+				clueText: doc.clue ?? p.kindClues[doc.kind] ?? KIND_CLUE[doc.kind]
+			});
+		}
+		const journalLabels = Object.fromEntries(JOURNALS.map((j) => [j, p.journalLabels[j] ?? JOURNAL_LABEL[j]]));
+		const journalHeadings = Object.fromEntries(JOURNALS.map((j) => [j, {
+			...JOURNAL_HEADING[j],
+			...p.journalHeadings[j]
+		}]));
+		const journalClues = Object.fromEntries(JOURNALS.map((j) => [j, p.journalClues[j] ?? JOURNAL_CLUE[j]]));
+		let business = p.business ?? "";
+		const entries = [];
+		if (p.mode === "journal") {
+			const missing = documents.find((d) => d.journal === undefined);
+			if (missing) {
+				return refuse("needs-journal", `"${missing.id}" needs a journal: purchases, sales, purchase-returns, sales-returns, cash-receipts, cash-payments or general.`);
+			}
+			if (!business) {
+				const names = unionOf(documents.flatMap((d) => [d.from, ...d.to ? [d.to] : []]));
+				const everywhere = names.filter((n) => documents.every((d) => sameText(d.from, n) || d.to !== undefined && sameText(d.to, n)));
+				if (everywhere.length !== 1) {
+					return refuse("business-unclear", "Name the business whose books these are: give `business` (no single name is on every document).");
+				}
+				business = everywhere[0];
+			}
+			const needsRef = (j) => journalFields(j).includes("ref");
+			const generalCredit = (d, other) => d.credit ?? other;
+			const otherOf = (d) => sameText(d.from, business) ? d.to : d.to !== undefined && sameText(d.to, business) ? d.from : undefined;
+			for (const d of documents) {
+				const journal = d.journal;
+				const ours = sameText(d.from, business);
+				if (!ours && (d.to === undefined || !sameText(d.to, business))) {
+					return refuse("business-not-party", `"${d.id}" is not to or from ${business}.`);
+				}
+				if (!journalTakes(journal, d.kind, ours)) {
+					return refuse("journal-kind-mismatch", `"${d.id}" is a ${d.kind} ${ours ? "issued by" : "received by"} ${business}; the ${journal} journal does not take it.`);
+				}
+				if (!d.date) return refuse("needs-date", `"${d.id}" needs a date: its row starts with one.`);
+				if (needsRef(journal) && !d.ref) {
+					return refuse("needs-ref", `"${d.id}" needs a ref: the ${journal} journal has a number column.`);
+				}
+				if (journal !== "general" && (d.debit !== undefined || d.credit !== undefined)) {
+					return refuse("accounts-outside-general", `"${d.id}": debit and credit are for the general journal; the ${journal} journal's column names them.`);
+				}
+				if (journal === "general" && d.debit === undefined) {
+					return refuse("needs-debit", `"${d.id}" goes in the general journal: give the account it debits.`);
+				}
+				if (otherOf(d) === undefined && !(journal === "general" && d.credit !== undefined)) {
+					return refuse("needs-party", `"${d.id}" needs the other party: give \`to\`.`);
+				}
+			}
+			const general = documents.filter((d) => d.journal === "general");
+			const defaults = {
+				date: unionOf(documents.map((d) => d.date)),
+				party: unionOf([...documents.flatMap((d) => [d.from, ...d.to ? [d.to] : []]), ...general.flatMap((d) => d.credit ? [d.credit] : [])]),
+				ref: unionOf(documents.flatMap((d) => d.ref ? [d.ref] : [])),
+				debit: unionOf([...general.map((d) => d.debit), ...p.accounts])
+			};
+			for (const d of documents) {
+				const journal = d.journal;
+				const heading = journalHeadings[journal];
+				const party = journal === "general" ? generalCredit(d, otherOf(d) ?? "") : otherOf(d);
+				const answer = {
+					date: d.date,
+					party,
+					ref: d.ref ?? "",
+					debit: d.debit ?? "",
+					amount: d.total
+				};
+				const options = {
+					date: unionOf(d.options?.date ?? defaults.date),
+					party: unionOf(d.options?.party ?? defaults.party),
+					ref: unionOf(d.options?.ref ?? defaults.ref),
+					debit: unionOf(d.options?.debit ?? defaults.debit)
+				};
+				const fields = journalFields(journal);
+				for (const field of fields) {
+					if (field === "amount") continue;
+					if (!options[field].some((o) => sameText(o, answer[field]))) {
+						return refuse("answer-not-offered", `"${d.id}": "${answer[field]}" is not among its ${field} choices.`);
+					}
+					if (options[field].length < 2) {
+						return refuse("needs-choices", `"${d.id}" needs at least two ${field} choices: give options.${field}${field === "debit" ? " or accounts" : ""}.`);
+					}
+				}
+				const authored = typeof d.why === "string" ? { journal: d.why } : d.why ?? {};
+				const amount = money$(p, d.total);
+				entries.push({
+					...d,
+					journal,
+					fields,
+					answer,
+					options,
+					why: {
+						journal: authored.journal ?? journalClues[journal],
+						date: authored.date ?? `The row takes the date on the document: ${answer.date}.`,
+						party: authored.party ?? (journal === "general" ? `${heading.credit ?? "Credit"}: ${party}.` : `${heading.party}: ${party}, the other party on the document.`),
+						ref: authored.ref ?? `${heading.ref ?? "No."}: ${answer.ref}, the number printed on the document.`,
+						debit: authored.debit ?? (answer.debit ? `${heading.debit ?? "Debit"}: ${answer.debit}.` : ""),
+						amount: authored.amount ?? `The row takes the document's total, after trade discount: ${amount}.`
+					}
+				});
+			}
+		}
+		const vouchers = [];
+		for (const [i, v] of p.vouchers.entries()) {
+			const options = {
+				date: unionOf(v.options.date ?? p.vouchers.map((x) => x.fields.date)),
+				party: unionOf(v.options.party ?? p.vouchers.map((x) => x.fields.party)),
+				account: unionOf(v.options.account ?? (p.accounts.length > 0 ? p.accounts : p.vouchers.map((x) => x.fields.account)))
+			};
+			for (const field of [
+				"date",
+				"party",
+				"account"
+			]) {
+				if (!options[field].some((o) => sameText(o, v.fields[field]))) {
+					return refuse("answer-not-offered", `Voucher ${i + 1}: "${v.fields[field]}" is not among its ${field} choices.`);
+				}
+				if (options[field].length < 2) {
+					return refuse("needs-choices", `Voucher ${i + 1} needs at least two ${field} choices: give options.${field}.`);
+				}
+			}
+			const amount = money$(p, v.fields.amount);
+			const paid = v.kind === "debit-voucher";
+			vouchers.push({
+				story: v.story,
+				kind: v.kind,
+				business: v.business,
+				fields: v.fields,
+				options,
+				why: {
+					kind: v.why.kind ?? p.kindClues[v.kind] ?? KIND_CLUE[v.kind],
+					date: v.why.date ?? `A voucher carries the day the cash moved: ${v.fields.date}.`,
+					party: v.why.party ?? (paid ? `The voucher names who was paid: ${v.fields.party}.` : `The voucher names who paid the business: ${v.fields.party}.`),
+					account: v.why.account ?? `The account head says what the money was for: ${v.fields.account}.`,
+					amount: v.why.amount ?? `The story's amount is ${amount}. Write it in figures, like ${amount}.`
+				}
+			});
+		}
+		const count = p.mode === "sort" ? cards.length : p.mode === "identify" || p.mode === "journal" ? documents.length : vouchers.length;
+		return {
+			mode: p.mode,
+			currency: p.currency,
+			cards,
+			documents,
+			entries,
+			business,
+			journalLabels,
+			journalHeadings,
+			journalClues,
+			vouchers,
+			kinds: p.kinds,
+			kindLabels,
+			labels,
+			phrases,
+			count
+		};
+	},
+	initial: () => ({
+		index: 0,
+		pick: "",
+		issuer: "",
+		draft: BLANK,
+		checked: null,
+		done: false,
+		tries: 0,
+		misses: 0,
+		firstTry: []
+	}),
+	controls: (c) => ({
+		sortAnswer: c.choice({
+			unset: true,
+			label: "Transaction or not?",
+			when: (s) => s.mode === "sort",
+			options: (s) => [{
+				value: "transaction",
+				label: s.phrases.transaction
+			}, {
+				value: "event",
+				label: s.phrases.event
+			}],
+			get: (st, s) => s.mode === "sort" ? st.pick : "",
+			set: (st, value, s) => {
+				if (st.done) return st;
+				const card = s.cards[st.index];
+				const right = value === "transaction" === card.transaction;
+				return {
+					...st,
+					pick: value,
+					done: true,
+					tries: 1,
+					firstTry: [...st.firstTry, right]
+				};
+			}
+		}),
+		docKind: c.choice({
+			unset: true,
+			label: (s) => s.phrases.kindQuestion,
+			when: (s) => s.mode === "identify",
+			options: (s) => s.kinds.map((k) => ({
+				value: k,
+				label: s.kindLabels[k]
+			})),
+			get: (st, s) => s.mode === "identify" ? st.pick : "",
+			set: (st, value) => st.done ? st : {
+				...st,
+				pick: value
+			}
+		}),
+		issuer: c.choice({
+			unset: true,
+			label: (s) => s.phrases.issuerQuestion,
+			when: (s, st) => s.mode === "identify" && s.documents[st.index]?.to !== undefined,
+			options: (s, st) => {
+				const doc = s.documents[st.index];
+				if (!doc?.to) return [];
+				const both = [{
+					value: "from",
+					label: doc.from
+				}, {
+					value: "to",
+					label: doc.to
+				}];
+				return both.sort((a, b) => a.label < b.label ? -1 : a.label > b.label ? 1 : 0);
+			},
+			get: (st) => st.issuer,
+			set: (st, value) => st.done ? st : {
+				...st,
+				issuer: value
+			}
+		}),
+		voucherKind: c.choice({
+			unset: true,
+			label: (s) => s.labels.voucherType,
+			when: (s) => s.mode === "fill",
+			options: (s) => [{
+				value: "debit-voucher",
+				label: s.kindLabels["debit-voucher"]
+			}, {
+				value: "credit-voucher",
+				label: s.kindLabels["credit-voucher"]
+			}],
+			get: (st, s) => s.mode === "fill" ? st.draft.kind : "",
+			set: (st, value) => st.done ? st : {
+				...st,
+				draft: {
+					...st.draft,
+					kind: value
+				}
+			}
+		}),
+		voucherDate: c.choice({
+			unset: true,
+			label: (s) => s.labels.date,
+			when: (s) => s.mode === "fill",
+			options: (s, st) => (s.vouchers[st.index]?.options.date ?? []).map((o) => ({
+				value: o,
+				label: o
+			})),
+			get: (st, s) => s.mode === "fill" ? st.draft.date : "",
+			set: (st, value) => st.done ? st : {
+				...st,
+				draft: {
+					...st.draft,
+					date: value
+				}
+			}
+		}),
+		voucherParty: c.choice({
+			unset: true,
+			label: (s, st) => st.draft.kind === "debit-voucher" ? s.labels.paidTo : st.draft.kind === "credit-voucher" ? s.labels.receivedFrom : s.labels.party,
+			when: (s) => s.mode === "fill",
+			options: (s, st) => (s.vouchers[st.index]?.options.party ?? []).map((o) => ({
+				value: o,
+				label: o
+			})),
+			get: (st, s) => s.mode === "fill" ? st.draft.party : "",
+			set: (st, value) => st.done ? st : {
+				...st,
+				draft: {
+					...st.draft,
+					party: value
+				}
+			}
+		}),
+		voucherAccount: c.choice({
+			unset: true,
+			label: (s) => s.labels.account,
+			when: (s) => s.mode === "fill",
+			options: (s, st) => (s.vouchers[st.index]?.options.account ?? []).map((o) => ({
+				value: o,
+				label: o
+			})),
+			get: (st, s) => s.mode === "fill" ? st.draft.account : "",
+			set: (st, value) => st.done ? st : {
+				...st,
+				draft: {
+					...st.draft,
+					account: value
+				}
+			}
+		}),
+		voucherAmount: c.text({
+			label: (s) => s.labels.amount,
+			when: (s) => s.mode === "fill",
+			inputMode: "decimal",
+			get: (st, s) => s.mode === "fill" ? st.draft.amount : "",
+			set: (st, value) => st.done ? st : {
+				...st,
+				draft: {
+					...st.draft,
+					amount: value
+				}
+			}
+		}),
+		journalPick: c.choice({
+			unset: true,
+			label: (s) => s.phrases.journalQuestion,
+			when: (s) => s.mode === "journal",
+			options: (s) => JOURNALS.map((j) => ({
+				value: j,
+				label: s.journalLabels[j]
+			})),
+			get: (st, s) => s.mode === "journal" ? st.pick : "",
+			set: (st, value, s) => {
+				const e = s.entries[st.index];
+				if (!e || st.done || st.pick === e.journal) return st;
+				return {
+					...st,
+					pick: value,
+					misses: value === e.journal ? st.misses : st.misses + 1
+				};
+			}
+		}),
+		journalDate: c.choice({
+			unset: true,
+			label: (s, st) => s.journalHeadings[s.entries[st.index]?.journal ?? "purchases"].date,
+			when: (s, st) => rowAsks(s, st, "date"),
+			options: (s, st) => (s.entries[st.index]?.options.date ?? []).map((o) => ({
+				value: o,
+				label: o
+			})),
+			get: (st, s) => s.mode === "journal" ? st.draft.date : "",
+			set: (st, value) => st.done ? st : {
+				...st,
+				draft: {
+					...st.draft,
+					date: value
+				}
+			}
+		}),
+		journalParty: c.choice({
+			unset: true,
+			label: (s, st) => rowLabel(s, st, "party"),
+			when: (s, st) => rowAsks(s, st, "party"),
+			options: (s, st) => (s.entries[st.index]?.options.party ?? []).map((o) => ({
+				value: o,
+				label: o
+			})),
+			get: (st, s) => s.mode === "journal" ? st.draft.party : "",
+			set: (st, value) => st.done ? st : {
+				...st,
+				draft: {
+					...st.draft,
+					party: value
+				}
+			}
+		}),
+		journalRef: c.choice({
+			unset: true,
+			label: (s, st) => rowLabel(s, st, "ref"),
+			when: (s, st) => rowAsks(s, st, "ref"),
+			options: (s, st) => (s.entries[st.index]?.options.ref ?? []).map((o) => ({
+				value: o,
+				label: o
+			})),
+			get: (st, s) => s.mode === "journal" ? st.draft.ref : "",
+			set: (st, value) => st.done ? st : {
+				...st,
+				draft: {
+					...st.draft,
+					ref: value
+				}
+			}
+		}),
+		journalDebit: c.choice({
+			unset: true,
+			label: (s, st) => rowLabel(s, st, "debit"),
+			when: (s, st) => rowAsks(s, st, "debit"),
+			options: (s, st) => (s.entries[st.index]?.options.debit ?? []).map((o) => ({
+				value: o,
+				label: o
+			})),
+			get: (st, s) => s.mode === "journal" ? st.draft.account : "",
+			set: (st, value) => st.done ? st : {
+				...st,
+				draft: {
+					...st.draft,
+					account: value
+				}
+			}
+		}),
+		journalAmount: c.text({
+			label: (s, st) => rowLabel(s, st, "amount"),
+			when: (s, st) => rowAsks(s, st, "amount"),
+			inputMode: "decimal",
+			get: (st, s) => s.mode === "journal" ? st.draft.amount : "",
+			set: (st, value) => st.done ? st : {
+				...st,
+				draft: {
+					...st.draft,
+					amount: value
+				}
+			}
+		}),
+		check: c.action({
+			label: "Check",
+			when: (s) => s.mode !== "sort",
+			enabled: (s, st) => {
+				if (st.done) return false;
+				if (s.mode === "identify") {
+					return st.pick !== "" && (s.documents[st.index]?.to === undefined || st.issuer !== "");
+				}
+				if (s.mode === "journal") {
+					const e = s.entries[st.index];
+					return !!e && st.pick === e.journal && e.fields.every((f) => st.draft[draftKey(f)].trim() !== "");
+				}
+				return FILL_FIELDS.every((f) => st.draft[f].trim() !== "");
+			},
+			run: (s, st) => {
+				if (st.done) return st;
+				if (s.mode === "identify") {
+					const doc = s.documents[st.index];
+					const right = st.pick === doc.kind && (doc.to === undefined || st.issuer === "from");
+					return {
+						...st,
+						done: true,
+						tries: 1,
+						firstTry: [...st.firstTry, right]
+					};
+				}
+				if (s.mode === "journal") {
+					const e = s.entries[st.index];
+					if (st.pick !== e.journal) return st;
+					const tries = st.tries + 1;
+					const allRight = e.fields.every((f) => journalMark(e, st.draft, f) === "right");
+					return {
+						...st,
+						checked: st.draft,
+						tries,
+						done: allRight,
+						firstTry: allRight ? [...st.firstTry, tries === 1 && st.misses === 0] : st.firstTry
+					};
+				}
+				const v = s.vouchers[st.index];
+				const tries = st.tries + 1;
+				const allRight = FILL_FIELDS.every((f) => fieldMark(v, st.draft, f) === "right");
+				return {
+					...st,
+					checked: st.draft,
+					tries,
+					done: allRight,
+					firstTry: allRight ? [...st.firstTry, tries === 1] : st.firstTry
+				};
+			}
+		}),
+		next: c.action({
+			label: "Next",
+			enabled: (s, st) => st.done && st.index < s.count - 1,
+			run: (s, st) => st.done && st.index < s.count - 1 ? {
+				...st,
+				index: st.index + 1,
+				pick: "",
+				issuer: "",
+				draft: BLANK,
+				checked: null,
+				done: false,
+				tries: 0,
+				misses: 0
+			} : st
+		})
+	}),
+	read(s, st) {
+		const last = st.index >= s.count - 1;
+		const card = s.mode === "sort" ? s.cards[st.index] : undefined;
+		const doc = s.mode === "identify" ? s.documents[st.index] : undefined;
+		const voucher = s.mode === "fill" ? s.vouchers[st.index] : undefined;
+		const sortRight = card && st.done ? st.pick === "transaction" === card.transaction : undefined;
+		const kindRight = doc && st.done ? st.pick === doc.kind : undefined;
+		const issuerRight = doc && st.done && doc.to !== undefined ? st.issuer === "from" : undefined;
+		const marks = Object.fromEntries(FILL_FIELDS.map((f) => {
+			if (!voucher || !st.checked) return [f, "pending"];
+			if (st.checked[f] !== st.draft[f]) return [f, "pending"];
+			return [f, fieldMark(voucher, st.checked, f)];
+		}));
+		const entry = s.mode === "journal" ? s.entries[st.index] : undefined;
+		/** journal: the pick is the right journal, so the row is open. */
+		const journalOpen = !!entry && st.pick === entry.journal;
+		const journalPickMark = !entry || st.pick === "" ? undefined : journalOpen ? "right" : "wrong";
+		const rowMarks = Object.fromEntries(JOURNAL_FIELDS.map((f) => {
+			if (!entry || !st.checked || !entry.fields.includes(f)) return [f, "pending"];
+			const key = draftKey(f);
+			if (st.checked[key] !== st.draft[key]) return [f, "pending"];
+			return [f, journalMark(entry, st.checked, f)];
+		}));
+		const books = s.mode === "journal" ? booksOf(s, st) : [];
+		const finished = st.done && last;
+		const rightFirst = st.firstTry.filter(Boolean).length;
+		return {
+			index: st.index,
+			count: s.count,
+			last,
+			done: st.done,
+			finished,
+			card,
+			doc,
+			voucher,
+			entry,
+			journalOpen,
+			journalPickMark,
+			rowMarks,
+			books,
+			sortRight,
+			kindRight,
+			issuerRight,
+			marks,
+			rightFirst,
+			partyLabel: st.draft.kind === "debit-voucher" ? s.labels.paidTo : st.draft.kind === "credit-voucher" ? s.labels.receivedFrom : s.labels.party
+		};
+	},
+	goals: { finished: (r) => r.finished },
+	witness: (s) => {
+		const lastIndex = s.count - 1;
+		const base = {
+			index: lastIndex,
+			issuer: "",
+			checked: null,
+			done: true,
+			tries: 1,
+			misses: 0,
+			firstTry: Array(s.count).fill(true)
+		};
+		if (s.mode === "journal") {
+			const e = s.entries[lastIndex];
+			const draft = {
+				...BLANK,
+				date: e.answer.date,
+				party: e.answer.party,
+				ref: e.answer.ref,
+				account: e.answer.debit,
+				amount: String(e.answer.amount)
+			};
+			return {
+				...base,
+				pick: e.journal,
+				draft,
+				checked: draft
+			};
+		}
+		if (s.mode === "sort") {
+			const card = s.cards[lastIndex];
+			return {
+				...base,
+				pick: card.transaction ? "transaction" : "event",
+				draft: BLANK
+			};
+		}
+		if (s.mode === "identify") {
+			const doc = s.documents[lastIndex];
+			return {
+				...base,
+				pick: doc.kind,
+				issuer: doc.to ? "from" : "",
+				draft: BLANK
+			};
+		}
+		const v = s.vouchers[lastIndex];
+		const draft = {
+			...BLANK,
+			kind: v.kind,
+			...v.fields,
+			amount: String(v.fields.amount)
+		};
+		return {
+			...base,
+			pick: "",
+			draft,
+			checked: draft
+		};
+	},
+	describe: (s, st, r) => {
+		const position = `${st.index + 1} of ${s.count}.`;
+		if (r.card) {
+			if (!st.done) return `${position} ${r.card.text} Transaction or not?`;
+			const verdict = r.card.transaction ? s.phrases.transaction : s.phrases.event;
+			const moved = r.card.transaction ? `${r.card.effects.map((e) => `${e.termLabel}: ${e.label} ${signedMoney(s.currency, e.delta)}`).join(", ")}. ${s.phrases.stillEqual}` : s.phrases.nothingMoved;
+			return `${position} ${r.card.text} ${r.sortRight ? "Right" : "Not quite"}: ${verdict}. ${moved} ${r.card.reason}`;
+		}
+		if (r.doc) {
+			const doc = r.doc;
+			const head = `${position} A document from ${doc.from}${doc.to ? ` to ${doc.to}` : ""}, total ${money$(s, doc.total)}.`;
+			if (!st.done) return `${head} ${s.phrases.kindQuestion}`;
+			return `${head} ${r.kindRight ? "Right" : "Not quite"}: ${doc.title}${doc.to ? `, issued by ${doc.from}` : ""}. ${doc.clueText}`;
+		}
+		if (r.entry) {
+			const e = r.entry;
+			const head = `${position} ${e.title} from ${e.from}${e.to ? ` to ${e.to}` : ""}, ${e.date}, total ${money$(s, e.total)}.`;
+			if (!r.journalOpen) {
+				const miss = r.journalPickMark === "wrong" ? ` ${s.phrases.notThisJournal} ${s.journalLabels[st.pick] ?? st.pick}: ${s.journalClues[st.pick] ?? ""}` : "";
+				return `${head}${miss} ${s.phrases.journalQuestion}`;
+			}
+			const label = s.journalLabels[e.journal];
+			const wrong = e.fields.filter((f) => r.rowMarks[f] === "wrong" || r.rowMarks[f] === "unreadable").map((f) => journalFieldLabel(s, e.journal, f));
+			const book = r.books.find((b) => b.journal === e.journal);
+			const h = s.journalHeadings[e.journal];
+			const posting = st.done && book?.complete && e.journal !== "general" ? ` ${label} ${s.labels.total} ${money$(s, book.total)}. ${s.phrases.monthEnd} ${[h.debit, h.credit].filter(Boolean).join(" / ")}.` : "";
+			const status = st.done ? `Entered in the ${label}.${posting}` : st.checked ? wrong.length > 0 ? `Fix: ${wrong.join(", ")}.` : "Check again." : `${label}: fill its row, then check.`;
+			return `${head} ${status}`;
+		}
+		const v = r.voucher;
+		const name = {
+			kind: s.labels.voucherType,
+			date: s.labels.date,
+			party: r.partyLabel,
+			account: s.labels.account,
+			amount: s.labels.amount
+		};
+		const wrong = FILL_FIELDS.filter((f) => r.marks[f] === "wrong" || r.marks[f] === "unreadable").map((f) => name[f]);
+		const status = st.done ? "Every field is right." : st.checked ? wrong.length > 0 ? `Fix: ${wrong.join(", ")}.` : "Check again." : "Fill the voucher, then check.";
+		return `${position} ${v.story} ${status}`;
+	}
+});
+
+//#endregion
+export { DOC_KINDS, FILL_FIELDS, JOURNALS, JOURNAL_FIELDS, documentDeskModel, documentDeskParamsSchema, journalFieldLabel, journalFields, signedMoney };