pptx-react-viewer 1.1.23 → 1.1.31

package/dist/{PowerPointViewer-BZa65J1D.d.mts → PowerPointViewer-765OcwHH.d.mts}

@@ -1,4 +1,4 @@
-import { l, P, $, f, i, X, U, R, h, V } from './presentation-nZxgWvXq.js';
+import { l, P, $, f, i, X, U, R, h, V } from './presentation-BWchOWpy.js';
 import * as React from 'react';
 import React__default from 'react';
 import { ViewerTheme } from './theme/index.js';
@@ -62,7 +62,7 @@ interface DragState {
     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. */
+    /** Accumulated delta, stored during DOM-only drag, committed on pointerup. */
     lastDx: number;
     lastDy: number;
 }
@@ -94,7 +94,7 @@ interface ResizeState {
     moved: boolean;
     /** DOM element cached at resize-start to avoid per-frame querySelector calls. */
     domEl: HTMLElement | null;
-    /** Accumulated final geometry — committed on pointerup. */
+    /** Accumulated final geometry, committed on pointerup. */
     lastX: number;
     lastY: number;
     lastWidth: number;
@@ -176,7 +176,7 @@ interface ShapeQuickStyle {
 }
 
 /**
- * Collaboration types — Shared type definitions for the real-time
+ * Collaboration types: Shared type definitions for the real-time
  * collaboration infrastructure (Yjs-backed CRDT sync, presence tracking,
  * collaborative editing).
  *
@@ -205,7 +205,7 @@ interface CollaborationConfig {
     userColor?: string;
     /** Optional authentication token sent with the WebSocket handshake. */
     authToken?: string;
-    /** Role in the session — defaults to `'collaborator'`. */
+    /** Role in the session: defaults to `'collaborator'`. */
     role?: CollaborationRole;
 }
 /** Connection lifecycle states for the Yjs WebSocket provider. */
