@lernapps/app-templates 0.2.1 → 0.3.0

package/dist/explainer-plugin.mjs

@@ -1,12 +1,12 @@
-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 { _ 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--ovXqbNE.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-CxtCPAa5.mjs";
-import { c as renderMarkdown, l as renderWithFormulas, o as plain, s as renderInline } from "./check-CteIFN96.mjs";
+import { n as renderMaterial } from "./blocks-D4SSGKuL.mjs";
+import { c as renderMarkdown, l as renderWithFormulas, o as plain, s as renderInline } from "./check-BxZOZPic.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-Dy359O1O.mjs";
+import { C as videoLine, G as placeholdersIn, K as plainText, L as questionFor, O as generate, T as message, U as label, W as placeholderValue, _ as mapUrl, a as assessments, et as kindOf, h as allBlocks, m as titleOf, o as drawsTasks, p as stepHint, r as assessmentOf, v as termId, x as renderVideo, y as timelineEvents } from "./assessment-DaKsXUdj.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";
@@ -450,6 +450,7 @@ const WORDS$2 = {
 			"rechnen-anschaulich": "Zeig Zahlen der Seite als Menge, z. B. „37 sind 3 Zehner und 7 Einer“, aber nie das Ergebnis einer Aufgabe. Ein Schritt pro Nachricht, nie Zeitdruck."
 		},
 		contextTitle: "Kontext: die Seite „{page}“",
+		recap: "Diese Seite ist eine Wiederholung: Sie wiederholt etwas, das das Kind schon können sollte, und hat keine Übung. Erklär mit dem Inhalt der Seite und frag nach, ob das Kind ihn verstanden hat. Üben kann es das in anderen Apps; welche das sind, steht hier: {url}",
 		exercise: "Übung",
 		steps: "Lösungsweg",
 		link: "Link",
@@ -502,6 +503,7 @@ const WORDS$2 = {
 			"rechnen-anschaulich": "Show numbers of the page as amounts, e.g. “37 is 3 tens and 7 ones”, but never the result of a task. One step per message, never time pressure."
 		},
 		contextTitle: "Context: the page “{page}”",
+		recap: "This page is a recap: it goes over something the child should already know, and has no exercise. Explain with the content of the page and ask whether the child has understood it. It can practise it in other apps; which ones, it says here: {url}",
 		exercise: "Exercise",
 		steps: "Steps of the solution",
 		link: "Link",
@@ -617,7 +619,7 @@ function generatedLines(spec, site, lang, format, page = "../") {
 	lines.push(`- ${words.linkNumber}: \`${page}?${spec.id}=n&via=tutor#${spec.id}\``);
 	const { paths, answer } = placeholdersOf(spec, lang);
 	const data = dataOf(spec, site.data);
-	const templates = templatesOf(spec, [lang]);
+	const templates = templatesOf(spec, [lang], data);
 	let choices = false;
 	const rows = taskSeeds(spec, data).map((seed, index) => {
 		const task = generate(spec, seed, data);
@@ -797,6 +799,7 @@ function pageMarkdown(site, page, lang, descriptions, exercises, rows, shown) {
 		link: `…/${page.chapter}/${page.id}/?via=tutor#${first.id}`
 	};
 	lines.push(`## ${words.whereTitle}`, "", ...words.where.flatMap((text) => !text.includes("{example}") && !text.includes("{link}") ? [`- ${text}`] : example === void 0 ? [] : [`- ${text.replace("{example}", example.query).replace("{link}", example.link)}`]), "", ...needsLines(lang), `## ${fill(words.contextTitle)}`, "");
+	if (page.recap !== void 0) lines.push(words.recap.replace("{url}", mapUrl(page.recap)), "");
 	if (page.description !== void 0) lines.push(own(page.description), "");
 	lines.push(...contentLines(site, page.blocks, lang, formulas, (heading, _anchor, depth) => `${"#".repeat(Math.min(3 + depth, 6))} ${heading}`));
 	for (const exercise of exercises) {
@@ -1402,10 +1405,11 @@ function pager(context) {
 	};
 	return `<nav class="explainer-pager" aria-label="${plain(context.t("pager"))}">${link("prev", "previous", -1)}${link("next", "next", 1)}</nav>`;
 }
-function pageList(context, pages) {
+function pageList$1(context, pages) {
 	return `<ol class="explainer-pages">${pages.map((page) => {
 		const description = page.description === void 0 ? "" : ` <span class="explainer-description">${context.text(page.description)}</span>`;
-		return `<li><a href="${context.to(`${page.chapter}/${page.id}/`)}">${context.text(page.title)}</a>${description}</li>`;
+		const recap = page.recap === void 0 ? "" : ` <span class="explainer-recap-note">(${plain(context.t("recapNote"))})</span>`;
+		return `<li><a href="${context.to(`${page.chapter}/${page.id}/`)}">${context.text(page.title)}</a>${recap}${description}</li>`;
 	}).join("")}</ol>`;
 }
 function main(context) {
@@ -1413,9 +1417,9 @@ function main(context) {
 	const title = `<h1>${plain(route.title)}</h1>`;
 	switch (route.kind) {
 		case "start": {
-			const contents = hiddenChapter(site) ? pageList(context, site.chapters[0]?.pages ?? []) : `<ol class="explainer-chapters">${site.chapters.map((chapter) => {
+			const contents = hiddenChapter(site) ? pageList$1(context, site.chapters[0]?.pages ?? []) : `<ol class="explainer-chapters">${site.chapters.map((chapter) => {
 				const summary = chapter.summary === void 0 ? "" : context.markdown(chapter.summary);
-				return `<li><a class="explainer-chapter-link" href="${context.to(`${chapter.id}/`)}">${context.text(chapter.title)}</a>${summary}${pageList(context, chapter.pages)}</li>`;
+				return `<li><a class="explainer-chapter-link" href="${context.to(`${chapter.id}/`)}">${context.text(chapter.title)}</a>${summary}${pageList$1(context, chapter.pages)}</li>`;
 			}).join("")}</ol>`;
 			const glossary = terms(site).length === 0 ? "" : `<p><a href="${context.to("glossar/")}">${plain(context.t("glossary"))}</a></p>`;
 			const sources = site.app.sources === void 0 ? "" : `<section class="explainer-sources"><h2>${plain(context.t("sources"))}</h2><p>${plain(context.t("sourcesIntro"))}</p><ul>${site.app.sources.map((source) => {
@@ -1442,7 +1446,7 @@ function main(context) {
 				title,
 				summary,
 				assessment === void 0 ? "" : assessmentOffer(assessmentContext(context), assessment),
-				`<nav class="explainer-contents" aria-label="${plain(context.t("pages"))}">${pageList(context, chapter.pages)}</nav>`
+				`<nav class="explainer-contents" aria-label="${plain(context.t("pages"))}">${pageList$1(context, chapter.pages)}</nav>`
 			].filter((part) => part !== "").join("\n");
 		}
 		case "assessment": return route.assessment === void 0 ? title : assessmentMain(assessmentContext(context), route.assessment);
@@ -1467,12 +1471,29 @@ function main(context) {
 				title,
 				tutorSection(context),
 				`</div>`,
+				page.recap === void 0 ? "" : recapNotice(context, page.recap),
 				pageContents(context, page.blocks),
 				renderBlocks(context, page.blocks, 1)
 			].join("\n");
 		}
 	}
 }
+/**
+* At the top of a recap page: that it is a recap, and the link to the competency's page on the learning map, where the
+* apps are that practise it. The runtime writes it, so that it cannot be missing; a plain link, nothing loaded before
+* a click.
+*/
+function recapNotice(context, recap) {
+	const link = external(mapUrl(recap), context.t("recapLink"));
+	const [before = "", after = ""] = context.t("recapText").split("{link}");
+	const label = plain(context.t("recap"));
+	return [
+		`<aside class="explainer-recap" aria-label="${label}">`,
+		`<p class="explainer-recap-label">${label}</p>`,
+		`<p>${plain(before)}${link}${plain(after)}</p>`,
+		`</aside>`
+	].join("\n");
+}
 /** What a part of a self-assessment needs of the page it is on (assessment-page.ts). */
 const assessmentContext = (context) => ({
 	site: context.site,
@@ -1767,6 +1788,23 @@ function scopeDocument(markdown, title, lang, folder = "") {
 		"</html>"
 	].join("\n");
 }
+// runtime/explainer/page-list.ts
+/** The file's name, at the root of the bundle. */
+const PAGE_LIST = "lernapps-pages.json";
+/** The list of the pages of `site`; undefined for an app of format 1, which has none. */
+function pageList(site) {
+	const { format, strand } = site.app;
+	if (format !== 2 || strand === void 0) return void 0;
+	return {
+		format: 1,
+		strand,
+		pages: contentPages(site).map((page) => ({
+			path: `${page.chapter}/${page.id}/`,
+			title: page.title,
+			...page.recap !== void 0 ? { recap: page.recap } : strand === "none" || page.competencies === void 0 ? {} : { competencies: page.competencies }
+		}))
+	};
+}
 // runtime/explainer/plugin.ts
 // @vitejs/plugin-vue and resolves vue to the copy this runtime depends on, so that the components and the islands
 const MARKER = "<!-- explainer -->";
@@ -1950,7 +1988,7 @@ function explainer() {
 			}
 			if (command !== "build" || content.components.length === 0) return;
 			const rendered = await withServer(root, (loader) => renderComponents(content, loader, true));
-			if (rendered.problems.length > 0) this.error(new ContentError(rendered.problems).message);
+			if (rendered.problems.length > 0) this.error(new ContentError(rendered.problems, content.app.format ?? 1).message);
 			islands = rendered.islands;
 			descriptions = rendered.descriptions;
 			islandsChunk = this.emitFile({
@@ -1985,6 +2023,12 @@ function explainer() {
 				fileName: "404.html",
 				source: notFoundPage()
 			});
+			const list = pageList(content);
+			if (list !== void 0) this.emitFile({
+				type: "asset",
+				fileName: PAGE_LIST,
+				source: `${JSON.stringify(list, null, 2)}\n`
+			});
 			for (const [image, file] of content.images) this.emitFile({
 				type: "asset",
 				fileName: image,
@@ -2055,7 +2099,7 @@ function explainer() {
 				const size = gzipSync(own).length;
 				if (size > 2e4) problems.push(`${component.file}: ${(size / 1e3).toFixed(1)} kB gzip of its own code, more than the budget of ${SIZE_BUDGET / 1e3} kB; split it into smaller components, or ask for a built-in block (vue-component-size)`);
 			}
-			if (problems.length > 0) this.error(new ContentError(problems).message);
+			if (problems.length > 0) this.error(new ContentError(problems, content.app.format ?? 1).message);
 		},
 		configureServer(server) {
 			devServer = server;
@@ -2091,7 +2135,7 @@ function explainer() {
 				const dev = devServer;
 				if (dev === void 0) return next();
 				renderComponents(content, (id) => dev.ssrLoadModule(id), false).then(({ islands: rendered, descriptions: described, problems }) => {
-					if (problems.length > 0) throw new ContentError(problems);
+					if (problems.length > 0) throw new ContentError(problems, content.app.format ?? 1);
 					if (forScope) {
 						const markdown = path.endsWith(TUTOR_MARKDOWN);
 						const lang = content.app.languages.find((one) => languageRoot(one) !== "" && path.startsWith(languageRoot(one))) ?? content.app.languages[0] ?? "de";

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-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 { F as mistakeOf, H as hintOf, J as taskText, L as questionFor, N as diagnose, O as generate, S as startVideos, T as message, c as isStoredResult, f as resultQuery, i as assessmentPrompt, l as linkLines, n as BAND_MESSAGES, q as stepsOf, u as pageResults } from "./assessment-DaKsXUdj.mjs";
+import { i as sessionLines, n as answerShown, r as resultLine, t as Progress } from "./result-DphIWHDF.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-D5kwkNt1.mjs";
+import { i as message, o as loadInteractive, t as APP_PAGE } from "./render-D3LsJY04.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-DO6oEJxj.mjs";
+import { o as pathText, t as Problems } from "./content-CAL0Nz1a.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-D5kwkNt1.mjs";
+import { a as InteractiveError, n as pages, o as loadInteractive, r as renderPage } from "./render-D3LsJY04.mjs";
 import { existsSync, readFileSync, readdirSync, statSync } from "node:fs";
 import { join } from "node:path";
 import vue from "@vitejs/plugin-vue";