@zeke-02/docx-editor-core 0.1.0

package/dist/findParagraphByParaId-Maw_8M5D.d.mts

@@ -0,0 +1,28 @@
+import { Node } from 'prosemirror-model';
+
+/**
+ * ProseMirror position immediately before the first textblock whose `paraId`
+ * attribute equals `paraId` (Word `w14:paraId` / OOXML paragraph id).
+ *
+ * Match is strict string equality on `node.attrs.paraId`.
+ */
+declare function findStartPosForParaId(doc: Node, paraId: string): number | null;
+
+/**
+ * ProseMirror position range for the paragraph (or any textblock) whose
+ * `paraId` attribute equals `paraId`. Returns the inclusive `from` and
+ * exclusive `to` positions, plus the node, so callers can both target
+ * the paragraph (e.g. addMark over its text range) and inspect it.
+ *
+ * `from` is the position immediately before the textblock; `to` is
+ * `from + node.nodeSize`. The text content lives at `[from + 1, to - 1]`.
+ *
+ * Returns null if no textblock with that paraId exists.
+ */
+declare function findParagraphByParaId(doc: Node, paraId: string): {
+    node: Node;
+    from: number;
+    to: number;
+} | null;
+
+export { findStartPosForParaId as a, findParagraphByParaId as f };

package/dist/findParagraphByParaId-Maw_8M5D.d.ts

@@ -0,0 +1,28 @@
+import { Node } from 'prosemirror-model';
+
+/**
+ * ProseMirror position immediately before the first textblock whose `paraId`
+ * attribute equals `paraId` (Word `w14:paraId` / OOXML paragraph id).
+ *
+ * Match is strict string equality on `node.attrs.paraId`.
+ */
+declare function findStartPosForParaId(doc: Node, paraId: string): number | null;
+
+/**
+ * ProseMirror position range for the paragraph (or any textblock) whose
+ * `paraId` attribute equals `paraId`. Returns the inclusive `from` and
+ * exclusive `to` positions, plus the node, so callers can both target
+ * the paragraph (e.g. addMark over its text range) and inspect it.
+ *
+ * `from` is the position immediately before the textblock; `to` is
+ * `from + node.nodeSize`. The text content lives at `[from + 1, to - 1]`.
+ *
+ * Returns null if no textblock with that paraId exists.
+ */
+declare function findParagraphByParaId(doc: Node, paraId: string): {
+    node: Node;
+    from: number;
+    to: number;
+} | null;
+
+export { findStartPosForParaId as a, findParagraphByParaId as f };

package/dist/fontLoader-8b4X-AIh.d.mts

