@twinfinity/printing 5.0.3-ci.28538-beta

package/dist/printToPdf.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"printToPdf.js","sourceRoot":"/","sources":["printToPdf.ts"],"names":[],"mappings":"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","sourcesContent":["/**\r\n * PDF export via jsPDF + svg2pdf.js\r\n *\r\n * These are optional peer dependencies. Functions will throw at runtime if not installed.\r\n */\r\n\r\nexport interface PrintToPdfOptions {\r\n    svgMarkup: string;\r\n    fileName?: string;\r\n    pageFormat?: 'a0' | 'a1' | 'a2' | 'a3' | 'a4';\r\n    orientation?: 'portrait' | 'landscape';\r\n    marginMm?: number;\r\n}\r\n\r\n/**\r\n * Export an SVG string to a PDF file.\r\n * Requires jspdf and svg2pdf.js as peer dependencies.\r\n */\r\nexport async function printToPdf(options: PrintToPdfOptions): Promise<Blob> {\r\n    // Dynamic imports for optional peer dependencies (installed by consumer, not this package)\r\n    let jspdfModule: any;\r\n    try {\r\n        // @ts-expect-error — optional peer dependency resolved at runtime\r\n        jspdfModule = await import('jspdf');\r\n    } catch {\r\n        throw new Error('jspdf is required for PDF export. Install it: bun add jspdf');\r\n    }\r\n    try {\r\n        // @ts-expect-error — optional peer dependency resolved at runtime\r\n        await import('svg2pdf.js');\r\n    } catch {\r\n        throw new Error('svg2pdf.js is required for PDF export. Install it: bun add svg2pdf.js');\r\n    }\r\n\r\n    const { jsPDF } = jspdfModule;\r\n    const format = options.pageFormat ?? 'a3';\r\n    const orientation = options.orientation ?? 'landscape';\r\n    const margin = options.marginMm ?? 10;\r\n\r\n    const doc = new jsPDF({ format, orientation, unit: 'mm' });\r\n    const pageWidth = doc.internal.pageSize.getWidth();\r\n    const pageHeight = doc.internal.pageSize.getHeight();\r\n\r\n    const parser = new DOMParser();\r\n    const svgDoc = parser.parseFromString(options.svgMarkup, 'image/svg+xml');\r\n    const svgElement = svgDoc.documentElement;\r\n\r\n    await doc.svg(svgElement, {\r\n        x: margin,\r\n        y: margin,\r\n        width: pageWidth - margin * 2,\r\n        height: pageHeight - margin * 2\r\n    });\r\n\r\n    const blob = doc.output('blob');\r\n\r\n    if (options.fileName) {\r\n        doc.save(options.fileName);\r\n    }\r\n\r\n    return blob;\r\n}\r\n\r\n/**\r\n * Export an SVG string directly as a downloadable SVG file.\r\n */\r\nexport function printToSvgFile(svgMarkup: string, fileName: string): void {\r\n    const blob = new Blob([svgMarkup], { type: 'image/svg+xml' });\r\n    const url = URL.createObjectURL(blob);\r\n    const link = document.createElement('a');\r\n    link.href = url;\r\n    link.download = fileName;\r\n    link.click();\r\n    URL.revokeObjectURL(url);\r\n}\r\n\r\n// Compatibility wrappers for print-layout module\r\nexport interface ExportSectionToPdfOptions {\r\n    svgMarkup: string;\r\n    fileName: string;\r\n    pageSizeMm?: { width: number; height: number };\r\n    openInNewTab?: boolean;\r\n}\r\n\r\nexport async function exportSectionToPdf(options: ExportSectionToPdfOptions): Promise<void> {\r\n    await printToPdf({\r\n        svgMarkup: options.svgMarkup,\r\n        fileName: options.fileName\r\n    });\r\n}\r\n\r\nexport interface ExportSectionToSvgOptions {\r\n    svgMarkup: string;\r\n    fileName: string;\r\n    openInNewTab?: boolean;\r\n}\r\n\r\nexport function exportSectionToSvg(options: ExportSectionToSvgOptions): void {\r\n    if (options.openInNewTab) {\r\n        const blob = new Blob([options.svgMarkup], { type: 'image/svg+xml' });\r\n        const url = URL.createObjectURL(blob);\r\n        window.open(url, '_blank');\r\n        // Revoke after a delay to allow the new tab to load the blob\r\n        setTimeout(() => URL.revokeObjectURL(url), 60_000);\r\n    } else {\r\n        printToSvgFile(options.svgMarkup, options.fileName);\r\n    }\r\n}\r\n"]}

