npm - mdast2docx - Versions diffs - 0.0.0-beta.0 → 0.0.0 - Mend

mdast2docx 0.0.0-beta.0 → 0.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (36) hide show

package/README.md CHANGED Viewed

@@ -1,170 +1,203 @@
-# **MDAST (Markdown Abstract Syntax Tree) to DOCX** <img src="https://raw.githubusercontent.com/mayank1513/mayank1513/main/popper.png" style="height: 40px"/>
-🚀 **Effortlessly convert Markdown Abstract Syntax Trees (MDAST) to DOCX.**
-[![Test](https://github.com/tiny-md/mdast2docx/actions/workflows/test.yml/badge.svg)](https://github.com/tiny-md/mdast2docx/actions/workflows/test.yml) [![Maintainability](https://api.codeclimate.com/v1/badges/aa896ec14c570f3bb274/maintainability)](https://codeclimate.com/github/tiny-md/mdast2docx/maintainability) [![Code Coverage](https://codecov.io/gh/tiny-md/mdast2docx/graph/badge.svg)](https://codecov.io/gh/tiny-md/mdast2docx) [![Version](https://img.shields.io/npm/v/mdast2docx.svg?colorB=green)](https://www.npmjs.com/package/mdast2docx) [![Downloads](https://img.shields.io/npm/d18m/mdast2docx)](https://www.npmjs.com/package/mdast2docx) ![Bundle Size](https://img.shields.io/bundlephobia/minzip/mdast2docx)
----
-## **✨ Features**
-✅ **MDAST to DOCX conversion** — Supports standard Markdown elements
-✅ **Footnotes handling** — Converts Markdown footnotes to DOCX format
-✅ **Customizable image handling** — Fine-tune image rendering in DOCX
-✅ **Hyperlink support** — Converts external links, internal links [WIP]
-✅ **Configurable sections** — Customize document structure & styling
----
-## **📦 Installation**
-Install the package using `pnpm`, `npm`, or `yarn`:
-```bash
-pnpm add mdast2docx
-```
-**_or_**
-```bash
-npm install mdast2docx
-```
-**_or_**
-```bash
-yarn add mdast2docx
-```
----
-## **🚀 Usage**
-### **Basic Example**
-```typescript
-import { toDocx } from "mdast2docx";
-import { unified } from "unified";
-import remarkParse from "remark-parse";
-import remarkMmd from "remark-mmd"; // Assumed MMD plugin
-const markdown = `
-# Sample Document
-This is a **bold** text and _italic_ text.
-> A blockquote example
-- List Item 1
-- List Item 2
-[Click Here](https://example.com)
-![Sample Image](https://example.com/image.png)
-This is a footnote reference[^1].
-[^1]: This is the footnote content.
-`;
-const mdast = unified().use(remarkParse).use(remarkMmd).parse(markdown);
-(async () => {
-  const docxBlob = await toDocx(mdast, { title: "My Document" }, {});
-  const url = URL.createObjectURL(docxBlob as Blob);
-  const link = document.createElement("a");
-  link.href = url;
-  link.download = "document.docx";
-  link.click();
-  URL.revokeObjectURL(url);
-})();
-```
----
-## **🛠 API Reference**
-### **`toDocx(astInputs, docxProps, defaultSectionProps, outputType?)`**
-| Parameter                 | Type                                               | Description                                                      |
-| ------------------------- | -------------------------------------------------- | ---------------------------------------------------------------- |
-| `astInputs`               | `Root` \| `{ ast: Root; props?: ISectionProps }[]` | Single or multiple MDAST trees with optional section properties. |
-| `docxProps`               | `IDocxProps`                                       | General document properties (title, styles, metadata).           |
-| `defaultSectionProps`     | `ISectionProps`                                    | Default properties for document sections.                        |
-| `outputType` _(optional)_ | `"blob"` (default) \| `"buffer"` \| `"base64"`     | Format of the generated DOCX document.                           |
-📌 **Returns:** A `Promise` resolving to a DOCX document in the chosen format.
----
-## **📜 Supported Markdown Elements**
-| Markdown Syntax                    | Supported in DOCX      |
-| ---------------------------------- | ---------------------- |
-| Headings `# H1` to `###### H6`     | ✅                     |
-| Paragraphs                         | ✅                     |
-| Bold `**text**` & Italics `_text_` | ✅                     |
-| Blockquotes `> quote`              | ✅                     |
-| Lists (ordered & unordered)        | ✅                     |
-| Links `[text](url)`                | ✅                     |
-| Images `![alt](url)`               | ✅                     |
-| Code Blocks `` `code` ``           | ✅                     |
-| Footnotes `[^1]`                   | ✅                     |
-| Tables                             | 🚧 _(Coming soon)_     |
-| HTML Tags                          | 🚧 _(Partial support)_ |
----
-## **🔧 Configuration**
-You can customize the DOCX output using `ISectionProps` and `IDocxProps`.
-### **Example: Customizing Styles**
-```typescript
-const docxProps = {
-  title: "Styled Document",
-  author: "John Doe",
-};
-const sectionProps = {
-  page: { margin: { top: 1000, bottom: 1000, left: 1200, right: 1200 } },
-};
-const docxBlob = await toDocx(mdast, docxProps, sectionProps);
-```
-📖 **More details:**
-- [DOCX.js Document Properties](https://docx.js.org/#/usage/document)
-- [DOCX.js Section Options](https://docx.js.org/#/usage/sections)
----
-## **📝 Contributing**
-We welcome contributions! To get started:
-1. **Fork** the repository
-2. **Create a feature branch** (`git checkout -b feature-new`)
-3. **Commit your changes** (`git commit -m "Add new feature"`)
-4. **Push to GitHub** (`git push origin feature-new`)
-5. **Open a Pull Request** 🚀
----
-## **📄 License**
-This project is **licensed under MPL-2.0**. See the [LICENSE](./LICENSE) file for details.
----
-## **🙌 Acknowledgments**
-Thanks to the **docx.js** and **unified.js** ecosystems for making this possible.
-> ⭐ **Star this repository** if you find it useful!
-> ❤️ Support our work by [sponsoring](https://github.com/sponsors/mayank1513).
----
-<p align="center">Made with 💖 by <a href="https://mayank-chaudhari.vercel.app" target="_blank">Mayank Kumar Chaudhari</a></p>
+# **MDAST (Markdown Abstract Syntax Tree) to DOCX** <img src="https://raw.githubusercontent.com/mayank1513/mayank1513/main/popper.png" style="height: 40px"/>
+🚀 **Effortlessly convert Markdown Abstract Syntax Trees (MDAST) to DOCX.**
+[![Test](https://github.com/tiny-md/mdast2docx/actions/workflows/test.yml/badge.svg)](https://github.com/tiny-md/mdast2docx/actions/workflows/test.yml) [![Maintainability](https://api.codeclimate.com/v1/badges/aa896ec14c570f3bb274/maintainability)](https://codeclimate.com/github/tiny-md/mdast2docx/maintainability) [![Code Coverage](https://codecov.io/gh/tiny-md/mdast2docx/graph/badge.svg)](https://codecov.io/gh/tiny-md/mdast2docx) [![Version](https://img.shields.io/npm/v/mdast2docx.svg?colorB=green)](https://www.npmjs.com/package/mdast2docx) [![Downloads](https://img.shields.io/npm/d18m/mdast2docx)](https://www.npmjs.com/package/mdast2docx) ![Bundle Size](https://img.shields.io/bundlephobia/minzip/mdast2docx)
+---
+## **✨ Features**
+✅ **MDAST to DOCX conversion** — Supports standard Markdown elements
+✅ **Footnotes handling** — Converts Markdown footnotes to DOCX format
+✅ **Tables support** — Converts Markdown tables into DOCX tables
+✅ **Hyperlink support** — External and internal hyperlinks are now fully functional
+✅ **New Plugin Architecture** — Extend and customize DOCX output with plugins
+✅ **Customizable image handling** — Images are now supported via `imagePlugin`
+> **Note:** Images are no longer supported by default. To enable image support, use the `imagePlugin` explicitly.
+>
+> This change helps us keep the library lean and extensible by community via plugins.
+---
+## **📦 Installation**
+Install the package using `pnpm`, `npm`, or `yarn`:
+```bash
+pnpm add mdast2docx
+```
+**_or_**
+```bash
+npm install mdast2docx
+```
+**_or_**
+```bash
+yarn add mdast2docx
+```
+---
+## **🚀 Usage**
+### **Basic Example**
+```typescript
+import { toDocx } from "mdast2docx";
+import { unified } from "unified";
+import remarkParse from "remark-parse";
+import remarkMmd from "remark-mmd"; // Assumed MMD plugin
+const markdown = `
+# Sample Document
+This is a **bold** text and _italic_ text.
+> A blockquote example
+- List Item 1
+- List Item 2
+[Click Here](https://example.com)
+This is a footnote reference[^1].
+[^1]: This is the footnote content.
+`;
+const mdast = unified().use(remarkParse).use(remarkMmd).parse(markdown);
+(async () => {
+  const docxBlob = await toDocx(mdast, { title: "My Document" }, {});
+  const url = URL.createObjectURL(docxBlob as Blob);
+  const link = document.createElement("a");
+  link.href = url;
+  link.download = "document.docx";
+  link.click();
+  URL.revokeObjectURL(url);
+})();
+```
+---
+## **📜 API Reference**
+### **`toDocx(astInputs, docxProps, defaultSectionProps, outputType?)`**
+| Parameter                 | Type                                               | Description                                                      |
+| ------------------------- | -------------------------------------------------- | ---------------------------------------------------------------- |
+| `astInputs`               | `Root` \| `{ ast: Root; props?: ISectionProps }[]` | Single or multiple MDAST trees with optional section properties. |
+| `docxProps`               | `IDocxProps`                                       | General document properties (title, styles, metadata).           |
+| `defaultSectionProps`     | `ISectionProps`                                    | Default properties for document sections.                        |
+| `outputType` _(optional)_ | `"blob"` (default) \| `"buffer"` \| `"base64"`     | Format of the generated DOCX document.                           |
+📌 **Returns:** A `Promise` resolving to a DOCX document in the chosen format.
+---
+## **📜 Supported Markdown Elements**
+| Markdown Syntax                    | Supported in DOCX                     |
+| ---------------------------------- | ------------------------------------- |
+| Headings `# H1` to `###### H6`     | ✅                                    |
+| Paragraphs                         | ✅                                    |
+| Bold `**text**` & Italics `_text_` | ✅                                    |
+| Blockquotes `> quote`              | ✅                                    |
+| Lists (ordered & unordered)        | ✅ _(ordered lists via `listPlugin`)_ |
+| Links `[text](url)`                | ✅                                    |
+| Images `![alt](url)`               | ✅ _(via `imagePlugin`)_              |
+| Code Blocks `` `code` ``           | ✅                                    |
+| Footnotes `[^1]`                   | ✅                                    |
+| Tables                             | ✅ _(via `tablePlugin`)_              |
+| Hyperlinks (external & internal)   | ✅                                    |
+| HTML Tags                          | 🚧 _(Work in progress)_               |
+---
+## **🔧 Configuration**
+You can customize the DOCX output using `ISectionProps` and `IDocxProps`.
+### **Example: Customizing Styles**
+```typescript
+const docxProps = {
+  title: "Styled Document",
+  author: "John Doe",
+};
+const sectionProps = {
+  page: { margin: { top: 1000, bottom: 1000, left: 1200, right: 1200 } },
+};
+const docxBlob = await toDocx(mdast, docxProps, sectionProps);
+```
+### **Use Plugins**
+Plugins allow extending functionality like adding image or table support.
+```typescript
+import { toDocx } from "mdast2docx";
+import { imagePlugin, tablePlugin, listPlugin, mathPlugin } from "mdast2docx/dist/plugins";
+const downloadDocx = () => {
+  toDocx(
+    mdast,
+    {},
+    { plugins: [imagePlugin(), tablePlugin(), listPlugin(), mathPlugin()] },
+    "blob",
+  ).then(blob => {
+    const url = URL.createObjectURL(blob as Blob);
+    const link = document.createElement("a");
+    link.href = url;
+    link.download = "my-document.docx";
+    link.click();
+    URL.revokeObjectURL(url);
+  });
+};
+```
+📖 **More details:**
+- [DOCX.js Document Properties](https://docx.js.org/#/usage/document)
+- [DOCX.js Section Options](https://docx.js.org/#/usage/sections)
+---
+## **📝 Contributing**
+We welcome contributions! To get started:
+1. **Fork** the repository
+2. **Create a feature branch** (`git checkout -b feature-new`)
+3. **Commit your changes** (`git commit -m "Add new feature"`)
+4. **Push to GitHub** (`git push origin feature-new`)
+5. **Open a Pull Request** 🚀
+### **Extend Functionality with Plugins**
+The community can create plugins to extend the functionality of this library. For inspiration, check out the existing plugins in the [`lib/src/plugins`](https://github.com/tiny-md/mdast2docx/tree/main/lib/src/plugins) folder.
+---
+## **📄 License**
+This project is **licensed under MPL-2.0**. See the [LICENSE](./LICENSE) file for details.
+---
+## **🙌 Acknowledgments**
+Thanks to the **docx.js** and **unified.js** ecosystems for making this possible.
+> ⭐ **Star this repository** if you find it useful!
+> ❤️ Support our work by [sponsoring](https://github.com/sponsors/mayank1513).
+---
+<p align="center">Made with 💖 by <a href="https://mayank-chaudhari.vercel.app" target="_blank">Mayank Kumar Chaudhari</a></p>

package/dist/chunk-KPLOM3EF.mjs ADDED Viewed

	@@ -0,0 +1,2 @@
1	+ import{b as C,d as N}from"./chunk-YKZOUIFR.mjs";import{Bookmark as D,BorderStyle as S,ExternalHyperlink as B,FootnoteReferenceRun as R,InternalHyperlink as v,Paragraph as m,TextRun as f}from"@mayank1513/docx";import*as g from"@mayank1513/docx";var T=(w,h,P)=>{let y=async(o,c)=>{var e,l,n;let t=Object.assign({},c),s=(await Promise.all(P.map(r=>{var d,p;return(p=(d=r.inline)==null?void 0:d.call(r,g,o,t,w,h,a))!=null?p:[]}))).flat(),i=(l=o.url)!=null?l:w[(e=o.identifier)==null?void 0:e.toUpperCase()];switch(o.type){case"text":return[...s,new f({text:o.value,...t})];case"break":return[...s,new f({break:1})];case"inlineCode":return[...s,new f({text:o.value,...t,style:"code",font:{name:"Consolas"}})];case"emphasis":return t.italics=!0,[...s,...await a(o,t)];case"strong":return t.bold=!0,[...s,...await a(o,t)];case"delete":return t.strike=!0,[...s,...await a(o,t)];case"link":case"linkReference":return[...s,i.startsWith("#")?new v({anchor:i.slice(1),children:await a(o,t)}):new B({link:i,children:await a(o,t)})];case"footnoteReference":return[...s,new R((n=h[o.identifier].id)!=null?n:0)];default:return[...s]}},a=async(o,c=new Set)=>{var t;return(await Promise.all((t=o.children)==null?void 0:t.map(s=>y(s,c)))).flat()};return a},H=async(w,h,P,y)=>{let{plugins:a,useTitle:o,...c}={...N,...y},t=T(h,P,a),s=async(e,l)=>{var d,p,k,I;let n=Object.assign({},l),r=(await Promise.all(a.map(u=>{var b,x;return(x=(b=u.block)==null?void 0:b.call(u,g,e,n,i,t))!=null?x:[]}))).flat();switch(e.type){case"paragraph":return[...r,new m({...l,children:await t(e)})];case"heading":return[new m({...r,heading:o?e.depth===1?"Title":`Heading${e.depth-1}`:`Heading${e.depth}`,children:[new D({id:C(e).replace(/[. ]+/g,"-").toLowerCase(),children:await t(e)})]})];case"code":return[...r,new m({alignment:"start",style:"blockCode",children:e.value.split(`
2	+ `).map(u=>new f({text:u,break:1,style:"code",font:{name:"Consolas"}}))})];case"list":return e.ordered?(n.bullet={level:((p=(d=n.bullet)==null?void 0:d.level)!=null?p:-1)+1},console.warn("Please add numbering plugin to support ordered lists. For now, we use only bullets for both the ordered and the unordered list.")):n.bullet={level:((I=(k=n.bullet)==null?void 0:k.level)!=null?I:-1)+1},[...r,...await i(e,n)];case"blockquote":return[...r,...await i(e,n)];case"listItem":return[...r,...await i(e,n)];case"thematicBreak":return[...r,new m({border:{top:{style:S.SINGLE,size:6}}})];case"definition":case"footnoteDefinition":return r;case"table":return console.warn("Please add table plugin to support tables."),r;case"":return r;case"yaml":case"html":default:return console.warn(`Unsupported node type: ${e.type}`,e),r}},i=async(e,l)=>{var n;return(await Promise.all((n=e.children)==null?void 0:n.map(r=>s(r,l)))).flat()};return{...c,children:await i(w,{})}};export{H as a};

package/dist/chunk-RFHTB4AU.mjs ADDED Viewed

	@@ -0,0 +1 @@
1	+ var r=()=>({inline:async(t,n)=>{var e;return n.type!=="inlineMath"?[]:(console.log("inline math",n.value),[new t.MathRun((e=n.value)!=null?e:"")])},block:async(t,n,e)=>{var a;return n.type!=="math"?[]:[new t.Paragraph({...e,children:[new t.MathRun((a=n.value)!=null?a:"")]})]}});export{r as a};

package/dist/chunk-TASCVLMX.mjs ADDED Viewed

@@ -0,0 +1 @@

+ import{c as g}from"./chunk-YKZOUIFR.mjs";import{AlignmentType as v,convertInchesToTwip as O,LevelFormat as e}from"@mayank1513/docx";var E=[e.DECIMAL,e.DECIMAL,e.DECIMAL,e.DECIMAL,e.UPPER_LETTER,e.LOWER_LETTER,e.LOWER_ROMAN,e.UPPER_ROMAN],b=(c,o=.4,u=.25)=>c.map((i,t)=>({level:t,format:i,text:(i===e.DECIMAL?Array(t+1).fill(`%${t+1}`).join("."):`%${t+1}`)+".",alignment:v.START,style:{paragraph:{indent:{left:O(o+t*u)}}}})),R=b(E),y=["\u25CF","\u25CB","\u25A0","\u25C6","\u25B6","\u25C9","\u2B24","\u2666","\u25E6","\u25AA"],A={levels:R,bullets:y,defaultBullets:!1},x=c=>{let o=g(),u=`numbering-${o}`,i=`bullet-${o}`,{levels:t,bulletLevels:f,bullets:m,defaultBullets:I}={...A,...c};return{block:async(L,l,n,a)=>{var s,p;if(l.type!=="list")return[];let r=((p=(s=n.bullet)==null?void 0:s.level)!=null?p:-1)+1;return n.numbering=I?void 0:{level:r,reference:l.ordered?u:i},n.bullet={level:r},l.type="",await a(l,n)},root:L=>{var l,n;L.numbering={config:[...(n=(l=L.numbering)==null?void 0:l.config)!=null?n:[],{reference:u,levels:t},{reference:i,levels:f!=null?f:t.map((a,r)=>{var s;return{...a,text:(s=m[r])!=null?s:"\u2022",format:e.BULLET}})}]}}}};export{b as a,x as b};

package/dist/chunk-UXY5TDOP.mjs ADDED Viewed

@@ -0,0 +1 @@

+ import{BorderStyle as I,ShadingType as C,WidthType as O,AlignmentType as E,VerticalAlign as D,convertMillimetersToTwip as r}from"@mayank1513/docx";var e={style:I.SINGLE,color:"auto",size:1},V={tableProps:{width:{size:100,type:O.PERCENTAGE},margins:{top:r(2),right:r(4),bottom:r(2),left:r(4)},borders:{top:e,right:e,bottom:e,left:e,insideHorizontal:e,insideVertical:e}},rowProps:{},cellProps:{},firstRowProps:{tableHeader:!0},firstRowCellProps:{shading:{type:C.SOLID,fill:"b79c2f"}},alignments:{defaultVerticalAlign:D.CENTER,defaultHorizontalAlign:E.CENTER,preferMdData:!0}},N=s=>({block:async(l,t,z,H,P)=>{var a;if(t.type!=="table")return[];let{Table:c,TableRow:f,TableCell:g,Paragraph:T}=l,{tableProps:b,firstRowProps:u,firstRowCellProps:m,rowProps:w,cellProps:y,alignments:o}={...V,...s},i=(a=t.align)==null?void 0:a.map(n=>{switch(n){case"left":return l.AlignmentType.LEFT;case"right":return l.AlignmentType.RIGHT;case"center":return l.AlignmentType.CENTER;default:return}}),d=async(n,p)=>new f({...w,...p===0?u:{},children:await Promise.all(n.children.map(async(A,h)=>new g({verticalAlign:o.defaultVerticalAlign,...y,...p===0?m:{},children:[new T({children:await P(A),alignment:o.preferMdData?i==null?void 0:i[h]:o.defaultHorizontalAlign})]})))}),R=await Promise.all(t.children.map(d));return t.type="",[new c({...b,rows:R})]}});export{V as a,N as b};

package/dist/chunk-XY2A2A66.mjs ADDED Viewed

@@ -0,0 +1 @@

+ var c=a=>{let e=new Uint8Array(a).slice(0,4);if(e[0]===66&&e[1]===77)return"bmp";switch(e.reduce((r,n)=>r+n.toString(16).padStart(2,"0"),"")){case"89504E47":return"png";case"47494638":return"gif";case"FFD8FFE0":case"FFD8FFE1":case"FFD8FFE2":case"FFD8FFE3":case"FFD8FFE8":return"jpg"}},p=3,u=async(a,e)=>{let t=document.createElement("canvas"),r=t.getContext("2d");if(!r)throw new Error("Canvas context not available");let n=new Image;n.src=a,await new Promise(o=>n.onload=o);let i=n.width*e,s=n.height*e;return t.width=i,t.height=s,r.drawImage(n,0,0,i,s),{data:t.toDataURL("image/png"),type:"png",transformation:{width:i/e,height:s/e}}},h=async a=>{let t=await(await fetch(a)).arrayBuffer(),r=c(t)||"png",n=await createImageBitmap(new Blob([t],{type:r}));return{type:r,data:t,transformation:{width:n.width,height:n.height}}},l=async(a,e)=>{var t;try{return a.startsWith("data:")?await u(a,(t=e==null?void 0:e.scale)!=null?t:p):await h(a)}catch(r){return console.error(`Error resolving image: ${a}`,r),{type:"png",data:Buffer.from([]),transformation:{width:100,height:100}}}},I=a=>({inline:async(e,t,r,n)=>{var i,s,o;if(/^image/.test(t.type)){let g=(s=t.url)!=null?s:n[(i=t.identifier)==null?void 0:i.toUpperCase()],m=(o=t.alt)!=null?o:g==null?void 0:g.split("/").pop();return t.type="",[new e.ImageRun({...await l(g,a),altText:{description:m,name:m,title:m}})]}return[]}});export{c as a,I as b};

package/dist/chunk-YKZOUIFR.mjs ADDED Viewed

@@ -0,0 +1 @@

+ import{convertInchesToTwip as d,convertMillimetersToTwip as P}from"@mayank1513/docx";var i=o=>{let t={},n={};return o.forEach(e=>{var r;e.type==="definition"?t[e.identifier.toUpperCase()]=e.url:e.type==="footnoteDefinition"?n[e.identifier.toUpperCase()]={children:e.children}:(r=e.children)!=null&&r.length&&Object.assign(t,i(e.children))}),{definitions:t,footnoteDefinitions:n}},s=o=>{var t,n;return(t=o.children)!=null&&t.length?o.children.map(s).join(""):(n=o.value)!=null?n:""},p=()=>Math.random().toString(16).slice(2),a={useTitle:!0,plugins:[]};export{i as a,s as b,p as c,a as d,d as e,P as f};

package/dist/index.d.ts CHANGED Viewed

@@ -1,13 +1,12 @@
-import { OutputType, type IPropertiesOptions } from "@mayank1513/docx";
+import { OutputType } from "@mayank1513/docx";
 import type { Root } from "mdast";
 import { type ISectionProps } from "./section";
+import { IDocxProps } from "./utils";
 /**
- * Defines document properties, excluding sections and footnotes (which are managed internally).
- */
-type IDocxProps = Omit<IPropertiesOptions, "sections" | "footnotes">;
-/**
- * Represents the input MDAST tree(s) for conversion.
- * It can be a single root node or an array of objects containing the AST and optional section properties.
+ * Represents the input Markdown AST tree(s) for conversion.
+ * Supports either:
+ * - A single `Root` node (direct conversion)
+ * - An array of objects `{ ast: Root, props?: ISectionProps }` for fine-grained section-level control.
  */
 type IInputMDAST = Root | {
     ast: Root;
@@ -21,5 +20,5 @@ type IInputMDAST = Root | {
  * @param outputType - The desired output format (default: `"blob"`). @see https://docx.js.org/#/usage/packers
  * @returns A DOCX document in the specified format.
  */
-export declare const toDocx: (astInputs: IInputMDAST, docxProps: IDocxProps, defaultSectionProps: ISectionProps, outputType?: OutputType) => Promise<string | ArrayBuffer | Buffer<ArrayBufferLike> | Uint8Array<ArrayBufferLike> | Blob | readonly number[]>;
+export declare const toDocx: (astInputs: IInputMDAST, docxProps?: IDocxProps, defaultSectionProps?: ISectionProps, outputType?: OutputType) => Promise<string | readonly number[] | ArrayBuffer | Uint8Array<ArrayBufferLike> | Blob | Buffer<ArrayBufferLike>>;
 export type { ISectionProps, IDocxProps, IInputMDAST };