pptx-react-viewer 4.26.0 → 4.29.0

package/dist/index.d.ts

@@ -1,3486 +1,16 @@
 import * as React$1 from 'react';
 import React$1__default from 'react';
-import { PptxTheme, PptxThemeColorRef, PptxLayoutPreview, PptxTransitionType, PptxSlideTransition, PptxElement, PptxSlide, TextSegment, TextStyle, ImagePptxElement, ShapePptxElement, PptxHandler, PptxData, PptxAnimationPreset, PptxNativeAnimation, InkPptxElement, PptxAction, PptxComment, PptxElementAnimation, ConnectorPptxElement, ParsedTableStyleMap, ShapeStyle, PptxLayoutOption, PptxCustomShow, PptxPresentationProperties } from 'ooxml-core/pptx';
+import * as ooxml_ui_pptx from 'ooxml-ui/pptx';
+import { CollaborationRole, CollaborationConfig, ViewportFitOptions, ViewerFontSource, ViewerTheme, ThemeCatalogEntry, AccountAuthConfig, ToolbarActionId, ViewerCustomization, PowerPointViewerAPI, ViewerCustomizationApi, CollaborationLivePatcher, InlineListReadResult, EditorImagePasteOptions, ViewerMode, RulerUnit, ElementAnimationState, ShapeAdjustmentHandleDescriptor, InlineTextEditSnapshot, ZoomNavigationTarget, FieldSubstitutionContext, EditPointsCommandId, EditPointsElementPatch, FreeformToolKind, ElementClipboardPayload, AnimationApplyGroup, InsertChartKind, ChangeCaseMode, SlideTemplateId, CollaborationShellState } from 'ooxml-ui/pptx';
+export { AVATAR_COLOR_SWATCHES, AccountAuthConfig, BACKSTAGE_CARD_IDS, BACKSTAGE_PAGE_IDS, BackstageCustomization, CANVAS_CONTEXT_MENU_COMMAND_IDS, CollaborationConfig, CollaborationShellState, ContextMenuCustomization, DEFAULT_VIEWER_PROFILE, EDITOR_SHORTCUT_ACTION_IDS, ELEMENT_CONTEXT_MENU_COMMAND_IDS, ElementUpdate, ElementUpdateOptions, ExternalCollaborationAwareness, ExternalCollaborationSession, ExternalCollaborationSnapshot, HostCanvasMenuContext, HostElementMenuContext, HostMenuCommand, KeyboardCustomization, LocalStorageUsageSummary, OPTIONS_PAGE_IDS, OPTIONS_SECTION_IDS, OPTIONS_SETTING_IDS, OptionsCustomization, OptionsPageId, OptionsSectionId, OptionsSettingId, OptionsSettingValues, PPTX_OPEN_ACCEPT, PRESENTATION_OPEN_EXTENSIONS, PowerPointViewerAPI, RIBBON_TAB_IDS, ResolvedCustomization, RibbonCustomization, SLIDE_TEMPLATES, SavedPresentationFormat, ShortcutChord, SlideTemplateId, SlideTemplateSpec, StoredViewerPrefs, THEME_CATALOG, TOOLBAR_BUTTON_IDS, ThemeCatalogEntry, ToolbarActionId, ToolbarButtonId, ToolbarTabId, VIEWER_DIALOG_IDS, VIEWER_EXPORT_FORMAT_IDS, VIEWER_FEATURE_IDS, VIEWER_PANEL_IDS, VIEWER_PREFS_STORAGE_KEY, ViewerCustomization, ViewerCustomizationApi, ViewerDialogId, ViewerExportFormatId, ViewerFeatureId, ViewerMode, ViewerPanelId, ViewerProfile, ViewerTheme, ViewerThemeColors, ViewportFitOptions, ViewportFitPadding, buildSlideTemplateContent, buildSlideTemplateSlide, clearAllLocalViewerData, clearStoredViewerPrefs, createImageElementFromFile, defaultCssVars, defaultRadius, defaultThemeColors, describeCollaborationShellState, getLocalStorageUsageSummary, isLegacyBinaryPresentation, isSupportedPresentationFile, presentationBaseName, readStoredViewerPrefs, resolveProfileInitial, resolveThemeCatalogEntry, saveViewerProfile, savedPresentationFileName, themeToCssVars, vermilionDarkColors, vermilionDarkTheme, vermilionLightColors, vermilionLightTheme, vermilionRadius, writeStoredViewerPrefs } from 'ooxml-ui/pptx';
+import { LocaleCatalogEntry } from 'ooxml-ui/pptx/i18n';
+export { LOCALE_CATALOG, LocaleCatalogEntry } from 'ooxml-ui/pptx/i18n';
+import { PptxAiConfig } from 'ooxml-ui/pptx/ai';
+export { PptxAiBridge, PptxAiConfig, PptxAiConnection, PptxAiContextStrategy, PptxAiToolName, PptxAiWritePolicy } from 'ooxml-ui/pptx/ai';
 import { Doc } from 'yjs';
-import { LanguageModel, ChatTransport, UIMessage, ToolSet } from 'ai';
+import { PptxAnimationPreset, PptxNativeAnimation, PptxSlide, PptxElement, TextStyle, InkPptxElement, ShapePptxElement, PptxAction, PptxComment, PptxElementAnimation, ConnectorPptxElement, ParsedTableStyleMap, PptxTheme, ShapeStyle, PptxLayoutOption, PptxLayoutPreview, PptxCustomShow, PptxSlideTransition, PptxPresentationProperties } from 'ooxml-core/pptx';
 import { Options } from 'html2canvas-pro';
 
