@twinfinity/printing 6.1.1-beta → 6.1.2-ci.30738-beta

package/templates/template-schema.json

@@ -3,7 +3,7 @@
   "$id": "twinfinity-print-template-v2",
   "title": "Twinfinity Print Template",
   "description": "Layout template for Twinfinity BIM section printing. Defines page size, viewports, legends, labels, and decorative elements for PDF/SVG output.",
-  "markdownDescription": "# Twinfinity Print Template\n\nLayout template for automated BIM drawing generation.\n\n## Template Structure\n\n- **`page`** — Page dimensions (A4, A3, custom)\n- **`styles`** — Named text styles (body, title, etc.)\n- **`assets`** — Reusable images/logos\n- **`presets`** — Reusable class filters and scale lists\n- **`elements`** — All content on the page\n\n## Available Elements\n\n| Element | Purpose |\n|---------|--------|\n| `viewport` | BIM section geometry at a position/scale |\n| `text` | Static or templated text |\n| `labels` | Per-item labels (room names, etc.) |\n| `legend` | Table with item properties and colors |\n| `scaleBar` | Graphical scale indicator |\n| `qr` | QR codes for navigation/anchoring |\n| `image` | Logo or decorative image |\n| `line`, `rect`, `circle` | Basic shapes |\n| `polyline`, `polygon` | Custom vector shapes |\n| `group` | Container with transforms/clipping |\n\n## Viewport Modes\n\n- **SLAB** — Optimized for horizontal floor plans (uses depth above/below)\n- **PLANE** — Arbitrary plane cuts (vertical sections, diagonals)\n\nAuto-detected from `planeNormal` orientation if not explicitly set.\n\n## Filtering & Highlighting\n\n- **`includeClasses`** — Which IFC classes to render\n- **`clip`** — Crop viewport to specific areas\n- **`highlight`** — Custom stroke/fill for matching items\n- **`fills`** — Filled polygons for spaces or other classes\n\n## Template Variables\n\nUse `{{variable}}` syntax in text elements:\n- `{{viewport.<id>.scaleText}}` — e.g. \"1:100\"\n- `{{buildStamp}}` — Build timestamp\n- `{{BIP.spacename}}` — Property values in labels",
+  "markdownDescription": "# Twinfinity Print Template\n\nLayout template for automated BIM drawing generation.\n\n## Template Structure\n\n- **`page`** — Page dimensions (A4, A3, custom)\n- **`styles`** — Named text styles (body, title, etc.)\n- **`resources`** — Reusable images/logos\n- **`presets`** — Reusable class filters and scale lists\n- **`elements`** — All content on the page\n\n## Available Elements\n\n| Element | Purpose |\n|---------|--------|\n| `viewport` | BIM section geometry at a position/scale |\n| `text` | Static or templated text |\n| `labels` | Per-item labels (room names, etc.) |\n| `legend` | Table with item properties and colors |\n| `scaleBar` | Graphical scale indicator |\n| `qr` | QR codes for navigation/anchoring |\n| `image` | Logo or decorative image |\n| `line`, `rect`, `circle` | Basic shapes |\n| `polyline`, `polygon` | Custom vector shapes |\n| `group` | Container with transforms/clipping |\n\n## Sections\n\nEach viewport declares its own cut: `cutHeight` (+ `depth`) for horizontal plans, `planeNormal` + `planePosition` for elevations/sections. All model-space values are metres. Up to 8 viewports per template.\n\n## Filtering & Highlighting\n\n- **`includeClasses`** — Which IFC classes to render\n- **`clip`** — Crop viewport to specific areas\n- **`highlight`** — Custom stroke/fill for matching items\n- **`fills`** — Filled polygons for spaces or other classes\n\n## Template Variables\n\nUse `{{variable}}` syntax in text elements:\n- `{{viewport.<id>.scaleText}}` — e.g. \"1:100\"\n- `{{vars.<name>}}` — declared template variables\n- `{{BIP.spacename}}` — Property values in labels\n\nNumeric placeholders accept format filters: `{{BIP.area | round:1}}`, `{{BIP.area | fixed:2}}`.",
   "type": "object",
   "required": ["page", "elements"],
   "additionalProperties": false,
@@ -106,11 +106,11 @@
       "description": "Named text styles (body, title, etc.).",
       "markdownDescription": "Named text styles referenced by elements.\n\n**Define reusable styles:**\n```json\n\"styles\": {\n  \"body\": { \"fontFamily\": \"Arial\", \"fontSizeMm\": 3.5, \"color\": \"#000000\" },\n  \"title\": { \"fontFamily\": \"Arial\", \"fontSizeMm\": 8, \"fontWeight\": \"bold\" },\n  \"small\": { \"fontFamily\": \"Arial\", \"fontSizeMm\": 2.5, \"color\": \"#666666\" }\n}\n```\n\n**Reference in elements:**\n```json\n{ \"kind\": \"text\", \"textStyle\": \"body\", \"text\": \"Hello\" }\n```"
     },
