pptx-vanilla-viewer 2.2.0 → 2.4.0

package/dist/index.d.ts

@@ -3,7 +3,7 @@ import "jszip";
 import { ChatTransport, LanguageModel, ToolSet, UIMessage } from "ai";
 import "pptx-viewer-mcp";
 import { Options } from "html2canvas-pro";
-//#region ../core/dist/text-operations-Dxy1YFgs.d.ts
+//#region ../core/dist/text-operations-CCau8x-H.d.ts
 //#region src/core/types/actions.d.ts
 /**
  * Action types: hyperlinks, slide jumps, macros, and action buttons.
@@ -53,10 +53,22 @@ interface PptxAction {
  * @example
  * ```ts
  * const type: ElementActionType = "slide";
- * // => "slide" — one of: "none" | "url" | "slide" | "firstSlide" | "lastSlide" | "prevSlide" | "nextSlide" | "endShow"
- * ```
- */
-type ElementActionType = 'none' | 'url' | 'slide' | 'firstSlide' | 'lastSlide' | 'prevSlide' | 'nextSlide' | 'endShow';
+ * // => "slide": one of: "none" | "url" | "slide" | "firstSlide" | "lastSlide" | "prevSlide" | "nextSlide" | "endShow" | "lastViewed" | "customShow" | "openFile" | "openPresentation" | "playMedia" | "oleVerb"
+ * ```
+ */
+type ElementActionType = 'none' | 'url' | 'slide' | 'firstSlide' | 'lastSlide' | 'prevSlide' | 'nextSlide' | 'endShow' |
+/** `ppaction://hlinkshowjump?jump=lastslideviewed` - back to the last slide the audience saw. */
+'lastViewed' |
+/** `ppaction://customshow?id=N[&return=true]` - jump into a named custom show. */
+'customShow' |
+/** `ppaction://hlinkfile` - open an external file via the action's `r:id`. */
+'openFile' |
+/** `ppaction://hlinkpres` - open another presentation via the action's `r:id`. */
+'openPresentation' |
+/** `ppaction://media` - play (or toggle) the element's own embedded media. */
+'playMedia' |
+/** `ppaction://ole?verb=N` - run a numbered OLE verb on an embedded object. */
+'oleVerb';
 /**
  * User-facing action configuration stored on an element.
  * This is a convenience wrapper around the lower-level `PptxAction` that maps
@@ -83,10 +95,16 @@ interface ElementAction {
   trigger: 'click' | 'hover';
   /** What kind of action to perform. */
   type: ElementActionType;
-  /** External URL (for 'url' type). */
+  /** External URL (for 'url' type), or the resolved external target (for 'openFile' / 'openPresentation'). */
   url?: string;
   /** Zero-based slide index (for 'slide' type). */
   slideIndex?: number;
+  /** Custom show identifier (for 'customShow' type), from `ppaction://customshow?id=`. */
+  customShowId?: string;
+  /** Whether the show returns to its origin after the custom show ends (`&return=true`), for 'customShow'. */
+  returnAfter?: boolean;
+  /** OLE verb number (for 'oleVerb' type), from `ppaction://ole?verb=`. */
+  oleVerb?: number;
 }
 //#endregion
 //#region src/core/types/common.d.ts
@@ -8339,7 +8357,7 @@ interface PptxEmbeddedFont {
   originalPartBytes?: Uint8Array;
 }
 //#endregion
