@usejunior/docx-core 0.9.1 → 0.10.0

package/dist/baselines/atomizer/formattingFidelity.d.ts

@@ -0,0 +1,99 @@
+/**
+ * Formatting-Fidelity Comparison Check
+ *
+ * Deterministic, in-engine measurement of formatting divergence between two
+ * word/document.xml views (e.g. inplace candidate vs rebuild candidate, or
+ * candidate vs expected). Both existing safety oracles are formatting-blind:
+ * the round-trip oracle compares text projections and the LibreOffice
+ * oracle's paragraphShape() records only paragraph count + visible-text
+ * presence — so rebuild mode's formatting loss passes every current gate
+ * silently. This module quantifies that loss and gates inplace fixes.
+ *
+ * Alignment strategy: paragraphs are aligned by their visible text content
+ * (LCS over paragraph texts), then run formatting is compared character by
+ * character within each aligned pair. Comparing per character — not per run —
+ * makes the check agnostic to run splits, which rebuild and inplace
+ * legitimately produce differently. Content divergence is the text oracle's
+ * job and is reported separately as alignment coverage, not folded into the
+ * formatting tallies.
+ *
+ * LibreOffice is deliberately not involved: it rewrites formatting on
+ * load/save (adds default w:pPr/w:rPr), so it cannot serve as a formatting
+ * oracle. This comparison runs entirely over our own emitted XML.
+ *
+ * @see https://github.com/UseJunior/safe-docx/issues/363
+ */
+export type FormattingScope = 'run' | 'paragraph' | 'table' | 'section';
+export type FormattingDivergenceKind = 'added' | 'removed' | 'changed';
+export interface FormattingDivergence {
+    scope: FormattingScope;
+    /** Friendly property name when known (e.g. "bold"), else the OOXML tag. */
+    property: string;
+    /** "added"/"removed" are relative to the expected view. */
+    kind: FormattingDivergenceKind;
+    /** Canonical serialization of the property in the expected view. */
+    expectedValue: string | null;
+    /** Canonical serialization of the property in the actual view. */
+    actualValue: string | null;
+    /**
+     * Document-order paragraph index in the expected view, or -1 for
+     * section-scope divergences (section breaks are aligned by index, not
+     * anchored to a paragraph).
+     */
+    paragraphIndex: number;
+    /** Aligned text the divergence applies to (truncated). */
+    textSample: string;
+}
+export interface FormattingDimensionTally {
+    /** Units compared: chars (run), paragraphs (paragraph/table), section breaks (section). */
+    compared: number;
+    divergent: number;
+    /** (compared - divergent) / compared; 1 when nothing was compared. */
+    score: number;
+}
+export interface FormattingFidelityReport {
+    /**
+     * Alignment coverage × mean of the dimension scores that compared at
+     * least one unit. Exactly 1.0 iff content aligned fully and no formatting
+     * diverged, so the score doubles as an exact-preservation gate.
+     */
+    score: number;
+    /** Character-weighted w:rPr comparison over aligned paragraph text. */
+    runFormatting: FormattingDimensionTally;
+    /** Per-paragraph w:pPr comparison (w:sectPr handled by the section dimension). */
+    paragraphFormatting: FormattingDimensionTally;
+    /** Per-paragraph w:tblPr/w:trPr/w:tcPr chain comparison for paragraphs inside tables. */
+    tableFormatting: FormattingDimensionTally;
+    /** Per-section-break w:sectPr comparison, aligned by document-order index. */
+    sectionFormatting: FormattingDimensionTally;
+    /** Paragraphs whose text could not be content-aligned (content divergence, not formatting). */
+    unalignedExpectedParagraphs: number;
+    unalignedActualParagraphs: number;
+    divergences: FormattingDivergence[];
+}
+/**
+ * Compare the formatting carried by two word/document.xml views.
+ *
+ * The views are expected to hold comparable content (e.g. two reconstruction
+ * candidates for the same comparison, or the same projection of each); use
+ * compareProjectedFormattingFidelity to compare tracked-changes candidates
+ * whose revision-markup granularity may differ.
+ */
+export declare function compareFormattingFidelity(expectedDocumentXml: string, actualDocumentXml: string): FormattingFidelityReport;
+export interface ProjectedFormattingFidelity {
+    /** Fidelity of accept-all(actual) measured against accept-all(expected). */
+    accept: FormattingFidelityReport;
+    /** Fidelity of reject-all(actual) measured against reject-all(expected). */
+    reject: FormattingFidelityReport;
+    /** min(accept.score, reject.score) — a candidate must preserve both projections. */
+    score: number;
+}
+/**
+ * Compare two tracked-changes candidates projection-to-projection, the same
+ * stance the round-trip text oracle adopted in #347: accept-all and
+ * reject-all projections strip revision markup, so candidates that encode
+ * the same result with different w:ins/w:del granularity score 1.0 unless
+ * their formatting actually diverges.
+ */
+export declare function compareProjectedFormattingFidelity(expectedCandidateXml: string, actualCandidateXml: string): ProjectedFormattingFidelity;
+//# sourceMappingURL=formattingFidelity.d.ts.map