-    "assets": {
+    "resources": {
       "type": "array",
-      "description": "Reusable assets (images, SVG logos) referenced by elements via assetId.",
-      "markdownDescription": "Reusable assets (images, SVG logos, icons).\n\n**Define assets:**\n```json\n\"assets\": [\n  {\n    \"id\": \"logo-main\",\n    \"src\": \"https://example.com/logo.svg\"\n  },\n  {\n    \"id\": \"north-arrow\",\n    \"src\": \"data:image/svg+xml;base64,...\"\n  }\n]\n```\n\n**Reference in elements:**\n```json\n{ \"kind\": \"image\", \"assetId\": \"logo-main\", \"...\" }\n{ \"northArrow\": { \"assetId\": \"north-arrow\" } }\n```\n\n**⚠️ Remote URLs require:** `\"allowRemoteAssets\": true`",
-      "items": { "$ref": "#/$defs/asset" }
+      "description": "Reusable resources (images, SVG logos) referenced by elements via resourceId.",
+      "markdownDescription": "Reusable resources (images, SVG logos, icons).\n\n**Define resources:**\n```json\n\"resources\": [\n  {\n    \"id\": \"logo-main\",\n    \"src\": \"https://example.com/logo.svg\"\n  },\n  {\n    \"id\": \"north-arrow\",\n    \"src\": \"data:image/svg+xml;base64,...\"\n  }\n]\n```\n\n**Reference in elements:**\n```json\n{ \"kind\": \"image\", \"resourceId\": \"logo-main\", \"...\" }\n{ \"northArrow\": { \"resourceId\": \"north-arrow\" } }\n```\n\n**⚠️ Remote URLs require:** `\"allowRemoteResources\": true`",
+      "items": { "$ref": "#/$defs/resource" }
     },
     "elements": {
       "type": "array",
@@ -123,11 +123,59 @@
       "description": "Reusable presets for class filters and scales.",
       "markdownDescription": "Reusable presets for class filters and scales.\n\n**Define presets:**\n```json\n\"presets\": {\n  \"includeClasses\": {\n    \"defaultBuilding\": [\"space\", \"walls\", \"windows\", \"doors\", \"columns\", \"stairs\", \"floor\"],\n    \"structureOnly\": [\"walls\", \"columns\", \"beam\", \"floor\"]\n  },\n  \"scales\": {\n    \"default\": { \"preferredScales\": [50, 100, 200, 500, 1000] },\n    \"detail\": { \"preferredScales\": [2, 5, 10, 20, 50] }\n  }\n}\n```\n\n**Reference in viewports:**\n```json\n\"includeClasses\": { \"preset\": \"defaultBuilding\" },\n\"scalePreset\": \"default\"\n```"
     },
-    "allowRemoteAssets": {
+    "variables": {
+      "type": "object",
+      "description": "Declared template variables (parameters). Names must be simple identifiers ([A-Za-z_][A-Za-z0-9_]*) — they are referenced as {{vars.<name>}}. Values are supplied at render time via options.variables, with the declared defaults as fail-safe fallback.",
+      "markdownDescription": "Declared template variables (parameters).\n\n**Names must be simple identifiers** (`[A-Za-z_][A-Za-z0-9_]*`) — they are referenced as `{{vars.<name>}}`, so dashes/dots would collide with the placeholder syntax.\n\n**Values at render time:** `renderDrawing({ ..., options: { variables: { name: value } } })` — missing values fall back to each variable's `default`.\n\n**Example:**\n```json\n\"variables\": {\n  \"title\": { \"type\": \"string\", \"default\": \"Floor plan\", \"label\": \"Title\" },\n  \"showLegend\": { \"type\": \"boolean\", \"default\": true, \"label\": \"Show legend\" }\n}\n```",
+      "propertyNames": { "pattern": "^[A-Za-z_][A-Za-z0-9_]*$" },
+      "additionalProperties": {
+        "type": "object",
+        "required": ["type", "default"],
+        "additionalProperties": false,
+        "properties": {
+          "type": {
+            "enum": ["string", "number", "boolean", "array"],
+            "description": "Variable type. Determines validation and UI control type."
+          },
+          "default": {
+            "description": "Default value. REQUIRED — ensures the template always works without user input. Must match the declared type."
+          },
+          "label": {
+            "type": "string",
+            "description": "Human-readable label for UI generation. Defaults to the variable name."
+          },
+          "description": {
+            "type": "string",
+            "description": "Description/help text for UI generation."
+          },
+          "format": {
+            "enum": ["color", "email", "url", "date"],
+            "description": "Semantic format hint for UI generation (string variables): color picker, email/url/date inputs."
+          },
+          "min": { "type": "number", "description": "Minimum value (number variables)." },
+          "max": { "type": "number", "description": "Maximum value (number variables)." },
+          "step": { "type": "number", "description": "Step size for UI controls (number variables)." },
+          "minLength": { "type": "number", "description": "Minimum length (string variables)." },
+          "maxLength": { "type": "number", "description": "Maximum length (string variables)." },
+          "pattern": { "type": "string", "description": "Regex the value must match (string variables)." },
+          "enum": { "type": "array", "description": "Allowed values; renders as a dropdown." },
+          "items": {
+            "type": "object",
+            "description": "Item constraints for array variables.",
+            "additionalProperties": false,
+            "properties": {
+              "type": { "enum": ["string", "number"] },
+              "enum": { "type": "array" }
+            }
+          }
+        }
+      }
+    },
+    "allowRemoteResources": {
       "type": "boolean",
       "default": false,
-      "description": "Allow fetching remote assets from https:// URLs. Required for remote images/logos.",
-      "markdownDescription": "Allow fetching remote assets from `https://` URLs.\n\n**Default:** `false` (only local/data URIs allowed)\n\n**Set to `true` when:**\n- Assets use `https://` URLs\n- Loading logos from a CDN\n- Fetching remote images\n\n**Example:**\n```json\n\"allowRemoteAssets\": true,\n\"assets\": [\n  { \"id\": \"logo\", \"src\": \"https://example.com/logo.svg\" }\n]\n```\n\n**⚠️ Security note:** Only enable for trusted URLs."
+      "description": "Allow fetching remote resources from https:// URLs. Required for remote images/logos.",
+      "markdownDescription": "Allow fetching remote resources from `https://` URLs.\n\n**Default:** `false` (only local/data URIs allowed)\n\n**Set to `true` when:**\n- Resources use `https://` URLs\n- Loading logos from a CDN\n- Fetching remote images\n\n**Example:**\n```json\n\"allowRemoteResources\": true,\n\"resources\": [\n  { \"id\": \"logo\", \"src\": \"https://example.com/logo.svg\" }\n]\n```\n\n**⚠️ Security note:** Only enable for trusted URLs."
     }
   },
 
@@ -265,7 +313,7 @@
           "description": "Page height in millimeters.",
           "markdownDescription": "Page height in millimeters.\n\nCommon values: `297` (A4 portrait / A3 landscape), `210` (A4 landscape), `420` (A3 portrait / A2 landscape), `594` (A1 landscape)"
         },
-        "marginMm": { "type": "number", "default": 10, "description": "Page margin in mm." },
+        "marginMm": { "type": "number", "default": 0, "description": "Page margin in mm. Used by legend auto-placement (anchor offsets); other elements position themselves with absolute coordinates." },
         "backgroundColor": { "$ref": "#/$defs/cssColor", "default": "#ffffff", "description": "Page background color." }
       }
     },
@@ -296,17 +344,18 @@
       }
     },
 
