@usejunior/docx-core 0.0.1 → 0.1.1

package/dist/benchmark/runner.js

@@ -0,0 +1,233 @@
+/**
+ * Benchmark runner for A/B baseline comparison.
+ *
+ * Runs both baselines against test fixtures and collects metrics.
+ */
+import { readFile, readdir, stat } from 'fs/promises';
+import { join } from 'path';
+import { createEmptyMetrics, createTimer, measureMemory, } from './metrics.js';
+import { compareWithDotnet, isRedlineAvailable } from '../baselines/wmlcomparer/DotnetCli.js';
+import { compareDocumentsBaselineB } from '../baselines/diffmatch/pipeline.js';
+/**
+ * Discover fixtures in a directory.
+ *
+ * Expects structure like:
+ * - fixtures/simple-word-change/original.docx
+ * - fixtures/simple-word-change/revised.docx
+ *
+ * Or:
+ * - fixtures/simple-word-change.original.docx
+ * - fixtures/simple-word-change.revised.docx
+ */
+async function discoverFixtures(fixturesPath) {
+    const fixtures = [];
+    const entries = await readdir(fixturesPath, { withFileTypes: true });
+    for (const entry of entries) {
+        if (entry.isDirectory()) {
+            // Directory structure: fixture-name/original.docx + revised.docx
+            const dirPath = join(fixturesPath, entry.name);
+            const originalPath = join(dirPath, 'original.docx');
+            const revisedPath = join(dirPath, 'revised.docx');
+            try {
+                await stat(originalPath);
+                await stat(revisedPath);
+                fixtures.push({
+                    name: entry.name,
+                    originalPath,
+                    revisedPath,
+                });
+            }
+            catch {
+                // Missing files, skip this fixture
+            }
+        }
+        else if (entry.name.endsWith('.original.docx')) {
+            // File structure: fixture-name.original.docx + fixture-name.revised.docx
+            const baseName = entry.name.replace('.original.docx', '');
+            const originalPath = join(fixturesPath, entry.name);
+            const revisedPath = join(fixturesPath, `${baseName}.revised.docx`);
+            try {
+                await stat(revisedPath);
+                fixtures.push({
+                    name: baseName,
+                    originalPath,
+                    revisedPath,
+                });
+            }
+            catch {
+                // Missing revised file, skip
+            }
+        }
+    }
+    return fixtures;
+}
+/**
+ * Run Baseline A (WmlComparer via CLI) on a fixture.
+ */
+async function runBaselineA(original, revised, options) {
+    const metrics = createEmptyMetrics();
+    const startMemory = measureMemory();
+    const timer = createTimer();
+    const result = await compareWithDotnet(original, revised, options);
+    metrics.wallTimeMs = timer();
+    metrics.peakRssMb = Math.max(measureMemory() - startMemory, 0);
+    metrics.outputSizeBytes = result.document.length;
+    metrics.insertions = result.stats.insertions;
+    metrics.deletions = result.stats.deletions;
+    metrics.modifications = result.stats.modifications;
+    // TODO: Add structural validation
+    // - Parse output DOCX
+    // - Check for broken relationships
+    // - Count actual track changes elements
+    return { metrics, output: result.document };
+}
+/**
+ * Run Baseline B (pure TypeScript) on a fixture.
+ *
+ * Uses the diffmatch pipeline:
+ * 1. Parse DOCX to extract paragraphs/runs
+ * 2. Align paragraphs using LCS
+ * 3. Diff matched paragraphs at run level
+ * 4. Render track changes back to DOCX
+ */
+async function runBaselineB(original, revised, author) {
+    const metrics = createEmptyMetrics();
+    const startMemory = measureMemory();
+    const timer = createTimer();
+    const result = await compareDocumentsBaselineB(original, revised, { author });
+    metrics.wallTimeMs = timer();
+    metrics.peakRssMb = Math.max(measureMemory() - startMemory, 0);
+    metrics.outputSizeBytes = result.document.length;
+    metrics.insertions = result.stats.insertions;
+    metrics.deletions = result.stats.deletions;
+    metrics.modifications = result.stats.modifications;
+    return { metrics, output: result.document };
+}
+/**
+ * Run benchmark on a single fixture.
+ */
+async function runFixture(fixture, config) {
+    const result = {
+        fixture: fixture.name,
+        baselineA: null,
+        baselineB: null,
+        timestamp: new Date(),
+    };
+    // Load fixture files
+    const original = await readFile(fixture.originalPath);
+    const revised = await readFile(fixture.revisedPath);
+    const author = config.author ?? 'Benchmark';
+    // Run Baseline A
+    if (config.runBaselineA !== false) {
+        try {
+            const { metrics } = await runBaselineA(original, revised, {
+                author,
+                docxodusPath: config.docxodusPath,
+                dotnetPath: config.dotnetPath,
+                timeout: config.timeout,
+            });
+            result.baselineA = metrics;
+        }
+        catch (error) {
+            result.baselineAError =
+                error instanceof Error ? error.message : String(error);
+        }
+    }
+    // Run Baseline B
+    if (config.runBaselineB !== false) {
+        try {
+            const { metrics } = await runBaselineB(original, revised, author);
+            result.baselineB = metrics;
+        }
+        catch (error) {
+            result.baselineBError =
+                error instanceof Error ? error.message : String(error);
+        }
+    }
+    return result;
+}
+/**
+ * Run benchmark on all fixtures.
+ */
+export async function runBenchmark(config) {
+    // Check if Baseline A is available
+    const canRunA = config.runBaselineA !== false &&
+        await isRedlineAvailable(config.docxodusPath, config.dotnetPath);
+    if (config.runBaselineA !== false && !canRunA) {
+        console.warn('Baseline A (WmlComparer) not available. Install .NET 8+ and Docxodus.');
+    }
+    // Discover fixtures
+    const fixtures = await discoverFixtures(config.fixturesPath);
+    if (fixtures.length === 0) {
+        console.warn(`No fixtures found in ${config.fixturesPath}`);
+        return [];
+    }
+    console.log(`Found ${fixtures.length} fixture(s)`);
+    // Run benchmarks
+    const results = [];
+    for (const fixture of fixtures) {
+        console.log(`Running: ${fixture.name}`);
+        const result = await runFixture(fixture, {
+            ...config,
+            runBaselineA: canRunA && config.runBaselineA !== false,
+        });
+        results.push(result);
+    }
+    return results;
+}
+/**
+ * CLI entry point.
+ */
+async function main() {
+    const args = process.argv.slice(2);
+    if (args.length === 0) {
+        console.log('Usage: npm run benchmark <fixtures-path> [options]');
+        console.log('');
+        console.log('Options:');
+        console.log('  --docxodus=<path>  Path to Docxodus repository');
+        console.log('  --dotnet=<path>    Path to dotnet executable (e.g., /opt/homebrew/opt/dotnet@8/bin/dotnet)');
+        console.log('  --author=<name>    Author name for revisions');
+        console.log('  --no-baseline-a    Skip Baseline A (WmlComparer)');
+        console.log('  --no-baseline-b    Skip Baseline B (pure TS)');
+        process.exit(1);
+    }
+    const fixturesPath = args[0];
+    const options = {};
+    for (let i = 1; i < args.length; i++) {
+        const arg = args[i];
+        if (arg.startsWith('--')) {
+            if (arg.includes('=')) {
+                const [key, value] = arg.slice(2).split('=', 2);
+                options[key] = value;
+            }
+            else if (arg.startsWith('--no-')) {
+                options[arg.slice(5)] = false;
+            }
+            else {
+                options[arg.slice(2)] = true;
+            }
+        }
+    }
+    const config = {
+        fixturesPath,
+        author: options.author,
+        docxodusPath: options.docxodus,
+        dotnetPath: options.dotnet,
+        runBaselineA: options['baseline-a'] !== false,
+        runBaselineB: options['baseline-b'] !== false,
+    };
+    try {
+        const results = await runBenchmark(config);
+        // Output results as JSON
+        console.log(JSON.stringify(results, null, 2));
+    }
+    catch (error) {
+        console.error('Benchmark failed:', error);
+        process.exit(1);
+    }
+}
+// Run if executed directly
+if (import.meta.url === `file://${process.argv[1]}`) {
+    main().catch(console.error);
+}
+//# sourceMappingURL=runner.js.map

