fika-editor 3.4.0 → 3.4.2

package/dist/types/embed/export.d.ts

@@ -1,5 +1,12 @@
 import type { FikaDocument } from './types';
 import type { PresentationExportOptions } from '../hooks/useExport';
+export interface FikaExportProgress {
+    phase: 'preparing' | 'rendering' | 'packaging' | 'complete';
+    completed: number;
+    total: number;
+    /** Normalized 0..1; reaches 1 only when downloadable bytes are ready. */
+    progress: number;
+}
 export interface FikaExportOptions extends Pick<PresentationExportOptions, 'mediaResolver' | 'watermark'> {
     /** Runtime assets/chunks when exporting before mounting an editor. */
     assetBaseUrl?: string;
@@ -7,7 +14,7 @@ export interface FikaExportOptions extends Pick<PresentationExportOptions, 'medi
     width?: number;
     /** Resource timeout per slide in milliseconds. Default 30000. */
     timeoutMs?: number;
-    onProgress?: (completed: number, total: number) => void;
+    onProgress?: (completed: number, total: number, detail?: FikaExportProgress) => void;
 }
 /** Editable PPTX bytes. No mount, dialog, browser download, or editor mutations. */
 export declare function exportPresentationPptx(document: FikaDocument, options?: FikaExportOptions): Promise<Blob>;

package/dist/types/embed/index.d.ts

@@ -1,4 +1,4 @@
-export { exportPresentationPptx, exportPresentationPdf, type FikaExportOptions } from './export';
+export { exportPresentationPptx, exportPresentationPdf, type FikaExportOptions, type FikaExportProgress } from './export';
 export { renderSlideImage, renderDeckAtlas } from "./render";
 export { mountFika, unmountFika } from './mount';
 export type { FikaController, FikaDocument, FikaHeaderMenuItem, FikaMountOptions, FikaMountResult, FikaDocumentLoader, FikaStarterPresentationOptions, FikaTemplateLoader, FikaTemplatePayload, FikaImportPptxOptions, FikaImportApplyMode, FikaViewMode, } from './types';

package/dist/types/utils/exportWorker.d.ts

@@ -0,0 +1,9 @@
+/** Per-export worker: bounded lifetime, no editor state or host callbacks cross the boundary. */
+export declare function createExportWorker(): {
+    request<T>(task: string, data: unknown, transfer?: Transferable[]): Promise<T>;
+    close(): void;
+};
+/** Yield to another browser task, rather than resuming work inside a rAF callback. */
+export declare const yieldExportTask: () => Promise<void>;
+/** DOM conversion remains on the main thread; bound work between input opportunities. */
+export declare function exportTimeSlice(budgetMs?: number): () => Promise<void>;

package/dist/types/utils/imageTransfer.d.ts

@@ -0,0 +1,2 @@
+/** Browser image drags supply HTML/URI data, not a File. Never insert active URLs. */
+export declare function imageSourceFromTransfer(transfer: Pick<DataTransfer, 'getData'>): string | null;

package/dist/types/utils/pptxExportCommands.d.ts

@@ -0,0 +1,13 @@
+import pptxgen from 'pptxgenjs-plus';
+export interface PptxExportCommand {
+    target: number;
+    property: string;
+    args?: unknown[];
+    value?: unknown;
+    slide?: number;
+}
+/** Record the public generator API, avoiding private class serialization across workers. */
+export declare function recordPptxExport(): {
+    pptx: pptxgen;
+    commands: PptxExportCommand[];
+};

package/docs/EMBED.md

@@ -574,7 +574,16 @@ high-resolution PNG per page (2560 pixels wide by default), preserving slide
 order and aspect ratio. PDF text is rasterized. No additional document IR is
 required. Load `fika-embed.css` before PDF export so bundled fonts are available.
 
-Options include `mediaResolver`, `watermark`, and `onProgress(completed, total)`.
+Options include `mediaResolver`, `watermark`, and `onProgress(completed, total, detail)`.
+The optional `detail` (`FikaExportProgress`) includes `phase` (`preparing`, `rendering`,
+`packaging`, or `complete`) and normalized `progress` (0–1). Counted slides are
+completed slides; packaging continues after all slides render, and `progress: 1`
+is emitted only when the returned Blob is ready. Errors reject without a completion event.
+
+PPTX generation, PDF image compression/packaging, and font decoding run in module
+workers. Serve the complete `dist/embed` directory, including worker and chunk
+files, under `assetBaseUrl`; the host's CSP must permit same-origin workers.
+DOM-dependent preparation still runs on the main thread with cooperative yields.
 Omitted resolvers use the current embed configuration. Pass `null` explicitly
 to disable a resolver. PDF also accepts `width` (64 to 8192 pixels) and
 `timeoutMs` (default 30000 per slide). Required watermark and PDF image failures
@@ -583,3 +592,12 @@ reject the promise. PPTX retains its existing partial-media warning behavior.
 The native export dialog now offers `pptx`, `pdf`, and `json`; control their
 visibility with `exportTabs`. Host exports should call these APIs directly,
 without simulating export button clicks or mounting an offscreen editor.
+
+### Multiple presentation tabs
+
+The embed uses shared module-level stores and permits one active editor per
+module. Destroy the previous controller before mounting a different deck;
+mounting a second host concurrently throws before changing any document.
+Cache each deck separately in the host and pass its latest snapshot on remount.
+`destroy()` flushes pending rich-text changes and the final `onChange` before
+releasing the editor. Hosts should flush their own autosave queue on teardown.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fika-editor",
-  "version": "3.4.0",
+  "version": "3.4.2",
   "description": "Fika presentation editor embed bundle with a typed agentic bridge.",
   "type": "module",
   "main": "dist/embed/fika-embed.js",