@ifc-lite/renderer 1.2.0 → 1.3.0

package/dist/constants.d.ts

@@ -0,0 +1,125 @@
+/**
+ * Renderer constants - extracted magic numbers for maintainability
+ */
+export declare const CAMERA_CONSTANTS: {
+    /** Inertia damping factor (0-1), higher = more damping */
+    readonly DAMPING_FACTOR: 0.92;
+    /** Minimum velocity threshold for inertia */
+    readonly MIN_VELOCITY_THRESHOLD: 0.001;
+    /** First-person movement speed */
+    readonly FIRST_PERSON_SPEED: 0.1;
+    /** Orbit sensitivity (radians per pixel) */
+    readonly ORBIT_SENSITIVITY: 0.01;
+    /** Pan speed multiplier */
+    readonly PAN_SPEED_MULTIPLIER: 0.001;
+    /** Zoom sensitivity */
+    readonly ZOOM_SENSITIVITY: 0.001;
+    /** Maximum zoom delta per frame */
+    readonly MAX_ZOOM_DELTA: 0.1;
+    readonly DEFAULT_POSITION: {
+        readonly x: 50;
+        readonly y: 50;
+        readonly z: 100;
+    };
+    readonly DEFAULT_TARGET: {
+        readonly x: 0;
+        readonly y: 0;
+        readonly z: 0;
+    };
+    readonly DEFAULT_UP: {
+        readonly x: 0;
+        readonly y: 1;
+        readonly z: 0;
+    };
+    readonly DEFAULT_FOV: number;
+    readonly DEFAULT_NEAR: 0.1;
+    readonly DEFAULT_FAR: 100000;
+    /** Maximum near/far ratio for depth precision */
+    readonly MAX_NEAR_FAR_RATIO: 10000;
+    /** Near plane as percentage of distance */
+    readonly NEAR_DISTANCE_FACTOR: 0.001;
+    /** Far plane multiplier of distance */
+    readonly FAR_DISTANCE_MULTIPLIER: 10;
+    /** Minimum phi angle to prevent gimbal lock at poles */
+    readonly MIN_PHI: 0.15;
+    /** Maximum phi angle to prevent gimbal lock at poles */
+    readonly MAX_PHI: number;
+    /** Sin phi threshold for pole detection */
+    readonly POLE_THRESHOLD: 0.05;
+    /** Default animation duration in ms */
+    readonly DEFAULT_ANIMATION_DURATION: 500;
+    /** Quick animation duration in ms */
+    readonly QUICK_ANIMATION_DURATION: 300;
+    /** Distance multiplier for fitToBounds */
+    readonly FIT_DISTANCE_MULTIPLIER: 2;
+    /** Padding multiplier for frame selection */
+    readonly FRAME_PADDING_MULTIPLIER: 1.2;
+    /** Padding multiplier for zoom extent */
+    readonly ZOOM_EXTENT_PADDING: 1.5;
+    readonly ISOMETRIC_OFFSET: {
+        readonly right: 0.6;
+        readonly up: 0.5;
+        readonly front: 0.6;
+    };
+};
+export declare const BVH_CONSTANTS: {
+    /** Minimum mesh count to trigger BVH construction */
+    readonly THRESHOLD: 100;
+    /** Maximum primitives per leaf node */
+    readonly MAX_PRIMITIVES_PER_LEAF: 4;
+    /** Maximum tree depth */
+    readonly MAX_DEPTH: 32;
+};
+export declare const ERROR_CONSTANTS: {
+    /** Rate limit for render error logging (ms) */
+    readonly RENDER_ERROR_THROTTLE_MS: 1000;
+};
+export declare const PIPELINE_CONSTANTS: {
+    /** Total uniform buffer size */
+    readonly UNIFORM_BUFFER_SIZE: 192;
+    /** Byte offset for flags in uniform buffer */
+    readonly FLAGS_BYTE_OFFSET: 176;
+    /** Default MSAA sample count */
+    readonly DEFAULT_SAMPLE_COUNT: 4;
+    /** Depth format for reverse-Z */
+    readonly DEPTH_FORMAT: "depth32float";
+};
+export declare const LIGHTING_CONSTANTS: {
+    readonly SUN_LIGHT: {
+        readonly x: 0.5;
+        readonly y: 1;
+        readonly z: 0.3;
+    };
+    readonly FILL_LIGHT: {
+        readonly x: -0.5;
+        readonly y: 0.3;
+        readonly z: -0.3;
+    };
+    readonly RIM_LIGHT: {
+        readonly x: 0;
+        readonly y: 0.2;
+        readonly z: -1;
+    };
+    readonly SKY_COLOR: {
+        readonly r: 0.3;
+        readonly g: 0.35;
+        readonly b: 0.4;
+    };
+    readonly GROUND_COLOR: {
+        readonly r: 0.15;
+        readonly g: 0.1;
+        readonly b: 0.08;
+    };
+    readonly AMBIENT_INTENSITY: 0.25;
+    readonly DIFFUSE_SUN_INTENSITY: 0.55;
+    readonly DIFFUSE_FILL_INTENSITY: 0.15;
+    readonly RIM_INTENSITY: 0.15;
+    readonly WRAP_FACTOR: 0.3;
+};
+export declare const PICK_CONSTANTS: {
+    /** Maximum meshes to create for picking during streaming */
+    readonly MAX_PICK_MESH_CREATION: 500;
+    /** Pick buffer format */
+    readonly BUFFER_FORMAT: "rgba8unorm";
+};
+//# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAIA;;GAEG;AAMH,eAAO,MAAM,gBAAgB;IAE3B,0DAA0D;;IAE1D,6CAA6C;;IAI7C,kCAAkC;;IAElC,4CAA4C;;IAE5C,2BAA2B;;IAE3B,uBAAuB;;IAEvB,mCAAmC;;;;;;;;;;;;;;;;;;;;IAYnC,iDAAiD;;IAEjD,2CAA2C;;IAE3C,uCAAuC;;IAIvC,wDAAwD;;IAExD,wDAAwD;;IAExD,2CAA2C;;IAI3C,uCAAuC;;IAEvC,qCAAqC;;IAIrC,0CAA0C;;IAE1C,6CAA6C;;IAE7C,yCAAyC;;;;;;;CAKjC,CAAC;AAMX,eAAO,MAAM,aAAa;IACxB,qDAAqD;;IAErD,uCAAuC;;IAEvC,yBAAyB;;CAEjB,CAAC;AAMX,eAAO,MAAM,eAAe;IAC1B,+CAA+C;;CAEvC,CAAC;AAMX,eAAO,MAAM,kBAAkB;IAE7B,gCAAgC;;IAEhC,8CAA8C;;IAI9C,gCAAgC;;IAIhC,iCAAiC;;CAEzB,CAAC;AAMX,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgBrB,CAAC;AAMX,eAAO,MAAM,cAAc;IACzB,4DAA4D;;IAE5D,yBAAyB;;CAEjB,CAAC"}

