@zeke-02/docx-editor-core 0.1.0

package/dist/layout-bridge/measuring/index.d.ts

@@ -0,0 +1,377 @@
+/**
+ * Text Measurement Module
+ *
+ * Provides text measurement utilities for the layout engine.
+ * Uses Canvas API for accurate, cached measurements.
+ * @packageDocumentation
+ * @public
+ */
+import { WrapTextDirection, TextRun, ParagraphBlock, ParagraphMeasure, FlowBlock, Measure } from '../../layout-engine/types.js';
+import '../../content-CmqAwdFL.js';
+import '../../formatting-_OXU8gLB.js';
+import '../../colors-C3vA7HUU.js';
+import '../../docx/wrapTypes.js';
+
+/**
+ * Measurement container for text layout
+ *
+ * Uses HTML5 Canvas API to measure text runs and calculate typography metrics.
+ * Canvas-based measurement is more accurate and performant than DOM-based approaches.
+ *
+ * Typography conventions (matching Word behavior):
+ * - ascent ≈ fontSize * 0.8 (baseline to top)
+ * - descent ≈ fontSize * 0.2 (baseline to bottom)
+ * - lineHeight from font metrics (fontBoundingBoxAscent + fontBoundingBoxDescent),
+ *   falling back to fontSize * 1.0 (OOXML spec default single spacing)
+ */
+/**
+ * Font styling properties for measurement
+ */
+interface FontStyle {
+    fontFamily?: string;
+    fontSize?: number;
+    bold?: boolean;
+    italic?: boolean;
+    letterSpacing?: number;
+}
+/**
+ * Typography metrics for a font
+ */
+interface FontMetrics {
+    fontSize: number;
+    ascent: number;
+    descent: number;
+    lineHeight: number;
+    fontFamily: string;
+    /** OS/2 single-line ratio for OOXML line spacing calculation */
+    singleLineRatio: number;
+}
+/**
+ * Result of measuring a text string
+ */
+interface TextMeasurement {
+    width: number;
+    height: number;
+    ascent: number;
+    descent: number;
+}
+/**
+ * Result of measuring a run of text
+ */
+interface RunMeasurement {
+    width: number;
+    charWidths: number[];
+    metrics: FontMetrics;
+}
+/**
+ * Get or create a canvas 2D context for text measurement
+ */
+declare function getCanvasContext(): CanvasRenderingContext2D;
+/**
+ * Reset the canvas context (useful for testing)
+ */
+declare function resetCanvasContext(): void;
+/**
+ * Build a CSS font string from styling properties
+ *
+ * Font sizes are in points and need to be converted to pixels for canvas.
+ * 1pt = 96/72 px ≈ 1.333px at standard web DPI.
+ *
+ * Uses the font resolver to get category-appropriate fallback stacks
+ * (serif fonts get serif fallbacks, sans-serif get sans-serif, etc.)
+ * matching the same stacks used in rendering for consistent measurements.
+ *
+ * @example
+ * buildFontString({ fontFamily: "Arial", fontSize: 12, bold: true })
+ * // Returns: "bold 16px Arial, Arimo, Helvetica, sans-serif" (12pt = 16px)
+ */
+declare function buildFontString(style: FontStyle): string;
+/**
+ * Get typography metrics for a given font size and family
+ *
+ * Uses Canvas TextMetrics API when available for precise metrics,
+ * falls back to ratio-based approximations.
+ */
+declare function getFontMetrics(style: FontStyle): FontMetrics;
+/**
+ * Measure the width of a text string with specific styling
+ *
+ * @param text - The text to measure
+ * @param style - Font styling properties
+ * @returns Width in pixels
+ */
+declare function measureTextWidth(text: string, style: FontStyle): number;
+/**
+ * Measure text and return full metrics
+ */
+declare function measureText(text: string, style: FontStyle): TextMeasurement;
+/**
+ * Measure a run of text and return per-character widths for click positioning
+ *
+ * @param text - The text to measure
+ * @param style - Font styling properties
+ * @returns Run measurement with width and per-character widths
+ */
+declare function measureRun(text: string, style: FontStyle): RunMeasurement;
+/**
+ * Find the character offset at a given X position within a text run
+ *
+ * @param x - X position relative to run start
+ * @param charWidths - Per-character widths from measureRun
+ * @returns Character offset (0-based index)
+ */
+declare function findCharacterAtX(x: number, charWidths: number[]): number;
+/**
+ * Get the X position of a character offset within a text run
+ *
+ * @param offset - Character offset (0-based index)
+ * @param charWidths - Per-character widths from measureRun
+ * @returns X position in pixels
+ */
+declare function getXForCharacter(offset: number, charWidths: number[]): number;
+/**
+ * Convert twips to pixels
+ */
+declare function twipsToPx(twips: number): number;
+/**
+ * Convert pixels to twips
+ */
+declare function pxToTwips(px: number): number;
+/**
+ * Convert points to pixels
+ */
+declare function ptToPx(pt: number): number;
+/**
+ * Convert pixels to points
+ */
+declare function pxToPt(px: number): number;
+/**
+ * Convert OOXML half-points to pixels
+ * OOXML font sizes are in half-points (24 = 12pt)
+ */
+declare function halfPtToPx(halfPt: number): number;
+/**
+ * Convert pixels to OOXML half-points
+ */
+declare function pxToHalfPt(px: number): number;
+
+interface FloatingExclusionRect {
+    /** Which side the object is on for simple one-sided wrapping. */
+    side: 'left' | 'right';
+    /** X position relative to the content area. */
+    x: number;
+    /** Y position relative to the content area. */
+    y: number;
+    width: number;
+    height: number;
+    distTop: number;
+    distBottom: number;
+    distLeft: number;
+    distRight: number;
+    wrapText?: WrapTextDirection;
+    wrapType?: string;
+}
+interface FloatingImageZone {
+    leftMargin: number;
+    rightMargin: number;
+    topY: number;
+    bottomY: number;
+    segments?: FloatingLineSegmentZone[];
+}
+interface FloatingLineSegmentZone {
+    leftOffset: number;
+    availableWidth: number;
+}
+interface FloatingLineMargins {
+    leftMargin: number;
+    rightMargin: number;
+    segments?: FloatingLineSegmentZone[];
+}
+declare function rectsToFloatingZones(rects: FloatingExclusionRect[], contentWidth: number): FloatingImageZone[];
+declare function getFloatingMargins(lineY: number, lineHeight: number, zones: FloatingImageZone[] | undefined, paragraphYOffset: number): FloatingLineMargins;
+
+/**
+ * Paragraph measurement module
+ *
+ * Measures paragraph blocks and computes line breaking.
+ * Converts runs into measured lines with typography metrics.
+ */
+
+/**
+ * Options for paragraph measurement
+ */
+interface MeasureParagraphOptions {
+    /** Floating image exclusion zones that affect line widths */
+    floatingZones?: FloatingImageZone[];
+    /** Y offset of this paragraph relative to the exclusion zones (default: 0) */
+    paragraphYOffset?: number;
+}
+/**
+ * When a float's wrap margins consume the entire content width (or more),
+ * there is no horizontal strip beside it for body text. Word renders the
+ * following lines at full content width instead of squeezing them into a
+ * 1-pixel column. Unchecked margins from near-full-width tables/images can
+ * exceed contentWidth and collapse every line to ~1 glyph (the "single
+ * character per line after a wide floating table" bug).
+ *
+ * Returned margins are zeroed when:
+ * - either side alone is >= contentWidth (no strip on that side at all), or
+ * - their sum is >= contentWidth (no strip exists between the two sides).
+ */
+declare function clampFloatingWrapMargins(leftMargin: number, rightMargin: number, contentWidth: number): {
+    leftMargin: number;
+    rightMargin: number;
+};
+/**
+ * Measure a paragraph block and compute line breaks
+ *
+ * @param block - The paragraph block to measure
+ * @param maxWidth - Maximum available width for the paragraph
+ * @param options - Optional measurement options (floating zones, Y offset)
+ * @returns ParagraphMeasure with lines and total height
+ */
+declare function measureParagraph(block: ParagraphBlock, maxWidth: number, options?: MeasureParagraphOptions): ParagraphMeasure;
+/**
+ * Measure multiple paragraph blocks
+ *
+ * @param blocks - Array of paragraph blocks to measure
+ * @param maxWidth - Maximum available width
+ * @returns Array of ParagraphMeasure results
+ */
+declare function measureParagraphs(blocks: ParagraphBlock[], maxWidth: number): ParagraphMeasure[];
+/**
+ * Get per-character widths for a text run (for click positioning)
+ *
+ * @param run - The text run to measure
+ * @returns Array of character widths
+ */
+declare function getRunCharWidths(run: TextRun): number[];
+
+/**
+ * Floating-aware block measurement pipeline.
+ *
+ * Pre-scans a block list to extract exclusion zones from anchored images,
+ * floating tables, and floating text boxes; groups co-located floats so
+ * their combined exclusion applies starting from the earliest anchor; then
+ * walks the blocks calling the caller-supplied `measureBlock` with the
+ * active zones and cumulative Y at each step.
+ *
+ * Adapters (React, Vue) provide their own `measureBlock` so they can
+ * decide e.g. whether to cache paragraph measures. The orchestration,
+ * extraction, and grouping live here so both adapters stay in lockstep.
+ *
+ * @packageDocumentation
+ * @public
+ */
+
+/**
+ * Block-measurement callback shape passed to {@link measureBlocksWithFloats}.
+ * Adapters (React, Vue) supply this so they can decide platform-specific
+ * concerns (e.g. paragraph-measure caching, per-section width) while
+ * sharing the floating-zone orchestration. This is adapter-author API,
+ * not end-consumer API.
+ *
+ * @public
+ */
+type MeasureBlockFn = (block: FlowBlock, contentWidth: number, floatingZones?: FloatingImageZone[], cumulativeY?: number) => Measure;
+/**
+ * Walk `blocks` and produce one `Measure` per block. Before measuring, this
+ * extracts floating exclusion zones (images / floating tables / floating
+ * textboxes), groups overlapping co-located floats, and threads the active
+ * zones plus cumulative Y into each `measureBlock` call.
+ *
+ * @public
+ */
+declare function measureBlocksWithFloats(blocks: FlowBlock[], contentWidth: number | number[], measureBlock: MeasureBlockFn): Measure[];
+
+/**
+ * Measurement Cache
+ *
+ * LRU cache for text width measurements and paragraph layout results.
+ * Improves performance by avoiding repeated measurements of identical content.
+ */
+
+/**
+ * Get cached text width or return undefined
+ */
+declare function getCachedTextWidth(text: string, font: string, letterSpacing?: number): number | undefined;
+/**
+ * Store text width in cache
+ */
+declare function setCachedTextWidth(text: string, font: string, letterSpacing: number, width: number): void;
+/**
+ * Clear the text width cache
+ */
+declare function clearTextWidthCache(): void;
+/**
+ * Set the maximum size of the text width cache
+ */
+declare function setTextCacheSize(size: number): void;
+/**
+ * Get current text width cache size
+ */
+declare function getTextCacheSize(): number;
+/**
+ * Cached font metrics entry
+ */
+interface FontMetricsEntry {
+    ascent: number;
+    descent: number;
+    lineHeight: number;
+}
+/**
+ * Get cached font metrics or return undefined
+ */
+declare function getCachedFontMetrics(fontFamily: string, fontSize: number, bold?: boolean, italic?: boolean): FontMetricsEntry | undefined;
+/**
+ * Store font metrics in cache
+ */
+declare function setCachedFontMetrics(fontFamily: string, fontSize: number, bold: boolean, italic: boolean, metrics: FontMetricsEntry): void;
+/**
+ * Clear the font metrics cache
+ */
+declare function clearFontMetricsCache(): void;
+/**
+ * Set the maximum size of the font metrics cache
+ */
+declare function setFontCacheSize(size: number): void;
+/**
+ * Get current font metrics cache size
+ */
+declare function getFontCacheSize(): number;
+/**
+ * Generate a simple hash for a paragraph block
+ * Used as cache key to identify identical content
+ */
+declare function hashParagraphBlock(block: ParagraphBlock): string;
+/**
+ * Get cached paragraph measurement or return undefined
+ */
+declare function getCachedParagraphMeasure(block: ParagraphBlock, maxWidth: number): ParagraphMeasure | undefined;
+/**
+ * Store paragraph measurement in cache
+ */
+declare function setCachedParagraphMeasure(block: ParagraphBlock, maxWidth: number, measure: ParagraphMeasure): void;
+/**
+ * Clear the paragraph measure cache
+ */
+declare function clearParagraphMeasureCache(): void;
+/**
+ * Set the maximum size of the paragraph measure cache
+ */
+declare function setParagraphCacheSize(size: number): void;
+/**
+ * Get current paragraph measure cache size
+ */
+declare function getParagraphCacheSize(): number;
+/**
+ * Clear all measurement caches
+ * Call when fonts change, page width changes, or for testing
+ */
+declare function clearAllCaches(): void;
+/**
+ * Get total size of all caches
+ */
+declare function getTotalCacheSize(): number;
+
+export { type FloatingExclusionRect, type FloatingImageZone, type FloatingLineSegmentZone, type FontMetrics, type FontStyle, type MeasureBlockFn, type MeasureParagraphOptions, type RunMeasurement, type TextMeasurement, buildFontString, clampFloatingWrapMargins, clearAllCaches, clearFontMetricsCache, clearParagraphMeasureCache, clearTextWidthCache, findCharacterAtX, getCachedFontMetrics, getCachedParagraphMeasure, getCachedTextWidth, getCanvasContext, getFloatingMargins, getFontCacheSize, getFontMetrics, getParagraphCacheSize, getRunCharWidths, getTextCacheSize, getTotalCacheSize, getXForCharacter, halfPtToPx, hashParagraphBlock, measureBlocksWithFloats, measureParagraph, measureParagraphs, measureRun, measureText, measureTextWidth, ptToPx, pxToHalfPt, pxToPt, pxToTwips, rectsToFloatingZones, resetCanvasContext, setCachedFontMetrics, setCachedParagraphMeasure, setCachedTextWidth, setFontCacheSize, setParagraphCacheSize, setTextCacheSize, twipsToPx };

