fika-editor 3.2.8 → 3.2.9

package/dist/embed/agentic-manifest.json

@@ -1,10 +1,10 @@
 {
   "schemaVersion": 2,
   "package": "fika-editor",
-  "packageVersion": "3.2.8",
-  "generatedAt": "2026-09-20T23:23:04.016Z",
+  "packageVersion": "3.2.9",
+  "generatedAt": "2026-09-21T15:54:48.564Z",
   "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,
+  "commandCount": 199,
   "designSystem": {
     "summary": "Fika lays elements out in a fixed pixel coordinate space, not inches. Prefer the styles + layouts flow (deck.applyStyle + slides.createFromLayout) so colors, contrast, fonts and layout are chosen for you instead of hand-picked. Host-registered templates (deck.applyTemplate + slides.insertFromTemplate) are optional when the embed host supplies them. These tokens describe the *fallback* defaults for manual placement only.",
     "coordinateSystem": {
@@ -58,7 +58,7 @@
   "domains": [
     {
       "id": "deck",
-      "commandCount": 14,
+      "commandCount": 16,
       "title": "Deck",
       "summary": "Whole-document state: title, theme, viewport, templates, plus full get/set/patch.",
       "whenToUse": "Apply a style with deck.setup / deck.applyStyle up front; set the viewport once; use whole-document import/export at persistence boundaries."
@@ -328,6 +328,42 @@
         ]
       }
     },
+    {
+      "name": "deck.listDesignThemes",
+      "domain": "deck",
+      "payload": "undefined",
+      "returns": "Array<{ id: string; name: string; background: string; fontColor: string; colors: string[] }>",
+      "doc": {
+        "summary": "Read the active host-provided design picker catalog (Fika defaults when the host supplies none). Read-only; IDs may be passed directly to deck.applyDesignTheme.",
+        "examples": [
+          "controller.deck.listDesignThemes()"
+        ]
+      }
+    },
+    {
+      "name": "deck.applyDesignTheme",
+      "domain": "deck",
+      "payload": "{ themeId: string }",
+      "returns": "{ themeId: string; name: string; slideCount: number }",
+      "doc": {
+        "summary": "Apply a design from the active host catalog to the entire existing deck in one undoable command, using the same implementation as the design picker.",
+        "params": [
+          {
+            "name": "themeId",
+            "type": "string",
+            "required": true,
+            "description": "Exact ID from deck.listDesignThemes or host-provided live deck context."
+          }
+        ],
+        "examples": [
+          "controller.deck.applyDesignTheme('scio-blue')"
+        ],
+        "tips": [
+          "When host IDs are already in context, apply the requested theme directly without a catalog/read call.",
+          "Preserves slide IDs and content; changes backgrounds, fonts, colors and chart palettes. Never use deck.setup to restyle an existing deck."
+        ]
+      }
+    },
     {
       "name": "deck.getTheme",
       "domain": "deck",