viral-viewer-2 7.2.3 → 7.2.4

package/dist/components/custom-objects/viral-batched-mesh.d.ts

@@ -2,11 +2,6 @@ import { Box3, BufferGeometry, type Color, type Material, Mesh, Vector3 } from "
 import { type LineMaterial } from "three/examples/jsm/Addons";
 import { type BufferElement } from "../..";
 import type { WorkerThreadPool } from "../worker/base/worker-pool";
-/**
- * Special alpha value to mark selected vertices for fast outline detection.
- * The AlphaSelectionOutlinePass detects this value with ZERO extra render passes.
- */
-export declare const SELECTION_ALPHA = 0.99;
 export declare class ViralBatchedMesh extends Mesh {
     globalMaterialIndex: number;
     private workerPool;
@@ -115,13 +110,6 @@ export declare class ViralBatchedMesh extends Mesh {
         elementId: string;
     }[];
     unselect(): void;
-    /**
-     * Set alpha value for elements (used for selection marking)
-     * This is VERY fast - only updates alpha channel, no geometry copying
-     *
-     * When setting alpha to 1.0 (removing selection), respects hidden/isolated state
-     */
-    private _setSelectionAlpha;
     /**
      * Hide elements by setting their alpha to 0 (GPU-accelerated)
      * Hidden elements are discarded in fragment shader - no rendering cost

package/dist/components/custom-objects/viral-bim-world.d.ts

@@ -11,6 +11,7 @@ import { ViralInstancedMeshV2 } from "./viral-instanced-mesh-v2";
  */
 export declare class ViralBIMWorld extends Mesh {
     workerPool: WorkerThreadPool | null;
+    private _mergePositionsWorker;
     bimModels: ViralBIMModel[];
     constructor();
     private _initializeWorkerPool;
@@ -98,6 +99,11 @@ export declare class ViralBIMWorld extends Mesh {
      * @returns Float32Array of positions or null if no selection
      */
     getSelectedElementsPositions(): Float32Array | null;
+    /**
+     * Async version — offloads vertex merging to a Web Worker so the main thread stays unblocked.
+     * Automatically cancels any in-flight request when called again.
+     */
+    getSelectedElementsPositionsAsync(): Promise<Float32Array | null>;
     /**
      * Changes the color of multiple elements in the merged mesh.
      * Works with RGBA color buffer (preserves existing alpha values)

package/dist/components/custom-objects/viral-instanced-mesh-v2.d.ts

@@ -1,11 +1,6 @@
 import { Box3, BufferGeometry, Color, InstancedMesh, type Material, Matrix4, Object3D, Vector3 } from "three";
 import { type LineMaterial } from "three/examples/jsm/Addons";
 import { type BufferElement } from "../..";
-/**
- * Special alpha value to mark selected instances for fast outline detection.
- * Note: Instanced meshes use a separate instanceSelected attribute instead of alpha.
- */
-export declare const SELECTION_ALPHA = 0.99;
 export declare class ViralInstancedMeshV2 extends Object3D {
     protected material?: Material | undefined;
     globalMaterialIndex: number;
@@ -56,12 +51,6 @@ export declare class ViralInstancedMeshV2 extends Object3D {
         };
     }[]): void;
     unselect(): void;
-    /**
-     * Set instance selection state for fast outline detection
-     * @param elements - Elements to set selection for
-     * @param selected - 1.0 = selected, 0.0 = not selected
-     */
-    private _setInstanceSelection;
     /**
      * Changes the color of multiple elements.
      * @param elements - An array of elements, each containing `modelId` and `elementId`.
@@ -174,10 +163,7 @@ export declare class ViralInstancedMeshV2 extends Object3D {
      */
     isElementVisible(modelId: string, elementId: string): boolean;
     /**
-     * Inject per-instance opacity and selection shader into material
-     * Enables:
-     * - Per-instance opacity (ghosting, hiding)
-     * - Selection alpha marker (for fast outline detection via AlphaSelectionOutlinePass)
+     * Inject per-instance opacity shader into material
      * Must be called after material is set and before rendering
      */
     injectOpacityShader(): void;
@@ -185,11 +171,6 @@ export declare class ViralInstancedMeshV2 extends Object3D {
      * Ensure all instanced meshes have opacity attribute
      */
     private _ensureOpacityAttributes;
-    /**
-     * Ensure all instanced meshes have selection attribute
-     * Used for fast outline detection via AlphaSelectionOutlinePass
-     */
-    private _ensureSelectionAttributes;
     /**
      * Update opacity for specific instances
      */

package/dist/components/post-processing/post-processing-renderer.d.ts

@@ -6,7 +6,6 @@ import { ShaderPass } from "three/examples/jsm/postprocessing/ShaderPass";
 import { SMAAPass } from "three/examples/jsm/postprocessing/SMAAPass";
 import { type ViralViewerApi } from "../..";
 import { DevicePerformanceChecker } from "../../utils/device";
-import { AlphaSelectionOutlinePass } from "./alpha-selection-outline-pass";
 import { type ScreenSpaceEdgesOptions, ScreenSpaceEdgesPass } from "./screen-space-edges-pass";
 import { type SelectionOutlineOptions, SelectionOutlinePass } from "./selection-outline-pass";
 export declare class PostProcessingRenderer {
@@ -27,7 +26,6 @@ export declare class PostProcessingRenderer {
     outlinePass: OutlinePass | null;
     screenSpaceEdgesPass: ScreenSpaceEdgesPass | null;
     selectionOutlinePass: SelectionOutlinePass | null;
-    alphaSelectionOutlinePass: AlphaSelectionOutlinePass | null;
     n8aoPass: any;
     perfChecker: DevicePerformanceChecker;
     constructor(renderer: WebGLRenderer, viralViewerApi: ViralViewerApi);
@@ -160,43 +158,4 @@ export declare class PostProcessingRenderer {
      * Set selection outline thickness in pixels
      */
     setSelectionOutlineThickness(thickness: number): void;
-    /**
-     * Initialize alpha-based selection outline pass
-     * ZERO extra render passes - detects selection via alpha channel in main render
-     * Cost: 1 fullscreen pass only (no geometry re-render)
-     *
-     * This is MUCH faster than SelectionOutlinePass for large selections
-     * Works with both batched meshes (per-vertex alpha) and instanced meshes (per-instance alpha)
-     */
-    initAlphaSelectionOutlinePass(): void;
-    /**
-     * Enable alpha selection outline rendering
-     */
-    enableAlphaSelectionOutline(): void;
-    /**
-     * Disable alpha selection outline rendering
-     */
-    disableAlphaSelectionOutline(): void;
-    /**
-     * Bypass alpha selection outline (instant, zero cost)
-     */
-    bypassAlphaSelectionOutline(): void;
-    /**
-     * Resume alpha selection outline after bypassing
-     */
-    resumeAlphaSelectionOutline(): void;
-    /**
-     * Set alpha selection outline color
-     */
-    setAlphaSelectionOutlineColor(color: Color | number | string): void;
-    /**
-     * Set alpha selection outline thickness in pixels
-     */
-    setAlphaSelectionOutlineThickness(thickness: number): void;
-    /**
-     * Update alpha selection outline state
-     * Call this when selection changes
-     * @param hasSelection - Whether there's any selection active
-     */
-    updateAlphaSelectionOutline(hasSelection: boolean): void;
 }

package/dist/components/post-processing/selection-outline-pass.d.ts

@@ -36,6 +36,8 @@ export declare class SelectionOutlinePass extends Pass {
     private maskScene;
     private selectionMesh;
     private selectionGeometry;
+    private selectionBuffer;
+    private selectionAttribute;
     private fsQuad;
     private hasSelection;
     /**

package/dist/components/visibility-manager/viral-visibility-manager.d.ts

@@ -5,6 +5,8 @@ export declare class ViralVisibilityManager {
     private viralViewerApi;
     /** Whether selection outline is enabled (default: true) */
     private _selectionOutlineEnabled;
+    /** Whether an outline update is already scheduled for the next frame */
+    private _outlineUpdateScheduled;
     constructor(viralViewerApi: ViralViewerApi);
     /**
      * show all elements and reset back to normal visualization
@@ -167,6 +169,12 @@ export declare class ViralVisibilityManager {
      * Uses merged geometry for efficient rendering
      */
     updateSelectionOutline(): void;
+    /**
+     * Schedule outline update for the next animation frame.
+     * Batches multiple rapid selection changes into a single update.
+     * Uses Web Worker to avoid blocking the main thread.
+     */
+    private scheduleOutlineUpdate;
     /**
      * Enable selection outline effect
      */
@@ -184,40 +192,6 @@ export declare class ViralVisibilityManager {
      * Get whether selection outline mode is enabled
      */
     get selectionOutlineEnabled(): boolean;
-    /** Whether alpha selection outline is enabled (default: false, as it requires opt-in) */
-    private _alphaSelectionOutlineEnabled;
-    /**
-     * Update alpha selection outline state
-     * This is MUCH faster than updateSelectionOutline() - no geometry copying needed
-     */
-    updateAlphaSelectionOutline(): void;
-    /**
-     * Enable alpha selection outline effect
-     * This is the FAST outline mode - constant cost regardless of selection size
-     */
-    enableAlphaSelectionOutline(): void;
-    /**
-     * Disable alpha selection outline effect
-     */
-    disableAlphaSelectionOutline(): void;
-    /**
-     * Set whether alpha selection outline mode is enabled
-     * This is the recommended mode for large selections (1000+ elements)
-     * @param enabled - true to enable, false to disable
-     */
-    setAlphaSelectionOutlineMode(enabled: boolean): void;
-    /**
-     * Get whether alpha selection outline mode is enabled
-     */
-    get alphaSelectionOutlineEnabled(): boolean;
-    /**
-     * Bypass alpha selection outline (fast, for camera movement)
-     */
-    bypassAlphaSelectionOutline(): void;
-    /**
-     * Resume alpha selection outline after bypass
-     */
-    resumeAlphaSelectionOutline(): void;
     enableNight(): void;
     disableNight(): void;
     enableSectionBox(): void;

package/dist/components/worker/merge-positions.worker.d.ts

@@ -0,0 +1,19 @@
+export declare class MergePositionsWorker {
+    private _worker;
+    private _resolve;
+    private _requestId;
+    constructor();
+    /**
+     * Merge selected element positions in a background thread.
+     * Cancels any in-flight request automatically.
+     */
+    merge(bufferElements: {
+        buffer: Float32Array | null;
+        modelId: number;
+        instances: {
+            elementId: string;
+            transform: number[];
+        }[];
+    }[], selectedKeys: string[]): Promise<Float32Array | null>;
+    dispose(): void;
+}

package/dist/components/worker-script/merge-positions.script.d.ts

@@ -0,0 +1 @@
+export declare const workerCode: any;