pptx-vue-viewer 4.0.0 → 4.1.0

package/dist/index.d.ts

@@ -14,7 +14,10 @@ import { Ref } from 'vue';
 import { ToolSet } from 'ai';
 import { UIMessage } from 'ai';
 
-declare const __VLS_base: DefineComponent<__VLS_Props, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
+declare const __VLS_base: DefineComponent<__VLS_Props, {
+    /** The scaled slide origin, for host pointer-to-slide coordinate conversion. */
+    getStageElement: () => HTMLElement | null;
+}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
     createGuide: (axis: "h" | "v", position: number) => any;
     "update:fitScale": (args_0: number) => any;
 }, string, PublicProps, Readonly<__VLS_Props> & Readonly<{
@@ -320,7 +323,7 @@ declare type __VLS_Props_5 = {
 };
 
 declare type __VLS_Slots = {} & {
-    default?: (props: typeof __VLS_14) => any;
+    default?: (props: typeof __VLS_16) => any;
 };
 
 declare type __VLS_Slots_2 = {} & {
@@ -806,7 +809,13 @@ export declare interface CollaborationConfig {
 
 export declare const CollaborationCursors: typeof __VLS_export_6;
 
+declare interface CollaborationInlineSnapshot extends CollaborationTextSnapshot {
+    readonly inline: InlineTextEditSnapshot;
+}
+
 declare interface CollaborationLivePatcher {
+    /** Bind a mounted native editor; its handle must be disposed on unmount. */
+    beginTextEdit?: (slideId: string | undefined, elementId: string, onChange?: () => void, ownsModel?: (element: PptxElement) => boolean) => CollaborationTextTarget | undefined;
     /** Attach a live doc (or `null` to go dormant). Pending patches are dropped. */
     configure: (doc: YDocLike | null, factories: YjsFactories | null,
     /** Publish synchronously when the host may revoke write readiness at any time. */
@@ -829,8 +838,38 @@ export declare type CollaborationRole = 'owner' | 'collaborator' | 'viewer';
 /** How the local user entered a collaboration session. */
 declare type CollaborationSessionIntent = 'create' | 'join';
 
+export declare interface CollaborationShellState {
+    canEdit: boolean;
+    status: ConnectionStatus;
+    remoteUsers: readonly SanitizedPresence[];
+    connectedCount: number;
+}
+
+declare type CollaborationShellTranslate = (key: string, params?: Record<string, string | number>) => string;
+
 export declare const CollaborationStatusIndicator: typeof __VLS_export_7;
 
+declare interface CollaborationTextSession {
+    applyLocalDelta: (delta: readonly DeltaOp[], edit?: LocalTextEdit) => boolean;
+    readMerged: () => CollaborationTextSnapshot | undefined;
+    adoptMerged: (snapshot: CollaborationTextSnapshot) => boolean;
+    /** Capture an offset in the last painted/local draft, not the newer remote string. */
+    bookmark: (index: number, association: number) => () => number | null;
+    dispose: () => void;
+}
+
+/** Opaque acknowledgement identity for an exact remote snapshot painted by an adapter. */
+declare interface CollaborationTextSnapshot {
+    readonly delta: readonly DeltaOp[];
+}
+
+/** A mounted editor owns this handle, never the document or its provider. */
+declare interface CollaborationTextTarget extends CollaborationTextSession {
+    readMerged: () => CollaborationInlineSnapshot | undefined;
+    /** A bookmark follows character identity rather than a mutable numeric offset. */
+    bookmark: (index: number, association: number) => () => number | null;
+}
+
 /**
  * Collaboration transport.
  *
@@ -863,7 +902,7 @@ declare interface ConnectionSite {
 }
 
 /** Connection lifecycle states for the Yjs WebSocket provider. */
-declare type ConnectionStatus = 'disconnected' | 'connecting' | 'connected' | 'error';
+export declare type ConnectionStatus = 'disconnected' | 'connecting' | 'connected' | 'error';
 
 /**
  * Arrow head types for connector start/end.
@@ -1180,6 +1219,18 @@ declare interface DeltaOp {
     attributes?: Record<string, unknown>;
 }
 
+/**
+ * One-line, localised status for a custom shell's `role="status"` readout.
+ *
+ * Every binding's custom-shell demo renders this same string under the same
+ * `Collaboration status` label, so the framework-neutral e2e helper that
+ * waits for the shell to become editable (`waitForHostEditing`) reads every
+ * binding the same way. Three of five demos once phrased it differently and
+ * the helper silently skipped them; on vanilla, that let a peer double-click
+ * before its edit gate opened.
+ */
+export declare function describeCollaborationShellState(state: Pick<CollaborationShellState, 'canEdit' | 'status' | 'connectedCount'>, translate: CollaborationShellTranslate): string;
+
 /** Active drawing/inking tool. Mirrors React `DrawingTool`. */
 export declare type DrawingTool = 'select' | 'pen' | 'highlighter' | 'eraser' | 'freeform';
 
@@ -1585,6 +1636,13 @@ declare interface InkPptxElement extends PptxElementBase {
     extensionXml?: PptxGraphicFrameExtension[];
 }
 
+/** Current editor payload. Missing segments explicitly denotes plain-text fallback. */
+declare interface InlineTextEditSnapshot {
+    elementId: string;
+    text: string;
+    textSegments?: TextSegment[];
+}
+
 /**
  * Dropdown ids for the insert-chart menu. Distinct from `PptxChartType`
  * because PowerPoint offers Column (vertical) and Bar (horizontal) as two
@@ -1758,6 +1816,14 @@ declare interface LocaleCatalogEntry {
     nativeLabel: string;
 }
 
+declare type LocalTextEdit = LocalTextReplacement | TextSessionCorrespondence;
+
+/** Browser edit range mapped to the editor's pre-input encoded coordinates. */
+declare interface LocalTextReplacement {
+    from: number;
+    to: number;
+}
+
 /**
  * Material preset type tokens from OOXML `a:sp3d/@prstMaterial`.
  *
@@ -11596,6 +11662,24 @@ export declare const RibbonToolbar: typeof __VLS_export_5;
 /** The unit system used for ruler display. */
 declare type RulerUnit = 'inches' | 'centimetres';
 
+/**
+ * Presence data for a remote collaborator, sanitised from the awareness
+ * protocol. Returned by {@link sanitizePresence}; coordinates are in unscaled
+ * slide pixels, clamped to the supplied canvas bounds.
+ */
+export declare interface SanitizedPresence {
+    clientId: number;
+    userName: string;
+    userAvatar?: string;
+    userColor: string;
+    activeSlideIndex: number;
+    cursorX: number;
+    cursorY: number;
+    lastUpdated: string;
+    selectedElementId?: string;
+    role?: CollaborationRole;
+}
+
 /**
  * The name a saved copy should be offered under: the source stem plus the
  * extension of the format actually being written.
@@ -12690,6 +12774,12 @@ declare interface TextOptions extends Partial<ElementPosition> {
 /** 2D linear transform matrix `[a, b, c, d]` for inherited group orientation. */
 declare type TextOrientationMatrix = [number, number, number, number];
 
+declare interface TextPositionCell {
+    index: number;
+    left?: TextPositionCell;
+    right?: TextPositionCell;
+}
+
 /**
  * A text box — a plain rectangle containing text, typically with no
  * visible fill or stroke.
@@ -12834,6 +12924,23 @@ declare interface TextSegmentInput {
     style?: Partial<TextStyleInput>;
 }
 
+/** Desired UTF-16 units mapped to the editor's previously observed identities. */
+declare interface TextSessionCorrespondence {
+    readonly retainedIndices: readonly (number | null)[];
+    /** Old carriers for known paragraph attributes, independently of character identity. */
+    readonly paragraphSources?: readonly (number | null)[];
+}
+
+/** Supplied by the binding's existing Yjs runtime, bound to this exact Y.Text. */
+declare interface TextSessionPositions<Position> {
+    capture: (index: number, association: number) => Position;
+    resolve: (position: Position) => number | null;
+    /** Synchronize tracked positions once per batch, including in-transaction writes. */
+    refresh?: () => boolean | void;
+    /** Release only resources created for this session. */
+    dispose?: () => void;
+}
+
 declare interface TextStyle {
     /**
      * Combined rotation/flip matrix inherited from ancestor groups.
@@ -13445,6 +13552,12 @@ export declare type ToolbarSection = 'file' | 'home' | 'insert' | 'text' | 'arra
 /** A top-level ribbon tab. `record` intentionally shares its id with the quick-access Record button above: both surface the same recording feature, so hiding one hides the other. */
 export declare type ToolbarTabId = 'file' | 'home' | 'insert' | 'draw' | 'design' | 'transitions' | 'animations' | 'slideShow' | 'record' | 'review' | 'view' | 'help';
 
+declare interface TrackedTextPosition {
+    /** Internal identity, shared by snapshots that observed the same character. */
+    readonly cell: TextPositionCell;
+    readonly association: number;
+}
+
 declare interface TransitionInput {
     type: PptxTransitionType;
     duration?: number;
@@ -13483,6 +13596,15 @@ declare interface UnknownPptxElement extends PptxElementBase {
 export declare function useCollaboration(options: UseCollaborationOptions): UseCollaborationResult;
 
 export declare interface UseCollaborationOptions {
+    /** Optional reactive configuration; replacing or clearing it starts or stops the session. */
+    collaboration?: MaybeRefOrGetter<CollaborationConfig | undefined>;
+    /** Host authorization, combined with the session's canonical read-only state. */
+    canEdit?: MaybeRefOrGetter<boolean>;
+    /** Whether an actual source file is still loading or failed to load. */
+    sourcePending?: MaybeRefOrGetter<boolean>;
+    sourceError?: MaybeRefOrGetter<boolean>;
+    /** Optional retained serializer for elected-owner write-back; the scheduler guards stale results. */
+    serialize?: (isCurrent: () => boolean) => Promise<Uint8Array | null> | Uint8Array | null;
     /** The editor's reactive slides ref (broadcast on local change). */
     slides: Ref< PptxSlide[]>;
     /** Called when a remote peer broadcasts a newer slide set. */
@@ -13526,6 +13648,10 @@ export declare interface UseCollaborationOptions {
 }
 
 export declare interface UseCollaborationResult {
+    /** Shared custom-shell permissions, connection status and sanitized presence. */
+    shellState: ComputedRef<CollaborationShellState>;
+    /** The configuration attached by start() or the reactive collaboration option. */
+    activeCollaboration: Ref<CollaborationConfig | null>;
     status: Ref< ConnectionStatus>;
     connected: Ref<boolean>;
     cursors: Ref<RemoteCursor[]>;
@@ -13844,6 +13970,8 @@ declare interface YjsFactories {
     createMap: () => YMapLike;
     createArray: () => YArrayLike;
     createText: () => YTextLike;
+    /** Track character identities using the binding's existing Yjs runtime. */
+    createTextPositions?: (text: YTextEditableLike) => TextSessionPositions<TrackedTextPosition>;
 }
 
 declare interface YMapLike {
@@ -13853,6 +13981,12 @@ declare interface YMapLike {
     forEach: (cb: (value: unknown, key: string) => void) => void;
 }
 
+/** Y.Text surface needed for in-place edits (delete/format on top of insert). */
+declare interface YTextEditableLike extends YTextLike {
+    delete: (index: number, length: number) => void;
+    format: (index: number, length: number, attributes: Record<string, string | null>) => void;
+}
+
 declare interface YTextLike {
     insert: (index: number, text: string, attrs?: Record<string, string>) => void;
     toDelta: () => DeltaOp[];

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-UwmccsEe.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-tvULTmsh.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 };
+import { $l as a, Ap as s, C as e, Dp as o, Gl as r, H as t, Hl as i, Hs as l, Op as n, Pc as p, Qs as w, S, Sd as u, Uu as b, Wu as c, Xt as d, Yt as f, Zs as m, Zu as C, bi as j, ec as g, eu as v, fl as x, fp as H, hf as O, it as P, jl as R, jp as k, kp as A, nr as D, os as T, rc as V, tp as Z, w as h, wi as y, x as B, xf as E } from "./useViewerSettingsDialog-Cgs5nn6a.js";
+import { A as F, C as G, O as I, T as M, a as Q, c as U, i as W, j as X, k as Y, l as $, n as q, r as z, s as J, t as K, w as L } from "./viewer-Bj84aywU.js";
+export { D as AUDIENCE_HASH, $ as CollaborationCursors, I as CollaborationStatusIndicator, d as ElementRenderer, J as FollowModeBar, j as PPTX_OPEN_ACCEPT, y as PRESENTATION_OPEN_EXTENSIONS, Q as PowerPointViewer, U as RemoteSelectionOverlay, L as RibbonToolbar, G as SlideCanvas, f as SlideStage, T as clearAudienceContent, M as cn, l as createImageElementFromFile, m as defaultCssVars, w as defaultRadius, g as defaultThemeColors, V as describeCollaborationShellState, B as exportAllSlidesToSvg, S as exportAllSlidesToSvgBlobs, e as exportSlideToSvg, h as exportSlideToSvgBlob, p as forgetSessionDeck, x as getSessionTabId, R as isAudienceTab, i as isLegacyBinaryPresentation, r as isSupportedPresentationFile, a as loadAudienceContent, v as loadSessionDeck, b as parseAudienceNonce, c as parsePresentationSessionId, C as presentationBaseName, Y as provideViewerTheme, u as rememberSessionDeck, t as renderToCanvas, O as restoreSessionDeck, E as savedPresentationFileName, Z as storeAudienceContent, H as themeToCssVars, P as useCollaboration, K as useCollaborativeHistory, q as useCollaborativeState, z as usePresenceTracking, F as useThemeStyle, X as useViewerTheme, W as useYjsProvider, o as vermilionDarkColors, n as vermilionDarkTheme, A as vermilionLightColors, s as vermilionLightTheme, k as vermilionRadius };

package/dist/internals.cjs

@@ -1,3 +1,3 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const e = require("./useViewerSettingsDialog-DsrqDbBi.cjs");
+const e = require("./useViewerSettingsDialog-w5_IIp3-.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

@@ -775,7 +775,13 @@ declare interface CollaborationConfig {
     writeBackDebounceMs?: number;
 }
 
+declare interface CollaborationInlineSnapshot extends CollaborationTextSnapshot {
+    readonly inline: InlineTextEditSnapshot;
+}
+
 declare interface CollaborationLivePatcher {
+    /** Bind a mounted native editor; its handle must be disposed on unmount. */
+    beginTextEdit?: (slideId: string | undefined, elementId: string, onChange?: () => void, ownsModel?: (element: PptxElement) => boolean) => CollaborationTextTarget | undefined;
     /** Attach a live doc (or `null` to go dormant). Pending patches are dropped. */
     configure: (doc: YDocLike | null, factories: YjsFactories | null,
     /** Publish synchronously when the host may revoke write readiness at any time. */
@@ -798,6 +804,34 @@ declare type CollaborationRole = 'owner' | 'collaborator' | 'viewer';
 /** How the local user entered a collaboration session. */
 declare type CollaborationSessionIntent = 'create' | 'join';
 
+declare interface CollaborationShellState {
+    canEdit: boolean;
+    status: ConnectionStatus;
+    remoteUsers: readonly SanitizedPresence[];
+    connectedCount: number;
+}
+
+declare interface CollaborationTextSession {
+    applyLocalDelta: (delta: readonly DeltaOp[], edit?: LocalTextEdit) => boolean;
+    readMerged: () => CollaborationTextSnapshot | undefined;
+    adoptMerged: (snapshot: CollaborationTextSnapshot) => boolean;
+    /** Capture an offset in the last painted/local draft, not the newer remote string. */
+    bookmark: (index: number, association: number) => () => number | null;
+    dispose: () => void;
+}
+
+/** Opaque acknowledgement identity for an exact remote snapshot painted by an adapter. */
+declare interface CollaborationTextSnapshot {
+    readonly delta: readonly DeltaOp[];
+}
+
+/** A mounted editor owns this handle, never the document or its provider. */
+declare interface CollaborationTextTarget extends CollaborationTextSession {
+    readMerged: () => CollaborationInlineSnapshot | undefined;
+    /** A bookmark follows character identity rather than a mutable numeric offset. */
+    bookmark: (index: number, association: number) => () => number | null;
+}
+
 /**
  * Collaboration transport.
  *
@@ -2297,6 +2331,14 @@ declare interface LiveTextSource {
     textStyle?: TextStyle;
 }
 
+declare type LocalTextEdit = LocalTextReplacement | TextSessionCorrespondence;
+
+/** Browser edit range mapped to the editor's pre-input encoded coordinates. */
+declare interface LocalTextReplacement {
+    from: number;
+    to: number;
+}
+
 /**
  * Active tab within the master view sidebar.
  *
@@ -12209,6 +12251,24 @@ declare interface RunRuby {
 /** A plain CSS style map (keys are CSS properties; binding-agnostic). */
 declare type RunStyle = Record<string, string | number>;
 
+/**
+ * Presence data for a remote collaborator, sanitised from the awareness
+ * protocol. Returned by {@link sanitizePresence}; coordinates are in unscaled
+ * slide pixels, clamped to the supplied canvas bounds.
+ */
+declare interface SanitizedPresence {
+    clientId: number;
+    userName: string;
+    userAvatar?: string;
+    userColor: string;
+    activeSlideIndex: number;
+    cursorX: number;
+    cursorY: number;
+    lastUpdated: string;
+    selectedElementId?: string;
+    role?: CollaborationRole;
+}
+
 /**
  * Full PowerPoint "File > Options" parity model.
  *
@@ -13700,6 +13760,12 @@ declare interface TextOptions extends Partial<ElementPosition> {
 /** 2D linear transform matrix `[a, b, c, d]` for inherited group orientation. */
 declare type TextOrientationMatrix = [number, number, number, number];
 
+declare interface TextPositionCell {
+    index: number;
+    left?: TextPositionCell;
+    right?: TextPositionCell;
+}
+
 /**
  * A text box — a plain rectangle containing text, typically with no
  * visible fill or stroke.
@@ -13844,6 +13910,23 @@ declare interface TextSegmentInput {
     style?: Partial<TextStyleInput>;
 }
 
+/** Desired UTF-16 units mapped to the editor's previously observed identities. */
+declare interface TextSessionCorrespondence {
+    readonly retainedIndices: readonly (number | null)[];
+    /** Old carriers for known paragraph attributes, independently of character identity. */
+    readonly paragraphSources?: readonly (number | null)[];
+}
+
+/** Supplied by the binding's existing Yjs runtime, bound to this exact Y.Text. */
+declare interface TextSessionPositions<Position> {
+    capture: (index: number, association: number) => Position;
+    resolve: (position: Position) => number | null;
+    /** Synchronize tracked positions once per batch, including in-transaction writes. */
+    refresh?: () => boolean | void;
+    /** Release only resources created for this session. */
+    dispose?: () => void;
+}
+
 declare interface TextStyle {
     /**
      * Combined rotation/flip matrix inherited from ancestor groups.
@@ -14468,6 +14551,12 @@ declare interface TouchGestureCallbacks {
     onLongPress?: (clientX: number, clientY: number) => void;
 }
 
+declare interface TrackedTextPosition {
+    /** Internal identity, shared by snapshots that observed the same character. */
+    readonly cell: TextPositionCell;
+    readonly association: number;
+}
+
 /** Geometry patch emitted by the selection overlay during a drag/resize/rotate. */
 export declare interface TransformPayload {
     id: string;
@@ -14765,6 +14854,15 @@ export declare function useChartEditing(element: ComputedRef<ChartPptxElement |
 export declare function useCollaboration(options: UseCollaborationOptions): UseCollaborationResult;
 
 export declare interface UseCollaborationOptions {
+    /** Optional reactive configuration; replacing or clearing it starts or stops the session. */
+    collaboration?: MaybeRefOrGetter<CollaborationConfig | undefined>;
+    /** Host authorization, combined with the session's canonical read-only state. */
+    canEdit?: MaybeRefOrGetter<boolean>;
+    /** Whether an actual source file is still loading or failed to load. */
+    sourcePending?: MaybeRefOrGetter<boolean>;
+    sourceError?: MaybeRefOrGetter<boolean>;
+    /** Optional retained serializer for elected-owner write-back; the scheduler guards stale results. */
+    serialize?: (isCurrent: () => boolean) => Promise<Uint8Array | null> | Uint8Array | null;
     /** The editor's reactive slides ref (broadcast on local change). */
     slides: Ref< PptxSlide[]>;
     /** Called when a remote peer broadcasts a newer slide set. */
@@ -14808,6 +14906,10 @@ export declare interface UseCollaborationOptions {
 }
 
 export declare interface UseCollaborationResult {
+    /** Shared custom-shell permissions, connection status and sanitized presence. */
+    shellState: ComputedRef<CollaborationShellState>;
+    /** The configuration attached by start() or the reactive collaboration option. */
+    activeCollaboration: Ref<CollaborationConfig | null>;
     status: Ref< ConnectionStatus>;
     connected: Ref<boolean>;
     cursors: Ref<RemoteCursor[]>;
@@ -15287,6 +15389,8 @@ export declare interface UseEditorOperationsInput {
 export declare function useElementDrag(input: UseElementDragInput): {
     hasActivePointerInteraction: () => boolean;
     startElementDrag: (id: string, event: PointerEvent, wasSelected: boolean) => void;
+    /** Stop window listeners when a custom shell detaches or becomes read-only. */
+    cancelElementDrag: () => void;
     onTransformStart: (payload?: {
         id: string;
     }) => void;
@@ -15749,6 +15853,8 @@ export declare interface UseInlineEditingInput {
     livePatcher?: () => CollaborationLivePatcher | undefined;
     /** The slide the edited element belongs to (needed by the live channel). */
     activeSlide?: () => PptxSlide | undefined;
+    /** Adopt already-published connected text locally before a host disables editing. */
+    onConnectedSuspend?: (snapshot: InlineTextEditSnapshot) => void;
 }
 
 export declare interface UseInlineEditingResult {
@@ -15758,6 +15864,7 @@ export declare interface UseInlineEditingResult {
     /** Set the in-progress text and mirror it to collaborators. */
     updateInlineText: (text: string, snapshot?: InlineTextEditSnapshot) => void;
     readInlineSnapshot: () => InlineTextEditSnapshot | undefined;
+    isInlineInputPending: () => boolean;
     onListSession: (event: {
         controller: InlineListController;
         active: boolean;
@@ -17698,6 +17805,8 @@ declare interface YjsFactories {
     createMap: () => YMapLike;
     createArray: () => YArrayLike;
     createText: () => YTextLike;
+    /** Track character identities using the binding's existing Yjs runtime. */
+    createTextPositions?: (text: YTextEditableLike) => TextSessionPositions<TrackedTextPosition>;
 }
 
 declare interface YMapLike {
@@ -17707,6 +17816,12 @@ declare interface YMapLike {
     forEach: (cb: (value: unknown, key: string) => void) => void;
 }
 
+/** Y.Text surface needed for in-place edits (delete/format on top of insert). */
+declare interface YTextEditableLike extends YTextLike {
+    delete: (index: number, length: number) => void;
+    format: (index: number, length: number, attributes: Record<string, string | null>) => void;
+}
+
 declare interface YTextLike {
     insert: (index: number, text: string, attrs?: Record<string, string>) => void;
     toDelta: () => DeltaOp[];

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

package/dist/pptx-vue-viewer.css

@@ -479,7 +479,7 @@
 }
 
 
-.pptx-vue-smartart-3d-canvas[data-v-1fe7fa4b] {
+.pptx-vue-smartart-3d-canvas[data-v-57f216fa] {
 	width: 100%;
 	height: 100%;
 	display: block;
@@ -488,7 +488,7 @@
 
 /* Invisible hit-test overlay: fills the canvas area, captures dblclicks.
    opacity:0 makes it invisible while keeping it in the layout + event flow. */
-.pptx-vue-smartart-3d-hittest[data-v-1fe7fa4b] {
+.pptx-vue-smartart-3d-hittest[data-v-57f216fa] {
 	position: absolute;
 	inset: 0;
 	opacity: 0;
@@ -500,11 +500,11 @@
    get pointer-events:auto when editable=true, which is disabled in the wrapper.
    This rule re-enables them so the dblclick target is the <g> element (carrying
    data-node-id) rather than the overlay div, enabling correct node resolution. */
-.pptx-vue-smartart-3d-hittest[data-v-1fe7fa4b] [data-node-id] {
+.pptx-vue-smartart-3d-hittest[data-v-57f216fa] [data-node-id] {
 	pointer-events: auto;
 }
 
-.pptx-vue-smartart-3d-editor[data-v-1fe7fa4b] {
+.pptx-vue-smartart-3d-editor[data-v-57f216fa] {
 	position: absolute;
 	z-index: 20;
 	margin: 0;