fika-editor 3.0.44 → 3.1.0

package/dist/types/configs/exportWatermark.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Host-mandated watermark for PPTX exports.
+ *
+ * The resolver runs at the start of every PPTX export, so entitlement changes
+ * on the host side (a user upgrading mid-session) take effect on the next
+ * download without remounting. Returning null/undefined exports a clean deck.
+ * A resolver that throws, or an image that cannot be loaded, fails the export
+ * — the engine never silently drops a mark the host asked for.
+ */
+export type FikaExportWatermarkPosition = 'bottom-right' | 'bottom-left' | 'top-right' | 'top-left';
+export interface FikaExportWatermark {
+    /** PNG or JPEG as a `data:` URL or a URL the browser can fetch. */
+    image: string;
+    /** Corner of the slide. @default 'bottom-right' */
+    position?: FikaExportWatermarkPosition;
+    /** Mark width as a fraction of the slide width (0–1]. @default 0.12 */
+    widthRatio?: number;
+    /** Gap to the slide edges as a fraction of the slide width (0–1]. @default 0.02 */
+    marginRatio?: number;
+    /** Extra opacity applied on top of the image's own alpha (0–1]. @default 1 */
+    opacity?: number;
+    /** Shape name shown by presentation apps. @default 'Watermark' */
+    name?: string;
+}
+export type FikaExportWatermarkResolver = () => FikaExportWatermark | null | undefined | Promise<FikaExportWatermark | null | undefined>;
+export declare function setFikaExportWatermark(resolver?: FikaExportWatermarkResolver | null): void;
+export declare function getFikaExportWatermark(): FikaExportWatermarkResolver | null;

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

