@stll/folio-core 0.47.7 → 0.48.0

package/dist/layout-engine/measure/tableFragmentBorderGeometry.js

@@ -9,7 +9,8 @@ const tableFragmentBottomBorders = ({ fragment, block, measure, placements: supp
 	const placements = suppliedPlacements ?? buildTableCellPlacements({
 		grid: buildTableCellGrid(block.rows, measure.columnWidths.length),
 		columnWidths: measure.columnWidths,
-		bidi: block.bidi === true
+		bidi: block.bidi === true,
+		cellSpacing: block.cellSpacing
 	});
 	return splitRow.cells.flatMap((cell) => {
 		const placement = placements.get(cell);

package/dist/layout-engine/noteAreaFlow.d.ts

@@ -0,0 +1,19 @@
+import { FlowBlock, Layout, Measure, NoteAreaLayout } from "./types.js";
+import { PageTopContinuation, Paginator } from "./paginator.js";
+//#region src/layout-engine/noteAreaFlow.d.ts
+/**
+ * The continuation separator a page opens with while a note area continues
+ * onto it. Its space after collapses with the next note paragraph's space
+ * before, as between any two paragraphs.
+ */
+declare function createNoteAreaContinuation(noteAreas: NoteAreaLayout | undefined, paginator: Paginator): PageTopContinuation | undefined;
+/** Whether laying out `block` continues a note area onto any page it opens. */
+declare function continuesNoteArea(noteAreas: NoteAreaLayout | undefined, block: FlowBlock): boolean;
+/**
+ * Record where each separator mark landed. A rule is centred on the first line
+ * of the separator paragraph: a `w:separator` spans part of the column and a
+ * `w:continuationSeparator` all of it.
+ */
+declare function annotateNoteSeparators(layout: Layout, blocks: readonly FlowBlock[], measures: readonly Measure[], noteAreas: NoteAreaLayout | undefined): Layout;
+//#endregion
+export { annotateNoteSeparators, continuesNoteArea, createNoteAreaContinuation };

package/dist/layout-engine/noteAreaFlow.js

@@ -0,0 +1,83 @@
+import { measuredLineRangeHeight } from "./lineFlow.js";
+import { getParagraphSpacingAfter } from "./paragraphSpacing.js";
+import { NOTE_SEPARATOR_RULE_THICKNESS, NOTE_SEPARATOR_WIDTH_FRACTION } from "./types.js";
+//#region src/layout-engine/noteAreaFlow.ts
+/**
+* Note areas that flow with the body (ECMA-376 §17.11).
+*
+* Endnotes are collected after the last body block of the document, or of a
+* section, and paginate exactly as body content does. Two things set them
+* apart from the body: the area opens with its `w:separator` story, and every
+* page the area continues onto opens with its `w:continuationSeparator` story.
+* Both stories draw their separator mark as a horizontal rule.
+*/
+/**
+* The continuation separator a page opens with while a note area continues
+* onto it. Its space after collapses with the next note paragraph's space
+* before, as between any two paragraphs.
+*/
+function createNoteAreaContinuation(noteAreas, paginator) {
+	const continuation = noteAreas?.continuationSeparator;
+	if (continuation === void 0) return;
+	const { block, measure } = continuation;
+	const height = measuredLineRangeHeight(measure.lines, 0, measure.lines.length);
+	return (state, x, width) => {
+		const fragment = {
+			kind: "paragraph",
+			blockId: block.id,
+			x,
+			y: state.cursorY,
+			width,
+			height,
+			fromLine: 0,
+			toLine: measure.lines.length
+		};
+		paginator.addUnflowedFragment(fragment);
+		state.trailingSpacing = getParagraphSpacingAfter(block);
+		return height;
+	};
+}
+/** Whether laying out `block` continues a note area onto any page it opens. */
+function continuesNoteArea(noteAreas, block) {
+	return noteAreas?.contentBlockIds.has(String(block.id)) === true;
+}
+/**
+* Record where each separator mark landed. A rule is centred on the first line
+* of the separator paragraph: a `w:separator` spans part of the column and a
+* `w:continuationSeparator` all of it.
+*/
+function annotateNoteSeparators(layout, blocks, measures, noteAreas) {
+	if (noteAreas === void 0 || noteAreas.separatorBlockIds.size === 0) return layout;
+	const measureById = /* @__PURE__ */ new Map();
+	for (const [index, block] of blocks.entries()) {
+		const measure = measures[index];
+		if (noteAreas.separatorBlockIds.has(String(block.id)) && measure?.kind === "paragraph") measureById.set(String(block.id), measure);
+	}
+	const continuation = noteAreas.continuationSeparator;
+	if (continuation !== void 0) measureById.set(String(continuation.block.id), continuation.measure);
+	for (const page of layout.pages) {
+		const rules = [];
+		for (const fragment of page.fragments) {
+			if (fragment.kind !== "paragraph" || fragment.fromLine !== 0) continue;
+			const kind = noteAreas.separatorBlockIds.get(String(fragment.blockId));
+			const firstLine = measureById.get(String(fragment.blockId))?.lines.at(0);
+			if (kind === void 0 || firstLine === void 0) continue;
+			rules.push({
+				x: fragment.x,
+				y: fragment.y + (firstLine.lineHeight - NOTE_SEPARATOR_RULE_THICKNESS) / 2,
+				width: fragment.width * separatorWidthFraction(kind)
+			});
+		}
+		if (rules.length > 0) page.noteSeparators = rules;
+	}
+	return layout;
+}
+function separatorWidthFraction(kind) {
+	switch (kind) {
+		case "separator": return NOTE_SEPARATOR_WIDTH_FRACTION;
+		case "continuationSeparator": return 1;
+		default: return kind;
+	}
+}
+//#endregion
+export { annotateNoteSeparators, continuesNoteArea, createNoteAreaContinuation };

package/dist/layout-engine/paginator.d.ts

@@ -65,6 +65,13 @@ type PaginatorOptions = {
 type ForcePageBreakOptions = {
   coalesceBlankPage?: boolean;
 };
+/**
+ * Content that opens every page created while a flow continues from an
+ * earlier page (a note area's continuation separator). Called with the new
+ * page's state and the first column's box; returns the height it placed,
+ * which the page's flow then starts below.
+ */
+type PageTopContinuation = (state: PageState, x: number, width: number) => number;
 declare const SECTION_START_PLACEMENT: {
   readonly CONTINUOUS: "continuous";
   readonly NEXT_PAGE: "nextPage";
@@ -147,7 +154,9 @@ declare function createPaginator(options: PaginatorOptions): {
   }, newMargins?: PageMargins, applyImmediately?: boolean) => void;
   /** Mark the next created page as the first page of a new section. */
   startSection: ({ sectionIndex, pageNumbering, placement }: StartSectionOptions) => void;
+  /** Set (or clear) the content that opens each page a flow continues onto. */
+  setPageTopContinuation: (continuation: PageTopContinuation | undefined) => void;
 };
 type Paginator = ReturnType<typeof createPaginator>;
 //#endregion
-export { FOOTNOTE_SEPARATOR_HEIGHT, PageState, Paginator, PaginatorOptions, SECTION_START_PLACEMENT, calculateColumnLefts, calculateColumnWidths, createPaginator, resolveColumnLeft };
+export { FOOTNOTE_SEPARATOR_HEIGHT, PageState, PageTopContinuation, Paginator, PaginatorOptions, SECTION_START_PLACEMENT, calculateColumnLefts, calculateColumnWidths, createPaginator, resolveColumnLeft };

package/dist/layout-engine/paginator.js

@@ -62,6 +62,7 @@ function createPaginator(options) {
 		type: "pending",
 		placement: "nextPage"
 	};
+	let pageTopContinuation;
 	const pages = [];
 	const states = [];
 	const paginationStateByPage = /* @__PURE__ */ new WeakMap();
@@ -180,6 +181,13 @@ function createPaginator(options) {
 		states.push(state);
 		columnRegionTop = topMargin;
 		columnRegionMaxBottom = topMargin;
+		const continuationHeight = pageTopContinuation?.(state, getColumnX(0), columnWidths[0] ?? getContentWidth()) ?? 0;
+		if (continuationHeight > 0) {
+			state.cursorY += continuationHeight;
+			state.topMargin += continuationHeight;
+			columnRegionTop = state.topMargin;
+			columnRegionMaxBottom = state.topMargin;
+		}
 		if (options.onNewPage) options.onNewPage(state);
 		return state;
 	}
@@ -503,7 +511,11 @@ function createPaginator(options) {
 		/** Update page size/margins for subsequent pages. */
 		updatePageLayout,
 		/** Mark the next created page as the first page of a new section. */
-		startSection
+		startSection,
+		/** Set (or clear) the content that opens each page a flow continues onto. */
+		setPageTopContinuation: (continuation) => {
+			pageTopContinuation = continuation;
+		}
 	};
 }
 //#endregion

package/dist/layout-engine/tableRowBreak.js

@@ -2,6 +2,7 @@ import { measuredLineAdvance } from "./lineFlow.js";
 import { measureParagraph } from "./measure/measureParagraph.js";
 import { buildTableCellFloatingZones, getTableCellContentWidth, getTableCellFloatingImages } from "./measure/tableCellFloating.js";
 import { createTableCellFlowState, placeTableCellBlock } from "./measure/tableCellFlow.js";
+import { getTableCellSpacingInsetsY } from "./measure/tableCellGrid.js";
 import { isEmptyParagraph } from "./paragraphSpacing.js";
 import { resolveTableCellPadding } from "./types.js";
 //#region src/layout-engine/tableRowBreak.ts
@@ -164,7 +165,8 @@ function buildTableRowBreakInfo(block, measure) {
 			const measuredCell = measuredCells[c];
 			if (!measuredCell) continue;
 			const sourceCell = sourceCells[c];
-			const geometry = shiftCellGeometry(cellBreakGeometry(sourceCell, measuredCell), getVerticalAlignmentOffset(sourceCell, measuredCell, rowHeight));
+			const spacing = getTableCellSpacingInsetsY(block.cellSpacing, r, sourceCell?.rowSpan ?? 1, block.rows.length);
+			const geometry = shiftCellGeometry(cellBreakGeometry(sourceCell, measuredCell), spacing.top + getVerticalAlignmentOffset(sourceCell, measuredCell, Math.max(0, rowHeight - spacing.top - spacing.bottom)));
 			cellGeometries.push(geometry);
 			for (const b of geometry.bottoms) if (b > 0 && b < rowHeight) offsets.add(b);
 		}

package/dist/layout-engine/types.d.ts

@@ -2,7 +2,7 @@ import { OutlineStyleAttr } from "../types/documentEnumValues.js";
 import { CssBorderStyle } from "../utils/borderCss.js";
 import { ImagePosition, ImageWrap, InlineWrapper, NumberFormat, OutlineLevel, ParagraphNumberingOverride, PreviewDescriptor, SdtProperties, SdtType, SectionStart, ShapeTextBody, TableCellFormatting, TableWidthType, UnderlineStyle, VerticalAlign } from "@stll/docx-core/model";
 declare namespace types_d_exports {
-  export { BlockId, BorderStyle, CellBorderSpec, CellBorders, ColumnBreakBlock, ColumnBreakMeasure, ColumnLayout, DEFAULT_TEXTBOX_MARGINS, DEFAULT_TEXTBOX_WIDTH, DocumentPosition, FOOTNOTE_ENTRY_MARGIN_BOTTOM, FOOTNOTE_FALLBACK_LINE_HEIGHT, FOOTNOTE_SEPARATOR_HEIGHT, FieldRun, FloatingTablePosition, FlowBlock, FootnoteContent, Fragment, FragmentBase, HeaderFooterContent, HeaderFooterContentHeights, HeaderFooterLayout, HitTestResult, HyperlinkInfo, ImageBlock, ImageFragment, ImageMeasure, ImageRun, ImageRunPosition, Layout, LayoutOptions, LineBreakRun, ListMarkerFormatting, MathRun, Measure, MeasuredLine, Page, PageBreakBlock, PageBreakMeasure, PageHeaderFooterRefs, PageMargins, ParagraphAttrs, ParagraphBlock, ParagraphBorders, ParagraphFragment, ParagraphIndent, ParagraphMeasure, ParagraphSpacing, RenderedPageBreakRun, Run, RunFormatting, SdtGroup, SectionBreakBlock, SectionBreakMeasure, SectionPageNumbering, TabAlignment, TabRun, TabStop, TableBlock, TableCell, TableCellMeasure, TableFragment, TableMeasure, TableRow, TableRowMeasure, TextBoxBlock, TextBoxFlowAttrs, TextBoxFragment, TextBoxMeasure, TextRun, floatingTextBoxReservesBand, floatingTextBoxWrapsText, getTableRowLeadingWidth, isFloatingImageRun, isFloatingTextBoxBlock, isListNumPr, isTextWrappingFloatingImageRun, resolveTableCellPadding, resolveTableWidthPx, tableColumnsArePinned };
+  export { BlockId, BorderStyle, CellBorderSpec, CellBorders, ColumnBreakBlock, ColumnBreakMeasure, ColumnLayout, DEFAULT_TEXTBOX_MARGINS, DEFAULT_TEXTBOX_WIDTH, DocumentPosition, FOOTNOTE_ENTRY_MARGIN_BOTTOM, FOOTNOTE_FALLBACK_LINE_HEIGHT, FOOTNOTE_SEPARATOR_HEIGHT, FieldRun, FloatingTablePosition, FlowBlock, FootnoteContent, Fragment, FragmentBase, HeaderFooterContent, HeaderFooterContentHeights, HeaderFooterLayout, HitTestResult, HyperlinkInfo, ImageBlock, ImageFragment, ImageMeasure, ImageRun, ImageRunPosition, Layout, LayoutOptions, LineBreakRun, ListMarkerFormatting, MathRun, Measure, MeasuredLine, NOTE_SEPARATOR_RULE_THICKNESS, NOTE_SEPARATOR_WIDTH_FRACTION, NoteAreaLayout, NoteSeparatorKind, NoteSeparatorRule, Page, PageBreakBlock, PageBreakMeasure, PageHeaderFooterRefs, PageMargins, ParagraphAttrs, ParagraphBlock, ParagraphBorders, ParagraphFragment, ParagraphIndent, ParagraphMeasure, ParagraphSpacing, RenderedPageBreakRun, Run, RunFormatting, SdtGroup, SectionBreakBlock, SectionBreakMeasure, SectionPageNumbering, TabAlignment, TabRun, TabStop, TableBlock, TableCell, TableCellMeasure, TableFragment, TableMeasure, TableRow, TableRowMeasure, TextBoxBlock, TextBoxFlowAttrs, TextBoxFragment, TextBoxMeasure, TextRun, floatingTextBoxReservesBand, floatingTextBoxWrapsText, getTableRowLeadingWidth, isFloatingImageRun, isFloatingTextBoxBlock, isListNumPr, isTextWrappingFloatingImageRun, resolveTableCellPadding, resolveTableWidthPx, stripFlowBlockPmAnchors, tableColumnsArePinned };
 }
 /**
  * Unique identifier for a block in the document.
@@ -47,6 +47,11 @@ type RunFormatting = {
   eastAsiaFontFamily?: string;
   /** OOXML alternate-name fallback for `eastAsiaFontFamily`. */
   eastAsiaAlternateFontFamily?: string;
+  /**
+   * `w:rFonts/@w:hint="eastAsia"`: the symbols and punctuation shared with East
+   * Asian text also take `eastAsiaFontFamily` (see `isEastAsiaHintCodePoint`).
+   */
+  eastAsiaHint?: boolean;
   /**
    * Resolved complex-script font (`w:cs` / `cstheme`). Arabic, Hebrew, Indic
    * and South-East Asian code points in this run measure and paint with this
@@ -155,7 +160,7 @@ type RunFormatting = {
   /** Groups a suggestion's runs for accept/reject and scroll-to. */
   suggestionId?: string;
 };
-type ListMarkerFormatting = Pick<RunFormatting, "fontFamily" | "alternateFontFamily" | "eastAsiaFontFamily" | "eastAsiaAlternateFontFamily" | "complexScriptFontFamily" | "complexScriptAlternateFontFamily" | "fontSize" | "complexScriptFontSize" | "bold" | "complexScriptBold" | "italic" | "complexScriptItalic" | "rtl" | "forceComplexScript">;
+type ListMarkerFormatting = Pick<RunFormatting, "fontFamily" | "alternateFontFamily" | "eastAsiaFontFamily" | "eastAsiaAlternateFontFamily" | "complexScriptFontFamily" | "complexScriptAlternateFontFamily" | "fontSize" | "complexScriptFontSize" | "bold" | "complexScriptBold" | "italic" | "complexScriptItalic" | "rtl" | "forceComplexScript" | "color">;
 /**
  * Hyperlink information for a run.
  */
@@ -519,6 +524,12 @@ type ParagraphAttrs = {
    * one space glyph; `nothing` lets body text butt against the marker.
    */
   listMarkerSuffix?: "tab" | "space" | "nothing";
+  /**
+   * `w:doNotUseIndentAsNumberingTabStop` (§17.15.3): the hanging indent is
+   * not an implicit stop for the tab after the number, so the first custom
+   * stop past the marker wins wherever it is.
+   */
+  listNumberingTabIgnoresIndent?: boolean;
   /**
    * Tracked-change state of the list numbering itself. When a list is applied
    * (or removed) under suggesting mode, the marker paints in the insertion /
@@ -681,6 +692,14 @@ type TableBlock = {
   justification?: "left" | "center" | "right";
   /** Table indent from the leading margin (in pixels, from w:tblInd). */
   indent?: number;
+  /**
+   * Default cell spacing in pixels (`w:tblCellSpacing`, §17.4.43). Each cell
+   * box sits this far inside its grid slot on every side, so adjacent cells
+   * stand twice this apart, and the table edge adds one more unit around the
+   * outermost cells. Borders then follow the separated model: every cell
+   * paints its own four edges.
+   */
+  cellSpacing?: number;
   /**
    * Pre-Word-2013 `w:tblInd` semantics: the indent measures to the leading
    * cell's text edge instead of the table border. Derived from the document's
@@ -865,6 +884,23 @@ type TextBoxBlock = {
     left: number;
     right: number;
   };
+  /**
+   * An inline box's `wp:effectExtent`, in pixels. The line reserves these
+   * beyond the box's own extent on each side, so the box sits `left`/`top`
+   * inside the space it occupies (ECMA-376 §20.4.2.6).
+   */
+  effectExtent?: {
+    top: number;
+    bottom: number;
+    left: number;
+    right: number;
+  };
+  /**
+   * The paragraph an inline box is the only content of. The box is run
+   * content of that paragraph, so its spacing surrounds the box and its
+   * indentation and alignment place it on the line.
+   */
+  hostParagraph?: ParagraphAttrs;
   /** Flow blocks inside the text box */
   content: (ParagraphBlock | TableBlock)[];
   /** Display mode copied from the ProseMirror text box node. */
@@ -1208,9 +1244,23 @@ type Page = {
   footnoteIds?: number[];
   /** Height reserved for the footnote area at page bottom (pixels). */
   footnoteReservedHeight?: number;
+  /**
+   * Rules drawn for the `w:separator` / `w:continuationSeparator` marks of a
+   * note area that flows with the body (endnotes), in page coordinates.
+   */
+  noteSeparators?: NoteSeparatorRule[];
   /** Column layout for this page (if multi-column). */
   columns?: ColumnLayout;
 };
+/**
+ * One separator rule of a flowed note area: the top-left corner of a
+ * `NOTE_SEPARATOR_RULE_THICKNESS`-high rule and its width, in page pixels.
+ */
+type NoteSeparatorRule = {
+  x: number;
+  y: number;
+  width: number;
+};
 /**
  * Column layout configuration.
  */
@@ -1341,6 +1391,32 @@ type LayoutOptions = {
   footnoteHeightById?: Map<number, number>;
   /** Header/footer references for each document section, by section index. */
   sectionHeaderFooterRefs?: PageHeaderFooterRefs[];
+  /** Note areas (endnotes) whose blocks flow with the body blocks. */
+  noteAreas?: NoteAreaLayout;
+};
+/** Which separator story a flowed note-area block renders. */
+type NoteSeparatorKind = "separator" | "continuationSeparator";
+/**
+ * Note areas laid out in the body flow (ECMA-376 §17.11): endnotes collected
+ * at the end of the document or of a section. Their blocks sit in the body's
+ * block list; this names the ones the paginator treats specially.
+ */
+type NoteAreaLayout = {
+  /**
+   * Separator-story paragraphs that carry a `w:separator` mark, keyed by block
+   * id. A rule is drawn across the first line of each of their fragments.
+   */
+  separatorBlockIds: ReadonlyMap<string, NoteSeparatorKind>;
+  /**
+   * Note content blocks. A page opened while one of them is laid out
+   * continues the area, so it starts with the continuation separator.
+   */
+  contentBlockIds: ReadonlySet<string>;
+  /** The `w:continuationSeparator` story's first paragraph, already measured. */
+  continuationSeparator?: {
+    block: ParagraphBlock;
+    measure: ParagraphMeasure;
+  };
 };
 /**
  * Result of hit-testing a click position.
@@ -1383,6 +1459,10 @@ declare const FOOTNOTE_SEPARATOR_HEIGHT = 12;
  * present in the source DOCX.
  */
 declare const FOOTNOTE_ENTRY_MARGIN_BOTTOM = 0;
+/** Thickness of a note separator rule, in the footnote band and in flowed endnotes. */
+declare const NOTE_SEPARATOR_RULE_THICKNESS = 0.5;
+/** Width of a `w:separator` rule as a fraction of its column. */
+declare const NOTE_SEPARATOR_WIDTH_FRACTION = 0.33;
 /**
  * Line height used when a footnote entry has no measured line height yet.
  * Conservative fallback so a missing measure does not collapse the entry.
@@ -1489,5 +1569,11 @@ declare function tableColumnsArePinned(table: TableBlock): boolean;
 declare function resolveTableWidthPx(width: number | undefined, widthType: TableWidthType | undefined, containerWidth: number): number | undefined;
 /** Return the leading visual offset for a row with omitted grid columns. */
 declare const getTableRowLeadingWidth: (row: TableRow, columnWidths: readonly number[]) => number;
+/**
+ * A copy of a block with every ProseMirror anchor removed. A note story's
+ * blocks carry positions in the note's own document; painted beside the body
+ * they must not resolve a click, a selection or a caret into the body.
+ */
+declare function stripFlowBlockPmAnchors(block: FlowBlock): FlowBlock;
 //#endregion
-export { BlockId, BorderStyle, CellBorderSpec, CellBorders, ColumnBreakBlock, ColumnBreakMeasure, ColumnLayout, DEFAULT_TEXTBOX_MARGINS, DEFAULT_TEXTBOX_WIDTH, DocumentPosition, FOOTNOTE_ENTRY_MARGIN_BOTTOM, FOOTNOTE_FALLBACK_LINE_HEIGHT, FOOTNOTE_SEPARATOR_HEIGHT, FieldRun, FloatingTablePosition, FlowBlock, FootnoteContent, Fragment, FragmentBase, HeaderFooterContent, HeaderFooterContentHeights, HeaderFooterLayout, HitTestResult, HyperlinkInfo, ImageBlock, ImageFragment, ImageMeasure, ImageRun, ImageRunPosition, Layout, LayoutOptions, LineBreakRun, ListMarkerFormatting, MathRun, Measure, MeasuredLine, Page, PageBreakBlock, PageBreakMeasure, PageHeaderFooterRefs, PageMargins, ParagraphAttrs, ParagraphBlock, ParagraphBorders, ParagraphFragment, ParagraphIndent, ParagraphMeasure, ParagraphSpacing, RenderedPageBreakRun, Run, RunFormatting, SdtGroup, SectionBreakBlock, SectionBreakMeasure, SectionPageNumbering, TabAlignment, TabRun, TabStop, TableBlock, TableCell, TableCellMeasure, TableFragment, TableMeasure, TableRow, TableRowMeasure, TextBoxBlock, TextBoxFlowAttrs, TextBoxFragment, TextBoxMeasure, TextRun, floatingTextBoxReservesBand, floatingTextBoxWrapsText, getTableRowLeadingWidth, isFloatingImageRun, isFloatingTextBoxBlock, isListNumPr, isTextWrappingFloatingImageRun, resolveTableCellPadding, resolveTableWidthPx, tableColumnsArePinned, types_d_exports };
+export { BlockId, BorderStyle, CellBorderSpec, CellBorders, ColumnBreakBlock, ColumnBreakMeasure, ColumnLayout, DEFAULT_TEXTBOX_MARGINS, DEFAULT_TEXTBOX_WIDTH, DocumentPosition, FOOTNOTE_ENTRY_MARGIN_BOTTOM, FOOTNOTE_FALLBACK_LINE_HEIGHT, FOOTNOTE_SEPARATOR_HEIGHT, FieldRun, FloatingTablePosition, FlowBlock, FootnoteContent, Fragment, FragmentBase, HeaderFooterContent, HeaderFooterContentHeights, HeaderFooterLayout, HitTestResult, HyperlinkInfo, ImageBlock, ImageFragment, ImageMeasure, ImageRun, ImageRunPosition, Layout, LayoutOptions, LineBreakRun, ListMarkerFormatting, MathRun, Measure, MeasuredLine, NOTE_SEPARATOR_RULE_THICKNESS, NOTE_SEPARATOR_WIDTH_FRACTION, NoteAreaLayout, NoteSeparatorKind, NoteSeparatorRule, Page, PageBreakBlock, PageBreakMeasure, PageHeaderFooterRefs, PageMargins, ParagraphAttrs, ParagraphBlock, ParagraphBorders, ParagraphFragment, ParagraphIndent, ParagraphMeasure, ParagraphSpacing, RenderedPageBreakRun, Run, RunFormatting, SdtGroup, SectionBreakBlock, SectionBreakMeasure, SectionPageNumbering, TabAlignment, TabRun, TabStop, TableBlock, TableCell, TableCellMeasure, TableFragment, TableMeasure, TableRow, TableRowMeasure, TextBoxBlock, TextBoxFlowAttrs, TextBoxFragment, TextBoxMeasure, TextRun, floatingTextBoxReservesBand, floatingTextBoxWrapsText, getTableRowLeadingWidth, isFloatingImageRun, isFloatingTextBoxBlock, isListNumPr, isTextWrappingFloatingImageRun, resolveTableCellPadding, resolveTableWidthPx, stripFlowBlockPmAnchors, tableColumnsArePinned, types_d_exports };

package/dist/layout-engine/types.js

@@ -7,6 +7,8 @@ var types_exports = /* @__PURE__ */ __exportAll({
 	FOOTNOTE_ENTRY_MARGIN_BOTTOM: () => 0,
 	FOOTNOTE_FALLBACK_LINE_HEIGHT: () => 13,
 	FOOTNOTE_SEPARATOR_HEIGHT: () => 12,
+	NOTE_SEPARATOR_RULE_THICKNESS: () => NOTE_SEPARATOR_RULE_THICKNESS,
+	NOTE_SEPARATOR_WIDTH_FRACTION: () => NOTE_SEPARATOR_WIDTH_FRACTION,
 	floatingTextBoxReservesBand: () => floatingTextBoxReservesBand,
 	floatingTextBoxWrapsText: () => floatingTextBoxWrapsText,
 	getTableRowLeadingWidth: () => getTableRowLeadingWidth,
@@ -16,6 +18,7 @@ var types_exports = /* @__PURE__ */ __exportAll({
 	isTextWrappingFloatingImageRun: () => isTextWrappingFloatingImageRun,
 	resolveTableCellPadding: () => resolveTableCellPadding,
 	resolveTableWidthPx: () => resolveTableWidthPx,
+	stripFlowBlockPmAnchors: () => stripFlowBlockPmAnchors,
 	tableColumnsArePinned: () => tableColumnsArePinned
 });
 /**
@@ -69,6 +72,10 @@ const FOOTNOTE_SEPARATOR_HEIGHT = 12;
 * present in the source DOCX.
 */
 const FOOTNOTE_ENTRY_MARGIN_BOTTOM = 0;
+/** Thickness of a note separator rule, in the footnote band and in flowed endnotes. */
+const NOTE_SEPARATOR_RULE_THICKNESS = .5;
+/** Width of a `w:separator` rule as a fraction of its column. */
+const NOTE_SEPARATOR_WIDTH_FRACTION = .33;
 /**
 * Line height used when a footnote entry has no measured line height yet.
 * Conservative fallback so a missing measure does not collapse the entry.
@@ -189,5 +196,93 @@ const getTableRowLeadingWidth = (row, columnWidths) => {
 	if (tableRowOwnsNestedGrid(row)) return 0;
 	return columnWidths.slice(0, row.gridBefore ?? 0).reduce((sum, columnWidth) => sum + columnWidth, 0);
 };
+/**
+* A copy of a block with every ProseMirror anchor removed. A note story's
+* blocks carry positions in the note's own document; painted beside the body
+* they must not resolve a click, a selection or a caret into the body.
+*/
+function stripFlowBlockPmAnchors(block) {
+	switch (block.kind) {
+		case "paragraph": return stripParagraphPmAnchors(block);
+		case "table": return stripTablePmAnchors(block);
+		case "image": {
+			const { pmStart: _pmStart, pmEnd: _pmEnd, ...image } = block;
+			return image;
+		}
+		case "textBox": {
+			const { pmStart: _pmStart, pmEnd: _pmEnd, ...textBox } = block;
+			return {
+				...textBox,
+				content: textBox.content.map((contentBlock) => contentBlock.kind === "table" ? stripTablePmAnchors(contentBlock) : stripParagraphPmAnchors(contentBlock))
+			};
+		}
+		case "pageBreak":
+		case "columnBreak": {
+			const { pmStart: _pmStart, pmEnd: _pmEnd, ...breakBlock } = block;
+			return breakBlock;
+		}
+		case "sectionBreak": return block;
+		default: return block;
+	}
+}
+function stripTablePmAnchors(block) {
+	const { pmStart: _pmStart, pmEnd: _pmEnd, ...table } = block;
+	return {
+		...table,
+		rows: table.rows.map(stripTableRowPmAnchors)
+	};
+}
+function stripTableRowPmAnchors(row) {
+	return {
+		...row,
+		cells: row.cells.map(stripTableCellPmAnchors)
+	};
+}
+function stripTableCellPmAnchors(cell) {
+	return {
+		...cell,
+		blocks: cell.blocks.map(stripFlowBlockPmAnchors)
+	};
+}
+function stripParagraphPmAnchors(block) {
+	const { pmStart: _pmStart, pmEnd: _pmEnd, ...paragraph } = block;
+	return {
+		...paragraph,
+		runs: paragraph.runs.map(stripRunPmAnchors)
+	};
+}
+function stripRunPmAnchors(run) {
+	switch (run.kind) {
+		case "text": {
+			const { pmStart: _pmStart, pmEnd: _pmEnd, ...textRun } = run;
+			return textRun;
+		}
+		case "tab": {
+			const { pmStart: _pmStart, pmEnd: _pmEnd, ...tabRun } = run;
+			return tabRun;
+		}
+		case "image": {
+			const { pmStart: _pmStart, pmEnd: _pmEnd, ...imageRun } = run;
+			return imageRun;
+		}
+		case "lineBreak": {
+			const { pmStart: _pmStart, pmEnd: _pmEnd, ...lineBreakRun } = run;
+			return lineBreakRun;
+		}
+		case "field": {
+			const { pmStart: _pmStart, pmEnd: _pmEnd, ...fieldRun } = run;
+			return fieldRun;
+		}
+		case "math": {
+			const { pmStart: _pmStart, pmEnd: _pmEnd, ...mathRun } = run;
+			return mathRun;
+		}
+		case "renderedPageBreak": {
+			const { pmStart: _pmStart, pmEnd: _pmEnd, ...breakRun } = run;
+			return breakRun;
+		}
+		default: return run;
+	}
+}
 //#endregion
-export { DEFAULT_TEXTBOX_MARGINS, DEFAULT_TEXTBOX_WIDTH, FOOTNOTE_ENTRY_MARGIN_BOTTOM, FOOTNOTE_FALLBACK_LINE_HEIGHT, FOOTNOTE_SEPARATOR_HEIGHT, floatingTextBoxReservesBand, floatingTextBoxWrapsText, getTableRowLeadingWidth, isFloatingImageRun, isFloatingTextBoxBlock, isListNumPr, isTextWrappingFloatingImageRun, resolveTableCellPadding, resolveTableWidthPx, tableColumnsArePinned, types_exports };
+export { DEFAULT_TEXTBOX_MARGINS, DEFAULT_TEXTBOX_WIDTH, FOOTNOTE_ENTRY_MARGIN_BOTTOM, FOOTNOTE_FALLBACK_LINE_HEIGHT, FOOTNOTE_SEPARATOR_HEIGHT, NOTE_SEPARATOR_RULE_THICKNESS, NOTE_SEPARATOR_WIDTH_FRACTION, floatingTextBoxReservesBand, floatingTextBoxWrapsText, getTableRowLeadingWidth, isFloatingImageRun, isFloatingTextBoxBlock, isListNumPr, isTextWrappingFloatingImageRun, resolveTableCellPadding, resolveTableWidthPx, stripFlowBlockPmAnchors, tableColumnsArePinned, types_exports };

package/dist/layout-painter/index.d.ts

@@ -1,4 +1,5 @@
 import { FlowBlock, Layout, Measure } from "../layout-engine/types.js";
+import { NoteStoryKey } from "../types/editor-story.js";
 import { RenderContext } from "./renderUtils.js";
 import { BlockFor, FeatureDispatchInput, FeatureFallback, FeatureModule, FeatureRenderInput, FragmentFor, MeasureFor } from "./registry/types.js";
 import { FeatureRegistry, createFeatureRegistry } from "./registry/registry.js";
@@ -17,6 +18,8 @@ type BlockLookupEntry = {
   block: FlowBlock;
   measure: Measure;
   version?: string;
+  /** The note story a block flowed with the body belongs to (endnote content). */
+  noteStory?: NoteStoryKey;
 };
 /**
  * Block lookup map type