@twinfinity/printing 5.0.3-ci.28538-beta

package/dist/layout/filters.js

@@ -0,0 +1,77 @@
+import { resolveProperty } from './renderUtils';
+import { isRecord, getProp } from './typeGuards';
+const normalizeClass = (cls) => (typeof cls === 'string' ? cls.trim().toLowerCase() : null);
+/** Compare two class strings, treating the 'Ifc' prefix as optional.
+ *  e.g. "IfcSpace" matches "Space", "space", and "IfcSpace". */
+const classEquals = (a, b) => {
+    if (a === null || b === null)
+        return false;
+    if (a === b)
+        return true;
+    // Try with/without Ifc prefix in both directions
+    const stripIfc = (s) => (s.startsWith('ifc') ? s.slice(3) : s);
+    return stripIfc(a) === stripIfc(b);
+};
+const normalizeValue = (v) => (typeof v === 'string' ? v.toLowerCase().trim() : v);
+/**
+ * Check whether an item's ifcClass matches the given class filter.
+ *
+ * Uses normalizeClass() for string comparison — works for extracted items
+ * where we have a normalized ifcClass string (not a live product).
+ *
+ * For live products, the caller should use product.class.is() directly.
+ */
+const matchesClass = (itemClass, classFilter) => {
+    if (classFilter === undefined)
+        return true;
+    const classes = Array.isArray(classFilter) ? classFilter : [classFilter];
+    const normalized = normalizeClass(itemClass);
+    if (normalized === null)
+        return false;
+    return classes.some((c) => classEquals(normalizeClass(c), normalized));
+};
+/**
+ * Check whether an item matches a `where` condition.
+ *
+ * Each key in `where` is a short property path (e.g. "BIP.spacetype").
+ * Each value is either a scalar (equality check) or an array (any-of check).
+ * Multiple keys = AND. String comparison is case-insensitive.
+ */
+const matchesWhere = (item, where) => {
+    if (!where)
+        return true;
+    for (const [path, expected] of Object.entries(where)) {
+        const value = resolveProperty(item, path);
+        if (Array.isArray(expected)) {
+            const target = normalizeValue(value);
+            if (!expected.some((v) => normalizeValue(v) === target))
+                return false;
+        }
+        else {
+            if (normalizeValue(value) !== normalizeValue(expected))
+                return false;
+        }
+    }
+    return true;
+};
+/**
+ * V2 filter: match items by class + where conditions.
+ *
+ * @param item - An object with ifcClass and propertySets
+ * @param classFilter - IFC class name(s) to match, or undefined for any
+ * @param where - Property conditions (short paths), or undefined for no conditions
+ */
+export const matchesV2Filter = (item, classFilter, where) => {
+    if (classFilter !== undefined && isRecord(item)) {
+        const itemClass = getProp(item, 'ifcClass');
+        const itemClassId = getProp(item, 'ifcClassId');
+        if (!matchesClass(itemClass, classFilter) && !matchesClass(itemClassId, classFilter)) {
+            return false;
+        }
+    }
+    if (!matchesWhere(item, where))
+        return false;
+    return true;
+};
+export { normalizeClass, classEquals, normalizeValue, matchesClass, matchesWhere };
+//# sourceMappingURL=filters.js.map

