docxmlater 10.4.1 → 11.0.4

package/dist/esm/images/ImageOptimizer.js

@@ -0,0 +1,161 @@
+import * as zlib from 'zlib';
+const CRC_TABLE = (() => {
+    const table = new Uint32Array(256);
+    for (let n = 0; n < 256; n++) {
+        let c = n;
+        for (let k = 0; k < 8; k++) {
+            c = c & 1 ? 0xedb88320 ^ (c >>> 1) : c >>> 1;
+        }
+        table[n] = c;
+    }
+    return table;
+})();
+function crc32(buf) {
+    let crc = 0xffffffff;
+    for (let i = 0; i < buf.length; i++) {
+        crc = CRC_TABLE[(crc ^ buf[i]) & 0xff] ^ (crc >>> 8);
+    }
+    return (crc ^ 0xffffffff) >>> 0;
+}
+const PNG_SIGNATURE = Buffer.from([0x89, 0x50, 0x4e, 0x47, 0x0d, 0x0a, 0x1a, 0x0a]);
+function buildPngChunk(type, data) {
+    const length = Buffer.alloc(4);
+    length.writeUInt32BE(data.length, 0);
+    const typeBuffer = Buffer.from(type, 'ascii');
+    const crcInput = Buffer.concat([typeBuffer, data]);
+    const crcValue = crc32(crcInput);
+    const crcBuffer = Buffer.alloc(4);
+    crcBuffer.writeUInt32BE(crcValue, 0);
+    return Buffer.concat([length, typeBuffer, data, crcBuffer]);
+}
+export function optimizePng(buffer) {
+    if (buffer.length < 8 || !buffer.subarray(0, 8).equals(PNG_SIGNATURE)) {
+        return null;
+    }
+    let ihdrData = null;
+    let plteData = null;
+    let trnsData = null;
+    const idatBuffers = [];
+    let offset = 8;
+    while (offset + 12 <= buffer.length) {
+        const chunkLength = buffer.readUInt32BE(offset);
+        const chunkType = buffer.subarray(offset + 4, offset + 8).toString('ascii');
+        if (offset + 12 + chunkLength > buffer.length)
+            break;
+        const chunkData = buffer.subarray(offset + 8, offset + 8 + chunkLength);
+        if (chunkType === 'IHDR') {
+            ihdrData = Buffer.from(chunkData);
+        }
+        else if (chunkType === 'PLTE') {
+            plteData = Buffer.from(chunkData);
+        }
+        else if (chunkType === 'tRNS') {
+            trnsData = Buffer.from(chunkData);
+        }
+        else if (chunkType === 'IDAT') {
+            idatBuffers.push(chunkData);
+        }
+        offset += 12 + chunkLength;
+        if (chunkType === 'IEND')
+            break;
+    }
+    if (!ihdrData || idatBuffers.length === 0)
+        return null;
+    const combinedIdat = Buffer.concat(idatBuffers);
+    let decompressed;
+    try {
+        decompressed = zlib.inflateSync(combinedIdat);
+    }
+    catch {
+        return null;
+    }
+    const recompressed = zlib.deflateSync(decompressed, { level: 9 });
+    const resultParts = [Buffer.from(PNG_SIGNATURE)];
+    resultParts.push(buildPngChunk('IHDR', ihdrData));
+    if (plteData)
+        resultParts.push(buildPngChunk('PLTE', plteData));
+    if (trnsData)
+        resultParts.push(buildPngChunk('tRNS', trnsData));
+    resultParts.push(buildPngChunk('IDAT', recompressed));
+    resultParts.push(buildPngChunk('IEND', Buffer.alloc(0)));
+    return Buffer.concat(resultParts);
+}
+export function convertBmpToPng(buffer) {
+    if (buffer.length < 54 || buffer[0] !== 0x42 || buffer[1] !== 0x4d) {
+        return null;
+    }
+    const pixelDataOffset = buffer.readUInt32LE(10);
+    const dibHeaderSize = buffer.readUInt32LE(14);
+    if (dibHeaderSize < 40)
+        return null;
+    const width = buffer.readInt32LE(18);
+    const height = buffer.readInt32LE(22);
+    const bitsPerPixel = buffer.readUInt16LE(28);
+    const compression = buffer.readUInt32LE(30);
+    if (compression !== 0 && !(compression === 3 && bitsPerPixel === 32))
+        return null;
+    if (bitsPerPixel !== 24 && bitsPerPixel !== 32)
+        return null;
+    if (width <= 0)
+        return null;
+    const absHeight = Math.abs(height);
+    if (absHeight === 0)
+        return null;
+    const isTopDown = height < 0;
+    const bytesPerPixel = bitsPerPixel / 8;
+    const rowSize = Math.ceil((width * bytesPerPixel) / 4) * 4;
+    if (pixelDataOffset + absHeight * rowSize > buffer.length)
+        return null;
+    const colorType = bitsPerPixel === 32 ? 6 : 2;
+    const pngBytesPerPixel = bitsPerPixel === 32 ? 4 : 3;
+    const ihdrData = Buffer.alloc(13);
+    ihdrData.writeUInt32BE(width, 0);
+    ihdrData.writeUInt32BE(absHeight, 4);
+    ihdrData[8] = 8;
+    ihdrData[9] = colorType;
+    ihdrData[10] = 0;
+    ihdrData[11] = 0;
+    ihdrData[12] = 0;
+    const rawDataSize = absHeight * (1 + width * pngBytesPerPixel);
+    const rawData = Buffer.alloc(rawDataSize);
+    for (let y = 0; y < absHeight; y++) {
+        const bmpRow = isTopDown ? y : absHeight - 1 - y;
+        const bmpRowOffset = pixelDataOffset + bmpRow * rowSize;
+        const pngRowOffset = y * (1 + width * pngBytesPerPixel);
+        rawData[pngRowOffset] = 0;
+        for (let x = 0; x < width; x++) {
+            const bmpPixelOffset = bmpRowOffset + x * bytesPerPixel;
+            const pngPixelOffset = pngRowOffset + 1 + x * pngBytesPerPixel;
+            rawData[pngPixelOffset] = buffer[bmpPixelOffset + 2];
+            rawData[pngPixelOffset + 1] = buffer[bmpPixelOffset + 1];
+            rawData[pngPixelOffset + 2] = buffer[bmpPixelOffset];
+            if (bitsPerPixel === 32) {
+                rawData[pngPixelOffset + 3] = buffer[bmpPixelOffset + 3];
+            }
+        }
+    }
+    const compressedData = zlib.deflateSync(rawData, { level: 9 });
+    return Buffer.concat([
+        Buffer.from(PNG_SIGNATURE),
+        buildPngChunk('IHDR', ihdrData),
+        buildPngChunk('IDAT', compressedData),
+        buildPngChunk('IEND', Buffer.alloc(0)),
+    ]);
+}
+export function optimizeImage(buffer, extension) {
+    const ext = extension.toLowerCase();
+    if (ext === 'png') {
+        const optimized = optimizePng(buffer);
+        if (!optimized || optimized.length >= buffer.length)
+            return null;
+        return { data: optimized, newExtension: 'png' };
+    }
+    if (ext === 'bmp') {
+        const converted = convertBmpToPng(buffer);
+        if (!converted)
+            return null;
+        return { data: converted, newExtension: 'png' };
+    }
+    return null;
+}
+//# sourceMappingURL=ImageOptimizer.js.map