@@ -384,13 +384,20 @@ interface AnimationPresetOption {
 interface PowerPointViewerProps {
     /** PowerPoint content as Uint8Array */
     content: Uint8Array;
-    /** Original file path — used for autosave recovery */
+    /** Original file path, used for autosave recovery */
     filePath?: string;
     /** Callback when content has unsaved changes */
     onDirtyChange?: (isDirty: boolean) => void;
     onContentChange?: (content: Uint8Array) => void;
     /** Callback when active slide changes */
     onActiveSlideChange?: (slideIndex: 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 */
@@ -474,11 +481,26 @@ interface PowerPointViewerProps {
         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 {
     getContent: () => Promise<Uint8Array>;
 }
 
+/**
+ * Thin adapter shim: the initial-style resolution now lives in
+ * `pptx-viewer-shared` (`render/animation-effects`). Shared returns a neutral
+ * `AnimationStyle` (camelCase inline-style map); these wrappers re-type the
+ * result as `React.CSSProperties` so React consumers/tests are unchanged.
+ */
+
 declare function getAnimationInitialStyle(preset: f | undefined, nativeAnimation?: V): React__default.CSSProperties;
 
 /**

package/dist/{PowerPointViewer-BZa65J1D.d.ts → PowerPointViewer-765OcwHH.d.ts}

@@ -1,4 +1,4 @@
-import { l, P, $, f, i, X, U, R, h, V } from './presentation-nZxgWvXq.js';
+import { l, P, $, f, i, X, U, R, h, V } from './presentation-BWchOWpy.js';
 import * as React from 'react';
 import React__default from 'react';
 import { ViewerTheme } from './theme/index.js';
@@ -62,7 +62,7 @@ interface DragState {
     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. */
+    /** Accumulated delta, stored during DOM-only drag, committed on pointerup. */
     lastDx: number;
     lastDy: number;
 }
@@ -94,7 +94,7 @@ interface ResizeState {
     moved: boolean;
     /** DOM element cached at resize-start to avoid per-frame querySelector calls. */
     domEl: HTMLElement | null;
-    /** Accumulated final geometry — committed on pointerup. */
+    /** Accumulated final geometry, committed on pointerup. */
     lastX: number;
     lastY: number;
     lastWidth: number;
@@ -176,7 +176,7 @@ interface ShapeQuickStyle {
 }
 
 /**
- * Collaboration types — Shared type definitions for the real-time
+ * Collaboration types: Shared type definitions for the real-time
  * collaboration infrastructure (Yjs-backed CRDT sync, presence tracking,
  * collaborative editing).
  *
@@ -205,7 +205,7 @@ interface CollaborationConfig {
     userColor?: string;
     /** Optional authentication token sent with the WebSocket handshake. */
     authToken?: string;
-    /** Role in the session — defaults to `'collaborator'`. */
+    /** Role in the session: defaults to `'collaborator'`. */
     role?: CollaborationRole;
 }
 /** Connection lifecycle states for the Yjs WebSocket provider. */
@@ -384,13 +384,20 @@ interface AnimationPresetOption {
 interface PowerPointViewerProps {
     /** PowerPoint content as Uint8Array */
     content: Uint8Array;
-    /** Original file path — used for autosave recovery */
+    /** Original file path, used for autosave recovery */
     filePath?: string;
     /** Callback when content has unsaved changes */
     onDirtyChange?: (isDirty: boolean) => void;
     onContentChange?: (content: Uint8Array) => void;
     /** Callback when active slide changes */
     onActiveSlideChange?: (slideIndex: 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 */
@@ -474,11 +481,26 @@ interface PowerPointViewerProps {
         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 {
     getContent: () => Promise<Uint8Array>;
 }
 
+/**
+ * Thin adapter shim: the initial-style resolution now lives in
+ * `pptx-viewer-shared` (`render/animation-effects`). Shared returns a neutral
+ * `AnimationStyle` (camelCase inline-style map); these wrappers re-type the
+ * result as `React.CSSProperties` so React consumers/tests are unchanged.
+ */
+
 declare function getAnimationInitialStyle(preset: f | undefined, nativeAnimation?: V): React__default.CSSProperties;
 
 /**

package/dist/index.d.mts

@@ -1,9 +1,9 @@
-export { P as PowerPointViewer, a as PowerPointViewerHandle, b as PowerPointViewerProps, g as getAnimationInitialStyle } from './PowerPointViewer-BZa65J1D.mjs';
+export { P as PowerPointViewer, a as PowerPointViewerHandle, b as PowerPointViewerProps, g as getAnimationInitialStyle } from './PowerPointViewer-765OcwHH.mjs';
 import { Options } from 'html2canvas-pro';
 import { ViewerTheme } from './theme/index.js';
 export { ViewerTheme, ViewerThemeColors, defaultCssVars, defaultRadius, defaultThemeColors, themeToCssVars } from './theme/index.js';
 import * as React$1 from 'react';
-import './presentation-nZxgWvXq.js';
+import './presentation-BWchOWpy.js';
 import 'yjs';
 
 interface ViewerThemeProviderProps {
@@ -13,7 +13,7 @@ interface ViewerThemeProviderProps {
 /**
  * Provides a `ViewerTheme` to all descendant viewer components.
  *
- * Typically you do **not** need to use this directly — passing a `theme`
+ * Typically you do **not** need to use this directly; passing a `theme`
  * prop to `<PowerPointViewer>` is sufficient. This provider is exposed
  * for advanced use-cases where you want to wrap multiple viewers or
  * share a theme across a wider subtree.
@@ -28,7 +28,7 @@ declare function useViewerTheme(): ViewerTheme | undefined;
 /**
  * A drop-in replacement for `html2canvas(element, options)` that first
  * resolves any oklch / oklab / lch / lab / color() values in the cloned
- * DOM to rgb()/hex, preventing parse errors in html2canvas ≤ 1.x.
+ * DOM to rgb()/hex, preventing parse errors in html2canvas <= 1.x.
  *
  * Three-pronged approach:
  * 1. Patch `<style>` elements to replace oklch in CSS custom properties.

package/dist/index.d.ts

@@ -1,9 +1,9 @@
-export { P as PowerPointViewer, a as PowerPointViewerHandle, b as PowerPointViewerProps, g as getAnimationInitialStyle } from './PowerPointViewer-BZa65J1D.js';
+export { P as PowerPointViewer, a as PowerPointViewerHandle, b as PowerPointViewerProps, g as getAnimationInitialStyle } from './PowerPointViewer-765OcwHH.js';
 import { Options } from 'html2canvas-pro';
 import { ViewerTheme } from './theme/index.js';
 export { ViewerTheme, ViewerThemeColors, defaultCssVars, defaultRadius, defaultThemeColors, themeToCssVars } from './theme/index.js';
 import * as React$1 from 'react';
-import './presentation-nZxgWvXq.js';
+import './presentation-BWchOWpy.js';
 import 'yjs';
 
 interface ViewerThemeProviderProps {
@@ -13,7 +13,7 @@ interface ViewerThemeProviderProps {
 /**
  * Provides a `ViewerTheme` to all descendant viewer components.
  *
- * Typically you do **not** need to use this directly — passing a `theme`
+ * Typically you do **not** need to use this directly; passing a `theme`
  * prop to `<PowerPointViewer>` is sufficient. This provider is exposed
  * for advanced use-cases where you want to wrap multiple viewers or
  * share a theme across a wider subtree.
@@ -28,7 +28,7 @@ declare function useViewerTheme(): ViewerTheme | undefined;
 /**
  * A drop-in replacement for `html2canvas(element, options)` that first
  * resolves any oklch / oklab / lch / lab / color() values in the cloned
- * DOM to rgb()/hex, preventing parse errors in html2canvas ≤ 1.x.
+ * DOM to rgb()/hex, preventing parse errors in html2canvas <= 1.x.
  *
  * Three-pronged approach:
  * 1. Patch `<style>` elements to replace oklch in CSS custom properties.