package/dist/constants.js

@@ -0,0 +1,124 @@
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/. */
+/**
+ * Renderer constants - extracted magic numbers for maintainability
+ */
+// ============================================================================
+// Camera Constants
+// ============================================================================
+export const CAMERA_CONSTANTS = {
+    // Inertia system
+    /** Inertia damping factor (0-1), higher = more damping */
+    DAMPING_FACTOR: 0.92,
+    /** Minimum velocity threshold for inertia */
+    MIN_VELOCITY_THRESHOLD: 0.001,
+    // Movement speeds
+    /** First-person movement speed */
+    FIRST_PERSON_SPEED: 0.1,
+    /** Orbit sensitivity (radians per pixel) */
+    ORBIT_SENSITIVITY: 0.01,
+    /** Pan speed multiplier */
+    PAN_SPEED_MULTIPLIER: 0.001,
+    /** Zoom sensitivity */
+    ZOOM_SENSITIVITY: 0.001,
+    /** Maximum zoom delta per frame */
+    MAX_ZOOM_DELTA: 0.1,
+    // Default camera setup
+    DEFAULT_POSITION: { x: 50, y: 50, z: 100 },
+    DEFAULT_TARGET: { x: 0, y: 0, z: 0 },
+    DEFAULT_UP: { x: 0, y: 1, z: 0 },
+    DEFAULT_FOV: Math.PI / 4, // 45 degrees
+    DEFAULT_NEAR: 0.1,
+    DEFAULT_FAR: 100000,
+    // Depth precision
+    /** Maximum near/far ratio for depth precision */
+    MAX_NEAR_FAR_RATIO: 10000,
+    /** Near plane as percentage of distance */
+    NEAR_DISTANCE_FACTOR: 0.001,
+    /** Far plane multiplier of distance */
+    FAR_DISTANCE_MULTIPLIER: 10,
+    // Gimbal lock prevention
+    /** Minimum phi angle to prevent gimbal lock at poles */
+    MIN_PHI: 0.15,
+    /** Maximum phi angle to prevent gimbal lock at poles */
+    MAX_PHI: Math.PI - 0.15,
+    /** Sin phi threshold for pole detection */
+    POLE_THRESHOLD: 0.05,
+    // Animation
+    /** Default animation duration in ms */
+    DEFAULT_ANIMATION_DURATION: 500,
+    /** Quick animation duration in ms */
+    QUICK_ANIMATION_DURATION: 300,
+    // Fit to bounds
+    /** Distance multiplier for fitToBounds */
+    FIT_DISTANCE_MULTIPLIER: 2.0,
+    /** Padding multiplier for frame selection */
+    FRAME_PADDING_MULTIPLIER: 1.2,
+    /** Padding multiplier for zoom extent */
+    ZOOM_EXTENT_PADDING: 1.5,
+    // Isometric view offsets
+    ISOMETRIC_OFFSET: { right: 0.6, up: 0.5, front: 0.6 },
+};
+// ============================================================================
+// BVH Constants
+// ============================================================================
+export const BVH_CONSTANTS = {
+    /** Minimum mesh count to trigger BVH construction */
+    THRESHOLD: 100,
+    /** Maximum primitives per leaf node */
+    MAX_PRIMITIVES_PER_LEAF: 4,
+    /** Maximum tree depth */
+    MAX_DEPTH: 32,
+};
+// ============================================================================
+// Error Handling Constants
+// ============================================================================
+export const ERROR_CONSTANTS = {
+    /** Rate limit for render error logging (ms) */
+    RENDER_ERROR_THROTTLE_MS: 1000,
+};
+// ============================================================================
+// Pipeline Constants
+// ============================================================================
+export const PIPELINE_CONSTANTS = {
+    // Buffer layout (bytes) - must match WGSL shader expectations
+    /** Total uniform buffer size */
+    UNIFORM_BUFFER_SIZE: 192,
+    /** Byte offset for flags in uniform buffer */
+    FLAGS_BYTE_OFFSET: 176,
+    // MSAA
+    /** Default MSAA sample count */
+    DEFAULT_SAMPLE_COUNT: 4,
+    // Depth buffer
+    /** Depth format for reverse-Z */
+    DEPTH_FORMAT: 'depth32float',
+};
+// ============================================================================
+// Lighting Constants (for shaders)
+// ============================================================================
+export const LIGHTING_CONSTANTS = {
+    // Directional lights (normalized directions)
+    SUN_LIGHT: { x: 0.5, y: 1.0, z: 0.3 },
+    FILL_LIGHT: { x: -0.5, y: 0.3, z: -0.3 },
+    RIM_LIGHT: { x: 0.0, y: 0.2, z: -1.0 },
+    // Hemisphere colors
+    SKY_COLOR: { r: 0.3, g: 0.35, b: 0.4 },
+    GROUND_COLOR: { r: 0.15, g: 0.1, b: 0.08 },
+    // Intensities
+    AMBIENT_INTENSITY: 0.25,
+    DIFFUSE_SUN_INTENSITY: 0.55,
+    DIFFUSE_FILL_INTENSITY: 0.15,
+    RIM_INTENSITY: 0.15,
+    WRAP_FACTOR: 0.3,
+};
+// ============================================================================
+// Pick Constants
+// ============================================================================
+export const PICK_CONSTANTS = {
+    /** Maximum meshes to create for picking during streaming */
+    MAX_PICK_MESH_CREATION: 500,
+    /** Pick buffer format */
+    BUFFER_FORMAT: 'rgba8unorm',
+};
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

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

