@twinfinity/printing 5.0.3-ci.28538-beta

package/README.md

@@ -0,0 +1,208 @@
+# @twinfinity/printing
+
+Template-driven page composition, section SVG building, and PDF/SVG export for BIM drawings.
+
+This package consolidates layout composition (formerly `@measurement-tools/print-layout`), PDF/SVG export (formerly `@measurement-tools/printing`), and section SVG building (formerly `@measurement-tools/sections`) into a single package.
+
+## Quick Start
+
+### Build a section render state
+
+```typescript
+import { createSectionSvg } from '@twinfinity/printing';
+
+// entries = from computePlaneSectionsForProducts() in @twinfinity/geometry
+const sectionState = createSectionSvg(entries);
+
+// sectionState.paths     — SVG path data with fill/stroke info
+// sectionState.transform — viewport dimensions
+// sectionState.labels    — positioned text labels
+```
+
+### Compose a drawing page from a template
+
+```typescript
+import { renderDrawing } from '@twinfinity/printing';
+
+const { svg, viewportScales } = await renderDrawing({
+  template,
+  sectionState,
+});
+
+// svg is a complete page SVG with title block, legend, scale bar, QR codes, etc.
+// viewportScales['main-viewport'].denom tells you the scale (e.g. 100 = 1:100)
+```
+
+### Export to PDF
+
+```typescript
+import { exportToPdf } from '@twinfinity/printing';
+
+await exportToPdf(svg, {
+  fileName: 'drawing.pdf',
+  pageFormat: 'a3',
+  orientation: 'landscape',
+});
+```
+
+### Quick PDF without a template
+
+```typescript
+import { exportSectionToPdf } from '@twinfinity/printing';
+
+await exportSectionToPdf({
+  state: sectionState,
+  fileName: 'section.pdf',
+  pageFormat: 'a3',
+  orientation: 'landscape',
+});
+```
+
+### End-to-end: BIM model to PDF
+
+```typescript
+import { SlabSection } from '@twinfinity/product-geometry';
+import { computePlaneSectionsForProducts } from '@twinfinity/geometry';
+import { createSectionSvg, renderDrawing, exportToPdf } from '@twinfinity/printing';
+import { planeFromPointAndNormal } from '@twinfinity/geometry';
+
+// 1. Compute section geometry
+const section = new SlabSection(scene, { cutHeight: 1.5, depth: { above: 2, below: 0.3 } });
+const geometry = await section.compute(products);
+
+// 2. Build section state
+const plane = planeFromPointAndNormal([0, 1.5, 0], [0, 1, 0]);
+const entries = await computePlaneSectionsForProducts(products, plane);
+const sectionState = createSectionSvg(entries);
+
+// 3. Compose drawing page from template
+const { svg } = await renderDrawing({ template, sectionState });
+
+// 4. Export to PDF
+await exportToPdf(svg, { fileName: 'drawing.pdf', pageFormat: 'a3', orientation: 'landscape' });
+```
+
+## Template-based layout composition
+
+### Validation and rendering
+
+```typescript
+import {
+  renderLayout,
+  validateLayoutTemplate,
+  preflight,
+  buildViewportItems,
+  sectionStateToModelView,
+  type LayoutTemplate,
+  type ProductFieldPaths,
+} from '@twinfinity/printing';
+
+// Validate template
+const vt = validateLayoutTemplate(tmpl);
+if (!vt.ok) throw new Error(vt.errors.map(e => `${e.path}: ${e.message}`).join('; '));
+
+// Build viewport items
+const productFields: ProductFieldPaths = {
+  idPath: 'propertySets.BIP.hyresobjektsnummer.value',
+  namePath: 'propertySets.BIP.spacename.value',
+  areaPath: 'propertySets.BIP.area.value',
+  classPath: 'propertySets.BIP.ifcClass.value',
+};
+const items = buildViewportItems(rawProducts, { productFields });
+
+// Preflight check
+const pf = preflight(tmpl, { viewports: { main: { items } } }, ['main'], sectionState);
+if (!pf.ok) {
+  const msgs = [
+    ...(pf.templateErrors ?? []).map(e => `${e.path}: ${e.message}`),
+    ...(pf.dataErrors ?? []),
+    ...(pf.sectionErrors ?? []),
+  ];
+  throw new Error(msgs.join('; '));
+}
+
+// Render
+const { svg } = await renderLayout(tmpl, { viewports: { main: { items } } }, models);
+```
+
+### Advanced section state
+
+```typescript
+import {
+  buildSectionStateForEntries,
+  extractViewWindow,
+  strokeWidthForWindow,
+} from '@twinfinity/printing';
+
+const state = buildSectionStateForEntries(entries, {
+  viewport: { viewMinX: -10, viewMaxX: 30, viewMinZ: -5, viewMaxZ: 25 },
+  strokeWidth: 0.15,
+  fills: [
+    { class: 'ifcspace', fillOpacity: 0.35 },
+    { class: ['ifcwall', 'ifcslab'], fillOpacity: 0 },
+  ],
+  includeLabels: true,
+  labelFontSize: 2.5,
+});
+```
+
+## Template JSON quick reference
+
+Templates are JSON files that define page layout. Use `$schema` for IDE validation:
+
+```json
+{
+  "$schema": "./path-to/template-schema.json",
+  "id": "my-template",
+  "page": { "widthMm": 420, "heightMm": 297, "marginMm": 10 },
+  "elements": []
+}
+```
+
+- **page**: `{ widthMm, heightMm, marginMm?, backgroundColor? }`
+- **styles**: named text styles `{ fontFamily, fontSizeMm, fontWeight?, letterSpacing?, lineHeight? }`
+- **assets**: `{ id, type: "image", src }` or `{ id, type: "svg", content }`
+- **elements** (z-index sorted):
+  - `viewport`: model view with scale, filters, clip, highlight, fills
+  - `text`: static or `{{interpolated}}` text
+  - `image`: logo or decorative image
+  - `line`, `rect`, `circle`: basic shapes
+  - `polyline`, `polygon`: custom vectors
+  - `scaleBar`: graphical scale indicator
+  - `qr`: QR codes for spatial anchoring (main + corner anchors)
+  - `labels`: per-item data-driven labels (room names, etc.)
+  - `legend`: tabular data with filtering and columns
+  - `group`: container with transforms/clipping
+- **presets**: reusable class filters and scale lists
+
+### Data contract
+
+- Item metadata must use `propertySets.<Set>.<Prop>.value`. Legacy `properties.*` is rejected.
+- Validate before render: use `validateLayoutTemplate` and `validateLayoutData` (or `preflight`).
+
+### Default templates
+
+Default templates (A0-A4, landscape/portrait) and a JSON schema for IDE validation are in the `templates/` directory.
+
+### Limits
+
+- Max 3 viewports by default (configurable in validation).
+- Legend: up to 200 rows, 5 data columns + color swatch.
+- Environment: PDF/QR export requires a browser/DOM with `document` and `svg2pdf.js`.
+- `DEFAULT_LAYOUT_TEMPLATE` provides a bundled A3 landscape example.
+
+## Troubleshooting
+
+| Message | Fix |
+|---------|-----|
+| `propertySets.<Set>.<Prop>.value` required | Update template/data paths to the canonical propertySets shape. |
+| `viewports.<id>.items is required...` | Provide a non-empty `items` array per viewport with `propertySets` on each item. |
+| `clip`/`highlight`/`legend` filter path is invalid | Use paths in the canonical shape; legacy `properties.*` is rejected. |
+| `Section render state is required` / transform errors | Ensure `SectionRenderState` has `geometryTransform`, `transform`, and non-empty `paths`. |
+| `Document is not available` | Run in a browser/DOM environment; headless Node is not supported out of the box. |
+
+## Documentation
+
+- [Template reference (field-by-field)](../../docs/specs/printing-template-reference.md)
+- [Template guide (practical examples)](../../docs/specs/printing-template-guide.md)
+- [Architecture overview](../../docs/specs/printing-architecture.md)

