@segnavia/html 0.37.0 → 0.39.0

package/dist/book/book-contents.js

@@ -0,0 +1,33 @@
+import { element, linkChildren, text } from "./dom.js";
+import { isTag } from "domhandler";
+import { resolveDirection } from "@segnavia/format";
+//#region src/book/book-contents.ts
+function contentsList(book, headings, options) {
+	const entries = headings.map((heading) => {
+		const page = book.contents.pageNumbers ? options.pageNumbers?.[heading.id] ?? "" : "";
+		const level = heading.level + (heading.depth ?? 0);
+		const attributes = {
+			class: "segnavia-contents-entry",
+			"data-level": String(level),
+			...heading.depth === void 0 ? {} : { "data-depth": String(heading.depth) }
+		};
+		return element("li", attributes, [element("a", {
+			href: options.crossLinks ? `segnavia:target/${heading.id}` : `#${heading.id}`,
+			dir: resolveDirection(book.dir, book.lang, heading.text)
+		}, [text(heading.text)]), book.contents.pageNumbers ? element("a", {
+			class: "segnavia-contents-page",
+			href: `#${heading.id}`,
+			"data-ref": "page"
+		}, [text(page)]) : element("span", { class: "segnavia-contents-page" }, [])]);
+	});
+	return element("ol", { class: "segnavia-contents-list" }, entries);
+}
+function addContents(book, section, headings, options) {
+	const title = section.info.title;
+	const titleNode = section.node.children.find((child) => isTag(child) && child.name === "h1");
+	if (title !== void 0 && titleNode && isTag(titleNode)) titleNode.attribs.dir = resolveDirection(book.dir, book.lang, title);
+	section.node.children.push(contentsList(book, headings, options));
+	linkChildren(section.node);
+}
+//#endregion
+export { addContents };

package/dist/book/book-document-nodes.js

@@ -0,0 +1,37 @@
+import { elements } from "../sanitize.js";
+import { element, text } from "./dom.js";
+//#region src/book/book-document-nodes.ts
+function targetLinks(sections) {
+	const ids = sections.flatMap((section) => [section.info.id, ...elements(section.node.children).flatMap((node) => node.attribs.id ? [node.attribs.id] : [])]);
+	return element("div", {
+		class: "segnavia-targets",
+		"aria-hidden": "true"
+	}, [...new Set(ids)].map((id) => element("a", {
+		href: `#${id}`,
+		tabindex: "-1"
+	}, [text("​")])));
+}
+function notesGalley(series, paragraphs) {
+	const notes = paragraphs.map((paragraph) => element("div", { "data-segnavia-note": paragraph.attribs.id ?? "" }, [paragraph]));
+	return element("aside", {
+		"data-segnavia-notes-galley": "",
+		"data-segnavia-note-series": series,
+		"aria-hidden": "true"
+	}, notes);
+}
+function notesGalleys(series, paragraphs) {
+	return series.flatMap((item) => {
+		const held = paragraphs.get(item.name);
+		return item.placement === "page" && held?.length ? [notesGalley(item.name, held)] : [];
+	});
+}
+function withBlankPages(sections, blankBefore) {
+	const counts = /* @__PURE__ */ new Map();
+	for (const id of blankBefore ?? []) counts.set(id, (counts.get(id) ?? 0) + 1);
+	return sections.flatMap((section) => [...Array.from({ length: counts.get(section.info.id) ?? 0 }, () => element("div", {
+		class: "segnavia-blank",
+		"aria-hidden": "true"
+	})), section.node]);
+}
+//#endregion
+export { notesGalleys, targetLinks, withBlankPages };

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

@@ -1,4 +1,6 @@
 import { BookDocument, BookDocumentOptions } from "./types.js";
+import "./book-held.js";
+import "./notes.js";
 import { Book } from "@segnavia/format";
 //#region src/book/book-document.d.ts
 export declare function bookDocument(book: Book, options?: BookDocumentOptions): BookDocument;

package/dist/book/book-document.js

@@ -1,29 +1,16 @@
 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";
