pptx-react-viewer 1.25.5 → 2.0.0

package/dist/viewer/index.d.ts

@@ -1,5 +1,6 @@
 import * as React from 'react';
 import React__default, { RefObject } from 'react';
+import { LanguageModel, ChatTransport, UIMessage, ToolSet } from 'ai';
 import * as Y from 'yjs';
 import { Doc } from 'yjs';
 
@@ -1024,6 +1025,14 @@ interface ShapeStyle {
   };
   /** Fill overlay blend mode from effectDag `a:fillOverlay/@blend`. */
   dagFillOverlayBlend?: 'over' | 'mult' | 'screen' | 'darken' | 'lighten';
+  /**
+   * Fill overlay tint colour (hex `#RRGGBB`) from effectDag `a:fillOverlay`'s
+   * `a:solidFill`/`a:gradFill`. Painted as a blended overlay layer over the
+   * element; the blend mode comes from {@link dagFillOverlayBlend}.
+   */
+  dagFillOverlayColor?: string;
+  /** Fill overlay tint opacity (0-1), from the overlay fill colour's alpha. */
+  dagFillOverlayOpacity?: number;
   /** `<a:lnRef @idx>` — 1-based index into the theme's lnStyleLst. */
   lnRefIdx?: number;
   /** Raw XML colour child of `<a:lnRef>` (e.g. `<a:schemeClr>` with transforms). */
@@ -1956,6 +1965,75 @@ interface PptxChartProtection {
   rawXml?: XmlObject;
 }
 //#endregion
+//#region src/core/types/chart-user-shapes.d.ts
+/**
+ * Types for chart drawing-overlay shapes (`c:userShapes`).
+ *
+ * A chart's `c:userShapes` element carries an `r:id` that references a
+ * separate drawing part (`ppt/drawings/drawingN.xml`) whose root is a
+ * `c:userShapes` element populated with `cdr:relSizeAnchor` /
+ * `cdr:absSizeAnchor` wrappers around `sp` / `pic` / `cxnSp` shapes drawn on
+ * top of the chart plot. These interfaces describe the parsed, renderable
+ * overlay model. The raw reference is preserved separately on
+ * {@link PptxChartData.userShapesXml} for verbatim round-trip save; this model
+ * is render-only.
+ *
+ * @module pptx-types/chart-user-shapes
+ */
+/** A single paragraph of overlay-shape text with light formatting. */
+interface PptxChartUserShapeParagraph {
+  /** Joined run text of the paragraph. */
+  text: string;
+  /** Font size in points (`a:rPr/@sz` divided by 100), when present. */
+  fontSize?: number;
+  /** Whether the first run is bold (`a:rPr/@b`). */
+  bold?: boolean;
+  /** Whether the first run is italic (`a:rPr/@i`). */
+  italic?: boolean;
+  /** Resolved run colour hex (e.g. `"#FF0000"`), when present. */
+  color?: string;
+  /** Paragraph alignment (`a:pPr/@algn`): left / centre / right. */
+  align?: 'l' | 'ctr' | 'r';
+}
+/**
+ * A parsed chart-overlay shape positioned by a drawing anchor.
+ *
+ * Position is expressed as chart-relative fractions in {@link from}. For a
+ * `relSizeAnchor` the opposite corner is {@link to} (also fractional); for an
+ * `absSizeAnchor` the extent is {@link ext} in EMU.
+ */
+interface PptxChartUserShape {
+  /** Shape kind: text/preset shape, connector, or picture. */
+  kind: 'sp' | 'cxnSp' | 'pic';
+  /** Anchor kind that positioned the shape. */
+  anchor: 'rel' | 'abs';
+  /** Top-left corner as chart-relative fractions (0-1). */
+  from: {
+    x: number;
+    y: number;
+  };
+  /** Bottom-right corner as chart-relative fractions (0-1); relSizeAnchor only. */
+  to?: {
+    x: number;
+    y: number;
+  };
+  /** Extent in EMU (cx, cy); absSizeAnchor only. */
+  ext?: {
+    cx: number;
+    cy: number;
+  };
+  /** Preset geometry name (`a:prstGeom/@prst`), defaulting to `"rect"`. */
+  prst?: string;
+  /** Resolved solid-fill hex colour, when present. */
+  fill?: string;
+  /** Resolved line/stroke hex colour, when present. */
+  stroke?: string;
+  /** Line width in points (`a:ln/@w` divided by 12700), when present. */
+  strokeWidth?: number;
+  /** Text paragraphs of the shape's `txBody`, when present. */
+  paragraphs?: PptxChartUserShapeParagraph[];
+}
+//#endregion
 //#region src/core/types/chart.d.ts
 /**
  * Supported chart type discriminators.
@@ -2289,6 +2367,15 @@ interface PptxChartTreemapOptions {
 interface PptxChartSeries {
   name: string;
   values: number[];
+  /**
+   * Blank-value mask aligned index-for-index with {@link values}: `true` marks
+   * a category whose numeric cache point (`c:numCache/c:pt`) was absent or
+   * empty, i.e. a genuine blank rather than a real `0`. Present only when the
+   * source series actually contains blanks; when set, blank slots in
+   * {@link values} carry `0` as a placeholder. Renderers honour
+   * `c:dispBlanksAs` (gap / zero / span) using this mask.
+   */
+  blanks?: boolean[];
   color?: string;
   trendlines?: PptxChartTrendline[];
   errBars?: PptxChartErrBars[];
