@selvajs/compute 3.1.0-beta.5 → 3.1.0-beta.7

package/dist/visualization-ET5JQHLQ.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/home/runner/work/selva-compute/selva-compute/dist/visualization-ET5JQHLQ.cjs"],"names":[],"mappings":"AAAA,iIAA6S,gCAA6B,62DAAg4B","file":"/home/runner/work/selva-compute/selva-compute/dist/visualization-ET5JQHLQ.cjs"}

package/dist/visualization-I6ZHBKFN.js

@@ -0,0 +1,2 @@
+import{A as I,B as L,C as R,D as S,E as D,F as B,G,H as P,I as u,J as F,K as b,L as N,M as V,a as e,b as r,c as o,d as t,e as a,f as s,g as p,h as i,i as n,j as m,k as l,l as f,m as y,n as C,o as x,p as d,q as h,r as E,s as M,t as _,u as c,v as A,w as g,x as O,y as T,z as j}from"./chunk-EQ7EMYF6.js";import"./chunk-WPB2LKCD.js";export{g as BINARY_MESH_MAGIC,T as BINARY_MESH_VERSION,O as COMPRESSED_MESH_MAGIC,n as EDGE_USERDATA_KIND,R as FLAG_DELTA_ENCODED,I as FLAG_FLOAT32,S as FLAG_HAS_UVS,D as FLAG_HAS_VERTEX_COLORS,L as FLAG_UINT16_INDICES,j as MIN_SUPPORTED_VERSION,e as Materials,N as SCALE_FACTORS,h as TEXTURE_CACHE_MAX_ENTRIES,G as UV_FORMAT_FLOAT32,B as UV_FORMAT_UINT16,m as addEdges,t as applyOffset,M as clearTextureCache,a as computeCombinedBoundingBox,s as createCameraController,p as createGrid,C as createLabelLayer,d as createMeasureTool,y as createRenderPipeline,i as createViewGizmo,V as getThreeMeshesFromComputeResponse,c as initThree,l as isEdgeOverlay,_ as materialAppearanceForLook,P as parseBinaryMeshBatch,o as parseColor,A as parseDisplayItems,u as parseMeshBatch,b as parseMeshBatchBlob,F as parseMeshBatchObject,f as removeEdges,E as setTextureAnisotropy,x as snapToVertex,r as updateScene};
+//# sourceMappingURL=visualization-I6ZHBKFN.js.map

package/dist/visualization.cjs

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true});var _chunkEZRBMUXTcjs = require('./chunk-EZRBMUXT.cjs');require('./chunk-GF6ZIJWX.cjs');exports.EDGE_USERDATA_KIND = _chunkEZRBMUXTcjs.i; exports.Materials = _chunkEZRBMUXTcjs.a; exports.SCALE_FACTORS = _chunkEZRBMUXTcjs.L; exports.addEdges = _chunkEZRBMUXTcjs.j; exports.applyOffset = _chunkEZRBMUXTcjs.d; exports.computeCombinedBoundingBox = _chunkEZRBMUXTcjs.e; exports.createCameraController = _chunkEZRBMUXTcjs.f; exports.createGrid = _chunkEZRBMUXTcjs.g; exports.createLabelLayer = _chunkEZRBMUXTcjs.n; exports.createMeasureTool = _chunkEZRBMUXTcjs.p; exports.createRenderPipeline = _chunkEZRBMUXTcjs.m; exports.createViewGizmo = _chunkEZRBMUXTcjs.h; exports.getThreeMeshesFromComputeResponse = _chunkEZRBMUXTcjs.M; exports.initThree = _chunkEZRBMUXTcjs.u; exports.isEdgeOverlay = _chunkEZRBMUXTcjs.k; exports.parseColor = _chunkEZRBMUXTcjs.c; exports.parseDisplayItems = _chunkEZRBMUXTcjs.v; exports.parseMeshBatchBlob = _chunkEZRBMUXTcjs.K; exports.parseMeshBatchObject = _chunkEZRBMUXTcjs.J; exports.removeEdges = _chunkEZRBMUXTcjs.l; exports.snapToVertex = _chunkEZRBMUXTcjs.o; exports.updateScene = _chunkEZRBMUXTcjs.b;
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});var _chunkAGU3SX3Jcjs = require('./chunk-AGU3SX3J.cjs');require('./chunk-CUQQ3ZBV.cjs');exports.EDGE_USERDATA_KIND = _chunkAGU3SX3Jcjs.i; exports.Materials = _chunkAGU3SX3Jcjs.a; exports.SCALE_FACTORS = _chunkAGU3SX3Jcjs.L; exports.addEdges = _chunkAGU3SX3Jcjs.j; exports.applyOffset = _chunkAGU3SX3Jcjs.d; exports.computeCombinedBoundingBox = _chunkAGU3SX3Jcjs.e; exports.createCameraController = _chunkAGU3SX3Jcjs.f; exports.createGrid = _chunkAGU3SX3Jcjs.g; exports.createLabelLayer = _chunkAGU3SX3Jcjs.n; exports.createMeasureTool = _chunkAGU3SX3Jcjs.p; exports.createRenderPipeline = _chunkAGU3SX3Jcjs.m; exports.createViewGizmo = _chunkAGU3SX3Jcjs.h; exports.getThreeMeshesFromComputeResponse = _chunkAGU3SX3Jcjs.M; exports.initThree = _chunkAGU3SX3Jcjs.u; exports.isEdgeOverlay = _chunkAGU3SX3Jcjs.k; exports.parseColor = _chunkAGU3SX3Jcjs.c; exports.parseDisplayItems = _chunkAGU3SX3Jcjs.v; exports.parseMeshBatchBlob = _chunkAGU3SX3Jcjs.K; exports.parseMeshBatchObject = _chunkAGU3SX3Jcjs.J; exports.removeEdges = _chunkAGU3SX3Jcjs.l; exports.snapToVertex = _chunkAGU3SX3Jcjs.o; exports.updateScene = _chunkAGU3SX3Jcjs.b;
 //# sourceMappingURL=visualization.cjs.map

