pptx-vanilla-viewer 3.25.0 → 3.27.0

package/dist/index.d.ts

@@ -1,57 +1,9 @@
-import { $ as InlineTextSelection, $n as ViewerThemeColors, $r as PptxTableCellStyle, $t as StrokeToInkElementOpts, An as forgetSessionDeck, Ar as PptxCommentMention, B as ExternalCollaborationAwareness, Bn as parsePresentationSessionId, Br as PptxHeaderFooter, Bt as RunProgramNotice, C as CompatibilityWarningToast, Cn as ViewportFitPadding, Cr as PptxAnimationTimelineAnchor, Ct as PresentationSnapshot, D as CropElementUpdate, Dn as canInteractWithElement, Dr as PptxChartData, Dt as ReadOnlyRecommendation, E as ContextMenuCustomization, En as buildInlineTextCommitPatch, Er as PptxAppProperties, Et as RIBBON_TAB_IDS, F as EditorKeyActionName, Fn as isLegacyBinaryPresentation, Fr as PptxData, Ft as RibbonGalleryApplyResult, G as GradientState, Gr as PptxNotesMaster, Gt as SessionDeck, H as ExternalCollaborationSnapshot, Hn as rememberSessionDeck, Hr as PptxLayoutPreview, I as ElementAnimationState, In as isSupportedPresentationFile, Ir as PptxElement, It as RibbonGalleryContext, J as HostElementMenuContext, Jr as PptxSlide, Jt as ShortcutChord, K as Guide, Kr as PptxPresentationProperties, Kt as ShapePresetType, L as ElementClipboardPayload, Ln as loadPresentationDeck, Lr as PptxElementAnimation, Lt as RibbonGroupId, Mr as PptxCoreProperties, Mt as RibbonContextualTabId, N as EDITOR_SHORTCUT_ACTION_IDS, Nn as getSessionTabId, Nr as PptxCustomProperty, Nt as RibbonControlId, O as CropSession, On as createImageElementFromFile, Or as PptxComment, Ot as RemoteCursor, P as ELEMENT_CONTEXT_MENU_COMMAND_IDS, Pr as PptxCustomShow, Pt as RibbonCustomization, Q as InlineTextEditSnapshot, Qn as ViewerTheme, Qr as PptxSmartArtNodeStyle, R as ElementUpdate, Rn as loadSessionDeck, Rr as PptxEmbeddedFont, Rt as RibbonTransitionDraft, S as CollaborationTransport, Sn as ViewportFitOptions, Sr as PptxAnimationSequence, St as PresentationPointerTool, T as ContextMenuCommandId, Tn as ZoomNavigationTarget, Tr as PptxAnimationTrigger, U as FieldSubstitutionContext, Ur as PptxModernCommentAuthor, Ut as SanitizedPresence, V as ExternalCollaborationSession, Vn as presentationBaseName, Vr as PptxImageEffects, W as FreeformToolKind, Wr as PptxModifyVerifier, Wt as SavedPresentationFormat, Xn as savedPresentationFileName, Xr as PptxSlideTransition, Xt as SlideSizeRescaleMode, Y as HostMenuCommand, Yn as restoreSessionDeck, Yr as PptxSlideMaster, Yt as SlideSizeEmu, Z as InlineListReadResult, Zn as ThemeCatalogEntry, Zr as PptxSmartArtData, Zt as SlideTemplateId, _ as CollabLoadOrigin, _i as PptxThemeColorRef, _n as ViewerMode, _r as ParsedTableStyleMap, _t as PPTX_OPEN_ACCEPT, a as AutosaveRecord, ai as PptxThemeFontScheme, an as ToolbarTabId, ar as vermilionLightTheme, at as ModifyPasswordCheckResult, b as CollaborationRole, bn as ViewerPanelId, br as PptxAnimationPreset, bt as PowerPointViewerAPI, c as BackstageCardId, ci as PptxViewProperties, cn as VIEWER_FEATURE_IDS, cr as PptxHandler, ct as OPTIONS_SETTING_IDS, d as CANVAS_CONTEXT_MENU_COMMAND_IDS, di as SmartArtLayout, dn as ViewerCustomizationApi, dr as SvgExportOptions, dt as OptionsSectionId, ei as PptxTableData, en as TOOLBAR_BUTTON_IDS, er as defaultCssVars, et as InsertChartKind, fi as SmartArtLayoutType, fn as ViewerCustomizationController, fr as ElementAction, ft as OptionsSettingId, g as ChartPartRef, gi as XmlObject, gn as ViewerFontSource, gr as OlePptxElement, h as ChangeCaseMode, hi as TextStyle, hn as ViewerFeatureId, hr as OleObjectType, i as AnimationGroup, ii as PptxThemeColorScheme, in as ToolbarButtonId, ir as vermilionDarkTheme, it as MobileSheetKey, jr as PptxCompatibilityWarning, k as CssStyleMap, kn as describeCollaborationShellState, kr as PptxCommentAuthor, kt as ResolvedCustomization, l as BackstageCustomization, li as ShapeStyle, ln as VIEWER_PANEL_IDS, lr as PptxHandlerSaveOptions, lt as OptionsCustomization, m as CanvasSize, mi as TextSegment, mn as ViewerExportFormatId, mr as MediaPptxElement, ni as PptxTextStyleLevels, nn as TextAdvancedChanges, nr as defaultThemeColors, nt as MasterViewCrudAction, o as BACKSTAGE_CARD_IDS, oi as PptxThemeOption, on as VIEWER_DIALOG_IDS, or as AccessibilityIssue, ot as OPTIONS_PAGE_IDS, p as CanvasContextMenuCommandId, pi as TablePptxElement, pn as ViewerDialogId, pr as MasterViewTab, pt as OptionsSettingValues, q as HostCanvasMenuContext, qr as PptxSection, qt as ShareDefaults, r as AccountAuthConfig, ri as PptxTheme, rn as ToolbarActionId, rr as themeToCssVars, rt as MasterViewCrudActionId, s as BACKSTAGE_PAGE_IDS, si as PptxTransitionType, sn as VIEWER_EXPORT_FORMAT_IDS, sr as MergeShapeOperation, st as OPTIONS_SECTION_IDS, ti as PptxTagCollection, tr as defaultRadius, tt as KeyboardCustomization, u as BackstagePage, ui as SmartArtColorScheme, un as ViewerCustomization, ur as PptxSaveFormat, ut as OptionsPageId, v as CollaborationConfig, vn as ViewerOptionPrimitive, vr as PptxAfterAnimationAction, vt as PRESENTATION_OPEN_EXTENSIONS, w as ConnectionStatus, wr as PptxAnimationTimingCurve, wt as PrintSettings, x as CollaborationShellState, xn as ViewerQuickAccessOptions, xr as PptxAnimationRepeatMode, xt as PresentationBlackout, y as CollaborationLivePatcher, yn as ViewerOptionsStore, yr as PptxAnimationDirection, yt as PasteSpecialFormat, z as ElementUpdateOptions, zn as overlayInlineTextSnapshot, zr as PptxHandoutMaster, zt as RulerUnit } from "./transition-overlay-D7asQvRY.js";
-import { ChatTransport, LanguageModel, ToolSet, UIMessage } from "ai";
-import "pptx-viewer-mcp";
+import { $ as PptxThemeOption, A as PptxCustomShow, B as PptxModifyVerifier, C as PptxAppProperties, D as PptxCommentMention, E as PptxCommentAuthor, F as PptxHandoutMaster, G as PptxSlideMaster, H as PptxPresentationProperties, I as PptxHeaderFooter, J as PptxTableData, K as PptxSlideTransition, L as PptxImageEffects, M as PptxElement, N as PptxElementAnimation, O as PptxCoreProperties, P as PptxEmbeddedFont, Q as PptxThemeFontScheme, R as PptxLayoutPreview, S as PptxAnimationTrigger, T as PptxComment, U as PptxSection, V as PptxNotesMaster, W as PptxSlide, X as PptxTextStyleLevels, Y as PptxTagCollection, Z as PptxThemeColorScheme, _ as PptxAnimationPreset, a as PptxHandler, at as PptxSmartArtNodeStyle, b as PptxAnimationTimelineAnchor, c as SvgExportOptions, ct as SmartArtLayoutType, d as MediaPptxElement, dt as XmlObject, et as PptxTransitionType, f as OleObjectType, ft as PptxThemeColorRef, g as PptxAnimationDirection, h as PptxAfterAnimationAction, i as MergeShapeOperation, it as PptxSmartArtData, j as PptxData, k as PptxCustomProperty, l as ElementAction, lt as TextSegment, m as ParsedTableStyleMap, nt as ShapeStyle, o as PptxHandlerSaveOptions, ot as SmartArtColorScheme, p as OlePptxElement, q as PptxTableCellStyle, r as AccessibilityIssue, rt as TablePptxElement, s as PptxSaveFormat, st as SmartArtLayout, tt as PptxViewProperties, u as MasterViewTab, ut as TextStyle, v as PptxAnimationRepeatMode, w as PptxChartData, x as PptxAnimationTimingCurve, y as PptxAnimationSequence, z as PptxModernCommentAuthor } from "./transition-overlay-CxqDHlcC.js";
+import { AccountAuthConfig, AccountAuthConfig as AccountAuthConfig$1, AlignEdge, AnimationGroup, AutosaveActivation, AutosaveRecord, AutosaveRecord as AutosaveRecord$1, AutosaveRecoveryOffer, BACKSTAGE_CARD_IDS, BACKSTAGE_PAGE_IDS, BackstageCardId, BackstageCustomization, BackstagePage, CANVAS_CONTEXT_MENU_COMMAND_IDS, CanvasContextMenuCommandId, CanvasSize, ChangeCaseMode, ChartPartRef, CollabLoadOrigin, CollabLoadOrigin as CollabLoadOrigin$1, CollaborationConfig, CollaborationConfig as CollaborationConfig$1, CollaborationLivePatcher, CollaborationLivePatcher as CollaborationLivePatcher$1, CollaborationRole, CollaborationShellState, CollaborationShellState as CollaborationShellState$1, CollaborationTransport, CompatibilityWarningToast, ConnectionStatus, ConnectionStatus as ConnectionStatus$1, ContextMenuCommandId, ContextMenuCustomization, ContextMenuTableContext, CropElementUpdate, CropSession, DeckSaveIntent, EDITOR_SHORTCUT_ACTION_IDS, ELEMENT_CONTEXT_MENU_COMMAND_IDS, EditorKeyActionName, ElementAnimationState, ElementClipboardPayload, ElementUpdate, ElementUpdate as ElementUpdate$1, ElementUpdateOptions, ElementUpdateOptions as ElementUpdateOptions$1, ExternalCollaborationAwareness, ExternalCollaborationSession, ExternalCollaborationSnapshot, FreeformToolKind, GradientState, Guide, HostCanvasMenuContext, HostElementMenuContext, HostMenuCommand, InlineListReadResult, InlineListReadResult as InlineListReadResult$1, InlineTextEditSnapshot, InlineTextEditSnapshot as InlineTextEditSnapshot$1, InlineTextSelection, InlineTextSelection as InlineTextSelection$1, InsertChartKind, KeyboardCustomization, MasterViewCrudAction, MasterViewCrudActionId, MobileSheetKey, ModifyPasswordCheckResult, OPTIONS_PAGE_IDS, OPTIONS_SECTION_IDS, OPTIONS_SETTING_IDS, OptionsCustomization, OptionsPageId, OptionsPageId as OptionsPageId$1, OptionsSectionId, OptionsSectionId as OptionsSectionId$1, OptionsSettingId, OptionsSettingId as OptionsSettingId$1, OptionsSettingValues, PPTX_OPEN_ACCEPT, PRESENTATION_OPEN_EXTENSIONS, PasteSpecialFormat, PowerPointViewerAPI, PresentationBlackout, PresentationPointerTool, PresentationSnapshot, PrintSettings, RIBBON_TAB_IDS, RasterizeElementResult, RasterizeElementTilesResult, ReadOnlyRecommendation, RemoteCursor, RemoteCursor as RemoteCursor$1, ResolvedCustomization, ResolvedCustomization as ResolvedCustomization$1, RibbonContextualTabId, RibbonControlId, RibbonCustomization, RibbonGalleryApplyResult, RibbonGalleryContext, RibbonGroupId, RibbonTransitionDraft, RulerUnit, RunProgramNotice, SanitizedPresence, SanitizedPresence as SanitizedPresence$1, SavedPresentationFormat, SessionDeck, ShapePresetType, ShareDefaults, ShortcutChord, ShortcutChord as ShortcutChord$1, SlideSizeEmu, SlideSizeRescaleMode, SlideTemplateId, StrokeToInkElementOpts, TOOLBAR_BUTTON_IDS, TextAdvancedChanges, ThemeCatalogEntry, ThemeColorPickerCommit, ToolbarActionId, ToolbarActionId as ToolbarActionId$1, ToolbarButtonId, ToolbarTabId, VIEWER_DIALOG_IDS, VIEWER_EXPORT_FORMAT_IDS, VIEWER_FEATURE_IDS, VIEWER_PANEL_IDS, ViewerCustomization, ViewerCustomization as ViewerCustomization$1, ViewerCustomizationApi, ViewerCustomizationApi as ViewerCustomizationApi$1, ViewerCustomizationController, ViewerDialogId, ViewerDialogId as ViewerDialogId$1, ViewerExportFormatId, ViewerFeatureId, ViewerFeatureId as ViewerFeatureId$1, ViewerFontSource, ViewerMode, ViewerOptionPrimitive, ViewerOptionsStore, ViewerPanelId, ViewerPanelId as ViewerPanelId$1, ViewerQuickAccessOptions, ViewerTheme, ViewerTheme as ViewerTheme$1, ViewerThemeColors, ViewportFitOptions, ViewportFitOptions as ViewportFitOptions$1, ViewportFitPadding, ZoomNavigationTarget, buildInlineTextCommitPatch, canInteractWithElement, createImageElementFromFile, defaultCssVars, defaultRadius, defaultThemeColors, describeCollaborationShellState, forgetSessionDeck, getSessionTabId, isLegacyBinaryPresentation, isSupportedPresentationFile, loadPresentationDeck, loadSessionDeck, overlayInlineTextSnapshot, parsePresentationSessionId, presentationBaseName, rememberSessionDeck, restoreSessionDeck, savedPresentationFileName, themeToCssVars, vermilionDarkTheme, vermilionLightTheme } from "ooxml-ui/pptx";
+import { LocaleCatalogEntry, TranslationKey, TranslationMessages, Translator, createTranslator, keyToLabel, translationsEn } from "ooxml-ui/pptx/i18n";
+import { LoadPresentationOptions, LoadedPresentation, loadPresentation, revokeBlobUrls } from "ooxml-ui/pptx/dom";
+import { PptxAiBridge, PptxAiConfig, PptxAiConfig as PptxAiConfig$1, PptxAiConnection, PptxAiContextStrategy, PptxAiToolName, PptxAiWritePolicy } from "ooxml-ui/pptx/ai";
 import { Options } from "html2canvas-pro";
