fika-editor 3.2.9 → 3.3.0

package/dist/embed/agentic-manifest.json

@@ -1,10 +1,10 @@
 {
   "schemaVersion": 2,
   "package": "fika-editor",
-  "packageVersion": "3.2.9",
-  "generatedAt": "2026-09-21T15:54:48.564Z",
+  "packageVersion": "3.3.0",
+  "generatedAt": "2026-09-22T07:56:27.484Z",
   "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": 199,
+  "commandCount": 201,
   "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": {
@@ -56,6 +56,13 @@
     }
   },
   "domains": [
+    {
+      "id": "canvas",
+      "commandCount": 2,
+      "title": "Canvas workspace",
+      "summary": "Bounded context for freeform multi-page design work.",
+      "whenToUse": "Read before targeted canvas edits; existing slide/element commands edit pages and artwork."
+    },
     {
       "id": "deck",
       "commandCount": 16,
@@ -237,6 +244,30 @@
     }
   ],
   "commands": [
+    {
+      "name": "canvas.apply",
+      "domain": "canvas",
+      "payload": "{ operations: FikaCanvasOperation[] }",
+      "returns": "FikaCanvasApplyResult",
+      "doc": {
+        "summary": "Create or edit a canvas using up to 100 compact operations in one undoable transaction.",
+        "details": "Operations: title, viewport, page, pageUpdate, text, shape, element, update, remove. Explicit page and element IDs allow references later in the same call. Text uses Markdown and fixed-size boxes. Rich native elements and frames use element/update. The first page operation replaces an untouched unnamed empty starter. Failure rolls back the entire call. Returns only operation names and IDs, never image data or complete elements."
+      }
+    },
+    {
+      "name": "canvas.get",
+      "domain": "canvas",
+      "payload": "{ pageId?: string; offset?: number; limit?: number; textLimit?: number }",
+      "returns": "FikaCanvasContext",
+      "optional": true,
+      "doc": {
+        "summary": "Read a compact canvas overview and one page of element summaries. No image bytes or full HTML.",
+        "details": "Defaults to active page, 40 elements, 160 text characters. At most 100 elements and 500 text characters per item. Use nextOffset to paginate. Mutate with existing slides/elements/text/shapes commands; batch related edits into one undoable operation. slides.update accepts canvasName, canvasPosition, guides, and workspaceLabels; elements.update accepts parentFrameId, and shapes accept frame.clipContent.",
+        "examples": [
+          "{\"type\":\"canvas.get\",\"payload\":{\"limit\":30}}"
+        ]
+      }
+    },
     {
       "name": "deck.get",
       "domain": "deck",
@@ -619,8 +650,8 @@
       "payload": "{ size?: number; ratio?: number }",
       "returns": "FikaBridgeState",
       "doc": {
-        "summary": "Set the canvas size/aspect ratio. size is the canvas width in px; ratio is height/width.",
-        "details": "Default is { size: 1000, ratio: 0.5625 } (16:9, 1000 x 562.5 px). Use ratio 0.75 for 4:3.",
+        "summary": "Resize the canvas and fit all slide content in one undoable operation. size is the canvas width in px; ratio is height/width.",
+        "details": "Default is { size: 1000, ratio: 0.5625 } (16:9, 1000 x 562.5 px). Use ratio 0.75 for 4:3. Content and type scale together; empty gutters adapt, groups stay together and images retain their proportions. For raw document import, use deck.patch with slides and viewport instead.",
         "examples": [
           "controller.deck.setViewport({ size: 1000, ratio: 0.5625 })"
         ],
@@ -2501,6 +2532,9 @@
     "FikaAudioSourceInput": "export type FikaAudioSourceInput = FikaMediaAssetInput",
     "FikaAudioTransformPatch": "export type FikaAudioTransformPatch = Pick<FikaElementTransformPatch, 'left' | 'top' | 'width' | 'height' | 'rotate'>",
     "FikaBridgeState": "export interface FikaBridgeState { title: string; slideIndex: number; slideCount: number; currentSlideId?: string; selectedSlideIndexes: number[]; selectedElementIds: string[]; handleElementId: string; activeGroupElementId: string; hiddenElementIds: string[]; viewportSize: number; viewportRatio: number; canvasScale: number; canvasPercentage: number; screening: boolean; canUndo: boolean; canRedo: boolean; documentVersion: number; locale?: Locales }",
+    "FikaCanvasApplyResult": "export interface FikaCanvasApplyResult { results: Array<{ op: FikaCanvasOperation['op']; id?: string; pageId?: string }> }",
+    "FikaCanvasContext": "export interface FikaCanvasContext { viewport: { width: number; height: number }; activePageId?: string; selectedIds: string[]; pageCount: number; pages: Array<{ id: string; name?: string; x: number; y: number; elementCount: number }>; pageId?: string; elementCount: number; offset: number; nextOffset?: number; elements: Array<{ id: string; type: string; name?: string; x: number; y: number; width: number; height?: number; parentFrameId?: string; groupId?: string; frame?: { clipContent: boolean }; text?: string }> }",
+    "FikaCanvasOperation": "export type FikaCanvasOperation = { op: 'title'; title: string } | { op: 'viewport'; width: number; height: number } | { op: 'page'; id?: string; name?: string; x?: number; y?: number; background?: string } | { op: 'pageUpdate'; id: string; patch: Partial<Slide> } | { op: 'text'; pageId?: string; id?: string; x: number; y: number; width: number; height: number; text: string; fontSize?: number; fontName?: string; color?: string; bold?: boolean; align?: 'left' | 'center' | 'right' | 'justify' } | { op: 'textUpdate'; pageId?: string; id: string; text: string; style?: TextRunStyle } | { op: 'shape'; pageId?: string; id?: string; x: number; y: number; width: number; height: number; shape: 'rect' | 'ellipse'; fill?: string } | { op: 'element'; pageId?: string; element: Partial<PPTElement> & { type: PPTElement['type'] } } | { op: 'update'; pageId?: string; id: string; patch: Partial<PPTElement> } | { op: 'remove'; pageId?: string; id: string }",
     "FikaChartElementPatch": "export interface FikaChartElementPatch { chartType?: ChartType; data?: ChartData; options?: ChartOptions; fill?: PPTChartElement['fill']; outline?: Partial<NonNullable<PPTChartElement['outline']>>; themeColors?: string[]; textColor?: string; lineColor?: string }",
     "FikaCreateAudioInput": "export interface FikaCreateAudioInput extends FikaAudioElementPatch { id?: string; source?: FikaAudioSourceInput; slideId?: string; index?: number; select?: boolean }",
     "FikaCreateChartInput": "export type FikaCreateChartInput = FikaChartElementPatch & Partial<Pick<PPTChartElement, 'id' | 'left' | 'top' | 'width' | 'height' | 'rotate'>> & { slideId?: string; index?: number; select?: boolean }",
@@ -2612,7 +2646,7 @@
     "NoteReply": "export interface NoteReply { id: string; content: string; time: number; user: string }",
     "PPTAnimation": "export interface PPTAnimation { id: string; elId: string; effect: string; type: AnimationType; duration: number; trigger: AnimationTrigger }",
     "PPTAudioElement": "export interface PPTAudioElement extends PPTBaseElement { type: 'audio'; fixedRatio: boolean; color: string; loop: boolean; autoplay: boolean; src: string; poster?: string; ext?: string }",
-    "PPTBaseElement": "interface PPTBaseElement { id: string; left: number; top: number; lock?: boolean; groupId?: string; width: number; height: number; rotate: number; link?: PPTElementLink; name?: string; source?: ElementSource; effects?: PPTElementEffects }",
+    "PPTBaseElement": "interface PPTBaseElement { parentFrameId?: string; id: string; left: number; top: number; lock?: boolean; groupId?: string; width: number; height: number; rotate: number; link?: PPTElementLink; name?: string; source?: ElementSource; effects?: PPTElementEffects }",
     "PPTChartElement": "export interface PPTChartElement extends PPTBaseElement { type: 'chart'; fill?: string; chartType: ChartType; data: ChartData; options?: ChartOptions; outline?: PPTElementOutline; themeColors: string[]; textColor?: string; lineColor?: string }",
     "PPTCodeElement": "export interface PPTCodeElement extends PPTBaseElement { type: 'code'; code: string; language: string; theme: string; fontSize: number; showLineNumbers: boolean }",
     "PPTElement": "export type PPTElement = PPTTextElement | PPTImageElement | PPTShapeElement | PPTLineElement | PPTChartElement | PPTTableElement | PPTLatexElement | PPTMermaidElement | PPTCodeElement | PPTVideoElement | PPTAudioElement",
@@ -2620,22 +2654,23 @@
     "PPTElementLink": "export interface PPTElementLink { type: ElementLinkType; target: string }",
     "PPTElementOutline": "export interface PPTElementOutline { style?: LineStyleType; width?: number; color?: string; radius?: number }",
     "PPTElementShadow": "export interface PPTElementShadow { h: number; v: number; blur: number; color: string }",
-    "PPTImageElement": "export interface PPTImageElement extends PPTBaseElement { type: 'image'; fixedRatio: boolean; src: string; outline?: PPTElementOutline; filters?: ImageElementFilters; clip?: ImageElementClip; flipH?: boolean; flipV?: boolean; shadow?: PPTElementShadow; radius?: number; colorMask?: string; imageType?: ImageType }",
+    "PPTImageElement": "export interface PPTImageElement extends PPTBaseElement { type: 'image'; fixedRatio: boolean; src: string; outline?: PPTElementOutline; filters?: ImageElementFilters; clip?: ImageElementClip; flipH?: boolean; flipV?: boolean; shadow?: PPTElementShadow; radius?: number; colorMask?: string; imageType?: ImageType; qrCode?: { text: string; errorCorrection: 'L' | 'M' | 'Q' | 'H'; foreground: string; background: string }; photoFrame?: { layout: string; cell: number; gutter: number; empty: boolean; sourceWidth?: number; sourceHeight?: number } }",
     "PPTLatexElement": "export interface PPTLatexElement extends PPTBaseElement { type: 'latex'; latex: string; path: string; color: string; strokeWidth: number; viewBox: [number, number]; fixedRatio: boolean }",
     "PPTLineElement": "export interface PPTLineElement extends Omit<PPTBaseElement, 'height' | 'rotate'> { type: 'line'; start: [number, number]; end: [number, number]; style: LineStyleType; color: string; points: [LinePoint, LinePoint]; shadow?: PPTElementShadow; broken?: [number, number]; broken2?: [number, number]; broken2Direction?: Broken2LineDirection; curve?: [number, number]; cubic?: [[number, number], [number, number]] }",
     "PPTMermaidElement": "export interface PPTMermaidElement extends PPTBaseElement { type: 'mermaid'; code: string }",
-    "PPTShapeElement": "export interface PPTShapeElement extends PPTBaseElement { type: 'shape'; viewBox: [number, number]; path: string; fixedRatio: boolean; fill: string; gradient?: Gradient; pattern?: string; outline?: PPTElementOutline; opacity?: number; flipH?: boolean; flipV?: boolean; shadow?: PPTElementShadow; special?: boolean; text?: ShapeText; pathFormula?: ShapePathFormulasKeys; keypoints?: number[] }",
+    "PPTShapeElement": "export interface PPTShapeElement extends PPTBaseElement { frame?: { clipContent: boolean }; type: 'shape'; viewBox: [number, number]; path: string; fixedRatio: boolean; fill: string; gradient?: Gradient; pattern?: string; outline?: PPTElementOutline; opacity?: number; flipH?: boolean; flipV?: boolean; shadow?: PPTElementShadow; special?: boolean; text?: ShapeText; pathFormula?: ShapePathFormulasKeys; keypoints?: number[] }",
     "PPTTableElement": "export interface PPTTableElement extends PPTBaseElement { type: 'table'; outline: PPTElementOutline; theme?: TableTheme; colWidths: number[]; cellMinHeight: number; data: TableCell[][] }",
     "PPTTextElement": "export interface PPTTextElement extends PPTBaseElement { type: 'text'; content: string; defaultFontName: string; defaultColor: string; placeholder?: string; placeholderFontSize?: number; placeholderColor?: string; placeholderAlign?: TextAlign; placeholderBold?: boolean; placeholderItalic?: boolean; placeholderLayoutHeight?: number; outline?: PPTElementOutline; fill?: string; lineHeight?: number; wordSpace?: number; opacity?: number; shadow?: PPTElementShadow; paragraphSpace?: number; vertical?: boolean; textType?: TextType; inset?: TextInset; fixedHeight?: boolean; vAlign?: TextAlignVertical; structuredText?: StructuredTextBody }",
     "PPTVideoElement": "export interface PPTVideoElement extends PPTBaseElement { type: 'video'; src: string; autoplay: boolean; poster?: string; ext?: string }",
     "SectionTag": "export interface SectionTag { id: string; title?: string }",
     "ShapePathFormulasKeys": "export declare const enum ShapePathFormulasKeys { ROUND_RECT = \"roundRect\", ROUND_RECT_DIAGONAL = \"roundRectDiagonal\", ROUND_RECT_SINGLE = \"roundRectSingle\", ROUND_RECT_SAMESIDE = \"roundRectSameSide\", CUT_RECT_DIAGONAL = \"cutRectDiagonal\", CUT_RECT_SINGLE = \"cutRectSingle\", CUT_RECT_SAMESIDE = \"cutRectSameSide\", CUT_ROUND_RECT = \"cutRoundRect\", MESSAGE = \"message\", ROUND_MESSAGE = \"roundMessage\", L = \"L\", RING_RECT = \"ringRect\", PLUS = \"plus\", TRIANGLE = \"triangle\", PARALLELOGRAM_LEFT = \"parallelogramLeft\", PARALLELOGRAM_RIGHT = \"parallelogramRight\", TRAPEZOID = \"trapezoid\", BULLET = \"bullet\", INDICATOR = \"indicator\", DONUT = \"donut\", DIAGSTRIPE = \"diagStripe\" }",
     "ShapeText": "export interface ShapeText { content: string; defaultFontName: string; defaultColor: string; align: TextAlignVertical; lineHeight?: number; wordSpace?: number; paragraphSpace?: number; inset?: TextInset; type?: TextType; fixedHeight?: boolean }",
-    "Slide": "export interface Slide { id: string; elements: PPTElement[]; notes?: Note[]; remark?: string; background?: SlideBackground; animations?: PPTAnimation[]; turningMode?: TurningMode; sectionTag?: SectionTag; type?: SlideType; sourcePackageId?: string; skeleton?: boolean }",
+    "Slide": "export interface Slide { workspaceLabels?: WorkspaceLabel[]; canvasPosition?: { x: number; y: number }; canvasName?: string; id: string; elements: PPTElement[]; guides?: SlideGuide[]; notes?: Note[]; remark?: string; background?: SlideBackground; animations?: PPTAnimation[]; turningMode?: TurningMode; sectionTag?: SectionTag; type?: SlideType; sourcePackageId?: string; skeleton?: boolean }",
     "SlideBackground": "export interface SlideBackground { type: SlideBackgroundType; color?: string; image?: SlideBackgroundImage; gradient?: Gradient }",
     "SlideBackgroundImage": "export interface SlideBackgroundImage { src: string; size: SlideBackgroundImageSize }",
     "SlideBackgroundImageSize": "export type SlideBackgroundImageSize = 'cover' | 'contain' | 'repeat'",
     "SlideBackgroundType": "export type SlideBackgroundType = 'solid' | 'image' | 'gradient'",
+    "SlideGuide": "export interface SlideGuide { id: string; axis: 'x' | 'y'; position: number }",
     "SlideTemplate": "export interface SlideTemplate { name: string; id: string; cover: string; origin?: string }",
     "SlideTheme": "export interface SlideTheme { backgroundColor: string; themeColors: string[]; fontColor: string; fontName: string; outline: PPTElementOutline; shadow: PPTElementShadow; styleId?: string }",
     "SlideType": "export type SlideType = 'cover' | 'contents' | 'transition' | 'content' | 'end'",
@@ -2649,6 +2684,7 @@
     "TextAlignVertical": "export type TextAlignVertical = 'top' | 'middle' | 'bottom'",
     "TextInset": "export type TextInset = [number, number, number, number]",
     "TextType": "export type TextType = 'title' | 'subtitle' | 'content' | 'item' | 'itemTitle' | 'notes' | 'header' | 'footer' | 'partNumber' | 'itemNumber'",
-    "TurningMode": "export type TurningMode = 'no' | 'fade' | 'throughInk' | 'dissolve' | 'slideX' | 'slideY' | 'wipe' | 'reveal' | 'scale' | 'scaleReverse' | 'morph' | 'ripple' | 'doors' | 'flythrough' | 'slideX3D' | 'slideY3D' | 'rotate' | 'scaleY' | 'scaleX' | 'random'"
+    "TurningMode": "export type TurningMode = 'no' | 'fade' | 'throughInk' | 'dissolve' | 'slideX' | 'slideY' | 'wipe' | 'reveal' | 'scale' | 'scaleReverse' | 'morph' | 'ripple' | 'doors' | 'flythrough' | 'slideX3D' | 'slideY3D' | 'rotate' | 'scaleY' | 'scaleX' | 'random'",
+    "WorkspaceLabel": "export interface WorkspaceLabel { kind?: 'section' | 'comment'; width?: number; height?: number; pageIds?: string[]; resolved?: boolean; replies?: string[]; id: string; text: string; x: number; y: number; fontSize: number }"
   }
 }