+import { addContents } from "./book-contents.js";
+import { notesGalleys, targetLinks, withBlankPages } from "./book-document-nodes.js";
+import { bookDocumentCss, bookFlowPageGeometry, markBlockPositions, resolveBookBuild } from "./book-flow.js";
+import { authoredSection, collectHeadings, designedSection, flowAttribs, markPlacementIssues, sectionNode, templateHolders, templateRegionIssues, templatedSection, templatedSectionIssues } from "./book-held.js";
+import { pageReferenceNodes, pageReferenceTarget, pageReferenceTargets } from "./book-page-reference.js";
+import { duplicateIdIssues, pageReferenceIssues, reservedIdIssues } from "./book-issues.js";
+import { addPart, attachPendingPartHeadings, partNames } from "./book-part-build.js";
+import { noteState, transformNotes } from "./notes.js";
 import { bookPrintPart } from "./types.js";
-import { isTag } from "domhandler";
-import { isBookContents, isDesignedSection, isTemplatedSection, noteMarkerIssues, resolveDirection } from "@segnavia/format";
+import { bookSections, isBookContents, isDesignedSection, isPart, isTemplatedSection, noteMarkerIssues, resolveDirection } from "@segnavia/format";
 //#region src/book/book-document.ts
-function direction(book, value) {
-	return resolveDirection(book.dir, book.lang, value);
-}
-function authoredSection(section, id, build) {
-	const document = parse(section.html);
-	const runningHead = section.title;
-	const node = sectionNode("front", id, document.children, build, runningHead, flowAttribs(section.opens, section.parents));
-	return {
-		info: {
-			id,
-			kind: "front",
-			title: section.title,
-			runningHead
-		},
-		node
-	};
-}
 function contentsSection(entry, build) {
 	const id = "segnavia-contents";
 	const title = entry.title;
@@ -35,13 +22,14 @@ function contentsSection(entry, build) {
 		info: {
 			id,
 			kind: "contents",
+			division: "front",
 			title,
 			runningHead: title
 		},
 		node: sectionNode("contents", id, children, build, title, flowAttribs(entry.opens, entry.parents))
 	};
 }
-function chapterSection(chapter, index, build) {
+function chapterSection(chapter, index, division, build) {
 	const id = `segnavia-chapter-${index}`;
 	const document = parse(chapter.html);
 	const runningHead = chapter.runningHead ?? chapter.title;
@@ -49,80 +37,40 @@ function chapterSection(chapter, index, build) {
 		info: {
 			id,
 			kind: "chapter",
+			division,
 			title: chapter.title,
 			runningHead
 		},
 		node: sectionNode("chapter", id, document.children, build, runningHead, flowAttribs(chapter.opens, chapter.parents))
 	};
 }
-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, build === "galley", notesOwner);
+function appendDesigned(entry, id, kind, book, build, sectionEntry) {
+	const held = designedSection(entry, id, kind, sectionEntry.division, build.build, book.contents.depth, build.build === "flow" ? bookFlowPageGeometry(book) : void 0);
+	build.sections.push(held.built);
+	decorateSection(sectionEntry, build);
+	build.issues.push(...reservedIdIssues(held.built), ...columnIssues(held.built));
+	build.headings.push(...withSectionDepth(held.headings, sectionEntry.depth));
+	const context = noteContext(sectionEntry, held.built.info.id, 0, entry.title, build);
+	transformNotes(held.built.node, book, context, build.notes, build.build === "galley");
 }
-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, build, sectionEntry) {
+	const held = templatedSection(entry, id, kind, sectionEntry.division, build.build, book.contents.depth, build.templates, build.build === "flow" ? bookFlowPageGeometry(book) : void 0);
+	build.sections.push(held.built);
+	decorateSection(sectionEntry, build);
+	build.issues.push(...reservedIdIssues(held.built), ...columnIssues(held.built), ...templatedSectionIssues(entry, id, build.templates));
+	build.headings.push(...withSectionDepth(held.headings, sectionEntry.depth));
+	const context = noteContext(sectionEntry, held.built.info.id, 0, entry.title, build);
+	transformNotes(held.built.node, book, context, build.notes, build.build === "galley");
 }
