pptx-react-viewer 4.14.0 → 4.16.0

package/dist/index.d.ts

@@ -13500,189 +13500,6 @@ interface CollaborationLivePatcher {
   /** Drop pending work, cancel timers and detach the doc. */
   dispose: () => void;
 }
-/**
- * A font supplied by the host application. The package never ships fonts:
- * applications provide a licensed URL, data URL, or blob URL for their users.
- */
-interface ViewerFontSource {
-  family: string;
-  src: string;
-  format?: 'truetype' | 'opentype' | 'woff' | 'woff2';
-  weight?: string | number;
-  style?: 'normal' | 'italic';
-}
-//#endregion
-//#region src/render/presentation-file-kinds.d.ts
-/**
- * presentation-file-kinds: the one place that answers "can the viewer open
- * this file?" and "what should the saved copy be called?".
- *
- * ## Why this is a shared decision and not five allow-lists
- *
- * The loader reads more formats than any single UI advertises. Legacy binary
- * `.ppt` (PowerPoint 97-2003) is the sharp example: `PptxHandler.load()` has
- * detected the OLE compound-file container and converted the binary deck
- * through the regular pptx pipeline for some time, but the product kept saying
- * it was unsupported, and a picker that filters the extension out makes a
- * working loader unreachable in practice. Whenever the loader learns a format,
- * exactly one list has to change.
- *
- * ## Read many, write several
- *
- * Input is a superset of output. We READ `.pptx`, `.ppsx`, `.pptm`, `.potx`,
- * legacy binary `.ppt` and portable `pptx-viewer-json`; we WRITE the OpenXML
- * family plus legacy binary `.ppt` (via `packages/core/src/core/ppt/writer/`,
- * a real MS-PPT/OLE2 encoder, not a stub). `savedPresentationFileName`
- * REPLACES the source extension with the extension of the format actually
- * being written rather than keeping the source's: a deck opened as
- * `report.pptx` and saved back as `.ppt` (or vice versa) must have its name
- * agree with its bytes, which is the kind of mismatch PowerPoint itself
- * refuses to open.
- *
- * This module deliberately imports nothing, so any layer (render, export, a
- * binding, a host app) can depend on it without risking an import cycle.
- *
- * @module render/presentation-file-kinds
- */
-/**
- * Extensions the built-in file picker offers, in the order it offers them.
- *
- * `.ppt` is in the list because the loader genuinely handles it, not as a
- * courtesy: see `packages/core/src/core/ppt/` and the `ppt-import` integration
- * suite, which asserts a `.ppt` loads to the same model as the `.pptx` it was
- * exported from.
- */
-declare const PRESENTATION_OPEN_EXTENSIONS: readonly ['.pptx', '.ppsx', '.pptm', '.potx', '.ppt', '.json'];
-/** Comma-separated `accept` attribute for a presentation file input. */
-declare const PPTX_OPEN_ACCEPT: string;
-/**
- * True when a picked / dropped file's name looks like something the loader can
- * open. Use this instead of a hand-rolled `endsWith` chain: a drop handler that
- * disagrees with the picker's `accept` list is a format that is supported by
- * mouse but not by drag, which is how `.ppt` stayed invisible.
- *
- * Extension-only, by design. The real answer comes from the container sniff in
- * `PptxHandler.load()`; this is only the cheap pre-filter a drop target needs
- * before it hands bytes to the loader.
- */
-declare function isSupportedPresentationFile(name: string | null | undefined): boolean;
-/**
- * True for the binary PowerPoint 97-2003 family. `.ppt` itself is now also a
- * SAVE target (see {@link SavedPresentationFormat}); `.pps`/`.pot` (97-2003
- * show/template) remain read-only siblings sharing the same record format.
- */
-declare function isLegacyBinaryPresentation(name: string | null | undefined): boolean;
-/** The formats the save path can produce. */
-type SavedPresentationFormat = 'pptx' | 'ppsx' | 'pptm' | 'ppt';
-/**
- * The stem of a presentation file name: directories and any loadable extension
- * removed. `C:\decks\report.ppt` becomes `report`; a name with no recognised
- * extension is kept whole, so `Untitled Presentation` survives intact rather
- * than losing everything after its last dot.
- */
-declare function presentationBaseName(sourceName: string | null | undefined, fallback?: string): string;
-/**
- * The name a saved copy should be offered under: the source stem plus the
- * extension of the format actually being written.
- *
- * This is what turns `report.ppt` into `report.pptx` on a regular Save As,
- * and `report.pptx` into `report.ppt` when the user explicitly picks the
- * PowerPoint 97-2003 format. Keeping the source extension would mislabel the
- * bytes either way.
- */
-declare function savedPresentationFileName(sourceName: string | null | undefined, format?: SavedPresentationFormat): string;
-//#endregion
-//#region src/render/editor-keymap.d.ts
-/** A logical editor command produced by one key press. */
-type EditorKeyActionName = 'undo' | 'redo' | 'copy' | 'cut' | 'paste' | 'duplicate' | 'delete' | 'selectAll' | 'group' | 'ungroup' | 'nudge' | 'prevSlide' | 'nextSlide' | 'escape' | 'find' | 'findReplace' | 'toggleShortcuts' | 'alignLeft' | 'alignCenter' | 'alignRight' | 'alignJustify' | 'increaseFontSize' | 'decreaseFontSize' | 'copyFormat' | 'pasteFormat' | 'newSlide' | 'hyperlink' | 'clearFormatting' | 'cycleSelectionNext' | 'cycleSelectionPrev' | 'pasteSpecial';
-//#endregion
-//#region src/render/merge-shapes/merge-shapes-menu.d.ts
-/** The right-click command id for each operation. */
-type MergeShapesCommandId = 'merge-union' | 'merge-combine' | 'merge-fragment' | 'merge-intersect' | 'merge-subtract';
-/** Every command a canvas context menu can offer, in no particular order. */
-type ContextMenuCommandId = 'copy' | 'cut' | 'paste' | 'duplicate' | 'edit-text' | 'edit-points' | 'bring-forward' | 'send-backward' | 'bring-front' | 'send-back' | 'ai-ask' | 'ai-fix' | 'comment' | 'hyperlink' | 'table-insert-row-above' | 'table-insert-row-below' | 'table-delete-row' | 'table-insert-col-left' | 'table-insert-col-right' | 'table-delete-col' | 'table-merge-selected' | 'table-merge-right' | 'table-merge-down' | 'table-split' | 'group' | 'ungroup' | 'crop' | MergeShapesCommandId | 'save-as-picture' | 'edit-alt-text' | 'size-and-position' | 'format-shape' | 'delete';
-//#endregion
-//#region src/render/canvas-context-menu-commands.d.ts
-/**
- * The right-click menu for the empty slide canvas (no element under the
- * cursor), as distinct from {@link ./context-menu-commands}'s per-element menu.
- *
- * Right-clicking empty canvas used to do nothing at all in every binding: React
- * and Vue both bailed out early (`getElementIdFromEvent` returns `null`, so the
- * handler just returns) rather than opening a menu, and the other three never
- * wired a handler for it either. PowerPoint offers Paste, Layout, Reset,
- * Format Background and view toggles (Grid and Guides, Ruler) from this menu;
- * this module is the one list every binding renders instead of five omissions.
- *
- * @module render/canvas-context-menu-commands
- */
-/** Every command the empty-canvas context menu can offer, in no particular order. */
-type CanvasContextMenuCommandId = 'paste' | 'layout' | 'reset-slide' | 'format-background' | 'grid-and-guides' | 'ruler';
-//#endregion
-//#region src/render/insert-chart.d.ts
-/**
- * Dropdown ids for the insert-chart menu. Distinct from `PptxChartType`
- * because PowerPoint offers Column (vertical) and Bar (horizontal) as two
- * entries over the same underlying `'bar'` chart type, and because `'pareto'`
- * has no `PptxChartType` of its own: it is a dropdown entry that resolves to
- * `type: 'histogram'` (see docs/guide/limitations.md's ChartEx row) with a
- * frequency-plus-cumulative-percentage default shape. The other six ChartEx
- * ids (`histogram` through `regionMap`) map one-to-one onto their chart type.
- */
-type InsertChartKind = 'column' | 'bar' | 'line' | 'pie' | 'doughnut' | 'area' | 'scatter' | 'histogram' | 'pareto' | 'funnel' | 'treemap' | 'sunburst' | 'boxWhisker' | 'regionMap';
-/** In-memory clipboard payload stored when an element is copied or cut. */
-interface ElementClipboardPayload {
-  element: PptxElement;
-  isTemplate: boolean;
-}
-//#endregion
-//#region src/render/image-file-insertion.d.ts
-/**
- * Decode a local image File/Blob into a centred element, fitting the slide
- * without upscaling. Dimensions are slide pixels; image bytes are preserved.
- *
- * Resolves null for unsupported/unreadable images, invalid bounds, cancellation,
- * or unavailable browser APIs. Importing this module is safe outside a browser.
- * No slide, selection, history, clipboard, or network state is changed. The
- * caller must still validate its document/slide destination before committing.
- */
-declare function createImageElementFromFile(file: Blob, canvasSize: CanvasSize$1, signal?: AbortSignal): Promise<ImagePptxElement | null>;
-//#endregion
-//#region src/render/editor-image-paste.d.ts
-/** A currently editable slide. Return null while loading or outside canvas editing. */
-interface EditorImagePasteTarget {
-  documentId: object;
-  slideId: string;
-  canvasSize: CanvasSize$1;
-}
-interface EditorImagePasteOptions {
-  getCanvas(): HTMLElement | null;
-  getTarget(): EditorImagePasteTarget | null;
-  /** Use the normal editor command so selection, dirty state and Undo stay consistent. */
-  insertElement(element: ImagePptxElement): void;
-}
-//#endregion
-//#region src/render/zoom-return-navigation.d.ts
-/**
- * The navigation-relevant fields of a Zoom click target, independent of
- * `zoomType`.
- *
- * `returnToParent` is already resolved to its EFFECTIVE value here (not the
- * raw, possibly-`undefined` `ZoomPptxElement`/`SummaryZoomTarget` field):
- * `CT_ZoomObjectProperties/@returnToParent` (MS-PPTX) is `<xsd:attribute
- * name="returnToParent" type="xsd:boolean" use="optional" default="true"/>`,
- * so an ABSENT attribute means true, not false. Core deliberately stores
- * `undefined` rather than fabricating `true` (so a round-trip never invents
- * an attribute the source never had), which makes `Boolean(x)` the wrong way
- * to read it; the two `resolve*NavigationTarget` functions below are the only
- * place that distinction should be made.
- */
-interface ZoomNavigationTarget {
-  targetSlideIndex: number;
-  targetSectionId?: string;
-  returnToParent: boolean;
-  transitionDurationMs?: number;
-}
 type BackstagePage = 'home' | 'new' | 'open' | 'info' | 'save' | 'saveAs' | 'print' | 'share' | 'export' | 'close' | 'account' | 'options';
 //#endregion
 //#region src/render/backstage-cards.d.ts
