bun-docx 0.19.2 → 0.20.1

package/README.md

@@ -8,6 +8,27 @@
 - Agents address text by **stable locators** with character offsets (`p3:5-20`); humans see normal Word formatting on disk.
 - Custom styles, theme colors, embedded objects — all of it survives. The CLI mutates XML in place rather than re-emitting from a lossy model.
 
+## Why docx-cli?
+
+The default way agents edit Word docs is to unzip the `.docx` and hand-write the OOXML inside. That takes a strong model to get right, burns tokens, and routinely produces a file Word won't open. `docx-cli` hands the agent plain commands plus an annotated-Markdown read view, so it never has to reason about the XML.
+
+We measured it — a controlled A/B bake-off: **six real document tasks** (fill an NDA, fill an invoice, restyle a résumé, redline a contract, finalize a contract, author a journal), the same starting files, and one independent judge grading every result from the **Word-rendered pages**. Three runs per arm at each of two model tiers:
+
+|                           | Haiku (weak, cheap) |                       | Sonnet (strong) |                       |
+| :------------------------ | ------------------: | --------------------: | --------------: | --------------------: |
+|                           |        **docx-cli** |         default skill |    **docx-cli** |         default skill |
+| Tasks solved (of 6)       |       **4.3** (4–5) |             0.7 (0–1) |   **6.0** (6–6) |             4.0 (4–4) |
+| Rendered correctly (of 6) |                 6 |                   3.7 |             6.0 |                   4.7 |
+| Outright-broken documents |               **0** |      ~1/run (up to 2) |           **0** |                     0 |
+| Input tokens              |            **2.4M** |           6.1M (2.6×) |        **1.6M** |           3.6M (2.2×) |
+| Wall-clock                |           **924 s** | 1,882 s (2.0× slower) |     **1,175 s** | 2,029 s (1.7× slower) |
+
+- **The correctness gap is widest on the cheap Haiku tier (~6×)**, and a frontier model never closes it — the default skill caps at 4/6, losing the contract redline and the résumé every Sonnet run.
+- **The cost and speed penalties are model-independent** — ~2.2–2.6× more tokens and ~1.7–2× slower at *both* tiers, with token/time ranges that never overlap.
+- **Word couldn't reliably open the default skill's work** — it failed to open 5 of 36 of its outputs; all 36 of docx-cli's opened on the first try.
+
+Full methodology, per-task rubric, and side-by-side renders: **[the bake-off writeup](https://kklimuk.github.io/docx-cli/)**.
+
 ## Install
 
 **npm** — the simplest path (requires Bun >= 1.3):

package/dist/index.js

@@ -4435,6 +4435,20 @@ class XmlNode2 {
     }
     return out;
   }
+  collectTextWithBreaks() {
+    if (this.isText)
+      return this.text ?? "";
+    if (this.tag === "w:br" || this.tag === "w:cr")
+      return `
+`;
+    if (this.tag === "w:tab")
+      return "\t";
+    let out = "";
+    for (const child of this.children) {
+      out += child.collectTextWithBreaks();
+    }
+    return out;
+  }
   clone() {
     const cloned = new XmlNode2(this.tag, { ...this.attributes });
     if (this.text !== undefined)
@@ -5290,6 +5304,11 @@ function RunElement({ run }) {
   }
   return null;
 }
