@usejunior/docx-core 0.0.1 → 0.1.1

package/dist/format-detection.js

@@ -0,0 +1,338 @@
+/**
+ * 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';
+// =============================================================================
+// 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 = new (require('@xmldom/xmldom').DOMParser)().parseFromString('<root/>', 'application/xml');
+    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

@@ -0,0 +1 @@
+{"version":3,"file":"format-detection.js","sourceRoot":"","sources":["../src/format-detection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAEL,iBAAiB,EACjB,iCAAiC,EAGjC,2BAA2B,GAC5B,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAEnE,gFAAgF;AAChF,0BAA0B;AAC1B,gFAAgF;AAEhF;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,wBAAwB,CACtC,IAAwB;IAExB,gCAAgC;IAChC,MAAM,UAAU,GAAG,IAAI,CAAC,gBAAgB,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,KAAK,CAAC,CAAC;IAC3E,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,4BAA4B;IAC5B,KAAK,MAAM,KAAK,IAAI,aAAa,CAAC,UAAU,CAAC,EAAE,CAAC;QAC9C,IAAI,KAAK,CAAC,OAAO,KAAK,OAAO;YAAE,OAAO,KAAK,CAAC;IAC9C,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAoBD,SAAS,2BAA2B,CAAC,GAAmB;IACtD,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;IAC1B,CAAC;IAED,MAAM,kBAAkB,GAAyB,aAAa,CAAC,GAAG,CAAC;QACjE,oCAAoC;SACnC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,aAAa,CAAC;QAC3C,gDAAgD;SAC/C,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;QACnD,uBAAuB;SACtB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QACT,MAAM,KAAK,GAAuB,EAAE,CAAC;QACrC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAC7C,MAAM,IAAI,GAAG,CAAC,CAAC,UAAU,CAAC,CAAC,CAAE,CAAC;YAC9B,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;QACtC,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;QAE7C,MAAM,IAAI,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC;QAC5B,MAAM,IAAI,GAAuB,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,KAAK,EAAE,CAAC;QAC/D,IAAI,IAAI,KAAK,SAAS;YAAE,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACzC,OAAO,IAAI,CAAC;IACd,CAAC,CAAC,CAAC;IAEL,OAAO,EAAE,QAAQ,EAAE,kBAAkB,EAAE,CAAC;AAC1C,CAAC;AAED,gFAAgF;AAChF,0BAA0B;AAC1B,gFAAgF;AAEhF;;GAEG;AACH,SAAS,6BAA6B,CAAC,GAAkB;IACvD,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,KAAK,MAAM,KAAK,IAAI,GAAG,CAAC,QAAQ,EAAE,CAAC;QACjC,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK;aACtB,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC;aAC9B,IAAI,CAAC,GAAG,CAAC,CAAC;QACb,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACpD,KAAK,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,OAAO,IAAI,KAAK,GAAG,QAAQ,IAAI,CAAC,CAAC;IACxD,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AACxB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB,CACnC,IAAoB,EACpB,IAAoB;IAEpB,MAAM,KAAK,GAAG,2BAA2B,CAAC,IAAI,CAAC,CAAC;IAChD,MAAM,KAAK,GAAG,2BAA2B,CAAC,IAAI,CAAC,CAAC;IAChD,OAAO,6BAA6B,CAAC,KAAK,CAAC,KAAK,6BAA6B,CAAC,KAAK,CAAC,CAAC;AACvF,CAAC;AAED,oEAAoE;AACpE,OAAO,EAAE,qBAAqB,IAAI,+BAA+B,EAAE,CAAC;AAEpE,gFAAgF;AAChF,6BAA6B;AAC7B,gFAAgF;AAEhF;;GAEG;AACH,SAAS,mBAAmB,CAAC,GAAkB;IAC7C,OAAO,IAAI,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;AACrD,CAAC;AAED;;GAEG;AACH,SAAS,iBAAiB,CACxB,GAAkB,EAClB,OAAe;IAEf,OAAO,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,OAAO,CAAC,CAAC;AACzD,CAAC;AAED;;GAEG;AACH,SAAS,uBAAuB,CAC9B,KAAqC,EACrC,KAAqC;IAErC,IAAI,CAAC,KAAK,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IAClC,IAAI,CAAC,KAAK,IAAI,CAAC,KAAK;QAAE,OAAO,KAAK,CAAC;IAEnC,MAAM,IAAI,GAAG,6BAA6B,CAAC,EAAE,QAAQ,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAClE,MAAM,IAAI,GAAG,6BAA6B,CAAC,EAAE,QAAQ,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAClE,OAAO,IAAI,KAAK,IAAI,CAAC;AACvB,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,uBAAuB,CACrC,MAAsB,EACtB,MAAsB;IAEtB,MAAM,OAAO,GAAa,EAAE,CAAC;IAE7B,MAAM,aAAa,GAAG,2BAA2B,CAAC,MAAM,CAAC,CAAC;IAC1D,MAAM,aAAa,GAAG,2BAA2B,CAAC,MAAM,CAAC,CAAC;IAC1D,MAAM,OAAO,GAAG,mBAAmB,CAAC,aAAa,CAAC,CAAC;IACnD,MAAM,OAAO,GAAG,mBAAmB,CAAC,aAAa,CAAC,CAAC;IAEnD,4BAA4B;IAC5B,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,OAAO,CAAC,CAAC,CAAC;IAElD,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;QAC1B,MAAM,OAAO,GAAG,iBAAiB,CAAC,aAAa,EAAE,GAAG,CAAC,CAAC;QACtD,MAAM,OAAO,GAAG,iBAAiB,CAAC,aAAa,EAAE,GAAG,CAAC,CAAC;QAEtD,IAAI,CAAC,uBAAuB,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,CAAC;YAC/C,iCAAiC;YACjC,MAAM,YAAY,GAAG,2BAA2B,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC;YAC7D,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC,IAAI,EAAE,CAAC;AACxB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,yBAAyB,CACvC,MAAsB,EACtB,MAAsB;IAEtB,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,MAAM,OAAO,GAAa,EAAE,CAAC;IAE7B,MAAM,aAAa,GAAG,2BAA2B,CAAC,MAAM,CAAC,CAAC;IAC1D,MAAM,aAAa,GAAG,2BAA2B,CAAC,MAAM,CAAC,CAAC;IAC1D,MAAM,OAAO,GAAG,mBAAmB,CAAC,aAAa,CAAC,CAAC;IACnD,MAAM,OAAO,GAAG,mBAAmB,CAAC,aAAa,CAAC,CAAC;IAEnD,kDAAkD;IAClD,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;QAC1B,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YACtB,MAAM,YAAY,GAAG,2BAA2B,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC;YAC7D,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QAC3B,CAAC;IACH,CAAC;IAED,oDAAoD;IACpD,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;QAC1B,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YACtB,MAAM,YAAY,GAAG,2BAA2B,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC;YAC7D,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC;IAED,6DAA6D;IAC7D,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;QAC1B,IAAI,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YACrB,MAAM,OAAO,GAAG,iBAAiB,CAAC,aAAa,EAAE,GAAG,CAAC,CAAC;YACtD,MAAM,OAAO,GAAG,iBAAiB,CAAC,aAAa,EAAE,GAAG,CAAC,CAAC;YACtD,IAAI,CAAC,uBAAuB,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,CAAC;gBAC/C,MAAM,YAAY,GAAG,2BAA2B,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC;gBAC7D,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;YAC7B,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO;QACL,KAAK,EAAE,KAAK,CAAC,IAAI,EAAE;QACnB,OAAO,EAAE,OAAO,CAAC,IAAI,EAAE;QACvB,OAAO,EAAE,OAAO,CAAC,IAAI,EAAE;KACxB,CAAC;AACJ,CAAC;AAED,gFAAgF;AAChF,iBAAiB;AACjB,gFAAgF;AAEhF;;;;;;;;GAQG;AACH,MAAM,UAAU,6BAA6B,CAC3C,KAA2B,EAC3B,WAAoC,iCAAiC;IAErE,IAAI,CAAC,QAAQ,CAAC,mBAAmB,EAAE,CAAC;QAClC,OAAO;IACT,CAAC;IAED,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,wDAAwD;QACxD,IAAI,IAAI,CAAC,iBAAiB,KAAK,iBAAiB,CAAC,KAAK,EAAE,CAAC;YACvD,SAAS;QACX,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,wBAAwB,EAAE,CAAC;YACnC,SAAS;QACX,CAAC;QAED,kCAAkC;QAClC,MAAM,MAAM,GAAG,wBAAwB,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;QACvE,MAAM,MAAM,GAAG,wBAAwB,CAAC,IAAI,CAAC,CAAC;QAE9C,yBAAyB;QACzB,IAAI,CAAC,qBAAqB,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC;YAC3C,IAAI,CAAC,iBAAiB,GAAG,iBAAiB,CAAC,aAAa,CAAC;YACzD,IAAI,CAAC,YAAY,GAAG;gBAClB,gBAAgB,EAAE,MAAM;gBACxB,gBAAgB,EAAE,MAAM;gBACxB,iBAAiB,EAAE,uBAAuB,CAAC,MAAM,EAAE,MAAM,CAAC;aAC3D,CAAC;QACJ,CAAC;IACH,CAAC;AACH,CAAC;AAkBD;;;;;;;GAOG;AACH,MAAM,UAAU,wBAAwB,CACtC,UAAmB,EACnB,SAAkB;IAElB,IAAI,UAAU,CAAC,OAAO,KAAK,KAAK,EAAE,CAAC;QACjC,OAAO;IACT,CAAC;IAED,oBAAoB;IACpB,IAAI,GAAG,GAAmB,IAAI,CAAC;IAC/B,KAAK,MAAM,KAAK,IAAI,aAAa,CAAC,UAAU,CAAC,EAAE,CAAC;QAC9C,IAAI,KAAK,CAAC,OAAO,KAAK,OAAO,EAAE,CAAC;YAC9B,GAAG,GAAG,KAAK,CAAC;YACZ,MAAM;QACR,CAAC;IACH,CAAC;IAED,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,4BAA4B;QAC5B,MAAM,GAAG,GAAG,UAAU,CAAC,aAAc,CAAC;QACtC,GAAG,GAAG,GAAG,CAAC,eAAe,CACvB,8DAA8D,EAC9D,OAAO,CACR,CAAC;QACF,UAAU,CAAC,YAAY,CAAC,GAAG,EAAE,UAAU,CAAC,UAAU,CAAC,CAAC;IACtD,CAAC;IAED,qCAAqC;IACrC,GAAG,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;AAC7B,CAAC;AAED,gFAAgF;AAChF,yDAAyD;AACzD,gFAAgF;AAEhF;;;;;GAKG;AACH,MAAM,UAAU,sBAAsB,CACpC,gBAAyB;IAEzB,IAAI,gBAAgB,CAAC,OAAO,KAAK,KAAK,EAAE,CAAC;QACvC,OAAO,IAAI,CAAC;IACd,CAAC;IACD,KAAK,MAAM,KAAK,IAAI,aAAa,CAAC,gBAAgB,CAAC,EAAE,CAAC;QACpD,IAAI,KAAK,CAAC,OAAO,KAAK,OAAO;YAAE,OAAO,KAAK,CAAC;IAC9C,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,iCAAiC,GAA2B;IACvE,MAAM,EAAE,WAAW;IACnB,OAAO,EAAE,aAAa;IACtB,WAAW,EAAE,SAAS;IACtB,UAAU,EAAE,OAAO;IACnB,SAAS,EAAE,WAAW;IACtB,QAAQ,EAAE,SAAS;IACnB,OAAO,EAAE,SAAS;IAClB,QAAQ,EAAE,MAAM;IAChB,YAAY,EAAE,cAAc;IAC5B,aAAa,EAAE,mBAAmB;IAClC,mBAAmB,EAAE,iBAAiB;IACtC,gBAAgB,EAAE,cAAc;IAChC,cAAc,EAAE,cAAc;CAC/B,CAAC;AAEF,gFAAgF;AAChF,gEAAgE;AAChE,gFAAgF;AAEhF;;GAEG;AACH,MAAM,UAAU,sBAAsB,CAAC,GAAmB;IACxD,OAAO,2BAA2B,CAAC,GAAG,CAAC,CAAC;AAC1C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,4BAA4B,CAAC,GAAmB;IAC9D,OAAO,2BAA2B,CAAC,GAAG,CAAC,CAAC;AAC1C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,0BAA0B,CACxC,YAA8B,EAC9B,OAAkC;IAElC,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC,SAAS,CAAC,EAAE,CAAC,eAAe,CAAC,SAAS,EAAE,iBAAiB,CAAa,CAAC;IAClH,MAAM,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC;IAC/C,MAAM,IAAI,GAAG,8DAA8D,CAAC;IAE5E,MAAM,SAAS,GAAG,GAAG,CAAC,eAAe,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC;IAC3D,SAAS,CAAC,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,CAAC,CAAC;IACtD,SAAS,CAAC,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IACnD,SAAS,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAE1C,MAAM,GAAG,GAAG,GAAG,CAAC,eAAe,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAC/C,SAAS,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IAE3B,IAAI,YAAY,CAAC,gBAAgB,EAAE,CAAC;QAClC,KAAK,MAAM,KAAK,IAAI,aAAa,CAAC,YAAY,CAAC,gBAAgB,CAAC,EAAE,CAAC;YACjE,IAAI,KAAK,CAAC,OAAO,KAAK,aAAa;gBAAE,SAAS;YAC9C,GAAG,CAAC,WAAW,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;QACzC,CAAC;IACH,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,177 @@
+/**
+ * Document Comparison Engine
+ *
+ * Provides multiple comparison approaches:
+ * - Baseline A: WmlComparer wrapper (Docxodus WASM or dotnet CLI)
+ * - Baseline B: Pure TypeScript (diff-match-patch + OOXML renderer) - paragraph level
+ * - Atomizer: Pure TypeScript with atom-level comparison, move detection, format detection
+ */
+export interface CompareOptions {
+    /** Author name for revision tracking. Default: "Comparison" */
+    author?: string;
+    /**
+     * Revision timestamp used for generated track changes (`w:date`).
+     * Default: current time.
+     */
+    date?: Date;
+    /** Ignore formatting differences. Default: true (v1) */
+    ignoreFormatting?: boolean;
+    /**
+     * Atomizer-only normalization: merge adjacent <w:r> siblings with identical formatting
+     * prior to comparison. This can reduce overly-granular diffs for heavily-fragmented docs.
+     *
+     * Default: false.
+     */
+    premergeRuns?: boolean;
+    /**
+     * How to reconstruct the output DOCX when using the atomizer engine:
+     * - 'rebuild': rebuild document.xml from scratch (more reject/accept stable)
+     * - 'inplace': modify the revised document AST in place (more experimental)
+     *
+     * Default: 'rebuild'
+     */
+    reconstructionMode?: ReconstructionMode;
+    /**
+     * Comparison engine to use:
+     * - 'atomizer': Character-level comparison with move detection (recommended)
+     * - 'diffmatch': Paragraph-level comparison (faster, less precise)
+     * - 'wmlcomparer': .NET WmlComparer (requires external runtime)
+     * - 'auto': Automatically select best available engine (currently 'atomizer')
+     *
+     * Default: 'auto'
+     */
+    engine?: 'wmlcomparer' | 'diffmatch' | 'atomizer' | 'auto';
+}
+export interface CompareStats {
+    insertions: number;
+    deletions: number;
+    modifications: number;
+}
+export type ReconstructionMode = 'rebuild' | 'inplace';
+export type ReconstructionFallbackReason = 'round_trip_safety_check_failed';
+export type ReconstructionSafetyCheckName = 'acceptText' | 'rejectText' | 'acceptBookmarks' | 'rejectBookmarks';
+export interface ReconstructionSafetyChecks {
+    acceptText: boolean;
+    rejectText: boolean;
+    acceptBookmarks: boolean;
+    rejectBookmarks: boolean;
+}
+export interface ReconstructionTextMismatchDetails {
+    expectedLength: number;
+    actualLength: number;
+    firstDifferingParagraphIndex: number;
+    expectedParagraph: string;
+    actualParagraph: string;
+    differenceSample: string[];
+}
+export interface ReconstructionIdDelta {
+    missing: string[];
+    unexpected: string[];
+}
+export interface ReconstructionBookmarkMismatchDetails {
+    startNames: ReconstructionIdDelta;
+    referencedBookmarkNames: ReconstructionIdDelta;
+    unresolvedReferenceNames: ReconstructionIdDelta;
+    startIds: ReconstructionIdDelta;
+    endIds: ReconstructionIdDelta;
+    expectedDuplicateStartNames: string[];
+    actualDuplicateStartNames: string[];
+    expectedDuplicateStartIds: string[];
+    actualDuplicateStartIds: string[];
+    expectedDuplicateEndIds: string[];
+    actualDuplicateEndIds: string[];
+    expectedUnmatchedStartIds: string[];
+    actualUnmatchedStartIds: string[];
+    expectedUnmatchedEndIds: string[];
+    actualUnmatchedEndIds: string[];
+}
+export interface ReconstructionSafetyFailureDetails {
+    acceptText?: ReconstructionTextMismatchDetails;
+    rejectText?: ReconstructionTextMismatchDetails;
+    acceptBookmarks?: ReconstructionBookmarkMismatchDetails;
+    rejectBookmarks?: ReconstructionBookmarkMismatchDetails;
+}
+export interface ReconstructionIdDeltaSummary {
+    missingCount: number;
+    unexpectedCount: number;
+    firstMissing?: string;
+    firstUnexpected?: string;
+}
+export interface ReconstructionTextMismatchSummary {
+    firstDifferingParagraphIndex: number;
+    expectedParagraph: string;
+    actualParagraph: string;
+    firstDifference: string;
+}
+export interface ReconstructionBookmarkMismatchSummary {
+    startNames: ReconstructionIdDeltaSummary;
+    referencedBookmarkNames: ReconstructionIdDeltaSummary;
+    unresolvedReferenceNames: ReconstructionIdDeltaSummary;
+    startIds: ReconstructionIdDeltaSummary;
+    endIds: ReconstructionIdDeltaSummary;
+    unmatchedStartCount: number;
+    unmatchedEndCount: number;
+    firstUnmatchedStartId?: string;
+    firstUnmatchedEndId?: string;
+}
+export interface ReconstructionSafetyFailureSummary {
+    acceptText?: ReconstructionTextMismatchSummary;
+    rejectText?: ReconstructionTextMismatchSummary;
+    acceptBookmarks?: ReconstructionBookmarkMismatchSummary;
+    rejectBookmarks?: ReconstructionBookmarkMismatchSummary;
+}
+export interface ReconstructionAttemptDiagnostics {
+    pass: 'inplace_word_split' | 'inplace_run_level' | 'inplace_word_split_cross_run' | 'inplace_run_level_cross_run';
+    checks: ReconstructionSafetyChecks;
+    failedChecks: ReconstructionSafetyCheckName[];
+    failureDetails?: ReconstructionSafetyFailureDetails;
+    firstDiffSummary?: ReconstructionSafetyFailureSummary;
+}
+export interface ReconstructionFallbackDiagnostics {
+    attempts: ReconstructionAttemptDiagnostics[];
+}
+export interface CompareResult {
+    /** The resulting DOCX with track changes */
+    document: Buffer;
+    /** Statistics about the comparison */
+    stats: CompareStats;
+    /** Which engine was used */
+    engine: 'wmlcomparer' | 'diffmatch' | 'atomizer';
+    /**
+     * Requested reconstruction mode. Present for atomizer outputs.
+     */
+    reconstructionModeRequested?: ReconstructionMode;
+    /**
+     * Actual reconstruction mode used to produce the output. Present for atomizer outputs.
+     */
+    reconstructionModeUsed?: ReconstructionMode;
+    /**
+     * Why the requested reconstruction mode could not be used.
+     * Present only when atomizer falls back.
+     */
+    fallbackReason?: ReconstructionFallbackReason;
+    /**
+     * Detailed safety-check diagnostics for fallback decisions.
+     * Present only when atomizer falls back.
+     */
+    fallbackDiagnostics?: ReconstructionFallbackDiagnostics;
+}
+/**
+ * Compare two DOCX documents and produce a document with track changes.
+ *
+ * @param original - The original document (Buffer)
+ * @param revised - The revised document (Buffer)
+ * @param options - Comparison options
+ * @returns The comparison result with track changes markup
+ */
+export declare function compareDocuments(original: Buffer, revised: Buffer, options?: CompareOptions): Promise<CompareResult>;
+export * from './shared/ooxml/namespaces.js';
+export * from './shared/ooxml/types.js';
+export * from './core-types.js';
+export * from './atomizer.js';
+export * from './move-detection.js';
+export * from './format-detection.js';
+export * from './numbering.js';
+export * from './footnotes.js';
+export * from './primitives/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,55 @@
+/**
+ * Document Comparison Engine
+ *
+ * Provides multiple comparison approaches:
+ * - Baseline A: WmlComparer wrapper (Docxodus WASM or dotnet CLI)
+ * - Baseline B: Pure TypeScript (diff-match-patch + OOXML renderer) - paragraph level
+ * - Atomizer: Pure TypeScript with atom-level comparison, move detection, format detection
+ */
+import { compareDocumentsBaselineB } from './baselines/diffmatch/pipeline.js';
+import { compareDocumentsAtomizer } from './baselines/atomizer/pipeline.js';
+/**
+ * Compare two DOCX documents and produce a document with track changes.
+ *
+ * @param original - The original document (Buffer)
+ * @param revised - The revised document (Buffer)
+ * @param options - Comparison options
+ * @returns The comparison result with track changes markup
+ */
+export async function compareDocuments(original, revised, options = {}) {
+    const { engine = 'auto', author, date, reconstructionMode, premergeRuns } = options;
+    // Atomizer engine (recommended) - character-level with move detection
+    if (engine === 'atomizer' || engine === 'auto') {
+        return compareDocumentsAtomizer(original, revised, {
+            author,
+            date,
+            reconstructionMode,
+            premergeRuns,
+        });
+    }
+    // Diffmatch engine - paragraph-level (fallback)
+    if (engine === 'diffmatch') {
+        return compareDocumentsBaselineB(original, revised, { author, date });
+    }
+    // WmlComparer engine requires --docxodus option at CLI level
+    throw new Error('WmlComparer engine is only available through the benchmark CLI. ' +
+        'Use engine: "diffmatch" or "atomizer" for programmatic access.');
+}
+// Re-export shared utilities
+export * from './shared/ooxml/namespaces.js';
+export * from './shared/ooxml/types.js';
+// Re-export core WmlComparer types
+export * from './core-types.js';
+// Re-export atomizer functions
+export * from './atomizer.js';
+// Re-export move detection
+export * from './move-detection.js';
+// Re-export format detection
+export * from './format-detection.js';
+// Re-export numbering utilities
+export * from './numbering.js';
+// Re-export footnote utilities
+export * from './footnotes.js';
+// Re-export primitives (editing, DOM helpers, document operations)
+export * from './primitives/index.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,yBAAyB,EAAE,MAAM,mCAAmC,CAAC;AAC9E,OAAO,EAAE,wBAAwB,EAAE,MAAM,kCAAkC,CAAC;AAiL5E;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,QAAgB,EAChB,OAAe,EACf,UAA0B,EAAE;IAE5B,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,kBAAkB,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC;IAEpF,sEAAsE;IACtE,IAAI,MAAM,KAAK,UAAU,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;QAC/C,OAAO,wBAAwB,CAAC,QAAQ,EAAE,OAAO,EAAE;YACjD,MAAM;YACN,IAAI;YACJ,kBAAkB;YAClB,YAAY;SACb,CAAC,CAAC;IACL,CAAC;IAED,gDAAgD;IAChD,IAAI,MAAM,KAAK,WAAW,EAAE,CAAC;QAC3B,OAAO,yBAAyB,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;IACxE,CAAC;IAED,6DAA6D;IAC7D,MAAM,IAAI,KAAK,CACb,kEAAkE;QAClE,gEAAgE,CACjE,CAAC;AACJ,CAAC;AAED,6BAA6B;AAC7B,cAAc,8BAA8B,CAAC;AAC7C,cAAc,yBAAyB,CAAC;AAExC,mCAAmC;AACnC,cAAc,iBAAiB,CAAC;AAEhC,+BAA+B;AAC/B,cAAc,eAAe,CAAC;AAE9B,2BAA2B;AAC3B,cAAc,qBAAqB,CAAC;AAEpC,6BAA6B;AAC7B,cAAc,uBAAuB,CAAC;AAEtC,gCAAgC;AAChC,cAAc,gBAAgB,CAAC;AAE/B,+BAA+B;AAC/B,cAAc,gBAAgB,CAAC;AAE/B,mEAAmE;AACnE,cAAc,uBAAuB,CAAC"}