package/dist/printToSvg.d.ts

@@ -0,0 +1,11 @@
+import type { SlabSectionGeometry } from '@twinfinity/geometry';
+import type { PrintToSvgOptions } from './types';
+/**
+ * Render SlabSectionGeometry to an SVG string.
+ *
+ * @param geometry The computed slab section geometry
+ * @param options Rendering options (viewBox, styles, planeBasis, etc.)
+ * @returns Complete SVG string
+ */
+export declare function printToSvg(geometry: SlabSectionGeometry, options?: PrintToSvgOptions): string;
+//# sourceMappingURL=printToSvg.d.ts.map

package/dist/printToSvg.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"printToSvg.d.ts","sourceRoot":"/","sources":["printToSvg.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAQ,MAAM,sBAAsB,CAAC;AACtE,OAAO,KAAK,EAAE,iBAAiB,EAAkC,MAAM,SAAS,CAAC;AAMjF;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,mBAAmB,EAAE,OAAO,GAAE,iBAAsB,GAAG,MAAM,CA6EjG"}

package/dist/printToSvg.js

@@ -0,0 +1,168 @@
+import { DEFAULT_SVG_STYLES } from './types';
+/**
+ * Render SlabSectionGeometry to an SVG string.
+ *
+ * @param geometry The computed slab section geometry
+ * @param options Rendering options (viewBox, styles, planeBasis, etc.)
+ * @returns Complete SVG string
+ */
+export function printToSvg(geometry, options = {}) {
+    if (!geometry)
+        throw new Error('geometry is required');
+    if (options.boundsPadding !== undefined &&
+        (typeof options.boundsPadding !== 'number' || options.boundsPadding < 0)) {
+        throw new Error('boundsPadding must be a non-negative number');
+    }
+    if (options.viewBox) {
+        if (!Array.isArray(options.viewBox) || options.viewBox.length !== 4) {
+            throw new Error('viewBox must be an array of 4 numbers [minX, minY, width, height]');
+        }
+        for (let i = 0; i < 4; i++) {
+            if (typeof options.viewBox[i] !== 'number' || !Number.isFinite(options.viewBox[i])) {
+                throw new Error(`viewBox[${i}] must be a finite number`);
+            }
+        }
+    }
+    const styles = mergeStyles(options.styles);
+    const includeXml = options.includeXmlDeclaration ?? true;
+    // Project all polylines to 2D once
+    const proj = {
+        hiddenLines: projectPolylines(geometry.hiddenLines, options.planeBasis),
+        outlineHidden: projectPolylines(geometry.outlineHidden, options.planeBasis),
+        visibleLines: projectPolylines(geometry.visibleLines, options.planeBasis),
+        outlineVisible: projectPolylines(geometry.outlineVisible, options.planeBasis),
+        silhouettes: projectPolylines(geometry.silhouettes, options.planeBasis),
+        featureEdges: projectPolylines(geometry.featureEdges, options.planeBasis),
+        cutLines: projectPolylines(geometry.cutLines, options.planeBasis),
+        stairArrows: projectPolylines(geometry.stairArrows, options.planeBasis)
+    };
+    const bounds = options.bounds ?? computeBoundsFromProjected(proj);
+    const viewBox = options.viewBox ?? boundsToViewBox(bounds, options.boundsPadding ?? 0.05);
+    const parts = [];
+    if (includeXml)
+        parts.push('<?xml version="1.0" encoding="UTF-8"?>');
+    const [minX, minY, width, height] = viewBox;
+    parts.push(`<svg xmlns="http://www.w3.org/2000/svg" ` +
+        `viewBox="${minX} ${minY} ${width} ${height}" ` +
+        `width="${width}" height="${height}">`);
+    if (options.backgroundColor) {
+        parts.push(`<rect x="${minX}" y="${minY}" width="${width}" height="${height}" fill="${options.backgroundColor}"/>`);
+    }
+    parts.push('<g fill="none" stroke-linecap="round" stroke-linejoin="round">');
+    const categories = [
+        ['hiddenLines', 'hiddenLines'],
+        ['outlineHidden', 'outlineHidden'],
+        ['visibleLines', 'visibleLines'],
+        ['outlineVisible', 'outlineVisible'],
+        ['silhouettes', 'silhouettes'],
+        ['featureEdges', 'featureEdges'],
+        ['cutLines', 'cutLines'],
+        ['stairArrows', 'stairArrows']
+    ];
+    for (const [key, styleKey] of categories) {
+        const style = styles[styleKey];
+        if (style.enabled)
+            renderProjectedCategory(parts, proj[key], style, bounds);
+    }
+    parts.push('</g>');
+    parts.push('</svg>');
+    return parts.join('\n');
+}
+function projectPolylines(polylines, planeBasis) {
+    const result = [];
+    for (const polyline of polylines) {
+        if (polyline.length === 0)
+            continue;
+        const projected = [];
+        for (const point of polyline) {
+            if (!Number.isFinite(point[0]) || !Number.isFinite(point[1]) || !Number.isFinite(point[2]))
+                continue;
+            if (planeBasis) {
+                const dx = point[0] - planeBasis.origin.x;
+                const dy = point[1] - planeBasis.origin.y;
+                const dz = point[2] - planeBasis.origin.z;
+                projected.push({
+                    x: dx * planeBasis.right.x + dy * planeBasis.right.y + dz * planeBasis.right.z,
+                    y: dx * planeBasis.up.x + dy * planeBasis.up.y + dz * planeBasis.up.z
+                });
+            }
+            else {
+                projected.push({ x: point[0], y: -point[2] });
+            }
+        }
+        if (projected.length > 0)
+            result.push(projected);
+    }
+    return result;
+}
+function computeBoundsFromProjected(categories) {
+    let minX = Infinity, minY = Infinity, maxX = -Infinity, maxY = -Infinity;
+    for (const polylines of Object.values(categories)) {
+        for (const polyline of polylines) {
+            for (const pt of polyline) {
+                if (pt.x < minX)
+                    minX = pt.x;
+                if (pt.x > maxX)
+                    maxX = pt.x;
+                if (pt.y < minY)
+                    minY = pt.y;
+                if (pt.y > maxY)
+                    maxY = pt.y;
+            }
+        }
+    }
+    if (!Number.isFinite(minX))
+        return { minX: 0, maxX: 1, minY: 0, maxY: 1 };
+    return { minX, maxX, minY, maxY };
+}
+function renderProjectedCategory(parts, polylines, style, bounds) {
+    if (!polylines.length)
+        return;
+    const pathData = projectedToPathData(polylines, bounds);
+    if (!pathData)
+        return;
+    let pathElement = `<path d="${pathData}"`;
+    if (style.stroke)
+        pathElement += ` stroke="${style.stroke}"`;
+    if (style.strokeWidth !== undefined)
+        pathElement += ` stroke-width="${style.strokeWidth}"`;
+    if (style.strokeDasharray)
+        pathElement += ` stroke-dasharray="${style.strokeDasharray}"`;
+    if (style.opacity !== undefined && style.opacity !== 1)
+        pathElement += ` opacity="${style.opacity}"`;
+    pathElement += '/>';
+    parts.push(pathElement);
+}
+function projectedToPathData(polylines, bounds) {
+    const parts = [];
+    const ox = bounds.minX;
+    const oy = bounds.maxY;
+    for (const polyline of polylines) {
+        if (polyline.length === 0)
+            continue;
+        parts.push(`M ${(polyline[0].x - ox).toFixed(6)} ${(oy - polyline[0].y).toFixed(6)}`);
+        for (let i = 1; i < polyline.length; i++) {
+            parts.push(`L ${(polyline[i].x - ox).toFixed(6)} ${(oy - polyline[i].y).toFixed(6)}`);
+        }
+    }
+    return parts.join(' ');
+}
+function boundsToViewBox(bounds, padding) {
+    const width = bounds.maxX - bounds.minX;
+    const height = bounds.maxY - bounds.minY;
+    const padAmount = Math.max(width, height) * padding;
+    return [-padAmount, -padAmount, width + padAmount * 2, height + padAmount * 2];
+}
+function mergeStyles(userStyles) {
+    return {
+        cutLines: { ...DEFAULT_SVG_STYLES.cutLines, ...userStyles?.cutLines },
+        visibleLines: { ...DEFAULT_SVG_STYLES.visibleLines, ...userStyles?.visibleLines },
+        hiddenLines: { ...DEFAULT_SVG_STYLES.hiddenLines, ...userStyles?.hiddenLines },
+        silhouettes: { ...DEFAULT_SVG_STYLES.silhouettes, ...userStyles?.silhouettes },
+        featureEdges: { ...DEFAULT_SVG_STYLES.featureEdges, ...userStyles?.featureEdges },
+        stairArrows: { ...DEFAULT_SVG_STYLES.stairArrows, ...userStyles?.stairArrows },
+        outlineVisible: { ...DEFAULT_SVG_STYLES.outlineVisible, ...userStyles?.outlineVisible },
+        outlineHidden: { ...DEFAULT_SVG_STYLES.outlineHidden, ...userStyles?.outlineHidden }
+    };
+}
+//# sourceMappingURL=printToSvg.js.map

