@segnavia/html 0.36.0 → 0.37.0

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

@@ -1,7 +1,5 @@
 import { BookDocument, BookDocumentOptions } from "./types.js";
 import { Book } from "@segnavia/format";
 //#region src/book/book-document.d.ts
-export declare const BOOK_COLUMN_MIN = 2;
-export declare const BOOK_COLUMN_MAX = 4;
 export declare function bookDocument(book: Book, options?: BookDocumentOptions): BookDocument;
 //#endregion

package/dist/book/book-document.js

@@ -1,4 +1,5 @@
 import { elements, parse, serialize } from "../sanitize.js";
+import { bookDocumentCss, bookFlowPageGeometry, markBlockPositions, resolveBookBuild } from "./book-flow.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";
@@ -6,16 +7,13 @@ import { bookPrintPart } from "./types.js";
 import { isTag } from "domhandler";
 import { isBookContents, isDesignedSection, isTemplatedSection, noteMarkerIssues, resolveDirection } from "@segnavia/format";
 //#region src/book/book-document.ts
-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 authoredSection(section, id, galley = false) {
+function authoredSection(section, id, build) {
 	const document = parse(section.html);
 	const runningHead = section.title;
-	const node = sectionNode("front", id, document.children, galley, runningHead, flowAttribs(section.opens, section.parents));
+	const node = sectionNode("front", id, document.children, build, runningHead, flowAttribs(section.opens, section.parents));
 	return {
 		info: {
 			id,
@@ -26,7 +24,7 @@ function authoredSection(section, id, galley = false) {
 		node
 	};
 }
-function contentsSection(entry, galley = false) {
+function contentsSection(entry, build) {
 	const id = "segnavia-contents";
 	const title = entry.title;
 	const children = title !== void 0 ? [element("h1", {
@@ -40,10 +38,10 @@ function contentsSection(entry, galley = false) {
 			title,
 			runningHead: title
 		},
-		node: sectionNode("contents", id, children, galley, title, flowAttribs(entry.opens, entry.parents))
+		node: sectionNode("contents", id, children, build, title, flowAttribs(entry.opens, entry.parents))
 	};
 }
-function chapterSection(chapter, index, galley = false) {
+function chapterSection(chapter, index, build) {
 	const id = `segnavia-chapter-${index}`;
 	const document = parse(chapter.html);
 	const runningHead = chapter.runningHead ?? chapter.title;
@@ -54,22 +52,22 @@ function chapterSection(chapter, index, galley = false) {
 			title: chapter.title,
 			runningHead
 		},
-		node: sectionNode("chapter", id, document.children, galley, runningHead, flowAttribs(chapter.opens, chapter.parents))
+		node: sectionNode("chapter", id, document.children, build, runningHead, flowAttribs(chapter.opens, chapter.parents))
 	};
 }
-function appendHeld(built, heldHeadings, extraIssues, book, notes, galley, sections, headings, issues, notesOwner = 0) {
+function appendHeld(built, heldHeadings, extraIssues, book, notes, build, 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);
+	transformNotes(built.node, book, 0, notes, build === "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 appendDesigned(entry, id, kind, book, build, notes, sections, headings, issues, notesOwner = 0) {
+	const held = designedSection(entry, id, kind, build, book.contents.depth, build === "flow" ? bookFlowPageGeometry(book) : void 0);
+	appendHeld(held.built, held.headings, [], book, notes, build, 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 appendTemplated(entry, id, kind, book, build, notes, templates, sections, headings, issues, notesOwner = 0) {
+	const held = templatedSection(entry, id, kind, build, book.contents.depth, templates, build === "flow" ? bookFlowPageGeometry(book) : void 0);
+	appendHeld(held.built, held.headings, undeclaredRegionIssues(entry, id, templates), book, notes, build, sections, headings, issues, notesOwner);
 }
 function chapterHeadings(section, chapter, depth) {
 	return collectHeadings(section.node.children, section.info.id, depth, 2, (n) => `segnavia-h-${chapter}-${n}`, { n: 0 });
@@ -125,8 +123,6 @@ function reservedIdIssues(section) {
 		return [`authored id ${id} in ${section.info.title ?? section.info.id} (${section.info.id}) uses the reserved segnavia- prefix`];
 	});
 }
-const BOOK_COLUMN_MIN = 2;
-const BOOK_COLUMN_MAX = 4;
 function columnsValueOk(value) {
 	if (!/^[0-9]+$/.test(value)) return false;
 	const count = Number(value);
@@ -147,7 +143,7 @@ function endnotesHeading(book) {
 		dir: direction(book, titleValue)
 	}, [text(titleValue)]);
 }
-function endnotesSection(book, paragraphs, galley, id, runningHead, opens) {
+function endnotesSection(book, paragraphs, build, id, runningHead, opens) {
 	return {
 		info: {
 			id,
@@ -155,7 +151,7 @@ function endnotesSection(book, paragraphs, galley, id, runningHead, opens) {
 			title: book.endnotes.title,
 			runningHead
 		},
-		node: sectionNode("endnotes", id, [endnotesHeading(book), ...paragraphs], galley, runningHead, opens ? flowAttribs(opens) : {})
+		node: sectionNode("endnotes", id, [endnotesHeading(book), ...paragraphs], build, runningHead, opens ? flowAttribs(opens) : {})
 	};
 }
 function notesGalley(paragraphs) {
@@ -182,29 +178,29 @@ function pushChapterEndnotes(book, build, id, owner) {
 	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"));
+	build.sections.push(endnotesSection(book, paragraphs, build.build, id, runningHead, "any"));
 }
 function addFrontMatter(book, build) {
 	let contents;
 	let frontNumber = 0;
 	for (const entry of book.frontMatter) {
 		if (isBookContents(entry)) {
-			contents = contentsSection(entry, build.galley);
+			contents = contentsSection(entry, build.build);
 			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);
+			appendDesigned(entry, `segnavia-designed-${build.designedNumber}`, "front", book, build.build, 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);
+			appendTemplated(entry, `segnavia-templated-${build.templatedNumber}`, "front", book, build.build, build.notes, build.templates, build.sections, build.headings, build.issues);
 			continue;
 		}
 		frontNumber += 1;
-		const section = authoredSection(entry, `segnavia-front-${frontNumber}`, build.galley);
+		const section = authoredSection(entry, `segnavia-front-${frontNumber}`, build.build);
 		build.sections.push(section);
 		build.issues.push(...reservedIdIssues(section), ...columnIssues(section));
 		if (entry.contents && entry.title !== void 0) build.headings.push({
@@ -213,7 +209,7 @@ function addFrontMatter(book, build) {
 			text: entry.title,
 			sectionId: section.info.id
 		});
-		transformNotes(section.node, book, 0, build.notes, build.galley);
+		transformNotes(section.node, book, 0, build.notes, build.build === "galley");
 	}
 	return contents;
 }
@@ -223,19 +219,19 @@ function addChapters(book, build) {
 		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);
+			appendDesigned(entry, `segnavia-designed-${build.designedNumber}`, "designed", book, build.build, 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);
+			appendTemplated(entry, `segnavia-templated-${build.templatedNumber}`, "templated", book, build.build, 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);
+		const section = chapterSection(entry, chapterNumber, build.build);
 		build.sections.push(section);
 		build.issues.push(...reservedIdIssues(section), ...columnIssues(section));
 		build.headings.push({
@@ -244,13 +240,14 @@ function addChapters(book, build) {
 			text: entry.title,
 			sectionId: section.info.id
 		}, ...chapterHeadings(section, chapterNumber, book.contents.depth));
-		transformNotes(section.node, book, chapterNumber, build.notes, build.galley);
+		transformNotes(section.node, book, chapterNumber, build.notes, build.build === "galley");
 		pushChapterEndnotes(book, build, `segnavia-endnotes-${chapterNumber}`, chapterNumber);
 	}
 }
 function bookDocument(book, options = {}) {
+	const { build: requestedBuild, issue: buildIssue } = resolveBookBuild(book, options.build);
 	const build = {
-		galley: book.mode === "paginated",
+		build: requestedBuild,
 		notes: noteState(),
 		sections: [],
 		headings: [],
@@ -262,20 +259,21 @@ function bookDocument(book, options = {}) {
 	};
 	const contents = addFrontMatter(book, build);
 	addChapters(book, build);
-	const { galley, notes, sections, headings, issues } = build;
+	const { 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 (leftover.length > 0) sections.push(endnotesSection(book, leftover, requestedBuild, "segnavia-endnotes", book.endnotes.title));
+	} else if (notes.endnotes) sections.push(endnotesSection(book, endnotesInOrder(notes), requestedBuild, "segnavia-endnotes", book.endnotes.title));
 	if (contents) addContents(book, contents, headings, options);
+	if (requestedBuild !== "print") markBlockPositions(sections);
 	const visible = sections.filter((section) => options.part === void 0 || bookPrintPart(section.info.kind) === options.part);
 	const document = parse("");
-	document.children = galley ? [element("style", {}, [text(GALLEY_CSS)]), element("div", { "data-segnavia-galleys": "" }, [
+	document.children = requestedBuild === "galley" ? [element("style", {}, [text(bookDocumentCss(book, requestedBuild))]), 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)]),
+		element("style", {}, [text(bookDocumentCss(book, requestedBuild))]),
 		...options.targets ? [targetLinks(visible)] : [],
 		...withBlankPages(visible, options.blankBefore)
 	];
@@ -285,6 +283,7 @@ function bookDocument(book, options = {}) {
 		sections: sections.map((section) => section.info),
 		headings,
 		issues: [
+			...buildIssue ? [buildIssue] : [],
 			...noteMarkerIssues(book, {
 				footnotes: notes.footnotes,
 				endnotes: notes.endnotes
@@ -297,4 +296,4 @@ function bookDocument(book, options = {}) {
 	};
 }
 //#endregion
-export { BOOK_COLUMN_MAX, BOOK_COLUMN_MIN, bookDocument };
+export { bookDocument };

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

@@ -0,0 +1,13 @@
+import { Element } from "domhandler";
+import { Book } from "@segnavia/format";
+//#region src/book/book-flow.d.ts
+export declare const BOOK_FLOW_COLUMN_MIN_PX = 240;
+export declare const BOOK_COLUMN_MIN = 2;
+export declare const BOOK_COLUMN_MAX = 4;
+export interface BookPositionKey {
+  flow: string;
+  index: number;
+  suffix?: string;
+}
+export declare function parseBookPositionKey(value: string): BookPositionKey | undefined;
+//#endregion

package/dist/book/book-flow.js

@@ -0,0 +1,80 @@
+import { isTag } from "domhandler";
+import { PX_PER_MM, sheetMm } from "@segnavia/format";
+//#region src/book/book-flow.ts
+const BOOK_FLOW_COLUMN_MIN_PX = 240;
+const BOOK_COLUMN_MIN = 2;
+const BOOK_COLUMN_MAX = 4;
+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 bookFlowPageGeometry(book) {
+	if (!book.page) return void 0;
+	const paper = sheetMm(book.page);
+	return {
+		paperInline: paper.width * PX_PER_MM,
+		paperBlock: paper.height * PX_PER_MM,
+		textInline: (paper.width - book.page.margin.inner - book.page.margin.outer) * PX_PER_MM,
+		textBlock: (paper.height - book.page.margin.top - book.page.margin.bottom) * PX_PER_MM,
+		marginBlockStart: book.page.margin.top * PX_PER_MM,
+		marginInlineStartRecto: book.page.margin.inner * PX_PER_MM,
+		marginInlineStartVerso: book.page.margin.outer * PX_PER_MM
+	};
+}
+function columnFallbacks(gap) {
+	return Array.from({ length: 3 }, (_, index) => index + 2).map((count) => {
+		return `@container (max-width:${count * 240 + (count - 1) * gap}px){:where([data-columns="${count}"]){column-count:1}}`;
+	}).join("");
+}
+function flowCss(book) {
+	const gap = (book.page?.columnGap ?? 0) * PX_PER_MM;
+	const columns = Array.from({ length: 3 }, (_, index) => index + 2).map((count) => `:where([data-columns="${count}"]){column-count:${count}}`).join("");
+	return `${CONTENTS_CSS}:where([data-segnavia-flow]){container-type:inline-size}:where([data-columns]){column-gap:${gap}px}${columns}:where([data-segnavia-flow-page]){inline-size:100%;container-type:inline-size;margin-inline:0}:where([data-segnavia-flow-page-size]){position:relative;inline-size:100cqi;block-size:calc(100cqi * var(--segnavia-paper-ratio));overflow:hidden}:where([data-segnavia-flow-paper]){position:absolute;inset-block-start:0;inset-inline-start:0;inline-size:var(--segnavia-paper-inline);block-size:var(--segnavia-paper-block);overflow:hidden;zoom:var(--segnavia-flow-scale,calc(100cqi / var(--segnavia-paper-inline)))}:where([data-segnavia-flow-text]){position:absolute;inset-block-start:var(--segnavia-text-block-start);inset-inline-start:var(--segnavia-text-inline-start);inline-size:var(--segnavia-text-inline);block-size:var(--segnavia-text-block);container-type:inline-size}${columnFallbacks(gap)}`;
+}
+function resolveBookBuild(book, requested) {
+	const build = requested ?? (book.mode === "paginated" ? "galley" : "print");
+	if (book.mode === "paginated" || build === "print") return { build };
+	return {
+		build,
+		issue: `a continuous book cannot use the ${build} build; request the print build, or make the book paginated with a page to clear this`
+	};
+}
+function bookDocumentCss(book, build) {
+	if (build === "galley") return GALLEY_CSS;
+	return build === "flow" ? flowCss(book) : PRINT_CSS;
+}
+function flowPageStyle(geometry, recto) {
+	const marginInlineStart = recto ? geometry.marginInlineStartRecto : geometry.marginInlineStartVerso;
+	return `--segnavia-paper-inline:${geometry.paperInline}px;--segnavia-paper-block:${geometry.paperBlock}px;--segnavia-paper-ratio:${geometry.paperBlock / geometry.paperInline};--segnavia-text-inline:${geometry.textInline}px;--segnavia-text-block:${geometry.textBlock}px;--segnavia-text-block-start:${geometry.marginBlockStart}px;--segnavia-text-inline-start:${marginInlineStart}px`;
+}
+function bookBlockPosition(flowId, block, suffix) {
+	return `${flowId}:${block}${suffix ? `:${suffix}` : ""}`;
+}
+function parseBookPositionKey(value) {
+	const match = /^(.*):(\d+)(?::([^:]+))?$/.exec(value);
+	if (!match?.[1] || !match[2]) return void 0;
+	return {
+		flow: match[1],
+		index: Number(match[2]),
+		...match[3] ? { suffix: match[3] } : {}
+	};
+}
+function isFootnoteBlock(node) {
+	return (node.attribs.class ?? "").split(/\s+/).includes("segnavia-footnotes");
+}
+function markBlockPositions(sections) {
+	for (const section of sections) {
+		let position = 0;
+		for (const child of section.node.children) {
+			if (!isTag(child)) continue;
+			if (child.name === "style" || child.name === "script") continue;
+			if (isFootnoteBlock(child)) {
+				child.attribs["data-segnavia-position"] = bookBlockPosition(section.info.id, position, "footnotes");
+				continue;
+			}
+			position += 1;
+			child.attribs["data-segnavia-position"] = bookBlockPosition(section.info.id, position);
+		}
+	}
+}
+//#endregion
+export { BOOK_COLUMN_MAX, BOOK_COLUMN_MIN, BOOK_FLOW_COLUMN_MIN_PX, bookBlockPosition, bookDocumentCss, bookFlowPageGeometry, flowPageStyle, markBlockPositions, parseBookPositionKey, resolveBookBuild };

package/dist/book/book-held.js

@@ -1,5 +1,6 @@
 import { elements, parse } from "../sanitize.js";
-import { element, textContent } from "./dom.js";
+import { flowPageStyle } from "./book-flow.js";
+import { element, linkChildren, 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 = {}) {
@@ -18,16 +19,24 @@ function flowAttribs(opens, parents, extra = {}) {
 	}
 	return attribs;
 }
-function sectionNode(kind, id, children = [], galley = false, runningHead, extra = {}) {
+function sectionNode(kind, id, children = [], build, 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;
+	if (build !== "print") attribs["data-segnavia-flow"] = id;
+	if (build === "galley" && runningHead !== void 0) attribs["data-running-head"] = runningHead;
 	return element("section", attribs, children);
 }
+function flowPage(page, kind, children, geometry, recto) {
+	const paper = element("div", { "data-segnavia-flow-paper": "" }, children);
+	return element("figure", {
+		[`data-segnavia-${kind}-page`]: String(page),
+		"data-segnavia-flow-page": "",
+		style: flowPageStyle(geometry, recto)
+	}, [element("div", { "data-segnavia-flow-page-size": "" }, [paper])]);
+}
 function collectHeadings(children, sectionId, depth, firstLevel, idFor, generated) {
 	return elements(children).flatMap((heading) => {
 		const match = /^h([1-6])$/.exec(heading.name);
@@ -48,17 +57,18 @@ function collectHeadings(children, sectionId, depth, firstLevel, idFor, generate
 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) {
+function designedSection(entry, id, kind, build, depth, geometry) {
 	const extra = flowAttribs(entry.opens, entry.parents, {
 		"data-segnavia-kind": "fixed",
 		...kind === "front" ? { "data-sequence": "front" } : {}
 	});
 	const headings = [];
 	const generated = { n: 0 };
+	const firstRecto = entry.opens !== "verso";
 	const holders = entry.pages.map((page, offset) => {
 		const document = parse(page.html);
 		headings.push(...heldHeadings(document.children, id, depth, generated));
-		return element("div", {
+		return build === "flow" && geometry ? flowPage(offset + 1, "designed", document.children, geometry, offset % 2 === 0 ? firstRecto : !firstRecto) : element("div", {
 			"data-segnavia-designed-page": String(offset + 1),
 			hidden: ""
 		}, document.children);
@@ -78,7 +88,7 @@ function designedSection(entry, id, kind, galley, depth) {
 				title: entry.title,
 				runningHead
 			},
-			node: sectionNode(kind, id, holders, galley, runningHead, extra)
+			node: sectionNode(kind, id, holders, build, runningHead, extra)
 		},
 		headings
 	};
@@ -127,7 +137,7 @@ function undeclaredRegionIssues(entry, id, templates) {
 		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) {
+function templatedSection(entry, id, kind, build, depth, templates, geometry) {
 	const extra = flowAttribs(entry.opens, entry.parents, {
 		"data-segnavia-kind": "templated",
 		"data-template": entry.template,
@@ -135,16 +145,34 @@ function templatedSection(entry, id, kind, galley, depth) {
 	});
 	const headings = [];
 	const generated = { n: 0 };
+	const firstRecto = entry.opens !== "verso";
 	const holders = entry.pages.map((page, offset) => {
 		const name = page.template ?? entry.template;
+		const regionChildren = /* @__PURE__ */ new Map();
 		const regions = Object.entries(page.regions).map(([region, html]) => {
 			const document = parse(html);
 			headings.push(...heldHeadings(document.children, id, depth, generated));
+			regionChildren.set(region, document.children);
 			return element("div", {
 				"data-region": region,
 				hidden: ""
 			}, document.children);
 		});
+		if (build === "flow" && geometry) {
+			const template = templates?.get(name);
+			const document = parse(template?.html ?? "");
+			for (const [region, children] of regionChildren) {
+				const target = elements(document.children).find((node) => node.attribs["data-region"] === region);
+				if (!target) continue;
+				target.children = children;
+				linkChildren(target);
+			}
+			const text = element("div", {
+				"data-segnavia-flow-text": "",
+				"data-template": name
+			}, document.children);
+			return flowPage(offset + 1, "templated", [text], geometry, offset % 2 === 0 ? firstRecto : !firstRecto);
+		}
 		return element("div", {
 			"data-segnavia-templated-page": String(offset + 1),
 			"data-template": name,
@@ -166,7 +194,7 @@ function templatedSection(entry, id, kind, galley, depth) {
 				title: entry.title,
 				runningHead
 			},
-			node: sectionNode(kind, id, holders, galley, runningHead, extra)
+			node: sectionNode(kind, id, holders, build, runningHead, extra)
 		},
 		headings
 	};

package/dist/book/book-view.js

@@ -19,8 +19,14 @@ function bookViewFromHtml(book, html) {
 }
 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);
+	const flow = book.mode === "paginated" ? bookDocument(book, { build: "flow" }) : void 0;
+	const issues = document.issues.length > 0 ? document.issues : flow?.issues ?? [];
+	if (issues.length > 0) throw new Error(`The book cannot be shown: ${issues.join("; ")}.`);
+	const view = bookViewFromHtml(book, document.html);
+	return flow ? {
+		...view,
+		flow: flow.html
+	} : view;
 }
 //#endregion
 export { bookView, bookViewFromHtml };

package/dist/book/paginate-keeps.js

@@ -62,7 +62,7 @@ function paginateKeeps(placed, next, textHeight, orphans, widows, allowEmpty) {
 		return kept(countOf(held, block) - need <= 0 ? dropBlock(held, block) : held.slice(0, held.length - need));
 	}
 	function rewindHeading(held, last, following) {
-		const other = !following || !sameBlock(following.block, last.block);
+		const other = following && !sameBlock(following.block, last.block);
 		if (!keepWithNext(last.block) || countOf(held, last.block) !== last.block.lines.length || !other) return void 0;
 		return kept(dropBlock(held, last.block));
 	}
@@ -70,7 +70,8 @@ function paginateKeeps(placed, next, textHeight, orphans, widows, allowEmpty) {
 	for (let pass = 0; pass < 8; pass += 1) {
 		const last = result[result.length - 1];
 		if (!last) return result;
-		const nextResult = rewindTogether(result, last) ?? rewindOrphans(result, last) ?? rewindWidows(result, last) ?? rewindHeading(result, last, next);
+		const following = placed[result.length] ?? next;
+		const nextResult = rewindTogether(result, last) ?? rewindOrphans(result, last) ?? rewindWidows(result, last) ?? rewindHeading(result, last, following);
 		if (!nextResult) return result;
 		result = nextResult;
 	}

package/dist/book/types.d.ts

@@ -5,7 +5,9 @@ export interface BookDocumentOptions {
   part?: 'front' | 'body';
   crossLinks?: boolean;
   targets?: boolean;
+  build?: BookBuild;
 }
+export type BookBuild = 'print' | 'galley' | 'flow';
 export interface BookSectionInfo {
   id: string;
   kind: 'front' | 'contents' | 'chapter' | 'endnotes' | 'designed' | 'templated';

package/dist/index.d.ts

@@ -1,8 +1,9 @@
 import { base64ToBytes, bytesToBase64 } from "./base64.js";
 import { REFUSED_ELEMENTS, SanitizeOptions, findActiveContent, sanitize } from "./sanitize.js";
 import { BINDINGS, FillOptions, Filled, bindingNames, bindingRoot, fill, hasBindings } from "./bindings.js";
-import { BookDocument, BookDocumentOptions, BookHeading, BookPrintPart, BookSectionInfo, bookPrintPart } from "./book/types.js";
-import { BOOK_COLUMN_MAX, BOOK_COLUMN_MIN, bookDocument } from "./book/book-document.js";
+import { BookBuild, BookDocument, BookDocumentOptions, BookHeading, BookPrintPart, BookSectionInfo, bookPrintPart } from "./book/types.js";
+import { bookDocument } from "./book/book-document.js";
+import { BOOK_COLUMN_MAX, BOOK_COLUMN_MIN, BOOK_FLOW_COLUMN_MIN_PX, BookPositionKey, parseBookPositionKey } from "./book/book-flow.js";
 import { bookView, bookViewFromHtml } from "./book/book-view.js";
 import { PaginateBlock, PaginateBookInput, PaginateBookPage, PaginateBookRefusal, PaginateBookResult, PaginateFlow, PaginateFlowParents, PaginateLine, PaginateMark, PaginateNote, PaginateNoteRef, PaginateOpens, PaginatePageMarks, PaginatePageNote, PaginatePageRole, PaginateSequence, PaginateWindow } from "./book/paginate-types.js";
 import { BookFurnitureValues, embedFunction, fillBookFurniture, furnitureScript } from "./book/furniture.js";
@@ -23,4 +24,4 @@ export type HtmlKind = 'plain' | 'live-data' | 'scripted' | 'refused';
 export declare function classify(html: string, prefix: string): HtmlKind;
 export declare function searchText(html: string): string;
 //#endregion
-export { BINDINGS, BOOK_COLUMN_MAX, BOOK_COLUMN_MIN, type BookDocument, type BookDocumentOptions, type BookFurnitureValues, type BookHeading, BookPageFacts, type BookPrintPart, BookPrintedPagePlan, BookPrintedPageRole, type BookSectionInfo, type BookSectionParents, type ExpandMotifsOptions, type ExpandedMotifs, type FillOptions, type Filled, FontCssRefusedError, MAX_SLOT_DECLARATIONS, MOTIF_DEPTH_LIMIT, MotifRefusedError, PAGINATE_FUNCTIONS, type PaginateBlock, type PaginateBookInput, type PaginateBookPage, type PaginateBookRefusal, type PaginateBookResult, type PaginateFlow, type PaginateFlowParents, type PaginateLine, type PaginateMark, type PaginateNote, type PaginateNoteRef, type PaginateOpens, type PaginatePageMarks, type PaginatePageNote, type PaginatePageRole, type PaginateSequence, type PaginateTarget, type PaginateTargetPage, type PaginateWindow, type PlacedMotif, type PreparedSlots, PrintedPagePlan, PrintedPageSide, REFUSED_ELEMENTS, RequiredSlotsRefusedError, type SanitizeOptions, type SlotFillEntry, type SlotFillRefusal, SlotFillRefusedError, SlotFillsConflictError, SlotFillsRefusedError, type SlotPrintOptions, UNICODE_RANGE_CLEARANCE, type UnicodeRangeParse, UnmeasuredSlotsRefusedError, assertSingleSlotCopy, assertSlotPrintOptions, base64ToBytes, bindingNames, bindingRoot, bookDocument, bookPrintPart, bookStylesheet, bookView, bookViewFromHtml, bytesToBase64, collectSlotPrintCopies, documentLanguage, embedFunction, expandMotifs, fill, fillBookFurniture, findActiveContent, fontCss, fontFaceCss, fontFormat, fontReferenceRefusals, furnitureScript, hasBindings, hasMotifPlacement, hasSlotWork, heldPageNumber, isSlotCopyRefusal, libraryMotifPlacementRefusal, mergeSlotFitResults, motifPlacementRefusals, openerPageIndex, pageIndexForTarget, paginateBook, paginateScript, parseUnicodeRange, planBookPages, planPrintedPages, prepareSlotCollection, prepareSlots, printedPageAt, renderMotifPlacements, requiredSlotRefusal, sanitize, sanitizeBookCss, selectBookParent, slotFillCopyId, slotFillRefusal, slotFillsConflict, unmeasuredSlotRefusal, windowPageIndex };
+export { BINDINGS, BOOK_COLUMN_MAX, BOOK_COLUMN_MIN, BOOK_FLOW_COLUMN_MIN_PX, type BookBuild, type BookDocument, type BookDocumentOptions, type BookFurnitureValues, type BookHeading, BookPageFacts, type BookPositionKey, type BookPrintPart, BookPrintedPagePlan, BookPrintedPageRole, type BookSectionInfo, type BookSectionParents, type ExpandMotifsOptions, type ExpandedMotifs, type FillOptions, type Filled, FontCssRefusedError, MAX_SLOT_DECLARATIONS, MOTIF_DEPTH_LIMIT, MotifRefusedError, PAGINATE_FUNCTIONS, type PaginateBlock, type PaginateBookInput, type PaginateBookPage, type PaginateBookRefusal, type PaginateBookResult, type PaginateFlow, type PaginateFlowParents, type PaginateLine, type PaginateMark, type PaginateNote, type PaginateNoteRef, type PaginateOpens, type PaginatePageMarks, type PaginatePageNote, type PaginatePageRole, type PaginateSequence, type PaginateTarget, type PaginateTargetPage, type PaginateWindow, type PlacedMotif, type PreparedSlots, PrintedPagePlan, PrintedPageSide, REFUSED_ELEMENTS, RequiredSlotsRefusedError, type SanitizeOptions, type SlotFillEntry, type SlotFillRefusal, SlotFillRefusedError, SlotFillsConflictError, SlotFillsRefusedError, type SlotPrintOptions, UNICODE_RANGE_CLEARANCE, type UnicodeRangeParse, UnmeasuredSlotsRefusedError, assertSingleSlotCopy, assertSlotPrintOptions, base64ToBytes, bindingNames, bindingRoot, bookDocument, bookPrintPart, bookStylesheet, bookView, bookViewFromHtml, bytesToBase64, collectSlotPrintCopies, documentLanguage, embedFunction, expandMotifs, fill, fillBookFurniture, findActiveContent, fontCss, fontFaceCss, fontFormat, fontReferenceRefusals, furnitureScript, hasBindings, hasMotifPlacement, hasSlotWork, heldPageNumber, isSlotCopyRefusal, libraryMotifPlacementRefusal, mergeSlotFitResults, motifPlacementRefusals, openerPageIndex, pageIndexForTarget, paginateBook, paginateScript, parseBookPositionKey, parseUnicodeRange, planBookPages, planPrintedPages, prepareSlotCollection, prepareSlots, printedPageAt, renderMotifPlacements, requiredSlotRefusal, sanitize, sanitizeBookCss, selectBookParent, slotFillCopyId, slotFillRefusal, slotFillsConflict, unmeasuredSlotRefusal, windowPageIndex };

package/dist/index.js

@@ -1,8 +1,9 @@
 import { REFUSED_ELEMENTS, elements, findActiveContent, parse, sanitize } from "./sanitize.js";
 import { BINDINGS, bindingNames, bindingRoot, fill, hasBindings } from "./bindings.js";
 import { base64ToBytes, bytesToBase64 } from "./base64.js";
+import { BOOK_COLUMN_MAX, BOOK_COLUMN_MIN, BOOK_FLOW_COLUMN_MIN_PX, parseBookPositionKey } from "./book/book-flow.js";
 import { bookPrintPart } from "./book/types.js";
-import { BOOK_COLUMN_MAX, BOOK_COLUMN_MIN, bookDocument } from "./book/book-document.js";
+import { bookDocument } from "./book/book-document.js";
 import { bookView, bookViewFromHtml } from "./book/book-view.js";
 import { embedFunction, fillBookFurniture, furnitureScript } from "./book/furniture.js";
 import { PAGINATE_FUNCTIONS, paginateBook, paginateScript } from "./book/paginate-book.js";
@@ -29,4 +30,4 @@ function searchText(html) {
 	return html.replace(/<(script|style)\b[^>]*>[\s\S]*?<\/\1\s*>/gi, " ").replace(/<[^>]+>/g, " ").replace(/&nbsp;/g, " ").replace(/\s+/g, " ").trim();
 }
 //#endregion
-export { BINDINGS, BOOK_COLUMN_MAX, BOOK_COLUMN_MIN, FontCssRefusedError, MAX_SLOT_DECLARATIONS, MOTIF_DEPTH_LIMIT, MotifRefusedError, PAGINATE_FUNCTIONS, REFUSED_ELEMENTS, RequiredSlotsRefusedError, SlotFillRefusedError, SlotFillsConflictError, SlotFillsRefusedError, UNICODE_RANGE_CLEARANCE, UnmeasuredSlotsRefusedError, assertSingleSlotCopy, assertSlotPrintOptions, base64ToBytes, bindingNames, bindingRoot, bookDocument, bookPrintPart, bookStylesheet, bookView, bookViewFromHtml, bytesToBase64, classify, collectSlotPrintCopies, documentLanguage, embedFunction, expandMotifs, fill, fillBookFurniture, findActiveContent, fontCss, fontFaceCss, fontFormat, fontReferenceRefusals, furnitureScript, hasBindings, hasMotifPlacement, hasSlotWork, heldPageNumber, isSlotCopyRefusal, libraryMotifPlacementRefusal, mergeSlotFitResults, motifPlacementRefusals, openerPageIndex, pageIndexForTarget, paginateBook, paginateScript, parseUnicodeRange, planBookPages, planPrintedPages, prepareSlotCollection, prepareSlots, printedPageAt, renderMotifPlacements, requiredSlotRefusal, sanitize, sanitizeBookCss, searchText, selectBookParent, slotFillCopyId, slotFillRefusal, slotFillsConflict, unmeasuredSlotRefusal, windowPageIndex };
+export { BINDINGS, BOOK_COLUMN_MAX, BOOK_COLUMN_MIN, BOOK_FLOW_COLUMN_MIN_PX, FontCssRefusedError, MAX_SLOT_DECLARATIONS, MOTIF_DEPTH_LIMIT, MotifRefusedError, PAGINATE_FUNCTIONS, REFUSED_ELEMENTS, RequiredSlotsRefusedError, SlotFillRefusedError, SlotFillsConflictError, SlotFillsRefusedError, UNICODE_RANGE_CLEARANCE, UnmeasuredSlotsRefusedError, assertSingleSlotCopy, assertSlotPrintOptions, base64ToBytes, bindingNames, bindingRoot, bookDocument, bookPrintPart, bookStylesheet, bookView, bookViewFromHtml, bytesToBase64, classify, collectSlotPrintCopies, documentLanguage, embedFunction, expandMotifs, fill, fillBookFurniture, findActiveContent, fontCss, fontFaceCss, fontFormat, fontReferenceRefusals, furnitureScript, hasBindings, hasMotifPlacement, hasSlotWork, heldPageNumber, isSlotCopyRefusal, libraryMotifPlacementRefusal, mergeSlotFitResults, motifPlacementRefusals, openerPageIndex, pageIndexForTarget, paginateBook, paginateScript, parseBookPositionKey, parseUnicodeRange, planBookPages, planPrintedPages, prepareSlotCollection, prepareSlots, printedPageAt, renderMotifPlacements, requiredSlotRefusal, sanitize, sanitizeBookCss, searchText, selectBookParent, slotFillCopyId, slotFillRefusal, slotFillsConflict, unmeasuredSlotRefusal, windowPageIndex };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@segnavia/html",
-  "version": "0.36.0",
+  "version": "0.37.0",
   "type": "module",
   "license": "MIT",
   "repository": {
@@ -26,7 +26,7 @@
     }
   },
   "dependencies": {
-    "@segnavia/format": "0.36.0",
+    "@segnavia/format": "0.37.0",
     "dom-serializer": "^2.0.0",
     "domhandler": "^5.0.3",
     "htmlparser2": "^10.0.0",