@base2datadesign/viewer-kit 0.2.14 → 0.2.16

package/dist/camera.d.ts

@@ -0,0 +1,28 @@
+import * as THREE from "three";
+export type CameraFrameMode = "iso" | "interior";
+export type CameraFrameConfig = {
+    mode?: CameraFrameMode;
+    padding?: number;
+    direction?: [number, number, number];
+};
+export type CameraNormalizationConfig = {
+    recenter?: boolean;
+    floorToZero?: boolean;
+    normalizePlan?: {
+        target?: number;
+        maxScale?: number;
+    };
+};
+export type CameraNormalizationResult = {
+    bounds: THREE.Box3;
+    center: THREE.Vector3;
+    size: THREE.Vector3;
+    scale: number;
+    offset: THREE.Vector3;
+};
+export declare const normalizeObject3d: (object: THREE.Object3D, config?: CameraNormalizationConfig) => CameraNormalizationResult;
+export declare const computeCameraFrame: (bounds: THREE.Box3, fovDegrees: number, config?: CameraFrameConfig) => {
+    position: THREE.Vector3;
+    target: THREE.Vector3;
+};
+//# sourceMappingURL=camera.d.ts.map

package/dist/camera.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"camera.d.ts","sourceRoot":"","sources":["../src/camera.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,MAAM,MAAM,eAAe,GAAG,KAAK,GAAG,UAAU,CAAC;AAEjD,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,CAAC,EAAE,eAAe,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;CACtC,CAAC;AAEF,MAAM,MAAM,yBAAyB,GAAG;IACtC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,aAAa,CAAC,EAAE;QACd,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC;CACH,CAAC;AAEF,MAAM,MAAM,yBAAyB,GAAG;IACtC,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC;IACnB,MAAM,EAAE,KAAK,CAAC,OAAO,CAAC;IACtB,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,KAAK,CAAC,OAAO,CAAC;CACvB,CAAC;AAKF,eAAO,MAAM,iBAAiB,GAC5B,QAAQ,KAAK,CAAC,QAAQ,EACtB,SAAS,yBAAyB,KACjC,yBA8CF,CAAC;AAEF,eAAO,MAAM,kBAAkB,GAC7B,QAAQ,KAAK,CAAC,IAAI,EAClB,YAAY,MAAM,EAClB,SAAS,iBAAiB,KACzB;IAAE,QAAQ,EAAE,KAAK,CAAC,OAAO,CAAC;IAAC,MAAM,EAAE,KAAK,CAAC,OAAO,CAAA;CAmBlD,CAAC"}

package/dist/camera.js

@@ -0,0 +1,62 @@
+import * as THREE from "three";
+const DEFAULT_FRAME_PADDING = 1.22;
+const DEFAULT_FRAME_DIRECTION = [1, 0.7, 1];
+export const normalizeObject3d = (object, config) => {
+    const resolved = config ?? {};
+    const offset = new THREE.Vector3();
+    let scale = 1;
+    object.updateMatrixWorld(true);
+    let bounds = new THREE.Box3().setFromObject(object);
+    let size = new THREE.Vector3();
+    let center = new THREE.Vector3();
+    bounds.getSize(size);
+    bounds.getCenter(center);
+    const targetPlan = resolved.normalizePlan?.target;
+    if (typeof targetPlan === "number" && Number.isFinite(targetPlan) && targetPlan > 0) {
+        const planMax = Math.max(size.x, size.z);
+        if (planMax > 1e-6) {
+            const maxScale = resolved.normalizePlan?.maxScale ?? 3;
+            scale = Math.min(maxScale, targetPlan / planMax);
+            if (Number.isFinite(scale) && scale > 0 && scale !== 1) {
+                object.scale.multiplyScalar(scale);
+                object.updateMatrixWorld(true);
+                bounds = new THREE.Box3().setFromObject(object);
+                bounds.getSize(size);
+                bounds.getCenter(center);
+            }
+        }
+    }
+    if (resolved.recenter) {
+        offset.x -= center.x;
+        offset.z -= center.z;
+    }
+    if (resolved.floorToZero) {
+        offset.y -= bounds.min.y;
+    }
+    if (offset.lengthSq() > 0) {
+        object.position.add(offset);
+        object.updateMatrixWorld(true);
+        bounds = new THREE.Box3().setFromObject(object);
+        bounds.getSize(size);
+        bounds.getCenter(center);
+    }
+    return { bounds, center, size, scale, offset };
+};
+export const computeCameraFrame = (bounds, fovDegrees, config) => {
+    const size = new THREE.Vector3();
+    const center = new THREE.Vector3();
+    bounds.getSize(size);
+    bounds.getCenter(center);
+    const mode = config?.mode ?? "iso";
+    if (mode === "interior") {
+        const position = new THREE.Vector3(center.x, center.y + size.y * 0.2, center.z + size.z * 0.2);
+        return { position, target: center };
+    }
+    const padding = config?.padding ?? DEFAULT_FRAME_PADDING;
+    const direction = new THREE.Vector3(...(config?.direction ?? DEFAULT_FRAME_DIRECTION)).normalize();
+    const radius = Math.max(0.5, size.length() * 0.5);
+    const vFov = THREE.MathUtils.degToRad(fovDegrees);
+    const distance = (radius / Math.sin(vFov / 2)) * padding;
+    const position = center.clone().add(direction.multiplyScalar(distance));
+    return { position, target: center };
+};