package/dist/integration/output-artifacts.d.ts

@@ -0,0 +1,6 @@
+export declare const WRITE_TRACKED_OUTPUT_FIXTURES: boolean;
+export declare const FIXTURE_STABLE_DATE: Date;
+export declare function getIntegrationOutputDir(): string;
+export declare function getIntegrationOutputModeLabel(): string;
+export declare function writeIntegrationArtifact(fileName: string, data: string | NodeJS.ArrayBufferView): Promise<string>;
+//# sourceMappingURL=output-artifacts.d.ts.map

package/dist/integration/output-artifacts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output-artifacts.d.ts","sourceRoot":"","sources":["../../src/integration/output-artifacts.ts"],"names":[],"mappings":"AAgBA,eAAO,MAAM,6BAA6B,SAA0C,CAAC;AACrF,eAAO,MAAM,mBAAmB,MAAmC,CAAC;AAEpE,wBAAgB,uBAAuB,IAAI,MAAM,CAEhD;AAED,wBAAgB,6BAA6B,IAAI,MAAM,CAEtD;AAED,wBAAsB,wBAAwB,CAC5C,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,eAAe,GACpC,OAAO,CAAC,MAAM,CAAC,CAMjB"}

package/dist/integration/output-artifacts.js

@@ -0,0 +1,30 @@
+import { mkdir, writeFile } from 'fs/promises';
+import { tmpdir } from 'os';
+import { dirname, join } from 'path';
+import { fileURLToPath } from 'url';
+const integrationDir = dirname(fileURLToPath(import.meta.url));
+const trackedOutputDir = join(integrationDir, '../testing/outputs');
+const tempOutputDir = join(tmpdir(), 'safe-docx', 'docx-comparison', 'integration-outputs');
+function envEnabled(name) {
+    const value = process.env[name];
+    if (!value)
+        return false;
+    const normalized = value.trim().toLowerCase();
+    return normalized === '1' || normalized === 'true' || normalized === 'yes' || normalized === 'on';
+}
+export const WRITE_TRACKED_OUTPUT_FIXTURES = envEnabled('SDX_WRITE_OUTPUT_FIXTURES');
+export const FIXTURE_STABLE_DATE = new Date('2024-01-01T00:00:00Z');
+export function getIntegrationOutputDir() {
+    return WRITE_TRACKED_OUTPUT_FIXTURES ? trackedOutputDir : tempOutputDir;
+}
+export function getIntegrationOutputModeLabel() {
+    return WRITE_TRACKED_OUTPUT_FIXTURES ? 'tracked fixtures' : 'temporary outputs';
+}
+export async function writeIntegrationArtifact(fileName, data) {
+    const outputDir = getIntegrationOutputDir();
+    await mkdir(outputDir, { recursive: true });
+    const outputPath = join(outputDir, fileName);
+    await writeFile(outputPath, data);
+    return outputPath;
+}
+//# sourceMappingURL=output-artifacts.js.map

