fika-editor 3.3.2 → 3.4.1

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

@@ -0,0 +1,15 @@
+import type { FikaDocument } from './types';
+import type { PresentationExportOptions } from '../hooks/useExport';
+export interface FikaExportOptions extends Pick<PresentationExportOptions, 'mediaResolver' | 'watermark'> {
+    /** Runtime assets/chunks when exporting before mounting an editor. */
+    assetBaseUrl?: string;
+    /** PDF raster width in pixels. Default 2560, maximum 8192. */
+    width?: number;
+    /** Resource timeout per slide in milliseconds. Default 30000. */
+    timeoutMs?: number;
+    onProgress?: (completed: number, total: number) => void;
+}
+/** Editable PPTX bytes. No mount, dialog, browser download, or editor mutations. */
+export declare function exportPresentationPptx(document: FikaDocument, options?: FikaExportOptions): Promise<Blob>;
+/** High-resolution image PDF, one slide per page, using Fika's existing painter. */
+export declare function exportPresentationPdf(document: FikaDocument, options?: FikaExportOptions): Promise<Blob>;

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

@@ -1,3 +1,4 @@
+export { exportPresentationPptx, exportPresentationPdf, type FikaExportOptions } 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/embed/render.d.ts

@@ -1,4 +1,5 @@
 import type { Slide, SlideTheme } from '../types/slides';
+import { type FikaExportMediaResolver } from '../configs/exportMediaResolver';
 /**
  * Offscreen slide rendering for hosts and agents.
  *
@@ -25,6 +26,10 @@ export interface FikaRenderSlideOptions {
     transparentBackground?: boolean;
     /** Load original image pixels, using the host media resolver if needed. Fail if an image cannot load. */
     fullResolutionImages?: boolean;