package/dist/layout/filters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"filters.js","sourceRoot":"/","sources":["layout/filters.ts"],"names":[],"mappings":"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","sourcesContent":["import { resolveProperty } from './renderUtils';\r\n\r\nimport { isRecord, getProp } from './typeGuards';\r\n\r\nimport type { WhereCondition } from './types';\r\n\r\nconst normalizeClass = (cls: unknown): string | null => (typeof cls === 'string' ? cls.trim().toLowerCase() : null);\r\n\r\n/** Compare two class strings, treating the 'Ifc' prefix as optional.\r\n *  e.g. \"IfcSpace\" matches \"Space\", \"space\", and \"IfcSpace\". */\r\nconst classEquals = (a: string | null, b: string | null): boolean => {\r\n    if (a === null || b === null) return false;\r\n    if (a === b) return true;\r\n    // Try with/without Ifc prefix in both directions\r\n    const stripIfc = (s: string): string => (s.startsWith('ifc') ? s.slice(3) : s);\r\n    return stripIfc(a) === stripIfc(b);\r\n};\r\nconst normalizeValue = (v: unknown): unknown => (typeof v === 'string' ? v.toLowerCase().trim() : v);\r\n\r\n/**\r\n * Check whether an item's ifcClass matches the given class filter.\r\n *\r\n * Uses normalizeClass() for string comparison — works for extracted items\r\n * where we have a normalized ifcClass string (not a live product).\r\n *\r\n * For live products, the caller should use product.class.is() directly.\r\n */\r\nconst matchesClass = (itemClass: unknown, classFilter: string | string[] | undefined): boolean => {\r\n    if (classFilter === undefined) return true;\r\n    const classes = Array.isArray(classFilter) ? classFilter : [classFilter];\r\n    const normalized = normalizeClass(itemClass);\r\n    if (normalized === null) return false;\r\n    return classes.some((c) => classEquals(normalizeClass(c), normalized));\r\n};\r\n\r\n/**\r\n * Check whether an item matches a `where` condition.\r\n *\r\n * Each key in `where` is a short property path (e.g. \"BIP.spacetype\").\r\n * Each value is either a scalar (equality check) or an array (any-of check).\r\n * Multiple keys = AND. String comparison is case-insensitive.\r\n */\r\nconst matchesWhere = (item: unknown, where: WhereCondition | undefined): boolean => {\r\n    if (!where) return true;\r\n    for (const [path, expected] of Object.entries(where)) {\r\n        const value = resolveProperty(item, path);\r\n        if (Array.isArray(expected)) {\r\n            const target = normalizeValue(value);\r\n            if (!expected.some((v) => normalizeValue(v) === target)) return false;\r\n        } else {\r\n            if (normalizeValue(value) !== normalizeValue(expected)) return false;\r\n        }\r\n    }\r\n    return true;\r\n};\r\n\r\n/**\r\n * V2 filter: match items by class + where conditions.\r\n *\r\n * @param item - An object with ifcClass and propertySets\r\n * @param classFilter - IFC class name(s) to match, or undefined for any\r\n * @param where - Property conditions (short paths), or undefined for no conditions\r\n */\r\nexport const matchesV2Filter = (\r\n    item: unknown,\r\n    classFilter: string | string[] | undefined,\r\n    where: WhereCondition | undefined\r\n): boolean => {\r\n    if (classFilter !== undefined && isRecord(item)) {\r\n        const itemClass = getProp(item, 'ifcClass');\r\n        const itemClassId = getProp(item, 'ifcClassId');\r\n        if (!matchesClass(itemClass, classFilter) && !matchesClass(itemClassId, classFilter)) {\r\n            return false;\r\n        }\r\n    }\r\n    if (!matchesWhere(item, where)) return false;\r\n    return true;\r\n};\r\n\r\nexport { normalizeClass, classEquals, normalizeValue, matchesClass, matchesWhere };\r\n"]}

package/dist/layout/geometryConstants.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Geometric computation constants
+ */
+export declare const EPSILON_INTERSECTION = 1e-9;
+export declare const EPSILON_DIVISION_SAFETY = 1e-9;
+export declare const EPSILON_MIN_DIMENSION = 0.000001;
+export declare const CENTER_FRACTION = 0.5;
+//# sourceMappingURL=geometryConstants.d.ts.map

package/dist/layout/geometryConstants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"geometryConstants.d.ts","sourceRoot":"/","sources":["layout/geometryConstants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,eAAO,MAAM,oBAAoB,OAAO,CAAC;AACzC,eAAO,MAAM,uBAAuB,OAAO,CAAC;AAC5C,eAAO,MAAM,qBAAqB,WAAO,CAAC;AAG1C,eAAO,MAAM,eAAe,MAAM,CAAC"}

package/dist/layout/geometryConstants.js

@@ -0,0 +1,10 @@
+/**
+ * Geometric computation constants
+ */
+// Epsilon values for floating-point comparisons
+export const EPSILON_INTERSECTION = 1e-9; // Used for detecting parallel lines
+export const EPSILON_DIVISION_SAFETY = 1e-9; // Used to prevent division by zero
+export const EPSILON_MIN_DIMENSION = 1e-6; // Minimum valid dimension for model bounds
+// Geometric multipliers
+export const CENTER_FRACTION = 0.5; // For calculating center/midpoint (x * 0.5)
+//# sourceMappingURL=geometryConstants.js.map

package/dist/layout/geometryConstants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"geometryConstants.js","sourceRoot":"/","sources":["layout/geometryConstants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,gDAAgD;AAChD,MAAM,CAAC,MAAM,oBAAoB,GAAG,IAAI,CAAC,CAAC,oCAAoC;AAC9E,MAAM,CAAC,MAAM,uBAAuB,GAAG,IAAI,CAAC,CAAC,mCAAmC;AAChF,MAAM,CAAC,MAAM,qBAAqB,GAAG,IAAI,CAAC,CAAC,2CAA2C;AAEtF,wBAAwB;AACxB,MAAM,CAAC,MAAM,eAAe,GAAG,GAAG,CAAC,CAAC,4CAA4C","sourcesContent":["/**\r\n * Geometric computation constants\r\n */\r\n\r\n// Epsilon values for floating-point comparisons\r\nexport const EPSILON_INTERSECTION = 1e-9; // Used for detecting parallel lines\r\nexport const EPSILON_DIVISION_SAFETY = 1e-9; // Used to prevent division by zero\r\nexport const EPSILON_MIN_DIMENSION = 1e-6; // Minimum valid dimension for model bounds\r\n\r\n// Geometric multipliers\r\nexport const CENTER_FRACTION = 0.5; // For calculating center/midpoint (x * 0.5)\r\n"]}