-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 withSectionDepth(headings, depth) {
+	return depth > 0 ? headings.map((heading) => ({
+		...heading,
+		depth
+	})) : headings;
 }
 function chapterHeadings(section, chapter, depth) {
 	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) => {
-		const page = book.contents.pageNumbers ? options.pageNumbers?.[heading.id] ?? "" : "";
-		return element("li", {
-			class: "segnavia-contents-entry",
-			"data-level": String(heading.level)
-		}, [element("a", {
-			href: options.crossLinks ? `segnavia:target/${heading.id}` : `#${heading.id}`,
-			dir: direction(book, heading.text)
-		}, [text(heading.text)]), element("span", {
-			class: "segnavia-contents-page",
-			"data-target": heading.id,
-			dir: direction(book, page)
-		}, [text(page)])]);
-	});
-	return element("ol", { class: "segnavia-contents-list" }, entries);
-}
-function addContents(book, section, headings, options) {
-	const title = section.info.title;
-	const titleNode = section.node.children.find((child) => isTag(child) && child.name === "h1");
-	if (title !== void 0 && titleNode && isTag(titleNode)) titleNode.attribs.dir = direction(book, title);
-	section.node.children.push(contentsList(book, headings, options));
-	linkChildren(section.node);
-}
-function targetLinks(sections) {
-	const ids = sections.flatMap((section) => [section.info.id, ...elements(section.node.children).flatMap((node) => node.attribs.id ? [node.attribs.id] : [])]);
-	return element("div", {
-		class: "segnavia-targets",
-		"aria-hidden": "true"
-	}, [...new Set(ids)].map((id) => element("a", { href: `#${id}` }, [text("​")])));
-}
-function duplicateIdIssues(sections, headings) {
-	const listed = new Set(headings.map((heading) => heading.id));
-	const occurrences = /* @__PURE__ */ new Map();
-	for (const section of sections) {
-		const ids = [section.info.id, ...elements(section.node.children).flatMap((node) => node.attribs.id ? [node.attribs.id] : [])];
-		for (const id of ids) occurrences.set(id, [...occurrences.get(id) ?? [], section.info]);
-	}
-	return [...occurrences].flatMap(([id, owners]) => {
-		if (!listed.has(id) || owners.length < 2) return [];
-		const named = owners.slice(0, 2).map((owner) => `${owner.title ?? owner.id} (${owner.id})`);
-		return [`destination id ${id} is used in both ${named[0]} and ${named[1]}; listed heading and generated destination ids must be unique`];
-	});
-}
-function reservedIdIssues(section) {
-	return elements(section.node.children).flatMap((node) => {
-		const id = node.attribs.id;
-		if (!id?.startsWith("segnavia-")) return [];
-		return [`authored id ${id} in ${section.info.title ?? section.info.id} (${section.info.id}) uses the reserved segnavia- prefix`];
-	});
-}
 function columnsValueOk(value) {
 	if (!/^[0-9]+$/.test(value)) return false;
 	const count = Number(value);
@@ -136,112 +84,171 @@ function columnIssues(section) {
 		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;
+function notesHeading(book, notes) {
 	return element("h1", {
-		class: "segnavia-endnotes-title",
-		dir: direction(book, titleValue)
-	}, [text(titleValue)]);
+		class: notes.series.titleClass,
+		dir: resolveDirection(book.dir, book.lang, notes.series.title)
+	}, [text(notes.series.title)]);
 }
