docxmlater 10.4.1 → 11.0.4

package/dist/esm/zip/ZipWriter.js

@@ -0,0 +1,199 @@
+import JSZip from 'jszip';
+import { promises as fs } from 'fs';
+import { FileOperationError } from './errors.js';
+import { validateDocxStructure, normalizePath } from '../utils/validation.js';
+export class ZipWriter {
+    zip;
+    files = new Map();
+    constructor() {
+        this.zip = new JSZip();
+    }
+    validatePathSecurity(path) {
+        if (path.includes('..')) {
+            throw new Error(`Security error: Path "${path}" contains path traversal sequence "..". ` +
+                `This could be an attempt to write files outside the archive.`);
+        }
+        if (path.startsWith('/') || /^[a-zA-Z]:/.test(path)) {
+            throw new Error(`Security error: Path "${path}" is an absolute path. ` +
+                `Only relative paths are allowed in ZIP archives.`);
+        }
+        if (path.includes('\0')) {
+            throw new Error(`Security error: Path "${path}" contains null byte. ` +
+                `This could be an attempt to exploit path handling.`);
+        }
+        const MAX_PATH_LENGTH = 260;
+        if (path.length > MAX_PATH_LENGTH) {
+            throw new Error(`Security error: Path "${path}" exceeds maximum length of ${MAX_PATH_LENGTH} characters.`);
+        }
+    }
+    addFile(filePath, content, options = {}) {
+        const { binary = Buffer.isBuffer(content), compression = 6, date = new Date() } = options;
+        const normalizedPath = normalizePath(filePath);
+        this.validatePathSecurity(normalizedPath);
+        let processedContent = content;
+        if (typeof content === 'string') {
+            processedContent = Buffer.from(content, 'utf8');
+        }
+        const isContentTypes = normalizedPath === '[Content_Types].xml';
+        const useCompression = isContentTypes ? 'STORE' : compression > 0 ? 'DEFLATE' : 'STORE';
+        const compressionLevel = isContentTypes ? 0 : compression;
+        this.zip.file(normalizedPath, processedContent, {
+            binary: true,
+            compression: useCompression,
+            compressionOptions: {
+                level: compressionLevel,
+            },
+            date,
+        });
+        this.files.set(normalizedPath, {
+            path: normalizedPath,
+            content: processedContent,
+            isBinary: binary,
+            size: processedContent.length,
+            date,
+        });
+    }
+    addFiles(files, options = {}) {
+        for (const [path, file] of files) {
+            this.addFile(path, file.content, {
+                ...options,
+                binary: file.isBinary,
+                date: file.date,
+            });
+        }
+    }
+    removeFile(filePath) {
+        const normalizedPath = normalizePath(filePath);
+        const zipFile = this.zip.file(normalizedPath);
+        if (zipFile) {
+            this.zip.remove(normalizedPath);
+            this.files.delete(normalizedPath);
+            return true;
+        }
+        return false;
+    }
+    hasFile(filePath) {
+        const normalizedPath = normalizePath(filePath);
+        return this.files.has(normalizedPath);
+    }
+    getFile(filePath) {
+        const normalizedPath = normalizePath(filePath);
+        return this.files.get(normalizedPath);
+    }
+    getAllFiles() {
+        return new Map(this.files);
+    }
+    getFilePaths() {
+        return Array.from(this.files.keys());
+    }
+    validate() {
+        const filePaths = this.getFilePaths();
+        validateDocxStructure(filePaths);
+    }
+    getSortedFilePaths() {
+        const paths = Array.from(this.files.keys());
+        return paths.sort((a, b) => {
+            if (a === '[Content_Types].xml')
+                return -1;
+            if (b === '[Content_Types].xml')
+                return 1;
+            if (a === '_rels/.rels')
+                return -1;
+            if (b === '_rels/.rels')
+                return 1;
+            const aIsDocProps = a.startsWith('docProps/');
+            const bIsDocProps = b.startsWith('docProps/');
+            if (aIsDocProps && !bIsDocProps)
+                return -1;
+            if (!aIsDocProps && bIsDocProps)
+                return 1;
+            if (a === 'word/_rels/document.xml.rels')
+                return -1;
+            if (b === 'word/_rels/document.xml.rels')
+                return 1;
+            if (a === 'word/document.xml')
+                return -1;
+            if (b === 'word/document.xml')
+                return 1;
+            const aIsWordRels = a.startsWith('word/_rels/');
+            const bIsWordRels = b.startsWith('word/_rels/');
+            const aIsWord = a.startsWith('word/') && !aIsWordRels;
+            const bIsWord = b.startsWith('word/') && !bIsWordRels;
+            if (aIsWord && !bIsWord && !bIsWordRels)
+                return -1;
+            if (!aIsWord && bIsWord && !aIsWordRels)
+                return 1;
+            if (aIsWordRels && !bIsWordRels)
+                return -1;
+            if (!aIsWordRels && bIsWordRels)
+                return 1;
+            return a.localeCompare(b);
+        });
+    }
+    async toBuffer(options = {}) {
+        const { compression = 6, validate = true } = options;
+        if (validate) {
+            this.validate();
+        }
+        try {
+            const orderedZip = new JSZip();
+            const sortedPaths = this.getSortedFilePaths();
+            for (const path of sortedPaths) {
+                const file = this.files.get(path);
+                if (!file)
+                    continue;
+                const processedContent = file.content;
+                const isContentTypes = path === '[Content_Types].xml';
+                const useCompression = isContentTypes ? 'STORE' : compression > 0 ? 'DEFLATE' : 'STORE';
+                const compressionLevel = isContentTypes ? 0 : compression;
+                orderedZip.file(path, processedContent, {
+                    binary: true,
+                    compression: useCompression,
+                    compressionOptions: {
+                        level: compressionLevel,
+                    },
+                    date: file.date,
+                });
+            }
+            const buffer = await orderedZip.generateAsync({
+                type: 'nodebuffer',
+                compression: compression > 0 ? 'DEFLATE' : 'STORE',
+                compressionOptions: {
+                    level: compression,
+                },
+                streamFiles: true,
+            });
+            return buffer;
+        }
+        catch (error) {
+            const err = error instanceof Error ? error : new Error(String(error));
+            throw new FileOperationError('generate', err.message);
+        }
+    }
+    async saveToFile(filePath, options = {}) {
+        try {
+            const buffer = await this.toBuffer(options);
+            await fs.writeFile(filePath, buffer);
+        }
+        catch (error) {
+            if (error instanceof FileOperationError) {
+                throw error;
+            }
+            const err = error instanceof Error ? error : new Error(String(error));
+            throw new FileOperationError('save', err.message);
+        }
+    }
+    clear() {
+        this.zip = new JSZip();
+        this.files.clear();
+    }
+    getFileCount() {
+        return this.files.size;
+    }
+    clone() {
+        const newWriter = new ZipWriter();
+        newWriter.addFiles(this.files);
+        return newWriter;
+    }
+}
+//# sourceMappingURL=ZipWriter.js.map