-    "asset": {
+    "resource": {
       "type": "object",
-      "description": "A reusable asset (image, SVG) that can be referenced by image elements.",
+      "description": "A reusable resource (image, SVG) that can be referenced by image elements. Needs src or content.",
       "required": ["id"],
+      "anyOf": [{ "required": ["src"] }, { "required": ["content"] }],
       "additionalProperties": false,
       "properties": {
-        "id": { "type": "string", "description": "Unique asset ID, referenced by image elements via assetId." },
+        "id": { "type": "string", "description": "Unique resource ID, referenced by image elements via resourceId." },
         "src": {
           "type": "string",
-          "description": "URL or data URI for the asset. Remote URLs require allowRemoteAssets: true.",
-          "markdownDescription": "URL or data URI for the asset.\n\n- **Data URI**: `data:image/svg+xml;base64,PHN2Zy...` (self-contained, no network)\n- **Remote URL**: `https://example.com/logo.svg` (requires `allowRemoteAssets: true`)",
+          "description": "URL or data URI for the resource. Remote URLs require allowRemoteResources: true.",
+          "markdownDescription": "URL or data URI for the resource.\n\n- **Data URI**: `data:image/svg+xml;base64,PHN2Zy...` (self-contained, no network)\n- **Remote URL**: `https://example.com/logo.svg` (requires `allowRemoteResources: true`)",
           "examples": [
             "data:image/svg+xml;base64,PHN2Zy...",
             "https://example.com/logo.svg"
@@ -379,7 +428,7 @@
     "clipConfig": {
       "type": "object",
       "description": "Clip the viewport to show only the area around matching BIM items (e.g. a specific tenant's spaces).",
-      "markdownDescription": "Clip the viewport to show only the area around matching BIM items.\n\nUse `class` + `where` to select which items define the clip boundary. The viewport is cropped to the bounding box of those items, optionally expanded by `expandByM`.\n\n**Example — clip to a tenant's spaces:**\n```json\n\"clip\": {\n  \"class\": \"space\",\n  \"where\": { \"BIP.hyresobjektsnummer\": \"2022-F2008\" },\n  \"expandByM\": 1.5\n}\n```",
+      "markdownDescription": "Clip the viewport to show only the area around matching BIM items.\n\nUse `class` + `where` to select which items define the clip boundary. The viewport is cropped to the bounding box of those items, optionally expanded by `expandBy`.\n\n**Example — clip to a tenant's spaces:**\n```json\n\"clip\": {\n  \"class\": \"space\",\n  \"where\": { \"BIP.hyresobjektsnummer\": \"2022-F2008\" },\n  \"expandBy\": 1.5\n}\n```",
       "required": ["where"],
       "additionalProperties": false,
       "properties": {
@@ -391,34 +440,39 @@
           "description": "IFC class filter (e.g. \"space\"). Only items of this class are used for the clip boundary."
         },
         "where": { "$ref": "#/$defs/whereCondition" },
-        "expandByM": {
+        "expandBy": {
           "type": "number",
           "default": 0,
           "description": "Expand the clip boundary outward by this many meters. Use 0.5–1.5 to show surrounding context.",
-          "markdownDescription": "Expand the clip boundary outward by this many meters.\n\n**Purpose:** Show surrounding context (adjacent walls, neighboring rooms) while keeping the clip focused on the target area.\n\n**How it works:**\n1. The original clip polygon is calculated from matching items\n2. The polygon is expanded outward by `expandByM` meters (morphological dilation)\n3. Geometry **paths** are clipped to the **expanded** boundary (shows more context)\n4. Fill filtering uses the **original** (unexpanded) boundary (controlled by `matchClipFilter`)\n\n**Common values:**\n- `0.5` — Small context (0.5m around clip area)\n- `1.5` — Medium context (1.5m around clip area) **← Recommended**\n- `3.0` — Large context (3m around clip area)\n- `0` — No expansion (strict clip to exact boundary)\n\n**Example:**\nClipping to a tenant's spaces with 1.5m surrounding context:\n```json\n\"clip\": {\n  \"class\": \"space\",\n  \"where\": { \"BIP.hyresobjektsnummer\": \"2022-F2008\" },\n  \"expandByM\": 1.5\n}\n```\n\n**⚠️ Note:** When using `expandByM` with fills, set `matchClipFilter: true` on fill rules to prevent adjacent spaces from being filled."
+          "markdownDescription": "Expand the clip boundary outward by this many meters.\n\n**Purpose:** Show surrounding context (adjacent walls, neighboring rooms) while keeping the clip focused on the target area.\n\n**How it works:**\n1. The original clip polygon is calculated from matching items\n2. The polygon is expanded outward by `expandBy` meters (morphological dilation)\n3. Geometry **paths** are clipped to the **expanded** boundary (shows more context)\n4. Fill filtering uses the **original** (unexpanded) boundary (controlled by `matchClipFilter`)\n\n**Common values:**\n- `0.5` — Small context (0.5m around clip area)\n- `1.5` — Medium context (1.5m around clip area) **← Recommended**\n- `3.0` — Large context (3m around clip area)\n- `0` — No expansion (strict clip to exact boundary)\n\n**Example:**\nClipping to a tenant's spaces with 1.5m surrounding context:\n```json\n\"clip\": {\n  \"class\": \"space\",\n  \"where\": { \"BIP.hyresobjektsnummer\": \"2022-F2008\" },\n  \"expandBy\": 1.5\n}\n```\n\n**⚠️ Note:** When using `expandBy` with fills, set `matchClipFilter: true` on fill rules to prevent adjacent spaces from being filled."
         },
         "clipLabels": {
           "type": "boolean",
           "default": false,
           "description": "Also clip labels to the clip boundary (hide labels outside the clip)."
         },
-        "stroke": {
+        "color": {
           "$ref": "#/$defs/cssColor",
           "default": "#000000",
-          "description": "Border color around the clipped area. Set to \"none\" to hide the clip border."
+          "description": "Border color around the clipped area (same vocabulary as lineStyles). Set to \"none\" to hide the clip border."
         },
-        "strokeWidthMm": {
+        "widthMm": {
           "type": "number",
           "default": 0.5,
           "description": "Border width in mm around the clipped area."
         },
-        "strokeOpacity": {
+        "opacity": {
           "type": "number",
           "default": 1,
           "minimum": 0,
           "maximum": 1,
           "description": "Border opacity (0 = invisible, 1 = fully opaque)."
         },
+        "dash": {
+          "type": "string",
+          "description": "SVG stroke-dasharray for the clip border (e.g. \"4 2\"). Omit for a solid border.",
+          "examples": ["4 2", "2 1", "6 2 1 2"]
+        },
         "fill": {
           "$ref": "#/$defs/cssColor",
           "default": "none",
@@ -437,7 +491,7 @@
     "highlightConfig": {
       "type": "object",
       "description": "Highlight matching BIM items with custom stroke/fill colors (e.g. highlight a tenant's spaces in yellow).",
-      "markdownDescription": "Highlight matching BIM items with custom stroke/fill colors.\n\nUse `class` + `where` to select which items get highlighted. Matching items are drawn with the specified stroke and fill colors.\n\n**Example — highlight tenant spaces in yellow:**\n```json\n\"highlight\": {\n  \"class\": \"space\",\n  \"where\": { \"BIP.hyresobjektsnummer\": \"2022-F2008\" },\n  \"stroke\": \"#f00\",\n  \"fill\": \"#ff0\",\n  \"fillOpacity\": 1\n}\n```\n\n**Example — highlight spaces that appear in both plan and section:**\n```json\n\"highlight\": {\n  \"class\": \"space\",\n  \"where\": { \"BIP.hyresobjektsnummer\": \"2022-F2008\" },\n  \"intersectsViewport\": \"main\",\n  \"stroke\": \"#f00\",\n  \"fill\": \"#ff0\",\n  \"fillOpacity\": 1\n}\n```",
+      "markdownDescription": "Highlight matching BIM items with custom stroke/fill colors.\n\nUse `class` + `where` to select which items get highlighted. Matching items are drawn with the specified stroke and fill colors.\n\n**Example — highlight tenant spaces in yellow:**\n```json\n\"highlight\": {\n  \"class\": \"space\",\n  \"where\": { \"BIP.hyresobjektsnummer\": \"2022-F2008\" },\n  \"color\": \"#f00\",\n  \"fill\": \"#ff0\",\n  \"fillOpacity\": 1\n}\n```\n\n**Example — highlight spaces that appear in both plan and section:**\n```json\n\"highlight\": {\n  \"class\": \"space\",\n  \"where\": { \"BIP.hyresobjektsnummer\": \"2022-F2008\" },\n  \"intersectsViewport\": \"main\",\n  \"color\": \"#f00\",\n  \"fill\": \"#ff0\",\n  \"fillOpacity\": 1\n}\n```",
       "required": ["where"],
       "additionalProperties": false,
       "properties": {
@@ -454,22 +508,27 @@
           "description": "Viewport ID to intersect with. Only highlights items that appear in BOTH this viewport and the referenced viewport (i.e., their geometry intersects both cutting planes).",
           "markdownDescription": "Viewport ID to intersect with.\n\nOnly highlights items that appear in **both** this viewport and the referenced viewport. Useful for highlighting spaces at a specific level in a section view.\n\n**Example:** In a vertical section, highlight only the spaces that also appear in the plan view at Y=3:\n```json\n\"intersectsViewport\": \"plan\"\n```"
         },
-        "stroke": {
+        "color": {
           "$ref": "#/$defs/cssColor",
           "default": "#ff0000",
-          "description": "Stroke color for highlighted items."
+          "description": "Outline color for highlighted items (same vocabulary as lineStyles)."
         },
-        "strokeWidthMm": {
+        "widthMm": {
           "type": "number",
           "default": 0.5,
-          "description": "Stroke width in mm for highlighted items."
+          "description": "Outline width in mm for highlighted items."
         },
-        "strokeOpacity": {
+        "opacity": {
           "type": "number",
           "default": 1,
           "minimum": 0,
           "maximum": 1,
-          "description": "Stroke opacity for highlighted items."
+          "description": "Outline opacity for highlighted items."
+        },
+        "dash": {
+          "type": "string",
+          "description": "SVG stroke-dasharray for highlighted outlines (e.g. \"4 2\"). Omit for solid.",
+          "examples": ["4 2", "2 1", "6 2 1 2"]
         },
         "fill": {
           "$ref": "#/$defs/cssColor",
@@ -509,18 +568,27 @@
 
     "viewportLineStyles": {
       "type": "object",
-      "description": "Per-category line styles for a viewport. Resolution order: category-specific → default → built-in defaults.",
-      "markdownDescription": "Per-category line styles for a viewport.\n\n**Resolution order:** category-specific → `default` → built-in defaults\n\n**Line categories:**\n\n| Category | Description | Typical Style |\n|----------|-------------|---------------|\n| `cutLines` | Where plane cuts geometry | Thick, solid black |\n| `visibleLines` | Visible edges below plane | Medium, solid black |\n| `hiddenLines` | Hidden behind geometry | Thin, dashed gray |\n| `silhouettes` | Outline silhouettes | Medium, solid black |\n| `featureEdges` | Sharp edges (angle-based) | Thin, solid gray |\n| `stairArrows` | Direction arrows on stairs | Medium, solid black |\n| `outlineVisible` | Visible outline edges | Medium, solid black |\n| `outlineHidden` | Hidden outline edges | Thin, dashed gray |\n\n**Example — Standard floor plan:**\n```json\n\"lineStyles\": {\n  \"default\": { \"widthMm\": 0.01, \"color\": \"#1f2937\" },\n  \"cutLines\": { \"widthMm\": 0.02, \"color\": \"#000000\" },\n  \"hiddenLines\": { \"widthMm\": 0.005, \"color\": \"#9ca3af\", \"dash\": \"4 2\" },\n  \"stairArrows\": { \"widthMm\": 0.015, \"color\": \"#1f2937\" }\n}\n```\n\n**Example — Hide specific categories:**\n```json\n\"lineStyles\": {\n  \"default\": { \"widthMm\": 0.01, \"color\": \"#000000\" },\n  \"hiddenLines\": { \"enabled\": false },\n  \"featureEdges\": { \"enabled\": false }\n}\n```\n\n**⚠️ Performance tip:** Set `\"enabled\": false` for categories you don't need to speed up rendering.",
+      "description": "Per-category line styles for a viewport. Resolution order: category-specific → defaultVisibleLines/defaultHiddenLines (visibility group) → built-in category defaults → default → built-in defaults.",
+      "markdownDescription": "Per-category line styles for a viewport.\n\n**Resolution order (strongest first):** category-specific → `defaultVisibleLines`/`defaultHiddenLines` (the category's visibility group) → built-in category defaults → `default` → built-in defaults\n\n**Visibility groups:** `defaultVisibleLines` applies to `cutLines`, `visibleLines`, `silhouettesVisible`, `featureEdges`, `outlineVisible`. `defaultHiddenLines` applies to `hiddenLines`, `silhouettesHidden`, `outlineHidden`. `stairArrows` is an annotation and belongs to neither group.\n\n**Line categories:**\n\n| Category | Description | Typical Style |\n|----------|-------------|---------------|\n| `cutLines` | Where plane cuts geometry | Thick, solid black |\n| `visibleLines` | Visible edges below plane | Medium, solid black |\n| `hiddenLines` | Hidden behind geometry | Thin, dashed gray |\n| `silhouettesVisible` | Visible outline silhouettes | Medium, solid black |\n| `silhouettesHidden` | Occluded outline silhouettes | Thin, dashed gray |\n| `featureEdges` | Sharp edges (angle-based) | Thin, solid gray |\n| `stairArrows` | Direction arrows on stairs | Medium, solid black |\n| `outlineVisible` | Visible outline edges | Medium, solid black |\n| `outlineHidden` | Hidden outline edges | Thin, dashed gray |\n\n**Example — group defaults with one override:**\n```json\n\"lineStyles\": {\n  \"defaultVisibleLines\": { \"widthMm\": 0.1, \"color\": \"#000000\" },\n  \"defaultHiddenLines\": { \"widthMm\": 0.05, \"color\": \"#9ca3af\", \"dash\": \"2 1\" },\n  \"cutLines\": { \"widthMm\": 0.2 }\n}\n```\n\n**Example — Hide specific categories:**\n```json\n\"lineStyles\": {\n  \"default\": { \"widthMm\": 0.01, \"color\": \"#000000\" },\n  \"hiddenLines\": { \"enabled\": false },\n  \"featureEdges\": { \"enabled\": false }\n}\n```\n\n**⚠️ Performance tip:** Set `\"enabled\": false` for categories you don't need to speed up rendering.",
       "additionalProperties": false,
       "properties": {
         "default": {
           "$ref": "#/$defs/viewportLineStyle",
           "description": "Fallback style for any category not explicitly listed."
         },
+        "defaultVisibleLines": {
+          "$ref": "#/$defs/viewportLineStyle",
+          "description": "Group default for all visible-class categories (cutLines, visibleLines, silhouettesVisible, featureEdges, outlineVisible). Overridden by the specific category key."
+        },
+        "defaultHiddenLines": {
+          "$ref": "#/$defs/viewportLineStyle",
+          "description": "Group default for all hidden-class categories (hiddenLines, silhouettesHidden, outlineHidden). Overridden by the specific category key."
+        },
         "cutLines": { "$ref": "#/$defs/viewportLineStyle", "description": "Lines where the section plane cuts through geometry." },
         "visibleLines": { "$ref": "#/$defs/viewportLineStyle", "description": "Visible edges below the cut plane." },
         "hiddenLines": { "$ref": "#/$defs/viewportLineStyle", "description": "Edges hidden behind other geometry. Typically dashed and lighter." },
-        "silhouettes": { "$ref": "#/$defs/viewportLineStyle", "description": "Outline silhouettes of objects." },
+        "silhouettesVisible": { "$ref": "#/$defs/viewportLineStyle", "description": "Visible outline silhouettes of objects." },
+        "silhouettesHidden": { "$ref": "#/$defs/viewportLineStyle", "description": "Occluded outline silhouettes — dashed by default, like hiddenLines." },
         "featureEdges": { "$ref": "#/$defs/viewportLineStyle", "description": "Sharp edges detected by angle threshold." },
         "stairArrows": { "$ref": "#/$defs/viewportLineStyle", "description": "Directional arrows on stairs." },
         "outlineVisible": { "$ref": "#/$defs/viewportLineStyle", "description": "Visible outline edges." },
@@ -543,10 +611,10 @@
           "default": 0.25,
           "description": "Border width in mm."
         },
-        "dashed": {
-          "type": "boolean",
-          "default": false,
-          "description": "Use a dashed border."
+        "dash": {
+          "type": "string",
+          "description": "SVG stroke-dasharray in mm, e.g. \"4 2\".",
+          "examples": ["4 2", "2 1", "6 2 2 2"]
         }
       }
     },
@@ -583,7 +651,13 @@
           "description": "Text alignment within the column."
         },
         "minWidthMm": { "type": "number", "description": "Minimum column width in mm." },
-        "maxWidthMm": { "type": "number", "description": "Maximum column width in mm." }
+        "maxWidthMm": { "type": "number", "description": "Maximum column width in mm." },
+        "summary": {
+          "type": "boolean",
+          "default": false,
+          "description": "Include this column in the legend's summary (totals) row. Only meaningful for numerical columns.",
+          "markdownDescription": "Include this column in the legend's summary (totals) row.\n\nWhen `true`, the summary row shows the **sum** of all values in this column. Only meaningful for numerical columns.\n\nRequires the legend's `summary.enabled: true`.\n\n**Example:**\n```json\n{ \"id\": \"area\", \"label\": \"Area\", \"property\": \"BIP.area\", \"summary\": true }\n```"
+        }
       }
     },
 
@@ -672,7 +746,7 @@
         },
         {
           "label": "image",
-          "description": "Image from an asset",
+          "description": "Image from a resource",
           "body": {
             "kind": "image",
             "id": "${1:logo}",
@@ -680,7 +754,7 @@
             "yMm": "${3:10}",
             "widthMm": "${4:80}",
             "heightMm": "${5:20}",
-            "assetId": "${6:logo-main}",
+            "resourceId": "${6:logo-main}",
             "fit": "contain"
           }
         },
@@ -793,10 +867,10 @@
         },
         "align": {
           "type": "string",
-          "enum": ["center", "topLeft", "Left"],
+          "enum": ["center", "topLeft"],
           "default": "center",
           "description": "How the content is aligned within the viewport.",
-          "markdownDescription": "How the drawing content is aligned within the viewport.\n\n- **`center`** (default) — Center the drawing in the viewport\n  - Best for: Most cases, balanced composition\n  - Drawing is centered both horizontally and vertically\n\n- **`topLeft`** — Align to top-left corner\n  - Best for: When you want consistent positioning\n  - Drawing starts at viewport's top-left corner\n\n- **`Left`** — Align to left edge, center vertically\n  - Best for: When horizontal alignment matters\n  - Drawing is left-aligned, vertically centered"
+          "markdownDescription": "How the drawing content is aligned within the viewport.\n\n- **`center`** (default) — Center the drawing in the viewport\n  - Best for: Most cases, balanced composition\n  - Drawing is centered both horizontally and vertically\n\n- **`topLeft`** — Align to top-left corner\n  - Best for: When you want consistent positioning\n  - Drawing starts at viewport's top-left corner"
         },
         "rotationDeg": {
           "type": "number",
@@ -808,9 +882,44 @@
           "oneOf": [
             {
               "type": "array",
-              "items": { "$ref": "#/$defs/ifcClassName" },
-              "description": "Array of IFC class names to include."
+              "items": {
+                "oneOf": [
+                  { "$ref": "#/$defs/ifcClassName" },
+                  {
+                    "type": "object",
+                    "required": ["class"],
+                    "additionalProperties": false,
+                    "properties": {
+                      "class": {
+                        "oneOf": [
+                          { "$ref": "#/$defs/ifcClassName" },
+                          { "type": "array", "items": { "$ref": "#/$defs/ifcClassName" } }
+                        ],
+                        "description": "IFC class name(s) this conditional entry applies to."
+                      },
+                      "where": {
+                        "$ref": "#/$defs/whereCondition",
+                        "description": "Only include items of this class that match the condition."
+                      },
+                      "occludes": {
+                        "type": "boolean",
+                        "default": true,
+                        "description": "When false, this class's geometry never hides other lines (it stays out of the occlusion computation). Use for schematic classes like pipes that must not erase the architecture behind them.",
+                        "markdownDescription": "When `false`, this class's geometry never hides other lines — it stays out of the occlusion computation.\n\nUse for schematic classes like pipes that must not erase the architecture behind them. Also a major performance win for dense curved classes."
+                      },
+                      "classify": {
+                        "type": "boolean",
+                        "default": true,
+                        "description": "When false, this class's own lines skip hidden-line testing and draw as-is (always visible). Big performance win for dense classes like pipes; combine with occludes:false for fully schematic linework.",
+                        "markdownDescription": "When `false`, this class's own lines skip hidden-line testing and draw as-is (always visible).\n\nBig performance win for dense classes like pipes.\n\n```json\n{ \"class\": \"flow\", \"occludes\": false, \"classify\": false }\n```"
+                      }
+                    }
+                  }
+                ]
+              },
+              "description": "Class names and/or conditional { class, where } entries to include."
             },
+            { "$ref": "#/$defs/ifcClassName" },
             {
               "type": "object",
               "required": ["preset"],
@@ -819,24 +928,26 @@
                 "preset": {
                   "type": "string",
                   "description": "Name of an includeClasses preset from presets.includeClasses."
+                },
+                "add": {
+                  "type": "array",
+                  "items": { "$ref": "#/$defs/ifcClassName" },
+                  "description": "Classes to include in addition to the preset."
+                },
+                "remove": {
+                  "type": "array",
+                  "items": { "$ref": "#/$defs/ifcClassName" },
+                  "description": "Classes to exclude from the preset."
                 }
               }
             }
           ],
-          "description": "Which IFC classes to render in this viewport. Can be an array of class names or a preset reference.",
+          "description": "Which IFC classes to render in this viewport. A single class, an array of classes and/or { class, where } conditions, or a preset reference (optionally with add/remove).",
           "markdownDescription": "Which IFC classes to render in this viewport.\n\n**Option 1: Inline array** (simple, good for unique viewports)\n```json\n\"includeClasses\": [\"space\", \"walls\", \"windows\", \"doors\"]\n```\n\n**Option 2: Preset reference** (reusable, good for multiple viewports)\n```json\n\"includeClasses\": { \"preset\": \"defaultBuilding\" }\n```\nReferences `presets.includeClasses.defaultBuilding` from the top level.\n\n**Common patterns:**\n\n| Viewport Type | Typical Classes |\n|---------------|----------------|\n| **Floor plan** | `[\"space\", \"walls\", \"windows\", \"doors\", \"columns\", \"stairs\"]` |\n| **Structure only** | `[\"walls\", \"columns\", \"beam\", \"floor\"]` |\n| **Detail view** | `[\"walls\", \"windows\", \"beam\", \"columns\"]` |\n| **Section view** | `[\"space\", \"walls\", \"windows\", \"floor\", \"roof\"]` |\n| **MEP** | `[\"flow\", \"furniture\", \"walls\"]` |\n\n**⚠️ Performance tip:** Fewer classes = faster rendering. Only include what you need for the drawing.\n\n**If omitted:** All classes with geometry are included (may be slow for large models)"
         },
         "lineStyles": {
           "$ref": "#/$defs/viewportLineStyles",
-          "description": "Per-category line styles. Overrides lineWidthMm and lineColor."
-        },
-        "lineWidthMm": {
-          "type": "number",
-          "description": "Simple shorthand: default line width for all categories. Overridden by lineStyles."
-        },
-        "lineColor": {
-          "$ref": "#/$defs/cssColor",
-          "description": "Simple shorthand: default line color for all categories. Overridden by lineStyles."
+          "description": "Per-category line styles. Use `default` for a single style across all categories."
         },
         "fills": {
           "type": "array",
@@ -849,8 +960,8 @@
             "properties": {
               "class": {
                 "oneOf": [
-                  { "type": "string" },
-                  { "type": "array", "items": { "type": "string" } }
+                  { "$ref": "#/$defs/ifcClassName" },
+                  { "type": "array", "items": { "$ref": "#/$defs/ifcClassName" } }
                 ],
                 "description": "IFC class filter (e.g. 'space', 'walls').",
                 "markdownDescription": "IFC class filter.\n\nCan be a single class or array of classes:\n- `\"class\": \"space\"`\n- `\"class\": [\"space\", \"walls\"]`"
@@ -875,8 +986,8 @@
               "matchClipFilter": {
                 "type": "boolean",
                 "default": false,
-                "description": "Only fill items whose centroid is inside the original (unexpanded) clip polygon. Useful when expandByM reveals adjacent spaces that shouldn't be filled.",
-                "markdownDescription": "Only fill items whose centroid is inside the **original** (unexpanded) clip polygon.\n\nWhen `clip.expandByM` is used, the viewport shows geometry in an expanded area, but you may only want fills for items in the original clip area.\n\n**Example:**\n```json\n\"clip\": {\n  \"class\": \"space\",\n  \"where\": { \"BIP.hyresobjektsnummer\": \"2022-F2008\" },\n  \"expandByM\": 1.5\n},\n\"fills\": [{\n  \"class\": \"space\",\n  \"where\": { \"BIP.spacetype\": \"ROOM\" },\n  \"fill\": \"sample\",\n  \"matchClipFilter\": true\n}]\n```\n\nThis ensures only the tenant's own spaces are filled, not surrounding spaces visible due to `expandByM`."
+                "description": "Only fill items whose centroid is inside the original (unexpanded) clip polygon. Useful when expandBy reveals adjacent spaces that shouldn't be filled.",
+                "markdownDescription": "Only fill items whose centroid is inside the **original** (unexpanded) clip polygon.\n\nWhen `clip.expandBy` is used, the viewport shows geometry in an expanded area, but you may only want fills for items in the original clip area.\n\n**Example:**\n```json\n\"clip\": {\n  \"class\": \"space\",\n  \"where\": { \"BIP.hyresobjektsnummer\": \"2022-F2008\" },\n  \"expandBy\": 1.5\n},\n\"fills\": [{\n  \"class\": \"space\",\n  \"where\": { \"BIP.spacetype\": \"ROOM\" },\n  \"fill\": \"sample\",\n  \"matchClipFilter\": true\n}]\n```\n\nThis ensures only the tenant's own spaces are filled, not surrounding spaces visible due to `expandBy`."
               }
             }
           }
@@ -884,31 +995,31 @@
         "northArrow": {
           "type": "object",
           "description": "Optional north arrow overlay showing building orientation.",
-          "markdownDescription": "Optional north arrow overlay showing building orientation.\n\n**Purpose:**\nDisplays a north arrow on the viewport to indicate building orientation relative to true north.\n\n**Example:**\n```json\n\"northArrow\": {\n  \"assetId\": \"north-arrow-icon\",\n  \"sizeMm\": 15,\n  \"offsetXMm\": 5,\n  \"offsetYMm\": 5,\n  \"rotationDeg\": 45\n}\n```\n\n**Positioning:**\n- Arrow is positioned relative to viewport's **top-left corner**\n- Use positive offsets to move right (X) and down (Y)\n\n**Rotation:**\n- `rotationDeg` rotates the arrow to point north\n- Example: If building is rotated 45° from north, set `rotationDeg: 45`\n\n**Requires:**\n- Define the north arrow image in `assets`\n- Reference it via `assetId`",
-          "required": ["assetId"],
+          "markdownDescription": "Optional north arrow overlay showing building orientation.\n\n**Purpose:**\nDisplays a north arrow on the viewport to indicate building orientation relative to true north.\n\n**Example:**\n```json\n\"northArrow\": {\n  \"resourceId\": \"north-arrow-icon\",\n  \"sizeMm\": 12,\n  \"offsetXMm\": 8,\n  \"offsetYMm\": 8,\n  \"rotationDeg\": 45\n}\n```\n\n**Positioning:**\n- Arrow is anchored at the viewport's **top-right corner**\n- Positive offsets move it left (X) and down (Y) from that corner\n\n**Rotation:**\n- `rotationDeg` rotates the arrow to point north\n- Example: If building is rotated 45° from north, set `rotationDeg: 45`\n\n**Requires:**\n- Define the north arrow image in `resources`\n- Reference it via `resourceId`",
+          "required": ["resourceId"],
           "additionalProperties": false,
           "properties": {
-            "assetId": {
+            "resourceId": {
               "type": "string",
-              "description": "Asset ID for the north arrow image (SVG or raster).",
+              "description": "Resource ID for the north arrow image (SVG or raster).",
               "examples": ["north-arrow", "north-icon"]
             },
             "sizeMm": {
               "type": "number",
               "description": "Size of the north arrow in mm (width and height).",
-              "default": 15,
+              "default": 12,
               "examples": [10, 15, 20]
             },
             "offsetXMm": {
               "type": "number",
-              "description": "Horizontal offset from viewport's top-left corner in mm.",
-              "default": 5,
+              "description": "Horizontal offset (leftwards) from the viewport's top-right corner in mm.",
+              "default": 8,
               "examples": [5, 10]
             },
             "offsetYMm": {
               "type": "number",
-              "description": "Vertical offset from viewport's top-left corner in mm.",
-              "default": 5,
+              "description": "Vertical offset (downwards) from the viewport's top-right corner in mm.",
+              "default": 8,
               "examples": [5, 10]
             },
             "rotationDeg": {
@@ -923,14 +1034,14 @@
         "clip": { "$ref": "#/$defs/clipConfig" },
         "highlight": { "$ref": "#/$defs/highlightConfig" },
         "cutHeight": {
-          "type": "number",
-          "description": "Override cutting plane height for horizontal plans (Y coordinate). Shorthand for planeNormal=[0,1,0], planePosition=cutHeight.",
+          "oneOf": [{ "type": "number" }, { "type": "string", "pattern": "^\\{\\{vars\\.\\w+\\}\\}$" }],
+          "description": "Override cutting plane height for horizontal plans (Y coordinate, metres). Shorthand for planeNormal=[0,1,0], planePosition=cutHeight. May be a variable binding like '{{vars.cutHeight}}' (number variable) so users control the cut via the variables UI.",
           "markdownDescription": "Override cutting plane height for horizontal plans (Y coordinate).\n\n**Shorthand for:**\n```json\n\"planeNormal\": [0, 1, 0],\n\"planePosition\": <cutHeight value>\n```\n\n**Common values:**\n- `3.0` — 3 meters above origin (typical floor plan height)\n- `1.5` — 1.5 meters (lower section height)\n- `5.0` — 5 meters (upper level)\n\n**When to use:**\n- For simple horizontal floor plans at a specific elevation\n- When you don't need vertical or diagonal sections\n\n**If omitted:** Uses app default height (typically 3.0m)"
         },
         "depth": {
           "type": "object",
           "description": "Override depth above/below cutting plane. Only applicable for SLAB mode (ignored in PLANE mode).",
-          "markdownDescription": "Override depth above/below cutting plane.\n\n**⚠️ SLAB mode only** — This property is ignored in PLANE mode (vertical sections).\n\nDefines the thickness of the \"slab\" that includes geometry:\n- `above` — How far above the cutting plane to include geometry\n- `below` — How far below the cutting plane to include geometry\n\n**Example — Standard floor plan:**\n```json\n\"cutHeight\": 3.0,\n\"depth\": {\n  \"above\": 1.0,\n  \"below\": 2.0\n}\n```\nThis includes geometry from Y=1.0 to Y=5.0 (3.0 - 2.0 to 3.0 + 1.0).\n\n**If omitted:** Uses app default depth settings",
+          "markdownDescription": "Override depth above/below cutting plane.\n\n**⚠️ SLAB mode only** — This property is ignored in PLANE mode (vertical sections).\n\nDefines the thickness of the \"slab\" that includes geometry:\n- `above` — How far above the cutting plane to include geometry\n- `below` — How far below the cutting plane to include geometry\n\n**Example — Standard floor plan:**\n```json\n\"cutHeight\": 3.0,\n\"depth\": {\n  \"above\": 1.0,\n  \"below\": 2.0\n}\n```\nThis includes geometry from Y=1.0 to Y=5.0 (3.0 - 2.0 up to 3.0 + 1.0 = 4.0).\n\n**If omitted:** Uses app default depth settings",
           "additionalProperties": false,
           "properties": {
             "above": {
@@ -945,6 +1056,49 @@
             }
           }
         },
+        "stairArrows": {
+          "type": "object",
+          "description": "Stair-arrow geometry options for plan viewports: marker shapes and run sizing. Stroke/color/width and hiding stay under lineStyles.stairArrows. Ignored for elevations/sections.",
+          "markdownDescription": "Stair-arrow **geometry** options for plan viewports — the shape of the generated arrows.\n\nStyling (stroke, color, width) and hiding stay under `lineStyles.stairArrows`; this object controls what gets generated.\n\n**Example — open markers per Bygghandlingar 90:**\n```json\n\"stairArrows\": {\n  \"startMarker\": \"open\",\n  \"arrowhead\": \"open\"\n}\n```\n\n**Ignored** for elevations/sections (they generate no stair arrows).",
+          "additionalProperties": false,
+          "properties": {
+            "startMarker": {
+              "type": "string",
+              "enum": ["filled", "open", "none"],
+              "default": "filled",
+              "description": "Marker at the run's bottom end: 'filled' (solid circle), 'open' (outline circle), or 'none'."
+            },
+            "arrowhead": {
+              "type": "string",
+              "enum": ["filled", "outline", "open"],
+              "default": "filled",
+              "description": "Arrowhead at the run's top end: 'filled' (solid triangle), 'outline' (hollow triangle), or 'open' (two barb strokes)."
+            },
+            "lengthScale": {
+              "type": "number",
+              "minimum": 0,
+              "description": "Fraction of the flight length the arrow occupies.",
+              "examples": [0.6]
+            },
+            "minLength": {
+              "type": "number",
+              "minimum": 0,
+              "description": "Minimum arrow length in metres.",
+              "examples": [0.8]
+            },
+            "maxLength": {
+              "type": "number",
+              "minimum": 0,
+              "description": "Maximum arrow length in metres.",
+              "examples": [20]
+            },
+            "landingExtension": {
+              "type": "number",
+              "minimum": 0,
+              "description": "How far the walking line extends onto a landing when the landing's own geometry can't anchor it (metres)."
+            }
+          }
+        },
         "planeNormal": {
           "type": "array",
           "description": "Plane normal vector [x, y, z]. Automatically normalized. Takes precedence over cutHeight.",
@@ -954,15 +1108,9 @@
           "maxItems": 3
         },
         "planePosition": {
-          "type": "number",
-          "description": "Distance from origin along the (normalized) plane normal. Required when using planeNormal.",
+          "oneOf": [{ "type": "number" }, { "type": "string", "pattern": "^\\{\\{vars\\.\\w+\\}\\}$" }],
+          "description": "Distance from origin along the (normalized) plane normal (metres). Required when using planeNormal. May be a variable binding like '{{vars.sectionPosition}}'.",
           "markdownDescription": "Distance from origin along the (normalized) plane normal.\n\n**How it works:**\nThe plane passes through the point: `normalize(planeNormal) * planePosition`\n\n**Examples:**\n\n**Vertical section at X=50:**\n```json\n\"planeNormal\": [1, 0, 0],\n\"planePosition\": 50\n```\nPlane perpendicular to X-axis, 50 meters from origin.\n\n**Vertical section at Z=30:**\n```json\n\"planeNormal\": [0, 0, 1],\n\"planePosition\": 30\n```\nPlane perpendicular to Z-axis, 30 meters from origin.\n\n**Horizontal plan at Y=3:**\n```json\n\"planeNormal\": [0, 1, 0],\n\"planePosition\": 3\n```\nSame as `\"cutHeight\": 3`.\n\n**⚠️ Must be used together with `planeNormal`**"
-        },
-        "mode": {
-          "type": "string",
-          "enum": ["slab", "plane"],
-          "description": "Section computation mode: 'slab' (horizontal plans) or 'plane' (vertical sections). Auto-detected if omitted.",
-          "markdownDescription": "Section computation mode:\n\n- **`slab`** — Optimized for horizontal floor plans. Uses `depth.above`/`depth.below` to include geometry in a thickness slab around the cutting plane. Fast and efficient for plan views.\n- **`plane`** — Arbitrary plane cuts (vertical sections, diagonal sections). Computes exact intersection with the plane. Required for non-horizontal sections.\n\n**Auto-detection (if omitted):**\n- Horizontal planes (`planeNormal` ≈ Y-axis) → `slab`\n- Vertical or diagonal planes → `plane`\n\n**⚠️ Important limitations:**\n- **Vertical sections MUST use `plane` mode** — SLAB mode only works correctly for horizontal plans\n- **Diagonal sections require `plane` mode**\n- If ANY viewport in a template requires `plane` mode, the entire export uses `plane` mode (auto-switching with console warning)\n\n**When to set explicitly:**\n- Set `\"mode\": \"plane\"` for vertical sections to be explicit\n- Set `\"mode\": \"slab\"` for horizontal plans if you want to ensure SLAB optimizations\n- Omit for auto-detection (recommended for most cases)"
         }
       }
     },
@@ -970,7 +1118,7 @@
     "textElement": {
       "type": "object",
       "description": "Static or template text placed at a fixed position on the page.",
-      "markdownDescription": "Static or template text placed at a fixed position on the page.\n\n**Use cases:**\n- Drawing titles\n- Scale indicators (\"Scale: 1:100\")\n- Project metadata (dates, revision numbers)\n- Fixed labels (\"PLAN\", \"SECTION A-A\")\n\n**Template variables:**\nUse `{{variable}}` syntax for dynamic content:\n\n| Variable | Output | Example |\n|----------|--------|----------|\n| `{{viewport.<id>.scaleText}}` | Scale ratio | `1:100` |\n| `{{buildStamp}}` | Build timestamp | `2025-02-24T14:30Z` |\n| Custom data keys | Passed via options | Any value |\n\n**Examples:**\n\n**Scale indicator:**\n```json\n{\n  \"kind\": \"text\",\n  \"id\": \"scale-text\",\n  \"xMm\": 210,\n  \"yMm\": 275,\n  \"textStyle\": \"body\",\n  \"align\": \"center\",\n  \"text\": \"Scale: {{viewport.main.scaleText}}\"\n}\n```\nOutput: `Scale: 1:100`\n\n**Drawing title with scale:**\n```json\n{\n  \"kind\": \"text\",\n  \"id\": \"title\",\n  \"xMm\": 10,\n  \"yMm\": 15,\n  \"textStyle\": \"title\",\n  \"text\": \"Floor Plan 02 — {{viewport.main.scaleText}}\"\n}\n```\nOutput: `Floor Plan 02 — 1:100`\n\n**Static text:**\n```json\n{\n  \"kind\": \"text\",\n  \"id\": \"section-label\",\n  \"xMm\": 320,\n  \"yMm\": 95,\n  \"textStyle\": \"body\",\n  \"text\": \"SECTION A-A\"\n}\n```",
+      "markdownDescription": "Static or template text placed at a fixed position on the page.\n\n**Use cases:**\n- Drawing titles\n- Scale indicators (\"Scale: 1:100\")\n- Project metadata (dates, revision numbers)\n- Fixed labels (\"PLAN\", \"SECTION A-A\")\n\n**Template variables:**\nUse `{{variable}}` syntax for dynamic content:\n\n| Variable | Output | Example |\n|----------|--------|----------|\n| `{{viewport.<id>.scaleText}}` | Scale ratio | `1:100` |\n| `{{vars.<name>}}` | Declared template variable | Any value |\n\n**Examples:**\n\n**Scale indicator:**\n```json\n{\n  \"kind\": \"text\",\n  \"id\": \"scale-text\",\n  \"xMm\": 210,\n  \"yMm\": 275,\n  \"textStyle\": \"body\",\n  \"align\": \"center\",\n  \"text\": \"Scale: {{viewport.main.scaleText}}\"\n}\n```\nOutput: `Scale: 1:100`\n\n**Drawing title with scale:**\n```json\n{\n  \"kind\": \"text\",\n  \"id\": \"title\",\n  \"xMm\": 10,\n  \"yMm\": 15,\n  \"textStyle\": \"title\",\n  \"text\": \"Floor Plan 02 — {{viewport.main.scaleText}}\"\n}\n```\nOutput: `Floor Plan 02 — 1:100`\n\n**Static text:**\n```json\n{\n  \"kind\": \"text\",\n  \"id\": \"section-label\",\n  \"xMm\": 320,\n  \"yMm\": 95,\n  \"textStyle\": \"body\",\n  \"text\": \"SECTION A-A\"\n}\n```",
       "required": ["kind", "id", "xMm", "yMm", "text"],
       "additionalProperties": false,
       "properties": {
@@ -989,11 +1137,9 @@
           "description": "Text content. Use {{variable}} for template interpolation.",
           "examples": [
             "Scale: {{viewport.main.scaleText}}",
-            "Build: {{buildStamp}}",
             "Hyresobjekt: 2022-F2008"
           ]
         },
-        "maxWidthMm": { "type": "number", "description": "Maximum text width in mm before wrapping." },
         "align": {
           "type": "string",
           "enum": ["left", "center", "right"],
@@ -1005,8 +1151,8 @@
 
     "imageElement": {
       "type": "object",
-      "description": "An image element placed on the page. References an asset by ID.",
-      "required": ["kind", "id", "xMm", "yMm", "widthMm", "heightMm", "assetId"],
+      "description": "An image element placed on the page. References a resource by ID.",
+      "required": ["kind", "id", "xMm", "yMm", "widthMm", "heightMm", "resourceId"],
       "additionalProperties": false,
       "properties": {
         "kind": { "const": "image" },
@@ -1016,7 +1162,7 @@
         "yMm": { "type": "number", "description": "Y position on page in mm." },
         "widthMm": { "type": "number", "description": "Image width in mm." },
         "heightMm": { "type": "number", "description": "Image height in mm." },
-        "assetId": { "type": "string", "description": "ID of an asset from the assets array." },
+        "resourceId": { "type": "string", "description": "ID of a resource from the resources array." },
         "fit": {
           "type": "string",
           "enum": ["contain", "cover", "stretch"],
@@ -1042,7 +1188,7 @@
         "y2Mm": { "type": "number", "description": "End Y in mm." },
         "stroke": { "$ref": "#/$defs/cssColor", "default": "#000", "description": "Line color." },
         "strokeWidthMm": { "type": "number", "default": 0.25, "description": "Line width in mm." },
-        "dashed": { "type": "boolean", "default": false, "description": "Use a dashed line." }
+        "dash": { "type": "string", "description": "SVG stroke-dasharray in mm, e.g. \"4 2\"." }
       }
     },
 
@@ -1062,7 +1208,7 @@
         "stroke": { "$ref": "#/$defs/cssColor", "description": "Border color." },
         "strokeWidthMm": { "type": "number", "description": "Border width in mm." },
         "fill": { "$ref": "#/$defs/cssColor", "default": "none", "description": "Fill color. \"none\" for no fill." },
-        "dashed": { "type": "boolean", "default": false, "description": "Use a dashed border." }
+        "dash": { "type": "string", "description": "SVG stroke-dasharray in mm, e.g. \"4 2\"." }
       }
     },
 
@@ -1081,7 +1227,7 @@
         "stroke": { "$ref": "#/$defs/cssColor", "description": "Border color." },
         "strokeWidthMm": { "type": "number", "description": "Border width in mm." },
         "fill": { "$ref": "#/$defs/cssColor", "default": "none", "description": "Fill color." },
-        "dashed": { "type": "boolean", "default": false }
+        "dash": { "type": "string", "description": "SVG stroke-dasharray in mm, e.g. \"4 2\"." }
       }
     },
 
@@ -1107,7 +1253,7 @@
         "points": { "type": "array", "items": { "$ref": "#/$defs/pointMm" }, "description": "Array of points in mm." },
         "stroke": { "$ref": "#/$defs/cssColor", "description": "Line color." },
         "strokeWidthMm": { "type": "number", "description": "Line width in mm." },
-        "dashed": { "type": "boolean", "default": false }
+        "dash": { "type": "string", "description": "SVG stroke-dasharray in mm, e.g. \"4 2\"." }
       }
     },
 
@@ -1124,7 +1270,7 @@
         "stroke": { "$ref": "#/$defs/cssColor", "description": "Border color." },
         "strokeWidthMm": { "type": "number", "description": "Border width in mm." },
         "fill": { "$ref": "#/$defs/cssColor", "default": "none", "description": "Fill color." },
-        "dashed": { "type": "boolean", "default": false }
+        "dash": { "type": "string", "description": "SVG stroke-dasharray in mm, e.g. \"4 2\"." }
       }
     },
 
@@ -1225,16 +1371,11 @@
           "description": "Label text alignment.",
           "markdownDescription": "Label text alignment.\n\n- **`center`** (default) — Centered on item centroid (best for room labels)\n- **`left`** — Aligned left from centroid\n- **`right`** — Aligned right from centroid"
         },
-        "maxWidthMm": {
-          "type": "number",
-          "description": "Maximum label width in mm before wrapping.",
-          "markdownDescription": "Maximum label width in mm before text wrapping.\n\n**Example:**\n```json\n\"maxWidthMm\": 30\n```\nLabels longer than 30mm will wrap to multiple lines.\n\n**If omitted:** No wrapping (single line, may overflow)"
-        },
         "matchClipFilter": {
           "type": "boolean",
           "default": false,
           "description": "Only show labels for items inside the viewport's clip boundary (if clip is configured).",
-          "markdownDescription": "Only show labels for items inside the viewport's clip boundary.\n\n**When to use:**\n- You have a `clip` configured on the viewport\n- You only want labels for items in the clipped area\n- You're using `expandByM` and don't want labels outside the original clip\n\n**Example:**\n```json\n\"clip\": {\n  \"class\": \"space\",\n  \"where\": { \"BIP.hyresobjektsnummer\": \"2022-F2008\" },\n  \"expandByM\": 1.5\n},\n\"labels\": {\n  \"class\": \"space\",\n  \"where\": { \"BIP.spacetype\": \"ROOM\" },\n  \"text\": \"{{BIP.spacename}}\",\n  \"matchClipFilter\": true\n}\n```\n\nLabels only appear for rooms whose centroid is in the ORIGINAL (unexpanded) clip polygon."
+          "markdownDescription": "Only show labels for items inside the viewport's clip boundary.\n\n**When to use:**\n- You have a `clip` configured on the viewport\n- You only want labels for items in the clipped area\n- You're using `expandBy` and don't want labels outside the original clip\n\n**Example:**\n```json\n\"clip\": {\n  \"class\": \"space\",\n  \"where\": { \"BIP.hyresobjektsnummer\": \"2022-F2008\" },\n  \"expandBy\": 1.5\n},\n\"labels\": {\n  \"class\": \"space\",\n  \"where\": { \"BIP.spacetype\": \"ROOM\" },\n  \"text\": \"{{BIP.spacename}}\",\n  \"matchClipFilter\": true\n}\n```\n\nLabels only appear for rooms whose centroid is in the ORIGINAL (unexpanded) clip polygon."
         }
       }
     },
@@ -1304,41 +1445,75 @@
           "default": 2,
           "description": "Padding inside each legend cell in mm."
         },
-        "borderStrokeWidthMm": {
-          "type": "number",
-          "default": 0.25,
-          "description": "Outer border stroke width in mm."
-        },
-        "borderStrokeColor": {
-          "$ref": "#/$defs/cssColor",
-          "default": "#000000",
-          "description": "Outer border color."
-        },
-        "gridStrokeWidthMm": {
-          "type": "number",
-          "default": 0.25,
-          "description": "Internal grid line width in mm."
-        },
-        "gridStrokeColor": {
-          "$ref": "#/$defs/cssColor",
-          "default": "#000000",
-          "description": "Internal grid line color."
+        "border": {
+          "type": "object",
+          "additionalProperties": false,
+          "description": "Outer table border — same stroke vocabulary as shape elements.",
+          "properties": {
+            "stroke": { "$ref": "#/$defs/cssColor", "default": "#000000", "description": "Border color." },
+            "strokeWidthMm": { "type": "number", "default": 0.25, "description": "Border width in mm." }
+          }
         },
-        "headerStrokeWidthMm": {
-          "type": "number",
-          "default": 0.65,
-          "description": "Stroke width under the header row in mm (thicker for visual emphasis)."
+        "grid": {
+          "type": "object",
+          "additionalProperties": false,
+          "description": "Inner grid lines between rows and columns.",
+          "properties": {
+            "stroke": { "$ref": "#/$defs/cssColor", "default": "#000000", "description": "Grid line color." },
+            "strokeWidthMm": { "type": "number", "default": 0.25, "description": "Grid line width in mm." }
+          }
         },
-        "headerStrokeColor": {
-          "$ref": "#/$defs/cssColor",
-          "default": "#000000",
-          "description": "Color of the stroke under the header row."
+        "header": {
+          "type": "object",
+          "additionalProperties": false,
+          "description": "Header separator line (also used above the summary row).",
+          "properties": {
+            "stroke": { "$ref": "#/$defs/cssColor", "default": "#000000", "description": "Separator color." },
+            "strokeWidthMm": { "type": "number", "default": 0.65, "description": "Separator width in mm." }
+          }
         },
         "columns": {
           "type": "array",
           "description": "Column definitions for the legend table.",
           "items": { "$ref": "#/$defs/legendColumn" },
           "minItems": 1
+        },
+        "summary": {
+          "type": "object",
+          "description": "Summary (totals) row at the bottom of the legend. Columns with summary: true show their sum.",
+          "markdownDescription": "Summary (totals) row at the bottom of the legend.\n\nColumns with `summary: true` show their **sum** in this row.\n\n**Example:**\n```json\n\"summary\": { \"enabled\": true, \"label\": \"Total\" },\n\"columns\": [\n  { \"id\": \"name\", \"label\": \"Room\", \"property\": \"BIP.spacename\" },\n  { \"id\": \"area\", \"label\": \"Area\", \"property\": \"BIP.area\", \"summary\": true }\n]\n```",
+          "required": ["enabled"],
+          "additionalProperties": false,
+          "properties": {
+            "enabled": { "type": "boolean", "description": "Enable the summary row." },
+            "label": {
+              "type": "string",
+              "default": "Total",
+              "description": "Label shown in the first column of the summary row."
+            }
+          }
+        },
+        "groupBy": {
+          "type": "string",
+          "description": "Group legend rows by a property path (e.g. BIP.spacename): identical values consolidate into one row; numerical columns are summed, others take the first value.",
+          "markdownDescription": "Group legend rows by a **property path** (short form, e.g. `BIP.spacename`).\n\nRows with identical values in the groupBy property consolidate into a single row — numerical columns are **summed** across the group; non-numerical columns take the first value.\n\n**Example:**\n```json\n\"groupBy\": \"BIP.spacename\",\n\"columns\": [\n  { \"id\": \"name\", \"label\": \"Room\", \"property\": \"BIP.spacename\" },\n  { \"id\": \"area\", \"label\": \"Area\", \"property\": \"BIP.area\", \"format\": { \"digits\": 2 } }\n]\n```\nGroups all rooms with the same name and sums their areas."
+        },
+        "assignColors": {
+          "type": "object",
+          "description": "Assign a distinct color to each legend row (or group) and expose them to the viewport: fill rules with fill: \"legend\" use these colors.",
+          "markdownDescription": "Assign a distinct color to each legend row (or group when `groupBy` is set) and apply them to the referenced viewport.\n\nThe viewport uses these colors via a fill rule with `\"fill\": \"legend\"`.\n\n**Example:**\n```json\n\"assignColors\": { \"enabled\": true, \"palette\": \"auto\" },\n\"groupBy\": \"BIP.spacename\"\n```\nGenerates distinct colors per room type, applied to matching spaces in the viewport.",
+          "required": ["enabled"],
+          "additionalProperties": false,
+          "properties": {
+            "enabled": { "type": "boolean", "description": "Enable color assignment to viewport items." },
+            "palette": {
+              "description": "\"auto\" for generated colors, or an explicit array of CSS colors used in row order.",
+              "oneOf": [
+                { "const": "auto" },
+                { "type": "array", "items": { "$ref": "#/$defs/cssColor" }, "minItems": 1 }
+              ]
+            }
+          }
         }
       }
     },