package/dist/esm/images/ImageOptimizer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ImageOptimizer.js","sourceRoot":"","sources":["../../../src/images/ImageOptimizer.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * ImageOptimizer - Lossless image optimization for DOCX documents\n *\n * Two techniques using only Node.js built-in zlib (zero dependencies):\n * 1. PNG re-compression — Re-compress IDAT chunks at zlib level 9 + strip metadata\n * 2. BMP → PNG conversion — Lossless format change, typically 10-50x smaller\n */\n\nimport * as zlib from 'zlib';\n\n// =============================================================================\n// Types\n// =============================================================================\n\nexport interface ImageOptimizationResult {\n  optimizedCount: number;\n  totalSavedBytes: number;\n}\n\n// =============================================================================\n// CRC-32 (IEEE polynomial)\n// =============================================================================\n\nconst CRC_TABLE: Uint32Array = (() => {\n  const table = new Uint32Array(256);\n  for (let n = 0; n < 256; n++) {\n    let c = n;\n    for (let k = 0; k < 8; k++) {\n      c = c & 1 ? 0xedb88320 ^ (c >>> 1) : c >>> 1;\n    }\n    table[n] = c;\n  }\n  return table;\n})();\n\nfunction crc32(buf: Buffer): number {\n  let crc = 0xffffffff;\n  for (let i = 0; i < buf.length; i++) {\n    crc = CRC_TABLE[(crc ^ buf[i]!) & 0xff]! ^ (crc >>> 8);\n  }\n  return (crc ^ 0xffffffff) >>> 0;\n}\n\n// =============================================================================\n// PNG Chunk Builder\n// =============================================================================\n\nconst PNG_SIGNATURE = Buffer.from([0x89, 0x50, 0x4e, 0x47, 0x0d, 0x0a, 0x1a, 0x0a]);\n\n/**\n * Builds a PNG chunk: [4-byte length][4-byte type][data][4-byte CRC]\n * CRC covers type + data bytes\n */\nfunction buildPngChunk(type: string, data: Buffer): Buffer {\n  const length = Buffer.alloc(4);\n  length.writeUInt32BE(data.length, 0);\n\n  const typeBuffer = Buffer.from(type, 'ascii');\n\n  const crcInput = Buffer.concat([typeBuffer, data]);\n  const crcValue = crc32(crcInput);\n  const crcBuffer = Buffer.alloc(4);\n  crcBuffer.writeUInt32BE(crcValue, 0);\n\n  return Buffer.concat([length, typeBuffer, data, crcBuffer]);\n}\n\n// =============================================================================\n// PNG Re-compression\n// =============================================================================\n\n/**\n * Re-compresses a PNG buffer at zlib level 9 and strips non-essential metadata chunks.\n * Returns the optimized buffer, or null if the PNG is invalid/cannot be optimized.\n * The caller should compare sizes to decide whether to use the result.\n */\nexport function optimizePng(buffer: Buffer): Buffer | null {\n  // Verify PNG signature\n  if (buffer.length < 8 || !buffer.subarray(0, 8).equals(PNG_SIGNATURE)) {\n    return null;\n  }\n\n  // Parse chunks\n  let ihdrData: Buffer | null = null;\n  let plteData: Buffer | null = null;\n  let trnsData: Buffer | null = null;\n  const idatBuffers: Buffer[] = [];\n\n  let offset = 8; // Skip signature\n  while (offset + 12 <= buffer.length) {\n    const chunkLength = buffer.readUInt32BE(offset);\n    const chunkType = buffer.subarray(offset + 4, offset + 8).toString('ascii');\n\n    // Bounds check: length + type(4) + data + crc(4) = 12 + chunkLength\n    if (offset + 12 + chunkLength > buffer.length) break;\n\n    const chunkData = buffer.subarray(offset + 8, offset + 8 + chunkLength);\n\n    if (chunkType === 'IHDR') {\n      ihdrData = Buffer.from(chunkData);\n    } else if (chunkType === 'PLTE') {\n      plteData = Buffer.from(chunkData);\n    } else if (chunkType === 'tRNS') {\n      trnsData = Buffer.from(chunkData);\n    } else if (chunkType === 'IDAT') {\n      idatBuffers.push(chunkData);\n    }\n    // Non-essential chunks (tEXt, iTXt, zTXt, iCCP, sRGB, gAMA, cHRM, tIME, pHYs, etc.)\n    // are intentionally discarded\n\n    offset += 12 + chunkLength;\n\n    // Stop after IEND\n    if (chunkType === 'IEND') break;\n  }\n\n  if (!ihdrData || idatBuffers.length === 0) return null;\n\n  // Decompress all IDAT data\n  const combinedIdat = Buffer.concat(idatBuffers);\n  let decompressed: Buffer;\n  try {\n    decompressed = zlib.inflateSync(combinedIdat);\n  } catch {\n    return null; // Corrupted IDAT data\n  }\n\n  // Re-compress at maximum level\n  const recompressed = zlib.deflateSync(decompressed, { level: 9 });\n\n  // Rebuild PNG: signature + IHDR + [PLTE] + [tRNS] + IDAT + IEND\n  const resultParts: Buffer[] = [Buffer.from(PNG_SIGNATURE)];\n\n  resultParts.push(buildPngChunk('IHDR', ihdrData));\n  if (plteData) resultParts.push(buildPngChunk('PLTE', plteData));\n  if (trnsData) resultParts.push(buildPngChunk('tRNS', trnsData));\n  resultParts.push(buildPngChunk('IDAT', recompressed));\n  resultParts.push(buildPngChunk('IEND', Buffer.alloc(0)));\n\n  return Buffer.concat(resultParts);\n}\n\n// =============================================================================\n// BMP → PNG Conversion\n// =============================================================================\n\n/**\n * Converts a BMP buffer to PNG format. Lossless conversion.\n * Supports 24-bit (RGB) and 32-bit (RGBA) uncompressed BMPs.\n * Returns null for unsupported variants (indexed, 16-bit, RLE-compressed).\n */\nexport function convertBmpToPng(buffer: Buffer): Buffer | null {\n  // Minimum BMP size: 14 (file header) + 40 (BITMAPINFOHEADER) = 54 bytes\n  if (buffer.length < 54 || buffer[0] !== 0x42 || buffer[1] !== 0x4d) {\n    return null;\n  }\n\n  // Parse BMP file header (14 bytes)\n  const pixelDataOffset = buffer.readUInt32LE(10);\n\n  // Parse DIB header (BITMAPINFOHEADER)\n  const dibHeaderSize = buffer.readUInt32LE(14);\n  if (dibHeaderSize < 40) return null; // Only support BITMAPINFOHEADER and larger\n\n  const width = buffer.readInt32LE(18);\n  const height = buffer.readInt32LE(22);\n  const bitsPerPixel = buffer.readUInt16LE(28);\n  const compression = buffer.readUInt32LE(30);\n\n  // Only support uncompressed (0) and BI_BITFIELDS (3) for 32-bit\n  if (compression !== 0 && !(compression === 3 && bitsPerPixel === 32)) return null;\n\n  // Only support 24-bit and 32-bit\n  if (bitsPerPixel !== 24 && bitsPerPixel !== 32) return null;\n\n  if (width <= 0) return null;\n  const absHeight = Math.abs(height);\n  if (absHeight === 0) return null;\n  const isTopDown = height < 0;\n\n  const bytesPerPixel = bitsPerPixel / 8;\n\n  // BMP rows are padded to 4-byte boundaries\n  const rowSize = Math.ceil((width * bytesPerPixel) / 4) * 4;\n\n  // Validate buffer has enough pixel data\n  if (pixelDataOffset + absHeight * rowSize > buffer.length) return null;\n\n  // PNG color type: 2 = RGB (24-bit), 6 = RGBA (32-bit)\n  const colorType = bitsPerPixel === 32 ? 6 : 2;\n  const pngBytesPerPixel = bitsPerPixel === 32 ? 4 : 3;\n\n  // Build IHDR data (13 bytes)\n  const ihdrData = Buffer.alloc(13);\n  ihdrData.writeUInt32BE(width, 0);\n  ihdrData.writeUInt32BE(absHeight, 4);\n  ihdrData[8] = 8; // bit depth\n  ihdrData[9] = colorType; // color type\n  ihdrData[10] = 0; // compression method (deflate)\n  ihdrData[11] = 0; // filter method (adaptive)\n  ihdrData[12] = 0; // interlace method (none)\n\n  // Build raw image data: filter byte (0 = None) + pixel data per row\n  const rawDataSize = absHeight * (1 + width * pngBytesPerPixel);\n  const rawData = Buffer.alloc(rawDataSize);\n\n  for (let y = 0; y < absHeight; y++) {\n    // BMP stores rows bottom-up by default; top-down if height is negative\n    const bmpRow = isTopDown ? y : absHeight - 1 - y;\n    const bmpRowOffset = pixelDataOffset + bmpRow * rowSize;\n\n    const pngRowOffset = y * (1 + width * pngBytesPerPixel);\n    rawData[pngRowOffset] = 0; // Filter type: None\n\n    for (let x = 0; x < width; x++) {\n      const bmpPixelOffset = bmpRowOffset + x * bytesPerPixel;\n      const pngPixelOffset = pngRowOffset + 1 + x * pngBytesPerPixel;\n\n      // Convert BGR(A) → RGB(A)\n      rawData[pngPixelOffset] = buffer[bmpPixelOffset + 2]!; // R\n      rawData[pngPixelOffset + 1] = buffer[bmpPixelOffset + 1]!; // G\n      rawData[pngPixelOffset + 2] = buffer[bmpPixelOffset]!; // B\n\n      if (bitsPerPixel === 32) {\n        rawData[pngPixelOffset + 3] = buffer[bmpPixelOffset + 3]!; // A\n      }\n    }\n  }\n\n  // Compress pixel data\n  const compressedData = zlib.deflateSync(rawData, { level: 9 });\n\n  // Assemble PNG file\n  return Buffer.concat([\n    Buffer.from(PNG_SIGNATURE),\n    buildPngChunk('IHDR', ihdrData),\n    buildPngChunk('IDAT', compressedData),\n    buildPngChunk('IEND', Buffer.alloc(0)),\n  ]);\n}\n\n// =============================================================================\n// Router\n// =============================================================================\n\n/**\n * Optimizes an image buffer based on its format.\n * - PNG: re-compresses at zlib level 9 and strips metadata. Only returns result if smaller.\n * - BMP: converts to PNG (always smaller than uncompressed BMP).\n * - Other formats: returns null (unsupported / cannot be losslessly optimized further).\n */\nexport function optimizeImage(\n  buffer: Buffer,\n  extension: string\n): { data: Buffer; newExtension: string } | null {\n  const ext = extension.toLowerCase();\n\n  if (ext === 'png') {\n    const optimized = optimizePng(buffer);\n    if (!optimized || optimized.length >= buffer.length) return null;\n    return { data: optimized, newExtension: 'png' };\n  }\n\n  if (ext === 'bmp') {\n    const converted = convertBmpToPng(buffer);\n    if (!converted) return null;\n    return { data: converted, newExtension: 'png' };\n  }\n\n  return null;\n}\n"]}