-//#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;
-}
-/**
- * Built-in language choices offered by File > Options > Language when a host
- * doesn't supply its own `availableLocales`. Mirrors the locales shipped by
- * the optional `pptx-viewer-locales` package (English needs no dictionary,
- * it's the viewer's own baseline).
- */
-declare const LOCALE_CATALOG: readonly LocaleCatalogEntry[];
-
-//#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/defaults.d.ts
-/**
- * Default dark-theme color values.
- *
- * These correspond to the built-in dark UI of the PowerPoint viewer and
- * use Tailwind's gray palette as the neutral scale with indigo as the
- * primary accent.
- */
-declare const defaultThemeColors: ViewerThemeColors;
-/** Default border-radius. */
-declare const defaultRadius = "0.5rem";
-//#endregion
-//#region src/theme/css-vars.d.ts
-/**
- * Convert a `ViewerTheme` into a flat `Record<string, string>` of CSS
- * custom properties (including the `--` prefix) ready to be spread onto
- * a `style` attribute.
- *
- * Only properties that differ from the built-in defaults are emitted when
- * `omitDefaults` is true (the default).
- */
-declare function themeToCssVars(theme: ViewerTheme | undefined, omitDefaults?: boolean): Record<string, string>;
-/**
- * Build the complete set of CSS custom properties with all defaults.
- * Useful for generating a full fallback stylesheet.
- */
-declare function defaultCssVars(): Record<string, string>;
-//#endregion
-//#region src/theme/presets.d.ts
-/**
- * Built-in "vermilion" theme presets.
- *
- * These mirror the pptx-viewer brand used on the documentation site:
- * a warm paper canvas in light mode, a dimmed presenter room in dark
- * mode, and the vermilion accent in both. Pass one to the viewer's
- * `theme` prop (React/Vue) or `provideViewerTheme` (Angular), or spread
- * the color objects to derive your own variant.
- */
-/** Light "paper" palette: a projection screen in a bright room. */
-declare const vermilionLightColors: ViewerThemeColors;
-/** Dark "presenter" palette: the presenter room with the lights down. */
-declare const vermilionDarkColors: ViewerThemeColors;
-/** Shared border-radius for the vermilion presets (slightly sharper than the default). */
-declare const vermilionRadius = "0.375rem";
-/** Light vermilion theme, ready for the viewer's `theme` prop. */
-declare const vermilionLightTheme: ViewerTheme;
-/** Dark vermilion theme, ready for the viewer's `theme` prop. */
-declare const vermilionDarkTheme: ViewerTheme;
-//#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;
-}
-/**
- * Built-in theme choices offered by File > Options > Appearance when a host
- * doesn't supply its own `availableThemes`. Keep this list short: it's meant
- * as a sensible out-of-the-box picker, not a full theme gallery. Hosts that
- * want more (or fewer) choices pass their own `availableThemes` prop.
- */
-declare const THEME_CATALOG: readonly ThemeCatalogEntry[];
-/** Look up a catalog entry by key, falling back to `undefined` (the built-in default) if not found. */
-declare function resolveThemeCatalogEntry(key: string | undefined, catalog?: readonly ThemeCatalogEntry[]): ViewerTheme | undefined;
-
-//#region src/render/collaboration-presence.d.ts
-/** Connection lifecycle states for the Yjs WebSocket provider. */
-type ConnectionStatus$1 = 'disconnected' | 'connecting' | 'connected' | 'error';
-/**
- * Presence data for a remote collaborator, sanitised from the awareness
- * protocol. Returned by {@link sanitizePresence}; coordinates are in unscaled
- * slide pixels, clamped to the supplied canvas bounds.
- */
-interface SanitizedPresence {
-  clientId: number;
-  userName: string;
-  userAvatar?: string;
-  userColor: string;
-  activeSlideIndex: number;
-  cursorX: number;
-  cursorY: number;
-  lastUpdated: string;
-  selectedElementId?: string;
-  role?: CollaborationRole;
-}
-//#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;
-}
-//#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;
-}
-//#endregion
-//#region src/types.d.ts
-/** Canvas dimensions in pixels. */
-interface CanvasSize$1 {
-  width: number;
-  height: number;
-}
-/** 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/text-run-style.d.ts
-/** A plain CSS style map (keys are CSS properties; binding-agnostic). */
-type RunStyle = Record<string, string | number>;
-/** One script-tagged piece of a run's text, ready for a binding's nested span. */
-interface ScriptFontPiece {
-  text: string;
-  /**
-   * CSS for a nested span wrapping `text`, or `undefined` when this piece
-   * needs no span at all (its script's font equals the run's own, so plain
-   * text renders identically). When present it carries the `fontFamily`
-   * override plus the run's own decoration subset, repeated because
-   * `text-decoration-*` does not inherit into a nested span (see
-   * `nestedTextDecorationStyle`).
-   */
-  style?: RunStyle;
-}
-//#endregion
-//#region src/render/reflection.d.ts
-/**
- * CSS `mask-image`/`-webkit-mask-image` value plus the raw `transform` for a
- * mirrored reflection sibling. Every value is a ready-to-apply CSS string (or
- * `'none'` sentinel avoided - fields are omitted when the browser default
- * already matches), so a binding can spread this directly onto its own style
- * object with no further per-framework logic.
- */
-interface ReflectionWrapperStyle {
-  position: 'absolute';
-  left: string;
-  /** `calc(100% + <dist>px)`: sits `@dist` px below the source element's box. */
-  top: string;
-  width: string;
-  height: string;
-  /** `scale(@sx, @sy)` (the sign of `@sy` IS the mirror) composed with `@kx`/`@ky`/`@rot`. */
-  transform: string;
-  /** Anchor point for the transform above, from `@algn` (default `center top`). */
-  transformOrigin: string;
-  maskImage: string;
-  WebkitMaskImage: string;
-  pointerEvents: 'none';
-}
-//#endregion
-//#region src/render/animation-timeline-build-descriptors.d.ts
-/**
- * `animation-timeline-build-descriptors` - staged-build (`p:bldChart` /
- * `p:bldDgm`) reveal descriptor types, split out of `animation-timeline-types`
- * to keep that module under the file-size limit. Re-exported from
- * `animation-timeline-types` so existing imports are unaffected.
- *
- * @module render/animation-timeline-build-descriptors
- */
-/**
- * Normalized staged-reveal mode for a chart graphic frame, derived from the
- * OOXML `a:bldChart/@bld` (or `p:bldOleChart/@bld`) token:
- *  - `asOne`      the whole chart appears at once (`allAtOnce`).
- *  - `bySeries`   one data series is revealed per stage (`series`).
- *  - `byCategory` one category is revealed per stage (`category`).
- *  - `byElement`  one series/category ELEMENT is revealed per stage
- *                 (`seriesElement` / `categoryElement`).
- */
-type ChartBuildMode = 'asOne' | 'bySeries' | 'byCategory' | 'byElement';
-/**
- * Normalized staged-reveal mode for a SmartArt diagram, derived from the OOXML
- * `a:bldDgm/@bld` or `p:bldDgm/@bld` token:
- *  - `asOne`        the whole diagram appears at once (`whole` / `allAtOnce`).
- *  - `byOne`        one node is revealed per stage (`one`, and the assorted
- *                   `depthBy*` / `breadthBy*` / directional traversals).
- *  - `byLvl`        levels are revealed one element at a time (`lvlOne`).
- *  - `byLvlAtOnce`  a whole level is revealed per stage (`lvlAtOnce`).
- */
-type DiagramBuildMode = 'asOne' | 'byOne' | 'byLvl' | 'byLvlAtOnce';
-/**
- * One authored `p:graphicEl` reveal unit resolved onto a chart, per
- * `TimelineStepGraphicElement`'s "both indices set" case: a single (series,
- * category) cell revealed by a `bldStep="seriesEl"`/`"categoryEl"` effect.
- */
-interface ChartRevealPoint {
-  seriesIdx: number;
-  categoryIdx: number;
-}
-/**
- * Playback-time chart reveal state derived from AUTHORED `p:graphicEl`
- * indices (see `chart-reveal-descriptor`'s `resolveChartRevealDescriptor`),
- * rather than from click-count/time progress. Present on
- * {@link import('./animation-timeline-group').ElementAnimationState.chartReveal}
- * only when every fired chart-build step for the element carried index data;
- * a renderer prefers this over the progress-based `build`/`ElementBuildState`
- * path when present, since it reflects the real authored reveal set (correct
- * even for a reversed-order or gapped chart build), and falls back to `build`
- * when absent.
- */
-interface ChartRevealDescriptor {
-  /**
-   * Whether the chart's background/axes/gridlines/legend should currently be
-   * visible: always `true` when the chart's `animateBackground` is `false`
-   * ("shown throughout"), otherwise `true` from the first revealed stage
-   * onward.
-   */
-  background: boolean;
-  /** Whole series revealed by a `bldStep="series"` effect. */
-  series: ReadonlySet<number>;
-  /** Whole categories revealed by a `bldStep="category"` effect. */
-  categories: ReadonlySet<number>;
-  /** Individual cells revealed by a `bldStep="seriesEl"`/`"categoryEl"` effect. */
-  points: readonly ChartRevealPoint[];
-}
-/**
- * Playback-time SmartArt diagram reveal state derived from AUTHORED
- * `p:graphicEl/p:dgm/@id` indices (see `diagram-reveal-descriptor`'s
- * `resolveDiagramRevealDescriptor`), rather than from click-count/time
- * progress. Present on
- * {@link import('./animation-timeline-group').ElementAnimationState.diagramReveal}
- * only when every fired diagram-build step for the element carried
- * `p:graphicEl` data. A SmartArt renderer prefers this over the
- * progress-based `build` / {@link ElementBuildState} path when present, since
- * it reflects the real authored reveal set (correct even for a
- * reversed-order or by-branch build), and falls back to `build` when absent.
- */
-interface DiagramRevealDescriptor {
-  /**
-   * Whether the diagram's background/connector chrome should currently be
-   * visible: `true` once any node-revealing or background-revealing
-   * (`bldStep="bg"`) step has fired.
-   */
-  background: boolean;
-  /** Data-model point ids (`PptxSmartArtNode.id`) revealed so far. */
-  nodeIds: ReadonlySet<string>;
-}
-/**
- * Playback-time staged-build state surfaced on
- * {@link import('./animation-timeline-group').ElementAnimationState}.
- * `progress` is the 0..1 fraction of the build revealed at the current
- * playback time; a consumer maps it to its own item COUNT (see
- * `revealedStageCount`).
- */
-type ElementBuildState = {
-  kind: 'chart';
-  mode: ChartBuildMode;
-  progress: number;
-} | {
-  kind: 'diagram';
-  mode: DiagramBuildMode;
-  progress: number;
-};
-//#endregion
-//#region src/render/animation-text-style-resolve.d.ts
-/**
- * Framework-neutral text-style override a font-style emphasis effect applies
- * on top of its target's own authored per-run bold/italic/underline/size/
- * colour. Every binding maps this onto its own text container so it OVERRIDES
- * the runs' inline styles (the runs carry explicit inline styles of their
- * own, so plain CSS inheritance cannot reach them).
- */
-interface TextStyleAnimationDescriptor {
-  bold?: boolean;
-  italic?: boolean;
-  underline?: boolean;
-  /** Relative multiplier against each run's own authored font size. */
-  fontScale?: number;
-  color?: string;
-}
-/** Snapshot of a single element's animation state at a point in the timeline. */
-interface ElementAnimationState {
-  /** Whether the element should be visible. */
-  visible: boolean;
-  /** CSS animation shorthand to apply (undefined = no active animation). */
-  cssAnimation: string | undefined;
-  /**
-   * Staged-build reveal state, present only when the active animation builds a
-   * chart or SmartArt diagram in stages (`p:bldChart` / `p:bldDgm`) rather than
-   * revealing the whole element at once. A staged renderer multiplies
-   * `build.progress` (0..1) by its own series / category / level COUNT to
-   * decide how many stages are revealed at the current playback time; see
-   * {@link import('./animation-build').revealedStageCount}. Absent for ordinary
-   * whole-element entrances, so existing renderers are unaffected.
-   */
-  build?: ElementBuildState;
-  /**
-   * Authored-index chart reveal state (see {@link ChartRevealDescriptor}),
-   * present only when every fired chart-build step for this element carried
-   * `p:graphicEl` index data. A chart renderer prefers this over `build` when
-   * present; `chart-build`'s `resolveRevealedChartData` picks between the two.
-   */
-  chartReveal?: {
-    mode: ChartBuildMode;
-    descriptor: ChartRevealDescriptor;
-  };
-  /**
-   * Authored-index SmartArt diagram reveal state (see
-   * {@link DiagramRevealDescriptor}), present only when every fired
-   * diagram-build step for this element carried `p:graphicEl` node-id data.
-   * `diagram-build`'s `resolveRevealedSmartArtNodes` prefers this over `build`
-   * when present.
-   */
-  diagramReveal?: {
-    mode: DiagramBuildMode;
-    descriptor: DiagramRevealDescriptor;
-  };
-  /**
-   * True when an active `p:animClr` color animation targets this shape's fill.
-   * A vector renderer should then paint the fill with `fill: inherit` so the
-   * wrapper-level colour keyframes cascade to the SVG path. Absent/false means
-   * no active fill-colour animation.
-   */
-  animatesFill?: boolean;
-  /**
-   * True when an active `p:animClr` color animation targets this shape's
-   * stroke. A vector renderer should then paint the stroke with
-   * `stroke: inherit`. Absent/false means no active stroke-colour animation.
-   */
-  animatesStroke?: boolean;
-  /**
-   * Active discrete font-style / colour / size override (see
-   * {@link import('./animation-timeline-step').TimelineStep.textStyle}) a
-   * font-style emphasis effect currently applies to this element's text,
-   * OVERRIDING the runs' own inline bold/italic/underline/size/colour.
-   * `animation-playback-engine.ts` writes this on step start and again on
-   * cleanup (held in full when the effect's `p:cTn/@fill` holds its end
-   * state, otherwise reverted); a text renderer maps it onto its run markup
-   * via `buildTextStyleOverrideCss` (`animation-text-style-css.ts`). Absent
-   * means no font-style emphasis effect is currently active on this element.
-   */
-  textStyle?: TextStyleAnimationDescriptor;
-}
-//#endregion
-//#region src/render/motion-path-authoring.d.ts
-/**
- * The bucket a ribbon gallery click targets. Widens the three preset buckets
- * with `motionPath` so a binding's single "apply animation" callback can carry
- * a motion-path preset id too, instead of every binding growing a second
- * callback threaded through the same six components.
- */
-type AnimationApplyGroup = 'entrance' | 'emphasis' | 'exit' | 'motionPath';
-//#endregion
-//#region src/render/slide-templates/slide-template-types.d.ts
-/** Discriminated id for every built-in slide template. */
-type SlideTemplateId = 'title' | 'titleAndContent' | 'sectionHeader' | 'agenda' | 'twoContent' | 'comparison' | 'quote' | 'timeline' | 'keyMetrics' | 'titleOnly' | 'blank' | 'closing';
-/** Catalog entry describing one insertable template for gallery UIs. */
-interface SlideTemplateSpec {
-  /** Stable template identifier. */
-  id: SlideTemplateId;
-  /** i18n key for the display name (e.g. `pptx.slideTemplates.title.name`). */
-  nameKey: string;
-  /** i18n key for the one-line description shown in the gallery. */
-  descriptionKey: string;
-}
-/**
- * Options for building a template's slide content.
- *
- * `scheme` maps theme colour keys (accent1, tx1, bg1, ...) to resolved hex
- * values; pass the loaded deck's `themeColorMap` so inserted slides inherit
- * the deck look. Missing keys fall back to the Office default scheme.
- */
-interface SlideTemplateBuildOptions {
-  /** Target slide width in px (defaults to 1280). */
-  slideWidth?: number;
-  /** Target slide height in px (defaults to 720). */
-  slideHeight?: number;
-  /** Theme colour key to resolved hex map (e.g. `PptxData.themeColorMap`). */
-  scheme?: Record<string, string>;
-  /** Element id factory; index is the element's ordinal within the slide. */
-  idFor?: (index: number) => string;
-  /**
-   * Translator for the placeholder content written onto template slides
-   * (keys under `pptx.slideTemplates.content.*`). Defaults to the canonical
-   * English dictionary so untranslated hosts still get sensible text.
-   */
-  translate?: (key: string) => string;
-}
-/** The buildable content of a template: elements plus slide-level fills. */
-interface SlideTemplateBuildResult {
-  /** Fully positioned elements ready to be placed on a new `PptxSlide`. */
-  elements: PptxElement[];
-  /** Optional slide background colour (resolved hex). */
-  backgroundColor?: string;
-}
-//#endregion
-//#region src/render/slide-templates/slide-template-catalog.d.ts
-/** Ordered gallery catalogue: one entry per built-in slide template. */
-declare const SLIDE_TEMPLATES: readonly SlideTemplateSpec[];
-/**
- * Build the theme-aware content a template inserts.
- *
- * Pass the deck's `themeColorMap` (and canvas size) in `options` so the
- * inserted slide inherits the deck look; colours also carry `a:schemeClr`
- * round-trip nodes so a save re-emits theme references, not literal RGB.
- */
-declare function buildSlideTemplateContent(id: SlideTemplateId, options?: SlideTemplateBuildOptions): SlideTemplateBuildResult;
-/**
- * Build a complete draft `PptxSlide` for a template, ready for a binding's
- * history-integrated insert path. The caller provides identity (`id`) and
- * numbering; elements are fully positioned for the target canvas.
- */
-declare function buildSlideTemplateSlide(templateId: SlideTemplateId, slideId: string, slideNumber: number, options?: SlideTemplateBuildOptions): PptxSlide;
-/** The unit system used for ruler display. */
-type RulerUnit = 'inches' | 'centimetres';
-/** Framework-neutral picture-bullet source, sizing, and accessible fallback. */
-interface PictureBulletMarker {
-  src?: string;
-  sizePx: number;
-  fallbackMarker: string;
-  accessibleLabel: string;
-  imageRelId?: string;
-}
-//#endregion
-//#region src/render/text-east-asian-breaks.d.ts
-/** Which of the two behaviours a paragraph asks for. */
-interface EastAsianBreakOptions {
-  /** `a:pPr/@hangingPunct="1"`. */
-  hangingPunctuation: boolean;
-  /** `a:pPr/@eaLnBrk="0"`: break between any two East Asian characters. */
-  breakAnywhere: boolean;
-}
-//#endregion
-//#region src/render/text-run-meta.d.ts
-/** A run's resolved hyperlink target. */
-interface RunHyperlink {
-  /**
-   * The URL to hand a click handler. For an internal `ppaction://hlinksldjump`
-   * the resolved slide index is appended as a `slideIndex` query parameter, so
-   * the target survives a callback whose only argument is the URL (see
-   * `parsePpactionUrl`, which reads it back off).
-   */
-  url: string;
-  /**
-   * A safe, renderable `href` for a plain `<a>`, or `undefined` when the target
-   * is an internal `ppaction://` action or fails the URL safety check. A
-   * binding with no click handler renders the run as text in that case, which
-   * is what every binding did for every link before this field existed.
-   */
-  href?: string;
-  /** `a:hlinkClick/@tooltip`, for the anchor's `title`. */
-  tooltip?: string;
-  /**
-   * `<a target>` for a real (non-`ppaction://`) hyperlink, from
-   * `a:hlinkClick/@tgtFrame` when authored, else `_blank` (every binding's
-   * pre-existing hardcoded default). Only meaningful alongside {@link href}.
-   */
-  target?: string;
-  /** `<a rel>` paired with {@link target} (see `resolveHyperlinkTargetAttrs`). */
-  rel?: string;
-  /** Resolved target slide for an internal slide jump. */
-  targetSlideIndex?: number;
-  /**
-   * True when the target came from `a:hlinkMouseOver` rather than
-   * `a:hlinkClick`: PowerPoint follows it on hover, not on click, so a binding
-   * that renders a plain anchor should not make it look clickable.
-   */
-  onHover?: boolean;
-}
-/** An inline equation run (`m:oMath`), rendered as MathML rather than text. */
-interface RunEquation {
-  /** The raw OMML node, for `convertOmmlToMathMl`. */
-  xml: Record<string, unknown>;
-  /** Display number for a numbered equation, without its parentheses. */
-  number?: string;
-}
-//#endregion
-//#region src/render/text-run-ruby.d.ts
-/** A run's phonetic guide, ready to render as `<rt>` above the base text. */
-interface RunRuby {
-  /** The annotation itself (`a:ruby/a:rt`), e.g. the furigana reading. */
-  text: string;
-  /** Inline style for the `<rt>` element (size, family, alignment, colour). */
-  style: RunStyle;
-}
-//#endregion
-//#region src/render/text-tab-run-build.d.ts
-/** One tabbed-line piece, ready to spread onto a binding's own span element. */
-interface TabbedRunPiece {
-  text: string;
-  /**
-   * CSS for the span that wraps `text`: inline-block layout, this run's own
-   * decoration repeated, and this piece's own PowerPoint advance-width
-   * correction as `letter-spacing` (see `buildTabbedLine`). The piece is
-   * nested inside the run's own span, and neither property inherits the way a
-   * caller would want: `text-decoration-*` does not inherit into a nested
-   * element at all (an ancestor's underline is drawn *through* its
-   * descendants, but each descendant still computes `none` of its own), so a
-   * caller passes the run's decoration subset (`nestedTextDecorationStyle`) to
-   * have it repeated here; `letter-spacing` DOES inherit, which is exactly why
-   * this piece sets it explicitly rather than only when non-zero - the run's
-   * container span carries its own (wrong, whole-text) correction that would
-   * otherwise leak in.
-   */
-  style: RunStyle;
-  /** CSS for the leader-fill span preceding this piece, or `undefined` when there is no gap to fill. */
-  leaderStyle?: RunStyle;
-  /** Leader glyphs sized to fill `leaderStyle`'s width. Present only alongside `leaderStyle`. */
-  leaderText?: string;
-  /**
-   * `a:rPr/@u="words"` per-word/gap sub-pieces of THIS tab piece's own text
-   * (see `splitWordsForUnderline`), present only when the run's underline is
-   * `words`. A tab-separated piece is otherwise rendered as a single span
-   * (`text` + `style`), which underlines it continuously - correct for a
-   * one-word piece, but wrong for a piece like `"Hello World"` between two tab
-   * stops, which needs a gap under the space. A binding renders one SIBLING
-   * span per entry IN PLACE OF the piece's single `text` span: each entry's
-   * `style` is the piece's own `style` (the same inline-block layout and
-   * advance-width correction, so the line measures exactly as before), with
-   * the underline stripped on a gap entry. They must be siblings, not spans
-   * nested inside the piece span: an ancestor's underline is drawn through
-   * every inline descendant, so a nested gap could not lose it. `text`/`style`
-   * stay the continuous-underline fallback for a binding that does not
-   * render this field.
-   */
-  words?: Array<{
-    text: string;
-    style: RunStyle;
-  }>;
-}
-/** One `\n`-split line of a run's tabbed text. */
-interface TabbedLineRun {
-  pieces: TabbedRunPiece[];
-}
-//#endregion
-//#region src/render/paragraph-types.d.ts
-/** A single rendered run within a paragraph. */
-interface ParagraphRun {
-  text: string;
-  style: RunStyle;
-  /**
-   * The run's hyperlink (`a:hlinkClick` / `a:hlinkMouseOver`), when it has one.
-   * A binding renders the run inside an `<a href>` when {@link RunHyperlink.href}
-   * is set, and routes {@link RunHyperlink.url} to its click handler otherwise
-   * (internal `ppaction://` slide jumps).
-   */
-  hyperlink?: RunHyperlink;
-  /**
-   * An inline equation (`m:oMath`) this run renders INSTEAD of `text`, which is
-   * empty for it. Emitted in the run sequence so the maths lands at its
-   * authored position between the runs around it.
-   */
-  equation?: RunEquation;
-  /**
-   * The run's phonetic guide (`a:ruby`: furigana, pinyin, bopomofo), when it
-   * has one. A binding renders `<ruby>{text}<rt style>{ruby.text}</rt></ruby>`;
-   * a run carrying one is never split per word, so the annotation appears once
-   * over the whole base run.
-   *
-   * Core parsed and saved ruby from the start, but `buildParagraphs` never read
-   * it, so the annotation rendered in React alone.
-   */
-  ruby?: RunRuby;
-  /**
-   * Index of the `textSegments` entry (of the override list when one was
-   * supplied) this run was built from.
-   *
-   * Shared splits one authored run into several per-word runs for PowerPoint's
-   * metric tracking, so this is many-to-one. It is the seam a binding uses to
-   * reach the facts the neutral model does not carry - React's find-match
-   * highlights, per-script font spans, tab stops and ruby all key off the
-   * originating segment - without regrouping the segments itself and drifting
-   * from the grouping here.
-   */
-  segmentIndex?: number;
-  /**
-   * Offset of this run's `text` within its segment's RENDERED text (after field
-   * substitution), so a caller holding per-segment character offsets can map
-   * them onto the split runs.
-   */
-  charStart?: number;
-  /**
-   * Per-script (`a:ea`/`a:cs`/`a:sym`) font-fallback pieces for this run's
-   * text, when a script it contains needs a font distinct from its own. A
-   * binding renders these as nested spans in place of `text` (see
-   * `text-script-fonts.ts`); absent for the common single-font case.
-   */
-  scriptRuns?: ScriptFontPiece[];
-  /**
-   * Measured tab-stop layout for this run's text, present when it contains an
-   * authored `\t` and the paragraph declares explicit tab stops. A binding
-   * renders these lines/pieces in place of `text`, honouring per-stop
-   * alignment and leader glyphs a plain CSS `tab-size` cannot express (see
-   * `text-tab-run-build.ts`). Absent for the common no-tab case.
-   */
-  tabLines?: TabbedLineRun[];
-  /**
-   * `a:rPr/@u="words"` word/gap pieces of a RUBY run's base text, present only
-   * when such a run's underline is `words` (the ordinary per-word split emits
-   * sibling runs instead; a tab piece carries its own `words`). Same shape as
-   * `scriptRuns` and rendered the same way, in place of `text`: a word entry
-   * carries the decoration for its own span, a gap entry is bare text. The
-   * run's own `style` has the underline stripped when this is set (see
-   * `paragraph-run-build.ts`).
-   */
-  underlineWordPieces?: ScriptFontPiece[];
-  /** The advance-carrying space after a hanging `、`/`。` (`text-east-asian-breaks`). */
-  hangingSpace?: true;
-  /**
-   * `a:reflection` mirrored-sibling wrapper style for this run (the text-run
-   * counterpart of a shape/picture's `ComputedEffectStyle.reflection`), or
-   * `undefined` for the common no-reflection case. A binding renders a sibling
-   * node just below the run's own, painted with the same text, positioned and
-   * masked by this style - see `render/reflection.ts`'s
-   * `getTextReflectionWrapperStyle`.
-   */
-  reflection?: ReflectionWrapperStyle;
-}
-/** A rendered paragraph: runs plus resolved bullet + hanging-indent metadata. */
-interface RenderParagraph {
-  runs: ParagraphRun[];
-  /** Bullet glyph / number to render before the runs (or `undefined`). */
-  bulletMarker?: string;
-  /** Picture marker rendered before runs, or fallback metadata when unresolved. */
-  bulletPicture?: PictureBulletMarker;
-  /** Inline style for the bullet marker (font / size / colour). */
-  bulletStyle: RunStyle;
-  /** `margin-left` in px for the whole paragraph (hanging-indent layout). */
-  marginLeftPx?: number;
-  /** `text-indent` in px (first-line / hanging indent). */
-  textIndentPx?: number;
-  /**
-   * Per-paragraph `line-height` from this paragraph's own `a:pPr > a:lnSpc`.
-   * A unitless multiplier for proportional spacing (`a:spcPct`) or a `"<n>pt"`
-   * string for exact spacing (`a:spcPts`). Undefined when the paragraph does
-   * not override spacing (binding keeps the body-level line-height).
-   */
-  lineHeight?: number | string;
-  /** `margin-top` in px from this paragraph's `a:pPr > a:spcBef` (space before). */
-  spaceBeforePx?: number;
-  /** `margin-bottom` in px from this paragraph's `a:pPr > a:spcAft` (space after). */
-  spaceAfterPx?: number;
-  /**
-   * `font-size` in px to set on the paragraph element so its CSS line boxes
-   * are built from its OWN runs rather than the text body's default size.
-   * Undefined when the paragraph already matches the body default.
-   *
-   * See `resolveParagraphStrutFontSize` for why this is needed: without it a
-   * paragraph of small runs inside a larger-defaulting body is laid out on
-   * too-tall lines and overflows its shape.
-   */
-  strutFontSizePx?: number;
-  /**
-   * True when the paragraph has no runs and no bullet: an authored blank line
-   * (`<a:p><a:endParaRPr/></a:p>`).
-   *
-   * PowerPoint gives such a paragraph a full line box, which is how decks
-   * space a heading away from the bullet list under it. A binding must render
-   * something with height for it (a `<br>`), or the gap disappears and the
-   * block reads as one dense run of text (issue #131, slides 13-14).
-   */
-  isEmpty?: boolean;
-  /**
-   * Indices of this paragraph's segments in the rendered segment list (the
-   * override list when one was supplied), in authored order and INCLUDING the
-   * bullet-marker segment the runs drop.
-   *
-   * The seam a binding uses to reach paragraph facts the neutral model does not
-   * carry, without regrouping the segments itself and drifting from the
-   * grouping here - which is exactly how React ended up splitting on every
-   * `"\n"` and treating a soft `a:br` as a paragraph break.
-   */
-  segmentIndices: number[];
-  /**
-   * True when this paragraph resolves right-to-left (`a:pPr/@rtl`, or the text
-   * body's default). A binding that mirrors its hanging indent for RTL reads
-   * this; the direction itself is already in {@link paragraphStyle}.
-   */
-  rtl?: boolean;
-  /**
-   * Extra CSS for the paragraph box, beyond the margin / indent / spacing
-   * fields above: this paragraph's own `text-align` (`a:pPr/@algn`), its BiDi
-   * `direction`, and the kinsoku line-breaking rules (`@eaLnBrk`,
-   * `@latinLnBrk`, `@hangingPunct`). Absent when the paragraph overrides none
-   * of them, which is the common case.
-   *
-   * All three used to be resolved in React's private paragraph renderer only,
-   * so a deck that centred one paragraph of a left-aligned body, or set CJK
-   * break rules, rendered differently in the other four bindings.
-   */
-  paragraphStyle?: RunStyle;
-  /**
-   * `@hangingPunct` / `@eaLnBrk="0"` as resolved for this paragraph. The runs
-   * above already carry their pieces; React, which rebuilds each segment's
-   * pieces inside one span, re-applies `splitEastAsianBreaks` from this.
-   */
-  eastAsianBreaks?: EastAsianBreakOptions;
-}
-//#endregion
-//#region src/render/inline-list-types.d.ts
-/** Current editor payload. Missing segments explicitly denotes plain-text fallback. */
-interface InlineTextEditSnapshot {
-  elementId: string;
-  text: string;
-  textSegments?: TextSegment[];
-}
-type InlineListReadResult = {
-  kind: 'supported';
-  snapshot: InlineTextEditSnapshot;
-  paragraphs: RenderParagraph[];
-} | {
-  kind: 'unsupported';
-  reason: string;
-  text: string;
-};
-//#endregion
-//#region src/render/text-field-substitution.d.ts
-/**
- * Text-field placeholder substitution, shared by every binding's text
- * renderer.
- *
- * Pure string logic: resolves OOXML field runs (slide number, date/time,
- * header/footer, document properties, slide title) into their display text.
- * Extracted from the React `viewer/utils/text-field-substitution` module so
- * every binding substitutes identically. The locale-aware datetime engine
- * lives in `text-field-datetime.ts`.
- */
-/** Context for substituting field placeholders (slide number, date/time, header/footer, etc.). */
-interface FieldSubstitutionContext {
-  slideNumber?: number;
-  dateTimeText?: string;
-  /**
-   * The deck's master date-field default TYPE (`a:fld/@type` on the slide
-   * master's `dt` placeholder, e.g. "datetime2"; see `header-footer-parts.ts`).
-   * This is a field TYPE, not a format pattern, and is used ONLY as a
-   * fallback for a field authored with the generic, unnumbered `datetime`
-   * type - a field that already names its own `datetime1`-`datetime13` type
-   * always uses that type, never this one (see `substituteFieldText`).
-   */
-  dateFormat?: string;
-  /** Footer text from PptxHeaderFooter settings. */
-  footerText?: string;
-  /** Header text from PptxHeaderFooter settings. */
-  headerText?: string;
-  /** Custom document properties for `docproperty` field substitution (keyed by property name). */
-  customProperties?: ReadonlyArray<{
-    name: string;
-    value: string;
-  }>;
-  /** Locale string for date/time formatting (e.g. "en-US"). Falls back to browser default. */
-  locale?: string;
-  /** Title text extracted from the first title placeholder on the slide. */
-  slideTitle?: string;
-}
-//#endregion
-//#region src/render/text-case-transform.d.ts
-type ChangeCaseMode = 'sentence' | 'lower' | 'upper' | 'capitalize' | 'toggle';
-//#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[];
-}
-interface CollaborationShellState {
-  canEdit: boolean;
-  status: ConnectionStatus$1;
-  remoteUsers: readonly SanitizedPresence[];
-  connectedCount: number;
-}
-type CollaborationShellTranslate = (key: string, params?: Record<string, string | number>) => string;
-/**
- * One-line, localised status for a custom shell's `role="status"` readout.
- *
- * Every binding's custom-shell demo renders this same string under the same
- * `Collaboration status` label, so the framework-neutral e2e helper that
- * waits for the shell to become editable (`waitForHostEditing`) reads every
- * binding the same way. Three of five demos once phrased it differently and
- * the helper silently skipped them; on vanilla, that let a peer double-click
- * before its edit gate opened.
- */
-declare function describeCollaborationShellState(state: Pick<CollaborationShellState, 'canEdit' | 'status' | 'connectedCount'>, translate: CollaborationShellTranslate): string;
-//#endregion
-//#region src/render/collaboration-text-codec.d.ts
-/**
- * collaboration-text-codec.ts: TextSegment[] <-> Y.Text delta codec used by the
- * collaboration sync layer. Split out of collaboration-sync.ts to keep both
- * modules focused.
- *
- * Exports:
- *  - DeltaOp / YTextLike: structural Yjs text interfaces (no yjs import)
- *  - encodeTextBody: write TextSegment[] into a live YTextLike
- *  - encodeSegmentsToDelta: pure simulation of the delta Y.Text would produce
- *  - decodeDelta / decodeTextBody: delta -> TextSegment[]
- *  - isYTextLike: runtime guard
- */
-interface DeltaOp {
-  insert?: unknown;
-  attributes?: Record<string, unknown>;
-}
-interface YTextLike {
-  insert: (index: number, text: string, attrs?: Record<string, string>) => void;
-  toDelta: () => DeltaOp[];
-  toString: () => string;
-}
-//#endregion
-//#region src/render/collaboration-text-merge.d.ts
-/** Y.Text surface needed for in-place edits (delete/format on top of insert). */
-interface YTextEditableLike extends YTextLike {
-  delete: (index: number, length: number) => void;
-  format: (index: number, length: number, attributes: Record<string, string | null>) => void;
-}
-//#endregion
-//#region src/render/collaboration-text-positions.d.ts
-interface TextPositionCell {
-  index: number;
-  left?: TextPositionCell;
-  right?: TextPositionCell;
-}
-interface TrackedTextPosition {
-  /** Internal identity, shared by snapshots that observed the same character. */
-  readonly cell: TextPositionCell;
-  readonly association: number;
-}
-//#endregion
-//#region src/render/collaboration-text-session-delta.d.ts
-/** Browser edit range mapped to the editor's pre-input encoded coordinates. */
-interface LocalTextReplacement {
-  from: number;
-  to: number;
-}
-/** Desired UTF-16 units mapped to the editor's previously observed identities. */
-interface TextSessionCorrespondence {
-  readonly retainedIndices: readonly (number | null)[];
-  /** Old carriers for known paragraph attributes, independently of character identity. */
-  readonly paragraphSources?: readonly (number | null)[];
-}
-type LocalTextEdit = LocalTextReplacement | TextSessionCorrespondence;
-//#endregion
-//#region src/render/collaboration-text-session.d.ts
-/** Supplied by the binding's existing Yjs runtime, bound to this exact Y.Text. */
-interface TextSessionPositions<Position> {
-  capture: (index: number, association: number) => Position;
-  resolve: (position: Position) => number | null;
-  /** Synchronize tracked positions once per batch, including in-transaction writes. */
-  refresh?: () => boolean | void;
-  /** Release only resources created for this session. */
-  dispose?: () => void;
-}
-/** Opaque acknowledgement identity for an exact remote snapshot painted by an adapter. */
-interface CollaborationTextSnapshot {
-  readonly delta: readonly DeltaOp[];
-}
-interface CollaborationTextSession {
-  applyLocalDelta: (delta: readonly DeltaOp[], edit?: LocalTextEdit) => boolean;
-  readMerged: () => CollaborationTextSnapshot | undefined;
-  adoptMerged: (snapshot: CollaborationTextSnapshot) => boolean;
-  /** Capture an offset in the last painted/local draft, not the newer remote string. */
-  bookmark: (index: number, association: number) => () => number | null;
-  dispose: () => void;
-}
-//#endregion
-//#region src/render/collaboration-sync.d.ts
-interface YMapLike {
-  get: (key: string) => unknown;
-  set: (key: string, value: unknown) => void;
-  delete: (key: string) => void;
-  forEach: (cb: (value: unknown, key: string) => void) => void;
-}
-/** Shape of the Yjs transaction passed to (deep) observers. */
-interface YTransactionLike {
-  origin?: unknown;
-}
-type YDeepObserver = (events?: unknown, transaction?: YTransactionLike) => void;
-interface YArrayLike {
-  readonly length: number;
-  get: (index: number) => unknown;
-  push: (items: unknown[]) => void;
-  delete: (index: number, length?: number) => void;
-  insert: (index: number, items: unknown[]) => void;
-  toArray: () => unknown[];
-  observe: (handler: () => void) => void;
-  unobserve: (handler: () => void) => void;
-  observeDeep: (handler: YDeepObserver) => void;
-  unobserveDeep: (handler: YDeepObserver) => void;
-}
-interface YDocLike {
-  getMap: (name: string) => YMapLike;
-  getArray: (name: string) => YArrayLike;
-  transact: (fn: () => void, origin?: unknown) => void;
-}
-interface YjsFactories {
-  createMap: () => YMapLike;
-  createArray: () => YArrayLike;
-  createText: () => YTextLike;
-  /** Track character identities using the binding's existing Yjs runtime. */
-  createTextPositions?: (text: YTextEditableLike) => TextSessionPositions<TrackedTextPosition>;
-}
-//#endregion
-//#region src/render/collaboration-live-patch-target.d.ts
-/** Interim geometry for an element mid-gesture. All fields optional. */
-interface LiveGeometryPatch {
-  x?: number;
-  y?: number;
-  width?: number;
-  height?: number;
-  rotation?: number;
-}
-/** The element's pre-edit rich text, used to remap the interim plain text. */
-interface LiveTextSource {
-  textSegments?: TextSegment[];
-  textStyle?: TextStyle;
-}
-//#endregion
-//#region src/render/collaboration-text-target.d.ts
-interface CollaborationInlineSnapshot extends CollaborationTextSnapshot {
-  readonly inline: InlineTextEditSnapshot;
-}
-/** A mounted editor owns this handle, never the document or its provider. */
-interface CollaborationTextTarget extends CollaborationTextSession {
-  readMerged: () => CollaborationInlineSnapshot | undefined;
-  /** A bookmark follows character identity rather than a mutable numeric offset. */
-  bookmark: (index: number, association: number) => () => number | null;
-}
-interface CollaborationLivePatcher {
-  /** Bind a mounted native editor; its handle must be disposed on unmount. */
-  beginTextEdit?: (slideId: string | undefined, elementId: string, onChange?: () => void, ownsModel?: (element: PptxElement) => boolean) => CollaborationTextTarget | undefined;
-  /** Attach a live doc (or `null` to go dormant). Pending patches are dropped. */
-  configure: (doc: YDocLike | null, factories: YjsFactories | null,
-  /** Publish synchronously when the host may revoke write readiness at any time. */
-  immediate?: boolean) => void;
-  /** True when a doc + factories are attached, i.e. patches will be written. */
-  isActive: () => boolean;
-  /** Queue interim geometry for an element. */
-  patchGeometry: (slideId: string | undefined, elementId: string, geometry: LiveGeometryPatch) => void;
-  /** Queue interim text for an element (remapped over `source`'s segments). */
-  patchText: (slideId: string | undefined, elementId: string, text: string, source?: LiveTextSource) => void;
-  /** Write everything queued right now (call on gesture end / edit commit). */
-  flush: () => void;
-  /** Drop pending work, cancel timers and detach the doc. */
-  dispose: () => void;
-}
-/** 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;
-type StoredViewerOptions = { [G in ViewerOptionsGroupId]?: Partial<ViewerOptions[G]>; };
-//#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-catalog.d.ts
-declare const RIBBON_TAB_IDS: readonly ToolbarTabId[];
-declare const TOOLBAR_BUTTON_IDS: readonly ["share", "broadcast", "export", "undo", "redo", "record", "notes", "fullscreen", "zoom", "navigation", "mergeShapes", "crop"];
-declare const OPTIONS_PAGE_IDS: readonly OptionsPageId[];
-declare const OPTIONS_SECTION_IDS: readonly OptionsSectionId[];
-declare const OPTIONS_SETTING_IDS: readonly OptionsSettingId[];
-declare const BACKSTAGE_PAGE_IDS: readonly BackstagePage[];
-declare const BACKSTAGE_CARD_IDS: readonly BackstageCardId[];
-declare const ELEMENT_CONTEXT_MENU_COMMAND_IDS: readonly ["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", "merge-union", "merge-combine", "merge-fragment", "merge-intersect", "merge-subtract", "save-as-picture", "edit-alt-text", "size-and-position", "format-shape", "delete"];
-declare const CANVAS_CONTEXT_MENU_COMMAND_IDS: readonly ["paste", "layout", "reset-slide", "format-background", "grid-and-guides", "ruler"];
-declare const EDITOR_SHORTCUT_ACTION_IDS: readonly ["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"];
-declare const VIEWER_PANEL_IDS: readonly ["statusBar", "slidesPane", "inspector", "notes", "quickAccessToolbar", "titleBar"];
-declare const VIEWER_FEATURE_IDS: readonly ["ai", "collaboration", "comments", "presentMode", "editPoints"];
-declare const VIEWER_DIALOG_IDS: readonly ["options", "share", "broadcast", "print", "export"];
-declare const VIEWER_EXPORT_FORMAT_IDS: readonly ["pdf", "png", "video", "gif", "json", "copyImage"];
-//#endregion
-//#region src/render/customization/customization-keymap.d.ts
-/** A parsed `Mod+Shift+D` chord. */
-interface ParsedShortcutChord {
-  key: string;
-  mod: boolean;
-  ctrl: boolean;
-  meta: boolean;
-  alt: boolean;
-  shift: boolean;
-}
-/** The normalised keyboard slice of a resolved customisation. */
-interface ResolvedKeyboardCustomization {
-  disableAll: boolean;
-  disabled: ReadonlySet<EditorKeyActionName>;
-  remap: ReadonlyMap<EditorKeyActionName, readonly ParsedShortcutChord[]>;
-}
-//#endregion
-//#region src/render/customization/customization-resolve.d.ts
-/** The normalised, set-based view of a customisation. Treat as immutable. */
-interface ResolvedCustomization {
-  hiddenActions: ReadonlySet<ToolbarActionId>;
-  /** Contextual tabs (`shapeFormat`, ...) the host never wants shown. */
-  hiddenContextualTabs: ReadonlySet<RibbonContextualTabId>;
-  /** Catalogued ribbon groups to hide (`ribbon.hiddenGroups`). */
-  hiddenRibbonGroups: ReadonlySet<RibbonGroupId>;
-  /** Catalogued ribbon controls to hide (the `<tab>.<group>.<control>` part of `ribbon.hiddenButtons`). */
-  hiddenRibbonControls: ReadonlySet<RibbonControlId>;
-  hiddenOptionsPages: ReadonlySet<OptionsPageId>;
-  hiddenOptionsSections: ReadonlySet<OptionsSectionId>;
-  hiddenSettings: ReadonlySet<OptionsSettingId>;
-  lockedSettings: OptionsSettingValues;
-  defaultSettings: OptionsSettingValues;
-  hiddenBackstagePages: ReadonlySet<BackstagePage>;
-  hiddenBackstageCards: ReadonlySet<BackstageCardId>;
-  hiddenElementCommands: ReadonlySet<ContextMenuCommandId>;
-  extraElementCommands: NonNullable<ViewerCustomization['contextMenu']>['extraElementCommands'];
-  extraCanvasCommands: NonNullable<ViewerCustomization['contextMenu']>['extraCanvasCommands'];
-  hiddenCanvasCommands: ReadonlySet<CanvasContextMenuCommandId>;
-  hiddenEditPointsCommands: ReadonlySet<EditPointsCommandId>;
-  hiddenDrawingTools: ReadonlySet<ViewerDrawingToolId>;
-  elementMenuEnabled: boolean;
-  canvasMenuEnabled: boolean;
-  hiddenPanels: ReadonlySet<ViewerPanelId>;
-  disabledFeatures: ReadonlySet<ViewerFeatureId>;
-  hiddenDialogs: ReadonlySet<ViewerDialogId>;
-  keyboard: ResolvedKeyboardCustomization;
-}
-//#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/presentation-file-kinds.d.ts
-/**
- * presentation-file-kinds: the one place that answers "can the viewer open
- * this file?" and "what should the saved copy be called?".
- *
- * ## Why this is a shared decision and not five allow-lists
- *
- * The loader reads more formats than any single UI advertises. Legacy binary
- * `.ppt` (PowerPoint 97-2003) is the sharp example: `PptxHandler.load()` has
- * detected the OLE compound-file container and converted the binary deck
- * through the regular pptx pipeline for some time, but the product kept saying
- * it was unsupported, and a picker that filters the extension out makes a
- * working loader unreachable in practice. Whenever the loader learns a format,
- * exactly one list has to change.
- *
- * ## Read many, write several
- *
- * Input is a superset of output. We READ `.pptx`, `.ppsx`, `.pptm`, `.potx`,
- * legacy binary `.ppt` and portable `pptx-viewer-json`; we WRITE the OpenXML
- * family plus legacy binary `.ppt` (via `ooxml-core/src/pptx/core/ppt/writer/`,
- * a real MS-PPT/OLE2 encoder, not a stub). `savedPresentationFileName`
- * REPLACES the source extension with the extension of the format actually
- * being written rather than keeping the source's: a deck opened as
- * `report.pptx` and saved back as `.ppt` (or vice versa) must have its name
- * agree with its bytes, which is the kind of mismatch PowerPoint itself
- * refuses to open.
- *
- * This module deliberately imports nothing, so any layer (render, export, a
- * binding, a host app) can depend on it without risking an import cycle.
- *
- * @module render/presentation-file-kinds
- */
-/**
- * Extensions the built-in file picker offers, in the order it offers them.
- *
- * `.ppt` is in the list because the loader genuinely handles it, not as a
- * courtesy: see `ooxml-core/src/pptx/core/ppt/` and the `ppt-import` integration
- * suite, which asserts a `.ppt` loads to the same model as the `.pptx` it was
- * exported from.
- */
-declare const PRESENTATION_OPEN_EXTENSIONS: readonly ['.pptx', '.ppsx', '.pptm', '.potx', '.ppt', '.json'];
-/** Comma-separated `accept` attribute for a presentation file input. */
-declare const PPTX_OPEN_ACCEPT: string;
-/**
- * True when a picked / dropped file's name looks like something the loader can
- * open. Use this instead of a hand-rolled `endsWith` chain: a drop handler that
- * disagrees with the picker's `accept` list is a format that is supported by
- * mouse but not by drag, which is how `.ppt` stayed invisible.
- *
- * Extension-only, by design. The real answer comes from the container sniff in
- * `PptxHandler.load()`; this is only the cheap pre-filter a drop target needs
- * before it hands bytes to the loader.
- */
-declare function isSupportedPresentationFile(name: string | null | undefined): boolean;
-/**
- * True for the binary PowerPoint 97-2003 family. `.ppt` itself is now also a
- * SAVE target (see {@link SavedPresentationFormat}); `.pps`/`.pot` (97-2003
- * show/template) remain read-only siblings sharing the same record format.
- */
-declare function isLegacyBinaryPresentation(name: string | null | undefined): boolean;
-/** The formats the save path can produce. */
-type SavedPresentationFormat = 'pptx' | 'ppsx' | 'pptm' | 'ppt';
-/**
- * The stem of a presentation file name: directories and any loadable extension
- * removed. `C:\decks\report.ppt` becomes `report`; a name with no recognised
- * extension is kept whole, so `Untitled Presentation` survives intact rather
- * than losing everything after its last dot.
- */
-declare function presentationBaseName(sourceName: string | null | undefined, fallback?: string): string;
-/**
- * The name a saved copy should be offered under: the source stem plus the
- * extension of the format actually being written.
- *
- * This is what turns `report.ppt` into `report.pptx` on a regular Save As,
- * and `report.pptx` into `report.ppt` when the user explicitly picks the
- * PowerPoint 97-2003 format. Keeping the source extension would mislabel the
- * bytes either way.
- */
-declare function savedPresentationFileName(sourceName: string | null | undefined, format?: SavedPresentationFormat): string;
-//#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[];
-}
-//#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;
-}
-//#endregion
-//#region src/render/insert-chart.d.ts
-/**
- * Dropdown ids for the insert-chart menu. Distinct from `PptxChartType`
- * because PowerPoint offers Column (vertical) and Bar (horizontal) as two
- * entries over the same underlying `'bar'` chart type, and because `'pareto'`
- * has no `PptxChartType` of its own: it is a dropdown entry that resolves to
- * `type: 'histogram'` (see docs/guide/limitations.md's ChartEx row) with a
- * frequency-plus-cumulative-percentage default shape. The other six ChartEx
- * ids (`histogram` through `regionMap`) map one-to-one onto their chart type.
- */
-type InsertChartKind = 'column' | 'bar' | 'line' | 'pie' | 'doughnut' | 'area' | 'scatter' | 'histogram' | 'pareto' | 'funnel' | 'treemap' | 'sunburst' | 'boxWhisker' | 'regionMap';
-/** In-memory clipboard payload stored when an element is copied or cut. */
-interface ElementClipboardPayload {
-  element: PptxElement;
-  isTemplate: boolean;
-}
-//#endregion
-//#region src/render/image-file-insertion.d.ts
-/**
- * Decode a local image File/Blob into a centred element, fitting the slide
- * without upscaling. Dimensions are slide pixels; image bytes are preserved.
- *
- * Resolves null for unsupported/unreadable images, invalid bounds, cancellation,
- * or unavailable browser APIs. Importing this module is safe outside a browser.
- * No slide, selection, history, clipboard, or network state is changed. The
- * caller must still validate its document/slide destination before committing.
- */
-declare function createImageElementFromFile(file: Blob, canvasSize: CanvasSize$1, signal?: AbortSignal): Promise<ImagePptxElement | null>;
-//#endregion
-//#region src/render/editor-image-paste.d.ts
-/** A currently editable slide. Return null while loading or outside canvas editing. */
-interface EditorImagePasteTarget {
-  documentId: object;
-  slideId: string;
-  canvasSize: CanvasSize$1;
-}
-interface EditorImagePasteOptions {
-  getCanvas(): HTMLElement | null;
-  getTarget(): EditorImagePasteTarget | null;
-  /** Use the normal editor command so selection, dirty state and Undo stay consistent. */
-  insertElement(element: ImagePptxElement): void;
-}
-/** 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/zoom-return-navigation.d.ts
-/**
- * The navigation-relevant fields of a Zoom click target, independent of
- * `zoomType`.
- *
- * `returnToParent` is already resolved to its EFFECTIVE value here (not the
- * raw, possibly-`undefined` `ZoomPptxElement`/`SummaryZoomTarget` field):
- * `CT_ZoomObjectProperties/@returnToParent` (MS-PPTX) is `<xsd:attribute
- * name="returnToParent" type="xsd:boolean" use="optional" default="true"/>`,
- * so an ABSENT attribute means true, not false. Core deliberately stores
- * `undefined` rather than fabricating `true` (so a round-trip never invents
- * an attribute the source never had), which makes `Boolean(x)` the wrong way
- * to read it; the two `resolve*NavigationTarget` functions below are the only
- * place that distinction should be made.
- */
-interface ZoomNavigationTarget {
-  targetSlideIndex: number;
-  targetSectionId?: string;
-  returnToParent: boolean;
-  transitionDurationMs?: number;
-}
-//#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;
-}
-//#endregion
-//#region src/render/account.d.ts
-/** Local-only display profile shown in File > Account. Never sent anywhere; purely cosmetic. */
-interface ViewerProfile {
-  displayName: string;
-  /** CSS color for the avatar bubble background, e.g. `'#c2431f'`. */
-  avatarColor: string;
-  /** Single character shown in the avatar bubble. Derived from `displayName` when omitted. */
-  initial?: string;
-}
-declare const DEFAULT_VIEWER_PROFILE: ViewerProfile;
-/** Suggested avatar color swatches for the Account profile editor. */
-declare const AVATAR_COLOR_SWATCHES: readonly string[];
-/** Derive the avatar-bubble initial from a profile, falling back to `'?'` for an empty name. */
-declare function resolveProfileInitial(profile: ViewerProfile): 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;
-  };
-}
-interface LocalStorageUsageSummary {
-  /** Number of presentations with a local autosave/recovery snapshot. */
-  presentationCount: number;
-  /** Total bytes across every stored snapshot. */
-  totalBytes: number;
-}
-/** Summarize local (IndexedDB) storage usage for the Account > Storage & Privacy panel. */
-declare function getLocalStorageUsageSummary(): Promise<LocalStorageUsageSummary>;
-/**
- * Delete every locally stored presentation/recovery snapshot and persisted
- * viewer preference (theme/locale/profile). Irreversible; callers should
- * confirm with the user before invoking this.
- */
-declare function clearAllLocalViewerData(): Promise<void>;
-/** Persist an updated profile via the shared viewer-prefs store. */
-declare function saveViewerProfile(profile: ViewerProfile): void;
-//#endregion
-//#region src/render/viewer-prefs-storage.d.ts
-/**
- * `localStorage`-backed viewer chrome preferences (theme/locale/profile),
- * shared by every binding.
- *
- * This is the persistence layer behind File > Options' Appearance/Language
- * tabs and File > Account's profile editor when a host doesn't supply its
- * own `onThemeChange`/`onLocaleChange`/`onProfileChange` callbacks - i.e. the
- * "standalone" fallback path. Hosts that do wire those callbacks own
- * persistence themselves and this module is never touched.
- */
-declare const VIEWER_PREFS_STORAGE_KEY = "pptx-viewer-prefs";
-interface StoredViewerPrefs {
-  /** Key into the shared `THEME_CATALOG` (or a host-supplied `availableThemes` catalog). */
-  themeKey?: string;
-  /** Locale code, e.g. `'fr'`. */
-  localeCode?: string;
-  /** Local-only display profile shown in File > Account. */
-  profile?: ViewerProfile;
-  /** Sparse File > Options diff against `DEFAULT_VIEWER_OPTIONS`. */
-  options?: StoredViewerOptions;
-}
-/** Read all persisted viewer preferences. Returns `{}` when unavailable, unset, or corrupt. */
-declare function readStoredViewerPrefs(): StoredViewerPrefs;
-/** Merge `patch` into the persisted viewer preferences. Silently no-ops when storage is unavailable. */
-declare function writeStoredViewerPrefs(patch: Partial<StoredViewerPrefs>): void;
-/** Remove all persisted viewer preferences. Silently no-ops when storage is unavailable. */
-declare function clearStoredViewerPrefs(): void;
-//#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;
-}
-/** The element fields an Edit Points commit writes. */
-type EditPointsElementPatch = Pick<ShapePptxElement, 'x' | 'y' | 'width' | 'height' | 'shapeType' | 'shapeAdjustments' | 'pathData' | 'pathWidth' | 'pathHeight' | 'customGeometryPaths' | 'customGeometryRawData' | 'customGeometryAdjustHandlesXY' | 'customGeometryAdjustHandlesPolar' | 'customGeometryConnectionSites' | 'customGeometryTextRect'>;
-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;
-  }
-}
-
 //#region src/viewer/types-core.d.ts
 /**
  * Union of all shape preset types that the viewer can insert or render.
@@ -3516,228 +46,6 @@ declare function ViewerThemeProvider({ theme, children }: ViewerThemeProviderPro
  */
 declare function useViewerTheme(): ViewerTheme | undefined;
 //#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';
