oasis-editor 0.0.1 → 0.0.3

package/dist/index.d.ts

@@ -1,14 +1,21 @@
 
 export { createOasisEditor } from './app/bootstrap/createOasisEditorApp.js';
 export type { OasisEditorInstance } from './app/bootstrap/createOasisEditorApp.js';
+export type { OasisEditorClient, OasisEditorClientEvent, OasisEditorClientEvents, OasisEditorClientEventHandler, OasisEditorDocumentApi, OasisEditorExportApi, OasisEditorFocusApi, OasisEditorHistoryApi, OasisEditorImportApi, OasisEditorSelectionApi, } from './app/client/OasisEditorClient.js';
 export { createOasisEditorContainer } from './app/bootstrap/createOasisEditorContainer.js';
 export type { OasisEditorContainerInstance } from './app/bootstrap/createOasisEditorContainer.js';
 export { OasisEditorContainer } from './ui/OasisEditorContainer.js';
 export type { OasisEditorContainerProps } from './ui/OasisEditorContainer.js';
+export { OasisEditorAppLazy } from './ui/OasisEditorAppLazy.js';
+export { OasisEditorLoading } from './ui/OasisEditorLoading.js';
+export type { OasisEditorLoadingProps } from './ui/OasisEditorLoading.js';
 export { Editor } from './core/Editor.js';
 export { CommandRegistry } from './core/commands/CommandRegistry.js';
-export { commandRefName, resolveCommandRef } from './core/commands/CommandRef.js';
+export { commandRefName, resolveCommandRef, } from './core/commands/CommandRef.js';
 export { createEditorCommandBus } from './core/commands/CommandBus.js';
+export { OASIS_BUILTIN_COMMANDS } from './core/commands/builtinCommands.js';
+export type { OasisBuiltinCommand } from './core/commands/builtinCommands.js';
+export type { CommandPayloadArgs, InsertTablePayload, OasisCommandName, OasisCommandPayloads, OasisCommandResults, SetFontSizePayload, SetPageMarginsPayload, TypedCommandBus, } from './core/commands/publicCommandTypes.js';
 export { PluginCollection } from './core/plugins/PluginCollection.js';
 export { mount } from './ui/mount.js';
 export { DocumentShell } from './ui/shells/DocumentShell.js';
@@ -18,26 +25,44 @@ export { Dialog } from './ui/components/Dialogs/Dialog.js';
 export type { DialogProps } from './ui/components/Dialogs/Dialog.js';
 export { Tabs } from './ui/components/Tabs/Tabs.js';
 export type { TabsItem, TabsProps } from './ui/components/Tabs/Tabs.js';
-export type { OasisPlugin, OasisEditor, OasisCommand, OasisCommandRegistry, CommandState, PluginReference, Unsubscribe, } from './core/plugin.js';
-export type { CommandRef, ResolvedCommandRef } from './core/commands/CommandRef.js';
+export { Button, Checkbox, DialogFooter, FloatingActionButton, IconButton, SelectField, SidePanel, SidePanelBody, SidePanelFooter, SidePanelHeader, TextField, } from './ui/public/index.js';
+export type { ButtonProps, CheckboxProps, DialogFooterProps, FloatingActionButtonProps, IconButtonProps, SelectFieldOption, SelectFieldProps, SidePanelProps, SidePanelSectionProps, TextFieldProps, } from './ui/public/index.js';
+export type { OasisPlugin, OasisEditor, OasisCommand, OasisCommandContext, OasisCommandRegistry, CommandState, FloatingActionContribution, FloatingActionPlacement, FloatingActionScope, OasisPluginUiContributions, OasisPluginUiRegistry, OasisPluginUiSnapshot, PluginUiRenderContext, PluginReference, SidePanelContribution, SidePanelMode, Unsubscribe, } from './core/plugin.js';
+export type { EditorDocument, EditorState } from './core/model.js';
+export type { DocumentPersistence } from './app/controllers/useEditorPersistence.js';
+export type { ImportProgressState } from './app/controllers/useEditorDocumentIO.js';
+export type { CommandRef, ResolvedCommandRef, } from './core/commands/CommandRef.js';
 export type { CommandBus } from './core/commands/CommandBus.js';
