pptx-svelte-viewer 0.5.0 → 0.6.0

package/dist/viewer/export/export-video.d.ts

@@ -0,0 +1,56 @@
+import { ExportProgress, RasterizeSlide } from './export-controller.svelte';
+/**
+ * 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 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;
+}
+/** The `MediaRecorder` surface this module drives (mockable in unit tests). */
+export interface RecorderLike {
+    start(): void;
+    stop(): void;
+    ondataavailable: ((event: {
+        data: Blob;
+    }) => void) | null;
+    onstop: (() => void) | null;
+    onerror: ((event: unknown) => void) | null;
+}
+/** Injected capture/recording dependencies (kept DOM-free for unit tests). */
+export interface VideoCaptureDeps {
+    /** Live slide count; read fresh on every call. */
+    getSlideCount(): number;
+    rasterizeSlide: RasterizeSlide;
+    /** Canvas factory override (test seam). Defaults to `document.createElement`. */
+    createCanvas?: (width: number, height: number) => HTMLCanvasElement;
+    /** Recorder factory override (test seam). Defaults to `new MediaRecorder`. */
+    createRecorder?: (stream: MediaStream, options: MediaRecorderOptions) => RecorderLike;
+}
+/**
+ * Capture every slide and record the sequence as a WebM video Blob, holding
+ * each slide for its planned duration. Rejects with the shared `AbortError`
+ * when `signal` aborts (the recorder is stopped first).
+ */
+export declare function exportSlidesToWebmBlob(deps: VideoCaptureDeps, options?: ExportVideoOptions): Promise<Blob>;
+//# sourceMappingURL=export-video.d.ts.map

package/dist/viewer/export/export-video.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"export-video.d.ts","sourceRoot":"","sources":["../../../src/viewer/export/export-video.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAEjF;;;;;;;;;;GAUG;AAEH,yCAAyC;AACzC,MAAM,WAAW,kBAAkB;IAClC,mEAAmE;IACnE,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gFAAgF;IAChF,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,wCAAwC;IACxC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,oDAAoD;IACpD,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,sEAAsE;IACtE,UAAU,CAAC,EAAE,cAAc,CAAC;IAC5B,wEAAwE;IACxE,gBAAgB,CAAC,EAAE,cAAc,CAAC;IAClC,yEAAyE;IACzE,MAAM,CAAC,EAAE,WAAW,CAAC;CACrB;AAED,+EAA+E;AAC/E,MAAM,WAAW,YAAY;IAC5B,KAAK,IAAI,IAAI,CAAC;IACd,IAAI,IAAI,IAAI,CAAC;IACb,eAAe,EAAE,CAAC,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,IAAI,CAAA;KAAE,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC;IAC1D,MAAM,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI,CAAC;IAC5B,OAAO,EAAE,CAAC,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC;CAC3C;AAED,8EAA8E;AAC9E,MAAM,WAAW,gBAAgB;IAChC,kDAAkD;IAClD,aAAa,IAAI,MAAM,CAAC;IACxB,cAAc,EAAE,cAAc,CAAC;IAC/B,iFAAiF;IACjF,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,iBAAiB,CAAC;IACpE,8EAA8E;IAC9E,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,oBAAoB,KAAK,YAAY,CAAC;CACtF;AAsBD;;;;GAIG;AACH,wBAAsB,sBAAsB,CAC3C,IAAI,EAAE,gBAAgB,EACtB,OAAO,GAAE,kBAAuB,GAC9B,OAAO,CAAC,IAAI,CAAC,CA0Ef"}

package/dist/viewer/export/export-wiring.svelte.d.ts

@@ -0,0 +1,35 @@
+import { PptxSlide } from 'pptx-viewer-core';
+import { CanvasSize } from 'pptx-viewer-shared';
+import { Translator } from '../../i18n/translator';
+import { ExportController } from './export-controller.svelte';
+export interface ExportWiringDeps {
+    /**
+     * Host the off-screen capture stage is appended to. Read lazily (not
+     * captured eagerly): the viewer root `bind:this` is `undefined` until after
+     * mount, but no export can be triggered before then anyway, so the
+     * rasteriser is only built on the first `exportSlidePng`/`exportPdf` call.
+     */
+    getContainer(): HTMLElement | undefined;
+    getSlides(): PptxSlide[];
+    getCanvasSize(): CanvasSize;
+    getMediaDataUrls(): Map<string, string>;
+    getCurrent(): number;
+    getTranslator(): Translator;
+    getSmartArt3D(): boolean;
+}
+export interface ExportWiring {
+    /** The reactive PNG/PDF export controller (`exporting` drives a spinner). */
+    controller: ExportController;
+    /** Tear down the off-screen capture stage (component destroy). */
+    destroy(): void;
+}
+/**
+ * Build the PNG/PDF export feature for one `PowerPointViewer` instance: the
+ * off-screen rasterisation stage (`rasterize-slide.ts`, built lazily since it
+ * needs a live container element) plus the reactive `ExportController`
+ * wired to it. Extracted from `PowerPointViewer.svelte` purely to keep the
+ * component's script under the file-size budget, mirroring the vanilla
+ * binding's `export-lifecycle.ts`.
+ */
+export declare function createExportWiring(deps: ExportWiringDeps): ExportWiring;
+//# sourceMappingURL=export-wiring.svelte.d.ts.map