package/dist/esm/index.js

@@ -0,0 +1,75 @@
+export { Document, } from './core/Document.js';
+export { Paragraph, isRun, isField, isSimpleField, isComplexField, isHyperlink, isRevision, isRangeMarker, isShape, isTextBox, } from './elements/Paragraph.js';
+export { Run } from './elements/Run.js';
+export { Section, } from './elements/Section.js';
+export { Table, } from './elements/Table.js';
+export { TableRow } from './elements/TableRow.js';
+export { TableCell, } from './elements/TableCell.js';
+export { TableGridChange, } from './elements/TableGridChange.js';
+export { Image, } from './elements/Image.js';
+export { ImageRun } from './elements/ImageRun.js';
+export { Shape } from './elements/Shape.js';
+export { TextBox } from './elements/TextBox.js';
+export { Header } from './elements/Header.js';
+export { Footer } from './elements/Footer.js';
+export { Hyperlink } from './elements/Hyperlink.js';
+export { Bookmark } from './elements/Bookmark.js';
+export { RangeMarker } from './elements/RangeMarker.js';
+export { Comment } from './elements/Comment.js';
+export { Footnote, FootnoteType } from './elements/Footnote.js';
+export { Endnote, EndnoteType } from './elements/Endnote.js';
+export { Field, ComplexField, createTOCField, } from './elements/Field.js';
+export { createNestedIFMergeField, createMergeField, createRefField, createIFField, createNestedField, parseHyperlinkInstruction, buildHyperlinkInstruction, isHyperlinkInstruction, } from './elements/FieldHelpers.js';
+export { StructuredDocumentTag, } from './elements/StructuredDocumentTag.js';
+export { TableOfContents } from './elements/TableOfContents.js';
+export { TableOfContentsElement } from './elements/TableOfContentsElement.js';
+export { AlternateContent } from './elements/AlternateContent.js';
+export { MathParagraph, MathExpression } from './elements/MathElement.js';
+export { CustomXmlBlock } from './elements/CustomXml.js';
+export { PreservedElement } from './elements/PreservedElement.js';
+export { Revision } from './elements/Revision.js';
+export { isRunContent, isHyperlinkContent } from './elements/RevisionContent.js';
+export { isRunPropertyChange, isParagraphPropertyChange, isTablePropertyChange, isSectionPropertyChange, isNumberingChange, } from './elements/PropertyChangeTypes.js';
+export { acceptRevisionsInMemory, paragraphHasRevisions, getRevisionsFromParagraph, countRevisionsByType, stripRevisionsFromXml, } from './processors/InMemoryRevisionAcceptor.js';
+export { MoveOperationHelper, } from './processors/MoveOperationHelper.js';
+export { SelectiveRevisionAcceptor, } from './processors/SelectiveRevisionAcceptor.js';
+export { RevisionAwareProcessor, } from './processors/RevisionAwareProcessor.js';
+export { ChangelogGenerator, } from './processors/ChangelogGenerator.js';
+export { Style } from './formatting/Style.js';
+export { StylesManager, } from './formatting/StylesManager.js';
+export { NumberingLevel, WORD_NATIVE_BULLETS, } from './formatting/NumberingLevel.js';
+export { AbstractNumbering } from './formatting/AbstractNumbering.js';
+export { NumberingInstance } from './formatting/NumberingInstance.js';
+export { NumberingManager, } from './formatting/NumberingManager.js';
+export { RevisionManager } from './elements/RevisionManager.js';
+export { ImageManager } from './elements/ImageManager.js';
+export { BookmarkManager } from './elements/BookmarkManager.js';
+export { CommentManager } from './elements/CommentManager.js';
+export { FootnoteManager } from './elements/FootnoteManager.js';
+export { EndnoteManager } from './elements/EndnoteManager.js';
+export { HeaderFooterManager } from './elements/HeaderFooterManager.js';
+export { FontManager } from './elements/FontManager.js';
+export { DrawingManager, } from './managers/DrawingManager.js';
+export { buildShadingAttributes, isShadingPattern, isBorderStyle, isHorizontalAlignment, isVerticalAlignment, isParagraphAlignment, isWidthType, DEFAULT_BORDER, NO_BORDER, } from './elements/CommonTypes.js';
+export { CompatibilityMode, } from './types/compatibility-types.js';
+export { CompatibilityUpgrader } from './processors/CompatibilityUpgrader.js';
+export { LEGACY_COMPAT_ELEMENTS, LEGACY_COMPAT_ELEMENT_NAMES, MODERN_COMPAT_SETTINGS, MS_WORD_COMPAT_URI, } from './constants/legacyCompatFlags.js';
+export { STANDARD_DPI, UNITS, PAGE_SIZES, COMMON_MARGINS, twipsToPoints, twipsToInches, twipsToCm, twipsToEmus, emusToTwips, emusToInches, emusToCm, emusToPoints, emusToPixels, pointsToTwips, pointsToEmus, pointsToInches, pointsToCm, pointsToHalfPoints, halfPointsToPoints, inchesToTwips, inchesToEmus, inchesToPoints, inchesToCm, inchesToPixels, cmToTwips, cmToEmus, cmToInches, cmToPoints, cmToPixels, pixelsToEmus, pixelsToInches, pixelsToTwips, pixelsToCm, pixelsToPoints, } from './utils/units.js';
+export { validateDocxStructure, isBinaryFile, normalizePath, isValidZipBuffer, isTextContent, validateTwips, validateColor, validateHexColor, normalizeColor, validateNumberingId, validateLevel, validateAlignment, validateFontSize, validateNonEmptyString, validatePercentage, validateEmus, detectXmlInText, cleanXmlFromText, validateRunText, sanitizeHyperlinkUrl, } from './utils/validation.js';
+export { detectCorruptionInDocument, detectCorruptionInText, suggestFix, looksCorrupted, } from './utils/corruptionDetection.js';
+export { isError, toError, wrapError, getErrorMessage } from './utils/errorHandling.js';
+export { REVISION_RULES, createIssueFromRule, getRuleByCode, getRulesBySeverity, getAutoFixableRules, RevisionValidator, RevisionAutoFixer, } from './validation/index.js';
+export { mergeFormatting, cloneFormatting, hasFormatting, cleanFormatting, isEqualFormatting, applyDefaults, } from './utils/formatting.js';
+export { safeParseInt, parseOoxmlBoolean, isExplicitlySet, parseNumericAttribute, parseOnOffAttribute, } from './utils/parsingHelpers.js';
+export { removeInvalidXmlChars, findInvalidXmlChars, hasInvalidXmlChars, XML_CONTROL_CHARS, } from './utils/xmlSanitization.js';
+export { detectTypedPrefix, detectListType, inferLevelFromIndentation, getParagraphIndentation, validateListSequence, getListCategoryFromFormat, getLevelFromFormat, TYPED_LIST_PATTERNS, PATTERN_TO_CATEGORY, FORMAT_TO_LEVEL, } from './utils/list-detection.js';
+export { LogLevel, ConsoleLogger, SilentLogger, CollectingLogger, defaultLogger, createScopedLogger, createComponentLogger, getGlobalLogger, setGlobalLogger, resetGlobalLogger, } from './utils/logger.js';
+export { RevisionWalker } from './processors/RevisionWalker.js';
+export { resolveCellShading } from './processors/ShadingResolver.js';
+export { decodeCnfStyle, getActiveConditionalsInPriorityOrder, } from './processors/cnfStyleDecoder.js';
+export { CleanupHelper } from './helpers/CleanupHelper.js';
+export { RelationshipType, } from './core/Relationship.js';
+export { ElementRegistry, } from './core/ElementRegistry.js';
+export { RegisteredBodyElement } from './elements/RegisteredBodyElement.js';
+export { ValidationRuleRegistry, } from './validation/ValidationRuleRegistry.js';
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * DocXML - DOCX Editing Framework\n * Main entry point\n */\n\n// =============================================================================\n// PUBLIC API — Core Document Classes\n// =============================================================================\n\nexport {\n  Document,\n  DocumentProperties,\n  DocumentOptions,\n  DocumentLoadOptions,\n  DocumentPart,\n} from './core/Document.js';\n\n// =============================================================================\n// PUBLIC API — Document Elements\n// =============================================================================\n\nexport {\n  Paragraph,\n  ParagraphAlignment,\n  ParagraphFormatting,\n  ParagraphContent,\n  FieldLike,\n  isRun,\n  isField,\n  isSimpleField,\n  isComplexField,\n  isHyperlink,\n  isRevision,\n  isRangeMarker,\n  isShape,\n  isTextBox,\n} from './elements/Paragraph.js';\nexport { Run, RunFormatting, ThemeColorValue, LanguageConfig } from './elements/Run.js';\nexport {\n  Section,\n  PageOrientation,\n  SectionType,\n  PageNumberFormat,\n  PageSize,\n  Margins,\n  Columns,\n  PageNumbering,\n  SectionProperties,\n  LineNumbering,\n  LineNumberingRestart,\n} from './elements/Section.js';\nexport {\n  Table,\n  TableAlignment,\n  TableLayout,\n  TableBorder,\n  TableBorders,\n  TableFormatting,\n} from './elements/Table.js';\nexport { TableRow, RowFormatting } from './elements/TableRow.js';\nexport {\n  TableCell,\n  CellBorder,\n  CellBorders,\n  CellShading,\n  CellFormatting,\n} from './elements/TableCell.js';\nexport {\n  TableGridChange,\n  GridColumn,\n  TableGridChangeProperties,\n} from './elements/TableGridChange.js';\nexport {\n  Image,\n  ImageFormat,\n  ImageProperties,\n  ImageBorder,\n  ImageEffects,\n  PresetGeometry,\n  BlipCompressionState,\n  PicLockAttribute,\n  PicNonVisualProperties,\n} from './elements/Image.js';\nexport { ImageRun } from './elements/ImageRun.js';\nexport { Shape, ShapeType, ShapeProperties, ShapeFill, ShapeOutline } from './elements/Shape.js';\nexport { TextBox, TextBoxProperties, TextBoxFill, TextBoxMargins } from './elements/TextBox.js';\nexport { Header, HeaderType, HeaderProperties } from './elements/Header.js';\nexport { Footer, FooterType, FooterProperties } from './elements/Footer.js';\nexport { Hyperlink, HyperlinkProperties } from './elements/Hyperlink.js';\nexport { Bookmark, BookmarkProperties } from './elements/Bookmark.js';\nexport { RangeMarker, RangeMarkerType, RangeMarkerProperties } from './elements/RangeMarker.js';\nexport { Comment, CommentProperties } from './elements/Comment.js';\nexport { Footnote, FootnoteType, FootnoteProperties } from './elements/Footnote.js';\nexport { Endnote, EndnoteType, EndnoteProperties } from './elements/Endnote.js';\nexport {\n  Field,\n  FieldType,\n  FieldProperties,\n  ComplexField,\n  ComplexFieldProperties,\n  FieldCharType,\n  TOCFieldOptions,\n  createTOCField,\n} from './elements/Field.js';\nexport {\n  createNestedIFMergeField,\n  createMergeField,\n  createRefField,\n  createIFField,\n  createNestedField,\n  parseHyperlinkInstruction,\n  buildHyperlinkInstruction,\n  isHyperlinkInstruction,\n  ParsedHyperlinkInstruction,\n} from './elements/FieldHelpers.js';\nexport {\n  StructuredDocumentTag,\n  SDTProperties,\n  SDTLockType,\n  SDTContent,\n  SDTPlaceholder,\n  SDTDataBinding,\n  ContentControlType,\n} from './elements/StructuredDocumentTag.js';\nexport { TableOfContents, TOCProperties } from './elements/TableOfContents.js';\nexport { TableOfContentsElement } from './elements/TableOfContentsElement.js';\nexport { AlternateContent } from './elements/AlternateContent.js';\nexport { MathParagraph, MathExpression } from './elements/MathElement.js';\nexport { CustomXmlBlock } from './elements/CustomXml.js';\nexport { PreservedElement, PreservedElementContext } from './elements/PreservedElement.js';\n\n// =============================================================================\n// PUBLIC API — Track Changes / Revisions\n// =============================================================================\n\nexport { Revision, RevisionType, RevisionProperties, FieldContext } from './elements/Revision.js';\nexport { RevisionContent, isRunContent, isHyperlinkContent } from './elements/RevisionContent.js';\nexport {\n  RevisionLocation,\n  RunPropertyChange,\n  ParagraphPropertyChange,\n  ParagraphFormattingPartial,\n  ParagraphBorderDef,\n  ParagraphBorders,\n  ParagraphShading,\n  TabStopDef,\n  PropertyChangeBase,\n  TablePropertyChange,\n  TablePropertyChangeType,\n  SectionPropertyChange,\n  NumberingChange,\n  AnyPropertyChange,\n  isRunPropertyChange,\n  isParagraphPropertyChange,\n  isTablePropertyChange,\n  isSectionPropertyChange,\n  isNumberingChange,\n} from './elements/PropertyChangeTypes.js';\nexport {\n  acceptRevisionsInMemory,\n  AcceptRevisionsOptions,\n  AcceptRevisionsResult,\n  paragraphHasRevisions,\n  getRevisionsFromParagraph,\n  countRevisionsByType,\n  stripRevisionsFromXml,\n} from './processors/InMemoryRevisionAcceptor.js';\nexport {\n  MoveOperationHelper,\n  MoveOperationOptions,\n  MoveOperationResult,\n} from './processors/MoveOperationHelper.js';\nexport {\n  SelectiveRevisionAcceptor,\n  SelectiveAcceptResult,\n} from './processors/SelectiveRevisionAcceptor.js';\nexport {\n  RevisionAwareProcessor,\n  RevisionHandlingMode,\n  RevisionProcessingOptions,\n  SelectionCriteria,\n  RevisionProcessingResult,\n  ConflictInfo,\n  ProcessingLogEntry,\n} from './processors/RevisionAwareProcessor.js';\nexport {\n  ChangelogGenerator,\n  ChangeEntry,\n  ChangeCategory,\n  ChangeLocation,\n  ChangelogOptions,\n  ChangelogFormat,\n  ConsolidatedChange,\n  ChangelogSummary,\n} from './processors/ChangelogGenerator.js';\n\n// =============================================================================\n// PUBLIC API — Formatting / Styles / Numbering\n// =============================================================================\n\nexport { Style, StyleType, StyleProperties } from './formatting/Style.js';\nexport {\n  StylesManager,\n  ValidationResult,\n  LatentStylesConfig,\n  LatentStyleException,\n} from './formatting/StylesManager.js';\nexport {\n  NumberingLevel,\n  NumberFormat,\n  NumberAlignment,\n  NumberingLevelProperties,\n  WORD_NATIVE_BULLETS,\n  WordNativeBullet,\n} from './formatting/NumberingLevel.js';\nexport { AbstractNumbering, AbstractNumberingProperties } from './formatting/AbstractNumbering.js';\nexport { NumberingInstance, NumberingInstanceProperties } from './formatting/NumberingInstance.js';\nexport {\n  NumberingManager,\n  NumberingConsolidationOptions,\n  NumberingConsolidationResult,\n} from './formatting/NumberingManager.js';\nexport {\n  StyleRunFormatting,\n  StyleParagraphFormatting,\n  Heading2TableOptions,\n  StyleConfig,\n  Heading2Config,\n  ApplyCustomFormattingOptions,\n} from './types/styleConfig.js';\nexport { FormatOptions, StyleApplyOptions, EmphasisType, ListPrefix } from './types/formatting.js';\n\n// =============================================================================\n// PUBLIC API — Managers\n// =============================================================================\n\nexport { RevisionManager, RevisionCategory, RevisionSummary } from './elements/RevisionManager.js';\nexport { ImageManager } from './elements/ImageManager.js';\nexport { BookmarkManager } from './elements/BookmarkManager.js';\nexport { CommentManager } from './elements/CommentManager.js';\nexport { FootnoteManager } from './elements/FootnoteManager.js';\nexport { EndnoteManager } from './elements/EndnoteManager.js';\nexport { HeaderFooterManager } from './elements/HeaderFooterManager.js';\nexport { FontManager, FontFormat, FontEntry } from './elements/FontManager.js';\nexport {\n  DrawingManager,\n  DrawingElement,\n  DrawingType,\n  PreservedDrawing,\n} from './managers/DrawingManager.js';\n\n// =============================================================================\n// PUBLIC API — Image Optimization\n// =============================================================================\n\nexport type { ImageOptimizationResult } from './images/ImageOptimizer.js';\n\n// =============================================================================\n// TYPES — Common / Shared Type Definitions\n// =============================================================================\n\nexport {\n  ShadingPattern,\n  BasicShadingPattern,\n  BorderStyle,\n  ExtendedBorderStyle,\n  FullBorderStyle,\n  BorderDefinition,\n  FourSidedBorders,\n  TableBorderDefinitions,\n  HorizontalAlignment,\n  VerticalAlignment,\n  PageVerticalAlignment,\n  CellVerticalAlignment,\n  ParagraphAlignment as CommonParagraphAlignment,\n  TableAlignment as CommonTableAlignment,\n  RowJustification,\n  TextVerticalAlignment,\n  TabAlignment,\n  PositionAnchor,\n  HorizontalAnchor,\n  VerticalAnchor,\n  TextDirection,\n  SectionTextDirection,\n  WidthType,\n  ShadingConfig,\n  buildShadingAttributes,\n  TabLeader,\n  TabStop,\n  isShadingPattern,\n  isBorderStyle,\n  isHorizontalAlignment,\n  isVerticalAlignment,\n  isParagraphAlignment,\n  isWidthType,\n  DEFAULT_BORDER,\n  NO_BORDER,\n} from './elements/CommonTypes.js';\nexport {\n  ListCategory,\n  NumberFormat as ListNumberFormat,\n  BulletFormat,\n  ListDetectionResult,\n  ListAnalysis,\n  ListNormalizationOptions,\n  ListNormalizationReport,\n  IndentationLevel,\n} from './types/list-types.js';\n\nexport {\n  CompatibilityMode,\n  CompatibilityInfo,\n  CompatSetting,\n} from './types/compatibility-types.js';\n\nexport {\n  DocumentProtection,\n  RevisionViewSettings,\n  TrackChangesSettings,\n  WebSettingsInfo,\n} from './types/settings-types.js';\n\n// =============================================================================\n// TYPES — Compatibility Upgrade\n// =============================================================================\n\nexport { CompatibilityUpgrader, UpgradeReport } from './processors/CompatibilityUpgrader.js';\nexport {\n  LEGACY_COMPAT_ELEMENTS,\n  LEGACY_COMPAT_ELEMENT_NAMES,\n  MODERN_COMPAT_SETTINGS,\n  MS_WORD_COMPAT_URI,\n} from './constants/legacyCompatFlags.js';\n\n// =============================================================================\n// UTILITIES — Unit Conversions\n// =============================================================================\n\nexport {\n  STANDARD_DPI,\n  UNITS,\n  PAGE_SIZES,\n  COMMON_MARGINS,\n  twipsToPoints,\n  twipsToInches,\n  twipsToCm,\n  twipsToEmus,\n  emusToTwips,\n  emusToInches,\n  emusToCm,\n  emusToPoints,\n  emusToPixels,\n  pointsToTwips,\n  pointsToEmus,\n  pointsToInches,\n  pointsToCm,\n  pointsToHalfPoints,\n  halfPointsToPoints,\n  inchesToTwips,\n  inchesToEmus,\n  inchesToPoints,\n  inchesToCm,\n  inchesToPixels,\n  cmToTwips,\n  cmToEmus,\n  cmToInches,\n  cmToPoints,\n  cmToPixels,\n  pixelsToEmus,\n  pixelsToInches,\n  pixelsToTwips,\n  pixelsToCm,\n  pixelsToPoints,\n} from './utils/units.js';\n\n// =============================================================================\n// UTILITIES — Validation, Corruption Detection, Error Handling\n// =============================================================================\n\nexport {\n  validateDocxStructure,\n  isBinaryFile,\n  normalizePath,\n  isValidZipBuffer,\n  isTextContent,\n  validateTwips,\n  validateColor,\n  validateHexColor,\n  normalizeColor,\n  validateNumberingId,\n  validateLevel,\n  validateAlignment,\n  validateFontSize,\n  validateNonEmptyString,\n  validatePercentage,\n  validateEmus,\n  detectXmlInText,\n  cleanXmlFromText,\n  validateRunText,\n  sanitizeHyperlinkUrl,\n  SanitizeHyperlinkUrlResult,\n  TextValidationResult,\n} from './utils/validation.js';\nexport {\n  detectCorruptionInDocument,\n  detectCorruptionInText,\n  suggestFix,\n  looksCorrupted,\n  CorruptionReport,\n  CorruptionLocation,\n  CorruptionType,\n} from './utils/corruptionDetection.js';\nexport { isError, toError, wrapError, getErrorMessage } from './utils/errorHandling.js';\nexport {\n  REVISION_RULES,\n  ValidationSeverity,\n  ValidationIssue,\n  ValidationRule,\n  ValidationOptions,\n  AutoFixOptions,\n  ValidationResult as RevisionValidationResult,\n  FixAction,\n  AutoFixResult,\n  createIssueFromRule,\n  getRuleByCode,\n  getRulesBySeverity,\n  getAutoFixableRules,\n  RevisionValidator,\n  RevisionAutoFixer,\n} from './validation/index.js';\n\n// =============================================================================\n// UTILITIES — Formatting, Parsing, Sanitization\n// =============================================================================\n\nexport {\n  mergeFormatting,\n  cloneFormatting,\n  hasFormatting,\n  cleanFormatting,\n  isEqualFormatting,\n  applyDefaults,\n} from './utils/formatting.js';\nexport {\n  safeParseInt,\n  parseOoxmlBoolean,\n  isExplicitlySet,\n  parseNumericAttribute,\n  parseOnOffAttribute,\n} from './utils/parsingHelpers.js';\nexport {\n  removeInvalidXmlChars,\n  findInvalidXmlChars,\n  hasInvalidXmlChars,\n  XML_CONTROL_CHARS,\n} from './utils/xmlSanitization.js';\n\n// =============================================================================\n// UTILITIES — List Detection (kept for basic detection; normalization moved to consumer)\n// =============================================================================\n\nexport {\n  detectTypedPrefix,\n  detectListType,\n  inferLevelFromIndentation,\n  getParagraphIndentation,\n  validateListSequence,\n  getListCategoryFromFormat,\n  getLevelFromFormat,\n  TYPED_LIST_PATTERNS,\n  PATTERN_TO_CATEGORY,\n  FORMAT_TO_LEVEL,\n} from './utils/list-detection.js';\n\n// =============================================================================\n// UTILITIES — Logging\n// =============================================================================\n\nexport {\n  ILogger,\n  LogLevel,\n  LogEntry,\n  ConsoleLogger,\n  SilentLogger,\n  CollectingLogger,\n  defaultLogger,\n  createScopedLogger,\n  createComponentLogger,\n  getGlobalLogger,\n  setGlobalLogger,\n  resetGlobalLogger,\n} from './utils/logger.js';\n\n// =============================================================================\n// UTILITIES — Revision Walker\n// =============================================================================\n\nexport { RevisionWalker, RevisionWalkerOptions } from './processors/RevisionWalker.js';\nexport { resolveCellShading } from './processors/ShadingResolver.js';\nexport {\n  decodeCnfStyle,\n  getActiveConditionalsInPriorityOrder,\n} from './processors/cnfStyleDecoder.js';\n\n// =============================================================================\n// UTILITIES — Cleanup\n// =============================================================================\n\nexport { CleanupHelper, CleanupOptions, CleanupReport } from './helpers/CleanupHelper.js';\n\n// =============================================================================\n// PUBLIC — Type unions consumers see when iterating doc.getBodyElements()\n// =============================================================================\n\nexport type { BodyElement } from './core/DocumentContent.js';\nexport {\n  RelationshipType,\n  type Relationship,\n  type RelationshipProperties,\n} from './core/Relationship.js';\n\n// =============================================================================\n// EXTENSIBILITY — Plugin Registries and Document Events\n// =============================================================================\n\nexport {\n  ElementRegistry,\n  type ElementHandler,\n  type ElementParseContext,\n  type ElementSerializeContext,\n} from './core/ElementRegistry.js';\nexport { RegisteredBodyElement } from './elements/RegisteredBodyElement.js';\nexport {\n  ValidationRuleRegistry,\n  type CustomValidationRule,\n  type CustomValidationIssue,\n  type CustomValidationSeverity,\n} from './validation/ValidationRuleRegistry.js';\nexport type {\n  DocumentEventMap,\n  DocumentEventType,\n  DocumentEventListener,\n} from './core/DocumentEvents.js';\n\n// Low-level building blocks — XMLBuilder, XMLParser, ZipHandler,\n// ZipReader, ZipWriter, DocumentParser, DocumentGenerator,\n// DocumentValidator, DocumentIdManager, DocumentContent,\n// RelationshipManager, DocumentEventEmitter, plus zip/xml types and\n// DocxError hierarchy — moved to the `docxmlater/internal` subpath in\n// 11.0.0. Migrate via:\n//   import { XMLParser, ZipHandler } from 'docxmlater/internal';\n// The internal subpath has relaxed semver — pin an exact version.\n"]}

