pptx-viewer-core 1.1.46 → 1.1.48

package/dist/index.d.mts

@@ -2576,7 +2576,7 @@ declare function decomposeSmartArt(smartArtData: PptxSmartArtData, containerBoun
  * @module smartart-editing-node-ops
  */
 
-/** Reset the edit counter (useful in tests). */
+/** No-op kept for API compatibility; id generation no longer needs a counter. */
 declare function resetSmartArtEditCounter(): void;
 /**
  * Add a new node to a SmartArt diagram after a given sibling.
@@ -2613,7 +2613,10 @@ declare function demoteSmartArtNode(data: PptxSmartArtData, nodeId: string): Ppt
 /**
  * Add a new node as a child of a given parent.
  *
- * If `parentId` is undefined, the node is added as a root-level item.
+ * If `parentId` is undefined, the node is added as a root-level item, using
+ * the diagram's own root/doc id (inferred from an existing top-level node)
+ * so it ends up as a sibling of the other top-level items rather than an
+ * unparented node the save pipeline can't anchor into the diagram XML.
  * If `text` is undefined, a default label is generated.
  *
  * Returns a new PptxSmartArtData with the node inserted and
@@ -5617,7 +5620,7 @@ declare class PptxElementXmlBuilder {
  * the constructor of the final concrete class
  * ({@link PptxHandlerRuntimeImplementation}).
  */
-declare class PptxHandlerRuntime$1g {
+declare class PptxHandlerRuntime$1h {
     /** The in-memory ZIP archive representing the OPC (.pptx) package. */
     protected zip: JSZip;
     /** fast-xml-parser instance used to parse XML strings into JS objects. */
@@ -5941,7 +5944,7 @@ declare class PptxHandlerRuntime$1g {
     protected restoreOriginalParser(): void;
 }
 
-declare class PptxHandlerRuntime$1f extends PptxHandlerRuntime$1g {
+declare class PptxHandlerRuntime$1g extends PptxHandlerRuntime$1h {
     /**
      * Export slides to a raster/vector format.
      *
@@ -5985,7 +5988,7 @@ declare class PptxHandlerRuntime$1f extends PptxHandlerRuntime$1g {
     protected parseTableStyles(): Promise<ParsedTableStyleMap | undefined>;
 }
 
-declare class PptxHandlerRuntime$1e extends PptxHandlerRuntime$1f {
+declare class PptxHandlerRuntime$1f extends PptxHandlerRuntime$1g {
     /**
      * Write or remove a single `a:hlinkClick` / `a:hlinkHover` node on
      * a `p:cNvPr` parent.
@@ -6008,7 +6011,7 @@ declare class PptxHandlerRuntime$1e extends PptxHandlerRuntime$1f {
     protected serializeShapeLocks(shape: XmlObject, el: PptxElement): void;
 }
 
-declare class PptxHandlerRuntime$1d extends PptxHandlerRuntime$1e {
+declare class PptxHandlerRuntime$1e extends PptxHandlerRuntime$1f {
     /**
      * Parse a single `a:hlinkClick` or `a:hlinkHover` node into a `PptxAction`.
      */
@@ -6047,7 +6050,7 @@ interface MediaTimingData {
     /** Playback speed multiplier (1 = normal). From p14:media/@spd (percentage * 1000). */
     playbackSpeed?: number;
 }
-declare class PptxHandlerRuntime$1c extends PptxHandlerRuntime$1d {
+declare class PptxHandlerRuntime$1d extends PptxHandlerRuntime$1e {
     /**
      * Extract image recolour/brightness/contrast/artistic effects from blip extensions.
      */
@@ -6068,7 +6071,7 @@ declare class PptxHandlerRuntime$1c extends PptxHandlerRuntime$1d {
     protected resolveRelationshipTarget(sourcePath: string, rId: string): string | undefined;
 }
 
-declare class PptxHandlerRuntime$1b extends PptxHandlerRuntime$1c {
+declare class PptxHandlerRuntime$1c extends PptxHandlerRuntime$1d {
     /**
      * Recursively walk the timing tree looking for `p:video` and `p:audio`
      * nodes that contain `p:cMediaNode`.
@@ -6096,7 +6099,7 @@ declare class PptxHandlerRuntime$1b extends PptxHandlerRuntime$1c {
     getMediaArrayBuffer(mediaPath: string): Promise<ArrayBuffer | undefined>;
 }
 
-declare class PptxHandlerRuntime$1a extends PptxHandlerRuntime$1b {
+declare class PptxHandlerRuntime$1b extends PptxHandlerRuntime$1c {
     /**
      * Convert raw image bytes to a URL suitable for <img src>.
      * Uses Blob URLs in browsers (avoids 33% base64 overhead),
@@ -6116,7 +6119,7 @@ declare class PptxHandlerRuntime$1a extends PptxHandlerRuntime$1b {
     protected parseNativeAnimations(slideXml: XmlObject): PptxNativeAnimation[] | undefined;
 }
 
-declare class PptxHandlerRuntime$19 extends PptxHandlerRuntime$1a {
+declare class PptxHandlerRuntime$1a extends PptxHandlerRuntime$1b {
     protected buildRelativeTargetPath(fromPartPath: string, toPartPath: string): string;
     protected setMasterThemeRelationship(masterPath: string, themePath: string): Promise<void>;
     setPresentationTheme(themePath: string, applyToAllMasters?: boolean): Promise<void>;
@@ -6172,7 +6175,7 @@ declare class PptxHandlerRuntime$19 extends PptxHandlerRuntime$1a {
     protected parseTags(): Promise<PptxTagCollection[]>;
 }
 
-declare class PptxHandlerRuntime$18 extends PptxHandlerRuntime$19 {
+declare class PptxHandlerRuntime$19 extends PptxHandlerRuntime$1a {
     /**
      * Parse background colour from a `p:bg` node.
      */
@@ -6215,7 +6218,7 @@ declare class PptxHandlerRuntime$18 extends PptxHandlerRuntime$19 {
     protected parseCustomShows(): PptxCustomShow[] | undefined;
 }
 
-declare class PptxHandlerRuntime$17 extends PptxHandlerRuntime$18 {
+declare class PptxHandlerRuntime$18 extends PptxHandlerRuntime$19 {
     /**
      * Parse presentation properties from `presentationPr.xml`.
      * Extracts show type, loop, narration, animation, and print settings.
@@ -6234,7 +6237,7 @@ declare class PptxHandlerRuntime$17 extends PptxHandlerRuntime$18 {
     protected toSlideRelsPath(slidePath: string): string;
 }
 
-declare class PptxHandlerRuntime$16 extends PptxHandlerRuntime$17 {
+declare class PptxHandlerRuntime$17 extends PptxHandlerRuntime$18 {
     protected createEmptySlideXml(): XmlObject;
     protected deepCloneXml(value: XmlObject | undefined): XmlObject | undefined;
     protected findSourceSlidePath(requestedSourcePath: string | undefined): string | undefined;
@@ -6268,16 +6271,16 @@ declare class PptxHandlerRuntime$16 extends PptxHandlerRuntime$17 {
     protected createLineSpacingXmlFromMultiplier(lineSpacing: number | undefined): XmlObject | undefined;
 }
 
-declare class PptxHandlerRuntime$15 extends PptxHandlerRuntime$16 {
+declare class PptxHandlerRuntime$16 extends PptxHandlerRuntime$17 {
     protected createRunPropertiesFromTextStyle(style: TextStyle | undefined, resolveHyperlinkRelationshipId?: (target: string) => string | undefined): XmlObject;
     private applyHyperlinkExtraAttrs;
 }
 
-declare class PptxHandlerRuntime$14 extends PptxHandlerRuntime$15 {
+declare class PptxHandlerRuntime$15 extends PptxHandlerRuntime$16 {
     protected createParagraphsFromTextContent(text: string | undefined, textStyle: TextStyle | undefined, textSegments: TextSegment[] | undefined, resolveHyperlinkRelationshipId?: (target: string) => string | undefined): XmlObject[];
 }
 
-declare class PptxHandlerRuntime$13 extends PptxHandlerRuntime$14 {
+declare class PptxHandlerRuntime$14 extends PptxHandlerRuntime$15 {
     protected updateNotesXmlText(notesXmlObj: XmlObject, notesText: string | undefined, notesSegments?: TextSegment[]): boolean;
     protected createPictureXml(el: PptxImageLikeElement, relationshipId: string): XmlObject;
     protected createMediaGraphicFrameXml(el: MediaPptxElement, relationshipId: string): XmlObject;
@@ -6289,7 +6292,7 @@ declare class PptxHandlerRuntime$13 extends PptxHandlerRuntime$14 {
     protected createConnectorXml(el: ConnectorPptxElement): XmlObject;
 }
 
-declare class PptxHandlerRuntime$12 extends PptxHandlerRuntime$13 {
+declare class PptxHandlerRuntime$13 extends PptxHandlerRuntime$14 {
     /**
      * Build a `p:graphicFrame` XML skeleton for an SDK-created table.
      *
@@ -6355,7 +6358,7 @@ declare class PptxHandlerRuntime$12 extends PptxHandlerRuntime$13 {
     protected buildGroupShapeXml(group: GroupPptxElement): XmlObject | null;
 }
 
-declare class PptxHandlerRuntime$11 extends PptxHandlerRuntime$12 {
+declare class PptxHandlerRuntime$12 extends PptxHandlerRuntime$13 {
     protected clampCropForSave(value: unknown): number;
     protected applyImageCropToBlipFill(blipFill: XmlObject | undefined, element: PptxImageLikeElement): void;
     protected applyImageEffectsToBlip(blipFill: XmlObject | undefined, effects: PptxImageEffects | undefined): void;
@@ -6377,7 +6380,7 @@ declare class PptxHandlerRuntime$11 extends PptxHandlerRuntime$12 {
     protected getTextValueForSave(text: string | undefined, textSegments: TextSegment[] | undefined): string;
 }
 
-declare class PptxHandlerRuntime$10 extends PptxHandlerRuntime$11 {
+declare class PptxHandlerRuntime$11 extends PptxHandlerRuntime$12 {
     protected textStylesEqual(left: TextStyle | undefined, right: TextStyle | undefined): boolean;
     protected hasMixedTextStyles(textSegments: TextSegment[]): boolean;
     /**
@@ -6397,7 +6400,7 @@ declare class PptxHandlerRuntime$10 extends PptxHandlerRuntime$11 {
     protected compactTextSegments(textSegments: TextSegment[], fallbackStyle: TextStyle | undefined): TextSegment[];
 }
 
-declare class PptxHandlerRuntime$$ extends PptxHandlerRuntime$10 {
+declare class PptxHandlerRuntime$10 extends PptxHandlerRuntime$11 {
     /**
      * Parse hyperlink-related properties (a:hlinkClick, a:hlinkMouseOver) from
      * run-level XML and apply them to the given TextStyle.
@@ -6425,7 +6428,7 @@ declare class PptxHandlerRuntime$$ extends PptxHandlerRuntime$10 {
     protected applyTextRunEffectDag(style: TextStyle, runProperties: XmlObject): void;
 }
 
-declare class PptxHandlerRuntime$_ extends PptxHandlerRuntime$$ {
+declare class PptxHandlerRuntime$$ extends PptxHandlerRuntime$10 {
     protected extractTextRunStyle(runProperties: XmlObject | undefined, align: TextStyle['align'], relationshipMap?: Map<string, string>): TextStyle;
     /**
      * Copy `@panose` / `@pitchFamily` / `@charset` from a font child node
@@ -6435,7 +6438,7 @@ declare class PptxHandlerRuntime$_ extends PptxHandlerRuntime$$ {
     private applyTextFontMetadata;
 }
 
-declare class PptxHandlerRuntime$Z extends PptxHandlerRuntime$_ {
+declare class PptxHandlerRuntime$_ extends PptxHandlerRuntime$$ {
     protected extractTextSegmentsFromTxBodyForRewrite(txBody: XmlObject | undefined, baseStyle: TextStyle | undefined, relationshipMap?: Map<string, string>): TextSegment[];
     protected remapEditedTextToExistingStyles(existingSegments: TextSegment[], nextText: string, fallbackStyle: TextStyle | undefined): TextSegment[];
 }
@@ -6564,7 +6567,7 @@ interface BodyPropertiesResult {
  * by type, reposition matched placeholders, remove unmatched ones, and
  * inject empty placeholders that exist only in the target layout.
  */
-declare class PptxHandlerRuntime$Y extends PptxHandlerRuntime$Z {
+declare class PptxHandlerRuntime$Z extends PptxHandlerRuntime$_ {
     /**
      * Read placeholder info from a `p:nvPr` XML node.
      *
@@ -6624,7 +6627,7 @@ declare class PptxHandlerRuntime$Y extends PptxHandlerRuntime$Z {
     protected createEmptyPlaceholderElement(phInfo: PlaceholderInfo, xEmu: number, yEmu: number, cxEmu: number, cyEmu: number, _layoutPath: string): PptxElement | null;
 }
 
-declare class PptxHandlerRuntime$X extends PptxHandlerRuntime$Y {
+declare class PptxHandlerRuntime$Y extends PptxHandlerRuntime$Z {
     /**
      * Write plain text into a table cell's txBody, preserving
      * existing run properties where possible.
@@ -6636,7 +6639,7 @@ declare class PptxHandlerRuntime$X extends PptxHandlerRuntime$Y {
     protected writeTableCellStyle(xmlCell: XmlObject, style: PptxTableCellStyle): void;
 }
 
-declare class PptxHandlerRuntime$W extends PptxHandlerRuntime$X {
+declare class PptxHandlerRuntime$X extends PptxHandlerRuntime$Y {
     /**
      * Serialise modified `PptxTableData` back into the graphic frame's
      * raw XML so that the round-tripped file preserves edits.
@@ -6713,7 +6716,7 @@ declare class PptxHandlerRuntime$W extends PptxHandlerRuntime$X {
     protected buildNewSeriesXml(seriesIndex: number, seriesData: PptxChartSeries, categories: string[], templateSeries?: XmlObject): XmlObject;
 }
 
-declare class PptxHandlerRuntime$V extends PptxHandlerRuntime$W {
+declare class PptxHandlerRuntime$W extends PptxHandlerRuntime$X {
     /** Pending SmartArt data updates to process during save. */
     protected pendingSmartArtUpdates?: Array<{
         element: SmartArtPptxElement;
@@ -6737,14 +6740,6 @@ declare class PptxHandlerRuntime$V extends PptxHandlerRuntime$W {
      * carries no colour transform.
      */
     protected regenerateSmartArtColorPart(slidePath: string, smartArtData: SmartArtPptxElement['smartArtData']): Promise<void>;
-    /**
-     * Merge the in-memory quick style back into `ppt/diagrams/quickStyles*.xml`.
-     *
-     * Resolves the part via the SmartArt `styleRelId` relationship, merges
-     * surgically, and skips gracefully when the rel or part is absent. No-op
-     * when the in-memory data carries no quick style.
-     */
-    protected regenerateSmartArtQuickStylePart(slidePath: string, smartArtData: SmartArtPptxElement['smartArtData']): Promise<void>;
     /**
      * Read a SmartArt diagram part by slide relationship id, locate its root
      * definition element by local name, apply a surgical merge callback, and
@@ -6829,7 +6824,7 @@ declare class PptxHandlerRuntime$V extends PptxHandlerRuntime$W {
     protected convertZipToStrictConformance(): Promise<void>;
 }
 
-declare class PptxHandlerRuntime$U extends PptxHandlerRuntime$V {
+declare class PptxHandlerRuntime$V extends PptxHandlerRuntime$W {
     protected applyPresentationPropertiesPart(properties: PptxPresentationProperties | undefined): Promise<void>;
     /**
      * Strip digital signature parts from the ZIP if the document was signed.
@@ -6838,14 +6833,14 @@ declare class PptxHandlerRuntime$U extends PptxHandlerRuntime$V {
     protected stripDigitalSignatures(): Promise<void>;
 }
 
-declare class PptxHandlerRuntime$T extends PptxHandlerRuntime$U {
+declare class PptxHandlerRuntime$U extends PptxHandlerRuntime$V {
     protected collectMediaElements(elements: PptxElement[], output: MediaPptxElement[]): void;
     protected getShapeIdFromRawXml(rawXml: XmlObject | undefined): string | undefined;
     protected applyMediaTimingToTimingTree(node: XmlObject, mediaByShapeId: Map<string, MediaPptxElement>): void;
     protected applyMediaTimingToRawTiming(rawTiming: XmlObject, elements: PptxElement[]): void;
 }
 
-declare class PptxHandlerRuntime$S extends PptxHandlerRuntime$T {
+declare class PptxHandlerRuntime$T extends PptxHandlerRuntime$U {
     /**
      * Recursively walk an XML object tree and deduplicate extension list entries
      * by `@_uri`. When multiple `a:ext` or `p:ext` entries share the same URI,
@@ -6867,7 +6862,7 @@ declare class PptxHandlerRuntime$S extends PptxHandlerRuntime$T {
     protected ensureTemplateShapeAttached(spTree: XmlObject, elementType: PptxElement['type'], shape: XmlObject): XmlObject;
 }
 
-declare class PptxHandlerRuntime$R extends PptxHandlerRuntime$S {
+declare class PptxHandlerRuntime$S extends PptxHandlerRuntime$T {
     /**
      * Serialize shape fill, stroke, dash, arrows, line join/cap/compound,
      * and line-level effects to the given spPr XML object.
@@ -6895,7 +6890,7 @@ declare class PptxHandlerRuntime$R extends PptxHandlerRuntime$S {
     private replaceRefColorChoice;
 }
 
-declare class PptxHandlerRuntime$Q extends PptxHandlerRuntime$R {
+declare class PptxHandlerRuntime$R extends PptxHandlerRuntime$S {
     /**
      * Serialize visual effects (shadow, glow, reflection, blur, soft edge),
      * effectDag, 3D scene, and 3D shape properties to the given spPr XML object.
@@ -6903,7 +6898,7 @@ declare class PptxHandlerRuntime$Q extends PptxHandlerRuntime$R {
     protected applyEffectsAndThreeD(spPr: XmlObject, shapeStyle: ShapeStyle): void;
 }
 
-declare class PptxHandlerRuntime$P extends PptxHandlerRuntime$Q {
+declare class PptxHandlerRuntime$Q extends PptxHandlerRuntime$R {
     /**
      * Build and write the text body (`p:txBody`) for shapes, text boxes,
      * and connectors that carry text content.
@@ -6939,7 +6934,7 @@ interface SaveSlideContext {
     readonly slideVideoRelationshipType: string;
     readonly slideAudioRelationshipType: string;
 }
-declare class PptxHandlerRuntime$O extends PptxHandlerRuntime$P {
+declare class PptxHandlerRuntime$P extends PptxHandlerRuntime$Q {
     /** Serialize table, chart, and SmartArt data when applicable. */
     protected applyDataSerialization(shape: XmlObject, el: PptxElement, slideId: string): void;
     /** Apply image crop, effects, and alt text for picture/image elements. */
@@ -6952,6 +6947,37 @@ declare class PptxHandlerRuntime$O extends PptxHandlerRuntime$P {
     protected processMediaEmbedding(mediaElement: MediaPptxElement, shape: XmlObject | undefined, ctx: SaveSlideContext): XmlObject | undefined;
 }
 
+/**
+ * Save-pipeline mixin: fabricate the full diagram part family for
+ * SDK-created SmartArt elements (inserted via the viewer / SlideBuilder,
+ * carrying only in-memory `smartArtData` with no `rawXml` and no diagram
+ * parts). Mirrors the SDK-created chart path (`createChartElementXml`):
+ * write the parts, register the slide relationships, queue content-type
+ * overrides, and return the `p:graphicFrame` envelope with `dgm:relIds`.
+ */
+
+declare class PptxHandlerRuntime$O extends PptxHandlerRuntime$P {
+    /** Content-type overrides queued for diagram parts fabricated this save. */
+    protected pendingDiagramContentTypes?: Array<{
+        partName: string;
+        contentType: string;
+    }>;
+    /** Pick the next free `ppt/diagrams/*N.xml` index (zip + pending writes). */
+    protected nextDiagramPartIndex(): number;
+    /**
+     * Fabricate `ppt/diagrams/{data,layout,quickStyle,colors}N.xml` for an
+     * SDK-created SmartArt element, register the four slide relationships,
+     * queue the content-type overrides, and return the `p:graphicFrame`.
+     */
+    protected createSmartArtElementXml(el: SmartArtPptxElement, ctx: SaveSlideContext): XmlObject;
+    /**
+     * Add `[Content_Types].xml` Override entries for diagram parts fabricated
+     * this save. Called from the save pipeline alongside
+     * `ensureChartPartContentTypes`; a no-op when nothing was fabricated.
+     */
+    protected ensureDiagramPartContentTypes(): Promise<void>;
+}
+
 /** Collector arrays for sorting processed elements into shape tree lists. */
 interface SlideShapeCollectors {
     readonly shapes: XmlObject[];