-export type { OasisEditorAppProps } from './ui/OasisEditorApp.js';
+export type { OasisEditorAppProps, ToolbarLayoutMode, } from './ui/OasisEditorApp.js';
 export type { ToolbarItem, ToolbarItemType, ButtonItem, ToggleItem, SplitItem, MenuItem, MenuContent, SelectItem, SelectOption, ColorPickerItem, GridPickerItem, SeparatorItem, GroupItem, CustomItem, ToolbarActionApi, ToolbarCommandState, ItemReactiveOverrides, } from './ui/components/Toolbar/schema/items.js';
 export type { ColorPalette, ColorSwatch, ThemeColor, } from './ui/components/Toolbar/schema/palette.js';
-export { createToolbarRegistry, } from './ui/components/Toolbar/registry/ToolbarRegistry.js';
-export type { ToolbarRegistry } from './ui/components/Toolbar/registry/ToolbarRegistry.js';
+export { createToolbarRegistry } from './ui/components/Toolbar/registry/ToolbarRegistry.js';
+export type { ToolbarMoveTarget, ToolbarRegistry, } from './ui/components/Toolbar/registry/ToolbarRegistry.js';
+export { MenuRegistry } from './ui/components/Menubar/menuRegistry.js';
+export type { MenubarHost, MenuItem as MenubarItem, } from './ui/components/Menubar/menuRegistry.js';
 export { DEFAULT_PALETTE } from './ui/components/Toolbar/presets/defaultPalette.js';
 export { createDefaultToolbarPreset } from './ui/components/Toolbar/presets/defaultToolbar.js';
+export { OASIS_TOOLBAR_ITEMS } from './ui/components/Toolbar/presets/builtinToolbarIds.js';
+export type { OasisToolbarItemId } from './ui/components/Toolbar/presets/builtinToolbarIds.js';
+export { OASIS_MENU_ITEMS } from './ui/components/Menubar/builtinMenuIds.js';
+export type { OasisMenuItemId } from './ui/components/Menubar/builtinMenuIds.js';
 export { Toolbar } from './ui/components/Toolbar/Toolbar.js';
 export type { ToolbarProps } from './ui/components/Toolbar/Toolbar.js';
-export { registerToolbarRenderer, } from './ui/components/Toolbar/renderers/renderers.js';
+export { registerToolbarRenderer } from './ui/components/Toolbar/renderers/renderers.js';
 export type { RendererProps } from './ui/components/Toolbar/renderers/renderers.js';
 export { Popover } from './ui/components/Toolbar/primitives/Popover.js';
-export type { PopoverProps } from './ui/components/Toolbar/primitives/Popover.js';
-export { Menu as ToolbarMenu } from './ui/components/Toolbar/primitives/Menu.js';
+export type { PopoverProps, PopoverTriggerApi, } from './ui/components/Toolbar/primitives/Popover.js';
+export { Menu, Menu as ToolbarMenu, } from './ui/components/Toolbar/primitives/Menu.js';
+export type { MenuProps } from './ui/components/Toolbar/primitives/Menu.js';
 export { Button as ToolbarButton } from './ui/components/Toolbar/primitives/Button.js';
-export { Select as ToolbarSelect } from './ui/components/Toolbar/primitives/Select.js';
-export { Separator as ToolbarSeparator } from './ui/components/Toolbar/primitives/Separator.js';
-export { SplitButton as ToolbarSplitButton } from './ui/components/Toolbar/primitives/SplitButton.js';
-export { ColorPicker as ToolbarColorPicker } from './ui/components/Toolbar/primitives/ColorPicker.js';
-export { GridPicker as ToolbarGridPicker } from './ui/components/Toolbar/primitives/GridPicker.js';
+export type { ToolbarButtonProps } from './ui/components/Toolbar/primitives/Button.js';
+export { Select, Select as ToolbarSelect, } from './ui/components/Toolbar/primitives/Select.js';
+export type { ToolbarSelectProps } from './ui/components/Toolbar/primitives/Select.js';
+export { Separator, Separator as ToolbarSeparator, } from './ui/components/Toolbar/primitives/Separator.js';
+export type { SeparatorProps } from './ui/components/Toolbar/primitives/Separator.js';
+export { SplitButton, SplitButton as ToolbarSplitButton, } from './ui/components/Toolbar/primitives/SplitButton.js';
+export type { SplitButtonProps } from './ui/components/Toolbar/primitives/SplitButton.js';
+export { ColorPicker, ColorPicker as ToolbarColorPicker, } from './ui/components/Toolbar/primitives/ColorPicker.js';
+export type { ColorPickerKind, ColorPickerProps, } from './ui/components/Toolbar/primitives/ColorPicker.js';
+export { GridPicker, GridPicker as ToolbarGridPicker, } from './ui/components/Toolbar/primitives/GridPicker.js';
+export type { GridPickerProps } from './ui/components/Toolbar/primitives/GridPicker.js';

