@json-to-office/jto 4.0.0 → 4.5.0

package/dist/client/templates/client-report-blocks.docx.json

@@ -107,13 +107,13 @@
           "title": {
             "type": "string",
             "oneLine": true,
-            "maxWords": 16,
+            "maxWords": 12,
             "required": true
           },
           "subtitle": {
             "type": "string",
             "oneLine": true,
-            "maxWords": 30,
+            "maxWords": 20,
             "required": false
           },
           "client": {
@@ -202,6 +202,10 @@
                     "default": "accent"
                   }
                 },
+                "spacing": {
+                  "before": 0,
+                  "after": 4
+                },
                 "keepNext": true
               }
             }
@@ -212,6 +216,10 @@
               "text": {
                 "$slot": "/title"
               },
+              "spacing": {
+                "before": 0,
+                "after": 10
+              },
               "font": {
                 "family": {
                   "$theme": "/fonts/body/family",
@@ -228,6 +236,10 @@
                 "color": {
                   "$theme": "/styles/display/color",
                   "default": "textPrimary"
+                },
+                "lineSpacing": {
+                  "type": "multiple",
+                  "value": 1.1
                 }
               },
               "keepNext": true
@@ -257,8 +269,16 @@
                   "color": {
                     "$theme": "/styles/subtitle/color",
                     "default": "textPrimary"
+                  },
+                  "lineSpacing": {
+                    "type": "multiple",
+                    "value": 1.1
                   }
                 },
+                "spacing": {
+                  "before": 0,
+                  "after": 6
+                },
                 "keepNext": true
               }
             }
@@ -288,6 +308,10 @@
                     "$theme": "/styles/label/color",
                     "default": "textPrimary"
                   }
+                },
+                "spacing": {
+                  "before": 0,
+                  "after": 4
                 }
               }
             }
@@ -317,6 +341,10 @@
                     "$theme": "/styles/label/color",
                     "default": "textPrimary"
                   }
+                },
+                "spacing": {
+                  "before": 0,
+                  "after": 2
                 }
               }
             }
