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

package/dist/layout/renderLayout.js

@@ -0,0 +1,315 @@
+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 { resolveIncludeClasses } from './metadata';
+import { pushWarning } from './warnings';
+import { escapeAttr, escapeText, interpolate, getPathValue, formatNumber } from './renderUtils';
+import { uniquePositiveDenoms } from './utils';
+import { validateLayoutTemplate } from './validation';
+import { validateLayoutData } from './preflight';
+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';
+const SVG_NS = 'http://www.w3.org/2000/svg';
+const dashArray = (dash) => (dash ? ` stroke-dasharray="${escapeAttr(dash)}"` : '');
+/**
+ * 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 resources, 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, {
+        allowRemoteResources: options?.allowRemoteResources,
+        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 resourceMap = new Map();
+    (template.resources ?? []).forEach((resource) => resourceMap.set(resource.id, resource));
+    const qrElements = allElements.filter((el) => el.kind === ELEMENT_KIND_QR);
+    const labelElements = allElements.filter((el) => el.kind === ELEMENT_KIND_LABELS);
+    const viewportRenderInfo = {};
+    // Compute every legend ONCE, before viewport rendering: fill: "legend"
+    // needs the color assignments first, and the drawn legend must be built
+    // from the exact same rows — computing twice is how fill colors drift
+    // from the legend swatches. applyLegendFilter works in world space, so no
+    // render-time state is needed here. Results are keyed by element
+    // reference (immune to duplicate ids) and reused by the render pass.
+    const legendColorMaps = new Map(); // viewport ID -> color assignment
+    const legendResults = new Map();
+    const legendElements = allElements.filter((el) => el.kind === ELEMENT_KIND_LEGEND);
+    legendElements.forEach((legend) => {
+        const legendItems = getPathValue(data, `viewports.${legend.viewport}.items`);
+        const rawLegendItems = Array.isArray(legendItems) ? legendItems : [];
+        const legendDataFiltered = applyLegendFilter(rawLegendItems, legend, viewportClipPolygonsWorld);
+        if (!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);
+        // Swatch opacity mirrors the fill rule the legend actually drives
+        // (fill: "legend"), falling back to the first fill rule.
+        const fillRule = vpEl?.fills?.find((f) => f.fill === 'legend') ?? vpEl?.fills?.[0];
+        const fillOpacity = fillRule ? (fillRule.fillOpacity ?? 0.35) : undefined;
+        const result = buildLegendGroup(legend, template.styles, page, page.marginMm, legendDataFiltered, fillOpacity);
+        legendResults.set(legend, result);
+        if (result?.colors) {
+            if (legendColorMaps.has(legend.viewport)) {
+                pushWarning(warnings, `Multiple legends with assignColors target viewport '${legend.viewport}' — fill: "legend" uses the last one.`);
+            }
+            legendColorMaps.set(legend.viewport, result.colors);
+        }
+    });
+    const renderElement = (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.dash) +
+                ` />`);
+        }
+        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.dash) +
+                ` />`);
+        }
+        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.dash) +
+                ` />`);
+        }
+        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.dash)} />`);
+        }
+        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.dash) +
+                ` />`);
+        }
+        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)}"` : '') +
+                // Escaped, not type-narrowed: validation only checks fontFamily and fontSizeMm,
+                // and these attributes legitimately accept a length with units ("0.5mm"), so
+                // forcing them to numbers would reject valid templates. Unescaped, a value of
+                // `0" onload="…` closed the attribute and injected a handler.
+                (style.letterSpacingMm !== undefined
+                    ? ` letter-spacing="${escapeAttr(style.letterSpacingMm)}"`
+                    : '') +
+                (style.lineHeightMm !== undefined ? ` line-height="${escapeAttr(style.lineHeightMm)}"` : '') +
+                ` text-anchor="${anchor}">${escapeText(text)}</text>`);
+        }
+        else if (el.kind === ELEMENT_KIND_IMAGE) {
+            const img = el;
+            const resource = resourceMap.get(img.resourceId);
+            if (!resource) {
+                pushWarning(warnings, `Missing resource '${img.resourceId}' for image '${img.id}'.`);
+                return;
+            }
+            if (resource.src) {
+                parts.push(`<image href="${escapeAttr(resource.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 (resource.content) {
+                parts.push(`<g transform="translate(${img.xMm} ${img.yMm}) scale(${img.widthMm} ${img.heightMm})">${resource.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 ?? 2);
+            const unitSuffix = sb.unit ? ` ${sb.unit}` : ' m';
+            const barParts = [];
+            const sbStroke = sb.stroke ?? '#000';
+            const sbStrokeWidth = sb.strokeWidthMm ?? 0.25;
+            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.`);
+            }
+            // Resolved once per viewport: the same includeClasses (incl. presets) that
+            // filters the line paths also gates generic fill rules in the renderer.
+            const vpIncludeFilters = resolveIncludeClasses(vp.includeClasses, presets.includeClasses ?? {});
+            const vpParts = renderViewportElement(vp, model, dataWithViewport, preferredScales, presets.scales, resourceMap, viewportScales, viewportClipPolygonsLocal, viewportClipBounds, viewportClipLabels, viewportClipStyles, viewportHighlight, viewportRenderInfo, warnings, legendColorMaps, undefined, vpIncludeFilters);
+            parts.push(...vpParts);
+        }
+        else if (el.kind === ELEMENT_KIND_LEGEND) {
+            // Computed once in the pre-pass (same rows as the color maps).
+            const legendResult = legendResults.get(el);
+            if (legendResult) {
+                parts.push(legendResult.svg);
+            }
+        }
+        else if (el.kind === ELEMENT_KIND_GROUP) {
+            const grp = el;
+            const children = Array.isArray(grp.children) ? grp.children : [];
+            if (!children.length)
+                return;
+            const t = grp.transform;
+            const transforms = [];
+            if (t?.translateXMm || t?.translateYMm) {
+                transforms.push(`translate(${t.translateXMm ?? 0} ${t.translateYMm ?? 0})`);
+            }
+            if (t?.rotateDeg)
+                transforms.push(`rotate(${t.rotateDeg})`);
+            if (t?.scaleX !== undefined || t?.scaleY !== undefined) {
+                transforms.push(`scale(${t.scaleX ?? 1} ${t.scaleY ?? 1})`);
+            }
+            let clipRef = '';
+            if (grp.clip && grp.clip.type === 'rect') {
+                // grp.id is template-authored and lands in both id="..." and url(#...); a quote in it
+                // would close the attribute and let the rest inject arbitrary ones. Every other
+                // template value in this function is escaped the same way.
+                const clipId = escapeAttr(`group-clip-${grp.id}-${parts.length}`);
+                parts.push(`<defs><clipPath id="${clipId}"><rect x="${grp.clip.xMm}" y="${grp.clip.yMm}" width="${grp.clip.widthMm}" height="${grp.clip.heightMm}" /></clipPath></defs>`);
+                clipRef = ` clip-path="url(#${clipId})"`;
+            }
+            parts.push(`<g${transforms.length ? ` transform="${transforms.join(' ')}"` : ''}` +
+                (grp.opacity !== undefined ? ` opacity="${grp.opacity}"` : '') +
+                clipRef +
+                `>`);
+            // Labels and QR are data-driven overlays rendered globally after
+            // the element pass (they need viewport render info / async QR
+            // encoding) — group transform/opacity/clip do not apply to them.
+            if (children.some((c) => c.kind === ELEMENT_KIND_LABELS || c.kind === ELEMENT_KIND_QR)) {
+                pushWarning(warnings, `Group '${grp.id}' contains labels/qr children — these render as page-level overlays; the group's transform/opacity/clip do not apply to them.`);
+            }
+            [...children]
+                .filter((c) => c.kind !== ELEMENT_KIND_LABELS && c.kind !== ELEMENT_KIND_QR)
+                .sort((a, b) => (a.zIndex ?? 0) - (b.zIndex ?? 0))
+                .forEach(renderElement);
+            parts.push('</g>');
+        }
+    };
+    sorted.forEach(renderElement);
+    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 };
+}
+//# sourceMappingURL=renderLayout.js.map

package/dist/layout/renderLayout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderLayout.js","sourceRoot":"/","sources":["layout/renderLayout.ts"],"names":[],"mappings":"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","sourcesContent":["import { renderViewportElement } from './viewportRender';\nimport { prepareViewports } from './viewportPrep';\nimport { renderLabels, ViewportRenderInfo } from './labelsRender';\nimport { renderQrElements } from './qrRender';\nimport { applyLegendFilter, buildLegendGroup, type LegendColorAssignment, type LegendResult } from './legendRender';\nimport { RenderLayoutOptions } from './options';\nimport { resolvePresets } from './presets';\nimport { resolveIncludeClasses } from './metadata';\nimport { pushWarning } from './warnings';\nimport { escapeAttr, escapeText, interpolate, getPathValue, formatNumber } from './renderUtils';\nimport { uniquePositiveDenoms } from './utils';\nimport { validateLayoutTemplate } from './validation';\nimport { validateLayoutData } from './preflight';\nimport {\n    ELEMENT_KIND_VIEWPORT,\n    ELEMENT_KIND_TEXT,\n    ELEMENT_KIND_IMAGE,\n    ELEMENT_KIND_LINE,\n    ELEMENT_KIND_RECT,\n    ELEMENT_KIND_CIRCLE,\n    ELEMENT_KIND_POLYLINE,\n    ELEMENT_KIND_POLYGON,\n    ELEMENT_KIND_SCALE_BAR,\n    ELEMENT_KIND_QR,\n    ELEMENT_KIND_LABELS,\n    ELEMENT_KIND_LEGEND,\n    ELEMENT_KIND_GROUP\n} from './elementKinds';\nimport {\n    ResourceSpec,\n    LayoutElement,\n    ViewportElement,\n    TextElement,\n    ImageElement,\n    LineElement,\n    RectElement,\n    CircleElement,\n    PolylineElement,\n    PolygonElement,\n    ScaleBarElement,\n    QrElement,\n    LabelsElement,\n    LegendElement,\n    GroupElement,\n    LayoutTemplate,\n    ModelContext,\n    LayoutData,\n    ValidationIssue,\n    ComputedViewportScale\n} from './types';\n\nconst SVG_NS = 'http://www.w3.org/2000/svg';\n\n/** Result of {@link renderLayout}: the final SVG markup, per-viewport scale info, and any warnings. */\nexport interface RenderLayoutResult {\n    /** Complete SVG markup string ready for embedding or PDF conversion. */\n    svg: string;\n    /** Per-viewport computed scale information (denominator, mm-per-model-unit, fit status). */\n    viewportScales: Record<string, ComputedViewportScale>;\n    /** Non-fatal issues encountered during rendering (missing resources, unresolved styles, etc.). */\n    warnings: string[];\n}\n\nconst dashArray = (dash?: string): string => (dash ? ` stroke-dasharray=\"${escapeAttr(dash)}\"` : '');\n\n/**\n * Render a layout template to SVG.\n *\n * This is the low-level rendering function. For most use cases, prefer {@link renderDrawing}\n * which handles all data wiring automatically.\n *\n * @param template - Validated layout template (page, elements, styles, presets).\n * @param data - Layout data with viewport items, template variables, and legend rows.\n * @param models - Per-viewport SVG model views (geometry + transforms).\n * @param options - Optional rendering settings (remote resources, scale overrides, metadata).\n * @returns SVG markup string, computed viewport scales, and any warnings.\n */\nexport async function renderLayout(\n    template: LayoutTemplate,\n    data: LayoutData,\n    models: ModelContext,\n    options?: RenderLayoutOptions\n): Promise<RenderLayoutResult> {\n    const presets = resolvePresets(template?.presets);\n\n    const validation = validateLayoutTemplate(template, {\n        allowRemoteResources: options?.allowRemoteResources,\n        allowDataUrls: options?.allowDataUrls,\n        maxViewports: options?.maxViewports\n    });\n    if (!validation.ok) {\n        throw new Error(\n            `Template validation failed: ${validation.errors.map((e: ValidationIssue) => `${e.path}: ${e.message}`).join('; ')}`\n        );\n    }\n\n    const preferredScales = uniquePositiveDenoms(options?.scaleDenominators);\n    const page = template.page;\n    const warnings: string[] = [];\n\n    // Flatten all elements to collect viewports, qrs, labels, legends regardless of grouping\n    const allElements: LayoutElement[] = [];\n    const collectElements = (elements: LayoutElement[]): void => {\n        elements.forEach((el) => {\n            allElements.push(el);\n            if (el.kind === ELEMENT_KIND_GROUP) {\n                collectElements((el as GroupElement).children);\n            }\n        });\n    };\n    collectElements(template.elements);\n\n    const viewports = allElements.filter((el) => el.kind === ELEMENT_KIND_VIEWPORT) as ViewportElement[];\n\n    const dataValidation = validateLayoutData(\n        data,\n        viewports.map((v) => v.id)\n    );\n    if (!dataValidation.ok) {\n        throw new Error(`Layout data validation failed: ${dataValidation.errors.join('; ')}`);\n    }\n\n    const {\n        viewportScales,\n        viewportClipPolygonsLocal,\n        viewportClipPolygonsWorld,\n        viewportClipBounds,\n        viewportClipLabels,\n        viewportClipStyles,\n        // viewportClipWhere intentionally omitted — not needed for rendering\n        viewportHighlight,\n        filteredModelsByViewport\n    } = prepareViewports(viewports, models, data, preferredScales, presets, {\n        metadataById: options?.metadataById,\n        warnings\n    });\n\n    const viewportData: Record<\n        string,\n        {\n            scaleDenom: number;\n            scaleText: string;\n            mmPerModelUnit: number;\n            fits: boolean;\n        }\n    > = {};\n\n    Object.entries(viewportScales).forEach(([id, scale]) => {\n        viewportData[id] = {\n            scaleDenom: scale.denom,\n            scaleText: `1:${scale.denom}`,\n            mmPerModelUnit: scale.mmPerModelUnit,\n            fits: scale.fits\n        };\n    });\n\n    const dataWithViewport = { ...data, viewport: viewportData };\n\n    const sorted = [...template.elements].sort((a, b) => (a.zIndex ?? 0) - (b.zIndex ?? 0));\n\n    const parts: string[] = [];\n    parts.push(\n        `<svg xmlns=\"${SVG_NS}\" width=\"${page.widthMm}mm\" height=\"${page.heightMm}mm\" viewBox=\"0 0 ${page.widthMm} ${page.heightMm}\">`\n    );\n\n    if (page.backgroundColor) {\n        parts.push(\n            `<rect x=\"0\" y=\"0\" width=\"${page.widthMm}\" height=\"${page.heightMm}\" fill=\"${escapeAttr(page.backgroundColor)}\"/>`\n        );\n    }\n\n    const resourceMap = new Map<string, ResourceSpec>();\n    (template.resources ?? []).forEach((resource) => resourceMap.set(resource.id, resource));\n\n    const qrElements = allElements.filter((el) => el.kind === ELEMENT_KIND_QR) as QrElement[];\n    const labelElements = allElements.filter((el) => el.kind === ELEMENT_KIND_LABELS) as LabelsElement[];\n    const viewportRenderInfo: Record<string, ViewportRenderInfo> = {};\n\n    // Compute every legend ONCE, before viewport rendering: fill: \"legend\"\n    // needs the color assignments first, and the drawn legend must be built\n    // from the exact same rows — computing twice is how fill colors drift\n    // from the legend swatches. applyLegendFilter works in world space, so no\n    // render-time state is needed here. Results are keyed by element\n    // reference (immune to duplicate ids) and reused by the render pass.\n    const legendColorMaps = new Map<string, LegendColorAssignment>(); // viewport ID -> color assignment\n    const legendResults = new Map<LegendElement, LegendResult | null>();\n    const legendElements = allElements.filter((el) => el.kind === ELEMENT_KIND_LEGEND) as LegendElement[];\n    legendElements.forEach((legend) => {\n        const legendItems = getPathValue(data, `viewports.${legend.viewport}.items`);\n        const rawLegendItems = Array.isArray(legendItems) ? legendItems : [];\n        const legendDataFiltered = applyLegendFilter(rawLegendItems, legend, viewportClipPolygonsWorld);\n        if (!legendDataFiltered.length) {\n            if (!rawLegendItems.length) {\n                pushWarning(warnings, `Legend '${legend.id}' has no items from viewport '${legend.viewport}'.`);\n            } else {\n                pushWarning(\n                    warnings,\n                    `Legend '${legend.id}' filter matched 0 of ${rawLegendItems.length} items (class=${JSON.stringify(legend.class)}, where=${JSON.stringify(legend.where)}).`\n                );\n            }\n        }\n        const vpEl = viewports.find((v) => v.id === legend.viewport);\n        // Swatch opacity mirrors the fill rule the legend actually drives\n        // (fill: \"legend\"), falling back to the first fill rule.\n        const fillRule = vpEl?.fills?.find((f) => f.fill === 'legend') ?? vpEl?.fills?.[0];\n        const fillOpacity = fillRule ? (fillRule.fillOpacity ?? 0.35) : undefined;\n        const result = buildLegendGroup(legend, template.styles, page, page.marginMm, legendDataFiltered, fillOpacity);\n        legendResults.set(legend, result);\n        if (result?.colors) {\n            if (legendColorMaps.has(legend.viewport)) {\n                pushWarning(\n                    warnings,\n                    `Multiple legends with assignColors target viewport '${legend.viewport}' — fill: \"legend\" uses the last one.`\n                );\n            }\n            legendColorMaps.set(legend.viewport, result.colors);\n        }\n    });\n\n    const renderElement = (el: LayoutElement): void => {\n        if (el.kind === ELEMENT_KIND_RECT) {\n            const r = el as RectElement;\n            parts.push(\n                `<rect x=\"${r.xMm}\" y=\"${r.yMm}\" width=\"${r.widthMm}\" height=\"${r.heightMm}\"` +\n                    (r.stroke ? ` stroke=\"${escapeAttr(r.stroke)}\"` : '') +\n                    (r.strokeWidthMm ? ` stroke-width=\"${r.strokeWidthMm}\"` : '') +\n                    (r.fill ? ` fill=\"${escapeAttr(r.fill)}\"` : ' fill=\"none\"') +\n                    dashArray(r.dash) +\n                    ` />`\n            );\n        } else if (el.kind === ELEMENT_KIND_LINE) {\n            const l = el as LineElement;\n            parts.push(\n                `<line x1=\"${l.x1Mm}\" y1=\"${l.y1Mm}\" x2=\"${l.x2Mm}\" y2=\"${l.y2Mm}\"` +\n                    (l.stroke ? ` stroke=\"${escapeAttr(l.stroke)}\"` : '') +\n                    (l.strokeWidthMm ? ` stroke-width=\"${l.strokeWidthMm}\"` : '') +\n                    dashArray(l.dash) +\n                    ` />`\n            );\n        } else if (el.kind === ELEMENT_KIND_CIRCLE) {\n            const c = el as CircleElement;\n            parts.push(\n                `<circle cx=\"${c.cxMm}\" cy=\"${c.cyMm}\" r=\"${c.rMm}\"` +\n                    (c.stroke ? ` stroke=\"${escapeAttr(c.stroke)}\"` : '') +\n                    (c.strokeWidthMm ? ` stroke-width=\"${c.strokeWidthMm}\"` : '') +\n                    (c.fill ? ` fill=\"${escapeAttr(c.fill)}\"` : ' fill=\"none\"') +\n                    dashArray(c.dash) +\n                    ` />`\n            );\n        } else if (el.kind === ELEMENT_KIND_POLYLINE) {\n            const pl = el as PolylineElement;\n            const pointsStr = pl.points.map((p) => `${formatNumber(p.xMm)},${formatNumber(p.yMm)}`).join(' ');\n            parts.push(\n                `<polyline points=\"${pointsStr}\" stroke=\"${escapeAttr(pl.stroke)}\" stroke-width=\"${pl.strokeWidthMm}\" fill=\"none\"${dashArray(pl.dash)} />`\n            );\n        } else if (el.kind === ELEMENT_KIND_POLYGON) {\n            const pg = el as PolygonElement;\n            const pointsStr = pg.points.map((p) => `${formatNumber(p.xMm)},${formatNumber(p.yMm)}`).join(' ');\n            parts.push(\n                `<polygon points=\"${pointsStr}\"` +\n                    (pg.stroke ? ` stroke=\"${escapeAttr(pg.stroke)}\"` : '') +\n                    (pg.strokeWidthMm ? ` stroke-width=\"${pg.strokeWidthMm}\"` : '') +\n                    (pg.fill ? ` fill=\"${escapeAttr(pg.fill)}\"` : ' fill=\"none\"') +\n                    dashArray(pg.dash) +\n                    ` />`\n            );\n        } else if (el.kind === ELEMENT_KIND_TEXT) {\n            const tEl = el as TextElement;\n            const styleName = tEl.textStyle;\n            const style = styleName ? template.styles?.[styleName] : undefined;\n            if (!style) {\n                pushWarning(warnings, `Missing text style '${styleName ?? '(none)'}' for element '${tEl.id}'.`);\n                return;\n            }\n            const text = interpolate(tEl.text, dataWithViewport, warnings);\n            const anchor = tEl.align === 'center' ? 'middle' : tEl.align === 'right' ? 'end' : 'start';\n            parts.push(\n                `<text x=\"${tEl.xMm}\" y=\"${tEl.yMm}\" font-family=\"${escapeAttr(style.fontFamily)}\" font-size=\"${style.fontSizeMm}\"` +\n                    (style.fontWeight ? ` font-weight=\"${escapeAttr(style.fontWeight)}\"` : '') +\n                    (style.color ? ` fill=\"${escapeAttr(style.color)}\"` : '') +\n                    // Escaped, not type-narrowed: validation only checks fontFamily and fontSizeMm,\n                    // and these attributes legitimately accept a length with units (\"0.5mm\"), so\n                    // forcing them to numbers would reject valid templates. Unescaped, a value of\n                    // `0\" onload=\"…` closed the attribute and injected a handler.\n                    (style.letterSpacingMm !== undefined\n                        ? ` letter-spacing=\"${escapeAttr(style.letterSpacingMm)}\"`\n                        : '') +\n                    (style.lineHeightMm !== undefined ? ` line-height=\"${escapeAttr(style.lineHeightMm)}\"` : '') +\n                    ` text-anchor=\"${anchor}\">${escapeText(text)}</text>`\n            );\n        } else if (el.kind === ELEMENT_KIND_IMAGE) {\n            const img = el as ImageElement;\n            const resource = resourceMap.get(img.resourceId);\n            if (!resource) {\n                pushWarning(warnings, `Missing resource '${img.resourceId}' for image '${img.id}'.`);\n                return;\n            }\n            if (resource.src) {\n                parts.push(\n                    `<image href=\"${escapeAttr(resource.src)}\" x=\"${img.xMm}\" y=\"${img.yMm}\" width=\"${img.widthMm}\" height=\"${img.heightMm}\"` +\n                        (img.fit === 'cover'\n                            ? ' preserveAspectRatio=\"xMidYMid slice\"'\n                            : img.fit === 'stretch'\n                              ? ' preserveAspectRatio=\"none\"'\n                              : ' preserveAspectRatio=\"xMidYMid meet\"') +\n                        ` />`\n                );\n            } else if (resource.content) {\n                parts.push(\n                    `<g transform=\"translate(${img.xMm} ${img.yMm}) scale(${img.widthMm} ${img.heightMm})\">${resource.content}</g>`\n                );\n            }\n        } else if (el.kind === ELEMENT_KIND_SCALE_BAR) {\n            const sb = el as ScaleBarElement;\n            // Scale bar declares which viewport it binds to via `viewport`\n            const boundViewport = sb.viewport ?? viewports[0]?.id ?? null;\n            if (!boundViewport) {\n                pushWarning(warnings, `Scale bar '${sb.id}' is not bound to a viewport.`);\n                return;\n            }\n            const scaleInfo = viewportScales[boundViewport];\n            if (!scaleInfo) {\n                pushWarning(warnings, `Viewport '${boundViewport}' missing scale info for scale bar '${sb.id}'.`);\n                return;\n            }\n            const lengthMm = sb.maxLengthMm;\n            const segments = sb.segments ?? 10;\n            const segmentMm = lengthMm / segments;\n            const metersPerMm = 1 / scaleInfo.mmPerModelUnit;\n            const segmentMeters = segmentMm * metersPerMm;\n            const labelsEvery = Math.max(1, sb.labelEvery ?? 2);\n            const unitSuffix = sb.unit ? ` ${sb.unit}` : ' m';\n            const barParts: string[] = [];\n            const sbStroke = sb.stroke ?? '#000';\n            const sbStrokeWidth = sb.strokeWidthMm ?? 0.25;\n\n            for (let i = 0; i <= segments; i++) {\n                const x = sb.xMm + segmentMm * i;\n                const isLabel = i % labelsEvery === 0;\n                const height = isLabel ? 4 : 3;\n                barParts.push(\n                    `<line x1=\"${x}\" y1=\"${sb.yMm}\" x2=\"${x}\" y2=\"${sb.yMm - height}\" stroke=\"${escapeAttr(\n                        sbStroke\n                    )}\" stroke-width=\"${sbStrokeWidth}\" />`\n                );\n                if (isLabel && sb.textStyle) {\n                    const style = template.styles?.[sb.textStyle];\n                    if (style) {\n                        const labelValue = (segmentMeters * i).toFixed(2).replace(/\\.?0+$/, '');\n                        barParts.push(\n                            `<text x=\"${x}\" y=\"${sb.yMm + style.fontSizeMm + 1}\" font-family=\"${escapeAttr(\n                                style.fontFamily\n                            )}\" font-size=\"${style.fontSizeMm}\" text-anchor=\"middle\">${escapeText(labelValue + unitSuffix)}</text>`\n                        );\n                    }\n                }\n            }\n\n            barParts.push(\n                `<line x1=\"${sb.xMm}\" y1=\"${sb.yMm}\" x2=\"${sb.xMm + lengthMm}\" y2=\"${sb.yMm}\" stroke=\"${escapeAttr(\n                    sbStroke\n                )}\" stroke-width=\"${sbStrokeWidth}\" />`\n            );\n\n            parts.push(barParts.join(''));\n        } else if (el.kind === ELEMENT_KIND_VIEWPORT) {\n            const vp = el as ViewportElement;\n            const model = filteredModelsByViewport[vp.id] ?? models[vp.id] ?? null;\n            if (!model) {\n                pushWarning(warnings, `Viewport '${vp.id}' missing model.`);\n            }\n            // Resolved once per viewport: the same includeClasses (incl. presets) that\n            // filters the line paths also gates generic fill rules in the renderer.\n            const vpIncludeFilters = resolveIncludeClasses(vp.includeClasses as unknown, presets.includeClasses ?? {});\n            const vpParts = renderViewportElement(\n                vp,\n                model,\n                dataWithViewport,\n                preferredScales,\n                presets.scales,\n                resourceMap,\n                viewportScales,\n                viewportClipPolygonsLocal,\n                viewportClipBounds,\n                viewportClipLabels,\n                viewportClipStyles,\n                viewportHighlight,\n                viewportRenderInfo,\n                warnings,\n                legendColorMaps,\n                undefined,\n                vpIncludeFilters\n            );\n            parts.push(...vpParts);\n        } else if (el.kind === ELEMENT_KIND_LEGEND) {\n            // Computed once in the pre-pass (same rows as the color maps).\n            const legendResult = legendResults.get(el as LegendElement);\n            if (legendResult) {\n                parts.push(legendResult.svg);\n            }\n        } else if (el.kind === ELEMENT_KIND_GROUP) {\n            const grp = el as GroupElement;\n            const children = Array.isArray(grp.children) ? grp.children : [];\n            if (!children.length) return;\n\n            const t = grp.transform;\n            const transforms: string[] = [];\n            if (t?.translateXMm || t?.translateYMm) {\n                transforms.push(`translate(${t.translateXMm ?? 0} ${t.translateYMm ?? 0})`);\n            }\n            if (t?.rotateDeg) transforms.push(`rotate(${t.rotateDeg})`);\n            if (t?.scaleX !== undefined || t?.scaleY !== undefined) {\n                transforms.push(`scale(${t.scaleX ?? 1} ${t.scaleY ?? 1})`);\n            }\n\n            let clipRef = '';\n            if (grp.clip && grp.clip.type === 'rect') {\n                // grp.id is template-authored and lands in both id=\"...\" and url(#...); a quote in it\n                // would close the attribute and let the rest inject arbitrary ones. Every other\n                // template value in this function is escaped the same way.\n                const clipId = escapeAttr(`group-clip-${grp.id}-${parts.length}`);\n                parts.push(\n                    `<defs><clipPath id=\"${clipId}\"><rect x=\"${grp.clip.xMm}\" y=\"${grp.clip.yMm}\" width=\"${grp.clip.widthMm}\" height=\"${grp.clip.heightMm}\" /></clipPath></defs>`\n                );\n                clipRef = ` clip-path=\"url(#${clipId})\"`;\n            }\n\n            parts.push(\n                `<g${transforms.length ? ` transform=\"${transforms.join(' ')}\"` : ''}` +\n                    (grp.opacity !== undefined ? ` opacity=\"${grp.opacity}\"` : '') +\n                    clipRef +\n                    `>`\n            );\n            // Labels and QR are data-driven overlays rendered globally after\n            // the element pass (they need viewport render info / async QR\n            // encoding) — group transform/opacity/clip do not apply to them.\n            if (children.some((c) => c.kind === ELEMENT_KIND_LABELS || c.kind === ELEMENT_KIND_QR)) {\n                pushWarning(\n                    warnings,\n                    `Group '${grp.id}' contains labels/qr children — these render as page-level overlays; the group's transform/opacity/clip do not apply to them.`\n                );\n            }\n            [...children]\n                .filter((c) => c.kind !== ELEMENT_KIND_LABELS && c.kind !== ELEMENT_KIND_QR)\n                .sort((a, b) => (a.zIndex ?? 0) - (b.zIndex ?? 0))\n                .forEach(renderElement);\n            parts.push('</g>');\n        }\n    };\n    sorted.forEach(renderElement);\n\n    if (labelElements.length) {\n        const labelParts = renderLabels(\n            labelElements,\n            data,\n            viewportRenderInfo,\n            viewportClipLabels,\n            viewportClipPolygonsLocal,\n            viewportClipPolygonsWorld,\n            template.styles ?? {},\n            dataWithViewport,\n            warnings\n        );\n        parts.push(...labelParts);\n    }\n\n    if (qrElements.length) {\n        const qrParts = await renderQrElements(\n            qrElements,\n            viewports,\n            viewportScales,\n            models,\n            { qrContext: options?.qrContext },\n            dataWithViewport,\n            warnings\n        );\n        parts.push(...qrParts);\n    }\n\n    parts.push('</svg>');\n\n    return { svg: parts.join(''), viewportScales, warnings };\n}\n"]}

package/dist/layout/renderTemplateSheet.d.ts

@@ -0,0 +1,99 @@
+import { type PlaneBasis, type Vec3 } from '@twinfinity/geometry';
+import { type ProductLike, type SlabSectionResult } from '@twinfinity/product-geometry';
+import { buildSectionStateForEntries } from '../sections';
+import { type SectionDefaults } from './sectionDefs';
+import type { LayoutTemplate, ViewportStairArrowOptions, ProductPolylineEntry } from './types';
+type SectionEntries = Parameters<typeof buildSectionStateForEntries>[0];
+/**
+ * The expensive template-independent half of one viewport's render: only the
+ * geometry is cached — the SvgModelView is built per viewport at render time,
+ * so template-driven styling (lineStyles incl. dash, fills) applies without
+ * re-sectioning.
+ */
+export type ComputedSection = {
+    kind: 'plan';
+    geometry: SlabSectionResult<ProductLike>;
+    basis: PlaneBasis;
+    segmentCount: number;
+    /** Per-product cut polylines (world x/z) — feeds labels/legend items. */
+    entries: ProductPolylineEntry[];
+} | {
+    kind: 'elevation';
+    perProduct: SectionEntries;
+    normal: Vec3;
+    segmentCount: number;
+    entries: ProductPolylineEntry[];
+};
+/**
+ * Section-geometry cache, one entry per distinct section definition. Owned by
+ * the caller (its lifetime = one loaded model; clear it when the model
+ * changes); renderTemplateSheet evicts entries no viewport references any
+ * more, keeping it bounded while sharing repeated definitions.
+ */
+export declare class SectionCache {
+    private readonly _map;
+    get(key: string): ComputedSection | undefined;
+    set(key: string, value: ComputedSection): void;
+    evictExcept(used: ReadonlySet<string>): void;
+    clear(): void;
+}
+export interface RenderTemplateSheetInput {
+    template: LayoutTemplate;
+    /** Products with geometry — pass ALL of them (unfiltered; see above). */
+    products: ProductLike[];
+    /**
+     * Fallback plan position (world) for viewports without a section
+     * definition — typically the model AABB centre. Without it such
+     * viewports are skipped with a warning.
+     */
+    modelCenter?: [number, number, number];
+    /** Section defaults applied where viewports omit cutHeight/depth. */
+    defaults?: SectionDefaults;
+    /** Reuse section geometry across renders (strongly recommended). */
+    cache?: SectionCache;
+    /** Context for role:'main'/'anchor' QR elements. */
+    qrContext?: {
+        host?: string | null;
+        containerName?: string | null;
+        floorName?: string | null;
+        planeHeight?: number | null;
+    };
+    /** Values for the template's declared variables ({{vars.*}}). */
+    variables?: Record<string, unknown>;
+    /**
+     * Host-side authorisation for fetching `https://` resources, matching the option `renderDrawing`
+     * already takes. Without it a caller rendering a sheet had no say at all — only the template
+     * could enable remote loading — so a host that wanted to permit it for its own templates could
+     * not, and one that wanted to observe the setting had nowhere to look.
+     */
+    allowRemoteResources?: boolean;
+    /**
+     * Progress callback: overall fraction 0–1 plus a human-readable phase.
+     * Section phases stream from SlabSection per viewport (cached sections
+     * skip ahead); the final render step reports as its own phase. Wire this
+     * to a busy indicator — large models can take tens of seconds, and
+     * without feedback a long compute is indistinguishable from a hang.
+     */
+    onProgress?: (progress: number, phase: string) => void;
+}
+export interface RenderedTemplateSheet {
+    svg: string;
+    warnings: string[];
+    /** Sum over viewports — 0 means no cut produced drawable geometry. */
+    segmentCount: number;
+}
+/**
+ * Read a viewport's `stairArrows` geometry options into a canonical object:
+ * known fields only, fixed order, invalid values dropped — so equal options
+ * always serialize to the same cache-key fragment and unknown junk from a
+ * hand-written template can't reach the geometry pass.
+ */
+export declare function readViewportStairArrowOptions(vp: Record<string, unknown>): ViewportStairArrowOptions | undefined;
+/**
+ * Render a template against a product set: resolve each viewport's section
+ * definition, compute (or reuse from `cache`) the section per distinct
+ * definition, and feed renderDrawing one model per viewport id.
+ */
+export declare function renderTemplateSheet(input: RenderTemplateSheetInput): Promise<RenderedTemplateSheet>;
+export {};
+//# sourceMappingURL=renderTemplateSheet.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"renderTemplateSheet.d.ts","sourceRoot":"/","sources":["layout/renderTemplateSheet.ts"],"names":[],"mappings":"AAAA,OAAO,EAA4C,KAAK,UAAU,EAAE,KAAK,IAAI,EAAE,MAAM,sBAAsB,CAAC;AAC5G,OAAO,EAGH,KAAK,WAAW,EAChB,KAAK,iBAAiB,EACzB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,2BAA2B,EAAE,MAAM,aAAa,CAAC;AAI1D,OAAO,EAAkE,KAAK,eAAe,EAAE,MAAM,eAAe,CAAC;AA2BrH,OAAO,KAAK,EACR,cAAc,EAGd,yBAAyB,EACzB,oBAAoB,EACvB,MAAM,SAAS,CAAC;AAqBjB,KAAK,cAAc,GAAG,UAAU,CAAC,OAAO,2BAA2B,CAAC,CAAC,CAAC,CAAC,CAAC;AAGxE;;;;;GAKG;AACH,MAAM,MAAM,eAAe,GACrB;IACI,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,iBAAiB,CAAC,WAAW,CAAC,CAAC;IACzC,KAAK,EAAE,UAAU,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,yEAAyE;IACzE,OAAO,EAAE,oBAAoB,EAAE,CAAC;CACnC,GACD;IACI,IAAI,EAAE,WAAW,CAAC;IAClB,UAAU,EAAE,cAAc,CAAC;IAC3B,MAAM,EAAE,IAAI,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,oBAAoB,EAAE,CAAC;CACnC,CAAC;AAER;;;;;GAKG;AACH,qBAAa,YAAY;IACrB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAsC;IAE3D,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS;IAI7C,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,eAAe,GAAG,IAAI;IAI9C,WAAW,CAAC,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,IAAI;IAM5C,KAAK,IAAI,IAAI;CAGhB;AAED,MAAM,WAAW,wBAAwB;IACrC,QAAQ,EAAE,cAAc,CAAC;IACzB,yEAAyE;IACzE,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB;;;;OAIG;IACH,WAAW,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC,qEAAqE;IACrE,QAAQ,CAAC,EAAE,eAAe,CAAC;IAC3B,oEAAoE;IACpE,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,oDAAoD;IACpD,SAAS,CAAC,EAAE;QACR,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACrB,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAC9B,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAC1B,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;KAC/B,CAAC;IACF,iEAAiE;IACjE,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC;;;;;OAKG;IACH,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B;;;;;;OAMG;IACH,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CAC1D;AAED,MAAM,WAAW,qBAAqB;IAClC,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,sEAAsE;IACtE,YAAY,EAAE,MAAM,CAAC;CACxB;AAED;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAAC,EAAE,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,yBAAyB,GAAG,SAAS,CAgBhH;AA0FD;;;;GAIG;AACH,wBAAsB,mBAAmB,CAAC,KAAK,EAAE,wBAAwB,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAuJzG"}