package/dist/benchmark/runner.js.map

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

package/dist/cli/compare-two.d.ts

@@ -0,0 +1,28 @@
+import { type CompareOptions } from '../index.js';
+export interface ParsedCompareCliArgs {
+    originalPath: string;
+    revisedPath: string;
+    outputPath?: string;
+    options: {
+        engine: NonNullable<CompareOptions['engine']>;
+        reconstructionMode: 'inplace' | 'rebuild';
+        author: string;
+        premergeRuns: boolean;
+    };
+}
+export interface CompareCliHelpResult {
+    help: true;
+    text: string;
+}
+export interface CompareCliRunResult {
+    help?: false;
+    output: string;
+    engine: string;
+    mode: 'inplace' | 'rebuild';
+    bytes: number;
+    stats: unknown;
+}
+export type CompareCliResult = CompareCliHelpResult | CompareCliRunResult;
+export declare function parseCompareCliArgs(argv: string[]): ParsedCompareCliArgs;
+export declare function runCompareCli(argv?: string[]): Promise<CompareCliResult>;
+//# sourceMappingURL=compare-two.d.ts.map

package/dist/cli/compare-two.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compare-two.d.ts","sourceRoot":"","sources":["../../src/cli/compare-two.ts"],"names":[],"mappings":"AAEA,OAAO,EAAoB,KAAK,cAAc,EAAE,MAAM,aAAa,CAAC;AAMpE,MAAM,WAAW,oBAAoB;IACnC,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE;QACP,MAAM,EAAE,WAAW,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC,CAAC;QAC9C,kBAAkB,EAAE,SAAS,GAAG,SAAS,CAAC;QAC1C,MAAM,EAAE,MAAM,CAAC;QACf,YAAY,EAAE,OAAO,CAAC;KACvB,CAAC;CACH;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,IAAI,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,CAAC,EAAE,KAAK,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,SAAS,GAAG,SAAS,CAAC;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,MAAM,gBAAgB,GAAG,oBAAoB,GAAG,mBAAmB,CAAC;AAS1E,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,oBAAoB,CAsExE;AAMD,wBAAsB,aAAa,CAAC,IAAI,WAAwB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAiC3F"}