package/dist/layout/index.d.ts

@@ -0,0 +1,86 @@
+import type { SectionRenderState } from '@twinfinity/geometry';
+import { pointInPolygon, filterItemsInPolygons, filterEntriesByClip, offsetPolygons, projectPolygonsToLocal } from './clipUtils';
+import { RenderLayoutOptions } from './options';
+import { LayoutTemplate, ModelContext, LayoutData, ValidationIssue, ComputedViewportScale } from './types';
+export type LayoutDataValidationResult = {
+    ok: true;
+} | {
+    ok: false;
+    errors: string[];
+};
+export type PreflightResult = {
+    ok: true;
+} | {
+    ok: false;
+    templateErrors?: ValidationIssue[];
+    dataErrors?: string[];
+    sectionErrors?: string[];
+};
+/**
+ * Validate template, layout data, and section state in a single call.
+ * Combines `validateLayoutTemplate`, `validateLayoutData`, and `validateSectionState`.
+ */
+export declare const preflight: (template: LayoutTemplate, data: unknown, expectedViewportIds: string[], sectionState?: SectionRenderState) => PreflightResult;
+/**
+ * Validate layout data before rendering to catch missing propertySets or items arrays.
+ */
+export declare const validateLayoutData: (data: unknown, expectedViewportIds: string[]) => LayoutDataValidationResult;
+export type { PageSpec, TextStyle, StyleMap, AssetSpec, LayoutElement, BaseElement, ViewportElement, TextElement, ImageElement, LineElement, RectElement, CircleElement, PolylineElement, PolygonElement, PointMm, ScaleBarElement, QrElement, LabelsElement, LegendElement, GroupElement, LayoutTemplate, LegendAnchor, LegendColumn, SvgModelView, ModelContext, LayoutData, LayoutDataViewports, ViewportItemsMap, PagePresetKey, PageOrientation, ValidationOptions, ValidationIssue, ValidationResult, ComputedViewportScale, NormalizedProductItem, SectionStateValidationResult, LabelStyle, WhereCondition, ClipConfig, HighlightConfig, ViewportLineStyle, ViewportLineStyles, SectionResult, FillRule, RenderDrawingInput, RenderDrawingResult, IncludeClassesFilter, ResolvedIncludeFilter, TemplateVariableDef, TemplateVariableInfo } from './types';
+export type { RenderLayoutOptions } from './options';
+export { pointInPolygon, filterItemsInPolygons, filterEntriesByClip, offsetPolygons, projectPolygonsToLocal };
+/** Normalize IFC class names to lowercase for consistent matching. */
+export { normalizeClass } from './filters';
+/** Test whether an item matches a class + where filter (used by clip, highlight, labels, legend). */
+export { matchesV2Filter } from './filters';
+/** Metadata utilities: build lookup maps, resolve IFC class includes, and merge metadata sources. */
+export { buildMetadataMap, normalizePropertySets, resolveIfcClassName, resolveIfcClassId, resolveIncludeClasses, resolveAllowedClasses, resolveMeta } from './metadata';
+/** Validate a layout template JSON structure. Returns `{ ok, errors }` or `{ ok, template }`. */
+export { validateLayoutTemplate as validateLayoutTemplateExternal } from './validation';
+/** Layout utility functions: scale denominators, label sizing, color parsing, and line style application. */
+export { uniquePositiveDenoms, computeLabelFontSize, colorFromString, applyLineStyleToPaths } from './utils';
+/** Property resolution: traverse nested objects with dot-path strings like `"BIP.spacename"`. */
+export { getPathValue, resolveProperty, resolvePath, matchesPropertyFilter } from './renderUtils';
+/** Build legend table rows from product items with property formatting. */
+export { buildLegendRows, type LegendRow, type LegendRowOptions } from './legendRows';
+/** Product normalization, viewport item builders, and section-state-to-SVG-model conversion. */
+export type { ProductLike, BuildViewportItemsOptions } from './itemBuilders';
+export { normalizeProductEntry, buildViewportItems, sectionStateToModelView } from './itemBuilders';
+/**
+ * High-level facade: renders a complete drawing from a template + section geometry.
+ * Internalizes all data wiring (items, colors, labels, metadata) that `renderLayout` requires manually.
+ */
+export { renderDrawing, resolveFillColor, BUILTIN_LINE_DEFAULTS, BUILTIN_HIDDEN_DEFAULTS, BUILTIN_LABEL_DEFAULTS, CATEGORY_BUILTIN_OVERRIDES, setRenderLayoutBinding } from './renderDrawing';
+export type { ResolvedLineStyles } from './renderDrawing';
+export { EXAMPLE_BUILDING_CLASSES } from './presets';
+export { analyzeTemplate } from './analyzeTemplate';
+export type { TemplateRequirements } from './analyzeTemplate';
+/** Drawing export utilities: convert SVG markup to PDF or SVG files. */
+export { exportToPdf, exportToSvg } from './exportDrawing';
+export type { ExportPdfOptions, ExportSvgOptions } from './exportDrawing';
+/** Template variable utilities: extract, validate, and resolve template parameters. */
+export { getTemplateVariables, getTemplateDefaults, resolveTemplateValues, applyTemplateVariables } from './templateVariables';
+/** Result of {@link renderLayout}: the final SVG markup, per-viewport scale info, and any warnings. */
+export interface RenderLayoutResult {
+    /** Complete SVG markup string ready for embedding or PDF conversion. */
+    svg: string;
+    /** Per-viewport computed scale information (denominator, mm-per-model-unit, fit status). */
+    viewportScales: Record<string, ComputedViewportScale>;
+    /** Non-fatal issues encountered during rendering (missing assets, unresolved styles, etc.). */
+    warnings: string[];
+}
+/** Built-in default layout template (A3 landscape with a single viewport). */
+export declare const DEFAULT_LAYOUT_TEMPLATE: LayoutTemplate;
+/**
+ * Render a layout template to SVG.
+ *
+ * This is the low-level rendering function. For most use cases, prefer {@link renderDrawing}
+ * which handles all data wiring automatically.
+ *
+ * @param template - Validated layout template (page, elements, styles, presets).
+ * @param data - Layout data with viewport items, template variables, and legend rows.
+ * @param models - Per-viewport SVG model views (geometry + transforms).
+ * @param options - Optional rendering settings (remote assets, scale overrides, metadata).
+ * @returns SVG markup string, computed viewport scales, and any warnings.
+ */
+export declare function renderLayout(template: LayoutTemplate, data: LayoutData, models: ModelContext, options?: RenderLayoutOptions): Promise<RenderLayoutResult>;
+//# sourceMappingURL=index.d.ts.map

