pptx-angular-viewer 3.1.1 → 3.2.0

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

@@ -5563,6 +5563,24 @@ declare function sampleColorFromSlide(clientX: number, clientY: number): Eyedrop
  */
 declare function pickColorByClickFallback(): Promise<string | null>;
 
+/**
+ * Slide-show right-click menu: shared item structure for every binding.
+ *
+ * PowerPoint shows a minimal Next/Previous/See All Slides/Presenter View menu
+ * (plus pointer tools, blank-screen and End Presentation) when you right-click
+ * during a slide show and Options > Advanced > "Show menu on right mouse
+ * click" is on. React built the full menu first (`PresentationContextMenu`);
+ * this module gives Vue/Angular/Svelte/Vanilla the same item order, grouping
+ * and i18n keys instead of each hand-porting React's JSX structure and
+ * drifting. A binding maps `getPresentationContextMenuSections` onto its own
+ * menu component and wires each action id to whatever handler it already
+ * uses for its toolbar's equivalent button; a capability the binding lacks
+ * (e.g. no "See All Slides" grid) is simply left out of `capabilities`, and
+ * the section/item is omitted rather than rendered disabled.
+ */
+/** One selectable action in the slide-show right-click menu. */
+type PresentationContextMenuActionId = 'next' | 'previous' | 'seeAllSlides' | 'presenterView' | 'pointerArrow' | 'pointerPen' | 'pointerHighlighter' | 'pointerLaser' | 'eraseInk' | 'blankBlack' | 'blankWhite' | 'endShow';
+
 /**
  * How much elapsed time one fill of the console's progress bar represents.
  *
@@ -6999,6 +7017,15 @@ interface ViewerAdvancedOptions {
     showGrid: boolean;
     snapToGrid: boolean;
     disableHardwareAcceleration: boolean;
+    /**
+     * Force every opt-in interactive 3D scene (SmartArt, bar/line/area/pie/
+     * surface charts) to fall back to its flat 2D rendering, even when the
+     * host has enabled that scene via its own `smartArt3D`/`*Chart3D` prop.
+     * A host opting in says "this deck may want 3D"; this is the viewer
+     * user's own override for when the WebGL scenes it renders are too much
+     * for their machine. See `resolve3DRenderingFlags`.
+     */
+    disable3DRendering: boolean;
     openDocumentsView: OpenDocumentsView;
     slideShowShowMenuOnRightClick: boolean;
     slideShowShowPopupToolbar: boolean;
@@ -7127,6 +7154,17 @@ interface PrintSettings {
     slideRange: PrintSlideRange;
     customRangeFrom: number;
     customRangeTo: number;
+    /**
+     * PowerPoint's Print > "Scale to Fit Paper". `true` (the default, and the
+     * only behavior this printed output ever had before this field existed)
+     * shrinks/grows each slide image to fill its page/cell while preserving
+     * aspect ratio. `false` prints at the slide's native pixel size instead,
+     * which may overflow or under-fill the page, exactly like PowerPoint with
+     * the option off. Optional so existing `Partial<PrintSettings>` literals
+     * across every binding keep compiling; `validatePrintSettings` defaults it
+     * to `true`.
+     */
+    scaleToFit?: boolean;
 }
 /** Default print settings used when the dialog opens. */
 declare const DEFAULT_PRINT_SETTINGS: PrintSettings;
@@ -7162,6 +7200,14 @@ interface PrintHtmlDocumentOptions {
     orientation: PrintOrientation;
     colorFilter: string;
     frameSlides: boolean;
+    /**
+     * PowerPoint's Print > "Scale to Fit Paper". Defaults to `true` (shrink/grow
+     * each slide image to fill its page/cell, the only behavior this printed
+     * output ever had before this option existed). `false` prints images at
+     * their native size instead, which may overflow (clipped by the cell's
+     * `overflow: hidden`) or under-fill the page/cell.
+     */
+    scaleToFit?: boolean;
 }
 /**
  * Assemble the complete printable HTML document string (doctype + head with
@@ -8552,6 +8598,11 @@ declare class EditorStateService {
      */
     private readonly translate;
     private readonly history;
+    /**
+     * Apply File > Options > Advanced > "Maximum number of undos" at runtime.
+     * Trims the past stack immediately if the new limit is smaller.
+     */
+    setHistoryDepth(depth: number): void;
     /**
      * Resolve a translation. Outside an injection context (see {@link translate})
      * falls back to the canonical English dictionary text, then the raw key.
@@ -9010,6 +9061,12 @@ declare class LoadContentService {
     private handler;
     private renderToken;
     private activeBlobUrls;
+    /**
+     * Optional: `inject()` needs an active injection context, which the
+     * colocated unit tests construct this service without. Trust Center >
+     * "Allow external content" reads through this when present.
+     */
+    private readonly optionsService;
     constructor();
     /**
      * Serialise the current (loaded) presentation back to `.pptx` bytes.
@@ -9208,10 +9265,15 @@ declare class PrintService {
     print(rawSettings: PrintSettings, slides: PptxSlide[], activeSlideIndex: number, captureSlide: CaptureSlideFn, slideSize?: Readonly<{
         width: number;
         height: number;
-    }>): Promise<boolean>;
+    }>, 
+    /** Options > Advanced > "Print hidden slides". Defaults to PowerPoint's own default (excluded). */
+    includeHiddenSlides?: boolean): Promise<boolean>;
     /**
-     * Open a print window, write the document, focus, and trigger printing.
-     * Returns `false` if the popup was blocked.
+     * Open a print window, write the document, focus, and trigger printing, all
+     * in one synchronous call. Used by the outline/slides paths, which never
+     * `await` before this point so the window is never at risk of being popup
+     * blocked -- no need for the placeholder-then-real-document split `print`'s
+     * notes/handouts branch needs (see `openPendingPrintWindow`/`finishPrintWindow`).
      */
     private _open;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<PrintService, never>;