package/dist/viewer/export/export-wiring.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"export-wiring.svelte.d.ts","sourceRoot":"","sources":["../../../src/viewer/export/export-wiring.svelte.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAErD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAI9D,MAAM,WAAW,gBAAgB;IAChC;;;;;OAKG;IACH,YAAY,IAAI,WAAW,GAAG,SAAS,CAAC;IACxC,SAAS,IAAI,SAAS,EAAE,CAAC;IACzB,aAAa,IAAI,UAAU,CAAC;IAC5B,gBAAgB,IAAI,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,UAAU,IAAI,MAAM,CAAC;IACrB,aAAa,IAAI,UAAU,CAAC;IAC5B,aAAa,IAAI,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,YAAY;IAC5B,6EAA6E;IAC7E,UAAU,EAAE,gBAAgB,CAAC;IAC7B,kEAAkE;IAClE,OAAO,IAAI,IAAI,CAAC;CAChB;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,gBAAgB,GAAG,YAAY,CAiCvE"}

package/dist/viewer/export/exporting-api.d.ts

@@ -0,0 +1,19 @@
+import { ExportController, ExportPdfOptions } from './export-controller.svelte';
+import { ExportGifOptions } from './export-gif';
+import { PrintOptions } from './export-print';
+import { ExportVideoOptions } from './export-video';
+/** The imperative export API exposed on the `PowerPointViewer` instance. */
+export interface ExportingApi {
+    exportSlidePng(index?: number): Promise<void>;
+    exportPdf(options?: ExportPdfOptions): Promise<void>;
+    exportGif(options?: ExportGifOptions): Promise<void>;
+    exportVideo(options?: ExportVideoOptions): Promise<void>;
+    print(options?: PrintOptions): Promise<boolean>;
+}
+/**
+ * Build the imperative export API bound to a live `ExportController`.
+ * Extracted so `PowerPointViewer.svelte` only re-exports thin, one-line
+ * bindings, matching the editing API's `editing-api.ts`.
+ */
+export declare function createExportingApi(exporter: ExportController): ExportingApi;
+//# sourceMappingURL=exporting-api.d.ts.map

package/dist/viewer/export/exporting-api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exporting-api.d.ts","sourceRoot":"","sources":["../../../src/viewer/export/exporting-api.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AACrF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAEzD,4EAA4E;AAC5E,MAAM,WAAW,YAAY;IAC5B,cAAc,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9C,SAAS,CAAC,OAAO,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrD,SAAS,CAAC,OAAO,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrD,WAAW,CAAC,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzD,KAAK,CAAC,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAChD;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,gBAAgB,GAAG,YAAY,CAQ3E"}

package/dist/viewer/export/index.d.ts

@@ -0,0 +1,16 @@
+export type { ExportControllerDeps, ExportPdfOptions, ExportProgress, RasterizeSlide, } from './export-controller.svelte';
+export { ExportController } from './export-controller.svelte';
+export type { ExportWiring, ExportWiringDeps } from './export-wiring.svelte';
+export { createExportWiring } from './export-wiring.svelte';
+export type { ExportGifOptions, GifCaptureDeps } from './export-gif';
+export { exportSlidesToGifBlob } from './export-gif';
+export type { OpenPrintWindow, PrintDeps, PrintOptions } from './export-print';
+export { defaultOpenPrintWindow, printSlides } from './export-print';
+export type { ExportVideoOptions, RecorderLike, VideoCaptureDeps } from './export-video';
+export { exportSlidesToWebmBlob } from './export-video';
+export type { ExportingApi } from './exporting-api';
+export { createExportingApi } from './exporting-api';
+export type { RasterizeSlideController, RasterizeSlideDeps } from './rasterize-slide';
+export { createRasterizeSlide } from './rasterize-slide';
+export { renderToCanvas } from './render-to-canvas';
+//# sourceMappingURL=index.d.ts.map

package/dist/viewer/export/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/viewer/export/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACX,oBAAoB,EACpB,gBAAgB,EAChB,cAAc,EACd,cAAc,GACd,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAC9D,YAAY,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC7E,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,YAAY,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACrE,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AACrD,YAAY,EAAE,eAAe,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC/E,OAAO,EAAE,sBAAsB,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AACrE,YAAY,EAAE,kBAAkB,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACzF,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AACxD,YAAY,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACrD,YAAY,EAAE,wBAAwB,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACtF,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/viewer/export/rasterize-slide.d.ts