-//#region ../core/dist/index-mqQTixoV.d.ts
+//#region ../core/dist/index-CcItPDSd.d.ts
 //#region src/core/types/theme-presets.d.ts
 /**
  * A complete theme preset that can be applied to a presentation.
@@ -10613,6 +10631,19 @@ interface AutosaveRecord {
   timestamp: number;
   size: number;
 }
+//#endregion
+//#region src/render/master-view-crud.d.ts
+/** One Slide Master view sidebar command. */
+type MasterViewCrudActionId = 'addLayout' | 'duplicateLayout' | 'deleteLayout' | 'renameLayout' | 'addMaster' | 'duplicateMaster' | 'deleteMaster' | 'renameMaster';
+/** A framework-neutral descriptor for one sidebar button. */
+interface MasterViewCrudAction {
+  id: MasterViewCrudActionId;
+  /** i18n key for the button label (`pptx.masterView.<id>`). */
+  labelKey: string;
+  enabled: boolean;
+  /** i18n key explaining why the button is disabled, set only when it is. */
+  disabledReasonKey?: 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
@@ -10706,26 +10737,25 @@ interface PrintSettings {
   scaleToFit?: boolean;
 }
 //#endregion
-//#region src/viewer/state/store.d.ts
-/**
- * A tiny framework-free reactive store: `get` / `set(patch)` / `subscribe`.
- *
- * This is deliberately minimal (a few dozen lines, no external deps). It only
- * carries the vanilla binding's *view state*; all domain logic (parsing,
- * styles, geometry, text building) stays in `pptx-viewer-core` and
- * `pptx-viewer-shared`.
- */
-/** Listener invoked after every state change with the next and previous state. */
-type StoreListener<T> = (state: T, previous: T) => void;
-interface Store<T extends object> {
-  /** Current state snapshot (do not mutate). */
-  get(): T;
-  /** Shallow-merge a partial patch into the state and notify subscribers. */
-  set(patch: Partial<T>): void;
-  /** Subscribe to state changes; returns an unsubscribe function. */
-  subscribe(listener: StoreListener<T>): () => void;
+//#region src/render/slide-size-rescale.d.ts
+type SlideSizeRescaleMode = 'maximize' | 'ensureFit';
+type ReadOnlyRecommendationKind = 'modifyVerifier' | 'markedFinal' | null;
+interface ReadOnlyRecommendation {
+  readonly kind: ReadOnlyRecommendationKind;
+  /** i18n key for the banner/toast a binding shows for this recommendation. */
+  readonly messageKey: string;
+  /** Whether a binding's "read-only" toggle should default to on. */
+  readonly defaultReadOnly: boolean;
+}
+interface CompatibilityWarningToast {
+  /** Stable per-code id, since toasts are deduped by code (see module docs). */
+  readonly id: string;
+  readonly code: string;
+  readonly severity: 'info' | 'warning';
+  readonly messageKey: string;
+  /** `{{code}}` for the generic fallback key; `undefined` for a mapped code. */
+  readonly params?: Readonly<Record<string, string>>;
 }
-declare function createStore<T extends object>(initial: T): Store<T>;
 //#endregion
 //#region src/viewer/i18n/translator.d.ts
 /**
@@ -10751,6 +10781,27 @@ type TranslationMessages = Record<string, Record<string, string>>;
  */
 declare function createTranslator(locale?: string, messages?: TranslationMessages): Translator;
 //#endregion
+//#region src/viewer/state/store.d.ts
+/**
+ * A tiny framework-free reactive store: `get` / `set(patch)` / `subscribe`.
+ *
+ * This is deliberately minimal (a few dozen lines, no external deps). It only
+ * carries the vanilla binding's *view state*; all domain logic (parsing,
+ * styles, geometry, text building) stays in `pptx-viewer-core` and
+ * `pptx-viewer-shared`.
+ */
+/** Listener invoked after every state change with the next and previous state. */
+type StoreListener<T> = (state: T, previous: T) => void;
+interface Store<T extends object> {
+  /** Current state snapshot (do not mutate). */
+  get(): T;
+  /** Shallow-merge a partial patch into the state and notify subscribers. */
+  set(patch: Partial<T>): void;
+  /** Subscribe to state changes; returns an unsubscribe function. */
+  subscribe(listener: StoreListener<T>): () => void;
+}
+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'];
@@ -10897,6 +10948,16 @@ interface ElementRenderContext {
    * 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
@@ -11043,6 +11104,8 @@ interface SlideStageOptions {
   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
@@ -11117,6 +11180,10 @@ interface ViewerState {
   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[];
   /**
    * The custom show a started slide show is restricted to, or null for the
    * whole deck. Custom shows were definable here but nothing could select one,
@@ -11306,6 +11373,28 @@ interface ViewerState {
   guides: Guide[];
   eyedropperActive: boolean;
   spellCheckEnabled: boolean;
+  /**
+   * Whether the loaded deck recommends opening read-only (`p:modifyVerifier`
+   * or `docProps/custom.xml`'s "Mark as Final"), and why; null when it does
+   * not. See `readOnlyRecommendation` in `pptx-viewer-shared`. Reset on every
+   * load.
+   */
+  readOnlyRecommendation: ReadOnlyRecommendation | null;
+  /**
+   * 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.
+   */
+  readOnlyBannerDismissed: boolean;
+  /**
+   * Compatibility-warning toasts for the current load (deck-level
+   * `data.warnings` concatenated with every slide's own `warnings`, deduped
+   * by code through the shared `compatibilityWarningToasts`). Load
+   * diagnostics, not auto-hiding; cleared on the next load. Dismissing a
+   * toast (or all of them) removes it from this list.
+   */
+  compatToasts: CompatibilityWarningToast[];
 }
 declare function createInitialViewerState(): ViewerState;
 //#endregion
@@ -11420,13 +11509,13 @@ interface ClipboardActions {
 //#endregion
 //#region src/viewer/editor/editor-comment-actions.d.ts
 interface CommentActions {
-  addComment(text: string, elementId?: string): string | null;
+  addComment(text: string, elementId?: string, mentions?: PptxCommentMention[]): string | null;
   /**
    * Append a reply under a top-level comment (React's `handleSubmitReply`
    * nested-`replies` model: the reply carries `threadId` = parent id and
    * inherits the parent's `elementId` anchor).
    */
-  addCommentReply(parentId: string, text: string): string | null;
+  addCommentReply(parentId: string, text: string, mentions?: PptxCommentMention[]): string | null;
   /** Update a comment's text in place; recurses into `replies` so nested rows are editable too. */
   editComment(id: string, text: string): void;
   deleteComment(id: string): void;
@@ -11475,6 +11564,15 @@ interface DeckActions {
    * exact authored dimensions.
    */
   updateSlideSize(size: SlideSizeEmu): void;
+  /**
+   * Adopt an EMU slide size AND rescale every slide's content for it in one
+   * undoable step (PowerPoint's Design > Slide Size "Maximize" / "Ensure Fit"
+   * prompt, shown when the deck has content and the new size does not match
+   * the old one). Unlike {@link updateSlideSize}, this also repositions and
+   * resizes every element (and scales font sizes) through the shared
+   * `scaleSlidesForSizeChange`.
+   */
+  applySlideSizeRescale(size: SlideSizeEmu, mode: SlideSizeRescaleMode): void;
 }
 //#endregion
 //#region src/viewer/editor/editor-ink-actions.d.ts
@@ -11585,6 +11683,19 @@ interface InspectorActions {
   setSmartArtColorScheme(scheme: SmartArtColorScheme): void;
 }
 //#endregion
+//#region src/viewer/editor/editor-master-view-crud-actions.d.ts
+interface MasterViewCrudActions {
+  /**
+   * Run one sidebar command (`addLayout` / `duplicateLayout` / `deleteLayout` /
+   * `renameLayout` / `addMaster` / `duplicateMaster` / `deleteMaster` /
+   * `renameMaster`) against the CURRENT master-view target. A no-op outside
+   * master view, when the deck is read-only, or when the action is disabled
+   * for the current target (mirrors the sidebar's own gating, so a stray call
+   * through the public API cannot bypass it).
+   */
+  runMasterViewCrudAction(id: MasterViewCrudActionId): Promise<void>;
+}
+//#endregion
 //#region src/viewer/editor/editor-section-actions.d.ts
 /** History-aware slide section actions exposed to the rail and Home ribbon. */
 interface SectionActions {
@@ -11725,6 +11836,8 @@ interface GeometryPatch {
 interface EditActions extends TextActions, ArrangeActions, ClipboardActions, SlideActions, SlideBackgroundActions, TransitionActions, AnimationActions, InspectorActions, InkActions, DeckActions {
   /** Slide section CRUD and ordering actions. */
   sections: SectionActions;
+  /** Slide Master view sidebar CRUD (Insert/Duplicate/Delete/Rename Layout/Master). */
+  masterView: MasterViewCrudActions;
   comments: CommentActions;
   toggleFormatPainter(): void;
   setShapeFill(color: string): void;
@@ -11732,6 +11845,8 @@ interface EditActions extends TextActions, ArrangeActions, ClipboardActions, Sli
   setShapeStrokeWidth(width: number): void;
   setShapeStyle(patch: Partial<ShapeStyle>): void;
   setShapeType(shapeType: string): void;
+  /** B6: fold a colour into the deck's "Recent colours" MRU list; see `InspectorHandlers.pushRecentColor`. */
+  pushRecentColor(hex: string): void;
   /** Commit an inspector geometry edit (X/Y/W/H/rotation). */
   setGeometry(patch: GeometryPatch): void;
   insert(kind: InsertKind, shapeType?: ShapePresetType): void;
@@ -11897,6 +12012,11 @@ interface InspectorState {
   tableRowHeights: number[];
   /** The selected table element itself, feeding the inspector data grid. */
   tableElement?: TablePptxElement;
+  /**
+   * B6: the deck's `p:clrMru`, most-recent-first, feeding the "Recent
+   * colours" row under the fill/stroke/text colour pickers.
+   */
+  recentColors: readonly string[];
 }
 /**
  * Deck/slide-level state for the inspector's Elements and Comments tabs plus
@@ -11911,11 +12031,21 @@ interface InspectorDeckState {
   };
   /** The deck's `p:sldSz` in EMU, which is what a save persists. */
   slideSize: SlideSizeEmu | undefined;
+  /**
+   * Whether ANY slide in the deck has at least one element (not just the
+   * active one). Gates the SLIDE SIZE card's rescale prompt: PowerPoint only
+   * offers Maximize/Ensure Fit when there is content to rescale.
+   */
+  hasDeckElements: boolean;
   elements: readonly PptxElement[];
   selectedIds: readonly string[];
   /** Primary selected element id (docked Animation panel target), if any. */
   selectedElementId?: string;
   comments: readonly PptxComment[];
+  /** Authors offered by the Comments tab's `@`-mention typeahead. */
+  commentMentionAuthors: readonly PptxModernCommentAuthor[];
+  /** Named custom shows, for the Action Settings panel's `customShow` picker. */
+  customShows: readonly PptxCustomShow[];
   docTitle: string | undefined;
   docAuthor: string | undefined;
   editable: boolean;
@@ -11979,6 +12109,9 @@ interface MasterViewSidebarOptions {
   handoutSlidesPerPage: number;
   /** Editing affordances are offered only on an editable deck. */
   editable?: boolean;
+  /** B4: the sidebar's CRUD command list for the current target (`[]` when there is none). */
+  crudActions: readonly MasterViewCrudAction[];
+  onCrudAction(id: MasterViewCrudActionId): void;
   renderStage(slide: PptxSlide, scale: number): HTMLElement;
   onSelect(masterIndex: number, layoutIndex: number | null): void;
   onTabChange(tab: MasterViewTab): void;
@@ -12150,6 +12283,8 @@ interface RibbonDrawState {
   tool: DrawTool;
   color: string;
   width: number;
+  /** B6: the deck's `p:clrMru`, most-recent-first. */
+  recentColors?: readonly string[];
 }
 /** Insert tab handler: build + insert an element of the given kind/shape preset. */
 interface RibbonInsertHandlers {
@@ -12223,6 +12358,8 @@ interface RibbonSelectionState {
   embeddedFontFamilies?: readonly string[];
   /** Families registered this session via File > Options > Fonts. */
   customFontFamilies?: readonly string[];
+  /** B6: the deck's `p:clrMru`, most-recent-first; feeds every swatch picker's row. */
+  recentColors?: readonly string[];
 }
 //#endregion
 //#region src/viewer/ui/mobile-action-sheets.d.ts
@@ -12494,6 +12631,10 @@ interface ViewerChrome {
   setQuickAccessPosition(position: 'above' | 'below'): void;
   /** Show/hide the Protected View "Enable Editing" banner. */
   setProtectedView(active: boolean): void;
+  /** Show/hide + populate the read-only recommendation banner. */
+  setReadOnlyRecommendation(recommendation: ReadOnlyRecommendation | null, dismissed: boolean): void;
+  /** Replace the compatibility-warning toast stack. */
+  setCompatToasts(toasts: readonly CompatibilityWarningToast[]): void;
 }
 //#endregion
 //#region src/viewer/editor/editor-controller.d.ts
@@ -13531,6 +13672,14 @@ interface ChromeHost {
   quickAccessScreenTip(label: string): string | undefined;
   /** Trust Center > Protected View's "Enable Editing" banner button. */
   enableEditingFromProtectedView(): void;
+  /** The read-only recommendation banner's "Edit anyway" button. */
+  editAnywayFromReadOnlyRecommendation(): void;
+  /** The read-only recommendation banner's plain close button. */
+  dismissReadOnlyBanner(): void;
+  /** One compatibility toast's own dismiss button. */
+  dismissCompatToast(id: string): void;
+  /** The compatibility toast stack's "Dismiss all" button. */
+  dismissAllCompatToasts(): void;
   /** Trust Center > "Confirm before opening external hyperlinks" gate + prompt. */
   confirmExternalHyperlink(url: string): boolean;
   toggleAutosave(): boolean;
@@ -13546,6 +13695,12 @@ interface ChromeHost {
   goToFirstSlide(): void;
   /** End: the show's last slide (skips trailing hidden slides while presenting). */
   goToLastSlide(): void;
+  /**
+   * The deck index "Present From Beginning" should land on (skips a hidden
+   * slide 1 and honours the authored `p:showPr/p:sldRg` range / custom show),
+   * unconditionally unlike {@link goToFirstSlide}.
+   */
+  firstShowSlideIndex(): number;
   getSlideCount(): number;
   enterPresentation(): Promise<void>;
   openPresenterView(): void;
@@ -13698,7 +13853,7 @@ declare class PptxViewer extends ViewerExportHost implements PptxViewerInstance,
   private userFontsStyle;
   private signatureWarningAcknowledged;
   private detachSignatureWarning;
-  /** Tags in-flight webfont probes; only the newest deck may apply its result. */
+  /** Tags in-flight webfont resolutions; only the newest deck may apply its result. */
   private webfontsToken;
   private annotations;
   private parityWorkflows;
@@ -13747,6 +13902,8 @@ declare class PptxViewer extends ViewerExportHost implements PptxViewerInstance,
   goToFirstSlide: () => void;
   /** End: the show's last slide (skips trailing hidden slides while presenting). */
   goToLastSlide: () => void;
+  /** "Present From Beginning"'s target deck index (skips a hidden slide 1 / honours the authored range). */
+  firstShowSlideIndex: () => number;
   getSlideCount: () => number;
   getCurrentSlide: () => number;
   getZoom: () => number;
@@ -13922,6 +14079,18 @@ declare class PptxViewer extends ViewerExportHost implements PptxViewerInstance,
   setEditable(editable: boolean): void;
   /** Trust Center > Protected View's "Enable Editing" banner button. */
   enableEditingFromProtectedView(): void;
+  /**
+   * 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.
+   */
+  editAnywayFromReadOnlyRecommendation(): void;
+  /** The read-only recommendation banner's plain close button: hides the banner, keeps the lock. */
+  dismissReadOnlyBanner(): void;
+  /** One compatibility toast's own dismiss button. */
+  dismissCompatToast(id: string): void;
+  /** The compatibility toast stack's "Dismiss all" button. */
+  dismissAllCompatToasts(): void;
   /**
    * Trust Center > "Confirm before opening external hyperlinks": both a
    * run-level text hyperlink click and an on-slide Action Setting's