fika-editor 3.0.24 → 3.0.26

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/utils/codeShapeTag.d.ts

@@ -0,0 +1,33 @@
+import type { PPTCodeElement } from '../types/slides';
+/**
+ * A .pptx has no code-block primitive, so a native code element travels as a
+ * text box whose shape name (`p:cNvPr@name`) carries this tag:
+ *
+ *     fika:code:<language>[:<theme>[:<lineNumbers 0|1>]]
+ *
+ * Fika writes it on export and python-pptx2's `add_code` writes it when a deck
+ * is authored server-side; the importer turns any shape carrying it back into a
+ * syntax-highlighted code element instead of a plain text box.
+ */
+export declare const CODE_SHAPE_NAME_PREFIX = "fika:code";
+export interface CodeShapeTag {
+    language: string;
+    theme: string;
+    showLineNumbers: boolean;
+}
+export declare function formatCodeShapeName(el: Pick<PPTCodeElement, 'language' | 'theme' | 'showLineNumbers'>): string;
+export declare function parseCodeShapeName(name: string | undefined | null): CodeShapeTag | null;
+/**
+ * Source lines from imported paragraph HTML: one `<p>` per line, `<br>` as a
+ * hard break inside a paragraph, entities decoded, whitespace kept verbatim.
+ */
+export declare function htmlToCodeLines(html: string): string[];
+/**
+ * Export paints line numbers as literal text (`" 1  code"`); when the tag says
+ * the gutter is on, peel it off so the numbers are not doubled on re-import.
+ */
+export declare function stripCodeLineNumberGutter(lines: string[]): string[];
+/** Imported paragraph HTML → code element source, honouring the tag's gutter flag. */
+export declare function importedCodeSource(html: string, tag: CodeShapeTag): string;
+/** The first run font size (pt) declared in imported paragraph HTML, scaled to px. */
+export declare function importedCodeFontSize(html: string, ratio: number): 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/package.json

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