@@ -13699,52 +13516,6 @@ type BackstagePage = 'home' | 'new' | 'open' | 'info' | 'save' | 'saveAs' | 'pri
  */
 type BackstageCardId = 'protect' | 'inspect' | 'embedFonts' | 'signatures' | 'versionHistory' | 'saveAsPptx' | 'saveAsPpsx' | 'saveAsPptm' | 'saveAsPpt' | 'pdf' | 'png' | 'video' | 'gif' | 'json' | 'copyImage' | 'print' | 'share';
 //#endregion
-//#region src/render/account.d.ts
-/** Local-only display profile shown in File > Account. Never sent anywhere; purely cosmetic. */
-interface ViewerProfile {
-  displayName: string;
-  /** CSS color for the avatar bubble background, e.g. `'#c2431f'`. */
-  avatarColor: string;
-  /** Single character shown in the avatar bubble. Derived from `displayName` when omitted. */
-  initial?: string;
-}
-declare const DEFAULT_VIEWER_PROFILE: ViewerProfile;
-/** Suggested avatar color swatches for the Account profile editor. */
-declare const AVATAR_COLOR_SWATCHES: readonly string[];
-/** Derive the avatar-bubble initial from a profile, falling back to `'?'` for an empty name. */
-declare function resolveProfileInitial(profile: ViewerProfile): string;
-/**
- * Optional hook point for hosts that want to wire a real sign-in flow into
- * File > Account. Disabled by default: the Account page renders nothing
- * extra unless a host explicitly opts in by passing `enabled: true`.
- * See docs/guide for wiring instructions.
- */
-interface AccountAuthConfig {
-  enabled: boolean;
-  onSignIn: () => void;
-  signedInUser?: {
-    name: string;
-    email?: string;
-    avatarUrl?: string;
-  };
-}
-interface LocalStorageUsageSummary {
-  /** Number of presentations with a local autosave/recovery snapshot. */
-  presentationCount: number;
-  /** Total bytes across every stored snapshot. */
-  totalBytes: number;
-}
-/** Summarize local (IndexedDB) storage usage for the Account > Storage & Privacy panel. */
-declare function getLocalStorageUsageSummary(): Promise<LocalStorageUsageSummary>;
-/**
- * Delete every locally stored presentation/recovery snapshot and persisted
- * viewer preference (theme/locale/profile). Irreversible; callers should
- * confirm with the user before invoking this.
- */
-declare function clearAllLocalViewerData(): Promise<void>;
-/** Persist an updated profile via the shared viewer-prefs store. */
-declare function saveViewerProfile(profile: ViewerProfile): void;
-//#endregion
 //#region src/render/toolbar-actions.d.ts
 /**
  * Toolbar action / ribbon-tab visibility: a single, framework-agnostic
@@ -13778,6 +13549,39 @@ type ToolbarActionId = ToolbarButtonId | ToolbarTabId;
  */
 type RibbonContextualTabId = 'shapeFormat' | 'pictureFormat' | 'tableDesign' | 'chartDesign' | 'smartArtDesign';
 //#endregion
