@lernapps/app-templates 0.1.0 → 0.2.0

package/README.md

@@ -7,7 +7,7 @@ with which a creator and their AI assistant build a learning app.
 ## Who it is for
 
 - **Creators and their assistants** never open this repo: the generator of
-  [lernapps/tooling](https://github.com/lernapps/tooling) copies a template folder into a new app. Start at
+  [lernapps/tooling](https://github.com/lernapps/tooling) writes a template's scaffold into a new app. Start at
   [lernapps.net/apps/eintragen/](https://lernapps.net/apps/eintragen/), or, as an assistant, at
   [lernapps.net/tooling/llms.txt](https://lernapps.net/tooling/llms.txt).
 - **Maintainers of an archetype** change its template and its runtime here.
@@ -24,7 +24,7 @@ feature: assistants read it before they choose an archetype.
 | [`explainer/`](explainer/) | an explainer: chapters of pages with sections, formulas, figures, tables, timelines, definitions with a glossary, quotes, code and YouTube videos behind two clicks, and an exercise on every page (the quiz's question types, and `generated` exercises drawn from a seed and property-tested at build), readable without JavaScript, in one or more languages; an optional self-assessment of the app or a chapter, checked as a whole; Vue components for what no block can express | the content as YAML in `src/`: `app.yaml`, a folder per chapter with `chapter.yaml` and its pages, `data/` and `images/`, and `components/` ([schema](runtime/explainer/explainer.v1.schema.json)) |
 | [`interactive/`](interactive/) | an interactive app whose doing is the content (a game, a trainer): a static start page, readable without JavaScript, and an app page with the app's own Vue components, its routes as `app/#<id>`; the build plays its playthroughs against its core | `src/app.yaml` ([schema](runtime/interactive/interactive.v1.schema.json)), the core `src/core/index.ts` (`start(seed, route)`, `step(state, input)` with a key or an action of its root component, optional `tick(state, dt)`), its components in `src/ui/`, data in `src/data/`, and `src/playthroughs/*.yaml` ([schema](runtime/interactive/playthrough.v1.schema.json)) |
 
-- [`runtime/`](runtime/): the runtime of each archetype, published to npm as `@lernapps/app-templates` (with the template folders, which `lernapps create` of `@lernapps/tooling` copies out of the installed package); its exports
+- [`runtime/`](runtime/): the runtime of each archetype, published to npm as `@lernapps/app-templates` (with the template folders, complete example apps, and the scaffold of each archetype: `lernapps create` of `@lernapps/tooling` copies the paths `lernapps.scaffold.<archetype>` in [`package.json`](package.json) lists and the placeholder in [`scaffold/<archetype>/`](scaffold/), and leaves the example in the installed package; [`scripts/scaffold.ts`](scripts/scaffold.ts) writes the same for the CI job `scaffold`); its exports
   are in [`package.json`](package.json), what each does in the comments of its source. The quiz's questions also work
   one by one, for other archetypes that embed them as exercises: `@lernapps/app-templates/quiz/question` (schema,
   validation, rendering, checker, messages; a question's texts may be maps by language), `startQuestion` of `@lernapps/app-templates/quiz` and the helpers of

package/dist/{assessment-By2GGTJC.mjs → assessment-Dy359O1O.mjs}

@@ -1,5 +1,5 @@
 import { i as inLanguage, l as textsIn, s as localeOf, t as escape } from "./html-mffkHGHh.mjs";
-import { S as shuffled, c as hash, m as parseNumber, u as isCorrect, y as random } from "./render-BJey0bwl.mjs";
+import { S as shuffled, c as hash, m as parseNumber, u as isCorrect, y as random } from "./render-GS1Htlu8.mjs";
 import { createStorage } from "@lernapps/tooling/storage";
 // runtime/explainer/fraction.ts
 const abs = (n) => n < 0n ? -n : n;

package/dist/{blocks-BmRrD7UY.mjs → blocks-CxtCPAa5.mjs}

@@ -1,7 +1,7 @@
 import { i as inLanguage, l as textsIn, n as escapeText, s as localeOf, t as escape } from "./html-mffkHGHh.mjs";
 import { n as markerOf } from "./block-BK_ohsH1.mjs";
-import { l as renderFormula, n as isUrl, o as renderInline, s as renderMarkdown } from "./check-BkEl-m-F.mjs";
-import "./validate-CxtdeQ5S.mjs";
+import { c as renderMarkdown, n as isUrl, s as renderInline, u as renderFormula } from "./check-CteIFN96.mjs";
+import "./validate-Bxy9NfB8.mjs";
 import hljs from "highlight.js/lib/core";
 import bash from "highlight.js/lib/languages/bash";
 import c from "highlight.js/lib/languages/c";

package/dist/blocks.mjs

@@ -1,4 +1,4 @@
 import { i as materialIn, n as markerOf, r as materialImages, t as MATERIAL_TYPES } from "./block-BK_ohsH1.mjs";
-import { a as highlight, i as hundredGrid, n as renderMaterial, r as bar, t as renderCredit } from "./blocks-BmRrD7UY.mjs";
-import { n as checkMaterial, t as MATERIAL_DEFINITIONS } from "./validate-CxtdeQ5S.mjs";
+import { a as highlight, i as hundredGrid, n as renderMaterial, r as bar, t as renderCredit } from "./blocks-CxtCPAa5.mjs";
+import { n as checkMaterial, t as MATERIAL_DEFINITIONS } from "./validate-Bxy9NfB8.mjs";
 export { MATERIAL_DEFINITIONS, MATERIAL_TYPES, bar, checkMaterial, highlight, hundredGrid, markerOf, materialImages, materialIn, renderCredit, renderMaterial };

package/dist/{check-BkEl-m-F.mjs → check-CteIFN96.mjs}

@@ -251,4 +251,4 @@ function checkText(value, kind, languages, declaredIn) {
 		links
 	};
 }
-export { plain as a, renderWithFormulas as c, inspect as i, renderFormula as l, isUrl as n, renderInline as o, formulaProblems as r, renderMarkdown as s, checkText as t };
+export { inspect as a, renderMarkdown as c, formulaProblems as i, renderWithFormulas as l, isUrl as n, plain as o, FORMULA as r, renderInline as s, checkText as t, renderFormula as u };

package/dist/{content-cYBPYg_J.mjs → content-DO6oEJxj.mjs}

@@ -1,4 +1,4 @@
-import { t as checkText } from "./check-BkEl-m-F.mjs";
+import { t as checkText } from "./check-CteIFN96.mjs";
 import { readFileSync } from "node:fs";
 import { join } from "node:path";
 import { LineCounter, isNode, parseDocument } from "yaml";

package/dist/{e2e-BiMI-pCL.mjs → e2e-CU0n_unV.mjs}

@@ -1,5 +1,5 @@
 import { l as textsIn } from "./html-mffkHGHh.mjs";
-import { g as questionId, t as QUESTION_MESSAGES } from "./render-BJey0bwl.mjs";
+import { g as questionId, t as QUESTION_MESSAGES } from "./render-GS1Htlu8.mjs";
 import { expect } from "playwright/test";
 // runtime/shared/questions/e2e.ts
 /** The question's own texts in `lang`. */

package/dist/{engine-BqF2Vffn.mjs → engine-CArxqizW.mjs}

@@ -1,5 +1,5 @@
 import { l as textsIn } from "./html-mffkHGHh.mjs";
-import { S as shuffled, c as hash, f as missesRight, l as isComplete, t as QUESTION_MESSAGES, u as isCorrect, w as wrongReasons } from "./render-BJey0bwl.mjs";
+import { S as shuffled, c as hash, f as missesRight, l as isComplete, t as QUESTION_MESSAGES, u as isCorrect, w as wrongReasons } from "./render-GS1Htlu8.mjs";
 import { translator } from "@lernapps/tooling/i18n";
 import { moveFocus } from "@lernapps/tooling/a11y";
 // runtime/shared/questions/engine.ts

package/dist/explainer-e2e.mjs

@@ -1,13 +1,18 @@
-import { a as routes, d as templatesOf, f as workedTasks, l as renderExercise, n as loadSite, s as dataOf, u as taskSeeds } from "./load-C-0hUaSC.mjs";
+import { a as routes, d as templatesOf, f as workedTasks, l as renderExercise, n as loadSite, s as dataOf, u as taskSeeds } from "./load-RosvaPZf.mjs";
 import { i as inLanguage } from "./html-mffkHGHh.mjs";
-import { i as inspect, s as renderMarkdown } from "./check-BkEl-m-F.mjs";
-import { C as wrongAnswer, _ as questionIn, b as rightAnswer, f as missesRight, g as questionId, i as questionMessagesIn, n as answerText, w as wrongReasons } from "./render-BJey0bwl.mjs";
-import { a as giveAnswer, i as expectMaterial, r as expectFeedbackInView, t as answerQuestion } from "./e2e-BiMI-pCL.mjs";
-import { A as answerFor, C as watchAddress, D as generate, F as questionFor, G as taskText, I as taskKey, R as fill, U as plainText, X as kindOf, a as assessments, j as diagnose, m as titleOf, v as timelineEvents, w as message, y as embedAddress } from "./assessment-By2GGTJC.mjs";
-import { n as answerShown } from "./result-_eQcamoz.mjs";
+import { a as inspect, c as renderMarkdown, l as renderWithFormulas } from "./check-CteIFN96.mjs";
+import { C as wrongAnswer, _ as questionIn, b as rightAnswer, f as missesRight, g as questionId, i as questionMessagesIn, n as answerText, w as wrongReasons } from "./render-GS1Htlu8.mjs";
+import { a as giveAnswer, i as expectMaterial, r as expectFeedbackInView, t as answerQuestion } from "./e2e-CU0n_unV.mjs";
+import { A as answerFor, C as watchAddress, D as generate, F as questionFor, G as taskText, I as taskKey, R as fill, U as plainText, X as kindOf, a as assessments, j as diagnose, m as titleOf, v as timelineEvents, w as message, y as embedAddress } from "./assessment-Dy359O1O.mjs";
+import { n as answerShown } from "./result-D_mmCVwN.mjs";
 import { n as ASSESSMENT_TASK_EVENT, p as taskNumber, u as nextTaskNumber } from "./tasks-DADUYy52.mjs";
 import { expect, test } from "playwright/test";
 // runtime/explainer/outline.ts
+/**
+* A learner text of a question as the page shows it, as text: its formulas $…$ rendered (a formula has no space the
+* tests could rely on in a browser's text, see squash in e2e.ts), the rest as written.
+*/
+const shownText = (text) => plainText(renderWithFormulas(text));
 /** The headings, sections, formulas and figures of `blocks` in `lang`, under a heading of level `level`. */
 function walk(site, blocks, lang, level, anchor, into) {
 	const text = (value) => inLanguage(value, lang);
@@ -142,7 +147,7 @@ function walk(site, blocks, lang, level, anchor, into) {
 				id: block.id,
 				type: block.type,
 				question,
-				answers: question.type === "single-choice" || question.type === "multiple-choice" ? question.options.filter((option) => option.correct).map((option) => option.text) : [plainText(answerText(question, lang))]
+				answers: question.type === "single-choice" || question.type === "multiple-choice" ? question.options.filter((option) => option.correct).map((option) => shownText(option.text)) : [plainText(answerText(question, lang))]
 			});
 		}
 	}
@@ -279,6 +284,11 @@ const BAND_WORDS = {
 	read: "assessmentRead",
 	unasked: "assessmentUnasked"
 };
+/**
+* `text` without space. A browser's text of a formula has space between its parts ("2 7" for 2⁷) where the content's
+* has none, so texts with formulas are compared without it (in the order of their characters, which is what counts).
+*/
+const squash = (text) => text.replace(/\s+/g, "");
 /** The task number of the deep link the tests open a generated exercise with. */
 const SEED = 7;
 /**
@@ -290,7 +300,7 @@ async function expectExercises(page, item) {
 	const main = page.locator("main");
 	const expected = item.exercises.map((exercise) => exercise.kind === "question" ? {
 		id: exercise.id,
-		texts: [exercise.question.text],
+		texts: [shownText(exercise.question.text)],
 		answers: [exercise.answers]
 	} : exercise.kind === "open" ? {
 		id: exercise.id,
@@ -301,7 +311,7 @@ async function expectExercises(page, item) {
 		texts: exercise.worked.map((worked) => worked.task),
 		answers: exercise.worked.map((worked) => [worked.answer])
 	});
-	const read = () => main.locator(".explainer-exercise").evaluateAll((elements) => elements.map((element) => {
+	const read = async () => (await main.locator(".explainer-exercise").evaluateAll((elements) => elements.map((element) => {
 		const fold = (text) => (text ?? "").replace(/\s+/g, " ").trim();
 		const own = element.classList.contains("explainer-question") ? [...element.querySelectorAll("legend")] : element.classList.contains("explainer-open-task") ? [...element.querySelectorAll(":scope > .explainer-open-task-text")] : [...element.querySelectorAll(".explainer-worked-task > .explainer-task")];
 		const solutions = [...element.querySelectorAll("details.explainer-solution")];
@@ -310,6 +320,10 @@ async function expectExercises(page, item) {
 			texts: own.map((text) => fold(text.textContent)),
 			shown: solutions.map((details) => details.open ? fold(details.innerText) : "")
 		};
+	}))).map((item) => ({
+		...item,
+		texts: item.texts.map(squash),
+		shown: item.shown.map(squash)
 	}));
 	const before = await read();
 	expect(before.map(({ id, texts }) => ({
@@ -317,12 +331,12 @@ async function expectExercises(page, item) {
 		texts
 	})), `${item.url}: each exercise with its text`).toEqual(expected.map(({ id, texts }) => ({
 		id,
-		texts
+		texts: texts.map(squash)
 	})));
 	await main.locator(".explainer-exercise details.explainer-solution > summary").evaluateAll((summaries) => summaries.forEach((summary) => summary.click()));
 	const after = await read();
 	for (const [index, exercise] of expected.entries()) exercise.answers.forEach((answers, at) => {
-		for (const answer of answers) expect(after[index]?.shown[at] ?? "", `${item.url}: ${exercise.id}, Lösung ${at + 1} shows ${answer}`).toContain(answer);
+		for (const answer of answers) expect(after[index]?.shown[at] ?? "", `${item.url}: ${exercise.id}, Lösung ${at + 1} shows ${answer}`).toContain(squash(answer));
 	});
 }
 /** Without JavaScript: each component's nojs text is visible, not empty and as in the content; its island is hidden. */
@@ -535,7 +549,7 @@ const feedback = (page, id) => page.locator(`[id="${id}"] .question-feedback`);
 function reasonFor(question, answer) {
 	const quiz = questionMessagesIn("de");
 	const [first] = wrongReasons(question, answer);
-	if (first !== void 0) return first.option === void 0 ? first.text : `${first.option}: ${first.text}`;
+	if (first !== void 0) return first.option === void 0 ? shownText(first.text) : `${shownText(first.option)}: ${shownText(first.text)}`;
 	return missesRight(question, answer) ? quiz.missingRight : quiz.lookAgain;
 }
 /**
@@ -545,7 +559,7 @@ function reasonFor(question, answer) {
 async function wrongThenSolution(page, exercise, question, reason) {
 	const item = page.locator(`[id="${questionId(question)}"]`);
 	await expect(feedback(page, questionId(question))).toContainText(questionMessagesIn("de").wrong);
-	await expect(item.locator(".question-diagnosis").first(), `${exercise}: the reason of the wrong answer`).toHaveText(reason);
+	await expect.poll(async () => squash(await item.locator(".question-diagnosis").first().textContent() ?? ""), `${exercise}: the reason of the wrong answer`).toBe(squash(reason));
 	await expectFeedbackInView(page, question);
 	await expect(item.locator(".question-reveal"), `${exercise}: no solution after a wrong answer`).toBeHidden();
 	await expect(item.locator("input, select").first(), `${exercise}: another try`).toBeEnabled();
@@ -791,13 +805,32 @@ async function expectResultLine(request, copied, here, first, id, n) {
 	expect(response.status(), `${address} answers`).toBe(200);
 	expect(await response.text(), "the tutor page has the exercise").toContain(id);
 }
-/** The explainer's tests, for the content in `root`/src. */
+/**
+* The tests of an explainer's content, for the content in `root`/src: what every app runs (e2e/explainer.e2e.ts).
+* Without JavaScript every page as its content says, previous and next, the app's own components and the checks of
+* its exercise components. What the runtime does the same in every app is explainerRuntimeTests.
+*/
 function explainerTests(root = ".") {
+	explainerSuite(root, "content");
+}
+/**
+* The tests of the explainer's runtime on the content in `root`/src: the exercises of each type, the videos, the tutor
+* ways, the start page, the self-assessments, what is stored. The template folder and the fixtures of
+* lernapps/app-templates run them (e2e/runtime.e2e.ts); an app does not, its scaffold has no such file: they test the
+* runtime, which is the same in every app, not the app's content.
+*/
+function explainerRuntimeTests(root = ".") {
+	explainerSuite(root, "runtime");
+}
+/** Only at desktop width, in a test of what does not depend on the width; what a page shows is tested at 360 px too. */
+const desktopOnly = (page) => test.skip((page.viewportSize()?.width ?? 0) <= 400, "only at desktop width");
+function explainerSuite(root, part) {
 	const app = outline(root);
+	const content = part === "content";
 	test.describe("explainer", () => {
 		test.describe.configure({ mode: "parallel" });
 		test.use({ reducedMotion: "reduce" });
-		test.describe("without JavaScript", () => {
+		if (content) test.describe("without JavaScript", () => {
 			test.use({ javaScriptEnabled: false });
 			for (const lang of app.languages) {
 				for (const item of app.pages[lang] ?? []) test(`${item.url || "./"}: headings, sections, formulas, figures and anchors as in the content`, async ({ page }) => {
@@ -834,6 +867,7 @@ function explainerTests(root = ".") {
 					if (item.kind === "start") await expect(page.locator(".explainer-tutor-about h2")).toHaveText(message(item.lang, "tutorTitle"));
 				});
 				test(`${lang}: previous and next form one chain over all pages`, async ({ page }) => {
+					desktopOnly(page);
 					const order = (app.pages[lang] ?? []).map((item) => item.url);
 					const first = order[0];
 					if (first === void 0) throw new Error(`no page in ${lang}`);
@@ -867,7 +901,7 @@ function explainerTests(root = ".") {
 		});
 		test.describe("with JavaScript", () => {
 			test.skip(({ viewport }) => (viewport?.width ?? 0) > 400, "the exercises run at 360 px");
-			for (const item of app.pages["de"] ?? []) {
+			if (!content) for (const item of app.pages["de"] ?? []) {
 				const types = /* @__PURE__ */ new Map();
 				for (const exercise of item.exercises) if (!types.has(exercise.type)) types.set(exercise.type, exercise);
 				if (types.size === 0) continue;
@@ -881,13 +915,13 @@ function explainerTests(root = ".") {
 					expect(kept.length, "an answer per open task").toBe(types.has("open-task") ? 1 : 0);
 				});
 			}
-			for (const item of app.pages["de"] ?? []) {
+			if (!content) for (const item of app.pages["de"] ?? []) {
 				if (item.videos.length === 0) continue;
 				test(`${item.url}: the videos load nothing before a click, the player after it, directly once chosen`, async ({ page, baseURL }) => {
 					await checkVideos(page, item, new URL(baseURL ?? page.url()).origin);
 				});
 			}
-			for (const item of app.pages["de"] ?? []) {
+			if (content) for (const item of app.pages["de"] ?? []) {
 				if (item.components.length === 0) continue;
 				test(`${item.url}: each component hydrates without a console error (${item.components.map((component) => component.name).join(", ")})`, async ({ page }) => {
 					await checkComponents(page, item);
@@ -895,6 +929,7 @@ function explainerTests(root = ".") {
 				});
 			}
 		});
+		if (content) return;
 		for (const item of (app.pages["de"] ?? []).filter((candidate) => candidate.exercises.some((exercise) => exercise.kind === "generated"))) test(`${item.url}: the address holds the task of each exercise, and the tutor button gives them to the prompt`, async ({ page }) => {
 			await page.addInitScript(() => {
 				const copied = [];
@@ -1294,4 +1329,4 @@ function explainerTests(root = ".") {
 		});
 	});
 }
-export { explainerTests };
+export { explainerRuntimeTests, explainerTests };

package/dist/explainer-plugin.mjs

@@ -1,12 +1,12 @@
-import { _ as propertyProblems, a as routes, c as exerciseData, d as templatesOf, g as exampleProblems, h as describedProblems, i as hiddenChapter, l as renderExercise, m as TABLE_CONTRACT, n as loadSite, o as terms, p as SIZE_BUDGET, r as contentPages, s as dataOf, t as ContentError, u as taskSeeds, v as propsIn } from "./load-C-0hUaSC.mjs";
+import { _ as exampleProblems, a as routes, c as exerciseData, d as templatesOf, g as describedProblems, h as TABLE_CONTRACT, i as hiddenChapter, l as renderExercise, m as SIZE_BUDGET, n as loadSite, o as terms, p as formulaAlternative, r as contentPages, s as dataOf, t as ContentError, u as taskSeeds, v as propertyProblems, y as propsIn } from "./load-RosvaPZf.mjs";
 import { i as inLanguage, s as localeOf, t as escape } from "./html-mffkHGHh.mjs";
 import { n as markerOf } from "./block-BK_ohsH1.mjs";
-import { n as renderMaterial } from "./blocks-BmRrD7UY.mjs";
-import { a as plain, c as renderWithFormulas, o as renderInline, s as renderMarkdown } from "./check-BkEl-m-F.mjs";
-import { _ as questionIn, a as renderQuestion, i as questionMessagesIn, n as answerText } from "./render-BJey0bwl.mjs";
+import { n as renderMaterial } from "./blocks-CxtCPAa5.mjs";
+import { c as renderMarkdown, l as renderWithFormulas, o as plain, s as renderInline } from "./check-CteIFN96.mjs";
+import { _ as questionIn, a as renderQuestion, i as questionMessagesIn, n as answerText } from "./render-GS1Htlu8.mjs";
 import { n as isSizeless, t as imageType } from "./image-CspJVfyQ.mjs";
 import { a as pageFooter, c as withLanguage, i as notFoundPage, n as fromDepth, o as pageHeader, r as languageRoot, s as relative, t as alternateLinks } from "./pages-9RaaomoO.mjs";
-import { B as label, D as generate, F as questionFor, H as placeholdersIn, S as videoLine, U as plainText, V as placeholderValue, X as kindOf, _ as termId, a as assessments, b as renderVideo, h as allBlocks, m as titleOf, o as drawsTasks, p as stepHint, r as assessmentOf, v as timelineEvents, w as message } from "./assessment-By2GGTJC.mjs";
+import { B as label, D as generate, F as questionFor, H as placeholdersIn, S as videoLine, U as plainText, V as placeholderValue, X as kindOf, _ as termId, a as assessments, b as renderVideo, h as allBlocks, m as titleOf, o as drawsTasks, p as stepHint, r as assessmentOf, v as timelineEvents, w as message } from "./assessment-Dy359O1O.mjs";
 import { i as NEW_TASK_ICON } from "./tasks-DADUYy52.mjs";
 import { n as NEEDS, o as languageName, t as LANGUAGES } from "./needs-BzEahJ6X.mjs";
 import { n as vueAlias, r as withServer, t as VUE_OPTIONS } from "./vue-DO1m6q1R.mjs";
@@ -909,6 +909,7 @@ function itemHtml(context, data, n, component = "") {
 	return `${label}${renderQuestion(question, {
 		lang,
 		format: (text) => rendered[text] ?? renderWithFormulas(text),
+		describe: (text) => formulaAlternative(text, lang),
 		...question.material === void 0 ? {} : { materialHtml: renderMaterial(question.material, context.material) }
 	})}`;
 }

package/dist/explainer.mjs

@@ -1,8 +1,8 @@
 import { t as escape } from "./html-mffkHGHh.mjs";
-import { S as shuffled, a as renderQuestion, g as questionId, l as isComplete, u as isCorrect } from "./render-BJey0bwl.mjs";
-import { n as startQuestion, t as readAnswer } from "./engine-BqF2Vffn.mjs";
-import { D as generate, F as questionFor, G as taskText, N as mistakeOf, W as stepsOf, c as isStoredResult, f as resultQuery, i as assessmentPrompt, j as diagnose, l as linkLines, n as BAND_MESSAGES, u as pageResults, w as message, x as startVideos, z as hintOf } from "./assessment-By2GGTJC.mjs";
-import { i as sessionLines, n as answerShown, r as resultLine, t as Progress } from "./result-_eQcamoz.mjs";
+import { S as shuffled, a as renderQuestion, g as questionId, l as isComplete, u as isCorrect } from "./render-GS1Htlu8.mjs";
+import { n as startQuestion, t as readAnswer } from "./engine-CArxqizW.mjs";
+import { D as generate, F as questionFor, G as taskText, N as mistakeOf, W as stepsOf, c as isStoredResult, f as resultQuery, i as assessmentPrompt, j as diagnose, l as linkLines, n as BAND_MESSAGES, u as pageResults, w as message, x as startVideos, z as hintOf } from "./assessment-Dy359O1O.mjs";
+import { i as sessionLines, n as answerShown, r as resultLine, t as Progress } from "./result-D_mmCVwN.mjs";
 import { c as addressOf, d as numberFromAddress, f as randomTaskNumber, i as NEW_TASK_ICON, n as ASSESSMENT_TASK_EVENT, p as taskNumber, r as ASSESSMENT_UNPACKED_EVENT, s as SHOWN_EVENT, t as ASSESSMENT_ANSWER_EVENT, u as nextTaskNumber } from "./tasks-DADUYy52.mjs";
 import { a as isNeedsChoice, c as withNeeds, r as NEEDS_KEY, s as withLanguage } from "./needs-BzEahJ6X.mjs";
 import { moveFocus } from "@lernapps/tooling/a11y";

package/dist/interactive-e2e.mjs

@@ -1,7 +1,7 @@
 import { i as inLanguage } from "./html-mffkHGHh.mjs";
 import { r as languageRoot } from "./pages-9RaaomoO.mjs";
 import { i as doingText, n as STATE_PROPERTY, o as inputsOf, s as mismatch, t as CLOCK_PROPERTY } from "./contract-PONpxJtd.mjs";
-import { i as message, o as loadInteractive, t as APP_PAGE } from "./render-BL6fV_NI.mjs";
+import { i as message, o as loadInteractive, t as APP_PAGE } from "./render-D5kwkNt1.mjs";
 import { expect, test } from "playwright/test";
 // runtime/interactive/e2e.ts
 /** The page's language, its alternates and a switch to each other language, the archetype marker. */

package/dist/interactive-plugin.mjs

@@ -1,9 +1,9 @@
 import { c as withLanguage, i as notFoundPage, n as fromDepth } from "./pages-9RaaomoO.mjs";
 import { c as sourceScope, n as codeProblems } from "./vue-code-BkJjW_I_.mjs";
-import { o as pathText, t as Problems } from "./content-cYBPYg_J.mjs";
+import { o as pathText, t as Problems } from "./content-DO6oEJxj.mjs";
 import { n as vueAlias, r as withServer, t as VUE_OPTIONS } from "./vue-DO1m6q1R.mjs";
 import { a as inputText, i as doingText, o as inputsOf, s as mismatch } from "./contract-PONpxJtd.mjs";
-import { a as InteractiveError, n as pages, o as loadInteractive, r as renderPage } from "./render-BL6fV_NI.mjs";
+import { a as InteractiveError, n as pages, o as loadInteractive, r as renderPage } from "./render-D5kwkNt1.mjs";
 import { existsSync, readFileSync, readdirSync, statSync } from "node:fs";
 import { join } from "node:path";
 import vue from "@vitejs/plugin-vue";

package/dist/{load-C-0hUaSC.mjs → load-RosvaPZf.mjs}

@@ -1,19 +1,20 @@
 import { a as isLanguage, c as textLanguages, i as inLanguage, o as languageListProblems, r as LANGUAGES } from "./html-mffkHGHh.mjs";
-import { n as renderMaterial } from "./blocks-BmRrD7UY.mjs";
-import { a as plain, c as renderWithFormulas, i as inspect, o as renderInline, r as formulaProblems, s as renderMarkdown } from "./check-BkEl-m-F.mjs";
-import { n as checkMaterial } from "./validate-CxtdeQ5S.mjs";
-import { _ as questionIn, a as renderQuestion, b as rightAnswer, i as questionMessagesIn, n as answerText, o as renderSolution, u as isCorrect, v as questionTexts } from "./render-BJey0bwl.mjs";
-import { _ as verdict, g as schemasById, h as knownProperties, i as addressProblem, m as question_v1_schema_default, s as questionDetails, t as QUESTION_BRANCH, u as questionSchemas } from "./validate-COaZso7u.mjs";
+import { n as renderMaterial } from "./blocks-CxtCPAa5.mjs";
+import { a as inspect, c as renderMarkdown, i as formulaProblems, l as renderWithFormulas, o as plain, r as FORMULA, s as renderInline, u as renderFormula } from "./check-CteIFN96.mjs";
+import { n as checkMaterial } from "./validate-Bxy9NfB8.mjs";
+import { _ as questionIn, a as renderQuestion, b as rightAnswer, i as questionMessagesIn, n as answerText, o as renderSolution, u as isCorrect, v as questionTexts } from "./render-GS1Htlu8.mjs";
+import { _ as verdict, g as schemasById, h as knownProperties, i as addressProblem, m as question_v1_schema_default, s as questionDetails, t as QUESTION_BRANCH, u as questionSchemas } from "./validate-BDwL7Su3.mjs";
 import { t as appName } from "./appname-Bh23cUuz.mjs";
 import { r as languageRoot } from "./pages-9RaaomoO.mjs";
-import { $ as parse, A as answerFor, B as label, D as generate, E as compiled, F as questionFor, G as taskText, I as taskKey, J as tokenize, K as templateProblems, L as answerLabel, M as exampleGiving, O as holds, P as pairValues, Q as evaluate, R as fill, T as StarvedError, W as stepsOf, X as kindOf, Y as unusedVariables, Z as ExpressionError, _ as termId, a as assessments, d as parseRef, et as same, g as isExercise, h as allBlocks, k as values, nt as Fraction, o as drawsTasks, q as templatesIn, s as exerciseOf, t as ASSESSMENT, tt as variables, w as message$1, z as hintOf } from "./assessment-By2GGTJC.mjs";
+import { $ as parse, A as answerFor, B as label, D as generate, E as compiled, F as questionFor, G as taskText, I as taskKey, J as tokenize, K as templateProblems, L as answerLabel, M as exampleGiving, O as holds, P as pairValues, Q as evaluate, R as fill, T as StarvedError, W as stepsOf, X as kindOf, Y as unusedVariables, Z as ExpressionError, _ as termId, a as assessments, d as parseRef, et as same, g as isExercise, h as allBlocks, k as values, nt as Fraction, o as drawsTasks, q as templatesIn, s as exerciseOf, t as ASSESSMENT, tt as variables, w as message$1, z as hintOf } from "./assessment-Dy359O1O.mjs";
 import { a as RESERVED_PARAMS, l as distinctSeeds, o as SEED_TRIES } from "./tasks-DADUYy52.mjs";
 import { a as parse$1, i as nodes, o as readSfc, r as line, s as sfc, t as codeChecker } from "./vue-code-BkJjW_I_.mjs";
-import { a as lineOf, c as schemaProblems, i as isObject, n as Texts, o as pathText, r as get, s as readYaml, t as Problems } from "./content-cYBPYg_J.mjs";
+import { a as lineOf, c as schemaProblems, i as isObject, n as Texts, o as pathText, r as get, s as readYaml, t as Problems } from "./content-DO6oEJxj.mjs";
 import "node:module";
 import { Ajv2020 } from "ajv/dist/2020.js";
 import { existsSync, readFileSync, readdirSync, statSync } from "node:fs";
 import { join } from "node:path";
+import untyped from "speech-rule-engine";
 // \0rolldown/runtime.js
 var __commonJSMin = (cb, mod) => () => (mod || (cb((mod = { exports: {} }).exports, mod, mod.exports), cb = null), mod.exports);
 // runtime/explainer/components/props.ts
@@ -14709,6 +14710,33 @@ function readComponents(root) {
 	};
 }
 /** A problem with a block's props, at a path below props. */
+// runtime/shared/text/speech.ts
+const SRE = untyped;
+const SPEECH = {
+	domain: "clearspeak",
+	modality: "speech"
+};
+for (const locale of LANGUAGES) await SRE.setupEngine({
+	locale,
+	...SPEECH
+});
+/** The formula `tex` as words in `lang` (German for a language the runtime has no texts for), e.g. "2 hoch 7". */
+function speakFormula(tex, lang) {
+	SRE.setupEngine({
+		locale: isLanguage(lang) ? lang : "de",
+		...SPEECH
+	});
+	return SRE.toSpeech(renderFormula(tex, false)).replace(/\s+/g, " ").trim();
+}
+/**
+* The words of a text that is only formulas, $…$ (and space); undefined for any other text, which has words of its own
+* for a name to be made of.
+*/
+function formulaAlternative(text, lang) {
+	const formulas = [...text.matchAll(FORMULA)];
+	if (formulas.length === 0 || text.replace(FORMULA, "").trim() !== "") return void 0;
+	return formulas.map((formula) => speakFormula(formula[1] ?? "", lang)).join(" ");
+}
 // runtime/explainer/exercises.ts
 /** The templates of a generated exercise in each of `languages`; links inside them through `resolve`. */
 function templatesOf(spec, languages, resolve = (href) => href) {
@@ -14795,6 +14823,7 @@ function questionExercise(block, lang, material) {
 		renderQuestion(question, {
 			lang,
 			format: renderWithFormulas,
+			describe: (text) => formulaAlternative(text, lang),
 			...question.material === void 0 ? {} : { materialHtml: renderMaterial(question.material, material) }
 		}),
 		`<details class="explainer-solution"><summary>${plain(questionMessagesIn(lang).solution)}</summary>`,
@@ -16944,4 +16973,4 @@ function loadSite(root, seeds = 200) {
 	if (site === void 0) throw new ContentError(problems);
 	return site;
 }
-export { propertyProblems as _, routes as a, exerciseData as c, templatesOf as d, workedTasks as f, exampleProblems$1 as g, describedProblems as h, hiddenChapter as i, renderExercise as l, TABLE_CONTRACT as m, loadSite as n, terms as o, SIZE_BUDGET as p, contentPages as r, dataOf as s, ContentError as t, taskSeeds as u, propsIn as v };
+export { exampleProblems$1 as _, routes as a, exerciseData as c, templatesOf as d, workedTasks as f, describedProblems as g, TABLE_CONTRACT as h, hiddenChapter as i, renderExercise as l, SIZE_BUDGET as m, loadSite as n, terms as o, formulaAlternative as p, contentPages as r, dataOf as s, ContentError as t, taskSeeds as u, propertyProblems as v, propsIn as y };

package/dist/questions-e2e.mjs

@@ -1 +1 @@
-export { t as answerQuestion, n as expectBackground, r as expectFeedbackInView, i as expectMaterial, a as giveAnswer, o as question } from "./e2e-BiMI-pCL.mjs";
+export { t as answerQuestion, n as expectBackground, r as expectFeedbackInView, i as expectMaterial, a as giveAnswer, o as question } from "./e2e-CU0n_unV.mjs";

package/dist/questions-engine.mjs

@@ -1,3 +1,3 @@
-import { g as questionId } from "./render-BJey0bwl.mjs";
-import { n as startQuestion, t as readAnswer } from "./engine-BqF2Vffn.mjs";
+import { g as questionId } from "./render-GS1Htlu8.mjs";
+import { n as startQuestion, t as readAnswer } from "./engine-CArxqizW.mjs";
 export { questionId, readAnswer, startQuestion };

package/dist/questions.mjs

@@ -1,5 +1,5 @@
-import { C as wrongAnswer, S as shuffled, T as de_default, _ as questionIn, a as renderQuestion, b as rightAnswer, c as hash, d as materialPairs, f as missesRight, g as questionId, h as questionAddresses, i as questionMessagesIn, l as isComplete, m as parseNumber, n as answerText, o as renderSolution, p as mixed, s as QUESTION_TYPES, t as QUESTION_MESSAGES, u as isCorrect, v as questionTexts, w as wrongReasons, x as rightEntries, y as random } from "./render-BJey0bwl.mjs";
-import { c as questionSchema, l as questionSchemaProblems, n as QUESTION_REF, p as validateQuestion, r as QUESTION_SCHEMA_ID, s as questionDetails, u as questionSchemas } from "./validate-COaZso7u.mjs";
+import { C as wrongAnswer, S as shuffled, T as de_default, _ as questionIn, a as renderQuestion, b as rightAnswer, c as hash, d as materialPairs, f as missesRight, g as questionId, h as questionAddresses, i as questionMessagesIn, l as isComplete, m as parseNumber, n as answerText, o as renderSolution, p as mixed, s as QUESTION_TYPES, t as QUESTION_MESSAGES, u as isCorrect, v as questionTexts, w as wrongReasons, x as rightEntries, y as random } from "./render-GS1Htlu8.mjs";
+import { c as questionSchema, l as questionSchemaProblems, n as QUESTION_REF, p as validateQuestion, r as QUESTION_SCHEMA_ID, s as questionDetails, u as questionSchemas } from "./validate-BDwL7Su3.mjs";
 // runtime/shared/questions/index.ts
 /** The texts of a question for learners in German, by their key (messages/de.json); questionMessagesIn(lang) for another. */
 const messages = de_default;

package/dist/{quiz-BKc8JYtC.mjs → quiz-DnW-xtCh.mjs}

@@ -1,5 +1,5 @@
 import { i as inLanguage } from "./html-mffkHGHh.mjs";
-import { _ as questionIn } from "./render-BJey0bwl.mjs";
+import { _ as questionIn } from "./render-GS1Htlu8.mjs";
 // runtime/quiz/messages/de.json
 var de_default = {
 	howto: "Beantworte die Fragen der Reihe nach. Nach jeder Antwort siehst du, ob sie stimmt, und erfährst mehr über jede Antwort. Am Ende siehst du dein Ergebnis.",

package/dist/quiz-e2e.mjs

@@ -1,21 +1,60 @@
-import { C as wrongAnswer, b as rightAnswer, g as questionId } from "./render-BJey0bwl.mjs";
-import { i as expectMaterial, n as expectBackground, o as question, r as expectFeedbackInView, t as answerQuestion } from "./e2e-BiMI-pCL.mjs";
-import { n as quizLanguages, t as quizIn } from "./quiz-BKc8JYtC.mjs";
-import { n as messagesIn, t as QUIZ_MESSAGES } from "./render-DpRO_RKm.mjs";
+import { C as wrongAnswer, b as rightAnswer, g as questionId } from "./render-GS1Htlu8.mjs";
+import { i as expectMaterial, n as expectBackground, o as question, r as expectFeedbackInView, t as answerQuestion } from "./e2e-CU0n_unV.mjs";
+import { n as quizLanguages, t as quizIn } from "./quiz-DnW-xtCh.mjs";
+import { n as messagesIn, t as QUIZ_MESSAGES } from "./render-DqHOJyHK.mjs";
 import { expect, test } from "playwright/test";
 import { readFileSync } from "node:fs";
 // runtime/quiz/e2e.ts
 const de = QUIZ_MESSAGES.de;
 /** The quiz's own texts in `lang`. */
 const messagesOf = messagesIn;
-/** The quiz's tests, for the question bank in `bank` (relative to the app's root). */
+/**
+* The tests of a quiz's content, for the question bank in `bank` (relative to the app's root): what every app runs
+* (e2e/quiz.e2e.ts). Each question's link opens it with what it shows; without JavaScript every question and its
+* solution can be read; each other language has its page. What the runtime does the same in every app is
+* quizRuntimeTests.
+*/
 function quizTests(bank = "src/quiz.json") {
+	quizSuite(bank, "content");
+}
+/**
+* The tests of the quiz's runtime on the question bank in `bank`: the right answer counts and a wrong one does not, with
+* the feedback in view; the seed and the order; a run through every question to the full score; how many questions
+* the learner chooses; what is stored. The template folder and the fixtures of lernapps/app-templates run them
+* (e2e/runtime.e2e.ts); an app does not, its scaffold has no such file: they test the runtime, which is the same in
+* every app, and their time grows with the bank (lernapps/app-templates#125).
+*/
+function quizRuntimeTests(bank = "src/quiz.json") {
+	quizSuite(bank, "runtime");
+}
+function quizSuite(bank, part) {
+	const content = part === "content";
 	const all = JSON.parse(readFileSync(bank, "utf8"));
 	const languages = quizLanguages(all);
 	const quiz = quizIn(all, "de");
 	test.describe("quiz", () => {
 		test.use({ reducedMotion: "reduce" });
-		for (const item of quiz.questions) {
+		if (content) {
+			for (const item of quiz.questions) test(`${item.id} (${item.type}): its link opens it, with what it shows`, async ({ page }) => {
+				await page.goto(`./#${questionId(item)}`);
+				await expect(question(page, item)).toBeVisible();
+				await expect(page.locator(".question:visible")).toHaveCount(1);
+				await expect(question(page, item).locator("legend")).toHaveText(item.text);
+				if (item.material !== void 0) await expectMaterial(page, item);
+			});
+			test.describe("without JavaScript", () => {
+				test.use({ javaScriptEnabled: false });
+				test("every question and its solution can be read", async ({ page }) => {
+					await page.goto("./");
+					for (const item of quiz.questions) {
+						await expect(question(page, item).locator("legend")).toHaveText(item.text);
+						await expectMaterial(page, item, { loaded: false });
+						await expectBackground(page.locator(`#loesung-${item.id}`), item);
+					}
+				});
+			});
+		}
+		if (!content) for (const item of quiz.questions) {
 			test(`${item.id} (${item.type}): its link opens it and the right answer counts`, async ({ page }) => {
 				await page.goto(`./#${questionId(item)}`);
 				await expect(question(page, item)).toBeVisible();
@@ -34,10 +73,6 @@ function quizTests(bank = "src/quiz.json") {
 					await expect(reveal.locator(".question-badge-right").first()).toHaveText(de.rightOption);
 				} else await expect(reveal).toContainText(de.rightAnswer);
 			});
-			if (item.material !== void 0) test(`${item.id} (${item.type}): what it shows is there, and its images load`, async ({ page }) => {
-				await page.goto(`./#${questionId(item)}`);
-				await expectMaterial(page, item);
-			});
 			test(`${item.id} (${item.type}): a wrong answer does not count`, async ({ page }) => {
 				await page.goto(`./#${questionId(item)}`);
 				await answerQuestion(page, item, wrongAnswer(item));
@@ -47,7 +82,7 @@ function quizTests(bank = "src/quiz.json") {
 				if (item.type === "single-choice" || item.type === "multiple-choice") await expect(question(page, item).locator(".question-badge-chosen").first()).toHaveText(de.yourChoice);
 			});
 		}
-		test("the seed in the address gives the order; without one, the address gets one", async ({ page }) => {
+		if (!content) test("the seed in the address gives the order; without one, the address gets one", async ({ page }) => {
 			const everything = `&n=${quiz.questions.length}`;
 			const order = async (address) => {
 				await page.goto(address);
@@ -69,7 +104,7 @@ function quizTests(bank = "src/quiz.json") {
 			await page.goto("./");
 			await expect.poll(() => new URL(page.url()).searchParams.get("seed")).toMatch(/^\d+$/);
 		});
-		test("all right answers give the full score, then the solutions show", async ({ page }) => {
+		if (!content) test("all right answers give the full score, then the solutions show", async ({ page }) => {
 			await page.goto("./");
 			if (quiz.questions.length > 1) await page.locator(".quiz-start button").click();
 			expect(await page.evaluate(() => Object.keys(localStorage))).toEqual([]);
@@ -89,7 +124,7 @@ function quizTests(bank = "src/quiz.json") {
 				expect(stored[0]).toMatch(/^lernapps:.+:last-result$/);
 			} else expect(stored).toEqual([]);
 		});
-		if (quiz.questions.length > 1) test("the learner chooses how many questions to answer; the address keeps the choice", async ({ page }) => {
+		if (!content && quiz.questions.length > 1) test("the learner chooses how many questions to answer; the address keeps the choice", async ({ page }) => {
 			await page.goto("./?seed=11");
 			await expect(page.locator(".quiz-start")).toBeVisible();
 			await expect(page.locator(".question:visible")).toHaveCount(0);
@@ -113,23 +148,12 @@ function quizTests(bank = "src/quiz.json") {
 			await expect(page.locator(".question")).toHaveCount(1);
 			await expect(page.locator(".question")).toHaveAttribute("data-id", item.id);
 		});
-		test.describe("without JavaScript", () => {
-			test.use({ javaScriptEnabled: false });
-			test("every question and its solution can be read", async ({ page }) => {
-				await page.goto("./");
-				for (const item of quiz.questions) {
-					await expect(question(page, item).locator("legend")).toHaveText(item.text);
-					await expectMaterial(page, item, { loaded: false });
-					await expectBackground(page.locator(`#loesung-${item.id}`), item);
-				}
-			});
-		});
 		for (const lang of languages.slice(1)) {
 			const local = quizIn(all, lang);
 			const words = messagesOf(lang);
 			const address = `./${lang}/`;
 			test.describe(`in ${lang}`, () => {
-				test.describe("without JavaScript", () => {
+				if (content) test.describe("without JavaScript", () => {
 					test.use({ javaScriptEnabled: false });
 					test(`the page is in ${lang}, every question and its solution can be read, the switch leads to every language`, async ({ page }) => {
 						await page.goto(address);
@@ -151,14 +175,14 @@ function quizTests(bank = "src/quiz.json") {
 						}
 					});
 				});
-				test(`what a question shows, in ${lang}`, async ({ page }) => {
+				if (content) test(`what a question shows, in ${lang}`, async ({ page }) => {
 					const item = local.questions.find((candidate) => candidate.material !== void 0);
 					test.skip(item === void 0, "no question shows content");
 					if (item === void 0) return;
 					await page.goto(`${address}#${questionId(item)}`);
 					await expectMaterial(page, item);
 				});
-				test(`one question, answered in ${lang}`, async ({ page }) => {
+				if (!content) test(`one question, answered in ${lang}`, async ({ page }) => {
 					const item = local.questions[0];
 					if (item === void 0) throw new Error("the quiz has no questions");
 					await page.goto(`${address}#${questionId(item)}`);
@@ -171,4 +195,4 @@ function quizTests(bank = "src/quiz.json") {
 		}
 	});
 }
-export { answerQuestion, expectBackground, expectFeedbackInView, expectMaterial, quizTests };
+export { answerQuestion, expectBackground, expectFeedbackInView, expectMaterial, quizRuntimeTests, quizTests };

package/dist/quiz-plugin.mjs

@@ -1,12 +1,12 @@
 import { c as textLanguages, o as languageListProblems, r as LANGUAGES, t as escape } from "./html-mffkHGHh.mjs";
 import { r as materialImages } from "./block-BK_ohsH1.mjs";
-import "./blocks-BmRrD7UY.mjs";
-import { a as duplicates, d as readable, f as schemaMessages, o as inQuestion, p as validateQuestion, u as questionSchemas } from "./validate-COaZso7u.mjs";
-import { n as quizLanguages, t as quizIn } from "./quiz-BKc8JYtC.mjs";
+import "./blocks-CxtCPAa5.mjs";
+import { a as duplicates, d as readable, f as schemaMessages, o as inQuestion, p as validateQuestion, u as questionSchemas } from "./validate-BDwL7Su3.mjs";
+import { n as quizLanguages, t as quizIn } from "./quiz-DnW-xtCh.mjs";
 import { t as appName } from "./appname-Bh23cUuz.mjs";
 import { n as isSizeless, t as imageType } from "./image-CspJVfyQ.mjs";
 import { c as withLanguage, i as notFoundPage, n as fromDepth, r as languageRoot } from "./pages-9RaaomoO.mjs";
-import { r as renderQuiz } from "./render-DpRO_RKm.mjs";
+import { r as renderQuiz } from "./render-DqHOJyHK.mjs";
 import { Ajv2020 } from "ajv/dist/2020.js";
 import { existsSync, readFileSync } from "node:fs";
 import { join } from "node:path";