bun-docx 0.6.0 → 0.6.1

package/README.md

@@ -40,6 +40,9 @@ docx delete FILE --at p3
 docx find FILE QUERY [--regex] [--ignore-case] [--all] [--nth N]
 docx replace FILE PATTERN REPLACEMENT [--regex] [--ignore-case] [--all] [--limit N] [--dry-run]
 
+docx wc      FILE [LOCATOR]
+docx outline FILE
+
 docx comments add     FILE --range p3:5-20 --text "..." [--author NAME]
 docx comments reply   FILE --to c0 --text "..."
 docx comments resolve FILE --id c0 [--unset]
@@ -62,7 +65,9 @@ docx info locators [--json]
 
 Every command has `--help`. Mutating commands accept `--dry-run` and `-o/--output PATH` (write to a parallel file instead of overwriting `FILE`). JSON output by default for `read` and `*.list`; structured `{ok, code, error, hint}` on failure.
 
-When `<w:trackChanges/>` is set in the doc (toggle via `docx track-changes FILE on`), `insert`/`edit`/`delete`/`replace` automatically emit `<w:ins>`/`<w:del>` markers attributed to `$DOCX_AUTHOR` (default `docx-cli`). To make a one-off untracked edit, flip the flag off, edit, then flip it back on. `find` results inside tracked-change wrappers carry a `trackedChanges` array so agents can decide what to do with hits in pending insertions/deletions.
+When `<w:trackChanges/>` is set in the doc (toggle via `docx track-changes FILE on`), `insert`/`edit`/`delete`/`replace` automatically emit `<w:ins>`/`<w:del>` markers. Author resolution: per-call `--author NAME` overrides `$DOCX_AUTHOR`, which falls back to `docx-cli`. To make a one-off untracked edit, flip the flag off, edit, then flip it back on. `find` results inside tracked-change wrappers carry a `trackedChanges` array so agents can decide what to do with hits in pending insertions/deletions.
+
+OOXML has no native tracked-change form for hyperlink edits or image swaps, so when track-changes is on, `hyperlinks add/replace/delete` and `images replace` auto-emit a `[docx-cli] …` comment anchored to the affected span/run instead. The comment carries the same `--author` attribution as the other tracked operations. Word itself silently bypasses tracking for these — we trade silence for an explicit audit trail.
 
 ### Markdown rendering
 
@@ -139,6 +144,10 @@ src/
     insert/              # insert FILE  (uses ./emit Paragraph component)
     edit/                # edit FILE
     delete/              # delete FILE
+    find/                # find FILE QUERY
+    replace/             # replace FILE PATTERN REPLACEMENT
+    wc/                  # wc FILE [LOCATOR]
+    outline/             # outline FILE
     comments/            # add | reply | resolve | delete | list
     images/              # list | extract | replace
     hyperlinks/          # add | list | replace | delete

package/dist/index.js

