@eigenpal/docx-editor-core 0.0.0

package/dist/headerFooterLayout-DkclHZ0Z.d.mts

@@ -0,0 +1,201 @@
+import { FlowBlock, Measure, LayoutOptions, FootnoteContent, Layout, Page, PageMargins, ImageRun } from './layout-engine/types.mjs';
+import { Footnote, HeaderFooter } from './types/content.mjs';
+import { a as StyleDefinitions, T as Theme } from './styles-BBoqh07F.mjs';
+import { F as FootnoteRenderItem, H as HeaderFooterContent } from './footnotes-lCH_P3N3.mjs';
+import { Document } from './types/document.mjs';
+
+/**
+ * Footnote Layout Utilities
+ *
+ * Footnote/endnote rendering pipeline plus page-mapping helpers:
+ * - scanning FlowBlocks for footnote references and their PM positions
+ * - mapping references to the page that ends up containing them
+ * - converting a Footnote → FootnoteContent via the body pipeline
+ *   (footnoteToProseDoc → toFlowBlocks → caller-supplied measureBlocks)
+ * - reserving per-page footnote area heights for layout
+ *
+ * Everything that's pure OOXML / FlowBlock semantics lives here so the
+ * React, Vue, and any future adapters can share the conversion logic
+ * and just supply their own measurement function (which depends on
+ * platform-specific Canvas/font metrics).
+ */
+
+/** Separator line height + vertical padding in pixels. */
+declare const FOOTNOTE_SEPARATOR_HEIGHT = 12;
+/**
+ * Hard cap on the multi-pass footnote layout loop. Reserving footnote
+ * space can move a reference to another page, so adapters keep remapping
+ * until the page→height contract is stable. Dense layouts converge in
+ * 2–3 passes in practice; 6 is a safe ceiling.
+ */
+declare const MAX_FOOTNOTE_LAYOUT_PASSES = 6;
+/**
+ * Compare two per-page footnote reservation maps. Used by the React +
+ * Vue adapters to detect when the multi-pass loop has converged.
+ */
+declare function footnoteReservedHeightsEqual(a: Map<number, number>, b: Map<number, number>): boolean;
+/**
+ * Scan FlowBlocks for runs with footnoteRefId set.
+ * Returns a list of { footnoteId, pmPos } in document order.
+ */
+declare function collectFootnoteRefs(blocks: FlowBlock[]): Array<{
+    footnoteId: number;
+    pmPos: number;
+}>;
+/**
+ * After layout, determine which footnotes appear on which pages.
+ * Checks each page's fragments to see if any footnoteRef PM positions fall within.
+ *
+ * Returns Map<pageNumber, footnoteId[]> in document order.
+ */
+declare function mapFootnotesToPages(pages: Page[], footnoteRefs: Array<{
+    footnoteId: number;
+    pmPos: number;
+}>): Map<number, number[]>;
+/**
+ * Footnote-specific block normalization. Mirrors the spirit of
+ * `normalizeHeaderFooterMeasureBlocks`: post-process the body-pipeline
+ * output for a single footnote so it carries the correct visual prefix
+ * (its display number, rendered as a superscript) and a default 8pt font
+ * for any run that didn't specify a size.
+ *
+ * The displayNumber is prepended onto the FIRST paragraph as a fresh
+ * superscript text run — visually matches Word's footnote numbering
+ * without disturbing the authored runs.
+ *
+ * Exported for callers that want to compose their own conversion
+ * pipeline; `convertFootnoteToContent` calls it as part of its flow.
+ */
+declare function applyFootnotePresentation(blocks: FlowBlock[], displayNumber: number): FlowBlock[];
+/**
+ * Adapter-supplied block measurement function. The caller (React /
+ * Vue / etc.) supplies its platform's measure routine — at minimum
+ * paragraph + table + image + textBox — so this core helper stays
+ * Canvas-free.
+ */
+type MeasureBlocksFn = (blocks: FlowBlock[], contentWidth: number) => Measure[];
+/**
+ * Options for {@link convertFootnoteToContent}.
+ */
+type ConvertFootnoteOptions = {
+    /** The document's parsed style definitions, threaded into the body pipeline. */
+    styles?: StyleDefinitions | null;
+    /** Theme for resolving themed fills / fonts inside the footnote. */
+    theme?: Theme | null;
+    /** Measure callback supplied by the rendering adapter. */
+    measureBlocks: MeasureBlocksFn;
+};
+/**
+ * Convert a Footnote to renderable FootnoteContent via the body pipeline:
+ * `footnoteToProseDoc → toFlowBlocks → applyFootnotePresentation →
+ * measureBlocks`. Pre-PR (#378) this lived in a hand-rolled shadow stack
+ * that silently dropped non-paragraph content; routing through the body
+ * pipeline gives footnotes full block-kind support — paragraph + table
+ * + image + textBox + fields.
+ */
+declare function convertFootnoteToContent(footnote: Footnote, displayNumber: number, contentWidth: number, options: ConvertFootnoteOptions): FootnoteContent;
+/**
+ * Build footnote content for all footnotes referenced in the document.
+ * Display numbers are assigned by first-appearance order (the same way
+ * Word renders them).
+ */
+declare function buildFootnoteContentMap(footnotes: Footnote[], footnoteRefs: Array<{
+    footnoteId: number;
+}>, contentWidth: number, options: ConvertFootnoteOptions): Map<number, FootnoteContent>;
+/**
+ * Calculate per-page footnote reserved heights.
+ * Returns Map<pageNumber, reservedHeight>.
+ */
+declare function calculateFootnoteReservedHeights(pageFootnoteMap: Map<number, number[]>, footnoteContentMap: Map<number, {
+    height: number;
+}>): Map<number, number>;
+interface StabilizeFootnoteLayoutArgs {
+    blocks: FlowBlock[];
+    measures: Measure[];
+    layoutOpts: LayoutOptions;
+    footnoteRefs: Array<{
+        footnoteId: number;
+        pmPos: number;
+    }>;
+    footnoteContentMap: Map<number, FootnoteContent>;
+    /** First-pass layout already computed by the caller without reserved heights. */
+    initialLayout: Layout;
+}
+interface StabilizeFootnoteLayoutResult {
+    layout: Layout;
+    pageFootnoteMap: Map<number, number[]>;
+    /** True if the loop converged before hitting MAX_FOOTNOTE_LAYOUT_PASSES. */
+    converged: boolean;
+}
+/**
+ * Run the multi-pass footnote layout loop. Reserving footnote space on a
+ * page can move a reference to another page, which changes the reservation,
+ * which can move references again. Iterate until the page→height contract
+ * is the same one used by the latest layout, or `MAX_FOOTNOTE_LAYOUT_PASSES`
+ * passes have run.
+ *
+ * Lives in core so the React + Vue adapters call the same loop and stay in
+ * lockstep on convergence behaviour. Writes `page.footnoteIds` onto each
+ * page in the returned layout so renderers can paint footnote areas.
+ */
+declare function stabilizeFootnoteLayout(args: StabilizeFootnoteLayoutArgs): StabilizeFootnoteLayoutResult;
+/**
+ * Turn the page→footnote-id map into the per-page render payload that
+ * `renderPages` consumes via `footnotesByPage`. Skips non-`normal` notes
+ * (separators, continuation notices), reads the display number out of the
+ * content map, and pulls plain text via `getFootnoteText`.
+ *
+ * Lives in core (not in either adapter) so React + Vue both call the
+ * same helper — same rule as the rest of this module.
+ */
+declare function buildFootnoteRenderItems(pageFootnoteMap: Map<number, number[]>, footnoteContentMap: Map<number, FootnoteContent>, doc: Document | null): Map<number, FootnoteRenderItem[]>;
+
+/**
+ * Header / Footer Layout Utilities
+ *
+ * The header/footer rendering pipeline lives here so any rendering adapter
+ * (React, Vue, etc.) can share the conversion logic and just supply its
+ * platform-specific {@link MeasureBlocksFn}. Mirrors the footnote pipeline
+ * in `footnoteLayout.ts`.
+ *
+ * Pipeline:
+ *   HF.content → headerFooterToProseDoc → toFlowBlocks
+ *     → measureBlocks (caller-supplied, Canvas-aware)
+ *     → HeaderFooterContent (blocks, measures, height, visualTop/Bottom)
+ *
+ * The render side uses the normalized block list so paint and measurement stay
+ * in lockstep. Visual-bounds calculation still inspects the original block
+ * list because floating images can paint above/below the nominal flow box even
+ * when they do not contribute to flow height.
+ */
+
+type HeaderFooterMetrics = {
+    section: 'header' | 'footer';
+    pageSize: {
+        w: number;
+        h: number;
+    };
+    margins: PageMargins;
+};
+declare function normalizeHeaderFooterMeasureBlocks(blocks: FlowBlock[]): FlowBlock[];
+declare function resolveHeaderFooterVisualTop(run: ImageRun, paragraphY: number, flowHeight: number, metrics: HeaderFooterMetrics): number;
+declare function calculateHeaderFooterVisualBounds(blocks: FlowBlock[], measures: Measure[], flowHeight: number, metrics: HeaderFooterMetrics): {
+    visualTop: number;
+    visualBottom: number;
+};
+type ConvertHeaderFooterOptions = {
+    styles?: StyleDefinitions | null;
+    theme?: Theme | null;
+    measureBlocks: MeasureBlocksFn;
+};
+/**
+ * Convert HeaderFooter (document type) to HeaderFooterContent (render type).
+ *
+ * Routes through the same pipeline as the body: HF.content →
+ * headerFooterToProseDoc → toFlowBlocks → measureBlocks. The inline editor
+ * uses the same conversion chain, so block support (paragraph, table, image,
+ * textBox, fields) and the inline editor's content stay in lockstep.
+ */
+declare function convertHeaderFooterToContent(headerFooter: HeaderFooter | null | undefined, contentWidth: number, metrics: HeaderFooterMetrics, options: ConvertHeaderFooterOptions): HeaderFooterContent | undefined;
+
+export { type ConvertFootnoteOptions as C, FOOTNOTE_SEPARATOR_HEIGHT as F, type HeaderFooterMetrics as H, MAX_FOOTNOTE_LAYOUT_PASSES as M, type StabilizeFootnoteLayoutArgs as S, type ConvertHeaderFooterOptions as a, type MeasureBlocksFn as b, type StabilizeFootnoteLayoutResult as c, buildFootnoteContentMap as d, buildFootnoteRenderItems as e, calculateFootnoteReservedHeights as f, collectFootnoteRefs as g, convertHeaderFooterToContent as h, footnoteReservedHeightsEqual as i, applyFootnotePresentation as j, calculateHeaderFooterVisualBounds as k, convertFootnoteToContent as l, mapFootnotesToPages as m, normalizeHeaderFooterMeasureBlocks as n, resolveHeaderFooterVisualTop as r, stabilizeFootnoteLayout as s };

