@selvajs/visualization 1.6.0-beta.1 → 1.6.0-beta.10

package/dist/render.d.cts

@@ -1,9 +1,9 @@
-import { a as MaterialAppearanceOptions, i as LookPreset, n as Look, r as LookMaterialOverride, t as LOOKS } from "./types-DjPelPRM.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";
-//#region src/shared/errors.d.ts
+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`
@@ -30,8 +30,6 @@ export declare class VisualizationError extends Error {
     originalError?: Error;
   });
 }
-//#endregion
-//#region src/shared/logger.d.ts
 /**
  * Logging facility for the visualization package. Deliberately local rather than imported from
  * `@selvajs/compute` (logging isn't a compute concern). Mirrors compute's logger shape so a host
@@ -46,8 +44,6 @@ interface Logger {
 export declare function getLogger(): Logger;
 export declare function setLogger(logger: Logger | Console | null): void;
 export declare function enableDebugLogging(): void;
-//#endregion
-//#region src/shared/looks.d.ts
 /** The look applied when the caller passes no `look` option. */
 export declare const DEFAULT_LOOK: Look;
 /**
@@ -62,8 +58,6 @@ export declare const DEFAULT_LOOK: Look;
 export declare const LOOK_PRESETS: Record<Look, LookPreset>;
 /** Baked at parse time (not toggleable at runtime). */
 export declare function materialAppearanceForLook(look: Look): MaterialAppearanceOptions;
-//#endregion
-//#region src/render/types.d.ts
 type CameraConfig = {
   position?: THREE.Vector3;
   fov?: number;
@@ -128,8 +122,26 @@ 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;
+  /**
+   * Frames averaged while the camera rests, for soft shadows and clean edges. Needs the composer,
+   * so looks without AO or bloom skip it. Costs nothing while orbiting. Default 32, or 0 on a
+   * `lowPower` device; 0 turns it off.
+   */
+  idleRefineFrames?: number;
+  /**
+   * Orbit frames slower than this fade ambient occlusion out while the camera moves, its largest
+   * cost. Needs `idleRefineFrames` to fade back in. Default 22. 0 always does; `Infinity` never does.
+   */
+  lightOrbitFrameMs?: number;
   /** 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;
   /**
@@ -158,7 +170,7 @@ type EdgesConfig = {
   thresholdAngle?: number;
   /** Default true. */
   distanceFade?: boolean;
-  /** Default 4M. */
+  /** Default 8M. */
   maxTriangles?: number;
   /** Default 2M. */
   maxSegments?: number;
@@ -262,8 +274,6 @@ type EventConfig = {
   /** Fires every animation frame, after controls update and before render. */
   onFrame?: (delta: number) => void;
 };
-//#endregion
-//#region src/render/camera-controller.d.ts
 /**
  * Runtime camera control: preset views, perspective⇄orthographic toggle, rotate lock.
  *
@@ -296,8 +306,6 @@ interface CameraController {
   /** Cancel any in-flight camera tween. Call on viewer teardown so ticks can't touch disposed controls. */
   dispose(): void;
 }
-//#endregion
-//#region src/render/edges/options.d.ts
 /** Crisp boundary/crease edges overlaid on meshes. See the layer README for depth/perf strategy. */
 interface EdgeOptions {
   /** Default: each overlay derives its color from its own mesh's material (see {@link DEFAULT_EDGE_COLOR}). */
@@ -316,9 +324,9 @@ interface EdgeOptions {
    */
   distanceFade?: boolean;
   /**
-   * Skip meshes above this triangle count entirely (default 4M) — extraction time is linear in
-   * triangles, and past this bound even the worker path burns seconds for a look the screen-space
-   * fallback approximates at constant cost. Skipped meshes are tagged
+   * Skip meshes above this triangle count entirely (default 8M). Extraction time and memory are
+   * linear in triangles: 8M is about 0.7 s in the worker and a few hundred MB of scratch, and past it
+   * the screen-space fallback approximates the look at constant cost. Skipped meshes are tagged
    * `userData.edgesSkipped = 'triangle-cap'`.
    */
   maxTriangles?: number;
@@ -341,8 +349,6 @@ interface EdgeOptions {
    */
   maxOverlays?: number;
 }
-//#endregion
-//#region src/render/grid.d.ts
 interface Grid {
   /** Tagged `userData.id = 'grid'` so pick/fit code skips it. */
   readonly object: THREE.Mesh;
@@ -356,8 +362,6 @@ interface Grid {
   setVisible(visible: boolean): void;
   dispose(): void;
 }
-//#endregion
-//#region src/render/label-layer.d.ts
 interface LabelHandle {
   readonly object: CSS2DObject;
   setPosition(position: THREE.Vector3): void;
@@ -371,8 +375,6 @@ interface LabelLayer {
   setSize(width: number, height: number): void;
   dispose(): void;
 }
-//#endregion
-//#region src/render/measure.d.ts
 /**
  * Two-click distance measurement. Click a point, click a second, read the distance off a label on
  * the connecting line; a third click starts fresh.
@@ -409,8 +411,6 @@ export declare function snapToVertex(hit: THREE.Intersection, camera: THREE.Came
   width: number;
   height: number;
 }, snapPixels: number): THREE.Vector3;
-//#endregion
-//#region src/render/tool-registry.d.ts
 /**
  * A tool that can claim canvas pointer input.
  *
@@ -463,8 +463,6 @@ export declare function pointerToNdc(event: MouseEvent, canvas: HTMLCanvasElemen
   x: number;
   y: number;
 };
-//#endregion
-//#region src/render/view-gizmo.d.ts
 /**
  * Corner nav-cube/axis gizmo. Uses three's {@link ViewHelper} only as the rendered widget, not its
  * click→animate behavior: ViewHelper's snap assumes Y-up and animates straight onto the up axis,
@@ -486,8 +484,18 @@ interface ViewGizmo {
   isVisible(): boolean;
   dispose(): void;
 }
-//#endregion
-//#region src/render/scene-setup/viewer.d.ts
+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;
+  memberIndex: number | null;
+}
 interface ThreeViewer {
   scene: THREE.Scene;
   camera: THREE.PerspectiveCamera;
@@ -534,7 +542,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
@@ -563,6 +576,16 @@ interface ThreeViewer {
   dispose: () => void;
   fitToView: () => void;
   clearSelection: () => void;
+  /**
+   * Selects from outside the viewport (an outliner's rows), replacing any current selection and
+   * firing no events. `[]` drops a selection made here and leaves one made by a canvas click.
+   */
+  selectEntries: (targets: SelectionTarget[]) => void;
+  /**
+   * Tints one object, or one member of a merged mesh, as a preview (an outliner row under the
+   * pointer), lighter than a selection. `null` clears it. A selected object keeps its selection tint.
+   */
+  setHover: (object: THREE.Object3D | null, memberIndex?: number | null) => void;
   /**
    * Adds host-owned geometry that survives `updateScene` solves and counts for fit-to-view.
    * Pass `appId` to scope it to one app (`userData.source = 'app:<id>'`) so `clearUserGeometry`
@@ -575,11 +598,7 @@ interface ThreeViewer {
   /** Removes and disposes geometry added via `addUserGeometry` — one app's, or all of it. */
   clearUserGeometry: (appId?: string) => void;
 }
-//#endregion
-//#region src/render/scene-setup/init-three.d.ts
 export declare const initThree: (canvas: HTMLCanvasElement, options?: ThreeInitializerOptions) => ThreeViewer;
-//#endregion
-//#region src/render/scene-ownership.d.ts
 /** Geometry produced by a solve. Replaced wholesale on the next one. */
 export declare const SOURCE_COMPUTE = "compute";
 /**
@@ -601,10 +620,7 @@ export declare function isHostOwned(object: THREE.Object3D): boolean;
  * `clearUserGeometry()` does.
  */
 export declare function isOwnedBy(object: THREE.Object3D, id?: string): boolean;
-//#endregion
-//#region src/render/three-helpers.d.ts
 /** 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;
-//#endregion
-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,9 +1,9 @@
-import { a as MaterialAppearanceOptions, i as LookPreset, n as Look, r as LookMaterialOverride, t as LOOKS } from "./types-DjPelPRM.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";
-//#region src/shared/errors.d.ts
 /**
  * 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`
