@stll/folio-core 0.14.1 → 0.15.1

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

@@ -427,6 +427,28 @@ function trimTrailingSpacesAndTabs(text) {
 	}
 	return text.slice(0, end);
 }
+function measureWordWithTrailingWhitespace(word, style) {
+	const measuredWord = trimTrailingSpacesAndTabs(word);
+	const wordWidth = measureTextWidth(measuredWord, style);
+	const trailingWhitespace = word.slice(measuredWord.length);
+	if (trailingWhitespace.length === 0) return {
+		measuredWord,
+		wordWidth,
+		fullWordWidth: wordWidth
+	};
+	if (style.kerning || trailingWhitespace.includes("	")) return {
+		measuredWord,
+		wordWidth,
+		fullWordWidth: measureTextWidth(word, style)
+	};
+	const trailingWhitespaceWidth = measureTextWidth(trailingWhitespace, style);
+	const boundarySpacing = measuredWord.length > 0 ? (style.letterSpacing ?? 0) * ((style.horizontalScale ?? 100) / 100) : 0;
+	return {
+		measuredWord,
+		wordWidth,
+		fullWordWidth: wordWidth + trailingWhitespaceWidth + boundarySpacing
+	};
+}
 function trailingCodePoint(text) {
 	if (text.length === 0) return;
 	const trailing = text.charCodeAt(text.length - 1);
@@ -1012,9 +1034,7 @@ function measureParagraph(block, maxWidth, options) {
 				while ((wordBreaks[wordBreakIndex] ?? Number.POSITIVE_INFINITY) <= charIndex) wordBreakIndex += 1;
 				const nextBreak = wordBreaks[wordBreakIndex] ?? text.length;
 				const word = text.slice(charIndex, nextBreak);
-				const measuredWord = trimTrailingSpacesAndTabs(word);
-				const wordWidth = measureTextWidth(measuredWord, style);
-				const fullWordWidth = measureTextWidth(word, style);
+				const { measuredWord, wordWidth, fullWordWidth } = measureWordWithTrailingWhitespace(word, style);
 				const hangingPunctuationWidth = trailingHangingPunctuationWidth(measuredWord, style, breakPolicy, effectiveLineBreakPolicy.hangingPunctuation);
 				const isFirstLine = lines.length === 0;
 				const regularSpaceWidth = compressibleSpaceWidth(measuredWord, style);

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

@@ -1,5 +1,4 @@
 import { FontMetrics, FontStyle, RunMeasurement, TextMeasurement } from "./measureTypes.js";
-
 //#region src/layout-engine/measure/measureProvider.d.ts
 /**
  * Swappable text-measurement backend. A canvas implementation is installed at

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

@@ -27,7 +27,8 @@ type FontStyle = {
   letterSpacing?: number;
   textTransform?: "uppercase";
   fontVariant?: "small-caps";
-  horizontalScale?: number; /** Enable pair kerning for runs whose authored threshold is met. */
+  horizontalScale?: number;
+  /** Enable pair kerning for runs whose authored threshold is met. */
   kerning?: boolean;
 };
 /**
@@ -38,7 +39,8 @@ type FontMetrics = {
   ascent: number;
   descent: number;
   lineHeight: number;
-  fontFamily: string; /** OS/2 single-line ratio for OOXML line spacing calculation */
+  fontFamily: string;
+  /** OS/2 single-line ratio for OOXML line spacing calculation */
   singleLineRatio: number;
 };
 /**

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

@@ -1,5 +1,4 @@
 import { MeasureRequestEntry, MeasureWorkerRequest, MeasureWorkerResponse } from "./measureWorkerProtocol.js";
-
 //#region src/layout-engine/measure/measureWorker.d.ts
 /**
  * Minimal duck-typed transport so tests can supply a fake instead of a

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

@@ -1,5 +1,4 @@
 import { FontKerningMode } from "./textMeasurementPolicy.js";
-
 //#region src/layout-engine/measure/measureWorkerProtocol.d.ts
 /**
  * Single measurement request inside a batch. Mirrors the inputs that

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

@@ -1,6 +1,5 @@
 import { ImageRun, TableCell, TableCellMeasure } from "../types.js";
 import { FloatingImageZone } from "./floatingZones.js";
-
 //#region src/layout-engine/measure/tableCellFloating.d.ts
 type TableCellFloatingImage = {
   src: string;

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

@@ -1,5 +1,4 @@
 import { FlowBlock, Measure } from "../types.js";
-
 //#region src/layout-engine/measure/tableCellFlow.d.ts
 type TableCellBlockPlacement = {
   top: number;

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

@@ -1,5 +1,4 @@
 import { TableCell, TableRow } from "../types.js";
-
 //#region src/layout-engine/measure/tableCellGrid.d.ts
 type TableCellGrid = {
   occupiedColumnsByRow: ReadonlyMap<number, ReadonlySet<number>>;

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

@@ -1,5 +1,4 @@
 import { ParagraphBlock, ParagraphMeasure, TableBlock, TableMeasure } from "../types.js";
-
 //#region src/layout-engine/measure/textBoxParagraphLayout.d.ts
 type TextBoxContentPlacement = {
   leadingSpacing: number;

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

@@ -1,6 +1,5 @@
 import { RunFormatting } from "../types.js";
 import { FontStyle } from "./measureTypes.js";
-
 //#region src/layout-engine/measure/textMeasurementPolicy.d.ts
 declare const FONT_KERNING_MODE: {
   readonly enabled: "normal";

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

@@ -1,33 +1,42 @@
 import { ColumnLayout, FOOTNOTE_SEPARATOR_HEIGHT, Fragment, Page, PageHeaderFooterRefs, PageMargins } from "./types.js";
-
 //#region src/layout-engine/paginator.d.ts
 /**
  * Current state of a page being laid out.
  */
 type PageState = {
-  /** The page being built. */page: Page; /** Current Y position (cursor) from page top. */
-  cursorY: number; /** Current column index (0-based). */
-  columnIndex: number; /** Top margin of content area. */
+  /** The page being built. */
+  page: Page;
+  /** Current Y position (cursor) from page top. */
+  cursorY: number;
+  /** Current column index (0-based). */
+  columnIndex: number;
+  /** Top margin of content area. */
   topMargin: number;
   /**
    * Bottom boundary of usable body content area.
    * Equals `pageBottom - footnoteHeight`. Recomputed when footnote
    * demand grows (a line carrying a fn ref is placed on this page).
    */
-  contentBottom: number; /** Raw bottom of content area (page height - bottom margin); excludes fn area. */
-  rawContentBottom: number; /** Total height reserved for footnotes on this page (grows as refs are placed). */
-  footnoteHeight: number; /** Accumulated trailing spacing (space after previous block). */
+  contentBottom: number;
+  /** Raw bottom of content area (page height - bottom margin); excludes fn area. */
+  rawContentBottom: number;
+  /** Total height reserved for footnotes on this page (grows as refs are placed). */
+  footnoteHeight: number;
+  /** Accumulated trailing spacing (space after previous block). */
   trailingSpacing: number;
 };
 /**
  * Options for creating a paginator.
  */
 type PaginatorOptions = {
-  /** Page size (width, height). */pageSize: {
+  /** Page size (width, height). */
+  pageSize: {
     w: number;
     h: number;
-  }; /** Page margins. */
-  margins: PageMargins; /** Swap left/right margins on even physical pages. */
+  };
+  /** Page margins. */
+  margins: PageMargins;
+  /** Swap left/right margins on even physical pages. */
   mirrorMargins?: boolean;
   /**
    * Margins applied only to the very first page (page 1) of the paginator.
@@ -35,11 +44,16 @@ type PaginatorOptions = {
    * its title page (typically extended top margin to clear an overflowing
    * first-page header) vs. its body pages. Pages 2+ use `margins`.
    */
-  firstPageMargins?: PageMargins; /** Per-section body margins used on even section pages. */
-  sectionEvenPageMargins?: (PageMargins | undefined)[]; /** Column configuration (optional). */
-  columns?: ColumnLayout; /** Per-page footnote reserved heights (pageNumber → height in pixels). */
-  footnoteReservedHeights?: Map<number, number>; /** Header/footer refs by section index. */
-  sectionHeaderFooterRefs?: PageHeaderFooterRefs[]; /** Callback when a new page is created. */
+  firstPageMargins?: PageMargins;
+  /** Per-section body margins used on even section pages. */
+  sectionEvenPageMargins?: (PageMargins | undefined)[];
+  /** Column configuration (optional). */
+  columns?: ColumnLayout;
+  /** Per-page footnote reserved heights (pageNumber → height in pixels). */
+  footnoteReservedHeights?: Map<number, number>;
+  /** Header/footer refs by section index. */
+  sectionHeaderFooterRefs?: PageHeaderFooterRefs[];
+  /** Callback when a new page is created. */
   onNewPage?: (state: PageState) => void;
 };
 type ForcePageBreakOptions = {
@@ -49,9 +63,13 @@ type ForcePageBreakOptions = {
  * Creates a paginator for managing page layout state.
  */
 declare function createPaginator(options: PaginatorOptions): {
-  /** All pages created so far. */pages: Page[]; /** All page states. */
-  states: PageState[]; /** Column width in pixels (use getColumnWidth() for current value after updates). */
-  readonly columnWidth: number; /** Get current column layout (returns copy to prevent external mutation). */
+  /** All pages created so far. */
+  pages: Page[];
+  /** All page states. */
+  states: PageState[];
+  /** Column width in pixels (use getColumnWidth() for current value after updates). */
+  readonly columnWidth: number;
+  /** Get current column layout (returns copy to prevent external mutation). */
   readonly columns: {
     count: number;
     gap: number;
@@ -59,28 +77,43 @@ declare function createPaginator(options: PaginatorOptions): {
     widths?: number[];
     gaps?: number[];
     separator?: boolean;
-  }; /** Get current state. */
-  getCurrentState: () => PageState; /** Get available height in current column. */
-  getAvailableHeight: () => number; /** Full content height of a fresh page in the active section. */
-  getContentHeight: () => number; /** Get content width for the active section. */
-  getContentWidth: () => number; /** Check if height fits in current column. */
-  fits: (height: number) => boolean; /** Ensure height fits, advancing if needed. */
-  ensureFits: (height: number) => PageState; /** Add a fragment to current page. */
+  };
+  /** Get current state. */
+  getCurrentState: () => PageState;
+  /** Get available height in current column. */
+  getAvailableHeight: () => number;
+  /** Full content height of a fresh page in the active section. */
+  getContentHeight: () => number;
+  /** Get content width for the active section. */
+  getContentWidth: () => number;
+  /** Check if height fits in current column. */
+  fits: (height: number) => boolean;
+  /** Ensure height fits, advancing if needed. */
+  ensureFits: (height: number) => PageState;
+  /** Add a fragment to current page. */
   addFragment: (fragment: Fragment, height: number, spaceBefore?: number, spaceAfter?: number) => {
     state: PageState;
     x: number;
     y: number;
-  }; /** Reserve additional footnote area on the current page. */
-  addFootnoteHeight: (additionalHeight: number, footnoteIds?: number[]) => void; /** Force a page break. */
-  forcePageBreak: (breakOptions?: ForcePageBreakOptions) => PageState; /** Reuse an already blank current page for the active section/layout. */
-  retargetCurrentBlankPage: () => boolean; /** Force a column break. */
-  forceColumnBreak: () => PageState; /** Get X position for column. */
-  getColumnX: (columnIndex: number) => number; /** Update column layout (for section breaks). */
-  updateColumns: (newColumns: ColumnLayout) => void; /** Update page size/margins for subsequent pages. */
+  };
+  /** Reserve additional footnote area on the current page. */
+  addFootnoteHeight: (additionalHeight: number, footnoteIds?: number[]) => void;
+  /** Force a page break. */
+  forcePageBreak: (breakOptions?: ForcePageBreakOptions) => PageState;
+  /** Reuse an already blank current page for the active section/layout. */
+  retargetCurrentBlankPage: () => boolean;
+  /** Force a column break. */
+  forceColumnBreak: () => PageState;
+  /** Get X position for column. */
+  getColumnX: (columnIndex: number) => number;
+  /** Update column layout (for section breaks). */
+  updateColumns: (newColumns: ColumnLayout) => void;
+  /** Update page size/margins for subsequent pages. */
   updatePageLayout: (newPageSize?: {
     w: number;
     h: number;
-  }, newMargins?: PageMargins, applyImmediately?: boolean) => void; /** Mark the next created page as the first page of a new section. */
+  }, newMargins?: PageMargins, applyImmediately?: boolean) => void;
+  /** Mark the next created page as the first page of a new section. */
   startSection: (sectionIndex: number) => void;
 };
 type Paginator = ReturnType<typeof createPaginator>;

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

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

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