package/dist/esm/zip/ZipWriter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ZipWriter.js","sourceRoot":"","sources":["../../../src/zip/ZipWriter.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,IAAI,CAAC;AAEpC,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,qBAAqB,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAK9E,MAAM,OAAO,SAAS;IACZ,GAAG,CAAQ;IACX,KAAK,GAAY,IAAI,GAAG,EAAE,CAAC;IAEnC;QACE,IAAI,CAAC,GAAG,GAAG,IAAI,KAAK,EAAE,CAAC;IACzB,CAAC;IAsBO,oBAAoB,CAAC,IAAY;QAEvC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CACb,yBAAyB,IAAI,2CAA2C;gBACtE,8DAA8D,CACjE,CAAC;QACJ,CAAC;QAGD,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YACpD,MAAM,IAAI,KAAK,CACb,yBAAyB,IAAI,yBAAyB;gBACpD,kDAAkD,CACrD,CAAC;QACJ,CAAC;QAGD,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CACb,yBAAyB,IAAI,wBAAwB;gBACnD,oDAAoD,CACvD,CAAC;QACJ,CAAC;QAGD,MAAM,eAAe,GAAG,GAAG,CAAC;QAC5B,IAAI,IAAI,CAAC,MAAM,GAAG,eAAe,EAAE,CAAC;YAClC,MAAM,IAAI,KAAK,CACb,yBAAyB,IAAI,+BAA+B,eAAe,cAAc,CAC1F,CAAC;QACJ,CAAC;IACH,CAAC;IAED,OAAO,CAAC,QAAgB,EAAE,OAAwB,EAAE,UAA0B,EAAE;QAC9E,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,WAAW,GAAG,CAAC,EAAE,IAAI,GAAG,IAAI,IAAI,EAAE,EAAE,GAAG,OAAO,CAAC;QAE1F,MAAM,cAAc,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC;QAG/C,IAAI,CAAC,oBAAoB,CAAC,cAAc,CAAC,CAAC;QAI1C,IAAI,gBAAgB,GAAG,OAAO,CAAC;QAC/B,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;YAEhC,gBAAgB,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAClD,CAAC;QAGD,MAAM,cAAc,GAAG,cAAc,KAAK,qBAAqB,CAAC;QAChE,MAAM,cAAc,GAAG,cAAc,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,WAAW,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC;QACxF,MAAM,gBAAgB,GAAG,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC;QAG1D,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,cAAc,EAAE,gBAAgB,EAAE;YAC9C,MAAM,EAAE,IAAI;YACZ,WAAW,EAAE,cAAc;YAC3B,kBAAkB,EAAE;gBAClB,KAAK,EAAE,gBAAgB;aACxB;YACD,IAAI;SACL,CAAC,CAAC;QAMH,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,cAAc,EAAE;YAC7B,IAAI,EAAE,cAAc;YACpB,OAAO,EAAE,gBAAgB;YACzB,QAAQ,EAAE,MAAM;YAChB,IAAI,EAAE,gBAAgB,CAAC,MAAM;YAC7B,IAAI;SACL,CAAC,CAAC;IACL,CAAC;IAOD,QAAQ,CAAC,KAAc,EAAE,UAA0B,EAAE;QACnD,KAAK,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,KAAK,EAAE,CAAC;YACjC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,EAAE;gBAC/B,GAAG,OAAO;gBACV,MAAM,EAAE,IAAI,CAAC,QAAQ;gBACrB,IAAI,EAAE,IAAI,CAAC,IAAI;aAChB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAOD,UAAU,CAAC,QAAgB;QACzB,MAAM,cAAc,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC;QAG/C,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QAC9C,IAAI,OAAO,EAAE,CAAC;YACZ,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC;YAChC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC;YAClC,OAAO,IAAI,CAAC;QACd,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;IAOD,OAAO,CAAC,QAAgB;QACtB,MAAM,cAAc,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC;QAC/C,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;IACxC,CAAC;IAOD,OAAO,CAAC,QAAgB;QACtB,MAAM,cAAc,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC;QAC/C,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;IACxC,CAAC;IAMD,WAAW;QACT,OAAO,IAAI,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC7B,CAAC;IAMD,YAAY;QACV,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;IACvC,CAAC;IAMD,QAAQ;QACN,MAAM,SAAS,GAAG,IAAI,CAAC,YAAY,EAAE,CAAC;QACtC,qBAAqB,CAAC,SAAS,CAAC,CAAC;IACnC,CAAC;IAiBO,kBAAkB;QACxB,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;QAE5C,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;YAEzB,IAAI,CAAC,KAAK,qBAAqB;gBAAE,OAAO,CAAC,CAAC,CAAC;YAC3C,IAAI,CAAC,KAAK,qBAAqB;gBAAE,OAAO,CAAC,CAAC;YAG1C,IAAI,CAAC,KAAK,aAAa;gBAAE,OAAO,CAAC,CAAC,CAAC;YACnC,IAAI,CAAC,KAAK,aAAa;gBAAE,OAAO,CAAC,CAAC;YAGlC,MAAM,WAAW,GAAG,CAAC,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;YAC9C,MAAM,WAAW,GAAG,CAAC,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;YAC9C,IAAI,WAAW,IAAI,CAAC,WAAW;gBAAE,OAAO,CAAC,CAAC,CAAC;YAC3C,IAAI,CAAC,WAAW,IAAI,WAAW;gBAAE,OAAO,CAAC,CAAC;YAG1C,IAAI,CAAC,KAAK,8BAA8B;gBAAE,OAAO,CAAC,CAAC,CAAC;YACpD,IAAI,CAAC,KAAK,8BAA8B;gBAAE,OAAO,CAAC,CAAC;YAGnD,IAAI,CAAC,KAAK,mBAAmB;gBAAE,OAAO,CAAC,CAAC,CAAC;YACzC,IAAI,CAAC,KAAK,mBAAmB;gBAAE,OAAO,CAAC,CAAC;YAGxC,MAAM,WAAW,GAAG,CAAC,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC;YAChD,MAAM,WAAW,GAAG,CAAC,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC;YAChD,MAAM,OAAO,GAAG,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC;YACtD,MAAM,OAAO,GAAG,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC;YAEtD,IAAI,OAAO,IAAI,CAAC,OAAO,IAAI,CAAC,WAAW;gBAAE,OAAO,CAAC,CAAC,CAAC;YACnD,IAAI,CAAC,OAAO,IAAI,OAAO,IAAI,CAAC,WAAW;gBAAE,OAAO,CAAC,CAAC;YAGlD,IAAI,WAAW,IAAI,CAAC,WAAW;gBAAE,OAAO,CAAC,CAAC,CAAC;YAC3C,IAAI,CAAC,WAAW,IAAI,WAAW;gBAAE,OAAO,CAAC,CAAC;YAG1C,OAAO,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;QAC5B,CAAC,CAAC,CAAC;IACL,CAAC;IAiBD,KAAK,CAAC,QAAQ,CAAC,UAAuB,EAAE;QACtC,MAAM,EAAE,WAAW,GAAG,CAAC,EAAE,QAAQ,GAAG,IAAI,EAAE,GAAG,OAAO,CAAC;QAGrD,IAAI,QAAQ,EAAE,CAAC;YACb,IAAI,CAAC,QAAQ,EAAE,CAAC;QAClB,CAAC;QAED,IAAI,CAAC;YAEH,MAAM,UAAU,GAAG,IAAI,KAAK,EAAE,CAAC;YAC/B,MAAM,WAAW,GAAG,IAAI,CAAC,kBAAkB,EAAE,CAAC;YAG9C,KAAK,MAAM,IAAI,IAAI,WAAW,EAAE,CAAC;gBAC/B,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;gBAClC,IAAI,CAAC,IAAI;oBAAE,SAAS;gBAGpB,MAAM,gBAAgB,GAAG,IAAI,CAAC,OAAiB,CAAC;gBAGhD,MAAM,cAAc,GAAG,IAAI,KAAK,qBAAqB,CAAC;gBACtD,MAAM,cAAc,GAAG,cAAc,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,WAAW,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC;gBACxF,MAAM,gBAAgB,GAAG,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC;gBAE1D,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,gBAAgB,EAAE;oBACtC,MAAM,EAAE,IAAI;oBACZ,WAAW,EAAE,cAAc;oBAC3B,kBAAkB,EAAE;wBAClB,KAAK,EAAE,gBAAgB;qBACxB;oBACD,IAAI,EAAE,IAAI,CAAC,IAAI;iBAChB,CAAC,CAAC;YACL,CAAC;YAGD,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,aAAa,CAAC;gBAC5C,IAAI,EAAE,YAAY;gBAClB,WAAW,EAAE,WAAW,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO;gBAClD,kBAAkB,EAAE;oBAClB,KAAK,EAAE,WAAW;iBACnB;gBACD,WAAW,EAAE,IAAI;aAClB,CAAC,CAAC;YAEH,OAAO,MAAM,CAAC;QAChB,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,MAAM,GAAG,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;YACtE,MAAM,IAAI,kBAAkB,CAAC,UAAU,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;QACxD,CAAC;IACH,CAAC;IAOD,KAAK,CAAC,UAAU,CAAC,QAAgB,EAAE,UAAuB,EAAE;QAC1D,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;YAC5C,MAAM,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QACvC,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,IAAI,KAAK,YAAY,kBAAkB,EAAE,CAAC;gBACxC,MAAM,KAAK,CAAC;YACd,CAAC;YACD,MAAM,GAAG,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;YACtE,MAAM,IAAI,kBAAkB,CAAC,MAAM,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;QACpD,CAAC;IACH,CAAC;IAKD,KAAK;QACH,IAAI,CAAC,GAAG,GAAG,IAAI,KAAK,EAAE,CAAC;QACvB,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;IAMD,YAAY;QACV,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;IACzB,CAAC;IAMD,KAAK;QACH,MAAM,SAAS,GAAG,IAAI,SAAS,EAAE,CAAC;QAClC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC/B,OAAO,SAAS,CAAC;IACnB,CAAC;CACF","sourcesContent":["/**\n * ZipWriter - Handles writing ZIP archives (DOCX files)\n *\n * DOCX Compliance Notes:\n * - [Content_Types].xml MUST be the first entry in the ZIP\n * - [Content_Types].xml MUST use STORE compression (uncompressed)\n * - File order matters for Microsoft Word compatibility\n */\n\nimport JSZip from 'jszip';\nimport { promises as fs } from 'fs';\nimport { ZipFile, FileMap, SaveOptions, AddFileOptions } from './types.js';\nimport { FileOperationError } from './errors.js';\nimport { validateDocxStructure, normalizePath } from '../utils/validation.js';\n\n/**\n * Handles writing operations on ZIP archives with DOCX-specific compliance\n */\nexport class ZipWriter {\n  private zip: JSZip;\n  private files: FileMap = new Map();\n\n  constructor() {\n    this.zip = new JSZip();\n  }\n\n  /**\n   * Adds a file to the archive\n   * @param filePath - Path where the file will be stored in the archive\n   * @param content - File content (string or Buffer)\n   * @param options - Options for adding the file\n   *\n   * **Encoding Note:**\n   * - String content is always encoded as UTF-8 per DOCX/OpenXML standard\n   * - Buffer content is stored as-is (should already be UTF-8 encoded for text)\n   * - XML files must use UTF-8 encoding as specified in their XML declaration\n   *\n   * **DOCX Compliance:**\n   * - [Content_Types].xml is automatically set to STORE compression\n   */\n  /**\n   * Validates a file path for security issues\n   * @param path - Normalized file path\n   * @throws {Error} If path contains path traversal or other security issues\n   * @private\n   */\n  private validatePathSecurity(path: string): void {\n    // Check for path traversal attacks\n    if (path.includes('..')) {\n      throw new Error(\n        `Security error: Path \"${path}\" contains path traversal sequence \"..\". ` +\n          `This could be an attempt to write files outside the archive.`\n      );\n    }\n\n    // Check for absolute paths (even after normalization)\n    if (path.startsWith('/') || /^[a-zA-Z]:/.test(path)) {\n      throw new Error(\n        `Security error: Path \"${path}\" is an absolute path. ` +\n          `Only relative paths are allowed in ZIP archives.`\n      );\n    }\n\n    // Check for null bytes (can be used to truncate paths)\n    if (path.includes('\\0')) {\n      throw new Error(\n        `Security error: Path \"${path}\" contains null byte. ` +\n          `This could be an attempt to exploit path handling.`\n      );\n    }\n\n    // Check for excessively long paths (potential DoS)\n    const MAX_PATH_LENGTH = 260; // Windows MAX_PATH\n    if (path.length > MAX_PATH_LENGTH) {\n      throw new Error(\n        `Security error: Path \"${path}\" exceeds maximum length of ${MAX_PATH_LENGTH} characters.`\n      );\n    }\n  }\n\n  addFile(filePath: string, content: string | Buffer, options: AddFileOptions = {}): void {\n    const { binary = Buffer.isBuffer(content), compression = 6, date = new Date() } = options;\n\n    const normalizedPath = normalizePath(filePath);\n\n    // Security: Validate path for traversal and other attacks\n    this.validatePathSecurity(normalizedPath);\n\n    // Convert string content to UTF-8 Buffer if not already binary\n    // This ensures consistent UTF-8 encoding regardless of system locale\n    let processedContent = content;\n    if (typeof content === 'string') {\n      // Explicitly encode string as UTF-8 Buffer\n      processedContent = Buffer.from(content, 'utf8');\n    }\n\n    // DOCX REQUIREMENT: [Content_Types].xml MUST be uncompressed (STORE)\n    const isContentTypes = normalizedPath === '[Content_Types].xml';\n    const useCompression = isContentTypes ? 'STORE' : compression > 0 ? 'DEFLATE' : 'STORE';\n    const compressionLevel = isContentTypes ? 0 : compression;\n\n    // For text content (XML), this ensures UTF-8 encoding is preserved\n    this.zip.file(normalizedPath, processedContent, {\n      binary: true, // Always treat as binary since we're using Buffers\n      compression: useCompression,\n      compressionOptions: {\n        level: compressionLevel,\n      },\n      date,\n    });\n\n    // Store in our file map\n    // IMPORTANT: Store the PROCESSED content (Buffer), not the original\n    // This ensures consistency with what was added to this.zip and prevents\n    // double UTF-8 conversion in toBuffer() method (Issue #1)\n    this.files.set(normalizedPath, {\n      path: normalizedPath,\n      content: processedContent, // Store Buffer, not original string\n      isBinary: binary,\n      size: processedContent.length, // Buffer.length is always correct (Issue #3)\n      date,\n    });\n  }\n\n  /**\n   * Adds multiple files to the archive\n   * @param files - Map of file paths to contents\n   * @param options - Options for adding files\n   */\n  addFiles(files: FileMap, options: AddFileOptions = {}): void {\n    for (const [path, file] of files) {\n      this.addFile(path, file.content, {\n        ...options,\n        binary: file.isBinary,\n        date: file.date,\n      });\n    }\n  }\n\n  /**\n   * Removes a file from the archive\n   * @param filePath - Path to the file to remove\n   * @returns True if the file was removed, false if it didn't exist\n   */\n  removeFile(filePath: string): boolean {\n    const normalizedPath = normalizePath(filePath);\n\n    // Remove from JSZip\n    const zipFile = this.zip.file(normalizedPath);\n    if (zipFile) {\n      this.zip.remove(normalizedPath);\n      this.files.delete(normalizedPath);\n      return true;\n    }\n\n    return false;\n  }\n\n  /**\n   * Checks if a file exists in the archive\n   * @param filePath - Path to check\n   * @returns True if the file exists\n   */\n  hasFile(filePath: string): boolean {\n    const normalizedPath = normalizePath(filePath);\n    return this.files.has(normalizedPath);\n  }\n\n  /**\n   * Gets a file from the archive\n   * @param filePath - Path to the file\n   * @returns The file data, or undefined if not found\n   */\n  getFile(filePath: string): ZipFile | undefined {\n    const normalizedPath = normalizePath(filePath);\n    return this.files.get(normalizedPath);\n  }\n\n  /**\n   * Gets all files in the archive\n   * @returns Map of file paths to file data\n   */\n  getAllFiles(): FileMap {\n    return new Map(this.files);\n  }\n\n  /**\n   * Gets a list of all file paths in the archive\n   * @returns Array of file paths\n   */\n  getFilePaths(): string[] {\n    return Array.from(this.files.keys());\n  }\n\n  /**\n   * Validates the DOCX structure before saving\n   * @throws {MissingRequiredFileError} If required files are missing\n   */\n  validate(): void {\n    const filePaths = this.getFilePaths();\n    validateDocxStructure(filePaths);\n  }\n\n  /**\n   * Sorts files according to DOCX best practices\n   * Microsoft Word expects files in a specific order for optimal compatibility\n   *\n   * @returns Sorted array of file paths\n   *\n   * **DOCX File Order (CRITICAL):**\n   * 1. [Content_Types].xml - MUST be first\n   * 2. _rels/.rels - Root relationships\n   * 3. docProps/* - Document properties\n   * 4. word/_rels/document.xml.rels - Document relationships\n   * 5. word/document.xml - Main document\n   * 6. word/* - Other word files (styles, numbering, etc.)\n   * 7. Everything else - Media, custom XML, etc.\n   */\n  private getSortedFilePaths(): string[] {\n    const paths = Array.from(this.files.keys());\n\n    return paths.sort((a, b) => {\n      // Priority 1: [Content_Types].xml MUST be first (CRITICAL for MS Word)\n      if (a === '[Content_Types].xml') return -1;\n      if (b === '[Content_Types].xml') return 1;\n\n      // Priority 2: Root relationships\n      if (a === '_rels/.rels') return -1;\n      if (b === '_rels/.rels') return 1;\n\n      // Priority 3: Document properties\n      const aIsDocProps = a.startsWith('docProps/');\n      const bIsDocProps = b.startsWith('docProps/');\n      if (aIsDocProps && !bIsDocProps) return -1;\n      if (!aIsDocProps && bIsDocProps) return 1;\n\n      // Priority 4: word/_rels/document.xml.rels\n      if (a === 'word/_rels/document.xml.rels') return -1;\n      if (b === 'word/_rels/document.xml.rels') return 1;\n\n      // Priority 5: word/document.xml\n      if (a === 'word/document.xml') return -1;\n      if (b === 'word/document.xml') return 1;\n\n      // Priority 6: Other word/ folder files (before relationships)\n      const aIsWordRels = a.startsWith('word/_rels/');\n      const bIsWordRels = b.startsWith('word/_rels/');\n      const aIsWord = a.startsWith('word/') && !aIsWordRels;\n      const bIsWord = b.startsWith('word/') && !bIsWordRels;\n\n      if (aIsWord && !bIsWord && !bIsWordRels) return -1;\n      if (!aIsWord && bIsWord && !aIsWordRels) return 1;\n\n      // Priority 7: word/_rels/ files\n      if (aIsWordRels && !bIsWordRels) return -1;\n      if (!aIsWordRels && bIsWordRels) return 1;\n\n      // Alphabetical for same priority\n      return a.localeCompare(b);\n    });\n  }\n\n  /**\n   * Generates the ZIP archive as a buffer\n   * @param options - Save options\n   * @returns Buffer containing the ZIP archive\n   *\n   * **Encoding Note:**\n   * The generated buffer contains UTF-8 encoded XML and text files.\n   * All string content within files has been explicitly UTF-8 encoded\n   * before being added to the archive to ensure consistency.\n   *\n   * **DOCX Compliance:**\n   * - Files are ordered with [Content_Types].xml first (REQUIRED)\n   * - [Content_Types].xml uses STORE compression (uncompressed)\n   * - All other files use DEFLATE compression by default\n   */\n  async toBuffer(options: SaveOptions = {}): Promise<Buffer> {\n    const { compression = 6, validate = true } = options;\n\n    // Validate structure if requested\n    if (validate) {\n      this.validate();\n    }\n\n    try {\n      // Create a new JSZip instance with proper file ordering\n      const orderedZip = new JSZip();\n      const sortedPaths = this.getSortedFilePaths();\n\n      // Add files in the correct order\n      for (const path of sortedPaths) {\n        const file = this.files.get(path);\n        if (!file) continue;\n\n        // Content is already a Buffer from addFile() - no re-conversion needed (Issue #2)\n        const processedContent = file.content as Buffer;\n\n        // DOCX REQUIREMENT: [Content_Types].xml MUST be uncompressed\n        const isContentTypes = path === '[Content_Types].xml';\n        const useCompression = isContentTypes ? 'STORE' : compression > 0 ? 'DEFLATE' : 'STORE';\n        const compressionLevel = isContentTypes ? 0 : compression;\n\n        orderedZip.file(path, processedContent, {\n          binary: true,\n          compression: useCompression,\n          compressionOptions: {\n            level: compressionLevel,\n          },\n          date: file.date,\n        });\n      }\n\n      // Generate ZIP with the ordered files\n      const buffer = await orderedZip.generateAsync({\n        type: 'nodebuffer',\n        compression: compression > 0 ? 'DEFLATE' : 'STORE',\n        compressionOptions: {\n          level: compression,\n        },\n        streamFiles: true,\n      });\n\n      return buffer;\n    } catch (error: unknown) {\n      const err = error instanceof Error ? error : new Error(String(error));\n      throw new FileOperationError('generate', err.message);\n    }\n  }\n\n  /**\n   * Saves the archive to a file\n   * @param filePath - Path where the file will be saved\n   * @param options - Save options\n   */\n  async saveToFile(filePath: string, options: SaveOptions = {}): Promise<void> {\n    try {\n      const buffer = await this.toBuffer(options);\n      await fs.writeFile(filePath, buffer);\n    } catch (error: unknown) {\n      if (error instanceof FileOperationError) {\n        throw error;\n      }\n      const err = error instanceof Error ? error : new Error(String(error));\n      throw new FileOperationError('save', err.message);\n    }\n  }\n\n  /**\n   * Creates a new empty archive\n   */\n  clear(): void {\n    this.zip = new JSZip();\n    this.files.clear();\n  }\n\n  /**\n   * Gets the number of files in the archive\n   * @returns Number of files\n   */\n  getFileCount(): number {\n    return this.files.size;\n  }\n\n  /**\n   * Creates a clone of this writer with all its files\n   * @returns A new ZipWriter instance with the same files\n   */\n  clone(): ZipWriter {\n    const newWriter = new ZipWriter();\n    newWriter.addFiles(this.files);\n    return newWriter;\n  }\n}\n"]}

package/dist/esm/zip/errors.js

@@ -0,0 +1,43 @@
+export class DocxError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'DocxError';
+        Object.setPrototypeOf(this, DocxError.prototype);
+    }
+}
+export class DocxNotFoundError extends DocxError {
+    constructor(filePath) {
+        super(`DOCX file not found: ${filePath}`);
+        this.name = 'DocxNotFoundError';
+        Object.setPrototypeOf(this, DocxNotFoundError.prototype);
+    }
+}
+export class InvalidDocxError extends DocxError {
+    constructor(message) {
+        super(`Invalid DOCX file: ${message}`);
+        this.name = 'InvalidDocxError';
+        Object.setPrototypeOf(this, InvalidDocxError.prototype);
+    }
+}
+export class CorruptedArchiveError extends DocxError {
+    constructor(message) {
+        super(`Corrupted archive: ${message}`);
+        this.name = 'CorruptedArchiveError';
+        Object.setPrototypeOf(this, CorruptedArchiveError.prototype);
+    }
+}
+export class MissingRequiredFileError extends DocxError {
+    constructor(fileName) {
+        super(`Missing required file: ${fileName}`);
+        this.name = 'MissingRequiredFileError';
+        Object.setPrototypeOf(this, MissingRequiredFileError.prototype);
+    }
+}
+export class FileOperationError extends DocxError {
+    constructor(operation, message) {
+        super(`File operation '${operation}' failed: ${message}`);
+        this.name = 'FileOperationError';
+        Object.setPrototypeOf(this, FileOperationError.prototype);
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/esm/zip/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/zip/errors.ts"],"names":[],"mappings":"AAOA,MAAM,OAAO,SAAU,SAAQ,KAAK;IAClC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC;QACxB,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IACnD,CAAC;CACF;AAKD,MAAM,OAAO,iBAAkB,SAAQ,SAAS;IAC9C,YAAY,QAAgB;QAC1B,KAAK,CAAC,wBAAwB,QAAQ,EAAE,CAAC,CAAC;QAC1C,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;QAChC,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,iBAAiB,CAAC,SAAS,CAAC,CAAC;IAC3D,CAAC;CACF;AAKD,MAAM,OAAO,gBAAiB,SAAQ,SAAS;IAC7C,YAAY,OAAe;QACzB,KAAK,CAAC,sBAAsB,OAAO,EAAE,CAAC,CAAC;QACvC,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;QAC/B,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,gBAAgB,CAAC,SAAS,CAAC,CAAC;IAC1D,CAAC;CACF;AAKD,MAAM,OAAO,qBAAsB,SAAQ,SAAS;IAClD,YAAY,OAAe;QACzB,KAAK,CAAC,sBAAsB,OAAO,EAAE,CAAC,CAAC;QACvC,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;QACpC,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,qBAAqB,CAAC,SAAS,CAAC,CAAC;IAC/D,CAAC;CACF;AAKD,MAAM,OAAO,wBAAyB,SAAQ,SAAS;IACrD,YAAY,QAAgB;QAC1B,KAAK,CAAC,0BAA0B,QAAQ,EAAE,CAAC,CAAC;QAC5C,IAAI,CAAC,IAAI,GAAG,0BAA0B,CAAC;QACvC,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,wBAAwB,CAAC,SAAS,CAAC,CAAC;IAClE,CAAC;CACF;AAKD,MAAM,OAAO,kBAAmB,SAAQ,SAAS;IAC/C,YAAY,SAAiB,EAAE,OAAe;QAC5C,KAAK,CAAC,mBAAmB,SAAS,aAAa,OAAO,EAAE,CAAC,CAAC;QAC1D,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;QACjC,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,kBAAkB,CAAC,SAAS,CAAC,CAAC;IAC5D,CAAC;CACF","sourcesContent":["/**\r\n * Custom error classes for ZIP and DOCX operations\r\n */\r\n\r\n/**\r\n * Base error class for all DOCX-related errors\r\n */\r\nexport class DocxError extends Error {\r\n  constructor(message: string) {\r\n    super(message);\r\n    this.name = 'DocxError';\r\n    Object.setPrototypeOf(this, DocxError.prototype);\r\n  }\r\n}\r\n\r\n/**\r\n * Error thrown when a DOCX file is not found\r\n */\r\nexport class DocxNotFoundError extends DocxError {\r\n  constructor(filePath: string) {\r\n    super(`DOCX file not found: ${filePath}`);\r\n    this.name = 'DocxNotFoundError';\r\n    Object.setPrototypeOf(this, DocxNotFoundError.prototype);\r\n  }\r\n}\r\n\r\n/**\r\n * Error thrown when a file is not a valid DOCX/ZIP archive\r\n */\r\nexport class InvalidDocxError extends DocxError {\r\n  constructor(message: string) {\r\n    super(`Invalid DOCX file: ${message}`);\r\n    this.name = 'InvalidDocxError';\r\n    Object.setPrototypeOf(this, InvalidDocxError.prototype);\r\n  }\r\n}\r\n\r\n/**\r\n * Error thrown when a ZIP archive is corrupted\r\n */\r\nexport class CorruptedArchiveError extends DocxError {\r\n  constructor(message: string) {\r\n    super(`Corrupted archive: ${message}`);\r\n    this.name = 'CorruptedArchiveError';\r\n    Object.setPrototypeOf(this, CorruptedArchiveError.prototype);\r\n  }\r\n}\r\n\r\n/**\r\n * Error thrown when a required DOCX file is missing\r\n */\r\nexport class MissingRequiredFileError extends DocxError {\r\n  constructor(fileName: string) {\r\n    super(`Missing required file: ${fileName}`);\r\n    this.name = 'MissingRequiredFileError';\r\n    Object.setPrototypeOf(this, MissingRequiredFileError.prototype);\r\n  }\r\n}\r\n\r\n/**\r\n * Error thrown when a file operation fails\r\n */\r\nexport class FileOperationError extends DocxError {\r\n  constructor(operation: string, message: string) {\r\n    super(`File operation '${operation}' failed: ${message}`);\r\n    this.name = 'FileOperationError';\r\n    Object.setPrototypeOf(this, FileOperationError.prototype);\r\n  }\r\n}\r\n"]}

package/dist/esm/zip/types.js

@@ -0,0 +1,31 @@
+export const DEFAULT_SIZE_LIMITS = {
+    warningSizeMB: 50,
+    maxSizeMB: 150,
+};
+export const REQUIRED_DOCX_FILES = [
+    '[Content_Types].xml',
+    '_rels/.rels',
+    'word/document.xml',
+];
+export const DOCX_PATHS = {
+    CONTENT_TYPES: '[Content_Types].xml',
+    RELS: '_rels/.rels',
+    DOCUMENT: 'word/document.xml',
+    DOCUMENT_RELS: 'word/_rels/document.xml.rels',
+    STYLES: 'word/styles.xml',
+    NUMBERING: 'word/numbering.xml',
+    NUMBERING_RELS: 'word/_rels/numbering.xml.rels',
+    SETTINGS: 'word/settings.xml',
+    FONT_TABLE: 'word/fontTable.xml',
+    THEME: 'word/theme/theme1.xml',
+    CORE_PROPS: 'docProps/core.xml',
+    APP_PROPS: 'docProps/app.xml',
+    MEDIA_DIR: 'word/media/',
+    FOOTNOTES: 'word/footnotes.xml',
+    ENDNOTES: 'word/endnotes.xml',
+    COMMENTS_EXTENDED: 'word/commentsExtended.xml',
+    COMMENTS_IDS: 'word/commentsIds.xml',
+    COMMENTS_EXTENSIBLE: 'word/commentsExtensible.xml',
+    WEB_SETTINGS: 'word/webSettings.xml',
+};
+//# sourceMappingURL=types.js.map

package/dist/esm/zip/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/zip/types.ts"],"names":[],"mappings":"AAuCA,MAAM,CAAC,MAAM,mBAAmB,GAA+B;IAC7D,aAAa,EAAE,EAAE;IACjB,SAAS,EAAE,GAAG;CACf,CAAC;AA4CF,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,qBAAqB;IACrB,aAAa;IACb,mBAAmB;CACX,CAAC;AAKX,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,aAAa,EAAE,qBAAqB;IACpC,IAAI,EAAE,aAAa;IACnB,QAAQ,EAAE,mBAAmB;IAC7B,aAAa,EAAE,8BAA8B;IAC7C,MAAM,EAAE,iBAAiB;IACzB,SAAS,EAAE,oBAAoB;IAC/B,cAAc,EAAE,+BAA+B;IAC/C,QAAQ,EAAE,mBAAmB;IAC7B,UAAU,EAAE,oBAAoB;IAChC,KAAK,EAAE,uBAAuB;IAC9B,UAAU,EAAE,mBAAmB;IAC/B,SAAS,EAAE,kBAAkB;IAC7B,SAAS,EAAE,aAAa;IACxB,SAAS,EAAE,oBAAoB;IAC/B,QAAQ,EAAE,mBAAmB;IAC7B,iBAAiB,EAAE,2BAA2B;IAC9C,YAAY,EAAE,sBAAsB;IACpC,mBAAmB,EAAE,6BAA6B;IAClD,YAAY,EAAE,sBAAsB;CAC5B,CAAC","sourcesContent":["/**\n * Types and interfaces for ZIP archive handling\n */\n\n/**\n * Represents a file within a ZIP archive\n */\nexport interface ZipFile {\n  /** The path of the file within the archive */\n  path: string;\n  /** The content of the file (string for text, Buffer for binary) */\n  content: string | Buffer;\n  /** Whether the content is binary */\n  isBinary: boolean;\n  /** File size in bytes */\n  size: number;\n  /** Last modified date */\n  date?: Date;\n}\n\n/**\n * Size limit configuration for document loading\n */\nexport interface SizeLimitOptions {\n  /**\n   * Size in MB at which to show a warning (default: 50 MB)\n   * Set to 0 to disable warnings\n   */\n  warningSizeMB?: number;\n  /**\n   * Maximum size in MB to load (default: 150 MB)\n   * Set to 0 to disable the limit (not recommended)\n   */\n  maxSizeMB?: number;\n}\n\n/**\n * Default size limits for document loading\n */\nexport const DEFAULT_SIZE_LIMITS: Required<SizeLimitOptions> = {\n  warningSizeMB: 50,\n  maxSizeMB: 150,\n};\n\n/**\n * Options for loading a DOCX file\n */\nexport interface LoadOptions {\n  /** Whether to validate the DOCX structure on load */\n  validate?: boolean;\n  /** Whether to load files lazily */\n  lazy?: boolean;\n  /** Size limit configuration (warning and max size thresholds) */\n  sizeLimits?: SizeLimitOptions;\n}\n\n/**\n * Options for saving a DOCX file\n */\nexport interface SaveOptions {\n  /** Compression level (0-9, where 0 is no compression and 9 is maximum) */\n  compression?: number;\n  /** Whether to validate the DOCX structure before save */\n  validate?: boolean;\n}\n\n/**\n * Options for adding files to the archive\n */\nexport interface AddFileOptions {\n  /** Whether the content is binary */\n  binary?: boolean;\n  /** Compression level for this specific file */\n  compression?: number;\n  /** Last modified date */\n  date?: Date;\n}\n\n/**\n * Map of file paths to their contents\n */\nexport type FileMap = Map<string, ZipFile>;\n\n/**\n * Required files for a valid DOCX structure\n */\nexport const REQUIRED_DOCX_FILES = [\n  '[Content_Types].xml',\n  '_rels/.rels',\n  'word/document.xml',\n] as const;\n\n/**\n * Common DOCX file paths\n */\nexport const DOCX_PATHS = {\n  CONTENT_TYPES: '[Content_Types].xml',\n  RELS: '_rels/.rels',\n  DOCUMENT: 'word/document.xml',\n  DOCUMENT_RELS: 'word/_rels/document.xml.rels',\n  STYLES: 'word/styles.xml',\n  NUMBERING: 'word/numbering.xml',\n  NUMBERING_RELS: 'word/_rels/numbering.xml.rels',\n  SETTINGS: 'word/settings.xml',\n  FONT_TABLE: 'word/fontTable.xml',\n  THEME: 'word/theme/theme1.xml',\n  CORE_PROPS: 'docProps/core.xml',\n  APP_PROPS: 'docProps/app.xml',\n  MEDIA_DIR: 'word/media/',\n  FOOTNOTES: 'word/footnotes.xml',\n  ENDNOTES: 'word/endnotes.xml',\n  COMMENTS_EXTENDED: 'word/commentsExtended.xml',\n  COMMENTS_IDS: 'word/commentsIds.xml',\n  COMMENTS_EXTENSIBLE: 'word/commentsExtensible.xml',\n  WEB_SETTINGS: 'word/webSettings.xml',\n} as const;\n"]}

package/dist/formatting/AbstractNumbering.d.ts

@@ -1,5 +1,5 @@
-import { XMLElement } from '../xml/XMLBuilder';
-import { NumberingLevel } from './NumberingLevel';
+import { XMLElement } from '../xml/XMLBuilder.js';
+import { NumberingLevel } from './NumberingLevel.js';
 export interface AbstractNumberingProperties {
     abstractNumId: number;
     name?: string;

package/dist/formatting/AbstractNumbering.d.ts.map

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

package/dist/formatting/AbstractNumbering.js

@@ -1,9 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.AbstractNumbering = void 0;
-const XMLBuilder_1 = require("../xml/XMLBuilder");
-const NumberingLevel_1 = require("./NumberingLevel");
-const logger_1 = require("../utils/logger");
+const XMLBuilder_js_1 = require("../xml/XMLBuilder.js");
+const NumberingLevel_js_1 = require("./NumberingLevel.js");
+const logger_js_1 = require("../utils/logger.js");
 class AbstractNumbering {
     abstractNumId;
     name;
@@ -150,7 +150,7 @@ class AbstractNumbering {
     toXML() {
         const children = [];
         if (this.nsid) {
-            children.push(XMLBuilder_1.XMLBuilder.wSelf('nsid', { 'w:val': this.nsid }));
+            children.push(XMLBuilder_js_1.XMLBuilder.wSelf('nsid', { 'w:val': this.nsid }));
         }
         let multiLevelTypeValue;
         if (this.multiLevelType === 1) {
@@ -162,29 +162,29 @@ class AbstractNumbering {
         else {
             multiLevelTypeValue = 'singleLevel';
         }
-        children.push(XMLBuilder_1.XMLBuilder.wSelf('multiLevelType', {
+        children.push(XMLBuilder_js_1.XMLBuilder.wSelf('multiLevelType', {
             'w:val': multiLevelTypeValue,
         }));
         if (this.tmpl) {
-            children.push(XMLBuilder_1.XMLBuilder.wSelf('tmpl', { 'w:val': this.tmpl }));
+            children.push(XMLBuilder_js_1.XMLBuilder.wSelf('tmpl', { 'w:val': this.tmpl }));
         }
         if (this.name) {
-            children.push(XMLBuilder_1.XMLBuilder.wSelf('name', { 'w:val': this.name }));
+            children.push(XMLBuilder_js_1.XMLBuilder.wSelf('name', { 'w:val': this.name }));
         }
         if (this.styleLink) {
-            children.push(XMLBuilder_1.XMLBuilder.wSelf('styleLink', { 'w:val': this.styleLink }));
+            children.push(XMLBuilder_js_1.XMLBuilder.wSelf('styleLink', { 'w:val': this.styleLink }));
         }
         if (this.numStyleLink) {
-            children.push(XMLBuilder_1.XMLBuilder.wSelf('numStyleLink', { 'w:val': this.numStyleLink }));
+            children.push(XMLBuilder_js_1.XMLBuilder.wSelf('numStyleLink', { 'w:val': this.numStyleLink }));
         }
         const sortedLevels = this.getAllLevels();
         sortedLevels.forEach((level) => {
             children.push(level.toXML());
         });
         if (sortedLevels.length === 0) {
-            children.push(NumberingLevel_1.NumberingLevel.createDecimalLevel(0).toXML());
+            children.push(NumberingLevel_js_1.NumberingLevel.createDecimalLevel(0).toXML());
         }
-        return XMLBuilder_1.XMLBuilder.w('abstractNum', { 'w:abstractNumId': this.abstractNumId.toString() }, children);
+        return XMLBuilder_js_1.XMLBuilder.w('abstractNum', { 'w:abstractNumId': this.abstractNumId.toString() }, children);
     }
     static createBulletList(abstractNumId, levels = 9, bullets) {
         const abstractNum = new AbstractNumbering({
@@ -195,10 +195,10 @@ class AbstractNumbering {
         for (let i = 0; i < levels && i < 9; i++) {
             if (bullets && bullets.length > 0) {
                 const bullet = bullets[i % bullets.length] || '•';
-                abstractNum.addLevel(NumberingLevel_1.NumberingLevel.createBulletLevel(i, bullet));
+                abstractNum.addLevel(NumberingLevel_js_1.NumberingLevel.createBulletLevel(i, bullet));
             }
             else {
-                abstractNum.addLevel(NumberingLevel_1.NumberingLevel.createBulletLevel(i));
+                abstractNum.addLevel(NumberingLevel_js_1.NumberingLevel.createBulletLevel(i));
             }
         }
         return abstractNum;
@@ -221,20 +221,20 @@ class AbstractNumbering {
             let level;
             switch (format) {
                 case 'lowerLetter':
-                    level = NumberingLevel_1.NumberingLevel.createLowerLetterLevel(i, template);
+                    level = NumberingLevel_js_1.NumberingLevel.createLowerLetterLevel(i, template);
                     break;
                 case 'lowerRoman':
-                    level = NumberingLevel_1.NumberingLevel.createLowerRomanLevel(i, template);
+                    level = NumberingLevel_js_1.NumberingLevel.createLowerRomanLevel(i, template);
                     break;
                 case 'upperLetter':
-                    level = NumberingLevel_1.NumberingLevel.createUpperLetterLevel(i, template);
+                    level = NumberingLevel_js_1.NumberingLevel.createUpperLetterLevel(i, template);
                     break;
                 case 'upperRoman':
-                    level = NumberingLevel_1.NumberingLevel.createUpperRomanLevel(i, template);
+                    level = NumberingLevel_js_1.NumberingLevel.createUpperRomanLevel(i, template);
                     break;
                 case 'decimal':
                 default:
-                    level = NumberingLevel_1.NumberingLevel.createDecimalLevel(i, template);
+                    level = NumberingLevel_js_1.NumberingLevel.createDecimalLevel(i, template);
                     break;
             }
             abstractNum.addLevel(level);
@@ -247,10 +247,10 @@ class AbstractNumbering {
             name: 'Multi-Level List',
             multiLevelType: 1,
         });
-        abstractNum.addLevel(NumberingLevel_1.NumberingLevel.createDecimalLevel(0, '%1.'));
-        abstractNum.addLevel(NumberingLevel_1.NumberingLevel.createLowerLetterLevel(1, '%2.'));
-        abstractNum.addLevel(NumberingLevel_1.NumberingLevel.createLowerRomanLevel(2, '%3.'));
-        abstractNum.addLevel(NumberingLevel_1.NumberingLevel.createDecimalLevel(3, '%4.'));
+        abstractNum.addLevel(NumberingLevel_js_1.NumberingLevel.createDecimalLevel(0, '%1.'));
+        abstractNum.addLevel(NumberingLevel_js_1.NumberingLevel.createLowerLetterLevel(1, '%2.'));
+        abstractNum.addLevel(NumberingLevel_js_1.NumberingLevel.createLowerRomanLevel(2, '%3.'));
+        abstractNum.addLevel(NumberingLevel_js_1.NumberingLevel.createDecimalLevel(3, '%4.'));
         return abstractNum;
     }
     static createOutlineList(abstractNumId) {
@@ -259,15 +259,15 @@ class AbstractNumbering {
             name: 'Outline List',
             multiLevelType: 1,
         });
-        abstractNum.addLevel(NumberingLevel_1.NumberingLevel.createUpperRomanLevel(0, '%1.'));
-        abstractNum.addLevel(NumberingLevel_1.NumberingLevel.createUpperLetterLevel(1, '%2.'));
-        abstractNum.addLevel(NumberingLevel_1.NumberingLevel.createDecimalLevel(2, '%3.'));
-        abstractNum.addLevel(NumberingLevel_1.NumberingLevel.createLowerLetterLevel(3, '%4.'));
-        abstractNum.addLevel(NumberingLevel_1.NumberingLevel.createLowerRomanLevel(4, '%5.'));
-        abstractNum.addLevel(NumberingLevel_1.NumberingLevel.createUpperLetterLevel(5, '%6.'));
-        abstractNum.addLevel(NumberingLevel_1.NumberingLevel.createDecimalLevel(6, '%7.'));
-        abstractNum.addLevel(NumberingLevel_1.NumberingLevel.createLowerLetterLevel(7, '%8.'));
-        abstractNum.addLevel(NumberingLevel_1.NumberingLevel.createLowerRomanLevel(8, '%9.'));
+        abstractNum.addLevel(NumberingLevel_js_1.NumberingLevel.createUpperRomanLevel(0, '%1.'));
+        abstractNum.addLevel(NumberingLevel_js_1.NumberingLevel.createUpperLetterLevel(1, '%2.'));
+        abstractNum.addLevel(NumberingLevel_js_1.NumberingLevel.createDecimalLevel(2, '%3.'));
+        abstractNum.addLevel(NumberingLevel_js_1.NumberingLevel.createLowerLetterLevel(3, '%4.'));
+        abstractNum.addLevel(NumberingLevel_js_1.NumberingLevel.createLowerRomanLevel(4, '%5.'));
+        abstractNum.addLevel(NumberingLevel_js_1.NumberingLevel.createUpperLetterLevel(5, '%6.'));
+        abstractNum.addLevel(NumberingLevel_js_1.NumberingLevel.createDecimalLevel(6, '%7.'));
+        abstractNum.addLevel(NumberingLevel_js_1.NumberingLevel.createLowerLetterLevel(7, '%8.'));
+        abstractNum.addLevel(NumberingLevel_js_1.NumberingLevel.createLowerRomanLevel(8, '%9.'));
         return abstractNum;
     }
     static create(properties) {
@@ -314,11 +314,11 @@ class AbstractNumbering {
         if (lvlMatches) {
             for (const lvlXml of lvlMatches) {
                 try {
-                    const level = NumberingLevel_1.NumberingLevel.fromXML(lvlXml);
+                    const level = NumberingLevel_js_1.NumberingLevel.fromXML(lvlXml);
                     abstractNum.addLevel(level);
                 }
                 catch (error) {
-                    logger_1.defaultLogger.warn(`Failed to parse level: ${error}`);
+                    logger_js_1.defaultLogger.warn(`Failed to parse level: ${error}`);
                 }
             }
         }