@betteroffice/docx 0.0.1 → 0.0.2

package/dist/docx/index.mjs

@@ -1,2 +1,2 @@
-export{h as getImageHeightPx,g as getImageWidthPx,j as getWrapDistancesPx,e as isBehindText,i as isDecorativeImage,d as isFloatingImage,f as isInFrontOfText,c as isInlineImage,a as parseDrawing,b as parseImage}from'../chunk-I6KKMUUC.mjs';import {a}from'../chunk-ZOV5KL7C.mjs';export{f as getEndnoteText,e as getFootnoteText,h as isSeparatorEndnote,g as isSeparatorFootnote,d as parseEndnoteProperties,b as parseEndnotes,c as parseFootnoteProperties,a as parseFootnotes}from'../chunk-OMR3TWCD.mjs';export{d as computeListRendering,c as createNumberingMap,e as formatNumber,h as getBulletCharacter,b as getCachedNumberingMap,i as isBulletLevel,a as parseNumbering,g as renderListMarker}from'../chunk-XWUOLYRQ.mjs';import {h,k,o,p,n,f,m,g,a as a$1,b,i,s,t,c,q as q$1,j as j$1,r,l,e}from'../chunk-HJGAQIU7.mjs';export{a as getDocumentWatermark,b as setDocumentWatermark}from'../chunk-WAUF2UC7.mjs';export{b as buildPatchedDocumentXml,a as validatePatchSafety}from'../chunk-KEE52TT5.mjs';import'../chunk-FZIA7OFY.mjs';export{a as attemptSelectiveSave}from'../chunk-OJOHXQNQ.mjs';export{s as createDocx,h as repackDocx,l as updateMultipleFiles}from'../chunk-KVKLLTDP.mjs';import'../chunk-BIQWVK5P.mjs';import {b as b$1}from'../chunk-3UBMCDME.mjs';export{b as emuToPixels,c as pixelsToEmu}from'../chunk-3UBMCDME.mjs';export{a as parseDocx}from'../chunk-LDUWIM7M.mjs';import'../chunk-DXKG3HQ5.mjs';import'../chunk-FPZBTOD6.mjs';import'../chunk-H3JCIGWK.mjs';import'../chunk-N5Q3YN64.mjs';import'../chunk-SINEY6ZF.mjs';import'../chunk-T4EZMUXM.mjs';import'../chunk-TTRUPDAB.mjs';var it=new Set(["decorative","modern","roman","script","swiss","auto"]),at=new Set(["default","fixed","variable"]);function V(e,t){let n=j$1(e,"w",t);if(!n)return;let r=o(n,"r","id");if(!r)return;let o$1={relId:r},l=o(n,"w","fontKey");l&&(o$1.fontKey=l);let i=o(n,"w","subsetted");return (i==="true"||i==="1")&&(o$1.subsetted=true),o$1}function lt(e){let t=o(e,"w","name");if(!t)return null;let n={name:t},r=j$1(e,"w","altName");if(r){let c=o(r,"w","val");c&&(n.altName=c);}let o$1=j$1(e,"w","family");if(o$1){let c=o(o$1,"w","val");c&&it.has(c)&&(n.family=c);}let l=j$1(e,"w","pitch");if(l){let c=o(l,"w","val");c&&at.has(c)&&(n.pitch=c);}let i=j$1(e,"w","charset");if(i){let c=o(i,"w","val");c&&(n.charset=c);}let a=j$1(e,"w","panose1");if(a){let c=o(a,"w","val");c&&(n.panose1=c);}let u=V(e,"embedRegular");u&&(n.embedRegular=u);let p=V(e,"embedBold");p&&(n.embedBold=p);let f=V(e,"embedItalic");f&&(n.embedItalic=f);let m=V(e,"embedBoldItalic");return m&&(n.embedBoldItalic=m),n}function st(e){if(!e||e.trim().length===0)return {fonts:[]};let t=h(e);if(!t)return console.warn("Failed to parse fontTable.xml"),{fonts:[]};let n=[];for(let r of k(t,"w","font")){let o=lt(r);o&&n.push(o);}return {fonts:n}}function ut(e,t,n,r,o,l){let i=e.includes("w")||e.includes("e"),a=e.includes("n")||e.includes("s"),u=e.includes("w")?-1:1,p=e.includes("n")?-1:1,f=i?r+t*u:r,m=a?o+n*p:o;if(i&&a&&l){let T=Math.max(f/r,m/o);f=r*T,m=o*T;}let c=T=>Math.max(20,Math.min(2e3,T));return {width:i?c(f):r,height:a?c(m):o}}function pt(e,t,n){let r=()=>t.position?.horizontal&&t.position.vertical?t.position:n?.initialPositionEmu?{horizontal:{relativeTo:"column",posOffset:n.initialPositionEmu.horizontalEmu},vertical:{relativeTo:"paragraph",posOffset:n.initialPositionEmu.verticalEmu}}:{horizontal:{relativeTo:"column",posOffset:0},vertical:{relativeTo:"paragraph",posOffset:0}};switch(e){case "inline":return {wrapType:"inline",displayMode:"inline",cssFloat:"none",wrapText:void 0,position:void 0,distTop:void 0,distBottom:void 0,distLeft:void 0,distRight:void 0};case "squareLeft":case "squareRight":{let o=e==="squareLeft"?"left":"right";return {wrapType:t.wrapType==="tight"||t.wrapType==="through"?t.wrapType:"square",displayMode:"float",cssFloat:o,wrapText:o==="left"?"right":"left",position:r()}}case "square":case "tight":case "through":{let o=t.cssFloat==="left"||t.cssFloat==="right"?t.cssFloat:"left";return {wrapType:e,displayMode:"float",cssFloat:o,wrapText:o==="left"?"right":"left",position:r()}}case "topAndBottom":return {wrapType:"topAndBottom",displayMode:"block",cssFloat:"none",wrapText:"bothSides",position:r()};case "behind":case "inFront":return {wrapType:e,displayMode:"float",cssFloat:"none",wrapText:"bothSides",position:r()}}}function ct(e,t){return e==="inline"?"inline":e==="behind"?"behind":e==="inFront"?"inFront":e==="square"||e==="tight"||e==="through"?t==="right"?"squareRight":"squareLeft":null}var ft=[{choice:"inline",i18nLabelKey:"inLineWithText",i18nDescKey:"inLineWithText",iconHint:"inline"},{choice:"squareLeft",i18nLabelKey:"squareLeft",i18nDescKey:"squareLeft",iconHint:"squareLeft"},{choice:"squareRight",i18nLabelKey:"squareRight",i18nDescKey:"squareRight",iconHint:"squareRight"},{choice:"behind",i18nLabelKey:"behindText",i18nDescKey:"behindText",iconHint:"behind"},{choice:"inFront",i18nLabelKey:"inFrontOfText",i18nDescKey:"inFrontOfText",iconHint:"inFront"}];function dt(e,t){return  true}function mt(e){switch(e){case "inline":return "inline";case "square":case "tight":case "through":return "squareLeft";case "topAndBottom":return "topAndBottom";case "behind":return "behind";case "inFront":return "inFront";case "wrapRight":return "squareLeft";case "wrapLeft":return "squareRight";default:return}}var Z=["PAGE","NUMPAGES","NUMWORDS","NUMCHARS","DATE","TIME","CREATEDATE","SAVEDATE","PRINTDATE","EDITTIME","AUTHOR","TITLE","SUBJECT","KEYWORDS","COMMENTS","FILENAME","FILESIZE","TEMPLATE","REVNUM","DOCPROPERTY","DOCVARIABLE","REF","PAGEREF","NOTEREF","HYPERLINK","TOC","TOA","INDEX","SEQ","STYLEREF","AUTONUM","AUTONUMLGL","AUTONUMOUT","SECTION","SECTIONPAGES","USERADDRESS","USERNAME","USERINITIALS","FORMTEXT","FORMCHECKBOX","FORMDROPDOWN","CITATION","BIBLIOGRAPHY","IF","MERGEFIELD","NEXT","NEXTIF","ASK","SET","QUOTE","INCLUDETEXT","INCLUDEPICTURE","SYMBOL","ADVANCE"];function $(e){let n=e.trim().match(/^\\?([A-Z][A-Z0-9]*)/i)?.[1]?.toUpperCase();return n&&Z.includes(n)?n:"UNKNOWN"}function ht(e){return Z.includes(e)}function gt(e){let t=e.trim(),n=t.match(/^\\?([A-Z][A-Z0-9]*)/i)?.[0]??"",r=t.slice(n.length).trim(),o=[],l=[],i=/\\(\*|@|#|!|[a-z])\s*(?:"([^"]*)"|([^\s]*))?/gi,a;for(;a=i.exec(r);)o.push({switch:a[1],...a[2]||a[3]?{value:a[2]||a[3]}:{}}),l.push(a.index);let u=r.slice(0,l[0]??r.length).trim(),p=u.startsWith('"')&&u.endsWith('"')?u.slice(1,-1):u||void 0;return {type:$(e),raw:e,...p?{argument:p}:{},switches:o}}function xt(e){return e.switches.find(t=>t.switch==="*"||t.switch==="@")?.value}function Tt(e){return e.switches.find(t=>t.switch==="*")?.value?.toUpperCase()==="MERGEFORMAT"}function bt(e,t,n){let r=o(e,"w","instr")??"",o$1=k(e,"w","r").map(i=>{let a=p(i);return {type:"run",content:a?[{type:"text",text:a}]:[]}}),l={type:"simpleField",instruction:r,fieldType:$(r),content:o$1};return /^(1|true)$/i.test(o(e,"w","fldLock")??"")&&(l.fldLock=true),/^(1|true)$/i.test(o(e,"w","dirty")??"")&&(l.dirty=true),o$1.length&&(l.structuredResult={inline:o$1},l.fieldTree={version:1,result:l.structuredResult,displayMode:"result"}),l}function yt(){return {state:"outside",instruction:"",codeRuns:[],resultRuns:[],fldLock:false,dirty:false,nestingLevel:0}}function wt(e){return (e.type==="simpleField"?e.content:e.fieldResult).map(St).join("")}function St(e){return e.type==="run"?le(e):e.children.filter(t=>t.type==="run").map(le).join("")}function le(e){return e.content.filter(t=>t.type==="text").map(t=>t.text).join("")}function Ft(e){return e.fieldType==="PAGE"}function Et(e){return e.fieldType==="NUMPAGES"}function Ct(e){return ["DATE","TIME","CREATEDATE","SAVEDATE","PRINTDATE","EDITTIME"].includes(e.fieldType)}function It(e){return ["AUTHOR","TITLE","SUBJECT","KEYWORDS","COMMENTS","FILENAME","FILESIZE","TEMPLATE","REVNUM","DOCPROPERTY","DOCVARIABLE"].includes(e.fieldType)}function At(e){return ["REF","PAGEREF","NOTEREF"].includes(e.fieldType)}function Mt(e){return ["MERGEFIELD","IF","NEXT","NEXTIF","ASK","SET"].includes(e.fieldType)}function Bt(e){return ["TOC","TOA","INDEX"].includes(e.fieldType)}function Pt(e,t,n$1=null,r=null,o$1=null,l,i=null){let a$1={type:"hyperlink",children:[]},u=o(e,"r","id");if(u){a$1.rId=u;let g=t?.get(u);g&&(a$1.href=a(g.target));}let p$1=o(e,"w","anchor");p$1&&(a$1.anchor=p$1.slice(0,1024),a$1.href||(a$1.href=`#${a$1.anchor}`));let f=o(e,"w","tooltip");f&&(a$1.tooltip=f.slice(0,2048));let m=o(e,"w","tgtFrame");m&&(a$1.target=m.slice(0,255));let c=o(e,"w","history");(c==="1"||c==="true")&&(a$1.history=true);let T=o(e,"w","docLocation");T&&(a$1.docLocation=T.slice(0,2048));for(let g of n(e).slice(0,1e4)){if(g.name?.replace(/^.*:/,"")!=="r")continue;let A=p(g);a$1.children.push({type:"run",content:A?[{type:"text",text:A}]:[]});}return a$1.children.length&&(a$1.structuredChildren=[...a$1.children]),a$1}function Lt(e){return e.children.filter(t=>t.type==="run").flatMap(t=>t.content).map(t=>t.type==="text"?t.text:t.type==="tab"?"	":"").join("")}function Rt(e){return e.href?/^https?:\/\/|^mailto:|^tel:|^ftp:/i.test(e.href):!!e.rId&&!e.anchor}function vt(e){return !!e.anchor}function Nt(e){return e.href}function Dt(e){return e.children.some(t=>t.type==="run")}function Ot(e){return e.children.filter(t=>t.type==="run")}function Xt(e,t){return e.rId&&(e.href=a(t.get(e.rId)?.target)),e.anchor&&!e.href&&(e.href=`#${e.anchor}`),e.href}function L(e,t){return n(e).find(n=>i(n.name??"")===t)??null}function P(e,t,n$1=0){if(!e||n$1>32)return null;for(let r of n(e)){if(i(r.name??"")===t)return r;let o=P(r,t,n$1+1);if(o)return o}return null}function N(e,t){let n=o(e,null,t);if(n==="1"||n==="true"||n==="on")return  true;if(n==="0"||n==="false"||n==="off")return  false}function E(e,t){let n=q$1(e,null,t);return n!==void 0&&Number.isFinite(n)?n:void 0}function kt(e){return e?l(e,"p").map(()=>({type:"paragraph",formatting:{},content:[]})):[]}function Ht(e$1,t){let n={t:"top",ctr:"middle",b:"bottom",dist:"distributed",just:"justified"},r=o(e$1,null,"anchor"),o$1=o(e$1,null,"vert"),l={left:E(e$1,"lIns"),right:E(e$1,"rIns"),top:E(e$1,"tIns"),bottom:E(e$1,"bIns")},i={content:kt(t)};o$1&&o$1!=="horz"&&(i.vertical=true);let a=e(o(e$1,null,"rot"));a!==void 0&&(i.rotation=a),r&&n[r]&&(i.anchor=n[r]);let u=N(e$1,"anchorCtr");return u!==void 0&&(i.anchorCenter=u),L(e$1,"noAutofit")?i.autoFit="none":L(e$1,"normAutofit")?i.autoFit="normal":L(e$1,"spAutoFit")&&(i.autoFit="shape"),Object.values(l).some(p=>p!==void 0)&&(i.margins=l),i}function se(e){let t=L(e,"spPr")??P(e,"spPr"),n=P(e,"cNvPr"),r=L(e,"bodyPr")??P(L(e,"txBody"),"bodyPr"),o$1=P(e,"txbxContent"),l=f(t?m(t,"a:xfrm"):null),i={type:"shape",shapeType:g(t),size:l.size};l.offset&&(i.offset=l.offset),l.transform&&(i.transform=l.transform);let a=a$1(t);a&&(i.fill=a);let u=b(t);return u&&(i.outline=u),n&&(i.id=o(n,null,"id")??void 0,i.name=o(n,null,"name")??void 0,i.title=o(n,null,"title")??void 0,i.description=o(n,null,"descr")??void 0,i.hidden=N(n,"hidden"),i.decorative=N(n,"decorative")),(o$1||r)&&(i.textBody=Ht(r,o$1)),i}function ue(e){return n(e).find(t=>{let n=i(t.name??"");return n==="inline"||n==="anchor"})??null}function Wt(e){let t$1=ue(e);if(!t$1)return null;let n$1=m(t$1,"a:graphicData");if(!n$1)return null;let r=n(n$1).find(u=>["wsp","sp","cxnSp"].includes(i(u.name??"")))??P(n$1,"wsp");if(!r)return null;let o$1=se(r),l=m(t$1,"wp:extent");l&&(o$1.size={width:E(l,"cx")??0,height:E(l,"cy")??0}),i(t$1.name??"")==="anchor"&&(o$1.position=s(t$1),o$1.wrap=t(t$1));let i$1=m(t$1,"wp:docPr");i$1&&(o$1.id=o(i$1,null,"id")??o$1.id,o$1.name=o(i$1,null,"name")??o$1.name,o$1.title=o(i$1,null,"title")??o$1.title,o$1.description=o(i$1,null,"descr")??o$1.description,o$1.hidden=N(i$1,"hidden")??o$1.hidden,o$1.decorative=N(i$1,"decorative")??o$1.decorative);let a=m(t$1,"wp:effectExtent");return a&&(o$1.effectExtent={left:E(a,"l"),top:E(a,"t"),right:E(a,"r"),bottom:E(a,"b")}),o$1.relativeHeight=o$1.position?.relativeHeight,o$1}function _t(e){let t=ue(e),n$1=t?m(t,"a:graphicData"):null;return n$1?n(n$1).some(r=>["wsp","wgp","wpc","spTree","grpSp","sp","cxnSp"].includes(i(r.name??""))):false}function Vt(e){return ["line","straightConnector1","bentConnector2","bentConnector3","bentConnector4","bentConnector5","curvedConnector2","curvedConnector3","curvedConnector4","curvedConnector5"].includes(e.shapeType)}function Ut(e){return e.shapeType==="textBox"||!!e.textBody?.content.length}function zt(e){return !!e.textBody?.content.length}function pe(e){return b$1(e.size.width)}function ce(e){return b$1(e.size.height)}function jt(e){return {width:pe(e),height:ce(e)}}function Kt(e){return e.position!==void 0||e.wrap!==void 0}function qt(e){return e.fill!==void 0&&e.fill.type!=="none"}function Gt(e){return e.outline!==void 0}function Yt(e){return e.outline?.width?b$1(e.outline.width):0}function Zt(e){return e.fill?.type==="solid"?c(e.fill.color):void 0}function $t(e){return e.outline?.color?c(e.outline.color):void 0}var J=720,Q="left",Jt="none";function fe(e){let t=q$1(e,"w","pos"),n=o(e,"w","val");if(t===void 0||!n)return null;let r={position:t,alignment:n},o$1=o(e,"w","leader");return o$1&&(r.leader=o$1),r}function de(e){if(!e)return [];let t=k(e,"w","tab");if(t.length===0)return [];let n=[];for(let r of t){let o=fe(r);o&&n.push(o);}return n.sort((r,o)=>r.position-o.position),n}function Qt(e){if(!e)return;let t=j$1(e,"w","tabs"),n=de(t);return n.length>0?n:void 0}function en(e,t){if(!e&&!t)return [];if(!e)return t??[];if(!t)return [...e];let n=new Map;for(let o of e)n.set(o.position,o);for(let o of t)o.alignment==="clear"?n.delete(o.position):n.set(o.position,o);let r=Array.from(n.values());return r.sort((o,l)=>o.position-l.position),r}function ee(e,t,n){for(let o of t)if(o.position>e&&o.alignment!=="clear")return o;let r=Math.ceil((e+1)/J)*J;return r>n?{position:n,alignment:Q}:{position:r,alignment:Q}}function tn(e,t,n){let r=ee(e,t,n);return Math.max(0,r.position-e)}function nn(e,t,n,r=0){let o=ee(e,t,n),l;switch(o.alignment){case "right":l=Math.max(0,o.position-e-r);break;case "center":l=Math.max(0,o.position-e-r/2);break;case "decimal":l=Math.max(0,o.position-e-r);break;case "bar":l=Math.max(0,o.position-e);break;default:l=Math.max(0,o.position-e);break}return {width:l,alignment:o.alignment}}function on(e){switch(e){case "dot":return ".";case "hyphen":return "-";case "underscore":return "_";case "heavy":return "_";case "middleDot":return "\xB7";default:return " "}}function rn(e){return e!==void 0&&e!=="none"}function an(e,t,n,r){return {...e&&e!=="auto"?{rgb:e}:{},...e==="auto"?{auto:true}:{},...t?{themeColor:t}:{},...n?{themeTint:n}:{},...r?{themeShade:r}:{}}}function D(e){if(!e)return;let n={style:o(e,"w","val")??"none"},r=q$1(e,"w","sz");r!==void 0&&(n.size=r);let o$1=q$1(e,"w","space");o$1!==void 0&&(n.space=o$1);let l=o(e,"w","color"),i=o(e,"w","themeColor"),a=o(e,"w","themeTint"),u=o(e,"w","themeShade");(l||i||a||u)&&(n.color=an(l,i,a,u));let p=o(e,"w","shadow");(p==="1"||p==="true")&&(n.shadow=true);let f=o(e,"w","frame");return (f==="1"||f==="true")&&(n.frame=true),n}function te(e){if(!e)return;let t=q$1(e,"w","w")??0,n=o(e,"w","type")??"dxa",r="dxa";return (n==="auto"||n==="dxa"||n==="nil"||n==="pct")&&(r=n),{value:t,type:r}}function C(e){return te(e)}function U(e){if(!e)return;let t={};for(let n of ["top","bottom","left","right","insideH","insideV","start","end","tl2br","tr2bl"]){let r=D(j$1(e,"w",n));r&&(t[n]=r);}return Object.keys(t).length>0?t:void 0}function z(e){if(!e)return;let t={},n=C(j$1(e,"w","top"));n&&(t.top=n);let r=C(j$1(e,"w","bottom"));r&&(t.bottom=r);let o=C(j$1(e,"w","left"));o&&(t.left=o);let l=C(j$1(e,"w","right"));l&&(t.right=l);let i=C(j$1(e,"w","start"));i&&(t.start=i);let a=C(j$1(e,"w","end"));if(a&&(t.end=a),Object.keys(t).length!==0)return t}function j(e){if(!e)return;let t={},n=o(e,"w","fill");n&&n!=="auto"&&(t.fill={rgb:n});let r=o(e,"w","themeFill");if(r){t.fill={themeColor:r};let a=o(e,"w","themeFillTint");a&&t.fill&&(t.fill.themeTint=a);let u=o(e,"w","themeFillShade");u&&t.fill&&(t.fill.themeShade=u);}let o$1=o(e,"w","color");o$1&&o$1!=="auto"&&(t.color={rgb:o$1});let l=o(e,"w","themeColor");l&&(t.color={...t.color??{},themeColor:l,themeTint:o(e,"w","themeTint")??void 0,themeShade:o(e,"w","themeShade")??void 0});let i=o(e,"w","val");if(i&&(t.pattern=i),Object.keys(t).length!==0)return t}function K(e){if(!e)return;let t={},n=o(e,"w","val");n&&(t.value=n.slice(0,8));let r=n?parseInt(n,16):NaN;Number.isNaN(r)||(t.firstRow=(r&32)!==0,t.lastRow=(r&64)!==0,t.firstColumn=(r&128)!==0,t.lastColumn=(r&256)!==0,t.noHBand=(r&512)!==0,t.noVBand=(r&1024)!==0);for(let[o$1,l]of [["firstRow","firstRow"],["lastRow","lastRow"],["firstColumn","firstColumn"],["lastColumn","lastColumn"],["noHBand","noHBand"],["noVBand","noVBand"]]){let i=o(e,"w",o$1);i!=null&&(t[l]=!/^(0|false|off)$/i.test(i));}if(Object.keys(t).length!==0)return t}function q(e){if(!e)return;let t={},n=o(e,"w","horzAnchor");(n==="margin"||n==="page"||n==="text")&&(t.horzAnchor=n);let r=o(e,"w","vertAnchor");(r==="margin"||r==="page"||r==="text")&&(t.vertAnchor=r);let o$1=q$1(e,"w","tblpX");o$1!==void 0&&(t.tblpX=o$1);let l=o(e,"w","tblpXSpec");l&&(t.tblpXSpec=l);let i=q$1(e,"w","tblpY");i!==void 0&&(t.tblpY=i);let a=o(e,"w","tblpYSpec");a&&(t.tblpYSpec=a);let u=q$1(e,"w","topFromText");u!==void 0&&(t.topFromText=u);let p=q$1(e,"w","bottomFromText");p!==void 0&&(t.bottomFromText=p);let f=q$1(e,"w","leftFromText");f!==void 0&&(t.leftFromText=f);let m=q$1(e,"w","rightFromText");if(m!==void 0&&(t.rightFromText=m),Object.keys(t).length!==0)return t}function me(e){return e.columnWidths&&e.columnWidths.length>0?e.columnWidths.length:e.rows.length===0?0:e.rows[0].cells.reduce((t,n)=>t+(n.formatting?.gridSpan??1),0)}function he(e){return e.rows.length}function ge(e){return e.formatting?.vMerge==="continue"}function xe(e){return e.formatting?.vMerge==="restart"}function Te(e){return e.rows.length===0?false:e.rows[0].formatting?.header===true}function ln(e){if(!e)return;let t={},n=C(j$1(e,"w","tblW"));n&&(t.width=n);let r$1=o(j$1(e,"w","jc"),"w","val");(r$1==="left"||r$1==="center"||r$1==="right"||r$1==="start")&&(t.justification=r$1==="start"?"left":r$1);let o$1=C(j$1(e,"w","tblCellSpacing"));o$1&&(t.cellSpacing=o$1);let l=C(j$1(e,"w","tblInd"));l&&(t.indent=l);let i=U(j$1(e,"w","tblBorders"));i&&(t.borders=i);let a=z(j$1(e,"w","tblCellMar"));a&&(t.cellMargins=a);let u=o(j$1(e,"w","tblLayout"),"w","type");(u==="fixed"||u==="autofit")&&(t.layout=u);let p=o(j$1(e,"w","tblStyle"),"w","val");p&&(t.styleId=p);let f=q$1(j$1(e,"w","tblStyleRowBandSize"),"w","val");f!==void 0&&f>0&&f<=1024&&(t.styleRowBandSize=f);let m=q$1(j$1(e,"w","tblStyleColBandSize"),"w","val");m!==void 0&&m>0&&m<=1024&&(t.styleColBandSize=m);let c=K(j$1(e,"w","tblLook"));c&&(t.look=c);let T=j(j$1(e,"w","shd"));T&&(t.shading=T);let g=o(j$1(e,"w","tblOverlap"),"w","val");(g==="never"||g==="overlap")&&(t.overlap=g);let A=q(j$1(e,"w","tblpPr"));return A&&(t.floating=A),r(j$1(e,"w","bidiVisual"))&&(t.bidi=true),Object.keys(t).length?t:void 0}var G=91440;function R(e,t){return n(e).find(n=>i(n.name??"")===t)??null}function I(e,t){let n=q$1(e,null,t);return n!==void 0&&Number.isFinite(n)?n:void 0}function sn(e$1){if(!e$1)return {};let t={left:I(e$1,"lIns"),right:I(e$1,"rIns"),top:I(e$1,"tIns"),bottom:I(e$1,"bIns")},n=Object.values(t).some(p=>p!==void 0),r={horz:"horizontal",vert:"vertical",vert270:"vertical270",wordArtVert:"wordArtVertical",wordArtVertRtl:"wordArtVertical",eaVert:"eastAsianVertical",mongolianVert:"mongolianVertical"},o$1={t:"top",ctr:"middle",b:"bottom",dist:"distributed",just:"justified"},l=o(e$1,null,"vert"),i=o(e$1,null,"anchor"),a=R(e$1,"normAutofit"),u={vertical:l?r[l]:void 0,rotation:e(o(e$1,null,"rot")),upright:o(e$1,null,"upright")==="1"||void 0,anchor:i?o$1[i]:void 0,anchorCenter:o(e$1,null,"anchorCtr")==="1"||void 0,columns:I(e$1,"numCol"),columnSpacing:I(e$1,"spcCol"),margins:n?t:void 0,autoFit:R(e$1,"noAutofit")?"none":a?"normal":R(e$1,"spAutoFit")?"shape":void 0,fontScale:I(a,"fontScale"),lineSpacingReduction:I(a,"lnSpcReduction")};return {...n?{margins:t}:{},...Object.values(u).some(p=>p!==void 0)?{bodyProperties:u}:{}}}function un(e){return {paragraphElements:l(e,"p"),tableElements:l(e,"tbl")}}function pn(e,t,n$1,r,o,l,i$1,a){if(!e)return [];let u=[];for(let p of n(e)){let f=i(p.name??"");f==="p"?u.push(t(p,r,o,l,i$1)):f==="tbl"&&n$1&&n$1(p,r,o,l,i$1,a);}return u}function be(e){let t=n(e).find(o=>["inline","anchor"].includes(i(o.name??"")))??null,n$1=t?m(t,"a:graphic"):null,r=n$1?m(n$1,"a:graphicData"):null;return {container:t,shape:r?m(r,"wps:wsp"):null}}function cn(e){let{shape:t}=be(e);return t?ne(t):false}function ne(e){return m(e,"wps:txbx")!==null}function ye(e,t,n,r){if(!ne(e))return null;let o$1=R(e,"spPr"),l=R(e,"bodyPr"),i=R(e,"cNvPr"),a=sn(l),u={type:"textBox",size:t,content:[]};u.id=o(i,null,"id")??void 0;let p=a$1(o$1);p&&(u.fill=p);let f=b(o$1);return f&&(u.outline=f),a.margins&&(u.margins=a.margins),a.bodyProperties&&(u.bodyProperties=a.bodyProperties),n&&(u.position=n),r&&(u.wrap=r),u}function fn(e){let{container:t$1,shape:n}=be(e);if(!t$1||!n)return null;let r=m(t$1,"wp:extent"),o$1={width:I(r,"cx")??0,height:I(r,"cy")??0},l=i(t$1.name??"")==="anchor",i$1=ye(n,o$1,l?s(t$1):void 0,l?t(t$1):void 0);return i$1&&(i$1.id=o(m(t$1,"wp:docPr"),null,"id")??i$1.id),i$1}function dn(e){return m(m(e,"wps:txbx"),"w:txbxContent")}function mn(e,t,n,r){return ye(e,t,n,r)}function we(e){return b$1(e.size.width)}function Se(e){return b$1(e.size.height)}function hn(e){return {width:we(e),height:Se(e)}}function gn(e){return {top:b$1(e.margins?.top??G),bottom:b$1(e.margins?.bottom??G),left:b$1(e.margins?.left??G),right:b$1(e.margins?.right??G)}}function xn(e){return e.position!==void 0||e.wrap!==void 0}function Tn(e){return e.fill!==void 0&&e.fill.type!=="none"}function bn(e){return e.outline!==void 0}function yn(e){return e.content.length>0}function wn(e){return e.content.map(t=>t.content.filter(n=>n.type==="run").flatMap(n=>n.content).filter(n=>n.type==="text").map(n=>n.text).join("")).join(`
-`)}function Sn(e){return e.fill?.type==="solid"?c(e.fill.color):void 0}function Fn(e){return e.outline?.color?c(e.outline.color):void 0}function En(e){return e.outline?.width?b$1(e.outline.width):0}function Cn(e,t){let n=t.filter(l=>l.parentId!=null);if(n.length===0)return;let r=new Map;for(let l of n){let i=r.get(l.parentId);i?i.push(l.id):r.set(l.parentId,[l.id]);}function o(l){for(let i of l)if(i.type==="paragraph"){if(!i.content.some(u=>u.type==="commentRangeStart"||u.type==="commentRangeEnd"))continue;let a=[];for(let u of i.content)if(u.type==="commentRangeStart"){a.push(u);let p=r.get(u.id);if(p)for(let f of p)a.push({type:"commentRangeStart",id:f});}else if(u.type==="commentRangeEnd"){a.push(u);let p=r.get(u.id);if(p)for(let f of p)a.push({type:"commentRangeEnd",id:f});}else a.push(u);i.content=a;}else if(i.type==="table")for(let a of i.rows)for(let u of a.cells)o(u.content);}o(e);}function In(e,t){let n=new Set(t.map(i=>i.id)),r=t.filter(i=>i.parentId!=null&&!n.has(i.parentId));if(r.length===0)return;let o=new Map;for(let i of r){let a=o.get(i.parentId);a?a.push(i.id):o.set(i.parentId,[i.id]);}function l(i){for(let a of i)if(a.type==="paragraph"){if(!a.content.some(m=>(m.type==="insertion"||m.type==="deletion")&&o.has(m.info.id)))continue;let p=[],f=a.content;for(let m=0;m<f.length;m++){let c=f[m];if((c.type==="insertion"||c.type==="deletion")&&o.has(c.info.id)){let T=o.get(c.info.id);for(let A of T)p.push({type:"commentRangeStart",id:A});p.push(c);let g=f[m+1];g&&(g.type==="insertion"||g.type==="deletion")&&g.type!==c.type&&g.info.author===c.info.author&&g.info.date===c.info.date&&(p.push(g),m++);for(let A of T)p.push({type:"commentRangeEnd",id:A});}else p.push(c);}a.content=p;}else if(a.type==="table")for(let u of a.rows)for(let p of u.cells)l(p.content);}l(e);}export{Q as DEFAULT_TAB_ALIGNMENT,J as DEFAULT_TAB_INTERVAL_TWIPS,Jt as DEFAULT_TAB_LEADER,ft as IMAGE_LAYOUT_OPTIONS,Z as KNOWN_FIELD_TYPES,ut as calculateResizedImageDimensions,tn as calculateTabWidth,nn as calculateTabWidthWithAlignment,yt as createComplexFieldContext,ct as deriveLayoutChoice,un as extractTextBoxContentElements,wt as getFieldDisplayValue,xt as getFormatSwitch,Ot as getHyperlinkRuns,Lt as getHyperlinkText,Nt as getHyperlinkUrl,on as getLeaderCharacter,ee as getNextTabStop,Yt as getOutlineWidthPx,jt as getShapeDimensionsPx,ce as getShapeHeightPx,pe as getShapeWidthPx,me as getTableColumnCount,he as getTableRowCount,dn as getTextBoxContentElement,hn as getTextBoxDimensionsPx,Se as getTextBoxHeightPx,gn as getTextBoxMarginsPx,En as getTextBoxOutlineWidthPx,wn as getTextBoxText,we as getTextBoxWidthPx,Dt as hasContent,qt as hasFill,Te as hasHeaderRow,Tt as hasMergeFormat,Gt as hasOutline,yn as hasTextBoxContent,Tn as hasTextBoxFill,bn as hasTextBoxOutline,zt as hasTextContent,rn as hasVisibleLeader,Cn as injectReplyRangeMarkers,In as injectTCReplyRangeMarkers,ge as isCellMergeContinuation,xe as isCellMergeStart,Ct as isDateTimeField,It as isDocPropertyField,Rt as isExternalLink,Kt as isFloatingShape,xn as isFloatingTextBox,dt as isImageLayoutOptionEnabled,vt as isInternalLink,ht as isKnownFieldType,Vt as isLineShape,Mt as isMergeField,Ft as isPageNumberField,At as isReferenceField,_t as isShapeDrawing,ne as isShapeTextBox,cn as isTextBoxDrawing,Ut as isTextBoxShape,Bt as isTocField,Et as isTotalPagesField,en as mergeTabStops,D as parseBorderSpec,z as parseCellMargins,gt as parseFieldInstruction,$ as parseFieldType,q as parseFloatingTableProperties,st as parseFontTable,Pt as parseHyperlink,j as parseShading,se as parseShape,Wt as parseShapeFromDrawing,bt as parseSimpleField,fe as parseTabStop,de as parseTabStops,Qt as parseTabStopsFromParagraphProperties,U as parseTableBorders,K as parseTableLook,te as parseTableMeasurement,ln as parseTableProperties,fn as parseTextBox,pn as parseTextBoxContent,mn as parseTextBoxFromShape,Zt as resolveFillColor,Xt as resolveHyperlinkUrl,pt as resolveImageLayoutAttrs,$t as resolveOutlineColor,Sn as resolveTextBoxFillColor,Fn as resolveTextBoxOutlineColor,mt as toolbarValueToLayoutTarget};
+import {e}from'../chunk-AEQOEQJ7.mjs';export{i as attemptSelectiveSave,h as createDocx,a as parseDocx,f as repackDocx,g as updateMultipleFiles}from'../chunk-AEQOEQJ7.mjs';import'../chunk-AZ52IWB6.mjs';import'../chunk-NJHOPXZW.mjs';import'../chunk-B4IR6YP4.mjs';import'../chunk-T4EZMUXM.mjs';import'../chunk-TTRUPDAB.mjs';function E(e,t,o,r,i,p){let a=e.includes("w")||e.includes("e"),s=e.includes("n")||e.includes("s"),u=e.includes("w")?-1:1,l=e.includes("n")?-1:1,m=a?r+t*u:r,f=s?i+o*l:i;if(a&&s&&p){let g=Math.max(m/r,f/i);m=r*g,f=i*g;}let d=g=>Math.max(20,Math.min(2e3,g));return {width:a?d(m):r,height:s?d(f):i}}function q(e,t,o){let r=()=>t.position?.horizontal&&t.position.vertical?t.position:o?.initialPositionEmu?{horizontal:{relativeTo:"column",posOffset:o.initialPositionEmu.horizontalEmu},vertical:{relativeTo:"paragraph",posOffset:o.initialPositionEmu.verticalEmu}}:{horizontal:{relativeTo:"column",posOffset:0},vertical:{relativeTo:"paragraph",posOffset:0}};switch(e){case "inline":return {wrapType:"inline",displayMode:"inline",cssFloat:"none",wrapText:void 0,position:void 0,distTop:void 0,distBottom:void 0,distLeft:void 0,distRight:void 0};case "squareLeft":case "squareRight":{let i=e==="squareLeft"?"left":"right";return {wrapType:t.wrapType==="tight"||t.wrapType==="through"?t.wrapType:"square",displayMode:"float",cssFloat:i,wrapText:i==="left"?"right":"left",position:r()}}case "square":case "tight":case "through":{let i=t.cssFloat==="left"||t.cssFloat==="right"?t.cssFloat:"left";return {wrapType:e,displayMode:"float",cssFloat:i,wrapText:i==="left"?"right":"left",position:r()}}case "topAndBottom":return {wrapType:"topAndBottom",displayMode:"block",cssFloat:"none",wrapText:"bothSides",position:r()};case "behind":case "inFront":return {wrapType:e,displayMode:"float",cssFloat:"none",wrapText:"bothSides",position:r()}}}function W(e,t){return e==="inline"?"inline":e==="behind"?"behind":e==="inFront"?"inFront":e==="square"||e==="tight"||e==="through"?t==="right"?"squareRight":"squareLeft":null}var _=[{choice:"inline",i18nLabelKey:"inLineWithText",i18nDescKey:"inLineWithText",iconHint:"inline"},{choice:"squareLeft",i18nLabelKey:"squareLeft",i18nDescKey:"squareLeft",iconHint:"squareLeft"},{choice:"squareRight",i18nLabelKey:"squareRight",i18nDescKey:"squareRight",iconHint:"squareRight"},{choice:"behind",i18nLabelKey:"behindText",i18nDescKey:"behindText",iconHint:"behind"},{choice:"inFront",i18nLabelKey:"inFrontOfText",i18nDescKey:"inFrontOfText",iconHint:"inFront"}];function B(e,t){return  true}function z(e){switch(e){case "inline":return "inline";case "square":case "tight":case "through":return "squareLeft";case "topAndBottom":return "topAndBottom";case "behind":return "behind";case "inFront":return "inFront";case "wrapRight":return "squareLeft";case "wrapLeft":return "squareRight";default:return}}function K(e,t){let o=t.filter(p=>p.parentId!=null);if(o.length===0)return;let r=new Map;for(let p of o){let a=r.get(p.parentId);a?a.push(p.id):r.set(p.parentId,[p.id]);}function i(p){for(let a of p)if(a.type==="paragraph"){if(!a.content.some(u=>u.type==="commentRangeStart"||u.type==="commentRangeEnd"))continue;let s=[];for(let u of a.content)if(u.type==="commentRangeStart"){s.push(u);let l=r.get(u.id);if(l)for(let m of l)s.push({type:"commentRangeStart",id:m});}else if(u.type==="commentRangeEnd"){s.push(u);let l=r.get(u.id);if(l)for(let m of l)s.push({type:"commentRangeEnd",id:m});}else s.push(u);a.content=s;}else if(a.type==="table")for(let s of a.rows)for(let u of s.cells)i(u.content);}i(e);}function X(e,t){let o=new Set(t.map(a=>a.id)),r=t.filter(a=>a.parentId!=null&&!o.has(a.parentId));if(r.length===0)return;let i=new Map;for(let a of r){let s=i.get(a.parentId);s?s.push(a.id):i.set(a.parentId,[a.id]);}function p(a){for(let s of a)if(s.type==="paragraph"){if(!s.content.some(f=>(f.type==="insertion"||f.type==="deletion")&&i.has(f.info.id)))continue;let l=[],m=s.content;for(let f=0;f<m.length;f++){let d=m[f];if((d.type==="insertion"||d.type==="deletion")&&i.has(d.info.id)){let g=i.get(d.info.id);for(let y of g)l.push({type:"commentRangeStart",id:y});l.push(d);let h=m[f+1];h&&(h.type==="insertion"||h.type==="deletion")&&h.type!==d.type&&h.info.author===d.info.author&&h.info.date===d.info.date&&(l.push(h),f++);for(let y of g)l.push({type:"commentRangeEnd",id:y});}else l.push(d);}s.content=l;}else if(s.type==="table")for(let u of s.rows)for(let l of u.cells)p(l.content);}p(e);}function $(e){let t=e?.package.headers;if(t){for(let o of t.values())if(o.watermark)return o.watermark}}function G(e){let t=e.package.headers;if(!t||t.size===0)return e;let o=false,r=new Map;for(let[i,p]of t)if(p.watermark){let{watermark:a,...s}=p;r.set(i,s),o=true;}else r.set(i,p);return o?{...e,package:{...e.package,headers:r}}:e}function N(e,t){let o=e.package.headers;if(!o||o.size===0)return e;let r=new Map;for(let[i,p]of o)r.set(i,{...p,watermark:{...t}});return {...e,package:{...e.package,headers:r}}}function j(e){let t=e.package.document,o=[];if(t.sections)for(let r of t.sections)r.properties&&o.push(r.properties);return t.finalSectionProperties&&o.push(t.finalSectionProperties),o}function U(e$1,t){let o=e$1.package,r=o.document,i=o.headers,p=j(e$1),a=new Set;if(i)for(let n of i.values())a.add(n.hdrFtrType);let s=!i||i.size===0,u=p.some(n=>n.titlePg),l=p.some(n=>n.evenAndOddHeaders),m=s,f=u&&!a.has("first"),d=l&&!a.has("even");if(!m&&!f&&!d)return e$1;let g=o.relationships?new Map(o.relationships):new Map,h=new Map(i??[]),y=new Set;for(let n of g.values())n.target&&y.add(n.target.replace(/^\/?word\//,"").toLowerCase());function P(){let n=1;for(;y.has(`header${n}.xml`);)n++;let c=`header${n}.xml`;return y.add(c.toLowerCase()),c}function v(n){let c=`rIdWmHdr${n[0].toUpperCase()}${n.slice(1)}`,I=1;for(;g.has(c);)c=`rIdWmHdr${n[0].toUpperCase()}${n.slice(1)}${I++}`;return g.set(c,{id:c,type:e.header,target:P()}),h.set(c,{type:"header",hdrFtrType:n,content:[],watermark:{...t}}),c}let T={};function F(n){return T[n]??(T[n]=v(n))}function L(n,c){let I=n?.headerReferences?[...n.headerReferences]:[];return I.some(S=>S.type===c)?n??{}:(I.push({type:c,rId:F(c)}),{...n??{},headerReferences:I})}function w(n){let c=n;return m&&(c=L(c,"default")),f&&c?.titlePg&&(c=L(c,"first")),d&&c?.evenAndOddHeaders&&(c=L(c,"even")),c}let M=w(r.finalSectionProperties),k=r.sections?.map(n=>({...n,properties:w(n.properties)??n.properties}));return {...e$1,package:{...o,relationships:g,headers:h,document:{...r,finalSectionProperties:M,...k?{sections:k}:{}}}}}function Y(e,t){if(!t)return G(e);let o=N(e,t);return U(o,t)}
+export{_ as IMAGE_LAYOUT_OPTIONS,E as calculateResizedImageDimensions,W as deriveLayoutChoice,$ as getDocumentWatermark,K as injectReplyRangeMarkers,X as injectTCReplyRangeMarkers,B as isImageLayoutOptionEnabled,q as resolveImageLayoutAttrs,Y as setDocumentWatermark,z as toolbarValueToLayoutTarget};

package/dist/editor/index.d.mts

@@ -1,170 +1,54 @@
-import { P as PageMargins, C as ColumnLayout, e as LayoutBlock, B as BlockExtent, a as Layout, H as HeaderFooterContent, h as FootnoteRenderItem } from '../types-DNrYr6yQ.mjs';
-import { t as toMeasuredBlocks } from '../measuredBlock-DZwz8zhD.mjs';
-import { L as LayoutPaginationSource } from '../rustPagination-Bj2hq013.mjs';
+import { R as ResidentMeasurementConfig } from '../rustMeasureSource-D1KsQvVC.mjs';
+import { L as LayoutBlock, B as BlockExtent, a as Layout, b as LayoutOptions } from '../types-DMkDbvEu.mjs';
+import { MeasuredBlock } from '../layout/pagination/index.mjs';
+import { D as DisplayListHeadersFooters } from '../rustDisplayList-CX78djsZ.mjs';
 import { Document } from '../types/document.mjs';
-import { a as Theme } from '../formatting-DoL7KBSL.mjs';
-import { S as SectionProperties, m as HeaderFooter, W as Watermark } from '../content-sSHuWw49.mjs';
-import { F as FloatPageGeometry } from '../measureBlocksPipeline-Df0Bbrwy.mjs';
-import { a as DisplayListHeadersFooters } from '../rustDisplayList-dqunvwxH.mjs';
-import { a as StyleDefinitions } from '../styles-VxNcXLdi.mjs';
-import '../settingsParser-CcGvtmCK.mjs';
+import { Y as YrsSession, a as YrsRenderEnv } from '../index-Bwxm3oiC.mjs';
+import { S as SectionProperties, N as NoteKind } from '../content-DLFHRQav.mjs';
+import '../formatting-D1EPSaJP.mjs';
+import '../styles-Dn_o3Vo5.mjs';
 import '../docx/wrapTypes.mjs';
 
-/**
- * The pure layout COMPUTE pass shared by the React and Vue adapters — issue
- * #696 Tier 2, the clean half of the engine spine.
- *
- * This is the 6-step pass from React's `useLayoutPipeline` minus the paint
- * + scroll/event side-effects (which stay adapter-side, where the framework
- * timing lives): PM doc → flow blocks → measure → header/footer resolve →
- * margin extension → Rust pagination (+ two-pass footnote stabilization) →
- * footnote render items. It is pure (no DOM, no refs, no rAF) and returns
- * everything the adapter needs to render.
- *
- * Two injected seams: `measureBlocks` (each adapter passes the Rust
- * measurement implementation) and `paginationSource` (the mandatory Rust
- * pagination engine — every pagination pass, including each footnote
- * stabilization iteration, runs through it). `getHfPmDoc` is the
- * HF-unification seam (prefer the persistent PM doc over re-parsing
- * `HeaderFooter.content`).
- */
-
-interface PageSizePx {
-    w: number;
-    h: number;
+interface ResidentRegionLayoutRequest {
+    bodyStory: 'body';
+    options: Pick<LayoutOptions, 'contractVersion' | 'pageGap'>;
+    regions: {
+        sections: Array<{
+            sectionId?: string;
+            properties: SectionProperties;
+        }>;
+        settings?: Document['package']['settings'];
+        watermark?: SectionProperties['watermark'];
+    };
+    notes: {
+        contents: Array<{
+            id: number;
+            noteKind: NoteKind;
+            height: 0;
+        }>;
+    };
+    renderEnv: YrsRenderEnv;
+    measurement?: ResidentMeasurementConfig;
 }
-/** Adapter-supplied block measurer (React's is caching). */
-type MeasureBlocksFn = (blocks: LayoutBlock[], contentWidth: number | number[], pageGeometry?: FloatPageGeometry) => BlockExtent[];
 interface ComputeLayoutInputs {
-    /** Legacy tree state; null when an adapter supplies yrs body blocks. */
-    state: {
-        readonly doc: {
-            readonly attrs: Record<string, any>;
-        };
-    } | null;
     document: Document | null;
-    pageSize: PageSizePx;
-    margins: PageMargins;
-    columns: ColumnLayout | undefined;
-    finalPageSize: PageSizePx;
-    finalMargins: PageMargins;
-    finalColumns: ColumnLayout | undefined;
     pageGap: number;
-    contentWidth: number;
-    theme: Theme | null | undefined;
-    styles: StyleDefinitions | null | undefined;
-    sectionProperties: SectionProperties | null | undefined;
-    finalSectionProperties: SectionProperties | null | undefined;
-    /** Resolved HF objects for the section (default + first-page). */
-    headerContent: HeaderFooter | null | undefined;
-    footerContent: HeaderFooter | null | undefined;
-    firstPageHeaderContent: HeaderFooter | null | undefined;
-    firstPageFooterContent: HeaderFooter | null | undefined;
-    /** Optional adapter-owned body source; null falls back to ProseMirror lowering. */
-    yrsBodyBlocks?: (env: {
-        pageContentHeight: number;
-    }) => LayoutBlock[] | null;
-    /** Optional adapter-owned non-body story source; null preserves PM lowering. */
-    yrsStoryBlocks?: (storyId: string) => LayoutBlock[] | null;
-    measureBlocks: MeasureBlocksFn;
-    /**
-     * The mandatory Rust pagination engine
-     * (`layout/pagination/rustPagination.ts`). Every pagination pass — full,
-     * footnote pass 1, and each footnote-stabilization iteration — runs
-     * `paginationSource.paginate(measured, options)`. The caller must gate
-     * layout passes on the source's readiness (`isReady()` / `whenReady()`);
-     * `paginate` throws on an unloaded engine or an engine failure and the
-     * pipeline surfaces the error.
-     *
-     * The Rust engine keeps no resume checkpoints: every pass is a full
-     * relayout in native code — the measured wager that replaced the TS
-     * incremental/off-thread kernels.
-     */
-    paginationSource: LayoutPaginationSource;
+    session: Pick<YrsSession, 'layoutDocumentWithRegionsJson'>;
+    renderEnv: YrsRenderEnv;
+    measurement: ResidentMeasurementConfig;
 }
 interface LayoutComputation {
     blocks: LayoutBlock[];
     measures: BlockExtent[];
     layout: Layout;
-    headerContentForRender: HeaderFooterContent | undefined;
-    footerContentForRender: HeaderFooterContent | undefined;
-    firstPageHeaderForRender: HeaderFooterContent | undefined;
-    firstPageFooterForRender: HeaderFooterContent | undefined;
-    hasTitlePg: boolean;
-    watermark: Watermark | undefined;
-    headerDistancePx: number | undefined;
-    footerDistancePx: number | undefined;
-    pageBorders: SectionProperties['pageBorders'] | undefined;
-    footnotesByPage: Map<number, FootnoteRenderItem[]> | undefined;
+    notesConverged: boolean;
 }
-/**
- * The `{ measured, options }` pair a Layout was paginated from, when that
- * Layout came out of a compute call in this session, plus the `headersFooters`
- * payload assembled from the same HF contents/page-level watermark the pages
- * render with. The canvas renderer joins this with the Layout itself into the
- * `{ measured, options, layout, headersFooters }` envelope the Rust
- * display-list builder consumes. Every compute path (including footnote
- * stabilization) records its final layout here; undefined means the Layout
- * did not come from a compute call in this session.
- */
+declare function buildResidentRegionLayoutRequest(document: Document | null, pageGap: number, renderEnv: YrsRenderEnv): ResidentRegionLayoutRequest;
 declare function getLayoutKernelInputs(layout: Layout): {
-    measured: ReturnType<typeof toMeasuredBlocks>;
+    measured: MeasuredBlock[];
     options: unknown;
     headersFooters?: DisplayListHeadersFooters;
 } | undefined;
-/**
- * Run the pure layout compute pass (the 6 steps in this file's header).
- * Every pagination pass runs through the injected Rust pagination source —
- * the sole layout kernel. The wasm engine is synchronous native code, so
- * edits and opens alike take this one full-pass path (the Rust engine keeps
- * no resume checkpoints; incremental resume and the off-thread worker died
- * with the TS kernel).
- */
 declare function computeLayout(inputs: ComputeLayoutInputs): LayoutComputation;
 
-/**
- * rAF-coalescing layout scheduler shared by the React and Vue adapters
- * (issue #696 Tier 2). Rapid doc-changing transactions (a burst of
- * keystrokes) collapse to a single layout pass per animation frame: while a
- * frame is pending, later `schedule` calls just replace the target state, so
- * only the final state lays out.
- *
- * `scheduleFrame`/`cancelFrame` are injected so a headless/test host can pass
- * a synchronous stub; they default to requestAnimationFrame.
- */
-interface LayoutScheduler<TState = unknown> {
-    /** Request a layout for `state`, coalesced into the pending frame. */
-    schedule(state: TState): void;
-    /** Cancel any pending frame (call on teardown). */
-    cancel(): void;
-}
-declare function createLayoutScheduler<TState>(run: (state: TState) => void, scheduleFrame?: (cb: () => void) => number, cancelFrame?: (handle: number) => void): LayoutScheduler<TState>;
-
-/**
- * Strip ProseMirror's internal `UPDATED_SCROLL` flag from a transaction so the
- * hidden, off-screen editor's `updateState` does not force-scroll its ancestors
- * to the selection — the paginated painter owns scroll, not the PM view.
- *
- * Shared by both adapters' `dispatchTransaction` (issue #696 Tier 2). React has
- * always done this; Vue did not, so its hidden editor could yank an ancestor's
- * scroll on edit. Centralizing the magic bit + the drift canary here keeps the
- * two in lockstep.
- *
- * `Transaction.updated` is a private bitfield in `prosemirror-state` whose
- * `UPDATED_SCROLL` bit is not exported. It is `4` in current PM
- * (state/src/transaction.ts). If a future PM release renumbers the bits before
- * SCROLL, `assertScrollFlagShape` logs once so the constant can be updated.
- */
-/** Minimal transaction shape used by the legacy scroll-flag compatibility seam. */
-interface ScrollFlagTransaction {
-    scrollIntoView(): ScrollFlagTransaction;
-}
-/**
- * Clear the scroll-into-view flag on `transaction` in place. Call inside
- * `dispatchTransaction` before `state.apply(transaction)`. `probeTr` should be
- * a fresh `view.state.tr` used only for the one-shot drift canary (so the real
- * transaction is never mutated by the probe).
- */
-declare function stripScrollFlag(transaction: ScrollFlagTransaction, probeTr: ScrollFlagTransaction): void;
-
-export { type ComputeLayoutInputs, type LayoutComputation, type LayoutScheduler, type MeasureBlocksFn, computeLayout, createLayoutScheduler, getLayoutKernelInputs, stripScrollFlag };
+export { type ComputeLayoutInputs, type LayoutComputation, buildResidentRegionLayoutRequest, computeLayout, getLayoutKernelInputs };

package/dist/editor/index.mjs

@@ -1 +1 @@
-import {I,f as f$1,w,g,j,e,n,o,l,a as a$1,C,t,b}from'../chunk-P3KDV4M2.mjs';import {f,g as g$1}from'../chunk-7DEIW7FL.mjs';import {c}from'../chunk-IL5JZJT7.mjs';import'../chunk-GWKJ2Y4Y.mjs';import'../chunk-52GB3Y42.mjs';import {a}from'../chunk-7PCO5I2O.mjs';import {d}from'../chunk-X4XDO3LZ.mjs';import'../chunk-L5ISVQ3W.mjs';import'../chunk-OMR3TWCD.mjs';import {e as e$1}from'../chunk-XWUOLYRQ.mjs';import'../chunk-HJGAQIU7.mjs';import'../chunk-FZIA7OFY.mjs';import'../chunk-OBQGPMPQ.mjs';import'../chunk-3UBMCDME.mjs';import'../chunk-FPZBTOD6.mjs';import'../chunk-H3JCIGWK.mjs';import'../chunk-SINEY6ZF.mjs';import'../chunk-T4EZMUXM.mjs';import'../chunk-TTRUPDAB.mjs';function fe(t,a){let r=t?.package?.document;if(!r)return;let o=[...(r.sections??[]).map(n=>n.properties),r.finalSectionProperties];return a.sectionIndex!==void 0?o[a.sectionIndex]??r.finalSectionProperties:o.find(n=>(n?.footnoteColumns??1)>1)??o[0]}function le(t){let a=t?.package?.document;return a?[...(a.sections??[]).map(r=>r.properties),a.finalSectionProperties]:[]}function me(t,a){let r={},o=(n,c,e)=>{let i=`${n}${c==="default"?"Default":c==="first"?"First":"Even"}`;r[i]=e;};for(let n=0;n<=a;n++){let c=t[n];for(let e of c?.headerReferences??[])o("header",e.type,e.rId);for(let e of c?.footerReferences??[])o("footer",e.type,e.rId);}return Object.keys(r).length?r:void 0}function Me(t,a){let{document:r,sectionProperties:o}=t.inputs,n=le(r),c=new Map;for(let e of a.pages){let s=e.sectionIndex??(n.length===1?0:void 0);e.sectionIndex===void 0&&s!==void 0&&(e.sectionIndex=s);let i=s!==void 0?n[s]??o:o;if(!i){t.watermark!==void 0&&e.watermark===void 0&&(e.watermark=t.watermark);continue}if(s!==void 0){let f=e.sectionId??String(s),l=c.get(f)??0,m=e.sectionPageIndex??l;c.set(f,Math.max(l,m)+1),e.sectionPageIndex=m,e.headerFooterRefs??(e.headerFooterRefs=me(n,s));let d=e.pageNumbering??i.pageNumbering;if(d){e.pageNumbering=d;let u=e.sectionPageNumber??(d.start??1)+m;e.sectionPageNumber=u,e.pageLabel??(e.pageLabel=e$1(u,d.format??"decimal"));}}e.headerDistance===void 0&&i.headerDistance!=null&&(e.headerDistance=C(i.headerDistance)),e.footerDistance===void 0&&i.footerDistance!=null&&(e.footerDistance=C(i.footerDistance)),e.pageBorders??(e.pageBorders=i.pageBorders),e.watermark??(e.watermark=i.watermark??t.watermark),e.verticalAlign??(e.verticalAlign=i.verticalAlign);}}function xe(t,a,r){let o=fe(t,a);if(!o?.footnoteColumns)return {columns:1,columnWidth:r};let n=o.footnoteColumns,e=((o.pageWidth!=null?C(o.pageWidth-(o.marginLeft??1440)-(o.marginRight??1440)):r)-(n-1)*b)/n;return {columns:n,columnWidth:Math.max(1,e)}}var pe=new WeakMap;function Be(t,a){return Me(t,a),pe.set(a,{measured:t.measured,options:t.layoutOpts,headersFooters:Ie(t,a.pages)}),a}function De(t,a){let r=String(a.length),o=[],n=(c,e)=>{let s=g$1(c,e);return s.active?s.width:void 0};for(let c of t.blocks)if(c.kind==="paragraph")for(let e of c.runs){if(e.kind!=="field"||e.fieldType!=="PAGE"&&e.fieldType!=="NUMPAGES"||e.pmStart===void 0)continue;let s={fontFamily:e.fontFamily??"Calibri",fontSize:e.fontSize??11,bold:e.bold,italic:e.italic},i=n(e.fallback||"1",s);if(i===void 0)continue;let f=[],l=true;for(let m of a){let d=n(e.fieldType==="NUMPAGES"?r:m.pageLabel??String(m.number),s);if(d===void 0){l=false;break}f.push(d);}l&&o.push({pmStart:e.pmStart,fallbackWidth:i,perPage:f});}return o.length>0?o:void 0}function Ie(t,a$1){let{inputs:r,hasTitlePg:o}=t,n=r.document?.package,c=(l,m)=>{if(!(!l||!m)){for(let[d,u]of l)if(u===m)return d}},e=[],s=(l,m,d,u)=>{if(!u||u.blocks.length===0)return;let g=De(u,a$1);e.push({rId:c(l==="header"?n?.headers:n?.footers,d)??"",kind:l,type:m,measured:a(u.blocks,u.measures),height:u.height,...u.flowHeight!==void 0?{flowHeight:u.flowHeight}:{},...u.visualTop!==void 0?{visualTop:u.visualTop}:{},...u.visualBottom!==void 0?{visualBottom:u.visualBottom}:{},...g?{fieldWidths:g}:{}});};s("header","default",r.headerContent,t.headerContentForRender),s("footer","default",r.footerContent,t.footerContentForRender),s("header","first",r.firstPageHeaderContent,t.firstPageHeaderForRender),s("footer","first",r.firstPageFooterContent,t.firstPageFooterForRender),s("header","even",t.evenPageHeader,t.evenPageHeaderForRender),s("footer","even",t.evenPageFooter,t.evenPageFooterForRender);let i=t.watermark;if(e.length===0&&!i)return;let{sectionProperties:f}=r;return {titlePg:o,evenAndOddHeaders:t.evenAndOddHeaders,...f?.headerDistance!=null?{headerDistance:C(f.headerDistance)}:{},...f?.footerDistance!=null?{footerDistance:C(f.footerDistance)}:{},...i?{watermark:i}:{},variants:e}}function we(t){return pe.get(t)}function Ee(t){let a=Oe(t),{layout:r,footnotesByPage:o}=a.hasFootnotes?We(a):{layout:t.paginationSource.paginate(a.measured,a.layoutOpts),footnotesByPage:void 0};return Be(a,r),_e(a,r,o)}function Oe(t$1){f();let{state:a$1,document:r,pageSize:o,margins:n,columns:c$1,finalPageSize:e,finalMargins:s,finalColumns:i,pageGap:f$2,contentWidth:l,theme:m,styles:d$1,sectionProperties:u,finalSectionProperties:g,headerContent:b,footerContent:C,firstPageHeaderContent:R,firstPageFooterContent:L,measureBlocks:k}=t$1,p=o.h-n.top-n.bottom,y=t$1.yrsBodyBlocks?.({pageContentHeight:p})??(a$1?c(a$1.doc,{theme:m,pageContentHeight:p}):(()=>{throw new Error("computeLayout requires either yrsBodyBlocks or a ProseMirror state")})()),h=I(y,{pageSize:o,margins:n,columns:c$1},{pageSize:e,margins:s,columns:i});let F=k(y,h,d({size:o,margins:n})),T=f$1(y),D=T.some(P=>P.noteKind==="endnote"?!!r?.package?.endnotes?.length:!!r?.package?.footnotes?.length),I$1={section:"header",pageSize:o,margins:n},w$1={section:"footer",pageSize:o,margins:n},he=a$1?.doc.attrs?.defaultTabStopTwips??r?.package.settings?.defaultTabStop??null,Pe={styles:d$1,theme:m,measureBlocks:k,defaultTabStopTwips:he,yrsStoryBlocks:t$1.yrsStoryBlocks},Fe=P=>{let v=r?.package;if(v){for(let x of [v.headers,v.footers])if(x){for(let[ve,Te]of x)if(Te===P)return `hf:${ve}`}}},H=(P,v)=>{if(!P)return;let x=t$1.yrsStoryBlocks?Fe(P):void 0;return t(P,l,v,Pe,x)},K=H(b,I$1),G=H(C,w$1),E=u?.titlePg===true,U=E?H(R,I$1):void 0,$=E?H(L,w$1):void 0,V=le(r),be=Math.max(0,V.findIndex(P=>P===u)),M=me(V,be),q=M?.headerEven?r?.package?.headers?.get(M.headerEven):void 0,j=M?.footerEven?r?.package?.footers?.get(M.footerEven):void 0,X=H(q,I$1),J=H(j,w$1),Le=r?.package?.settings?.evenAndOddHeaders===true||u?.evenAndOddHeaders===true,ke=a$1?.doc.attrs?.watermark??g?.watermark??void 0,{margins:Se,finalMargins:Ce}=w({pageSize:o,margins:n,finalMargins:s,bodyBlocks:y,headers:[K,U,X],footers:[G,$,J],warn:P=>console.warn(`[computeLayout] ${P}`)}),He=g?.sectionStart,Re={pageSize:o,margins:Se,finalPageSize:e,finalMargins:Ce,columns:i,bodyBreakType:He,pageGap:f$2};return {measured:a(y,F),layoutOpts:Re,hasFootnotes:D,footnoteRefs:T,blocks:y,measures:F,headerContentForRender:K,footerContentForRender:G,firstPageHeaderForRender:U,firstPageFooterForRender:$,evenPageHeader:q,evenPageFooter:j,evenPageHeaderForRender:X,evenPageFooterForRender:J,evenAndOddHeaders:Le,hasTitlePg:E,watermark:ke,inputs:t$1}}function We(t){let{measured:a,layoutOpts:r,footnoteRefs:o$1,blocks:n$1,measures:c,inputs:e$1}=t,{document:s,contentWidth:i,styles:f,theme:l,measureBlocks:m,state:d}=e$1,u=d?.doc.attrs?.defaultTabStopTwips??s?.package.settings?.defaultTabStop??null,g$1=(h,F)=>e$1.paginationSource.paginate(h,F),b=g$1(a,r),C=g(b.pages,o$1),R=new Map,L=new Map;for(let h of b.pages){let{columns:F,columnWidth:T}=xe(s,h,i);R.set(h.number,F);for(let D of C.get(h.number)??[])L.set(D,T);}let k=Ae(o$1,b.pages,s,C),p=j(s.package.footnotes??[],s.package.endnotes??[],o$1,h=>L.get(e(h))??i,{styles:f??void 0,theme:l??null,measureBlocks:m,defaultTabStopTwips:u,yrsStoryBlocks:e$1.yrsStoryBlocks},k),y=n({blocks:n$1,measures:c,layoutOpts:r,paginate:g$1,footnoteRefs:o$1,footnoteContentMap:p,initialLayout:b,footnoteColumns:R,mapReferencesToPages:(h,F)=>Ne(h,F,s)});return ze(y.layout,y.pageFootnoteMap,p,s),{layout:y.layout,footnotesByPage:o(y.pageFootnoteMap,p,s)}}function _(t,a,r){let o=t?.package?.settings,n=fe(t,a);return r==="endnote"?{...o?.endnotePr??{},...n?.endnotePr??{}}:{...o?.footnotePr??{},...n?.footnotePr??{}}}function ge(t,a,r){let o=[...a].find(([,n])=>n.includes(r))?.[0];return t.find(n=>n.number===o)}function Ne(t,a,r){let o=g(t,a),n=new Map,c=(e,s)=>{let i=n.get(e)??[];i.includes(s)||i.push(s),n.set(e,i);};for(let e$1 of a){let s=e(e$1),i=ge(t,o,s);if(!i)continue;let f=e$1.noteKind??"footnote",m=_(r,i,f).position??(f==="endnote"?"docEnd":"pageBottom"),d=i;if(m==="docEnd")d=t[t.length-1]??i;else if(m==="sectEnd"){let u=t.filter(g=>i.sectionId!==void 0?g.sectionId===i.sectionId:i.sectionIndex!==void 0?g.sectionIndex===i.sectionIndex:true);d=u[u.length-1]??i;}c(d.number,s);}return n}function Ae(t,a,r,o){let n=new Map,c=new Map;for(let e$2 of t){let s=e(e$2);if(n.has(s))continue;let i=ge(a,o,s);if(!i)continue;let f=e$2.noteKind??"footnote",l=_(r,i,f),m=l.numRestart==="eachPage"?`${f}:page:${i.number}`:l.numRestart==="eachSect"?`${f}:section:${i.sectionId??i.sectionIndex??0}`:`${f}:continuous`,d=c.get(m)??l.numStart??1;c.set(m,d+1),n.set(s,{displayNumber:d,displayLabel:e$1(d,l.numFmt??"decimal"),anchor:{docStart:e$2.pmPos,docEnd:e$2.pmPos+1}});}return n}function ze(t,a,r,o){for(let n of t.pages){let c=a.get(n.number);if(!c?.length)continue;let e=c.map(d=>r.get(d)).filter(d=>d!==void 0);if(!e.length)continue;let s=n.size.h-n.margins.bottom,i=n.fragments.reduce((d,u)=>Math.max(d,u.y+u.height),n.margins.top),f=new Map;for(let d of e){let u=d.noteKind??"footnote",g=f.get(u)??[];g.push(d),f.set(u,g);}let l$1=s,m=i;n.noteAreas=[...f].map(([d,u])=>{let b=_(o,n,d).position??(d==="endnote"?"docEnd":"pageBottom"),C=d==="footnote"?n.footnoteColumns??1:1,L=l(u,C).reduce((p,y)=>Math.max(p,y.reduce((h,F)=>h+F.height,0)),0)+a$1,k;return b==="beneathText"?(k=Math.min(m,s-L),m=k+L):(l$1-=L,k=l$1),{kind:d,placement:b,y:k,height:L,columns:C,sectionId:n.sectionId,notes:u.map(p=>({kind:d,id:p.id,displayLabel:p.displayLabel??String(p.displayNumber),blocks:p.blocks,measures:p.measures,height:p.height,anchorDocStart:p.anchor?.docStart,anchorDocEnd:p.anchor?.docEnd,customMarkFollows:p.customMarkFollows}))}});}}function _e(t,a,r){let{sectionProperties:o}=t.inputs;return {blocks:t.blocks,measures:t.measures,layout:a,headerContentForRender:t.headerContentForRender,footerContentForRender:t.footerContentForRender,firstPageHeaderForRender:t.firstPageHeaderForRender,firstPageFooterForRender:t.firstPageFooterForRender,hasTitlePg:t.hasTitlePg,watermark:t.watermark,headerDistancePx:o?.headerDistance!=null?C(o.headerDistance):void 0,footerDistancePx:o?.footerDistance!=null?C(o.footerDistance):void 0,pageBorders:o?.pageBorders,footnotesByPage:r?.size?r:void 0}}function Ke(t,a=o=>requestAnimationFrame(o),r=o=>cancelAnimationFrame(o)){let o=null;return {schedule(n){if(o){o.state=n;return}o={handle:0,state:n};let c=a(()=>{let e=o;o=null,e&&t(e.state);});o&&(o.handle=c);},cancel(){o&&(r(o.handle),o=null);}}}var ye=false;function Ge(t){if(!ye){ye=true;try{let a=t.scrollIntoView();(typeof a.updated!="number"||(a.updated&4)===0)&&console.warn("[docx-editor] prosemirror-state UPDATED_SCROLL bit shape changed; paginated scroll suppression may be stale. Update PM_UPDATED_SCROLL.");}catch{}}}function Ue(t,a){Ge(a);let r=t;typeof r.updated=="number"&&(r.updated&=-5);}export{Ee as computeLayout,Ke as createLayoutScheduler,we as getLayoutKernelInputs,Ue as stripScrollFlag};
+import'../chunk-TTRUPDAB.mjs';var r=new WeakMap;function p(e){let n=e?.package.document;if(!n)return [{properties:{}}];let t=(n.sections??[]).map(o=>({sectionId:o.id??o.properties.sectionId,properties:o.properties}));return t.push({sectionId:n.finalSectionProperties?.sectionId,properties:n.finalSectionProperties??{}}),t}function a(e,n,t){let o=[];for(let s of e?.package.footnotes??[])s.noteType&&s.noteType!=="normal"||o.push({id:s.id,noteKind:"footnote",height:0});for(let s of e?.package.endnotes??[])s.noteType&&s.noteType!=="normal"||o.push({id:s.id,noteKind:"endnote",height:0});return {bodyStory:"body",options:{contractVersion:e?.package.contractVersion,pageGap:n},regions:{sections:p(e),settings:e?.package.settings,watermark:e?.package.document.finalSectionProperties?.watermark},notes:{contents:o},renderEnv:t}}function d(e){return r.get(e)}function c(e){let n=a(e.document,e.pageGap,e.renderEnv);n.measurement=e.measurement;let t=JSON.parse(e.session.layoutDocumentWithRegionsJson(JSON.stringify(n)));return r.set(t.layout,{measured:t.measured,options:t.options,...t.headersFooters?{headersFooters:t.headersFooters}:{}}),{blocks:t.measured.map(o=>o.block),measures:t.measured.map(o=>o.measure),layout:t.layout,notesConverged:t.notesConverged}}export{a as buildResidentRegionLayoutRequest,c as computeLayout,d as getLayoutKernelInputs};

package/dist/{fontLoader-Bx6DK6-2.d.mts → fontLoader-aSewHMKF.d.mts}

@@ -1,90 +1,92 @@
-import { Document } from './types/document.mjs';
-import { s as BreakContent, P as Paragraph, R as Run, g as RunContent } from './content-sSHuWw49.mjs';
+import { C as ColorValue, e as Theme, f as ThemeColorSlot } from './formatting-D1EPSaJP.mjs';
 
 /**
- * Insert Operations Utility
+ * Color Resolver - Convert OOXML colors to CSS
  *
- * Utility functions for inserting content into the document.
- * Provides functions for inserting page breaks, horizontal rules, and other elements.
+ * The generic color machinery (theme slots, tint/shade math, blending, the
+ * picker matrix) is re-exported here. This module keeps the WordprocessingML-
+ * specific pieces: w:highlight named colors, w:shd shading semantics, and
+ * ColorValue construction helpers.
+ *
+ * OOXML Color References:
+ * - w:color/@w:val - RGB hex or "auto"
+ * - w:color/@w:themeColor - Theme color slot
+ * - w:color/@w:themeTint - Tint modifier (0-255, hex)
+ * - w:color/@w:themeShade - Shade modifier (0-255, hex)
  */
 
 /**
- * Insert position in the document
- */
-interface InsertPosition {
-    /** Paragraph index in the document body */
-    paragraphIndex: number;
-    /** Run index within the paragraph (optional) */
-    runIndex?: number;
-    /** Character offset within the run (optional) */
-    offset?: number;
-}
-/**
- * Create a page break content element
- */
-declare function createPageBreak(): BreakContent;
-/**
- * Create a column break content element
- */
-declare function createColumnBreak(): BreakContent;
-/**
- * Create a text wrapping break (line break)
- */
-declare function createLineBreak(clear?: 'none' | 'left' | 'right' | 'all'): BreakContent;
-/**
- * Create a run containing a page break
- */
-declare function createPageBreakRun(): Run;
-/**
- * Create an empty paragraph with a page break before it
- */
-declare function createPageBreakParagraph(): Paragraph;
-/**
- * Insert a page break at a position in the document
- * This inserts a new paragraph with pageBreakBefore: true
- */
-declare function insertPageBreak(doc: Document, position: InsertPosition): Document;
-/**
- * Create a horizontal rule paragraph
- * Uses a paragraph with bottom border to simulate horizontal rule
+ * Resolve a highlight color name to CSS
+ *
+ * @param highlight - Highlight color name (e.g., "yellow", "cyan")
+ * @returns CSS color string or empty string for "none"
  */
-declare function createHorizontalRule(): Paragraph;
+declare function resolveHighlightColor(highlight: string | undefined): string;
 /**
- * Insert a horizontal rule at a position in the document
+ * Resolve a shading fill or pattern color to CSS
+ *
+ * @param color - ColorValue for fill
+ * @param theme - Theme for resolving theme colors
+ * @returns CSS color string
  */
-declare function insertHorizontalRule(doc: Document, position: InsertPosition): Document;
+declare function resolveShadingColor(color: ColorValue | undefined | null, theme: Theme | null | undefined): string;
 /**
- * Check if content is a page break
+ * Check if a color is effectively black
+ *
+ * @param color - ColorValue object
+ * @param theme - Theme for resolving theme colors
+ * @returns True if color resolves to black or very dark
  */
-declare function isPageBreak(content: RunContent): boolean;
+declare function isBlack(color: ColorValue | undefined | null, theme: Theme | null | undefined): boolean;
 /**
- * Check if content is a column break
+ * Check if a color is effectively white
+ *
+ * @param color - ColorValue object
+ * @param theme - Theme for resolving theme colors
+ * @returns True if color resolves to white or very light
  */
-declare function isColumnBreak(content: RunContent): boolean;
+declare function isWhite(color: ColorValue | undefined | null, theme: Theme | null | undefined): boolean;
 /**
- * Check if content is a line break
+ * Parse a color string (various formats) to ColorValue
+ *
+ * @param colorString - Color string like "FF0000", "auto", or theme color name
+ * @returns ColorValue object
  */
-declare function isLineBreak(content: RunContent): boolean;
+declare function parseColorString(colorString: string | undefined): ColorValue | undefined;
 /**
- * Check if content is any type of break
+ * Create a ColorValue from theme color reference
+ *
+ * @param themeColor - Theme color slot name
+ * @param tint - Optional tint modifier
+ * @param shade - Optional shade modifier
+ * @returns ColorValue object
  */
-declare function isBreakContent(content: RunContent): content is BreakContent;
+declare function createThemeColor(themeColor: ThemeColorSlot, tint?: number, shade?: number): ColorValue;
 /**
- * Check if a paragraph has pageBreakBefore
+ * Create a ColorValue from RGB hex
+ *
+ * @param hex - 6-character hex color (no #)
+ * @returns ColorValue object
  */
-declare function hasPageBreakBefore(paragraph: Paragraph): boolean;
+declare function createRgbColor(hex: string): ColorValue;
 /**
- * Count page breaks in a document
+ * Ensure a hex color string has a '#' prefix.
  */
-declare function countPageBreaks(doc: Document): number;
+declare function ensureHexPrefix(hex: string): string;
 /**
- * Find all page break positions in a document
+ * Resolve a highlight color value to a CSS-ready string.
+ * Tries OOXML named highlight first, then ensures hex prefix.
  */
-declare function findPageBreaks(doc: Document): InsertPosition[];
+declare function resolveHighlightToCss(value: string): string;
 /**
- * Remove a page break at a specific position
+ * Check if two colors are equal
+ *
+ * @param color1 - First color
+ * @param color2 - Second color
+ * @param theme - Theme for resolving
+ * @returns True if colors resolve to the same value
  */
-declare function removePageBreak(doc: Document, position: InsertPosition): Document;
+declare function colorsEqual(color1: ColorValue | undefined | null, color2: ColorValue | undefined | null, theme: Theme | null | undefined): boolean;
 
 /**
  * Google Fonts Loader
@@ -324,4 +326,4 @@ declare function extractFontsFromDocument(document: unknown): Set<string>;
  */
 declare function loadDocumentFonts(document: unknown): Promise<void>;
 
-export { setGoogleFontsEnabled as A, type FontDefinition as B, extractFontsFromDocument as C, getGoogleFontEquivalent as D, loadDocumentFonts as E, FONT_MAPPING as F, loadFontDefinitions as G, loadFontFromUrl as H, type InsertPosition as I, loadFontWithMapping as J, loadFontsWithMapping as K, onFontError as L, countPageBreaks as a, createColumnBreak as b, canRenderFont as c, createHorizontalRule as d, createLineBreak as e, createPageBreak as f, createPageBreakParagraph as g, createPageBreakRun as h, findPageBreaks as i, getLoadedFonts as j, hasPageBreakBefore as k, insertHorizontalRule as l, insertPageBreak as m, isBreakContent as n, isColumnBreak as o, isFontLoaded as p, isLoading as q, isGoogleFontsEnabled as r, isLineBreak as s, isPageBreak as t, loadFont as u, loadFontFromBuffer as v, loadFonts as w, onFontsLoaded as x, preloadCommonFonts as y, removePageBreak as z };
+export { loadFontFromUrl as A, loadFontWithMapping as B, loadFontsWithMapping as C, onFontError as D, FONT_MAPPING as F, colorsEqual as a, createRgbColor as b, canRenderFont as c, createThemeColor as d, ensureHexPrefix as e, isFontLoaded as f, getLoadedFonts as g, isLoading as h, isBlack as i, isGoogleFontsEnabled as j, isWhite as k, loadFont as l, loadFontFromBuffer as m, loadFonts as n, onFontsLoaded as o, parseColorString as p, preloadCommonFonts as q, resolveHighlightColor as r, resolveHighlightToCss as s, resolveShadingColor as t, setGoogleFontsEnabled as u, type FontDefinition as v, extractFontsFromDocument as w, getGoogleFontEquivalent as x, loadDocumentFonts as y, loadFontDefinitions as z };

package/dist/{formatting-DoL7KBSL.d.mts → formatting-D1EPSaJP.d.mts}

@@ -820,4 +820,4 @@ interface TableCellFormatting {
     conditionalFormat?: ConditionalFormatStyle;
 }
 
-export { type ThemeFont as A, type BorderSpec as B, type ColorValue as C, type ThemeFontScheme as D, type EmphasisMark as E, type FloatingTableProperties as F, type ThemeMatrixCell as G, generateThemeTintShadeMatrix as H, getThemeTintShadeHex as I, resolveColorToHex as J, type LineSpacingRule as L, type ParagraphFormatting as P, type RunFontHint as R, type ShadingProperties as S, type TextFormatting as T, type UnderlineStyle as U, type Theme as a, blendColors as b, type CellMargins as c, darkenColor as d, type ConditionalFormatStyle as e, type ParagraphAlignment as f, getContrastingColor as g, type RunLanguage as h, type TabLeader as i, type TabStop as j, type TabStopAlignment as k, lightenColor as l, type TableBorders as m, type TableCellFormatting as n, type TableFormatting as o, type TableLook as p, type TableMeasurement as q, resolveColor as r, type TableRowFormatting as s, type TableStyleCascade as t, type TableStyleRegion as u, type TableWidthType as v, type TextEffect as w, type TextModernEffects as x, type ThemeColorScheme as y, type ThemeColorSlot as z };
+export { generateThemeTintShadeMatrix as A, type BorderSpec as B, type ColorValue as C, getContrastingColor as D, type EmphasisMark as E, type FloatingTableProperties as F, getThemeTintShadeHex as G, lightenColor as H, resolveColor as I, resolveColorToHex as J, type LineSpacingRule as L, type ParagraphFormatting as P, type RunFontHint as R, type ShadingProperties as S, type TextModernEffects as T, type UnderlineStyle as U, type TextFormatting as a, type TableFormatting as b, type TableRowFormatting as c, type TableCellFormatting as d, type Theme as e, type ThemeColorSlot as f, type CellMargins as g, type ConditionalFormatStyle as h, type ParagraphAlignment as i, type RunLanguage as j, type TabLeader as k, type TabStop as l, type TabStopAlignment as m, type TableBorders as n, type TableLook as o, type TableMeasurement as p, type TableStyleCascade as q, type TableStyleRegion as r, type TableWidthType as s, type TextEffect as t, type ThemeColorScheme as u, type ThemeFont as v, type ThemeFontScheme as w, type ThemeMatrixCell as x, blendColors as y, darkenColor as z };