package/dist/engine/ViewerEngine.d.ts

@@ -7,6 +7,7 @@ export declare class ViewerEngine {
     private camera;
     private controls;
     private rootGroup;
+    private sceneBounds;
     private environmentSystem;
     private lightingSystem;
     private postFxSystem;

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;IAE/B,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;IAmBzB,OAAO,CAAC,UAAU;IAKlB,KAAK,IAAI,IAAI;IAgBb,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;IAwBjC,SAAS,CAAC,KAAK,EAAE,OAAO,CAAC,WAAW,CAAC,GAAG,IAAI;IAe5C,cAAc,IAAI,WAAW;IAQvB,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;gBAElB,OAAO,EAAE,mBAAmB;IAwDxC,SAAS,IAAI,YAAY;IAmBzB,OAAO,CAAC,UAAU;IAKlB,KAAK,IAAI,IAAI;IAgBb,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;IAyBjC,SAAS,CAAC,KAAK,EAAE,OAAO,CAAC,WAAW,CAAC,GAAG,IAAI;IAe5C,cAAc,IAAI,WAAW;IAQvB,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

@@ -14,6 +14,7 @@ export class ViewerEngine {
     camera;
     controls;
     rootGroup;
+    sceneBounds = null;
     environmentSystem;
     lightingSystem;
     postFxSystem;
@@ -159,6 +160,7 @@ export class ViewerEngine {
         if (object3d && object3d.isObject3D) {
             this.rootGroup.add(object3d);
             const bounds = new THREE.Box3().setFromObject(object3d);
+            this.sceneBounds = bounds.clone();
             if (!bounds.isEmpty()) {
                 const size = new THREE.Vector3();
                 bounds.getSize(size);
@@ -300,7 +302,7 @@ export class ViewerEngine {
         this.lightingSystem.apply(preset);
         this.postFxSystem.apply(this.usePostprocessing ? preset.postfx : undefined);
         this.postFxSystem.invalidate();
-        this.debugSystem.apply(preset);
+        this.debugSystem.apply(preset, this.sceneBounds);
     }
     resolvePreset(presetId) {
         if (presetId in this.presets)

package/dist/index.d.ts

@@ -1,5 +1,7 @@
 export type { ViewerCreateOptions, ViewerHandle, ViewerSnapshot, CameraState, RenderPresetDefinition, PresetCatalog, LightingRigConfig, PostFxConfig, SceneExtrasConfig, SkyDefinition, SkyHdrConfig, SkyCubeConfig, ViewerDebugInfo, } from "./engine/types";
+export type { CameraFrameConfig, CameraFrameMode, CameraNormalizationConfig, CameraNormalizationResult, } from "./camera";
 export { createViewer } from "./engine/createViewer";
+export { computeCameraFrame, normalizeObject3d } from "./camera";
 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";

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,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,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,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,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAC9G,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,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,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAC9G,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,4 +1,5 @@
 export { createViewer } from "./engine/createViewer";
+export { computeCameraFrame, normalizeObject3d } from "./camera";
 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";

package/dist/systems/debugSystem.d.ts

@@ -4,7 +4,7 @@ export declare class DebugSystem {
     private scene;
     private objects;
     constructor(scene: THREE.Scene);
-    apply(preset: RenderPresetDefinition): void;
+    apply(preset: RenderPresetDefinition, bounds?: THREE.Box3 | null): void;
     dispose(): void;
     private add;
     private clear;

package/dist/systems/debugSystem.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"debugSystem.d.ts","sourceRoot":"","sources":["../../src/systems/debugSystem.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,KAAK,EAAqB,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AAoKjF,qBAAa,WAAW;IACtB,OAAO,CAAC,KAAK,CAAc;IAC3B,OAAO,CAAC,OAAO,CAAwB;gBAE3B,KAAK,EAAE,KAAK,CAAC,KAAK;IAI9B,KAAK,CAAC,MAAM,EAAE,sBAAsB,GAAG,IAAI;IAwE3C,OAAO,IAAI,IAAI;IAIf,OAAO,CAAC,GAAG;IAKX,OAAO,CAAC,KAAK;CAmCd"}
+{"version":3,"file":"debugSystem.d.ts","sourceRoot":"","sources":["../../src/systems/debugSystem.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,KAAK,EAAqB,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AAoKjF,qBAAa,WAAW;IACtB,OAAO,CAAC,KAAK,CAAc;IAC3B,OAAO,CAAC,OAAO,CAAwB;gBAE3B,KAAK,EAAE,KAAK,CAAC,KAAK;IAI9B,KAAK,CAAC,MAAM,EAAE,sBAAsB,EAAE,MAAM,CAAC,EAAE,KAAK,CAAC,IAAI,GAAG,IAAI,GAAG,IAAI;IA8EvE,OAAO,IAAI,IAAI;IAIf,OAAO,CAAC,GAAG;IAKX,OAAO,CAAC,KAAK;CAmCd"}

package/dist/systems/debugSystem.js

@@ -152,7 +152,7 @@ export class DebugSystem {
     constructor(scene) {
         this.scene = scene;
     }
-    apply(preset) {
+    apply(preset, bounds) {
         const extras = { ...DEFAULT_EXTRAS, ...(preset.sceneExtras ?? {}) };
         this.clear();
         const skyMode = preset.sky?.mode ?? "gradient";
@@ -163,8 +163,14 @@ export class DebugSystem {
         const axesEnabled = extras.axes !== false;
         const originEnabled = extras.origin !== false;
         const groundColor = extras.groundColor ?? 0x2c2f33;
+        const boundsSize = bounds && !bounds.isEmpty() ? bounds.getSize(new THREE.Vector3()) : null;
+        const modelSpan = boundsSize ? Math.max(boundsSize.x, boundsSize.z, 1) : null;
+        const groundSizeDefault = isHdr ? HDR_GROUND_SIZE : 400;
+        const gridSizeDefault = DEFAULT_GRID_SIZE;
+        const derivedGroundSize = modelSpan ? Math.max(modelSpan * 4, groundSizeDefault * 0.5) : groundSizeDefault;
+        const derivedGridSize = modelSpan ? Math.max(modelSpan * 3, gridSizeDefault) : gridSizeDefault;
         if (groundEnabled) {
-            const size = extras.groundSize ?? (isHdr ? HDR_GROUND_SIZE : 400);
+            const size = extras.groundSize ?? derivedGroundSize;
             const groundGeometry = new THREE.PlaneGeometry(size, size);
             const groundMaterial = new THREE.MeshStandardMaterial({
                 color: groundColor,
@@ -182,7 +188,7 @@ export class DebugSystem {
         if (gridEnabled) {
             const gridPrimary = new THREE.Color(extras.gridColor ?? adjustGridColor(groundColor));
             const gridSecondary = new THREE.Color(extras.gridColorSecondary ?? gridPrimary.getHex());
-            const gridSize = extras.gridSize ?? DEFAULT_GRID_SIZE;
+            const gridSize = extras.gridSize ?? derivedGridSize;
             const gridDivisions = extras.gridDivisions ?? Math.max(1, gridSize);
             const grid = new THREE.GridHelper(gridSize, gridDivisions, gridPrimary, gridSecondary);
             const offset = extras.gridHeightOffset ?? DEFAULT_GRID_HEIGHT_OFFSET;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@base2datadesign/viewer-kit",
-  "version": "0.2.14",
+  "version": "0.2.16",
   "type": "module",
   "license": "UNLICENSED",
   "main": "./dist/index.js",