pptx-angular-viewer 2.0.0 → 2.1.0

package/types/pptx-angular-viewer.d.ts

@@ -2911,6 +2911,82 @@ interface YjsFactories {
     createText: () => YTextLike;
 }
 
+/**
+ * collaboration-live-patch-target.ts: locating an element inside the shared
+ * Y.Doc and writing one interim patch into it.
+ *
+ * Split out of `collaboration-live-patch.ts` (which owns the throttled patcher
+ * and the binding-facing helpers) to keep both files inside the repo's 300 LOC
+ * ceiling. This half is pure: given a doc it finds the element's Y.Map through
+ * the existing schema and applies geometry / text, with no timers or state.
+ */
+
+/** Interim geometry for an element mid-gesture. All fields optional. */
+interface LiveGeometryPatch {
+    x?: number;
+    y?: number;
+    width?: number;
+    height?: number;
+    rotation?: number;
+}
+/** The element's pre-edit rich text, used to remap the interim plain text. */
+interface LiveTextSource {
+    textSegments?: TextSegment[];
+    textStyle?: TextStyle;
+}
+
+/**
+ * collaboration-live-patch.ts: interim ("live preview") writes straight into
+ * the shared Y.Doc, bypassing each binding's slides state.
+ *
+ * Why: the editors deliberately keep gestures out of framework state. React's
+ * drag/resize writes `style.left/top/width/height` on the DOM node and only
+ * calls `updateElementById` on pointer-up; every binding's inline text editor
+ * buffers the typed string and only commits it on blur. Because the Y.Doc sync
+ * is driven off the slides state, remote peers saw nothing until the gesture
+ * (or the edit) ended.
+ *
+ * This module patches the element's Y.Map directly, so the host keeps its
+ * per-frame performance design while peers see the move/typing live:
+ *
+ *  - geometry scalars (x / y / width / height / rotation) are set in place
+ *  - text goes through the SAME character-level Y.Text merge the reconcile
+ *    pass uses (`reconcileElementTextBody`), so concurrent typing on one
+ *    element still merges instead of last-write-wins
+ *  - writes are throttled (~1 per 50ms) with a trailing write, plus an
+ *    explicit `flush()` for gesture end
+ *  - every transaction is tagged with LOCAL_SYNC_ORIGIN, exactly like
+ *    `reconcileSlidesInYDoc`, so the local observer skips the echo
+ *
+ * It is a no-op until `configure()` is handed a live doc + factories, so
+ * bindings can call it unconditionally.
+ */
+
+interface CollaborationLivePatcher {
+    /** Attach a live doc (or `null` to go dormant). Pending patches are dropped. */
+    configure: (doc: YDocLike | null, factories: YjsFactories | null) => void;
+    /** True when a doc + factories are attached, i.e. patches will be written. */
+    isActive: () => boolean;
+    /** Queue interim geometry for an element. */
+    patchGeometry: (slideId: string | undefined, elementId: string, geometry: LiveGeometryPatch) => void;
+    /** Queue interim text for an element (remapped over `source`'s segments). */
+    patchText: (slideId: string | undefined, elementId: string, text: string, source?: LiveTextSource) => void;
+    /** Write everything queued right now (call on gesture end / edit commit). */
+    flush: () => void;
+    /** Drop pending work, cancel timers and detach the doc. */
+    dispose: () => void;
+}
+
+interface DepartureChannel {
+    /**
+     * Announce that this client is leaving `roomId`. Synchronous on purpose:
+     * it must survive being called from a `pagehide` handler.
+     */
+    announce: () => void;
+    /** Stop listening and release the channel. */
+    dispose: () => void;
+}
+
 /**
  * slide-compare — pure, framework-agnostic slide-diff engine shared by every
  * binding (React / Vue / Angular).
@@ -5773,9 +5849,16 @@ declare class CollaborationService {
     readonly followedSlideIndex: _angular_core.Signal<number | null>;
     /** Active-slide index of the first `owner` peer (the broadcaster), or null. */
     readonly broadcasterSlideIndex: _angular_core.Signal<number | null>;