@@ -0,0 +1,283 @@
+import { Document } from './types/document.mjs';
+import { t as BreakContent, P as Paragraph, R as Run, g as RunContent } from './content-5Mrz6w_b.mjs';
+
+/**
+ * Insert Operations Utility
+ *
+ * Utility functions for inserting content into the document.
+ * Provides functions for inserting page breaks, horizontal rules, and other elements.
+ */
+
+/**
+ * Insert position in the document
+ */
+interface InsertPosition {
+    /** Paragraph index in the document body */
+    paragraphIndex: number;
+    /** Run index within the paragraph (optional) */
+    runIndex?: number;
+    /** Character offset within the run (optional) */
+    offset?: number;
+}
+/**
+ * Create a page break content element
+ */
+declare function createPageBreak(): BreakContent;
+/**
+ * Create a column break content element
+ */
+declare function createColumnBreak(): BreakContent;
+/**
+ * Create a text wrapping break (line break)
+ */
+declare function createLineBreak(clear?: 'none' | 'left' | 'right' | 'all'): BreakContent;
+/**
+ * Create a run containing a page break
+ */
+declare function createPageBreakRun(): Run;
+/**
+ * Create an empty paragraph with a page break before it
+ */
+declare function createPageBreakParagraph(): Paragraph;
+/**
+ * Insert a page break at a position in the document
+ * This inserts a new paragraph with pageBreakBefore: true
+ */
+declare function insertPageBreak(doc: Document, position: InsertPosition): Document;
+/**
+ * Create a horizontal rule paragraph
+ * Uses a paragraph with bottom border to simulate horizontal rule
+ */
+declare function createHorizontalRule(): Paragraph;
+/**
+ * Insert a horizontal rule at a position in the document
+ */
+declare function insertHorizontalRule(doc: Document, position: InsertPosition): Document;
+/**
+ * Check if content is a page break
+ */
+declare function isPageBreak(content: RunContent): boolean;
+/**
+ * Check if content is a column break
+ */
+declare function isColumnBreak(content: RunContent): boolean;
+/**
+ * Check if content is a line break
+ */
+declare function isLineBreak(content: RunContent): boolean;
+/**
+ * Check if content is any type of break
+ */
+declare function isBreakContent(content: RunContent): content is BreakContent;
+/**
+ * Check if a paragraph has pageBreakBefore
+ */
+declare function hasPageBreakBefore(paragraph: Paragraph): boolean;
+/**
+ * Count page breaks in a document
+ */
+declare function countPageBreaks(doc: Document): number;
+/**
+ * Find all page break positions in a document
+ */
+declare function findPageBreaks(doc: Document): InsertPosition[];
+/**
+ * Remove a page break at a specific position
+ */
+declare function removePageBreak(doc: Document, position: InsertPosition): Document;
+
+/**
+ * Google Fonts Loader
+ *
+ * Dynamically loads fonts from Google Fonts API with:
+ * - Loading state tracking
+ * - Duplicate prevention
+ * - Callback notifications
+ * - Font availability detection
+ */
+/**
+ * Load a font from Google Fonts
+ *
+ * @param fontFamily - The font family name to load
+ * @param options - Optional configuration
+ * @returns Promise resolving to true if font loaded successfully, false otherwise
+ */
+declare function loadFont(fontFamily: string, options?: {
+    weights?: number[];
+    styles?: ('normal' | 'italic')[];
+}): Promise<boolean>;
+/**
+ * Load multiple fonts from Google Fonts
+ *
+ * @param families - Array of font family names to load
+ * @param options - Optional configuration
+ * @returns Promise resolving when all fonts are loaded (or failed)
+ */
+declare function loadFonts(families: string[], options?: {
+    weights?: number[];
+    styles?: ('normal' | 'italic')[];
+}): Promise<void>;
+/**
+ * Check if a font is loaded
+ *
+ * @param fontFamily - The font family name to check
+ * @returns true if the font is loaded, false otherwise
+ */
+declare function isFontLoaded(fontFamily: string): boolean;
+/**
+ * Check if any fonts are currently loading
+ *
+ * @returns true if any fonts are loading, false otherwise
+ */
+declare function isLoading(): boolean;
+/**
+ * Get list of all loaded fonts
+ *
+ * @returns Array of loaded font family names
+ */
+declare function getLoadedFonts(): string[];
+/**
+ * Register a callback to be notified when fonts are loaded
+ *
+ * @param callback - Function to call when fonts are loaded
+ * @returns Cleanup function to remove the callback
+ */
+declare function onFontsLoaded(callback: (fonts: string[]) => void): () => void;
+/**
+ * Register a callback to be notified when a font fails to load.
+ *
+ * Adapters subscribe and forward to their `onError` prop. Returns the unsub.
+ *
+ * @public
+ */
+declare function onFontError(callback: (error: Error) => void): () => void;
+/**
+ * Check if a font is available on the system using canvas measurement
+ *
+ * This uses the technique of comparing text width with the target font
+ * vs a known fallback font. If they differ, the font is available.
+ *
+ * @param fontFamily - The font family name to check
+ * @param fallbackFont - Fallback font to compare against
+ * @returns true if font is available, false otherwise
+ */
+declare function canRenderFont(fontFamily: string, fallbackFont?: string): boolean;
+/**
+ * Load a font from a raw buffer (e.g., embedded in DOCX)
+ *
+ * @param fontFamily - The font family name
+ * @param buffer - Font file buffer (TTF, OTF, WOFF, WOFF2)
+ * @param options - Font options
+ * @returns Promise resolving when font is loaded
+ */
+declare function loadFontFromBuffer(fontFamily: string, buffer: ArrayBuffer, options?: {
+    weight?: number | string;
+}): Promise<boolean>;
+/**
+ * Load a font face from a URL (woff2, woff, ttf, otf).
+ *
+ * Injects an `@font-face` rule pointing at the URL. Multiple weights of the
+ * same family can be registered independently.
+ *
+ * @param fontFamily - CSS font-family name to expose
+ * @param src - URL to the font file
+ * @param options - Optional weight
+ * @returns Promise resolving to true if the face became available
+ *
+ * @public
+ */
+declare function loadFontFromUrl(fontFamily: string, src: string, options?: {
+    weight?: number | string;
+}): Promise<boolean>;
+/**
+ * Declarative description of a single font face to register with the editor.
+ *
+ * Each entry injects one `@font-face` rule pointing at a URL. Multiple
+ * entries can share `family` to register distinct weights as separate faces.
+ *
+ * For Google Fonts, call `loadFont(family)` directly — the `fonts` prop is
+ * for fonts the consumer hosts themselves. For raw bytes already in memory
+ * (DOCX-embedded fonts, user uploads), call `loadFontFromBuffer(family, buf)`.
+ *
+ * @public
+ */
+interface FontDefinition {
+    /**
+     * CSS `font-family` name to expose. Match the family name your documents
+     * reference; the browser uses this to look up glyphs when text is rendered.
+     */
+    family: string;
+    /**
+     * URL to the font file (woff2, woff, ttf, or otf). The loader injects an
+     * `@font-face` rule and lets the browser fetch on demand.
+     */
+    src: string;
+    /**
+     * CSS `font-weight` for this face. Defaults to `'normal'` (≈400). Pass a
+     * number (`400`, `700`) or a CSS keyword (`'bold'`). Required when one
+     * `family` registers multiple weights as separate entries.
+     */
+    weight?: number | string;
+}
+/**
+ * Register a list of custom font faces. Used by the `fonts` prop on
+ * `<DocxEditor>` (React + Vue). Idempotent — safe to call on every render.
+ *
+ * @public
+ */
+declare function loadFontDefinitions(defs: ReadonlyArray<FontDefinition> | undefined): Promise<void>;
+/**
+ * Mapping from common Office/system fonts to Google Fonts equivalents
+ *
+ * Google Fonts doesn't have exact matches for many Microsoft fonts,
+ * but these are close alternatives that work well for document rendering.
+ */
+declare const FONT_MAPPING: Record<string, string>;
+/**
+ * Get the Google Fonts equivalent for a font name
+ *
+ * @param fontName - The original font name from the document
+ * @returns The Google Fonts equivalent, or the original name if no mapping exists
+ */
+declare function getGoogleFontEquivalent(fontName: string): string;
+/**
+ * Load a font, automatically mapping to Google Fonts equivalent if needed.
+ * If the font needs mapping, also creates a CSS alias so the original font
+ * name works in stylesheets.
+ *
+ * @param fontFamily - The font family name (may be an Office font)
+ * @returns Promise resolving to true if font loaded
+ */
+declare function loadFontWithMapping(fontFamily: string): Promise<boolean>;
+/**
+ * Load multiple fonts with automatic mapping to Google Fonts equivalents
+ *
+ * @param families - Array of font family names
+ * @returns Promise resolving when all fonts are loaded
+ */
+declare function loadFontsWithMapping(families: string[]): Promise<void>;
+/**
+ * Preload a list of common document fonts
+ *
+ * This preloads fonts commonly used in DOCX documents that have
+ * Google Fonts equivalents.
+ */
+declare function preloadCommonFonts(): Promise<void>;
+/**
+ * Extract all font families used in a document
+ *
+ * Uses loose typing to handle any document-like structure.
+ *
+ * @param document - The parsed document
+ * @returns Set of unique font family names
+ */
+declare function extractFontsFromDocument(document: unknown): Set<string>;
+/**
+ * Extract fonts from a document and load them from Google Fonts
+ *
+ * @param document - The parsed document
+ * @returns Promise resolving when fonts are loaded
+ */
+declare function loadDocumentFonts(document: unknown): Promise<void>;
+
+export { extractFontsFromDocument as A, getGoogleFontEquivalent as B, loadDocumentFonts as C, loadFontDefinitions as D, loadFontFromUrl as E, FONT_MAPPING as F, loadFontWithMapping as G, loadFontsWithMapping as H, type InsertPosition as I, onFontError as J, countPageBreaks as a, createColumnBreak as b, canRenderFont as c, createHorizontalRule as d, createLineBreak as e, createPageBreak as f, createPageBreakParagraph as g, createPageBreakRun as h, findPageBreaks as i, getLoadedFonts as j, hasPageBreakBefore as k, insertHorizontalRule as l, insertPageBreak as m, isBreakContent as n, isColumnBreak as o, isFontLoaded as p, isLoading as q, isLineBreak as r, isPageBreak as s, loadFont as t, loadFontFromBuffer as u, loadFonts as v, onFontsLoaded as w, preloadCommonFonts as x, removePageBreak as y, type FontDefinition as z };

