@cj-tech-master/excelts 9.5.0 → 9.5.1

package/dist/cjs/modules/word/docx-packager.js

@@ -205,42 +205,42 @@ function collectHyperlinksFromHeaderFooter(content) {
 async function packageDocx(doc, compressionLevel) {
     const archive = (0, create_archive_1.zip)({ level: compressionLevel ?? 6 });
     // Managers
-    const contentTypes = new content_types_1.ContentTypesManager();
-    const packageRels = new relationships_1.RelationshipManager();
-    const documentRels = new relationships_1.RelationshipManager();
+    const contentTypes = (0, content_types_1.createContentTypes)();
+    const packageRels = (0, relationships_1.createRelationships)();
+    const documentRels = (0, relationships_1.createRelationships)();
     // --- Package relationships ---
-    packageRels.add(constants_1.RelType.OfficeDocument, "word/document.xml");
-    packageRels.add(constants_1.RelType.CoreProperties, "docProps/core.xml");
-    packageRels.add(constants_1.RelType.ExtendedProperties, "docProps/app.xml");
+    (0, relationships_1.addRelationship)(packageRels, constants_1.RelType.OfficeDocument, "word/document.xml");
+    (0, relationships_1.addRelationship)(packageRels, constants_1.RelType.CoreProperties, "docProps/core.xml");
+    (0, relationships_1.addRelationship)(packageRels, constants_1.RelType.ExtendedProperties, "docProps/app.xml");
     // Custom properties
     const hasCustomProps = doc.customProperties && doc.customProperties.length > 0;
     if (hasCustomProps) {
-        packageRels.add(constants_1.RelType.CustomProperties, "docProps/custom.xml");
+        (0, relationships_1.addRelationship)(packageRels, constants_1.RelType.CustomProperties, "docProps/custom.xml");
     }
     // --- Document relationships ---
-    documentRels.add(constants_1.RelType.Styles, "styles.xml");
-    documentRels.add(constants_1.RelType.Settings, "settings.xml");
-    documentRels.add(constants_1.RelType.FontTable, "fontTable.xml");
-    documentRels.add(constants_1.RelType.Theme, "theme/theme1.xml");
+    (0, relationships_1.addRelationship)(documentRels, constants_1.RelType.Styles, "styles.xml");
+    (0, relationships_1.addRelationship)(documentRels, constants_1.RelType.Settings, "settings.xml");
+    (0, relationships_1.addRelationship)(documentRels, constants_1.RelType.FontTable, "fontTable.xml");
+    (0, relationships_1.addRelationship)(documentRels, constants_1.RelType.Theme, "theme/theme1.xml");
     // Numbering
     const hasNumbering = (doc.abstractNumberings && doc.abstractNumberings.length > 0) ||
         (doc.numberingInstances && doc.numberingInstances.length > 0);
     if (hasNumbering) {
-        documentRels.add(constants_1.RelType.Numbering, "numbering.xml");
+        (0, relationships_1.addRelationship)(documentRels, constants_1.RelType.Numbering, "numbering.xml");
     }
     // Footnotes & Endnotes
     const hasFootnotes = doc.footnotes && doc.footnotes.length > 0;
     const hasEndnotes = doc.endnotes && doc.endnotes.length > 0;
     if (hasFootnotes) {
-        documentRels.add(constants_1.RelType.Footnotes, "footnotes.xml");
+        (0, relationships_1.addRelationship)(documentRels, constants_1.RelType.Footnotes, "footnotes.xml");
     }
     if (hasEndnotes) {
-        documentRels.add(constants_1.RelType.Endnotes, "endnotes.xml");
+        (0, relationships_1.addRelationship)(documentRels, constants_1.RelType.Endnotes, "endnotes.xml");
     }
     // Comments
     const hasComments = doc.comments && doc.comments.length > 0;
     if (hasComments) {
-        documentRels.add(constants_1.RelType.Comments, "comments.xml");
+        (0, relationships_1.addRelationship)(documentRels, constants_1.RelType.Comments, "comments.xml");
     }
     // Images
     const imageExtensions = new Set();
@@ -262,14 +262,14 @@ async function packageDocx(doc, compressionLevel) {
                 const baseName = img.fileName.replace(/\.[^.]+$/, "");
                 const fallbackFileName = `${baseName}_fallback.png`;
                 // Register PNG fallback as the main rId
-                const fbRId = documentRels.add(constants_1.RelType.Image, `media/${fallbackFileName}`);
+                const fbRId = (0, relationships_1.addRelationship)(documentRels, constants_1.RelType.Image, `media/${fallbackFileName}`);
                 img.rId = fbRId;
                 if (oldRid) {
                     imageRidMap.set(oldRid, fbRId);
                 }
                 imageExtensions.add("png");
                 // Register SVG as separate image
-                const svgRId = documentRels.add(constants_1.RelType.Image, `media/${img.fileName}`);
+                const svgRId = (0, relationships_1.addRelationship)(documentRels, constants_1.RelType.Image, `media/${img.fileName}`);
                 svgRidMap.set(img.fileName, svgRId);
                 const ext = img.fileName.split(".").pop()?.toLowerCase();
                 if (ext) {
@@ -278,7 +278,7 @@ async function packageDocx(doc, compressionLevel) {
                 svgFallbacks.push({ fallbackFileName, data: img.fallbackData });
             }
             else {
-                const rId = documentRels.add(constants_1.RelType.Image, `media/${img.fileName}`);
+                const rId = (0, relationships_1.addRelationship)(documentRels, constants_1.RelType.Image, `media/${img.fileName}`);
                 img.rId = rId;
                 if (oldRid) {
                     imageRidMap.set(oldRid, rId);
@@ -345,7 +345,7 @@ async function packageDocx(doc, compressionLevel) {
     const hyperlinks = collectHyperlinks(doc.body);
     for (const link of hyperlinks) {
         if (link.url) {
-            const rId = documentRels.add(constants_1.RelType.Hyperlink, link.url, "External");
+            const rId = (0, relationships_1.addRelationship)(documentRels, constants_1.RelType.Hyperlink, link.url, "External");
             link.rId = rId;
         }
     }
@@ -355,11 +355,11 @@ async function packageDocx(doc, compressionLevel) {
     altChunks.forEach((chunk, i) => {
         const fileName = chunk.fileName ?? `afchunk${i + 1}.html`;
         // Register relationship for the alt chunk
-        const rId = documentRels.add("http://schemas.openxmlformats.org/officeDocument/2006/relationships/aFChunk", fileName);
+        const rId = (0, relationships_1.addRelationship)(documentRels, "http://schemas.openxmlformats.org/officeDocument/2006/relationships/aFChunk", fileName);
         chunk.rId = rId;
         // Register content type
         const ct = chunk.contentType ?? "text/html";
-        contentTypes.addOverride(`/word/${fileName}`, ct);
+        (0, content_types_1.addContentTypeOverride)(contentTypes, `/word/${fileName}`, ct);
         // Write data to archive
         if (chunk.data) {
             archive.add(`word/${fileName}`, chunk.data);
@@ -370,17 +370,17 @@ async function packageDocx(doc, compressionLevel) {
     const headerRelManagers = new Map();
     if (doc.headers) {
         for (const [key, headerDef] of doc.headers) {
-            const rId = documentRels.add(constants_1.RelType.Header, `header${headerIndex}.xml`);
+            const rId = (0, relationships_1.addRelationship)(documentRels, constants_1.RelType.Header, `header${headerIndex}.xml`);
             headerDef.rId = rId;
-            // Create per-header relationship manager for images and hyperlinks
-            const hRels = new relationships_1.RelationshipManager();
+            // Create per-header relationship state for images and hyperlinks
+            const hRels = (0, relationships_1.createRelationships)();
             const imgRids = collectImageRidsFromContent(headerDef.content);
             if (imgRids.size > 0 && doc.images) {
                 for (const oldRid of imgRids) {
                     // O(1) lookup: direct or via remap
                     const img = imageByRid.get(oldRid) ?? imageByRid.get(imageRidMap.get(oldRid) ?? "");
                     if (img) {
-                        hRels.addWithId(oldRid, constants_1.RelType.Image, `media/${img.fileName}`);
+                        (0, relationships_1.addRelationshipWithId)(hRels, oldRid, constants_1.RelType.Image, `media/${img.fileName}`);
                     }
                 }
             }
@@ -388,11 +388,11 @@ async function packageDocx(doc, compressionLevel) {
             const hLinks = collectHyperlinksFromHeaderFooter(headerDef.content);
             for (const link of hLinks) {
                 if (link.url) {
-                    const linkRId = hRels.add(constants_1.RelType.Hyperlink, link.url, "External");
+                    const linkRId = (0, relationships_1.addRelationship)(hRels, constants_1.RelType.Hyperlink, link.url, "External");
                     link.rId = linkRId;
                 }
             }
-            if (hRels.count > 0) {
+            if ((0, relationships_1.getRelationshipCount)(hRels) > 0) {
                 headerRelManagers.set(key, hRels);
             }
             headerIndex++;
@@ -403,16 +403,16 @@ async function packageDocx(doc, compressionLevel) {
     const footerRelManagers = new Map();
     if (doc.footers) {
         for (const [key, footerDef] of doc.footers) {
-            const rId = documentRels.add(constants_1.RelType.Footer, `footer${footerIndex}.xml`);
+            const rId = (0, relationships_1.addRelationship)(documentRels, constants_1.RelType.Footer, `footer${footerIndex}.xml`);
             footerDef.rId = rId;
-            // Create per-footer relationship manager for images and hyperlinks
-            const fRels = new relationships_1.RelationshipManager();
+            // Create per-footer relationship state for images and hyperlinks
+            const fRels = (0, relationships_1.createRelationships)();
             const imgRids = collectImageRidsFromContent(footerDef.content);
             if (imgRids.size > 0 && doc.images) {
                 for (const oldRid of imgRids) {
                     const img = imageByRid.get(oldRid) ?? imageByRid.get(imageRidMap.get(oldRid) ?? "");
                     if (img) {
-                        fRels.addWithId(oldRid, constants_1.RelType.Image, `media/${img.fileName}`);
+                        (0, relationships_1.addRelationshipWithId)(fRels, oldRid, constants_1.RelType.Image, `media/${img.fileName}`);
                     }
                 }
             }
@@ -420,11 +420,11 @@ async function packageDocx(doc, compressionLevel) {
             const fLinks = collectHyperlinksFromHeaderFooter(footerDef.content);
             for (const link of fLinks) {
                 if (link.url) {
-                    const linkRId = fRels.add(constants_1.RelType.Hyperlink, link.url, "External");
+                    const linkRId = (0, relationships_1.addRelationship)(fRels, constants_1.RelType.Hyperlink, link.url, "External");
                     link.rId = linkRId;
                 }
             }
-            if (fRels.count > 0) {
+            if ((0, relationships_1.getRelationshipCount)(fRels) > 0) {
                 footerRelManagers.set(key, fRels);
             }
             footerIndex++;
@@ -437,67 +437,67 @@ async function packageDocx(doc, compressionLevel) {
     if (doc.watermark) {
         // Use next header index
         const wmHdrIdx = headerIndex;
-        watermarkHeaderRId = documentRels.add(constants_1.RelType.Header, `header${wmHdrIdx}.xml`);
+        watermarkHeaderRId = (0, relationships_1.addRelationship)(documentRels, constants_1.RelType.Header, `header${wmHdrIdx}.xml`);
         watermarkHeaderIndex = wmHdrIdx;
         // If image watermark, add image relationship in header .rels
         if (doc.watermark.type === "image") {
-            const wmRels = new relationships_1.RelationshipManager();
+            const wmRels = (0, relationships_1.createRelationships)();
             const wmRId = doc.watermark.rId;
             const img = imageByRid.get(wmRId) ?? imageByRid.get(imageRidMap.get(wmRId) ?? "");
             if (img) {
-                wmRels.addWithId(wmRId, constants_1.RelType.Image, `media/${img.fileName}`);
+                (0, relationships_1.addRelationshipWithId)(wmRels, wmRId, constants_1.RelType.Image, `media/${img.fileName}`);
             }
             watermarkHeaderRels = wmRels;
         }
         headerIndex++;
     }
     // --- Content Types ---
-    contentTypes.addImageDefaults(imageExtensions);
-    contentTypes.addOverride(constants_1.PartPath.Document, constants_1.ContentType.Document);
-    contentTypes.addOverride(constants_1.PartPath.Styles, constants_1.ContentType.Styles);
-    contentTypes.addOverride(constants_1.PartPath.Settings, constants_1.ContentType.Settings);
-    contentTypes.addOverride(constants_1.PartPath.FontTable, constants_1.ContentType.FontTable);
-    contentTypes.addOverride(constants_1.PartPath.Theme, constants_1.ContentType.Theme);
+    (0, content_types_1.addImageContentTypeDefaults)(contentTypes, imageExtensions);
+    (0, content_types_1.addContentTypeOverride)(contentTypes, constants_1.PartPath.Document, constants_1.ContentType.Document);
+    (0, content_types_1.addContentTypeOverride)(contentTypes, constants_1.PartPath.Styles, constants_1.ContentType.Styles);
+    (0, content_types_1.addContentTypeOverride)(contentTypes, constants_1.PartPath.Settings, constants_1.ContentType.Settings);
+    (0, content_types_1.addContentTypeOverride)(contentTypes, constants_1.PartPath.FontTable, constants_1.ContentType.FontTable);
+    (0, content_types_1.addContentTypeOverride)(contentTypes, constants_1.PartPath.Theme, constants_1.ContentType.Theme);
     if (hasNumbering) {
-        contentTypes.addOverride(constants_1.PartPath.Numbering, constants_1.ContentType.Numbering);
+        (0, content_types_1.addContentTypeOverride)(contentTypes, constants_1.PartPath.Numbering, constants_1.ContentType.Numbering);
     }
     if (hasFootnotes) {
-        contentTypes.addOverride(constants_1.PartPath.Footnotes, constants_1.ContentType.Footnotes);
+        (0, content_types_1.addContentTypeOverride)(contentTypes, constants_1.PartPath.Footnotes, constants_1.ContentType.Footnotes);
     }
     if (hasEndnotes) {
-        contentTypes.addOverride(constants_1.PartPath.Endnotes, constants_1.ContentType.Endnotes);
+        (0, content_types_1.addContentTypeOverride)(contentTypes, constants_1.PartPath.Endnotes, constants_1.ContentType.Endnotes);
     }
     if (hasComments) {
-        contentTypes.addOverride(constants_1.PartPath.Comments, constants_1.ContentType.Comments);
+        (0, content_types_1.addContentTypeOverride)(contentTypes, constants_1.PartPath.Comments, constants_1.ContentType.Comments);
     }
     headerIndex = 1;
     if (doc.headers) {
         for (const [,] of doc.headers) {
-            contentTypes.addOverride(constants_1.PartPath.header(headerIndex), constants_1.ContentType.Header);
+            (0, content_types_1.addContentTypeOverride)(contentTypes, constants_1.PartPath.header(headerIndex), constants_1.ContentType.Header);
             headerIndex++;
         }
     }
     footerIndex = 1;
     if (doc.footers) {
         for (const [,] of doc.footers) {
-            contentTypes.addOverride(constants_1.PartPath.footer(footerIndex), constants_1.ContentType.Footer);
+            (0, content_types_1.addContentTypeOverride)(contentTypes, constants_1.PartPath.footer(footerIndex), constants_1.ContentType.Footer);
             footerIndex++;
         }
     }
     if (watermarkHeaderIndex !== undefined) {
-        contentTypes.addOverride(constants_1.PartPath.header(watermarkHeaderIndex), constants_1.ContentType.Header);
+        (0, content_types_1.addContentTypeOverride)(contentTypes, constants_1.PartPath.header(watermarkHeaderIndex), constants_1.ContentType.Header);
     }
-    contentTypes.addOverride(constants_1.PartPath.CoreProps, constants_1.ContentType.CoreProperties);
-    contentTypes.addOverride(constants_1.PartPath.AppProps, constants_1.ContentType.ExtendedProperties);
+    (0, content_types_1.addContentTypeOverride)(contentTypes, constants_1.PartPath.CoreProps, constants_1.ContentType.CoreProperties);
+    (0, content_types_1.addContentTypeOverride)(contentTypes, constants_1.PartPath.AppProps, constants_1.ContentType.ExtendedProperties);
     if (hasCustomProps) {
-        contentTypes.addOverride(constants_1.PartPath.CustomProps, constants_1.ContentType.CustomProperties);
+        (0, content_types_1.addContentTypeOverride)(contentTypes, constants_1.PartPath.CustomProps, constants_1.ContentType.CustomProperties);
     }
     // --- Generate & add parts to archive ---
     // Note: [Content_Types].xml and _rels/.rels are serialized LAST so that any
     // relationships/content types registered during content rendering (e.g.
     // thumbnails, chart parts, alt chunks) are included.
     // word/_rels/document.xml.rels
-    archive.add(constants_1.PartPath.DocumentRels, renderXml(xml => documentRels.render(xml)));
+    archive.add(constants_1.PartPath.DocumentRels, renderXml(xml => (0, relationships_1.renderRelationships)(documentRels, xml)));
     // Build an effective doc that includes the auto-generated watermark header
     // reference in section properties (without mutating the caller's doc).
     let effectiveDoc = doc;
@@ -533,7 +533,7 @@ async function packageDocx(doc, compressionLevel) {
     const chartRIds = [];
     charts.forEach(chartContent => {
         const num = chartRIds.length + 1;
-        const rId = documentRels.add(constants_1.RelType.Chart, `charts/chart${num}.xml`);
+        const rId = (0, relationships_1.addRelationship)(documentRels, constants_1.RelType.Chart, `charts/chart${num}.xml`);
         chartRIds.push(rId);
         // Store rId in registry so renderChartDrawing can look it up
         document_writer_1.CHART_RID_REGISTRY.set(chartContent, rId);
@@ -548,7 +548,7 @@ async function packageDocx(doc, compressionLevel) {
     archive.add(constants_1.PartPath.FontTable, renderXml(xml => (0, parts_writer_1.renderFontTable)(xml, doc.fonts)));
     // word/fonts/*.odttf (embedded fonts)
     if (doc.embeddedFonts && doc.embeddedFonts.length > 0) {
-        const fontTableRels = new relationships_1.RelationshipManager();
+        const fontTableRels = (0, relationships_1.createRelationships)();
         const usedRIds = new Set();
         // Collect rIds referenced in fontTable
         if (doc.fonts) {
@@ -572,26 +572,26 @@ async function packageDocx(doc, compressionLevel) {
             archive.add(partPath, ef.data);
             // Register relationship from fontTable.xml
             if (usedRIds.has(ef.rId)) {
-                fontTableRels.addWithId(ef.rId, constants_1.RelType.Font, `fonts/${ef.fileName}`);
+                (0, relationships_1.addRelationshipWithId)(fontTableRels, ef.rId, constants_1.RelType.Font, `fonts/${ef.fileName}`);
             }
             else {
                 // Add anyway so the embedded font isn't orphaned
-                fontTableRels.addWithId(ef.rId, constants_1.RelType.Font, `fonts/${ef.fileName}`);
+                (0, relationships_1.addRelationshipWithId)(fontTableRels, ef.rId, constants_1.RelType.Font, `fonts/${ef.fileName}`);
             }
             // Register content type for .odttf / .ttf
             const ext = ef.fileName.split(".").pop()?.toLowerCase();
             if (ext === "odttf") {
-                contentTypes.addDefault("odttf", constants_1.ContentType.ObfuscatedFont);
+                (0, content_types_1.addContentTypeDefault)(contentTypes, "odttf", constants_1.ContentType.ObfuscatedFont);
             }
             else if (ext === "ttf") {
-                contentTypes.addDefault("ttf", "application/x-font-ttf");
+                (0, content_types_1.addContentTypeDefault)(contentTypes, "ttf", "application/x-font-ttf");
             }
             else if (ext === "otf") {
-                contentTypes.addDefault("otf", "application/x-font-otf");
+                (0, content_types_1.addContentTypeDefault)(contentTypes, "otf", "application/x-font-otf");
             }
         }
         // Write fontTable.xml.rels
-        archive.add("word/_rels/fontTable.xml.rels", renderXml(xml => fontTableRels.render(xml)));
+        archive.add("word/_rels/fontTable.xml.rels", renderXml(xml => (0, relationships_1.renderRelationships)(fontTableRels, xml)));
     }
     // Custom XML parts (for SDT data binding)
     if (doc.customXmlParts && doc.customXmlParts.length > 0) {
@@ -622,13 +622,13 @@ async function packageDocx(doc, compressionLevel) {
             });
             archive.add(propsPath, propsXml);
             // Write item rels (links itemN.xml → itemPropsN.xml)
-            const itemRels = new relationships_1.RelationshipManager();
-            itemRels.add(constants_1.RelType.CustomXmlProps, `itemProps${num}.xml`);
-            archive.add(`word/customXml/_rels/item${num}.xml.rels`, renderXml(xml => itemRels.render(xml)));
+            const itemRels = (0, relationships_1.createRelationships)();
+            (0, relationships_1.addRelationship)(itemRels, constants_1.RelType.CustomXmlProps, `itemProps${num}.xml`);
+            archive.add(`word/customXml/_rels/item${num}.xml.rels`, renderXml(xml => (0, relationships_1.renderRelationships)(itemRels, xml)));
             // Register content types
-            contentTypes.addOverride(`/word/customXml/itemProps${num}.xml`, "application/vnd.openxmlformats-officedocument.customXmlProperties+xml");
+            (0, content_types_1.addContentTypeOverride)(contentTypes, `/word/customXml/itemProps${num}.xml`, "application/vnd.openxmlformats-officedocument.customXmlProperties+xml");
             // Add to document rels
-            documentRels.add(constants_1.RelType.CustomXml, `customXml/item${num}.xml`);
+            (0, relationships_1.addRelationship)(documentRels, constants_1.RelType.CustomXml, `customXml/item${num}.xml`);
         });
     }
     // word/theme/theme1.xml
@@ -653,8 +653,8 @@ async function packageDocx(doc, compressionLevel) {
         if (hasExtended) {
             const extXml = renderXml(xml => (0, comment_writer_1.renderCommentsExtended)(xml, doc.comments));
             archive.add(constants_1.PartPath.CommentsExtended, extXml);
-            documentRels.add(constants_1.RelType.CommentsExtended, "commentsExtended.xml");
-            contentTypes.addOverride(`/${constants_1.PartPath.CommentsExtended}`, constants_1.ContentType.CommentsExtended);
+            (0, relationships_1.addRelationship)(documentRels, constants_1.RelType.CommentsExtended, "commentsExtended.xml");
+            (0, content_types_1.addContentTypeOverride)(contentTypes, `/${constants_1.PartPath.CommentsExtended}`, constants_1.ContentType.CommentsExtended);
         }
     }
     // Headers
@@ -667,8 +667,8 @@ async function packageDocx(doc, compressionLevel) {
             // Header .rels file
             const hKey = keys[hIdx];
             const hRels = headerRelManagers.get(hKey);
-            if (hRels && hRels.count > 0) {
-                archive.add(`word/_rels/header${headerIndex}.xml.rels`, renderXml(xml => hRels.render(xml)));
+            if (hRels && (0, relationships_1.getRelationshipCount)(hRels) > 0) {
+                archive.add(`word/_rels/header${headerIndex}.xml.rels`, renderXml(xml => (0, relationships_1.renderRelationships)(hRels, xml)));
             }
             headerIndex++;
             hIdx++;
@@ -684,8 +684,8 @@ async function packageDocx(doc, compressionLevel) {
             // Footer .rels file
             const fKey = keys[fIdx];
             const fRels = footerRelManagers.get(fKey);
-            if (fRels && fRels.count > 0) {
-                archive.add(`word/_rels/footer${footerIndex}.xml.rels`, renderXml(xml => fRels.render(xml)));
+            if (fRels && (0, relationships_1.getRelationshipCount)(fRels) > 0) {
+                archive.add(`word/_rels/footer${footerIndex}.xml.rels`, renderXml(xml => (0, relationships_1.renderRelationships)(fRels, xml)));
             }
             footerIndex++;
             fIdx++;
@@ -694,8 +694,8 @@ async function packageDocx(doc, compressionLevel) {
     // Watermark header
     if (watermarkHeaderIndex !== undefined && doc.watermark) {
         archive.add(constants_1.PartPath.header(watermarkHeaderIndex), renderXml(xml => (0, header_footer_writer_1.renderWatermarkHeader)(xml, doc.watermark)));
-        if (watermarkHeaderRels && watermarkHeaderRels.count > 0) {
-            archive.add(`word/_rels/header${watermarkHeaderIndex}.xml.rels`, renderXml(xml => watermarkHeaderRels.render(xml)));
+        if (watermarkHeaderRels && (0, relationships_1.getRelationshipCount)(watermarkHeaderRels) > 0) {
+            archive.add(`word/_rels/header${watermarkHeaderIndex}.xml.rels`, renderXml(xml => (0, relationships_1.renderRelationships)(watermarkHeaderRels, xml)));
         }
     }
     // Media / images
@@ -719,14 +719,14 @@ async function packageDocx(doc, compressionLevel) {
     // word/webSettings.xml
     if (doc.webSettings) {
         archive.add(constants_1.PartPath.WebSettings, renderXml(xml => (0, parts_writer_1.renderWebSettings)(xml, doc.webSettings)));
-        documentRels.add(constants_1.RelType.WebSettings, "webSettings.xml");
-        contentTypes.addOverride(`/${constants_1.PartPath.WebSettings}`, constants_1.ContentType.WebSettings);
+        (0, relationships_1.addRelationship)(documentRels, constants_1.RelType.WebSettings, "webSettings.xml");
+        (0, content_types_1.addContentTypeOverride)(contentTypes, `/${constants_1.PartPath.WebSettings}`, constants_1.ContentType.WebSettings);
     }
     // word/people.xml
     if (doc.people && doc.people.length > 0) {
         archive.add(constants_1.PartPath.People, renderXml(xml => (0, parts_writer_1.renderPeople)(xml, doc.people)));
-        documentRels.add(constants_1.RelType.People, "people.xml");
-        contentTypes.addOverride(`/${constants_1.PartPath.People}`, constants_1.ContentType.People);
+        (0, relationships_1.addRelationship)(documentRels, constants_1.RelType.People, "people.xml");
+        (0, content_types_1.addContentTypeOverride)(contentTypes, `/${constants_1.PartPath.People}`, constants_1.ContentType.People);
     }
     // docProps/thumbnail
     if (doc.thumbnail) {
@@ -738,8 +738,8 @@ async function packageDocx(doc, compressionLevel) {
         const thumbPath = `docProps/thumbnail.${ext}`;
         archive.add(thumbPath, doc.thumbnail.data);
         // Package rels: target is relative to package root (docProps/thumbnail.jpeg)
-        packageRels.add("http://schemas.openxmlformats.org/package/2006/relationships/metadata/thumbnail", thumbPath);
-        contentTypes.addDefault(ext, doc.thumbnail.contentType);
+        (0, relationships_1.addRelationship)(packageRels, "http://schemas.openxmlformats.org/package/2006/relationships/metadata/thumbnail", thumbPath);
+        (0, content_types_1.addContentTypeDefault)(contentTypes, ext, doc.thumbnail.contentType);
     }
     // Write opaque (unrecognized) parts for round-trip preservation
     if (doc.opaqueParts) {
@@ -748,23 +748,23 @@ async function packageDocx(doc, compressionLevel) {
             // Register content type: explicit > inferred by extension > skip
             const ext = part.path.split(".").pop()?.toLowerCase();
             if (part.contentType) {
-                contentTypes.addOverride(`/${part.path}`, part.contentType);
+                (0, content_types_1.addContentTypeOverride)(contentTypes, `/${part.path}`, part.contentType);
             }
             else if (ext) {
                 // Infer from common extensions so [Content_Types].xml isn't incomplete
                 const inferred = inferContentType(ext);
                 if (inferred) {
-                    contentTypes.addOverride(`/${part.path}`, inferred);
+                    (0, content_types_1.addContentTypeOverride)(contentTypes, `/${part.path}`, inferred);
                 }
             }
             // Write part relationships if any
             if (part.relationships && part.relationships.length > 0) {
-                const partRels = new relationships_1.RelationshipManager();
+                const partRels = (0, relationships_1.createRelationships)();
                 for (const rel of part.relationships) {
-                    partRels.addWithId(rel.id, rel.type, rel.target, rel.targetMode);
+                    (0, relationships_1.addRelationshipWithId)(partRels, rel.id, rel.type, rel.target, rel.targetMode);
                 }
                 const relsPath = getPartRelsPath(part.path);
-                archive.add(relsPath, renderXml(xml => partRels.render(xml)));
+                archive.add(relsPath, renderXml(xml => (0, relationships_1.renderRelationships)(partRels, xml)));
             }
         }
     }
@@ -775,12 +775,12 @@ async function packageDocx(doc, compressionLevel) {
         // Register chart part
         archive.add(chartPath, renderXml(xml => (0, chart_writer_1.renderChartPart)(xml, chartContent.chart)));
         // Register content type
-        contentTypes.addOverride(`/word/charts/chart${num}.xml`, constants_1.ContentType.Chart);
+        (0, content_types_1.addContentTypeOverride)(contentTypes, `/word/charts/chart${num}.xml`, constants_1.ContentType.Chart);
     });
     // LAST: Write [Content_Types].xml and _rels/.rels after all parts have registered
     // their content types and relationships.
-    archive.add(constants_1.PartPath.ContentTypes, renderXml(xml => contentTypes.render(xml)));
-    archive.add(constants_1.PartPath.PackageRels, renderXml(xml => packageRels.render(xml)));
+    archive.add(constants_1.PartPath.ContentTypes, renderXml(xml => (0, content_types_1.renderContentTypes)(contentTypes, xml)));
+    archive.add(constants_1.PartPath.PackageRels, renderXml(xml => (0, relationships_1.renderRelationships)(packageRels, xml)));
     return archive.bytes();
 }
 /** Recursively collect altChunks from body content. */

package/dist/cjs/modules/word/html-renderer.js

@@ -8,7 +8,7 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.renderToHtml = renderToHtml;
-const document_1 = require("./document");
+const color_utils_1 = require("./color-utils");
 const internal_utils_1 = require("./internal-utils");
 /**
  * Convert a DocxDocument to HTML.
@@ -722,7 +722,7 @@ function resolveColor(color, theme) {
             return color.value === "auto" ? undefined : color.value;
         }
         if (color.themeColor && theme) {
-            return (0, document_1.resolveThemeColor)(color, theme);
+            return (0, color_utils_1.resolveThemeColor)(color, theme);
         }
     }
     return undefined;

package/dist/cjs/modules/word/html.js

@@ -0,0 +1,16 @@
+"use strict";
+/**
+ * DOCX Module - HTML Renderer (Subpath Export)
+ *
+ * Import separately to avoid pulling html-renderer into the bundle
+ * when only core document building is needed.
+ *
+ * @example
+ * ```ts
+ * import { renderToHtml } from "excelts/word/html";
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.renderToHtml = void 0;
+var html_renderer_1 = require("./html-renderer");
+Object.defineProperty(exports, "renderToHtml", { enumerable: true, get: function () { return html_renderer_1.renderToHtml; } });

package/dist/cjs/modules/word/index.base.js

@@ -5,10 +5,9 @@
  * Shared exports for both Node.js and browser environments.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.timeField = exports.sequenceField = exports.dateField = exports.sectionField = exports.sectionPagesField = exports.totalPagesField = exports.pageNumberField = exports.field = exports.softHyphen = exports.noBreakHyphen = exports.carriageReturn = exports.ruby = exports.positionalTab = exports.tab = exports.columnBreak = exports.lineBreak = exports.pageBreak = exports.italic = exports.bold = exports.text = exports.DocumentBuilder = exports.tablePctToPercent = exports.percentToTablePct = exports.spacingToLineMultiplier = exports.lineMultiplierToSpacing = exports.eighthPointToPt = exports.ptToEighthPoint = exports.halfPointToPt = exports.ptToHalfPoint = exports.emuToPx = exports.pxToEmu = exports.ptToEmu = exports.emuToCm = exports.cmToEmu = exports.emuToInches = exports.inchesToEmu = exports.mmToTwips = exports.twipsToPt = exports.ptToTwips = exports.twipsToCm = exports.cmToTwips = exports.twipsToInches = exports.inchesToTwips = exports.isDocxError = exports.DocxUnsupportedFeatureError = exports.DocxInvalidStructureError = exports.DocxMissingPartError = exports.DocxWriteError = exports.DocxParseError = exports.DocxError = void 0;
+exports.timeField = exports.sequenceField = exports.dateField = exports.sectionField = exports.sectionPagesField = exports.totalPagesField = exports.pageNumberField = exports.field = exports.softHyphen = exports.noBreakHyphen = exports.carriageReturn = exports.ruby = exports.positionalTab = exports.tab = exports.columnBreak = exports.lineBreak = exports.pageBreak = exports.italic = exports.bold = exports.text = exports.Document = exports.tablePctToPercent = exports.percentToTablePct = exports.spacingToLineMultiplier = exports.lineMultiplierToSpacing = exports.eighthPointToPt = exports.ptToEighthPoint = exports.halfPointToPt = exports.ptToHalfPoint = exports.emuToPx = exports.pxToEmu = exports.ptToEmu = exports.emuToCm = exports.cmToEmu = exports.emuToInches = exports.inchesToEmu = exports.mmToTwips = exports.twipsToPt = exports.ptToTwips = exports.twipsToCm = exports.cmToTwips = exports.twipsToInches = exports.inchesToTwips = exports.isDocxError = exports.DocxUnsupportedFeatureError = exports.DocxInvalidStructureError = exports.DocxMissingPartError = exports.DocxWriteError = exports.DocxParseError = exports.DocxError = void 0;
 exports.mathSubScript = exports.mathSuperScript = exports.mathProduct = exports.mathIntegral = exports.mathSum = exports.mathRoot = exports.mathSqrt = exports.mathFraction = exports.mathRun = exports.mathBlock = exports.checkBox = exports.moveToRangeEnd = exports.moveToRangeStart = exports.moveFromRangeEnd = exports.moveFromRangeStart = exports.movedToRun = exports.movedFromRun = exports.deletedRun = exports.insertedRun = exports.commentReference = exports.commentRangeEnd = exports.commentRangeStart = exports.bookmarkEnd = exports.bookmarkStart = exports.hyperlink = exports.heading = exports.textParagraph = exports.paragraph = exports.formDropdownField = exports.formCheckboxField = exports.formTextField = exports.includePictureField = exports.includeTextField = exports.ifField = exports.indexField = exports.indexEntryField = exports.tcField = exports.tocField = exports.quoteField = exports.hyperlinkField = exports.noteRefField = exports.pageRefField = exports.refField = exports.styleRefField = exports.fileSizeField = exports.fileNameField = exports.keywordsField = exports.subjectField = exports.titleField = exports.authorField = void 0;
-exports.deriveEncryptionKey = exports.parseEncryptionInfoXml = exports.decryptPackage = exports.verifyPassword = exports.isEncryptedDocx = exports.generateFontKey = exports.obfuscateFont = exports.deobfuscateFont = exports.readDocx = exports.packageDocx = exports.extractText = exports.tableCount = exports.listHyperlinks = exports.listTables = exports.listImages = exports.findComment = exports.findBookmark = exports.getHeadings = exports.countWords = exports.paragraphCount = exports.mailMerge = exports.patchDocument = exports.resolveThemeColor = exports.replaceText = exports.searchText = exports.simpleTable = exports.table = exports.row = exports.cell = exports.gridBorders = exports.border = exports.structuredDocumentTag = exports.chart = exports.drawingShape = exports.floatingImage = exports.symbol = exports.mathEquationArray = exports.mathBox = exports.mathBar = exports.mathAccent = exports.mathMatrix = exports.mathLimit = exports.mathFunction = exports.mathNary = exports.mathDelimiter = exports.mathBorderBox = exports.mathGroupChar = exports.mathPhantom = exports.mathPreSubSuperScript = exports.mathSubSuperScript = void 0;
-exports.renderToHtml = exports.isWellFormedSignature = exports.extractSignatures = exports.parseSignatureXml = exports.hasDigitalSignatures = exports.AGILE_BLOCK_KEYS = void 0;
+exports.MathML = exports.Query = exports.Sdt = exports.TrackChanges = exports.Drawing = exports.Field = exports.patchDocument = exports.toBase64 = exports.toBuffer = exports.readDocx = exports.packageDocx = exports.extractText = exports.tableCount = exports.listHyperlinks = exports.listTables = exports.listImages = exports.findComment = exports.findBookmark = exports.getHeadings = exports.countWords = exports.paragraphCount = exports.mailMerge = exports.resolveThemeColor = exports.replaceText = exports.searchText = exports.simpleTable = exports.table = exports.row = exports.cell = exports.gridBorders = exports.border = exports.structuredDocumentTag = exports.chart = exports.drawingShape = exports.floatingImage = exports.symbol = exports.mathEquationArray = exports.mathBox = exports.mathBar = exports.mathAccent = exports.mathMatrix = exports.mathLimit = exports.mathFunction = exports.mathNary = exports.mathDelimiter = exports.mathBorderBox = exports.mathGroupChar = exports.mathPhantom = exports.mathPreSubSuperScript = exports.mathSubSuperScript = void 0;
 // Errors
 var errors_1 = require("./errors");
 Object.defineProperty(exports, "DocxError", { enumerable: true, get: function () { return errors_1.DocxError; } });
@@ -44,7 +43,7 @@ Object.defineProperty(exports, "percentToTablePct", { enumerable: true, get: fun
 Object.defineProperty(exports, "tablePctToPercent", { enumerable: true, get: function () { return units_1.tablePctToPercent; } });
 // Builder helpers
 var document_1 = require("./document");
-Object.defineProperty(exports, "DocumentBuilder", { enumerable: true, get: function () { return document_1.DocumentBuilder; } });
+Object.defineProperty(exports, "Document", { enumerable: true, get: function () { return document_1.Document; } });
 // Run helpers
 Object.defineProperty(exports, "text", { enumerable: true, get: function () { return document_1.text; } });
 Object.defineProperty(exports, "bold", { enumerable: true, get: function () { return document_1.bold; } });
@@ -156,7 +155,6 @@ Object.defineProperty(exports, "simpleTable", { enumerable: true, get: function
 Object.defineProperty(exports, "searchText", { enumerable: true, get: function () { return document_1.searchText; } });
 Object.defineProperty(exports, "replaceText", { enumerable: true, get: function () { return document_1.replaceText; } });
 Object.defineProperty(exports, "resolveThemeColor", { enumerable: true, get: function () { return document_1.resolveThemeColor; } });
-Object.defineProperty(exports, "patchDocument", { enumerable: true, get: function () { return document_1.patchDocument; } });
 Object.defineProperty(exports, "mailMerge", { enumerable: true, get: function () { return document_1.mailMerge; } });
 // Query API
 Object.defineProperty(exports, "paragraphCount", { enumerable: true, get: function () { return document_1.paragraphCount; } });
@@ -175,25 +173,17 @@ Object.defineProperty(exports, "packageDocx", { enumerable: true, get: function
 // Reader
 var docx_reader_1 = require("./docx-reader");
 Object.defineProperty(exports, "readDocx", { enumerable: true, get: function () { return docx_reader_1.readDocx; } });
-// Font obfuscation utilities
-var font_obfuscation_1 = require("./font-obfuscation");
-Object.defineProperty(exports, "deobfuscateFont", { enumerable: true, get: function () { return font_obfuscation_1.deobfuscateFont; } });
-Object.defineProperty(exports, "obfuscateFont", { enumerable: true, get: function () { return font_obfuscation_1.obfuscateFont; } });
-Object.defineProperty(exports, "generateFontKey", { enumerable: true, get: function () { return font_obfuscation_1.generateFontKey; } });
-// Encryption utilities
-var encryption_1 = require("./encryption");
-Object.defineProperty(exports, "isEncryptedDocx", { enumerable: true, get: function () { return encryption_1.isEncryptedDocx; } });
-Object.defineProperty(exports, "verifyPassword", { enumerable: true, get: function () { return encryption_1.verifyPassword; } });
-Object.defineProperty(exports, "decryptPackage", { enumerable: true, get: function () { return encryption_1.decryptPackage; } });
-Object.defineProperty(exports, "parseEncryptionInfoXml", { enumerable: true, get: function () { return encryption_1.parseEncryptionInfoXml; } });
-Object.defineProperty(exports, "deriveEncryptionKey", { enumerable: true, get: function () { return encryption_1.deriveEncryptionKey; } });
-Object.defineProperty(exports, "AGILE_BLOCK_KEYS", { enumerable: true, get: function () { return encryption_1.AGILE_BLOCK_KEYS; } });
-// Digital signature utilities
-var digital_signatures_1 = require("./digital-signatures");
-Object.defineProperty(exports, "hasDigitalSignatures", { enumerable: true, get: function () { return digital_signatures_1.hasDigitalSignatures; } });
-Object.defineProperty(exports, "parseSignatureXml", { enumerable: true, get: function () { return digital_signatures_1.parseSignatureXml; } });
-Object.defineProperty(exports, "extractSignatures", { enumerable: true, get: function () { return digital_signatures_1.extractSignatures; } });
-Object.defineProperty(exports, "isWellFormedSignature", { enumerable: true, get: function () { return digital_signatures_1.isWellFormedSignature; } });
-// HTML Renderer
-var html_renderer_1 = require("./html-renderer");
-Object.defineProperty(exports, "renderToHtml", { enumerable: true, get: function () { return html_renderer_1.renderToHtml; } });
+// Document IO (toBuffer, toBase64, patchDocument)
+var document_io_1 = require("./document-io");
+Object.defineProperty(exports, "toBuffer", { enumerable: true, get: function () { return document_io_1.toBuffer; } });
+Object.defineProperty(exports, "toBase64", { enumerable: true, get: function () { return document_io_1.toBase64; } });
+Object.defineProperty(exports, "patchDocument", { enumerable: true, get: function () { return document_io_1.patchDocument; } });
+// Sub-namespaces for grouped API ergonomics (no name conflicts with types)
+var namespaces_1 = require("./namespaces");
+Object.defineProperty(exports, "Field", { enumerable: true, get: function () { return namespaces_1.Field; } });
+Object.defineProperty(exports, "Drawing", { enumerable: true, get: function () { return namespaces_1.Drawing; } });
+Object.defineProperty(exports, "TrackChanges", { enumerable: true, get: function () { return namespaces_1.TrackChanges; } });
+Object.defineProperty(exports, "Sdt", { enumerable: true, get: function () { return namespaces_1.Sdt; } });
+Object.defineProperty(exports, "Query", { enumerable: true, get: function () { return namespaces_1.Query; } });
+var namespaces_2 = require("./namespaces");
+Object.defineProperty(exports, "MathML", { enumerable: true, get: function () { return namespaces_2.Math; } });