docrev 0.9.18 → 0.10.1

package/completions/rev.zsh

@@ -1,207 +1,207 @@
-#compdef rev
-
-# Zsh completion for rev (docrev)
-# Install: add to fpath or run:
-#   eval "$(rev completions zsh)"
-
-_rev() {
-    local -a commands build_formats doi_actions eq_actions help_topics journals preview_formats
-
-    commands=(
-        'build:Build PDF/DOCX/TEX from sections'
-        'new:Create new project from template'
-        'import:Import Word document'
-        'sections:Import to section files'
-        'extract:Extract text from Word'
-        'review:Interactive review TUI'
-        'status:Show annotation counts'
-        'comments:List comments'
-        'resolve:Mark comment as resolved'
-        'reply:Reply to comments'
-        'strip:Output clean markdown'
-        'refs:Show reference status'
-        'migrate:Convert hardcoded refs'
-        'config:Configure settings'
-        'install:Check dependencies'
-        'doi:DOI validation'
-        'citations:Validate citations'
-        'equations:Extract equations'
-        'figures:List figures'
-        'response:Generate response letter'
-        'anonymize:Prepare for blind review'
-        'validate:Check journal requirements'
-        'merge:Merge reviewer feedback'
-        'diff:Compare against git history'
-        'history:Show revision history'
-        'help:Show help'
-        'init:Initialize project'
-        'split:Split paper.md to sections'
-        'word-count:Show word counts per section'
-        'wc:Show word counts (alias)'
-        'stats:Show project statistics'
-        'search:Search across files'
-        'backup:Create timestamped backup'
-        'export:Export project as zip'
-        'preview:Build and open document'
-        'watch:Watch and auto-rebuild'
-        'lint:Check for issues'
-        'grammar:Check grammar and style'
-        'annotate:Add comments to DOCX'
-        'apply:Apply annotations as track changes'
-        'comment:Interactive comment mode'
-        'completions:Generate shell completions'
-    )
-
-    preview_formats=(
-        'pdf:Preview PDF'
-        'docx:Preview Word document'
-    )
-
-    build_formats=(
-        'pdf:Build PDF'
-        'docx:Build Word document'
-        'tex:Build LaTeX'
-        'all:Build all formats'
-    )
-
-    doi_actions=(
-        'check:Validate DOIs'
-        'lookup:Find missing DOIs'
-        'fetch:Get BibTeX from DOI'
-        'add:Add citation by DOI'
-    )
-
-    eq_actions=(
-        'list:List equations'
-        'extract:Extract to file'
-        'convert:Convert to Word'
-        'from-word:Extract from Word'
-    )
-
-    help_topics=(
-        'workflow:Review workflow'
-        'syntax:CriticMarkup syntax'
-        'commands:All commands'
-    )
-
-    journals=(
-        'nature:Nature journal'
-        'science:Science journal'
-        'plos:PLOS ONE'
-        'cell:Cell journal'
-        'ecology:Ecology journals'
-        'custom:Custom profile'
-    )
-
-    case "$words[2]" in
-        build)
-            _describe -t formats 'format' build_formats
-            _arguments \
-                '--toc[Include table of contents]' \
-                '--show-changes[Show track changes in DOCX]' \
-                '--clean[Clean build files]'
-            ;;
-        new)
-            _arguments \
-                '--list[List templates]' \
-                '--template[Template name]:template:(paper minimal thesis proposal)'
-            ;;
-        doi)
-            _describe -t actions 'action' doi_actions
-            ;;
-        equations|eq)
-            _describe -t actions 'action' eq_actions
-            ;;
-        validate)
-            _arguments \
-                '--list[List journals]' \
-                '--journal[Journal name]:journal:($journals)'
-            ;;
-        help)
-            _describe -t topics 'topic' help_topics
-            ;;
-        config)
-            _values 'setting' 'user[Set user name]'
-            ;;
-        word-count|wc)
-            _arguments \
-                '--limit[Word limit]:number:' \
-                '--journal[Use journal word limit]:journal:'
-            ;;
-        preview)
-            _describe -t formats 'format' preview_formats
-            ;;
-        watch)
-            _arguments \
-                '--no-open[Do not open after build]'
-            _values 'format' 'pdf' 'docx' 'all'
-            ;;
-        lint)
-            _arguments \
-                '--fix[Auto-fix issues]'
-            ;;
-        grammar)
-            _arguments \
-                '--learn[Add word to dictionary]:word:' \
-                '--forget[Remove from dictionary]:word:' \
-                '--list[List dictionary words]' \
-                '--rules[List grammar rules]' \
-                '--no-scientific[Disable science rules]' \
-                '--severity[Minimum severity]:level:(error warning info)'
-            _files -g '*.md'
-            ;;
-        annotate)
-            _arguments \
-                '-m[Comment message]:text:' \
-                '-s[Search text]:text:' \
-                '-a[Author name]:name:'
-            _files -g '*.docx'
-            ;;
-        apply)
-            _arguments \
-                '-a[Author name]:name:'
-            _files -g '*.md'
-            ;;
-        comment)
-            _arguments \
-                '-a[Author name]:name:'
-            _files -g '*.docx'
-            ;;
-        completions)
-            _values 'shell' 'bash' 'zsh'
-            ;;
-        import|sections|extract|review|status|comments|strip|refs|migrate|figures|response|anonymize|split|search|stats)
-            _files -g '*.md' -g '*.docx'
-            ;;
-        resolve|reply)
-            _arguments \
-                '-n[Comment number]:number:' \
-                '-m[Reply message]:message:'
-            _files -g '*.md'
-            ;;
-        check|lookup|add|citations)
-            _files -g '*.bib'
-            ;;
-        merge)
-            _files -g '*.md' -g '*.docx'
-            ;;
-        backup)
-            _arguments \
-                '--name[Custom backup name]:name:' \
-                '--output[Output directory]:dir:_files -/'
-            ;;
-        export)
-            _arguments \
-                '--output[Output filename]:file:' \
-                '--include-output[Include built files]'
-            ;;
-        *)
-            _describe -t commands 'command' commands
-            _arguments \
-                '--help[Show help]' \
-                '--version[Show version]'
-            ;;
-    esac
-}
-
-_rev "$@"
+#compdef rev
+
+# Zsh completion for rev (docrev)
+# Install: add to fpath or run:
+#   eval "$(rev completions zsh)"
+
+_rev() {
+    local -a commands build_formats doi_actions eq_actions help_topics journals preview_formats
+
+    commands=(
+        'build:Build PDF/DOCX/TEX from sections'
+        'new:Create new project from template'
+        'import:Import Word document'
+        'sections:Import to section files'
+        'extract:Extract text from Word'
+        'review:Interactive review TUI'
+        'status:Show annotation counts'
+        'comments:List comments'
+        'resolve:Mark comment as resolved'
+        'reply:Reply to comments'
+        'strip:Output clean markdown'
+        'refs:Show reference status'
+        'migrate:Convert hardcoded refs'
+        'config:Configure settings'
+        'install:Check dependencies'
+        'doi:DOI validation'
+        'citations:Validate citations'
+        'equations:Extract equations'
+        'figures:List figures'
+        'response:Generate response letter'
+        'anonymize:Prepare for blind review'
+        'validate:Check journal requirements'
+        'merge:Merge reviewer feedback'
+        'diff:Compare against git history'
+        'history:Show revision history'
+        'help:Show help'
+        'init:Initialize project'
+        'split:Split paper.md to sections'
+        'word-count:Show word counts per section'
+        'wc:Show word counts (alias)'
+        'stats:Show project statistics'
+        'search:Search across files'
+        'backup:Create timestamped backup'
+        'export:Export project as zip'
+        'preview:Build and open document'
+        'watch:Watch and auto-rebuild'
+        'lint:Check for issues'
+        'grammar:Check grammar and style'
+        'annotate:Add comments to DOCX'
+        'apply:Apply annotations as track changes'
+        'comment:Interactive comment mode'
+        'completions:Generate shell completions'
+    )
+
+    preview_formats=(
+        'pdf:Preview PDF'
+        'docx:Preview Word document'
+    )
+
+    build_formats=(
+        'pdf:Build PDF'
+        'docx:Build Word document'
+        'tex:Build LaTeX'
+        'all:Build all formats'
+    )
+
+    doi_actions=(
+        'check:Validate DOIs'
+        'lookup:Find missing DOIs'
+        'fetch:Get BibTeX from DOI'
+        'add:Add citation by DOI'
+    )
+
+    eq_actions=(
+        'list:List equations'
+        'extract:Extract to file'
+        'convert:Convert to Word'
+        'from-word:Extract from Word'
+    )
+
+    help_topics=(
+        'workflow:Review workflow'
+        'syntax:CriticMarkup syntax'
+        'commands:All commands'
+    )
+
+    journals=(
+        'nature:Nature journal'
+        'science:Science journal'
+        'plos:PLOS ONE'
+        'cell:Cell journal'
+        'ecology:Ecology journals'
+        'custom:Custom profile'
+    )
+
+    case "$words[2]" in
+        build)
+            _describe -t formats 'format' build_formats
+            _arguments \
+                '--toc[Include table of contents]' \
+                '--show-changes[Show track changes in DOCX]' \
+                '--clean[Clean build files]'
+            ;;
+        new)
+            _arguments \
+                '--list[List templates]' \
+                '--template[Template name]:template:(paper minimal thesis proposal)'
+            ;;
+        doi)
+            _describe -t actions 'action' doi_actions
+            ;;
+        equations|eq)
+            _describe -t actions 'action' eq_actions
+            ;;
+        validate)
+            _arguments \
+                '--list[List journals]' \
+                '--journal[Journal name]:journal:($journals)'
+            ;;
+        help)
+            _describe -t topics 'topic' help_topics
+            ;;
+        config)
+            _values 'setting' 'user[Set user name]'
+            ;;
+        word-count|wc)
+            _arguments \
+                '--limit[Word limit]:number:' \
+                '--journal[Use journal word limit]:journal:'
+            ;;
+        preview)
+            _describe -t formats 'format' preview_formats
+            ;;
+        watch)
+            _arguments \
+                '--no-open[Do not open after build]'
+            _values 'format' 'pdf' 'docx' 'all'
+            ;;
+        lint)
+            _arguments \
+                '--fix[Auto-fix issues]'
+            ;;
+        grammar)
+            _arguments \
+                '--learn[Add word to dictionary]:word:' \
+                '--forget[Remove from dictionary]:word:' \
+                '--list[List dictionary words]' \
+                '--rules[List grammar rules]' \
+                '--no-scientific[Disable science rules]' \
+                '--severity[Minimum severity]:level:(error warning info)'
+            _files -g '*.md'
+            ;;
+        annotate)
+            _arguments \
+                '-m[Comment message]:text:' \
+                '-s[Search text]:text:' \
+                '-a[Author name]:name:'
+            _files -g '*.docx'
+            ;;
+        apply)
+            _arguments \
+                '-a[Author name]:name:'
+            _files -g '*.md'
+            ;;
+        comment)
+            _arguments \
+                '-a[Author name]:name:'
+            _files -g '*.docx'
+            ;;
+        completions)
+            _values 'shell' 'bash' 'zsh'
+            ;;
+        import|sections|extract|review|status|comments|strip|refs|migrate|figures|response|anonymize|split|search|stats)
+            _files -g '*.md' -g '*.docx'
+            ;;
+        resolve|reply)
+            _arguments \
+                '-n[Comment number]:number:' \
+                '-m[Reply message]:message:'
+            _files -g '*.md'
+            ;;
+        check|lookup|add|citations)
+            _files -g '*.bib'
+            ;;
+        merge)
+            _files -g '*.md' -g '*.docx'
+            ;;
+        backup)
+            _arguments \
+                '--name[Custom backup name]:name:' \
+                '--output[Output directory]:dir:_files -/'
+            ;;
+        export)
+            _arguments \
+                '--output[Output filename]:file:' \
+                '--include-output[Include built files]'
+            ;;
+        *)
+            _describe -t commands 'command' commands
+            _arguments \
+                '--help[Show help]' \
+                '--version[Show version]'
+            ;;
+    esac
+}
+
+_rev "$@"

