fika-editor 3.1.1 → 3.2.0

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

@@ -8,9 +8,19 @@
  * — the engine never silently drops a mark the host asked for.
  */
 export type FikaExportWatermarkPosition = 'bottom-right' | 'bottom-left' | 'top-right' | 'top-left';
+export type FikaWatermarkSurface = 'light' | 'dark';
 export interface FikaExportWatermark {
-    /** PNG or JPEG as a `data:` URL or a URL the browser can fetch. */
+    /**
+     * Mark for light slide fills (dark artwork). PNG or JPEG as a `data:` URL
+     * or a URL the browser can fetch.
+     */
     image: string;
+    /**
+     * Mark for dark / photo slides (light artwork). When omitted every slide
+     * uses `image`. Polarities come from the same `preferredInk` query as editor
+     * chrome and text contrast.
+     */
+    imageOnDark?: string;
     /** Corner of the slide. @default 'bottom-right' */
     position?: FikaExportWatermarkPosition;
     /** Mark width as a fraction of the slide width (0–1]. @default 0.12 */

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

@@ -3,7 +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 type { FikaExportWatermark, FikaExportWatermarkPosition, FikaExportWatermarkResolver, FikaWatermarkSurface, } 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,13 +1,13 @@
 import type { FikaExportTabsConfig } from '../configs/exportTabs';
 import type { FikaExportMediaResolver } from '../configs/exportMediaResolver';
-import type { FikaExportWatermark, FikaExportWatermarkPosition, FikaExportWatermarkResolver } from '../configs/exportWatermark';
+import type { FikaExportWatermark, FikaExportWatermarkPosition, FikaExportWatermarkResolver, FikaWatermarkSurface } 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 { FikaExportWatermark, FikaExportWatermarkPosition, FikaExportWatermarkResolver, FikaWatermarkSurface };
 export type { FikaRevealOptions };
 export type { FikaMediaConfig, FikaMediaConstraints, FikaMediaKind, FikaMediaSizeLimit, FikaMediaUploadProgress, FikaMediaUploadRequest, FikaMediaUploadResult, FikaMediaUploader, FikaXhrMediaUploaderOptions } from '../configs/mediaUpload';
 export interface FikaTemplatePayload {

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

@@ -1,4 +1,4 @@
-import type { FikaExportWatermark } from '../configs/exportWatermark';
+import type { FikaExportWatermark, FikaWatermarkSurface } from '../configs/exportWatermark';
 export declare const EXPORT_WATERMARK_MARKER = "fika:export-watermark";
 export interface WatermarkImage {
     bytes: Uint8Array;
@@ -6,17 +6,32 @@ export interface WatermarkImage {
     width: number;
     height: number;
 }
+export interface ApplyPptxExportWatermarkImages {
+    onLight: WatermarkImage;
+    onDark?: WatermarkImage;
+    /** Per-slide polarity from `preferredInk`. Gaps are inferred from the slide XML. */
+    slideSurfaces?: Array<FikaWatermarkSurface | undefined>;
+    masterSurface?: FikaWatermarkSurface;
+}
 /** 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>;
+/**
+ * Same cliff as `perceivedDark` in textContrast: AERT brightness 140 or WCAG
+ * luminance 0.25. Dark surface → light mark.
+ */
+export declare function watermarkSurfaceFromRgb(r: number, g: number, b: number): FikaWatermarkSurface;
+export declare function watermarkSurfaceFromHex(hex: string): FikaWatermarkSurface;
+/** Photo fills use the invert mark; solids/gradients follow the sampled color. */
+export declare function inferWatermarkSurfaceFromSlideXml(xml: string): FikaWatermarkSurface;
 /** 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>;
+export declare function applyPptxExportWatermark(bytes: ArrayBuffer | Uint8Array, watermark: FikaExportWatermark, images: WatermarkImage | ApplyPptxExportWatermarkImages): Promise<Uint8Array>;
 /**
  * Browser download through a real `HTMLAnchorElement.click()` — the same seam
  * pptxgenjs uses, which embedding hosts rely on to capture export bytes.

package/dist/types/utils/prosemirror/commands/splitBlockKeepStyle.d.ts

@@ -0,0 +1,8 @@
+import type { NodeType } from 'prosemirror-model';
+import type { Command } from 'prosemirror-state';
+/**
+ * Enter must continue the current paragraph — align, indent, and marks.
+ * Default `splitBlock` / `splitListItem` drop attrs at the end of a block.
+ */
+export declare const splitBlockKeepStyle: Command;
+export declare const splitListItemKeepStyle: (itemType: NodeType) => Command;

package/docs/EMBED.md

@@ -292,7 +292,8 @@ await mountFika(host, {
   exportWatermark: () =>
     isFreeTier()
       ? {
-          image: `${location.origin}/images/logo.png`, // PNG or JPEG; data: URLs work too
+          image: `${location.origin}/images/logo.png`,      // light slides (dark artwork)
+          imageOnDark: `${location.origin}/images/logo-on-dark.png`, // optional; dark / photo slides
           position: 'bottom-right',                    // default
           widthRatio: 0.12,                            // fraction of slide width, default
           marginRatio: 0.02,                           // fraction of slide width, default
@@ -304,7 +305,7 @@ await mountFika(host, {
 
 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**;
+- one media part per polarity (`image` on light fills, `imageOnDark` on dark / photo fills). The engine picks the variant with the same `preferredInk` query as editor chrome; image backgrounds follow the invert mark;
 - 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.

package/package.json

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