@stll/folio-core 0.62.0 → 0.63.1

package/dist/markdown/renderRuns.js

@@ -7,6 +7,16 @@ import { registerImage } from "./images.js";
 import { numberNoteReference, pushWarning } from "./internals.js";
 import { compileMarkdownToContent } from "@stll/docx-core";
 //#region src/markdown/renderRuns.ts
+/**
+* Render inline content (runs, hyperlinks, comment-range markers, tracked
+* changes) to markdown. Operates on the `ParagraphContent[]` of a paragraph, or
+* the equivalent inline lists inside hyperlinks and tracked-change wrappers.
+*
+* Inline marks are rendered as character-precise wrappers around the affected
+* runs. Comments and tracked changes become configurable annotation tags via
+* `./annotations`. Ported from eigenpal/docx-editor PR #595 (folio adds the
+* `footnotes: "strip"` gate).
+*/
 const MARK_DELIMS = {
 	bold: "**",
 	italic: "*",
@@ -241,12 +251,7 @@ function renderRunContent(ctx, pkg, content, paraId) {
 			pushWarning(ctx, `image rId=${item.image.rId ?? "(absent)"} not resolvable`);
 			break;
 		}
-		case "shape":
-			pushWarning(ctx, "shape not representable in markdown");
-			break;
-		case "fieldChar":
-		case "instrText": break;
-		default: break;
+		case "shape": pushWarning(ctx, "shape not representable in markdown");
 	}
 	return out;
 }
@@ -386,6 +391,9 @@ function renderTrackedWrapper(ctx, pkg, wrapper, paraId) {
 			case "complexField": return renderParagraphInline(ctx, pkg, [child], paraId, UNKNOWN_NEIGHBORS);
 			case "bookmarkStart":
 			case "bookmarkEnd":
+			case "commentRangeStart":
+			case "commentRangeEnd":
+			case "commentReference":
 			case "moveFromRangeStart":
 			case "moveFromRangeEnd":
 			case "moveToRangeStart":
@@ -497,10 +505,7 @@ function renderParagraphInline(ctx, pkg, content, paraId, edges = {
 			case "inlineWrapper":
 				out += renderParagraphInline(ctx, pkg, item.content, paraId, around(index));
 				break;
-			case "mathEquation":
-				if (item.plainText) out += escapeInline(item.plainText);
-				break;
-			default: break;
+			case "mathEquation": if (item.plainText) out += escapeInline(item.plainText);
 		}
 	}
 	while (openComments.length) {

package/dist/markdown/renderTable.d.ts

@@ -2,6 +2,5 @@ import { document_d_exports } from "../types/document.js";
 import { RenderContext } from "./types.js";
 //#region src/markdown/renderTable.d.ts
 /** Render a `Table` as markdown. Picks GFM vs HTML based on cell features. */
-declare function renderTable(ctx: RenderContext, pkg: document_d_exports.DocxPackage | undefined, table: document_d_exports.Table): string;
-//#endregion
-export { renderTable };
+export declare function renderTable(ctx: RenderContext, pkg: document_d_exports.DocxPackage | undefined, table: document_d_exports.Table): string;
+//#endregion

package/dist/markdown/renderTable.js

@@ -8,6 +8,13 @@ import { registerImage } from "./images.js";
 import { numberNoteReference, pushWarning } from "./internals.js";
 import { renderParagraph } from "./renderParagraph.js";
 //#region src/markdown/renderTable.ts
+/**
+* Render a Word table as markdown. Two output modes, picked automatically per
+* table: GFM for simple tables (no merged cells, no nested tables); inline HTML
+* `<table>` with `colspan`/`rowspan` when the table has `gridSpan`, `vMerge`, or
+* a nested table. Multi-paragraph cells join their paragraphs with `<br>` in
+* both modes. Ported from eigenpal/docx-editor PR #595.
+*/
 /** Render a `Table` as markdown. Picks GFM vs HTML based on cell features. */
 function renderTable(ctx, pkg, table) {
 	const { rows } = table;
@@ -82,7 +89,11 @@ function renderGfmCell(ctx, pkg, cell) {
 				else if (isOpaqueNestedRowMarkup(item.xml)) blocks.push("[Unsupported nested w:tr content]");
 				break;
 			case "bookmarkStart":
-			case "bookmarkEnd": break;
+			case "bookmarkEnd":
+			case "moveFromRangeStart":
+			case "moveFromRangeEnd":
+			case "moveToRangeStart":
+			case "moveToRangeEnd": break;
 			default: return item;
 		}
 	};
@@ -161,7 +172,11 @@ function renderHtmlCell(ctx, pkg, cell) {
 				else if (isOpaqueNestedRowMarkup(item.xml)) parts.push("[Unsupported nested w:tr content]");
 				break;
 			case "bookmarkStart":
-			case "bookmarkEnd": break;
+			case "bookmarkEnd":
+			case "moveFromRangeStart":
+			case "moveFromRangeEnd":
+			case "moveToRangeStart":
+			case "moveToRangeEnd": break;
 			default: return item;
 		}
 	};
@@ -200,10 +215,7 @@ function renderHtmlInline(ctx, pkg, content, paraId) {
 		case "inlineWrapper":
 			out += renderHtmlInline(ctx, pkg, item.content, paraId);
 			break;
-		case "mathEquation":
-			if (item.plainText) out += escapeHtml(item.plainText);
-			break;
-		default: break;
+		case "mathEquation": if (item.plainText) out += escapeHtml(item.plainText);
 	}
 	return out;
 }
