pptx-react-viewer 1.10.1 → 1.10.2

package/dist/viewer/index.d.mts

@@ -1,6 +1,6 @@
-import { C as CollaborationRole, d as CollaborationConfig } from '../PowerPointViewer-S-ugGq-b.mjs';
-export { A as AccessibilityIssue, e as AnimationPresetOption, f as CanvasSize, h as ConnectorArrowOption, i as ConnectorGeometryOption, j as ConnectorGeometryType, k as ConnectorPathGeometry, D as DragState, l as DrawingTool, E as EditorHistorySnapshot, m as ElementBounds, n as ElementClipboardPayload, o as ElementContextMenuAction, p as ElementContextMenuState, F as FileViewerHandle, M as MarqueeSelectionState, q as ParsedTableCell, r as ParsedTableData, P as PowerPointViewer, b as PowerPointViewerHandle, c as PowerPointViewerProps, s as PresentationAnimationRuntime, R as ResizeHandle, t as ResizeState, S as ShapeAdjustmentDragState, u as ShapeAdjustmentHandleDescriptor, v as ShapePreset, w as ShapeQuickStyle, x as ShortcutReferenceItem, y as SlideAlignment, z as SlideSectionGroup, B as SlideTransitionOption, G as StrokeDashOption, H as SupportedShapeType, T as TableCellEditorState, I as ToolbarSection, V as ViewerMode, g as getAnimationInitialStyle } from '../PowerPointViewer-S-ugGq-b.mjs';
-import { d, e, n, o, m, l, P, X, p, q, r, s, t, u, v, w, x, y, z, A, B, D, E, F, G, H, J, K, L, h, i, k, j, f, g } from './presentation-BRAUjTRt.js';
+import { C as CollaborationRole, d as CollaborationConfig } from '../PowerPointViewer-88hWoBGx.mjs';
+export { A as AccessibilityIssue, e as AnimationPresetOption, f as CanvasSize, h as ConnectorArrowOption, i as ConnectorGeometryOption, j as ConnectorGeometryType, k as ConnectorPathGeometry, D as DragState, l as DrawingTool, E as EditorHistorySnapshot, m as ElementBounds, n as ElementClipboardPayload, o as ElementContextMenuAction, p as ElementContextMenuState, F as FileViewerHandle, M as MarqueeSelectionState, q as ParsedTableCell, r as ParsedTableData, P as PowerPointViewer, b as PowerPointViewerHandle, c as PowerPointViewerProps, s as PresentationAnimationRuntime, R as ResizeHandle, t as ResizeState, S as ShapeAdjustmentDragState, u as ShapeAdjustmentHandleDescriptor, v as ShapePreset, w as ShapeQuickStyle, x as ShortcutReferenceItem, y as SlideAlignment, z as SlideSectionGroup, B as SlideTransitionOption, G as StrokeDashOption, H as SupportedShapeType, T as TableCellEditorState, I as ToolbarSection, V as ViewerMode, g as getAnimationInitialStyle } from '../PowerPointViewer-88hWoBGx.mjs';
+import { d, e, n, o, m, l, P, X, p, q, r, s, t, u, v, w, x, y, z, A, B, D, E, F, G, H, J, K, L, h, i, k, j, f, g } from './presentation-CLc4eS3z.js';
 import React__default, { RefObject } from 'react';
 import { Doc } from 'yjs';
 import { Awareness } from 'y-protocols/awareness';