@@ -2510,6 +2597,14 @@ interface PptxChartManualLayout {
   y?: number;
   width?: number;
   height?: number;
+  /**
+   * Raw `c:extLst` (CT_ExtensionList) of the `c:manualLayout`, captured
+   * verbatim so it round-trips through the typed model. Without this, a dirty
+   * write of an edited layout would drop the extension list (the manual node
+   * is rebuilt from the typed fields). Emitted as the trailing child, matching
+   * the CT_ManualLayout schema order.
+   */
+  ext?: XmlObject;
 }
 /**
  * Typed manual layouts for chart regions that accept `c:layout`.
@@ -2701,6 +2796,15 @@ interface PptxChartData {
    * attempting to parse the nested drawing tree.
    */
   userShapesXml?: unknown;
+  /**
+   * Parsed, renderable drawing-overlay shapes resolved from the separate
+   * drawing part referenced by `c:userShapes/@r:id`
+   * (`ppt/drawings/drawingN.xml`). Each entry carries chart-relative anchor
+   * geometry plus light shape/text formatting so the viewer can render an
+   * overlay on top of the chart plot. Render-only: {@link userShapesXml}
+   * remains the source of truth for round-trip save.
+   */
+  userShapes?: PptxChartUserShape[];
   /**
    * Raw `c:pivotFmts` XML subtree preserved verbatim.
    *
@@ -3721,7 +3825,7 @@ interface PptxSmartArtData {
 /**
  * Per-cell visual style for a table cell.
  *
- * All fields are optional — unset values inherit from the table style.
+ * All fields are optional - unset values inherit from the table style.
  *
  * @example
  * ```ts
@@ -3849,6 +3953,52 @@ interface PptxTableCellStyle {
   patternFillForeground?: string;
   /** Pattern fill background colour. */
   patternFillBackground?: string;
+  /**
+   * Cell 3D bevel + lighting from `a:tcPr/a:cell3D` (CT_Cell3D,
+   * ECMA-376 §21.1.3.1). Rendered as a CSS bevel treatment.
+   */
+  cell3D?: PptxTableCell3D;
+  /**
+   * `a:tcPr/@anchorCtr` - centre the text block in the direction
+   * perpendicular to the text flow (horizontal centring for horizontal text).
+   */
+  anchorCtr?: boolean;
+  /**
+   * `a:tcPr/@horzOverflow` (ST_TextHorzOverflowType): `clip` clips text at
+   * the cell edge, `overflow` (the default) lets it spill.
+   */
+  horzOverflow?: 'clip' | 'overflow';
+}
+/**
+ * Cell 3D bevel + lighting parsed from `a:tcPr/a:cell3D` (CT_Cell3D).
+ *
+ * Only the fields needed to render a plausible bevel treatment are captured;
+ * verbatim round-trip of the full node is handled separately by the save path.
+ *
+ * @example
+ * ```ts
+ * const c3d: PptxTableCell3D = {
+ *   bevelWidth: 8,
+ *   bevelHeight: 8,
+ *   bevelPreset: 'circle',
+ *   material: 'plastic',
+ * };
+ * // => satisfies PptxTableCell3D
+ * ```
+ */
+interface PptxTableCell3D {
+  /** Bevel width in px (from `a:bevel@w`, EMU converted). */
+  bevelWidth?: number;
+  /** Bevel height in px (from `a:bevel@h`, EMU converted). */
+  bevelHeight?: number;
+  /** Bevel preset name (`a:bevel@prst`, e.g. `circle`, `relaxedInset`). */
+  bevelPreset?: string;
+  /** Preset material (`a:cell3D@prstMaterial`, e.g. `plastic`, `metal`). */
+  material?: string;
+  /** Light rig type (`a:lightRig@rig`, e.g. `threePt`, `soft`). */
+  lightRig?: string;
+  /** Light rig direction (`a:lightRig@dir`, e.g. `tl`, `t`, `tr`). */
+  lightRigDirection?: string;
 }
 /**
  * A single table cell with text content, optional style, and merge info.
@@ -4072,7 +4222,7 @@ interface ParsedTableStyleBorder {
   fill?: ParsedTableStyleFill;
   /** Explicit hex colour when the line used `a:srgbClr` (e.g. `#808080`). */
   color?: string;
