pptx-vanilla-viewer 3.48.0 → 3.50.0

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import { a as __reExport, i as __exportAll, r as index_d_exports$2 } from "./transition-overlay-xJ7M4VZA.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, CollaborationInput, CollaborationInput as CollaborationInput$1, CollaborationLivePatcher, CollaborationLivePatcher as CollaborationLivePatcher$1, CollaborationRole, CollaborationShellState, CollaborationShellState as CollaborationShellState$1, CollaborationState, CollaborationState as CollaborationState$1, CollaborationState as CollaborationState$2, CollaborationTransport, CompatibilityWarningToast, ConnectionStatus, ConnectionStatus as ConnectionStatus$1, ContextMenuCommandId, ContextMenuCustomization, ContextMenuTableContext, CropElementUpdate, CropSession, DeckSaveIntent, DeckStyleState, DocumentStorage, 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, HostBackstagePage, HostBackstageRegionId, 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, PptxUiRibbonInsertElement, PresentationBlackout, PresentationPointerTool, PresentationSnapshot, PrintSettings, RIBBON_TAB_IDS, RasterizeElementResult, RasterizeElementTilesResult, ReadOnlyRecommendation, RemoteCursor, RemoteCursor as RemoteCursor$1, ResolvedCustomization, ResolvedCustomization as ResolvedCustomization$1, ReviewCommentsHost, RibbonAddInTab, RibbonContextualTabId, RibbonControlId, RibbonCustomization, RibbonGalleryApplyResult, RibbonGalleryContext, RibbonGroupId, RibbonTransitionDraft, RulerUnit, RunProgramNotice, SanitizedPresence, SanitizedPresence as SanitizedPresence$1, SavedPresentationFormat, SessionDeck, ShapePresetType, ShareDefaults, ShortcutChord, ShortcutChord as ShortcutChord$1, SlideCommentsChange, SlidePasteRequest, SlideSizeEmu, SlideSizeRescaleMode, SlideTemplateId, StatusBarAutosave, 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, ViewerCapabilityId, 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, ViewerRegionContext, ViewerRegionId, ViewerRegionRenderer, ViewerTheme, ViewerTheme as ViewerTheme$1, ViewerThemeColors, ViewportFitOptions, ViewportFitOptions as ViewportFitOptions$1, ViewportFitPadding, ZoomNavigationTarget, buildInlineTextCommitPatch, canInteractWithElement, createImageElementFromFile, defaultCssVars, defaultRadius, defaultThemeColors, describeCollaborationShellState, findReplacementAvailability, forgetSessionDeck, getSessionTabId, isLegacyBinaryPresentation, isSupportedPresentationFile, loadPresentationDeck, loadSessionDeck, overlayInlineTextSnapshot, parsePresentationSessionId, presentationBaseName, rememberSessionDeck, restoreSessionDeck, savedPresentationFileName, themeToCssVars, vermilionDarkTheme, vermilionLightTheme } from "ooxml-ui/pptx";
+import { AccountAuthConfig, AccountAuthConfig as AccountAuthConfig$1, AlignEdge, AnimationGroup, AutosaveActivation, AutosaveRecord, AutosaveRecord as AutosaveRecord$1, AutosaveRecoveryController, 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, CollaborationInput, CollaborationInput as CollaborationInput$1, CollaborationLivePatcher, CollaborationLivePatcher as CollaborationLivePatcher$1, CollaborationRole, CollaborationShellState, CollaborationShellState as CollaborationShellState$1, CollaborationState, CollaborationState as CollaborationState$1, CollaborationState as CollaborationState$2, CollaborationTransport, CompatibilityWarningToast, ConnectionStatus, ConnectionStatus as ConnectionStatus$1, ContextMenuCommandId, ContextMenuCustomization, ContextMenuTableContext, CropElementUpdate, CropSession, DeckSaveIntent, DeckStyleState, DocumentStorage, 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, HostBackstagePage, HostBackstageRegionId, HostCanvasMenuContext, HostElementMenuContext, HostMenuCommand, InlineListReadResult, InlineListReadResult as InlineListReadResult$1, InlineTextDraft, InlineTextEditSnapshot, InlineTextEditSnapshot as InlineTextEditSnapshot$1, InlineTextSelection, InlineTextSelection as InlineTextSelection$1, InsertChartKind, InsertChartOptions, KeyboardCustomization, MasterViewCrudAction, MasterViewCrudActionId, MobileSheetKey, 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, PptxUiRibbonInsertElement, PresentationBlackout, PresentationPointerTool, PresentationSnapshot, PrintSettings, RIBBON_TAB_IDS, RasterizeElementResult, RasterizeElementTilesResult, ReadOnlyBannerPasswordError, ReadOnlyRecommendation, RemoteCursor, RemoteCursor as RemoteCursor$1, ResolvedCustomization, ResolvedCustomization as ResolvedCustomization$1, ReviewCommentsHost, RibbonAddInTab, RibbonContextualTabId, RibbonControlId, RibbonCustomization, RibbonGalleryApplyResult, RibbonGalleryContext, RibbonGroupId, RibbonTransitionDraft, RulerUnit, RunProgramNotice, SanitizedPresence, SanitizedPresence as SanitizedPresence$1, SavedPresentationFormat, SessionDeck, ShapePresetType, ShareDefaults, ShortcutChord, ShortcutChord as ShortcutChord$1, SlideCommentsChange, SlidePasteRequest, SlideSizeEmu, SlideSizeRescaleMode, SlideTemplateId, StatusBarAutosave, StrokeToInkElementOpts, TOOLBAR_BUTTON_IDS, TextAdvancedChanges, ThemeCatalogEntry, ToolbarActionId, ToolbarActionId as ToolbarActionId$1, ToolbarButtonId, ToolbarTabId, VIEWER_DIALOG_IDS, VIEWER_EXPORT_FORMAT_IDS, VIEWER_FEATURE_IDS, VIEWER_PANEL_IDS, ViewerAutosaveStatus, ViewerCapabilityId, 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, ViewerRegionContext, ViewerRegionId, ViewerRegionRenderer, ViewerTheme, ViewerTheme as ViewerTheme$1, ViewerThemeColors, ViewportFitOptions, ViewportFitOptions as ViewportFitOptions$1, ViewportFitPadding, ZoomExcursion, ZoomNavigationTarget, buildInlineTextCommitPatch, canInteractWithElement, createImageElementFromFile, defaultCssVars, defaultRadius, defaultThemeColors, describeCollaborationShellState, findReplacementAvailability, 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";
@@ -27,10 +27,8 @@ export declare function createStore<T extends object>(initial: T): Store<T>;
 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`). */
-type ModifyPasswordErrorReason$1 = Extract<ModifyPasswordCheckResult, {
-  ok: false;
-}>['reason'];
+/** Why the last password attempt failed; see `checkModifyPassword` (`ooxml-ui/pptx`). */
+type ModifyPasswordErrorReason$1 = ReadOnlyBannerPasswordError;
 /** `zoom` is either an explicit scale factor (1 = 100%) or fit-to-viewport. */
 type ZoomLevel = number | 'fit';
 /**
@@ -318,9 +316,18 @@ interface ViewerState {
    * Whether the read-only recommendation banner has been closed for this
    * load, by either "Edit anyway" or the plain dismiss button. Independent
    * from whether editing is actually locked: "Dismiss" hides the banner but
-   * keeps the lock, only "Edit anyway" lifts it too.
+   * keeps the lock, only "Edit anyway" lifts it too (see
+   * {@link readOnlyEditAnyway}).
    */
   readOnlyBannerDismissed: boolean;
+  /**
+   * Whether "Edit anyway" (or the right password) lifted the read-only
+   * recommendation's lock for this load. The lock is ANDed into the editable
+   * state, so the host's `setEditable(true)` does not lift it. Optional so a
+   * host state built before this field still type-checks; missing reads as
+   * false (`createInitialViewerState` sets it).
+   */
+  readOnlyEditAnyway?: boolean;
   /**
    * The loaded deck's raw `p:modifyVerifier`, kept alongside
    * {@link readOnlyRecommendation} so `submitReadOnlyPassword` can check a
@@ -337,6 +344,13 @@ interface ViewerState {
   readOnlyPasswordError: ModifyPasswordErrorReason$1 | null;
   /** True while a submitted password is being checked; disables the form. */
   readOnlyCheckingPassword: boolean;
+  /**
+   * Which password check a result belongs to (`ReadOnlySession.passwordCheck`
+   * in `ooxml-ui/pptx`): a new load, Cancel and every new check move it on,
+   * so a check that finishes late is dropped. Optional like
+   * {@link readOnlyEditAnyway}; missing reads as 0.
+   */
+  readOnlyPasswordCheck?: number;
   /**
    * Compatibility-warning toasts for the current load (deck-level
    * `data.warnings` concatenated with every slide's own `warnings`, deduped
@@ -730,9 +744,6 @@ interface InspectorActions {
   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<index_d_exports$2.PptxSmartArtNodeStyle>): void;
-  mutateSmartArtNode(nodeId: string, action: 'add' | 'addChild' | 'remove' | 'promote' | 'demote'): void;
   replaceSmartArtData(data: index_d_exports$2.PptxSmartArtData): void;
   setSmartArtLayout(layout: index_d_exports$2.SmartArtLayoutType): void;
   setSmartArtColorScheme(scheme: index_d_exports$2.SmartArtColorScheme): void;
@@ -905,8 +916,14 @@ interface EditActions extends TextActions, ArrangeActions, ClipboardActions, Sli
   masterView: MasterViewCrudActions;
   comments: CommentActions;
   toggleFormatPainter(): void;
-  setShapeFill(color: string, ref?: index_d_exports$2.PptxThemeColorRef): void;
-  setShapeStroke(color: string, ref?: index_d_exports$2.PptxThemeColorRef): void;
+  /**
+   * Every pick adds `color` to the recent colours except a drag tick through
+   * the native colour picker (`committed: false`), which only applies live:
+   * the picker records the colour it settles on through `pushRecentColor`.
+   */
+  setShapeFill(color: string, ref?: index_d_exports$2.PptxThemeColorRef, committed?: boolean): void;
+  /** Same `committed` contract as {@link setShapeFill}, for the outline colour. */
+  setShapeStroke(color: string, ref?: index_d_exports$2.PptxThemeColorRef, committed?: boolean): void;
   setShapeStrokeWidth(width: number): void;
   setShapeStyle(patch: Partial<index_d_exports$2.ShapeStyle>): void;
   setShapeType(shapeType: string): void;
@@ -923,7 +940,8 @@ interface EditActions extends TextActions, ArrangeActions, ClipboardActions, Sli
   /** Existing history-tracked insertion transaction for a prepared element. */
   insertElement(element: index_d_exports$2.PptxElement): void;
   /** Insert a default chart for the given dropdown entry (defaults to Column). */
-  insertChart(chartKind?: InsertChartKind): void;
+  /** `options` carries the Insert Chart dialog's title and grouping. */
+  insertChart(chartKind?: InsertChartKind, options?: InsertChartOptions): void;
   insertSmartArt(layout: index_d_exports$2.SmartArtLayout, defaultItems: string[]): void;
   insertEquation(omml: Record<string, unknown>): void;
   updateEquation(id: string, omml: Record<string, unknown>): void;
@@ -1123,11 +1141,14 @@ interface InspectorHandlers {
   /**
    * 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?: index_d_exports$2.PptxThemeColorRef): void;
-  /** Same `ref` contract as {@link setShapeFill}, for the stroke colour. */
-  setShapeStroke(color: string, ref?: index_d_exports$2.PptxThemeColorRef): void;
+   * previously-stored ref for a plain/custom/recent pick. The colour also
+   * goes into the recent colours, unless `committed` is `false`: a drag tick
+   * through the native picker, which records only the colour it settles on
+   * (its `change`, through {@link pushRecentColor}).
+   */
+  setShapeFill(color: string, ref?: index_d_exports$2.PptxThemeColorRef, committed?: boolean): void;
+  /** Same `ref` and `committed` contract as {@link setShapeFill}, for the stroke colour. */
+  setShapeStroke(color: string, ref?: index_d_exports$2.PptxThemeColorRef, committed?: boolean): void;
   setShapeStrokeWidth(width: number): void;
   setShapeStyle(patch: Partial<index_d_exports$2.ShapeStyle>): void;
   setShapeType(shapeType: string): void;
@@ -1212,15 +1233,11 @@ interface InspectorHandlers {
   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<index_d_exports$2.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.
+   * like every other SmartArt mutation. Used by the text pane
+   * (`pptx-ui-smartart-text-pane`), which computes the next data through the
+   * pptx SmartArt facades before emitting it.
    */
   replaceSmartArtData(data: index_d_exports$2.PptxSmartArtData): void;
   setSmartArtLayout(layout: index_d_exports$2.SmartArtLayoutType): void;
@@ -1940,8 +1957,8 @@ interface PresentationTouchControls {
 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`). */