@@ -223,6 +235,9 @@ function renderHtmlChildren(ctx, pkg, children, paraId) {
 			case "moveTo": return renderHtmlInline(ctx, pkg, [child], paraId);
 			case "bookmarkStart":
 			case "bookmarkEnd":
+			case "commentRangeStart":
+			case "commentRangeEnd":
+			case "commentReference":
 			case "moveFromRangeStart":
 			case "moveFromRangeEnd":
 			case "moveToRangeStart":
@@ -279,8 +294,6 @@ function renderHtmlRun(ctx, pkg, run, paraId) {
 			text += `<sup>[${token}]</sup>`;
 			break;
 		}
-		case "noteMarker": break;
-		default: break;
 	}
 	if (!text) return "";
 	const f = run.formatting;

package/dist/markdown/trailers.d.ts

@@ -7,6 +7,5 @@ import { RenderContext } from "./types.js";
  * `comments: "sidecar"`). Each section is emitted only when its corresponding
  * refs accumulator has entries.
  */
-declare function appendTrailers(ctx: RenderContext, doc: document_d_exports.Document, body: string): string;
-//#endregion
-export { appendTrailers };
+export declare function appendTrailers(ctx: RenderContext, doc: document_d_exports.Document, body: string): string;
+//#endregion

package/dist/markdown/types.d.ts

@@ -8,7 +8,7 @@ import { ListLabelCounter } from "../prosemirror/listLabels.js";
  * module so its public surface is independent of the docx model's drawing
  * types.
  */