package/dist/fontLoader-CK2QLq68.d.ts

@@ -0,0 +1,283 @@
+import { Document } from './types/document.js';
+import { t as BreakContent, P as Paragraph, R as Run, g as RunContent } from './content-CmqAwdFL.js';
+
+/**
+ * Insert Operations Utility
+ *
+ * Utility functions for inserting content into the document.
+ * Provides functions for inserting page breaks, horizontal rules, and other elements.
+ */
+
+/**
+ * Insert position in the document
+ */
+interface InsertPosition {
+    /** Paragraph index in the document body */
+    paragraphIndex: number;
+    /** Run index within the paragraph (optional) */
+    runIndex?: number;
+    /** Character offset within the run (optional) */
+    offset?: number;
+}
+/**
+ * Create a page break content element
+ */
+declare function createPageBreak(): BreakContent;
+/**
+ * Create a column break content element
+ */
+declare function createColumnBreak(): BreakContent;
+/**
+ * Create a text wrapping break (line break)
+ */
+declare function createLineBreak(clear?: 'none' | 'left' | 'right' | 'all'): BreakContent;
+/**
+ * Create a run containing a page break
+ */
+declare function createPageBreakRun(): Run;
+/**
+ * Create an empty paragraph with a page break before it
+ */
+declare function createPageBreakParagraph(): Paragraph;
+/**
+ * Insert a page break at a position in the document
+ * This inserts a new paragraph with pageBreakBefore: true
+ */
+declare function insertPageBreak(doc: Document, position: InsertPosition): Document;
+/**
+ * Create a horizontal rule paragraph
+ * Uses a paragraph with bottom border to simulate horizontal rule
+ */
+declare function createHorizontalRule(): Paragraph;
+/**
+ * Insert a horizontal rule at a position in the document
+ */
+declare function insertHorizontalRule(doc: Document, position: InsertPosition): Document;
+/**
+ * Check if content is a page break
+ */
+declare function isPageBreak(content: RunContent): boolean;
+/**
+ * Check if content is a column break
+ */
+declare function isColumnBreak(content: RunContent): boolean;
+/**
+ * Check if content is a line break
+ */
+declare function isLineBreak(content: RunContent): boolean;
+/**
+ * Check if content is any type of break
+ */
+declare function isBreakContent(content: RunContent): content is BreakContent;
+/**
+ * Check if a paragraph has pageBreakBefore
+ */
+declare function hasPageBreakBefore(paragraph: Paragraph): boolean;
+/**
+ * Count page breaks in a document
+ */
+declare function countPageBreaks(doc: Document): number;
+/**
+ * Find all page break positions in a document
+ */
+declare function findPageBreaks(doc: Document): InsertPosition[];
+/**
+ * Remove a page break at a specific position
+ */
+declare function removePageBreak(doc: Document, position: InsertPosition): Document;
+
+/**
+ * Google Fonts Loader
+ *
+ * Dynamically loads fonts from Google Fonts API with:
+ * - Loading state tracking
+ * - Duplicate prevention
+ * - Callback notifications
+ * - Font availability detection
+ */
+/**
+ * Load a font from Google Fonts
+ *
+ * @param fontFamily - The font family name to load
+ * @param options - Optional configuration
+ * @returns Promise resolving to true if font loaded successfully, false otherwise
+ */
+declare function loadFont(fontFamily: string, options?: {
+    weights?: number[];
+    styles?: ('normal' | 'italic')[];
+}): Promise<boolean>;
+/**
+ * Load multiple fonts from Google Fonts
+ *
+ * @param families - Array of font family names to load
+ * @param options - Optional configuration
+ * @returns Promise resolving when all fonts are loaded (or failed)
+ */
+declare function loadFonts(families: string[], options?: {
+    weights?: number[];
+    styles?: ('normal' | 'italic')[];
+}): Promise<void>;
+/**
+ * Check if a font is loaded
+ *
+ * @param fontFamily - The font family name to check
+ * @returns true if the font is loaded, false otherwise
+ */
+declare function isFontLoaded(fontFamily: string): boolean;
+/**
+ * Check if any fonts are currently loading
+ *
+ * @returns true if any fonts are loading, false otherwise
+ */
+declare function isLoading(): boolean;
+/**
+ * Get list of all loaded fonts
+ *
+ * @returns Array of loaded font family names
+ */
+declare function getLoadedFonts(): string[];
+/**
+ * Register a callback to be notified when fonts are loaded
+ *
+ * @param callback - Function to call when fonts are loaded
+ * @returns Cleanup function to remove the callback
+ */
+declare function onFontsLoaded(callback: (fonts: string[]) => void): () => void;
+/**
+ * Register a callback to be notified when a font fails to load.
+ *
+ * Adapters subscribe and forward to their `onError` prop. Returns the unsub.
+ *
+ * @public
+ */
+declare function onFontError(callback: (error: Error) => void): () => void;
+/**
+ * Check if a font is available on the system using canvas measurement
+ *
+ * This uses the technique of comparing text width with the target font
+ * vs a known fallback font. If they differ, the font is available.
+ *
+ * @param fontFamily - The font family name to check
+ * @param fallbackFont - Fallback font to compare against
+ * @returns true if font is available, false otherwise
+ */
+declare function canRenderFont(fontFamily: string, fallbackFont?: string): boolean;
+/**
+ * Load a font from a raw buffer (e.g., embedded in DOCX)
+ *
+ * @param fontFamily - The font family name
+ * @param buffer - Font file buffer (TTF, OTF, WOFF, WOFF2)
+ * @param options - Font options
+ * @returns Promise resolving when font is loaded
+ */
+declare function loadFontFromBuffer(fontFamily: string, buffer: ArrayBuffer, options?: {
+    weight?: number | string;
+}): Promise<boolean>;
+/**
+ * Load a font face from a URL (woff2, woff, ttf, otf).
+ *
+ * Injects an `@font-face` rule pointing at the URL. Multiple weights of the
+ * same family can be registered independently.
+ *
+ * @param fontFamily - CSS font-family name to expose
+ * @param src - URL to the font file
+ * @param options - Optional weight
+ * @returns Promise resolving to true if the face became available
+ *
+ * @public
+ */
+declare function loadFontFromUrl(fontFamily: string, src: string, options?: {
+    weight?: number | string;
+}): Promise<boolean>;
+/**
+ * Declarative description of a single font face to register with the editor.
+ *
+ * Each entry injects one `@font-face` rule pointing at a URL. Multiple
+ * entries can share `family` to register distinct weights as separate faces.
+ *
+ * For Google Fonts, call `loadFont(family)` directly — the `fonts` prop is
+ * for fonts the consumer hosts themselves. For raw bytes already in memory
+ * (DOCX-embedded fonts, user uploads), call `loadFontFromBuffer(family, buf)`.
+ *
+ * @public
+ */
+interface FontDefinition {
+    /**
+     * CSS `font-family` name to expose. Match the family name your documents
+     * reference; the browser uses this to look up glyphs when text is rendered.
+     */
+    family: string;
+    /**
+     * URL to the font file (woff2, woff, ttf, or otf). The loader injects an
+     * `@font-face` rule and lets the browser fetch on demand.
+     */
+    src: string;
+    /**
+     * CSS `font-weight` for this face. Defaults to `'normal'` (≈400). Pass a
+     * number (`400`, `700`) or a CSS keyword (`'bold'`). Required when one
+     * `family` registers multiple weights as separate entries.
+     */
+    weight?: number | string;
+}
+/**
+ * Register a list of custom font faces. Used by the `fonts` prop on
+ * `<DocxEditor>` (React + Vue). Idempotent — safe to call on every render.
+ *
+ * @public
+ */
+declare function loadFontDefinitions(defs: ReadonlyArray<FontDefinition> | undefined): Promise<void>;
+/**
+ * Mapping from common Office/system fonts to Google Fonts equivalents
+ *
+ * Google Fonts doesn't have exact matches for many Microsoft fonts,
+ * but these are close alternatives that work well for document rendering.
+ */
+declare const FONT_MAPPING: Record<string, string>;
+/**
+ * Get the Google Fonts equivalent for a font name
+ *
+ * @param fontName - The original font name from the document
+ * @returns The Google Fonts equivalent, or the original name if no mapping exists
+ */
+declare function getGoogleFontEquivalent(fontName: string): string;
+/**
+ * Load a font, automatically mapping to Google Fonts equivalent if needed.
+ * If the font needs mapping, also creates a CSS alias so the original font
+ * name works in stylesheets.
+ *
+ * @param fontFamily - The font family name (may be an Office font)
+ * @returns Promise resolving to true if font loaded
+ */
+declare function loadFontWithMapping(fontFamily: string): Promise<boolean>;
+/**
+ * Load multiple fonts with automatic mapping to Google Fonts equivalents
+ *
+ * @param families - Array of font family names
+ * @returns Promise resolving when all fonts are loaded
+ */
+declare function loadFontsWithMapping(families: string[]): Promise<void>;
+/**
+ * Preload a list of common document fonts
+ *
+ * This preloads fonts commonly used in DOCX documents that have
+ * Google Fonts equivalents.
+ */
+declare function preloadCommonFonts(): Promise<void>;
+/**
+ * Extract all font families used in a document
+ *
+ * Uses loose typing to handle any document-like structure.
+ *
+ * @param document - The parsed document
+ * @returns Set of unique font family names
+ */
+declare function extractFontsFromDocument(document: unknown): Set<string>;
+/**
+ * Extract fonts from a document and load them from Google Fonts
+ *
+ * @param document - The parsed document
+ * @returns Promise resolving when fonts are loaded
+ */
+declare function loadDocumentFonts(document: unknown): Promise<void>;
+
+export { extractFontsFromDocument as A, getGoogleFontEquivalent as B, loadDocumentFonts as C, loadFontDefinitions as D, loadFontFromUrl as E, FONT_MAPPING as F, loadFontWithMapping as G, loadFontsWithMapping as H, type InsertPosition as I, onFontError as J, countPageBreaks as a, createColumnBreak as b, canRenderFont as c, createHorizontalRule as d, createLineBreak as e, createPageBreak as f, createPageBreakParagraph as g, createPageBreakRun as h, findPageBreaks as i, getLoadedFonts as j, hasPageBreakBefore as k, insertHorizontalRule as l, insertPageBreak as m, isBreakContent as n, isColumnBreak as o, isFontLoaded as p, isLoading as q, isLineBreak as r, isPageBreak as s, loadFont as t, loadFontFromBuffer as u, loadFonts as v, onFontsLoaded as w, preloadCommonFonts as x, removePageBreak as y, type FontDefinition as z };

