pptx-viewer-core 1.6.5 → 1.6.7

package/CHANGELOG.md

@@ -4,6 +4,14 @@ All notable changes to this project are documented here.
 This file is generated from [Conventional Commits](https://www.conventionalcommits.org)
 by [git-cliff](https://git-cliff.org); do not edit it by hand.
 
+## [1.6.6](https://github.com/ChristopherVR/pptx-viewer/releases/tag/pptx-viewer-core@1.6.6) - 2026-07-18
+
+## [1.6.5](https://github.com/ChristopherVR/pptx-viewer/releases/tag/pptx-viewer-core@1.6.5) - 2026-07-18
+
+### Documentation
+
+- Correct and expand the per-package npm readmes (by @ChristopherVR) ([46f7c57](https://github.com/ChristopherVR/pptx-viewer/commit/46f7c573701a19e91c507d41ebdc956c64699c38))
+
 ## [1.6.4](https://github.com/ChristopherVR/pptx-viewer/releases/tag/pptx-viewer-core@1.6.4) - 2026-07-18
 
 ## [1.6.3](https://github.com/ChristopherVR/pptx-viewer/releases/tag/pptx-viewer-core@1.6.3) - 2026-07-18

package/dist/cli/index.js

@@ -2713,14 +2713,52 @@ function extractSourceOrders(xml) {
   }
   return orders;
 }
+function ensureArrayLocal(value) {
+  return Array.isArray(value) ? value : value === void 0 ? [] : [value];
+}
+function countsSignature(counts) {
+  return [...counts.entries()].sort((a, b) => a[0] < b[0] ? -1 : 1).map(([name, count]) => `${name}:${count}`).join(",");
+}
+function pathSignature(path2) {
+  const counts = /* @__PURE__ */ new Map();
+  for (const key of Object.keys(path2)) {
+    const name = localName(key);
+    if (!PATH_COMMANDS.has(name)) {
+      continue;
+    }
+    counts.set(name, (counts.get(name) ?? 0) + ensureArrayLocal(path2[key]).length);
+  }
+  return countsSignature(counts);
+}
+function orderSignature(order) {
+  const counts = /* @__PURE__ */ new Map();
+  for (const name of order) {
+    counts.set(name, (counts.get(name) ?? 0) + 1);
+  }
+  return countsSignature(counts);
+}
 function annotateCustomGeometryCommandOrder(xml, parsed) {
   const orders = extractSourceOrders(xml);
   if (orders.length === 0) {
     return;
   }
   const paths = collectParsedPaths(parsed);
-  for (let index = 0; index < Math.min(paths.length, orders.length); index++) {
-    commandOrder.set(paths[index], orders[index]);
+  const ordersBySignature = /* @__PURE__ */ new Map();
+  for (const order of orders) {
+    const signature = orderSignature(order);
+    const bucket = ordersBySignature.get(signature);
+    if (bucket) {
+      bucket.push(order);
+    } else {
+      ordersBySignature.set(signature, [order]);
+    }
+  }
+  for (const path2 of paths) {
+    const bucket = ordersBySignature.get(pathSignature(path2));
+    const order = bucket?.shift();
+    if (order) {
+      commandOrder.set(path2, order);
+    }
   }
 }
 function orderedPathCommandEntries(path2, ensureArray16) {
@@ -50002,6 +50040,8 @@ var PptxHandlerRuntime56 = class extends PptxHandlerRuntime55 {
       const existing = merged[key];
       if (value && typeof value === "object" && !Array.isArray(value) && existing && typeof existing === "object" && !Array.isArray(existing)) {
         merged[key] = this.mergeXmlObjects(existing, value, depth + 1);
+      } else if (value === "" && existing !== void 0 && existing !== "" && typeof existing === "object") {
+        merged[key] = existing;
       } else {
         merged[key] = value;
       }
@@ -52784,32 +52824,56 @@ var PptxHandlerRuntime67 = class _PptxHandlerRuntime extends PptxHandlerRuntime6
     }
     const grpSpPr = group["p:grpSpPr"];
     const xfrm = grpSpPr?.["a:xfrm"];
+    const EMU_PX = _PptxHandlerRuntime.EMU_PER_PX;
     let parentX = 0, parentY = 0, parentW = 0, parentH = 0;
     let chX = 0, chY = 0, chW = 0, chH = 0;
     if (xfrm) {
       const off = xfrm["a:off"];
       if (off) {
-        parentX = Math.round(parseEmuInt2(off["@_x"]) / _PptxHandlerRuntime.EMU_PER_PX);
-        parentY = Math.round(parseEmuInt2(off["@_y"]) / _PptxHandlerRuntime.EMU_PER_PX);
+        parentX = parseEmuInt2(off["@_x"]) / EMU_PX;
+        parentY = parseEmuInt2(off["@_y"]) / EMU_PX;
       }
       const ext = xfrm["a:ext"];
       if (ext) {
-        parentW = Math.round(parseEmuInt2(ext["@_cx"]) / _PptxHandlerRuntime.EMU_PER_PX);
-        parentH = Math.round(parseEmuInt2(ext["@_cy"]) / _PptxHandlerRuntime.EMU_PER_PX);
+        parentW = parseEmuInt2(ext["@_cx"]) / EMU_PX;
+        parentH = parseEmuInt2(ext["@_cy"]) / EMU_PX;
       }
       const chOff = xfrm["a:chOff"];
       if (chOff) {
-        chX = Math.round(parseEmuInt2(chOff["@_x"]) / _PptxHandlerRuntime.EMU_PER_PX);
-        chY = Math.round(parseEmuInt2(chOff["@_y"]) / _PptxHandlerRuntime.EMU_PER_PX);
+        chX = parseEmuInt2(chOff["@_x"]) / EMU_PX;
+        chY = parseEmuInt2(chOff["@_y"]) / EMU_PX;
       }
       const chExt = xfrm["a:chExt"];
       if (chExt) {
-        chW = Math.round(parseEmuInt2(chExt["@_cx"]) / _PptxHandlerRuntime.EMU_PER_PX);
-        chH = Math.round(parseEmuInt2(chExt["@_cy"]) / _PptxHandlerRuntime.EMU_PER_PX);
+        chW = parseEmuInt2(chExt["@_cx"]) / EMU_PX;
+        chH = parseEmuInt2(chExt["@_cy"]) / EMU_PX;
       }
     }
     const scaleX = chW > 0 ? parentW / chW : 1;
     const scaleY = chH > 0 ? parentH / chH : 1;
+    const rawChildXfrm = (childNode) => {
+      if (!childNode) {
+        return void 0;
+      }
+      const childXfrm = childNode["p:spPr"]?.["a:xfrm"] ?? childNode["p:xfrm"];
+      return childXfrm;
+    };
+    const applyRawChildGeometry = (el, childNode) => {
+      const childXfrm = rawChildXfrm(childNode);
+      if (!childXfrm) {
+        return;
+      }
+      const off = childXfrm["a:off"];
+      const ext = childXfrm["a:ext"];
+      if (off) {
+        el.x = parseEmuInt2(off["@_x"]) / EMU_PX;
+        el.y = parseEmuInt2(off["@_y"]) / EMU_PX;
+      }
+      if (ext) {
+        el.width = parseEmuInt2(ext["@_cx"]) / EMU_PX;
+        el.height = parseEmuInt2(ext["@_cy"]) / EMU_PX;
+      }
+    };
     const transformElement = (el) => {
       const relativeX = el.x - chX;
       const relativeY = el.y - chY;
@@ -52867,6 +52931,8 @@ var PptxHandlerRuntime67 = class _PptxHandlerRuntime extends PptxHandlerRuntime6
           `${baseId}-`
         );
         if (element) {
+          const childNode = this.ensureArray(group[entry.tag])[entry.indexInType];
+          applyRawChildGeometry(element, childNode);
           transformElement(element);
           elements.push(element);
         }
@@ -53416,6 +53482,40 @@ var PptxHandlerRuntime70 = class extends PptxHandlerRuntime69 {
     }
     return void 0;
   }
+  /**
+   * Reuse the cached parse of a layout XML part, parsing (and caching) on a
+   * miss. Background resolution runs per slide but the layout/master parts are
+   * large (a themed master can be ~200 KB); re-parsing them for every slide
+   * dominated load time, so share the same parsed object `getLayoutElements`
+   * already populated.
+   */
+  async resolveCachedLayoutXml(layoutPath) {
+    const cached = this.layoutXmlMap.get(layoutPath);
+    if (cached) {
+      return cached;
+    }
+    const xml = await this.zip.file(layoutPath)?.async("string");
+    if (!xml) {
+      return void 0;
+    }
+    const parsed = this.parser.parse(xml);
+    this.layoutXmlMap.set(layoutPath, parsed);
+    return parsed;
+  }
+  /** Reuse the cached parse of a master XML part, parsing (and caching) on a miss. */
+  async resolveCachedMasterXml(masterPath) {
+    const cached = this.masterXmlMap.get(masterPath);
+    if (cached) {
+      return cached;
+    }
+    const xml = await this.zip.file(masterPath)?.async("string");
+    if (!xml) {
+      return void 0;
+    }
+    const parsed = this.parser.parse(xml);
+    this.masterXmlMap.set(masterPath, parsed);
+    return parsed;
+  }
   async getMasterBackgroundImage(layoutPath) {
     const layoutRels = this.slideRelsMap.get(layoutPath);
     if (!layoutRels) {
@@ -53426,9 +53526,8 @@ var PptxHandlerRuntime70 = class extends PptxHandlerRuntime69 {
         const layoutDir = layoutPath.substring(0, layoutPath.lastIndexOf("/") + 1);
         const masterPath = target.startsWith("/") ? target.substring(1) : target.startsWith("..") ? this.resolvePath(layoutDir, target) : `ppt/${stripParentDirSegments(target)}`;
         try {
-          const masterXmlStr = await this.zip.file(masterPath)?.async("string");
-          if (masterXmlStr) {
-            const masterXmlObj = this.parser.parse(masterXmlStr);
+          const masterXmlObj = await this.resolveCachedMasterXml(masterPath);
+          if (masterXmlObj) {
             const masterRelsPath = `${masterPath.replace("slideMasters/", "slideMasters/_rels/")}.rels`;
             await this.loadSlideRelationships(masterPath, masterRelsPath);
             return this.extractBackgroundImage(masterXmlObj, masterPath, "p:sldMaster");
@@ -53450,9 +53549,8 @@ var PptxHandlerRuntime70 = class extends PptxHandlerRuntime69 {
         const slideDir = slidePath.substring(0, slidePath.lastIndexOf("/") + 1);
         const layoutPath = target.startsWith("/") ? target.substring(1) : target.startsWith("..") ? this.resolvePath(slideDir, target) : `ppt/${stripParentDirSegments(target)}`;
         try {
-          const layoutXmlStr = await this.zip.file(layoutPath)?.async("string");
-          if (layoutXmlStr) {
-            const layoutXmlObj = this.parser.parse(layoutXmlStr);
+          const layoutXmlObj = await this.resolveCachedLayoutXml(layoutPath);
+          if (layoutXmlObj) {
             const layoutRelsPath = `${layoutPath.replace("slideLayouts/", "slideLayouts/_rels/")}.rels`;
             await this.loadSlideRelationships(layoutPath, layoutRelsPath);
             const bg = this.extractBackgroundImage(layoutXmlObj, layoutPath, "p:sldLayout");
@@ -53478,9 +53576,8 @@ var PptxHandlerRuntime70 = class extends PptxHandlerRuntime69 {
         const slideDir = slidePath.substring(0, slidePath.lastIndexOf("/") + 1);
         const layoutPath = target.startsWith("/") ? target.substring(1) : target.startsWith("..") ? this.resolvePath(slideDir, target) : `ppt/${stripParentDirSegments(target)}`;
         try {
-          const layoutXmlStr = await this.zip.file(layoutPath)?.async("string");
-          if (layoutXmlStr) {
-            const layoutXmlObj = this.parser.parse(layoutXmlStr);
+          const layoutXmlObj = await this.resolveCachedLayoutXml(layoutPath);
+          if (layoutXmlObj) {
             const layoutBg = this.extractBackgroundColor(layoutXmlObj, "p:sldLayout");
             if (layoutBg) {
               return layoutBg;
@@ -53507,9 +53604,8 @@ var PptxHandlerRuntime70 = class extends PptxHandlerRuntime69 {
         const layoutDir = layoutPath.substring(0, layoutPath.lastIndexOf("/") + 1);
         const masterPath = target.startsWith("/") ? target.substring(1) : target.startsWith("..") ? this.resolvePath(layoutDir, target) : `ppt/${stripParentDirSegments(target)}`;
         try {
-          const masterXmlStr = await this.zip.file(masterPath)?.async("string");
-          if (masterXmlStr) {
-            const masterXmlObj = this.parser.parse(masterXmlStr);
+          const masterXmlObj = await this.resolveCachedMasterXml(masterPath);
+          if (masterXmlObj) {
             return this.extractBackgroundColor(masterXmlObj, "p:sldMaster");
           }
         } catch {
@@ -53536,9 +53632,8 @@ var PptxHandlerRuntime71 = class extends PptxHandlerRuntime70 {
         const slideDir = slidePath.substring(0, slidePath.lastIndexOf("/") + 1);
         const layoutPath = target.startsWith("/") ? target.substring(1) : target.startsWith("..") ? this.resolvePath(slideDir, target) : `ppt/${stripParentDirSegments(target)}`;
         try {
-          const layoutXmlStr = await this.zip.file(layoutPath)?.async("string");
-          if (layoutXmlStr) {
-            const layoutXmlObj = this.parser.parse(layoutXmlStr);
+          const layoutXmlObj = await this.resolveCachedLayoutXml(layoutPath);
+          if (layoutXmlObj) {
             const layoutGrad = this.extractBackgroundGradient(layoutXmlObj, "p:sldLayout");
             if (layoutGrad) {
               return layoutGrad;
@@ -53565,9 +53660,8 @@ var PptxHandlerRuntime71 = class extends PptxHandlerRuntime70 {
         const layoutDir = layoutPath.substring(0, layoutPath.lastIndexOf("/") + 1);
         const masterPath = target.startsWith("/") ? target.substring(1) : target.startsWith("..") ? this.resolvePath(layoutDir, target) : `ppt/${stripParentDirSegments(target)}`;
         try {
-          const masterXmlStr = await this.zip.file(masterPath)?.async("string");
-          if (masterXmlStr) {
-            const masterXmlObj = this.parser.parse(masterXmlStr);
+          const masterXmlObj = await this.resolveCachedMasterXml(masterPath);
+          if (masterXmlObj) {
             return this.extractBackgroundGradient(masterXmlObj, "p:sldMaster");
           }
         } catch {
@@ -54375,6 +54469,21 @@ var PptxHandlerRuntime74 = class extends PptxHandlerRuntime73 {
             element.id = `master-${element.id}`;
             elements.push(element);
           }
+        } else if (entry.tag === "p:grpSp") {
+          const groups = this.ensureArray(spTree["p:grpSp"]);
+          const group = groups[entry.indexInType];
+          if (!group) {
+            continue;
+          }
+          const element = await this.parseGroupShapeAsGroup(
+            group,
+            `master-group-${masterToken}-${entry.indexInType}`,
+            masterPath
+          );
+          if (element) {
+            element.id = `master-${element.id}`;
+            elements.push(element);
+          }
         }
       }
       this.masterCache.set(masterPath, elements);
@@ -54586,6 +54695,21 @@ var PptxHandlerRuntime76 = class extends PptxHandlerRuntime75 {
             element.id = `layout-${element.id}`;
             elements.push(element);
           }
+        } else if (entry.tag === "p:grpSp") {
+          const groups = this.ensureArray(spTree["p:grpSp"]);
+          const group = groups[entry.indexInType];
+          if (!group) {
+            continue;
+          }
+          const element = await this.parseGroupShapeAsGroup(
+            group,
+            `layout-group-${layoutToken}-${entry.indexInType}`,
+            layoutPath
+          );
+          if (element) {
+            element.id = `layout-${element.id}`;
+            elements.push(element);
+          }
         }
       }
       const layoutShowMasterSp = xmlAttr(

package/dist/cli/index.mjs

@@ -2687,14 +2687,52 @@ function extractSourceOrders(xml) {
   }
   return orders;
 }
+function ensureArrayLocal(value) {
+  return Array.isArray(value) ? value : value === void 0 ? [] : [value];
+}
+function countsSignature(counts) {
+  return [...counts.entries()].sort((a, b) => a[0] < b[0] ? -1 : 1).map(([name, count]) => `${name}:${count}`).join(",");
+}
+function pathSignature(path2) {
+  const counts = /* @__PURE__ */ new Map();
+  for (const key of Object.keys(path2)) {
+    const name = localName(key);
+    if (!PATH_COMMANDS.has(name)) {
+      continue;
+    }
+    counts.set(name, (counts.get(name) ?? 0) + ensureArrayLocal(path2[key]).length);
+  }
+  return countsSignature(counts);
+}
+function orderSignature(order) {
+  const counts = /* @__PURE__ */ new Map();
+  for (const name of order) {
+    counts.set(name, (counts.get(name) ?? 0) + 1);
+  }
+  return countsSignature(counts);
+}
 function annotateCustomGeometryCommandOrder(xml, parsed) {
   const orders = extractSourceOrders(xml);
   if (orders.length === 0) {
     return;
   }
   const paths = collectParsedPaths(parsed);
-  for (let index = 0; index < Math.min(paths.length, orders.length); index++) {
-    commandOrder.set(paths[index], orders[index]);
+  const ordersBySignature = /* @__PURE__ */ new Map();
+  for (const order of orders) {
+    const signature = orderSignature(order);
+    const bucket = ordersBySignature.get(signature);
+    if (bucket) {
+      bucket.push(order);
+    } else {
+      ordersBySignature.set(signature, [order]);
+    }
+  }
+  for (const path2 of paths) {
+    const bucket = ordersBySignature.get(pathSignature(path2));
+    const order = bucket?.shift();
+    if (order) {
+      commandOrder.set(path2, order);
+    }
   }
 }
 function orderedPathCommandEntries(path2, ensureArray16) {
@@ -49976,6 +50014,8 @@ var PptxHandlerRuntime56 = class extends PptxHandlerRuntime55 {
       const existing = merged[key];
       if (value && typeof value === "object" && !Array.isArray(value) && existing && typeof existing === "object" && !Array.isArray(existing)) {
         merged[key] = this.mergeXmlObjects(existing, value, depth + 1);
+      } else if (value === "" && existing !== void 0 && existing !== "" && typeof existing === "object") {
+        merged[key] = existing;
       } else {
         merged[key] = value;
       }
@@ -52758,32 +52798,56 @@ var PptxHandlerRuntime67 = class _PptxHandlerRuntime extends PptxHandlerRuntime6
     }
     const grpSpPr = group["p:grpSpPr"];
     const xfrm = grpSpPr?.["a:xfrm"];
+    const EMU_PX = _PptxHandlerRuntime.EMU_PER_PX;
     let parentX = 0, parentY = 0, parentW = 0, parentH = 0;
     let chX = 0, chY = 0, chW = 0, chH = 0;
     if (xfrm) {
       const off = xfrm["a:off"];
       if (off) {
-        parentX = Math.round(parseEmuInt2(off["@_x"]) / _PptxHandlerRuntime.EMU_PER_PX);
-        parentY = Math.round(parseEmuInt2(off["@_y"]) / _PptxHandlerRuntime.EMU_PER_PX);
+        parentX = parseEmuInt2(off["@_x"]) / EMU_PX;
+        parentY = parseEmuInt2(off["@_y"]) / EMU_PX;
       }
       const ext = xfrm["a:ext"];
       if (ext) {
-        parentW = Math.round(parseEmuInt2(ext["@_cx"]) / _PptxHandlerRuntime.EMU_PER_PX);
-        parentH = Math.round(parseEmuInt2(ext["@_cy"]) / _PptxHandlerRuntime.EMU_PER_PX);
+        parentW = parseEmuInt2(ext["@_cx"]) / EMU_PX;
+        parentH = parseEmuInt2(ext["@_cy"]) / EMU_PX;
       }
       const chOff = xfrm["a:chOff"];
       if (chOff) {
-        chX = Math.round(parseEmuInt2(chOff["@_x"]) / _PptxHandlerRuntime.EMU_PER_PX);
-        chY = Math.round(parseEmuInt2(chOff["@_y"]) / _PptxHandlerRuntime.EMU_PER_PX);
+        chX = parseEmuInt2(chOff["@_x"]) / EMU_PX;
+        chY = parseEmuInt2(chOff["@_y"]) / EMU_PX;
       }
       const chExt = xfrm["a:chExt"];
       if (chExt) {
-        chW = Math.round(parseEmuInt2(chExt["@_cx"]) / _PptxHandlerRuntime.EMU_PER_PX);
-        chH = Math.round(parseEmuInt2(chExt["@_cy"]) / _PptxHandlerRuntime.EMU_PER_PX);
+        chW = parseEmuInt2(chExt["@_cx"]) / EMU_PX;
+        chH = parseEmuInt2(chExt["@_cy"]) / EMU_PX;
       }
     }
     const scaleX = chW > 0 ? parentW / chW : 1;
     const scaleY = chH > 0 ? parentH / chH : 1;
+    const rawChildXfrm = (childNode) => {
+      if (!childNode) {
+        return void 0;
+      }
+      const childXfrm = childNode["p:spPr"]?.["a:xfrm"] ?? childNode["p:xfrm"];
+      return childXfrm;
+    };
+    const applyRawChildGeometry = (el, childNode) => {
+      const childXfrm = rawChildXfrm(childNode);
+      if (!childXfrm) {
+        return;
+      }
+      const off = childXfrm["a:off"];
+      const ext = childXfrm["a:ext"];
+      if (off) {
+        el.x = parseEmuInt2(off["@_x"]) / EMU_PX;
+        el.y = parseEmuInt2(off["@_y"]) / EMU_PX;
+      }
+      if (ext) {
+        el.width = parseEmuInt2(ext["@_cx"]) / EMU_PX;
+        el.height = parseEmuInt2(ext["@_cy"]) / EMU_PX;
+      }
+    };
     const transformElement = (el) => {
       const relativeX = el.x - chX;
       const relativeY = el.y - chY;
@@ -52841,6 +52905,8 @@ var PptxHandlerRuntime67 = class _PptxHandlerRuntime extends PptxHandlerRuntime6
           `${baseId}-`
         );
         if (element) {
+          const childNode = this.ensureArray(group[entry.tag])[entry.indexInType];
+          applyRawChildGeometry(element, childNode);
           transformElement(element);
           elements.push(element);
         }
@@ -53390,6 +53456,40 @@ var PptxHandlerRuntime70 = class extends PptxHandlerRuntime69 {
     }
     return void 0;
   }
+  /**
+   * Reuse the cached parse of a layout XML part, parsing (and caching) on a
+   * miss. Background resolution runs per slide but the layout/master parts are
+   * large (a themed master can be ~200 KB); re-parsing them for every slide
+   * dominated load time, so share the same parsed object `getLayoutElements`
+   * already populated.
+   */
+  async resolveCachedLayoutXml(layoutPath) {
+    const cached = this.layoutXmlMap.get(layoutPath);
+    if (cached) {
+      return cached;
+    }
+    const xml = await this.zip.file(layoutPath)?.async("string");
+    if (!xml) {
+      return void 0;
+    }
+    const parsed = this.parser.parse(xml);
+    this.layoutXmlMap.set(layoutPath, parsed);
+    return parsed;
+  }
+  /** Reuse the cached parse of a master XML part, parsing (and caching) on a miss. */
+  async resolveCachedMasterXml(masterPath) {
+    const cached = this.masterXmlMap.get(masterPath);
+    if (cached) {
+      return cached;
+    }
+    const xml = await this.zip.file(masterPath)?.async("string");
+    if (!xml) {
+      return void 0;
+    }
+    const parsed = this.parser.parse(xml);
+    this.masterXmlMap.set(masterPath, parsed);
+    return parsed;
+  }
   async getMasterBackgroundImage(layoutPath) {
     const layoutRels = this.slideRelsMap.get(layoutPath);
     if (!layoutRels) {
@@ -53400,9 +53500,8 @@ var PptxHandlerRuntime70 = class extends PptxHandlerRuntime69 {
         const layoutDir = layoutPath.substring(0, layoutPath.lastIndexOf("/") + 1);
         const masterPath = target.startsWith("/") ? target.substring(1) : target.startsWith("..") ? this.resolvePath(layoutDir, target) : `ppt/${stripParentDirSegments(target)}`;
         try {
-          const masterXmlStr = await this.zip.file(masterPath)?.async("string");
-          if (masterXmlStr) {
-            const masterXmlObj = this.parser.parse(masterXmlStr);
+          const masterXmlObj = await this.resolveCachedMasterXml(masterPath);
+          if (masterXmlObj) {
             const masterRelsPath = `${masterPath.replace("slideMasters/", "slideMasters/_rels/")}.rels`;
             await this.loadSlideRelationships(masterPath, masterRelsPath);
             return this.extractBackgroundImage(masterXmlObj, masterPath, "p:sldMaster");
@@ -53424,9 +53523,8 @@ var PptxHandlerRuntime70 = class extends PptxHandlerRuntime69 {
         const slideDir = slidePath.substring(0, slidePath.lastIndexOf("/") + 1);
         const layoutPath = target.startsWith("/") ? target.substring(1) : target.startsWith("..") ? this.resolvePath(slideDir, target) : `ppt/${stripParentDirSegments(target)}`;
         try {
-          const layoutXmlStr = await this.zip.file(layoutPath)?.async("string");
-          if (layoutXmlStr) {
-            const layoutXmlObj = this.parser.parse(layoutXmlStr);
+          const layoutXmlObj = await this.resolveCachedLayoutXml(layoutPath);
+          if (layoutXmlObj) {
             const layoutRelsPath = `${layoutPath.replace("slideLayouts/", "slideLayouts/_rels/")}.rels`;
             await this.loadSlideRelationships(layoutPath, layoutRelsPath);
             const bg = this.extractBackgroundImage(layoutXmlObj, layoutPath, "p:sldLayout");
@@ -53452,9 +53550,8 @@ var PptxHandlerRuntime70 = class extends PptxHandlerRuntime69 {
         const slideDir = slidePath.substring(0, slidePath.lastIndexOf("/") + 1);
         const layoutPath = target.startsWith("/") ? target.substring(1) : target.startsWith("..") ? this.resolvePath(slideDir, target) : `ppt/${stripParentDirSegments(target)}`;
         try {
-          const layoutXmlStr = await this.zip.file(layoutPath)?.async("string");
-          if (layoutXmlStr) {
-            const layoutXmlObj = this.parser.parse(layoutXmlStr);
+          const layoutXmlObj = await this.resolveCachedLayoutXml(layoutPath);
+          if (layoutXmlObj) {
             const layoutBg = this.extractBackgroundColor(layoutXmlObj, "p:sldLayout");
             if (layoutBg) {
               return layoutBg;
@@ -53481,9 +53578,8 @@ var PptxHandlerRuntime70 = class extends PptxHandlerRuntime69 {
         const layoutDir = layoutPath.substring(0, layoutPath.lastIndexOf("/") + 1);
         const masterPath = target.startsWith("/") ? target.substring(1) : target.startsWith("..") ? this.resolvePath(layoutDir, target) : `ppt/${stripParentDirSegments(target)}`;
         try {
-          const masterXmlStr = await this.zip.file(masterPath)?.async("string");
-          if (masterXmlStr) {
-            const masterXmlObj = this.parser.parse(masterXmlStr);
+          const masterXmlObj = await this.resolveCachedMasterXml(masterPath);
+          if (masterXmlObj) {
             return this.extractBackgroundColor(masterXmlObj, "p:sldMaster");
           }
         } catch {
@@ -53510,9 +53606,8 @@ var PptxHandlerRuntime71 = class extends PptxHandlerRuntime70 {
         const slideDir = slidePath.substring(0, slidePath.lastIndexOf("/") + 1);
         const layoutPath = target.startsWith("/") ? target.substring(1) : target.startsWith("..") ? this.resolvePath(slideDir, target) : `ppt/${stripParentDirSegments(target)}`;
         try {
-          const layoutXmlStr = await this.zip.file(layoutPath)?.async("string");
-          if (layoutXmlStr) {
-            const layoutXmlObj = this.parser.parse(layoutXmlStr);
+          const layoutXmlObj = await this.resolveCachedLayoutXml(layoutPath);
+          if (layoutXmlObj) {
             const layoutGrad = this.extractBackgroundGradient(layoutXmlObj, "p:sldLayout");
             if (layoutGrad) {
               return layoutGrad;
@@ -53539,9 +53634,8 @@ var PptxHandlerRuntime71 = class extends PptxHandlerRuntime70 {
         const layoutDir = layoutPath.substring(0, layoutPath.lastIndexOf("/") + 1);
         const masterPath = target.startsWith("/") ? target.substring(1) : target.startsWith("..") ? this.resolvePath(layoutDir, target) : `ppt/${stripParentDirSegments(target)}`;
         try {
-          const masterXmlStr = await this.zip.file(masterPath)?.async("string");
-          if (masterXmlStr) {
-            const masterXmlObj = this.parser.parse(masterXmlStr);
+          const masterXmlObj = await this.resolveCachedMasterXml(masterPath);
+          if (masterXmlObj) {
             return this.extractBackgroundGradient(masterXmlObj, "p:sldMaster");
           }
         } catch {
@@ -54349,6 +54443,21 @@ var PptxHandlerRuntime74 = class extends PptxHandlerRuntime73 {
             element.id = `master-${element.id}`;
             elements.push(element);
           }
+        } else if (entry.tag === "p:grpSp") {
+          const groups = this.ensureArray(spTree["p:grpSp"]);
+          const group = groups[entry.indexInType];
+          if (!group) {
+            continue;
+          }
+          const element = await this.parseGroupShapeAsGroup(
+            group,
+            `master-group-${masterToken}-${entry.indexInType}`,
+            masterPath
+          );
+          if (element) {
+            element.id = `master-${element.id}`;
+            elements.push(element);
+          }
         }
       }
       this.masterCache.set(masterPath, elements);
@@ -54560,6 +54669,21 @@ var PptxHandlerRuntime76 = class extends PptxHandlerRuntime75 {
             element.id = `layout-${element.id}`;
             elements.push(element);
           }
+        } else if (entry.tag === "p:grpSp") {
+          const groups = this.ensureArray(spTree["p:grpSp"]);
+          const group = groups[entry.indexInType];
+          if (!group) {
+            continue;
+          }
+          const element = await this.parseGroupShapeAsGroup(
+            group,
+            `layout-group-${layoutToken}-${entry.indexInType}`,
+            layoutPath
+          );
+          if (element) {
+            element.id = `layout-${element.id}`;
+            elements.push(element);
+          }
         }
       }
       const layoutShowMasterSp = xmlAttr(

package/dist/converter/index.d.ts

@@ -1,2 +1,2 @@
-import { _ as FileSystemAdapter, a as SlideProcessorOptions, c as DocumentConverter, d as normalizePath, f as MediaContext, g as ConversionResult, h as ConversionOptions, i as SlideProcessor, l as deriveOutputPath, m as generateMediaFilename, n as SvgExporter, o as PptxConverterOptions, p as dataUrlToMediaBytes, r as SlideMetadataRenderer, s as PptxMarkdownConverter, t as SvgExportOptions, u as getDirectory } from "../index-BmCX2W7T.js";
+import { _ as FileSystemAdapter, a as SlideProcessorOptions, c as DocumentConverter, d as normalizePath, f as MediaContext, g as ConversionResult, h as ConversionOptions, i as SlideProcessor, l as deriveOutputPath, m as generateMediaFilename, n as SvgExporter, o as PptxConverterOptions, p as dataUrlToMediaBytes, r as SlideMetadataRenderer, s as PptxMarkdownConverter, t as SvgExportOptions, u as getDirectory } from "../index-jDlq3aEH.js";
 export { type ConversionOptions, type ConversionResult, DocumentConverter, type FileSystemAdapter, MediaContext, type PptxConverterOptions, PptxMarkdownConverter, SlideMetadataRenderer, SlideProcessor, type SlideProcessorOptions, type SvgExportOptions, SvgExporter, dataUrlToMediaBytes, deriveOutputPath, generateMediaFilename, getDirectory, normalizePath };