@lernapps/app-templates 0.1.0 → 0.2.0

package/dist/quiz.mjs

@@ -1,6 +1,6 @@
-import { S as shuffled, g as questionId, u as isCorrect } from "./render-BJey0bwl.mjs";
-import { n as startQuestion } from "./engine-BqF2Vffn.mjs";
-import { a as de_default, i as en_default, r as solutionId } from "./quiz-BKc8JYtC.mjs";
+import { S as shuffled, g as questionId, u as isCorrect } from "./render-GS1Htlu8.mjs";
+import { n as startQuestion } from "./engine-CArxqizW.mjs";
+import { a as de_default, i as en_default, r as solutionId } from "./quiz-DnW-xtCh.mjs";
 import { translator } from "@lernapps/tooling/i18n";
 import { announce, moveFocus } from "@lernapps/tooling/a11y";
 import { createStorage } from "@lernapps/tooling/storage";

package/dist/{render-BL6fV_NI.mjs → render-D5kwkNt1.mjs}

@@ -1,7 +1,7 @@
 import { i as inLanguage, l as textsIn, o as languageListProblems, r as LANGUAGES } from "./html-mffkHGHh.mjs";
-import { a as plain, s as renderMarkdown } from "./check-BkEl-m-F.mjs";
+import { c as renderMarkdown, o as plain } from "./check-CteIFN96.mjs";
 import { a as pageFooter, o as pageHeader, r as languageRoot, s as relative, t as alternateLinks } from "./pages-9RaaomoO.mjs";
-import { c as schemaProblems, n as Texts, s as readYaml, t as Problems } from "./content-cYBPYg_J.mjs";
+import { c as schemaProblems, n as Texts, s as readYaml, t as Problems } from "./content-DO6oEJxj.mjs";
 import { Ajv2020 } from "ajv/dist/2020.js";
 import { existsSync, readdirSync } from "node:fs";
 import { join } from "node:path";

package/dist/{render-DpRO_RKm.mjs → render-DqHOJyHK.mjs}

@@ -1,7 +1,7 @@
 import { l as textsIn, s as localeOf, t as escape } from "./html-mffkHGHh.mjs";
-import { n as renderMaterial } from "./blocks-BmRrD7UY.mjs";
-import { a as renderQuestion, g as questionId, o as renderSolution, r as external, t as QUESTION_MESSAGES } from "./render-BJey0bwl.mjs";
-import { a as de_default, i as en_default, r as solutionId } from "./quiz-BKc8JYtC.mjs";
+import { n as renderMaterial } from "./blocks-CxtCPAa5.mjs";
+import { a as renderQuestion, g as questionId, o as renderSolution, r as external, t as QUESTION_MESSAGES } from "./render-GS1Htlu8.mjs";
+import { a as de_default, i as en_default, r as solutionId } from "./quiz-DnW-xtCh.mjs";
 import { a as pageFooter, o as pageHeader, r as languageRoot, s as relative, t as alternateLinks } from "./pages-9RaaomoO.mjs";
 import { translator } from "@lernapps/tooling/i18n";
 // runtime/quiz/render.ts

package/dist/{render-BJey0bwl.mjs → render-GS1Htlu8.mjs}

@@ -199,6 +199,7 @@ function questionIn(question, lang) {
 				text: t(option.text),
 				correct: option.correct,
 				info: t(option.info),
+				...option.alt === void 0 ? {} : { alt: t(option.alt) },
 				...option.link === void 0 ? {} : { link: link(option.link) }
 			}))
 		};
@@ -415,13 +416,17 @@ function questionWords(lang = "de") {
 	}
 	return found;
 }