-//#region ../../../../src/core/dist/geometry/align-distribute.d.ts
-/**
- * Pure geometry helpers for the align / distribute editor operations.
- *
- * These functions operate over a list of slide elements (anything carrying the
- * `{ id, x, y, width, height }` bounding-box fields of {@link PptxElement}) and
- * return a `Map` keyed by element `id` describing the *new* position(s) for the
- * elements that need to move. Elements that already sit on the target edge (or
- * the two outer-most elements during distribution) are still included with
- * their unchanged coordinate so callers can apply the whole map uniformly; the
- * map only ever contains the axis that the operation touches.
- *
- * The reference box the selection is aligned against is either the union of
- * the selected boxes (PowerPoint's "Align Selected Objects") or the slide
- * itself ("Align to Slide"). PowerPoint defaults to the slide whenever a
- * single object is selected, which is why a one-element selection is not a
- * no-op once a `slideSize` is supplied: Align Center on a lone title is one
- * of the commonest arrange gestures there is.
- *
- * The helpers are deliberately framework-agnostic: no DOM, no Vue reactivity,
- * no side effects. The host wires them into the editor by feeding the current
- * selection in and applying the returned `Map` via its element-transform
- * operation (one batched history entry per call).
- */
-/** Edge / centre that {@link alignElements} can snap a selection to. */
-type AlignEdge = 'left' | 'centerH' | 'right' | 'top' | 'middle' | 'bottom';
-//#endregion
-//#region src/viewer/i18n/translator.d.ts
-/**
- * Minimal i18n for the vanilla binding.
- *
- * The other bindings delegate to their framework's i18n runtime (react-i18next,
- * vue-i18n, ngx-translate) fed by the shared `pptx.*` dictionary. The vanilla
- * binding has no framework, so this module provides the one missing piece: a
- * `t(key, params)` lookup with `{{param}}` interpolation over the same shared
- * English dictionary, plus per-locale overrides supplied by the host.
- *
- * Resolution order: host dictionary for the active locale, then the built-in
- * English dictionary, then a humanised fallback derived from the key (shared
- * `keyToLabel`), so a missing key never renders as a raw `pptx.*` string.
- */
-/** Translate a dotted `pptx.*` key with optional `{{param}}` interpolation. */
-type Translator = (key: string, params?: Record<string, string | number>) => string;
-/** Locale to flat `key: message` dictionary map supplied by the host. */
-type TranslationMessages = Record<string, Record<string, string>>;
-/**
- * Build a {@link Translator} for a locale. `messages[locale]` (when provided)
- * wins over the built-in English dictionary; English is always the fallback.
- */
-export declare function createTranslator(locale?: string, messages?: TranslationMessages): Translator;
 //#endregion
 //#region src/viewer/state/store.d.ts
 /**
@@ -73,347 +25,7 @@ interface Store<T extends object> {
   subscribe(listener: StoreListener<T>): () => void;
 }
 export declare function createStore<T extends object>(initial: T): Store<T>;
-//#endregion
-//#region src/viewer/render/types.d.ts
-/** Discriminant values of the {@link PptxElement} union (`'text'`, `'chart'`, ...). */
-type PptxElementType = PptxElement['type'];
-/**
- * A selected chart sub-part, scoped to the chart element that owns it. The
- * vanilla counterpart of React's `ChartPartSelectionContext` / Vue's
- * `ChartPartSelection` / Angular's `ChartPartSelectionService`: the bridge
- * between an on-canvas mark click (`chart-editable.ts`) and the chart
- * inspector (`chart-data-grid.ts` / `chart-point-index.ts`), threaded through
- * the store rather than component context since vanilla has no such
- * injection mechanism.
- */
-interface ChartPartSelection {
-  elementId: string;
-  part: ChartPartRef;
-}
-/**
- * Everything an element renderer may need, passed to every renderer call.
- *
- * The context is immutable per slide render. Renderers must create DOM through
- * `context.document` (never the global `document`) so slides can render into
- * detached documents (tests, export pipelines).
- */
-interface ElementRenderContext {
-  /** Document used for all DOM creation. */
-  readonly document: Document;
-  /** The slide being rendered. */
-  readonly slide: PptxSlide;
-  /** Full deck, used by Zoom elements to resolve their target preview. */
-  readonly slides?: readonly PptxSlide[];
-  /** Zero-based active slide index for Zoom return navigation. */
-  readonly currentSlideIndex?: number;
-  /** Presentation-only Zoom tile activation callback. */
-  readonly onZoomClick?: (target: ZoomNavigationTarget, returnSlideIndex: number) => void;
-  /** Full slide canvas size in CSS px (elements are positioned in this space). */
-  readonly canvasSize: CanvasSize;
-  /**
-   * The scale the stage is rendered at (1 = 100%). The stage applies it via a
-   * CSS transform, so renderers should lay out in unscaled canvas px; `scale`
-   * is informational (e.g. for raster density decisions).
-   */
-  readonly scale: number;
-  /** Archive-path to displayable URL map for media + poster frames. */
-  readonly mediaDataUrls: ReadonlyMap<string, string>;
-  /** Presentation theme colour scheme used by theme-aware render helpers. */
-  readonly colorScheme?: PptxThemeColorScheme;
-  /**
-   * Presentation theme font scheme, so table styles resolve their
-   * `a:fontRef@idx` (`minor`/`major`) to a concrete font family.
-   */
-  readonly fontScheme?: PptxThemeFontScheme;
-  /** Parsed `ppt/tableStyles.xml` definitions used by table band/header styling. */
-  readonly tableStyleMap?: ParsedTableStyleMap;
-  readonly fieldContext?: FieldSubstitutionContext;
-  /** Shared-dictionary translator (`pptx.*` keys). */
-  readonly t: Translator;
-  /**
-   * Opt-in flag: render `smartArt` elements as an extruded Three.js scene
-   * instead of flat SVG (see `PptxViewerOptions.smartArt3D`). Defaults to
-   * `false` when the option is unset.
-   */
-  readonly smartArt3D: boolean;
-  /**
-   * Opt-in flag: render `surface`/`surface3D` charts as an interactive,
-   * Three.js mesh instead of the static SVG isometric
-   * projection (see `PptxViewerOptions.surfaceChart3D`). Defaults to `false`
-   * when the option is unset.
-   */
-  readonly surfaceChart3D: boolean;
-  /**
-   * Opt-in flag: render `bar3D` charts as an interactive Three.js box-mesh scene instead of the flat SVG oblique-projection
-   * illusion (see `PptxViewerOptions.barChart3D`). Defaults to `false` when
-   * the option is unset.
-   */
-  readonly barChart3D: boolean;
-  /**
-   * Opt-in flag: render `line3D` charts as an interactive Three.js tube-path scene instead of the flat SVG oblique-projection
-   * illusion (see `PptxViewerOptions.lineChart3D`). Defaults to `false` when
-   * the option is unset.
-   */
-  readonly lineChart3D: boolean;
-  /**
-   * Opt-in flag: render `area3D` charts as an interactive Three.js tube-path + ribbon-fill scene instead of the flat SVG
-   * oblique-projection illusion (see `PptxViewerOptions.areaChart3D`).
-   * Defaults to `false` when the option is unset.
-   */
-  readonly areaChart3D: boolean;
-  /**
-   * Opt-in flag: render `pie3D` charts as an interactive Three.js wedge-mesh scene instead of the flat SVG oblique-projection
-   * illusion (see `PptxViewerOptions.pieChart3D`). Defaults to `false` when
-   * the option is unset.
-   */
-  readonly pieChart3D: boolean;
-  /**
-   * True only for the live presentation stage (real Fullscreen API active):
-   * media renderers use this to autoplay once mounted, matching PowerPoint's
-   * slideshow behaviour. `false` for the editor canvas and thumbnail rail.
-   */
-  readonly presenting: boolean;
-  /**
-   * True only for the surface the user is authoring on. `false` for every
-   * still of a slide (thumbnail rail, presenter console panes, export raster)
-   * AND for the live show stage, which is driven, not edited.
-   *
-   * Media reads it: a stage that is neither interactive nor presenting is a
-   * still, and a still never carries the browser's native transport (see the
-   * shared `mediaTransportVisible`). Optional so the many hand-built contexts
-   * in tests keep compiling; the stage always sets it.
-   */
-  readonly interactive?: boolean;
-  readonly onSmartArtNodeTextChange?: (element: PptxElement, nodeId: string, text: string) => void;
-  readonly onSmartArtNodeFillChange?: (element: PptxElement, nodeId: string, fill: string) => void;
-  /**
-   * Commit a table's whole column-width array after a column-boundary drag.
-   * Called once on pointer release (the drag itself only translates the
-   * boundary handle), so one drag is one undo step. Absent on every
-   * non-authoring surface, matching `onSmartArtNodeTextChange`.
-   */
-  readonly onTableResizeColumns?: (element: PptxElement, widths: number[]) => void;
-  /** Commit one row's new pixel height after a row-boundary drag. */
-  readonly onTableResizeRow?: (element: PptxElement, rowIndex: number, height: number) => void;
-  /**
-   * Commit a chart data point dragged on the canvas, with the whole updated
-   * `chartData`. Called ONCE on pointer release (the drag itself is a local
-   * preview), so one drag is one undo step. Absent on every non-authoring
-   * surface, which is what keeps thumbnails and the show stage inert.
-   */
-  readonly onChartPointChange?: (element: PptxElement, chartData: PptxChartData) => void;
-  /**
-   * The current on-canvas chart part selection (shared with the inspector via
-   * the store), or `null`/absent when nothing is selected. Read by
-   * `chart-editable.ts` to seed its highlight on (re)mount, so the ring stays
-   * on the clicked mark across a stage rebuild triggered by an unrelated edit.
-   */
-  readonly chartPartSelection?: ChartPartSelection | null;
-  /**
-   * A chart part (bar / dot / slice / series line) was pressed on the canvas.
-   * Surfaces the selection to the chart inspector (ring-highlight + scroll in
-   * `chart-data-grid.ts`, point sync in `chart-point-index.ts`). Absent on
-   * every non-authoring surface, matching `onChartPointChange`.
-   */
-  readonly onChartPartSelect?: (element: PptxElement, part: ChartPartRef) => void;
-  /**
-   * Ids of the currently selected elements (the store's `selectedElementIds`).
-   * A chart renderer arms its on-canvas mark hit-testing
-   * (`chart-editable.ts`'s `CHART_INTERACTIVE_CLASS`) only while ITS OWN id is
-   * in this set: an unselected chart must let a mark click bubble up and
-   * select the chart like any other element, exactly as a bare click on any
-   * other element type does. Absent on every non-authoring surface, matching
-   * `onChartPointChange`.
-   */
-  readonly selectedElementIds?: ReadonlySet<string>;
-  /**
-   * Per-element native-animation playback state, keyed by element id, present
-   * only during a running presentation. Chart / SmartArt renderers read their
-   * element's {@link ElementAnimationState.build} to reveal a staged build
-   * (`p:bldChart` / `p:bldDgm`); shape renderers read `animatesFill` /
-   * `animatesStroke` to relinquish static paint during a `p:animClr` animation.
-   * A stable map instance, mutated in place by the playback controller so a
-   * targeted single-element re-render always reads current state.
-   */
-  readonly presentationStates?: ReadonlyMap<string, ElementAnimationState>;
-  /** The registry in effect, for renderers that need to inspect it. */
-  readonly registry: ElementRendererRegistry;
-  /**
-   * Render a child element through the registry (used by the group renderer
-   * for recursion; custom renderers may nest elements the same way).
-   */
-  renderElement(element: PptxElement, zIndex: number): HTMLElement | SVGElement | null;
-}
-/**
- * Renders one slide element to a DOM node (or `null` to render nothing).
- *
- * Contract:
- * - Position absolutely within the stage: apply the shared
- *   `getContainerStyle(element, zIndex)` map (or equivalent) to the returned
- *   root node.
- * - Set `dataset.elementId = element.id` on the root node.
- * - Create all DOM via `context.document`.
- * - Never mutate `element` or anything on the context.
- */
-type ElementRenderer = (element: PptxElement, zIndex: number, context: ElementRenderContext) => HTMLElement | SVGElement | null;
-/**
- * Registry dispatching elements to renderers by their `type` discriminant.
- *
- * Additional element types are supported by registering a renderer for the
- * type; unregistered types fall through to the fallback renderer (a typed
- * placeholder box by default). See `render/elements/README.md` for the
- * step-by-step contract.
- */
-interface ElementRendererRegistry {
-  /** Register (or replace) the renderer for an element type. */
-  register(type: PptxElementType, renderer: ElementRenderer): void;
-  /** Remove the renderer for an element type (falls back afterwards). */
-  unregister(type: PptxElementType): void;
-  /** The renderer registered for a type, or `undefined`. */
-  get(type: PptxElementType): ElementRenderer | undefined;
-  /** True when a dedicated (non-fallback) renderer is registered. */
-  has(type: PptxElementType): boolean;
-  /** Replace the fallback renderer used for unregistered types. */
-  setFallback(renderer: ElementRenderer): void;
-  /** The renderer to use for a type: registered renderer or fallback. */
-  resolve(type: PptxElementType): ElementRenderer;
-  /** All types with a dedicated renderer (sorted, for tests/debugging). */
-  registeredTypes(): PptxElementType[];
-}
-//#endregion
-//#region src/viewer/render/registry.d.ts
-/**
- * Create an empty {@link ElementRendererRegistry}.
- *
- * The default fallback renders nothing; `createDefaultRegistry()` (in
- * `./elements`) installs the built-in renderers plus the typed placeholder
- * fallback.
- */
-export declare function createElementRendererRegistry(): ElementRendererRegistry;
-//#endregion
-//#region src/viewer/render/dom.d.ts
-/**
- * Apply a shared `CssStyleMap` to an element. The shared builders emit a mix
- * of camelCase (`backgroundColor`) and kebab-case (`background-color`) keys;
- * both are normalised to `style.setProperty` calls.
- */
-export declare function applyStyleMap(el: HTMLElement | SVGElement, style: CssStyleMap): void;
-/** Create an element with an optional class and style map. */
-export declare function createEl<K extends keyof HTMLElementTagNameMap>(doc: Document, tag: K, className?: string, style?: CssStyleMap): HTMLElementTagNameMap[K];
-/** Create a namespaced SVG element with optional attributes. */
-export declare function createSvgEl<K extends keyof SVGElementTagNameMap>(doc: Document, tag: K, attrs?: Record<string, string | number | undefined>): SVGElementTagNameMap[K];
-//#endregion
-//#region src/viewer/render/slide-stage.d.ts
-interface SlideStageOptions {
-  document: Document;
-  slide: PptxSlide;
-  canvasSize: CanvasSize;
-  mediaDataUrls: ReadonlyMap<string, string>;
-  /** Optional presentation theme colour scheme for element renderers. */
-  colorScheme?: PptxThemeColorScheme;
-  /** Optional presentation theme font scheme for table-style font resolution. */
-  fontScheme?: PptxThemeFontScheme;
-  /** Optional parsed table-style definitions for theme-aware table rendering. */
-  tableStyleMap?: ParsedTableStyleMap;
-  fieldContext?: FieldSubstitutionContext;
-  registry: ElementRendererRegistry;
-  t: Translator;
-  /** Scale applied via CSS transform (default 1). */
-  scale?: number;
-  /**
-   * Grid dot/line spacing in CSS px for the View > Grid overlay (`.pptxv-showGrid`),
-   * derived by the caller from the deck's authored `viewProperties.gridSpacing`
-   * via `computeGridSpacingPx`. Defaults to 10px (this binding's existing grid
-   * step) when omitted.
-   */
-  gridSpacingPx?: number;
-  /** Opt-in WebGL SmartArt renderer flag; see `PptxViewerOptions.smartArt3D`. */
-  smartArt3D?: boolean;
-  /**
-   * Opt-in interactive WebGL surface-chart renderer flag; see
-   * `PptxViewerOptions.surfaceChart3D`.
-   */
-  surfaceChart3D?: boolean;
-  /**
-   * Opt-in interactive WebGL bar3D-chart renderer flag; see
-   * `PptxViewerOptions.barChart3D`.
-   */
-  barChart3D?: boolean;
-  /**
-   * Opt-in interactive WebGL line3D-chart renderer flag; see
-   * `PptxViewerOptions.lineChart3D`.
-   */
-  lineChart3D?: boolean;
-  /**
-   * Opt-in interactive WebGL area3D-chart renderer flag; see
-   * `PptxViewerOptions.areaChart3D`.
-   */
-  areaChart3D?: boolean;
-  /**
-   * Opt-in interactive WebGL pie3D-chart renderer flag; see
-   * `PptxViewerOptions.pieChart3D`.
-   */
-  pieChart3D?: boolean;
-  /** True only for the live presentation stage; see `ElementRenderContext.presenting`. */
-  presenting?: boolean;
-  /** Full deck and active index used by presentation Zoom elements. */
-  slides?: readonly PptxSlide[];
-  currentSlideIndex?: number;
-  onZoomClick?: (target: ZoomNavigationTarget, returnSlideIndex: number) => void;
-  onSmartArtNodeTextChange?: (element: PptxElement, nodeId: string, text: string) => void;
-  onSmartArtNodeFillChange?: (element: PptxElement, nodeId: string, fill: string) => void;
-  /** See `ElementRenderContext.onChartPointChange`. */
-  readonly onChartPointChange?: (element: PptxElement, chartData: PptxChartData) => void;
-  /** See `ElementRenderContext.onTableResizeColumns`. */
-  readonly onTableResizeColumns?: (element: PptxElement, widths: number[]) => void;
-  /** See `ElementRenderContext.onTableResizeRow`. */
-  readonly onTableResizeRow?: (element: PptxElement, rowIndex: number, height: number) => void;
-  /** See `ElementRenderContext.chartPartSelection`. */
-  readonly chartPartSelection?: ChartPartSelection | null;
-  /** See `ElementRenderContext.onChartPartSelect`. */
-  readonly onChartPartSelect?: (element: PptxElement, part: ChartPartRef) => void;
-  /** See `ElementRenderContext.selectedElementIds`. */
-  readonly selectedElementIds?: ReadonlySet<string>;
-  /**
-   * True only for the main (interactive) canvas, never the thumbnail rail.
-   * Marks every rendered element (recursively, including group children) with
-   * `data-pptx-element="true"` and the stage itself with
-   * `role="region" aria-roledescription="slide"` - the framework-neutral e2e
-   * test hooks the React/Vue/Angular bindings also emit. Defaults to `false`.
-   */
-  interactive?: boolean;
-  /** Whether inherited layout/master nodes participate in editing. */
-  templateEditing?: boolean;
-  /** Per-element native-animation playback state (presentation mode only). */
-  presentationStates?: ReadonlyMap<string, ElementAnimationState>;
-  /**
-   * Invoked with the built render context once the stage is assembled. Lets the
-   * presentation playback re-render single elements (staged chart / SmartArt
-   * build, `p:animClr` fill / stroke) in place without rebuilding the stage.
-   */
-  captureContext?: (context: ElementRenderContext) => void;
-}
-/**
- * Render one slide as a fixed-size stage: the resolved slide background plus
- * every element dispatched through the registry, scaled with a CSS transform
- * (`transform-origin: top left`), exactly like the other bindings' stages.
- *
- * The returned node is `canvasSize * scale` ON SCREEN but laid out at the
- * unscaled canvas size, so the caller should wrap it in a box sized to
- * `canvasSize * scale` (the viewer's stage host and thumbnails both do).
- */
-export declare function renderSlideStage(options: SlideStageOptions): HTMLElement;
-//#endregion
-//#region src/viewer/render/elements/index.d.ts
-/**
- * The registry the viewer uses by default.
- *
- * Dedicated renderers: `text`, `shape`, `image`, `picture`, `group`,
- * `connector`, `table`, `chart`, `smartArt`, `media`, `ink`, `ole`,
- * `contentPart`, `zoom`, and `model3d`. Only unknown extension elements fall
- * through to the typed placeholder fallback.
- */
-export declare function createDefaultRegistry(): ElementRendererRegistry;
+import * as import_ooxml_ui_pptx_dom from "ooxml-ui/pptx/dom";
 //#endregion
 //#region src/viewer/state/viewer-state.d.ts
 /** Why the last password attempt failed; see `checkModifyPassword` (`pptx-viewer-shared`). */
@@ -607,13 +219,13 @@ interface ViewerState {
     column: number;
   }>;
   /** Active rich-text range captured from the inline editor. */
-  selectedTextRange: InlineTextSelection | null;
+  selectedTextRange: InlineTextSelection$1 | null;
   /**
    * On-canvas chart part selection (a clicked bar/dot/slice/series line),
    * surfaced to the chart inspector's data grid + point-index picker. Cleared
    * whenever the general element selection changes (see `selectionState`).
    */
-  chartPartSelection: ChartPartSelection | null;
+  chartPartSelection: index_d_exports$1.ChartPartSelection | null;
   /** Source element id while the one-shot Format Painter is armed. */
   formatPainterSourceId: string | null;
   /** When true, selection and element mutations target inherited template elements. */
