pptx-vue-viewer 3.20.1 → 3.21.0

package/CHANGELOG.md

@@ -7,6 +7,23 @@ A release listed with no entries carried no Conventional Commit in this package'
 scope: scripts/release-plan.mjs re-releases a package whenever any of its files
 change, not only on conventional ones.
 
+## [3.20.1](https://github.com/ChristopherVR/pptx-viewer/releases/tag/pptx-vue-viewer@3.20.1) - 2026-09-17
+
+### Bug Fixes
+
+- **i18n:** Translate recording and editor control labels (by @yunfeizhu) ([7be4498](https://github.com/ChristopherVR/pptx-viewer/commit/7be44985707067b5e11fcac257e52186d7159349))
+- **core:** Embed real images in CLI export-md/export-svg output (by @ChristopherVR) ([6617c92](https://github.com/ChristopherVR/pptx-viewer/commit/6617c92a2ee2ea673c35e4a58cc60dc7cc32def5))
+- **shared:** Keep chart axis interval count off a manual plot layout (by @ChristopherVR) ([d39b2b0](https://github.com/ChristopherVR/pptx-viewer/commit/d39b2b06925c8bd02e64b39c8b5b1a4476537010))
+
+### Testing
+
+- **i18n:** Cover translated editor controls across bindings (by @yunfeizhu) ([fe99e2b](https://github.com/ChristopherVR/pptx-viewer/commit/fe99e2b866a66bd3874707ae506416fd03bf8f1e))
+- **core:** Remove duplicate chart-stacked-line-markers manifest entry (by @ChristopherVR) ([5c60b11](https://github.com/ChristopherVR/pptx-viewer/commit/5c60b1170223c3c74bd5815e8ebad28a233656a4))
+
+### Styling
+
+- **vue:** Satisfy oxlint brace requirement on an unbraced if-return (by @ChristopherVR) ([63d54c4](https://github.com/ChristopherVR/pptx-viewer/commit/63d54c418ec269a33d97b4e2229a62bb4281268b))
+
 ## [3.20.0](https://github.com/ChristopherVR/pptx-viewer/releases/tag/pptx-vue-viewer@3.20.0) - 2026-09-17
 
 ### Features

package/dist/{AiChatPanel-CFSAlqJI.cjs → AiChatPanel-C3SFixYS.cjs}

@@ -1,4 +1,4 @@
-const e = require("./useViewerSettingsDialog-uvVI276F.cjs"), t = require("./viewer-0NOwrXnK.cjs");
+const e = require("./useViewerSettingsDialog-0H_Y-M2X.cjs"), t = require("./viewer-DfAhm6nQ.cjs");
 let r = require("vue"), a = require("lucide-vue-next"), n = require("ai");
 var o = /* @__PURE__ */ new Set([
 	"input-available",

package/dist/{AiChatPanel-D6WRGBq-.js → AiChatPanel-YRXQsZFL.js}

@@ -1,5 +1,5 @@
-import { Zn as e } from "./useViewerSettingsDialog-B6nsrIpR.js";
-import { S as t, T as a, _ as s, b as r, d as l, f as o, g as n, h as i, m as p, o as d, p as c, u, v as m, x, y as g } from "./viewer-m9_VJVCG.js";
+import { Zn as e } from "./useViewerSettingsDialog-DC5oTNB9.js";
+import { S as t, T as a, _ as s, b as r, d as l, f as o, g as n, h as i, m as p, o as d, p as c, u, v as m, x, y as g } from "./viewer-DD0gCFhg.js";
 import { Fragment as f, Suspense as b, computed as v, createBlock as h, createCommentVNode as y, createElementBlock as k, createElementVNode as w, createTextVNode as C, createVNode as P, defineComponent as S, nextTick as T, normalizeClass as I, normalizeStyle as j, onBeforeUnmount as _, onMounted as A, openBlock as E, ref as M, renderList as F, resolveDynamicComponent as B, shallowRef as D, toDisplayString as N, unref as L, vModelText as R, watch as H, withAsyncContext as W, withCtx as z, withDirectives as V } from "vue";
 import { Bot as K, ChartColumn as O, Check as U, Crosshair as Z, Eye as $, Film as q, GitMerge as G, History as J, LayoutTemplate as Q, LoaderCircle as X, MessageSquare as Y, MessageSquarePlus as ee, Move as te, Navigation as ae, Palette as se, Pin as re, PinOff as le, Plus as oe, Search as ne, Send as ie, Shapes as pe, Sparkles as de, Square as ce, StickyNote as ue, Table as me, Trash2 as xe, TriangleAlert as ge, Type as fe, User as be, Wrench as ve, X as he } from "lucide-vue-next";
 import { getToolOrDynamicToolName as ye, isDynamicToolUIPart as ke, isToolUIPart as we } from "ai";

package/dist/gif-encoder-B-tt5tMj.js

@@ -0,0 +1,2 @@
+import { bc as e } from "./useViewerSettingsDialog-DC5oTNB9.js";
+export { e as encodeGif };

package/dist/gif-encoder-B-tt5tMj.js.br

@@ -0,0 +1,3 @@
+�-�import { bc as e } from "./useViewerSettingsDialog-DC5oTNB9.js";
+export { e as encodeGif };
+

package/dist/gif-encoder-BsQ4Gn3G.cjs

@@ -0,0 +1,2 @@
+const e = require("./useViewerSettingsDialog-0H_Y-M2X.cjs");
+exports.encodeGif = e.encodeGif;

package/dist/index.cjs

@@ -1,3 +1,3 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const e = require("./useViewerSettingsDialog-uvVI276F.cjs"), o = require("./viewer-0NOwrXnK.cjs");
+const e = require("./useViewerSettingsDialog-0H_Y-M2X.cjs"), o = require("./viewer-DfAhm6nQ.cjs");
 exports.AUDIENCE_HASH = e.AUDIENCE_HASH, exports.CollaborationCursors = o.CollaborationCursors_default, exports.CollaborationStatusIndicator = o.CollaborationStatusIndicator_default, exports.ElementRenderer = e.ElementRenderer_default, exports.FollowModeBar = o.FollowModeBar_default, exports.PPTX_OPEN_ACCEPT = e.PPTX_OPEN_ACCEPT, exports.PRESENTATION_OPEN_EXTENSIONS = e.PRESENTATION_OPEN_EXTENSIONS, exports.PowerPointViewer = o.PowerPointViewer_default, exports.RemoteSelectionOverlay = o.RemoteSelectionOverlay_default, exports.RibbonToolbar = o.RibbonToolbar_default, exports.SlideCanvas = o.SlideCanvas_default, exports.SlideStage = e.SlideStage_default, exports.clearAudienceContent = e.clearAudienceContent, exports.cn = o.cn, exports.createImageElementFromFile = e.createImageElementFromFile, exports.defaultCssVars = e.defaultCssVars, exports.defaultRadius = e.defaultRadius, exports.defaultThemeColors = e.defaultThemeColors, exports.exportAllSlidesToSvg = e.exportAllSlidesToSvg, exports.exportAllSlidesToSvgBlobs = e.exportAllSlidesToSvgBlobs, exports.exportSlideToSvg = e.exportSlideToSvg, exports.exportSlideToSvgBlob = e.exportSlideToSvgBlob, exports.forgetSessionDeck = e.forgetSessionDeck, exports.getSessionTabId = e.getSessionTabId, exports.isAudienceTab = e.isAudienceTab, exports.isLegacyBinaryPresentation = e.isLegacyBinaryPresentation, exports.isSupportedPresentationFile = e.isSupportedPresentationFile, exports.loadAudienceContent = e.loadAudienceContent, exports.loadSessionDeck = e.loadSessionDeck, exports.parseAudienceNonce = e.parseAudienceNonce, exports.parsePresentationSessionId = e.parsePresentationSessionId, exports.presentationBaseName = e.presentationBaseName, exports.provideViewerTheme = o.provideViewerTheme, exports.rememberSessionDeck = e.rememberSessionDeck, exports.renderToCanvas = e.renderToCanvas, exports.restoreSessionDeck = e.restoreSessionDeck, exports.savedPresentationFileName = e.savedPresentationFileName, exports.storeAudienceContent = e.storeAudienceContent, exports.themeToCssVars = e.themeToCssVars, exports.useCollaboration = e.useCollaboration, exports.useCollaborativeHistory = o.useCollaborativeHistory, exports.useCollaborativeState = o.useCollaborativeState, exports.usePresenceTracking = o.usePresenceTracking, exports.useThemeStyle = o.useThemeStyle, exports.useViewerTheme = o.useViewerTheme, exports.useYjsProvider = o.useYjsProvider, exports.vermilionDarkColors = e.vermilionDarkColors, exports.vermilionDarkTheme = e.vermilionDarkTheme, exports.vermilionLightColors = e.vermilionLightColors, exports.vermilionLightTheme = e.vermilionLightTheme, exports.vermilionRadius = e.vermilionRadius;

package/dist/index.d.ts

@@ -5,6 +5,7 @@ import { ComponentProvideOptions } from 'vue';
 import { ComputedRef } from 'vue';
 import { CSSProperties } from 'vue';
 import { DefineComponent } from 'vue';
+import { Doc } from 'yjs';
 import { LanguageModel } from 'ai';
 import { MaybeRefOrGetter } from 'vue';
 import { Options } from 'html2canvas-pro';
@@ -498,6 +499,18 @@ declare interface AnimationInput {
 /** URL hash that marks the current tab as the audience display. */
 export declare const AUDIENCE_HASH = "#pptx-audience";
 
+/**
+ * Structural interface for the lazily-imported Yjs awareness surface. Every
+ * binding's live `y-protocols/awareness` `Awareness` instance satisfies this.
+ */
+declare 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;
+}
+
 declare type BackgroundInput = {
     type: 'solid';
     color: string;
@@ -738,11 +751,18 @@ export declare 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
@@ -788,7 +808,9 @@ export declare const CollaborationCursors: typeof __VLS_export_6;
 
 declare 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. */
@@ -1296,6 +1318,40 @@ export declare function exportSlideToSvg(slide: PptxSlide, width: number, height
 /** Export one parsed slide as an SVG Blob. */
 export declare function exportSlideToSvgBlob(slide: PptxSlide, width: number, height: number, options?: SvgExportSingleSlideOptions): Blob;
 
+/** The public y-protocols Awareness surface needed by a borrowed session. */
+export declare 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.
+ */
+export declare 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;
+}
+
+/** Connection state reported by the host, independent of the viewer lifetime. */
+export declare 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;
+}
+
 declare type FillInput = {
     type: 'solid';
     color: string;
@@ -13476,6 +13532,8 @@ export declare interface UseCollaborationResult {
     remotePresences: Ref<RemotePresence[]>;
     connectedCount: ComputedRef<number>;
     active: Ref<boolean>;
+    /** Blocks edits only while a session is read-only or awaiting host sync. */
+    readOnly: Ref<boolean>;
     /** The local user's role in the active session (undefined when stopped). */
     activeRole: Ref<CollaborationRole | undefined>;
     followedClientId: Ref<number | null>;

package/dist/index.js

@@ -1,3 +1,3 @@
-import { $s as a, Bl as s, Bu as e, C as o, Cp as r, Dp as l, Ep as i, H as t, Mc as n, Ql as p, S as w, Tp as d, Ul as u, Vs as C, Xs as S, Xt as b, Yt as m, Zf as c, Zl as f, Zs as v, _f as g, as as B, bi as D, cp as E, df as R, it as T, kl as V, nr as Z, qu as j, ul as k, vd as x, w as M, wi as O, wp as P, x as X, zu as q } from "./useViewerSettingsDialog-B6nsrIpR.js";
-import { C as y, D as z, E as F, O as H, T as I, a as Q, c as U, i as Y, k as $, l as _, n as h, r as A, s as G, t as J, w as K } from "./viewer-m9_VJVCG.js";
+import { $s as a, Bl as s, Bu as e, C as o, Cp as r, Dp as l, Ep as i, H as t, Mc as n, Ql as p, S as w, Tp as d, Ul as u, Vs as C, Xs as S, Xt as b, Yt as m, Zf as c, Zl as f, Zs as v, _f as g, as as B, bi as D, cp as E, df as R, it as T, kl as V, nr as Z, qu as j, ul as k, vd as x, w as M, wi as O, wp as P, x as X, zu as q } from "./useViewerSettingsDialog-DC5oTNB9.js";
+import { C as y, D as z, E as F, O as H, T as I, a as Q, c as U, i as Y, k as $, l as _, n as h, r as A, s as G, t as J, w as K } from "./viewer-DD0gCFhg.js";
 export { Z as AUDIENCE_HASH, _ as CollaborationCursors, F as CollaborationStatusIndicator, b as ElementRenderer, G as FollowModeBar, D as PPTX_OPEN_ACCEPT, O as PRESENTATION_OPEN_EXTENSIONS, Q as PowerPointViewer, U as RemoteSelectionOverlay, K as RibbonToolbar, y as SlideCanvas, m as SlideStage, B as clearAudienceContent, I as cn, C as createImageElementFromFile, S as defaultCssVars, v as defaultRadius, a as defaultThemeColors, X as exportAllSlidesToSvg, w as exportAllSlidesToSvgBlobs, o as exportSlideToSvg, M as exportSlideToSvgBlob, n as forgetSessionDeck, k as getSessionTabId, V as isAudienceTab, s as isLegacyBinaryPresentation, u as isSupportedPresentationFile, f as loadAudienceContent, p as loadSessionDeck, q as parseAudienceNonce, e as parsePresentationSessionId, j as presentationBaseName, z as provideViewerTheme, x as rememberSessionDeck, t as renderToCanvas, R as restoreSessionDeck, g as savedPresentationFileName, c as storeAudienceContent, E as themeToCssVars, T as useCollaboration, J as useCollaborativeHistory, h as useCollaborativeState, A as usePresenceTracking, H as useThemeStyle, $ as useViewerTheme, Y as useYjsProvider, r as vermilionDarkColors, P as vermilionDarkTheme, d as vermilionLightColors, i as vermilionLightTheme, l as vermilionRadius };

package/dist/internals.cjs

@@ -1,3 +1,3 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const e = require("./useViewerSettingsDialog-uvVI276F.cjs");
+const e = require("./useViewerSettingsDialog-0H_Y-M2X.cjs");
 exports.CINEMATIC_TRANSITION_KEYFRAMES = e.CINEMATIC_TRANSITION_KEYFRAMES, exports.DEFAULT_MAX_VERSIONS = e.DEFAULT_MAX_VERSIONS, exports.DEFAULT_MORPH_DURATION_MS = e.DEFAULT_MORPH_DURATION_MS, exports.DEFAULT_TRANSITION_DURATION_MS = e.DEFAULT_TRANSITION_DURATION_MS, exports.EASE = e.EASE, exports.ERASER_RADIUS = e.ERASER_RADIUS, exports.FragmentedTransitionLayer = e.FragmentedTransitionLayer_default, exports.HIGHLIGHTER_OPACITY = e.HIGHLIGHTER_OPACITY, exports.HIGHLIGHTER_WIDTH = e.HIGHLIGHTER_WIDTH, exports.INSTANT = e.INSTANT, exports.MOBILE_BREAKPOINT = e.MOBILE_BREAKPOINT, exports.MOBILE_LANDSCAPE_MAX_HEIGHT = e.MOBILE_LANDSCAPE_MAX_HEIGHT, exports.MorphExtraLayers = e.MorphExtraLayers_default, exports.NUDGE_LARGE = e.NUDGE_LARGE, exports.NUDGE_SMALL = e.NUDGE_SMALL, exports.P14_TRANSITION_KEYFRAMES = e.P14_TRANSITION_KEYFRAMES, exports.P14_TRANSITION_KEYFRAMES_2 = e.P14_TRANSITION_KEYFRAMES_2, exports.P14_TRANSITION_KEYFRAMES_ALL = e.P14_TRANSITION_KEYFRAMES_ALL, exports.PEN_WIDTH = e.PEN_WIDTH, exports.PresentationTransitionOverlay = e.PresentationTransitionOverlay_default, exports.RANDOM_ELIGIBLE_TYPES = e.RANDOM_ELIGIBLE_TYPES, exports.RIBBON_ALIGN = e.RIBBON_ALIGN, exports.SHORTCUT_CATALOG = e.SHORTCUT_CATALOG, exports.SHORTCUT_GROUP_LABEL_KEYS = e.SHORTCUT_GROUP_LABEL_KEYS, exports.SLIDE_TRANSITION_KEYFRAMES = e.SLIDE_TRANSITION_KEYFRAMES, exports.SLIDE_TRANSITION_KEYFRAMES_CSS = e.SLIDE_TRANSITION_KEYFRAMES_CSS, exports.SMARTART_COLOR_SCHEMES = e.SMARTART_COLOR_SCHEMES, exports.SMARTART_STYLE_OPTIONS = e.SMARTART_STYLE_OPTIONS, exports.SmartArt3DKey = e.SmartArt3DKey, exports.TABLET_BREAKPOINT = e.TABLET_BREAKPOINT, exports.TRANSITION_SPEED_DURATION_MS = e.TRANSITION_SPEED_DURATION_MS, exports.TableSelectionKey = e.TableSelectionKey, exports.WHEEL_SPOKE_COUNTS = e.WHEEL_SPOKE_COUNTS, exports.buildClickGroups = e.buildClickGroups, exports.computeCellSelection = e.computeCellSelection, exports.computeDocumentStatistics = e.computeDocumentStatistics, exports.computeElapsed = e.computeElapsed, exports.countWords = e.countWords, exports.createStroke = e.createStroke, exports.eraseStrokesAtPoint = e.eraseStrokesAtPoint, exports.formatRehearseMs = e.formatRehearseMs, exports.generateCommentId = e.generateCommentId, exports.getCinematicTransitionAnimations = e.getCinematicTransitionAnimations, exports.getP14TransitionAnimations = e.getP14TransitionAnimations, exports.getSlideTransitionAnimations = e.getSlideTransitionAnimations, exports.groupShortcutCatalog = e.groupShortcutCatalog, exports.injectTableSelection = e.injectTableSelection, exports.inlineEditorRect = e.inlineEditorRect, exports.isMobileViewport = e.isMobileViewport, exports.nodeIdsInRenderOrder = e.nodeIdsInRenderOrder, exports.parseSignaturesFromBuffer = e.parseSignaturesFromBuffer, exports.provideTableSelection = e.provideTableSelection, exports.resolveDirection = e.resolveDirection, exports.resolveDirection8 = e.resolveDirection8, exports.resolveOrientation = e.resolveOrientation, exports.resolveShortcutAction = e.resolveShortcutAction, exports.resolveSlideTransition = e.resolveSlideTransition, exports.resolveTransitionDurationMs = e.resolveTransitionDurationMs, exports.resolveWheelSpokeCount = e.resolveWheelSpokeCount, exports.smartArtLayoutLabel = e.smartArtLayoutLabel, exports.textNodeIdsInRenderOrder = e.textNodeIdsInRenderOrder, exports.toShapePreset = e.toShapePreset, exports.useAccessibility = e.useAccessibility, exports.useAlignGroup = e.useAlignGroup, exports.useAnimationPlayback = e.useAnimationPlayback, exports.useAutosave = e.useAutosave, exports.useChartEditing = e.useChartEditing, exports.useCollaboration = e.useCollaboration, exports.useCollaborationWiring = e.useCollaborationWiring, exports.useColorChangeImage = e.useColorChangeImage, exports.useComments = e.useComments, exports.useCommentsWiring = e.useCommentsWiring, exports.useContextMenu = e.useContextMenu, exports.useCustomShows = e.useCustomShows, exports.useCustomShowsWiring = e.useCustomShowsWiring, exports.useDebouncedCallback = e.useDebouncedCallback, exports.useDocumentPropertiesDialog = e.useDocumentPropertiesDialog, exports.useDocumentStatistics = e.useDocumentStatistics, exports.useEditorHistory = e.useEditorHistory, exports.useEditorKeyboard = e.useEditorKeyboard, exports.useEditorOperations = e.useEditorOperations, exports.useElementDrag = e.useElementDrag, exports.useElementInsertion = e.useElementInsertion, exports.useEmbeddedFonts = e.useEmbeddedFonts, exports.useExport = e.useExport, exports.useExportProgress = e.useExportProgress, exports.useExportWiring = e.useExportWiring, exports.useFindReplace = e.useFindReplace, exports.useFontEmbedding = e.useFontEmbedding, exports.useFormatPainter = e.useFormatPainter, exports.useHeaderFooterDialog = e.useHeaderFooterDialog, exports.useInkDrawing = e.useInkDrawing, exports.useInlineEditing = e.useInlineEditing, exports.useInsertElementDialogs = e.useInsertElementDialogs, exports.useIsMobile = e.useIsMobile, exports.useKeyboardInsets = e.useKeyboardInsets, exports.useKeyboardShortcuts = e.useKeyboardShortcuts, exports.useLoadContent = e.useLoadContent, exports.useMasterViewState = e.useMasterViewState, exports.useMediaExport = e.useMediaExport, exports.useMobileChrome = e.useMobileChrome, exports.useModel3dScene = e.useModel3dScene, exports.useMorphTransitionOverlay = e.useMorphTransitionOverlay, exports.useMultiSelectOps = e.useMultiSelectOps, exports.usePasswordProtection = e.usePasswordProtection, exports.usePresentationAnnotations = e.usePresentationAnnotations, exports.usePresentationModeWiring = e.usePresentationModeWiring, exports.usePrint = e.usePrint, exports.useRehearseTimings = e.useRehearseTimings, exports.useRibbonActions = e.useRibbonActions, exports.useRibbonProps = e.useRibbonProps, exports.useRibbonUiState = e.useRibbonUiState, exports.useSectionOperations = e.useSectionOperations, exports.useSelectionPaneWiring = e.useSelectionPaneWiring, exports.useSheetDismissDrag = e.useSheetDismissDrag, exports.useSignatureWorkflow = e.useSignatureWorkflow, exports.useSignatures = e.useSignatures, exports.useSlideMutations = e.useSlideMutations, exports.useSlideOperations = e.useSlideOperations, exports.useSlideShowSettings = e.useSlideShowSettings, exports.useSlideTemplateInsertion = e.useSlideTemplateInsertion, exports.useSmartArt3D = e.useSmartArt3D, exports.useSmartArtEditing = e.useSmartArtEditing, exports.useSmartArtFocus = e.useSmartArtFocus, exports.useSmartArtHoverRect = e.useSmartArtHoverRect, exports.useSmartArtInlineEditState = e.useSmartArtInlineEditState, exports.useSmartArtNodeEditContext = e.useSmartArtNodeEditContext, exports.useTableCellEditingContext = e.useTableCellEditingContext, exports.useTableCellSelection = e.useTableCellSelection, exports.useThemeEditing = e.useThemeEditing, exports.useToolbarAutoHide = e.useToolbarAutoHide, exports.useToolbarVisibility = e.useToolbarVisibility, exports.useTouchGestures = e.useTouchGestures, exports.useVersionHistory = e.useVersionHistory, exports.useVersionHistoryWiring = e.useVersionHistoryWiring, exports.useViewerSettingsDialog = e.useViewerSettingsDialog;

package/dist/internals.d.ts

@@ -3,6 +3,7 @@ import { ComponentProvideOptions } from 'vue';
 import { ComputedRef } from 'vue';
 import { CSSProperties as CSSProperties_2 } from 'vue';
 import { DefineComponent } from 'vue';
+import { Doc } from 'yjs';
 import { InjectionKey } from 'vue';
 import { MaybeRefOrGetter } from 'vue';
 import { PublicProps } from 'vue';
@@ -321,6 +322,18 @@ export declare interface AutosaveTimerApi {
     clearTimer: (id: number) => void;
 }
 
+/**
+ * Structural interface for the lazily-imported Yjs awareness surface. Every
+ * binding's live `y-protocols/awareness` `Awareness` instance satisfies this.
+ */
+declare 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;
+}
+
 declare type BackgroundInput = {
     type: 'solid';
     color: string;
@@ -709,11 +722,18 @@ declare 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
@@ -757,7 +777,9 @@ declare interface CollaborationConfig {
 
 declare 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. */
@@ -1656,6 +1678,40 @@ export declare interface ExportPdfOptions {
 /** Per-slide progress callback: `(currentSlideIndex, totalSlides)`. */
 export declare type ExportProgress = (current: number, total: number) => void;
 
+/** The public y-protocols Awareness surface needed by a borrowed session. */
+declare 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.
+ */
+declare 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;
+}
+
+/** Connection state reported by the host, independent of the viewer lifetime. */
+declare 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;
+}
+
 declare type FeedbackSoundScheme = 'modern' | 'classic';
 
 declare type FillInput = {
@@ -14758,6 +14814,8 @@ export declare interface UseCollaborationResult {
     remotePresences: Ref<RemotePresence[]>;
     connectedCount: ComputedRef<number>;
     active: Ref<boolean>;
+    /** Blocks edits only while a session is read-only or awaiting host sync. */
+    readOnly: Ref<boolean>;
     /** The local user's role in the active session (undefined when stopped). */
     activeRole: Ref<CollaborationRole | undefined>;
     followedClientId: Ref<number | null>;

package/dist/internals.js

@@ -1,2 +1,2 @@
-import { $ as a, $d as s, A as t, B as n, Bt as i, Cs as r, Ct as e, D as o, E as l, F as d, Fi as g, Fn as p, Ft as y, G as c, Hc as f, Ht as m, I as h, In as F, Is as L, It as T, J as u, Jd as w, Ji as x, K as I, Kc as V, L as j, Ld as v, Lt as J, M, Mt as P, N as R, Nt as _, O as b, P as k, Pt as q, Q as z, R as B, Rd as C, Rt as D, St as E, T as H, Tn as K, Tt as N, U as O, Ut as S, V as U, Vl as W, Vt as X, W as Y, Wt as $, X as A, Xn as G, Y as Q, Yi as Z, Z as aa, _ as sa, _i as ta, _t as na, a as ia, ai as ra, at as ea, b as oa, bt as la, c as da, ci as ga, cn as pa, ct as ya, d as ca, do as fa, dt as ma, ei as ha, et as Fa, f as La, fn as Ta, ft as ua, g as wa, gi as xa, gn as Ia, gt as Va, h as ja, hi as va, hn as Ja, ht as Ma, i as Pa, if as Ra, it as _a, j as ba, jt as ka, k as qa, kr as za, l as Ba, li as Ca, ln as Da, lr as Ea, lt as Ha, m as Ka, mn as Na, mt as Oa, n as Sa, na as Ua, nt as Wa, o as Xa, oi as Ya, on as $a, ot as Aa, p as Ga, pl as Qa, pn as Za, pt as as, q as ss, qt as ts, r as ns, rl as is, rt as rs, s as es, sf as os, sn as ls, st as ds, t as gs, tt as ps, u as ys, un as cs, ut as fs, v as ms, vt as hs, wa as Fs, wr as Ls, wt as Ts, xr as us, xt as ws, y as xs, ya as Is, yn as Vs, yt as js, z as vs, zt as Js } from "./useViewerSettingsDialog-B6nsrIpR.js";
+import { $ as a, $d as s, A as t, B as n, Bt as i, Cs as r, Ct as e, D as o, E as l, F as d, Fi as g, Fn as p, Ft as y, G as c, Hc as f, Ht as m, I as h, In as F, Is as L, It as T, J as u, Jd as w, Ji as x, K as I, Kc as V, L as j, Ld as v, Lt as J, M, Mt as P, N as R, Nt as _, O as b, P as k, Pt as q, Q as z, R as B, Rd as C, Rt as D, St as E, T as H, Tn as K, Tt as N, U as O, Ut as S, V as U, Vl as W, Vt as X, W as Y, Wt as $, X as A, Xn as G, Y as Q, Yi as Z, Z as aa, _ as sa, _i as ta, _t as na, a as ia, ai as ra, at as ea, b as oa, bt as la, c as da, ci as ga, cn as pa, ct as ya, d as ca, do as fa, dt as ma, ei as ha, et as Fa, f as La, fn as Ta, ft as ua, g as wa, gi as xa, gn as Ia, gt as Va, h as ja, hi as va, hn as Ja, ht as Ma, i as Pa, if as Ra, it as _a, j as ba, jt as ka, k as qa, kr as za, l as Ba, li as Ca, ln as Da, lr as Ea, lt as Ha, m as Ka, mn as Na, mt as Oa, n as Sa, na as Ua, nt as Wa, o as Xa, oi as Ya, on as $a, ot as Aa, p as Ga, pl as Qa, pn as Za, pt as as, q as ss, qt as ts, r as ns, rl as is, rt as rs, s as es, sf as os, sn as ls, st as ds, t as gs, tt as ps, u as ys, un as cs, ut as fs, v as ms, vt as hs, wa as Fs, wr as Ls, wt as Ts, xr as us, xt as ws, y as xs, ya as Is, yn as Vs, yt as js, z as vs, zt as Js } from "./useViewerSettingsDialog-DC5oTNB9.js";
 export { Ea as CINEMATIC_TRANSITION_KEYFRAMES, Pa as DEFAULT_MAX_VERSIONS, us as DEFAULT_MORPH_DURATION_MS, Ls as DEFAULT_TRANSITION_DURATION_MS, za as EASE, hs as ERASER_RADIUS, Oa as FragmentedTransitionLayer, js as HIGHLIGHTER_OPACITY, la as HIGHLIGHTER_WIDTH, ha as INSTANT, ra as MOBILE_BREAKPOINT, Ya as MOBILE_LANDSCAPE_MAX_HEIGHT, as as MorphExtraLayers, ga as NUDGE_LARGE, Ca as NUDGE_SMALL, va as P14_TRANSITION_KEYFRAMES, xa as P14_TRANSITION_KEYFRAMES_2, ta as P14_TRANSITION_KEYFRAMES_ALL, ws as PEN_WIDTH, ua as PresentationTransitionOverlay, g as RANDOM_ELIGIBLE_TYPES, sa as RIBBON_ALIGN, D as SHORTCUT_CATALOG, Js as SHORTCUT_GROUP_LABEL_KEYS, x as SLIDE_TRANSITION_KEYFRAMES, Z as SLIDE_TRANSITION_KEYFRAMES_CSS, P as SMARTART_COLOR_SCHEMES, _ as SMARTART_STYLE_OPTIONS, p as SmartArt3DKey, Ua as TABLET_BREAKPOINT, Is as TRANSITION_SPEED_DURATION_MS, $a as TableSelectionKey, Fs as WHEEL_SPOKE_COUNTS, fa as buildClickGroups, ls as computeCellSelection, r as computeDocumentStatistics, Ha as computeElapsed, L as countWords, E as createStroke, e as eraseStrokesAtPoint, fs as formatRehearseMs, f as generateCommentId, V as getCinematicTransitionAnimations, is as getP14TransitionAnimations, Qa as getSlideTransitionAnimations, i as groupShortcutCatalog, pa as injectTableSelection, Za as inlineEditorRect, W as isMobileViewport, Na as nodeIdsInRenderOrder, t as parseSignaturesFromBuffer, Da as provideTableSelection, v as resolveDirection, C as resolveDirection8, w as resolveOrientation, X as resolveShortcutAction, s as resolveSlideTransition, Ra as resolveTransitionDurationMs, os as resolveWheelSpokeCount, q as smartArtLayoutLabel, Ja as textNodeIdsInRenderOrder, ms as toShapePreset, ds as useAccessibility, Aa as useAlignGroup, N as useAnimationPlayback, ea as useAutosave, J as useChartEditing, _a as useCollaboration, rs as useCollaborationWiring, K as useColorChangeImage, Wa as useComments, ps as useCommentsWiring, Fa as useContextMenu, a as useCustomShows, z as useCustomShowsWiring, T as useDebouncedCallback, aa as useDocumentPropertiesDialog, S as useDocumentStatistics, A as useEditorHistory, Q as useEditorKeyboard, u as useEditorOperations, ss as useElementDrag, I as useElementInsertion, c as useEmbeddedFonts, Y as useExport, O as useExportProgress, n as useExportWiring, vs as useFindReplace, B as useFontEmbedding, j as useFormatPainter, h as useHeaderFooterDialog, d as useInkDrawing, k as useInlineEditing, R as useInsertElementDialogs, $ as useIsMobile, M as useKeyboardInsets, m as useKeyboardShortcuts, ba as useLoadContent, qa as useMasterViewState, U as useMediaExport, b as useMobileChrome, Vs as useModel3dScene, Ma as useMorphTransitionOverlay, o as useMultiSelectOps, l as usePasswordProtection, Ts as usePresentationAnnotations, H as usePresentationModeWiring, oa as usePrint, ma as useRehearseTimings, xs as useRibbonActions, Sa as useRibbonProps, wa as useRibbonUiState, ja as useSectionOperations, Ka as useSelectionPaneWiring, G as useSheetDismissDrag, Ga as useSignatureWorkflow, ya as useSignatures, La as useSlideMutations, ca as useSlideOperations, ys as useSlideShowSettings, Ba as useSlideTemplateInsertion, F as useSmartArt3D, ka as useSmartArtEditing, y as useSmartArtFocus, Ta as useSmartArtHoverRect, Ia as useSmartArtInlineEditState, da as useSmartArtNodeEditContext, es as useTableCellEditingContext, cs as useTableCellSelection, Xa as useThemeEditing, na as useToolbarAutoHide, ts as useToolbarVisibility, Va as useTouchGestures, ia as useVersionHistory, ns as useVersionHistoryWiring, gs as useViewerSettingsDialog };