pptx-react-viewer 4.26.0 → 4.27.0

package/dist/viewer/index.d.ts

@@ -1,2413 +1,14 @@
-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 ooxml_ui_pptx from 'ooxml-ui/pptx';
+import { CollaborationRole, CollaborationConfig, ViewportFitOptions, ViewerFontSource, ViewerTheme, ThemeCatalogEntry, AccountAuthConfig, ToolbarActionId, ViewerCustomization, PowerPointViewerAPI, ViewerCustomizationApi, BorrowedCollaborationAwareness } from 'ooxml-ui/pptx';
+export { CollaborationConfig, CollaborationRole, ElementClipboardPayload, ExternalCollaborationAwareness, ExternalCollaborationSession, ExternalCollaborationSnapshot, SessionDeck, ShapeAdjustmentDragState, ShapeAdjustmentHandleDescriptor, ViewerMode, clearAudienceContent, forgetSessionDeck, getSessionTabId, loadAudienceContent, loadSessionDeck, rememberSessionDeck, restoreSessionDeck, storeAudienceContent } from 'ooxml-ui/pptx';
 import * as React from 'react';
 import React__default, { RefObject } from 'react';
-import { LanguageModel, ChatTransport, UIMessage, ToolSet } from 'ai';
-
-//#region src/theme/types.d.ts
-/**
- * Theme configuration types for the PowerPoint viewer.
- *
- * All color values accept any valid CSS color string:
- * hex (`#6366f1`), rgb (`rgb(99 102 241)`), hsl (`hsl(239 84% 67%)`),
- * oklch (`oklch(0.585 0.233 277)`), named colors, etc.
- *
- * Framework-agnostic — shared by the React, Vue, and Angular bindings.
- */
-/**
- * Semantic color tokens for the viewer UI.
- *
- * These map to CSS custom properties (`--pptx-<token>`) and drive all
- * UI component colors. The naming follows the shadcn/ui convention so
- * that Tailwind + shadcn users get a familiar experience.
- */
-interface ViewerThemeColors {
-  /** Page / root background */
-  background: string;
-  /** Default text color */
-  foreground: string;
-  /** Card / panel surface */
-  card: string;
-  /** Text on card surfaces */
-  cardForeground: string;
-  /** Popover / dropdown surface */
-  popover: string;
-  /** Text inside popovers */
-  popoverForeground: string;
-  /** Primary action color (buttons, active indicators) */
-  primary: string;
-  /** Text on primary-colored backgrounds */
-  primaryForeground: string;
-  /** Secondary / subdued action color */
-  secondary: string;
-  /** Text on secondary backgrounds */
-  secondaryForeground: string;
-  /** Muted / disabled surface */
-  muted: string;
-  /** Text on muted surfaces (also used for secondary text) */
-  mutedForeground: string;
-  /** Accent / hover-highlight surface */
-  accent: string;
-  /** Text on accent surfaces */
-  accentForeground: string;
-  /** Destructive / danger action color */
-  destructive: string;
-  /** Text on destructive backgrounds */
-  destructiveForeground: string;
-  /** Default border color */
-  border: string;
-  /** Input field border color */
-  input: string;
-  /** Focus ring color */
-  ring: string;
-}
-/**
- * Full viewer theme configuration.
- *
- * Every property is optional — unset values fall back to the built-in
- * dark theme defaults.
- */
-interface ViewerTheme {
-  /** Semantic UI colors. Each key maps to a `--pptx-<key>` CSS custom property. */
-  colors?: Partial<ViewerThemeColors>;
-  /** Base border-radius value (e.g. `"0.5rem"`, `"8px"`). */
-  radius?: string;
-  /**
-   * Escape hatch: arbitrary CSS custom properties to set on the viewer
-   * root element. Keys should include the `--` prefix.
-   *
-   * @example
-   * ```ts
-   * { "--my-custom-shadow": "0 4px 12px rgba(0,0,0,0.5)" }
-   * ```
-   */
-  cssVars?: Record<string, string>;
-}
-//#endregion
-//#region src/theme/theme-catalog.d.ts
-/** One selectable entry in the viewer chrome's built-in theme picker (File > Options > Appearance). */
-interface ThemeCatalogEntry {
-  /** Stable identifier persisted to storage and passed to `onThemeChange`. */
-  key: string;
-  /** `pptx.*` translation key for the entry's display label. */
-  labelKey: string;
-  /** The theme to apply, or `undefined` to reset to the built-in default. */
-  theme: ViewerTheme | undefined;
-}
-
-//#region src/render/collaboration-presence.d.ts
-/** Connection lifecycle states for the Yjs WebSocket provider. */
-type ConnectionStatus$1 = 'disconnected' | 'connecting' | 'connected' | 'error';
-//#endregion
-//#region src/render/collaboration-presence-publisher.d.ts
-/**
- * Structural interface for the lazily-imported Yjs awareness surface. Every
- * binding's live `y-protocols/awareness` `Awareness` instance satisfies this.
- */
-interface AwarenessLike {
-  clientID?: number;
-  setLocalStateField: (field: string, value: unknown) => void;
-  getStates: () => Map<number, Record<string, unknown>>;
-  on: (event: string, cb: () => void) => void;
-  off?: (event: string, cb: () => void) => void;
-}
-//#endregion
-//#region src/render/collaboration-external-session.d.ts
-/** Connection state reported by the host, independent of the viewer lifetime. */
-interface ExternalCollaborationSnapshot {
-  status: ConnectionStatus$1;
-  /**
-   * The host has loaded the authoritative document and permits local edits.
-   * Keep true while offline to allow ordinary Yjs offline edits, or set false
-   * to suspend writes until a fresh sync. The viewer never infers this from
-   * `status` and never opens it after a timeout.
-   */
-  synced: boolean;
-}
-/** The public y-protocols Awareness surface needed by a borrowed session. */
-interface ExternalCollaborationAwareness extends AwarenessLike {
-  clientID: number;
-  getLocalState: () => Record<string, unknown> | null;
-  setLocalState: (state: Record<string, unknown> | null) => void;
-  off: (event: string, callback: () => void) => void;
-}
-/**
- * Host-owned Yjs resources. The host creates, connects and destroys them.
- * Keep this object and its resources stable for a session; report connection
- * changes through subscribe instead of replacing the collaboration config.
- */
-interface ExternalCollaborationSession {
-  readonly doc: Doc;
-  /** Awareness must belong to doc. One viewer publishes slide presence at a time. */
-  readonly awareness: ExternalCollaborationAwareness;
-  getSnapshot: () => ExternalCollaborationSnapshot;
-  /** Subscribe to status or synced changes; return an unsubscribe function. */
-  subscribe: (listener: () => void) => () => void;
-}
-/** Listener/publisher view, deliberately excluding host lifecycle methods. */
-interface BorrowedCollaborationAwareness extends AwarenessLike {
-  clientID: number;
-  off: (event: string, callback: () => void) => void;
-}
-//#endregion
-//#region src/render/element-update-batch.d.ts
-/** A shallow property patch for a top-level element on an ordinary slide. */
-interface ElementUpdate {
-  slideId: string;
-  elementId: string;
-  patch: Partial<PptxElement>;
-}
-interface ElementUpdateOptions {
-  /** Optional description for the undo entry. */
-  label?: string;
-}
-/** Viewer interaction mode: read-only, edit, presentation, or master-view. */
-type ViewerMode = 'preview' | 'edit' | 'present' | 'master';
-/**
- * Framework-agnostic imperative API contract for the PowerPoint viewer.
- *
- * Each binding (React `forwardRef` handle, Vue `defineExpose`, Angular public
- * methods) implements this interface so consumers get a consistent progressive
- * API regardless of framework.
- */
-interface PowerPointViewerAPI {
-  /** Serialise the current presentation to `.pptx` bytes. */
-  getContent: () => Promise<Uint8Array>;
-  /** Navigate to a specific slide by zero-based index. */
-  goTo: (slideIndex: number) => void;
-  /** Navigate to the previous slide. */
-  goPrev: () => void;
-  /** Navigate to the next slide. */
-  goNext: () => void;
-  /** Undo the last editing action. No-op when nothing to undo. */
-  undo: () => void;
-  /** Redo the last undone action. No-op when nothing to redo. */
-  redo: () => void;
-  /** Whether an undo action is available. */
-  canUndo: () => boolean;
-  /** Whether a redo action is available. */
-  canRedo: () => boolean;
-  /** Get the current zoom level (1 = 100%). */
-  getZoom: () => number;
-  /** Set the zoom level (clamped to min/max bounds). */
-  setZoom: (level: number) => void;
-  /** Zoom in by one step. */
-  zoomIn: () => void;
-  /** Zoom out by one step. */
-  zoomOut: () => void;
-  /** Reset zoom to 100%. */
-  zoomReset: () => void;
-  /** Get the current viewer mode. */
-  getMode: () => ViewerMode;
-  /** Switch the viewer mode (e.g. 'edit', 'preview', 'present'). */
-  setMode: (mode: ViewerMode) => void;
-  /** Get the zero-based active slide index. */
-  getActiveSlideIndex: () => number;
-  /** Set the active slide by zero-based index (alias of goTo). */
-  setActiveSlideIndex: (index: number) => void;
-  /** Get the total number of slides. */
-  getSlideCount: () => number;
-  /** Whether the document has unsaved changes. */
-  isDirty: () => boolean;
-  /**
-   * Get the full slide array. Returns the actual `PptxSlide[]` from the
-   * internal model with full type information (elements, notes, transitions,
-   * animations, etc.). The returned reference is a snapshot; mutations are
-   * not reflected back unless done via the manipulation methods.
-   */
-  getSlides: () => readonly PptxSlide[];
-  /** Get a single slide by zero-based index, or undefined if out of range. */
-  getSlide: (index: number) => PptxSlide | undefined;
-  /** Get the currently active slide. */
-  getActiveSlide: () => PptxSlide | undefined;
-  /** Add a blank slide after the given index (or at end if omitted). */
-  addSlide: (afterIndex?: number) => void;
-  /** Delete slides at the given zero-based indexes. At least one slide is kept. */
-  deleteSlides: (indexes: number[]) => void;
-  /** Duplicate slides at the given zero-based indexes. */
-  duplicateSlides: (indexes: number[]) => void;
-  /** Move a slide from one position to another. */
-  moveSlide: (fromIndex: number, toIndex: number) => void;
-  /** Toggle the hidden flag on slides at the given indexes. */
-  toggleHideSlides: (indexes: number[]) => void;
-  /**
-   * Get the elements on a slide. Defaults to the active slide when
-   * `slideIndex` is omitted. Returns the full `PptxElement[]` with
-   * all type-specific properties intact.
-   */
-  getElements: (slideIndex?: number) => readonly PptxElement[];
-  /** Get a single element by ID from the active slide (or a specified slide). */
-  getElementById: (elementId: string, slideIndex?: number) => PptxElement | undefined;
-  /**
-   * Append and select a deep copy on the active ordinary editable slide.
-   * Assigns fresh element IDs without offsetting the supplied geometry.
-   * Returns the new root ID, or undefined when insertion is unavailable.
-   * Uses normal Undo/Redo grouping. Models must be self-contained or refer to
-   * assets in this document; this does not import foreign PPTX relationships.
-   */
-  addElement: (element: PptxElement) => string | undefined;
-  /**
-   * Update one or more properties of an element by ID on the active slide.
-   * Accepts a `Partial<PptxElement>` patch (e.g. `{ x: 100, width: 300 }`).
-   */
-  updateElement: (elementId: string, updates: Partial<PptxElement>) => void;
-  /** Atomically patch ordinary slide elements as one independent undo step. Rejects invalid batches. */
-  updateElements: (updates: readonly ElementUpdate[], options?: ElementUpdateOptions) => Promise<void>;
-  /** Delete elements by their IDs from the active slide. */
-  deleteElements: (elementIds: string[]) => void;
-  /**
-   * Duplicate an element on the active slide.
-   * Returns the new element's ID, or undefined if the source was not found.
-   */
-  duplicateElement: (elementId: string) => string | undefined;
-  /** Get the IDs of currently selected elements. */
-  getSelectedElementIds: () => string[];
-  /** Programmatically select elements by their IDs. */
-  selectElements: (ids: string[]) => void;
-  /** Clear the current selection. */
-  clearSelection: () => void;
-}
-/** Collaboration role within a session. */
-type CollaborationRole = 'owner' | 'collaborator' | 'viewer';
-/**
- * Collaboration transport.
- *
- * - `'websocket'` (default): y-websocket against `serverUrl`.
- * - `'webrtc'`: y-webrtc peer-to-peer; needs no document server. Peers meet
- *   through the `signaling` servers (WebRTC signaling only, no document data)
- *   and same-browser tabs additionally sync via BroadcastChannel even without
- *   any signaling server, which makes this mode usable from static hosting.
- */
-type CollaborationTransport = 'websocket' | 'webrtc';
-/** How the local user entered a collaboration session. */
-type CollaborationSessionIntent = 'create' | 'join';
-/**
- * Real-time collaboration configuration.
- *
- * The same shape is accepted by every framework binding.
- */
-interface CollaborationConfig {
-  /** Unique identifier for the collaboration room (alphanumeric, hyphens, underscores). */
-  roomId: string;
-  /**
-   * WebSocket server URL for the Yjs provider (e.g. "wss://collab.example.com").
-   * Ignored (may be empty) for `externalSession` or when `transport` is `'webrtc'`.
-   */
-  serverUrl: string;
-  /** Transport to use. Defaults to `'websocket'`. */
-  transport?: CollaborationTransport;
-  /**
-   * Use the host's document, awareness and transport instead of creating a
-   * provider. Transport, serverUrl, signaling and authToken are ignored. The
-   * viewer only detaches its listeners and presence on stop; it never destroys
-   * these resources. Keep this object stable and report readiness via subscribe.
-   */
-  externalSession?: ExternalCollaborationSession;
-  /**
-   * WebRTC signaling server URLs (only used when `transport` is `'webrtc'`).
-   * Defaults to y-webrtc's built-in public signaling list. Same-browser tabs
-   * sync via BroadcastChannel regardless of signaling availability.
-   */
-  signaling?: string[];
-  /** Display name for the local user. */
-  userName: string;
-  /** Avatar URL for the local user (optional). */
-  userAvatar?: string;
-  /** Hex colour for the local user's cursor/presence indicator. */
-  userColor?: string;
-  /** Optional authentication token sent with the WebSocket handshake. */
-  authToken?: string;
-  /** Role in the session; defaults to `'collaborator'`. */
-  role?: CollaborationRole;
-  /**
-   * Whether this client created the room or joined an existing room. Providers
-   * do not use this value, but hosts can use it to avoid publishing local file
-   * bytes when handling a join request. Omitted values retain the legacy
-   * create-session behaviour.
-   */
-  sessionIntent?: CollaborationSessionIntent;
-  /**
-   * Elected-writer write-back callback (Area 3 of the C3 hardening plan).
-   *
-   * When the local user has `role: 'owner'`, the binding debounces changes and
-   * serializes the current Y.Doc state to a PPTX byte array, then calls this
-   * callback so the host can persist the snapshot. Only one writer (the owner)
-   * does this; other collaborators never trigger write-back, eliminating the
-   * last-save-wins problem.
-   */
-  onWriteBack?: (bytes: Uint8Array) => void;
-  /**
-   * Debounce delay (ms) between the last Y.Doc change and the write-back
-   * invocation. Defaults to 5000 ms. Set to 0 to write back on every change
-   * (not recommended for large documents).
-   */
-  writeBackDebounceMs?: number;
-}
-//#endregion
-//#region src/render/shape-adjustment-model.d.ts
-/**
- * `shape-adjustment-model`: the vocabulary the adjust-handle modules share.
- *
- * The `a:ahLst` work is split three ways for the repo's file-size budget:
- * `shape-adjustment-probe` measures the geometry, `shape-adjustment-handles`
- * derives the handles from those measurements, and `shape-adjustment-solver`
- * turns a pointer position back into guide values. All three need these types
- * and the one rule that operates purely on them, so they live here and the
- * dependency graph stays a DAG rather than a cycle.
- *
- * @module render/shape-adjustment-model
- */
-/**
- * How a pointer position becomes a guide value, captured once when the gesture
- * starts so `pointermove` stays pure arithmetic.
- */
-interface ShapeAdjustmentSolver {
-  /** `linear`: the handle slides. `angular`: it swings about {@link centerX}. */
-  kind: 'linear' | 'angular';
-  /** Handle position in element-local px at {@link startValue}. */
-  anchorX: number;
-  anchorY: number;
-  /** Element-local px the handle travels per ONE unit of guide value. */
-  dirX: number;
-  dirY: number;
-  /** Pivot for an angular handle (the shape centre). */
-  centerX: number;
-  centerY: number;
-  /** The guide value the anchor was measured at. */
-  startValue: number;
-  /** Guide-space bounds, taken from the preset's own `pin` clamp. */
-  min: number;
-  max: number;
-}
-/** One guide a handle drives. */
-interface AdjustmentAxisSolver {
-  key: string;
-  solver: ShapeAdjustmentSolver;
-}
-/** Descriptor for one draggable adjustment handle (the amber diamond). */
-interface ShapeAdjustmentHandleDescriptor {
-  /** The `a:avLst` guide name this handle writes (`adj`, `adj1`, ...). */
-  key: string;
-  /** Handle x offset in element-local px (origin = element top-left). */
-  left: number;
-  /** Handle y offset in element-local px. */
-  top: number;
-  /**
-   * Current adjustment value in GUIDE units, not a 0-1 fraction. Most presets
-   * range 0..50000 or 0..100000 and the angular ones run to 21,600,000.
-   */
-  value: number;
-  cursor: string;
-  /**
-   * How this handle's drag resolves, measured off the preset geometry: one
-   * entry per `a:avLst` guide it drives (callouts drive two). Absent only for
-   * a caller that built a descriptor by hand.
-   */
-  solvers?: AdjustmentAxisSolver[];
-}
-/** Live drag state captured when an adjustment gesture starts. */
-interface ShapeAdjustmentDragState {
-  elementId: string;
-  key: string;
-  shapeType: string;
-  startClientX: number;
-  startClientY: number;
-  startAdjustment: number;
-  startWidth: number;
-  startHeight: number;
-  moved: boolean;
-  /** Copied from the descriptor the gesture started on. */
-  solvers?: AdjustmentAxisSolver[];
-  /**
-   * The element's whole `a:avLst` map at gesture start.
-   *
-   * A binding writes `shapeAdjustments` as one object, so a drag that sent
-   * only the guide it changed would DELETE every other authored adjustment on
-   * a multi-adjust preset (a `quadArrow` would lose two of its three the first
-   * time one was touched).
-   */
-  startAdjustments?: Record<string, number>;
-}
-/** Everything the Transitions tab's controls currently say. */
-interface RibbonTransitionDraft {
-  /** The highlighted gallery entry. */
-  type: PptxTransitionType;
-  /** Duration field, in seconds. */
-  durationSec: number;
-  /** Advance Slide > On Mouse Click. */
-  advanceOnClick: boolean;
-  /** Advance Slide > After (whether the timed advance is armed at all). */
-  advanceAfter: boolean;
-  /** Advance Slide > After, as the `mm:ss.hh` text the field holds. */
-  advanceAfterText: string;
-}
-type BackstagePage = 'home' | 'new' | 'open' | 'info' | 'save' | 'saveAs' | 'print' | 'share' | 'export' | 'close' | 'account' | 'options';
-//#endregion
-//#region src/render/backstage-cards.d.ts
-/**
- * Every action card the File-tab backstage can show, keyed by the operation it
- * triggers rather than by its wording.
- *
- * The five bindings used to hardcode a title and a body string each, which made
- * the whole backstage untranslatable and let the copy drift: the same card
- * carried four different descriptions depending on which binding you opened it
- * in. Both halves now live here as a dictionary key plus an English fallback,
- * so a wording change lands everywhere at once and a translator only has to
- * translate it once.
- */
-type BackstageCardId = 'protect' | 'inspect' | 'embedFonts' | 'signatures' | 'versionHistory' | 'saveAsPptx' | 'saveAsPpsx' | 'saveAsPptm' | 'saveAsPpt' | 'pdf' | 'png' | 'video' | 'gif' | 'json' | 'copyImage' | 'print' | 'share';
-//#endregion
-//#region src/render/toolbar-actions.d.ts
-/**
- * Toolbar action / ribbon-tab visibility: a single, framework-agnostic
- * catalogue of every top-level toolbar button and ribbon tab a host app can
- * independently hide. Each binding exposes a `hiddenActions?: ToolbarActionId[]`
- * prop, threads it down to the relevant render sites, and gates them with
- * `isActionHidden`. Default (`undefined` / `[]`) hides nothing, matching
- * today's always-visible behaviour.
- *
- * `TOOLBAR_TABS` is also the canonical ribbon-tab list/order, replacing the
- * copy hand-duplicated in each binding (React's `TOOLBAR_SECTIONS`, Vue's
- * `ribbon-constants.ts`, Angular's `RIBBON_TABS`, etc.) so the tab set can't
- * drift between bindings. Per-tab icons stay in each binding (icon libraries
- * differ per framework); only id + i18n key + order are shared here.
- */
-/**
- * A single toolbar button/control that can be hidden independently of the
- * ribbon tab it may also appear inside. `zoom` and `navigation` each cover a
- * whole control cluster (zoom in/out/fit, prev/next) rather than each button
- * in it, matching how hosts actually want to hide/keep them as a unit.
- */
-type ToolbarButtonId = 'share' | 'broadcast' | 'export' | 'undo' | 'redo' | 'record' | 'notes' | 'fullscreen' | 'zoom' | 'navigation' | 'mergeShapes' | 'crop';
-/** A top-level ribbon tab. `record` intentionally shares its id with the quick-access Record button above: both surface the same recording feature, so hiding one hides the other. */
-type ToolbarTabId = 'file' | 'home' | 'insert' | 'draw' | 'design' | 'transitions' | 'animations' | 'slideShow' | 'record' | 'review' | 'view' | 'help';
-type ToolbarActionId = ToolbarButtonId | ToolbarTabId;
-/**
- * PowerPoint's contextual tabs: they join the tab row only while the
- * selection is of their kind (see `contextualTabsForElement` in
- * `ribbon-galleries/`). Kept apart from `ToolbarTabId` because they are not
- * part of the fixed tab order every binding renders.
- */
-type RibbonContextualTabId = 'shapeFormat' | 'pictureFormat' | 'tableDesign' | 'chartDesign' | 'smartArtDesign';
-//#endregion
-//#region src/render/canvas-context-menu-commands.d.ts
-/**
- * The right-click menu for the empty slide canvas (no element under the
- * cursor), as distinct from {@link ./context-menu-commands}'s per-element menu.
- *
- * Right-clicking empty canvas used to do nothing at all in every binding: React
- * and Vue both bailed out early (`getElementIdFromEvent` returns `null`, so the
- * handler just returns) rather than opening a menu, and the other three never
- * wired a handler for it either. PowerPoint offers Paste, Layout, Reset,
- * Format Background and view toggles (Grid and Guides, Ruler) from this menu;
- * this module is the one list every binding renders instead of five omissions.
- *
- * @module render/canvas-context-menu-commands
- */
-/** Every command the empty-canvas context menu can offer, in no particular order. */
-type CanvasContextMenuCommandId = 'paste' | 'layout' | 'reset-slide' | 'format-background' | 'grid-and-guides' | 'ruler';
-//#endregion
-//#region src/render/merge-shapes/merge-shapes-menu.d.ts
-/** The right-click command id for each operation. */
-type MergeShapesCommandId = 'merge-union' | 'merge-combine' | 'merge-fragment' | 'merge-intersect' | 'merge-subtract';
-/** Every command a canvas context menu can offer, in no particular order. */
-type ContextMenuCommandId = 'copy' | 'cut' | 'paste' | 'duplicate' | 'edit-text' | 'edit-points' | 'bring-forward' | 'send-backward' | 'bring-front' | 'send-back' | 'ai-ask' | 'ai-fix' | 'comment' | 'hyperlink' | 'table-insert-row-above' | 'table-insert-row-below' | 'table-delete-row' | 'table-insert-col-left' | 'table-insert-col-right' | 'table-delete-col' | 'table-merge-selected' | 'table-merge-right' | 'table-merge-down' | 'table-split' | 'group' | 'ungroup' | 'crop' | MergeShapesCommandId | 'save-as-picture' | 'edit-alt-text' | 'size-and-position' | 'format-shape' | 'delete';
-/** Every command the Edit Points right-click menu can offer. */
-type EditPointsCommandId = 'add-point' | 'delete-point' | 'delete-segment' | 'open-path' | 'close-path' | 'smooth-point' | 'straight-point' | 'corner-point' | 'straight-segment' | 'curved-segment' | 'exit';
-//#endregion
-//#region src/render/edit-points/freeform-tool-geometry.d.ts
-/** The two click-to-place drawing tools. */
-type FreeformToolKind = 'freeformShape' | 'curve';
-//#endregion
-//#region src/render/editor-keymap.d.ts
-/** A logical editor command produced by one key press. */
-type EditorKeyActionName = 'undo' | 'redo' | 'copy' | 'cut' | 'paste' | 'duplicate' | 'delete' | 'selectAll' | 'group' | 'ungroup' | 'nudge' | 'prevSlide' | 'nextSlide' | 'escape' | 'find' | 'findReplace' | 'toggleShortcuts' | 'alignLeft' | 'alignCenter' | 'alignRight' | 'alignJustify' | 'increaseFontSize' | 'decreaseFontSize' | 'copyFormat' | 'pasteFormat' | 'newSlide' | 'hyperlink' | 'clearFormatting' | 'cycleSelectionNext' | 'cycleSelectionPrev' | 'pasteSpecial';
-//#endregion
-//#region src/render/options/viewer-options.d.ts
-/**
- * Full PowerPoint "File > Options" parity model.
- *
- * Groups mirror the ten categories of PowerPoint's Options dialog. Values are
- * flat primitives per group so the dialog panes can be rendered generically
- * from `VIEWER_OPTIONS_SCHEMA` in every binding. The legacy six-toggle
- * `ViewerPreferences` surface stays supported via the mapping helpers below.
- */
-type ScreenTipStyle = 'descriptions' | 'plain' | 'off';
-type DisplayOptimization = 'appearance' | 'compatibility';
-type ImageResolutionPreset = 'highFidelity' | 'ppi330' | 'ppi220' | 'ppi150' | 'ppi96';
-type OpenDocumentsView = 'savedView' | 'normal' | 'outline' | 'slideSorter' | 'notes';
-type DefaultExportFormat = 'pptx' | 'pdf' | 'png';
-type QuickAccessPosition = 'above' | 'below';
-type FeedbackSoundScheme = 'modern' | 'classic';
-type OptionsPrintWhat = 'slides' | 'handouts' | 'notes' | 'outline';
-type OptionsPrintColorMode = 'color' | 'grayscale' | 'blackAndWhite';
-interface ViewerGeneralOptions {
-  displayOptimization: DisplayOptimization;
-  showMiniToolbar: boolean;
-  enableLivePreview: boolean;
-  collapseRibbonAutomatically: boolean;
-  collapseSearchByDefault: boolean;
-  screenTipStyle: ScreenTipStyle;
-  userName: string;
-  userInitials: string;
-  showStartScreen: boolean;
-  /**
-   * Lets the user hand a local font file to the viewer so decks authored
-   * with a font the browser lacks render with the real face.
-   *
-   * Off by default. The registration reads a file the user picks and adds it
-   * to the page's font set for the session, which is a capability a host
-   * embedding the viewer should opt into rather than inherit.
-   */
-  enableCustomFontUpload: boolean;
-}
-interface ViewerProofingOptions {
-  autoCorrectTwoInitialCapitals: boolean;
-  autoCorrectCapitalizeFirstLetter: boolean;
-  autoCorrectCapitalizeDayNames: boolean;
-  autoCorrectSmartQuotes: boolean;
-  autoCorrectHyphensToDash: boolean;
-  autoCorrectFractions: boolean;
-  autoCorrectOrdinals: boolean;
-  ignoreUppercase: boolean;
-  ignoreWordsWithNumbers: boolean;
-  ignoreInternetAddresses: boolean;
-  flagRepeatedWords: boolean;
-  checkSpellingAsYouType: boolean;
-  hideSpellingErrors: boolean;
-}
-/**
- * File > Options > Save.
- *
- * Font embedding deliberately has NO entry here. It is owned by the File >
- * Fonts panel, whose toggle is the one the save path reads (see
- * `render/font-embedding`: `describeFontEmbedding` decides the toggle's start
- * position and whether it can do anything at all, `embeddedFontSaveOptions`
- * turns it into the `PptxHandler.save()` slice). This group used to carry a
- * second `embedFonts` boolean, plus an `embedAllFontCharacters` companion, and
- * neither was read by anything: the pane moved a switch that changed no saved
- * byte, while the panel next door moved the real one. Two switches for one
- * setting, one of them lying, is worse than one switch in a less
- * PowerPoint-shaped place.
- */
-interface ViewerSaveOptions {
-  autoSave: boolean;
-  autoRecoverIntervalMinutes: number;
-  keepLastAutoRecoveredVersion: boolean;
-  defaultExportFormat: DefaultExportFormat;
-  cacheRetentionDays: number;
-  clearCacheOnClose: boolean;
-}
-interface ViewerAccessibilityOptions {
-  /** Browser speech-recognition language; automatic follows the browser language. */
-  subtitleLanguage?: string;
-  showAccessibilityStatus: boolean;
-  feedbackWithSound: boolean;
-  soundScheme: FeedbackSoundScheme;
-  showShortcutKeysInScreenTips: boolean;
-  reducedMotion: boolean;
-}
-interface ViewerAdvancedOptions {
-  autoSelectEntireWord: boolean;
-  allowTextDragAndDrop: boolean;
-  maximumUndoSteps: number;
-  useSmartCutAndPaste: boolean;
-  showPasteOptionsButton: boolean;
-  imageDefaultResolution: ImageResolutionPreset;
-  doNotCompressImages: boolean;
-  chartPropertiesFollowDataPoint: boolean;
-  recentPresentationsCount: number;
-  showVerticalRuler: boolean;
-  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;
-  /**
-   * `p:animEffect/@filter="pixelate"` defaults to snapping the element to
-   * its end state (`cutIn`/`cutOut`), matching PowerPoint's own behaviour
-   * (COM `CreateVideo` frame-diffing shows PowerPoint performs no animation
-   * at all for this filter value). This turns on the blocky mosaic reveal
-   * this renderer can build instead, for a viewer that would rather show
-   * something animating than PowerPoint's own instant swap. See
-   * `resolveFilterEffect` in `animation-filter-effects.ts` and
-   * `docs/guide/visual-effects.md`.
-   */
-  pixelateMosaicAnimation: boolean;
-  openDocumentsView: OpenDocumentsView;
-  slideShowShowMenuOnRightClick: boolean;
-  slideShowShowPopupToolbar: boolean;
-  slideShowPromptKeepInkAnnotations: boolean;
-  slideShowEndWithBlackSlide: boolean;
-  printInBackground: boolean;
-  printHighQuality: boolean;
-  printUseMostRecentSettings: boolean;
-  printWhat: OptionsPrintWhat;
-  printColorMode: OptionsPrintColorMode;
-  printHiddenSlides: boolean;
-  printScaleToFit: boolean;
-  printFrameSlides: boolean;
-}
-interface ViewerRibbonOptions {
-  /** Ribbon tabs unticked in Customize Ribbon. The File tab can never be hidden. */
-  hiddenTabIds: ToolbarTabId[];
-}
-interface ViewerQuickAccessOptions {
-  visible: boolean;
-  position: QuickAccessPosition;
-  showCommandLabels: boolean;
-  /** Ordered ids from `QUICK_ACCESS_COMMAND_CATALOG`. */
-  commandIds: string[];
-}
-interface ViewerTrustOptions {
-  openInProtectedView: boolean;
-  allowExternalContent: boolean;
-  confirmExternalHyperlinks: boolean;
-}
-interface ViewerOptions {
-  general: ViewerGeneralOptions;
-  proofing: ViewerProofingOptions;
-  save: ViewerSaveOptions;
-  accessibility: ViewerAccessibilityOptions;
-  advanced: ViewerAdvancedOptions;
-  ribbon: ViewerRibbonOptions;
-  quickAccess: ViewerQuickAccessOptions;
-  trust: ViewerTrustOptions;
-}
-type ViewerOptionsGroupId = keyof ViewerOptions;
-type ViewerOptionPrimitive = boolean | number | string;
-//#endregion
-//#region src/render/options/viewer-options-controls.d.ts
-/**
- * Control/section/tab descriptor types for the File > Options schema, plus
- * the terse constructors the tab-definition modules build panes with.
- */
-type ViewerOptionsTabId = 'general' | 'proofing' | 'save' | 'language' | 'accessibility' | 'advanced' | 'ribbon' | 'quickAccess' | 'addIns' | 'trust';
-//#endregion
-//#region src/render/customization/host-menu-commands.d.ts
-/** Snapshot of the slide on which the host command was offered. */
-interface HostCanvasMenuContext {
-  slideIndex: number;
-}
-/** Effective selection, including a single right-clicked element. */
-interface HostElementMenuContext extends HostCanvasMenuContext {
-  elementIds: readonly string[];
-}
-/** Plain text labels work identically in every framework. */
-interface HostMenuCommand<C> {
-  id: string;
-  label: string;
-  /** Default: a separate group above the built-in commands. */
-  group?: 'top' | 'bottom';
-  disabled?: boolean | ((context: C) => boolean);
-  onSelect: (context: C) => void;
-}
-//#endregion
-//#region src/render/customization/ribbon-control-catalog.d.ts
-declare const RIBBON_CONTROL_CATALOG: {
-  readonly home: {
-    readonly clipboard: {
-      readonly label: 'Clipboard';
-      readonly controls: {
-        readonly paste: 'Paste';
-        readonly cut: 'Cut';
-        readonly copy: 'Copy';
-        readonly formatPainter: 'Format Painter';
-      };
-    };
-    readonly slides: {
-      readonly label: 'Slides';
-      readonly controls: {
-        readonly newSlide: 'New Slide';
-        readonly layout: 'Layout';
-        readonly reset: 'Reset';
-        readonly section: 'Section';
-        readonly slideTemplates: 'Slide templates';
-      };
-    };
-    readonly font: {
-      readonly label: 'Font';
-      readonly controls: {
-        readonly fontFamily: 'Font';
-        readonly fontSize: 'Font Size';
-        readonly increaseFontSize: 'Increase Font Size';
-        readonly decreaseFontSize: 'Decrease Font Size';
-        readonly clearFormatting: 'Clear All Formatting';
-        readonly bold: 'Bold';
-        readonly italic: 'Italic';
-        readonly underline: 'Underline';
-        readonly strikethrough: 'Strikethrough';
-        readonly shadow: 'Text Shadow';
-        readonly characterSpacing: 'Character Spacing';
-        readonly changeCase: 'Change Case';
-        readonly fontColor: 'Font Color';
-        readonly highlightColor: 'Text Highlight Color';
-        readonly superscript: 'Superscript';
-        readonly subscript: 'Subscript';
-      };
-    };
-    readonly paragraph: {
-      readonly label: 'Paragraph';
-      readonly controls: {
-        readonly bullets: 'Bullets (toggle and gallery)';
-        readonly numbering: 'Numbering (toggle and gallery)';
-        readonly decreaseIndent: 'Decrease List Level';
-        readonly increaseIndent: 'Increase List Level';
-        readonly lineSpacing: 'Line Spacing';
-        readonly alignLeft: 'Align Left';
-        readonly alignCenter: 'Center';
-        readonly alignRight: 'Align Right';
-        readonly justify: 'Justify';
-        readonly columns: 'Columns';
-        readonly textDirection: 'Text Direction';
-        readonly alignText: 'Align Text';
-      };
-    };
-    readonly drawing: {
-      readonly label: 'Drawing';
-      readonly controls: {
-        readonly shapes: 'Shapes';
-        readonly arrange: 'Arrange';
-        readonly quickStyles: 'Quick Styles (Shape Styles gallery)';
-        readonly shapeFill: 'Shape Fill';
-        readonly shapeOutline: 'Shape Outline';
-        readonly shapeEffects: 'Shape Effects gallery';
-      };
-    };
-    readonly arrange: {
-      readonly label: 'Arrange';
-      readonly controls: {
-        readonly bringForward: 'Bring Forward';
-        readonly sendBackward: 'Send Backward';
-        readonly bringToFront: 'Bring to Front';
-        readonly sendToBack: 'Send to Back';
-        readonly flipHorizontal: 'Flip Horizontal';
-        readonly flipVertical: 'Flip Vertical';
-        readonly duplicate: 'Duplicate';
-        readonly delete: 'Delete';
-        readonly group: 'Group';
-        readonly ungroup: 'Ungroup';
-        readonly align: 'Align';
-        readonly mergeShapes: 'Merge Shapes';
-        readonly crop: 'Crop';
-        readonly outlineWidth: 'Outline width';
-      };
-    };
-    readonly editing: {
-      readonly label: 'Editing';
-      readonly controls: {
-        readonly find: 'Find';
-        readonly replace: 'Replace';
-        readonly select: 'Select';
-      };
-    };
-  };
-  readonly insert: {
-    readonly slides: {
-      readonly label: 'Slides';
-      readonly controls: {
-        readonly newSlide: 'New Slide';
-      };
-    };
-    readonly tables: {
-      readonly label: 'Tables';
-      readonly controls: {
-        readonly table: 'Table';
-      };
-    };
-    readonly images: {
-      readonly label: 'Images';
-      readonly controls: {
-        readonly pictures: 'Pictures';
-      };
-    };
-    readonly illustrations: {
-      readonly label: 'Illustrations';
-      readonly controls: {
-        readonly shapes: 'Shapes';
-        readonly smartArt: 'SmartArt';
-        readonly chart: 'Chart';
-      };
-    };
-    readonly links: {
-      readonly label: 'Links';
-      readonly controls: {
-        readonly link: 'Link';
-        readonly action: 'Action button';
-      };
-    };
-    readonly comments: {
-      readonly label: 'Comments';
-      readonly controls: {
-        readonly comment: 'Comment';
-      };
-    };
-    readonly text: {
-      readonly label: 'Text';
-      readonly controls: {
-        readonly textBox: 'Text Box';
-        readonly field: 'Header, date, slide number field';
-      };
-    };
-    readonly symbols: {
-      readonly label: 'Symbols';
-      readonly controls: {
-        readonly equation: 'Equation';
-        readonly symbol: 'Symbol';
-      };
-    };
-    readonly media: {
-      readonly label: 'Media';
-      readonly controls: {
-        readonly media: 'Video / Audio';
-      };
-    };
-  };
-  readonly draw: {
-    readonly tools: {
-      readonly label: 'Drawing Tools';
-      readonly controls: {
-        readonly select: 'Select';
-        readonly pen: 'Pen';
-        readonly highlighter: 'Highlighter';
-        readonly freeform: 'Freeform';
-        readonly eraser: 'Eraser';
-        readonly penColor: 'Pen colour';
-        readonly penWidth: 'Pen width';
-      };
-    };
-    readonly convert: {
-      readonly label: 'Convert';
-      readonly controls: {
-        readonly inkToShape: 'Ink to Shape';
-      };
-    };
-  };
-  readonly design: {
-    readonly themes: {
-      readonly label: 'Themes';
-      readonly controls: {
-        readonly browseThemes: 'Themes gallery';
-        readonly editTheme: 'Edit theme';
-      };
-    };
-    readonly variants: {
-      readonly label: 'Variants';
-      readonly controls: {
-        readonly colors: 'Variants: Colors gallery';
-        readonly fonts: 'Variants: Fonts gallery';
-      };
-    };
-    readonly customize: {
-      readonly label: 'Customize';
-      readonly controls: {
-        readonly slideSize: 'Slide Size';
-        readonly formatBackground: 'Format Background';
-      };
-    };
-  };
-  readonly transitions: {
-    readonly preview: {
-      readonly label: 'Preview';
-      readonly controls: {
-        readonly preview: 'Preview';
-      };
-    };
-    readonly transitionToThisSlide: {
-      readonly label: 'Transition to This Slide';
-      readonly controls: {
-        readonly gallery: 'Transition gallery';
-        readonly effectOptions: 'Effect Options';
-      };
-    };
-    readonly timing: {
-      readonly label: 'Timing';
-      readonly controls: {
-        readonly sound: 'Sound';
-        readonly duration: 'Duration';
-        readonly applyToAll: 'Apply To All';
-        readonly advanceOnClick: 'On Mouse Click';
-        readonly advanceAfter: 'After';
-      };
-    };
-  };
-  readonly animations: {
-    readonly preview: {
-      readonly label: 'Preview';
-      readonly controls: {
-        readonly preview: 'Preview';
-      };
-    };
-    readonly animation: {
-      readonly label: 'Animation';
-      readonly controls: {
-        readonly gallery: 'Animation gallery';
-        readonly effectOptions: 'Effect Options';
-      };
-    };
-    readonly motionPath: {
-      readonly label: 'Motion Paths';
-      readonly controls: {
-        readonly gallery: 'Motion path gallery';
-      };
-    };
-    readonly advancedAnimation: {
-      readonly label: 'Advanced Animation';
-      readonly controls: {
-        readonly addAnimation: 'Add Animation';
-        readonly animationPane: 'Animation Pane';
-        readonly trigger: 'Trigger';
-        readonly animationPainter: 'Animation Painter';
-        readonly remove: 'Remove animation';
-      };
-    };
-    readonly timing: {
-      readonly label: 'Timing';
-      readonly controls: {
-        readonly start: 'Start';
-        readonly duration: 'Duration';
-        readonly delay: 'Delay';
-        readonly reorder: 'Reorder';
-      };
-    };
-  };
-  readonly slideShow: {
-    readonly startSlideShow: {
-      readonly label: 'Start Slide Show';
-      readonly controls: {
-        readonly fromBeginning: 'From Beginning';
-        readonly fromCurrent: 'From Current Slide';
-        readonly customShow: 'Custom Slide Show';
-      };
-    };
-    readonly present: {
-      readonly label: 'Present';
-      readonly controls: {
-        readonly presenterView: 'Presenter View';
-        readonly broadcast: 'Present Online';
-      };
-    };
-    readonly setUp: {
-      readonly label: 'Set Up';
-      readonly controls: {
-        readonly setUpSlideShow: 'Set Up Slide Show';
-        readonly hideSlide: 'Hide Slide';
-        readonly rehearseTimings: 'Rehearse Timings';
-        readonly record: 'Record';
-        readonly rehearseWithCoach: 'Rehearse with Coach';
-      };
-    };
-    readonly captions: {
-      readonly label: 'Captions & Subtitles';
-      readonly controls: {
-        readonly subtitles: 'Always Use Subtitles';
-        readonly subtitleSettings: 'Subtitle Settings';
-      };
-    };
-  };
-  readonly record: {
-    readonly camera: {
-      readonly label: 'Camera';
-      readonly controls: {
-        readonly cameo: 'Cameo';
-      };
-    };
-    readonly record: {
-      readonly label: 'Record';
-      readonly controls: {
-        readonly fromBeginning: 'From Beginning';
-        readonly fromCurrent: 'From Current Slide';
-      };
-    };
-    readonly manage: {
-      readonly label: 'Manage';
-      readonly controls: {
-        readonly clear: 'Clear';
-        readonly reset: 'Reset to Cameo';
-      };
-    };
-    readonly help: {
-      readonly label: 'Help';
-      readonly controls: {
-        readonly learnMore: 'Learn more';
-      };
-    };
-  };
-  readonly review: {
-    readonly proofing: {
-      readonly label: 'Proofing';
-      readonly controls: {
-        readonly spelling: 'Spelling';
-        readonly thesaurus: 'Thesaurus';
-      };
-    };
-    readonly accessibility: {
-      readonly label: 'Accessibility';
-      readonly controls: {
-        readonly check: 'Check Accessibility';
-      };
-    };
-    readonly language: {
-      readonly label: 'Language';
-      readonly controls: {
-        readonly translate: 'Translate';
-        readonly language: 'Language';
-      };
-    };
-    readonly comments: {
-      readonly label: 'Comments';
-      readonly controls: {
-        readonly newComment: 'New Comment';
-        readonly delete: 'Delete';
-        readonly previous: 'Previous';
-        readonly next: 'Next';
-        readonly showComments: 'Show Comments';
-      };
-    };
-    readonly compare: {
-      readonly label: 'Compare';
-      readonly controls: {
-        readonly compare: 'Compare';
-        readonly markAllRead: 'Mark all read';
-      };
-    };
-    readonly protect: {
-      readonly label: 'Protect';
-      readonly controls: {
-        readonly readOnly: 'Read-only';
-        readonly restrictPermission: 'Restrict Permission';
-      };
-    };
-    readonly ink: {
-      readonly label: 'Ink';
-      readonly controls: {
-        readonly hideInk: 'Hide Ink';
-      };
-    };
-  };
-  readonly view: {
-    readonly presentationViews: {
-      readonly label: 'Presentation Views';
-      readonly controls: {
-        readonly normal: 'Normal';
-        readonly outline: 'Outline View';
-        readonly slideSorter: 'Slide Sorter';
-        readonly notesPage: 'Notes Page';
-        readonly readingView: 'Reading View';
-      };
-    };
-    readonly masterViews: {
-      readonly label: 'Master Views';
-      readonly controls: {
-        readonly slideMaster: 'Slide Master';
-        readonly handoutMaster: 'Handout Master';
-        readonly notesMaster: 'Notes Master';
-      };
-    };
-    readonly show: {
-      readonly label: 'Show';
-      readonly controls: {
-        readonly ruler: 'Ruler';
-        readonly gridlines: 'Gridlines';
-        readonly guides: 'Guides';
-        readonly snapToGrid: 'Snap to Grid';
-        readonly snapToShape: 'Snap to Shape';
-        readonly addGuide: 'Add horizontal / vertical guide';
-        readonly selectionPane: 'Selection Pane';
-        readonly eyedropper: 'Eyedropper';
-        readonly notes: 'Notes';
-      };
-    };
-    readonly zoom: {
-      readonly label: 'Zoom';
-      readonly controls: {
-        readonly zoom: 'Zoom';
-        readonly fitToWindow: 'Fit to Window';
-      };
-    };
-    readonly window: {
-      readonly label: 'Window';
-      readonly controls: {
-        readonly templateEditing: 'Edit template elements';
-        readonly macros: 'Macros';
-      };
-    };
-  };
-  readonly help: {
-    readonly help: {
-      readonly label: 'Help';
-      readonly controls: {
-        readonly options: 'Options';
-        readonly keyboardShortcuts: 'Keyboard shortcuts';
-        readonly accessibility: 'Accessibility checker';
-      };
-    };
-  };
-  readonly shapeFormat: {
-    readonly shapeStyles: {
-      readonly label: 'Shape Styles';
-      readonly controls: {
-        readonly gallery: 'Shape Styles gallery';
-        readonly shapeEffects: 'Shape Effects gallery';
-      };
-    };
-    readonly wordArtStyles: {
-      readonly label: 'WordArt Styles';
-      readonly controls: {
-        readonly gallery: 'WordArt Styles gallery';
-      };
-    };
-  };
-  readonly pictureFormat: {
-    readonly adjust: {
-      readonly label: 'Adjust';
-      readonly controls: {
-        readonly corrections: 'Corrections gallery';
-        readonly color: 'Color gallery';
-        readonly artisticEffects: 'Artistic Effects gallery';
-      };
-    };
-    readonly pictureStyles: {
-      readonly label: 'Picture Styles';
-      readonly controls: {
-        readonly gallery: 'Picture Styles gallery';
-        readonly pictureEffects: 'Picture Effects gallery';
-      };
-    };
-  };
-  readonly tableDesign: {
-    readonly tableStyles: {
-      readonly label: 'Table Styles';
-      readonly controls: {
-        readonly gallery: 'Table Styles gallery';
-      };
-    };
-  };
-  readonly chartDesign: {
-    readonly chartLayouts: {
-      readonly label: 'Chart Layouts';
-      readonly controls: {
-        readonly quickLayout: 'Quick Layout gallery';
-      };
-    };
-    readonly chartStyles: {
-      readonly label: 'Chart Styles';
-      readonly controls: {
-        readonly changeColors: 'Change Colors gallery';
-        readonly gallery: 'Chart Styles gallery';
-      };
-    };
-  };
-  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: {
-        readonly changeColors: 'Change Colors gallery';
-        readonly gallery: 'SmartArt Styles gallery';
-      };
-    };
-    readonly reset: {
-      readonly label: 'Reset';
-      readonly controls: {
-        readonly resetGraphic: 'Reset Graphic';
-        readonly convert: 'Convert';
-      };
-    };
-  };
-};
-//#endregion
-//#region src/render/customization/ribbon-control-ids.d.ts
-type Catalog = typeof RIBBON_CONTROL_CATALOG;
-/** `<tab>.<group>`, for example `home.font`. */
-type RibbonGroupId = { [T in keyof Catalog]: { [G in keyof Catalog[T]]: `${T & string}.${G & string}`; }[keyof Catalog[T]]; }[keyof Catalog];
-/** `<tab>.<group>.<control>`, for example `home.font.bold`. */
-type RibbonControlId = { [T in keyof Catalog]: { [G in keyof Catalog[T]]: Catalog[T][G] extends {
-  controls: infer C;
-} ? `${T & string}.${G & string}.${keyof C & string}` : never; }[keyof Catalog[T]]; }[keyof Catalog];
-//#endregion
-//#region src/render/customization/customization-types.d.ts
-/** Keys of an options group whose value is a primitive (not an array). */
-type PrimitiveKeys<T> = { [K in keyof T]: T[K] extends ViewerOptionPrimitive ? K : never; }[keyof T] & string;
-/**
- * One File > Options setting, addressed as `<group>.<key>`, for example
- * `general.userName` or `advanced.showGrid`. The union is derived from the
- * `ViewerOptions` model itself, so a typo is a compile error.
- */
-type OptionsSettingId = { [G in ViewerOptionsGroupId]: `${G}.${PrimitiveKeys<ViewerOptions[G]>}`; }[ViewerOptionsGroupId];
-/**
- * A File > Options page: the ten PowerPoint categories plus `ai`, the AI
- * assistant page a binding adds when the host configured an assistant.
- */
-type OptionsPageId = ViewerOptionsTabId | 'ai';
-/**
- * One section of an Options page, addressed as `<page>.<section>`, for
- * example `general.personalize` or `advanced.print`. The full list is
- * `OPTIONS_SECTION_IDS` (derived from the schema at runtime).
- */
-type OptionsSectionId = `${ViewerOptionsTabId}.${string}`;
-/** Values a host forces onto settings. */
-type OptionsSettingValues = Partial<Record<OptionsSettingId, ViewerOptionPrimitive>>;
-/** Ribbon and toolbar customisation. */
-interface RibbonCustomization {
-  /**
-   * Ribbon tabs to remove (the File tab included, unlike Customize Ribbon),
-   * and contextual tabs (`shapeFormat`, `pictureFormat`, ...) that should
-   * never appear.
-   */
-  hiddenTabs?: readonly (ToolbarTabId | RibbonContextualTabId)[];
-  /** Groups inside a tab to remove, as `<tab>.<group>` (`home.font`). */
-  hiddenGroups?: readonly RibbonGroupId[];
-  /**
-   * Controls to remove: a top-level toolbar button / control cluster
-   * (`share`, `zoom`, ...) or any ribbon control as
-   * `<tab>.<group>.<control>` (`home.font.bold`).
-   */
-  hiddenButtons?: readonly (ToolbarButtonId | RibbonControlId)[];
-}
-/** File > Options (the Settings dialog) customisation. */
-interface OptionsCustomization {
-  /** Whole pages to remove from the dialog's category rail. */
-  hiddenPages?: readonly OptionsPageId[];
-  /** Sections (`<page>.<section>`) to remove from their page. */
-  hiddenSections?: readonly OptionsSectionId[];
-  /** Individual settings (`<group>.<key>`) to remove wherever they appear. */
-  hiddenSettings?: readonly OptionsSettingId[];
-  /**
-   * Settings pinned to a fixed value. The value is forced into the options
-   * store, user edits to it are ignored, and the control renders read-only.
-   * Add the id to `hiddenSettings` too to lock it invisibly.
-   */
-  locked?: OptionsSettingValues;
-  /**
-   * Host defaults: the value a setting starts at when the user has not saved
-   * a choice of their own. "Reset" returns to these, not to the built-ins.
-   */
-  defaults?: OptionsSettingValues;
-}
-/** File tab (backstage) customisation. */
-interface BackstageCustomization {
-  /** Navigation entries (pages) to remove from the File tab. */
-  hiddenPages?: readonly BackstagePage[];
-  /** Action cards to remove from the pages that show them. */
-  hiddenCards?: readonly BackstageCardId[];
-}
-/** Right-click menu customisation. */
-interface ContextMenuCustomization {
-  /** Additional host commands, independent of the viewer's AI connection. */
-  extraElementCommands?: readonly HostMenuCommand<HostElementMenuContext>[];
-  extraCanvasCommands?: readonly HostMenuCommand<HostCanvasMenuContext>[];
-  /** Entries to remove from the element (right-click on a shape) menu. */
-  hiddenElementCommands?: readonly ContextMenuCommandId[];
-  /** Entries to remove from the empty-canvas menu. */
-  hiddenCanvasCommands?: readonly CanvasContextMenuCommandId[];
-  /**
-   * Entries to remove from the Edit Points menu (right-click a vertex or a
-   * segment while editing a shape's points).
-   */
-  hiddenEditPointsCommands?: readonly EditPointsCommandId[];
-  /** Remove the element context menu entirely. */
-  disableElementMenu?: boolean;
-  /** Remove the empty-canvas context menu entirely. */
-  disableCanvasMenu?: boolean;
-}
-/**
- * A shortcut chord in the form `Mod+Shift+D`: modifiers `Mod` (Ctrl on
- * Windows/Linux, Cmd on macOS), `Ctrl`, `Meta`, `Alt`, `Shift`, joined by `+`,
- * followed by a `KeyboardEvent.key` value (`D`, `Delete`, `ArrowLeft`, `F2`).
- */
-type ShortcutChord = string;
-/** Editor keyboard-shortcut customisation. */
-interface KeyboardCustomization {
-  /** Turn every editor shortcut off (the host owns the keyboard). */
-  disableAll?: boolean;
-  /** Editor commands whose shortcut is turned off. */
-  disabled?: readonly EditorKeyActionName[];
-  /**
-   * Replacement chords per command. A remapped command no longer answers to
-   * its built-in chord; it answers to the chord(s) given here instead.
-   */
-  remap?: Partial<Record<EditorKeyActionName, ShortcutChord | readonly ShortcutChord[]>>;
-}
-/**
- * Chrome regions a host can remove. Each id maps onto one region in every
- * binding; see `VIEWER_PANEL_IDS` for the catalogue.
- */
-type ViewerPanelId = 'statusBar' | 'slidesPane' | 'inspector' | 'notes' | 'quickAccessToolbar' | 'titleBar';
-/** Feature areas that can be switched off as a whole. */
-type ViewerFeatureId = 'ai' | 'collaboration' | 'comments' | 'presentMode' | 'editPoints';
-/**
- * The click-to-place drawing tools of Insert > Shapes > Lines: Freeform:
- * Shape and Curve.
- */
-type ViewerDrawingToolId = FreeformToolKind;
-/** Dialogs (and the entry points that open them) a host can remove. */
-type ViewerDialogId = 'options' | 'share' | 'broadcast' | 'print' | 'export';
-/** Export formats offered by the File > Export page. */
-type ViewerExportFormatId = 'pdf' | 'png' | 'video' | 'gif' | 'json' | 'copyImage';
-/**
- * The whole customisation object. Every field is optional; omitted fields hide
- * nothing and lock nothing.
- */
-interface ViewerCustomization {
-  ribbon?: RibbonCustomization;
-  options?: OptionsCustomization;
-  backstage?: BackstageCustomization;
-  contextMenu?: ContextMenuCustomization;
-  keyboard?: KeyboardCustomization;
-  /** Chrome regions to remove (`true` hides). */
-  hiddenPanels?: readonly ViewerPanelId[];
-  /** Feature areas to switch off (their buttons, menus, pages and panels). */
-  disabledFeatures?: readonly ViewerFeatureId[];
-  /** Dialogs to remove, along with every entry point that opens them. */
-  hiddenDialogs?: readonly ViewerDialogId[];
-  /** Export formats to remove from File > Export. */
-  hiddenExportFormats?: readonly ViewerExportFormatId[];
-  /** Drawing tools to remove from the Insert > Shapes gallery. */
-  hiddenDrawingTools?: readonly ViewerDrawingToolId[];
-}
-//#endregion
-//#region src/render/customization/customization-controller.d.ts
-/** The imperative methods every binding's component handle exposes. */
-interface ViewerCustomizationApi {
-  /** The current customisation object (a snapshot; do not mutate). */
-  getCustomization(): ViewerCustomization;
-  /** Replace the whole customisation. */
-  setCustomization(next: ViewerCustomization): void;
-  /** Merge a partial customisation (see `mergeCustomization`). */
-  updateCustomization(patch: ViewerCustomization): void;
-  /** Drop every customisation, back to the stock UI. */
-  resetCustomization(): void;
-  /** Hide a fixed tab, or stop a contextual tab (`shapeFormat`, ...) from appearing. */
-  hideRibbonTab(tab: ToolbarTabId | RibbonContextualTabId): void;
-  showRibbonTab(tab: ToolbarTabId | RibbonContextualTabId): void;
-  /** Hide a group inside a tab (`home.font`). */
-  hideRibbonGroup(group: RibbonGroupId): void;
-  showRibbonGroup(group: RibbonGroupId): void;
-  /** Hide a top-level toolbar button or any ribbon control (`home.font.bold`). */
-  hideToolbarButton(button: ToolbarButtonId | RibbonControlId): void;
-  showToolbarButton(button: ToolbarButtonId | RibbonControlId): void;
-  /** Alias of `hideToolbarButton` for a ribbon control id. */
-  hideRibbonControl(control: RibbonControlId): void;
-  showRibbonControl(control: RibbonControlId): void;
-  hideOptionsPage(page: OptionsPageId): void;
-  showOptionsPage(page: OptionsPageId): void;
-  hideOptionsSection(section: OptionsSectionId): void;
-  showOptionsSection(section: OptionsSectionId): void;
-  hideSetting(setting: OptionsSettingId): void;
-  showSetting(setting: OptionsSettingId): void;
-  /** Pin a setting to `value`; `hidden` also removes it from the dialog. */
-  lockSetting(setting: OptionsSettingId, value: ViewerOptionPrimitive, hidden?: boolean): void;
-  unlockSetting(setting: OptionsSettingId): void;
-  /** Set (or with `undefined`, clear) the host default for a setting. */
-  setSettingDefault(setting: OptionsSettingId, value: ViewerOptionPrimitive | undefined): void;
-  hideBackstagePage(page: BackstagePage): void;
-  showBackstagePage(page: BackstagePage): void;
-  hideBackstageCard(card: BackstageCardId): void;
-  showBackstageCard(card: BackstageCardId): void;
-  hideContextMenuCommand(command: ContextMenuCommandId): void;
-  showContextMenuCommand(command: ContextMenuCommandId): void;
-  hideCanvasContextMenuCommand(command: CanvasContextMenuCommandId): void;
-  showCanvasContextMenuCommand(command: CanvasContextMenuCommandId): void;
-  disableShortcut(action: EditorKeyActionName): void;
-  enableShortcut(action: EditorKeyActionName): void;
-  /** Move a command onto new chord(s); `undefined` restores the built-in chord. */
-  remapShortcut(action: EditorKeyActionName, chords: ShortcutChord | readonly ShortcutChord[] | undefined): void;
-  setPanelVisible(panel: ViewerPanelId, visible: boolean): void;
-  setFeatureEnabled(feature: ViewerFeatureId, enabled: boolean): void;
-  setDialogAvailable(dialog: ViewerDialogId, available: boolean): void;
-}
-//#endregion
-//#region src/render/ribbon-command-view.d.ts
-/** A host supplies translated labels and controlled state; shared owns markup. */
-interface RibbonCommandView {
-  id: RibbonControlId;
-  label: string;
-  icon: string;
-  title?: string;
-  disabled?: boolean;
-  active?: boolean;
-  pressed?: boolean;
-  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;
-}
-interface RibbonGroupView {
-  id: RibbonGroupId;
-  label: string;
-  commands: readonly RibbonCommandView[];
-}
-/**
- * A font supplied by the host application. The package never ships fonts:
- * applications provide a licensed URL, data URL, or blob URL for their users.
- */
-interface ViewerFontSource {
-  family: string;
-  src: string;
-  format?: 'truetype' | 'opentype' | 'woff' | 'woff2';
-  weight?: string | number;
-  style?: 'normal' | 'italic';
-}
-//#endregion
-//#region src/render/session-restore.d.ts
-/**
- * session-restore: keep the deck a host app has open across a page refresh.
- *
- * A host (the demo apps, or any embedder) owns the bytes it hands to the
- * viewer, so a plain reload drops them and the user lands back on the file
- * dropzone with their presentation gone. This store remembers the open deck in
- * IndexedDB and hands it back on the next load.
- *
- * Scope is deliberately per-tab: the record is keyed by an id kept in
- * `sessionStorage`, which survives a reload but NOT a new tab. Refreshing
- * restores the deck this tab had open, while a second tab opened on the same
- * origin still starts on the landing page, and two tabs holding different decks
- * never steal each other's content.
- *
- * `restoreSessionDeck` additionally prefers a NEWER autosave snapshot for the
- * same file (see `./autosave-store`), so a refresh mid-edit comes back with the
- * edited deck rather than the pristine bytes that were first opened.
- *
- * Every operation is best-effort: a blocked IndexedDB, a partitioned
- * `sessionStorage`, or an exhausted quota degrades to "no restore", never to a
- * thrown error in the host.
- */
-/** A deck remembered for the current tab. */
-interface SessionDeck {
-  /** File name the deck was opened under, used as the autosave key. */
-  fileName: string;
-  /** The presentation bytes. */
-  data: Uint8Array;
-  /** When these bytes were remembered (epoch ms). */
-  timestamp: number;
-}
-/**
- * This tab's session id, or `null` when `sessionStorage` is unavailable (a
- * sandboxed iframe, or a browser with storage disabled).
- *
- * @param create Mint and persist an id when the tab does not have one yet.
- *   Reads pass `false` so a fresh tab never claims another tab's record.
- */
-declare function getSessionTabId(create?: boolean): string | null;
-/**
- * Remember `data` as the deck this tab has open, so the next load can restore
- * it. Resolves `false` when the browser refused to store it; callers treat that
- * as "no restore available later", never as an error.
- */
-declare function rememberSessionDeck(fileName: string, data: Uint8Array): Promise<boolean>;
-/** The deck remembered for this tab, or `null` when there is nothing to restore. */
-declare function loadSessionDeck(): Promise<SessionDeck | null>;
-/** Forget this tab's deck (the host closed it, or handed the tab to another flow). */
-declare function forgetSessionDeck(): Promise<void>;
-/**
- * The deck to reopen on load: this tab's remembered bytes, upgraded to a newer
- * autosave snapshot of the same file when the viewer wrote one after they were
- * remembered. Without that upgrade a refresh mid-edit would silently roll the
- * 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.
- */
-declare function storeAudienceContent(content: ArrayBuffer | Uint8Array, sessionId?: string): Promise<void>;
-/**
- * Load PPTX content bytes stored by the presenter tab.
- * Returns `null` if nothing is stored.
- */
-declare function loadAudienceContent(sessionId?: string): Promise<Uint8Array | null>;
-/**
- * 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;
-}
-interface SubtitleSettingsLabels {
-  title: string;
-  language: string;
-  browserLanguage: string;
-  description: string;
-  apply: string;
-  cancel: string;
-}
-/**
- * Optional hook point for hosts that want to wire a real sign-in flow into
- * File > Account. Disabled by default: the Account page renders nothing
- * extra unless a host explicitly opts in by passing `enabled: true`.
- * See docs/guide for wiring instructions.
- */
-interface AccountAuthConfig {
-  enabled: boolean;
-  onSignIn: () => void;
-  signedInUser?: {
-    name: string;
-    email?: string;
-    avatarUrl?: string;
-  };
-}
-//#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' | 'smartArtLayouts' | 'smartArtAddShape' | 'smartArtAddBullet' | 'smartArtTextPane' | 'smartArtPromote' | 'smartArtDemote' | 'smartArtRightToLeft' | 'smartArtMoveUp' | 'smartArtMoveDown' | 'smartArtResetGraphic' | 'smartArtConvert' | 'themeColors' | 'themeFonts';
-/** One tile. */
-interface RibbonGalleryItem {
-  /** Stable within its gallery; what `applyRibbonGalleryItem` takes. */
-  id: string;
-  /** i18n key of the tile's accessible name / tooltip. */
-  labelKey: string;
-  /** `{{name}}` interpolation values for `labelKey`. */
-  labelParams?: Readonly<Record<string, string | number>>;
-  /** English fallback for bindings whose dictionary lacks `labelKey`. */
-  label: string;
-  /**
-   * A complete, self-contained `<svg>` element (width/height/viewBox set).
-   * Built only from catalogue data and theme colours, never from user text,
-   * so it is safe to inject as markup.
-   */
-  previewSvg: string;
-  /**
-   * CSS `filter` the tile's preview carries (the Picture Adjust galleries),
-   * for a host that draws the thumbnail over a real image instead of
-   * `previewSvg`. Omitted when the preset has no CSS-expressible preview.
-   */
-  previewFilter?: string;
-  /** True when this entry is what the selection currently carries. */
-  applied: boolean;
-}
-/** A titled block of tiles (PowerPoint's "Theme Styles" / "Presets"). */
-interface RibbonGallerySection {
-  id: string;
-  /** i18n key of the section heading; omitted for an untitled section. */
-  titleKey?: string;
-  title?: string;
-  /** Tiles per row in the dropped-down grid. */
-  columns: number;
-  /** Preview tile size in CSS px (the SVG's own width/height). */
-  tileWidth: number;
-  tileHeight: number;
-  items: RibbonGalleryItem[];
-}
-interface RibbonGalleryDescriptor {
-  id: RibbonGalleryId;
-  /** i18n key of the gallery trigger / group caption. */
-  labelKey: string;
-  label: string;
-  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
-/** Unscaled CSS pixels reserved on each side of the ordinary viewer viewport. */
-type ViewportFitPadding = number | {
-  horizontal: number;
-  vertical: number;
-};
-/** Host layout policy, independent of authored slide dimensions and user zoom. */
-interface ViewportFitOptions {
-  /** Per-side padding. Omission keeps the binding's existing decorative allowance. */
-  fitPadding?: ViewportFitPadding;
-  /** Positive fit-factor ceiling; null allows enlargement without a ceiling. */
-  maxFitScale?: number | null;
-}
-type ThemeEditorLabels = Record<string, string>;
-/**
- * Controlled Animations tab state. Hosts own the slide model, selection,
- * history and the inspector; the view only reflects these values.
- */
-interface RibbonAnimationsViewState {
-  /** False in read-only hosts: every authoring intent is rejected. */
-  editable: boolean;
-  /** Whether an element is selected; effects always target one element. */
-  hasSelection: boolean;
-  /** Whether the Animation Pane (inspector) is open; reflected as pressed. */
-  paneOpen?: boolean;
-  /** Transient highlight while a host's Preview is playing, where it tracks one. */
-  previewActive?: boolean;
-  translate?: (key: string) => string;
-}
-//#endregion
-//#region src/render/ribbon-draw-state.d.ts
-type RibbonDrawTool = 'select' | 'pen' | 'highlighter' | 'eraser' | 'freeform';
-interface RibbonDrawViewState {
-  tool: RibbonDrawTool;
-  color: string;
-  width: number;
-  editable: boolean;
-  recentColors?: readonly string[];
-  translate?: (key: string) => string;
-}
-/**
- * Controlled Insert tab state. Native viewers own the selections, every document
- * mutation, the file/shape/SmartArt/equation/hyperlink dialogs and history.
- */
-interface RibbonInsertState {
-  editable: boolean;
-  /** A hyperlink always attaches to something, so Link tracks the selection. */
-  hasSelection: boolean;
-  /** The shape preset staged in the Shape picker. */
-  shapeType: string;
-  /** The chart entry staged in the Chart picker. */
-  chartKind: string;
-  /** The armed Freeform: Shape / Curve tool. */
-  activeFreeformTool?: string | null;
-  /** Visible Freeform tools; empty hides the buttons (host customization). */
-  freeformTools?: readonly string[];
-  /** Hosts without these capabilities hide the control instead of showing a dead one. */
-  chartAvailable?: boolean;
-  fieldAvailable?: boolean;
-  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<RibbonHomeKey, RibbonHomeControlState>>>;
-  translate?: (key: string) => string;
-}
-/** Controlled View tab state. Native viewers own the values and every side effect. */
-interface RibbonViewState {
-  editable: boolean;
-  showRulers: boolean;
-  showGrid: boolean;
-  showGuides: boolean;
-  snapToGrid: boolean;
-  snapToShape: boolean;
-  templateEditing: boolean;
-  selectionPaneOpen?: boolean;
-  eyedropperActive?: boolean;
-  /** Hosts without these capabilities hide the control instead of showing a dead one. */
-  selectionPaneAvailable?: boolean;
-  eyedropperAvailable?: boolean;
-  zoomAvailable?: boolean;
-  translate?: (key: string) => string;
-}
-//#endregion
-//#region src/render/ribbon-transitions-state.d.ts
-type RibbonTransitionsTranslate = (key: string, params?: Record<string, string>) => string;
-/** Controlled Transitions tab state. The host derives it from the ACTIVE slide. */
-interface RibbonTransitionsViewState {
-  draft: RibbonTransitionDraft;
-  /** The slide's transition, used only to list and select the Sound entries. */
-  transition?: PptxSlideTransition;
-  editable: boolean;
-  inspectorOpen?: boolean;
-  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;
-  labels: ThemeEditorLabels;
-  disabled: boolean;
-}
-declare global {
-  interface HTMLElementTagNameMap {
-    'pptx-ui-theme-editor': PptxUiThemeEditorElement;
-  }
-}
-/** 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 PptxUiCompatToastsElement extends HTMLElement {
-  state: CompatToastsViewState;
-}
-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;
-}
-interface PptxUiPasteOptionsElement extends HTMLElement {
-  state: PasteOptionsViewState;
-}
-interface PptxUiReadOnlyBannerElement extends HTMLElement {
-  state: ReadOnlyBannerViewState;
-}
-interface PptxUiContextMenuElement extends HTMLElement {
-  state: ContextMenuViewState;
-}
-declare global {
-  interface HTMLElementTagNameMap {
-    'pptx-ui-compat-toasts': PptxUiCompatToastsElement;
-    'pptx-ui-context-menu': PptxUiContextMenuElement;
-    'pptx-ui-dialog-footer': PptxUiDialogFooterElement;
-    'pptx-ui-paste-options': PptxUiPasteOptionsElement;
-    'pptx-ui-read-only-banner': PptxUiReadOnlyBannerElement;
-  }
-}
-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 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 PptxUiRibbonAnimationsElement extends HTMLElement {
-  state: RibbonAnimationsViewState;
-}
-declare global {
-  interface HTMLElementTagNameMap {
-    'pptx-ui-ribbon-animations': PptxUiRibbonAnimationsElement;
-  }
-}
-interface PptxUiRibbonDrawElement extends HTMLElement {
-  state: RibbonDrawViewState;
-}
-declare global {
-  interface HTMLElementTagNameMap {
-    '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 {
-    'pptx-ui-ribbon-home-clipboard': PptxUiRibbonHomeElement;
-    '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 {
-  state: RibbonTransitionsViewState;
-}
-declare global {
-  interface HTMLElementTagNameMap {
-    'pptx-ui-ribbon-transitions': PptxUiRibbonTransitionsElement;
-  }
-}
-interface PptxUiRibbonInsertElement extends HTMLElement {
-  state: RibbonInsertState;
-  /** Return focus to a control by its public id, e.g. after a native dialog closes. */
-  focusControl(id: string): void;
-}
-declare global {
-  interface HTMLElementTagNameMap {
-    'pptx-ui-ribbon-insert': PptxUiRibbonInsertElement;
-  }
-}
-interface PptxUiRibbonViewElement extends HTMLElement {
-  state: RibbonViewState;
-}
-declare global {
-  interface HTMLElementTagNameMap {
-    'pptx-ui-ribbon-view': PptxUiRibbonViewElement;
-  }
-}
-//#endregion
-//#region src/web-components/ribbon-section.d.ts
-interface PptxUiRibbonSectionElement extends HTMLElement {
-  groups: readonly RibbonGroupView[];
-}
-declare global {
-  interface HTMLElementTagNameMap {
-    'pptx-ui-ribbon-section': PptxUiRibbonSectionElement;
-  }
-}
-//#endregion
-//#region src/web-components/ribbon-gallery.d.ts
-type GalleryTranslate = (key: string, params?: Readonly<Record<string, string | number>>) => string;
-interface PptxUiRibbonGalleryElement extends HTMLElement {
-  readonly trigger: HTMLButtonElement;
-  readonly popup: HTMLElement;
-  descriptor: RibbonGalleryDescriptor | undefined;
-  translateLabel: GalleryTranslate;
-  disabled: boolean;
-  open: boolean;
-  close(): void;
-}
-declare global {
-  interface HTMLElementTagNameMap {
-    'pptx-ui-ribbon-gallery': PptxUiRibbonGalleryElement;
-  }
-}
-//#endregion
-//#region src/web-components/subtitle-settings.d.ts
-interface PptxUiSubtitleSettingsElement extends HTMLElement {
-  settings: SubtitleSettings;
-  labels: SubtitleSettingsLabels;
-  languageDisabled: boolean;
-}
-declare global {
-  interface HTMLElementTagNameMap {
-    '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;
-  }
-}
-//#endregion
-//#region src/web-components/select-value.d.ts
-/**
- * Public DOM shape of `pptx-ui-select`, used by every binding. The element is ooxml-ui's
- * `office-ui-select` under the pptx tag (see `office-aliases.ts`); it is not a native select.
- */
-interface PptxUiSelectElement extends HTMLElement {
-  value: string;
-  disabled: boolean;
-  readonly options: HTMLOptionElement[];
-  selectedIndex: number;
-}
-declare global {
-  interface HTMLElementTagNameMap {
-    'pptx-ui-select': PptxUiSelectElement;
-  }
-}
-
-//#endregion
-//#region src/i18n/locale-catalog.d.ts
-/** One selectable entry in the viewer chrome's built-in language picker (File > Options > Language). */
-interface LocaleCatalogEntry {
-  /** BCP-47-ish locale code, e.g. `'en'`, `'fr'`. Matches `pptx-viewer-locales`' exports. */
-  code: string;
-  /** English display name, used before a translation dictionary for the target locale is loaded. */
-  label: string;
-  /** The locale's own name for itself, e.g. `'Français'` for `fr`. */
-  nativeLabel: string;
-}
+import { LocaleCatalogEntry } from 'ooxml-ui/pptx/i18n';
+import { PptxAnimationPreset, ConnectorArrowType, PptxSlide, PptxElement, XmlObject, PptxElementAnimation, ShapeStyle, PptxSlideTransition, StrokeDashType, PptxNativeAnimation, PptxThemePreset, PptxThemeColorScheme, PptxThemeFontScheme, PptxHandler, PptxData } from 'ooxml-core/pptx';
+import { PptxAiConfig } from 'ooxml-ui/pptx/ai';
+export { PptxAiBridge, PptxAiConfig, PptxAiConnection, PptxAiContextStrategy, PptxAiToolName, PptxAiWritePolicy } from 'ooxml-ui/pptx/ai';
+import * as Y from 'yjs';
+import { Doc } from 'yjs';
 
 //#region src/viewer/types-core.d.ts
 /**
@@ -2530,228 +131,6 @@ interface ShapeQuickStyle {
   style: Partial<ShapeStyle>;
 }
 //#endregion
-//#region ../shared/dist/ai/index.d.ts
-//#endregion
-//#region src/ai/change-animator.d.ts
-/** Host-tunable options for how AI edits are animated on the canvas. */
-interface AiChangeAnimationConfig {
-  /** Master switch. Default true. */
-  enabled?: boolean;
-  /** How long the motion + glow plays, in ms. Default 900. */
-  durationMs?: number;
-  /** Draw the pulsing glow highlight on changed elements. Default true. */
-  glow?: boolean;
-  /** Glide old->new bounds and cross-fade colours. Default true. */
-  tween?: boolean;
-  /** Accent colour (any CSS colour) for the glow/ghosts. Default a blue. */
-  color?: string;
-}
-//#endregion
-//#region src/ai/config.d.ts
-/** The UI message shape exchanged with the assistant. Alias of the SDK type. */
-type PptxAiUIMessage = UIMessage;
-/**
- * Canonical name of every tool the assistant can call. Document tools mirror the
- * `pptx-viewer-mcp` server exactly (they ARE the same functions, run against the
- * live deck); the viewer-only tools (navigation, deck outline, element/notes
- * readers, table merge) have no MCP counterpart.
- */
-type PptxAiToolName = 'get_deck_overview' | 'get_slide' | 'get_element' | 'get_speaker_notes' | 'find_text' | 'get_theme' | 'go_to_slide' | 'select_elements' | 'merge_tables' | 'get_metadata' | 'get_layouts' | 'find_placeholders' | 'get_presentation_properties' | 'run_accessibility_check' | 'convert_to_markdown' | 'export_to_json' | 'add_element' | 'update_element' | 'delete_elements' | 'arrange_elements' | 'clone_element' | 'set_element_animation' | 'group_elements' | 'ungroup_elements' | 'batch_update_elements' | 'update_element_style' | 'replace_geometry' | 'set_element_lock' | 'manage_hyperlinks' | 'replace_text' | 'manage_comments' | 'update_table_cells' | 'manage_table_structure' | 'create_chart' | 'update_chart' | 'add_chart_series' | 'remove_chart_series' | 'update_chart_series_data' | 'manage_smart_art' | 'apply_template' | 'add_slide' | 'duplicate_slide' | 'delete_slides' | 'reorder_slides' | 'update_slide_properties' | 'set_slide_transition' | 'apply_theme_preset' | 'update_theme_colors' | 'update_theme_fonts' | 'set_canvas_size' | 'update_metadata' | 'manage_sections' | 'update_presentation_properties' | 'import_from_json' | 'apply_layout';
-type Resolvable<T> = T | (() => T | Promise<T>);
-/** How the assistant reaches a language model. */
-type PptxAiConnection =
-/**
- * Post messages to a host backend route (recommended for production so the
- * provider API key stays server-side). Maps to `DefaultChatTransport`.
- */
-{
-  kind: 'endpoint';
-  api: string;
-  headers?: Resolvable<Record<string, string>>;
-  body?: Resolvable<Record<string, unknown>>;
-  credentials?: RequestCredentials;
-  fetch?: typeof globalThis.fetch;
-} |
-/**
- * Run a language model in-process in the browser (bring-your-own key /
- * local model). Maps to a `ToolLoopAgent` behind a `DirectChatTransport`.
- */
-{
-  kind: 'model';
-  model: LanguageModel;
-  system?: string;
-  maxSteps?: number;
-} |
-/** Provide a fully-constructed transport (advanced / testing escape hatch). */
-{
-  kind: 'transport';
-  transport: ChatTransport<PptxAiUIMessage>;
-};
-/** How writes proposed by the assistant reach the document. */
-type PptxAiWritePolicy = 'stage' | 'approve' | 'auto';
-/** Which deck context is fed to the model with each turn. */
-type PptxAiContextStrategy = 'outline' | 'current-slide' | 'none';
-/** Optional per-session history persistence hooks. */
-interface PptxAiHistoryHooks {
-  load?(id: string): Promise<PptxAiUIMessage[]>;
-  save?(id: string, messages: PptxAiUIMessage[]): Promise<void>;
-}
-/** Complete host configuration for an AI chat session. */
-interface PptxAiConfig {
-  connection: PptxAiConnection;
-  /** Extra host instructions appended to the base system prompt. */
-  systemPromptExtras?: string;
-  tools?: {
-    /** Allowlist. When set, only these tools are exposed. */
-    enabled?: PptxAiToolName[];
-    /** Denylist, applied after `enabled`. */
-    disabled?: PptxAiToolName[];
-    /** Additional host-defined tools merged into the tool set. */
-    extra?: ToolSet;
-  };
-  /** Default `'stage'`. */
-  writePolicy?: PptxAiWritePolicy;
-  /** Default `'outline'`. */
-  contextStrategy?: PptxAiContextStrategy;
-  history?: PptxAiHistoryHooks;
-  /**
-   * How AI edits are animated on the canvas so the user can watch them land
-   * (glide old->new, fade/scale in-out, glow-pulse). Omit for the defaults;
-   * set `{ enabled: false }` to turn it off.
-   */
-  changeAnimation?: AiChangeAnimationConfig;
-  onError?(error: Error): void;
-}
-//#endregion
-//#region src/ai/bridge.d.ts
-/** Lightweight, model-friendly summary of the whole deck. */
-interface PptxAiDeckMeta {
-  /** Total number of slides. */
-  slideCount: number;
-  /** Zero-based index of the currently active slide. */
-  activeSlideIndex: number;
-  /** Deck title, when known (first slide title / core properties). */
-  title?: string;
-  /** Slide canvas width in CSS pixels. */
-  width: number;
-  /** Slide canvas height in CSS pixels. */
-  height: number;
-}
-/** Severity hint for {@link PptxAiBridge.notify}. */
-type PptxAiNotifyLevel = 'info' | 'success' | 'warning' | 'error';
-/**
- * A target the user has scoped the assistant to: either a whole slide or a
- * single element on a slide. Returned by {@link PptxAiBridge.getFocusedTargets}
- * so the context builder can tell the model exactly what to focus on.
- */
-type PptxAiFocusedTarget = {
-  kind: 'slide';
-  slideIndex: number;
-} | {
-  kind: 'element';
-  slideIndex: number;
-  elementId: string;
-};
-/**
- * A pure updater over the deck's slides. It receives a deep clone of the
- * current slides (mutation-safe) and returns the next slides array. The bridge
- * commits the returned array as ONE history entry.
- */
-type PptxAiSlidesUpdater = (slides: PptxSlide[]) => PptxSlide[];
-/**
- * A pure updater over the whole parsed deck ({@link PptxData}). Mirrors the
- * `pptx-viewer-mcp` tool model (data in, mutated data out) so presentation-level
- * MCP tools (metadata, sections, canvas size, presentation properties, layouts)
- * can be committed as ONE undoable history entry through {@link
- * PptxAiBridge.applyDeckData}. Optional: bindings that only track slide/theme
- * state can omit it, in which case those presentation-level tools report that
- * they are unavailable in this viewer while every slide/theme tool still works.
- */
-type PptxAiDataUpdater = (data: PptxData) => PptxData;
-/** Field-level updates for a single element, mirroring the MCP update vocab. */
-interface PptxAiElementUpdate {
-  x?: number;
-  y?: number;
-  width?: number;
-  height?: number;
-  rotation?: number;
-  opacity?: number;
-  hidden?: boolean;
-  flipHorizontal?: boolean;
-  flipVertical?: boolean;
-  text?: string;
-  fontSize?: number;
-  fontFamily?: string;
-  fontColor?: string;
-  bold?: boolean;
-  italic?: boolean;
-  underline?: boolean;
-  align?: 'left' | 'center' | 'right' | 'justify';
-  fillColor?: string;
-  strokeColor?: string;
-  strokeWidth?: number;
-}
-/**
- * Implemented by each binding to expose its live editor to the AI core.
- *
- * Read methods must be cheap and synchronous. Write methods must route through
- * the binding's editor-history layer so AI edits are undoable like manual ones.
- */
-interface PptxAiBridge {
-  /** Return a summary of the whole deck. */
-  getDeckMeta(): PptxAiDeckMeta;
-  /** Return the deck's slides. Callers must not mutate the returned array. */
-  getSlides(): PptxSlide[];
-  /** Return the zero-based index of the active slide. */
-  getActiveSlideIndex(): number;
-  /** Return the resolved presentation theme, when available. */
-  getTheme(): PptxTheme | undefined;
-  /** Return the underlying core handler, when the binding exposes one. */
-  getHandler(): PptxHandler | undefined;
-  /** Navigate the viewer to a slide by zero-based index. */
-  goToSlide(index: number): void;
-  /** Select the given elements on a slide (empty array clears selection). */
-  selectElements(slideIndex: number, elementIds: string[]): void;
-  /**
-   * Apply a slides updater as a single, atomic, undoable history entry. The
-   * binding is responsible for cloning current slides before calling
-   * `updater` and for installing the result.
-   */
-  applySlidesUpdate(updater: PptxAiSlidesUpdater, label: string): void;
-  /** Apply field updates to one element as a single history entry. */
-  updateElement(slideIndex: number, elementId: string, updates: PptxAiElementUpdate): void;
-  /** Apply partial theme updates as a single history entry. */
-  applyTheme(updates: Partial<PptxTheme>): void;
-  /**
-   * Return the full parsed {@link PptxData} for the open deck, with the live
-   * (edited) slides and theme overlaid. Enables `pptx-viewer-mcp` tools that
-   * read presentation-level state (metadata, sections, layouts, presentation
-   * properties). Optional: when absent, the AI core synthesises a minimal
-   * PptxData from slides + dimensions, which is enough for every slide/theme
-   * tool but not for presentation-level reads.
-   */
-  getDeckData?(): PptxData | undefined;
-  /**
-   * Commit a whole-deck {@link PptxData} mutation as one undoable history entry.
-   * Used to apply presentation-level MCP tool results (metadata, sections,
-   * canvas size, presentation properties, layouts). Optional: when absent,
-   * those tools report they are not supported in this viewer; slide/theme tools
-   * are unaffected (they route through {@link PptxAiBridge.applySlidesUpdate}
-   * and {@link PptxAiBridge.applyTheme}).
-   */
-  applyDeckData?(updater: PptxAiDataUpdater, label: string): void;
-  /**
-   * Return the slides / elements the user has scoped the assistant to, if any.
-   * When present and non-empty, the context builder tells the model to focus on
-   * exactly these targets. Optional so existing bridges satisfy the contract
-   * without change; a bridge that does not implement it behaves as before (no
-   * focus scoping).
-   */
-  getFocusedTargets?(): PptxAiFocusedTarget[];
-  /** Surface a transient message in the host UI (toast / status line). */
-  notify?(message: string, level?: PptxAiNotifyLevel): void;
-}
-//#endregion
 //#region src/viewer/hooks/collaboration/types.d.ts
 /** Connection lifecycle states for the Yjs WebSocket provider. */
 type ConnectionStatus = 'disconnected' | 'connecting' | 'connected' | 'error';