-type ImageMeta = {
+export type ImageMeta = {
   /** `paraId` of the containing paragraph, when the source paragraph has one. */
   paraId?: string | undefined;
   /** 1-based ordinal in registration order. Unique per render call. */
@@ -21,7 +21,7 @@ type ImageMeta = {
   alt?: string | undefined;
 };
 /** Full registration record for an image, keyed by `virtualPath`. */
-type ImageRef = {
+export type ImageRef = {
   /** Raw bytes as exposed by the DOCX parser. */
   data: Uint8Array;
   /** Base64-encoded contents, without the `data:` prefix. */
@@ -36,7 +36,7 @@ type ImageRef = {
  * `{ annotations: "strip", trackedChanges: "clean", comments: "strip",
  * hyperlinks: "inline", footnotes: "strip" }`.
  */
-type MarkdownOptions = {
+export type MarkdownOptions = {
   /**
    * How to encode constructs markdown can't express natively (comments,
    * tracked changes).
@@ -79,7 +79,7 @@ type MarkdownOptions = {
   imagePath?: (info: ImageMeta) => string;
 };
 /** Result of a render, when the caller needs images/warnings as well as text. */
-type MarkdownResult = {
+export type MarkdownResult = {
   /** The full rendered markdown string. */
   markdown: string;
   /** Every image referenced in `markdown`, keyed by its virtual path. */
@@ -88,7 +88,7 @@ type MarkdownResult = {
   warnings: string[];
 };
 /** Resolved option values with defaults applied. Used internally. */
-type ResolvedOptions = {
+export type ResolvedOptions = {
   annotations: "html" | "pandoc" | "strip";
   trackedChanges: "clean" | "annotate";
   comments: "strip" | "inline" | "sidecar";
@@ -101,7 +101,7 @@ type ResolvedOptions = {
  * side-channel output: image map, warnings, and footnote/comment/hyperlink
  * reference lists. Exported only so the split renderer files share the shape.
  */
-type RenderContext = {
+export type RenderContext = {
   opts: ResolvedOptions;
   /** Accumulated images keyed by virtual path. */
   images: Map<string, ImageRef>;
@@ -150,5 +150,4 @@ type RenderContext = {
    */
   listIndentWidths: number[];
 };
-//#endregion
-export { ImageMeta, ImageRef, MarkdownOptions, MarkdownResult, RenderContext, ResolvedOptions };
+//#endregion

package/dist/model.d.ts

@@ -1,8 +1,8 @@
 import { document_d_exports } from "./types/document.js";
 import { CONDITIONAL_STYLE_TYPE_VALUES, COUNTER_FORMAT_VALUES, EMPHASIS_MARK_VALUES, FIELD_TYPE_VALUES, FLOATING_TABLE_X_SPEC_VALUES, FLOATING_TABLE_Y_SPEC_VALUES, FONT_HINT_VALUES, FONT_THEME_VALUES, FRAME_WRAP_VALUES, FRAME_X_ALIGN_VALUES, FRAME_Y_ALIGN_VALUES, HIGHLIGHT_COLOR_VALUES, IMAGE_HORIZONTAL_ALIGNMENT_VALUES, IMAGE_HORIZONTAL_RELATIVE_TO_VALUES, IMAGE_VERTICAL_ALIGNMENT_VALUES, IMAGE_VERTICAL_RELATIVE_TO_VALUES, IMAGE_WRAP_TEXT_VALUES, IMAGE_WRAP_TYPE_VALUES, LEVEL_SUFFIX_VALUES, LINE_SPACING_RULE_VALUES, NUMBER_FORMAT_VALUES, OUTLINE_STYLE_ATTR_VALUES, OUTLINE_STYLE_CSS_ALIAS_VALUES, OutlineStyleAttr, OutlineStyleCssAlias, PARAGRAPH_ALIGNMENT_VALUES, POSITIONAL_TAB_ALIGNMENT_VALUES, POSITIONAL_TAB_LEADER_VALUES, POSITIONAL_TAB_RELATIVE_TO_VALUES, SDT_LOCK_VALUES, SDT_TYPE_VALUES, SHADING_PATTERN_VALUES, SHAPE_TEXT_ANCHOR_VALUES, SHAPE_TYPE_VALUES, STYLE_TYPE_VALUES, TABLE_CELL_VERTICAL_ALIGNMENT_VALUES, TABLE_JUSTIFICATION_VALUES, TABLE_ROW_HEIGHT_RULE_VALUES, TABLE_WIDTH_TYPE_VALUES, TAB_LEADER_VALUES, TAB_STOP_ALIGNMENT_VALUES, TEXT_DIRECTION_VALUES, TEXT_EFFECT_VALUES, UNDERLINE_STYLE_VALUES, normalizeShapeTextAnchor, outlineAttrForDash, presetDashForOutlineAttr } from "./types/documentEnumValues.js";
 import { DeriveBlockIdInput, FolioBlockId, currentFolioBlockId, deriveBlankBlockId, deriveBlockId, getFolioParaIdFromBlockId, getSequentialFolioBlockIdIndex, isBlankFolioBlockId, isFolioBlockId, isSequentialFolioBlockId } from "./types/block-id.js";
-import { types_d_exports } from "./layout-engine/types.js";
 import { measureTypes_d_exports } from "./layout-engine/measure/measureTypes.js";
+import { types_d_exports } from "./layout-engine/types.js";
 export * from "@stll/docx-core/model";
 declare namespace model_d_exports {
   export { CONDITIONAL_STYLE_TYPE_VALUES, COUNTER_FORMAT_VALUES, DeriveBlockIdInput, EMPHASIS_MARK_VALUES, FIELD_TYPE_VALUES, FLOATING_TABLE_X_SPEC_VALUES, FLOATING_TABLE_Y_SPEC_VALUES, FONT_HINT_VALUES, FONT_THEME_VALUES, FRAME_WRAP_VALUES, FRAME_X_ALIGN_VALUES, FRAME_Y_ALIGN_VALUES, FolioBlockId, HIGHLIGHT_COLOR_VALUES, IMAGE_HORIZONTAL_ALIGNMENT_VALUES, IMAGE_HORIZONTAL_RELATIVE_TO_VALUES, IMAGE_VERTICAL_ALIGNMENT_VALUES, IMAGE_VERTICAL_RELATIVE_TO_VALUES, IMAGE_WRAP_TEXT_VALUES, IMAGE_WRAP_TYPE_VALUES, LEVEL_SUFFIX_VALUES, LINE_SPACING_RULE_VALUES, types_d_exports as Layout, measureTypes_d_exports as Measure, NUMBER_FORMAT_VALUES, OUTLINE_STYLE_ATTR_VALUES, OUTLINE_STYLE_CSS_ALIAS_VALUES, OutlineStyleAttr, OutlineStyleCssAlias, PARAGRAPH_ALIGNMENT_VALUES, POSITIONAL_TAB_ALIGNMENT_VALUES, POSITIONAL_TAB_LEADER_VALUES, POSITIONAL_TAB_RELATIVE_TO_VALUES, SDT_LOCK_VALUES, SDT_TYPE_VALUES, SHADING_PATTERN_VALUES, SHAPE_TEXT_ANCHOR_VALUES, SHAPE_TYPE_VALUES, STYLE_TYPE_VALUES, TABLE_CELL_VERTICAL_ALIGNMENT_VALUES, TABLE_JUSTIFICATION_VALUES, TABLE_ROW_HEIGHT_RULE_VALUES, TABLE_WIDTH_TYPE_VALUES, TAB_LEADER_VALUES, TAB_STOP_ALIGNMENT_VALUES, TEXT_DIRECTION_VALUES, TEXT_EFFECT_VALUES, UNDERLINE_STYLE_VALUES, currentFolioBlockId, deriveBlankBlockId, deriveBlockId, getFolioParaIdFromBlockId, getSequentialFolioBlockIdIndex, isBlankFolioBlockId, isFolioBlockId, isSequentialFolioBlockId, normalizeShapeTextAnchor, outlineAttrForDash, presetDashForOutlineAttr };

package/dist/paged-layout/LayoutSelectionGate.d.ts

@@ -18,7 +18,7 @@ type RenderCallback = () => void;
  * 4. Selection update requested → requestRender()
  * 5. If safe → callback is called
  */
-declare class LayoutSelectionGate {
+export declare class LayoutSelectionGate {
   #private;
   /**
    * Set the document state sequence (call when document changes).
@@ -77,4 +77,4 @@ declare class LayoutSelectionGate {
   };
 }
 //#endregion
-export { LayoutSelectionGate };
+export {};

package/dist/paged-layout/blockGeometry.d.ts

@@ -1,7 +1,7 @@
 import { FolioAIEditSnapshot } from "../ai-edits/types.js";
 //#region src/paged-layout/blockGeometry.d.ts
 /** Painted geometry for one AI-snapshot block in scroll-content coordinates. */
-type BlockRect = {
+export type BlockRect = {
   blockId: string;
   /** One-based painted page number. */
   page: number;
@@ -12,7 +12,7 @@ type BlockRect = {
   width: number;
   height: number;
 };
-type ReadBlockRectsOptions = {
+export type ReadBlockRectsOptions = {
   blockIds: readonly string[];
   snapshot: FolioAIEditSnapshot;
   pagesContainer: HTMLElement;
@@ -25,8 +25,7 @@ type ReadBlockRectsOptions = {
  * requested block is measured at most once; painted elements are collected in
  * one DOM query per relevant page.
  */
-declare const readBlockRects: ({ blockIds, snapshot, pagesContainer, scrollRoot }: ReadBlockRectsOptions) => ReadonlyMap<string, BlockRect>;
+export declare const readBlockRects: ({ blockIds, snapshot, pagesContainer, scrollRoot }: ReadBlockRectsOptions) => ReadonlyMap<string, BlockRect>;
 /** Subscribe to instance-scoped painted-page changes. */
-declare const onPaintedLayoutChange: (pagesContainer: HTMLElement, listener: () => void) => (() => void);
-//#endregion
-export { BlockRect, ReadBlockRectsOptions, onPaintedLayoutChange, readBlockRects };
+export declare const onPaintedLayoutChange: (pagesContainer: HTMLElement, listener: () => void) => (() => void);
+//#endregion

package/dist/paged-layout/editorScrollRoot.d.ts

@@ -1,8 +1,8 @@
 //#region src/paged-layout/editorScrollRoot.d.ts
-declare const getEditorScrollRoot: (element: HTMLElement | null) => HTMLElement | null;
+export declare const getEditorScrollRoot: (element: HTMLElement | null) => HTMLElement | null;
 /** Resolve the root even when a caller holds a painted descendant or viewport. */
-declare const scrollEditorTo: (element: HTMLElement | null, options: ScrollToOptions) => void;
-declare const scrollEditorBy: (element: HTMLElement | null, delta: number) => void;
+export declare const scrollEditorTo: (element: HTMLElement | null, options: ScrollToOptions) => void;
+export declare const scrollEditorBy: (element: HTMLElement | null, delta: number) => void;
 type ScrollEditorElementOptions = {
   block?: "start" | "center" | "end" | "nearest";
   behavior?: ScrollBehavior;
@@ -12,6 +12,6 @@ type ScrollEditorElementOptions = {
   rect?: DOMRectReadOnly;
 };
 /** Scroll only the marked root, including when the target is inside a scaled viewport. */
-declare const scrollEditorElementIntoView: (element: HTMLElement | null, { block, behavior, margin, rect }?: ScrollEditorElementOptions) => void;
+export declare const scrollEditorElementIntoView: (element: HTMLElement | null, { block, behavior, margin, rect }?: ScrollEditorElementOptions) => void;
 //#endregion
-export { getEditorScrollRoot, scrollEditorBy, scrollEditorElementIntoView, scrollEditorTo };
+export {};

package/dist/paged-layout/fitWidthZoom.d.ts

@@ -0,0 +1,36 @@
+//#region src/paged-layout/fitWidthZoom.d.ts
+/**
+ * fitWidthZoom
+ *
+ * Framework-agnostic fit-width math for the React `useZoomAndPageInfo` hook.
+ *
+ * The fit reads the container's border-box width minus the widest
+ * non-content edge (borders plus a classic vertical scrollbar) seen so far,
+ * never `clientWidth` alone. Whether a classic scrollbar shows depends on the
+ * fitted zoom, so a fit that follows `clientWidth` can toggle the scrollbar
+ * and with it its own input. Reserving the widest edge makes the basis
+ * independent of the scrollbar: a container re-fits once when its gutter first
+ * appears and then holds.
+ */
+export declare const FIT_TO_WIDTH_PADDING_PX = 16;
+export declare const FIT_TO_WIDTH_MIN_ZOOM = 0.1;
+export declare const FIT_TO_WIDTH_MAX_ZOOM = 1;
+type FitWidthZoomParams = {
+  /** Border-box width of the scroll container (`offsetWidth`). */
+  offsetWidth: number;
+  /** Content-box width of the scroll container (`clientWidth`). */
+  clientWidth: number;
+  /** Natural width of the laid-out page at zoom 1. */
+  pageWidth: number;
+  /** The widest edge returned by earlier fits of the same container, or 0. */
+  reservedEdge: number;
+};
+type FitWidthZoomResult = {
+  /** The fitted zoom, or `null` when the container has no width to fit. */
+  zoom: number | null;
+  /** Pass back as `reservedEdge` on the next fit of the same container. */
+  reservedEdge: number;
+};
+export declare const fitWidthZoom: ({ offsetWidth, clientWidth, pageWidth, reservedEdge }: FitWidthZoomParams) => FitWidthZoomResult;
+//#endregion
+export {};

package/dist/paged-layout/fitWidthZoom.js

@@ -0,0 +1,31 @@
+//#region src/paged-layout/fitWidthZoom.ts
+/**
+* fitWidthZoom
+*
+* Framework-agnostic fit-width math for the React `useZoomAndPageInfo` hook.
+*
+* The fit reads the container's border-box width minus the widest
+* non-content edge (borders plus a classic vertical scrollbar) seen so far,
+* never `clientWidth` alone. Whether a classic scrollbar shows depends on the
+* fitted zoom, so a fit that follows `clientWidth` can toggle the scrollbar
+* and with it its own input. Reserving the widest edge makes the basis
+* independent of the scrollbar: a container re-fits once when its gutter first
+* appears and then holds.
+*/
+const FIT_TO_WIDTH_PADDING_PX = 16;
+const FIT_TO_WIDTH_MIN_ZOOM = .1;
+const FIT_TO_WIDTH_MAX_ZOOM = 1;
+const fitWidthZoom = ({ offsetWidth, clientWidth, pageWidth, reservedEdge }) => {
+	const edge = Math.max(reservedEdge, offsetWidth - clientWidth);
+	const available = offsetWidth - edge - 16;
+	if (available <= 0 || pageWidth <= 0) return {
+		zoom: null,
+		reservedEdge: edge
+	};
+	return {
+		zoom: Math.min(1, Math.max(FIT_TO_WIDTH_MIN_ZOOM, Math.round(available / pageWidth * 100) / 100)),
+		reservedEdge: edge
+	};
+};
+//#endregion
+export { FIT_TO_WIDTH_MAX_ZOOM, FIT_TO_WIDTH_MIN_ZOOM, FIT_TO_WIDTH_PADDING_PX, fitWidthZoom };

package/dist/paged-layout/hiddenEditorScroll.d.ts

@@ -1,4 +1,3 @@
 //#region src/paged-layout/hiddenEditorScroll.d.ts
-declare const suppressHiddenEditorScrollToSelection: () => true;
-//#endregion
-export { suppressHiddenEditorScrollToSelection };
+export declare const suppressHiddenEditorScrollToSelection: () => true;
+//#endregion

package/dist/paged-layout/incrementalMeasure.d.ts

@@ -1,10 +1,10 @@
 import { FlowBlock, Measure } from "../layout-engine/types.js";
 //#region src/paged-layout/incrementalMeasure.d.ts
-type DirtyRange = {
+export type DirtyRange = {
   from: number;
   to: number;
 };
-type IncrementalMeasureInput = {
+export type IncrementalMeasureInput = {
   previousBlocks: FlowBlock[];
   previousMeasures: Measure[];
   previousBlockWidths: number[];
@@ -13,11 +13,10 @@ type IncrementalMeasureInput = {
   dirtyRange: DirtyRange;
   measureBlock: (block: FlowBlock, blockWidth: number, blockIndex: number) => Measure;
 };
-type IncrementalMeasureResult = {
+export type IncrementalMeasureResult = {
   measures: Measure[];
   measuredBlockIndexes: number[];
 };
-declare function findDirtyBlockIndexes(blocks: FlowBlock[], dirtyRange: DirtyRange): number[];
-declare function tryBuildIncrementalMeasures({ previousBlocks, previousMeasures, previousBlockWidths, nextBlocks, nextBlockWidths, dirtyRange, measureBlock }: IncrementalMeasureInput): IncrementalMeasureResult | null;
-//#endregion
-export { DirtyRange, IncrementalMeasureInput, IncrementalMeasureResult, findDirtyBlockIndexes, tryBuildIncrementalMeasures };
+export declare function findDirtyBlockIndexes(blocks: FlowBlock[], dirtyRange: DirtyRange): number[];
+export declare function tryBuildIncrementalMeasures({ previousBlocks, previousMeasures, previousBlockWidths, nextBlocks, nextBlockWidths, dirtyRange, measureBlock }: IncrementalMeasureInput): IncrementalMeasureResult | null;
+//#endregion

package/dist/paged-layout/pageText.d.ts

@@ -18,6 +18,6 @@ type PageTextOptions = {
  * are skipped. Returns `null` when the layout hasn't been computed yet or the
  * page number is out of range.
  */
-declare const getPageTextFromLayout: ({ layout, doc, page, projection }: PageTextOptions) => string | null;
+export declare const getPageTextFromLayout: ({ layout, doc, page, projection }: PageTextOptions) => string | null;
 //#endregion
-export { getPageTextFromLayout };
+export {};

package/dist/paged-layout/paragraphFlash.d.ts

@@ -1,16 +1,16 @@
 import { ParagraphHighlightOptions, ScrollToParaIdOptions } from "./paragraphFlashTypes.js";
 //#region src/paged-layout/paragraphFlash.d.ts
 /** Default color used by paragraph flashes. */
-declare const DEFAULT_PARAGRAPH_FLASH_COLOR = "rgba(255, 235, 59, 0.55)";
+export declare const DEFAULT_PARAGRAPH_FLASH_COLOR = "rgba(255, 235, 59, 0.55)";
 /** Default duration for paragraph flashes. */
-declare const DEFAULT_PARAGRAPH_FLASH_DURATION_MS = 1200;
+export declare const DEFAULT_PARAGRAPH_FLASH_DURATION_MS = 1200;
 /** CSS class applied to paragraph fragments during a transient flash. */
-declare const PARAGRAPH_FLASH_CLASS_NAME = "folio-paragraph-flash";
+export declare const PARAGRAPH_FLASH_CLASS_NAME = "folio-paragraph-flash";
 /** Find all painted paragraph fragments with a stable `data-para-id`. */
-declare const findParagraphFragmentsByParaId: (root: ParentNode, paraId: string) => HTMLElement[];
+export declare const findParagraphFragmentsByParaId: (root: ParentNode, paraId: string) => HTMLElement[];
 /** Apply a transient flash to a collection of paragraph elements. */
-declare const flashParagraphElements: (elements: Iterable<HTMLElement>, options?: ParagraphHighlightOptions) => number;
+export declare const flashParagraphElements: (elements: Iterable<HTMLElement>, options?: ParagraphHighlightOptions) => number;
 /** Find paragraph fragments by `paraId` and flash them. */
-declare const flashParagraphFragmentsByParaId: (root: ParentNode, paraId: string, options?: ParagraphHighlightOptions) => boolean;
+export declare const flashParagraphFragmentsByParaId: (root: ParentNode, paraId: string, options?: ParagraphHighlightOptions) => boolean;
 //#endregion
-export { DEFAULT_PARAGRAPH_FLASH_COLOR, DEFAULT_PARAGRAPH_FLASH_DURATION_MS, PARAGRAPH_FLASH_CLASS_NAME, type ParagraphHighlightOptions, type ScrollToParaIdOptions, findParagraphFragmentsByParaId, flashParagraphElements, flashParagraphFragmentsByParaId };
+export type { ParagraphHighlightOptions, ScrollToParaIdOptions };

package/dist/paged-layout/paragraphFlashTypes.d.ts

@@ -6,16 +6,15 @@
  * paragraph-flash DOM helpers.
  */
 /** Customization for the transient paragraph flash applied by `scrollToParaId`. */
-type ParagraphHighlightOptions = {
+export type ParagraphHighlightOptions = {
   /** CSS color used for the transient paragraph flash. Defaults to yellow. */
   color?: string;
   /** How long the flash remains visible before it is removed. Defaults to 1200ms. */
   durationMs?: number;
 };
 /** Optional reveal behavior for `scrollToParaId`. */
-type ScrollToParaIdOptions = {
+export type ScrollToParaIdOptions = {
   /** Flash rendered paragraph fragments after scrolling to the paragraph. */
   highlight?: ParagraphHighlightOptions;
 };
-//#endregion
-export { ParagraphHighlightOptions, ScrollToParaIdOptions };
+//#endregion

package/dist/paged-layout/rangeProjection.d.ts

@@ -1,15 +1,15 @@
 import { FlowBlock, Layout, Measure } from "../layout-engine/types.js";
 import { SelectionRect } from "../layout-bridge/engine/selectionRects.js";
 //#region src/paged-layout/rangeProjection.d.ts
-type ProjectableRange = {
+export type ProjectableRange = {
   from: number;
   to: number;
 };
-type ProjectedRange<T extends ProjectableRange> = {
+export type ProjectedRange<T extends ProjectableRange> = {
   range: T;
   rects: SelectionRect[];
 };
-type RangeProjectionContext = {
+export type RangeProjectionContext = {
   pagesContainer: HTMLElement;
   zoom: number;
   layout: Layout | null;
@@ -23,13 +23,13 @@ type RangeProjectionContext = {
  * horizontally between paint passes while content above reflows. The page's
  * left margin is fixed, so this value holds steady as text is edited.
  */
-declare const measureContentLeft: (pagesContainer: HTMLElement, zoom: number) => number | null;
+export declare const measureContentLeft: (pagesContainer: HTMLElement, zoom: number) => number | null;
 /**
  * One page's body-content vertical extent in container space. `.layout-page-content`
  * is inset by the page margins, so its box excludes the header/footer and the
  * inter-page gap — exactly the region a gutter rail is allowed to paint over.
  */
-type PageContentBand = {
+export type PageContentBand = {
   /** 0-based page index (from `data-page-number` minus one). */
   pageIndex: number;
   /** Top of the body content area, container space. */
@@ -43,7 +43,7 @@ type PageContentBand = {
  * budget), and each page's body-content band (so a rail can be clipped per page
  * instead of running across page breaks). Measured O(pages), never per-range.
  */
-type DirectiveGutterGeometry = {
+export type DirectiveGutterGeometry = {
   /** Text-column left edge, container space. Rails anchor here. */
   contentLeft: number;
   /** Usable left-margin width: `contentLeft - pageLeftEdge`. Drives the budget. */
@@ -51,14 +51,14 @@ type DirectiveGutterGeometry = {
   /** Per-page body-content vertical bands, in document order. */
   pageBands: PageContentBand[];
 };
-declare const measureDirectiveGutter: (pagesContainer: HTMLElement, zoom: number) => DirectiveGutterGeometry | null;
+export declare const measureDirectiveGutter: (pagesContainer: HTMLElement, zoom: number) => DirectiveGutterGeometry | null;
 /**
  * Computed text style of the painted run at a PM position. Overlays
  * that paint substituted text over the pages (template fill preview,
  * AI suggestion replacement) copy these so the injected text matches
  * the surrounding run instead of the overlay container's base font.
  */
-type ProjectedRunFont = {
+export type ProjectedRunFont = {
   fontFamily: string;
   fontSize: string;
   fontWeight: string;
@@ -72,7 +72,6 @@ type ProjectedRunFont = {
  * (virtualized pages) simply stay absent from the result; callers fall
  * back to the overlay's inherited font.
  */
-declare const collectRunFontsAtPmPositions: (pagesContainer: HTMLElement, positions: readonly number[]) => Map<number, ProjectedRunFont>;
-declare const projectRangesToRects: <T extends ProjectableRange>(ranges: readonly T[], ctx: RangeProjectionContext) => Promise<ProjectedRange<T>[]>;
-//#endregion
-export { DirectiveGutterGeometry, PageContentBand, ProjectableRange, ProjectedRange, ProjectedRunFont, RangeProjectionContext, collectRunFontsAtPmPositions, measureContentLeft, measureDirectiveGutter, projectRangesToRects };
+export declare const collectRunFontsAtPmPositions: (pagesContainer: HTMLElement, positions: readonly number[]) => Map<number, ProjectedRunFont>;
+export declare const projectRangesToRects: <T extends ProjectableRange>(ranges: readonly T[], ctx: RangeProjectionContext) => Promise<ProjectedRange<T>[]>;
+//#endregion

package/dist/paged-layout/readOnlyEditAttempt.d.ts

@@ -1,5 +1,5 @@
 //#region src/paged-layout/readOnlyEditAttempt.d.ts
 type ReadOnlyEditKeyEvent = Pick<KeyboardEvent, "altKey" | "ctrlKey" | "key" | "metaKey">;
-declare const isReadOnlyEditKey: (event: ReadOnlyEditKeyEvent) => boolean;
+export declare const isReadOnlyEditKey: (event: ReadOnlyEditKeyEvent) => boolean;
 //#endregion
-export { isReadOnlyEditKey };
+export {};

package/dist/paged-layout/scrollNavigation.d.ts

@@ -1,13 +1,13 @@
 import { Layout } from "../layout-engine/types.js";
 //#region src/paged-layout/scrollNavigation.d.ts
-type PageScrollTarget = {
+export type PageScrollTarget = {
   type: "position";
   pmPos: number;
 } | {
   type: "pageShell";
   pageIndex: number;
 };
-declare const isValidPmScrollPosition: (pmPos: number) => boolean;
+export declare const isValidPmScrollPosition: (pmPos: number) => boolean;
 /**
  * Pick a `scrollIntoView` / `scrollTo` `behavior` that respects the
  * user's `prefers-reduced-motion` setting. Chrome silently no-ops
@@ -16,7 +16,6 @@ declare const isValidPmScrollPosition: (pmPos: number) => boolean;
  * leaves the user wondering why the chip "doesn't work". Use the
  * helper everywhere we'd otherwise hard-code `"smooth"`.
  */
-declare const prefersReducedMotionBehavior: () => ScrollBehavior;
-declare const getPageScrollTarget: (layout: Layout | null, pageNumber: number) => PageScrollTarget | null;
-//#endregion
-export { PageScrollTarget, getPageScrollTarget, isValidPmScrollPosition, prefersReducedMotionBehavior };
+export declare const prefersReducedMotionBehavior: () => ScrollBehavior;
+export declare const getPageScrollTarget: (layout: Layout | null, pageNumber: number) => PageScrollTarget | null;
+//#endregion

package/dist/paged-layout/scrollPageInfo.d.ts

@@ -7,13 +7,13 @@
  * `useZoomAndPageInfo` hook owns the React state and the scroll/layout DOM
  * reads; this module owns the pure geometry.
  */
-type ScrollPageInfo = {
+export type ScrollPageInfo = {
   currentPage: number;
   totalPages: number;
   visible: boolean;
 };
-declare const updateScrollPageTotal: (previous: ScrollPageInfo, totalPages: number) => ScrollPageInfo;
-type ScrollPageMetrics = {
+export declare const updateScrollPageTotal: (previous: ScrollPageInfo, totalPages: number) => ScrollPageInfo;
+export type ScrollPageMetrics = {
   /** Laid-out page heights (unscaled), top to bottom. */
   pageHeights: readonly number[];
   /** Current scroll offset of the container (scaled by zoom). */
@@ -32,9 +32,8 @@ type ScrollPageMetrics = {
  * count from the laid-out page heights and the live scroll position. Returns
  * null when there are no pages to measure.
  */
-declare const computeScrollPageInfo: ({ pageHeights, scrollTop, clientHeight, zoom, viewportPaddingTop, pageGap }: ScrollPageMetrics) => {
+export declare const computeScrollPageInfo: ({ pageHeights, scrollTop, clientHeight, zoom, viewportPaddingTop, pageGap }: ScrollPageMetrics) => {
   currentPage: number;
   totalPages: number;
 } | null;
-//#endregion
-export { ScrollPageInfo, ScrollPageMetrics, computeScrollPageInfo, updateScrollPageTotal };
+//#endregion

package/dist/paged-layout/scrollToPmPosition.d.ts

@@ -1,9 +1,9 @@
 import { EditorView } from "prosemirror-view";
 //#region src/paged-layout/scrollToPmPosition.d.ts
 /** Class on the pages container `PagedEditor` paints into. */
-declare const PAGES_CONTAINER_CLASS = "paged-editor__pages";
+export declare const PAGES_CONTAINER_CLASS = "paged-editor__pages";
 /** Scroll visible pages to a ProseMirror position. */
-declare const scrollPagesToPmPosition: (pageContainer: HTMLElement, pmPos: number) => void;
+export declare const scrollPagesToPmPosition: (pageContainer: HTMLElement, pmPos: number) => void;
 /**
  * Scroll the paged layout that mirrors `view` so `pmPos` is centered
  * in the viewport. The hidden editing view sits inside the editor's
@@ -11,6 +11,5 @@ declare const scrollPagesToPmPosition: (pageContainer: HTMLElement, pmPos: numbe
  * Returns false when no paged layout is found (non-paged host) so
  * callers can fall back to coordinate-based scrolling.
  */
-declare const scrollFolioPositionIntoView: (view: EditorView, pmPos: number) => boolean;
-//#endregion
-export { PAGES_CONTAINER_CLASS, scrollFolioPositionIntoView, scrollPagesToPmPosition };
+export declare const scrollFolioPositionIntoView: (view: EditorView, pmPos: number) => boolean;
+//#endregion

package/dist/paged-layout/sectionBlockWidths.d.ts

@@ -41,7 +41,7 @@ type PerBlockMeasureInputs = {
  * Section N's blocks use config from sectionBreak[N].
  * The final section (after all breaks) uses body-level config.
  */
-declare function computePerBlockWidths({ blocks, bodyConfig, finalConfig }: ComputePerBlockMeasureInput): number[];
-declare function computePerBlockMeasureInputs({ blocks, bodyConfig, finalConfig }: ComputePerBlockMeasureInput): PerBlockMeasureInputs;
+export declare function computePerBlockWidths({ blocks, bodyConfig, finalConfig }: ComputePerBlockMeasureInput): number[];
+export declare function computePerBlockMeasureInputs({ blocks, bodyConfig, finalConfig }: ComputePerBlockMeasureInput): PerBlockMeasureInputs;
 //#endregion
-export { computePerBlockMeasureInputs, computePerBlockWidths };
+export {};

package/dist/paged-layout/sectionBlockWidths.js

@@ -76,9 +76,6 @@ function computePerBlockMeasureInputs({ blocks, bodyConfig, finalConfig }) {
 				hasPhysicalPageContent = false;
 				columnGeometryDirty = true;
 				columnIndex = 0;
-				break;
-			case "none": break;
-			default:
 		}
 		if (measuredSectionIdx !== sectionIdx || columnGeometryDirty) {
 			activeColumns = config.columns ?? SINGLE_COLUMN_LAYOUT;