@reportwright/engine 0.0.0-stage → 0.12.0

package/schema.json

@@ -0,0 +1,2517 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/MrArun005/reportwright/blob/main/src/engine/schema/report.schema.js",
+  "title": "ReportWright report definition",
+  "$ref": "#/$defs/Report",
+  "$defs": {
+    "Expr": {
+      "x-ts-decl": "export type Expr<T = string | number | boolean> = T | `=${string}`;",
+      "description": "A literal value or an expression (\"=Sum(Fields.amount)\")."
+    },
+    "Style": {
+      "type": "object",
+      "properties": {
+        "fontFamily": {
+          "type": "string"
+        },
+        "fontSize": {
+          "x-ts": "number | string"
+        },
+        "fontWeight": {
+          "x-ts": "'normal' | 'bold' | number | string"
+        },
+        "fontStyle": {
+          "x-ts": "'normal' | 'italic' | string"
+        },
+        "color": {
+          "type": "string"
+        },
+        "backgroundColor": {
+          "type": "string"
+        },
+        "backgroundImage": {
+          "type": "string"
+        },
+        "backgroundFit": {
+          "x-ts": "'contain' | 'cover' | 'fill' | string"
+        },
+        "textAlign": {
+          "x-ts": "'left' | 'center' | 'right' | 'justify' | 'auto' | string"
+        },
+        "verticalAlign": {
+          "x-ts": "'top' | 'middle' | 'bottom' | string"
+        },
+        "textDecoration": {
+          "type": "string"
+        },
+        "lineHeight": {
+          "x-ts": "number | string"
+        },
+        "padding": {
+          "x-ts": "number | [number, number, number, number] | string"
+        },
+        "border": {
+          "type": "string"
+        },
+        "borderTop": {
+          "type": "string"
+        },
+        "borderRight": {
+          "type": "string"
+        },
+        "borderBottom": {
+          "type": "string"
+        },
+        "borderLeft": {
+          "type": "string"
+        },
+        "format": {
+          "type": "string"
+        },
+        "writingMode": {
+          "type": "string"
+        },
+        "stroke": {
+          "type": "string"
+        },
+        "strokeWidth": {
+          "x-ts": "number | string"
+        },
+        "strokeDash": {
+          "type": "string"
+        },
+        "fill": {
+          "type": "string"
+        },
+        "radius": {
+          "x-ts": "number | string"
+        }
+      },
+      "additionalProperties": true,
+      "description": "Text and box style. Values may also be expressions. Unknown keys are allowed (newer engine versions add more)."
+    },
+    "Action": {
+      "description": "What a click does: open a URL, drill to another report, jump to a bookmark, or set parameters and run again.",
+      "anyOf": [
+        {
+          "type": "object",
+          "properties": {
+            "type": {
+              "const": "none"
+            }
+          },
+          "required": [
+            "type"
+          ]
+        },
+        {
+          "type": "object",
+          "properties": {
+            "type": {
+              "const": "url"
+            },
+            "url": {
+              "x-ts": "Expr<string>"
+            }
+          },
+          "required": [
+            "type",
+            "url"
+          ]
+        },
+        {
+          "type": "object",
+          "properties": {
+            "type": {
+              "const": "report"
+            },
+            "report": {
+              "x-ts": "Expr<string>"
+            },
+            "params": {
+              "x-ts": "Record<string, Expr>",
+              "type": "object"
+            }
+          },
+          "required": [
+            "type",
+            "report"
+          ]
+        },
+        {
+          "type": "object",
+          "properties": {
+            "type": {
+              "const": "bookmark"
+            },
+            "target": {
+              "x-ts": "Expr<string>"
+            }
+          },
+          "required": [
+            "type",
+            "target"
+          ]
+        },
+        {
+          "type": "object",
+          "properties": {
+            "type": {
+              "const": "params"
+            },
+            "params": {
+              "x-ts": "Record<string, Expr>",
+              "type": "object"
+            },
+            "toggle": {
+              "type": "boolean"
+            }
+          },
+          "required": [
+            "type",
+            "params"
+          ]
+        }
+      ]
+    },
+    "ItemBase": {
+      "type": "object",
+      "properties": {
+        "id": {
+          "type": "string"
+        },
+        "name": {
+          "type": "string"
+        },
+        "x": {
+          "type": "number"
+        },
+        "y": {
+          "type": "number"
+        },
+        "w": {
+          "type": "number"
+        },
+        "h": {
+          "type": "number"
+        },
+        "style": {
+          "$ref": "#/$defs/Style"
+        },
+        "styleName": {
+          "type": "string"
+        },
+        "hidden": {
+          "x-ts": "Expr<boolean>"
+        },
+        "dataSet": {
+          "x-ts": "string | null"
+        },
+        "alt": {
+          "type": "string",
+          "description": "alternative text for screen readers (accessible PDF, Word, HTML)"
+        },
+        "keepTogether": {
+          "type": "boolean"
+        },
+        "pageBreakBefore": {
+          "type": "boolean"
+        },
+        "pageBreakAfter": {
+          "type": "boolean"
+        },
+        "bookmark": {
+          "x-ts": "Expr<string>"
+        },
+        "tooltip": {
+          "x-ts": "Expr<string>"
+        },
+        "action": {
+          "$ref": "#/$defs/Action"
+        }
+      },
+      "required": [
+        "x",
+        "y",
+        "w",
+        "h"
+      ],
+      "x-internal": true
+    },
+    "TextBox": {
+      "allOf": [
+        {
+          "$ref": "#/$defs/ItemBase"
+        },
+        {
+          "type": "object",
+          "properties": {
+            "type": {
+              "const": "textbox"
+            },
+            "value": {
+              "x-ts": "Expr"
+            },
+            "canGrow": {
+              "type": "boolean"
+            },
+            "canShrink": {
+              "type": "boolean"
+            },
+            "shrinkToFit": {
+              "type": "boolean"
+            },
+            "minFontSize": {
+              "type": "number"
+            },
+            "shrinkStep": {
+              "type": "number"
+            },
+            "rotate": {
+              "type": "number"
+            },
+            "headingLevel": {
+              "x-ts": "1 | 2 | 3 | 4 | 5 | 6 | '1' | '2' | '3' | '4' | '5' | '6'",
+              "enum": [
+                1,
+                2,
+                3,
+                4,
+                5,
+                6,
+                "1",
+                "2",
+                "3",
+                "4",
+                "5",
+                "6"
+              ],
+              "description": "1–6: listed by a table of contents with source \"headings\""
+            },
+            "dir": {
+              "enum": [
+                "ltr",
+                "rtl",
+                "auto"
+              ],
+              "description": "text direction: auto (default) from the first strong character"
+            }
+          },
+          "required": [
+            "type"
+          ]
+        }
+      ]
+    },
+    "RichText": {
+      "allOf": [
+        {
+          "$ref": "#/$defs/ItemBase"
+        },
+        {
+          "type": "object",
+          "properties": {
+            "type": {
+              "const": "richtext"
+            },
+            "value": {
+              "type": "string"
+            },
+            "htmlFromData": {
+              "type": "boolean"
+            },
+            "canGrow": {
+              "type": "boolean"
+            },
+            "canShrink": {
+              "type": "boolean"
+            },
+            "listIndent": {
+              "type": "number"
+            },
+            "paragraphSpacing": {
+              "type": "number"
+            }
+          },
+          "required": [
+            "type"
+          ]
+        }
+      ]
+    },
+    "Image": {
+      "allOf": [
+        {
+          "$ref": "#/$defs/ItemBase"
+        },
+        {
+          "type": "object",
+          "properties": {
+            "type": {
+              "const": "image"
+            },
+            "src": {
+              "x-ts": "Expr<string>",
+              "description": "URL, data URI, \"embedded:name\" (the report's images), or a field holding base64 text or bytes"
+            },
+            "fit": {
+              "enum": [
+                "contain",
+                "cover",
+                "fill",
+                "clip"
+              ]
+            },
+            "autoSize": {
+              "type": "boolean",
+              "description": "size the box to the image (96 dpi); data and embedded images only"
+            }
+          },
+          "required": [
+            "type"
+          ]
+        }
+      ]
+    },
+    "Line": {
+      "allOf": [
+        {
+          "$ref": "#/$defs/ItemBase"
+        },
+        {
+          "type": "object",
+          "properties": {
+            "type": {
+              "const": "line"
+            },
+            "direction": {
+              "enum": [
+                "down",
+                "up"
+              ]
+            }
+          },
+          "required": [
+            "type"
+          ]
+        }
+      ]
+    },
+    "Shape": {
+      "allOf": [
+        {
+          "$ref": "#/$defs/ItemBase"
+        },
+        {
+          "type": "object",
+          "properties": {
+            "type": {
+              "const": "shape"
+            },
+            "shape": {
+              "enum": [
+                "rect",
+                "ellipse"
+              ]
+            }
+          },
+          "required": [
+            "type"
+          ]
+        }
+      ]
+    },
+    "SortSpec": {
+      "type": "object",
+      "description": "One sort key: the rows (or groups) are ordered by by, ascending or descending.",
+      "properties": {
+        "by": {
+          "x-ts": "Expr",
+          "description": "the expression to sort by, e.g. =Fields.name"
+        },
+        "dir": {
+          "enum": [
+            "asc",
+            "desc"
+          ],
+          "description": "asc (default) or desc"
+        }
+      },
+      "required": [
+        "by"
+      ],
+      "additionalProperties": false
+    },
+    "TableCell": {
+      "type": "object",
+      "properties": {
+        "value": {
+          "x-ts": "Expr"
+        },
+        "sortBy": {
+          "x-ts": "Expr",
+          "description": "a header cell's interactive sort: the viewer orders the rows by this expression when the header is clicked"
+        },
+        "style": {
+          "$ref": "#/$defs/Style"
+        },
+        "colSpan": {
+          "type": "number",
+          "description": "columns this cell spans. Either list one entry per column (null under the span), or omit the spanned cells (RDL/HTML style: a row with fewer cells than columns)"
+        },
+        "rowSpan": {
+          "type": "number",
+          "description": "merged down over this many rows of the same band (header, a group's rows, one record's detail rows, footer)"
+        },
+        "item": {
+          "$ref": "#/$defs/Item",
+          "description": "an item laid out inside the cell, scoped to the row (a related data set gets that row's children)"
+        },
+        "action": {
+          "$ref": "#/$defs/Action"
+        }
+      },
+      "additionalProperties": true
+    },
+    "TableRow": {
+      "type": "object",
+      "properties": {
+        "cells": {
+          "type": "array",
+          "items": {
+            "x-ts": "TableCell | null",
+            "anyOf": [
+              {
+                "$ref": "#/$defs/TableCell"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          }
+        },
+        "height": {
+          "type": "number"
+        },
+        "style": {
+          "$ref": "#/$defs/Style"
+        }
+      },
+      "required": [
+        "cells"
+      ],
+      "additionalProperties": true
+    },
+    "TableGroup": {
+      "type": "object",
+      "properties": {
+        "expr": {
+          "type": "string"
+        },
+        "name": {
+          "type": "string"
+        },
+        "header": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/TableRow"
+          }
+        },
+        "footer": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/TableRow"
+          }
+        },
+        "sort": {
+          "enum": [
+            "asc",
+            "desc",
+            "none"
+          ],
+          "description": "orders the groups by their value (asc or desc); sortBy orders them by an expression"
+        },
+        "sortBy": {
+          "x-ts": "Expr",
+          "description": "orders the groups by this expression, evaluated in each group's scope (e.g. =Sum(Fields.amount)); the interactive sort on a header wins"
+        },
+        "pageBreak": {
+          "type": "string"
+        },
+        "collapsible": {
+          "type": "boolean"
+        },
+        "initiallyCollapsed": {
+          "type": "boolean"
+        },
+        "parent": {
+          "x-ts": "Expr",
+          "description": "recursive hierarchy: the parent's id; expr is the node's id. Level() is the depth."
+        },
+        "indent": {
+          "type": "number"
+        },
+        "expandLevels": {
+          "type": "number"
+        },
+        "newSection": {
+          "type": "boolean",
+          "description": "each instance starts on a new page and restarts Globals.PageNumber / TotalPages"
+        }
+      },
+      "required": [
+        "expr"
+      ],
+      "additionalProperties": true
+    },
+    "Table": {
+      "allOf": [
+        {
+          "$ref": "#/$defs/ItemBase"
+        },
+        {
+          "type": "object",
+          "properties": {
+            "type": {
+              "const": "table"
+            },
+            "columns": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "width": {
+                    "type": "number"
+                  }
+                },
+                "required": [
+                  "width"
+                ],
+                "additionalProperties": true
+              }
+            },
+            "header": {
+              "type": "array",
+              "items": {
+                "$ref": "#/$defs/TableRow"
+              }
+            },
+            "groups": {
+              "type": "array",
+              "items": {
+                "$ref": "#/$defs/TableGroup"
+              }
+            },
+            "detail": {
+              "type": "array",
+              "items": {
+                "$ref": "#/$defs/TableRow"
+              }
+            },
+            "footer": {
+              "type": "array",
+              "items": {
+                "$ref": "#/$defs/TableRow"
+              }
+            },
+            "repeatHeader": {
+              "type": "boolean"
+            },
+            "widowControl": {
+              "type": "boolean",
+              "description": "Default true: a group of four or more rows never leaves one of its rows alone at a page foot or head, and a group of two or three rows that fits a page moves whole to the next page. false lets a break fall anywhere inside a group."
+            },
+            "fitColumns": {
+              "type": "boolean",
+              "description": "Column widths from the content: the header, the first 50 rows and the footer, in proportion, filling the table's width. Columns without a width are measured anyway."
+            },
+            "noRowsText": {
+              "type": "string"
+            },
+            "sort": {
+              "type": "array",
+              "items": {
+                "$ref": "#/$defs/SortSpec"
+              },
+              "description": "rows ordered by these entries, in order"
+            },
+            "filters": {
+              "type": "array",
+              "items": {}
+            },
+            "printAtBottom": {
+              "type": "boolean",
+              "description": "the footer at the bottom of the page the table ends on"
+            },
+            "overflow": {
+              "enum": [
+                "clip",
+                "paginate",
+                "shrink"
+              ],
+              "description": "wider than the page: continue on the next page set, repeating the first repeatColumns columns"
+            },
+            "repeatColumns": {
+              "type": "number"
+            },
+            "pageOrder": {
+              "enum": [
+                "down",
+                "across"
+              ]
+            },
+            "overflowTo": {
+              "type": "string",
+              "description": "fixed frame: continue rows in"
+            }
+          },
+          "required": [
+            "type",
+            "columns"
+          ]
+        }
+      ]
+    },
+    "Container": {
+      "allOf": [
+        {
+          "$ref": "#/$defs/ItemBase"
+        },
+        {
+          "type": "object",
+          "properties": {
+            "type": {
+              "const": "container"
+            },
+            "items": {
+              "type": "array",
+              "items": {
+                "$ref": "#/$defs/Item"
+              }
+            }
+          },
+          "required": [
+            "type",
+            "items"
+          ]
+        }
+      ]
+    },
+    "List": {
+      "allOf": [
+        {
+          "$ref": "#/$defs/ItemBase"
+        },
+        {
+          "type": "object",
+          "properties": {
+            "type": {
+              "const": "list"
+            },
+            "items": {
+              "type": "array",
+              "items": {
+                "$ref": "#/$defs/Item"
+              }
+            },
+            "groupBy": {
+              "x-ts": "Expr<string>"
+            },
+            "pageBreakBetween": {
+              "type": "boolean"
+            },
+            "sort": {
+              "type": "array",
+              "items": {
+                "$ref": "#/$defs/SortSpec"
+              },
+              "description": "rows ordered by these entries, in order"
+            },
+            "filters": {
+              "type": "array",
+              "items": {}
+            },
+            "columns": {
+              "type": "number",
+              "description": "records across (a grid list)"
+            },
+            "columnGap": {
+              "type": "number"
+            },
+            "newSection": {
+              "type": "boolean"
+            },
+            "groupAdjacent": {
+              "type": "boolean",
+              "description": "a new group at every change (not sorted)"
+            },
+            "inheritRows": {
+              "type": "boolean",
+              "description": "rows of the enclosing list row"
+            }
+          },
+          "required": [
+            "type",
+            "items"
+          ]
+        }
+      ]
+    },
+    "CheckBox": {
+      "allOf": [
+        {
+          "$ref": "#/$defs/ItemBase"
+        },
+        {
+          "type": "object",
+          "properties": {
+            "type": {
+              "const": "checkbox"
+            },
+            "value": {
+              "x-ts": "Expr<boolean>"
+            },
+            "text": {
+              "x-ts": "Expr<string>"
+            }
+          },
+          "required": [
+            "type"
+          ]
+        }
+      ]
+    },
+    "ChartAxis": {
+      "type": "object",
+      "properties": {
+        "title": {
+          "type": "string"
+        },
+        "format": {
+          "type": "string"
+        },
+        "min": {
+          "type": "number"
+        },
+        "max": {
+          "type": "number"
+        },
+        "log": {
+          "type": "boolean"
+        },
+        "gridlines": {
+          "type": "boolean"
+        },
+        "labelAngle": {
+          "type": "number",
+          "description": "category axis only: turn the labels, e.g. -45"
+        },
+        "reversed": {
+          "type": "boolean"
+        }
+      }
+    },
+    "ChartSeries": {
+      "type": "object",
+      "properties": {
+        "name": {
+          "type": "string"
+        },
+        "value": {
+          "x-ts": "Expr"
+        },
+        "color": {
+          "type": "string"
+        },
+        "type": {
+          "enum": [
+            "column",
+            "bar",
+            "line",
+            "area"
+          ],
+          "description": "combo charts: draw this series as columns, a line or an area"
+        },
+        "axis": {
+          "enum": [
+            "primary",
+            "secondary"
+          ]
+        },
+        "low": {
+          "x-ts": "Expr",
+          "description": "a range series (low + high), or with open + close a candlestick / OHLC series"
+        },
+        "high": {
+          "x-ts": "Expr"
+        },
+        "open": {
+          "x-ts": "Expr"
+        },
+        "close": {
+          "x-ts": "Expr"
+        },
+        "size": {
+          "x-ts": "Expr",
+          "description": "bubble size, per row"
+        },
+        "line": {
+          "enum": [
+            "straight",
+            "smooth",
+            "step"
+          ]
+        }
+      },
+      "additionalProperties": true
+    },
+    "ChartOverlay": {
+      "anyOf": [
+        {
+          "type": "object",
+          "properties": {
+            "type": {
+              "const": "trend"
+            },
+            "kind": {
+              "enum": [
+                "linear",
+                "exp",
+                "poly"
+              ]
+            },
+            "order": {
+              "type": "number"
+            },
+            "series": {
+              "type": "number"
+            },
+            "color": {
+              "type": "string"
+            },
+            "label": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "type"
+          ]
+        },
+        {
+          "type": "object",
+          "properties": {
+            "type": {
+              "const": "movingAverage"
+            },
+            "period": {
+              "type": "number"
+            },
+            "series": {
+              "type": "number"
+            },
+            "color": {
+              "type": "string"
+            },
+            "label": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "type"
+          ]
+        },
+        {
+          "type": "object",
+          "properties": {
+            "type": {
+              "const": "line"
+            },
+            "value": {
+              "x-ts": "number | Expr"
+            },
+            "axis": {
+              "enum": [
+                "primary",
+                "secondary"
+              ]
+            },
+            "color": {
+              "type": "string"
+            },
+            "label": {
+              "type": "string"
+            },
+            "showValue": {
+              "type": "boolean"
+            }
+          },
+          "required": [
+            "type",
+            "value"
+          ]
+        },
+        {
+          "type": "object",
+          "properties": {
+            "type": {
+              "const": "band"
+            },
+            "from": {
+              "x-ts": "number | Expr"
+            },
+            "to": {
+              "x-ts": "number | Expr"
+            },
+            "axis": {
+              "enum": [
+                "primary",
+                "secondary"
+              ]
+            },
+            "color": {
+              "type": "string"
+            },
+            "label": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "type",
+            "from",
+            "to"
+          ]
+        }
+      ]
+    },
+    "ChartPalette": {
+      "enum": [
+        "default",
+        "office",
+        "colorblind",
+        "vivid",
+        "pastel",
+        "ocean",
+        "sunset",
+        "forest",
+        "berry",
+        "earth",
+        "grayscale",
+        "highContrast"
+      ]
+    },
+    "Chart": {
+      "allOf": [
+        {
+          "$ref": "#/$defs/ItemBase"
+        },
+        {
+          "type": "object",
+          "properties": {
+            "type": {
+              "const": "chart"
+            },
+            "chartType": {
+              "enum": [
+                "column",
+                "bar",
+                "line",
+                "area",
+                "pie",
+                "donut",
+                "scatter",
+                "bubble",
+                "radar",
+                "polar",
+                "candlestick",
+                "ohlc",
+                "gauge",
+                "funnel",
+                "treemap",
+                "histogram",
+                "boxplot",
+                "waterfall",
+                "gantt"
+              ]
+            },
+            "title": {
+              "x-ts": "Expr<string>"
+            },
+            "category": {
+              "x-ts": "Expr<string>"
+            },
+            "categorySort": {
+              "enum": [
+                "asc",
+                "desc"
+              ]
+            },
+            "categoryFormat": {
+              "type": "string"
+            },
+            "series": {
+              "type": "array",
+              "items": {
+                "$ref": "#/$defs/ChartSeries"
+              }
+            },
+            "seriesGroup": {
+              "x-ts": "Expr<string>"
+            },
+            "stacked": {
+              "x-ts": "boolean | 'percent'"
+            },
+            "showValues": {
+              "type": "boolean"
+            },
+            "valueFormat": {
+              "type": "string"
+            },
+            "legend": {
+              "enum": [
+                "bottom",
+                "none"
+              ]
+            },
+            "xValue": {
+              "x-ts": "Expr"
+            },
+            "pointAction": {
+              "$ref": "#/$defs/Action"
+            },
+            "pointColor": {
+              "x-ts": "Expr<string>"
+            },
+            "tooltips": {
+              "type": "boolean"
+            },
+            "xTitle": {
+              "type": "string"
+            },
+            "fontSize": {
+              "type": "number"
+            },
+            "background": {
+              "type": "string"
+            },
+            "maxCategories": {
+              "type": "number"
+            },
+            "outliers": {
+              "enum": [
+                "clip",
+                "none"
+              ],
+              "description": "Scatter and bubble. clip: the axes stop at the 1st and 99th percentiles; points beyond are drawn at the edge with a ring and a warning. none: the full range. Unset: clip when 20 or more points have an extreme spread (full range over 5x the 1st-99th percentile range), else none"
+            },
+            "line": {
+              "enum": [
+                "straight",
+                "smooth",
+                "step"
+              ]
+            },
+            "axes": {
+              "type": "object",
+              "properties": {
+                "x": {
+                  "$ref": "#/$defs/ChartAxis"
+                },
+                "y": {
+                  "$ref": "#/$defs/ChartAxis"
+                },
+                "y2": {
+                  "$ref": "#/$defs/ChartAxis"
+                }
+              }
+            },
+            "overlays": {
+              "type": "array",
+              "items": {
+                "$ref": "#/$defs/ChartOverlay"
+              }
+            },
+            "labelTemplate": {
+              "type": "string",
+              "description": "{value} {category} {series} {percent}, or an =expression in the point's scope"
+            },
+            "labelPosition": {
+              "enum": [
+                "outside",
+                "inside",
+                "center"
+              ]
+            },
+            "palette": {
+              "x-ts": "ChartPalette | string[]"
+            },
+            "colorByCategory": {
+              "type": "boolean",
+              "description": "opt-in: each category (pie, donut, funnel slices; seriesGroup series) keeps one colour in every chart of the report that sets it; off: colours by position"
+            },
+            "animation": {
+              "enum": [
+                "none",
+                "grow",
+                "fade"
+              ],
+              "description": "viewer only; exports stay static"
+            },
+            "upColor": {
+              "type": "string"
+            },
+            "downColor": {
+              "type": "string"
+            },
+            "binCount": {
+              "type": "number",
+              "description": "number of bins (empty: automatic)"
+            },
+            "binWidth": {
+              "type": "number",
+              "description": "bin width (instead of a number of bins)"
+            },
+            "showMean": {
+              "type": "boolean",
+              "description": "mark the mean"
+            },
+            "waterfallTotals": {
+              "x-ts": "Expr",
+              "description": "subtotal bar when (e.g. =Fields.isTotal)"
+            },
+            "showTotal": {
+              "type": "boolean",
+              "description": "total bar at the end"
+            },
+            "totalLabel": {
+              "type": "string",
+              "description": "total bar label"
+            },
+            "totalColor": {
+              "type": "string",
+              "description": "total colour"
+            },
+            "ganttStart": {
+              "x-ts": "Expr",
+              "description": "bar start (date or number)"
+            },
+            "ganttEnd": {
+              "x-ts": "Expr",
+              "description": "bar end (date or number)"
+            },
+            "ganttToday": {
+              "type": "boolean",
+              "description": "today line"
+            },
+            "todayColor": {
+              "type": "string",
+              "description": "today line colour"
+            },
+            "gaugeShape": {
+              "enum": [
+                "half",
+                "threeQuarter",
+                "full"
+              ],
+              "description": "gauge shape"
+            },
+            "gaugeIndicator": {
+              "enum": [
+                "needle",
+                "pointer",
+                "bar"
+              ],
+              "description": "value shown by"
+            },
+            "pointerColor": {
+              "type": "string",
+              "description": "needle or pointer colour"
+            },
+            "gaugeTicks": {
+              "type": "boolean",
+              "description": "tick marks and values"
+            }
+          },
+          "required": [
+            "type"
+          ]
+        }
+      ]
+    },
+    "FormField": {
+      "allOf": [
+        {
+          "$ref": "#/$defs/ItemBase"
+        },
+        {
+          "type": "object",
+          "properties": {
+            "type": {
+              "const": "field"
+            },
+            "kind": {
+              "enum": [
+                "text",
+                "multiline",
+                "checkbox",
+                "choice"
+              ]
+            },
+            "fieldName": {
+              "x-ts": "Expr<string>"
+            },
+            "value": {
+              "x-ts": "Expr"
+            },
+            "options": {
+              "x-ts": "Expr"
+            },
+            "required": {
+              "type": "boolean"
+            },
+            "readOnly": {
+              "type": "boolean"
+            }
+          },
+          "required": [
+            "type"
+          ]
+        }
+      ]
+    },
+    "MapItem": {
+      "allOf": [
+        {
+          "$ref": "#/$defs/ItemBase"
+        },
+        {
+          "type": "object",
+          "properties": {
+            "type": {
+              "const": "map"
+            },
+            "geojson": {
+              "type": "string"
+            },
+            "geometry": {
+              "x-ts": "Expr"
+            },
+            "shapeKey": {
+              "x-ts": "Expr<string>"
+            },
+            "valueDataSet": {
+              "type": "string"
+            },
+            "valueKey": {
+              "x-ts": "Expr<string>"
+            },
+            "value": {
+              "x-ts": "Expr<number>"
+            },
+            "valueFormat": {
+              "type": "string"
+            },
+            "colorLow": {
+              "type": "string"
+            },
+            "colorHigh": {
+              "type": "string"
+            },
+            "legend": {
+              "enum": [
+                "bottom",
+                "none"
+              ]
+            },
+            "pointDataSet": {
+              "type": "string"
+            },
+            "lat": {
+              "x-ts": "Expr<number>"
+            },
+            "lon": {
+              "x-ts": "Expr<number>"
+            },
+            "pointSize": {
+              "x-ts": "Expr<number>"
+            },
+            "pointLabel": {
+              "x-ts": "Expr<string>"
+            },
+            "pointColor": {
+              "type": "string"
+            },
+            "colorScale": {
+              "enum": [
+                "continuous",
+                "classes"
+              ],
+              "description": "colour scale"
+            },
+            "classes": {
+              "type": "number",
+              "description": "number of classes (2–9)"
+            },
+            "lineColor": {
+              "type": "string",
+              "description": "lines: colour (LineString shapes)"
+            },
+            "lineWidth": {
+              "type": "number",
+              "description": "lines: width (pt)"
+            },
+            "regionAction": {
+              "$ref": "#/$defs/Action",
+              "description": "click on a region"
+            },
+            "tooltips": {
+              "type": "boolean",
+              "description": "tooltips on hover"
+            }
+          },
+          "required": [
+            "type"
+          ]
+        }
+      ]
+    },
+    "Sparkline": {
+      "allOf": [
+        {
+          "$ref": "#/$defs/ItemBase"
+        },
+        {
+          "type": "object",
+          "properties": {
+            "type": {
+              "const": "sparkline"
+            },
+            "category": {
+              "x-ts": "Expr"
+            },
+            "value": {
+              "x-ts": "Expr<number>"
+            },
+            "color": {
+              "type": "string"
+            },
+            "style": {
+              "x-ts": "'line' | 'column' | 'area' | 'winloss'",
+              "enum": [
+                "line",
+                "column",
+                "area",
+                "winloss"
+              ]
+            },
+            "bandLow": {
+              "x-ts": "Expr<number>"
+            },
+            "bandHigh": {
+              "x-ts": "Expr<number>"
+            },
+            "bandColor": {
+              "type": "string"
+            },
+            "negColor": {
+              "type": "string"
+            },
+            "negativeColor": {
+              "type": "string",
+              "description": "data bars: the colour of a bar with a negative value (default #dc2626)"
+            }
+          },
+          "required": [
+            "type"
+          ]
+        }
+      ]
+    },
+    "DataBar": {
+      "allOf": [
+        {
+          "$ref": "#/$defs/ItemBase"
+        },
+        {
+          "type": "object",
+          "properties": {
+            "type": {
+              "const": "databar"
+            },
+            "value": {
+              "x-ts": "Expr<number>"
+            },
+            "max": {
+              "x-ts": "Expr<number>"
+            },
+            "color": {
+              "type": "string"
+            },
+            "negativeColor": {
+              "type": "string",
+              "description": "the colour of a bar with a negative value (default #dc2626)"
+            }
+          },
+          "required": [
+            "type"
+          ]
+        }
+      ]
+    },
+    "Bullet": {
+      "allOf": [
+        {
+          "$ref": "#/$defs/ItemBase"
+        },
+        {
+          "type": "object",
+          "properties": {
+            "type": {
+              "const": "bullet"
+            },
+            "value": {
+              "x-ts": "Expr<number>"
+            },
+            "max": {
+              "x-ts": "Expr<number>"
+            },
+            "target": {
+              "x-ts": "Expr<number>"
+            },
+            "color": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "type"
+          ]
+        }
+      ]
+    },
+    "IconSet": {
+      "allOf": [
+        {
+          "$ref": "#/$defs/ItemBase"
+        },
+        {
+          "type": "object",
+          "properties": {
+            "type": {
+              "const": "iconset"
+            },
+            "value": {
+              "x-ts": "Expr<number>"
+            },
+            "iconSet": {
+              "enum": [
+                "trafficLights",
+                "arrows",
+                "symbols",
+                "flags",
+                "ratings"
+              ]
+            },
+            "lower": {
+              "x-ts": "Expr<number>"
+            },
+            "upper": {
+              "x-ts": "Expr<number>"
+            },
+            "reverse": {
+              "type": "boolean",
+              "description": "reverse order (higher is worse)"
+            }
+          },
+          "required": [
+            "type"
+          ]
+        }
+      ]
+    },
+    "RangeBar": {
+      "allOf": [
+        {
+          "$ref": "#/$defs/ItemBase"
+        },
+        {
+          "type": "object",
+          "properties": {
+            "type": {
+              "const": "rangebar"
+            },
+            "low": {
+              "x-ts": "Expr<number>"
+            },
+            "high": {
+              "x-ts": "Expr<number>"
+            },
+            "min": {
+              "x-ts": "Expr<number>"
+            },
+            "max": {
+              "x-ts": "Expr<number>"
+            },
+            "color": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "type"
+          ]
+        }
+      ]
+    },
+    "Barcode": {
+      "allOf": [
+        {
+          "$ref": "#/$defs/ItemBase"
+        },
+        {
+          "type": "object",
+          "properties": {
+            "type": {
+              "const": "barcode"
+            },
+            "symbology": {
+              "type": "string",
+              "description": "a bwip-js id: code128, qrcode, datamatrix, pdf417, ean13, gs1-128, …"
+            },
+            "value": {
+              "x-ts": "Expr<string>"
+            },
+            "showText": {
+              "type": "boolean"
+            },
+            "captionPosition": {
+              "enum": [
+                "below",
+                "above"
+              ]
+            },
+            "quietZone": {
+              "type": "number",
+              "description": "points of white around the code"
+            },
+            "rotate": {
+              "x-ts": "0 | 90 | 180 | 270 | '0' | '90' | '180' | '270'",
+              "enum": [
+                0,
+                90,
+                180,
+                270,
+                "0",
+                "90",
+                "180",
+                "270"
+              ]
+            },
+            "qrErrorLevel": {
+              "enum": [
+                "L",
+                "M",
+                "Q",
+                "H"
+              ]
+            },
+            "qrVersion": {
+              "type": "number"
+            },
+            "qrMask": {
+              "type": "number"
+            },
+            "dmShape": {
+              "enum": [
+                "square",
+                "rectangle"
+              ]
+            },
+            "dmSize": {
+              "type": "string"
+            },
+            "pdfColumns": {
+              "type": "number"
+            },
+            "pdfRows": {
+              "type": "number"
+            },
+            "pdfErrorLevel": {
+              "type": "number"
+            },
+            "pdfCompact": {
+              "type": "boolean"
+            },
+            "aztecLayers": {
+              "type": "number"
+            },
+            "aztecErrorPercent": {
+              "type": "number"
+            },
+            "maxiMode": {
+              "type": "number"
+            },
+            "checkDigit": {
+              "type": "boolean"
+            },
+            "barRatio": {
+              "type": "number"
+            }
+          },
+          "required": [
+            "type"
+          ]
+        }
+      ]
+    },
+    "PivotGroup": {
+      "type": "object",
+      "properties": {
+        "expr": {
+          "x-ts": "Expr"
+        },
+        "name": {
+          "type": "string"
+        },
+        "label": {
+          "x-ts": "Expr<string>"
+        },
+        "format": {
+          "type": "string"
+        },
+        "sort": {
+          "enum": [
+            "asc",
+            "desc",
+            "none"
+          ]
+        },
+        "sortBy": {
+          "x-ts": "Expr"
+        },
+        "total": {
+          "enum": [
+            "none",
+            "before",
+            "after"
+          ],
+          "description": "a total of this group's instances inside the group above (the first group's total is the grand total)"
+        },
+        "totalLabel": {
+          "type": "string"
+        },
+        "collapsible": {
+          "type": "boolean"
+        },
+        "initiallyCollapsed": {
+          "type": "boolean"
+        },
+        "width": {
+          "type": "number",
+          "description": "row groups: the header column's width and title"
+        },
+        "header": {
+          "type": "string"
+        },
+        "style": {
+          "$ref": "#/$defs/Style"
+        }
+      },
+      "required": [
+        "expr"
+      ]
+    },
+    "PivotValue": {
+      "type": "object",
+      "properties": {
+        "value": {
+          "x-ts": "Expr"
+        },
+        "name": {
+          "type": "string"
+        },
+        "label": {
+          "type": "string"
+        },
+        "format": {
+          "type": "string"
+        },
+        "show": {
+          "enum": [
+            "value",
+            "percentOfTotal",
+            "percentOfRow",
+            "percentOfColumn"
+          ]
+        },
+        "width": {
+          "type": "number"
+        },
+        "style": {
+          "$ref": "#/$defs/Style"
+        }
+      },
+      "required": [
+        "value"
+      ]
+    },
+    "Matrix": {
+      "allOf": [
+        {
+          "$ref": "#/$defs/ItemBase"
+        },
+        {
+          "type": "object",
+          "properties": {
+            "type": {
+              "const": "matrix"
+            },
+            "rowGroups": {
+              "type": "array",
+              "items": {
+                "$ref": "#/$defs/PivotGroup"
+              },
+              "description": "the tablix form: nested row and column groups, several values"
+            },
+            "columnGroups": {
+              "type": "array",
+              "items": {
+                "$ref": "#/$defs/PivotGroup"
+              }
+            },
+            "values": {
+              "type": "array",
+              "items": {
+                "$ref": "#/$defs/PivotValue"
+              }
+            },
+            "overflow": {
+              "enum": [
+                "paginate",
+                "shrink",
+                "clip"
+              ]
+            },
+            "pageOrder": {
+              "enum": [
+                "down",
+                "across"
+              ]
+            },
+            "rowGroup": {
+              "x-ts": "Expr<string>",
+              "description": "the older single-group form (still read when the arrays are absent)"
+            },
+            "columnGroup": {
+              "x-ts": "Expr<string>"
+            },
+            "value": {
+              "x-ts": "Expr"
+            },
+            "valueFormat": {
+              "type": "string"
+            },
+            "rowSort": {
+              "enum": [
+                "asc",
+                "desc",
+                "none"
+              ]
+            },
+            "columnSort": {
+              "enum": [
+                "asc",
+                "desc",
+                "none"
+              ]
+            },
+            "rowTotals": {
+              "type": "boolean"
+            },
+            "columnTotals": {
+              "type": "boolean"
+            },
+            "corner": {
+              "type": "string"
+            },
+            "rowHeaderWidth": {
+              "type": "number"
+            },
+            "columnWidth": {
+              "type": "number"
+            },
+            "repeatHeader": {
+              "type": "boolean"
+            },
+            "headerStyle": {
+              "$ref": "#/$defs/Style"
+            },
+            "cellStyle": {
+              "$ref": "#/$defs/Style"
+            },
+            "totalStyle": {
+              "$ref": "#/$defs/Style"
+            }
+          },
+          "required": [
+            "type"
+          ]
+        }
+      ]
+    },
+    "Subreport": {
+      "allOf": [
+        {
+          "$ref": "#/$defs/ItemBase"
+        },
+        {
+          "type": "object",
+          "properties": {
+            "type": {
+              "const": "subreport"
+            },
+            "report": {
+              "type": "string"
+            },
+            "params": {
+              "x-ts": "Record<string, Expr>",
+              "type": "object"
+            }
+          },
+          "required": [
+            "type",
+            "report"
+          ]
+        }
+      ]
+    },
+    "TableOfContents": {
+      "allOf": [
+        {
+          "$ref": "#/$defs/ItemBase"
+        },
+        {
+          "type": "object",
+          "properties": {
+            "type": {
+              "const": "toc"
+            },
+            "title": {
+              "type": "string"
+            },
+            "levels": {
+              "type": "number"
+            },
+            "source": {
+              "enum": [
+                "bookmarks",
+                "headings"
+              ],
+              "description": "bookmarks (default) or text boxes with a headingLevel"
+            },
+            "numbering": {
+              "x-ts": "string | ('decimal' | 'roman' | 'alpha')[]",
+              "description": "decimal, roman or alpha; one per level as an array or \"roman,alpha\" (the last repeats)"
+            }
+          },
+          "required": [
+            "type"
+          ]
+        }
+      ]
+    },
+    "Item": {
+      "anyOf": [
+        {
+          "$ref": "#/$defs/TextBox"
+        },
+        {
+          "$ref": "#/$defs/RichText"
+        },
+        {
+          "$ref": "#/$defs/Image"
+        },
+        {
+          "$ref": "#/$defs/Line"
+        },
+        {
+          "$ref": "#/$defs/Shape"
+        },
+        {
+          "$ref": "#/$defs/Table"
+        },
+        {
+          "$ref": "#/$defs/Container"
+        },
+        {
+          "$ref": "#/$defs/List"
+        },
+        {
+          "$ref": "#/$defs/CheckBox"
+        },
+        {
+          "$ref": "#/$defs/Chart"
+        },
+        {
+          "$ref": "#/$defs/FormField"
+        },
+        {
+          "$ref": "#/$defs/MapItem"
+        },
+        {
+          "$ref": "#/$defs/Sparkline"
+        },
+        {
+          "$ref": "#/$defs/DataBar"
+        },
+        {
+          "$ref": "#/$defs/Bullet"
+        },
+        {
+          "$ref": "#/$defs/IconSet"
+        },
+        {
+          "$ref": "#/$defs/RangeBar"
+        },
+        {
+          "$ref": "#/$defs/Barcode"
+        },
+        {
+          "$ref": "#/$defs/Matrix"
+        },
+        {
+          "$ref": "#/$defs/Subreport"
+        },
+        {
+          "$ref": "#/$defs/TableOfContents"
+        }
+      ]
+    },
+    "ItemType": {
+      "x-ts-decl": "export type ItemType = Item['type'];"
+    },
+    "Band": {
+      "type": "object",
+      "properties": {
+        "height": {
+          "type": "number"
+        },
+        "items": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/Item"
+          }
+        },
+        "printOnFirstPage": {
+          "type": "boolean"
+        },
+        "printOnLastPage": {
+          "type": "boolean"
+        },
+        "columns": {
+          "type": "object",
+          "properties": {
+            "count": {
+              "type": "number"
+            },
+            "gap": {
+              "type": "number"
+            }
+          },
+          "required": [
+            "count"
+          ]
+        }
+      },
+      "required": [
+        "items"
+      ]
+    },
+    "BodySection": {
+      "description": "A body section with its own page settings (missing keys come from the report's page).",
+      "allOf": [
+        {
+          "$ref": "#/$defs/Band"
+        },
+        {
+          "type": "object",
+          "properties": {
+            "name": {
+              "type": "string"
+            },
+            "page": {
+              "x-ts": "Report['page']",
+              "type": "object"
+            }
+          }
+        }
+      ]
+    },
+    "Field": {
+      "type": "object",
+      "properties": {
+        "name": {
+          "type": "string"
+        },
+        "type": {
+          "enum": [
+            "string",
+            "number",
+            "integer",
+            "boolean",
+            "date",
+            "datetime"
+          ],
+          "description": "'string' keeps text as text: an ISO date string in it is not turned into a date"
+        },
+        "path": {
+          "type": "string"
+        },
+        "expr": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "name"
+      ]
+    },
+    "Parameter": {
+      "type": "object",
+      "properties": {
+        "name": {
+          "type": "string"
+        },
+        "type": {
+          "enum": [
+            "string",
+            "number",
+            "integer",
+            "boolean",
+            "date",
+            "datetime"
+          ]
+        },
+        "prompt": {
+          "type": "string"
+        },
+        "default": {},
+        "required": {
+          "type": "boolean"
+        },
+        "multi": {
+          "type": "boolean"
+        },
+        "hidden": {
+          "type": "boolean"
+        },
+        "options": {
+          "type": "array",
+          "items": {
+            "x-ts": "string | number | { value: unknown; label?: string }"
+          }
+        },
+        "optionsFrom": {
+          "type": "object",
+          "properties": {
+            "dataSet": {
+              "type": "string"
+            },
+            "value": {
+              "type": "string"
+            },
+            "label": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "dataSet",
+            "value"
+          ]
+        },
+        "editor": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "name"
+      ],
+      "additionalProperties": true
+    },
+    "DataSource": {
+      "anyOf": [
+        {
+          "type": "object",
+          "properties": {
+            "name": {
+              "type": "string"
+            },
+            "type": {
+              "const": "json"
+            },
+            "data": {}
+          },
+          "required": [
+            "name",
+            "type",
+            "data"
+          ]
+        },
+        {
+          "type": "object",
+          "properties": {
+            "name": {
+              "type": "string"
+            },
+            "type": {
+              "const": "csv"
+            },
+            "data": {
+              "type": "string"
+            },
+            "url": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "name",
+            "type"
+          ],
+          "additionalProperties": true
+        },
+        {
+          "type": "object",
+          "properties": {
+            "name": {
+              "type": "string"
+            },
+            "type": {
+              "enum": [
+                "rest",
+                "graphql"
+              ]
+            },
+            "url": {
+              "type": "string"
+            },
+            "method": {
+              "type": "string"
+            },
+            "headers": {
+              "x-ts": "Record<string, string>",
+              "type": "object"
+            },
+            "query": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "name",
+            "type",
+            "url"
+          ],
+          "additionalProperties": true
+        },
+        {
+          "type": "object",
+          "properties": {
+            "name": {
+              "type": "string"
+            },
+            "type": {
+              "const": "sql"
+            },
+            "connection": {
+              "type": "string"
+            },
+            "query": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "name",
+            "type",
+            "connection",
+            "query"
+          ],
+          "additionalProperties": true
+        }
+      ]
+    },
+    "DataSet": {
+      "type": "object",
+      "properties": {
+        "name": {
+          "type": "string"
+        },
+        "source": {
+          "type": "string"
+        },
+        "path": {
+          "type": "string"
+        },
+        "detectDates": {
+          "type": "boolean",
+          "description": "false: strings that look like ISO dates stay text (default true: they become dates when fields are detected)"
+        },
+        "fields": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/Field"
+          },
+          "description": "the fields, typed; none: detected from the rows"
+        },
+        "filters": {
+          "type": "array",
+          "items": {}
+        },
+        "sort": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/SortSpec"
+          },
+          "description": "rows ordered by these entries, in order"
+        }
+      },
+      "required": [
+        "name",
+        "source"
+      ],
+      "additionalProperties": true
+    },
+    "Report": {
+      "description": "A ReportWright report definition (pagewright/report@1).",
+      "type": "object",
+      "properties": {
+        "$schema": {
+          "description": "pagewright/report@1; reportwright/report@1 is the same format under the new name.",
+          "enum": [
+            "pagewright/report@1",
+            "reportwright/report@1"
+          ]
+        },
+        "name": {
+          "type": "string"
+        },
+        "description": {
+          "type": "string"
+        },
+        "locale": {
+          "type": "string"
+        },
+        "currency": {
+          "type": "string",
+          "description": "ISO 4217 code for C formats; none: the locale's own currency (en-IN: INR)"
+        },
+        "nonFinite": {
+          "enum": [
+            "blank",
+            "error"
+          ],
+          "description": "how Infinity and NaN (1/0, 0/0) print: as SSRS (default), blank, or #Error"
+        },
+        "grouping": {
+          "enum": [
+            "always",
+            "never"
+          ],
+          "description": "digit grouping of numbers: as the locale's rule (default, Intl/CLDR: es-ES 1234,50), always, or never"
+        },
+        "page": {
+          "type": "object",
+          "properties": {
+            "size": {
+              "x-ts": "'A4' | 'A3' | 'A5' | 'Letter' | 'Legal' | 'Pageless' | string | [number, number]"
+            },
+            "orientation": {
+              "enum": [
+                "portrait",
+                "landscape"
+              ]
+            },
+            "margins": {
+              "x-ts": "[number, number, number, number] | number",
+              "description": "top, right, bottom, left in points"
+            },
+            "width": {
+              "type": "number"
+            },
+            "height": {
+              "type": "number"
+            }
+          },
+          "additionalProperties": true
+        },
+        "parameters": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/Parameter"
+          }
+        },
+        "parameterLayout": {},
+        "liveParameters": {
+          "type": "boolean"
+        },
+        "dataSources": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/DataSource"
+          }
+        },
+        "dataSets": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/DataSet"
+          }
+        },
+        "styles": {
+          "type": "object",
+          "properties": {
+            "base": {
+              "$ref": "#/$defs/Style"
+            },
+            "named": {
+              "x-ts": "Record<string, Style>",
+              "type": "object"
+            }
+          }
+        },
+        "images": {
+          "x-ts": "Record<string, `data:image/${string}`>",
+          "type": "object",
+          "description": "images the report carries, by name, as data:image/… URIs; an image's src \"embedded:<name>\" uses one"
+        },
+        "sections": {
+          "type": "object",
+          "properties": {
+            "pageHeader": {
+              "$ref": "#/$defs/Band"
+            },
+            "body": {
+              "x-ts": "Band | BodySection[]"
+            },
+            "pageFooter": {
+              "$ref": "#/$defs/Band"
+            }
+          },
+          "required": [
+            "body"
+          ]
+        }
+      },
+      "required": [
+        "$schema",
+        "sections"
+      ],
+      "examples": [
+        {
+          "$schema": "pagewright/report@1",
+          "name": "Invoice",
+          "page": {
+            "size": "A4",
+            "margins": [
+              36,
+              36,
+              36,
+              36
+            ]
+          },
+          "dataSources": [
+            {
+              "name": "orders",
+              "type": "json",
+              "data": {
+                "rows": [
+                  {
+                    "customer": "Asha Rao",
+                    "amount": 1200.5
+                  }
+                ]
+              }
+            }
+          ],
+          "dataSets": [
+            {
+              "name": "Rows",
+              "source": "orders",
+              "path": "$.rows"
+            }
+          ],
+          "sections": {
+            "body": {
+              "items": [
+                {
+                  "type": "textbox",
+                  "name": "Title",
+                  "x": 0,
+                  "y": 0,
+                  "w": 300,
+                  "h": 24,
+                  "value": "Invoice",
+                  "style": {
+                    "fontSize": 18,
+                    "fontWeight": "bold"
+                  }
+                },
+                {
+                  "type": "table",
+                  "name": "Lines",
+                  "x": 0,
+                  "y": 40,
+                  "w": 400,
+                  "h": 40,
+                  "dataSet": "Rows",
+                  "columns": [
+                    {
+                      "width": 250
+                    },
+                    {
+                      "width": 150
+                    }
+                  ],
+                  "header": [
+                    {
+                      "height": 18,
+                      "cells": [
+                        {
+                          "value": "Customer",
+                          "colSpan": 1
+                        },
+                        {
+                          "value": "Amount"
+                        }
+                      ]
+                    }
+                  ],
+                  "detail": [
+                    {
+                      "height": 18,
+                      "cells": [
+                        {
+                          "value": "=Fields.customer"
+                        },
+                        {
+                          "value": "=Fields.amount",
+                          "style": {
+                            "format": "C2"
+                          }
+                        }
+                      ]
+                    }
+                  ],
+                  "footer": [
+                    {
+                      "height": 18,
+                      "cells": [
+                        {
+                          "value": "Total",
+                          "colSpan": 2
+                        }
+                      ]
+                    }
+                  ]
+                }
+              ]
+            }
+          }
+        }
+      ]
+    }
+  }
+}