@@ -30,8 +30,6 @@ export declare class VisualizationError extends Error {
     originalError?: Error;
   });
 }
-//#endregion
-//#region src/shared/logger.d.ts
 /**
  * Logging facility for the visualization package. Deliberately local rather than imported from
  * `@selvajs/compute` (logging isn't a compute concern). Mirrors compute's logger shape so a host
@@ -46,8 +44,6 @@ interface Logger {
 export declare function getLogger(): Logger;
 export declare function setLogger(logger: Logger | Console | null): void;
 export declare function enableDebugLogging(): void;
-//#endregion
-//#region src/shared/looks.d.ts
 /** The look applied when the caller passes no `look` option. */
 export declare const DEFAULT_LOOK: Look;
 /**
@@ -62,8 +58,6 @@ export declare const DEFAULT_LOOK: Look;
 export declare const LOOK_PRESETS: Record<Look, LookPreset>;
 /** Baked at parse time (not toggleable at runtime). */
 export declare function materialAppearanceForLook(look: Look): MaterialAppearanceOptions;
-//#endregion
-//#region src/render/types.d.ts
 type CameraConfig = {
   position?: THREE.Vector3;
   fov?: number;
@@ -128,8 +122,26 @@ 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;
+  /**
+   * Frames averaged while the camera rests, for soft shadows and clean edges. Needs the composer,
+   * so looks without AO or bloom skip it. Costs nothing while orbiting. Default 32, or 0 on a
+   * `lowPower` device; 0 turns it off.
+   */
+  idleRefineFrames?: number;
+  /**
+   * Orbit frames slower than this fade ambient occlusion out while the camera moves, its largest
+   * cost. Needs `idleRefineFrames` to fade back in. Default 22. 0 always does; `Infinity` never does.
+   */
+  lightOrbitFrameMs?: number;
   /** 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;
   /**
@@ -158,7 +170,7 @@ type EdgesConfig = {
   thresholdAngle?: number;
   /** Default true. */
   distanceFade?: boolean;
-  /** Default 4M. */
+  /** Default 8M. */
   maxTriangles?: number;
   /** Default 2M. */
   maxSegments?: number;
@@ -262,8 +274,6 @@ type EventConfig = {
   /** Fires every animation frame, after controls update and before render. */
   onFrame?: (delta: number) => void;
 };
-//#endregion
-//#region src/render/camera-controller.d.ts
 /**
  * Runtime camera control: preset views, perspective⇄orthographic toggle, rotate lock.
  *
@@ -296,8 +306,6 @@ interface CameraController {
   /** Cancel any in-flight camera tween. Call on viewer teardown so ticks can't touch disposed controls. */
   dispose(): void;
 }