package/dist/integration/output-artifacts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output-artifacts.js","sourceRoot":"","sources":["../../src/integration/output-artifacts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,MAAM,EAAE,MAAM,IAAI,CAAC;AAC5B,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AACrC,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AAEpC,MAAM,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAC/D,MAAM,gBAAgB,GAAG,IAAI,CAAC,cAAc,EAAE,oBAAoB,CAAC,CAAC;AACpE,MAAM,aAAa,GAAG,IAAI,CAAC,MAAM,EAAE,EAAE,WAAW,EAAE,iBAAiB,EAAE,qBAAqB,CAAC,CAAC;AAE5F,SAAS,UAAU,CAAC,IAAY;IAC9B,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAChC,IAAI,CAAC,KAAK;QAAE,OAAO,KAAK,CAAC;IACzB,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC9C,OAAO,UAAU,KAAK,GAAG,IAAI,UAAU,KAAK,MAAM,IAAI,UAAU,KAAK,KAAK,IAAI,UAAU,KAAK,IAAI,CAAC;AACpG,CAAC;AAED,MAAM,CAAC,MAAM,6BAA6B,GAAG,UAAU,CAAC,2BAA2B,CAAC,CAAC;AACrF,MAAM,CAAC,MAAM,mBAAmB,GAAG,IAAI,IAAI,CAAC,sBAAsB,CAAC,CAAC;AAEpE,MAAM,UAAU,uBAAuB;IACrC,OAAO,6BAA6B,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,aAAa,CAAC;AAC1E,CAAC;AAED,MAAM,UAAU,6BAA6B;IAC3C,OAAO,6BAA6B,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,mBAAmB,CAAC;AAClF,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,QAAgB,EAChB,IAAqC;IAErC,MAAM,SAAS,GAAG,uBAAuB,EAAE,CAAC;IAC5C,MAAM,KAAK,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5C,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IAC7C,MAAM,SAAS,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;IAClC,OAAO,UAAU,CAAC;AACpB,CAAC"}