+    /**
+     * Interim ("live preview") Y.Doc write channel: publishes in-flight inline
+     * editor text that has not reached the slides state yet, so peers see typing
+     * as it happens instead of on commit. Dormant outside a session.
+     */
+    readonly livePatcher: CollaborationLivePatcher;
     private ydoc;
     private provider;
     private awareness;
+    private departure;
     private selfId;
     private applyingRemote;
     private yFactories;
@@ -5800,6 +5883,14 @@ declare class CollaborationService {
     private lastConfig;
     private lastOptions;
     private localPresence;
+    /**
+     * Reentrancy token for {@link connect}: bumped by every connect() and
+     * disconnect(). A connect() whose token no longer matches after an await was
+     * superseded, so it tears down whatever it just created and leaves the
+     * service state to the newer call (a second provider join on the same room
+     * would otherwise throw inside Yjs and kill the surviving session).
+     */
+    private connectToken;
     private readonly refreshPresence;
     constructor();
     connect(config: CollaborationConfig, options?: ConnectOptions): Promise<void>;
@@ -6253,8 +6344,6 @@ interface BarAction {
     key: NonNullable<MobileBarSheet> | 'insert';
     labelKey: string;
     ariaLabelKey?: string;
-    /** SVG path data for the icon (24 × 24 view-box). */
-    svgPath: string;
     disabled: boolean;
     active: boolean;
     badge?: number;
@@ -6812,6 +6901,7 @@ declare class ViewerCanvasEditingService {
     private readonly editor;
     private readonly dialogs;
     private readonly formatPainter;
+    private readonly collab;
     /** Id of the element being inline text-edited, or null. */
     readonly editingId: _angular_core.WritableSignal<string | null>;
     /** Open editor context-menu position (client coords), or null. */
@@ -6833,6 +6923,16 @@ declare class ViewerCanvasEditingService {
         id: string;
         updates: Partial<TextStyle>;
     }): void;
+    /**
+     * Mirror an in-progress inline edit to collaborators. The typed text only
+     * reaches the editor state (and therefore the Y.Doc reconcile) on commit, so
+     * without this peers saw nothing until the editor blurred. No-op when not
+     * collaborating.
+     */
+    onTextInput(event: {
+        id: string;
+        text: string;
+    }): void;
     /** Commit an inline text edit: replace the element's text (one history entry). */
     onTextCommit(event: {
         id: string;
@@ -6957,6 +7057,14 @@ declare class ViewerCollaborationSessionService {
      */
     private readonly activeSession;
     private host;
+    /**
+     * Last host `collaboration` config handled by {@link syncHostConfig}
+     * (reference-equal dedup). A re-invocation with the same object (e.g. a
+     * spurious effect re-run) must not reconnect: a second provider join on the
+     * same room throws inside Yjs and tears down the live session. Cleared on
+     * the explicit stop paths so stop + restart with the same object works.
+     */
+    private lastSyncedConfig;
     /** Wire the host inputs/outputs (called once from the component constructor). */
     bind(host: CollaborationSessionHost): void;
     private requireHost;
@@ -7444,6 +7552,11 @@ declare class ViewerInspectorPanelService {
     readonly visibleInspectorKind: _angular_core.Signal<InspectorContent>;
     /** Accessible-label translation key for the inspector host, by active content. */
     readonly inspectorLabel: _angular_core.Signal<"" | "pptx.toolbar.comments" | "pptx.accessibility.title" | "pptx.viewer.digitalSignatures" | "pptx.selectionPane.title" | "pptx.inspector.properties">;
+    /**
+     * Dismiss the mobile bottom-sheet inspector (backdrop tap or a past-threshold
+     * swipe-down): hide the host until reopened and clear any explicit tool panel.
+     */
+    dismissMobileInspector(): void;
     /** Toggle a right-docked tool panel (clicking the active one closes it). */
     togglePanel(panel: InspectorToolPanel): void;
     /**
@@ -9397,6 +9510,15 @@ declare class SlideCanvasComponent implements SlideContext {
         id: string;
         text: string;
     }>;
+    /**
+     * Emitted on EVERY keystroke while inline-editing. The commit path stays the
+     * only thing that touches editor state/history; this feeds the collaboration
+     * live preview so peers see typing before the edit commits.
+     */
+    readonly textInput: _angular_core.OutputEmitterRef<{
+        id: string;
+        text: string;
+    }>;
     /** Emitted when an inline edit is cancelled (Escape). */
     readonly textCancel: _angular_core.OutputEmitterRef<void>;
     /** Emitted on Ctrl/Cmd+B/I/U while inline-editing (parity with React/Vue). */
@@ -9542,6 +9664,8 @@ declare class SlideCanvasComponent implements SlideContext {
     private trimTrailingSpaceBeforeCaret;
     /** Toggle bold/italic/underline for the element under inline edit. */
     private emitTextFormat;
+    /** Mirror each keystroke out for the collaboration live preview. */
+    onTextInput(event: Event, id: string): void;
     commitText(event: Event, id: string): void;
     onContextMenu(event: MouseEvent): void;
     onHandlePointerDown(event: PointerEvent, handle: ResizeHandle): void;
@@ -9571,7 +9695,7 @@ declare class SlideCanvasComponent implements SlideContext {
     readonly vRulerTicks: _angular_core.Signal<readonly RulerTick[]>;
     readonly stageStyle: _angular_core.Signal<StyleMap>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<SlideCanvasComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<SlideCanvasComponent, "pptx-slide-canvas", never, { "slide": { "alias": "slide"; "required": false; "isSignal": true; }; "canvasSize": { "alias": "canvasSize"; "required": true; "isSignal": true; }; "mediaDataUrls": { "alias": "mediaDataUrls"; "required": false; "isSignal": true; }; "zoom": { "alias": "zoom"; "required": false; "isSignal": true; }; "editable": { "alias": "editable"; "required": false; "isSignal": true; }; "showGrid": { "alias": "showGrid"; "required": false; "isSignal": true; }; "showRulers": { "alias": "showRulers"; "required": false; "isSignal": true; }; "showGuides": { "alias": "showGuides"; "required": false; "isSignal": true; }; "snapToGrid": { "alias": "snapToGrid"; "required": false; "isSignal": true; }; "snapToShape": { "alias": "snapToShape"; "required": false; "isSignal": true; }; "guideCommand": { "alias": "guideCommand"; "required": false; "isSignal": true; }; "spellCheck": { "alias": "spellCheck"; "required": false; "isSignal": true; }; "snapToGuides": { "alias": "snapToGuides"; "required": false; "isSignal": true; }; "autoFit": { "alias": "autoFit"; "required": false; "isSignal": true; }; "interactive": { "alias": "interactive"; "required": false; "isSignal": true; }; "presenting": { "alias": "presenting"; "required": false; "isSignal": true; }; "selectedIds": { "alias": "selectedIds"; "required": false; "isSignal": true; }; "editingId": { "alias": "editingId"; "required": false; "isSignal": true; }; "editTemplateMode": { "alias": "editTemplateMode"; "required": false; "isSignal": true; }; "templateElements": { "alias": "templateElements"; "required": false; "isSignal": true; }; "aiHighlights": { "alias": "aiHighlights"; "required": false; "isSignal": true; }; "aiActive": { "alias": "aiActive"; "required": false; "isSignal": true; }; "aiActiveSlideIndex": { "alias": "aiActiveSlideIndex"; "required": false; "isSignal": true; }; "aiChangeBatch": { "alias": "aiChangeBatch"; "required": false; "isSignal": true; }; "aiPickMode": { "alias": "aiPickMode"; "required": false; "isSignal": true; }; "drawTool": { "alias": "drawTool"; "required": false; "isSignal": true; }; "drawColor": { "alias": "drawColor"; "required": false; "isSignal": true; }; "drawWidth": { "alias": "drawWidth"; "required": false; "isSignal": true; }; }, { "elementSelect": "elementSelect"; "backgroundClick": "backgroundClick"; "transformStart": "transformStart"; "transformUpdate": "transformUpdate"; "contextMenu": "contextMenu"; "textEditStart": "textEditStart"; "textCommit": "textCommit"; "textCancel": "textCancel"; "textFormat": "textFormat"; "rotateUpdate": "rotateUpdate"; "marqueeSelect": "marqueeSelect"; "inkStrokeComplete": "inkStrokeComplete"; "eraserHit": "eraserHit"; "cellCommit": "cellCommit"; "tableChange": "tableChange"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<SlideCanvasComponent, "pptx-slide-canvas", never, { "slide": { "alias": "slide"; "required": false; "isSignal": true; }; "canvasSize": { "alias": "canvasSize"; "required": true; "isSignal": true; }; "mediaDataUrls": { "alias": "mediaDataUrls"; "required": false; "isSignal": true; }; "zoom": { "alias": "zoom"; "required": false; "isSignal": true; }; "editable": { "alias": "editable"; "required": false; "isSignal": true; }; "showGrid": { "alias": "showGrid"; "required": false; "isSignal": true; }; "showRulers": { "alias": "showRulers"; "required": false; "isSignal": true; }; "showGuides": { "alias": "showGuides"; "required": false; "isSignal": true; }; "snapToGrid": { "alias": "snapToGrid"; "required": false; "isSignal": true; }; "snapToShape": { "alias": "snapToShape"; "required": false; "isSignal": true; }; "guideCommand": { "alias": "guideCommand"; "required": false; "isSignal": true; }; "spellCheck": { "alias": "spellCheck"; "required": false; "isSignal": true; }; "snapToGuides": { "alias": "snapToGuides"; "required": false; "isSignal": true; }; "autoFit": { "alias": "autoFit"; "required": false; "isSignal": true; }; "interactive": { "alias": "interactive"; "required": false; "isSignal": true; }; "presenting": { "alias": "presenting"; "required": false; "isSignal": true; }; "selectedIds": { "alias": "selectedIds"; "required": false; "isSignal": true; }; "editingId": { "alias": "editingId"; "required": false; "isSignal": true; }; "editTemplateMode": { "alias": "editTemplateMode"; "required": false; "isSignal": true; }; "templateElements": { "alias": "templateElements"; "required": false; "isSignal": true; }; "aiHighlights": { "alias": "aiHighlights"; "required": false; "isSignal": true; }; "aiActive": { "alias": "aiActive"; "required": false; "isSignal": true; }; "aiActiveSlideIndex": { "alias": "aiActiveSlideIndex"; "required": false; "isSignal": true; }; "aiChangeBatch": { "alias": "aiChangeBatch"; "required": false; "isSignal": true; }; "aiPickMode": { "alias": "aiPickMode"; "required": false; "isSignal": true; }; "drawTool": { "alias": "drawTool"; "required": false; "isSignal": true; }; "drawColor": { "alias": "drawColor"; "required": false; "isSignal": true; }; "drawWidth": { "alias": "drawWidth"; "required": false; "isSignal": true; }; }, { "elementSelect": "elementSelect"; "backgroundClick": "backgroundClick"; "transformStart": "transformStart"; "transformUpdate": "transformUpdate"; "contextMenu": "contextMenu"; "textEditStart": "textEditStart"; "textCommit": "textCommit"; "textInput": "textInput"; "textCancel": "textCancel"; "textFormat": "textFormat"; "rotateUpdate": "rotateUpdate"; "marqueeSelect": "marqueeSelect"; "inkStrokeComplete": "inkStrokeComplete"; "eraserHit": "eraserHit"; "cellCommit": "cellCommit"; "tableChange": "tableChange"; }, never, never, true, never>;
 }
 
 /**
@@ -12404,13 +12528,15 @@ declare class MobileToolbarComponent {
     readonly undo: _angular_core.OutputEmitterRef<void>;
     /** User tapped Redo. */
     readonly redo: _angular_core.OutputEmitterRef<void>;
+    /** User tapped Share (opens the collaboration share dialog). */
+    readonly share: _angular_core.OutputEmitterRef<void>;
     /** User tapped Save (download as .pptx). */
     readonly save: _angular_core.OutputEmitterRef<void>;
     /** User tapped Present. */
     readonly present: _angular_core.OutputEmitterRef<void>;
     protected readonly toolbar: ToolbarVisibility;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<MobileToolbarComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<MobileToolbarComponent, "pptx-mobile-toolbar", never, { "canUndo": { "alias": "canUndo"; "required": false; "isSignal": true; }; "canRedo": { "alias": "canRedo"; "required": false; "isSignal": true; }; "canPresent": { "alias": "canPresent"; "required": false; "isSignal": true; }; "canEdit": { "alias": "canEdit"; "required": false; "isSignal": true; }; "menuOpen": { "alias": "menuOpen"; "required": false; "isSignal": true; }; "aiEnabled": { "alias": "aiEnabled"; "required": false; "isSignal": true; }; "aiPanelOpen": { "alias": "aiPanelOpen"; "required": false; "isSignal": true; }; "hiddenActions": { "alias": "hiddenActions"; "required": false; "isSignal": true; }; }, { "toggleMenu": "toggleMenu"; "toggleAiPanel": "toggleAiPanel"; "undo": "undo"; "redo": "redo"; "save": "save"; "present": "present"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<MobileToolbarComponent, "pptx-mobile-toolbar", never, { "canUndo": { "alias": "canUndo"; "required": false; "isSignal": true; }; "canRedo": { "alias": "canRedo"; "required": false; "isSignal": true; }; "canPresent": { "alias": "canPresent"; "required": false; "isSignal": true; }; "canEdit": { "alias": "canEdit"; "required": false; "isSignal": true; }; "menuOpen": { "alias": "menuOpen"; "required": false; "isSignal": true; }; "aiEnabled": { "alias": "aiEnabled"; "required": false; "isSignal": true; }; "aiPanelOpen": { "alias": "aiPanelOpen"; "required": false; "isSignal": true; }; "hiddenActions": { "alias": "hiddenActions"; "required": false; "isSignal": true; }; }, { "toggleMenu": "toggleMenu"; "toggleAiPanel": "toggleAiPanel"; "undo": "undo"; "redo": "redo"; "share": "share"; "save": "save"; "present": "present"; }, never, never, true, never>;
 }
 
 declare class NotesPanelComponent {
@@ -13566,7 +13692,7 @@ declare class SetUpSlideShowDialogComponent {
     readonly close: _angular_core.OutputEmitterRef<void>;
     /** Working copy of the properties; seeded from `properties` on open. */
     readonly draft: _angular_core.WritableSignal<PptxPresentationProperties>;
-    readonly showType: _angular_core.Signal<"kiosk" | "browsed" | "presented">;
+    readonly showType: _angular_core.Signal<"kiosk" | "presented" | "browsed">;
     readonly showSlidesMode: _angular_core.Signal<"range" | "all" | "customShow">;
     constructor();
     /** Merge a partial patch into the current draft. */
@@ -13955,7 +14081,7 @@ declare class AccountPageComponent {
     readonly accountAuth: _angular_core.InputSignal<AccountAuthConfig | undefined>;
     private readonly translate;
     protected readonly swatches: readonly string[];
-    protected readonly version = "1.31.5";
+    protected readonly version = "2.0.1";
     protected readonly profile: _angular_core.WritableSignal<ViewerProfile>;
     protected readonly initial: _angular_core.Signal<string>;
     protected readonly usage: _angular_core.WritableSignal<LocalStorageUsageSummary | null>;
@@ -15960,6 +16086,8 @@ declare function createSwipeDismissDrag(onDismiss: () => void): SwipeDismissDrag
 /** Minimal awareness surface used by the service. */
 interface AwarenessLike {
     clientID?: number;
+    /** Passing `null` withdraws the local presence (see `clearLocalAwareness`). */
+    setLocalState?: (state: null) => void;
     setLocalStateField: (field: string, value: unknown) => void;
     getStates: () => Map<number, Record<string, unknown>>;
     on: (event: string, cb: () => void) => void;
@@ -15986,6 +16114,13 @@ interface ProviderBundle {
     provider: ProviderLike;
     awareness: AwarenessLike;
     factories: YjsFactories;
+    /**
+     * Synchronous "I am leaving" announcement. The provider's own awareness
+     * removal is broadcast a microtask later, which never escapes a document
+     * that is already being destroyed (see the shared collaboration-departure
+     * module), so `disconnect()` announces through this first.
+     */
+    departure: DepartureChannel;
 }
 /** Create a y-websocket transport bundle for `config`. */
 declare function createWebsocketBundle(config: CollaborationConfig): Promise<ProviderBundle>;