fika-editor 3.0.25 → 3.0.26

package/dist/embed/agentic-manifest.json

@@ -1,8 +1,8 @@
 {
   "schemaVersion": 2,
   "package": "fika-editor",
-  "packageVersion": "3.0.25",
-  "generatedAt": "2026-09-04T13:39:48.041Z",
+  "packageVersion": "3.0.26",
+  "generatedAt": "2026-09-04T14:59:33.406Z",
   "summary": "Authoring guidance for the Fika agentic bridge. SLIDE NUMBERS START AT 1 everywhere: payload.index, result.data.slideIndex, screenshot.slideIndex, getState().slideIndex, selectedSlideIndexes, plan.slides[].index, and plan.loudIndex are the SAME 1-based number — never subtract or add 1. First slide = 1; last existing = slideCount; omit index to append; index === slideCount+1 also appends; 1 ≤ index ≤ slideCount on createFromLayout REPLACES that slide. The recommended way to build a deck from scratch: (1) ONE bootstrap call deck.setup({ styleId, slideCount, title? }) — applies the visual identity, returns the composition plan (anchors + loud slide), and optionally builds the title slide together; prefer this over separate styles.catalog / deck.applyStyle / deck.planComposition, then (2) for each slide pick a recipe + visual variant from layouts.catalog and add it with slides.createFromLayout({ layoutId, variantId, slots }), preferring a variant whose anchor matches the plan (when variantId is omitted the engine picks a filled/full-width match; an explicit variantId is kept). The engine themes, positions, sanitizes slot markers the layout already draws, AND auto-fits every text box (via responsive measurement) so content does not overflow, and it runs a deterministic QA pass on each slide (overlap / contrast / density / monotony) so you can fix issues in the same turn. Author slot content as Markdown/plain text or structured values (arrays for bullets, { labels, series } for charts) — never hand-written HTML. Host-registered templates (deck.applyTemplate + slides.insertFromTemplate) are optional when the embed host supplies them. Avoid blank slides.create / hand-placed elements unless no layout fits. Pair this with the machine schema (command payload/return types) in the same manifest.",
   "commandCount": 197,
   "designSystem": {
@@ -1303,8 +1303,8 @@
       "payload": "FikaCreateTextInput | undefined",
       "returns": "PPTTextElement",
       "doc": {
-        "summary": "Create a text element (manual placement). Author content as Markdown via `markdown` (recommended) or plain text via `content`.",
-        "details": "Pass `markdown` for formatted copy (the bridge converts it to the HTML Fika stores). Markdown supports inline math: $…$ (inline) and $$…$$ (display) typeset via MathML, so mix prose and formulas freely (e.g. 'Plocha je $\\pi r^2$'). `content` is treated as literal markup — pass plain text there, or intentional HTML only when you specifically want to render markup (e.g. a code snippet). Do NOT type raw HTML tags into `markdown`: they are escaped and appear as literal text (the bridge warns when it detects this). The fallback color/font come from defaultColor/defaultFontName.",
+        "summary": "Create a text element (manual placement). Author content as Markdown via `markdown` (recommended) plus an optional `style` (fontSize / fontName / color / bold / align), or plain text via `content`.",
+        "details": "Pass `markdown` for formatted copy (the bridge converts it to the HTML Fika stores) and `style` to set the run typography — this is how you match an existing deck's look (e.g. `style:{ fontSize:44, fontName:'Calibri', color:'#0F172A', bold:true }`) WITHOUT writing HTML. Markdown supports inline math: $…$ (inline) and $$…$$ (display) typeset via MathML, so mix prose and formulas freely (e.g. 'Plocha je $\\pi r^2$'). `content` is treated as literal markup — pass plain text there, or intentional HTML only when you specifically want to render markup (e.g. a code snippet). Do NOT type raw HTML tags into `markdown`: they are escaped and appear as literal text (the bridge warns when it detects this). The fallback color/font come from style, then defaultColor/defaultFontName.",
         "params": [
           {
             "name": "slideId",
@@ -1318,6 +1318,12 @@
             "required": false,
             "description": "Markdown content (recommended). Converted to HTML."
           },
+          {
+            "name": "style",
+            "type": "{ fontSize?: number; fontName?: string; color?: string; bold?: boolean; align?: 'left'|'center'|'right'|'justify' }",
+            "required": false,
+            "description": "Run style for the rendered Markdown: font size in canvas px, font family, color, bold, paragraph alignment. Use it to match the typography of neighbouring slides (read a sibling element's summary for its font/size/color) instead of hand-writing <span style> HTML into `content`."
+          },
           {
             "name": "content",
             "type": "string",
@@ -1333,11 +1339,12 @@
         ],
         "examples": [
           "controller.text.create({ slideId, markdown: '**Key finding:** treated group improved 18%', element: { left:520, top:130, width:440, height:300, rotate:0, defaultColor:'#2D2D2D' } })",
+          "controller.text.create({ slideId, markdown: 'Jak program běží', style: { fontSize:44, fontName:'Calibri', color:'#0F172A', bold:true }, element: { left:77, top:50, width:1126, height:56, rotate:0 } })",
           "controller.text.create({ slideId, markdown: '- First point\\n- Second point\\n- Third point', element:{ left:40, top:140, width:920, height:300, rotate:0 } })",
           "controller.text.create({ slideId, markdown: 'Vertically centered, never overflows', element:{ left:80, top:120, width:360, height:200, rotate:0, fixedHeight:true, vAlign:'middle' } })"
         ],
         "tips": [
-          "Prefer slides.insertFromTemplate for whole slides. Markdown flavor: markdown-it + markdown-it-texmath (KaTeX). Write Markdown, not HTML.",
+          "Prefer slides.insertFromTemplate for whole slides. Markdown flavor: markdown-it + markdown-it-texmath (KaTeX). Write Markdown + `style`, not HTML — `style` covers font, size, color, bold and alignment, which is everything needed to match hand-styled neighbouring slides.",
           "For a box that must stay a fixed size, set fixedHeight:true so the text auto-shrinks to fit instead of overflowing."
         ],
         "related": [
@@ -1383,13 +1390,14 @@
     {
       "name": "text.setMarkdown",
       "domain": "text",
-      "payload": "{ elementId: string; slideId?: string; markdown: string }",
+      "payload": "{ elementId: string; slideId?: string; markdown: string; style?: TextRunStyle }",
       "returns": "PPTTextElement",
       "doc": {
-        "summary": "Replace a text element's content from a Markdown string (converted to HTML).",
-        "details": "Author in Markdown. Raw HTML tags are escaped (they would render as literal text) and trigger a warning — use Markdown syntax instead.",
+        "summary": "Replace a text element's content from a Markdown string (converted to HTML), optionally with a run `style`.",
+        "details": "Author in Markdown. Raw HTML tags are escaped (they would render as literal text) and trigger a warning — use Markdown syntax instead. Pass `style` ({ fontSize, fontName, color, bold, align }) to keep or set the typography of the box; without it the element's default font/color apply.",
         "examples": [
-          "controller.text.setMarkdown(elementId, '- First point\\n- Second point\\n- Third point')"
+          "controller.text.setMarkdown(elementId, '- First point\\n- Second point\\n- Third point')",
+          "controller.text.setMarkdown(elementId, 'Nový nadpis', { style: { fontSize: 44, fontName: 'Calibri', color: '#0F172A', bold: true } })"
         ],
         "related": [
           "text.setContent",
@@ -2263,7 +2271,188 @@
       ]
     }
   ],
-  "layoutCheatsheet": [],
+  "layoutCheatsheet": [
+    {
+      "id": "title",
+      "slots": [
+        "title*:text",
+        "subtitle:text",
+        "eyebrow:text"
+      ],
+      "variants": [
+        "centered(centered)"
+      ]
+    },
+    {
+      "id": "section",
+      "slots": [
+        "title*:text",
+        "subtitle:text",
+        "eyebrow:text"
+      ],
+      "variants": [
+        "centered(centered)"
+      ]
+    },
+    {
+      "id": "closing",
+      "slots": [
+        "title*:text",
+        "subtitle:text",
+        "eyebrow:text"
+      ],
+      "variants": [
+        "centered(centered)"
+      ]
+    },
+    {
+      "id": "bullets",
+      "slots": [
+        "title*:text",
+        "bullets*:bullets",
+        "eyebrow:text",
+        "ordered:text"
+      ],
+      "variants": [
+        "standard(leftHeavy)",
+        "leftRail(leftHeavy)",
+        "rightRail(rightHeavy)"
+      ]
+    },
+    {
+      "id": "twoColumn",
+      "slots": [
+        "title*:text",
+        "leftHeading:text",
+        "leftBullets:bullets",
+        "leftBody:text",
+        "rightHeading:text",
+        "rightBullets:bullets",
+        "rightBody:text"
+      ],
+      "variants": [
+        "even(split)",
+        "leftWide(leftHeavy)",
+        "rightWide(rightHeavy)"
+      ]
+    },
+    {
+      "id": "imageText",
+      "slots": [
+        "title*:text",
+        "image:image",
+        "imageSide:text",
+        "bullets:bullets",
+        "body:text",
+        "caption:text"
+      ],
+      "variants": [
+        "imageRight(leftHeavy)",
+        "imageLeft(rightHeavy)"
+      ]
+    },
+    {
+      "id": "bigStat",
+      "slots": [
+        "stats:stats",
+        "stat:text",
+        "statLabel:text",
+        "title:text",
+        "body:text"
+      ],
+      "variants": [
+        "centered(centered)",
+        "edgeAligned(edgeAligned)"
+      ]
+    },
+    {
+      "id": "quote",
+      "slots": [
+        "quote*:text",
+        "attribution:text"
+      ],
+      "variants": [
+        "centered(centered)",
+        "leftHeavy(leftHeavy)"
+      ]
+    },
+    {
+      "id": "chart",
+      "slots": [
+        "title*:text",
+        "chartType:text",
+        "labels*:chart",
+        "series*:chart",
+        "legends:chart",
+        "caption:text"
+      ],
+      "variants": [
+        "full(split)",
+        "inset(centered)"
+      ]
+    },
+    {
+      "id": "comparison",
+      "slots": [
+        "title*:text",
+        "headers:rows",
+        "rows*:rows"
+      ],
+      "variants": [
+        "full(split)"
+      ]
+    },
+    {
+      "id": "cards",
+      "slots": [
+        "title*:text",
+        "cards*:cards",
+        "eyebrow:text"
+      ],
+      "variants": [
+        "grid(centered)",
+        "accentPanel(split)",
+        "leftOffset(leftHeavy)",
+        "rightOffset(rightHeavy)"
+      ]
+    },
+    {
+      "id": "numbered",
+      "slots": [
+        "title*:text",
+        "steps*:steps",
+        "eyebrow:text"
+      ],
+      "variants": [
+        "standard(leftHeavy)",
+        "rightRail(rightHeavy)"
+      ]
+    },
+    {
+      "id": "imageFull",
+      "slots": [
+        "image*:image",
+        "title*:text",
+        "subtitle:text"
+      ],
+      "variants": [
+        "fullBleed(fullBleed)"
+      ]
+    },
+    {
+      "id": "diagram",
+      "slots": [
+        "title*:text",
+        "code:diagram",
+        "kind:text",
+        "image:image",
+        "eyebrow:text"
+      ],
+      "variants": [
+        "standard(centered)"
+      ]
+    }
+  ],
   "helperTypes": {
     "FikaAnimationCatalog": "export interface FikaAnimationCatalog { enter: FikaAnimationPresetGroup[]; exit: FikaAnimationPresetGroup[]; attention: FikaAnimationPresetGroup[]; slide: FikaSlideAnimationPreset[] }",
     "FikaAnimationPreset": "export interface FikaAnimationPreset { name: string; value: string }",
@@ -2285,7 +2474,7 @@
     "FikaCreateLineElementInput": "export interface FikaCreateLineElementInput { slideId?: string; index?: number; element: FikaLineElementInput; select?: boolean }",
     "FikaCreateShapeInput": "export type FikaCreateShapeInput = FikaShapePatch & { slideId?: string; index?: number; select?: boolean; presetId?: string; categoryKey?: ShapeCategoryKey; presetIndex?: number; preset?: ShapePoolItem; element?: Partial<PPTShapeElement> }",
     "FikaCreateTableInput": "export type FikaCreateTableInput = FikaTableElementPatch & { id?: string; slideId?: string; index?: number; select?: boolean; element?: Partial<PPTTableElement> }",
-    "FikaCreateTextInput": "export interface FikaCreateTextInput { slideId?: string; index?: number; content?: string; markdown?: string; element?: Partial<PPTTextElement>; select?: boolean }",
+    "FikaCreateTextInput": "export interface FikaCreateTextInput { slideId?: string; index?: number; content?: string; markdown?: string; style?: TextRunStyle; element?: Partial<PPTTextElement>; select?: boolean }",
     "FikaDeckDocument": "export type FikaDeckDocument = Omit<FikaDocument, 'theme'> & { theme: SlideTheme; viewport: FikaDeckViewport; templates: SlideTemplate[] }",
     "FikaDeckInput": "export type FikaDeckInput = Omit<FikaDocument, 'theme'> & { theme?: FikaSlideThemePatch; viewport?: Partial<FikaDeckViewport>; templates?: SlideTemplate[] }",
     "FikaDeckPatch": "export interface FikaDeckPatch { title?: string; slides?: Slide[]; theme?: FikaSlideThemePatch; viewport?: Partial<FikaDeckViewport>; templates?: SlideTemplate[] }",
@@ -2362,7 +2551,8 @@
     "FikaVideoStylePatch": "export interface FikaVideoStylePatch { lock?: boolean; groupId?: string; name?: string; link?: PPTElementLink }",
     "ImageFilterKey": "type ImageFilterKey = keyof NonNullable<PPTImageElement['filters']>",
     "SlideReference": "type SlideReference = string | number",
-    "SlideSelectorPayload": "type SlideSelectorPayload = { slideId?: string; index?: number; slideIdOrIndex?: SlideReference }"
+    "SlideSelectorPayload": "type SlideSelectorPayload = { slideId?: string; index?: number; slideIdOrIndex?: SlideReference }",
+    "TextRunStyle": "export interface TextRunStyle { fontSize?: number; fontName?: string; color?: string; bold?: boolean; align?: 'left' | 'center' | 'right' | 'justify' }"
   },
   "modelTypes": {
     "AnimationTrigger": "export type AnimationTrigger = 'click' | 'meantime' | 'auto'",