+function textToRunElements(text) {
+  return textToRuns(text, {}).map((run) => /* @__PURE__ */ jsxDEV(RunElement, {
+    run
+  }, undefined, false, undefined, this)).filter((node) => node !== null);
+}
 function applyParagraphOptionsInPlace(rebuilt, options) {
   if (!options.style && !options.alignment && !options.tabs && !options.spacing && !options.indent)
     return;
@@ -17744,14 +17763,7 @@ function noteFirstParagraphRuns({
     return runs;
   if (text2 === undefined)
     return [];
-  return [
-    /* @__PURE__ */ jsxDEV(w.r, {
-      children: /* @__PURE__ */ jsxDEV(w.t, {
-        "xml:space": "preserve",
-        children: ` ${text2}`
-      }, undefined, false, undefined, this)
-    }, undefined, false, undefined, this)
-  ];
+  return textToRunElements(` ${text2}`);
 }
 function TrackedNoteBody({
   config,
@@ -17761,6 +17773,19 @@ function TrackedNoteBody({
 }) {
   const Note = config.kind === "footnote" ? w.footnote : w.endnote;
   const BodyRef = config.kind === "footnote" ? w.footnoteRef : w.endnoteRef;
+  const insRuns = [
+    /* @__PURE__ */ jsxDEV(w.r, {
+      children: [
+        /* @__PURE__ */ jsxDEV(w.rPr, {
+          children: /* @__PURE__ */ jsxDEV(w.rStyle, {
+            "w-val": config.referenceStyle
+          }, undefined, false, undefined, this)
+        }, undefined, false, undefined, this),
+        /* @__PURE__ */ jsxDEV(BodyRef, {}, undefined, false, undefined, this)
+      ]
+    }, undefined, true, undefined, this),
+    ...textToRunElements(` ${text2}`)
+  ];
   return /* @__PURE__ */ jsxDEV(Note, {
     "w-id": id,
     children: /* @__PURE__ */ jsxDEV(w.p, {
@@ -17772,25 +17797,8 @@ function TrackedNoteBody({
         }, undefined, false, undefined, this),
         /* @__PURE__ */ jsxDEV(Ins, {
           meta,
-          children: [
-            /* @__PURE__ */ jsxDEV(w.r, {
-              children: [
-                /* @__PURE__ */ jsxDEV(w.rPr, {
-                  children: /* @__PURE__ */ jsxDEV(w.rStyle, {
-                    "w-val": config.referenceStyle
-                  }, undefined, false, undefined, this)
-                }, undefined, false, undefined, this),
-                /* @__PURE__ */ jsxDEV(BodyRef, {}, undefined, false, undefined, this)
-              ]
-            }, undefined, true, undefined, this),
-            /* @__PURE__ */ jsxDEV(w.r, {
-              children: /* @__PURE__ */ jsxDEV(w.t, {
-                "xml:space": "preserve",
-                children: ` ${text2}`
-              }, undefined, false, undefined, this)
-            }, undefined, false, undefined, this)
-          ]
-        }, undefined, true, undefined, this)
+          children: insRuns
+        }, undefined, false, undefined, this)
       ]
     }, undefined, true, undefined, this)
   }, undefined, false, undefined, this);
@@ -17831,15 +17839,9 @@ function wrapNoteBodyAsEdited(noteBody, newText, insMeta, delMeta) {
       continue;
     }
     if (!inserted) {
-      const newRun = /* @__PURE__ */ jsxDEV(w.r, {
-        children: /* @__PURE__ */ jsxDEV(w.t, {
-          "xml:space": "preserve",
-          children: newText
-        }, undefined, false, undefined, this)
-      }, undefined, false, undefined, this);
       result.push(/* @__PURE__ */ jsxDEV(Ins, {
         meta: insMeta,
-        children: newRun
+        children: textToRunElements(newText)
       }, undefined, false, undefined, this));
       inserted = true;
     }
@@ -17849,15 +17851,9 @@ function wrapNoteBodyAsEdited(noteBody, newText, insMeta, delMeta) {
     }, undefined, false, undefined, this));
   }
   if (!inserted) {
-    const newRun = /* @__PURE__ */ jsxDEV(w.r, {
-      children: /* @__PURE__ */ jsxDEV(w.t, {
-        "xml:space": "preserve",
-        children: newText
-      }, undefined, false, undefined, this)
-    }, undefined, false, undefined, this);
     result.push(/* @__PURE__ */ jsxDEV(Ins, {
       meta: insMeta,
-      children: newRun
+      children: textToRunElements(newText)
     }, undefined, false, undefined, this));
   }
   paragraph.children = result;