@@ -14645,8 +14645,6 @@ function resolveAuthor(authorFlag) {
     return authorFlag;
   if (Bun.env.DOCX_AUTHOR)
     return Bun.env.DOCX_AUTHOR;
-  if (Bun.env.DOCX_CLI_AUTHOR)
-    return Bun.env.DOCX_CLI_AUTHOR;
   return "docx-cli";
 }
 function resolveDate() {
@@ -15067,15 +15065,15 @@ function ensureCommentsExtPart(view) {
   return root;
 }
 function paragraphTextLength(paragraph) {
+  return sumTextLength(paragraph.children);
+}
+function sumTextLength(children) {
   let total = 0;
-  for (const child of paragraph.children) {
+  for (const child of children) {
     if (child.tag === "w:r")
       total += runTextLength(child);
-    else if (child.tag === "w:ins" || child.tag === "w:del") {
-      for (const inner of child.children) {
-        if (inner.tag === "w:r")
-          total += runTextLength(inner);
-      }
+    else if (child.tag === "w:ins" || child.tag === "w:del" || child.tag === "w:hyperlink") {
+      total += sumTextLength(child.children);
     }
   }
   return total;
@@ -15114,6 +15112,97 @@ function addCommentRangeMarkers(startParagraph, startOffset, endParagraph, endOf
     }
   ]);
 }
+function addCommentMarkersAroundRun(paragraph, target, commentId) {
+  function walk(parent) {
+    const children = parent.children;
+    for (let index = 0;index < children.length; index++) {
+      const child = children[index];
+      if (child === target) {
+        children.splice(index, 1, commentRangeStartMarker(commentId), target, commentRangeEndMarker(commentId), commentReferenceRun(commentId));
+        return true;
+      }
+      if (child && (child.tag === "w:ins" || child.tag === "w:del" || child.tag === "w:hyperlink")) {
+        if (walk(child))
+          return true;
+      }
+    }
+    return false;
+  }
+  return walk(paragraph);
+}
+function findElementOffsetsInParagraph(paragraph, target) {
+  let cursor = 0;
+  let result = null;
+  function walk(children) {
+    for (const child of children) {
+      if (child === target) {
+        const start = cursor;
+        cursor += sumTextLength([child]);
+        result = { start, end: cursor };
+        return true;
+      }
+      if (child.tag === "w:r") {
+        cursor += runTextLength(child);
+        continue;
+      }
+      if (child.tag === "w:ins" || child.tag === "w:del" || child.tag === "w:hyperlink") {
+        if (walk(child.children))
+          return true;
+      }
+    }
+    return false;
+  }
+  walk(paragraph.children);
+  return result;
+}
+function findContainingParagraph(documentTree, target) {
+  function walk(node) {
+    if (node.tag === "w:p" && containsNode(node, target))
+      return node;
+    for (const child of node.children) {
+      const found = walk(child);
+      if (found)
+        return found;
+    }
+    return null;
+  }
+  for (const root of documentTree) {
+    const found = walk(root);
+    if (found)
+      return found;
+  }
+  return null;
+}
+function containsNode(haystack, needle) {
+  if (haystack === needle)
+    return true;
+  for (const child of haystack.children) {
+    if (containsNode(child, needle))
+      return true;
+  }
+  return false;
+}
+function emitAuditComment(view, anchor, options) {
+  const numericId = nextCommentId(view);
+  const paraId = generateParaId();
+  if (anchor.kind === "span") {
+    addCommentMarkersToParagraph(anchor.paragraph, numericId, anchor.span);
+  } else {
+    addCommentMarkersAroundRun(anchor.paragraph, anchor.run, numericId);
+  }
+  const commentsRoot = ensureCommentsPart(view);
+  commentsRoot.children.push(/* @__PURE__ */ jsxDEV(CommentBody, {
+    options: {
+      id: numericId,
+      author: options.author,
+      date: options.date,
+      initials: authorInitials(options.author),
+      paraId,
+      text: options.body
+    }
+  }, undefined, false, undefined, this));
+  return numericId;
+}
 function commentRangeStartMarker(commentId) {
   return /* @__PURE__ */ jsxDEV(w.commentRangeStart, {
     "w-id": commentId
@@ -15149,13 +15238,13 @@ function placeMarkersInParagraph(paragraph, markers) {
   }
   const pending = markers.slice();
   const state = { offset: 0, placedCount: 0 };
-  paragraph.children = walkAndPlace(paragraph.children, pending, true, state);
+  paragraph.children = walkAndPlace(paragraph.children, pending, state);
   flushAtCurrentOffset(paragraph.children, pending, state);
   if (state.placedCount !== markers.length) {
     throw new SpanOutOfRangeError(`Could not place comment markers (placed ${state.placedCount} of ${markers.length})`);
   }
 }
-function walkAndPlace(children, pending, isParagraphLevel, state) {
+function walkAndPlace(children, pending, state) {
   const result = [];
   for (const child of children) {
     if (child.tag === "w:r") {
@@ -15197,9 +15286,9 @@ function walkAndPlace(children, pending, isParagraphLevel, state) {
       state.offset = runEnd;
       continue;
     }
-    if (isParagraphLevel && (child.tag === "w:ins" || child.tag === "w:del")) {
+    if (child.tag === "w:ins" || child.tag === "w:del" || child.tag === "w:hyperlink") {
       flushAtCurrentOffset(result, pending, state);
-      const innerChildren = walkAndPlace(child.children, pending, false, state);
+      const innerChildren = walkAndPlace(child.children, pending, state);
       const wrapper = new XmlNode2(child.tag, { ...child.attributes });
       wrapper.children = innerChildren;
       result.push(wrapper);
@@ -16174,6 +16263,7 @@ async function run8(args) {
       allowPositionals: true,
       options: {
         at: { type: "string" },
+        author: { type: "string" },
         output: { type: "string", short: "o" },
         "dry-run": { type: "boolean" },
         help: { type: "boolean", short: "h" }
@@ -16219,7 +16309,7 @@ async function run8(args) {
     if (blockRef.node.tag !== "w:p") {
       return fail("TRACKED_CHANGE_CONFLICT", "Tracked deletion of non-paragraph blocks (e.g., tables) is not supported", "Use `docx track-changes off` first, or delete table contents row-by-row.");
     }
-    applyTrackedDeletion(view, blockRef.node);
+    applyTrackedDeletion(view, blockRef.node, parsed.values.author);
   } else {
     blockRef.parent.splice(targetIndex, 1);
   }
@@ -16232,9 +16322,9 @@ async function run8(args) {
   });
   return EXIT.OK;
 }
-function applyTrackedDeletion(view, paragraph) {
+function applyTrackedDeletion(view, paragraph, authorFlag) {
   const allocator = createRevisionAllocator(view);
-  const baseMeta = { author: resolveAuthor(), date: resolveDate() };
+  const baseMeta = { author: resolveAuthor(authorFlag), date: resolveDate() };
   const mintMeta = () => ({
     ...baseMeta,
     revisionId: allocator.next()
@@ -16271,6 +16361,7 @@ Usage:
 Locator (required):
   --at LOCATOR      Block to remove (e.g., p3, t0)
 
+  --author NAME     Author for tracked changes (default: $DOCX_AUTHOR)
   -o, --output PATH Write to PATH instead of overwriting FILE
   --dry-run         Print what would be removed; do not write the file
   -h, --help        Show this help
@@ -16423,6 +16514,7 @@ async function run9(args) {
         color: { type: "string" },
         bold: { type: "boolean" },
         italic: { type: "boolean" },
+        author: { type: "string" },
         output: { type: "string", short: "o" },
         "dry-run": { type: "boolean" },
         help: { type: "boolean", short: "h" }
@@ -16510,7 +16602,7 @@ async function run9(args) {
     return EXIT.OK;
   }
   if (isTrackChangesEnabled(view)) {
-    applyTrackedEdit(view, blockRef.node, paragraphNode);
+    applyTrackedEdit(view, blockRef.node, paragraphNode, parsed.values.author);
   } else {
     blockRef.parent.splice(targetIndex, 1, paragraphNode);
   }
@@ -16523,9 +16615,9 @@ async function run9(args) {
   });
   return EXIT.OK;
 }
-function applyTrackedEdit(view, existingParagraph, newParagraph) {
+function applyTrackedEdit(view, existingParagraph, newParagraph, authorFlag) {
   const allocator = createRevisionAllocator(view);
-  const baseMeta = { author: resolveAuthor(), date: resolveDate() };
+  const baseMeta = { author: resolveAuthor(authorFlag), date: resolveDate() };
   const mintMeta = () => ({
     ...baseMeta,
     revisionId: allocator.next()
@@ -16592,6 +16684,7 @@ Run options (only with --text):
   --bold            Bold
   --italic          Italic
 
+  --author NAME     Author for tracked changes (default: $DOCX_AUTHOR)
   -o, --output PATH Write to PATH instead of overwriting FILE
   --dry-run         Print what would change; do not write the file
   -h, --help        Show this help
@@ -16933,6 +17026,7 @@ async function run11(args) {
       options: {
         at: { type: "string" },
         url: { type: "string" },
+        author: { type: "string" },
         output: { type: "string", short: "o" },
         "dry-run": { type: "boolean" },
         help: { type: "boolean", short: "h" }
@@ -17001,6 +17095,13 @@ async function run11(args) {
     throw error;
   }
   view.hyperlinksByRelationshipId.set(relationshipId, { url });
+  if (isTrackChangesEnabled(view)) {
+    emitAuditComment(view, { kind: "span", paragraph: paragraphRef.node, span: target.span }, {
+      body: `[docx-cli] hyperlink added \u2192 ${url}`,
+      author: resolveAuthor(parsed.values.author),
+      date: resolveDate()
+    });
+  }
   await saveDocView(view, outputPath);
   await respond({
     ok: true,
@@ -17023,6 +17124,8 @@ Required:
   --url URL         Target URL
 
 Optional:
+  --author NAME     Author for the audit comment when track-changes is on
+                    (default: $DOCX_AUTHOR)
   -o, --output PATH Write to PATH instead of overwriting FILE
   --dry-run         Print what would change; do not write the file
   -h, --help        Show this help
@@ -17030,12 +17133,16 @@ Optional:
 The span must lie inside a single paragraph and must not overlap an existing
 hyperlink or a tracked-change wrapper.
 
+When track-changes is on, an audit comment is anchored to the wrapped span
+since OOXML has no native tracked-change form for hyperlink edits.
+
 Examples:
   docx hyperlinks add doc.docx --at p3:5-20 --url https://example.com
 `;
 var init_add2 = __esm(() => {
   init_core();
   init_parser();
+  init_helpers();
   init_respond();
   init_wrap();
 });
@@ -17054,6 +17161,7 @@ async function run12(args) {
       allowPositionals: true,
       options: {
         at: { type: "string" },
+        author: { type: "string" },
         output: { type: "string", short: "o" },
         "dry-run": { type: "boolean" },
         help: { type: "boolean", short: "h" }
@@ -17098,6 +17206,9 @@ async function run12(args) {
   if (index === -1) {
     return fail("HYPERLINK_NOT_FOUND", `Hyperlink reference is stale (parent does not contain it): ${targetId}`);
   }
+  const trackingOn = isTrackChangesEnabled(view);
+  const paragraph = trackingOn ? findContainingParagraph(view.documentTree, reference.node) : null;
+  const offsets = trackingOn && paragraph ? findElementOffsetsInParagraph(paragraph, reference.node) : null;
   reference.parent.splice(index, 1, ...reference.node.children);
   view.hyperlinkById.delete(targetId);
   if (reference.relationshipId) {
@@ -17107,6 +17218,13 @@ async function run12(args) {
       view.hyperlinksByRelationshipId.delete(reference.relationshipId);
     }
   }
+  if (trackingOn && paragraph && offsets) {
+    emitAuditComment(view, { kind: "span", paragraph, span: offsets }, {
+      body: `[docx-cli] hyperlink removed (was: ${oldUrl ?? "(none)"})`,
+      author: resolveAuthor(parsed.values.author),
+      date: resolveDate()
+    });
+  }
   await saveDocView(view, outputPath);
   await respond({
     ok: true,
@@ -17149,6 +17267,8 @@ Required:
   --at LINK_ID      Existing hyperlink to remove (e.g., link0)
 
 Optional:
+  --author NAME     Author for the audit comment when track-changes is on
+                    (default: $DOCX_AUTHOR)
   -o, --output PATH Write to PATH instead of overwriting FILE
   --dry-run         Print what would change; do not write the file
   -h, --help        Show this help
@@ -17157,12 +17277,16 @@ The display text stays in place; only the <w:hyperlink> wrapper is removed.
 If the underlying relationship is no longer referenced, it is pruned from the
 rels file too.
 
+When track-changes is on, an audit comment is anchored to the surviving text
+since OOXML has no native tracked-change form for hyperlink removal.
+
 Examples:
   docx hyperlinks delete doc.docx --at link0
 `;
 var init_delete3 = __esm(() => {
   init_core();
   init_parser();
+  init_helpers();
   init_respond();
 });
 
@@ -17272,6 +17396,7 @@ async function run14(args) {
       options: {
         at: { type: "string" },
         with: { type: "string" },
+        author: { type: "string" },
         output: { type: "string", short: "o" },
         "dry-run": { type: "boolean" },
         help: { type: "boolean", short: "h" }
@@ -17333,6 +17458,17 @@ async function run14(args) {
     updateRelationshipTarget(relationships, existingId, newUrl);
     view.hyperlinksByRelationshipId.set(existingId, { url: newUrl });
   }
+  if (isTrackChangesEnabled(view)) {
+    const paragraph = findContainingParagraph(view.documentTree, reference.node);
+    const offsets = paragraph ? findElementOffsetsInParagraph(paragraph, reference.node) : null;
+    if (paragraph && offsets) {
+      emitAuditComment(view, { kind: "span", paragraph, span: offsets }, {
+        body: `[docx-cli] hyperlink target changed: ${oldUrl ?? "(none)"} \u2192 ${newUrl}`,
+        author: resolveAuthor(parsed.values.author),
+        date: resolveDate()
+      });
+    }
+  }
   await saveDocView(view, outputPath);
   await respond({
     ok: true,
@@ -17381,6 +17517,8 @@ Required:
   --with URL        New target URL
 
 Optional:
+  --author NAME     Author for the audit comment when track-changes is on
+                    (default: $DOCX_AUTHOR)
   -o, --output PATH Write to PATH instead of overwriting FILE
   --dry-run         Print what would change; do not write the file
   -h, --help        Show this help
@@ -17389,12 +17527,17 @@ Replaces only the targeted hyperlink. If multiple hyperlinks shared the same
 underlying relationship, a new relationship is allocated so the others are
 unaffected.
 
+When track-changes is on, an audit comment is anchored to the affected
+hyperlink span since OOXML has no native tracked-change form for hyperlink
+target edits.
+
 Examples:
   docx hyperlinks replace doc.docx --at link0 --with https://example.com
 `;
 var init_replace = __esm(() => {
   init_core();
   init_parser();
+  init_helpers();
   init_respond();
 });
 
@@ -17654,6 +17797,7 @@ async function run18(args) {
       options: {
         at: { type: "string" },
         with: { type: "string" },
+        author: { type: "string" },
         output: { type: "string", short: "o" },
         "dry-run": { type: "boolean" },
         help: { type: "boolean", short: "h" }
@@ -17709,6 +17853,7 @@ async function run18(args) {
     return EXIT.OK;
   }
   const bytes = new Uint8Array(await sourceFile.arrayBuffer());
+  const originalMimeType = reference.contentType;
   if (newPartName === originalPartName) {
     view.pkg.writeBytes(originalPartName, bytes);
   } else {
@@ -17719,6 +17864,18 @@ async function run18(args) {
     reference.partName = newPartName;
     reference.contentType = newMimeType;
   }
+  if (isTrackChangesEnabled(view)) {
+    const author = resolveAuthor(parsed.values.author);
+    const date = resolveDate();
+    const body = `[docx-cli] image replaced: ${originalPartName} (${originalMimeType}) \u2192 ${newPartName} (${newMimeType}, ${bytes.length} bytes)`;
+    const drawingRuns = findDrawingRunsForRelationship(view.documentTree, reference.relationshipId);
+    for (const drawingRun of drawingRuns) {
+      const paragraph = findContainingParagraph(view.documentTree, drawingRun);
+      if (!paragraph)
+        continue;
+      emitAuditComment(view, { kind: "run", paragraph, run: drawingRun }, { body, author, date });
+    }
+  }
   await saveDocView(view, outputPath);
   await respond({
     ok: true,
@@ -17731,6 +17888,33 @@ async function run18(args) {
   });
   return EXIT.OK;
 }
+function findDrawingRunsForRelationship(documentTree, relationshipId) {
+  const matches = [];
+  function walk(node) {
+    if (node.tag === "w:r" && runReferencesImage(node, relationshipId)) {
+      matches.push(node);
+      return;
+    }
+    for (const child of node.children)
+      walk(child);
+  }
+  for (const root of documentTree)
+    walk(root);
+  return matches;
+}
+function runReferencesImage(run19, relationshipId) {
+  for (const child of run19.children) {
+    if (child.tag !== "w:drawing")
+      continue;
+    const blip = child.findDescendant("a:blip");
+    if (!blip)
+      continue;
+    const embed = blip.getAttribute("r:embed") ?? blip.getAttribute("r:link");
+    if (embed === relationshipId)
+      return true;
+  }
+  return false;
+}
 function renameExtension(partName, newExtension) {
   const dotIndex = partName.lastIndexOf(".");
   const slashIndex = partName.lastIndexOf("/");
@@ -17777,6 +17961,8 @@ Required:
   --with PATH       New image file (any image MIME type)
 
 Optional:
+  --author NAME     Author for the audit comment when track-changes is on
+                    (default: $DOCX_AUTHOR)
   -o, --output PATH Write to PATH instead of overwriting FILE
   --dry-run         Print what would change; do not write the file
   -h, --help        Show this help
@@ -17785,6 +17971,10 @@ If the replacement uses a different format from the original, the part is
 renamed (extension changes), the relationship Target is rewritten, and
 [Content_Types].xml gets a Default entry for the new extension if needed.
 
+When track-changes is on, an audit comment is anchored to each drawing that
+referenced the swapped image since OOXML has no native tracked-change form
+for image replacement.
+
 Examples:
   docx images replace doc.docx --at img2 --with ./new-photo.png
   docx images replace doc.docx --at img0 --with ./diagram.svg
@@ -17792,6 +17982,7 @@ Examples:
 var init_replace2 = __esm(() => {
   init_core();
   init_parser();
+  init_helpers();
   init_respond();
   EXTENSION_BY_MIME = {
     "image/png": "png",
@@ -18036,10 +18227,10 @@ async function run20(args) {
   await respond(JSON_SCHEMA);
   return EXIT.OK;
 }
-var HELP20 = `docx schema \u2014 print the AST type definitions
+var HELP20 = `docx info schema \u2014 print the AST type definitions
 
 Usage:
-  docx schema [options]
+  docx info schema [options]
 
 Options:
   --json       Print as a JSON Schema document (default)
@@ -18047,8 +18238,8 @@ Options:
   -h, --help   Show this help
 
 Examples:
-  docx schema | jq '.definitions.Run'
-  docx schema --ts > ast.d.ts
+  docx info schema | jq '.$defs.Run'
+  docx info schema --ts > ast.d.ts
 `, JSON_SCHEMA;
 var init_schema = __esm(() => {
   init_types();
@@ -18316,14 +18507,18 @@ async function run21(args) {
   await writeStdout(REFERENCE);
   return EXIT.OK;
 }
-var HELP21 = `docx locators \u2014 print the locator grammar reference
+var HELP21 = `docx info locators \u2014 print the locator grammar reference
 
 Usage:
-  docx locators [options]
+  docx info locators [options]
 
 Options:
   --json       Print as JSON
   -h, --help   Show this help
+
+Examples:
+  docx info locators
+  docx info locators --json | jq '.entityLocators'
 `, REFERENCE = `LOCATOR GRAMMAR
 
 Block locators:
@@ -18456,6 +18651,7 @@ async function run23(args) {
         bold: { type: "boolean" },
         italic: { type: "boolean" },
         url: { type: "string" },
+        author: { type: "string" },
         output: { type: "string", short: "o" },
         "dry-run": { type: "boolean" },
         help: { type: "boolean", short: "h" }
@@ -18544,7 +18740,7 @@ async function run23(args) {
   }
   const insertIndex = after !== undefined ? targetIndex + 1 : targetIndex;
   if (isTrackChangesEnabled(view)) {
-    applyTrackedInsertion(paragraphNode, view);
+    applyTrackedInsertion(paragraphNode, view, parsed.values.author);
   }
   const outputPath = parsed.values.output;
   if (parsed.values["dry-run"]) {
@@ -18593,9 +18789,9 @@ function wrapFirstRunInHyperlink(view, paragraph, url) {
   }
   paragraph.children = newChildren;
 }
-function applyTrackedInsertion(paragraph, view) {
+function applyTrackedInsertion(paragraph, view, authorFlag) {
   const allocator = createRevisionAllocator(view);
-  const baseMeta = { author: resolveAuthor(), date: resolveDate() };
+  const baseMeta = { author: resolveAuthor(authorFlag), date: resolveDate() };
   const mintMeta = () => ({
     ...baseMeta,
     revisionId: allocator.next()
@@ -18646,6 +18842,7 @@ Run options (only with --text):
   --italic          Italic
   --url URL         Wrap the inserted text in a hyperlink to URL
 
+  --author NAME     Author for tracked changes (default: $DOCX_AUTHOR)
   -o, --output PATH Write to PATH instead of overwriting FILE
   --dry-run         Print what would be inserted; do not write the file
   -h, --help        Show this help
@@ -19694,6 +19891,7 @@ async function run26(args) {
         "ignore-case": { type: "boolean" },
         all: { type: "boolean" },
         limit: { type: "string" },
+        author: { type: "string" },
         output: { type: "string", short: "o" },
         "dry-run": { type: "boolean" },
         help: { type: "boolean", short: "h" }
@@ -19792,8 +19990,9 @@ async function run26(args) {
     }
     return rightMatch.start - leftMatch.start;
   });
+  const authorFlag = parsed.values.author;
   const tracked = isTrackChangesEnabled(view) ? {
-    meta: { author: resolveAuthor(), date: resolveDate() },
+    meta: { author: resolveAuthor(authorFlag), date: resolveDate() },
     allocator: createRevisionAllocator(view)
   } : undefined;
   const regexFlags = ignoreCase ? "i" : "";
@@ -19827,6 +20026,7 @@ Options:
   --ignore-case     case-insensitive match
   --all             replace every match (default: just the first)
   --limit N         replace at most N matches (in document order)
+  --author NAME     author for tracked changes (default: $DOCX_AUTHOR)
   -o, --output PATH write to PATH instead of overwriting FILE
   --dry-run         report what would change without writing the file
   -h, --help        show this help
@@ -20220,7 +20420,7 @@ var init_wc = __esm(() => {
 // package.json
 var package_default = {
   name: "bun-docx",
-  version: "0.6.0",
+  version: "0.6.1",
   description: "CLI for AI agents (Claude, Codex) to read, edit, and comment on .docx files with full format fidelity.",
   keywords: [
     "docx",
@@ -20299,7 +20499,7 @@ Commands:
   outline   FILE  List headings as a hierarchical tree
   comments  \u2026     Add, reply, resolve, delete, list comments
   images    \u2026     Extract, replace, list images
-  hyperlinks \u2026    List, replace hyperlinks
+  hyperlinks \u2026    Add, list, replace, delete hyperlinks
   track-changes FILE on|off  Toggle tracked-changes mode
   info      \u2026     Reference material (schema, locators)
 

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "bun-docx",
-	"version": "0.6.0",
+	"version": "0.6.1",
 	"description": "CLI for AI agents (Claude, Codex) to read, edit, and comment on .docx files with full format fidelity.",
 	"keywords": [
 		"docx",