@twinfinity/printing 5.0.3-ci.28538-beta

package/templates/template-schema.json

@@ -0,0 +1,1395 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$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",
+  "type": "object",
+  "required": ["page", "elements"],
+  "additionalProperties": false,
+  "defaultSnippets": [
+    {
+      "label": "New template",
+      "description": "Full template skeleton with page, styles, presets, and a viewport",
+      "body": {
+        "$$schema": "./template-schema.json",
+        "id": "${1:my-template}",
+        "page": { "widthMm": ${2:420}, "heightMm": ${3:297}, "marginMm": 10, "backgroundColor": "#ffffff" },
+        "styles": {
+          "body": { "fontFamily": "Arial", "fontSizeMm": 3.5, "color": "#000000" },
+          "spaceLabels": { "fontFamily": "Arial", "fontSizeMm": 2.5, "color": "#000000" }
+        },
+        "presets": {
+          "includeClasses": {
+            "defaultBuilding": ["space", "walls", "windows", "doors", "columns", "stairs", "floor"]
+          },
+          "scales": {
+            "default": { "preferredScales": [50, 100, 150, 200, 250, 500, 1000] }
+          }
+        },
+        "elements": [
+          {
+            "kind": "viewport",
+            "id": "main",
+            "xMm": 10,
+            "yMm": 30,
+            "widthMm": 400,
+            "heightMm": 240,
+            "includeClasses": { "preset": "defaultBuilding" },
+            "scaleMode": "fitAndRound",
+            "scalePreset": "default",
+            "align": "center",
+            "fills": [{ "class": "space", "fill": "sample", "fillOpacity": 0.35 }]
+          },
+          {
+            "kind": "text",
+            "id": "title",
+            "xMm": 10,
+            "yMm": 15,
+            "textStyle": "body",
+            "text": "${4:Drawing title} — {{viewport.main.scaleText}}"
+          },
+          {
+            "kind": "scaleBar",
+            "id": "scale-bar",
+            "xMm": 10,
+            "yMm": 280,
+            "maxLengthMm": 100,
+            "unit": "m",
+            "segments": 4,
+            "stroke": "#000000",
+            "strokeWidthMm": 0.25,
+            "textStyle": "body"
+          }
+        ]
+      }
+    },
+    {
+      "label": "Minimal template",
+      "description": "Bare minimum: page + one viewport",
+      "body": {
+        "$$schema": "./template-schema.json",
+        "id": "${1:minimal}",
+        "page": { "widthMm": ${2:420}, "heightMm": ${3:297} },
+        "elements": [
+          {
+            "kind": "viewport",
+            "id": "main",
+            "xMm": 10,
+            "yMm": 10,
+            "widthMm": 400,
+            "heightMm": 277,
+            "scaleMode": "fitAndRound",
+            "align": "center"
+          }
+        ]
+      }
+    }
+  ],
+  "properties": {
+    "$schema": {
+      "type": "string",
+      "description": "Path to this JSON schema file (for editor autocompletion).",
+      "markdownDescription": "Path to this JSON schema file.\n\n**Always set to:** `\"./template-schema.json\"`\n\nEnables autocomplete, validation, and inline documentation in VS Code and other editors."
+    },
+    "id": {
+      "type": "string",
+      "description": "Unique identifier for this template.",
+      "markdownDescription": "Unique identifier for this template.\n\n**Used for:**\n- Template selection in UI\n- Logging and debugging\n- File naming conventions\n\n**Format:** `kebab-case` (lowercase with hyphens)\n\n**Examples:** `floor-plan-a3`, `section-detail`, `tenant-appendix`"
+    },
+    "page": {
+      "$ref": "#/$defs/page",
+      "description": "Page dimensions and background."
+    },
+    "styles": {
+      "$ref": "#/$defs/styles",
+      "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": {
+      "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" }
+    },
+    "elements": {
+      "type": "array",
+      "description": "All layout elements to render on the page.",
+      "markdownDescription": "All layout elements to render on the page.\n\n**Available element types:**\n- `viewport` — BIM section geometry\n- `text` — Static or template text\n- `labels` — Per-item labels (room names)\n- `legend` — Table with properties\n- `scaleBar` — Graphical scale\n- `qr` — QR codes\n- `image` — Logos, icons\n- `line`, `rect`, `circle` — Basic shapes\n- `polyline`, `polygon` — Custom vectors\n- `group` — Container with transforms\n\n**Order matters:**\n- Elements are rendered in array order\n- Later elements appear on top (unless `zIndex` is used)\n- Use `zIndex` for explicit layering",
+      "items": { "$ref": "#/$defs/element" }
+    },
+    "presets": {
+      "$ref": "#/$defs/presets",
+      "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": {
+      "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."
+    }
+  },
+
+  "$defs": {
+    "cssColor": {
+      "type": "string",
+      "description": "CSS color value.",
+      "examples": ["#000000", "#ff0000", "#9ca3af", "none", "rgb(255,0,0)", "rgba(0,0,0,0.5)"]
+    },
+
+    "ifcClassName": {
+      "type": "string",
+      "description": "IFC class name. Use short aliases (space, walls, doors, etc.) or full IFC names (IfcWall, IfcDoor, etc.). Case-insensitive.",
+      "markdownDescription": "IFC class name. Case-insensitive.\n\n**Short aliases** (match all subtypes in category):\n`space` `walls` `windows` `doors` `columns` `beam` `stairs` `floor` `roof` `covering` `furniture` `reinforcement` `flow` `annotations` `other`\n\n**Full IFC names** also work: `IfcWall`, `IfcDoor`, `IfcSpace`, etc.",
+      "anyOf": [
+        {
+          "enum": [
+            "space", "walls", "windows", "doors", "columns", "beam", "stairs",
+            "floor", "roof", "covering", "furniture", "reinforcement", "flow",
+            "annotations", "other"
+          ],
+          "description": "Short alias — matches all IFC subtypes in this category."
+        },
+        {
+          "enum": [
+            "IfcWall", "IfcWallStandardCase", "IfcWallElementedCase",
+            "IfcDoor", "IfcDoorStandardCase",
+            "IfcWindow", "IfcWindowStandardCase",
+            "IfcColumn", "IfcColumnStandardCase",
+            "IfcBeam", "IfcBeamStandardCase",
+            "IfcSlab", "IfcSlabStandardCase", "IfcSlabElementedCase",
+            "IfcStair", "IfcStairFlight",
+            "IfcRamp", "IfcRampFlight",
+            "IfcRailing",
+            "IfcRoof",
+            "IfcSpace",
+            "IfcCurtainWall",
+            "IfcCovering",
+            "IfcPlate", "IfcPlateStandardCase",
+            "IfcMember", "IfcMemberStandardCase",
+            "IfcFooting",
+            "IfcPile",
+            "IfcBuildingElementProxy",
+            "IfcFurnishingElement", "IfcFurniture", "IfcSystemFurnitureElement",
+            "IfcOpeningElement", "IfcOpeningStandardCase",
+            "IfcChimney",
+            "IfcShadingDevice",
+            "IfcReinforcingBar", "IfcReinforcingMesh",
+            "IfcTendon", "IfcTendonAnchor", "IfcTendonConduit",
+            "IfcBuildingElementPart",
+            "IfcDiscreteAccessory", "IfcFastener", "IfcMechanicalFastener",
+            "IfcAnnotation",
+            "IfcGrid",
+            "IfcSite", "IfcBuilding", "IfcBuildingStorey", "IfcProject",
+            "IfcProxy",
+            "IfcDistributionElement", "IfcDistributionFlowElement",
+            "IfcDistributionControlElement", "IfcDistributionPort",
+            "IfcFlowTerminal", "IfcFlowSegment", "IfcFlowFitting",
+            "IfcFlowController", "IfcFlowMovingDevice",
+            "IfcFlowStorageDevice", "IfcFlowTreatmentDevice",
+            "IfcEnergyConversionDevice",
+            "IfcPipeFitting", "IfcPipeSegment",
+            "IfcDuctFitting", "IfcDuctSegment", "IfcDuctSilencer",
+            "IfcCableCarrierFitting", "IfcCableCarrierSegment",
+            "IfcCableFitting", "IfcCableSegment",
+            "IfcSanitaryTerminal", "IfcWasteTerminal",
+            "IfcFireSuppressionTerminal", "IfcStackTerminal",
+            "IfcAirTerminal", "IfcAirTerminalBox",
+            "IfcLightFixture", "IfcLamp",
+            "IfcOutlet", "IfcSwitchingDevice", "IfcJunctionBox",
+            "IfcElectricAppliance", "IfcElectricDistributionBoard",
+            "IfcElectricGenerator", "IfcElectricMotor",
+            "IfcSpaceHeater", "IfcCooledBeam",
+            "IfcBoiler", "IfcChiller", "IfcCompressor", "IfcCondenser",
+            "IfcHeatExchanger", "IfcHumidifier", "IfcEvaporator", "IfcEvaporativeCooler",
+            "IfcFan", "IfcPump", "IfcValve", "IfcDamper", "IfcFilter",
+            "IfcTank",
+            "IfcSensor", "IfcActuator", "IfcAlarm", "IfcController",
+            "IfcFlowMeter", "IfcFlowInstrument",
+            "IfcUnitaryEquipment", "IfcUnitaryControlElement",
+            "IfcTransformer", "IfcMotorConnection",
+            "IfcProtectiveDevice", "IfcProtectiveDeviceTrippingUnit",
+            "IfcDistributionBoard", "IfcDistributionChamberElement",
+            "IfcCommunicationsAppliance", "IfcAudioVisualAppliance",
+            "IfcMedicalDevice", "IfcTransportElement",
+            "IfcElementAssembly",
+            "IfcCivilElement", "IfcGeographicElement",
+            "IfcBridge", "IfcBridgePart",
+            "IfcRoad", "IfcRoadPart",
+            "IfcRailway", "IfcRailwayPart",
+            "IfcMarineFacility", "IfcMarinePart",
+            "IfcAlignment", "IfcReferent", "IfcLinearElement",
+            "IfcBuiltElement", "IfcVirtualElement",
+            "IfcSurfaceFeature", "IfcVoidingFeature",
+            "IfcEarthworksElement", "IfcEarthworksCut", "IfcEarthworksFill",
+            "IfcReinforcedSoil", "IfcGeomodel", "IfcGeoslice",
+            "IfcCourse", "IfcKerb", "IfcPavement",
+            "IfcSign", "IfcSignal",
+            "IfcRail", "IfcTrackElement",
+            "IfcBorehole", "IfcCaissonFoundation", "IfcDeepFoundation",
+            "IfcNavigationElement", "IfcMooringDevice",
+            "IfcImpactProtectionDevice", "IfcVibrationDamper", "IfcVibrationIsolator",
+            "IfcBearing", "IfcSolarDevice",
+            "IfcBurner", "IfcEngine", "IfcCoolingTower",
+            "IfcInterceptor", "IfcLiquidTerminal",
+            "IfcConveyorSegment", "IfcVehicle",
+            "IfcMobileTelecommunicationsAppliance",
+            "IfcElectricFlowStorageDevice", "IfcElectricFlowTreatmentDevice",
+            "IfcElectricTimeControl",
+            "IfcAirToAirHeatRecovery", "IfcTubeBundle",
+            "IfcSpatialZone", "IfcExternalSpatialElement",
+            "IfcFacility", "IfcFacilityPartCommon",
+            "IfcUnknown"
+          ],
+          "description": "Full IFC class name — matches this specific IFC type."
+        },
+        { "type": "string" }
+      ]
+    },
+
+    "page": {
+      "type": "object",
+      "description": "Page dimensions and background.",
+      "markdownDescription": "Page dimensions and background.\n\n**Common sizes:**\n| Size | Landscape | Portrait |\n|------|-----------|----------|\n| A4 | 297 × 210 | 210 × 297 |\n| A3 | 420 × 297 | 297 × 420 |\n| A2 | 594 × 420 | 420 × 594 |\n| A1 | 841 × 594 | 594 × 841 |",
+      "required": ["widthMm", "heightMm"],
+      "additionalProperties": false,
+      "properties": {
+        "widthMm": {
+          "type": "number",
+          "description": "Page width in millimeters.",
+          "markdownDescription": "Page width in millimeters.\n\nCommon values: `210` (A4 portrait), `297` (A4 landscape / A3 portrait), `420` (A3 landscape), `594` (A2 landscape / A1 portrait), `841` (A1 landscape)"
+        },
+        "heightMm": {
+          "type": "number",
+          "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." },
+        "backgroundColor": { "$ref": "#/$defs/cssColor", "default": "#ffffff", "description": "Page background color." }
+      }
+    },
+
+    "styles": {
+      "type": "object",
+      "description": "Named text styles referenced by elements via textStyle. Each key is a style name.",
+      "markdownDescription": "Named text styles referenced by elements via `textStyle`.\n\nEach key becomes a reusable style name. Example:\n```json\n\"styles\": {\n  \"body\": { \"fontFamily\": \"Arial\", \"fontSizeMm\": 3.5 },\n  \"title\": { \"fontFamily\": \"Arial\", \"fontSizeMm\": 8, \"fontWeight\": \"bold\" }\n}\n```",
+      "additionalProperties": { "$ref": "#/$defs/textStyle" }
+    },
+
+    "textStyle": {
+      "type": "object",
+      "description": "Text style definition.",
+      "required": ["fontFamily", "fontSizeMm"],
+      "additionalProperties": false,
+      "properties": {
+        "fontFamily": { "type": "string", "description": "CSS font-family.", "examples": ["Arial", "Helvetica", "Times New Roman", "Courier New"] },
+        "fontSizeMm": { "type": "number", "description": "Font size in millimeters (not points or pixels)." },
+        "fontWeight": {
+          "type": "string",
+          "description": "CSS font weight.",
+          "examples": ["normal", "bold", "lighter", "100", "300", "700"]
+        },
+        "color": { "$ref": "#/$defs/cssColor", "description": "Text fill color." },
+        "letterSpacingMm": { "type": "number", "description": "Letter spacing in mm." },
+        "lineHeightMm": { "type": "number", "description": "Line height in mm." }
+      }
+    },
+
+    "asset": {
+      "type": "object",
+      "description": "A reusable asset (image, SVG) that can be referenced by image elements.",
+      "required": ["id"],
+      "additionalProperties": false,
+      "properties": {
+        "id": { "type": "string", "description": "Unique asset ID, referenced by image elements via assetId." },
+        "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`)",
+          "examples": [
+            "data:image/svg+xml;base64,PHN2Zy...",
+            "https://example.com/logo.svg"
+          ]
+        },
+        "content": { "type": "string", "description": "Inline SVG content (alternative to src)." }
+      }
+    },
+
+    "presets": {
+      "type": "object",
+      "description": "Reusable presets for class filters and scale preferences.",
+      "additionalProperties": false,
+      "properties": {
+        "includeClasses": {
+          "type": "object",
+          "description": "Named sets of IFC class names. Referenced by viewports via { \"preset\": \"presetName\" }.",
+          "markdownDescription": "Named sets of IFC class names. Referenced by viewports via `{ \"preset\": \"presetName\" }`.\n\nExample:\n```json\n\"includeClasses\": {\n  \"defaultBuilding\": [\"space\", \"walls\", \"windows\", \"doors\", \"columns\", \"stairs\", \"floor\"],\n  \"structureOnly\": [\"walls\", \"columns\", \"beam\", \"floor\"]\n}\n```",
+          "additionalProperties": {
+            "type": "array",
+            "items": { "$ref": "#/$defs/ifcClassName" },
+            "description": "Array of IFC class names to include. Names are case-insensitive."
+          }
+        },
+        "scales": {
+          "type": "object",
+          "description": "Named scale presets. Referenced by viewports via scalePreset.",
+          "markdownDescription": "Named scale presets. Referenced by viewports via `scalePreset`.\n\nValues are scale denominators: `[50, 100, 200]` means 1:50, 1:100, 1:200.\nThe renderer picks the best fit from these values.",
+          "additionalProperties": {
+            "type": "object",
+            "properties": {
+              "preferredScales": {
+                "type": "array",
+                "items": { "type": "number" },
+                "description": "Preferred scale denominators (e.g. [50, 100, 200] means 1:50, 1:100, 1:200)."
+              }
+            }
+          }
+        }
+      }
+    },
+
+    "whereCondition": {
+      "type": "object",
+      "description": "Filter BIM items by property values. Keys are short property paths. Multiple keys = AND. Array values = OR. String comparison is case-insensitive.",
+      "markdownDescription": "Filter BIM items by property values.\n\n**Keys** are short property paths like `BIP.spacetype` which resolve to `propertySets.BIP.spacetype.value`.\n\n**Rules:**\n- Multiple keys = **AND** (all must match)\n- Array values = **OR** (any value matches)\n- String comparison is **case-insensitive**\n\n**Examples:**\n```json\n{ \"BIP.spacetype\": \"ROOM\" }\n{ \"BIP.hyresobjektsnummer\": \"2022-F2008\" }\n{ \"BIP.spacetype\": [\"ROOM\", \"CORRIDOR\"] }\n```",
+      "additionalProperties": {
+        "oneOf": [
+          { "type": "string" },
+          { "type": "number" },
+          { "type": "boolean" },
+          {
+            "type": "array",
+            "items": {
+              "oneOf": [
+                { "type": "string" },
+                { "type": "number" }
+              ]
+            }
+          }
+        ]
+      },
+      "examples": [
+        { "BIP.spacetype": "ROOM" },
+        { "BIP.hyresobjektsnummer": "2022-F2008" },
+        { "BIP.spacetype": ["ROOM", "CORRIDOR"] }
+      ]
+    },
+
+    "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```",
+      "required": ["where"],
+      "additionalProperties": false,
+      "properties": {
+        "class": {
+          "oneOf": [
+            { "$ref": "#/$defs/ifcClassName" },
+            { "type": "array", "items": { "$ref": "#/$defs/ifcClassName" } }
+          ],
+          "description": "IFC class filter (e.g. \"space\"). Only items of this class are used for the clip boundary."
+        },
+        "where": { "$ref": "#/$defs/whereCondition" },
+        "expandByM": {
+          "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."
+        },
+        "clipLabels": {
+          "type": "boolean",
+          "default": false,
+          "description": "Also clip labels to the clip boundary (hide labels outside the clip)."
+        },
+        "stroke": {
+          "$ref": "#/$defs/cssColor",
+          "default": "#000000",
+          "description": "Border color around the clipped area. Set to \"none\" to hide the clip border."
+        },
+        "strokeWidthMm": {
+          "type": "number",
+          "default": 0.5,
+          "description": "Border width in mm around the clipped area."
+        },
+        "strokeOpacity": {
+          "type": "number",
+          "default": 1,
+          "minimum": 0,
+          "maximum": 1,
+          "description": "Border opacity (0 = invisible, 1 = fully opaque)."
+        },
+        "fill": {
+          "$ref": "#/$defs/cssColor",
+          "default": "none",
+          "description": "Fill color inside the clip boundary. Usually \"none\"."
+        },
+        "fillOpacity": {
+          "type": "number",
+          "default": 0,
+          "minimum": 0,
+          "maximum": 1,
+          "description": "Fill opacity (0 = transparent, 1 = fully opaque)."
+        }
+      }
+    },
+
+    "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```",
+      "required": ["where"],
+      "additionalProperties": false,
+      "properties": {
+        "class": {
+          "oneOf": [
+            { "$ref": "#/$defs/ifcClassName" },
+            { "type": "array", "items": { "$ref": "#/$defs/ifcClassName" } }
+          ],
+          "description": "IFC class filter (e.g. \"space\")."
+        },
+        "where": { "$ref": "#/$defs/whereCondition" },
+        "intersectsViewport": {
+          "type": "string",
+          "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": {
+          "$ref": "#/$defs/cssColor",
+          "default": "#ff0000",
+          "description": "Stroke color for highlighted items."
+        },
+        "strokeWidthMm": {
+          "type": "number",
+          "default": 0.5,
+          "description": "Stroke width in mm for highlighted items."
+        },
+        "strokeOpacity": {
+          "type": "number",
+          "default": 1,
+          "minimum": 0,
+          "maximum": 1,
+          "description": "Stroke opacity for highlighted items."
+        },
+        "fill": {
+          "$ref": "#/$defs/cssColor",
+          "default": "#ffff00",
+          "description": "Fill color for highlighted items."
+        },
+        "fillOpacity": {
+          "type": "number",
+          "default": 0.5,
+          "minimum": 0,
+          "maximum": 1,
+          "description": "Fill opacity for highlighted items (0.5 = semi-transparent yellow by default)."
+        }
+      }
+    },
+
+    "viewportLineStyle": {
+      "type": "object",
+      "description": "Style for a single line category.",
+      "additionalProperties": false,
+      "properties": {
+        "widthMm": { "type": "number", "description": "Line width in mm." },
+        "color": { "$ref": "#/$defs/cssColor", "description": "Line color." },
+        "dash": {
+          "type": "string",
+          "description": "SVG stroke-dasharray pattern. Empty string for solid.",
+          "markdownDescription": "SVG `stroke-dasharray` pattern.\n\n- `\"\"` — solid line\n- `\"4 2\"` — dashed (4mm dash, 2mm gap)\n- `\"2 1\"` — short dashes\n- `\"1 1\"` — dotted",
+          "examples": ["", "4 2", "2 1", "1 1"]
+        },
+        "enabled": {
+          "type": "boolean",
+          "default": true,
+          "description": "Whether this line category is rendered. Set to false to hide it completely."
+        }
+      }
+    },
+
+    "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.",
+      "additionalProperties": false,
+      "properties": {
+        "default": {
+          "$ref": "#/$defs/viewportLineStyle",
+          "description": "Fallback style for any category not explicitly listed."
+        },
+        "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." },
+        "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." },
+        "outlineHidden": { "$ref": "#/$defs/viewportLineStyle", "description": "Hidden outline edges. Typically dashed." }
+      }
+    },
+
+    "border": {
+      "type": "object",
+      "description": "Border around a viewport.",
+      "additionalProperties": false,
+      "properties": {
+        "stroke": {
+          "$ref": "#/$defs/cssColor",
+          "default": "#000000",
+          "description": "Border color. Set to \"none\" to hide."
+        },
+        "strokeWidthMm": {
+          "type": "number",
+          "default": 0.25,
+          "description": "Border width in mm."
+        },
+        "dashed": {
+          "type": "boolean",
+          "default": false,
+          "description": "Use a dashed border."
+        }
+      }
+    },
+
+    "legendColumn": {
+      "type": "object",
+      "description": "A column in the legend table.",
+      "required": ["id", "label", "property"],
+      "additionalProperties": false,
+      "properties": {
+        "id": { "type": "string", "description": "Unique column ID." },
+        "label": { "type": "string", "description": "Column header text displayed in the legend." },
+        "property": {
+          "type": "string",
+          "description": "Short property path to read from each BIM item.",
+          "markdownDescription": "Short property path to read from each BIM item.\n\n`BIP.spacename` resolves to `propertySets.BIP.spacename.value`.\n\nCommon paths: `BIP.spacename`, `BIP.area`, `BIP.hyresobjektsnummer`, `BIP.spacetype`",
+          "examples": ["BIP.spacename", "BIP.area", "BIP.hyresobjektsnummer"]
+        },
+        "format": {
+          "type": "object",
+          "description": "Number formatting options.",
+          "markdownDescription": "Number formatting options.\n\nExample: `{ \"digits\": 2, \"suffix\": \" m²\" }` → `12.50 m²`",
+          "additionalProperties": false,
+          "properties": {
+            "digits": { "type": "integer", "description": "Number of decimal places." },
+            "prefix": { "type": "string", "description": "Text prepended to the value." },
+            "suffix": { "type": "string", "description": "Text appended to the value.", "examples": [" m²", " m", " st"] }
+          }
+        },
+        "align": {
+          "type": "string",
+          "enum": ["left", "center", "right"],
+          "default": "left",
+          "description": "Text alignment within the column."
+        },
+        "minWidthMm": { "type": "number", "description": "Minimum column width in mm." },
+        "maxWidthMm": { "type": "number", "description": "Maximum column width in mm." }
+      }
+    },
+
+    "element": {
+      "defaultSnippets": [
+        {
+          "label": "viewport",
+          "description": "A viewport rendering BIM section geometry",
+          "body": {
+            "kind": "viewport",
+            "id": "${1:main}",
+            "xMm": "${2:10}",
+            "yMm": "${3:40}",
+            "widthMm": "${4:400}",
+            "heightMm": "${5:230}",
+            "includeClasses": { "preset": "${6:defaultBuilding}" },
+            "scaleMode": "fitAndRound",
+            "scalePreset": "default",
+            "align": "center",
+            "fills": [{ "class": "space", "fill": "sample", "fillOpacity": 0.35 }]
+          }
+        },
+        {
+          "label": "labels",
+          "description": "Text labels at item centroids",
+          "body": {
+            "kind": "labels",
+            "id": "${1:room-labels}",
+            "viewport": "${2:main}",
+            "class": "space",
+            "where": { "${3:BIP.spacetype}": "${4:ROOM}" },
+            "text": "{{${5:BIP.spacename}}}",
+            "textStyle": "${6:spaceLabels}",
+            "align": "center"
+          }
+        },
+        {
+          "label": "legend",
+          "description": "Table legend with room names and areas",
+          "body": {
+            "kind": "legend",
+            "id": "${1:legend}",
+            "viewport": "${2:main}",
+            "class": "space",
+            "where": { "${3:BIP.spacetype}": "${4:ROOM}" },
+            "clipToViewport": true,
+            "textStyle": "${5:body}",
+            "anchor": "top-right",
+            "anchorPositionMm": { "xMm": 415, "yMm": 40 },
+            "columns": [
+              { "id": "name", "label": "Name", "property": "BIP.spacename" },
+              { "id": "area", "label": "Area", "property": "BIP.area", "format": { "digits": 2, "suffix": " m²" }, "align": "right" }
+            ]
+          }
+        },
+        {
+          "label": "scaleBar",
+          "description": "Graphical scale bar for a viewport",
+          "body": {
+            "kind": "scaleBar",
+            "id": "${1:scale-bar}",
+            "viewport": "${2:main}",
+            "xMm": "${3:160}",
+            "yMm": "${4:285}",
+            "maxLengthMm": "${5:100}",
+            "unit": "m",
+            "segments": 10,
+            "labelEvery": 2,
+            "stroke": "#000",
+            "strokeWidthMm": 0.25,
+            "textStyle": "${6:body}"
+          }
+        },
+        {
+          "label": "text",
+          "description": "Static or template text",
+          "body": {
+            "kind": "text",
+            "id": "${1:my-text}",
+            "xMm": "${2:10}",
+            "yMm": "${3:10}",
+            "textStyle": "${4:body}",
+            "text": "${5:Hello}",
+            "align": "left"
+          }
+        },
+        {
+          "label": "image",
+          "description": "Image from an asset",
+          "body": {
+            "kind": "image",
+            "id": "${1:logo}",
+            "xMm": "${2:170}",
+            "yMm": "${3:10}",
+            "widthMm": "${4:80}",
+            "heightMm": "${5:20}",
+            "assetId": "${6:logo-main}",
+            "fit": "contain"
+          }
+        },
+        {
+          "label": "rect",
+          "description": "Rectangle (frame, box)",
+          "body": {
+            "kind": "rect",
+            "id": "${1:frame}",
+            "xMm": "${2:5}",
+            "yMm": "${3:5}",
+            "widthMm": "${4:410}",
+            "heightMm": "${5:287}",
+            "stroke": "#000",
+            "strokeWidthMm": 0.25,
+            "fill": "none"
+          }
+        },
+        {
+          "label": "line",
+          "description": "Straight line",
+          "body": {
+            "kind": "line",
+            "id": "${1:my-line}",
+            "x1Mm": "${2:10}",
+            "y1Mm": "${3:10}",
+            "x2Mm": "${4:410}",
+            "y2Mm": "${5:10}",
+            "stroke": "#000",
+            "strokeWidthMm": 0.25
+          }
+        },
+        {
+          "label": "qr",
+          "description": "QR code for navigation or anchoring",
+          "body": {
+            "kind": "qr",
+            "id": "${1:qr-main}",
+            "role": "${2:main}",
+            "xMm": "${3:5}",
+            "yMm": "${4:270}",
+            "sizeMm": "${5:25}",
+            "viewport": "${6:main}"
+          }
+        }
+      ],
+      "oneOf": [
+        { "$ref": "#/$defs/viewportElement" },
+        { "$ref": "#/$defs/textElement" },
+        { "$ref": "#/$defs/imageElement" },
+        { "$ref": "#/$defs/lineElement" },
+        { "$ref": "#/$defs/rectElement" },
+        { "$ref": "#/$defs/circleElement" },
+        { "$ref": "#/$defs/polylineElement" },
+        { "$ref": "#/$defs/polygonElement" },
+        { "$ref": "#/$defs/scaleBarElement" },
+        { "$ref": "#/$defs/qrElement" },
+        { "$ref": "#/$defs/labelsElement" },
+        { "$ref": "#/$defs/legendElement" },
+        { "$ref": "#/$defs/groupElement" }
+      ]
+    },
+
+    "viewportElement": {
+      "type": "object",
+      "description": "A viewport renders BIM section geometry at a given position and scale on the page.",
+      "required": ["kind", "id", "xMm", "yMm", "widthMm", "heightMm"],
+      "additionalProperties": false,
+      "properties": {
+        "kind": { "const": "viewport" },
+        "id": {
+          "type": "string",
+          "description": "Unique element ID. Also used to match with section data.",
+          "markdownDescription": "Unique element ID.\n\nThis ID is used to:\n- Match with section data passed to `renderDrawing`\n- Link `labels`, `legend`, `scaleBar`, and `qr` elements to this viewport"
+        },
+        "zIndex": { "type": "integer", "description": "Render order (higher = on top)." },
+        "xMm": { "type": "number", "description": "X position on page in mm." },
+        "yMm": { "type": "number", "description": "Y position on page in mm." },
+        "widthMm": { "type": "number", "description": "Viewport width in mm." },
+        "heightMm": { "type": "number", "description": "Viewport height in mm." },
+        "scaleMode": {
+          "type": "string",
+          "enum": ["fit", "fitAndRound", "fixed"],
+          "default": "fitAndRound",
+          "description": "How scale is determined.",
+          "markdownDescription": "How the drawing scale is determined.\n\n**Modes:**\n\n- **`fitAndRound`** (recommended) — Fit content, then round to nearest standard scale\n  - Result: Standard scales like 1:50, 1:100, 1:200\n  - Best for: Publication, matching standard drawing conventions\n  - Example: Content needs 1:73 → rounds to 1:100\n\n- **`fit`** — Best fit to viewport (exact)\n  - Result: Odd scales like 1:73.4, 1:127.8\n  - Best for: When content must fill viewport exactly\n  - Example: Content needs 1:73.4 → uses 1:73.4\n\n- **`fixed`** — Use exact scale specified in `fixedScaleDenom`\n  - Result: Exactly the scale you specify\n  - Best for: When scale must match other drawings\n  - Example: `fixedScaleDenom: 100` → always 1:100\n  - ⚠️ Content may be clipped if too large\n\n**Default:** `fitAndRound` with standard architectural scales"
+        },
+        "fixedScaleDenom": {
+          "type": "number",
+          "description": "Scale denominator when scaleMode is \"fixed\". E.g. 100 means 1:100.",
+          "markdownDescription": "Scale denominator when `scaleMode: \"fixed\"`.\n\n**How it works:**\n- Value `100` → scale is 1:100\n- Value `50` → scale is 1:50\n- Value `200` → scale is 1:200\n\n**Example:**\n```json\n\"scaleMode\": \"fixed\",\n\"fixedScaleDenom\": 100\n```\nAlways renders at exactly 1:100.\n\n**⚠️ Warning:** Content larger than the viewport at this scale will be clipped.",
+          "examples": [50, 100, 200, 250, 500]
+        },
+        "preferredScales": {
+          "type": "array",
+          "items": { "type": "number" },
+          "description": "Preferred scale denominators for this viewport. Overrides scalePreset.",
+          "markdownDescription": "Preferred scale denominators for this viewport (when `scaleMode: \"fitAndRound\"`).\n\n**Overrides** `scalePreset` if both are specified.\n\n**Standard architectural scales:**\n```json\n\"preferredScales\": [50, 100, 200, 250, 500, 1000]\n```\n\n**Engineering scales:**\n```json\n\"preferredScales\": [10, 20, 50, 100, 200, 500]\n```\n\n**Detail scales:**\n```json\n\"preferredScales\": [2, 5, 10, 20, 50]\n```\n\nThe renderer picks the smallest scale that fits the content.",
+          "examples": [
+            [50, 100, 200, 500],
+            [2, 5, 10, 20, 50],
+            [10, 25, 50, 100, 250]
+          ]
+        },
+        "scalePreset": {
+          "type": "string",
+          "description": "Name of a scale preset from presets.scales (when scaleMode is fitAndRound).",
+          "markdownDescription": "Name of a scale preset from `presets.scales`.\n\nUsed when `scaleMode: \"fitAndRound\"`. Allows reusing scale lists across multiple viewports.\n\n**Example:**\n```json\n\"scalePreset\": \"default\"\n```\nReferences `presets.scales.default.preferredScales`.\n\n**Define preset at top level:**\n```json\n\"presets\": {\n  \"scales\": {\n    \"default\": { \"preferredScales\": [50, 100, 200, 500] }\n  }\n}\n```",
+          "examples": ["default", "detail", "overview"]
+        },
+        "align": {
+          "type": "string",
+          "enum": ["center", "topLeft", "Left"],
+          "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"
+        },
+        "rotationDeg": {
+          "type": "number",
+          "default": 0,
+          "description": "Rotate the viewport content by this many degrees.",
+          "markdownDescription": "Rotate the viewport content by this many degrees.\n\n**Rotation is clockwise:**\n- `0` — No rotation (default)\n- `90` — 90° clockwise\n- `180` — Upside down\n- `270` — 90° counter-clockwise\n- `-90` — 90° counter-clockwise (same as 270)\n\n**Use cases:**\n- Rotate a vertical section to horizontal orientation\n- Match drawing orientation to page layout\n- Align building orientation with page direction\n\n**Example:**\n```json\n{\n  \"kind\": \"viewport\",\n  \"id\": \"section\",\n  \"rotationDeg\": 90,\n  \"...\": \"...\"\n}\n```"
+        },
+        "includeClasses": {
+          "oneOf": [
+            {
+              "type": "array",
+              "items": { "$ref": "#/$defs/ifcClassName" },
+              "description": "Array of IFC class names to include."
+            },
+            {
+              "type": "object",
+              "required": ["preset"],
+              "additionalProperties": false,
+              "properties": {
+                "preset": {
+                  "type": "string",
+                  "description": "Name of an includeClasses preset from presets.includeClasses."
+                }
+              }
+            }
+          ],
+          "description": "Which IFC classes to render in this viewport. Can be an array of class names or a preset reference.",
+          "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."
+        },
+        "fills": {
+          "type": "array",
+          "description": "Fill rules controlling which products get filled polygons. When absent, no fills are rendered.",
+          "markdownDescription": "Fill rules controlling which products get filled polygons.\n\n**Default:** No fills (when property is omitted)\n\n**Fill color options:**\n- `\"sample\"` — Use the 3D model's material color\n- `\"#80c8b4\"` — Any CSS hex color\n- `\"rgb(128, 200, 180)\"` — CSS rgb/rgba\n\n**Example — Color spaces by material:**\n```json\n\"fills\": [\n  { \"class\": \"space\", \"fill\": \"sample\", \"fillOpacity\": 0.35 }\n]\n```\n\n**Example — Different colors per space type:**\n```json\n\"fills\": [\n  { \"class\": \"space\", \"where\": { \"BIP.spacetype\": \"ROOM\" }, \"fill\": \"#80c8b4\", \"fillOpacity\": 0.35 },\n  { \"class\": \"space\", \"where\": { \"BIP.spacetype\": \"CORRIDOR\" }, \"fill\": \"#c8b480\", \"fillOpacity\": 0.35 }\n]\n```",
+          "items": {
+            "type": "object",
+            "required": ["fill"],
+            "additionalProperties": false,
+            "properties": {
+              "class": {
+                "oneOf": [
+                  { "type": "string" },
+                  { "type": "array", "items": { "type": "string" } }
+                ],
+                "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\"]`"
+              },
+              "where": {
+                "$ref": "#/$defs/whereCondition",
+                "description": "Property-based filter (same as highlight/clip where)."
+              },
+              "fill": {
+                "type": "string",
+                "description": "Fill color: CSS hex (e.g. '#80c8b4') or 'sample' to read from 3D model material.",
+                "markdownDescription": "Fill color.\n\n- `\"sample\"` — Use 3D model material color\n- `\"#80c8b4\"` — CSS hex color\n- `\"rgb(128,200,180)\"` — CSS rgb/rgba",
+                "examples": ["sample", "#80c8b4", "#ff0000", "rgba(128,200,180,0.5)"]
+              },
+              "fillOpacity": {
+                "type": "number",
+                "minimum": 0,
+                "maximum": 1,
+                "default": 0.35,
+                "description": "Fill opacity (0 = transparent, 1 = fully opaque). Default: 0.35"
+              },
+              "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`."
+              }
+            }
+          }
+        },
+        "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"],
+          "additionalProperties": false,
+          "properties": {
+            "assetId": {
+              "type": "string",
+              "description": "Asset 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,
+              "examples": [10, 15, 20]
+            },
+            "offsetXMm": {
+              "type": "number",
+              "description": "Horizontal offset from viewport's top-left corner in mm.",
+              "default": 5,
+              "examples": [5, 10]
+            },
+            "offsetYMm": {
+              "type": "number",
+              "description": "Vertical offset from viewport's top-left corner in mm.",
+              "default": 5,
+              "examples": [5, 10]
+            },
+            "rotationDeg": {
+              "type": "number",
+              "description": "Rotation of the arrow in degrees (to point toward true north).",
+              "default": 0,
+              "examples": [0, 45, 90, 180]
+            }
+          }
+        },
+        "border": { "$ref": "#/$defs/border" },
+        "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.",
+          "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",
+          "additionalProperties": false,
+          "properties": {
+            "above": {
+              "type": "number",
+              "description": "Distance above cutting plane (meters). How far upward from the plane to include geometry.",
+              "examples": [1.0, 2.0, 0.5]
+            },
+            "below": {
+              "type": "number",
+              "description": "Distance below cutting plane (meters). How far downward from the plane to include geometry.",
+              "examples": [2.0, 3.0, 1.0]
+            }
+          }
+        },
+        "planeNormal": {
+          "type": "array",
+          "description": "Plane normal vector [x, y, z]. Automatically normalized. Takes precedence over cutHeight.",
+          "markdownDescription": "Plane normal vector `[x, y, z]` defining the cutting plane orientation.\n\n**Automatically normalized** — You can use unnormalized vectors like `[1, 0, 1]`\n\n**Takes precedence over `cutHeight`** if both are specified.\n\n**Common patterns:**\n\n| Normal | Orientation | Use Case |\n|--------|------------|----------|\n| `[0, 1, 0]` | Horizontal plan | Floor plan (same as `cutHeight`) |\n| `[1, 0, 0]` | Vertical, ⊥ X-axis | Section looking along X |\n| `[0, 0, 1]` | Vertical, ⊥ Z-axis | Section looking along Z |\n| `[1, 0, 1]` | Diagonal (45°) | Angled section |\n\n**⚠️ Important:**\n- Non-horizontal normals require `mode: \"plane\"` (auto-detected)\n- Vertical sections (`[1,0,0]` or `[0,0,1]`) will NOT work correctly in SLAB mode\n\n**Example — Vertical section perpendicular to Z:**\n```json\n\"planeNormal\": [0, 0, 1],\n\"planePosition\": 30\n```\nThis creates a vertical section at Z=30 meters.",
+          "items": { "type": "number" },
+          "minItems": 3,
+          "maxItems": 3
+        },
+        "planePosition": {
+          "type": "number",
+          "description": "Distance from origin along the (normalized) plane normal. Required when using planeNormal.",
+          "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)"
+        }
+      }
+    },
+
+    "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```",
+      "required": ["kind", "id", "xMm", "yMm", "text"],
+      "additionalProperties": false,
+      "properties": {
+        "kind": { "const": "text" },
+        "id": { "type": "string", "description": "Unique element ID." },
+        "zIndex": { "type": "integer" },
+        "xMm": { "type": "number", "description": "X position on page in mm." },
+        "yMm": { "type": "number", "description": "Y position on page in mm." },
+        "textStyle": {
+          "type": "string",
+          "description": "Name of a style from the styles section.",
+          "examples": ["body", "title", "spaceLabels", "small"]
+        },
+        "text": {
+          "type": "string",
+          "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"],
+          "default": "left",
+          "description": "Text alignment."
+        }
+      }
+    },
+
+    "imageElement": {
+      "type": "object",
+      "description": "An image element placed on the page. References an asset by ID.",
+      "required": ["kind", "id", "xMm", "yMm", "widthMm", "heightMm", "assetId"],
+      "additionalProperties": false,
+      "properties": {
+        "kind": { "const": "image" },
+        "id": { "type": "string" },
+        "zIndex": { "type": "integer" },
+        "xMm": { "type": "number", "description": "X position on page in mm." },
+        "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." },
+        "fit": {
+          "type": "string",
+          "enum": ["contain", "cover", "stretch"],
+          "default": "contain",
+          "description": "How the image fits within its bounds.",
+          "markdownDescription": "How the image fits within its bounds.\n\n- **`contain`** — Scale to fit, preserving aspect ratio (may have empty space)\n- **`cover`** — Scale to fill, cropping if needed\n- **`stretch`** — Stretch to exact dimensions (may distort)"
+        }
+      }
+    },
+
+    "lineElement": {
+      "type": "object",
+      "description": "A straight line between two points on the page.",
+      "required": ["kind", "id", "x1Mm", "y1Mm", "x2Mm", "y2Mm"],
+      "additionalProperties": false,
+      "properties": {
+        "kind": { "const": "line" },
+        "id": { "type": "string" },
+        "zIndex": { "type": "integer" },
+        "x1Mm": { "type": "number", "description": "Start X in mm." },
+        "y1Mm": { "type": "number", "description": "Start Y in mm." },
+        "x2Mm": { "type": "number", "description": "End X in mm." },
+        "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." }
+      }
+    },
+
+    "rectElement": {
+      "type": "object",
+      "description": "A rectangle on the page.",
+      "required": ["kind", "id", "xMm", "yMm", "widthMm", "heightMm"],
+      "additionalProperties": false,
+      "properties": {
+        "kind": { "const": "rect" },
+        "id": { "type": "string" },
+        "zIndex": { "type": "integer" },
+        "xMm": { "type": "number", "description": "X position in mm." },
+        "yMm": { "type": "number", "description": "Y position in mm." },
+        "widthMm": { "type": "number", "description": "Width in mm." },
+        "heightMm": { "type": "number", "description": "Height in mm." },
+        "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." }
+      }
+    },
+
+    "circleElement": {
+      "type": "object",
+      "description": "A circle on the page.",
+      "required": ["kind", "id", "cxMm", "cyMm", "rMm"],
+      "additionalProperties": false,
+      "properties": {
+        "kind": { "const": "circle" },
+        "id": { "type": "string" },
+        "zIndex": { "type": "integer" },
+        "cxMm": { "type": "number", "description": "Center X in mm." },
+        "cyMm": { "type": "number", "description": "Center Y in mm." },
+        "rMm": { "type": "number", "description": "Radius in mm." },
+        "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 }
+      }
+    },
+
+    "pointMm": {
+      "type": "object",
+      "required": ["xMm", "yMm"],
+      "additionalProperties": false,
+      "properties": {
+        "xMm": { "type": "number" },
+        "yMm": { "type": "number" }
+      }
+    },
+
+    "polylineElement": {
+      "type": "object",
+      "description": "An open polyline (connected line segments).",
+      "required": ["kind", "id", "points", "stroke", "strokeWidthMm"],
+      "additionalProperties": false,
+      "properties": {
+        "kind": { "const": "polyline" },
+        "id": { "type": "string" },
+        "zIndex": { "type": "integer" },
+        "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 }
+      }
+    },
+
+    "polygonElement": {
+      "type": "object",
+      "description": "A closed polygon.",
+      "required": ["kind", "id", "points"],
+      "additionalProperties": false,
+      "properties": {
+        "kind": { "const": "polygon" },
+        "id": { "type": "string" },
+        "zIndex": { "type": "integer" },
+        "points": { "type": "array", "items": { "$ref": "#/$defs/pointMm" }, "description": "Array of points in mm." },
+        "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 }
+      }
+    },
+
+    "scaleBarElement": {
+      "type": "object",
+      "description": "A graphical scale bar showing the actual scale of a viewport.",
+      "markdownDescription": "A graphical scale bar showing the actual scale of a viewport.\n\n**Purpose:**\nProvides a visual reference for measuring distances on the drawing. The scale bar automatically adjusts based on the viewport's actual scale.\n\n**How it works:**\n1. References a viewport by ID via `viewport` property\n2. Reads the viewport's computed scale (e.g. 1:100)\n3. Generates a bar divided into `segments`\n4. Each segment represents a round number in the specified `unit`\n5. Labels appear every `labelEvery` segments\n\n**Example — 10-segment bar, labels every 2 segments:**\n```json\n{\n  \"kind\": \"scaleBar\",\n  \"id\": \"scale-bar-main\",\n  \"viewport\": \"main\",\n  \"xMm\": 160,\n  \"yMm\": 285,\n  \"maxLengthMm\": 100,\n  \"unit\": \"m\",\n  \"segments\": 10,\n  \"labelEvery\": 2,\n  \"stroke\": \"#000\",\n  \"strokeWidthMm\": 0.5,\n  \"textStyle\": \"body\"\n}\n```\n\nAt scale 1:100, this might show: `0 — 2m — 4m — 6m — 8m — 10m`\n\n**⚠️ Must reference a viewport** — The scale bar gets its scale from the referenced viewport.",
+      "required": ["kind", "id", "xMm", "yMm", "maxLengthMm"],
+      "additionalProperties": false,
+      "properties": {
+        "kind": { "const": "scaleBar" },
+        "id": { "type": "string" },
+        "zIndex": { "type": "integer" },
+        "xMm": { "type": "number", "description": "X position on page in mm." },
+        "yMm": { "type": "number", "description": "Y position on page in mm." },
+        "maxLengthMm": { "type": "number", "description": "Maximum length of the scale bar in mm." },
+        "unit": { "type": "string", "default": "m", "description": "Display unit label.", "examples": ["m", "mm", "ft"] },
+        "segments": { "type": "integer", "default": 10, "description": "Number of segments in the scale bar." },
+        "labelEvery": { "type": "integer", "default": 2, "description": "Show a numeric label every N segments." },
+        "stroke": { "$ref": "#/$defs/cssColor", "default": "#000", "description": "Scale bar line color." },
+        "strokeWidthMm": { "type": "number", "default": 0.25, "description": "Scale bar line width in mm." },
+        "textStyle": { "type": "string", "description": "Name of a style from the styles section for scale labels." },
+        "viewport": { "type": "string", "description": "ID of the viewport this scale bar measures." }
+      }
+    },
+
+    "qrElement": {
+      "type": "object",
+      "description": "A QR code element for navigation, AR spatial anchoring, or custom data.",
+      "markdownDescription": "A QR code element for various purposes.\n\n**Common uses:**\n\n1. **Navigation QR** (`role: \"main\"`)\n   - Links to Twinfinity web viewer at the drawing's location\n   - Users scan to view the 3D model at this section\n\n2. **Spatial anchor** (`role: \"anchor\"`)\n   - AR positioning reference\n   - Four QR codes (one per corner) define the page location in 3D space\n   - Enables accurate AR overlay of digital content on printed drawings\n\n3. **Custom data** (`role: \"custom\"`)\n   - Encode arbitrary data via `dataTemplate`\n   - Example: Project ID, revision number, document URL\n\n**Example — Navigation QR:**\n```json\n{\n  \"kind\": \"qr\",\n  \"id\": \"qr-main\",\n  \"role\": \"main\",\n  \"xMm\": 5,\n  \"yMm\": 270,\n  \"sizeMm\": 25,\n  \"viewport\": \"main\"\n}\n```\n\n**Example — Four anchor QRs for AR:**\n```json\n[\n  { \"kind\": \"qr\", \"role\": \"anchor\", \"anchorCorner\": \"bottom-left\", \"xMm\": 5, \"yMm\": 287, \"sizeMm\": 15 },\n  { \"kind\": \"qr\", \"role\": \"anchor\", \"anchorCorner\": \"bottom-right\", \"xMm\": 400, \"yMm\": 287, \"sizeMm\": 15 },\n  { \"kind\": \"qr\", \"role\": \"anchor\", \"anchorCorner\": \"top-left\", \"xMm\": 5, \"yMm\": 5, \"sizeMm\": 15 },\n  { \"kind\": \"qr\", \"role\": \"anchor\", \"anchorCorner\": \"top-right\", \"xMm\": 400, \"yMm\": 5, \"sizeMm\": 15 }\n]\n```",
+      "required": ["kind", "id", "xMm", "yMm", "sizeMm"],
+      "additionalProperties": false,
+      "properties": {
+        "kind": { "const": "qr" },
+        "id": { "type": "string" },
+        "zIndex": { "type": "integer" },
+        "xMm": { "type": "number", "description": "X position on page in mm." },
+        "yMm": { "type": "number", "description": "Y position on page in mm." },
+        "sizeMm": { "type": "number", "description": "QR code size (width and height) in mm." },
+        "role": {
+          "type": "string",
+          "enum": ["main", "anchor", "custom"],
+          "default": "main",
+          "description": "QR role.",
+          "markdownDescription": "QR code role.\n\n- **`main`** — Primary navigation QR code (links to Twinfinity viewer)\n- **`anchor`** — Spatial anchor for augmented reality positioning\n- **`custom`** — Custom data via `dataTemplate`"
+        },
+        "anchorCorner": {
+          "type": "string",
+          "enum": ["bottom-left", "bottom-right", "top-left", "top-right"],
+          "description": "Which page corner this anchor represents (for spatial anchoring)."
+        },
+        "viewport": { "type": "string", "description": "ID of the viewport this QR code is associated with." },
+        "dataTemplate": {
+          "type": "string",
+          "description": "Template string for custom QR data. Supports {{variable}} interpolation."
+        }
+      }
+    },
+
+    "labelsElement": {
+      "type": "object",
+      "description": "Renders text labels at the centroid of each matching BIM item inside a viewport.",
+      "markdownDescription": "Renders text labels at the centroid of each matching BIM item inside a viewport.\n\nThe `text` property supports `{{property.path}}` template variables resolved per item.\n\n**Examples:**\n```json\n\"text\": \"{{BIP.spacename}}\"\n\"text\": \"{{BIP.spacename}} ({{BIP.area}} m²)\"\n```\n\nPaths like `BIP.spacename` resolve to `propertySets.BIP.spacename.value`.",
+      "required": ["kind", "id", "viewport", "text"],
+      "additionalProperties": false,
+      "properties": {
+        "kind": { "const": "labels" },
+        "id": { "type": "string" },
+        "zIndex": { "type": "integer" },
+        "viewport": { "type": "string", "description": "ID of the viewport to place labels in." },
+        "class": {
+          "oneOf": [
+            { "$ref": "#/$defs/ifcClassName" },
+            { "type": "array", "items": { "$ref": "#/$defs/ifcClassName" } }
+          ],
+          "description": "IFC class filter. Only items of this class get labels."
+        },
+        "where": { "$ref": "#/$defs/whereCondition" },
+        "text": {
+          "type": "string",
+          "description": "Label text template. Use {{property.path}} for per-item values.",
+          "markdownDescription": "Label text template. Use `{{property.path}}` for per-item values.\n\nPaths like `BIP.spacename` resolve to `propertySets.BIP.spacename.value`.\n\nMultiple variables work: `{{BIP.spacename}} - {{BIP.area}} m²`",
+          "examples": [
+            "{{BIP.spacename}}",
+            "{{BIP.spacename}} ({{BIP.area}} m²)",
+            "{{BIP.spacenumber}}"
+          ]
+        },
+        "textStyle": {
+          "type": "string",
+          "description": "Name of a style from the styles section.",
+          "examples": ["spaceLabels"]
+        },
+        "align": {
+          "type": "string",
+          "enum": ["left", "center", "right"],
+          "default": "center",
+          "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."
+        }
+      }
+    },
+
+    "legendElement": {
+      "type": "object",
+      "description": "A table legend showing BIM item properties (room names, areas, etc.) with optional color swatches.",
+      "markdownDescription": "A table legend showing BIM item properties with optional color swatches.\n\nThe legend is anchored to a page position and auto-sizes based on content.\n\n**Example:**\n```json\n{\n  \"kind\": \"legend\",\n  \"id\": \"legend\",\n  \"viewport\": \"main\",\n  \"class\": \"space\",\n  \"where\": { \"BIP.spacetype\": \"ROOM\" },\n  \"clipToViewport\": true,\n  \"columns\": [\n    { \"id\": \"name\", \"label\": \"Rum\", \"property\": \"BIP.spacename\" },\n    { \"id\": \"area\", \"label\": \"Area\", \"property\": \"BIP.area\", \"format\": { \"digits\": 2, \"suffix\": \" m²\" } }\n  ]\n}\n```",
+      "required": ["kind", "id", "viewport", "columns"],
+      "additionalProperties": false,
+      "properties": {
+        "kind": { "const": "legend" },
+        "id": { "type": "string" },
+        "zIndex": { "type": "integer" },
+        "viewport": { "type": "string", "description": "ID of the viewport whose items populate the legend." },
+        "class": {
+          "oneOf": [
+            { "$ref": "#/$defs/ifcClassName" },
+            { "type": "array", "items": { "$ref": "#/$defs/ifcClassName" } }
+          ],
+          "description": "IFC class filter. Only items of this class appear in the legend."
+        },
+        "where": { "$ref": "#/$defs/whereCondition" },
+        "clipToViewport": {
+          "type": "boolean",
+          "default": false,
+          "description": "Only show items that are inside the viewport's clip boundary."
+        },
+        "anchor": {
+          "type": "string",
+          "enum": ["top-right", "top-left", "bottom-right", "bottom-left"],
+          "default": "top-right",
+          "description": "Which corner of the legend is anchored to anchorPositionMm."
+        },
+        "anchorPositionMm": {
+          "type": "object",
+          "description": "Position of the anchor corner on the page.",
+          "required": ["xMm", "yMm"],
+          "additionalProperties": false,
+          "properties": {
+            "xMm": { "type": "number" },
+            "yMm": { "type": "number" }
+          }
+        },
+        "marginMm": {
+          "type": "number",
+          "default": 5,
+          "description": "Margin around the legend table in mm."
+        },
+        "textStyle": {
+          "type": "string",
+          "description": "Name of a style from the styles section for legend text.",
+          "examples": ["body"]
+        },
+        "showColorColumn": {
+          "type": "boolean",
+          "default": true,
+          "description": "Show a color swatch column on the left side of the legend."
+        },
+        "colorColumnWidthMm": {
+          "type": "number",
+          "default": 8,
+          "description": "Width of the color swatch column in mm."
+        },
+        "cellPaddingMm": {
+          "type": "number",
+          "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."
+        },
+        "headerStrokeWidthMm": {
+          "type": "number",
+          "default": 0.65,
+          "description": "Stroke width under the header row in mm (thicker for visual emphasis)."
+        },
+        "headerStrokeColor": {
+          "$ref": "#/$defs/cssColor",
+          "default": "#000000",
+          "description": "Color of the stroke under the header row."
+        },
+        "columns": {
+          "type": "array",
+          "description": "Column definitions for the legend table.",
+          "items": { "$ref": "#/$defs/legendColumn" },
+          "minItems": 1
+        }
+      }
+    },
+
+    "groupElement": {
+      "type": "object",
+      "description": "A container grouping child elements with optional transforms, opacity, and clipping.",
+      "markdownDescription": "A container grouping child elements with optional transforms, opacity, and clipping.\n\n**Use cases:**\n- Apply transforms to multiple elements at once\n- Set opacity for a group of elements\n- Clip multiple elements to a rectangular region\n- Organize related elements (e.g., title block components)\n\n**Features:**\n- **Transform** — Translate, rotate, or scale all children\n- **Opacity** — Fade entire group (0 = invisible, 1 = opaque)\n- **Clip** — Rectangular clipping region\n- **Z-index** — Control render order\n\n**Example — Title block group:**\n```json\n{\n  \"kind\": \"group\",\n  \"id\": \"title-block\",\n  \"transform\": {\n    \"translateXMm\": 300,\n    \"translateYMm\": 260\n  },\n  \"children\": [\n    { \"kind\": \"rect\", \"xMm\": 0, \"yMm\": 0, \"widthMm\": 115, \"heightMm\": 30, \"stroke\": \"#000\", \"strokeWidthMm\": 0.5 },\n    { \"kind\": \"text\", \"xMm\": 5, \"yMm\": 10, \"text\": \"Project Name\", \"textStyle\": \"body\" },\n    { \"kind\": \"text\", \"xMm\": 5, \"yMm\": 20, \"text\": \"Drawing Number: A-101\", \"textStyle\": \"body\" }\n  ]\n}\n```\n\n**Example — Semi-transparent watermark:**\n```json\n{\n  \"kind\": \"group\",\n  \"id\": \"watermark\",\n  \"opacity\": 0.15,\n  \"children\": [\n    { \"kind\": \"text\", \"xMm\": 150, \"yMm\": 120, \"text\": \"DRAFT\", \"textStyle\": \"watermark\" }\n  ]\n}\n```",
+      "required": ["kind", "id", "children"],
+      "additionalProperties": false,
+      "properties": {
+        "kind": { "const": "group" },
+        "id": { "type": "string" },
+        "zIndex": { "type": "integer" },
+        "opacity": {
+          "type": "number",
+          "minimum": 0,
+          "maximum": 1,
+          "description": "Group opacity (0 = invisible, 1 = fully opaque)."
+        },
+        "transform": {
+          "type": "object",
+          "description": "Transform applied to the group.",
+          "additionalProperties": false,
+          "properties": {
+            "translateXMm": { "type": "number", "description": "Horizontal translation in mm." },
+            "translateYMm": { "type": "number", "description": "Vertical translation in mm." },
+            "rotateDeg": { "type": "number", "description": "Rotation in degrees." },
+            "scaleX": { "type": "number", "description": "Horizontal scale factor." },
+            "scaleY": { "type": "number", "description": "Vertical scale factor." }
+          }
+        },
+        "clip": {
+          "type": "object",
+          "description": "Rectangular clip region for the group.",
+          "required": ["type", "xMm", "yMm", "widthMm", "heightMm"],
+          "additionalProperties": false,
+          "properties": {
+            "type": { "const": "rect" },
+            "xMm": { "type": "number" },
+            "yMm": { "type": "number" },
+            "widthMm": { "type": "number" },
+            "heightMm": { "type": "number" }
+          }
+        },
+        "children": {
+          "type": "array",
+          "description": "Child elements within this group.",
+          "items": { "$ref": "#/$defs/element" }
+        }
+      }
+    }
+  }
+}