docrev 0.10.2 → 0.11.1

package/dist/lib/rate-limiter.d.ts

@@ -6,12 +6,20 @@ export interface RateLimiterOptions {
     maxDelay?: number;
     maxRetries?: number;
     backoffFactor?: number;
+    /** Per-request timeout in ms; a stalled connection aborts instead of hanging. */
+    requestTimeout?: number;
 }
+/**
+ * Parse an HTTP `Retry-After` header, which may be a delay in seconds or an
+ * HTTP-date. Returns the delay in milliseconds, or null when unparseable.
+ */
+export declare function parseRetryAfter(value: string | null, now?: number): number | null;
 export declare class RateLimiter {
     private minDelay;
     private maxDelay;
     private maxRetries;
     private backoffFactor;
+    private requestTimeout;
     private lastRequestTime;
     private currentDelay;
     private consecutiveErrors;

package/dist/lib/rate-limiter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rate-limiter.d.ts","sourceRoot":"","sources":["../../lib/rate-limiter.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,eAAe,CAAS;IAChC,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,iBAAiB,CAAS;gBAEtB,OAAO,GAAE,kBAAuB;IAUtC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAS3B,SAAS,IAAI,IAAI;IAMjB,OAAO,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;IAS9B,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,QAAQ,CAAC;CAkChF;AAGD,eAAO,MAAM,eAAe,aAAsD,CAAC;AACnF,eAAO,MAAM,eAAe,aAAsD,CAAC;AACnF,eAAO,MAAM,aAAa,aAAsD,CAAC"}
+{"version":3,"file":"rate-limiter.d.ts","sourceRoot":"","sources":["../../lib/rate-limiter.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iFAAiF;IACjF,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,EAAE,GAAG,GAAE,MAAmB,GAAG,MAAM,GAAG,IAAI,CAO7F;AAED,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,eAAe,CAAS;IAChC,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,iBAAiB,CAAS;gBAEtB,OAAO,GAAE,kBAAuB;IAWtC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAS3B,SAAS,IAAI,IAAI;IAMjB,OAAO,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;IAS9B,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,QAAQ,CAAC;CAkDhF;AAGD,eAAO,MAAM,eAAe,aAAsD,CAAC;AACnF,eAAO,MAAM,eAAe,aAAsD,CAAC;AACnF,eAAO,MAAM,aAAa,aAAsD,CAAC"}

package/dist/lib/rate-limiter.js

@@ -1,11 +1,27 @@
 /**
  * Rate Limiter - Prevents API abuse with exponential backoff
  */
+/**
+ * Parse an HTTP `Retry-After` header, which may be a delay in seconds or an
+ * HTTP-date. Returns the delay in milliseconds, or null when unparseable.
+ */
+export function parseRetryAfter(value, now = Date.now()) {
+    if (!value)
+        return null;
+    const seconds = Number(value);
+    if (Number.isFinite(seconds))
+        return Math.max(0, seconds * 1000);
+    const date = Date.parse(value);
+    if (!Number.isNaN(date))
+        return Math.max(0, date - now);
+    return null;
+}
 export class RateLimiter {
     minDelay;
     maxDelay;
     maxRetries;
     backoffFactor;
+    requestTimeout;
     lastRequestTime;
     currentDelay;
     consecutiveErrors;
@@ -14,6 +30,7 @@ export class RateLimiter {
         this.maxDelay = options.maxDelay || 30000; // Max delay after backoff (ms)
         this.maxRetries = options.maxRetries || 3; // Max retry attempts
         this.backoffFactor = options.backoffFactor || 2;
+        this.requestTimeout = options.requestTimeout || 15000; // Abort a stalled request
         this.lastRequestTime = 0;
         this.currentDelay = this.minDelay;
         this.consecutiveErrors = 0;
@@ -41,14 +58,25 @@ export class RateLimiter {
     }
     async fetchWithRetry(url, options = {}) {
         let lastError;
+        const callerSignal = options.signal ?? undefined;
         for (let attempt = 0; attempt <= this.maxRetries; attempt++) {
             await this.wait();
+            // Bound each attempt so a half-open connection cannot hang the run
+            // forever; merge the caller's signal so an external cancel still works.
+            const controller = new AbortController();
+            const timer = setTimeout(() => controller.abort(new Error('Request timed out')), this.requestTimeout);
+            const onCallerAbort = () => controller.abort(callerSignal.reason);
+            if (callerSignal) {
+                if (callerSignal.aborted)
+                    controller.abort(callerSignal.reason);
+                else
+                    callerSignal.addEventListener('abort', onCallerAbort, { once: true });
+            }
             try {
-                const response = await fetch(url, options);
+                const response = await fetch(url, { ...options, signal: controller.signal });
                 if (response.status === 429) {
-                    // Rate limited - back off
-                    const retryAfter = response.headers.get('Retry-After');
-                    const delay = retryAfter ? parseInt(retryAfter, 10) * 1000 : this.currentDelay * 2;
+                    // Rate limited - back off. Retry-After may be seconds or an HTTP-date.
+                    const delay = parseRetryAfter(response.headers.get('Retry-After')) ?? this.currentDelay * 2;
                     this.currentDelay = Math.min(this.maxDelay, delay);
                     if (!this.onError(429))
                         break;
@@ -64,10 +92,19 @@ export class RateLimiter {
                 return response;
             }
             catch (err) {
+                // A caller-initiated abort is intentional cancellation, not a failure
+                // to retry around.
+                if (callerSignal?.aborted)
+                    throw err;
                 lastError = err;
                 if (!this.onError(0))
                     break;
             }
+            finally {
+                clearTimeout(timer);
+                if (callerSignal)
+                    callerSignal.removeEventListener('abort', onCallerAbort);
+            }
         }
         throw lastError || new Error('Max retries exceeded');
     }

package/dist/lib/rate-limiter.js.map

@@ -1 +1 @@
-{"version":3,"file":"rate-limiter.js","sourceRoot":"","sources":["../../lib/rate-limiter.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"rate-limiter.js","sourceRoot":"","sources":["../../lib/rate-limiter.ts"],"names":[],"mappings":"AAAA;;GAEG;AAWH;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,KAAoB,EAAE,MAAc,IAAI,CAAC,GAAG,EAAE;IAC5E,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IACxB,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAC9B,IAAI,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC;QAAE,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC,CAAC;IACjE,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC/B,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,GAAG,GAAG,CAAC,CAAC;IACxD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,OAAO,WAAW;IACd,QAAQ,CAAS;IACjB,QAAQ,CAAS;IACjB,UAAU,CAAS;IACnB,aAAa,CAAS;IACtB,cAAc,CAAS;IACvB,eAAe,CAAS;IACxB,YAAY,CAAS;IACrB,iBAAiB,CAAS;IAElC,YAAY,UAA8B,EAAE;QAC1C,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,GAAG,CAAC,CAAM,kCAAkC;QAChF,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,KAAK,CAAC,CAAI,+BAA+B;QAC7E,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,CAAC,CAAC,CAAI,qBAAqB;QACnE,IAAI,CAAC,aAAa,GAAG,OAAO,CAAC,aAAa,IAAI,CAAC,CAAC;QAChD,IAAI,CAAC,cAAc,GAAG,OAAO,CAAC,cAAc,IAAI,KAAK,CAAC,CAAC,0BAA0B;QACjF,IAAI,CAAC,eAAe,GAAG,CAAC,CAAC;QACzB,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,QAAQ,CAAC;QAClC,IAAI,CAAC,iBAAiB,GAAG,CAAC,CAAC;IAC7B,CAAC;IAED,KAAK,CAAC,IAAI;QACR,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,MAAM,OAAO,GAAG,GAAG,GAAG,IAAI,CAAC,eAAe,CAAC;QAC3C,IAAI,OAAO,GAAG,IAAI,CAAC,YAAY,EAAE,CAAC;YAChC,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC,CAAC,CAAC;QACrE,CAAC;QACD,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACpC,CAAC;IAED,SAAS;QACP,oCAAoC;QACpC,IAAI,CAAC,iBAAiB,GAAG,CAAC,CAAC;QAC3B,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,aAAa,CAAC,CAAC;IACtF,CAAC;IAED,OAAO,CAAC,UAAkB;QACxB,IAAI,CAAC,iBAAiB,EAAE,CAAC;QACzB,sBAAsB;QACtB,IAAI,UAAU,KAAK,GAAG,IAAI,UAAU,IAAI,GAAG,EAAE,CAAC;YAC5C,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,aAAa,CAAC,CAAC;QACtF,CAAC;QACD,OAAO,IAAI,CAAC,iBAAiB,IAAI,IAAI,CAAC,UAAU,CAAC;IACnD,CAAC;IAED,KAAK,CAAC,cAAc,CAAC,GAAW,EAAE,UAAuB,EAAE;QACzD,IAAI,SAA4B,CAAC;QACjC,MAAM,YAAY,GAAG,OAAO,CAAC,MAAM,IAAI,SAAS,CAAC;QAEjD,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,IAAI,CAAC,UAAU,EAAE,OAAO,EAAE,EAAE,CAAC;YAC5D,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;YAElB,mEAAmE;YACnE,wEAAwE;YACxE,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;YACzC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC,EAAE,IAAI,CAAC,cAAc,CAAC,CAAC;YACtG,MAAM,aAAa,GAAG,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,CAAE,YAA4B,CAAC,MAAM,CAAC,CAAC;YACnF,IAAI,YAAY,EAAE,CAAC;gBACjB,IAAI,YAAY,CAAC,OAAO;oBAAE,UAAU,CAAC,KAAK,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;;oBAC3D,YAAY,CAAC,gBAAgB,CAAC,OAAO,EAAE,aAAa,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;YAC7E,CAAC;YAED,IAAI,CAAC;gBACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,GAAG,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC;gBAE7E,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;oBAC5B,uEAAuE;oBACvE,MAAM,KAAK,GAAG,eAAe,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,IAAI,IAAI,CAAC,YAAY,GAAG,CAAC,CAAC;oBAC5F,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;oBACnD,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC;wBAAE,MAAM;oBAC9B,SAAS;gBACX,CAAC;gBAED,IAAI,QAAQ,CAAC,MAAM,IAAI,GAAG,IAAI,OAAO,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;oBACxD,oCAAoC;oBACpC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;wBAAE,MAAM;oBAC1C,SAAS;gBACX,CAAC;gBAED,IAAI,CAAC,SAAS,EAAE,CAAC;gBACjB,OAAO,QAAQ,CAAC;YAClB,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,sEAAsE;gBACtE,mBAAmB;gBACnB,IAAI,YAAY,EAAE,OAAO;oBAAE,MAAM,GAAG,CAAC;gBACrC,SAAS,GAAG,GAAY,CAAC;gBACzB,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;oBAAE,MAAM;YAC9B,CAAC;oBAAS,CAAC;gBACT,YAAY,CAAC,KAAK,CAAC,CAAC;gBACpB,IAAI,YAAY;oBAAE,YAAY,CAAC,mBAAmB,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;YAC7E,CAAC;QACH,CAAC;QAED,MAAM,SAAS,IAAI,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC;IACvD,CAAC;CACF;AAED,0CAA0C;AAC1C,MAAM,CAAC,MAAM,eAAe,GAAG,IAAI,WAAW,CAAC,EAAE,QAAQ,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC;AACnF,MAAM,CAAC,MAAM,eAAe,GAAG,IAAI,WAAW,CAAC,EAAE,QAAQ,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC;AACnF,MAAM,CAAC,MAAM,aAAa,GAAG,IAAI,WAAW,CAAC,EAAE,QAAQ,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC"}

package/dist/lib/trackchanges.d.ts

@@ -1,51 +1,67 @@
 /**
  * Track changes module - Apply markdown annotations as Word track changes
  *
- * Converts CriticMarkup annotations to Word OOXML track changes format.
+ * Converts CriticMarkup insertions/deletions/substitutions to pandoc-native
+ * track-change spans (`[text]{.insertion}` / `[text]{.deletion}`). Pandoc's
+ * docx writer emits well-formed `w:ins`/`w:del` run-level revisions from these
+ * spans in a single pass, so the output is valid OOXML that Word accepts and
+ * that composes with comment injection (see lib/wordcomments.ts).
  */
-import type { TrackChangeMarker } from './types.js';
-interface PrepareOptions {
+interface NativeTrackChangeOptions {
     author?: string;
+    /** ISO-8601 timestamp for the revisions. Defaults to now (no milliseconds). */
+    date?: string;
 }
-interface PrepareResult {
+export interface NativeTrackChangeStats {
+    insertions: number;
+    deletions: number;
+    substitutions: number;
+}
+interface ConvertResult {
     text: string;
-    markers: TrackChangeMarker[];
+    stats: NativeTrackChangeStats;
 }
 interface ApplyResult {
     success: boolean;
     message: string;
-    stats?: {
-        insertions: number;
-        deletions: number;
-        substitutions: number;
-    };
+    stats?: NativeTrackChangeStats;
 }
 /**
- * Prepare text with CriticMarkup annotations for track changes
- * Replaces annotations with markers that can be processed in DOCX
+ * Convert CriticMarkup insertions/deletions/substitutions to pandoc-native
+ * track-change spans. Comments (`{>>...<<}`) and highlights (`{==...==}`) are
+ * left untouched — the caller decides how to handle those (strip, or thread
+ * them via wordcomments.ts).
+ *
+ * A single pandoc pass over the result emits valid `w:ins`/`w:del` revisions,
+ * so this composes with the full rev filter chain (crossref, citeproc,
+ * reference-doc, macros) instead of post-processing document.xml by hand.
  *
- * @param text - Text with CriticMarkup annotations
- * @param options - Options
- * @returns Processed text and marker info
+ * @param text - Markdown with CriticMarkup annotations
+ * @param options - Author/date for the revisions
+ * @returns Converted markdown plus per-type counts
  */
-export declare function prepareForTrackChanges(text: string, options?: PrepareOptions): PrepareResult;
+export declare function criticToNativeTrackChanges(text: string, options?: NativeTrackChangeOptions): ConvertResult;
 /**
- * Apply track changes markers to a Word document
+ * Enable tracked-revision display in a docx's settings.xml (in place).
  *
- * @param docxPath - Path to input DOCX file
- * @param markers - Markers from prepareForTrackChanges
- * @param outputPath - Path for output DOCX file
- * @returns Result with success status and message
+ * The `w:ins`/`w:del` elements already render as tracked changes without this,
+ * but `w:trackRevisions` tells Word to keep tracking the author's further
+ * edits — the expected state for a "return to author" review document.
  */
-export declare function applyTrackChangesToDocx(docxPath: string, markers: TrackChangeMarker[], outputPath: string): Promise<ApplyResult>;
+export declare function enableTrackRevisions(docxPath: string): void;
 /**
- * Build a Word document with track changes from annotated markdown
+ * Build a standalone Word document with track changes from annotated markdown.
+ *
+ * Used by `rev apply <md> <docx>` for a single markdown file outside a rev
+ * project (no crossref/citeproc/reference-doc). Comments are dropped — use the
+ * project build (`rev build docx --show-changes`) for the full filter chain and
+ * threaded comments.
  *
  * @param mdPath - Path to markdown file with CriticMarkup
  * @param docxPath - Output path for Word document
- * @param options - Options
+ * @param options - Author name for the revisions
  * @returns Result with success status and message
  */
-export declare function buildWithTrackChanges(mdPath: string, docxPath: string, options?: PrepareOptions): Promise<ApplyResult>;
+export declare function buildWithTrackChanges(mdPath: string, docxPath: string, options?: NativeTrackChangeOptions): Promise<ApplyResult>;
 export {};
 //# sourceMappingURL=trackchanges.d.ts.map

package/dist/lib/trackchanges.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"trackchanges.d.ts","sourceRoot":"","sources":["../../lib/trackchanges.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAGpD,UAAU,cAAc;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,UAAU,aAAa;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,iBAAiB,EAAE,CAAC;CAC9B;AAED,UAAU,WAAW;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE;QACN,UAAU,EAAE,MAAM,CAAC;QACnB,SAAS,EAAE,MAAM,CAAC;QAClB,aAAa,EAAE,MAAM,CAAC;KACvB,CAAC;CACH;AAED;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,cAAmB,GAAG,aAAa,CAiEhG;AAED;;;;;;;GAOG;AACH,wBAAsB,uBAAuB,CAC3C,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,iBAAiB,EAAE,EAC5B,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,WAAW,CAAC,CAgEtB;AAED;;;;;;;GAOG;AACH,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,WAAW,CAAC,CAiDtB"}
+{"version":3,"file":"trackchanges.d.ts","sourceRoot":"","sources":["../../lib/trackchanges.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAOH,UAAU,wBAAwB;IAChC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,+EAA+E;IAC/E,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,sBAAsB;IACrC,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,UAAU,aAAa;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,sBAAsB,CAAC;CAC/B;AAED,UAAU,WAAW;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,sBAAsB,CAAC;CAChC;AAgBD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,0BAA0B,CACxC,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,wBAA6B,GACrC,aAAa,CA8Bf;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAe3D;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,wBAA6B,GACrC,OAAO,CAAC,WAAW,CAAC,CAuBtB"}

package/dist/lib/trackchanges.js

@@ -1,192 +1,131 @@
 /**
  * Track changes module - Apply markdown annotations as Word track changes
  *
- * Converts CriticMarkup annotations to Word OOXML track changes format.
+ * Converts CriticMarkup insertions/deletions/substitutions to pandoc-native
+ * track-change spans (`[text]{.insertion}` / `[text]{.deletion}`). Pandoc's
+ * docx writer emits well-formed `w:ins`/`w:del` run-level revisions from these
+ * spans in a single pass, so the output is valid OOXML that Word accepts and
+ * that composes with comment injection (see lib/wordcomments.ts).
  */
 import * as fs from 'fs';
 import * as path from 'path';
 import { execSync } from 'child_process';
 import AdmZip from 'adm-zip';
-import { escapeXml } from './utils.js';
+/** Word/pandoc want revision dates without milliseconds: 2026-07-05T08:33:00Z */
+function isoDateNoMillis() {
+    return new Date().toISOString().replace(/\.\d{3}Z$/, 'Z');
+}
+/**
+ * Escape a value for use inside a pandoc span attribute (`author="..."`).
+ * Pandoc attribute values are double-quoted; a literal `"` or `\` would break
+ * the attribute, so both are backslash-escaped.
+ */
+function escapeSpanAttr(value) {
+    return value.replace(/\\/g, '\\\\').replace(/"/g, '\\"');
+}
 /**
- * Prepare text with CriticMarkup annotations for track changes
- * Replaces annotations with markers that can be processed in DOCX
+ * Convert CriticMarkup insertions/deletions/substitutions to pandoc-native
+ * track-change spans. Comments (`{>>...<<}`) and highlights (`{==...==}`) are
+ * left untouched — the caller decides how to handle those (strip, or thread
+ * them via wordcomments.ts).
  *
- * @param text - Text with CriticMarkup annotations
- * @param options - Options
- * @returns Processed text and marker info
+ * A single pandoc pass over the result emits valid `w:ins`/`w:del` revisions,
+ * so this composes with the full rev filter chain (crossref, citeproc,
+ * reference-doc, macros) instead of post-processing document.xml by hand.
+ *
+ * @param text - Markdown with CriticMarkup annotations
+ * @param options - Author/date for the revisions
+ * @returns Converted markdown plus per-type counts
  */
-export function prepareForTrackChanges(text, options = {}) {
-    const { author = 'Reviewer' } = options;
-    const markers = [];
-    let markerId = 0;
+export function criticToNativeTrackChanges(text, options = {}) {
+    const author = escapeSpanAttr(options.author ?? 'Author');
+    const date = escapeSpanAttr(options.date ?? isoDateNoMillis());
+    const insAttr = `{.insertion author="${author}" date="${date}"}`;
+    const delAttr = `{.deletion author="${author}" date="${date}"}`;
+    const stats = { insertions: 0, deletions: 0, substitutions: 0 };
     let result = text;
-    // Process insertions: {++text++}
-    result = result.replace(/\{\+\+(.+?)\+\+\}/gs, (match, content) => {
-        const id = markerId++;
-        markers.push({
-            id,
-            type: 'insert',
-            content,
-            author,
-        });
-        return `{{TC_${id}}}`;
-    });
-    // Process deletions: {--text--}
-    result = result.replace(/\{--(.+?)--\}/gs, (match, content) => {
-        const id = markerId++;
-        markers.push({
-            id,
-            type: 'delete',
-            content,
-            author,
-        });
-        return `{{TC_${id}}}`;
+    // Substitutions first so `{~~old~>new~~}` is consumed before the insertion/
+    // deletion passes could see its inner delimiters. Emit delete-then-insert so
+    // Word shows the struck-through original followed by the replacement.
+    result = result.replace(/\{~~([\s\S]+?)~>([\s\S]+?)~~\}/g, (_m, oldText, newText) => {
+        stats.substitutions++;
+        return `[${oldText}]${delAttr}[${newText}]${insAttr}`;
     });
-    // Process substitutions: {~~old~>new~~}
-    result = result.replace(/\{~~(.+?)~>(.+?)~~\}/gs, (match, old, replacement) => {
-        const id = markerId++;
-        markers.push({
-            id,
-            type: 'substitute',
-            content: old,
-            replacement,
-            author,
-        });
-        return `{{TC_${id}}}`;
+    // Insertions: {++text++}
+    result = result.replace(/\{\+\+([\s\S]+?)\+\+\}/g, (_m, content) => {
+        stats.insertions++;
+        return `[${content}]${insAttr}`;
     });
-    // Process comments: {>>Author: comment<<}
-    result = result.replace(/\{>>(.+?)<<\}/gs, (match, content) => {
-        const id = markerId++;
-        // Extract author if present (format: "Author: comment")
-        const colonIdx = content.indexOf(':');
-        let commentAuthor = author;
-        let commentText = content;
-        if (colonIdx > 0 && colonIdx < 30) {
-            commentAuthor = content.slice(0, colonIdx).trim();
-            commentText = content.slice(colonIdx + 1).trim();
-        }
-        markers.push({
-            id,
-            type: 'comment',
-            content: commentText,
-            author: commentAuthor,
-        });
-        return `{{TC_${id}}}`;
+    // Deletions: {--text--}
+    result = result.replace(/\{--([\s\S]+?)--\}/g, (_m, content) => {
+        stats.deletions++;
+        return `[${content}]${delAttr}`;
     });
-    return { text: result, markers };
+    return { text: result, stats };
 }
 /**
- * Apply track changes markers to a Word document
+ * Enable tracked-revision display in a docx's settings.xml (in place).
  *
- * @param docxPath - Path to input DOCX file
- * @param markers - Markers from prepareForTrackChanges
- * @param outputPath - Path for output DOCX file
- * @returns Result with success status and message
+ * The `w:ins`/`w:del` elements already render as tracked changes without this,
+ * but `w:trackRevisions` tells Word to keep tracking the author's further
+ * edits — the expected state for a "return to author" review document.
  */
-export async function applyTrackChangesToDocx(docxPath, markers, outputPath) {
-    if (!fs.existsSync(docxPath)) {
-        return { success: false, message: `File not found: ${docxPath}` };
-    }
-    let zip;
-    try {
-        zip = new AdmZip(docxPath);
-    }
-    catch (err) {
-        const error = err;
-        return { success: false, message: `Invalid DOCX file: ${error.message}` };
-    }
-    // Read document.xml
-    const docEntry = zip.getEntry('word/document.xml');
-    if (!docEntry) {
-        return { success: false, message: 'Invalid DOCX: no document.xml' };
-    }
-    let documentXml = zip.readAsText(docEntry);
-    // Generate ISO date for track changes
-    const now = new Date().toISOString();
-    // Replace markers with track change XML
-    for (const marker of markers) {
-        const placeholder = `{{TC_${marker.id}}}`;
-        let replacement = '';
-        const escapedContent = escapeXml(marker.content);
-        const escapedAuthor = escapeXml(marker.author);
-        if (marker.type === 'insert') {
-            replacement = `<w:ins w:id="${marker.id}" w:author="${escapedAuthor}" w:date="${now}"><w:r><w:t>${escapedContent}</w:t></w:r></w:ins>`;
-        }
-        else if (marker.type === 'delete') {
-            replacement = `<w:del w:id="${marker.id}" w:author="${escapedAuthor}" w:date="${now}"><w:r><w:delText>${escapedContent}</w:delText></w:r></w:del>`;
-        }
-        else if (marker.type === 'substitute') {
-            const escapedReplacement = escapeXml(marker.replacement || '');
-            replacement = `<w:del w:id="${marker.id}" w:author="${escapedAuthor}" w:date="${now}"><w:r><w:delText>${escapedContent}</w:delText></w:r></w:del><w:ins w:id="${marker.id + 1000}" w:author="${escapedAuthor}" w:date="${now}"><w:r><w:t>${escapedReplacement}</w:t></w:r></w:ins>`;
-        }
-        documentXml = documentXml.replace(placeholder, replacement);
-    }
-    // Update document.xml
-    zip.updateFile('word/document.xml', Buffer.from(documentXml));
-    // Enable track revisions in settings.xml
+export function enableTrackRevisions(docxPath) {
+    const zip = new AdmZip(docxPath);
     const settingsEntry = zip.getEntry('word/settings.xml');
-    if (settingsEntry) {
-        let settingsXml = zip.readAsText(settingsEntry);
-        if (!settingsXml.includes('w:trackRevisions')) {
-            settingsXml = settingsXml.replace('</w:settings>', '<w:trackRevisions/></w:settings>');
-            zip.updateFile('word/settings.xml', Buffer.from(settingsXml));
-        }
+    if (!settingsEntry)
+        return;
+    let settingsXml = zip.readAsText(settingsEntry);
+    if (settingsXml.includes('w:trackRevisions'))
+        return;
+    // trackRevisions must appear early in the ordered settings sequence; placing
+    // it right after the opening tag keeps Word from rejecting the schema order.
+    settingsXml = settingsXml.replace(/(<w:settings[^>]*>)/, '$1<w:trackRevisions/>');
+    if (!settingsXml.includes('<w:trackRevisions/>')) {
+        // No opening tag matched (unexpected) — fall back to before the close tag.
+        settingsXml = settingsXml.replace('</w:settings>', '<w:trackRevisions/></w:settings>');
     }
-    // Write output
-    zip.writeZip(outputPath);
-    return { success: true, message: `Created ${outputPath} with track changes` };
+    zip.updateFile('word/settings.xml', Buffer.from(settingsXml, 'utf-8'));
+    zip.writeZip(docxPath);
 }
 /**
- * Build a Word document with track changes from annotated markdown
+ * Build a standalone Word document with track changes from annotated markdown.
+ *
+ * Used by `rev apply <md> <docx>` for a single markdown file outside a rev
+ * project (no crossref/citeproc/reference-doc). Comments are dropped — use the
+ * project build (`rev build docx --show-changes`) for the full filter chain and
+ * threaded comments.
  *
  * @param mdPath - Path to markdown file with CriticMarkup
  * @param docxPath - Output path for Word document
- * @param options - Options
+ * @param options - Author name for the revisions
  * @returns Result with success status and message
  */
 export async function buildWithTrackChanges(mdPath, docxPath, options = {}) {
-    const { author = 'Author' } = options;
     if (!fs.existsSync(mdPath)) {
         return { success: false, message: `File not found: ${mdPath}` };
     }
+    const { author = 'Author' } = options;
     const content = fs.readFileSync(mdPath, 'utf-8');
-    // Prepare for track changes
-    const { text: prepared, markers } = prepareForTrackChanges(content, { author });
-    // If no annotations, just build normally
-    if (markers.length === 0) {
-        try {
-            execSync(`pandoc "${mdPath}" -o "${docxPath}"`, { encoding: 'utf-8' });
-            return { success: true, message: `Created ${docxPath}` };
-        }
-        catch (err) {
-            const error = err;
-            return { success: false, message: error.message };
-        }
-    }
-    // Write prepared content to temp file
-    const tempDir = path.dirname(mdPath);
-    const tempMd = path.join(tempDir, `.temp-${Date.now()}.md`);
-    const tempDocx = path.join(tempDir, `.temp-${Date.now()}.docx`);
+    const { text: converted, stats } = criticToNativeTrackChanges(content, { author });
+    const total = stats.insertions + stats.deletions + stats.substitutions;
+    const tempMd = path.join(path.dirname(mdPath), `.temp-tc-${process.pid}.md`);
     try {
-        fs.writeFileSync(tempMd, prepared, 'utf-8');
-        // Build with pandoc
-        execSync(`pandoc "${tempMd}" -o "${tempDocx}"`, { encoding: 'utf-8' });
-        // Apply track changes
-        const result = await applyTrackChangesToDocx(tempDocx, markers, docxPath);
-        // Clean up temp files
-        fs.unlinkSync(tempMd);
-        fs.unlinkSync(tempDocx);
-        return result;
+        fs.writeFileSync(tempMd, converted, 'utf-8');
+        execSync(`pandoc "${tempMd}" -o "${docxPath}"`, { encoding: 'utf-8' });
+        if (total > 0)
+            enableTrackRevisions(docxPath);
+        return { success: true, message: `Created ${docxPath} with track changes`, stats };
     }
     catch (err) {
-        // Clean up on error
-        if (fs.existsSync(tempMd))
-            fs.unlinkSync(tempMd);
-        if (fs.existsSync(tempDocx))
-            fs.unlinkSync(tempDocx);
         const error = err;
         return { success: false, message: error.message };
     }
+    finally {
+        try {
+            fs.unlinkSync(tempMd);
+        }
+        catch { /* best-effort cleanup */ }
+    }
 }
 //# sourceMappingURL=trackchanges.js.map

package/dist/lib/trackchanges.js.map

@@ -1 +1 @@
-{"version":3,"file":"trackchanges.js","sourceRoot":"","sources":["../../lib/trackchanges.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"trackchanges.js","sourceRoot":"","sources":["../../lib/trackchanges.ts"],"names":[],"mappings":"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"}

package/dist/lib/types.d.ts

@@ -188,7 +188,13 @@ export interface BibEntry {
 }
 export interface DoiCheckResult {
     valid: boolean;
-    source?: 'crossref' | 'datacite';
+    source?: 'crossref' | 'datacite' | 'doi.org';
+    /**
+     * True when the registry could not be reached (network error, timeout, or
+     * 5xx) — the DOI's validity is unknown, distinct from a definitive "not
+     * found". Callers must not report an unreachable DOI as invalid.
+     */
+    unreachable?: boolean;
     metadata?: {
         title: string;
         authors: string[];
@@ -229,6 +235,8 @@ export interface BibCheckResult {
     }>;
     valid: number;
     invalid: number;
+    /** DOIs whose registry could not be reached (network/timeout) — not invalid. */
+    unreachable: number;
     missing: number;
     skipped: number;
 }
@@ -444,13 +452,6 @@ export interface TrackChangesResult {
         deletions: number;
     };
 }
-export interface TrackChangeMarker {
-    id: number;
-    type: 'insert' | 'delete' | 'substitute' | 'comment';
-    content: string;
-    author: string;
-    replacement?: string;
-}
 export interface SpellingIssue {
     word: string;
     line: number;