package/dist/cli/compare-two.js

@@ -0,0 +1,110 @@
+import { readFile, writeFile, mkdir } from 'node:fs/promises';
+import { dirname, resolve } from 'node:path';
+import { compareDocuments } from '../index.js';
+const USAGE = 'Usage: docx-comparison <original.docx> <revised.docx> [output.docx] ' +
+    '[--engine atomizer|diffmatch|auto] [--mode inplace|rebuild] [--author "Name"] [--premerge-runs true|false]';
+function parseBooleanFlag(raw, flagName) {
+    const normalized = raw.trim().toLowerCase();
+    if (['1', 'true', 'yes', 'on'].includes(normalized))
+        return true;
+    if (['0', 'false', 'no', 'off'].includes(normalized))
+        return false;
+    throw new Error(`Invalid value for ${flagName}: ${raw}. Use true or false.`);
+}
+export function parseCompareCliArgs(argv) {
+    const positional = [];
+    const options = {
+        engine: 'atomizer',
+        reconstructionMode: 'rebuild',
+        author: 'Comparison',
+        premergeRuns: false,
+    };
+    for (let i = 0; i < argv.length; i++) {
+        const token = argv[i];
+        if (!token)
+            continue;
+        if (!token.startsWith('--')) {
+            positional.push(token);
+            continue;
+        }
+        const consumeValue = (flagName) => {
+            const next = argv[i + 1];
+            if (!next || next.startsWith('--')) {
+                throw new Error(`Missing value for ${flagName}.\n${USAGE}`);
+            }
+            i += 1;
+            return next;
+        };
+        switch (token) {
+            case '--engine': {
+                const engine = consumeValue(token);
+                if (engine !== 'atomizer' && engine !== 'diffmatch' && engine !== 'auto') {
+                    throw new Error(`Unsupported engine: ${engine}. Use atomizer, diffmatch, or auto.`);
+                }
+                options.engine = engine;
+                break;
+            }
+            case '--mode': {
+                const mode = consumeValue(token);
+                if (mode !== 'inplace' && mode !== 'rebuild') {
+                    throw new Error(`Unsupported mode: ${mode}. Use inplace or rebuild.`);
+                }
+                options.reconstructionMode = mode;
+                break;
+            }
+            case '--author':
+                options.author = consumeValue(token);
+                break;
+            case '--premerge-runs':
+                options.premergeRuns = parseBooleanFlag(consumeValue(token), token);
+                break;
+            default:
+                throw new Error(`Unknown option: ${token}.\n${USAGE}`);
+        }
+    }
+    if (positional.length < 2 || positional.length > 3) {
+        throw new Error(`Expected <original.docx> <revised.docx> [output.docx].\n${USAGE}`);
+    }
+    const [originalPath, revisedPath, outputPath] = positional;
+    if (!originalPath || !revisedPath) {
+        throw new Error(`Expected <original.docx> <revised.docx> [output.docx].\n${USAGE}`);
+    }
+    return {
+        originalPath,
+        revisedPath,
+        outputPath,
+        options,
+    };
+}
+function defaultOutputPath(revisedAbs, options) {
+    return revisedAbs.replace(/\.docx$/i, '') + `.REDLINE.${options.engine}.${options.reconstructionMode}.docx`;
+}
+export async function runCompareCli(argv = process.argv.slice(2)) {
+    if (argv.includes('--help') || argv.includes('-h')) {
+        return { help: true, text: USAGE };
+    }
+    const parsed = parseCompareCliArgs(argv);
+    const originalAbs = resolve(parsed.originalPath);
+    const revisedAbs = resolve(parsed.revisedPath);
+    const outputAbs = resolve(parsed.outputPath ?? defaultOutputPath(revisedAbs, parsed.options));
+    const [originalBuffer, revisedBuffer] = await Promise.all([
+        readFile(originalAbs),
+        readFile(revisedAbs),
+    ]);
+    const result = await compareDocuments(originalBuffer, revisedBuffer, {
+        engine: parsed.options.engine,
+        author: parsed.options.author,
+        reconstructionMode: parsed.options.reconstructionMode,
+        premergeRuns: parsed.options.premergeRuns,
+    });
+    await mkdir(dirname(outputAbs), { recursive: true });
+    await writeFile(outputAbs, result.document);
+    return {
+        output: outputAbs,
+        engine: result.engine,
+        mode: parsed.options.reconstructionMode,
+        bytes: result.document.length,
+        stats: result.stats,
+    };
+}
+//# sourceMappingURL=compare-two.js.map