package/dist/esm/internal.js

@@ -0,0 +1,16 @@
+export { ZipHandler } from './zip/ZipHandler.js';
+export { ZipReader } from './zip/ZipReader.js';
+export { ZipWriter } from './zip/ZipWriter.js';
+export { DEFAULT_SIZE_LIMITS, REQUIRED_DOCX_FILES, DOCX_PATHS, } from './zip/types.js';
+export { DocxError, DocxNotFoundError, InvalidDocxError, CorruptedArchiveError, MissingRequiredFileError, FileOperationError, } from './zip/errors.js';
+export { XMLBuilder } from './xml/XMLBuilder.js';
+export { XMLParser, DEFAULT_MAX_NESTING_DEPTH, } from './xml/XMLParser.js';
+export { RelationshipManager } from './core/RelationshipManager.js';
+export { DocumentParser } from './core/DocumentParser.js';
+export { DocumentGenerator } from './core/DocumentGenerator.js';
+export { DocumentValidator, } from './core/DocumentValidator.js';
+export { DocumentIdManager } from './core/DocumentIdManager.js';
+export { DocumentContent } from './core/DocumentContent.js';
+export { DocumentEventEmitter } from './core/DocumentEvents.js';
+export { LIMITS } from './constants/limits.js';
+//# sourceMappingURL=internal.js.map