package/dist/layoutProjection/blockHeights.d.ts

@@ -1 +1 @@
-export { estimateParagraphBlockHeight, } from '../paragraphPagination.js';
+export { estimateParagraphBlockHeight } from '../paragraphPagination.js';

package/dist/layoutProjection/blocksPagination.d.ts

@@ -11,8 +11,8 @@ export interface ProjectBlocksLayoutContext {
     pageOffset?: number;
     totalPages?: number;
     existingPages?: EditorLayoutPage[];
-    layoutMode?: "fast" | "wordParity";
     measurer?: ITextMeasurer;
     reservedHeightByPageIndex?: Map<number, number>;
+    defaultTabStop?: number;
 }
 export declare function projectBlocksLayout(context: ProjectBlocksLayoutContext): EditorLayoutPage[];

package/dist/layoutProjection/constants.d.ts

@@ -1 +1,9 @@
-export { FOOTNOTE_MARKER_GUTTER_PX, } from '../footnotePagination.js';
+export { FOOTNOTE_MARKER_GUTTER_PX } from '../footnotePagination.js';
+/** CSS reference: 96 device pixels per inch, 72 points per inch. */
+export declare const PX_PER_POINT: number;
+/**
+ * Extra gap (px) inserted between a paragraph border and its text, on top of
+ * the border's own stroke width. Keeps glyphs from touching the box edges and
+ * mirrors Word's small default `w:space` around paragraph borders.
+ */
+export declare const PARAGRAPH_BORDER_PADDING_PX = 2;

package/dist/layoutProjection/documentLayout.d.ts

@@ -2,6 +2,5 @@ import { EditorDocument, EditorLayoutDocument, EditorLayoutParagraph } from '../
 import { ITextMeasurer } from '../../core/engine.js';
 
 export declare function projectDocumentLayout(document: EditorDocument, maxPageHeightOverride?: number, measuredHeights?: Record<string, number>, measuredParagraphLayouts?: Record<string, EditorLayoutParagraph>, options?: {
-    layoutMode?: "fast" | "wordParity";
     measurer?: ITextMeasurer;
 }): EditorLayoutDocument;

package/dist/layoutProjection/dropCapExclusion.d.ts

@@ -0,0 +1,23 @@
+import { EditorDropCap } from '../../core/model.js';
+import { FloatingExclusionRect } from '../floatingObjects.js';
+
+/** Synthetic run id used for the drop-cap exclusion rect. */
+export declare const DROP_CAP_EXCLUSION_RUN_ID = "dropcap";
+/**
+ * Advance width (px) of the cap glyph(s) at their own font size, used to size
+ * the exclusion the body text wraps around.
+ */
+export declare function measureDropCapWidth(dropCap: EditorDropCap): number;
+/**
+ * Build the exclusion rectangle that the wrapping paragraph's lines avoid so
+ * body text flows to the right of the drop cap. Reuses the floating-object
+ * exclusion model: `wrap: "square"` shortens every line the rect overlaps.
+ *
+ * Coordinates are paragraph-local (x/y relative to the paragraph's text box):
+ * a "drop" cap sits at the left edge (x = 0); a "margin" cap sits in the left
+ * margin (x = -width).
+ */
+export declare function resolveDropCapExclusion(options: {
+    dropCap: EditorDropCap;
+    bodyLineHeight: number;
+}): FloatingExclusionRect | null;

package/dist/layoutProjection/endnotePagination.d.ts

@@ -0,0 +1,8 @@
+import { EditorDocument } from '../../core/model.js';
+
+/**
+ * Return a document whose last section has the endnote flow appended. When the
+ * document has no referenced endnotes the original document is returned
+ * unchanged (referential equality preserved).
+ */
+export declare function injectEndnotesIntoDocument(document: EditorDocument): EditorDocument;