package/dist/headless.d.mts

@@ -0,0 +1,110 @@
+/**
+ * @eigenpal/docx-editor-core/headless
+ *
+ * Headless aggregate for Node.js scripts, CLI tools, and server-side
+ * processing. Same surface as the default `.` entry, named to make the
+ * "no DOM" intent explicit. Prefer the smaller subpaths (`./docx`,
+ * `./agent`, `./utils`, etc.) for new code — they tree-shake better.
+ *
+ * @example
+ * ```ts
+ * import { DocumentAgent, parseDocx, pluginRegistry } from '@eigenpal/docx-editor-core/headless';
+ * import { docxtemplaterPlugin } from '@eigenpal/docx-editor-core/core-plugins';
+ *
+ * // Register plugins
+ * pluginRegistry.register(docxtemplaterPlugin);
+ *
+ * // Load and manipulate document
+ * const buffer = fs.readFileSync('template.docx');
+ * const agent = await DocumentAgent.fromBuffer(buffer);
+ *
+ * // Get document info
+ * console.log('Word count:', agent.getWordCount());
+ * console.log('Variables:', agent.getVariables());
+ *
+ * // Edit document
+ * const newAgent = agent
+ *   .insertText({ paragraphIndex: 0, offset: 0 }, 'Hello ')
+ *   .applyStyle(0, 'Heading1');
+ *
+ * // Apply template variables
+ * const finalAgent = await newAgent.applyVariables({
+ *   customer_name: 'Jane Doe',
+ *   date: '2024-02-15',
+ * });
+ *
+ * // Export
+ * const output = await finalAgent.toBuffer();
+ * fs.writeFileSync('output.docx', Buffer.from(output));
+ * ```
+ * @packageDocumentation
+ * @public
+ */
+export { A as AgentContextOptions, S as ContextSelectionOptions, D as DocumentAgent, E as ExtendedSelectionContext, F as FormattedTextSegment, a as FormattingSummary, I as InsertHyperlinkOptions, b as InsertImageOptions, c as InsertTableOptions, d as InsertTextOptions, e as SelectionContextOptions, f as buildExtendedSelectionContext, g as buildSelectionContext, h as buildSelectionContextFromContext, i as createAgent, j as createAgentFromDocument, k as executeCommand, l as executeCommands, m as getAgentContext, n as getDocumentSummary, o as getSelectionFormattingSummary } from './selectionContext-Xq3AY7pn.mjs';
+export { countCharacters, countWords, getBlockIndexForParagraph, getBodyCharacterCount, getBodyText, getBodyWordCount, getFormattingAtPosition, getHyperlinkAtPosition, getHyperlinkText, getParagraphAtIndex, getParagraphText, getParagraphs, getRunText, getTableText, getTextAfter, getTextBefore, hasHyperlinks, hasImages, hasTables, isHeadingStyle, isPositionInHyperlink, parseHeadingLevel } from './agent/index.mjs';
+export { parseDocx } from './docx/parser.mjs';
+export { s as serializeDocumentBody, a as serializeDocx, b as serializeSectionProperties } from './documentSerializer-C1ueey5d.mjs';
+export { createDocx, default as repackDocx, updateMultipleFiles } from './docx/rezip.mjs';
+export { a as attemptSelectiveSave } from './selectiveSave-jinP_4xa.mjs';
+export { b as buildPatchedDocumentXml, v as validatePatchSafety } from './selectiveXmlPatch-ypkxlTD_.mjs';
+export { C as CreateEmptyDocumentOptions, P as ProcessTemplateOptions, a as ProcessTemplateResult, T as TemplateError, b as blendColors, c as colorsEqual, d as createDocumentWithText, e as createEmptyDocument, f as createRgbColor, g as createTemplateProcessor, h as createThemeColor, i as darkenColor, j as getContrastingColor, k as getMissingVariables, l as getTemplateTags, m as isBlack, n as isWhite, o as lightenColor, p as parseColorString, q as previewTemplate, r as processTemplate, s as processTemplateAdvanced, t as processTemplateAsBlob, u as processTemplateDetailed, v as resolveColor, w as resolveHighlightColor, x as resolveShadingColor, y as validateTemplate } from './colorResolver-C3q7MLLD.mjs';
+export { V as VariableDetectionResult, a as VariableOccurrence, d as detectVariables, b as detectVariablesDetailed, c as detectVariablesInBody, e as detectVariablesInParagraph, f as documentHasVariables, g as extractVariablesFromText, h as formatVariable, i as hasTemplateVariables, j as isValidVariableName, p as parseVariable, r as removeVariables, k as replaceVariables, s as sanitizeVariableName } from './variableDetector-CAdt8yOr.mjs';
+export { emuToPixels, emuToTwips, formatPx, halfPointsToPixels, pixelsToEmu, pixelsToTwips, pointsToPixels, twipsToEmu, twipsToPixels } from './utils/units.mjs';
+export { C as CommandHandler, a as CommandResult, b as CorePlugin, J as JsonSchema, L as LoadedDocument, M as McpSession, c as McpToolAnnotations, d as McpToolContent, e as McpToolContext, f as McpToolDefinition, g as McpToolHandler, h as McpToolResult, b as Plugin, P as PluginCommand, C as PluginCommandHandler, i as PluginEvent, j as PluginEventListener, k as PluginOptions, l as PluginRegistrationResult, f as ToolDefinition, g as ToolHandler, h as ToolResult, Z as ZodSchemaLike, m as isZodSchema } from './types-dYdjUZMo.mjs';
+export { P as PluginRegistry, c as createPluginRegistrar, p as pluginRegistry, r as registerPlugins } from './registry-Cpyybgij.mjs';
+export { Document, DocxPackage } from './types/document.mjs';
+export { AIAction, AIActionRequest, AgentCommand, AgentContext, AgentResponse, ApplyStyleCommand, ApplyVariablesCommand, DEFAULT_AI_ACTIONS, DeleteTextCommand, FormatParagraphCommand, FormatTextCommand, InsertHyperlinkCommand, InsertImageCommand, InsertTableCommand, InsertTextCommand, ParagraphContext, ParagraphOutline, Position, Range, ReplaceTextCommand, SectionInfo, SelectionContext, SetVariableCommand, StyleInfo, SuggestedAction, comparePositions, createCollapsedRange, createCommand, createRange, getActionDescription, getActionLabel, isPositionInRange } from './types/agentApi.mjs';
+export { BlockContent, Comment, CommentRangeEnd, CommentRangeStart, Deletion, DocumentBody, Endnote, Footnote, Hyperlink, Image, Insertion, MoveFrom, MoveTo, Paragraph, ParagraphContent, Run, RunContent, SectionProperties, Table, TableCell, TableRow, TextContent, TrackedChangeInfo, TrackedRunChange } from './types/content.mjs';
+export { L as ListLevel, N as NumberingDefinitions } from './lists-JDB80qyP.mjs';
+export { P as ParagraphFormatting, T as TextFormatting } from './formatting-D9I-lFS4.mjs';
+export { R as Relationship, S as Style, a as StyleDefinitions, T as Theme } from './styles-BBoqh07F.mjs';
+import './docxInput-DTbCa48g.mjs';
+import 'jszip';
+import './colors-C3vA7HUU.mjs';
+import './docx/wrapTypes.mjs';
+
+/**
+ * @eigenpal/docx-editor-core/headless
+ *
+ * Headless aggregate for Node.js scripts, CLI tools, and server-side
+ * processing. Same surface as the default `.` entry, named to make the
+ * "no DOM" intent explicit. Prefer the smaller subpaths (`./docx`,
+ * `./agent`, `./utils`, etc.) for new code — they tree-shake better.
+ *
+ * @example
+ * ```ts
+ * import { DocumentAgent, parseDocx, pluginRegistry } from '@eigenpal/docx-editor-core/headless';
+ * import { docxtemplaterPlugin } from '@eigenpal/docx-editor-core/core-plugins';
+ *
+ * // Register plugins
+ * pluginRegistry.register(docxtemplaterPlugin);
+ *
+ * // Load and manipulate document
+ * const buffer = fs.readFileSync('template.docx');
+ * const agent = await DocumentAgent.fromBuffer(buffer);
+ *
+ * // Get document info
+ * console.log('Word count:', agent.getWordCount());
+ * console.log('Variables:', agent.getVariables());
+ *
+ * // Edit document
+ * const newAgent = agent
+ *   .insertText({ paragraphIndex: 0, offset: 0 }, 'Hello ')
+ *   .applyStyle(0, 'Heading1');
+ *
+ * // Apply template variables
+ * const finalAgent = await newAgent.applyVariables({
+ *   customer_name: 'Jane Doe',
+ *   date: '2024-02-15',
+ * });
+ *
+ * // Export
+ * const output = await finalAgent.toBuffer();
+ * fs.writeFileSync('output.docx', Buffer.from(output));
+ * ```
+ * @packageDocumentation
+ * @public
+ */
+declare const VERSION = "0.0.2";
+
+export { VERSION };

