@segnavia/html 0.26.0 → 0.28.0

package/dist/base64.d.ts

@@ -0,0 +1,4 @@
+//#region src/base64.d.ts
+export declare function bytesToBase64(data: Uint8Array): string;
+export declare function base64ToBytes(value: string): Uint8Array | undefined;
+//#endregion

package/dist/base64.js

@@ -0,0 +1,51 @@
+//#region src/base64.ts
+const TABLE = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/";
+function triplet(data, index, count) {
+	let value = 0;
+	for (let offset = 0; offset < 3; offset += 1) {
+		const byte = offset < count ? data[index + offset] : 0;
+		value = value << 8 | (byte ?? 0);
+	}
+	return value;
+}
+function encodeTriplet(value, chars) {
+	const shifts = [
+		18,
+		12,
+		6,
+		0
+	];
+	let out = "";
+	for (let i = 0; i < 4; i += 1) {
+		const shift = shifts[i] ?? 0;
+		out += i < chars ? TABLE[value >> shift & 63] ?? "" : "=";
+	}
+	return out;
+}
+function bytesToBase64(data) {
+	let out = "";
+	const full = Math.floor(data.length / 3) * 3;
+	for (let i = 0; i < full; i += 3) out += encodeTriplet(triplet(data, i, 3), 4);
+	const rest = data.length - full;
+	if (rest > 0) out += encodeTriplet(triplet(data, full, rest), rest + 1);
+	return out;
+}
+function base64ToBytes(value) {
+	if (value.length % 4 !== 0 || !/^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$/.test(value)) return;
+	const padding = value.endsWith("==") ? 2 : value.endsWith("=") ? 1 : 0;
+	const bytes = new Uint8Array(value.length / 4 * 3 - padding);
+	let output = 0;
+	for (let index = 0; index < value.length; index += 4) {
+		const a = TABLE.indexOf(value[index] ?? "");
+		const b = TABLE.indexOf(value[index + 1] ?? "");
+		const c = value[index + 2] === "=" ? 0 : TABLE.indexOf(value[index + 2] ?? "");
+		const d = value[index + 3] === "=" ? 0 : TABLE.indexOf(value[index + 3] ?? "");
+		const triplet = a << 18 | b << 12 | c << 6 | d;
+		if (output < bytes.length) bytes[output++] = triplet >> 16 & 255;
+		if (output < bytes.length) bytes[output++] = triplet >> 8 & 255;
+		if (output < bytes.length) bytes[output++] = triplet & 255;
+	}
+	return bytes;
+}
+//#endregion
+export { base64ToBytes, bytesToBase64 };

package/dist/bindings.d.ts

@@ -1,12 +1,15 @@
 import { SanitizeOptions } from "./sanitize.js";
 //#region src/bindings.d.ts
 export declare const BINDINGS: readonly ["value", "href", "src", "each", "when", "present", "width"];
+export declare function bindingRoot(path: string): string;
 export declare function bindingNames(prefix: string): Record<(typeof BINDINGS)[number], string>;