package/dist/layoutProjection/floatingObjects.d.ts

@@ -0,0 +1,45 @@
+import { EditorImageFloatingLayout, EditorImageRunData, EditorLayoutFragment, EditorLayoutLine, EditorPageSettings, EditorTextBoxData } from '../../core/model.js';
+
+export interface FloatingObjectRect {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+export interface ExclusionPolygonPoint {
+    x: number;
+    y: number;
+}
+export interface FloatingExclusionRect extends FloatingObjectRect {
+    wrap: NonNullable<EditorImageFloatingLayout["wrap"]>;
+    sourceRunId: string;
+    /** Absolute-layout-coordinate tight/through contour. When present (images
+     * with a wrapPolygon and wrap tight/through), the composer carves per-line
+     * intervals from this outline instead of the bounding rect. */
+    polygon?: ExclusionPolygonPoint[];
+}
+export interface FloatingObjectGeometry {
+    width: number;
+    height: number;
+    floating: EditorImageFloatingLayout;
+}
+export type ResolveTextBoxHeight = (textBox: EditorTextBoxData) => number;
+export declare function getTextBoxFloatingGeometry(textBox: EditorTextBoxData, heightOverride?: number): FloatingObjectGeometry;
+export declare function getImageFloatingGeometry(image: EditorImageRunData): FloatingObjectGeometry;
+export declare function resolveFloatingObjectRect(options: {
+    object: FloatingObjectGeometry;
+    pageSettings: EditorPageSettings;
+    contentLeft: number;
+    contentTop: number;
+    contentWidth: number;
+    paragraphTop: number;
+    lineTop: number;
+    anchorLeft: number;
+}): FloatingObjectRect;
+export declare function collectParagraphFloatingExclusions(options: {
+    fragments: EditorLayoutFragment[];
+    preliminaryLines: EditorLayoutLine[];
+    pageSettings: EditorPageSettings;
+    contentWidth: number;
+    resolveTextBoxHeight?: ResolveTextBoxHeight;
+}): FloatingExclusionRect[];

package/dist/layoutProjection/footnotePagination.d.ts

@@ -5,14 +5,13 @@ export declare const FOOTNOTE_SEPARATOR_HEIGHT = 10;
 export declare const FOOTNOTE_BLOCK_GAP = 2;
 export declare const FOOTNOTE_MARKER_GUTTER_PX = 24;
 export declare const MAX_FOOTNOTE_LAYOUT_ITERATIONS = 4;
-export type HeaderFooterBlockProjector = (blocks: EditorBlockNode[], pageIndex?: number, totalPages?: number, measuredHeights?: Record<string, number>, measuredParagraphLayouts?: Record<string, EditorLayoutParagraph>, styles?: EditorDocument["styles"], contentWidth?: number, layoutMode?: "fast" | "wordParity", measurer?: ITextMeasurer) => EditorLayoutBlock[];
+export type HeaderFooterBlockProjector = (blocks: EditorBlockNode[], pageIndex?: number, totalPages?: number, measuredHeights?: Record<string, number>, measuredParagraphLayouts?: Record<string, EditorLayoutParagraph>, styles?: EditorDocument["styles"], contentWidth?: number, measurer?: ITextMeasurer, defaultTabStop?: number) => EditorLayoutBlock[];
 export declare function collectPageFootnoteReferenceIds(page: EditorLayoutPage): string[];
 export interface FootnotePaginationContext {
     document: EditorDocument;
     totalPages?: number;
     measuredHeights?: Record<string, number>;
     measuredParagraphLayouts?: Record<string, EditorLayoutParagraph>;
-    layoutMode: "fast" | "wordParity";
     measurer: ITextMeasurer;
     projectBlocks: HeaderFooterBlockProjector;
 }

package/dist/layoutProjection/headerFooterFootnotes.d.ts

@@ -1,4 +1,4 @@
 import { EditorBlockNode, EditorLayoutBlock, EditorLayoutParagraph, EditorNamedStyle } from '../../core/model.js';
 import { ITextMeasurer } from '../../core/engine.js';
 
-export declare function projectHeaderFooterBlocks(blocks: EditorBlockNode[], pageIndex?: number, totalPages?: number, measuredHeights?: Record<string, number>, measuredParagraphLayouts?: Record<string, EditorLayoutParagraph>, styles?: Record<string, EditorNamedStyle>, contentWidth?: number, layoutMode?: "fast" | "wordParity", measurer?: ITextMeasurer): EditorLayoutBlock[];
+export declare function projectHeaderFooterBlocks(blocks: EditorBlockNode[], pageIndex?: number, totalPages?: number, measuredHeights?: Record<string, number>, measuredParagraphLayouts?: Record<string, EditorLayoutParagraph>, styles?: Record<string, EditorNamedStyle>, contentWidth?: number, measurer?: ITextMeasurer, defaultTabStop?: number): EditorLayoutBlock[];

package/dist/layoutProjection/headerFooterProjection.d.ts

@@ -1,14 +1,14 @@
 import { EditorBlockNode, EditorLayoutBlock, EditorLayoutParagraph, EditorNamedStyle, EditorParagraphNode } from '../../core/model.js';
 import { ITextMeasurer } from '../../core/engine.js';
 
-type ProjectParagraphLayoutFn = (paragraph: EditorParagraphNode, pageIndex?: number, totalPages?: number, styles?: Record<string, EditorNamedStyle>, contentWidth?: number, layoutMode?: "fast" | "wordParity", measurer?: ITextMeasurer) => EditorLayoutParagraph;
+type ProjectParagraphLayoutFn = (paragraph: EditorParagraphNode, pageIndex?: number, totalPages?: number, styles?: Record<string, EditorNamedStyle>, contentWidth?: number, measurer?: ITextMeasurer, defaultTabStop?: number) => EditorLayoutParagraph;
 type EstimateTableBlockHeightFn = (block: Extract<EditorBlockNode, {
     type: "table";
-}>, styles?: Record<string, EditorNamedStyle>, contentWidth?: number, layoutMode?: "fast" | "wordParity", measurer?: ITextMeasurer) => number;
+}>, styles?: Record<string, EditorNamedStyle>, contentWidth?: number, measurer?: ITextMeasurer, defaultTabStop?: number) => number;
 type GetProjectedParagraphBlockHeightFn = (paragraph: EditorParagraphNode, layout: EditorLayoutParagraph, styles: Record<string, EditorNamedStyle> | undefined) => number;
 export declare function projectHeaderFooterBlocksWithDependencies(blocks: EditorBlockNode[], deps: {
     projectParagraphLayout: ProjectParagraphLayoutFn;
     estimateTableBlockHeight: EstimateTableBlockHeightFn;
     getProjectedParagraphBlockHeight: GetProjectedParagraphBlockHeightFn;
-}, pageIndex?: number, totalPages?: number, measuredHeights?: Record<string, number>, _measuredParagraphLayouts?: Record<string, EditorLayoutParagraph>, styles?: Record<string, EditorNamedStyle>, contentWidth?: number, layoutMode?: "fast" | "wordParity", measurer?: ITextMeasurer): EditorLayoutBlock[];
+}, pageIndex?: number, totalPages?: number, measuredHeights?: Record<string, number>, _measuredParagraphLayouts?: Record<string, EditorLayoutParagraph>, styles?: Record<string, EditorNamedStyle>, contentWidth?: number, measurer?: ITextMeasurer, defaultTabStop?: number): EditorLayoutBlock[];
 export {};