-function endnotesSection(book, paragraphs, build, id, runningHead, opens) {
+function notesSection(book, notes, build, id, runningHead, parts, opens) {
+	const scope = notes.scopeTitle !== void 0 && (notes.series.placement === "chapter" || notes.series.placement === "part") ? [element("p", {
+		class: "segnavia-notes-scope",
+		dir: resolveDirection(book.dir, book.lang, notes.scopeTitle)
+	}, [text(notes.scopeTitle)])] : [];
 	return {
 		info: {
 			id,
 			kind: "endnotes",
-			title: book.endnotes.title,
+			division: notes.targetId === "book" ? "body" : notes.division,
+			title: notes.series.title,
 			runningHead
 		},
-		node: sectionNode("endnotes", id, [endnotesHeading(book), ...paragraphs], build, runningHead, opens ? flowAttribs(opens) : {})
+		node: sectionNode("endnotes", id, [
+			notesHeading(book, notes),
+			...scope,
+			...notes.paragraphs
+		], build, runningHead, {
+			...opens ? flowAttribs(opens) : {},
+			...parts ? { "data-segnavia-parts": JSON.stringify(parts) } : {}
+		})
 	};
 }
-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);
-	return sections.flatMap((section) => [...Array.from({ length: counts.get(section.info.id) ?? 0 }, () => element("div", {
-		class: "segnavia-blank",
-		"aria-hidden": "true"
-	})), section.node]);
-}
-function takeHeldNotesOwner(build) {
-	build.heldNotesOwner -= 1;
-	return build.heldNotesOwner;
+function decorateSection(sectionEntry, build) {
+	const section = build.sections.at(-1);
+	if (!section) return;
+	if (sectionEntry.ancestry.length > 0) section.node.attribs["data-segnavia-parts"] = JSON.stringify(partNames(sectionEntry.ancestry));
+	attachPendingPartHeadings(build, sectionEntry, section.info.id);
 }
-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.build, id, runningHead, "any"));
+function noteContext(sectionEntry, targetId, chapter, title, build) {
+	const ancestry = sectionEntry.ancestry.at(-1);
+	for (const part of sectionEntry.ancestry) build.partTargets.set(part.id, targetId);
+	return {
+		chapter,
+		title,
+		division: sectionEntry.division,
+		targetId,
+		...chapter === 0 && sectionEntry.division !== "front" ? { placementKey: targetId.replace(/^segnavia-/, "") } : {},
+		...ancestry ? { part: {
+			id: ancestry.id,
+			title: ancestry.title
+		} } : {}
+	};
 }
 function addFrontMatter(book, build) {
 	let contents;
 	let frontNumber = 0;
-	for (const entry of book.frontMatter) {
+	for (const sectionEntry of bookSections(book)) {
+		if (sectionEntry.division !== "front") continue;
+		const { entry } = sectionEntry;
+		if (isPart(entry)) {
+			addPart(sectionEntry, build);
+			continue;
+		}
 		if (isBookContents(entry)) {
 			contents = contentsSection(entry, build.build);
 			build.sections.push(contents);
+			decorateSection(sectionEntry, build);
 			continue;
 		}
 		if (isDesignedSection(entry)) {
 			build.designedNumber += 1;
-			appendDesigned(entry, `segnavia-designed-${build.designedNumber}`, "front", book, build.build, build.notes, build.sections, build.headings, build.issues);
+			appendDesigned(entry, `segnavia-designed-${build.designedNumber}`, "front", book, build, sectionEntry);
 			continue;
 		}
 		if (isTemplatedSection(entry)) {
 			build.templatedNumber += 1;
-			appendTemplated(entry, `segnavia-templated-${build.templatedNumber}`, "front", book, build.build, build.notes, build.templates, build.sections, build.headings, build.issues);
+			appendTemplated(entry, `segnavia-templated-${build.templatedNumber}`, "front", book, build, sectionEntry);
 			continue;
 		}
+		if (!("html" in entry)) continue;
 		frontNumber += 1;
 		const section = authoredSection(entry, `segnavia-front-${frontNumber}`, build.build);
 		build.sections.push(section);
+		decorateSection(sectionEntry, build);
 		build.issues.push(...reservedIdIssues(section), ...columnIssues(section));
-		if (entry.contents && entry.title !== void 0) build.headings.push({
+		if ("contents" in entry && entry.contents && entry.title !== void 0) build.headings.push(...withSectionDepth([{
 			id: section.info.id,
 			level: 1,
 			text: entry.title,
 			sectionId: section.info.id
-		});
-		transformNotes(section.node, book, 0, build.notes, build.build === "galley");
+		}], sectionEntry.depth));
+		transformNotes(section.node, book, noteContext(sectionEntry, section.info.id, 0, entry.title, build), build.notes, build.build === "galley");
 	}
 	return contents;
 }
-function addChapters(book, build) {
-	let chapterNumber = 0;
-	for (const entry of book.chapters) {
+function addChapters(book, build, division = "body") {
+	for (const sectionEntry of bookSections(book)) {
+		if (sectionEntry.division !== division) continue;
+		const { entry } = sectionEntry;
+		if (isPart(entry)) {
+			addPart(sectionEntry, build);
+			continue;
+		}
+		if (isBookContents(entry)) continue;
 		if (isDesignedSection(entry)) {
 			build.designedNumber += 1;
-			const owner = takeHeldNotesOwner(build);
-			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);
+			appendDesigned(entry, `segnavia-designed-${build.designedNumber}`, "designed", book, build, sectionEntry);
 			continue;
 		}
 		if (isTemplatedSection(entry)) {
 			build.templatedNumber += 1;
-			const owner = takeHeldNotesOwner(build);
-			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);
+			appendTemplated(entry, `segnavia-templated-${build.templatedNumber}`, "templated", book, build, sectionEntry);
 			continue;
 		}
-		chapterNumber += 1;
-		const section = chapterSection(entry, chapterNumber, build.build);
+		if (!("html" in entry)) continue;
+		build.chapterNumber += 1;
+		const section = chapterSection(entry, build.chapterNumber, sectionEntry.division, build.build);
 		build.sections.push(section);
+		decorateSection(sectionEntry, build);
 		build.issues.push(...reservedIdIssues(section), ...columnIssues(section));
-		build.headings.push({
+		if (entry.title !== void 0) build.headings.push(...withSectionDepth([{
 			id: section.info.id,
 			level: 1,
 			text: entry.title,
 			sectionId: section.info.id
-		}, ...chapterHeadings(section, chapterNumber, book.contents.depth));
-		transformNotes(section.node, book, chapterNumber, build.notes, build.build === "galley");
-		pushChapterEndnotes(book, build, `segnavia-endnotes-${chapterNumber}`, chapterNumber);
+		}], sectionEntry.depth));
+		build.headings.push(...withSectionDepth(chapterHeadings(section, build.chapterNumber, book.contents.depth), sectionEntry.depth));
+		transformNotes(section.node, book, noteContext(sectionEntry, section.info.id, build.chapterNumber, entry.title, build), build.notes, build.build === "galley");
+	}
+}
+function collectedSectionId(notes) {
+	const prefix = notes.series.sectionIdPrefix;
+	if (notes.targetId === "book") return prefix;
+	if (notes.series.placement === "part") return `${prefix}-${notes.placementKey.replace(/^segnavia-/, "")}`;
+	if (notes.series.placement === "chapter" && notes.targetId.startsWith("segnavia-chapter-")) return `${prefix}-${notes.targetId.slice(17)}`;
+	return `${prefix}-${notes.targetId.replace(/^segnavia-/, "")}`;
+}
+function insertCollectedSections(book, build) {
+	const order = new Map(book.notes.map((series, index) => [series.name, index]));
+	const collected = [...build.notes.collected.values()].sort((left, right) => (order.get(left.series.name) ?? 0) - (order.get(right.series.name) ?? 0));
+	for (const notes of [...collected].reverse()) {
+		if (notes.targetId === "book") continue;
+		const targetId = notes.series.placement === "part" ? build.partTargets.get(notes.placementKey) ?? notes.targetId : notes.targetId;
+		notes.targetId = targetId;
+		const index = build.sections.findIndex(({ info }) => info.id === targetId);
+		if (index < 0) {
+			build.issues.push(`note series ${notes.series.name} could not find placement target ${targetId}; keep the owning section in the book`);
+			continue;
+		}
+		const owner = build.sections[index];
+		const parts = owner?.node.attribs["data-segnavia-parts"];
+		build.sections.splice(index + 1, 0, notesSection(book, notes, build.build, collectedSectionId(notes), owner?.info.runningHead, parts ? JSON.parse(parts) : void 0, "any"));
+	}
+	for (const notes of collected) {
+		if (notes.targetId !== "book") continue;
+		const index = build.sections.findIndex(({ info }) => info.division === "end");
+		build.sections.splice(index < 0 ? build.sections.length : index, 0, notesSection(book, notes, build.build, collectedSectionId(notes), notes.series.title));
+	}
+}
+function writePageReferenceNumbers(book, roots, options) {
+	for (const node of pageReferenceNodes(roots)) {
+		const id = pageReferenceTarget(node.attribs);
+		if (!id) continue;
+		const page = options.pageNumbers?.[id] ?? "";
+		node.children = [text(page)];
+		node.attribs.dir = resolveDirection(book.dir, book.lang, page);
+		if (options.crossLinks) node.attribs.href = `segnavia:target/${id}`;
+		linkChildren(node);
 	}
 }
 function bookDocument(book, options = {}) {
@@ -255,24 +262,40 @@ function bookDocument(book, options = {}) {
 		templates: new Map(book.templates.map((template) => [template.name, template])),
 		designedNumber: 0,
 		templatedNumber: 0,
-		heldNotesOwner: 0
+		chapterNumber: 0,
+		partTargets: /* @__PURE__ */ new Map(),
+		pendingPartHeadings: []
 	};
 	const contents = addFrontMatter(book, build);
 	addChapters(book, build);
+	addChapters(book, build, "end");
 	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, requestedBuild, "segnavia-endnotes", book.endnotes.title));
