@usejunior/docx-core 0.0.1 → 0.1.1

package/dist/footnotes.js

@@ -0,0 +1,291 @@
+/**
+ * Footnote Numbering Module
+ *
+ * Handles sequential footnote/endnote numbering by document order.
+ *
+ * Per ECMA-376, w:id on footnoteReference is a reference identifier, NOT the
+ * display number. Display numbers are sequential based on document order.
+ *
+ * @example
+ * Document has 91 footnotes with XML IDs 2-92 (IDs 0, 1 are reserved):
+ * - Incorrect: Display as 2, 3, 4, ..., 92
+ * - Correct: Display as 1, 2, 3, ..., 91
+ */
+import { RESERVED_FOOTNOTE_IDS, } from './core-types.js';
+import { childElements, getLeafText } from './primitives/index.js';
+// =============================================================================
+// Footnote Reference Finding
+// =============================================================================
+/**
+ * Find all footnote or endnote references in document order.
+ *
+ * Recursively traverses the document tree to find references in reading order.
+ *
+ * @param element - The root element to search from
+ * @param tagName - The reference tag to find ('w:footnoteReference' or 'w:endnoteReference')
+ * @returns Array of reference elements in document order
+ */
+export function findReferencesInOrder(element, tagName) {
+    const refs = [];
+    function traverse(node) {
+        if (node.tagName === tagName) {
+            refs.push(node);
+        }
+        for (const child of childElements(node)) {
+            traverse(child);
+        }
+    }
+    traverse(element);
+    return refs;
+}
+/**
+ * Check if a footnote/endnote ID is reserved.
+ *
+ * IDs 0 and 1 are reserved for separator types per ECMA-376.
+ *
+ * @param xmlId - The XML ID to check
+ * @returns True if this is a reserved ID
+ */
+export function isReservedId(xmlId) {
+    return (xmlId === RESERVED_FOOTNOTE_IDS.SEPARATOR ||
+        xmlId === RESERVED_FOOTNOTE_IDS.CONTINUATION_SEPARATOR);
+}
+// =============================================================================
+// FootnoteNumberingTracker Class
+// =============================================================================
+/**
+ * Tracks sequential footnote/endnote numbering by document order.
+ *
+ * Scans the document for footnote/endnote references and builds a mapping
+ * from XML IDs to display numbers.
+ *
+ * @example
+ * const tracker = new FootnoteNumberingTracker(documentRoot);
+ * const displayNum = tracker.getDisplayNumber('42'); // Returns 1 if '42' is the first footnote
+ */
+export class FootnoteNumberingTracker {
+    footnoteIdToDisplayNumber = new Map();
+    endnoteIdToDisplayNumber = new Map();
+    footnoteCustomMarks = new Set();
+    endnoteCustomMarks = new Set();
+    /**
+     * Create a new tracker by scanning the document.
+     *
+     * @param documentRoot - The root element of the main document (w:document or w:body)
+     */
+    constructor(documentRoot) {
+        this.scanDocument(documentRoot);
+    }
+    /**
+     * Scan the document for footnote and endnote references.
+     */
+    scanDocument(documentRoot) {
+        // Scan for footnote references
+        const footnoteRefs = findReferencesInOrder(documentRoot, 'w:footnoteReference');
+        this.buildNumbering(footnoteRefs, this.footnoteIdToDisplayNumber, this.footnoteCustomMarks);
+        // Scan for endnote references
+        const endnoteRefs = findReferencesInOrder(documentRoot, 'w:endnoteReference');
+        this.buildNumbering(endnoteRefs, this.endnoteIdToDisplayNumber, this.endnoteCustomMarks);
+    }
+    /**
+     * Build the ID to display number mapping.
+     */
+    buildNumbering(refs, idToNumber, customMarks) {
+        let displayNum = 1;
+        for (const ref of refs) {
+            const xmlId = ref.getAttribute('w:id');
+            if (!xmlId)
+                continue;
+            // Skip reserved IDs
+            if (isReservedId(xmlId))
+                continue;
+            // Check for custom mark
+            const hasCustomMark = ref.getAttribute('w:customMarkFollows') === '1' ||
+                ref.getAttribute('w:customMarkFollows') === 'true';
+            if (hasCustomMark) {
+                customMarks.add(xmlId);
+                // Custom marks don't get automatic numbers but still reserve a slot
+                // Some implementations skip numbering, others don't - we follow Word behavior
+            }
+            // Only assign number if not already seen (handles duplicate references)
+            if (!idToNumber.has(xmlId)) {
+                if (!hasCustomMark) {
+                    idToNumber.set(xmlId, displayNum);
+                    displayNum++;
+                }
+            }
+        }
+    }
+    /**
+     * Get the display number for a footnote by its XML ID.
+     *
+     * @param xmlId - The XML ID (w:id attribute)
+     * @returns The display number, or undefined if not found or uses custom mark
+     */
+    getFootnoteDisplayNumber(xmlId) {
+        return this.footnoteIdToDisplayNumber.get(xmlId);
+    }
+    /**
+     * Get the display number for an endnote by its XML ID.
+     *
+     * @param xmlId - The XML ID (w:id attribute)
+     * @returns The display number, or undefined if not found or uses custom mark
+     */
+    getEndnoteDisplayNumber(xmlId) {
+        return this.endnoteIdToDisplayNumber.get(xmlId);
+    }
+    /**
+     * Get the display number for a footnote or endnote by its XML ID.
+     *
+     * Convenience method that checks both footnotes and endnotes.
+     *
+     * @param xmlId - The XML ID
+     * @returns The display number, or undefined if not found
+     */
+    getDisplayNumber(xmlId) {
+        return (this.footnoteIdToDisplayNumber.get(xmlId) ??
+            this.endnoteIdToDisplayNumber.get(xmlId));
+    }
+    /**
+     * Check if a footnote uses a custom mark.
+     *
+     * @param xmlId - The XML ID
+     * @returns True if this footnote has w:customMarkFollows
+     */
+    hasFootnoteCustomMark(xmlId) {
+        return this.footnoteCustomMarks.has(xmlId);
+    }
+    /**
+     * Check if an endnote uses a custom mark.
+     *
+     * @param xmlId - The XML ID
+     * @returns True if this endnote has w:customMarkFollows
+     */
+    hasEndnoteCustomMark(xmlId) {
+        return this.endnoteCustomMarks.has(xmlId);
+    }
+    /**
+     * Get the total number of footnotes (excluding custom marks).
+     */
+    getFootnoteCount() {
+        return this.footnoteIdToDisplayNumber.size;
+    }
+    /**
+     * Get the total number of endnotes (excluding custom marks).
+     */
+    getEndnoteCount() {
+        return this.endnoteIdToDisplayNumber.size;
+    }
+    /**
+     * Get all footnote references as structured data.
+     *
+     * @returns Array of FootnoteReference objects
+     */
+    getFootnoteReferences() {
+        const refs = [];
+        for (const [xmlId, displayNumber] of this.footnoteIdToDisplayNumber) {
+            refs.push({
+                xmlId,
+                displayNumber,
+                customMarkFollows: this.footnoteCustomMarks.has(xmlId),
+            });
+        }
+        // Add custom mark footnotes (no display number)
+        for (const xmlId of this.footnoteCustomMarks) {
+            if (!this.footnoteIdToDisplayNumber.has(xmlId)) {
+                refs.push({
+                    xmlId,
+                    customMarkFollows: true,
+                });
+            }
+        }
+        return refs;
+    }
+    /**
+     * Get all endnote references as structured data.
+     *
+     * @returns Array of FootnoteReference objects
+     */
+    getEndnoteReferences() {
+        const refs = [];
+        for (const [xmlId, displayNumber] of this.endnoteIdToDisplayNumber) {
+            refs.push({
+                xmlId,
+                displayNumber,
+                customMarkFollows: this.endnoteCustomMarks.has(xmlId),
+            });
+        }
+        // Add custom mark endnotes (no display number)
+        for (const xmlId of this.endnoteCustomMarks) {
+            if (!this.endnoteIdToDisplayNumber.has(xmlId)) {
+                refs.push({
+                    xmlId,
+                    customMarkFollows: true,
+                });
+            }
+        }
+        return refs;
+    }
+}
+// =============================================================================
+// Footnote Content Extraction
+// =============================================================================
+/**
+ * Find a footnote element by its ID in the footnotes.xml part.
+ *
+ * @param footnotesRoot - The root of the footnotes.xml document
+ * @param xmlId - The XML ID to find
+ * @returns The w:footnote element, or undefined if not found
+ */
+export function findFootnoteById(footnotesRoot, xmlId) {
+    if (footnotesRoot.tagName !== 'w:footnotes') {
+        return undefined;
+    }
+    for (const child of childElements(footnotesRoot)) {
+        if (child.tagName === 'w:footnote' && child.getAttribute('w:id') === xmlId) {
+            return child;
+        }
+    }
+    return undefined;
+}
+/**
+ * Find an endnote element by its ID in the endnotes.xml part.
+ *
+ * @param endnotesRoot - The root of the endnotes.xml document
+ * @param xmlId - The XML ID to find
+ * @returns The w:endnote element, or undefined if not found
+ */
+export function findEndnoteById(endnotesRoot, xmlId) {
+    if (endnotesRoot.tagName !== 'w:endnotes') {
+        return undefined;
+    }
+    for (const child of childElements(endnotesRoot)) {
+        if (child.tagName === 'w:endnote' && child.getAttribute('w:id') === xmlId) {
+            return child;
+        }
+    }
+    return undefined;
+}
+/**
+ * Extract plain text content from a footnote/endnote element.
+ *
+ * @param noteElement - The w:footnote or w:endnote element
+ * @returns Plain text content
+ */
+export function extractNoteText(noteElement) {
+    const texts = [];
+    function traverse(node) {
+        if (node.tagName === 'w:t') {
+            const text = getLeafText(node) ?? '';
+            if (text) {
+                texts.push(text);
+            }
+        }
+        for (const child of childElements(node)) {
+            traverse(child);
+        }
+    }
+    traverse(noteElement);
+    return texts.join('');
+}
+//# sourceMappingURL=footnotes.js.map

