fika-editor 3.0.2 → 3.0.3

package/dist/types/components/Draggable.d.ts

@@ -7,7 +7,7 @@ type ItemRender = (args: {
 }) => ReactNode;
 type OverlayRender = (paint: OverlayPaint) => ReactNode;
 type VirtualizerApi = ThumbnailVirtualizerApi;
-/** Drag ghost for slide rails: the live slide DOM at thumb size. */
+/** Drag ghost for slide rails: the same direct-canvas thumbnail path. */
 export declare const slideDragOverlay: OverlayRender;
 export default function Draggable({ modelValue, list, itemKey, item, children, className, onEnd, onUpdateModelValue, onContextMenu, disabled, handle, scrollRef, virtualItems, virtualizer, totalSize, overlayRender, }: {
     modelValue?: any[];

package/dist/types/components/Slider.d.ts

@@ -6,6 +6,7 @@ type SliderBaseProps = {
     step?: number;
     className?: string;
     style?: CSSProperties;
+    tooltipSuffix?: string;
     'data-tooltip'?: string;
     'data-style-slider'?: string;
 };

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

@@ -259,7 +259,7 @@ interface SlideAnimation {
     label: string;
     value: TurningMode;
 }
-/** Default slide-to-slide transition when a slide has no turningMode (PowerPoint-style: none). */
+/** Default slide-to-slide transition when a slide has no turningMode (Rise). */
 export declare const DEFAULT_TURNING_MODE: TurningMode;
 /** Locale-free slide transition values. Resolve labels via getSlideAnimations(). */
 export declare const SLIDE_ANIMATIONS: {

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

@@ -0,0 +1,28 @@
+import type { TurningGroup, TurningMode } from '../types/slides';
+export type SlideTransitionExport = {
+    type: string;
+    direction?: string;
+    duration?: number;
+    thruBlk?: boolean;
+};
+export type SlideTransitionDef = {
+    value: TurningMode;
+    group: TurningGroup;
+    /** Shown in the Transition panel. Legacy modes stay playable/exportable. */
+    picker: boolean;
+    /** Included when turningMode is `random`. */
+    randomPool: boolean;
+    duration: number;
+    export?: SlideTransitionExport;
+};
+/** Curated ink-style transitions first; legacy keys remain for existing decks. */
+export declare const SLIDE_TRANSITION_DEFS: SlideTransitionDef[];
+export declare const TURNING_MODES: TurningMode[];
+export declare const SLIDE_ANIMATION_PICKER: TurningMode[];
+export declare const SLIDE_ANIMATION_GROUPS: TurningGroup[];
+export declare const RANDOM_TURNING_MODES: Exclude<TurningMode, 'random' | 'no'>[];
+export declare const getTransitionDef: (mode?: TurningMode) => SlideTransitionDef;
+export declare const getTurningDurationMs: (mode?: TurningMode) => number;
+export declare const turningDurationVars: (mode?: TurningMode) => Record<string, string>;
+export declare const transitionExportForMode: (mode?: TurningMode) => SlideTransitionExport | undefined;
+export declare const pickerModesForGroup: (group: TurningGroup) => TurningMode[];

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

@@ -49,6 +49,13 @@ export interface FikaImportDocumentOptions {
      * Ignored on the agentic JSON path (never shows a dialog).
      */
     confirm?: boolean;
+    /**
+     * Override imported transitions. A single mode applies to every slide;
+     * an array or 0-/1-based index map sets individual slides.
+     */
+    turningMode?: TurningMode | Array<TurningMode | null | undefined> | Record<number, TurningMode>;
+    /** Fallback when a slide has no transition and no per-slide override. Defaults to Rise. */
+    defaultTurningMode?: TurningMode;
 }
 export type FikaDocumentImportPayload = FikaDeckInput | ({
     document: FikaDeckInput;

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

@@ -152,6 +152,14 @@ export interface FikaImportPptxOptions {
      * leave off for genuine user files.
      */
     fixContrast?: boolean;
+    /**
+     * Override imported transitions. A single mode applies to every slide;
+     * an array or 0-/1-based index map sets individual slides. Missing entries
+     * keep the file transition, or Rise when the file has none.
+     */
+    turningMode?: import('../types/slides').TurningMode | Array<import('../types/slides').TurningMode | null | undefined> | Record<number, import('../types/slides').TurningMode>;
+    /** Fallback when a slide has no file transition and no per-slide override. */
+    defaultTurningMode?: import('../types/slides').TurningMode;
 }
 /** Public embed controller: legacy host methods plus the generic command and domain APIs. */
 export interface FikaController extends FikaAgentApi {

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

@@ -722,6 +722,16 @@ export type NamespaceCanvasTranslation = {
      * S​t​y​l​e​ ​p​a​n​e​l​ ​s​t​a​y​s​ ​c​l​o​s​e​d​ ​w​h​e​n​ ​s​e​l​e​c​t​i​n​g​ ​t​e​x​t
      */
     openPanelOnTextSelectionDisabled: string;
+    layerStack: {
+        /**
+         * L​a​y​e​r​s
+         */
+        title: string;
+        /**
+         * A​l​t​ ​+​ ​C​l​i​c​k​ ​·​ ​n​e​x​t​ ​l​a​y​e​r
+         */
+        hint: string;
+    };
     shapeCreate: {
         /**
          * D​r​a​w​ ​f​r​e​e​l​y​ ​·​ ​E​n​t​e​r​ ​t​o​ ​a​p​p​l​y​ ​·​ ​E​s​c​ ​t​o​ ​d​i​s​c​a​r​d
@@ -1449,49 +1459,99 @@ export type NamespaceConfigsTranslation = {
              */
             no: string;
             /**
-             * R​a​n​d​o​m
+             * F​a​d​e
              */
-            random: string;
+            fade: string;
+            /**
+             * T​h​r​o​u​g​h​ ​i​n​k
+             */
+            throughInk: string;
+            /**
+             * D​i​s​s​o​l​v​e
+             */
+            dissolve: string;
             /**
-             * H​o​r​i​z​o​n​t​a​l​ ​s​l​i​d​e
+             * P​u​s​h
              */
             slideX: string;
             /**
-             * V​e​r​t​i​c​a​l​ ​s​l​i​d​e
+             * R​i​s​e
              */
             slideY: string;
             /**
-             * H​o​r​i​z​o​n​t​a​l​ ​s​l​i​d​e​ ​(​3​D​)
+             * W​i​p​e
              */
-            slideX3D: string;
+            wipe: string;
             /**
-             * V​e​r​t​i​c​a​l​ ​s​l​i​d​e​ ​(​3​D​)
+             * R​e​v​e​a​l
              */
-            slideY3D: string;
+            reveal: string;
             /**
-             * F​a​d​e
+             * Z​o​o​m
              */
-            fade: string;
+            scale: string;
+            /**
+             * Z​o​o​m​ ​o​u​t
+             */
+            scaleReverse: string;
+            /**
+             * M​o​r​p​h
+             */
+            morph: string;
+            /**
+             * R​i​p​p​l​e
+             */
+            ripple: string;
+            /**
+             * D​o​o​r​s
+             */
+            doors: string;
+            /**
+             * D​i​v​e
+             */
+            flythrough: string;
             /**
-             * R​o​t​a​t​e
+             * F​l​i​p
+             */
+            slideX3D: string;
+            /**
+             * F​l​i​p​ ​v​e​r​t​i​c​a​l
+             */
+            slideY3D: string;
+            /**
+             * P​i​v​o​t
              */
             rotate: string;
             /**
-             * V​e​r​t​i​c​a​l​ ​s​t​r​e​t​c​h
+             * S​t​r​e​t​c​h​ ​v​e​r​t​i​c​a​l
              */
             scaleY: string;
             /**
-             * H​o​r​i​z​o​n​t​a​l​ ​s​t​r​e​t​c​h
+             * S​t​r​e​t​c​h
              */
             scaleX: string;
             /**
-             * Z​o​o​m​ ​i​n
+             * R​a​n​d​o​m
              */
-            scale: string;
+            random: string;
+        };
+        slideGroups: {
             /**
-             * Z​o​o​m​ ​o​u​t
+             * A​t​m​o​s​p​h​e​r​e
              */
-            scaleReverse: string;
+            atmosphere: string;
+            /**
+             * M​o​t​i​o​n
+             */
+            motion: string;
+            /**
+             * D​e​p​t​h
+             */
+            depth: string;
+            /**
+             * C​l​a​s​s​i​c
+             */
+            classic: string;
         };
     };
     chart: {
@@ -1844,6 +1904,10 @@ export type NamespaceConfigsTranslation = {
              * C​y​c​l​e​ ​f​o​c​u​s​ ​b​e​t​w​e​e​n​ ​e​l​e​m​e​n​t​s
              */
             cycleFocusElement: string;
+            /**
+             * C​y​c​l​e​ ​l​a​y​e​r​s​ ​u​n​d​e​r​ ​t​h​e​ ​c​u​r​s​o​r
+             */
+            cycleLayersAtPoint: string;
             /**
              * C​o​n​f​i​r​m​ ​i​m​a​g​e​ ​c​r​o​p
              */
@@ -1970,6 +2034,10 @@ export type NamespaceConfigsTranslation = {
              * R​i​g​h​t​-​c​l​i​c​k
              */
             rightClick: string;
+            /**
+             * A​l​t​ ​+​ ​c​l​i​c​k
+             */
+            altClick: string;
             /**
              * L​ ​/​ ​r​i​g​h​t​-​c​l​i​c​k​ ​d​r​a​g
              */
@@ -3471,6 +3539,22 @@ export type NamespaceEditorTranslation = {
              * K​e​e​p​ ​c​u​r​r​e​n​t​ ​s​l​i​d​e​s​ ​a​n​d​ ​a​p​p​e​n​d​ ​t​h​e​ ​i​m​p​o​r​t​e​d​ ​o​n​e​s​.
              */
             appendHint: string;
+            /**
+             * T​r​a​n​s​i​t​i​o​n​s
+             */
+            transitionLabel: string;
+            /**
+             * F​r​o​m​ ​f​i​l​e
+             */
+            transitionKeep: string;
+            /**
+             * K​e​e​p​ ​e​a​c​h​ ​s​l​i​d​e​’​s​ ​t​r​a​n​s​i​t​i​o​n​.​ ​S​l​i​d​e​s​ ​w​i​t​h​o​u​t​ ​o​n​e​ ​g​e​t​ ​R​i​s​e​.
+             */
+            transitionKeepHint: string;
+            /**
+             * S​a​m​e​ ​o​n​ ​e​v​e​r​y​ ​s​l​i​d​e
+             */
+            transitionAll: string;
         };
         /**
          * L​a​n​g​u​a​g​e
@@ -5858,6 +5942,16 @@ export type TranslationFunctions = {
          * Style panel stays closed when selecting text
          */
         openPanelOnTextSelectionDisabled: () => LocalizedString;
+        layerStack: {
+            /**
+             * Layers
+             */
+            title: () => LocalizedString;
+            /**
+             * Alt + Click · next layer
+             */
+            hint: () => LocalizedString;
+        };
         shapeCreate: {
             /**
              * Draw freely · Enter to apply · Esc to discard
@@ -6588,49 +6682,99 @@ export type TranslationFunctions = {
                  */
                 no: () => LocalizedString;
                 /**
-                 * Random
+                 * Fade
                  */
-                random: () => LocalizedString;
+                fade: () => LocalizedString;
+                /**
+                 * Through ink
+                 */
+                throughInk: () => LocalizedString;
+                /**
+                 * Dissolve
+                 */
+                dissolve: () => LocalizedString;
                 /**
-                 * Horizontal slide
+                 * Push
                  */
                 slideX: () => LocalizedString;
                 /**
-                 * Vertical slide
+                 * Rise
                  */
                 slideY: () => LocalizedString;
                 /**
-                 * Horizontal slide (3D)
+                 * Wipe
                  */
-                slideX3D: () => LocalizedString;
+                wipe: () => LocalizedString;
                 /**
-                 * Vertical slide (3D)
+                 * Reveal
                  */
-                slideY3D: () => LocalizedString;
+                reveal: () => LocalizedString;
                 /**
-                 * Fade
+                 * Zoom
                  */
-                fade: () => LocalizedString;
+                scale: () => LocalizedString;
+                /**
+                 * Zoom out
+                 */
+                scaleReverse: () => LocalizedString;
+                /**
+                 * Morph
+                 */
+                morph: () => LocalizedString;
+                /**
+                 * Ripple
+                 */
+                ripple: () => LocalizedString;
+                /**
+                 * Doors
+                 */
+                doors: () => LocalizedString;
+                /**
+                 * Dive
+                 */
+                flythrough: () => LocalizedString;
                 /**
-                 * Rotate
+                 * Flip
+                 */
+                slideX3D: () => LocalizedString;
+                /**
+                 * Flip vertical
+                 */
+                slideY3D: () => LocalizedString;
+                /**
+                 * Pivot
                  */
                 rotate: () => LocalizedString;
                 /**
-                 * Vertical stretch
+                 * Stretch vertical
                  */
                 scaleY: () => LocalizedString;
                 /**
-                 * Horizontal stretch
+                 * Stretch
                  */
                 scaleX: () => LocalizedString;
                 /**
-                 * Zoom in
+                 * Random
                  */
-                scale: () => LocalizedString;
+                random: () => LocalizedString;
+            };
+            slideGroups: {
                 /**
-                 * Zoom out
+                 * Atmosphere
                  */
-                scaleReverse: () => LocalizedString;
+                atmosphere: () => LocalizedString;
+                /**
+                 * Motion
+                 */
+                motion: () => LocalizedString;
+                /**
+                 * Depth
+                 */
+                depth: () => LocalizedString;
+                /**
+                 * Classic
+                 */
+                classic: () => LocalizedString;
             };
         };
         chart: {
@@ -6983,6 +7127,10 @@ export type TranslationFunctions = {
                  * Cycle focus between elements
                  */
                 cycleFocusElement: () => LocalizedString;
+                /**
+                 * Cycle layers under the cursor
+                 */
+                cycleLayersAtPoint: () => LocalizedString;
                 /**
                  * Confirm image crop
                  */
@@ -7109,6 +7257,10 @@ export type TranslationFunctions = {
                  * Right-click
                  */
                 rightClick: () => LocalizedString;
+                /**
+                 * Alt + click
+                 */
+                altClick: () => LocalizedString;
                 /**
                  * L / right-click drag
                  */
@@ -8626,6 +8778,22 @@ export type TranslationFunctions = {
                  * Keep current slides and append the imported ones.
                  */
                 appendHint: () => LocalizedString;
+                /**
+                 * Transitions
+                 */
+                transitionLabel: () => LocalizedString;
+                /**
+                 * From file
+                 */
+                transitionKeep: () => LocalizedString;
+                /**
+                 * Keep each slide’s transition. Slides without one get Rise.
+                 */
+                transitionKeepHint: () => LocalizedString;
+                /**
+                 * Same on every slide
+                 */
+                transitionAll: () => LocalizedString;
             };
             /**
              * Language

package/dist/types/paint/rasterResources.d.ts

@@ -0,0 +1,7 @@
+import type { PPTChartElement, PPTCodeElement, PPTMermaidElement } from '../types/slides';
+type Raster = ImageBitmap | HTMLCanvasElement;
+export declare const getChartRaster: (element: PPTChartElement, colors: string[], textColor: string, lineColor: string, invalidate: () => void) => Raster | undefined;
+export declare const getMermaidRaster: (element: PPTMermaidElement, invalidate: () => void) => Raster | undefined;
+export declare const getCodeRaster: (element: PPTCodeElement, invalidate: () => void) => Raster | undefined;
+export declare const clearSlideRasterResources: () => void;
+export {};

package/dist/types/paint/scheduler.d.ts

@@ -0,0 +1,17 @@
+export type PaintPriority = 'visible' | 'nearby' | 'background';
+export declare const canvasPaintStats: {
+    paints: number;
+    cancelled: number;
+    maxQueue: number;
+    paintMs: number[];
+};
+export declare const scheduleSlidePaint: (key: string, paint: () => void, priority?: PaintPriority) => () => void;
+export declare const readCanvasPaintReport: () => {
+    paints: number;
+    cancelled: number;
+    maxQueue: number;
+    paintMs: number[];
+    paintMsAvg: number;
+    paintMsMax: number;
+    queued: number;
+};

package/dist/types/paint/slidePainter.d.ts

@@ -0,0 +1,17 @@
+import type { Slide, SlideTheme } from '../types/slides';
+export type PaintSlideOptions = {
+    slide: Slide;
+    theme: SlideTheme;
+    viewportSize: number;
+    viewportRatio: number;
+    cssWidth: number;
+    cssHeight?: number;
+    dpr?: number;
+    invalidate: () => void;
+};
+/**
+ * Direct Slide JSON -> final-DPR canvas paint. No DOM tree, foreignObject
+ * capture, intermediate PNG, or CSS-scale resampling is involved.
+ */
+export declare const paintSlideToCanvas: (canvas: HTMLCanvasElement, options: PaintSlideOptions) => void;
+export declare const clearSlidePathCache: () => void;

package/dist/types/paint/textPainter.d.ts

@@ -0,0 +1,31 @@
+import type { TextAlign, TextAlignVertical } from '../types/slides';
+export type CanvasTextPaintOptions = {
+    html: string;
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    defaultFontFamily: string;
+    defaultColor: string;
+    defaultSize?: number;
+    lineHeight?: number;
+    letterSpacing?: number;
+    paragraphSpace?: number;
+    inset?: [number, number, number, number];
+    vAlign?: TextAlignVertical;
+    align?: TextAlign;
+    fit?: boolean;
+    opacity?: number;
+    vertical?: boolean;
+    shadow?: {
+        h: number;
+        v: number;
+        blur: number;
+        color: string;
+    };
+};
+/**
+ * Paint ProseMirror HTML without mounting DOM. Pretext owns Unicode-aware
+ * wrapping; Canvas owns glyph shaping and rasterization at the final DPR.
+ */
+export declare const paintRichText: (ctx: CanvasRenderingContext2D, options: CanvasTextPaintOptions) => number;

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

@@ -1,5 +1,10 @@
 import type { ImportApplyMode } from '../utils/importApply';
-export type ImportConfirmChoice = ImportApplyMode | null;
+import type { TurningMode } from '../types/slides';
+export type ImportTransitionChoice = 'keep' | TurningMode;
+export type ImportConfirmChoice = {
+    apply: ImportApplyMode;
+    turningMode: ImportTransitionChoice;
+} | null;
 export interface ImportConfirmState {
     visible: boolean;
     slideCount: number;

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

@@ -1,4 +1,4 @@
-import type { Slide, SlideTheme, PPTElement, PPTAnimation, SlideTemplate, ImportedSlideTemplate } from '../types/slides';
+import type { Slide, SlideTheme, PPTElement, PPTAnimation, SlideTemplate, ImportedSlideTemplate, TurningMode } from '../types/slides';
 export type AddSlideOptions = {
     index?: number;
     select?: boolean;
@@ -27,6 +27,8 @@ export interface SlidesState {
     viewportRatio: number;
     templates: SlideTemplate[];
     importedTemplates: ImportedSlideTemplate[];
+    /** Used for newly added slides after "Use on every slide". Defaults to Rise. */
+    defaultTurningMode: TurningMode;
 }
 export interface SlidesActions {
     setTitle: (title: string) => void;
@@ -46,6 +48,7 @@ export interface SlidesActions {
     moveSlide: (fromIndex: number, toIndex: number) => void;
     reorderSlides: (oldIndex: number, newIndex: number) => void;
     updateSlideIndex: (index: number) => void;
+    setDefaultTurningMode: (mode: TurningMode) => void;
     addElement: (element: PPTElement | PPTElement[]) => void;
     deleteElement: (elementId: string | string[]) => void;
     updateElement: (data: UpdateElementData) => void;
@@ -849,7 +852,7 @@ export declare const useSlidesStore: import("zustand").UseBoundStore<Omit<import
                 duration: number;
                 trigger: import("../types/slides").AnimationTrigger;
             }[];
-            turningMode?: import("../types/slides").TurningMode;
+            turningMode?: TurningMode;
             sectionTag?: {
                 id: string;
                 title?: string;
@@ -1631,7 +1634,7 @@ export declare const useSlidesStore: import("zustand").UseBoundStore<Omit<import
                     duration: number;
                     trigger: import("../types/slides").AnimationTrigger;
                 }[];
-                turningMode?: import("../types/slides").TurningMode;
+                turningMode?: TurningMode;
                 sectionTag?: {
                     id: string;
                     title?: string;
@@ -1661,6 +1664,7 @@ export declare const useSlidesStore: import("zustand").UseBoundStore<Omit<import
             width: number;
             height: number;
         }[];
+        defaultTurningMode: TurningMode;
         setTitle: (title: string) => void;
         setTheme: (themeProps: Partial<SlideTheme>) => void;
         setViewportSize: (size: number) => void;
@@ -1678,6 +1682,7 @@ export declare const useSlidesStore: import("zustand").UseBoundStore<Omit<import
         moveSlide: (fromIndex: number, toIndex: number) => void;
         reorderSlides: (oldIndex: number, newIndex: number) => void;
         updateSlideIndex: (index: number) => void;
+        setDefaultTurningMode: (mode: TurningMode) => void;
         addElement: (element: PPTElement | PPTElement[]) => void;
         deleteElement: (elementId: string | string[]) => void;
         updateElement: (data: UpdateElementData) => void;
@@ -2466,7 +2471,7 @@ export declare const useSlidesStore: import("zustand").UseBoundStore<Omit<import
                 duration: number;
                 trigger: import("../types/slides").AnimationTrigger;
             }[];
-            turningMode?: import("../types/slides").TurningMode;
+            turningMode?: TurningMode;
             sectionTag?: {
                 id: string;
                 title?: string;
@@ -3248,7 +3253,7 @@ export declare const useSlidesStore: import("zustand").UseBoundStore<Omit<import
                     duration: number;
                     trigger: import("../types/slides").AnimationTrigger;
                 }[];
-                turningMode?: import("../types/slides").TurningMode;
+                turningMode?: TurningMode;
                 sectionTag?: {
                     id: string;
                     title?: string;
@@ -3278,6 +3283,7 @@ export declare const useSlidesStore: import("zustand").UseBoundStore<Omit<import
             width: number;
             height: number;
         }[];
+        defaultTurningMode: TurningMode;
         setTitle: (title: string) => void;
         setTheme: (themeProps: Partial<SlideTheme>) => void;
         setViewportSize: (size: number) => void;
@@ -3295,6 +3301,7 @@ export declare const useSlidesStore: import("zustand").UseBoundStore<Omit<import
         moveSlide: (fromIndex: number, toIndex: number) => void;
         reorderSlides: (oldIndex: number, newIndex: number) => void;
         updateSlideIndex: (index: number) => void;
+        setDefaultTurningMode: (mode: TurningMode) => void;
         addElement: (element: PPTElement | PPTElement[]) => void;
         deleteElement: (elementId: string | string[]) => void;
         updateElement: (data: UpdateElementData) => void;

package/dist/types/types/slides.d.ts

@@ -113,7 +113,7 @@ export interface StructuredTextBody {
  * style?: solid or dashed
  * width?: stroke width
  * color?: stroke color
- * radius?: corner radius in px
+ * radius?: 0–1 of max rounding (ECMA-376 / pptxgenjs `rectRadius`). Values > 1 are legacy px.
  */
 export interface PPTElementOutline {
     style?: LineStyleType;
@@ -515,7 +515,8 @@ export interface SlideBackground {
     image?: SlideBackgroundImage;
     gradient?: Gradient;
 }
-export type TurningMode = 'no' | 'fade' | 'slideX' | 'slideY' | 'random' | 'slideX3D' | 'slideY3D' | 'rotate' | 'scaleY' | 'scaleX' | 'scale' | 'scaleReverse';
+export type TurningMode = 'no' | 'fade' | 'throughInk' | 'dissolve' | 'slideX' | 'slideY' | 'wipe' | 'reveal' | 'scale' | 'scaleReverse' | 'morph' | 'ripple' | 'doors' | 'flythrough' | 'slideX3D' | 'slideY3D' | 'rotate' | 'scaleY' | 'scaleX' | 'random';
+export type TurningGroup = 'atmosphere' | 'motion' | 'depth' | 'classic';
 export interface NoteReply {
     id: string;
     content: string;