-export interface FillOptions extends Pick<SanitizeOptions, 'linkOrigins'> {
+export interface FillOptions extends Pick<SanitizeOptions, 'linkOrigins' | 'dataFonts'> {
   prefix: string;
   data: Record<string, unknown>;
   unavailable?: Iterable<string>;
   preserveUnavailable?: boolean;
+  registerHrefOrigins?: boolean;
+  deferPaths?: Iterable<string>;
 }
 export interface Filled {
   html: string;

package/dist/bindings.js

@@ -10,6 +10,9 @@ const BINDINGS = [
 	"present",
 	"width"
 ];
+function bindingRoot(path) {
+	return path.replace(/^(?:\.\.\/)+/, "").split(".")[0] ?? "";
+}
 function bindingNames(prefix) {
 	return Object.fromEntries(BINDINGS.map((binding) => [binding, `data-${prefix}-${binding}`]));
 }
@@ -57,6 +60,13 @@ function safeHref(value, origins) {
 		return false;
 	}
 }
+function registerHrefOrigin(origins, attribute, value, register) {
+	if (attribute !== "href" || !register || typeof value !== "string") return;
+	try {
+		const url = new URL(value);
+		if (url.protocol === "https:") origins.add(url.origin);
+	} catch {}
+}
 function hasBindings(html, prefix) {
 	const names = new Set(Object.values(bindingNames(prefix)));
 	return elements(parse(html).children).some((element) => Object.keys(element.attribs).some((name) => names.has(name)));
@@ -66,7 +76,11 @@ function fill(html, options) {
 	const origins = new Set([...options.linkOrigins ?? []].map((origin) => new URL(origin).origin));
 	const unavailable = new Set(options.unavailable ?? []);
 	const values = [];
-	const document = parse(sanitize(html, { linkOrigins: options.linkOrigins }));
+	const deferred = new Set(options.deferPaths ?? []);
+	const document = parse(sanitize(html, {
+		linkOrigins: options.linkOrigins,
+		dataFonts: options.dataFonts
+	}));
 	const resolve = (path, stack) => {
 		const { context, rest } = contextAt(stack, path);
 		const value = atPath(context, rest);
@@ -75,6 +89,8 @@ function fill(html, options) {
 	};
 	const take = (element, name) => {
 		const value = element.attribs[name];
+		const root = value === void 0 ? void 0 : bindingRoot(value);
+		if (root && deferred.has(root)) return void 0;
 		delete element.attribs[name];
 		return value;
 	};
@@ -113,6 +129,7 @@ function fill(html, options) {
 			if (path === void 0) continue;
 			const value = resolve(path, stack);
 			if (preserves(value)) continue;
+			registerHrefOrigin(origins, attribute, value, options.registerHrefOrigins);
 			if (typeof value === "string" && (attribute === "href" ? safeHref(value, origins) : /^data:image\//i.test(value))) element.attribs[attribute] = value;
 			else {
 				delete element.attribs[attribute];
@@ -155,4 +172,4 @@ function fill(html, options) {
 	};
 }
 //#endregion
-export { BINDINGS, bindingNames, fill, hasBindings };
+export { BINDINGS, bindingNames, bindingRoot, fill, hasBindings };

package/dist/book/book-document.js

@@ -1,34 +1,34 @@
 import { elements, parse, serialize } from "../sanitize.js";
-import { element, linkChildren, text, textContent } from "./dom.js";
-import { noteState, transformNotes } from "./notes.js";
+import { element, linkChildren, text } from "./dom.js";
+import { collectHeadings, designedSection, flowAttribs, markPlacementIssues, sectionNode, templateHolders, templateRegionNameIssues, templatedSection, undeclaredRegionIssues } from "./book-held.js";
+import { endnotesInOrder, noteState, transformNotes } from "./notes.js";
 import { bookPrintPart } from "./types.js";
 import { isTag } from "domhandler";
-import { isBookContents, noteMarkerIssues, resolveDirection } from "@segnavia/format";
+import { isBookContents, isDesignedSection, isTemplatedSection, noteMarkerIssues, resolveDirection } from "@segnavia/format";
 //#region src/book/book-document.ts
-const PRINT_CSS = ":where(.segnavia-contents-list){list-style:none;padding:0;margin:0}:where(.segnavia-contents-entry){display:flex}:where(.segnavia-contents-page){margin-inline-start:auto}:where(.segnavia-contents-entry[data-level=\"2\"]){padding-inline-start:1em}:where(.segnavia-contents-entry[data-level=\"3\"]){padding-inline-start:2em}:where(.segnavia-contents-entry[data-level=\"4\"]){padding-inline-start:3em}:where(.segnavia-contents-entry[data-level=\"5\"]){padding-inline-start:4em}:where(.segnavia-contents-entry[data-level=\"6\"]){padding-inline-start:5em}@media print{:where(.segnavia-front,.segnavia-contents)~:where(.segnavia-front,.segnavia-contents),:where(.segnavia-chapter,.segnavia-endnotes,.segnavia-blank){break-before:page}:where(.segnavia-blank){break-after:page}:where(.segnavia-targets){position:absolute;inline-size:1px;block-size:1px;overflow:hidden;clip-path:inset(50%)}}";
+const CONTENTS_CSS = ":where(.segnavia-contents-list){list-style:none;padding:0;margin:0}:where(.segnavia-contents-entry){display:flex}:where(.segnavia-contents-page){margin-inline-start:auto}:where(.segnavia-contents-entry[data-level=\"2\"]){padding-inline-start:1em}:where(.segnavia-contents-entry[data-level=\"3\"]){padding-inline-start:2em}:where(.segnavia-contents-entry[data-level=\"4\"]){padding-inline-start:3em}:where(.segnavia-contents-entry[data-level=\"5\"]){padding-inline-start:4em}:where(.segnavia-contents-entry[data-level=\"6\"]){padding-inline-start:5em}";
+const PRINT_CSS = `${CONTENTS_CSS}@media print{:where(.segnavia-front,.segnavia-contents)~:where(.segnavia-front,.segnavia-contents),:where(.segnavia-chapter,.segnavia-endnotes,.segnavia-blank){break-before:page}:where(.segnavia-blank){break-after:page}:where(.segnavia-targets){position:absolute;inline-size:1px;block-size:1px;overflow:hidden;clip-path:inset(50%)}}`;
+const GALLEY_CSS = `${CONTENTS_CSS}:where([data-segnavia-galleys]){position:relative}:where([data-segnavia-flow]){orphans:inherit;widows:inherit}:where([data-segnavia-kind="fixed"],[data-segnavia-kind="templated"],[data-segnavia-template]){display:none}:where([data-segnavia-notes-galley]){border-block-start:1px solid;padding-block-start:8px}:where([data-segnavia-note]){break-inside:avoid}:where([data-segnavia-galleys] img,[data-segnavia-window] img,[data-segnavia-page-note] img){display:block;max-block-size:var(--segnavia-text-height);max-inline-size:100%;block-size:auto;inline-size:auto}`;
 function direction(book, value) {
 	return resolveDirection(book.dir, book.lang, value);
 }
-function sectionNode(kind, id, children = []) {
-	return element("section", {
-		class: `segnavia-section segnavia-${kind}`,
-		id
-	}, children);
-}
-function authoredSection(section, id) {
-	const node = sectionNode("front", id, parse(section.html).children);
+function authoredSection(section, id, galley = false) {
+	const document = parse(section.html);
+	const runningHead = section.title;
+	const node = sectionNode("front", id, document.children, galley, runningHead, flowAttribs(section.opens, section.parents));
 	return {
 		info: {
 			id,
 			kind: "front",
 			title: section.title,
-			runningHead: section.title
+			runningHead
 		},
 		node
 	};
 }
-function contentsSection(title) {
+function contentsSection(entry, galley = false) {
 	const id = "segnavia-contents";
+	const title = entry.title;
 	const children = title !== void 0 ? [element("h1", {
 		class: "segnavia-contents-title",
 		dir: "ltr"
@@ -40,39 +40,39 @@ function contentsSection(title) {
 			title,
 			runningHead: title
 		},
-		node: sectionNode("contents", id, children)
+		node: sectionNode("contents", id, children, galley, title, flowAttribs(entry.opens, entry.parents))
 	};
 }
-function chapterSection(chapter, index) {
+function chapterSection(chapter, index, galley = false) {
 	const id = `segnavia-chapter-${index}`;
 	const document = parse(chapter.html);
+	const runningHead = chapter.runningHead ?? chapter.title;
 	return {
 		info: {
 			id,
 			kind: "chapter",
 			title: chapter.title,
-			runningHead: chapter.runningHead ?? chapter.title
+			runningHead
 		},
-		node: sectionNode("chapter", id, document.children)
+		node: sectionNode("chapter", id, document.children, galley, runningHead, flowAttribs(chapter.opens, chapter.parents))
 	};
 }
+function appendHeld(built, heldHeadings, extraIssues, book, notes, galley, sections, headings, issues, notesOwner = 0) {
+	sections.push(built);
+	issues.push(...reservedIdIssues(built), ...columnIssues(built), ...extraIssues);
+	headings.push(...heldHeadings);
+	transformNotes(built.node, book, 0, notes, galley, notesOwner);
+}
+function appendDesigned(entry, id, kind, book, galley, notes, sections, headings, issues, notesOwner = 0) {
+	const held = designedSection(entry, id, kind, galley, book.contents.depth);
+	appendHeld(held.built, held.headings, [], book, notes, galley, sections, headings, issues, notesOwner);
+}
+function appendTemplated(entry, id, kind, book, galley, notes, templates, sections, headings, issues, notesOwner = 0) {
+	const held = templatedSection(entry, id, kind, galley, book.contents.depth);
+	appendHeld(held.built, held.headings, undeclaredRegionIssues(entry, id, templates), book, notes, galley, sections, headings, issues, notesOwner);
+}
 function chapterHeadings(section, chapter, depth) {
-	let generated = 0;
-	return elements(section.node.children).flatMap((heading) => {
-		const match = /^h([2-6])$/.exec(heading.name);
-		if (!match || heading.attribs["data-contents"] === "exclude") return [];
-		const level = Number(match[1]);
-		if (level > depth) return [];
-		generated += 1;
-		const id = heading.attribs.id ?? `segnavia-h-${chapter}-${generated}`;
-		heading.attribs.id = id;
-		return [{
-			id,
-			level,
-			text: textContent(heading, true).replace(/\s+/g, " ").trim(),
-			sectionId: section.info.id
-		}];
-	});
+	return collectHeadings(section.node.children, section.info.id, depth, 2, (n) => `segnavia-h-${chapter}-${n}`, { n: 0 });
 }
 function contentsList(book, headings, options) {
 	const entries = headings.map((heading) => {
@@ -125,23 +125,44 @@ function reservedIdIssues(section) {
 		return [`authored id ${id} in ${section.info.title ?? section.info.id} (${section.info.id}) uses the reserved segnavia- prefix`];
 	});
 }
-function endnotesSection(book, paragraphs) {
-	const id = "segnavia-endnotes";
+function columnsValueOk(value) {
+	if (!/^[0-9]+$/.test(value)) return false;
+	const count = Number(value);
+	return count >= 2 && count <= 4;
+}
+function columnIssues(section) {
+	const where = `${section.info.title ?? section.info.id} (${section.info.id})`;
+	return elements(section.node.children).flatMap((node) => {
+		const value = node.attribs["data-columns"];
+		if (value === void 0 || columnsValueOk(value)) return [];
+		return [`The ${node.name} in ${where} could not establish data-columns ${JSON.stringify(value)}; set it to an integer from 2 to 4 to clear this`];
+	});
+}
+function endnotesHeading(book) {
 	const titleValue = book.endnotes.title;
-	const titleNode = element("h1", {
+	return element("h1", {
 		class: "segnavia-endnotes-title",
 		dir: direction(book, titleValue)
 	}, [text(titleValue)]);
+}
+function endnotesSection(book, paragraphs, galley, id, runningHead, opens) {
 	return {
 		info: {
 			id,
 			kind: "endnotes",
-			title: titleValue,
-			runningHead: titleValue
+			title: book.endnotes.title,
+			runningHead
 		},
-		node: sectionNode("endnotes", id, [titleNode, ...paragraphs])
+		node: sectionNode("endnotes", id, [endnotesHeading(book), ...paragraphs], galley, runningHead, opens ? flowAttribs(opens) : {})
 	};
 }
+function notesGalley(paragraphs) {
+	const notes = paragraphs.map((paragraph) => element("div", { "data-segnavia-note": paragraph.attribs.id ?? "" }, [paragraph]));
+	return element("aside", {
+		"data-segnavia-notes-galley": "",
+		"aria-hidden": "true"
+	}, notes);
+}
 function withBlankPages(sections, blankBefore) {
 	const counts = /* @__PURE__ */ new Map();
 	for (const id of blankBefore ?? []) counts.set(id, (counts.get(id) ?? 0) + 1);
@@ -150,50 +171,108 @@ function withBlankPages(sections, blankBefore) {
 		"aria-hidden": "true"
 	})), section.node]);
 }
-function bookDocument(book, options = {}) {
-	const notes = noteState();
-	const sections = [];
-	const headings = [];
-	const issues = [];
-	let frontNumber = 0;
+function takeHeldNotesOwner(build) {
+	build.heldNotesOwner -= 1;
+	return build.heldNotesOwner;
+}
+function pushChapterEndnotes(book, build, id, owner) {
+	if (book.endnotes.placement !== "chapter") return;
+	const paragraphs = build.notes.chapterEndnotes.get(owner) ?? [];
+	if (paragraphs.length === 0) return;
+	const runningHead = build.sections.at(-1)?.info.runningHead;
+	build.sections.push(endnotesSection(book, paragraphs, build.galley, id, runningHead, "any"));
+}
+function addFrontMatter(book, build) {
 	let contents;
+	let frontNumber = 0;
 	for (const entry of book.frontMatter) {
 		if (isBookContents(entry)) {
-			contents = contentsSection(entry.title);
-			sections.push(contents);
+			contents = contentsSection(entry, build.galley);
+			build.sections.push(contents);
+			continue;
+		}
+		if (isDesignedSection(entry)) {
+			build.designedNumber += 1;
+			appendDesigned(entry, `segnavia-designed-${build.designedNumber}`, "front", book, build.galley, build.notes, build.sections, build.headings, build.issues);
+			continue;
+		}
+		if (isTemplatedSection(entry)) {
+			build.templatedNumber += 1;
+			appendTemplated(entry, `segnavia-templated-${build.templatedNumber}`, "front", book, build.galley, build.notes, build.templates, build.sections, build.headings, build.issues);
 			continue;
 		}
 		frontNumber += 1;
-		const section = authoredSection(entry, `segnavia-front-${frontNumber}`);
-		sections.push(section);
-		issues.push(...reservedIdIssues(section));
-		if (entry.contents && entry.title !== void 0) headings.push({
+		const section = authoredSection(entry, `segnavia-front-${frontNumber}`, build.galley);
+		build.sections.push(section);
+		build.issues.push(...reservedIdIssues(section), ...columnIssues(section));
+		if (entry.contents && entry.title !== void 0) build.headings.push({
 			id: section.info.id,
 			level: 1,
 			text: entry.title,
 			sectionId: section.info.id
 		});
-		transformNotes(section.node, book, 0, notes);
+		transformNotes(section.node, book, 0, build.notes, build.galley);
 	}
-	for (const [offset, chapter] of book.chapters.entries()) {
-		const number = offset + 1;
-		const section = chapterSection(chapter, number);
-		sections.push(section);
-		issues.push(...reservedIdIssues(section));
-		headings.push({
+	return contents;
+}
+function addChapters(book, build) {
+	let chapterNumber = 0;
+	for (const entry of book.chapters) {
+		if (isDesignedSection(entry)) {
+			build.designedNumber += 1;
+			const owner = takeHeldNotesOwner(build);
+			appendDesigned(entry, `segnavia-designed-${build.designedNumber}`, "designed", book, build.galley, build.notes, build.sections, build.headings, build.issues, owner);
+			pushChapterEndnotes(book, build, `segnavia-endnotes-designed-${build.designedNumber}`, owner);
+			continue;
+		}
+		if (isTemplatedSection(entry)) {
+			build.templatedNumber += 1;
+			const owner = takeHeldNotesOwner(build);
+			appendTemplated(entry, `segnavia-templated-${build.templatedNumber}`, "templated", book, build.galley, build.notes, build.templates, build.sections, build.headings, build.issues, owner);
+			pushChapterEndnotes(book, build, `segnavia-endnotes-templated-${build.templatedNumber}`, owner);
+			continue;
+		}
+		chapterNumber += 1;
+		const section = chapterSection(entry, chapterNumber, build.galley);
+		build.sections.push(section);
+		build.issues.push(...reservedIdIssues(section), ...columnIssues(section));
+		build.headings.push({
 			id: section.info.id,
 			level: 1,
-			text: chapter.title,
+			text: entry.title,
 			sectionId: section.info.id
-		}, ...chapterHeadings(section, number, book.contents.depth));
-		transformNotes(section.node, book, number, notes);
+		}, ...chapterHeadings(section, chapterNumber, book.contents.depth));
+		transformNotes(section.node, book, chapterNumber, build.notes, build.galley);
+		pushChapterEndnotes(book, build, `segnavia-endnotes-${chapterNumber}`, chapterNumber);
 	}
-	if (notes.endnotes) sections.push(endnotesSection(book, notes.endnoteParagraphs));
-	if (book.endnotes.placement === "chapter") issues.push("endnotes at the end of each chapter belong to paginated mode, which is not built yet");
+}
+function bookDocument(book, options = {}) {
+	const build = {
+		galley: book.mode === "paginated",
+		notes: noteState(),
+		sections: [],
+		headings: [],
+		issues: [],
+		templates: new Map(book.templates.map((template) => [template.name, template])),
+		designedNumber: 0,
+		templatedNumber: 0,
+		heldNotesOwner: 0
+	};
+	const contents = addFrontMatter(book, build);
+	addChapters(book, build);
+	const { galley, notes, sections, headings, issues } = build;
+	if (book.endnotes.placement === "chapter") {
+		const leftover = notes.chapterEndnotes.get(0) ?? [];
+		if (leftover.length > 0) sections.push(endnotesSection(book, leftover, galley, "segnavia-endnotes", book.endnotes.title));
+	} else if (notes.endnotes) sections.push(endnotesSection(book, endnotesInOrder(notes), galley, "segnavia-endnotes", book.endnotes.title));
 	if (contents) addContents(book, contents, headings, options);
 	const visible = sections.filter((section) => options.part === void 0 || bookPrintPart(section.info.kind) === options.part);
 	const document = parse("");
-	document.children = [
+	document.children = galley ? [element("style", {}, [text(GALLEY_CSS)]), element("div", { "data-segnavia-galleys": "" }, [
+		...templateHolders(book.templates),
+		...visible.map((section) => section.node),
+		...notes.footnoteParagraphs.length > 0 ? [notesGalley(notes.footnoteParagraphs)] : []
+	])] : [
 		element("style", {}, [text(PRINT_CSS)]),
 		...options.targets ? [targetLinks(visible)] : [],
 		...withBlankPages(visible, options.blankBefore)
@@ -208,6 +287,8 @@ function bookDocument(book, options = {}) {
 				footnotes: notes.footnotes,
 				endnotes: notes.endnotes
 			}),
+			...markPlacementIssues(book.parentPages),
+			...templateRegionNameIssues(book.templates),
 			...issues,
 			...duplicateIdIssues(sections, headings)
 		]

package/dist/book/book-held.js

@@ -0,0 +1,182 @@
+import { elements, parse } from "../sanitize.js";
+import { element, textContent } from "./dom.js";
+import { BOOK_FURNITURE, MOTIF_ATTRIBUTE, REGION_NAME, motifFieldAttribute } from "@segnavia/format";
+//#region src/book/book-held.ts
+function flowAttribs(opens, parents, extra = {}) {
+	const attribs = { ...extra };
+	if (opens) attribs["data-opens"] = opens;
+	if (!parents) return attribs;
+	for (const role of [
+		"opener",
+		"recto",
+		"verso",
+		"blank",
+		"fixed"
+	]) {
+		const name = parents[role];
+		if (name) attribs[`data-parent-${role}`] = name;
+	}
+	return attribs;
+}
+function sectionNode(kind, id, children = [], galley = false, runningHead, extra = {}) {
+	const attribs = {
+		class: `segnavia-section segnavia-${kind}`,
+		id,
+		...extra
+	};
+	if (galley) attribs["data-segnavia-flow"] = id;
+	if (galley && runningHead !== void 0) attribs["data-running-head"] = runningHead;
+	return element("section", attribs, children);
+}
+function collectHeadings(children, sectionId, depth, firstLevel, idFor, generated) {
+	return elements(children).flatMap((heading) => {
+		const match = /^h([1-6])$/.exec(heading.name);
+		if (!match || heading.attribs["data-contents"] === "exclude") return [];
+		const level = Number(match[1]);
+		if (level < firstLevel || level > depth) return [];
+		generated.n += 1;
+		const id = heading.attribs.id ?? idFor(generated.n);
+		heading.attribs.id = id;
+		return [{
+			id,
+			level,
+			text: textContent(heading, true).replace(/\s+/g, " ").trim(),
+			sectionId
+		}];
+	});
+}
+function heldHeadings(children, sectionId, depth, generated) {
+	return collectHeadings(children, sectionId, depth, 1, (n) => `segnavia-h-${sectionId.replace(/^segnavia-/, "")}-${n}`, generated);
+}
+function designedSection(entry, id, kind, galley, depth) {
+	const extra = flowAttribs(entry.opens, entry.parents, {
+		"data-segnavia-kind": "fixed",
+		...kind === "front" ? { "data-sequence": "front" } : {}
+	});
+	const headings = [];
+	const generated = { n: 0 };
+	const holders = entry.pages.map((page, offset) => {
+		const document = parse(page.html);
+		headings.push(...heldHeadings(document.children, id, depth, generated));
+		return element("div", {
+			"data-segnavia-designed-page": String(offset + 1),
+			hidden: ""
+		}, document.children);
+	});
+	if (entry.contents && entry.title !== void 0) headings.unshift({
+		id,
+		level: 1,
+		text: entry.title,
+		sectionId: id
+	});
+	const runningHead = entry.title;
+	return {
+		built: {
+			info: {
+				id,
+				kind,
+				title: entry.title,
+				runningHead
+			},
+			node: sectionNode(kind, id, holders, galley, runningHead, extra)
+		},
+		headings
+	};
+}
+function declaredRegions(html) {
+	return new Set(elements(parse(html).children).flatMap((node) => node.attribs["data-region"] ? [node.attribs["data-region"]] : []));
+}
+const regionNameClear = "use a letter followed by letters, digits, hyphens or underscores to clear this refusal";
+function templateRegionNameIssues(templates) {
+	return templates.flatMap((template) => [...declaredRegions(template.html)].flatMap((key) => REGION_NAME.test(key) ? [] : [`template "${template.name}" marks region "${key}" which is not an HTML name token; ${regionNameClear}`]));
+}
+const markFurniture = BOOK_FURNITURE.find((item) => item.key === "segnavia:mark");
+const markFields = new Set(markFurniture.fields.map((field) => motifFieldAttribute(field.key)));
+const allowedMarkFields = markFurniture.fields.map((field) => field.key).join(" and ");
+function markNodeIssues(parent, node) {
+	if (node.attribs[MOTIF_ATTRIBUTE] !== markFurniture.key) return [];
+	const issues = Object.keys(node.attribs).filter((attribute) => attribute.startsWith(`${MOTIF_ATTRIBUTE}-`) && !markFields.has(attribute)).map((attribute) => {
+		const field = attribute.slice(`${MOTIF_ATTRIBUTE}-`.length);
+		return `parent page "${parent.name}" mark has unknown field "${field}"; use only ${allowedMarkFields} to clear this refusal`;
+	});
+	for (const field of markFurniture.fields) {
+		const attribute = motifFieldAttribute(field.key);
+		const value = node.attribs[attribute] ?? ("default" in field ? field.default : void 0);
+		if ("required" in field && field.required && (value === void 0 || value.trim() === "")) issues.push(`parent page "${parent.name}" mark has an empty ${field.key}; set a non-empty ${attribute} on the segnavia:mark placement to clear this refusal`);
+		if ("choices" in field && value !== void 0) {
+			const choices = field.choices;
+			if (!choices.includes(value)) issues.push(`parent page "${parent.name}" mark has unknown ${field.key} value "${value}"; use ${choices.join(" or ")} to clear this refusal`);
+		}
+	}
+	return issues;
+}
+function markPlacementIssues(parents) {
+	return parents.flatMap((parent) => ["head", "foot"].flatMap((region) => {
+		const html = parent[region];
+		if (html === void 0) return [];
+		return elements(parse(html).children).flatMap((node) => markNodeIssues(parent, node));
+	}));
+}
+function undeclaredRegionIssues(entry, id, templates) {
+	const label = entry.title ?? id;
+	return entry.pages.flatMap((page, index) => {
+		const name = page.template ?? entry.template;
+		const template = templates.get(name);
+		if (!template) return [];
+		const declared = declaredRegions(template.html);
+		return Object.keys(page.regions).flatMap((region) => declared.has(region) ? [] : [`section ${label} page ${index + 1} fills region "${region}" which template "${name}" does not declare; add that region to the template or remove the fill to clear this refusal`]);
+	});
+}
+function templatedSection(entry, id, kind, galley, depth) {
+	const extra = flowAttribs(entry.opens, entry.parents, {
+		"data-segnavia-kind": "templated",
+		"data-template": entry.template,
+		...kind === "front" ? { "data-sequence": "front" } : {}
+	});
+	const headings = [];
+	const generated = { n: 0 };
+	const holders = entry.pages.map((page, offset) => {
+		const name = page.template ?? entry.template;
+		const regions = Object.entries(page.regions).map(([region, html]) => {
+			const document = parse(html);
+			headings.push(...heldHeadings(document.children, id, depth, generated));
+			return element("div", {
+				"data-region": region,
+				hidden: ""
+			}, document.children);
+		});
+		return element("div", {
+			"data-segnavia-templated-page": String(offset + 1),
+			"data-template": name,
+			hidden: ""
+		}, regions);
+	});
+	if (entry.contents && entry.title !== void 0) headings.unshift({
+		id,
+		level: 1,
+		text: entry.title,
+		sectionId: id
+	});
+	const runningHead = entry.title;
+	return {
+		built: {
+			info: {
+				id,
+				kind,
+				title: entry.title,
+				runningHead
+			},
+			node: sectionNode(kind, id, holders, galley, runningHead, extra)
+		},
+		headings
+	};
+}
+function templateHolders(templates) {
+	return templates.map((template) => element("div", {
+		"data-segnavia-template": template.name,
+		hidden: "",
+		...flowAttribs(void 0, template.parents)
+	}, parse(template.html).children));
+}
+//#endregion
+export { collectHeadings, designedSection, flowAttribs, markPlacementIssues, sectionNode, templateHolders, templateRegionNameIssues, templatedSection, undeclaredRegionIssues };

package/dist/book/book-view.d.ts

@@ -0,0 +1,5 @@
+import { Book, BookView } from "@segnavia/format";
+//#region src/book/book-view.d.ts
+export declare function bookViewFromHtml(book: Book, html: string): BookView;
+export declare function bookView(book: Book): BookView;
+//#endregion

package/dist/book/book-view.js

@@ -0,0 +1,26 @@
+import { bookDocument } from "./book-document.js";
+import { resolveBookPagination } from "@segnavia/format";
+//#region src/book/book-view.ts
+function bookViewFromHtml(book, html) {
+	const view = {
+		html,
+		title: book.title,
+		scripts: book.scripts,
+		...book.dir === void 0 ? {} : { dir: book.dir },
+		...book.lang === void 0 ? {} : { lang: book.lang },
+		...book.fonts === void 0 ? {} : { fonts: book.fonts },
+		...book.css === void 0 ? {} : { css: book.css }
+	};
+	const pagination = resolveBookPagination(book);
+	return pagination ? {
+		...view,
+		pagination
+	} : view;
+}
+function bookView(book) {
+	const document = bookDocument(book);
+	if (document.issues.length > 0) throw new Error(`The book cannot be shown: ${document.issues.join("; ")}.`);
+	return bookViewFromHtml(book, document.html);
+}
+//#endregion
+export { bookView, bookViewFromHtml };

package/dist/book/furniture.d.ts

@@ -0,0 +1,14 @@
+import { PaginatePageMarks } from "./paginate-types.js";
+//#region src/book/furniture.d.ts
+export interface BookFurnitureValues {
+  folio?: string;
+  runningHead?: string;
+  marks?: PaginatePageMarks;
+}
+export declare function fillBookFurniture(html: string, values: BookFurnitureValues, dir?: string, lang?: string): string;
+export declare function embedFunction(name: string, fn: {
+  name: string;
+  toString(): string;
+}): string;
+export declare function furnitureScript(): string;
+//#endregion