pptx-svelte-viewer 0.1.0 → 0.1.2

package/dist/viewer/index.d.ts

@@ -554,6 +554,17 @@ declare interface EncryptionOptions {
     spinCount?: number;
 }
 
+/** Options for the multi-slide PDF export (progress + cooperative cancel). */
+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;
+
 declare type FillInput = {
     type: 'solid';
     color: string;
@@ -1257,7 +1268,42 @@ declare interface PlaceholderTextLevelStyle {
  * 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>;
+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>;
+}
 
 /** Props for `<PowerPointViewer>`. */
 export declare interface PowerPointViewerProps {
@@ -1277,6 +1323,28 @@ export declare interface PowerPointViewerProps {
     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. */
@@ -1285,6 +1353,20 @@ export declare interface PowerPointViewerProps {
     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;
 }
 
 /**

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-CacEu31z.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-DxQFSCeR.js";
 export {
   c as PowerPointViewer,
   o as PresentationLoader,

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "pptx-svelte-viewer",
-	"version": "0.1.0",
+	"version": "0.1.2",
 	"description": "Svelte 5 PowerPoint viewer component: render PPTX slides in the browser.",
 	"keywords": [
 		"office",
@@ -62,12 +62,14 @@
 		"test:watch": "vitest",
 		"pack": "bun run build && bun pm pack"
 	},
+	"dependencies": {
+		"html2canvas-pro": "^2.0.4",
+		"jspdf": "^4.2.1"
+	},
 	"devDependencies": {
 		"@microsoft/api-extractor": "^7.53.1",
 		"@sveltejs/vite-plugin-svelte": "^7.2.0",
 		"happy-dom": "^20.10.6",
-		"pptx-viewer-core": "workspace:*",
-		"pptx-viewer-shared": "workspace:*",
 		"svelte": "^5.46.4",
 		"svelte-check": "^4.7.2",
 		"typescript": "^6.0.3",
@@ -79,5 +81,8 @@
 		"fast-xml-parser": "^5.8.0",
 		"jszip": "^3.10.1",
 		"svelte": "^5.0.0"
+	},
+	"optionalDependencies": {
+		"three": "^0.185.1"
 	}
 }