package/dist/layout-bridge/measuring/index.js

@@ -0,0 +1 @@
+'use strict';var chunkSORYYVJ7_js=require('../../chunk-SORYYVJ7.js'),chunkLTHT4A4S_js=require('../../chunk-LTHT4A4S.js');require('../../chunk-IMKU4O3P.js'),require('../../chunk-DROCYKAR.js'),require('../../chunk-44FHVKSI.js'),require('../../chunk-JFZIXFRC.js'),require('../../chunk-DV6GWBUJ.js'),require('../../chunk-N3Y5BUKV.js'),require('../../chunk-4Q2IP5FW.js'),require('../../chunk-DC7S76ZX.js');Object.defineProperty(exports,"clearAllCaches",{enumerable:true,get:function(){return chunkSORYYVJ7_js.B}});Object.defineProperty(exports,"clearFontMetricsCache",{enumerable:true,get:function(){return chunkSORYYVJ7_js.s}});Object.defineProperty(exports,"clearParagraphMeasureCache",{enumerable:true,get:function(){return chunkSORYYVJ7_js.y}});Object.defineProperty(exports,"clearTextWidthCache",{enumerable:true,get:function(){return chunkSORYYVJ7_js.n}});Object.defineProperty(exports,"getCachedFontMetrics",{enumerable:true,get:function(){return chunkSORYYVJ7_js.q}});Object.defineProperty(exports,"getCachedParagraphMeasure",{enumerable:true,get:function(){return chunkSORYYVJ7_js.w}});Object.defineProperty(exports,"getCachedTextWidth",{enumerable:true,get:function(){return chunkSORYYVJ7_js.l}});Object.defineProperty(exports,"getFontCacheSize",{enumerable:true,get:function(){return chunkSORYYVJ7_js.u}});Object.defineProperty(exports,"getParagraphCacheSize",{enumerable:true,get:function(){return chunkSORYYVJ7_js.A}});Object.defineProperty(exports,"getTextCacheSize",{enumerable:true,get:function(){return chunkSORYYVJ7_js.p}});Object.defineProperty(exports,"getTotalCacheSize",{enumerable:true,get:function(){return chunkSORYYVJ7_js.C}});Object.defineProperty(exports,"hashParagraphBlock",{enumerable:true,get:function(){return chunkSORYYVJ7_js.v}});Object.defineProperty(exports,"measureBlocksWithFloats",{enumerable:true,get:function(){return chunkSORYYVJ7_js.k}});Object.defineProperty(exports,"setCachedFontMetrics",{enumerable:true,get:function(){return chunkSORYYVJ7_js.r}});Object.defineProperty(exports,"setCachedParagraphMeasure",{enumerable:true,get:function(){return chunkSORYYVJ7_js.x}});Object.defineProperty(exports,"setCachedTextWidth",{enumerable:true,get:function(){return chunkSORYYVJ7_js.m}});Object.defineProperty(exports,"setFontCacheSize",{enumerable:true,get:function(){return chunkSORYYVJ7_js.t}});Object.defineProperty(exports,"setParagraphCacheSize",{enumerable:true,get:function(){return chunkSORYYVJ7_js.z}});Object.defineProperty(exports,"setTextCacheSize",{enumerable:true,get:function(){return chunkSORYYVJ7_js.o}});Object.defineProperty(exports,"buildFontString",{enumerable:true,get:function(){return chunkLTHT4A4S_js.c}});Object.defineProperty(exports,"clampFloatingWrapMargins",{enumerable:true,get:function(){return chunkLTHT4A4S_js.u}});Object.defineProperty(exports,"findCharacterAtX",{enumerable:true,get:function(){return chunkLTHT4A4S_js.h}});Object.defineProperty(exports,"getCanvasContext",{enumerable:true,get:function(){return chunkLTHT4A4S_js.a}});Object.defineProperty(exports,"getFloatingMargins",{enumerable:true,get:function(){return chunkLTHT4A4S_js.q}});Object.defineProperty(exports,"getFontMetrics",{enumerable:true,get:function(){return chunkLTHT4A4S_js.d}});Object.defineProperty(exports,"getRunCharWidths",{enumerable:true,get:function(){return chunkLTHT4A4S_js.x}});Object.defineProperty(exports,"getXForCharacter",{enumerable:true,get:function(){return chunkLTHT4A4S_js.i}});Object.defineProperty(exports,"halfPtToPx",{enumerable:true,get:function(){return chunkLTHT4A4S_js.n}});Object.defineProperty(exports,"measureParagraph",{enumerable:true,get:function(){return chunkLTHT4A4S_js.v}});Object.defineProperty(exports,"measureParagraphs",{enumerable:true,get:function(){return chunkLTHT4A4S_js.w}});Object.defineProperty(exports,"measureRun",{enumerable:true,get:function(){return chunkLTHT4A4S_js.g}});Object.defineProperty(exports,"measureText",{enumerable:true,get:function(){return chunkLTHT4A4S_js.f}});Object.defineProperty(exports,"measureTextWidth",{enumerable:true,get:function(){return chunkLTHT4A4S_js.e}});Object.defineProperty(exports,"ptToPx",{enumerable:true,get:function(){return chunkLTHT4A4S_js.l}});Object.defineProperty(exports,"pxToHalfPt",{enumerable:true,get:function(){return chunkLTHT4A4S_js.o}});Object.defineProperty(exports,"pxToPt",{enumerable:true,get:function(){return chunkLTHT4A4S_js.m}});Object.defineProperty(exports,"pxToTwips",{enumerable:true,get:function(){return chunkLTHT4A4S_js.k}});Object.defineProperty(exports,"rectsToFloatingZones",{enumerable:true,get:function(){return chunkLTHT4A4S_js.p}});Object.defineProperty(exports,"resetCanvasContext",{enumerable:true,get:function(){return chunkLTHT4A4S_js.b}});Object.defineProperty(exports,"twipsToPx",{enumerable:true,get:function(){return chunkLTHT4A4S_js.j}});