package/dist/printToSvg.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"printToSvg.js","sourceRoot":"/","sources":["printToSvg.ts"],"names":[],"mappings":"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","sourcesContent":["import type { SlabSectionGeometry, Vec3 } from '@twinfinity/geometry';\r\nimport type { PrintToSvgOptions, SvgRenderStyles, SvgPlaneBasis } from './types';\r\nimport { DEFAULT_SVG_STYLES } from './types';\r\n\r\ntype Pt2 = { x: number; y: number };\r\ntype Bounds = { minX: number; maxX: number; minY: number; maxY: number };\r\n\r\n/**\r\n * Render SlabSectionGeometry to an SVG string.\r\n *\r\n * @param geometry The computed slab section geometry\r\n * @param options Rendering options (viewBox, styles, planeBasis, etc.)\r\n * @returns Complete SVG string\r\n */\r\nexport function printToSvg(geometry: SlabSectionGeometry, options: PrintToSvgOptions = {}): string {\r\n    if (!geometry) throw new Error('geometry is required');\r\n\r\n    if (\r\n        options.boundsPadding !== undefined &&\r\n        (typeof options.boundsPadding !== 'number' || options.boundsPadding < 0)\r\n    ) {\r\n        throw new Error('boundsPadding must be a non-negative number');\r\n    }\r\n\r\n    if (options.viewBox) {\r\n        if (!Array.isArray(options.viewBox) || options.viewBox.length !== 4) {\r\n            throw new Error('viewBox must be an array of 4 numbers [minX, minY, width, height]');\r\n        }\r\n        for (let i = 0; i < 4; i++) {\r\n            if (typeof options.viewBox[i] !== 'number' || !Number.isFinite(options.viewBox[i])) {\r\n                throw new Error(`viewBox[${i}] must be a finite number`);\r\n            }\r\n        }\r\n    }\r\n\r\n    const styles = mergeStyles(options.styles);\r\n    const includeXml = options.includeXmlDeclaration ?? true;\r\n\r\n    // Project all polylines to 2D once\r\n    const proj = {\r\n        hiddenLines: projectPolylines(geometry.hiddenLines, options.planeBasis),\r\n        outlineHidden: projectPolylines(geometry.outlineHidden, options.planeBasis),\r\n        visibleLines: projectPolylines(geometry.visibleLines, options.planeBasis),\r\n        outlineVisible: projectPolylines(geometry.outlineVisible, options.planeBasis),\r\n        silhouettes: projectPolylines(geometry.silhouettes, options.planeBasis),\r\n        featureEdges: projectPolylines(geometry.featureEdges, options.planeBasis),\r\n        cutLines: projectPolylines(geometry.cutLines, options.planeBasis),\r\n        stairArrows: projectPolylines(geometry.stairArrows, options.planeBasis)\r\n    };\r\n\r\n    const bounds = options.bounds ?? computeBoundsFromProjected(proj);\r\n    const viewBox = options.viewBox ?? boundsToViewBox(bounds, options.boundsPadding ?? 0.05);\r\n\r\n    const parts: string[] = [];\r\n\r\n    if (includeXml) parts.push('<?xml version=\"1.0\" encoding=\"UTF-8\"?>');\r\n\r\n    const [minX, minY, width, height] = viewBox;\r\n    parts.push(\r\n        `<svg xmlns=\"http://www.w3.org/2000/svg\" ` +\r\n            `viewBox=\"${minX} ${minY} ${width} ${height}\" ` +\r\n            `width=\"${width}\" height=\"${height}\">`\r\n    );\r\n\r\n    if (options.backgroundColor) {\r\n        parts.push(\r\n            `<rect x=\"${minX}\" y=\"${minY}\" width=\"${width}\" height=\"${height}\" fill=\"${options.backgroundColor}\"/>`\r\n        );\r\n    }\r\n\r\n    parts.push('<g fill=\"none\" stroke-linecap=\"round\" stroke-linejoin=\"round\">');\r\n\r\n    const categories: Array<[keyof typeof proj, keyof Required<SvgRenderStyles>]> = [\r\n        ['hiddenLines', 'hiddenLines'],\r\n        ['outlineHidden', 'outlineHidden'],\r\n        ['visibleLines', 'visibleLines'],\r\n        ['outlineVisible', 'outlineVisible'],\r\n        ['silhouettes', 'silhouettes'],\r\n        ['featureEdges', 'featureEdges'],\r\n        ['cutLines', 'cutLines'],\r\n        ['stairArrows', 'stairArrows']\r\n    ];\r\n\r\n    for (const [key, styleKey] of categories) {\r\n        const style = styles[styleKey];\r\n        if (style.enabled) renderProjectedCategory(parts, proj[key], style, bounds);\r\n    }\r\n\r\n    parts.push('</g>');\r\n    parts.push('</svg>');\r\n    return parts.join('\\n');\r\n}\r\n\r\nfunction projectPolylines(polylines: Vec3[][], planeBasis?: SvgPlaneBasis): Pt2[][] {\r\n    const result: Pt2[][] = [];\r\n    for (const polyline of polylines) {\r\n        if (polyline.length === 0) continue;\r\n        const projected: Pt2[] = [];\r\n        for (const point of polyline) {\r\n            if (!Number.isFinite(point[0]) || !Number.isFinite(point[1]) || !Number.isFinite(point[2])) continue;\r\n            if (planeBasis) {\r\n                const dx = point[0] - planeBasis.origin.x;\r\n                const dy = point[1] - planeBasis.origin.y;\r\n                const dz = point[2] - planeBasis.origin.z;\r\n                projected.push({\r\n                    x: dx * planeBasis.right.x + dy * planeBasis.right.y + dz * planeBasis.right.z,\r\n                    y: dx * planeBasis.up.x + dy * planeBasis.up.y + dz * planeBasis.up.z\r\n                });\r\n            } else {\r\n                projected.push({ x: point[0], y: -point[2] });\r\n            }\r\n        }\r\n        if (projected.length > 0) result.push(projected);\r\n    }\r\n    return result;\r\n}\r\n\r\nfunction computeBoundsFromProjected(categories: Record<string, Pt2[][]>): Bounds {\r\n    let minX = Infinity,\r\n        minY = Infinity,\r\n        maxX = -Infinity,\r\n        maxY = -Infinity;\r\n    for (const polylines of Object.values(categories)) {\r\n        for (const polyline of polylines) {\r\n            for (const pt of polyline) {\r\n                if (pt.x < minX) minX = pt.x;\r\n                if (pt.x > maxX) maxX = pt.x;\r\n                if (pt.y < minY) minY = pt.y;\r\n                if (pt.y > maxY) maxY = pt.y;\r\n            }\r\n        }\r\n    }\r\n    if (!Number.isFinite(minX)) return { minX: 0, maxX: 1, minY: 0, maxY: 1 };\r\n    return { minX, maxX, minY, maxY };\r\n}\r\n\r\nfunction renderProjectedCategory(\r\n    parts: string[],\r\n    polylines: Pt2[][],\r\n    style: { stroke?: string; strokeWidth?: number; strokeDasharray?: string; opacity?: number },\r\n    bounds: Bounds\r\n): void {\r\n    if (!polylines.length) return;\r\n    const pathData = projectedToPathData(polylines, bounds);\r\n    if (!pathData) return;\r\n\r\n    let pathElement = `<path d=\"${pathData}\"`;\r\n    if (style.stroke) pathElement += ` stroke=\"${style.stroke}\"`;\r\n    if (style.strokeWidth !== undefined) pathElement += ` stroke-width=\"${style.strokeWidth}\"`;\r\n    if (style.strokeDasharray) pathElement += ` stroke-dasharray=\"${style.strokeDasharray}\"`;\r\n    if (style.opacity !== undefined && style.opacity !== 1) pathElement += ` opacity=\"${style.opacity}\"`;\r\n    pathElement += '/>';\r\n    parts.push(pathElement);\r\n}\r\n\r\nfunction projectedToPathData(polylines: Pt2[][], bounds: Bounds): string {\r\n    const parts: string[] = [];\r\n    const ox = bounds.minX;\r\n    const oy = bounds.maxY;\r\n    for (const polyline of polylines) {\r\n        if (polyline.length === 0) continue;\r\n        parts.push(`M ${(polyline[0].x - ox).toFixed(6)} ${(oy - polyline[0].y).toFixed(6)}`);\r\n        for (let i = 1; i < polyline.length; i++) {\r\n            parts.push(`L ${(polyline[i].x - ox).toFixed(6)} ${(oy - polyline[i].y).toFixed(6)}`);\r\n        }\r\n    }\r\n    return parts.join(' ');\r\n}\r\n\r\nfunction boundsToViewBox(bounds: Bounds, padding: number): [number, number, number, number] {\r\n    const width = bounds.maxX - bounds.minX;\r\n    const height = bounds.maxY - bounds.minY;\r\n    const padAmount = Math.max(width, height) * padding;\r\n    return [-padAmount, -padAmount, width + padAmount * 2, height + padAmount * 2];\r\n}\r\n\r\nfunction mergeStyles(userStyles?: SvgRenderStyles): Required<SvgRenderStyles> {\r\n    return {\r\n        cutLines: { ...DEFAULT_SVG_STYLES.cutLines, ...userStyles?.cutLines },\r\n        visibleLines: { ...DEFAULT_SVG_STYLES.visibleLines, ...userStyles?.visibleLines },\r\n        hiddenLines: { ...DEFAULT_SVG_STYLES.hiddenLines, ...userStyles?.hiddenLines },\r\n        silhouettes: { ...DEFAULT_SVG_STYLES.silhouettes, ...userStyles?.silhouettes },\r\n        featureEdges: { ...DEFAULT_SVG_STYLES.featureEdges, ...userStyles?.featureEdges },\r\n        stairArrows: { ...DEFAULT_SVG_STYLES.stairArrows, ...userStyles?.stairArrows },\r\n        outlineVisible: { ...DEFAULT_SVG_STYLES.outlineVisible, ...userStyles?.outlineVisible },\r\n        outlineHidden: { ...DEFAULT_SVG_STYLES.outlineHidden, ...userStyles?.outlineHidden }\r\n    };\r\n}\r\n"]}