package/dist/footnotes-lCH_P3N3.d.mts

@@ -0,0 +1,78 @@
+import { FlowBlock, Measure, TableBlock, FootnoteContent } from './layout-engine/types.mjs';
+
+/**
+ * Header / footer rendering for renderPage.
+ *
+ * Owns `renderHeaderFooterContent` — the mini-flow that lays paragraphs and
+ * tables inside a header/footer container (separate from the body flow) —
+ * plus the floating-image and floating-table positioning helpers used by
+ * that flow. Coordinates returned by `resolveHeaderFooterFloatingTablePosition`
+ * are relative to the HF container's flow origin (`layout.flowTop`/`flowLeft`)
+ * so callers can drop them into `style.top`/`style.left`.
+ */
+
+/**
+ * Header/footer content for rendering
+ */
+interface HeaderFooterContent {
+    /** Flow blocks for the header/footer content. */
+    blocks: FlowBlock[];
+    /** Measurements for the blocks. */
+    measures: Measure[];
+    /** Total height of the content. */
+    height: number;
+    /** Top-most visual extent relative to the nominal flow origin. */
+    visualTop?: number;
+    /** Bottom-most visual extent relative to the nominal flow origin. */
+    visualBottom?: number;
+}
+interface HeaderFooterLayoutInfo {
+    flowTop: number;
+    flowLeft: number;
+    contentWidth: number;
+    pageWidth: number;
+    pageHeight: number;
+    margins: {
+        top: number;
+        right: number;
+        bottom: number;
+        left: number;
+    };
+}
+/**
+ * Resolve the (left, top) position for a floating table inside a header/
+ * footer container, per ECMA-376 §17.4.57. The table's `floating.tblpX/tblpY`
+ * are already in pixels (parser converted from twips); `horzAnchor`/
+ * `vertAnchor` decide whether the offset is relative to the page, the
+ * margins, or the surrounding text/column. Coordinates returned are
+ * relative to the HF container's flow origin (`layout.flowTop` /
+ * `layout.flowLeft`) so the caller can drop them straight into
+ * `style.top` / `style.left`.
+ */
+declare function resolveHeaderFooterFloatingTablePosition(floating: NonNullable<TableBlock['floating']>, layout: HeaderFooterLayoutInfo): {
+    left: number;
+    top: number;
+};
+
+/**
+ * Footnote area rendering.
+ *
+ * Footnotes get a separator line plus per-item rendering at the bottom of
+ * each page. Two paths: measured content (full body pipeline through
+ * paragraph/table/image/textBox fragments) for WYSIWYG fidelity, or a plain
+ * text fallback when no measurement is available.
+ */
+
+/**
+ * A single footnote item ready for rendering at page bottom.
+ */
+interface FootnoteRenderItem {
+    /** Display number (e.g. "1", "2") */
+    displayNumber: string;
+    /** Plain text content */
+    text: string;
+    /** Measured body-pipeline content used for WYSIWYG painting. */
+    content?: FootnoteContent;
+}
+
+export { type FootnoteRenderItem as F, type HeaderFooterContent as H, type HeaderFooterLayoutInfo as a, resolveHeaderFooterFloatingTablePosition as r };