fika-editor 3.0.25 → 3.0.27

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

@@ -58,6 +58,16 @@ export interface FikaLayout {
 /** Strip one or more leading bullet/number markers from a list item. */
 export declare function stripLeadingListMarkers(raw: string): string;
 type Slots = Record<string, unknown>;
+/** Natural (intrinsic) pixel size of a bitmap, when the host or the probe knows it. */
+export interface ImageNaturalSize {
+    width: number;
+    height: number;
+}
+/**
+ * Best-effort natural size of a bitmap. Browser only; resolves `undefined`
+ * on error or after `timeoutMs` so a slow CDN never blocks slide creation.
+ */
+export declare function probeImageNaturalSize(src: string, timeoutMs?: number): Promise<ImageNaturalSize | undefined>;
 export declare const PPTX_LAYOUTS: FikaLayout[];
 export declare function listLayouts(): FikaLayout[];
 /**

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

@@ -7,6 +7,8 @@ import type { FikaLayout, FikaLayoutBackgroundMode } from './layouts';
 import type { FikaStyleMotif, FikaStyleSummary } from './styles';
 import type { CompositionAnchor, CompositionPlan, CompositionSlideHint } from './composition';
 import type { FikaAgenticDocs, FikaCommandDescription, FikaDesignGuide, FikaDomainSummary } from './manifestDocs';
+import type { TextRunStyle } from '../../utils/markdown';
+export type { TextRunStyle } from '../../utils/markdown';
 export type { FikaAgenticDocs, FikaCommandDescription, FikaCommandDoc, FikaDesignGuide, FikaDesignSystem, FikaDocParam, FikaDomainDoc, FikaDomainSummary } from './manifestDocs';
 export type { FikaTemplateSummary, FikaTemplateSlideEntry, FikaTemplateSlidesCatalog, FikaTemplateSlidesCatalogResult } from './templates';
 export type { FikaLayout, FikaLayoutSlotDef, FikaLayoutBackgroundMode, FikaLayoutVariant } from './layouts';
@@ -317,6 +319,8 @@ export interface FikaCreateTextInput {
     content?: string;
     /** Markdown content; converted to HTML by the bridge. */
     markdown?: string;
+    /** Run style (fontSize / fontName / color / bold / align) applied to `markdown`. */
+    style?: TextRunStyle;
     element?: Partial<PPTTextElement>;
     select?: boolean;
 }