+//#region src/render/canvas-context-menu-commands.d.ts
+/**
+ * The right-click menu for the empty slide canvas (no element under the
+ * cursor), as distinct from {@link ./context-menu-commands}'s per-element menu.
+ *
+ * Right-clicking empty canvas used to do nothing at all in every binding: React
+ * and Vue both bailed out early (`getElementIdFromEvent` returns `null`, so the
+ * handler just returns) rather than opening a menu, and the other three never
+ * wired a handler for it either. PowerPoint offers Paste, Layout, Reset,
+ * Format Background and view toggles (Grid and Guides, Ruler) from this menu;
+ * this module is the one list every binding renders instead of five omissions.
+ *
+ * @module render/canvas-context-menu-commands
+ */
+/** Every command the empty-canvas context menu can offer, in no particular order. */
+type CanvasContextMenuCommandId = 'paste' | 'layout' | 'reset-slide' | 'format-background' | 'grid-and-guides' | 'ruler';
+//#endregion
+//#region src/render/merge-shapes/merge-shapes-menu.d.ts
+/** The right-click command id for each operation. */
+type MergeShapesCommandId = 'merge-union' | 'merge-combine' | 'merge-fragment' | 'merge-intersect' | 'merge-subtract';
+/** Every command a canvas context menu can offer, in no particular order. */
+type ContextMenuCommandId = 'copy' | 'cut' | 'paste' | 'duplicate' | 'edit-text' | 'edit-points' | 'bring-forward' | 'send-backward' | 'bring-front' | 'send-back' | 'ai-ask' | 'ai-fix' | 'comment' | 'hyperlink' | 'table-insert-row-above' | 'table-insert-row-below' | 'table-delete-row' | 'table-insert-col-left' | 'table-insert-col-right' | 'table-delete-col' | 'table-merge-selected' | 'table-merge-right' | 'table-merge-down' | 'table-split' | 'group' | 'ungroup' | 'crop' | MergeShapesCommandId | 'save-as-picture' | 'edit-alt-text' | 'size-and-position' | 'format-shape' | 'delete';
+/** Every command the Edit Points right-click menu can offer. */
+type EditPointsCommandId = 'add-point' | 'delete-point' | 'delete-segment' | 'open-path' | 'close-path' | 'smooth-point' | 'straight-point' | 'corner-point' | 'straight-segment' | 'curved-segment' | 'exit';
+//#endregion
+//#region src/render/edit-points/freeform-tool-geometry.d.ts
+/** The two click-to-place drawing tools. */
+type FreeformToolKind = 'freeformShape' | 'curve';
+//#endregion
+//#region src/render/editor-keymap.d.ts
+/** A logical editor command produced by one key press. */
+type EditorKeyActionName = 'undo' | 'redo' | 'copy' | 'cut' | 'paste' | 'duplicate' | 'delete' | 'selectAll' | 'group' | 'ungroup' | 'nudge' | 'prevSlide' | 'nextSlide' | 'escape' | 'find' | 'findReplace' | 'toggleShortcuts' | 'alignLeft' | 'alignCenter' | 'alignRight' | 'alignJustify' | 'increaseFontSize' | 'decreaseFontSize' | 'copyFormat' | 'pasteFormat' | 'newSlide' | 'hyperlink' | 'clearFormatting' | 'cycleSelectionNext' | 'cycleSelectionPrev' | 'pasteSpecial';
+//#endregion
 //#region src/render/options/viewer-options.d.ts
 /**
  * Full PowerPoint "File > Options" parity model.
@@ -13854,6 +13658,8 @@ interface ViewerSaveOptions {
   clearCacheOnClose: boolean;
 }
 interface ViewerAccessibilityOptions {
+  /** Browser speech-recognition language; automatic follows the browser language. */
+  subtitleLanguage?: string;
   showAccessibilityStatus: boolean;
   feedbackWithSound: boolean;
   soundScheme: FeedbackSoundScheme;