package/dist/BuildInfo.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Represents either production or development build type
+ */
+export type BuildType = 'Dev' | 'Prod';
+/**
+ * Contains property metadata for the Twinfinity build
+ */
+export interface BuildInfo {
+    /** Major version number */
+    readonly major: number;
+    /** Minor version number */
+    readonly minor: number;
+    /** Patch version number */
+    readonly patch: number;
+    /** Unique build id */
+    readonly id: number;
+    /** The commit checksum */
+    readonly commit: string;
+    /** String that uniquely identifies the current version */
+    readonly version: string;
+    /** The build type */
+    readonly buildType: BuildType;
+}
+export declare const BUILD_INFO: Readonly<BuildInfo>;
+//# sourceMappingURL=BuildInfo.d.ts.map

package/dist/BuildInfo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BuildInfo.d.ts","sourceRoot":"/","sources":["BuildInfo.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,KAAK,GAAG,MAAM,CAAC;AAEvC;;GAEG;AACH,MAAM,WAAW,SAAS;IACtB,2BAA2B;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,2BAA2B;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,2BAA2B;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,sBAAsB;IACtB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,0BAA0B;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,0DAA0D;IAC1D,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,qBAAqB;IACrB,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;CACjC;AAiBD,eAAO,MAAM,UAAU,qBAAqB,CAAC"}