package/dist/layout-bridge/measuring/index.mjs

@@ -0,0 +1 @@
+export{B as clearAllCaches,s as clearFontMetricsCache,y as clearParagraphMeasureCache,n as clearTextWidthCache,q as getCachedFontMetrics,w as getCachedParagraphMeasure,l as getCachedTextWidth,u as getFontCacheSize,A as getParagraphCacheSize,p as getTextCacheSize,C as getTotalCacheSize,v as hashParagraphBlock,k as measureBlocksWithFloats,r as setCachedFontMetrics,x as setCachedParagraphMeasure,m as setCachedTextWidth,t as setFontCacheSize,z as setParagraphCacheSize,o as setTextCacheSize}from'../../chunk-MP4QSEO2.mjs';export{c as buildFontString,u as clampFloatingWrapMargins,h as findCharacterAtX,a as getCanvasContext,q as getFloatingMargins,d as getFontMetrics,x as getRunCharWidths,i as getXForCharacter,n as halfPtToPx,v as measureParagraph,w as measureParagraphs,g as measureRun,f as measureText,e as measureTextWidth,l as ptToPx,o as pxToHalfPt,m as pxToPt,k as pxToTwips,p as rectsToFloatingZones,b as resetCanvasContext,j as twipsToPx}from'../../chunk-6Y6LON6Y.mjs';import'../../chunk-FCJWLEKT.mjs';import'../../chunk-7E5VBRDL.mjs';import'../../chunk-BOOHU5EW.mjs';import'../../chunk-QPFJJPIC.mjs';import'../../chunk-WLHNIXWC.mjs';import'../../chunk-AMENZY5F.mjs';import'../../chunk-VW22RZ6C.mjs';import'../../chunk-QYUPLKLP.mjs';