package/dist/baselines/atomizer/formattingFidelity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formattingFidelity.d.ts","sourceRoot":"","sources":["../../../src/baselines/atomizer/formattingFidelity.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAYH,MAAM,MAAM,eAAe,GAAG,KAAK,GAAG,WAAW,GAAG,OAAO,GAAG,SAAS,CAAC;AAExE,MAAM,MAAM,wBAAwB,GAAG,OAAO,GAAG,SAAS,GAAG,SAAS,CAAC;AAEvE,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,eAAe,CAAC;IACvB,2EAA2E;IAC3E,QAAQ,EAAE,MAAM,CAAC;IACjB,2DAA2D;IAC3D,IAAI,EAAE,wBAAwB,CAAC;IAC/B,oEAAoE;IACpE,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,kEAAkE;IAClE,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B;;;;OAIG;IACH,cAAc,EAAE,MAAM,CAAC;IACvB,0DAA0D;IAC1D,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,wBAAwB;IACvC,2FAA2F;IAC3F,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,sEAAsE;IACtE,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,wBAAwB;IACvC;;;;OAIG;IACH,KAAK,EAAE,MAAM,CAAC;IACd,uEAAuE;IACvE,aAAa,EAAE,wBAAwB,CAAC;IACxC,kFAAkF;IAClF,mBAAmB,EAAE,wBAAwB,CAAC;IAC9C,yFAAyF;IACzF,eAAe,EAAE,wBAAwB,CAAC;IAC1C,8EAA8E;IAC9E,iBAAiB,EAAE,wBAAwB,CAAC;IAC5C,+FAA+F;IAC/F,2BAA2B,EAAE,MAAM,CAAC;IACpC,yBAAyB,EAAE,MAAM,CAAC;IAClC,WAAW,EAAE,oBAAoB,EAAE,CAAC;CACrC;AAidD;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CACvC,mBAAmB,EAAE,MAAM,EAC3B,iBAAiB,EAAE,MAAM,GACxB,wBAAwB,CAqC1B;AAMD,MAAM,WAAW,2BAA2B;IAC1C,4EAA4E;IAC5E,MAAM,EAAE,wBAAwB,CAAC;IACjC,4EAA4E;IAC5E,MAAM,EAAE,wBAAwB,CAAC;IACjC,oFAAoF;IACpF,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;;;GAMG;AACH,wBAAgB,kCAAkC,CAChD,oBAAoB,EAAE,MAAM,EAC5B,kBAAkB,EAAE,MAAM,GACzB,2BAA2B,CAU7B"}

package/dist/baselines/atomizer/formattingFidelity.js