-  /** The line was `a:noFill` — an explicit "no border" that clears lower layers. */
+  /** The line was `a:noFill` - an explicit "no border" that clears lower layers. */
   noFill?: boolean;
 }
 /**
@@ -5058,6 +5208,14 @@ interface PptxNativeAnimation {
    * that aren't OLE charts).
    */
   graphicBuild?: string;
+  /**
+   * OLE-embedded chart build attribute (`p:bldOleChart/@bld`) when this
+   * animation stages an OLE chart graphic frame. Values follow
+   * ST_TLOleChartBuildType: `allAtOnce`, `series`, `category`, `seriesEl`,
+   * `categoryEl`. Lets a staged-reveal renderer build the chart by series /
+   * category / element to match PowerPoint, rather than as one whole element.
+   */
+  oleChartBuild?: string;
   /** Schema-accurate `p:bldGraphic/p:bldAsOne|p:bldSub` representation. */
   graphicBuildProperties?: PptxGraphicBuild;
   /**
@@ -5547,6 +5705,18 @@ interface PptxAppProperties {
   template?: string;
   /** Hyperlink base URL. */
   hyperlinkBase?: string;
+  /** Document security bitmask (`<DocSecurity>`). */
+  docSecurity?: number;
+  /** Number of multimedia clips (`<MMClips>`). */
+  mmClips?: number;
+  /** Whether thumbnail images were scaled to fit (`<ScaleCrop>`). */
+  scaleCrop?: boolean;
+  /** Whether hyperlinks are current (`<LinksUpToDate>`). */
+  linksUpToDate?: boolean;
+  /** Whether the document is shared (`<SharedDoc>`). */
+  sharedDoc?: boolean;
+  /** Whether hyperlinks changed since last save (`<HyperlinksChanged>`). */
+  hyperlinksChanged?: boolean;
 }
 //#endregion
 //#region src/core/types/presentation-print-properties.d.ts
@@ -6051,6 +6221,21 @@ interface PptxActiveXControl {
   name?: string;
   /** Shape ID this control is linked to (from @spid). */
   shapeId?: string;
+  /** X position (px) of the control's fallback picture, if present. */
+  x?: number;
+  /** Y position (px) of the control's fallback picture, if present. */
+  y?: number;
+  /** Width (px) of the control's fallback picture, if present. */
+  width?: number;
+  /** Height (px) of the control's fallback picture, if present. */
+  height?: number;
+  /**
+   * Relationship ID of the control's static fallback picture
+   * (`mc:AlternateContent > mc:Fallback > p:pic > p:blipFill > a:blip@r:embed`).
+   * Renderers resolve this to an image so a control shows its last static
+   * frame instead of a blank area (the live ActiveX cannot run in a viewer).
+   */
+  fallbackImageRelId?: string;
   /** Raw XML for round-trip preservation. */
   rawXml?: XmlObject;
 }
