@segnavia/format 0.37.0 → 0.38.0

package/dist/book.js

@@ -3,8 +3,9 @@ import { Scripts } from "./scripts.js";
 import { Slots } from "./slots.js";
 import { FontReference } from "./fonts.js";
 import { NoteMarker, NumberSystem, isHebrew } from "./numbering.js";
-import { ParentPage, bookParentPages } from "./printed-pages.js";
-import { BookChapterEntry, BookContents, BookFrontMatterEntry, BookOpens, BookSection, BookSectionParents, BookTemplate, Chapter, DesignedPage, DesignedSection, REGION_NAME, TemplatedPage, TemplatedSection, bookParentIssues, isBookContents, isChapter, isDesignedSection, isTemplatedSection } from "./book-section.js";
+import { ParentPage, bookParentPages, flowingParentNames, resolveParentPages, textArea } from "./printed-pages.js";
+import { BookChapterEntry, BookContents, BookFrontMatterEntry, BookItem, BookOpens, BookSection, BookSectionParents, BookTemplate, Chapter, DesignedPage, DesignedSection, MAX_PART_DEPTH, Part, REGION_NAME, TemplatedPage, TemplatedSection, bookParentIssues, bookSections, isBookContents, isChapter, isDesignedSection, isPart, isTemplatedSection } from "./book-section.js";
+import { NoteSeries, noteSeriesIssues, resolveNoteSeries } from "./note-series.js";
 import { Orientation, Paper, sheetMm } from "./paper.js";
 import { z } from "zod";
 //#region src/book.ts
@@ -20,23 +21,31 @@ const BookPage = z.object({
 	}),
 	columnGap: z.number().nonnegative().default(4)
 });