package/dist/cli/compare-two.js.map

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

package/dist/cli/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export declare function runCli(argv?: string[]): Promise<void>;
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";AAIA,wBAAsB,MAAM,CAAC,IAAI,WAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAU/D"}

package/dist/cli/index.js

@@ -0,0 +1,21 @@
+#!/usr/bin/env node
+import { pathToFileURL } from 'node:url';
+import { runCompareCli } from './compare-two.js';
+export async function runCli(argv = process.argv) {
+    const result = await runCompareCli(argv.slice(2));
+    if ('help' in result && result.help) {
+        // eslint-disable-next-line no-console
+        console.log(result.text);
+        return;
+    }
+    // eslint-disable-next-line no-console
+    console.log(JSON.stringify(result));
+}
+if (process.argv[1] && pathToFileURL(process.argv[1]).href === import.meta.url) {
+    runCli(process.argv).catch((err) => {
+        // eslint-disable-next-line no-console
+        console.error(err?.message ?? String(err));
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjD,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI;IAC9C,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAClD,IAAI,MAAM,IAAI,MAAM,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;QACpC,sCAAsC;QACtC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACzB,OAAO;IACT,CAAC;IAED,sCAAsC;IACtC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC;AACtC,CAAC;AAED,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,aAAa,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;IAC/E,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;QACjC,sCAAsC;QACtC,OAAO,CAAC,KAAK,CAAC,GAAG,EAAE,OAAO,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QAC3C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;AACL,CAAC"}