@@ -2955,7 +334,7 @@ interface PowerPointViewerProps extends ViewportFitOptions {
   /** Callback when active slide changes */
   onActiveSlideChange?: (slideIndex: number) => void;
   /** Callback when the viewer mode changes (e.g. edit to present). */
-  onModeChange?: (mode: ViewerMode) => void;
+  onModeChange?: (mode: ooxml_ui_pptx.ViewerMode) => void;
   /** Callback when the zoom level changes. */
   onZoomChange?: (zoom: number) => void;
   /** Callback when element selection changes. */
@@ -3579,5 +958,5 @@ interface CollaborationStatusIndicatorProps {
 }
 declare function CollaborationStatusIndicator({ status, connectedCount, onRetry }: CollaborationStatusIndicatorProps): React__default.ReactElement;
 
-export { CollaborationProvider, CollaborationStatusIndicator, PowerPointViewer, RemoteUserCursors, UserAvatarBar, clearAudienceContent, forgetSessionDeck, getAnimationInitialStyle, getSessionTabId, isAudienceTab, loadAudienceContent, loadSessionDeck, parseAudienceNonce, rememberSessionDeck, restoreSessionDeck, storeAudienceContent, useCollaborativeHistory, useCollaborativeState, usePresenceTracking, useThemeSwitching, useYjsProvider };
-export type { AccessibilityIssue, AnimationPresetOption, CanvasContextMenuState, CanvasSize, CollaborationConfig, CollaborationContextValue, CollaborationRole, CollaborationStatusIndicatorProps, ConnectionStatus, ConnectorArrowOption, ConnectorGeometryOption, ConnectorGeometryType, ConnectorPathGeometry, DragState, DrawingTool, EditorHistorySnapshot, ElementBounds, ElementClipboardPayload, ElementContextMenuAction, ElementContextMenuState, ExternalCollaborationAwareness, ExternalCollaborationSession, ExternalCollaborationSnapshot, FileViewerHandle, MarqueeSelectionState, ParsedTableCell, ParsedTableData, PowerPointViewerHandle, PowerPointViewerProps, PptxAiBridge, PptxAiConfig, PptxAiConnection, PptxAiContextStrategy, PptxAiToolName, PptxAiWritePolicy, PresentationAnimationRuntime, RemoteUserCursorsProps, ResizeHandle, ResizeState, SessionDeck, ShapeAdjustmentDragState, ShapeAdjustmentHandleDescriptor, ShapePreset, ShapeQuickStyle, ShortcutReferenceItem, SlideAlignment, SlideSectionGroup, SlideTransitionOption, StrokeDashOption, SupportedShapeType, TableCellEditorState, ThemeSwitchingResult, ToolbarSection, UseCollaborativeHistoryResult, UseCollaborativeStateInput, UsePresenceTrackingResult, UseThemeSwitchingInput, UserAvatarBarProps, UserPresence, ViewerMode };
+export { CollaborationProvider, CollaborationStatusIndicator, PowerPointViewer, RemoteUserCursors, UserAvatarBar, getAnimationInitialStyle, isAudienceTab, parseAudienceNonce, useCollaborativeHistory, useCollaborativeState, usePresenceTracking, useThemeSwitching, useYjsProvider };
+export type { AccessibilityIssue, AnimationPresetOption, CanvasContextMenuState, CanvasSize, CollaborationContextValue, CollaborationStatusIndicatorProps, ConnectionStatus, ConnectorArrowOption, ConnectorGeometryOption, ConnectorGeometryType, ConnectorPathGeometry, DragState, DrawingTool, EditorHistorySnapshot, ElementBounds, ElementContextMenuAction, ElementContextMenuState, FileViewerHandle, MarqueeSelectionState, ParsedTableCell, ParsedTableData, PowerPointViewerHandle, PowerPointViewerProps, PresentationAnimationRuntime, RemoteUserCursorsProps, ResizeHandle, ResizeState, ShapePreset, ShapeQuickStyle, ShortcutReferenceItem, SlideAlignment, SlideSectionGroup, SlideTransitionOption, StrokeDashOption, SupportedShapeType, TableCellEditorState, ThemeSwitchingResult, ToolbarSection, UseCollaborativeHistoryResult, UseCollaborativeStateInput, UsePresenceTrackingResult, UseThemeSwitchingInput, UserAvatarBarProps, UserPresence };