fika-editor 3.4.1 → 3.4.3

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/exportFonts.d.ts

@@ -12,15 +12,23 @@
  * boot inside a bundled web build, hanging exports forever with no error.
  */
 import type pptxgen from 'pptxgenjs-plus';
+import type { PptxExportCommand } from './pptxExportCommands';
 type AddFontOptions = Parameters<pptxgen['addFont']>[0];
 /** Collect candidate font families from a CSS font-family string. */
 export declare const parseFontFamilyList: (value?: string) => string[];
-/** Decide whether a family should be embedded (custom, not a system font). */
+/** Bundled fonts travel with the deck, even when installed on this computer. */
 export declare const isEmbeddableFont: (family: string) => boolean;
 /**
  * Embed fonts used in the deck into the PPTX.
  * `usedFamilies` should be the raw font-family strings gathered from elements/theme.
- * Silently skips families that are system fonts, have no bundled file, or fail to load.
+ * Unbundled families remain available for the viewer to resolve. A bundled font
+ * failing to load rejects export instead of silently losing portability.
  */
 export declare const collectEmbeddedFonts: (usedFamilies: string[]) => Promise<AddFontOptions[]>;
+/**
+ * Inspect the final generator commands, including rich text runs, shape text,
+ * tables, charts and theme defaults. CSS fallback lists are not OOXML typefaces;
+ * use their first family and the same canonical name as our embedded font.
+ */
+export declare const preparePptxFontFamilies: (commands: PptxExportCommand[]) => string[];
 export {};

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/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
@@ -592,3 +601,17 @@ 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.
+
+### Portable PPTX fonts
+
+PPTX exports automatically embed bundled fonts used by the exported text runs,
+tables, shapes, charts and theme, including fonts that are installed on the
+exporting computer. Inline-only font choices are included. CSS fallback stacks
+are converted to a single OOXML typeface, and bundled family aliases use their
+canonical names. No host option is required.
+
+Serve the package's font assets alongside its workers and chunks. If a required
+bundled font cannot be fetched or decoded, export rejects instead of silently
+omitting it. Fonts outside the bundled catalog still depend on the receiving
+application's font availability. Embedded fonts improve portability in viewers
+that support them; PDF is available for a fixed visual result.

package/package.json

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