package/dist/device.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"device.d.ts","sourceRoot":"","sources":["../src/device.ts"],"names":[],"mappings":"AAIA;;GAEG;AAEH,qBAAa,YAAY;IACvB,OAAO,CAAC,OAAO,CAA2B;IAC1C,OAAO,CAAC,MAAM,CAA0B;IACxC,OAAO,CAAC,OAAO,CAAiC;IAChD,OAAO,CAAC,MAAM,CAAkC;IAChD,OAAO,CAAC,MAAM,CAAkC;IAChD,OAAO,CAAC,SAAS,CAAa;IAC9B,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,iBAAiB,CAAkB;IAC3C,OAAO,CAAC,UAAU,CAAa;IAE/B;;OAEG;IACG,IAAI,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAgCpD;;;OAGG;IACH,gBAAgB,IAAI,IAAI;IAoBxB;;OAEG;IACH,gBAAgB,IAAI,OAAO;IAM3B;;OAEG;IACH,iBAAiB,IAAI,IAAI;IAIzB;;;OAGG;IACH,aAAa,IAAI,OAAO;IAWxB;;;OAGG;IACH,iBAAiB,IAAI,UAAU,GAAG,IAAI;IActC,SAAS,IAAI,SAAS;IAOtB,UAAU,IAAI,gBAAgB;IAO9B,SAAS,IAAI,gBAAgB;IAI7B,aAAa,IAAI,OAAO;CAGzB"}
+{"version":3,"file":"device.d.ts","sourceRoot":"","sources":["../src/device.ts"],"names":[],"mappings":"AAIA;;GAEG;AAEH,qBAAa,YAAY;IACvB,OAAO,CAAC,OAAO,CAA2B;IAC1C,OAAO,CAAC,MAAM,CAA0B;IACxC,OAAO,CAAC,OAAO,CAAiC;IAChD,OAAO,CAAC,MAAM,CAAkC;IAChD,OAAO,CAAC,MAAM,CAAkC;IAChD,OAAO,CAAC,SAAS,CAAa;IAC9B,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,iBAAiB,CAAkB;IAC3C,OAAO,CAAC,UAAU,CAAa;IAE/B;;OAEG;IACG,IAAI,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAgCpD;;;OAGG;IACH,gBAAgB,IAAI,IAAI;IAoBxB;;OAEG;IACH,gBAAgB,IAAI,OAAO;IAM3B;;OAEG;IACH,iBAAiB,IAAI,IAAI;IAIzB;;;OAGG;IACH,aAAa,IAAI,OAAO;IAWxB;;;OAGG;IACH,iBAAiB,IAAI,UAAU,GAAG,IAAI;IAgBtC,SAAS,IAAI,SAAS;IAOtB,UAAU,IAAI,gBAAgB;IAO9B,SAAS,IAAI,gBAAgB;IAI7B,aAAa,IAAI,OAAO;CAGzB"}

