docxmlater 10.4.1 → 11.0.4

package/dist/esm/elements/RevisionManager.js

@@ -0,0 +1,486 @@
+import { getGlobalLogger, createScopedLogger } from '../utils/logger.js';
+function getLogger() {
+    return createScopedLogger(getGlobalLogger(), 'RevisionManager');
+}
+export class RevisionManager {
+    revisions = [];
+    nextId = 0;
+    idProvider = null;
+    idExistsNotifier = null;
+    revisionsByTypeCache = new Map();
+    revisionsByAuthorCache = new Map();
+    revisionsByCategoryCache = new Map();
+    invalidateCache() {
+        this.revisionsByTypeCache.clear();
+        this.revisionsByAuthorCache.clear();
+        this.revisionsByCategoryCache.clear();
+    }
+    setIdProvider(provider, existsNotifier) {
+        this.idProvider = provider;
+        this.idExistsNotifier = existsNotifier || null;
+    }
+    register(revision) {
+        const logger = getLogger();
+        const id = this.idProvider ? this.idProvider() : this.nextId++;
+        revision.setId(id);
+        this.revisions.push(revision);
+        this.invalidateCache();
+        logger.debug('Revision registered', {
+            id: revision.getId(),
+            type: revision.getType(),
+            author: revision.getAuthor(),
+        });
+        return revision;
+    }
+    registerExisting(revision) {
+        const logger = getLogger();
+        const existingId = revision.getId();
+        if (this.idExistsNotifier) {
+            this.idExistsNotifier(existingId);
+        }
+        if (existingId >= this.nextId) {
+            this.nextId = existingId + 1;
+        }
+        this.revisions.push(revision);
+        this.invalidateCache();
+        logger.debug('Existing revision registered', {
+            id: existingId,
+            type: revision.getType(),
+            author: revision.getAuthor(),
+        });
+        return revision;
+    }
+    getAllRevisions() {
+        return [...this.revisions];
+    }
+    getRevisionsByType(type) {
+        if (this.revisionsByTypeCache.has(type)) {
+            return [...this.revisionsByTypeCache.get(type)];
+        }
+        const result = this.revisions.filter((rev) => rev.getType() === type);
+        this.revisionsByTypeCache.set(type, result);
+        return [...result];
+    }
+    getRevisionsByAuthor(author) {
+        if (this.revisionsByAuthorCache.has(author)) {
+            return [...this.revisionsByAuthorCache.get(author)];
+        }
+        const result = this.revisions.filter((rev) => rev.getAuthor() === author);
+        this.revisionsByAuthorCache.set(author, result);
+        return [...result];
+    }
+    getCount() {
+        return this.revisions.length;
+    }
+    getInsertionCount() {
+        return this.getRevisionsByType('insert').length;
+    }
+    getDeletionCount() {
+        return this.getRevisionsByType('delete').length;
+    }
+    getAuthors() {
+        const authorsSet = new Set();
+        for (const revision of this.revisions) {
+            authorsSet.add(revision.getAuthor());
+        }
+        return Array.from(authorsSet);
+    }
+    clear() {
+        const count = this.revisions.length;
+        this.revisions = [];
+        this.nextId = 0;
+        this.invalidateCache();
+        if (count > 0) {
+            getLogger().info('Revisions cleared', { previousCount: count });
+        }
+    }
+    isEmpty() {
+        return this.revisions.length === 0;
+    }
+    getRecentRevisions(count) {
+        return [...this.revisions]
+            .sort((a, b) => b.getDate().getTime() - a.getDate().getTime())
+            .slice(0, count);
+    }
+    findRevisionsByText(searchText) {
+        const lowerSearch = searchText.toLowerCase();
+        return this.revisions.filter((revision) => {
+            const text = revision
+                .getRuns()
+                .map((run) => run.getText())
+                .join('')
+                .toLowerCase();
+            return text.includes(lowerSearch);
+        });
+    }
+    getAllInsertions() {
+        return this.getRevisionsByType('insert');
+    }
+    getAllDeletions() {
+        return this.getRevisionsByType('delete');
+    }
+    getAllRunPropertiesChanges() {
+        return this.getRevisionsByType('runPropertiesChange');
+    }
+    getAllParagraphPropertiesChanges() {
+        return this.getRevisionsByType('paragraphPropertiesChange');
+    }
+    getAllTablePropertiesChanges() {
+        return this.getRevisionsByType('tablePropertiesChange');
+    }
+    getAllMoves() {
+        return this.revisions.filter((rev) => rev.getType() === 'moveFrom' || rev.getType() === 'moveTo');
+    }
+    getAllMoveFrom() {
+        return this.getRevisionsByType('moveFrom');
+    }
+    getAllMoveTo() {
+        return this.getRevisionsByType('moveTo');
+    }
+    getAllTableCellChanges() {
+        return this.revisions.filter((rev) => rev.getType() === 'tableCellInsert' ||
+            rev.getType() === 'tableCellDelete' ||
+            rev.getType() === 'tableCellMerge');
+    }
+    getAllNumberingChanges() {
+        return this.getRevisionsByType('numberingChange');
+    }
+    getAllPropertyChanges() {
+        return this.revisions.filter((rev) => rev.getType() === 'runPropertiesChange' ||
+            rev.getType() === 'paragraphPropertiesChange' ||
+            rev.getType() === 'tablePropertiesChange' ||
+            rev.getType() === 'tableRowPropertiesChange' ||
+            rev.getType() === 'tableCellPropertiesChange' ||
+            rev.getType() === 'sectionPropertiesChange' ||
+            rev.getType() === 'numberingChange');
+    }
+    getMovePair(moveId) {
+        const moveFrom = this.revisions.find((rev) => rev.getType() === 'moveFrom' && rev.getMoveId() === moveId);
+        const moveTo = this.revisions.find((rev) => rev.getType() === 'moveTo' && rev.getMoveId() === moveId);
+        return { moveFrom, moveTo };
+    }
+    getStats() {
+        return {
+            total: this.revisions.length,
+            insertions: this.getInsertionCount(),
+            deletions: this.getDeletionCount(),
+            propertyChanges: this.getAllPropertyChanges().length,
+            moves: this.getAllMoves().length,
+            tableCellChanges: this.getAllTableCellChanges().length,
+            authors: this.getAuthors(),
+            nextId: this.nextId,
+        };
+    }
+    isTrackingChanges() {
+        return this.revisions.length > 0;
+    }
+    getLatestRevision() {
+        if (this.revisions.length === 0) {
+            return undefined;
+        }
+        return this.revisions[this.revisions.length - 1];
+    }
+    getRevisionsByDateRange(startDate, endDate) {
+        return this.revisions.filter((rev) => {
+            const revDate = rev.getDate();
+            return revDate >= startDate && revDate <= endDate;
+        });
+    }
+    getNextId() {
+        return this.nextId;
+    }
+    peekNextId() {
+        return this.nextId;
+    }
+    consumeNextId() {
+        return this.idProvider ? this.idProvider() : this.nextId++;
+    }
+    setNextId(id) {
+        this.nextId = id;
+    }
+    static create() {
+        return new RevisionManager();
+    }
+    hasRevisions() {
+        return this.revisions.length > 0;
+    }
+    getByCategory(category) {
+        if (this.revisionsByCategoryCache.has(category)) {
+            return [...this.revisionsByCategoryCache.get(category)];
+        }
+        const result = this.revisions.filter((rev) => {
+            const type = rev.getType();
+            switch (category) {
+                case 'content':
+                    return (type === 'insert' ||
+                        type === 'delete' ||
+                        type === 'imageChange' ||
+                        type === 'fieldChange' ||
+                        type === 'commentChange' ||
+                        type === 'contentControlChange' ||
+                        type === 'hyperlinkChange');
+                case 'formatting':
+                    return (type === 'runPropertiesChange' ||
+                        type === 'paragraphPropertiesChange' ||
+                        type === 'numberingChange');
+                case 'structural':
+                    return (type === 'moveFrom' ||
+                        type === 'moveTo' ||
+                        type === 'sectionPropertiesChange' ||
+                        type === 'bookmarkChange');
+                case 'table':
+                    return (type === 'tablePropertiesChange' ||
+                        type === 'tableExceptionPropertiesChange' ||
+                        type === 'tableRowPropertiesChange' ||
+                        type === 'tableCellPropertiesChange' ||
+                        type === 'tableCellInsert' ||
+                        type === 'tableCellDelete' ||
+                        type === 'tableCellMerge');
+                default:
+                    return false;
+            }
+        });
+        this.revisionsByCategoryCache.set(category, result);
+        return [...result];
+    }
+    getRevisionsForParagraph(paragraphIndex) {
+        if (paragraphIndex < 0) {
+            return [];
+        }
+        return this.revisions.filter((rev) => {
+            const loc = rev.getLocation();
+            if (!loc)
+                return false;
+            return loc.paragraphIndex === paragraphIndex;
+        });
+    }
+    getSummary() {
+        const byCategory = {
+            content: 0,
+            formatting: 0,
+            structural: 0,
+            table: 0,
+        };
+        let earliest = null;
+        let latest = null;
+        for (const rev of this.revisions) {
+            const type = rev.getType();
+            const date = rev.getDate();
+            if (!earliest || date < earliest)
+                earliest = date;
+            if (!latest || date > latest)
+                latest = date;
+            if (type === 'insert' || type === 'delete') {
+                byCategory.content++;
+            }
+            else if (type === 'runPropertiesChange' ||
+                type === 'paragraphPropertiesChange' ||
+                type === 'numberingChange') {
+                byCategory.formatting++;
+            }
+            else if (type === 'moveFrom' || type === 'moveTo' || type === 'sectionPropertiesChange') {
+                byCategory.structural++;
+            }
+            else if (type === 'tablePropertiesChange' ||
+                type === 'tableExceptionPropertiesChange' ||
+                type === 'tableRowPropertiesChange' ||
+                type === 'tableCellPropertiesChange' ||
+                type === 'tableCellInsert' ||
+                type === 'tableCellDelete' ||
+                type === 'tableCellMerge') {
+                byCategory.table++;
+            }
+        }
+        const summary = {
+            total: this.revisions.length,
+            byType: {
+                insertions: this.getInsertionCount(),
+                deletions: this.getDeletionCount(),
+                moves: this.getAllMoves().length,
+                propertyChanges: this.getAllPropertyChanges().length,
+                tableChanges: this.getAllTableCellChanges().length,
+            },
+            byCategory,
+            authors: this.getAuthors(),
+            dateRange: earliest && latest ? { earliest, latest } : null,
+        };
+        if (summary.total > 0) {
+            getLogger().info('Revision summary', {
+                total: summary.total,
+                ins: summary.byType.insertions,
+                del: summary.byType.deletions,
+                fmt: summary.byType.propertyChanges,
+                authors: summary.authors.length,
+            });
+        }
+        return summary;
+    }
+    getById(id) {
+        return this.revisions.find((rev) => rev.getId() === id);
+    }
+    removeById(id) {
+        const index = this.revisions.findIndex((rev) => rev.getId() === id);
+        if (index === -1)
+            return false;
+        this.revisions.splice(index, 1);
+        this.invalidateCache();
+        return true;
+    }
+    getMatching(criteria) {
+        return this.revisions.filter((rev) => {
+            if (criteria.types && !criteria.types.includes(rev.getType())) {
+                return false;
+            }
+            if (criteria.authors && !criteria.authors.includes(rev.getAuthor())) {
+                return false;
+            }
+            if (criteria.categories) {
+                const revCategory = this.getRevisionCategory(rev);
+                if (!criteria.categories.includes(revCategory)) {
+                    return false;
+                }
+            }
+            if (criteria.dateRange) {
+                const date = rev.getDate();
+                if (date < criteria.dateRange.start || date > criteria.dateRange.end) {
+                    return false;
+                }
+            }
+            return true;
+        });
+    }
+    getRevisionCategory(revision) {
+        const type = revision.getType();
+        if (type === 'insert' || type === 'delete') {
+            return 'content';
+        }
+        if (type === 'runPropertiesChange' ||
+            type === 'paragraphPropertiesChange' ||
+            type === 'numberingChange') {
+            return 'formatting';
+        }
+        if (type === 'moveFrom' || type === 'moveTo' || type === 'sectionPropertiesChange') {
+            return 'structural';
+        }
+        if (type === 'tablePropertiesChange' ||
+            type === 'tableExceptionPropertiesChange' ||
+            type === 'tableRowPropertiesChange' ||
+            type === 'tableCellPropertiesChange' ||
+            type === 'tableCellInsert' ||
+            type === 'tableCellDelete' ||
+            type === 'tableCellMerge') {
+            return 'table';
+        }
+        return 'content';
+    }
+    getRevisionsForRun(paragraphIndex, runIndex) {
+        return this.revisions.filter((rev) => {
+            const loc = rev.getLocation();
+            if (!loc)
+                return false;
+            return loc.paragraphIndex === paragraphIndex && loc.runIndex === runIndex;
+        });
+    }
+    getRevisionsByLocation(criteria) {
+        return this.revisions.filter((rev) => {
+            const loc = rev.getLocation();
+            if (!loc)
+                return false;
+            if (criteria.paragraphIndex !== undefined && loc.paragraphIndex !== criteria.paragraphIndex) {
+                return false;
+            }
+            if (criteria.runIndex !== undefined && loc.runIndex !== criteria.runIndex) {
+                return false;
+            }
+            if (criteria.tableRow !== undefined && loc.tableRow !== criteria.tableRow) {
+                return false;
+            }
+            if (criteria.tableCell !== undefined && loc.tableCell !== criteria.tableCell) {
+                return false;
+            }
+            if (criteria.sectionIndex !== undefined && loc.sectionIndex !== criteria.sectionIndex) {
+                return false;
+            }
+            if (criteria.headerFooterType !== undefined &&
+                loc.headerFooterType !== criteria.headerFooterType) {
+                return false;
+            }
+            return true;
+        });
+    }
+    getRevisionsWithLocation() {
+        return this.revisions.filter((rev) => rev.getLocation() !== undefined);
+    }
+    getRevisionsWithoutLocation() {
+        return this.revisions.filter((rev) => rev.getLocation() === undefined);
+    }
+    validateRevisionIds() {
+        const seen = new Set();
+        const duplicates = [];
+        for (const rev of this.revisions) {
+            const id = rev.getId();
+            if (seen.has(id)) {
+                if (!duplicates.includes(id)) {
+                    duplicates.push(id);
+                }
+            }
+            seen.add(id);
+        }
+        return {
+            valid: duplicates.length === 0,
+            duplicates,
+        };
+    }
+    reassignRevisionIds(startId = 0) {
+        let currentId = startId;
+        for (const rev of this.revisions) {
+            rev.setId(currentId++);
+        }
+        this.nextId = currentId;
+        return this.revisions.length;
+    }
+    validateMovePairs() {
+        const moveFromIds = new Map();
+        const moveToIds = new Map();
+        for (const rev of this.revisions) {
+            const moveId = rev.getMoveId();
+            if (!moveId)
+                continue;
+            if (rev.getType() === 'moveFrom') {
+                moveFromIds.set(moveId, rev);
+            }
+            else if (rev.getType() === 'moveTo') {
+                moveToIds.set(moveId, rev);
+            }
+        }
+        const orphanedMoveFrom = [];
+        const orphanedMoveTo = [];
+        for (const moveId of moveFromIds.keys()) {
+            if (!moveToIds.has(moveId)) {
+                orphanedMoveFrom.push(moveId);
+            }
+        }
+        for (const moveId of moveToIds.keys()) {
+            if (!moveFromIds.has(moveId)) {
+                orphanedMoveTo.push(moveId);
+            }
+        }
+        return {
+            valid: orphanedMoveFrom.length === 0 && orphanedMoveTo.length === 0,
+            orphanedMoveFrom,
+            orphanedMoveTo,
+        };
+    }
+    getHighestId() {
+        if (this.revisions.length === 0)
+            return -1;
+        return Math.max(...this.revisions.map((r) => r.getId()));
+    }
+    syncNextId() {
+        const highestId = this.getHighestId();
+        if (highestId >= this.nextId) {
+            this.nextId = highestId + 1;
+        }
+    }
+}
+//# sourceMappingURL=RevisionManager.js.map