package/dist/layout/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"/","sources":["layout/index.ts"],"names":[],"mappings":"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"}

package/dist/layout/index.js

@@ -0,0 +1,363 @@
+import defaultTemplateJson from '../templates/default-template.json';
+import { pointInPolygon, filterItemsInPolygons, filterEntriesByClip, offsetPolygons, projectPolygonsToLocal } from './clipUtils';
+import { uniquePositiveDenoms } from './utils';
+import { validateLayoutTemplate as validateLayoutTemplateExternal } from './validation';
+import { renderViewportElement } from './viewportRender';
+import { prepareViewports } from './viewportPrep';
+import { renderLabels } from './labelsRender';
+import { renderQrElements } from './qrRender';
+import { applyLegendFilter, buildLegendGroup } from './legendRender';
+import { resolvePresets } from './presets';
+import { pushWarning } from './warnings';
+import { escapeAttr, escapeText, interpolate, getPathValue } from './renderUtils';
+import { validateSectionState } from './sectionValidation';
+import { ELEMENT_KIND_VIEWPORT, ELEMENT_KIND_TEXT, ELEMENT_KIND_IMAGE, ELEMENT_KIND_LINE, ELEMENT_KIND_RECT, ELEMENT_KIND_CIRCLE, ELEMENT_KIND_POLYLINE, ELEMENT_KIND_POLYGON, ELEMENT_KIND_SCALE_BAR, ELEMENT_KIND_QR, ELEMENT_KIND_LABELS, ELEMENT_KIND_LEGEND, ELEMENT_KIND_GROUP } from './elementKinds';
+import { isRecord, getProp } from './typeGuards';
+/**
+ * Validate template, layout data, and section state in a single call.
+ * Combines `validateLayoutTemplate`, `validateLayoutData`, and `validateSectionState`.
+ */
+export const preflight = (template, data, expectedViewportIds, sectionState) => {
+    const templateValidation = validateLayoutTemplate(template);
+    const dataValidation = validateLayoutData(data, expectedViewportIds);
+    const sectionValidation = sectionState ? validateSectionState(sectionState) : { ok: true };
+    const ok = templateValidation.ok && dataValidation.ok && sectionValidation.ok;
+    if (ok)
+        return { ok: true };
+    return {
+        ok: false,
+        templateErrors: templateValidation.ok ? undefined : templateValidation.errors,
+        dataErrors: dataValidation.ok ? undefined : dataValidation.errors,
+        sectionErrors: sectionValidation.ok ? undefined : sectionValidation.errors
+    };
+};
+/**
+ * Validate layout data before rendering to catch missing propertySets or items arrays.
+ */
+export const validateLayoutData = (data, expectedViewportIds) => {
+    const errors = [];
+    if (!isRecord(data)) {
+        return { ok: false, errors: ['layout data must be an object'] };
+    }
+    expectedViewportIds.forEach((vpId) => {
+        const viewports = getProp(data, 'viewports');
+        const viewport = isRecord(viewports) ? getProp(viewports, vpId) : undefined;
+        const items = getProp(viewport, 'items');
+        if (!Array.isArray(items)) {
+            errors.push(`viewports.${vpId}.items is required and must be an array.`);
+            return;
+        }
+        items.forEach((it, idx) => {
+            if (!isRecord(it)) {
+                errors.push(`viewports.${vpId}.items[${idx}] must be an object.`);
+                return;
+            }
+            const sets = getProp(it, 'propertySets');
+            if (!isRecord(sets)) {
+                errors.push(`viewports.${vpId}.items[${idx}] is missing propertySets.<Set>.<Prop>.value.`);
+                return;
+            }
+            Object.entries(sets).forEach(([setName, props]) => {
+                if (!isRecord(props)) {
+                    errors.push(`viewports.${vpId}.items[${idx}].propertySets.${setName} must be an object.`);
+                    return;
+                }
+                Object.entries(props).forEach(([propName, payload]) => {
+                    if (!isRecord(payload) || !('value' in payload)) {
+                        errors.push(`viewports.${vpId}.items[${idx}].propertySets.${setName}.${propName} must include a value (propertySets.<Set>.<Prop>.value).`);
+                    }
+                });
+            });
+        });
+    });
+    return errors.length ? { ok: false, errors } : { ok: true };
+};
+const validateLayoutTemplate = validateLayoutTemplateExternal;
+export { pointInPolygon, filterItemsInPolygons, filterEntriesByClip, offsetPolygons, projectPolygonsToLocal };
+/** Normalize IFC class names to lowercase for consistent matching. */
+export { normalizeClass } from './filters';
+/** Test whether an item matches a class + where filter (used by clip, highlight, labels, legend). */
+export { matchesV2Filter } from './filters';
+/** Metadata utilities: build lookup maps, resolve IFC class includes, and merge metadata sources. */
+export { buildMetadataMap, normalizePropertySets, resolveIfcClassName, resolveIfcClassId, resolveIncludeClasses, resolveAllowedClasses, resolveMeta } from './metadata';
+/** Validate a layout template JSON structure. Returns `{ ok, errors }` or `{ ok, template }`. */
+export { validateLayoutTemplate as validateLayoutTemplateExternal } from './validation';
+/** Layout utility functions: scale denominators, label sizing, color parsing, and line style application. */
+export { uniquePositiveDenoms, computeLabelFontSize, colorFromString, applyLineStyleToPaths } from './utils';
+/** Property resolution: traverse nested objects with dot-path strings like `"BIP.spacename"`. */
+export { getPathValue, resolveProperty, resolvePath, matchesPropertyFilter } from './renderUtils';
+const SVG_NS = 'http://www.w3.org/2000/svg';
+/** Build legend table rows from product items with property formatting. */
+export { buildLegendRows } from './legendRows';
+export { normalizeProductEntry, buildViewportItems, sectionStateToModelView } from './itemBuilders';
+/**
+ * High-level facade: renders a complete drawing from a template + section geometry.
+ * Internalizes all data wiring (items, colors, labels, metadata) that `renderLayout` requires manually.
+ */
+export { renderDrawing, resolveFillColor, BUILTIN_LINE_DEFAULTS, BUILTIN_HIDDEN_DEFAULTS, BUILTIN_LABEL_DEFAULTS, CATEGORY_BUILTIN_OVERRIDES, setRenderLayoutBinding } from './renderDrawing';
+export { EXAMPLE_BUILDING_CLASSES } from './presets';
+export { analyzeTemplate } from './analyzeTemplate';
+/** Drawing export utilities: convert SVG markup to PDF or SVG files. */
+export { exportToPdf, exportToSvg } from './exportDrawing';
+/** Template variable utilities: extract, validate, and resolve template parameters. */
+export { getTemplateVariables, getTemplateDefaults, resolveTemplateValues, applyTemplateVariables } from './templateVariables';
+/** Built-in default layout template (A3 landscape with a single viewport). */
+export const DEFAULT_LAYOUT_TEMPLATE = defaultTemplateJson;
+const dashArray = (dashed) => (dashed ? ' stroke-dasharray="4 2"' : '');
+const formatNumber = (value) => {
+    if (!Number.isFinite(value))
+        return 0;
+    return Number.parseFloat(value.toFixed(3));
+};
+/**
+ * Render a layout template to SVG.
+ *
+ * This is the low-level rendering function. For most use cases, prefer {@link renderDrawing}
+ * which handles all data wiring automatically.
+ *
+ * @param template - Validated layout template (page, elements, styles, presets).
+ * @param data - Layout data with viewport items, template variables, and legend rows.
+ * @param models - Per-viewport SVG model views (geometry + transforms).
+ * @param options - Optional rendering settings (remote assets, scale overrides, metadata).
+ * @returns SVG markup string, computed viewport scales, and any warnings.
+ */
+export async function renderLayout(template, data, models, options) {
+    const presets = resolvePresets(template?.presets);
+    const validation = validateLayoutTemplate(template, {
+        allowRemoteAssets: options?.allowRemoteAssets,
+        allowDataUrls: options?.allowDataUrls,
+        maxViewports: options?.maxViewports
+    });
+    if (!validation.ok) {
+        throw new Error(`Template validation failed: ${validation.errors.map((e) => `${e.path}: ${e.message}`).join('; ')}`);
+    }
+    const preferredScales = uniquePositiveDenoms(options?.scaleDenominators);
+    const page = template.page;
+    const warnings = [];
+    // Flatten all elements to collect viewports, qrs, labels, legends regardless of grouping
+    const allElements = [];
+    const collectElements = (elements) => {
+        elements.forEach((el) => {
+            allElements.push(el);
+            if (el.kind === ELEMENT_KIND_GROUP) {
+                collectElements(el.children);
+            }
+        });
+    };
+    collectElements(template.elements);
+    const viewports = allElements.filter((el) => el.kind === ELEMENT_KIND_VIEWPORT);
+    const dataValidation = validateLayoutData(data, viewports.map((v) => v.id));
+    if (!dataValidation.ok) {
+        throw new Error(`Layout data validation failed: ${dataValidation.errors.join('; ')}`);
+    }
+    const { viewportScales, viewportClipPolygonsLocal, viewportClipPolygonsWorld, viewportClipBounds, viewportClipLabels, viewportClipStyles, 
+    // viewportClipWhere intentionally omitted — not needed for rendering
+    viewportHighlight, filteredModelsByViewport } = prepareViewports(viewports, models, data, preferredScales, presets, {
+        metadataById: options?.metadataById,
+        warnings
+    });
+    const viewportData = {};
+    Object.entries(viewportScales).forEach(([id, scale]) => {
+        viewportData[id] = {
+            scaleDenom: scale.denom,
+            scaleText: `1:${scale.denom}`,
+            mmPerModelUnit: scale.mmPerModelUnit,
+            fits: scale.fits
+        };
+    });
+    const dataWithViewport = { ...data, viewport: viewportData };
+    const sorted = [...template.elements].sort((a, b) => (a.zIndex ?? 0) - (b.zIndex ?? 0));
+    const parts = [];
+    parts.push(`<svg xmlns="${SVG_NS}" width="${page.widthMm}mm" height="${page.heightMm}mm" viewBox="0 0 ${page.widthMm} ${page.heightMm}">`);
+    if (page.backgroundColor) {
+        parts.push(`<rect x="0" y="0" width="${page.widthMm}" height="${page.heightMm}" fill="${escapeAttr(page.backgroundColor)}"/>`);
+    }
+    const assetMap = new Map();
+    (template.assets ?? []).forEach((asset) => assetMap.set(asset.id, asset));
+    const qrElements = allElements.filter((el) => el.kind === ELEMENT_KIND_QR);
+    const labelElements = allElements.filter((el) => el.kind === ELEMENT_KIND_LABELS);
+    const viewportRenderInfo = {};
+    // Pre-process legends to collect color maps (needed before viewport rendering)
+    const legendColorMaps = new Map(); // viewport ID -> color map
+    const legendElements = allElements.filter((el) => el.kind === ELEMENT_KIND_LEGEND);
+    legendElements.forEach((legend) => {
+        if (legend.assignColors?.enabled && legend.groupBy) {
+            const legendItems = getPathValue(data, `viewports.${legend.viewport}.items`);
+            const rawLegendItems = Array.isArray(legendItems) ? legendItems : [];
+            const legendDataFiltered = applyLegendFilter(rawLegendItems, legend, viewports, viewportClipPolygonsLocal, viewportRenderInfo);
+            if (legendDataFiltered && legendDataFiltered.length) {
+                const vpEl = viewports.find((v) => v.id === legend.viewport);
+                const fillOpacity = vpEl?.fills?.length ? (vpEl.fills[0].fillOpacity ?? 0.35) : undefined;
+                const result = buildLegendGroup(legend, template.styles, page, page.marginMm, legendDataFiltered, fillOpacity);
+                if (result?.colorMap) {
+                    legendColorMaps.set(legend.viewport, result.colorMap);
+                    console.log(`[LEGEND PRE-PROCESS] Stored color map for viewport "${legend.viewport}": ${result.colorMap.size} colors`);
+                }
+            }
+        }
+    });
+    sorted.forEach((el) => {
+        if (el.kind === ELEMENT_KIND_RECT) {
+            const r = el;
+            parts.push(`<rect x="${r.xMm}" y="${r.yMm}" width="${r.widthMm}" height="${r.heightMm}"` +
+                (r.stroke ? ` stroke="${escapeAttr(r.stroke)}"` : '') +
+                (r.strokeWidthMm ? ` stroke-width="${r.strokeWidthMm}"` : '') +
+                (r.fill ? ` fill="${escapeAttr(r.fill)}"` : ' fill="none"') +
+                dashArray(r.dashed) +
+                ` />`);
+        }
+        else if (el.kind === ELEMENT_KIND_LINE) {
+            const l = el;
+            parts.push(`<line x1="${l.x1Mm}" y1="${l.y1Mm}" x2="${l.x2Mm}" y2="${l.y2Mm}"` +
+                (l.stroke ? ` stroke="${escapeAttr(l.stroke)}"` : '') +
+                (l.strokeWidthMm ? ` stroke-width="${l.strokeWidthMm}"` : '') +
+                dashArray(l.dashed) +
+                ` />`);
+        }
+        else if (el.kind === ELEMENT_KIND_CIRCLE) {
+            const c = el;
+            parts.push(`<circle cx="${c.cxMm}" cy="${c.cyMm}" r="${c.rMm}"` +
+                (c.stroke ? ` stroke="${escapeAttr(c.stroke)}"` : '') +
+                (c.strokeWidthMm ? ` stroke-width="${c.strokeWidthMm}"` : '') +
+                (c.fill ? ` fill="${escapeAttr(c.fill)}"` : ' fill="none"') +
+                dashArray(c.dashed) +
+                ` />`);
+        }
+        else if (el.kind === ELEMENT_KIND_POLYLINE) {
+            const pl = el;
+            const pointsStr = pl.points.map((p) => `${formatNumber(p.xMm)},${formatNumber(p.yMm)}`).join(' ');
+            parts.push(`<polyline points="${pointsStr}" stroke="${escapeAttr(pl.stroke)}" stroke-width="${pl.strokeWidthMm}" fill="none"${dashArray(pl.dashed)} />`);
+        }
+        else if (el.kind === ELEMENT_KIND_POLYGON) {
+            const pg = el;
+            const pointsStr = pg.points.map((p) => `${formatNumber(p.xMm)},${formatNumber(p.yMm)}`).join(' ');
+            parts.push(`<polygon points="${pointsStr}"` +
+                (pg.stroke ? ` stroke="${escapeAttr(pg.stroke)}"` : '') +
+                (pg.strokeWidthMm ? ` stroke-width="${pg.strokeWidthMm}"` : '') +
+                (pg.fill ? ` fill="${escapeAttr(pg.fill)}"` : ' fill="none"') +
+                dashArray(pg.dashed) +
+                ` />`);
+        }
+        else if (el.kind === ELEMENT_KIND_TEXT) {
+            const tEl = el;
+            const styleName = tEl.textStyle;
+            const style = styleName ? template.styles?.[styleName] : undefined;
+            if (!style) {
+                pushWarning(warnings, `Missing text style '${styleName ?? '(none)'}' for element '${tEl.id}'.`);
+                return;
+            }
+            const text = interpolate(tEl.text, dataWithViewport, warnings);
+            const anchor = tEl.align === 'center' ? 'middle' : tEl.align === 'right' ? 'end' : 'start';
+            parts.push(`<text x="${tEl.xMm}" y="${tEl.yMm}" font-family="${escapeAttr(style.fontFamily)}" font-size="${style.fontSizeMm}"` +
+                (style.fontWeight ? ` font-weight="${escapeAttr(style.fontWeight)}"` : '') +
+                (style.color ? ` fill="${escapeAttr(style.color)}"` : '') +
+                (style.letterSpacingMm !== undefined ? ` letter-spacing="${style.letterSpacingMm}"` : '') +
+                (style.lineHeightMm !== undefined ? ` line-height="${style.lineHeightMm}"` : '') +
+                ` text-anchor="${anchor}">${escapeText(text)}</text>`);
+        }
+        else if (el.kind === ELEMENT_KIND_IMAGE) {
+            const img = el;
+            const asset = assetMap.get(img.assetId);
+            if (!asset) {
+                pushWarning(warnings, `Missing asset '${img.assetId}' for image '${img.id}'.`);
+                return;
+            }
+            if (asset.src) {
+                parts.push(`<image href="${escapeAttr(asset.src)}" x="${img.xMm}" y="${img.yMm}" width="${img.widthMm}" height="${img.heightMm}"` +
+                    (img.fit === 'cover'
+                        ? ' preserveAspectRatio="xMidYMid slice"'
+                        : img.fit === 'stretch'
+                            ? ' preserveAspectRatio="none"'
+                            : ' preserveAspectRatio="xMidYMid meet"') +
+                    ` />`);
+            }
+            else if (asset.content) {
+                parts.push(`<g transform="translate(${img.xMm} ${img.yMm}) scale(${img.widthMm} ${img.heightMm})">${asset.content}</g>`);
+            }
+        }
+        else if (el.kind === ELEMENT_KIND_SCALE_BAR) {
+            const sb = el;
+            // Scale bar declares which viewport it binds to via `viewport`
+            const boundViewport = sb.viewport ?? viewports[0]?.id ?? null;
+            if (!boundViewport) {
+                pushWarning(warnings, `Scale bar '${sb.id}' is not bound to a viewport.`);
+                return;
+            }
+            const scaleInfo = viewportScales[boundViewport];
+            if (!scaleInfo) {
+                pushWarning(warnings, `Viewport '${boundViewport}' missing scale info for scale bar '${sb.id}'.`);
+                return;
+            }
+            const lengthMm = sb.maxLengthMm;
+            const segments = sb.segments ?? 10;
+            const segmentMm = lengthMm / segments;
+            const metersPerMm = 1 / scaleInfo.mmPerModelUnit;
+            const segmentMeters = segmentMm * metersPerMm;
+            const labelsEvery = Math.max(1, sb.labelEvery ?? 1);
+            const unitSuffix = sb.unit ? ` ${sb.unit}` : ' m';
+            const barParts = [];
+            const sbStroke = sb.stroke ?? '#000';
+            const sbStrokeWidth = sb.strokeWidthMm ?? 0.5;
+            for (let i = 0; i <= segments; i++) {
+                const x = sb.xMm + segmentMm * i;
+                const isLabel = i % labelsEvery === 0;
+                const height = isLabel ? 4 : 3;
+                barParts.push(`<line x1="${x}" y1="${sb.yMm}" x2="${x}" y2="${sb.yMm - height}" stroke="${escapeAttr(sbStroke)}" stroke-width="${sbStrokeWidth}" />`);
+                if (isLabel && sb.textStyle) {
+                    const style = template.styles?.[sb.textStyle];
+                    if (style) {
+                        const labelValue = (segmentMeters * i).toFixed(2).replace(/\.?0+$/, '');
+                        barParts.push(`<text x="${x}" y="${sb.yMm + style.fontSizeMm + 1}" font-family="${escapeAttr(style.fontFamily)}" font-size="${style.fontSizeMm}" text-anchor="middle">${escapeText(labelValue + unitSuffix)}</text>`);
+                    }
+                }
+            }
+            barParts.push(`<line x1="${sb.xMm}" y1="${sb.yMm}" x2="${sb.xMm + lengthMm}" y2="${sb.yMm}" stroke="${escapeAttr(sbStroke)}" stroke-width="${sbStrokeWidth}" />`);
+            parts.push(barParts.join(''));
+        }
+        else if (el.kind === ELEMENT_KIND_VIEWPORT) {
+            const vp = el;
+            const model = filteredModelsByViewport[vp.id] ?? models[vp.id] ?? null;
+            if (!model) {
+                pushWarning(warnings, `Viewport '${vp.id}' missing model.`);
+            }
+            const vpParts = renderViewportElement(vp, model, dataWithViewport, preferredScales, presets.scales, assetMap, viewportScales, viewportClipPolygonsLocal, viewportClipBounds, viewportClipLabels, viewportClipStyles, viewportHighlight, viewportRenderInfo, warnings, legendColorMaps);
+            parts.push(...vpParts);
+        }
+        else if (el.kind === ELEMENT_KIND_LEGEND) {
+            const legend = el;
+            const legendItems = getPathValue(data, `viewports.${legend.viewport}.items`);
+            const rawLegendItems = Array.isArray(legendItems) ? legendItems : [];
+            const legendDataFiltered = applyLegendFilter(rawLegendItems, legend, viewports, viewportClipPolygonsLocal, viewportRenderInfo);
+            if (!legendDataFiltered || !legendDataFiltered.length) {
+                if (!rawLegendItems.length) {
+                    pushWarning(warnings, `Legend '${legend.id}' has no items from viewport '${legend.viewport}'.`);
+                }
+                else {
+                    pushWarning(warnings, `Legend '${legend.id}' filter matched 0 of ${rawLegendItems.length} items (class=${JSON.stringify(legend.class)}, where=${JSON.stringify(legend.where)}).`);
+                }
+            }
+            const vpEl = viewports.find((v) => v.id === legend.viewport);
+            // Derive swatch opacity from viewport fill rules (first matching rule's opacity)
+            const fillOpacity = vpEl?.fills?.length ? (vpEl.fills[0].fillOpacity ?? 0.35) : undefined;
+            const legendResult = buildLegendGroup(legend, template.styles, page, page.marginMm, legendDataFiltered || [], fillOpacity);
+            if (legendResult) {
+                parts.push(legendResult.svg);
+            }
+        }
+    });
+    if (labelElements.length) {
+        const labelParts = renderLabels(labelElements, data, viewportRenderInfo, viewportClipLabels, viewportClipPolygonsLocal, viewportClipPolygonsWorld, template.styles ?? {}, dataWithViewport, warnings);
+        parts.push(...labelParts);
+    }
+    if (qrElements.length) {
+        const qrParts = await renderQrElements(qrElements, viewports, viewportScales, models, { qrContext: options?.qrContext }, dataWithViewport, warnings);
+        parts.push(...qrParts);
+    }
+    parts.push('</svg>');
+    return { svg: parts.join(''), viewportScales, warnings };
+}
+// Register renderLayout with renderDrawing to break the circular dependency.
+// This runs at module evaluation time — safe because renderLayout is defined above.
+import { setRenderLayoutBinding as _setBinding } from './renderDrawing';
+_setBinding(renderLayout);
+//# sourceMappingURL=index.js.map