package/dist/headless.d.ts

@@ -0,0 +1,110 @@
+/**
+ * @eigenpal/docx-editor-core/headless
+ *
+ * Headless aggregate for Node.js scripts, CLI tools, and server-side
+ * processing. Same surface as the default `.` entry, named to make the
+ * "no DOM" intent explicit. Prefer the smaller subpaths (`./docx`,
+ * `./agent`, `./utils`, etc.) for new code — they tree-shake better.
+ *
+ * @example
+ * ```ts
+ * import { DocumentAgent, parseDocx, pluginRegistry } from '@eigenpal/docx-editor-core/headless';
+ * import { docxtemplaterPlugin } from '@eigenpal/docx-editor-core/core-plugins';
+ *
+ * // Register plugins
+ * pluginRegistry.register(docxtemplaterPlugin);
+ *
+ * // Load and manipulate document
+ * const buffer = fs.readFileSync('template.docx');
+ * const agent = await DocumentAgent.fromBuffer(buffer);
+ *
+ * // Get document info
+ * console.log('Word count:', agent.getWordCount());
+ * console.log('Variables:', agent.getVariables());
+ *
+ * // Edit document
+ * const newAgent = agent
+ *   .insertText({ paragraphIndex: 0, offset: 0 }, 'Hello ')
+ *   .applyStyle(0, 'Heading1');
+ *
+ * // Apply template variables
+ * const finalAgent = await newAgent.applyVariables({
+ *   customer_name: 'Jane Doe',
+ *   date: '2024-02-15',
+ * });
+ *
+ * // Export
+ * const output = await finalAgent.toBuffer();
+ * fs.writeFileSync('output.docx', Buffer.from(output));
+ * ```
+ * @packageDocumentation
+ * @public
+ */
+export { A as AgentContextOptions, S as ContextSelectionOptions, D as DocumentAgent, E as ExtendedSelectionContext, F as FormattedTextSegment, a as FormattingSummary, I as InsertHyperlinkOptions, b as InsertImageOptions, c as InsertTableOptions, d as InsertTextOptions, e as SelectionContextOptions, f as buildExtendedSelectionContext, g as buildSelectionContext, h as buildSelectionContextFromContext, i as createAgent, j as createAgentFromDocument, k as executeCommand, l as executeCommands, m as getAgentContext, n as getDocumentSummary, o as getSelectionFormattingSummary } from './selectionContext-85CE0f7a.js';
+export { countCharacters, countWords, getBlockIndexForParagraph, getBodyCharacterCount, getBodyText, getBodyWordCount, getFormattingAtPosition, getHyperlinkAtPosition, getHyperlinkText, getParagraphAtIndex, getParagraphText, getParagraphs, getRunText, getTableText, getTextAfter, getTextBefore, hasHyperlinks, hasImages, hasTables, isHeadingStyle, isPositionInHyperlink, parseHeadingLevel } from './agent/index.js';
+export { parseDocx } from './docx/parser.js';
+export { s as serializeDocumentBody, a as serializeDocx, b as serializeSectionProperties } from './documentSerializer-Chn7J1WG.js';
+export { createDocx, default as repackDocx, updateMultipleFiles } from './docx/rezip.js';
+export { a as attemptSelectiveSave } from './selectiveSave-CWaPEv0B.js';
+export { b as buildPatchedDocumentXml, v as validatePatchSafety } from './selectiveXmlPatch-ypkxlTD_.js';
+export { C as CreateEmptyDocumentOptions, P as ProcessTemplateOptions, a as ProcessTemplateResult, T as TemplateError, b as blendColors, c as colorsEqual, d as createDocumentWithText, e as createEmptyDocument, f as createRgbColor, g as createTemplateProcessor, h as createThemeColor, i as darkenColor, j as getContrastingColor, k as getMissingVariables, l as getTemplateTags, m as isBlack, n as isWhite, o as lightenColor, p as parseColorString, q as previewTemplate, r as processTemplate, s as processTemplateAdvanced, t as processTemplateAsBlob, u as processTemplateDetailed, v as resolveColor, w as resolveHighlightColor, x as resolveShadingColor, y as validateTemplate } from './colorResolver-CVsPLsw1.js';
+export { V as VariableDetectionResult, a as VariableOccurrence, d as detectVariables, b as detectVariablesDetailed, c as detectVariablesInBody, e as detectVariablesInParagraph, f as documentHasVariables, g as extractVariablesFromText, h as formatVariable, i as hasTemplateVariables, j as isValidVariableName, p as parseVariable, r as removeVariables, k as replaceVariables, s as sanitizeVariableName } from './variableDetector-W4XEN9YC.js';
+export { emuToPixels, emuToTwips, formatPx, halfPointsToPixels, pixelsToEmu, pixelsToTwips, pointsToPixels, twipsToEmu, twipsToPixels } from './utils/units.js';
+export { C as CommandHandler, a as CommandResult, b as CorePlugin, J as JsonSchema, L as LoadedDocument, M as McpSession, c as McpToolAnnotations, d as McpToolContent, e as McpToolContext, f as McpToolDefinition, g as McpToolHandler, h as McpToolResult, b as Plugin, P as PluginCommand, C as PluginCommandHandler, i as PluginEvent, j as PluginEventListener, k as PluginOptions, l as PluginRegistrationResult, f as ToolDefinition, g as ToolHandler, h as ToolResult, Z as ZodSchemaLike, m as isZodSchema } from './types-DXG7vqe9.js';
+export { P as PluginRegistry, c as createPluginRegistrar, p as pluginRegistry, r as registerPlugins } from './registry-E5pahPKL.js';
+export { Document, DocxPackage } from './types/document.js';
+export { AIAction, AIActionRequest, AgentCommand, AgentContext, AgentResponse, ApplyStyleCommand, ApplyVariablesCommand, DEFAULT_AI_ACTIONS, DeleteTextCommand, FormatParagraphCommand, FormatTextCommand, InsertHyperlinkCommand, InsertImageCommand, InsertTableCommand, InsertTextCommand, ParagraphContext, ParagraphOutline, Position, Range, ReplaceTextCommand, SectionInfo, SelectionContext, SetVariableCommand, StyleInfo, SuggestedAction, comparePositions, createCollapsedRange, createCommand, createRange, getActionDescription, getActionLabel, isPositionInRange } from './types/agentApi.js';
+export { BlockContent, Comment, CommentRangeEnd, CommentRangeStart, Deletion, DocumentBody, Endnote, Footnote, Hyperlink, Image, Insertion, MoveFrom, MoveTo, Paragraph, ParagraphContent, Run, RunContent, SectionProperties, Table, TableCell, TableRow, TextContent, TrackedChangeInfo, TrackedRunChange } from './types/content.js';
+export { L as ListLevel, N as NumberingDefinitions } from './lists-CdiIk_c1.js';
+export { P as ParagraphFormatting, T as TextFormatting } from './formatting-BwpZWdGi.js';
+export { R as Relationship, S as Style, a as StyleDefinitions, T as Theme } from './styles-jqO45PSq.js';
+import './docxInput-DTbCa48g.js';
+import 'jszip';
+import './colors-C3vA7HUU.js';
+import './docx/wrapTypes.js';
+
+/**
+ * @eigenpal/docx-editor-core/headless
+ *
+ * Headless aggregate for Node.js scripts, CLI tools, and server-side
+ * processing. Same surface as the default `.` entry, named to make the
+ * "no DOM" intent explicit. Prefer the smaller subpaths (`./docx`,
+ * `./agent`, `./utils`, etc.) for new code — they tree-shake better.
+ *
+ * @example
+ * ```ts
+ * import { DocumentAgent, parseDocx, pluginRegistry } from '@eigenpal/docx-editor-core/headless';
+ * import { docxtemplaterPlugin } from '@eigenpal/docx-editor-core/core-plugins';
+ *
+ * // Register plugins
+ * pluginRegistry.register(docxtemplaterPlugin);
+ *
+ * // Load and manipulate document
+ * const buffer = fs.readFileSync('template.docx');
+ * const agent = await DocumentAgent.fromBuffer(buffer);
+ *
+ * // Get document info
+ * console.log('Word count:', agent.getWordCount());
+ * console.log('Variables:', agent.getVariables());
+ *
+ * // Edit document
+ * const newAgent = agent
+ *   .insertText({ paragraphIndex: 0, offset: 0 }, 'Hello ')
+ *   .applyStyle(0, 'Heading1');
+ *
+ * // Apply template variables
+ * const finalAgent = await newAgent.applyVariables({
+ *   customer_name: 'Jane Doe',
+ *   date: '2024-02-15',
+ * });
+ *
+ * // Export
+ * const output = await finalAgent.toBuffer();
+ * fs.writeFileSync('output.docx', Buffer.from(output));
+ * ```
+ * @packageDocumentation
+ * @public
+ */
+declare const VERSION = "0.0.2";
+
+export { VERSION };