package/dist/lib/build.d.ts

@@ -8,6 +8,7 @@
  * - Runs pandoc with crossref filter
  */
 import type { Author, JournalFormatting } from './types.js';
+import { type MacroDef } from './macros.js';
 export interface CrossrefConfig {
     figureTitle?: string;
     tableTitle?: string;
@@ -111,6 +112,13 @@ export interface BuildConfig {
     pptx: PptxConfig;
     tables: TablesConfig;
     postprocess: PostprocessConfig;
+    /**
+     * User-declared placeholder macros. Merged with the built-in macros
+     * (currently \tofill). Each entry overrides a built-in by name.
+     *
+     * See lib/macros.ts for the per-format rendering rules.
+     */
+    macros?: MacroDef[];
     /**
      * Directory (relative to the project) where final outputs land. Created on
      * demand. Set to null/empty to keep outputs alongside paper.md (legacy

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

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

package/dist/lib/build.js

@@ -9,6 +9,7 @@
  */
 import * as fs from 'fs';
 import * as path from 'path';
+import { fileURLToPath } from 'url';
 import { spawn } from 'child_process';
 import YAML from 'yaml';
 import { stripAnnotations } from './annotations.js';
@@ -22,6 +23,7 @@ import { hasPandoc, hasPandocCrossref, hasLatex } from './dependencies.js';
 import { buildImageRegistry, writeImageRegistry } from './image-registry.js';
 import { getJournalProfile } from './journals.js';
 import { resolveCSL } from './csl.js';
+import { mergeMacros, generateLatexPreamble, writeMacrosSidecar, getMacroFilterPath, } from './macros.js';
 // =============================================================================
 // Constants
 // =============================================================================
@@ -100,6 +102,9 @@ export const DEFAULT_CONFIG = {
         beamer: null,
         all: null, // Runs after any format
     },
+    // Placeholder/highlight macros. Defaults are the built-ins from
+    // lib/macros.ts; users append their own here.
+    macros: [],
     // Final outputs land here (created on demand). Set to null or '' to keep
     // outputs in the project root.
     outputDir: 'output',
@@ -963,10 +968,10 @@ export function buildPandocArgs(format, config, outputPath) {
         }
         // Fit images within slide bounds (default: true)
         if (beamer.fit_images !== false) {
-            const fitImagesHeader = `\\makeatletter
-\\def\\maxwidth{\\ifdim\\Gin@nat@width>\\linewidth\\linewidth\\else\\Gin@nat@width\\fi}
-\\def\\maxheight{\\ifdim\\Gin@nat@height>0.75\\textheight 0.75\\textheight\\else\\Gin@nat@height\\fi}
-\\makeatother
+            const fitImagesHeader = `\\makeatletter
+\\def\\maxwidth{\\ifdim\\Gin@nat@width>\\linewidth\\linewidth\\else\\Gin@nat@width\\fi}
+\\def\\maxheight{\\ifdim\\Gin@nat@height>0.75\\textheight 0.75\\textheight\\else\\Gin@nat@height\\fi}
+\\makeatother
 \\setkeys{Gin}{width=\\maxwidth,height=\\maxheight,keepaspectratio}`;
             args.push('-V', `header-includes=${fitImagesHeader}`);
         }
@@ -1164,12 +1169,46 @@ export async function runPandoc(inputPath, format, config, options = {}) {
         if (referenceDoc) {
             args.push('--reference-doc', referenceDoc);
         }
-        // Add color filter for PPTX (handles [text]{color=#RRGGBB} syntax)
-        const colorFilterPath = path.join(path.dirname(new URL(import.meta.url).pathname.replace(/^\/([A-Z]:)/, '$1')), 'pptx-color-filter.lua');
+        // Add color filter for PPTX (handles [text]{color=#RRGGBB} syntax).
+        // fileURLToPath handles Windows paths with spaces — the old
+        // `new URL(...).pathname` returned URL-encoded `%20` and fs.existsSync
+        // silently failed.
+        const colorFilterPath = path.join(path.dirname(fileURLToPath(import.meta.url)), 'pptx-color-filter.lua');
         if (fs.existsSync(colorFilterPath)) {
             args.push('--lua-filter', colorFilterPath);
         }
     }
+    // Wire placeholder macros (built-in \tofill plus user-declared entries).
+    // - docx/html: lua filter expands \name{X} to format-specific raw runs.
+    // - pdf/tex/beamer: inject a \providecommand preamble so LaTeX renders it
+    //   directly. `\providecommand` is non-clobbering, so a user who already
+    //   has `\providecommand{\tofill}{...}` in their own header keeps theirs.
+    //
+    // Sidecar path is passed to the lua filter via DOCREV_MACROS_FILE in the
+    // child env (not pandoc metadata) because pandoc walks RawInline/RawBlock
+    // BEFORE Meta — by the time a Meta handler could read the path, the inline
+    // expansion has already happened.
+    const macroTempFiles = [];
+    let macroEnvFile = null;
+    const macros = mergeMacros(config.macros);
+    if (macros.length > 0) {
+        if (format === 'docx' || format === 'html' || format === 'html5' || format === 'html4') {
+            const sidecarPath = writeMacrosSidecar(directory, macros);
+            macroTempFiles.push(sidecarPath);
+            macroEnvFile = sidecarPath;
+            const filterPath = getMacroFilterPath();
+            if (fs.existsSync(filterPath)) {
+                args.push('--lua-filter', filterPath);
+            }
+        }
+        else if (format === 'pdf' || format === 'tex' || format === 'beamer') {
+            const preamble = generateLatexPreamble(macros);
+            const preamblePath = path.join(directory, '.macros.tex');
+            fs.writeFileSync(preamblePath, preamble, 'utf-8');
+            macroTempFiles.push(preamblePath);
+            args.push('-H', path.basename(preamblePath));
+        }
+    }
     // Add crossref metadata file if exists (skip for slides - they don't use crossref)
     if (format !== 'beamer' && format !== 'pptx') {
         const crossrefPath = path.join(directory, 'crossref.yaml');
@@ -1188,15 +1227,31 @@ export async function runPandoc(inputPath, format, config, options = {}) {
         console.error(`  pandoc ${quoted}`);
     }
     return new Promise((resolve) => {
+        const pandocEnv = { ...process.env };
+        if (macroEnvFile) {
+            pandocEnv.DOCREV_MACROS_FILE = macroEnvFile;
+        }
         const pandoc = spawn('pandoc', args, {
             cwd: directory,
             stdio: ['ignore', 'pipe', 'pipe'],
+            env: pandocEnv,
         });
         let stderr = '';
         pandoc.stderr?.on('data', (data) => {
             stderr += data.toString();
         });
+        const cleanupMacroTempFiles = () => {
+            for (const tmp of macroTempFiles) {
+                try {
+                    fs.unlinkSync(tmp);
+                }
+                catch {
+                    // ignore — best-effort cleanup
+                }
+            }
+        };
         pandoc.on('close', async (code) => {
+            cleanupMacroTempFiles();
             if (code === 0) {
                 // For PPTX, post-process to add slide numbers, buildup colors, and logos
                 if (format === 'pptx') {
@@ -1247,6 +1302,7 @@ export async function runPandoc(inputPath, format, config, options = {}) {
             }
         });
         pandoc.on('error', (err) => {
+            cleanupMacroTempFiles();
             resolve({ outputPath, success: false, error: err.message });
         });
     });