package/dist/esm/internal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal.js","sourceRoot":"","sources":["../../src/internal.ts"],"names":[],"mappings":"AA2BA,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAOL,mBAAmB,EACnB,mBAAmB,EACnB,UAAU,GACX,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,SAAS,EACT,iBAAiB,EACjB,gBAAgB,EAChB,qBAAqB,EACrB,wBAAwB,EACxB,kBAAkB,GACnB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EAAE,UAAU,EAAmB,MAAM,qBAAqB,CAAC;AAClE,OAAO,EACL,SAAS,EAIT,yBAAyB,GAC1B,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AACpE,OAAO,EAAE,cAAc,EAAc,MAAM,0BAA0B,CAAC;AACtE,OAAO,EAAE,iBAAiB,EAA0B,MAAM,6BAA6B,CAAC;AACxF,OAAO,EACL,iBAAiB,GAGlB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAK5D,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAGhE,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC","sourcesContent":["/**\n * docxmlater INTERNAL API\n *\n * Subpath export consumed via `import { ... } from 'docxmlater/internal'`.\n * Surfaces low-level building blocks for advanced consumers writing\n * tooling that needs raw XML / ZIP / parser access:\n *   - ZipHandler, ZipReader, ZipWriter (+ types and DocxError hierarchy)\n *   - XMLBuilder, XMLParser (+ ParseToObjectOptions etc.)\n *   - DocumentParser, DocumentGenerator, DocumentValidator\n *   - DocumentIdManager, DocumentContent, RelationshipManager\n *   - DocumentEventEmitter (the emitter class itself)\n *   - LIMITS constants\n *\n * **Stability:** these exports follow a relaxed semver — minor version\n * bumps may change signatures. Pin an exact docxmlater version when\n * consuming the internal subpath. The main API (`from 'docxmlater'`)\n * follows full semver.\n *\n * Symbols moved out of the main API in 11.0.0 — see CHANGELOG.\n *\n * The plugin registries (`ElementRegistry`, `ValidationRuleRegistry`)\n * and event types (`DocumentEventMap`, `DocumentEventListener`,\n * `DocumentEventType`) are NOT re-exported here — they belong in the\n * main API as stable extension points.\n */\n\n// ZIP layer\nexport { ZipHandler } from './zip/ZipHandler.js';\nexport { ZipReader } from './zip/ZipReader.js';\nexport { ZipWriter } from './zip/ZipWriter.js';\nexport {\n  type ZipFile,\n  type FileMap,\n  type LoadOptions,\n  type SaveOptions,\n  type AddFileOptions,\n  type SizeLimitOptions,\n  DEFAULT_SIZE_LIMITS,\n  REQUIRED_DOCX_FILES,\n  DOCX_PATHS,\n} from './zip/types.js';\nexport {\n  DocxError,\n  DocxNotFoundError,\n  InvalidDocxError,\n  CorruptedArchiveError,\n  MissingRequiredFileError,\n  FileOperationError,\n} from './zip/errors.js';\n\n// XML layer\nexport { XMLBuilder, type XMLElement } from './xml/XMLBuilder.js';\nexport {\n  XMLParser,\n  type ParseToObjectOptions,\n  type ParsedXMLValue,\n  type ParsedXMLObject,\n  DEFAULT_MAX_NESTING_DEPTH,\n} from './xml/XMLParser.js';\n\n// Core orchestration\nexport { RelationshipManager } from './core/RelationshipManager.js';\nexport { DocumentParser, ParseError } from './core/DocumentParser.js';\nexport { DocumentGenerator, type IZipHandlerReader } from './core/DocumentGenerator.js';\nexport {\n  DocumentValidator,\n  type SizeEstimate,\n  type MemoryOptions,\n} from './core/DocumentValidator.js';\nexport { DocumentIdManager } from './core/DocumentIdManager.js';\nexport { DocumentContent } from './core/DocumentContent.js';\n\n// Document events — the emitter class is internal; the type aliases\n// (DocumentEventMap, DocumentEventListener, DocumentEventType) live in\n// the main API.\nexport { DocumentEventEmitter } from './core/DocumentEvents.js';\n\n// Constants\nexport { LIMITS } from './constants/limits.js';\n"]}