@@ -0,0 +1,449 @@
+/**
+ * Formatting-Fidelity Comparison Check
+ *
+ * Deterministic, in-engine measurement of formatting divergence between two
+ * word/document.xml views (e.g. inplace candidate vs rebuild candidate, or
+ * candidate vs expected). Both existing safety oracles are formatting-blind:
+ * the round-trip oracle compares text projections and the LibreOffice
+ * oracle's paragraphShape() records only paragraph count + visible-text
+ * presence — so rebuild mode's formatting loss passes every current gate
+ * silently. This module quantifies that loss and gates inplace fixes.
+ *
+ * Alignment strategy: paragraphs are aligned by their visible text content
+ * (LCS over paragraph texts), then run formatting is compared character by
+ * character within each aligned pair. Comparing per character — not per run —
+ * makes the check agnostic to run splits, which rebuild and inplace
+ * legitimately produce differently. Content divergence is the text oracle's
+ * job and is reported separately as alignment coverage, not folded into the
+ * formatting tallies.
+ *
+ * LibreOffice is deliberately not involved: it rewrites formatting on
+ * load/save (adds default w:pPr/w:rPr), so it cannot serve as a formatting
+ * oracle. This comparison runs entirely over our own emitted XML.
+ *
+ * @see https://github.com/UseJunior/safe-docx/issues/363
+ */
+import { parseDocumentXml } from './xmlToWmlElement.js';
+import { acceptAllChanges, rejectAllChanges } from './trackChangesAcceptorAst.js';
+import { childElements, findChildByTagName } from '../../primitives/index.js';
+import { RUN_PROPERTY_FRIENDLY_NAMES } from '../../core-types.js';
+import { PARAGRAPH_PROPERTY_FRIENDLY_NAMES } from '../../format-detection.js';
+// =============================================================================
+// Canonical property keys
+// =============================================================================
+/**
+ * Revision-tracking elements excluded from canonicalization at every depth.
+ * Two views that differ only in tracked-change provenance markup carry the
+ * same formatting.
+ */
+const REVISION_PROPERTY_TAGS = new Set([
+    'w:rPrChange',
+    'w:pPrChange',
+    'w:tblPrChange',
+    'w:trPrChange',
+    'w:tcPrChange',
+    'w:sectPrChange',
+    'w:ins',
+    'w:del',
+    'w:cellIns',
+    'w:cellDel',
+    'w:cellMerge',
+]);
+/** w:sectPr inside w:pPr is a section break — owned by the section dimension. */
+const PPR_EXCLUDED_TAGS = new Set([...REVISION_PROPERTY_TAGS, 'w:sectPr']);
+/**
+ * Canonical serialization: sorted attributes, children sorted by their own
+ * canonical form, revision markup dropped. A comparison key, not output XML —
+ * sorting trades element-order semantics for emitter-order independence.
+ * Namespace declarations (`xmlns`, `xmlns:*`) are skipped: they record where
+ * a prefix is bound, not formatting, and emitters legitimately declare the
+ * same binding at different depths (inline vs inherited from the root).
+ */
+function canonicalizeElement(el) {
+    const attrs = [];
+    for (let i = 0; i < el.attributes.length; i++) {
+        const attr = el.attributes[i];
+        if (attr.name === 'xmlns' || attr.name.startsWith('xmlns:'))
+            continue;
+        attrs.push(`${attr.name}="${attr.value}"`);
+    }
+    attrs.sort();
+    const attrPart = attrs.length > 0 ? ` ${attrs.join(' ')}` : '';
+    const children = childElements(el)
+        .filter((child) => !REVISION_PROPERTY_TAGS.has(child.tagName))
+        .map(canonicalizeElement)
+        .sort();
+    if (children.length === 0) {
+        const text = (el.textContent ?? '').trim();
+        return text.length > 0
+            ? `<${el.tagName}${attrPart}>${text}</${el.tagName}>`
+            : `<${el.tagName}${attrPart}/>`;
+    }
+    return `<${el.tagName}${attrPart}>${children.join('')}</${el.tagName}>`;
+}
+/**
+ * Map of property tag → canonical serialization for the direct children of a
+ * property container (w:rPr, w:pPr, w:tcPr, ...). Repeated tags are merged
+ * into one sorted entry. An absent container equals an empty one.
+ */
+function propertyMap(container, excludedTags) {
+    const collected = new Map();
+    if (container) {
+        for (const child of childElements(container)) {
+            if (excludedTags.has(child.tagName))
+                continue;
+            const existing = collected.get(child.tagName);
+            if (existing)
+                existing.push(canonicalizeElement(child));
+            else
+                collected.set(child.tagName, [canonicalizeElement(child)]);
+        }
+    }
+    const merged = new Map();
+    for (const [tag, values] of collected) {
+        merged.set(tag, values.sort().join(''));
+    }
+    return merged;
+}
+function containerKey(props) {
+    return [...props.keys()]
+        .sort()
+        .map((tag) => props.get(tag))
+        .join('');
+}
+function diffPropertyMaps(expected, actual, friendlyNames) {
+    const diffs = [];
+    const allTags = [...new Set([...expected.keys(), ...actual.keys()])].sort();
+    for (const tag of allTags) {
+        const expectedValue = expected.get(tag);
+        const actualValue = actual.get(tag);
+        if (expectedValue === actualValue)
+            continue;
+        diffs.push({
+            property: friendlyNames[tag] ?? tag,
+            kind: expectedValue === undefined
+                ? 'added'
+                : actualValue === undefined
+                    ? 'removed'
+                    : 'changed',
+            expectedValue: expectedValue ?? null,
+            actualValue: actualValue ?? null,
+        });
+    }
+    return diffs;
+}
+function tableLevelKey(level) {
+    return [
+        containerKey(propertyMap(level.tblPr, REVISION_PROPERTY_TAGS)),
+        containerKey(propertyMap(level.trPr, REVISION_PROPERTY_TAGS)),
+        containerKey(propertyMap(level.tcPr, REVISION_PROPERTY_TAGS)),
+    ].join('§');
+}
+function collectRunText(el, currentRPrKey, currentRPr, unit) {
+    for (const child of childElements(el)) {
+        if (child.tagName === 'w:pPr')
+            continue;
+        if (child.tagName === 'w:r') {
+            const rPr = findChildByTagName(child, 'w:rPr');
+            const key = containerKey(propertyMap(rPr, REVISION_PROPERTY_TAGS));
+            collectRunText(child, key, rPr, unit);
+            continue;
+        }
+        if (child.tagName === 'w:t' || child.tagName === 'w:delText') {
+            const text = child.textContent ?? '';
+            unit.text += text;
+            for (let i = 0; i < text.length; i++) {
+                unit.charRPrKeys.push(currentRPrKey);
+                unit.charRPrElements.push(currentRPr);
+            }
+            continue;
+        }
+        // Recurse through revision wrappers, hyperlinks, smart tags, sdt, ...
+        collectRunText(child, currentRPrKey, currentRPr, unit);
+    }
+}
+function buildParagraphUnit(paragraph, chain, index) {
+    const pPr = findChildByTagName(paragraph, 'w:pPr');
+    const pPrProps = propertyMap(pPr, PPR_EXCLUDED_TAGS);
+    const unit = {
+        index,
+        text: '',
+        charRPrKeys: [],
+        charRPrElements: [],
+        pPrProps,
+        pPrKey: containerKey(pPrProps),
+        tableChain: chain,
+        tableKey: chain.map(tableLevelKey).join('|'),
+    };
+    collectRunText(paragraph, '', null, unit);
+    return unit;
+}
+function collectParagraphUnits(container, chain, out) {
+    for (const child of childElements(container)) {
+        if (child.tagName === 'w:p') {
+            out.push(buildParagraphUnit(child, chain, out.length));
+            continue;
+        }
+        if (child.tagName === 'w:tbl') {
+            const tblPr = findChildByTagName(child, 'w:tblPr');
+            for (const row of childElements(child)) {
+                if (row.tagName !== 'w:tr')
+                    continue;
+                const trPr = findChildByTagName(row, 'w:trPr');
+                for (const cell of childElements(row)) {
+                    if (cell.tagName !== 'w:tc')
+                        continue;
+                    const tcPr = findChildByTagName(cell, 'w:tcPr');
+                    collectParagraphUnits(cell, [...chain, { tblPr, trPr, tcPr }], out);
+                }
+            }
+            continue;
+        }
+        // Recurse through sdt/customXml/revision wrappers that can hold blocks.
+        collectParagraphUnits(child, chain, out);
+    }
+}
+function collectSectionProperties(root) {
+    const out = [];
+    const walk = (el) => {
+        for (const child of childElements(el)) {
+            if (child.tagName === 'w:sectPr') {
+                out.push(child);
+                continue;
+            }
+            walk(child);
+        }
+    };
+    walk(root);
+    return out;
+}
+// =============================================================================
+// Content alignment
+// =============================================================================
+/**
+ * LCS over paragraph texts. O(n·m) — fine for a measurement/gate tool, not
+ * intended for hot paths.
+ */
+function alignParagraphsByText(expected, actual) {
+    if (expected.length === actual.length &&
+        expected.every((unit, i) => unit.text === actual[i].text)) {
+        return expected.map((unit, i) => [unit, actual[i]]);
+    }
+    const n = expected.length;
+    const m = actual.length;
+    const table = new Array((n + 1) * (m + 1)).fill(0);
+    const at = (i, j) => i * (m + 1) + j;
+    for (let i = n - 1; i >= 0; i--) {
+        for (let j = m - 1; j >= 0; j--) {
+            table[at(i, j)] =
+                expected[i].text === actual[j].text
+                    ? table[at(i + 1, j + 1)] + 1
+                    : Math.max(table[at(i + 1, j)], table[at(i, j + 1)]);
+        }
+    }
+    const pairs = [];
+    let i = 0;
+    let j = 0;
+    while (i < n && j < m) {
+        if (expected[i].text === actual[j].text) {
+            pairs.push([expected[i], actual[j]]);
+            i++;
+            j++;
+        }
+        else if (table[at(i + 1, j)] >= table[at(i, j + 1)]) {
+            i++;
+        }
+        else {
+            j++;
+        }
+    }
+    return pairs;
+}
+// =============================================================================
+// Comparison
+// =============================================================================
+const TEXT_SAMPLE_LIMIT = 80;
+function sampleText(text) {
+    return text.length > TEXT_SAMPLE_LIMIT ? `${text.slice(0, TEXT_SAMPLE_LIMIT)}…` : text;
+}
+function makeTally(compared, divergent) {
+    return {
+        compared,
+        divergent,
+        score: compared === 0 ? 1 : (compared - divergent) / compared,
+    };
+}
+function compareRunFormatting(pairs, divergences) {
+    let compared = 0;
+    let divergent = 0;
+    for (const [expected, actual] of pairs) {
+        compared += expected.text.length;
+        let rangeStart = -1;
+        const flushRange = (end) => {
+            if (rangeStart < 0)
+                return;
+            const diffs = diffPropertyMaps(propertyMap(expected.charRPrElements[rangeStart] ?? null, REVISION_PROPERTY_TAGS), propertyMap(actual.charRPrElements[rangeStart] ?? null, REVISION_PROPERTY_TAGS), RUN_PROPERTY_FRIENDLY_NAMES);
+            const textSample = sampleText(expected.text.slice(rangeStart, end));
+            for (const diff of diffs) {
+                divergences.push({
+                    scope: 'run',
+                    paragraphIndex: expected.index,
+                    textSample,
+                    ...diff,
+                });
+            }
+            rangeStart = -1;
+        };
+        for (let i = 0; i < expected.text.length; i++) {
+            if (expected.charRPrKeys[i] === actual.charRPrKeys[i]) {
+                flushRange(i);
+                continue;
+            }
+            divergent++;
+            // Coalesce contiguous chars with the same key pair into one report range.
+            if (rangeStart >= 0 &&
+                (expected.charRPrKeys[i] !== expected.charRPrKeys[rangeStart] ||
+                    actual.charRPrKeys[i] !== actual.charRPrKeys[rangeStart])) {
+                flushRange(i);
+            }
+            if (rangeStart < 0)
+                rangeStart = i;
+        }
+        flushRange(expected.text.length);
+    }
+    return makeTally(compared, divergent);
+}
+function compareParagraphFormatting(pairs, divergences) {
+    let divergent = 0;
+    for (const [expected, actual] of pairs) {
+        if (expected.pPrKey === actual.pPrKey)
+            continue;
+        divergent++;
+        for (const diff of diffPropertyMaps(expected.pPrProps, actual.pPrProps, PARAGRAPH_PROPERTY_FRIENDLY_NAMES)) {
+            divergences.push({
+                scope: 'paragraph',
+                paragraphIndex: expected.index,
+                textSample: sampleText(expected.text),
+                ...diff,
+            });
+        }
+    }
+    return makeTally(pairs.length, divergent);
+}
+function compareTableFormatting(pairs, divergences) {
+    let compared = 0;
+    let divergent = 0;
+    for (const [expected, actual] of pairs) {
+        if (expected.tableChain.length === 0 && actual.tableChain.length === 0)
+            continue;
+        compared++;
+        if (expected.tableKey === actual.tableKey)
+            continue;
+        divergent++;
+        if (expected.tableChain.length !== actual.tableChain.length) {
+            divergences.push({
+                scope: 'table',
+                property: 'tableNesting',
+                kind: 'changed',
+                expectedValue: String(expected.tableChain.length),
+                actualValue: String(actual.tableChain.length),
+                paragraphIndex: expected.index,
+                textSample: sampleText(expected.text),
+            });
+            continue;
+        }
+        for (let level = 0; level < expected.tableChain.length; level++) {
+            const expectedLevel = expected.tableChain[level];
+            const actualLevel = actual.tableChain[level];
+            const containers = [
+                [expectedLevel.tblPr, actualLevel.tblPr],
+                [expectedLevel.trPr, actualLevel.trPr],
+                [expectedLevel.tcPr, actualLevel.tcPr],
+            ];
+            for (const [expectedContainer, actualContainer] of containers) {
+                for (const diff of diffPropertyMaps(propertyMap(expectedContainer, REVISION_PROPERTY_TAGS), propertyMap(actualContainer, REVISION_PROPERTY_TAGS), {})) {
+                    divergences.push({
+                        scope: 'table',
+                        paragraphIndex: expected.index,
+                        textSample: sampleText(expected.text),
+                        ...diff,
+                    });
+                }
+            }
+        }
+    }
+    return makeTally(compared, divergent);
+}
+function compareSectionFormatting(expectedRoot, actualRoot, divergences) {
+    const expectedSections = collectSectionProperties(expectedRoot);
+    const actualSections = collectSectionProperties(actualRoot);
+    const compared = Math.max(expectedSections.length, actualSections.length);
+    let divergent = 0;
+    for (let i = 0; i < compared; i++) {
+        const expectedProps = propertyMap(expectedSections[i] ?? null, REVISION_PROPERTY_TAGS);
+        const actualProps = propertyMap(actualSections[i] ?? null, REVISION_PROPERTY_TAGS);
+        if (containerKey(expectedProps) === containerKey(actualProps))
+            continue;
+        divergent++;
+        for (const diff of diffPropertyMaps(expectedProps, actualProps, {})) {
+            divergences.push({
+                scope: 'section',
+                paragraphIndex: -1,
+                textSample: '',
+                ...diff,
+            });
+        }
+    }
+    return makeTally(compared, divergent);
+}
+/**
+ * Compare the formatting carried by two word/document.xml views.
+ *
+ * The views are expected to hold comparable content (e.g. two reconstruction
+ * candidates for the same comparison, or the same projection of each); use
+ * compareProjectedFormattingFidelity to compare tracked-changes candidates
+ * whose revision-markup granularity may differ.
+ */
+export function compareFormattingFidelity(expectedDocumentXml, actualDocumentXml) {
+    const expectedRoot = parseDocumentXml(expectedDocumentXml);
+    const actualRoot = parseDocumentXml(actualDocumentXml);
+    const expectedUnits = [];
+    const actualUnits = [];
+    collectParagraphUnits(expectedRoot, [], expectedUnits);
+    collectParagraphUnits(actualRoot, [], actualUnits);
+    const pairs = alignParagraphsByText(expectedUnits, actualUnits);
+    const divergences = [];
+    const runFormatting = compareRunFormatting(pairs, divergences);
+    const paragraphFormatting = compareParagraphFormatting(pairs, divergences);
+    const tableFormatting = compareTableFormatting(pairs, divergences);
+    const sectionFormatting = compareSectionFormatting(expectedRoot, actualRoot, divergences);
+    const totalParagraphs = expectedUnits.length + actualUnits.length;
+    const alignmentCoverage = totalParagraphs === 0 ? 1 : (2 * pairs.length) / totalParagraphs;
+    const dimensions = [runFormatting, paragraphFormatting, tableFormatting, sectionFormatting].filter((dimension) => dimension.compared > 0);
+    const dimensionScore = dimensions.length === 0
+        ? 1
+        : dimensions.reduce((sum, dimension) => sum + dimension.score, 0) / dimensions.length;
+    return {
+        score: alignmentCoverage * dimensionScore,
+        runFormatting,
+        paragraphFormatting,
+        tableFormatting,
+        sectionFormatting,
+        unalignedExpectedParagraphs: expectedUnits.length - pairs.length,
+        unalignedActualParagraphs: actualUnits.length - pairs.length,
+        divergences,
+    };
+}
+/**
+ * Compare two tracked-changes candidates projection-to-projection, the same
+ * stance the round-trip text oracle adopted in #347: accept-all and
+ * reject-all projections strip revision markup, so candidates that encode
+ * the same result with different w:ins/w:del granularity score 1.0 unless
+ * their formatting actually diverges.
+ */
+export function compareProjectedFormattingFidelity(expectedCandidateXml, actualCandidateXml) {
+    const accept = compareFormattingFidelity(acceptAllChanges(expectedCandidateXml), acceptAllChanges(actualCandidateXml));
+    const reject = compareFormattingFidelity(rejectAllChanges(expectedCandidateXml), rejectAllChanges(actualCandidateXml));
+    return { accept, reject, score: Math.min(accept.score, reject.score) };
+}
+//# sourceMappingURL=formattingFidelity.js.map