package/dist/layout-bridge/tableInsertHover.d.mts

@@ -0,0 +1,45 @@
+/**
+ * Table-insert "+" hover hit-test.
+ *
+ * Pure DOM logic for the floating row/column insert button that shows
+ * when the mouse is near the left or top edge of a layout table. Lives
+ * in core so React + Vue + any future adapter can share the hit-test
+ * and just wire up their own UI rendering of the button.
+ *
+ * The function is gated by `hfEditMode`: tables in inactive HF/body
+ * regions don't surface the affordance. A header table only matches
+ * when the user is editing the header; a body table only matches when
+ * not in any HF edit mode.
+ * @packageDocumentation
+ * @public
+ */
+declare const TABLE_INSERT_EDGE_PROXIMITY = 30;
+declare const TABLE_INSERT_HIDE_DELAY_MS = 200;
+type TableInsertHoverHit = {
+    type: 'row' | 'column';
+    /** Client-coordinate anchor for the button. Caller converts to its UI frame. */
+    clientX: number;
+    clientY: number;
+    /** PM position of the cell the button targets. */
+    cellPmPos: number;
+};
+type TableInsertHoverInput = {
+    mouseX: number;
+    mouseY: number;
+    pagesContainer: HTMLElement;
+    /** Element under the cursor at the time of the event (e.target). */
+    target: HTMLElement;
+    hfEditMode: 'header' | 'footer' | null;
+    /** Override edge proximity in pixels (defaults to TABLE_INSERT_EDGE_PROXIMITY). */
+    edgeProximity?: number;
+};
+/**
+ * Detect whether a mousemove should surface a row/column insert "+" button.
+ *
+ * Returns the button anchor + target cell PM position, or `null` if the
+ * mouse isn't near a row's left edge or a column's top edge — or if the
+ * relevant table belongs to an inactive HF/body region.
+ */
+declare function detectTableInsertHover(input: TableInsertHoverInput): TableInsertHoverHit | null;
+
+export { TABLE_INSERT_EDGE_PROXIMITY, TABLE_INSERT_HIDE_DELAY_MS, type TableInsertHoverHit, type TableInsertHoverInput, detectTableInsertHover };