package/dist/footnotes.js.map

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

package/dist/format-detection.d.ts

@@ -0,0 +1,120 @@
+/**
+ * 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 { ComparisonUnitAtom, FormatChangeInfo, FormatDetectionSettings } from './core-types.js';
+/**
+ * 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 declare function getRunPropertiesFromAtom(atom: ComparisonUnitAtom): Element | null;
+/**
+ * Lightweight property descriptor for normalized comparison.
+ * These are NOT DOM Elements — they're ephemeral comparison objects.
+ */
+interface NormalizedProperty {
+    tagName: string;
+    attrs: [string, string][];
+    text?: string;
+}
+interface NormalizedRPr {
+    children: NormalizedProperty[];
+}
+/**
+ * Check if two run properties are equal after normalization.
+ */
+export declare function areRunPropertiesEqual(rPr1: Element | null, rPr2: Element | null): boolean;
+export { areRunPropertiesEqual as areNormalizedRunPropertiesEqual };
+/**
+ * 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 declare function getChangedPropertyNames(oldRPr: Element | null, newRPr: Element | null): string[];
+/**
+ * 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 declare function categorizePropertyChanges(oldRPr: Element | null, newRPr: Element | null): {
+    added: string[];
+    removed: string[];
+    changed: string[];
+};
+/**
+ * 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 declare function detectFormatChangesInAtomList(atoms: ComparisonUnitAtom[], settings?: FormatDetectionSettings): void;
+/**
+ * Options for generating format change markup.
+ */
+export interface FormatChangeMarkupOptions {
+    /** Author name for revision tracking */
+    author: string;
+    /** Timestamp for revisions */
+    dateTime: Date;
+    /** ID for the w:rPrChange element */
+    id: number;
+}
+/**
+ * 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 declare function mergeFormatChangeIntoRun(runElement: Element, rPrChange: Element): void;
+/**
+ * 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 declare function getParagraphProperties(paragraphElement: Element): Element | null;
+/**
+ * Paragraph property friendly names.
+ */
+export declare const PARAGRAPH_PROPERTY_FRIENDLY_NAMES: Record<string, string>;
+/**
+ * @deprecated Use areRunPropertiesEqual directly with Element params
+ */
+export declare function normalizeRunProperties(rPr: Element | null): NormalizedRPr;
+/**
+ * @deprecated Use getParagraphProperties directly
+ */
+export declare function normalizeParagraphProperties(pPr: Element | null): NormalizedRPr;
+/**
+ * @deprecated Removed — use generateFormatChangeMarkup with DOM approach
+ */
+export declare function generateFormatChangeMarkup(formatChange: FormatChangeInfo, options: FormatChangeMarkupOptions): Element;
+//# sourceMappingURL=format-detection.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"format-detection.d.ts","sourceRoot":"","sources":["../src/format-detection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EACL,kBAAkB,EAGlB,gBAAgB,EAChB,uBAAuB,EAExB,MAAM,iBAAiB,CAAC;AAOzB;;;;;;;;;;;GAWG;AACH,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,kBAAkB,GACvB,OAAO,GAAG,IAAI,CAYhB;AAMD;;;GAGG;AACH,UAAU,kBAAkB;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,UAAU,aAAa;IACrB,QAAQ,EAAE,kBAAkB,EAAE,CAAC;CAChC;AAmDD;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,OAAO,GAAG,IAAI,EACpB,IAAI,EAAE,OAAO,GAAG,IAAI,GACnB,OAAO,CAIT;AAGD,OAAO,EAAE,qBAAqB,IAAI,+BAA+B,EAAE,CAAC;AAsCpE;;;;;;;;;GASG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,OAAO,GAAG,IAAI,EACtB,MAAM,EAAE,OAAO,GAAG,IAAI,GACrB,MAAM,EAAE,CAuBV;AAED;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,OAAO,GAAG,IAAI,EACtB,MAAM,EAAE,OAAO,GAAG,IAAI,GACrB;IAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CA2C3D;AAMD;;;;;;;;GAQG;AACH,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,kBAAkB,EAAE,EAC3B,QAAQ,GAAE,uBAA2D,GACpE,IAAI,CA6BN;AAMD;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,wCAAwC;IACxC,MAAM,EAAE,MAAM,CAAC;IACf,8BAA8B;IAC9B,QAAQ,EAAE,IAAI,CAAC;IACf,qCAAqC;IACrC,EAAE,EAAE,MAAM,CAAC;CACZ;AAED;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CACtC,UAAU,EAAE,OAAO,EACnB,SAAS,EAAE,OAAO,GACjB,IAAI,CA0BN;AAMD;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,gBAAgB,EAAE,OAAO,GACxB,OAAO,GAAG,IAAI,CAQhB;AAED;;GAEG;AACH,eAAO,MAAM,iCAAiC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAcpE,CAAC;AAMF;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,GAAG,aAAa,CAEzE;AAED;;GAEG;AACH,wBAAgB,4BAA4B,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,GAAG,aAAa,CAE/E;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CACxC,YAAY,EAAE,gBAAgB,EAC9B,OAAO,EAAE,yBAAyB,GACjC,OAAO,CAqBT"}