pptx-svelte-viewer 0.5.0 → 0.6.0

package/dist/index.d.ts

@@ -1,605 +1,765 @@
-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.
- *
- * These were duplicated in the React (`types-ui.ts`) and Vue (`viewer/types.ts`)
- * packages; this is the canonical copy. Each binding layers its own
- * framework-specific prop/event/handle types on top of these.
- */
-
-/** Canvas dimensions in pixels. */
-export declare interface CanvasSize {
-    width: number;
-    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.
- */
-export declare function defaultCssVars(): Record<string, string>;
-
-/** Default border-radius. */
-export declare const defaultRadius = "0.5rem";
-
-/**
- * Default dark-theme color values.
- *
- * These correspond to the built-in dark UI of the PowerPoint viewer and
- * use Tailwind's gray palette as the neutral scale with indigo as the
- * primary accent.
- */
-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). */
-export declare interface ExportPdfOptions {
-    /** Capture-phase progress callback: `(currentSlide, totalSlides)`. */
-    onProgress?: ExportProgress;
-    /** Abort the export early; the loop checks this between slides. */
-    signal?: AbortSignal;
-}
-
-/** 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.
- *
- * `svelte-check` types the `.svelte` import precisely, but the plain
- * TypeScript pass that emits the published declaration files resolves
- * `.svelte` modules through a loose ambient shim (`src/shims-svelte.d.ts`).
- * Re-exporting through this annotated constant keeps the published `.d.ts`
- * fully typed regardless of which compiler produced it.
- */
-export declare const PowerPointViewer: Component<PowerPointViewerProps, PowerPointViewerApi>;
-
-/**
- * Imperative editing API exposed on the `<PowerPointViewer>` component
- * instance (via `bind:this`). Mirrors the vanilla binding's `EditorController`
- * surface subset the host drives directly.
- */
-export declare interface PowerPointViewerApi {
-    /** Undo the last committed edit. */
-    undo(): void;
-    /** Redo the last undone edit. */
-    redo(): void;
-    /** Whether an undo step is available (snapshot; not reactive). */
-    canUndo(): boolean;
-    /** Whether a redo step is available (snapshot; not reactive). */
-    canRedo(): boolean;
-    /** Delete the selected element (no-op when nothing is selected). */
-    deleteSelected(): void;
-    /** The selected top-level element id, or null. */
-    getSelectedElementId(): string | null;
-    /** Serialize the edited slides to `.pptx` bytes via the core handler. */
-    save(): Promise<Uint8Array>;
-    /** Save + trigger a browser download of the `.pptx` (default name). */
-    downloadPptx(fileName?: string): Promise<void>;
-    /**
-     * Export a slide as a PNG download (defaults to the current slide). Renders
-     * the slide off-screen at scale 1 and rasterises it with `html2canvas-pro`
-     * (dynamically imported), so the first call pays a one-time load cost.
-     */
-    exportSlidePng(index?: number): Promise<void>;
-    /**
-     * Export every slide as a multi-page PDF download (one slide per page).
-     * `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>`. */
-export declare interface PowerPointViewerProps {
-    /** PowerPoint content as `Uint8Array` (or `ArrayBuffer`). */
-    source: Uint8Array | ArrayBuffer | null | undefined;
-    /**
-     * Theme configuration for customising the viewer's appearance. Accepts
-     * partial color overrides, a custom border-radius, and arbitrary CSS
-     * custom properties. Unset values fall back to the built-in defaults.
-     */
-    theme?: ViewerTheme;
-    /** UI locale (BCP 47). English ships built in; register others via `pptx-svelte-viewer/i18n`. */
-    locale?: string;
-    /** Slide shown after load (0-based, clamped). Default 0. */
-    initialSlide?: number;
-    /** Show the thumbnail sidebar. Default true. */
-    showThumbnails?: boolean;
-    /** Show the navigation/zoom toolbar. Default true. */
-    showToolbar?: boolean;
-    /**
-     * Show the speaker-notes panel and its toolbar toggle. Default true. The
-     * panel is plain-text only and reads the active slide's notes; pass
-     * `onnotesupdate` to make it editable (omitting it renders read-only).
-     */
-    showNotes?: boolean;
-    /**
-     * Opt in to the experimental Three.js (WebGL) SmartArt renderer for
-     * `smartArt` elements, in place of the default SVG renderer. Requires the
-     * optional `three` peer dependency; when it is unavailable, or a diagram
-     * has no renderable nodes, or the WebGL mount fails, the SVG renderer is
-     * used automatically. Default false.
-     */
-    smartArt3D?: boolean;
-    /**
-     * Enable in-place editing: click to select an element, drag to move, use the
-     * 8 handles to resize (Shift locks aspect) and the rotate handle to rotate,
-     * double-click text/shapes to edit their text, and the keyboard for
-     * delete/duplicate/nudge/undo/redo. Adds an Undo/Redo/Save/Download group to
-     * the toolbar. Default false (read-only viewer).
-     */
-    editable?: boolean;
-    /** Optional class name applied to the root element. */
-    class?: string;
-    /** Fired after a presentation finishes loading. */
-    onload?: (detail: ViewerLoadDetail) => void;
-    /** Fired when a load fails (message is human-readable). */
-    onerror?: (message: string) => void;
-    /** Fired when the active slide changes (0-based index). */
-    onslidechange?: (index: number) => void;
-    /**
-     * Fired with the committed plain-text speaker notes when the user edits
-     * the notes panel (on `change` / `blur`). This binding has no built-in
-     * slide-mutation channel, so the host is responsible for writing the text
-     * back onto its own copy of the slide; omit this to render the notes
-     * panel read-only.
-     */
-    onnotesupdate?: (notes: string) => void;
-    /**
-     * Fired after every committed editing mutation (move / resize / rotate /
-     * delete / duplicate / nudge / inline text / notes) when `editable`. Use it
-     * 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 cursors/presence render via the built-in
-     * Share/Broadcast toolbar buttons; see `collab/collaboration.svelte.ts` and
-     * `collab/components/`.
-     */
-    collaboration?: CollaborationConfig;
-    /** Fired when a collaboration session starts (with the resolved config). */
-    onstartcollaboration?: (config: CollaborationConfig) => void;
-    /** Fired when a collaboration session stops. */
-    onstopcollaboration?: () => void;
-    /**
-     * Prefilled values for the built-in Share dialog's form (room id, display
-     * name, server URL). The Broadcast dialog reuses `serverUrl` from this same
-     * object. Purely a starting point; the user can still edit every field.
-     */
-    shareDefaults?: {
-        roomId?: string;
-        userName?: string;
-        serverUrl?: string;
-    };
-}
-
-/** 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.
- */
-export declare function registerTranslations(locale: string, dictionary: TranslationDictionary): void;
-
-/**
- * Convert a `ViewerTheme` into a flat `Record<string, string>` of CSS
- * custom properties (including the `--` prefix) ready to be spread onto
- * a `style` attribute.
- *
- * Only properties that differ from the built-in defaults are emitted when
- * `omitDefaults` is true (the default).
- */
-export declare function themeToCssVars(theme: ViewerTheme | undefined, omitDefaults?: boolean): Record<string, string>;
-
-/**
- * Minimal, dependency-free translation layer for the Svelte binding.
- *
- * The canonical English dictionary lives in `pptx-viewer-shared/i18n` (shared
- * with the React, Vue, and Angular bindings, which each plug it into their
- * framework's i18n library). Svelte has no blessed i18n runtime, so this
- * module implements the small subset the viewer needs: dictionary lookup by
- * locale with English fallback, `{{name}}` interpolation, and the shared
- * `keyToLabel` humanised fallback for missing keys.
- */
-/** A flat dictionary of dotted `pptx.*` keys to display strings. */
-export declare type TranslationDictionary = Record<string, string>;
-
-/** Translate `key`, interpolating `{{name}}` placeholders from `params`. */
-export declare type Translator = (key: string, params?: Record<string, string | number>) => string;
-
-/** Dark "presenter" palette: the presenter room with the lights down. */
-export declare const vermilionDarkColors: ViewerThemeColors;
-
-/** Dark vermilion theme, ready for the viewer's `theme` prop. */
-export declare const vermilionDarkTheme: ViewerTheme;
-
-/** Light "paper" palette: a projection screen in a bright room. */
-export declare const vermilionLightColors: ViewerThemeColors;
-
-/** Light vermilion theme, ready for the viewer's `theme` prop. */
-export declare const vermilionLightTheme: ViewerTheme;
-
-/** Shared border-radius for the vermilion presets (slightly sharper than the default). */
-export declare const vermilionRadius = "0.375rem";
-
-/** Payload for the `onload` callback. */
-export declare interface ViewerLoadDetail {
-    /** Number of slides in the loaded presentation. */
-    slideCount: number;
-    /** Slide canvas size in pixels. */
-    canvasSize: CanvasSize;
-}
-
-/**
- * Full viewer theme configuration.
- *
- * Every property is optional — unset values fall back to the built-in
- * dark theme defaults.
- */
-export declare interface ViewerTheme {
-    /** Semantic UI colors. Each key maps to a `--pptx-<key>` CSS custom property. */
-    colors?: Partial<ViewerThemeColors>;
-    /** Base border-radius value (e.g. `"0.5rem"`, `"8px"`). */
-    radius?: string;
-    /**
-     * Escape hatch: arbitrary CSS custom properties to set on the viewer
-     * root element. Keys should include the `--` prefix.
-     *
-     * @example
-     * ```ts
-     * { "--my-custom-shadow": "0 4px 12px rgba(0,0,0,0.5)" }
-     * ```
-     */
-    cssVars?: Record<string, string>;
-}
-
-/**
- * Theme configuration types for the PowerPoint viewer.
- *
- * All color values accept any valid CSS color string:
- * hex (`#6366f1`), rgb (`rgb(99 102 241)`), hsl (`hsl(239 84% 67%)`),
- * oklch (`oklch(0.585 0.233 277)`), named colors, etc.
- *
- * Framework-agnostic — shared by the React, Vue, and Angular bindings.
- */
-/**
- * Semantic color tokens for the viewer UI.
- *
- * These map to CSS custom properties (`--pptx-<token>`) and drive all
- * UI component colors. The naming follows the shadcn/ui convention so
- * that Tailwind + shadcn users get a familiar experience.
- */
-export declare interface ViewerThemeColors {
-    /** Page / root background */
-    background: string;
-    /** Default text color */
-    foreground: string;
-    /** Card / panel surface */
-    card: string;
-    /** Text on card surfaces */
-    cardForeground: string;
-    /** Popover / dropdown surface */
-    popover: string;
-    /** Text inside popovers */
-    popoverForeground: string;
-    /** Primary action color (buttons, active indicators) */
-    primary: string;
-    /** Text on primary-colored backgrounds */
-    primaryForeground: string;
-    /** Secondary / subdued action color */
-    secondary: string;
-    /** Text on secondary backgrounds */
-    secondaryForeground: string;
-    /** Muted / disabled surface */
-    muted: string;
-    /** Text on muted surfaces (also used for secondary text) */
-    mutedForeground: string;
-    /** Accent / hover-highlight surface */
-    accent: string;
-    /** Text on accent surfaces */
-    accentForeground: string;
-    /** Destructive / danger action color */
-    destructive: string;
-    /** Text on destructive backgrounds */
-    destructiveForeground: string;
-    /** Default border color */
-    border: string;
-    /** Input field border color */
-    input: string;
-    /** Focus ring color */
-    ring: string;
-}
-
-export { }
+import { Component } from 'svelte';
+
+/**
+ * Theme configuration types for the PowerPoint viewer.
+ *
+ * All color values accept any valid CSS color string:
+ * hex (`#6366f1`), rgb (`rgb(99 102 241)`), hsl (`hsl(239 84% 67%)`),
+ * oklch (`oklch(0.585 0.233 277)`), named colors, etc.
+ *
+ * Framework-agnostic — shared by the React, Vue, and Angular bindings.
+ */
+/**
+ * Semantic color tokens for the viewer UI.
+ *
+ * These map to CSS custom properties (`--pptx-<token>`) and drive all
+ * UI component colors. The naming follows the shadcn/ui convention so
+ * that Tailwind + shadcn users get a familiar experience.
+ */
+interface ViewerThemeColors {
+    /** Page / root background */
+    background: string;
+    /** Default text color */
+    foreground: string;
+    /** Card / panel surface */
+    card: string;
+    /** Text on card surfaces */
+    cardForeground: string;
+    /** Popover / dropdown surface */
+    popover: string;
+    /** Text inside popovers */
+    popoverForeground: string;
+    /** Primary action color (buttons, active indicators) */
+    primary: string;
+    /** Text on primary-colored backgrounds */
+    primaryForeground: string;
+    /** Secondary / subdued action color */
+    secondary: string;
+    /** Text on secondary backgrounds */
+    secondaryForeground: string;
+    /** Muted / disabled surface */
+    muted: string;
+    /** Text on muted surfaces (also used for secondary text) */
+    mutedForeground: string;
+    /** Accent / hover-highlight surface */
+    accent: string;
+    /** Text on accent surfaces */
+    accentForeground: string;
+    /** Destructive / danger action color */
+    destructive: string;
+    /** Text on destructive backgrounds */
+    destructiveForeground: string;
+    /** Default border color */
+    border: string;
+    /** Input field border color */
+    input: string;
+    /** Focus ring color */
+    ring: string;
+}
+/**
+ * Full viewer theme configuration.
+ *
+ * Every property is optional — unset values fall back to the built-in
+ * dark theme defaults.
+ */
+interface ViewerTheme {
+    /** Semantic UI colors. Each key maps to a `--pptx-<key>` CSS custom property. */
+    colors?: Partial<ViewerThemeColors>;
+    /** Base border-radius value (e.g. `"0.5rem"`, `"8px"`). */
+    radius?: string;
+    /**
+     * Escape hatch: arbitrary CSS custom properties to set on the viewer
+     * root element. Keys should include the `--` prefix.
+     *
+     * @example
+     * ```ts
+     * { "--my-custom-shadow": "0 4px 12px rgba(0,0,0,0.5)" }
+     * ```
+     */
+    cssVars?: Record<string, string>;
+}
+
+/**
+ * Default dark-theme color values.
+ *
+ * These correspond to the built-in dark UI of the PowerPoint viewer and
+ * use Tailwind's gray palette as the neutral scale with indigo as the
+ * primary accent.
+ */
+declare const defaultThemeColors: ViewerThemeColors;
+/** Default border-radius. */
+declare const defaultRadius = "0.5rem";
+
+/**
+ * Convert a `ViewerTheme` into a flat `Record<string, string>` of CSS
+ * custom properties (including the `--` prefix) ready to be spread onto
+ * a `style` attribute.
+ *
+ * Only properties that differ from the built-in defaults are emitted when
+ * `omitDefaults` is true (the default).
+ */
+declare function themeToCssVars(theme: ViewerTheme | undefined, omitDefaults?: boolean): Record<string, string>;
+/**
+ * Build the complete set of CSS custom properties with all defaults.
+ * Useful for generating a full fallback stylesheet.
+ */
+declare function defaultCssVars(): Record<string, string>;
+
+/**
+ * Built-in "vermilion" theme presets.
+ *
+ * These mirror the pptx-viewer brand used on the documentation site:
+ * a warm paper canvas in light mode, a dimmed presenter room in dark
+ * mode, and the vermilion accent in both. Pass one to the viewer's
+ * `theme` prop (React/Vue) or `provideViewerTheme` (Angular), or spread
+ * the color objects to derive your own variant.
+ */
+/** Light "paper" palette: a projection screen in a bright room. */
+declare const vermilionLightColors: ViewerThemeColors;
+/** Dark "presenter" palette: the presenter room with the lights down. */
+declare const vermilionDarkColors: ViewerThemeColors;
+/** Shared border-radius for the vermilion presets (slightly sharper than the default). */
+declare const vermilionRadius = "0.375rem";
+/** Light vermilion theme, ready for the viewer's `theme` prop. */
+declare const vermilionLightTheme: ViewerTheme;
+/** Dark vermilion theme, ready for the viewer's `theme` prop. */
+declare const vermilionDarkTheme: ViewerTheme;
+
+/**
+ * Strongly-typed parsed XML node from fast-xml-parser.
+ *
+ * The parser is configured with `attributeNamePrefix: '@_'`,
+ * `parseAttributeValue: false`, and `parseTagValue: false`, so attribute and
+ * text values are always strings at runtime. This type encodes that:
+ *
+ * - **Attributes** — keys matching `` `@_${string}` `` return
+ *   `string | undefined` directly.
+ * - **Text content** — `#text` returns `string | undefined`.
+ * - **Child elements** — any other string key returns
+ *   `XmlObject | XmlObject[] | string | undefined`. The union reflects that
+ *   fast-xml-parser may emit an object (single child), an array (repeated
+ *   children), or a bare string (text-only element collapsed by the parser).
+ *
+ * For traversal, prefer the helpers in {@link ./../utils/xml-access} —
+ * `xmlChild` / `xmlChildren` / `xmlAttr` / `xmlText` / `xmlPath` — which
+ * narrow the union and normalize the single-vs-array duality. Direct
+ * indexing works for attributes (typed as string) but chained child access
+ * (`obj['p:spPr']?.['a:xfrm']`) requires the helpers or a narrowing cast
+ * because TypeScript cannot index into the `XmlObject[] | string` part of
+ * the union.
+ */
+interface XmlObject {
+    /** Attributes (`@_`-prefixed keys) are always strings at runtime. */
+    [attr: `@_${string}`]: string | undefined;
+    /** Element text content surfaces under `#text` when present. */
+    '#text'?: string;
+    /**
+     * Child elements keyed by their (namespaced) tag name. fast-xml-parser
+     * emits a single object for unique elements, an array for repeated ones,
+     * and a bare string for elements collapsed to their text content. Use
+     * the helpers in `utils/xml-access` to narrow this union.
+     */
+    [child: string]: XmlObject | XmlObject[] | string | undefined;
+}
+
+/**
+ * Image types: effects, crop shapes, and properties shared by image/picture
+ * elements.
+ *
+ * @module pptx-types/image
+ */
+/**
+ * Blend mode for `a:blend` container nodes inside an `a:effectDag` (CT_BlendEffect).
+ *
+ * Per ECMA-376 §20.1.8.10, valid values are: `darken`, `lighten`, `mult`,
+ * `over`, `screen`.
+ */
+type EffectDagBlendMode = 'darken' | 'lighten' | 'mult' | 'over' | 'screen';
+/**
+ * Container node kind inside an `a:effectDag` (CT_EffectContainer @type).
+ *
+ * Per ECMA-376 §20.1.8.20, `sib` (sibling) draws each child independently
+ * over the same source; `tree` (tree) chains effects so each sees the output
+ * of its siblings.
+ */
+type EffectDagContainerType = 'sib' | 'tree';
+/**
+ * Typed model of the directed-acyclic effect graph stored in `a:effectDag`.
+ *
+ * The four "structural" container/transform nodes are typed; any other inner
+ * effect (e.g. `a:outerShdw`, `a:glow`, `a:alphaInv`) is preserved verbatim
+ * as a raw XML object via the {@link EffectDagRawLeaf} variant so we never
+ * have to recurse into the full effect taxonomy.
+ *
+ * @example
+ * ```ts
+ * // <a:effectDag>
+ * //   <a:cont type="sib">
+ * //     <a:blend blend="mult"><a:cont type="tree" /></a:blend>
+ * //   </a:cont>
+ * // </a:effectDag>
+ * const dag: EffectDagContainer = {
+ *   kind: "cont",
+ *   type: "sib",
+ *   children: [{
+ *     kind: "blend",
+ *     mode: "mult",
+ *     container: { kind: "cont", type: "tree", children: [] },
+ *   }],
+ * };
+ * ```
+ */
+type EffectDagNode = EffectDagContainer | EffectDagBlend | EffectDagXfrm | EffectDagRelOff | EffectDagRawLeaf;
+/** `a:cont` — CT_EffectContainer. Recursive; mirrors the top-level `effectDag`. */
+interface EffectDagContainer {
+    kind: 'cont';
+    /** `@type` — `sib` or `tree`. */
+    type: EffectDagContainerType;
+    /** Optional `@name` attribute. */
+    name?: string;
+    /** Ordered children. */
+    children: EffectDagNode[];
+}
+/** `a:blend` — CT_BlendEffect. Always wraps a single `a:cont` child. */
+interface EffectDagBlend {
+    kind: 'blend';
+    /** `@blend` attribute. */
+    mode: EffectDagBlendMode;
+    /** Required child `a:cont` container. */
+    container: EffectDagContainer;
+}
+/** `a:xfrmEffect` — CT_TransformEffect. Affine transform with no children. */
+interface EffectDagXfrm {
+    kind: 'xfrmEffect';
+    /** Horizontal scale, percentage * 1000 (e.g. 100000 = 100%). */
+    sx?: number;
+    /** Vertical scale, percentage * 1000. */
+    sy?: number;
+    /** Horizontal skew, degrees * 60000. */
+    kx?: number;
+    /** Vertical skew, degrees * 60000. */
+    ky?: number;
+    /** Horizontal translation in EMU. */
+    tx?: number;
+    /** Vertical translation in EMU. */
+    ty?: number;
+}
+/** `a:relOff` — CT_RelativeOffsetEffect. Relative offset in 1000ths of a percent. */
+interface EffectDagRelOff {
+    kind: 'relOff';
+    /** Horizontal offset, percentage * 1000. */
+    tx?: number;
+    /** Vertical offset, percentage * 1000. */
+    ty?: number;
+}
+/**
+ * Catch-all leaf preserving any non-container effect (e.g. `a:outerShdw`,
+ * `a:glow`, `a:alphaInv`) as raw XML. Re-emitted verbatim on save.
+ */
+interface EffectDagRawLeaf {
+    kind: 'raw';
+    /** Local element name without the `a:` prefix (e.g. `outerShdw`, `glow`). */
+    tag: string;
+    /** Raw XML object captured at load — preserved verbatim on save. */
+    xml: Record<string, unknown>;
+}
+declare module "./index" {
+    interface TextStyle {
+        /**
+         * Raw `a:effectDag` XML node from `a:rPr`, preserved verbatim for
+         * round-trip serialisation. Mirrors the shape-level
+         * {@link import('./shape-style').ShapeStyle.effectDagXml} field.
+         */
+        textEffectDagXml?: XmlObject;
+        /**
+         * Typed effect graph parsed from `textEffectDagXml`. The four structural
+         * container nodes (`a:cont`, `a:blend`, `a:xfrmEffect`, `a:relOff`) are
+         * fully typed; any other leaf effect is captured as
+         * {@link EffectDagRawLeaf} so we never have to recurse into the full
+         * effect taxonomy.
+         */
+        textEffectDagTree?: EffectDagContainer;
+    }
+}
+declare module "./index" {
+    interface ShapeStyle {
+        /**
+         * Typed effect graph parsed from {@link ShapeStyle.effectDagXml}. The four
+         * structural container nodes (`a:cont`, `a:blend`, `a:xfrmEffect`,
+         * `a:relOff`) are fully typed; any other leaf effect (e.g. `a:outerShdw`,
+         * `a:glow`, `a:alphaInv`) is captured as {@link EffectDagRawLeaf} so we
+         * never have to recurse into the full effect taxonomy.
+         */
+        effectDagTree?: EffectDagContainer;
+    }
+}
+
+/**
+ * Framework-agnostic public types shared by the viewer bindings.
+ *
+ * These were duplicated in the React (`types-ui.ts`) and Vue (`viewer/types.ts`)
+ * packages; this is the canonical copy. Each binding layers its own
+ * framework-specific prop/event/handle types on top of these.
+ */
+
+/** Canvas dimensions in pixels. */
+interface CanvasSize {
+    width: number;
+    height: number;
+}
+/** Collaboration role within a session. */
+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.
+ */
+type CollaborationTransport = 'websocket' | 'webrtc';
+/**
+ * Real-time collaboration configuration.
+ *
+ * The same shape is accepted by the React, Vue, and Angular bindings.
+ */
+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;
+}
+interface AutosaveRecord {
+    key: string;
+    data: Uint8Array;
+    timestamp: number;
+    size: number;
+}
+/**
+ * Retrieve a single autosave snapshot by file path.
+ * Returns undefined when no snapshot exists.
+ */
+declare function getAutosaveSnapshot(filePath: string): Promise<AutosaveRecord | undefined>;
+/**
+ * List all autosave snapshots (without the heavy `data` blob).
+ * Useful for showing a recovery picker on app start.
+ */
+declare function listAutosaveSnapshots(): Promise<Array<{
+    key: string;
+    timestamp: number;
+    size: number;
+}>>;
+/**
+ * Delete an autosave snapshot by file path.
+ */
+declare function deleteAutosaveSnapshot(filePath: string): Promise<boolean>;
+
+/**
+ * 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. */
+type HandoutSlidesPerPage = 1 | 2 | 3 | 4 | 6 | 9;
+
+/**
+ * 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. */
+type PrintWhat = 'slides' | 'handouts' | 'notes' | 'outline';
+/** Page orientation for the printed output. */
+type PrintOrientation = 'portrait' | 'landscape';
+/** Colour mode for the printed output. */
+type PrintColorMode = 'color' | 'grayscale' | 'blackAndWhite';
+/** Slide range mode. */
+type PrintSlideRange = 'all' | 'current' | 'custom';
+/** Resolved print settings emitted on confirm. */
+interface PrintSettings {
+    printWhat: PrintWhat;
+    orientation: PrintOrientation;
+    colorMode: PrintColorMode;
+    frameSlides: boolean;
+    slidesPerPage: HandoutSlidesPerPage;
+    slideRange: PrintSlideRange;
+    customRangeFrom: number;
+    customRangeTo: 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. */
+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;
+}
+
+/**
+ * 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. */
+type PrintOptions = Partial<PrintSettings>;
+
+/**
+ * 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. */
+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;
+}
+
+/** Per-slide progress callback: `(currentSlideIndex, totalSlides)`. */
+type ExportProgress = (current: number, total: number) => void;
+/** Options for the multi-slide PDF export (progress + cooperative cancel). */
+interface ExportPdfOptions {
+    /** Capture-phase progress callback: `(currentSlide, totalSlides)`. */
+    onProgress?: ExportProgress;
+    /** Abort the export early; the loop checks this between slides. */
+    signal?: AbortSignal;
+}
+
+/**
+ * Minimal, dependency-free translation layer for the Svelte binding.
+ *
+ * The canonical English dictionary lives in `pptx-viewer-shared/i18n` (shared
+ * with the React, Vue, and Angular bindings, which each plug it into their
+ * framework's i18n library). Svelte has no blessed i18n runtime, so this
+ * module implements the small subset the viewer needs: dictionary lookup by
+ * locale with English fallback, `{{name}}` interpolation, and the shared
+ * `keyToLabel` humanised fallback for missing keys.
+ */
+/** A flat dictionary of dotted `pptx.*` keys to display strings. */
+type TranslationDictionary = Record<string, string>;
+/** Translate `key`, interpolating `{{name}}` placeholders from `params`. */
+type Translator = (key: string, params?: Record<string, string | number>) => string;
+/**
+ * Register (or extend) the dictionary for a locale. Later registrations are
+ * merged over earlier ones, so hosts can override individual keys.
+ */
+declare function registerTranslations(locale: string, dictionary: TranslationDictionary): void;
+
+/** Payload for the `onload` callback. */
+interface ViewerLoadDetail {
+    /** Number of slides in the loaded presentation. */
+    slideCount: number;
+    /** Slide canvas size in pixels. */
+    canvasSize: CanvasSize;
+}
+/** Props for `<PowerPointViewer>`. */
+interface PowerPointViewerProps {
+    /** PowerPoint content as `Uint8Array` (or `ArrayBuffer`). */
+    source: Uint8Array | ArrayBuffer | null | undefined;
+    /**
+     * Theme configuration for customising the viewer's appearance. Accepts
+     * partial color overrides, a custom border-radius, and arbitrary CSS
+     * custom properties. Unset values fall back to the built-in defaults.
+     */
+    theme?: ViewerTheme;
+    /** UI locale (BCP 47). English ships built in; register others via `pptx-svelte-viewer/i18n`. */
+    locale?: string;
+    /** Slide shown after load (0-based, clamped). Default 0. */
+    initialSlide?: number;
+    /** Show the thumbnail sidebar. Default true. */
+    showThumbnails?: boolean;
+    /** Show the navigation/zoom toolbar. Default true. */
+    showToolbar?: boolean;
+    /**
+     * Show the speaker-notes panel and its toolbar toggle. Default true. The
+     * panel is plain-text only and reads the active slide's notes; pass
+     * `onnotesupdate` to make it editable (omitting it renders read-only).
+     */
+    showNotes?: boolean;
+    /**
+     * Opt in to the experimental Three.js (WebGL) SmartArt renderer for
+     * `smartArt` elements, in place of the default SVG renderer. Requires the
+     * optional `three` peer dependency; when it is unavailable, or a diagram
+     * has no renderable nodes, or the WebGL mount fails, the SVG renderer is
+     * used automatically. Default false.
+     */
+    smartArt3D?: boolean;
+    /**
+     * Enable in-place editing: click to select an element, drag to move, use the
+     * 8 handles to resize (Shift locks aspect) and the rotate handle to rotate,
+     * double-click text/shapes to edit their text, and the keyboard for
+     * delete/duplicate/nudge/undo/redo. Adds an Undo/Redo/Save/Download group to
+     * the toolbar. Default false (read-only viewer).
+     */
+    editable?: boolean;
+    /** Optional class name applied to the root element. */
+    class?: string;
+    /** Optional display name shown in the desktop title bar. */
+    fileName?: string;
+    /** Fired after a presentation finishes loading. */
+    onload?: (detail: ViewerLoadDetail) => void;
+    /** Fired when a load fails (message is human-readable). */
+    onerror?: (message: string) => void;
+    /** Fired when the active slide changes (0-based index). */
+    onslidechange?: (index: number) => void;
+    /**
+     * Fired with the committed plain-text speaker notes when the user edits
+     * the notes panel (on `change` / `blur`). This binding has no built-in
+     * slide-mutation channel, so the host is responsible for writing the text
+     * back onto its own copy of the slide; omit this to render the notes
+     * panel read-only.
+     */
+    onnotesupdate?: (notes: string) => void;
+    /**
+     * Fired after every committed editing mutation (move / resize / rotate /
+     * delete / duplicate / nudge / inline text / notes) when `editable`. Use it
+     * 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;
+    /** Fired when the desktop title bar toggles AutoSave for this viewer instance. */
+    onautosavetoggle?: (enabled: boolean) => void;
+    /**
+     * 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 cursors/presence render via the built-in
+     * Share/Broadcast toolbar buttons; see `collab/collaboration.svelte.ts` and
+     * `collab/components/`.
+     */
+    collaboration?: CollaborationConfig;
+    /** Fired when a collaboration session starts (with the resolved config). */
+    onstartcollaboration?: (config: CollaborationConfig) => void;
+    /** Fired when a collaboration session stops. */
+    onstopcollaboration?: () => void;
+    /**
+     * Prefilled values for the built-in Share dialog's form (room id, display
+     * name, server URL). The Broadcast dialog reuses `serverUrl` from this same
+     * object. Purely a starting point; the user can still edit every field.
+     */
+    shareDefaults?: {
+        roomId?: string;
+        userName?: string;
+        serverUrl?: string;
+    };
+}
+/**
+ * Imperative editing API exposed on the `<PowerPointViewer>` component
+ * instance (via `bind:this`). Mirrors the vanilla binding's `EditorController`
+ * surface subset the host drives directly.
+ */
+interface PowerPointViewerApi {
+    /** Undo the last committed edit. */
+    undo(): void;
+    /** Redo the last undone edit. */
+    redo(): void;
+    /** Whether an undo step is available (snapshot; not reactive). */
+    canUndo(): boolean;
+    /** Whether a redo step is available (snapshot; not reactive). */
+    canRedo(): boolean;
+    /** Delete the selected element (no-op when nothing is selected). */
+    deleteSelected(): void;
+    /** The selected top-level element id, or null. */
+    getSelectedElementId(): string | null;
+    /** Serialize the edited slides to `.pptx` bytes via the core handler. */
+    save(): Promise<Uint8Array>;
+    /** Save + trigger a browser download of the `.pptx` (default name). */
+    downloadPptx(fileName?: string): Promise<void>;
+    /**
+     * Export a slide as a PNG download (defaults to the current slide). Renders
+     * the slide off-screen at scale 1 and rasterises it with `html2canvas-pro`
+     * (dynamically imported), so the first call pays a one-time load cost.
+     */
+    exportSlidePng(index?: number): Promise<void>;
+    /**
+     * Export every slide as a multi-page PDF download (one slide per page).
+     * `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>;
+}
+
+/**
+ * Explicitly-typed public export of the viewer component.
+ *
+ * `svelte-check` types the `.svelte` import precisely, but the plain
+ * TypeScript pass that emits the published declaration files resolves
+ * `.svelte` modules through a loose ambient shim (`src/shims-svelte.d.ts`).
+ * Re-exporting through this annotated constant keeps the published `.d.ts`
+ * fully typed regardless of which compiler produced it.
+ */
+declare const PowerPointViewer: Component<PowerPointViewerProps, PowerPointViewerApi>;
+
+/**
+ * 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.
+ */
+type AutosaveStatus = 'idle' | 'disabled' | 'saving' | 'saved' | 'error';
+
+export { PowerPointViewer, defaultCssVars, defaultRadius, defaultThemeColors, deleteAutosaveSnapshot, getAutosaveSnapshot, listAutosaveSnapshots, registerTranslations, themeToCssVars, vermilionDarkColors, vermilionDarkTheme, vermilionLightColors, vermilionLightTheme, vermilionRadius };
+export type { AutosaveRecord, AutosaveStatus, CanvasSize, CollaborationConfig, CollaborationRole, CollaborationTransport, ExportGifOptions, ExportPdfOptions, ExportVideoOptions, PowerPointViewerApi, PowerPointViewerProps, PrintOptions, TranslationDictionary, Translator, ViewerLoadDetail, ViewerTheme, ViewerThemeColors };