@usejunior/docx-core 0.15.0 → 0.17.0

package/dist/format-detection.js

@@ -1,339 +0,0 @@
-/**
- * Format Change Detection Module
- *
- * Detects formatting changes (bold, italic, font size, etc.) between
- * documents after LCS comparison. Runs on atoms marked as Equal to
- * identify text that matches but has different formatting.
- *
- * Pipeline position:
- * LCS() → FlattenToAtomList() → detectMovesInAtomList() → detectFormatChangesInAtomList() → CoalesceRecurse()
- *
- * @see design.md Decision 10: Format Change Detection as Post-LCS Phase
- */
-import { CorrelationStatus, DEFAULT_FORMAT_DETECTION_SETTINGS, RUN_PROPERTY_FRIENDLY_NAMES, } from './core-types.js';
-import { getLeafText, childElements } from './primitives/index.js';
-import { parseXml } from './primitives/xml.js';
-// =============================================================================
-// Run Property Extraction
-// =============================================================================
-/**
- * Extract run properties (w:rPr) from an atom's ancestor elements.
- *
- * Finds the w:r (run) element in ancestors and extracts its w:rPr child.
- *
- * @param atom - The atom to extract properties from
- * @returns The w:rPr element, or null if not found
- *
- * @example
- * // For an atom inside <w:r><w:rPr><w:b/></w:rPr><w:t>text</w:t></w:r>
- * // Returns the <w:rPr><w:b/></w:rPr> element
- */
-export function getRunPropertiesFromAtom(atom) {
-    // Find the w:r ancestor element
-    const runElement = atom.ancestorElements?.find((a) => a.tagName === 'w:r');
-    if (!runElement) {
-        return null;
-    }
-    // Get the rPr child element
-    for (const child of childElements(runElement)) {
-        if (child.tagName === 'w:rPr')
-            return child;
-    }
-    return null;
-}
-function extractNormalizedProperties(rPr) {
-    if (!rPr) {
-        return { children: [] };
-    }
-    const normalizedChildren = childElements(rPr)
-        // Remove revision tracking elements
-        .filter((e) => e.tagName !== 'w:rPrChange')
-        // Sort by tag name for deterministic comparison
-        .sort((a, b) => a.tagName.localeCompare(b.tagName))
-        // Normalize each child
-        .map((e) => {
-        const attrs = [];
-        for (let i = 0; i < e.attributes.length; i++) {
-            const attr = e.attributes[i];
-            attrs.push([attr.name, attr.value]);
-        }
-        attrs.sort(([a], [b]) => a.localeCompare(b));
-        const text = getLeafText(e);
-        const prop = { tagName: e.tagName, attrs };
-        if (text !== undefined)
-            prop.text = text;
-        return prop;
-    });
-    return { children: normalizedChildren };
-}
-// =============================================================================
-// Run Property Comparison
-// =============================================================================
-/**
- * Serialize normalized properties to a string for comparison.
- */
-function serializeNormalizedProperties(rPr) {
-    const parts = [];
-    for (const child of rPr.children) {
-        const attrs = child.attrs
-            .map(([k, v]) => `${k}="${v}"`)
-            .join(' ');
-        const textPart = child.text ? `|${child.text}` : '';
-        parts.push(`<${child.tagName} ${attrs}${textPart}/>`);
-    }
-    return parts.join('');
-}
-/**
- * Check if two run properties are equal after normalization.
- */
-export function areRunPropertiesEqual(rPr1, rPr2) {
-    const norm1 = extractNormalizedProperties(rPr1);
-    const norm2 = extractNormalizedProperties(rPr2);
-    return serializeNormalizedProperties(norm1) === serializeNormalizedProperties(norm2);
-}
-// Keep legacy overload for callers that pass WmlElement (= Element)
-export { areRunPropertiesEqual as areNormalizedRunPropertiesEqual };
-// =============================================================================
-// Changed Property Detection
-// =============================================================================
-/**
- * Get the set of property tag names from a normalized rPr.
- */
-function getPropertyTagNames(rPr) {
-    return new Set(rPr.children.map((c) => c.tagName));
-}
-/**
- * Find a property element by tag name in a normalized rPr.
- */
-function findPropertyByTag(rPr, tagName) {
-    return rPr.children.find((c) => c.tagName === tagName);
-}
-/**
- * Check if two property elements have the same value.
- */
-function arePropertiesValueEqual(prop1, prop2) {
-    if (!prop1 && !prop2)
-        return true;
-    if (!prop1 || !prop2)
-        return false;
-    const str1 = serializeNormalizedProperties({ children: [prop1] });
-    const str2 = serializeNormalizedProperties({ children: [prop2] });
-    return str1 === str2;
-}
-/**
- * Get the list of property names that changed between two run properties.
- *
- * Returns friendly names (e.g., "bold", "italic") when available,
- * otherwise returns the OOXML tag name.
- *
- * @param oldRPr - Old run properties element (or null)
- * @param newRPr - New run properties element (or null)
- * @returns Array of changed property names
- */
-export function getChangedPropertyNames(oldRPr, newRPr) {
-    const changed = [];
-    const normalizedOld = extractNormalizedProperties(oldRPr);
-    const normalizedNew = extractNormalizedProperties(newRPr);
-    const oldTags = getPropertyTagNames(normalizedOld);
-    const newTags = getPropertyTagNames(normalizedNew);
-    // All unique tags from both
-    const allTags = new Set([...oldTags, ...newTags]);
-    for (const tag of allTags) {
-        const oldProp = findPropertyByTag(normalizedOld, tag);
-        const newProp = findPropertyByTag(normalizedNew, tag);
-        if (!arePropertiesValueEqual(oldProp, newProp)) {
-            // Use friendly name if available
-            const friendlyName = RUN_PROPERTY_FRIENDLY_NAMES[tag] ?? tag;
-            changed.push(friendlyName);
-        }
-    }
-    return changed.sort();
-}
-/**
- * Categorize changed properties into added, removed, and modified.
- *
- * @param oldRPr - Old run properties element (or null)
- * @param newRPr - New run properties element (or null)
- * @returns Object with added, removed, and changed arrays
- */
-export function categorizePropertyChanges(oldRPr, newRPr) {
-    const added = [];
-    const removed = [];
-    const changed = [];
-    const normalizedOld = extractNormalizedProperties(oldRPr);
-    const normalizedNew = extractNormalizedProperties(newRPr);
-    const oldTags = getPropertyTagNames(normalizedOld);
-    const newTags = getPropertyTagNames(normalizedNew);
-    // Check for added properties (in new but not old)
-    for (const tag of newTags) {
-        if (!oldTags.has(tag)) {
-            const friendlyName = RUN_PROPERTY_FRIENDLY_NAMES[tag] ?? tag;
-            added.push(friendlyName);
-        }
-    }
-    // Check for removed properties (in old but not new)
-    for (const tag of oldTags) {
-        if (!newTags.has(tag)) {
-            const friendlyName = RUN_PROPERTY_FRIENDLY_NAMES[tag] ?? tag;
-            removed.push(friendlyName);
-        }
-    }
-    // Check for changed properties (in both but different value)
-    for (const tag of oldTags) {
-        if (newTags.has(tag)) {
-            const oldProp = findPropertyByTag(normalizedOld, tag);
-            const newProp = findPropertyByTag(normalizedNew, tag);
-            if (!arePropertiesValueEqual(oldProp, newProp)) {
-                const friendlyName = RUN_PROPERTY_FRIENDLY_NAMES[tag] ?? tag;
-                changed.push(friendlyName);
-            }
-        }
-    }
-    return {
-        added: added.sort(),
-        removed: removed.sort(),
-        changed: changed.sort(),
-    };
-}
-// =============================================================================
-// Main Algorithm
-// =============================================================================
-/**
- * Detect format changes in a flat list of atoms.
- *
- * Runs after LCS and move detection to identify Equal atoms where the text
- * matches but formatting differs. Updates atoms in place with format change status.
- *
- * @param atoms - The atom list to process (modified in place)
- * @param settings - Format detection settings (optional, uses defaults)
- */
-export function detectFormatChangesInAtomList(atoms, settings = DEFAULT_FORMAT_DETECTION_SETTINGS) {
-    if (!settings.detectFormatChanges) {
-        return;
-    }
-    for (const atom of atoms) {
-        // Only check Equal atoms that have a "before" reference
-        if (atom.correlationStatus !== CorrelationStatus.Equal) {
-            continue;
-        }
-        if (!atom.comparisonUnitAtomBefore) {
-            continue;
-        }
-        // Extract rPr from both documents
-        const oldRPr = getRunPropertiesFromAtom(atom.comparisonUnitAtomBefore);
-        const newRPr = getRunPropertiesFromAtom(atom);
-        // Compare run properties
-        if (!areRunPropertiesEqual(oldRPr, newRPr)) {
-            atom.correlationStatus = CorrelationStatus.FormatChanged;
-            atom.formatChange = {
-                oldRunProperties: oldRPr,
-                newRunProperties: newRPr,
-                changedProperties: getChangedPropertyNames(oldRPr, newRPr),
-            };
-        }
-    }
-}
-/**
- * Merge format change markup into a run's existing rPr element.
- *
- * Adds the w:rPrChange element as the last child of w:rPr.
- *
- * @param runElement - The w:r element to modify
- * @param rPrChange - The w:rPrChange element to insert
- */
-export function mergeFormatChangeIntoRun(runElement, rPrChange) {
-    if (runElement.tagName !== 'w:r') {
-        return;
-    }
-    // Find existing rPr
-    let rPr = null;
-    for (const child of childElements(runElement)) {
-        if (child.tagName === 'w:rPr') {
-            rPr = child;
-            break;
-        }
-    }
-    if (!rPr) {
-        // Create rPr as first child
-        const doc = runElement.ownerDocument;
-        rPr = doc.createElementNS('http://schemas.openxmlformats.org/wordprocessingml/2006/main', 'w:rPr');
-        runElement.insertBefore(rPr, runElement.firstChild);
-    }
-    // Add rPrChange as last child of rPr
-    rPr.appendChild(rPrChange);
-}
-// =============================================================================
-// Paragraph Property Change Support (Future Enhancement)
-// =============================================================================
-/**
- * Extract paragraph properties (w:pPr) from an element.
- *
- * @param paragraphElement - The w:p element
- * @returns The w:pPr element, or null if not found
- */
-export function getParagraphProperties(paragraphElement) {
-    if (paragraphElement.tagName !== 'w:p') {
-        return null;
-    }
-    for (const child of childElements(paragraphElement)) {
-        if (child.tagName === 'w:pPr')
-            return child;
-    }
-    return null;
-}
-/**
- * Paragraph property friendly names.
- */
-export const PARAGRAPH_PROPERTY_FRIENDLY_NAMES = {
-    'w:jc': 'alignment',
-    'w:ind': 'indentation',
-    'w:spacing': 'spacing',
-    'w:pStyle': 'style',
-    'w:numPr': 'numbering',
-    'w:pBdr': 'borders',
-    'w:shd': 'shading',
-    'w:tabs': 'tabs',
-    'w:keepNext': 'keepWithNext',
-    'w:keepLines': 'keepLinesTogether',
-    'w:pageBreakBefore': 'pageBreakBefore',
-    'w:widowControl': 'widowControl',
-    'w:outlineLvl': 'outlineLevel',
-};
-// =============================================================================
-// Legacy API — kept for backward compatibility during migration
-// =============================================================================
-/**
- * @deprecated Use areRunPropertiesEqual directly with Element params
- */
-export function normalizeRunProperties(rPr) {
-    return extractNormalizedProperties(rPr);
-}
-/**
- * @deprecated Use getParagraphProperties directly
- */
-export function normalizeParagraphProperties(pPr) {
-    return extractNormalizedProperties(pPr);
-}
-/**
- * @deprecated Removed — use generateFormatChangeMarkup with DOM approach
- */
-export function generateFormatChangeMarkup(formatChange, options) {
-    const doc = parseXml('<root/>');
-    const dateStr = options.dateTime.toISOString();
-    const W_NS = 'http://schemas.openxmlformats.org/wordprocessingml/2006/main';
-    const rPrChange = doc.createElementNS(W_NS, 'w:rPrChange');
-    rPrChange.setAttribute('w:id', options.id.toString());
-    rPrChange.setAttribute('w:author', options.author);
-    rPrChange.setAttribute('w:date', dateStr);
-    const rPr = doc.createElementNS(W_NS, 'w:rPr');
-    rPrChange.appendChild(rPr);
-    if (formatChange.oldRunProperties) {
-        for (const child of childElements(formatChange.oldRunProperties)) {
-            if (child.tagName === 'w:rPrChange')
-                continue;
-            rPr.appendChild(child.cloneNode(true));
-        }
-    }
-    return rPrChange;
-}
-//# sourceMappingURL=format-detection.js.map

