fika-editor 3.0.22 → 3.0.23

package/dist/embed/agentic-manifest.json

@@ -1,8 +1,8 @@
 {
   "schemaVersion": 2,
   "package": "fika-editor",
-  "packageVersion": "3.0.22",
-  "generatedAt": "2026-09-04T11:46:18.784Z",
+  "packageVersion": "3.0.23",
+  "generatedAt": "2026-09-04T12:20:36.524Z",
   "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": {
@@ -95,7 +95,7 @@
       "id": "layouts",
       "commandCount": 1,
       "title": "Layouts",
-      "summary": "Compositional slide recipes (title, section, closing, bullets, twoColumn, imageText, imageFull, bigStat, quote, chart, comparison, cards, numbered), each with 1–4 visual VARIANTS that share slots but compose them differently (different anchor, background treatment, motif placement). layouts.catalog lists each layout's variants and content slots; slides.createFromLayout builds a themed, positioned slide from a layout id + variantId + slots.",
+      "summary": "Compositional slide recipes (title, section, closing, bullets, twoColumn, imageText, imageFull, bigStat, quote, chart, comparison, cards, numbered, diagram), each with 1–4 visual VARIANTS that share slots but compose them differently (different anchor, background treatment, motif placement). layouts.catalog lists each layout's variants and content slots; slides.createFromLayout builds a themed, positioned slide from a layout id + variantId + slots.",
       "whenToUse": "After deck.setup (or applyStyle + planComposition), once per slide. Pick the layout whose composition matches the slide's job, then pick the VARIANT whose anchor matches the planned anchor for that slide position (this is what keeps consecutive slides from looking identical). Fill its slots with content. The engine themes, positions and auto-fits text to each box, so focus on clear, concise content rather than exact character counts."
     },
     {
@@ -960,7 +960,8 @@
           "controller.elements.create({ slideId, element: { type:'text', left:40, top:40, width:920, height:90, rotate:0, content:'<p><span style=\"font-size:40px;color:#1F4E79\"><strong>Action title</strong></span></p>', defaultFontName:'Arial', defaultColor:'#1F4E79' } })"
         ],
         "tips": [
-          "Text font size lives in inline HTML styles inside content, not in a fontSize field."
+          "Text font size lives in inline HTML styles inside content, not in a fontSize field.",
+          "For a flowchart, mindmap, sequence or cycle use type:'mermaid' with the Mermaid source in `code` — do NOT assemble boxes and arrows from shapes + lines. slides.createFromLayout({ layoutId:'diagram', slots:{ title, code } }) titles the slide and fills the body. PlantUML (@startuml …) in the same `code` field is rendered by the host to an image."
         ],
         "related": [
           "text.create",
@@ -2312,7 +2313,7 @@
     "FikaLatexElementSizing": "export interface FikaLatexElementSizing { left?: number; top?: number; width?: number; height?: number; rotate?: number }",
     "FikaLayout": "export interface FikaLayout { id: string; label: string; summary: string; bestFor: string; feature: boolean; slots: FikaLayoutSlotDef[]; variants: FikaLayoutVariant[] }",
     "FikaLayoutBackgroundMode": "export type FikaLayoutBackgroundMode = 'auto' | 'feature' | 'plain'",
-    "FikaLayoutSlotDef": "export interface FikaLayoutSlotDef { name: string; type: 'text' | 'bullets' | 'image' | 'chart' | 'stats' | 'rows' | 'cards' | 'steps'; required: boolean; description: string }",
+    "FikaLayoutSlotDef": "export interface FikaLayoutSlotDef { name: string; type: 'text' | 'bullets' | 'image' | 'chart' | 'stats' | 'rows' | 'cards' | 'steps' | 'diagram'; required: boolean; description: string }",
     "FikaLayoutVariant": "export interface FikaLayoutVariant { id: string; label: string; anchor: CompositionAnchor; summary: string }",
     "FikaLineDirectionInput": "export type FikaLineDirectionInput = Broken2LineDirection | 'auto'",
     "FikaLineElementInput": "export type FikaLineElementInput = Partial<Pick<PPTLineElement, 'id' | 'left' | 'top' | 'width' | 'style' | 'color' | 'points' | 'shadow' | 'broken' | 'broken2' | 'broken2Direction' | 'curve' | 'cubic' | 'link' | 'name' | 'lock' | 'groupId'>> & Pick<PPTLineElement, 'start' | 'end'>",