@docen/export-docx 0.0.12 → 0.0.13

package/README.md

@@ -1,271 +1,271 @@
-# @docen/export-docx
-
-![npm version](https://img.shields.io/npm/v/@docen/export-docx)
-![npm downloads](https://img.shields.io/npm/dw/@docen/export-docx)
-![npm license](https://img.shields.io/npm/l/@docen/export-docx)
-
-> Export TipTap/ProseMirror editor content to Microsoft Word DOCX format.
-
-## Features
-
-- 📝 **Rich Text Support** - Full support for headings, paragraphs, and blockquotes with proper formatting
-- 🖼️ **Image Handling** - Automatic image sizing, positioning, and metadata extraction
-- 📊 **Table Support** - Complete table structure with headers, cells, colspan, and rowspan
-- ✅ **Lists & Tasks** - Bullet lists, numbered lists with custom start numbers, and task lists with checkboxes
-- 🎨 **Text Formatting** - Bold, italic, underline, strikethrough, subscript, and superscript
-- 🎯 **Text Styles** - Comprehensive style support including colors, backgrounds, fonts, sizes, and line heights
-- 🔗 **Links** - Hyperlink support with href preservation
-- 💻 **Code Blocks** - Syntax highlighted code blocks with language attribute support
-- 📁 **Collapsible Content** - Details/summary sections for expandable content
-- 😀 **Emoji Support** - Native emoji rendering in documents
-- 🧮 **Mathematical Content** - LaTeX-style formula support
-- ⚙️ **Configurable Options** - Customizable export options for documents, tables, styles, and horizontal rules
-
-## Installation
-
-```bash
-# Install with npm
-$ npm install @docen/export-docx
-
-# Install with yarn
-$ yarn add @docen/export-docx
-
-# Install with pnpm
-$ pnpm add @docen/export-docx
-```
-
-## Quick Start
-
-```typescript
-import { generateDOCX } from "@docen/export-docx";
-import { writeFileSync } from "node:fs";
-
-// Your TipTap/ProseMirror editor content
-const content = {
-  type: "doc",
-  content: [
-    {
-      type: "paragraph",
-      content: [
-        {
-          type: "text",
-          marks: [{ type: "bold" }, { type: "italic" }],
-          text: "Hello, world!",
-        },
-      ],
-    },
-  ],
-};
-
-// Convert to DOCX and save to file
-const docx = await generateDOCX(content, { outputType: "nodebuffer" });
-writeFileSync("document.docx", docx);
-```
-
-## API Reference
-
-### `generateDOCX(content, options)`
-
-Converts TipTap/ProseMirror content to DOCX format.
-
-**Parameters:**
-
-- `content: JSONContent` - TipTap/ProseMirror editor content
-- `options: DocxExportOptions` - Export configuration options
-
-**Returns:** `Promise<OutputByType[T]>` - DOCX file data with type matching the specified outputType
-
-**Available Output Types:**
-
-- `"base64"` - Base64 encoded string
-- `"string"` - Text string
-- `"text"` - Plain text
-- `"binarystring"` - Binary string
-- `"array"` - Array of numbers
-- `"uint8array"` - Uint8Array
-- `"arraybuffer"` - ArrayBuffer
-- `"blob"` - Blob object
-- `"nodebuffer"` - Node.js Buffer
-
-**Configuration Options:**
-
-- `title` - Document title
-- `creator` - Document author
-- `description` - Document description
-- `outputType` - Output format (required)
-- `table` - Table styling defaults (alignment, spacing, borders)
-- `image` - Image handling options
-- `styles` - Document default styles (font, line height, spacing)
-- `horizontalRule` - Horizontal rule style
-
-## Supported Content Types
-
-### Text Formatting
-
-- **Bold**, _Italic_, <u>Underline</u>, ~~Strikethrough~~
-- ^Superscript^ and ~Subscript~
-- Text colors and background colors
-- Font families and sizes
-- Line heights
-
-### Block Elements
-
-- **Headings** (H1-H6) with level attribute
-- **Paragraphs** with text alignment (left, right, center, justify)
-- **Blockquotes** (Note: Exported as indented paragraphs with left border due to DOCX format)
-- **Horizontal Rules** (Exported as page breaks by default)
-- **Code Blocks** with language support
-
-### Lists
-
-- **Bullet Lists** - Standard unordered lists
-- **Numbered Lists** - Ordered lists with custom start number
-- **Task Lists** - Checkbox lists with checked/unchecked states
-
-### Tables
-
-- Complete table structure with rows and cells
-- **Table Headers** with colspan/rowspan support
-- **Table Cells** with colspan/rowspan support
-- Cell alignment and formatting options
-
-### Media & Embeds
-
-- **Images** with automatic sizing and positioning
-- **Links** (hyperlinks) with href attribute
-- **Emoji** rendering
-- **Mathematics** formulas (LaTeX-style)
-- **Details/Summary** collapsible sections
-
-## Examples
-
-### Document with Tables and Colspan/Rowspan
-
-```typescript
-const content = {
-  type: "doc",
-  content: [
-    {
-      type: "table",
-      content: [
-        {
-          type: "tableRow",
-          content: [
-            {
-              type: "tableHeader",
-              attrs: { colspan: 2, rowspan: 1 },
-              content: [
-                {
-                  type: "paragraph",
-                  content: [{ type: "text", text: "Spanning Header" }],
-                },
-              ],
-            },
-            {
-              type: "tableCell",
-              content: [
-                {
-                  type: "paragraph",
-                  content: [{ type: "text", text: "Regular Cell" }],
-                },
-              ],
-            },
-          ],
-        },
-      ],
-    },
-  ],
-};
-```
-
-### Document with Text Styles
-
-```typescript
-const content = {
-  type: "doc",
-  content: [
-    {
-      type: "paragraph",
-      content: [
-        {
-          type: "text",
-          marks: [
-            {
-              type: "textStyle",
-              attrs: {
-                color: "#FF0000",
-                fontSize: "18px",
-                fontFamily: "Arial",
-                backgroundColor: "#FFFF00",
-              },
-            },
-          ],
-          text: "Red, 18px, Arial text on yellow background",
-        },
-      ],
-    },
-  ],
-};
-```
-
-### Document with Lists
-
-```typescript
-const content = {
-  type: "doc",
-  content: [
-    {
-      type: "bulletList",
-      content: [
-        {
-          type: "listItem",
-          content: [
-            {
-              type: "paragraph",
-              content: [{ type: "text", text: "First item" }],
-            },
-          ],
-        },
-        {
-          type: "listItem",
-          content: [
-            {
-              type: "paragraph",
-              content: [{ type: "text", text: "Second item" }],
-            },
-          ],
-        },
-      ],
-    },
-  ],
-};
-```
-
-## Known Limitations
-
-### Blockquote Structure
-
-DOCX does not have a semantic blockquote structure. Blockquotes are exported as:
-
-- Indented paragraphs (720 twips / 0.5 inch left indentation)
-- Left border (single line)
-
-This is a DOCX format limitation, not a bug.
-
-### Code Marks
-
-The `code` mark is exported as monospace font (Consolas). When re-importing, it will be recognized as `textStyle` with `fontFamily: "Consolas"`, not as a `code` mark.
-
-This is intentional - we do not detect code marks from fonts during import to avoid false positives.
-
-### Color Name Conversion
-
-Color names (like `"red"`, `"green"`, `"blue"`) are automatically converted to hex values (`"#FF0000"`, `"#008000"`, `"#0000FF"`) for DOCX compatibility.
-
-## Contributing
-
-Contributions are welcome! Please read our [Contributor Covenant](https://www.contributor-covenant.org/version/2/1/code_of_conduct/) and submit pull requests to the [main repository](https://github.com/DemoMacro/docen).
-
-## License
-
-- [MIT](LICENSE) &copy; [Demo Macro](https://imst.xyz/)
+# @docen/export-docx
+
+![npm version](https://img.shields.io/npm/v/@docen/export-docx)
+![npm downloads](https://img.shields.io/npm/dw/@docen/export-docx)
+![npm license](https://img.shields.io/npm/l/@docen/export-docx)
+
+> Export TipTap/ProseMirror editor content to Microsoft Word DOCX format.
+
+## Features
+
+- 📝 **Rich Text Support** - Full support for headings, paragraphs, and blockquotes with proper formatting
+- 🖼️ **Image Handling** - Automatic image sizing, positioning, and metadata extraction
+- 📊 **Table Support** - Complete table structure with headers, cells, colspan, and rowspan
+- ✅ **Lists & Tasks** - Bullet lists, numbered lists with custom start numbers, and task lists with checkboxes
+- 🎨 **Text Formatting** - Bold, italic, underline, strikethrough, subscript, and superscript
+- 🎯 **Text Styles** - Comprehensive style support including colors, backgrounds, fonts, sizes, and line heights
+- 🔗 **Links** - Hyperlink support with href preservation
+- 💻 **Code Blocks** - Syntax highlighted code blocks with language attribute support
+- 📁 **Collapsible Content** - Details/summary sections for expandable content
+- 😀 **Emoji Support** - Native emoji rendering in documents
+- 🧮 **Mathematical Content** - LaTeX-style formula support
+- ⚙️ **Configurable Options** - Customizable export options for documents, tables, styles, and horizontal rules
+
+## Installation
+
+```bash
+# Install with npm
+$ npm install @docen/export-docx
+
+# Install with yarn
+$ yarn add @docen/export-docx
+
+# Install with pnpm
+$ pnpm add @docen/export-docx
+```
+
+## Quick Start
+
+```typescript
+import { generateDOCX } from "@docen/export-docx";
+import { writeFileSync } from "node:fs";
+
+// Your TipTap/ProseMirror editor content
+const content = {
+  type: "doc",
+  content: [
+    {
+      type: "paragraph",
+      content: [
+        {
+          type: "text",
+          marks: [{ type: "bold" }, { type: "italic" }],
+          text: "Hello, world!",
+        },
+      ],
+    },
+  ],
+};
+
+// Convert to DOCX and save to file
+const docx = await generateDOCX(content, { outputType: "nodebuffer" });
+writeFileSync("document.docx", docx);
+```
+
+## API Reference
+
+### `generateDOCX(content, options)`
+
+Converts TipTap/ProseMirror content to DOCX format.
+
+**Parameters:**
+
+- `content: JSONContent` - TipTap/ProseMirror editor content
+- `options: DocxExportOptions` - Export configuration options
+
+**Returns:** `Promise<OutputByType[T]>` - DOCX file data with type matching the specified outputType
+
+**Available Output Types:**
+
+- `"base64"` - Base64 encoded string
+- `"string"` - Text string
+- `"text"` - Plain text
+- `"binarystring"` - Binary string
+- `"array"` - Array of numbers
+- `"uint8array"` - Uint8Array
+- `"arraybuffer"` - ArrayBuffer
+- `"blob"` - Blob object
+- `"nodebuffer"` - Node.js Buffer
+
+**Configuration Options:**
+
+- `title` - Document title
+- `creator` - Document author
+- `description` - Document description
+- `outputType` - Output format (required)
+- `table` - Table styling defaults (alignment, spacing, borders)
+- `image` - Image handling options
+- `styles` - Document default styles (font, line height, spacing)
+- `horizontalRule` - Horizontal rule style
+
+## Supported Content Types
+
+### Text Formatting
+
+- **Bold**, _Italic_, <u>Underline</u>, ~~Strikethrough~~
+- ^Superscript^ and ~Subscript~
+- Text colors and background colors
+- Font families and sizes
+- Line heights
+
+### Block Elements
+
+- **Headings** (H1-H6) with level attribute
+- **Paragraphs** with text alignment (left, right, center, justify)
+- **Blockquotes** (Note: Exported as indented paragraphs with left border due to DOCX format)
+- **Horizontal Rules** (Exported as page breaks by default)
+- **Code Blocks** with language support
+
+### Lists
+
+- **Bullet Lists** - Standard unordered lists
+- **Numbered Lists** - Ordered lists with custom start number
+- **Task Lists** - Checkbox lists with checked/unchecked states
+
+### Tables
+
+- Complete table structure with rows and cells
+- **Table Headers** with colspan/rowspan support
+- **Table Cells** with colspan/rowspan support
+- Cell alignment and formatting options
+
+### Media & Embeds
+
+- **Images** with automatic sizing and positioning
+- **Links** (hyperlinks) with href attribute
+- **Emoji** rendering
+- **Mathematics** formulas (LaTeX-style)
+- **Details/Summary** collapsible sections
+
+## Examples
+
+### Document with Tables and Colspan/Rowspan
+
+```typescript
+const content = {
+  type: "doc",
+  content: [
+    {
+      type: "table",
+      content: [
+        {
+          type: "tableRow",
+          content: [
+            {
+              type: "tableHeader",
+              attrs: { colspan: 2, rowspan: 1 },
+              content: [
+                {
+                  type: "paragraph",
+                  content: [{ type: "text", text: "Spanning Header" }],
+                },
+              ],
+            },
+            {
+              type: "tableCell",
+              content: [
+                {
+                  type: "paragraph",
+                  content: [{ type: "text", text: "Regular Cell" }],
+                },
+              ],
+            },
+          ],
+        },
+      ],
+    },
+  ],
+};
+```
+
+### Document with Text Styles
+
+```typescript
+const content = {
+  type: "doc",
+  content: [
+    {
+      type: "paragraph",
+      content: [
+        {
+          type: "text",
+          marks: [
+            {
+              type: "textStyle",
+              attrs: {
+                color: "#FF0000",
+                fontSize: "18px",
+                fontFamily: "Arial",
+                backgroundColor: "#FFFF00",
+              },
+            },
+          ],
+          text: "Red, 18px, Arial text on yellow background",
+        },
+      ],
+    },
+  ],
+};
+```
+
+### Document with Lists
+
+```typescript
+const content = {
+  type: "doc",
+  content: [
+    {
+      type: "bulletList",
+      content: [
+        {
+          type: "listItem",
+          content: [
+            {
+              type: "paragraph",
+              content: [{ type: "text", text: "First item" }],
+            },
+          ],
+        },
+        {
+          type: "listItem",
+          content: [
+            {
+              type: "paragraph",
+              content: [{ type: "text", text: "Second item" }],
+            },
+          ],
+        },
+      ],
+    },
+  ],
+};
+```
+
+## Known Limitations
+
+### Blockquote Structure
+
+DOCX does not have a semantic blockquote structure. Blockquotes are exported as:
+
+- Indented paragraphs (720 twips / 0.5 inch left indentation)
+- Left border (single line)
+
+This is a DOCX format limitation, not a bug.
+
+### Code Marks
+
+The `code` mark is exported as monospace font (Consolas). When re-importing, it will be recognized as `textStyle` with `fontFamily: "Consolas"`, not as a `code` mark.
+
+This is intentional - we do not detect code marks from fonts during import to avoid false positives.
+
+### Color Name Conversion
+
+Color names (like `"red"`, `"green"`, `"blue"`) are automatically converted to hex values (`"#FF0000"`, `"#008000"`, `"#0000FF"`) for DOCX compatibility.
+
+## Contributing
+
+Contributions are welcome! Please read our [Contributor Covenant](https://www.contributor-covenant.org/version/2/1/code_of_conduct/) and submit pull requests to the [main repository](https://github.com/DemoMacro/docen).
+
+## License
+
+- [MIT](LICENSE) &copy; [Demo Macro](https://imst.xyz/)

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-import { ExternalHyperlink, FileChild, IFloating, IHorizontalPositionOptions, IImageOptions, IParagraphOptions, IParagraphStyleOptions, IPropertiesOptions, ISectionOptions, ITableCellOptions, ITableOfContentsOptions, ITableOptions, ITableRowOptions, IVerticalPositionOptions, ImageRun, OutputByType, OutputType, PositiveUniversalMeasure as PositiveUniversalMeasure$1, Table, TableCell, TableRow, TextRun } from "docx";
+import { ExternalHyperlink, FileChild, IImageOptions, IParagraphOptions, IParagraphStyleOptions, IPropertiesOptions, ISectionOptions, ITableCellOptions, ITableOfContentsOptions, ITableOptions, ITableRowOptions, ImageRun, OutputByType, OutputType, PositiveUniversalMeasure as PositiveUniversalMeasure$1, Table, TableCell, TableRow, TextRun } from "docx";
 import { ImageMeta } from "image-meta";
 
 //#region ../../node_modules/.pnpm/orderedmap@2.1.1/node_modules/orderedmap/dist/index.d.ts
@@ -3672,7 +3672,7 @@ point into textblock nodes. It can be empty (a regular cursor
 position).
 */
 //#endregion
-//#region ../../node_modules/.pnpm/@tiptap+core@3.20.1_@tiptap+pm@3.20.1/node_modules/@tiptap/core/dist/index.d.ts
+//#region ../../node_modules/.pnpm/@tiptap+core@3.20.0_@tiptap+pm@3.20.0/node_modules/@tiptap/core/dist/index.d.ts
 type StringKeyOf<T> = Extract<keyof T, string>;
 type CallbackType<T extends Record<string, any>, EventName extends StringKeyOf<T>> = T[EventName] extends any[] ? T[EventName] : [T[EventName]];
 type CallbackFunction<T extends Record<string, any>, EventName extends StringKeyOf<T>> = (...props: CallbackType<T, EventName>) => any;
@@ -6763,12 +6763,225 @@ declare function convertDocument(node: JSONContent, params: {
 declare function convertNode(node: JSONContent, options: DocxExportOptions, effectiveContentWidth: number): Promise<FileChild | FileChild[] | null>;
 //#endregion
 //#region ../extensions/dist/types.d.mts
+//#region ../../node_modules/.pnpm/docx@9.6.1/node_modules/docx/dist/index.d.ts
+declare const CompoundLine: {
+  readonly SINGLE: "sng";
+  readonly DOUBLE: "dbl";
+  readonly THICK_THIN: "thickThin";
+  readonly THIN_THICK: "thinThick";
+  readonly TRI: "tri";
+};
+declare type CoreImageOptions = {
+  readonly transformation: IMediaTransformation;
+  readonly floating?: IFloating;
+  readonly altText?: DocPropertiesOptions;
+  readonly outline?: OutlineOptions;
+  readonly solidFill?: SolidFillOptions;
+};
+declare type DocPropertiesOptions = {
+  readonly name: string;
+  readonly description?: string;
+  readonly title?: string;
+  readonly id?: string;
+};
+declare const HorizontalPositionAlign: {
+  readonly CENTER: "center";
+  readonly INSIDE: "inside";
+  readonly LEFT: "left";
+  readonly OUTSIDE: "outside";
+  readonly RIGHT: "right";
+};
+declare const HorizontalPositionRelativeFrom: {
+  readonly CHARACTER: "character";
+  readonly COLUMN: "column";
+  readonly INSIDE_MARGIN: "insideMargin";
+  readonly LEFT_MARGIN: "leftMargin";
+  readonly MARGIN: "margin";
+  readonly OUTSIDE_MARGIN: "outsideMargin";
+  readonly PAGE: "page";
+  readonly RIGHT_MARGIN: "rightMargin";
+};
+declare type IDistance = {
+  readonly distT?: number;
+  readonly distB?: number;
+  readonly distL?: number;
+  readonly distR?: number;
+};
+declare type IFloating = {
+  readonly horizontalPosition: IHorizontalPositionOptions;
+  readonly verticalPosition: IVerticalPositionOptions;
+  readonly allowOverlap?: boolean;
+  readonly lockAnchor?: boolean;
+  readonly behindDocument?: boolean;
+  readonly layoutInCell?: boolean;
+  readonly margins?: IMargins;
+  readonly wrap?: ITextWrapping;
+  readonly zIndex?: number;
+};
+declare type IHorizontalPositionOptions = {
+  readonly relative?: (typeof HorizontalPositionRelativeFrom)[keyof typeof HorizontalPositionRelativeFrom];
+  readonly align?: (typeof HorizontalPositionAlign)[keyof typeof HorizontalPositionAlign];
+  readonly offset?: number;
+};
+declare type IImageOptions$1 = (RegularImageOptions | SvgMediaOptions) & CoreImageOptions;
+declare type IMargins = {
+  readonly left?: number;
+  readonly bottom?: number;
+  readonly top?: number;
+  readonly right?: number;
+};
+declare type IMediaTransformation = {
+  readonly offset?: {
+    readonly top?: number;
+    readonly left?: number;
+  };
+  readonly width: number;
+  readonly height: number;
+  readonly flip?: {
+    readonly vertical?: boolean;
+    readonly horizontal?: boolean;
+  };
+  readonly rotation?: number;
+};
+declare type ITextWrapping = {
+  readonly type: (typeof TextWrappingType)[keyof typeof TextWrappingType];
+  readonly side?: (typeof TextWrappingSide)[keyof typeof TextWrappingSide];
+  readonly margins?: IDistance;
+};
+declare type IVerticalPositionOptions = {
+  readonly relative?: (typeof VerticalPositionRelativeFrom)[keyof typeof VerticalPositionRelativeFrom];
+  readonly align?: (typeof VerticalPositionAlign)[keyof typeof VerticalPositionAlign];
+  readonly offset?: number;
+};
+declare const LineCap: {
+  readonly ROUND: "rnd";
+  readonly SQUARE: "sq";
+  readonly FLAT: "flat";
+};
+declare type OutlineAttributes = {
+  readonly width?: number;
+  readonly cap?: keyof typeof LineCap;
+  readonly compoundLine?: keyof typeof CompoundLine;
+  readonly align?: keyof typeof PenAlignment;
+};
+declare type OutlineFillProperties = OutlineNoFill | OutlineSolidFill;
+declare type OutlineNoFill = {
+  readonly type: "noFill";
+};
+declare type OutlineOptions = OutlineAttributes & OutlineFillProperties;
+declare type OutlineRgbSolidFill = {
+  readonly type: "solidFill";
+  readonly solidFillType: "rgb";
+  readonly value: string;
+};
+declare type OutlineSchemeSolidFill = {
+  readonly type: "solidFill";
+  readonly solidFillType: "scheme";
+  readonly value: (typeof SchemeColor)[keyof typeof SchemeColor];
+};
+declare type OutlineSolidFill = OutlineRgbSolidFill | OutlineSchemeSolidFill;
+declare const PenAlignment: {
+  readonly CENTER: "ctr";
+  readonly INSET: "in";
+};
+declare type RegularImageOptions = {
+  readonly type: "jpg" | "png" | "gif" | "bmp";
+  readonly data: Buffer | string | Uint8Array | ArrayBuffer;
+};
+declare type RgbColorOptions = {
+  readonly type: "rgb";
+  readonly value: string;
+};
+declare const SchemeColor: {
+  readonly BG1: "bg1";
+  readonly TX1: "tx1";
+  readonly BG2: "bg2";
+  readonly TX2: "tx2";
+  readonly ACCENT1: "accent1";
+  readonly ACCENT2: "accent2";
+  readonly ACCENT3: "accent3";
+  readonly ACCENT4: "accent4";
+  readonly ACCENT5: "accent5";
+  readonly ACCENT6: "accent6";
+  readonly HLINK: "hlink";
+  readonly FOLHLINK: "folHlink";
+  readonly DK1: "dk1";
+  readonly LT1: "lt1";
+  readonly DK2: "dk2";
+  readonly LT2: "lt2";
+  readonly PHCLR: "phClr";
+};
+declare type SchemeColorOptions = {
+  readonly type: "scheme";
+  readonly value: (typeof SchemeColor)[keyof typeof SchemeColor];
+};
+declare type SolidFillOptions = RgbColorOptions | SchemeColorOptions;
+declare type SvgMediaOptions = {
+  readonly type: "svg";
+  readonly data: Buffer | string | Uint8Array | ArrayBuffer;
+  readonly fallback: RegularImageOptions;
+};
+declare const TextWrappingSide: {
+  readonly BOTH_SIDES: "bothSides";
+  readonly LEFT: "left";
+  readonly RIGHT: "right";
+  readonly LARGEST: "largest";
+};
+declare const TextWrappingType: {
+  readonly NONE: 0;
+  readonly SQUARE: 1;
+  readonly TIGHT: 2;
+  readonly TOP_AND_BOTTOM: 3;
+};
+declare const VerticalPositionAlign: {
+  readonly BOTTOM: "bottom";
+  readonly CENTER: "center";
+  readonly INSIDE: "inside";
+  readonly OUTSIDE: "outside";
+  readonly TOP: "top";
+};
+declare const VerticalPositionRelativeFrom: {
+  readonly BOTTOM_MARGIN: "bottomMargin";
+  readonly INSIDE_MARGIN: "insideMargin";
+  readonly LINE: "line";
+  readonly MARGIN: "margin";
+  readonly OUTSIDE_MARGIN: "outsideMargin";
+  readonly PAGE: "page";
+  readonly PARAGRAPH: "paragraph";
+  readonly TOP_MARGIN: "topMargin";
+}; //#endregion
 //#region src/types.d.ts
+/**
+ * Border definition (compatible with docx.js BorderOptions)
+ * Used by paragraphs, table cells, and blockquotes
+ */
+interface Border {
+  /** Border color (hex without #, e.g., "FF0000" or "auto") */
+  color?: string;
+  /** Border size (eighth-points, 1/8 pt) */
+  size?: number;
+  /** Border style */
+  style?: "single" | "dashed" | "dotted" | "double" | "dotDash" | "dotDotDash" | "none";
+  /** Space between border and content (points) */
+  space?: number;
+}
+/**
+ * Shading definition (compatible with docx.js ShadingOptions)
+ * Used for paragraph and table cell background colors
+ */
+interface Shading {
+  /** Fill color (hex without #, e.g., "FF0000") */
+  fill?: string;
+  /** Pattern color (hex without #) */
+  color?: string;
+  /** Shading pattern type (e.g., "clear", "percent-10") */
+  type?: string;
+}
 type ImageFloatingOptions = {
   horizontalPosition: IHorizontalPositionOptions;
   verticalPosition: IVerticalPositionOptions;
 } & Partial<Omit<IFloating, "horizontalPosition" | "verticalPosition">>;
-type ImageOutlineOptions = IImageOptions["outline"];
+type ImageOutlineOptions = IImageOptions$1["outline"];
 interface TextNode {
   type: "text";
   text: string;
@@ -6806,6 +7019,11 @@ interface ParagraphNode extends JSONContent {
     indentFirstLine?: string;
     spacingBefore?: string;
     spacingAfter?: string;
+    shading?: Shading;
+    borderTop?: Border;
+    borderBottom?: Border;
+    borderLeft?: Border;
+    borderRight?: Border;
   };
   content?: Array<TextNode | HardBreakNode | ImageNode>;
 }
@@ -6819,6 +7037,11 @@ interface HeadingNode extends JSONContent {
     spacingBefore?: string;
     spacingAfter?: string;
     textAlign?: "left" | "right" | "center" | "justify";
+    shading?: Shading;
+    borderTop?: Border;
+    borderBottom?: Border;
+    borderLeft?: Border;
+    borderRight?: Border;
   };
   content?: Array<TextNode | HardBreakNode>;
 }
@@ -6864,11 +7087,6 @@ interface TaskItemNode extends JSONContent {
   };
   content?: Array<ParagraphNode>;
 }
-interface TableCellBorder {
-  color?: string;
-  width?: number;
-  style?: "solid" | "dashed" | "dotted" | "double" | "none";
-}
 interface TableNode extends JSONContent {
   type: "table";
   attrs?: {
@@ -6894,10 +7112,10 @@ interface TableCellNode extends JSONContent {
     colwidth?: number[] | null;
     backgroundColor?: string | null;
     verticalAlign?: "top" | "middle" | "bottom" | null;
-    borderTop?: TableCellBorder | null;
-    borderBottom?: TableCellBorder | null;
-    borderLeft?: TableCellBorder | null;
-    borderRight?: TableCellBorder | null;
+    borderTop?: Border;
+    borderBottom?: Border;
+    borderLeft?: Border;
+    borderRight?: Border;
   };
   content?: Array<ParagraphNode>;
 }
@@ -6909,10 +7127,10 @@ interface TableHeaderNode extends JSONContent {
     colwidth?: number[] | null;
     backgroundColor?: string | null;
     verticalAlign?: "top" | "middle" | "bottom" | null;
-    borderTop?: TableCellBorder | null;
-    borderBottom?: TableCellBorder | null;
-    borderLeft?: TableCellBorder | null;
-    borderRight?: TableCellBorder | null;
+    borderTop?: Border;
+    borderBottom?: Border;
+    borderLeft?: Border;
+    borderRight?: Border;
   };
   content?: Array<ParagraphNode>;
 }
@@ -7632,26 +7850,30 @@ declare function createStringValidator<T extends string>(validValues: readonly T
  * Calculate effective content width from document options
  */
 declare function calculateEffectiveContentWidth(options?: DocxExportOptions): number;
-//#endregion
-//#region src/utils/paragraph.d.ts
 /**
- * Apply paragraph style attributes to options
+ * Convert Border to docx.js format
  */
-declare const applyParagraphStyleAttributes: <T extends Record<string, unknown>>(options: T, attrs?: ParagraphNode["attrs"]) => T;
-//#endregion
-//#region src/utils/table.d.ts
+declare function convertBorder(border?: Border): {
+  color?: string;
+  size?: number;
+  style?: string;
+  space?: number;
+} | undefined;
 /**
- * Convert TipTap border to DOCX border format
- *
- * @param border - TipTap table cell border definition
- * @returns DOCX border options or undefined if no border
+ * Convert Shading to docx.js format
  */
-declare function convertBorder(border: TableCellBorder | null | undefined): {
+declare function convertShading(shading?: Shading): {
+  fill?: string;
   color?: string;
-  size?: number;
-  style: "single" | "dashed" | "dotted" | "double" | "none";
+  val?: string;
 } | undefined;
 //#endregion
+//#region src/utils/paragraph.d.ts
+/**
+ * Apply paragraph style attributes to options
+ */
+declare const applyParagraphStyleAttributes: <T extends Record<string, unknown>>(options: T, attrs?: ParagraphNode["attrs"]) => T;
+//#endregion
 //#region src/converters/image.d.ts
 /**
  * Convert TipTap image node to DOCX ImageRun
@@ -7825,4 +8047,4 @@ declare function convertDetailsSummary(node: DetailsSummaryNode, params: {
   /** Export options for details styling */options?: DocxExportOptions["details"];
 }): IParagraphOptions;
 //#endregion
-export { BlockNode, BlockquoteNode, BulletListNode, CHECKBOX_SYMBOLS, COLOR_NAME_TO_HEX, CodeBlockNode, DEFAULT_CODE_FONT, DOCX_DPI, DOCX_STYLE_NAMES, DetailsContentNode, DetailsNode, DetailsSummaryNode, DocumentNode, DocxExportOptions, DocxImageExportHandler, EMUS_PER_INCH, HALF_POINTS_PER_PIXEL, HardBreakNode, HeadingNode, HorizontalRuleNode, ImageFloatingOptions, ImageNode, ImageOutlineOptions, type JSONContent, ListItemNode, ListOptions, Mark, OrderedListNode, PAGE_DIMENSIONS, PIXELS_PER_HALF_POINT, ParagraphNode, PositiveUniversalMeasure, TEXT_ALIGN_MAP, TWIPS_PER_INCH, TableCellBorder, TableCellNode, TableHeaderNode, TableNode, TableRowNode, TaskItemNode, TaskListNode, TextContent, TextNode, 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 { BlockNode, BlockquoteNode, Border, BulletListNode, CHECKBOX_SYMBOLS, COLOR_NAME_TO_HEX, CodeBlockNode, DEFAULT_CODE_FONT, DOCX_DPI, DOCX_STYLE_NAMES, DetailsContentNode, DetailsNode, DetailsSummaryNode, DocumentNode, DocxExportOptions, DocxImageExportHandler, EMUS_PER_INCH, HALF_POINTS_PER_PIXEL, HardBreakNode, HeadingNode, HorizontalRuleNode, ImageFloatingOptions, ImageNode, ImageOutlineOptions, type JSONContent, ListItemNode, ListOptions, Mark, OrderedListNode, PAGE_DIMENSIONS, PIXELS_PER_HALF_POINT, ParagraphNode, PositiveUniversalMeasure, Shading, TEXT_ALIGN_MAP, TWIPS_PER_INCH, TableCellNode, TableHeaderNode, TableNode, TableRowNode, TaskItemNode, TaskListNode, TextContent, TextNode, 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, convertShading, convertTable, convertTableCell, convertTableHeader, convertTableRow, convertTaskItem, convertTaskList, convertText, convertTextNodes, convertToDocxImageType, convertTwipToCssString, convertTwipToPixels, createFloatingOptions, createStringValidator, findChild, findDeepChild, findDeepChildren, generateDOCX, getImageDataAndMeta, getImageHeight, getImageTypeFromSrc, getImageWidth, normalizeHexColor, parseTwipAttr };

package/dist/index.mjs

@@ -438,6 +438,29 @@ function calculateEffectiveContentWidth(options) {
 	const effectiveWidth = pageWidth - marginLeft - marginRight;
 	return Math.max(convertTwipToPixels(effectiveWidth), 96);
 }
+/**
+* Convert Border to docx.js format
+*/
+function convertBorder(border) {
+	if (!border) return void 0;
+	const docxBorder = {};
+	if (border.color) docxBorder.color = border.color.replace("#", "");
+	if (border.size !== void 0) docxBorder.size = border.size;
+	if (border.style) docxBorder.style = border.style;
+	if (border.space !== void 0) docxBorder.space = border.space;
+	return Object.keys(docxBorder).length > 0 ? docxBorder : void 0;
+}
+/**
+* Convert Shading to docx.js format
+*/
+function convertShading(shading) {
+	if (!shading || !shading.fill) return void 0;
+	const docxShading = {};
+	if (shading.fill) docxShading.fill = shading.fill.replace("#", "");
+	if (shading.color) docxShading.color = shading.color.replace("#", "");
+	docxShading.val = shading.type || "clear";
+	return docxShading;
+}
 //#endregion
 //#region src/utils/image.ts
 const DEFAULT_MAX_IMAGE_WIDTH_PIXELS = 6.5 * 96;
@@ -600,52 +623,27 @@ async function getImageDataAndMeta(url) {
 */
 const applyParagraphStyleAttributes = (options, attrs) => {
 	if (!attrs) return options;
-	let result = { ...options };
-	if (attrs.indentLeft || attrs.indentRight || attrs.indentFirstLine) result = {
-		...result,
-		indent: {
-			...attrs.indentLeft && { left: convertPixelsToTwip(convertCssLengthToPixels(attrs.indentLeft)) },
-			...attrs.indentRight && { right: convertPixelsToTwip(convertCssLengthToPixels(attrs.indentRight)) },
-			...attrs.indentFirstLine && { firstLine: convertPixelsToTwip(convertCssLengthToPixels(attrs.indentFirstLine)) }
-		}
+	const result = { ...options };
+	if (attrs.indentLeft || attrs.indentRight || attrs.indentFirstLine) result.indent = {
+		...attrs.indentLeft && { left: convertPixelsToTwip(convertCssLengthToPixels(attrs.indentLeft)) },
+		...attrs.indentRight && { right: convertPixelsToTwip(convertCssLengthToPixels(attrs.indentRight)) },
+		...attrs.indentFirstLine && { firstLine: convertPixelsToTwip(convertCssLengthToPixels(attrs.indentFirstLine)) }
 	};
-	if (attrs.spacingBefore || attrs.spacingAfter) result = {
-		...result,
-		spacing: {
-			...attrs.spacingBefore && { before: convertPixelsToTwip(convertCssLengthToPixels(attrs.spacingBefore)) },
-			...attrs.spacingAfter && { after: convertPixelsToTwip(convertCssLengthToPixels(attrs.spacingAfter)) }
-		}
+	if (attrs.spacingBefore || attrs.spacingAfter) result.spacing = {
+		...attrs.spacingBefore && { before: convertPixelsToTwip(convertCssLengthToPixels(attrs.spacingBefore)) },
+		...attrs.spacingAfter && { after: convertPixelsToTwip(convertCssLengthToPixels(attrs.spacingAfter)) }
 	};
-	if (attrs.textAlign) result = {
-		...result,
-		alignment: TEXT_ALIGN_MAP.tiptapToDocx[attrs.textAlign]
+	if (attrs.textAlign) result.alignment = TEXT_ALIGN_MAP.tiptapToDocx[attrs.textAlign];
+	if (attrs.shading) result.shading = convertShading(attrs.shading);
+	if (attrs.borderTop || attrs.borderBottom || attrs.borderLeft || attrs.borderRight) result.border = {
+		...attrs.borderTop && { top: convertBorder(attrs.borderTop) },
+		...attrs.borderBottom && { bottom: convertBorder(attrs.borderBottom) },
+		...attrs.borderLeft && { left: convertBorder(attrs.borderLeft) },
+		...attrs.borderRight && { right: convertBorder(attrs.borderRight) }
 	};
 	return result;
 };
 //#endregion
-//#region src/utils/table.ts
-/**
-* Convert TipTap border to DOCX border format
-*
-* @param border - TipTap table cell border definition
-* @returns DOCX border options or undefined if no border
-*/
-function convertBorder(border) {
-	if (!border) return void 0;
-	const docxStyle = border.style ? {
-		solid: "single",
-		dashed: "dashed",
-		dotted: "dotted",
-		double: "double",
-		none: "none"
-	}[border.style] || "single" : "single";
-	return {
-		color: border.color?.replace("#", "") || "auto",
-		size: border.width ? border.width * 6 : 4,
-		style: docxStyle
-	};
-}
-//#endregion
 //#region src/converters/text.ts
 /**
 * Convert TipTap text node to DOCX TextRun or ExternalHyperlink
@@ -933,13 +931,16 @@ async function convertTableCell(node, params) {
 	}
 	if (node.attrs?.backgroundColor) cellOptions.shading = { fill: node.attrs.backgroundColor.replace("#", "") };
 	if (node.attrs?.verticalAlign) cellOptions.verticalAlign = node.attrs.verticalAlign === "middle" ? "center" : node.attrs.verticalAlign;
-	const borders = {
-		top: convertBorder(node.attrs?.borderTop),
-		bottom: convertBorder(node.attrs?.borderBottom),
-		left: convertBorder(node.attrs?.borderLeft),
-		right: convertBorder(node.attrs?.borderRight)
-	};
-	if (borders.top || borders.bottom || borders.left || borders.right) cellOptions.borders = borders;
+	const borders = {};
+	const top = convertBorder(node.attrs?.borderTop);
+	if (top) borders.top = top;
+	const bottom = convertBorder(node.attrs?.borderBottom);
+	if (bottom) borders.bottom = bottom;
+	const left = convertBorder(node.attrs?.borderLeft);
+	if (left) borders.left = left;
+	const right = convertBorder(node.attrs?.borderRight);
+	if (right) borders.right = right;
+	if (Object.keys(borders).length > 0) cellOptions.borders = borders;
 	return new TableCell(cellOptions);
 }
 //#endregion
@@ -973,13 +974,16 @@ async function convertTableHeader(node, params) {
 	}
 	if (node.attrs?.backgroundColor) headerCellOptions.shading = { fill: node.attrs.backgroundColor.replace("#", "") };
 	if (node.attrs?.verticalAlign) headerCellOptions.verticalAlign = node.attrs.verticalAlign === "middle" ? "center" : node.attrs.verticalAlign;
-	const borders = {
-		top: convertBorder(node.attrs?.borderTop),
-		bottom: convertBorder(node.attrs?.borderBottom),
-		left: convertBorder(node.attrs?.borderLeft),
-		right: convertBorder(node.attrs?.borderRight)
-	};
-	if (borders.top || borders.bottom || borders.left || borders.right) headerCellOptions.borders = borders;
+	const borders = {};
+	const top = convertBorder(node.attrs?.borderTop);
+	if (top) borders.top = top;
+	const bottom = convertBorder(node.attrs?.borderBottom);
+	if (bottom) borders.bottom = bottom;
+	const left = convertBorder(node.attrs?.borderLeft);
+	if (left) borders.left = left;
+	const right = convertBorder(node.attrs?.borderRight);
+	if (right) borders.right = right;
+	if (Object.keys(borders).length > 0) headerCellOptions.borders = borders;
 	return new TableCell(headerCellOptions);
 }
 //#endregion
@@ -1264,11 +1268,13 @@ async function generateDOCX(docJson, options) {
 * Convert document content to DOCX elements
 */
 async function convertDocument(node, params) {
-	const elements = [];
-	if (!node || !Array.isArray(node.content)) return elements;
+	if (!node || !Array.isArray(node.content)) return [];
 	const effectiveContentWidth = calculateEffectiveContentWidth(params.options);
-	for (const childNode of node.content) {
-		const element = await convertNode(childNode, params.options, effectiveContentWidth);
+	const convertedElements = await Promise.all(node.content.map((childNode) => convertNode(childNode, params.options, effectiveContentWidth)));
+	const elements = [];
+	for (let i = 0; i < convertedElements.length; i++) {
+		const element = convertedElements[i];
+		const childNode = node.content[i];
 		if (Array.isArray(element)) elements.push(...element);
 		else if (element) {
 			elements.push(element);
@@ -1292,6 +1298,7 @@ async function convertNode(node, options, effectiveContentWidth) {
 	if (Array.isArray(dataResult)) {
 		const styleId = getStyleIdByNodeType(node.type, options);
 		return dataResult.map((paragraphOptions) => {
+			if (!styleId) return new Paragraph(paragraphOptions);
 			return new Paragraph(applyStyleReference(paragraphOptions, styleId));
 		});
 	}
@@ -1299,6 +1306,7 @@ async function convertNode(node, options, effectiveContentWidth) {
 	if (!styleId && node.type === "paragraph" && node.content) {
 		if (node.content.length > 0 && node.content.every((child) => child.type === "image")) styleId = options.image?.style?.id;
 	}
+	if (!styleId) return createDOCXObject(dataResult);
 	return createDOCXObject(applyStyleReference(dataResult, styleId));
 }
 /**
@@ -1443,4 +1451,4 @@ function createDOCXObject(options) {
 	return new Paragraph(options);
 }
 //#endregion
-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 { 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, convertShading, convertTable, convertTableCell, convertTableHeader, convertTableRow, convertTaskItem, convertTaskList, convertText, convertTextNodes, convertToDocxImageType, convertTwipToCssString, convertTwipToPixels, createFloatingOptions, createStringValidator, findChild, findDeepChild, findDeepChildren, generateDOCX, getImageDataAndMeta, getImageHeight, getImageTypeFromSrc, getImageWidth, normalizeHexColor, parseTwipAttr };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@docen/export-docx",
-  "version": "0.0.12",
+  "version": "0.0.13",
   "description": "A powerful TipTap/ProseMirror extension that converts editor content to Microsoft Word DOCX format",
   "keywords": [
     "converter",
@@ -54,9 +54,9 @@
     "ofetch": "1.5.1"
   },
   "devDependencies": {
-    "@tiptap/core": "3.20.1",
-    "@docen/utils": "0.0.12",
-    "@docen/extensions": "0.0.12"
+    "@tiptap/core": "3.20.0",
+    "@docen/extensions": "0.0.13",
+    "@docen/utils": "0.0.13"
   },
   "scripts": {
     "dev": "basis build --stub",