h17-sspdf 0.4.1 → 0.5.0

package/DOCUMENTATION.md

@@ -30,9 +30,11 @@ Controls page geometry, background, and baseline rendering state.
 ```js
 page: {
   // Page geometry
-  format: "a4",                   // only "a4" is supported
+  format: "a4",                   // named format: "a4", "letter", etc.
   orientation: "portrait",        // "portrait" or "landscape"
   unit: "mm",                     // only "mm" is supported
+  pageWidthMm: 338,               // custom width in mm (overrides format)
+  pageHeightMm: 190,              // custom height in mm (overrides format)
   compress: true,                 // PDF compression (default true)
 
   // Margins - individual margins override the shared `margin` value
@@ -76,7 +78,9 @@ page: {
 }
 ```
 
-The content area runs from `marginTop` to `pageHeight - marginBottom` vertically, and `marginLeft` to `pageWidth - marginRight` horizontally. On A4 portrait, the page is 210 × 297 mm.
+The content area runs from `marginTop` to `pageHeight - marginBottom` vertically, and `marginLeft` to `pageWidth - marginRight` horizontally. On A4 portrait, the page is 210 x 297 mm.
+
+When `pageWidthMm` and `pageHeightMm` are both set, they override the `format` field and create a page with those exact dimensions. This is useful for non-standard formats like 16:9 presentations (e.g. 338 x 190 mm). All layout math -- margins, content area, pagination -- adapts automatically.
 
 ### `labels` (required)
 
@@ -235,6 +239,7 @@ Shared layout defaults read by operation handlers.
 ```js
 layout: {
   bulletIndentMm: 4.5,     // text indent after bullet marker (default: 4)
+  chartAlign: "center",    // chart horizontal alignment: "left" (default) or "center"
 }
 ```
 
@@ -553,6 +558,16 @@ Three forms (use exactly one):
 | `px` | number | Fixed space in CSS px |
 | `label` | string | Theme label with `spaceMm` or `spacePx` |
 
+#### `pageBreak`
+
+Forces a new page. The cursor resets to the top content area. Page templates (headers/footers) are applied to the new page automatically.
+
+```json
+{ "type": "pageBreak" }
+```
+
+No fields required. Useful for presentation-style layouts where each section should start on its own page.
+
 #### `hiddenText`
 
 Renders text in the background color so it's invisible but present in the PDF text layer (for ATS keyword injection).
@@ -1714,11 +1729,12 @@ main();
 | `chartType` | yes | string | Chart.js type: `"bar"`, `"line"`, `"doughnut"`, etc. |
 | `data` | yes | object | Chart.js `data` config (`labels` + `datasets`) |
 | `widthMm` | no | number | Width in the PDF in mm (default: content area width) |
-| `heightMm` | no | number | Height in the PDF in mm (default: 80) |
+| `heightMm` | no | number or `"fill"` | Height in mm (default: 80). `"fill"` uses remaining page space. |
 | `canvasWidth` | no | number | Canvas render width in pixels (default: 1600) |
 | `canvasHeight` | no | number | Canvas render height in pixels (default: 800) |
 | `options` | no | object | Chart.js `options` object. `responsive: false` and `animation: false` are injected automatically. |
 | `xMm` | no | number | Left edge in mm (default: content left margin) |
+| `align` | no | string | `"left"` (default) or `"center"`. Can also be set globally via `layout.chartAlign` in the theme. |
 
 ### Resolution
 

package/README.md