-type ModifyPasswordErrorReason = 'wrong-password' | 'unsupported-algorithm';
+/** Why the last password attempt failed; see `checkModifyPassword` (`ooxml-ui/pptx`). */
+type ModifyPasswordErrorReason = ReadOnlyBannerPasswordError;
 //#endregion
 //#region src/viewer/ui/ribbon/tabs/view-tab.d.ts
 /** The View > Show toggles, as the viewer state currently holds them. */
@@ -2978,57 +2995,6 @@ 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: index_d_exports$2.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
@@ -3186,6 +3152,8 @@ interface PresentationPlayback {
    * caller falls through to its normal show-order advance.
    */
   consumeZoomReturnOnAdvance(currentSlideIndex: number): number | undefined;
+  /** The pending zoom excursion, read by the shared show step without consuming it. */
+  peekZoomExcursion(): ZoomExcursion | undefined;
   /** Cancel any running transition/timers and forget all per-slide state. */
   reset(): void;
   /**
@@ -3334,39 +3302,25 @@ declare function createRenderController(deps: RenderControllerDeps): RenderContr
 //#endregion
 //#region src/viewer/autosave/autosave-controller.d.ts
 /**
- * Debounced autosave for the vanilla viewer, layered on the shared IndexedDB
- * recovery store (`pptx-viewer-shared/autosave-store`).
- *
- * A local edit marks the document dirty; a debounce timer then re-serializes the
- * deck through the shared `saveDeckWithPassword` and persists it under
- * `filePath` via `saveAutosaveSnapshot` (evicting the oldest record on quota
- * exhaustion). The recovery blob is a crash-safety net only; **it never clears
- * the editor's dirty flag** or stands in for the user's real Save.
- *
- * The snapshot is written with `recoverySnapshotIntent`, so it is a plain ZIP
- * even when the deck is password protected: `getAutosaveSnapshot` hands the
- * bytes back with no password, and an encrypted package would simply refuse to
- * open (see `deck-save-encryption` in `pptx-viewer-shared` for the reasoning
- * and the cleartext-at-rest tradeoff it accepts).
- *
- * Two decisions are NOT made here, so all five bindings share them:
+ * The vanilla adapter of the shared recovery autosave engine
+ * (`createAutosaveController` in `ooxml-ui/pptx`) and of the shared recovery
+ * offer (`createAutosaveRecoveryController`).
  *
- *  - **whether autosave runs at all** comes from the shared
- *    `resolveAutosaveActivation` verdict, read live through
- *    {@link AutosaveControllerDeps.getActivation}. This controller never owns a
- *    raw `enabled` boolean, because the host prop is a ceiling and the user's
- *    toggle is a preference inside it.
- *  - **how long the debounce may defer a snapshot** comes from the shared
- *    `nextAutosaveDelayMs`. A plain re-armed debounce can defer forever while
- *    the user keeps typing; the ceiling keeps the promise that a snapshot lands
- *    no later than one interval after the FIRST unsaved edit.
+ * The engine follows PowerPoint's AutoRecover: while there are unsaved edits a
+ * snapshot (always a plain ZIP, written with `recoverySnapshotIntent`) lands
+ * one interval after the first edit, and nothing is written while the deck is
+ * unchanged. A recovery snapshot **never clears the editor's dirty flag**: it
+ * is a crash-safety net, not the user's Save. Whether autosave runs at all is
+ * the shared `resolveAutosaveActivation` verdict, read live through
+ * {@link AutosaveControllerDeps.getActivation}.
  *
- * Recovery is probed once per loaded deck through the shared
- * `shouldProbeAutosaveRecovery` / `probeAutosaveRecovery` pair, and surfaced
- * both to the host callback ({@link AutosaveControllerDeps.onRecovery}) and to
- * the viewer's own prompt ({@link AutosaveControllerDeps.onRecoveryOffer}).
+ * This adapter only feeds the engine from the store (local edits set `dirty`;
+ * loads and remote collaboration applies do not) and serialises the deck. The
+ * recovery offer is probed once per loaded deck and surfaced both to the host
+ * callback ({@link AutosaveControllerDeps.onRecovery}) and to the viewer's own
+ * prompt ({@link AutosaveControllerDeps.onRecoveryOffer}).
  */
-type AutosaveStatus = 'idle' | 'saving' | 'saved' | 'error';
+type AutosaveStatus = ViewerAutosaveStatus;
 interface AutosaveControllerDeps {
   store: Store<ViewerState>;
   /** Live core handler used to serialize the current slides to `.pptx` bytes. */
@@ -3385,8 +3339,7 @@ interface AutosaveControllerDeps {
   /**
    * 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.
+   * whatever it says.
    */
   getSaveIntent?: () => DeckSaveIntent;
   /** Surface status transitions (toolbar indicator + optional host callback). */
@@ -3405,16 +3358,22 @@ interface AutosaveControllerDeps {
    * still be asked about work a crash left behind.
    */
   isRecoveryAllowed?: () => boolean;
+  /** Load restored bytes through the viewer's load path (the recovery offer's restore). */
+  loadFile?: (bytes: Uint8Array) => Promise<void> | void;
 }
 interface AutosaveController {
-  /** Force an immediate snapshot, bypassing the debounce window. */
+  /** Force an immediate snapshot of unsaved edits (no-op while autosave is not active). */
   saveNow(): Promise<void>;
+  /** In-progress inline text: a changed draft is an edit and goes into the snapshot. */
+  noteInlineDraft(draft: InlineTextDraft | null): 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;
+  /** The shared recovery offer (restore and dismiss). */
+  getRecovery(): AutosaveRecoveryController;
   /** Tear down the timer + store subscription. */
   destroy(): void;
 }
@@ -3668,31 +3627,32 @@ declare function createExportController(deps: ExportControllerDeps): ExportContr
 //#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).
+ * ExportProgressModal: the progress modal shown while a multi-slide export (PDF / GIF / WebM)
+ * runs. A thin adapter over the shared `pptx-ui-export-progress`, which owns the dialog and
+ * progress bar semantics, focus and the look, and is deliberately not dismissable: the export
+ * ends by completing, erroring or 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. */
+  /** Hide the modal. */
   close(): void;
 }
 interface ExportProgressModalDeps {
   doc: Document;
   getTranslator(): Translator;
+  /**
+   * Where the modal mounts: the viewer's chrome root, so it takes the viewer's theme variables.
+   * Defaults to `doc.body`.
+   */
+  getHost?(): HTMLElement;
   /** The Cancel control was pressed (abort the in-flight export). */
   onCancel(): void;
 }
-/** Build a (closed) progress modal; `open` mounts it onto `doc.body`. */
+/** Build a (closed) progress modal; `open` mounts it into the host. */
 declare function createExportProgressModal(deps: ExportProgressModalDeps): ExportProgressModal;
 //#endregion
 //#region src/viewer/export/export-progress-ui.d.ts
@@ -4576,6 +4536,8 @@ interface ExportLifecycleDeps {
   doc: Document;
   /** Host the off-screen capture stage mounts into; matches the viewer container. */
   container: HTMLElement;
+  /** Where the export progress modal mounts (the chrome root, which carries the theme). */
+  getModalHost?(): HTMLElement;
   store: Store<ViewerState>;
   registry: index_d_exports$1.ElementRendererRegistry;
   getTranslator(): Translator;
@@ -4751,6 +4713,8 @@ export declare class PptxViewer extends ViewerCustomizationHost implements PptxV
   /** Host/user intent is retained while collaboration temporarily disables editing. */
   private requestedEditable;
   private requestedReadOnly;
+  /** The read-only banner's actions over the store (the shared `read-only-session` model). */
+  private readonly readOnlyActions;
   private annotations;
   private parityWorkflows;
   private aiChat;
@@ -5014,7 +4978,8 @@ export declare class PptxViewer extends ViewerCustomizationHost implements PptxV
   /**
    * The edit state the viewer actually runs in: what the host asked for (the
    * `editable` option and `readOnly` flag, `setEditable`), AND-ed with a
-   * collaboration read-only role and the `capabilities.edit` customisation.
+   * collaboration read-only role, the `capabilities.edit` customisation and
+   * the deck's read-only recommendation until "Edit anyway" lifts it.
    */
   private effectiveEditable;
   private applyEditable;
@@ -5023,7 +4988,9 @@ export declare class PptxViewer extends ViewerCustomizationHost implements PptxV
   /**
    * The read-only recommendation banner's "Edit anyway" button
    * (`p:modifyVerifier` / "Mark as Final"): lifts the lock and hides the
-   * banner, unlike plain dismiss which only hides it.
+   * banner, unlike plain dismiss which only hides it. The lock is ANDed into
+   * {@link effectiveEditable}, so lifting it never turns on editing the host
+   * did not ask for.
    *
    * When the recommendation's `requiresPassword` is set (a `modifyVerifier`
    * with a hash this viewer can check), this opens the inline password
@@ -5038,8 +5005,9 @@ export declare class PptxViewer extends ViewerCustomizationHost implements PptxV
   cancelReadOnlyPasswordPrompt(): void;
   /**
    * Check `password` against the deck's `modifyVerifier`
-   * (`checkModifyPassword`, `pptx-viewer-shared`); unlocks and closes the
-   * prompt on a match, otherwise leaves the deck locked and reports why.
+   * (`checkModifyPassword`, `ooxml-ui/pptx`); unlocks and closes the prompt
+   * on a match, otherwise leaves the deck locked and reports why. A result
+   * that arrives after a new load or Cancel is dropped.
    */
   submitReadOnlyPassword(password: string): void;
   private checkReadOnlyPassword;
@@ -5265,8 +5233,10 @@ interface CollaborationController {
 //#endregion
 //#region src/viewer/collab/collaboration-controller.d.ts
 /**
- * Yjs collaboration with built-in transports or a borrowed host session.
- * Granular slide sync and presence live in their focused modules.
+ * Yjs collaboration with built-in transports or a borrowed host session. The
+ * room lifecycle (owned sessions, transport, connection status, first-write
+ * gate, pagehide teardown) is the shared `createCollaborationSessionController`;
+ * granular slide sync and presence live in their focused modules.
  *
  * KNOWN LIMITATION: collaboration undo semantics are undefined - the local
  * `EditorHistory` stack keeps working but does not coordinate with peers
@@ -5384,7 +5354,7 @@ declare function ensureViewerStyles(doc: Document): void;
 /** The complete viewer stylesheet text (for hosts that self-manage CSS). */
 export declare function getViewerCss(): string;
 declare namespace index_d_exports {
-  export { AccessibilityPanel, AutosaveController, AutosaveRecord, AutosaveStatus, ButtonHandle, ChromeOptions, CollaborationConfig, CollaborationController, CollaborationRole, CollaborationState$2 as CollaborationState, 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 };
+  export { AccessibilityPanel, AutosaveController, AutosaveRecord, AutosaveStatus, ButtonHandle, ChromeOptions, CollaborationConfig, CollaborationController, CollaborationRole, CollaborationState$2 as CollaborationState, 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, 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, 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, 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;