fika-editor 3.0.40 → 3.0.41

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

@@ -0,0 +1,32 @@
+/**
+ * "AI is writing" reveal of a freshly generated slide.
+ *
+ * Non-text elements (pictures, shapes, lines, charts, formulas…) pop in one
+ * after another with a tiny stagger; text boxes are then typed out and tables
+ * are filled cell by cell, in element order. The store is written directly on
+ * every frame (no history snapshots, host `onChange` muted) and the final
+ * content lands through the regular `slides.update` command once, so undo and
+ * autosave only ever see the finished slide.
+ */
+import type { Slide } from '../types/slides';
+export interface FikaRevealOptions {
+    /** Badge text shown next to the caret (host-localized). Omit for no badge. */
+    label?: string;
+    /** Aborting jumps straight to the finished slide. */
+    signal?: AbortSignal;
+    /** Typing speed in characters per second. Default 80. */
+    charsPerSecond?: number;
+    /** Upper bound for the whole reveal in ms. Default 9000. */
+    maxDurationMs?: number;
+    /** `false` skips the animation and applies the slide at once. */
+    animate?: boolean;
+}
+export interface RevealDeps {
+    /** Suppress host change notifications while frames are written. */
+    mute(): void;
+    unmute(): void;
+    /** Apply the finished slide through the command pipeline (history + change event). */
+    commit(slideId: string, patch: Partial<Slide>): Promise<void>;
+    isDestroyed(): boolean;
+}
+export declare function revealSlide(slideId: string, patch: Partial<Slide>, options: FikaRevealOptions, deps: RevealDeps): Promise<void>;

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

@@ -4,7 +4,9 @@ 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 { FikaRevealOptions };
 export type { FikaMediaConfig, FikaMediaConstraints, FikaMediaKind, FikaMediaSizeLimit, FikaMediaUploadProgress, FikaMediaUploadRequest, FikaMediaUploadResult, FikaMediaUploader, FikaXhrMediaUploaderOptions } from '../configs/mediaUpload';
 export interface FikaTemplatePayload {
     title?: string;
@@ -126,6 +128,12 @@ export interface FikaMountOptions {
      * Exiting the slideshow re-enters it, so the page stays a pure viewer.
      */
     viewMode?: FikaViewMode;
+    /**
+     * Start in view-only mode: the user can browse slides but not select, edit,
+     * insert, reorder or delete anything. Host and agent commands still apply.
+     * Toggle later with `controller.setReadOnly`.
+     */
+    readOnly?: boolean;
 }
 export type FikaImportApplyMode = import('../utils/importApply').ImportApplyMode;
 export interface FikaImportPptxOptions {
@@ -193,6 +201,17 @@ export interface FikaController extends FikaAgentApi {
     nextSlide(): void;
     previousSlide(): void;
     setZoom(scale: number): void;
+    /** Toggle view-only mode (see `FikaMountOptions.readOnly`). */
+    setReadOnly(readOnly: boolean): void;
+    isReadOnly(): boolean;
+    /**
+     * Apply `patch` to an existing slide with an "AI is writing" reveal: pictures,
+     * shapes and other non-text elements pop in with a small stagger, text boxes
+     * are typed out and tables filled cell by cell, with an optional badge next
+     * to the caret. Resolves once the finished slide has been committed (one
+     * history step, one `onChange`). Aborting the signal finishes at once.
+     */
+    revealSlide(slideId: string, patch: Partial<Slide>, options?: FikaRevealOptions): Promise<void>;
     enterPresentation(): void;
     exitPresentation(): void;
     destroy(): void;

package/dist/types/store/main.d.ts

@@ -38,6 +38,22 @@ export interface MainState {
     rightPanelCollapsed: boolean;
     rightPanelPinned: 'open' | 'closed' | null;
     openPanelOnTextSelection: boolean;
+    /**
+     * Host-driven view-only mode: the user can browse slides but not select,
+     * edit, insert, reorder or delete anything. Host/agent commands still apply.
+     */
+    readOnly: boolean;
+    /** Live "AI is writing" reveal driven by `controller.revealSlide`; null when idle. */
+    aiReveal: AiRevealState | null;
+}
+export interface AiRevealState {
+    slideId: string;
+    /** Element currently being written; null while non-text elements pop in. */
+    elementId: string | null;
+    /** Host-localized badge text. Empty string hides the badge. */
+    label: string;
+    /** Bumped on every reveal frame so the badge re-measures the caret. */
+    tick: number;
 }
 export interface MainActions {
     setActiveElementIdList: (activeElementIdList: string[]) => void;
@@ -75,6 +91,8 @@ export interface MainActions {
     setOpenPanelOnTextSelection: (on: boolean) => void;
     revealRightPanelForTextRange: () => void;
     applyRightPanelAuto: (width: number, narrowPx: number) => void;
+    setReadOnly: (readOnly: boolean) => void;
+    setAiReveal: (reveal: Omit<AiRevealState, 'tick'> | null) => void;
 }
 export type MainStore = MainState & MainActions;
 export declare const databaseId: string;

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

@@ -0,0 +1,12 @@
+/**
+ * Progressive "typing" prefixes of rich-text HTML.
+ *
+ * A prefix keeps the markup well-formed: text nodes are cut mid-run, atomic
+ * nodes (inline math, images, line breaks) are either fully in or fully out,
+ * and elements left with nothing visible after the cut are dropped so no
+ * empty paragraphs flash before their text arrives.
+ */
+/** Total typing units in `html` (characters plus a fixed weight per atomic node). */
+export declare function revealUnits(html: string): number;
+/** The first `units` typing units of `html` as well-formed HTML. */
+export declare function revealPrefix(html: string, units: number): string;

package/dist/types/views/Editor/Canvas/AiRevealBadge.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Small "AI is writing" pill that trails the caret of the element currently
+ * being revealed by `controller.revealSlide`, or sits at the top-right of an
+ * element without text.
+ */
+declare const AiRevealBadge: import("react").MemoExoticComponent<({ canvasRef }: {
+    canvasRef: {
+        current: HTMLElement | null;
+    };
+}) => import("react").JSX.Element>;
+export default AiRevealBadge;

package/package.json

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