package/dist/BuildInfo.js

@@ -0,0 +1,15 @@
+const gBi = {
+    major: 5,
+    minor: 0,
+    patch: 3,
+    id: 28538,
+    commit: '8df82701',
+    version: '',
+    buildType: 'Prod'
+};
+gBi.version = `${gBi.major}.${gBi.minor}.${gBi.patch}.${gBi.id}-[${gBi.commit}]`;
+if (gBi.commit === 'unknownCommit') {
+    gBi.buildType = 'Dev';
+}
+export const BUILD_INFO = Object.freeze(gBi);
+//# sourceMappingURL=BuildInfo.js.map

package/dist/BuildInfo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BuildInfo.js","sourceRoot":"/","sources":["BuildInfo.ts"],"names":[],"mappings":"AAyBA,MAAM,GAAG,GAAc;IACnB,KAAK,EAAE,MAAM;IACb,KAAK,EAAE,MAAM;IACb,KAAK,EAAE,MAAM;IACb,EAAE,EAAE,MAAM;IACV,MAAM,EAAE,eAAe;IACvB,OAAO,EAAE,EAAE;IACX,SAAS,EAAE,MAAM;CACpB,CAAC;AAED,GAAG,CAAC,OAAkB,GAAG,GAAG,GAAG,CAAC,KAAK,IAAI,GAAG,CAAC,KAAK,IAAI,GAAG,CAAC,KAAK,IAAI,GAAG,CAAC,EAAE,KAAK,GAAG,CAAC,MAAM,GAAG,CAAC;AAC7F,IAAI,GAAG,CAAC,MAAM,KAAK,eAAe,EAAE,CAAC;IAChC,GAAG,CAAC,SAAuB,GAAG,KAAK,CAAC;AACzC,CAAC;AAED,MAAM,CAAC,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC","sourcesContent":["/**\r\n * Represents either production or development build type\r\n */\r\nexport type BuildType = 'Dev' | 'Prod';\r\n\r\n/**\r\n * Contains property metadata for the Twinfinity build\r\n */\r\nexport interface BuildInfo {\r\n    /** Major version number */\r\n    readonly major: number;\r\n    /** Minor version number */\r\n    readonly minor: number;\r\n    /** Patch version number */\r\n    readonly patch: number;\r\n    /** Unique build id */\r\n    readonly id: number;\r\n    /** The commit checksum */\r\n    readonly commit: string;\r\n    /** String that uniquely identifies the current version */\r\n    readonly version: string;\r\n    /** The build type */\r\n    readonly buildType: BuildType;\r\n}\r\n\r\nconst gBi: BuildInfo = {\r\n    major: 111111,\r\n    minor: 222222,\r\n    patch: 333333,\r\n    id: 444444,\r\n    commit: 'unknownCommit',\r\n    version: '',\r\n    buildType: 'Prod'\r\n};\r\n\r\n(gBi.version as string) = `${gBi.major}.${gBi.minor}.${gBi.patch}.${gBi.id}-[${gBi.commit}]`;\r\nif (gBi.commit === 'unknownCommit') {\r\n    (gBi.buildType as BuildType) = 'Dev';\r\n}\r\n\r\nexport const BUILD_INFO = Object.freeze(gBi);\r\n"]}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export * from './BuildInfo';
+export * from './types';
+export { printToSvg } from './printToSvg';
+export { printToPdf, printToSvgFile, type PrintToPdfOptions } from './printToPdf';
+export * from './layout/index';
+export * from './sections';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"/","sources":["index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,KAAK,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAGlF,cAAc,gBAAgB,CAAC;AAG/B,cAAc,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,9 @@
+export * from './BuildInfo';
+export * from './types';
+export { printToSvg } from './printToSvg';
+export { printToPdf, printToSvgFile } from './printToPdf';
+// Print-layout module (template-driven page composition)
+export * from './layout/index';
+// Sections SVG viewport module
+export * from './sections';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"/","sources":["index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,cAAc,EAA0B,MAAM,cAAc,CAAC;AAElF,yDAAyD;AACzD,cAAc,gBAAgB,CAAC;AAE/B,+BAA+B;AAC/B,cAAc,YAAY,CAAC","sourcesContent":["export * from './BuildInfo';\r\nexport * from './types';\r\nexport { printToSvg } from './printToSvg';\r\nexport { printToPdf, printToSvgFile, type PrintToPdfOptions } from './printToPdf';\r\n\r\n// Print-layout module (template-driven page composition)\r\nexport * from './layout/index';\r\n\r\n// Sections SVG viewport module\r\nexport * from './sections';\r\n"]}

package/dist/layout/analyzeTemplate.d.ts

@@ -0,0 +1,29 @@
+import type { LayoutTemplate } from './types';
+/**
+ * Describes the input requirements inferred from a layout template.
+ * Use `analyzeTemplate()` to scan a template and discover what data it needs.
+ */
+export interface TemplateRequirements {
+    /** Viewport IDs the template declares. */
+    viewportIds: string[];
+    /** Property paths referenced by legends, where-filters, and labels.
+     *  Short-path format: "SetName.propName" (e.g. "BIP.spacename"). */
+    propertyPaths: string[];
+    /** Class filters referenced (e.g. "space", "walls"). Already lowercase. */
+    classFilters: string[];
+    /** Asset IDs referenced by image/northArrow elements. */
+    assetIds: string[];
+    /** Text interpolation variables (e.g. "viewport.main.scaleText"). */
+    interpolationVars: string[];
+    /** Whether the template references remote (http/https) asset URLs. */
+    usesRemoteAssets: boolean;
+}
+/**
+ * Scan a layout template and return its input requirements.
+ *
+ * This is a pure, read-only analysis — it does not modify the template or
+ * perform any rendering. Use the result to validate inputs before calling
+ * `renderDrawing()` or `renderLayout()`.
+ */
+export declare function analyzeTemplate(template: LayoutTemplate): TemplateRequirements;
+//# sourceMappingURL=analyzeTemplate.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"analyzeTemplate.d.ts","sourceRoot":"/","sources":["layout/analyzeTemplate.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACR,cAAc,EAWjB,MAAM,SAAS,CAAC;AAEjB;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACjC,0CAA0C;IAC1C,WAAW,EAAE,MAAM,EAAE,CAAC;IAEtB;wEACoE;IACpE,aAAa,EAAE,MAAM,EAAE,CAAC;IAExB,2EAA2E;IAC3E,YAAY,EAAE,MAAM,EAAE,CAAC;IAEvB,yDAAyD;IACzD,QAAQ,EAAE,MAAM,EAAE,CAAC;IAEnB,qEAAqE;IACrE,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAE5B,sEAAsE;IACtE,gBAAgB,EAAE,OAAO,CAAC;CAC7B;AAiCD;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,cAAc,GAAG,oBAAoB,CA2I9E"}

package/dist/layout/analyzeTemplate.js

@@ -0,0 +1,168 @@
+import { normalizeClass } from './filters';
+const INTERPOLATION_RE = /\{\{\s*([^}]+?)\s*\}\}/g;
+/** Extract `{{path}}` tokens from a template string. */
+function extractInterpolationVars(text) {
+    const vars = [];
+    let m;
+    INTERPOLATION_RE.lastIndex = 0;
+    while ((m = INTERPOLATION_RE.exec(text)) !== null) {
+        vars.push(m[1]);
+    }
+    return vars;
+}
+/** Collect keys from a WhereCondition (each key is a property short-path). */
+function collectWherePaths(where, out) {
+    if (!where || typeof where !== 'object')
+        return;
+    for (const key of Object.keys(where)) {
+        out.add(key);
+    }
+}
+/** Collect class filter values, normalizing to lowercase. */
+function collectClassFilter(classFilter, out) {
+    if (!classFilter)
+        return;
+    const classes = Array.isArray(classFilter) ? classFilter : [classFilter];
+    for (const c of classes) {
+        const normalized = normalizeClass(c);
+        if (normalized)
+            out.add(normalized);
+    }
+}
+/**
+ * Scan a layout template and return its input requirements.
+ *
+ * This is a pure, read-only analysis — it does not modify the template or
+ * perform any rendering. Use the result to validate inputs before calling
+ * `renderDrawing()` or `renderLayout()`.
+ */
+export function analyzeTemplate(template) {
+    const viewportIds = new Set();
+    const propertyPaths = new Set();
+    const classFilters = new Set();
+    const assetIds = new Set();
+    const interpolationVars = new Set();
+    let usesRemoteAssets = false;
+    // Check assets for remote URLs
+    if (template.assets) {
+        for (const asset of template.assets) {
+            if (asset.src && /^https?:\/\//i.test(asset.src)) {
+                usesRemoteAssets = true;
+            }
+        }
+    }
+    // Walk all elements (recursing into groups)
+    const walk = (elements) => {
+        for (const el of elements) {
+            switch (el.kind) {
+                case 'viewport': {
+                    const vp = el;
+                    viewportIds.add(vp.id);
+                    // Clip filter
+                    if (vp.clip) {
+                        collectClassFilter(vp.clip.class, classFilters);
+                        collectWherePaths(vp.clip.where, propertyPaths);
+                    }
+                    // Highlight filter
+                    if (vp.highlight) {
+                        collectClassFilter(vp.highlight.class, classFilters);
+                        collectWherePaths(vp.highlight.where, propertyPaths);
+                    }
+                    // includeClasses
+                    if (vp.includeClasses) {
+                        if (Array.isArray(vp.includeClasses)) {
+                            for (const c of vp.includeClasses) {
+                                const normalized = normalizeClass(c);
+                                if (normalized)
+                                    classFilters.add(normalized);
+                            }
+                        }
+                        // Preset references are resolved at render time, nothing to collect
+                    }
+                    // North arrow asset
+                    if (vp.northArrow?.assetId) {
+                        assetIds.add(vp.northArrow.assetId);
+                    }
+                    break;
+                }
+                case 'text': {
+                    const txt = el;
+                    if (txt.text) {
+                        for (const v of extractInterpolationVars(txt.text)) {
+                            interpolationVars.add(v);
+                        }
+                    }
+                    break;
+                }
+                case 'image': {
+                    const img = el;
+                    if (img.assetId)
+                        assetIds.add(img.assetId);
+                    break;
+                }
+                case 'qr': {
+                    const qr = el;
+                    if (qr.dataTemplate) {
+                        for (const v of extractInterpolationVars(qr.dataTemplate)) {
+                            interpolationVars.add(v);
+                        }
+                    }
+                    break;
+                }
+                case 'labels': {
+                    const sl = el;
+                    collectClassFilter(sl.class, classFilters);
+                    collectWherePaths(sl.where, propertyPaths);
+                    // Extract property paths from text interpolation (skip viewport.* which are computed)
+                    if (sl.text) {
+                        for (const v of extractInterpolationVars(sl.text)) {
+                            if (!v.startsWith('viewport.')) {
+                                propertyPaths.add(v);
+                            }
+                            else {
+                                interpolationVars.add(v);
+                            }
+                        }
+                    }
+                    break;
+                }
+                case 'legend': {
+                    const leg = el;
+                    collectClassFilter(leg.class, classFilters);
+                    collectWherePaths(leg.where, propertyPaths);
+                    // Column property paths
+                    if (leg.columns) {
+                        for (const col of leg.columns) {
+                            if (col.property)
+                                propertyPaths.add(col.property);
+                        }
+                    }
+                    break;
+                }
+                case 'scaleBar': {
+                    // scaleBar references a viewport by ID (informational)
+                    const sb = el;
+                    if (sb.viewport)
+                        viewportIds.add(sb.viewport);
+                    break;
+                }
+                case 'group': {
+                    const grp = el;
+                    if (grp.children)
+                        walk(grp.children);
+                    break;
+                }
+            }
+        }
+    };
+    walk(template.elements);
+    return {
+        viewportIds: [...viewportIds],
+        propertyPaths: [...propertyPaths],
+        classFilters: [...classFilters],
+        assetIds: [...assetIds],
+        interpolationVars: [...interpolationVars],
+        usesRemoteAssets
+    };
+}
+//# sourceMappingURL=analyzeTemplate.js.map