@@ -6177,6 +6362,13 @@ interface PptxSlide {
   customerData?: PptxCustomerData[];
   /** ActiveX control references from `p:controls` on this slide. */
   activeXControls?: PptxActiveXControl[];
+  /**
+   * Shapes parsed from a referenced legacy VML drawing part
+   * (`ppt/drawings/vmlDrawing*.vml`, linked via a `legacyDrawing`
+   * relationship). These are read-only render hints: the VML part itself is
+   * preserved verbatim on save, so this field is not re-serialized.
+   */
+  legacyVmlElements?: PptxElement[];
   /** Per-slide header/footer flags from `<p:hf>` (P-H3). */
   headerFooterFlags?: PptxHeaderFooterFlags;
   /** Server-backed slide synchronization metadata stored in a related OPC part. */
@@ -6285,12 +6477,6 @@ interface PptxPresentationProperties {
   showSubtitles?: boolean;
   /** Typed `p:prnPr` settings. Set to null during save to remove the element. */
   printProperties?: PptxPresentationPrintProperties | null;
-  /** @deprecated Use `printProperties.printWhat`; retained as a handout compatibility alias. */
-  printSlidesPerPage?: number;
-  /** @deprecated Use `printProperties.frameSlides`. */
-  printFrameSlides?: boolean;
-  /** @deprecated Use `printProperties.colorMode`. */
-  printColorMode?: 'clr' | 'gray' | 'bw';
   /** Most-recently-used colours from the presentation palette. */
   mruColors?: string[];
   /** Grid spacing in EMUs (cx, cy). Default is 914400 / 8 = 114300. */
@@ -8232,6 +8418,20 @@ interface ViewerFontSource {
   weight?: string | number;
   style?: 'normal' | 'italic';
 }
+/**
+ * Store PPTX content bytes so the audience tab can retrieve them.
+ * Called by the presenter before opening the audience window.
+ */
+declare function storeAudienceContent(content: ArrayBuffer | Uint8Array, sessionId?: string): Promise<void>;
+/**
+ * Load PPTX content bytes stored by the presenter tab.
+ * Returns `null` if nothing is stored.
+ */
+declare function loadAudienceContent(sessionId?: string): Promise<Uint8Array | null>;
+/**
+ * Remove stored audience content (cleanup).
+ */
+declare function clearAudienceContent(sessionId?: string): Promise<void>;
 /** In-memory clipboard payload stored when an element is copied or cut. */
 interface ElementClipboardPayload {
   element: PptxElement;
@@ -8440,6 +8640,228 @@ interface ShapeQuickStyle {
   style: Partial<ShapeStyle>;
 }
 //#endregion
+//#region ../shared/dist/ai/index.d.ts
+//#endregion
+//#region src/ai/change-animator.d.ts
+/** Host-tunable options for how AI edits are animated on the canvas. */
+interface AiChangeAnimationConfig {
+  /** Master switch. Default true. */
+  enabled?: boolean;
+  /** How long the motion + glow plays, in ms. Default 900. */
+  durationMs?: number;
+  /** Draw the pulsing glow highlight on changed elements. Default true. */
+  glow?: boolean;
+  /** Glide old->new bounds and cross-fade colours. Default true. */
+  tween?: boolean;
+  /** Accent colour (any CSS colour) for the glow/ghosts. Default a blue. */
+  color?: string;
+}
+//#endregion
+//#region src/ai/config.d.ts
+/** The UI message shape exchanged with the assistant. Alias of the SDK type. */
+type PptxAiUIMessage = UIMessage;
+/**
+ * Canonical name of every tool the assistant can call. Document tools mirror the
+ * `pptx-viewer-mcp` server exactly (they ARE the same functions, run against the
+ * live deck); the viewer-only tools (navigation, deck outline, element/notes
+ * readers, table merge) have no MCP counterpart.
+ */
+type PptxAiToolName = 'get_deck_overview' | 'get_slide' | 'get_element' | 'get_speaker_notes' | 'find_text' | 'get_theme' | 'go_to_slide' | 'select_elements' | 'merge_tables' | 'get_metadata' | 'get_layouts' | 'find_placeholders' | 'get_presentation_properties' | 'run_accessibility_check' | 'convert_to_markdown' | 'add_element' | 'update_element' | 'delete_elements' | 'arrange_elements' | 'clone_element' | 'set_element_animation' | 'group_elements' | 'ungroup_elements' | 'batch_update_elements' | 'update_element_style' | 'replace_geometry' | 'set_element_lock' | 'manage_hyperlinks' | 'replace_text' | 'manage_comments' | 'update_table_cells' | 'manage_table_structure' | 'create_chart' | 'update_chart' | 'add_chart_series' | 'remove_chart_series' | 'update_chart_series_data' | 'manage_smart_art' | 'apply_template' | 'add_slide' | 'duplicate_slide' | 'delete_slides' | 'reorder_slides' | 'update_slide_properties' | 'set_slide_transition' | 'apply_theme_preset' | 'update_theme_colors' | 'update_theme_fonts' | 'set_canvas_size' | 'update_metadata' | 'manage_sections' | 'update_presentation_properties' | 'apply_layout';
+type Resolvable<T> = T | (() => T | Promise<T>);
+/** How the assistant reaches a language model. */
+type PptxAiConnection =
+/**
+ * Post messages to a host backend route (recommended for production so the
+ * provider API key stays server-side). Maps to `DefaultChatTransport`.
+ */
+{
+  kind: 'endpoint';
+  api: string;
+  headers?: Resolvable<Record<string, string>>;
+  body?: Resolvable<Record<string, unknown>>;
+  credentials?: RequestCredentials;
+  fetch?: typeof globalThis.fetch;
+} |
+/**
+ * Run a language model in-process in the browser (bring-your-own key /
+ * local model). Maps to a `ToolLoopAgent` behind a `DirectChatTransport`.
+ */
+{
+  kind: 'model';
+  model: LanguageModel;
+  system?: string;
+  maxSteps?: number;
+} |
+/** Provide a fully-constructed transport (advanced / testing escape hatch). */
+{
+  kind: 'transport';
+  transport: ChatTransport<PptxAiUIMessage>;
+};
+/** How writes proposed by the assistant reach the document. */
+type PptxAiWritePolicy = 'stage' | 'approve' | 'auto';
+/** Which deck context is fed to the model with each turn. */
+type PptxAiContextStrategy = 'outline' | 'current-slide' | 'none';
+/** Optional per-session history persistence hooks. */
+interface PptxAiHistoryHooks {
+  load?(id: string): Promise<PptxAiUIMessage[]>;
+  save?(id: string, messages: PptxAiUIMessage[]): Promise<void>;
+}
+/** Complete host configuration for an AI chat session. */
+interface PptxAiConfig {
+  connection: PptxAiConnection;
+  /** Extra host instructions appended to the base system prompt. */
+  systemPromptExtras?: string;
+  tools?: {
+    /** Allowlist. When set, only these tools are exposed. */
+    enabled?: PptxAiToolName[];
+    /** Denylist, applied after `enabled`. */
+    disabled?: PptxAiToolName[];
+    /** Additional host-defined tools merged into the tool set. */
+    extra?: ToolSet;
+  };
+  /** Default `'stage'`. */
+  writePolicy?: PptxAiWritePolicy;
+  /** Default `'outline'`. */
+  contextStrategy?: PptxAiContextStrategy;
+  history?: PptxAiHistoryHooks;
+  /**
+   * How AI edits are animated on the canvas so the user can watch them land
+   * (glide old->new, fade/scale in-out, glow-pulse). Omit for the defaults;
+   * set `{ enabled: false }` to turn it off.
+   */
+  changeAnimation?: AiChangeAnimationConfig;
+  onError?(error: Error): void;
+}
+//#endregion
+//#region src/ai/bridge.d.ts
+/** Lightweight, model-friendly summary of the whole deck. */
+interface PptxAiDeckMeta {
+  /** Total number of slides. */
+  slideCount: number;
+  /** Zero-based index of the currently active slide. */
+  activeSlideIndex: number;
+  /** Deck title, when known (first slide title / core properties). */
+  title?: string;
+  /** Slide canvas width in CSS pixels. */
+  width: number;
+  /** Slide canvas height in CSS pixels. */
+  height: number;
+}
+/** Severity hint for {@link PptxAiBridge.notify}. */
+type PptxAiNotifyLevel = 'info' | 'success' | 'warning' | 'error';
+/**
+ * A target the user has scoped the assistant to: either a whole slide or a
+ * single element on a slide. Returned by {@link PptxAiBridge.getFocusedTargets}
+ * so the context builder can tell the model exactly what to focus on.
+ */
+type PptxAiFocusedTarget = {
+  kind: 'slide';
+  slideIndex: number;
+} | {
+  kind: 'element';
+  slideIndex: number;
+  elementId: string;
+};
+/**
+ * A pure updater over the deck's slides. It receives a deep clone of the
+ * current slides (mutation-safe) and returns the next slides array. The bridge
+ * commits the returned array as ONE history entry.
+ */
+type PptxAiSlidesUpdater = (slides: PptxSlide[]) => PptxSlide[];
+/**
+ * A pure updater over the whole parsed deck ({@link PptxData}). Mirrors the
+ * `pptx-viewer-mcp` tool model (data in, mutated data out) so presentation-level
+ * MCP tools (metadata, sections, canvas size, presentation properties, layouts)
+ * can be committed as ONE undoable history entry through {@link
+ * PptxAiBridge.applyDeckData}. Optional: bindings that only track slide/theme
+ * state can omit it, in which case those presentation-level tools report that
+ * they are unavailable in this viewer while every slide/theme tool still works.
+ */
+type PptxAiDataUpdater = (data: PptxData) => PptxData;
+/** Field-level updates for a single element, mirroring the MCP update vocab. */
+interface PptxAiElementUpdate {
+  x?: number;
+  y?: number;
+  width?: number;
+  height?: number;
+  rotation?: number;
+  opacity?: number;
+  hidden?: boolean;
+  flipHorizontal?: boolean;
+  flipVertical?: boolean;
+  text?: string;
+  fontSize?: number;
+  fontFamily?: string;
+  fontColor?: string;
+  bold?: boolean;
+  italic?: boolean;
+  underline?: boolean;
+  align?: 'left' | 'center' | 'right' | 'justify';
+  fillColor?: string;
+  strokeColor?: string;
+  strokeWidth?: number;
+}
+/**
+ * Implemented by each binding to expose its live editor to the AI core.
+ *
+ * Read methods must be cheap and synchronous. Write methods must route through
+ * the binding's editor-history layer so AI edits are undoable like manual ones.
+ */
+interface PptxAiBridge {
+  /** Return a summary of the whole deck. */
+  getDeckMeta(): PptxAiDeckMeta;
+  /** Return the deck's slides. Callers must not mutate the returned array. */
+  getSlides(): PptxSlide[];
+  /** Return the zero-based index of the active slide. */
+  getActiveSlideIndex(): number;
+  /** Return the resolved presentation theme, when available. */
+  getTheme(): PptxTheme | undefined;
+  /** Return the underlying core handler, when the binding exposes one. */
+  getHandler(): PptxHandler | undefined;
+  /** Navigate the viewer to a slide by zero-based index. */
+  goToSlide(index: number): void;
+  /** Select the given elements on a slide (empty array clears selection). */
+  selectElements(slideIndex: number, elementIds: string[]): void;
+  /**
+   * Apply a slides updater as a single, atomic, undoable history entry. The
+   * binding is responsible for cloning current slides before calling
+   * `updater` and for installing the result.
+   */
+  applySlidesUpdate(updater: PptxAiSlidesUpdater, label: string): void;
+  /** Apply field updates to one element as a single history entry. */
+  updateElement(slideIndex: number, elementId: string, updates: PptxAiElementUpdate): void;
+  /** Apply partial theme updates as a single history entry. */
+  applyTheme(updates: Partial<PptxTheme>): void;
+  /**
+   * Return the full parsed {@link PptxData} for the open deck, with the live
+   * (edited) slides and theme overlaid. Enables `pptx-viewer-mcp` tools that
+   * read presentation-level state (metadata, sections, layouts, presentation
+   * properties). Optional: when absent, the AI core synthesises a minimal
+   * PptxData from slides + dimensions, which is enough for every slide/theme
+   * tool but not for presentation-level reads.
+   */
+  getDeckData?(): PptxData | undefined;
+  /**
+   * Commit a whole-deck {@link PptxData} mutation as one undoable history entry.
+   * Used to apply presentation-level MCP tool results (metadata, sections,
+   * canvas size, presentation properties, layouts). Optional: when absent,
+   * those tools report they are not supported in this viewer; slide/theme tools
+   * are unaffected (they route through {@link PptxAiBridge.applySlidesUpdate}
+   * and {@link PptxAiBridge.applyTheme}).
+   */
+  applyDeckData?(updater: PptxAiDataUpdater, label: string): void;
+  /**
+   * Return the slides / elements the user has scoped the assistant to, if any.
+   * When present and non-empty, the context builder tells the model to focus on
+   * exactly these targets. Optional so existing bridges satisfy the contract
+   * without change; a bridge that does not implement it behaves as before (no
+   * focus scoping).
+   */
+  getFocusedTargets?(): PptxAiFocusedTarget[];
+  /** Surface a transient message in the host UI (toast / status line). */
+  notify?(message: string, level?: PptxAiNotifyLevel): void;
+}
+//#endregion
 //#region src/viewer/hooks/collaboration/types.d.ts
 /** Connection lifecycle states for the Yjs WebSocket provider. */
 type ConnectionStatus = 'disconnected' | 'connecting' | 'connected' | 'error';
@@ -8780,11 +9202,11 @@ interface PowerPointViewerProps {
     serverUrl?: string;
   };
   /**
-   * Opt in to the experimental Three.js SmartArt renderer. When `true`,
-   * SmartArt diagrams render as extruded 3D blocks on a WebGL canvas instead
-   * of flat SVG. Requires the optional `three` peer dependency; when it is not
-   * installed (or the diagram has no geometry), the viewer transparently falls
-   * back to the SVG `SmartArtRenderer`. Default `false`.
+   * Opt in to the Three.js SmartArt renderer. When `true`, SmartArt diagrams
+   * render as extruded 3D blocks on a WebGL canvas instead of flat SVG.
+   * Requires the optional `three` peer dependency; when it is not installed
+   * (or the diagram has no geometry), the viewer transparently falls back to
+   * the SVG `SmartArtRenderer`. Default `false`.
    */
   smartArt3D?: boolean;
   /**
@@ -8805,11 +9227,44 @@ interface PowerPointViewerProps {
    * ```
    */
   hiddenActions?: ToolbarActionId[];
+  /**
+   * Opt in to the built-in AI assistant. When provided, a Sparkles toggle
+   * appears in the toolbar and opens a chat panel wired to this config; when
+   * omitted, no AI icon renders and no AI code is loaded (the panel and its
+   * `@ai-sdk/react` dependency are `React.lazy`-imported only on first open).
+   *
+   * The host supplies the model connection (a backend `endpoint`, an in-browser
+   * `model`, or a custom `transport`) plus optional tool allow/deny lists and a
+   * write policy. Requires the optional `ai` and `@ai-sdk/react` peers.
+   *
+   * @example
+   * ```tsx
+   * <PowerPointViewer content={bytes} ai={{ connection: { kind: 'model', model } }} />
+   * ```
+   *
+   * @see {@link PptxAiConfig}
+   */
+  ai?: PptxAiConfig;
 }
 interface PowerPointViewerHandle extends FileViewerHandle, PowerPointViewerAPI {
   getContent: () => Promise<Uint8Array>;
 }
 
+//#region src/viewer/utils/animation-effects.d.ts
+declare function getAnimationInitialStyle(preset: PptxAnimationPreset | undefined, nativeAnimation?: PptxNativeAnimation): React__default.CSSProperties;
+//#endregion
+//#region src/viewer/PowerPointViewer.d.ts
+/**
+ * Root React component for the PowerPoint viewer/editor.
+ *
+ * Accepts binary `.pptx` content and renders a full-featured editor with
+ * slide canvas, toolbar, inspector panels, presentation mode, and more.
+ *
+ * Uses `forwardRef` to expose a `PowerPointViewerHandle` for imperative
+ * access (e.g. serialising the current content for saving).
+ */
+declare const PowerPointViewer: React.ForwardRefExoticComponent<PowerPointViewerProps & React.RefAttributes<PowerPointViewerHandle>>;
+
 //#endregion
 //#region src/viewer/hooks/useThemeSwitching.d.ts
 interface UseThemeSwitchingInput {
@@ -9099,44 +9554,6 @@ declare function parseAudienceNonce(): string | null;
 /** Returns true if the current page was opened as an audience tab. */
 declare function isAudienceTab(): boolean;
 
-//#region src/viewer/utils/animation-effects.d.ts
-declare function getAnimationInitialStyle(preset: PptxAnimationPreset | undefined, nativeAnimation?: PptxNativeAnimation): React__default.CSSProperties;
-//#endregion
-//#region src/viewer/PowerPointViewer.d.ts
-/**
- * Root React component for the PowerPoint viewer/editor.
- *
- * Accepts binary `.pptx` content and renders a full-featured editor with
- * slide canvas, toolbar, inspector panels, presentation mode, and more.
- *
- * Uses `forwardRef` to expose a `PowerPointViewerHandle` for imperative
- * access (e.g. serialising the current content for saving).
- */
-declare const PowerPointViewer: React.ForwardRefExoticComponent<PowerPointViewerProps & React.RefAttributes<PowerPointViewerHandle>>;
-
-//#region src/viewer/hooks/presentation-mode/audience-content-store.d.ts
-/**
- * audience-content-store: IndexedDB-based storage for sharing PPTX content
- * between the presenter tab and audience tab.
- *
- * When the presenter opens an audience window, the PPTX bytes are stored in
- * IndexedDB. The audience tab retrieves them on load and then cleans up.
- */
-/**
- * Store PPTX content bytes so the audience tab can retrieve them.
- * Called by the presenter before opening the audience window.
- */
-declare function storeAudienceContent(content: ArrayBuffer | Uint8Array, sessionId?: string): Promise<void>;
-/**
- * Load PPTX content bytes stored by the presenter tab.
- * Returns `null` if nothing is stored.
- */
-declare function loadAudienceContent(sessionId?: string): Promise<Uint8Array | null>;
-/**
- * Remove stored audience content (cleanup).
- */
-declare function clearAudienceContent(sessionId?: string): Promise<void>;
-//#endregion
 //#region src/viewer/components/collaboration/CollaborationProvider.d.ts
 interface CollaborationProviderProps {
   /** Collaboration config, or `undefined`/omitted while no session is active. */
@@ -9189,4 +9606,4 @@ interface CollaborationStatusIndicatorProps {
 declare function CollaborationStatusIndicator({ status, connectedCount, onRetry }: CollaborationStatusIndicatorProps): React__default.ReactElement;
 
 export { CollaborationProvider, CollaborationStatusIndicator, PowerPointViewer, RemoteUserCursors, UserAvatarBar, clearAudienceContent, getAnimationInitialStyle, isAudienceTab, loadAudienceContent, parseAudienceNonce, storeAudienceContent, useCollaborativeHistory, useCollaborativeState, usePresenceTracking, useThemeSwitching, useYjsProvider };
-export type { AccessibilityIssue, AnimationPresetOption, CanvasSize, CollaborationConfig, CollaborationContextValue, CollaborationRole, CollaborationStatusIndicatorProps, ConnectionStatus, ConnectorArrowOption, ConnectorGeometryOption, ConnectorGeometryType, ConnectorPathGeometry, DragState, DrawingTool, EditorHistorySnapshot, ElementBounds, ElementClipboardPayload, ElementContextMenuAction, ElementContextMenuState, FileViewerHandle, MarqueeSelectionState, ParsedTableCell, ParsedTableData, PowerPointViewerHandle, PowerPointViewerProps, PresentationAnimationRuntime, RemoteUserCursorsProps, ResizeHandle, ResizeState, ShapeAdjustmentDragState, ShapeAdjustmentHandleDescriptor, ShapePreset, ShapeQuickStyle, ShortcutReferenceItem, SlideAlignment, SlideSectionGroup, SlideTransitionOption, StrokeDashOption, SupportedShapeType, TableCellEditorState, ThemeSwitchingResult, ToolbarSection, UseCollaborativeHistoryResult, UseCollaborativeStateInput, UsePresenceTrackingResult, UseThemeSwitchingInput, UserAvatarBarProps, UserPresence, ViewerMode };
+export type { AccessibilityIssue, AnimationPresetOption, CanvasSize, CollaborationConfig, CollaborationContextValue, CollaborationRole, CollaborationStatusIndicatorProps, ConnectionStatus, ConnectorArrowOption, ConnectorGeometryOption, ConnectorGeometryType, ConnectorPathGeometry, DragState, DrawingTool, EditorHistorySnapshot, ElementBounds, ElementClipboardPayload, ElementContextMenuAction, ElementContextMenuState, FileViewerHandle, MarqueeSelectionState, ParsedTableCell, ParsedTableData, PowerPointViewerHandle, PowerPointViewerProps, PptxAiBridge, PptxAiConfig, PptxAiConnection, PptxAiContextStrategy, PptxAiToolName, PptxAiWritePolicy, PresentationAnimationRuntime, RemoteUserCursorsProps, ResizeHandle, ResizeState, ShapeAdjustmentDragState, ShapeAdjustmentHandleDescriptor, ShapePreset, ShapeQuickStyle, ShortcutReferenceItem, SlideAlignment, SlideSectionGroup, SlideTransitionOption, StrokeDashOption, SupportedShapeType, TableCellEditorState, ThemeSwitchingResult, ToolbarSection, UseCollaborativeHistoryResult, UseCollaborativeStateInput, UsePresenceTrackingResult, UseThemeSwitchingInput, UserAvatarBarProps, UserPresence, ViewerMode };

package/dist/viewer/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/viewer/hooks/presentation-mode/audience-content-store.ts","../../src/viewer/components/collaboration/CollaborationProvider.tsx","../../src/viewer/components/collaboration/RemoteUserCursors.tsx","../../src/viewer/components/collaboration/UserAvatarBar.tsx","../../src/viewer/components/collaboration/CollaborationStatusIndicator.tsx"],"mappings":";;;;;;;;;;;;;;;;;iBAqDsB,qBACrB,SAAS,cAAc,YACvB,qBACE;;;;;iBA2BmB,oBAAoB,qBAAqB,QAAQ;;;;iBA+CjD,qBAAqB,qBAAqB;;;UCvF/C;;EAEhB,SAAS;EACT;EACA;EACA,UAAU,MAAM;;iBAGD,wBACf,QACA,aACA,cACA,YACE,6BAA6B,MAAM;;;UCtCrB;;EAEhB,aAAa;;EAEb;;EAEA;;EAEA;;iBAOe,oBACf,aACA,kBACA,aACA,gBACE,yBAAyB,MAAM;;;UCRjB;;EAEhB,aAAa;;EAEb;;EAEA;;EAEA;;EAEA,QAAQ;;EAER;;iBAqDe,gBACf,aACA,eACA,gBACA,iBACA,QACA,cACE,qBAAqB,MAAM;;;UCrFb;;EAEhB,QAAQ;;EAER;;EAEA;;iBAkCe,+BACf,QACA,gBACA,WACE,oCAAoC,MAAM"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/viewer/components/collaboration/CollaborationProvider.tsx","../../src/viewer/components/collaboration/RemoteUserCursors.tsx","../../src/viewer/components/collaboration/UserAvatarBar.tsx","../../src/viewer/components/collaboration/CollaborationStatusIndicator.tsx"],"mappings":";;;;;;UA2CiB;;EAEhB,SAAS;EACT;EACA;EACA,UAAU,MAAM;;iBAGD,wBACf,QACA,aACA,cACA,YACE,6BAA6B,MAAM;;;UCtCrB;;EAEhB,aAAa;;EAEb;;EAEA;;EAEA;;iBAOe,oBACf,aACA,kBACA,aACA,gBACE,yBAAyB,MAAM;;;UCRjB;;EAEhB,aAAa;;EAEb;;EAEA;;EAEA;;EAEA,QAAQ;;EAER;;iBAqDe,gBACf,aACA,eACA,gBACA,iBACA,QACA,cACE,qBAAqB,MAAM;;;UCrFb;;EAEhB,QAAQ;;EAER;;EAEA;;iBAkCe,+BACf,QACA,gBACA,WACE,oCAAoC,MAAM"}