@treasuryspatial/viewer-kit 0.2.39 → 0.2.41

package/dist/engine/ViewerEngine.d.ts

@@ -20,6 +20,7 @@ export declare class ViewerEngine {
     private lastWidth;
     private lastHeight;
     private maxPixelRatio;
+    private hasDominantGroundPlane;
     constructor(options: ViewerCreateOptions);
     getHandle(): ViewerHandle;
     private invalidate;

package/dist/engine/ViewerEngine.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ViewerEngine.d.ts","sourceRoot":"","sources":["../../src/engine/ViewerEngine.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAiB,WAAW,EAAiB,sBAAsB,EAAE,mBAAmB,EAAmB,YAAY,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAQrK,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,iBAAiB,CAAiB;IAE1D,OAAO,CAAC,SAAS,CAAc;IAC/B,OAAO,CAAC,QAAQ,CAAsB;IACtC,OAAO,CAAC,KAAK,CAAc;IAC3B,OAAO,CAAC,MAAM,CAA0B;IACxC,OAAO,CAAC,QAAQ,CAAgB;IAChC,OAAO,CAAC,SAAS,CAAc;IAC/B,OAAO,CAAC,WAAW,CAA2B;IAE9C,OAAO,CAAC,iBAAiB,CAAoB;IAC7C,OAAO,CAAC,cAAc,CAAiB;IACvC,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,iBAAiB,CAAU;IAEnC,OAAO,CAAC,OAAO,CAAgB;IAC/B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,cAAc,CAAuB;IAC7C,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,aAAa,CAAS;gBAElB,OAAO,EAAE,mBAAmB;IAwDxC,SAAS,IAAI,YAAY;IA0BzB,OAAO,CAAC,UAAU;IAKlB,KAAK,IAAI,IAAI;IAiBb,IAAI,IAAI,IAAI;IAQZ,MAAM,IAAI,IAAI;IAcd,OAAO,IAAI,IAAI;IAef,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAIjC,gBAAgB,CAAC,MAAM,EAAE,sBAAsB,GAAG,IAAI;IAStD,YAAY,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI;IAoDjC,SAAS,CAAC,KAAK,EAAE,OAAO,CAAC,WAAW,CAAC,GAAG,IAAI;IAuB5C,cAAc,IAAI,WAAW;IAUvB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAmCjC,WAAW,IAAI,cAAc;IAe7B,OAAO,CAAC,YAAY;IAuCpB,OAAO,CAAC,WAAW;IAyBnB,OAAO,CAAC,aAAa;CAKtB"}
+{"version":3,"file":"ViewerEngine.d.ts","sourceRoot":"","sources":["../../src/engine/ViewerEngine.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAiB,WAAW,EAAiB,sBAAsB,EAAE,mBAAmB,EAAmB,YAAY,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAQrK,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,iBAAiB,CAAiB;IAE1D,OAAO,CAAC,SAAS,CAAc;IAC/B,OAAO,CAAC,QAAQ,CAAsB;IACtC,OAAO,CAAC,KAAK,CAAc;IAC3B,OAAO,CAAC,MAAM,CAA0B;IACxC,OAAO,CAAC,QAAQ,CAAgB;IAChC,OAAO,CAAC,SAAS,CAAc;IAC/B,OAAO,CAAC,WAAW,CAA2B;IAE9C,OAAO,CAAC,iBAAiB,CAAoB;IAC7C,OAAO,CAAC,cAAc,CAAiB;IACvC,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,iBAAiB,CAAU;IAEnC,OAAO,CAAC,OAAO,CAAgB;IAC/B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,cAAc,CAAuB;IAC7C,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,aAAa,CAAS;IAE9B,OAAO,CAAC,sBAAsB;gBAiClB,OAAO,EAAE,mBAAmB;IAwDxC,SAAS,IAAI,YAAY;IA0BzB,OAAO,CAAC,UAAU;IAKlB,KAAK,IAAI,IAAI;IAiBb,IAAI,IAAI,IAAI;IAQZ,MAAM,IAAI,IAAI;IAcd,OAAO,IAAI,IAAI;IAef,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAIjC,gBAAgB,CAAC,MAAM,EAAE,sBAAsB,GAAG,IAAI;IAStD,YAAY,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI;IA8DjC,SAAS,CAAC,KAAK,EAAE,OAAO,CAAC,WAAW,CAAC,GAAG,IAAI;IAuB5C,cAAc,IAAI,WAAW;IAUvB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAmCjC,WAAW,IAAI,cAAc;IAe7B,OAAO,CAAC,YAAY;IAuCpB,OAAO,CAAC,WAAW;IAyBnB,OAAO,CAAC,aAAa;CAKtB"}

package/dist/engine/ViewerEngine.js

@@ -27,6 +27,41 @@ export class ViewerEngine {
     lastWidth;
     lastHeight;
     maxPixelRatio;
+    hasDominantGroundPlane(root, bounds) {
+        if (!bounds || bounds.isEmpty())
+            return false;
+        const size = new THREE.Vector3();
+        bounds.getSize(size);
+        const planSpan = Math.max(size.x, size.z);
+        const minY = bounds.min.y;
+        const heightThreshold = Math.max(0.05, size.y * 0.02);
+        const planThreshold = planSpan * 0.7;
+        let detected = false;
+        root.updateMatrixWorld(true);
+        root.traverse((object) => {
+            if (detected)
+                return;
+            const mesh = object;
+            if (!mesh.isMesh || !mesh.geometry)
+                return;
+            const geometry = mesh.geometry;
+            geometry.computeBoundingBox();
+            const bbox = geometry.boundingBox?.clone();
+            if (!bbox)
+                return;
+            bbox.applyMatrix4(mesh.matrixWorld);
+            const spanX = bbox.max.x - bbox.min.x;
+            const spanZ = bbox.max.z - bbox.min.z;
+            const spanY = bbox.max.y - bbox.min.y;
+            const nearFloor = Math.abs(bbox.min.y - minY) <= heightThreshold * 1.5;
+            const flat = spanY <= heightThreshold;
+            const large = spanX >= planThreshold && spanZ >= planThreshold;
+            if (nearFloor && flat && large) {
+                detected = true;
+            }
+        });
+        return detected;
+    }
     constructor(options) {
         this.container = options.container;
         const basePresets = options.presets ?? DEFAULT_PRESETS;
@@ -205,7 +240,17 @@ export class ViewerEngine {
         // Re-apply scene extras (ground/grid) to match updated bounds.
         try {
             const preset = this.resolvePreset(this.presetId);
-            this.debugSystem.apply(preset, this.sceneBounds);
+            const disableGround = this.hasDominantGroundPlane(this.rootGroup, this.sceneBounds);
+            const debugPreset = disableGround
+                ? {
+                    ...preset,
+                    sceneExtras: {
+                        ...(preset.sceneExtras ?? {}),
+                        ground: false,
+                    },
+                }
+                : preset;
+            this.debugSystem.apply(debugPreset, this.sceneBounds);
         }
         catch {
             // ignore debug system failures

package/dist/index.d.ts

@@ -2,6 +2,8 @@ export type { ViewerCreateOptions, ViewerHandle, ViewerRuntime, ViewerSnapshot,
 export type { CameraFrameConfig, CameraFrameMode, CameraNormalizationConfig, CameraNormalizationResult, } from "./camera";
 export { createViewer } from "./engine/createViewer";
 export { computeCameraFrame, normalizeObject3d } from "./camera";
+export type { CameraRigConfig, SceneStats, ApplyGroupToViewerOptions, ApplyGroupToViewerResult, RoomHeights, } from "./scene";
+export { DEFAULT_CAMERA_RIG, applyGroupToViewer, computeSceneStats, resolveRoomHeights, setCameraToBounds, setCameraTopDown, } from "./scene";
 export { DEFAULT_PRESET_ID, DEFAULT_PRESETS } from "./presets/defaults";
 export { SCIENCE_PRESETS, SCIENCE_PRESET_SUMMARIES, SCIENCE_DEFAULT_PRESET_ID, buildViewerPresets, buildSciencePresets, } from "./presets/sciencePresets";
 export { listScienceSkyOptions, getScienceSkyOption } from "./sky/scienceSky";
@@ -10,6 +12,8 @@ export type { MaterialCatalogue, MaterialDefinition, MaterialId, MaterialColor,
 export { getMaterialCatalogue, findMaterial, listMaterialsByCategory } from "./materials/catalogue";
 export { getRenderMaterialMetadata } from "./materials/renderMetadata";
 export { BASELINE_MATERIAL_PRESET_ID, MATERIAL_PRESET_DATA, listMaterialPresets, getMaterialPreset, resolveMaterialSlot, resolveMaterialPresetMaterials, } from "./materials/presets";
+export type { MaterialOverrides, MaterialResolveOptions } from "./materials/resolve";
+export { resolveMaterialConfig } from "./materials/resolve";
 export { applyMaterialsToGroup, buildSurfaceMaterial, buildCatalogMaterial, setTextureBaseUrl, } from "./materials/architectural";
 export { EnvironmentSystem } from "./systems/environmentSystem";
 export { LightingSystem } from "./systems/lightingSystem";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,mBAAmB,EACnB,YAAY,EACZ,aAAa,EACb,cAAc,EACd,WAAW,EACX,sBAAsB,EACtB,aAAa,EACb,iBAAiB,EACjB,YAAY,EACZ,iBAAiB,EACjB,aAAa,EACb,YAAY,EACZ,aAAa,EACb,eAAe,GAChB,MAAM,gBAAgB,CAAC;AACxB,YAAY,EACV,iBAAiB,EACjB,eAAe,EACf,yBAAyB,EACzB,yBAAyB,GAC1B,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AACjE,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACxE,OAAO,EACL,eAAe,EACf,wBAAwB,EACxB,yBAAyB,EACzB,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAC9E,YAAY,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACzD,YAAY,EACV,iBAAiB,EACjB,kBAAkB,EAClB,UAAU,EACV,aAAa,EACb,qBAAqB,EACrB,eAAe,GAChB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,oBAAoB,EAAE,YAAY,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AACpG,OAAO,EAAE,yBAAyB,EAAE,MAAM,4BAA4B,CAAC;AACvE,OAAO,EACL,2BAA2B,EAC3B,oBAAoB,EACpB,mBAAmB,EACnB,iBAAiB,EACjB,mBAAmB,EACnB,8BAA8B,GAC/B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,qBAAqB,EACrB,oBAAoB,EACpB,oBAAoB,EACpB,iBAAiB,GAClB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACnE,cAAc,WAAW,CAAC;AAC1B,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,YAAY,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,mBAAmB,EACnB,YAAY,EACZ,aAAa,EACb,cAAc,EACd,WAAW,EACX,sBAAsB,EACtB,aAAa,EACb,iBAAiB,EACjB,YAAY,EACZ,iBAAiB,EACjB,aAAa,EACb,YAAY,EACZ,aAAa,EACb,eAAe,GAChB,MAAM,gBAAgB,CAAC;AACxB,YAAY,EACV,iBAAiB,EACjB,eAAe,EACf,yBAAyB,EACzB,yBAAyB,GAC1B,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AACjE,YAAY,EACV,eAAe,EACf,UAAU,EACV,yBAAyB,EACzB,wBAAwB,EACxB,WAAW,GACZ,MAAM,SAAS,CAAC;AACjB,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACxE,OAAO,EACL,eAAe,EACf,wBAAwB,EACxB,yBAAyB,EACzB,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAC9E,YAAY,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACzD,YAAY,EACV,iBAAiB,EACjB,kBAAkB,EAClB,UAAU,EACV,aAAa,EACb,qBAAqB,EACrB,eAAe,GAChB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,oBAAoB,EAAE,YAAY,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AACpG,OAAO,EAAE,yBAAyB,EAAE,MAAM,4BAA4B,CAAC;AACvE,OAAO,EACL,2BAA2B,EAC3B,oBAAoB,EACpB,mBAAmB,EACnB,iBAAiB,EACjB,mBAAmB,EACnB,8BAA8B,GAC/B,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AACrF,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EACL,qBAAqB,EACrB,oBAAoB,EACpB,oBAAoB,EACpB,iBAAiB,GAClB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACnE,cAAc,WAAW,CAAC;AAC1B,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,YAAY,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/index.js

@@ -1,11 +1,13 @@
 export { createViewer } from "./engine/createViewer";
 export { computeCameraFrame, normalizeObject3d } from "./camera";
+export { DEFAULT_CAMERA_RIG, applyGroupToViewer, computeSceneStats, resolveRoomHeights, setCameraToBounds, setCameraTopDown, } from "./scene";
 export { DEFAULT_PRESET_ID, DEFAULT_PRESETS } from "./presets/defaults";
 export { SCIENCE_PRESETS, SCIENCE_PRESET_SUMMARIES, SCIENCE_DEFAULT_PRESET_ID, buildViewerPresets, buildSciencePresets, } from "./presets/sciencePresets";
 export { listScienceSkyOptions, getScienceSkyOption } from "./sky/scienceSky";
 export { getMaterialCatalogue, findMaterial, listMaterialsByCategory } from "./materials/catalogue";
 export { getRenderMaterialMetadata } from "./materials/renderMetadata";
 export { BASELINE_MATERIAL_PRESET_ID, MATERIAL_PRESET_DATA, listMaterialPresets, getMaterialPreset, resolveMaterialSlot, resolveMaterialPresetMaterials, } from "./materials/presets";
+export { resolveMaterialConfig } from "./materials/resolve";
 export { applyMaterialsToGroup, buildSurfaceMaterial, buildCatalogMaterial, setTextureBaseUrl, } from "./materials/architectural";
 export { EnvironmentSystem } from "./systems/environmentSystem";
 export { LightingSystem } from "./systems/lightingSystem";

package/dist/materials/resolve.d.ts

@@ -0,0 +1,13 @@
+import type { MaterialsConfig, SurfaceMaterialConfig } from "./types";
+export type MaterialOverrides = {
+    walls?: Partial<SurfaceMaterialConfig>;
+    floor?: Partial<SurfaceMaterialConfig>;
+    ceiling?: Partial<SurfaceMaterialConfig>;
+};
+export type MaterialResolveOptions = {
+    payload?: Record<string, unknown> | null;
+    presetId?: string | null;
+    overrides?: MaterialOverrides | null;
+};
+export declare function resolveMaterialConfig(options: MaterialResolveOptions): MaterialsConfig | null;
+//# sourceMappingURL=resolve.d.ts.map

package/dist/materials/resolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../../src/materials/resolve.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAGtE,MAAM,MAAM,iBAAiB,GAAG;IAC9B,KAAK,CAAC,EAAE,OAAO,CAAC,qBAAqB,CAAC,CAAC;IACvC,KAAK,CAAC,EAAE,OAAO,CAAC,qBAAqB,CAAC,CAAC;IACvC,OAAO,CAAC,EAAE,OAAO,CAAC,qBAAqB,CAAC,CAAC;CAC1C,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG;IACnC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACzC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,SAAS,CAAC,EAAE,iBAAiB,GAAG,IAAI,CAAC;CACtC,CAAC;AAEF,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,sBAAsB,GAAG,eAAe,GAAG,IAAI,CAyB7F"}

package/dist/materials/resolve.js

@@ -0,0 +1,28 @@
+import { getMaterialPreset, resolveMaterialPresetMaterials } from "./presets";
+export function resolveMaterialConfig(options) {
+    const { payload, presetId, overrides } = options;
+    if (presetId) {
+        try {
+            const preset = getMaterialPreset(presetId);
+            const base = resolveMaterialPresetMaterials(preset);
+            return {
+                walls: { ...base.walls, ...(overrides?.walls ?? {}) },
+                floor: { ...base.floor, ...(overrides?.floor ?? {}) },
+                ceiling: { ...base.ceiling, ...(overrides?.ceiling ?? {}) },
+            };
+        }
+        catch {
+            return null;
+        }
+    }
+    const record = payload;
+    const directMaterials = record?.materials ?? record?.room?.materials;
+    if (directMaterials?.walls && directMaterials?.floor && directMaterials?.ceiling) {
+        return {
+            walls: { ...directMaterials.walls, ...(overrides?.walls ?? {}) },
+            floor: { ...directMaterials.floor, ...(overrides?.floor ?? {}) },
+            ceiling: { ...directMaterials.ceiling, ...(overrides?.ceiling ?? {}) },
+        };
+    }
+    return null;
+}

package/dist/scene.d.ts

@@ -0,0 +1,43 @@
+import * as THREE from "three";
+import type { ViewerHandle } from "./engine/types";
+import type { CameraFrameConfig, CameraNormalizationConfig, CameraNormalizationResult } from "./camera";
+import type { MaterialsConfig } from "./materials/types";
+export type CameraRigConfig = CameraFrameConfig & CameraNormalizationConfig;
+export declare const DEFAULT_CAMERA_RIG: CameraRigConfig;
+export type SceneStats = {
+    meshCount: number;
+    vertexCount: number;
+    triangleCount: number;
+    size: {
+        x: number;
+        y: number;
+        z: number;
+    };
+};
+export declare function computeSceneStats(root?: THREE.Object3D | null): SceneStats;
+export declare const setCameraToBounds: (handle: ViewerHandle, bounds: THREE.Box3, config?: CameraFrameConfig) => void;
+export declare const setCameraTopDown: (handle: ViewerHandle, bounds: THREE.Box3) => void;
+export type ApplyGroupToViewerOptions = {
+    viewer?: ViewerHandle | null;
+    group: THREE.Group;
+    cameraRig?: CameraRigConfig;
+    viewMode?: "2d" | "3d" | "auto";
+    frameConfig?: CameraFrameConfig;
+    materialsConfig?: MaterialsConfig | null;
+    floorLevel?: number;
+    ceilingHeight?: number;
+};
+export type ApplyGroupToViewerResult = {
+    bounds: THREE.Box3;
+    stats: SceneStats;
+    normalization: CameraNormalizationResult;
+    resolvedFloor: number;
+    resolvedHeight: number;
+};
+export type RoomHeights = {
+    floorLevel?: number;
+    ceilingHeight?: number;
+};
+export declare const resolveRoomHeights: (payload: Record<string, unknown>) => RoomHeights;
+export declare function applyGroupToViewer(options: ApplyGroupToViewerOptions): ApplyGroupToViewerResult | null;
+//# sourceMappingURL=scene.d.ts.map

package/dist/scene.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scene.d.ts","sourceRoot":"","sources":["../src/scene.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,KAAK,EAAE,iBAAiB,EAAE,yBAAyB,EAAE,yBAAyB,EAAE,MAAM,UAAU,CAAC;AAExG,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAGzD,MAAM,MAAM,eAAe,GAAG,iBAAiB,GAAG,yBAAyB,CAAC;AAE5E,eAAO,MAAM,kBAAkB,EAAE,eAMhC,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC3C,CAAC;AAEF,wBAAgB,iBAAiB,CAAC,IAAI,CAAC,EAAE,KAAK,CAAC,QAAQ,GAAG,IAAI,GAAG,UAAU,CA0C1E;AAED,eAAO,MAAM,iBAAiB,GAC5B,QAAQ,YAAY,EACpB,QAAQ,KAAK,CAAC,IAAI,EAClB,SAAS,iBAAiB,SA0B3B,CAAC;AAEF,eAAO,MAAM,gBAAgB,GAAI,QAAQ,YAAY,EAAE,QAAQ,KAAK,CAAC,IAAI,SA0BxE,CAAC;AAEF,MAAM,MAAM,yBAAyB,GAAG;IACtC,MAAM,CAAC,EAAE,YAAY,GAAG,IAAI,CAAC;IAC7B,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC;IACnB,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B,QAAQ,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,MAAM,CAAC;IAChC,WAAW,CAAC,EAAE,iBAAiB,CAAC;IAChC,eAAe,CAAC,EAAE,eAAe,GAAG,IAAI,CAAC;IACzC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG;IACrC,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC;IACnB,KAAK,EAAE,UAAU,CAAC;IAClB,aAAa,EAAE,yBAAyB,CAAC;IACzC,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IAAE,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,aAAa,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAE1E,eAAO,MAAM,kBAAkB,GAAI,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAG,WAYrE,CAAC;AAEF,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,yBAAyB,GACjC,wBAAwB,GAAG,IAAI,CA2CjC"}

package/dist/scene.js

@@ -0,0 +1,148 @@
+import * as THREE from "three";
+import { computeCameraFrame, normalizeObject3d } from "./camera";
+import { applyMaterialsToGroup } from "./materials/architectural";
+export const DEFAULT_CAMERA_RIG = {
+    recenter: true,
+    floorToZero: true,
+    padding: 1.22,
+    direction: [1, 0.7, 1],
+    mode: "iso",
+};
+export function computeSceneStats(root) {
+    let meshCount = 0;
+    let vertexCount = 0;
+    let triangleCount = 0;
+    if (!root || typeof root.traverse !== "function") {
+        return {
+            meshCount,
+            vertexCount,
+            triangleCount,
+            size: { x: 0, y: 0, z: 0 },
+        };
+    }
+    root.traverse((child) => {
+        const mesh = child;
+        if (mesh.isMesh) {
+            meshCount += 1;
+            const geometry = mesh.geometry;
+            const position = geometry.getAttribute("position");
+            if (position) {
+                vertexCount += position.count;
+            }
+            const index = geometry.getIndex();
+            if (index) {
+                triangleCount += index.count / 3;
+            }
+            else if (position) {
+                triangleCount += position.count / 3;
+            }
+        }
+    });
+    const bounds = new THREE.Box3().setFromObject(root);
+    const size = new THREE.Vector3();
+    bounds.getSize(size);
+    return {
+        meshCount,
+        vertexCount,
+        triangleCount: Math.round(triangleCount),
+        size: { x: size.x, y: size.y, z: size.z },
+    };
+}
+export const setCameraToBounds = (handle, bounds, config) => {
+    if (bounds.isEmpty())
+        return;
+    const fov = handle.getCameraState().fov ?? 60;
+    const { position, target } = computeCameraFrame(bounds, fov, config);
+    if (![position.x, position.y, position.z, target.x, target.y, target.z].every(Number.isFinite)) {
+        return;
+    }
+    const sphere = new THREE.Sphere();
+    bounds.getBoundingSphere(sphere);
+    const distance = position.distanceTo(target);
+    const safetyFar = 1.15;
+    const safetyNear = 1.6;
+    let near = Math.max(0.01, distance - sphere.radius * safetyNear);
+    const maxNear = distance * 0.1;
+    if (Number.isFinite(maxNear) && maxNear > 0) {
+        near = Math.min(near, maxNear);
+    }
+    const minSkyFar = 350;
+    const far = Math.max(distance + sphere.radius * safetyFar, near + sphere.radius * 2, minSkyFar);
+    handle.setCamera({
+        position: [position.x, position.y, position.z],
+        target: [target.x, target.y, target.z],
+        near,
+        far,
+    });
+};
+export const setCameraTopDown = (handle, bounds) => {
+    if (bounds.isEmpty())
+        return;
+    const center = bounds.getCenter(new THREE.Vector3());
+    const size = bounds.getSize(new THREE.Vector3());
+    const span = Math.max(size.x, size.z, 1);
+    const height = span * 1.5;
+    const position = new THREE.Vector3(center.x, center.y + height, center.z);
+    const target = center.clone();
+    const sphere = new THREE.Sphere();
+    bounds.getBoundingSphere(sphere);
+    const distance = position.distanceTo(target);
+    const safetyFar = 1.2;
+    const safetyNear = 1.8;
+    let near = Math.max(0.01, distance - sphere.radius * safetyNear);
+    const maxNear = distance * 0.1;
+    if (Number.isFinite(maxNear) && maxNear > 0) {
+        near = Math.min(near, maxNear);
+    }
+    const minSkyFar = 350;
+    const far = Math.max(distance + sphere.radius * safetyFar, near + sphere.radius * 2, minSkyFar);
+    handle.setCamera({
+        position: [position.x, position.y, position.z],
+        target: [target.x, target.y, target.z],
+        near,
+        far,
+    });
+};
+export const resolveRoomHeights = (payload) => {
+    const record = payload;
+    const floorLevel = typeof record?.floorLevel === "number" ? record.floorLevel : undefined;
+    const roomHeight = typeof record?.roomHeight === "number"
+        ? record.roomHeight
+        : typeof record?.room?.rectilinear?.height === "number"
+            ? record.room.rectilinear.height
+            : typeof record?.room?.curvilinear?.height === "number"
+                ? record.room.curvilinear.height
+                : undefined;
+    return { floorLevel, ceilingHeight: roomHeight };
+};
+export function applyGroupToViewer(options) {
+    const { viewer, group, cameraRig, viewMode = "auto", frameConfig, materialsConfig, floorLevel, ceilingHeight, } = options;
+    if (!group)
+        return null;
+    const normalization = normalizeObject3d(group, cameraRig);
+    const bounds = normalization.bounds;
+    const resolvedFloor = cameraRig?.floorToZero
+        ? 0
+        : typeof floorLevel === "number"
+            ? floorLevel * normalization.scale + normalization.offset.y
+            : bounds.min.y;
+    const resolvedHeight = typeof ceilingHeight === "number"
+        ? ceilingHeight * normalization.scale
+        : Math.max(0.1, bounds.max.y - bounds.min.y);
+    if (materialsConfig) {
+        applyMaterialsToGroup(group, materialsConfig, resolvedFloor, resolvedHeight);
+        viewer?.invalidate?.();
+    }
+    const stats = computeSceneStats(group);
+    if (viewer) {
+        viewer.setSceneRoot(group);
+        const shouldTopDown = viewMode === "2d" || (viewMode === "auto" && stats.meshCount === 0);
+        if (shouldTopDown) {
+            setCameraTopDown(viewer, bounds);
+        }
+        else {
+            setCameraToBounds(viewer, bounds, frameConfig);
+        }
+    }
+    return { bounds, stats, normalization, resolvedFloor, resolvedHeight };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@treasuryspatial/viewer-kit",
-  "version": "0.2.39",
+  "version": "0.2.41",
   "type": "module",
   "license": "UNLICENSED",
   "main": "./dist/index.js",
@@ -15,7 +15,7 @@
     "dist"
   ],
   "dependencies": {
-    "@treasuryspatial/rhino-bridge": "^0.1.6"
+    "@treasuryspatial/rhino-bridge": "^0.1.7"
   },
   "publishConfig": {
     "access": "public"