@json-to-office/jto 2.3.1 → 3.0.0

package/dist/client/templates/minimalist-pitch-deck.pptx.json

@@ -58,104 +58,120 @@
         "color": "text"
       }
     },
-    "templates": [
-      {
-        "name": "veil-bottom-right",
-        "background": {
-          "gradient": {
-            "type": "radial",
-            "focus": "bottomRight",
-            "stops": [
-              {
-                "color": "primary",
-                "pos": 0
-              },
-              {
-                "color": "primary",
-                "pos": 79
-              },
-              {
-                "color": "secondary",
-                "pos": 100
-              }
-            ]
+    "blocks": {
+      "veil-bottom-right": {
+        "description": "Slide chrome shared by the veil-bottom-right slides of this deck.",
+        "slots": {},
+        "slide": {
+          "background": {
+            "gradient": {
+              "type": "radial",
+              "focus": "bottomRight",
+              "stops": [
+                {
+                  "color": "primary",
+                  "pos": 0
+                },
+                {
+                  "color": "primary",
+                  "pos": 79
+                },
+                {
+                  "color": "secondary",
+                  "pos": 100
+                }
+              ]
+            }
           }
-        }
+        },
+        "body": []
       },
-      {
-        "name": "veil-top-left",
-        "background": {
-          "gradient": {
-            "type": "radial",
-            "focus": "topLeft",
-            "stops": [
-              {
-                "color": "primary",
-                "pos": 0
-              },
-              {
-                "color": "primary",
-                "pos": 79
-              },
-              {
-                "color": "secondary",
-                "pos": 100
-              }
-            ]
+      "veil-top-left": {
+        "description": "Slide chrome shared by the veil-top-left slides of this deck.",
+        "slots": {},
+        "slide": {
+          "background": {
+            "gradient": {
+              "type": "radial",
+              "focus": "topLeft",
+              "stops": [
+                {
+                  "color": "primary",
+                  "pos": 0
+                },
+                {
+                  "color": "primary",
+                  "pos": 79
+                },
+                {
+                  "color": "secondary",
+                  "pos": 100
+                }
+              ]
+            }
           }
-        }
+        },
+        "body": []
       },
-      {
-        "name": "dawn-diagonal",
-        "background": {
-          "gradient": {
-            "type": "linear",
-            "angle": 110,
-            "stops": [
-              {
-                "color": "primary",
-                "pos": 0
-              },
-              {
-                "color": "secondary",
-                "pos": 23
-              },
-              {
-                "color": "background2",
-                "pos": 73
-              },
-              {
-                "color": "background2",
-                "pos": 100
-              }
-            ]
+      "dawn-diagonal": {
+        "description": "Slide chrome shared by the dawn-diagonal slides of this deck.",
+        "slots": {},
+        "slide": {
+          "background": {
+            "gradient": {
+              "type": "linear",
+              "angle": 110,
+              "stops": [
+                {
+                  "color": "primary",
+                  "pos": 0
+                },
+                {
+                  "color": "secondary",
+                  "pos": 23
+                },
+                {
+                  "color": "background2",
+                  "pos": 73
+                },
+                {
+                  "color": "background2",
+                  "pos": 100
+                }
+              ]
+            }
           }
-        }
+        },
+        "body": []
       },
-      {
-        "name": "haze-bottom-left",
-        "background": {
-          "gradient": {
-            "type": "radial",
-            "focus": "bottomLeft",
-            "stops": [
-              {
-                "color": "secondary",
-                "pos": 0
-              },
-              {
-                "color": "background2",
-                "pos": 38
-              },
-              {
-                "color": "background2",
-                "pos": 100
-              }
-            ]
+      "haze-bottom-left": {
+        "description": "Slide chrome shared by the haze-bottom-left slides of this deck.",
+        "slots": {},
+        "slide": {
+          "background": {
+            "gradient": {
+              "type": "radial",
+              "focus": "bottomLeft",
+              "stops": [
+                {
+                  "color": "secondary",
+                  "pos": 0
+                },
+                {
+                  "color": "background2",
+                  "pos": 38
+                },
+                {
+                  "color": "background2",
+                  "pos": 100
+                }
+              ]
+            }
           }
-        }
+        },
+        "body": []
       }
-    ]
+    }
   },
   "children": [
     {
@@ -405,10 +421,15 @@
     {
       "name": "slide",
       "props": {
-        "template": "veil-bottom-right",
         "notes": "Welcome slide with stat and image."
       },
       "children": [
+        {
+          "name": "block",
+          "props": {
+            "ref": "veil-bottom-right"
+          }
+        },
         {
           "name": "text",
           "props": {
@@ -545,10 +566,15 @@
     {
       "name": "slide",
       "props": {
-        "template": "veil-top-left",
         "notes": "Vision statement with stat and two square images."
       },
       "children": [
+        {
+          "name": "block",
+          "props": {
+            "ref": "veil-top-left"
+          }
+        },
         {
           "name": "text",
           "props": {
@@ -717,10 +743,15 @@
     {
       "name": "slide",
       "props": {
-        "template": "dawn-diagonal",
         "notes": "Problem and solution overview."
       },
       "children": [
+        {
+          "name": "block",
+          "props": {
+            "ref": "dawn-diagonal"
+          }
+        },
         {
           "name": "text",
           "props": {
@@ -1746,10 +1777,15 @@
     {
       "name": "slide",
       "props": {
-        "template": "veil-bottom-right",
         "notes": "Product overview with right image band."
       },
       "children": [
+        {
+          "name": "block",
+          "props": {
+            "ref": "veil-bottom-right"
+          }
+        },
         {
           "name": "image",
           "props": {
@@ -1879,10 +1915,15 @@
     {
       "name": "slide",
       "props": {
-        "template": "veil-top-left",
         "notes": "Three product feature images."
       },
       "children": [
+        {
+          "name": "block",
+          "props": {
+            "ref": "veil-top-left"
+          }
+        },
         {
           "name": "image",
           "props": {
@@ -2031,10 +2072,15 @@
         "meta": {
           "title": "Case timeline"
         },
-        "template": "dawn-diagonal",
         "notes": "Arc timeline with four cases."
       },
       "children": [
+        {
+          "name": "block",
+          "props": {
+            "ref": "dawn-diagonal"
+          }
+        },
         {
           "name": "text",
           "props": {
@@ -2383,10 +2429,15 @@
         "meta": {
           "title": "Market overview"
         },
-        "template": "haze-bottom-left",
         "notes": "Market overview pies."
       },
       "children": [
+        {
+          "name": "block",
+          "props": {
+            "ref": "haze-bottom-left"
+          }
+        },
         {
           "name": "text",
           "props": {
@@ -2835,10 +2886,15 @@
         "meta": {
           "title": "Competitive landscape"
         },
-        "template": "veil-bottom-right",
         "notes": "Competitive landscape stats and images."
       },
       "children": [
+        {
+          "name": "block",
+          "props": {
+            "ref": "veil-bottom-right"
+          }
+        },
         {
           "name": "image",
           "props": {
@@ -3021,10 +3077,15 @@
         "meta": {
           "title": "Laptop mockup"
         },
-        "template": "veil-top-left",
         "notes": "Laptop mockup slide."
       },
       "children": [
+        {
+          "name": "block",
+          "props": {
+            "ref": "veil-top-left"
+          }
+        },
         {
           "name": "shape",
           "props": {
@@ -3263,10 +3324,15 @@
         "meta": {
           "title": "Values"
         },
-        "template": "dawn-diagonal",
         "notes": "Values list and percent column."
       },
       "children": [
+        {
+          "name": "block",
+          "props": {
+            "ref": "dawn-diagonal"
+          }
+        },
         {
           "name": "image",
           "props": {
@@ -3427,10 +3493,15 @@
         "meta": {
           "title": "Revenue KPIs"
         },
-        "template": "haze-bottom-left",
         "notes": "Revenue KPIs."
       },
       "children": [
+        {
+          "name": "block",
+          "props": {
+            "ref": "haze-bottom-left"
+          }
+        },
         {
           "name": "text",
           "props": {

package/dist/prompts/instructions-edit-document-pptx-blocks.md

@@ -0,0 +1,77 @@
+## Presentation: {{documentName}}
+
+### Current block definitions
+
+```json
+{{blocksText}}
+```
+
+### Slides invoking them (reference only — do not output these)
+
+{{slidesSummary}}
+
+You are EDITING the block definitions of this presentation. Output **only new or modified** definitions:
+
+```json
+{
+  "blocks": { "<name>": { ...complete definition... } }
+}
+```
+
+Unchanged definitions are automatically preserved — do NOT echo them back.
+
+### Rules for block-scoped editing
+
+- Output ONLY definitions you are adding or modifying. Omit unchanged definitions entirely.
+- Do NOT include `"name"`, `"children"` or other top-level keys — only `"blocks"`.
+- When modifying a definition, output the **complete** definition (all its slots, its whole body, its `slide` effects) — not just the changed fields.
+- Keep definition names stable — slides reference them by name. Keep every slot the slides above fill, with the same name and type; renaming or removing one breaks those slides.
+- To DELETE a definition, output `"<name>": null`.
+- New names are lowercase-kebab (`kpi-row`, `two-column`). Each definition needs `slots` and `body`; add `description` and, when the slide should inherit a background or notes, `slide`.
+- Author geometry as percentage frames of the slide, bind sizes to type roles with a `default`, wrap optional slots in `$if`, give titles a `fit`, and put page numbers and trackers in the body.
+- **Component format:** every item in a `body` MUST be `{ "name": "<type>", "props": { ... } }` or a binding directive. Never `{ "type": "...", ... }` with flat props.
+
+### Example
+
+**User request:** "Add a source line to the statement block"
+
+**Correct output (only the modified definition, complete):**
+
+```json
+{
+  "blocks": {
+    "statement": {
+      "description": "One sentence on an otherwise empty slide, with an optional source.",
+      "slots": {
+        "text": { "type": "string", "required": true, "maxWords": 30, "role": "actionTitle" },
+        "source": { "type": "string", "maxWords": 20, "role": "source" }
+      },
+      "body": [
+        {
+          "name": "text",
+          "props": {
+            "text": { "$slot": "/text" },
+            "style": "display",
+            "fontSize": { "$theme": "/styles/display/fontSize", "default": 28 },
+            "x": "3.75%", "y": "30%", "w": "92.5%", "h": "30%",
+            "valign": "middle",
+            "fit": { "maxLines": 3, "shrink": [24, 22] }
+          }
+        },
+        {
+          "$if": "/source",
+          "then": {
+            "name": "text",
+            "props": {
+              "text": { "$slot": "/source" },
+              "style": "source",
+              "fontSize": { "$theme": "/styles/source/fontSize", "default": 9 },
+              "x": "3.75%", "y": "94.5%", "w": "75%", "h": "5%"
+            }
+          }
+        }
+      ]
+    }
+  }
+}
+```

package/dist/prompts/instructions-edit-document-pptx-slides.md

@@ -1,10 +1,10 @@
 ## Presentation: {{documentName}}
 
-### Available Templates (reference only — do not output these)
+### Available blocks (reference only — do not output these)
 
-{{templatesSummary}}
+{{blocksSummary}}
 
-### Current Slides
+### Current slides
 
 ```json
 {{slidesText}}
@@ -21,40 +21,34 @@ You are EDITING the slides of this presentation. Return ONLY the modified slides
 ### Rules for slide-scoped editing
 
 - Output the COMPLETE `children` array — include ALL slides, not just changed ones.
-- Do NOT include `"name"` or `"props"` keys — templates and presentation settings are unchanged.
-- Reference existing template names from the list above.
-- New slides MUST reference existing templates — do not invent new templates.
+- Do NOT include `"name"` or `"props"` keys — the block definitions and presentation settings are unchanged.
+- New slides MUST invoke blocks from the list above — do not define new blocks here and do not add coordinates to an invocation.
 - Preserve unmodified slides exactly as they appear above.
-- When editing a slide, keep its `template` reference and only change `placeholders` content.
-- If the presentation uses templates, new slides should also use templates for consistency.
+- When editing a slide that invokes a block, keep its `ref` and change only the `slots`; fill every required slot and respect `maxWords`/`oneLine`.
 - **Component format:** every component MUST be `{ "name": "<type>", "props": { ... } }`. Never use `{ "type": "...", ... }` with flat props.
 
 ### Example
 
 **User request:** "Add a slide about pricing"
 
-**Correct output (complete children array with new slide appended):**
+**Correct output (complete children array with the new slide appended):**
 
 ```json
 {
   "children": [
     {
       "name": "slide",
-      "props": {
-        "template": "CONTENT_TEMPLATE",
-        "placeholders": {
-          "heading": { "name": "text", "props": { "text": "Overview" } }
-        }
-      }
+      "props": { "meta": { "title": "Overview" } },
+      "children": [
+        { "name": "block", "props": { "ref": "statement", "slots": { "text": "Growth improved as delivery became reliable." } } }
+      ]
     },
     {
       "name": "slide",
-      "props": {
-        "template": "CONTENT_TEMPLATE",
-        "placeholders": {
-          "heading": { "name": "text", "props": { "text": "Pricing" } }
-        }
-      }
+      "props": { "meta": { "title": "Pricing" } },
+      "children": [
+        { "name": "block", "props": { "ref": "statement", "slots": { "text": "Pricing moves to three tiers." } } }
+      ]
     }
   ]
 }

package/dist/prompts/instructions-edit-document-pptx.md

@@ -10,11 +10,11 @@ IMPORTANT: This {{contentLabelLower}} already exists. You are EDITING it, not ge
 
 ### Rules for editing presentations
 
-- **Preserve all existing templates** in `pptx.props.templates` unless explicitly asked to modify them.
-- When adding new slides, **reference existing template names** — do not invent new templates unless the user asks for a new layout.
-- When editing a slide, keep its `template` reference and only change the `placeholders` content.
-- If the presentation uses templates, new slides should also use templates for consistency.
-- **Component format:** every component MUST be `{ "name": "<type>", "props": { ... } }`. Never use `{ "type": "...", ... }` with flat props.
+- **Preserve every definition in `pptx.props.blocks`** unless explicitly asked to change it.
+- When adding slides, **invoke an existing block** — do not define a new one unless the user asks for a new layout, and never add coordinates to an invocation.
+- When editing a slide that invokes a block, keep its `ref` and change only the `slots`.
+- If the presentation uses blocks, new slides should invoke blocks too, for consistency.
+- **Component format:** every component MUST be `{ "name": "<type>", "props": { ... } }`. Never use `{ "type": "...", ... }` with flat props. Never emit `templates`, `template` or `placeholders` keys.
 
 ### Example
 
@@ -24,26 +24,23 @@ IMPORTANT: This {{contentLabelLower}} already exists. You are EDITING it, not ge
 {
   "name": "pptx",
   "props": {
-    "templates": [
-      {
-        "name": "CONTENT_TEMPLATE",
-        "placeholders": [
-          { "name": "heading", "type": "title" },
-          { "name": "body", "type": "body" }
-        ]
+    "theme": "consulting",
+    "slideWidth": 13.333,
+    "slideHeight": 7.5,
+    "blocks": {
+      "statement": {
+        "slots": { "text": { "type": "string", "required": true, "maxWords": 30 } },
+        "body": [{ "name": "text", "props": { "text": { "$slot": "/text" }, "style": "display", "x": "3.75%", "y": "30%", "w": "92.5%", "h": "30%" } }]
       }
-    ]
+    }
   },
   "children": [
     {
       "name": "slide",
-      "props": {
-        "template": "CONTENT_TEMPLATE",
-        "placeholders": {
-          "heading": { "name": "text", "props": { "text": "Overview" } },
-          "body": { "name": "text", "props": { "text": "Content here." } }
-        }
-      }
+      "props": { "meta": { "title": "Overview" } },
+      "children": [
+        { "name": "block", "props": { "ref": "statement", "slots": { "text": "Growth improved as delivery became reliable." } } }
+      ]
     }
   ]
 }
@@ -51,52 +48,36 @@ IMPORTANT: This {{contentLabelLower}} already exists. You are EDITING it, not ge
 
 **User request:** "Add a slide about pricing"
 
-**Correct output (full document with new slide appended, using existing template):**
+**Correct output (full document with the new slide appended, invoking the existing block):**
 
 ```json
 {
   "name": "pptx",
   "props": {
-    "templates": [
-      {
-        "name": "CONTENT_TEMPLATE",
-        "placeholders": [
-          { "name": "heading", "type": "title" },
-          { "name": "body", "type": "body" }
-        ]
+    "theme": "consulting",
+    "slideWidth": 13.333,
+    "slideHeight": 7.5,
+    "blocks": {
+      "statement": {
+        "slots": { "text": { "type": "string", "required": true, "maxWords": 30 } },
+        "body": [{ "name": "text", "props": { "text": { "$slot": "/text" }, "style": "display", "x": "3.75%", "y": "30%", "w": "92.5%", "h": "30%" } }]
       }
-    ]
+    }
   },
   "children": [
     {
       "name": "slide",
-      "props": {
-        "template": "CONTENT_TEMPLATE",
-        "placeholders": {
-          "heading": { "name": "text", "props": { "text": "Overview" } },
-          "body": { "name": "text", "props": { "text": "Content here." } }
-        }
-      }
+      "props": { "meta": { "title": "Overview" } },
+      "children": [
+        { "name": "block", "props": { "ref": "statement", "slots": { "text": "Growth improved as delivery became reliable." } } }
+      ]
     },
     {
       "name": "slide",
-      "props": {
-        "template": "CONTENT_TEMPLATE",
-        "placeholders": {
-          "heading": { "name": "text", "props": { "text": "Pricing" } },
-          "body": {
-            "name": "table",
-            "props": {
-              "rows": [
-                ["Plan", "Price"],
-                ["Starter", "$9/mo"],
-                ["Pro", "$29/mo"]
-              ],
-              "grid": { "column": 0, "row": 2, "columnSpan": 12, "rowSpan": 3 }
-            }
-          }
-        }
-      }
+      "props": { "meta": { "title": "Pricing" } },
+      "children": [
+        { "name": "block", "props": { "ref": "statement", "slots": { "text": "Pricing moves to three tiers: Starter at $9, Pro at $29, Enterprise on request." } } }
+      ]
     }
   ]
 }