-const BookRunningHeadSource = z.union([z.literal("title"), z.object({
-	mark: z.string().min(1),
-	which: z.enum(["first", "last"])
-})]);
+const BookRunningHeadSource = z.union([
+	z.literal("title"),
+	z.object({
+		mark: z.string().min(1),
+		which: z.enum(["first", "last"])
+	}),
+	z.object({ part: z.string().regex(REGION_NAME) })
+]);
 const BookRunningHead = z.object({
 	recto: BookRunningHeadSource.default("title"),
 	verso: BookRunningHeadSource.default("title")
 });
 const BookShape = z.object({
 	title: z.string(),
+	authors: z.array(z.string()).optional(),
+	subject: z.string().optional(),
 	mode: BookMode,
 	page: BookPage.optional(),
 	scripts: Scripts.default("refuse"),
 	dir: Direction.optional(),
 	lang: z.string().optional(),
-	frontMatter: z.array(BookFrontMatterEntry).default([]),
-	chapters: z.array(BookChapterEntry).min(1),
+	frontMatter: z.array(BookItem).default([]),
+	body: z.array(BookItem).optional(),
+	endMatter: z.array(BookItem).default([]),
+	chapters: z.array(BookChapterEntry).optional(),
 	parentPages: z.array(ParentPage).default([]),
 	templates: z.array(BookTemplate).default([]),
 	slots: Slots.optional(),
@@ -55,6 +64,7 @@ const BookShape = z.object({
 		placement: z.enum(["book", "chapter"]).default("book"),
 		title: z.string().optional()
 	}).default({ placement: "book" }),
+	notes: z.array(NoteSeries).default([]),
 	rectoOpenings: z.boolean().default(false),
 	orphans: z.number().int().min(1).default(2),
 	widows: z.number().int().min(1).default(2),
@@ -106,31 +116,123 @@ const BookView = BookShape.pick({
 	flow: z.string().optional(),
 	pagination: BookViewPagination.optional()
 });
-const Book = BookShape.transform((book) => {
+const ResolvedBook = BookShape.superRefine((book, ctx) => {
+	const seen = /* @__PURE__ */ new Set();
+	book.notes.forEach(({ name }, index) => {
+		if (seen.has(name)) ctx.addIssue({
+			code: "custom",
+			path: [
+				"notes",
+				index,
+				"name"
+			],
+			message: `note series ${name} is duplicated; give every series a unique name`
+		});
+		seen.add(name);
+		if (name !== "footnote" && name !== "endnote") {
+			if (book.notes[index]?.placement === void 0) ctx.addIssue({
+				code: "custom",
+				path: [
+					"notes",
+					index,
+					"placement"
+				],
+				message: `note series ${name} needs placement`
+			});
+			if (book.notes[index]?.numbering === void 0) ctx.addIssue({
+				code: "custom",
+				path: [
+					"notes",
+					index,
+					"numbering"
+				],
+				message: `note series ${name} needs numbering`
+			});
+		}
+	});
+}).transform((book, ctx) => {
 	const hebrew = isHebrew(book.lang);
+	const { chapters, ...fields } = book;
+	if (book.body !== void 0 && chapters !== void 0) {
+		ctx.addIssue({
+			code: "custom",
+			path: ["body"],
+			message: "body and chapters were both given; keep body and remove chapters"
+		});
+		ctx.addIssue({
+			code: "custom",
+			path: ["chapters"],
+			message: "chapters and body were both given; keep body and remove chapters"
+		});
+	}
+	const notes = resolveNoteSeries({
+		lang: book.lang,
+		footnotes: book.footnotes,
+		endnotes: book.endnotes,
+		notes: book.notes
+	});
+	const footnote = notes[0];
+	const endnote = notes[1];
+	if (!footnote || !endnote) throw new Error("note series resolution did not produce the two default series");
 	return {
-		...book,
+		...fields,
+		body: book.body ?? chapters ?? [],
+		bodyKey: book.body === void 0 && chapters !== void 0 ? "chapters" : "body",
 		numbering: {
 			frontMatter: book.numbering.frontMatter ?? (hebrew ? "arabic" : "roman-lower"),
 			body: book.numbering.body ?? (hebrew ? "hebrew" : "arabic")
 		},
 		footnotes: {
 			...book.footnotes,
-			marker: book.footnotes.marker ?? (hebrew ? "hebrew" : "symbols")
+			marker: footnote.marker
 		},
 		endnotes: {
 			...book.endnotes,
-			marker: book.endnotes.marker ?? "arabic",
-			title: book.endnotes.title ?? (hebrew ? "הערות" : "Notes")
-		}
+			marker: endnote.marker,
+			title: endnote.title
+		},
+		notes
 	};
-}).superRefine((book, ctx) => {
-	const contentsPositions = book.frontMatter.flatMap((entry, index) => isBookContents(entry) ? [index + 1] : []);
-	if (contentsPositions.length > 1) ctx.addIssue({
-		code: "custom",
+});
+function partSectionIssues(items, path) {
+	return items.flatMap((entry, index) => {
+		if (!isPart(entry)) return [];
+		const partPath = [...path, index];
+		return [...!(entry.html !== void 0 || bookSections({
+			frontMatter: [],
+			body: entry.children,
+			endMatter: []
+		}).some(({ entry: child }) => !isPart(child) || child.html !== void 0)) ? [{
+			path: partPath,
+			message: `part ${partPath.join(".")} has no section; add html or a section inside it to clear this refusal`
+		}] : [], ...partSectionIssues(entry.children, [...partPath, "children"])];
+	});
+}
+function structuralBookIssues(book) {
+	const issues = [];
+	if (book.body.length === 0) issues.push({
+		path: ["body"],
+		message: "a book needs at least one body entry; add a chapter or part"
+	});
+	issues.push(...partSectionIssues(book.frontMatter, ["frontMatter"]), ...partSectionIssues(book.body, [book.bodyKey]), ...partSectionIssues(book.endMatter, ["endMatter"]));
+	const sections = bookSections(book);
+	for (const section of sections) if (isBookContents(section.entry) && section.division !== "front") issues.push({
+		path: section.path,
+		message: `contents belongs in frontMatter; move this ${section.division} contents entry there`
+	});
+	const paths = sections.flatMap(({ entry, division, path }) => division === "front" && isBookContents(entry) ? [path.join(".")] : []);
+	if (paths.length > 1) issues.push({
 		path: ["frontMatter"],
-		message: `front-matter entries at positions ${contentsPositions[0]} and ${contentsPositions[1]} are both contents entries; one must go`
+		message: `front-matter entries at ${paths[0]} and ${paths[1]} are both contents entries; one must go`
+	});
+	return issues;
+}
+const RefinedBook = ResolvedBook.superRefine((book, ctx) => {
+	for (const issue of structuralBookIssues(book)) ctx.addIssue({
+		code: "custom",
+		...issue
 	});
+	const sections = bookSections(book);
 	if (book.mode === "paginated" && !book.page) ctx.addIssue({
 		code: "custom",
 		path: ["page"],
@@ -141,10 +243,9 @@ const Book = BookShape.transform((book) => {
 		path: ["numbering"],
 		message: `front-matter and body numbering are both ${book.numbering.body}; the two must differ when front matter is present`
 	});
-	if (book.endnotes.placement === "chapter" && book.mode === "continuous") ctx.addIssue({
+	for (const issue of noteSeriesIssues(book.notes, book.mode)) ctx.addIssue({
 		code: "custom",
-		path: ["endnotes", "placement"],
-		message: "endnotes are placed at the end of each chapter only in paginated mode; use book placement or paginated mode"
+		...issue
 	});
 	for (const issue of bookParentIssues(book)) ctx.addIssue({
 		code: "custom",
@@ -152,19 +253,105 @@ const Book = BookShape.transform((book) => {
 	});
 	if (!book.page) return;
 	const trim = sheetMm(book.page);
-	const vertical = book.page.margin.top + book.page.margin.bottom;
-	const horizontal = book.page.margin.inner + book.page.margin.outer;
-	if (vertical >= trim.height) ctx.addIssue({
-		code: "custom",
-		path: ["page", "margin"],
-		message: `the top and bottom margins total ${vertical}mm and the page is ${trim.height}mm high; reduce the vertical margins to leave a text area`
+	const parents = resolveParentPages([...bookParentPages(book.page.margin), ...book.parentPages]);
+	const defaults = new Set(bookParentPages(book.page.margin).map((parent) => parent.name));
+	for (const parent of parents) {
+		const area = textArea(parent, trim);
+		const path = defaults.has(parent.name) ? ["page", "margin"] : ["parentPages"];
+		if (area.height <= 0) {
+			const total = parent.margin.top + parent.margin.bottom;
+			ctx.addIssue({
+				code: "custom",
+				path,
+				message: `parent page "${parent.name}" has top and bottom margins totaling ${total}mm on paper ${trim.height}mm high; reduce the vertical margins to leave a text area`
+			});
+		}
+		if (area.width <= 0) {
+			const total = parent.margin.inner + parent.margin.outer;
+			ctx.addIssue({
+				code: "custom",
+				path,
+				message: `parent page "${parent.name}" has inner and outer margins totaling ${total}mm on paper ${trim.width}mm wide; reduce the horizontal margins to leave a text area`
+			});
+		}
+	}
+	const byName = new Map(parents.map((parent) => [parent.name, parent]));
+	sections.filter(({ entry }) => !isDesignedSection(entry) && !isTemplatedSection(entry)).forEach(({ entry: flow, path }, index) => {
+		const names = flowingParentNames(flow.parents);
+		const widths = Object.entries(names).flatMap(([role, name]) => {
+			const parent = byName.get(name);
+			return parent ? [{
+				role,
+				name,
+				width: textArea(parent, trim).width
+			}] : [];
+		});
+		const first = widths[0];
+		const different = widths.find((candidate) => candidate.width !== first?.width);
+		if (!first || !different) return;
+		const label = flow.title ?? `flow ${index + 1}`;
+		ctx.addIssue({
+			code: "custom",
+			path,
+			message: `the ${label} flow uses parent pages "${first.name}" (${first.width}mm) and "${different.name}" (${different.width}mm) with different text widths; make the widths equal or split the flow into sections to clear this refusal`
+		});
 	});
-	if (horizontal >= trim.width) ctx.addIssue({
+});
+function partDepthIssues(value) {
+	if (typeof value !== "object" || value === null) return [];
+	const input = value;
+	const roots = [
+		["frontMatter", input.frontMatter],
+		["body", input.body],
+		["chapters", input.chapters],
+		["endMatter", input.endMatter]
+	];
+	const stack = [];
+	for (const [key, entries] of roots) {
+		if (!Array.isArray(entries)) continue;
+		entries.forEach((entry, index) => {
+			stack.push({
+				value: entry,
+				path: [key, index],
+				depth: 0
+			});
+		});
+	}
+	const issues = [];
+	while (stack.length > 0) {
+		const current = stack.pop();
+		if (!current || typeof current.value !== "object" || current.value === null || !("name" in current.value)) continue;
+		const depth = current.depth + 1;
+		if (depth > 6) {
+			issues.push({
+				path: current.path,
+				message: `part ${current.path.join(".")} exceeds the maximum part depth of 6; reduce the nesting to clear this refusal`
+			});
+			continue;
+		}
+		const children = current.value.children;
+		if (!Array.isArray(children)) continue;
+		children.forEach((child, index) => {
+			stack.push({
+				value: child,
+				path: [
+					...current.path,
+					"children",
+					index
+				],
+				depth
+			});
+		});
+	}
+	return issues;
+}
+const Book = z.preprocess((value, ctx) => {
+	for (const issue of partDepthIssues(value)) ctx.addIssue({
 		code: "custom",
-		path: ["page", "margin"],
-		message: `the inner and outer margins total ${horizontal}mm and the page is ${trim.width}mm wide; reduce the horizontal margins to leave a text area`
+		...issue
 	});
-});
+	return value;
+}, RefinedBook).transform(({ bodyKey: _bodyKey, ...book }) => book);
 function resolveBookPagination(book) {
 	if (book.mode !== "paginated" || !book.page) return void 0;
 	return {
@@ -182,9 +369,5 @@ function resolveBookPagination(book) {
 		runningHead: book.runningHead
 	};
 }
-function noteMarkerIssues(book, used) {
-	if (!used.footnotes || !used.endnotes || book.footnotes.marker !== book.endnotes.marker) return [];
-	return [`footnote and endnote markers are both ${book.footnotes.marker}; the two must differ when both kinds are used`];
-}
 //#endregion
-export { Book, BookChapterEntry, BookContents, BookFrontMatterEntry, BookMode, BookOpens, BookPage, BookRunningHead, BookRunningHeadSource, BookSection, BookSectionParents, BookShape, BookTemplate, BookView, BookViewPagination, Chapter, DesignedPage, DesignedSection, REGION_NAME, TemplatedPage, TemplatedSection, isBookContents, isChapter, isDesignedSection, isTemplatedSection, noteMarkerIssues, resolveBookPagination };
+export { Book, BookChapterEntry, BookContents, BookFrontMatterEntry, BookItem, BookMode, BookOpens, BookPage, BookRunningHead, BookRunningHeadSource, BookSection, BookSectionParents, BookShape, BookTemplate, BookView, BookViewPagination, Chapter, DesignedPage, DesignedSection, MAX_PART_DEPTH, Part, REGION_NAME, TemplatedPage, TemplatedSection, bookSections, isBookContents, isChapter, isDesignedSection, isPart, isTemplatedSection, resolveBookPagination };

package/dist/dependency-policy.d.ts

@@ -0,0 +1,12 @@
+//#region src/dependency-policy.d.ts
+export type DependencyDecision = {
+  allowed: true;
+  origin: string;
+} | {
+  allowed: false;
+  reason: string;
+};
+export declare function originSet(values: Iterable<string> | undefined, bare?: boolean): Set<string>;
+export declare const dependencyOriginSet: (values: Iterable<string> | undefined) => Set<string>;
+export declare function dependencyDecision(value: string, approved: ReadonlySet<string>): DependencyDecision;
+//#endregion

package/dist/dependency-policy.js

@@ -0,0 +1,42 @@
+//#region src/dependency-policy.ts
+const PACKAGE_PATHS = {
+	"https://cdn.jsdelivr.net": /^\/npm\/(?:@[^/]+\/)?[^/@]+@(\d+\.\d+\.\d+)(?:\/|$)/,
+	"https://unpkg.com": /^\/(?:@[^/]+\/)?[^/@]+@(\d+\.\d+\.\d+)(?:\/|$)/,
+	"https://cdnjs.cloudflare.com": /^\/ajax\/libs\/[^/]+\/(\d+\.\d+\.\d+)(?:\/|$)/
+};
+function originSet(values, bare = false) {
+	const result = /* @__PURE__ */ new Set();
+	for (const value of values ?? []) try {
+		const url = new URL(value);
+		if (url.protocol === "https:" && (!bare || url.pathname === "/" && !url.search && !url.hash)) result.add(url.origin.toLowerCase());
+	} catch {}
+	return result;
+}
+const dependencyOriginSet = (values) => originSet(values, true);
+function dependencyDecision(value, approved) {
+	let url;
+	try {
+		url = new URL(value);
+	} catch {
+		return {
+			allowed: false,
+			reason: `${JSON.stringify(value)} is not an absolute https URL; an absolute URL at an approved origin clears this refusal`
+		};
+	}
+	const origin = url.origin.toLowerCase();
+	if (url.protocol !== "https:" || !approved.has(origin)) return {
+		allowed: false,
+		reason: `${url.href} is not at an approved dependency origin; add ${origin} to dependencyOrigins to clear this refusal`
+	};
+	const shape = PACKAGE_PATHS[origin];
+	if (shape && !shape.test(url.pathname)) return {
+		allowed: false,
+		reason: `${url.href} does not name an exact x.y.z package version; use an exact version to clear this refusal`
+	};
+	return {
+		allowed: true,
+		origin
+	};
+}
+//#endregion
+export { dependencyDecision, dependencyOriginSet, originSet };

package/dist/index.d.ts

@@ -1,3 +1,5 @@
+import { BOOK_PARENT_NAMES, FlowingParentNames, PRINTED_PAGE_LIMIT, PRINTED_PAGE_ROLES, ParentPage, ParentPageMargin, PrintedPageRole, PrintedPageRules, PrintedPages, ResolvedParentPage, TextArea, bookParentPages, flowingParentNames, pagePrintedPagesIssues, parentListIssues, printedPagesIssues, resolveParentPages, textArea } from "./printed-pages.js";
+import { BookChapterEntry, BookContents, BookDivision, BookDivisions, BookFrontMatterEntry, BookItem, BookOpens, BookSection, BookSectionEntry, BookSectionParents, BookTemplate, Chapter, DesignedPage, DesignedSection, MAX_PART_DEPTH, Part, REGION_NAME, TemplatedPage, TemplatedSection, bookSections, isBookContents, isChapter, isDesignedSection, isPart, isTemplatedSection } from "./book-section.js";
 import { Board, BoardInput, BoardItem, BoardLabel, BoardSection, GridCell } from "./board.js";
 import { Annotation, Box, Cue, DECK_SIZE, Deck, DeckInput, DeckLimits, ImageFit, Manifest, Narration, PLAYBACK_MODES, Playback, PlaybackMode, Point, PublishedShot, SHOT_KEY, Shot, Size, Slide, SlideContent, Word, annotationCueIssues, exceedsLimits, parsePlayback } from "./deck.js";
 import { BoardItemAnchor, MIN_BOARD_ITEM_WIDTH, addItem, moveItems, moveSection, removeItems, resizeItem } from "./board-edit.js";
@@ -6,25 +8,27 @@ import { BoardListingGroup, boardListing, boardListingIsEmpty, foldForSearch, na
 import { GridDropTarget, deriveSectionCells, gridDropMarkerBox, gridDropTarget, insertIntoGrid, layoutSection, removeFromGrid } from "./board-section-grid.js";
 import { MAKE_ROOM_LIMIT, SECTION_GAP, SECTION_MIN_SIZE, SECTION_PADDING, SECTION_TITLE_ROOM } from "./board-section-constants.js";
 import { assignMembership, fitSection, fitTouchedSections, makeRoom, settleBoard } from "./board-sections.js";
-import { BOOK_PARENT_NAMES, PRINTED_PAGE_LIMIT, PRINTED_PAGE_ROLES, ParentPage, ParentPageMargin, PrintedPageRole, PrintedPageRules, PrintedPages, ResolvedParentPage, bookParentPages, pagePrintedPagesIssues, parentListIssues, printedPagesIssues, resolveParentPages } from "./printed-pages.js";
-import { BookChapterEntry, BookContents, BookFrontMatterEntry, BookOpens, BookSection, BookSectionParents, BookTemplate, Chapter, DesignedPage, DesignedSection, REGION_NAME, TemplatedPage, TemplatedSection, isBookContents, isChapter, isDesignedSection, isTemplatedSection } from "./book-section.js";
-import { Book, BookInput, BookMode, BookPage, BookRunningHead, BookRunningHeadSource, BookView, BookViewInput, BookViewPagination, noteMarkerIssues, resolveBookPagination } from "./book.js";
+import { NoteMarker, NumberSystem, defaultPageNumbering, formatNumber, isHebrew, noteMarker } from "./numbering.js";
+import { NoteNumbering, NotePlacement, NoteSeries, NoteSeriesInput, ResolvedNoteSeries, noteMarkerIssues, resolveNoteSeries } from "./note-series.js";
+import { Book, BookInput, BookMode, BookPage, BookRunningHead, BookRunningHeadSource, BookView, BookViewInput, BookViewPagination, resolveBookPagination } from "./book.js";
+import "./book-exports.js";
 import { DeckFromSlidesOptions, SlideRow, deckFromSlides } from "./deck-from-slides.js";
 import { Direction, TextDirection, firstStrongDirection, languageDirection, resolveDirection, textDirection } from "./direction.js";
 import { PAPER_FIT_TOLERANCE_MM } from "./imposition-fit.js";
-import { CUSTOM_PAPER_MAX_MM, CUSTOM_PAPER_MIN_MM, FOLD_DASH_OFF_MM, FOLD_DASH_ON_MM, MARK_GAP_MM, MARK_LENGTH_MM, MM_PER_PT, MarkSegment, NAMED_PAPERS, NamedPaper, NamedPaperMetadata, ORIENTATIONS, Orientation, PAPER_GROUPS, PAPER_METADATA, PAPER_MM, PAPER_UNITS, PX_PER_MM, Paper, PaperBox, PaperGroup, PaperUnit, PrintSetting, PrintSettingInput, fromMillimeters, paperPixels, printBoxes, printPadding, printProperties, roundMillimeters, sheetMm, toMillimeters } from "./paper.js";
+import { CUSTOM_PAPER_MAX_MM, CUSTOM_PAPER_MIN_MM, FOLD_DASH_OFF_MM, FOLD_DASH_ON_MM, MARK_GAP_MM, MARK_LENGTH_MM, MM_PER_PT, MarkSegment, NAMED_PAPERS, NamedPaper, NamedPaperMetadata, ORIENTATIONS, Orientation, PAPER_GROUPS, PAPER_METADATA, PAPER_MM, PAPER_UNITS, PX_PER_MM, PX_PER_PT, Paper, PaperBox, PaperGroup, PaperUnit, PrintSetting, PrintSettingInput, fromMillimeters, paperPixels, printBoxes, printPadding, printProperties, roundMillimeters, sheetMm, toMillimeters } from "./paper.js";
 import { FOLD_KINDS, FOLD_TUCK_IN_MM, FoldKind, foldCellPages, foldColumns, foldPageCountMessage, foldPanelMap } from "./fold.js";
 import { APP_FONT_NAME, APP_FONT_NAME_MESSAGE, AppFont, FONT_FORMATS, FONT_GENERICS, FontFace, FontFormat, FontGeneric, FontReference, FontReferenceInput, FontSource, LocalFaceTransport, LocalFacesInput, LocalFacesTransport, localFontReferences } from "./fonts.js";
 import { Imposed, MillimeterEdges, PageFit, PagePlacementKind, PagePlacementLayout, Placement, fitPage, impose, mirrorPlacement, pagePlacementLayout } from "./imposition.js";
 import { ImpositionMarkEdge, ImpositionSideMarks, MIN_MARK_LENGTH_MM, OmittedImpositionMark, impositionMarks } from "./imposition-marks.js";
 import { Lexicon, PronunciationEntry, lexiconVersion } from "./lexicon.js";
+import { LOCAL_FONT_LIMITS, LocalFontLimitFace, LocalFontLimits, localFontLimitRefusal } from "./local-font-limits.js";
 import { BOOK_FURNITURE, BookFurniture, LIBRARY_MOTIF_PREFIX, MOTIF_ATTRIBUTE, Motif, MotifField, MotifFieldInput, MotifInput, MotifPlacement, MotifSource, MotifVersion, MotifVersionChoice, MotifVersionInput, PRINTED_PAGE_CONTEXT, PRINTED_PAGE_FOLIO_PATH, PRINTED_PAGE_NUMBER_PATH, PRINTED_PAGE_RUNNING_HEAD_PATH, PRINTED_PAGE_TOTAL_PATH, chooseMotifVersion, motifFieldAttribute } from "./motif.js";
-import { NoteMarker, NumberSystem, defaultPageNumbering, formatNumber, isHebrew, noteMarker } from "./numbering.js";
 import { isPrintedPageIdentityImposition } from "./printed-page-imposition.js";
 import { Scripts } from "./scripts.js";
 import { ShotUse, shotsUsed } from "./shots-used.js";
 import { MAX_SLIDE_TIMING_MS } from "./timing.js";
 import { DEFAULT_TRANSITION_DURATION_MS, MAX_TRANSITION_DURATION_MS, MIN_TRANSITION_DURATION_MS, Transition, TransitionInput } from "./transition.js";
+import { DependencyDecision, dependencyDecision, dependencyOriginSet, originSet } from "./dependency-policy.js";
 import { Fill, FillValues, SLOT_TYPES, SlotDeclaration, SlotDeclarationInput, SlotKey, SlotReport, SlotSource, SlotState, SlotType, SlotValue, Slots, SlotsInput, SlotsOptions, mergeSlotDeclarations } from "./slots.js";
 import { z } from "zod";
 //#region src/index.d.ts
@@ -452,6 +456,8 @@ export type PageInput = z.input<typeof Page>;
 export declare function jsonSchemas(): {
   book: z.core.ZodStandardJSONSchemaPayload<z.ZodObject<{
     title: z.ZodString;
+    authors: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    subject: z.ZodOptional<z.ZodString>;
     mode: z.ZodEnum<{
       continuous: "continuous";
       paginated: "paginated";
@@ -516,80 +522,10 @@ export declare function jsonSchemas(): {
       auto: "auto";
     }>>;
     lang: z.ZodOptional<z.ZodString>;
-    frontMatter: z.ZodDefault<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
-      pages: z.ZodArray<z.ZodObject<{
-        html: z.ZodString;
-      }, z.core.$strip>>;
-      title: z.ZodOptional<z.ZodString>;
-      contents: z.ZodDefault<z.ZodBoolean>;
-      opens: z.ZodOptional<z.ZodEnum<{
-        any: "any";
-        recto: "recto";
-        verso: "verso";
-      }>>;
-      parents: z.ZodOptional<z.ZodObject<{
-        opener: z.ZodOptional<z.ZodString>;
-        recto: z.ZodOptional<z.ZodString>;
-        verso: z.ZodOptional<z.ZodString>;
-        blank: z.ZodOptional<z.ZodString>;
-        fixed: z.ZodOptional<z.ZodString>;
-      }, z.core.$strip>>;
-      kind: z.ZodLiteral<"designed">;
-    }, z.core.$strip>, z.ZodObject<{
-      template: z.ZodString;
-      pages: z.ZodArray<z.ZodObject<{
-        template: z.ZodOptional<z.ZodString>;
-        regions: z.ZodRecord<z.ZodString, z.ZodString>;
-      }, z.core.$strip>>;
-      title: z.ZodOptional<z.ZodString>;
-      contents: z.ZodDefault<z.ZodBoolean>;
-      opens: z.ZodOptional<z.ZodEnum<{
-        any: "any";
-        recto: "recto";
-        verso: "verso";
-      }>>;
-      parents: z.ZodOptional<z.ZodObject<{
-        opener: z.ZodOptional<z.ZodString>;
-        recto: z.ZodOptional<z.ZodString>;
-        verso: z.ZodOptional<z.ZodString>;
-        blank: z.ZodOptional<z.ZodString>;
-        fixed: z.ZodOptional<z.ZodString>;
-      }, z.core.$strip>>;
-      kind: z.ZodLiteral<"templated">;
-    }, z.core.$strip>, z.ZodObject<{
-      kind: z.ZodLiteral<"contents">;
-      title: z.ZodOptional<z.ZodString>;
-      opens: z.ZodOptional<z.ZodEnum<{
-        any: "any";
-        recto: "recto";
-        verso: "verso";
-      }>>;
-      parents: z.ZodOptional<z.ZodObject<{
-        opener: z.ZodOptional<z.ZodString>;
-        recto: z.ZodOptional<z.ZodString>;
-        verso: z.ZodOptional<z.ZodString>;
-        blank: z.ZodOptional<z.ZodString>;
-        fixed: z.ZodOptional<z.ZodString>;
-      }, z.core.$strip>>;
-    }, z.core.$strip>, z.ZodObject<{
-      title: z.ZodOptional<z.ZodString>;
-      contents: z.ZodDefault<z.ZodBoolean>;
-      opens: z.ZodOptional<z.ZodEnum<{
-        any: "any";
-        recto: "recto";
-        verso: "verso";
-      }>>;
-      parents: z.ZodOptional<z.ZodObject<{
-        opener: z.ZodOptional<z.ZodString>;
-        recto: z.ZodOptional<z.ZodString>;
-        verso: z.ZodOptional<z.ZodString>;
-        blank: z.ZodOptional<z.ZodString>;
-        fixed: z.ZodOptional<z.ZodString>;
-      }, z.core.$strip>>;
-      html: z.ZodString;
-      kind: z.ZodOptional<z.ZodLiteral<"front">>;
-    }, z.core.$strip>], "kind">>>;
-    chapters: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+    frontMatter: z.ZodDefault<z.ZodArray<z.ZodType<BookItem, unknown, z.core.$ZodTypeInternals<BookItem, unknown>>>>;
+    body: z.ZodOptional<z.ZodArray<z.ZodType<BookItem, unknown, z.core.$ZodTypeInternals<BookItem, unknown>>>>;
+    endMatter: z.ZodDefault<z.ZodArray<z.ZodType<BookItem, unknown, z.core.$ZodTypeInternals<BookItem, unknown>>>>;
+    chapters: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
       pages: z.ZodArray<z.ZodObject<{
         html: z.ZodString;
       }, z.core.$strip>>;
@@ -646,7 +582,7 @@ export declare function jsonSchemas(): {
         fixed: z.ZodOptional<z.ZodString>;
       }, z.core.$strip>>;
       kind: z.ZodOptional<z.ZodLiteral<"chapter">>;
-    }, z.core.$strip>], "kind">>;
+    }, z.core.$strip>], "kind">>>;
     parentPages: z.ZodDefault<z.ZodArray<z.ZodObject<{
       name: z.ZodString;
       basedOn: z.ZodOptional<z.ZodString>;
@@ -753,6 +689,27 @@ export declare function jsonSchemas(): {
       }>>;
       title: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>;
+    notes: z.ZodDefault<z.ZodArray<z.ZodObject<{
+      name: z.ZodString;
+      placement: z.ZodOptional<z.ZodEnum<{
+        page: "page";
+        chapter: "chapter";
+        book: "book";
+        part: "part";
+      }>>;
+      numbering: z.ZodOptional<z.ZodEnum<{
+        chapter: "chapter";
+        book: "book";
+        part: "part";
+      }>>;
+      marker: z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<{
+        arabic: "arabic";
+        "roman-lower": "roman-lower";
+        "roman-upper": "roman-upper";
+        hebrew: "hebrew";
+      }>, z.ZodLiteral<"symbols">]>>;
+      title: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
     rectoOpenings: z.ZodDefault<z.ZodBoolean>;
     orphans: z.ZodDefault<z.ZodNumber>;
     widows: z.ZodDefault<z.ZodNumber>;
@@ -763,6 +720,8 @@ export declare function jsonSchemas(): {
           first: "first";
           last: "last";
         }>;
+      }, z.core.$strip>, z.ZodObject<{
+        part: z.ZodString;
       }, z.core.$strip>]>>;
       verso: z.ZodDefault<z.ZodUnion<readonly [z.ZodLiteral<"title">, z.ZodObject<{
         mark: z.ZodString;
@@ -770,6 +729,8 @@ export declare function jsonSchemas(): {
           first: "first";
           last: "last";
         }>;
+      }, z.core.$strip>, z.ZodObject<{
+        part: z.ZodString;
       }, z.core.$strip>]>>;
     }, z.core.$strip>>;
     contents: z.ZodDefault<z.ZodObject<{
@@ -858,6 +819,8 @@ export declare function jsonSchemas(): {
             first: "first";
             last: "last";
           }>;
+        }, z.core.$strip>, z.ZodObject<{
+          part: z.ZodString;
         }, z.core.$strip>]>>;
         verso: z.ZodDefault<z.ZodUnion<readonly [z.ZodLiteral<"title">, z.ZodObject<{
           mark: z.ZodString;
@@ -865,6 +828,8 @@ export declare function jsonSchemas(): {
             first: "first";
             last: "last";
           }>;
+        }, z.core.$strip>, z.ZodObject<{
+          part: z.ZodString;
         }, z.core.$strip>]>>;
       }, z.core.$strip>;
     }, z.core.$strip>>;
@@ -1813,4 +1778,4 @@ export declare function jsonSchemas(): {
   }, z.core.$strict>>;
 };
 //#endregion
-export { APP_FONT_NAME, APP_FONT_NAME_MESSAGE, Annotation, type AppFont, type ArrangeOptions, BOOK_FURNITURE, BOOK_PARENT_NAMES, Board, type BoardInput, BoardItem, type BoardItemAnchor, BoardLabel, type BoardListingGroup, BoardSection, type BoardShapes, type BoardView, Book, BookChapterEntry, BookContents, BookFrontMatterEntry, BookFurniture, type BookInput, BookMode, BookOpens, BookPage, BookRunningHead, BookRunningHeadSource, BookSection, BookSectionParents, BookTemplate, BookView, type BookViewInput, BookViewPagination, Box, CUSTOM_PAPER_MAX_MM, CUSTOM_PAPER_MIN_MM, Chapter, Cue, DECK_SIZE, DEFAULT_TRANSITION_DURATION_MS, Deck, type DeckFromSlidesOptions, type DeckInput, type DeckLimits, DesignedPage, DesignedSection, Direction, FOLD_DASH_OFF_MM, FOLD_DASH_ON_MM, FOLD_KINDS, FOLD_TUCK_IN_MM, FONT_FORMATS, FONT_GENERICS, Fill, FillValues, type FoldKind, type FontFace, type FontFormat, type FontGeneric, FontReference, FontReferenceInput, type FontSource, GridCell, type GridDropTarget, ImageFit, type Imposed, type ImpositionMarkEdge, type ImpositionSideMarks, LIBRARY_MOTIF_PREFIX, Lexicon, LocalFaceTransport, type LocalFacesInput, LocalFacesTransport, MAKE_ROOM_LIMIT, MARK_GAP_MM, MARK_LENGTH_MM, MAX_BOARD_ZOOM, MAX_SLIDE_TIMING_MS, MAX_TRANSITION_DURATION_MS, MIN_BOARD_ITEM_WIDTH, MIN_BOARD_ZOOM, MIN_MARK_LENGTH_MM, MIN_TRANSITION_DURATION_MS, MM_PER_PT, MOTIF_ATTRIBUTE, Manifest, type MarkSegment, type MillimeterEdges, Motif, MotifField, MotifFieldInput, MotifInput, MotifPlacement, MotifSource, MotifVersion, MotifVersionChoice, MotifVersionInput, NAMED_PAPERS, type NamedPaper, type NamedPaperMetadata, Narration, NoteMarker, NumberSystem, ORIENTATIONS, type OmittedImpositionMark, Orientation, PAPER_FIT_TOLERANCE_MM, PAPER_GROUPS, PAPER_METADATA, PAPER_MM, PAPER_UNITS, PLAYBACK_MODES, PRINTED_PAGE_CONTEXT, PRINTED_PAGE_FOLIO_PATH, PRINTED_PAGE_LIMIT, PRINTED_PAGE_NUMBER_PATH, PRINTED_PAGE_ROLES, PRINTED_PAGE_RUNNING_HEAD_PATH, PRINTED_PAGE_TOTAL_PATH, PX_PER_MM, type PageFit, type PagePlacementKind, type PagePlacementLayout, Paper, type PaperBox, type PaperGroup, PaperUnit, ParentPage, ParentPageMargin, type Placement, Playback, type PlaybackMode, Point, PrintSetting, PrintSettingInput, PrintedPageRole, PrintedPageRules, PrintedPages, PronunciationEntry, PublishedShot, REGION_NAME, ResolvedParentPage, SECTION_GAP, SECTION_MIN_SIZE, SECTION_PADDING, SECTION_TITLE_ROOM, SHOT_KEY, SLOT_TYPES, Scripts, Shot, type ShotUse, Size, Slide, SlideContent, type SlideRow, SlotDeclaration, SlotDeclarationInput, SlotKey, SlotReport, SlotSource, SlotState, SlotType, SlotValue, Slots, SlotsInput, SlotsOptions, TemplatedPage, TemplatedSection, TextDirection, Transition, TransitionInput, Word, type ZoomBounds, addItem, annotationCueIssues, arrange, assignMembership, boardBounds, boardListing, boardListingIsEmpty, boardToScreen, bookParentPages, chooseMotifVersion, deckFromSlides, defaultPageNumbering, deriveSectionCells, exceedsLimits, firstStrongDirection, fitPage, fitSection, fitTouchedSections, foldCellPages, foldColumns, foldForSearch, foldPageCountMessage, foldPanelMap, formatNumber, fromMillimeters, gridDropMarkerBox, gridDropTarget, impose, impositionMarks, insertIntoGrid, isBookContents, isChapter, isDesignedSection, isHebrew, isPrintedPageIdentityImposition, isTemplatedSection, itemAt, itemHeight, languageDirection, layoutSection, lexiconVersion, localFontReferences, makeRoom, mergeSlotDeclarations, mirrorPlacement, motifFieldAttribute, moveItems, moveSection, nameMatches, noteMarker, noteMarkerIssues, pagePlacementLayout, pagePrintedPagesIssues, paperPixels, parentListIssues, parsePlayback, printBoxes, printPadding, printProperties, printedPagesIssues, removeFromGrid, removeItems, resizeItem, resolveBookPagination, resolveDirection, resolveParentPages, revealView, roundMillimeters, screenToBoard, settleBoard, sheetMm, shotsUsed, textDirection, toMillimeters, visibleItems, zoomAt, zoomToFit };
+export { APP_FONT_NAME, APP_FONT_NAME_MESSAGE, Annotation, type AppFont, type ArrangeOptions, BOOK_FURNITURE, BOOK_PARENT_NAMES, Board, type BoardInput, BoardItem, type BoardItemAnchor, BoardLabel, type BoardListingGroup, BoardSection, type BoardShapes, type BoardView, Book, BookChapterEntry, BookContents, type BookDivision, type BookDivisions, BookFrontMatterEntry, BookFurniture, type BookInput, BookItem, BookMode, BookOpens, BookPage, BookRunningHead, BookRunningHeadSource, BookSection, type BookSectionEntry, BookSectionParents, BookTemplate, BookView, type BookViewInput, BookViewPagination, Box, CUSTOM_PAPER_MAX_MM, CUSTOM_PAPER_MIN_MM, Chapter, Cue, DECK_SIZE, DEFAULT_TRANSITION_DURATION_MS, Deck, type DeckFromSlidesOptions, type DeckInput, type DeckLimits, type DependencyDecision, DesignedPage, DesignedSection, Direction, FOLD_DASH_OFF_MM, FOLD_DASH_ON_MM, FOLD_KINDS, FOLD_TUCK_IN_MM, FONT_FORMATS, FONT_GENERICS, Fill, FillValues, FlowingParentNames, type FoldKind, type FontFace, type FontFormat, type FontGeneric, FontReference, FontReferenceInput, type FontSource, GridCell, type GridDropTarget, ImageFit, type Imposed, type ImpositionMarkEdge, type ImpositionSideMarks, LIBRARY_MOTIF_PREFIX, LOCAL_FONT_LIMITS, Lexicon, LocalFaceTransport, type LocalFacesInput, LocalFacesTransport, type LocalFontLimitFace, type LocalFontLimits, MAKE_ROOM_LIMIT, MARK_GAP_MM, MARK_LENGTH_MM, MAX_BOARD_ZOOM, MAX_PART_DEPTH, MAX_SLIDE_TIMING_MS, MAX_TRANSITION_DURATION_MS, MIN_BOARD_ITEM_WIDTH, MIN_BOARD_ZOOM, MIN_MARK_LENGTH_MM, MIN_TRANSITION_DURATION_MS, MM_PER_PT, MOTIF_ATTRIBUTE, Manifest, type MarkSegment, type MillimeterEdges, Motif, MotifField, MotifFieldInput, MotifInput, MotifPlacement, MotifSource, MotifVersion, MotifVersionChoice, MotifVersionInput, NAMED_PAPERS, type NamedPaper, type NamedPaperMetadata, Narration, NoteMarker, NoteNumbering, NotePlacement, NoteSeries, type NoteSeriesInput, NumberSystem, ORIENTATIONS, type OmittedImpositionMark, Orientation, PAPER_FIT_TOLERANCE_MM, PAPER_GROUPS, PAPER_METADATA, PAPER_MM, PAPER_UNITS, PLAYBACK_MODES, PRINTED_PAGE_CONTEXT, PRINTED_PAGE_FOLIO_PATH, PRINTED_PAGE_LIMIT, PRINTED_PAGE_NUMBER_PATH, PRINTED_PAGE_ROLES, PRINTED_PAGE_RUNNING_HEAD_PATH, PRINTED_PAGE_TOTAL_PATH, PX_PER_MM, PX_PER_PT, type PageFit, type PagePlacementKind, type PagePlacementLayout, Paper, type PaperBox, type PaperGroup, PaperUnit, ParentPage, ParentPageMargin, Part, type Placement, Playback, type PlaybackMode, Point, PrintSetting, PrintSettingInput, PrintedPageRole, PrintedPageRules, PrintedPages, PronunciationEntry, PublishedShot, REGION_NAME, type ResolvedNoteSeries, ResolvedParentPage, SECTION_GAP, SECTION_MIN_SIZE, SECTION_PADDING, SECTION_TITLE_ROOM, SHOT_KEY, SLOT_TYPES, Scripts, Shot, type ShotUse, Size, Slide, SlideContent, type SlideRow, SlotDeclaration, SlotDeclarationInput, SlotKey, SlotReport, SlotSource, SlotState, SlotType, SlotValue, Slots, SlotsInput, SlotsOptions, TemplatedPage, TemplatedSection, TextArea, TextDirection, Transition, TransitionInput, Word, type ZoomBounds, addItem, annotationCueIssues, arrange, assignMembership, boardBounds, boardListing, boardListingIsEmpty, boardToScreen, bookParentPages, bookSections, chooseMotifVersion, deckFromSlides, defaultPageNumbering, dependencyDecision, dependencyOriginSet, deriveSectionCells, exceedsLimits, firstStrongDirection, fitPage, fitSection, fitTouchedSections, flowingParentNames, foldCellPages, foldColumns, foldForSearch, foldPageCountMessage, foldPanelMap, formatNumber, fromMillimeters, gridDropMarkerBox, gridDropTarget, impose, impositionMarks, insertIntoGrid, isBookContents, isChapter, isDesignedSection, isHebrew, isPart, isPrintedPageIdentityImposition, isTemplatedSection, itemAt, itemHeight, languageDirection, layoutSection, lexiconVersion, localFontLimitRefusal, localFontReferences, makeRoom, mergeSlotDeclarations, mirrorPlacement, motifFieldAttribute, moveItems, moveSection, nameMatches, noteMarker, noteMarkerIssues, originSet, pagePlacementLayout, pagePrintedPagesIssues, paperPixels, parentListIssues, parsePlayback, printBoxes, printPadding, printProperties, printedPagesIssues, removeFromGrid, removeItems, resizeItem, resolveBookPagination, resolveDirection, resolveNoteSeries, resolveParentPages, revealView, roundMillimeters, screenToBoard, settleBoard, sheetMm, shotsUsed, textArea, textDirection, toMillimeters, visibleItems, zoomAt, zoomToFit };