@segnavia/format 0.37.0 → 0.38.0

package/dist/index.js

@@ -8,10 +8,11 @@ import { Board, BoardItem, BoardLabel, BoardSection, GridCell } from "./board.js
 import { APP_FONT_NAME, APP_FONT_NAME_MESSAGE, FONT_FORMATS, FONT_GENERICS, FontReference, FontReferenceInput, LocalFaceTransport, LocalFacesTransport, localFontReferences } from "./fonts.js";
 import { BOOK_FURNITURE, LIBRARY_MOTIF_PREFIX, MOTIF_ATTRIBUTE, Motif, MotifField, MotifFieldInput, MotifInput, MotifVersion, 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 { BOOK_PARENT_NAMES, PRINTED_PAGE_LIMIT, PRINTED_PAGE_ROLES, ParentPage, ParentPageMargin, PrintedPageRules, PrintedPages, 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 { 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, NAMED_PAPERS, ORIENTATIONS, Orientation, PAPER_GROUPS, PAPER_METADATA, PAPER_MM, PAPER_UNITS, PX_PER_MM, Paper, PaperUnit, PrintSetting, PrintSettingInput, fromMillimeters, paperPixels, printBoxes, printPadding, printProperties, roundMillimeters, sheetMm, toMillimeters } from "./paper.js";
-import { Book, BookMode, BookPage, BookRunningHead, BookRunningHeadSource, BookShape, BookView, BookViewPagination, noteMarkerIssues, resolveBookPagination } from "./book.js";
+import { BOOK_PARENT_NAMES, PRINTED_PAGE_LIMIT, PRINTED_PAGE_ROLES, ParentPage, ParentPageMargin, PrintedPageRules, PrintedPages, bookParentPages, flowingParentNames, pagePrintedPagesIssues, parentListIssues, printedPagesIssues, 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, bookSections, isBookContents, isChapter, isDesignedSection, isPart, isTemplatedSection } from "./book-section.js";
+import { NoteNumbering, NotePlacement, NoteSeries, noteMarkerIssues, resolveNoteSeries } from "./note-series.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, NAMED_PAPERS, ORIENTATIONS, Orientation, PAPER_GROUPS, PAPER_METADATA, PAPER_MM, PAPER_UNITS, PX_PER_MM, PX_PER_PT, Paper, PaperUnit, PrintSetting, PrintSettingInput, fromMillimeters, paperPixels, printBoxes, printPadding, printProperties, roundMillimeters, sheetMm, toMillimeters } from "./paper.js";
+import { Book, BookMode, BookPage, BookRunningHead, BookRunningHeadSource, BookShape, BookView, BookViewPagination, resolveBookPagination } from "./book.js";
 import { PAPER_FIT_TOLERANCE_MM, refuseOverflow, refuseSafe } from "./imposition-fit.js";
 import { FOLD_KINDS, FOLD_TUCK_IN_MM, foldCellPages, foldColumns, foldPageCountMessage, foldPanelMap, refineFold, resolveImposition } from "./fold.js";
 import { Lexicon, PronunciationEntry, lexiconVersion } from "./lexicon.js";
@@ -24,8 +25,10 @@ import { assignMembership, fitSection, fitTouchedSections, makeRoom, settleBoard
 import { deckFromSlides } from "./deck-from-slides.js";
 import { fitPage, impose, mirrorPlacement, pagePlacementLayout } from "./imposition.js";
 import { MIN_MARK_LENGTH_MM, impositionMarks } from "./imposition-marks.js";
+import { LOCAL_FONT_LIMITS, localFontLimitRefusal } from "./local-font-limits.js";
 import { isPrintedPageIdentityImposition } from "./printed-page-imposition.js";
 import { shotsUsed } from "./shots-used.js";
+import { dependencyDecision, dependencyOriginSet, originSet } from "./dependency-policy.js";
 import { z } from "zod";
 //#region src/index.ts
 const Margin = z.object({
@@ -224,4 +227,4 @@ function jsonSchemas() {
 	};
 }
 //#endregion
-export { APP_FONT_NAME, APP_FONT_NAME_MESSAGE, Annotation, BOOK_FURNITURE, BOOK_PARENT_NAMES, Board, BoardItem, BoardLabel, BoardSection, Book, BookChapterEntry, BookContents, BookFrontMatterEntry, BookMode, BookOpens, BookPage, BookRunningHead, BookRunningHeadSource, BookSection, BookSectionParents, BookTemplate, BookView, BookViewPagination, Box, CUSTOM_PAPER_MAX_MM, CUSTOM_PAPER_MIN_MM, Chapter, Cue, DECK_SIZE, DEFAULT_TRANSITION_DURATION_MS, Deck, DesignedPage, DesignedSection, Direction, FOLD_DASH_OFF_MM, FOLD_DASH_ON_MM, FOLD_KINDS, FOLD_TUCK_IN_MM, FONT_FORMATS, FONT_GENERICS, FillValues, FontReference, FontReferenceInput, GridCell, ImageFit, Imposition, LIBRARY_MOTIF_PREFIX, Lexicon, LocalFaceTransport, LocalFacesTransport, MAKE_ROOM_LIMIT, MARK_GAP_MM, MARK_LENGTH_MM, MAX_BOARD_ZOOM, MAX_IMPOSITION_CELLS, 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, Margin, MarkColor, Motif, MotifField, MotifFieldInput, MotifInput, MotifVersion, MotifVersionInput, NAMED_PAPERS, Narration, NoteMarker, NumberSystem, ORIENTATIONS, 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, Page, PageSize, Paper, PaperUnit, ParentPage, ParentPageMargin, Playback, Point, Print, PrintSetting, PrintSettingInput, PrintedPageRules, PrintedPages, PronunciationEntry, PublishedShot, REGION_NAME, SECTION_GAP, SECTION_MIN_SIZE, SECTION_PADDING, SECTION_TITLE_ROOM, SHOT_KEY, SLOT_TYPES, Scripts, Shot, Size, Slide, SlideContent, SlotDeclaration, SlotDeclarationInput, SlotKey, SlotType, SlotValue, Slots, SlotsInput, TemplatedPage, TemplatedSection, TextDirection, Transition, Word, 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, jsonSchemas, 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, BOOK_FURNITURE, BOOK_PARENT_NAMES, Board, BoardItem, BoardLabel, BoardSection, Book, BookChapterEntry, BookContents, BookFrontMatterEntry, BookItem, BookMode, BookOpens, BookPage, BookRunningHead, BookRunningHeadSource, BookSection, BookSectionParents, BookTemplate, BookView, BookViewPagination, Box, CUSTOM_PAPER_MAX_MM, CUSTOM_PAPER_MIN_MM, Chapter, Cue, DECK_SIZE, DEFAULT_TRANSITION_DURATION_MS, Deck, DesignedPage, DesignedSection, Direction, FOLD_DASH_OFF_MM, FOLD_DASH_ON_MM, FOLD_KINDS, FOLD_TUCK_IN_MM, FONT_FORMATS, FONT_GENERICS, FillValues, FontReference, FontReferenceInput, GridCell, ImageFit, Imposition, LIBRARY_MOTIF_PREFIX, LOCAL_FONT_LIMITS, Lexicon, LocalFaceTransport, LocalFacesTransport, MAKE_ROOM_LIMIT, MARK_GAP_MM, MARK_LENGTH_MM, MAX_BOARD_ZOOM, MAX_IMPOSITION_CELLS, 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, Margin, MarkColor, Motif, MotifField, MotifFieldInput, MotifInput, MotifVersion, MotifVersionInput, NAMED_PAPERS, Narration, NoteMarker, NoteNumbering, NotePlacement, NoteSeries, NumberSystem, ORIENTATIONS, 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, Page, PageSize, Paper, PaperUnit, ParentPage, ParentPageMargin, Part, Playback, Point, Print, PrintSetting, PrintSettingInput, PrintedPageRules, PrintedPages, PronunciationEntry, PublishedShot, REGION_NAME, SECTION_GAP, SECTION_MIN_SIZE, SECTION_PADDING, SECTION_TITLE_ROOM, SHOT_KEY, SLOT_TYPES, Scripts, Shot, Size, Slide, SlideContent, SlotDeclaration, SlotDeclarationInput, SlotKey, SlotType, SlotValue, Slots, SlotsInput, TemplatedPage, TemplatedSection, TextDirection, Transition, Word, 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, jsonSchemas, 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 };

package/dist/local-font-limits.d.ts

@@ -0,0 +1,15 @@
+//#region src/local-font-limits.d.ts
+export interface LocalFontLimits {
+  count?: number;
+  bytes?: number;
+}
+export interface LocalFontLimitFace {
+  family: string;
+  bytes: number;
+}
+export declare const LOCAL_FONT_LIMITS: {
+  readonly count: 64;
+  readonly bytes: number;
+};
+export declare function localFontLimitRefusal(faces: readonly LocalFontLimitFace[], limits?: LocalFontLimits): string | undefined;
+//#endregion

package/dist/local-font-limits.js

@@ -0,0 +1,24 @@
+//#region src/local-font-limits.ts
+const LOCAL_FONT_LIMITS = {
+	count: 64,
+	bytes: 33554432
+};
+function limit(value, fallback, label) {
+	const resolved = value ?? fallback;
+	if (!Number.isSafeInteger(resolved) || resolved < 0) return `The local font ${label} limit must be a non-negative safe integer; pass valid limits to clear this refusal.`;
+	return resolved;
+}
+function localFontLimitRefusal(faces, limits = {}) {
+	const countLimit = limit(limits.count, LOCAL_FONT_LIMITS.count, "count");
+	if (typeof countLimit === "string") return countLimit;
+	const byteLimit = limit(limits.bytes, LOCAL_FONT_LIMITS.bytes, "byte");
+	if (typeof byteLimit === "string") return byteLimit;
+	if (faces.length > countLimit) return `The local face ${JSON.stringify(faces[countLimit]?.family ?? "unknown family")} exceeds the count limit of ${countLimit}; pass higher limits or declare fewer local font families to clear this refusal.`;
+	let bytes = 0;
+	for (const face of faces) {
+		bytes += face.bytes;
+		if (bytes > byteLimit) return `The local face ${JSON.stringify(face.family)} exceeds the byte limit of ${byteLimit}; pass higher limits or declare fewer local font families to clear this refusal.`;
+	}
+}
+//#endregion
+export { LOCAL_FONT_LIMITS, localFontLimitRefusal };

package/dist/note-series.d.ts

@@ -0,0 +1,70 @@
+import { NoteMarker } from "./numbering.js";
+import { z } from "zod";
+//#region src/note-series.d.ts
+export declare const NotePlacement: z.ZodEnum<{
+  page: "page";
+  chapter: "chapter";
+  book: "book";
+  part: "part";
+}>;
+export type NotePlacement = z.infer<typeof NotePlacement>;
+export declare const NoteNumbering: z.ZodEnum<{
+  chapter: "chapter";
+  book: "book";
+  part: "part";
+}>;
+export type NoteNumbering = z.infer<typeof NoteNumbering>;
+export declare const NoteSeries: 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>;
+export type NoteSeriesInput = z.input<typeof NoteSeries>;
+export interface ResolvedNoteSeries {
+  name: string;
+  placement: NotePlacement;
+  numbering: NoteNumbering;
+  marker: NoteMarker;
+  title: string;
+  idStem: string;
+  idScope: 'chapter' | 'numbering';
+  blockClass: string;
+  bodyClass: string;
+  titleClass: string;
+  sectionIdPrefix: string;
+  markerLabel: string;
+  markerConflictSuffixes: Readonly<Record<string, string>>;
+  markBlockSeries: boolean;
+}
+interface NoteSeriesSettings {
+  lang?: string;
+  footnotes: {
+    marker?: NoteMarker;
+    restart: 'chapter' | 'book';
+  };
+  endnotes: {
+    marker?: NoteMarker;
+    placement: 'book' | 'chapter';
+    title?: string;
+  };
+  notes: NoteSeriesInput[];
+}
+export declare function resolveNoteSeries(settings: NoteSeriesSettings): ResolvedNoteSeries[];
+export declare function noteMarkerIssues(series: ResolvedNoteSeries[], used: ReadonlySet<string>): string[];
+//#endregion

package/dist/note-series.js

@@ -0,0 +1,158 @@
+import { NoteMarker, isHebrew } from "./numbering.js";
+import { REGION_NAME } from "./book-section.js";
+import { z } from "zod";
+//#region src/note-series.ts
+const NotePlacement = z.enum([
+	"page",
+	"chapter",
+	"part",
+	"book"
+]);
+const NoteNumbering = z.enum([
+	"chapter",
+	"part",
+	"book"
+]);
+const NoteSeries = z.object({
+	name: z.string().regex(REGION_NAME, "a note series name must be an HTML name token"),
+	placement: NotePlacement.optional(),
+	numbering: NoteNumbering.optional(),
+	marker: NoteMarker.optional(),
+	title: z.string().optional()
+});
+function markerOrder(lang) {
+	return isHebrew(lang) ? [
+		"hebrew",
+		"arabic",
+		"symbols",
+		"roman-lower"
+	] : [
+		"symbols",
+		"arabic",
+		"roman-lower",
+		"hebrew"
+	];
+}
+function unusedMarker(lang, used) {
+	return markerOrder(lang).find((marker) => !used.has(marker)) ?? "symbols";
+}
+function resolveCustomSeries(series) {
+	if (series.placement === void 0 || series.numbering === void 0) throw new Error(`note series ${series.name} needs placement and numbering`);
+	return {
+		...series,
+		placement: series.placement,
+		numbering: series.numbering,
+		title: series.title ?? series.name,
+		idStem: `note-${series.name}`,
+		idScope: "numbering",
+		blockClass: `segnavia-notes-${series.name}`,
+		bodyClass: `segnavia-note-${series.name}`,
+		titleClass: "segnavia-notes-title",
+		sectionIdPrefix: `segnavia-notes-${series.name}`,
+		markerLabel: `note series ${series.name}`,
+		markerConflictSuffixes: {},
+		markBlockSeries: true
+	};
+}
+function resolveNoteSeries(settings) {
+	const hebrew = isHebrew(settings.lang);
+	const declared = new Map(settings.notes.map((series) => [series.name, series]));
+	const footnotePresentation = {
+		idStem: "fn",
+		idScope: "chapter",
+		blockClass: "segnavia-footnotes",
+		bodyClass: "segnavia-footnote",
+		titleClass: "segnavia-notes-title",
+		sectionIdPrefix: "segnavia-notes-footnote",
+		markerLabel: "footnote",
+		markerConflictSuffixes: { endnote: "the two must differ when both kinds are used" },
+		markBlockSeries: false
+	};
+	const endnotePresentation = {
+		idStem: "en",
+		idScope: "numbering",
+		blockClass: "segnavia-notes-endnote",
+		bodyClass: "segnavia-endnote",
+		titleClass: "segnavia-endnotes-title",
+		sectionIdPrefix: "segnavia-endnotes",
+		markerLabel: "endnote",
+		markerConflictSuffixes: {},
+		markBlockSeries: true
+	};
+	const inputs = [
+		{
+			name: "footnote",
+			placement: "page",
+			numbering: settings.footnotes.restart,
+			marker: settings.footnotes.marker ?? (hebrew ? "hebrew" : "symbols"),
+			title: hebrew ? "מקורות" : "Footnotes",
+			...footnotePresentation,
+			...declared.get("footnote")
+		},
+		{
+			name: "endnote",
+			placement: settings.endnotes.placement,
+			numbering: "book",
+			marker: settings.endnotes.marker ?? "arabic",
+			title: settings.endnotes.title ?? (hebrew ? "הערות" : "Notes"),
+			...endnotePresentation,
+			...declared.get("endnote")
+		},
+		...settings.notes.filter(({ name }) => name !== "footnote" && name !== "endnote").map(resolveCustomSeries)
+	];
+	const used = /* @__PURE__ */ new Set();
+	return inputs.map((series) => {
+		const marker = series.marker ?? unusedMarker(settings.lang, used);
+		used.add(marker);
+		return {
+			name: series.name,
+			placement: series.placement,
+			numbering: series.numbering,
+			marker,
+			title: series.title,
+			idStem: series.idStem,
+			idScope: series.idScope,
+			blockClass: series.blockClass,
+			bodyClass: series.bodyClass,
+			titleClass: series.titleClass,
+			sectionIdPrefix: series.sectionIdPrefix,
+			markerLabel: series.markerLabel,
+			markerConflictSuffixes: series.markerConflictSuffixes,
+			markBlockSeries: series.markBlockSeries
+		};
+	});
+}
+function noteSeriesIssues(series, mode) {
+	const issues = [];
+	series.forEach((item, index) => {
+		if (mode === "continuous" && (item.placement === "chapter" || item.placement === "part")) issues.push({
+			path: [
+				"notes",
+				index,
+				"placement"
+			],
+			message: `note series ${item.name} uses ${item.placement} placement only available in paginated mode; use page or book placement, or paginated mode`
+		});
+	});
+	const page = series.filter(({ placement }) => placement === "page");
+	if (page.length > 1) issues.push({
+		path: ["notes"],
+		message: `note series ${page.map(({ name }) => name).join(" and ")} are both page-placed; declare one page-placed series`
+	});
+	return issues;
+}
+function noteMarkerIssues(series, used) {
+	const active = series.filter(({ name }) => used.has(name));
+	const issues = [];
+	for (let left = 0; left < active.length; left += 1) for (let right = left + 1; right < active.length; right += 1) {
+		const a = active[left];
+		const b = active[right];
+		if (!a || !b) continue;
+		if (a.marker !== b.marker) continue;
+		const suffix = a.markerConflictSuffixes[b.name] ?? b.markerConflictSuffixes[a.name] ?? "used series must have different markers";
+		issues.push(`${a.markerLabel} and ${b.markerLabel} markers are both ${a.marker}; ${suffix}`);
+	}
+	return issues;
+}
+//#endregion
+export { NoteNumbering, NotePlacement, NoteSeries, noteMarkerIssues, noteSeriesIssues, resolveNoteSeries };

package/dist/paper.d.ts

@@ -305,6 +305,7 @@ export declare function sheetMm(print: Pick<Print, 'paper' | 'orientation'>): {
   height: number;
 };
 export declare const PX_PER_MM: number;
+export declare const PX_PER_PT: number;
 export declare const paperPixels: (millimeters: number) => number;
 export declare function printProperties(print: Pick<Print, 'bleed' | 'safe'>, unit?: 'mm' | 'in' | 'pt'): string;
 export declare function printPadding(edges: {

package/dist/paper.js

@@ -375,6 +375,7 @@ function sheetMm(print) {
 	};
 }
 const PX_PER_MM = 96 / 25.4;
+const PX_PER_PT = PX_PER_MM * MM_PER_PT;
 const paperPixels = (millimeters) => Math.ceil(millimeters * PX_PER_MM - 1e-9);
 function printProperties(print, unit = "mm") {
 	return `:root{--segnavia-bleed:${roundMillimeters(toMillimeters(print.bleed, unit))}mm;--segnavia-safe:${roundMillimeters(toMillimeters(print.safe, unit))}mm}`;
@@ -485,4 +486,4 @@ function printBoxes(print) {
 	};
 }
 //#endregion
-export { 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, NAMED_PAPERS, ORIENTATIONS, Orientation, PAPER_GROUPS, PAPER_METADATA, PAPER_MM, PAPER_UNITS, PX_PER_MM, Paper, PaperUnit, PrintSetting, PrintSettingInput, fromMillimeters, paperPixels, printBoxes, printPadding, printProperties, roundMillimeters, sheetMm, toMillimeters };
+export { 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, NAMED_PAPERS, ORIENTATIONS, Orientation, PAPER_GROUPS, PAPER_METADATA, PAPER_MM, PAPER_UNITS, PX_PER_MM, PX_PER_PT, Paper, PaperUnit, PrintSetting, PrintSettingInput, fromMillimeters, paperPixels, printBoxes, printPadding, printProperties, roundMillimeters, sheetMm, toMillimeters };

package/dist/printed-pages.d.ts

@@ -91,6 +91,12 @@ export declare const BOOK_PARENT_NAMES: {
   readonly opener: "segnavia:opener";
   readonly blank: "segnavia:blank";
 };
+export interface FlowingParentNames {
+  opener: string;
+  recto: string;
+  verso: string;
+}
+export declare function flowingParentNames(parents?: Partial<FlowingParentNames>): FlowingParentNames;
 export declare function bookParentPages(margin: ParentPageMargin): ParentPage[];
 export interface ResolvedParentPage {
   name: string;
@@ -98,6 +104,14 @@ export interface ResolvedParentPage {
   head: string;
   foot: string;
 }
+export interface TextArea {
+  width: number;
+  height: number;
+}
+export declare function textArea(parent: Pick<ResolvedParentPage, 'margin'>, paper: {
+  width: number;
+  height: number;
+}): TextArea;
 export declare function resolveParentPages(parents: ParentPage[]): ResolvedParentPage[];
 export declare function parentListIssues(parents: ParentPage[], options?: {
   path?: (string | number)[];

package/dist/printed-pages.js

@@ -54,6 +54,13 @@ const BOOK_PARENT_NAMES = {
 	opener: "segnavia:opener",
 	blank: "segnavia:blank"
 };
+function flowingParentNames(parents) {
+	return {
+		opener: parents?.opener ?? "segnavia:opener",
+		recto: parents?.recto ?? "segnavia:recto",
+		verso: parents?.verso ?? "segnavia:verso"
+	};
+}
 function furniture(region) {
 	return BOOK_FURNITURE.filter((item) => item.region === region).filter((item) => item.fields.every((field) => !("required" in field) || !field.required)).map((item) => `<div class="${item.className}" data-motif="${item.key}"></div>`).join("");
 }
@@ -85,6 +92,12 @@ function bookParentPages(margin) {
 		}
 	];
 }
+function textArea(parent, paper) {
+	return {
+		width: paper.width - parent.margin.inner - parent.margin.outer,
+		height: paper.height - parent.margin.top - parent.margin.bottom
+	};
+}
 const ZERO_PARENT_MARGIN = {
 	top: 0,
 	bottom: 0,
@@ -193,4 +206,4 @@ function pagePrintedPagesIssues(page) {
 	return issues;
 }
 //#endregion
-export { BOOK_PARENT_NAMES, PRINTED_PAGE_LIMIT, PRINTED_PAGE_ROLES, ParentPage, ParentPageMargin, PrintedPageRules, PrintedPages, bookParentPages, pagePrintedPagesIssues, parentListIssues, printedPagesIssues, resolveParentPages };
+export { BOOK_PARENT_NAMES, PRINTED_PAGE_LIMIT, PRINTED_PAGE_ROLES, ParentPage, ParentPageMargin, PrintedPageRules, PrintedPages, bookParentPages, flowingParentNames, pagePrintedPagesIssues, parentListIssues, printedPagesIssues, resolveParentPages, textArea };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@segnavia/format",
-  "version": "0.37.0",
+  "version": "0.38.0",
   "type": "module",
   "license": "MIT",
   "repository": {