package/dist/headless.js

@@ -0,0 +1 @@
+'use strict';var chunkOCAX2KJQ_js=require('./chunk-OCAX2KJQ.js'),chunkXXU7YQVV_js=require('./chunk-XXU7YQVV.js'),chunkS7IKPRC3_js=require('./chunk-S7IKPRC3.js'),chunkWLQEPVDR_js=require('./chunk-WLQEPVDR.js'),chunkNXLJVVVE_js=require('./chunk-NXLJVVVE.js'),chunkCKXAHSJQ_js=require('./chunk-CKXAHSJQ.js'),chunkU4UCHBZ7_js=require('./chunk-U4UCHBZ7.js'),chunkESI4BSBF_js=require('./chunk-ESI4BSBF.js'),chunkTE2AF7FM_js=require('./chunk-TE2AF7FM.js'),chunkWNTT4MGC_js=require('./chunk-WNTT4MGC.js'),chunkCCWOLPZE_js=require('./chunk-CCWOLPZE.js'),chunk4BFNWPKW_js=require('./chunk-4BFNWPKW.js'),chunk6ILFFGGS_js=require('./chunk-6ILFFGGS.js');require('./chunk-CWAP26GB.js'),require('./chunk-KBU6QQFU.js'),require('./chunk-MZOVDLYL.js'),require('./chunk-YGHHSCPR.js'),require('./chunk-7VCMJCBY.js');var chunkMJ5FQX7Q_js=require('./chunk-MJ5FQX7Q.js');require('./chunk-T4CPTPRP.js'),require('./chunk-Q4CKLXWA.js');var chunk4Q2IP5FW_js=require('./chunk-4Q2IP5FW.js');require('./chunk-DC7S76ZX.js');var je="0.0.2";Object.defineProperty(exports,"countCharacters",{enumerable:true,get:function(){return chunkOCAX2KJQ_js.g}});Object.defineProperty(exports,"countWords",{enumerable:true,get:function(){return chunkOCAX2KJQ_js.f}});Object.defineProperty(exports,"getBlockIndexForParagraph",{enumerable:true,get:function(){return chunkOCAX2KJQ_js.v}});Object.defineProperty(exports,"getBodyCharacterCount",{enumerable:true,get:function(){return chunkOCAX2KJQ_js.i}});Object.defineProperty(exports,"getBodyText",{enumerable:true,get:function(){return chunkOCAX2KJQ_js.e}});Object.defineProperty(exports,"getBodyWordCount",{enumerable:true,get:function(){return chunkOCAX2KJQ_js.h}});Object.defineProperty(exports,"getFormattingAtPosition",{enumerable:true,get:function(){return chunkOCAX2KJQ_js.l}});Object.defineProperty(exports,"getHyperlinkAtPosition",{enumerable:true,get:function(){return chunkOCAX2KJQ_js.n}});Object.defineProperty(exports,"getHyperlinkText",{enumerable:true,get:function(){return chunkOCAX2KJQ_js.c}});Object.defineProperty(exports,"getParagraphAtIndex",{enumerable:true,get:function(){return chunkOCAX2KJQ_js.u}});Object.defineProperty(exports,"getParagraphText",{enumerable:true,get:function(){return chunkOCAX2KJQ_js.a}});Object.defineProperty(exports,"getParagraphs",{enumerable:true,get:function(){return chunkOCAX2KJQ_js.t}});Object.defineProperty(exports,"getRunText",{enumerable:true,get:function(){return chunkOCAX2KJQ_js.b}});Object.defineProperty(exports,"getTableText",{enumerable:true,get:function(){return chunkOCAX2KJQ_js.d}});Object.defineProperty(exports,"getTextAfter",{enumerable:true,get:function(){return chunkOCAX2KJQ_js.k}});Object.defineProperty(exports,"getTextBefore",{enumerable:true,get:function(){return chunkOCAX2KJQ_js.j}});Object.defineProperty(exports,"hasHyperlinks",{enumerable:true,get:function(){return chunkOCAX2KJQ_js.r}});Object.defineProperty(exports,"hasImages",{enumerable:true,get:function(){return chunkOCAX2KJQ_js.q}});Object.defineProperty(exports,"hasTables",{enumerable:true,get:function(){return chunkOCAX2KJQ_js.s}});Object.defineProperty(exports,"isHeadingStyle",{enumerable:true,get:function(){return chunkOCAX2KJQ_js.o}});Object.defineProperty(exports,"isPositionInHyperlink",{enumerable:true,get:function(){return chunkOCAX2KJQ_js.m}});Object.defineProperty(exports,"parseHeadingLevel",{enumerable:true,get:function(){return chunkOCAX2KJQ_js.p}});Object.defineProperty(exports,"DEFAULT_AI_ACTIONS",{enumerable:true,get:function(){return chunkXXU7YQVV_js.g}});Object.defineProperty(exports,"comparePositions",{enumerable:true,get:function(){return chunkXXU7YQVV_js.d}});Object.defineProperty(exports,"createCollapsedRange",{enumerable:true,get:function(){return chunkXXU7YQVV_js.a}});Object.defineProperty(exports,"createCommand",{enumerable:true,get:function(){return chunkXXU7YQVV_js.h}});Object.defineProperty(exports,"createRange",{enumerable:true,get:function(){return chunkXXU7YQVV_js.b}});Object.defineProperty(exports,"getActionDescription",{enumerable:true,get:function(){return chunkXXU7YQVV_js.f}});Object.defineProperty(exports,"getActionLabel",{enumerable:true,get:function(){return chunkXXU7YQVV_js.e}});Object.defineProperty(exports,"isPositionInRange",{enumerable:true,get:function(){return chunkXXU7YQVV_js.c}});Object.defineProperty(exports,"DocumentAgent",{enumerable:true,get:function(){return chunkS7IKPRC3_js.a}});Object.defineProperty(exports,"buildExtendedSelectionContext",{enumerable:true,get:function(){return chunkS7IKPRC3_js.h}});Object.defineProperty(exports,"buildSelectionContext",{enumerable:true,get:function(){return chunkS7IKPRC3_js.g}});Object.defineProperty(exports,"buildSelectionContextFromContext",{enumerable:true,get:function(){return chunkS7IKPRC3_js.e}});Object.defineProperty(exports,"createAgent",{enumerable:true,get:function(){return chunkS7IKPRC3_js.b}});Object.defineProperty(exports,"createAgentFromDocument",{enumerable:true,get:function(){return chunkS7IKPRC3_js.c}});Object.defineProperty(exports,"getAgentContext",{enumerable:true,get:function(){return chunkS7IKPRC3_js.d}});Object.defineProperty(exports,"getDocumentSummary",{enumerable:true,get:function(){return chunkS7IKPRC3_js.f}});Object.defineProperty(exports,"getSelectionFormattingSummary",{enumerable:true,get:function(){return chunkS7IKPRC3_js.i}});Object.defineProperty(exports,"attemptSelectiveSave",{enumerable:true,get:function(){return chunkWLQEPVDR_js.c}});Object.defineProperty(exports,"buildPatchedDocumentXml",{enumerable:true,get:function(){return chunkWLQEPVDR_js.b}});Object.defineProperty(exports,"validatePatchSafety",{enumerable:true,get:function(){return chunkWLQEPVDR_js.a}});Object.defineProperty(exports,"createDocumentWithText",{enumerable:true,get:function(){return chunkNXLJVVVE_js.b}});Object.defineProperty(exports,"createEmptyDocument",{enumerable:true,get:function(){return chunkNXLJVVVE_js.a}});Object.defineProperty(exports,"isZodSchema",{enumerable:true,get:function(){return chunkCKXAHSJQ_js.a}});Object.defineProperty(exports,"detectVariables",{enumerable:true,get:function(){return chunkU4UCHBZ7_js.a}});Object.defineProperty(exports,"detectVariablesDetailed",{enumerable:true,get:function(){return chunkU4UCHBZ7_js.b}});Object.defineProperty(exports,"detectVariablesInBody",{enumerable:true,get:function(){return chunkU4UCHBZ7_js.c}});Object.defineProperty(exports,"detectVariablesInParagraph",{enumerable:true,get:function(){return chunkU4UCHBZ7_js.d}});Object.defineProperty(exports,"documentHasVariables",{enumerable:true,get:function(){return chunkU4UCHBZ7_js.m}});Object.defineProperty(exports,"extractVariablesFromText",{enumerable:true,get:function(){return chunkU4UCHBZ7_js.e}});Object.defineProperty(exports,"formatVariable",{enumerable:true,get:function(){return chunkU4UCHBZ7_js.i}});Object.defineProperty(exports,"hasTemplateVariables",{enumerable:true,get:function(){return chunkU4UCHBZ7_js.f}});Object.defineProperty(exports,"isValidVariableName",{enumerable:true,get:function(){return chunkU4UCHBZ7_js.g}});Object.defineProperty(exports,"parseVariable",{enumerable:true,get:function(){return chunkU4UCHBZ7_js.j}});Object.defineProperty(exports,"removeVariables",{enumerable:true,get:function(){return chunkU4UCHBZ7_js.l}});Object.defineProperty(exports,"replaceVariables",{enumerable:true,get:function(){return chunkU4UCHBZ7_js.k}});Object.defineProperty(exports,"sanitizeVariableName",{enumerable:true,get:function(){return chunkU4UCHBZ7_js.h}});Object.defineProperty(exports,"createTemplateProcessor",{enumerable:true,get:function(){return chunkESI4BSBF_js.j}});Object.defineProperty(exports,"getMissingVariables",{enumerable:true,get:function(){return chunkESI4BSBF_js.g}});Object.defineProperty(exports,"getTemplateTags",{enumerable:true,get:function(){return chunkESI4BSBF_js.e}});Object.defineProperty(exports,"previewTemplate",{enumerable:true,get:function(){return chunkESI4BSBF_js.h}});Object.defineProperty(exports,"processTemplate",{enumerable:true,get:function(){return chunkESI4BSBF_js.a}});Object.defineProperty(exports,"processTemplateAdvanced",{enumerable:true,get:function(){return chunkESI4BSBF_js.i}});Object.defineProperty(exports,"processTemplateAsBlob",{enumerable:true,get:function(){return chunkESI4BSBF_js.c}});Object.defineProperty(exports,"processTemplateDetailed",{enumerable:true,get:function(){return chunkESI4BSBF_js.b}});Object.defineProperty(exports,"validateTemplate",{enumerable:true,get:function(){return chunkESI4BSBF_js.f}});Object.defineProperty(exports,"executeCommand",{enumerable:true,get:function(){return chunkTE2AF7FM_js.a}});Object.defineProperty(exports,"executeCommands",{enumerable:true,get:function(){return chunkTE2AF7FM_js.b}});Object.defineProperty(exports,"createDocx",{enumerable:true,get:function(){return chunkWNTT4MGC_js.s}});Object.defineProperty(exports,"repackDocx",{enumerable:true,get:function(){return chunkWNTT4MGC_js.h}});Object.defineProperty(exports,"updateMultipleFiles",{enumerable:true,get:function(){return chunkWNTT4MGC_js.l}});Object.defineProperty(exports,"serializeDocumentBody",{enumerable:true,get:function(){return chunkCCWOLPZE_js.f}});Object.defineProperty(exports,"serializeDocx",{enumerable:true,get:function(){return chunkCCWOLPZE_js.g}});Object.defineProperty(exports,"serializeSectionProperties",{enumerable:true,get:function(){return chunkCCWOLPZE_js.e}});Object.defineProperty(exports,"PluginRegistry",{enumerable:true,get:function(){return chunk4BFNWPKW_js.a}});Object.defineProperty(exports,"createPluginRegistrar",{enumerable:true,get:function(){return chunk4BFNWPKW_js.d}});Object.defineProperty(exports,"pluginRegistry",{enumerable:true,get:function(){return chunk4BFNWPKW_js.b}});Object.defineProperty(exports,"registerPlugins",{enumerable:true,get:function(){return chunk4BFNWPKW_js.c}});Object.defineProperty(exports,"parseDocx",{enumerable:true,get:function(){return chunk6ILFFGGS_js.f}});Object.defineProperty(exports,"blendColors",{enumerable:true,get:function(){return chunkMJ5FQX7Q_js.m}});Object.defineProperty(exports,"colorsEqual",{enumerable:true,get:function(){return chunkMJ5FQX7Q_js.r}});Object.defineProperty(exports,"createRgbColor",{enumerable:true,get:function(){return chunkMJ5FQX7Q_js.j}});Object.defineProperty(exports,"createThemeColor",{enumerable:true,get:function(){return chunkMJ5FQX7Q_js.i}});Object.defineProperty(exports,"darkenColor",{enumerable:true,get:function(){return chunkMJ5FQX7Q_js.k}});Object.defineProperty(exports,"getContrastingColor",{enumerable:true,get:function(){return chunkMJ5FQX7Q_js.g}});Object.defineProperty(exports,"isBlack",{enumerable:true,get:function(){return chunkMJ5FQX7Q_js.e}});Object.defineProperty(exports,"isWhite",{enumerable:true,get:function(){return chunkMJ5FQX7Q_js.f}});Object.defineProperty(exports,"lightenColor",{enumerable:true,get:function(){return chunkMJ5FQX7Q_js.l}});Object.defineProperty(exports,"parseColorString",{enumerable:true,get:function(){return chunkMJ5FQX7Q_js.h}});Object.defineProperty(exports,"resolveColor",{enumerable:true,get:function(){return chunkMJ5FQX7Q_js.a}});Object.defineProperty(exports,"resolveHighlightColor",{enumerable:true,get:function(){return chunkMJ5FQX7Q_js.c}});Object.defineProperty(exports,"resolveShadingColor",{enumerable:true,get:function(){return chunkMJ5FQX7Q_js.d}});Object.defineProperty(exports,"emuToPixels",{enumerable:true,get:function(){return chunk4Q2IP5FW_js.e}});Object.defineProperty(exports,"emuToTwips",{enumerable:true,get:function(){return chunk4Q2IP5FW_js.g}});Object.defineProperty(exports,"formatPx",{enumerable:true,get:function(){return chunk4Q2IP5FW_js.p}});Object.defineProperty(exports,"halfPointsToPixels",{enumerable:true,get:function(){return chunk4Q2IP5FW_js.j}});Object.defineProperty(exports,"pixelsToEmu",{enumerable:true,get:function(){return chunk4Q2IP5FW_js.f}});Object.defineProperty(exports,"pixelsToTwips",{enumerable:true,get:function(){return chunk4Q2IP5FW_js.d}});Object.defineProperty(exports,"pointsToPixels",{enumerable:true,get:function(){return chunk4Q2IP5FW_js.i}});Object.defineProperty(exports,"twipsToEmu",{enumerable:true,get:function(){return chunk4Q2IP5FW_js.h}});Object.defineProperty(exports,"twipsToPixels",{enumerable:true,get:function(){return chunk4Q2IP5FW_js.c}});exports.VERSION=je;