package/dist/visualization.d.cts

@@ -1,11 +1,11 @@
 import * as THREE from 'three';
 import { OrbitControls } from 'three/addons/controls/OrbitControls.js';
-import { M as MaterialAppearanceOptions, f as GrasshopperComputeResponse, m as MeshExtractionOptions, n as MeshBatchParsingOptions, o as DisplayBatch, p as DisplayItem } from './types-Ci8Z0-hF.cjs';
-export { q as DisplayCurve, r as DisplayIdentity, s as DisplayItemBase, t as DisplayPoint, u as DisplayPosition, v as MeshBatch } from './types-Ci8Z0-hF.cjs';
+import { M as MaterialAppearanceOptions, f as GrasshopperComputeResponse, m as MeshExtractionOptions, n as MeshBatchParsingOptions, o as DisplayBatch, p as DisplayItem } from './types-C8XWc4Ab.cjs';
+export { q as DisplayCurve, r as DisplayIdentity, s as DisplayItemBase, t as DisplayPoint, u as DisplayPosition, v as MeshBatch } from './types-C8XWc4Ab.cjs';
 import { CSS2DObject } from 'three/addons/renderers/CSS2DRenderer.js';
 import { LineSegments2 } from 'three/addons/lines/LineSegments2.js';
 import { RhinoModule } from 'rhino3dm';