@@ -3848,7 +156,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. */
@@ -4069,6 +377,23 @@ interface PowerPointViewerProps extends ViewportFitOptions {
    * back to the flat SVG pie3D renderer. Default `false`.
    */
   pieChart3D?: boolean;
+  /**
+   * Zero-based slide shown after each load, clamped into the deck. Default
+   * `0`. Changing it later does not move the current slide; it applies to
+   * the next load.
+   */
+  initialSlide?: number;
+  /**
+   * Show the editor chrome: title bar, ribbon and toolbar, protected-view
+   * and read-only banners, the mobile toolbar and the status bar. Default
+   * `true`; `false` leaves the canvas (and the thumbnail pane, if shown).
+   */
+  showToolbar?: boolean;
+  /**
+   * Show the slide thumbnail pane. Default `true`. The pane still follows
+   * the user's own collapse toggle and the `slidesPane` customisation panel.
+   */
+  showThumbnails?: boolean;
   /**
    * Hide individual toolbar buttons and/or ribbon tabs instead of the whole
    * toolbar. Accepts any mix of button ids (`share`, `broadcast`, `export`,
@@ -4697,5 +1022,5 @@ declare function SlideTemplatePreview({ templateId, scheme }: SlideTemplatePrevi
  */
 declare function renderToCanvas(element: HTMLElement, options?: Partial<Options>): Promise<HTMLCanvasElement>;
 
-export { AVATAR_COLOR_SWATCHES, BACKSTAGE_CARD_IDS, BACKSTAGE_PAGE_IDS, CANVAS_CONTEXT_MENU_COMMAND_IDS, DEFAULT_VIEWER_PROFILE, EDITOR_SHORTCUT_ACTION_IDS, ELEMENT_CONTEXT_MENU_COMMAND_IDS, LOCALE_CATALOG, OPTIONS_PAGE_IDS, OPTIONS_SECTION_IDS, OPTIONS_SETTING_IDS, PPTX_OPEN_ACCEPT, PRESENTATION_OPEN_EXTENSIONS, PowerPointViewer, RIBBON_TAB_IDS, SLIDE_TEMPLATES, SlideCanvas, SlideTemplateGalleryDialog, SlideTemplatePreview, THEME_CATALOG, TOOLBAR_BUTTON_IDS, Toolbar, VIEWER_DIALOG_IDS, VIEWER_EXPORT_FORMAT_IDS, VIEWER_FEATURE_IDS, VIEWER_PANEL_IDS, VIEWER_PREFS_STORAGE_KEY, ViewerThemeProvider, buildSlideTemplateContent, buildSlideTemplateSlide, clearAllLocalViewerData, clearStoredViewerPrefs, createImageElementFromFile, defaultCssVars, defaultRadius, defaultThemeColors, describeCollaborationShellState, getAnimationInitialStyle, getLocalStorageUsageSummary, isLegacyBinaryPresentation, isSupportedPresentationFile, presentationBaseName, readStoredViewerPrefs, renderToCanvas, resolveProfileInitial, resolveThemeCatalogEntry, saveViewerProfile, savedPresentationFileName, themeToCssVars, useViewerBuildingBlocks, useViewerTheme, vermilionDarkColors, vermilionDarkTheme, vermilionLightColors, vermilionLightTheme, vermilionRadius, writeStoredViewerPrefs };
-export type { AccountAuthConfig, BackstageCustomization, CollaborationConfig, CollaborationContextValue, CollaborationShellState, ContextMenuCustomization, ElementUpdate, ElementUpdateOptions, ExternalCollaborationAwareness, ExternalCollaborationSession, ExternalCollaborationSnapshot, HostCanvasMenuContext, HostElementMenuContext, HostMenuCommand, KeyboardCustomization, LocalStorageUsageSummary, LocaleCatalogEntry, OptionsCustomization, OptionsPageId, OptionsSectionId, OptionsSettingId, OptionsSettingValues, PowerPointViewerAPI, PowerPointViewerHandle, PowerPointViewerProps, PptxAiBridge, PptxAiConfig, PptxAiConnection, PptxAiContextStrategy, PptxAiToolName, PptxAiWritePolicy, ResolvedCustomization, RibbonCustomization, SavedPresentationFormat, ShortcutChord, SlideCanvasProps, SlideTemplateGalleryDialogProps, SlideTemplateId, SlideTemplatePreviewProps, SlideTemplateSpec, StoredViewerPrefs, ThemeCatalogEntry, ToolbarActionId, ToolbarButtonId, ToolbarProps, ToolbarTabId, UseViewerBuildingBlocksInput, ViewerBuildingBlocksResult, ViewerCustomization, ViewerCustomizationApi, ViewerDialogId, ViewerExportFormatId, ViewerFeatureId, ViewerMode, ViewerPanelId, ViewerProfile, ViewerTheme, ViewerThemeColors, ViewportFitOptions, ViewportFitPadding };
+export { PowerPointViewer, SlideCanvas, SlideTemplateGalleryDialog, SlideTemplatePreview, Toolbar, ViewerThemeProvider, getAnimationInitialStyle, renderToCanvas, useViewerBuildingBlocks, useViewerTheme };
+export type { CollaborationContextValue, PowerPointViewerHandle, PowerPointViewerProps, SlideCanvasProps, SlideTemplateGalleryDialogProps, SlideTemplatePreviewProps, ToolbarProps, UseViewerBuildingBlocksInput, ViewerBuildingBlocksResult };