package/dist/layout-bridge/tableInsertHover.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Table-insert "+" hover hit-test.
+ *
+ * Pure DOM logic for the floating row/column insert button that shows
+ * when the mouse is near the left or top edge of a layout table. Lives
+ * in core so React + Vue + any future adapter can share the hit-test
+ * and just wire up their own UI rendering of the button.
+ *
+ * The function is gated by `hfEditMode`: tables in inactive HF/body
+ * regions don't surface the affordance. A header table only matches
+ * when the user is editing the header; a body table only matches when
+ * not in any HF edit mode.
+ * @packageDocumentation
+ * @public
+ */
+declare const TABLE_INSERT_EDGE_PROXIMITY = 30;
+declare const TABLE_INSERT_HIDE_DELAY_MS = 200;
+type TableInsertHoverHit = {
+    type: 'row' | 'column';
+    /** Client-coordinate anchor for the button. Caller converts to its UI frame. */
+    clientX: number;
+    clientY: number;
+    /** PM position of the cell the button targets. */
+    cellPmPos: number;
+};
+type TableInsertHoverInput = {
+    mouseX: number;
+    mouseY: number;
+    pagesContainer: HTMLElement;
+    /** Element under the cursor at the time of the event (e.target). */
+    target: HTMLElement;
+    hfEditMode: 'header' | 'footer' | null;
+    /** Override edge proximity in pixels (defaults to TABLE_INSERT_EDGE_PROXIMITY). */
+    edgeProximity?: number;
+};
+/**
+ * Detect whether a mousemove should surface a row/column insert "+" button.
+ *
+ * Returns the button anchor + target cell PM position, or `null` if the
+ * mouse isn't near a row's left edge or a column's top edge — or if the
+ * relevant table belongs to an inactive HF/body region.
+ */
+declare function detectTableInsertHover(input: TableInsertHoverInput): TableInsertHoverHit | null;
+
+export { TABLE_INSERT_EDGE_PROXIMITY, TABLE_INSERT_HIDE_DELAY_MS, type TableInsertHoverHit, type TableInsertHoverInput, detectTableInsertHover };

