fika-editor 3.0.18 → 3.0.20

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

@@ -0,0 +1,14 @@
+import type { Slide, SlideTheme } from '../../types/slides';
+import { type FikaStylePreset } from './styles';
+export declare const INHERITED_STYLE_ID = "inherited";
+/** True when the deck has authored content worth inheriting from. */
+export declare function deckHasAuthoredStyle(slides: Slide[]): boolean;
+/**
+ * Derive a preset from the slides that already exist. Returns `undefined`
+ * when there is too little authored content to read a style from.
+ *
+ * `canvasWidth` is the deck's viewport width; the returned scale is expressed
+ * in the layout engine's 1000px reference so `buildLayoutSlide` can rescale it
+ * for the actual canvas together with the built-in presets.
+ */
+export declare function inferStylePresetFromDeck(slides: Slide[], theme: Partial<SlideTheme> | undefined, canvasWidth: number): FikaStylePreset | undefined;

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

@@ -1,5 +1,5 @@
 import type { PPTChartElement, PPTImageElement, PPTShapeElement, PPTTableElement, PPTTextElement, Slide } from '../../types/slides';
-import type { FikaStylePreset } from './styles';
+import { type FikaStylePreset } from './styles';
 import type { CompositionAnchor } from './composition';
 /**
  * Un-normalized element inputs the builder emits. Typed as a discriminated

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

@@ -123,6 +123,15 @@ export declare function getStylePreset(id?: string | null): FikaStylePreset | un
 /** Resolve a usable preset, falling back to the default when id is missing/unknown. */
 export declare function resolveStylePreset(id?: string | null): FikaStylePreset;
 export declare function listStylePresets(): FikaStyleSummary[];
+/** Canvas width the preset type scales and motif sizes are authored for. */
+export declare const STYLE_REFERENCE_WIDTH = 1000;
+/**
+ * Rescale a preset's px-based type scale and motif for a canvas of `width`
+ * px. Presets are authored for the 1000px default viewport; an imported
+ * 1280px deck would otherwise get 22px body copy that reads 22% smaller than
+ * designed. Returns the same object when no scaling is needed.
+ */
+export declare function scaleStylePreset(preset: FikaStylePreset, width: number): FikaStylePreset;
 /**
  * Build the deck-theme patch for a preset. Sets the inheritable defaults that
  * manually-created elements pick up (`fontColor`, `fontName`, `backgroundColor`,

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

@@ -534,9 +534,14 @@ export interface FikaCreateFromLayoutInput {
     slots?: Record<string, unknown>;
     /**
      * 1-based slide number. Omit to append (or replace the blank starter / a duplicate title).
-     * 1…slideCount replaces that slide in place. slideCount+1 appends.
+     * 1…slideCount replaces that slide in place (or inserts before it with `mode: 'insert'`). slideCount+1 appends.
      */
     index?: number;
+    /**
+     * How an `index` inside 1…slideCount is applied: `replace` (default) rebuilds
+     * that slide; `insert` puts the new slide BEFORE it and shifts the rest right.
+     */
+    mode?: 'replace' | 'insert';
     select?: boolean;
     /** Force a feature (dark) or plain background; defaults to the layout's own preference. */
     backgroundMode?: FikaLayoutBackgroundMode;
@@ -554,6 +559,8 @@ export interface FikaCreateFromLayoutResult {
     replacedStarter?: boolean;
     /** True when an existing slide was overwritten in place. */
     replaced?: boolean;
+    /** True when the slide was inserted before `index` (`mode: 'insert'`), shifting later slides right. */
+    inserted?: boolean;
     elementIds: string[];
     textElementIds: string[];
 }

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

@@ -1,5 +1,6 @@
 export { mountFika, unmountFika } from './mount';
 export type { FikaController, FikaDocument, FikaHeaderMenuItem, FikaMountOptions, FikaMountResult, FikaDocumentLoader, FikaStarterPresentationOptions, FikaTemplateLoader, FikaTemplatePayload, FikaImportPptxOptions, FikaImportApplyMode, FikaViewMode, } from './types';
+export type { FikaDeckAtlasOptions, FikaDeckAtlasSheet, FikaDeckAtlasTile, FikaRenderSlideOptions, } from './render';
 export type { ExportTabId, FikaExportTabsConfig } from '../configs/exportTabs';
 export type { FikaExportMediaResolver } from '../configs/exportMediaResolver';
 export { createFikaMediaUploader, } from '../configs/mediaUpload';

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