@@ -0,0 +1,44 @@
+import { PptxSlide } from 'pptx-viewer-core';
+import { CanvasSize } from 'pptx-viewer-shared';
+import { Translator } from '../../i18n/translator';
+export interface RasterizeSlideDeps {
+    doc: Document;
+    /** Host the off-screen capture stage is appended to; removed on `destroy()`. */
+    container: HTMLElement;
+    getSlides(): PptxSlide[];
+    getCanvasSize(): CanvasSize;
+    getMediaDataUrls(): Map<string, string>;
+    getTranslator(): Translator;
+    /** Opt-in WebGL SmartArt renderer flag; see `PowerPointViewerProps.smartArt3D`. */
+    smartArt3D: boolean;
+    /**
+     * Overridable frame-wait before capture (test seam: the real
+     * `requestAnimationFrame` double-wait is not worth driving through fake
+     * timers). Defaults to {@link nextFrame}.
+     */
+    waitForFrame?: () => Promise<void>;
+}
+export interface RasterizeSlideController {
+    /** Render slide `index` off-screen at scale 1 and capture it with html2canvas-pro. */
+    rasterizeSlide(index: number): Promise<HTMLCanvasElement>;
+    /** Remove the off-screen capture stage from the DOM. */
+    destroy(): void;
+}
+/**
+ * Build the off-screen capture stage used by PNG/PDF export: a hidden host
+ * (fixed off-canvas, `aria-hidden`) that mounts one slide at a time via
+ * Svelte 5's imperative `mount()` API (the same `mount`/`unmount` pair the
+ * component tests use to render outside the normal component tree), then
+ * rasterises it with `renderToCanvas`. The mounted `SlideStage` instance is
+ * torn down with `unmount()` and replaced on every call, and again in
+ * `destroy()`.
+ *
+ * Svelte port of the vanilla binding's `createRasterizeSlide`
+ * (`packages/vanilla/src/viewer/export/rasterize-slide.ts`): vanilla builds
+ * the stage DOM directly via the shared `renderSlideStage`; this binding
+ * instead mounts the real `SlideStage.svelte` component, seeding the i18n and
+ * SmartArt-3D context it reads deep in the element tree (those contexts are
+ * otherwise only provided by the live `PowerPointViewer` root).
+ */
+export declare function createRasterizeSlide(deps: RasterizeSlideDeps): RasterizeSlideController;
+//# sourceMappingURL=rasterize-slide.d.ts.map

package/dist/viewer/export/rasterize-slide.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rasterize-slide.d.ts","sourceRoot":"","sources":["../../../src/viewer/export/rasterize-slide.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAIrD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAKxD,MAAM,WAAW,kBAAkB;IAClC,GAAG,EAAE,QAAQ,CAAC;IACd,gFAAgF;IAChF,SAAS,EAAE,WAAW,CAAC;IACvB,SAAS,IAAI,SAAS,EAAE,CAAC;IACzB,aAAa,IAAI,UAAU,CAAC;IAC5B,gBAAgB,IAAI,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,aAAa,IAAI,UAAU,CAAC;IAC5B,mFAAmF;IACnF,UAAU,EAAE,OAAO,CAAC;IACpB;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,wBAAwB;IACxC,sFAAsF;IACtF,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAC1D,wDAAwD;IACxD,OAAO,IAAI,IAAI,CAAC;CAChB;AAwBD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,kBAAkB,GAAG,wBAAwB,CAkEvF"}

package/dist/viewer/export/render-to-canvas.d.ts

@@ -0,0 +1,15 @@
+import { Options as Html2CanvasOptions } from 'html2canvas-pro';
+/**
+ * A drop-in wrapper around `html2canvas-pro` that first normalises modern CSS
+ * colour functions (oklch/oklab/lch/lab/color()) to sRGB and applies the
+ * shared CSS-preprocessing pass (backdrop-filter, mix-blend-mode, 3D
+ * transforms, unsupported features) to the cloned capture document. Svelte
+ * port of the vanilla binding's `renderToCanvas` wrapper
+ * (`packages/vanilla/src/viewer/export/render-to-canvas.ts`); the pure
+ * colour/CSS passes live once in `pptx-viewer-shared`, only this thin
+ * html2canvas-pro glue is per-binding. `html2canvas-pro` is imported
+ * dynamically so it stays out of the main bundle until export is actually
+ * used.
+ */
+export declare function renderToCanvas(element: HTMLElement, options?: Partial<Html2CanvasOptions>): Promise<HTMLCanvasElement>;
+//# sourceMappingURL=render-to-canvas.d.ts.map

package/dist/viewer/export/render-to-canvas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-to-canvas.d.ts","sourceRoot":"","sources":["../../../src/viewer/export/render-to-canvas.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,IAAI,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAGrE;;;;;;;;;;;GAWG;AACH,wBAAsB,cAAc,CACnC,OAAO,EAAE,WAAW,EACpB,OAAO,GAAE,OAAO,CAAC,kBAAkB,CAAM,GACvC,OAAO,CAAC,iBAAiB,CAAC,CAe5B"}