package/dist/layout/analyzeTemplate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyzeTemplate.js","sourceRoot":"/","sources":["layout/analyzeTemplate.ts"],"names":[],"mappings":"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","sourcesContent":["import { normalizeClass } from './filters';\r\nimport type {\r\n    LayoutTemplate,\r\n    LayoutElement,\r\n    ViewportElement,\r\n    TextElement,\r\n    ImageElement,\r\n    QrElement,\r\n    LabelsElement,\r\n    LegendElement,\r\n    GroupElement,\r\n    ScaleBarElement,\r\n    WhereCondition\r\n} from './types';\r\n\r\n/**\r\n * Describes the input requirements inferred from a layout template.\r\n * Use `analyzeTemplate()` to scan a template and discover what data it needs.\r\n */\r\nexport interface TemplateRequirements {\r\n    /** Viewport IDs the template declares. */\r\n    viewportIds: string[];\r\n\r\n    /** Property paths referenced by legends, where-filters, and labels.\r\n     *  Short-path format: \"SetName.propName\" (e.g. \"BIP.spacename\"). */\r\n    propertyPaths: string[];\r\n\r\n    /** Class filters referenced (e.g. \"space\", \"walls\"). Already lowercase. */\r\n    classFilters: string[];\r\n\r\n    /** Asset IDs referenced by image/northArrow elements. */\r\n    assetIds: string[];\r\n\r\n    /** Text interpolation variables (e.g. \"viewport.main.scaleText\"). */\r\n    interpolationVars: string[];\r\n\r\n    /** Whether the template references remote (http/https) asset URLs. */\r\n    usesRemoteAssets: boolean;\r\n}\r\n\r\nconst INTERPOLATION_RE = /\\{\\{\\s*([^}]+?)\\s*\\}\\}/g;\r\n\r\n/** Extract `{{path}}` tokens from a template string. */\r\nfunction extractInterpolationVars(text: string): string[] {\r\n    const vars: string[] = [];\r\n    let m: RegExpExecArray | null;\r\n    INTERPOLATION_RE.lastIndex = 0;\r\n    while ((m = INTERPOLATION_RE.exec(text)) !== null) {\r\n        vars.push(m[1]);\r\n    }\r\n    return vars;\r\n}\r\n\r\n/** Collect keys from a WhereCondition (each key is a property short-path). */\r\nfunction collectWherePaths(where: WhereCondition | undefined, out: Set<string>): void {\r\n    if (!where || typeof where !== 'object') return;\r\n    for (const key of Object.keys(where)) {\r\n        out.add(key);\r\n    }\r\n}\r\n\r\n/** Collect class filter values, normalizing to lowercase. */\r\nfunction collectClassFilter(classFilter: string | string[] | undefined, out: Set<string>): void {\r\n    if (!classFilter) return;\r\n    const classes = Array.isArray(classFilter) ? classFilter : [classFilter];\r\n    for (const c of classes) {\r\n        const normalized = normalizeClass(c);\r\n        if (normalized) out.add(normalized);\r\n    }\r\n}\r\n\r\n/**\r\n * Scan a layout template and return its input requirements.\r\n *\r\n * This is a pure, read-only analysis — it does not modify the template or\r\n * perform any rendering. Use the result to validate inputs before calling\r\n * `renderDrawing()` or `renderLayout()`.\r\n */\r\nexport function analyzeTemplate(template: LayoutTemplate): TemplateRequirements {\r\n    const viewportIds = new Set<string>();\r\n    const propertyPaths = new Set<string>();\r\n    const classFilters = new Set<string>();\r\n    const assetIds = new Set<string>();\r\n    const interpolationVars = new Set<string>();\r\n    let usesRemoteAssets = false;\r\n\r\n    // Check assets for remote URLs\r\n    if (template.assets) {\r\n        for (const asset of template.assets) {\r\n            if (asset.src && /^https?:\\/\\//i.test(asset.src)) {\r\n                usesRemoteAssets = true;\r\n            }\r\n        }\r\n    }\r\n\r\n    // Walk all elements (recursing into groups)\r\n    const walk = (elements: LayoutElement[]): void => {\r\n        for (const el of elements) {\r\n            switch (el.kind) {\r\n                case 'viewport': {\r\n                    const vp = el as ViewportElement;\r\n                    viewportIds.add(vp.id);\r\n\r\n                    // Clip filter\r\n                    if (vp.clip) {\r\n                        collectClassFilter(vp.clip.class, classFilters);\r\n                        collectWherePaths(vp.clip.where, propertyPaths);\r\n                    }\r\n\r\n                    // Highlight filter\r\n                    if (vp.highlight) {\r\n                        collectClassFilter(vp.highlight.class, classFilters);\r\n                        collectWherePaths(vp.highlight.where, propertyPaths);\r\n                    }\r\n\r\n                    // includeClasses\r\n                    if (vp.includeClasses) {\r\n                        if (Array.isArray(vp.includeClasses)) {\r\n                            for (const c of vp.includeClasses) {\r\n                                const normalized = normalizeClass(c);\r\n                                if (normalized) classFilters.add(normalized);\r\n                            }\r\n                        }\r\n                        // Preset references are resolved at render time, nothing to collect\r\n                    }\r\n\r\n                    // North arrow asset\r\n                    if (vp.northArrow?.assetId) {\r\n                        assetIds.add(vp.northArrow.assetId);\r\n                    }\r\n                    break;\r\n                }\r\n\r\n                case 'text': {\r\n                    const txt = el as TextElement;\r\n                    if (txt.text) {\r\n                        for (const v of extractInterpolationVars(txt.text)) {\r\n                            interpolationVars.add(v);\r\n                        }\r\n                    }\r\n                    break;\r\n                }\r\n\r\n                case 'image': {\r\n                    const img = el as ImageElement;\r\n                    if (img.assetId) assetIds.add(img.assetId);\r\n                    break;\r\n                }\r\n\r\n                case 'qr': {\r\n                    const qr = el as QrElement;\r\n                    if (qr.dataTemplate) {\r\n                        for (const v of extractInterpolationVars(qr.dataTemplate)) {\r\n                            interpolationVars.add(v);\r\n                        }\r\n                    }\r\n                    break;\r\n                }\r\n\r\n                case 'labels': {\r\n                    const sl = el as LabelsElement;\r\n                    collectClassFilter(sl.class, classFilters);\r\n                    collectWherePaths(sl.where, propertyPaths);\r\n\r\n                    // Extract property paths from text interpolation (skip viewport.* which are computed)\r\n                    if (sl.text) {\r\n                        for (const v of extractInterpolationVars(sl.text)) {\r\n                            if (!v.startsWith('viewport.')) {\r\n                                propertyPaths.add(v);\r\n                            } else {\r\n                                interpolationVars.add(v);\r\n                            }\r\n                        }\r\n                    }\r\n                    break;\r\n                }\r\n\r\n                case 'legend': {\r\n                    const leg = el as LegendElement;\r\n                    collectClassFilter(leg.class, classFilters);\r\n                    collectWherePaths(leg.where, propertyPaths);\r\n\r\n                    // Column property paths\r\n                    if (leg.columns) {\r\n                        for (const col of leg.columns) {\r\n                            if (col.property) propertyPaths.add(col.property);\r\n                        }\r\n                    }\r\n                    break;\r\n                }\r\n\r\n                case 'scaleBar': {\r\n                    // scaleBar references a viewport by ID (informational)\r\n                    const sb = el as ScaleBarElement;\r\n                    if (sb.viewport) viewportIds.add(sb.viewport);\r\n                    break;\r\n                }\r\n\r\n                case 'group': {\r\n                    const grp = el as GroupElement;\r\n                    if (grp.children) walk(grp.children);\r\n                    break;\r\n                }\r\n            }\r\n        }\r\n    };\r\n\r\n    walk(template.elements);\r\n\r\n    return {\r\n        viewportIds: [...viewportIds],\r\n        propertyPaths: [...propertyPaths],\r\n        classFilters: [...classFilters],\r\n        assetIds: [...assetIds],\r\n        interpolationVars: [...interpolationVars],\r\n        usesRemoteAssets\r\n    };\r\n}\r\n"]}

package/dist/layout/clipUtils.d.ts

@@ -0,0 +1,18 @@
+import type { SvgModelView } from './types';
+export type Point = {
+    x: number;
+    y: number;
+};
+export type Polygon = Point[];
+export declare const pointInPolygon: (polygon: Polygon, x: number, y: number) => boolean;
+export declare const filterItemsInPolygons: (items: unknown[], polygons: Polygon[], xField: string | undefined, yField: string | undefined, getPathValue: (obj: unknown, path: string) => unknown) => unknown[];
+export declare const filterEntriesByClip: (entries: unknown[], polygons: Array<Array<{
+    x: number;
+    z: number;
+}>>) => unknown[];
+export declare const offsetPolygons: (polys: Polygon[], delta: number) => Polygon[];
+export declare const projectPolygonsToLocal: (polygonsSource: unknown, xField: string, yField: string, model: SvgModelView, rotationDeg: number, contentOffsetX: number, contentOffsetY: number, mmPerModel: number) => {
+    local: Polygon[];
+    page: Polygon[];
+};
+//# sourceMappingURL=clipUtils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"clipUtils.d.ts","sourceRoot":"/","sources":["layout/clipUtils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAG5C,MAAM,MAAM,KAAK,GAAG;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAC7C,MAAM,MAAM,OAAO,GAAG,KAAK,EAAE,CAAC;AAI9B,eAAO,MAAM,cAAc,GAAI,SAAS,OAAO,EAAE,GAAG,MAAM,EAAE,GAAG,MAAM,KAAG,OAWvE,CAAC;AAEF,eAAO,MAAM,qBAAqB,GAC9B,OAAO,OAAO,EAAE,EAChB,UAAU,OAAO,EAAE,EACnB,0BAAY,EACZ,0BAAY,EACZ,cAAc,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,KACtD,OAAO,EAUT,CAAC;AAEF,eAAO,MAAM,mBAAmB,GAC5B,SAAS,OAAO,EAAE,EAClB,UAAU,KAAK,CAAC,KAAK,CAAC;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC,KACjD,OAAO,EA2CT,CAAC;AAEF,eAAO,MAAM,cAAc,GAAI,OAAO,OAAO,EAAE,EAAE,OAAO,MAAM,KAAG,OAAO,EAuCvE,CAAC;AAEF,eAAO,MAAM,sBAAsB,GAC/B,gBAAgB,OAAO,EACvB,QAAQ,MAAM,EACd,QAAQ,MAAM,EACd,OAAO,YAAY,EACnB,aAAa,MAAM,EACnB,gBAAgB,MAAM,EACtB,gBAAgB,MAAM,EACtB,YAAY,MAAM,KACnB;IAAE,KAAK,EAAE,OAAO,EAAE,CAAC;IAAC,IAAI,EAAE,OAAO,EAAE,CAAA;CAuDrC,CAAC"}