package/dist/layout-bridge/tableInsertHover.js

@@ -0,0 +1 @@
+'use strict';var chunkYUZQTRI2_js=require('../chunk-YUZQTRI2.js');require('../chunk-7U4I6BKJ.js'),require('../chunk-HKVAW3RE.js'),require('../chunk-SORYYVJ7.js'),require('../chunk-LTHT4A4S.js'),require('../chunk-IMKU4O3P.js'),require('../chunk-DROCYKAR.js'),require('../chunk-F44ZLDZS.js'),require('../chunk-44FHVKSI.js'),require('../chunk-7AMYZMCX.js'),require('../chunk-D4RPOJC7.js'),require('../chunk-IP2VXNWG.js'),require('../chunk-JFZIXFRC.js'),require('../chunk-MZOVDLYL.js'),require('../chunk-E4JMCA5X.js'),require('../chunk-HQPWFUP5.js'),require('../chunk-DV6GWBUJ.js'),require('../chunk-SHJBS42Y.js'),require('../chunk-MCFHOMA2.js'),require('../chunk-BHBOAP6Z.js'),require('../chunk-MZ7LW5CH.js'),require('../chunk-N3Y5BUKV.js'),require('../chunk-YTDWMXNS.js'),require('../chunk-6LVPRTB6.js'),require('../chunk-TUIEV7Q7.js'),require('../chunk-7HANRHHL.js'),require('../chunk-MJ5FQX7Q.js'),require('../chunk-C2BAPYGJ.js'),require('../chunk-4Q2IP5FW.js'),require('../chunk-Q4CKLXWA.js'),require('../chunk-DC7S76ZX.js');Object.defineProperty(exports,"TABLE_INSERT_EDGE_PROXIMITY",{enumerable:true,get:function(){return chunkYUZQTRI2_js.a}});Object.defineProperty(exports,"TABLE_INSERT_HIDE_DELAY_MS",{enumerable:true,get:function(){return chunkYUZQTRI2_js.b}});Object.defineProperty(exports,"detectTableInsertHover",{enumerable:true,get:function(){return chunkYUZQTRI2_js.c}});

