@stll/folio-core 0.61.0 → 0.63.0

package/dist/layout-engine/measure/tabCalculator.d.ts

@@ -13,15 +13,15 @@
 /**
  * Tab alignment types
  */
-type TabAlignment = "start" | "end" | "center" | "decimal" | "bar" | "clear";
+export type TabAlignment = "start" | "end" | "center" | "decimal" | "bar" | "clear";
 /**
  * Tab leader (fill character) types
  */
-type TabLeader = "none" | "dot" | "hyphen" | "underscore" | "middleDot" | "heavy";
+export type TabLeader = "none" | "dot" | "hyphen" | "underscore" | "middleDot" | "heavy";
 /**
  * Tab stop definition
  */
-type TabStop = {
+export type TabStop = {
   /** Tab alignment mode */
   val: TabAlignment;
   /** Position in twips from left margin */
@@ -32,7 +32,7 @@ type TabStop = {
 /**
  * Context for tab calculations
  */
-type TabContext = {
+export type TabContext = {
   /** Explicit tab stops from paragraph or style */
   explicitStops?: TabStop[];
   /** Default tab interval in twips (default: 720 = 0.5 inch) */
@@ -43,7 +43,7 @@ type TabContext = {
 /**
  * Result of tab width calculation
  */
-type TabWidthResult = {
+export type TabWidthResult = {
   /** Width of the tab in pixels */
   width: number;
   /** Leader character to render (if any) */
@@ -54,23 +54,23 @@ type TabWidthResult = {
   explicit?: true;
 };
 /** Default tab interval: 720 twips = 0.5 inch */
-declare const DEFAULT_TAB_INTERVAL_TWIPS = 720;
+export declare const DEFAULT_TAB_INTERVAL_TWIPS = 720;
 /** Twips per inch */
-declare const TWIPS_PER_INCH = 1440;
+export declare const TWIPS_PER_INCH = 1440;
 /** Pixels per inch (96 dpi standard for CSS) */
-declare const PIXELS_PER_INCH = 96;
+export declare const PIXELS_PER_INCH = 96;
 /**
  * Convert twips to pixels
  * @param twips - Value in twips (1/1440 inch)
  * @returns Value in pixels (at 96 dpi)
  */
-declare function twipsToPixels(twips: number): number;
+export declare function twipsToPixels(twips: number): number;
 /**
  * Convert pixels to twips
  * @param pixels - Value in pixels (at 96 dpi)
  * @returns Value in twips (1/1440 inch)
  */
-declare function pixelsToTwips(pixels: number): number;
+export declare function pixelsToTwips(pixels: number): number;
 /**
  * Compute the list of effective tab stops for a paragraph
  *
@@ -82,7 +82,7 @@ declare function pixelsToTwips(pixels: number): number;
  * @param context - Tab context with explicit stops and settings
  * @returns Sorted array of tab stops in twips
  */
-declare function computeTabStops(context: TabContext): TabStop[];
+export declare function computeTabStops(context: TabContext): TabStop[];
 /**
  * Pixel widths of the content after a tab, needed to position non-left stops.
  *
@@ -90,7 +90,7 @@ declare function computeTabStops(context: TabContext): TabStop[];
  * different run models and measurement paths) and passes the result here, so
  * this module owns the stop grid + alignment math without owning measurement.
  */
-type TabFollowingContent = {
+export type TabFollowingContent = {
   /** Total width of the runs after the tab. Used for `end` and `center` stops. */
   followingWidth?: number;
   /** Width of the content before the decimal separator. Used for `decimal` stops. */
@@ -110,7 +110,7 @@ type TabFollowingContent = {
  * @param following - Measured widths of the content after the tab
  * @returns Tab width result with width in pixels
  */
-declare function calculateTabWidth(currentXPx: number, context: TabContext, following?: TabFollowingContent): TabWidthResult;
+export declare function calculateTabWidth(currentXPx: number, context: TabContext, following?: TabFollowingContent): TabWidthResult;
 /**
  * Calculate tab width with simple default stops
  *
@@ -120,6 +120,5 @@ declare function calculateTabWidth(currentXPx: number, context: TabContext, foll
  * @param currentXPx - Current horizontal position in pixels
  * @returns Width of the tab in pixels
  */
-declare function calculateSimpleTabWidth(currentXPx: number): number;
-//#endregion
-export { DEFAULT_TAB_INTERVAL_TWIPS, PIXELS_PER_INCH, TWIPS_PER_INCH, TabAlignment, TabContext, TabFollowingContent, TabLeader, TabStop, TabWidthResult, calculateSimpleTabWidth, calculateTabWidth, computeTabStops, pixelsToTwips, twipsToPixels };
+export declare function calculateSimpleTabWidth(currentXPx: number): number;
+//#endregion

package/dist/layout-engine/measure/tableCellFloating.d.ts

@@ -1,7 +1,7 @@
 import { ImageRun, TableCell, TableCellMeasure } from "../types.js";
 import { FloatingImageZone } from "./floatingZones.js";
 //#region src/layout-engine/measure/tableCellFloating.d.ts
-type TableCellFloatingImage = {
+export type TableCellFloatingImage = {
   src: string;
   width: number;
   height: number;
@@ -28,9 +28,9 @@ type TableCellFloatingImage = {
   pmEnd?: number;
 };
 type TableCellFloatingPosition = Pick<TableCellFloatingImage, "x" | "y" | "side">;
-type ResolveTableCellFloatingPosition = (run: ImageRun, paragraphY: number) => TableCellFloatingPosition;
-declare function getTableCellContentWidth(cell: TableCell | undefined, cellMeasure: TableCellMeasure): number;
-declare function getTableCellFloatingImages(cell: TableCell, cellMeasure: TableCellMeasure, contentWidth: number, resolvePosition?: ResolveTableCellFloatingPosition): TableCellFloatingImage[];
-declare function buildTableCellFloatingZones(floatingImages: TableCellFloatingImage[], contentWidth: number): FloatingImageZone[];
+export type ResolveTableCellFloatingPosition = (run: ImageRun, paragraphY: number) => TableCellFloatingPosition;
+export declare function getTableCellContentWidth(cell: TableCell | undefined, cellMeasure: TableCellMeasure): number;
+export declare function getTableCellFloatingImages(cell: TableCell, cellMeasure: TableCellMeasure, contentWidth: number, resolvePosition?: ResolveTableCellFloatingPosition): TableCellFloatingImage[];
+export declare function buildTableCellFloatingZones(floatingImages: TableCellFloatingImage[], contentWidth: number): FloatingImageZone[];
 //#endregion
-export { ResolveTableCellFloatingPosition, TableCellFloatingImage, buildTableCellFloatingZones, getTableCellContentWidth, getTableCellFloatingImages };
+export {};

package/dist/layout-engine/measure/tableCellFlow.d.ts

@@ -1,6 +1,6 @@
 import { FlowBlock, Measure } from "../types.js";
 //#region src/layout-engine/measure/tableCellFlow.d.ts
-type TableCellBlockPlacement = {
+export type TableCellBlockPlacement = {
   top: number;
   contentTop: number;
   contentHeight: number;
@@ -25,15 +25,15 @@ type TableCellTrailingSpacing = {
   type: typeof TABLE_CELL_TRAILING_SPACING_TYPE.automatic;
   value: number;
 };
-type TableCellFlowState = {
+export type TableCellFlowState = {
   height: number;
   position: TableCellFlowPosition;
   previousParagraphWasEmpty: boolean;
   trailingSpacing: TableCellTrailingSpacing;
 };
-declare const createTableCellFlowState: () => TableCellFlowState;
-declare const finishTableCellFlow: (state: TableCellFlowState) => number;
-declare const getTableCellBlockContentHeight: (block: FlowBlock, measure: Measure) => number;
+export declare const createTableCellFlowState: () => TableCellFlowState;
+export declare const finishTableCellFlow: (state: TableCellFlowState) => number;
+export declare const getTableCellBlockContentHeight: (block: FlowBlock, measure: Measure) => number;
 /**
  * Place one block in an unpaginated table-cell story.
  *
@@ -41,6 +41,6 @@ declare const getTableCellBlockContentHeight: (block: FlowBlock, measure: Measur
  * authored empty paragraphs remain independent vertical spacers, including
  * at the end of the cell.
  */
-declare const placeTableCellBlock: (state: TableCellFlowState, block: FlowBlock, measure: Measure) => TableCellBlockPlacement;
+export declare const placeTableCellBlock: (state: TableCellFlowState, block: FlowBlock, measure: Measure) => TableCellBlockPlacement;
 //#endregion
-export { TableCellBlockPlacement, TableCellFlowState, createTableCellFlowState, finishTableCellFlow, getTableCellBlockContentHeight, placeTableCellBlock };
+export {};

package/dist/layout-engine/measure/tableCellGrid.d.ts

@@ -1,17 +1,17 @@
 import { TableCell, TableRow } from "../types.js";
 //#region src/layout-engine/measure/tableCellGrid.d.ts
-type TableCellGrid = {
+export type TableCellGrid = {
   occupiedColumnsByRow: ReadonlyMap<number, ReadonlySet<number>>;
   sourceCellsByRow: ReadonlyMap<number, ReadonlyMap<number, TableCell>>;
   sourceColumnsByCell: ReadonlyMap<TableCell, number>;
 };
-type TableCellPlacement = {
+export type TableCellPlacement = {
   sourceColumn: number;
   columnSpan: number;
   left: number;
   width: number;
 };
-type TableCellPlacements = ReadonlyMap<TableCell, TableCellPlacement>;
+export type TableCellPlacements = ReadonlyMap<TableCell, TableCellPlacement>;
 type BuildTableCellPlacementsOptions = {
   grid: TableCellGrid;
   columnWidths: readonly number[];
@@ -19,11 +19,11 @@ type BuildTableCellPlacementsOptions = {
   /** `w:tblCellSpacing` in pixels; see {@link getTableCellSpacingInsetsX}. */
   cellSpacing?: number | undefined;
 };
-type TableCellSpacingInsets = {
+export type TableCellSpacingInsets = {
   readonly start: number;
   readonly end: number;
 };
-type TableCellSpacingInsetsY = {
+export type TableCellSpacingInsetsY = {
   readonly top: number;
   readonly bottom: number;
 };
@@ -34,20 +34,20 @@ type TableCellSpacingInsetsY = {
  * its slot, and a slot at the table's leading or trailing grid edge keeps one
  * more for the edge itself.
  */
-declare const getTableCellSpacingInsetsX: (cellSpacing: number | undefined, sourceColumn: number, columnSpan: number, columnCount: number) => TableCellSpacingInsets;
+export declare const getTableCellSpacingInsetsX: (cellSpacing: number | undefined, sourceColumn: number, columnSpan: number, columnCount: number) => TableCellSpacingInsets;
 /**
  * Block-direction insets of a cell box inside the rows it spans, the
  * `w:tblCellSpacing` counterpart of {@link getTableCellSpacingInsetsX}: one
  * unit above and below every cell, plus one more at the table's first and
  * last rows.
  */
-declare const getTableCellSpacingInsetsY: (cellSpacing: number | undefined, rowIndex: number, rowSpan: number, rowCount: number) => TableCellSpacingInsetsY;
-declare const buildTableCellGrid: (rows: readonly TableRow[], columnCount: number) => TableCellGrid;
-declare const getFirstAvailableColumn: (grid: TableCellGrid, rowIndex: number, startingColumn: number) => number;
-declare const getSourceCellAt: (grid: TableCellGrid, rowIndex: number, columnIndex: number) => TableCell | undefined;
-declare const getSourceCellColumn: (grid: TableCellGrid, cell: TableCell) => number | undefined;
+export declare const getTableCellSpacingInsetsY: (cellSpacing: number | undefined, rowIndex: number, rowSpan: number, rowCount: number) => TableCellSpacingInsetsY;
+export declare const buildTableCellGrid: (rows: readonly TableRow[], columnCount: number) => TableCellGrid;
+export declare const getFirstAvailableColumn: (grid: TableCellGrid, rowIndex: number, startingColumn: number) => number;
+export declare const getSourceCellAt: (grid: TableCellGrid, rowIndex: number, columnIndex: number) => TableCell | undefined;
+export declare const getSourceCellColumn: (grid: TableCellGrid, cell: TableCell) => number | undefined;
 /** Resolve all source cells to canonical logical columns and physical boxes. */
-declare const buildTableCellPlacements: ({ grid, columnWidths, bidi, cellSpacing }: BuildTableCellPlacementsOptions) => TableCellPlacements;
-declare const getTableCellVerticalBorderHeight: (grid: TableCellGrid, cell: TableCell | undefined, rowIndex: number, separated?: boolean) => number;
+export declare const buildTableCellPlacements: ({ grid, columnWidths, bidi, cellSpacing }: BuildTableCellPlacementsOptions) => TableCellPlacements;
+export declare const getTableCellVerticalBorderHeight: (grid: TableCellGrid, cell: TableCell | undefined, rowIndex: number, separated?: boolean) => number;
 //#endregion
-export { TableCellGrid, TableCellPlacement, TableCellPlacements, TableCellSpacingInsets, TableCellSpacingInsetsY, buildTableCellGrid, buildTableCellPlacements, getFirstAvailableColumn, getSourceCellAt, getSourceCellColumn, getTableCellSpacingInsetsX, getTableCellSpacingInsetsY, getTableCellVerticalBorderHeight };
+export {};

package/dist/layout-engine/measure/tableFragmentBorderGeometry.d.ts

@@ -12,6 +12,6 @@ type TableFragmentBottomBordersOptions = {
   readonly measure: TableMeasure;
   readonly placements?: TableCellPlacements;
 };
-declare const tableFragmentBottomBorders: ({ fragment, block, measure, placements: suppliedPlacements }: TableFragmentBottomBordersOptions) => readonly TableFragmentBottomBorder[];
+export declare const tableFragmentBottomBorders: ({ fragment, block, measure, placements: suppliedPlacements }: TableFragmentBottomBordersOptions) => readonly TableFragmentBottomBorder[];
 //#endregion
-export { tableFragmentBottomBorders };
+export {};

package/dist/layout-engine/measure/tableInlinePlacement.d.ts

@@ -8,7 +8,7 @@ type TableInlinePlacement = {
 };
 type LeadingEdgeTable = Pick<TableBlock, "bidi" | "indent" | "indentCompatibility" | "justification" | "rows">;
 /** Resolve an inline table's horizontal anchor without losing RTL leading-edge semantics. */
-declare const resolveTableInlinePlacement: (table: LeadingEdgeTable, rowJustification?: TableBlock["justification"]) => TableInlinePlacement;
+export declare const resolveTableInlinePlacement: (table: LeadingEdgeTable, rowJustification?: TableBlock["justification"]) => TableInlinePlacement;
 type ResolveTableInlineOffsetOptions = {
   table: LeadingEdgeTable;
   rowJustification?: TableBlock["justification"];
@@ -16,6 +16,6 @@ type ResolveTableInlineOffsetOptions = {
   tableWidth: number;
 };
 /** Resolve a table's physical inline offset within its current content frame. */
-declare const resolveTableInlineOffset: ({ table, rowJustification, frameWidth, tableWidth }: ResolveTableInlineOffsetOptions) => number;
+export declare const resolveTableInlineOffset: ({ table, rowJustification, frameWidth, tableWidth }: ResolveTableInlineOffsetOptions) => number;
 //#endregion
-export { resolveTableInlineOffset, resolveTableInlinePlacement };
+export {};

package/dist/layout-engine/measure/textBoxParagraphLayout.d.ts

@@ -1,10 +1,10 @@
 import { ParagraphBlock, ParagraphMeasure, TableBlock, TableMeasure } from "../types.js";
 //#region src/layout-engine/measure/textBoxParagraphLayout.d.ts
-type TextBoxContentPlacement = {
+export type TextBoxContentPlacement = {
   leadingSpacing: number;
   contentHeight: number;
 };
-type TextBoxContentLayout = {
+export type TextBoxContentLayout = {
   placements: TextBoxContentPlacement[];
   totalHeight: number;
 };
@@ -14,6 +14,6 @@ type TextBoxContentMeasure = ParagraphMeasure | TableMeasure;
  * Lay out a text box's block story as one unpaginated flow. Adjacent paragraph
  * before/after spacing collapses to the larger value, matching body flow.
  */
-declare function layoutTextBoxContent(blocks: readonly TextBoxContentBlock[], measures: readonly TextBoxContentMeasure[]): TextBoxContentLayout;
+export declare function layoutTextBoxContent(blocks: readonly TextBoxContentBlock[], measures: readonly TextBoxContentMeasure[]): TextBoxContentLayout;
 //#endregion
-export { TextBoxContentLayout, TextBoxContentPlacement, layoutTextBoxContent };
+export {};

package/dist/layout-engine/measure/textMeasurementPolicy.d.ts

@@ -1,19 +1,19 @@
-import { RunFormatting } from "../types.js";
 import { FontStyle } from "./measureTypes.js";
+import { RunFormatting } from "../types.js";
 //#region src/layout-engine/measure/textMeasurementPolicy.d.ts
-declare const FONT_KERNING_MODE: {
+export declare const FONT_KERNING_MODE: {
   readonly enabled: "normal";
   readonly disabled: "none";
 };
-type FontKerningMode = (typeof FONT_KERNING_MODE)[keyof typeof FONT_KERNING_MODE];
+export type FontKerningMode = (typeof FONT_KERNING_MODE)[keyof typeof FONT_KERNING_MODE];
 type RunKerningInput = Pick<RunFormatting, "fontSize" | "kerningMinPt">;
 /** Resolve an authored kerning threshold against the effective run size. */
-declare function getRunFontKerningMode(run: RunKerningInput, fallbackFontSize: number): FontKerningMode;
+export declare function getRunFontKerningMode(run: RunKerningInput, fallbackFontSize: number): FontKerningMode;
 /** Convert normalized measurement style into the canvas/CSS kerning mode. */
-declare function getFontKerningMode(style: Pick<FontStyle, "kerning">): FontKerningMode;
+export declare function getFontKerningMode(style: Pick<FontStyle, "kerning">): FontKerningMode;
 /** Count ordinary ASCII spaces that justification may compress. */
-declare function countCompressibleSpaces(text: string): number;
+export declare function countCompressibleSpaces(text: string): number;
 /** Paint OOXML no-break hyphens with the ordinary hyphen glyph. */
-declare function toPaintedText(text: string): string;
+export declare function toPaintedText(text: string): string;
 //#endregion
-export { FONT_KERNING_MODE, FontKerningMode, countCompressibleSpaces, getFontKerningMode, getRunFontKerningMode, toPaintedText };
+export {};

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

@@ -0,0 +1,7 @@
+import { LayoutOptions } from "./types.js";
+//#region src/layout-engine/noColumnBalanceCompatibility.d.ts
+type ColumnBalancing = NonNullable<LayoutOptions["columnBalancing"]>;
+/** `w:noColumnBalance` is ignored beginning with compatibility mode 15. */
+export declare const columnBalancingForCompatibility: (noColumnBalance: boolean | undefined, compatibilityMode: number | undefined) => ColumnBalancing;
+//#endregion
+export {};

package/dist/layout-engine/noColumnBalanceCompatibility.js

@@ -0,0 +1,5 @@
+//#region src/layout-engine/noColumnBalanceCompatibility.ts
+/** `w:noColumnBalance` is ignored beginning with compatibility mode 15. */
+const columnBalancingForCompatibility = (noColumnBalance, compatibilityMode) => noColumnBalance === true && (compatibilityMode === void 0 || compatibilityMode < 15) ? "natural" : "balanced";
+//#endregion
+export { columnBalancingForCompatibility };

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

@@ -6,14 +6,13 @@ import { PageTopContinuation, Paginator } from "./paginator.js";
  * 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;
+export 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;
+export 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
+ * Record note identities and 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 };
+export declare function annotateNoteAreas(layout: Layout, blocks: readonly FlowBlock[], measures: readonly Measure[], noteAreas: NoteAreaLayout | undefined): Layout;
+//#endregion

package/dist/layout-engine/noteAreaFlow.js

@@ -39,15 +39,15 @@ function createNoteAreaContinuation(noteAreas, paginator) {
 }
 /** 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;
+	return noteAreas?.noteStoryByBlockId.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
+* Record note identities and 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;
+function annotateNoteAreas(layout, blocks, measures, noteAreas) {
+	if (noteAreas === void 0) return layout;
 	const measureById = /* @__PURE__ */ new Map();
 	for (const [index, block] of blocks.entries()) {
 		const measure = measures[index];
@@ -56,6 +56,12 @@ function annotateNoteSeparators(layout, blocks, measures, noteAreas) {
 	const continuation = noteAreas.continuationSeparator;
 	if (continuation !== void 0) measureById.set(String(continuation.block.id), continuation.measure);
 	for (const page of layout.pages) {
+		const endnoteIds = /* @__PURE__ */ new Set();
+		for (const fragment of page.fragments) {
+			const story = noteAreas.noteStoryByBlockId.get(String(fragment.blockId));
+			if (story?.kind === "endnote") endnoteIds.add(story.noteId);
+		}
+		if (endnoteIds.size > 0) page.endnoteIds = [...endnoteIds];
 		const rules = [];
 		for (const fragment of page.fragments) {
 			if (fragment.kind !== "paragraph" || fragment.fromLine !== 0) continue;
@@ -80,4 +86,4 @@ function separatorWidthFraction(kind) {
 	}
 }
 //#endregion
-export { annotateNoteSeparators, continuesNoteArea, createNoteAreaContinuation };
+export { annotateNoteAreas, continuesNoteArea, createNoteAreaContinuation };

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

@@ -3,7 +3,7 @@ import { ColumnLayout, FOOTNOTE_SEPARATOR_HEIGHT, Fragment, Page, PageHeaderFoot
 /**
  * Current state of a page being laid out.
  */
-type PageState = {
+export type PageState = {
   /** The page being built. */
   page: Page;
   /** Current Y position (cursor) from page top. */
@@ -32,7 +32,7 @@ type PageState = {
 /**
  * Options for creating a paginator.
  */
-type PaginatorOptions = {
+export type PaginatorOptions = {
   /** Page size (width, height). */
   pageSize: {
     w: number;
@@ -73,8 +73,8 @@ type ForcePageBreakOptions = {
  * 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: {
+export type PageTopContinuation = (state: PageState, x: number, width: number) => number;
+export declare const SECTION_START_PLACEMENT: {
   readonly CONTINUOUS: "continuous";
   readonly NEXT_PAGE: "nextPage";
 };
@@ -85,9 +85,9 @@ type StartSectionOptions = {
   placement?: SectionStartPlacement;
 };
 /** Calculate active column widths, preferring authored unequal widths. */
-declare function calculateColumnWidths(pageWidth: number, leftMargin: number, rightMargin: number, columns: ColumnLayout): number[];
+export declare function calculateColumnWidths(pageWidth: number, leftMargin: number, rightMargin: number, columns: ColumnLayout): number[];
 /** Resolve every column's absolute page X in one pass. */
-declare function calculateColumnLefts(leftMargin: number, columnWidths: readonly number[], columns: ColumnLayout): number[];
+export declare function calculateColumnLefts(leftMargin: number, columnWidths: readonly number[], columns: ColumnLayout): number[];
 type ResolveColumnLeftOptions = {
   leftMargin: number;
   columnWidths: readonly number[];
@@ -95,11 +95,11 @@ type ResolveColumnLeftOptions = {
   columnIndex: number;
 };
 /** Resolve an active column's absolute page X from the shared width/gap model. */
-declare function resolveColumnLeft({ leftMargin, columnWidths, columns, columnIndex }: ResolveColumnLeftOptions): number;
+export declare function resolveColumnLeft({ leftMargin, columnWidths, columns, columnIndex }: ResolveColumnLeftOptions): number;
 /**
  * Creates a paginator for managing page layout state.
  */
-declare function createPaginator(options: PaginatorOptions): {
+export declare function createPaginator(options: PaginatorOptions): {
   /** All pages created so far. */
   readonly pages: Page[];
   /** All page states. */
@@ -126,7 +126,14 @@ declare function createPaginator(options: PaginatorOptions): {
   /** Check if height fits in current column. */
   fits: (height: number) => boolean;
   /** Ensure height fits, advancing if needed. */
-  ensureFits: (height: number) => PageState;
+  ensureFits: {
+    (height: number): PageState;
+    (options: {
+      requiredHeight: number;
+      freshColumnHeight?: number;
+    }): PageState;
+  };
+  isAtFreshColumnRegion: () => boolean;
   /** Add a fragment to current page. */
   addFragment: (fragment: Fragment, height: number, spaceBefore?: number, spaceAfter?: number) => {
     state: PageState;
@@ -159,6 +166,6 @@ declare function createPaginator(options: PaginatorOptions): {
   /** Set (or clear) the content that opens each page a flow continues onto. */
   setPageTopContinuation: (continuation: PageTopContinuation | undefined) => void;
 };
-type Paginator = ReturnType<typeof createPaginator>;
+export type Paginator = ReturnType<typeof createPaginator>;
 //#endregion
-export { FOOTNOTE_SEPARATOR_HEIGHT, PageState, PageTopContinuation, Paginator, PaginatorOptions, SECTION_START_PLACEMENT, calculateColumnLefts, calculateColumnWidths, createPaginator, resolveColumnLeft };
+export { FOOTNOTE_SEPARATOR_HEIGHT };

package/dist/layout-engine/paginator.js

@@ -1,3 +1,4 @@
+import { columnPictureClipViewportForColumn } from "../utils/paragraphInlineLayout.js";
 import { collapseParagraphSpacing } from "./paragraphSpacing.js";
 import { FOOTNOTE_SEPARATOR_HEIGHT } from "./types.js";
 import { panic } from "better-result";
@@ -119,6 +120,25 @@ function createPaginator(options) {
 			columnIndex
 		});
 	}
+	function getColumnPictureViewport(columnIndex) {
+		const state = getCurrentState();
+		if (columns.count < 2) return {
+			left: 0,
+			right: state.page.size.w
+		};
+		const horizontalColumns = Array.from({ length: columns.count }, (_, index) => ({
+			left: getColumnX(index),
+			width: columnWidths[index] ?? 0
+		}));
+		return columnPictureClipViewportForColumn({
+			paper: {
+				left: 0,
+				right: state.page.size.w
+			},
+			columns: horizontalColumns,
+			columnIndex
+		});
+	}
 	function getPagePaginationState(page) {
 		const state = paginationStateByPage.get(page);
 		if (!state) panic("Paginator: page visibility state is missing");
@@ -229,20 +249,27 @@ function createPaginator(options) {
 		}
 		return createNewPage();
 	}
-	/**
-	* Ensure content of given height can fit.
-	* Advances column or creates new page if needed.
-	* Returns the state to use for placement.
-	*/
-	function ensureFits(height) {
+	function ensureFits(input) {
 		let state = getCurrentState();
-		const safeHeight = Number.isFinite(height) && height > 0 ? height : 0;
-		while (!fits(safeHeight, state)) {
-			if (safeHeight > state.contentBottom - columnRegionTop) {
+		const requiredHeight = typeof input === "number" ? input : input.requiredHeight;
+		const safeHeight = Number.isFinite(requiredHeight) && requiredHeight > 0 ? requiredHeight : 0;
+		const freshColumnHeight = typeof input === "number" ? void 0 : input.freshColumnHeight;
+		const safeFreshColumnHeight = freshColumnHeight !== void 0 && Number.isFinite(freshColumnHeight) && freshColumnHeight > 0 ? freshColumnHeight : safeHeight;
+		let heightToFit = state.columnIndex > 0 && state.cursorY === columnRegionTop ? safeFreshColumnHeight : safeHeight;
+		while (!fits(heightToFit, state)) {
+			const columnCapacity = state.contentBottom - columnRegionTop;
+			if (heightToFit > columnCapacity) {
+				if (state.columnIndex < columns.count - 1 && safeFreshColumnHeight <= columnCapacity) {
+					state = advanceColumn(state);
+					heightToFit = safeFreshColumnHeight;
+					continue;
+				}
+				if (columnRegionTop > state.topMargin) return forcePageBreak();
 				if (state.cursorY !== state.topMargin) state = advanceColumn(state);
 				return state;
 			}
 			state = advanceColumn(state);
+			heightToFit = state.columnIndex > 0 && state.cursorY === columnRegionTop ? safeFreshColumnHeight : safeHeight;
 		}
 		return state;
 	}
@@ -257,12 +284,17 @@ function createPaginator(options) {
 			before: spaceBefore,
 			after: initialState.trailingSpacing
 		});
-		const state = ensureFits(effectiveSpaceBefore + height);
-		const actualSpaceBefore = state === initialState && state.columnIndex === initialColumnIndex ? effectiveSpaceBefore : spaceBefore;
+		const state = ensureFits({
+			requiredHeight: effectiveSpaceBefore + height,
+			freshColumnHeight: height
+		});
+		let actualSpaceBefore = state === initialState && state.columnIndex === initialColumnIndex ? effectiveSpaceBefore : spaceBefore;
+		if (state.columnIndex > 0 && state.cursorY === columnRegionTop) actualSpaceBefore = 0;
 		const x = getColumnX(state.columnIndex);
 		const y = state.cursorY + actualSpaceBefore;
 		fragment.x = x;
 		fragment.y = y;
+		if (fragment.kind === "paragraph") fragment.inlinePictureViewport = getColumnPictureViewport(state.columnIndex);
 		commitFragment(state, fragment);
 		state.cursorY = y + height;
 		state.trailingSpacing = spaceAfter;
@@ -289,6 +321,10 @@ function createPaginator(options) {
 	}
 	function addUnflowedFragment(fragment) {
 		const state = getCurrentState();
+		if (fragment.kind === "paragraph" && fragment.inlinePictureViewport === void 0) fragment.inlinePictureViewport = {
+			left: fragment.x,
+			right: fragment.x + fragment.width
+		};
 		commitFragment(state, fragment);
 		return state;
 	}
@@ -494,6 +530,10 @@ function createPaginator(options) {
 		fits: (height) => fits(height),
 		/** Ensure height fits, advancing if needed. */
 		ensureFits,
+		isAtFreshColumnRegion: () => {
+			const state = getCurrentState();
+			return state.columnIndex > 0 && state.cursorY === columnRegionTop;
+		},
 		/** Add a fragment to current page. */
 		addFragment,
 		/** Add an already-positioned fragment without advancing normal flow. */

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

@@ -1,8 +1,7 @@
 import { ParagraphBlock, ParagraphMeasure } from "./types.js";
 //#region src/layout-engine/paragraphFragmentRange.d.ts
-declare function getParagraphFragmentPmRange(block: ParagraphBlock, measure: ParagraphMeasure, fromLine: number, toLine: number): {
+export declare function getParagraphFragmentPmRange(block: ParagraphBlock, measure: ParagraphMeasure, fromLine: number, toLine: number): {
   pmStart?: number;
   pmEnd?: number;
 };
-//#endregion
-export { getParagraphFragmentPmRange };
+//#endregion

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

@@ -1,21 +1,2 @@
-import { ParagraphBlock, TextBoxBlock } from "./types.js";
-//#region src/layout-engine/paragraphFrame.d.ts
-type ParagraphFrame = {
-  width?: number;
-  height?: number;
-  hSpace?: number;
-  vSpace?: number;
-  hAnchor?: "text" | "margin" | "page";
-  vAnchor?: "text" | "margin" | "page";
-  x?: number;
-  y?: number;
-  xAlign?: "left" | "center" | "right" | "inside" | "outside";
-  yAlign?: "top" | "center" | "bottom" | "inside" | "outside" | "inline";
-  wrap?: "around" | "auto" | "none" | "notBeside" | "through" | "tight";
-};
-declare function setParagraphFrame(block: ParagraphBlock, frame: ParagraphFrame): void;
-declare function getParagraphFrame(block: ParagraphBlock): ParagraphFrame | undefined;
-declare function markParagraphFrameTextBox(block: TextBoxBlock): void;
-declare function isParagraphFrameTextBox(block: TextBoxBlock): boolean;
-//#endregion
-export { ParagraphFrame, getParagraphFrame, isParagraphFrameTextBox, markParagraphFrameTextBox, setParagraphFrame };
+import { ParagraphFrame, getParagraphFrame, isParagraphFrameTextBox, markParagraphFrameTextBox, setParagraphFrame } from "../utils/paragraphFrame.js";
+export { type ParagraphFrame, getParagraphFrame, isParagraphFrameTextBox, markParagraphFrameTextBox, setParagraphFrame };

package/dist/layout-engine/paragraphFrame.js

@@ -1,17 +1 @@
-//#region src/layout-engine/paragraphFrame.ts
-const paragraphFrames = /* @__PURE__ */ new WeakMap();
-const paragraphFrameTextBoxes = /* @__PURE__ */ new WeakSet();
-function setParagraphFrame(block, frame) {
-	paragraphFrames.set(block, frame);
-}
-function getParagraphFrame(block) {
-	return paragraphFrames.get(block);
-}
-function markParagraphFrameTextBox(block) {
-	paragraphFrameTextBoxes.add(block);
-}
-function isParagraphFrameTextBox(block) {
-	return paragraphFrameTextBoxes.has(block);
-}
-//#endregion
-export { getParagraphFrame, isParagraphFrameTextBox, markParagraphFrameTextBox, setParagraphFrame };
+export { getParagraphFrame, isParagraphFrameTextBox, markParagraphFrameTextBox, setParagraphFrame } from "../utils/paragraphFrame.js";

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

@@ -18,6 +18,6 @@ type LayoutParagraphOptions = {
   footnoteHeightById: Map<number, number> | undefined;
   suppressSpaceBefore: boolean;
 };
-declare function layoutParagraph({ block, measure, paginator, contentWidth, footnoteHeightById, suppressSpaceBefore }: LayoutParagraphOptions): void;
+export declare function layoutParagraph({ block, measure, paginator, contentWidth, footnoteHeightById, suppressSpaceBefore }: LayoutParagraphOptions): void;
 //#endregion
-export { layoutParagraph };
+export {};