@@ -633,9 +245,9 @@ interface ViewerState {
   /** True when the right-hand property inspector panel is shown (editing chrome). */
   inspectorOpen: boolean;
   /** Remote collaborators currently in the session (empty when not collaborating). */
-  remotePresences: SanitizedPresence[];
+  remotePresences: SanitizedPresence$1[];
   /** Remote cursors visible on the current slide, projected from `remotePresences`. */
-  cursors: RemoteCursor[];
+  cursors: RemoteCursor$1[];
   /** Client id of the peer the local user is following, or null when free. */
   followedClientId: number | null;
   /** In-memory clipboard payload from the last copy/cut, or null. */
@@ -725,6 +337,8 @@ interface ViewerState {
   runProgramNotices: RunProgramNotice[];
 }
 export declare function createInitialViewerState(): ViewerState;
+/** Clamp a slide index into the valid range for the given slide count. */
+declare function clampSlideIndex(index: number, slideCount: number): number;
 //#endregion
 //#region src/viewer/editor/editor-animation-actions.d.ts
 /**
@@ -1033,7 +647,7 @@ interface InspectorActions {
   setTextWrap(wrap: NonNullable<TextStyle['textWrap']>): void;
   setAutoFitMode(mode: NonNullable<TextStyle['autoFitMode']>): void;
   setTextAdvanced(patch: TextAdvancedChanges): void;
-  setTextStyle(patch: Partial<TextStyle>, selection?: InlineTextSelection | null): void;
+  setTextStyle(patch: Partial<TextStyle>, selection?: InlineTextSelection$1 | null): void;
   setFillOpacity(opacity: number): void;
   setStrokeOpacity(opacity: number): void;
   setGradientFill(state: GradientState): void;
@@ -1308,8 +922,209 @@ interface AccessibilityPanel {
   open(issues: readonly AccessibilityIssue[]): void;
   close(): void;
 }
+/**
+ * A keyboard-accessible, live accessibility checker result panel. It is kept
+ * separate from the element inspector so it remains useful in read-only mode,
+ * while the View ribbon is its discoverable entry point.
+ */
+declare function createAccessibilityPanel(doc: Document, t: Translator, onSelectSlide: (index: number) => void): AccessibilityPanel;
 //#endregion
 //#region src/viewer/ui/inspector/types.d.ts
+/**
+ * The inspector edit actions: universal geometry + flat fill/stroke, plus the
+ * element-type-aware sections (text anchor/wrap/autofit, gradient fill +
+ * opacity, image adjustments/crop, table-level flags + padding).
+ */
+interface InspectorHandlers {
+  /** Select an element from the Elements (layer-order) tab. */
+  selectElement(id: string): void;
+  /** Open the full Document Properties dialog from the Properties tab. */
+  openDocumentProperties(): void;
+  /**
+   * File > Options > Advanced > "Properties follow chart data point for
+   * current workbook", read fresh on every chart category removal.
+   */
+  getChartFollowDataPoint(): boolean;
+  /** Merge a patch into the presentation show/print settings (PRESENTATION card). */
+  updatePresentationSettings(patch: Partial<PptxPresentationProperties>): void;
+  /** Apply a packaged theme part by archive path (THEME card). */
+  applyThemeByPath(themePath: string, allMasters: boolean): void;
+  /** Re-theme the deck from the THEME EDITOR card's staged colours/fonts/name. */
+  applyThemeEdit(payload: {
+    colorScheme: PptxThemeColorScheme;
+    fontScheme: PptxThemeFontScheme;
+    name: string;
+  }): void | Promise<void>;
+  /** Replace the deck's `ppt/tags/*.xml` collections (TAGS card). */
+  updateTagCollections(next: PptxTagCollection[]): void;
+  /**
+   * The deck's parsed `ppt/tableStyles.xml` map, for the table properties
+   * panel's "Edit style...". `undefined` means the host has not wired the
+   * table-style-editor feature through; the button then simply does not render.
+   */
+  getTableStyleMap(): ParsedTableStyleMap | undefined;
+  /** The current theme colour map (scheme key -> hex), for resolving scheme-based table style colours. */
+  getThemeColorMap(): Record<string, string> | undefined;
+  /** Commit a full replacement style map (section edit, create, or delete already applied). */
+  updateTableStyleMap(nextMap: ParsedTableStyleMap): void;
+  /** Record a styleId for save-time removal from `ppt/tableStyles.xml`. */
+  deleteTableStyle(styleId: string): void;
+  /** Patch the active slide (THEME OVERRIDE card). */
+  updateActiveSlide(patch: Partial<PptxSlide>): void;
+  /**
+   * Set a layout/master's background colour (SLIDE BACKGROUND card's
+   * template rows, shown while `editTemplateMode` is on). Master Views
+   * covers the same ground but requires leaving the slide.
+   */
+  setTemplateBackground(path: string, backgroundColor: string): void;
+  /** Read a layout/master's current background colour. */
+  getTemplateBackgroundColor(path: string): string | undefined;
+  /** Resize the slide canvas (the SLIDE SIZE card's raw W/H inputs). */
+  updateCanvasSize(size: {
+    width: number;
+    height: number;
+  }): void;
+  /**
+   * Adopt an EMU slide size (SLIDE SIZE preset dropdown / orientation toggle).
+   * Writes both the EMU state and the pixel canvas.
+   */
+  updateSlideSize(size: SlideSizeEmu): void;
+  /**
+   * Adopt an EMU slide size AND rescale every slide's content for it in one
+   * undoable step (the "Scale content for the new slide size?" prompt shown
+   * when the deck has content and the new size differs from the current one).
+   */
+  applySlideSizeRescale(size: SlideSizeEmu, mode: SlideSizeRescaleMode): void;
+  /** Add a comment on the current slide (Comments tab). */
+  addComment(text: string, mentions?: PptxCommentMention[]): void;
+  /** Append a reply under a top-level comment (Comments tab reply form). */
+  addCommentReply(parentId: string, text: string, mentions?: PptxCommentMention[]): void;
+  /** Replace a comment's (or reply's) text (Comments tab edit-in-place). */
+  editComment(id: string, text: string): void;
+  deleteComment(id: string): void;
+  toggleCommentResolved(id: string): void;
+  /** Set/clear one effect bucket on the selected element (docked Animation panel). */
+  setAnimationEffect(group: AnimationGroup, preset: PptxAnimationPreset | 'none'): void;
+  /** Apply/clear a catalogue motion path by preset id (`'none'` clears it). */
+  applyMotionPath(presetId: string): void;
+  /** Patch timing/effect options on one element's animation entry. */
+  setAnimationTiming(elementId: string, patch: AnimationTimingPatch): void;
+  /** Stage a picked effect sound file, or clear it entirely (`undefined`). */
+  setAnimationSound(elementId: string, pick: {
+    dataUrl: string;
+    fileName?: string;
+  } | undefined): void;
+  /** Stage one of PowerPoint's 19 built-in stock sounds by catalogue id. */
+  setAnimationStockSound(elementId: string, catalogueId: string): void;
+  /** Move an element's animation one step in the slide play order. */
+  reorderAnimation(elementId: string, direction: 'up' | 'down'): void;
+  setGeometry(patch: GeometryPatch): void;
+  /** Flip the selected element's lock (see elementLockTogglePatch). */
+  toggleElementLock(): void;
+  /**
+   * Set the shape fill colour. Pass `ref` for a theme-swatch pick (wins on
+   * save, so the fill follows a later theme change); omit it to clear a
+   * previously-stored ref for a plain/custom/recent pick.
+   */
+  setShapeFill(color: string, ref?: PptxThemeColorRef): void;
+  /** Same `ref` contract as {@link setShapeFill}, for the stroke colour. */
+  setShapeStroke(color: string, ref?: PptxThemeColorRef): void;
+  setShapeStrokeWidth(width: number): void;
+  setShapeStyle(patch: Partial<ShapeStyle>): void;
+  setShapeType(shapeType: string): void;
+  /**
+   * B6: fold a colour into the deck's "Recent colours" (`p:clrMru`) MRU list,
+   * without touching the selected element. Every inspector colour input that
+   * has no dedicated recent-colours row of its own (chart/table/image/
+   * SmartArt/text-effects colours, gradient stops, pattern fill) calls this
+   * on COMMIT (native `change`, never the continuous `input` event a drag
+   * through the OS picker fires) so the deck's MRU list still grows even
+   * though there is nowhere on screen to show it going in.
+   */
+  pushRecentColor(hex: string): void;
+  setTextVerticalAlign(vAlign: InspectorState['vAlign']): void;
+  setTextWrap(wrap: InspectorState['textWrap']): void;
+  setAutoFitMode(mode: InspectorState['autoFitMode']): void;
+  setTextAdvanced(patch: TextAdvancedChanges): void;
+  setTextStyle(patch: Partial<TextStyle>, selection?: InlineTextSelection$1 | null): void;
+  setFillOpacity(opacity: number): void;
+  setStrokeOpacity(opacity: number): void;
+  setGradientFill(state: GradientState): void;
+  addGradientStop(color: string, position: number): void;
+  removeGradientStop(index: number): void;
+  updateGradientStop(index: number, changes: Partial<GradientState['stops'][number]>): void;
+  setImageBrightness(value: number): void;
+  setImageContrast(value: number): void;
+  setImageSaturation(value: number): void;
+  setImageCrop(edge: 'left' | 'top' | 'right' | 'bottom', value: number): void;
+  setImageEffects(patch: Partial<PptxImageEffects>): void;
+  replaceImage(): void;
+  resetImage(): void;
+  resetCrop(): void;
+  setElementAction(trigger: 'click' | 'hover', action: ElementAction): void;
+  /** Set the selected element's accessibility description (Alt Text field). */
+  setAltText(text: string): void;
+  /**
+   * Set the selected element's accessibility title (`p:cNvPr/@title`).
+   * Applies to a plain shape/text box/connector and every graphic-frame
+   * kind (table/chart/smartArt/ole/media), not a picture (which has no
+   * title field). See {@link PptxNonVisualDescription}.
+   */
+  setTitle(text: string): void;
+  /**
+   * Set the selected OLE element's Object Name (`p:oleObj/@name`, ECMA-376
+   * SS13.3.4). A browser cannot run the native application an embedded OLE
+   * object belongs to, so the object stays read-only; this name already
+   * parses, saves, and syncs via collaboration and only lacked an editing
+   * surface.
+   */
+  setOleName(name: string): void;
+  /**
+   * Patch an in-place OLE content edit (spreadsheet cell / document
+   * paragraph / nested-deck slide title / Replace File) onto the selected
+   * element. Callers pass `buildOleContentUpdatePatch`'s output, which
+   * already scopes the patch to the fields a content edit can touch.
+   */
+  setOleContent(patch: Partial<OlePptxElement>): void;
+  setChartData(data: PptxChartData): void;
+  setMediaProperties(patch: Partial<MediaPptxElement>): void;
+  setTableHeaderRow(enabled: boolean): void;
+  setTableBandedRows(enabled: boolean): void;
+  setTableCellPadding(padding: number): void;
+  setTableOptions(patch: Partial<PptxTableData>, cellStyle?: Partial<PptxTableCellStyle>): void;
+  /**
+   * Replace the selected table's whole `tableData` (inspector data grid).
+   *
+   * `setTableOptions` cannot serve here: it re-applies the element's existing
+   * rows after the patch, so a row/cell change made through it is discarded.
+   */
+  /**
+   * Replace the selected table's whole `tableData`, plus the graphic-frame
+   * `rawXml` the renderer and save writer actually read for a table parsed from
+   * a real deck (a `tableData`-only patch is invisible on such tables).
+   */
+  setTableData(data: PptxTableData, rawXml?: XmlObject): void;
+  setTableCellStyle(row: number, column: number, patch: Partial<PptxTableCellStyle>): void;
+  setTableCellStyles(cells: TableCellPosition[], patch: Partial<PptxTableCellStyle>): void;
+  mutateTableStructure(cell: TableCellPosition, action: TableStructureAction): void;
+  setTableColumnWidth(column: number, percent: number): void;
+  setTableRowHeight(row: number, height: number): void;
+  mergeTableCells(cells: TableCellPosition[]): void;
+  splitTableCell(cell: TableCellPosition): void;
+  setSmartArtNodeText(nodeId: string, text: string): void;
+  setSmartArtNodeStyle(nodeId: string, patch: Partial<PptxSmartArtNodeStyle>): void;
+  mutateSmartArtNode(nodeId: string, action: 'add' | 'addChild' | 'remove' | 'promote' | 'demote'): void;
+  /**
+   * Commit a whole replacement `smartArtData`, reflowed and history-integrated
+   * like every other SmartArt mutation. Used by the text pane's Tab / Enter /
+   * Backspace keyboard handling, which computes the next data (and, for
+   * add/remove, the node to focus next) via the shared `smartart-node-pane-
+   * handlers` builders before committing.
+   */
+  replaceSmartArtData(data: PptxSmartArtData): void;
+  setSmartArtLayout(layout: SmartArtLayoutType): void;
+  setSmartArtColorScheme(scheme: SmartArtColorScheme): void;
+}
 /** Selection-derived state the inspector reflects, computed by `buildInspectorState`. */
 interface InspectorState {
   hasSelection: boolean;
@@ -1375,7 +1190,7 @@ interface InspectorState {
   textDirection: 'horizontal' | 'vertical' | 'vertical270' | 'eaVert' | 'wordArtVert' | 'wordArtVertRtl' | 'mongolianVert';
   textRtl: boolean;
   textStyle: TextStyle | undefined;
-  selectedTextRange: InlineTextSelection | null;
+  selectedTextRange: InlineTextSelection$1 | null;
   imageBrightness: number;
   imageContrast: number;
   imageSaturation: number;
@@ -1524,6 +1339,18 @@ interface Inspector {
   setEditable(editable: boolean): void;
 }
 //#endregion
+//#region src/viewer/ui/inspector/inspector.d.ts
+/**
+ * The property inspector: a right-hand panel with React's three-tab strip
+ * (Elements | Properties | Comments). The Properties tab shows the
+ * element-type-aware sections when something is selected and a deck-level
+ * panel (presentation / slide size / document) otherwise; Elements lists the
+ * slide's layer order; Comments carries the slide's review comments. Vanilla
+ * counterpart of React's `InspectorPane`, scoped to the highest-traffic
+ * panels. All labels from the shared `pptx.*` dictionary.
+ */
+declare function createInspector(doc: Document, t: Translator, handlers: InspectorHandlers): Inspector;
+//#endregion
 //#region src/viewer/ui/master-view-sidebar.d.ts
 interface MasterViewSidebarOptions {
   tab: MasterViewTab;
@@ -1563,6 +1390,7 @@ interface MasterViewSidebar {
   render(options: MasterViewSidebarOptions): void;
   setVisible(visible: boolean): void;
 }
+declare function createMasterViewSidebar(doc: Document, t: Translator): MasterViewSidebar;
 //#endregion
 //#region src/viewer/ui/ribbon/ribbon-types.d.ts
 /** Ribbon tab identifiers this wave implements (see `ribbon-tabs.ts` for the full future roster). */
@@ -1581,7 +1409,7 @@ interface RibbonNavHandlers {
   openAccessibility(): void;
   openSettings(tab?: 'general' | 'shortcuts'): void;
   /** The host's resolved UI customisation (omitted: nothing customised). */
-  getCustomization?(): ResolvedCustomization;
+  getCustomization?(): ResolvedCustomization$1;
   openHeaderFooter(): void;
   openCompare(): void;
   openSelectionPane(): void;
@@ -1620,7 +1448,7 @@ interface RibbonFileHandlers {
   createPresentation(templateId: string): void;
   openSettings(): void;
   /** The host's resolved UI customisation (omitted: nothing customised). */
-  getCustomization?(): ResolvedCustomization;
+  getCustomization?(): ResolvedCustomization$1;
   openShare(): void;
   openDocumentProperties(): void;
   openFontEmbedding(): void;
@@ -1849,8 +1677,16 @@ interface MobileActionSheets {
   setEditable(editable: boolean): void;
   setNotesExpanded(expanded: boolean): void;
 }
+declare function createMobileActionSheets(doc: Document, t: Translator, handlers: RibbonHandlers, onSelectSlide: (index: number) => void, inspector: HTMLElement | null, hiddenActions?: readonly ToolbarActionId$1[]): MobileActionSheets;
 //#endregion
 //#region src/viewer/ui/mobile-toolbar.d.ts
+interface MobileToolbarHandlers {
+  openMenu(): void;
+  undo(): void;
+  redo(): void;
+  save(): void;
+  present(): void;
+}
 interface MobileToolbar {
   el: HTMLElement;
   collaborationHost: HTMLElement;
@@ -1864,6 +1700,16 @@ interface MobileToolbar {
   aiHost: HTMLElement;
   setEditState(state: RibbonEditState): void;
 }
+/**
+ * Compact phone toolbar matching React's menu/edit/save/present action row. A
+ * thin adapter over the shared `pptx-ui-mobile-toolbar`, which owns the markup
+ * and gating. Applies the same `hiddenActions` rules as the desktop chrome:
+ * undo/redo hide independently, and present shares the `'fullscreen'` action
+ * with the status bar / View tab's slide-show toggle. The AI toggle and the
+ * collaboration pill are host-mounted into the element's `ai` and
+ * `collaboration` slots; Share is the collaboration pill, so it is not drawn.
+ */
+declare function createMobileToolbar(doc: Document, t: Translator, handlers: MobileToolbarHandlers, hiddenActions?: readonly ToolbarActionId$1[]): MobileToolbar;
 //#endregion
 //#region src/viewer/ui/notes-panel.d.ts
 /** State the panel needs to reflect: the slide to read notes from, and whether edits are allowed. */
@@ -1884,8 +1730,48 @@ interface NotesPanel {
   /** Expand or collapse the notes body (header stays visible either way). */
   setExpanded(expanded: boolean): void;
 }
+/**
+ * The speaker-notes panel: a collapsible strip docked below the
+ * slide stage. Vanilla counterpart of the Vue binding's `NotesPanel.vue`
+ * plain `<textarea>` surface only; there is no rich contentEditable chrome
+ * here (that is out of scope for this binding).
+ *
+ * The textarea is uncontrolled: its `value` is set imperatively and only
+ * re-seeded on a genuine slide swap (keyed by slide id), matching the
+ * mobile-safe rationale documented on the Vue editor. Edits commit on
+ * `change` / `blur`, never per keystroke.
+ */
+declare function createNotesPanel(doc: Document, t: Translator, onToggle: () => void, onCommit: (notes: string, notesSegments?: TextSegment[]) => void): NotesPanel;
 //#endregion
 //#region src/viewer/ui/presentation-toolbar.d.ts
+/**
+ * The floating slide-show toolbar, matching React's `PresentationToolbar`.
+ *
+ * Vanilla previously shipped ONLY `presentation-touch-controls.ts`, whose CSS
+ * hides it outside a coarse pointer, so a desktop presenter saw no show chrome
+ * at all: no counter, no navigation, and no way out short of Escape. This is the
+ * desktop bar, a thin adapter over the shared `pptx-ui-present-toolbar`, which
+ * renders the shared `present-chrome` inventory (control ids, order, names,
+ * colour palettes and the elapsed readout) so it cannot drift from the other four
+ * bindings.
+ *
+ * This module owns behaviour only: the auto-hide wrapper, the start time and the
+ * state reflection. The element tree lives in the shared package.
+ */
+interface PresentationToolbarHandlers {
+  previous(): void;
+  next(): void;
+  /** Select an annotation tool; the caller decides whether re-selecting clears it. */
+  setTool(tool: PresentationPointerTool): void;
+  /** Set the active pointer colour (picking a swatch also selects its tool). */
+  setColor(color: string): void;
+  /** One-click blackboard: arm/disarm the black screen and the pen together. */
+  toggleBlackboard(): void;
+  clearAnnotations(): void;
+  /** Open/close the presenter console + audience display. */
+  togglePresenterView(): void;
+  end(): void;
+}
 /** Everything the bar reflects; pushed in as partial patches from two sources. */
 interface PresentationToolbarState {
   /** Zero-based active slide. */
@@ -1910,12 +1796,29 @@ interface PresentationToolbar {
   toggleVisible(): void;
   dispose(): void;
 }
+/**
+ * Build the show toolbar. `container` is the surface the bottom trigger zone is
+ * measured against (the `.pptxv` root, which is also the fullscreen element).
+ */
+declare function createPresentationToolbar(doc: Document, t: Translator, container: HTMLElement, handlers: PresentationToolbarHandlers): PresentationToolbar;
 //#endregion
 //#region src/viewer/ui/presentation-touch-controls.d.ts
+interface PresentationTouchControlHandlers {
+  previous(): void;
+  next(): void;
+  exit(): void;
+}
 interface PresentationTouchControls {
   el: HTMLElement;
   update(current: number, total: number): void;
 }
+/**
+ * Build persistent, safe-area-aware controls for coarse-pointer slide shows.
+ * The prev/next pair is gated as a unit on the `'navigation'` action (the exit
+ * affordance always stays, since removing it would trap a touch user in
+ * presentation mode).
+ */
+declare function createPresentationTouchControls(doc: Document, t: Translator, handlers: PresentationTouchControlHandlers, hiddenActions?: readonly ToolbarActionId$1[]): PresentationTouchControls;
 //#endregion
 //#region src/viewer/ui/read-only-banner.d.ts
 /** Why the last password attempt failed; see `checkModifyPassword` (`pptx-viewer-shared`). */
@@ -1992,7 +1895,7 @@ interface Ribbon {
  * never called, and a hidden button/cluster inside a tab is never built by
  * that tab's own module (see `ribbon-types.ts` handlers vs. this file).
  */
-export declare function createRibbon(doc: Document, t: Translator, handlers: RibbonHandlers, hiddenActions?: readonly ToolbarActionId[], accountAuth?: AccountAuthConfig): Ribbon;
+export declare function createRibbon(doc: Document, t: Translator, handlers: RibbonHandlers, hiddenActions?: readonly ToolbarActionId$1[], accountAuth?: AccountAuthConfig$1): Ribbon;
 //#endregion
 //#region src/viewer/ui/shortcut-panel.d.ts
 interface ShortcutPanel {
@@ -2002,9 +1905,21 @@ interface ShortcutPanel {
   close(): void;
   isOpen(): boolean;
 }
-//#endregion
-//#region src/viewer/ui/status-bar.d.ts
-/** Autosave lifecycle states pushed into the save-state text. */
+/**
+ * The keyboard-shortcut cheat sheet.
+ *
+ * Every other binding shipped one; the vanilla binding was the only viewer with
+ * no way to discover its own keymap. Rows come from the shared
+ * {@link VIEWER_SHORTCUT_REFERENCE}, so the list cannot claim a binding the
+ * shared keymap does not actually resolve.
+ *
+ * It carries `data-pptx-shortcuts-panel`, the neutral hook the cross-binding
+ * e2e suite locates it by.
+ */
+declare function createShortcutPanel(doc: Document, t: Translator): ShortcutPanel;
+//#endregion
+//#region src/viewer/ui/status-bar.d.ts
+/** Autosave lifecycle states pushed into the save-state text. */
 type StatusBarSaveKind = 'idle' | 'saving' | 'saved' | 'error';
 interface StatusBar {
   el: HTMLElement;
@@ -2101,11 +2016,11 @@ interface InlineEditorSession {
   /** Recognize a merged model revision before the ordinary model replacement guard. */
   checkModel?: (model: PptxElement | undefined) => boolean;
   /** Canonical accepted state only, for retirement before a host permission veto. */
-  readAccepted?: () => InlineTextEditSnapshot | undefined;
+  readAccepted?: () => InlineTextEditSnapshot$1 | undefined;
   activateList(element: PptxElement): boolean | undefined;
-  readSnapshot(): InlineTextEditSnapshot | undefined;
-  readList(): InlineListReadResult | undefined;
-  formatSnapshot(snapshot: InlineTextEditSnapshot): boolean;
+  readSnapshot(): InlineTextEditSnapshot$1 | undefined;
+  readList(): InlineListReadResult$1 | undefined;
+  formatSnapshot(snapshot: InlineTextEditSnapshot$1): boolean;
   /** Commit the current text (fires `onCommit` when changed) and close. */
   commit(): void;
   /** Close without committing. */
@@ -2122,17 +2037,17 @@ interface OpenInlineEditorOptions {
   spellCheck?: boolean;
   /** Use the existing connected slide channel, never create another session. */
   collaboration?: {
-    patcher: CollaborationLivePatcher;
+    patcher: CollaborationLivePatcher$1;
     slideId?: string;
   };
   /** Called with the edited text on commit (only when it changed). */
-  onCommit(text: string, snapshot?: InlineTextEditSnapshot): void;
+  onCommit(text: string, snapshot?: InlineTextEditSnapshot$1): void;
   /**
    * Called with the edited text on EVERY keystroke. Used for the collaboration
    * live preview only: it must not touch editor state or history.
    */
-  onInput?(text: string, snapshot?: InlineTextEditSnapshot): void;
-  onSelectionChange?(selection: InlineTextSelection | null): void;
+  onInput?(text: string, snapshot?: InlineTextEditSnapshot$1): void;
+  onSelectionChange?(selection: InlineTextSelection$1 | null): void;
   /** Called after the surface closes (commit or cancel). */
   onClose(): void;
   /**
@@ -2176,6 +2091,15 @@ interface ThumbnailSectionActions {
 }
 //#endregion
 //#region src/viewer/ui/thumbnails.d.ts
+/** The item-2 multi-select/context-menu deps; all optional so existing callers keep working. */
+interface ThumbnailRailMenuDeps {
+  store: Store<ViewerState>;
+  getEditActions(): EditActions;
+  addSlideAfter(index: number): void;
+  duplicateSlides(indexes: number[]): void;
+  deleteSlides(indexes: number[]): void;
+  toggleHideSlides(indexes: number[]): void;
+}
 interface ThumbnailRail {
   el: HTMLElement;
   /** Rebuild the rail for a new slide list (uses `renderStage` per slide). */
@@ -2191,10 +2115,61 @@ interface ThumbnailRail {
     layoutIndex: number | null;
   }): void;
 }
+/**
+ * The thumbnail sidebar: a scaled-down live render of every slide; clicking a
+ * thumbnail navigates to it. Rebuilt only when the slide list changes.
+ */
+declare function createThumbnailRail(doc: Document, t: Translator, onSelect: (index: number) => void, onAddSlide?: () => void, menuDeps?: ThumbnailRailMenuDeps): ThumbnailRail;
 //#endregion
 //#region src/viewer/ui/title-bar.d.ts
 /** Autosave lifecycle states the title-bar status text reflects. */
 type TitleBarAutosaveKind = 'idle' | 'saving' | 'saved' | 'error';
+/** Live Quick Access Toolbar config (File > Options > Quick Access Toolbar). */
+interface TitleBarQuickAccessState {
+  visible: boolean;
+  showCommandLabels: boolean;
+  commandIds: readonly string[];
+}
+interface TitleBarQuickAccess {
+  getState(): TitleBarQuickAccessState;
+  /** Run a non-core command id (`presentFromStart`, `print`, `zoomIn`, ...). */
+  run(id: string): void;
+  /** ScreenTip text for a command label; undefined suppresses the tooltip. */
+  screenTip(label: string): string | undefined;
+}
+interface TitleBarDeps {
+  /** Display name of the open document (host-supplied). */
+  fileName?: string;
+  /** Whether the AutoSave switch starts on. */
+  autosaveEnabled: boolean;
+  /**
+   * Whether the switch can change anything (default `true`). The host's
+   * `autosave: false` is a policy the user cannot override, and a switch that
+   * silently does nothing is worse than a visibly disabled one, so it renders
+   * inert instead of pretending to work. See
+   * `pptx-viewer-shared/render/autosave-policy`.
+   */
+  autosaveToggleAvailable?: boolean;
+  /** Flip autosave; returns the new enabled state the switch reflects. */
+  onToggleAutosave(): boolean;
+  save(): void;
+  undo(): void;
+  redo(): void;
+  /** Run a shared command-search id (`COMMAND_SEARCH_ENTRIES`), see `title-bar-commands.ts`. */
+  runCommand(id: string): void;
+  /** The search box's "Find in Slides" row: toggle the Find & Replace panel. */
+  findInSlides(): void;
+  /** Individually hidden toolbar buttons (gates undo/redo independently). */
+  hiddenActions?: readonly ToolbarActionId$1[];
+  /** Options-driven Quick Access strip; omitted = the classic Save/Undo/Redo. */
+  quickAccess?: TitleBarQuickAccess;
+  /**
+   * Fires whenever the below-the-ribbon strip's emptiness is recomputed, so the
+   * detached dock (see `ViewerChrome.setQuickAccessPosition`) can hide instead
+   * of showing an empty bar.
+   */
+  onQuickAccessVisibilityChange?(hidden: boolean): void;
+}
 interface TitleBar {
   /** The shared `pptx-ui-title-bar` host; host-owned parts are slotted into it. */
   el: HTMLElement;
@@ -2221,6 +2196,68 @@ interface TitleBar {
 }
 //#endregion
 //#region src/viewer/ui/chrome.d.ts
+interface ChromeOptions {
+  showToolbar: boolean;
+  showThumbnails: boolean;
+  /** Show the ribbon's editing surface (tab bar + Home/Insert/View content); default true. */
+  showFormatToolbar: boolean;
+  /** Build the property inspector panel (default true; shown only when editable). */
+  showInspector: boolean;
+  /** Host customisation region gates (default true): see `customization-lifecycle`. */
+  showTitleBar?: boolean;
+  showStatusBar?: boolean;
+  showNotes?: boolean;
+  /** Whether editing is initially enabled (gates ribbon tab content/inspector visibility). */
+  editable: boolean;
+  /**
+   * Individually hidden toolbar buttons/ribbon tabs (default: nothing
+   * hidden). Threaded down to every chrome surface that renders a hideable
+   * action so DOM nodes for hidden actions are never constructed.
+   */
+  hiddenActions?: readonly ToolbarActionId$1[];
+  /** Every ribbon handler (nav/primary/file/insert/edit/findReplace). */
+  ribbonHandlers: RibbonHandlers;
+  /**
+   * The slides pane thumbnail context menu's multi-select bulk operations
+   * (New Slide/Duplicate/Delete/Layout/Hide/Add Section). Omit to fall back
+   * to the rail's single-slide "+ Add Slide" behaviour only, with no
+   * right-click menu or Ctrl/Shift multi-select.
+   */
+  thumbnailMenu?: ThumbnailRailMenuDeps;
+  /** Inspector actions (geometry + shape fill/stroke). */
+  inspectorHandlers: InspectorHandlers;
+  /**
+   * Slide-show toolbar actions (annotation tools, presenter view, end show).
+   * Navigation and exit reuse `ribbonHandlers.nav`; only the annotation and
+   * presenter-console actions have no ribbon equivalent, so they arrive here.
+   */
+  presentationToolbarHandlers: Pick<PresentationToolbarHandlers, 'setTool' | 'setColor' | 'toggleBlackboard' | 'clearAnnotations' | 'togglePresenterView'>;
+  /** PowerPoint-style top chrome, built when the toolbar is visible. */
+  titleBar: TitleBarDeps;
+  /** Optional File > Account sign-in hook point; disabled/absent by default. */
+  accountAuth?: AccountAuthConfig$1;
+  onSelectSlide(index: number): void;
+  /** Header click on the notes panel; shares the ribbon Notes button's handler. */
+  onToggleNotes(): void;
+  /** Fired when the notes textarea commits (change/blur) in editable mode. */
+  onCommitNotes(notes: string, notesSegments?: TextSegment[]): void;
+  /** "Enable Editing" click on the Protected View banner. */
+  onEnableEditing(): void;
+  /** "Edit anyway" click on the read-only recommendation banner. */
+  onEditAnywayFromReadOnly(): void;
+  /** Close click on the read-only recommendation banner. */
+  onDismissReadOnlyBanner(): void;
+  /** The read-only recommendation banner's password form submit. */
+  onSubmitReadOnlyPassword(password: string): void;
+  /** The read-only recommendation banner's password form "Cancel". */
+  onCancelReadOnlyPasswordPrompt(): void;
+  /** One compatibility toast's own dismiss button. */
+  onDismissCompatToast(id: string): void;
+  /** The compatibility toast stack's "Dismiss all" button. */
+  onDismissAllCompatToasts(): void;
+  /** One run-program notice's own dismiss button. */
+  onDismissRunProgramNotice(id: string): void;
+}
 /** The viewer's static DOM skeleton plus the mutable overlay controls. */
 interface ViewerChrome {
   /** `.pptxv` root (focusable; keyboard navigation attaches here). */
@@ -2281,6 +2318,427 @@ interface ViewerChrome {
   /** Replace the running-show "Run program" notice stack. */
   setRunProgramNotices(notices: readonly RunProgramNotice[]): void;
 }
+/**
+ * Build the viewer chrome: ribbon (optional), thumbnail rail (optional),
+ * viewport + stage host, and the loading/error/empty overlays. Pure DOM
+ * assembly; all behaviour is wired by the caller through the handlers.
+ */
+declare function buildViewerChrome(doc: Document, t: Translator, options: ChromeOptions): ViewerChrome;
+//#endregion
+//#region src/viewer/ui/icon-paths.d.ts
+declare const ICON_PATHS: {
+  readonly 'chevron-left': readonly ['M15 18l-6-6 6-6'];
+  readonly 'chevron-right': readonly ['M9 18l6-6-6-6'];
+  readonly 'chevron-down': readonly ['M6 9l6 6 6-6'];
+  readonly 'chevron-up': readonly ['M18 15l-6-6-6 6'];
+  readonly 'zoom-in': readonly ['M11 4a7 7 0 1 0 0 14 7 7 0 0 0 0-14z', 'M21 21l-4.35-4.35', 'M11 8v6', 'M8 11h6'];
+  readonly 'zoom-out': readonly ['M11 4a7 7 0 1 0 0 14 7 7 0 0 0 0-14z', 'M21 21l-4.35-4.35', 'M8 11h6'];
+  readonly fit: readonly ['M8 3H5a2 2 0 0 0-2 2v3', 'M16 3h3a2 2 0 0 1 2 2v3', 'M8 21H5a2 2 0 0 1-2-2v-3', 'M16 21h3a2 2 0 0 0 2-2v-3'];
+  readonly play: readonly ['M6 4l14 8-14 8V4z'];
+  readonly sidebar: readonly ['M4 4h16v16H4z', 'M9 4v16'];
+  readonly undo: readonly ['M3 7v6h6', 'M21 17a9 9 0 0 0-15-6.7L3 13'];
+  readonly redo: readonly ['M21 7v6h-6', 'M3 17a9 9 0 0 1 15-6.7L21 13'];
+  readonly save: readonly ['M19 21H5a2 2 0 0 1-2-2V5a2 2 0 0 1 2-2h11l5 5v11a2 2 0 0 1-2 2z', 'M17 21v-8H7v8', 'M7 3v5h8'];
+  readonly notes: readonly ['M5 4h14v16H5z', 'M8 9h8', 'M8 13h8', 'M8 17h4'];
+  readonly plus: readonly ['M12 5v14', 'M5 12h14'];
+  readonly minus: readonly ['M5 12h14'];
+  readonly shapes: readonly ['M4 4h9v9H4z', 'M17.5 14a4.5 4.5 0 1 0 0 9 4.5 4.5 0 0 0 0-9z'];
+  readonly 'bring-front': readonly ['M9 3h12v12H9z', 'M3 9h6v12h12v-6', 'M3 9h6V3'];
+  readonly 'send-back': readonly ['M3 9h12v12H3z', 'M9 3h12v12h-6', 'M15 15h6V9'];
+  readonly 'bring-forward': readonly ['M8 8h13v13H8z', 'M3 3h10v5', 'M3 3v10h5'];
+  readonly 'send-backward': readonly ['M3 3h13v13H3z', 'M16 16h5V8', 'M16 21h5v-5'];
+  readonly share: readonly ['M15 5a3 3 0 1 0 6 0 3 3 0 1 0 -6 0', 'M3 12a3 3 0 1 0 6 0 3 3 0 1 0 -6 0', 'M15 19a3 3 0 1 0 6 0 3 3 0 1 0 -6 0', 'M8.6 13.5l6.8 3.9', 'M15.4 6.6l-6.8 3.9'];
+  readonly broadcast: readonly ['M10 12a2 2 0 1 0 4 0 2 2 0 1 0 -4 0', 'M7.8 7.8a6 6 0 0 0 0 8.4', 'M16.2 7.8a6 6 0 0 1 0 8.4', 'M4.9 4.9a10 10 0 0 0 0 14.2', 'M19.1 4.9a10 10 0 0 1 0 14.2'];
+  readonly cut: readonly ['M6 9a3 3 0 1 0 0-6 3 3 0 0 0 0 6z', 'M6 21a3 3 0 1 0 0-6 3 3 0 0 0 0 6z', 'M20 4L8.5 15.5', 'M14.5 9.5L20 15', 'M8.5 8.5L12 12'];
+  readonly copy: readonly ['M9 9h11v11H9z', 'M5 15H4a1 1 0 0 1-1-1V4a1 1 0 0 1 1-1h10a1 1 0 0 1 1 1v1'];
+  readonly paste: readonly ['M9 3h6v3H9z', 'M6 5h2v2h8V5h2a1 1 0 0 1 1 1v14a1 1 0 0 1-1 1H6a1 1 0 0 1-1-1V6a1 1 0 0 1 1-1z'];
+  readonly duplicate: readonly ['M8 8h11v11H8z', 'M5 15H4a1 1 0 0 1-1-1V4a1 1 0 0 1 1-1h10a1 1 0 0 1 1 1v1'];
+  readonly trash: readonly ['M4 6h16', 'M9 6V4h6v2', 'M6 6l1 14h10l1-14', 'M10 11v5', 'M14 11v5'];
+  readonly bold: readonly ['M6 4h6a3.5 3.5 0 0 1 0 7H6z', 'M6 11h7a3.5 3.5 0 0 1 0 7H6z'];
+  readonly italic: readonly ['M11 4h6', 'M7 20h6', 'M15 4L9 20'];
+  readonly underline: readonly ['M6 4v6a6 6 0 0 0 12 0V4', 'M5 21h14'];
+  readonly strikethrough: readonly ['M6 12h12', 'M8 6.5a4 3 0 0 1 4-2.5c2 0 4 1 4 2.5', 'M8 17.5a4 3 0 0 0 4 2.5c2 0 4-1 4-2.5'];
+  readonly 'text-shadow': readonly ['M6 17V7h5a3.5 3.5 0 0 1 0 7H6', 'M9.5 10h5a3.5 3.5 0 0 1 0 7H9.5', 'M9.5 17V10'];
+  readonly 'a-up': readonly ['M5 18l4-11 4 11', 'M6.5 14h5', 'M17 10l3-3 3 3'];
+  readonly 'a-down': readonly ['M5 18l4-11 4 11', 'M6.5 14h5', 'M17 7l3 3 3-3'];
+  readonly 'clear-format': readonly ['M4 7V4h11l-1.5 3', 'M14 7l6 13', 'M9.5 10.5L18 19', 'M4 20h7'];
+  readonly 'text-direction': readonly [];
+  readonly palette: readonly [];
+  readonly 'change-case': readonly ['M4 16l3-9 3 9', 'M5 13h4', 'M14 8v8', 'M14 10a3 3 0 1 1 0 6', 'M14 10a3 3 0 1 0 0 6'];
+  readonly 'char-spacing': readonly ['M6 6h2v12H6z', 'M16 6h2v12h-2z', 'M2 20h2M2 20v-2M2 20v2', 'M22 20h-2M22 20v-2M22 20v2'];
+  readonly 'font-color': readonly ['M6 20h12', 'M9.5 4h5L18 16H6L9.5 4z'];
+  readonly highlight: readonly ['M11 15l-4 4H3v-4l4-4', 'M14.5 4.5l5 5L9 20l-5-1 1-5z'];
+  readonly 'bullet-list': readonly ['M9 6h11', 'M9 12h11', 'M9 18h11', 'M4 6h.01', 'M4 12h.01', 'M4 18h.01'];
+  readonly 'numbered-list': readonly ['M10 6h11', 'M10 12h11', 'M10 18h11', 'M4 6h1v3', 'M4 13a1 1 0 0 1 1-1h1v2l-2 2h2', 'M4 17h2v3H4'];
+  readonly 'indent-increase': readonly ['M3 5h18', 'M3 19h18', 'M3 12h9', 'M14 9l4 3-4 3'];
+  readonly 'indent-decrease': readonly ['M3 5h18', 'M3 19h18', 'M3 12h9', 'M18 9l-4 3 4 3'];
+  readonly 'align-left': readonly ['M4 6h16', 'M4 12h10', 'M4 18h14'];
+  readonly 'align-center': readonly ['M4 6h16', 'M7 12h10', 'M6 18h12'];
+  readonly 'align-right': readonly ['M4 6h16', 'M10 12h10', 'M6 18h14'];
+  readonly 'align-justify': readonly ['M4 6h16', 'M4 12h16', 'M4 18h16'];
+  readonly 'align-top': readonly ['M4 4h16', 'M9 9h6v11H9z'];
+  readonly 'align-middle': readonly ['M4 12h16', 'M9 6.5h6v11H9z'];
+  readonly 'align-bottom': readonly ['M4 20h16', 'M9 4h6v11H9z'];
+  readonly 'distribute-h': readonly ['M3 4v16', 'M21 4v16', 'M8 9h3v6H8z', 'M13 9h3v6h-3z'];
+  readonly 'distribute-v': readonly ['M4 3h16', 'M4 21h16', 'M9 8v3h6V8z', 'M9 13v3h6v-3z'];
+  readonly 'flip-h': readonly ['M12 3v18', 'M17 8l3 4-3 4', 'M7 8l-3 4 3 4'];
+  readonly 'flip-v': readonly ['M3 12h18', 'M8 17l4 3 4-3', 'M8 7l4-3 4 3'];
+  readonly group: readonly ['M4 4h10v10H4z', 'M10 10h10v10H10z'];
+  readonly ungroup: readonly ['M4 4h7v7H4z', 'M13 13h7v7h-7z'];
+  readonly 'line-spacing': readonly ['M5 5h14', 'M5 12h14', 'M5 19h14', 'M2 8l0 -5 M2 3l1.5 1.5 M2 3l-1.5 1.5', 'M2 16l0 5 M2 21l1.5 -1.5 M2 21l-1.5 -1.5'];
+  readonly search: readonly ['M11 4a7 7 0 1 0 0 14 7 7 0 0 0 0-14z', 'M21 21l-4.35-4.35'];
+  readonly replace: readonly ['M4 7h11l-3-3', 'M4 7l3 3', 'M20 17H9l3-3', 'M20 17l-3 3'];
+  readonly 'new-slide': readonly ['M4 4h16v16H4z', 'M12 8v8', 'M8 12h8'];
+  readonly layout: readonly ['M4 3h5a1 1 0 0 1 1 1v5a1 1 0 0 1-1 1H4a1 1 0 0 1-1-1V4a1 1 0 0 1 1-1Z', 'M15 3h5a1 1 0 0 1 1 1v5a1 1 0 0 1-1 1h-5a1 1 0 0 1-1-1V4a1 1 0 0 1 1-1Z', 'M15 14h5a1 1 0 0 1 1 1v5a1 1 0 0 1-1 1h-5a1 1 0 0 1-1-1v-5a1 1 0 0 1 1-1Z', 'M4 14h5a1 1 0 0 1 1 1v5a1 1 0 0 1-1 1H4a1 1 0 0 1-1-1v-5a1 1 0 0 1 1-1Z'];
+  readonly 'slide-templates': readonly ['M4 3h16a1 1 0 0 1 1 1v5a1 1 0 0 1-1 1H4a1 1 0 0 1-1-1V4a1 1 0 0 1 1-1Z', 'M4 14h7a1 1 0 0 1 1 1v5a1 1 0 0 1-1 1H4a1 1 0 0 1-1-1v-5a1 1 0 0 1 1-1Z', 'M17 14h3a1 1 0 0 1 1 1v5a1 1 0 0 1-1 1h-3a1 1 0 0 1-1-1v-5a1 1 0 0 1 1-1Z'];
+  readonly table: readonly ['M3 4h18v16H3z', 'M3 10h18', 'M3 16h18', 'M9 4v16', 'M15 4v16'];
+  readonly image: readonly ['M3 4h18v16H3z', 'M8 11a2 2 0 1 0 0-4 2 2 0 0 0 0 4z', 'M4 18l5-5 4 4 3-3 4 4'];
+  readonly video: readonly ['M3 5h13v14H3z', 'M16 10l5-3v10l-5-3z'];
+  readonly 'text-box': readonly ['M4 4h16v16H4z', 'M9 9h6', 'M12 9v7'];
+  readonly chart: readonly ['M3 3v18h18', 'M7 11h3v6H7z', 'M12 7h3v10h-3z', 'M17 13h3v4h-3z'];
+  readonly file: readonly ['M6 2h9l5 5v15H6z', 'M15 2v5h5'];
+  readonly download: readonly ['M12 3v12', 'M7 10l5 5 5-5', 'M5 21h14'];
+  readonly package: readonly ['M21 8l-9 5-9-5', 'M3 8l9-5 9 5v8l-9 5-9-5z', 'M12 13v8'];
+  readonly printer: readonly ['M6 9V3h12v6', 'M6 18H4a1 1 0 0 1-1-1v-6a1 1 0 0 1 1-1h16a1 1 0 0 1 1 1v6a1 1 0 0 1-1 1h-2', 'M6 14h12v7H6z'];
+  readonly square: readonly ['M4 4h16v16H4z'];
+  readonly circle: readonly ['M12 21a9 9 0 1 0 0-18 9 9 0 0 0 0 18z'];
+  readonly triangle: readonly ['M12 3l9 18H3z'];
+  readonly diamond: readonly ['M12 2l10 10-10 10L2 12z'];
+  readonly database: readonly ['M12 5c4.4 0 8-1.1 8-2.5S16.4 0 12 0 4 1.1 4 2.5 7.6 5 12 5z', 'M4 2.5v14c0 1.4 3.6 2.5 8 2.5s8-1.1 8-2.5v-14', 'M4 9c0 1.4 3.6 2.5 8 2.5s8-1.1 8-2.5'];
+  readonly 'move-right': readonly ['M5 12h14', 'M13 6l6 6-6 6'];
+  readonly equation: readonly ['M4 17h6', 'M7 14v6', 'M14 7l4.5 10', 'M15.5 14h5'];
+  readonly 'smart-art': readonly ['M3 3h8v8H3z', 'M13 13h8v8h-8z', 'M11 7h2', 'M17 11v2'];
+  readonly 'action-button': readonly ['M3 3h18v18H3z', 'M13 7l4 5-4 5'];
+  readonly field: readonly ['M4 7h16', 'M4 12h10', 'M4 17h12', 'M19 12a3 3 0 1 0 0 6 3 3 0 0 0 0-6z'];
+  readonly cursor: readonly ['M4 4l7.07 17 2.51-7.39L21 11.07 4 4z'];
+  readonly pen: readonly ['M12 20h9', 'M16.5 3.5a2.12 2.12 0 0 1 3 3L7 19l-4 1 1-4 12.5-12.5z'];
+  readonly highlighter: readonly ['M9 11l-6 6v3h3l9.5-9.5', 'M14.5 4l5.5 5.5-2.5 2.5-5.5-5.5z'];
+  readonly eraser: readonly ['M7 21l-4.3-4.3c-1-1-1-2.5 0-3.4l9.6-9.6c1-1 2.5-1 3.4 0l5.6 5.6c1 1 1 2.5 0 3.4L13 21', 'M22 21H7', 'M5 11l9 9'];
+  readonly menu: readonly ['M4 6h16', 'M4 12h16', 'M4 18h16'];
+  readonly layers: readonly ['M12.83 2.18a2 2 0 0 0-1.66 0L2.6 6.08a1 1 0 0 0 0 1.83l8.58 3.91a2 2 0 0 0 1.66 0l8.58-3.9a1 1 0 0 0 0-1.83z', 'M22 17.65l-9.17 4.16a2 2 0 0 1-1.66 0L2 17.65', 'M22 12.65l-9.17 4.16a2 2 0 0 1-1.66 0L2 12.65'];
+  readonly sliders: readonly ['M20 7h-9', 'M14 17H5', 'M17 14a3 3 0 1 0 0 6 3 3 0 0 0 0-6z', 'M7 4a3 3 0 1 0 0 6 3 3 0 0 0 0-6z'];
+  readonly 'panel-left': readonly ['M4 4h16v16H4z', 'M9 4v16'];
+  readonly 'panel-right': readonly ['M4 4h16v16H4z', 'M15 4v16'];
+  readonly 'sticky-note': readonly ['M5 4h14v10l-6 6H5z', 'M13 20v-6h6'];
+  readonly monitor: readonly ['M3 5h18v12H3z', 'M8 21h8', 'M12 17v4'];
+  readonly presentation: readonly ['M3 4h18', 'M5 4h14v11H5z', 'M12 15v3', 'M9 21l3-3 3 3'];
+  readonly columns: readonly ['M4 4h16v16H4z', 'M12 4v16'];
+  readonly comment: readonly ['M21 15a2 2 0 0 1-2 2H7l-4 4V5a2 2 0 0 1 2-2h14a2 2 0 0 1 2 2z'];
+  readonly settings: readonly ['M12.22 2h-.44a2 2 0 0 0-2 2v.18a2 2 0 0 1-1 1.73l-.43.25a2 2 0 0 1-2 0l-.15-.08a2 2 0 0 0-2.73.73l-.22.38a2 2 0 0 0 .73 2.73l.15.1a2 2 0 0 1 1 1.72v.51a2 2 0 0 1-1 1.74l-.15.09a2 2 0 0 0-.73 2.73l.22.38a2 2 0 0 0 2.73.73l.15-.08a2 2 0 0 1 2 0l.43.25a2 2 0 0 1 1 1.73V20a2 2 0 0 0 2 2h.44a2 2 0 0 0 2-2v-.18a2 2 0 0 1 1-1.73l.43-.25a2 2 0 0 1 2 0l.15.08a2 2 0 0 0 2.73-.73l.22-.39a2 2 0 0 0-.73-2.73l-.15-.08a2 2 0 0 1-1-1.74v-.5a2 2 0 0 1 1-1.74l.15-.09a2 2 0 0 0 .73-2.73l-.22-.38a2 2 0 0 0-2.73-.73l-.15.08a2 2 0 0 1-2 0l-.43-.25a2 2 0 0 1-1-1.73V4a2 2 0 0 0-2-2z', 'M12 9a3 3 0 1 0 0 6 3 3 0 0 0 0-6z'];
+  readonly 'folder-plus': readonly ['M20 20a2 2 0 0 0 2-2V8a2 2 0 0 0-2-2h-7.9a2 2 0 0 1-1.69-.9L9.6 3.9A2 2 0 0 0 7.93 3H4a2 2 0 0 0-2 2v13a2 2 0 0 0 2 2z', 'M12 10v6', 'M9 13h6'];
+  readonly ellipsis: readonly ['M5 12h.01', 'M12 12h.01', 'M19 12h.01'];
+  readonly sparkles: readonly ['M12 3l1.9 4.6L18.5 9.5l-4.6 1.9L12 16l-1.9-4.6L5.5 9.5l4.6-1.9L12 3z', 'M19 15l.9 2.1L22 18l-2.1.9L19 21l-.9-2.1L16 18l2.1-.9L19 15z'];
+  readonly send: readonly ['M22 2L11 13', 'M22 2l-7 20-4-9-9-4 20-7z'];
+  readonly eye: readonly ['M2 12s3.5-7 10-7 10 7 10 7-3.5 7-10 7-10-7-10-7z', 'M12 9a3 3 0 1 0 0 6 3 3 0 0 0 0-6z'];
+  readonly 'eye-off': readonly ['M17.94 17.94A10.07 10.07 0 0 1 12 20c-7 0-11-8-11-8a18.45 18.45 0 0 1 5.06-5.94', 'M9.9 4.24A9.12 9.12 0 0 1 12 4c7 0 11 8 11 8a18.5 18.5 0 0 1-2.16 3.19', 'M14.12 14.12a3 3 0 1 1-4.24-4.24', 'M1 1l22 22'];
+  readonly wrench: readonly ['M14.7 6.3a1 1 0 0 0 0 1.4l1.6 1.6a1 1 0 0 0 1.4 0l3.77-3.77a6 6 0 0 1-7.94 7.94l-6.91 6.91a2.12 2.12 0 0 1-3-3l6.91-6.91a6 6 0 0 1 7.94-7.94z'];
+  readonly check: readonly ['M20 6L9 17l-5-5'];
+  readonly alert: readonly ['M10.3 3.9 1.8 18a2 2 0 0 0 1.7 3h17a2 2 0 0 0 1.7-3L13.7 3.9a2 2 0 0 0-3.4 0z', 'M12 9v4', 'M12 17h.01'];
+  readonly close: readonly ['M18 6L6 18', 'M6 6l12 12'];
+  readonly crosshair: readonly ['M12 3a9 9 0 1 0 0 18 9 9 0 0 0 0-18z', 'M12 2v4', 'M12 18v4', 'M2 12h4', 'M18 12h4'];
+  readonly history: readonly ['M3 12a9 9 0 1 0 9-9 9.75 9.75 0 0 0-6.74 2.74L3 8', 'M3 3v5h5', 'M12 7v5l4 2'];
+  readonly timer: readonly ['M10 2h4', 'M12 14l3-3', 'M12 22a8 8 0 1 0 0-16 8 8 0 0 0 0 16z'];
+  readonly link: readonly ['M10 13a5 5 0 0 0 7.54.54l3-3a5 5 0 0 0-7.07-7.07l-1.72 1.71', 'M14 11a5 5 0 0 0-7.54-.54l-3 3a5 5 0 0 0 7.07 7.07l1.71-1.71'];
+  readonly 'git-merge': readonly ['M3 6a3 3 0 1 0 6 0 3 3 0 1 0 -6 0', 'M15 18a3 3 0 1 0 6 0 3 3 0 1 0 -6 0', 'M6 9v6', 'M6 15a6 6 0 0 0 6 6h3'];
+  readonly pin: readonly ['M12 17v5', 'M9 10.5V4h-1a1 1 0 0 1 0-2h8a1 1 0 0 1 0 2h-1v6.5l2 2.5H7z'];
+  readonly 'pin-off': readonly ['M12 17v5', 'M9 10.5V4h-1a1 1 0 0 1 0-2h8a1 1 0 0 1 0 2h-1v6.5l2 2.5H7z', 'M3 3l18 18'];
+  readonly bug: readonly ['M12 8a4 4 0 0 0-4 4v3a4 4 0 0 0 8 0v-3a4 4 0 0 0-4-4z', 'M9 6l1.5 1.5', 'M15 6l-1.5 1.5', 'M6 12H4', 'M20 12h-2', 'M6 16H4', 'M20 16h-2', 'M12 20v-8'];
+  readonly 'circle-pause': readonly ['M12 3a9 9 0 1 0 0 18 9 9 0 0 0 0-18z', 'M10 9v6', 'M14 9v6'];
+  readonly 'circle-play': readonly ['M12 3a9 9 0 1 0 0 18 9 9 0 0 0 0-18z', 'M10 8l6 4-6 4z'];
+  readonly 'rotate-ccw': readonly ['M3 12a9 9 0 1 0 9-9 9.75 9.75 0 0 0-6.74 2.74L3 8', 'M3 3v5h5'];
+  readonly 'grid-2x2': readonly ['M3 3h18v18H3z', 'M12 3v18', 'M3 12h18'];
+  readonly scan: readonly ['M3 8V5a2 2 0 0 1 2-2h3', 'M16 3h3a2 2 0 0 1 2 2v3', 'M21 16v3a2 2 0 0 1-2 2h-3', 'M8 21H5a2 2 0 0 1-2-2v-3'];
+  readonly 'mouse-pointer-2': readonly ['M4 3l7 17 2.5-6.5L20 11z'];
+  readonly captions: readonly ['M3 5h18v14H3z', 'M7 12h3', 'M14 12h3'];
+  readonly 'monitor-off': readonly ['M3 5h13', 'M21 5v9', 'M3 5v9h11', 'M8 21h8', 'M12 17v4', 'M3 3l18 18'];
+  readonly 'arrow-left-right': readonly ['M8 3L4 7l4 4', 'M4 7h16', 'M16 13l4 4-4 4', 'M20 17H4'];
+  readonly lock: readonly ['M3 11h18v11H3z', 'M7 11V7a5 5 0 0 1 10 0v4'];
+  readonly 'lock-open': readonly ['M3 11h18v11H3z', 'M7 11V7a5 5 0 0 1 9.9-1'];
+  readonly paintbrush: readonly ['m14.622 17.897-10.68-2.913', 'M18.376 2.622a1 1 0 1 1 3.002 3.002L17.36 9.643a.5.5 0 0 0 0 .707l.944.944a2.41 2.41 0 0 1 0 3.408l-.944.944a.5.5 0 0 1-.707 0L8.354 7.348a.5.5 0 0 1 0-.707l.944-.944a2.41 2.41 0 0 1 3.408 0l.944.944a.5.5 0 0 0 .707 0z', 'M9 8c-1.804 2.71-3.97 3.46-6.583 3.948a.507.507 0 0 0-.302.819l7.32 8.883a1 1 0 0 0 1.185.204C12.735 20.405 16 16.792 16 15'];
+  readonly filter: readonly ['M10 20a1 1 0 0 0 .553.895l2 1A1 1 0 0 0 14 21v-7a2 2 0 0 1 .517-1.341L21.74 4.67A1 1 0 0 0 21 3H3a1 1 0 0 0-.742 1.67l7.225 7.989A2 2 0 0 1 10 14z'];
+  readonly 'merge-shapes': readonly ['M3 3h12v12H3z', 'M9 9h12v12H9z'];
+  readonly crop: readonly ['M6 2v14a2 2 0 0 0 2 2h14', 'M18 22V8a2 2 0 0 0-2-2H2'];
+};
+type IconName = keyof typeof ICON_PATHS;
+//#endregion
+//#region src/viewer/ui/icons.d.ts
+/** Build a 16x16 stroked icon `<svg>` for the given name. */
+declare function createIcon(doc: Document, name: IconName): SVGSVGElement;
+//#endregion
+//#region src/viewer/ui/controls.d.ts
+/**
+ * Small reusable DOM control builders for the editing chrome (format toolbar +
+ * inspector). Each returns the element plus an imperative handle so the editor
+ * can enable/disable and reflect the selected element's values without a
+ * framework. Pure DOM assembly; all behaviour is the caller's `on*` handlers.
+ */
+interface ButtonOptions {
+  label: string;
+  icon?: IconName;
+  /** Short text glyph when no icon (e.g. "B" for bold). */
+  text?: string;
+  /**
+   * Visible text label rendered next to the icon; turns the fixed-size icon
+   * button into a React-style labelled pill (`.pptxv-btn-pill`).
+   */
+  textLabel?: string;
+  /** Extra class on the button (e.g. for a bold/italic glyph style). */
+  className?: string;
+  onClick(): void;
+}
+interface ButtonHandle {
+  btn: HTMLButtonElement;
+  setActive(active: boolean): void;
+  setDisabled(disabled: boolean): void;
+}
+/** Build an icon/glyph button labelled (title + aria-label) via `label`. */
+declare function makeButton(doc: Document, options: ButtonOptions): ButtonHandle;
+interface ColorControlOptions {
+  label: string;
+  /** Fired on every colour change (native `<input type=color>` input event). */
+  onInput(hex: string): void;
+  /**
+   * B6: fired once the picker COMMITS (native `change`), separate from the
+   * continuous `onInput` a drag through the OS colour picker fires. Wired by
+   * callers to `InspectorHandlers.pushRecentColor` so the "Recent colours"
+   * MRU list grows once per pick rather than on every drag tick.
+   */
+  onCommit?(hex: string): void;
+}
+interface ColorControlHandle {
+  el: HTMLElement;
+  setValue(hex: string | undefined): void;
+  setDisabled(disabled: boolean): void;
+}
+/**
+ * A labelled colour swatch backed by a native `<input type="color">`. The
+ * visible swatch shows the current colour; clicking it opens the OS picker.
+ */
+declare function makeColorControl(doc: Document, options: ColorControlOptions, fallback?: string): ColorControlHandle;
+interface NumberFieldOptions {
+  label: string;
+  min?: number;
+  max?: number;
+  step?: number;
+  /** Fired on commit (Enter / change / blur) with the parsed number. */
+  onCommit(value: number): void;
+}
+interface NumberFieldHandle {
+  el: HTMLElement;
+  input: HTMLInputElement;
+  setValue(value: number): void;
+  setDisabled(disabled: boolean): void;
+}
+/**
+ * A compact labelled numeric field. Commits on change/blur/Enter (never per
+ * keystroke), so typing "-12" isn't committed digit-by-digit. The label text is
+ * shown before the input (e.g. "X", "W").
+ */
+declare function makeNumberField(doc: Document, options: NumberFieldOptions): NumberFieldHandle;
+//#endregion
+//#region src/viewer/ui/dropdown.d.ts
+/** One selectable entry in a {@link makeDropdown} menu. */
+interface DropdownItem<T> {
+  label: string;
+  value: T;
+  /** Optional inline style applied to the item's label (e.g. `fontFamily`). */
+  style?: Partial<CSSStyleDeclaration>;
+  /**
+   * Renders a non-selectable heading above this item, starting a group.
+   *
+   * Used by the Home tab's font dropdown, which PowerPoint splits into theme
+   * fonts / embedded / added-this-session / all.
+   */
+  groupLabel?: string;
+  /** Trailing hint shown after the label (e.g. the theme role "Headings"). */
+  hint?: string;
+}
+interface DropdownOptions<T> {
+  /** Accessible label / title for the trigger button. */
+  triggerLabel: string;
+  /** Visible text on the trigger button (kept in sync via `setTriggerText`). */
+  triggerText: string;
+  items: ReadonlyArray<DropdownItem<T>>;
+  onSelect(value: T): void;
+  /** Trailing chevron icon; defaults to `'chevron-down'`. */
+  icon?: IconName;
+  /**
+   * Use a trigger the host already renders (a shared Home button): no trigger
+   * is built, `el` holds only the menu and is appended inside `anchor`'s
+   * wrapper, and the menu opens through `toggle()`.
+   */
+  external?: {
+    anchor(): HTMLElement | undefined;
+    onOpenChange?(open: boolean): void;
+  };
+}
+interface DropdownHandle<T> {
+  el: HTMLElement;
+  /** Open or close the menu (the only way to open an external-trigger menu). */
+  toggle(): void;
+  setDisabled(disabled: boolean): void;
+  setTriggerText(text: string): void;
+  /** Replace the whole item list (the font dropdown regroups per deck). */
+  setItems(items: ReadonlyArray<DropdownItem<T>>): void;
+  /** Highlight the item matching `value` (adds `is-selected`); pass `undefined` to clear. */
+  setSelected(value: T | undefined): void;
+  close(): void;
+}
+/**
+ * A small popover dropdown: a pill trigger button that opens a scrollable list
+ * of items on click, closing on selection or an outside pointerdown. Shared by
+ * every ribbon group that needs a labelled choice list (font family/size, line
+ * spacing, character spacing, change case, ...).
+ */
+declare function makeDropdown<T>(doc: Document, options: DropdownOptions<T>): DropdownHandle<T>;
+//#endregion
+//#region src/viewer/ui/element-context-menu-commands.d.ts
+/** The AI hooks the two AI entries need (structurally the `AiFocusController`). */
+interface ContextMenuAiHooks {
+  askAboutSelection(): void;
+  fixElement(element: PptxElement | null, slideIndex: number): void;
+}
+/** The table cell the menu was opened on, plus what the shared builder asks about it. */
+interface ContextMenuTableTarget {
+  cell: TableCellPosition;
+  context: ContextMenuTableContext;
+}
+interface ContextMenuCommandDeps {
+  doc: Document;
+  store: Store<ViewerState>;
+  getEditActions(): EditActions;
+  /** Slide review comments (React's context-menu "Add Comment" opens the same surface). */
+  openComments(): void;
+  /** Hyperlink dialog for the selected element. */
+  openHyperlink(): void;
+  /** AI focus controller when the host configured `ai`, otherwise null. */
+  getAi(): ContextMenuAiHooks | null;
+  /** Enter Edit Points on a shape (omitted: the entry does nothing). */
+  startEditPoints?(elementId: string): boolean;
+}
+/** The `{row, column}` a right-click landed on, when it landed inside a table cell. */
+declare function readTableCellTarget(target: EventTarget | null): TableCellPosition | null;
+/**
+ * The table context for the right-clicked element, or null when this is not a
+ * table cell. The cell under the cursor wins over the stored selection so the
+ * commands act on what the user actually aimed at.
+ */
+declare function resolveTableTarget(state: ViewerState, element: PptxElement | null, target: EventTarget | null): ContextMenuTableTarget | null;
+/** Run `id` against the live editor actions. Table commands no-op without a cell. */
+declare function runContextMenuCommand(id: ContextMenuCommandId, deps: ContextMenuCommandDeps, table: ContextMenuTableTarget | null): void;
+//#endregion
+//#region src/viewer/ui/element-context-menu.d.ts
+interface ElementContextMenuDeps extends ContextMenuCommandDeps {
+  doc: Document;
+  /**
+   * Live translator getter, not a value: `setLocale` swaps the viewer's
+   * translator, and a captured copy would keep labelling the menu in the old
+   * language for the rest of the session.
+   */
+  getTranslator(): Translator;
+  /** The scrollable viewport that contains the stage. */
+  viewport: HTMLElement;
+  /** The live `.pptxv-stage` node, or null (rebuilt on every render). */
+  getStageRoot(): HTMLElement | null;
+  /** Make `id` the selection before a command acts on it. */
+  selectElement(id: string): void;
+  /** The host's resolved UI customisation, read at open time (omitted: none). */
+  getCustomization?(): ResolvedCustomization$1;
+}
+interface ElementContextMenu {
+  destroy(): void;
+}
+/** Attach the element context menu to the editing canvas. */
+declare function mountElementContextMenu(deps: ElementContextMenuDeps): ElementContextMenu;
+//#endregion
+//#region src/viewer/ui/presentation-context-menu.d.ts
+interface PresentationContextMenuDeps {
+  doc: Document;
+  store: Store<ViewerState>;
+  /** The element the menu is mounted under (the `.pptxv` root). */
+  root: HTMLElement;
+  getTranslator(): Translator;
+  /** File > Options > Advanced > "Show menu on right mouse click". */
+  shouldShow(): boolean;
+  next(): void;
+  prev(): void;
+  exitPresentation(): void;
+  showAllSlides(): void;
+  togglePresenterView(): void;
+  setPointerTool(tool: 'none' | 'pen' | 'highlighter' | 'laser'): void;
+  eraseAnnotations(): void;
+  toggleBlank(value: 'black' | 'white'): void;
+}
+interface PresentationContextMenu {
+  destroy(): void;
+}
+/** Attach the slide-show right-click menu to the presentation root. */
+declare function mountPresentationContextMenu(deps: PresentationContextMenuDeps): PresentationContextMenu;
+//#endregion
+//#region src/viewer/ui/keyboard.d.ts
+interface KeyboardHandlers {
+  next(): void;
+  prev(): void;
+  first(): void;
+  last(): void;
+  /** Invoked on Escape (used to exit presentation mode). */
+  escape(): void;
+  /** True while a slide show is running; gates the show-only shortcuts. */
+  isPresenting?(): boolean;
+  /** Jump to a zero-based slide index (typed slide number during a show). */
+  goToSlide?(index: number): void;
+  /** Number of slides, so a typed slide number can be range-checked. */
+  getSlideCount?(): number;
+  /** Select a pointer tool (Ctrl+L / Ctrl+P / Ctrl+A / Ctrl+E). */
+  setPointerTool?(tool: PresentationPointerTool): void;
+  /** Erase the show's ink annotations (E). */
+  eraseAnnotations?(): void;
+  /** Show or hide ink markup (Ctrl+M). */
+  toggleInkMarkup?(): void;
+  /** Blank the screen black or white (B / W, or `.` / `,`). */
+  toggleBlank?(value: 'black' | 'white'): void;
+  /** Show or hide live captions (PowerPoint's bare `J`). */
+  toggleSubtitles?(): void;
+  /** Show or hide the running show's own chrome (Ctrl+H). */
+  toggleChrome?(): void;
+  /** Raise PowerPoint's "See All Slides" navigator (Ctrl+S). */
+  showAllSlides?(): void;
+  /** Bare F5: the exact entry point the ribbon's "From Beginning" button calls. */
+  startFromBeginning?(): void;
+  /** Shift+F5: the exact entry point the ribbon's "From Current Slide" button calls. */
+  startFromCurrent?(): void;
+  /** False when the host switched the slide show off: F5 / Shift+F5 then fall through. */
+  isSlideShowStartEnabled?(): boolean;
+}
+/**
+ * Attach slideshow keyboard navigation to the viewer root.
+ *
+ * While a show is running the full PowerPoint shortcut set applies, resolved by
+ * the shared slide-show map. Outside a show only the arrows, Page keys, Home,
+ * End and Escape navigate: PowerPoint's bare-letter commands (N, P, B, W, E)
+ * belong to the show, and binding them in the editor would hijack typing.
+ *
+ * Returns a detach function. Keys originating from form fields are ignored.
+ */
+declare function attachKeyboardNavigation(root: HTMLElement, handlers: KeyboardHandlers): () => void;
+//#endregion
+//#region src/viewer/ui/touch-gestures.d.ts
+interface TouchGestureHandlers {
+  /** Read the current effective scale, including fit-to-viewport resolution. */
+  getScale(): number;
+  /** Persist a concrete scale after a two-finger pinch. */
+  onPinchZoom(scale: number): void;
+  /** Whether a one-finger swipe may change slides at this moment. */
+  isSwipeEnabled(): boolean;
+  onNext(): void;
+  onPrevious(): void;
+}
+/**
+ * Attach React-parity touch gestures to the stable viewport node. Pinching is
+ * available in every mode; slide swipes deliberately stay disabled while
+ * editing so they cannot steal element move/resize gestures.
+ */
+declare function attachTouchGestures(target: HTMLElement, handlers: TouchGestureHandlers): () => void;
 //#endregion
 //#region src/viewer/ui/presentation.d.ts
 interface PresentationController {
@@ -2293,6 +2751,200 @@ interface PresentationController {
   /** Remove listeners. */
   dispose(): void;
 }
+/**
+ * Presentation mode over the real Fullscreen API. `onChange` fires for every
+ * transition, including user-initiated exits (Esc, browser chrome), driven by
+ * the `fullscreenchange` event rather than the promise result.
+ *
+ * In environments without the Fullscreen API (older browsers, tests) it
+ * degrades to a plain state toggle so the viewer still hides its chrome.
+ */
+declare function createPresentationController(target: HTMLElement, onChange: (presenting: boolean) => void): PresentationController;
+//#endregion
+//#region src/viewer/ui/ribbon/find-replace-panel.d.ts
+interface FindReplacePanel {
+  el: HTMLElement;
+  toggle(): void;
+  setOpen(open: boolean): void;
+  isOpen(): boolean;
+  setEditable(editable: boolean): void;
+}
+/**
+ * A simple docked Find & Replace panel (query + replacement + match-case
+ * toggle + Find/Replace/Replace All), backed by the shared `find-replace.ts`
+ * helpers via {@link FindReplaceActions}. No in-canvas match highlighting or
+ * next/previous cursor (see that module's docs); status text reports the
+ * match count / replacement count instead.
+ */
+declare function createFindReplacePanel(doc: Document, t: Translator, actions: FindReplaceActions): FindReplacePanel;
+//#endregion
+//#region src/viewer/ui/ribbon/ribbon-tab-bar.d.ts
+interface RibbonTabBar {
+  el: HTMLElement;
+  setActive(tab: RibbonTabId | RibbonContextualTabId): void;
+  /**
+   * Show the selection's contextual tabs (Shape Format, Picture Format, ...)
+   * after the fixed tabs, PowerPoint-style.
+   */
+  setContextualTabs(tabs: readonly RibbonContextualTabId[]): void;
+  /** Hide/show tab buttons per Options > Customize Ribbon (File always shown). */
+  setHiddenTabs(hidden: ReadonlySet<string>): void;
+  /** Set each tab's `title` from a ScreenTip resolver (Options > General). */
+  applyScreenTips(resolve: (label: string) => string | undefined): void;
+}
+/** Right-side quick actions on the tab row (React's `TabRowActions`). */
+interface RibbonTabBarActions {
+  /** The red-dot Record button (starts rehearsal/recording). */
+  startRecording(): void;
+}
+/**
+ * The ribbon's tab strip (File/Home/Insert/.../View), à la React's ribbon tab
+ * row. Tabs in `hiddenActions` are never constructed, matching how the ribbon
+ * itself skips building content for a hidden tab. The right side carries the
+ * Record button plus a `.pptxv-tabrow-actions` host the collaboration UI
+ * mounts its Share trigger into (see `collab/collab-ui.ts`).
+ */
+declare function createRibbonTabBar(doc: Document, t: Translator, onSelect: (tab: RibbonTabId | RibbonContextualTabId) => void, hiddenActions?: readonly ToolbarActionId$1[], actions?: RibbonTabBarActions): RibbonTabBar;
+//#endregion
+//#region src/viewer/ui/ribbon/ribbon-tabs.d.ts
+/**
+ * The ribbon tab registry: id + i18n label key, in display order.
+ *
+ * Mirrors React's `TOOLBAR_SECTIONS` (see `packages/react/src/viewer/constants/toolbar.ts`)
+ * tab order/labels, but this wave only implements content for `file` / `home`
+ * / `insert` / `draw` / `design` / `transitions` / `animations` / `view`. The
+ * remaining entries are commented out rather than omitted so a later wave
+ * adds one registry line + one tab-content module per tab, matching this
+ * file's shape.
+ *
+ * Ids here are the ribbon-tab subset of the shared `ToolbarTabId` (see
+ * `pptx-viewer-shared`'s `toolbar-actions.ts`); `createRibbon` filters this
+ * list through `filterVisibleTabs` so a host's `hiddenActions` option skips
+ * building a hidden tab's content entirely, rather than hiding it after the
+ * fact.
+ */
+interface RibbonTabDef {
+  id: RibbonTabId;
+  labelKey: string;
+}
+declare const RIBBON_TABS: readonly RibbonTabDef[];
+/** The default active tab on mount. */
+declare const DEFAULT_RIBBON_TAB: RibbonTabId;
+/** True when `id` is a known ribbon tab (guards persisted/host-supplied tab ids). */
+declare function isRibbonTab(id: string): id is RibbonTabId;
+//#endregion
+//#region src/viewer/ui/swatch-picker.d.ts
+/**
+ * Office "Standard Colors" swatch set, shared by both the font-colour and
+ * highlight-colour pickers (`pptx-viewer-shared`'s canonical catalogue, so
+ * this binding cannot drift from the others' standard-colour row).
+ */
+declare const OFFICE_STANDARD_SWATCHES: readonly string[];
+interface SwatchPickerOptions {
+  /** Accessible label / title for the trigger button. */
+  label: string;
+  /** Icon shown in the trigger (a small colour bar under it reflects the value). */
+  icon: IconName;
+  swatches: readonly string[];
+  /** Fallback colour when no value is set yet. */
+  fallback: string;
+  onSelect(hex: string): void;
+  /**
+   * Fired ONLY by a theme-swatch click, carrying both the hex and the ref.
+   * Provide alongside `themeColorMap` to show the deck's real "Theme Colors"
+   * grid above the standard swatches (font colour only: highlight colour has
+   * no theme-ref concept on the model).
+   */
+  onSelectTheme?(commit: ThemeColorPickerCommit): void;
+  /** As `DropdownOptions.external`: the trigger is a shared Home button. */
+  external?: {
+    anchor(): HTMLElement | undefined;
+    onOpenChange?(open: boolean): void;
+  };
+}
+interface SwatchPickerHandle {
+  el: HTMLElement;
+  /** Open or close the menu (the only way to open an external-trigger picker). */
+  toggle(): void;
+  setValue(hex: string | undefined): void;
+  setDisabled(disabled: boolean): void;
+  /** B6: refresh the "Recent colours" row (most-recent-first); hidden when empty. */
+  setRecentColors(colors: readonly string[]): void;
+  /** Set the deck's theme colour map; the theme-swatch grid hides itself when `undefined`. */
+  setThemeColorMap(themeColorMap: Record<string, string> | undefined): void;
+  /** Highlight the swatch matching the element's current theme ref, if any. */
+  setSelectedRef(ref: PptxThemeColorRef | undefined): void;
+}
+/**
+ * A reusable swatch-grid colour picker: a small pill trigger (icon + a
+ * colour-bar swab of the current value) that opens a grid of preset swatches
+ * plus a "Custom colour..." row backed by a native `<input type="color">`.
+ * Used by the ribbon's font-colour and highlight-colour controls (upgrading
+ * them from the bare native colour input the format toolbar used).
+ */
+declare function makeSwatchPicker(doc: Document, t: Translator, options: SwatchPickerOptions): SwatchPickerHandle;
+//#endregion
+//#region src/viewer/ui/ruler-strips.d.ts
+/**
+ * The View > Rulers strips: a horizontal ruler along the top of the slide, a
+ * vertical one down the left, and the corner square where they meet.
+ *
+ * Drawn as SIBLINGS of the scaled stage (inside `.pptxv-stage-wrap`, in the
+ * gutter the `pptxv-showRulers` rule opens up around it) rather than inside it,
+ * because the stage carries a CSS `transform: scale()`: a ruler inside it would
+ * have its tick strokes and labels scaled by the zoom instead of tracking it.
+ * The strips therefore receive the scale and lay their ticks out in
+ * already-scaled screen px.
+ *
+ * Tick geometry comes from the shared `generateTicks` and a drag off a strip is
+ * resolved by the shared `rulerDragToGuidePosition`, so this binding agrees
+ * with React, Vue, Angular and Svelte on unit, subdivision density, label
+ * thinning and the guide-drop rules. Vanilla previously faked the whole feature
+ * with a flat 18px border on the stage wrap: no ticks, no labels, no guides.
+ */
+/** Selected element extent (unscaled slide px) shaded on both strips. */
+interface RulerSelection {
+  x: number;
+  y: number;
+  width: number;
+  height: number;
+}
+interface RulerStripsState {
+  /** View > Rulers, minus presentation mode (rulers are an editing aid). */
+  visible: boolean;
+  canvasSize: CanvasSize;
+  /** Effective stage scale (fit * zoom). */
+  scale: number;
+  unit: RulerUnit;
+  selection: RulerSelection | null;
+  /** Offer the drag-out-a-guide gesture (editable canvases only). */
+  draggable: boolean;
+}
+interface RulerStrips {
+  /**
+   * Attach the strips to the stage wrap. Re-callable: the wrap's children are
+   * replaced on every stage render, so the strips must be re-appended after it.
+   */
+  mount(stageWrap: HTMLElement): void;
+  /** Repaint from the current state (hides the strips when not visible). */
+  update(state: RulerStripsState): void;
+  destroy(): void;
+}
+declare function createRulerStrips(doc: Document, onCreateGuide: (axis: 'h' | 'v', position: number) => void): RulerStrips;
+//#endregion
+//#region src/viewer/ui/protected-view-banner.d.ts
+/**
+ * PowerPoint's Protected View bar: a persistent strip below the Ribbon while
+ * Trust Center > "Open documents in Protected View" is holding a freshly
+ * opened deck read-only, with the one real "Enable Editing" affordance that
+ * lifts it for the rest of the session. See `shouldOpenInProtectedView` and
+ * `ViewerState.protectedView`.
+ */
+interface ProtectedViewBanner {
+  el: HTMLElement;
+  setActive(active: boolean): void;
+}
+declare function createProtectedViewBanner(doc: Document, t: Translator, onEnableEditing: () => void): ProtectedViewBanner;
 //#endregion
 //#region src/viewer/animation/presentation-playback.d.ts
 /** Everything the controller needs after a stage (re)render. */
@@ -2400,6 +3052,101 @@ interface PresentationPlayback {
 }
 //#endregion
 //#region src/viewer/render-controller.d.ts
+interface RenderControllerDeps {
+  doc: Document;
+  store: Store<ViewerState>;
+  registry: index_d_exports$1.ElementRendererRegistry;
+  /**
+   * Getters, not plain booleans, so chrome/translator swaps (setLocale) and
+   * the six 3D flags below are picked up live.
+   */
+  getChrome(): ViewerChrome;
+  getTranslator(): Translator;
+  getFitOptions?(): ViewportFitOptions$1;
+  /**
+   * Opt-in WebGL SmartArt renderer flag; see `PptxViewerOptions.smartArt3D`.
+   * Already ANDed with Options > Advanced > "Disable 3D rendering" by the
+   * caller (see `resolve3DRenderingFlags`), so this getter alone decides
+   * whether the WebGL scene renders.
+   */
+  getSmartArt3D(): boolean;
+  /**
+   * Opt-in interactive WebGL surface-chart renderer flag; see
+   * `PptxViewerOptions.surfaceChart3D`. Same "already ANDed" note as
+   * `getSmartArt3D`.
+   */
+  getSurfaceChart3D(): boolean;
+  /**
+   * Opt-in interactive WebGL bar3D-chart renderer flag; see
+   * `PptxViewerOptions.barChart3D`. Same "already ANDed" note as
+   * `getSmartArt3D`.
+   */
+  getBarChart3D(): boolean;
+  /**
+   * Opt-in interactive WebGL line3D-chart renderer flag; see
+   * `PptxViewerOptions.lineChart3D`. Same "already ANDed" note as
+   * `getSmartArt3D`.
+   */
+  getLineChart3D(): boolean;
+  /**
+   * Opt-in interactive WebGL area3D-chart renderer flag; see
+   * `PptxViewerOptions.areaChart3D`. Same "already ANDed" note as
+   * `getSmartArt3D`.
+   */
+  getAreaChart3D(): boolean;
+  /**
+   * Opt-in interactive WebGL pie3D-chart renderer flag; see
+   * `PptxViewerOptions.pieChart3D`. Same "already ANDed" note as
+   * `getSmartArt3D`.
+   */
+  getPieChart3D(): boolean;
+  /**
+   * `viewerOptions.advanced.pixelateMosaicAnimation`. `true` plays the
+   * blocky mosaic reveal for `p:animEffect/@filter="pixelate"`; `false`
+   * (the default, matching PowerPoint's own behaviour) snaps the element
+   * to its end state. See `resolveFilterEffect`'s doc in
+   * `pptx-viewer-shared`'s `animation-filter-effects.ts`.
+   */
+  getPixelateMosaicAnimation(): boolean;
+  /** History-integrated handout master layout mutation. */
+  onHandoutSlidesPerPageChange(count: number): void;
+  onMasterBackgroundColorChange(color: string): void;
+  /** Run a Slide Master view sidebar CRUD command (B4). */
+  onMasterCrudAction(id: MasterViewCrudActionId): void;
+  onSectionToggle(sectionId: string): void;
+  onSectionRename(sectionId: string, name: string): void;
+  onSectionDelete(sectionId: string): void;
+  onSectionMove(sectionId: string, direction: 'up' | 'down'): void;
+  onSectionAddAfter(slideIndex: number): void;
+  /** Navigate from a presentation Zoom tile. */
+  onZoomClick(target: ZoomNavigationTarget, returnSlideIndex: number): void;
+  /** A canvas comment marker dot was clicked; bring the comments UI on screen. */
+  onCommentMarkerClick?(commentId: string): void;
+  onSmartArtNodeTextChange?(element: PptxElement, nodeId: string, text: string): void;
+  onSmartArtNodeFillChange?(element: PptxElement, nodeId: string, fill: string): void;
+  /**
+   * Commit a chart data point dragged on the canvas. Gated on `interactive`
+   * below with the SmartArt hooks, so thumbnails, the presenter console and
+   * export rasters never arm the chart marks.
+   */
+  onChartPointChange?(element: PptxElement, chartData: PptxChartData): void;
+  /**
+   * A table column/row boundary was dragged on the canvas. Gated on
+   * `interactive` with the other on-canvas edit hooks.
+   */
+  onTableResizeColumns?(element: PptxElement, widths: number[]): void;
+  onTableResizeRow?(element: PptxElement, rowIndex: number, height: number): void;
+  /**
+   * A chart part was pressed on the canvas. Gated on `interactive` with the
+   * other chart/SmartArt hooks. See `ElementRenderContext.onChartPartSelect`.
+   */
+  onChartPartSelect?(element: PptxElement, part: ChartPartRef): void;
+  /**
+   * Invoked after every stage render (the stage host is rebuilt with
+   * `replaceChildren`); the editor re-mounts its overlay layer here.
+   */
+  onStageRendered?(): void;
+}
 interface RenderController {
   /** Re-render everything (used after a chrome rebuild). */
   renderAll(): void;
@@ -2431,265 +3178,12 @@ interface RenderController {
    */
   readonly presentationPlayback: PresentationPlayback;
 }
-//#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.
+ * The DOM render orchestration for {@link PptxViewer}: turns store state into
+ * stage / thumbnail / toolbar updates. Split from the class to keep both
+ * halves small; it owns no state of its own.
  */
-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 ../shared/dist/i18n/index.d.ts
-//#region src/i18n/translations-en.d.ts
-/**
- * The canonical English UI-string dictionary for pptx-viewer. None of the
- * React/Vue/Angular binding packages ship translations themselves - each
- * only calls its framework's translation function (react-i18next's `t()`,
- * vue-i18n's `t()`, ngx-translate's `TranslateService`/`translate` pipe)
- * against dotted `pptx.*` keys. The host app supplies the dictionary; this
- * module is that dictionary for the demos, shared so all three stay in sync
- * instead of drifting into three separate copies.
- */
-export declare const translationsEn: Record<string, string>;
-/**
- * Every key in the English dictionary. A new locale dictionary typed as
- * `Record<TranslationKey, string>` gets a compile error for any key it's
- * missing or misspells, so translation contributions stay complete without a
- * separate parity test.
- */
-type TranslationKey = keyof typeof translationsEn;
-/**
- * Convert a dotted translation key to a human-readable label when no
- * explicit dictionary entry exists yet. Takes the last segment and converts
- * camelCase to Title Case, e.g. "pptx.slideSorter.zoomIn" -> "Zoom In".
- */
-export declare function keyToLabel(key: string): string;
-//#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;
-}
+declare function createRenderController(deps: RenderControllerDeps): RenderController;
 //#endregion
 //#region src/viewer/autosave/autosave-controller.d.ts
 /**
@@ -2726,10 +3220,119 @@ interface LocaleCatalogEntry {
  * the viewer's own prompt ({@link AutosaveControllerDeps.onRecoveryOffer}).
  */
 type AutosaveStatus = 'idle' | 'saving' | 'saved' | 'error';
+interface AutosaveControllerDeps {
+  store: Store<ViewerState>;
+  /** Live core handler used to serialize the current slides to `.pptx` bytes. */
+  getHandler: () => PptxHandler | null;
+  /** IndexedDB key for the recovery snapshot (usually the open file's name). */
+  filePath: string;
+  /** Public document name rendered in the recovery message. */
+  fileName?: string;
+  /**
+   * The resolved cadence in ms, read EVERY time the timer is armed so a
+   * File > Options > Save change applies without rebuilding the viewer.
+   */
+  getIntervalMs: () => number;
+  /**
+   * The Protect-Presentation state, forwarded to the shared save decision.
+   * Deliberately inert here: a recovery snapshot is written in the clear
+   * whatever it says. It is threaded through so this path runs the same one
+   * decision function as every real save instead of side-stepping it.
+   */
+  getSaveIntent?: () => DeckSaveIntent;
+  /** Surface status transitions (toolbar indicator + optional host callback). */
+  onStatus?: (status: AutosaveStatus) => void;
+  /** The raw record, for the host's `onAutosaveRecovery` hook. */
+  onRecovery?: (record: AutosaveRecord$1) => void;
+  /** The shared prompt descriptor + record, for the viewer's own dialog. */
+  onRecoveryOffer?: (offer: AutosaveRecoveryOffer) => void;
+  /** The live shared activation verdict; omitted means "always active". */
+  getActivation?: () => AutosaveActivation;
+  /**
+   * Whether a snapshot may be OFFERED back. This is the host ceiling alone
+   * (`autosave !== false`): a user who merely switched the toggle off should
+   * still be asked about work a crash left behind.
+   */
+  isRecoveryAllowed?: () => boolean;
+}
+interface AutosaveController {
+  /** Force an immediate snapshot, bypassing the debounce window. */
+  saveNow(): Promise<void>;
+  /** Current status. */
+  getStatus(): AutosaveStatus;
+  /** Re-read the activation verdict (the toggle or edit-ability changed). */
+  refresh(): void;
+  /** Whether new edits currently schedule recovery snapshots. */
+  isEnabled(): boolean;
+  /** Tear down the timer + store subscription. */
+  destroy(): void;
+}
+declare function createAutosaveController(deps: AutosaveControllerDeps): AutosaveController;
 //#endregion
 //#region src/viewer/export/export-types.d.ts
+/**
+ * Types shared by the per-format export runners (`export-gif.ts`,
+ * `export-video.ts`, `export-print.ts`) and the controller that wraps them
+ * (`export-controller.ts`). Kept in their own module so the runners never
+ * import from the controller (no cycles).
+ */
+/**
+ * Rasterise the slide at `index` to an `HTMLCanvasElement`. Injected so the
+ * export modules stay DOM-capture-free and unit-testable. `scaleMultiplier`
+ * (default 1) is an extra factor the print path applies when Options >
+ * Advanced > "High quality" is on.
+ */
+type RasterizeSlide = (index: number, scaleMultiplier?: number) => Promise<HTMLCanvasElement>;
+/**
+ * Same capture as {@link RasterizeSlide}, but returns the full
+ * `RasterizeElementResult` (tiled `png-bytes` included) instead of a plain
+ * canvas. Used by the PNG-export and "copy slide as image" paths so a
+ * request whose full resolution exceeds the browser's canvas cap is tiled
+ * and stitched into pre-encoded PNG bytes instead of a canvas
+ * `toBlob`/`toDataURL` call.
+ */
+type RasterizeSlideToRaster = (index: number, scaleMultiplier?: number) => Promise<RasterizeElementResult>;
+/**
+ * Same capture, but returns the raw per-tile canvases (no PNG stitching).
+ * Used by PDF export so a page whose resolution exceeds the browser canvas
+ * cap is composed of several small tile images instead of one oversized or
+ * stitched canvas.
+ */
+type RasterizeSlideToTiles = (index: number, scaleMultiplier?: number) => Promise<RasterizeElementTilesResult>;
 /** Per-slide progress callback: `(currentSlideIndex, totalSlides)`. */
 type ExportProgress = (current: number, total: number) => void;
+/** Dependencies every per-format export runner receives from the controller. */
+interface ExportCaptureDeps {
+  store: Store<ViewerState>;
+  rasterizeSlide: RasterizeSlide;
+  /**
+   * PNG-export / "copy slide as image" only; see {@link RasterizeSlideToRaster}.
+   * Optional: existing test fixtures that only exercise PDF/GIF/video/print
+   * (none of which touch this path) do not need to supply it.
+   * `exportSlidePng`/`copySlideAsImage` fall back to wrapping
+   * `rasterizeSlide`'s plain canvas when this is omitted.
+   */
+  rasterizeSlideToRaster?: RasterizeSlideToRaster;
+  /**
+   * PDF export only; see {@link RasterizeSlideToTiles}. Optional for the
+   * same reason `rasterizeSlideToRaster` is: `exportPdf` falls back to
+   * `rasterizeSlide`'s single canvas per page when this is omitted.
+   */
+  rasterizeSlideToTiles?: RasterizeSlideToTiles;
+  /** Resolved base file name (no extension) for downloads. */
+  baseName: string;
+  /**
+   * Live translator (host-supplied), for the print path's own UI text.
+   * Optional: only the print path actually needs it, and falls back to a
+   * default English `createTranslator()` when omitted (e.g. a GIF/video
+   * test fixture that never touches print).
+   */
+  getTranslator?(): Translator;
+  /** Options > Advanced > "Print hidden slides". Defaults to `false` (excluded), matching PowerPoint. */
+  getIncludeHiddenSlides?(): boolean;
+  /** Options > Advanced > "High quality" raster scale for the print fallback path. */
+  getPrintHighQuality?(): boolean;
+}
 //#endregion
 //#region src/viewer/export/export-gif.d.ts
 /**
@@ -2766,6 +3369,12 @@ interface ExportGifOptions {
   /** Abort the export early; the capture loop checks this between slides. */
   signal?: AbortSignal;
 }
+/**
+ * Capture every slide, encode the frames as an animated GIF, and trigger a
+ * `<baseName>.gif` download. No-op when the deck is empty. Throws the shared
+ * `AbortError` when `signal` aborts between slide captures.
+ */
+declare function runGifExport(deps: ExportCaptureDeps, options?: ExportGifOptions): Promise<void>;
 //#endregion
 //#region src/viewer/export/export-print.d.ts
 /**
@@ -2803,6 +3412,13 @@ interface PrintOptions extends Partial<PrintSettings> {
    */
   openPrintWindow?: OpenPrintWindow;
 }
+/**
+ * Assemble the printable HTML document for the (validated) settings and open
+ * it in a print window. Resolves `true` when the window opened, `false` when
+ * it was blocked or nothing matched the slide range. Throws the shared
+ * `AbortError` when `signal` aborts between slide captures.
+ */
+declare function runPrint(deps: ExportCaptureDeps, options?: PrintOptions): Promise<boolean>;
 //#endregion
 //#region src/viewer/export/export-video.d.ts
 /**
@@ -2831,6 +3447,17 @@ interface ExportVideoOptions {
   /** Abort the export early; checked between slides and between frames. */
   signal?: AbortSignal;
 }
+/** Deps for {@link runVideoExport}; adds a sleep seam for fast unit tests. */
+interface ExportVideoDeps extends ExportCaptureDeps {
+  /** Overridable frame-hold sleep (test seam). Defaults to `setTimeout`. */
+  waitMs?: (ms: number) => Promise<void>;
+}
+/**
+ * Capture every slide, record them into a WebM video, and trigger a
+ * `<baseName>.webm` download. No-op when the deck is empty. Throws the shared
+ * `AbortError` when `signal` aborts during capture or recording.
+ */
+declare function runVideoExport(deps: ExportVideoDeps, options?: ExportVideoOptions): Promise<void>;
 //#endregion
 //#region src/viewer/export/export-controller.d.ts
 /** Options for the multi-slide PDF export (progress + cooperative cancel). */
@@ -2840,6 +3467,109 @@ interface ExportPdfOptions {
   /** Abort the export early; the loop checks this between slides. */
   signal?: AbortSignal;
 }
+interface ExportControllerDeps {
+  store: Store<ViewerState>;
+  rasterizeSlide: RasterizeSlide;
+  /** PNG-export / "copy slide as image" only; see {@link RasterizeSlideToRaster}. */
+  rasterizeSlideToRaster?: RasterizeSlideToRaster;
+  /** PDF export only; see {@link RasterizeSlideToTiles}. */
+  rasterizeSlideToTiles?: RasterizeSlideToTiles;
+  /** Base file name (without extension) for downloads. Defaults to `presentation`. */
+  fileName?: string;
+  /** Live translator (host-supplied), for the print path's own UI text. */
+  getTranslator?: ExportCaptureDeps['getTranslator'];
+  /** Options > Advanced > "Print hidden slides". */
+  getIncludeHiddenSlides?: ExportCaptureDeps['getIncludeHiddenSlides'];
+  /** Options > Advanced > "High quality" raster scale for the print fallback path. */
+  getPrintHighQuality?: ExportCaptureDeps['getPrintHighQuality'];
+}
+interface ExportController {
+  /** Export a single slide as a PNG download. Defaults to the current slide. */
+  exportSlidePng(index?: number): Promise<void>;
+  /** Copy a slide to the system clipboard as a PNG image. */
+  copySlideAsImage(index?: number): Promise<void>;
+  /** Export every slide as a multi-page PDF download (one slide per page). */
+  exportPdf(options?: ExportPdfOptions): Promise<void>;
+  /** Export every slide as an animated GIF download (one frame per slide). */
+  exportGif(options?: ExportGifOptions): Promise<void>;
+  /** Export every slide as a WebM video download (MediaRecorder). */
+  exportVideo(options?: ExportVideoOptions): Promise<void>;
+  /** Assemble the printable document and open it in a print window. */
+  print(options?: PrintOptions): Promise<boolean>;
+  /** Serialize the deck to `pptx-viewer-json` and download it. */
+  exportJson(): void;
+}
+/**
+ * Export controller: render slides to PNG / PDF / GIF / WebM video, plus the
+ * print flow. Vanilla port of Vue's `useExport` composable extended with the
+ * GIF/video/print surface from React's `useExportHandlers` (the per-format
+ * capture drivers live in `export-gif.ts` / `export-video.ts` /
+ * `export-print.ts`; all pure planning/encoding/assembly is shared). A plain
+ * closure with an internal `exporting` guard replaces the reactive flag, since
+ * nothing in the vanilla binding currently needs to reactively observe
+ * export-in-progress state.
+ *
+ * Rasterisation is delegated to the injected `rasterizeSlide` (the host owns
+ * the DOM + `html2canvas-pro`, see `rasterize-slide.ts`). `jspdf` is loaded
+ * lazily so it stays out of the main bundle.
+ */
+declare function createExportController(deps: ExportControllerDeps): ExportController;
+//#endregion
+//#region src/viewer/export/export-progress-modal.d.ts
+/**
+ * ExportProgressModal: a centered, non-dismissable overlay shown while a
+ * multi-slide export (PDF / GIF / WebM) runs. Vanilla port of the shared
+ * ExportProgressModal pattern (React/Vue/Angular/Svelte): same layout and
+ * `--pptx-*` theme tokens, hand-built DOM instead of a template.
+ *
+ * It deliberately does NOT close on backdrop click or Escape: an export in
+ * flight should only end by completing, erroring, or the user pressing
+ * Cancel. `onCancel` aborts cooperatively (the export loops check the
+ * signal between slides).
+ */
+interface ExportProgressModal {
+  /** Show the modal with a fresh title, zeroed bar, and initial status. */
+  open(title: string, status: string): void;
+  /** Update the bar (0-100, clamped) and the status line under it. */
+  update(progress: number, status: string): void;
+  /** Hide and remove the modal from the document. */
+  close(): void;
+}
+interface ExportProgressModalDeps {
+  doc: Document;
+  getTranslator(): Translator;
+  /** The Cancel control was pressed (abort the in-flight export). */
+  onCancel(): void;
+}
+/** Build a (closed) progress modal; `open` mounts it onto `doc.body`. */
+declare function createExportProgressModal(deps: ExportProgressModalDeps): ExportProgressModal;
+//#endregion
+//#region src/viewer/export/export-progress-ui.d.ts
+/**
+ * Wires the multi-slide exports (PDF / GIF / WebM) to the progress modal:
+ * a `begin -> run -> end` envelope owning the modal state and the
+ * `AbortController` the export loops check between slides. Vanilla port of
+ * Svelte's `ExportUiState` / Vue's `useExportProgress`; all percentage maths
+ * and status labels come from `pptx-viewer-shared` (`export-progress.ts`) so
+ * every binding shows identical progress.
+ *
+ * A caller-supplied `onProgress`/`signal` (the public `PptxViewerInstance`
+ * export API accepts them) still works: caller callbacks are invoked alongside
+ * the modal's, and an aborted caller signal aborts the envelope's controller.
+ */
+interface ExportProgressUiDeps {
+  modal: ExportProgressModal;
+  controller: ExportController;
+  getTranslator(): Translator;
+}
+interface ExportProgressUi {
+  runPdf(options?: ExportPdfOptions): Promise<void>;
+  runGif(options?: ExportGifOptions): Promise<void>;
+  runVideo(options?: ExportVideoOptions): Promise<void>;
+  /** Abort the in-flight export (the modal's Cancel control routes here). */
+  cancel(): void;
+}
+declare function createExportProgressUi(deps: ExportProgressUiDeps): ExportProgressUi;
 //#endregion
 //#region src/viewer/export/export-svg.d.ts
 /** Export one parsed slide as resolution-independent SVG markup. */
@@ -2847,6 +3577,113 @@ export declare function exportSlideToSvg(slide: PptxSlide, width: number, height
 /** Export the selected slides in a parsed presentation as SVG markup. */
 export declare function exportAllSlidesToSvg(data: PptxData, options?: SvgExportOptions): string[];
 //#endregion
+//#region src/viewer/export/rasterize-slide.d.ts
+interface RasterizeSlideDeps {
+  doc: Document;
+  /** Host the off-screen capture stage is appended to; removed on `destroy()`. */
+  container: HTMLElement;
+  store: Store<ViewerState>;
+  registry: index_d_exports$1.ElementRendererRegistry;
+  getTranslator(): Translator;
+  /**
+   * Opt-in WebGL SmartArt renderer flag; see `PptxViewerOptions.smartArt3D`.
+   * A getter, not a plain boolean, read fresh on every `rasterizeSlide()`
+   * call so a mid-session Options > Advanced > "Disable 3D rendering" toggle
+   * (already ANDed in by the caller, see `resolve3DRenderingFlags`) reaches
+   * the very next export/print without reconstructing this controller.
+   */
+  getSmartArt3D(): boolean;
+  /**
+   * Opt-in interactive WebGL surface-chart renderer flag; see
+   * `PptxViewerOptions.surfaceChart3D`. Same "read fresh" note as
+   * `getSmartArt3D`.
+   */
+  getSurfaceChart3D(): boolean;
+  /**
+   * Opt-in interactive WebGL bar3D-chart renderer flag; see
+   * `PptxViewerOptions.barChart3D`. Same "read fresh" note as `getSmartArt3D`.
+   */
+  getBarChart3D(): boolean;
+  /**
+   * Opt-in interactive WebGL line3D-chart renderer flag; see
+   * `PptxViewerOptions.lineChart3D`. Same "read fresh" note as
+   * `getSmartArt3D`.
+   */
+  getLineChart3D(): boolean;
+  /**
+   * Opt-in interactive WebGL area3D-chart renderer flag; see
+   * `PptxViewerOptions.areaChart3D`. Same "read fresh" note as
+   * `getSmartArt3D`.
+   */
+  getAreaChart3D(): boolean;
+  /**
+   * Opt-in interactive WebGL pie3D-chart renderer flag; see
+   * `PptxViewerOptions.pieChart3D`. Same "read fresh" note as `getSmartArt3D`.
+   */
+  getPieChart3D(): boolean;
+  /**
+   * Options > Advanced > "Default resolution" / "Do not compress images"
+   * raster-scale multiplier (see `resolveImageResolutionScale` in
+   * `pptx-viewer-shared`), applied on top of the baseline capture scale so
+   * the option has real effect without changing the default (highFidelity)
+   * export quality.
+   */
+  getImageResolutionScale(): number;
+  /**
+   * Overridable frame-wait before capture (test seam: the real
+   * `requestAnimationFrame` double-wait is not worth driving through fake
+   * timers). Defaults to {@link nextFrame}.
+   */
+  waitForFrame?: () => Promise<void>;
+}
+interface RasterizeSlideController {
+  /**
+   * Render slide `index` off-screen at scale 1 and capture it to a single
+   * full-resolution canvas via the shared `rasterizeElementTiledToCanvas`
+   * (foreignObject -> vector-SVG -> html2canvas-pro fallback chain), tiling
+   * and stitching transparently (never reducing scale) if the requested
+   * resolution would exceed the browser's canvas cap. `scaleMultiplier`
+   * (default 1) is an extra factor on top of the baseline 2x * Options >
+   * Advanced > Image Size/Quality scale; the Print dialog's notes/handouts
+   * raster path passes a higher value when Options > Advanced > "High
+   * quality" is on, without changing plain PNG/PDF export.
+   */
+  rasterizeSlide(index: number, scaleMultiplier?: number): Promise<HTMLCanvasElement>;
+  /**
+   * Same capture as {@link rasterizeSlide}, but returns the full
+   * `RasterizeElementResult` instead of unwrapping to a plain canvas. Used
+   * by the PNG-export and "copy slide as image" paths so a request whose
+   * full resolution exceeds the browser's canvas cap is tiled and stitched
+   * as pre-encoded PNG bytes (`kind: 'png-bytes'`) instead of a canvas
+   * `toBlob`/`toDataURL` call, since no single canvas could hold the full
+   * image.
+   */
+  rasterizeSlideToRaster(index: number, scaleMultiplier?: number): Promise<RasterizeElementResult>;
+  /**
+   * Same capture, but returns the raw per-tile canvases (no PNG stitching).
+   * Used by PDF export so a page whose resolution exceeds the browser
+   * canvas cap is composed of several small tile images instead of one
+   * oversized or stitched canvas.
+   */
+  rasterizeSlideToTiles(index: number, scaleMultiplier?: number): Promise<RasterizeElementTilesResult>;
+  /** Remove the off-screen capture stage from the DOM. */
+  destroy(): void;
+}
+/**
+ * Build the off-screen capture stage used by PNG/PDF export: a hidden host
+ * (fixed off-canvas, `aria-hidden`) that renders one slide at a time at scale
+ * 1 via the shared `renderSlideStage`, then rasterises it through the shared
+ * `rasterizeElement` / `rasterizeElementTiles` /
+ * `rasterizeElementTiledToCanvas` entry points; `renderToCanvas`
+ * (html2canvas-pro) is only ever the last-resort `html2canvasFallback` driver
+ * handed to them. Vanilla port of Vue's `useExportWiring.rasterizeSlide`
+ * (`packages/vue/src/viewer/composables/useExportWiring.ts`): Vue re-renders
+ * an off-screen `<SlideStage>` behind a template ref; the vanilla binding
+ * owns the DOM directly, so this builds and re-populates one host element for
+ * the life of the controller instead.
+ */
+declare function createRasterizeSlide(deps: RasterizeSlideDeps): RasterizeSlideController;
+//#endregion
 //#region src/viewer/export/render-to-canvas.d.ts
 /**
  * A drop-in wrapper around `html2canvas-pro` that first normalises modern CSS
@@ -2867,100 +3704,8 @@ export declare function renderToCanvas(element: HTMLElement, options?: Partial<O
  * a URL string to fetch.
  */
 type PptxViewerSource = ArrayBuffer | Uint8Array | Blob | string;
-//#endregion
-//#region src/viewer/load/load-presentation.d.ts
-/**
- * The vanilla load pipeline: parse a `.pptx` buffer with `pptx-viewer-core`'s
- * `PptxHandler` and resolve all media / picture URLs, exactly like the Vue
- * binding's `useLoadContent` (minus the framework reactivity). Chart data
- * enrichment happens inside `PptxHandler.load` (core's slide loader calls
- * `enrichChartData` for every chart), so loaded chart elements arrive
- * render-ready here too.
- */
-interface LoadedPresentation {
-  /** The live handler (owns the archive; caller must `dispose()` it). */
-  handler: PptxHandler;
-  /** Parsed slides with image/media URLs patched in. */
-  slides: PptxSlide[];
-  /** Parsed presentation sections. */
-  sections: PptxSection[];
-  presentationProperties: PptxPresentationProperties;
-  /**
-   * View properties (`ppt/viewProps.xml`, `p:viewPr`): grid spacing, snap /
-   * guide toggles, last view, splitter state, etc. `gridSpacing` lives here,
-   * NOT on `presentationProperties` -- `p:gridSpacing` is a child of
-   * `p:viewPr`, and a real PowerPoint file never populates it under
-   * `p:presentationPr`.
-   */
-  viewProperties?: PptxViewProperties;
-  headerFooter: PptxHeaderFooter;
-  coreProperties?: PptxCoreProperties;
-  appProperties?: PptxAppProperties;
-  customProperties: PptxCustomProperty[];
-  customShows: PptxCustomShow[];
-  /** Office 2021 (p188) comment authors, for the `@`-mention typeahead. */
-  modernCommentAuthors: PptxModernCommentAuthor[];
-  /** Legacy `ppt/commentAuthors.xml` authors, mapped into the typeahead too. */
-  commentAuthors: PptxCommentAuthor[];
-  embeddedFonts: PptxEmbeddedFont[];
-  hasDigitalSignatures: boolean;
-  digitalSignatureCount: number;
-  isPasswordProtected: boolean;
-  /** Slide canvas size in CSS px. */
-  canvasSize: CanvasSize;
-  /**
-   * `p:sldSz` verbatim, in EMU. Kept even when it matches no preset so a save
-   * re-emits the authored dimensions rather than a lossy pixel round-trip.
-   */
-  slideSize?: SlideSizeEmu;
-  /** Archive-path to displayable URL map for media + poster frames. */
-  mediaDataUrls: Map<string, string>;
-  /** Presentation theme colours used by scheme-based rendering. */
-  colorScheme?: PptxThemeColorScheme;
-  /** Presentation theme fonts used by table-style font resolution. */
-  fontScheme?: PptxThemeFontScheme;
-  /** The theme part's name, seeding the inspector's THEME EDITOR card. */
-  themeName?: string;
-  /** Tag collections from `ppt/tags/*.xml` (inspector TAGS card). */
-  tagCollections: PptxTagCollection[];
-  /** Parsed presentation table styles keyed by style id. */
-  tableStyleMap?: ParsedTableStyleMap;
-  /** `ppt/tableStyles.xml`'s `<a:tblStyleLst @def>` default style GUID. */
-  tableStylesDefaultId?: string;
-  slideMasters: PptxSlideMaster[];
-  /** Theme parts discovered in the package (inspector THEME card). */
-  themeOptions: PptxThemeOption[];
-  notesMaster?: PptxNotesMaster;
-  handoutMaster?: PptxHandoutMaster;
-  hasMacros: boolean;
-  notesCanvasSize?: CanvasSize;
-  /** Blob URLs created during the load; revoke them when replacing/destroying. */
-  blobUrls: string[];
-  /**
-   * Write-protection verifier from `p:modifyVerifier` (`presentation.xml`).
-   * Feeds `readOnlyRecommendation`: its presence means editing requires a
-   * password this viewer never asks for.
-   */
-  modifyVerifier?: PptxModifyVerifier;
-  /**
-   * Deck-level compatibility warnings (`data.warnings`, distinct from each
-   * slide's own `warnings`): unmodelled markup, lossy save fallbacks, etc.
-   * reported by core's `PptxCompatibilityService`. Feeds
-   * `compatibilityWarningToasts` alongside every slide's `warnings`.
-   */
-  warnings: PptxCompatibilityWarning[];
-}
-interface LoadPresentationOptions {
-  /**
-   * Trust Center > "Allow external content" (default false, matching core's
-   * own SSRF/privacy-safe default). When false, `PptxHandler.getImageData`
-   * silently drops `http(s)://` image references instead of fetching them.
-   */
-  allowExternalImages?: boolean;
-}
-export declare function loadPresentation(buffer: ArrayBuffer, options?: LoadPresentationOptions): Promise<LoadedPresentation>;
-/** Revoke every `blob:` URL in the list (safe for data: URLs, which are skipped). */
-export declare function revokeBlobUrls(urls: Iterable<string>): void;
+/** Normalise any accepted source into an `ArrayBuffer` of `.pptx` bytes. */
+declare function resolveSourceToBuffer(source: PptxViewerSource): Promise<ArrayBuffer>;
 //#endregion
 //#region src/viewer/types.d.ts
 /** Callbacks mirroring the Vue component's emits. */
@@ -2995,7 +3740,7 @@ interface PptxViewerCallbacks {
   /** Fired on every collaboration connection-status transition. */
   onCollaborationStatus?: (status: ConnectionStatus) => void;
 }
-interface PptxViewerOptions extends PptxViewerCallbacks, ViewportFitOptions {
+interface PptxViewerOptions extends PptxViewerCallbacks, ViewportFitOptions$1 {
   /**
    * The presentation to open: raw `.pptx` bytes (ArrayBuffer / Uint8Array),
    * a Blob/File, or a URL string to fetch. Omit to start empty and call
@@ -3005,7 +3750,7 @@ interface PptxViewerOptions extends PptxViewerCallbacks, ViewportFitOptions {
   /** Licensed font sources supplied by the host application. */
   fonts?: ViewerFontSource[];
   /** Viewer chrome theme (shared `ViewerTheme`: colors, radius, CSS vars). */
-  theme?: ViewerTheme;
+  theme?: ViewerTheme$1;
   /** Display name shown in the PowerPoint-style title bar. */
   fileName?: string;
   /** UI locale (default `'en'`). Dictionaries come from `messages`. */
@@ -3045,7 +3790,7 @@ interface PptxViewerOptions extends PptxViewerCallbacks, ViewportFitOptions {
    * Disabled by default: the Account page's sign-in section renders nothing
    * unless `enabled: true` is passed.
    */
-  accountAuth?: AccountAuthConfig;
+  accountAuth?: AccountAuthConfig$1;
   /** Zero-based slide to show after load (default 0). */
   initialSlide?: number;
   /**
@@ -3083,20 +3828,20 @@ interface PptxViewerOptions extends PptxViewerCallbacks, ViewportFitOptions {
    * the same feature. Unlike {@link showToolbar}, this hides individual
    * pieces rather than the whole chrome.
    */
-  hiddenActions?: ToolbarActionId[];
+  hiddenActions?: ToolbarActionId$1[];
   /**
    * Framework-neutral UI customisation. See docs/guide/customization.md.
    * Seeds the instance's customisation; the `ViewerCustomizationApi` methods
    * on the returned instance (`hideRibbonTab`, `setCustomization`, ...)
    * change it live. {@link hiddenActions} still applies and is unioned with it.
    */
-  customization?: ViewerCustomization;
+  customization?: ViewerCustomization$1;
   /**
    * Custom element-renderer registry. Defaults to `createDefaultRegistry()`;
    * pass your own (or mutate the default via `getRegistry()`) to add or
    * override element renderers.
    */
-  registry?: ElementRendererRegistry;
+  registry?: index_d_exports$1.ElementRendererRegistry;
   /**
    * Unit system for the View > Rulers tick labels (default `'inches'`, as
    * PowerPoint does). Mirrors React's `rulerUnit` prop; the tick generator is
@@ -3241,10 +3986,10 @@ interface PptxViewerOptions extends PptxViewerCallbacks, ViewportFitOptions {
    * the model connection (a backend `endpoint`, an in-browser `model`, or a
    * custom `transport`); see {@link PptxAiConfig}.
    */
-  ai?: PptxAiConfig;
+  ai?: PptxAiConfig$1;
 }
 /** The viewer handle returned by `createPptxViewer`. */
-interface PptxViewerInstance extends PowerPointViewerAPI, ViewerCustomizationApi {
+interface PptxViewerInstance extends PowerPointViewerAPI, ViewerCustomizationApi$1 {
   /** Load a presentation from bytes or a Blob/File (replaces the current one). */
   loadFile(file: Blob | ArrayBuffer | Uint8Array): Promise<void>;
   /** Fetch and load a presentation from a URL. */
@@ -3267,7 +4012,7 @@ interface PptxViewerInstance extends PowerPointViewerAPI, ViewerCustomizationApi
   zoomOut(): void;
   zoomToFit(): void;
   /** Apply a new viewer theme (pass `undefined` to reset to defaults). */
-  setTheme(theme: ViewerTheme | undefined): void;
+  setTheme(theme: ViewerTheme$1 | undefined): void;
   /** Switch the UI locale (rebuilds the chrome labels). */
   setLocale(locale: string): void;
   /** Enter presentation mode (real Fullscreen API). */
@@ -3334,7 +4079,7 @@ interface PptxViewerInstance extends PowerPointViewerAPI, ViewerCustomizationApi
    */
   exportJson(): void;
   /** The element-renderer registry in effect (extension point). */
-  getRegistry(): ElementRendererRegistry;
+  getRegistry(): index_d_exports$1.ElementRendererRegistry;
   /**
    * Escape hatch: the live `pptx-viewer-core` handler for the loaded file
    * (or `null`). Enables advanced operations (save, markdown conversion,
@@ -3386,9 +4131,9 @@ interface ChromeHost {
   /** The host options with the UI customisation folded into the chrome flags. */
   getChromeOptions(): PptxViewerOptions;
   /** The live resolved UI customisation. */
-  getResolvedCustomization(): ResolvedCustomization;
+  getResolvedCustomization(): ResolvedCustomization$1;
   /** The viewer's live theme (kept in sync by `setTheme`); read on mount/remount instead of the static `options.theme`. */
-  currentTheme: ViewerTheme | undefined;
+  currentTheme: ViewerTheme$1 | undefined;
   editor: {
     commitNotes(notes: string, notesSegments?: TextSegment[]): void;
     getEditActions(): EditActions;
@@ -3531,7 +4276,7 @@ interface ChromeHost {
   openFile(): void;
   openRecentFile(key: string): void;
   createPresentation(templateId: string): void;
-  setTheme(theme: ViewerTheme | undefined): void;
+  setTheme(theme: ViewerTheme$1 | undefined): void;
   applyPresentationTheme(presetId: string): void;
 }
 //#endregion
@@ -3539,7 +4284,7 @@ interface ChromeHost {
 interface ViewerCustomizationLifecycle {
   readonly controller: ViewerCustomizationController;
   /** The current resolved customisation (read lazily by every render site). */
-  getResolved(): ResolvedCustomization;
+  getResolved(): ResolvedCustomization$1;
   /**
    * The host options with the customisation folded into the flags the chrome
    * builders already read: `hiddenActions` (legacy list unioned with the
@@ -3548,7 +4293,7 @@ interface ViewerCustomizationLifecycle {
   getChromeOptions(): PptxViewerOptions;
   /** The host configured `ai` AND the customisation keeps the AI feature. */
   isAiEnabled(): boolean;
-  isDialogAvailable(dialog: ViewerDialogId): boolean;
+  isDialogAvailable(dialog: ViewerDialogId$1): boolean;
   /**
    * Start applying the customisation: push the constraints into the options
    * store now and on every change, and call `onChange` after each change so
@@ -3559,6 +4304,44 @@ interface ViewerCustomizationLifecycle {
 }
 //#endregion
 //#region src/viewer/export-lifecycle.d.ts
+interface ExportLifecycleDeps {
+  doc: Document;
+  /** Host the off-screen capture stage mounts into; matches the viewer container. */
+  container: HTMLElement;
+  store: Store<ViewerState>;
+  registry: index_d_exports$1.ElementRendererRegistry;
+  getTranslator(): Translator;
+  /**
+   * The six 3D opt-in flags as getters (not plain booleans), each already
+   * ANDed with Options > Advanced > "Disable 3D rendering" by the caller
+   * (see `resolve3DRenderingFlags`) and read fresh on every export/print so
+   * a mid-session toggle reaches the very next one. See `RasterizeSlideDeps`.
+   */
+  getSmartArt3D(): boolean;
+  getSurfaceChart3D(): boolean;
+  getBarChart3D(): boolean;
+  getLineChart3D(): boolean;
+  getAreaChart3D(): boolean;
+  getPieChart3D(): boolean;
+  /**
+   * Options > Advanced > "Default resolution" / "Do not compress images"
+   * raster-scale multiplier (see `resolveImageResolutionScale`), read fresh
+   * on every rasterize call so a mid-session change reaches the next export.
+   */
+  getImageResolutionScale(): number;
+  /**
+   * Options > Advanced > "Print hidden slides", read fresh on every print so a
+   * mid-session toggle reaches the very next print job.
+   */
+  getIncludeHiddenSlides?(): boolean;
+  /**
+   * Options > Advanced > "High quality" raster scale for the print
+   * notes/handouts fallback path, read fresh on every print.
+   */
+  getPrintHighQuality?(): boolean;
+  /** Source file name (title-bar name); drives export download names. */
+  fileName?: string;
+}
 /** The export slice of the public viewer API (see `PptxViewerInstance`). */
 interface ViewerExportApi {
   /** Export a single slide as a PNG download. Defaults to the current slide. */
@@ -3596,14 +4379,23 @@ declare abstract class ViewerExportHost implements ViewerExportApi {
   print(options?: PrintOptions): Promise<boolean>;
   exportJson(): void;
 }
+/**
+ * Build the export feature for one `PptxViewer` instance: the off-screen
+ * rasterisation stage (`./export/rasterize-slide.ts`) plus the
+ * PNG/PDF/GIF/video/print export controller
+ * (`./export/export-controller.ts`) wired to it. Split out of `PptxViewer`
+ * (mirrors `chrome-lifecycle.ts`) purely to keep the class file under the
+ * file-size budget; owns no state beyond the capture stage.
+ */
+declare function createExportLifecycle(deps: ExportLifecycleDeps): ExportLifecycle;
 //#endregion
 //#region src/viewer/customization-host.d.ts
-declare abstract class ViewerCustomizationHost extends ViewerExportHost implements ViewerCustomizationApi {
+declare abstract class ViewerCustomizationHost extends ViewerExportHost implements ViewerCustomizationApi$1 {
   protected abstract readonly customization: ViewerCustomizationLifecycle;
   private get customizationApi();
-  getCustomization(): ViewerCustomization;
-  setCustomization(next: ViewerCustomization): void;
-  updateCustomization(patch: ViewerCustomization): void;
+  getCustomization(): ViewerCustomization$1;
+  setCustomization(next: ViewerCustomization$1): void;
+  updateCustomization(patch: ViewerCustomization$1): void;
   resetCustomization(): void;
   hideRibbonTab(tab: ToolbarTabId | RibbonContextualTabId): void;
   showRibbonTab(tab: ToolbarTabId | RibbonContextualTabId): void;
@@ -3613,15 +4405,15 @@ declare abstract class ViewerCustomizationHost extends ViewerExportHost implemen
   showToolbarButton(button: ToolbarButtonId | RibbonControlId): void;
   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;
-  lockSetting(setting: OptionsSettingId, value: ViewerOptionPrimitive, hidden?: boolean): void;
-  unlockSetting(setting: OptionsSettingId): void;
-  setSettingDefault(setting: OptionsSettingId, value: ViewerOptionPrimitive | undefined): void;
+  hideOptionsPage(page: OptionsPageId$1): void;
+  showOptionsPage(page: OptionsPageId$1): void;
+  hideOptionsSection(section: OptionsSectionId$1): void;
+  showOptionsSection(section: OptionsSectionId$1): void;
+  hideSetting(setting: OptionsSettingId$1): void;
+  showSetting(setting: OptionsSettingId$1): void;
+  lockSetting(setting: OptionsSettingId$1, value: ViewerOptionPrimitive, hidden?: boolean): void;
+  unlockSetting(setting: OptionsSettingId$1): void;
+  setSettingDefault(setting: OptionsSettingId$1, value: ViewerOptionPrimitive | undefined): void;
   hideBackstagePage(page: BackstagePage): void;
   showBackstagePage(page: BackstagePage): void;
   hideBackstageCard(card: BackstageCardId): void;
@@ -3632,10 +4424,10 @@ declare abstract class ViewerCustomizationHost extends ViewerExportHost implemen
   showCanvasContextMenuCommand(command: CanvasContextMenuCommandId): void;
   disableShortcut(action: EditorKeyActionName): void;
   enableShortcut(action: EditorKeyActionName): void;
-  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;
+  remapShortcut(action: EditorKeyActionName, chords: ShortcutChord$1 | readonly ShortcutChord$1[] | undefined): void;
+  setPanelVisible(panel: ViewerPanelId$1, visible: boolean): void;
+  setFeatureEnabled(feature: ViewerFeatureId$1, enabled: boolean): void;
+  setDialogAvailable(dialog: ViewerDialogId$1, available: boolean): void;
 }
 //#endregion
 //#region src/viewer/PptxViewer.d.ts
@@ -3652,7 +4444,7 @@ export declare class PptxViewer extends ViewerCustomizationHost implements PptxV
   readonly renderer: RenderController;
   t: Translator;
   /** The viewer's live theme (kept in sync by `setTheme`); read by `ChromeHost` on mount/remount. */
-  currentTheme: ViewerTheme | undefined;
+  currentTheme: ViewerTheme$1 | undefined;
   private readonly availableThemes;
   private readonly availableLocales;
   private currentThemeKey;
@@ -3777,7 +4569,7 @@ export declare class PptxViewer extends ViewerCustomizationHost implements PptxV
   getActiveSlide: () => PptxSlide | undefined;
   getElements: (index?: number) => readonly PptxElement[];
   getElementById: (id: string, index?: number) => PptxElement | undefined;
-  updateElements: (updates: readonly ElementUpdate[], options?: ElementUpdateOptions) => Promise<void>;
+  updateElements: (updates: readonly ElementUpdate$1[], options?: ElementUpdateOptions$1) => Promise<void>;
   updateElement: (id: string, updates: Partial<PptxElement>) => void;
   addElement: (element: PptxElement) => string | undefined;
   deleteElements: (ids: string[]) => void;
@@ -3804,14 +4596,14 @@ export declare class PptxViewer extends ViewerCustomizationHost implements PptxV
    * isn't tracked as a "choice", matching how the Design tab's own gallery
    * already calls this method.
    */
-  setTheme(theme: ViewerTheme | undefined): void;
+  setTheme(theme: ViewerTheme$1 | undefined): void;
   applyPresentationTheme(presetId: string): void;
   /** Run the shared WCAG checks against the live deck and show the results. */
   openAccessibility(): void;
   openSettings(tab?: 'general' | 'shortcuts'): void;
   openSetUpSlideShow(): void;
   toggleSubtitles(): void;
-  subtitleOptionsStore(): ViewerOptionsStore;
+  subtitleOptionsStore(): import("ooxml-ui/pptx").ViewerOptionsStore;
   openHeaderFooter(): void;
   openCompare(): void;
   openPrintDialog(): void;
@@ -4053,7 +4845,7 @@ export declare class PptxViewer extends ViewerCustomizationHost implements PptxV
   getSelectedElementId: () => string | null;
   enterPresentation(): Promise<void>;
   exitPresentation(): Promise<void>;
-  getRegistry: () => ElementRendererRegistry;
+  getRegistry: () => index_d_exports$1.ElementRendererRegistry;
   getHandler: () => PptxHandler | null;
   startCollaboration(config: CollaborationConfig): Promise<void>;
   stopCollaboration: () => void;
@@ -4075,7 +4867,7 @@ export declare class PptxViewer extends ViewerCustomizationHost implements PptxV
   /** The host options with the UI customisation folded in (read on every chrome mount). */
   getChromeOptions(): PptxViewerOptions;
   /** The live resolved UI customisation (every render site reads this). */
-  getResolvedCustomization(): ResolvedCustomization;
+  getResolvedCustomization(): ResolvedCustomization$1;
   /** Rebuild the whole chrome (locale switch, customisation change) and re-wire it. */
   private rebuildChrome;
   private remountChrome;
@@ -4100,11 +4892,11 @@ interface CollaborationControllerDeps {
   /** When supplied, apply a session restriction without replacing host edit permission. */
   onReadOnlyChange?: (readOnly: boolean) => void;
   /** Notified on every connection-status transition. */
-  onStatusChange?: (status: ConnectionStatus) => void;
+  onStatusChange?: (status: ConnectionStatus$1) => void;
 }
 interface CollaborationController {
   /** Connect and begin syncing. Stops any prior session first. */
-  start(config: CollaborationConfig): Promise<void>;
+  start(config: CollaborationConfig$1): Promise<void>;
   /** Disconnect and tear the session down. */
   stop(): void;
   /** Whether a session is currently active. */
@@ -4112,7 +4904,7 @@ interface CollaborationController {
   /** Whether the session's role or host readiness currently blocks editing. */
   isReadOnly(): boolean;
   /** Current connection status. */
-  getStatus(): ConnectionStatus;
+  getStatus(): ConnectionStatus$1;
   /** Publish a cursor move (slide-space px); no-op when no session is active. */
   setCursor(x: number, y: number, activeSlideIndex?: number): void;
   /** Publish the local selection; no-op when no session is active. */
@@ -4122,14 +4914,14 @@ interface CollaborationController {
   /** Follow the given peer's active slide, or `null` to stop following. */
   followUser(clientId: number | null): void;
   /** The last config used to start a session (persists after `stop()`, for retry). */
-  getConfig(): CollaborationConfig | null;
+  getConfig(): CollaborationConfig$1 | null;
   /**
    * The load pipeline is about to commit a parsed deck to the store: suppress
    * local->doc slide publishing until {@link notifyContentLoaded} runs, so a
    * late joiner's bootstrap deck is never written into the room's doc before
    * the adoption check.
    */
-  beginContentLoad(origin: CollabLoadOrigin): void;
+  beginContentLoad(origin: CollabLoadOrigin$1): void;
   /**
    * A content load finished applying to viewer state.
    *
@@ -4139,13 +4931,13 @@ interface CollaborationController {
    * the opposite case - it is what they asked for, so the deferred publish
    * runs and the room adopts it (see `shouldRoomSlidesReplaceLoad`).
    */
-  notifyContentLoaded(origin: CollabLoadOrigin): void;
+  notifyContentLoaded(origin: CollabLoadOrigin$1): void;
   /**
    * Interim ("live preview") Y.Doc write channel: publishes in-flight inline
    * editor text that has not reached the store yet, so peers see typing as it
    * happens instead of on commit. Dormant outside a session.
    */
-  readonly livePatcher: CollaborationLivePatcher;
+  readonly livePatcher: CollaborationLivePatcher$1;
   /** Stop and release everything (viewer destroy). */
   destroy(): void;
 }
@@ -4177,7 +4969,7 @@ export declare function createCollaborationController(deps: CollaborationControl
 interface CollaborationCursors {
   /** Mount as a sibling of the rendered stage inside the stage wrap. */
   el: HTMLElement;
-  update(cursors: readonly RemoteCursor[], scale: number): void;
+  update(cursors: readonly RemoteCursor$1[], scale: number): void;
   destroy(): void;
 }
 export declare function createCollaborationCursors(doc: Document): CollaborationCursors;
@@ -4203,7 +4995,7 @@ export declare function createCollaborationCursors(doc: Document): Collaboration
 interface RemoteSelectionOverlay {
   /** Mount as a sibling of the rendered stage inside the stage wrap. */
   el: HTMLElement;
-  update(presences: readonly SanitizedPresence[], elements: readonly PptxElement[], activeSlideIndex: number, scale: number): void;
+  update(presences: readonly SanitizedPresence$1[], elements: readonly PptxElement[], activeSlideIndex: number, scale: number): void;
   destroy(): void;
 }
 //#endregion
@@ -4216,7 +5008,7 @@ interface CollaborationShellOptions extends Pick<CollaborationControllerDeps, 's
   getSourcePending?(): boolean;
   getSourceError?(): boolean;
   getScale?(): number;
-  onStateChange?(state: CollaborationShellState): void;
+  onStateChange?(state: CollaborationShellState$1): void;
 }
 interface CollaborationShell {
   /** Existing controller for load boundaries and interim edit publication. */
@@ -4224,8 +5016,8 @@ interface CollaborationShell {
   /** Mount beside the scaled stage; refresh after changing the host's zoom. */
   cursorOverlay: CollaborationCursors;
   selectionOverlay: RemoteSelectionOverlay;
-  setConfig(config: CollaborationConfig | undefined): Promise<void>;
-  getState(): CollaborationShellState;
+  setConfig(config: CollaborationConfig$1 | undefined): Promise<void>;
+  getState(): CollaborationShellState$1;
   /** Re-evaluate host permission, loading or zoom getters after host-only changes. */
   refresh(): void;
   destroy(): void;
@@ -4233,9 +5025,57 @@ interface CollaborationShell {
 /** Thin custom-chrome wiring; document ownership and sync stay in the controller. */
 export declare function createCollaborationShell(options: CollaborationShellOptions): CollaborationShell;
 //#endregion
+//#region src/viewer/state-sync.d.ts
+interface StateSyncDeps {
+  getChrome(): ViewerChrome;
+  renderer: RenderController;
+  callbacks: PptxViewerCallbacks;
+}
+/**
+ * Build the store listener that turns {@link ViewerState} transitions into
+ * chrome updates, stage re-renders, and host callbacks. Extracted from
+ * {@link PptxViewer} to keep the class focused on its public API.
+ */
+declare function createStateSync(deps: StateSyncDeps): StoreListener<ViewerState>;
+//#endregion
+//#region src/viewer/theme-apply.d.ts
+/**
+ * Apply a `ViewerTheme` to the viewer root as inline `--pptx-*` custom
+ * properties (over the stylesheet defaults), removing whatever the previous
+ * theme set. Returns the list of property names now applied, to be passed
+ * back on the next call.
+ */
+declare function applyThemeVars(root: HTMLElement, theme: ViewerTheme$1 | undefined, previouslyApplied: readonly string[]): string[];
+//#endregion
+//#region src/viewer/styles/css.d.ts
+/** The full stylesheet text (theme-var defaults + chrome rules + editor + collab chrome). */
+declare function buildViewerCss(): string;
+//#endregion
 //#region src/viewer/styles/inject.d.ts
+/**
+ * Inject the viewer stylesheet into a document's `<head>` once (idempotent
+ * per document). Called automatically by `createPptxViewer`; hosts using a
+ * strict CSP without `style-src 'unsafe-inline'` can instead ship the string
+ * from `getViewerCss()` themselves and rely on this being a no-op once a
+ * `#pptx-vanilla-viewer-styles` node exists.
+ */
+declare function ensureViewerStyles(doc: Document): void;
 /** The complete viewer stylesheet text (for hosts that self-manage CSS). */
 export declare function getViewerCss(): string;
-//#endregion
-export { type AccountAuthConfig, type AutosaveRecord, type AutosaveStatus, BACKSTAGE_CARD_IDS, BACKSTAGE_PAGE_IDS, type BackstageCustomization, CANVAS_CONTEXT_MENU_COMMAND_IDS, type CollabLoadOrigin, type CollaborationConfig, type CollaborationController, type CollaborationControllerDeps, type CollaborationCursors, type CollaborationLivePatcher, type CollaborationRole, type CollaborationShell, type CollaborationShellOptions, type CollaborationShellState, type CollaborationTransport, type ConnectionStatus, type ContextMenuCustomization, type CssStyleMap, EDITOR_SHORTCUT_ACTION_IDS, ELEMENT_CONTEXT_MENU_COMMAND_IDS, type EditActions, type ElementRenderContext, type ElementRenderer, type ElementRendererRegistry, type ElementUpdate, type ElementUpdateOptions, type ExportGifOptions, type ExportPdfOptions, type ExportProgress, type ExportVideoOptions, type ExternalCollaborationAwareness, type ExternalCollaborationSession, type ExternalCollaborationSnapshot, type FindReplaceActions, type HostCanvasMenuContext, type HostElementMenuContext, type HostMenuCommand, type InlineEditorSession, type InlineListReadResult, type InlineTextEditSnapshot, type InlineTextSelection, type KeyboardCustomization, type LoadPresentationOptions, type LoadedPresentation, OPTIONS_PAGE_IDS, OPTIONS_SECTION_IDS, OPTIONS_SETTING_IDS, type OpenInlineEditorOptions, type OpenPrintWindow, type OptionsCustomization, type OptionsPageId, type OptionsSectionId, type OptionsSettingId, type OptionsSettingValues, type OverlayBox, PPTX_OPEN_ACCEPT, PRESENTATION_OPEN_EXTENSIONS, type PptxAiBridge, type PptxAiConfig, type PptxAiConnection, type PptxAiContextStrategy, type PptxAiToolName, type PptxAiWritePolicy, type PptxElement, type PptxElementType, type PptxHandler, type PptxHandlerSaveOptions, type PptxSlide, type PptxViewerCallbacks, type PptxViewerInstance, type PptxViewerOptions, type PptxViewerSource, type PrintOptions, RIBBON_TAB_IDS, type RemoteCursor, type RemoteSelectionOverlay, type ResolvedCustomization, type Ribbon, type RibbonCustomization, type RibbonDesignHandlers, type RibbonDrawHandlers, type RibbonDrawState, type RibbonEditState, type RibbonFileHandlers, type RibbonHandlers, type RibbonInsertHandlers, type RibbonNavHandlers, type RibbonNavState, type RibbonPrimaryHandlers, type RibbonSelectionState, type RibbonSlideShowHandlers, type RibbonTabId, type SanitizedPresence, type SavedPresentationFormat, type SessionDeck, type ShortcutChord, type SlideStageOptions, type Store, type SvgExportOptions, TOOLBAR_BUTTON_IDS, type ToolbarActionId, type TranslationKey, type TranslationMessages, type Translator, VIEWER_DIALOG_IDS, VIEWER_EXPORT_FORMAT_IDS, VIEWER_FEATURE_IDS, VIEWER_PANEL_IDS, type ViewerCustomization, type ViewerCustomizationApi, type ViewerDialogId, type ViewerExportFormatId, type ViewerFeatureId, type ViewerPanelId, type ViewerState, type ViewerTheme, type ViewerThemeColors, type ViewportFitOptions, type ViewportFitPadding, type ZoomLevel, buildInlineTextCommitPatch, canInteractWithElement, createImageElementFromFile, defaultCssVars, defaultRadius, defaultThemeColors, describeCollaborationShellState, forgetSessionDeck, getSessionTabId, isLegacyBinaryPresentation, isSupportedPresentationFile, loadPresentationDeck, loadSessionDeck, overlayInlineTextSnapshot, parsePresentationSessionId, presentationBaseName, rememberSessionDeck, restoreSessionDeck, savedPresentationFileName, themeToCssVars, vermilionDarkTheme, vermilionLightTheme };
+declare namespace index_d_exports {
+  export { AccessibilityPanel, AutosaveController, AutosaveRecord, AutosaveStatus, ButtonHandle, ChromeOptions, CollaborationConfig, CollaborationController, CollaborationRole, CollaborationTransport, ColorControlHandle, ConnectionStatus, ContextMenuAiHooks, ContextMenuCommandDeps, ContextMenuTableTarget, DEFAULT_RIBBON_TAB, DrawTool, DropdownHandle, DropdownItem, DropdownOptions, EditActions, ElementContextMenu, ElementContextMenuDeps, ExportCaptureDeps, ExportController, ExportControllerDeps, ExportGifOptions, ExportLifecycle, ExportLifecycleDeps, ExportPdfOptions, ExportProgress, ExportProgressModal, ExportProgressModalDeps, ExportProgressUi, ExportProgressUiDeps, ExportVideoDeps, ExportVideoOptions, FindReplaceActions, FindReplacePanel, IconName, Inspector, InspectorHandlers, InspectorState, KeyboardHandlers, LoadPresentationOptions, LoadedPresentation, MasterViewSidebar, MasterViewSidebarOptions, MobileActionSheets, MobileToolbar, MobileToolbarHandlers, NotesPanel, NotesPanelUpdate, NumberFieldHandle, OFFICE_STANDARD_SWATCHES, OpenPrintWindow, PptxViewer, PptxViewerCallbacks, PptxViewerInstance, PptxViewerOptions, PptxViewerSource, PresentationContextMenu, PresentationContextMenuDeps, PresentationController, PresentationToolbar, PresentationToolbarHandlers, PresentationToolbarState, PresentationTouchControls, PrintOptions, ProtectedViewBanner, RIBBON_TABS, RasterizeSlide, RasterizeSlideController, RasterizeSlideDeps, RasterizeSlideToRaster, RasterizeSlideToTiles, RenderController, RenderControllerDeps, Ribbon, RibbonDesignHandlers, RibbonDrawHandlers, RibbonDrawState, RibbonEditState, RibbonFileHandlers, RibbonHandlers, RibbonInsertHandlers, RibbonNavHandlers, RibbonNavState, RibbonPrimaryHandlers, RibbonSelectionState, RibbonSlideShowHandlers, RibbonTabBar, RibbonTabDef, RibbonTabId, RulerSelection, RulerStrips, RulerStripsState, ShortcutPanel, StateSyncDeps, Store, StoreListener, SvgExportOptions, SwatchPickerHandle, SwatchPickerOptions, ThumbnailRail, TouchGestureHandlers, TranslationMessages, Translator, ViewerChrome, ViewerExportApi, ViewerExportHost, ViewerState, ZoomLevel, applyThemeVars, attachKeyboardNavigation, attachTouchGestures, buildViewerChrome, buildViewerCss, clampSlideIndex, createAccessibilityPanel, createAutosaveController, createCollaborationController, createExportController, createExportLifecycle, createExportProgressModal, createExportProgressUi, createFindReplacePanel, createIcon, createInitialViewerState, createInspector, createMasterViewSidebar, createMobileActionSheets, createMobileToolbar, createNotesPanel, createPptxViewer, createPresentationController, createPresentationToolbar, createPresentationTouchControls, createProtectedViewBanner, createRasterizeSlide, createRenderController, createRibbon, createRibbonTabBar, createRulerStrips, createShortcutPanel, createStateSync, createStore, createThumbnailRail, createTranslator, ensureViewerStyles, exportAllSlidesToSvg, exportSlideToSvg, getViewerCss, isRibbonTab, loadPresentation, makeButton, makeColorControl, makeDropdown, makeNumberField, makeSwatchPicker, mountElementContextMenu, mountPresentationContextMenu, readTableCellTarget, renderToCanvas, resolveSourceToBuffer, resolveTableTarget, revokeBlobUrls, runContextMenuCommand, runGifExport, runPrint, runVideoExport };
+}
+type CssStyleMap = index_d_exports$1.CssStyleMap;
+type ElementRenderContext = index_d_exports$1.ElementRenderContext;
+type ElementRenderer = index_d_exports$1.ElementRenderer;
+type ElementRendererRegistry = index_d_exports$1.ElementRendererRegistry;
+type PptxElementType = index_d_exports$1.PptxElementType;
+type SlideStageOptions = index_d_exports$1.SlideStageOptions;
+type applyStyleMap = index_d_exports$1.applyStyleMap;
+type createDefaultRegistry = index_d_exports$1.createDefaultRegistry;
+type createEl = index_d_exports$1.createEl;
+type createElementRendererRegistry = index_d_exports$1.createElementRendererRegistry;
+type createSvgEl = index_d_exports$1.createSvgEl;
+type renderSlideStage = index_d_exports$1.renderSlideStage;
+export { type AccountAuthConfig, type AutosaveRecord, type AutosaveStatus, BACKSTAGE_CARD_IDS, BACKSTAGE_PAGE_IDS, type BackstageCustomization, CANVAS_CONTEXT_MENU_COMMAND_IDS, type CollabLoadOrigin, type CollaborationConfig, type CollaborationController, type CollaborationControllerDeps, type CollaborationCursors, type CollaborationLivePatcher, type CollaborationRole, type CollaborationShell, type CollaborationShellOptions, type CollaborationShellState, type CollaborationTransport, type ConnectionStatus, type ContextMenuCustomization, type CssStyleMap, EDITOR_SHORTCUT_ACTION_IDS, ELEMENT_CONTEXT_MENU_COMMAND_IDS, type EditActions, type ElementRenderContext, type ElementRenderer, type ElementRendererRegistry, type ElementUpdate, type ElementUpdateOptions, type ExportGifOptions, type ExportPdfOptions, type ExportProgress, type ExportVideoOptions, type ExternalCollaborationAwareness, type ExternalCollaborationSession, type ExternalCollaborationSnapshot, type FindReplaceActions, type HostCanvasMenuContext, type HostElementMenuContext, type HostMenuCommand, type InlineEditorSession, type InlineListReadResult, type InlineTextEditSnapshot, type InlineTextSelection, type KeyboardCustomization, type LoadPresentationOptions, type LoadedPresentation, OPTIONS_PAGE_IDS, OPTIONS_SECTION_IDS, OPTIONS_SETTING_IDS, type OpenInlineEditorOptions, type OpenPrintWindow, type OptionsCustomization, type OptionsPageId, type OptionsSectionId, type OptionsSettingId, type OptionsSettingValues, type OverlayBox, PPTX_OPEN_ACCEPT, PRESENTATION_OPEN_EXTENSIONS, type PptxAiBridge, type PptxAiConfig, type PptxAiConnection, type PptxAiContextStrategy, type PptxAiToolName, type PptxAiWritePolicy, type PptxElement, type PptxElementType, type PptxHandler, type PptxHandlerSaveOptions, type PptxSlide, type PptxViewerCallbacks, type PptxViewerInstance, type PptxViewerOptions, type PptxViewerSource, type PrintOptions, RIBBON_TAB_IDS, type RemoteCursor, type RemoteSelectionOverlay, type ResolvedCustomization, type Ribbon, type RibbonCustomization, type RibbonDesignHandlers, type RibbonDrawHandlers, type RibbonDrawState, type RibbonEditState, type RibbonFileHandlers, type RibbonHandlers, type RibbonInsertHandlers, type RibbonNavHandlers, type RibbonNavState, type RibbonPrimaryHandlers, type RibbonSelectionState, type RibbonSlideShowHandlers, type RibbonTabId, type SanitizedPresence, type SavedPresentationFormat, type SessionDeck, type ShortcutChord, type SlideStageOptions, type Store, type SvgExportOptions, TOOLBAR_BUTTON_IDS, type ToolbarActionId, type TranslationKey, type TranslationMessages, type Translator, VIEWER_DIALOG_IDS, VIEWER_EXPORT_FORMAT_IDS, VIEWER_FEATURE_IDS, VIEWER_PANEL_IDS, type ViewerCustomization, type ViewerCustomizationApi, type ViewerDialogId, type ViewerExportFormatId, type ViewerFeatureId, type ViewerPanelId, type ViewerState, type ViewerTheme, type ViewerThemeColors, type ViewportFitOptions, type ViewportFitPadding, type ZoomLevel, applyStyleMap, buildInlineTextCommitPatch, canInteractWithElement, createDefaultRegistry, createEl, createElementRendererRegistry, createImageElementFromFile, createSvgEl, createTranslator, defaultCssVars, defaultRadius, defaultThemeColors, describeCollaborationShellState, forgetSessionDeck, getSessionTabId, isLegacyBinaryPresentation, isSupportedPresentationFile, keyToLabel, loadPresentation, loadPresentationDeck, loadSessionDeck, overlayInlineTextSnapshot, parsePresentationSessionId, presentationBaseName, rememberSessionDeck, renderSlideStage, restoreSessionDeck, revokeBlobUrls, savedPresentationFileName, themeToCssVars, translationsEn, vermilionDarkTheme, vermilionLightTheme };
 //# sourceMappingURL=index.d.ts.map