@@ -1,5 +1,4 @@
 import { ParagraphBlock, TextBoxBlock } from "./types.js";
-
 //#region src/layout-engine/paragraphFrame.d.ts
 type ParagraphFrame = {
   width?: number;

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

@@ -1,5 +1,4 @@
 import { FlowBlock } from "./types.js";
-
 //#region src/layout-engine/paragraphSequence.d.ts
 declare const continuesNumberedSequence: (previous: FlowBlock | undefined, current: FlowBlock) => boolean;
 declare const continuesTabbedParagraphSequence: (previous: FlowBlock | undefined, current: FlowBlock) => boolean;

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

@@ -1,5 +1,4 @@
 import { FlowBlock, ParagraphBlock } from "./types.js";
-
 //#region src/layout-engine/paragraphSpacing.d.ts
 type EffectiveParagraphSpacing = Readonly<{
   before: number;
@@ -10,10 +9,7 @@ type CollapseParagraphSpacingOptions = {
   after: number;
 };
 /** Collapse adjacent paragraph spacing to the larger authored side. */
-declare const collapseParagraphSpacing: ({
-  before,
-  after
-}: CollapseParagraphSpacingOptions) => number;
+declare const collapseParagraphSpacing: ({ before, after }: CollapseParagraphSpacingOptions) => number;
 /** Whether a paragraph has no visible run content. */
 declare function isEmptyParagraph(block: ParagraphBlock): boolean;
 /**

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

@@ -1,5 +1,4 @@
 import { Layout } from "./types.js";
-
 //#region src/layout-engine/pmPageIndex.d.ts
 /**
  * Exhaustiveness guard for `FlowBlock`-shaped switches. Call from the

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

@@ -1,5 +1,4 @@
 import { FlowBlock, Page } from "./types.js";
-
 //#region src/layout-engine/renderedBreakReconciliation.d.ts
 type RenderedBreakState = {
   type: "noPageAdvance";
@@ -34,15 +33,7 @@ type BreakDecision = {
  * Every marker consumes the accumulated advance state so later markers make
  * independent decisions.
  */
-declare const reconcileBreakBeforeBlock: ({
-  state,
-  block,
-  previousBlock,
-  page,
-  blocksById,
-  hasExplicitPageBreak,
-  renderedBreakNeedsSnap
-}: ReconcileBeforeBlockOptions) => BreakDecision;
+declare const reconcileBreakBeforeBlock: ({ state, block, previousBlock, page, blocksById, hasExplicitPageBreak, renderedBreakNeedsSnap }: ReconcileBeforeBlockOptions) => BreakDecision;
 declare const recordReflowBoundary: (state: RenderedBreakState, crossedPageBoundary: boolean) => RenderedBreakState;
 type ReconcileAfterBlockOptions = {
   state: RenderedBreakState;
@@ -52,12 +43,6 @@ type ReconcileAfterBlockOptions = {
   previousPage: Page | undefined;
 };
 /** Record page movement and carry authored boundaries across pagination-empty paragraphs. */
-declare const reconcileAfterBlock: ({
-  state,
-  block,
-  pageNumberBefore,
-  pageNumberAfter,
-  previousPage
-}: ReconcileAfterBlockOptions) => RenderedBreakState;
+declare const reconcileAfterBlock: ({ state, block, pageNumberBefore, pageNumberAfter, previousPage }: ReconcileAfterBlockOptions) => RenderedBreakState;
 //#endregion
 export { INITIAL_RENDERED_BREAK_STATE, RenderedBreakState, reconcileAfterBlock, reconcileBreakBeforeBlock, recordReflowBoundary };

package/dist/layout-engine/section-breaks.d.ts

@@ -1,39 +1,56 @@
 import { ColumnLayout, PageMargins, SectionBreakBlock } from "./types.js";
-
 //#region src/layout-engine/section-breaks.d.ts
 /**
  * State tracking for sections during layout.
  * Uses active/pending pattern to schedule changes at page boundaries.
  */
 type SectionState = {
-  /** Currently active top margin. */activeTopMargin: number; /** Currently active bottom margin. */
-  activeBottomMargin: number; /** Currently active left margin. */
-  activeLeftMargin: number; /** Currently active right margin. */
-  activeRightMargin: number; /** Scheduled top margin for next page. */
-  pendingTopMargin: number | null; /** Scheduled bottom margin for next page. */
-  pendingBottomMargin: number | null; /** Scheduled left margin for next page. */
-  pendingLeftMargin: number | null; /** Scheduled right margin for next page. */
-  pendingRightMargin: number | null; /** Currently active page size. */
+  /** Currently active top margin. */
+  activeTopMargin: number;
+  /** Currently active bottom margin. */
+  activeBottomMargin: number;
+  /** Currently active left margin. */
+  activeLeftMargin: number;
+  /** Currently active right margin. */
+  activeRightMargin: number;
+  /** Scheduled top margin for next page. */
+  pendingTopMargin: number | null;
+  /** Scheduled bottom margin for next page. */
+  pendingBottomMargin: number | null;
+  /** Scheduled left margin for next page. */
+  pendingLeftMargin: number | null;
+  /** Scheduled right margin for next page. */
+  pendingRightMargin: number | null;
+  /** Currently active page size. */
   activePageSize: {
     w: number;
     h: number;
-  }; /** Scheduled page size for next page. */
+  };
+  /** Scheduled page size for next page. */
   pendingPageSize: {
     w: number;
     h: number;
-  } | null; /** Currently active column layout. */
-  activeColumns: ColumnLayout; /** Scheduled column layout for next page. */
-  pendingColumns: ColumnLayout | null; /** Currently active orientation. */
-  activeOrientation: "portrait" | "landscape" | null; /** Scheduled orientation for next page. */
-  pendingOrientation: "portrait" | "landscape" | null; /** Whether any pages have been created yet. */
+  } | null;
+  /** Currently active column layout. */
+  activeColumns: ColumnLayout;
+  /** Scheduled column layout for next page. */
+  pendingColumns: ColumnLayout | null;
+  /** Currently active orientation. */
+  activeOrientation: "portrait" | "landscape" | null;
+  /** Scheduled orientation for next page. */
+  pendingOrientation: "portrait" | "landscape" | null;
+  /** Whether any pages have been created yet. */
   hasAnyPages: boolean;
 };
 /**
  * Decision about what happens at a section break.
  */
 type BreakDecision = {
-  /** Force a page break. */forcePageBreak: boolean; /** Force a mid-page region change (for column layout changes). */
-  forceMidPageRegion: boolean; /** Required page parity (even or odd). */
+  /** Force a page break. */
+  forcePageBreak: boolean;
+  /** Force a mid-page region change (for column layout changes). */
+  forceMidPageRegion: boolean;
+  /** Required page parity (even or odd). */
   requiredParity?: "even" | "odd";
 };
 /**

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

@@ -1,15 +1,16 @@
 import { TableBlock, TableMeasure } from "./types.js";
-
 //#region src/layout-engine/tableRowBreak.d.ts
 /** Precomputed break geometry for a table. */
 type TableRowBreakInfo = {
-  /** Cumulative y of the top of each row; `rowTops[rows.length]` is the table height. */rowTops: number[];
+  /** Cumulative y of the top of each row; `rowTops[rows.length]` is the table height. */
+  rowTops: number[];
   /**
    * Per-row sorted, de-duplicated line-bottom offsets (relative to the row top)
    * at which a break is clean. Always includes the row's full height as the
    * final boundary.
    */
-  breakOffsets: number[][]; /** Suppressible leading paragraph whitespace after each matching break offset. */
+  breakOffsets: number[][];
+  /** Suppressible leading paragraph whitespace after each matching break offset. */
   continuationSkips: number[][];
 };
 /** Build break geometry for a table from its block + measure. */

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

@@ -1,5 +1,4 @@
 import { ImageRunPosition } from "./types.js";
-
 //#region src/layout-engine/textBoxFlow.d.ts
 type VerticalRelativeTo = NonNullable<ImageRunPosition["vertical"]>["relativeTo"];
 /**

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

@@ -1,5 +1,4 @@
 import { TextBoxBlock } from "./types.js";
-
 //#region src/layout-engine/textBoxGroup.d.ts
 declare const setTextBoxGroupId: (textBox: TextBoxBlock, groupId: string) => void;
 declare const getTextBoxGroupId: (textBox: TextBoxBlock) => string | undefined;