pptx-svelte-viewer 0.1.2 → 0.2.0

package/dist/index.d.ts

@@ -1,5 +1,40 @@
 import { Component } from 'svelte';
 
+export declare interface AutosaveRecord {
+    key: string;
+    data: Uint8Array;
+    timestamp: number;
+    size: number;
+}
+
+/**
+ * autosave.svelte.ts: debounced crash-recovery autosave for the Svelte viewer.
+ *
+ * A runes port that fuses the two shared semantics the other bindings use:
+ *  - React's persistence target: each successful save writes the serialized
+ *    `.pptx` bytes to the shared IndexedDB recovery store
+ *    (`saveAutosaveSnapshot`, keyed by `filePath`), so a host can offer
+ *    restore-on-load with `getAutosaveSnapshot` / `listAutosaveSnapshots`
+ *    (both re-exported from this package). This binding does NOT auto-restore;
+ *    matching React/Vue, recovery is a host concern.
+ *  - Vue's debounce-on-edit trigger: an edit marks the document dirty and
+ *    (re)arms a debounce timer instead of polling on a fixed interval.
+ *
+ * The controller registers its own edit-watching `$effect` in the constructor,
+ * so the SFC only has to construct it once during setup and read its reactive
+ * `status` / `isDirty` for the toolbar indicator.
+ */
+/**
+ * Autosave status, surfaced for the toolbar status pill.
+ *
+ *  - `idle`     : nothing has been saved yet (or no edits since mount).
+ *  - `disabled` : autosave is inactive (off, not editable, or no file path).
+ *  - `saving`   : a save is currently in flight.
+ *  - `saved`    : the most recent save succeeded.
+ *  - `error`    : the most recent save threw.
+ */
+export declare type AutosaveStatus = 'idle' | 'disabled' | 'saving' | 'saved' | 'error';
+
 /**
  * Framework-agnostic public types shared by the viewer bindings.
  *
@@ -14,6 +49,69 @@ export declare interface CanvasSize {
     height: number;
 }
 
+/**
+ * Real-time collaboration configuration.
+ *
+ * The same shape is accepted by the React, Vue, and Angular bindings.
+ */
+export declare interface CollaborationConfig {
+    /** Unique identifier for the collaboration room (alphanumeric, hyphens, underscores). */
+    roomId: string;
+    /**
+     * WebSocket server URL for the Yjs provider (e.g. "wss://collab.example.com").
+     * Ignored (may be empty) when `transport` is `'webrtc'`.
+     */
+    serverUrl: string;
+    /** Transport to use. Defaults to `'websocket'`. */
+    transport?: CollaborationTransport;
+    /**
+     * WebRTC signaling server URLs (only used when `transport` is `'webrtc'`).
+     * Defaults to y-webrtc's built-in public signaling list. Same-browser tabs
+     * sync via BroadcastChannel regardless of signaling availability.
+     */
+    signaling?: string[];
+    /** Display name for the local user. */
+    userName: string;
+    /** Avatar URL for the local user (optional). */
+    userAvatar?: string;
+    /** Hex colour for the local user's cursor/presence indicator. */
+    userColor?: string;
+    /** Optional authentication token sent with the WebSocket handshake. */
+    authToken?: string;
+    /** Role in the session; defaults to `'collaborator'`. */
+    role?: CollaborationRole;
+    /**
+     * Elected-writer write-back callback (Area 3 of the C3 hardening plan).
+     *
+     * When the local user has `role: 'owner'`, the binding debounces changes and
+     * serializes the current Y.Doc state to a PPTX byte array, then calls this
+     * callback so the host can persist the snapshot. Only one writer (the owner)
+     * does this; other collaborators never trigger write-back, eliminating the
+     * last-save-wins problem.
+     */
+    onWriteBack?: (bytes: Uint8Array) => void;
+    /**
+     * Debounce delay (ms) between the last Y.Doc change and the write-back
+     * invocation. Defaults to 5000 ms. Set to 0 to write back on every change
+     * (not recommended for large documents).
+     */
+    writeBackDebounceMs?: number;
+}
+
+/** Collaboration role within a session. */
+export declare type CollaborationRole = 'owner' | 'collaborator' | 'viewer';
+
+/**
+ * Collaboration transport.
+ *
+ * - `'websocket'` (default): y-websocket against `serverUrl`.
+ * - `'webrtc'`: y-webrtc peer-to-peer; needs no document server. Peers meet
+ *   through the `signaling` servers (WebRTC signaling only, no document data)
+ *   and same-browser tabs additionally sync via BroadcastChannel even without
+ *   any signaling server, which makes this mode usable from static hosting.
+ */
+export declare type CollaborationTransport = 'websocket' | 'webrtc';
+
 /**
  * Build the complete set of CSS custom properties with all defaults.
  * Useful for generating a full fallback stylesheet.
@@ -32,8 +130,41 @@ export declare const defaultRadius = "0.5rem";
  */
 export declare const defaultThemeColors: ViewerThemeColors;
 