@@ -263,6 +263,7 @@ labels: {
 | `divider` | Horizontal rule | `label`, `x1Mm`, `x2Mm` |
 | `image` | Embedded PNG/JPEG | `src`, `width` (percentage or mm), `caption` |
 | `spacer` | Vertical gap | `mm`, `px`, or `label` |
+| `pageBreak` | Force new page | (none) |
 | `hiddenText` | Invisible text | `label`, `text` |
 | `quote` | Blockquote with attribution | `label`, `text`, `attribution` |
 | `block` | Group children, optional background + border | `children`, `keepTogether` |
@@ -466,7 +467,7 @@ Claude Code skills for generating PDFs and themes are available in the `skills/`
 
 ## Constraints
 
-- A4 only
+- Page format defaults to A4; custom dimensions supported via `pageWidthMm`/`pageHeightMm` (e.g. 16:9 presentations)
 - Single-line `row` cells, no multi-line column pairs
 - `{{page}}` gives the current page number; `{{pages}}` (total page count) is not supported because keep-together rules make the final page count unpredictable until the last operation is laid out
 - Charts require the `canvas` npm package (native C++ addon) for server-side rendering; everything else is zero native dependencies

package/core/pdf-core.js

@@ -77,6 +77,8 @@ class PDFCore {
    * @param {number} [theme.page.margin]
    * @param {string} [theme.page.format]
    * @param {string} [theme.page.orientation]
+   * @param {number} [theme.page.pageWidthMm]
+   * @param {number} [theme.page.pageHeightMm]
    * @param {string} [theme.page.unit]
    * @param {boolean} [theme.page.compress]
    * @param {number[]} [theme.page.backgroundColor]
@@ -102,11 +104,13 @@ class PDFCore {
     this.margin = this.marginLeftMm;
     this.headerHeightMm = Number(this.page.headerHeightMm) || 0;
     this.footerHeightMm = Number(this.page.footerHeightMm) || 0;
-    this.format = String(this.page.format || "a4").toLowerCase();
+    const customW = Number(this.page.pageWidthMm) || 0;
+    const customH = Number(this.page.pageHeightMm) || 0;
+    const hasCustomDimensions = customW > 0 && customH > 0;
 
-    if (this.format !== "a4") {
-      throw new Error(`Unsupported page format "${this.page.format}". Only A4 is supported.`);
-    }
+    this.format = hasCustomDimensions
+      ? [customW, customH]
+      : String(this.page.format || "a4").toLowerCase();
 
     this.doc = new jsPDF({
       orientation: this.page.orientation || "portrait",

package/core/plugin-chart.js

@@ -132,14 +132,30 @@ module.exports = {
       );
     }
 
-    const widthMm  = operation.widthMm  || (bounds.right - bounds.left);
-    const heightMm = operation.heightMm || 80;
-    const x        = operation.xMm !== undefined ? operation.xMm : bounds.left;
+    const { theme } = ctx;
+    const contentWidth = bounds.right - bounds.left;
+    const widthMm  = operation.widthMm  || contentWidth;
+    const heightMm = operation.heightMm === "fill"
+      ? Math.max(0, core.contentBottomY - core.getCursorY())
+      : (operation.heightMm || 80);
+    const align = operation.align || (theme && theme.layout && theme.layout.chartAlign) || "left";
+
+    let x;
+    if (operation.xMm !== undefined) {
+      x = operation.xMm;
+    } else if (align === "center") {
+      x = bounds.left + (contentWidth - widthMm) / 2;
+    } else {
+      x = bounds.left;
+    }
 
     core.drawImage({ data: operation._buf, format: 'PNG', x, widthMm, heightMm });
   },
 
   estimateHeight(ctx) {
+    if (ctx.operation.heightMm === "fill") {
+      return ctx.core.contentBottomY - ctx.core.getCursorY();
+    }
     return (ctx.operation.heightMm || 80) + 4;
   },
 

package/core/render-document.js

@@ -221,17 +221,21 @@ function executeOperations(ctx) {
       }
     }
 
-    core.withDocumentState(() => {
-      executeOperation({
-        core,
-        theme,
-        operation,
-        index,
-        templateMode,
-        templateBypassMargins,
-        insideContainer,
+    if (operation.type === "pageBreak") {
+      core.addPage();
+    } else {
+      core.withDocumentState(() => {
+        executeOperation({
+          core,
+          theme,
+          operation,
+          index,
+          templateMode,
+          templateBypassMargins,
+          insideContainer,
+        });
       });
-    });
+    }
   }
 }
 
@@ -335,6 +339,7 @@ function isOperationType(type) {
     || type === "bullet"
     || type === "divider"
     || type === "spacer"
+    || type === "pageBreak"
     || type === "hiddenText"
     || type === "table"
     || type === "image"
@@ -1026,6 +1031,10 @@ function estimateOperationHeight(ctx) {
     throw new Error(`Spacer operation at index ${index} must provide mm, px, or label with spaceMm/spacePx`);
   }
 
+  if (operation.type === "pageBreak") {
+    return 0;
+  }
+
   if (operation.type === "hiddenText") {
     return 0;
   }

package/examples/sources/source-presentation.json

@@ -0,0 +1,634 @@
+{
+  "pageTemplates": {
+    "footer": [
+      {
+        "type": "divider",
+        "label": "slide.footer.rule",
+        "x1Mm": 24,
+        "x2Mm": 314
+      },
+      {
+        "type": "row",
+        "leftLabel": "slide.footer.left",
+        "rightLabel": "slide.footer.right",
+        "leftText": "h17.ai | sspdf",
+        "rightText": "{{page}}",
+        "xLeftMm": 24,
+        "xRightMm": 314
+      }
+    ],
+    "footerHeightMm": 8,
+    "footerStartMm": 178,
+    "footerBypassMargins": false
+  },
+  "sections": [
+    {
+      "type": "section",
+      "comment": "Title slide",
+      "content": [
+        {
+          "type": "image",
+          "src": "examples/sources/og-sspdf.png",
+          "width": "70%",
+          "label": "slide.image"
+        },
+        {
+          "type": "spacer",
+          "mm": 4
+        },
+        {
+          "type": "text",
+          "label": "slide.subtitle",
+          "text": "A math-first PDF engine. Send JSON, get a pixel-perfect document in under a second."
+        },
+        {
+          "type": "divider",
+          "label": "slide.divider.accent",
+          "widthMm": 60
+        },
+        {
+          "type": "text",
+          "label": "slide.author",
+          "text": "Hugo Palma  |  h17.ai  |  March 2026"
+        },
+        {
+          "type": "pageBreak"
+        }
+      ]
+    },
+    {
+      "type": "section",
+      "comment": "The problem",
+      "content": [
+        {
+          "type": "text",
+          "label": "slide.heading",
+          "text": "The problem"
+        },
+        {
+          "type": "divider",
+          "label": "slide.divider.accent",
+          "widthMm": 40
+        },
+        {
+          "type": "text",
+          "label": "slide.body",
+          "text": "Most PDF libraries force you to think in coordinates. You place text at (x, y), draw lines at absolute positions, and manually track where the cursor is. Change a font size and your entire layout breaks."
+        },
+        {
+          "type": "spacer",
+          "mm": 4
+        },
+        {
+          "type": "bullet",
+          "markerLabel": "slide.bullet.marker",
+          "label": "slide.bullet.text",
+          "text": "Layouts break when content length changes"
+        },
+        {
+          "type": "bullet",
+          "markerLabel": "slide.bullet.marker",
+          "label": "slide.bullet.text",
+          "text": "No automatic pagination or page-break logic"
+        },
+        {
+          "type": "bullet",
+          "markerLabel": "slide.bullet.marker",
+          "label": "slide.bullet.text",
+          "text": "Style changes require touching every draw call"
+        },
+        {
+          "type": "bullet",
+          "markerLabel": "slide.bullet.marker",
+          "label": "slide.bullet.text",
+          "text": "Themes, reuse, and consistency are an afterthought"
+        },
+        {
+          "type": "pageBreak"
+        }
+      ]
+    },
+    {
+      "type": "section",
+      "comment": "Architecture",
+      "content": [
+        {
+          "type": "text",
+          "label": "slide.heading",
+          "text": "How sspdf works"
+        },
+        {
+          "type": "divider",
+          "label": "slide.divider.accent",
+          "widthMm": 40
+        },
+        {
+          "type": "text",
+          "label": "slide.body",
+          "text": "Two inputs, one output. The theme defines every visual rule. The source defines content as a flat list of operations. The engine handles layout, pagination, and rendering."
+        },
+        {
+          "type": "spacer",
+          "mm": 4
+        },
+        {
+          "type": "table",
+          "label": "slide.table",
+          "headerLabel": "slide.table.header",
+          "columns": [
+            {
+              "header": "Layer",
+              "widthMm": 80
+            },
+            {
+              "header": "Responsibility",
+              "widthMm": 210
+            }
+          ],
+          "rows": [
+            [
+              "Theme (.js)",
+              "Page geometry, fonts, colors, margins, label styles"
+            ],
+            [
+              "Source (.json)",
+              "Content: text, bullets, tables, charts, images, spacers"
+            ],
+            [
+              "PDFCore",
+              "Cursor math, page breaks, style reset, drawing primitives"
+            ],
+            [
+              "render-document",
+              "Reads source ops, resolves labels from theme, calls PDFCore"
+            ],
+            [
+              "Plugins",
+              "Chart rendering (Chart.js), image embedding (PNG/JPEG)"
+            ]
+          ]
+        },
+        {
+          "type": "pageBreak"
+        }
+      ]
+    },
+    {
+      "type": "section",
+      "comment": "Operation types",
+      "content": [
+        {
+          "type": "text",
+          "label": "slide.heading",
+          "text": "Operation types"
+        },
+        {
+          "type": "divider",
+          "label": "slide.divider.accent",
+          "widthMm": 40
+        },
+        {
+          "type": "text",
+          "label": "slide.body",
+          "text": "Every document is built from these primitives. Each one is self-contained and flows automatically."
+        },
+        {
+          "type": "spacer",
+          "mm": 4
+        },
+        {
+          "type": "table",
+          "label": "slide.table",
+          "headerLabel": "slide.table.header",
+          "columns": [
+            {
+              "header": "Operation",
+              "widthMm": 65
+            },
+            {
+              "header": "What it does",
+              "widthMm": 225
+            }
+          ],
+          "rows": [
+            [
+              "text",
+              "Single or multi-line text block with word wrapping and alignment"
+            ],
+            [
+              "row",
+              "Left/right pair on the same line (dates, labels, key-value)"
+            ],
+            [
+              "bullet",
+              "Bulleted item with text or vector shape markers"
+            ],
+            [
+              "divider",
+              "Horizontal rule with configurable color, width, dash pattern"
+            ],
+            [
+              "table",
+              "Multi-column table with headers, alt-row shading, page-break header repeat"
+            ],
+            [
+              "chart",
+              "Bar, line, doughnut, pie via Chart.js (server-side canvas)"
+            ],
+            [
+              "image",
+              "Embedded PNG/JPEG with percentage or explicit sizing"
+            ],
+            [
+              "spacer",
+              "Vertical gap in millimeters"
+            ],
+            [
+              "section",
+              "Grouping wrapper, transparent to layout"
+            ],
+            [
+              "hiddenText",
+              "Invisible metadata for PDF search indexing"
+            ]
+          ]
+        },
+        {
+          "type": "pageBreak"
+        }
+      ]
+    },
+    {
+      "type": "section",
+      "comment": "Benchmark chart",
+      "content": [
+        {
+          "type": "text",
+          "label": "slide.heading",
+          "text": "Render performance"
+        },
+        {
+          "type": "divider",
+          "label": "slide.divider.accent",
+          "widthMm": 40
+        },
+        {
+          "type": "text",
+          "label": "slide.body",
+          "text": "All documents render in under a second. Complex multi-page layouts with tables and charts stay well below 500ms."
+        },
+        {
+          "type": "spacer",
+          "mm": 4
+        },
+        {
+          "type": "chart",
+          "chartType": "bar",
+          "widthMm": 260,
+          "heightMm": "fill",
+          "canvasWidth": 2600,
+          "canvasHeight": 800,
+
+          "data": {
+            "labels": [
+              "Invoice",
+              "Article",
+              "Financial Report",
+              "Board Brief",
+              "Event Program",
+              "Certificate"
+            ],
+            "datasets": [
+              {
+                "label": "Render time (ms)",
+                "data": [
+                  42,
+                  68,
+                  187,
+                  95,
+                  112,
+                  31
+                ],
+                "backgroundColor": "rgba(0, 229, 255, 0.7)",
+                "borderColor": "rgba(0, 229, 255, 1)",
+                "borderWidth": 1
+              }
+            ]
+          },
+          "options": {
+            "indexAxis": "y",
+            "scales": {
+              "x": {
+                "beginAtZero": true,
+                "ticks": {
+                  "color": "rgba(122, 122, 136, 1)",
+                  "font": {
+                    "size": 18
+                  }
+                },
+                "grid": {
+                  "color": "rgba(30, 30, 40, 1)"
+                },
+                "title": {
+                  "display": true,
+                  "text": "Milliseconds",
+                  "color": "rgba(122, 122, 136, 1)",
+                  "font": {
+                    "size": 18
+                  }
+                }
+              },
+              "y": {
+                "ticks": {
+                  "color": "rgba(200, 200, 210, 1)",
+                  "font": {
+                    "size": 18
+                  }
+                },
+                "grid": {
+                  "display": false
+                }
+              }
+            },
+            "plugins": {
+              "legend": {
+                "display": false
+              }
+            },
+            "layout": {
+              "padding": {
+                "bottom": 5
+              }
+            }
+          }
+        },
+        {
+          "type": "pageBreak"
+        }
+      ]
+    },
+    {
+      "type": "section",
+      "comment": "Theme system",
+      "content": [
+        {
+          "type": "text",
+          "label": "slide.heading",
+          "text": "Theme system"
+        },
+        {
+          "type": "divider",
+          "label": "slide.divider.accent",
+          "widthMm": 40
+        },
+        {
+          "type": "text",
+          "label": "slide.body",
+          "text": "Themes are plain JS objects. Every visual decision lives in labels. Swap the theme file and the same source JSON renders in a completely different style."
+        },
+        {
+          "type": "spacer",
+          "mm": 4
+        },
+        {
+          "type": "row",
+          "leftLabel": "slide.row.left",
+          "rightLabel": "slide.row.right",
+          "leftText": "Built-in fonts",
+          "rightText": "20 Google Fonts shipped as base64 TTF (Inter, Roboto, Lora, Fira Code...)",
+          "xLeftMm": 24,
+          "xRightMm": 314
+        },
+        {
+          "type": "row",
+          "leftLabel": "slide.row.left",
+          "rightLabel": "slide.row.right",
+          "leftText": "Vector bullets",
+          "rightText": "20 shape markers (arrows, checkmarks, diamonds) -- no Unicode issues",
+          "xLeftMm": 24,
+          "xRightMm": 314
+        },
+        {
+          "type": "row",
+          "leftLabel": "slide.row.left",
+          "rightLabel": "slide.row.right",
+          "leftText": "Label properties",
+          "rightText": "Font, color, margin, padding, background, border, border-radius, left accent",
+          "xLeftMm": 24,
+          "xRightMm": 314
+        },
+        {
+          "type": "row",
+          "leftLabel": "slide.row.left",
+          "rightLabel": "slide.row.right",
+          "leftText": "Page templates",
+          "rightText": "Repeating headers and footers with page number tokens",
+          "xLeftMm": 24,
+          "xRightMm": 314
+        },
+        {
+          "type": "spacer",
+          "mm": 6
+        },
+        {
+          "type": "text",
+          "label": "slide.callout",
+          "text": "This presentation is itself rendered by sspdf using a 338x190mm (16:9) custom page format with the h17.ai color palette."
+        },
+        {
+          "type": "pageBreak"
+        }
+      ]
+    },
+    {
+      "type": "section",
+      "comment": "Adoption chart",
+      "content": [
+        {
+          "type": "text",
+          "label": "slide.heading",
+          "text": "Test coverage and growth"
+        },
+        {
+          "type": "divider",
+          "label": "slide.divider.accent",
+          "widthMm": 40
+        },
+        {
+          "type": "spacer",
+          "mm": 2
+        },
+        {
+          "type": "chart",
+          "chartType": "line",
+          "widthMm": 260,
+          "heightMm": "fill",
+          "canvasWidth": 2600,
+          "canvasHeight": 800,
+
+          "data": {
+            "labels": [
+              "v0.1.0",
+              "v0.1.2",
+              "v0.1.4",
+              "v0.1.6",
+              "v0.1.8",
+              "v0.2.0",
+              "v0.3.0",
+              "v0.4.0"
+            ],
+            "datasets": [
+              {
+                "label": "Test count",
+                "data": [
+                  8,
+                  14,
+                  22,
+                  30,
+                  38,
+                  40,
+                  42,
+                  48
+                ],
+                "borderColor": "rgba(0, 229, 255, 1)",
+                "backgroundColor": "rgba(0, 229, 255, 0.1)",
+                "fill": true,
+                "tension": 0.3,
+                "pointRadius": 6,
+                "pointBackgroundColor": "rgba(0, 229, 255, 1)",
+                "borderWidth": 3
+              },
+              {
+                "label": "Operation types",
+                "data": [
+                  3,
+                  4,
+                  5,
+                  7,
+                  8,
+                  9,
+                  9,
+                  10
+                ],
+                "borderColor": "rgba(0, 165, 184, 1)",
+                "backgroundColor": "rgba(0, 165, 184, 0.05)",
+                "fill": true,
+                "tension": 0.3,
+                "pointRadius": 6,
+                "pointBackgroundColor": "rgba(0, 165, 184, 1)",
+                "borderWidth": 3
+              }
+            ]
+          },
+          "options": {
+            "scales": {
+              "x": {
+                "ticks": {
+                  "color": "rgba(122, 122, 136, 1)",
+                  "font": {
+                    "size": 18
+                  }
+                },
+                "grid": {
+                  "color": "rgba(30, 30, 40, 1)"
+                }
+              },
+              "y": {
+                "beginAtZero": true,
+                "ticks": {
+                  "color": "rgba(122, 122, 136, 1)",
+                  "font": {
+                    "size": 18
+                  }
+                },
+                "grid": {
+                  "color": "rgba(30, 30, 40, 1)"
+                }
+              }
+            },
+            "plugins": {
+              "legend": {
+                "position": "bottom",
+                "labels": {
+                  "color": "rgba(200, 200, 210, 1)",
+                  "font": {
+                    "size": 18
+                  },
+                  "padding": 20
+                }
+              }
+            },
+            "layout": {
+              "padding": {
+                "bottom": 5
+              }
+            }
+          }
+        },
+        {
+          "type": "pageBreak"
+        }
+      ]
+    },
+    {
+      "type": "section",
+      "comment": "Closing slide",
+      "content": [
+        {
+          "type": "spacer",
+          "mm": 24
+        },
+        {
+          "type": "text",
+          "label": "slide.kicker",
+          "text": "Get Started"
+        },
+        {
+          "type": "text",
+          "label": "slide.title",
+          "text": "npm install h17-sspdf"
+        },
+        {
+          "type": "spacer",
+          "mm": 8
+        },
+        {
+          "type": "divider",
+          "label": "slide.divider.accent",
+          "widthMm": 60
+        },
+        {
+          "type": "spacer",
+          "mm": 4
+        },
+        {
+          "type": "text",
+          "label": "slide.body",
+          "text": "Zero native dependencies. Works in Node.js. CLI and programmatic API included."
+        },
+        {
+          "type": "spacer",
+          "mm": 6
+        },
+        {
+          "type": "row",
+          "leftLabel": "slide.row.left",
+          "rightLabel": "slide.row.right",
+          "leftText": "GitHub",
+          "rightText": "github.com/hugopalma17/sspdf",
+          "xLeftMm": 24,
+          "xRightMm": 314
+        },
+        {
+          "type": "row",
+          "leftLabel": "slide.row.left",
+          "rightLabel": "slide.row.right",
+          "leftText": "Docs",
+          "rightText": "h17.ai/docs/sspdf",
+          "xLeftMm": 24,
+          "xRightMm": 314
+        }
+      ]
+    }
+  ]
+}

package/examples/themes/theme-presentation.js

@@ -0,0 +1,276 @@
+const INTER = require("../../fonts/inter.js");
+
+module.exports = {
+  name: "Presentation Theme",
+
+  customFonts: [
+    {
+      family: "Inter",
+      faces: [
+        { style: "normal", fileName: "Inter-Regular.ttf", data: INTER.Regular },
+        { style: "bold", fileName: "Inter-Bold.ttf", data: INTER.Bold },
+      ],
+    },
+  ],
+
+  page: {
+    pageWidthMm: 338,
+    pageHeightMm: 190,
+    orientation: "landscape",
+    unit: "mm",
+    compress: true,
+    marginTopMm: 16,
+    marginBottomMm: 14,
+    marginLeftMm: 24,
+    marginRightMm: 24,
+    backgroundColor: [6, 6, 8],
+    defaultText: {
+      fontFamily: "helvetica",
+      fontStyle: "normal",
+      fontSize: 14,
+      color: [232, 232, 236],
+      lineHeight: 1.4,
+    },
+    defaultStroke: {
+      color: [232, 232, 236],
+      lineWidth: 0.2,
+      lineCap: "butt",
+      lineJoin: "miter",
+    },
+    defaultFillColor: [6, 6, 8],
+  },
+
+  layout: {
+    chartAlign: "center",
+  },
+
+  labels: {
+    // ─── Slide footer ─────────────────────────────────────────
+    "slide.footer.rule": {
+      color: [74, 74, 85],
+      lineWidth: 0.25,
+      marginBottomPx: 2,
+    },
+    "slide.footer.left": {
+      fontFamily: "Inter",
+      fontStyle: "normal",
+      fontSize: 8,
+      color: [122, 122, 136],
+      marginBottomPx: 0,
+    },
+    "slide.footer.right": {
+      fontFamily: "Inter",
+      fontStyle: "normal",
+      fontSize: 8,
+      color: [122, 122, 136],
+      marginBottomPx: 0,
+    },
+
+    // ─── Title slide ──────────────────────────────────────────
+    "slide.kicker": {
+      fontFamily: "Inter",
+      fontStyle: "bold",
+      fontSize: 11,
+      textTransform: "upper",
+      align: "center",
+      color: [0, 229, 255],
+      marginBottomPx: 6,
+    },
+    "slide.title": {
+      fontFamily: "Inter",
+      fontStyle: "bold",
+      fontSize: 36,
+      align: "center",
+      color: [232, 232, 236],
+      lineHeight: 1.15,
+      marginBottomPx: 8,
+    },
+    "slide.subtitle": {
+      fontFamily: "Inter",
+      fontStyle: "normal",
+      fontSize: 16,
+      align: "center",
+      color: [122, 122, 136],
+      lineHeight: 1.4,
+      marginBottomPx: 6,
+    },
+    "slide.author": {
+      fontFamily: "Inter",
+      fontStyle: "normal",
+      fontSize: 12,
+      align: "center",
+      color: [74, 74, 85],
+      marginBottomPx: 0,
+    },
+
+    // ─── Content slides ───────────────────────────────────────
+    "slide.heading": {
+      fontFamily: "Inter",
+      fontStyle: "bold",
+      fontSize: 24,
+      align: "center",
+      color: [232, 232, 236],
+      lineHeight: 1.2,
+      marginBottomPx: 10,
+    },
+    "slide.body": {
+      fontFamily: "Inter",
+      fontStyle: "normal",
+      fontSize: 14,
+      align: "center",
+      color: [122, 122, 136],
+      lineHeight: 1.5,
+      marginBottomPx: 6,
+    },
+    "slide.body.bold": {
+      fontFamily: "Inter",
+      fontStyle: "bold",
+      fontSize: 14,
+      align: "center",
+      color: [232, 232, 236],
+      lineHeight: 1.5,
+      marginBottomPx: 6,
+    },
+    "slide.caption": {
+      fontFamily: "Inter",
+      fontStyle: "normal",
+      fontSize: 10,
+      color: [74, 74, 85],
+      lineHeight: 1.3,
+      marginBottomPx: 4,
+    },
+
+    // ─── Bullets ──────────────────────────────────────────────
+    "slide.bullet.marker": {
+      shape: "circle-filled",
+      shapeColor: [0, 229, 255],
+      shapeSize: 0.5,
+      textIndentMm: 3,
+    },
+    "slide.bullet.text": {
+      fontFamily: "Inter",
+      fontStyle: "normal",
+      fontSize: 14,
+      color: [122, 122, 136],
+      lineHeight: 1.5,
+      marginBottomPx: 5,
+    },
+
+    // ─── Metrics / KPI ────────────────────────────────────────
+    "slide.metric.value": {
+      fontFamily: "Inter",
+      fontStyle: "bold",
+      fontSize: 28,
+      color: [0, 229, 255],
+      align: "center",
+      marginBottomPx: 2,
+    },
+    "slide.metric.label": {
+      fontFamily: "Inter",
+      fontStyle: "normal",
+      fontSize: 11,
+      color: [122, 122, 136],
+      align: "center",
+      marginBottomPx: 4,
+    },
+
+    // ─── Dividers ─────────────────────────────────────────────
+    "slide.divider": {
+      color: [18, 18, 24],
+      lineWidth: 0.4,
+      marginTopPx: 6,
+      marginBottomPx: 6,
+    },
+    "slide.divider.accent": {
+      color: [0, 229, 255],
+      lineWidth: 1.2,
+      marginTopPx: 4,
+      marginBottomPx: 8,
+    },
+
+    // ─── Callout box ──────────────────────────────────────────
+    "slide.callout": {
+      fontFamily: "Inter",
+      fontStyle: "normal",
+      fontSize: 13,
+      align: "center",
+      color: [0, 229, 255],
+      lineHeight: 1.45,
+      backgroundColor: [12, 12, 16],
+      borderColor: [0, 165, 184],
+      borderWidthMm: 0.35,
+      borderRadiusMm: 2,
+      paddingTopMm: 4,
+      paddingBottomMm: 4,
+      paddingLeftMm: 5,
+      paddingRightMm: 5,
+      marginTopPx: 4,
+      marginBottomPx: 6,
+    },
+
+    // ─── Image ────────────────────────────────────────────────
+    "slide.image": {
+      paddingTopMm: 2,
+      paddingBottomMm: 2,
+    },
+    "slide.image.caption": {
+      fontFamily: "Inter",
+      fontStyle: "normal",
+      fontSize: 9,
+      color: [74, 74, 85],
+      align: "center",
+      lineHeight: 1.3,
+    },
+
+    // ─── Table ────────────────────────────────────────────────
+    "slide.table": {
+      fontFamily: "Inter",
+      fontStyle: "normal",
+      fontSize: 11,
+      color: [200, 200, 210],
+      lineHeight: 1.3,
+      cellPaddingMm: 2.5,
+      borderColor: [30, 30, 40],
+      borderTopMm: 0,
+      borderBottomMm: 0.15,
+      borderLeftMm: 0,
+      borderRightMm: 0,
+      altRowColor: [12, 12, 16],
+    },
+    "slide.table.header": {
+      fontFamily: "Inter",
+      fontStyle: "bold",
+      fontSize: 11,
+      color: [6, 6, 8],
+      lineHeight: 1.3,
+      cellPaddingMm: 2.5,
+      backgroundColor: [0, 229, 255],
+      borderColor: [0, 200, 220],
+      borderTopMm: 0,
+      borderBottomMm: 0.3,
+      borderLeftMm: 0,
+      borderRightMm: 0,
+    },
+
+    // ─── Row labels ───────────────────────────────────────────
+    "slide.row.left": {
+      fontFamily: "Inter",
+      fontStyle: "bold",
+      fontSize: 12,
+      color: [232, 232, 236],
+      marginBottomPx: 2,
+    },
+    "slide.row.right": {
+      fontFamily: "Inter",
+      fontStyle: "normal",
+      fontSize: 12,
+      color: [122, 122, 136],
+      marginBottomPx: 2,
+    },
+
+    // ─── Spacers ──────────────────────────────────────────────
+    "slide.spacer.sm": { spaceMm: 4 },
+    "slide.spacer.md": { spaceMm: 8 },
+    "slide.spacer.lg": { spaceMm: 16 },
+  },
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "h17-sspdf",
-  "version": "0.4.1",
+  "version": "0.5.0",
   "description": "Declarative PDF engine - define layout once, feed it JSON, get consistent PDFs",
   "main": "index.js",
   "author": "Hugo Palma",