bun-docx 0.19.1 → 0.19.2

package/README.md

@@ -366,7 +366,7 @@ The CLI is built for non-interactive agents. **Exit code is the success signal**
 | Command class                                                                                                                                                                                                                                                              | Default stdout on success                                                                                                                                                                   | `--verbose`                                                               |
 | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------- |
 | **Mutator that mints a new handle** — `comments add`→`cN`, `comments reply`→`cN`, `footnotes/endnotes add`→`fnN`/`enN`, `hyperlinks add`→`linkN`, `insert`→the new `pN`                                                                                                    | the bare locator(s), **one per line** (a multi-block `--markdown` insert prints several)                                                                                                    | full `{ok:true,…}` ack                                                    |
-| **Mutator with no new handle** — `edit`, `delete`, `replace`, `create`, `comments resolve/delete`, `images replace/delete`, `hyperlinks replace/delete`, `footnotes/endnotes edit/delete`, `headers/footers set/clear`, `tables *`, `track-changes accept/reject` & toggle | **one-line confirmation** — `<operation> <target>` (e.g. `edit t1:r0c1:p0`, `edit 7 changes`, `replace 0 occurrences replaced`) (exit `0`)                                                  | full `{ok:true,…}` ack                                                    |
+| **Mutator with no new handle** — `edit`, `delete`, `replace`, `create`, `comments resolve/delete`, `images replace/delete`, `hyperlinks replace/delete`, `footnotes/endnotes edit/delete`, `headers/footers set/clear`, `tables *`, `track-changes accept/reject` & toggle | **one-line confirmation** — `<operation> <target>` (e.g. `edit t1:r0c1:p0`, `edit 7 changes`, `replace 3 occurrences replaced`) (exit `0`)                                                  | full `{ok:true,…}` ack                                                    |
 | `find`                                                                                                                                                                                                                                                                     | matched span locators, one per line (no matches → nothing, exit `0`)                                                                                                                        | `--json` → `{ totalMatches, query, view, matches:[…], normalizedQuery? }` |
 | `wc`                                                                                                                                                                                                                                                                       | the bare count (whole-doc adds a tab-separated `sections` column, like `wc`)                                                                                                                | `--json` → `{ words, scope, view, sections? }`                            |
 | `outline`                                                                                                                                                                                                                                                                  | indented `LOCATOR⇥TEXT` tree (two spaces per level)                                                                                                                                         | `--json` → nested `[{ id, locator, level, style, text, children }]`       |

package/dist/index.js

@@ -93257,6 +93257,13 @@ async function runReplaceBatch(filePath, batchSource, values2) {
     return EXIT2.OK;
   }
   await document4.save(outputPath);
+  const noops = results.filter((entry) => entry.replaced === 0);
+  if (noops.length > 0) {
+    const list3 = noops.map((entry) => JSON.stringify(entry.pattern)).join(", ");
+    const applied = results.length - noops.length;
+    const savedNote = applied === 0 ? "No entry matched, so the document is unchanged." : `The other ${applied} ${applied === 1 ? "entry was" : "entries were"} applied and SAVED \u2014 this nonzero exit means "some entries missed," not "nothing changed."`;
+    return await fail("MATCH_NOT_FOUND", `${noops.length} of ${results.length} replace ${results.length === 1 ? "entry" : "entries"} matched nothing (0 occurrences): ${list3}. ${savedNote}`, `Those patterns weren't found as LITERAL document text \u2014 check for read-view markup (\`<mark>\`/\`<u>\`) or a locator in the pattern. \`docx find\` locates the real text; --ignore-case/--regex/--at scope the search.`);
+  }
   await respondAck({
     ok: true,
     operation: "replace",
@@ -93459,22 +93466,8 @@ async function run40(args) {
     return EXIT2.OK;
   }
   if (selected.length === 0) {
-    await respondAck({
-      ok: true,
-      operation: "replace",
-      path: path2,
-      pattern,
-      replacement,
-      regex: useRegex,
-      ignoreCase,
-      view: findView,
-      ...atScope ? { at: atScope } : {},
-      totalMatches: 0,
-      replaced: 0,
-      matches: [],
-      ...normalizationFields
-    });
-    return EXIT2.OK;
+    const scopeNote = atScope ? ` within ${atScope}` : "";
+    return await fail("MATCH_NOT_FOUND", `Pattern not found${scopeNote}: ${JSON.stringify(pattern)} \u2014 0 occurrences, nothing changed.`, `Match LITERAL document text, not read-view markup (\`<mark>\`/\`<u>\`/\`**\`\u2026) or a locator. Run \`docx find ${JSON.stringify(pattern)} ${path2}\` to see if/where it occurs; add --ignore-case, --regex, --at <locator> to scope, or --current/--baseline to search tracked-change text.`);
   }
   const reversed = [...selected].sort((leftMatch, rightMatch) => {
     if (leftMatch.blockId !== rightMatch.blockId) {
@@ -93580,6 +93573,10 @@ Output:
   addressable handle (matched-span locators shift as text changes; re-read or
   use --dry-run to see them). --verbose / --dry-run print
   {ok:true, operation, totalMatches, replaced, matches:[{locator,\u2026}], \u2026}.
+  A PATTERN that matches NOTHING is an error, not a silent success \u2014 0 occurrences
+  exits nonzero (MATCH_NOT_FOUND), so a no-op replace can't read as "done." Unsure it
+  matches? Probe with \`docx find PATTERN FILE\` or --dry-run and READ the reported count
+  \u2014 both exit 0 whether or not it matches; only the real replace exits nonzero on 0.
   Errors print {code, error, hint?} with a nonzero exit.
 
 Examples:
@@ -98024,7 +98021,7 @@ Examples:
 // package.json
 var package_default = {
   name: "bun-docx",
-  version: "0.19.1",
+  version: "0.19.2",
   description: "Read, edit, redline, and comment on Microsoft Word .docx files from the command line \u2014 built for AI agents.",
   keywords: [
     "docx",

package/package.json

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