@eigenpal/docx-editor-core 0.0.0

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

@@ -0,0 +1,320 @@
+/**
+ * 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 } from '../../layout-engine/types.mjs';
+
+/**
+ * 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;
+}
+/**
+ * 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[];
+
+/**
+ * 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 MeasureParagraphOptions, type RunMeasurement, type TextMeasurement, buildFontString, clearAllCaches, clearFontMetricsCache, clearParagraphMeasureCache, clearTextWidthCache, findCharacterAtX, getCachedFontMetrics, getCachedParagraphMeasure, getCachedTextWidth, getCanvasContext, getFloatingMargins, getFontCacheSize, getFontMetrics, getParagraphCacheSize, getRunCharWidths, getTextCacheSize, getTotalCacheSize, getXForCharacter, halfPtToPx, hashParagraphBlock, measureParagraph, measureParagraphs, measureRun, measureText, measureTextWidth, ptToPx, pxToHalfPt, pxToPt, pxToTwips, rectsToFloatingZones, resetCanvasContext, setCachedFontMetrics, setCachedParagraphMeasure, setCachedTextWidth, setFontCacheSize, setParagraphCacheSize, setTextCacheSize, twipsToPx };

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

@@ -0,0 +1,320 @@
+/**
+ * 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 } from '../../layout-engine/types.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;
+}
+/**
+ * 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[];
+
+/**
+ * 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 MeasureParagraphOptions, type RunMeasurement, type TextMeasurement, buildFontString, clearAllCaches, clearFontMetricsCache, clearParagraphMeasureCache, clearTextWidthCache, findCharacterAtX, getCachedFontMetrics, getCachedParagraphMeasure, getCachedTextWidth, getCanvasContext, getFloatingMargins, getFontCacheSize, getFontMetrics, getParagraphCacheSize, getRunCharWidths, getTextCacheSize, getTotalCacheSize, getXForCharacter, halfPtToPx, hashParagraphBlock, 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 chunkDY2MJCSV_js=require('../../chunk-DY2MJCSV.js');require('../../chunk-JFZIXFRC.js'),require('../../chunk-N3Y5BUKV.js'),require('../../chunk-DC7S76ZX.js');Object.defineProperty(exports,"buildFontString",{enumerable:true,get:function(){return chunkDY2MJCSV_js.c}});Object.defineProperty(exports,"clearAllCaches",{enumerable:true,get:function(){return chunkDY2MJCSV_js.K}});Object.defineProperty(exports,"clearFontMetricsCache",{enumerable:true,get:function(){return chunkDY2MJCSV_js.B}});Object.defineProperty(exports,"clearParagraphMeasureCache",{enumerable:true,get:function(){return chunkDY2MJCSV_js.H}});Object.defineProperty(exports,"clearTextWidthCache",{enumerable:true,get:function(){return chunkDY2MJCSV_js.w}});Object.defineProperty(exports,"findCharacterAtX",{enumerable:true,get:function(){return chunkDY2MJCSV_js.h}});Object.defineProperty(exports,"getCachedFontMetrics",{enumerable:true,get:function(){return chunkDY2MJCSV_js.z}});Object.defineProperty(exports,"getCachedParagraphMeasure",{enumerable:true,get:function(){return chunkDY2MJCSV_js.F}});Object.defineProperty(exports,"getCachedTextWidth",{enumerable:true,get:function(){return chunkDY2MJCSV_js.u}});Object.defineProperty(exports,"getCanvasContext",{enumerable:true,get:function(){return chunkDY2MJCSV_js.a}});Object.defineProperty(exports,"getFloatingMargins",{enumerable:true,get:function(){return chunkDY2MJCSV_js.q}});Object.defineProperty(exports,"getFontCacheSize",{enumerable:true,get:function(){return chunkDY2MJCSV_js.D}});Object.defineProperty(exports,"getFontMetrics",{enumerable:true,get:function(){return chunkDY2MJCSV_js.d}});Object.defineProperty(exports,"getParagraphCacheSize",{enumerable:true,get:function(){return chunkDY2MJCSV_js.J}});Object.defineProperty(exports,"getRunCharWidths",{enumerable:true,get:function(){return chunkDY2MJCSV_js.t}});Object.defineProperty(exports,"getTextCacheSize",{enumerable:true,get:function(){return chunkDY2MJCSV_js.y}});Object.defineProperty(exports,"getTotalCacheSize",{enumerable:true,get:function(){return chunkDY2MJCSV_js.L}});Object.defineProperty(exports,"getXForCharacter",{enumerable:true,get:function(){return chunkDY2MJCSV_js.i}});Object.defineProperty(exports,"halfPtToPx",{enumerable:true,get:function(){return chunkDY2MJCSV_js.n}});Object.defineProperty(exports,"hashParagraphBlock",{enumerable:true,get:function(){return chunkDY2MJCSV_js.E}});Object.defineProperty(exports,"measureParagraph",{enumerable:true,get:function(){return chunkDY2MJCSV_js.r}});Object.defineProperty(exports,"measureParagraphs",{enumerable:true,get:function(){return chunkDY2MJCSV_js.s}});Object.defineProperty(exports,"measureRun",{enumerable:true,get:function(){return chunkDY2MJCSV_js.g}});Object.defineProperty(exports,"measureText",{enumerable:true,get:function(){return chunkDY2MJCSV_js.f}});Object.defineProperty(exports,"measureTextWidth",{enumerable:true,get:function(){return chunkDY2MJCSV_js.e}});Object.defineProperty(exports,"ptToPx",{enumerable:true,get:function(){return chunkDY2MJCSV_js.l}});Object.defineProperty(exports,"pxToHalfPt",{enumerable:true,get:function(){return chunkDY2MJCSV_js.o}});Object.defineProperty(exports,"pxToPt",{enumerable:true,get:function(){return chunkDY2MJCSV_js.m}});Object.defineProperty(exports,"pxToTwips",{enumerable:true,get:function(){return chunkDY2MJCSV_js.k}});Object.defineProperty(exports,"rectsToFloatingZones",{enumerable:true,get:function(){return chunkDY2MJCSV_js.p}});Object.defineProperty(exports,"resetCanvasContext",{enumerable:true,get:function(){return chunkDY2MJCSV_js.b}});Object.defineProperty(exports,"setCachedFontMetrics",{enumerable:true,get:function(){return chunkDY2MJCSV_js.A}});Object.defineProperty(exports,"setCachedParagraphMeasure",{enumerable:true,get:function(){return chunkDY2MJCSV_js.G}});Object.defineProperty(exports,"setCachedTextWidth",{enumerable:true,get:function(){return chunkDY2MJCSV_js.v}});Object.defineProperty(exports,"setFontCacheSize",{enumerable:true,get:function(){return chunkDY2MJCSV_js.C}});Object.defineProperty(exports,"setParagraphCacheSize",{enumerable:true,get:function(){return chunkDY2MJCSV_js.I}});Object.defineProperty(exports,"setTextCacheSize",{enumerable:true,get:function(){return chunkDY2MJCSV_js.x}});Object.defineProperty(exports,"twipsToPx",{enumerable:true,get:function(){return chunkDY2MJCSV_js.j}});

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

@@ -0,0 +1 @@
+export{c as buildFontString,K as clearAllCaches,B as clearFontMetricsCache,H as clearParagraphMeasureCache,w as clearTextWidthCache,h as findCharacterAtX,z as getCachedFontMetrics,F as getCachedParagraphMeasure,u as getCachedTextWidth,a as getCanvasContext,q as getFloatingMargins,D as getFontCacheSize,d as getFontMetrics,J as getParagraphCacheSize,t as getRunCharWidths,y as getTextCacheSize,L as getTotalCacheSize,i as getXForCharacter,n as halfPtToPx,E as hashParagraphBlock,r as measureParagraph,s 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,A as setCachedFontMetrics,G as setCachedParagraphMeasure,v as setCachedTextWidth,C as setFontCacheSize,I as setParagraphCacheSize,x as setTextCacheSize,j as twipsToPx}from'../../chunk-G6Y4UZMJ.mjs';import'../../chunk-QPFJJPIC.mjs';import'../../chunk-AMENZY5F.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 };