pptx-angular-viewer 1.11.0 → 1.11.1

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "pptx-angular-viewer",
-	"version": "1.11.0",
+	"version": "1.11.1",
 	"description": "Angular PowerPoint viewer and editor component: render, edit, and export PPTX slides in the browser.",
 	"keywords": [
 		"angular",
@@ -46,7 +46,7 @@
 		"html2canvas-pro": "^2.0.4",
 		"jspdf": "^4.2.1",
 		"jszip": "^3.10.1",
-		"pptx-viewer-core": "^1.2.4",
+		"pptx-viewer-core": "^1.2.5",
 		"tslib": "^2.8.1"
 	},
 	"peerDependencies": {

package/types/pptx-angular-viewer.d.ts

@@ -3000,7 +3000,6 @@ declare class EditorStateService {
     private zOrder;
     private commit;
     private syncHistory;
-    private clone;
     private newId;
     private idCounter;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<EditorStateService, never>;
@@ -3838,11 +3837,22 @@ declare class ViewerCustomShowsService {
     readonly activeId: _angular_core.WritableSignal<string | null>;
     /** Active-slide index of the host viewer (bound from the component). */
     private activeSlideIndex;
-    /** Wire the host's active-slide-index accessor (called once from the constructor). */
-    bind(activeSlideIndex: () => number): void;
+    /**
+     * The viewer's LIVE (edited) slides accessor, bound from the component. The
+     * presentation overlay must reflect in-session edits (inserted media, moved
+     * shapes, etc.), so it reads these rather than the pristine loaded deck
+     * (`loader.slides()`), mirroring React/Vue where present mode shows the
+     * working set. Defaults to the loaded slides until bound.
+     */
+    private liveSlides;
+    /** Wire the host's active-slide-index + live-slides accessors (called once from the constructor). */
+    bind(accessors: {
+        activeSlideIndex: () => number;
+        liveSlides: () => readonly PptxSlide[];
+    }): void;
     /** Custom shows mapped to the core shape consumed by set-up-slide-show. */
     readonly pptxCustomShows: _angular_core.Signal<PptxCustomShow[]>;
-    /** Slides shown in presentation mode: the active custom show, else the full deck. */
+    /** Slides shown in presentation mode: the active custom show, else the full (live) deck. */
     readonly presentationSlides: _angular_core.Signal<PptxSlide[]>;
     /** Start index into {@link presentationSlides}: first slide of a custom show, else the active slide. */
     readonly presentationStartIndex: _angular_core.Signal<number>;
@@ -4352,7 +4362,11 @@ declare class ViewerPresentationModeService {
     /** Wire the host accessors (called once from the component constructor). */
     bind(host: PresentationModeHost): void;
     private requireHost;
-    /** Open the fullscreen presentation overlay from the current slide. */
+    /**
+     * Open the presentation overlay from the current slide. The overlay itself
+     * (`PresentationOverlayComponent`) requests real browser fullscreen once it
+     * mounts as a result of `presenting` flipping true.
+     */
     present(): void;
     /**
      * Map a presentation-overlay index back to the full-deck `activeSlideIndex`.
@@ -4922,6 +4936,12 @@ declare class SlideCanvasComponent {
      * e2e selectors from matching multiple elements.
      */
     readonly interactive: _angular_core.InputSignal<boolean>;
+    /**
+     * True only for the live presentation stage: slide-content media autoplays.
+     * Left false for thumbnails, the sorter and the editor canvas so their media
+     * stays quiet (the template layer never autoplays regardless).
+     */
+    readonly presenting: _angular_core.InputSignal<boolean>;
     /** Ids of currently-selected elements (drawn with a selection outline). */
     readonly selectedIds: _angular_core.InputSignal<readonly string[]>;
     /** Id of the element currently being text-edited inline (or null). */
@@ -5135,7 +5155,7 @@ declare class SlideCanvasComponent {
     readonly vRulerTicks: _angular_core.Signal<readonly RulerTick[]>;
     readonly stageStyle: _angular_core.Signal<StyleMap>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<SlideCanvasComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<SlideCanvasComponent, "pptx-slide-canvas", never, { "slide": { "alias": "slide"; "required": false; "isSignal": true; }; "canvasSize": { "alias": "canvasSize"; "required": true; "isSignal": true; }; "mediaDataUrls": { "alias": "mediaDataUrls"; "required": false; "isSignal": true; }; "zoom": { "alias": "zoom"; "required": false; "isSignal": true; }; "editable": { "alias": "editable"; "required": false; "isSignal": true; }; "showGrid": { "alias": "showGrid"; "required": false; "isSignal": true; }; "showRulers": { "alias": "showRulers"; "required": false; "isSignal": true; }; "showGuides": { "alias": "showGuides"; "required": false; "isSignal": true; }; "snapToGrid": { "alias": "snapToGrid"; "required": false; "isSignal": true; }; "snapToGuides": { "alias": "snapToGuides"; "required": false; "isSignal": true; }; "autoFit": { "alias": "autoFit"; "required": false; "isSignal": true; }; "interactive": { "alias": "interactive"; "required": false; "isSignal": true; }; "selectedIds": { "alias": "selectedIds"; "required": false; "isSignal": true; }; "editingId": { "alias": "editingId"; "required": false; "isSignal": true; }; "editTemplateMode": { "alias": "editTemplateMode"; "required": false; "isSignal": true; }; "templateElements": { "alias": "templateElements"; "required": false; "isSignal": true; }; "drawTool": { "alias": "drawTool"; "required": false; "isSignal": true; }; "drawColor": { "alias": "drawColor"; "required": false; "isSignal": true; }; "drawWidth": { "alias": "drawWidth"; "required": false; "isSignal": true; }; }, { "elementSelect": "elementSelect"; "backgroundClick": "backgroundClick"; "transformStart": "transformStart"; "transformUpdate": "transformUpdate"; "contextMenu": "contextMenu"; "textEditStart": "textEditStart"; "textCommit": "textCommit"; "textCancel": "textCancel"; "textFormat": "textFormat"; "rotateUpdate": "rotateUpdate"; "marqueeSelect": "marqueeSelect"; "inkStrokeComplete": "inkStrokeComplete"; "eraserHit": "eraserHit"; "cellCommit": "cellCommit"; "tableChange": "tableChange"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<SlideCanvasComponent, "pptx-slide-canvas", never, { "slide": { "alias": "slide"; "required": false; "isSignal": true; }; "canvasSize": { "alias": "canvasSize"; "required": true; "isSignal": true; }; "mediaDataUrls": { "alias": "mediaDataUrls"; "required": false; "isSignal": true; }; "zoom": { "alias": "zoom"; "required": false; "isSignal": true; }; "editable": { "alias": "editable"; "required": false; "isSignal": true; }; "showGrid": { "alias": "showGrid"; "required": false; "isSignal": true; }; "showRulers": { "alias": "showRulers"; "required": false; "isSignal": true; }; "showGuides": { "alias": "showGuides"; "required": false; "isSignal": true; }; "snapToGrid": { "alias": "snapToGrid"; "required": false; "isSignal": true; }; "snapToGuides": { "alias": "snapToGuides"; "required": false; "isSignal": true; }; "autoFit": { "alias": "autoFit"; "required": false; "isSignal": true; }; "interactive": { "alias": "interactive"; "required": false; "isSignal": true; }; "presenting": { "alias": "presenting"; "required": false; "isSignal": true; }; "selectedIds": { "alias": "selectedIds"; "required": false; "isSignal": true; }; "editingId": { "alias": "editingId"; "required": false; "isSignal": true; }; "editTemplateMode": { "alias": "editTemplateMode"; "required": false; "isSignal": true; }; "templateElements": { "alias": "templateElements"; "required": false; "isSignal": true; }; "drawTool": { "alias": "drawTool"; "required": false; "isSignal": true; }; "drawColor": { "alias": "drawColor"; "required": false; "isSignal": true; }; "drawWidth": { "alias": "drawWidth"; "required": false; "isSignal": true; }; }, { "elementSelect": "elementSelect"; "backgroundClick": "backgroundClick"; "transformStart": "transformStart"; "transformUpdate": "transformUpdate"; "contextMenu": "contextMenu"; "textEditStart": "textEditStart"; "textCommit": "textCommit"; "textCancel": "textCancel"; "textFormat": "textFormat"; "rotateUpdate": "rotateUpdate"; "marqueeSelect": "marqueeSelect"; "inkStrokeComplete": "inkStrokeComplete"; "eraserHit": "eraserHit"; "cellCommit": "cellCommit"; "tableChange": "tableChange"; }, never, never, true, never>;
 }
 
 /**
@@ -5331,6 +5351,12 @@ declare class ElementRendererComponent {
      * separate lightweight renderer).
      */
     readonly interactive: _angular_core.InputSignal<boolean>;
+    /**
+     * True only on the live presentation stage; threaded to the media renderer so
+     * a slide's media autoplays when the slide becomes active (and to group
+     * children so nested media autoplays too). False everywhere else.
+     */
+    readonly presenting: _angular_core.InputSignal<boolean>;
     /** Whether inline editing (e.g. table-cell text input) is enabled. */
     readonly editable: _angular_core.InputSignal<boolean>;
     /**
@@ -5395,7 +5421,7 @@ declare class ElementRendererComponent {
     readonly hasText: _angular_core.Signal<boolean>;
     readonly placeholderLabel: _angular_core.Signal<string>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<ElementRendererComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<ElementRendererComponent, "pptx-element-renderer", never, { "element": { "alias": "element"; "required": true; "isSignal": true; }; "mediaDataUrls": { "alias": "mediaDataUrls"; "required": false; "isSignal": true; }; "zIndex": { "alias": "zIndex"; "required": false; "isSignal": true; }; "obstacles": { "alias": "obstacles"; "required": false; "isSignal": true; }; "canvasWidth": { "alias": "canvasWidth"; "required": false; "isSignal": true; }; "canvasHeight": { "alias": "canvasHeight"; "required": false; "isSignal": true; }; "interactive": { "alias": "interactive"; "required": false; "isSignal": true; }; "editable": { "alias": "editable"; "required": false; "isSignal": true; }; "fieldContext": { "alias": "fieldContext"; "required": false; "isSignal": true; }; "editTemplateMode": { "alias": "editTemplateMode"; "required": false; "isSignal": true; }; }, { "cellCommit": "cellCommit"; "tableChange": "tableChange"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<ElementRendererComponent, "pptx-element-renderer", never, { "element": { "alias": "element"; "required": true; "isSignal": true; }; "mediaDataUrls": { "alias": "mediaDataUrls"; "required": false; "isSignal": true; }; "zIndex": { "alias": "zIndex"; "required": false; "isSignal": true; }; "obstacles": { "alias": "obstacles"; "required": false; "isSignal": true; }; "canvasWidth": { "alias": "canvasWidth"; "required": false; "isSignal": true; }; "canvasHeight": { "alias": "canvasHeight"; "required": false; "isSignal": true; }; "interactive": { "alias": "interactive"; "required": false; "isSignal": true; }; "presenting": { "alias": "presenting"; "required": false; "isSignal": true; }; "editable": { "alias": "editable"; "required": false; "isSignal": true; }; "fieldContext": { "alias": "fieldContext"; "required": false; "isSignal": true; }; "editTemplateMode": { "alias": "editTemplateMode"; "required": false; "isSignal": true; }; }, { "cellCommit": "cellCommit"; "tableChange": "tableChange"; }, never, never, true, never>;
 }
 
 /**
@@ -5877,6 +5903,13 @@ declare class OleRendererComponent {
      * when no rows are available.
      */
     readonly infoTitle: _angular_core.Signal<string>;
+    /**
+     * Open the recovered embedded payload in a new browser tab. Routes through
+     * the shared {@link openUrlInNewTab} helper, which converts the `data:` URL to
+     * a Blob object URL first: browsers silently refuse to navigate a new
+     * top-level tab straight to a `data:` URL.
+     */
+    openEmbedded(): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<OleRendererComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<OleRendererComponent, "pptx-ole-renderer", never, { "element": { "alias": "element"; "required": true; "isSignal": true; }; "zIndex": { "alias": "zIndex"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
@@ -6272,6 +6305,17 @@ declare class PresentationAnnotationsService {
  *   Horizontal swipe                    → left → next, right → previous
  *
  * Click on the overlay body → advance to next visible slide.
+ *
+ * Fullscreen (mirrors the React `usePresentationMode` / Vue `PresentationMode.vue`
+ * behavior, on top of the CSS-fixed full-viewport overlay above): the real
+ * Fullscreen API is requested on this component's root element once it mounts,
+ * and released again on destroy, so the browser chrome (address bar, etc.) gets
+ * out of the way on mobile the same way it does for React/Vue. A
+ * `fullscreenchange` listener syncs back to `closed` when fullscreen is exited
+ * from outside this component's own close/Escape handling (browser UI, the
+ * Android back gesture, etc.). Environments without Fullscreen API support
+ * (iOS Safari's partial support, `jsdom` in tests) degrade silently to the
+ * plain CSS overlay.
  */
 declare class PresentationOverlayComponent implements OnInit {
     readonly slides: _angular_core.InputSignal<PptxSlide[]>;
@@ -6309,8 +6353,19 @@ declare class PresentationOverlayComponent implements OnInit {
     protected readonly subtitlesVisible: _angular_core.WritableSignal<boolean>;
     /** The slide stage root; animation styles are applied to its elements. */
     private readonly stageRef;
-    /** The overlay root; the shared touch-gesture recogniser attaches here. */
+    /**
+     * The overlay root; the shared touch-gesture recogniser attaches here, and
+     * it is the element the real Fullscreen API is requested on (see
+     * {@link setupFullscreen}).
+     */
     private readonly rootRef;
+    /**
+     * Guards against handling the same exit twice: e.g. Escape both reaches our
+     * own `keydown` handler AND causes the browser to natively exit fullscreen
+     * (firing `fullscreenchange`), or the close button's `click` and `touchend`
+     * both fire for one tap.
+     */
+    private closing;
     constructor();
     /**
      * Imperatively apply animation reveal / pending CSS to the slide's element
@@ -6349,6 +6404,24 @@ declare class PresentationOverlayComponent implements OnInit {
      * (afterNextRender) and is torn down on destroy.
      */
     private setupTouchGestures;
+    /**
+     * Request real fullscreen on the overlay root once it mounts, and release
+     * it again when the overlay is destroyed (`presenting` flips back to
+     * false, closing this `@if` block). Mirrors Vue's `onMounted` /
+     * `onBeforeUnmount` pair on its own overlay root; feature-detected so
+     * unsupported environments just keep the CSS overlay.
+     */
+    private setupFullscreen;
+    /**
+     * Sync back to `closed` when fullscreen is exited from OUTSIDE this
+     * component's own close/Escape handling: the browser's native Esc handling
+     * can beat (or replace) our `keydown` listener, and mobile back
+     * gestures/browser-UI exits never reach it at all. Without this, `presenting`
+     * would stay stuck true while the app has silently fallen back to the plain
+     * CSS overlay. `emitClosed()` is itself guarded against double-firing, so it
+     * is safe if our own close flow *also* triggers this event.
+     */
+    protected onFullscreenChange(): void;
     ngOnInit(): void;
     onWindowResize(): void;
     private snapViewport;