@@ -13935,43 +13741,8 @@ interface ViewerOptions {
   trust: ViewerTrustOptions;
 }
 type ViewerOptionsGroupId = keyof ViewerOptions;
-type ViewerOptionPrimitive = boolean | number | string;
-type StoredViewerOptions = { [G in ViewerOptionsGroupId]?: Partial<ViewerOptions[G]>; };
-//#endregion
-//#region src/render/viewer-prefs-storage.d.ts
-/**
- * `localStorage`-backed viewer chrome preferences (theme/locale/profile),
- * shared by every binding.
- *
- * This is the persistence layer behind File > Options' Appearance/Language
- * tabs and File > Account's profile editor when a host doesn't supply its
- * own `onThemeChange`/`onLocaleChange`/`onProfileChange` callbacks - i.e. the
- * "standalone" fallback path. Hosts that do wire those callbacks own
- * persistence themselves and this module is never touched.
- */
-declare const VIEWER_PREFS_STORAGE_KEY = "pptx-viewer-prefs";
-interface StoredViewerPrefs {
-  /** Key into the shared `THEME_CATALOG` (or a host-supplied `availableThemes` catalog). */
-  themeKey?: string;
-  /** Locale code, e.g. `'fr'`. */
-  localeCode?: string;
-  /** Local-only display profile shown in File > Account. */
-  profile?: ViewerProfile;
-  /** Sparse File > Options diff against `DEFAULT_VIEWER_OPTIONS`. */
-  options?: StoredViewerOptions;
-}
-/** Read all persisted viewer preferences. Returns `{}` when unavailable, unset, or corrupt. */
-declare function readStoredViewerPrefs(): StoredViewerPrefs;
-/** Merge `patch` into the persisted viewer preferences. Silently no-ops when storage is unavailable. */
-declare function writeStoredViewerPrefs(patch: Partial<StoredViewerPrefs>): void;
-/** Remove all persisted viewer preferences. Silently no-ops when storage is unavailable. */
-declare function clearStoredViewerPrefs(): void;
-/** Every command the Edit Points right-click menu can offer. */
-type EditPointsCommandId = 'add-point' | 'delete-point' | 'delete-segment' | 'open-path' | 'close-path' | 'smooth-point' | 'straight-point' | 'corner-point' | 'straight-segment' | 'curved-segment' | 'exit';
-//#endregion
-//#region src/render/edit-points/freeform-tool-geometry.d.ts
-/** The two click-to-place drawing tools. */
-type FreeformToolKind = 'freeformShape' | 'curve';
+type ViewerOptionPrimitive = boolean | number | string;
+type StoredViewerOptions = { [G in ViewerOptionsGroupId]?: Partial<ViewerOptions[G]>; };
 //#endregion
 //#region src/render/options/viewer-options-controls.d.ts
 /**
@@ -13980,6 +13751,25 @@ type FreeformToolKind = 'freeformShape' | 'curve';
  */
 type ViewerOptionsTabId = 'general' | 'proofing' | 'save' | 'language' | 'accessibility' | 'advanced' | 'ribbon' | 'quickAccess' | 'addIns' | 'trust';
 //#endregion