+/**
+ * Delete an autosave snapshot by file path.
+ */
+export declare function deleteAutosaveSnapshot(filePath: string): Promise<boolean>;
+
+/**
+ * Animated-GIF export capture/encode pipeline. All the pure logic is shared:
+ * `planGifFrames` derives the per-slide frame delays (default duration +
+ * per-slide overrides), `clampGifDimensions` bounds the output size, and
+ * `encodeGif` (median-cut quantisation + LZW GIF89a) produces the bytes with
+ * each frame carrying its own plan delay. This module only owns the
+ * DOM-adjacent glue: rasterising each slide via the injected capture callback
+ * and normalising every frame onto a uniform-size canvas before pixel
+ * extraction. Blob download is left to the caller (`ExportController`).
+ */
+/** Options for the animated-GIF export. */
+export declare interface ExportGifOptions {
+    /** Duration each slide is shown, in milliseconds. Default 2000. */
+    slideDurationMs?: number;
+    /** Per-slide duration overrides in milliseconds (index maps to slide index). */
+    slideTimingsMs?: number[];
+    /**
+     * Longest allowed output side in pixels; frames are scaled down
+     * proportionally. Default 960 (GIF encoding cost grows with pixel count:
+     * every pixel is matched against a 256-colour palette per frame).
+     */
+    maxDimension?: number;
+    /** Capture-phase progress callback: `(currentSlide, totalSlides)`. */
+    onProgress?: ExportProgress;
+    /** Abort the export early; checked before each slide capture. */
+    signal?: AbortSignal;
+}
+
 /** Options for the multi-slide PDF export (progress + cooperative cancel). */
