@docen/export-docx 0.0.9 → 0.0.10

package/dist/index.d.mts

@@ -1,5 +1,5 @@
 /// <reference types="node" />
-import { OutputType, ISectionOptions, IPropertiesOptions, ITableOfContentsOptions, IParagraphStyleOptions, IImageOptions as IImageOptions$1, ITableOptions, IParagraphOptions, ITableRowOptions, ITableCellOptions, OutputByType, FileChild, TextRun, ExternalHyperlink, PositiveUniversalMeasure as PositiveUniversalMeasure$1, Paragraph, ImageRun, Table, TableRow, TableCell } from 'docx';
+import { PositiveUniversalMeasure as PositiveUniversalMeasure$1, OutputType, ISectionOptions, IPropertiesOptions, ITableOfContentsOptions, IParagraphStyleOptions, IImageOptions as IImageOptions$1, ITableOptions, IParagraphOptions, ITableRowOptions, ITableCellOptions, FileChild, OutputByType, TextRun, ExternalHyperlink, ImageRun, Table, TableRow, TableCell } from 'docx';
 import { ImageMeta } from 'image-meta';
 
 declare class OrderedMap$1<T = any> {
@@ -2029,6 +2029,16 @@ declare class Transform$1 {
     */
     get docChanged(): boolean;
     /**
+    Return a single range, in post-transform document positions,
+    that covers all content changed by this transform. Returns null
+    if no replacements are made. Note that this will ignore changes
+    that add/remove marks without replacing the underlying content.
+    */
+    changedRange(): {
+        from: number;
+        to: number;
+    } | null;
+    /**
     Replace the part of the document between `from` and `to` with the
     given `slice`.
     */
@@ -6567,6 +6577,62 @@ interface Commands$1<ReturnType = any> {
 interface Storage$1 {
 }
 
+type DocxImageExportHandler = (src: string) => Promise<Uint8Array>;
+/**
+ * Convert image MIME type to DOCX type
+ */
+declare function convertToDocxImageType(mimeType?: string): "jpg" | "png" | "gif" | "bmp";
+/**
+ * Extract image type from URL or base64 data
+ */
+declare function getImageTypeFromSrc(src: string): "png" | "jpeg" | "gif" | "bmp" | "tiff";
+/**
+ * Create floating options for full-width images
+ */
+declare function createFloatingOptions(): {
+    horizontalPosition: {
+        relative: string;
+        align: string;
+    };
+    verticalPosition: {
+        relative: string;
+        align: string;
+    };
+    lockAnchor: boolean;
+    behindDocument: boolean;
+    inFrontOfText: boolean;
+};
+/**
+ * Get image width with priority: node attrs > image meta > calculated > default
+ */
+declare function getImageWidth(node: {
+    attrs?: {
+        width?: number | null;
+    };
+}, imageMeta?: {
+    width?: number;
+    height?: number;
+}, maxWidth?: number | PositiveUniversalMeasure$1): number;
+/**
+ * Get image height with priority: node attrs > image meta > calculated > default
+ */
+declare function getImageHeight(node: {
+    attrs?: {
+        height?: number | null;
+    };
+}, width: number, imageMeta?: {
+    width?: number;
+    height?: number;
+}, maxWidth?: number | PositiveUniversalMeasure$1): number;
+/**
+ * Fetch image data and metadata from HTTP/HTTPS URL
+ * (Only for use without custom handler)
+ */
+declare function getImageDataAndMeta(url: string): Promise<{
+    data: Uint8Array;
+    meta: ImageMeta;
+}>;
+
 /**
  * Options for exporting TipTap content to DOCX
  */
@@ -6598,6 +6664,7 @@ interface DocxExportOptions<T extends OutputType = OutputType> {
         run?: Partial<ITableOfContentsOptions>;
     };
     image?: {
+        handler?: DocxImageExportHandler;
         style?: IParagraphStyleOptions;
         run?: Partial<IImageOptions$1>;
     };
@@ -6617,6 +6684,9 @@ interface DocxExportOptions<T extends OutputType = OutputType> {
             run?: Partial<ITableCellOptions>;
         };
     };
+    code?: {
+        style?: IParagraphStyleOptions;
+    };
     details?: {
         summary?: {
             paragraph?: Partial<IParagraphOptions>;
@@ -6647,6 +6717,11 @@ declare function convertDocument(node: JSONContent$1, params: {
 }): Promise<FileChild[]>;
 /**
  * Convert a single node to DOCX element(s)
+ *
+ * This function implements a three-layer architecture:
+ * 1. Data Transformation: Convert node.attrs → IParagraphOptions (pure data)
+ * 2. Style Application: Apply styleId references (if configured)
+ * 3. Object Creation: Create actual DOCX instances (Paragraph, Table, etc.)
  */
 declare function convertNode(node: JSONContent$1, options: DocxExportOptions, effectiveContentWidth: number): Promise<FileChild | FileChild[] | null>;
 
@@ -8677,6 +8752,16 @@ declare class Transform {
     */
     get docChanged(): boolean;
     /**
+    Return a single range, in post-transform document positions,
+    that covers all content changed by this transform. Returns null
+    if no replacements are made. Note that this will ignore changes
+    that add/remove marks without replacing the underlying content.
+    */
+    changedRange(): {
+        from: number;
+        to: number;
+    } | null;
+    /**
     Replace the part of the document between `from` and `to` with the
     given `slice`.
     */
@@ -13613,11 +13698,14 @@ declare function convertHardBreak(marks?: Array<{
 declare function convertTextNodes(nodes?: JSONContent$1[]): Array<TextRun | ExternalHyperlink | undefined>;
 
 /**
- * Convert TipTap paragraph node to DOCX Paragraph
+ * Convert TipTap paragraph node to DOCX paragraph options
+ *
+ * This converter only handles data transformation from node.attrs to DOCX format properties.
+ * It returns pure data objects (IParagraphOptions), not DOCX instances.
  *
  * @param node - TipTap paragraph node
  * @param params - Conversion parameters
- * @returns Promise<DOCX Paragraph object>
+ * @returns Promise<DOCX paragraph options (pure data object)>
  */
 declare function convertParagraph(node: ParagraphNode, params?: {
     options?: IParagraphOptions;
@@ -13625,163 +13713,34 @@ declare function convertParagraph(node: ParagraphNode, params?: {
     image?: {
         /** Maximum available width for inline images (number = pixels, or string like "6in", "152.4mm") */
         maxWidth?: number | PositiveUniversalMeasure$1;
+        /** Additional image options to apply */
+        options?: Partial<IImageOptions$1>;
+        /** Custom image handler for fetching image data */
+        handler?: DocxImageExportHandler;
     };
-}): Promise<Paragraph>;
+}): Promise<IParagraphOptions>;
 
 /**
- * Convert TipTap heading node to DOCX paragraph
+ * Convert TipTap heading node to DOCX paragraph options
  *
- * @param node - TipTap heading node
- * @returns DOCX Paragraph object
- */
-declare function convertHeading(node: HeadingNode): Paragraph;
-
-/**
- * Convert TipTap blockquote node to array of DOCX Paragraphs
- * Each paragraph in blockquote is indented and styled
+ * This converter only handles data transformation from node.attrs to DOCX format properties.
+ * It returns pure data objects (IParagraphOptions), not DOCX instances.
  *
- * @param node - TipTap blockquote node
- * @returns Array of DOCX Paragraph objects
- */
-declare function convertBlockquote(node: BlockquoteNode): Paragraph[];
-
-/**
- * Convert TipTap image node to DOCX ImageRun
- *
- * @param node - TipTap image node
- * @param params - Conversion parameters
- * @returns Promise<DOCX ImageRun>
- */
-declare function convertImage(node: ImageNode, params?: {
-    /** Maximum available width (number = pixels, or string like "6in", "152.4mm") */
-    maxWidth?: number | PositiveUniversalMeasure$1;
-    /** Additional image options to apply */
-    options?: Partial<IImageOptions$1>;
-}): Promise<ImageRun>;
-
-/**
- * Convert TipTap table node to DOCX Table
- *
- * @param node - TipTap table node
- * @param params - Conversion parameters
- * @returns Promise<Table>
- */
-declare function convertTable(node: TableNode, params: {
-    options: DocxExportOptions["table"];
-}): Promise<Table>;
-
-/**
- * Convert TipTap table row node to DOCX TableRow
- *
- * @param node - TipTap table row node
- * @param params - Conversion parameters
- * @returns Promise<DOCX TableRow object>
- */
-declare function convertTableRow(node: TableRowNode, params: {
-    options: DocxExportOptions["table"];
-}): Promise<TableRow>;
-
-/**
- * Convert TipTap table cell node to DOCX TableCell
- *
- * @param node - TipTap table cell node
- * @param params - Conversion parameters
- * @returns Promise<DOCX TableCell object>
- */
-declare function convertTableCell(node: TableCellNode, params: {
-    options: DocxExportOptions["table"];
-}): Promise<TableCell>;
-
-/**
- * Convert TipTap table header node to DOCX TableCell
- *
- * @param node - TipTap table header node
- * @param params - Conversion parameters
- * @returns Promise<DOCX TableCell object for header>
- */
-declare function convertTableHeader(node: TableHeaderNode, params: {
-    options: DocxExportOptions["table"];
-}): Promise<TableCell>;
-
-/**
- * Convert TipTap codeBlock node to DOCX Paragraph
- *
- * @param node - TipTap codeBlock node
- * @returns DOCX Paragraph object with code styling
- */
-declare function convertCodeBlock(node: CodeBlockNode): Paragraph;
-
-interface ListOptions {
-    numbering: {
-        reference: string;
-        level: number;
-    };
-    start?: number;
-}
-declare function convertBulletList(): ListOptions;
-declare function convertOrderedList(node: OrderedListNode): ListOptions;
-/**
- * Convert list nodes (bullet or ordered) with proper numbering
- */
-declare function convertList(node: BulletListNode | OrderedListNode, params: {
-    listType: "bullet" | "ordered";
-}): Promise<Paragraph[]>;
-
-/**
- * Convert TipTap list item node to DOCX Paragraph
- *
- * Note: The numbering reference (including start value) is typically
- * handled by the parent list converter. This function focuses on
- * converting the paragraph content of the list item.
- *
- * @param node - TipTap list item node
- * @param params - Conversion parameters
- * @returns Promise<DOCX Paragraph object>
- */
-declare function convertListItem(node: ListItemNode, params: {
-    options?: IParagraphOptions;
-}): Promise<Paragraph>;
-
-/**
- * Convert TipTap task list node to DOCX paragraphs
- *
- * @param node - TipTap task list node
- * @returns Array of Paragraph objects with checkboxes
+ * @param node - TipTap heading node
+ * @returns DOCX paragraph options (pure data object)
  */
-declare function convertTaskList(node: TaskListNode): Paragraph[];
+declare function convertHeading(node: HeadingNode): IParagraphOptions;
 
 /**
- * Convert TipTap task item node to DOCX Paragraph with checkbox
+ * Convert TipTap blockquote node to array of paragraph options
  *
- * @param node - TipTap task item node
- * @returns DOCX Paragraph object with checkbox
- */
-declare function convertTaskItem(node: TaskItemNode): Paragraph;
-
-/**
- * Convert TipTap horizontalRule node to DOCX Paragraph
- * Uses page break by default (consistent with import-docx behavior)
+ * This converter only handles data transformation from node content to DOCX format properties.
+ * It returns pure data objects (IParagraphOptions[]), not DOCX instances.
  *
- * @param node - TipTap horizontalRule node
- * @param params - Conversion parameters
- * @returns DOCX Paragraph object with page break or custom styling
- */
-declare function convertHorizontalRule(node: HorizontalRuleNode, params: {
-    /** Export options for horizontal rule styling */
-    options?: DocxExportOptions["horizontalRule"];
-}): Paragraph;
-
-/**
- * Convert TipTap detailsSummary node to DOCX Paragraph
- *
- * @param node - TipTap detailsSummary node
- * @param params - Conversion parameters
- * @returns DOCX Paragraph with summary styling
+ * @param node - TipTap blockquote node
+ * @returns Array of paragraph options (pure data objects)
  */
-declare function convertDetailsSummary(node: DetailsSummaryNode, params: {
-    /** Export options for details styling */
-    options?: DocxExportOptions["details"];
-}): Paragraph;
+declare function convertBlockquote(node: BlockquoteNode): IParagraphOptions[];
 
 // ## Interfaces
 
@@ -14176,11 +14135,6 @@ interface TextData extends Data {}
  * Unit conversion utilities for DOCX processing
  * Handles conversions between TWIPs, EMUs, pixels, and other units
  */
-/**
- * DOCX DPI (dots per inch) for pixel conversions
- * Word uses 96 DPI internally
- */
-declare const DOCX_DPI = 96;
 /**
  * Convert TWIPs to CSS pixels (returns number)
  * @param twip - Value in TWIPs (1 inch = 1440 TWIPs)
@@ -14247,6 +14201,7 @@ declare function convertEmuStringToPixels(emuStr: string): number | undefined;
  * convertCssLengthToPixels("20px") // returns 20
  * convertCssLengthToPixels("1.5em") // returns 24
  * convertCssLengthToPixels("100%") // returns 16
+ * convertCssLengthToPixels("20") // returns 20 (unitless treated as px)
  */
 declare function convertCssLengthToPixels(value: string): number;
 /**
@@ -14361,68 +14316,284 @@ declare function parseTwipAttr(attributes: Record<string, any> | {
 }, name: string): string | undefined;
 
 /**
- * Calculate effective content width from document options
+ * Shared constants for DOCX processing
+ * Used across @docen/export-docx and @docen/import-docx packages
  */
-declare function calculateEffectiveContentWidth(options?: DocxExportOptions): number;
-
 /**
- * Convert image MIME type to DOCX type
+ * DOCX DPI (dots per inch) for pixel conversions
+ * Word uses 96 DPI internally
  */
-declare function convertToDocxImageType(mimeType?: string): "jpg" | "png" | "gif" | "bmp";
+declare const DOCX_DPI = 96;
 /**
- * Extract image type from URL or base64 data
+ * TWIP (Twentieth of a Point) conversion constants
+ * 1 inch = 1440 TWIPs
  */
-declare function getImageTypeFromSrc(src: string): "png" | "jpeg" | "gif" | "bmp" | "tiff";
+declare const TWIPS_PER_INCH = 1440;
 /**
- * Create floating options for full-width images
+ * EMU (English Metric Unit) conversion constants
+ * 1 inch = 914400 EMUs
  */
-declare function createFloatingOptions(): {
-    horizontalPosition: {
-        relative: string;
-        align: string;
+declare const EMUS_PER_INCH = 914400;
+/**
+ * Font size conversion factors
+ * DOCX uses half-points, TipTap uses pixels
+ * 1px ≈ 0.75pt, 1pt = 2 half-points
+ * So: px * 0.75 * 2 = px * 1.5
+ */
+declare const HALF_POINTS_PER_PIXEL = 1.5;
+declare const PIXELS_PER_HALF_POINT: number;
+/**
+ * Default code font family
+ */
+declare const DEFAULT_CODE_FONT = "Consolas";
+/**
+ * Checkbox symbols for task lists
+ */
+declare const CHECKBOX_SYMBOLS: {
+    readonly checked: "☑";
+    readonly unchecked: "☐";
+};
+/**
+ * DOCX style names
+ */
+declare const DOCX_STYLE_NAMES: {
+    readonly CODE_BLOCK: "CodeBlock";
+    readonly CODE_PREFIX: "Code";
+};
+/**
+ * Text alignment mappings
+ */
+declare const TEXT_ALIGN_MAP: {
+    /** TipTap to DOCX alignment mapping */
+    readonly tiptapToDocx: {
+        readonly left: "left";
+        readonly right: "right";
+        readonly center: "center";
+        readonly justify: "both";
     };
-    verticalPosition: {
-        relative: string;
-        align: string;
+    /** DOCX to TipTap alignment mapping */
+    readonly docxToTipTap: {
+        readonly left: "left";
+        readonly right: "right";
+        readonly center: "center";
+        readonly both: "justify";
     };
-    lockAnchor: boolean;
-    behindDocument: boolean;
-    inFrontOfText: boolean;
 };
 /**
- * Get image width with priority: node attrs > image meta > calculated > default
+ * Common page dimensions in TWIPs
  */
-declare function getImageWidth(node: {
-    attrs?: {
-        width?: number | null;
-    };
-}, imageMeta?: {
-    width?: number;
-    height?: number;
-}, maxWidth?: number | PositiveUniversalMeasure$1): number;
+declare const PAGE_DIMENSIONS: {
+    /** A4 width in TWIPs (8.27 inches = 11906 TWIPs) */
+    readonly A4_WIDTH_TWIP: 11906;
+    /** Default 1 inch margin in TWIPs */
+    readonly DEFAULT_MARGIN_TWIP: 1440;
+};
+
 /**
- * Get image height with priority: node attrs > image meta > calculated > default
+ * Type guard utilities for DOCX processing
  */
-declare function getImageHeight(node: {
-    attrs?: {
-        height?: number | null;
-    };
-}, width: number, imageMeta?: {
-    width?: number;
-    height?: number;
-}, maxWidth?: number | PositiveUniversalMeasure$1): number;
 /**
- * Fetch image data and metadata from URL
+ * Type guard factory function
+ * Creates a type guard function that checks if a value is one of the valid values
+ *
+ * @param validValues - Readonly array of valid string values
+ * @returns Type guard function
+ *
+ * @example
+ * const isValidAlign = createStringValidator(["left", "right", "center"] as const);
+ * if (isValidAlign(value)) {
+ *   // value is typed as "left" | "right" | "center"
+ * }
  */
-declare function getImageDataAndMeta(url: string): Promise<{
-    data: Uint8Array;
-    meta: ImageMeta;
-}>;
+declare function createStringValidator<T extends string>(validValues: readonly T[]): (value: string) => value is T;
+
+/**
+ * Calculate effective content width from document options
+ */
+declare function calculateEffectiveContentWidth(options?: DocxExportOptions): number;
 
 /**
  * Apply paragraph style attributes to options
  */
 declare const applyParagraphStyleAttributes: <T extends Record<string, unknown>>(options: T, attrs?: ParagraphNode["attrs"]) => T;
 
-export { COLOR_NAME_TO_HEX, DOCX_DPI, applyParagraphStyleAttributes, calculateEffectiveContentWidth, convertBlockquote, convertBulletList, convertCodeBlock, convertColorToHex, convertCssLengthToPixels, convertDetailsSummary, convertDocument, convertEmuStringToPixels, convertEmuToPixels, convertHardBreak, convertHeading, convertHorizontalRule, convertImage, convertList, convertListItem, convertMeasureToInches, convertMeasureToPixels, convertNode, convertOrderedList, convertParagraph, convertPixelsToEmu, convertPixelsToTwip, convertTable, convertTableCell, convertTableHeader, convertTableRow, convertTaskItem, convertTaskList, convertText, convertTextNodes, convertToDocxImageType, convertTwipToCssString, convertTwipToPixels, createFloatingOptions, findChild, findDeepChild, findDeepChildren, generateDOCX, getImageDataAndMeta, getImageHeight, getImageTypeFromSrc, getImageWidth, normalizeHexColor, parseTwipAttr };
-export type { BlockNode, BlockquoteNode, BulletListNode, CodeBlockNode, DetailsContentNode, DetailsNode, DetailsSummaryNode, DocumentNode, DocxExportOptions, HardBreakNode, HeadingNode, HorizontalRuleNode, ImageFloatingOptions, ImageNode, ImageOutlineOptions, JSONContent, ListItemNode, ListOptions, Mark, OrderedListNode, ParagraphNode, PositiveUniversalMeasure, TableCellBorder, TableCellNode, TableHeaderNode, TableNode, TableRowNode, TaskItemNode, TaskListNode, TextContent, TextNode };
+/**
+ * Convert TipTap border to DOCX border format
+ *
+ * @param border - TipTap table cell border definition
+ * @returns DOCX border options or undefined if no border
+ */
+declare function convertBorder(border: TableCellBorder | null | undefined): {
+    color?: string;
+    size?: number;
+    style: "single" | "dashed" | "dotted" | "double" | "none";
+} | undefined;
+
+/**
+ * Convert TipTap image node to DOCX ImageRun
+ *
+ * @param node - TipTap image node
+ * @param params - Conversion parameters
+ * @returns Promise<DOCX ImageRun>
+ */
+declare function convertImage(node: ImageNode, params?: {
+    /** Maximum available width (number = pixels, or string like "6in", "152.4mm") */
+    maxWidth?: number | PositiveUniversalMeasure$1;
+    /** Additional image options to apply */
+    options?: Partial<IImageOptions$1>;
+    /** Custom image handler for fetching image data */
+    handler?: DocxImageExportHandler;
+}): Promise<ImageRun>;
+
+/**
+ * Apply table margins to table options
+ */
+declare const applyTableMargins: <T extends ITableOptions>(options: T, node: TableNode) => T;
+/**
+ * Convert TipTap table node to DOCX Table
+ *
+ * @param node - TipTap table node
+ * @param params - Conversion parameters
+ * @returns Promise<Table>
+ */
+declare function convertTable(node: TableNode, params: {
+    options: DocxExportOptions["table"];
+}): Promise<Table>;
+
+/**
+ * Convert TipTap table row node to DOCX TableRow
+ *
+ * @param node - TipTap table row node
+ * @param params - Conversion parameters
+ * @returns Promise<DOCX TableRow object>
+ */
+declare function convertTableRow(node: TableRowNode, params: {
+    options: DocxExportOptions["table"];
+}): Promise<TableRow>;
+
+/**
+ * Convert TipTap table cell node to DOCX TableCell
+ *
+ * @param node - TipTap table cell node
+ * @param params - Conversion parameters
+ * @returns Promise<DOCX TableCell object>
+ */
+declare function convertTableCell(node: TableCellNode, params: {
+    options: DocxExportOptions["table"];
+}): Promise<TableCell>;
+
+/**
+ * Convert TipTap table header node to DOCX TableCell
+ *
+ * @param node - TipTap table header node
+ * @param params - Conversion parameters
+ * @returns Promise<DOCX TableCell object for header>
+ */
+declare function convertTableHeader(node: TableHeaderNode, params: {
+    options: DocxExportOptions["table"];
+}): Promise<TableCell>;
+
+/**
+ * Convert TipTap codeBlock node to DOCX paragraph options
+ *
+ * This converter only handles data transformation from node.attrs to DOCX format properties.
+ * It returns pure data objects (IParagraphOptions), not DOCX instances.
+ *
+ * @param node - TipTap codeBlock node
+ * @returns DOCX paragraph options (pure data object)
+ */
+declare function convertCodeBlock(node: CodeBlockNode): IParagraphOptions;
+
+interface ListOptions {
+    numbering: {
+        reference: string;
+        level: number;
+    };
+    start?: number;
+}
+declare function convertBulletList(): ListOptions;
+declare function convertOrderedList(node: OrderedListNode): ListOptions;
+/**
+ * Convert list nodes (bullet or ordered) with proper numbering
+ *
+ * This converter only handles data transformation from node content to DOCX format properties.
+ * It returns pure data objects (IParagraphOptions[]), not DOCX instances.
+ */
+declare function convertList(node: BulletListNode | OrderedListNode, params: {
+    listType: "bullet" | "ordered";
+}): Promise<IParagraphOptions[]>;
+
+/**
+ * Convert TipTap list item node to paragraph options
+ *
+ * This converter only handles data transformation from node content to DOCX format properties.
+ * It returns pure data objects (IParagraphOptions), not DOCX instances.
+ *
+ * Note: The numbering reference (including start value) is typically
+ * handled by the parent list converter. This function focuses on
+ * converting the paragraph content of the list item.
+ *
+ * @param node - TipTap list item node
+ * @param params - Conversion parameters
+ * @returns Promise<Paragraph options (pure data object)>
+ */
+declare function convertListItem(node: ListItemNode, params: {
+    options?: IParagraphOptions;
+}): Promise<IParagraphOptions>;
+
+/**
+ * Convert TipTap task list node to array of paragraph options
+ *
+ * This converter only handles data transformation from node content to DOCX format properties.
+ * It returns pure data objects (IParagraphOptions[]), not DOCX instances.
+ *
+ * @param node - TipTap task list node
+ * @returns Array of paragraph options (pure data objects) with checkboxes
+ */
+declare function convertTaskList(node: TaskListNode): IParagraphOptions[];
+
+/**
+ * Convert TipTap task item node to paragraph options with checkbox
+ *
+ * This converter only handles data transformation from node content to DOCX format properties.
+ * It returns pure data objects (IParagraphOptions), not DOCX instances.
+ *
+ * @param node - TipTap task item node
+ * @returns Paragraph options (pure data object) with checkbox
+ */
+declare function convertTaskItem(node: TaskItemNode): IParagraphOptions;
+
+/**
+ * Convert TipTap horizontalRule node to paragraph options
+ *
+ * This converter only handles data transformation from node to DOCX format properties.
+ * It returns pure data objects (IParagraphOptions), not DOCX instances.
+ *
+ * Uses page break by default (consistent with import-docx behavior)
+ *
+ * @param node - TipTap horizontalRule node
+ * @param params - Conversion parameters
+ * @returns Paragraph options (pure data object) with page break or custom styling
+ */
+declare function convertHorizontalRule(node: HorizontalRuleNode, params: {
+    /** Export options for horizontal rule styling */
+    options?: DocxExportOptions["horizontalRule"];
+}): IParagraphOptions;
+
+/**
+ * Convert TipTap detailsSummary node to paragraph options
+ *
+ * This converter only handles data transformation from node content to DOCX format properties.
+ * It returns pure data objects (IParagraphOptions), not DOCX instances.
+ *
+ * @param node - TipTap detailsSummary node
+ * @param params - Conversion parameters
+ * @returns Paragraph options (pure data object) with summary styling
+ */
+declare function convertDetailsSummary(node: DetailsSummaryNode, params: {
+    /** Export options for details styling */
+    options?: DocxExportOptions["details"];
+}): IParagraphOptions;
+
+export { CHECKBOX_SYMBOLS, COLOR_NAME_TO_HEX, DEFAULT_CODE_FONT, DOCX_DPI, DOCX_STYLE_NAMES, EMUS_PER_INCH, HALF_POINTS_PER_PIXEL, PAGE_DIMENSIONS, PIXELS_PER_HALF_POINT, TEXT_ALIGN_MAP, TWIPS_PER_INCH, applyParagraphStyleAttributes, applyTableMargins, calculateEffectiveContentWidth, convertBlockquote, convertBorder, convertBulletList, convertCodeBlock, convertColorToHex, convertCssLengthToPixels, convertDetailsSummary, convertDocument, convertEmuStringToPixels, convertEmuToPixels, convertHardBreak, convertHeading, convertHorizontalRule, convertImage, convertList, convertListItem, convertMeasureToInches, convertMeasureToPixels, convertNode, convertOrderedList, convertParagraph, convertPixelsToEmu, convertPixelsToTwip, convertTable, convertTableCell, convertTableHeader, convertTableRow, convertTaskItem, convertTaskList, convertText, convertTextNodes, convertToDocxImageType, convertTwipToCssString, convertTwipToPixels, createFloatingOptions, createStringValidator, findChild, findDeepChild, findDeepChildren, generateDOCX, getImageDataAndMeta, getImageHeight, getImageTypeFromSrc, getImageWidth, normalizeHexColor, parseTwipAttr };
+export type { BlockNode, BlockquoteNode, BulletListNode, CodeBlockNode, DetailsContentNode, DetailsNode, DetailsSummaryNode, DocumentNode, DocxExportOptions, DocxImageExportHandler, HardBreakNode, HeadingNode, HorizontalRuleNode, ImageFloatingOptions, ImageNode, ImageOutlineOptions, JSONContent, ListItemNode, ListOptions, Mark, OrderedListNode, ParagraphNode, PositiveUniversalMeasure, TableCellBorder, TableCellNode, TableHeaderNode, TableNode, TableRowNode, TaskItemNode, TaskListNode, TextContent, TextNode };