package/dist/format-detection.js.map

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

package/dist/move-detection.d.ts

@@ -1,211 +0,0 @@
-/**
- * Move Detection Module
- *
- * Detects relocated content after LCS comparison by matching deleted blocks
- * with inserted blocks using Jaccard word similarity.
- *
- * Pipeline position:
- * LCS() → MarkRowsAsDeletedOrInserted() → FlattenToAtomList() → detectMovesInAtomList() → CoalesceRecurse()
- *
- * @see WmlComparer.cs DetectMovesInAtomList() line 3811
- */
-import { AtomBlock, ComparisonUnitAtom, CorrelationStatus, MoveDetectionSettings } from './core-types.js';
-/**
- * Extract text content from an atom.
- *
- * @param atom - The atom to extract text from
- * @returns The text content, or empty string for non-text atoms
- */
-export declare function getAtomText(atom: ComparisonUnitAtom): string;
-/**
- * Extract text from a sequence of atoms.
- *
- * @param atoms - The atoms to extract text from
- * @returns Combined text content
- */
-export declare function getAtomsText(atoms: ComparisonUnitAtom[]): string;
-/**
- * Count words in text.
- *
- * @param text - The text to count words in
- * @returns Number of words
- */
-export declare function countWords(text: string): number;
-/**
- * Calculate Jaccard similarity between two texts based on word sets.
- *
- * Jaccard index = |intersection| / |union|
- *
- * Benefits:
- * - Order-independent: "fox quick brown" matches "brown quick fox"
- * - Handles insertions/deletions well: adding one word to a 10-word block only slightly reduces similarity
- * - O(n) complexity where n = total words
- *
- * @param text1 - First text
- * @param text2 - Second text
- * @param caseInsensitive - Whether to ignore case (default: true)
- * @returns Similarity score between 0 and 1
- *
- * @example
- * jaccardWordSimilarity("The quick brown fox", "The quick brown dog")
- * // Returns 0.6 (3 common words / 5 total unique words)
- */
-export declare function jaccardWordSimilarity(text1: string, text2: string, caseInsensitive?: boolean): number;
-/**
- * Group consecutive atoms by correlation status.
- *
- * Creates blocks of atoms with the same status (Deleted or Inserted).
- *
- * @param atoms - The atoms to group
- * @returns Array of atom blocks
- */
-export declare function groupIntoBlocks(atoms: ComparisonUnitAtom[]): AtomBlock[];
-/**
- * Result of finding the best match for a deleted block.
- */
-interface MatchResult {
-    /** The matching inserted block */
-    block: AtomBlock;
-    /** Similarity score between 0 and 1 */
-    similarity: number;
-    /** Index in the insertedBlocks array */
-    index: number;
-}
-/**
- * Find the best matching inserted block for a deleted block.
- *
- * @param deleted - The deleted block to match
- * @param insertedBlocks - Available inserted blocks
- * @param settings - Move detection settings
- * @returns The best match, or undefined if no match meets threshold
- */
-export declare function findBestMatch(deleted: AtomBlock, insertedBlocks: AtomBlock[], settings: MoveDetectionSettings): MatchResult | undefined;
-/**
- * Mark atoms as part of a move operation.
- *
- * @param atoms - Atoms to mark
- * @param status - New correlation status (MovedSource or MovedDestination)
- * @param moveGroupId - ID linking source and destination
- * @param moveName - Name for move tracking (e.g., "move1")
- */
-export declare function markAsMove(atoms: ComparisonUnitAtom[], status: CorrelationStatus.MovedSource | CorrelationStatus.MovedDestination, moveGroupId: number, moveName: string): void;
-/**
- * Detect moves in a flat list of atoms.
- *
- * Runs after LCS comparison to identify deleted blocks that were actually
- * moved to a new location. Updates atoms in place with move status.
- *
- * @param atoms - The atom list to process (modified in place)
- * @param settings - Move detection settings (optional, uses defaults)
- *
- * @see WmlComparer.cs DetectMovesInAtomList() line 3811
- *
- * @example
- * const atoms = atomizeTree(document, [], part);
- * runLCSComparison(atoms);
- * detectMovesInAtomList(atoms); // Updates atoms in place
- */
-export declare function detectMovesInAtomList(atoms: ComparisonUnitAtom[], settings?: MoveDetectionSettings): void;
-/**
- * Options for generating move markup.
- */
-export interface MoveMarkupOptions {
-    /** Author name for revision tracking */
-    author: string;
-    /** Timestamp for revisions */
-    dateTime: Date;
-    /** Starting ID for range markers */
-    startId: number;
-}
-/**
- * Generated move markup for a block.
- */
-export interface MoveMarkup {
-    /** Range start element */
-    rangeStart: Element;
-    /** Move content wrapper element */
-    moveWrapper: Element;
-    /** Range end element */
-    rangeEnd: Element;
-    /** Next available ID after these elements */
-    nextId: number;
-}
-/**
- * Generate move source markup (w:moveFrom with range markers).
- *
- * @param moveName - Name linking source and destination (e.g., "move1")
- * @param content - Child elements to wrap
- * @param options - Markup generation options
- * @returns Move markup elements
- *
- * @example
- * Output structure:
- * <w:moveFromRangeStart w:id="1" w:name="move1" w:author="..." w:date="..."/>
- * <w:moveFrom w:id="2" w:author="..." w:date="...">
- *   <!-- content -->
- * </w:moveFrom>
- * <w:moveFromRangeEnd w:id="1"/>
- */
-export declare function generateMoveSourceMarkup(moveName: string, content: Element[], options: MoveMarkupOptions): MoveMarkup;
-/**
- * Generate move destination markup (w:moveTo with range markers).
- *
- * @param moveName - Name linking source and destination (e.g., "move1")
- * @param content - Child elements to wrap
- * @param options - Markup generation options
- * @returns Move markup elements
- *
- * @example
- * Output structure:
- * <w:moveToRangeStart w:id="3" w:name="move1" w:author="..." w:date="..."/>
- * <w:moveTo w:id="4" w:author="..." w:date="...">
- *   <!-- content -->
- * </w:moveTo>
- * <w:moveToRangeEnd w:id="3"/>
- */
-export declare function generateMoveDestinationMarkup(moveName: string, content: Element[], options: MoveMarkupOptions): MoveMarkup;
-/**
- * State for tracking revision IDs during markup generation.
- */
-export interface RevisionIdState {
-    /** Next available ID */
-    nextId: number;
-    /** Move name to range start ID mapping */
-    moveRangeIds: Map<string, {
-        sourceRangeId: number;
-        destRangeId: number;
-    }>;
-}
-/**
- * Create initial revision ID state.
- *
- * @param startId - Starting ID (default: 1)
- * @returns Initial state
- */
-export declare function createRevisionIdState(startId?: number): RevisionIdState;
-/**
- * Allocate IDs for a move operation.
- *
- * Ensures source and destination use consistent IDs for proper linking.
- *
- * @param state - Revision ID state (modified in place)
- * @param moveName - Move name (e.g., "move1")
- * @returns IDs for source and destination markup
- */
-export declare function allocateMoveIds(state: RevisionIdState, moveName: string): {
-    sourceRangeId: number;
-    sourceMoveId: number;
-    destRangeId: number;
-    destMoveId: number;
-};
-/**
- * Fix up revision IDs after all moves have been processed.
- *
- * Ensures proper ID pairing between source and destination elements.
- * This is a post-processing step after markup generation.
- *
- * @param state - The revision ID state
- */
-export declare function fixUpRevisionIds(_state: RevisionIdState): void;
-export {};
-//# sourceMappingURL=move-detection.d.ts.map

package/dist/move-detection.d.ts.map

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