package/dist/layoutProjection/index.d.ts

@@ -1,7 +1,9 @@
-export { FOOTNOTE_MARKER_GUTTER_PX, } from '../constants.js';
-export { estimateParagraphBlockHeight, } from '../blockHeights.js';
-export { estimateTableBlockHeight, } from '../tableProjection.js';
-export { measureParagraphLayoutFromRects, projectParagraphLayout, resolveClosestOffsetInMeasuredLayout, } from '../paragraphProjection.js';
-export { projectHeaderFooterBlocks, } from '../headerFooterFootnotes.js';
-export { projectBlocksLayout, } from '../blocksPagination.js';
-export { projectDocumentLayout, } from '../documentLayout.js';
+export { FOOTNOTE_MARKER_GUTTER_PX, PARAGRAPH_BORDER_PADDING_PX, PX_PER_POINT, } from '../constants.js';
+export { getParagraphBorderInsets, type ParagraphBorderInsets, } from '../paragraphBorders.js';
+export { estimateParagraphBlockHeight } from '../blockHeights.js';
+export { estimateTableBlockHeight } from '../tableProjection.js';
+export { clearProjectedParagraphLayoutCache, measureParagraphLayoutFromRects, projectParagraphLayout, projectParagraphLayoutWithExclusions, resolveClosestOffsetInMeasuredLayout, } from '../paragraphProjection.js';
+export { projectHeaderFooterBlocks } from '../headerFooterFootnotes.js';
+export { collectParagraphFloatingExclusions, getImageFloatingGeometry, getTextBoxFloatingGeometry, resolveFloatingObjectRect, type FloatingExclusionRect, type FloatingObjectRect, } from '../floatingObjects.js';
+export { projectBlocksLayout } from '../blocksPagination.js';
+export { projectDocumentLayout } from '../documentLayout.js';