package/dist/headless.mjs

@@ -0,0 +1 @@
+export{g as countCharacters,f as countWords,v as getBlockIndexForParagraph,i as getBodyCharacterCount,e as getBodyText,h as getBodyWordCount,l as getFormattingAtPosition,n as getHyperlinkAtPosition,c as getHyperlinkText,u as getParagraphAtIndex,a as getParagraphText,t as getParagraphs,b as getRunText,d as getTableText,k as getTextAfter,j as getTextBefore,r as hasHyperlinks,q as hasImages,s as hasTables,o as isHeadingStyle,m as isPositionInHyperlink,p as parseHeadingLevel}from'./chunk-FWTP7BN7.mjs';export{g as DEFAULT_AI_ACTIONS,d as comparePositions,a as createCollapsedRange,h as createCommand,b as createRange,f as getActionDescription,e as getActionLabel,c as isPositionInRange}from'./chunk-MVZOTKNL.mjs';export{a as DocumentAgent,h as buildExtendedSelectionContext,g as buildSelectionContext,e as buildSelectionContextFromContext,b as createAgent,c as createAgentFromDocument,d as getAgentContext,f as getDocumentSummary,i as getSelectionFormattingSummary}from'./chunk-36VIYQHD.mjs';export{c as attemptSelectiveSave,b as buildPatchedDocumentXml,a as validatePatchSafety}from'./chunk-O5X22KZ6.mjs';export{b as createDocumentWithText,a as createEmptyDocument}from'./chunk-CKKO4JWE.mjs';export{a as isZodSchema}from'./chunk-J7ULKGU2.mjs';export{a as detectVariables,b as detectVariablesDetailed,c as detectVariablesInBody,d as detectVariablesInParagraph,m as documentHasVariables,e as extractVariablesFromText,i as formatVariable,f as hasTemplateVariables,g as isValidVariableName,j as parseVariable,l as removeVariables,k as replaceVariables,h as sanitizeVariableName}from'./chunk-ARHPXIBJ.mjs';export{j as createTemplateProcessor,g as getMissingVariables,e as getTemplateTags,h as previewTemplate,a as processTemplate,i as processTemplateAdvanced,c as processTemplateAsBlob,b as processTemplateDetailed,f as validateTemplate}from'./chunk-CGJ6S3AH.mjs';export{a as executeCommand,b as executeCommands}from'./chunk-CUY2THAO.mjs';export{s as createDocx,h as repackDocx,l as updateMultipleFiles}from'./chunk-4EHBV73E.mjs';export{f as serializeDocumentBody,g as serializeDocx,e as serializeSectionProperties}from'./chunk-ZYESB4KC.mjs';export{a as PluginRegistry,d as createPluginRegistrar,b as pluginRegistry,c as registerPlugins}from'./chunk-3NRMSZX2.mjs';export{f as parseDocx}from'./chunk-VKTCTMIO.mjs';import'./chunk-BWHUD2XC.mjs';import'./chunk-Y5HZAMND.mjs';import'./chunk-ILJUDEZ5.mjs';import'./chunk-IBNUQL57.mjs';import'./chunk-6LOYA7G5.mjs';export{m as blendColors,r as colorsEqual,j as createRgbColor,i as createThemeColor,k as darkenColor,g as getContrastingColor,e as isBlack,f as isWhite,l as lightenColor,h as parseColorString,a as resolveColor,c as resolveHighlightColor,d as resolveShadingColor}from'./chunk-67LVRQIR.mjs';import'./chunk-6VUYFDHY.mjs';import'./chunk-VQWZHPWI.mjs';export{e as emuToPixels,g as emuToTwips,p as formatPx,j as halfPointsToPixels,f as pixelsToEmu,d as pixelsToTwips,i as pointsToPixels,h as twipsToEmu,c as twipsToPixels}from'./chunk-VW22RZ6C.mjs';import'./chunk-QYUPLKLP.mjs';var je="0.0.2";export{je as VERSION};

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

