pptx-react-viewer 1.1.72 → 1.1.74

package/CHANGELOG.md

@@ -4,6 +4,12 @@ All notable changes to this project are documented here.
 This file is generated from [Conventional Commits](https://www.conventionalcommits.org)
 by [git-cliff](https://git-cliff.org); do not edit it by hand.
 
+## [1.1.73](https://github.com/ChristopherVR/pptx-viewer/releases/tag/pptx-react-viewer@1.1.73) - 2026-07-03
+
+### Features
+
+- Document localization and add demo language pickers (by @ChristopherVR) ([a07ad82](https://github.com/ChristopherVR/pptx-viewer/commit/a07ad8279e906590e0392d19cd1637855012a80e))
+
 ## [1.1.71](https://github.com/ChristopherVR/pptx-viewer/releases/tag/pptx-react-viewer@1.1.71) - 2026-07-02
 
 ### Features

package/README.md

@@ -145,7 +145,7 @@ All `ViewerTheme.colors` keys are optional; override only what you need. Helpers
 
 ## Localization (i18n)
 
-UI labels go through [i18next](https://www.i18next.com/) / [react-i18next](https://react.i18next.com/) with dotted keys such as `pptx.statusBar.allSaved`. Initialise an i18next instance and wrap your app in `I18nextProvider` (the demo's `demo/i18n.ts` shows a minimal config, including a `parseMissingKeyHandler` that derives Title Case labels for any key you don't explicitly translate). Add a new language by supplying a resource bundle under its language code.
+UI labels go through [i18next](https://www.i18next.com/) / [react-i18next](https://react.i18next.com/) with dotted keys such as `pptx.statusBar.allSaved`. Initialise an i18next instance and wrap your app in `I18nextProvider` (the demo's `demo/i18n.ts` shows a minimal config, including a `parseMissingKeyHandler` that derives Title Case labels for any key you don't explicitly translate). `pptx-react-viewer/i18n` exports `translationsEn` (the English dictionary), `keyToLabel` (the fallback), and a `TranslationKey` type you can use to type-check a new locale dictionary (`Record<TranslationKey, string>`) at compile time. Add a new language by supplying a resource bundle under its language code. See the [Localization guide](https://christophervr.github.io/pptx-viewer/guide/localization) for full wiring examples and how to contribute a translation upstream; the live demo's language picker is a working reference.
 
 ## How it's built
 

package/dist/{PowerPointViewer-DSaLy8x5.d.mts → PowerPointViewer-DNlwKuTs.d.mts}

@@ -2,7 +2,6 @@ import { l, P, $, f, i, X, U, R, h, V } from './presentation-BRAUjTRt.js';
 import * as React from 'react';
 import React__default from 'react';
 import { ViewerTheme } from './theme/index.js';
-import { Doc } from 'yjs';
 
 /**
  * Core data-model types for the PowerPoint viewer/editor plugin.
@@ -177,20 +176,37 @@ interface ShapeQuickStyle {
 
 /** Collaboration role within a session. */
 type CollaborationRole = 'owner' | 'collaborator' | 'viewer';
-
 /**
- * Collaboration types: Shared type definitions for the real-time
- * collaboration infrastructure (Yjs-backed CRDT sync, presence tracking,
- * collaborative editing).
+ * Collaboration transport.
  *
- * @module collaboration/types
+ * - `'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"). */
+    /**
+     * 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). */
@@ -199,53 +215,24 @@ interface CollaborationConfig {
     userColor?: string;
     /** Optional authentication token sent with the WebSocket handshake. */
     authToken?: string;
-    /** Role in the session: defaults to `'collaborator'`. */
-    role?: CollaborationRole;
-}
-/** Connection lifecycle states for the Yjs WebSocket provider. */
-type ConnectionStatus = 'disconnected' | 'connecting' | 'connected' | 'error';
-/**
- * Presence data broadcast to other participants.
- * Cursor position is relative to the slide canvas (0..canvasWidth, 0..canvasHeight).
- */
-interface UserPresence {
-    /** Unique client ID (assigned by Yjs awareness). */
-    clientId: number;
-    /** Sanitised display name. */
-    userName: string;
-    /** Optional avatar URL (validated). */
-    userAvatar?: string;
-    /** Hex colour for the user's cursor ring. */
-    userColor: string;
-    /** Slide index the user is currently viewing. */
-    activeSlideIndex: number;
-    /** Cursor X on the canvas (clamped to slide bounds). */
-    cursorX: number;
-    /** Cursor Y on the canvas (clamped to slide bounds). */
-    cursorY: number;
-    /** ISO timestamp of last update (for stale-presence cleanup). */
-    lastUpdated: string;
-    /** Optional currently selected element ID. */
-    selectedElementId?: string;
-    /** Role in the session (owner, viewer, or collaborator). */
+    /** Role in the session; defaults to `'collaborator'`. */
     role?: CollaborationRole;
-}
-/** Value exposed by `CollaborationContext`. */
-interface CollaborationContextValue {
-    /** Current WebSocket connection status. */
-    status: ConnectionStatus;
-    /** Presence data for all remote users (excludes the local user). */
-    remoteUsers: UserPresence[];
-    /** Broadcast the local user's presence state. */
-    broadcastPresence: (update: Partial<Omit<UserPresence, 'clientId'>>) => void;
-    /** Total number of connected users (including local). */
-    connectedCount: number;
-    /** The collaboration config that was provided. */
-    config: CollaborationConfig;
-    /** The Yjs document (for document sync). */
-    doc: Doc | null;
-    /** Manually retry the WebSocket connection after a timeout or error. */
-    retry: () => void;
+    /**
+     * 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;
 }
 
 /**
@@ -508,4 +495,4 @@ declare function getAnimationInitialStyle(preset: f | undefined, nativeAnimation
  */
 declare const PowerPointViewer: React.ForwardRefExoticComponent<PowerPointViewerProps & React.RefAttributes<PowerPointViewerHandle>>;
 
-export { type AccessibilityIssue as A, type SlideSectionGroup as B, type CollaborationConfig as C, type DragState as D, type EditorHistorySnapshot as E, type FileViewerHandle as F, type SlideTransitionOption as G, type StrokeDashOption as H, type SupportedShapeType as I, type ToolbarSection as J, type MarqueeSelectionState as M, PowerPointViewer as P, type ResizeHandle as R, type ShapeAdjustmentDragState as S, type TableCellEditorState as T, type UserPresence as U, type ViewerMode as V, type PowerPointViewerHandle as a, type PowerPointViewerProps as b, type ConnectionStatus as c, type CollaborationContextValue as d, type AnimationPresetOption as e, type CanvasSize as f, getAnimationInitialStyle as g, type CollaborationRole as h, type ConnectorArrowOption as i, type ConnectorGeometryOption as j, type ConnectorGeometryType as k, type ConnectorPathGeometry as l, type DrawingTool as m, type ElementBounds as n, type ElementClipboardPayload as o, type ElementContextMenuAction as p, type ElementContextMenuState as q, type ParsedTableCell as r, type ParsedTableData as s, type PresentationAnimationRuntime as t, type ResizeState as u, type ShapeAdjustmentHandleDescriptor as v, type ShapePreset as w, type ShapeQuickStyle as x, type ShortcutReferenceItem as y, type SlideAlignment as z };
+export { type AccessibilityIssue as A, type StrokeDashOption as B, type CollaborationRole as C, type DragState as D, type EditorHistorySnapshot as E, type FileViewerHandle as F, type SupportedShapeType as G, type ToolbarSection as H, type MarqueeSelectionState as M, PowerPointViewer as P, 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 CollaborationConfig as c, type AnimationPresetOption as d, type CanvasSize as e, type ConnectorArrowOption as f, getAnimationInitialStyle as g, type ConnectorGeometryOption as h, type ConnectorGeometryType as i, type ConnectorPathGeometry as j, type DrawingTool as k, type ElementBounds as l, type ElementClipboardPayload as m, type ElementContextMenuAction as n, type ElementContextMenuState as o, type ParsedTableCell as p, type ParsedTableData as q, type PresentationAnimationRuntime as r, type ResizeState as s, type ShapeAdjustmentHandleDescriptor as t, type ShapePreset as u, type ShapeQuickStyle as v, type ShortcutReferenceItem as w, type SlideAlignment as x, type SlideSectionGroup as y, type SlideTransitionOption as z };

package/dist/{PowerPointViewer-DSaLy8x5.d.ts → PowerPointViewer-DNlwKuTs.d.ts}

@@ -2,7 +2,6 @@ import { l, P, $, f, i, X, U, R, h, V } from './presentation-BRAUjTRt.js';
 import * as React from 'react';
 import React__default from 'react';
 import { ViewerTheme } from './theme/index.js';
-import { Doc } from 'yjs';
 
 /**
  * Core data-model types for the PowerPoint viewer/editor plugin.
@@ -177,20 +176,37 @@ interface ShapeQuickStyle {
 
 /** Collaboration role within a session. */
 type CollaborationRole = 'owner' | 'collaborator' | 'viewer';
-
 /**
- * Collaboration types: Shared type definitions for the real-time
- * collaboration infrastructure (Yjs-backed CRDT sync, presence tracking,
- * collaborative editing).
+ * Collaboration transport.
  *
- * @module collaboration/types
+ * - `'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"). */
+    /**
+     * 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). */
@@ -199,53 +215,24 @@ interface CollaborationConfig {
     userColor?: string;
     /** Optional authentication token sent with the WebSocket handshake. */
     authToken?: string;
-    /** Role in the session: defaults to `'collaborator'`. */
-    role?: CollaborationRole;
-}
-/** Connection lifecycle states for the Yjs WebSocket provider. */
-type ConnectionStatus = 'disconnected' | 'connecting' | 'connected' | 'error';
-/**
- * Presence data broadcast to other participants.
- * Cursor position is relative to the slide canvas (0..canvasWidth, 0..canvasHeight).
- */
-interface UserPresence {
-    /** Unique client ID (assigned by Yjs awareness). */
-    clientId: number;
-    /** Sanitised display name. */
-    userName: string;
-    /** Optional avatar URL (validated). */
-    userAvatar?: string;
-    /** Hex colour for the user's cursor ring. */
-    userColor: string;
-    /** Slide index the user is currently viewing. */
-    activeSlideIndex: number;
-    /** Cursor X on the canvas (clamped to slide bounds). */
-    cursorX: number;
-    /** Cursor Y on the canvas (clamped to slide bounds). */
-    cursorY: number;
-    /** ISO timestamp of last update (for stale-presence cleanup). */
-    lastUpdated: string;
-    /** Optional currently selected element ID. */
-    selectedElementId?: string;
-    /** Role in the session (owner, viewer, or collaborator). */
+    /** Role in the session; defaults to `'collaborator'`. */
     role?: CollaborationRole;
-}
-/** Value exposed by `CollaborationContext`. */
-interface CollaborationContextValue {
-    /** Current WebSocket connection status. */
-    status: ConnectionStatus;
-    /** Presence data for all remote users (excludes the local user). */
-    remoteUsers: UserPresence[];
-    /** Broadcast the local user's presence state. */
-    broadcastPresence: (update: Partial<Omit<UserPresence, 'clientId'>>) => void;
-    /** Total number of connected users (including local). */
-    connectedCount: number;
-    /** The collaboration config that was provided. */
-    config: CollaborationConfig;
-    /** The Yjs document (for document sync). */
-    doc: Doc | null;
-    /** Manually retry the WebSocket connection after a timeout or error. */
-    retry: () => void;
+    /**
+     * 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;
 }
 
 /**
@@ -508,4 +495,4 @@ declare function getAnimationInitialStyle(preset: f | undefined, nativeAnimation
  */
 declare const PowerPointViewer: React.ForwardRefExoticComponent<PowerPointViewerProps & React.RefAttributes<PowerPointViewerHandle>>;
 
-export { type AccessibilityIssue as A, type SlideSectionGroup as B, type CollaborationConfig as C, type DragState as D, type EditorHistorySnapshot as E, type FileViewerHandle as F, type SlideTransitionOption as G, type StrokeDashOption as H, type SupportedShapeType as I, type ToolbarSection as J, type MarqueeSelectionState as M, PowerPointViewer as P, type ResizeHandle as R, type ShapeAdjustmentDragState as S, type TableCellEditorState as T, type UserPresence as U, type ViewerMode as V, type PowerPointViewerHandle as a, type PowerPointViewerProps as b, type ConnectionStatus as c, type CollaborationContextValue as d, type AnimationPresetOption as e, type CanvasSize as f, getAnimationInitialStyle as g, type CollaborationRole as h, type ConnectorArrowOption as i, type ConnectorGeometryOption as j, type ConnectorGeometryType as k, type ConnectorPathGeometry as l, type DrawingTool as m, type ElementBounds as n, type ElementClipboardPayload as o, type ElementContextMenuAction as p, type ElementContextMenuState as q, type ParsedTableCell as r, type ParsedTableData as s, type PresentationAnimationRuntime as t, type ResizeState as u, type ShapeAdjustmentHandleDescriptor as v, type ShapePreset as w, type ShapeQuickStyle as x, type ShortcutReferenceItem as y, type SlideAlignment as z };
+export { type AccessibilityIssue as A, type StrokeDashOption as B, type CollaborationRole as C, type DragState as D, type EditorHistorySnapshot as E, type FileViewerHandle as F, type SupportedShapeType as G, type ToolbarSection as H, type MarqueeSelectionState as M, PowerPointViewer as P, 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 CollaborationConfig as c, type AnimationPresetOption as d, type CanvasSize as e, type ConnectorArrowOption as f, getAnimationInitialStyle as g, type ConnectorGeometryOption as h, type ConnectorGeometryType as i, type ConnectorPathGeometry as j, type DrawingTool as k, type ElementBounds as l, type ElementClipboardPayload as m, type ElementContextMenuAction as n, type ElementContextMenuState as o, type ParsedTableCell as p, type ParsedTableData as q, type PresentationAnimationRuntime as r, type ResizeState as s, type ShapeAdjustmentHandleDescriptor as t, type ShapePreset as u, type ShapeQuickStyle as v, type ShortcutReferenceItem as w, type SlideAlignment as x, type SlideSectionGroup as y, type SlideTransitionOption as z };

package/dist/i18n.d.mts

@@ -1 +1 @@
-export { keyToLabel, translationsEn } from 'pptx-viewer-shared/i18n';
+export { TranslationKey, keyToLabel, translationsEn } from 'pptx-viewer-shared/i18n';

package/dist/i18n.d.ts

@@ -1 +1 @@
-export { keyToLabel, translationsEn } from 'pptx-viewer-shared/i18n';
+export { TranslationKey, keyToLabel, translationsEn } from 'pptx-viewer-shared/i18n';