pptx-viewer-core 1.2.4 → 1.2.5

package/dist/index.mjs

@@ -7170,6 +7170,32 @@ function findAinkInkPayload(graphicData) {
   }
   return void 0;
 }
+function findOleObjPayload(graphicData) {
+  if (!graphicData) {
+    return void 0;
+  }
+  const direct = graphicData["p:oleObj"];
+  if (direct) {
+    return direct;
+  }
+  const altContent = graphicData["mc:AlternateContent"];
+  if (!altContent) {
+    return void 0;
+  }
+  const fallback = altContent["mc:Fallback"];
+  const fallbackOleObj = fallback?.["p:oleObj"];
+  if (fallbackOleObj) {
+    return fallbackOleObj;
+  }
+  const choices = ensureArrayLike(altContent["mc:Choice"]);
+  for (const choice of choices) {
+    const node = choice?.["p:oleObj"];
+    if (node) {
+      return node;
+    }
+  }
+  return void 0;
+}
 function decodeAinkInk(inkRoot) {
   const inkPaths = [];
   const inkColors = [];
@@ -7282,7 +7308,7 @@ var PptxGraphicFrameParser = class {
         };
       }
       if (type === "ole" && graphicData) {
-        const oleObject = graphicData["p:oleObj"];
+        const oleObject = findOleObjPayload(graphicData);
         const oleProgId = String(oleObject?.["@_progId"] || "").trim() || void 0;
         const oleName = String(oleObject?.["@_name"] || "").trim() || void 0;
         const oleClsId = String(oleObject?.["@_classid"] || "").trim() || void 0;
@@ -7373,7 +7399,7 @@ var PptxGraphicFrameParser = class {
     if (graphicData["dgm:relIds"] || uri.includes("/drawingml/2006/diagram")) {
       return "smartArt";
     }
-    if (graphicData["p:oleObj"] || uri.includes("/drawingml/2006/ole")) {
+    if (uri.includes("/presentationml/2006/ole") || uri.includes("/drawingml/2006/ole") || findOleObjPayload(graphicData)) {
       return "ole";
     }
     if (graphicData["a:videoFile"] || graphicData["a:audioFile"] || uri.includes("/drawingml/2006/media")) {
@@ -8674,6 +8700,87 @@ function parseGuideNode(node) {
   return { id, orientation, positionEmu, color };
 }
 
+// src/core/services/animation-target-reconcile.ts
+var NV_CONTAINERS = [
+  "p:nvSpPr",
+  "p:nvPicPr",
+  "p:nvCxnSpPr",
+  "p:nvGraphicFramePr",
+  "p:nvGrpSpPr"
+];
+function readCnvPrId(rawXml) {
+  if (!rawXml) {
+    return void 0;
+  }
+  for (const nvKey of NV_CONTAINERS) {
+    const nv = rawXml[nvKey];
+    const cNvPr = nv?.["p:cNvPr"];
+    const id = cNvPr?.["@_id"];
+    if (id !== void 0 && id !== null && String(id).length > 0) {
+      return String(id);
+    }
+  }
+  return void 0;
+}
+function isTemplateElementId(elementId) {
+  return elementId.startsWith("layout-") || elementId.startsWith("master-");
+}
+function collectShapeIdMap(elements) {
+  const map = /* @__PURE__ */ new Map();
+  const walk = (els) => {
+    for (const el of els) {
+      const cnvId = readCnvPrId(el.rawXml);
+      if (cnvId) {
+        el.shapeId = cnvId;
+        if (!isTemplateElementId(el.id)) {
+          map.set(cnvId, el.id);
+        }
+      }
+      if (el.type === "group" && Array.isArray(el.children)) {
+        walk(el.children);
+      }
+    }
+  };
+  walk(elements);
+  return map;
+}
+function reconcileAnimationTargets(elements, nativeAnimations, editorAnimations) {
+  const map = collectShapeIdMap(elements);
+  if (map.size === 0) {
+    return;
+  }
+  if (nativeAnimations) {
+    for (const anim of nativeAnimations) {
+      if (anim.targetId !== void 0) {
+        const resolved = map.get(anim.targetId);
+        if (resolved) {
+          anim.targetId = resolved;
+        }
+      }
+      if (anim.triggerShapeId !== void 0) {
+        const resolved = map.get(anim.triggerShapeId);
+        if (resolved) {
+          anim.triggerShapeId = resolved;
+        }
+      }
+    }
+  }
+  if (editorAnimations) {
+    for (const anim of editorAnimations) {
+      const resolvedElement = map.get(anim.elementId);
+      if (resolvedElement) {
+        anim.elementId = resolvedElement;
+      }
+      if (anim.triggerShapeId !== void 0) {
+        const resolvedTrigger = map.get(anim.triggerShapeId);
+        if (resolvedTrigger) {
+          anim.triggerShapeId = resolvedTrigger;
+        }
+      }
+    }
+  }
+}
+
 // src/core/services/PptxSlideLoaderService.ts
 var PptxSlideLoaderService = class {
   /**
@@ -8814,6 +8921,7 @@ var PptxSlideLoaderService = class {
       const transition = params.parseSlideTransition(slideXmlObj, path);
       const animations = params.parseEditorAnimations(slideXmlObj);
       const nativeAnimations = params.parseNativeAnimations(slideXmlObj);
+      reconcileAnimationTargets(elements, nativeAnimations, animations);
       const rawTiming = slideXmlObj["p:sld"]?.["p:timing"];
       const drawingGuides = parseSlideDrawingGuides(slideXmlObj);
       const customerData = await params.parseSlideCustomerData(slideXmlObj, path);
@@ -9313,6 +9421,60 @@ var PptxEditorAnimationService = class {
   }
 };
 
+// src/core/services/animation-shape-id-assign.ts
+function flattenElements(elements, out) {
+  for (const el of elements) {
+    out.push(el);
+    if (el.type === "group" && Array.isArray(el.children)) {
+      flattenElements(el.children, out);
+    }
+  }
+}
+function maxShapeId(elements) {
+  let max = 0;
+  for (const el of elements) {
+    if (el.shapeId !== void 0) {
+      const n = Number.parseInt(el.shapeId, 10);
+      if (Number.isFinite(n) && n > max) {
+        max = n;
+      }
+    }
+  }
+  return max;
+}
+function remapEditorAnimationsToShapeIds(elements, animations, reservedMaxId = 0) {
+  const flat = [];
+  flattenElements(elements, flat);
+  const byId = /* @__PURE__ */ new Map();
+  for (const el of flat) {
+    byId.set(el.id, el);
+  }
+  let nextId2 = Math.max(maxShapeId(flat), reservedMaxId) + 1;
+  const resolve = (elementId) => {
+    const el = byId.get(elementId);
+    if (!el) {
+      return void 0;
+    }
+    if (el.shapeId === void 0) {
+      el.shapeId = String(nextId2);
+      nextId2 += 1;
+    }
+    return el.shapeId;
+  };
+  return animations.map((anim) => {
+    const resolvedElement = resolve(anim.elementId);
+    const resolvedTrigger = anim.triggerShapeId !== void 0 ? resolve(anim.triggerShapeId) : void 0;
+    if (resolvedElement === void 0 && resolvedTrigger === void 0) {
+      return anim;
+    }
+    return {
+      ...anim,
+      elementId: resolvedElement ?? anim.elementId,
+      triggerShapeId: resolvedTrigger ?? anim.triggerShapeId
+    };
+  });
+}
+
 // src/core/services/native-animation-helpers.ts
 function extractSoundAction(cTn) {
   const stSnd = cTn["p:stSnd"];
@@ -10535,7 +10697,7 @@ var PptxSlideTransitionService = class {
   }
   parseSlideTransition(slideXml2) {
     const slideRoot = this.xmlLookupService.getChildByLocalName(slideXml2, "sld");
-    const transitionNode = this.xmlLookupService.getChildByLocalName(slideRoot, "transition");
+    const transitionNode = this.xmlLookupService.getChildByLocalName(slideRoot, "transition") || this.findTransitionInAlternateContent(slideRoot);
     if (!transitionNode) {
       return void 0;
     }
@@ -10607,7 +10769,8 @@ var PptxSlideTransitionService = class {
         transitionType = "morph";
       }
     }
-    const parsedDuration = Number.parseInt(String(transitionNode["@_dur"] || ""), 10);
+    const rawDuration = transitionNode["@_dur"] ?? transitionNode["@_p14:dur"];
+    const parsedDuration = Number.parseInt(String(rawDuration || ""), 10);
     const durationMs = Number.isFinite(parsedDuration) && parsedDuration > 0 ? parsedDuration : void 0;
     const advanceOnClickToken = String(transitionNode["@_advClick"] || "").trim();
     const advanceOnClick = advanceOnClickToken.length > 0 ? !["0", "false", "off"].includes(advanceOnClickToken.toLowerCase()) : void 0;
@@ -10656,6 +10819,35 @@ var PptxSlideTransitionService = class {
       rawExtLst
     };
   }
+  /**
+   * Locate a `<p:transition>` wrapped in a slide-root `mc:AlternateContent`
+   * envelope.
+   *
+   * Real PowerPoint (verified via COM-authored fixtures) wraps the
+   * transition in `mc:AlternateContent` whenever it carries an Office
+   * 2010+ attribute such as `p14:dur` (sub-second transition duration):
+   * an `mc:Choice Requires="p14"` branch carries the richer transition,
+   * and `mc:Fallback` carries a plain one for older readers. Without this
+   * unwrap, `p:sld`'s direct-child lookup for `transition` finds nothing
+   * and the whole transition (including plain ones falling back with no
+   * p14 data) is silently dropped, even though `mc:Choice` is otherwise a
+   * complete, directly usable `p:transition` node.
+   */
+  findTransitionInAlternateContent(slideRoot) {
+    const altContent = this.xmlLookupService.getChildByLocalName(slideRoot, "AlternateContent");
+    if (!altContent) {
+      return void 0;
+    }
+    const choices = this.xmlLookupService.getChildrenArrayByLocalName(altContent, "Choice");
+    for (const choice of choices) {
+      const transitionNode = this.xmlLookupService.getChildByLocalName(choice, "transition");
+      if (transitionNode) {
+        return transitionNode;
+      }
+    }
+    const fallback = this.xmlLookupService.getChildByLocalName(altContent, "Fallback");
+    return this.xmlLookupService.getChildByLocalName(fallback, "transition");
+  }
   /**
    * Detects the PowerPoint 2016+ `morph` transition stored as a p159 extension
    * inside the transition's extLst.
@@ -36610,6 +36802,22 @@ var PptxHandlerRuntime32 = class _PptxHandlerRuntime extends PptxHandlerRuntime3
 
 // src/core/core/runtime/PptxHandlerRuntimeSaveElementWriter.ts
 var PptxHandlerRuntime33 = class _PptxHandlerRuntime extends PptxHandlerRuntime32 {
+  /**
+   * Whether a shape XML represents a `<p:pic>` (picture-shaped) node.
+   *
+   * Real PowerPoint (verified via COM-authored fixtures) represents video
+   * *and* audio media as `<p:pic>` (poster-frame blip + `p:nvPr/a:videoFile`
+   * or `a:audioFile` + a `p14:media` extension) rather than the older
+   * `<p:graphicFrame>` form. A `media`-typed element's `rawXml` is
+   * therefore frequently `p:pic`-shaped, not a graphic frame; without this
+   * check it falls into the generic `shapes` bucket, which the slide
+   * writer serializes under `<p:sp>` -- corrupting the picture markup
+   * (`p:nvPicPr`/`p:blipFill`) into an invalid shape and permanently
+   * losing the media relationship on save.
+   */
+  isPictureShape(shape) {
+    return Boolean(shape["p:nvPicPr"]);
+  }
   /** Whether a shape XML represents a graphic frame. */
   isGraphicFrameShape(shape) {
     return Boolean(shape["p:nvGraphicFramePr"] || shape["a:graphic"] && shape["p:xfrm"]);
@@ -36725,6 +36933,34 @@ var PptxHandlerRuntime33 = class _PptxHandlerRuntime extends PptxHandlerRuntime3
   isTemplateElementId(elementId) {
     return elementId.startsWith("layout-") || elementId.startsWith("master-");
   }
+  /** Non-visual property containers that hold a `p:cNvPr`. */
+  static NV_CONTAINERS = [
+    "p:nvSpPr",
+    "p:nvPicPr",
+    "p:nvCxnSpPr",
+    "p:nvGraphicFramePr",
+    "p:nvGrpSpPr"
+  ];
+  /**
+   * Write an element's native shape id (`element.shapeId`) into the serialized
+   * shape's `p:cNvPr/@id`. Animation targets (`p:spTgt/@spid`) reference this
+   * id, so the two must agree for PowerPoint to bind an animation to its shape.
+   * A no-op when the element carries no `shapeId` (nothing to reconcile) or the
+   * shape XML has no cNvPr container.
+   */
+  applyShapeIdToCnvPr(shape, el) {
+    if (el.shapeId === void 0) {
+      return;
+    }
+    for (const nvKey of _PptxHandlerRuntime.NV_CONTAINERS) {
+      const nv = shape[nvKey];
+      const cNvPr = nv?.["p:cNvPr"];
+      if (cNvPr) {
+        cNvPr["@_id"] = el.shapeId;
+        return;
+      }
+    }
+  }
   /**
    * Process a single slide element during save. Handles embedding,
    * transforms, geometry, styles, text, and sorts into collectors.
@@ -36834,12 +37070,15 @@ var PptxHandlerRuntime33 = class _PptxHandlerRuntime extends PptxHandlerRuntime3
       }
       return;
     }
+    this.applyShapeIdToCnvPr(shape, el);
     if (el.type === "picture" || el.type === "image") {
       collectors.pics.push(shape);
     } else if (el.type === "connector") {
       collectors.connectors.push(shape);
     } else if (el.type === "model3d") {
       collectors.model3ds.push(shape);
+    } else if (el.type === "media" && this.isPictureShape(shape)) {
+      collectors.pics.push(shape);
     } else if (this.isGraphicFrameShape(shape)) {
       collectors.graphicFrames.push(shape);
     } else {
@@ -36878,12 +37117,17 @@ var PptxHandlerRuntime34 = class extends PptxHandlerRuntime33 {
         delete slideNode["p:transition"];
       }
     }
-    if (slide.animations !== void 0) {
-      this.applyEditorAnimations(slideNode, slide.animations);
+    const shapeIdAnimations = slide.animations !== void 0 ? remapEditorAnimationsToShapeIds(
+      slide.elements,
+      slide.animations,
+      this.maxCnvPrId(this.ensureSlideTree(xmlObj))
+    ) : void 0;
+    if (shapeIdAnimations !== void 0) {
+      this.applyEditorAnimations(slideNode, shapeIdAnimations);
     }
-    if (slide.animations && slide.animations.length > 0) {
+    if (shapeIdAnimations && shapeIdAnimations.length > 0) {
       const generatedTiming = this.animationWriteService.buildTimingXml(
-        slide.animations,
+        shapeIdAnimations,
         slide.rawTiming
       );
       if (generatedTiming) {
@@ -37036,6 +37280,40 @@ var PptxHandlerRuntime34 = class extends PptxHandlerRuntime33 {
     }
     this.zip.file(slide.id, this.builder.build(xmlObj));
   }
+  /**
+   * Largest `p:cNvPr/@id` already present anywhere in a shape tree, including
+   * the implicit `<p:spTree>` group's own reserved id. Used to seed minting of
+   * fresh animation-target shape ids so they never collide with a reserved id.
+   */
+  maxCnvPrId(spTree) {
+    let max = 0;
+    const nvContainers = [
+      "p:nvSpPr",
+      "p:nvPicPr",
+      "p:nvCxnSpPr",
+      "p:nvGraphicFramePr",
+      "p:nvGrpSpPr"
+    ];
+    const visit = (node) => {
+      for (const nvKey of nvContainers) {
+        const nv = node[nvKey];
+        const cNvPr = nv?.["p:cNvPr"];
+        if (cNvPr?.["@_id"] !== void 0) {
+          const n = Number.parseInt(String(cNvPr["@_id"]), 10);
+          if (Number.isFinite(n) && n > max) {
+            max = n;
+          }
+        }
+      }
+      for (const listKey of ["p:sp", "p:pic", "p:cxnSp", "p:graphicFrame", "p:grpSp"]) {
+        for (const child of this.ensureArray(node[listKey])) {
+          visit(child);
+        }
+      }
+    };
+    visit(spTree);
+    return max;
+  }
   /**
    * Re-wrap selected children with their original `<mc:AlternateContent>`
    * envelope (CC-4).
@@ -46754,7 +47032,22 @@ var PptxHandlerRuntime79 = class _PptxHandlerRuntime extends PptxHandlerRuntime7
         await this.enrichOleElementsWithEmbeddedData(el.children, slidePath, depth + 1);
         continue;
       }
-      if (el.type !== "ole" || el.isLinked || !el.oleTarget) {
+      if (el.type !== "ole") {
+        continue;
+      }
+      if (el.previewImage && !el.previewImageData) {
+        try {
+          const previewPath = this.resolveImagePath(slidePath, el.previewImage);
+          if (previewPath) {
+            const previewData = await this.getImageData(previewPath);
+            if (previewData) {
+              el.previewImageData = previewData;
+            }
+          }
+        } catch {
+        }
+      }
+      if (el.isLinked || !el.oleTarget) {
         continue;
       }
       try {
@@ -65013,4 +65306,4 @@ var SvgExporter = class _SvgExporter {
  *     `<p:extLst>` (optional)
  */
 
-export { ALL_ANIMATION_PRESETS, BLIP_FILL_ORDER, CLOUD_CALLOUT_TAIL_COUNT, CLOUD_LOBE_COUNT, COLOR_MAP_ALIAS_KEYS, CONNECTOR_ARROW_OPTIONS, CONNECTOR_GEOMETRY_OPTIONS, ChartBuilder, ConnectorBuilder, ConnectorXmlFactory, DEFAULT_CANVAS_HEIGHT, DEFAULT_CANVAS_WIDTH, DEFAULT_COLOR_MAP, DEFAULT_FILL_COLOR, DEFAULT_FONT_FAMILY, DEFAULT_MAX_UNCOMPRESSED_BYTES, DEFAULT_SCHEME_COLOR_MAP, DEFAULT_STROKE_COLOR, DEFAULT_TEXT_COLOR, DEFAULT_TEXT_FONT_SIZE, DIGEST_ALGORITHM_TO_HASH, DIGEST_ALGORITHM_TO_WEB_CRYPTO, DIGITAL_SIGNATURE_ORIGIN_REL_TYPE, DIGITAL_SIGNATURE_REL_TYPE, DataIntegrityError, DocumentConverter, EFFECT_LST_ORDER, EMPHASIS_PRESETS, EMU_PER_INCH, EMU_PER_PIXEL2 as EMU_PER_PIXEL, EMU_PER_POINT, EMU_PER_PX, ENTERPRISE_FAIL_ON_REVOCATION_UNKNOWN_ENV, ENTERPRISE_REQUIRE_REVOCATION_ENV, ENTERPRISE_REQUIRE_TIMESTAMP_ENV, ENTERPRISE_TRUST_ROOTS_FILE_ENV, ENTERPRISE_TRUST_ROOTS_PEM_ENV, ENTRANCE_PRESETS, EXIT_PRESETS, EncryptedFileError, FONT_SUBSTITUTION_MAP, FreeformPathBuilder, GroupBuilder, ImageBuilder, IncorrectPasswordError, MAX_TABLE_DIMENSION, MAX_ZIP_ENTRY_COUNT, MIN_ELEMENT_SIZE, MIN_TABLE_DIMENSION, MOTION_PATH_PRESETS, MediaBuilder, MediaContext, MediaGraphicFrameXmlFactory, OOXML_TO_PRESET_EMPH, OOXML_TO_PRESET_ENTR, OOXML_TO_PRESET_EXIT, OPC_RELATIONSHIP_TRANSFORM, Ole2ParseError, P14_GUIDE_URI, P15_GUIDE_URI, PANOSE_FAMILY_MAP, PANOSE_MONOSPACE_PROPORTION, PANOSE_SANS_SERIF_STYLES, PANOSE_WEIGHT_MAP, POWERPOINT_PRESENCE_KEY, PPTX_VIEWER_MANIFEST_NS, PRESET_COLOR_MAP, PRESET_SHAPE_CATEGORY_LABELS, PRESET_SHAPE_CLIP_PATHS, PRESET_SHAPE_DEFINITIONS, PRESET_SHAPE_GEOMETRY_TABLE, PRESET_TO_OOXML, PictureXmlFactory, PptxAnimationWriteService, PptxColorStyleCodec, PptxCommentAuthorsXmlFactory, PptxCommentXmlFactoryProvider, PptxCompatibilityService, PptxConnectorParser, PptxContentTypesBuilder, PptxDocumentPropertiesUpdater, PptxEditorAnimationService, PptxElementTransformUpdater, PptxElementXmlBuilder, PptxGraphicFrameParser, PptxHandler, PptxHandlerRuntime82 as PptxHandlerRuntime, PptxHandlerRuntimeFactory, PptxLoadDataBuilder, PptxMarkdownConverter, PptxMediaDataParser, PptxNativeAnimationService, PptxPresentationSaveBuilder, PptxPresentationSlidesReconciler, PptxRuntimeDependencyFactory, PptxSaveConstantsFactory, PptxSaveState as PptxSaveSession, PptxSaveStateBuilder as PptxSaveSessionBuilder, PptxSaveState, PptxSaveStateBuilder, PptxShapeIdValidator, PptxShapeStyleExtractor, PptxSlideBackgroundBuilder, PptxSlideBuilder, PptxSlideCommentPartWriter, PptxSlideCommentsXmlFactory, PptxSlideElementsBuilder, PptxSlideLoaderService, PptxSlideMediaRelationshipBuilder, PptxSlideNotesBuilder, PptxSlideNotesPartUpdater, PptxSlideRelationshipRegistry, PptxSlideTransitionService, PptxTableDataParser, PptxTemplateBackgroundService, PptxXmlBuilder, PptxXmlFactoryProvider, PptxXmlLookupService, Presentation, PresentationBuilder, SHAPE_TREE_ELEMENT_TAGS, SP_PR_ORDER, STROKE_DASH_OPTIONS, SUPPORTED_XML_CANON_TRANSFORMS, SWITCHABLE_LAYOUT_TYPES, SYSTEM_COLOR_MAP, ShapeBuilder, SlideBuilder, SlideProcessor, SlideSizes, SvgExporter, TC_PR_BORDERS_ORDER, THEME_COLOR_SCHEME_KEYS, THEME_PRESETS, TRANSITION_VALID_DIRECTIONS, TableBuilder, TextBuilder, TextShapeXmlFactory, ThemePresets, VML_SHAPE_TAGS, XMLDSIG_NS, XML_TRANSFORM_ENVELOPED_SIGNATURE, ZipBombError, addChartCategory, addChartSeries, addSection, addSmartArtNode, addSmartArtNodeAsChild, applyDrawingColorTransforms, applyKinsokuToXml, applyTableCellTextAndStyle, applyTemplate, applyThemeToData, areNamespacesSupported, buildCalloutLeaderLineSvgPath, buildClrMapOverrideXml, buildFontFamilyString, buildGuideListExtension, buildLinkedTextBoxChains, buildOle2, buildSingleEffectNode, buildSrgbColorChoice, buildThemeColorMap, catmullRomToBezier, chartDataAddCategory, chartDataAddSeries, chartDataChangeType, chartDataRemoveCategory, chartDataRemoveSeries, chartDataUpdatePoint, checkBlankSlide, checkComplexTables, checkDuplicateTitles, checkLowContrast, checkMissingAltText, checkMissingSlideTitle, checkPresentation, clampUnitInterval, classifyPanose, cloneElement, cloneShapeStyle, cloneSlide, cloneTemplateElementsBySlideId, cloneTextStyle, cloneXmlObject, cm, cmToEmu, colorWithOpacity, colorsEqual, combineShapes, computeContrastRatio, computeCycleLayout, computeDetailStatus, computeDigestBase64 as computeDigestBase64WebCrypto, computeHierarchyLayout, computeLinearLayout, computeMatrixLayout, computePyramidLayout, computeSmartArtLayout, computeSnakeLayout, computeVerificationStatus, convertXmlToStrict, createArrayBufferCopy, createBuiltinVariables, createChartElement, createConnectorElement, createDefaultPptxHandlerRuntime, createEditorId, createFreeformElement, createGroupElement, createImageElement, createLayout, createLayouts, createMediaElement, createModifyVerifier, createPptxSaveConstants, createShapeElement, createTableCellXml, createTableElement, createTableGraphicFrameRawXml, createTemplateConnectorRawXml, createTemplateShapeRawXml, createTextElement, createUniformTextSegments, dataUrlToMediaBytes, decodeOle10Native, decodeXmlEntities, decomposeSmartArt, decryptPptx, demoteSmartArtNode, deobfuscateFont, deriveOutputPath, detectDigitalSignatures, detectFileFormat, detectFontFormat, detectOleObjectType, detectStrictConformance, diffPresentations, diffSlides, distributeSegmentsAcrossChain, douglasPeucker, duplicateElement, duplicateSlide, elementActionToPptxAction, elementHasAction, emuToPixels, encryptPptx, ensureArrayValue, escapeXmlAttr, escapeXmlText, estimateTextBoxCapacity, evaluateGeometryPaths, evaluateGuides, evaluatePresetShape, extractAllTagText, extractColorChoiceXml, extractFirstTagText, extractGuidFromPartName, extractModel3DTransform, extractTagAttribute, fetchUrlToBytes, findCustomShow, findLayoutByName, findLayoutByType, findPlaceholders, findText, formatCommentTimestamp, fragmentShapes, generateFontGuid, generateLayoutXml, generateMediaFilename, getAdjustmentAwareClipPath, getAdjustmentAwareShapeClipPath, getAnimationPresetInfo, getCalloutLeaderLineGeometry, getCalloutTier, getCalloutViewBoxBounds, getCloudCalloutClipPath, getCloudClipPath, getCloudPathForRendering, getCommentMarkerPosition, getConnectorAdjustment, getConnectorPathGeometry, getCssBorderDashStyle, getCustomShowNames, getCustomShowPositionLabel, getDirectory, getElementLabel, getElementTextContent, getElementTransform, getImageMaskStyle, getLinkedTextBoxSegments, getNativeAnimationPresetMetadata, getOleObjectTypeLabel, getPanoseWeight, getPresetShapeClipPath, getPresetsByCategory, getRoundRectRadiusPx, getSectionForSlide, getSectionSlideRange, getShapeClipPath, getShapeClipPathFromPreset, getShapeType, getSignaturePathsToStrip, getSubstituteFontFamily, getSubstituteFonts, getSupportedNamespaces, getSvgStrokeDasharray, getTextCompensationTransform, getThemePreset, getZoomElements, getZoomTargetSlideIndexes, guidToKey, guideEmuToPx, guidePxToEmu, hasDirectSubstitution, hasNonTrivialOverride, hasShapeProperties, hasTextProperties, hexToRgbChannels, hslToRgb, inches, inchesToEmu, inferOleExtensionFromTarget, interpolateShapeGeometry, intersectPolygons, intersectShapes, intersectSvgPaths, isCalloutShape, isConnectorElement, isEditableTextElement, isImageLikeElement, isInkElement, isNamespaceSupported, isOle2CompoundFile, isShapeElement, isStrictNamespaceUri, isSummaryZoomSlide, isSwitchableLayoutType, isTemplateElement, isTextElement, isTransitionalNamespaceUri, isValidBase64, isXmlNode, isZoomElement, isZoomElement2 as isZoomElementUtil, layoutEngineShapesToDrawingShapes, lookupPresetShape, mailMerge, mergePresentation, mergeShapes, mergeStyleParts, mergeThemeColorOverride, mimeTypeForOleFile, mm, moveSlidesToSection, navigateCustomShow, normalizeHexColor, normalizeNamespaceUri, normalizePartPath, normalizePath, normalizeStrictXml, normalizeStrokeDashType, obfuscateFont, oleBytesToDataUrl, ooxmlArcToSvg, ooxmlToPresetName, parseActiveXControlsFromSlide, parseAdjustmentValues, parseBodyPrBooleanAttrs, parseChart3DSurfaces, parseChartAxes, parseCondition, parseConditionList, parseCxChartSeries, parseDataTable, parseDataUrlToBytes, parseDrawingColor, parseDrawingColorChoice, parseDrawingColorOpacity, parseDrawingFraction, parseDrawingHueDegrees, parseDrawingPercent, parseEmbeddedXlsx, parseGuideDefinitions, parseHexColor, parseKinsoku, parseLayoutDefinition, parseLineStyle, parseMarker, parseOle2, parsePanoseBytes, parsePanoseString, parsePresentationDrawingGuides, parseSeriesDataLabels, parseSeriesDataPoints, parseSeriesErrBars, parseSeriesExplosion, parseSeriesTrendlines, parseShapeProps, parseSignatureXml, parseSlideDrawingGuides, parseSvgPath, parseVmlElement, parseVmlElements, pixelsToEmu, polygonsToSvgPath, pptxActionToElementAction, promoteSmartArtNode, pt, reResolveSlideColors, readFileAsDataUrl, rebuildTableStructureInRawXml, reflowSmartArtLayout, relativeLuminance, relayoutSmartArt, removeChartCategory, removeChartSeries, removeSection, removeSmartArtNode, reorderObjectKeys, reorderSections, reorderSmartArtNode, reorderSmartArtNodeToIndex, repairPptx, replaceShapeGeometry, replaceText, replaceTextInSlide, replaceWithCustomGeometry, resetCloneIdCounter, resetDecomposeCounter, resetIdCounter, resetSectionIdCounter, resetSmartArtEditCounter, resolveCoordinate, resolveCustomShowSlideIndices, resolveLayoutDisplayName, resolveModel3DMimeType, resolveReferenceUriToPart, resolveTableCellStyle, rgbToHsl, selectAlternateContentBranch, serializeColorChoice, serializeCondition, serializeConditionList, serializeSvgPath, setChartAxis, setChartAxisGridlineStyle, setChartAxisLogScale, setChartAxisTitleStyle, setChartCategories, setChartDataLabels, setChartDataPointExplosion, setChartDataPointFill, setChartDataPointLabel, setChartDataPointMarker, setChartGrouping, setChartLegend, setChartSeriesChartType, setChartSeriesColor, setChartSeriesErrorBars, setChartSeriesMarker, setChartSeriesTrendline, setChartTitle, setChartType, setElementLocked, setSmartArtNodeStyle, shouldRenderFallbackLabel, shouldReturnToZoomSlide, subtractPolygons, subtractShapes, subtractSvgPaths, svgPathToPolygons, switchSmartArtLayout, toHex, toStrictNamespaceUri, unionPolygons, unionShapes, unionSvgPaths, unwrapAlternateContent, unwrapOleEmbedding, updateCellTextInRawXml, updateCellTextStyleInRawXml, updateChartDataPoint, updateChartSeriesValues, updateMergeAttrsInRawXml, updateSmartArtNodeText, validatePptx, verifyModifyPassword, verifyPassword, verifySignatureDigests, writeBodyPrBooleanAttrs, xmlAttr, xmlAttrBool, xmlAttrNumber, xmlChild, xmlChildren, xmlPath, xmlText };
+export { ALL_ANIMATION_PRESETS, BLIP_FILL_ORDER, CLOUD_CALLOUT_TAIL_COUNT, CLOUD_LOBE_COUNT, COLOR_MAP_ALIAS_KEYS, CONNECTOR_ARROW_OPTIONS, CONNECTOR_GEOMETRY_OPTIONS, ChartBuilder, ConnectorBuilder, ConnectorXmlFactory, DEFAULT_CANVAS_HEIGHT, DEFAULT_CANVAS_WIDTH, DEFAULT_COLOR_MAP, DEFAULT_FILL_COLOR, DEFAULT_FONT_FAMILY, DEFAULT_MAX_UNCOMPRESSED_BYTES, DEFAULT_SCHEME_COLOR_MAP, DEFAULT_STROKE_COLOR, DEFAULT_TEXT_COLOR, DEFAULT_TEXT_FONT_SIZE, DIGEST_ALGORITHM_TO_HASH, DIGEST_ALGORITHM_TO_WEB_CRYPTO, DIGITAL_SIGNATURE_ORIGIN_REL_TYPE, DIGITAL_SIGNATURE_REL_TYPE, DataIntegrityError, DocumentConverter, EFFECT_LST_ORDER, EMPHASIS_PRESETS, EMU_PER_INCH, EMU_PER_PIXEL2 as EMU_PER_PIXEL, EMU_PER_POINT, EMU_PER_PX, ENTERPRISE_FAIL_ON_REVOCATION_UNKNOWN_ENV, ENTERPRISE_REQUIRE_REVOCATION_ENV, ENTERPRISE_REQUIRE_TIMESTAMP_ENV, ENTERPRISE_TRUST_ROOTS_FILE_ENV, ENTERPRISE_TRUST_ROOTS_PEM_ENV, ENTRANCE_PRESETS, EXIT_PRESETS, EncryptedFileError, FONT_SUBSTITUTION_MAP, FreeformPathBuilder, GroupBuilder, ImageBuilder, IncorrectPasswordError, MAX_TABLE_DIMENSION, MAX_ZIP_ENTRY_COUNT, MIN_ELEMENT_SIZE, MIN_TABLE_DIMENSION, MOTION_PATH_PRESETS, MediaBuilder, MediaContext, MediaGraphicFrameXmlFactory, OOXML_TO_PRESET_EMPH, OOXML_TO_PRESET_ENTR, OOXML_TO_PRESET_EXIT, OPC_RELATIONSHIP_TRANSFORM, Ole2ParseError, P14_GUIDE_URI, P15_GUIDE_URI, PANOSE_FAMILY_MAP, PANOSE_MONOSPACE_PROPORTION, PANOSE_SANS_SERIF_STYLES, PANOSE_WEIGHT_MAP, POWERPOINT_PRESENCE_KEY, PPTX_VIEWER_MANIFEST_NS, PRESET_COLOR_MAP, PRESET_SHAPE_CATEGORY_LABELS, PRESET_SHAPE_CLIP_PATHS, PRESET_SHAPE_DEFINITIONS, PRESET_SHAPE_GEOMETRY_TABLE, PRESET_TO_OOXML, PictureXmlFactory, PptxAnimationWriteService, PptxColorStyleCodec, PptxCommentAuthorsXmlFactory, PptxCommentXmlFactoryProvider, PptxCompatibilityService, PptxConnectorParser, PptxContentTypesBuilder, PptxDocumentPropertiesUpdater, PptxEditorAnimationService, PptxElementTransformUpdater, PptxElementXmlBuilder, PptxGraphicFrameParser, PptxHandler, PptxHandlerRuntime82 as PptxHandlerRuntime, PptxHandlerRuntimeFactory, PptxLoadDataBuilder, PptxMarkdownConverter, PptxMediaDataParser, PptxNativeAnimationService, PptxPresentationSaveBuilder, PptxPresentationSlidesReconciler, PptxRuntimeDependencyFactory, PptxSaveConstantsFactory, PptxSaveState as PptxSaveSession, PptxSaveStateBuilder as PptxSaveSessionBuilder, PptxSaveState, PptxSaveStateBuilder, PptxShapeIdValidator, PptxShapeStyleExtractor, PptxSlideBackgroundBuilder, PptxSlideBuilder, PptxSlideCommentPartWriter, PptxSlideCommentsXmlFactory, PptxSlideElementsBuilder, PptxSlideLoaderService, PptxSlideMediaRelationshipBuilder, PptxSlideNotesBuilder, PptxSlideNotesPartUpdater, PptxSlideRelationshipRegistry, PptxSlideTransitionService, PptxTableDataParser, PptxTemplateBackgroundService, PptxXmlBuilder, PptxXmlFactoryProvider, PptxXmlLookupService, Presentation, PresentationBuilder, SHAPE_TREE_ELEMENT_TAGS, SP_PR_ORDER, STROKE_DASH_OPTIONS, SUPPORTED_XML_CANON_TRANSFORMS, SWITCHABLE_LAYOUT_TYPES, SYSTEM_COLOR_MAP, ShapeBuilder, SlideBuilder, SlideProcessor, SlideSizes, SvgExporter, TC_PR_BORDERS_ORDER, THEME_COLOR_SCHEME_KEYS, THEME_PRESETS, TRANSITION_VALID_DIRECTIONS, TableBuilder, TextBuilder, TextShapeXmlFactory, ThemePresets, VML_SHAPE_TAGS, XMLDSIG_NS, XML_TRANSFORM_ENVELOPED_SIGNATURE, ZipBombError, addChartCategory, addChartSeries, addSection, addSmartArtNode, addSmartArtNodeAsChild, applyDrawingColorTransforms, applyKinsokuToXml, applyTableCellTextAndStyle, applyTemplate, applyThemeToData, areNamespacesSupported, buildCalloutLeaderLineSvgPath, buildClrMapOverrideXml, buildFontFamilyString, buildGuideListExtension, buildLinkedTextBoxChains, buildOle2, buildSingleEffectNode, buildSrgbColorChoice, buildThemeColorMap, catmullRomToBezier, chartDataAddCategory, chartDataAddSeries, chartDataChangeType, chartDataRemoveCategory, chartDataRemoveSeries, chartDataUpdatePoint, checkBlankSlide, checkComplexTables, checkDuplicateTitles, checkLowContrast, checkMissingAltText, checkMissingSlideTitle, checkPresentation, clampUnitInterval, classifyPanose, cloneElement, cloneShapeStyle, cloneSlide, cloneTemplateElementsBySlideId, cloneTextStyle, cloneXmlObject, cm, cmToEmu, colorWithOpacity, colorsEqual, combineShapes, computeContrastRatio, computeCycleLayout, computeDetailStatus, computeDigestBase64 as computeDigestBase64WebCrypto, computeHierarchyLayout, computeLinearLayout, computeMatrixLayout, computePyramidLayout, computeSmartArtLayout, computeSnakeLayout, computeVerificationStatus, convertXmlToStrict, createArrayBufferCopy, createBuiltinVariables, createChartElement, createConnectorElement, createDefaultPptxHandlerRuntime, createEditorId, createFreeformElement, createGroupElement, createImageElement, createLayout, createLayouts, createMediaElement, createModifyVerifier, createPptxSaveConstants, createShapeElement, createTableCellXml, createTableElement, createTableGraphicFrameRawXml, createTemplateConnectorRawXml, createTemplateShapeRawXml, createTextElement, createUniformTextSegments, dataUrlToMediaBytes, decodeOle10Native, decodeXmlEntities, decomposeSmartArt, decryptPptx, demoteSmartArtNode, deobfuscateFont, deriveOutputPath, detectDigitalSignatures, detectFileFormat, detectFontFormat, detectOleObjectType, detectStrictConformance, diffPresentations, diffSlides, distributeSegmentsAcrossChain, douglasPeucker, duplicateElement, duplicateSlide, elementActionToPptxAction, elementHasAction, emuToPixels, encryptPptx, ensureArrayValue, escapeXmlAttr, escapeXmlText, estimateTextBoxCapacity, evaluateGeometryPaths, evaluateGuides, evaluatePresetShape, extractAllTagText, extractColorChoiceXml, extractFirstTagText, extractGuidFromPartName, extractModel3DTransform, extractTagAttribute, fetchUrlToBytes, findCustomShow, findLayoutByName, findLayoutByType, findPlaceholders, findText, formatCommentTimestamp, fragmentShapes, generateFontGuid, generateLayoutXml, generateMediaFilename, getAdjustmentAwareClipPath, getAdjustmentAwareShapeClipPath, getAnimationPresetInfo, getCalloutLeaderLineGeometry, getCalloutTier, getCalloutViewBoxBounds, getCloudCalloutClipPath, getCloudClipPath, getCloudPathForRendering, getCommentMarkerPosition, getConnectorAdjustment, getConnectorPathGeometry, getCssBorderDashStyle, getCustomShowNames, getCustomShowPositionLabel, getDirectory, getElementLabel, getElementTextContent, getElementTransform, getImageMaskStyle, getLinkedTextBoxSegments, getNativeAnimationPresetMetadata, getOleObjectTypeLabel, getPanoseWeight, getPresetShapeClipPath, getPresetsByCategory, getRoundRectRadiusPx, getSectionForSlide, getSectionSlideRange, getShapeClipPath, getShapeClipPathFromPreset, getShapeType, getSignaturePathsToStrip, getSubstituteFontFamily, getSubstituteFonts, getSupportedNamespaces, getSvgStrokeDasharray, getTextCompensationTransform, getThemePreset, getZoomElements, getZoomTargetSlideIndexes, guidToKey, guideEmuToPx, guidePxToEmu, hasDirectSubstitution, hasNonTrivialOverride, hasShapeProperties, hasTextProperties, hexToRgbChannels, hslToRgb, inches, inchesToEmu, inferOleExtensionFromTarget, interpolateShapeGeometry, intersectPolygons, intersectShapes, intersectSvgPaths, isCalloutShape, isConnectorElement, isEditableTextElement, isImageLikeElement, isInkElement, isNamespaceSupported, isOle2CompoundFile, isShapeElement, isStrictNamespaceUri, isSummaryZoomSlide, isSwitchableLayoutType, isTemplateElement, isTextElement, isTransitionalNamespaceUri, isValidBase64, isXmlNode, isZoomElement, isZoomElement2 as isZoomElementUtil, layoutEngineShapesToDrawingShapes, lookupPresetShape, mailMerge, mergePresentation, mergeShapes, mergeStyleParts, mergeThemeColorOverride, mimeTypeForOleFile, mm, moveSlidesToSection, navigateCustomShow, normalizeHexColor, normalizeNamespaceUri, normalizePartPath, normalizePath, normalizeStrictXml, normalizeStrokeDashType, obfuscateFont, oleBytesToDataUrl, ooxmlArcToSvg, ooxmlToPresetName, parseActiveXControlsFromSlide, parseAdjustmentValues, parseBodyPrBooleanAttrs, parseChart3DSurfaces, parseChartAxes, parseCondition, parseConditionList, parseCxChartSeries, parseDataTable, parseDataUrlToBytes, parseDrawingColor, parseDrawingColorChoice, parseDrawingColorOpacity, parseDrawingFraction, parseDrawingHueDegrees, parseDrawingPercent, parseEmbeddedXlsx, parseGuideDefinitions, parseHexColor, parseKinsoku, parseLayoutDefinition, parseLineStyle, parseMarker, parseOle2, parsePanoseBytes, parsePanoseString, parsePresentationDrawingGuides, parseSeriesDataLabels, parseSeriesDataPoints, parseSeriesErrBars, parseSeriesExplosion, parseSeriesTrendlines, parseShapeProps, parseSignatureXml, parseSlideDrawingGuides, parseSvgPath, parseVmlElement, parseVmlElements, pixelsToEmu, polygonsToSvgPath, pptxActionToElementAction, promoteSmartArtNode, pt, reResolveSlideColors, readFileAsDataUrl, rebuildTableStructureInRawXml, reconcileAnimationTargets, reflowSmartArtLayout, relativeLuminance, relayoutSmartArt, remapEditorAnimationsToShapeIds, removeChartCategory, removeChartSeries, removeSection, removeSmartArtNode, reorderObjectKeys, reorderSections, reorderSmartArtNode, reorderSmartArtNodeToIndex, repairPptx, replaceShapeGeometry, replaceText, replaceTextInSlide, replaceWithCustomGeometry, resetCloneIdCounter, resetDecomposeCounter, resetIdCounter, resetSectionIdCounter, resetSmartArtEditCounter, resolveCoordinate, resolveCustomShowSlideIndices, resolveLayoutDisplayName, resolveModel3DMimeType, resolveReferenceUriToPart, resolveTableCellStyle, rgbToHsl, selectAlternateContentBranch, serializeColorChoice, serializeCondition, serializeConditionList, serializeSvgPath, setChartAxis, setChartAxisGridlineStyle, setChartAxisLogScale, setChartAxisTitleStyle, setChartCategories, setChartDataLabels, setChartDataPointExplosion, setChartDataPointFill, setChartDataPointLabel, setChartDataPointMarker, setChartGrouping, setChartLegend, setChartSeriesChartType, setChartSeriesColor, setChartSeriesErrorBars, setChartSeriesMarker, setChartSeriesTrendline, setChartTitle, setChartType, setElementLocked, setSmartArtNodeStyle, shouldRenderFallbackLabel, shouldReturnToZoomSlide, subtractPolygons, subtractShapes, subtractSvgPaths, svgPathToPolygons, switchSmartArtLayout, toHex, toStrictNamespaceUri, unionPolygons, unionShapes, unionSvgPaths, unwrapAlternateContent, unwrapOleEmbedding, updateCellTextInRawXml, updateCellTextStyleInRawXml, updateChartDataPoint, updateChartSeriesValues, updateMergeAttrsInRawXml, updateSmartArtNodeText, validatePptx, verifyModifyPassword, verifyPassword, verifySignatureDigests, writeBodyPrBooleanAttrs, xmlAttr, xmlAttrBool, xmlAttrNumber, xmlChild, xmlChildren, xmlPath, xmlText };

package/dist/{presentation-BRAUjTRt.d.mts → presentation-CLc4eS3z.d.mts}

@@ -3962,6 +3962,16 @@ interface PptxAppProperties {
  */
 interface PptxElementBase {
     id: string;
+    /**
+     * The shape's native OOXML id from `p:cNvPr/@id` (an unsigned integer, as a
+     * string), captured on load. Distinct from {@link id}, which is a synthetic
+     * positional identity (`${slidePath}-shape-${index}`) the loader assigns for
+     * selection / undo / template tracking. Animations target shapes by this
+     * native id (`p:spTgt/@spid`), so it is the stable key used to reconcile an
+     * animation to the element it animates across a save/reload round trip.
+     * Absent on SDK-created elements until one is minted at save time.
+     */
+    shapeId?: string;
     /** Element name from `cNvPr/@name`. Used for morph transition matching via the `!!` naming convention. */
     name?: string;
     x: number;

package/dist/{presentation-BRAUjTRt.d.ts → presentation-CLc4eS3z.d.ts}

@@ -3962,6 +3962,16 @@ interface PptxAppProperties {
  */
 interface PptxElementBase {
     id: string;
+    /**
+     * The shape's native OOXML id from `p:cNvPr/@id` (an unsigned integer, as a
+     * string), captured on load. Distinct from {@link id}, which is a synthetic
+     * positional identity (`${slidePath}-shape-${index}`) the loader assigns for
+     * selection / undo / template tracking. Animations target shapes by this
+     * native id (`p:spTgt/@spid`), so it is the stable key used to reconcile an
+     * animation to the element it animates across a save/reload round trip.
+     * Absent on SDK-created elements until one is minted at save time.
+     */
+    shapeId?: string;
     /** Element name from `cNvPr/@name`. Used for morph transition matching via the `!!` naming convention. */
     name?: string;
     x: number;

package/dist/{text-operations-CkW4BO91.d.mts → text-operations-CCKEVX_5.d.mts}

@@ -1,4 +1,4 @@
-import { m as PptxData, l as PptxSlide } from './presentation-BRAUjTRt.mjs';
+import { m as PptxData, l as PptxSlide } from './presentation-CLc4eS3z.mjs';
 
 /**
  * Presentation merge operations for the headless PPTX SDK.

package/dist/{text-operations-BJUOhA1w.d.ts → text-operations-oN04X1yi.d.ts}

@@ -1,4 +1,4 @@
-import { m as PptxData, l as PptxSlide } from './presentation-BRAUjTRt.js';
+import { m as PptxData, l as PptxSlide } from './presentation-CLc4eS3z.js';
 
 /**
  * Presentation merge operations for the headless PPTX SDK.

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "pptx-viewer-core",
-	"version": "1.2.4",
+	"version": "1.2.5",
 	"description": "PowerPoint PPTX engine: parse, edit, serialize, and convert .pptx files. Framework-agnostic TypeScript SDK.",
 	"keywords": [
 		"angular",