-import './types-C9YpTbr3.cjs';
+import './types-BGhtYxZ-.cjs';
 
 type CameraConfig = {
     position?: THREE.Vector3;
@@ -21,6 +21,20 @@ type LightingConfig = {
     ambientLightColor?: THREE.Color;
     ambientLightIntensity?: number;
     sunlightColor?: THREE.Color | number;
+    /**
+     * Add a hemisphere fill light (sky color from above, ground color from below). Unlike the flat
+     * ambient, this gives soft *direction-aware* fill, so downward- and side-facing surfaces never
+     * collapse to black when the HDR's lower hemisphere is dark. The single biggest lever for keeping
+     * results well-lit regardless of which HDR is loaded. Default false (opt-in) — enabling it shifts
+     * the look. See {@link LightingConfig.hemisphereIntensity}.
+     */
+    enableHemisphereLight?: boolean;
+    /** Hemisphere fill sky color (lights upward-facing surfaces). Default white. */
+    hemisphereSkyColor?: THREE.Color | number;
+    /** Hemisphere fill ground color (lights downward-facing surfaces). Default a mid grey. */
+    hemisphereGroundColor?: THREE.Color | number;
+    /** Hemisphere fill strength. Default 0.6. Only applies when {@link LightingConfig.enableHemisphereLight}. */
+    hemisphereIntensity?: number;
 };
 type EnvironmentConfig = {
     hdrPath?: string;
@@ -28,6 +42,13 @@ type EnvironmentConfig = {
     enableEnvironmentLighting?: boolean;
     sceneUp?: THREE.Vector3;
     showEnvironment?: boolean;
+    /**
+     * Uniform multiplier on the HDR's image-based lighting contribution (`scene.environmentIntensity`).
+     * Normalizes brightness across HDRs of differing exposure — raise it to lift a dim HDR, lower it to
+     * tame a blown-out one — so the scene doesn't render dim-or-blown purely because of the HDR chosen.
+     * Default 1 (three.js default, unchanged look).
+     */
+    environmentIntensity?: number;
 };
 type FloorConfig = {
     enabled?: boolean;
@@ -52,17 +73,29 @@ type RenderConfig = {
     ambientOcclusion?: boolean;
     /** AO strength 0–1 when {@link RenderConfig.ambientOcclusion} is on. Default 1. */
     aoIntensity?: number;
+    /**
+     * Device-pixel-ratio cap for the ambient-occlusion postprocessing buffers. AO is low-frequency, so
+     * rendering its buffers below the display DPR is nearly invisible but hugely cheaper — on a Retina
+     * display (DPR 2) full-resolution AO means 4× the pixels through GTAO's per-pixel sample loops,
+     * which can dominate frame time. Default 1 (AO buffers at 1× regardless of display DPR). Raise
+     * toward the display DPR for sharper AO at higher cost; only relevant when AO is enabled.
+     */
+    aoPixelRatio?: number;
 };
 /**
- * A coherent visual look. Seeds the initial render defaults (tone mapping, AO, edges, grid, IBL
- * strength) at construction and can be re-applied live via `setRenderStyle`.
+ * A ready-to-go visual look. A `look` is a named bundle of LIGHTING/MATERIAL defaults only — it is
+ * deliberately decoupled from the CAD overlays (edges, grid), which are driven independently by
+ * {@link EdgesConfig}/{@link GridConfig}. Pick one and the viewer looks professional with zero other
+ * config; every individual `lighting`/`environment`/`render` option still overrides the preset. Seeds
+ * construction defaults and can be re-applied live via `setLook`.
  *
- * - 'technical': matte, drawing-like — neutral tone mapping, low IBL, edges + grid on, AO on.
- *   Reads like a CAD shaded view (Rhino/Onshape).
- * - 'rendered':  presentation — ACES-filmic tone mapping, stronger IBL, edges off, AO on. Reads
- *   like a Keyshot/Fusion render.
+ * - 'technical' (default): matte, drawing-like — neutral tone mapping, low IBL, no fill. Reads like a
+ *   CAD shaded view (Rhino/Onshape).
+ * - 'studio': balanced presentation — ACES tone mapping, hemisphere fill + lifted HDR so results are
+ *   well-lit regardless of the HDR, without washing colour out. The polished "product shot" look.
+ * - 'showcase': punchier presentation — ACES, stronger IBL/fill and a touch more exposure.
  */
-type RenderStyle = 'technical' | 'rendered';
+type Look = 'studio' | 'technical' | 'showcase';
 /** Crisp boundary/crease edge overlays on meshes. See `addEdges`. */
 type EdgesConfig = {
     /** Auto-attach edge overlays to meshes as they load. Default false (opt-in). */
@@ -133,12 +166,13 @@ type MeasureConfig = {
 type ThreeInitializerOptions = {
     sceneScale?: 'mm' | 'cm' | 'm' | 'inches' | 'feet';
     /**
-     * Pick a coherent look up front — seeds sensible defaults for tone mapping, AO, edges, grid, and
-     * IBL strength (see {@link RenderStyle}). Individual `render`/`edges`/`grid` options still win
-     * when set explicitly, so this only fills in what you leave unspecified. Omit for the plain
-     * per-field defaults (no style applied). Re-apply later via the init result's `setRenderStyle`.
+     * Pick a ready-to-go visual look up front — seeds professional lighting/material defaults (tone
+     * mapping, AO, IBL strength, hemisphere fill; see {@link Look}). Individual `lighting`/
+     * `environment`/`render` options still win when set explicitly, so this only fills in what you
+     * leave unspecified. A look does NOT touch edges/grid (those are independent overlays). Defaults
+     * to 'technical'. Re-apply later via the init result's `setLook`.
      */
-    renderStyle?: RenderStyle;
+    look?: Look;
     camera?: CameraConfig;
     lighting?: LightingConfig;
     environment?: EnvironmentConfig;
@@ -461,13 +495,40 @@ declare const initThree: (canvas: HTMLCanvasElement, options?: ThreeInitializerO
      * edges). Retunes viewer-owned dials only; per-material parse choices are set via the batch
      * parser's `material` option. Handy for comparing the two looks in a live viewer.
      */
-    setRenderStyle: (style: "technical" | "rendered") => void;
     /**
-     * The parse-time material options (backface culling, IBL strength) matching the active render
-     * style — feed into the batch parser's `material` option so freshly-loaded meshes are built to
-     * match the look. Returns undefined when no style is active. See `setRenderStyle`.
+     * Switch the viewer to a ready-to-go look at runtime ('studio' | 'technical' | 'showcase'). Retunes
+     * lighting/material only (tone mapping, fill, IBL, AO) — never edges/grid. A straight preset apply:
+     * overwrites any granular lighting dials you set earlier.
      */
-    getMaterialAppearance: () => MaterialAppearanceOptions | undefined;
+    setLook: (look: "studio" | "technical" | "showcase") => void;
+    /**
+     * Retune the fill lights at runtime: the direction-aware hemisphere fill (sky/ground) and the flat
+     * ambient. Raising `hemisphereIntensity` is the most effective way to lift shadowed / under-facing
+     * surfaces a dark HDR leaves black. A positive `hemisphereIntensity` lazily creates the hemisphere
+     * light if the viewer was built without one; `0` switches it off.
+     */
+    setFillLights: (opts: {
+        hemisphereIntensity?: number;
+        hemisphereSkyColor?: THREE.Color | number;
+        hemisphereGroundColor?: THREE.Color | number;
+        ambientIntensity?: number;
+    }) => void;
+    /**
+     * Set the uniform multiplier on the HDR's image-based lighting (`scene.environmentIntensity`) at
+     * runtime — normalizes brightness across HDRs of differing exposure so the scene isn't at the
+     * mercy of whichever HDR is loaded. Applies immediately, even before the HDR finishes decoding.
+     */
+    setEnvironmentIntensity: (intensity: number) => void;
+    /** Set renderer tone-mapping exposure at runtime. Higher lifts shadows and overall brightness. */
+    setToneMappingExposure: (exposure: number) => void;
+    /** Set GTAO strength at runtime (0–1). No-op when ambient occlusion isn't active. */
+    setAoIntensity: (intensity: number) => void;
+    /**
+     * The parse-time material options (backface culling, IBL strength) matching the active look — feed
+     * into the batch parser's `material` option so freshly-loaded meshes are built to match it. See
+     * `setLook`.
+     */
+    getMaterialAppearance: () => MaterialAppearanceOptions;
     /**
      * Refit the sun's shadow frustum to the current scene content for crisp shadows. Call after
      * loading or replacing geometry (e.g. after `updateScene`). No-op when sunlight/shadows are off.
@@ -488,25 +549,9 @@ declare const initThree: (canvas: HTMLCanvasElement, options?: ThreeInitializerO
     clearUserGeometry: () => void;
 };
 
-/**
- * Updates the scene with the given meshes and camera settings.
- * If initialPositionSet is false, it positions the camera and sets the controls target based on the bounding boxes of the meshes.
- * @param scene - The THREE.Scene object to update.
- * @param meshes - An array of THREE.Mesh objects to add to the scene.
- * @param camera - The THREE.PerspectiveCamera object to position.
- * @param controls - The OrbitControls object to update.
- * @param initialPositionSet - A boolean indicating whether the initial position of the camera and controls have been set.
- */
+/** Updates scene with meshes and positions camera on first call. */
 declare function updateScene(scene: THREE.Scene, meshes: THREE.Object3D[], camera: THREE.PerspectiveCamera, controls: OrbitControls, initialPositionSet: boolean): void;
-/**
- * Parses a color string in multiple formats to a THREE.Color object.
- * Supported formats:
- * - Hex: "#C7A5A5", "C7A5A5"
- * - RGB: "199, 165, 165"
- * - CSS named colors: "red", "blue", etc.
- * @param colorString - The color string to parse.
- * @returns A THREE.Color object.
- */
+/** Parses color strings (hex, RGB, CSS names). */
 declare function parseColor(colorString: string): THREE.Color;
 /**
  * Shift objects along one world axis. Defaults to `z` — the up axis of the unified Z-up scene
@@ -526,12 +571,7 @@ declare const PLASTIC_MATERIAL: THREE.MeshPhysicalMaterial;
 declare const GLASS_MATERIAL: THREE.MeshPhysicalMaterial;
 declare const RUBBER_MATERIAL: THREE.MeshPhysicalMaterial;
 declare const WOOD_MATERIAL: THREE.MeshPhysicalMaterial;
-/**
- * The module-scope singleton materials above, as a set. Scene-clearing code must NOT dispose a
- * material in this set: they are shared across meshes and across solves, and `dispose()` on a
- * still-referenced material forces a shader program rebuild on its next use (and would free any
- * textures they gain later while other objects still use them).
- */
+/** Shared singleton materials; must not be disposed (rebuilds shaders, frees textures). */
 declare const SHARED_MATERIALS: ReadonlySet<THREE.Material>;
 
 declare const threeMaterials_CONCRETE_MATERIAL: typeof CONCRETE_MATERIAL;
@@ -619,6 +659,12 @@ interface RenderPipelineOptions {
     toneMappingExposure: number;
     /** AO strength 0–1. Default 1. */
     aoIntensity?: number;
+    /**
+     * Cap on the device-pixel-ratio used for the composer's (AO) buffers. AO is low-frequency, so
+     * rendering below the display DPR is nearly invisible but far cheaper. `setSize`'s incoming
+     * pixelRatio is clamped to this. Default 1.
+     */
+    aoPixelRatio?: number;
 }
 declare function createRenderPipeline(renderer: THREE.WebGLRenderer, scene: THREE.Scene, camera: THREE.Camera, width: number, height: number, options: RenderPipelineOptions): RenderPipeline;
 
@@ -677,11 +723,7 @@ declare const SCALE_FACTORS: Record<string, number>;
  */
 declare function getThreeMeshesFromComputeResponse(data: GrasshopperComputeResponse, options?: MeshExtractionOptions): Promise<THREE.Object3D[]>;
 
-/**
- * Internal-only telemetry threaded from an outer entry point (e.g. the JSON
- * `parseMeshBatch` measuring its own `JSON.parse` cost) into the shared build
- * step. Never part of any public options surface — callers don't supply timings.
- */
+/** Internal telemetry only (not exposed in public options). */
 interface ParseTelemetry {
     parseTime?: number;
     perfStart?: number;

package/dist/visualization.d.ts

@@ -1,11 +1,11 @@
 import * as THREE from 'three';
 import { OrbitControls } from 'three/addons/controls/OrbitControls.js';
-import { M as MaterialAppearanceOptions, f as GrasshopperComputeResponse, m as MeshExtractionOptions, n as MeshBatchParsingOptions, o as DisplayBatch, p as DisplayItem } from './types-DuOh5XqS.js';
-export { q as DisplayCurve, r as DisplayIdentity, s as DisplayItemBase, t as DisplayPoint, u as DisplayPosition, v as MeshBatch } from './types-DuOh5XqS.js';
+import { M as MaterialAppearanceOptions, f as GrasshopperComputeResponse, m as MeshExtractionOptions, n as MeshBatchParsingOptions, o as DisplayBatch, p as DisplayItem } from './types-Dtok-mVq.js';
+export { q as DisplayCurve, r as DisplayIdentity, s as DisplayItemBase, t as DisplayPoint, u as DisplayPosition, v as MeshBatch } from './types-Dtok-mVq.js';
 import { CSS2DObject } from 'three/addons/renderers/CSS2DRenderer.js';
 import { LineSegments2 } from 'three/addons/lines/LineSegments2.js';
 import { RhinoModule } from 'rhino3dm';
-import './types-C9YpTbr3.js';
+import './types-BGhtYxZ-.js';
 
 type CameraConfig = {
     position?: THREE.Vector3;
@@ -21,6 +21,20 @@ type LightingConfig = {
     ambientLightColor?: THREE.Color;
     ambientLightIntensity?: number;
     sunlightColor?: THREE.Color | number;
+    /**
+     * Add a hemisphere fill light (sky color from above, ground color from below). Unlike the flat
+     * ambient, this gives soft *direction-aware* fill, so downward- and side-facing surfaces never
+     * collapse to black when the HDR's lower hemisphere is dark. The single biggest lever for keeping
+     * results well-lit regardless of which HDR is loaded. Default false (opt-in) — enabling it shifts
+     * the look. See {@link LightingConfig.hemisphereIntensity}.
+     */
+    enableHemisphereLight?: boolean;
+    /** Hemisphere fill sky color (lights upward-facing surfaces). Default white. */
+    hemisphereSkyColor?: THREE.Color | number;
+    /** Hemisphere fill ground color (lights downward-facing surfaces). Default a mid grey. */
+    hemisphereGroundColor?: THREE.Color | number;
+    /** Hemisphere fill strength. Default 0.6. Only applies when {@link LightingConfig.enableHemisphereLight}. */
+    hemisphereIntensity?: number;
 };
 type EnvironmentConfig = {
     hdrPath?: string;
@@ -28,6 +42,13 @@ type EnvironmentConfig = {
     enableEnvironmentLighting?: boolean;
     sceneUp?: THREE.Vector3;
     showEnvironment?: boolean;
+    /**
+     * Uniform multiplier on the HDR's image-based lighting contribution (`scene.environmentIntensity`).
+     * Normalizes brightness across HDRs of differing exposure — raise it to lift a dim HDR, lower it to
+     * tame a blown-out one — so the scene doesn't render dim-or-blown purely because of the HDR chosen.
+     * Default 1 (three.js default, unchanged look).
+     */
+    environmentIntensity?: number;
 };
 type FloorConfig = {
     enabled?: boolean;
@@ -52,17 +73,29 @@ type RenderConfig = {
     ambientOcclusion?: boolean;
     /** AO strength 0–1 when {@link RenderConfig.ambientOcclusion} is on. Default 1. */
     aoIntensity?: number;
+    /**
+     * Device-pixel-ratio cap for the ambient-occlusion postprocessing buffers. AO is low-frequency, so
+     * rendering its buffers below the display DPR is nearly invisible but hugely cheaper — on a Retina
+     * display (DPR 2) full-resolution AO means 4× the pixels through GTAO's per-pixel sample loops,
+     * which can dominate frame time. Default 1 (AO buffers at 1× regardless of display DPR). Raise
+     * toward the display DPR for sharper AO at higher cost; only relevant when AO is enabled.
+     */
+    aoPixelRatio?: number;
 };
 /**
- * A coherent visual look. Seeds the initial render defaults (tone mapping, AO, edges, grid, IBL
- * strength) at construction and can be re-applied live via `setRenderStyle`.
+ * A ready-to-go visual look. A `look` is a named bundle of LIGHTING/MATERIAL defaults only — it is
+ * deliberately decoupled from the CAD overlays (edges, grid), which are driven independently by
+ * {@link EdgesConfig}/{@link GridConfig}. Pick one and the viewer looks professional with zero other
+ * config; every individual `lighting`/`environment`/`render` option still overrides the preset. Seeds
+ * construction defaults and can be re-applied live via `setLook`.
  *
- * - 'technical': matte, drawing-like — neutral tone mapping, low IBL, edges + grid on, AO on.
- *   Reads like a CAD shaded view (Rhino/Onshape).
- * - 'rendered':  presentation — ACES-filmic tone mapping, stronger IBL, edges off, AO on. Reads
- *   like a Keyshot/Fusion render.
+ * - 'technical' (default): matte, drawing-like — neutral tone mapping, low IBL, no fill. Reads like a
+ *   CAD shaded view (Rhino/Onshape).
+ * - 'studio': balanced presentation — ACES tone mapping, hemisphere fill + lifted HDR so results are
+ *   well-lit regardless of the HDR, without washing colour out. The polished "product shot" look.
+ * - 'showcase': punchier presentation — ACES, stronger IBL/fill and a touch more exposure.
  */
-type RenderStyle = 'technical' | 'rendered';
+type Look = 'studio' | 'technical' | 'showcase';
 /** Crisp boundary/crease edge overlays on meshes. See `addEdges`. */
 type EdgesConfig = {
     /** Auto-attach edge overlays to meshes as they load. Default false (opt-in). */
@@ -133,12 +166,13 @@ type MeasureConfig = {
 type ThreeInitializerOptions = {
     sceneScale?: 'mm' | 'cm' | 'm' | 'inches' | 'feet';
     /**
-     * Pick a coherent look up front — seeds sensible defaults for tone mapping, AO, edges, grid, and
-     * IBL strength (see {@link RenderStyle}). Individual `render`/`edges`/`grid` options still win
-     * when set explicitly, so this only fills in what you leave unspecified. Omit for the plain
-     * per-field defaults (no style applied). Re-apply later via the init result's `setRenderStyle`.
+     * Pick a ready-to-go visual look up front — seeds professional lighting/material defaults (tone
+     * mapping, AO, IBL strength, hemisphere fill; see {@link Look}). Individual `lighting`/
+     * `environment`/`render` options still win when set explicitly, so this only fills in what you
+     * leave unspecified. A look does NOT touch edges/grid (those are independent overlays). Defaults
+     * to 'technical'. Re-apply later via the init result's `setLook`.
      */
-    renderStyle?: RenderStyle;
+    look?: Look;
     camera?: CameraConfig;
     lighting?: LightingConfig;
     environment?: EnvironmentConfig;
@@ -461,13 +495,40 @@ declare const initThree: (canvas: HTMLCanvasElement, options?: ThreeInitializerO
      * edges). Retunes viewer-owned dials only; per-material parse choices are set via the batch
      * parser's `material` option. Handy for comparing the two looks in a live viewer.
      */
-    setRenderStyle: (style: "technical" | "rendered") => void;
     /**
-     * The parse-time material options (backface culling, IBL strength) matching the active render
-     * style — feed into the batch parser's `material` option so freshly-loaded meshes are built to
-     * match the look. Returns undefined when no style is active. See `setRenderStyle`.
+     * Switch the viewer to a ready-to-go look at runtime ('studio' | 'technical' | 'showcase'). Retunes
+     * lighting/material only (tone mapping, fill, IBL, AO) — never edges/grid. A straight preset apply:
+     * overwrites any granular lighting dials you set earlier.
      */
-    getMaterialAppearance: () => MaterialAppearanceOptions | undefined;
+    setLook: (look: "studio" | "technical" | "showcase") => void;
+    /**
+     * Retune the fill lights at runtime: the direction-aware hemisphere fill (sky/ground) and the flat
+     * ambient. Raising `hemisphereIntensity` is the most effective way to lift shadowed / under-facing
+     * surfaces a dark HDR leaves black. A positive `hemisphereIntensity` lazily creates the hemisphere
+     * light if the viewer was built without one; `0` switches it off.
+     */
+    setFillLights: (opts: {
+        hemisphereIntensity?: number;
+        hemisphereSkyColor?: THREE.Color | number;
+        hemisphereGroundColor?: THREE.Color | number;
+        ambientIntensity?: number;
+    }) => void;
+    /**
+     * Set the uniform multiplier on the HDR's image-based lighting (`scene.environmentIntensity`) at
+     * runtime — normalizes brightness across HDRs of differing exposure so the scene isn't at the
+     * mercy of whichever HDR is loaded. Applies immediately, even before the HDR finishes decoding.
+     */
+    setEnvironmentIntensity: (intensity: number) => void;
+    /** Set renderer tone-mapping exposure at runtime. Higher lifts shadows and overall brightness. */
+    setToneMappingExposure: (exposure: number) => void;
+    /** Set GTAO strength at runtime (0–1). No-op when ambient occlusion isn't active. */
+    setAoIntensity: (intensity: number) => void;
+    /**
+     * The parse-time material options (backface culling, IBL strength) matching the active look — feed
+     * into the batch parser's `material` option so freshly-loaded meshes are built to match it. See
+     * `setLook`.
+     */
+    getMaterialAppearance: () => MaterialAppearanceOptions;
     /**
      * Refit the sun's shadow frustum to the current scene content for crisp shadows. Call after
      * loading or replacing geometry (e.g. after `updateScene`). No-op when sunlight/shadows are off.
@@ -488,25 +549,9 @@ declare const initThree: (canvas: HTMLCanvasElement, options?: ThreeInitializerO
     clearUserGeometry: () => void;
 };
 
-/**
- * Updates the scene with the given meshes and camera settings.
- * If initialPositionSet is false, it positions the camera and sets the controls target based on the bounding boxes of the meshes.
- * @param scene - The THREE.Scene object to update.
- * @param meshes - An array of THREE.Mesh objects to add to the scene.
- * @param camera - The THREE.PerspectiveCamera object to position.
- * @param controls - The OrbitControls object to update.
- * @param initialPositionSet - A boolean indicating whether the initial position of the camera and controls have been set.
- */
+/** Updates scene with meshes and positions camera on first call. */
 declare function updateScene(scene: THREE.Scene, meshes: THREE.Object3D[], camera: THREE.PerspectiveCamera, controls: OrbitControls, initialPositionSet: boolean): void;
-/**
- * Parses a color string in multiple formats to a THREE.Color object.
- * Supported formats:
- * - Hex: "#C7A5A5", "C7A5A5"
- * - RGB: "199, 165, 165"
- * - CSS named colors: "red", "blue", etc.
- * @param colorString - The color string to parse.
- * @returns A THREE.Color object.
- */
+/** Parses color strings (hex, RGB, CSS names). */
 declare function parseColor(colorString: string): THREE.Color;
 /**
  * Shift objects along one world axis. Defaults to `z` — the up axis of the unified Z-up scene
@@ -526,12 +571,7 @@ declare const PLASTIC_MATERIAL: THREE.MeshPhysicalMaterial;
 declare const GLASS_MATERIAL: THREE.MeshPhysicalMaterial;
 declare const RUBBER_MATERIAL: THREE.MeshPhysicalMaterial;
 declare const WOOD_MATERIAL: THREE.MeshPhysicalMaterial;
-/**
- * The module-scope singleton materials above, as a set. Scene-clearing code must NOT dispose a
- * material in this set: they are shared across meshes and across solves, and `dispose()` on a
- * still-referenced material forces a shader program rebuild on its next use (and would free any
- * textures they gain later while other objects still use them).
- */
+/** Shared singleton materials; must not be disposed (rebuilds shaders, frees textures). */
 declare const SHARED_MATERIALS: ReadonlySet<THREE.Material>;
 
 declare const threeMaterials_CONCRETE_MATERIAL: typeof CONCRETE_MATERIAL;
@@ -619,6 +659,12 @@ interface RenderPipelineOptions {
     toneMappingExposure: number;
     /** AO strength 0–1. Default 1. */
     aoIntensity?: number;
+    /**
+     * Cap on the device-pixel-ratio used for the composer's (AO) buffers. AO is low-frequency, so
+     * rendering below the display DPR is nearly invisible but far cheaper. `setSize`'s incoming
+     * pixelRatio is clamped to this. Default 1.
+     */
+    aoPixelRatio?: number;
 }
 declare function createRenderPipeline(renderer: THREE.WebGLRenderer, scene: THREE.Scene, camera: THREE.Camera, width: number, height: number, options: RenderPipelineOptions): RenderPipeline;
 
@@ -677,11 +723,7 @@ declare const SCALE_FACTORS: Record<string, number>;
  */
 declare function getThreeMeshesFromComputeResponse(data: GrasshopperComputeResponse, options?: MeshExtractionOptions): Promise<THREE.Object3D[]>;
 
-/**
- * Internal-only telemetry threaded from an outer entry point (e.g. the JSON
- * `parseMeshBatch` measuring its own `JSON.parse` cost) into the shared build
- * step. Never part of any public options surface — callers don't supply timings.
- */
+/** Internal telemetry only (not exposed in public options). */
 interface ParseTelemetry {
     parseTime?: number;
     perfStart?: number;

package/dist/visualization.js

@@ -1,2 +1,2 @@
-import{J as h,K as c,L as v,M as j,a as e,b as r,c as t,d as o,e as i,f as a,g as s,h as p,i as n,j as l,k as f,l as m,m as y,n as u,o as d,p as x,u as C,v as g}from"./chunk-ORGJSKR4.js";import"./chunk-54O6BO24.js";export{n as EDGE_USERDATA_KIND,e as Materials,v as SCALE_FACTORS,l as addEdges,o as applyOffset,i as computeCombinedBoundingBox,a as createCameraController,s as createGrid,u as createLabelLayer,x as createMeasureTool,y as createRenderPipeline,p as createViewGizmo,j as getThreeMeshesFromComputeResponse,C as initThree,f as isEdgeOverlay,t as parseColor,g as parseDisplayItems,c as parseMeshBatchBlob,h as parseMeshBatchObject,m as removeEdges,d as snapToVertex,r as updateScene};
+import{J as h,K as c,L as v,M as j,a as e,b as r,c as t,d as o,e as i,f as a,g as s,h as p,i as n,j as l,k as f,l as m,m as y,n as u,o as d,p as x,u as C,v as g}from"./chunk-EQ7EMYF6.js";import"./chunk-WPB2LKCD.js";export{n as EDGE_USERDATA_KIND,e as Materials,v as SCALE_FACTORS,l as addEdges,o as applyOffset,i as computeCombinedBoundingBox,a as createCameraController,s as createGrid,u as createLabelLayer,x as createMeasureTool,y as createRenderPipeline,p as createViewGizmo,j as getThreeMeshesFromComputeResponse,C as initThree,f as isEdgeOverlay,t as parseColor,g as parseDisplayItems,c as parseMeshBatchBlob,h as parseMeshBatchObject,m as removeEdges,d as snapToVertex,r as updateScene};
 //# sourceMappingURL=visualization.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@selvajs/compute",
-  "version": "3.1.0-beta.5",
+  "version": "3.1.0-beta.7",
   "description": "TypeScript library for Rhino Compute Server - Grasshopper and RhinoCommon",
   "author": "VektorNode",
   "license": "MIT",