@twinfinity/printing 6.0.1-ci.28952-beta → 6.0.2-beta

package/src/layout/itemBuilders.ts

@@ -1,159 +1,159 @@
-import type { SectionRenderState } from '@twinfinity/geometry';
-import { normalizePropertySets } from './metadata';
-import { getPathValue } from './renderUtils';
-import { buildModelViewFromRaw } from './model';
-import { ProductFieldPaths, NormalizedProductItem, SvgModelView, LabelStyle } from './types';
-
-import { getProp } from './typeGuards';
-
-export interface ProductLike {
-    product?: any;
-    polylines?: Array<{ points?: Array<{ x: number; z: number }> }>;
-}
-
-export interface BuildViewportItemsOptions {
-    productFields?: ProductFieldPaths;
-}
-
-/**
- * Normalize a single product entry using explicit field paths.
- */
-export const normalizeProductEntry = (entry: ProductLike, productFields: ProductFieldPaths): NormalizedProductItem => {
-    if (!productFields?.idPath || !productFields?.namePath || !productFields?.areaPath) {
-        throw new Error(
-            'productFields must include idPath, namePath, and areaPath using propertySets.<Set>.<Prop>.value.'
-        );
-    }
-    const product = getProp(entry, 'product') ?? entry;
-    const propertySets = normalizePropertySets(product);
-    const getVal = (path: string): unknown => getPathValue({ propertySets }, path);
-    const idVal = getVal(productFields.idPath) ?? getProp(product, 'gid');
-    const nameVal = getVal(productFields.namePath);
-    const areaVal = getVal(productFields.areaPath);
-    // class.type = IfcClassType ("space", "walls", etc.) — used by template filters
-    // class.id = PredefinedIfcClassId ("IfcSpace", "IfcWall", etc.) — used as fallback
-    // classPath from propertySets may contain a PredefinedIfcClassId
-    const classPathVal = productFields.classPath ? getVal(productFields.classPath) : null;
-    const productClass = getProp(product, 'class');
-    const classType = getProp(productClass, 'type') as string | null; // IfcClassType
-    const classId = getProp(productClass, 'id') as string | null; // PredefinedIfcClassId
-    // ifcClass = IfcClassType category; ifcClassId = PredefinedIfcClassId
-    const ifcClass = (classType ?? null) as string | null;
-    const ifcClassId = (classPathVal ?? classId ?? null) as string | null;
-    // Try multiple sources for coordinates:
-    // 1. BBox center from product
-    // 2. Polylines center from entry
-    // 3. Direct x/z on entry or product
-    let { x, z } = getBBoxCenter(product);
-    if (x === null || z === null) {
-        const polyCenter = computePolylinesCenter(entry);
-        x = polyCenter.x ?? x;
-        z = polyCenter.z ?? z;
-    }
-    if (x === null || z === null) {
-        const directX = getProp(entry, 'x') ?? getProp(product, 'x');
-        const directZ = getProp(entry, 'z') ?? getProp(product, 'z');
-        if (Number.isFinite(directX)) x = directX as number;
-        if (Number.isFinite(directZ)) z = directZ as number;
-    }
-    const rawPolylines = getProp(entry, 'polylines');
-    return {
-        gid: getProp(product, 'gid') as string | undefined,
-        ifcClass,
-        ifcClassId,
-        propertySets,
-        productId: idVal ? String(idVal) : '-',
-        productName: typeof nameVal === 'string' && nameVal.trim().length ? nameVal.trim() : '-',
-        area: typeof areaVal === 'number' && Number.isFinite(areaVal) ? areaVal : null,
-        x,
-        z,
-        text: typeof nameVal === 'string' && nameVal.trim().length ? nameVal.trim() : '-',
-        polylines: Array.isArray(rawPolylines) ? rawPolylines : undefined
-    };
-};
-
-const getBBoxCenter = (product: unknown): { x: number | null; z: number | null } => {
-    try {
-        const boundingInfo = getProp(product, 'boundingInfo');
-        const boundingInfoResult = typeof boundingInfo === 'function' ? boundingInfo() : null;
-        const bbox = getProp(boundingInfoResult, 'boundingBox');
-        const min = getProp(bbox, 'minimumWorld') ?? getProp(bbox, 'minimum');
-        const max = getProp(bbox, 'maximumWorld') ?? getProp(bbox, 'maximum');
-        const minX = getProp(min, 'x');
-        const maxX = getProp(max, 'x');
-        const minZ = getProp(min, 'z');
-        const maxZ = getProp(max, 'z');
-        if (Number.isFinite(minX) && Number.isFinite(maxX) && Number.isFinite(minZ) && Number.isFinite(maxZ)) {
-            return { x: ((minX as number) + (maxX as number)) * 0.5, z: ((minZ as number) + (maxZ as number)) * 0.5 };
-        }
-    } catch {
-        // Bounding info access may fail for products without geometry or with malformed data structures.
-        // This is expected behavior - we return null coordinates as fallback.
-    }
-    return { x: null, z: null };
-};
-
-export const computePolylinesCenter = (entry: unknown): { x: number | null; z: number | null } => {
-    try {
-        const polylines = getProp(entry, 'polylines');
-        if (!Array.isArray(polylines) || !polylines.length) {
-            return { x: null, z: null };
-        }
-        let sumX = 0;
-        let sumZ = 0;
-        let count = 0;
-        for (const polyline of polylines) {
-            const points = getProp(polyline, 'points');
-            if (!Array.isArray(points)) continue;
-            for (const pt of points) {
-                const px = getProp(pt, 'x');
-                const pz = getProp(pt, 'z');
-                if (Number.isFinite(px) && Number.isFinite(pz)) {
-                    sumX += px as number;
-                    sumZ += pz as number;
-                    count++;
-                }
-            }
-        }
-        if (count > 0) {
-            return { x: sumX / count, z: sumZ / count };
-        }
-    } catch {
-        // Polyline access may fail - return null
-    }
-    return { x: null, z: null };
-};
-
-/**
- * Normalize raw product entries into viewport items using explicit field paths.
- * Requires productFields (id/name/area/class) pointing to propertySets.<Set>.<Prop>.value.
- */
-export const buildViewportItems = (
-    entries: ProductLike[],
-    options?: BuildViewportItemsOptions
-): NormalizedProductItem[] => {
-    if (!options?.productFields) {
-        throw new Error('buildViewportItems requires productFields (idPath/namePath/areaPath/classPath).');
-    }
-    const { idPath, namePath, areaPath } = options.productFields;
-    if (!idPath || !namePath || !areaPath) {
-        throw new Error(
-            'productFields must include idPath, namePath, and areaPath using propertySets.<Set>.<Prop>.value.'
-        );
-    }
-    return (entries ?? []).map((entry: any) => normalizeProductEntry(entry, options.productFields!));
-};
-
-export function sectionStateToModelView(state: SectionRenderState, labelStyle?: LabelStyle): SvgModelView {
-    const model = buildModelViewFromRaw(
-        state.paths,
-        state.labels,
-        state.transform,
-        state.geometryTransform,
-        labelStyle
-    );
-    if (!model) {
-        throw new Error('sectionStateToModelView requires paths, transform, and geometryTransform.');
-    }
-    return model;
-}
+import type { SectionRenderState } from '@twinfinity/geometry';
+import { normalizePropertySets } from './metadata';
+import { getPathValue } from './renderUtils';
+import { buildModelViewFromRaw } from './model';
+import { ProductFieldPaths, NormalizedProductItem, SvgModelView, LabelStyle } from './types';
+
+import { getProp } from './typeGuards';
+
+export interface ProductLike {
+    product?: any;
+    polylines?: Array<{ points?: Array<{ x: number; z: number }> }>;
+}
+
+export interface BuildViewportItemsOptions {
+    productFields?: ProductFieldPaths;
+}
+
+/**
+ * Normalize a single product entry using explicit field paths.
+ */
+export const normalizeProductEntry = (entry: ProductLike, productFields: ProductFieldPaths): NormalizedProductItem => {
+    if (!productFields?.idPath || !productFields?.namePath || !productFields?.areaPath) {
+        throw new Error(
+            'productFields must include idPath, namePath, and areaPath using propertySets.<Set>.<Prop>.value.'
+        );
+    }
+    const product = getProp(entry, 'product') ?? entry;
+    const propertySets = normalizePropertySets(product);
+    const getVal = (path: string): unknown => getPathValue({ propertySets }, path);
+    const idVal = getVal(productFields.idPath) ?? getProp(product, 'gid');
+    const nameVal = getVal(productFields.namePath);
+    const areaVal = getVal(productFields.areaPath);
+    // class.type = IfcClassType ("space", "walls", etc.) — used by template filters
+    // class.id = PredefinedIfcClassId ("IfcSpace", "IfcWall", etc.) — used as fallback
+    // classPath from propertySets may contain a PredefinedIfcClassId
+    const classPathVal = productFields.classPath ? getVal(productFields.classPath) : null;
+    const productClass = getProp(product, 'class');
+    const classType = getProp(productClass, 'type') as string | null; // IfcClassType
+    const classId = getProp(productClass, 'id') as string | null; // PredefinedIfcClassId
+    // ifcClass = IfcClassType category; ifcClassId = PredefinedIfcClassId
+    const ifcClass = (classType ?? null) as string | null;
+    const ifcClassId = (classPathVal ?? classId ?? null) as string | null;
+    // Try multiple sources for coordinates:
+    // 1. BBox center from product
+    // 2. Polylines center from entry
+    // 3. Direct x/z on entry or product
+    let { x, z } = getBBoxCenter(product);
+    if (x === null || z === null) {
+        const polyCenter = computePolylinesCenter(entry);
+        x = polyCenter.x ?? x;
+        z = polyCenter.z ?? z;
+    }
+    if (x === null || z === null) {
+        const directX = getProp(entry, 'x') ?? getProp(product, 'x');
+        const directZ = getProp(entry, 'z') ?? getProp(product, 'z');
+        if (Number.isFinite(directX)) x = directX as number;
+        if (Number.isFinite(directZ)) z = directZ as number;
+    }
+    const rawPolylines = getProp(entry, 'polylines');
+    return {
+        gid: getProp(product, 'gid') as string | undefined,
+        ifcClass,
+        ifcClassId,
+        propertySets,
+        productId: idVal ? String(idVal) : '-',
+        productName: typeof nameVal === 'string' && nameVal.trim().length ? nameVal.trim() : '-',
+        area: typeof areaVal === 'number' && Number.isFinite(areaVal) ? areaVal : null,
+        x,
+        z,
+        text: typeof nameVal === 'string' && nameVal.trim().length ? nameVal.trim() : '-',
+        polylines: Array.isArray(rawPolylines) ? rawPolylines : undefined
+    };
+};
+
+const getBBoxCenter = (product: unknown): { x: number | null; z: number | null } => {
+    try {
+        const boundingInfo = getProp(product, 'boundingInfo');
+        const boundingInfoResult = typeof boundingInfo === 'function' ? boundingInfo() : null;
+        const bbox = getProp(boundingInfoResult, 'boundingBox');
+        const min = getProp(bbox, 'minimumWorld') ?? getProp(bbox, 'minimum');
+        const max = getProp(bbox, 'maximumWorld') ?? getProp(bbox, 'maximum');
+        const minX = getProp(min, 'x');
+        const maxX = getProp(max, 'x');
+        const minZ = getProp(min, 'z');
+        const maxZ = getProp(max, 'z');
+        if (Number.isFinite(minX) && Number.isFinite(maxX) && Number.isFinite(minZ) && Number.isFinite(maxZ)) {
+            return { x: ((minX as number) + (maxX as number)) * 0.5, z: ((minZ as number) + (maxZ as number)) * 0.5 };
+        }
+    } catch {
+        // Bounding info access may fail for products without geometry or with malformed data structures.
+        // This is expected behavior - we return null coordinates as fallback.
+    }
+    return { x: null, z: null };
+};
+
+export const computePolylinesCenter = (entry: unknown): { x: number | null; z: number | null } => {
+    try {
+        const polylines = getProp(entry, 'polylines');
+        if (!Array.isArray(polylines) || !polylines.length) {
+            return { x: null, z: null };
+        }
+        let sumX = 0;
+        let sumZ = 0;
+        let count = 0;
+        for (const polyline of polylines) {
+            const points = getProp(polyline, 'points');
+            if (!Array.isArray(points)) continue;
+            for (const pt of points) {
+                const px = getProp(pt, 'x');
+                const pz = getProp(pt, 'z');
+                if (Number.isFinite(px) && Number.isFinite(pz)) {
+                    sumX += px as number;
+                    sumZ += pz as number;
+                    count++;
+                }
+            }
+        }
+        if (count > 0) {
+            return { x: sumX / count, z: sumZ / count };
+        }
+    } catch {
+        // Polyline access may fail - return null
+    }
+    return { x: null, z: null };
+};
+
+/**
+ * Normalize raw product entries into viewport items using explicit field paths.
+ * Requires productFields (id/name/area/class) pointing to propertySets.<Set>.<Prop>.value.
+ */
+export const buildViewportItems = (
+    entries: ProductLike[],
+    options?: BuildViewportItemsOptions
+): NormalizedProductItem[] => {
+    if (!options?.productFields) {
+        throw new Error('buildViewportItems requires productFields (idPath/namePath/areaPath/classPath).');
+    }
+    const { idPath, namePath, areaPath } = options.productFields;
+    if (!idPath || !namePath || !areaPath) {
+        throw new Error(
+            'productFields must include idPath, namePath, and areaPath using propertySets.<Set>.<Prop>.value.'
+        );
+    }
+    return (entries ?? []).map((entry: any) => normalizeProductEntry(entry, options.productFields!));
+};
+
+export function sectionStateToModelView(state: SectionRenderState, labelStyle?: LabelStyle): SvgModelView {
+    const model = buildModelViewFromRaw(
+        state.paths,
+        state.labels,
+        state.transform,
+        state.geometryTransform,
+        labelStyle
+    );
+    if (!model) {
+        throw new Error('sectionStateToModelView requires paths, transform, and geometryTransform.');
+    }
+    return model;
+}