package/dist/sections.d.ts

@@ -0,0 +1,118 @@
+import type { Vec3, SectionLabel, SectionPath, SectionRenderState, TransformInfo, ViewWindow } from '@twinfinity/geometry';
+export type { SectionLabel, SectionPath, SectionRenderState, TransformInfo, ViewWindow } from '@twinfinity/geometry';
+/** Minimal product interface for section fill matching. */
+interface SectionProduct {
+    class?: {
+        is(c: unknown): boolean;
+        type?: string;
+        id?: string;
+    };
+    className?: string;
+    propertySets?: Record<string, unknown>;
+    properties?: {
+        data?: Record<string, unknown>;
+        sets?: Record<string, unknown>;
+    };
+}
+/** Local replacement for PlaneSectionEntry (not available in @twinfinity/geometry). */
+type PlaneSectionEntry<TProduct extends SectionProduct = SectionProduct> = {
+    product: TProduct;
+    segments: [Vec3, Vec3][];
+    polylines: {
+        points: Vec3[];
+        closed: boolean;
+    }[];
+};
+/**
+ * Resolve a dotted property path (e.g. "BIP.spacetype") against a product.
+ * Handles both the new T8 API (propertySets → .properties → .value) and
+ * legacy BimIfcObject (properties.sets / properties.data).
+ *
+ * Returns the resolved value, or undefined if not found.
+ */
+export declare function resolveProductProperty(product: SectionProduct | unknown, path: string): unknown;
+/** Base SVG display width in layout units. */
+export declare const BASE_WIDTH = 240;
+/** Minimum SVG display height in layout units. */
+export declare const MIN_HEIGHT = 140;
+/** Margin ratio applied around section bounds (fraction of world extent). */
+export declare const SECTION_MARGIN_RATIO = 0.05;
+/** Maximum zoom factor for viewport clamping. */
+export declare const MAX_ZOOM_FACTOR = 12;
+/** Multiplicative step for zooming in. */
+export declare const ZOOM_IN_STEP = 0.8;
+/** Multiplicative step for zooming out. */
+export declare const ZOOM_OUT_STEP: number;
+/** Clamp a number to a min/max range. */
+export declare function clampValue(value: number, min: number, max: number): number;
+export interface SectionBuildOptions {
+    /** If true, attach source product metadata to paths/labels for downstream filtering */
+    includeMeta?: boolean;
+    /** When true, create fill paths for closed polygons. When false, create only stroke/outline paths. Defaults to true for backward compatibility. */
+    createFills?: boolean;
+    /** Plane normal vector for determining 2D projection axes. If omitted, defaults to horizontal plan (Y-up). */
+    planeNormal?: Vec3;
+}
+/** Default fill opacity when a fill rule omits `fillOpacity`. */
+export declare const DEFAULT_FILL_OPACITY = 0.35;
+/**
+ * Fill rule controlling which products get visible fills and at what opacity.
+ * Mirrors the template-level FillRule but kept minimal to avoid circular deps.
+ */
+export interface SectionFillRule {
+    /** IFC class filter. When omitted, matches all products. */
+    class?: string | string[];
+    /** Property-based filter (e.g. { "BIP.spacetype": "ROOM" }). */
+    where?: Record<string, string | number | boolean | Array<string | number>>;
+    /** Fill opacity (0–1). Default: {@link DEFAULT_FILL_OPACITY}. */
+    fillOpacity?: number;
+    /** When true, only apply fill to products whose centroid is inside the clip polygon. @default false */
+    matchClipFilter?: boolean;
+}
+export interface BuildSectionStateOptions {
+    viewport?: ViewWindow;
+    strokeWidth?: number;
+    labelFontSize?: number;
+    /**
+     * Fill rules controlling which products get visible fills and at what opacity.
+     * Products matching a fill rule are rendered below non-matching products.
+     * When absent or empty, all products render uniformly (no fill-based reordering).
+     */
+    fills?: SectionFillRule[];
+    includeMeta?: boolean;
+    /** Enable labels. Requires buildLabels callback. */
+    includeLabels?: boolean;
+    /** Callback to build labels for matching products. Required when includeLabels is true. */
+    buildLabels?: (products: any[], fontSize: number) => SectionLabel[];
+    /** Clip polygon in world coordinates (x, z). Used when fill.matchClipFilter is true for spatial filtering. */
+    clipPolygon?: Array<Array<{
+        x: number;
+        z: number;
+    }>>;
+    /** When true, create fill paths for closed polygons. When false, create only stroke/outline paths. Defaults to true for backward compatibility. */
+    createFills?: boolean;
+    /** Plane normal vector for determining 2D projection axes. If omitted, defaults to horizontal plan (Y-up). */
+    planeNormal?: Vec3;
+}
+/** Convert plane section polylines to SVG path data with fill colors and stroke styles. */
+export declare function createSectionSvg(perProduct: PlaneSectionEntry[], viewport?: ViewWindow, strokeWidthHint?: number, labels?: SectionLabel[], options?: SectionBuildOptions): SectionRenderState | null;
+/**
+ * Build a complete SectionRenderState from plane section entries, with optional
+ * fill-rule-based separation, ordering, and label generation.
+ *
+ * When `fills` rules are provided, entries matching a fill rule are rendered
+ * below non-matching entries, with their fill opacity set by the matching rule.
+ */
+export declare function buildSectionStateForEntries(perProduct: PlaneSectionEntry[], options: BuildSectionStateOptions): (SectionRenderState & {
+    rawPaths?: SectionPath[];
+    rawLabels?: SectionLabel[];
+}) | null;
+/** Extract the viewport bounding box from a TransformInfo. */
+export declare function extractViewWindow(transform: TransformInfo): ViewWindow;
+/** Compare two viewport windows for equality within a tolerance. */
+export declare function windowsEqual(a: ViewWindow, b: ViewWindow, epsilon?: number): boolean;
+/** Constrain a viewport window within base bounds, preserving aspect ratio. */
+export declare function clampViewWindow(base: TransformInfo, candidate: ViewWindow): ViewWindow;
+/** Adjust stroke width proportionally to zoom level. */
+export declare function strokeWidthForWindow(baseStroke: number, baseTransform: TransformInfo, window: ViewWindow): number;
+//# sourceMappingURL=sections.d.ts.map

package/dist/sections.d.ts.map

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