package/dist/esm/managers/DrawingManager.js

@@ -0,0 +1,163 @@
+import { Image } from '../elements/Image.js';
+import { Shape } from '../elements/Shape.js';
+import { TextBox } from '../elements/TextBox.js';
+export class DrawingManager {
+    drawings = new Map();
+    nextId = 1;
+    imageIds = new Set();
+    shapeIds = new Set();
+    textboxIds = new Set();
+    preservedIds = new Set();
+    constructor() {
+    }
+    addImage(image) {
+        const id = this.generateId();
+        image.setDocPrId(this.nextId - 1);
+        this.drawings.set(id, image);
+        this.imageIds.add(id);
+        return id;
+    }
+    addShape(shape) {
+        const id = this.generateId();
+        shape.setDocPrId(this.nextId - 1);
+        this.drawings.set(id, shape);
+        this.shapeIds.add(id);
+        return id;
+    }
+    addTextBox(textbox) {
+        const id = this.generateId();
+        textbox.setDocPrId(this.nextId - 1);
+        this.drawings.set(id, textbox);
+        this.textboxIds.add(id);
+        return id;
+    }
+    addPreservedDrawing(drawing) {
+        const id = this.generateId();
+        this.drawings.set(id, { ...drawing, id });
+        this.preservedIds.add(id);
+        return id;
+    }
+    getDrawing(id) {
+        return this.drawings.get(id);
+    }
+    getAllDrawings() {
+        return Array.from(this.drawings.values());
+    }
+    getAllImages() {
+        const images = [];
+        for (const id of this.imageIds) {
+            const drawing = this.drawings.get(id);
+            if (drawing instanceof Image) {
+                images.push(drawing);
+            }
+        }
+        return images;
+    }
+    getAllShapes() {
+        const shapes = [];
+        for (const id of this.shapeIds) {
+            const drawing = this.drawings.get(id);
+            if (drawing instanceof Shape) {
+                shapes.push(drawing);
+            }
+        }
+        return shapes;
+    }
+    getAllTextBoxes() {
+        const textboxes = [];
+        for (const id of this.textboxIds) {
+            const drawing = this.drawings.get(id);
+            if (drawing instanceof TextBox) {
+                textboxes.push(drawing);
+            }
+        }
+        return textboxes;
+    }
+    getAllPreservedDrawings() {
+        const preserved = [];
+        for (const id of this.preservedIds) {
+            const drawing = this.drawings.get(id);
+            if (drawing && this.isPreservedDrawing(drawing)) {
+                preserved.push(drawing);
+            }
+        }
+        return preserved;
+    }
+    removeDrawing(id) {
+        const deleted = this.drawings.delete(id);
+        if (deleted) {
+            this.imageIds.delete(id);
+            this.shapeIds.delete(id);
+            this.textboxIds.delete(id);
+            this.preservedIds.delete(id);
+        }
+        return deleted;
+    }
+    getCount() {
+        return this.drawings.size;
+    }
+    isEmpty() {
+        return this.drawings.size === 0;
+    }
+    clear() {
+        this.drawings.clear();
+        this.imageIds.clear();
+        this.shapeIds.clear();
+        this.textboxIds.clear();
+        this.preservedIds.clear();
+        this.nextId = 1;
+    }
+    getDrawingType(drawing) {
+        if (drawing instanceof Image) {
+            return 'image';
+        }
+        else if (drawing instanceof Shape) {
+            return 'shape';
+        }
+        else if (drawing instanceof TextBox) {
+            return 'textbox';
+        }
+        else {
+            return 'preserved';
+        }
+    }
+    isPreservedDrawing(drawing) {
+        return (!!drawing &&
+            typeof drawing === 'object' &&
+            'type' in drawing &&
+            'xml' in drawing &&
+            'relationshipIds' in drawing &&
+            (drawing.type === 'smartart' ||
+                drawing.type === 'chart' ||
+                drawing.type === 'wordart'));
+    }
+    generateId() {
+        const id = `drawing_${this.nextId}`;
+        this.nextId++;
+        return id;
+    }
+    assignIds() {
+        let docPrId = 1;
+        for (const drawing of this.drawings.values()) {
+            if (drawing instanceof Image) {
+                drawing.setDocPrId(docPrId++);
+            }
+            else if (drawing instanceof Shape) {
+                drawing.setDocPrId(docPrId++);
+            }
+            else if (drawing instanceof TextBox) {
+                drawing.setDocPrId(docPrId++);
+            }
+        }
+    }
+    getStats() {
+        return {
+            total: this.drawings.size,
+            images: this.imageIds.size,
+            shapes: this.shapeIds.size,
+            textboxes: this.textboxIds.size,
+            preserved: this.preservedIds.size,
+        };
+    }
+}
+//# sourceMappingURL=DrawingManager.js.map