-declare interface ExportPdfOptions {
+export declare interface ExportPdfOptions {
     /** Capture-phase progress callback: `(currentSlide, totalSlides)`. */
     onProgress?: ExportProgress;
     /** Abort the export early; the loop checks this between slides. */
@@ -43,6 +174,61 @@ declare interface ExportPdfOptions {
 /** Per-slide progress callback: `(currentSlideIndex, totalSlides)`. */
 declare type ExportProgress = (current: number, total: number) => void;
 
+/**
+ * Video (WebM) export driven by the shared `video-plan` maths: segment timing
+ * comes from `planVideoSegments` (default duration + per-slide overrides +
+ * fps -> frame count), the frame pacing from `fpsToFrameIntervalMs`, and the
+ * recorder MIME type from `pickSupportedMimeType(WEBM_MIME_CANDIDATES)`. This
+ * module owns the browser glue only: rasterise every slide first (capture
+ * phase), then replay each canvas onto a recording canvas whose
+ * `captureStream()` feeds a `MediaRecorder` (recording phase). Mirrors
+ * React's `exportAllSlidesAsVideo`, minus the live-stage slide flipping (the
+ * injected rasteriser renders off-screen instead).
+ */
+/** Options for the WebM video export. */
+export declare interface ExportVideoOptions {
+    /** Duration each slide is shown, in milliseconds. Default 3000. */
+    slideDurationMs?: number;
+    /** Per-slide duration overrides in milliseconds (index maps to slide index). */
+    slideTimingsMs?: number[];
+    /** Recording frame rate. Default 30. */
+    fps?: number;
+    /** Recorder bitrate. Default 5,000,000 (5 Mbps). */
+    videoBitsPerSecond?: number;
+    /** Capture-phase progress callback: `(currentSlide, totalSlides)`. */
+    onProgress?: ExportProgress;
+    /** Recording-phase progress callback: `(currentSlide, totalSlides)`. */
+    onRecordProgress?: ExportProgress;
+    /** Abort the export early; checked between slides and between frames. */
+    signal?: AbortSignal;
+}
+
+/**
+ * Retrieve a single autosave snapshot by file path.
+ * Returns undefined when no snapshot exists.
+ */
+export declare function getAutosaveSnapshot(filePath: string): Promise<AutosaveRecord | undefined>;
+
+/**
+ * Pure handout layout calculations, shared by every binding's print path.
+ *
+ * Handles distributing slides across pages, computing grid dimensions, and
+ * positioning cells within A4 page space. No DOM/framework dependency: callers
+ * render the resulting rectangles however their view layer prefers.
+ */
+/** Supported slides-per-page values. */
+declare type HandoutSlidesPerPage = 1 | 2 | 3 | 4 | 6 | 9;
+
+/**
+ * List all autosave snapshots (without the heavy `data` blob).
+ * Useful for showing a recovery picker on app start.
+ */
+export declare function listAutosaveSnapshots(): Promise<Array<{
+    key: string;
+    timestamp: number;
+    size: number;
+}>>;
+
 /**
  * Explicitly-typed public export of the viewer component.
  *
@@ -87,6 +273,30 @@ export declare interface PowerPointViewerApi {
      * `jspdf` is dynamically imported on first use.
      */
     exportPdf(options?: ExportPdfOptions): Promise<void>;
+    /**
+     * Export every slide as an animated GIF download. Per-slide frame delays
+     * come from the shared frame plan: a default `slideDurationMs` (2000) with
+     * optional per-slide `slideTimingsMs` overrides. Supports `onProgress` and
+     * an `AbortSignal`, like {@link exportPdf}.
+     */
+    exportGif(options?: ExportGifOptions): Promise<void>;
+    /**
+     * Export every slide as a WebM video download (canvas capture stream +
+     * `MediaRecorder`; codec picked from the shared WebM candidates). Timing
+     * follows the shared video plan (`slideDurationMs` default 3000, per-slide
+     * `slideTimingsMs`, `fps` default 30). Supports capture/recording progress
+     * callbacks and an `AbortSignal`.
+     */
+    exportVideo(options?: ExportVideoOptions): Promise<void>;
+    /**
+     * Assemble the shared print document (slides / handouts / notes / outline,
+     * slide range + colour mode) and open the browser print dialog. The default
+     * print surface is a hidden same-origin iframe, so no popup window is
+     * involved; a custom `window.open`-based opener (injectable at the
+     * controller level) is subject to popup blockers, in which case the promise
+     * resolves `false`. Resolves `true` once the print surface opened.
+     */
+    print(options?: PrintOptions): Promise<boolean>;
 }
 
 /** Props for `<PowerPointViewer>`. */
@@ -151,8 +361,101 @@ export declare interface PowerPointViewerProps {
      * to track the dirty state or mirror edits into host state.
      */
     onchange?: () => void;
+    /**
+     * Enable debounced crash-recovery autosave. On each edit (when `editable`)
+     * the current slides are serialized to `.pptx` bytes and written to the
+     * shared IndexedDB recovery store (keyed by {@link filePath}), and
+     * `onautosave` is fired with the bytes. Requires `filePath`; without one the
+     * autosave indicator reads "disabled". This binding does not auto-restore on
+     * load; recovery is a host concern (see the re-exported `getAutosaveSnapshot`
+     * / `listAutosaveSnapshots` helpers). Default false.
+     */
+    autosave?: boolean;
+    /**
+     * IndexedDB record key for autosave (typically the open file's name/path).
+     * Autosave is inert until this is set.
+     */
+    filePath?: string;
+    /** Autosave debounce window in milliseconds. Default 2000. */
+    autosaveIntervalMs?: number;
+    /** Fired with the serialized `.pptx` bytes after each successful autosave. */
+    onautosave?: (bytes: Uint8Array) => void;
+    /**
+     * Real-time collaboration configuration. When provided, the viewer connects
+     * to the room (y-websocket or serverless y-webrtc), publishes local edits
+     * granularly, and applies remote peers' edits into the editable slides.
+     * Clearing it (undefined) tears the session down. A `viewer` role makes the
+     * local user read-only. Remote presence/cursors are not rendered by this
+     * binding (descoped); see `collab/collaboration.svelte.ts`.
+     */
+    collaboration?: CollaborationConfig;
+    /** Fired when a collaboration session starts (with the resolved config). */
+    onstartcollaboration?: (config: CollaborationConfig) => void;
+    /** Fired when a collaboration session stops. */
+    onstopcollaboration?: () => void;
 }
 
+/** Colour mode for the printed output. */
+declare type PrintColorMode = 'color' | 'grayscale' | 'blackAndWhite';
+
+/**
+ * Print flow: assemble the shared print document (slides / notes / handouts /
+ * outline) and hand it to a print surface. All the pure logic is shared and
+ * DOMPurify-hardened: `validatePrintSettings` normalises the caller's partial
+ * settings, `computeSlideIndices` / `computeColorFilter` resolve the range and
+ * colour mode, the `build*Html` helpers produce the escaped body markup, and
+ * `buildPrintHtmlDocument` sanitises + assembles the final document. This
+ * module (the Svelte counterpart of Vue's `usePrint`) only rasterises the
+ * selected slides and opens the print surface.
+ *
+ * **Print surface / popup-blocker caveats:** the default opener renders the
+ * document into a hidden same-origin `<iframe srcdoc>` and calls
+ * `contentWindow.print()`, so no popup window is involved and popup blockers
+ * cannot interfere (`document.write` is avoided too). A host that prefers a
+ * visible print window can inject its own {@link OpenPrintWindow} via the
+ * controller deps; note that a `window.open`-based opener only succeeds inside
+ * a user gesture (a click handler) and returns `null` under popup blockers,
+ * in which case it should report `false` so the flow resolves `false` and the
+ * host can surface "allow popups for this site" guidance.
+ */
+/** Options for the print flow: any subset of the shared print settings. */
+export declare type PrintOptions = Partial<PrintSettings>;
+
+/** Page orientation for the printed output. */
+declare type PrintOrientation = 'portrait' | 'landscape';
+
+/** Resolved print settings emitted on confirm. */
+declare interface PrintSettings {
+    printWhat: PrintWhat;
+    orientation: PrintOrientation;
+    colorMode: PrintColorMode;
+    frameSlides: boolean;
+    slidesPerPage: HandoutSlidesPerPage;
+    slideRange: PrintSlideRange;
+    customRangeFrom: number;
+    customRangeTo: number;
+}
+
+/** Slide range mode. */
+declare type PrintSlideRange = 'all' | 'current' | 'custom';
+
+/**
+ * Pure print helpers shared by every binding's print path: settings validation,
+ * slide-range / colour-filter resolution, page-count estimation, HTML markup
+ * builders, escaping, and the full print-document assembler.
+ *
+ * No DOM side effects and no `window.print()`: everything is deterministic and
+ * the binding writes the returned HTML string into a print window. The handout
+ * grid geometry lives in `handout-layout`; this module reuses it.
+ *
+ * ng-packagr constraint honoured here (the Angular binding inlines this source
+ * and compiles it through ng-packagr): NO `String.prototype.replaceAll`
+ * (`escapeHtml` uses `.split(x).join(y)` instead).
+ */
+
+/** What to print. */
+declare type PrintWhat = 'slides' | 'handouts' | 'notes' | 'outline';
+
 /**
  * Register (or extend) the dictionary for a locale. Later registrations are
  * merged over earlier ones, so hosts can override individual keys.

package/dist/index.js

@@ -1,16 +1,19 @@
-import { _ as r, d as a, f as e, g as i, h as o, l as m, m as t, p as l, t as n, u as h } from "./component-DxQFSCeR.js";
+import { _ as a, b as e, d as o, f as r, g as t, h as i, l, m, p as n, t as h, u, v, y as p } from "./component-Bvs5zPMN.js";
 import { r as f } from "./translator-C44zS1dl.js";
 import "./i18n.js";
 export {
-  n as PowerPointViewer,
-  m as defaultCssVars,
-  h as defaultRadius,
-  a as defaultThemeColors,
+  h as PowerPointViewer,
+  l as defaultCssVars,
+  u as defaultRadius,
+  o as defaultThemeColors,
+  r as deleteAutosaveSnapshot,
+  n as getAutosaveSnapshot,
+  m as listAutosaveSnapshots,
   f as registerTranslations,
-  e as themeToCssVars,
-  l as vermilionDarkColors,
-  t as vermilionDarkTheme,
-  o as vermilionLightColors,
-  i as vermilionLightTheme,
-  r as vermilionRadius
+  i as themeToCssVars,
+  t as vermilionDarkColors,
+  a as vermilionDarkTheme,
+  v as vermilionLightColors,
+  p as vermilionLightTheme,
+  e as vermilionRadius
 };

package/dist/viewer/index.d.ts

@@ -271,6 +271,69 @@ declare interface ChartSeriesInput {
 /** Clamp a slide index into `[0, count - 1]` (0 when there are no slides). */
 export declare function clampSlideIndex(index: number, count: number): number;
 
+/**
+ * Real-time collaboration configuration.
+ *
+ * The same shape is accepted by the React, Vue, and Angular bindings.
+ */
+declare interface CollaborationConfig {
+    /** Unique identifier for the collaboration room (alphanumeric, hyphens, underscores). */
+    roomId: string;
+    /**
+     * WebSocket server URL for the Yjs provider (e.g. "wss://collab.example.com").
+     * Ignored (may be empty) when `transport` is `'webrtc'`.
+     */
+    serverUrl: string;
+    /** Transport to use. Defaults to `'websocket'`. */
+    transport?: CollaborationTransport;
+    /**
+     * WebRTC signaling server URLs (only used when `transport` is `'webrtc'`).
+     * Defaults to y-webrtc's built-in public signaling list. Same-browser tabs
+     * sync via BroadcastChannel regardless of signaling availability.
+     */
+    signaling?: string[];
+    /** Display name for the local user. */
+    userName: string;
+    /** Avatar URL for the local user (optional). */
+    userAvatar?: string;
+    /** Hex colour for the local user's cursor/presence indicator. */
+    userColor?: string;
+    /** Optional authentication token sent with the WebSocket handshake. */
+    authToken?: string;
+    /** Role in the session; defaults to `'collaborator'`. */
+    role?: CollaborationRole;
+    /**
+     * Elected-writer write-back callback (Area 3 of the C3 hardening plan).
+     *
+     * When the local user has `role: 'owner'`, the binding debounces changes and
+     * serializes the current Y.Doc state to a PPTX byte array, then calls this
+     * callback so the host can persist the snapshot. Only one writer (the owner)
+     * does this; other collaborators never trigger write-back, eliminating the
+     * last-save-wins problem.
+     */
+    onWriteBack?: (bytes: Uint8Array) => void;
+    /**
+     * Debounce delay (ms) between the last Y.Doc change and the write-back
+     * invocation. Defaults to 5000 ms. Set to 0 to write back on every change
+     * (not recommended for large documents).
+     */
+    writeBackDebounceMs?: number;
+}
+
+/** Collaboration role within a session. */
+declare type CollaborationRole = 'owner' | 'collaborator' | 'viewer';
+
+/**
+ * Collaboration transport.
+ *
+ * - `'websocket'` (default): y-websocket against `serverUrl`.
+ * - `'webrtc'`: y-webrtc peer-to-peer; needs no document server. Peers meet
+ *   through the `signaling` servers (WebRTC signaling only, no document data)
+ *   and same-browser tabs additionally sync via BroadcastChannel even without
+ *   any signaling server, which makes this mode usable from static hosting.
+ */
+declare type CollaborationTransport = 'websocket' | 'webrtc';
+
 /**
  * Connection site (`a:cxn`) on a custom geometry.
  *
@@ -554,8 +617,36 @@ declare interface EncryptionOptions {
     spinCount?: number;
 }
 
+/**
+ * Animated-GIF export capture/encode pipeline. All the pure logic is shared:
+ * `planGifFrames` derives the per-slide frame delays (default duration +
+ * per-slide overrides), `clampGifDimensions` bounds the output size, and
+ * `encodeGif` (median-cut quantisation + LZW GIF89a) produces the bytes with
+ * each frame carrying its own plan delay. This module only owns the
+ * DOM-adjacent glue: rasterising each slide via the injected capture callback
+ * and normalising every frame onto a uniform-size canvas before pixel
+ * extraction. Blob download is left to the caller (`ExportController`).
+ */
+/** Options for the animated-GIF export. */
+export declare interface ExportGifOptions {
+    /** Duration each slide is shown, in milliseconds. Default 2000. */
+    slideDurationMs?: number;
+    /** Per-slide duration overrides in milliseconds (index maps to slide index). */
+    slideTimingsMs?: number[];
+    /**
+     * Longest allowed output side in pixels; frames are scaled down
+     * proportionally. Default 960 (GIF encoding cost grows with pixel count:
+     * every pixel is matched against a 256-colour palette per frame).
+     */
+    maxDimension?: number;
+    /** Capture-phase progress callback: `(currentSlide, totalSlides)`. */
+    onProgress?: ExportProgress;
+    /** Abort the export early; checked before each slide capture. */
+    signal?: AbortSignal;
+}
+
 /** Options for the multi-slide PDF export (progress + cooperative cancel). */
-declare interface ExportPdfOptions {
+export declare interface ExportPdfOptions {
     /** Capture-phase progress callback: `(currentSlide, totalSlides)`. */
     onProgress?: ExportProgress;
     /** Abort the export early; the loop checks this between slides. */
@@ -565,6 +656,35 @@ declare interface ExportPdfOptions {
 /** Per-slide progress callback: `(currentSlideIndex, totalSlides)`. */
 declare type ExportProgress = (current: number, total: number) => void;
 
+/**
+ * Video (WebM) export driven by the shared `video-plan` maths: segment timing
+ * comes from `planVideoSegments` (default duration + per-slide overrides +
+ * fps -> frame count), the frame pacing from `fpsToFrameIntervalMs`, and the
+ * recorder MIME type from `pickSupportedMimeType(WEBM_MIME_CANDIDATES)`. This
+ * module owns the browser glue only: rasterise every slide first (capture
+ * phase), then replay each canvas onto a recording canvas whose
+ * `captureStream()` feeds a `MediaRecorder` (recording phase). Mirrors
+ * React's `exportAllSlidesAsVideo`, minus the live-stage slide flipping (the
+ * injected rasteriser renders off-screen instead).
+ */
+/** Options for the WebM video export. */
+export declare interface ExportVideoOptions {
+    /** Duration each slide is shown, in milliseconds. Default 3000. */
+    slideDurationMs?: number;
+    /** Per-slide duration overrides in milliseconds (index maps to slide index). */
+    slideTimingsMs?: number[];
+    /** Recording frame rate. Default 30. */
+    fps?: number;
+    /** Recorder bitrate. Default 5,000,000 (5 Mbps). */
+    videoBitsPerSecond?: number;
+    /** Capture-phase progress callback: `(currentSlide, totalSlides)`. */
+    onProgress?: ExportProgress;
+    /** Recording-phase progress callback: `(currentSlide, totalSlides)`. */
+    onRecordProgress?: ExportProgress;
+    /** Abort the export early; checked between slides and between frames. */
+    signal?: AbortSignal;
+}
+
 declare type FillInput = {
     type: 'solid';
     color: string;
@@ -660,6 +780,16 @@ declare interface GroupPptxElement extends PptxElementBase {
     groupFill?: ShapeStyle;
 }
 
+/**
+ * Pure handout layout calculations, shared by every binding's print path.
+ *
+ * Handles distributing slides across pages, computing grid dimensions, and
+ * positioning cells within A4 page space. No DOM/framework dependency: callers
+ * render the resulting rectangles however their view layer prefers.
+ */
+/** Supported slides-per-page values. */
+declare type HandoutSlidesPerPage = 1 | 2 | 3 | 4 | 6 | 9;
+
 declare interface ImageOptions extends Partial<ElementPosition> {
     altText?: string;
     cropLeft?: number;
@@ -1303,6 +1433,30 @@ export declare interface PowerPointViewerApi {
      * `jspdf` is dynamically imported on first use.
      */
     exportPdf(options?: ExportPdfOptions): Promise<void>;
+    /**
+     * Export every slide as an animated GIF download. Per-slide frame delays
+     * come from the shared frame plan: a default `slideDurationMs` (2000) with
+     * optional per-slide `slideTimingsMs` overrides. Supports `onProgress` and
+     * an `AbortSignal`, like {@link exportPdf}.
+     */
+    exportGif(options?: ExportGifOptions): Promise<void>;
+    /**
+     * Export every slide as a WebM video download (canvas capture stream +
+     * `MediaRecorder`; codec picked from the shared WebM candidates). Timing
+     * follows the shared video plan (`slideDurationMs` default 3000, per-slide
+     * `slideTimingsMs`, `fps` default 30). Supports capture/recording progress
+     * callbacks and an `AbortSignal`.
+     */
+    exportVideo(options?: ExportVideoOptions): Promise<void>;
+    /**
+     * Assemble the shared print document (slides / handouts / notes / outline,
+     * slide range + colour mode) and open the browser print dialog. The default
+     * print surface is a hidden same-origin iframe, so no popup window is
+     * involved; a custom `window.open`-based opener (injectable at the
+     * controller level) is subject to popup blockers, in which case the promise
+     * resolves `false`. Resolves `true` once the print surface opened.
+     */
+    print(options?: PrintOptions): Promise<boolean>;
 }
 
 /** Props for `<PowerPointViewer>`. */
@@ -1367,6 +1521,38 @@ export declare interface PowerPointViewerProps {
      * to track the dirty state or mirror edits into host state.
      */
     onchange?: () => void;
+    /**
+     * Enable debounced crash-recovery autosave. On each edit (when `editable`)
+     * the current slides are serialized to `.pptx` bytes and written to the
+     * shared IndexedDB recovery store (keyed by {@link filePath}), and
+     * `onautosave` is fired with the bytes. Requires `filePath`; without one the
+     * autosave indicator reads "disabled". This binding does not auto-restore on
+     * load; recovery is a host concern (see the re-exported `getAutosaveSnapshot`
+     * / `listAutosaveSnapshots` helpers). Default false.
+     */
+    autosave?: boolean;
+    /**
+     * IndexedDB record key for autosave (typically the open file's name/path).
+     * Autosave is inert until this is set.
+     */
+    filePath?: string;
+    /** Autosave debounce window in milliseconds. Default 2000. */
+    autosaveIntervalMs?: number;
+    /** Fired with the serialized `.pptx` bytes after each successful autosave. */
+    onautosave?: (bytes: Uint8Array) => void;
+    /**
+     * Real-time collaboration configuration. When provided, the viewer connects
+     * to the room (y-websocket or serverless y-webrtc), publishes local edits
+     * granularly, and applies remote peers' edits into the editable slides.
+     * Clearing it (undefined) tears the session down. A `viewer` role makes the
+     * local user read-only. Remote presence/cursors are not rendered by this
+     * binding (descoped); see `collab/collaboration.svelte.ts`.
+     */
+    collaboration?: CollaborationConfig;
+    /** Fired when a collaboration session starts (with the resolved config). */
+    onstartcollaboration?: (config: CollaborationConfig) => void;
+    /** Fired when a collaboration session stops. */
+    onstopcollaboration?: () => void;
 }
 
 /**
@@ -5791,6 +5977,67 @@ declare interface PresentationThemeInput {
     };
 }
 
+/** Colour mode for the printed output. */
+declare type PrintColorMode = 'color' | 'grayscale' | 'blackAndWhite';
+
+/**
+ * Print flow: assemble the shared print document (slides / notes / handouts /
+ * outline) and hand it to a print surface. All the pure logic is shared and
+ * DOMPurify-hardened: `validatePrintSettings` normalises the caller's partial
+ * settings, `computeSlideIndices` / `computeColorFilter` resolve the range and
+ * colour mode, the `build*Html` helpers produce the escaped body markup, and
+ * `buildPrintHtmlDocument` sanitises + assembles the final document. This
+ * module (the Svelte counterpart of Vue's `usePrint`) only rasterises the
+ * selected slides and opens the print surface.
+ *
+ * **Print surface / popup-blocker caveats:** the default opener renders the
+ * document into a hidden same-origin `<iframe srcdoc>` and calls
+ * `contentWindow.print()`, so no popup window is involved and popup blockers
+ * cannot interfere (`document.write` is avoided too). A host that prefers a
+ * visible print window can inject its own {@link OpenPrintWindow} via the
+ * controller deps; note that a `window.open`-based opener only succeeds inside
+ * a user gesture (a click handler) and returns `null` under popup blockers,
+ * in which case it should report `false` so the flow resolves `false` and the
+ * host can surface "allow popups for this site" guidance.
+ */
+/** Options for the print flow: any subset of the shared print settings. */
+export declare type PrintOptions = Partial<PrintSettings>;
+
+/** Page orientation for the printed output. */
+declare type PrintOrientation = 'portrait' | 'landscape';
+
+/** Resolved print settings emitted on confirm. */
+declare interface PrintSettings {
+    printWhat: PrintWhat;
+    orientation: PrintOrientation;
+    colorMode: PrintColorMode;
+    frameSlides: boolean;
+    slidesPerPage: HandoutSlidesPerPage;
+    slideRange: PrintSlideRange;
+    customRangeFrom: number;
+    customRangeTo: number;
+}
+
+/** Slide range mode. */
+declare type PrintSlideRange = 'all' | 'current' | 'custom';
+
+/**
+ * Pure print helpers shared by every binding's print path: settings validation,
+ * slide-range / colour-filter resolution, page-count estimation, HTML markup
+ * builders, escaping, and the full print-document assembler.
+ *
+ * No DOM side effects and no `window.print()`: everything is deterministic and
+ * the binding writes the returned HTML string into a print window. The handout
+ * grid geometry lives in `handout-layout`; this module reuses it.
+ *
+ * ng-packagr constraint honoured here (the Angular binding inlines this source
+ * and compiles it through ng-packagr): NO `String.prototype.replaceAll`
+ * (`escapeHtml` uses `.split(x).join(y)` instead).
+ */
+
+/** What to print. */
+declare type PrintWhat = 'slides' | 'handouts' | 'notes' | 'outline';
+
 /**
  * Map a `KeyboardEvent.key` to a navigation action, mirroring the slideshow
  * conventions used by the other bindings (arrows, paging keys, space, Home/End).

package/dist/viewer/index.js

@@ -1,4 +1,4 @@
-import { a, c as o, i as t, n as r, o as s, r as i, s as n, t as c } from "../component-DxQFSCeR.js";
+import { a, c as o, i as t, n as r, o as s, r as i, s as n, t as c } from "../component-Bvs5zPMN.js";
 export {
   c as PowerPointViewer,
   o as PresentationLoader,