-//#endregion
-//#region src/render/edges/options.d.ts
 /** Crisp boundary/crease edges overlaid on meshes. See the layer README for depth/perf strategy. */
 interface EdgeOptions {
   /** Default: each overlay derives its color from its own mesh's material (see {@link DEFAULT_EDGE_COLOR}). */
@@ -316,9 +324,9 @@ interface EdgeOptions {
    */
   distanceFade?: boolean;
   /**
-   * Skip meshes above this triangle count entirely (default 4M) — extraction time is linear in
-   * triangles, and past this bound even the worker path burns seconds for a look the screen-space
-   * fallback approximates at constant cost. Skipped meshes are tagged
+   * Skip meshes above this triangle count entirely (default 8M). Extraction time and memory are
+   * linear in triangles: 8M is about 0.7 s in the worker and a few hundred MB of scratch, and past it
+   * the screen-space fallback approximates the look at constant cost. Skipped meshes are tagged
    * `userData.edgesSkipped = 'triangle-cap'`.
    */
   maxTriangles?: number;
@@ -341,8 +349,6 @@ interface EdgeOptions {
    */
   maxOverlays?: number;
 }
-//#endregion
-//#region src/render/grid.d.ts
 interface Grid {
   /** Tagged `userData.id = 'grid'` so pick/fit code skips it. */
   readonly object: THREE.Mesh;
@@ -356,8 +362,6 @@ interface Grid {
   setVisible(visible: boolean): void;
   dispose(): void;
 }
-//#endregion
-//#region src/render/label-layer.d.ts
 interface LabelHandle {
   readonly object: CSS2DObject;
   setPosition(position: THREE.Vector3): void;
@@ -371,8 +375,6 @@ interface LabelLayer {
   setSize(width: number, height: number): void;
   dispose(): void;
 }
-//#endregion
-//#region src/render/measure.d.ts
 /**
  * Two-click distance measurement. Click a point, click a second, read the distance off a label on
  * the connecting line; a third click starts fresh.
@@ -409,8 +411,6 @@ export declare function snapToVertex(hit: THREE.Intersection, camera: THREE.Came
   width: number;
   height: number;
 }, snapPixels: number): THREE.Vector3;
-//#endregion
-//#region src/render/tool-registry.d.ts
 /**
  * A tool that can claim canvas pointer input.
  *
@@ -463,8 +463,6 @@ export declare function pointerToNdc(event: MouseEvent, canvas: HTMLCanvasElemen
   x: number;
   y: number;
 };
-//#endregion
-//#region src/render/view-gizmo.d.ts
 /**
  * Corner nav-cube/axis gizmo. Uses three's {@link ViewHelper} only as the rendered widget, not its
  * click→animate behavior: ViewHelper's snap assumes Y-up and animates straight onto the up axis,
@@ -486,8 +484,18 @@ interface ViewGizmo {
   isVisible(): boolean;
   dispose(): void;
 }
-//#endregion
-//#region src/render/scene-setup/viewer.d.ts
+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;
+  memberIndex: number | null;
+}
 interface ThreeViewer {
   scene: THREE.Scene;
   camera: THREE.PerspectiveCamera;
@@ -534,7 +542,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
@@ -563,6 +576,16 @@ interface ThreeViewer {
   dispose: () => void;
   fitToView: () => void;
   clearSelection: () => void;
+  /**
+   * Selects from outside the viewport (an outliner's rows), replacing any current selection and
+   * firing no events. `[]` drops a selection made here and leaves one made by a canvas click.
+   */
+  selectEntries: (targets: SelectionTarget[]) => void;
+  /**
+   * Tints one object, or one member of a merged mesh, as a preview (an outliner row under the
+   * pointer), lighter than a selection. `null` clears it. A selected object keeps its selection tint.
+   */
+  setHover: (object: THREE.Object3D | null, memberIndex?: number | null) => void;
   /**
    * Adds host-owned geometry that survives `updateScene` solves and counts for fit-to-view.
    * Pass `appId` to scope it to one app (`userData.source = 'app:<id>'`) so `clearUserGeometry`
@@ -575,11 +598,7 @@ interface ThreeViewer {
   /** Removes and disposes geometry added via `addUserGeometry` — one app's, or all of it. */
   clearUserGeometry: (appId?: string) => void;
 }
-//#endregion
-//#region src/render/scene-setup/init-three.d.ts
 export declare const initThree: (canvas: HTMLCanvasElement, options?: ThreeInitializerOptions) => ThreeViewer;
-//#endregion
-//#region src/render/scene-ownership.d.ts
 /** Geometry produced by a solve. Replaced wholesale on the next one. */
 export declare const SOURCE_COMPUTE = "compute";
 /**
@@ -601,10 +620,7 @@ export declare function isHostOwned(object: THREE.Object3D): boolean;
  * `clearUserGeometry()` does.
  */
 export declare function isOwnedBy(object: THREE.Object3D, id?: string): boolean;
-//#endregion
-//#region src/render/three-helpers.d.ts
 /** 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;
-//#endregion
-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