@@ -0,0 +1,82 @@
+import type { Slide, SlideTheme } from '../types/slides';
+/**
+ * Offscreen slide rendering for hosts and agents.
+ *
+ * Both entry points paint Slide JSON straight to a canvas with the same
+ * painter the thumbnail rail uses, so the pixels match what the user sees
+ * (list markers, text-fit sizes, shapes) without cloning the live DOM.
+ */
+export interface FikaRenderSlideOptions {
+    /** Output width in CSS px. Height follows the deck ratio. Default 1280. */
+    width?: number;
+    /** Device pixel ratio multiplier for the backing store. Default 1. */
+    dpr?: number;
+    /**
+     * Upper bound on waiting for async resources (images, charts, LaTeX).
+     * Whatever has resolved by then is painted; the rest stays blank.
+     * Default 4000.
+     */
+    timeoutMs?: number;
+    /** Encoded image type. Default `image/png`. */
+    format?: 'image/png' | 'image/jpeg' | 'image/webp';
+    /** Encoder quality for lossy formats (0–1). Default 0.9. */
+    quality?: number;
+}
+export interface FikaDeckAtlasOptions extends Omit<FikaRenderSlideOptions, 'width'> {
+    /** Width of one slide tile in CSS px. Default 640. */
+    tileWidth?: number;
+    /** Tiles per row. Default 3. */
+    columns?: number;
+    /** Slides per sheet; long decks split into several sheets. Default 12. */
+    maxPerSheet?: number;
+    /** Only these slides (ids or 1-based indexes). Default: every slide. */
+    slides?: Array<string | number>;
+    /** Paint "1", "2", … in each tile's corner so the viewer can address slides. Default true. */
+    numbered?: boolean;
+    /** Sheet background. Default `#1F2937`. */
+    gutterColor?: string;
+}
+export interface FikaDeckAtlasTile {
+    slideId: string;
+    /** 1-based deck position. */
+    index: number;
+    row: number;
+    column: number;
+    /** Tile rectangle in sheet CSS px. */
+    left: number;
+    top: number;
+    width: number;
+    height: number;
+}
+export interface FikaDeckAtlasSheet {
+    blob: Blob;
+    width: number;
+    height: number;
+    columns: number;
+    rows: number;
+    tiles: FikaDeckAtlasTile[];
+}
+interface RenderTarget {
+    slide: Slide;
+    theme: SlideTheme;
+    viewportSize: number;
+    viewportRatio: number;
+}
+/** Render one slide to an encoded image. */
+export declare function renderSlideImage(target: RenderTarget, options?: FikaRenderSlideOptions): Promise<{
+    blob: Blob;
+    width: number;
+    height: number;
+}>;
+/**
+ * Render the deck as one or more contact sheets: numbered slide tiles on a
+ * neutral gutter, in reading order. One sheet holds up to `maxPerSheet`
+ * slides so a 30-slide deck yields three images rather than one unreadable one.
+ */
+export declare function renderDeckAtlas(deck: {
+    slides: Slide[];
+    theme: SlideTheme;
+    viewportSize: number;
+    viewportRatio: number;
+}, options?: FikaDeckAtlasOptions): Promise<FikaDeckAtlasSheet[]>;
+export {};

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

@@ -174,6 +174,21 @@ export interface FikaController extends FikaAgentApi {
     importPptx(data: File | Blob | ArrayBuffer, options?: FikaImportPptxOptions): Promise<boolean>;
     setTitle(title: string): void;
     setLocale(locale: Locales): Promise<void>;
+    /**
+     * Paint one slide offscreen (thumbnail painter, no DOM capture) and return
+     * the encoded image. Defaults to the current slide.
+     */
+    renderSlide(slideIdOrIndex?: FikaSlideReference, options?: import('./render').FikaRenderSlideOptions): Promise<{
+        blob: Blob;
+        width: number;
+        height: number;
+    } | null>;
+    /**
+     * Paint the whole deck as numbered contact sheets — what an agent should
+     * look at before editing an existing deck, or after its context was
+     * compacted. Long decks split across several sheets.
+     */
+    renderAtlas(options?: import('./render').FikaDeckAtlasOptions): Promise<import('./render').FikaDeckAtlasSheet[]>;
     goToSlide(slideIdOrIndex: FikaSlideReference): void;
     nextSlide(): void;
     previousSlide(): void;

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

@@ -1,3 +1,9 @@
+/**
+ * Prefer the live slideshow surface so host-app chrome (sidebars, cards)
+ * is not part of the fullscreen tree. `document.documentElement` is last
+ * resort — fullscreening the page keeps that chrome on screen.
+ */
+export declare function getFullscreenElement(): HTMLElement;
 export declare const enterFullscreen: () => void;
 export declare const exitFullscreen: () => void;
 export declare const isFullscreen: () => boolean;