pptx-react-viewer 3.20.1 → 3.21.0

package/dist/index.d.ts

@@ -1,5 +1,6 @@
 import * as React$1 from 'react';
 import React$1__default from 'react';
+import { Doc } from 'yjs';
 import { LanguageModel, ChatTransport, UIMessage, ToolSet } from 'ai';
 import { Options } from 'html2canvas-pro';
 
@@ -11645,6 +11646,56 @@ interface TextStyleAnimationDescriptor {
   color?: string;
 }
 
+//#region src/render/collaboration-presence.d.ts
+/** Connection lifecycle states for the Yjs WebSocket provider. */
+type ConnectionStatus = 'disconnected' | 'connecting' | 'connected' | 'error';
+//#endregion
+//#region src/render/collaboration-presence-publisher.d.ts
+/**
+ * Structural interface for the lazily-imported Yjs awareness surface. Every
+ * binding's live `y-protocols/awareness` `Awareness` instance satisfies this.
+ */
+interface AwarenessLike {
+  clientID?: number;
+  setLocalStateField: (field: string, value: unknown) => void;
+  getStates: () => Map<number, Record<string, unknown>>;
+  on: (event: string, cb: () => void) => void;
+  off?: (event: string, cb: () => void) => void;
+}
+//#endregion
+//#region src/render/collaboration-external-session.d.ts
+/** Connection state reported by the host, independent of the viewer lifetime. */
+interface ExternalCollaborationSnapshot {
+  status: ConnectionStatus;
+  /**
+   * The host has loaded the authoritative document and permits local edits.
+   * Keep true while offline to allow ordinary Yjs offline edits, or set false
+   * to suspend writes until a fresh sync. The viewer never infers this from
+   * `status` and never opens it after a timeout.
+   */
+  synced: boolean;
+}
+/** The public y-protocols Awareness surface needed by a borrowed session. */
+interface ExternalCollaborationAwareness extends AwarenessLike {
+  clientID: number;
+  getLocalState: () => Record<string, unknown> | null;
+  setLocalState: (state: Record<string, unknown> | null) => void;
+  off: (event: string, callback: () => void) => void;
+}
+/**
+ * Host-owned Yjs resources. The host creates, connects and destroys them.
+ * Keep this object and its resources stable for a session; report connection
+ * changes through subscribe instead of replacing the collaboration config.
+ */
+interface ExternalCollaborationSession {
+  readonly doc: Doc;
+  /** Awareness must belong to doc. One viewer publishes slide presence at a time. */
+  readonly awareness: ExternalCollaborationAwareness;
+  getSnapshot: () => ExternalCollaborationSnapshot;
+  /** Subscribe to status or synced changes; return an unsubscribe function. */
+  subscribe: (listener: () => void) => () => void;
+}
+//#endregion
 //#region src/render/element-update-batch.d.ts
 /** A shallow property patch for a top-level element on an ordinary slide. */
 interface ElementUpdate {
@@ -11793,11 +11844,18 @@ interface CollaborationConfig {
   roomId: string;
   /**
    * WebSocket server URL for the Yjs provider (e.g. "wss://collab.example.com").
-   * Ignored (may be empty) when `transport` is `'webrtc'`.
+   * Ignored (may be empty) for `externalSession` or when `transport` is `'webrtc'`.
    */
   serverUrl: string;
   /** Transport to use. Defaults to `'websocket'`. */
   transport?: CollaborationTransport;
+  /**
+   * Use the host's document, awareness and transport instead of creating a
+   * provider. Transport, serverUrl, signaling and authToken are ignored. The
+   * viewer only detaches its listeners and presence on stop; it never destroys
+   * these resources. Keep this object stable and report readiness via subscribe.
+   */
+  externalSession?: ExternalCollaborationSession;
   /**
    * WebRTC signaling server URLs (only used when `transport` is `'webrtc'`).
    * Defaults to y-webrtc's built-in public signaling list. Same-browser tabs
@@ -13706,4 +13764,4 @@ declare function SlideTemplatePreview({ templateId, scheme }: SlideTemplatePrevi
 declare function renderToCanvas(element: HTMLElement, options?: Partial<Options>): Promise<HTMLCanvasElement>;
 
 export { AVATAR_COLOR_SWATCHES, DEFAULT_VIEWER_PROFILE, LOCALE_CATALOG, PPTX_OPEN_ACCEPT, PRESENTATION_OPEN_EXTENSIONS, PowerPointViewer, SLIDE_TEMPLATES, SlideCanvas, SlideTemplateGalleryDialog, SlideTemplatePreview, THEME_CATALOG, Toolbar, VIEWER_PREFS_STORAGE_KEY, ViewerThemeProvider, buildSlideTemplateContent, buildSlideTemplateSlide, clearAllLocalViewerData, clearStoredViewerPrefs, createImageElementFromFile, defaultCssVars, defaultRadius, defaultThemeColors, getAnimationInitialStyle, getLocalStorageUsageSummary, isLegacyBinaryPresentation, isSupportedPresentationFile, presentationBaseName, readStoredViewerPrefs, renderToCanvas, resolveProfileInitial, resolveThemeCatalogEntry, saveViewerProfile, savedPresentationFileName, themeToCssVars, useViewerBuildingBlocks, useViewerTheme, vermilionDarkColors, vermilionDarkTheme, vermilionLightColors, vermilionLightTheme, vermilionRadius, writeStoredViewerPrefs };
-export type { AccountAuthConfig, ElementUpdate, ElementUpdateOptions, LocalStorageUsageSummary, LocaleCatalogEntry, PowerPointViewerAPI, PowerPointViewerHandle, PowerPointViewerProps, PptxAiBridge, PptxAiConfig, PptxAiConnection, PptxAiContextStrategy, PptxAiToolName, PptxAiWritePolicy, SavedPresentationFormat, SlideCanvasProps, SlideTemplateGalleryDialogProps, SlideTemplateId, SlideTemplatePreviewProps, SlideTemplateSpec, StoredViewerPrefs, ThemeCatalogEntry, ToolbarActionId, ToolbarButtonId, ToolbarProps, ToolbarTabId, UseViewerBuildingBlocksInput, ViewerBuildingBlocksResult, ViewerMode, ViewerProfile, ViewerTheme, ViewerThemeColors, ViewportFitOptions, ViewportFitPadding };
+export type { AccountAuthConfig, CollaborationConfig, ElementUpdate, ElementUpdateOptions, ExternalCollaborationAwareness, ExternalCollaborationSession, ExternalCollaborationSnapshot, LocalStorageUsageSummary, LocaleCatalogEntry, PowerPointViewerAPI, PowerPointViewerHandle, PowerPointViewerProps, PptxAiBridge, PptxAiConfig, PptxAiConnection, PptxAiContextStrategy, PptxAiToolName, PptxAiWritePolicy, SavedPresentationFormat, SlideCanvasProps, SlideTemplateGalleryDialogProps, SlideTemplateId, SlideTemplatePreviewProps, SlideTemplateSpec, StoredViewerPrefs, ThemeCatalogEntry, ToolbarActionId, ToolbarButtonId, ToolbarProps, ToolbarTabId, UseViewerBuildingBlocksInput, ViewerBuildingBlocksResult, ViewerMode, ViewerProfile, ViewerTheme, ViewerThemeColors, ViewportFitOptions, ViewportFitPadding };

package/dist/index.js

@@ -1,10 +1,10 @@
 'use strict';
 
-var chunk2BQKGTIF_js = require('./chunk-2BQKGTIF.js');
-require('./chunk-K7TAGREH.js');
-var chunkML4MTTPV_js = require('./chunk-ML4MTTPV.js');
-var chunkU46O2NL5_js = require('./chunk-U46O2NL5.js');
-var chunkHN5QJSVB_js = require('./chunk-HN5QJSVB.js');
+var chunkM6QJKPU2_js = require('./chunk-M6QJKPU2.js');
+require('./chunk-H7QPQ4OR.js');
+var chunkBFPIMU6Q_js = require('./chunk-BFPIMU6Q.js');
+var chunkSUZIFHXI_js = require('./chunk-SUZIFHXI.js');
+var chunkT6V342NP_js = require('./chunk-T6V342NP.js');
 var chunkM24DEOP6_js = require('./chunk-M24DEOP6.js');
 require('./chunk-4VNS5WPM.js');
 
@@ -12,167 +12,167 @@ require('./chunk-4VNS5WPM.js');
 
 Object.defineProperty(exports, "PowerPointViewer", {
   enumerable: true,
-  get: function () { return chunk2BQKGTIF_js.PowerPointViewer; }
+  get: function () { return chunkM6QJKPU2_js.PowerPointViewer; }
 });
 Object.defineProperty(exports, "SlideCanvas", {
   enumerable: true,
-  get: function () { return chunk2BQKGTIF_js.SlideCanvas; }
+  get: function () { return chunkM6QJKPU2_js.SlideCanvas; }
 });
 Object.defineProperty(exports, "SlideTemplateGalleryDialog", {
   enumerable: true,
-  get: function () { return chunk2BQKGTIF_js.SlideTemplateGalleryDialog; }
+  get: function () { return chunkM6QJKPU2_js.SlideTemplateGalleryDialog; }
 });
 Object.defineProperty(exports, "SlideTemplatePreview", {
   enumerable: true,
-  get: function () { return chunk2BQKGTIF_js.SlideTemplatePreview; }
+  get: function () { return chunkM6QJKPU2_js.SlideTemplatePreview; }
 });
 Object.defineProperty(exports, "Toolbar", {
   enumerable: true,
-  get: function () { return chunk2BQKGTIF_js.Toolbar; }
+  get: function () { return chunkM6QJKPU2_js.Toolbar; }
 });
 Object.defineProperty(exports, "ViewerThemeProvider", {
   enumerable: true,
-  get: function () { return chunk2BQKGTIF_js.ViewerThemeProvider; }
+  get: function () { return chunkM6QJKPU2_js.ViewerThemeProvider; }
 });
 Object.defineProperty(exports, "useViewerTheme", {
   enumerable: true,
-  get: function () { return chunk2BQKGTIF_js.useViewerTheme; }
+  get: function () { return chunkM6QJKPU2_js.useViewerTheme; }
 });
 Object.defineProperty(exports, "renderToCanvas", {
   enumerable: true,
-  get: function () { return chunkML4MTTPV_js.renderToCanvas; }
+  get: function () { return chunkBFPIMU6Q_js.renderToCanvas; }
 });
 Object.defineProperty(exports, "useViewerBuildingBlocks", {
   enumerable: true,
-  get: function () { return chunkML4MTTPV_js.useViewerBuildingBlocks; }
+  get: function () { return chunkBFPIMU6Q_js.useViewerBuildingBlocks; }
 });
 Object.defineProperty(exports, "getAnimationInitialStyle", {
   enumerable: true,
-  get: function () { return chunkU46O2NL5_js.getAnimationInitialStyle; }
+  get: function () { return chunkSUZIFHXI_js.getAnimationInitialStyle; }
 });
 Object.defineProperty(exports, "AVATAR_COLOR_SWATCHES", {
   enumerable: true,
-  get: function () { return chunkHN5QJSVB_js.AVATAR_COLOR_SWATCHES; }
+  get: function () { return chunkT6V342NP_js.AVATAR_COLOR_SWATCHES; }
 });
 Object.defineProperty(exports, "DEFAULT_VIEWER_PROFILE", {
   enumerable: true,
-  get: function () { return chunkHN5QJSVB_js.DEFAULT_VIEWER_PROFILE; }
+  get: function () { return chunkT6V342NP_js.DEFAULT_VIEWER_PROFILE; }
 });
 Object.defineProperty(exports, "PPTX_OPEN_ACCEPT", {
   enumerable: true,
-  get: function () { return chunkHN5QJSVB_js.PPTX_OPEN_ACCEPT; }
+  get: function () { return chunkT6V342NP_js.PPTX_OPEN_ACCEPT; }
 });
 Object.defineProperty(exports, "PRESENTATION_OPEN_EXTENSIONS", {
   enumerable: true,
-  get: function () { return chunkHN5QJSVB_js.PRESENTATION_OPEN_EXTENSIONS; }
+  get: function () { return chunkT6V342NP_js.PRESENTATION_OPEN_EXTENSIONS; }
 });
 Object.defineProperty(exports, "SLIDE_TEMPLATES", {
   enumerable: true,
-  get: function () { return chunkHN5QJSVB_js.SLIDE_TEMPLATES; }
+  get: function () { return chunkT6V342NP_js.SLIDE_TEMPLATES; }
 });
 Object.defineProperty(exports, "THEME_CATALOG", {
   enumerable: true,
-  get: function () { return chunkHN5QJSVB_js.THEME_CATALOG; }
+  get: function () { return chunkT6V342NP_js.THEME_CATALOG; }
 });
 Object.defineProperty(exports, "VIEWER_PREFS_STORAGE_KEY", {
   enumerable: true,
-  get: function () { return chunkHN5QJSVB_js.VIEWER_PREFS_STORAGE_KEY; }
+  get: function () { return chunkT6V342NP_js.VIEWER_PREFS_STORAGE_KEY; }
 });
 Object.defineProperty(exports, "buildSlideTemplateContent", {
   enumerable: true,
-  get: function () { return chunkHN5QJSVB_js.buildSlideTemplateContent; }
+  get: function () { return chunkT6V342NP_js.buildSlideTemplateContent; }
 });
 Object.defineProperty(exports, "buildSlideTemplateSlide", {
   enumerable: true,
-  get: function () { return chunkHN5QJSVB_js.buildSlideTemplateSlide; }
+  get: function () { return chunkT6V342NP_js.buildSlideTemplateSlide; }
 });
 Object.defineProperty(exports, "clearAllLocalViewerData", {
   enumerable: true,
-  get: function () { return chunkHN5QJSVB_js.clearAllLocalViewerData; }
+  get: function () { return chunkT6V342NP_js.clearAllLocalViewerData; }
 });
 Object.defineProperty(exports, "clearStoredViewerPrefs", {
   enumerable: true,
-  get: function () { return chunkHN5QJSVB_js.clearStoredViewerPrefs; }
+  get: function () { return chunkT6V342NP_js.clearStoredViewerPrefs; }
 });
 Object.defineProperty(exports, "createImageElementFromFile", {
   enumerable: true,
-  get: function () { return chunkHN5QJSVB_js.createImageElementFromFile; }
+  get: function () { return chunkT6V342NP_js.createImageElementFromFile; }
 });
 Object.defineProperty(exports, "defaultCssVars", {
   enumerable: true,
-  get: function () { return chunkHN5QJSVB_js.defaultCssVars; }
+  get: function () { return chunkT6V342NP_js.defaultCssVars; }
 });
 Object.defineProperty(exports, "defaultRadius", {
   enumerable: true,
-  get: function () { return chunkHN5QJSVB_js.defaultRadius; }
+  get: function () { return chunkT6V342NP_js.defaultRadius; }
 });
 Object.defineProperty(exports, "defaultThemeColors", {
   enumerable: true,
-  get: function () { return chunkHN5QJSVB_js.defaultThemeColors; }
+  get: function () { return chunkT6V342NP_js.defaultThemeColors; }
 });
 Object.defineProperty(exports, "getLocalStorageUsageSummary", {
   enumerable: true,
-  get: function () { return chunkHN5QJSVB_js.getLocalStorageUsageSummary; }
+  get: function () { return chunkT6V342NP_js.getLocalStorageUsageSummary; }
 });
 Object.defineProperty(exports, "isLegacyBinaryPresentation", {
   enumerable: true,
-  get: function () { return chunkHN5QJSVB_js.isLegacyBinaryPresentation; }
+  get: function () { return chunkT6V342NP_js.isLegacyBinaryPresentation; }
 });
 Object.defineProperty(exports, "isSupportedPresentationFile", {
   enumerable: true,
-  get: function () { return chunkHN5QJSVB_js.isSupportedPresentationFile; }
+  get: function () { return chunkT6V342NP_js.isSupportedPresentationFile; }
 });
 Object.defineProperty(exports, "presentationBaseName", {
   enumerable: true,
-  get: function () { return chunkHN5QJSVB_js.presentationBaseName; }
+  get: function () { return chunkT6V342NP_js.presentationBaseName; }
 });
 Object.defineProperty(exports, "readStoredViewerPrefs", {
   enumerable: true,
-  get: function () { return chunkHN5QJSVB_js.readStoredViewerPrefs; }
+  get: function () { return chunkT6V342NP_js.readStoredViewerPrefs; }
 });
 Object.defineProperty(exports, "resolveProfileInitial", {
   enumerable: true,
-  get: function () { return chunkHN5QJSVB_js.resolveProfileInitial; }
+  get: function () { return chunkT6V342NP_js.resolveProfileInitial; }
 });
 Object.defineProperty(exports, "resolveThemeCatalogEntry", {
   enumerable: true,
-  get: function () { return chunkHN5QJSVB_js.resolveThemeCatalogEntry; }
+  get: function () { return chunkT6V342NP_js.resolveThemeCatalogEntry; }
 });
 Object.defineProperty(exports, "saveViewerProfile", {
   enumerable: true,
-  get: function () { return chunkHN5QJSVB_js.saveViewerProfile; }
+  get: function () { return chunkT6V342NP_js.saveViewerProfile; }
 });
 Object.defineProperty(exports, "savedPresentationFileName", {
   enumerable: true,
-  get: function () { return chunkHN5QJSVB_js.savedPresentationFileName; }
+  get: function () { return chunkT6V342NP_js.savedPresentationFileName; }
 });
 Object.defineProperty(exports, "themeToCssVars", {
   enumerable: true,
-  get: function () { return chunkHN5QJSVB_js.themeToCssVars; }
+  get: function () { return chunkT6V342NP_js.themeToCssVars; }
 });
 Object.defineProperty(exports, "vermilionDarkColors", {
   enumerable: true,
-  get: function () { return chunkHN5QJSVB_js.vermilionDarkColors; }
+  get: function () { return chunkT6V342NP_js.vermilionDarkColors; }
 });
 Object.defineProperty(exports, "vermilionDarkTheme", {
   enumerable: true,
-  get: function () { return chunkHN5QJSVB_js.vermilionDarkTheme; }
+  get: function () { return chunkT6V342NP_js.vermilionDarkTheme; }
 });
 Object.defineProperty(exports, "vermilionLightColors", {
   enumerable: true,
-  get: function () { return chunkHN5QJSVB_js.vermilionLightColors; }
+  get: function () { return chunkT6V342NP_js.vermilionLightColors; }
 });
 Object.defineProperty(exports, "vermilionLightTheme", {
   enumerable: true,
-  get: function () { return chunkHN5QJSVB_js.vermilionLightTheme; }
+  get: function () { return chunkT6V342NP_js.vermilionLightTheme; }
 });
 Object.defineProperty(exports, "vermilionRadius", {
   enumerable: true,
-  get: function () { return chunkHN5QJSVB_js.vermilionRadius; }
+  get: function () { return chunkT6V342NP_js.vermilionRadius; }
 });
 Object.defineProperty(exports, "writeStoredViewerPrefs", {
   enumerable: true,
-  get: function () { return chunkHN5QJSVB_js.writeStoredViewerPrefs; }
+  get: function () { return chunkT6V342NP_js.writeStoredViewerPrefs; }
 });
 Object.defineProperty(exports, "LOCALE_CATALOG", {
   enumerable: true,

package/dist/index.mjs

@@ -1,7 +1,7 @@
-export { PowerPointViewer, SlideCanvas, SlideTemplateGalleryDialog, SlideTemplatePreview, Toolbar, ViewerThemeProvider, useViewerTheme } from './chunk-GV6LVDBE.mjs';
-import './chunk-OKIHMWGI.mjs';
-export { renderToCanvas, useViewerBuildingBlocks } from './chunk-JIP6BCRV.mjs';
-export { getAnimationInitialStyle } from './chunk-F65J67TW.mjs';
-export { AVATAR_COLOR_SWATCHES, DEFAULT_VIEWER_PROFILE, PPTX_OPEN_ACCEPT, PRESENTATION_OPEN_EXTENSIONS, SLIDE_TEMPLATES, THEME_CATALOG, VIEWER_PREFS_STORAGE_KEY, buildSlideTemplateContent, buildSlideTemplateSlide, clearAllLocalViewerData, clearStoredViewerPrefs, createImageElementFromFile, defaultCssVars, defaultRadius, defaultThemeColors, getLocalStorageUsageSummary, isLegacyBinaryPresentation, isSupportedPresentationFile, presentationBaseName, readStoredViewerPrefs, resolveProfileInitial, resolveThemeCatalogEntry, saveViewerProfile, savedPresentationFileName, themeToCssVars, vermilionDarkColors, vermilionDarkTheme, vermilionLightColors, vermilionLightTheme, vermilionRadius, writeStoredViewerPrefs } from './chunk-MWNB4BX5.mjs';
+export { PowerPointViewer, SlideCanvas, SlideTemplateGalleryDialog, SlideTemplatePreview, Toolbar, ViewerThemeProvider, useViewerTheme } from './chunk-EJMDD4VV.mjs';
+import './chunk-TOOKJUPG.mjs';
+export { renderToCanvas, useViewerBuildingBlocks } from './chunk-BXMPXKV5.mjs';
+export { getAnimationInitialStyle } from './chunk-HZEOZUUH.mjs';
+export { AVATAR_COLOR_SWATCHES, DEFAULT_VIEWER_PROFILE, PPTX_OPEN_ACCEPT, PRESENTATION_OPEN_EXTENSIONS, SLIDE_TEMPLATES, THEME_CATALOG, VIEWER_PREFS_STORAGE_KEY, buildSlideTemplateContent, buildSlideTemplateSlide, clearAllLocalViewerData, clearStoredViewerPrefs, createImageElementFromFile, defaultCssVars, defaultRadius, defaultThemeColors, getLocalStorageUsageSummary, isLegacyBinaryPresentation, isSupportedPresentationFile, presentationBaseName, readStoredViewerPrefs, resolveProfileInitial, resolveThemeCatalogEntry, saveViewerProfile, savedPresentationFileName, themeToCssVars, vermilionDarkColors, vermilionDarkTheme, vermilionLightColors, vermilionLightTheme, vermilionRadius, writeStoredViewerPrefs } from './chunk-TMTQJAGK.mjs';
 export { LOCALE_CATALOG } from './chunk-R664EPDC.mjs';
 import './chunk-XGB3TDIC.mjs';

package/dist/internals.d.ts

@@ -11489,6 +11489,61 @@ interface TextStyleAnimationDescriptor {
   color?: string;
 }
 
+//#region src/render/collaboration-presence.d.ts
+/** Connection lifecycle states for the Yjs WebSocket provider. */
+type ConnectionStatus$1 = 'disconnected' | 'connecting' | 'connected' | 'error';
+//#endregion
+//#region src/render/collaboration-presence-publisher.d.ts
+/**
+ * Structural interface for the lazily-imported Yjs awareness surface. Every
+ * binding's live `y-protocols/awareness` `Awareness` instance satisfies this.
+ */
+interface AwarenessLike {
+  clientID?: number;
+  setLocalStateField: (field: string, value: unknown) => void;
+  getStates: () => Map<number, Record<string, unknown>>;
+  on: (event: string, cb: () => void) => void;
+  off?: (event: string, cb: () => void) => void;
+}
+//#endregion
+//#region src/render/collaboration-external-session.d.ts
+/** Connection state reported by the host, independent of the viewer lifetime. */
+interface ExternalCollaborationSnapshot {
+  status: ConnectionStatus$1;
+  /**
+   * The host has loaded the authoritative document and permits local edits.
+   * Keep true while offline to allow ordinary Yjs offline edits, or set false
+   * to suspend writes until a fresh sync. The viewer never infers this from
+   * `status` and never opens it after a timeout.
+   */
+  synced: boolean;
+}
+/** The public y-protocols Awareness surface needed by a borrowed session. */
+interface ExternalCollaborationAwareness extends AwarenessLike {
+  clientID: number;
+  getLocalState: () => Record<string, unknown> | null;
+  setLocalState: (state: Record<string, unknown> | null) => void;
+  off: (event: string, callback: () => void) => void;
+}
+/**
+ * Host-owned Yjs resources. The host creates, connects and destroys them.
+ * Keep this object and its resources stable for a session; report connection
+ * changes through subscribe instead of replacing the collaboration config.
+ */
+interface ExternalCollaborationSession {
+  readonly doc: Doc;
+  /** Awareness must belong to doc. One viewer publishes slide presence at a time. */
+  readonly awareness: ExternalCollaborationAwareness;
+  getSnapshot: () => ExternalCollaborationSnapshot;
+  /** Subscribe to status or synced changes; return an unsubscribe function. */
+  subscribe: (listener: () => void) => () => void;
+}
+/** Listener/publisher view, deliberately excluding host lifecycle methods. */
+interface BorrowedCollaborationAwareness extends AwarenessLike {
+  clientID: number;
+  off: (event: string, callback: () => void) => void;
+}
+//#endregion
 //#region src/render/element-update-batch.d.ts
 /** A shallow property patch for a top-level element on an ordinary slide. */
 interface ElementUpdate {
@@ -11637,11 +11692,18 @@ interface CollaborationConfig {
   roomId: string;
   /**
    * WebSocket server URL for the Yjs provider (e.g. "wss://collab.example.com").
-   * Ignored (may be empty) when `transport` is `'webrtc'`.
+   * Ignored (may be empty) for `externalSession` or when `transport` is `'webrtc'`.
    */
   serverUrl: string;
   /** Transport to use. Defaults to `'websocket'`. */
   transport?: CollaborationTransport;
+  /**
+   * Use the host's document, awareness and transport instead of creating a
+   * provider. Transport, serverUrl, signaling and authToken are ignored. The
+   * viewer only detaches its listeners and presence on stop; it never destroys
+   * these resources. Keep this object stable and report readiness via subscribe.
+   */
+  externalSession?: ExternalCollaborationSession;
   /**
    * WebRTC signaling server URLs (only used when `transport` is `'webrtc'`).
    * Defaults to y-webrtc's built-in public signaling list. Same-browser tabs
@@ -12192,7 +12254,9 @@ interface LiveTextSource {
 }
 interface CollaborationLivePatcher {
   /** Attach a live doc (or `null` to go dormant). Pending patches are dropped. */
-  configure: (doc: YDocLike | null, factories: YjsFactories | null) => void;
+  configure: (doc: YDocLike | null, factories: YjsFactories | null,
+  /** Publish synchronously when the host may revoke write readiness at any time. */
+  immediate?: boolean) => void;
   /** True when a doc + factories are attached, i.e. patches will be written. */
   isActive: () => boolean;
   /** Queue interim geometry for an element. */
@@ -15379,12 +15443,14 @@ interface UseYjsProviderResult {
  *
  * The Yjs packages are dynamically imported so they are fully
  * tree-shaken when collaboration is not enabled.
+ * This low-level hook owns built-in transports only. Use useCollaborativeState
+ * (or the full/headless viewer) to attach a host-owned external session.
  */
-declare function useYjsProvider({ config }: UseYjsProviderInput): UseYjsProviderResult;
+declare function useYjsProvider({ config: inputConfig }: UseYjsProviderInput): UseYjsProviderResult;
 //#endregion
 //#region src/viewer/hooks/collaboration/usePresenceTracking.d.ts
 interface UsePresenceTrackingInput {
-  awareness: Awareness | null;
+  awareness: Awareness | BorrowedCollaborationAwareness | null;
   localClientId: number | null;
   userName: string;
   userColor: string;
@@ -15443,56 +15509,22 @@ declare function useCollaborativeHistory({ localClientId: _localClientId, handle
 //#endregion
 //#region src/viewer/hooks/collaboration/useYjsDocumentSync.d.ts
 interface UseYjsDocumentSyncInput {
-  /** The Yjs document (from useYjsProvider). null when not collaborating. */
   doc: Doc | null;
-  /** Current slides state. */
   slides: PptxSlide[];
-  /** Separated master/layout (template) elements, merged back on write-back. */
   templateElementsBySlideId: Record<string, PptxElement[]>;
-  /** React state setter for slides. */
   setSlides: React.Dispatch<React.SetStateAction<PptxSlide[]>>;
-  /** Whether collaboration is active (status === 'connected'). */
   isConnected: boolean;
-  /**
-   * Whether the provider completed its initial document sync. Local -> doc
-   * writes are gated on this so a late joiner never seeds its bootstrap deck
-   * into a room whose real content has not arrived yet. Defaults to true for
-   * callers that manage sync readiness themselves.
-   */
   isSynced?: boolean;
-  /** Collaboration config (for role and write-back). */
-  config?: Pick<CollaborationConfig, 'role' | 'onWriteBack' | 'writeBackDebounceMs'>;
-  /**
-   * Return the source PPTX bytes for write-back serialization. Only called
-   * when role === 'owner' and onWriteBack is set.
-   */
+  config?: Pick<CollaborationConfig, 'role' | 'onWriteBack' | 'writeBackDebounceMs' | 'externalSession' | 'sessionIntent'>;
   getSourceBytes?: () => Uint8Array | null;
-  /**
-   * Session-level save options (view properties, table styles, tags, deck
-   * properties, ...), built the same way as the Save/Export path
-   * (`buildDeckSaveOptions` in `pptx-viewer-shared`). Without this the
-   * write-back reloaded the source bytes and called `handler.save(slides)`
-   * with NO options, so an owner's write-back file dropped every
-   * session-level edit that lives outside `slides`.
-   */
   getSaveOptions?: () => PptxHandlerSaveOptions;
-  /**
-   * Monotonic counter bumped each time the content-load pipeline finishes
-   * applying a parsed deck to viewer state. A local load that lands while the
-   * shared doc already holds slides (a late joiner's bootstrap deck parsing
-   * after the room state arrived) would silently clobber the synced slides;
-   * each bump re-adopts the doc's slides when the room has content.
-   */
   loadVersion?: number;
-  /**
-   * Why the last content load ran. Only a `bootstrap` deck (the host's
-   * `content`) yields to a room that already holds slides; a file the user
-   * opened mid-session is what they asked for and is published instead
-   * (`shouldRoomSlidesReplaceLoad`).
-   */
   loadOrigin?: CollabLoadOrigin;
+  /** External readiness owns this channel together with full-deck writes. */
+  livePatcher?: CollaborationLivePatcher;
+  onReadOnlyChange?: (readOnly: boolean) => void;
 }
-declare function useYjsDocumentSync({ doc, slides, templateElementsBySlideId, setSlides, isConnected, isSynced, config, getSourceBytes, getSaveOptions, loadVersion, loadOrigin }: UseYjsDocumentSyncInput): void;
+declare function useYjsDocumentSync(input: UseYjsDocumentSyncInput): void;
 //#endregion
 //#region src/viewer/hooks/collaboration/useBroadcastFollower.d.ts
 interface UseBroadcastFollowerInput {