@@ -1515,7 +1515,12 @@ declare function useThemeSwitching(input: UseThemeSwitchingInput): ThemeSwitchin
  */
 
 interface UseYjsProviderInput {
-    config: CollaborationConfig;
+    /**
+     * Collaboration config, or `undefined` when collaboration is inactive. The
+     * hook is always called (React hook rules) but stays fully dormant, never
+     * opening a transport, while config is absent.
+     */
+    config?: CollaborationConfig;
 }
 interface UseYjsProviderResult {
     /** Current WebSocket connection status. */
@@ -1584,11 +1589,17 @@ declare function usePresenceTracking({ awareness, localClientId, userName, userC
  */
 
 interface UseCollaborativeStateInput {
-    config: CollaborationConfig;
+    /**
+     * Collaboration config, or `undefined` when collaboration is inactive. The
+     * hook is always called so the surrounding provider keeps a stable React
+     * tree shape; it produces a dormant value (no transport, empty presence)
+     * while config is absent.
+     */
+    config?: CollaborationConfig;
     canvasWidth: number;
     canvasHeight: number;
 }
-declare function useCollaborativeState({ config, canvasWidth, canvasHeight, }: UseCollaborativeStateInput): CollaborationContextValue;
+declare function useCollaborativeState({ config, canvasWidth, canvasHeight, }: UseCollaborativeStateInput): CollaborationContextValue | null;
 
 interface UseCollaborativeHistoryInput {
     /** The local user's client ID (from Yjs awareness). */
@@ -1621,14 +1632,20 @@ declare function useCollaborativeHistory({ localClientId: _localClientId, handle
  * remote user presence, broadcast function) to all child components via
  * `useCollaboration()`.
  *
- * This component is only rendered when `collaboration` config is provided to
- * `PowerPointViewer`, ensuring zero bundle/runtime cost when unused.
+ * This provider is rendered unconditionally by `PowerPointViewer` so that
+ * starting or stopping a collaboration session never changes the React tree
+ * shape (which would force a full unmount/remount of the editor subtree). When
+ * no `config` is supplied it stays completely dormant: it opens no transport,
+ * tracks no presence, and exposes a `null` context value so `useCollaboration()`
+ * reports "not collaborating". The Yjs packages remain dynamically imported, so
+ * there is still zero bundle cost until a session actually starts.
  *
  * @module collaboration/CollaborationProvider
  */
 
 interface CollaborationProviderProps {
-    config: CollaborationConfig;
+    /** Collaboration config, or `undefined`/omitted while no session is active. */
+    config?: CollaborationConfig;
     canvasWidth: number;
     canvasHeight: number;
     children: React__default.ReactNode;

package/dist/viewer/index.d.ts

@@ -1,6 +1,6 @@
-import { C as CollaborationRole, d as CollaborationConfig } from '../PowerPointViewer-S-ugGq-b.js';
-export { A as AccessibilityIssue, e as AnimationPresetOption, f as CanvasSize, h as ConnectorArrowOption, i as ConnectorGeometryOption, j as ConnectorGeometryType, k as ConnectorPathGeometry, D as DragState, l as DrawingTool, E as EditorHistorySnapshot, m as ElementBounds, n as ElementClipboardPayload, o as ElementContextMenuAction, p as ElementContextMenuState, F as FileViewerHandle, M as MarqueeSelectionState, q as ParsedTableCell, r as ParsedTableData, P as PowerPointViewer, b as PowerPointViewerHandle, c as PowerPointViewerProps, s as PresentationAnimationRuntime, R as ResizeHandle, t as ResizeState, S as ShapeAdjustmentDragState, u as ShapeAdjustmentHandleDescriptor, v as ShapePreset, w as ShapeQuickStyle, x as ShortcutReferenceItem, y as SlideAlignment, z as SlideSectionGroup, B as SlideTransitionOption, G as StrokeDashOption, H as SupportedShapeType, T as TableCellEditorState, I as ToolbarSection, V as ViewerMode, g as getAnimationInitialStyle } from '../PowerPointViewer-S-ugGq-b.js';
-import { d, e, n, o, m, l, P, X, p, q, r, s, t, u, v, w, x, y, z, A, B, D, E, F, G, H, J, K, L, h, i, k, j, f, g } from './presentation-BRAUjTRt.js';
+import { C as CollaborationRole, d as CollaborationConfig } from '../PowerPointViewer-88hWoBGx.js';
+export { A as AccessibilityIssue, e as AnimationPresetOption, f as CanvasSize, h as ConnectorArrowOption, i as ConnectorGeometryOption, j as ConnectorGeometryType, k as ConnectorPathGeometry, D as DragState, l as DrawingTool, E as EditorHistorySnapshot, m as ElementBounds, n as ElementClipboardPayload, o as ElementContextMenuAction, p as ElementContextMenuState, F as FileViewerHandle, M as MarqueeSelectionState, q as ParsedTableCell, r as ParsedTableData, P as PowerPointViewer, b as PowerPointViewerHandle, c as PowerPointViewerProps, s as PresentationAnimationRuntime, R as ResizeHandle, t as ResizeState, S as ShapeAdjustmentDragState, u as ShapeAdjustmentHandleDescriptor, v as ShapePreset, w as ShapeQuickStyle, x as ShortcutReferenceItem, y as SlideAlignment, z as SlideSectionGroup, B as SlideTransitionOption, G as StrokeDashOption, H as SupportedShapeType, T as TableCellEditorState, I as ToolbarSection, V as ViewerMode, g as getAnimationInitialStyle } from '../PowerPointViewer-88hWoBGx.js';
+import { d, e, n, o, m, l, P, X, p, q, r, s, t, u, v, w, x, y, z, A, B, D, E, F, G, H, J, K, L, h, i, k, j, f, g } from './presentation-CLc4eS3z.js';
 import React__default, { RefObject } from 'react';
 import { Doc } from 'yjs';
 import { Awareness } from 'y-protocols/awareness';
@@ -1515,7 +1515,12 @@ declare function useThemeSwitching(input: UseThemeSwitchingInput): ThemeSwitchin
  */
 
 interface UseYjsProviderInput {
-    config: CollaborationConfig;
+    /**
+     * Collaboration config, or `undefined` when collaboration is inactive. The
+     * hook is always called (React hook rules) but stays fully dormant, never
+     * opening a transport, while config is absent.
+     */
+    config?: CollaborationConfig;
 }
 interface UseYjsProviderResult {
     /** Current WebSocket connection status. */
@@ -1584,11 +1589,17 @@ declare function usePresenceTracking({ awareness, localClientId, userName, userC
  */
 
 interface UseCollaborativeStateInput {
-    config: CollaborationConfig;
+    /**
+     * Collaboration config, or `undefined` when collaboration is inactive. The
+     * hook is always called so the surrounding provider keeps a stable React
+     * tree shape; it produces a dormant value (no transport, empty presence)
+     * while config is absent.
+     */
+    config?: CollaborationConfig;
     canvasWidth: number;
     canvasHeight: number;
 }
-declare function useCollaborativeState({ config, canvasWidth, canvasHeight, }: UseCollaborativeStateInput): CollaborationContextValue;
+declare function useCollaborativeState({ config, canvasWidth, canvasHeight, }: UseCollaborativeStateInput): CollaborationContextValue | null;
 
 interface UseCollaborativeHistoryInput {
     /** The local user's client ID (from Yjs awareness). */
@@ -1621,14 +1632,20 @@ declare function useCollaborativeHistory({ localClientId: _localClientId, handle
  * remote user presence, broadcast function) to all child components via
  * `useCollaboration()`.
  *
- * This component is only rendered when `collaboration` config is provided to
- * `PowerPointViewer`, ensuring zero bundle/runtime cost when unused.
+ * This provider is rendered unconditionally by `PowerPointViewer` so that
+ * starting or stopping a collaboration session never changes the React tree
+ * shape (which would force a full unmount/remount of the editor subtree). When
+ * no `config` is supplied it stays completely dormant: it opens no transport,
+ * tracks no presence, and exposes a `null` context value so `useCollaboration()`
+ * reports "not collaborating". The Yjs packages remain dynamically imported, so
+ * there is still zero bundle cost until a session actually starts.
  *
  * @module collaboration/CollaborationProvider
  */
 
 interface CollaborationProviderProps {
-    config: CollaborationConfig;
+    /** Collaboration config, or `undefined`/omitted while no session is active. */
+    config?: CollaborationConfig;
     canvasWidth: number;
     canvasHeight: number;
     children: React__default.ReactNode;