@@ -17885,6 +17881,7 @@ function isBareWhitespaceRun(run) {
   return saw;
 }
 var init_emit3 = __esm(() => {
+  init_blocks();
   init_jsx();
   init_track_changes();
   init_emit2();
@@ -21138,6 +21135,9 @@ function nodeText(node) {
         out += child2.collectText();
       else if (child2.tag === "w:tab")
         out += "\t";
+      else if (child2.tag === "w:br" || child2.tag === "w:cr")
+        out += `
+`;
     }
     return out;
   }
@@ -23700,7 +23700,7 @@ class CommentsView {
       const author = child2.getAttribute("w:author") ?? "";
       const date = child2.getAttribute("w:date") ?? "";
       const initials = child2.getAttribute("w:initials");
-      const text2 = child2.collectText();
+      const text2 = child2.collectTextWithBreaks();
       const anchor = anchors.get(commentId) ?? {
         startBlockId: "",
         startOffset: 0,
@@ -24218,7 +24218,7 @@ class NotesView {
       const numericId = child2.getAttribute("w:id");
       if (numericId == null)
         continue;
-      const text2 = child2.collectText().replace(/\s+/g, " ").trim();
+      const text2 = child2.collectTextWithBreaks().trim();
       out.push({ id: `${config.idPrefix}${numericId}`, text: text2 });
     }
     return out;
@@ -35447,12 +35447,7 @@ function CommentBody({
     children: /* @__PURE__ */ jsxDEV(w.p, {
       "w14:paraId": options.paraId,
       "w14:textId": "00000000",
-      children: /* @__PURE__ */ jsxDEV(w.r, {
-        children: /* @__PURE__ */ jsxDEV(w.t, {
-          "xml:space": "preserve",
-          children: options.text
-        }, undefined, false, undefined, this)
-      }, undefined, false, undefined, this)
+      children: textToRunElements(options.text)
     }, undefined, false, undefined, this)
   }, undefined, false, undefined, this);
 }
@@ -35519,6 +35514,7 @@ function containsCommentReference(run, numericId) {
 var SpanOutOfRangeError;
 var init_markers = __esm(() => {
   init_comments();
+  init_blocks();
   init_jsx();
   init_parser();
   init_jsx_dev_runtime();
@@ -74332,7 +74328,7 @@ function buildContentParagraph(spec, contentWidth) {
             }, undefined, false, undefined, this)
           }, undefined, false, undefined, this)
         }, undefined, false, undefined, this),
-        textRun(spec.text),
+        textToRunElements(spec.text),
         /* @__PURE__ */ jsxDEV(w.r, {
           children: /* @__PURE__ */ jsxDEV(w.tab, {}, undefined, false, undefined, this)
         }, undefined, false, undefined, this),
@@ -74357,7 +74353,7 @@ function buildContentParagraph(spec, contentWidth) {
       alignment ? /* @__PURE__ */ jsxDEV(w.pPr, {
         children: alignment
       }, undefined, false, undefined, this) : null,
-      hasText ? textRun(spec.text) : null
+      hasText ? textToRunElements(spec.text) : null
     ]
   }, undefined, true, undefined, this);
 }
@@ -74368,22 +74364,14 @@ function alignChild(align) {
     "w-val": align
   }, undefined, false, undefined, this);
 }
