pptx-react-viewer 1.16.1 → 1.17.0

package/dist/types-ui-NG29h55h.d.mts

@@ -1,712 +0,0 @@
-import { P, a, $, U, g, j, X, R, i } from './presentation-BfnrtJV1.js';
-import React__default from 'react';
-import { ViewerTheme } from './theme/index.js';
-
-/** Viewer interaction mode: read-only, edit, presentation, or master-view. */
-type ViewerMode = 'preview' | 'edit' | 'present' | 'master';
-/**
- * Framework-agnostic imperative API contract for the PowerPoint viewer.
- *
- * Each binding (React `forwardRef` handle, Vue `defineExpose`, Angular public
- * methods) implements this interface so consumers get a consistent progressive
- * API regardless of framework.
- */
-interface PowerPointViewerAPI {
-    /** Serialise the current presentation to `.pptx` bytes. */
-    getContent: () => Promise<Uint8Array>;
-    /** Navigate to a specific slide by zero-based index. */
-    goTo: (slideIndex: number) => void;
-    /** Navigate to the previous slide. */
-    goPrev: () => void;
-    /** Navigate to the next slide. */
-    goNext: () => void;
-    /** Undo the last editing action. No-op when nothing to undo. */
-    undo: () => void;
-    /** Redo the last undone action. No-op when nothing to redo. */
-    redo: () => void;
-    /** Whether an undo action is available. */
-    canUndo: () => boolean;
-    /** Whether a redo action is available. */
-    canRedo: () => boolean;
-    /** Get the current zoom level (1 = 100%). */
-    getZoom: () => number;
-    /** Set the zoom level (clamped to min/max bounds). */
-    setZoom: (level: number) => void;
-    /** Zoom in by one step. */
-    zoomIn: () => void;
-    /** Zoom out by one step. */
-    zoomOut: () => void;
-    /** Reset zoom to 100%. */
-    zoomReset: () => void;
-    /** Get the current viewer mode. */
-    getMode: () => ViewerMode;
-    /** Switch the viewer mode (e.g. 'edit', 'preview', 'present'). */
-    setMode: (mode: ViewerMode) => void;
-    /** Get the zero-based active slide index. */
-    getActiveSlideIndex: () => number;
-    /** Set the active slide by zero-based index (alias of goTo). */
-    setActiveSlideIndex: (index: number) => void;
-    /** Get the total number of slides. */
-    getSlideCount: () => number;
-    /** Whether the document has unsaved changes. */
-    isDirty: () => boolean;
-    /**
-     * Get the full slide array. Returns the actual `PptxSlide[]` from the
-     * internal model with full type information (elements, notes, transitions,
-     * animations, etc.). The returned reference is a snapshot; mutations are
-     * not reflected back unless done via the manipulation methods.
-     */
-    getSlides: () => readonly P[];
-    /** Get a single slide by zero-based index, or undefined if out of range. */
-    getSlide: (index: number) => P | undefined;
-    /** Get the currently active slide. */
-    getActiveSlide: () => P | undefined;
-    /** Add a blank slide after the given index (or at end if omitted). */
-    addSlide: (afterIndex?: number) => void;
-    /** Delete slides at the given zero-based indexes. At least one slide is kept. */
-    deleteSlides: (indexes: number[]) => void;
-    /** Duplicate slides at the given zero-based indexes. */
-    duplicateSlides: (indexes: number[]) => void;
-    /** Move a slide from one position to another. */
-    moveSlide: (fromIndex: number, toIndex: number) => void;
-    /** Toggle the hidden flag on slides at the given indexes. */
-    toggleHideSlides: (indexes: number[]) => void;
-    /**
-     * Get the elements on a slide. Defaults to the active slide when
-     * `slideIndex` is omitted. Returns the full `PptxElement[]` with
-     * all type-specific properties intact.
-     */
-    getElements: (slideIndex?: number) => readonly a[];
-    /** Get a single element by ID from the active slide (or a specified slide). */
-    getElementById: (elementId: string, slideIndex?: number) => a | undefined;
-    /**
-     * Update one or more properties of an element by ID on the active slide.
-     * Accepts a `Partial<PptxElement>` patch (e.g. `{ x: 100, width: 300 }`).
-     */
-    updateElement: (elementId: string, updates: Partial<a>) => void;
-    /** Delete elements by their IDs from the active slide. */
-    deleteElements: (elementIds: string[]) => void;
-    /**
-     * Duplicate an element on the active slide.
-     * Returns the new element's ID, or undefined if the source was not found.
-     */
-    duplicateElement: (elementId: string) => string | undefined;
-    /** Get the IDs of currently selected elements. */
-    getSelectedElementIds: () => string[];
-    /** Programmatically select elements by their IDs. */
-    selectElements: (ids: string[]) => void;
-    /** Clear the current selection. */
-    clearSelection: () => void;
-}
-/** Collaboration role within a session. */
-type CollaborationRole = 'owner' | 'collaborator' | 'viewer';
-/**
- * Collaboration transport.
- *
- * - `'websocket'` (default): y-websocket against `serverUrl`.
- * - `'webrtc'`: y-webrtc peer-to-peer; needs no document server. Peers meet
- *   through the `signaling` servers (WebRTC signaling only, no document data)
- *   and same-browser tabs additionally sync via BroadcastChannel even without
- *   any signaling server, which makes this mode usable from static hosting.
- */
-type CollaborationTransport = 'websocket' | 'webrtc';
-/**
- * Real-time collaboration configuration.
- *
- * The same shape is accepted by the React, Vue, and Angular bindings.
- */
-interface CollaborationConfig {
-    /** Unique identifier for the collaboration room (alphanumeric, hyphens, underscores). */
-    roomId: string;
-    /**
-     * WebSocket server URL for the Yjs provider (e.g. "wss://collab.example.com").
-     * Ignored (may be empty) when `transport` is `'webrtc'`.
-     */
-    serverUrl: string;
-    /** Transport to use. Defaults to `'websocket'`. */
-    transport?: CollaborationTransport;
-    /**
-     * WebRTC signaling server URLs (only used when `transport` is `'webrtc'`).
-     * Defaults to y-webrtc's built-in public signaling list. Same-browser tabs
-     * sync via BroadcastChannel regardless of signaling availability.
-     */
-    signaling?: string[];
-    /** Display name for the local user. */
-    userName: string;
-    /** Avatar URL for the local user (optional). */
-    userAvatar?: string;
-    /** Hex colour for the local user's cursor/presence indicator. */
-    userColor?: string;
-    /** Optional authentication token sent with the WebSocket handshake. */
-    authToken?: string;
-    /** Role in the session; defaults to `'collaborator'`. */
-    role?: CollaborationRole;
-    /**
-     * Elected-writer write-back callback (Area 3 of the C3 hardening plan).
-     *
-     * When the local user has `role: 'owner'`, the binding debounces changes and
-     * serializes the current Y.Doc state to a PPTX byte array, then calls this
-     * callback so the host can persist the snapshot. Only one writer (the owner)
-     * does this; other collaborators never trigger write-back, eliminating the
-     * last-save-wins problem.
-     */
-    onWriteBack?: (bytes: Uint8Array) => void;
-    /**
-     * Debounce delay (ms) between the last Y.Doc change and the write-back
-     * invocation. Defaults to 5000 ms. Set to 0 to write back on every change
-     * (not recommended for large documents).
-     */
-    writeBackDebounceMs?: number;
-}
-/** Snapshot of a single element's animation state at a point in the timeline. */
-interface ElementAnimationState {
-    /** Whether the element should be visible. */
-    visible: boolean;
-    /** CSS animation shorthand to apply (undefined = no active animation). */
-    cssAnimation: string | undefined;
-}
-
-/**
- * "Change Case" text mutation (PowerPoint's Aa dropdown: Sentence case, lower,
- * UPPER, Capitalize Each Word, tOGGLE cASE). Unlike `textCaps` (a purely
- * visual `text-transform`-style render hint), these modes rewrite the actual
- * characters, matching PowerPoint's own behaviour. Framework-agnostic; no
- * framework imports.
- */
-
-type ChangeCaseMode = 'sentence' | 'lower' | 'upper' | 'capitalize' | 'toggle';
-
-/**
- * slide-compare — pure, framework-agnostic slide-diff engine shared by every
- * binding (React / Vue / Angular).
- *
- * Provides two entry points over the same element-diff core:
- *   - `comparePresentation(base, compare)` — diffs two full `PptxData` documents
- *     (the React surface).
- *   - `compareSlides(base, compare)` — diffs two `PptxSlide[]` arrays directly
- *     (the Vue editor-foundation surface), plus `compareSlide` for a single
- *     slide pair and `diffSlideElements` for the flattened element trees.
- *
- * DOM-free and side-effect-free.
- */
-
-type SlideDiffStatus = 'added' | 'removed' | 'changed' | 'unchanged';
-type ElementChangeKind = 'added' | 'removed' | 'moved' | 'resized' | 'textChanged';
-interface ElementChange {
-    elementId: string;
-    label: string;
-    kind: ElementChangeKind;
-    description: string;
-}
-interface SlideDiff {
-    status: SlideDiffStatus;
-    /** Index in the base (current) presentation, or -1 for added slides. */
-    baseIndex: number;
-    /** Index in the compare (other) presentation, or -1 for removed slides. */
-    compareIndex: number;
-    /** The base slide data (undefined for added slides). */
-    baseSlide?: P;
-    /** The compare slide data (undefined for removed slides). */
-    compareSlide?: P;
-    /** Per-element changes when status is `changed`. */
-    changes: ElementChange[];
-}
-interface CompareResult {
-    diffs: SlideDiff[];
-    baseSlideCount: number;
-    compareSlideCount: number;
-    addedCount: number;
-    removedCount: number;
-    changedCount: number;
-    unchangedCount: number;
-}
-
-/**
- * mobile-viewport.ts: framework-agnostic viewport / touch / orientation
- * detection shared by the React, Vue, and Angular bindings.
- *
- * These are the pure predicates and feature-detection helpers behind each
- * binding's `useIsMobile` / `IsMobileService`. The reactive wiring (React
- * state, Vue refs, Angular signals) stays in the binding; the breakpoint maths
- * and DOM capability probes live here so all three frameworks switch chrome at
- * exactly the same thresholds.
- *
- * SSR / test safe: every probe feature-detects `window` / `navigator` /
- * `screen` and returns a sensible default when absent.
- */
-/** Mobile breakpoint: below this width is considered mobile. */
-declare const MOBILE_BREAKPOINT = 768;
-/** Tablet breakpoint: below this width (but >= MOBILE) is tablet. */
-declare const TABLET_BREAKPOINT = 1024;
-/** Device orientation as reported by the screen / viewport aspect ratio. */
-type DeviceOrientation = 'portrait' | 'landscape';
-interface TouchGestureCallbacks {
-    /** Called continuously during a pinch gesture with the new (clamped) scale. */
-    onPinchZoom?: (newScale: number) => void;
-    /** Called when a horizontal swipe is detected. direction: -1 = left, 1 = right. */
-    onSwipe?: (direction: -1 | 1) => void;
-    /** Called when a long-press is detected, with the press coordinates. */
-    onLongPress?: (clientX: number, clientY: number) => void;
-}
-/** In-memory clipboard payload stored when an element is copied or cut. */
-interface ElementClipboardPayload {
-    element: a;
-    isTemplate: boolean;
-}
-
-/**
- * Pure handout layout calculations, shared by every binding's print path.
- *
- * Handles distributing slides across pages, computing grid dimensions, and
- * positioning cells within A4 page space. No DOM/framework dependency: callers
- * render the resulting rectangles however their view layer prefers.
- */
-/** Supported slides-per-page values. */
-type HandoutSlidesPerPage = 1 | 2 | 3 | 4 | 6 | 9;
-
-/**
- * Pure print helpers shared by every binding's print path: settings validation,
- * slide-range / colour-filter resolution, page-count estimation, HTML markup
- * builders, escaping, and the full print-document assembler.
- *
- * No DOM side effects and no `window.print()`: everything is deterministic and
- * the binding writes the returned HTML string into a print window. The handout
- * grid geometry lives in `handout-layout`; this module reuses it.
- *
- * ng-packagr constraint honoured here (the Angular binding inlines this source
- * and compiles it through ng-packagr): NO `String.prototype.replaceAll`
- * (`escapeHtml` uses `.split(x).join(y)` instead).
- */
-
-/** What to print. */
-type PrintWhat = 'slides' | 'handouts' | 'notes' | 'outline';
-/** Page orientation for the printed output. */
-type PrintOrientation = 'portrait' | 'landscape';
-/** Colour mode for the printed output. */
-type PrintColorMode = 'color' | 'grayscale' | 'blackAndWhite';
-/** Slide range mode. */
-type PrintSlideRange = 'all' | 'current' | 'custom';
-/** Resolved print settings emitted on confirm. */
-interface PrintSettings {
-    printWhat: PrintWhat;
-    orientation: PrintOrientation;
-    colorMode: PrintColorMode;
-    frameSlides: boolean;
-    slidesPerPage: HandoutSlidesPerPage;
-    slideRange: PrintSlideRange;
-    customRangeFrom: number;
-    customRangeTo: number;
-}
-
-/**
- * Core data-model types for the PowerPoint viewer/editor plugin.
- *
- * Framework-agnostic types (PptxElement, PptxSlide, TextStyle, etc.)
- * live in `pptx-viewer-core`. This module defines additional types used
- * by the React viewer layer for canvas layout, drag/resize interactions,
- * clipboard operations, undo/redo history, geometry, and shape quick styles.
- */
-
-/**
- * Union of all shape preset types that the viewer can insert or render.
- * Maps to OOXML `a:prstGeom` preset values (e.g. "rect", "ellipse").
- * Includes basic shapes, arrows, connectors, and freeform paths.
- */
-type SupportedShapeType = 'rect' | 'roundRect' | 'ellipse' | 'triangle' | 'rtTriangle' | 'diamond' | 'cylinder' | 'parallelogram' | 'trapezoid' | 'pentagon' | 'hexagon' | 'octagon' | 'chevron' | 'star5' | 'star6' | 'star8' | 'plus' | 'heart' | 'cloud' | 'sun' | 'moon' | 'pie' | 'plaque' | 'teardrop' | 'line' | 'rtArrow' | 'leftArrow' | 'upArrow' | 'downArrow' | 'connector' | 'freeform';
-/**
- * Connector geometry presets corresponding to OOXML `a:prstGeom` connector types.
- * Determines the routing style (straight, bent with N segments, or curved).
- */
-type ConnectorGeometryType = 'straightConnector1' | 'bentConnector2' | 'bentConnector3' | 'bentConnector4' | 'bentConnector5' | 'curvedConnector2' | 'curvedConnector3' | 'curvedConnector4' | 'curvedConnector5';
-/** The pixel dimensions of the slide canvas (presentation slide size). */
-interface CanvasSize {
-    /** Width of the canvas in CSS pixels. */
-    width: number;
-    /** Height of the canvas in CSS pixels. */
-    height: number;
-}
-/**
- * Tracks the state of an ongoing element drag operation.
- * Created on pointer-down and destroyed on pointer-up.
- * During the drag, position changes are applied directly to DOM elements
- * for performance (bypassing React state) and committed to state on completion.
- */
-interface DragState {
-    /** ID of the primary element being dragged. */
-    elementId: string;
-    /** Client X coordinate at the start of the drag. */
-    startClientX: number;
-    /** Client Y coordinate at the start of the drag. */
-    startClientY: number;
-    /** Original positions of all selected elements, keyed by element ID. */
-    startPositionsById: Record<string, {
-        x: number;
-        y: number;
-    }>;
-    /** DOM elements cached at drag-start to avoid per-frame querySelector calls. */
-    domEls: Map<string, HTMLElement>;
-    /** Whether the pointer has actually moved since the drag started. */
-    moved: boolean;
-    /** Accumulated delta, stored during DOM-only drag, committed on pointerup. */
-    lastDx: number;
-    lastDy: number;
-}
-/** Handle used as the resize anchor point (corners + edge midpoints). */
-type ResizeHandle = 'nw' | 'ne' | 'sw' | 'se' | 'n' | 's' | 'e' | 'w';
-/**
- * Tracks the state of an ongoing element resize operation.
- * Uses direct DOM manipulation during the resize for performance,
- * then commits the final geometry to React state on pointer-up.
- */
-interface ResizeState {
-    /** ID of the element being resized. */
-    elementId: string;
-    /** Client X coordinate at the start of the resize. */
-    startClientX: number;
-    /** Client Y coordinate at the start of the resize. */
-    startClientY: number;
-    /** Original X position of the element. */
-    startX: number;
-    /** Original Y position of the element. */
-    startY: number;
-    /** Original width of the element. */
-    startWidth: number;
-    /** Original height of the element. */
-    startHeight: number;
-    /** Which handle initiated the resize. */
-    handle: ResizeHandle;
-    /** Whether the pointer has actually moved since the resize started. */
-    moved: boolean;
-    /** DOM element cached at resize-start to avoid per-frame querySelector calls. */
-    domEl: HTMLElement | null;
-    /** Accumulated final geometry, committed on pointerup. */
-    lastX: number;
-    lastY: number;
-    lastWidth: number;
-    lastHeight: number;
-}
-/**
- * Describes the position and value of a shape adjustment handle (yellow diamond).
- * Adjustment handles allow users to modify shape parameters like corner radius,
- * arrow width, etc. without a full resize.
- */
-interface ShapeAdjustmentHandleDescriptor {
-    key: string;
-    left: number;
-    top: number;
-    value: number;
-    cursor: string;
-}
-/**
- * Tracks the state of an ongoing shape adjustment handle drag.
- * Used when the user drags the yellow diamond handle to alter
- * shape-specific parameters (e.g. corner radius on a rounded rectangle).
- */
-interface ShapeAdjustmentDragState {
-    elementId: string;
-    key: string;
-    shapeType: string;
-    startClientX: number;
-    startClientY: number;
-    startAdjustment: number;
-    startWidth: number;
-    startHeight: number;
-    moved: boolean;
-}
-
-/**
- * A snapshot of editor state captured for undo/redo history.
- * Contains the full slide deck state at a point in time so that
- * any editing operation can be reverted or replayed.
- */
-interface EditorHistorySnapshot {
-    width: number;
-    height: number;
-    activeSlideIndex: number;
-    slides: P[];
-    templateElementsBySlideId: Record<string, a[]>;
-    actionLabel?: string;
-}
-/** Axis-aligned bounding box for an element, used for hit-testing and alignment. */
-interface ElementBounds {
-    minX: number;
-    minY: number;
-    maxX: number;
-    maxY: number;
-}
-/**
- * Geometry data for rendering a connector line as an SVG path.
- * Includes start/end coordinates, the SVG path data string,
- * and optional marker (arrowhead) identifiers.
- */
-interface ConnectorPathGeometry {
-    startX: number;
-    startY: number;
-    endX: number;
-    endY: number;
-    pathData: string;
-    d?: string;
-    viewBox?: string;
-    startMarkerId?: string;
-    endMarkerId?: string;
-}
-/** A named preset shape style used in the Quick Styles gallery. */
-interface ShapeQuickStyle {
-    name: string;
-    style: Partial<$>;
-}
-
-/**
- * Base handle interface for file viewer components.
- * Defined locally to avoid dependency on external file-viewer plugin packages.
- * Provides a standard `getContent` method used by the host application to
- * retrieve the current file content (e.g. for saving).
- */
-interface FileViewerHandle {
-    /** Get the current content of the file (for saving) */
-    getContent: () => Promise<string | Uint8Array>;
-}
-/** A shape preset entry used in the toolbar shape insertion palette. */
-interface ShapePreset {
-    type: SupportedShapeType;
-    label: string;
-    icon: React__default.ReactNode;
-}
-/** Tracks the position and target element of an open context menu. */
-interface ElementContextMenuState {
-    x: number;
-    y: number;
-    elementId: string;
-}
-/** Identifies an action triggered from the element right-click context menu. */
-type ElementContextMenuAction = 'copy' | 'cut' | 'paste' | 'duplicate' | 'delete' | 'bring-forward' | 'send-backward' | 'bring-front' | 'send-back' | 'bringForward' | 'sendBackward' | 'bringToFront' | 'sendToBack' | 'comment' | 'addComment' | 'group' | 'ungroup' | 'editPoints' | 'editHyperlink';
-/**
- * State of an active marquee (rubber-band) selection rectangle.
- * Created when the user clicks and drags on the canvas background,
- * and used to compute which elements fall within the selection area.
- */
-interface MarqueeSelectionState {
-    startX: number;
-    startY: number;
-    currentX: number;
-    currentY: number;
-    additive: boolean;
-    baseSelectionIds?: string[];
-}
-/** Tracks which table cell is selected and/or actively being edited. */
-interface TableCellEditorState {
-    rowIndex: number;
-    columnIndex: number;
-    /** When true the cell has an active text input. */
-    isEditing?: boolean;
-    /** Optional multi-cell selection (Shift+Click range). Each entry is {row, col}. */
-    selectedCells?: Array<{
-        row: number;
-        col: number;
-    }>;
-}
-/** A single parsed table cell with its position, text content, and computed CSS style. */
-interface ParsedTableCell {
-    rowIndex: number;
-    columnIndex: number;
-    text: string;
-    style: React__default.CSSProperties;
-    rawCell: X;
-}
-/** Complete parsed table data including row/column structure and all cells. */
-interface ParsedTableData {
-    rowCount: number;
-    columnCount: number;
-    rows: X[];
-    columnPercentages: number[];
-    cells: ParsedTableCell[];
-}
-/** Runtime state for a single element's animation during presentation mode. */
-interface PresentationAnimationRuntime {
-    elementId: string;
-    state: 'hidden' | 'entering' | 'visible';
-    animation: U;
-}
-/**
- * Groups slides into named sections for the slides pane sidebar.
- * Corresponds to OOXML `p15:section` elements in `presentation.xml`.
- */
-interface SlideSectionGroup {
-    id: string;
-    label: string;
-    slideIndexes: number[];
-    /** Section highlight color from p15:sectionPr. */
-    color?: string;
-    /** Whether the section should start collapsed (from p15:sectionPr). */
-    defaultCollapsed?: boolean;
-}
-/** Alignment direction for distributing/aligning multiple selected elements on the slide. */
-type SlideAlignment = 'left' | 'center' | 'right' | 'top' | 'middle' | 'bottom';
-/** Identifies one of the ribbon-style toolbar tabs (home, insert, text, etc.). */
-type ToolbarSection = 'file' | 'home' | 'insert' | 'text' | 'arrange' | 'draw' | 'design' | 'transitions' | 'animations' | 'slideShow' | 'record' | 'review' | 'view' | 'help';
-/** The active drawing/inking tool selected in the Draw toolbar tab. */
-type DrawingTool = 'select' | 'pen' | 'highlighter' | 'eraser' | 'freeform';
-/** A single entry in the keyboard shortcuts help panel. */
-interface ShortcutReferenceItem {
-    actionKey: string;
-    shortcut: string;
-}
-/** An accessibility audit finding (missing alt text, reading order issues, etc.). */
-interface AccessibilityIssue {
-    slideIndex: number;
-    elementId?: string;
-    severity: 'error' | 'warning' | 'info';
-    message: string;
-}
-/** Dropdown option for selecting a connector geometry type. */
-interface ConnectorGeometryOption {
-    value: ConnectorGeometryType;
-    label: string;
-}
-/** Dropdown option for selecting a connector arrowhead style. */
-interface ConnectorArrowOption {
-    value: j;
-    label: string;
-}
-/** Dropdown option for selecting a stroke dash pattern. */
-interface StrokeDashOption {
-    value: i;
-    label: string;
-}
-/** Dropdown option for selecting a slide transition type. */
-interface SlideTransitionOption {
-    value: NonNullable<R['type']>;
-    label: string;
-}
-/** Dropdown option for selecting an animation effect preset. */
-interface AnimationPresetOption {
-    value: Exclude<g, 'none'>;
-    label: string;
-}
-interface PowerPointViewerProps {
-    /** PowerPoint content as Uint8Array */
-    content: Uint8Array;
-    /** Original file path, used for autosave recovery */
-    filePath?: string;
-    /**
-     * Display name of the open document, shown in the PowerPoint-style title
-     * bar (e.g. "quarterly-review.pptx"). Falls back to a generic label.
-     */
-    fileName?: string;
-    /** Callback when content has unsaved changes */
-    onDirtyChange?: (isDirty: boolean) => void;
-    onContentChange?: (content: Uint8Array) => void;
-    /** Callback when active slide changes */
-    onActiveSlideChange?: (slideIndex: number) => void;
-    /** Callback when the viewer mode changes (e.g. edit to present). */
-    onModeChange?: (mode: ViewerMode) => void;
-    /** Callback when the zoom level changes. */
-    onZoomChange?: (zoom: number) => void;
-    /** Callback when element selection changes. */
-    onSelectionChange?: (elementIds: string[]) => void;
-    /** Callback when the total slide count changes (slide added/deleted). */
-    onSlideCountChange?: (count: number) => void;
-    /**
-     * Host override for the File ▸ Open action. When provided, the built-in
-     * native file picker is bypassed and this is invoked instead; the host is
-     * then responsible for supplying a new `content` buffer. When omitted, the
-     * viewer opens its own picker and loads the chosen presentation in place.
-     */
-    onOpenFile?: () => void;
-    /** Whether editing actions are enabled */
-    canEdit?: boolean;
-    /** Optional class name */
-    className?: string;
-    /**
-     * Display name used as the author for comments and annotations.
-     * Falls back to `collaboration.userName` when collaborating, or `'You'`.
-     */
-    authorName?: string;
-    /**
-     * Theme configuration for customising the viewer's appearance.
-     *
-     * Accepts partial color overrides, a custom border-radius, and
-     * arbitrary CSS custom properties. Unset values fall back to the
-     * built-in dark theme.
-     *
-     * @example
-     * ```tsx
-     * <PowerPointViewer
-     *   content={bytes}
-     *   theme={{
-     *     colors: { primary: "#6366f1", background: "#0f172a" },
-     *     radius: "0.75rem",
-     *   }}
-     * />
-     * ```
-     *
-     * @see {@link ViewerTheme} for the full type definition.
-     */
-    theme?: ViewerTheme;
-    /**
-     * Optional real-time collaboration configuration.
-     *
-     * When provided, the viewer enables collaborative editing with live
-     * cursors, user presence indicators, and CRDT-based state sync via Yjs.
-     * Requires `yjs` and `y-websocket` peer dependencies.
-     *
-     * @example
-     * ```tsx
-     * <PowerPointViewer
-     *   content={bytes}
-     *   collaboration={{
-     *     roomId: "my-room-123",
-     *     serverUrl: "wss://collab.example.com",
-     *     userName: "Alice",
-     *     userColor: "#6366f1",
-     *   }}
-     * />
-     * ```
-     */
-    collaboration?: CollaborationConfig;
-    /**
-     * Callback invoked when the user starts a collaboration session from the
-     * Share dialog. The host app should use this to set the `collaboration`
-     * prop with the returned config.
-     */
-    onStartCollaboration?: (config: CollaborationConfig) => void;
-    /**
-     * Callback invoked when the user stops a collaboration session from the
-     * Share dialog. The host app should clear the `collaboration` prop.
-     */
-    onStopCollaboration?: () => void;
-    /**
-     * Default values for the Share dialog fields. The host app should provide
-     * these to control the session name, user display name, and server URL.
-     * If omitted, the Share dialog fields will be empty and require user input.
-     *
-     * @example
-     * ```tsx
-     * <PowerPointViewer
-     *   shareDefaults={{
-     *     roomId: "session-abc123",
-     *     userName: "Alice",
-     *     serverUrl: "ws://localhost:1234",
-     *   }}
-     * />
-     * ```
-     */
-    shareDefaults?: {
-        roomId?: string;
-        userName?: string;
-        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`.
-     */
-    smartArt3D?: boolean;
-}
-interface PowerPointViewerHandle extends FileViewerHandle, PowerPointViewerAPI {
-    getContent: () => Promise<Uint8Array>;
-}
-
-export { type AccessibilityIssue as A, type SupportedShapeType as B, type CollaborationConfig as C, type DragState as D, type EditorHistorySnapshot as E, type FileViewerHandle as F, type ToolbarSection as G, type ElementAnimationState as H, type ChangeCaseMode as I, type PrintSettings as J, type CompareResult as K, type DeviceOrientation as L, type MarqueeSelectionState as M, type TouchGestureCallbacks as N, MOBILE_BREAKPOINT as O, type PowerPointViewerAPI as P, TABLET_BREAKPOINT as Q, type ResizeHandle as R, type ShapeAdjustmentDragState as S, type TableCellEditorState as T, type ViewerMode as V, type PowerPointViewerHandle as a, type PowerPointViewerProps as b, type AnimationPresetOption as c, type CanvasSize as d, type CollaborationRole as e, type ConnectorArrowOption as f, type ConnectorGeometryOption as g, type ConnectorGeometryType as h, type ConnectorPathGeometry as i, type DrawingTool as j, type ElementBounds as k, type ElementClipboardPayload as l, type ElementContextMenuAction as m, type ElementContextMenuState as n, type ParsedTableCell as o, type ParsedTableData as p, type PresentationAnimationRuntime as q, type ResizeState as r, type ShapeAdjustmentHandleDescriptor as s, type ShapePreset as t, type ShapeQuickStyle as u, type ShortcutReferenceItem as v, type SlideAlignment as w, type SlideSectionGroup as x, type SlideTransitionOption as y, type StrokeDashOption as z };