@selvajs/visualization 1.6.0-beta.8 → 1.6.0-beta.9

package/dist/render.d.cts

@@ -1,8 +1,9 @@
-import { a as MaterialAppearanceOptions, i as LookPreset, n as Look, r as LookMaterialOverride, t as LOOKS } from "./types-P5PyfYYE.cjs";
+import { a as LookPreset, i as LookMaterialOverride, n as LOOKS, o as MaterialAppearanceOptions, r as Look, t as BloomOptions } from "./types-DW_qU4-Y.cjs";
 import * as THREE from "three";
 import { OrbitControls } from "three/addons/controls/OrbitControls.js";
 import "three/addons/lines/LineSegments2.js";
 import { CSS2DObject } from "three/addons/renderers/CSS2DRenderer.js";
+import "three/addons/postprocessing/Pass.js";
 /**
  * Errors for the visualization package. Replaces `@selvajs/compute`'s `RhinoComputeError`, which
  * mis-named failures on paths (e.g. the plugin WebSocket) that never touch Rhino.Compute. `code`
@@ -121,8 +122,15 @@ type RenderConfig = {
   toneMapping?: THREE.ToneMapping;
   toneMappingExposure?: number;
   preserveDrawingBuffer?: boolean;
+  /**
+   * Cuts what the look's `lowPower` fields name; only `night` has any. Default: on for a touch
+   * device with a phone-sized screen. Set it to force the tier on or off.
+   */
+  lowPower?: boolean;
   /** Default false — switches rendering from `renderer.render` to an EffectComposer, which costs more. */
   ambientOcclusion?: boolean;
