docrev 0.10.2 → 0.11.1

package/package.json

@@ -1,137 +1,137 @@
-{
-  "name": "docrev",
-  "version": "0.10.2",
-  "description": "Academic paper revision workflow: Word ↔ Markdown round-trips, DOI validation, reviewer comments",
-  "type": "module",
-  "types": "dist/lib/types.d.ts",
-  "exports": {
-    ".": {
-      "types": "./dist/lib/annotations.d.ts",
-      "import": "./dist/lib/annotations.js"
-    },
-    "./annotations": {
-      "types": "./dist/lib/annotations.d.ts",
-      "import": "./dist/lib/annotations.js"
-    },
-    "./build": {
-      "types": "./dist/lib/build.d.ts",
-      "import": "./dist/lib/build.js"
-    },
-    "./citations": {
-      "types": "./dist/lib/citations.d.ts",
-      "import": "./dist/lib/citations.js"
-    },
-    "./crossref": {
-      "types": "./dist/lib/crossref.d.ts",
-      "import": "./dist/lib/crossref.js"
-    },
-    "./doi": {
-      "types": "./dist/lib/doi.d.ts",
-      "import": "./dist/lib/doi.js"
-    },
-    "./equations": {
-      "types": "./dist/lib/equations.d.ts",
-      "import": "./dist/lib/equations.js"
-    },
-    "./git": {
-      "types": "./dist/lib/git.d.ts",
-      "import": "./dist/lib/git.js"
-    },
-    "./journals": {
-      "types": "./dist/lib/journals.d.ts",
-      "import": "./dist/lib/journals.js"
-    },
-    "./merge": {
-      "types": "./dist/lib/merge.d.ts",
-      "import": "./dist/lib/merge.js"
-    },
-    "./sections": {
-      "types": "./dist/lib/sections.d.ts",
-      "import": "./dist/lib/sections.js"
-    },
-    "./word": {
-      "types": "./dist/lib/word.d.ts",
-      "import": "./dist/lib/word.js"
-    },
-    "./variables": {
-      "types": "./dist/lib/variables.d.ts",
-      "import": "./dist/lib/variables.js"
-    },
-    "./grammar": {
-      "types": "./dist/lib/grammar.d.ts",
-      "import": "./dist/lib/grammar.js"
-    },
-    "./trackchanges": {
-      "types": "./dist/lib/trackchanges.d.ts",
-      "import": "./dist/lib/trackchanges.js"
-    },
-    "./spelling": {
-      "types": "./dist/lib/spelling.d.ts",
-      "import": "./dist/lib/spelling.js"
-    },
-    "./wordcomments": {
-      "types": "./dist/lib/wordcomments.d.ts",
-      "import": "./dist/lib/wordcomments.js"
-    }
-  },
-  "engines": {
-    "node": ">=18.0.0"
-  },
-  "bin": {
-    "rev": "bin/rev.js"
-  },
-  "scripts": {
-    "build": "tsc && node scripts/postbuild.js",
-    "build:watch": "tsc --watch",
-    "dev": "tsx bin/rev.ts",
-    "test": "tsx --test test/*.test.js",
-    "test:ts": "tsx --test test/*.test.ts",
-    "test:watch": "node --test --watch test/*.test.js",
-    "test:coverage": "c8 --reporter=text --reporter=lcov node --test test/*.test.js",
-    "typecheck": "tsc --noEmit",
-    "prepublishOnly": "npm run build"
-  },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/gcol33/docrev.git"
-  },
-  "bugs": {
-    "url": "https://github.com/gcol33/docrev/issues"
-  },
-  "homepage": "https://github.com/gcol33/docrev#readme",
-  "keywords": [
-    "markdown",
-    "word",
-    "docx",
-    "track-changes",
-    "comments",
-    "academic",
-    "writing",
-    "pandoc",
-    "criticmarkup"
-  ],
-  "author": "Gilles Colling",
-  "license": "MIT",
-  "dependencies": {
-    "adm-zip": "^0.5.16",
-    "chalk": "^5.3.0",
-    "commander": "^12.0.0",
-    "dictionary-en": "^4.0.0",
-    "dictionary-en-gb": "^3.0.0",
-    "diff": "^8.0.2",
-    "mathml-to-latex": "^1.5.0",
-    "nspell": "^2.1.5",
-    "pdf-lib": "^1.17.1",
-    "pdfjs-dist": "^5.4.530",
-    "tsx": "^4.21.0",
-    "xml2js": "^0.6.2",
-    "yaml": "^2.8.2"
-  },
-  "devDependencies": {
-    "@types/adm-zip": "^0.5.7",
-    "@types/node": "^25.2.0",
-    "@types/xml2js": "^0.4.14",
-    "c8": "^10.1.2",
-    "typescript": "^5.9.3"
-  }
-}
+{
+  "name": "docrev",
+  "version": "0.11.1",
+  "description": "Academic paper revision workflow: Word ↔ Markdown round-trips, DOI validation, reviewer comments",
+  "type": "module",
+  "types": "dist/lib/types.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/lib/annotations.d.ts",
+      "import": "./dist/lib/annotations.js"
+    },
+    "./annotations": {
+      "types": "./dist/lib/annotations.d.ts",
+      "import": "./dist/lib/annotations.js"
+    },
+    "./build": {
+      "types": "./dist/lib/build.d.ts",
+      "import": "./dist/lib/build.js"
+    },
+    "./citations": {
+      "types": "./dist/lib/citations.d.ts",
+      "import": "./dist/lib/citations.js"
+    },
+    "./crossref": {
+      "types": "./dist/lib/crossref.d.ts",
+      "import": "./dist/lib/crossref.js"
+    },
+    "./doi": {
+      "types": "./dist/lib/doi.d.ts",
+      "import": "./dist/lib/doi.js"
+    },
+    "./equations": {
+      "types": "./dist/lib/equations.d.ts",
+      "import": "./dist/lib/equations.js"
+    },
+    "./git": {
+      "types": "./dist/lib/git.d.ts",
+      "import": "./dist/lib/git.js"
+    },
+    "./journals": {
+      "types": "./dist/lib/journals.d.ts",
+      "import": "./dist/lib/journals.js"
+    },
+    "./merge": {
+      "types": "./dist/lib/merge.d.ts",
+      "import": "./dist/lib/merge.js"
+    },
+    "./sections": {
+      "types": "./dist/lib/sections.d.ts",
+      "import": "./dist/lib/sections.js"
+    },
+    "./word": {
+      "types": "./dist/lib/word.d.ts",
+      "import": "./dist/lib/word.js"
+    },
+    "./variables": {
+      "types": "./dist/lib/variables.d.ts",
+      "import": "./dist/lib/variables.js"
+    },
+    "./grammar": {
+      "types": "./dist/lib/grammar.d.ts",
+      "import": "./dist/lib/grammar.js"
+    },
+    "./trackchanges": {
+      "types": "./dist/lib/trackchanges.d.ts",
+      "import": "./dist/lib/trackchanges.js"
+    },
+    "./spelling": {
+      "types": "./dist/lib/spelling.d.ts",
+      "import": "./dist/lib/spelling.js"
+    },
+    "./wordcomments": {
+      "types": "./dist/lib/wordcomments.d.ts",
+      "import": "./dist/lib/wordcomments.js"
+    }
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "bin": {
+    "rev": "bin/rev.js"
+  },
+  "scripts": {
+    "build": "tsc && node scripts/postbuild.js",
+    "build:watch": "tsc --watch",
+    "dev": "tsx bin/rev.ts",
+    "test": "tsx --test test/*.test.js",
+    "test:ts": "tsx --test test/*.test.ts",
+    "test:watch": "node --test --watch test/*.test.js",
+    "test:coverage": "c8 --reporter=text --reporter=lcov node --test test/*.test.js",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run build"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/gcol33/docrev.git"
+  },
+  "bugs": {
+    "url": "https://github.com/gcol33/docrev/issues"
+  },
+  "homepage": "https://github.com/gcol33/docrev#readme",
+  "keywords": [
+    "markdown",
+    "word",
+    "docx",
+    "track-changes",
+    "comments",
+    "academic",
+    "writing",
+    "pandoc",
+    "criticmarkup"
+  ],
+  "author": "Gilles Colling",
+  "license": "MIT",
+  "dependencies": {
+    "adm-zip": "^0.5.16",
+    "chalk": "^5.3.0",
+    "commander": "^12.0.0",
+    "dictionary-en": "^4.0.0",
+    "dictionary-en-gb": "^3.0.0",
+    "diff": "^8.0.2",
+    "mathml-to-latex": "^1.5.0",
+    "nspell": "^2.1.5",
+    "pdf-lib": "^1.17.1",
+    "pdfjs-dist": "^5.4.530",
+    "tsx": "^4.21.0",
+    "xml2js": "^0.6.2",
+    "yaml": "^2.8.2"
+  },
+  "devDependencies": {
+    "@types/adm-zip": "^0.5.7",
+    "@types/node": "^25.2.0",
+    "@types/xml2js": "^0.4.14",
+    "c8": "^10.1.2",
+    "typescript": "^5.9.3"
+  }
+}