package/dist/baselines/atomizer/formattingFidelity.js.map

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

package/dist/baselines/atomizer/inPlaceModifier-bookmarks.d.ts

@@ -0,0 +1,37 @@
+/**
+ * In-Place AST Modifier
+ *
+ * Modifies the revised document's AST in-place to add track changes markup.
+ * This replaces the reconstruction-based approach with direct tree manipulation.
+ */
+import { type RevisionIdState } from './inPlaceModifier-shared.js';
+export interface ParagraphBoundaryBookmarkMarkers {
+    leading: Element[];
+    trailing: Element[];
+    sourceLeading: Element[];
+    sourceTrailing: Element[];
+}
+export declare function cloneParagraphBoundaryBookmarkMarkers(sourceParagraph: Element | undefined): ParagraphBoundaryBookmarkMarkers;
+export declare function insertLeadingMarkers(paragraph: Element, markers: Element[]): Element | null;
+export type BookmarkMarkerTag = 'w:bookmarkStart' | 'w:bookmarkEnd';
+export declare function isBookmarkMarkerTag(tagName: string): tagName is BookmarkMarkerTag;
+/**
+ * Collect direct paragraph bookmark markers adjacent to a source run.
+ *
+ * Markers between runs (or at paragraph boundaries) are represented as siblings
+ * of w:r under w:p. We clone nearby markers so reconstructed deleted/moveFrom
+ * fragments preserve bookmark names/IDs needed for Reject All parity.
+ */
+export declare function collectAdjacentSourceBookmarkMarkers(sourceRun: Element): Element[];
+export interface BookmarkSurvivalContext {
+    isParagraphRemovedOnReject?: (paragraph: Element) => boolean;
+}
+export declare function markerSurvivesReject(marker: Element, context?: BookmarkSurvivalContext): boolean;
+export declare function targetTreeHasEquivalentBookmarkMarker(targetParagraph: Element, marker: Element, context?: BookmarkSurvivalContext): boolean;
+export declare function cloneUnemittedSourceBookmarkMarkers(sourceRun: Element, targetParagraph: Element, state: RevisionIdState, context?: BookmarkSurvivalContext): Element[];
+export declare function insertMarkersBeforeWrapper(wrapper: Element, markers: Element[]): void;
+export declare function filterEquivalentBookmarkMarkers(markers: Element[], targetNode: Element, context?: BookmarkSurvivalContext): Element[];
+/**
+ * Track change wrapper tag names.
+ */
+//# sourceMappingURL=inPlaceModifier-bookmarks.d.ts.map

