docrev 0.8.1 → 0.8.5

package/dist/lib/plugins.js

@@ -0,0 +1,235 @@
+/**
+ * Plugin system for custom journal profiles and export formats
+ *
+ * Users can add custom profiles in:
+ * - Project: .rev/profiles/*.yaml
+ * - User: ~/.rev/profiles/*.yaml
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import * as os from 'os';
+import * as yaml from 'yaml';
+// Plugin directories
+const USER_PLUGINS_DIR = path.join(os.homedir(), '.rev', 'profiles');
+const PROJECT_PLUGINS_DIR = path.join(process.cwd(), '.rev', 'profiles');
+/**
+ * Load all custom journal profiles
+ */
+export function loadCustomProfiles() {
+    const profiles = {};
+    // Load user profiles first (lower priority)
+    const userProfiles = loadProfilesFromDir(USER_PLUGINS_DIR);
+    Object.assign(profiles, userProfiles);
+    // Load project profiles (higher priority, can override)
+    const projectProfiles = loadProfilesFromDir(PROJECT_PLUGINS_DIR);
+    Object.assign(profiles, projectProfiles);
+    return profiles;
+}
+/**
+ * Load profiles from a directory
+ */
+function loadProfilesFromDir(dir) {
+    const profiles = {};
+    if (!fs.existsSync(dir)) {
+        return profiles;
+    }
+    try {
+        const files = fs.readdirSync(dir).filter(f => f.endsWith('.yaml') || f.endsWith('.yml') || f.endsWith('.json'));
+        for (const file of files) {
+            try {
+                const filePath = path.join(dir, file);
+                const content = fs.readFileSync(filePath, 'utf-8');
+                const profile = file.endsWith('.json')
+                    ? JSON.parse(content)
+                    : yaml.parse(content);
+                if (validateProfile(profile)) {
+                    const id = profile.id || path.basename(file, path.extname(file));
+                    profiles[id] = normalizeProfile(profile);
+                }
+            }
+            catch (err) {
+                const message = err instanceof Error ? err.message : String(err);
+                console.error(`Warning: Failed to load profile ${file}: ${message}`);
+            }
+        }
+    }
+    catch {
+        // Directory not readable
+    }
+    return profiles;
+}
+/**
+ * Validate a profile structure
+ */
+function validateProfile(profile) {
+    if (!profile || typeof profile !== 'object') {
+        return false;
+    }
+    const p = profile;
+    // Must have a name
+    if (!p.name || typeof p.name !== 'string') {
+        return false;
+    }
+    // Requirements must be an object if present
+    if (p.requirements && typeof p.requirements !== 'object') {
+        return false;
+    }
+    return true;
+}
+/**
+ * Normalize profile to standard structure
+ */
+function normalizeProfile(profile) {
+    return {
+        name: profile.name,
+        url: profile.url || null,
+        custom: true,
+        requirements: {
+            wordLimit: profile.requirements?.wordLimit || profile.wordLimit || {},
+            references: profile.requirements?.references || profile.references || {},
+            figures: profile.requirements?.figures || profile.figures || {},
+            sections: profile.requirements?.sections || profile.sections || {},
+            authors: profile.requirements?.authors || profile.authors || {},
+            keywords: profile.requirements?.keywords || profile.keywords || null,
+            dataAvailability: profile.requirements?.dataAvailability || profile.dataAvailability || false,
+            ...profile.requirements,
+        },
+    };
+}
+/**
+ * Initialize plugin directories
+ */
+export function initPluginDir(project = false) {
+    const dir = project ? PROJECT_PLUGINS_DIR : USER_PLUGINS_DIR;
+    if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true });
+    }
+    return dir;
+}
+/**
+ * Get plugin directories info
+ */
+export function getPluginDirs() {
+    return {
+        user: USER_PLUGINS_DIR,
+        project: PROJECT_PLUGINS_DIR,
+        userExists: fs.existsSync(USER_PLUGINS_DIR),
+        projectExists: fs.existsSync(PROJECT_PLUGINS_DIR),
+    };
+}
+/**
+ * Create a sample profile template
+ */
+export function createProfileTemplate(journalName) {
+    const id = journalName.toLowerCase().replace(/\s+/g, '-');
+    return `# Custom journal profile for ${journalName}
+# Save as: ~/.rev/profiles/${id}.yaml (user-wide)
+# Or: .rev/profiles/${id}.yaml (project-specific)
+
+id: ${id}
+name: "${journalName}"
+url: "https://journal-website.com/author-guidelines"
+
+# Word count limits
+wordLimit:
+  main: 8000      # null for no limit
+  abstract: 300
+  title: null     # characters
+
+# Reference requirements
+references:
+  max: null       # null for no limit
+  doiRequired: true
+
+# Figure/table limits
+figures:
+  max: 8
+  combinedWithTables: false
+
+# Required sections
+sections:
+  required:
+    - Abstract
+    - Introduction
+    - Methods
+    - Results
+    - Discussion
+  methodsPosition: null  # 'end' or 'before-results'
+
+# Keywords
+keywords:
+  min: 4
+  max: 8
+
+# Other requirements
+dataAvailability: true
+highlights: false
+graphicalAbstract: false
+`;
+}
+/**
+ * Save a profile template
+ */
+export function saveProfileTemplate(journalName, project = false) {
+    const dir = initPluginDir(project);
+    const id = journalName.toLowerCase().replace(/\s+/g, '-');
+    const filePath = path.join(dir, `${id}.yaml`);
+    if (fs.existsSync(filePath)) {
+        throw new Error(`Profile already exists: ${filePath}`);
+    }
+    const content = createProfileTemplate(journalName);
+    fs.writeFileSync(filePath, content, 'utf-8');
+    return filePath;
+}
+/**
+ * List all custom profiles
+ */
+export function listCustomProfiles() {
+    const result = [];
+    // User profiles
+    if (fs.existsSync(USER_PLUGINS_DIR)) {
+        const files = fs.readdirSync(USER_PLUGINS_DIR).filter(f => f.endsWith('.yaml') || f.endsWith('.yml') || f.endsWith('.json'));
+        for (const file of files) {
+            try {
+                const filePath = path.join(USER_PLUGINS_DIR, file);
+                const content = fs.readFileSync(filePath, 'utf-8');
+                const profile = file.endsWith('.json') ? JSON.parse(content) : yaml.parse(content);
+                if (validateProfile(profile)) {
+                    result.push({
+                        id: profile.id || path.basename(file, path.extname(file)),
+                        name: profile.name,
+                        source: 'user',
+                        path: filePath,
+                    });
+                }
+            }
+            catch {
+                // Skip invalid profiles
+            }
+        }
+    }
+    // Project profiles
+    if (fs.existsSync(PROJECT_PLUGINS_DIR)) {
+        const files = fs.readdirSync(PROJECT_PLUGINS_DIR).filter(f => f.endsWith('.yaml') || f.endsWith('.yml') || f.endsWith('.json'));
+        for (const file of files) {
+            try {
+                const filePath = path.join(PROJECT_PLUGINS_DIR, file);
+                const content = fs.readFileSync(filePath, 'utf-8');
+                const profile = file.endsWith('.json') ? JSON.parse(content) : yaml.parse(content);
+                if (validateProfile(profile)) {
+                    result.push({
+                        id: profile.id || path.basename(file, path.extname(file)),
+                        name: profile.name,
+                        source: 'project',
+                        path: filePath,
+                    });
+                }
+            }
+            catch {
+                // Skip invalid profiles
+            }
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=plugins.js.map

package/dist/lib/plugins.js.map

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

package/dist/lib/postprocess.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Postprocess scripting for docrev
+ *
+ * Allows users to run custom scripts after output generation.
+ * Supports shell scripts, PowerShell, Python, and Node.js.
+ */
+/**
+ * Script execution result
+ */
+interface ExecutionResult {
+    success: boolean;
+    stdout: string;
+    stderr: string;
+    error?: string;
+}
+/**
+ * Execution options
+ */
+interface ExecutionOptions {
+    verbose?: boolean;
+}
+/**
+ * Postprocess result
+ */
+interface PostprocessResult {
+    success: boolean;
+    error?: string;
+}
+/**
+ * Execute a script with environment variables
+ */
+export declare function executeScript(scriptPath: string, env: Record<string, string>, options?: ExecutionOptions): Promise<ExecutionResult>;
+/**
+ * Run postprocess scripts for a given format
+ */
+export declare function runPostprocess(outputPath: string, format: string, config: {
+    postprocess?: Record<string, string>;
+    _configPath?: string;
+    [key: string]: unknown;
+}, options?: ExecutionOptions): Promise<PostprocessResult>;
+export {};
+//# sourceMappingURL=postprocess.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"postprocess.d.ts","sourceRoot":"","sources":["../../lib/postprocess.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH;;GAEG;AACH,UAAU,eAAe;IACvB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,UAAU,gBAAgB;IACxB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,UAAU,iBAAiB;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,wBAAsB,aAAa,CACjC,UAAU,EAAE,MAAM,EAClB,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC3B,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,eAAe,CAAC,CA0E1B;AAED;;GAEG;AACH,wBAAsB,cAAc,CAClC,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE;IAAE,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE,EAC9F,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,iBAAiB,CAAC,CA4D5B"}

package/dist/lib/postprocess.js

@@ -0,0 +1,138 @@
+/**
+ * Postprocess scripting for docrev
+ *
+ * Allows users to run custom scripts after output generation.
+ * Supports shell scripts, PowerShell, Python, and Node.js.
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import { spawn } from 'child_process';
+/**
+ * Execute a script with environment variables
+ */
+export async function executeScript(scriptPath, env, options = {}) {
+    return new Promise((resolve) => {
+        const ext = path.extname(scriptPath).toLowerCase();
+        const isWindows = process.platform === 'win32';
+        let command;
+        let args;
+        let useShell;
+        // Determine how to run based on extension
+        if (ext === '.ps1') {
+            command = 'powershell';
+            args = ['-ExecutionPolicy', 'Bypass', '-File', scriptPath];
+            useShell = false;
+        }
+        else if (ext === '.py') {
+            // Python needs shell on Windows for PATH resolution
+            command = isWindows ? 'python' : 'python3';
+            // On Windows, wrap path in quotes to handle spaces
+            args = [isWindows ? `"${scriptPath}"` : scriptPath];
+            useShell = isWindows;
+        }
+        else if (ext === '.js' || ext === '.mjs') {
+            // Node.js is typically in PATH and works without shell
+            command = process.execPath; // Use the same Node that's running this script
+            args = [scriptPath];
+            useShell = false;
+        }
+        else {
+            // Assume shell script (.sh or no extension)
+            command = isWindows ? 'bash' : '/bin/bash';
+            args = [scriptPath];
+            useShell = false;
+        }
+        const proc = spawn(command, args, {
+            env: { ...process.env, ...env },
+            cwd: path.dirname(scriptPath),
+            stdio: ['ignore', 'pipe', 'pipe'],
+            shell: useShell,
+            // On Windows with shell, use windowsVerbatimArguments to preserve paths with spaces
+            windowsVerbatimArguments: isWindows && useShell,
+        });
+        let stdout = '';
+        let stderr = '';
+        proc.stdout.on('data', (data) => {
+            stdout += data.toString();
+            if (options.verbose) {
+                process.stdout.write(data);
+            }
+        });
+        proc.stderr.on('data', (data) => {
+            stderr += data.toString();
+            if (options.verbose) {
+                process.stderr.write(data);
+            }
+        });
+        proc.on('error', (err) => {
+            resolve({ success: false, stdout, stderr, error: err.message });
+        });
+        proc.on('close', (code) => {
+            if (code === 0) {
+                resolve({ success: true, stdout, stderr });
+            }
+            else {
+                resolve({
+                    success: false,
+                    stdout,
+                    stderr,
+                    error: `Exit code ${code}: ${stderr.trim() || 'Unknown error'}`,
+                });
+            }
+        });
+    });
+}
+/**
+ * Run postprocess scripts for a given format
+ */
+export async function runPostprocess(outputPath, format, config, options = {}) {
+    const postprocessConfig = config.postprocess || {};
+    // Collect scripts to run (format-specific + all)
+    const scripts = [];
+    if (postprocessConfig[format]) {
+        scripts.push(postprocessConfig[format]);
+    }
+    if (postprocessConfig.all) {
+        scripts.push(postprocessConfig.all);
+    }
+    if (scripts.length === 0) {
+        return { success: true };
+    }
+    const directory = path.dirname(outputPath);
+    const errors = [];
+    for (const scriptPath of scripts) {
+        const absoluteScript = path.isAbsolute(scriptPath)
+            ? scriptPath
+            : path.join(directory, scriptPath);
+        if (!fs.existsSync(absoluteScript)) {
+            errors.push(`Postprocess script not found: ${scriptPath}`);
+            continue;
+        }
+        try {
+            if (options.verbose) {
+                console.log(`Running postprocess script: ${scriptPath}`);
+            }
+            const result = await executeScript(absoluteScript, {
+                OUTPUT_FILE: outputPath,
+                OUTPUT_FORMAT: format,
+                PROJECT_DIR: directory,
+                CONFIG_PATH: config._configPath || '',
+            }, options);
+            if (!result.success) {
+                errors.push(`Script ${scriptPath} failed: ${result.error}`);
+            }
+            else if (options.verbose) {
+                console.log(`Postprocess script completed: ${scriptPath}`);
+            }
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            errors.push(`Script ${scriptPath} error: ${message}`);
+        }
+    }
+    return {
+        success: errors.length === 0,
+        error: errors.length > 0 ? errors.join('\n') : undefined,
+    };
+}
+//# sourceMappingURL=postprocess.js.map

package/dist/lib/postprocess.js.map

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

package/dist/lib/pptx-template.d.ts

@@ -0,0 +1,59 @@
+/**
+ * PPTX post-processing
+ *
+ * Injects logos into each slide of a generated PPTX to match ref.pptx styling.
+ * Uses ref.pptx as-is for --reference-doc, then post-processes to add logos.
+ */
+interface ThemeFonts {
+    major?: string;
+    minor?: string;
+}
+interface Theme {
+    fonts?: ThemeFonts;
+}
+interface TemplateOptions {
+    baseTemplate: string;
+    outputPath: string;
+}
+interface BuildupConfig {
+    default?: string;
+    title?: string;
+    grey?: string;
+    accent?: string;
+    enabled?: boolean;
+}
+/**
+ * Inject slide numbers into each slide of a PPTX
+ * Only adds slide numbers to slides that have a footer (i.e., slides with the green banner).
+ * Title slides, section slides, cover slides don't have the banner so they don't get numbers.
+ * Uses in-place ZIP modification to preserve file structure.
+ */
+export declare function injectSlideNumbers(pptxPath: string): Promise<void>;
+/**
+ * Inject logos into cover slide of a PPTX (matching ref.pptx style)
+ * Uses in-place ZIP modification to preserve file structure.
+ */
+export declare function injectLogosIntoSlides(pptxPath: string, mediaDir: string | null): Promise<void>;
+export declare function generatePptxTemplate(options: TemplateOptions): Promise<string | null>;
+export declare function templateNeedsRegeneration(templatePath: string, mediaDir: string, baseTemplate: string): boolean;
+export declare function injectMediaIntoPptx(pptxPath: string, mediaDir: string): Promise<void>;
+/**
+ * Apply theme fonts to all text in a PPTX
+ * Pandoc generates slides with hardcoded fonts; this replaces them with theme font references.
+ * Uses in-place ZIP modification to preserve file structure.
+ */
+export declare function applyThemeFonts(pptxPath: string, theme: Theme): Promise<void>;
+/**
+ * Apply vertical centering to slides that have the .center class
+ * Uses in-place ZIP modification to preserve file structure.
+ */
+export declare function applyCentering(pptxPath: string, centeredSlideIndices: number[]): Promise<void>;
+/**
+ * Apply buildup greying to slides with buildup content
+ * Greys out all bullet items except the last one, which gets the accent color.
+ * Only affects actual bullet items (not intro text with buNone).
+ * Uses in-place ZIP modification to preserve file structure.
+ */
+export declare function applyBuildupColors(pptxPath: string, config?: BuildupConfig): Promise<void>;
+export {};
+//# sourceMappingURL=pptx-template.d.ts.map

package/dist/lib/pptx-template.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pptx-template.d.ts","sourceRoot":"","sources":["../../lib/pptx-template.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,UAAU,UAAU;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,UAAU,KAAK;IACb,KAAK,CAAC,EAAE,UAAU,CAAC;CACpB;AAED,UAAU,eAAe;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,UAAU,aAAa;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AA0ED;;;;;GAKG;AACH,wBAAsB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAgExE;AAED;;;GAGG;AACH,wBAAsB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CA0HpG;AAGD,wBAAsB,oBAAoB,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAS3F;AAED,wBAAgB,yBAAyB,CAAC,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAE/G;AAED,wBAAsB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAG3F;AAED;;;;GAIG;AACH,wBAAsB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CA0CnF;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,oBAAoB,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAwEpG;AAED;;;;;GAKG;AACH,wBAAsB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,GAAE,aAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAqKpG"}