-	} else if (notes.endnotes) sections.push(endnotesSection(book, endnotesInOrder(notes), requestedBuild, "segnavia-endnotes", book.endnotes.title));
+	insertCollectedSections(book, build);
 	if (contents) addContents(book, contents, headings, options);
+	const noteGalleys = notesGalleys(book.notes, notes.pageParagraphs);
+	const scopes = [...sections.map((section) => ({
+		owner: `${section.info.title ?? section.info.id} (${section.info.id})`,
+		roots: [section.node]
+	})), ...noteGalleys.map((galley) => ({
+		owner: `page-placed note series ${galley.attribs["data-segnavia-note-series"] ?? ""}`,
+		roots: [galley]
+	}))];
+	const referenceIssues = pageReferenceIssues(sections, scopes);
+	const referenceRoots = scopes.flatMap((scope) => scope.roots);
+	const referenceTargets = pageReferenceTargets(referenceRoots);
+	writePageReferenceNumbers(book, referenceRoots, options);
 	if (requestedBuild !== "print") markBlockPositions(sections);
-	const visible = sections.filter((section) => options.part === void 0 || bookPrintPart(section.info.kind) === options.part);
+	const visible = sections.filter((section) => options.part === void 0 || bookPrintPart(section.info.division) === options.part);
 	const document = parse("");