@@ -0,0 +1,56 @@
+/**
+ * DOM-based Click-to-Position Mapping
+ *
+ * Uses the browser's actual rendered DOM to find ProseMirror positions.
+ * This is more accurate than geometry-based calculation because it uses
+ * the browser's own text rendering with document.elementsFromPoint().
+ *
+ * DOM elements are tagged with data-pm-start and data-pm-end attributes,
+ * enabling binary search to find exact character positions.
+ * @packageDocumentation
+ * @public
+ */
+/**
+ * Find ProseMirror position from a click using DOM-based detection.
+ *
+ * @param container - The pages container element
+ * @param clientX - Client X coordinate from mouse event
+ * @param clientY - Client Y coordinate from mouse event
+ * @param zoom - Current zoom level (default 1)
+ * @returns ProseMirror position, or null if not found
+ */
+declare function clickToPositionDom(container: HTMLElement, clientX: number, clientY: number, zoom?: number): number | null;
+/**
+ * Get selection rectangles for a PM range using DOM-based detection.
+ *
+ * @param container - The pages container element
+ * @param from - Start PM position
+ * @param to - End PM position
+ * @param overlayRect - Bounding rect of the selection overlay
+ * @returns Array of selection rectangles in overlay coordinates
+ */
+interface DomSelectionRect {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    pageIndex: number;
+}
+declare function getSelectionRectsFromDom(container: HTMLElement, from: number, to: number, overlayRect: DOMRect): DomSelectionRect[];
+/**
+ * Get caret position from DOM for a PM position.
+ *
+ * @param container - The pages container element
+ * @param pmPos - ProseMirror position
+ * @param overlayRect - Bounding rect of the selection overlay
+ * @returns Caret position in overlay coordinates, or null
+ */
+interface DomCaretPosition {
+    x: number;
+    y: number;
+    height: number;
+    pageIndex: number;
+}
+declare function getCaretPositionFromDom(container: HTMLElement, pmPos: number, overlayRect: DOMRect): DomCaretPosition | null;
+
+export { type DomCaretPosition, type DomSelectionRect, clickToPositionDom, getCaretPositionFromDom, getSelectionRectsFromDom };

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