+  /** Glow around emissive parts. The look decides; `night` sets it. */
+  bloom?: BloomOptions;
   /** AO strength 0–1 when {@link RenderConfig.ambientOcclusion} is on. Default 1. */
   aoIntensity?: number;
   /**
@@ -465,6 +473,13 @@ interface ViewGizmo {
   isVisible(): boolean;
   dispose(): void;
 }
+type SetLookOptions = {
+  /**
+   * Skips the sync, which walks every glowing part. The caller runs `syncEmissiveLights()` itself
+   * once visibility settles.
+   */
+  deferEmissiveLights?: boolean;
+};
 /** One thing to select: a whole object, or one member of a merged mesh. */
 interface SelectionTarget {
   object: THREE.Object3D;
@@ -516,7 +531,12 @@ interface ThreeViewer {
    * Retunes lighting/material (tone mapping, fill, IBL, AO) only — never edges/grid. Overwrites
    * any granular lighting dials set earlier with the preset's values.
    */
-  setLook: (look: Look) => void;
+  setLook: (look: Look, options?: SetLookOptions) => void;
+  /**
+   * Call after showing or hiding objects, solve output included: a look that lights the scene from
+   * glowing parts reads what is drawn when it runs, so a hidden lamp would keep shining.
+   */
+  syncEmissiveLights: () => void;
   /**
    * Raising `hemisphereIntensity` is the most effective way to lift shadowed surfaces a dark HDR
    * leaves black. Lazily creates the hemisphere light if the viewer was built without one; `0` turns
@@ -591,5 +611,5 @@ export declare function isHostOwned(object: THREE.Object3D): boolean;
 export declare function isOwnedBy(object: THREE.Object3D, id?: string): boolean;
 /** Replaces scene content with `meshes`, rescales the camera frustum to fit, and (first call only) positions the camera/controls. */
 export declare function updateScene(scene: THREE.Scene, meshes: THREE.Object3D[], camera: THREE.PerspectiveCamera, controls: OrbitControls, initialPositionSet: boolean): void;
-export { type CameraConfig, type CameraController, type CameraProjection, type ControlsConfig, type EdgesConfig, type EnvironmentConfig, type ErrorCode, type EventConfig, type FloorConfig, type GizmoConfig, type Grid, type GridConfig, LOOKS, type LabelHandle, type LabelLayer, type LightingConfig, type Logger, type Look, type LookMaterialOverride, type LookPreset, type MaterialAppearanceOptions, type MeasureConfig, type MeasureTool, type PointerTool, type RenderConfig, type ThreeInitializerOptions, type ThreeViewer, type ToolRegistration, type ToolRegistry, type ViewGizmo, type ViewPreset };
+export { type CameraConfig, type CameraController, type CameraProjection, type ControlsConfig, type EdgesConfig, type EnvironmentConfig, type ErrorCode, type EventConfig, type FloorConfig, type GizmoConfig, type Grid, type GridConfig, LOOKS, type LabelHandle, type LabelLayer, type LightingConfig, type Logger, type Look, type LookMaterialOverride, type LookPreset, type MaterialAppearanceOptions, type MeasureConfig, type MeasureTool, type PointerTool, type RenderConfig, type SetLookOptions, type ThreeInitializerOptions, type ThreeViewer, type ToolRegistration, type ToolRegistry, type ViewGizmo, type ViewPreset };
 //# sourceMappingURL=render.d.cts.map

package/dist/render.d.ts

@@ -1,7 +1,8 @@
-import { a as MaterialAppearanceOptions, i as LookPreset, n as Look, r as LookMaterialOverride, t as LOOKS } from "./types-P5PyfYYE.js";
+import { a as LookPreset, i as LookMaterialOverride, n as LOOKS, o as MaterialAppearanceOptions, r as Look, t as BloomOptions } from "./types-DW_qU4-Y.js";
 import * as THREE from "three";
 import { LineSegments2 } from "three/addons/lines/LineSegments2.js";
 import { CSS2DObject } from "three/addons/renderers/CSS2DRenderer.js";
+import { Pass } from "three/addons/postprocessing/Pass.js";
 import { OrbitControls } from "three/addons/controls/OrbitControls.js";
 /**
  * Errors for the visualization package. Replaces `@selvajs/compute`'s `RhinoComputeError`, which
@@ -121,8 +122,15 @@ type RenderConfig = {
   toneMapping?: THREE.ToneMapping;
   toneMappingExposure?: number;
   preserveDrawingBuffer?: boolean;
+  /**
+   * Cuts what the look's `lowPower` fields name; only `night` has any. Default: on for a touch
+   * device with a phone-sized screen. Set it to force the tier on or off.
+   */
+  lowPower?: boolean;
   /** Default false — switches rendering from `renderer.render` to an EffectComposer, which costs more. */
   ambientOcclusion?: boolean;
+  /** Glow around emissive parts. The look decides; `night` sets it. */
+  bloom?: BloomOptions;
   /** AO strength 0–1 when {@link RenderConfig.ambientOcclusion} is on. Default 1. */
   aoIntensity?: number;
   /**
@@ -465,6 +473,13 @@ interface ViewGizmo {
   isVisible(): boolean;
   dispose(): void;
 }
+type SetLookOptions = {
+  /**
+   * Skips the sync, which walks every glowing part. The caller runs `syncEmissiveLights()` itself
+   * once visibility settles.
+   */
+  deferEmissiveLights?: boolean;
+};
 /** One thing to select: a whole object, or one member of a merged mesh. */
 interface SelectionTarget {
   object: THREE.Object3D;
@@ -516,7 +531,12 @@ interface ThreeViewer {
    * Retunes lighting/material (tone mapping, fill, IBL, AO) only — never edges/grid. Overwrites
    * any granular lighting dials set earlier with the preset's values.
    */
-  setLook: (look: Look) => void;
+  setLook: (look: Look, options?: SetLookOptions) => void;
+  /**
+   * Call after showing or hiding objects, solve output included: a look that lights the scene from
+   * glowing parts reads what is drawn when it runs, so a hidden lamp would keep shining.
+   */
+  syncEmissiveLights: () => void;
   /**
    * Raising `hemisphereIntensity` is the most effective way to lift shadowed surfaces a dark HDR
    * leaves black. Lazily creates the hemisphere light if the viewer was built without one; `0` turns
@@ -591,5 +611,5 @@ export declare function isHostOwned(object: THREE.Object3D): boolean;
 export declare function isOwnedBy(object: THREE.Object3D, id?: string): boolean;
 /** Replaces scene content with `meshes`, rescales the camera frustum to fit, and (first call only) positions the camera/controls. */
 export declare function updateScene(scene: THREE.Scene, meshes: THREE.Object3D[], camera: THREE.PerspectiveCamera, controls: OrbitControls, initialPositionSet: boolean): void;
-export { type CameraConfig, type CameraController, type CameraProjection, type ControlsConfig, type EdgesConfig, type EnvironmentConfig, type ErrorCode, type EventConfig, type FloorConfig, type GizmoConfig, type Grid, type GridConfig, LOOKS, type LabelHandle, type LabelLayer, type LightingConfig, type Logger, type Look, type LookMaterialOverride, type LookPreset, type MaterialAppearanceOptions, type MeasureConfig, type MeasureTool, type PointerTool, type RenderConfig, type ThreeInitializerOptions, type ThreeViewer, type ToolRegistration, type ToolRegistry, type ViewGizmo, type ViewPreset };
+export { type CameraConfig, type CameraController, type CameraProjection, type ControlsConfig, type EdgesConfig, type EnvironmentConfig, type ErrorCode, type EventConfig, type FloorConfig, type GizmoConfig, type Grid, type GridConfig, LOOKS, type LabelHandle, type LabelLayer, type LightingConfig, type Logger, type Look, type LookMaterialOverride, type LookPreset, type MaterialAppearanceOptions, type MeasureConfig, type MeasureTool, type PointerTool, type RenderConfig, type SetLookOptions, type ThreeInitializerOptions, type ThreeViewer, type ToolRegistration, type ToolRegistry, type ViewGizmo, type ViewPreset };
 //# sourceMappingURL=render.d.ts.map