@spacecorexdev/core 0.0.2 → 0.0.4

package/scripts/patch-docx-grid.cjs

@@ -0,0 +1,412 @@
+/**
+ * Patch @file-viewer/docx renderer: fix document grid (docGrid) line-height.
+ *
+ * Bug: when a section declares <w:docGrid w:type="lines" w:linePitch="N"/> and a
+ * paragraph has no explicit line-height, applyDocumentGridLinePitch() only sets
+ * min-height (no effect on inline text stacking) and never sets line-height, so
+ * paragraphs ignore the Word document grid entirely.
+ *
+ * Fix (Word/WPS "snap to grid" semantics):
+ *   Each text line occupies an integer number of grid units:
+ *     units = ceil(fontNaturalHeight / linePitch)
+ *     line-height = units * linePitch
+ *   Word font line metrics (winAscent + winDescent) for the legacy CJK fonts
+ *   (宋体/SimSun, 新宋体/NSimSun, 仿宋/FangSong, 楷体/KaiTi, 黑体/SimHei, …)
+ *   equal 1.32em, so 12pt text has a natural height of 15.84pt and snaps to
+ *   2 grid units when linePitch is 15.6pt (linePitch=312 twips); other fonts
+ *   use a 1.2em fallback factor.
+ *
+ * Affected files (different build paths load different bundles):
+ *   - dist/docx-preview.js          (CJS, "main" / "require")
+ *   - dist/docx-preview.mjs         (ESM, "module" / "import" — used by esbuild/vite)
+ *   - dist/docx-preview.worker.js   (worker 产物，vite-plugin 会复制覆盖 public worker)
+ *   - public/vendor/docx/docx.worker.js  (standalone worker deployment)
+ *
+ * 除 docGrid 行距外，本脚本还包含制表位页码、分页容量边界、页眉页脚锚定等补丁。
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+const PKG_DIR = path.join(__dirname, '..', 'node_modules', '@file-viewer', 'docx');
+const WORKER_PATH = path.join(__dirname, '..', 'public', 'vendor', 'docx', 'docx.worker.js');
+
+// Original (buggy) function as shipped in @file-viewer/docx 0.3.33
+const ORIGINAL =
+  'applyDocumentGridLinePitch(e,t,r){if(!this.paragraphUsesDocumentGrid(e,t))return;' +
+  'const a=this.currentSectionProps.docGrid.linePitch,' +
+  'n=this.effectiveParagraphCssValue(e,t,"line-height"),' +
+  's=e.lineSpacing??t?.paragraphProps?.lineSpacing;' +
+  'if(n){if("exact"==s?.lineRule||"exactly"==s?.lineRule)return;' +
+  'const o=/^-?\\d+(?:\\.\\d+)?$/.test(n)?`calc(${n} * 1em)`:n;' +
+  'return this.setCssStyle(r,"line-height",`max(${o}, ${a})`),' +
+  'void this.applyDocumentGridMinimumHeight(e,t,r,a)}' +
+  'this.applyDocumentGridMinimumHeight(e,t,r,a)}';
+
+// Earlier intermediate patch (1 grid unit, unconditional) — also accepted so
+// installs made with the previous postinstall version upgrade cleanly.
+const LEGACY_ONE_GRID_TAIL =
+  '}this.setCssStyle(r,"line-height",a),this.applyDocumentGridMinimumHeight(e,t,r,a)}';
+
+// Patched implementation: integer grid units based on natural font height.
+const PATCHED =
+  'documentGridLineHeight(e,t,r,a){' +
+  'const pitch=parseFloat(a);let fs=0,fam="";' +
+  'const note=el=>{if(!el.style)return;const v=el.style.fontSize;' +
+  'if(v){const m=/^([\\d.]+)pt$/.exec(v);m&&(fs=Math.max(fs,parseFloat(m[1])))}' +
+  'const f=el.style.fontFamily;f&&(fam+=" "+f)};' +
+  'note(r);if(r.querySelectorAll)r.querySelectorAll("[style]").forEach(note);' +
+  'if(!fs){const ps=this.effectiveParagraphCssValue(e,t,"font-size");' +
+  'if(ps){const m=/^([\\d.]+)pt$/.exec(ps);m&&(fs=parseFloat(m[1]))}}' +
+  'fs||(fs=12);' +
+  'const cjk=/simsun|nsimsun|fangsong|kaiti|simhei|microsoft yahei|dengxian|' +
+  '宋体|新宋|仿宋|楷体|黑体|雅黑|等线|mingliu|pmingliu|microsoft jhenghei/i.test(fam);' +
+  'const units=Math.max(1,Math.ceil(fs*(cjk?1.32:1.2)/pitch-1e-6));' +
+  'return(units*pitch).toFixed(2)+"pt"}' +
+  'applyDocumentGridLinePitch(e,t,r){if(!this.paragraphUsesDocumentGrid(e,t))return;' +
+  'const a=this.currentSectionProps.docGrid.linePitch,' +
+  'l=this.documentGridLineHeight(e,t,r,a),' +
+  'n=this.effectiveParagraphCssValue(e,t,"line-height"),' +
+  's=e.lineSpacing??t?.paragraphProps?.lineSpacing;' +
+  'if(n){if("exact"==s?.lineRule||"exactly"==s?.lineRule)return;' +
+  'const o=/^-?\\d+(?:\\.\\d+)?$/.test(n)?`calc(${n} * 1em)`:n;' +
+  'return this.setCssStyle(r,"line-height",`max(${o}, ${l})`),' +
+  'void this.applyDocumentGridMinimumHeight(e,t,r,l)}' +
+  'this.setCssStyle(r,"line-height",l),this.applyDocumentGridMinimumHeight(e,t,r,l)}';
+
+// ---------------------------------------------------------------------------
+// 补丁 2：制表位（tab stop）布局被 experimental 开关关闭
+//
+// 现象：页脚中「居中制表位 + Tab + PAGE 域」生成的页码，在编辑器/WPS 中跳到
+// 页心居中，导出 PDF 时却停在左边距处（renderTab 只渲染固定 14px 的 span）。
+// 根因：制表位宽度计算 updateTabStop 已实现，但收集与刷新两处都被
+// this.options.experimental（默认 false）门控，从未执行。
+// 方案：去掉两处门控；刷新时除原有 500ms 延迟刷新外，立即同步刷新一次，
+// 使制表位宽度在动态分页开始前确定（避免分页稳定后正文再回流）。
+// ---------------------------------------------------------------------------
+const TAB_COLLECT_ORIGINAL =
+  'this.options.experimental&&this.currentTabs.push({stops:r,span:i})';
+const TAB_COLLECT_PATCHED =
+  'this.currentTabs.push({stops:r,span:i})';
+
+const TAB_REFRESH_ORIGINAL =
+  'refreshTabStops(){this.options.experimental&&setTimeout(()=>{' +
+  'const e=(0,o.computePixelToPoint)();for(let t of this.currentTabs)' +
+  '(0,o.updateTabStop)(t.span,t.stops,this.defaultTabSize,e)},500)}';
+// 上一版补丁（仅立即+500ms 刷新）——存在缺陷：动态分页在渲染结束后才执行，
+// 分页会搬移/克隆节点（含页脚），中途量出的几何失真会把制表位宽度算成 0pt。
+// 保留它以便已打旧补丁的环境可以升级到新版。
+const TAB_REFRESH_PATCHED_V1 =
+  'refreshTabStops(){' +
+  'const run=()=>{let e=.75;try{e=(0,o.computePixelToPoint)()}catch(t){}' +
+  'for(let t of this.currentTabs)try{(0,o.updateTabStop)(t.span,t.stops,this.defaultTabSize,e)}catch(t){}};' +
+  'run();setTimeout(run,500)}';
+
+const TAB_REFRESH_PATCHED =
+  'refreshTabStops(){' +
+  // 制表位布局：立即执行一次（分页前），并保留延迟刷新兜底（晚到字体等）
+  'const run=()=>{let e=.75;try{e=(0,o.computePixelToPoint)()}catch(t){}' +
+  'for(let t of this.currentTabs)try{(0,o.updateTabStop)(t.span,t.stops,this.defaultTabSize,e)}catch(t){}};' +
+  'run();setTimeout(run,500);' +
+  // 动态分页在渲染结束后异步执行且会搬移/克隆节点，必须等分页稳定后再刷新，
+  // 否则中途失真几何会把制表位宽度算错（如页码居中被算成 0pt）
+  'let n=0,readyHits=0;' +
+  'const iv=setInterval(()=>{n++;let ready=1;' +
+  'for(const t of this.currentTabs){const w=t.span.closest&&t.span.closest(".docx-wrapper");' +
+  'if(w&&(w.dataset.docxPaginated!=="true"||w.dataset.docxPaginating||w.dataset.docxPaginationScheduled)){ready=0;break}}' +
+  'if(ready){run();if(++readyHits>=2){clearInterval(iv);return}}else readyHits=0;' +
+  'if(n>150)clearInterval(iv)},200)}';
+
+// ---------------------------------------------------------------------------
+// 补丁 3：分页溢出判定把页脚区算进正文容量，导致每页多排约一行
+//
+// 现象：isPageOverflowing 以纸张底边 r.bottom 为界，并把 header/footer 的
+// bottom 也计入最大内容高度；页脚用负 margin 从普通流拉入页边区后，正文
+// 实际可排到页脚位置（比正文 padding 底边多约 68px≈1.6 行）。
+// 方案：分页（breakPages，即 visualPagination）时只统计 article 内节点，
+// 容量边界改为正文 padding 底边（r.bottom - paddingBottom）。
+// ---------------------------------------------------------------------------
+const OVERFLOW_ORIGINAL =
+  'isPageOverflowing(e){const t=this.options.paginationTolerance??2;if(e.clientHeight<=0)return!1;' +
+  'const r=e.getBoundingClientRect();let a=r.top;' +
+  'for(const t of Array.from(e.children)){const e=t.getBoundingClientRect();' +
+  'if(a=Math.max(a,e.bottom),"article"==t.tagName.toLowerCase())' +
+  'for(const e of Array.from(t.children)){const t=e.getBoundingClientRect();a=Math.max(a,t.bottom)}}' +
+  'return a>r.bottom+t}';
+const OVERFLOW_PATCHED =
+  'isPageOverflowing(e){const t=this.options.paginationTolerance??2;if(e.clientHeight<=0)return!1;' +
+  'const r=e.getBoundingClientRect();let a=r.top;' +
+  // 分页模式下页眉/页脚绝对定位于页边区，不占正文容量；以正文 padding 底边为界
+  'const pb=this.options.breakPages?parseFloat(getComputedStyle(e).paddingBottom)||0:0;' +
+  'const b=r.bottom-pb;' +
+  'for(const n of Array.from(e.children))if("article"==n.tagName.toLowerCase())' +
+  'for(const ch of Array.from(n.children)){const bx=ch.getBoundingClientRect();a=Math.max(a,bx.bottom)}' +
+  'return a>b+t}';
+
+// ---------------------------------------------------------------------------
+// 补丁 4：固定分页模式下页眉/页脚改为相对纸张绝对定位
+//
+// 现象：页脚连续流写法（marginBottom 负值 + minHeight）在固定高度分页中
+// 垂直位置偏低约 21pt（导出 PDF 页码距纸底约 30pt，编辑器/WPS 约 57pt；
+// Word 语义下页脚底边距纸底 = footerDistance）。
+// 方案：breakPages（visualPagination）时，header 以 top=headerDistance、
+// footer 以 bottom=footerDistance、左右以左右页边距绝对锚定到纸张；
+// 连续预览（breakPages=false）保持原有流式写法不变。
+// ---------------------------------------------------------------------------
+const HEADER_FOOTER_ORIGINAL =
+  't?.pageMargins&&(c.rootElement.type===n.DomType.Header?' +
+  '(e.style.marginTop=`calc(${t.pageMargins.header} - ${t.pageMargins.top})`,' +
+  'e.style.minHeight=`calc(${t.pageMargins.top} - ${t.pageMargins.header})`):' +
+  'c.rootElement.type===n.DomType.Footer&&' +
+  '(e.style.marginBottom=`calc(${t.pageMargins.footer} - ${t.pageMargins.bottom})`,' +
+  'e.style.minHeight=`calc(${t.pageMargins.bottom} - ${t.pageMargins.footer})`))';
+const HEADER_FOOTER_PATCHED =
+  't?.pageMargins&&(this.options.breakPages?' +
+  // 固定分页：页眉/页脚按 Word 边距绝对锚定到纸张（section.docx 为定位包含块）
+  '(c.rootElement.type===n.DomType.Header?' +
+  '(e.style.position="absolute",e.style.left=t.pageMargins.left,e.style.right=t.pageMargins.right,' +
+  'e.style.top=t.pageMargins.header):' +
+  'c.rootElement.type===n.DomType.Footer&&' +
+  '(e.style.position="absolute",e.style.left=t.pageMargins.left,e.style.right=t.pageMargins.right,' +
+  'e.style.bottom=t.pageMargins.footer)):' +
+  // 连续预览：保持原有负 margin 流式写法
+  '(c.rootElement.type===n.DomType.Header?' +
+  '(e.style.marginTop=`calc(${t.pageMargins.header} - ${t.pageMargins.top})`,' +
+  'e.style.minHeight=`calc(${t.pageMargins.top} - ${t.pageMargins.header})`):' +
+  'c.rootElement.type===n.DomType.Footer&&' +
+  '(e.style.marginBottom=`calc(${t.pageMargins.footer} - ${t.pageMargins.bottom})`,' +
+  'e.style.minHeight=`calc(${t.pageMargins.bottom} - ${t.pageMargins.footer})`)))';
+
+// ---------------------------------------------------------------------------
+// 补丁 5：updateTabStop 居中/右对齐制表位公式不自洽（非幂等）
+//
+// 现象：首次计算正确（页码居中），但重复执行时把 tab span 自身的当前宽度
+// 也算进了 o（内容偏移），导致第二次执行算出负数→被 clamp 到 0pt。
+// 根因：o = range.left + n*range.width - paragraphLeft，其中 range.left
+// 包含了 tab span 的当前宽度 d.width。正确做法是减去 d.width，使 o 只反映
+// 内容本身的位置，与 tab span 当前宽度无关。
+// 方案：o 计算中减去 d.width，使公式幂等。
+// 注意：worker bundle 与 CJS/MJS bundle 的 minified 变量名不同
+//   worker: T = paragraph content left
+//   CJS/MJS: w = paragraph content left
+//   两者的 span rect 变量都是 d。
+// ---------------------------------------------------------------------------
+const TAB_FORMULA_ORIGINAL_WORKER =
+  'o=s.left+n*s.width-T;C=S.pos-o*l';
+const TAB_FORMULA_PATCHED_WORKER =
+  'o=s.left+n*s.width-T-d.width;C=S.pos-o*l';
+const TAB_FORMULA_ORIGINAL_CJS =
+  'o=s.left+n*s.width-w;C=S.pos-o*l';
+const TAB_FORMULA_PATCHED_CJS =
+  'o=s.left+n*s.width-w-d.width;C=S.pos-o*l';
+
+// ---------------------------------------------------------------------------
+// 补丁 6：浮动对象（<wp:anchor wrapNone/>）水平/垂直 align 未转成 CSS 定位
+//
+// 现象：真实合同页码放在浮动文本框里：
+//   <wp:positionH relativeFrom="margin"><wp:align>center</wp:align></wp:positionH>
+// worker 解析了 align（anchorPosition.horizontal.align，M=true），但 wrapNone
+// 绝对定位分支只在存在 posOffset 时设置 left/top，align 被完全忽略，文本框
+// 以默认 left:0 贴在左侧（页码无法居中；right/bottom/center 同样失效）。
+// 方案：当 XML 提供的是 align 而非 posOffset 时（M/N=true），映射为 CSS：
+//   horizontal: center -> left:50% + translateX(-50%)；right -> right:0；left -> left:0
+//   vertical:   center -> top:50% + translateY(-50%)；bottom -> bottom:0；top -> top:0
+// 绝对定位包含块为锚定段落（position:relative），其宽度即正文/页脚的 margin
+// 内容区宽度，左右页边距对称时其 50% 点就是纸张水平中心，与 Word 语义一致。
+// posOffset 路径（M/N=false）保持原逻辑不变。
+// ---------------------------------------------------------------------------
+const FLOAT_ALIGN_ORIGINAL =
+  '"wrapNone"==x?(f.cssStyle.display="block",f.cssStyle.position=g?"absolute":"relative",' +
+  'C.offset&&(f.cssStyle.left=C.offset),A.offset&&(f.cssStyle.top=A.offset))';
+const FLOAT_ALIGN_PATCHED =
+  '"wrapNone"==x?(f.cssStyle.display="block",f.cssStyle.position=g?"absolute":"relative",' +
+  'M?("center"==C.align?(f.cssStyle.left="50%",f.cssStyle.transform="translateX(-50%)"):' +
+  '"right"==C.align?f.cssStyle.right="0":' +
+  '"left"==C.align&&(f.cssStyle.left="0")):C.offset&&(f.cssStyle.left=C.offset),' +
+  'N?("center"==A.align?(f.cssStyle.top="50%",' +
+  'f.cssStyle.transform=(f.cssStyle.transform?f.cssStyle.transform+" ":"")+"translateY(-50%)"):' +
+  '"bottom"==A.align?f.cssStyle.bottom="0":' +
+  '"top"==A.align&&(f.cssStyle.top="0")):A.offset&&(f.cssStyle.top=A.offset))';
+
+// ---------------------------------------------------------------------------
+// 补丁 7：文本框 spAutoFit（形状随文字收缩）未实现，导致页脚浮动文本框里的
+// 页码不能随 align=center 居中
+//
+// 真实合同页脚：浮动文本框 <wp:extent 144pt> + <wps:bodyPr><a:spAutoFit/></wps:bodyPr>
+// （VML 兜底 mso-fit-shape-to-text:t）。Word/WPS 打开时文本框会收缩到与文字
+// 等宽，再按 positionH align=center 居中；渲染器无视 spAutoFit，始终用 extent
+// 的 144pt 固定宽，框虽居中，左对齐的页码停在框左缘（整体偏左约 70pt）。
+// 三处修改：
+//   7a parseDmlTextBoxProperties：解析 spAutoFit 标志到 dmlShapeAutoFit；
+//   7b parseWordprocessingShape：文本框形状自适应时宽高改 auto（收缩到内容）；
+//   7c parseDrawingWrapper：外层锚定框内含自适应文本框时宽高也改 auto，
+//      使绝对定位 shrink-to-fit，配合补丁 6 的 left:50% 实现真正居中。
+// ---------------------------------------------------------------------------
+const AUTOFIT_FLAG_ORIGINAL =
+  'parseDmlTextBoxProperties(e){const t={};return this.applyDmlTextInsets(e,t),' +
+  '{dmlTextBox:!0,textInsets:t,textVerticalAlign:this.dmlVerticalAlign(e)}}';
+const AUTOFIT_FLAG_PATCHED =
+  'parseDmlTextBoxProperties(e){const t={};return this.applyDmlTextInsets(e,t),' +
+  '{dmlTextBox:!0,textInsets:t,textVerticalAlign:this.dmlVerticalAlign(e),' +
+  'dmlShapeAutoFit:!!i.default.element(e,"spAutoFit")}}';
+
+const SHAPE_AUTOSIZE_ORIGINAL =
+  'return s&&(t.props={...t.props??{},...this.parseDmlTextBoxProperties(a)}),t}';
+const SHAPE_AUTOSIZE_PATCHED =
+  'if(s){const tp=this.parseDmlTextBoxProperties(a);t.props={...t.props??{},...tp};' +
+  'tp.dmlShapeAutoFit&&(t.cssStyle.width="auto",t.cssStyle.height="auto")}return t}';
+
+const WRAPPER_AUTOSIZE_ORIGINAL = 'f.cssStyle.float=C.align,f}';
+const WRAPPER_AUTOSIZE_PATCHED =
+  'f.cssStyle.float=C.align,' +
+  '(f.children?.some?.(ch=>ch?.props?.dmlShapeAutoFit))&&' +
+  '(f.cssStyle.width="auto",f.cssStyle.height="auto"),f}';
+
+// 追加的 1:1 字符串替换补丁（每个补丁在单文件中必须且只能出现一次）
+const EXTRA_PATCHES = [
+  {
+    id: 'tab-collect',
+    original: TAB_COLLECT_ORIGINAL,
+    patched: TAB_COLLECT_PATCHED,
+  },
+  {
+    id: 'tab-refresh',
+    original: TAB_REFRESH_ORIGINAL,
+    patched: TAB_REFRESH_PATCHED,
+    // 兼容已打旧版补丁的环境：同样替换为新版
+    legacy: [TAB_REFRESH_PATCHED_V1],
+  },
+  {
+    id: 'overflow-body-bound',
+    original: OVERFLOW_ORIGINAL,
+    patched: OVERFLOW_PATCHED,
+  },
+  {
+    id: 'header-footer-anchor',
+    original: HEADER_FOOTER_ORIGINAL,
+    patched: HEADER_FOOTER_PATCHED,
+  },
+  {
+    id: 'float-align',
+    original: FLOAT_ALIGN_ORIGINAL,
+    patched: FLOAT_ALIGN_PATCHED,
+  },
+  {
+    id: 'autofit-flag',
+    original: AUTOFIT_FLAG_ORIGINAL,
+    patched: AUTOFIT_FLAG_PATCHED,
+  },
+  {
+    id: 'shape-autosize',
+    original: SHAPE_AUTOSIZE_ORIGINAL,
+    patched: SHAPE_AUTOSIZE_PATCHED,
+  },
+  {
+    id: 'wrapper-autosize',
+    original: WRAPPER_AUTOSIZE_ORIGINAL,
+    patched: WRAPPER_AUTOSIZE_PATCHED,
+  },
+];
+
+// 补丁 5 需要按文件变体选择不同锚点
+const TAB_FORMULA_VARIANTS = {
+  'docx.worker.js': { original: TAB_FORMULA_ORIGINAL_WORKER, patched: TAB_FORMULA_PATCHED_WORKER },
+  'docx-preview.js': { original: TAB_FORMULA_ORIGINAL_CJS, patched: TAB_FORMULA_PATCHED_CJS },
+  'docx-preview.mjs': { original: TAB_FORMULA_ORIGINAL_CJS, patched: TAB_FORMULA_PATCHED_CJS },
+  // 包内 worker 产物：@file-viewer/vite-plugin 每次 dev/build 会把它复制覆盖
+  // public/vendor/docx/docx.worker.js，必须一并补丁，否则重启后修复被冲掉
+  'docx-preview.worker.js': { original: TAB_FORMULA_ORIGINAL_CJS, patched: TAB_FORMULA_PATCHED_CJS },
+};
+
+const targets = [
+  path.join(PKG_DIR, 'dist', 'docx-preview.js'),
+  path.join(PKG_DIR, 'dist', 'docx-preview.mjs'),
+  path.join(PKG_DIR, 'dist', 'docx-preview.worker.js'),
+  WORKER_PATH,
+];
+
+let ok = 0;
+for (const file of targets) {
+  if (!fs.existsSync(file)) {
+    console.warn(`[patch-docx-grid] SKIP (not found): ${file}`);
+    continue;
+  }
+  let content = fs.readFileSync(file, 'utf8');
+  const base = path.basename(file);
+
+  // 追加补丁（在 docGrid 补丁判断之前执行；各补丁自带幂等检测）
+  for (const patch of EXTRA_PATCHES) {
+    // 注意：patched 可能是 original 的子串，必须同时确认 original 已不存在才算已补丁
+    if (content.includes(patch.patched) && !content.includes(patch.original)) {
+      console.log(`[patch-docx-grid] ${base}: ${patch.id} ALREADY PATCHED`);
+      continue;
+    }
+    // 兼容旧版补丁：如果当前文件已被 legacy 版本打过，直接替换为新版
+    let replaced = false;
+    for (const legacy of (patch.legacy || [])) {
+      if (content.includes(legacy)) {
+        content = content.replace(legacy, patch.patched);
+        console.log(`[patch-docx-grid] ${base}: ${patch.id} UPGRADED (legacy -> new)`);
+        replaced = true;
+        break;
+      }
+    }
+    if (replaced) continue;
+    const count = content.split(patch.original).length - 1;
+    if (count !== 1) {
+      console.error(`[patch-docx-grid] ERROR: ${patch.id} expected 1 anchor in ${base}, found ${count}`);
+      process.exitCode = 1;
+      continue;
+    }
+    content = content.replace(patch.original, patch.patched);
+    console.log(`[patch-docx-grid] ${base}: ${patch.id} PATCHED`);
+  }
+
+  // 补丁 5：制表位公式幂等修复（按文件名选择变量名变体）
+  const tabFormula = TAB_FORMULA_VARIANTS[base];
+  if (tabFormula) {
+    if (content.includes(tabFormula.patched) && !content.includes(tabFormula.original)) {
+      console.log(`[patch-docx-grid] ${base}: tab-formula ALREADY PATCHED`);
+    } else {
+      const count = content.split(tabFormula.original).length - 1;
+      if (count !== 1) {
+        console.error(`[patch-docx-grid] ERROR: tab-formula expected 1 anchor in ${base}, found ${count}`);
+        process.exitCode = 1;
+      } else {
+        content = content.replace(tabFormula.original, tabFormula.patched);
+        console.log(`[patch-docx-grid] ${base}: tab-formula PATCHED`);
+      }
+    }
+  }
+
+  if (content.includes(PATCHED)) {
+    if (content !== fs.readFileSync(file, 'utf8')) {
+      fs.writeFileSync(file, content, 'utf8');
+    }
+    console.log(`[patch-docx-grid] docGrid: ${base} ALREADY PATCHED`);
+    ok++;
+    continue;
+  }
+
+  // Upgrade path from the previous one-grid patch: rewrite the whole function.
+  if (content.includes(LEGACY_ONE_GRID_TAIL) && content.includes(ORIGINAL.replace('this.applyDocumentGridMinimumHeight(e,t,r,a)}', LEGACY_ONE_GRID_TAIL))) {
+    const legacyFull = ORIGINAL.replace('this.applyDocumentGridMinimumHeight(e,t,r,a)}', LEGACY_ONE_GRID_TAIL);
+    content = content.replace(legacyFull, PATCHED);
+  } else {
+    const count = content.split(ORIGINAL).length - 1;
+    if (count !== 1) {
+      console.error(`[patch-docx-grid] ERROR: expected 1 original function in ${base}, found ${count}`);
+      process.exitCode = 1;
+      continue;
+    }
+    content = content.replace(ORIGINAL, PATCHED);
+  }
+
+  fs.writeFileSync(file, content, 'utf8');
+  console.log(`[patch-docx-grid] PATCHED: ${base}`);
+  ok++;
+}
+
+if (ok === targets.length && process.exitCode !== 1) {
+  console.log('[patch-docx-grid] All files patched successfully.');
+}