@lofcz/pptist 2.0.10 → 2.0.12

package/dist/embed/agentic-manifest.json

@@ -1,8 +1,8 @@
 {
   "schemaVersion": 2,
   "package": "@lofcz/pptist",
-  "packageVersion": "2.0.10",
-  "generatedAt": "2026-06-02T05:17:27.619Z",
+  "packageVersion": "2.0.12",
+  "generatedAt": "2026-06-02T06:38:48.529Z",
   "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": {
@@ -79,7 +79,7 @@
       "commandCount": 18,
       "title": "Slides",
       "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."
+      "whenToUse": "Prefer slides.insertFromTemplate (one call per slide). After insert, use text.setMarkdown on the returned placeholderElementIds/textElementIds. Avoid slides.create for deck building."
     },
     {
       "id": "elements",
@@ -465,7 +465,7 @@
       "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.",
+        "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 placeholderElementIds (or textElementIds). Do not create new text boxes on top of an unfilled placeholder; Office-style placeholders show their prompt until that same placeholder is filled.",
         "params": [
           {
             "name": "templateId",
@@ -504,7 +504,7 @@
         ],
         "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."
+          "After insert, batch text.setMarkdown calls for each placeholderElementIds entry that should contain slide copy. Empty placeholders intentionally keep their Office-style prompt."
         ],
         "related": [
           "templates.slidesCatalog",
@@ -1635,7 +1635,7 @@
         "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.",
+        "5. Use the returned placeholderElementIds/textElementIds: batch text.setMarkdown (or text.update) to replace placeholder copy. Do not add separate text boxes over placeholders. 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."
       ]
@@ -1821,7 +1821,7 @@
     "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[] }",
+    "PptistInsertFromTemplateResult": "export interface PptistInsertFromTemplateResult { slideId: string; templateId: string; slug: string; elementIds: string[]; textElementIds: string[]; placeholderElementIds: 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",