@docen/export-docx 0.0.10 → 0.0.12

package/dist/index.mjs

@@ -1 +1,1446 @@
-import{TextRun as f,ExternalHyperlink as $t,ImageRun as Z,HeadingLevel as b,Paragraph as I,TableCell as tt,TableRow as zt,Table as B,PageBreak as jt,TableOfContents as Gt,Document as Ut,Packer as Xt,AlignmentType as et,LevelFormat as nt,convertInchesToTwip as _}from"docx";import{imageMeta as O}from"image-meta";import{ofetch as qt}from"ofetch";const W=96,$=1440,Kt=914400,rt=1.5,Yt=.6666666666666666,P="Consolas",z={checked:"\u2611",unchecked:"\u2610"},Vt={CODE_BLOCK:"CodeBlock",CODE_PREFIX:"Code"},ot={tiptapToDocx:{left:"left",right:"right",center:"center",justify:"both"},docxToTipTap:{left:"left",right:"right",center:"center",both:"justify"}},j={A4_WIDTH_TWIP:11906,DEFAULT_MARGIN_TWIP:1440},M=96;function E(t){return Math.round(t*M/1440)}function Jt(t){return`${E(t)}px`}function g(t){return Math.round(t*(1440/M))}function at(t){return Math.round(t/(914400/M))}function Qt(t){return Math.round(t*(914400/M))}function Zt(t){const e=parseInt(t,10);if(!isNaN(e))return at(e)}const te=/^(-?[\d.]+)(px|pt|em|rem|%|)?$/,ee={px:1,pt:1.333,em:16,rem:16,"%":.16};function m(t){if(!t)return 0;t=t.trim();const e=t.match(te);if(!e)return 0;const n=parseFloat(e[1]);if(isNaN(n))return 0;const o=e[2]||"px",r=ee[o]??1;return Math.round(n*r)}const ne=/^([\d.]+)(in|mm|cm|pt|pc|pi)$/,re={in:1,mm:1/25.4,cm:1/2.54,pt:1/72,pc:1/6,pi:1/6};function S(t){if(typeof t=="number")return t;const e=t.match(ne);if(e){const o=parseFloat(e[1]),r=e[2],a=re[r];return a!==void 0?o*a:o}const n=parseFloat(t);return isNaN(n)?6.5:n}function G(t){if(typeof t=="number")return t;const e=S(t);return Math.round(e*96)}const it={black:"#000000",white:"#FFFFFF",red:"#FF0000",green:"#008000",blue:"#0000FF",yellow:"#FFFF00",orange:"#FFA500",purple:"#800080",pink:"#FFC0CB",brown:"#A52A2A",gray:"#808080",grey:"#808080",cyan:"#00FFFF",magenta:"#FF00FF",lime:"#00FF00",navy:"#000080",teal:"#008080",maroon:"#800000",olive:"#808000",silver:"#C0C0C0",gold:"#FFD700",indigo:"#4B0082",violet:"#EE82EE",aqua:"#00FFFF",fuchsia:"#FF00FF",darkblue:"#00008B",darkcyan:"#008B8B",darkgrey:"#A9A9A9",darkgreen:"#006400",darkkhaki:"#BDB76B",darkmagenta:"#8B008B",darkolivegreen:"#556B2F",darkorange:"#FF8C00",darkorchid:"#9932CC",darkred:"#8B0000",darksalmon:"#E9967A",darkviolet:"#9400D3",lightblue:"#ADD8E6",lightcyan:"#E0FFFF",lightgreen:"#90EE90",lightgrey:"#D3D3D3",lightpink:"#FFB6C1",lightyellow:"#FFFFE0"};function U(t){if(t)return t.startsWith("#")?t:it[t.toLowerCase()]||t}function oe(t){return t.startsWith("#")?t:`#${t}`}function ae(t,e){if(!t.children)return null;for(const n of t.children)if(n.type==="element"&&n.name===e)return n;return null}function st(t,e){if(!t.children)return null;for(const n of t.children)if(n.type==="element"){if(n.name===e)return n;const o=st(n,e);if(o)return o}return null}function ct(t,e){const n=[];if(!t.children)return n;for(const o of t.children)o.type==="element"&&(o.name===e&&n.push(o),n.push(...ct(o,e)));return n}function ie(t,e){const n=t[e];if(!n)return;const o=parseInt(n,10);if(!isNaN(o))return n}function se(t){return e=>t.includes(e)}const lt=(t,e)=>t?typeof t=="number"?t:Math.round(S(t)*$):e;function dt(t){const e=j.A4_WIDTH_TWIP,n=j.DEFAULT_MARGIN_TWIP;if(!t?.sections?.length)return E(e-n*2);const o=t.sections[0];if(!o.properties?.page)return E(e-n*2);const r=o.properties.page;let a=e;if(r.size?.width){const d=r.size.width;a=typeof d=="number"?d:Math.round(S(d)*$)}const i=r.margin,l=lt(i?.left,n),u=lt(i?.right,n),c=a-l-u;return Math.max(E(c),W)}const ut=6.5*W,N={mimeToInternal:{jpg:"jpeg",jpeg:"jpeg",png:"png",gif:"gif",bmp:"bmp",tiff:"tiff"},internalToDocx:{jpeg:"jpg",png:"png",gif:"gif",bmp:"bmp",tiff:"bmp"}};function pt(t){if(!t)return"png";const e=t.toLowerCase(),n=N.mimeToInternal[e]||"png";return N.internalToDocx[n]||"png"}function H(t){if(t.startsWith("data:")){const e=t.match(/data:image\/(\w+);/);if(e){const n=e[1].toLowerCase();return N.mimeToInternal[n]||"png"}}else{const e=t.split(".").pop()?.toLowerCase();if(e)return N.mimeToInternal[e]||"png"}return"png"}const ht=(t,e=ut)=>{if(!t.width||!t.height)return{width:e,height:Math.round(e*.75)};if(t.width<=e)return{width:t.width,height:t.height};const n=e/t.width;return{width:e,height:Math.round(t.height*n)}};function ce(){return{horizontalPosition:{relative:"page",align:"center"},verticalPosition:{relative:"page",align:"top"},lockAnchor:!0,behindDocument:!1,inFrontOfText:!1}}function ft(t,e,n){if(t.attrs?.width!==void 0&&t.attrs?.width!==null)return t.attrs.width;const o=n!==void 0?G(n):void 0;return e?.width&&e?.height?ht(e,o).width:o||ut}function gt(t,e,n,o){if(t.attrs?.height!==void 0&&t.attrs?.height!==null)return t.attrs.height;const r=o!==void 0?G(o):void 0;return n?.width&&n?.height?ht(n,r).height:Math.round(e*.75)}async function mt(t){try{const e=await(await qt(t,{responseType:"blob"})).bytes();let n;try{n=O(e)}catch(o){console.warn("Failed to extract image metadata:",o),n={width:void 0,height:void 0,type:H(t)||"png",orientation:void 0}}return{data:e,meta:n}}catch(e){throw console.warn(`Failed to fetch image from ${t}:`,e),e}}const X=(t,e)=>{if(!e)return t;let n={...t};return(e.indentLeft||e.indentRight||e.indentFirstLine)&&(n={...n,indent:{...e.indentLeft&&{left:g(m(e.indentLeft))},...e.indentRight&&{right:g(m(e.indentRight))},...e.indentFirstLine&&{firstLine:g(m(e.indentFirstLine))}}}),(e.spacingBefore||e.spacingAfter)&&(n={...n,spacing:{...e.spacingBefore&&{before:g(m(e.spacingBefore))},...e.spacingAfter&&{after:g(m(e.spacingAfter))}}}),e.textAlign&&(n={...n,alignment:ot.tiptapToDocx[e.textAlign]}),n};function p(t){if(!t)return;const e={solid:"single",dashed:"dashed",dotted:"dotted",double:"double",none:"none"},n=t.style&&e[t.style]||"single",o=t.color?.replace("#","")||"auto",r=t.width?t.width*6:4;return{color:o,size:r,style:n}}function T(t){const e=t.marks?.some(s=>s.type==="bold"),n=t.marks?.some(s=>s.type==="italic"),o=t.marks?.some(s=>s.type==="underline"),r=t.marks?.some(s=>s.type==="strike"),a=t.marks?.some(s=>s.type==="code"),i=t.marks?.some(s=>s.type==="subscript"),l=t.marks?.some(s=>s.type==="superscript"),u=t.marks?.find(s=>s.type==="link"),c=t.marks?.find(s=>s.type==="textStyle"),d=t.marks?.some(s=>s.type==="highlight"),y=U(c?.attrs?.color),h=U(c?.attrs?.backgroundColor);let F;if(c?.attrs?.fontSize){const s=c.attrs.fontSize;if(s.endsWith("px")){const A=parseFloat(s);isNaN(A)||(F=Math.round(A*rt))}}let w;a?w=P:c?.attrs?.fontFamily&&(w=c.attrs.fontFamily);const v={text:t.text||"",bold:e||void 0,italics:n||void 0,underline:o?{}:void 0,strike:r||void 0,font:w,size:F,subScript:i||void 0,superScript:l||void 0,color:y,shading:h?{fill:h}:void 0,highlight:d?"yellow":void 0};return u?.attrs?.href?new $t({children:[new f({...v,style:"Hyperlink"})],link:u.attrs.href}):new f(v)}function k(t){const e={text:"",break:1};if(t)for(const n of t)switch(n.type){case"bold":e.bold=!0;break;case"italic":e.italics=!0;break;case"underline":e.underline={};break;case"strike":e.strike=!0;break;case"textStyle":n.attrs?.color&&(e.color=n.attrs.color);break}return new f(e)}function q(t=[]){return t.flatMap(e=>e.type==="text"?[T(e)]:e.type==="hardBreak"?[k(e.marks)]:[])}async function K(t,e){const n=c=>{const d=c||H(t.attrs?.src||"");return pt(d)};let o,r;try{const c=t.attrs?.src||"";if(e?.handler){o=await e.handler(c);try{r=O(o)}catch{r={type:H(c),width:void 0,height:void 0,orientation:void 0}}}else if(c.startsWith("http")){const d=await mt(c);o=d.data,r=d.meta}else if(c.startsWith("data:")){const d=c.split(",")[1];if(!d)throw new Error("Invalid data URL: missing base64 data");const y=atob(d);o=Uint8Array.from(y,h=>h.charCodeAt(0));try{r=O(o)}catch{r={type:"png",width:void 0,height:void 0,orientation:void 0}}}else throw new Error(`Unsupported image source format: ${c.substring(0,20)}...`)}catch(c){return console.warn("Failed to process image:",c),new Z({type:"png",data:new Uint8Array(0),transformation:{width:100,height:100},altText:{name:t.attrs?.alt||"Failed to load image"}})}const a=ft(t,r,e?.maxWidth),i=gt(t,a,r,e?.maxWidth),l={width:a,height:i};t.attrs?.rotation!==void 0&&(l.rotation=t.attrs.rotation);const u={...e?.options,type:n(r.type),data:o,transformation:l,altText:{name:t.attrs?.alt||"",description:void 0,title:t.attrs?.title||void 0},...t.attrs?.floating&&{floating:t.attrs.floating},...t.attrs?.outline&&{outline:t.attrs.outline}};return new Z(u)}async function C(t,e){const{options:n,image:o}=e||{},r=[];for(const i of t.content||[])if(i.type==="text")r.push(T(i));else if(i.type==="hardBreak")r.push(k(i.marks));else if(i.type==="image"){const l=await K(i,{maxWidth:o?.maxWidth,options:o?.options,handler:o?.handler});r.push(l)}let a={children:r};return n&&(a={...a,...n}),t.attrs&&(a=X(a,t.attrs)),a}function yt(t){const e=t?.attrs?.level,n=q(t.content).filter(a=>a!==void 0),o={1:b.HEADING_1,2:b.HEADING_2,3:b.HEADING_3,4:b.HEADING_4,5:b.HEADING_5,6:b.HEADING_6};let r={children:n,heading:o[e]};return t.attrs&&(r=X(r,t.attrs)),r}function wt(t){return t.content?t.content.map(e=>e.type==="paragraph"?{children:e.content?.flatMap(n=>n.type==="text"?T(n):n.type==="hardBreak"?k(n.marks):[])||[],indent:{left:720},border:{left:{style:"single"}}}:{}):[]}async function vt(t,e){const{options:n}=e;let o=n?.cell?.paragraph??n?.row?.paragraph??{};n?.style&&(o={...o,style:n.style.id});const r={children:(await Promise.all((t.content||[]).map(i=>C(i,{options:o})))).map(i=>new I(i)),...n?.cell?.run};if(t.attrs?.colspan&&t.attrs.colspan>1&&(r.columnSpan=t.attrs.colspan),t.attrs?.rowspan&&t.attrs.rowspan>1&&(r.rowSpan=t.attrs.rowspan),t.attrs?.colwidth!==null&&t.attrs?.colwidth!==void 0){const i=Array.isArray(t.attrs.colwidth)?t.attrs.colwidth[0]:t.attrs.colwidth;if(i&&i>0){const l=Math.round(i*15);r.width={size:l,type:"dxa"}}}if(t.attrs?.backgroundColor){const i=t.attrs.backgroundColor.replace("#","");r.shading={fill:i}}if(t.attrs?.verticalAlign){const i=t.attrs.verticalAlign==="middle"?"center":t.attrs.verticalAlign;r.verticalAlign=i}const a={top:p(t.attrs?.borderTop),bottom:p(t.attrs?.borderBottom),left:p(t.attrs?.borderLeft),right:p(t.attrs?.borderRight)};return(a.top||a.bottom||a.left||a.right)&&(r.borders=a),new tt(r)}async function bt(t,e){const{options:n}=e;let o=n?.header?.paragraph??n?.cell?.paragraph??n?.row?.paragraph??{};n?.style&&(o={...o,style:n.style.id});const r={children:(await Promise.all((t.content||[]).map(i=>C(i,{options:o})))).map(i=>new I(i)),...n?.header?.run};if(t.attrs?.colspan&&t.attrs.colspan>1&&(r.columnSpan=t.attrs.colspan),t.attrs?.rowspan&&t.attrs.rowspan>1&&(r.rowSpan=t.attrs.rowspan),t.attrs?.colwidth!==null&&t.attrs?.colwidth!==void 0){const i=Array.isArray(t.attrs.colwidth)?t.attrs.colwidth[0]:t.attrs.colwidth;if(i&&i>0){const l=Math.round(i*15);r.width={size:l,type:"dxa"}}}if(t.attrs?.backgroundColor){const i=t.attrs.backgroundColor.replace("#","");r.shading={fill:i}}if(t.attrs?.verticalAlign){const i=t.attrs.verticalAlign==="middle"?"center":t.attrs.verticalAlign;r.verticalAlign=i}const a={top:p(t.attrs?.borderTop),bottom:p(t.attrs?.borderBottom),left:p(t.attrs?.borderLeft),right:p(t.attrs?.borderRight)};return(a.top||a.bottom||a.left||a.right)&&(r.borders=a),new tt(r)}async function Tt(t,e){const{options:n}=e,o=n?.row,r={children:(await Promise.all((t.content||[]).map(async a=>a.type==="tableCell"?await vt(a,e):a.type==="tableHeader"?await bt(a,e):null))).filter(a=>a!==void 0),...o};if(t.attrs?.rowHeight){const a=m(t.attrs.rowHeight),i=g(a);i>0&&(r.height={rule:"atLeast",value:i})}return new zt(r)}const kt=(t,e)=>{const n={top:e.attrs?.marginTop??void 0,bottom:e.attrs?.marginBottom??void 0,left:e.attrs?.marginLeft??void 0,right:e.attrs?.marginRight??void 0};return n.top||n.bottom||n.left||n.right?{...t,margins:n}:t};async function Ft(t,e){const{options:n}=e;let o={rows:await Promise.all((t.content||[]).map(r=>Tt(r,e))),...n?.run};return o=kt(o,t),new B(o)}function At(t){if(!t.content||t.content.length===0)return{children:[new f({text:"",font:P})]};const e=t.content.flatMap(n=>n.type==="text"?T(n):[]);return{children:e.length>0?e:[new f({text:"",font:P})]}}async function xt(t,e){if(!t.content||t.content.length===0)return{};const n=t.content[0];return n.type==="paragraph"?await C(n,{options:e.options}):{}}function It(){return{numbering:{reference:"bullet-list",level:0}}}function Et(t){const e=t.attrs?.start||1;return{numbering:{reference:"ordered-list",level:0},start:e}}async function Y(t,e){const{listType:n}=e;if(!t.content)return[];const o=[],r=n==="bullet"?It():Et(t);let a=r.numbering.reference;n==="ordered"&&r.start&&r.start!==1&&(a=`ordered-list-start-${r.start}`);for(const i of t.content)if(i.type==="listItem"){const l=await xt(i,{options:{numbering:{reference:a,level:0}}});o.push(l)}return o}function V(t){if(!t.content||t.content.length===0)return{};const e=t.content[0];if(e.type==="paragraph"){const n=t.attrs?.checked?z.checked+" ":z.unchecked+" ",o=e.content?.flatMap(r=>r.type==="text"?T(r):r.type==="hardBreak"?k(r.marks):[])||[];return{children:[new f({text:n}),...o]}}return{}}function Ct(t){return!t.content||t.content.length===0?[]:t.content.filter(e=>e.type==="taskItem").map(e=>V(e))}function Lt(t,e){return{children:[new jt],...e.options?.paragraph}}function Dt(t,e){return{children:q(t.content||[]).filter(n=>n!==void 0),...e.options?.summary?.paragraph}}async function le(t,e){const{title:n,subject:o,creator:r,keywords:a,description:i,lastModifiedBy:l,revision:u,styles:c,tableOfContents:d,sections:y,fonts:h,hyphenation:F,compatibility:w,customProperties:v,evenAndOddHeaderAndFooters:s,defaultTabStop:A,outputType:St}=e,R=await Bt(t,{options:e}),L=d?new Gt(d.title,{...d.run}):null,Nt=he(t),x=[];e.image?.style&&x.push(e.image.style),e.table?.style&&x.push(e.table.style),e.code?.style&&x.push(e.code.style);const Ht=c?{...c,...x.length>0&&{paragraphStyles:[...c.paragraphStyles||[],...x]}}:{},Rt={sections:y?y.map((Wt,Q)=>{const D=[];return Q===0&&L&&D.push(L),Q===0&&D.push(...R),{...Wt,...D.length>0?{children:D}:{}}}):[{children:L?[L,...R]:R}],title:n||"Document",subject:o||"",creator:r||"",keywords:a||"",description:i||"",lastModifiedBy:l||"",revision:u||1,styles:Ht,numbering:Nt,...h&&h.length>0&&{fonts:h},...F&&{hyphenation:F},...w&&{compatibility:w},...v&&v.length>0&&{customProperties:v},...s!==void 0&&{evenAndOddHeaderAndFooters:s},...A!==void 0&&{defaultTabStop:A}},Ot=new Ut(Rt);return Xt.pack(Ot,St||"arraybuffer")}async function Bt(t,e){const n=[];if(!t||!Array.isArray(t.content))return n;const o=dt(e.options);for(const r of t.content){const a=await J(r,e.options,o);Array.isArray(a)?n.push(...a):a&&(n.push(a),r.type==="table"&&n.length>=2&&n[n.length-2]instanceof B&&n.push(new I({})))}return n}async function J(t,e,n){if(!t||!t.type)return null;const o=await de(t,e,n);if(o instanceof B)return o;if(Array.isArray(o)){const i=Pt(t.type,e);return o.map(l=>{const u=Mt(l,i);return new I(u)})}const r=Pt(t.type,e),a=Mt(o,r);return fe(a)}async function de(t,e,n){switch(t.type){case"paragraph":return await C(t,{image:{maxWidth:n,options:e.image?.run,handler:e.image?.handler}});case"heading":return yt(t);case"blockquote":return wt(t);case"codeBlock":return At(t);case"image":return{children:[await K(t,{maxWidth:n,options:e.image?.run,handler:e.image?.handler})]};case"table":return await Ft(t,{options:e.table});case"bulletList":return await Y(t,{listType:"bullet"});case"orderedList":return await Y(t,{listType:"ordered"});case"taskList":return Ct(t);case"taskItem":return V(t);case"hardBreak":return{children:[k()]};case"horizontalRule":return Lt(t,{options:e.horizontalRule});case"details":return await ue(t,e,n);case"detailsSummary":return Dt(t,{options:e.details});default:return{children:[new f({text:`[Unsupported: ${t.type}]`})]}}}async function ue(t,e,n){const o=[];if(t.content)for(const r of t.content){const a=await J(r,e,n);Array.isArray(a)?o.push(...a):a&&o.push(a)}return o}const pe=t=>({level:0,format:nt.DECIMAL,text:"%1.",alignment:et.START,start:t??1,style:{paragraph:{indent:{left:_(.5),hanging:_(.25)}}}}),_t=t=>({reference:t&&t!==1?`ordered-list-start-${t}`:"ordered-list",levels:[pe(t)]});function he(t){const e=new Set;function n(r){if(r.type==="orderedList"&&r.attrs?.start&&e.add(r.attrs.start),r.content)for(const a of r.content)n(a)}n(t);const o=[{reference:"bullet-list",levels:[{level:0,format:nt.BULLET,text:"\u2022",alignment:et.START,style:{paragraph:{indent:{left:_(.5),hanging:_(.25)}}}}]},_t(1)];return e.forEach(r=>{r!==1&&o.push(_t(r))}),{config:o}}function Pt(t,e){return{codeBlock:e.code?.style?.id,image:e.image?.style?.id}[t]}function Mt(t,e){return e?{...t,style:e}:t}function fe(t){return t instanceof B?t:new I(t)}export{z as CHECKBOX_SYMBOLS,it as COLOR_NAME_TO_HEX,P as DEFAULT_CODE_FONT,W as DOCX_DPI,Vt as DOCX_STYLE_NAMES,Kt as EMUS_PER_INCH,rt as HALF_POINTS_PER_PIXEL,j as PAGE_DIMENSIONS,Yt as PIXELS_PER_HALF_POINT,ot as TEXT_ALIGN_MAP,$ as TWIPS_PER_INCH,X as applyParagraphStyleAttributes,kt as applyTableMargins,dt as calculateEffectiveContentWidth,wt as convertBlockquote,p as convertBorder,It as convertBulletList,At as convertCodeBlock,U as convertColorToHex,m as convertCssLengthToPixels,Dt as convertDetailsSummary,Bt as convertDocument,Zt as convertEmuStringToPixels,at as convertEmuToPixels,k as convertHardBreak,yt as convertHeading,Lt as convertHorizontalRule,K as convertImage,Y as convertList,xt as convertListItem,S as convertMeasureToInches,G as convertMeasureToPixels,J as convertNode,Et as convertOrderedList,C as convertParagraph,Qt as convertPixelsToEmu,g as convertPixelsToTwip,Ft as convertTable,vt as convertTableCell,bt as convertTableHeader,Tt as convertTableRow,V as convertTaskItem,Ct as convertTaskList,T as convertText,q as convertTextNodes,pt as convertToDocxImageType,Jt as convertTwipToCssString,E as convertTwipToPixels,ce as createFloatingOptions,se as createStringValidator,ae as findChild,st as findDeepChild,ct as findDeepChildren,le as generateDOCX,mt as getImageDataAndMeta,gt as getImageHeight,H as getImageTypeFromSrc,ft as getImageWidth,oe as normalizeHexColor,ie as parseTwipAttr};
+import { AlignmentType, Document, ExternalHyperlink, HeadingLevel, ImageRun, LevelFormat, Packer, PageBreak, Paragraph, Table, TableCell, TableOfContents, TableRow, TextRun, convertInchesToTwip } from "docx";
+import { imageMeta } from "image-meta";
+import { ofetch } from "ofetch";
+//#region ../utils/dist/index.mjs
+/**
+* Shared constants for DOCX processing
+* Used across @docen/export-docx and @docen/import-docx packages
+*/
+/**
+* DOCX DPI (dots per inch) for pixel conversions
+* Word uses 96 DPI internally
+*/
+const DOCX_DPI = 96;
+/**
+* TWIP (Twentieth of a Point) conversion constants
+* 1 inch = 1440 TWIPs
+*/
+const TWIPS_PER_INCH = 1440;
+/**
+* EMU (English Metric Unit) conversion constants
+* 1 inch = 914400 EMUs
+*/
+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
+*/
+const HALF_POINTS_PER_PIXEL = 1.5;
+const PIXELS_PER_HALF_POINT = 1 / 1.5;
+/**
+* Default code font family
+*/
+const DEFAULT_CODE_FONT = "Consolas";
+/**
+* Checkbox symbols for task lists
+*/
+const CHECKBOX_SYMBOLS = {
+	checked: "☑",
+	unchecked: "☐"
+};
+/**
+* DOCX style names
+*/
+const DOCX_STYLE_NAMES = {
+	CODE_BLOCK: "CodeBlock",
+	CODE_PREFIX: "Code"
+};
+/**
+* Text alignment mappings
+*/
+const TEXT_ALIGN_MAP = {
+	tiptapToDocx: {
+		left: "left",
+		right: "right",
+		center: "center",
+		justify: "both"
+	},
+	docxToTipTap: {
+		left: "left",
+		right: "right",
+		center: "center",
+		both: "justify"
+	}
+};
+/**
+* Common page dimensions in TWIPs
+*/
+const PAGE_DIMENSIONS = {
+	A4_WIDTH_TWIP: 11906,
+	DEFAULT_MARGIN_TWIP: 1440
+};
+/**
+* Unit conversion utilities for DOCX processing
+* Handles conversions between TWIPs, EMUs, pixels, and other units
+*/
+const PIXELS_PER_INCH = 96;
+/**
+* Convert TWIPs to CSS pixels (returns number)
+* @param twip - Value in TWIPs (1 inch = 1440 TWIPs)
+* @returns Number value in pixels
+*
+* @example
+* convertTwipToPixels(1440) // returns 96
+*/
+function convertTwipToPixels(twip) {
+	return Math.round(twip * PIXELS_PER_INCH / TWIPS_PER_INCH);
+}
+/**
+* Convert TWIPs to CSS string (returns "px" string)
+* @param twip - Value in TWIPs
+* @returns CSS value string in pixels (e.g., "20px")
+*
+* @example
+* convertTwipToCssString(1440) // returns "96px"
+*/
+function convertTwipToCssString(twip) {
+	return `${convertTwipToPixels(twip)}px`;
+}
+/**
+* Convert pixels to TWIPs
+* @param px - Value in pixels
+* @returns Value in TWIPs
+*
+* @example
+* convertPixelsToTwip(96) // returns 1440
+*/
+function convertPixelsToTwip(px) {
+	return Math.round(px * (TWIPS_PER_INCH / PIXELS_PER_INCH));
+}
+/**
+* Convert EMUs to pixels
+* EMU = English Metric Unit (1 inch = 914400 EMUs)
+* @param emu - Value in EMUs
+* @returns Value in pixels
+*
+* @example
+* convertEmuToPixels(914400) // returns 96
+*/
+function convertEmuToPixels(emu) {
+	return Math.round(emu / (EMUS_PER_INCH / PIXELS_PER_INCH));
+}
+/**
+* Convert pixels to EMUs
+* @param px - Value in pixels
+* @returns Value in EMUs
+*
+* @example
+* convertPixelsToEmu(96) // returns 914400
+*/
+function convertPixelsToEmu(px) {
+	return Math.round(px * (EMUS_PER_INCH / PIXELS_PER_INCH));
+}
+/**
+* Convert EMU string to pixels
+* @param emuStr - EMU value as string
+* @returns Pixel value or undefined if invalid
+*
+* @example
+* convertEmuStringToPixels("914400") // returns 96
+* convertEmuStringToPixels("invalid") // returns undefined
+*/
+function convertEmuStringToPixels(emuStr) {
+	const emu = parseInt(emuStr, 10);
+	if (isNaN(emu)) return void 0;
+	return convertEmuToPixels(emu);
+}
+/**
+* Regular expression for matching CSS length values
+* Supports: px, pt, em, rem, %, and unitless values (including negative values)
+*/
+const CSS_LENGTH_REGEX = /^(-?[\d.]+)(px|pt|em|rem|%|)?$/;
+/**
+* Conversion factors from various units to pixels
+*/
+const UNIT_TO_PIXELS = {
+	px: 1,
+	pt: 1.333,
+	em: 16,
+	rem: 16,
+	"%": .16
+};
+/**
+* Parse CSS length value to pixels
+* Supports: px, pt, em, rem, %, and unitless values
+* @param value - CSS length value (e.g., "20px", "1.5em", "100%")
+* @returns Value in pixels
+*
+* @example
+* convertCssLengthToPixels("20px") // returns 20
+* convertCssLengthToPixels("1.5em") // returns 24
+* convertCssLengthToPixels("100%") // returns 16
+* convertCssLengthToPixels("20") // returns 20 (unitless treated as px)
+*/
+function convertCssLengthToPixels(value) {
+	if (!value) return 0;
+	value = value.trim();
+	const match = value.match(CSS_LENGTH_REGEX);
+	if (!match) return 0;
+	const num = parseFloat(match[1]);
+	if (isNaN(num)) return 0;
+	const factor = UNIT_TO_PIXELS[match[2] || "px"] ?? 1;
+	return Math.round(num * factor);
+}
+/**
+* Regular expression for matching universal measure values
+* Used in DOCX for specifying dimensions in various units
+*/
+const MEASURE_REGEX = /^([\d.]+)(in|mm|cm|pt|pc|pi)$/;
+/**
+* Conversion factors from various units to inches
+*/
+const UNIT_TO_INCHES = {
+	in: 1,
+	mm: 1 / 25.4,
+	cm: 1 / 2.54,
+	pt: 1 / 72,
+	pc: 1 / 6,
+	pi: 1 / 6
+};
+/**
+* Convert universal measure to inches
+* Compatible with docx.js UniversalMeasure type
+* @param value - Value in various units (number or string)
+* @returns Value in inches
+*
+* @example
+* convertMeasureToInches(6.5) // returns 6.5
+* convertMeasureToInches("1in") // returns 1
+* convertMeasureToInches("25.4mm") // returns ~1
+*/
+function convertMeasureToInches(value) {
+	if (typeof value === "number") return value;
+	const match = value.match(MEASURE_REGEX);
+	if (match) {
+		const numValue = parseFloat(match[1]);
+		const factor = UNIT_TO_INCHES[match[2]];
+		return factor !== void 0 ? numValue * factor : numValue;
+	}
+	const num = parseFloat(value);
+	return isNaN(num) ? 6.5 : num;
+}
+/**
+* Convert universal measure to pixels
+* Compatible with docx.js UniversalMeasure type
+* @param value - Value in various units (number or string)
+* @returns Value in pixels
+*
+* @example
+* convertMeasureToPixels("1in") // returns 96
+* convertMeasureToPixels(6.5) // returns 624
+*/
+function convertMeasureToPixels(value) {
+	if (typeof value === "number") return value;
+	const inches = convertMeasureToInches(value);
+	return Math.round(inches * 96);
+}
+/**
+* Color conversion utilities for DOCX processing
+* Handles conversion between color names and hex values
+*/
+/**
+* Color name to hex value mapping
+* Includes common HTML/CSS color names
+*/
+const COLOR_NAME_TO_HEX = {
+	black: "#000000",
+	white: "#FFFFFF",
+	red: "#FF0000",
+	green: "#008000",
+	blue: "#0000FF",
+	yellow: "#FFFF00",
+	orange: "#FFA500",
+	purple: "#800080",
+	pink: "#FFC0CB",
+	brown: "#A52A2A",
+	gray: "#808080",
+	grey: "#808080",
+	cyan: "#00FFFF",
+	magenta: "#FF00FF",
+	lime: "#00FF00",
+	navy: "#000080",
+	teal: "#008080",
+	maroon: "#800000",
+	olive: "#808000",
+	silver: "#C0C0C0",
+	gold: "#FFD700",
+	indigo: "#4B0082",
+	violet: "#EE82EE",
+	aqua: "#00FFFF",
+	fuchsia: "#FF00FF",
+	darkblue: "#00008B",
+	darkcyan: "#008B8B",
+	darkgrey: "#A9A9A9",
+	darkgreen: "#006400",
+	darkkhaki: "#BDB76B",
+	darkmagenta: "#8B008B",
+	darkolivegreen: "#556B2F",
+	darkorange: "#FF8C00",
+	darkorchid: "#9932CC",
+	darkred: "#8B0000",
+	darksalmon: "#E9967A",
+	darkviolet: "#9400D3",
+	lightblue: "#ADD8E6",
+	lightcyan: "#E0FFFF",
+	lightgreen: "#90EE90",
+	lightgrey: "#D3D3D3",
+	lightpink: "#FFB6C1",
+	lightyellow: "#FFFFE0"
+};
+/**
+* Convert color name or hex to normalized hex value
+* @param color - Color as name (e.g., "red") or hex (e.g., "#FF0000" or "FF0000")
+* @returns Normalized hex color string (e.g., "#FF0000") or undefined if invalid
+*
+* @example
+* convertColorToHex("red") // returns "#FF0000"
+* convertColorToHex("#FF0000") // returns "#FF0000"
+* convertColorToHex("FF0000") // returns "#FF0000"
+* convertColorToHex("invalid") // returns undefined
+*/
+function convertColorToHex(color) {
+	if (!color) return void 0;
+	if (color.startsWith("#")) return color;
+	return COLOR_NAME_TO_HEX[color.toLowerCase()] || color;
+}
+/**
+* Normalize hex color to ensure it has a # prefix
+* @param color - Color value with or without # prefix
+* @returns Hex color with # prefix
+*
+* @example
+* normalizeHexColor("FF0000") // returns "#FF0000"
+* normalizeHexColor("#FF0000") // returns "#FF0000"
+*/
+function normalizeHexColor(color) {
+	if (color.startsWith("#")) return color;
+	return `#${color}`;
+}
+/**
+* Find direct child element with specified name
+* @param node - Parent XML element or root node
+* @param name - Child element name to find (can include namespace prefix, e.g., "w:p")
+* @returns Child element if found, null otherwise
+*
+* @example
+* const paragraph = findChild(document, "w:p");
+*/
+function findChild(node, name) {
+	if (!node.children) return null;
+	for (const child of node.children) if (child.type === "element" && child.name === name) return child;
+	return null;
+}
+/**
+* Find deep descendant element with specified name (recursive)
+* Searches through all descendants, not just direct children
+* @param node - Root XML element
+* @param name - Descendant element name to find
+* @returns Descendant element if found, null otherwise
+*
+* @example
+* const textElement = findDeepChild(run, "w:t");
+*/
+function findDeepChild(node, name) {
+	if (!node.children) return null;
+	for (const child of node.children) if (child.type === "element") {
+		if (child.name === name) return child;
+		const found = findDeepChild(child, name);
+		if (found) return found;
+	}
+	return null;
+}
+/**
+* Find all deep descendant elements with specified name (recursive)
+* @param node - Root XML element
+* @param name - Descendant element name to find
+* @returns Array of matching descendant elements
+*
+* @example
+* const allTextRuns = findDeepChildren(paragraph, "w:r");
+*/
+function findDeepChildren(node, name) {
+	const results = [];
+	if (!node.children) return results;
+	for (const child of node.children) if (child.type === "element") {
+		if (child.name === name) results.push(child);
+		results.push(...findDeepChildren(child, name));
+	}
+	return results;
+}
+/**
+* Parse TWIP attribute value from element attributes
+* TWIP = Twentieth of a Point (1 inch = 1440 TWIPs)
+* @param attributes - Element attributes object
+* @param name - Attribute name to parse
+* @returns TWIP value as string, or undefined if not found
+*
+* @example
+* const leftIndent = parseTwipAttr(pPr.attributes, "w:left");
+*/
+function parseTwipAttr(attributes, name) {
+	const value = attributes[name];
+	if (!value) return void 0;
+	const num = parseInt(value, 10);
+	if (isNaN(num)) return void 0;
+	return value;
+}
+/**
+* Type guard utilities for DOCX processing
+*/
+/**
+* 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"
+* }
+*/
+function createStringValidator(validValues) {
+	return (value) => {
+		return validValues.includes(value);
+	};
+}
+//#endregion
+//#region src/utils/conversion.ts
+/**
+* Normalize margin value to TWIPs
+* Converts number (already TWIPs) or PositiveUniversalMeasure to TWIPs
+*/
+const normalizeMarginToTwip = (margin, fallback) => {
+	if (!margin) return fallback;
+	return typeof margin === "number" ? margin : Math.round(convertMeasureToInches(margin) * TWIPS_PER_INCH);
+};
+/**
+* Calculate effective content width from document options
+*/
+function calculateEffectiveContentWidth(options) {
+	const DEFAULT_PAGE_WIDTH_TWIP = PAGE_DIMENSIONS.A4_WIDTH_TWIP;
+	const DEFAULT_MARGIN_TWIP = PAGE_DIMENSIONS.DEFAULT_MARGIN_TWIP;
+	if (!options?.sections?.length) return convertTwipToPixels(DEFAULT_PAGE_WIDTH_TWIP - DEFAULT_MARGIN_TWIP * 2);
+	const firstSection = options.sections[0];
+	if (!firstSection.properties?.page) return convertTwipToPixels(DEFAULT_PAGE_WIDTH_TWIP - DEFAULT_MARGIN_TWIP * 2);
+	const pageSettings = firstSection.properties.page;
+	let pageWidth = DEFAULT_PAGE_WIDTH_TWIP;
+	if (pageSettings.size?.width) {
+		const widthValue = pageSettings.size.width;
+		pageWidth = typeof widthValue === "number" ? widthValue : Math.round(convertMeasureToInches(widthValue) * TWIPS_PER_INCH);
+	}
+	const marginSettings = pageSettings.margin;
+	const marginLeft = normalizeMarginToTwip(marginSettings?.left, DEFAULT_MARGIN_TWIP);
+	const marginRight = normalizeMarginToTwip(marginSettings?.right, DEFAULT_MARGIN_TWIP);
+	const effectiveWidth = pageWidth - marginLeft - marginRight;
+	return Math.max(convertTwipToPixels(effectiveWidth), 96);
+}
+//#endregion
+//#region src/utils/image.ts
+const DEFAULT_MAX_IMAGE_WIDTH_PIXELS = 6.5 * 96;
+/**
+* Unified image type mapping
+* Maps file extensions and MIME types to standardized type names and DOCX types
+*/
+const IMAGE_TYPE_MAPPING = {
+	mimeToInternal: {
+		jpg: "jpeg",
+		jpeg: "jpeg",
+		png: "png",
+		gif: "gif",
+		bmp: "bmp",
+		tiff: "tiff"
+	},
+	internalToDocx: {
+		jpeg: "jpg",
+		png: "png",
+		gif: "gif",
+		bmp: "bmp",
+		tiff: "bmp"
+	}
+};
+/**
+* Convert image MIME type to DOCX type
+*/
+function convertToDocxImageType(mimeType) {
+	if (!mimeType) return "png";
+	const typeKey = mimeType.toLowerCase();
+	const internalType = IMAGE_TYPE_MAPPING.mimeToInternal[typeKey] || "png";
+	return IMAGE_TYPE_MAPPING.internalToDocx[internalType] || "png";
+}
+/**
+* Extract image type from URL or base64 data
+*/
+function getImageTypeFromSrc(src) {
+	if (src.startsWith("data:")) {
+		const match = src.match(/data:image\/(\w+);/);
+		if (match) {
+			const type = match[1].toLowerCase();
+			return IMAGE_TYPE_MAPPING.mimeToInternal[type] || "png";
+		}
+	} else {
+		const extension = src.split(".").pop()?.toLowerCase();
+		if (extension) return IMAGE_TYPE_MAPPING.mimeToInternal[extension] || "png";
+	}
+	return "png";
+}
+/**
+* Calculate appropriate display size for image (mimicking Word's behavior)
+*/
+const calculateDisplaySize = (imageMeta, maxWidthPixels = DEFAULT_MAX_IMAGE_WIDTH_PIXELS) => {
+	if (!imageMeta.width || !imageMeta.height) return {
+		width: maxWidthPixels,
+		height: Math.round(maxWidthPixels * .75)
+	};
+	if (imageMeta.width <= maxWidthPixels) return {
+		width: imageMeta.width,
+		height: imageMeta.height
+	};
+	const scaleFactor = maxWidthPixels / imageMeta.width;
+	return {
+		width: maxWidthPixels,
+		height: Math.round(imageMeta.height * scaleFactor)
+	};
+};
+/**
+* Create floating options for full-width images
+*/
+function createFloatingOptions() {
+	return {
+		horizontalPosition: {
+			relative: "page",
+			align: "center"
+		},
+		verticalPosition: {
+			relative: "page",
+			align: "top"
+		},
+		lockAnchor: true,
+		behindDocument: false,
+		inFrontOfText: false
+	};
+}
+/**
+* Get image width with priority: node attrs > image meta > calculated > default
+*
+* Note: maxWidth constraint only applies to inline (non-floating) images.
+* Floating images maintain their original dimensions.
+*/
+function getImageWidth(node, imageMeta, maxWidth) {
+	if (node.attrs?.width !== void 0 && node.attrs?.width !== null) {
+		const requestedWidth = node.attrs.width;
+		if (!node.attrs.floating && maxWidth) {
+			const maxWidthPixels = maxWidth !== void 0 ? convertMeasureToPixels(maxWidth) : void 0;
+			if (maxWidthPixels && requestedWidth > maxWidthPixels) return maxWidthPixels;
+		}
+		return requestedWidth;
+	}
+	const maxWidthPixels = maxWidth !== void 0 ? convertMeasureToPixels(maxWidth) : void 0;
+	if (imageMeta?.width && imageMeta?.height) return calculateDisplaySize(imageMeta, maxWidthPixels).width;
+	return maxWidthPixels || DEFAULT_MAX_IMAGE_WIDTH_PIXELS;
+}
+/**
+* Get image height with priority: node attrs > image meta > calculated > default
+*
+* Note: maxWidth constraint only applies to inline (non-floating) images.
+* Floating images maintain their original dimensions and aspect ratio.
+*/
+function getImageHeight(node, width, imageMeta, maxWidth) {
+	if (node.attrs?.height !== void 0 && node.attrs?.height !== null) {
+		const requestedHeight = node.attrs.height;
+		if (!node.attrs.floating && maxWidth && node.attrs?.width) {
+			const maxWidthPixels = maxWidth !== void 0 ? convertMeasureToPixels(maxWidth) : void 0;
+			const requestedWidth = node.attrs.width;
+			if (maxWidthPixels && requestedWidth > maxWidthPixels) {
+				const scaleFactor = maxWidthPixels / requestedWidth;
+				return Math.round(requestedHeight * scaleFactor);
+			}
+		}
+		return requestedHeight;
+	}
+	const maxWidthPixels = maxWidth !== void 0 ? convertMeasureToPixels(maxWidth) : void 0;
+	if (imageMeta?.width && imageMeta?.height) return calculateDisplaySize(imageMeta, maxWidthPixels).height;
+	return Math.round(width * .75);
+}
+/**
+* Fetch image data and metadata from HTTP/HTTPS URL
+* (Only for use without custom handler)
+*/
+async function getImageDataAndMeta(url) {
+	try {
+		const data = await (await ofetch(url, { responseType: "blob" })).bytes();
+		let meta;
+		try {
+			meta = imageMeta(data);
+		} catch (error) {
+			console.warn(`Failed to extract image metadata:`, error);
+			meta = {
+				width: void 0,
+				height: void 0,
+				type: getImageTypeFromSrc(url) || "png",
+				orientation: void 0
+			};
+		}
+		return {
+			data,
+			meta
+		};
+	} catch (error) {
+		console.warn(`Failed to fetch image from ${url}:`, error);
+		throw error;
+	}
+}
+//#endregion
+//#region src/utils/paragraph.ts
+/**
+* Apply paragraph style attributes to options
+*/
+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)) }
+		}
+	};
+	if (attrs.spacingBefore || attrs.spacingAfter) result = {
+		...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]
+	};
+	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
+*/
+function convertText(node) {
+	const isBold = node.marks?.some((m) => m.type === "bold");
+	const isItalic = node.marks?.some((m) => m.type === "italic");
+	const isUnderline = node.marks?.some((m) => m.type === "underline");
+	const isStrike = node.marks?.some((m) => m.type === "strike");
+	const isCode = node.marks?.some((m) => m.type === "code");
+	const isSubscript = node.marks?.some((m) => m.type === "subscript");
+	const isSuperscript = node.marks?.some((m) => m.type === "superscript");
+	const linkMark = node.marks?.find((m) => m.type === "link");
+	const textStyleMark = node.marks?.find((m) => m.type === "textStyle");
+	const hasHighlight = node.marks?.some((m) => m.type === "highlight");
+	const textColor = convertColorToHex(textStyleMark?.attrs?.color);
+	const backgroundColor = convertColorToHex(textStyleMark?.attrs?.backgroundColor);
+	let fontSize;
+	if (textStyleMark?.attrs?.fontSize) {
+		const fontSizeStr = textStyleMark.attrs.fontSize;
+		if (fontSizeStr.endsWith("px")) {
+			const px = parseFloat(fontSizeStr);
+			if (!isNaN(px)) fontSize = Math.round(px * HALF_POINTS_PER_PIXEL);
+		}
+	}
+	let fontFamily;
+	if (isCode) fontFamily = DEFAULT_CODE_FONT;
+	else if (textStyleMark?.attrs?.fontFamily) fontFamily = textStyleMark.attrs.fontFamily;
+	const baseOptions = {
+		text: node.text || "",
+		bold: isBold || void 0,
+		italics: isItalic || void 0,
+		underline: isUnderline ? {} : void 0,
+		strike: isStrike || void 0,
+		font: fontFamily,
+		size: fontSize,
+		subScript: isSubscript || void 0,
+		superScript: isSuperscript || void 0,
+		color: textColor,
+		shading: backgroundColor ? { fill: backgroundColor } : void 0,
+		highlight: hasHighlight ? "yellow" : void 0
+	};
+	if (linkMark?.attrs?.href) return new ExternalHyperlink({
+		children: [new TextRun({
+			...baseOptions,
+			style: "Hyperlink"
+		})],
+		link: linkMark.attrs.href
+	});
+	return new TextRun(baseOptions);
+}
+/**
+* Convert TipTap hardBreak node to DOCX TextRun with break
+*/
+function convertHardBreak(marks) {
+	const options = {
+		text: "",
+		break: 1
+	};
+	if (marks) for (const mark of marks) switch (mark.type) {
+		case "bold":
+			options.bold = true;
+			break;
+		case "italic":
+			options.italics = true;
+			break;
+		case "underline":
+			options.underline = {};
+			break;
+		case "strike":
+			options.strike = true;
+			break;
+		case "textStyle":
+			if (mark.attrs?.color) options.color = mark.attrs.color;
+			break;
+	}
+	return new TextRun(options);
+}
+/**
+* Convert array of text nodes (text, hardBreak) to DOCX elements
+* Returns flattened array of TextRun or ExternalHyperlink
+*/
+function convertTextNodes(nodes = []) {
+	return nodes.flatMap((contentNode) => {
+		if (contentNode.type === "text") return [convertText(contentNode)];
+		else if (contentNode.type === "hardBreak") return [convertHardBreak(contentNode.marks)];
+		return [];
+	});
+}
+//#endregion
+//#region src/converters/image.ts
+/**
+* Convert TipTap image node to DOCX ImageRun
+*
+* @param node - TipTap image node
+* @param params - Conversion parameters
+* @returns Promise<DOCX ImageRun>
+*/
+async function convertImage(node, params) {
+	const getImageType = (metaType) => {
+		return convertToDocxImageType(metaType || getImageTypeFromSrc(node.attrs?.src || ""));
+	};
+	let imageData;
+	let imageMeta$1;
+	try {
+		const src = node.attrs?.src || "";
+		if (params?.handler) {
+			imageData = await params.handler(src);
+			try {
+				imageMeta$1 = imageMeta(imageData);
+			} catch {
+				imageMeta$1 = {
+					type: getImageTypeFromSrc(src),
+					width: void 0,
+					height: void 0,
+					orientation: void 0
+				};
+			}
+		} else if (src.startsWith("http")) {
+			const result = await getImageDataAndMeta(src);
+			imageData = result.data;
+			imageMeta$1 = result.meta;
+		} else if (src.startsWith("data:")) {
+			const base64Data = src.split(",")[1];
+			if (!base64Data) throw new Error("Invalid data URL: missing base64 data");
+			const binaryString = atob(base64Data);
+			imageData = Uint8Array.from(binaryString, (char) => char.charCodeAt(0));
+			try {
+				imageMeta$1 = imageMeta(imageData);
+			} catch {
+				imageMeta$1 = {
+					type: "png",
+					width: void 0,
+					height: void 0,
+					orientation: void 0
+				};
+			}
+		} else throw new Error(`Unsupported image source format: ${src.substring(0, 20)}...`);
+	} catch (error) {
+		console.warn(`Failed to process image:`, error);
+		return new ImageRun({
+			type: "png",
+			data: new Uint8Array(0),
+			transformation: {
+				width: 100,
+				height: 100
+			},
+			altText: { name: node.attrs?.alt || "Failed to load image" }
+		});
+	}
+	const finalWidth = getImageWidth(node, imageMeta$1, params?.maxWidth);
+	const transformation = {
+		width: finalWidth,
+		height: getImageHeight(node, finalWidth, imageMeta$1, params?.maxWidth)
+	};
+	if (node.attrs?.rotation !== void 0) transformation.rotation = node.attrs.rotation;
+	return new ImageRun({
+		...params?.options,
+		type: getImageType(imageMeta$1.type),
+		data: imageData,
+		transformation,
+		altText: {
+			name: node.attrs?.alt || "",
+			description: void 0,
+			title: node.attrs?.title || void 0
+		},
+		...node.attrs?.floating && { floating: node.attrs.floating },
+		...node.attrs?.outline && { outline: node.attrs.outline }
+	});
+}
+//#endregion
+//#region src/converters/paragraph.ts
+/**
+* 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 options (pure data object)>
+*/
+async function convertParagraph(node, params) {
+	const { options, image } = params || {};
+	const children = [];
+	for (const contentNode of node.content || []) if (contentNode.type === "text") children.push(convertText(contentNode));
+	else if (contentNode.type === "hardBreak") children.push(convertHardBreak(contentNode.marks));
+	else if (contentNode.type === "image") {
+		const imageRun = await convertImage(contentNode, {
+			maxWidth: image?.maxWidth,
+			options: image?.options,
+			handler: image?.handler
+		});
+		children.push(imageRun);
+	}
+	let paragraphOptions = { children };
+	if (options) paragraphOptions = {
+		...paragraphOptions,
+		...options
+	};
+	if (node.attrs) paragraphOptions = applyParagraphStyleAttributes(paragraphOptions, node.attrs);
+	return paragraphOptions;
+}
+//#endregion
+//#region src/converters/heading.ts
+/**
+* Convert TipTap heading 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 heading node
+* @returns DOCX paragraph options (pure data object)
+*/
+function convertHeading(node) {
+	const level = node?.attrs?.level;
+	let paragraphOptions = {
+		children: convertTextNodes(node.content).filter((item) => item !== void 0),
+		heading: {
+			1: HeadingLevel.HEADING_1,
+			2: HeadingLevel.HEADING_2,
+			3: HeadingLevel.HEADING_3,
+			4: HeadingLevel.HEADING_4,
+			5: HeadingLevel.HEADING_5,
+			6: HeadingLevel.HEADING_6
+		}[level]
+	};
+	if (node.attrs) paragraphOptions = applyParagraphStyleAttributes(paragraphOptions, node.attrs);
+	return paragraphOptions;
+}
+//#endregion
+//#region src/converters/blockquote.ts
+/**
+* Convert TipTap blockquote 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 blockquote node
+* @returns Array of paragraph options (pure data objects)
+*/
+function convertBlockquote(node) {
+	if (!node.content) return [];
+	return node.content.map((contentNode) => {
+		if (contentNode.type === "paragraph") return {
+			children: contentNode.content?.flatMap((node) => {
+				if (node.type === "text") return convertText(node);
+				else if (node.type === "hardBreak") return convertHardBreak(node.marks);
+				return [];
+			}) || [],
+			indent: { left: 720 },
+			border: { left: { style: "single" } }
+		};
+		return {};
+	});
+}
+//#endregion
+//#region src/converters/table-cell.ts
+/**
+* Convert TipTap table cell node to DOCX TableCell
+*
+* @param node - TipTap table cell node
+* @param params - Conversion parameters
+* @returns Promise<DOCX TableCell object>
+*/
+async function convertTableCell(node, params) {
+	const { options } = params;
+	let cellParagraphOptions = options?.cell?.paragraph ?? options?.row?.paragraph ?? {};
+	if (options?.style) cellParagraphOptions = {
+		...cellParagraphOptions,
+		style: options.style.id
+	};
+	const cellOptions = {
+		children: (await Promise.all((node.content || []).map((p) => convertParagraph(p, { options: cellParagraphOptions })))).map((options) => new Paragraph(options)),
+		...options?.cell?.run
+	};
+	if (node.attrs?.colspan && node.attrs.colspan > 1) cellOptions.columnSpan = node.attrs.colspan;
+	if (node.attrs?.rowspan && node.attrs.rowspan > 1) cellOptions.rowSpan = node.attrs.rowspan;
+	if (node.attrs?.colwidth !== null && node.attrs?.colwidth !== void 0) {
+		const widthInPixels = Array.isArray(node.attrs.colwidth) ? node.attrs.colwidth[0] : node.attrs.colwidth;
+		if (widthInPixels && widthInPixels > 0) cellOptions.width = {
+			size: Math.round(widthInPixels * 15),
+			type: "dxa"
+		};
+	}
+	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;
+	return new TableCell(cellOptions);
+}
+//#endregion
+//#region src/converters/table-header.ts
+/**
+* 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>
+*/
+async function convertTableHeader(node, params) {
+	const { options } = params;
+	let headerParagraphOptions = options?.header?.paragraph ?? options?.cell?.paragraph ?? options?.row?.paragraph ?? {};
+	if (options?.style) headerParagraphOptions = {
+		...headerParagraphOptions,
+		style: options.style.id
+	};
+	const headerCellOptions = {
+		children: (await Promise.all((node.content || []).map((p) => convertParagraph(p, { options: headerParagraphOptions })))).map((options) => new Paragraph(options)),
+		...options?.header?.run
+	};
+	if (node.attrs?.colspan && node.attrs.colspan > 1) headerCellOptions.columnSpan = node.attrs.colspan;
+	if (node.attrs?.rowspan && node.attrs.rowspan > 1) headerCellOptions.rowSpan = node.attrs.rowspan;
+	if (node.attrs?.colwidth !== null && node.attrs?.colwidth !== void 0) {
+		const widthInPixels = Array.isArray(node.attrs.colwidth) ? node.attrs.colwidth[0] : node.attrs.colwidth;
+		if (widthInPixels && widthInPixels > 0) headerCellOptions.width = {
+			size: Math.round(widthInPixels * 15),
+			type: "dxa"
+		};
+	}
+	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;
+	return new TableCell(headerCellOptions);
+}
+//#endregion
+//#region src/converters/table-row.ts
+/**
+* Convert TipTap table row node to DOCX TableRow
+*
+* @param node - TipTap table row node
+* @param params - Conversion parameters
+* @returns Promise<DOCX TableRow object>
+*/
+async function convertTableRow(node, params) {
+	const { options } = params;
+	const rowOptions = options?.row;
+	const tableRowOptions = {
+		children: (await Promise.all((node.content || []).map(async (cellNode) => {
+			if (cellNode.type === "tableCell") return await convertTableCell(cellNode, params);
+			else if (cellNode.type === "tableHeader") return await convertTableHeader(cellNode, params);
+			return null;
+		}))).filter((cell) => cell !== void 0),
+		...rowOptions
+	};
+	if (node.attrs?.rowHeight) {
+		const twips = convertPixelsToTwip(convertCssLengthToPixels(node.attrs.rowHeight));
+		if (twips > 0) tableRowOptions.height = {
+			rule: "atLeast",
+			value: twips
+		};
+	}
+	return new TableRow(tableRowOptions);
+}
+//#endregion
+//#region src/converters/table.ts
+/**
+* Apply table margins to table options
+*/
+const applyTableMargins = (options, node) => {
+	const margins = {
+		top: node.attrs?.marginTop ?? void 0,
+		bottom: node.attrs?.marginBottom ?? void 0,
+		left: node.attrs?.marginLeft ?? void 0,
+		right: node.attrs?.marginRight ?? void 0
+	};
+	if (margins.top || margins.bottom || margins.left || margins.right) return {
+		...options,
+		margins
+	};
+	return options;
+};
+/**
+* Convert TipTap table node to DOCX Table
+*
+* @param node - TipTap table node
+* @param params - Conversion parameters
+* @returns Promise<Table>
+*/
+async function convertTable(node, params) {
+	const { options } = params;
+	let tableOptions = {
+		rows: await Promise.all((node.content || []).map((row) => convertTableRow(row, params))),
+		...options?.style?.id && { style: options.style.id },
+		...options?.run
+	};
+	tableOptions = applyTableMargins(tableOptions, node);
+	return new Table(tableOptions);
+}
+//#endregion
+//#region src/converters/code-block.ts
+/**
+* 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)
+*/
+function convertCodeBlock(node) {
+	if (!node.content || node.content.length === 0) return { children: [new TextRun({
+		text: "",
+		font: DEFAULT_CODE_FONT
+	})] };
+	const textRuns = node.content.flatMap((contentNode) => {
+		if (contentNode.type === "text") return convertText(contentNode);
+		return [];
+	});
+	return { children: textRuns.length > 0 ? textRuns : [new TextRun({
+		text: "",
+		font: DEFAULT_CODE_FONT
+	})] };
+}
+//#endregion
+//#region src/converters/list-item.ts
+/**
+* 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)>
+*/
+async function convertListItem(node, params) {
+	if (!node.content || node.content.length === 0) return {};
+	const firstParagraph = node.content[0];
+	if (firstParagraph.type === "paragraph") return await convertParagraph(firstParagraph, { options: params.options });
+	return {};
+}
+//#endregion
+//#region src/converters/list.ts
+function convertBulletList() {
+	return { numbering: {
+		reference: "bullet-list",
+		level: 0
+	} };
+}
+function convertOrderedList(node) {
+	return {
+		numbering: {
+			reference: "ordered-list",
+			level: 0
+		},
+		start: node.attrs?.start || 1
+	};
+}
+/**
+* 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.
+*/
+async function convertList(node, params) {
+	const { listType } = params;
+	if (!node.content) return [];
+	const elements = [];
+	const listOptions = listType === "bullet" ? convertBulletList() : convertOrderedList(node);
+	let numberingReference = listOptions.numbering.reference;
+	if (listType === "ordered" && listOptions.start && listOptions.start !== 1) numberingReference = `ordered-list-start-${listOptions.start}`;
+	for (const item of node.content) if (item.type === "listItem") {
+		const paragraphOptions = await convertListItem(item, { options: { numbering: {
+			reference: numberingReference,
+			level: 0
+		} } });
+		elements.push(paragraphOptions);
+	}
+	return elements;
+}
+//#endregion
+//#region src/converters/task-item.ts
+/**
+* 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
+*/
+function convertTaskItem(node) {
+	if (!node.content || node.content.length === 0) return {};
+	const firstParagraph = node.content[0];
+	if (firstParagraph.type === "paragraph") {
+		const checkboxText = node.attrs?.checked || false ? CHECKBOX_SYMBOLS.checked + " " : CHECKBOX_SYMBOLS.unchecked + " ";
+		const children = firstParagraph.content?.flatMap((contentNode) => {
+			if (contentNode.type === "text") return convertText(contentNode);
+			else if (contentNode.type === "hardBreak") return convertHardBreak(contentNode.marks);
+			return [];
+		}) || [];
+		return { children: [new TextRun({ text: checkboxText }), ...children] };
+	}
+	return {};
+}
+//#endregion
+//#region src/converters/task-list.ts
+/**
+* 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
+*/
+function convertTaskList(node) {
+	if (!node.content || node.content.length === 0) return [];
+	return node.content.filter((item) => item.type === "taskItem").map((item) => convertTaskItem(item));
+}
+//#endregion
+//#region src/converters/horizontal-rule.ts
+/**
+* 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
+*/
+function convertHorizontalRule(node, params) {
+	return {
+		children: [new PageBreak()],
+		...params.options?.paragraph
+	};
+}
+//#endregion
+//#region src/converters/details.ts
+/**
+* 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
+*/
+function convertDetailsSummary(node, params) {
+	return {
+		children: convertTextNodes(node.content || []).filter((item) => item !== void 0),
+		...params.options?.summary?.paragraph
+	};
+}
+//#endregion
+//#region src/generator.ts
+/**
+* Convert TipTap JSONContent to DOCX format
+*
+* @param docJson - TipTap document JSON
+* @param options - Export options
+* @returns Promise with DOCX in specified format
+*/
+async function generateDOCX(docJson, options) {
+	const { title, subject, creator, keywords, description, lastModifiedBy, revision, styles, tableOfContents, sections, fonts, hyphenation, compatibility, customProperties, evenAndOddHeaderAndFooters, defaultTabStop, outputType } = options;
+	const children = await convertDocument(docJson, { options });
+	const tocElement = tableOfContents ? new TableOfContents(tableOfContents.title, { ...tableOfContents.run }) : null;
+	const numberingOptions = createNumberingOptions(docJson);
+	const additionalParagraphStyles = [];
+	if (options.image?.style) additionalParagraphStyles.push(options.image.style);
+	if (options.table?.style) additionalParagraphStyles.push(options.table.style);
+	if (options.code?.style) additionalParagraphStyles.push(options.code.style);
+	const mergedStyles = styles ? {
+		...styles,
+		...additionalParagraphStyles.length > 0 && { paragraphStyles: [...styles.paragraphStyles || [], ...additionalParagraphStyles] }
+	} : {};
+	const doc = new Document({
+		sections: sections ? sections.map((section, index) => {
+			const sectionChildren = [];
+			if (index === 0 && tocElement) sectionChildren.push(tocElement);
+			if (index === 0) sectionChildren.push(...children);
+			return {
+				...section,
+				...sectionChildren.length > 0 ? { children: sectionChildren } : {}
+			};
+		}) : [{ children: tocElement ? [tocElement, ...children] : children }],
+		title: title || "Document",
+		subject: subject || "",
+		creator: creator || "",
+		keywords: keywords || "",
+		description: description || "",
+		lastModifiedBy: lastModifiedBy || "",
+		revision: revision || 1,
+		styles: mergedStyles,
+		numbering: numberingOptions,
+		...fonts && fonts.length > 0 && { fonts },
+		...hyphenation && { hyphenation },
+		...compatibility && { compatibility },
+		...customProperties && customProperties.length > 0 && { customProperties },
+		...evenAndOddHeaderAndFooters !== void 0 && { evenAndOddHeaderAndFooters },
+		...defaultTabStop !== void 0 && { defaultTabStop }
+	});
+	return Packer.pack(doc, outputType || "arraybuffer");
+}
+/**
+* Convert document content to DOCX elements
+*/
+async function convertDocument(node, params) {
+	const elements = [];
+	if (!node || !Array.isArray(node.content)) return elements;
+	const effectiveContentWidth = calculateEffectiveContentWidth(params.options);
+	for (const childNode of node.content) {
+		const element = await convertNode(childNode, params.options, effectiveContentWidth);
+		if (Array.isArray(element)) elements.push(...element);
+		else if (element) {
+			elements.push(element);
+			if (childNode.type === "table" && elements.length >= 2 && elements[elements.length - 2] instanceof Table) elements.push(new Paragraph({}));
+		}
+	}
+	return elements;
+}
+/**
+* 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.)
+*/
+async function convertNode(node, options, effectiveContentWidth) {
+	if (!node || !node.type) return null;
+	const dataResult = await convertNodeData(node, options, effectiveContentWidth);
+	if (dataResult instanceof Table) return dataResult;
+	if (Array.isArray(dataResult)) {
+		const styleId = getStyleIdByNodeType(node.type, options);
+		return dataResult.map((paragraphOptions) => {
+			return new Paragraph(applyStyleReference(paragraphOptions, styleId));
+		});
+	}
+	let styleId = getStyleIdByNodeType(node.type, options);
+	if (!styleId && node.type === "paragraph" && node.content) {
+		if (node.content.length > 0 && node.content.every((child) => child.type === "image")) styleId = options.image?.style?.id;
+	}
+	return createDOCXObject(applyStyleReference(dataResult, styleId));
+}
+/**
+* Layer 1: Data Transformation
+*
+* Convert node data to DOCX format properties.
+* Returns pure data objects (IParagraphOptions) or arrays, not DOCX instances.
+* This layer does NOT handle styleId references.
+*/
+async function convertNodeData(node, options, effectiveContentWidth) {
+	switch (node.type) {
+		case "paragraph": return await convertParagraph(node, { image: {
+			maxWidth: effectiveContentWidth,
+			options: options.image?.run,
+			handler: options.image?.handler
+		} });
+		case "heading": return convertHeading(node);
+		case "blockquote": return convertBlockquote(node);
+		case "codeBlock": return convertCodeBlock(node);
+		case "image": return applyStyleReference({ children: [await convertImage(node, {
+			maxWidth: effectiveContentWidth,
+			options: options.image?.run,
+			handler: options.image?.handler
+		})] }, getStyleIdByNodeType("image", options));
+		case "table": return await convertTable(node, { options: options.table });
+		case "bulletList": return await convertList(node, { listType: "bullet" });
+		case "orderedList": return await convertList(node, { listType: "ordered" });
+		case "taskList": return convertTaskList(node);
+		case "taskItem": return convertTaskItem(node);
+		case "hardBreak": return { children: [convertHardBreak()] };
+		case "horizontalRule": return convertHorizontalRule(node, { options: options.horizontalRule });
+		case "details": return await convertDetails(node, options, effectiveContentWidth);
+		case "detailsSummary": return convertDetailsSummary(node, { options: options.details });
+		default: return { children: [new TextRun({ text: `[Unsupported: ${node.type}]` })] };
+	}
+}
+/**
+* Helper to convert details node (needs to recursively call convertNode)
+*/
+async function convertDetails(node, options, effectiveContentWidth) {
+	const elements = [];
+	if (node.content) for (const child of node.content) {
+		const element = await convertNode(child, options, effectiveContentWidth);
+		if (Array.isArray(element)) elements.push(...element);
+		else if (element) elements.push(element);
+	}
+	return elements;
+}
+/**
+* Create a single ordered list level configuration
+*/
+const createOrderedListLevel = (start) => ({
+	level: 0,
+	format: LevelFormat.DECIMAL,
+	text: "%1.",
+	alignment: AlignmentType.START,
+	start: start ?? 1,
+	style: { paragraph: { indent: {
+		left: convertInchesToTwip(.5),
+		hanging: convertInchesToTwip(.25)
+	} } }
+});
+/**
+* Create a numbering reference configuration
+*/
+const createNumberingReference = (start) => ({
+	reference: start && start !== 1 ? `ordered-list-start-${start}` : "ordered-list",
+	levels: [createOrderedListLevel(start)]
+});
+/**
+* Create numbering options for the document
+*/
+function createNumberingOptions(docJson) {
+	const orderedListStarts = /* @__PURE__ */ new Set();
+	function collectListStarts(node) {
+		if (node.type === "orderedList" && node.attrs?.start) orderedListStarts.add(node.attrs.start);
+		if (node.content) for (const child of node.content) collectListStarts(child);
+	}
+	collectListStarts(docJson);
+	const numberingOptions = [{
+		reference: "bullet-list",
+		levels: [{
+			level: 0,
+			format: LevelFormat.BULLET,
+			text: "•",
+			alignment: AlignmentType.START,
+			style: { paragraph: { indent: {
+				left: convertInchesToTwip(.5),
+				hanging: convertInchesToTwip(.25)
+			} } }
+		}]
+	}, createNumberingReference(1)];
+	orderedListStarts.forEach((start) => {
+		if (start !== 1) numberingOptions.push(createNumberingReference(start));
+	});
+	return { config: numberingOptions };
+}
+/**
+* Get style ID for a specific node type from export options
+*
+* This is a centralized mapping of node types to their configured style IDs.
+* Style references are applied separately from data transformation.
+*
+* @param nodeType - The type of TipTap node
+* @param options - Export options containing style configurations
+* @returns Style ID string if configured, undefined otherwise
+*/
+function getStyleIdByNodeType(nodeType, options) {
+	return {
+		codeBlock: options.code?.style?.id,
+		image: options.image?.style?.id
+	}[nodeType];
+}
+/**
+* Apply style reference to paragraph options
+*
+* This function handles the final step of adding a style ID reference to
+* paragraph options. It's called after data transformation is complete.
+*
+* @param paragraphOptions - Paragraph options from converter
+* @param styleId - Style ID to apply (optional)
+* @returns Paragraph options with style ID applied if provided
+*/
+function applyStyleReference(paragraphOptions, styleId) {
+	if (!styleId) return paragraphOptions;
+	return {
+		...paragraphOptions,
+		style: styleId
+	};
+}
+/**
+* Create a DOCX object from paragraph options
+*
+* This is the final step that creates actual DOCX instances from
+* pure data objects.
+*
+* @param options - Paragraph options or table
+* @returns DOCX Paragraph or Table instance
+*/
+function createDOCXObject(options) {
+	if (options instanceof Table) return 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 };