-function controls(question, { t }, format) {
+function controls(question, { t }, format, describe) {
 	const name = questionId(question);
 	switch (question.type) {
 		case "single-choice":
 		case "multiple-choice": {
 			const type = question.type === "single-choice" ? "radio" : "checkbox";
-			return question.options.map((option, index) => `<label class="question-option"><input type="${type}" name="${name}" value="${index}"> <span>${format(option.text)}</span></label>`).join("\n");
+			return question.options.map((option, index) => {
+				const spoken = option.alt ?? describe?.(option.text);
+				const label = spoken === void 0 ? "" : ` aria-label="${escape(spoken)}"`;
+				return `<label class="question-option"><input type="${type}" name="${name}" value="${index}"${label}> <span>${format(option.text)}</span></label>`;
+			}).join("\n");
 		}
 		case "true-false": return [true, false].map((value) => `<label class="question-option"><input type="radio" name="${name}" value="${value}"> <span>${t(value ? "true" : "false")}</span></label>`).join("\n");
 		case "number": return [
@@ -456,7 +461,7 @@ function controls(question, { t }, format) {
 * what the learner learns about it (the same as its solution). The engine's startQuestion makes it live; without
 * JavaScript the button stays hidden.
 */
-function renderQuestion(question, { element = "div", next = false, lang = "de", textHtml, materialHtml, explanationHtml, format = escape } = {}) {
+function renderQuestion(question, { element = "div", next = false, lang = "de", textHtml, materialHtml, explanationHtml, format = escape, describe } = {}) {
 	const words = questionWords(lang);
 	const { t } = words;
 	const id = questionId(question);
@@ -467,7 +472,7 @@ function renderQuestion(question, { element = "div", next = false, lang = "de",
 		`<fieldset>`,
 		`<legend class="question-text">${textHtml ?? format(question.text)}</legend>`,
 		...materialHtml === void 0 || materialHtml === "" ? [] : [`<div class="question-material">${materialHtml}</div>`],
-		controls(question, words, format),
+		controls(question, words, format, describe),
 		`</fieldset>`,
 		`<div class="question-feedback" role="status"></div>`,
 		`<div class="question-reveal" hidden>`,

package/dist/{result-_eQcamoz.mjs → result-D_mmCVwN.mjs}

@@ -1,5 +1,5 @@
-import { x as rightEntries } from "./render-BJey0bwl.mjs";
-import { w as message } from "./assessment-By2GGTJC.mjs";
+import { x as rightEntries } from "./render-GS1Htlu8.mjs";
+import { w as message } from "./assessment-Dy359O1O.mjs";
 // runtime/explainer/result.ts
 const key = (id, n) => n === void 0 ? id : `${id}=${n}`;
 /**

package/dist/{validate-COaZso7u.mjs → validate-BDwL7Su3.mjs}

@@ -1,6 +1,6 @@
 import { c as textLanguages } from "./html-mffkHGHh.mjs";
-import { n as checkMaterial, t as MATERIAL_DEFINITIONS } from "./validate-CxtdeQ5S.mjs";
-import { _ as questionIn, h as questionAddresses, l as isComplete, m as parseNumber, u as isCorrect, v as questionTexts, x as rightEntries } from "./render-BJey0bwl.mjs";
+import { n as checkMaterial, t as MATERIAL_DEFINITIONS } from "./validate-Bxy9NfB8.mjs";
+import { _ as questionIn, h as questionAddresses, l as isComplete, m as parseNumber, u as isCorrect, v as questionTexts, x as rightEntries } from "./render-GS1Htlu8.mjs";
 import { Ajv2020 } from "ajv/dist/2020.js";
 // runtime/shared/examples.ts
 /**
@@ -591,6 +591,10 @@ var question_v1_schema_default = {
 							"description": "One to three sentences of background on this option itself, true whether or not it is the right answer, e.g. \"Der Uluru ist ein Inselberg in der Wüste Zentralaustraliens ...\". After an answer it shows for every option. For a wrong option it is also the reason a learner who chose it reads with the feedback, so say there why it does not fit.",
 							"$ref": "urn:lernapps:schema:text.v1#/$defs/text"
 						},
+						"alt": {
+							"description": "Optional: the option as it is spoken, for the name of its radio button or checkbox, when its text is only a formula, e.g. \"zwei hoch sieben\" for \"$2^7$\". Without it the name is made from the formula in the page's language (\"2 hoch 7\"); write it where that reads badly, e.g. for a chemical formula. Not needed when the text has words.",
+							"$ref": "urn:lernapps:schema:text.v1#/$defs/text"
+						},
 						"link": {
 							"description": "Further reading on this option.",
 							"$ref": "#/$defs/link"

package/dist/{validate-CxtdeQ5S.mjs → validate-Bxy9NfB8.mjs}

@@ -1,6 +1,6 @@
 import { i as inLanguage } from "./html-mffkHGHh.mjs";
 import { n as markerOf } from "./block-BK_ohsH1.mjs";
-import { t as checkText } from "./check-BkEl-m-F.mjs";
+import { t as checkText } from "./check-CteIFN96.mjs";
 // runtime/shared/blocks/validate.ts
 /** The definition of each type of block in the schema of the blocks (blocks.v1.schema.json). */
 const MATERIAL_DEFINITIONS = {

package/docs/arc42/09-decisions.arc42.md

@@ -228,6 +228,30 @@ addresses: qg-understandable
 :::
 ```
 
+## A New App Gets the Scaffold, Not the Example
+
+`lernapps create` copies only the scaffold of the archetype into a new app: the paths that `lernapps.scaffold.<archetype>`
+in this package's `package.json` lists (the entry, the configuration, the e2e entry) and a placeholder as start content
+(`scaffold/<archetype>/`: one question, one page with one exercise, or a counter as the core). The template folder
+stays a complete example app, which this repo checks; an app does not copy it, the creator's assistant looks it up in
+`node_modules/@lernapps/app-templates/<archetype>/`. A copied example shaped the new app too much: its structure,
+its topic and its tone stayed long after the plan said otherwise. The list is data in this package, which alone knows
+what is configuration and what is example; the tooling only reads it. The CI job `scaffold` checks the scaffold as an
+app, so that a new app passes `lernapps check` from its first commit. `lernapps update` never writes the scaffold
+again: it moves libraries, not content. Rejected: a function `scaffold()` exported by the package, which would need the
+built package even in a clone given to `create --templates`; start content inside the template folder, which the
+template's own checks would read as part of the example.
+
+```arc42
+:::decision
+id: dec-scaffold
+title: A new app gets the scaffold and a placeholder, not the example app
+status: accepted
+date: 2026-11-02
+addresses: qg-understandable
+:::
+```
+
 ## Tutor Variant
 
 The optional tutor is a handoff to the learner's own assistant: after a click, a prompt (copied or passed to a chosen

package/explainer/docs/arc42/05-explainer-building-blocks.arc42.md

@@ -488,8 +488,12 @@ path: runtime/explainer/assessment.ts
 
 ### End-to-end tests
 
-Built. `explainerTests()` derives from the content what every page must show, checks it without JavaScript in every
-language, and with JavaScript one exercise per type and page and every component.
+Built, in two parts. `explainerTests()` checks the app's content: it derives from the content what every page must
+show and checks it without JavaScript in every language, previous and next, and with JavaScript the app's own
+components and the checks of its exercise components. `explainerRuntimeTests()` checks the runtime, the same in every
+app: one exercise per type and page, the videos, the tutor ways, the start page, the self-assessments, what is stored.
+Only this repo runs the second part, on the template and its fixtures (`explainer/e2e/runtime.e2e.ts`, not in the
+scaffold).
 
 ```arc42
 :::building-block
@@ -504,7 +508,7 @@ requires: if-archetype-content, if-runtime-texts, if-questions
 
 #### Tests interface
 
-The app's `e2e/explainer.e2e.ts` only calls `explainerTests()`.
+The app's `e2e/explainer.e2e.ts`, part of the scaffold, only calls `explainerTests()`.
 
 ```arc42
 :::interface

package/explainer/e2e/runtime.e2e.ts

@@ -0,0 +1,6 @@
+import { explainerRuntimeTests } from "@lernapps/app-templates/explainer/e2e";
+
+// The tests of the explainer runtime, which this repo runs on the template and its fixtures. Not part of the scaffold
+// (lernapps.scaffold in the package.json of @lernapps/app-templates): a new app runs only explainerTests(), on its
+// content.
+explainerRuntimeTests();

package/explainer/package.json

@@ -9,10 +9,11 @@
   },
   "devDependencies": {
     "@lernapps/app-templates": "file:..",
-    "@lernapps/tooling": "github:lernapps/tooling#7354ffe7ae7d8079ba5f714d5b402666d27df066",
+    "@lernapps/tooling": "^0.1.2",
     "vite-plus": "1.4.0"
   },
   "overrides": {
+    "@lernapps/app-templates": "file:..",
     "vite": "npm:@voidzero-dev/vite-plus-core@1.4.0"
   }
 }

package/interactive/package.json

@@ -9,10 +9,11 @@
   },
   "devDependencies": {
     "@lernapps/app-templates": "file:..",
-    "@lernapps/tooling": "github:lernapps/tooling#7354ffe7ae7d8079ba5f714d5b402666d27df066",
+    "@lernapps/tooling": "^0.1.2",
     "vite-plus": "1.4.0"
   },
   "overrides": {
+    "@lernapps/app-templates": "file:..",
     "vite": "npm:@voidzero-dev/vite-plus-core@1.4.0"
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lernapps/app-templates",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "The templates of the archetypes of lernapps.net apps, and the runtime of each archetype that apps depend on (the quiz: engine, build step, styles, end-to-end tests, the schema of the question bank, the questions it shares with the explainer are in ./questions; the explainer: build step, client module with its exercises, the islands of its Vue components, styles, end-to-end tests, the schema of its content; the interactive archetype: build step, the start page and the app page around the app's own Vue components and core, its playthroughs, styles, end-to-end tests, the schemas of its start page and its playthroughs)",
   "license": "MIT",
   "repository": {
@@ -14,6 +14,7 @@
     "explainer",
     "interactive",
     "quiz",
+    "scaffold",
     "!**/package-lock.json",
     "!**/node_modules"
   ],
@@ -100,6 +101,7 @@
     "highlight.js": "11.12.0",
     "marked": "18.1.2",
     "source-map-js": "1.2.2",
+    "speech-rule-engine": "4.1.5",
     "temml": "0.14.0",
     "vue": "3.5.44",
     "yaml": "2.9.1"
@@ -141,6 +143,40 @@
       "explainer",
       "interactive",
       "quiz"
-    ]
+    ],
+    "scaffold": {
+      "explainer": [
+        ".gitignore",
+        "index.html",
+        "package.json",
+        "tsconfig.json",
+        "vite.config.ts",
+        "playwright.config.ts",
+        "src/main.ts",
+        "e2e/explainer.e2e.ts"
+      ],
+      "interactive": [
+        ".arc42ignore",
+        ".gitignore",
+        "index.html",
+        "package.json",
+        "tsconfig.json",
+        "vite.config.ts",
+        "playwright.config.ts",
+        "src/main.ts",
+        "src/env.d.ts",
+        "e2e/interactive.e2e.ts"
+      ],
+      "quiz": [
+        ".gitignore",
+        "index.html",
+        "package.json",
+        "tsconfig.json",
+        "vite.config.ts",
+        "playwright.config.ts",
+        "src/main.ts",
+        "e2e/quiz.e2e.ts"
+      ]
+    }
   }
 }

package/quiz/docs/arc42/05-quiz-building-blocks.arc42.md

@@ -196,8 +196,12 @@ path: runtime/quiz/engine.ts
 
 ### End-to-end tests
 
-Built. `quizTests()` checks every question of the bank in the browser (deep link, right and wrong answer, feedback in
-view with the focus), the full score, the page without JavaScript, and each further language.
+Built, in two parts. `quizTests()` checks the app's content: each question's deep link with what it shows, the page
+without JavaScript with every question and its solution, and each further language. `quizRuntimeTests()` checks the
+runtime, the same in every app: right and wrong answer with the feedback in view and the focus, the seed and the order,
+the run to the full score, the number of questions, what is stored. Only this repo runs the second part, on the
+template and its fixtures (`quiz/e2e/runtime.e2e.ts`, not in the scaffold): its time grows with the bank, and it tests
+nothing an app writes.
 
 ```arc42
 :::building-block
@@ -212,7 +216,7 @@ requires: if-archetype-content, if-runtime-texts
 
 #### Tests interface
 
-The app's `e2e/quiz.e2e.ts` only calls `quizTests()`.
+The app's `e2e/quiz.e2e.ts`, part of the scaffold, only calls `quizTests()`.
 
 ```arc42
 :::interface

package/quiz/e2e/runtime.e2e.ts

@@ -0,0 +1,5 @@
+import { quizRuntimeTests } from "@lernapps/app-templates/quiz/e2e";
+
+// The tests of the quiz runtime, which this repo runs on the template and its fixtures. Not part of the scaffold
+// (lernapps.scaffold in the package.json of @lernapps/app-templates): a new app runs only quizTests(), on its content.
+quizRuntimeTests();

package/quiz/package.json

@@ -9,10 +9,11 @@
   },
   "devDependencies": {
     "@lernapps/app-templates": "file:..",
-    "@lernapps/tooling": "github:lernapps/tooling#7354ffe7ae7d8079ba5f714d5b402666d27df066",
+    "@lernapps/tooling": "^0.1.2",
     "vite-plus": "1.4.0"
   },
   "overrides": {
+    "@lernapps/app-templates": "file:..",
     "vite": "npm:@voidzero-dev/vite-plus-core@1.4.0"
   }
 }

package/runtime/explainer/assessment-page.ts

@@ -12,6 +12,7 @@
 import { renderQuestion } from "../shared/questions/render.ts";
 import { type MaterialContext, renderMaterial } from "../shared/blocks/index.ts";
 import { plain, renderWithFormulas } from "../shared/text/markdown.ts";
+import { formulaAlternative } from "../shared/text/speech.ts";
 import {
   assessments,
   drawsTasks,
@@ -117,6 +118,7 @@ function itemHtml(context: AssessmentContext, data: AssessmentItemData, n: numbe
   return `${label}${renderQuestion(question, {
     lang,
     format: (text) => rendered[text] ?? renderWithFormulas(text),
+    describe: (text) => formulaAlternative(text, lang),
     ...(question.material === undefined ? {} : { materialHtml: renderMaterial(question.material, context.material) }),
   })}`;
 }