-	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)] : []
-	])] : [
+	document.children = requestedBuild === "galley" ? [
+		element("style", {}, [text(bookDocumentCss(book, requestedBuild))]),
+		...options.targets ? [targetLinks(visible)] : [],
+		element("div", { "data-segnavia-galleys": "" }, [
+			...templateHolders(book.templates),
+			...visible.map((section) => section.node),
+			...noteGalleys
+		])
+	] : [
 		element("style", {}, [text(bookDocumentCss(book, requestedBuild))]),
 		...options.targets ? [targetLinks(visible)] : [],
 		...withBlankPages(visible, options.blankBefore)
@@ -282,16 +305,16 @@ function bookDocument(book, options = {}) {
 		html: serialize(document),
 		sections: sections.map((section) => section.info),
 		headings,
+		pageReferenceTargets: referenceTargets,
 		issues: [
 			...buildIssue ? [buildIssue] : [],
-			...noteMarkerIssues(book, {
-				footnotes: notes.footnotes,
-				endnotes: notes.endnotes
-			}),
+			...noteMarkerIssues(book.notes, notes.used),
+			...notes.issues,
 			...markPlacementIssues(book.parentPages),
-			...templateRegionNameIssues(book.templates),
+			...templateRegionIssues(book.templates),
 			...issues,
-			...duplicateIdIssues(sections, headings)
+			...duplicateIdIssues(sections, headings),
+			...referenceIssues
 		]
 	};
 }

package/dist/book/book-flow.js

@@ -1,12 +1,24 @@
 import { isTag } from "domhandler";
-import { PX_PER_MM, sheetMm } from "@segnavia/format";
+import { MAX_PART_DEPTH, PX_PER_MM, bookSections, isPart, 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}`;
+const CONTENTS_INDENTS = Array.from({ length: 5 }, (_, index) => index + 2).map((level) => `:where(.segnavia-contents-entry[data-level="${level}"]){padding-inline-start:${level - 1}em}`).join("");
+const DEEP_CONTENTS_INDENTS = Array.from({ length: MAX_PART_DEPTH }, (_, index) => index + 7).map((level) => `:where(.segnavia-contents-entry[data-level="${level}"]){padding-inline-start:${level - 1}em}`).join("");
+const CONTENTS_PREFIX = `: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([data-ref="page"]){unicode-bidi:isolate}${CONTENTS_INDENTS}`;
+const CONTENTS_SUFFIX = ":where(.segnavia-targets){position:absolute;inline-size:1px;block-size:1px;overflow:hidden;clip-path:inset(50%)}";
+const GALLEY_SUFFIX = ":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 hasParts(book) {
+	return bookSections(book).some(({ entry }) => isPart(entry));
+}
+function contentsCss(book) {
+	return `${CONTENTS_PREFIX}${hasParts(book) ? DEEP_CONTENTS_INDENTS : ""}${CONTENTS_SUFFIX}`;
+}
+function printCss(book) {
+	const breaks = hasParts(book) ? ".segnavia-part,.segnavia-chapter,.segnavia-endnotes,.segnavia-blank" : ".segnavia-chapter,.segnavia-endnotes,.segnavia-blank";
+	return `${contentsCss(book)}@media print{:where(.segnavia-front,.segnavia-contents)~:where(.segnavia-front,.segnavia-contents),:where(${breaks}){break-before:page}:where(.segnavia-blank){break-after:page}}`;
+}
 function bookFlowPageGeometry(book) {
 	if (!book.page) return void 0;
 	const paper = sheetMm(book.page);
@@ -28,7 +40,7 @@ function columnFallbacks(gap) {
 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)}`;
+	return `${contentsCss(book)}: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");
@@ -39,8 +51,8 @@ function resolveBookBuild(book, requested) {
 	};
 }
 function bookDocumentCss(book, build) {
-	if (build === "galley") return GALLEY_CSS;
-	return build === "flow" ? flowCss(book) : PRINT_CSS;
+	if (build === "galley") return `${contentsCss(book)}${GALLEY_SUFFIX}`;
+	return build === "flow" ? flowCss(book) : printCss(book);
 }
 function flowPageStyle(geometry, recto) {
 	const marginInlineStart = recto ? geometry.marginInlineStartRecto : geometry.marginInlineStartVerso;
@@ -61,12 +73,16 @@ function parseBookPositionKey(value) {
 function isFootnoteBlock(node) {
 	return (node.attribs.class ?? "").split(/\s+/).includes("segnavia-footnotes");
 }
+function isNotesScope(node) {
+	return (node.attribs.class ?? "").split(/\s+/).includes("segnavia-notes-scope");
+}
 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 (isNotesScope(child)) continue;
 			if (isFootnoteBlock(child)) {
 				child.attribs["data-segnavia-position"] = bookBlockPosition(section.info.id, position, "footnotes");
 				continue;

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

@@ -0,0 +1,4 @@
+import "./book-flow.js";
+import "./dom.js";
+import { Element } from "domhandler";
+import { Book, BookSectionParents } from "@segnavia/format";