pptx-react-viewer 4.17.1 → 4.19.0

package/dist/viewer/index.d.ts

@@ -1,4 +1,4 @@
-import { PptxTheme, PptxTransitionType, PptxSlideTransition, PptxElement, PptxSlide, PptxAnimationPreset, ConnectorArrowType, XmlObject, PptxHandler, PptxData, PptxElementAnimation, ShapeStyle, StrokeDashType, PptxNativeAnimation, PptxThemePreset, PptxThemeColorScheme, PptxThemeFontScheme } from '@christophervr/ooxml-core/pptx';
+import { PptxTheme, PptxThemeColorRef, PptxLayoutPreview, PptxTransitionType, PptxSlideTransition, PptxElement, PptxSlide, PptxAnimationPreset, ConnectorArrowType, XmlObject, PptxHandler, PptxData, PptxElementAnimation, ShapeStyle, StrokeDashType, PptxNativeAnimation, PptxThemePreset, PptxThemeColorScheme, PptxThemeFontScheme } from 'ooxml-core/pptx';
 import * as Y from 'yjs';
 import { Doc } from 'yjs';
 import * as React from 'react';
@@ -1207,6 +1207,25 @@ declare const RIBBON_CONTROL_CATALOG: {
     };
   };
   readonly smartArtDesign: {
+    readonly createGraphic: {
+      readonly label: 'Create Graphic';
+      readonly controls: {
+        readonly addShape: 'Add Shape';
+        readonly addBullet: 'Add Bullet';
+        readonly textPane: 'Text Pane';
+        readonly promote: 'Promote';
+        readonly demote: 'Demote';
+        readonly rightToLeft: 'Right to Left';
+        readonly moveUp: 'Move Up';
+        readonly moveDown: 'Move Down';
+      };
+    };
+    readonly layouts: {
+      readonly label: 'Layouts';
+      readonly controls: {
+        readonly gallery: 'Layouts gallery';
+      };
+    };
     readonly smartArtStyles: {
       readonly label: 'SmartArt Styles';
       readonly controls: {
@@ -1214,6 +1233,13 @@ declare const RIBBON_CONTROL_CATALOG: {
         readonly gallery: 'SmartArt Styles gallery';
       };
     };
+    readonly reset: {
+      readonly label: 'Reset';
+      readonly controls: {
+        readonly resetGraphic: 'Reset Graphic';
+        readonly convert: 'Convert';
+      };
+    };
   };
 };
 //#endregion