@@ -3,6 +3,7 @@ export type { FikaController, FikaDocument, FikaHeaderMenuItem, FikaMountOptions
 export type { FikaDeckAtlasOptions, FikaDeckAtlasSheet, FikaDeckAtlasTile, FikaRenderSlideOptions, } from './render';
 export type { ExportTabId, FikaExportTabsConfig } from '../configs/exportTabs';
 export type { FikaExportMediaResolver } from '../configs/exportMediaResolver';
+export type { FikaExportWatermark, FikaExportWatermarkPosition, FikaExportWatermarkResolver, } from '../configs/exportWatermark';
 export { createFikaMediaUploader, } from '../configs/mediaUpload';
 export type { FikaMediaConfig, FikaMediaConstraints, FikaMediaKind, FikaMediaSizeLimit, FikaMediaUploadProgress, FikaMediaUploadRequest, FikaMediaUploadResult, FikaMediaUploader, FikaXhrMediaUploaderOptions, } from '../configs/mediaUpload';
 export type * from './agentic/types';

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

@@ -1,11 +1,13 @@
 import type { FikaExportTabsConfig } from '../configs/exportTabs';
 import type { FikaExportMediaResolver } from '../configs/exportMediaResolver';
+import type { FikaExportWatermark, FikaExportWatermarkPosition, FikaExportWatermarkResolver } from '../configs/exportWatermark';
 import type { FikaMediaConfig } from '../configs/mediaUpload';
 import type { Locales } from '../i18n/locale';
 import type { Slide, SlideTheme, SlideTemplate } from '../types/slides';
 import type { FikaAgentApi, FikaDeckViewport, FikaSlideReference } from './agentic/types';
 import type { FikaRevealOptions } from './reveal';
 export type { FikaExportMediaResolver };
+export type { FikaExportWatermark, FikaExportWatermarkPosition, FikaExportWatermarkResolver };
 export type { FikaRevealOptions };
 export type { FikaMediaConfig, FikaMediaConstraints, FikaMediaKind, FikaMediaSizeLimit, FikaMediaUploadProgress, FikaMediaUploadRequest, FikaMediaUploadResult, FikaMediaUploader, FikaXhrMediaUploaderOptions } from '../configs/mediaUpload';
 export interface FikaTemplatePayload {
@@ -97,6 +99,13 @@ export interface FikaMountOptions {
      * or null/undefined to give up on that source.
      */
     exportMediaResolver?: FikaExportMediaResolver;
+    /**
+     * Watermark baked into every PPTX download (each slide and slide master, as
+     * a locked, unselectable picture). Evaluated at the start of each export so
+     * the host can gate it on current entitlement; return null for a clean deck.
+     * Applies to regenerated decks and retained source packages alike.
+     */
+    exportWatermark?: FikaExportWatermarkResolver;
     /**
      * Local media picker used by the unified Insert → Media action (images,
      * video, and audio). Pass `upload` to send files to your backend instead of

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

@@ -0,0 +1,24 @@
+import type { FikaExportWatermark } from '../configs/exportWatermark';
+export declare const EXPORT_WATERMARK_MARKER = "fika:export-watermark";
+export interface WatermarkImage {
+    bytes: Uint8Array;
+    mime: 'image/png' | 'image/jpeg';
+    width: number;
+    height: number;
+}
+/** Reads dimensions from the PNG/JPEG header — no decoder or DOM needed. */
+export declare function readWatermarkImage(bytes: Uint8Array): WatermarkImage;
+/** Resolves `image` (data: URL or fetchable URL) to raw bytes plus dimensions. */
+export declare function loadWatermarkImage(image: string): Promise<WatermarkImage>;
+/** True when the package already carries the export watermark on any slide. */
+export declare function hasPptxExportWatermark(bytes: ArrayBuffer | Uint8Array): Promise<boolean>;
+/**
+ * Returns a new package with the watermark on every slide and slide master.
+ * Throws when the input is not a presentation package.
+ */
+export declare function applyPptxExportWatermark(bytes: ArrayBuffer | Uint8Array, watermark: FikaExportWatermark, image: WatermarkImage): Promise<Uint8Array>;
+/**
+ * Browser download through a real `HTMLAnchorElement.click()` — the same seam
+ * pptxgenjs uses, which embedding hosts rely on to capture export bytes.
+ */
+export declare function downloadPptxBytes(bytes: Uint8Array, fileName: string): void;

package/docs/EMBED.md

@@ -283,6 +283,34 @@ await mountFika(host, {
 
 Direct fetch is tried first; the resolver runs only on failure.
 
+### Export watermark
+
+Hosts that gate clean downloads behind a plan can have every PPTX export carry a watermark. Pass `exportWatermark`, a resolver evaluated at the start of each export — return the mark for accounts that need it, `null` for a clean deck. Because it runs per export, an entitlement change takes effect on the next download without remounting.
+
+```ts
+await mountFika(host, {
+  exportWatermark: () =>
+    isFreeTier()
+      ? {
+          image: `${location.origin}/images/logo.png`, // PNG or JPEG; data: URLs work too
+          position: 'bottom-right',                    // default
+          widthRatio: 0.12,                            // fraction of slide width, default
+          marginRatio: 0.02,                           // fraction of slide width, default
+          name: 'Acme',                                // shape name, default 'Watermark'
+        }
+      : null,
+})
+```
+
+The mark is written into the OOXML after generation, so it is identical for regenerated decks and retained source packages:
+
+- one shared media part, referenced from **every slide and every slide master**;
+- the slide copy sits last in the shape tree (visible over full-bleed content) and is fully locked — `noSelect` keeps PowerPoint from selecting it by click, marquee, Ctrl+A or the selection pane, so there is no in-app way to delete it;
+- the master copy is `userDrawn` and locked too; it survives slide-level deletions in editors that ignore locks and only goes away through the slide master view (or by hiding background graphics on a slide);
+- parts already carrying the mark are skipped, so a re-imported export does not stack marks.
+
+OOXML is plain XML in a ZIP — a determined user can still strip the picture with a text editor. The mark is designed to defeat casual removal, not to be cryptographically enforced. If the resolver throws or the image cannot be loaded, the export fails with the standard export error instead of silently downloading a clean deck.
+
 ### Media uploads
 
 The toolbar **Media** action (images, video, and audio) opens a local-file picker. Pexels / remote galleries are not used. Without a host `upload` callback, images become data URLs and audio/video become blob URLs — fine for demos, not for persistence.

package/package.json

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