@@ -0,0 +1,56 @@
+/**
+ * DOM-based Click-to-Position Mapping
+ *
+ * Uses the browser's actual rendered DOM to find ProseMirror positions.
+ * This is more accurate than geometry-based calculation because it uses
+ * the browser's own text rendering with document.elementsFromPoint().
+ *
+ * DOM elements are tagged with data-pm-start and data-pm-end attributes,
+ * enabling binary search to find exact character positions.
+ * @packageDocumentation
+ * @public
+ */
+/**
+ * Find ProseMirror position from a click using DOM-based detection.
+ *
+ * @param container - The pages container element
+ * @param clientX - Client X coordinate from mouse event
+ * @param clientY - Client Y coordinate from mouse event
+ * @param zoom - Current zoom level (default 1)
+ * @returns ProseMirror position, or null if not found
+ */
+declare function clickToPositionDom(container: HTMLElement, clientX: number, clientY: number, zoom?: number): number | null;
+/**
+ * Get selection rectangles for a PM range using DOM-based detection.
+ *
+ * @param container - The pages container element
+ * @param from - Start PM position
+ * @param to - End PM position
+ * @param overlayRect - Bounding rect of the selection overlay
+ * @returns Array of selection rectangles in overlay coordinates
+ */
+interface DomSelectionRect {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    pageIndex: number;
+}
+declare function getSelectionRectsFromDom(container: HTMLElement, from: number, to: number, overlayRect: DOMRect): DomSelectionRect[];
+/**
+ * Get caret position from DOM for a PM position.
+ *
+ * @param container - The pages container element
+ * @param pmPos - ProseMirror position
+ * @param overlayRect - Bounding rect of the selection overlay
+ * @returns Caret position in overlay coordinates, or null
+ */
+interface DomCaretPosition {
+    x: number;
+    y: number;
+    height: number;
+    pageIndex: number;
+}
+declare function getCaretPositionFromDom(container: HTMLElement, pmPos: number, overlayRect: DOMRect): DomCaretPosition | null;
+
+export { type DomCaretPosition, type DomSelectionRect, clickToPositionDom, getCaretPositionFromDom, getSelectionRectsFromDom };

package/dist/layout-bridge/clickToPositionDom.js

@@ -0,0 +1 @@
+'use strict';var chunk7RDCZLTU_js=require('../chunk-7RDCZLTU.js');require('../chunk-DC7S76ZX.js');Object.defineProperty(exports,"clickToPositionDom",{enumerable:true,get:function(){return chunk7RDCZLTU_js.e}});Object.defineProperty(exports,"getCaretPositionFromDom",{enumerable:true,get:function(){return chunk7RDCZLTU_js.g}});Object.defineProperty(exports,"getSelectionRectsFromDom",{enumerable:true,get:function(){return chunk7RDCZLTU_js.f}});

package/dist/layout-bridge/clickToPositionDom.mjs

@@ -0,0 +1 @@
+export{e as clickToPositionDom,g as getCaretPositionFromDom,f as getSelectionRectsFromDom}from'../chunk-YMZ3F2FZ.mjs';import'../chunk-QYUPLKLP.mjs';