package/dist/esm/elements/RevisionManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RevisionManager.js","sourceRoot":"","sources":["../../../src/elements/RevisionManager.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * RevisionManager - Manages tracked changes (revisions) in a document\n *\n * Tracks all revisions, assigns unique IDs, and provides statistics.\n */\n\nimport { Revision, RevisionType } from './Revision.js';\nimport type { RevisionLocation } from './PropertyChangeTypes.js';\nimport { getGlobalLogger, createScopedLogger, ILogger } from '../utils/logger.js';\n\n// Scoped logger for RevisionManager\nfunction getLogger(): ILogger {\n  return createScopedLogger(getGlobalLogger(), 'RevisionManager');\n}\n\n/**\n * Type for the centralized ID provider callback.\n * Returns the next available annotation ID from a shared counter.\n */\nexport type IdProviderCallback = () => number;\n\n/**\n * Type for callback to notify of existing IDs (for synchronization).\n * Called when registering existing revisions to keep the central counter in sync.\n */\nexport type IdExistsCallback = (existingId: number) => void;\n\n/**\n * Semantic category for grouping revisions.\n */\nexport type RevisionCategory =\n  | 'content' // Text insertions, deletions\n  | 'formatting' // Run/paragraph property changes\n  | 'structural' // Moves, section changes\n  | 'table'; // Table structure changes\n\n/**\n * Summary statistics for revisions.\n */\nexport interface RevisionSummary {\n  total: number;\n  byType: {\n    insertions: number;\n    deletions: number;\n    moves: number;\n    propertyChanges: number;\n    tableChanges: number;\n  };\n  byCategory: Record<RevisionCategory, number>;\n  authors: string[];\n  dateRange: { earliest: Date; latest: Date } | null;\n}\n\n/**\n * Manages document revisions (track changes)\n *\n * Per ECMA-376, revision IDs must be unique across ALL annotation types\n * in a document. Use setIdProvider() to connect to a centralized ID allocator.\n */\nexport class RevisionManager {\n  private revisions: Revision[] = [];\n  private nextId = 0;\n  private idProvider: IdProviderCallback | null = null;\n  private idExistsNotifier: IdExistsCallback | null = null;\n\n  // Performance caching for frequently accessed filtered results\n  private revisionsByTypeCache = new Map<RevisionType, Revision[]>();\n  private revisionsByAuthorCache = new Map<string, Revision[]>();\n  private revisionsByCategoryCache = new Map<RevisionCategory, Revision[]>();\n  /**\n   * Invalidates all caches. Called when revisions are added/removed.\n   * @private\n   */\n  private invalidateCache(): void {\n    this.revisionsByTypeCache.clear();\n    this.revisionsByAuthorCache.clear();\n    this.revisionsByCategoryCache.clear();\n    // Cache cleared\n  }\n\n  /**\n   * Sets the centralized ID provider callback.\n   * When set, IDs will be allocated from the centralized DocumentIdManager\n   * instead of the local nextId counter.\n   *\n   * @param provider - Callback that returns the next available ID\n   * @param existsNotifier - Optional callback to notify when existing IDs are found\n   */\n  setIdProvider(provider: IdProviderCallback, existsNotifier?: IdExistsCallback): void {\n    this.idProvider = provider;\n    this.idExistsNotifier = existsNotifier || null;\n  }\n\n  /**\n   * Registers a revision with the manager\n   * Assigns a unique ID\n   * @param revision - Revision to register\n   * @returns The registered revision (same instance)\n   */\n  register(revision: Revision): Revision {\n    const logger = getLogger();\n    // Assign unique ID - use centralized provider if available\n    const id = this.idProvider ? this.idProvider() : this.nextId++;\n    revision.setId(id);\n\n    // Store revision\n    this.revisions.push(revision);\n    this.invalidateCache();\n\n    logger.debug('Revision registered', {\n      id: revision.getId(),\n      type: revision.getType(),\n      author: revision.getAuthor(),\n    });\n\n    return revision;\n  }\n\n  /**\n   * Registers an existing revision (from parsing) with its pre-assigned ID.\n   * Unlike register(), this does NOT assign a new ID - preserves the original\n   * ID from parsed XML. Used when loading documents to avoid overwriting\n   * revision IDs that are already correct.\n   *\n   * @param revision - Revision with ID already set from XML parsing\n   * @returns The registered revision (same instance)\n   */\n  registerExisting(revision: Revision): Revision {\n    const logger = getLogger();\n    const existingId = revision.getId();\n\n    // Notify centralized ID manager about this existing ID\n    // This ensures the shared counter stays above all existing IDs\n    if (this.idExistsNotifier) {\n      this.idExistsNotifier(existingId);\n    }\n\n    // Also update local nextId to avoid collisions (fallback when no provider)\n    if (existingId >= this.nextId) {\n      this.nextId = existingId + 1;\n    }\n\n    // Store revision (keep its existing ID - do NOT overwrite)\n    this.revisions.push(revision);\n    this.invalidateCache();\n\n    logger.debug('Existing revision registered', {\n      id: existingId,\n      type: revision.getType(),\n      author: revision.getAuthor(),\n    });\n\n    return revision;\n  }\n\n  /**\n   * Gets all revisions\n   * @returns Array of all revisions\n   */\n  getAllRevisions(): Revision[] {\n    return [...this.revisions];\n  }\n\n  /**\n   * Gets revisions by type\n   * Uses caching for improved performance on repeated calls\n   * @param type - Revision type to filter by\n   * @returns Array of revisions of the specified type\n   */\n  getRevisionsByType(type: RevisionType): Revision[] {\n    // Check cache first\n    if (this.revisionsByTypeCache.has(type)) {\n      return [...this.revisionsByTypeCache.get(type)!];\n    }\n\n    // Compute and cache\n    const result = this.revisions.filter((rev) => rev.getType() === type);\n    this.revisionsByTypeCache.set(type, result);\n    return [...result];\n  }\n\n  /**\n   * Gets revisions by author\n   * Uses caching for improved performance on repeated calls\n   * @param author - Author name to filter by\n   * @returns Array of revisions by the specified author\n   */\n  getRevisionsByAuthor(author: string): Revision[] {\n    // Check cache first\n    if (this.revisionsByAuthorCache.has(author)) {\n      return [...this.revisionsByAuthorCache.get(author)!];\n    }\n\n    // Compute and cache\n    const result = this.revisions.filter((rev) => rev.getAuthor() === author);\n    this.revisionsByAuthorCache.set(author, result);\n    return [...result];\n  }\n\n  /**\n   * Gets the number of revisions\n   * @returns Number of revisions\n   */\n  getCount(): number {\n    return this.revisions.length;\n  }\n\n  /**\n   * Gets the number of insertions\n   * @returns Number of insertion revisions\n   */\n  getInsertionCount(): number {\n    return this.getRevisionsByType('insert').length;\n  }\n\n  /**\n   * Gets the number of deletions\n   * @returns Number of deletion revisions\n   */\n  getDeletionCount(): number {\n    return this.getRevisionsByType('delete').length;\n  }\n\n  /**\n   * Gets all unique authors who have made changes\n   * @returns Array of unique author names\n   */\n  getAuthors(): string[] {\n    const authorsSet = new Set<string>();\n    for (const revision of this.revisions) {\n      authorsSet.add(revision.getAuthor());\n    }\n    return Array.from(authorsSet);\n  }\n\n  /**\n   * Clears all revisions\n   */\n  clear(): void {\n    const count = this.revisions.length;\n    this.revisions = [];\n    this.nextId = 0;\n    this.invalidateCache();\n    if (count > 0) {\n      getLogger().info('Revisions cleared', { previousCount: count });\n    }\n  }\n\n  /**\n   * Checks if there are no revisions\n   * @returns True if there are no tracked changes\n   */\n  isEmpty(): boolean {\n    return this.revisions.length === 0;\n  }\n\n  /**\n   * Gets the most recent N revisions\n   * @param count - Number of recent revisions to return\n   * @returns Array of most recent revisions\n   */\n  getRecentRevisions(count: number): Revision[] {\n    return [...this.revisions]\n      .sort((a, b) => b.getDate().getTime() - a.getDate().getTime())\n      .slice(0, count);\n  }\n\n  /**\n   * Searches revisions by text content\n   * @param searchText - Text to search for (case-insensitive)\n   * @returns Array of revisions containing the search text\n   */\n  findRevisionsByText(searchText: string): Revision[] {\n    const lowerSearch = searchText.toLowerCase();\n    return this.revisions.filter((revision) => {\n      const text = revision\n        .getRuns()\n        .map((run) => run.getText())\n        .join('')\n        .toLowerCase();\n      return text.includes(lowerSearch);\n    });\n  }\n\n  /**\n   * Gets all insertions (added text)\n   * @returns Array of insertion revisions\n   */\n  getAllInsertions(): Revision[] {\n    return this.getRevisionsByType('insert');\n  }\n\n  /**\n   * Gets all deletions (removed text)\n   * @returns Array of deletion revisions\n   */\n  getAllDeletions(): Revision[] {\n    return this.getRevisionsByType('delete');\n  }\n\n  /**\n   * Gets all run properties changes (formatting changes)\n   * @returns Array of run property change revisions\n   */\n  getAllRunPropertiesChanges(): Revision[] {\n    return this.getRevisionsByType('runPropertiesChange');\n  }\n\n  /**\n   * Gets all paragraph properties changes\n   * @returns Array of paragraph property change revisions\n   */\n  getAllParagraphPropertiesChanges(): Revision[] {\n    return this.getRevisionsByType('paragraphPropertiesChange');\n  }\n\n  /**\n   * Gets all table properties changes\n   * @returns Array of table property change revisions\n   */\n  getAllTablePropertiesChanges(): Revision[] {\n    return this.getRevisionsByType('tablePropertiesChange');\n  }\n\n  /**\n   * Gets all move operations (both moveFrom and moveTo)\n   * @returns Array of move-related revisions\n   */\n  getAllMoves(): Revision[] {\n    return this.revisions.filter(\n      (rev) => rev.getType() === 'moveFrom' || rev.getType() === 'moveTo'\n    );\n  }\n\n  /**\n   * Gets all moveFrom revisions (source of moves)\n   * @returns Array of moveFrom revisions\n   */\n  getAllMoveFrom(): Revision[] {\n    return this.getRevisionsByType('moveFrom');\n  }\n\n  /**\n   * Gets all moveTo revisions (destination of moves)\n   * @returns Array of moveTo revisions\n   */\n  getAllMoveTo(): Revision[] {\n    return this.getRevisionsByType('moveTo');\n  }\n\n  /**\n   * Gets all table cell changes (insert, delete, merge)\n   * @returns Array of table cell change revisions\n   */\n  getAllTableCellChanges(): Revision[] {\n    return this.revisions.filter(\n      (rev) =>\n        rev.getType() === 'tableCellInsert' ||\n        rev.getType() === 'tableCellDelete' ||\n        rev.getType() === 'tableCellMerge'\n    );\n  }\n\n  /**\n   * Gets all numbering changes\n   * @returns Array of numbering change revisions\n   */\n  getAllNumberingChanges(): Revision[] {\n    return this.getRevisionsByType('numberingChange');\n  }\n\n  /**\n   * Gets all property change revisions (run, paragraph, table, etc.)\n   * @returns Array of all property change revisions\n   */\n  getAllPropertyChanges(): Revision[] {\n    return this.revisions.filter(\n      (rev) =>\n        rev.getType() === 'runPropertiesChange' ||\n        rev.getType() === 'paragraphPropertiesChange' ||\n        rev.getType() === 'tablePropertiesChange' ||\n        rev.getType() === 'tableRowPropertiesChange' ||\n        rev.getType() === 'tableCellPropertiesChange' ||\n        rev.getType() === 'sectionPropertiesChange' ||\n        rev.getType() === 'numberingChange'\n    );\n  }\n\n  /**\n   * Gets move pair by move ID\n   * @param moveId - Move operation ID\n   * @returns Object with moveFrom and moveTo revisions (if found)\n   */\n  getMovePair(moveId: string): { moveFrom?: Revision; moveTo?: Revision } {\n    const moveFrom = this.revisions.find(\n      (rev) => rev.getType() === 'moveFrom' && rev.getMoveId() === moveId\n    );\n    const moveTo = this.revisions.find(\n      (rev) => rev.getType() === 'moveTo' && rev.getMoveId() === moveId\n    );\n    return { moveFrom, moveTo };\n  }\n\n  /**\n   * Gets statistics about revisions\n   * @returns Object with revision statistics\n   */\n  getStats(): {\n    total: number;\n    insertions: number;\n    deletions: number;\n    propertyChanges: number;\n    moves: number;\n    tableCellChanges: number;\n    authors: string[];\n    nextId: number;\n  } {\n    return {\n      total: this.revisions.length,\n      insertions: this.getInsertionCount(),\n      deletions: this.getDeletionCount(),\n      propertyChanges: this.getAllPropertyChanges().length,\n      moves: this.getAllMoves().length,\n      tableCellChanges: this.getAllTableCellChanges().length,\n      authors: this.getAuthors(),\n      nextId: this.nextId,\n    };\n  }\n\n  /**\n   * Checks if track changes is enabled (has any revisions)\n   * @returns True if there are revisions\n   */\n  isTrackingChanges(): boolean {\n    return this.revisions.length > 0;\n  }\n\n  /**\n   * Gets the most recent revision\n   * @returns The most recent revision, or undefined if no revisions\n   */\n  getLatestRevision(): Revision | undefined {\n    if (this.revisions.length === 0) {\n      return undefined;\n    }\n    return this.revisions[this.revisions.length - 1];\n  }\n\n  /**\n   * Gets revisions within a date range\n   * @param startDate - Start of date range\n   * @param endDate - End of date range\n   * @returns Array of revisions within the date range\n   */\n  getRevisionsByDateRange(startDate: Date, endDate: Date): Revision[] {\n    return this.revisions.filter((rev) => {\n      const revDate = rev.getDate();\n      return revDate >= startDate && revDate <= endDate;\n    });\n  }\n\n  /**\n   * Gets the next available revision ID without consuming it.\n   *\n   * This is an alias for peekNextId() for backward compatibility.\n   * Use consumeNextId() if you need to reserve an ID for manual use.\n   *\n   * @returns Next available revision ID (without consuming it)\n   * @see consumeNextId for reserving IDs\n   * @see register for automatic ID assignment\n   */\n  getNextId(): number {\n    return this.nextId;\n  }\n\n  /**\n   * Peeks at the next revision ID without incrementing\n   * @returns Next available revision ID (without consuming it)\n   */\n  peekNextId(): number {\n    return this.nextId;\n  }\n\n  /**\n   * Consumes and returns the next revision ID.\n   *\n   * Use this when you need to manually assign an ID to a revision\n   * that won't be registered through register(). The ID is reserved\n   * and won't be reused by subsequent register() calls.\n   *\n   * When a centralized ID provider is set, IDs come from the shared counter.\n   *\n   * @returns The consumed revision ID\n   *\n   * @example\n   * ```typescript\n   * // Reserve an ID for manual assignment\n   * const id = revisionManager.consumeNextId();\n   * revision.setId(id);\n   * // Don't call register() - the ID is already consumed\n   * ```\n   */\n  consumeNextId(): number {\n    // Use centralized provider if available\n    return this.idProvider ? this.idProvider() : this.nextId++;\n  }\n\n  /**\n   * Sets the next ID to be assigned.\n   * Used when loading documents to avoid ID collisions with existing revisions.\n   * @param id - The next ID value to use\n   */\n  setNextId(id: number): void {\n    this.nextId = id;\n  }\n\n  /**\n   * Creates a new RevisionManager\n   * @returns New RevisionManager instance\n   */\n  static create(): RevisionManager {\n    return new RevisionManager();\n  }\n\n  // ═══════════════════════════════════════════════════════════════════════════\n  // NEW METHODS - Added for ChangelogGenerator and RevisionAwareProcessor\n  // ═══════════════════════════════════════════════════════════════════════════\n\n  /**\n   * Check if any revisions exist in the manager.\n   * @returns True if there are any revisions\n   */\n  hasRevisions(): boolean {\n    return this.revisions.length > 0;\n  }\n\n  /**\n   * Get revisions by semantic category.\n   *\n   * Categories:\n   * - content: insert, delete, imageChange, fieldChange, commentChange, contentControlChange, hyperlinkChange\n   * - formatting: runPropertiesChange, paragraphPropertiesChange, numberingChange\n   * - structural: moveFrom, moveTo, sectionPropertiesChange, bookmarkChange\n   * - table: tablePropertiesChange, tableCellInsert, tableCellDelete, tableCellMerge, etc.\n   *\n   * @param category - Semantic category to filter by\n   * @returns Array of revisions in the specified category\n   */\n  getByCategory(category: RevisionCategory): Revision[] {\n    // Check cache first\n    if (this.revisionsByCategoryCache.has(category)) {\n      return [...this.revisionsByCategoryCache.get(category)!];\n    }\n\n    // Compute and cache\n    const result = this.revisions.filter((rev) => {\n      const type = rev.getType();\n      switch (category) {\n        case 'content':\n          return (\n            type === 'insert' ||\n            type === 'delete' ||\n            // Internal tracking types for rich content changes\n            type === 'imageChange' ||\n            type === 'fieldChange' ||\n            type === 'commentChange' ||\n            type === 'contentControlChange' ||\n            type === 'hyperlinkChange'\n          );\n\n        case 'formatting':\n          return (\n            type === 'runPropertiesChange' ||\n            type === 'paragraphPropertiesChange' ||\n            type === 'numberingChange'\n          );\n\n        case 'structural':\n          return (\n            type === 'moveFrom' ||\n            type === 'moveTo' ||\n            type === 'sectionPropertiesChange' ||\n            // Bookmarks are structural markers\n            type === 'bookmarkChange'\n          );\n\n        case 'table':\n          return (\n            type === 'tablePropertiesChange' ||\n            type === 'tableExceptionPropertiesChange' ||\n            type === 'tableRowPropertiesChange' ||\n            type === 'tableCellPropertiesChange' ||\n            type === 'tableCellInsert' ||\n            type === 'tableCellDelete' ||\n            type === 'tableCellMerge'\n          );\n\n        default:\n          return false;\n      }\n    });\n    this.revisionsByCategoryCache.set(category, result);\n    return [...result];\n  }\n\n  /**\n   * Get revisions affecting a specific paragraph.\n   *\n   * Uses the revision's location data if available. Returns revisions\n   * where location.paragraphIndex matches the specified index.\n   *\n   * Note: Revisions must have location data set (via setLocation()) for\n   * accurate filtering. Revisions without location data are excluded.\n   *\n   * @param paragraphIndex - Index of the paragraph (0-based)\n   * @returns Array of revisions affecting the specified paragraph\n   *\n   * @example\n   * ```typescript\n   * const revisions = revisionManager.getRevisionsForParagraph(3);\n   * console.log(`${revisions.length} revisions affect paragraph 3`);\n   * ```\n   */\n  getRevisionsForParagraph(paragraphIndex: number): Revision[] {\n    if (paragraphIndex < 0) {\n      return [];\n    }\n    return this.revisions.filter((rev) => {\n      const loc = rev.getLocation();\n      if (!loc) return false;\n      return loc.paragraphIndex === paragraphIndex;\n    });\n  }\n\n  /**\n   * Get summary statistics for all revisions.\n   * Provides comprehensive breakdown by type, category, and author.\n   *\n   * @returns Summary statistics object\n   */\n  getSummary(): RevisionSummary {\n    const byCategory: Record<RevisionCategory, number> = {\n      content: 0,\n      formatting: 0,\n      structural: 0,\n      table: 0,\n    };\n\n    let earliest: Date | null = null;\n    let latest: Date | null = null;\n\n    // Count by category and track date range\n    for (const rev of this.revisions) {\n      const type = rev.getType();\n      const date = rev.getDate();\n\n      // Update date range\n      if (!earliest || date < earliest) earliest = date;\n      if (!latest || date > latest) latest = date;\n\n      // Categorize\n      if (type === 'insert' || type === 'delete') {\n        byCategory.content++;\n      } else if (\n        type === 'runPropertiesChange' ||\n        type === 'paragraphPropertiesChange' ||\n        type === 'numberingChange'\n      ) {\n        byCategory.formatting++;\n      } else if (type === 'moveFrom' || type === 'moveTo' || type === 'sectionPropertiesChange') {\n        byCategory.structural++;\n      } else if (\n        type === 'tablePropertiesChange' ||\n        type === 'tableExceptionPropertiesChange' ||\n        type === 'tableRowPropertiesChange' ||\n        type === 'tableCellPropertiesChange' ||\n        type === 'tableCellInsert' ||\n        type === 'tableCellDelete' ||\n        type === 'tableCellMerge'\n      ) {\n        byCategory.table++;\n      }\n    }\n\n    const summary = {\n      total: this.revisions.length,\n      byType: {\n        insertions: this.getInsertionCount(),\n        deletions: this.getDeletionCount(),\n        moves: this.getAllMoves().length,\n        propertyChanges: this.getAllPropertyChanges().length,\n        tableChanges: this.getAllTableCellChanges().length,\n      },\n      byCategory,\n      authors: this.getAuthors(),\n      dateRange: earliest && latest ? { earliest, latest } : null,\n    };\n\n    if (summary.total > 0) {\n      getLogger().info('Revision summary', {\n        total: summary.total,\n        ins: summary.byType.insertions,\n        del: summary.byType.deletions,\n        fmt: summary.byType.propertyChanges,\n        authors: summary.authors.length,\n      });\n    }\n\n    return summary;\n  }\n\n  /**\n   * Get a revision by its ID.\n   *\n   * @param id - Revision ID to find\n   * @returns Revision with the specified ID, or undefined\n   */\n  getById(id: number): Revision | undefined {\n    return this.revisions.find((rev) => rev.getId() === id);\n  }\n\n  /**\n   * Remove a revision by its ID.\n   *\n   * @param id - ID of the revision to remove\n   * @returns True if revision was found and removed\n   */\n  removeById(id: number): boolean {\n    const index = this.revisions.findIndex((rev) => rev.getId() === id);\n    if (index === -1) return false;\n\n    this.revisions.splice(index, 1);\n    this.invalidateCache();\n    return true;\n  }\n\n  /**\n   * Get revisions matching multiple criteria.\n   *\n   * @param criteria - Filter criteria\n   * @returns Array of matching revisions\n   */\n  getMatching(criteria: {\n    types?: RevisionType[];\n    authors?: string[];\n    categories?: RevisionCategory[];\n    dateRange?: { start: Date; end: Date };\n  }): Revision[] {\n    return this.revisions.filter((rev) => {\n      // Filter by types\n      if (criteria.types && !criteria.types.includes(rev.getType())) {\n        return false;\n      }\n\n      // Filter by authors\n      if (criteria.authors && !criteria.authors.includes(rev.getAuthor())) {\n        return false;\n      }\n\n      // Filter by categories\n      if (criteria.categories) {\n        const revCategory = this.getRevisionCategory(rev);\n        if (!criteria.categories.includes(revCategory)) {\n          return false;\n        }\n      }\n\n      // Filter by date range\n      if (criteria.dateRange) {\n        const date = rev.getDate();\n        if (date < criteria.dateRange.start || date > criteria.dateRange.end) {\n          return false;\n        }\n      }\n\n      return true;\n    });\n  }\n\n  /**\n   * Get the semantic category of a revision.\n   * @internal\n   */\n  private getRevisionCategory(revision: Revision): RevisionCategory {\n    const type = revision.getType();\n\n    if (type === 'insert' || type === 'delete') {\n      return 'content';\n    }\n    if (\n      type === 'runPropertiesChange' ||\n      type === 'paragraphPropertiesChange' ||\n      type === 'numberingChange'\n    ) {\n      return 'formatting';\n    }\n    if (type === 'moveFrom' || type === 'moveTo' || type === 'sectionPropertiesChange') {\n      return 'structural';\n    }\n    if (\n      type === 'tablePropertiesChange' ||\n      type === 'tableExceptionPropertiesChange' ||\n      type === 'tableRowPropertiesChange' ||\n      type === 'tableCellPropertiesChange' ||\n      type === 'tableCellInsert' ||\n      type === 'tableCellDelete' ||\n      type === 'tableCellMerge'\n    ) {\n      return 'table';\n    }\n\n    // Default\n    return 'content';\n  }\n\n  // ============================================================\n  // Location-Aware Methods\n  // ============================================================\n\n  /**\n   * Gets revisions affecting a specific run within a paragraph.\n   *\n   * Uses the revision's location data if available.\n   *\n   * @param paragraphIndex - Index of the paragraph (0-based)\n   * @param runIndex - Index of the run within the paragraph (0-based)\n   * @returns Array of revisions affecting the specified run\n   *\n   * @example\n   * ```typescript\n   * const revisions = revisionManager.getRevisionsForRun(0, 2);\n   * console.log(`${revisions.length} revisions affect run 2 in paragraph 0`);\n   * ```\n   */\n  getRevisionsForRun(paragraphIndex: number, runIndex: number): Revision[] {\n    return this.revisions.filter((rev) => {\n      const loc = rev.getLocation();\n      if (!loc) return false;\n      return loc.paragraphIndex === paragraphIndex && loc.runIndex === runIndex;\n    });\n  }\n\n  /**\n   * Gets revisions by location criteria.\n   *\n   * Filters revisions based on their location within the document structure.\n   * All specified criteria must match (AND logic).\n   *\n   * @param criteria - Location filter criteria\n   * @returns Array of revisions matching the criteria\n   *\n   * @example\n   * ```typescript\n   * // Get all revisions in paragraph 5\n   * const paraRevisions = revisionManager.getRevisionsByLocation({\n   *   paragraphIndex: 5\n   * });\n   *\n   * // Get all revisions in table row 2, cell 1\n   * const cellRevisions = revisionManager.getRevisionsByLocation({\n   *   tableRow: 2,\n   *   tableCell: 1\n   * });\n   * ```\n   */\n  getRevisionsByLocation(criteria: Partial<RevisionLocation>): Revision[] {\n    return this.revisions.filter((rev) => {\n      const loc = rev.getLocation();\n      if (!loc) return false;\n\n      // Check each criteria if specified\n      if (criteria.paragraphIndex !== undefined && loc.paragraphIndex !== criteria.paragraphIndex) {\n        return false;\n      }\n      if (criteria.runIndex !== undefined && loc.runIndex !== criteria.runIndex) {\n        return false;\n      }\n      if (criteria.tableRow !== undefined && loc.tableRow !== criteria.tableRow) {\n        return false;\n      }\n      if (criteria.tableCell !== undefined && loc.tableCell !== criteria.tableCell) {\n        return false;\n      }\n      if (criteria.sectionIndex !== undefined && loc.sectionIndex !== criteria.sectionIndex) {\n        return false;\n      }\n      if (\n        criteria.headerFooterType !== undefined &&\n        loc.headerFooterType !== criteria.headerFooterType\n      ) {\n        return false;\n      }\n\n      return true;\n    });\n  }\n\n  /**\n   * Gets revisions that have location data.\n   *\n   * @returns Array of revisions with location information\n   */\n  getRevisionsWithLocation(): Revision[] {\n    return this.revisions.filter((rev) => rev.getLocation() !== undefined);\n  }\n\n  /**\n   * Gets revisions that do NOT have location data.\n   *\n   * @returns Array of revisions without location information\n   */\n  getRevisionsWithoutLocation(): Revision[] {\n    return this.revisions.filter((rev) => rev.getLocation() === undefined);\n  }\n\n  // ============================================================\n  // Validation Methods\n  // ============================================================\n\n  /**\n   * Validates that all revision IDs are unique.\n   *\n   * Per ECMA-376, revision IDs must be unique within a document.\n   * Duplicate IDs can cause Word to reject the document or\n   * produce unexpected behavior.\n   *\n   * @returns Validation result with any duplicate IDs found\n   *\n   * @example\n   * ```typescript\n   * const result = revisionManager.validateRevisionIds();\n   * if (!result.valid) {\n   *   console.error('Duplicate IDs found:', result.duplicates);\n   * }\n   * ```\n   */\n  validateRevisionIds(): { valid: boolean; duplicates: number[] } {\n    const seen = new Set<number>();\n    const duplicates: number[] = [];\n\n    for (const rev of this.revisions) {\n      const id = rev.getId();\n      if (seen.has(id)) {\n        if (!duplicates.includes(id)) {\n          duplicates.push(id);\n        }\n      }\n      seen.add(id);\n    }\n\n    return {\n      valid: duplicates.length === 0,\n      duplicates,\n    };\n  }\n\n  /**\n   * Reassigns all revision IDs to ensure uniqueness.\n   *\n   * This is useful after merging documents or when duplicate\n   * IDs are detected. IDs are reassigned sequentially starting\n   * from the specified value.\n   *\n   * @param startId - Starting ID value (default: 0)\n   * @returns Number of IDs reassigned\n   *\n   * @example\n   * ```typescript\n   * const count = revisionManager.reassignRevisionIds();\n   * console.log(`Reassigned ${count} revision IDs`);\n   * ```\n   */\n  reassignRevisionIds(startId = 0): number {\n    let currentId = startId;\n\n    for (const rev of this.revisions) {\n      rev.setId(currentId++);\n    }\n\n    // Update nextId to continue from where we left off\n    this.nextId = currentId;\n\n    return this.revisions.length;\n  }\n\n  /**\n   * Validates move operation pairs (moveFrom/moveTo).\n   *\n   * Each moveFrom must have a matching moveTo with the same moveId,\n   * and vice versa. Orphaned move markers can cause document corruption.\n   *\n   * @returns Validation result with orphaned move IDs\n   *\n   * @example\n   * ```typescript\n   * const result = revisionManager.validateMovePairs();\n   * if (!result.valid) {\n   *   console.error('Orphaned moveFrom IDs:', result.orphanedMoveFrom);\n   *   console.error('Orphaned moveTo IDs:', result.orphanedMoveTo);\n   * }\n   * ```\n   */\n  validateMovePairs(): {\n    valid: boolean;\n    orphanedMoveFrom: string[];\n    orphanedMoveTo: string[];\n  } {\n    const moveFromIds = new Map<string, Revision>();\n    const moveToIds = new Map<string, Revision>();\n\n    for (const rev of this.revisions) {\n      const moveId = rev.getMoveId();\n      if (!moveId) continue;\n\n      if (rev.getType() === 'moveFrom') {\n        moveFromIds.set(moveId, rev);\n      } else if (rev.getType() === 'moveTo') {\n        moveToIds.set(moveId, rev);\n      }\n    }\n\n    const orphanedMoveFrom: string[] = [];\n    const orphanedMoveTo: string[] = [];\n\n    // Find moveFrom without matching moveTo\n    for (const moveId of moveFromIds.keys()) {\n      if (!moveToIds.has(moveId)) {\n        orphanedMoveFrom.push(moveId);\n      }\n    }\n\n    // Find moveTo without matching moveFrom\n    for (const moveId of moveToIds.keys()) {\n      if (!moveFromIds.has(moveId)) {\n        orphanedMoveTo.push(moveId);\n      }\n    }\n\n    return {\n      valid: orphanedMoveFrom.length === 0 && orphanedMoveTo.length === 0,\n      orphanedMoveFrom,\n      orphanedMoveTo,\n    };\n  }\n\n  /**\n   * Gets the highest revision ID currently in use.\n   *\n   * @returns Highest ID, or -1 if no revisions exist\n   */\n  getHighestId(): number {\n    if (this.revisions.length === 0) return -1;\n    return Math.max(...this.revisions.map((r) => r.getId()));\n  }\n\n  /**\n   * Ensures the next ID is higher than all existing IDs.\n   *\n   * Useful after loading a document with existing revisions\n   * to prevent ID conflicts with new revisions.\n   */\n  syncNextId(): void {\n    const highestId = this.getHighestId();\n    if (highestId >= this.nextId) {\n      this.nextId = highestId + 1;\n    }\n  }\n}\n"]}