@usejunior/docx-core 0.0.1 → 0.1.2

package/dist/baselines/wmlcomparer/DotnetCli.js

@@ -0,0 +1,135 @@
+/**
+ * Baseline A: WmlComparer via dotnet CLI.
+ *
+ * Shells out to Docxodus's redline tool to perform document comparison.
+ * Requires .NET 8+ and Docxodus to be available.
+ */
+import { execFile } from 'child_process';
+import { promisify } from 'util';
+import { writeFile, readFile, unlink, mkdtemp } from 'fs/promises';
+import { join } from 'path';
+import { tmpdir } from 'os';
+const execFileAsync = promisify(execFile);
+/**
+ * Check if dotnet CLI is available.
+ */
+export async function isDotnetAvailable(dotnetPath = 'dotnet') {
+    try {
+        await execFileAsync(dotnetPath, ['--version']);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Compare two DOCX documents using the dotnet CLI.
+ *
+ * @param original - Original document as Buffer
+ * @param revised - Revised document as Buffer
+ * @param options - CLI options
+ * @returns Comparison result with track changes
+ */
+export async function compareWithDotnet(original, revised, options = {}) {
+    const { author = 'Comparison', redlinePath, docxodusPath, dotnetPath = 'dotnet', timeout = 60000, } = options;
+    // Create a temporary directory for the comparison
+    const tempDir = await mkdtemp(join(tmpdir(), 'docx-compare-'));
+    const originalPath = join(tempDir, 'original.docx');
+    const revisedPath = join(tempDir, 'revised.docx');
+    const outputPath = join(tempDir, 'output.docx');
+    try {
+        // Write input files
+        await writeFile(originalPath, original);
+        await writeFile(revisedPath, revised);
+        // Determine command to run
+        let command;
+        let args;
+        if (redlinePath) {
+            // Use specified redline executable
+            command = redlinePath;
+            args = [originalPath, revisedPath, outputPath, `--author=${author}`];
+        }
+        else if (docxodusPath) {
+            // Use dotnet run with Docxodus project
+            command = dotnetPath;
+            args = [
+                'run',
+                '--project',
+                join(docxodusPath, 'tools', 'redline', 'redline.csproj'),
+                '--configuration',
+                'Release',
+                '--no-build',
+                '--',
+                originalPath,
+                revisedPath,
+                outputPath,
+                `--author=${author}`,
+            ];
+        }
+        else {
+            // Try using global tool or assume redline is in PATH
+            command = 'redline';
+            args = [originalPath, revisedPath, outputPath, `--author=${author}`];
+        }
+        // Execute comparison
+        const { stdout } = await execFileAsync(command, args, {
+            timeout,
+            maxBuffer: 10 * 1024 * 1024, // 10MB
+        });
+        // Parse revision count from stdout if available
+        const revisionMatch = stdout.match(/(\d+) revision\(s\) found/);
+        const revisionCount = revisionMatch ? parseInt(revisionMatch[1] ?? '0', 10) : 0;
+        // Read output file
+        const outputBuffer = await readFile(outputPath);
+        // Return result
+        // Note: We can't get detailed stats without parsing the output DOCX
+        // For now, just return the revision count as insertions
+        const stats = {
+            insertions: revisionCount,
+            deletions: 0, // Would need to parse output to get this
+            modifications: 0,
+        };
+        return {
+            document: outputBuffer,
+            stats,
+            engine: 'wmlcomparer',
+        };
+    }
+    finally {
+        // Clean up temporary files
+        try {
+            await unlink(originalPath);
+            await unlink(revisedPath);
+            await unlink(outputPath);
+            // Note: Can't rmdir because it might not be empty
+        }
+        catch {
+            // Ignore cleanup errors
+        }
+    }
+}
+/**
+ * Check if Docxodus redline tool is available.
+ *
+ * @param docxodusPath - Path to Docxodus repository
+ * @param dotnetPath - Path to dotnet executable
+ */
+export async function isRedlineAvailable(docxodusPath, dotnetPath = 'dotnet') {
+    try {
+        if (docxodusPath) {
+            // Check if the project file exists
+            const projectPath = join(docxodusPath, 'tools', 'redline', 'redline.csproj');
+            await readFile(projectPath);
+            return await isDotnetAvailable(dotnetPath);
+        }
+        else {
+            // Try running redline --version
+            await execFileAsync('redline', ['--version']);
+            return true;
+        }
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=DotnetCli.js.map

package/dist/baselines/wmlcomparer/DotnetCli.js.map

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

package/dist/benchmark/metrics.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Benchmark metrics collection.
+ *
+ * Defines the metrics collected during A/B baseline comparison.
+ */
+/**
+ * Metrics collected from a comparison operation.
+ */
+export interface ComparisonMetrics {
+    /** Number of insertions detected */
+    insertions: number;
+    /** Number of deletions detected */
+    deletions: number;
+    /** Number of modifications (paragraphs with changes) */
+    modifications: number;
+    /** Average length of changed spans */
+    avgSpanLength: number;
+    /** Whether output opens in Word (requires manual verification or COM automation) */
+    opensInWord: boolean | null;
+    /** Whether OpenXML SDK can load the output */
+    openXmlSdkValid: boolean | null;
+    /** Whether all relationship parts are valid */
+    noBrokenRelationships: boolean | null;
+    /** Whether numbering was retained correctly */
+    numberingRetained: boolean | null;
+    /** Whether section headings are correct */
+    sectionHeadingsCorrect: boolean | null;
+    /** Whether defined terms are preserved */
+    definedTermsPreserved: boolean | null;
+    /** Whether tables remain intact */
+    tablesIntact: boolean | null;
+    /** Whether cross-references work */
+    crossRefsWorking: boolean | null;
+    /** Wall clock time in milliseconds */
+    wallTimeMs: number;
+    /** Peak RSS memory in megabytes */
+    peakRssMb: number;
+    /** Output file size in bytes */
+    outputSizeBytes: number;
+}
+/**
+ * Create an empty metrics object with null values.
+ */
+export declare function createEmptyMetrics(): ComparisonMetrics;
+/**
+ * Result of running a benchmark on a fixture.
+ */
+export interface BenchmarkResult {
+    /** Name of the fixture */
+    fixture: string;
+    /** Metrics from Baseline A (WmlComparer) */
+    baselineA: ComparisonMetrics | null;
+    /** Error from Baseline A if any */
+    baselineAError?: string;
+    /** Metrics from Baseline B (pure TS) */
+    baselineB: ComparisonMetrics | null;
+    /** Error from Baseline B if any */
+    baselineBError?: string;
+    /** Metrics from Word oracle (if available) */
+    wordOracle?: ComparisonMetrics | null;
+    /** Timestamp when benchmark was run */
+    timestamp: Date;
+}
+/**
+ * Measure memory usage.
+ */
+export declare function measureMemory(): number;
+/**
+ * High-resolution timer for performance measurement.
+ */
+export declare function createTimer(): () => number;
+//# sourceMappingURL=metrics.d.ts.map

package/dist/benchmark/metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["../../src/benchmark/metrics.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAEhC,oCAAoC;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,mCAAmC;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,wDAAwD;IACxD,aAAa,EAAE,MAAM,CAAC;IACtB,sCAAsC;IACtC,aAAa,EAAE,MAAM,CAAC;IAGtB,oFAAoF;IACpF,WAAW,EAAE,OAAO,GAAG,IAAI,CAAC;IAC5B,8CAA8C;IAC9C,eAAe,EAAE,OAAO,GAAG,IAAI,CAAC;IAChC,+CAA+C;IAC/C,qBAAqB,EAAE,OAAO,GAAG,IAAI,CAAC;IAGtC,+CAA+C;IAC/C,iBAAiB,EAAE,OAAO,GAAG,IAAI,CAAC;IAClC,2CAA2C;IAC3C,sBAAsB,EAAE,OAAO,GAAG,IAAI,CAAC;IACvC,0CAA0C;IAC1C,qBAAqB,EAAE,OAAO,GAAG,IAAI,CAAC;IACtC,mCAAmC;IACnC,YAAY,EAAE,OAAO,GAAG,IAAI,CAAC;IAC7B,oCAAoC;IACpC,gBAAgB,EAAE,OAAO,GAAG,IAAI,CAAC;IAGjC,sCAAsC;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,mCAAmC;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,gCAAgC;IAChC,eAAe,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,iBAAiB,CAkBtD;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,0BAA0B;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,4CAA4C;IAC5C,SAAS,EAAE,iBAAiB,GAAG,IAAI,CAAC;IACpC,mCAAmC;IACnC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,wCAAwC;IACxC,SAAS,EAAE,iBAAiB,GAAG,IAAI,CAAC;IACpC,mCAAmC;IACnC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,8CAA8C;IAC9C,UAAU,CAAC,EAAE,iBAAiB,GAAG,IAAI,CAAC;IACtC,uCAAuC;IACvC,SAAS,EAAE,IAAI,CAAC;CACjB;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAGtC;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,MAAM,MAAM,CAM1C"}

package/dist/benchmark/metrics.js

@@ -0,0 +1,45 @@
+/**
+ * Benchmark metrics collection.
+ *
+ * Defines the metrics collected during A/B baseline comparison.
+ */
+/**
+ * Create an empty metrics object with null values.
+ */
+export function createEmptyMetrics() {
+    return {
+        insertions: 0,
+        deletions: 0,
+        modifications: 0,
+        avgSpanLength: 0,
+        opensInWord: null,
+        openXmlSdkValid: null,
+        noBrokenRelationships: null,
+        numberingRetained: null,
+        sectionHeadingsCorrect: null,
+        definedTermsPreserved: null,
+        tablesIntact: null,
+        crossRefsWorking: null,
+        wallTimeMs: 0,
+        peakRssMb: 0,
+        outputSizeBytes: 0,
+    };
+}
+/**
+ * Measure memory usage.
+ */
+export function measureMemory() {
+    const usage = process.memoryUsage();
+    return usage.rss / (1024 * 1024); // Convert to MB
+}
+/**
+ * High-resolution timer for performance measurement.
+ */
+export function createTimer() {
+    const start = process.hrtime.bigint();
+    return () => {
+        const end = process.hrtime.bigint();
+        return Number(end - start) / 1_000_000; // Convert to ms
+    };
+}
+//# sourceMappingURL=metrics.js.map

package/dist/benchmark/metrics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.js","sourceRoot":"","sources":["../../src/benchmark/metrics.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AA6CH;;GAEG;AACH,MAAM,UAAU,kBAAkB;IAChC,OAAO;QACL,UAAU,EAAE,CAAC;QACb,SAAS,EAAE,CAAC;QACZ,aAAa,EAAE,CAAC;QAChB,aAAa,EAAE,CAAC;QAChB,WAAW,EAAE,IAAI;QACjB,eAAe,EAAE,IAAI;QACrB,qBAAqB,EAAE,IAAI;QAC3B,iBAAiB,EAAE,IAAI;QACvB,sBAAsB,EAAE,IAAI;QAC5B,qBAAqB,EAAE,IAAI;QAC3B,YAAY,EAAE,IAAI;QAClB,gBAAgB,EAAE,IAAI;QACtB,UAAU,EAAE,CAAC;QACb,SAAS,EAAE,CAAC;QACZ,eAAe,EAAE,CAAC;KACnB,CAAC;AACJ,CAAC;AAsBD;;GAEG;AACH,MAAM,UAAU,aAAa;IAC3B,MAAM,KAAK,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IACpC,OAAO,KAAK,CAAC,GAAG,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,gBAAgB;AACpD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW;IACzB,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;IACtC,OAAO,GAAG,EAAE;QACV,MAAM,GAAG,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;QACpC,OAAO,MAAM,CAAC,GAAG,GAAG,KAAK,CAAC,GAAG,SAAS,CAAC,CAAC,gBAAgB;IAC1D,CAAC,CAAC;AACJ,CAAC"}

package/dist/benchmark/reporter.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Benchmark result reporter.
+ *
+ * Formats benchmark results for different output modes.
+ */
+import { BenchmarkResult } from './metrics.js';
+/**
+ * Generate a markdown report from benchmark results.
+ */
+export declare function generateMarkdownReport(results: BenchmarkResult[]): string;
+/**
+ * Generate a console table from benchmark results.
+ */
+export declare function generateConsoleTable(results: BenchmarkResult[]): string;
+/**
+ * Generate JSON output from benchmark results.
+ */
+export declare function generateJsonReport(results: BenchmarkResult[]): string;
+/**
+ * Print a comparison summary to console.
+ */
+export declare function printSummary(results: BenchmarkResult[]): void;
+//# sourceMappingURL=reporter.d.ts.map

package/dist/benchmark/reporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reporter.d.ts","sourceRoot":"","sources":["../../src/benchmark/reporter.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,eAAe,EAAqB,MAAM,cAAc,CAAC;AAoBlE;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,eAAe,EAAE,GAAG,MAAM,CAuCzE;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,eAAe,EAAE,GAAG,MAAM,CAuCvE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,eAAe,EAAE,GAAG,MAAM,CA+BrE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,eAAe,EAAE,GAAG,IAAI,CA4B7D"}

package/dist/benchmark/reporter.js

@@ -0,0 +1,147 @@
+/**
+ * Benchmark result reporter.
+ *
+ * Formats benchmark results for different output modes.
+ */
+/**
+ * Format metrics as a markdown table row.
+ */
+function formatMetricsRow(name, metrics, error) {
+    if (error) {
+        return `| ${name} | Error: ${error.slice(0, 50)}... | - | - | - | - |`;
+    }
+    if (!metrics) {
+        return `| ${name} | Skipped | - | - | - | - |`;
+    }
+    return `| ${name} | ${metrics.insertions} | ${metrics.deletions} | ${metrics.wallTimeMs.toFixed(1)}ms | ${metrics.peakRssMb.toFixed(1)}MB | ${(metrics.outputSizeBytes / 1024).toFixed(1)}KB |`;
+}
+/**
+ * Generate a markdown report from benchmark results.
+ */
+export function generateMarkdownReport(results) {
+    const lines = [];
+    lines.push('# Document Comparison Benchmark Results');
+    lines.push('');
+    lines.push(`Generated: ${new Date().toISOString()}`);
+    lines.push('');
+    for (const result of results) {
+        lines.push(`## Fixture: ${result.fixture}`);
+        lines.push('');
+        lines.push('| Baseline | Insertions | Deletions | Time | Memory | Output Size |');
+        lines.push('|----------|------------|-----------|------|--------|-------------|');
+        lines.push(formatMetricsRow('A (WmlComparer)', result.baselineA, result.baselineAError));
+        lines.push(formatMetricsRow('B (Pure TS)', result.baselineB, result.baselineBError));
+        if (result.wordOracle) {
+            lines.push(formatMetricsRow('Word Oracle', result.wordOracle));
+        }
+        lines.push('');
+    }
+    // Summary statistics
+    lines.push('## Summary');
+    lines.push('');
+    const successfulA = results.filter(r => r.baselineA !== null);
+    const successfulB = results.filter(r => r.baselineB !== null);
+    if (successfulA.length > 0) {
+        const avgTimeA = successfulA.reduce((sum, r) => sum + (r.baselineA?.wallTimeMs ?? 0), 0) / successfulA.length;
+        lines.push(`- Baseline A: ${successfulA.length}/${results.length} successful, avg time: ${avgTimeA.toFixed(1)}ms`);
+    }
+    if (successfulB.length > 0) {
+        const avgTimeB = successfulB.reduce((sum, r) => sum + (r.baselineB?.wallTimeMs ?? 0), 0) / successfulB.length;
+        lines.push(`- Baseline B: ${successfulB.length}/${results.length} successful, avg time: ${avgTimeB.toFixed(1)}ms`);
+    }
+    return lines.join('\n');
+}
+/**
+ * Generate a console table from benchmark results.
+ */
+export function generateConsoleTable(results) {
+    const lines = [];
+    // Header
+    lines.push('┌────────────────────────┬──────────┬─────────────┬─────────────┬──────────┬──────────┐');
+    lines.push('│ Fixture                │ Baseline │ Insertions  │ Deletions   │ Time     │ Memory   │');
+    lines.push('├────────────────────────┼──────────┼─────────────┼─────────────┼──────────┼──────────┤');
+    for (const result of results) {
+        const fixtureName = result.fixture.padEnd(22).slice(0, 22);
+        // Baseline A row
+        if (result.baselineAError) {
+            lines.push(`│ ${fixtureName} │ A        │ ERROR       │             │          │          │`);
+        }
+        else if (result.baselineA) {
+            const m = result.baselineA;
+            lines.push(`│ ${fixtureName} │ A        │ ${String(m.insertions).padStart(11)} │ ${String(m.deletions).padStart(11)} │ ${m.wallTimeMs.toFixed(0).padStart(6)}ms │ ${m.peakRssMb.toFixed(1).padStart(6)}MB │`);
+        }
+        // Baseline B row
+        if (result.baselineBError) {
+            lines.push(`│                        │ B        │ ERROR       │             │          │          │`);
+        }
+        else if (result.baselineB) {
+            const m = result.baselineB;
+            lines.push(`│                        │ B        │ ${String(m.insertions).padStart(11)} │ ${String(m.deletions).padStart(11)} │ ${m.wallTimeMs.toFixed(0).padStart(6)}ms │ ${m.peakRssMb.toFixed(1).padStart(6)}MB │`);
+        }
+        lines.push('├────────────────────────┼──────────┼─────────────┼─────────────┼──────────┼──────────┤');
+    }
+    // Remove last separator and add bottom border
+    lines.pop();
+    lines.push('└────────────────────────┴──────────┴─────────────┴─────────────┴──────────┴──────────┘');
+    return lines.join('\n');
+}
+/**
+ * Generate JSON output from benchmark results.
+ */
+export function generateJsonReport(results) {
+    return JSON.stringify({
+        timestamp: new Date().toISOString(),
+        results: results.map(r => ({
+            fixture: r.fixture,
+            timestamp: r.timestamp.toISOString(),
+            baselineA: r.baselineA
+                ? {
+                    success: true,
+                    ...r.baselineA,
+                }
+                : {
+                    success: false,
+                    error: r.baselineAError,
+                },
+            baselineB: r.baselineB
+                ? {
+                    success: true,
+                    ...r.baselineB,
+                }
+                : {
+                    success: false,
+                    error: r.baselineBError,
+                },
+            wordOracle: r.wordOracle ?? null,
+        })),
+    }, null, 2);
+}
+/**
+ * Print a comparison summary to console.
+ */
+export function printSummary(results) {
+    console.log('\n=== Benchmark Summary ===\n');
+    for (const result of results) {
+        console.log(`Fixture: ${result.fixture}`);
+        if (result.baselineA) {
+            console.log(`  Baseline A: ${result.baselineA.insertions} ins, ${result.baselineA.deletions} del, ${result.baselineA.wallTimeMs.toFixed(0)}ms`);
+        }
+        else if (result.baselineAError) {
+            console.log(`  Baseline A: Error - ${result.baselineAError}`);
+        }
+        else {
+            console.log('  Baseline A: Skipped');
+        }
+        if (result.baselineB) {
+            console.log(`  Baseline B: ${result.baselineB.insertions} ins, ${result.baselineB.deletions} del, ${result.baselineB.wallTimeMs.toFixed(0)}ms`);
+        }
+        else if (result.baselineBError) {
+            console.log(`  Baseline B: Error - ${result.baselineBError}`);
+        }
+        else {
+            console.log('  Baseline B: Skipped');
+        }
+        console.log('');
+    }
+}
+//# sourceMappingURL=reporter.js.map

package/dist/benchmark/reporter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reporter.js","sourceRoot":"","sources":["../../src/benchmark/reporter.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH;;GAEG;AACH,SAAS,gBAAgB,CACvB,IAAY,EACZ,OAAiC,EACjC,KAAc;IAEd,IAAI,KAAK,EAAE,CAAC;QACV,OAAO,KAAK,IAAI,aAAa,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,uBAAuB,CAAC;IACzE,CAAC;IACD,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,KAAK,IAAI,8BAA8B,CAAC;IACjD,CAAC;IAED,OAAO,KAAK,IAAI,MAAM,OAAO,CAAC,UAAU,MAAM,OAAO,CAAC,SAAS,MAAM,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC;AAClM,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,sBAAsB,CAAC,OAA0B;IAC/D,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,KAAK,CAAC,IAAI,CAAC,yCAAyC,CAAC,CAAC;IACtD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,cAAc,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;IACrD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,KAAK,CAAC,IAAI,CAAC,eAAe,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;QAC5C,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,qEAAqE,CAAC,CAAC;QAClF,KAAK,CAAC,IAAI,CAAC,qEAAqE,CAAC,CAAC;QAClF,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,iBAAiB,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,cAAc,CAAC,CAAC,CAAC;QACzF,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,aAAa,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,cAAc,CAAC,CAAC,CAAC;QACrF,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;YACtB,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,aAAa,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC;QACjE,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,qBAAqB;IACrB,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IACzB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,MAAM,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,KAAK,IAAI,CAAC,CAAC;IAC9D,MAAM,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,KAAK,IAAI,CAAC,CAAC;IAE9D,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC3B,MAAM,QAAQ,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,SAAS,EAAE,UAAU,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,WAAW,CAAC,MAAM,CAAC;QAC9G,KAAK,CAAC,IAAI,CAAC,iBAAiB,WAAW,CAAC,MAAM,IAAI,OAAO,CAAC,MAAM,0BAA0B,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IACrH,CAAC;IAED,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC3B,MAAM,QAAQ,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,SAAS,EAAE,UAAU,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,WAAW,CAAC,MAAM,CAAC;QAC9G,KAAK,CAAC,IAAI,CAAC,iBAAiB,WAAW,CAAC,MAAM,IAAI,OAAO,CAAC,MAAM,0BAA0B,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IACrH,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,OAA0B;IAC7D,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,SAAS;IACT,KAAK,CAAC,IAAI,CAAC,yFAAyF,CAAC,CAAC;IACtG,KAAK,CAAC,IAAI,CAAC,yFAAyF,CAAC,CAAC;IACtG,KAAK,CAAC,IAAI,CAAC,yFAAyF,CAAC,CAAC;IAEtG,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,MAAM,WAAW,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAE3D,iBAAiB;QACjB,IAAI,MAAM,CAAC,cAAc,EAAE,CAAC;YAC1B,KAAK,CAAC,IAAI,CAAC,KAAK,WAAW,iEAAiE,CAAC,CAAC;QAChG,CAAC;aAAM,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;YAC5B,MAAM,CAAC,GAAG,MAAM,CAAC,SAAS,CAAC;YAC3B,KAAK,CAAC,IAAI,CACR,KAAK,WAAW,iBAAiB,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,MAAM,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAClM,CAAC;QACJ,CAAC;QAED,iBAAiB;QACjB,IAAI,MAAM,CAAC,cAAc,EAAE,CAAC;YAC1B,KAAK,CAAC,IAAI,CAAC,yFAAyF,CAAC,CAAC;QACxG,CAAC;aAAM,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;YAC5B,MAAM,CAAC,GAAG,MAAM,CAAC,SAAS,CAAC;YAC3B,KAAK,CAAC,IAAI,CACR,yCAAyC,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,MAAM,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAC1M,CAAC;QACJ,CAAC;QAED,KAAK,CAAC,IAAI,CAAC,yFAAyF,CAAC,CAAC;IACxG,CAAC;IAED,8CAA8C;IAC9C,KAAK,CAAC,GAAG,EAAE,CAAC;IACZ,KAAK,CAAC,IAAI,CAAC,yFAAyF,CAAC,CAAC;IAEtG,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAA0B;IAC3D,OAAO,IAAI,CAAC,SAAS,CACnB;QACE,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACnC,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YACzB,OAAO,EAAE,CAAC,CAAC,OAAO;YAClB,SAAS,EAAE,CAAC,CAAC,SAAS,CAAC,WAAW,EAAE;YACpC,SAAS,EAAE,CAAC,CAAC,SAAS;gBACpB,CAAC,CAAC;oBACE,OAAO,EAAE,IAAI;oBACb,GAAG,CAAC,CAAC,SAAS;iBACf;gBACH,CAAC,CAAC;oBACE,OAAO,EAAE,KAAK;oBACd,KAAK,EAAE,CAAC,CAAC,cAAc;iBACxB;YACL,SAAS,EAAE,CAAC,CAAC,SAAS;gBACpB,CAAC,CAAC;oBACE,OAAO,EAAE,IAAI;oBACb,GAAG,CAAC,CAAC,SAAS;iBACf;gBACH,CAAC,CAAC;oBACE,OAAO,EAAE,KAAK;oBACd,KAAK,EAAE,CAAC,CAAC,cAAc;iBACxB;YACL,UAAU,EAAE,CAAC,CAAC,UAAU,IAAI,IAAI;SACjC,CAAC,CAAC;KACJ,EACD,IAAI,EACJ,CAAC,CACF,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,OAA0B;IACrD,OAAO,CAAC,GAAG,CAAC,+BAA+B,CAAC,CAAC;IAE7C,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,OAAO,CAAC,GAAG,CAAC,YAAY,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;QAE1C,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;YACrB,OAAO,CAAC,GAAG,CACT,iBAAiB,MAAM,CAAC,SAAS,CAAC,UAAU,SAAS,MAAM,CAAC,SAAS,CAAC,SAAS,SAAS,MAAM,CAAC,SAAS,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CACnI,CAAC;QACJ,CAAC;aAAM,IAAI,MAAM,CAAC,cAAc,EAAE,CAAC;YACjC,OAAO,CAAC,GAAG,CAAC,yBAAyB,MAAM,CAAC,cAAc,EAAE,CAAC,CAAC;QAChE,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAC;QACvC,CAAC;QAED,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;YACrB,OAAO,CAAC,GAAG,CACT,iBAAiB,MAAM,CAAC,SAAS,CAAC,UAAU,SAAS,MAAM,CAAC,SAAS,CAAC,SAAS,SAAS,MAAM,CAAC,SAAS,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CACnI,CAAC;QACJ,CAAC;aAAM,IAAI,MAAM,CAAC,cAAc,EAAE,CAAC;YACjC,OAAO,CAAC,GAAG,CAAC,yBAAyB,MAAM,CAAC,cAAc,EAAE,CAAC,CAAC;QAChE,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAC;QACvC,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAClB,CAAC;AACH,CAAC"}

package/dist/benchmark/runner.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Benchmark runner for A/B baseline comparison.
+ *
+ * Runs both baselines against test fixtures and collects metrics.
+ */
+import type { BenchmarkResult } from './metrics.js';
+/**
+ * Configuration for benchmark runs.
+ */
+export interface BenchmarkConfig {
+    /** Path to fixtures directory */
+    fixturesPath: string;
+    /** Author name for revisions */
+    author?: string;
+    /** Path to Docxodus repository (for CLI fallback) */
+    docxodusPath?: string;
+    /** Path to dotnet executable (e.g., /opt/homebrew/opt/dotnet@8/bin/dotnet) */
+    dotnetPath?: string;
+    /** Run Baseline A (WmlComparer) */
+    runBaselineA?: boolean;
+    /** Run Baseline B (pure TS) */
+    runBaselineB?: boolean;
+    /** Timeout for each comparison in ms */
+    timeout?: number;
+}
+/**
+ * Run benchmark on all fixtures.
+ */
+export declare function runBenchmark(config: BenchmarkConfig): Promise<BenchmarkResult[]>;
+//# sourceMappingURL=runner.d.ts.map

package/dist/benchmark/runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../src/benchmark/runner.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EACV,eAAe,EAEhB,MAAM,cAAc,CAAC;AAUtB;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,iCAAiC;IACjC,YAAY,EAAE,MAAM,CAAC;IACrB,gCAAgC;IAChC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qDAAqD;IACrD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,8EAA8E;IAC9E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,mCAAmC;IACnC,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,+BAA+B;IAC/B,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,wCAAwC;IACxC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AA+KD;;GAEG;AACH,wBAAsB,YAAY,CAChC,MAAM,EAAE,eAAe,GACtB,OAAO,CAAC,eAAe,EAAE,CAAC,CAoC5B"}