package/dist/layout-bridge/tableInsertHover.mjs

@@ -0,0 +1 @@
+export{a as TABLE_INSERT_EDGE_PROXIMITY,b as TABLE_INSERT_HIDE_DELAY_MS,c as detectTableInsertHover}from'../chunk-UCJGOQ4J.mjs';import'../chunk-QLPQVR5W.mjs';import'../chunk-5VBNOHRE.mjs';import'../chunk-MP4QSEO2.mjs';import'../chunk-6Y6LON6Y.mjs';import'../chunk-FCJWLEKT.mjs';import'../chunk-7E5VBRDL.mjs';import'../chunk-RFC2SXZ6.mjs';import'../chunk-BOOHU5EW.mjs';import'../chunk-NDDJ67FQ.mjs';import'../chunk-LBKMYD3M.mjs';import'../chunk-NBLJPT54.mjs';import'../chunk-QPFJJPIC.mjs';import'../chunk-ILJUDEZ5.mjs';import'../chunk-6ZXL3EIP.mjs';import'../chunk-OEXVWIHW.mjs';import'../chunk-WLHNIXWC.mjs';import'../chunk-J7NADDC4.mjs';import'../chunk-2MSZXH6Q.mjs';import'../chunk-MOKKS75W.mjs';import'../chunk-OZMNIX6U.mjs';import'../chunk-AMENZY5F.mjs';import'../chunk-VHUVPHPI.mjs';import'../chunk-BGY3CB37.mjs';import'../chunk-ZX26QZJ5.mjs';import'../chunk-MJ6XZFVD.mjs';import'../chunk-67LVRQIR.mjs';import'../chunk-LE67NTCN.mjs';import'../chunk-VW22RZ6C.mjs';import'../chunk-VQWZHPWI.mjs';import'../chunk-QYUPLKLP.mjs';

package/dist/layout-bridge/toFlowBlocks.d.mts