package/dist/baselines/atomizer/inPlaceModifier-bookmarks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inPlaceModifier-bookmarks.d.ts","sourceRoot":"","sources":["../../../src/baselines/atomizer/inPlaceModifier-bookmarks.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAKL,KAAK,eAAe,EACrB,MAAM,6BAA6B,CAAC;AAErC,MAAM,WAAW,gCAAgC;IAC/C,OAAO,EAAE,OAAO,EAAE,CAAC;IACnB,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,aAAa,EAAE,OAAO,EAAE,CAAC;IACzB,cAAc,EAAE,OAAO,EAAE,CAAC;CAC3B;AAED,wBAAgB,qCAAqC,CACnD,eAAe,EAAE,OAAO,GAAG,SAAS,GACnC,gCAAgC,CAwClC;AAED,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,OAAO,EAClB,OAAO,EAAE,OAAO,EAAE,GACjB,OAAO,GAAG,IAAI,CAiBhB;AAED,MAAM,MAAM,iBAAiB,GAAG,iBAAiB,GAAG,eAAe,CAAC;AAEpE,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,IAAI,iBAAiB,CAEjF;AAED;;;;;;GAMG;AACH,wBAAgB,oCAAoC,CAAC,SAAS,EAAE,OAAO,GAAG,OAAO,EAAE,CAiClF;AAGD,MAAM,WAAW,uBAAuB;IACtC,0BAA0B,CAAC,EAAE,CAAC,SAAS,EAAE,OAAO,KAAK,OAAO,CAAC;CAC9D;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,uBAAuB,GAAG,OAAO,CAgBhG;AAED,wBAAgB,qCAAqC,CACnD,eAAe,EAAE,OAAO,EACxB,MAAM,EAAE,OAAO,EACf,OAAO,CAAC,EAAE,uBAAuB,GAChC,OAAO,CA8BT;AAED,wBAAgB,mCAAmC,CACjD,SAAS,EAAE,OAAO,EAClB,eAAe,EAAE,OAAO,EACxB,KAAK,EAAE,eAAe,EACtB,OAAO,CAAC,EAAE,uBAAuB,GAChC,OAAO,EAAE,CAoBX;AAED,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,IAAI,CAOrF;AAED,wBAAgB,+BAA+B,CAC7C,OAAO,EAAE,OAAO,EAAE,EAClB,UAAU,EAAE,OAAO,EACnB,OAAO,CAAC,EAAE,uBAAuB,GAChC,OAAO,EAAE,CAEX;AAED;;GAEG"}