@lofcz/pptist 2.0.8 → 2.0.10

package/dist/embed/agentic-manifest.json

@@ -1,12 +1,12 @@
 {
   "schemaVersion": 2,
   "package": "@lofcz/pptist",
-  "packageVersion": "2.0.8",
-  "generatedAt": "2026-06-01T05:43:33.073Z",
-  "summary": "Authoring guidance for the PPTist agentic bridge: the coordinate system, a default design system, per-domain and per-command notes, and reusable slide composition recipes. Pair this with the machine schema (command payload/return types) in the same manifest.",
-  "commandCount": 169,
+  "packageVersion": "2.0.10",
+  "generatedAt": "2026-06-02T05:17:27.619Z",
+  "summary": "Authoring guidance for the PPTist agentic bridge. The fast, reliable way to build a deck: (1) pick ONE built-in presentation template (the same styles as the template picker — template_1 … template_8) with deck.applyTemplate, (2) read templates.slidesCatalog for that template's slide slugs grouped by type (cover, contents, transition, content, end), then (3) insert slides with slides.insertFromTemplate and edit text via text.setMarkdown. Do NOT build decks from blank slides.create or hand-placed elements unless no template slide fits. Content is Markdown or plain text — never hand-written HTML. Pair this with the machine schema (command payload/return types) in the same manifest.",
+  "commandCount": 173,
   "designSystem": {
-    "summary": "PPTist lays elements out in a fixed pixel coordinate space, not inches. Design against these tokens for clean, readable decks.",
+    "summary": "PPTist lays elements out in a fixed pixel coordinate space, not inches. Prefer built-in templates (deck.applyTemplate + slides.insertFromTemplate) so colors, contrast, fonts and layout come from the official template library instead of being hand-picked. These tokens describe the *fallback* defaults for manual placement only.",
     "coordinateSystem": {
       "summary": "The default 16:9 canvas is 1000 x 562.5 px (viewport.size = 1000, viewport.ratio = 0.5625). Origin (0,0) is the top-left corner. Every element has left, top, width, height in px and rotate in degrees.",
       "notes": [
@@ -14,11 +14,12 @@
         "Keep a 40px safe margin from every edge (left/top >= 40, and left+width <= 960, top+height <= 522 on the default canvas).",
         "Coordinates are absolute px, NOT inches/points. To port an inches-based layout, multiply inches by 100 (10in wide deck -> 1000px).",
         "rotate is clockwise degrees about the element center. Lines use start/end points instead of width/height/rotate.",
-        "Text size is controlled by inline styles inside the element's HTML content (e.g. <span style=\"font-size:40px\">), not by a top-level fontSize field. defaultColor/defaultFontName are only fallbacks."
+        "When you use slides.insertFromTemplate you do NOT compute coordinates or sizes — the template slide already has designed elements. The notes above only matter for manual element placement.",
+        "For manual text, write Markdown or plain text (text.create({ markdown }) / { content } as plain text). The engine stores text as HTML internally; you should not author raw HTML tags yourself (they are escaped and show as literal text). Per-run font sizing is an advanced manual concern — reach for a layout instead."
       ]
     },
     "tokens": {
-      "summary": "A neutral, presentation-safe default palette and type scale (px). Override per deck via deck.setTheme.",
+      "summary": "The neutral fallback palette/type scale (px) used when no template theme is applied. PREFER deck.applyTemplate (see templates.catalog) — each built-in template ships a full theme and designed slides. Override individual tokens with deck.setTheme only when a template is not enough.",
       "colors": {
         "background": "#FFFFFF",
         "primary": "#1F4E79",
@@ -47,10 +48,10 @@
   "domains": [
     {
       "id": "deck",
-      "commandCount": 7,
+      "commandCount": 8,
       "title": "Deck",
       "summary": "Whole-document state: title, theme, viewport, templates, plus full get/set/patch.",
-      "whenToUse": "Set the deck theme and viewport once up front; use whole-document import/export at persistence boundaries."
+      "whenToUse": "Apply a template theme with deck.applyTemplate up front; set the viewport once; use whole-document import/export at persistence boundaries."
     },
     {
       "id": "import",
@@ -66,12 +67,19 @@
       "summary": "Serializable JSON snapshot of the deck.",
       "whenToUse": "Persist/autosave from documentChanged events."
     },
+    {
+      "id": "templates",
+      "commandCount": 2,
+      "title": "Templates",
+      "summary": "Built-in presentation templates (template_1 … template_8 — same as the UI template picker). templates.catalog lists them; templates.slidesCatalog lists insertable slide slugs by type; deck.applyTemplate sets the deck theme.",
+      "whenToUse": "FIRST. Pick exactly one template style for the whole deck, apply its theme, then insert slides by slug. Never invent custom slide layouts when a template slide fits."
+    },
     {
       "id": "slides",
-      "commandCount": 17,
+      "commandCount": 18,
       "title": "Slides",
-      "summary": "Create, read, update, delete, duplicate, move, select slides; set background, transition and speaker remark.",
-      "whenToUse": "Add one slide per idea; capture the returned slide id and reuse it for every element you place on that slide."
+      "summary": "Insert slides from built-in templates (slides.insertFromTemplate); read, update, delete, duplicate, move, select; set background, transition and speaker remark.",
+      "whenToUse": "Prefer slides.insertFromTemplate (one call per slide). After insert, use text.setMarkdown on the returned element ids. Avoid slides.create for deck building."
     },
     {
       "id": "elements",
@@ -91,8 +99,8 @@
       "id": "text",
       "commandCount": 11,
       "title": "Text",
-      "summary": "Text element create/update plus content helpers. Accepts Markdown via text.create({ markdown }) and text.setMarkdown.",
-      "whenToUse": "Place titles, body copy and captions. Author content as HTML, or pass Markdown and let the bridge convert it."
+      "summary": "Text element create/update plus content helpers. Author content as Markdown (text.create({ markdown }) / text.setMarkdown) or plain text.",
+      "whenToUse": "For manual slides only — layouts already place titles, body and captions. Pass Markdown or plain text; do NOT write raw HTML tags (they are escaped and show as literal text). The literal-HTML path (text.setContent / { content }) is reserved for intentionally rendering code-like markup."
     },
     {
       "id": "lines",
@@ -106,7 +114,7 @@
       "commandCount": 3,
       "title": "Rich text",
       "summary": "Document-model edits to a text element's prose: set content, run styles and paragraph attributes.",
-      "whenToUse": "Use when you need paragraph alignment / inline run styling beyond raw HTML replacement."
+      "whenToUse": "Use when you need paragraph alignment / inline run styling on an existing text element."
     },
     {
       "id": "animations",
@@ -285,6 +293,78 @@
         ]
       }
     },
+    {
+      "name": "deck.applyTemplate",
+      "domain": "deck",
+      "payload": "{ templateId: string }",
+      "returns": "PptistApplyTemplateResult",
+      "doc": {
+        "summary": "Apply ONE built-in template theme to the whole deck (fonts, colors, background).",
+        "details": "Do this once, up front, before inserting slides. slides.insertFromTemplate also applies the theme automatically when the deck is still empty (default).",
+        "params": [
+          {
+            "name": "templateId",
+            "type": "string",
+            "required": true,
+            "description": "A built-in id from templates.catalog (e.g. 'template_1' for Crimson landscape)."
+          }
+        ],
+        "examples": [
+          "await controller.deck.applyTemplate('template_1')"
+        ],
+        "tips": [
+          "Keep one template style for the whole deck. Do not hand-pick colors or fonts on top of a template."
+        ],
+        "related": [
+          "templates.catalog",
+          "templates.slidesCatalog",
+          "slides.insertFromTemplate"
+        ]
+      }
+    },
+    {
+      "name": "templates.catalog",
+      "domain": "templates",
+      "payload": "undefined",
+      "returns": "PptistTemplateSummary[]",
+      "doc": {
+        "summary": "List built-in presentation templates (template_1 … template_8) with human-readable names — the same catalog as the template picker UI.",
+        "details": "Read this first. Each entry is a full designed theme (e.g. template_1 = Crimson landscape). Pick exactly one whose tone fits the audience, then apply it with deck.applyTemplate before inserting any slides.",
+        "examples": [
+          "const templates = controller.templates.catalog() // -> [{ id:'template_1', name:'Crimson landscape', ... }, ...]"
+        ],
+        "related": [
+          "deck.applyTemplate",
+          "templates.slidesCatalog"
+        ]
+      }
+    },
+    {
+      "name": "templates.slidesCatalog",
+      "domain": "templates",
+      "payload": "{ templateId: string }",
+      "returns": "PptistTemplateSlidesCatalogResult",
+      "doc": {
+        "summary": "List insertable slides for a template, grouped by type (cover, contents, transition, content, end) with slug + description.",
+        "details": "Call after choosing a templateId. Each slug (e.g. cover_1, content_2) maps to one designed slide in that template. Pick the slug whose description best matches the slide you need, then call slides.insertFromTemplate.",
+        "params": [
+          {
+            "name": "templateId",
+            "type": "string",
+            "required": true,
+            "description": "Built-in template id from templates.catalog."
+          }
+        ],
+        "examples": [
+          "const catalog = await controller.templates.slidesCatalog('template_1')",
+          "// catalog.byType.cover -> [{ slug:'cover_1', description:'...', ... }, ...]"
+        ],
+        "related": [
+          "slides.insertFromTemplate",
+          "templates.catalog"
+        ]
+      }
+    },
     {
       "name": "deck.setViewport",
       "domain": "deck",
@@ -378,6 +458,61 @@
         ]
       }
     },
+    {
+      "name": "slides.insertFromTemplate",
+      "domain": "slides",
+      "payload": "PptistInsertFromTemplateInput",
+      "returns": "PptistInsertFromTemplateResult",
+      "doc": {
+        "summary": "Insert a designed slide from a built-in template by slug. The PREFERRED way to add a slide.",
+        "details": "Clones the template slide (layout, decor, placeholder text boxes) into the deck. You do NOT pick coordinates or sizes. After insert, fill placeholders with text.setMarkdown on the returned elementIds. Do not use slides.create for normal deck building.",
+        "params": [
+          {
+            "name": "templateId",
+            "type": "string",
+            "required": true,
+            "description": "Built-in template id (same as deck.applyTemplate)."
+          },
+          {
+            "name": "slug",
+            "type": "string",
+            "required": true,
+            "description": "Slide slug from templates.slidesCatalog (e.g. 'cover_1', 'contents_1', 'content_3')."
+          },
+          {
+            "name": "index",
+            "type": "number",
+            "required": false,
+            "description": "Insert position; appends when omitted."
+          },
+          {
+            "name": "select",
+            "type": "boolean",
+            "required": false,
+            "description": "Select the new slide after insert (default true)."
+          },
+          {
+            "name": "applyTemplateTheme",
+            "type": "boolean",
+            "required": false,
+            "description": "Apply template theme when deck is empty (default true)."
+          }
+        ],
+        "examples": [
+          "await controller.slides.insertFromTemplate({ templateId:'template_1', slug:'cover_1' })",
+          "await controller.slides.insertFromTemplate({ templateId:'template_1', slug:'content_2', index:2 })"
+        ],
+        "tips": [
+          "Plan slide flow: cover → contents → content slides → end. Match slug descriptions from slidesCatalog.",
+          "After insert, batch text.setMarkdown calls for each placeholder element id returned."
+        ],
+        "related": [
+          "templates.slidesCatalog",
+          "deck.applyTemplate",
+          "text.setMarkdown"
+        ]
+      }
+    },
     {
       "name": "slides.insert",
       "domain": "slides",
@@ -498,8 +633,8 @@
       "payload": "{ slideId?: string; index?: number; element: Partial<PPTElement> & { type: PPTElement['type'] }; select?: boolean }",
       "returns": "PPTElement",
       "doc": {
-        "summary": "Create any element type on a slide. payload.element.type is required.",
-        "details": "Generic creator across all element types. For text you can use { type:'text', content } (HTML). Prefer the typed creators (text.create, shapes.create, charts.create, tables.create) for richer, validated input. Provide left/top/width/height in canvas px and rotate in degrees.",
+        "summary": "Create any element type on a slide (manual placement). payload.element.type is required.",
+        "details": "Generic creator across all element types, for bespoke slides a template can't express. Prefer slides.insertFromTemplate for whole slides, or the typed creators (text.create, shapes.create, charts.create, tables.create) for single elements. Provide left/top/width/height in canvas px and rotate in degrees. For text, pass Markdown via text.create instead of hand-writing HTML here.",
         "params": [
           {
             "name": "slideId",
@@ -751,8 +886,8 @@
       "payload": "PptistCreateTextInput | undefined",
       "returns": "PPTTextElement",
       "doc": {
-        "summary": "Create a text element. Accepts HTML via content, or Markdown via markdown (converted to HTML).",
-        "details": "If element.content or content (HTML) is given it wins; otherwise markdown is converted to HTML. Size text via inline styles in the HTML; use defaultColor for the fallback color.",
+        "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 PPTist stores). `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.",
         "params": [
           {
             "name": "slideId",
@@ -761,16 +896,16 @@
             "description": "Target slide."
           },
           {
-            "name": "content",
+            "name": "markdown",
             "type": "string",
             "required": false,
-            "description": "HTML content (wins over markdown)."
+            "description": "Markdown content (recommended). Converted to HTML."
           },
           {
-            "name": "markdown",
+            "name": "content",
             "type": "string",
             "required": false,
-            "description": "Markdown content; converted to HTML."
+            "description": "Literal content (plain text, or intentional HTML for code-like markup). Wins over markdown."
           },
           {
             "name": "element",
@@ -781,16 +916,16 @@
         ],
         "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, content:'<p><span style=\"font-size:40px;color:#1F4E79\"><strong>Methods</strong></span></p>', element:{ left:40, top:40, width:920, height:90, 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 } })"
         ],
         "tips": [
-          "Flavor: markdown-it + markdown-it-texmath (KaTeX)."
+          "Prefer slides.insertFromTemplate for whole slides. Markdown flavor: markdown-it + markdown-it-texmath (KaTeX). Write Markdown, not HTML."
         ],
         "related": [
           "text.setMarkdown",
           "text.setContent",
           "richText.setContent",
-          "elements.create"
+          "slides.insertFromTemplate"
         ]
       }
     },
@@ -818,7 +953,8 @@
       "payload": "{ elementId: string; slideId?: string; content: string }",
       "returns": "PPTTextElement",
       "doc": {
-        "summary": "Replace a text element's HTML content verbatim.",
+        "summary": "Replace a text element's content with a literal string (the literal-markup path).",
+        "details": "Use for plain text, or for intentionally rendering HTML markup (e.g. a code snippet). For normal formatted copy use text.setMarkdown instead.",
         "related": [
           "text.setMarkdown",
           "richText.setContent"
@@ -832,6 +968,7 @@
       "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.",
         "examples": [
           "controller.text.setMarkdown(elementId, '- First point\\n- Second point\\n- Third point')"
         ],
@@ -1489,17 +1626,43 @@
     }
   ],
   "guides": [
+    {
+      "id": "templates-flow",
+      "title": "How to build a deck (built-in templates)",
+      "summary": "The recommended flow: pick one template style, apply its theme, insert slides by slug, then edit text.",
+      "body": [
+        "1. Read templates.catalog and pick exactly ONE template (template_1 … template_8) whose tone fits the audience (e.g. template_1 Crimson landscape for bold keynotes, template_5 Minimal green for crisp lessons).",
+        "2. Apply it once: deck.applyTemplate({ templateId:'template_1' }). This sets the deck theme. Do not hand-pick colors or fonts after this.",
+        "3. Read templates.slidesCatalog({ templateId }) — slides are grouped by type: cover, contents, transition, content, end. Each entry has a slug and description.",
+        "4. For each slide in your outline, call slides.insertFromTemplate({ templateId, slug }) with the slug that best matches (e.g. cover_1 for title, contents_1 for agenda, content_2 for a text+image slide).",
+        "5. Use the returned elementIds: batch text.setMarkdown (or text.update) to replace placeholder copy. Author Markdown/plain text only — never HTML.",
+        "6. After creating or editing a slide, look at the auto-screenshot. Fix overflow and literal markup before moving on.",
+        "7. Only use slides.create + manual elements when no template slide in the catalog fits."
+      ]
+    },
+    {
+      "id": "content-authoring",
+      "title": "Authoring content (Markdown / plain text / structured data — not HTML)",
+      "summary": "What to put in text and layout slots, and why raw HTML does not belong there.",
+      "body": [
+        "Layout slots and the markdown text path accept Markdown, plain text, or structured values (arrays for bullets; { labels, series } for charts; rows for comparison). The engine renders them into clean, themed HTML for you.",
+        "Do NOT write raw HTML tags (<div>, <span style>, <br>, <b>, ...) into Markdown/plain-text inputs. They are ESCAPED and appear as literal angle-bracket text on the slide. The bridge attaches a warning when it detects this — treat that warning as a must-fix.",
+        "Use Markdown syntax for emphasis: **bold**, _italic_, `code`, and - / 1. for lists. Math uses $...$ / $$...$$ (KaTeX).",
+        "The only place literal HTML is appropriate is the explicit literal path (text.setContent / element.content) when you intentionally want to render markup — for example, displaying an HTML code snippet as content. Even then, prefer a fenced code block in Markdown when you just want code to look like code.",
+        "If a screenshot shows literal tags or markup characters on a slide, you used the wrong path: re-author the text as Markdown via text.setMarkdown."
+      ]
+    },
     {
       "id": "getting-started",
-      "title": "How to build a deck",
-      "summary": "The read -> theme -> per-slide batch -> review loop the bridge is designed for.",
+      "title": "Manual placement (fallback)",
+      "summary": "For bespoke slides a layout can't express: the read -> style -> per-slide batch -> review loop.",
       "body": [
-        "1. Read the current deck (controller.export.json() or deck.get) and the design tokens (controller.docs().designSystem).",
-        "2. Set the deck theme once with deck.setTheme so element defaults inherit your palette and font.",
-        "3. For each slide: create the slide, capture result.data.id, then add its elements in a single executeBatch so the slide is one undo step.",
-        "4. Place elements in canvas px (default 1000 x 562.5). Keep a 40px margin and a clear visual hierarchy: title row, content area, footer/citation.",
-        "5. Author body text in Markdown (text.create({ markdown }) / text.setMarkdown) or HTML; use inline font-size styles in HTML when you need exact sizes.",
-        "6. Review and iterate. Use meta.dryRun to validate a risky payload before applying it."
+        "Prefer built-in templates (see the templates-flow guide). Use manual placement only when no template slide fits.",
+        "1. Read the current deck (controller.export.json() or deck.get) and apply a template theme (deck.applyTemplate) so element defaults inherit a coherent palette and font.",
+        "2. For each slide: create the slide, capture result.data.id, then add its elements in a single executeBatch so the slide is one undo step.",
+        "3. Place elements in canvas px (default 1000 x 562.5). Keep a 40px margin and a clear visual hierarchy: title row, content area, footer/citation.",
+        "4. Author body text in Markdown (text.create({ markdown }) / text.setMarkdown), never raw HTML.",
+        "5. Screenshot the slide and fix overflow/contrast/alignment before moving on. Use meta.dryRun to validate a risky payload before applying it."
       ]
     },
     {
@@ -1630,6 +1793,7 @@
     "PptistAnimationPreset": "export interface PptistAnimationPreset { name: string; value: string }",
     "PptistAnimationPresetGroup": "export interface PptistAnimationPresetGroup { type: string; name: string; children: PptistAnimationPreset[] }",
     "PptistAnimationSequenceStep": "export interface PptistAnimationSequenceStep { index: number; animations: PPTAnimation[]; autoNext: boolean }",
+    "PptistApplyTemplateResult": "export interface PptistApplyTemplateResult { templateId: string; theme: SlideTheme }",
     "PptistAudioElementPatch": "export type PptistAudioElementPatch = Partial<Pick<PPTAudioElement, 'src' | 'ext' | 'autoplay' | 'loop' | 'color' | 'fixedRatio' | 'link' | 'name' | 'lock' | 'groupId'>> & { transform?: PptistAudioTransformPatch }",
     "PptistAudioSourceInput": "export type PptistAudioSourceInput = PptistMediaAssetInput",
     "PptistAudioTransformPatch": "export type PptistAudioTransformPatch = Pick<PptistElementTransformPatch, 'left' | 'top' | 'width' | 'height' | 'rotate'>",
@@ -1656,6 +1820,8 @@
     "PptistIdRemap": "export interface PptistIdRemap { slideIds: PptistIdMap; elementIds: PptistIdMap; groupIds: PptistIdMap; animationIds: PptistIdMap }",
     "PptistInsertElementsInput": "export interface PptistInsertElementsInput { slideId?: string; index?: number; elements: PPTElement | PPTElement[]; animations?: PPTAnimation[]; offset?: number | { left?: number; top?: number }; select?: boolean; preserveExternalSlideLinks?: boolean; slideIdMap?: PptistIdMap }",
     "PptistInsertElementsResult": "export interface PptistInsertElementsResult { slideId: string; elements: PPTElement[]; animations: PPTAnimation[]; remap: Omit<PptistIdRemap, 'slideIds'> & { slideIds?: PptistIdMap } }",
+    "PptistInsertFromTemplateInput": "export interface PptistInsertFromTemplateInput { templateId: string; slug: string; index?: number; select?: boolean; applyTemplateTheme?: boolean }",
+    "PptistInsertFromTemplateResult": "export interface PptistInsertFromTemplateResult { slideId: string; templateId: string; slug: string; elementIds: string[] }",
     "PptistInsertSlidesInput": "export interface PptistInsertSlidesInput { slides: Slide | Slide[]; index?: number; select?: boolean; preserveExternalSlideLinks?: boolean }",
     "PptistInsertSlidesResult": "export interface PptistInsertSlidesResult { slides: Slide[]; remap: PptistIdRemap }",
     "PptistJsonPrimitive": "export type PptistJsonPrimitive = string | number | boolean | null",
@@ -1687,6 +1853,10 @@
     "PptistSlideThemePatch": "export type PptistSlideThemePatch = Omit<Partial<SlideTheme>, 'outline' | 'shadow'> & { outline?: Partial<SlideTheme['outline']>; shadow?: Partial<SlideTheme['shadow']> }",
     "PptistSlideTransition": "export interface PptistSlideTransition { slideId: string; turningMode?: TurningMode }",
     "PptistTableElementPatch": "export type PptistTableElementPatch = Partial<Omit<PPTTableElement, 'type' | 'id' | 'outline' | 'theme'>> & { outline?: Partial<PPTTableElement['outline']>; theme?: Partial<NonNullable<PPTTableElement['theme']>> }",
+    "PptistTemplateSlideEntry": "export interface PptistTemplateSlideEntry { slug: string; type: SlideType; description: string; elementCount: number }",
+    "PptistTemplateSlidesCatalog": "export type PptistTemplateSlidesCatalog = Record<SlideType, PptistTemplateSlideEntry[]>",
+    "PptistTemplateSlidesCatalogResult": "export interface PptistTemplateSlidesCatalogResult { templateId: string; templateName: string; slideCount: number; byType: PptistTemplateSlidesCatalog }",
+    "PptistTemplateSummary": "export interface PptistTemplateSummary { id: BuiltInTemplateId | string; name: string; cover: string; origin?: string }",
     "PptistVideoPatch": "export type PptistVideoPatch = PptistVideoPlaybackPatch & PptistVideoSizePatch & PptistVideoPositionPatch & PptistVideoStylePatch",
     "PptistVideoPlaybackPatch": "export interface PptistVideoPlaybackPatch { src?: string; ext?: string; autoplay?: boolean; poster?: string }",
     "PptistVideoPositionPatch": "export interface PptistVideoPositionPatch { left?: number; top?: number; rotate?: number }",
@@ -1739,7 +1909,7 @@
     "SlideBackgroundImageSize": "export type SlideBackgroundImageSize = 'cover' | 'contain' | 'repeat'",
     "SlideBackgroundType": "export type SlideBackgroundType = 'solid' | 'image' | 'gradient'",
     "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 }",
+    "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'",
     "TableCell": "export interface TableCell { id: string; colspan: number; rowspan: number; text: string; style?: TableCellStyle }",
     "TableCellStyle": "export interface TableCellStyle { bold?: boolean; em?: boolean; underline?: boolean; strikethrough?: boolean; color?: string; backcolor?: string; fontsize?: string; fontname?: string; align?: TextAlign; vAlign?: TextAlignVertical }",