-function textRun(text6) {
-  return /* @__PURE__ */ jsxDEV(w.r, {
-    children: /* @__PURE__ */ jsxDEV(w.t, {
-      "xml:space": "preserve",
-      children: text6
-    }, undefined, false, undefined, this)
-  }, undefined, false, undefined, this);
-}
 function fieldRuns(field) {
   switch (field.type) {
     case "page":
       if (field.ofPages) {
         return [
-          textRun("Page "),
+          ...textToRunElements("Page "),
           fieldSimple(" PAGE ", "1"),
-          textRun(" of "),
+          ...textToRunElements(" of "),
           fieldSimple(" NUMPAGES ", "1")
         ];
       }
@@ -74445,6 +74433,7 @@ function relationshipTarget(partName) {
 }
 var NS_W3 = "http://schemas.openxmlformats.org/wordprocessingml/2006/main", NS_R2 = "http://schemas.openxmlformats.org/officeDocument/2006/relationships";
 var init_marginals2 = __esm(() => {
+  init_blocks();
   init_jsx();
   init_sections();
   init_track_changes();
@@ -82687,7 +82676,7 @@ async function resolveBlockOrFail(document4, locator) {
     return document4.body.resolveBlock(locator);
   } catch (err) {
     if (err instanceof LocatorResolveError) {
-      return await fail("BLOCK_NOT_FOUND", err.message);
+      return await fail("BLOCK_NOT_FOUND", err.message, STALE_LOCATOR_HINT);
     }
     throw err;
   }
@@ -82737,7 +82726,7 @@ async function resolveBlockRangeOrFail(document4, locator) {
       return await fail("INVALID_LOCATOR", err.message);
     }
     if (err instanceof LocatorResolveError) {
-      return await fail("BLOCK_NOT_FOUND", err.message);
+      return await fail("BLOCK_NOT_FOUND", err.message, STALE_LOCATOR_HINT);
     }
     throw err;
   }
@@ -82746,7 +82735,7 @@ var EXIT2, stdout = async (text6) => {
   await Bun.stdout.write(text6);
 }, stderr = async (text6) => {
   await Bun.stderr.write(text6);
-}, sinks, verboseAck = false, SAVE_FLAGS;
+}, sinks, verboseAck = false, STALE_LOCATOR_HINT = "Locator ids are positional and shift after structural edits (insert/delete/section changes) \u2014 an id from an earlier read may now point elsewhere or be gone. Re-read the file to get current ids, then retry. Applying several changes? Do them from ONE read with --batch (edit/insert/delete/replace/comments) so ids never go stale mid-run.", SAVE_FLAGS;
 var init_respond = __esm(() => {
   init_core2();
   EXIT2 = {
@@ -82797,6 +82786,12 @@ async function rejectShellMangledValue(text6, help, label = "this value") {
   return await fail("USAGE", `${label} contains "${fragment}" \u2014 a number with no integer part, the signature of a "$" amount gutted by the shell (bash turns double-quoted "$300.00" into ".00" and "$10,000" into ",000"). docx would write the corrupted value verbatim.`, `Wrap any "$"-bearing value in SINGLE quotes ('$300.00') so bash leaves it alone, or supply it via --batch FILE (JSONL never touches the shell). If you really mean "${fragment}", write its integer part (0${fragment}) or use --batch. Help:
 ${help}`);
 }
+function decodeInlineEscapes(value) {
+  if (value === undefined)
+    return;
+  return value.replace(/\\r\\n|\\[nrt]/g, (match) => match === "\\t" ? "\t" : `
+`);
+}
 function parseTaskFlag(value) {
   const normalized = value.toLowerCase();
   if (normalized === "checked" || normalized === "true" || normalized === "1")
@@ -83206,7 +83201,7 @@ async function run(args) {
   const atInput = parsed.values.at;
   const anchorInput = parsed.values.anchor;
   const batchInput = parsed.values.batch;
-  const text6 = parsed.values.text;
+  const text6 = decodeInlineEscapes(parsed.values.text);
   const occurrenceRaw = parsed.values.occurrence;
   const defaultAuthor = resolveAuthor(parsed.values.author);
   const outputPath = parsed.values.output;
@@ -83690,7 +83685,7 @@ async function run4(args) {
   if (!path2)
     return fail("USAGE", "Missing FILE argument", HELP4);
   const parentInput = parsed.values.at;
-  const text6 = parsed.values.text;
+  const text6 = decodeInlineEscapes(parsed.values.text);
   if (!parentInput)
     return fail("USAGE", "Missing --at cN", HELP4);
   if (!text6)
@@ -83764,6 +83759,7 @@ Examples:
 `;
 var init_reply = __esm(() => {
   init_core2();
+  init_parse_helpers();
   init_respond();
 });
 
@@ -84077,12 +84073,7 @@ function DocumentBody({ text: text6 }) {
     children: /* @__PURE__ */ jsxDEV(w.body, {
       children: [
         text6 !== undefined ? /* @__PURE__ */ jsxDEV(w.p, {
-          children: /* @__PURE__ */ jsxDEV(w.r, {
-            children: /* @__PURE__ */ jsxDEV(w.t, {
-              "xml:space": "preserve",
-              children: text6
-            }, undefined, false, undefined, this)
-          }, undefined, false, undefined, this)
+          children: textToRunElements(text6)
         }, undefined, false, undefined, this) : /* @__PURE__ */ jsxDEV(w.p, {}, undefined, false, undefined, this),
         /* @__PURE__ */ jsxDEV(DefaultSectionProperties, {}, undefined, false, undefined, this)
       ]
@@ -84180,6 +84171,7 @@ function serializeWithDeclaration(root2) {
 }
 var DOC_NAMESPACES, CONTENT_TYPES, ROOT_RELS, DOCUMENT_RELS;
 var init_template = __esm(() => {
+  init_blocks();
   init_jsx();
   init_parser();
   init_canonical_parts();
@@ -84260,7 +84252,7 @@ async function run7(args) {
   if (!path2) {
     return fail("USAGE", "Missing FILE argument", HELP7);
   }
-  const text6 = parsed.values.text;
+  const text6 = decodeInlineEscapes(parsed.values.text);
   const fromPath = parsed.values.from;
   const textFilePath = parsed.values["text-file"];
   const contentSources = [text6, fromPath, textFilePath].filter((value) => value !== undefined);
@@ -85841,7 +85833,7 @@ async function validateParagraphEdit(values2, paragraphOptions) {
       return { kind: "clear", tags };
     }
   }
-  const text6 = values2.text;
+  const text6 = decodeInlineEscapes(values2.text);
   const runsJson = values2.runs;
   const codeInline = values2.code;
   const codeFile = values2["code-file"];
@@ -85895,7 +85887,7 @@ async function validateParagraphEdit(values2, paragraphOptions) {
     }
     return { kind: "task", checked };
   }
-  const markdownInline = values2.markdown;
+  const markdownInline = decodeInlineEscapes(values2.markdown);
   const markdownFile = values2["markdown-file"];
   const contentFlags = [
     text6 !== undefined,
@@ -86249,9 +86241,12 @@ General options:
   -h, --help        Show this help
 
 Output:
-  Prints a one-line confirmation on success (exit 0) \u2014 the edited locator is unchanged, so there's
-  nothing to mint. --verbose prints {ok:true, operation, path, locator}.
-  Errors print {code, error, hint?} with a nonzero exit. Discover ids with
+  Prints a one-line confirmation on success (exit 0) \u2014 an in-place edit shifts nothing, so the
+  edited locator is unchanged and there's nothing to mint. --verbose prints {ok:true, operation,
+  path, locator}. Errors print {code, error, hint?} with a nonzero exit.
+  Heads up: a locator you hold from BEFORE a structural edit (an insert/delete elsewhere renumbers
+  ids) is stale \u2014 it lands on the wrong block or errors BLOCK_NOT_FOUND. Re-read after any
+  insert/delete, or apply the whole set from one read with --batch (above). Discover ids with
   \`docx read FILE --ast\` (equation ids appear on EquationRun nodes).
 
 Examples:
@@ -86442,9 +86437,9 @@ async function runAddNote(args, kind) {
   if (anchorCount > 1) {
     return fail("USAGE", "--at and --anchor are mutually exclusive", help);
   }
-  const text6 = parsed.values.text;
+  const text6 = decodeInlineEscapes(parsed.values.text);
   const runsJson = parsed.values.runs;
-  const markdown2 = parsed.values.markdown;
+  const markdown2 = decodeInlineEscapes(parsed.values.markdown);
   const markdownFile = parsed.values["markdown-file"];
   const bodyCount = (text6 !== undefined ? 1 : 0) + (runsJson !== undefined ? 1 : 0) + (markdown2 !== undefined ? 1 : 0) + (markdownFile !== undefined ? 1 : 0);
   if (bodyCount === 0) {
@@ -86868,9 +86863,9 @@ async function runEditNote(args, kind) {
   const config = noteConfig(kind);
   if (!idInput)
     return fail("USAGE", `Missing --at ${config.idPrefix}N`, help);
-  const text6 = parsed.values.text;
+  const text6 = decodeInlineEscapes(parsed.values.text);
   const runsJson = parsed.values.runs;
-  const markdown2 = parsed.values.markdown;
+  const markdown2 = decodeInlineEscapes(parsed.values.markdown);
   const markdownFile = parsed.values["markdown-file"];
   const bodyCount = (text6 !== undefined ? 1 : 0) + (runsJson !== undefined ? 1 : 0) + (markdown2 !== undefined ? 1 : 0) + (markdownFile !== undefined ? 1 : 0);
   if (bodyCount === 0) {
@@ -87645,7 +87640,7 @@ async function runSetMarginal(args, kind) {
   if (align !== undefined && !isAlign(align)) {
     return fail("USAGE", `Invalid --align: ${align}`, "Valid: left, center, right.");
   }
-  const text6 = parsed.values.text;
+  const text6 = decodeInlineEscapes(parsed.values.text);
   if (text6 === undefined && field === undefined) {
     return fail("USAGE", `Nothing to set \u2014 pass --text and/or a field (--page-number/--date/--style-ref/--field).`, helpFor7(kind));
   }
@@ -87740,6 +87735,7 @@ var OPTION_SPEC4, SAVE_FLAGS_HELP = `Output:
   -h, --help         Show this help`;
 var init_set = __esm(() => {
   init_core2();
+  init_parse_helpers();
   init_respond();
   init_shared();
   OPTION_SPEC4 = {
@@ -88879,10 +88875,10 @@ async function buildSingleShotOptions(filePath, values2) {
   if (typeof spec === "number")
     return spec;
   if (spec.kind === "text") {
-    const rejected = await rejectMarkdownInText(values2.text, HELP20);
+    const rejected = await rejectMarkdownInText(spec.text, HELP20);
     if (typeof rejected === "number")
       return rejected;
-    const mangled = await rejectShellMangledValue(values2.text, HELP20, "--text");
+    const mangled = await rejectShellMangledValue(spec.text, HELP20, "--text");
     if (typeof mangled === "number")
       return mangled;
   }
@@ -89022,7 +89018,7 @@ async function chooseContentSpec(values2) {
 }
 async function resolveMarkdownSpec(values2, flag) {
   if (flag === "markdown") {
-    const source2 = values2.markdown;
+    const source2 = decodeInlineEscapes(values2.markdown);
     return { kind: "markdown", source: source2 };
   }
   const path2 = values2["markdown-file"];
@@ -89067,7 +89063,7 @@ async function parseImageFlags(values2) {
   const alt = values2.alt;
   if (alt !== undefined)
     out.alt = alt;
-  const caption = values2.caption;
+  const caption = decodeInlineEscapes(values2.caption);
   if (caption !== undefined)
     out.caption = caption;
   const widthRaw = values2.width;
@@ -89092,7 +89088,7 @@ function buildTextSpec(values2) {
   const url = values2.url;
   return {
     kind: "text",
-    text: values2.text,
+    text: decodeInlineEscapes(values2.text),
     format: {
       color: values2.color,
       bold: values2.bold,
@@ -91608,7 +91604,7 @@ function formatNote(type, pairs, bareTokens = []) {
   return `<!-- ${parts.join(" ")} -->`;
 }
 function htmlAttr(key, value) {
-  const escaped = value.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;");
+  const escaped = value.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/\n/g, "&#10;").replace(/\r/g, "&#13;").replace(/\t/g, "&#9;");
   return `${key}="${escaped}"`;
 }
 function twipsToInches(twips) {
@@ -98021,7 +98017,7 @@ Examples:
 // package.json
 var package_default = {
   name: "bun-docx",
-  version: "0.19.2",
+  version: "0.20.1",
   description: "Read, edit, redline, and comment on Microsoft Word .docx files from the command line \u2014 built for AI agents.",
   keywords: [
     "docx",
@@ -98144,11 +98140,13 @@ Commands (each one-liner names capabilities you'd otherwise miss; see <command>
 It is highly recommended to run "docx info locators" and "docx info schema" (neither needs a FILE) to understand the addressing model and AST.
 Run "docx <command> --help" for command-specific help.
 
-BATCH MANY CHANGES IN ONE READ: filling a form or applying many edits? Don't go
-one-at-a-time \u2014 edit / insert / replace / delete and comments (add/resolve/delete)
-all take --batch FILE.jsonl (one JSON change per line; "-" reads stdin). Every locator
-addresses the document AS READ, so ids stay valid across the whole batch \u2014 one
-read, one write, no re-reading between changes. See "<command> --help".
+BATCH MANY CHANGES IN ONE READ: locator ids are positional and shift after structural
+edits (insert/delete/section changes), so going one-at-a-time forces a re-read to refresh
+ids after each. Miss the change and the next command lands on the wrong block or errors
+BLOCK_NOT_FOUND. Skip all that: edit / insert / replace / delete and comments
+(add/resolve/delete) all take --batch FILE.jsonl (one JSON change per line; "-" reads
+stdin). Every locator addresses the document AS READ, so ids stay valid across the whole
+batch \u2014 one read, one write, no re-reading between changes. See "<command> --help".
 
 FILL FORMATTED / TABBED LINES WITHOUT REBUILDING RUNS: to fill a template line that
 carries formatting (bold/font) or tab stops \u2014 e.g. "**Org Name**\u21E5Date" \u2014 replace just

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "bun-docx",
-	"version": "0.19.2",
+	"version": "0.20.1",
 	"description": "Read, edit, redline, and comment on Microsoft Word .docx files from the command line — built for AI agents.",
 	"keywords": [
 		"docx",