package/dist/layoutProjection/paragraphBorders.d.ts

@@ -0,0 +1,14 @@
+import { EditorParagraphStyle } from '../../core/model.js';
+
+export interface ParagraphBorderInsets {
+    top: number;
+    bottom: number;
+}
+/**
+ * Vertical space (px) a paragraph's top/bottom borders add around its text.
+ * Each visible edge reserves its stroke width plus
+ * {@link PARAGRAPH_BORDER_PADDING_PX}; absent edges reserve nothing, so plain or
+ * shading-only paragraphs are unchanged. Shared by pagination (to reserve the
+ * height) and the canvas/PDF painters (to size the box and offset the text).
+ */
+export declare function getParagraphBorderInsets(style: EditorParagraphStyle): ParagraphBorderInsets;

package/dist/layoutProjection/paragraphPagination.d.ts

@@ -1,20 +1,34 @@
-import { EditorLayoutLine, EditorLayoutParagraph, EditorNamedStyle, EditorParagraphNode } from '../../core/model.js';
+import { EditorLayoutLine, EditorLayoutParagraph, EditorNamedStyle, EditorPageSettings, EditorParagraphNode, EditorParagraphStyle } from '../../core/model.js';
 import { CharRect } from '../../ui/caretGeometry.js';
 import { ITextMeasurer } from '../../core/engine.js';
+import { ResolveTextBoxHeight } from '../floatingObjects.js';
 
-export declare function projectParagraphLayout(paragraph: EditorParagraphNode, pageIndex?: number, totalPages?: number, styles?: Record<string, EditorNamedStyle>, contentWidth?: number, layoutMode?: "fast" | "wordParity", measurer?: ITextMeasurer): EditorLayoutParagraph;
-export declare function measureParagraphLayoutFromRects(paragraph: EditorParagraphNode, charRects: CharRect[], styles?: Record<string, EditorNamedStyle>, layoutMode?: "fast" | "wordParity"): EditorLayoutParagraph;
+export declare function shouldCollapseContextualSpacing(previous: EditorParagraphNode | undefined, next: EditorParagraphNode | undefined, styles: Record<string, EditorNamedStyle> | undefined): boolean;
+export declare function clearProjectedParagraphLayoutCache(): void;
+export declare function projectParagraphLayout(paragraph: EditorParagraphNode, pageIndex?: number, totalPages?: number, styles?: Record<string, EditorNamedStyle>, contentWidth?: number, measurer?: ITextMeasurer, defaultTabStop?: number): EditorLayoutParagraph;
+export declare function projectParagraphLayoutWithExclusions(paragraph: EditorParagraphNode, pageSettings: EditorPageSettings | undefined, contentWidth: number | undefined, measurer?: ITextMeasurer, pageIndex?: number, totalPages?: number, styles?: Record<string, EditorNamedStyle>, defaultTabStop?: number, resolveTextBoxHeight?: ResolveTextBoxHeight): EditorLayoutParagraph;
+export declare function measureParagraphLayoutFromRects(paragraph: EditorParagraphNode, charRects: CharRect[], styles?: Record<string, EditorNamedStyle>): EditorLayoutParagraph;
 export declare function applyMeasuredLineGeometry(projected: EditorLayoutParagraph, measured: EditorLayoutParagraph): EditorLayoutParagraph;
 export declare function isMeasuredLayoutCurrent(projected: EditorLayoutParagraph, measured: EditorLayoutParagraph): boolean;
 export declare function resolveClosestOffsetInMeasuredLayout(layout: EditorLayoutParagraph, clientX: number, clientY: number): number;
