docxmlater 11.0.9 → 12.0.1

package/dist/esm/elements/ImageManager.js

@@ -91,6 +91,9 @@ export class ImageManager {
         const oldFilename = entry.filename;
         if (oldFilename === newFilename)
             return oldFilename;
+        if (this.isFilenameOwnedByOther(newFilename, oldFilename)) {
+            throw new Error(`Cannot rename image to "${newFilename}": filename already in use by a different image`);
+        }
         for (const e of this.images.values()) {
             if (e.filename === oldFilename)
                 e.filename = newFilename;
@@ -101,6 +104,14 @@ export class ImageManager {
         }
         return oldFilename;
     }
+    isFilenameOwnedByOther(filename, excludeFilename) {
+        for (const e of this.images.values()) {
+            if (e.filename === filename && e.filename !== excludeFilename) {
+                return true;
+            }
+        }
+        return false;
+    }
     getAllImages() {
         return Array.from(this.images.values());
     }

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

@@ -1 +1 @@
-{"version":3,"file":"ImageManager.js","sourceRoot":"","sources":["../../../src/elements/ImageManager.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * ImageManager - Manages images in a document\n *\n * Handles image tracking, unique filename generation, and coordination\n * with the RelationshipManager for image relationships.\n */\n\nimport { Image } from './Image.js';\nimport { defaultLogger } from '../utils/logger.js';\n\n/**\n * Image file entry\n */\ninterface ImageEntry {\n  /** The Image object */\n  image: Image;\n  /** Filename in media folder (e.g., 'image1.png') */\n  filename: string;\n  /** Relationship ID */\n  relationshipId: string;\n  /** Document property ID (for DrawingML) */\n  docPrId: number;\n}\n\n/**\n * Image manager options\n */\nexport interface ImageManagerOptions {\n  /** Maximum number of images allowed. Default: 1000 */\n  maxImageCount?: number;\n  /** Maximum total size of all images in MB. Default: 100 */\n  maxTotalImageSizeMB?: number;\n  /** Maximum size of a single image in MB. Default: 20 */\n  maxSingleImageSizeMB?: number;\n}\n\n/**\n * Manages all images in a document\n */\nexport class ImageManager {\n  private images: Map<Image, ImageEntry>;\n  private imagesByRelId: Map<string, ImageEntry>; // Track by relationship ID (Issue #12 fix)\n  private nextImageNumber: number;\n  private nextDocPrId: number;\n  private maxImageCount: number;\n  private maxTotalImageSizeBytes: number;\n  private maxSingleImageSizeBytes: number;\n\n  /**\n   * Creates a new image manager\n   * @param options Image manager options\n   */\n  constructor(options: ImageManagerOptions = {}) {\n    this.images = new Map();\n    this.imagesByRelId = new Map(); // Issue #12 fix\n    this.nextImageNumber = 1;\n    this.nextDocPrId = 1;\n    // Increased from 20 to 1000 to support production documents with many images\n    this.maxImageCount = options.maxImageCount ?? 1000;\n    this.maxTotalImageSizeBytes = (options.maxTotalImageSizeMB ?? 100) * 1024 * 1024;\n    this.maxSingleImageSizeBytes = (options.maxSingleImageSizeMB ?? 20) * 1024 * 1024;\n  }\n\n  /**\n   * Registers an image with the manager\n   * @param image The image to register\n   * @param relationshipId The relationship ID for this image\n   * @param originalFilename Optional original filename from the source document.\n   *   When provided (during parsing), preserves the original filename to maintain\n   *   consistency with relationship targets. When not provided (adding new images),\n   *   generates a new sequential filename.\n   * @param partName Optional part name (e.g., 'header1.xml', 'footer1.xml') for\n   *   distinguishing relationship IDs from different document parts. Headers and footers\n   *   have their own .rels files, so rId1 in header1.xml is different from rId1 in document.xml.\n   * @returns The filename assigned to this image\n   * @throws {Error} If image limits are exceeded\n   *\n   * **Issue #12 Fix:** Reuses filename for images with same relationship ID\n   * to prevent duplicating files in media folder during save.\n   * However, each image occurrence gets its own entry to preserve dimensions\n   * (Word allows same image file displayed at different sizes via wp:extent).\n   */\n  registerImage(\n    image: Image,\n    relationshipId: string,\n    originalFilename?: string,\n    partName?: string\n  ): string {\n    // Check if already registered by object reference (exact same object)\n    const existing = this.images.get(image);\n    if (existing) {\n      return existing.filename;\n    }\n\n    // Issue #12 fix: Reuse FILENAME for same rId, but create separate entry\n    // This prevents duplicate files in media folder while preserving dimensions\n    // Use composite key with partName to distinguish headers/footers from document body\n    const relIdKey = partName ? `${partName}:${relationshipId}` : relationshipId;\n    const existingByRelId = this.imagesByRelId.get(relIdKey);\n\n    // Filename priority:\n    // 1. Existing filename for same rId (prevents duplicates)\n    // 2. Original filename from source document (preserves round-trip integrity)\n    // 3. Generate new sequential filename (for newly added images)\n    const filename = existingByRelId\n      ? existingByRelId.filename\n      : originalFilename || `image${this.nextImageNumber++}.${image.getExtension()}`;\n\n    // Validate image count limit\n    if (this.images.size >= this.maxImageCount) {\n      throw new Error(\n        `Cannot add image: Maximum image count (${this.maxImageCount}) exceeded. ` +\n          `Consider:\\n` +\n          `  - Reducing the number of images\\n` +\n          `  - Increasing maxImageCount in DocumentOptions\\n` +\n          `  - Splitting into multiple documents`\n      );\n    }\n\n    // Validate single image size (if data is loaded)\n    try {\n      const imageData = image.getImageData();\n      const imageSizeMB = imageData.length / (1024 * 1024);\n\n      if (imageData.length > this.maxSingleImageSizeBytes) {\n        throw new Error(\n          `Image size (${imageSizeMB.toFixed(1)}MB) exceeds maximum single image size ` +\n            `(${(this.maxSingleImageSizeBytes / (1024 * 1024)).toFixed(0)}MB). ` +\n            `Consider:\\n` +\n            `  - Compressing the image\\n` +\n            `  - Resizing to lower resolution\\n` +\n            `  - Converting to a more efficient format (e.g., JPEG)\\n` +\n            `  - Increasing maxSingleImageSizeMB in DocumentOptions`\n        );\n      }\n\n      // Validate total size after adding this image\n      const currentTotalSize = this.getTotalSize();\n      const newTotalSize = currentTotalSize + imageData.length;\n      const newTotalSizeMB = newTotalSize / (1024 * 1024);\n\n      if (newTotalSize > this.maxTotalImageSizeBytes) {\n        throw new Error(\n          `Total image size (${newTotalSizeMB.toFixed(1)}MB) would exceed maximum ` +\n            `(${(this.maxTotalImageSizeBytes / (1024 * 1024)).toFixed(0)}MB) after adding this image. ` +\n            `Consider:\\n` +\n            `  - Compressing existing images\\n` +\n            `  - Removing unnecessary images\\n` +\n            `  - Increasing maxTotalImageSizeMB in DocumentOptions\\n` +\n            `  - Splitting into multiple documents`\n        );\n      }\n    } catch (error: unknown) {\n      // Image data not loaded yet - validation will happen during save\n      // This is acceptable for lazy-loaded images\n      if (error instanceof Error && !error.message.includes('not loaded')) {\n        throw error; // Re-throw size limit errors\n      }\n    }\n\n    // Assign docPr ID\n    const docPrId = this.nextDocPrId++;\n    image.setDocPrId(docPrId);\n\n    // Set relationship ID\n    image.setRelationshipId(relationshipId);\n\n    // Store entry (each image occurrence gets its own entry)\n    const entry: ImageEntry = {\n      image,\n      filename,\n      relationshipId,\n      docPrId,\n    };\n\n    this.images.set(image, entry);\n\n    // Only store first image for each rId (used for filename reuse)\n    // Use composite key to distinguish headers/footers from document body\n    if (!existingByRelId) {\n      this.imagesByRelId.set(relIdKey, entry);\n    }\n\n    return filename;\n  }\n\n  /**\n   * Gets the filename for an image\n   * @param image The image\n   * @returns The filename, or undefined if not registered\n   */\n  getFilename(image: Image): string | undefined {\n    return this.images.get(image)?.filename;\n  }\n\n  /**\n   * Gets the relationship ID for an image\n   * @param image The image\n   * @returns The relationship ID, or undefined if not registered\n   */\n  getRelationshipId(image: Image): string | undefined {\n    return this.images.get(image)?.relationshipId;\n  }\n\n  /**\n   * Updates the filename for an image and all other entries sharing the same old filename.\n   * Used when image format changes (e.g., BMP → PNG) require a new filename.\n   * @param image The image whose filename to update\n   * @param newFilename The new filename\n   * @returns The old filename, or undefined if image not registered\n   */\n  updateEntryFilename(image: Image, newFilename: string): string | undefined {\n    const entry = this.images.get(image);\n    if (!entry) return undefined;\n    const oldFilename = entry.filename;\n    if (oldFilename === newFilename) return oldFilename;\n\n    // Update all entries sharing the old filename\n    for (const e of this.images.values()) {\n      if (e.filename === oldFilename) e.filename = newFilename;\n    }\n    for (const e of this.imagesByRelId.values()) {\n      if (e.filename === oldFilename) e.filename = newFilename;\n    }\n    return oldFilename;\n  }\n\n  /**\n   * Gets all registered images\n   * @returns Array of image entries\n   */\n  getAllImages(): ImageEntry[] {\n    return Array.from(this.images.values());\n  }\n\n  /**\n   * Gets the number of images\n   * @returns Number of registered images\n   */\n  getImageCount(): number {\n    return this.images.size;\n  }\n\n  /**\n   * Checks if an image is registered\n   * @param image The image\n   * @returns True if registered\n   */\n  hasImage(image: Image): boolean {\n    return this.images.has(image);\n  }\n\n  /**\n   * Gets the MIME type for an image extension\n   * @param extension File extension (without dot)\n   * @returns MIME type\n   */\n  static getMimeType(extension: string): string {\n    const mimeTypes: Record<string, string> = {\n      png: 'image/png',\n      jpg: 'image/jpeg',\n      jpeg: 'image/jpeg',\n      gif: 'image/gif',\n      bmp: 'image/bmp',\n      tiff: 'image/tiff',\n      tif: 'image/tiff',\n      svg: 'image/svg+xml',\n      emf: 'image/x-emf',\n      wmf: 'image/x-wmf',\n    };\n\n    return mimeTypes[extension.toLowerCase()] || 'image/png';\n  }\n\n  /**\n   * Loads data for all images with controlled concurrency\n   * Call this before saving to ensure all image data is available\n   * @param concurrency Maximum number of images to load simultaneously (default: 5)\n   * @param onProgress Optional callback for progress tracking (loaded, total)\n   */\n  async loadAllImageData(\n    concurrency = 5,\n    onProgress?: (loaded: number, total: number) => void\n  ): Promise<void> {\n    const images = Array.from(this.images.values());\n    const total = images.length;\n\n    if (total === 0) {\n      return;\n    }\n\n    // Validate concurrency\n    if (concurrency < 1 || concurrency > 50 || !Number.isInteger(concurrency)) {\n      throw new Error('Concurrency must be an integer between 1 and 50');\n    }\n\n    let loaded = 0;\n\n    // Load images in batches to control concurrency\n    for (let i = 0; i < total; i += concurrency) {\n      const batch = images.slice(i, Math.min(i + concurrency, total));\n\n      // Load batch in parallel\n      await Promise.all(\n        batch.map(async (entry) => {\n          try {\n            await entry.image.ensureDataLoaded();\n            loaded++;\n\n            // Report progress\n            if (onProgress) {\n              onProgress(loaded, total);\n            }\n          } catch (error: unknown) {\n            // Log error but continue loading other images\n            const message = error instanceof Error ? error.message : String(error);\n            defaultLogger.warn(`Failed to load image data: ${message}`);\n            loaded++; // Still count as processed\n\n            if (onProgress) {\n              onProgress(loaded, total);\n            }\n          }\n        })\n      );\n    }\n  }\n\n  /**\n   * Releases data for all images\n   * Call this after saving to free memory\n   */\n  releaseAllImageData(): void {\n    for (const entry of this.images.values()) {\n      entry.image.releaseData();\n    }\n  }\n\n  /**\n   * Gets the total size of all loaded image data\n   * Only counts images that are currently loaded in memory\n   * @returns Total size in bytes\n   */\n  getTotalSize(): number {\n    let totalSize = 0;\n    for (const entry of this.images.values()) {\n      try {\n        const data = entry.image.getImageData();\n        totalSize += data.length;\n      } catch (e) {\n        defaultLogger.debug(\n          `[ImageManager] Image not loaded, skipping size count: ${entry.filename}`\n        );\n      }\n    }\n    return totalSize;\n  }\n\n  /**\n   * Gets the total size of all images (loads them if needed)\n   * Use this for accurate size estimation before saving\n   * @returns Total size in bytes\n   */\n  async getTotalSizeAsync(): Promise<number> {\n    let totalSize = 0;\n    for (const entry of this.images.values()) {\n      try {\n        const data = await entry.image.getImageDataAsync();\n        totalSize += data.length;\n      } catch (e) {\n        defaultLogger.debug(`[ImageManager] Image loading failed, skipping: ${entry.filename}`);\n      }\n    }\n    return totalSize;\n  }\n\n  /**\n   * Gets statistics about images\n   * @returns Object with image statistics\n   */\n  getStats(): {\n    count: number;\n    totalSize: number;\n    averageSize: number;\n  } {\n    const count = this.getImageCount();\n    const totalSize = this.getTotalSize();\n    return {\n      count,\n      totalSize,\n      averageSize: count > 0 ? Math.round(totalSize / count) : 0,\n    };\n  }\n\n  /**\n   * Initializes nextImageNumber from already-loaded images\n   * Call after parsing to prevent filename collisions\n   *\n   * **Issue #12 Fix:** Prevents collisions when adding new images after load\n   */\n  initializeFromLoadedImages(): void {\n    let maxNumber = 0;\n\n    for (const entry of this.images.values()) {\n      // Extract number from filename (e.g., \"image5.png\" → 5)\n      const match = /image(\\d+)\\./.exec(entry.filename);\n      if (match?.[1]) {\n        const num = parseInt(match[1], 10);\n        if (num > maxNumber) {\n          maxNumber = num;\n        }\n      }\n    }\n\n    // Start numbering after highest existing number\n    this.nextImageNumber = maxNumber + 1;\n  }\n\n  /**\n   * Clears all images\n   */\n  clear(): this {\n    this.images.clear();\n    this.imagesByRelId.clear(); // Issue #12 fix\n    this.nextImageNumber = 1;\n    this.nextDocPrId = 1;\n    return this;\n  }\n\n  /**\n   * Creates a new image manager\n   * @param options Image manager options\n   */\n  static create(options?: ImageManagerOptions): ImageManager {\n    return new ImageManager(options);\n  }\n}\n"]}
+{"version":3,"file":"ImageManager.js","sourceRoot":"","sources":["../../../src/elements/ImageManager.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * ImageManager - Manages images in a document\n *\n * Handles image tracking, unique filename generation, and coordination\n * with the RelationshipManager for image relationships.\n */\n\nimport { Image } from './Image.js';\nimport { defaultLogger } from '../utils/logger.js';\n\n/**\n * Image file entry\n */\ninterface ImageEntry {\n  /** The Image object */\n  image: Image;\n  /** Filename in media folder (e.g., 'image1.png') */\n  filename: string;\n  /** Relationship ID */\n  relationshipId: string;\n  /** Document property ID (for DrawingML) */\n  docPrId: number;\n}\n\n/**\n * Image manager options\n */\nexport interface ImageManagerOptions {\n  /** Maximum number of images allowed. Default: 1000 */\n  maxImageCount?: number;\n  /** Maximum total size of all images in MB. Default: 100 */\n  maxTotalImageSizeMB?: number;\n  /** Maximum size of a single image in MB. Default: 20 */\n  maxSingleImageSizeMB?: number;\n}\n\n/**\n * Manages all images in a document\n */\nexport class ImageManager {\n  private images: Map<Image, ImageEntry>;\n  private imagesByRelId: Map<string, ImageEntry>; // Track by relationship ID (Issue #12 fix)\n  private nextImageNumber: number;\n  private nextDocPrId: number;\n  private maxImageCount: number;\n  private maxTotalImageSizeBytes: number;\n  private maxSingleImageSizeBytes: number;\n\n  /**\n   * Creates a new image manager\n   * @param options Image manager options\n   */\n  constructor(options: ImageManagerOptions = {}) {\n    this.images = new Map();\n    this.imagesByRelId = new Map(); // Issue #12 fix\n    this.nextImageNumber = 1;\n    this.nextDocPrId = 1;\n    // Increased from 20 to 1000 to support production documents with many images\n    this.maxImageCount = options.maxImageCount ?? 1000;\n    this.maxTotalImageSizeBytes = (options.maxTotalImageSizeMB ?? 100) * 1024 * 1024;\n    this.maxSingleImageSizeBytes = (options.maxSingleImageSizeMB ?? 20) * 1024 * 1024;\n  }\n\n  /**\n   * Registers an image with the manager\n   * @param image The image to register\n   * @param relationshipId The relationship ID for this image\n   * @param originalFilename Optional original filename from the source document.\n   *   When provided (during parsing), preserves the original filename to maintain\n   *   consistency with relationship targets. When not provided (adding new images),\n   *   generates a new sequential filename.\n   * @param partName Optional part name (e.g., 'header1.xml', 'footer1.xml') for\n   *   distinguishing relationship IDs from different document parts. Headers and footers\n   *   have their own .rels files, so rId1 in header1.xml is different from rId1 in document.xml.\n   * @returns The filename assigned to this image\n   * @throws {Error} If image limits are exceeded\n   *\n   * **Issue #12 Fix:** Reuses filename for images with same relationship ID\n   * to prevent duplicating files in media folder during save.\n   * However, each image occurrence gets its own entry to preserve dimensions\n   * (Word allows same image file displayed at different sizes via wp:extent).\n   */\n  registerImage(\n    image: Image,\n    relationshipId: string,\n    originalFilename?: string,\n    partName?: string\n  ): string {\n    // Check if already registered by object reference (exact same object)\n    const existing = this.images.get(image);\n    if (existing) {\n      return existing.filename;\n    }\n\n    // Issue #12 fix: Reuse FILENAME for same rId, but create separate entry\n    // This prevents duplicate files in media folder while preserving dimensions\n    // Use composite key with partName to distinguish headers/footers from document body\n    const relIdKey = partName ? `${partName}:${relationshipId}` : relationshipId;\n    const existingByRelId = this.imagesByRelId.get(relIdKey);\n\n    // Filename priority:\n    // 1. Existing filename for same rId (prevents duplicates)\n    // 2. Original filename from source document (preserves round-trip integrity)\n    // 3. Generate new sequential filename (for newly added images)\n    const filename = existingByRelId\n      ? existingByRelId.filename\n      : originalFilename || `image${this.nextImageNumber++}.${image.getExtension()}`;\n\n    // Validate image count limit\n    if (this.images.size >= this.maxImageCount) {\n      throw new Error(\n        `Cannot add image: Maximum image count (${this.maxImageCount}) exceeded. ` +\n          `Consider:\\n` +\n          `  - Reducing the number of images\\n` +\n          `  - Increasing maxImageCount in DocumentOptions\\n` +\n          `  - Splitting into multiple documents`\n      );\n    }\n\n    // Validate single image size (if data is loaded)\n    try {\n      const imageData = image.getImageData();\n      const imageSizeMB = imageData.length / (1024 * 1024);\n\n      if (imageData.length > this.maxSingleImageSizeBytes) {\n        throw new Error(\n          `Image size (${imageSizeMB.toFixed(1)}MB) exceeds maximum single image size ` +\n            `(${(this.maxSingleImageSizeBytes / (1024 * 1024)).toFixed(0)}MB). ` +\n            `Consider:\\n` +\n            `  - Compressing the image\\n` +\n            `  - Resizing to lower resolution\\n` +\n            `  - Converting to a more efficient format (e.g., JPEG)\\n` +\n            `  - Increasing maxSingleImageSizeMB in DocumentOptions`\n        );\n      }\n\n      // Validate total size after adding this image\n      const currentTotalSize = this.getTotalSize();\n      const newTotalSize = currentTotalSize + imageData.length;\n      const newTotalSizeMB = newTotalSize / (1024 * 1024);\n\n      if (newTotalSize > this.maxTotalImageSizeBytes) {\n        throw new Error(\n          `Total image size (${newTotalSizeMB.toFixed(1)}MB) would exceed maximum ` +\n            `(${(this.maxTotalImageSizeBytes / (1024 * 1024)).toFixed(0)}MB) after adding this image. ` +\n            `Consider:\\n` +\n            `  - Compressing existing images\\n` +\n            `  - Removing unnecessary images\\n` +\n            `  - Increasing maxTotalImageSizeMB in DocumentOptions\\n` +\n            `  - Splitting into multiple documents`\n        );\n      }\n    } catch (error: unknown) {\n      // Image data not loaded yet - validation will happen during save\n      // This is acceptable for lazy-loaded images\n      if (error instanceof Error && !error.message.includes('not loaded')) {\n        throw error; // Re-throw size limit errors\n      }\n    }\n\n    // Assign docPr ID\n    const docPrId = this.nextDocPrId++;\n    image.setDocPrId(docPrId);\n\n    // Set relationship ID\n    image.setRelationshipId(relationshipId);\n\n    // Store entry (each image occurrence gets its own entry)\n    const entry: ImageEntry = {\n      image,\n      filename,\n      relationshipId,\n      docPrId,\n    };\n\n    this.images.set(image, entry);\n\n    // Only store first image for each rId (used for filename reuse)\n    // Use composite key to distinguish headers/footers from document body\n    if (!existingByRelId) {\n      this.imagesByRelId.set(relIdKey, entry);\n    }\n\n    return filename;\n  }\n\n  /**\n   * Gets the filename for an image\n   * @param image The image\n   * @returns The filename, or undefined if not registered\n   */\n  getFilename(image: Image): string | undefined {\n    return this.images.get(image)?.filename;\n  }\n\n  /**\n   * Gets the relationship ID for an image\n   * @param image The image\n   * @returns The relationship ID, or undefined if not registered\n   */\n  getRelationshipId(image: Image): string | undefined {\n    return this.images.get(image)?.relationshipId;\n  }\n\n  /**\n   * Updates the filename for an image and all other entries sharing the same old filename.\n   * Used when image format changes (e.g., BMP → PNG) require a new filename.\n   * @param image The image whose filename to update\n   * @param newFilename The new filename\n   * @returns The old filename, or undefined if image not registered\n   */\n  updateEntryFilename(image: Image, newFilename: string): string | undefined {\n    const entry = this.images.get(image);\n    if (!entry) return undefined;\n    const oldFilename = entry.filename;\n    if (oldFilename === newFilename) return oldFilename;\n\n    // Guard against clobbering a distinct image: if another entry already owns\n    // newFilename, renaming here would point two different images at the same\n    // media part and saveImages() would write both to the same path (last write\n    // wins). Callers must resolve the collision to a fresh name first.\n    if (this.isFilenameOwnedByOther(newFilename, oldFilename)) {\n      throw new Error(\n        `Cannot rename image to \"${newFilename}\": filename already in use by a different image`\n      );\n    }\n\n    // Update all entries sharing the old filename\n    for (const e of this.images.values()) {\n      if (e.filename === oldFilename) e.filename = newFilename;\n    }\n    for (const e of this.imagesByRelId.values()) {\n      if (e.filename === oldFilename) e.filename = newFilename;\n    }\n    return oldFilename;\n  }\n\n  /**\n   * Returns true if a registered image other than those sharing `excludeFilename`\n   * already uses `filename`. Used to detect rename collisions before they\n   * silently clobber a distinct media part.\n   */\n  isFilenameOwnedByOther(filename: string, excludeFilename: string): boolean {\n    for (const e of this.images.values()) {\n      if (e.filename === filename && e.filename !== excludeFilename) {\n        return true;\n      }\n    }\n    return false;\n  }\n\n  /**\n   * Gets all registered images\n   * @returns Array of image entries\n   */\n  getAllImages(): ImageEntry[] {\n    return Array.from(this.images.values());\n  }\n\n  /**\n   * Gets the number of images\n   * @returns Number of registered images\n   */\n  getImageCount(): number {\n    return this.images.size;\n  }\n\n  /**\n   * Checks if an image is registered\n   * @param image The image\n   * @returns True if registered\n   */\n  hasImage(image: Image): boolean {\n    return this.images.has(image);\n  }\n\n  /**\n   * Gets the MIME type for an image extension\n   * @param extension File extension (without dot)\n   * @returns MIME type\n   */\n  static getMimeType(extension: string): string {\n    const mimeTypes: Record<string, string> = {\n      png: 'image/png',\n      jpg: 'image/jpeg',\n      jpeg: 'image/jpeg',\n      gif: 'image/gif',\n      bmp: 'image/bmp',\n      tiff: 'image/tiff',\n      tif: 'image/tiff',\n      svg: 'image/svg+xml',\n      emf: 'image/x-emf',\n      wmf: 'image/x-wmf',\n    };\n\n    return mimeTypes[extension.toLowerCase()] || 'image/png';\n  }\n\n  /**\n   * Loads data for all images with controlled concurrency\n   * Call this before saving to ensure all image data is available\n   * @param concurrency Maximum number of images to load simultaneously (default: 5)\n   * @param onProgress Optional callback for progress tracking (loaded, total)\n   */\n  async loadAllImageData(\n    concurrency = 5,\n    onProgress?: (loaded: number, total: number) => void\n  ): Promise<void> {\n    const images = Array.from(this.images.values());\n    const total = images.length;\n\n    if (total === 0) {\n      return;\n    }\n\n    // Validate concurrency\n    if (concurrency < 1 || concurrency > 50 || !Number.isInteger(concurrency)) {\n      throw new Error('Concurrency must be an integer between 1 and 50');\n    }\n\n    let loaded = 0;\n\n    // Load images in batches to control concurrency\n    for (let i = 0; i < total; i += concurrency) {\n      const batch = images.slice(i, Math.min(i + concurrency, total));\n\n      // Load batch in parallel\n      await Promise.all(\n        batch.map(async (entry) => {\n          try {\n            await entry.image.ensureDataLoaded();\n            loaded++;\n\n            // Report progress\n            if (onProgress) {\n              onProgress(loaded, total);\n            }\n          } catch (error: unknown) {\n            // Log error but continue loading other images\n            const message = error instanceof Error ? error.message : String(error);\n            defaultLogger.warn(`Failed to load image data: ${message}`);\n            loaded++; // Still count as processed\n\n            if (onProgress) {\n              onProgress(loaded, total);\n            }\n          }\n        })\n      );\n    }\n  }\n\n  /**\n   * Releases data for all images\n   * Call this after saving to free memory\n   */\n  releaseAllImageData(): void {\n    for (const entry of this.images.values()) {\n      entry.image.releaseData();\n    }\n  }\n\n  /**\n   * Gets the total size of all loaded image data\n   * Only counts images that are currently loaded in memory\n   * @returns Total size in bytes\n   */\n  getTotalSize(): number {\n    let totalSize = 0;\n    for (const entry of this.images.values()) {\n      try {\n        const data = entry.image.getImageData();\n        totalSize += data.length;\n      } catch (e) {\n        defaultLogger.debug(\n          `[ImageManager] Image not loaded, skipping size count: ${entry.filename}`\n        );\n      }\n    }\n    return totalSize;\n  }\n\n  /**\n   * Gets the total size of all images (loads them if needed)\n   * Use this for accurate size estimation before saving\n   * @returns Total size in bytes\n   */\n  async getTotalSizeAsync(): Promise<number> {\n    let totalSize = 0;\n    for (const entry of this.images.values()) {\n      try {\n        const data = await entry.image.getImageDataAsync();\n        totalSize += data.length;\n      } catch (e) {\n        defaultLogger.debug(`[ImageManager] Image loading failed, skipping: ${entry.filename}`);\n      }\n    }\n    return totalSize;\n  }\n\n  /**\n   * Gets statistics about images\n   * @returns Object with image statistics\n   */\n  getStats(): {\n    count: number;\n    totalSize: number;\n    averageSize: number;\n  } {\n    const count = this.getImageCount();\n    const totalSize = this.getTotalSize();\n    return {\n      count,\n      totalSize,\n      averageSize: count > 0 ? Math.round(totalSize / count) : 0,\n    };\n  }\n\n  /**\n   * Initializes nextImageNumber from already-loaded images\n   * Call after parsing to prevent filename collisions\n   *\n   * **Issue #12 Fix:** Prevents collisions when adding new images after load\n   */\n  initializeFromLoadedImages(): void {\n    let maxNumber = 0;\n\n    for (const entry of this.images.values()) {\n      // Extract number from filename (e.g., \"image5.png\" → 5)\n      const match = /image(\\d+)\\./.exec(entry.filename);\n      if (match?.[1]) {\n        const num = parseInt(match[1], 10);\n        if (num > maxNumber) {\n          maxNumber = num;\n        }\n      }\n    }\n\n    // Start numbering after highest existing number\n    this.nextImageNumber = maxNumber + 1;\n  }\n\n  /**\n   * Clears all images\n   */\n  clear(): this {\n    this.images.clear();\n    this.imagesByRelId.clear(); // Issue #12 fix\n    this.nextImageNumber = 1;\n    this.nextDocPrId = 1;\n    return this;\n  }\n\n  /**\n   * Creates a new image manager\n   * @param options Image manager options\n   */\n  static create(options?: ImageManagerOptions): ImageManager {\n    return new ImageManager(options);\n  }\n}\n"]}

package/dist/esm/elements/Paragraph.js

@@ -13,6 +13,7 @@ import { Revision } from './Revision.js';
 import { Run } from './Run.js';
 import { Shape } from './Shape.js';
 import { TextBox } from './TextBox.js';
+import { PreservedElement } from './PreservedElement.js';
 export function isRun(content) {
     return content instanceof Run;
 }
@@ -236,6 +237,41 @@ export class Paragraph {
     getCommentsEnd() {
         return [...this.commentsEnd];
     }
+    removeCommentAnchor(commentId) {
+        let removed = false;
+        const startCount = this.commentsStart.length;
+        this.commentsStart = this.commentsStart.filter((c) => c.getId() !== commentId);
+        if (this.commentsStart.length !== startCount) {
+            removed = true;
+        }
+        const endCount = this.commentsEnd.length;
+        this.commentsEnd = this.commentsEnd.filter((c) => c.getId() !== commentId);
+        if (this.commentsEnd.length !== endCount) {
+            removed = true;
+        }
+        const contentCount = this.content.length;
+        this.content = this.content.filter((item) => {
+            if (!(item instanceof PreservedElement)) {
+                return true;
+            }
+            const elementType = item.getElementType();
+            if (elementType === 'w:commentRangeStart' || elementType === 'w:commentRangeEnd') {
+                return !Paragraph.rawXmlMatchesCommentId(item.getRawXml(), elementType, commentId);
+            }
+            if (elementType === 'w:r') {
+                return !Paragraph.rawXmlMatchesCommentId(item.getRawXml(), 'w:commentReference', commentId);
+            }
+            return true;
+        });
+        if (this.content.length !== contentCount) {
+            removed = true;
+        }
+        return removed;
+    }
+    static rawXmlMatchesCommentId(rawXml, elementName, commentId) {
+        const match = rawXml.match(new RegExp(`<${elementName}\\b[^>]*\\bw:id="(\\d+)"`));
+        return match !== null && Number(match[1]) === commentId;
+    }
     addPageNumber(formatting) {
         return this.addField(Field.createPageNumber(formatting));
     }
@@ -283,7 +319,33 @@ export class Paragraph {
         return this;
     }
     setText(text, formatting) {
-        this.content = [new Run(text, formatting)];
+        const newRun = new Run(text, formatting);
+        newRun._setParentParagraph(this);
+        if (this.trackingContext) {
+            newRun._setTrackingContext(this.trackingContext);
+        }
+        if (this.trackingContext?.isEnabled()) {
+            const deletedContent = [];
+            for (const item of this.content) {
+                if (item instanceof Revision) {
+                    deletedContent.push(item);
+                }
+                else if (item instanceof Run || item instanceof Hyperlink) {
+                    const revision = Revision.createDeletion(this.trackingContext.getAuthor(), item, new Date());
+                    this.trackingContext.getRevisionManager().register(revision);
+                    deletedContent.push(revision);
+                }
+                else {
+                    deletedContent.push(item);
+                }
+            }
+            const insertion = Revision.createInsertion(this.trackingContext.getAuthor(), newRun, new Date());
+            this.trackingContext.getRevisionManager().register(insertion);
+            this.content = [...deletedContent, insertion];
+        }
+        else {
+            this.content = [newRun];
+        }
         return this;
     }
     getRuns() {
@@ -388,6 +450,12 @@ export class Paragraph {
             .map((item) => item.getText())
             .join('');
     }
+    getTextIncludingRevisions() {
+        return this.content
+            .filter((item) => item instanceof Run || item instanceof Hyperlink || item instanceof Revision)
+            .map((item) => item.getText())
+            .join('');
+    }
     getFields() {
         return this.content.filter((item) => item instanceof Field || item instanceof ComplexField);
     }
@@ -1705,9 +1773,7 @@ export class Paragraph {
         const clonedParagraph = new Paragraph(clonedFormatting);
         for (const item of this.content) {
             if (item instanceof Run) {
-                const runFormatting = item.getFormatting();
-                const clonedRun = new Run(item.getText(), deepClone(runFormatting));
-                clonedParagraph.addRun(clonedRun);
+                clonedParagraph.addRun(item.clone());
             }
             else {
                 clonedParagraph.content.push(item);
@@ -1997,12 +2063,21 @@ export class Paragraph {
             const keepAfter = match.end < lastAffected.end
                 ? lastAffected.run.getText().slice(match.end - lastAffected.start)
                 : '';
-            firstAffected.run.setText(keepBefore + replace + keepAfter);
-            for (let r = affectedRuns.length - 1; r >= 1; r--) {
-                const runEntry = affectedRuns[r];
-                const idx = this.content.indexOf(runEntry.run);
-                if (idx !== -1) {
-                    this.content.splice(idx, 1);
+            if (affectedRuns.length === 1) {
+                firstAffected.run.setText(keepBefore + replace + keepAfter);
+            }
+            else {
+                if (keepAfter !== '') {
+                    lastAffected.run.setText(keepAfter);
+                }
+                firstAffected.run.setText(keepBefore + replace);
+                const lastRemovable = keepAfter !== '' ? affectedRuns.length - 2 : affectedRuns.length - 1;
+                for (let r = lastRemovable; r >= 1; r--) {
+                    const runEntry = affectedRuns[r];
+                    const idx = this.content.indexOf(runEntry.run);
+                    if (idx !== -1) {
+                        this.content.splice(idx, 1);
+                    }
                 }
             }
         }
@@ -2175,6 +2250,8 @@ export class Paragraph {
             }
             const prev = consolidated.length > 0 ? consolidated[consolidated.length - 1] : undefined;
             if (prev instanceof Run &&
+                !prev.hasPropertyChangeRevision() &&
+                !item.hasPropertyChangeRevision() &&
                 isEqualFormatting(prev.getFormatting(), item.getFormatting())) {
                 const mergedContent = [...prev.getContent(), ...item.getContent()];
                 const mergedRun = Run.createFromContent(mergedContent, deepClone(prev.getFormatting()));
@@ -2208,28 +2285,16 @@ export class Paragraph {
     clearDirectRunFormatting(properties) {
         const runs = this.getRuns();
         for (const run of runs) {
-            const formatting = run.getFormatting();
             if (properties && properties.length > 0) {
-                const newFormatting = { ...formatting };
+                const formatting = run.formatting;
                 for (const prop of properties) {
-                    if (prop in newFormatting) {
-                        delete newFormatting[prop];
+                    if (prop in formatting) {
+                        delete formatting[prop];
                     }
                 }
-                const text = run.getText();
-                const newRun = new Run(text, newFormatting);
-                const index = this.content.indexOf(run);
-                if (index !== -1) {
-                    this.content[index] = newRun;
-                }
             }
             else {
-                const text = run.getText();
-                const newRun = new Run(text, {});
-                const index = this.content.indexOf(run);
-                if (index !== -1) {
-                    this.content[index] = newRun;
-                }
+                run.clearFormatting();
             }
         }
         return this;