fika-editor 3.0.44 → 3.1.1

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

@@ -4,17 +4,16 @@ export declare const getChartRaster: (element: PPTChartElement, colors: string[]
 export declare const getMermaidRaster: (element: PPTMermaidElement, invalidate: () => void) => Raster | undefined;
 export declare const getCodeRaster: (element: PPTCodeElement, invalidate: () => void) => Raster | undefined;
 /**
- * MathLive typeset of a formula element, mirroring `LatexContent`'s DOM
- * (flex-centered box, a 36px stage fitted uniformly into the authored box).
- * html-to-image is used instead of a bare foreignObject because SVG-as-image
- * cannot load the MathLive web fonts.
+ * Tight MathLive snapshot of a formula — same nowrap, max-content stage as
+ * `LatexContent`. SnapDOM v3 `width`/`height` are output size only and do not
+ * reflow the live tree, but a flex host sized to the slide box *does*: the
+ * stage shrinks (`min-width:auto`), `.ML__latex` wraps, and the thumbnail
+ * becomes two lines of fallback-looking text. Capture the unconstrained
+ * stage, then `paintLatex` scales that bitmap into the authored box.
  *
- * The fit is applied as a font size, not a CSS transform: inside the SVG
- * snapshot, box edges (the radical rule, fraction bars) snap to whole CSS
- * pixels of the pre-transform layout while glyphs scale exactly, so a scaled
- * 36px stage paints a `\sqrt` rule thinner and lower than the surd's tick.
- * Laying out at the final size keeps that snap error under half a pixel, and
- * the 2x capture halves it again.
+ * Font size is the fitted size (not a CSS transform) so radical/fraction
+ * rules snap at the painted size. `reconcile: true` pins inline/table-cell
+ * boxes SnapDOM otherwise warns may re-wrap under font fallback.
  */
 export declare const getLatexRaster: (element: PPTLatexElement, invalidate: () => void) => Raster | undefined;
 /**

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

@@ -53,7 +53,7 @@ export type HighlightedTokens = {
 };
 export declare function highlightCodeTokens(code: string, language: string, theme: string): Promise<HighlightedTokens>;
 export declare function highlightCodeBlock(code: string, language: string, theme: string): Promise<HighlightedCode>;
-/** Warm Shiki + html-to-image so the first on-slide raster is not a cold start. */
+/** Warm Shiki + SnapDOM so the first on-slide raster is not a cold start. */
 export declare function prefetchCodeRaster(language?: string, theme?: string): void;
 /** Load core + lang + theme. Safe to call before CodeMirror/Shiki highlighting. */
 export declare function prepareHighlighter(language: string, theme: string): Promise<{
@@ -74,7 +74,7 @@ export type CodeRasterInput = {
     fontSize: number;
     showLineNumbers: boolean;
 };
-/** Real gutter spans so SnapDOM / html-to-image do not depend on CSS counters. */
+/** Real gutter spans so SnapDOM does not depend on CSS counters. */
 export declare function injectBoothLineNumbers(shikiHtml: string, showLineNumbers: boolean): string;
 export declare function codeElementToBoothHtml(el: CodeRasterInput): Promise<string>;
 export declare function renderCodeElementPng(el: CodeRasterInput & {

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

@@ -1,17 +1,20 @@
 /**
  * `@font-face` CSS with the font files inlined as data URLs, for markup that
- * is rasterised as a standalone SVG image (math booths, mermaid diagrams):
- * an SVG drawn through `<img>` cannot reach the page's web fonts, so any
- * family it names must travel with it.
+ * is rasterised as a standalone SVG image (mermaid diagrams): an SVG drawn
+ * through `<img>` cannot reach the page's web fonts, so any family it names
+ * must travel with it.
  *
- * html-to-image only inlines the families the probed node uses, so the probe
- * is a stub naming exactly the requested families. Results are cached per
- * family set; a result without inlined data (stylesheet not parsed yet, font
- * fetch failed) is not cached so the next capture retries.
+ * Walks document stylesheets for matching `@font-face` rules and inlines
+ * their `url()` sources. Results are cached per family set; a result without
+ * inlined data (stylesheet not parsed yet, font fetch failed) is not cached
+ * so the next capture retries.
  */
+export declare const normalizeFontFamily: (family: string) => string;
 /** Families the document declares via `@font-face` (loaded or not). */
 export declare const declaredFontFamilies: () => Set<string>;
-export declare const fontEmbedCssFor: (families: readonly string[], host?: HTMLElement) => Promise<string>;
+export declare const fontEmbedCssFor: (families: readonly string[], _host?: HTMLElement) => Promise<string>;
+/** Drop cached CSS so a later capture retries stylesheet reads. Tests only. */
+export declare const resetFontEmbedCssCache: () => void;
 /**
  * Inline every declared web font an SVG names into a `<style>` at its top,
  * so the diagram paints the same through `<img>` as it does in the DOM.

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

@@ -14,6 +14,13 @@ export declare function latexPropsAfterEdit(_current: Pick<PPTLatexElement, 'wid
 }): Pick<PPTLatexElement, 'latex' | 'path' | 'viewBox'>;
 /** Same uniform scale `useLiveBoxFit` writes: authored box / natural viewBox. */
 export declare function latexPaintScale(el: Pick<PPTLatexElement, 'width' | 'height' | 'viewBox'>): number;
+/** Scale a measured formula so it stays inside the slide with a margin. */
+export declare function fitLatexBoxToSlide(width: number, height: number, slideW: number, slideH: number, pad?: number): {
+    width: number;
+    height: number;
+    left: number;
+    top: number;
+};
 /**
  * Extract the contents of every equation (or equation*) environment.
  */

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/dist/types/utils/snapdomCapture.d.ts

@@ -0,0 +1,14 @@
+/**
+ * SnapDOM v3 capture helpers.
+ *
+ * Width/height are the final CSS size (they win over `scale`). `dpr` defaults
+ * to 1 so those dimensions are also the pixel size — pass `dpr: 2` when a
+ * booth needs a hidpi backing store. Fonts embed automatically (`'auto'`);
+ * pass `false` only to skip webfonts the way the old `fontEmbedCSS: ''` did.
+ */
+import { type SnapdomOptions } from '@zumer/snapdom';
+export type SnapdomCaptureOptions = Pick<SnapdomOptions, 'width' | 'height' | 'dpr' | 'quality' | 'embedFonts' | 'backgroundColor' | 'exclude' | 'excludeMode' | 'filter' | 'filterMode' | 'invalidate' | 'canvas' | 'reconcile'>;
+export declare const prefetchSnapdom: () => void;
+export declare const captureToCanvas: (element: Element, options?: SnapdomCaptureOptions) => Promise<HTMLCanvasElement>;
+export declare const captureToPngDataUrl: (element: Element, options?: SnapdomCaptureOptions) => Promise<string>;
+export declare const captureToJpegDataUrl: (element: Element, options?: SnapdomCaptureOptions) => Promise<string>;

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

@@ -13,6 +13,15 @@
 import { prepare as pretextPrepare } from '@chenglou/pretext';
 /** ProseMirror's default text size (assets/styles/prosemirror.scss). */
 export declare const DEFAULT_TEXT_FONT_SIZE = 16;
+/**
+ * Live text boxes use `$textElementFont` when the theme/element family is
+ * empty. Canvas wrap must use the same stack — generic `sans-serif` is a
+ * different face and packs a different number of words per line.
+ */
+export declare const DEFAULT_TEXT_FONT_FAMILY = "-apple-system, BlinkMacSystemFont, \"Segoe UI\", Roboto, Helvetica, Arial, sans-serif, \"Apple Color Emoji\", \"Segoe UI Emoji\", \"Segoe UI Symbol\"";
+/** @deprecated Use DEFAULT_TEXT_FONT_FAMILY */
+export declare const DEFAULT_FIT_FONT_FAMILY = "-apple-system, BlinkMacSystemFont, \"Segoe UI\", Roboto, Helvetica, Arial, sans-serif, \"Apple Color Emoji\", \"Segoe UI Emoji\", \"Segoe UI Symbol\"";
+export declare function resolvePaintFontFamily(family?: string | null): string;
 /** Matches `ul, ol { padding-inline-start: 1em }` when the list has no inline pad. */
 export declare const DEFAULT_LIST_PADDING_EM = 1;
 /** Matches `li { padding-inline-start: 0.4em }` (marker-to-text gap). */
@@ -143,6 +152,15 @@ export declare const lineBoxHeight: (runs: TextFitRun[], sizeScale: number, line
  * item occupies exactly the chip width.
  */
 export declare const MATH_PLACEHOLDER = "\uFFFC";
+/**
+ * Live ProseMirror uses `white-space: break-spaces`: the space after the last
+ * word on a line still occupies width, so the wrap column is one space
+ * narrower than the content box. pretext is `white-space: normal` and would
+ * otherwise pack an extra word per line (thumb vs slide).
+ */
+export declare const measureSpaceWidth: (font: string) => number;
+export declare const breakSpacesWrapWidth: (width: number, spaceWidth: number) => number;
+export declare const editorWrapWidth: (width: number, font: string) => number;
 export declare const richInlineFromRun: (run: TextFitRun, font: string, sizeScale: number, letterSpacing?: number) => {
     text: string;
     font: string;

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.1",
   "description": "Fika presentation editor embed bundle with a typed agentic bridge.",
   "type": "module",
   "main": "dist/embed/fika-embed.js",
@@ -88,6 +88,7 @@
     "@tanstack/react-virtual": "^3.14.10",
     "@use-gesture/react": "^10.3.1",
     "@use-gesture/vanilla": "^10.3.1",
+    "@zumer/snapdom": "^3.0.0",
     "animate.css": "^4.1.1",
     "buffer": "^6.0.3",
     "clipboard": "^2.0.11",
@@ -103,7 +104,6 @@
     "file-saver": "^2.0.5",
     "flatbush": "^4.6.2",
     "hfmath": "^0.0.2",
-    "html-to-image": "^1.11.13",
     "immer": "^11.1.18",
     "jszip": "^3.10.1",
     "lucide-react": "^1.33.0",