+//#region src/render/customization/host-menu-commands.d.ts
+/** Snapshot of the slide on which the host command was offered. */
+interface HostCanvasMenuContext {
+  slideIndex: number;
+}
+/** Effective selection, including a single right-clicked element. */
+interface HostElementMenuContext extends HostCanvasMenuContext {
+  elementIds: readonly string[];
+}
+/** Plain text labels work identically in every framework. */
+interface HostMenuCommand<C> {
+  id: string;
+  label: string;
+  /** Default: a separate group above the built-in commands. */
+  group?: 'top' | 'bottom';
+  disabled?: boolean | ((context: C) => boolean);
+  onSelect: (context: C) => void;
+}
+//#endregion
 //#region src/render/customization/ribbon-control-catalog.d.ts
 declare const RIBBON_CONTROL_CATALOG: {
   readonly home: {
@@ -14561,6 +14351,9 @@ interface BackstageCustomization {
 }
 /** Right-click menu customisation. */
 interface ContextMenuCustomization {
+  /** Additional host commands, independent of the viewer's AI connection. */
+  extraElementCommands?: readonly HostMenuCommand<HostElementMenuContext>[];
+  extraCanvasCommands?: readonly HostMenuCommand<HostCanvasMenuContext>[];
   /** Entries to remove from the element (right-click on a shape) menu. */
   hiddenElementCommands?: readonly ContextMenuCommandId[];
   /** Entries to remove from the empty-canvas menu. */
@@ -14682,6 +14475,8 @@ interface ResolvedCustomization {
   hiddenBackstagePages: ReadonlySet<BackstagePage>;
   hiddenBackstageCards: ReadonlySet<BackstageCardId>;
   hiddenElementCommands: ReadonlySet<ContextMenuCommandId>;
+  extraElementCommands: NonNullable<ViewerCustomization['contextMenu']>['extraElementCommands'];
+  extraCanvasCommands: NonNullable<ViewerCustomization['contextMenu']>['extraCanvasCommands'];
   hiddenCanvasCommands: ReadonlySet<CanvasContextMenuCommandId>;
   hiddenEditPointsCommands: ReadonlySet<EditPointsCommandId>;
   hiddenDrawingTools: ReadonlySet<ViewerDrawingToolId>;
@@ -14743,6 +14538,248 @@ interface ViewerCustomizationApi {
   setFeatureEnabled(feature: ViewerFeatureId, enabled: boolean): void;
   setDialogAvailable(dialog: ViewerDialogId, available: boolean): void;
 }
+/**
+ * A font supplied by the host application. The package never ships fonts:
+ * applications provide a licensed URL, data URL, or blob URL for their users.
+ */
+interface ViewerFontSource {
+  family: string;
+  src: string;
+  format?: 'truetype' | 'opentype' | 'woff' | 'woff2';
+  weight?: string | number;
+  style?: 'normal' | 'italic';
+}
+//#endregion
+//#region src/render/presentation-file-kinds.d.ts
+/**
+ * presentation-file-kinds: the one place that answers "can the viewer open
+ * this file?" and "what should the saved copy be called?".
+ *
+ * ## Why this is a shared decision and not five allow-lists
+ *
+ * The loader reads more formats than any single UI advertises. Legacy binary
+ * `.ppt` (PowerPoint 97-2003) is the sharp example: `PptxHandler.load()` has
+ * detected the OLE compound-file container and converted the binary deck
+ * through the regular pptx pipeline for some time, but the product kept saying
+ * it was unsupported, and a picker that filters the extension out makes a
+ * working loader unreachable in practice. Whenever the loader learns a format,
+ * exactly one list has to change.
+ *
+ * ## Read many, write several
+ *
+ * Input is a superset of output. We READ `.pptx`, `.ppsx`, `.pptm`, `.potx`,
+ * legacy binary `.ppt` and portable `pptx-viewer-json`; we WRITE the OpenXML
+ * family plus legacy binary `.ppt` (via `packages/core/src/core/ppt/writer/`,
+ * a real MS-PPT/OLE2 encoder, not a stub). `savedPresentationFileName`
+ * REPLACES the source extension with the extension of the format actually
+ * being written rather than keeping the source's: a deck opened as
+ * `report.pptx` and saved back as `.ppt` (or vice versa) must have its name
+ * agree with its bytes, which is the kind of mismatch PowerPoint itself
+ * refuses to open.
+ *
+ * This module deliberately imports nothing, so any layer (render, export, a
+ * binding, a host app) can depend on it without risking an import cycle.
+ *
+ * @module render/presentation-file-kinds
+ */
+/**
+ * Extensions the built-in file picker offers, in the order it offers them.
+ *
+ * `.ppt` is in the list because the loader genuinely handles it, not as a
+ * courtesy: see `packages/core/src/core/ppt/` and the `ppt-import` integration
+ * suite, which asserts a `.ppt` loads to the same model as the `.pptx` it was
+ * exported from.
+ */
+declare const PRESENTATION_OPEN_EXTENSIONS: readonly ['.pptx', '.ppsx', '.pptm', '.potx', '.ppt', '.json'];
+/** Comma-separated `accept` attribute for a presentation file input. */
+declare const PPTX_OPEN_ACCEPT: string;
+/**
+ * True when a picked / dropped file's name looks like something the loader can
+ * open. Use this instead of a hand-rolled `endsWith` chain: a drop handler that
+ * disagrees with the picker's `accept` list is a format that is supported by
+ * mouse but not by drag, which is how `.ppt` stayed invisible.
+ *
+ * Extension-only, by design. The real answer comes from the container sniff in
+ * `PptxHandler.load()`; this is only the cheap pre-filter a drop target needs
+ * before it hands bytes to the loader.
+ */
+declare function isSupportedPresentationFile(name: string | null | undefined): boolean;
+/**
+ * True for the binary PowerPoint 97-2003 family. `.ppt` itself is now also a
+ * SAVE target (see {@link SavedPresentationFormat}); `.pps`/`.pot` (97-2003
+ * show/template) remain read-only siblings sharing the same record format.
+ */
+declare function isLegacyBinaryPresentation(name: string | null | undefined): boolean;
+/** The formats the save path can produce. */
+type SavedPresentationFormat = 'pptx' | 'ppsx' | 'pptm' | 'ppt';
+/**
+ * The stem of a presentation file name: directories and any loadable extension
+ * removed. `C:\decks\report.ppt` becomes `report`; a name with no recognised
+ * extension is kept whole, so `Untitled Presentation` survives intact rather
+ * than losing everything after its last dot.
+ */
+declare function presentationBaseName(sourceName: string | null | undefined, fallback?: string): string;
+/**
+ * The name a saved copy should be offered under: the source stem plus the
+ * extension of the format actually being written.
+ *
+ * This is what turns `report.ppt` into `report.pptx` on a regular Save As,
+ * and `report.pptx` into `report.ppt` when the user explicitly picks the
+ * PowerPoint 97-2003 format. Keeping the source extension would mislabel the
+ * bytes either way.
+ */
+declare function savedPresentationFileName(sourceName: string | null | undefined, format?: SavedPresentationFormat): string;
+//#endregion
+//#region src/render/insert-chart.d.ts
+/**
+ * Dropdown ids for the insert-chart menu. Distinct from `PptxChartType`
+ * because PowerPoint offers Column (vertical) and Bar (horizontal) as two
+ * entries over the same underlying `'bar'` chart type, and because `'pareto'`
+ * has no `PptxChartType` of its own: it is a dropdown entry that resolves to
+ * `type: 'histogram'` (see docs/guide/limitations.md's ChartEx row) with a
+ * frequency-plus-cumulative-percentage default shape. The other six ChartEx
+ * ids (`histogram` through `regionMap`) map one-to-one onto their chart type.
+ */
+type InsertChartKind = 'column' | 'bar' | 'line' | 'pie' | 'doughnut' | 'area' | 'scatter' | 'histogram' | 'pareto' | 'funnel' | 'treemap' | 'sunburst' | 'boxWhisker' | 'regionMap';
+/** In-memory clipboard payload stored when an element is copied or cut. */
+interface ElementClipboardPayload {
+  element: PptxElement;
+  isTemplate: boolean;
+}
+//#endregion
+//#region src/render/image-file-insertion.d.ts
+/**
+ * Decode a local image File/Blob into a centred element, fitting the slide
+ * without upscaling. Dimensions are slide pixels; image bytes are preserved.
+ *
+ * Resolves null for unsupported/unreadable images, invalid bounds, cancellation,
+ * or unavailable browser APIs. Importing this module is safe outside a browser.
+ * No slide, selection, history, clipboard, or network state is changed. The
+ * caller must still validate its document/slide destination before committing.
+ */
+declare function createImageElementFromFile(file: Blob, canvasSize: CanvasSize$1, signal?: AbortSignal): Promise<ImagePptxElement | null>;
+//#endregion
+//#region src/render/editor-image-paste.d.ts
+/** A currently editable slide. Return null while loading or outside canvas editing. */
+interface EditorImagePasteTarget {
+  documentId: object;
+  slideId: string;
+  canvasSize: CanvasSize$1;
+}
+interface EditorImagePasteOptions {
+  getCanvas(): HTMLElement | null;
+  getTarget(): EditorImagePasteTarget | null;
+  /** Use the normal editor command so selection, dirty state and Undo stay consistent. */
+  insertElement(element: ImagePptxElement): void;
+}
+//#endregion
+//#region src/render/zoom-return-navigation.d.ts
+/**
+ * The navigation-relevant fields of a Zoom click target, independent of
+ * `zoomType`.
+ *
+ * `returnToParent` is already resolved to its EFFECTIVE value here (not the
+ * raw, possibly-`undefined` `ZoomPptxElement`/`SummaryZoomTarget` field):
+ * `CT_ZoomObjectProperties/@returnToParent` (MS-PPTX) is `<xsd:attribute
+ * name="returnToParent" type="xsd:boolean" use="optional" default="true"/>`,
+ * so an ABSENT attribute means true, not false. Core deliberately stores
+ * `undefined` rather than fabricating `true` (so a round-trip never invents
+ * an attribute the source never had), which makes `Boolean(x)` the wrong way
+ * to read it; the two `resolve*NavigationTarget` functions below are the only
+ * place that distinction should be made.
+ */
+interface ZoomNavigationTarget {
+  targetSlideIndex: number;
+  targetSectionId?: string;
+  returnToParent: boolean;
+  transitionDurationMs?: number;
+}
+interface SubtitleSettings {
+  spokenLanguage: string;
+}
+interface SubtitleSettingsLabels {
+  title: string;
+  language: string;
+  browserLanguage: string;
+  description: string;
+  apply: string;
+  cancel: string;
+}
+//#endregion
+//#region src/render/account.d.ts
+/** Local-only display profile shown in File > Account. Never sent anywhere; purely cosmetic. */
+interface ViewerProfile {
+  displayName: string;
+  /** CSS color for the avatar bubble background, e.g. `'#c2431f'`. */
+  avatarColor: string;
+  /** Single character shown in the avatar bubble. Derived from `displayName` when omitted. */
+  initial?: string;
+}
+declare const DEFAULT_VIEWER_PROFILE: ViewerProfile;
+/** Suggested avatar color swatches for the Account profile editor. */
+declare const AVATAR_COLOR_SWATCHES: readonly string[];
+/** Derive the avatar-bubble initial from a profile, falling back to `'?'` for an empty name. */
+declare function resolveProfileInitial(profile: ViewerProfile): string;
+/**
+ * Optional hook point for hosts that want to wire a real sign-in flow into
+ * File > Account. Disabled by default: the Account page renders nothing
+ * extra unless a host explicitly opts in by passing `enabled: true`.
+ * See docs/guide for wiring instructions.
+ */
+interface AccountAuthConfig {
+  enabled: boolean;
+  onSignIn: () => void;
+  signedInUser?: {
+    name: string;
+    email?: string;
+    avatarUrl?: string;
+  };
+}
+interface LocalStorageUsageSummary {
+  /** Number of presentations with a local autosave/recovery snapshot. */
+  presentationCount: number;
+  /** Total bytes across every stored snapshot. */
+  totalBytes: number;
+}
+/** Summarize local (IndexedDB) storage usage for the Account > Storage & Privacy panel. */
+declare function getLocalStorageUsageSummary(): Promise<LocalStorageUsageSummary>;
+/**
+ * Delete every locally stored presentation/recovery snapshot and persisted
+ * viewer preference (theme/locale/profile). Irreversible; callers should
+ * confirm with the user before invoking this.
+ */
+declare function clearAllLocalViewerData(): Promise<void>;
+/** Persist an updated profile via the shared viewer-prefs store. */
+declare function saveViewerProfile(profile: ViewerProfile): void;
+//#endregion
+//#region src/render/viewer-prefs-storage.d.ts
+/**
+ * `localStorage`-backed viewer chrome preferences (theme/locale/profile),
+ * shared by every binding.
+ *
+ * This is the persistence layer behind File > Options' Appearance/Language
+ * tabs and File > Account's profile editor when a host doesn't supply its
+ * own `onThemeChange`/`onLocaleChange`/`onProfileChange` callbacks - i.e. the
+ * "standalone" fallback path. Hosts that do wire those callbacks own
+ * persistence themselves and this module is never touched.
+ */
+declare const VIEWER_PREFS_STORAGE_KEY = "pptx-viewer-prefs";
+interface StoredViewerPrefs {
+  /** Key into the shared `THEME_CATALOG` (or a host-supplied `availableThemes` catalog). */
+  themeKey?: string;
+  /** Locale code, e.g. `'fr'`. */
+  localeCode?: string;
+  /** Local-only display profile shown in File > Account. */
+  profile?: ViewerProfile;
+  /** Sparse File > Options diff against `DEFAULT_VIEWER_OPTIONS`. */
+  options?: StoredViewerOptions;
+}
+/** Read all persisted viewer preferences. Returns `{}` when unavailable, unset, or corrupt. */
+declare function readStoredViewerPrefs(): StoredViewerPrefs;
+/** Merge `patch` into the persisted viewer preferences. Silently no-ops when storage is unavailable. */
+declare function writeStoredViewerPrefs(patch: Partial<StoredViewerPrefs>): void;
+/** Remove all persisted viewer preferences. Silently no-ops when storage is unavailable. */
+declare function clearStoredViewerPrefs(): void;
 //#endregion
 //#region src/render/viewport-fit.d.ts
 /** Unscaled CSS pixels reserved on each side of the ordinary viewer viewport. */
@@ -14759,6 +14796,31 @@ interface ViewportFitOptions {
 }
 /** The element fields an Edit Points commit writes. */
 type EditPointsElementPatch = Pick<ShapePptxElement, 'x' | 'y' | 'width' | 'height' | 'shapeType' | 'shapeAdjustments' | 'pathData' | 'pathWidth' | 'pathHeight' | 'customGeometryPaths' | 'customGeometryRawData' | 'customGeometryAdjustHandlesXY' | 'customGeometryAdjustHandlesPolar' | 'customGeometryConnectionSites' | 'customGeometryTextRect'>;
+type ThemeEditorLabels = Record<string, string>;
+//#endregion
+//#region src/web-components/theme-editor.d.ts
+interface PptxUiThemeEditorElement extends HTMLElement {
+  theme: PptxTheme | undefined;
+  labels: ThemeEditorLabels;
+  disabled: boolean;
+}
+declare global {
+  interface HTMLElementTagNameMap {
+    'pptx-ui-theme-editor': PptxUiThemeEditorElement;
+  }
+}
+//#endregion
+//#region src/web-components/subtitle-settings.d.ts
+interface PptxUiSubtitleSettingsElement extends HTMLElement {
+  settings: SubtitleSettings;
+  labels: SubtitleSettingsLabels;
+  languageDisabled: boolean;
+}
+declare global {
+  interface HTMLElementTagNameMap {
+    'pptx-ui-subtitle-settings': PptxUiSubtitleSettingsElement;
+  }
+}
 //#endregion
 //#region src/web-components/select-value.d.ts
 /** Public DOM shape used by all bindings; the element is not a native select. */
@@ -15991,4 +16053,4 @@ declare function SlideTemplatePreview({ templateId, scheme }: SlideTemplatePrevi
 declare function renderToCanvas(element: HTMLElement, options?: Partial<Options>): Promise<HTMLCanvasElement>;
 
 export { AVATAR_COLOR_SWATCHES, BACKSTAGE_CARD_IDS, BACKSTAGE_PAGE_IDS, CANVAS_CONTEXT_MENU_COMMAND_IDS, DEFAULT_VIEWER_PROFILE, EDITOR_SHORTCUT_ACTION_IDS, ELEMENT_CONTEXT_MENU_COMMAND_IDS, LOCALE_CATALOG, OPTIONS_PAGE_IDS, OPTIONS_SECTION_IDS, OPTIONS_SETTING_IDS, PPTX_OPEN_ACCEPT, PRESENTATION_OPEN_EXTENSIONS, PowerPointViewer, RIBBON_TAB_IDS, SLIDE_TEMPLATES, SlideCanvas, SlideTemplateGalleryDialog, SlideTemplatePreview, THEME_CATALOG, TOOLBAR_BUTTON_IDS, Toolbar, VIEWER_DIALOG_IDS, VIEWER_EXPORT_FORMAT_IDS, VIEWER_FEATURE_IDS, VIEWER_PANEL_IDS, VIEWER_PREFS_STORAGE_KEY, ViewerThemeProvider, buildSlideTemplateContent, buildSlideTemplateSlide, clearAllLocalViewerData, clearStoredViewerPrefs, createImageElementFromFile, defaultCssVars, defaultRadius, defaultThemeColors, describeCollaborationShellState, getAnimationInitialStyle, getLocalStorageUsageSummary, isLegacyBinaryPresentation, isSupportedPresentationFile, presentationBaseName, readStoredViewerPrefs, renderToCanvas, resolveProfileInitial, resolveThemeCatalogEntry, saveViewerProfile, savedPresentationFileName, themeToCssVars, useViewerBuildingBlocks, useViewerTheme, vermilionDarkColors, vermilionDarkTheme, vermilionLightColors, vermilionLightTheme, vermilionRadius, writeStoredViewerPrefs };
-export type { AccountAuthConfig, BackstageCustomization, CollaborationConfig, CollaborationContextValue, CollaborationShellState, ContextMenuCustomization, ElementUpdate, ElementUpdateOptions, ExternalCollaborationAwareness, ExternalCollaborationSession, ExternalCollaborationSnapshot, KeyboardCustomization, LocalStorageUsageSummary, LocaleCatalogEntry, OptionsCustomization, OptionsPageId, OptionsSectionId, OptionsSettingId, OptionsSettingValues, PowerPointViewerAPI, PowerPointViewerHandle, PowerPointViewerProps, PptxAiBridge, PptxAiConfig, PptxAiConnection, PptxAiContextStrategy, PptxAiToolName, PptxAiWritePolicy, ResolvedCustomization, RibbonCustomization, SavedPresentationFormat, ShortcutChord, SlideCanvasProps, SlideTemplateGalleryDialogProps, SlideTemplateId, SlideTemplatePreviewProps, SlideTemplateSpec, StoredViewerPrefs, ThemeCatalogEntry, ToolbarActionId, ToolbarButtonId, ToolbarProps, ToolbarTabId, UseViewerBuildingBlocksInput, ViewerBuildingBlocksResult, ViewerCustomization, ViewerCustomizationApi, ViewerDialogId, ViewerExportFormatId, ViewerFeatureId, ViewerMode, ViewerPanelId, ViewerProfile, ViewerTheme, ViewerThemeColors, ViewportFitOptions, ViewportFitPadding };
+export type { AccountAuthConfig, BackstageCustomization, CollaborationConfig, CollaborationContextValue, CollaborationShellState, ContextMenuCustomization, ElementUpdate, ElementUpdateOptions, ExternalCollaborationAwareness, ExternalCollaborationSession, ExternalCollaborationSnapshot, HostCanvasMenuContext, HostElementMenuContext, HostMenuCommand, KeyboardCustomization, LocalStorageUsageSummary, LocaleCatalogEntry, OptionsCustomization, OptionsPageId, OptionsSectionId, OptionsSettingId, OptionsSettingValues, PowerPointViewerAPI, PowerPointViewerHandle, PowerPointViewerProps, PptxAiBridge, PptxAiConfig, PptxAiConnection, PptxAiContextStrategy, PptxAiToolName, PptxAiWritePolicy, ResolvedCustomization, RibbonCustomization, SavedPresentationFormat, ShortcutChord, SlideCanvasProps, SlideTemplateGalleryDialogProps, SlideTemplateId, SlideTemplatePreviewProps, SlideTemplateSpec, StoredViewerPrefs, ThemeCatalogEntry, ToolbarActionId, ToolbarButtonId, ToolbarProps, ToolbarTabId, UseViewerBuildingBlocksInput, ViewerBuildingBlocksResult, ViewerCustomization, ViewerCustomizationApi, ViewerDialogId, ViewerExportFormatId, ViewerFeatureId, ViewerMode, ViewerPanelId, ViewerProfile, ViewerTheme, ViewerThemeColors, ViewportFitOptions, ViewportFitPadding };