fika-editor 3.0.37 → 3.0.39

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

@@ -0,0 +1,17 @@
+/**
+ * Geometry of a skeleton slide (`Slide.skeleton`): grey blocks standing in for
+ * a title, a few lines of body and a picture panel. Fractions of the slide
+ * box so the same shapes paint on the rail thumbnail, the live canvas and an
+ * offscreen `renderSlide`.
+ */
+export type SlideSkeletonBlock = {
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+};
+export declare const SLIDE_SKELETON_BLOCKS: readonly SlideSkeletonBlock[];
+/** Block fill; kept translucent so a themed slide background still reads through. */
+export declare const SLIDE_SKELETON_FILL = "rgba(30, 41, 59, 0.09)";
+/** Corner radius as a fraction of the slide width. */
+export declare const SLIDE_SKELETON_RADIUS = 0.008;

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

@@ -5,9 +5,16 @@ export declare const getMermaidRaster: (element: PPTMermaidElement, invalidate:
 export declare const getCodeRaster: (element: PPTCodeElement, invalidate: () => void) => Raster | undefined;
 /**
  * MathLive typeset of a formula element, mirroring `LatexContent`'s DOM
- * (flex-centered box, 36px stage scaled uniformly into the authored box).
+ * (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.
+ *
+ * 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.
  */
 export declare const getLatexRaster: (element: PPTLatexElement, invalidate: () => void) => Raster | undefined;
 /**

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

@@ -861,6 +861,7 @@ export declare const useSlidesStore: import("zustand").UseBoundStore<Omit<import
             };
             type?: import("../types/slides").SlideType;
             sourcePackageId?: string;
+            skeleton?: boolean;
         }[];
         slideIndex: number;
         viewportSize: number;
@@ -1643,6 +1644,7 @@ export declare const useSlidesStore: import("zustand").UseBoundStore<Omit<import
                 };
                 type?: import("../types/slides").SlideType;
                 sourcePackageId?: string;
+                skeleton?: boolean;
             }[];
             theme: {
                 backgroundColor?: string;
@@ -2480,6 +2482,7 @@ export declare const useSlidesStore: import("zustand").UseBoundStore<Omit<import
             };
             type?: import("../types/slides").SlideType;
             sourcePackageId?: string;
+            skeleton?: boolean;
         }[];
         slideIndex: number;
         viewportSize: number;
@@ -3262,6 +3265,7 @@ export declare const useSlidesStore: import("zustand").UseBoundStore<Omit<import
                 };
                 type?: import("../types/slides").SlideType;
                 sourcePackageId?: string;
+                skeleton?: boolean;
             }[];
             theme: {
                 backgroundColor?: string;

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

@@ -543,6 +543,10 @@ export type SlideType = 'cover' | 'contents' | 'transition' | 'content' | 'end';
  * remark?: speaker notes
  * turningMode?: transition
  * sourcePackageId?: retained PPTX package id (when imported from Office)
+ * skeleton?: the slide is a placeholder whose content is still being produced
+ *   (a host streaming a deck in). Painted as shimmering blocks in the rail and
+ *   on the canvas, not editable; cleared by the first `slides.update` that
+ *   omits or falsifies it.
  */
 export interface Slide {
     id: string;
@@ -555,6 +559,7 @@ export interface Slide {
     sectionTag?: SectionTag;
     type?: SlideType;
     sourcePackageId?: string;
+    skeleton?: boolean;
 }
 /**
  * Slide theme (background, accent colors, default font).

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

@@ -1,5 +1,5 @@
 import type { Slide } from '../types/slides';
-export type PaintedSlide = Pick<Slide, 'id' | 'elements' | 'background' | 'type'>;
+export type PaintedSlide = Pick<Slide, 'id' | 'elements' | 'background' | 'type' | 'skeleton'>;
 export type PaintedSlideDiff = {
     added: string[];
     removed: string[];

package/dist/types/views/components/SlideSkeleton/index.d.ts

@@ -0,0 +1,12 @@
+export type ISlideSkeletonProps = {
+    className?: string;
+    /** Swallow pointer gestures so the placeholder cannot be drawn on (live canvas). */
+    shield?: boolean;
+};
+/**
+ * Shimmering placeholder painted over a `Slide.skeleton` slide. Absolutely
+ * fills its positioned parent; block geometry is shared with the canvas
+ * painter so a thumbnail and a `renderSlide` capture agree.
+ */
+declare const SlideSkeleton: import("react").MemoExoticComponent<({ className, shield }: ISlideSkeletonProps) => import("react").JSX.Element>;
+export default SlideSkeleton;

package/docs/EMBED.md

@@ -148,6 +148,21 @@ if (createTitle.ok && createTitle.data) {
 await controller.slides.setRemark(createSlide.data.id, '<p>Teacher notes from the sciobot agent</p>')
 ```
 
+### Skeleton slides (streaming a deck in)
+
+A slide with `skeleton: true` is a placeholder for content that is still being produced. The rail thumbnail and the live canvas paint shimmering grey blocks over its background, the canvas refuses edits on it, and `renderSlide` paints the same blocks statically. Seed the whole deck up front with the ids you will later fill, then swap each one in place — a `slides.update` patch that carries `elements` (or `skeleton: false`) clears the flag:
+
+```ts
+await controller.setDocument({
+  title,
+  slides: outline.map(item => ({ id: item.id, elements: [], skeleton: true, background })),
+})
+
+// …as each slide finishes generating:
+await controller.slides.update(item.id, { elements, background, remark })
+controller.goToSlide(item.id)
+```
+
 ### Bridge subscriptions
 
 Subscribe once when the controller is mounted, then unsubscribe before replacing or destroying it. `documentChanged` is the best signal for persistence, while `commandFailed` is the best signal for agent telemetry:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fika-editor",
-  "version": "3.0.37",
+  "version": "3.0.39",
   "description": "Fika presentation editor embed bundle with a typed agentic bridge.",
   "type": "module",
   "main": "dist/embed/fika-embed.js",
@@ -109,7 +109,7 @@
     "lucide-react": "^1.33.0",
     "markdown-it": "^15.0.0",
     "markdown-it-texmath": "^1.0.0",
-    "mathlive": "npm:@lofcz/mathlive@^0.110.8",
+    "mathlive": "npm:@lofcz/mathlive@^0.110.9",
     "mathml2omml-plus": "^0.6.4",
     "mermaid": "^11.17.0",
     "mitt": "^3.0.1",