package/dist/esm/managers/DrawingManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DrawingManager.js","sourceRoot":"","sources":["../../../src/managers/DrawingManager.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * DrawingManager - Manages all drawing elements in a document\n *\n * Centralizes management of images, shapes, and text boxes.\n * Assigns unique IDs and handles relationship management.\n */\n\nimport { Image } from '../elements/Image.js';\nimport { Shape } from '../elements/Shape.js';\nimport { TextBox } from '../elements/TextBox.js';\n\n/**\n * Type representing any drawing element\n */\nexport type DrawingElement = Image | Shape | TextBox;\n\n/**\n * Drawing type discriminator\n */\nexport type DrawingType = 'image' | 'shape' | 'textbox' | 'preserved';\n\n/**\n * Preserved drawing (SmartArt, Chart, WordArt)\n * These are stored as raw XML for round-trip preservation\n */\nexport interface PreservedDrawing {\n  /** Type of preserved drawing */\n  type: 'smartart' | 'chart' | 'wordart';\n  /** Raw XML content */\n  xml: string;\n  /** Relationship IDs referenced by this drawing */\n  relationshipIds: string[];\n  /** Unique ID for this drawing */\n  id: string;\n}\n\n/**\n * Manages all drawing elements in a document\n *\n * Performance: Uses type-indexed Sets for O(1) type-specific lookups\n * instead of O(n) linear scans through the main Map.\n */\nexport class DrawingManager {\n  private drawings = new Map<string, DrawingElement | PreservedDrawing>();\n  private nextId = 1;\n\n  // Type-indexed Sets for O(1) type-specific lookups\n  private imageIds = new Set<string>();\n  private shapeIds = new Set<string>();\n  private textboxIds = new Set<string>();\n  private preservedIds = new Set<string>();\n\n  /**\n   * Creates a new DrawingManager\n   */\n  constructor() {\n    // Empty constructor\n  }\n\n  /**\n   * Adds an image to the manager\n   * @param image Image to add\n   * @returns Assigned ID\n   */\n  addImage(image: Image): string {\n    const id = this.generateId();\n    image.setDocPrId(this.nextId - 1);\n    this.drawings.set(id, image);\n    this.imageIds.add(id);\n    return id;\n  }\n\n  /**\n   * Adds a shape to the manager\n   * @param shape Shape to add\n   * @returns Assigned ID\n   */\n  addShape(shape: Shape): string {\n    const id = this.generateId();\n    shape.setDocPrId(this.nextId - 1);\n    this.drawings.set(id, shape);\n    this.shapeIds.add(id);\n    return id;\n  }\n\n  /**\n   * Adds a text box to the manager\n   * @param textbox TextBox to add\n   * @returns Assigned ID\n   */\n  addTextBox(textbox: TextBox): string {\n    const id = this.generateId();\n    textbox.setDocPrId(this.nextId - 1);\n    this.drawings.set(id, textbox);\n    this.textboxIds.add(id);\n    return id;\n  }\n\n  /**\n   * Adds a preserved drawing (SmartArt, Chart, WordArt)\n   * @param drawing Preserved drawing to add\n   * @returns Assigned ID\n   */\n  addPreservedDrawing(drawing: PreservedDrawing): string {\n    const id = this.generateId();\n    this.drawings.set(id, { ...drawing, id });\n    this.preservedIds.add(id);\n    return id;\n  }\n\n  /**\n   * Gets a drawing by ID\n   * @param id Drawing ID\n   * @returns Drawing element or undefined\n   */\n  getDrawing(id: string): DrawingElement | PreservedDrawing | undefined {\n    return this.drawings.get(id);\n  }\n\n  /**\n   * Gets all drawings\n   * @returns Array of all drawing elements\n   */\n  getAllDrawings(): (DrawingElement | PreservedDrawing)[] {\n    return Array.from(this.drawings.values());\n  }\n\n  /**\n   * Gets all images\n   * Performance: O(k) where k = number of images (uses indexed lookup)\n   * @returns Array of images\n   */\n  getAllImages(): Image[] {\n    const images: Image[] = [];\n    for (const id of this.imageIds) {\n      const drawing = this.drawings.get(id);\n      if (drawing instanceof Image) {\n        images.push(drawing);\n      }\n    }\n    return images;\n  }\n\n  /**\n   * Gets all shapes\n   * Performance: O(k) where k = number of shapes (uses indexed lookup)\n   * @returns Array of shapes\n   */\n  getAllShapes(): Shape[] {\n    const shapes: Shape[] = [];\n    for (const id of this.shapeIds) {\n      const drawing = this.drawings.get(id);\n      if (drawing instanceof Shape) {\n        shapes.push(drawing);\n      }\n    }\n    return shapes;\n  }\n\n  /**\n   * Gets all text boxes\n   * Performance: O(k) where k = number of text boxes (uses indexed lookup)\n   * @returns Array of text boxes\n   */\n  getAllTextBoxes(): TextBox[] {\n    const textboxes: TextBox[] = [];\n    for (const id of this.textboxIds) {\n      const drawing = this.drawings.get(id);\n      if (drawing instanceof TextBox) {\n        textboxes.push(drawing);\n      }\n    }\n    return textboxes;\n  }\n\n  /**\n   * Gets all preserved drawings\n   * Performance: O(k) where k = number of preserved drawings (uses indexed lookup)\n   * @returns Array of preserved drawings\n   */\n  getAllPreservedDrawings(): PreservedDrawing[] {\n    const preserved: PreservedDrawing[] = [];\n    for (const id of this.preservedIds) {\n      const drawing = this.drawings.get(id);\n      if (drawing && this.isPreservedDrawing(drawing)) {\n        preserved.push(drawing);\n      }\n    }\n    return preserved;\n  }\n\n  /**\n   * Removes a drawing by ID\n   * @param id Drawing ID\n   * @returns True if removed, false if not found\n   */\n  removeDrawing(id: string): boolean {\n    const deleted = this.drawings.delete(id);\n    if (deleted) {\n      // Remove from type-specific indices\n      this.imageIds.delete(id);\n      this.shapeIds.delete(id);\n      this.textboxIds.delete(id);\n      this.preservedIds.delete(id);\n    }\n    return deleted;\n  }\n\n  /**\n   * Gets the total number of drawings\n   * @returns Number of drawings\n   */\n  getCount(): number {\n    return this.drawings.size;\n  }\n\n  /**\n   * Checks if the manager has any drawings\n   * @returns True if empty, false otherwise\n   */\n  isEmpty(): boolean {\n    return this.drawings.size === 0;\n  }\n\n  /**\n   * Clears all drawings\n   */\n  clear(): void {\n    this.drawings.clear();\n    this.imageIds.clear();\n    this.shapeIds.clear();\n    this.textboxIds.clear();\n    this.preservedIds.clear();\n    this.nextId = 1;\n  }\n\n  /**\n   * Gets the drawing type\n   * @param drawing Drawing element\n   * @returns Drawing type\n   */\n  getDrawingType(drawing: DrawingElement | PreservedDrawing): DrawingType {\n    if (drawing instanceof Image) {\n      return 'image';\n    } else if (drawing instanceof Shape) {\n      return 'shape';\n    } else if (drawing instanceof TextBox) {\n      return 'textbox';\n    } else {\n      return 'preserved';\n    }\n  }\n\n  /**\n   * Type guard for PreservedDrawing\n   * @param drawing Drawing to check\n   * @returns True if PreservedDrawing\n   */\n  private isPreservedDrawing(drawing: unknown): drawing is PreservedDrawing {\n    return (\n      !!drawing &&\n      typeof drawing === 'object' &&\n      'type' in drawing &&\n      'xml' in drawing &&\n      'relationshipIds' in drawing &&\n      ((drawing as PreservedDrawing).type === 'smartart' ||\n        (drawing as PreservedDrawing).type === 'chart' ||\n        (drawing as PreservedDrawing).type === 'wordart')\n    );\n  }\n\n  /**\n   * Generates a unique ID for a drawing\n   * @private\n   * @returns Unique ID string\n   */\n  private generateId(): string {\n    const id = `drawing_${this.nextId}`;\n    this.nextId++;\n    return id;\n  }\n\n  /**\n   * Assigns sequential docPr IDs to all drawings\n   * Call this before generating the document to ensure unique IDs\n   */\n  assignIds(): void {\n    let docPrId = 1;\n    for (const drawing of this.drawings.values()) {\n      if (drawing instanceof Image) {\n        drawing.setDocPrId(docPrId++);\n      } else if (drawing instanceof Shape) {\n        drawing.setDocPrId(docPrId++);\n      } else if (drawing instanceof TextBox) {\n        drawing.setDocPrId(docPrId++);\n      }\n      // PreservedDrawings don't need docPrId assignment (already in XML)\n    }\n  }\n\n  /**\n   * Gets statistics about the drawings\n   * Performance: O(1) using indexed Set sizes\n   * @returns Statistics object\n   */\n  getStats(): {\n    total: number;\n    images: number;\n    shapes: number;\n    textboxes: number;\n    preserved: number;\n  } {\n    return {\n      total: this.drawings.size,\n      images: this.imageIds.size,\n      shapes: this.shapeIds.size,\n      textboxes: this.textboxIds.size,\n      preserved: this.preservedIds.size,\n    };\n  }\n}\n"]}

package/dist/esm/package.json

@@ -0,0 +1,3 @@
+{
+  "type": "module"
+}