-export declare function getEffectiveParagraphStyle(paragraph: EditorParagraphNode, styles: Record<string, EditorNamedStyle> | undefined): Required<import('../../core/model.js').EditorParagraphStyle>;
-export declare function getParagraphSegmentHeight(paragraph: EditorParagraphNode, lines: EditorLayoutLine[], isFirstSegment: boolean, isLastSegment: boolean, styles: Record<string, EditorNamedStyle> | undefined, allowSpacingBefore?: boolean): number;
-export declare function getParagraphSegmentFitHeight(paragraph: EditorParagraphNode, segmentHeight: number, isLastSegment: boolean, styles: Record<string, EditorNamedStyle> | undefined, _layoutMode: "fast" | "wordParity"): number;
-export declare function getProjectedParagraphBlockHeight(paragraph: EditorParagraphNode, layout: EditorLayoutParagraph, styles: Record<string, EditorNamedStyle> | undefined, allowSpacingBefore?: boolean): number;
+export declare function getEffectiveParagraphStyle(paragraph: EditorParagraphNode, styles: Record<string, EditorNamedStyle> | undefined): Required<EditorParagraphStyle>;
+export declare function getParagraphSegmentHeight(paragraph: EditorParagraphNode, lines: EditorLayoutLine[], isFirstSegment: boolean, isLastSegment: boolean, styles: Record<string, EditorNamedStyle> | undefined, allowSpacingBefore?: boolean, allowSpacingAfter?: boolean): number;
+export declare function getParagraphSegmentFitHeight(paragraph: EditorParagraphNode, segmentHeight: number, isLastSegment: boolean, styles: Record<string, EditorNamedStyle> | undefined, allowSpacingAfter?: boolean): number;
+export declare function getProjectedParagraphBlockHeight(paragraph: EditorParagraphNode, layout: EditorLayoutParagraph, styles: Record<string, EditorNamedStyle> | undefined, allowSpacingBefore?: boolean, allowSpacingAfter?: boolean): number;
 export declare function getParagraphMeasuredHeight(measuredHeights: Record<string, number> | undefined, paragraphId: string, segmentId: string, isWholeParagraphSegment: boolean, fallbackHeight: number): number;
 export declare function createParagraphSegmentLayout(layout: EditorLayoutParagraph, startLineIndex: number, endLineIndexExclusive: number): EditorLayoutParagraph;