+    /** Per-export resolver; does not replace the mounted editor's configuration. */
+    mediaResolver?: FikaExportMediaResolver | null;
+    /** Reject instead of encoding incomplete asynchronous resources. */
+    strictResources?: boolean;
 }
 export interface FikaDeckAtlasOptions extends Omit<FikaRenderSlideOptions, 'width'> {
     /** Width of one slide tile in CSS px. Default 640. */

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

@@ -93,7 +93,7 @@ export interface FikaMountOptions {
     /** Fired when Fika enters or exits slideshow/presentation mode. */
     onPresentationModeChange?: (screening: boolean) => void;
     /**
-     * Toggle export dialog formats (`pptx`, `json`). Omitted keys stay enabled.
+     * Toggle export dialog formats (`pptx`, `pdf`, `json`). Omitted keys stay enabled.
      */
     exportTabs?: FikaExportTabsConfig;
     /**

package/dist/types/hooks/useExport.d.ts

@@ -1,6 +1,22 @@
-import type { Slide } from '../types/slides';
-export default _default;
-declare function _default(): {
+import type { Slide, SlideTheme } from '../types/slides';
+import { type FikaExportMediaResolver } from '../configs/exportMediaResolver';
+import { type FikaExportWatermarkResolver } from '../configs/exportWatermark';
+/** A per-call deck snapshot: exporting never mounts or mutates an editor. */
+export interface PresentationExportState {
+    slides: Slide[];
+    theme: SlideTheme;
+    viewportRatio: number;
+    viewportSize: number;
+    title: string;
+}
+export interface PresentationExportOptions {
+    /** Only the live editor can certify the retained source package is unchanged. */
+    preserveSourcePackage?: boolean;
+    hiddenElementIds?: string[];
+    mediaResolver?: FikaExportMediaResolver | null;
+    watermark?: FikaExportWatermarkResolver | null;
+}
+export declare function createPresentationExporter({ slides, theme, viewportRatio, title, viewportSize }: PresentationExportState, options?: PresentationExportOptions, job?: import("../utils/jobProgress").JobProgress): {
     exporting: boolean;
     exportProgress: number;
     exportSlide: number;
@@ -9,5 +25,17 @@ declare function _default(): {
     exportImagePPTX: (domRefs: NodeListOf<Element>) => void;
     exportJSON: () => void;
     exportSpecificFile: (_slides: Slide[]) => void;
-    exportPPTX: (_slides: Slide[], masterOverwrite?: boolean, ignoreMedia?: boolean) => Promise<void>;
+    exportPPTX: (_slides: Slide[], masterOverwrite?: boolean, ignoreMedia?: boolean) => Promise<Blob>;
+};
+export default function useExport(): {
+    exporting: boolean;
+    exportProgress: number;
+    exportSlide: number;
+    exportSlideTotal: number;
+    exportImage: (domRef: HTMLElement, format: string, quality: number, ignoreWebfont?: boolean) => void;
+    exportImagePPTX: (domRefs: NodeListOf<Element>) => void;
+    exportJSON: () => void;
+    exportSpecificFile: (_slides: Slide[]) => void;
+    exportPDF: () => Promise<void>;
+    exportPPTX: (slides: Slide[], masterOverwrite?: boolean, ignoreMedia?: boolean) => Promise<void>;
 };

package/dist/types/i18n/i18n-types.d.ts

@@ -80,6 +80,20 @@ export type NamespaceExportTranslation = {
          */
         exportButton: string;
     };
+    pdf: {
+        /**
+         * P​D​F
+         */
+        title: string;
+        /**
+         * H​i​g​h​-​r​e​s​o​l​u​t​i​o​n​ ​s​l​i​d​e​s​,​ ​o​n​e​ ​p​e​r​ ​p​a​g​e​.
+         */
+        description: string;
+        /**
+         * D​o​w​n​l​o​a​d​ ​P​D​F
+         */
+        exportButton: string;
+    };
     json: {
         /**
          * J​S​O​N
@@ -6076,6 +6090,20 @@ export type TranslationFunctions = {
              */
             exportButton: () => LocalizedString;
         };
+        pdf: {
+            /**
+             * PDF
+             */
+            title: () => LocalizedString;
+            /**
+             * High-resolution slides, one per page.
+             */
+            description: () => LocalizedString;
+            /**
+             * Download PDF
+             */
+            exportButton: () => LocalizedString;
+        };
         json: {
             /**
              * JSON

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

@@ -1 +1 @@
-export type DialogForExportTypes = 'json' | 'pptx' | '';
+export type DialogForExportTypes = 'json' | 'pptx' | 'pdf' | '';

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/docs/EMBED.md

@@ -552,3 +552,43 @@ ordinary Fika document and viewport. `createMynaDocument()` and `MYNA_FORMATS`
 are exported for hosts that need the starter or format catalog. The same
 controller, history, media uploader, read-only options, and change callbacks
 apply. See [Myna integration and capabilities](./MYNA.md).
+
+
+### Export without a mounted editor
+
+`exportPresentationPptx(document, options)` and `exportPresentationPdf(document, options)`
+return `Promise<Blob>`. They snapshot the supplied `FikaDocument`, do not open
+an export dialog, and do not trigger a browser download. A saved deck can be
+exported while another deck remains open and editable.
+
+```ts
+import { exportPresentationPptx, exportPresentationPdf } from 'fika-editor/embed'
+
+const options = { assetBaseUrl: '/fika-assets' }
+const pptx = await exportPresentationPptx(document, options)
+const pdf = await exportPresentationPdf(document, options)
+```
+
+PPTX retains editable elements. PDF uses the existing slide painter with one
+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)`.
+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
+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.3.2",
+  "version": "3.4.1",
   "description": "Fika presentation editor embed bundle with a typed agentic bridge.",
   "type": "module",
   "main": "dist/embed/fika-embed.js",
@@ -96,11 +96,11 @@
     "@codemirror/language": "^6.12.4",
     "@codemirror/state": "^6.7.1",
     "@codemirror/view": "^6.43.9",
-    "@rgrove/parse-xml": "^4.2.3",
     "@dnd-kit/core": "^6.3.1",
     "@dnd-kit/sortable": "^10.0.0",
     "@dnd-kit/utilities": "^3.2.2",
     "@karibash/pixel-units": "^2.3.0",
+    "@rgrove/parse-xml": "^4.2.3",
     "@tanstack/react-virtual": "^3.14.10",
     "@use-gesture/react": "^10.3.1",
     "@use-gesture/vanilla": "^10.3.1",
@@ -136,8 +136,9 @@
     "number-precision": "^1.6.0",
     "overlayscrollbars": "^2.16.0",
     "parse5": "^8.0.1",
+    "pdf-lib": "^1.17.1",
     "perfect-freehand": "^1.2.3",
-    "pptxgenjs-plus": "^4.3.3",
+    "pptxgenjs-plus": "^4.3.4",
     "pptxtojson": "npm:@lofcz/pptxtojson@^2.2.9",
     "prosemirror-commands": "^1.7.2",
     "prosemirror-dropcursor": "^1.8.3",