@@ -0,0 +1,130 @@
+/**
+ * ProseMirror to FlowBlock Converter
+ *
+ * Converts a ProseMirror document into FlowBlock[] for the layout engine.
+ * Tracks pmStart/pmEnd positions for click-to-position mapping.
+ *
+ * The deep import `@eigenpal/.../layout-bridge/toFlowBlocks` is part of the
+ * public surface (Vue adapter + tests), so the per-domain helpers under
+ * ./toFlowBlocks/ are re-exported from here to keep that path stable.
+ * @packageDocumentation
+ * @public
+ */
+import { Node } from 'prosemirror-model';
+import { BorderStyle, FlowBlock } from '../layout-engine/types.mjs';
+import { T as Theme } from '../styles-EI2lxeEN.mjs';
+import { o as NumberFormat } from '../content-5Mrz6w_b.mjs';
+import '../formatting-BH4hcZiq.mjs';
+import '../colors-C3vA7HUU.mjs';
+import '../docx/wrapTypes.mjs';
+
+/**
+ * Shared types and primitive helpers used across toFlowBlocks sub-modules.
+ */
+
+/**
+ * Options for the conversion.
+ */
+type ToFlowBlocksOptions = {
+    /** Default font family. */
+    defaultFont?: string;
+    /** Default font size in points. */
+    defaultSize?: number;
+    /** Theme for resolving theme colors. */
+    theme?: Theme | null;
+    /** Page content height in pixels (pageHeight - marginTop - marginBottom). Images taller than this are scaled down to fit. */
+    pageContentHeight?: number;
+    /**
+     * Document-wide `w:defaultTabStop` (§17.6.13) in twips. Stamped onto each
+     * paragraph's attrs so the layout-time list-marker helper can snap body
+     * text to the default tab grid when no custom `w:tabs` are defined.
+     * Default 720 twips (Word's spec default).
+     */
+    defaultTabStopTwips?: number;
+    /**
+     * @internal Allocated by toFlowBlocks() and threaded through table /
+     * text-box conversion so list numbering stays continuous across containers.
+     * Keyed by abstractNumId when known (ECMA-376 §17.9.18: numIds sharing one
+     * abstractNum share counter state); falls back to numId.
+     */
+    listCounters?: Map<number, number[]>;
+    /**
+     * @internal Tracks `${numId}:${ilvl}` pairs whose startOverride has already
+     * been applied. Per ECMA-376 §17.9.27 the override fires the first time
+     * each level of a numId is encountered, so a numId with overrides on
+     * multiple ilvls fires each one independently.
+     */
+    listSeenNumIds?: Set<string>;
+};
+/**
+ * Reset the block ID counter (useful for testing).
+ */
+declare function resetBlockIdCounter(): void;
+
+/**
+ * Border Conversion
+ *
+ * Shared OOXML BorderSpec → layout-engine BorderStyle conversion, used by
+ * paragraph borders, table cell borders, and header/footer borders.
+ */
+
+/**
+ * Convert an OOXML BorderSpec to a layout-engine BorderStyle.
+ * Shared by paragraph borders, cell borders, and header/footer borders.
+ */
+declare function convertBorderSpecToLayout(border: {
+    style?: string;
+    size?: number;
+    space?: number;
+    color?: {
+        rgb?: string;
+        themeColor?: string;
+        themeTint?: string;
+        themeShade?: string;
+    };
+}, theme?: Theme | null): BorderStyle | undefined;
+
+/**
+ * List Marker Resolution
+ *
+ * Helpers for rendering OOXML list markers from the counter stack:
+ *   - format numbers as decimal/roman/letter per ECMA-376 §17.9.16 numFmt
+ *   - resolve lvlText templates ("%1.%2.") against the counter stack
+ *   - drive the per-paragraph counter increment, including startOverride.
+ */
+
+/**
+ * Resolve an OOXML lvlText template like "%1.%2." against the counter stack
+ * and per-level numFmt list (ECMA-376 §17.9.11).
+ *
+ * When a referenced counter has no value yet (e.g. "%2" referenced from a
+ * level-0 paragraph), the placeholder AND the punctuation immediately
+ * following it are dropped — matches Word's behavior so "%1.%2." renders
+ * "1." rather than "1..".
+ *
+ * Exported for unit testing.
+ */
+declare function resolveListTemplate(template: string, counters: number[], levelNumFmts: NumberFormat[] | undefined): string;
+
+/**
+ * ProseMirror to FlowBlock Converter
+ *
+ * Converts a ProseMirror document into FlowBlock[] for the layout engine.
+ * Tracks pmStart/pmEnd positions for click-to-position mapping.
+ *
+ * The deep import `@eigenpal/.../layout-bridge/toFlowBlocks` is part of the
+ * public surface (Vue adapter + tests), so the per-domain helpers under
+ * ./toFlowBlocks/ are re-exported from here to keep that path stable.
+ * @packageDocumentation
+ * @public
+ */
+
+/**
+ * Convert a ProseMirror document to FlowBlock array.
+ *
+ * Walks the document tree, converting each node to the appropriate block type.
+ * Tracks pmStart/pmEnd positions for each block for click-to-position mapping.
+ */
+declare function toFlowBlocks(doc: Node, options?: ToFlowBlocksOptions): FlowBlock[];
+
+export { type ToFlowBlocksOptions, convertBorderSpecToLayout, resetBlockIdCounter, resolveListTemplate, toFlowBlocks };