-export declare function applyWidowOrphanControl(paragraph: EditorParagraphNode, lines: EditorLayoutLine[], startLineIndex: number, endLineIndexExclusive: number, styles: Record<string, EditorNamedStyle> | undefined, allowSpacingBefore?: boolean): {
+export declare function applyWidowOrphanControl(paragraph: EditorParagraphNode, lines: EditorLayoutLine[], startLineIndex: number, endLineIndexExclusive: number, styles: Record<string, EditorNamedStyle> | undefined, allowSpacingBefore?: boolean, allowSpacingAfter?: boolean, allowOrphanControl?: boolean): {
     endLineIndexExclusive: number;
     height: number;
 };
-export declare function estimateParagraphBlockHeight(paragraph: EditorParagraphNode, styles?: Record<string, EditorNamedStyle>, contentWidth?: number, layoutMode?: "fast" | "wordParity", measurer?: ITextMeasurer): number;
+export interface EstimateParagraphBlockHeightOptions {
+    allowSpacingBefore?: boolean;
+    allowSpacingAfter?: boolean;
+}
+/**
+ * TODO: Floating wrap exclusions are intentionally ignored in this estimate.
+ * If pagination issues appear with large floating objects affecting nearby
+ * paragraphs, introduce a dedicated estimation path using an
+ * exclusionSignature, not raw pageSettings.
+ */
+export declare function estimateParagraphBlockHeight(paragraph: EditorParagraphNode, styles?: Record<string, EditorNamedStyle>, contentWidth?: number, measurer?: ITextMeasurer, options?: EstimateParagraphBlockHeightOptions, defaultTabStop?: number): number;

package/dist/layoutProjection/paragraphProjection.d.ts

@@ -1 +1 @@
-export { measureParagraphLayoutFromRects, projectParagraphLayout, resolveClosestOffsetInMeasuredLayout, } from '../paragraphPagination.js';
+export { clearProjectedParagraphLayoutCache, measureParagraphLayoutFromRects, projectParagraphLayout, projectParagraphLayoutWithExclusions, resolveClosestOffsetInMeasuredLayout, } from '../paragraphPagination.js';

package/dist/layoutProjection/sectionPagination.d.ts

@@ -14,16 +14,17 @@ export type BlocksLayoutProjector = (context: {
     layoutMode?: "fast" | "wordParity";
     measurer?: ITextMeasurer;
     reservedHeightByPageIndex?: Map<number, number>;
+    defaultTabStop?: number;
 }) => EditorLayoutPage[];
-export type HeaderFooterBlockProjector = (blocks: EditorBlockNode[], pageIndex?: number, totalPages?: number, measuredHeights?: Record<string, number>, measuredParagraphLayouts?: Record<string, EditorLayoutParagraph>, styles?: Record<string, EditorNamedStyle>, contentWidth?: number, layoutMode?: "fast" | "wordParity", measurer?: ITextMeasurer) => EditorLayoutBlock[];
+export type HeaderFooterBlockProjector = (blocks: EditorBlockNode[], pageIndex?: number, totalPages?: number, measuredHeights?: Record<string, number>, measuredParagraphLayouts?: Record<string, EditorLayoutParagraph>, styles?: Record<string, EditorNamedStyle>, contentWidth?: number, measurer?: ITextMeasurer, defaultTabStop?: number) => EditorLayoutBlock[];
 export interface SectionPaginationContext {
     sections: EditorSection[];
     documentStyles?: EditorDocument["styles"];
     maxPageHeightOverride?: number;
     measuredHeights?: Record<string, number>;
     measuredParagraphLayouts?: Record<string, EditorLayoutParagraph>;
-    layoutMode: "fast" | "wordParity";
     measurer: ITextMeasurer;
+    defaultTabStop?: number;
     needsTotalPages: boolean;
     projectBlocks: BlocksLayoutProjector;
     projectHeaderFooterBlocks: HeaderFooterBlockProjector;

package/dist/layoutProjection/tablePagination.d.ts

@@ -1,6 +1,7 @@
 import { EditorNamedStyle, EditorTableNode } from '../../core/model.js';
 import { ITextMeasurer } from '../../core/engine.js';
 
+export declare function estimateTableRowHeight(row: EditorTableNode["rows"][number], styles: Record<string, EditorNamedStyle> | undefined, measurer: ITextMeasurer, defaultTabStop: number | undefined, contentWidth?: number, table?: EditorTableNode, rowIndex?: number): number;
 export declare function getTableHeaderRowCount(table: EditorTableNode): number;
 export declare function getTableRowGroups(table: EditorTableNode): Array<{
     startRowIndex: number;
@@ -10,5 +11,5 @@ export declare function getRepeatableHeaderRowCount(table: EditorTableNode, head
     startRowIndex: number;
     endRowIndexExclusive: number;
 }>): number;
-export declare function getTableSegmentHeight(table: EditorTableNode, rowStartIndex: number, rowEndIndexExclusive: number, repeatedHeaderRowCount: number, styles: Record<string, EditorNamedStyle> | undefined, layoutMode: "fast" | "wordParity", contentWidth?: number, _measurer?: ITextMeasurer): number;
-export declare function estimateTableBlockHeight(table: EditorTableNode, styles?: Record<string, EditorNamedStyle>, contentWidth?: number, layoutMode?: "fast" | "wordParity", measurer?: ITextMeasurer): number;
+export declare function getTableSegmentHeight(table: EditorTableNode, rowStartIndex: number, rowEndIndexExclusive: number, repeatedHeaderRowCount: number, styles: Record<string, EditorNamedStyle> | undefined, contentWidth?: number, measurer?: ITextMeasurer, defaultTabStop?: number): number;
+export declare function estimateTableBlockHeight(table: EditorTableNode, styles?: Record<string, EditorNamedStyle>, contentWidth?: number, measurer?: ITextMeasurer, defaultTabStop?: number): number;

package/dist/layoutProjection/tableProjection.d.ts

@@ -1 +1 @@
-export { estimateTableBlockHeight, } from '../tablePagination.js';
+export { estimateTableBlockHeight } from '../tablePagination.js';