pptx-react-viewer 1.1.48 → 1.1.49

package/dist/viewer/index.d.mts

@@ -784,6 +784,14 @@ interface IPptxHandlerRuntime {
      * @returns Array of layout options belonging to the same slide master.
      */
     getAvailableLayoutsForSlide(slideIndex: number, slides: l[]): Promise<o[]>;
+    /**
+     * Resolve the editable template (master + layout) elements a slide
+     * inherits, each carrying a `master-` / `layout-` prefixed id. Excludes
+     * placeholders; returns only decorative shapes/pictures/graphic frames.
+     *
+     * @param slideId - The slide's archive path (`PptxSlide.id`).
+     */
+    getTemplateElementsForSlide(slideId: string): Promise<P[]>;
     /**
      * Scan the loaded PPTX archive for all theme parts.
      */
@@ -1191,6 +1199,37 @@ declare class PptxHandlerCore {
      * ```
      */
     getAvailableLayoutsForSlide(slideIndex: number, slides: l[]): Promise<o[]>;
+    /**
+     * Resolve the editable template (master + layout) elements a slide
+     * inherits, each carrying a `master-` / `layout-` prefixed id.
+     *
+     * This is the foundation for an "edit template/master" feature. The
+     * returned elements are the decorative master/layout shapes the loader
+     * already merges behind slide-authored content (master shapes behind,
+     * layout shapes on top); placeholders are excluded. The same elements are
+     * shared by every slide inheriting the layout/master, so editing one and
+     * saving updates the shared part.
+     *
+     * To persist an edit, keep the mutated template element inside the
+     * `slide.elements` array passed to {@link save}; the save writer reads
+     * template elements from there and writes their shape XML back into the
+     * owning layout/master `p:spTree`.
+     *
+     * @param slideId - The slide's archive path (the `PptxSlide.id`).
+     * @returns Master + layout elements with prefixed ids (may be empty).
+     *
+     * @example
+     * ```ts
+     * const templateEls = await handler.getTemplateElementsForSlide(slide.id);
+     * const logo = templateEls.find((e) => e.id.startsWith("master-"));
+     * if (logo) {
+     *   logo.x += 10;
+     *   slide.elements = [...slide.elements, logo];
+     *   await handler.save(data.slides);
+     * }
+     * ```
+     */
+    getTemplateElementsForSlide(slideId: string): Promise<P[]>;
     /**
      * Apply a different layout to an existing slide.
      *

package/dist/viewer/index.d.ts

@@ -784,6 +784,14 @@ interface IPptxHandlerRuntime {
      * @returns Array of layout options belonging to the same slide master.
      */
     getAvailableLayoutsForSlide(slideIndex: number, slides: l[]): Promise<o[]>;
+    /**
+     * Resolve the editable template (master + layout) elements a slide
+     * inherits, each carrying a `master-` / `layout-` prefixed id. Excludes
+     * placeholders; returns only decorative shapes/pictures/graphic frames.
+     *
+     * @param slideId - The slide's archive path (`PptxSlide.id`).
+     */
+    getTemplateElementsForSlide(slideId: string): Promise<P[]>;
     /**
      * Scan the loaded PPTX archive for all theme parts.
      */
@@ -1191,6 +1199,37 @@ declare class PptxHandlerCore {
      * ```
      */
     getAvailableLayoutsForSlide(slideIndex: number, slides: l[]): Promise<o[]>;
+    /**
+     * Resolve the editable template (master + layout) elements a slide
+     * inherits, each carrying a `master-` / `layout-` prefixed id.
+     *
+     * This is the foundation for an "edit template/master" feature. The
+     * returned elements are the decorative master/layout shapes the loader
+     * already merges behind slide-authored content (master shapes behind,
+     * layout shapes on top); placeholders are excluded. The same elements are
+     * shared by every slide inheriting the layout/master, so editing one and
+     * saving updates the shared part.
+     *
+     * To persist an edit, keep the mutated template element inside the
+     * `slide.elements` array passed to {@link save}; the save writer reads
+     * template elements from there and writes their shape XML back into the
+     * owning layout/master `p:spTree`.
+     *
+     * @param slideId - The slide's archive path (the `PptxSlide.id`).
+     * @returns Master + layout elements with prefixed ids (may be empty).
+     *
+     * @example
+     * ```ts
+     * const templateEls = await handler.getTemplateElementsForSlide(slide.id);
+     * const logo = templateEls.find((e) => e.id.startsWith("master-"));
+     * if (logo) {
+     *   logo.x += 10;
+     *   slide.elements = [...slide.elements, logo];
+     *   await handler.save(data.slides);
+     * }
+     * ```
+     */
+    getTemplateElementsForSlide(slideId: string): Promise<P[]>;
     /**
      * Apply a different layout to an existing slide.
      *