@@ -1431,6 +1457,8 @@ interface RibbonCommandView {
   expanded?: boolean;
   hidden?: boolean;
   compact?: boolean;
+  /** Opens a menu or panel: draws PowerPoint's drop-down chevron after the label. */
+  caret?: boolean;
   badge?: number;
   /** Commands with the same column share a vertical stack. */
   column?: number;
@@ -1509,6 +1537,51 @@ declare function forgetSessionDeck(): Promise<void>;
  * presentation back to the state it was opened in.
  */
 declare function restoreSessionDeck(): Promise<SessionDeck | null>;
+//#endregion
+//#region src/render/presentation-session-types.d.ts
+interface PresentationSnapshot {
+  slideIndex: number;
+  buildStep: number;
+  sequence: number;
+  blackout: 'none' | 'black' | 'white';
+  paused: boolean;
+  elapsedMs: number;
+  zoom?: PresentationZoomState;
+  pointer?: PresentationPointerState;
+  inkStrokes?: PresentationInkStroke[];
+  /**
+   * Whether ink markup is drawn (PowerPoint's Ctrl+M). Undefined means visible,
+   * so existing snapshots keep showing their ink. Hiding never discards the
+   * strokes, which stay in `inkStrokes` and can be kept on exit.
+   */
+  inkMarkupVisible?: boolean;
+  caption?: string;
+  subtitlesVisible?: boolean;
+}
+interface PresentationZoomState {
+  scale: number;
+  originX: number;
+  originY: number;
+}
+type PresentationPointerTool = 'none' | 'laser' | 'pen' | 'highlighter' | 'eraser';
+interface PresentationPointerState {
+  tool: PresentationPointerTool;
+  x: number;
+  y: number;
+  color: string;
+}
+interface PresentationInkPoint {
+  x: number;
+  y: number;
+}
+interface PresentationInkStroke {
+  id: string;
+  slideIndex: number;
+  tool: 'pen' | 'highlighter';
+  color: string;
+  width: number;
+  points: PresentationInkPoint[];
+}
 /**
  * Store PPTX content bytes so the audience tab can retrieve them.
  * Called by the presenter before opening the audience window.
@@ -1523,11 +1596,184 @@ declare function loadAudienceContent(sessionId?: string): Promise<Uint8Array | n
  * Remove stored audience content (cleanup).
  */
 declare function clearAudienceContent(sessionId?: string): Promise<void>;
+//#endregion
+//#region src/render/presentation-blackboard.d.ts
+/** Blackout state, as carried by {@link PresentationSnapshot}. */
+type PresentationBlackout = PresentationSnapshot['blackout'];
+//#endregion
+//#region src/render/chrome-controls-state.d.ts
+type ChromeTranslate = (key: string, params?: Record<string, string | number>) => string;
+type ReadOnlyBannerPasswordError = 'wrong-password' | 'unsupported-algorithm';
+interface ReadOnlyBannerViewState {
+  /** `ReadOnlyRecommendation.kind`; mirrored onto the host's `data-kind`. */
+  kind: string | null;
+  /** `ReadOnlyRecommendation.messageKey`, translated by `translate`. */
+  messageKey: string;
+  /** Swap the Edit anyway / Dismiss pair for the inline password form. */
+  passwordPromptOpen?: boolean;
+  passwordError?: ReadOnlyBannerPasswordError | null;
+  /** Disables the form while a submitted password is being checked. */
+  checkingPassword?: boolean;
+  translate?: ChromeTranslate;
+}
+interface PasteOptionsViewState {
+  /** Right edge of the pasted element in viewport pixels. */
+  left: number;
+  /** Bottom edge of the pasted element in viewport pixels. */
+  top: number;
+  translate?: ChromeTranslate;
+}
+interface CompatToastViewItem {
+  readonly id: string;
+  readonly code: string;
+  readonly severity: 'info' | 'warning';
+  readonly messageKey: string;
+  readonly params?: Readonly<Record<string, string>>;
+}
+interface CompatToastsViewState {
+  /** Dismiss-filtered toasts. The element shows the first {@link COMPAT_TOAST_VISIBLE_LIMIT}. */
+  toasts: readonly CompatToastViewItem[];
+  /** Extra toasts a host already trimmed off the list it passes. */
+  overflowCount?: number;
+  /** Width of the open right-docked panel (see `compatToastStackStyle`). */
+  rightInset?: number;
+  /** Live height of the docked notes strip (see `compatToastStackStyle`). */
+  bottomInset?: number;
+  translate?: ChromeTranslate;
+}
+type DialogFooterVariant = 'secondary' | 'primary' | 'warning' | 'danger';
+type DialogFooterIcon = 'trash' | 'pen' | 'restore' | 'print' | 'check';
+interface DialogFooterAction {
+  /** Stable id echoed back in the `dialog-footer-request` intent. */
+  id: string;
+  /** Already-translated visible label and accessible name. */
+  label: string;
+  variant?: DialogFooterVariant;
+  icon?: DialogFooterIcon;
+  disabled?: boolean;
+  /** Work in flight: the button is disabled, `aria-busy` and shows a spinner. */
+  busy?: boolean;
+  /** Tooltip (`title`) for an action whose label needs a longer hint. */
+  title?: string;
+  /** `start` pins a tertiary action (Remove link, Reset all) to the left edge. */
+  align?: 'start' | 'end';
+  /** Optional `data-testid` stamped on the button. */
+  testId?: string;
+}
+interface DialogFooterViewState {
+  actions: readonly DialogFooterAction[];
+}
+type MobileBarId = 'slides' | 'insert' | 'inspector' | 'comments' | 'notes';
+interface MobileBarViewState {
+  /** Every button disables at 0 (see `buildBarActions`). */
+  slideCount: number;
+  /** The button whose sheet is open; reflected as `aria-pressed` and a top pill. */
+  activeSheet?: MobileBarId | null;
+  /** Comment count on the badge of Comments (`99+` above 99). */
+  commentCount?: number;
+  /** Buttons dropped entirely, such as Notes when `hiddenActions` hides it. */
+  hidden?: readonly MobileBarId[];
+  /** Buttons disabled beyond the no-slides rule, such as edit-only ones in view mode. */
+  disabled?: readonly MobileBarId[];
+  translate?: ChromeTranslate;
+}
+type MobileToolbarId = 'menu' | 'undo' | 'redo' | 'ai' | 'save' | 'present' | 'share';
+interface MobileToolbarViewState {
+  /** Menu, Undo, Redo, AI and Share only show while editing. */
+  editable: boolean;
+  canUndo: boolean;
+  canRedo: boolean;
+  /** Host opted into the AI assistant; the element draws its toggle. */
+  aiVisible?: boolean;
+  aiActive?: boolean;
+  /** Reflected as `aria-expanded` on Menu when given. */
+  menuOpen?: boolean;
+  /** Buttons dropped entirely (`hiddenActions`, or Share when the host has none). */
+  hidden?: readonly MobileToolbarId[];
+  /** Buttons disabled, such as Present while there is nothing to present. */
+  disabled?: readonly MobileToolbarId[];
+  translate?: ChromeTranslate;
+}
+interface PresentToolbarViewState {
+  /** Zero-based slide on screen. */
+  current: number;
+  total: number;
+  /** The armed annotation tool; `none` leaves every tool unpressed. */
+  tool: PresentationPointerTool;
+  penColor: string;
+  highlighterColor: string;
+  hasAnnotations: boolean;
+  /** With the pen, marks the Blackboard toggle active (`isBlackboardActive`). */
+  blackout: PresentationBlackout;
+  /** Show the presenter-view toggle (default false). */
+  presenterViewVisible?: boolean;
+  presenterViewActive?: boolean;
+  /** Epoch ms the show started. The element ticks the readout; null shows 00:00. */
+  startTime: number | null;
+  translate?: ChromeTranslate;
+}
+interface PresenterConsoleViewState {
+  /** Ids of toggles that read as on (and the resume / close-window variants). */
+  active: readonly string[];
+  /** Ids of controls that are disabled. */
+  disabled: readonly string[];
+  translate?: ChromeTranslate;
+}
 /** In-memory clipboard payload stored when an element is copied or cut. */
 interface ElementClipboardPayload {
   element: PptxElement;
   isTemplate: boolean;
 }
+/** One placeholder outline, already positioned in unscaled slide space. */
+interface LayoutPreviewFrame {
+  /** Stable key for list rendering. */
+  key: string;
+  type: string;
+  left: number;
+  top: number;
+  width: number;
+  height: number;
+}
+/** Everything a binding needs to render one thumbnail. */
+interface LayoutPreviewGeometry {
+  /** Outer box, in CSS pixels. */
+  boxWidth: number;
+  boxHeight: number;
+  /** Inner surface size, in unscaled slide pixels. */
+  surfaceWidth: number;
+  surfaceHeight: number;
+  /** Factor to apply as `transform: scale(...)` on the inner surface. */
+  scale: number;
+  backgroundColor: string;
+  /**
+   * Border width for placeholder outlines, pre-divided by {@link scale}.
+   *
+   * The outlines live inside the scaled surface, so a plain 1.5px border
+   * would be multiplied down to a hairline that vanishes at thumbnail size.
+   * Dividing here keeps the drawn width constant on screen whatever the
+   * slide dimensions are.
+   */
+  frameBorderWidth: number;
+  frames: LayoutPreviewFrame[];
+}
+//#endregion
+//#region src/render/command-search.d.ts
+/**
+ * Command-search data for the PowerPoint-style "Tell me what you want to do"
+ * search bar. Provides searchable command entries grouped by category, each
+ * mapping a label translation key to a command identifier that bindings can
+ * dispatch.
+ */
+interface CommandSearchEntry {
+  /** Translation key for the display label. */
+  labelKey: string;
+  /** Command identifier dispatched to the host binding. */
+  command: string;
+  /** Optional icon hint (binding resolves to framework icon component). */
+  icon?: string;
+  /** Category grouping key; hosts with their own short list may omit it. */
+  category?: 'format' | 'insert' | 'view' | 'slideShow' | 'design' | 'arrange';
+}
 interface SubtitleSettings {
   spokenLanguage: string;
 }
@@ -1557,7 +1803,7 @@ interface AccountAuthConfig {
 //#endregion
 //#region src/render/ribbon-galleries/gallery-types.d.ts
 /** Every gallery the ribbon offers. */
-type RibbonGalleryId = 'shapeStyles' | 'shapeEffects' | 'wordArtStyles' | 'pictureStyles' | 'pictureCorrections' | 'pictureColor' | 'pictureArtisticEffects' | 'bullets' | 'numbering' | 'tableStyles' | 'chartStyles' | 'chartColors' | 'chartQuickLayout' | 'smartArtStyles' | 'smartArtColors' | 'themeColors' | 'themeFonts';
+type RibbonGalleryId = 'shapeStyles' | 'shapeEffects' | 'wordArtStyles' | 'pictureStyles' | 'pictureCorrections' | 'pictureColor' | 'pictureArtisticEffects' | 'bullets' | 'numbering' | 'tableStyles' | 'chartStyles' | 'chartColors' | 'chartQuickLayout' | 'smartArtStyles' | 'smartArtColors' | 'smartArtLayouts' | 'smartArtAddShape' | 'smartArtAddBullet' | 'smartArtTextPane' | 'smartArtPromote' | 'smartArtDemote' | 'smartArtRightToLeft' | 'smartArtMoveUp' | 'smartArtMoveDown' | 'smartArtResetGraphic' | 'smartArtConvert' | 'themeColors' | 'themeFonts';
 /** One tile. */
 interface RibbonGalleryItem {
   /** Stable within its gallery; what `applyRibbonGalleryItem` takes. */
@@ -1604,6 +1850,22 @@ interface RibbonGalleryDescriptor {
   sections: RibbonGallerySection[];
   /** True when the selection cannot take this gallery (trigger disabled). */
   disabled: boolean;
+  /**
+   * Set when the entry is a one-button command (PowerPoint's Add Shape, Reset
+   * Graphic, ...) rather than a gallery: the element draws a plain command, a
+   * click picks its only item and no panel opens.
+   */
+  command?: RibbonGalleryCommandView;
+}
+/** How a command-style entry draws (see {@link RibbonGalleryDescriptor.command}). */
+interface RibbonGalleryCommandView {
+  /** SVG path data on a 20px grid. */
+  iconPath: string;
+  /** Icon above the label (PowerPoint's large button) instead of beside it. */
+  large?: boolean;
+  /** i18n key and English fallback of the tooltip, e.g. why the command is unavailable. */
+  hintKey?: string;
+  hint?: string;
 }
 //#endregion
 //#region src/render/viewport-fit.d.ts
@@ -1668,15 +1930,73 @@ interface RibbonInsertState {
   headerFooterAvailable?: boolean;
   translate?: (key: string) => string;
 }
+/** One row of a menu or select; labels are translated by the view unless `label` is set. */
+interface RibbonHomeItem {
+  readonly value: string;
+  /** Ready-made text (a font family, a layout name); wins over `labelKey`. */
+  readonly label?: string;
+  readonly labelKey?: string;
+  readonly fallback?: string;
+  readonly description?: string;
+  readonly descriptionKey?: string;
+  /** Heading of the group this row opens; consecutive rows share one heading. */
+  readonly group?: string;
+  readonly groupKey?: string;
+  readonly checked?: boolean;
+  readonly disabled?: boolean;
+  /** Preview typeface of a font row. */
+  readonly fontFamily?: string;
+  /** Shared artwork key shown before the label (a shape glyph or ribbon icon). */
+  readonly icon?: string;
+  /** Preserved test or automation hooks (`data-pptx-merge-op`, ...). */
+  readonly attrs?: Readonly<Record<string, string>>;
+  /** Draws a divider above the row. */
+  readonly separator?: boolean;
+}
 interface RibbonHomeControlState {
   disabled?: boolean;
   /** Omit for ordinary commands; a boolean reflects `aria-pressed`. */
   pressed?: boolean;
+  /** Reserved for hosts that mirror their own popover; shared popovers set it themselves. */
+  expanded?: boolean;
   hidden?: boolean;
+  /** Select, number, colour bar and checked menu row. */
+  value?: string | number;
+  /** Menu or select rows that replace the spec's static ones. */
+  items?: readonly RibbonHomeItem[];
+  /** Colour popover content; the trigger shows `value` in its bar. */
+  colour?: RibbonHomeColourModel;
+  /** Layout gallery content. */
+  layouts?: RibbonHomeLayoutModel;
+  /** Embedded gallery content. */
+  gallery?: {
+    descriptor: RibbonGalleryDescriptor | undefined;
+    disabled?: boolean;
+  };
 }
+interface RibbonHomeColourModel {
+  /** The deck's theme colour map; the popover derives the theme palette from it. */
+  themeColors?: Readonly<Record<string, string>>;
+  /** Theme reference of the current colour (highlights its swatch). */
+  selectedRef?: PptxThemeColorRef;
+  /** Recently used colours, newest first. */
+  recent?: readonly string[];
+}
+interface RibbonHomeLayoutModel {
+  layouts: readonly {
+    path: string;
+    name: string;
+  }[];
+  /** Marks the active tile; omitted by New Slide. */
+  current?: string;
+  /** Artwork data by layout path; tiles render name-only until it arrives. */
+  previews?: Readonly<Record<string, PptxLayoutPreview>> | ReadonlyMap<string, PptxLayoutPreview>;
+}
+/** State key of a control: its id, or `id#part` when several buttons share one id. */
+type RibbonHomeKey = RibbonControlId | `${RibbonControlId}#${string}`;
 interface RibbonHomeViewState {
   /** Missing entries are enabled, unpressed and visible. */
-  controls: Readonly<Partial<Record<RibbonControlId, RibbonHomeControlState>>>;
+  controls: Readonly<Partial<Record<RibbonHomeKey, RibbonHomeControlState>>>;
   translate?: (key: string) => string;
 }
 /** Controlled View tab state. Native viewers own the values and every side effect. */
@@ -1709,6 +2029,113 @@ interface RibbonTransitionsViewState {
   translate?: RibbonTransitionsTranslate;
 }
 //#endregion
+//#region src/render/status-bar-state.d.ts
+/**
+ * Shared model for the bottom status bar (`pptx-ui-status-bar`).
+ *
+ * The slide counter, save indicator, notes toggle, view-mode buttons and zoom
+ * cluster were hand-built five times. The view owns the markup, pressed state
+ * and gating; hosts own every effect (notes panel, view switching, zoom).
+ */
+type StatusBarTranslate = (key: string, params?: Record<string, string | number>) => string;
+type StatusBarSaveKind = 'idle' | 'saving' | 'error';
+type StatusBarViewMode = 'normal' | 'sorter' | 'slideShow';
+interface StatusBarViewState {
+  slideCount: number;
+  /** Zero-based active slide; clamped into range for display. */
+  activeSlideIndex: number;
+  /** Already-translated save indicator, see {@link resolveStatusBarSave}. */
+  saveText: string;
+  saveKind?: StatusBarSaveKind;
+  /** Omit to hide the whole zoom cluster. */
+  zoomPercent?: number;
+  showNotes?: boolean;
+  notesExpanded?: boolean;
+  /** Default true. False drops the Normal / Sorter / Slide Show cluster. */
+  showViewModes?: boolean;
+  /** Default true. */
+  showSorter?: boolean;
+  /** Default true. */
+  showSlideShow?: boolean;
+  /** The pressed view button; omit when none is active. */
+  viewMode?: StatusBarViewMode;
+  translate?: StatusBarTranslate;
+}
+//#endregion
+//#region src/render/notes-toolbar-state.d.ts
+/**
+ * Shared model for the speaker-notes formatting toolbar (`pptx-ui-notes-toolbar`).
+ *
+ * The toolbar owns the buttons, their order, icons, labels, enabled state and
+ * the hyperlink popover. Hosts own the contenteditable editor, selection-based
+ * edits, history, printing and persistence, and route typed intents to them.
+ */
+type NotesToolbarTranslate = (key: string, params?: Record<string, string | number>) => string;
+interface NotesToolbarViewState {
+  /** True while the rich (contenteditable) surface is active. Drives the mode button label. */
+  rich: boolean;
+  /** Enables the formatting buttons. False in the plain editor, where they cannot act. */
+  canFormat: boolean;
+  /** Shows the Print button. */
+  showPrint: boolean;
+  /** Disables every button, for example while no slide is selected. */
+  disabled?: boolean;
+  /** Host translator; keys are the canonical `pptx.notes.*` set. Omitted: keys are shown. */
+  translate?: NotesToolbarTranslate;
+}
+//#endregion
+//#region src/render/title-bar-state.d.ts
+type TitleBarTranslate = (key: string, params?: Record<string, string | number>) => string;
+type TitleBarPlacement = 'titleBar' | 'belowRibbon';
+type TitleBarTone = 'idle' | 'saving' | 'error';
+interface TitleBarAutosaveView {
+  enabled: boolean;
+  /** Default true. False renders the switch inert (host policy `autosave: false`). */
+  toggleAvailable?: boolean;
+  /** Translation key from `resolveTitleBarStatusKey`. */
+  statusKey: string;
+  /** Colour of the status text; only meaningful while `enabled`. */
+  tone?: TitleBarTone;
+}
+interface TitleBarHistoryState {
+  canUndo: boolean;
+  canRedo: boolean;
+  /** Description of the pending action, e.g. "Delete shape". */
+  undoLabel?: string | null;
+  redoLabel?: string | null;
+  /** Default true. Maps to `hiddenActions: ['undo']`. */
+  showUndo?: boolean;
+  /** Default true. Maps to `hiddenActions: ['redo']`. */
+  showRedo?: boolean;
+}
+interface TitleBarQuickAccessView {
+  visible: boolean;
+  position: QuickAccessPosition;
+  showCommandLabels: boolean;
+  /** Ordered catalog ids (File > Options > Quick Access Toolbar). */
+  commandIds: readonly string[];
+}
+interface TitleBarViewState {
+  /** Edit mode with an editable deck. Gates AutoSave, the strip, status and search. */
+  editing: boolean;
+  /** Whether the command search shows; hosts pass `editing`. */
+  searchVisible: boolean;
+  /** Display name; the translated default shows when empty. */
+  fileName?: string;
+  autosave: TitleBarAutosaveView;
+  history: TitleBarHistoryState;
+  /** Default true. */
+  showSave?: boolean;
+  quickAccess: TitleBarQuickAccessView;
+  /** Search catalogue; defaults to the shared `COMMAND_SEARCH_ENTRIES`. */
+  commands?: readonly CommandSearchEntry[];
+  /** Default true. False drops the "Find in Slides" fallback row. */
+  contentSearch?: boolean;
+  /** ScreenTip rule (Options > General); returning undefined suppresses the title. */
+  screenTip?: (label: string) => string | undefined;
+  translate?: TitleBarTranslate;
+}
+//#endregion
 //#region src/web-components/theme-editor.d.ts
 interface PptxUiThemeEditorElement extends HTMLElement {
   theme: PptxTheme | undefined;
@@ -1720,6 +2147,74 @@ declare global {
     'pptx-ui-theme-editor': PptxUiThemeEditorElement;
   }
 }
+interface PptxUiCompatToastsElement extends HTMLElement {
+  state: CompatToastsViewState;
+}
+declare global {
+  interface HTMLElementTagNameMap {
+    'pptx-ui-compat-toasts': PptxUiCompatToastsElement;
+  }
+}
+interface PptxUiDialogFooterElement extends HTMLElement {
+  state: DialogFooterViewState;
+  /** Move keyboard focus to an action, e.g. the primary one when a dialog opens. */
+  focusAction(id: string): void;
+}
+declare global {
+  interface HTMLElementTagNameMap {
+    'pptx-ui-dialog-footer': PptxUiDialogFooterElement;
+  }
+}
+interface PptxUiMobileBarElement extends HTMLElement {
+  state: MobileBarViewState;
+}
+declare global {
+  interface HTMLElementTagNameMap {
+    'pptx-ui-mobile-bar': PptxUiMobileBarElement;
+  }
+}
+interface PptxUiMobileToolbarElement extends HTMLElement {
+  state: MobileToolbarViewState;
+}
+declare global {
+  interface HTMLElementTagNameMap {
+    'pptx-ui-mobile-toolbar': PptxUiMobileToolbarElement;
+  }
+}
+interface PptxUiPasteOptionsElement extends HTMLElement {
+  state: PasteOptionsViewState;
+}
+declare global {
+  interface HTMLElementTagNameMap {
+    'pptx-ui-paste-options': PptxUiPasteOptionsElement;
+  }
+}
+interface PptxUiPresentToolbarElement extends HTMLElement {
+  state: PresentToolbarViewState;
+  /** Close an open colour palette, e.g. when the host auto-hides the bar. */
+  closePalettes(): void;
+}
+declare global {
+  interface HTMLElementTagNameMap {
+    'pptx-ui-present-toolbar': PptxUiPresentToolbarElement;
+  }
+}
+interface PptxUiPresenterConsoleElement extends HTMLElement {
+  state: PresenterConsoleViewState;
+}
+declare global {
+  interface HTMLElementTagNameMap {
+    'pptx-ui-presenter-console': PptxUiPresenterConsoleElement;
+  }
+}
+interface PptxUiReadOnlyBannerElement extends HTMLElement {
+  state: ReadOnlyBannerViewState;
+}
+declare global {
+  interface HTMLElementTagNameMap {
+    'pptx-ui-read-only-banner': PptxUiReadOnlyBannerElement;
+  }
+}
 interface PptxUiRibbonAnimationsElement extends HTMLElement {
   state: RibbonAnimationsViewState;
 }
@@ -1736,8 +2231,19 @@ declare global {
     'pptx-ui-ribbon-draw': PptxUiRibbonDrawElement;
   }
 }
+//#endregion
+//#region src/web-components/ribbon-home-layout.d.ts
+/**
+ * Draws a layout's real artwork inside a tile's scaled surface. The artwork is
+ * element rendering that each binding owns; return a disposer to release it.
+ */
+type HomeLayoutArtwork = (preview: PptxLayoutPreview, geometry: LayoutPreviewGeometry, container: HTMLElement) => (() => void) | void;
 interface PptxUiRibbonHomeElement extends HTMLElement {
   state: RibbonHomeViewState;
+  /** Draws a layout's real artwork inside a gallery tile; the host owns element rendering. */
+  layoutArtwork: HomeLayoutArtwork | undefined;
+  /** Wrapper (or button) of a control id. */
+  anchor(id: string): HTMLElement | undefined;
 }
 declare global {
   interface HTMLElementTagNameMap {
@@ -1745,6 +2251,15 @@ declare global {
     'pptx-ui-ribbon-home-font': PptxUiRibbonHomeElement;
     'pptx-ui-ribbon-home-paragraph': PptxUiRibbonHomeElement;
     'pptx-ui-ribbon-home-editing': PptxUiRibbonHomeElement;
+    'pptx-ui-ribbon-home-slides': PptxUiRibbonHomeElement;
+    'pptx-ui-ribbon-home-drawing': PptxUiRibbonHomeElement;
+    'pptx-ui-ribbon-home-arrange-align': PptxUiRibbonHomeElement;
+    'pptx-ui-ribbon-home-arrange-flip': PptxUiRibbonHomeElement;
+    'pptx-ui-ribbon-home-arrange-order': PptxUiRibbonHomeElement;
+    'pptx-ui-ribbon-home-arrange-edit': PptxUiRibbonHomeElement;
+    'pptx-ui-ribbon-home-font-picker': PptxUiRibbonHomeElement;
+    'pptx-ui-ribbon-home-arrange-painter': PptxUiRibbonHomeElement;
+    'pptx-ui-ribbon-home-arrange-shape': PptxUiRibbonHomeElement;
   }
 }
 interface PptxUiRibbonTransitionsElement extends HTMLElement {
@@ -1812,6 +2327,74 @@ declare global {
     'pptx-ui-subtitle-settings': PptxUiSubtitleSettingsElement;
   }
 }
+interface PptxUiStatusBarElement extends HTMLElement {
+  state: StatusBarViewState;
+}
+declare global {
+  interface HTMLElementTagNameMap {
+    'pptx-ui-status-bar': PptxUiStatusBarElement;
+  }
+}
+interface PptxUiNotesToolbarElement extends HTMLElement {
+  state: NotesToolbarViewState;
+}
+declare global {
+  interface HTMLElementTagNameMap {
+    'pptx-ui-notes-toolbar': PptxUiNotesToolbarElement;
+  }
+}
+interface PptxUiTitleBarElement extends HTMLElement {
+  state: TitleBarViewState | undefined;
+  placement: TitleBarPlacement;
+}
+declare global {
+  interface HTMLElementTagNameMap {
+    'pptx-ui-title-bar': PptxUiTitleBarElement;
+  }
+}
+/** One row of a context menu. Hosts decide `id`, wording, gating and what activation does. */
+interface ContextMenuViewItem {
+  /** Stable command id, echoed by `menu-request`. */
+  id: string;
+  /** Already-translated visible label. */
+  label: string;
+  /** Draw a rule before this row. */
+  separatorBefore?: boolean;
+  /** Group heading shown before this row; the row and the ones after it join that group. */
+  heading?: string;
+  /** Destructive command (Delete): tinted. */
+  danger?: boolean;
+  /** Offered but unavailable: announced and drawn dim, skipped by arrow keys. */
+  disabled?: boolean;
+  /** A toggle (Grid and Guides, Ruler) in this state; omitted for one-shot commands. */
+  checked?: boolean;
+}
+/** Everything the controlled element needs to draw one menu. */
+interface ContextMenuViewState {
+  /** Pointer position, in viewport pixels. The element clamps it into the window. */
+  x: number;
+  y: number;
+  /** Accessible name of the menu. */
+  label: string;
+  items: readonly ContextMenuViewItem[];
+  /**
+   * Test-hook attributes copied onto the host element (`data-pptx-context-menu`,
+   * `data-pptx-canvas-context-menu`, ...). Only `data-pptx-*` names are accepted.
+   */
+  markers?: readonly string[];
+  /** Stacking order; defaults to {@link CONTEXT_MENU_EDITOR_LAYER}. */
+  zIndex?: number;
+  /** Move focus onto the first command on open. Default true. */
+  autoFocus?: boolean;
+}
+interface PptxUiContextMenuElement extends HTMLElement {
+  state: ContextMenuViewState;
+}
+declare global {
+  interface HTMLElementTagNameMap {
+    'pptx-ui-context-menu': PptxUiContextMenuElement;
+  }
+}
 //#endregion
 //#region src/web-components/select-value.d.ts
 /** Public DOM shape used by all bindings; the element is not a native select. */