package/skill/REFERENCE.md

@@ -62,6 +62,7 @@ rev build docx               # DOCX only
 rev build --toc              # Include table of contents
 rev build docx --dual        # Clean + annotated versions
 rev build docx --show-changes  # DOCX with visible track changes (audit)
+rev build docx --dual --show-changes  # One DOCX: tracked changes + threaded comments
 rev build docx --pandoc-arg=--lua-filter=tofill.lua   # Pass extra args to pandoc
 rev build -o Final_Report     # Override output filename (extension auto-added)
 rev build pdf --verbose      # Echo the pandoc invocation (useful for filter debugging)
@@ -138,9 +139,19 @@ The `--dual` flag produces:
 - `output/<title>_comments.docx` — includes comment threads as Word comments
 
 The `--show-changes` flag (DOCX only) produces a single audit document
-where every accepted/rejected revision and substitution is exported as a
-visible Word track change, attributed to the configured user. Useful when
-a co-author wants to see what changed since the last shared version.
+(`output/<title>-changes.docx`) where every insertion/deletion/substitution is
+exported as a visible Word track change, attributed to the configured user.
+Useful when a co-author wants to see what changed since the last shared
+version. The revisions are emitted by pandoc as native run-level `w:ins`/`w:del`
+elements through the full filter chain (crossref, citeproc, reference-doc,
+macros) — not post-processed markers.
+
+Combine `--dual --show-changes` to get one `output/<title>-changes.docx` with
+tracked changes AND threaded comments: your `{++..++}`/`{--..--}` edits as
+track changes alongside the reviewer's `{>>..<<}` comments and your threaded
+replies. This is the standard "return to senior author" artifact. Add
+`--reference <docx>` to realign comment anchors against a reviewer's copy
+before injecting.
 
 ### rev preview
 Build and open document in default app.