@@ -324,7 +352,7 @@
         ]
       },
       "section-opener": {
-        "description": "A numbered section heading which sets the general section tracker.",
+        "description": "A numbered section heading.",
         "slots": {
           "number": {
             "type": "string",
@@ -337,20 +365,6 @@
             "oneLine": true,
             "maxWords": 12,
             "required": true
-          },
-          "tracker": {
-            "type": "string",
-            "oneLine": true,
-            "maxWords": 6,
-            "required": false
-          }
-        },
-        "section": {
-          "tracker": {
-            "$slot": "/tracker",
-            "default": {
-              "$slot": "/title"
-            }
           }
         },
         "body": [
@@ -396,15 +410,9 @@
         ]
       },
       "running-head": {
-        "description": "Document title/section tracker and page fields, inherited by subsequent sections.",
+        "description": "Document title in the header and confidentiality, page fields and date in the footer, inherited by every later section; those sections continue on the page.",
         "slots": {
           "title": {
-            "type": "string",
-            "oneLine": true,
-            "maxWords": 12,
-            "required": false
-          },
-          "tracker": {
             "type": "string",
             "oneLine": true,
             "maxWords": 6,
@@ -413,13 +421,13 @@
           "confidentiality": {
             "type": "string",
             "oneLine": true,
-            "maxWords": 8,
+            "maxWords": 4,
             "required": false
           },
           "date": {
             "type": "string",
             "oneLine": true,
-            "maxWords": 6,
+            "maxWords": 3,
             "required": false
           },
           "pageNumbers": {
@@ -436,24 +444,11 @@
               "name": "paragraph",
               "props": {
                 "text": {
-                  "$join": [
-                    {
-                      "$slot": "/title",
-                      "default": {
-                        "$context": "/document/title",
-                        "default": ""
-                      }
-                    },
-                    {
-                      "$context": "/section/tracker",
-                      "default": {
-                        "$slot": "/tracker",
-                        "default": ""
-                      }
-                    }
-                  ],
-                  "separator": "\t",
-                  "keepEmpty": true
+                  "$slot": "/title",
+                  "default": {
+                    "$context": "/document/title",
+                    "default": ""
+                  }
                 },
                 "font": {
                   "family": {
@@ -473,15 +468,6 @@
                     "default": "textMuted"
                   }
                 },
-                "tabStops": [
-                  {
-                    "type": "right",
-                    "position": {
-                      "$measure": "width",
-                      "unit": "twip"
-                    }
-                  }
-                ],
                 "spacing": {
                   "before": 0,
                   "after": 0
@@ -648,7 +634,7 @@
         ]
       },
       "kpi-row": {
-        "description": "Two to four headline metrics in equal columns: value with its unit, label, and a signed delta with a direction glyph. An optional source collapses with its hairline. Text budgets reject overflow; columns reflow at unchanged type size.",
+        "description": "Two to four headline metrics in equal columns: value with its unit, label, and a signed delta with a direction glyph; four of them set the figures a size smaller. An optional source collapses with its hairline. Text budgets reject overflow; columns reflow at unchanged type size.",
         "slots": {
           "items": {
             "type": "array",
@@ -661,12 +647,12 @@
                 "value": {
                   "type": "string",
                   "required": true,
-                  "maxLength": 12,
+                  "maxLength": 7,
                   "description": "The headline figure, already formatted: 8.8, 94, +18."
                 },
                 "unit": {
                   "type": "string",
-                  "maxLength": 6,
+                  "maxLength": 5,
                   "description": "Suffix drawn after the figure at half its size: %, €m, pts. Write the space yourself when one belongs."
                 },
                 "label": {
@@ -678,7 +664,7 @@
                 },
                 "delta": {
                   "type": "string",
-                  "maxLength": 12,
+                  "maxLength": 10,
                   "description": "Signed change shown beside the figure: +3.2 pts, −0.4."
                 },
                 "trend": {
@@ -724,6 +710,11 @@
                     },
                     "trendValue": {
                       "$item": "/delta"
+                    },
+                    "size": {
+                      "$if": "/items/3",
+                      "then": "small",
+                      "else": "medium"
                     }
                   }
                 }
@@ -834,7 +825,7 @@
         ]
       },
       "data-table": {
-        "description": "A sourced numeric table: a title, a text column of row labels, one to six data columns right-aligned by construction, then optional notes and a source line. With its header, 24 rows keep the table on one page; the table-design rule checks the compiled table for mixed decimals.",
+        "description": "A sourced numeric table: a title, a text column of row labels at a fifth of the measure, one to five data columns right-aligned by construction, then optional notes and a source line. With its header, 24 rows keep the table on one page; the table-design rule checks the compiled table for mixed decimals.",
         "slots": {
           "title": {
             "type": "string",
@@ -857,7 +848,7 @@
             "items": {
               "type": "string",
               "oneLine": true,
-              "maxWords": 8
+              "maxWords": 5
             },
             "description": "Row labels, top to bottom. Every data column lists its cells in this order and at this count."
           },
@@ -865,7 +856,7 @@
             "type": "array",
             "required": true,
             "minItems": 1,
-            "maxItems": 6,
+            "maxItems": 5,
             "items": {
               "type": "object",
               "properties": {
@@ -874,6 +865,7 @@
                   "required": true,
                   "oneLine": true,
                   "maxWords": 4,
+                  "maxLength": 14,
                   "description": "Column header; put the unit here: Revenue (€m)."
                 },
                 "cells": {
@@ -883,7 +875,7 @@
                   "maxItems": 24,
                   "items": {
                     "type": "string",
-                    "maxLength": 16
+                    "maxLength": 10
                   },
                   "description": "One formatted value per row label, rounded the same way down the column."
                 },
@@ -943,11 +935,28 @@
             "props": {
               "width": 100,
               "repeatHeaderOnPageBreak": true,
+              "rows": {
+                "$each": "/labels",
+                "template": {
+                  "cantSplit": true
+                }
+              },
               "columns": [
                 {
+                  "width": "22%",
                   "header": {
                     "content": {
                       "$slot": "/labelHeader"
+                    },
+                    "padding": {
+                      "left": 0,
+                      "right": 6
+                    }
+                  },
+                  "cellDefaults": {
+                    "padding": {
+                      "left": 0,
+                      "right": 6
                     }
                   },
                   "cells": {
@@ -972,6 +981,10 @@
                         },
                         "then": "right",
                         "else": "left"
+                      },
+                      "padding": {
+                        "left": 6,
+                        "right": 0
                       }
                     },
                     "cellDefaults": {
@@ -981,6 +994,10 @@
                         },
                         "then": "right",
                         "else": "left"
+                      },
+                      "padding": {
+                        "left": 6,
+                        "right": 0
                       }
                     },
                     "cells": {
@@ -1346,8 +1363,7 @@
             "ref": "section-opener",
             "slots": {
               "number": "01",
-              "title": "Delivery improvements supported growth",
-              "tracker": "Performance"
+              "title": "Delivery improvements supported growth"
             }
           }
         },
@@ -1432,8 +1448,7 @@
             "ref": "section-opener",
             "slots": {
               "number": "02",
-              "title": "Focus the next quarter on retention",
-              "tracker": "Recommendations"
+              "title": "Focus the next quarter on retention"
             }
           }
         },
@@ -1472,7 +1487,7 @@
         {
           "name": "paragraph",
           "props": {
-            "text": "The inherited running header uses this section’s tracker and page width. Page numbers are native Word fields."
+            "text": "The inherited running header carries the document title and this section’s page width; the section continues on the page. Page numbers are native Word fields."
           }
         },
         {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@json-to-office/jto",
-  "version": "4.0.0",
+  "version": "4.5.0",
   "description": "JSON to Office CLI - Unified document and presentation generation",
   "type": "module",
   "bin": {
@@ -84,13 +84,13 @@
     "vite": "6.0.5",
     "zod": "^4.0.0",
     "zustand": "5.0.2",
-    "@json-to-office/core-docx": "^4.0.0",
-    "@json-to-office/core-pptx": "^4.0.0",
+    "@json-to-office/core-docx": "^4.5.0",
+    "@json-to-office/core-pptx": "^4.4.1",
     "@json-to-office/jto-cli": "^4.0.0",
-    "@json-to-office/quality": "^4.0.0",
-    "@json-to-office/shared": "^4.0.0",
-    "@json-to-office/shared-docx": "^4.0.0",
-    "@json-to-office/shared-pptx": "^4.0.0"
+    "@json-to-office/quality": "^4.5.0",
+    "@json-to-office/shared-docx": "^4.3.0",
+    "@json-to-office/shared-pptx": "^4.0.0",
+    "@json-to-office/shared": "^4.4.1"
   },
   "devDependencies": {
     "@types/lodash.debounce": "4.0.9",