@@ -9695,6 +9757,8 @@ declare class ViewerCanvasEditingService {
     private readonly dialogs;
     private readonly formatPainter;
     private readonly collab;
+    /** Options > Proofing > AutoCorrect, applied to committed inline-edit text. */
+    private readonly viewerOpts;
     /** Id of the element being inline text-edited, or null. */
     readonly editingId: _angular_core.WritableSignal<string | null>;
     /** Open editor context-menu position (client coords), or null. */
@@ -9861,6 +9925,7 @@ interface CollaborationSessionHost {
 }
 declare class ViewerCollaborationSessionService {
     private readonly collab;
+    private readonly viewerOpts;
     /** Share (collaboration) dialog visibility. */
     readonly showShare: _angular_core.WritableSignal<boolean>;
     /** Broadcast dialog visibility. */
@@ -10123,6 +10188,14 @@ interface ExportHost {
     readonly mergedSlides: () => readonly PptxSlide[];
     /** Resolve the live slide-stage element, or `undefined` when not mounted. */
     readonly resolveStage: () => HTMLElement | undefined;
+    /**
+     * File > Options > Advanced > "Image Size and Quality"
+     * (`resolveImageResolutionScale`), read fresh for every PNG/PDF capture.
+     * Not applied to GIF/video (those intentionally stay at their own fixed
+     * capture resolution). Defaults to 2 (the pre-existing hardcoded value)
+     * when omitted.
+     */
+    readonly imageExportScale?: () => number;
 }
 declare class ViewerExportService {
     private readonly exportSvc;
@@ -10156,7 +10229,13 @@ declare class ViewerExportService {
     exportGif(): Promise<void>;
     /** Export every slide as a WebM video (3s per slide) via MediaRecorder. */
     exportVideo(): Promise<void>;
-    onPrint(settings: PrintSettings): Promise<void>;
+    /**
+     * `includeHiddenSlides`: Options > Advanced > "Print hidden slides".
+     * `highQuality`: Options > Advanced > "High quality" raster scale for the
+     * notes/handouts fallback path, composed on top of the host's own Image
+     * Size/Quality scale.
+     */
+    onPrint(settings: PrintSettings, includeHiddenSlides?: boolean, highQuality?: boolean): Promise<void>;
     onCancelExport(): void;
     /**
      * Open the progress modal and arm a fresh `AbortController` for an export.
@@ -10169,7 +10248,12 @@ declare class ViewerExportService {
      * per-slide progress and bailing out cooperatively when `abortSignal.aborted`.
      */
     private captureSlideCanvases;
-    /** Flip the live stage to `index`, let it settle, and capture it to a PNG data URL. */
+    /**
+     * Flip the live stage to `index`, let it settle, and capture it to a PNG
+     * data URL. `scale` defaults to the host's own Image Size/Quality scale
+     * (matching PNG/PDF export); the print notes/handouts path passes a higher
+     * value when Options > Advanced > "High quality" is on.
+     */
     private captureSlideDataUrl;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<ViewerExportService, never>;
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<ViewerExportService>;
@@ -10190,6 +10274,12 @@ interface FileIOHost {
      * encrypted OLE2 container instead of a plain ZIP.
      */
     readonly saveIntent: () => DeckSaveIntent;
+    /**
+     * Options > Accessibility > "feedback with sound", and Options > Save >
+     * "keep the last AutoRecover version": run once a Save/Save-As download
+     * actually completes.
+     */
+    readonly afterSuccessfulSave: (format: PptxSaveFormat) => void;
 }
 declare class ViewerFileIOService {
     private readonly loader;
@@ -10228,8 +10318,6 @@ declare class ViewerFileIOService {
      * `sourceName` (the host `fileName` input) seeds the download filename.
      */
     exportJson(sourceName?: string | null): void;
-    /** Bundle the presentation and its usage notes in a shareable ZIP archive. */
-    packageForSharing(): Promise<void>;
     /**
      * File ▸ Open: host override (`onOpenFile` input) takes precedence; otherwise
      * a built-in native picker loads the chosen presentation in place.
@@ -10519,6 +10607,15 @@ declare class ViewerOptionsService {
     historyDepth(): number;
     /** AutoRecover cadence in seconds for the autosave engine. */
     autosaveIntervalSeconds(): number;
+    /**
+     * Raster-scale multiplier for PNG/PDF export and copy-slide-as-image.
+     * Multiplied against the pre-existing 2x baseline (not used outright) so
+     * the default "High fidelity" preset (raw multiplier 1) keeps today's
+     * export quality instead of silently downgrading it; the explicit ppi
+     * presets still scale proportionally from that baseline. Mirrors the
+     * vanilla/vue/svelte bindings.
+     */
+    imageExportScale(): number;
     /** Print-dialog seed; `undefined` keeps the dialog's own recents. */
     printDefaults(): Partial<PrintSettings> | undefined;
     /** Option-driven CSS classes for the viewer root (`pptx-ng-*` prefixed). */
@@ -10541,6 +10638,17 @@ declare class ViewerOptionsService {
      * snapshot from the shared IndexedDB store. Resolves with the purge count.
      */
     clearCache(): Promise<number>;
+    /**
+     * Options > Save > "keep the last AutoRecover version": whether a
+     * successful `.pptx` save should discard the AutoRecover snapshot for the
+     * deck just saved (PowerPoint's default: the real file already has the
+     * work, so the snapshot is stale unless the user asked to keep it).
+     */
+    shouldDiscardAutosaveOnSave(): boolean;
+    /** Options > Save > "clear cache on close": whether to wipe snapshots now. */
+    shouldClearCacheOnClose(): boolean;
+    /** Options > Save > "cache retention": prune snapshots older than N days. */
+    pruneExpiredCache(): Promise<void>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<ViewerOptionsService, never>;
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<ViewerOptionsService>;
 }
@@ -10973,12 +11081,46 @@ declare class PowerPointViewerComponent implements PowerPointViewerAPI {
     private readonly encryptedNotice;
     /** The `<main>` host; used to locate the live `.pptx-ng-canvas-stage`. */
     private readonly mainEl;
+    /**
+     * Whether the CURRENT document's Protected View lock was lifted via the
+     * banner's "Enable Editing" button this session. A document the host
+     * opened read-only (`canEditInput()` false) never shows the banner, so
+     * there is nothing to dismiss for it; reset to `false` whenever a new
+     * presentation finishes loading (see the `loader.slides()` effect below),
+     * so re-opening (or opening another) file starts protected again,
+     * mirroring PowerPoint's own per-document banner.
+     */
+    protected readonly protectedViewDismissed: _angular_core.WritableSignal<boolean>;
     /**
      * Effective edit permission: the host's `canEdit` input gated by Trust
      * Center > "Open presentations in Protected View", which forces the deck
-     * read-only while enabled (File > Options wiring, mirrors PowerPoint).
+     * read-only while enabled (File > Options wiring, mirrors PowerPoint),
+     * unless the user has lifted it via `enableEditing()` for this document.
      */
     protected readonly canEdit: _angular_core.Signal<boolean>;
+    /** Whether the Protected View banner should show: host allows editing, the option still blocks it, and the user hasn't dismissed it yet. */
+    protected readonly protectedViewActive: _angular_core.Signal<boolean>;
+    /** Lift Protected View's read-only lock for the current document (File > Options > Trust Center). */
+    protected enableEditing(): void;
+    /**
+     * Toolbar/ribbon ids to hide: the host's own `hiddenActions` input, UNIONED
+     * with File > Options > Customize Ribbon's `ribbon.hiddenTabIds` (see
+     * {@link mergeHiddenActions}). Every chrome component downstream (ribbon,
+     * title bar, mobile toolbar/menu, status bar) must see BOTH, or ticking a
+     * tab off in Customize Ribbon changes what the pane displays without
+     * changing what actually renders.
+     */
+    protected readonly effectiveHiddenActions: _angular_core.Signal<ToolbarActionId[]>;
+    /**
+     * File > Options > Quick Access Toolbar > Position "Below the Ribbon": the
+     * configured commands beyond the dedicated Save/Undo/Redo trio (which stay
+     * in the title bar regardless of position), or `null` when the strip has
+     * nothing to show there (hidden, `above`, or no extra commands configured).
+     * {@link TitleBarComponent} independently suppresses its own inline strip
+     * under the identical {@link resolveBelowRibbonQuickAccess} condition, so
+     * the commands render in exactly one place.
+     */
+    protected readonly belowRibbonQuickAccess: _angular_core.Signal<ViewerQuickAccessOptions | null>;
     protected readonly activeSlideIndex: _angular_core.WritableSignal<number>;
     /**
      * True in an audience display once the presenter ended the session and the
@@ -11354,6 +11496,11 @@ declare class PowerPointViewerComponent implements PowerPointViewerAPI {
         color: string;
         width: number;
     }): void;
+    /**
+     * Comment/reply author: the host `authorName` input wins, otherwise fall
+     * back to Options > General > "User name" before the generic "You".
+     */
+    private commentAuthorName;
     /** Append a comment to the active slide (one history entry). */
     onCommentAdd(text: string): void;
     /** Remove a comment from the active slide. */
@@ -11383,6 +11530,8 @@ declare class PowerPointViewerComponent implements PowerPointViewerAPI {
      * is delegated to {@link ViewerKeyboardService}.
      */
     onKeyDown(event: KeyboardEvent): void;
+    /** Options > Save > "clear cache on close": wipe recovery snapshots when the tab closes. */
+    protected clearCacheOnUnload(): void;
     /** Resolve the live slide-stage element within `<main>`. */
     private stageElement;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<PowerPointViewerComponent, never>;
@@ -11715,6 +11864,7 @@ declare class ViewerCompareService {
     private readonly svc;
     private readonly editor;
     private readonly translate;
+    private readonly optionsService;
     /**
      * Open a `.pptx` picker and diff it against the current deck, opening the
      * compare panel with the result. Invoked from the ribbon.
@@ -12431,7 +12581,6 @@ declare class RibbonComponent {
     readonly save: _angular_core.OutputEmitterRef<void>;
     readonly savePpsx: _angular_core.OutputEmitterRef<void>;
     readonly savePptm: _angular_core.OutputEmitterRef<void>;
-    readonly packageForSharing: _angular_core.OutputEmitterRef<void>;
     /** Emitted when the user toggles the slides panel from the top bar. */
     readonly toggleSidebar: _angular_core.OutputEmitterRef<void>;
     /** Emitted when the user clicks the AI assistant Sparkles toggle. */
@@ -12530,7 +12679,7 @@ declare class RibbonComponent {
     /** Forward the Review proofing toggle to the viewer-owned live state. */
     protected setSpellCheck(enabled: boolean): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<RibbonComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<RibbonComponent, "pptx-ribbon", never, { "slideIndex": { "alias": "slideIndex"; "required": false; "isSignal": true; }; "slideCount": { "alias": "slideCount"; "required": false; "isSignal": true; }; "canEdit": { "alias": "canEdit"; "required": false; "isSignal": true; }; "selectedElement": { "alias": "selectedElement"; "required": false; "isSignal": true; }; "zoomPercent": { "alias": "zoomPercent"; "required": false; "isSignal": true; }; "formatPainterActive": { "alias": "formatPainterActive"; "required": false; "isSignal": true; }; "canActivateFormatPainter": { "alias": "canActivateFormatPainter"; "required": false; "isSignal": true; }; "exporting": { "alias": "exporting"; "required": false; "isSignal": true; }; "hasMacros": { "alias": "hasMacros"; "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; }; "snapToShape": { "alias": "snapToShape"; "required": false; "isSignal": true; }; "eyedropperActive": { "alias": "eyedropperActive"; "required": false; "isSignal": true; }; "themeGalleryOpen": { "alias": "themeGalleryOpen"; "required": false; "isSignal": true; }; "sidebarCollapsed": { "alias": "sidebarCollapsed"; "required": false; "isSignal": true; }; "inspectorOpen": { "alias": "inspectorOpen"; "required": false; "isSignal": true; }; "commentsOpen": { "alias": "commentsOpen"; "required": false; "isSignal": true; }; "commentCount": { "alias": "commentCount"; "required": false; "isSignal": true; }; "findOpen": { "alias": "findOpen"; "required": false; "isSignal": true; }; "collabConnected": { "alias": "collabConnected"; "required": false; "isSignal": true; }; "connectedCount": { "alias": "connectedCount"; "required": false; "isSignal": true; }; "spellCheckEnabled": { "alias": "spellCheckEnabled"; "required": false; "isSignal": true; }; "showSubtitles": { "alias": "showSubtitles"; "required": false; "isSignal": true; }; "hiddenActions": { "alias": "hiddenActions"; "required": false; "isSignal": true; }; "aiEnabled": { "alias": "aiEnabled"; "required": false; "isSignal": true; }; "aiPanelOpen": { "alias": "aiPanelOpen"; "required": false; "isSignal": true; }; "accountAuth": { "alias": "accountAuth"; "required": false; "isSignal": true; }; "activeSlideHidden": { "alias": "activeSlideHidden"; "required": false; "isSignal": true; }; }, { "prev": "prev"; "next": "next"; "zoomIn": "zoomIn"; "zoomOut": "zoomOut"; "zoomReset": "zoomReset"; "find": "find"; "present": "present"; "presenter": "presenter"; "record": "record"; "presentFromBeginning": "presentFromBeginning"; "rehearseTimings": "rehearseTimings"; "toggleSubtitles": "toggleSubtitles"; "openSubtitleSettings": "openSubtitleSettings"; "recordFromBeginning": "recordFromBeginning"; "recordFromCurrent": "recordFromCurrent"; "spellCheckChange": "spellCheckChange"; "share": "share"; "broadcast": "broadcast"; "openFile": "openFile"; "openRecentFile": "openRecentFile"; "createPresentation": "createPresentation"; "save": "save"; "savePpsx": "savePpsx"; "savePptm": "savePptm"; "packageForSharing": "packageForSharing"; "toggleSidebar": "toggleSidebar"; "toggleAiPanel": "toggleAiPanel"; "signatures": "signatures"; "info": "info"; "print": "print"; "comments": "comments"; "a11y": "a11y"; "shortcuts": "shortcuts"; "versionHistory": "versionHistory"; "passwordProtection": "passwordProtection"; "fontEmbedding": "fontEmbedding"; "link": "link"; "openSorter": "openSorter"; "openReadingView": "openReadingView"; "openOutlineView": "openOutlineView"; "openMasterView": "openMasterView"; "toggleNotes": "toggleNotes"; "toggleFormatPainter": "toggleFormatPainter"; "exportPng": "exportPng"; "exportPdf": "exportPdf"; "exportGif": "exportGif"; "exportVideo": "exportVideo"; "exportJson": "exportJson"; "copySlideAsImage": "copySlideAsImage"; "replace": "replace"; "toggleInspector": "toggleInspector"; "drawToolChange": "drawToolChange"; "toggleThemeGallery": "toggleThemeGallery"; "editTheme": "editTheme"; "openSlideSize": "openSlideSize"; "toggleGrid": "toggleGrid"; "toggleRulers": "toggleRulers"; "toggleGuides": "toggleGuides"; "toggleSelectionPane": "toggleSelectionPane"; "openCustomShows": "openCustomShows"; "toggleSnapToGrid": "toggleSnapToGrid"; "toggleSnapToShape": "toggleSnapToShape"; "addGuide": "addGuide"; "zoomToFit": "zoomToFit"; "toggleEyedropper": "toggleEyedropper"; "openSmartArtDialog": "openSmartArtDialog"; "openTemplateGallery": "openTemplateGallery"; "openEquationDialog": "openEquationDialog"; "openSetUpSlideShow": "openSetUpSlideShow"; "toggleHideSlide": "toggleHideSlide"; "openCompare": "openCompare"; "openPassword": "openPassword"; "openFontEmbedding": "openFontEmbedding"; "openVersionHistory": "openVersionHistory"; "openShortcuts": "openShortcuts"; "openSettings": "openSettings"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<RibbonComponent, "pptx-ribbon", never, { "slideIndex": { "alias": "slideIndex"; "required": false; "isSignal": true; }; "slideCount": { "alias": "slideCount"; "required": false; "isSignal": true; }; "canEdit": { "alias": "canEdit"; "required": false; "isSignal": true; }; "selectedElement": { "alias": "selectedElement"; "required": false; "isSignal": true; }; "zoomPercent": { "alias": "zoomPercent"; "required": false; "isSignal": true; }; "formatPainterActive": { "alias": "formatPainterActive"; "required": false; "isSignal": true; }; "canActivateFormatPainter": { "alias": "canActivateFormatPainter"; "required": false; "isSignal": true; }; "exporting": { "alias": "exporting"; "required": false; "isSignal": true; }; "hasMacros": { "alias": "hasMacros"; "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; }; "snapToShape": { "alias": "snapToShape"; "required": false; "isSignal": true; }; "eyedropperActive": { "alias": "eyedropperActive"; "required": false; "isSignal": true; }; "themeGalleryOpen": { "alias": "themeGalleryOpen"; "required": false; "isSignal": true; }; "sidebarCollapsed": { "alias": "sidebarCollapsed"; "required": false; "isSignal": true; }; "inspectorOpen": { "alias": "inspectorOpen"; "required": false; "isSignal": true; }; "commentsOpen": { "alias": "commentsOpen"; "required": false; "isSignal": true; }; "commentCount": { "alias": "commentCount"; "required": false; "isSignal": true; }; "findOpen": { "alias": "findOpen"; "required": false; "isSignal": true; }; "collabConnected": { "alias": "collabConnected"; "required": false; "isSignal": true; }; "connectedCount": { "alias": "connectedCount"; "required": false; "isSignal": true; }; "spellCheckEnabled": { "alias": "spellCheckEnabled"; "required": false; "isSignal": true; }; "showSubtitles": { "alias": "showSubtitles"; "required": false; "isSignal": true; }; "hiddenActions": { "alias": "hiddenActions"; "required": false; "isSignal": true; }; "aiEnabled": { "alias": "aiEnabled"; "required": false; "isSignal": true; }; "aiPanelOpen": { "alias": "aiPanelOpen"; "required": false; "isSignal": true; }; "accountAuth": { "alias": "accountAuth"; "required": false; "isSignal": true; }; "activeSlideHidden": { "alias": "activeSlideHidden"; "required": false; "isSignal": true; }; }, { "prev": "prev"; "next": "next"; "zoomIn": "zoomIn"; "zoomOut": "zoomOut"; "zoomReset": "zoomReset"; "find": "find"; "present": "present"; "presenter": "presenter"; "record": "record"; "presentFromBeginning": "presentFromBeginning"; "rehearseTimings": "rehearseTimings"; "toggleSubtitles": "toggleSubtitles"; "openSubtitleSettings": "openSubtitleSettings"; "recordFromBeginning": "recordFromBeginning"; "recordFromCurrent": "recordFromCurrent"; "spellCheckChange": "spellCheckChange"; "share": "share"; "broadcast": "broadcast"; "openFile": "openFile"; "openRecentFile": "openRecentFile"; "createPresentation": "createPresentation"; "save": "save"; "savePpsx": "savePpsx"; "savePptm": "savePptm"; "toggleSidebar": "toggleSidebar"; "toggleAiPanel": "toggleAiPanel"; "signatures": "signatures"; "info": "info"; "print": "print"; "comments": "comments"; "a11y": "a11y"; "shortcuts": "shortcuts"; "versionHistory": "versionHistory"; "passwordProtection": "passwordProtection"; "fontEmbedding": "fontEmbedding"; "link": "link"; "openSorter": "openSorter"; "openReadingView": "openReadingView"; "openOutlineView": "openOutlineView"; "openMasterView": "openMasterView"; "toggleNotes": "toggleNotes"; "toggleFormatPainter": "toggleFormatPainter"; "exportPng": "exportPng"; "exportPdf": "exportPdf"; "exportGif": "exportGif"; "exportVideo": "exportVideo"; "exportJson": "exportJson"; "copySlideAsImage": "copySlideAsImage"; "replace": "replace"; "toggleInspector": "toggleInspector"; "drawToolChange": "drawToolChange"; "toggleThemeGallery": "toggleThemeGallery"; "editTheme": "editTheme"; "openSlideSize": "openSlideSize"; "toggleGrid": "toggleGrid"; "toggleRulers": "toggleRulers"; "toggleGuides": "toggleGuides"; "toggleSelectionPane": "toggleSelectionPane"; "openCustomShows": "openCustomShows"; "toggleSnapToGrid": "toggleSnapToGrid"; "toggleSnapToShape": "toggleSnapToShape"; "addGuide": "addGuide"; "zoomToFit": "zoomToFit"; "toggleEyedropper": "toggleEyedropper"; "openSmartArtDialog": "openSmartArtDialog"; "openTemplateGallery": "openTemplateGallery"; "openEquationDialog": "openEquationDialog"; "openSetUpSlideShow": "openSetUpSlideShow"; "toggleHideSlide": "toggleHideSlide"; "openCompare": "openCompare"; "openPassword": "openPassword"; "openFontEmbedding": "openFontEmbedding"; "openVersionHistory": "openVersionHistory"; "openShortcuts": "openShortcuts"; "openSettings": "openSettings"; }, never, never, true, never>;
 }
 
 /** The eight resize-handle positions around a selection box. */
@@ -13024,6 +13173,8 @@ declare class SlideCanvasComponent implements SlideContext {
      */
     private readonly fieldContextSvc;
     readonly fieldContext: _angular_core.Signal<FieldSubstitutionContext | undefined>;
+    /** Options > Proofing > AutoCorrect, applied to committed inline-edit text. */
+    private readonly viewerOpts;
     /**
      * Obstacle rects (absolute slide coords) for connector A* routing: every
      * non-connector element with a positive footprint. Bent connectors detour
@@ -13499,6 +13650,12 @@ declare class ElementRendererComponent {
      */
     private readonly playback;
     private readonly translate;
+    /**
+     * Optional so this renderer still works outside a `PowerPointViewerComponent`
+     * host (thumbnails, export): a text-run hyperlink click is then never
+     * confirmed, matching the option's own default meaning ("not configured").
+     */
+    private readonly viewerOpts;
     readonly smartArt3D: _angular_core.Signal<boolean>;
     /**
      * Whether the Selection Pane has hidden this element. Drives the empty first
@@ -13688,6 +13845,13 @@ declare class ElementRendererComponent {
      * sub-animations, otherwise the whole box just fades as one.
      */
     readonly textBuildSpecs: _angular_core.Signal<(TextBuildSpec<StyleMap> | undefined)[]>;
+    /**
+     * Trust Center > "Confirm before opening external hyperlinks" gate for a
+     * text-run hyperlink (`<a class="pptx-ng-link">`). The anchor's own `href` /
+     * `target="_blank"` still does the actual navigation; this only vetoes it
+     * via `preventDefault()` when the user declines the prompt.
+     */
+    protected onHyperlinkClick(event: MouseEvent, href: string): void;
     /** Whole-paragraph text, for the paragraph-level build wrapper. */
     protected paragraphText(para: Paragraph): string;
     /** Style for one build piece, merged over the run's own style. */
@@ -15261,6 +15425,14 @@ interface PresentationInputDeps {
     showAllSlides: () => void;
     /** End the show; the component guards against double-closing. */
     requestClose: () => void;
+    /**
+     * Trust Center > "Confirm before opening external hyperlinks" gate for an
+     * on-slide action click (`a:hlinkClick`) that resolves to an external URL.
+     * Return `true` to allow the navigation, `false` to block it. Omitted (or
+     * absent) means "always allow", matching `shouldConfirmExternalHyperlink`
+     * with the option off.
+     */
+    confirmExternalHyperlink?: (href: string) => boolean;
 }
 declare class PresentationInputController {
     private readonly deps;
@@ -15282,6 +15454,12 @@ declare class PresentationInputController {
     /**
      * Run any on-slide action under the pointer, and report what the click left
      * for the show: only `'advance'` reaches {@link advanceFromClick}.
+     *
+     * Reimplements `handlePresentationStageClick`'s classify-then-run in two
+     * steps (rather than calling it directly) so an `openUrl` intent can be
+     * gated by Trust Center > "Confirm before opening external hyperlinks"
+     * before the navigation actually runs. A declined confirmation still
+     * consumes the click (PowerPoint does not also advance the slide).
      */
     private handleActionClick;
     /**
@@ -15319,6 +15497,12 @@ declare class PresentationInputController {
  */
 declare class PresentationOverlayComponent implements OnInit {
     protected readonly presenterWindow: PresenterWindowService;
+    /**
+     * Optional so this overlay still renders in isolation (Storybook-style
+     * usage, tests): outside a `PowerPointViewerComponent` host that provides
+     * it, external-hyperlink clicks are simply never confirmed.
+     */
+    private readonly viewerOpts;
     readonly slides: _angular_core.InputSignal<PptxSlide[]>;
     readonly canvasSize: _angular_core.InputSignal<CanvasSize>;
     readonly mediaDataUrls: _angular_core.InputSignal<Map<string, string>>;
@@ -15354,6 +15538,13 @@ declare class PresentationOverlayComponent implements OnInit {
     readonly endWithBlackSlide: _angular_core.InputSignal<boolean>;
     /** Whether presenter view is up (tints the toolbar's presenter-view toggle). */
     readonly presenterMode: _angular_core.InputSignal<boolean>;
+    /**
+     * File > Options > Advanced > "Show menu on right mouse click". Off swallows
+     * right-click entirely (no browser menu either), matching React/Vue.
+     */
+    readonly showMenuOnRightClick: _angular_core.InputSignal<boolean>;
+    /** File > Options > Advanced > "Show popup toolbar" while presenting. */
+    readonly showPopupToolbar: _angular_core.InputSignal<boolean>;
     readonly indexChange: _angular_core.OutputEmitterRef<number>;
     readonly closed: _angular_core.OutputEmitterRef<void>;
     /** Live-caption preference; driven by the host's ribbon, not by show chrome. */
@@ -15386,6 +15577,11 @@ declare class PresentationOverlayComponent implements OnInit {
     protected readonly input: PresentationInputController;
     /** Whether PowerPoint's "See All Slides" navigator is up (Ctrl+S). */
     protected readonly allSlidesOpen: _angular_core.WritableSignal<boolean>;
+    /** Slide-show right-click menu position, or null when closed. */
+    protected readonly contextMenuState: _angular_core.WritableSignal<{
+        x: number;
+        y: number;
+    } | null>;
     /** Template aliases for the navigator's state. */
     protected readonly currentIndex: _angular_core.WritableSignal<number>;
     protected readonly endOfShow: _angular_core.WritableSignal<boolean>;
@@ -15501,6 +15697,17 @@ declare class PresentationOverlayComponent implements OnInit {
      */
     onKeyDown(event: KeyboardEvent): void;
     protected onBodyClick(event: MouseEvent): void;
+    /**
+     * Options > Advanced > "Show menu on right mouse click": right-click opens
+     * a minimal Next/Previous/End Show menu (plus pointer tools, See All
+     * Slides, presenter view and the black/white blank screen); off swallows
+     * the click entirely, matching React/Vue.
+     */
+    protected onStageContextMenu(event: MouseEvent): void;
+    /** Route a chosen context-menu action onto this overlay's own handlers. */
+    protected onContextMenuAction(id: PresentationContextMenuActionId): void;
+    /** Set (or clear) the whole-screen blank, mirroring the keyboard B/W shortcuts. */
+    private setBlankScreen;
     /** Click on the end screen: exit the show, like PowerPoint's "click to exit". */
     protected onEndScreenClick(event: MouseEvent): void;
     /** The show toolbar's end button: same exit path as Escape / the close button. */
@@ -15519,7 +15726,7 @@ declare class PresentationOverlayComponent implements OnInit {
     private runChromeAction;
     private emitClosed;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<PresentationOverlayComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<PresentationOverlayComponent, "pptx-presentation-overlay", never, { "slides": { "alias": "slides"; "required": true; "isSignal": true; }; "canvasSize": { "alias": "canvasSize"; "required": true; "isSignal": true; }; "mediaDataUrls": { "alias": "mediaDataUrls"; "required": false; "isSignal": true; }; "startIndex": { "alias": "startIndex"; "required": false; "isSignal": true; }; "activeCustomShow": { "alias": "activeCustomShow"; "required": false; "isSignal": true; }; "showWithAnimation": { "alias": "showWithAnimation"; "required": false; "isSignal": true; }; "useTimings": { "alias": "useTimings"; "required": false; "isSignal": true; }; "subtitlesVisible": { "alias": "subtitlesVisible"; "required": false; "isSignal": true; }; "sessionEnded": { "alias": "sessionEnded"; "required": false; "isSignal": true; }; "endWithBlackSlide": { "alias": "endWithBlackSlide"; "required": false; "isSignal": true; }; "presenterMode": { "alias": "presenterMode"; "required": false; "isSignal": true; }; }, { "indexChange": "indexChange"; "closed": "closed"; "subtitlesChange": "subtitlesChange"; "presenterViewToggle": "presenterViewToggle"; "annotationsExit": "annotationsExit"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<PresentationOverlayComponent, "pptx-presentation-overlay", never, { "slides": { "alias": "slides"; "required": true; "isSignal": true; }; "canvasSize": { "alias": "canvasSize"; "required": true; "isSignal": true; }; "mediaDataUrls": { "alias": "mediaDataUrls"; "required": false; "isSignal": true; }; "startIndex": { "alias": "startIndex"; "required": false; "isSignal": true; }; "activeCustomShow": { "alias": "activeCustomShow"; "required": false; "isSignal": true; }; "showWithAnimation": { "alias": "showWithAnimation"; "required": false; "isSignal": true; }; "useTimings": { "alias": "useTimings"; "required": false; "isSignal": true; }; "subtitlesVisible": { "alias": "subtitlesVisible"; "required": false; "isSignal": true; }; "sessionEnded": { "alias": "sessionEnded"; "required": false; "isSignal": true; }; "endWithBlackSlide": { "alias": "endWithBlackSlide"; "required": false; "isSignal": true; }; "presenterMode": { "alias": "presenterMode"; "required": false; "isSignal": true; }; "showMenuOnRightClick": { "alias": "showMenuOnRightClick"; "required": false; "isSignal": true; }; "showPopupToolbar": { "alias": "showPopupToolbar"; "required": false; "isSignal": true; }; }, { "indexChange": "indexChange"; "closed": "closed"; "subtitlesChange": "subtitlesChange"; "presenterViewToggle": "presenterViewToggle"; "annotationsExit": "annotationsExit"; }, never, never, true, never>;
 }
 
 /**
@@ -16552,8 +16759,16 @@ declare class ChartDataEditorComponent {
     private readonly translate;
     /** Canvas <-> inspector chart-part selection bridge (viewer-scoped, optional). */
     private readonly partSelection;
+    /** File > Options access (viewer-scoped, optional for standalone unit tests). */
+    private readonly viewerOpts;
     private readonly host;
     private readonly injector;
+    /**
+     * File > Options > Advanced > "Properties follow chart data point for
+     * current workbook". Falls back to PowerPoint's own default (`true`) when
+     * the service is unavailable (standalone unit tests).
+     */
+    private followDataPoint;
     /** The chart element being edited. */
     readonly element: _angular_core.InputSignal<ChartPptxElement>;
     /** Whether editing is enabled (read-only mode when false). */
@@ -18377,6 +18592,10 @@ declare class ViewerExtraDialogsComponent {
     protected readonly editor: EditorStateService;
     protected readonly loader: LoadContentService;
     private readonly fonts;
+    private readonly smartArt3D;
+    private readonly collab;
+    /** Real runtime availability for the Options > Add-ins pane; see {@link resolveViewerExtraAddinStatus}. */
+    protected readonly addinStatus: _angular_core.Signal<ViewerAddinStatus>;
     /** Distinct font families used across the editable deck. */
     protected readonly usedFontFamilies: _angular_core.Signal<string[]>;
     /** Families backed by an embedded @font-face rule. */
@@ -18888,7 +19107,7 @@ declare class AccountPageComponent {
     readonly accountAuth: _angular_core.InputSignal<AccountAuthConfig | undefined>;
     private readonly translate;
     protected readonly swatches: readonly string[];
-    protected readonly version = "3.1.0";
+    protected readonly version = "3.1.1";
     protected readonly profile: _angular_core.WritableSignal<ViewerProfile>;
     protected readonly initial: _angular_core.Signal<string>;
     protected readonly usage: _angular_core.WritableSignal<LocalStorageUsageSummary | null>;
@@ -19002,6 +19221,12 @@ declare class PrintDialogComponent {
     readonly defaultSlidesPerPage: _angular_core.InputSignal<number | undefined>;
     /** Default frame-slides from presentation properties. */
     readonly defaultFrameSlides: _angular_core.InputSignal<boolean | undefined>;
+    /**
+     * File > Options > Advanced > Print seed (`ViewerOptionsService.printDefaults`).
+     * `undefined` (Options > "Use the most recently used print settings") leaves
+     * `printWhat`/`colorMode`/`frameSlides` at their hardcoded defaults below.
+     */
+    readonly defaultSettings: _angular_core.InputSignal<Partial<PrintSettings> | undefined>;
     /** Emits the resolved, validated settings when the user clicks Print. */
     readonly print: _angular_core.OutputEmitterRef<PrintSettings>;
     /** Emits when the dialog is dismissed (Cancel / Escape / backdrop). */
@@ -19028,7 +19253,7 @@ declare class PrintDialogComponent {
     onBackdropClick(event: MouseEvent): void;
     onKeydown(event: KeyboardEvent): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<PrintDialogComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<PrintDialogComponent, "pptx-print-dialog", never, { "slides": { "alias": "slides"; "required": true; "isSignal": true; }; "activeSlideIndex": { "alias": "activeSlideIndex"; "required": true; "isSignal": true; }; "defaultSlidesPerPage": { "alias": "defaultSlidesPerPage"; "required": false; "isSignal": true; }; "defaultFrameSlides": { "alias": "defaultFrameSlides"; "required": false; "isSignal": true; }; }, { "print": "print"; "cancel": "cancel"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<PrintDialogComponent, "pptx-print-dialog", never, { "slides": { "alias": "slides"; "required": true; "isSignal": true; }; "activeSlideIndex": { "alias": "activeSlideIndex"; "required": true; "isSignal": true; }; "defaultSlidesPerPage": { "alias": "defaultSlidesPerPage"; "required": false; "isSignal": true; }; "defaultFrameSlides": { "alias": "defaultFrameSlides"; "required": false; "isSignal": true; }; "defaultSettings": { "alias": "defaultSettings"; "required": false; "isSignal": true; }; }, { "print": "print"; "cancel": "cancel"; }, never, never, true, never>;
 }
 
 declare class PrintSettingsPanelComponent {
@@ -19205,6 +19430,12 @@ declare class PresentationToolbarComponent {
     readonly presentationStartTime: _angular_core.InputSignal<number | null>;
     /** Whether presenter view is currently up (tints the toggle). */
     readonly presenterMode: _angular_core.InputSignal<boolean>;
+    /**
+     * File > Options > Advanced > "Show popup toolbar" (default true). When
+     * `false`, `mousemove` never auto-reveals the bar; `toggleVisible`
+     * (PowerPoint's Ctrl+H) still works.
+     */
+    readonly popupToolbarEnabled: _angular_core.InputSignal<boolean>;
     /** Step the show by one slide (`-1` back, `1` forward). */
     readonly move: _angular_core.OutputEmitterRef<1 | -1>;
     /** Leave the show. */
@@ -19287,7 +19518,7 @@ declare class PresentationToolbarComponent {
     private selectTool;
     private togglePalette;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<PresentationToolbarComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<PresentationToolbarComponent, "pptx-presentation-toolbar", never, { "currentSlideIndex": { "alias": "currentSlideIndex"; "required": true; "isSignal": true; }; "totalSlides": { "alias": "totalSlides"; "required": true; "isSignal": true; }; "presentationStartTime": { "alias": "presentationStartTime"; "required": false; "isSignal": true; }; "presenterMode": { "alias": "presenterMode"; "required": false; "isSignal": true; }; }, { "move": "move"; "endPresentation": "endPresentation"; "presenterViewToggle": "presenterViewToggle"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<PresentationToolbarComponent, "pptx-presentation-toolbar", never, { "currentSlideIndex": { "alias": "currentSlideIndex"; "required": true; "isSignal": true; }; "totalSlides": { "alias": "totalSlides"; "required": true; "isSignal": true; }; "presentationStartTime": { "alias": "presentationStartTime"; "required": false; "isSignal": true; }; "presenterMode": { "alias": "presenterMode"; "required": false; "isSignal": true; }; "popupToolbarEnabled": { "alias": "popupToolbarEnabled"; "required": false; "isSignal": true; }; }, { "move": "move"; "endPresentation": "endPresentation"; "presenterViewToggle": "presenterViewToggle"; }, never, never, true, never>;
 }
 
 /**
@@ -20099,7 +20330,7 @@ declare function addCategory(element: ChartPptxElement): ChartPptxElement;
  * const updated = removeCategory(el, 2);
  * ```
  */
-declare function removeCategory(element: ChartPptxElement, catIndex: number): ChartPptxElement;
+declare function removeCategory(element: ChartPptxElement, catIndex: number, followDataPoint?: boolean): ChartPptxElement;
 /**
  * Update a single numeric value in a chart series, returning a new
  * `ChartPptxElement`.
@@ -20732,6 +20963,8 @@ declare class RibbonFileSectionComponent {
     readonly hasMacros: _angular_core.InputSignal<boolean>;
     /** Toolbar buttons the host wants hidden (drops the Export nav entry/page). */
     readonly hiddenActions: _angular_core.InputSignal<ToolbarActionId[]>;
+    /** File > Options > Advanced > "Quickly access this number of Recent Documents". */
+    readonly recentPresentationsCount: _angular_core.InputSignal<number | undefined>;
     /** Optional sign-in hook point for the Account page. Absent/disabled by default. */
     readonly accountAuth: _angular_core.InputSignal<AccountAuthConfig | undefined>;
     readonly close: _angular_core.OutputEmitterRef<void>;
@@ -20741,7 +20974,6 @@ declare class RibbonFileSectionComponent {
     readonly save: _angular_core.OutputEmitterRef<void>;
     readonly savePpsx: _angular_core.OutputEmitterRef<void>;
     readonly savePptm: _angular_core.OutputEmitterRef<void>;
-    readonly packageForSharing: _angular_core.OutputEmitterRef<void>;
     readonly exportPng: _angular_core.OutputEmitterRef<void>;
     readonly exportPdf: _angular_core.OutputEmitterRef<void>;
     readonly exportGif: _angular_core.OutputEmitterRef<void>;
@@ -20801,7 +21033,7 @@ declare class RibbonFileSectionComponent {
      */
     private pageActions;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<RibbonFileSectionComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<RibbonFileSectionComponent, "pptx-ribbon-file-section", never, { "fileName": { "alias": "fileName"; "required": false; "isSignal": true; }; "slideCount": { "alias": "slideCount"; "required": false; "isSignal": true; }; "exporting": { "alias": "exporting"; "required": false; "isSignal": true; }; "hasMacros": { "alias": "hasMacros"; "required": false; "isSignal": true; }; "hiddenActions": { "alias": "hiddenActions"; "required": false; "isSignal": true; }; "accountAuth": { "alias": "accountAuth"; "required": false; "isSignal": true; }; }, { "close": "close"; "createPresentation": "createPresentation"; "openFile": "openFile"; "openRecentFile": "openRecentFile"; "save": "save"; "savePpsx": "savePpsx"; "savePptm": "savePptm"; "packageForSharing": "packageForSharing"; "exportPng": "exportPng"; "exportPdf": "exportPdf"; "exportGif": "exportGif"; "exportVideo": "exportVideo"; "exportJson": "exportJson"; "copySlideAsImage": "copySlideAsImage"; "print": "print"; "info": "info"; "signatures": "signatures"; "replace": "replace"; "openPassword": "openPassword"; "openFontEmbedding": "openFontEmbedding"; "openVersionHistory": "openVersionHistory"; "share": "share"; "options": "options"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<RibbonFileSectionComponent, "pptx-ribbon-file-section", never, { "fileName": { "alias": "fileName"; "required": false; "isSignal": true; }; "slideCount": { "alias": "slideCount"; "required": false; "isSignal": true; }; "exporting": { "alias": "exporting"; "required": false; "isSignal": true; }; "hasMacros": { "alias": "hasMacros"; "required": false; "isSignal": true; }; "hiddenActions": { "alias": "hiddenActions"; "required": false; "isSignal": true; }; "recentPresentationsCount": { "alias": "recentPresentationsCount"; "required": false; "isSignal": true; }; "accountAuth": { "alias": "accountAuth"; "required": false; "isSignal": true; }; }, { "close": "close"; "createPresentation": "createPresentation"; "openFile": "openFile"; "openRecentFile": "openRecentFile"; "save": "save"; "savePpsx": "savePpsx"; "savePptm": "savePptm"; "exportPng": "exportPng"; "exportPdf": "exportPdf"; "exportGif": "exportGif"; "exportVideo": "exportVideo"; "exportJson": "exportJson"; "copySlideAsImage": "copySlideAsImage"; "print": "print"; "info": "info"; "signatures": "signatures"; "replace": "replace"; "openPassword": "openPassword"; "openFontEmbedding": "openFontEmbedding"; "openVersionHistory": "openVersionHistory"; "share": "share"; "options": "options"; }, never, never, true, never>;
 }
 
 declare class RibbonFontControlsComponent {
@@ -22027,6 +22259,12 @@ declare class TitleBarComponent {
      * remainder means those buttons carry real icons rather than a letter glyph.
      */
     protected readonly extraQat: _angular_core.Signal<ViewerQuickAccessOptions>;
+    /**
+     * Whether the below-ribbon strip is the one rendering the configured extra
+     * commands right now, so this component's OWN inline strip stands down
+     * instead of showing the same commands twice.
+     */
+    protected readonly belowRibbonActive: _angular_core.Signal<boolean>;
     /**
      * Route a Quick Access press: keep the dedicated save/undo/redo outputs
      * (existing host wiring, `hiddenActions` gating) and forward everything