package/skill/SKILL.md

@@ -84,17 +84,24 @@ rev resolve methods.md -n 1  # Mark comment #1 as resolved
 ### 7. Rebuild with comment threads
 
 ```bash
-rev build docx --dual            # Produces clean + annotated versions
-rev build docx --show-changes    # Single DOCX with visible track changes
+rev build docx --dual                 # Produces clean + annotated versions
+rev build docx --show-changes         # Single DOCX with visible track changes
+rev build docx --dual --show-changes  # One DOCX: tracked changes + threaded comments
 ```
 
 `--dual` produces:
 - `output/<title>.docx` — clean, for submission
 - `output/<title>_comments.docx` — comment threads as Word comments
 
-`--show-changes` produces a single audit DOCX where every accepted/rejected
-revision is rendered as a visible Word track change. Useful when a co-author
-wants to see what changed since the last shared version.
+`--show-changes` produces a single audit DOCX (`<title>-changes.docx`) where
+every accepted/rejected revision is rendered as a visible Word track change.
+Useful when a co-author wants to see what changed since the last shared version.
+
+`--dual --show-changes` combines both into one `<title>-changes.docx`: my
+`{++..++}`/`{--..--}` edits as tracked changes *and* the reviewer's `{>>..<<}`
+comments with my threaded replies. This is the file a supervisor opens,
+reviews next to each other, and hands back. Add `--reference <docx>` to
+realign comment anchors against a reviewer's copy first.
 
 Outputs land in `output/` by default; set `outputDir: null` in `rev.yaml`
 to keep them alongside `paper.md` (legacy layout). The basename is derived

package/types/index.d.ts

@@ -482,16 +482,22 @@ export function isWordDocument(filePath: string): boolean;
 // TrackChanges (lib/trackchanges.js)
 // ============================================
 
-export interface TrackChangeMarker {
-  type: 'insert' | 'delete';
-  start: number;
-  end: number;
-  content: string;
-}
-
-export function prepareForTrackChanges(text: string): { text: string; markers: TrackChangeMarker[] };
-export function applyTrackChangesToDocx(docxPath: string, markers: TrackChangeMarker[], author?: string): Promise<void>;
-export function buildWithTrackChanges(markdownPath: string, outputPath: string, options?: object): Promise<{ success: boolean; message: string }>;
+export interface NativeTrackChangeStats {
+  insertions: number;
+  deletions: number;
+  substitutions: number;
+}
+
+export function criticToNativeTrackChanges(
+  text: string,
+  options?: { author?: string; date?: string }
+): { text: string; stats: NativeTrackChangeStats };
+export function enableTrackRevisions(docxPath: string): void;
+export function buildWithTrackChanges(
+  markdownPath: string,
+  outputPath: string,
+  options?: { author?: string; date?: string }
+): Promise<{ success: boolean; message: string; stats?: NativeTrackChangeStats }>;
 
 // ============================================
 // Spelling (lib/spelling.js)