package/dist/device.js

@@ -100,8 +100,9 @@ export class WebGPUDevice {
      * Returns null if texture is not available (context needs reconfiguration)
      */
     getCurrentTexture() {
-        if (!this.context || !this.contextConfigured)
+        if (!this.context || !this.contextConfigured) {
             return null;
+        }
         try {
             const texture = this.context.getCurrentTexture();
             this.frameCount++;

package/dist/device.js.map

@@ -1 +1 @@
-{"version":3,"file":"device.js","sourceRoot":"","sources":["../src/device.ts"],"names":[],"mappings":"AAAA;;+DAE+D;AAE/D;;GAEG;AAEH,MAAM,OAAO,YAAY;IACf,OAAO,GAAsB,IAAI,CAAC;IAClC,MAAM,GAAqB,IAAI,CAAC;IAChC,OAAO,GAA4B,IAAI,CAAC;IACxC,MAAM,GAAqB,YAAY,CAAC;IACxC,MAAM,GAA6B,IAAI,CAAC;IACxC,SAAS,GAAW,CAAC,CAAC;IACtB,UAAU,GAAW,CAAC,CAAC;IACvB,iBAAiB,GAAY,KAAK,CAAC;IACnC,UAAU,GAAW,CAAC,CAAC;IAE/B;;OAEG;IACH,KAAK,CAAC,IAAI,CAAC,MAAyB;QAClC,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,CAAC;YACnB,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC;QAC1C,CAAC;QAED,IAAI,CAAC,OAAO,GAAG,MAAM,SAAS,CAAC,GAAG,CAAC,cAAc,EAAE,CAAC;QACpD,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YAClB,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;QAC/C,CAAC;QAED,IAAI,CAAC,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC;QACjD,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC,GAAG,CAAC,wBAAwB,EAAE,CAAC;QACvD,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QAErB,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,UAAU,CAAC,QAAQ,CAA4B,CAAC;QACtE,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YAClB,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;QAClD,CAAC;QAED,+DAA+D;QAC/D,yEAAyE;QACzE,MAAM,cAAc,GAAG,IAAI,CAAC,MAA6D,CAAC;QAC1F,IAAI,cAAc,CAAC,IAAI,EAAE,CAAC;YACxB,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE;gBAChC,OAAO,CAAC,IAAI,CAAC,uBAAuB,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;gBACpD,IAAI,CAAC,iBAAiB,GAAG,KAAK,CAAC;YACjC,CAAC,CAAC,CAAC;QACL,CAAC;QAED,IAAI,CAAC,gBAAgB,EAAE,CAAC;IAC1B,CAAC;IAED;;;OAGG;IACH,gBAAgB;QACd,IAAI,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM;YAAE,OAAO;QAE1D,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC;QACnC,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC;QAErC,IAAI,CAAC;YACL,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC;gBACrB,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,KAAK,EAAE,eAAe,CAAC,iBAAiB;gBACtC,SAAS,EAAE,eAAe;aAC7B,CAAC,CAAC;YACD,IAAI,CAAC,iBAAiB,GAAG,IAAI,CAAC;QAChC,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO,CAAC,IAAI,CAAC,uCAAuC,EAAE,CAAC,CAAC,CAAC;YACzD,IAAI,CAAC,iBAAiB,GAAG,KAAK,CAAC;QACjC,CAAC;IACH,CAAC;IAED;;OAEG;IACH,gBAAgB;QACd,IAAI,CAAC,IAAI,CAAC,MAAM;YAAE,OAAO,KAAK,CAAC;QAC/B,IAAI,CAAC,IAAI,CAAC,iBAAiB;YAAE,OAAO,IAAI,CAAC;QACzC,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,KAAK,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,KAAK,IAAI,CAAC,UAAU,CAAC;IACxF,CAAC;IAED;;OAEG;IACH,iBAAiB;QACf,IAAI,CAAC,iBAAiB,GAAG,KAAK,CAAC;IACjC,CAAC;IAED;;;OAGG;IACH,aAAa;QACX,IAAI,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM;YAAE,OAAO,KAAK,CAAC;QAEhE,+BAA+B;QAC/B,IAAI,IAAI,CAAC,gBAAgB,EAAE,EAAE,CAAC;YAC5B,IAAI,CAAC,gBAAgB,EAAE,CAAC;QAC1B,CAAC;QAED,OAAO,IAAI,CAAC,iBAAiB,CAAC;IAChC,CAAC;IAED;;;OAGG;IACH,iBAAiB;QACf,IAAI,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC,IAAI,CAAC,iBAAiB;YAAE,OAAO,IAAI,CAAC;QAE1D,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,iBAAiB,EAAE,CAAC;YACjD,IAAI,CAAC,UAAU,EAAE,CAAC;YAClB,OAAO,OAAO,CAAC;QACjB,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,mDAAmD;YACnD,IAAI,CAAC,iBAAiB,GAAG,KAAK,CAAC;YAC/B,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,SAAS;QACP,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC;QAC5C,CAAC;QACD,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,UAAU;QACR,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YAClB,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;QAC7C,CAAC;QACD,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED,SAAS;QACP,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,aAAa;QACX,OAAO,IAAI,CAAC,MAAM,KAAK,IAAI,IAAI,IAAI,CAAC,OAAO,KAAK,IAAI,CAAC;IACvD,CAAC;CACF"}
+{"version":3,"file":"device.js","sourceRoot":"","sources":["../src/device.ts"],"names":[],"mappings":"AAAA;;+DAE+D;AAE/D;;GAEG;AAEH,MAAM,OAAO,YAAY;IACf,OAAO,GAAsB,IAAI,CAAC;IAClC,MAAM,GAAqB,IAAI,CAAC;IAChC,OAAO,GAA4B,IAAI,CAAC;IACxC,MAAM,GAAqB,YAAY,CAAC;IACxC,MAAM,GAA6B,IAAI,CAAC;IACxC,SAAS,GAAW,CAAC,CAAC;IACtB,UAAU,GAAW,CAAC,CAAC;IACvB,iBAAiB,GAAY,KAAK,CAAC;IACnC,UAAU,GAAW,CAAC,CAAC;IAE/B;;OAEG;IACH,KAAK,CAAC,IAAI,CAAC,MAAyB;QAClC,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,CAAC;YACnB,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC;QAC1C,CAAC;QAED,IAAI,CAAC,OAAO,GAAG,MAAM,SAAS,CAAC,GAAG,CAAC,cAAc,EAAE,CAAC;QACpD,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YAClB,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;QAC/C,CAAC;QAED,IAAI,CAAC,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC;QACjD,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC,GAAG,CAAC,wBAAwB,EAAE,CAAC;QACvD,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QAErB,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,UAAU,CAAC,QAAQ,CAA4B,CAAC;QACtE,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YAClB,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;QAClD,CAAC;QAED,+DAA+D;QAC/D,yEAAyE;QACzE,MAAM,cAAc,GAAG,IAAI,CAAC,MAA6D,CAAC;QAC1F,IAAI,cAAc,CAAC,IAAI,EAAE,CAAC;YACxB,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE;gBAChC,OAAO,CAAC,IAAI,CAAC,uBAAuB,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;gBACpD,IAAI,CAAC,iBAAiB,GAAG,KAAK,CAAC;YACjC,CAAC,CAAC,CAAC;QACL,CAAC;QAED,IAAI,CAAC,gBAAgB,EAAE,CAAC;IAC1B,CAAC;IAED;;;OAGG;IACH,gBAAgB;QACd,IAAI,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM;YAAE,OAAO;QAE1D,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC;QACnC,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC;QAErC,IAAI,CAAC;YACL,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC;gBACrB,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,KAAK,EAAE,eAAe,CAAC,iBAAiB;gBACtC,SAAS,EAAE,eAAe;aAC7B,CAAC,CAAC;YACD,IAAI,CAAC,iBAAiB,GAAG,IAAI,CAAC;QAChC,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO,CAAC,IAAI,CAAC,uCAAuC,EAAE,CAAC,CAAC,CAAC;YACzD,IAAI,CAAC,iBAAiB,GAAG,KAAK,CAAC;QACjC,CAAC;IACH,CAAC;IAED;;OAEG;IACH,gBAAgB;QACd,IAAI,CAAC,IAAI,CAAC,MAAM;YAAE,OAAO,KAAK,CAAC;QAC/B,IAAI,CAAC,IAAI,CAAC,iBAAiB;YAAE,OAAO,IAAI,CAAC;QACzC,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,KAAK,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,KAAK,IAAI,CAAC,UAAU,CAAC;IACxF,CAAC;IAED;;OAEG;IACH,iBAAiB;QACf,IAAI,CAAC,iBAAiB,GAAG,KAAK,CAAC;IACjC,CAAC;IAED;;;OAGG;IACH,aAAa;QACX,IAAI,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM;YAAE,OAAO,KAAK,CAAC;QAEhE,+BAA+B;QAC/B,IAAI,IAAI,CAAC,gBAAgB,EAAE,EAAE,CAAC;YAC5B,IAAI,CAAC,gBAAgB,EAAE,CAAC;QAC1B,CAAC;QAED,OAAO,IAAI,CAAC,iBAAiB,CAAC;IAChC,CAAC;IAED;;;OAGG;IACH,iBAAiB;QACf,IAAI,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC,IAAI,CAAC,iBAAiB,EAAE,CAAC;YAC7C,OAAO,IAAI,CAAC;QACd,CAAC;QAED,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,iBAAiB,EAAE,CAAC;YACjD,IAAI,CAAC,UAAU,EAAE,CAAC;YAClB,OAAO,OAAO,CAAC;QACjB,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,mDAAmD;YACnD,IAAI,CAAC,iBAAiB,GAAG,KAAK,CAAC;YAC/B,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,SAAS;QACP,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC;QAC5C,CAAC;QACD,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,UAAU;QACR,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YAClB,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;QAC7C,CAAC;QACD,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED,SAAS;QACP,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,aAAa;QACX,OAAO,IAAI,CAAC,MAAM,KAAK,IAAI,IAAI,IAAI,CAAC,OAAO,KAAK,IAAI,CAAC;IACvD,CAAC;CACF"}

package/dist/federation-registry.d.ts

@@ -0,0 +1,98 @@
+/**
+ * FederationRegistry - Bulletproof multi-model ID management
+ *
+ * Each model gets a unique ID offset, ensuring globally unique IDs across
+ * all federated models. This eliminates ID collisions when multiple IFC
+ * files have overlapping expressIds.
+ *
+ * Inspired by HOOPS Communicator's loadSubtree approach where node IDs
+ * are automatically offset to avoid conflicts.
+ */
+export interface ModelRange {
+    modelId: string;
+    offset: number;
+    maxExpressId: number;
+}
+export interface GlobalIdLookup {
+    modelId: string;
+    expressId: number;
+}
+/**
+ * Central registry for multi-model federation
+ * Manages ID offsets and provides O(1) to-global / O(log N) from-global transformations
+ */
+export declare class FederationRegistry {
+    private modelRanges;
+    private sortedRanges;
+    private nextOffset;
+    /**
+     * Register a new model and get its ID offset
+     * Call this BEFORE adding meshes to the scene
+     *
+     * @param modelId Unique identifier for this model
+     * @param maxExpressId Highest expressId in this model (scan meshes first)
+     * @returns The offset to add to all expressIds for this model
+     */
+    registerModel(modelId: string, maxExpressId: number): number;
+    /**
+     * Unregister a model (when removed from viewer)
+     * Note: The offset space is NOT reclaimed to avoid invalidating any
+     * existing references (selections, undo stack, etc.)
+     */
+    unregisterModel(modelId: string): void;
+    /**
+     * Transform a local expressId to a globally unique ID
+     * O(1) - direct map lookup + addition
+     */
+    toGlobalId(modelId: string, expressId: number): number;
+    /**
+     * Transform a global ID back to model + local expressId
+     * O(log N) - binary search on sorted ranges
+     */
+    fromGlobalId(globalId: number): GlobalIdLookup | null;
+    /**
+     * Get the model ID that owns a global ID (without computing expressId)
+     * O(log N)
+     */
+    getModelForGlobalId(globalId: number): string | null;
+    /**
+     * Get the offset for a model (useful for batch transformations)
+     */
+    getOffset(modelId: string): number | null;
+    /**
+     * Check if a model is registered
+     */
+    hasModel(modelId: string): boolean;
+    /**
+     * Get all registered model IDs
+     */
+    getModelIds(): string[];
+    /**
+     * Get the number of registered models
+     */
+    getModelCount(): number;
+    /**
+     * Get all global IDs for a model (as a range)
+     * Useful for bulk operations like "hide all entities in model X"
+     */
+    getGlobalIdRange(modelId: string): {
+        start: number;
+        end: number;
+    } | null;
+    /**
+     * Check if a global ID belongs to a specific model
+     * O(1) when we know the model
+     */
+    isInModel(globalId: number, modelId: string): boolean;
+    /**
+     * Clear all registrations (for full reset)
+     */
+    clear(): void;
+    /**
+     * Binary search to find the range that could contain a globalId
+     * Returns the range with the largest offset that is <= globalId
+     */
+    private binarySearchRange;
+}
+export declare const federationRegistry: FederationRegistry;
+//# sourceMappingURL=federation-registry.d.ts.map

package/dist/federation-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"federation-registry.d.ts","sourceRoot":"","sources":["../src/federation-registry.ts"],"names":[],"mappings":"AAIA;;;;;;;;;GASG;AAEH,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAMD;;;GAGG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,WAAW,CAAsC;IACzD,OAAO,CAAC,YAAY,CAAoB;IACxC,OAAO,CAAC,UAAU,CAAa;IAE/B;;;;;;;OAOG;IACH,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM;IAuC5D;;;;OAIG;IACH,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAYtC;;;OAGG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM;IAStD;;;OAGG;IACH,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI;IAwBrD;;;OAGG;IACH,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAKpD;;OAEG;IACH,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAIzC;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAIlC;;OAEG;IACH,WAAW,IAAI,MAAM,EAAE;IAIvB;;OAEG;IACH,aAAa,IAAI,MAAM;IAIvB;;;OAGG;IACH,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IASxE;;;OAGG;IACH,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO;IAOrD;;OAEG;IACH,KAAK,IAAI,IAAI;IAMb;;;OAGG;IACH,OAAO,CAAC,iBAAiB;CAsB1B;AAID,eAAO,MAAM,kBAAkB,oBAA2B,CAAC"}

package/dist/federation-registry.js

@@ -0,0 +1,197 @@
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/. */
+// Safety limit - warn before approaching 32-bit limit
+// WebGPU picking uses r32uint (max 4,294,967,295)
+const MAX_SAFE_OFFSET = 2_000_000_000;
+/**
+ * Central registry for multi-model federation
+ * Manages ID offsets and provides O(1) to-global / O(log N) from-global transformations
+ */
+export class FederationRegistry {
+    modelRanges = new Map();
+    sortedRanges = []; // Sorted by offset for binary search
+    nextOffset = 0;
+    /**
+     * Register a new model and get its ID offset
+     * Call this BEFORE adding meshes to the scene
+     *
+     * @param modelId Unique identifier for this model
+     * @param maxExpressId Highest expressId in this model (scan meshes first)
+     * @returns The offset to add to all expressIds for this model
+     */
+    registerModel(modelId, maxExpressId) {
+        // Validate inputs
+        if (!modelId || typeof modelId !== 'string') {
+            throw new Error(`[FederationRegistry] Invalid modelId: ${modelId}`);
+        }
+        if (typeof maxExpressId !== 'number' || !Number.isFinite(maxExpressId) || maxExpressId < 0) {
+            throw new Error(`[FederationRegistry] Invalid maxExpressId: ${maxExpressId} for model ${modelId}`);
+        }
+        // Check for duplicate registration
+        if (this.modelRanges.has(modelId)) {
+            const existing = this.modelRanges.get(modelId);
+            console.warn(`[FederationRegistry] Model ${modelId} already registered with offset ${existing.offset}`);
+            return existing.offset;
+        }
+        // Check for overflow
+        if (this.nextOffset + maxExpressId > MAX_SAFE_OFFSET) {
+            throw new Error(`[FederationRegistry] Cannot register model: would exceed safe ID limit. ` +
+                `Current offset: ${this.nextOffset}, model max ID: ${maxExpressId}. ` +
+                `Please unload some models first.`);
+        }
+        const offset = this.nextOffset;
+        const range = { modelId, offset, maxExpressId };
+        this.modelRanges.set(modelId, range);
+        this.sortedRanges.push(range);
+        // Keep sorted by offset for binary search
+        this.sortedRanges.sort((a, b) => a.offset - b.offset);
+        // Next model starts after this model's range (+1 gap for safety)
+        this.nextOffset = offset + maxExpressId + 1;
+        return offset;
+    }
+    /**
+     * Unregister a model (when removed from viewer)
+     * Note: The offset space is NOT reclaimed to avoid invalidating any
+     * existing references (selections, undo stack, etc.)
+     */
+    unregisterModel(modelId) {
+        const range = this.modelRanges.get(modelId);
+        if (!range) {
+            console.warn(`[FederationRegistry] Cannot unregister unknown model: ${modelId}`);
+            return;
+        }
+        this.modelRanges.delete(modelId);
+        this.sortedRanges = this.sortedRanges.filter(r => r.modelId !== modelId);
+        // Note: nextOffset is NOT reduced - offset space is burned
+    }
+    /**
+     * Transform a local expressId to a globally unique ID
+     * O(1) - direct map lookup + addition
+     */
+    toGlobalId(modelId, expressId) {
+        const range = this.modelRanges.get(modelId);
+        if (!range) {
+            console.warn(`[FederationRegistry] Unknown model: ${modelId}, returning expressId unchanged`);
+            return expressId;
+        }
+        return expressId + range.offset;
+    }
+    /**
+     * Transform a global ID back to model + local expressId
+     * O(log N) - binary search on sorted ranges
+     */
+    fromGlobalId(globalId) {
+        if (this.sortedRanges.length === 0) {
+            return null;
+        }
+        // Binary search to find which range contains this globalId
+        const range = this.binarySearchRange(globalId);
+        if (!range) {
+            return null;
+        }
+        // Verify the globalId is actually within this model's range
+        const localId = globalId - range.offset;
+        if (localId < 0 || localId > range.maxExpressId) {
+            // globalId is in the gap between models
+            return null;
+        }
+        return {
+            modelId: range.modelId,
+            expressId: localId,
+        };
+    }
+    /**
+     * Get the model ID that owns a global ID (without computing expressId)
+     * O(log N)
+     */
+    getModelForGlobalId(globalId) {
+        const result = this.fromGlobalId(globalId);
+        return result?.modelId ?? null;
+    }
+    /**
+     * Get the offset for a model (useful for batch transformations)
+     */
+    getOffset(modelId) {
+        return this.modelRanges.get(modelId)?.offset ?? null;
+    }
+    /**
+     * Check if a model is registered
+     */
+    hasModel(modelId) {
+        return this.modelRanges.has(modelId);
+    }
+    /**
+     * Get all registered model IDs
+     */
+    getModelIds() {
+        return Array.from(this.modelRanges.keys());
+    }
+    /**
+     * Get the number of registered models
+     */
+    getModelCount() {
+        return this.modelRanges.size;
+    }
+    /**
+     * Get all global IDs for a model (as a range)
+     * Useful for bulk operations like "hide all entities in model X"
+     */
+    getGlobalIdRange(modelId) {
+        const range = this.modelRanges.get(modelId);
+        if (!range)
+            return null;
+        return {
+            start: range.offset,
+            end: range.offset + range.maxExpressId,
+        };
+    }
+    /**
+     * Check if a global ID belongs to a specific model
+     * O(1) when we know the model
+     */
+    isInModel(globalId, modelId) {
+        const range = this.modelRanges.get(modelId);
+        if (!range)
+            return false;
+        const localId = globalId - range.offset;
+        return localId >= 0 && localId <= range.maxExpressId;
+    }
+    /**
+     * Clear all registrations (for full reset)
+     */
+    clear() {
+        this.modelRanges.clear();
+        this.sortedRanges = [];
+        this.nextOffset = 0;
+    }
+    /**
+     * Binary search to find the range that could contain a globalId
+     * Returns the range with the largest offset that is <= globalId
+     */
+    binarySearchRange(globalId) {
+        const ranges = this.sortedRanges;
+        if (ranges.length === 0)
+            return null;
+        // If globalId is before first range, no match
+        if (globalId < ranges[0].offset)
+            return null;
+        let lo = 0;
+        let hi = ranges.length - 1;
+        // Find the rightmost range where offset <= globalId
+        while (lo < hi) {
+            const mid = Math.floor((lo + hi + 1) / 2);
+            if (ranges[mid].offset <= globalId) {
+                lo = mid;
+            }
+            else {
+                hi = mid - 1;
+            }
+        }
+        return ranges[lo];
+    }
+}
+// Singleton instance for the application
+// Export both the class (for testing) and a singleton instance
+export const federationRegistry = new FederationRegistry();
+//# sourceMappingURL=federation-registry.js.map

package/dist/federation-registry.js.map

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