@@ -742,9 +746,10 @@ export interface FikaAgentTextApi {
     setContent(elementId: string, content: string, meta?: FikaCommandMeta & {
         slideId?: string;
     }): Promise<FikaCommandResult<PPTTextElement>>;
-    /** Replace content from a Markdown string (converted to HTML). */
+    /** Replace content from a Markdown string (converted to HTML), optionally with a run `style`. */
     setMarkdown(elementId: string, markdown: string, meta?: FikaCommandMeta & {
         slideId?: string;
+        style?: TextRunStyle;
     }): Promise<FikaCommandResult<PPTTextElement>>;
     updateContent(elementId: string, update: FikaTextContentUpdateInput, meta?: FikaCommandMeta & {
         slideId?: string;
@@ -1429,6 +1434,7 @@ export interface FikaCommandPayloadMap {
         elementId: string;
         slideId?: string;
         markdown: string;
+        style?: TextRunStyle;
     };
     'text.updateContent': {
         elementId: string;

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

@@ -10,5 +10,12 @@ export declare const getCodeRaster: (element: PPTCodeElement, invalidate: () =>
  * cannot load the MathLive web fonts.
  */
 export declare const getLatexRaster: (element: PPTLatexElement, invalidate: () => void) => Raster | undefined;
+/**
+ * Typeset inline/display math at the painted font size and snapshot it.
+ * The booth is `.fika-embed-root` so scoped MathLive CSS applies; a white
+ * or empty capture falls back to readable TeX-ish text instead of a gap.
+ */
+export declare const getInlineMathRaster: (latex: string, fontSize: number, color: string, display: boolean, invalidate: () => void) => Raster | undefined;
+export declare const hasPendingRasters: () => boolean;
 export declare const clearSlideRasterResources: () => void;
 export {};

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

@@ -23,6 +23,7 @@ export type CanvasTextPaintOptions = {
         blur: number;
         color: string;
     };
+    invalidate?: () => void;
 };
 /**
  * Paint ProseMirror HTML without mounting DOM. Pretext owns Unicode-aware

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

@@ -0,0 +1,10 @@
+/** Canonical class on typeset math wrappers. Kept here so text-fit can stay MathLive-free. */
+export declare const MATH_CLASS = "fika-math";
+export declare function htmlHasFikaMath(html: string): boolean;
+/** Readable stand-in when a math raster has not arrived yet. Never leave a blank chip. */
+export declare function latexFallbackText(latex: string): string;
+/** Fallback box when MathLive is not loaded yet — wide enough to reserve wrap space. */
+export declare function estimateInlineMathBox(latex: string, fontSize: number, display: boolean): {
+    width: number;
+    height: number;
+};

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

@@ -50,3 +50,23 @@ export declare function ensureInlineMathReady(): Promise<void>;
  * read as literal text.
  */
 export declare function renderInlineMarkdown(markdown: string): string;
+/** Typographic run style applied on top of Markdown-rendered HTML. */
+export interface TextRunStyle {
+    /** Font size in px (the deck's canvas px). */
+    fontSize?: number;
+    /** CSS font-family name, e.g. "Calibri". */
+    fontName?: string;
+    /** CSS color (hex / rgb). */
+    color?: string;
+    bold?: boolean;
+    align?: 'left' | 'center' | 'right' | 'justify';
+}
+/**
+ * Apply one run style (size / font / color / bold / align) to Markdown output
+ * so agents get styled copy from `text.create({ markdown, style })` without
+ * hand-writing `<span style>` HTML. Parses the HTML with parse5, wraps each
+ * block's inline content in a single styled span (the shape the editor and
+ * the pptx importer produce) and mirrors size / color onto list containers so
+ * bullet markers match.
+ */
+export declare function applyTextRunStyle(htmlText: string, style: TextRunStyle | undefined): string;

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

@@ -12,7 +12,7 @@
  * `fonts.css`) is lazy-loaded the first time math actually appears or an editor
  * opens, so decks without math never pull it into the bundle.
  */
-export declare const MATH_CLASS = "fika-math";
+export { MATH_CLASS, estimateInlineMathBox, htmlHasFikaMath } from './inlineMathBox';
 type ConvertLatexToMarkup = (latex: string, options?: {
     defaultMode?: 'inline-math' | 'math' | 'text';
 }) => string;
@@ -26,6 +26,7 @@ interface MathliveModule {
     MathfieldElement: {
         fontsDirectory: string | null;
         soundsDirectory: string | null;
+        stylesheetScope: string | null;
     };
 }
 /**
@@ -86,6 +87,19 @@ export declare const LATEX_ELEMENT_FONT_SIZE = 36;
  * inline math — not the old hfmath stroke paths.
  */
 export declare function renderLatexElementHtml(latex: string): string;
+/**
+ * Sync natural box of inline/display math at `fontSize`. Returns null until
+ * MathLive can typeset; callers should fall back to {@link estimateInlineMathBox}.
+ */
+export declare function measureInlineMathBox(latex: string, fontSize: number, display?: boolean): {
+    width: number;
+    height: number;
+} | null;
+/** Measured box when MathLive is ready, otherwise a conservative estimate. */
+export declare function inlineMathBox(latex: string, fontSize: number, display?: boolean): {
+    width: number;
+    height: number;
+};
 /** Natural box of a formula at {@link LATEX_ELEMENT_FONT_SIZE}, plus padding. */
 export declare function measureLatexElement(latex: string): Promise<{
     width: number;
@@ -101,4 +115,3 @@ export declare function deckHasMath(slides: ReadonlyArray<{
 export declare function ensureMathStylesForSlides(slides: ReadonlyArray<{
     elements?: ReadonlyArray<unknown>;
 }>): void;
-export {};

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

@@ -5,6 +5,13 @@ export declare function setFikaPortalTarget(target: HTMLElement | null): void;
 export declare function clearFikaPortalTarget(target: HTMLElement): void;
 /** Overlay mount for the standalone app. Never document.body — that is the page, not Fika. */
 export declare function ensureAppPortalRoot(): HTMLElement;
+/**
+ * Parent for offscreen work nodes (MathLive probes, raster stages). The embed
+ * stylesheet is scoped under `.fika-embed-root`, so a node hung off
+ * `document.body` would paint without MathLive/ProseMirror rules (fractions
+ * collapse to a flat run). Mount inside the embed root when there is one.
+ */
+export declare function resolveOffscreenHost(): HTMLElement;
 export declare function getFikaPortalTarget(): HTMLElement;
 /**
  * Resolve the portal target for a *specific* embed instance.

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

@@ -31,6 +31,13 @@ export interface TextFitRun {
     strikethrough?: boolean;
     color?: string;
     fontFamily?: string;
+    /** Authored TeX from `span.fika-math[data-latex]` — painted as a raster chip. */
+    mathLatex?: string;
+    mathDisplay?: boolean;
+    /** Chip width at authored `size` (not yet fit-scaled). */
+    extraWidth?: number;
+    /** Chip height at authored `size` (fractions are taller than the font). */
+    mathHeight?: number;
 }
 /** A single measurable text block (one paragraph or one list item). */
 export interface TextFitBlock {
@@ -120,6 +127,22 @@ export declare function innerBoxFromLiveStyles(box: HTMLElement | null | undefin
 };
 export declare function contentBoxOfHost(host: HTMLElement | null | undefined): HTMLElement | null;
 export declare function measureUnzoomedScrollHeight(host: HTMLElement, innerWidth: number): number;
+/** Line-box size for a run: math chips use the typeset height, not the font. */
+export declare const runVisualSize: (run: TextFitRun) => number;
+/**
+ * Stand-in grapheme for a math chip. pretext drops items whose text is empty
+ * or whitespace-only, so a chip must carry one real `text`-kind grapheme to
+ * exist in the flow; its glyph advance is subtracted from `extraWidth` so the
+ * item occupies exactly the chip width.
+ */
+export declare const MATH_PLACEHOLDER = "\uFFFC";
+export declare const richInlineFromRun: (run: TextFitRun, font: string, sizeScale: number, letterSpacing?: number) => {
+    text: string;
+    font: string;
+    letterSpacing?: number;
+    break?: 'never';
+    extraWidth?: number;
+};
 export declare function measureTextBlocksHeight(blocks: TextFitBlock[], options: MeasureBlocksOptions): number;
 export interface FitFontScaleOptions {
     innerWidth: number;
@@ -149,6 +172,7 @@ export type FitMeasureSession = {
     key: string;
     lineHeight: number;
     maxFont: number;
+    letterSpacing?: number;
     items: Array<{
         block: TextFitBlock;
         size: number;
@@ -183,6 +207,8 @@ type FitScaleOptions = {
     letterSpacing?: number;
     blockSpace?: number;
     locale?: string;
+    /** Pre-extracted blocks (e.g. after MathLive refined math chip sizes). */
+    blocks?: TextFitBlock[];
 };
 /**
  * Persist a DOM-verified correction: the editor measured the REAL rendered
@@ -195,6 +221,11 @@ export declare function rememberFitScale(html: string, options: FitScaleOptions,
  * cached session; preview/export call this so they shrink with the same math.
  */
 export declare function textFitScaleForHtml(html: string, options: FitScaleOptions): number;
+/** Replace estimated math chip boxes with a real typeset measure. */
+export declare function applyMeasuredMathBoxes(blocks: TextFitBlock[], measure: (latex: string, fontSize: number, display: boolean) => {
+    width: number;
+    height: number;
+} | null): void;
 export interface ExtractedContent {
     blocks: TextFitBlock[];
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fika-editor",
-  "version": "3.0.25",
+  "version": "3.0.27",
   "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.6",
+    "mathlive": "npm:@lofcz/mathlive@^0.110.8",
     "mathml2omml-plus": "^0.6.4",
     "mermaid": "^11.17.0",
     "mitt": "^3.0.1",