@selvajs/compute 2.1.0-beta.1 → 2.1.0-beta.3

package/dist/visualization.cjs

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true});var _chunkJPXUC3P5cjs = require('./chunk-JPXUC3P5.cjs');require('./chunk-MA6YB3YZ.cjs');exports.Materials = _chunkJPXUC3P5cjs.q; exports.SCALE_FACTORS = _chunkJPXUC3P5cjs.z; exports.getThreeMeshesFromComputeResponse = _chunkJPXUC3P5cjs.A; exports.initThree = _chunkJPXUC3P5cjs.p; exports.parseDisplayItems = _chunkJPXUC3P5cjs.r; exports.parseMeshBatchBlob = _chunkJPXUC3P5cjs.y; exports.parseMeshBatchObject = _chunkJPXUC3P5cjs.x; exports.updateScene = _chunkJPXUC3P5cjs.a;
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});var _chunk7RLHTZZQcjs = require('./chunk-7RLHTZZQ.cjs');require('./chunk-JZFH67ES.cjs');exports.EDGE_USERDATA_KIND = _chunk7RLHTZZQcjs.h; exports.Materials = _chunk7RLHTZZQcjs.q; exports.SCALE_FACTORS = _chunk7RLHTZZQcjs.z; exports.addEdges = _chunk7RLHTZZQcjs.i; exports.applyOffset = _chunk7RLHTZZQcjs.c; exports.computeCombinedBoundingBox = _chunk7RLHTZZQcjs.d; exports.createCameraController = _chunk7RLHTZZQcjs.e; exports.createGrid = _chunk7RLHTZZQcjs.f; exports.createLabelLayer = _chunk7RLHTZZQcjs.m; exports.createMeasureTool = _chunk7RLHTZZQcjs.o; exports.createRenderPipeline = _chunk7RLHTZZQcjs.l; exports.createViewGizmo = _chunk7RLHTZZQcjs.g; exports.getThreeMeshesFromComputeResponse = _chunk7RLHTZZQcjs.A; exports.initThree = _chunk7RLHTZZQcjs.p; exports.isEdgeOverlay = _chunk7RLHTZZQcjs.j; exports.parseColor = _chunk7RLHTZZQcjs.b; exports.parseDisplayItems = _chunk7RLHTZZQcjs.r; exports.parseMeshBatchBlob = _chunk7RLHTZZQcjs.y; exports.parseMeshBatchObject = _chunk7RLHTZZQcjs.x; exports.removeEdges = _chunk7RLHTZZQcjs.k; exports.snapToVertex = _chunk7RLHTZZQcjs.n; exports.updateScene = _chunk7RLHTZZQcjs.a;
 //# sourceMappingURL=visualization.cjs.map

package/dist/visualization.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["/home/runner/work/selva-compute/selva-compute/dist/visualization.cjs"],"names":[],"mappings":"AAAA,iIAAyF,gCAA6B,iYAA0L","file":"/home/runner/work/selva-compute/selva-compute/dist/visualization.cjs"}
+{"version":3,"sources":["/home/runner/work/selva-compute/selva-compute/dist/visualization.cjs"],"names":[],"mappings":"AAAA,iIAA2L,gCAA6B,khCAA+d","file":"/home/runner/work/selva-compute/selva-compute/dist/visualization.cjs"}

package/dist/visualization.d.cts

@@ -1,5 +1,7 @@
 import * as THREE from 'three';
 import { OrbitControls } from 'three/addons/controls/OrbitControls.js';
+import { CSS2DObject } from 'three/addons/renderers/CSS2DRenderer.js';
+import { LineSegments2 } from 'three/addons/lines/LineSegments2.js';
 import { f as GrasshopperComputeResponse, M as MeshExtractionOptions, m as MeshBatchParsingOptions, n as DisplayBatch, o as DisplayItem } from './types-BuRCHPlb.cjs';
 export { p as DisplayCurve, q as DisplayIdentity, r as DisplayItemBase, s as DisplayPoint, t as DisplayPosition, u as MeshBatch } from './types-BuRCHPlb.cjs';
 import { RhinoModule } from 'rhino3dm';
@@ -183,7 +185,40 @@ interface CameraController {
     /** Keep the orthographic frustum aspect in sync on canvas resize. Called by the resize loop. */
     updateAspect(width: number, height: number): void;
 }
+interface CameraControllerDeps {
+    scene: THREE.Scene;
+    perspective: THREE.PerspectiveCamera;
+    controls: OrbitControls;
+    /** Called whenever the active camera identity changes, so callers can re-point the renderer/raycaster. */
+    onActiveCameraChange: (camera: THREE.Camera) => void;
+}
+declare function createCameraController(deps: CameraControllerDeps): CameraController;
 
+/**
+ * An "infinite", distance-fading reference grid — the single strongest visual cue that reads as CAD.
+ *
+ * Why not `GridHelper`: it's a fixed-size square of line segments that visibly ends and looks wrong
+ * once you pan or zoom past it. Instead we draw one large screen-facing plane and compute the grid
+ * in the fragment shader from world coordinates, fading lines out with distance so the edge is never
+ * a hard cutoff. The plane is big enough to cover any reasonable view; the fade hides its bounds.
+ *
+ * Two line frequencies (minor + major every 10th) give the usual graph-paper depth read. Spacing is
+ * in world units (meters — the scene's normalized unit), so a `cellSize` of 1 = 1m minor cells.
+ */
+interface GridOptions {
+    /** Minor cell size in world units (meters). Default 1. */
+    cellSize?: number;
+    /** How many minor cells per major line. Default 10. */
+    majorEvery?: number;
+    /** Minor line color. */
+    cellColor?: THREE.ColorRepresentation;
+    /** Major line color. */
+    majorColor?: THREE.ColorRepresentation;
+    /** World-space radius at which the grid has fully faded out. Default 100. */
+    fadeDistance?: number;
+    /** Plane to lay the grid on. 'y' = horizontal ground (Three Y-up). Default 'y'. */
+    plane?: 'x' | 'y' | 'z';
+}
 interface Grid {
     /** The grid mesh; add to the scene. Tagged `userData.id = 'grid'` so pick/fit code skips it. */
     readonly object: THREE.Mesh;
@@ -192,6 +227,7 @@ interface Grid {
     setVisible(visible: boolean): void;
     dispose(): void;
 }
+declare function createGrid(options?: GridOptions): Grid;
 
 /**
  * The corner nav-cube/axis gizmo. Wraps three's {@link ViewHelper} (the standard, well-tested
@@ -222,6 +258,49 @@ interface ViewGizmo {
     isVisible(): boolean;
     dispose(): void;
 }
+interface ViewGizmoDeps {
+    /** The perspective (primary) camera ViewHelper orients and animates. */
+    camera: THREE.PerspectiveCamera;
+    domElement: HTMLElement;
+    controls: OrbitControls;
+    controller: CameraController;
+}
+declare function createViewGizmo(deps: ViewGizmoDeps): ViewGizmo;
+
+/**
+ * An HTML label layer that tracks 3D positions, via three's {@link CSS2DRenderer}. Labels are real
+ * DOM nodes (crisp text, CSS-stylable) positioned each frame to follow points in the scene — the
+ * foundation for measurement readouts, dimension annotations, and point tags.
+ *
+ * The CSS2D renderer draws into its own absolutely-positioned DOM overlay stacked on top of the
+ * WebGL canvas (pointer-events disabled so it never steals clicks from the viewer). The viewer owns
+ * one of these; features like the measure tool add/remove labels through it.
+ */
+interface LabelHandle {
+    /** The CSS2DObject in the scene graph. */
+    readonly object: CSS2DObject;
+    /** Move the label to a new world position. */
+    setPosition(position: THREE.Vector3): void;
+    /** Replace the label's text/HTML. */
+    setText(text: string): void;
+    /** Remove the label from the scene and the DOM. */
+    remove(): void;
+}
+interface LabelLayer {
+    /** Create a label at a world position. `className` lets callers theme groups of labels. */
+    addLabel(text: string, position: THREE.Vector3, className?: string): LabelHandle;
+    /** Render the DOM overlay. Call each frame after the WebGL render, with the active camera. */
+    render(scene: THREE.Scene, camera: THREE.Camera): void;
+    setSize(width: number, height: number): void;
+    dispose(): void;
+}
+/**
+ * @param container element to overlay labels onto — normally the canvas's parent, so the overlay and
+ * canvas share a positioning context. The overlay is appended here and absolutely positioned.
+ * @param scene labels are parented to a group added to this scene, so they render and follow the
+ * camera without the caller wiring scene-graph parenting.
+ */
+declare function createLabelLayer(container: HTMLElement, scene: THREE.Scene): LabelLayer;
 
 /**
  * A two-click distance measurement tool — the CAD verb users expect. Click a point, click a second,
@@ -246,6 +325,35 @@ interface MeasureTool {
     clear(): void;
     dispose(): void;
 }
+interface MeasureOptions {
+    /** Snap to a vertex when the cursor is within this many screen pixels of it. Default 12. */
+    snapPixels?: number;
+    /** Marker + line color. Default yellow. */
+    color?: THREE.ColorRepresentation;
+    /** CSS class applied to the distance label, for styling. */
+    labelClassName?: string;
+    /** Format the distance number → label text. Default: 3 significant digits + " m". */
+    format?: (distance: number) => string;
+}
+interface MeasureDeps {
+    canvas: HTMLCanvasElement;
+    scene: THREE.Scene;
+    getActiveCamera: () => THREE.Camera;
+    labelLayer: LabelLayer;
+    options?: MeasureOptions;
+}
+/**
+ * Snap a raycast hit to the nearest vertex of the struck triangle if it's within `snapPixels` on
+ * screen; otherwise return the raw hit point. Pure (no DOM) so it's unit-testable: it takes the
+ * screen size explicitly rather than reading the canvas. Exported for that reason.
+ *
+ * Falls back to the raw point for non-mesh hits (e.g. a curve) or geometry without a face/positions.
+ */
+declare function snapToVertex(hit: THREE.Intersection, camera: THREE.Camera, screenSize: {
+    width: number;
+    height: number;
+}, snapPixels: number): THREE.Vector3;
+declare function createMeasureTool(deps: MeasureDeps): MeasureTool;
 
 /**
  * Initializes a Three.js environment with scene, camera, renderer, and event handling.
@@ -282,6 +390,22 @@ declare const initThree: (canvas: HTMLCanvasElement, options?: ThreeInitializerO
  * @param initialPositionSet - A boolean indicating whether the initial position of the camera and controls have been set.
  */
 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.
+ */
+declare function parseColor(colorString: string): THREE.Color;
+declare function applyOffset(meshes: THREE.Object3D[], offsetY: number): void;
+/**
+ * Computes the combined world-axis-aligned bounding box of a set of objects (meshes, lines, points).
+ * Correctly accounts for transformations (rotation, position, scale).
+ */
+declare function computeCombinedBoundingBox(meshes: THREE.Object3D[]): THREE.Box3;
 
 declare const EMISSIVE_MATERIAL: THREE.MeshPhysicalMaterial;
 declare const METAL_MATERIAL: THREE.MeshPhysicalMaterial;
@@ -302,6 +426,75 @@ declare namespace threeMaterials {
   export { threeMaterials_CONCRETE_MATERIAL as CONCRETE_MATERIAL, threeMaterials_EMISSIVE_MATERIAL as EMISSIVE_MATERIAL, threeMaterials_GLASS_MATERIAL as GLASS_MATERIAL, threeMaterials_METAL_MATERIAL as METAL_MATERIAL, threeMaterials_PLASTIC_MATERIAL as PLASTIC_MATERIAL, threeMaterials_RUBBER_MATERIAL as RUBBER_MATERIAL, threeMaterials_WOOD_MATERIAL as WOOD_MATERIAL };
 }
 
+/**
+ * Crisp boundary/crease edges overlaid on meshes — the defining "technical drawing" look that makes
+ * shaded geometry read as discrete objects rather than blobs.
+ *
+ * Built with `EdgesGeometry` (which keeps only edges whose adjacent faces meet above a threshold
+ * angle, so flat tessellation noise is dropped) rendered as a fat `LineSegments2` using the same
+ * `LineMaterial` family as curves (Phase 1) — so edges get controllable thickness, not the 1px cap
+ * of `THREE.LineSegments`. The overlay is added as a *child* of each mesh, so it inherits the mesh's
+ * transform and is disposed when the mesh subtree is cleared.
+ */
+interface EdgeOptions {
+    /** Edge color. Default near-black. */
+    color?: THREE.ColorRepresentation;
+    /** Edge thickness in CSS px. Default 1.5. */
+    width?: number;
+    /**
+     * Crease angle in degrees: an edge is kept only where its two faces differ by more than this.
+     * Default 30. Higher = fewer edges (only sharp creases); lower = more (catches gentle bends).
+     */
+    thresholdAngle?: number;
+}
+/** Tag on edge overlays so pick/fit/clear logic can recognize and skip or dispose them. */
+declare const EDGE_USERDATA_KIND = "edge-overlay";
+/**
+ * Walk an object subtree and attach an edge overlay to every `Mesh` found, returning the created
+ * overlays (so callers can dispose them explicitly if they don't clear the whole subtree). Meshes
+ * that already carry an overlay are skipped, so this is safe to call more than once.
+ *
+ * Skips the floor and the grid (they're aids, not content) and anything already tagged as an edge.
+ */
+declare function addEdges(root: THREE.Object3D, options?: EdgeOptions): LineSegments2[];
+/** Whether an object is an edge overlay (for pick/fit filters elsewhere). */
+declare function isEdgeOverlay(object: THREE.Object3D): boolean;
+/**
+ * Remove every edge overlay under `root`, disposing its geometry and material. The inverse of
+ * {@link addEdges}; together they make edges a live on/off toggle. Returns how many were removed.
+ */
+declare function removeEdges(root: THREE.Object3D): number;
+
+/**
+ * Optional postprocessing pipeline for ambient occlusion. Default-OFF: the viewer only constructs
+ * this when `render.ambientOcclusion` is enabled, and otherwise renders with a plain
+ * `renderer.render` so the cheap path stays cheap (the chosen tradeoff — see cad-viewer-plan.md).
+ *
+ * Pipeline: RenderPass → GTAOPass → OutputPass. GTAO (ground-truth AO) is the modern replacement for
+ * SSAO/SAO — better contact shadows in crevices, the "engineered" depth cue. `screenSpaceRadius` is
+ * on so the AO radius is in screen space, which keeps it scale-robust across the viewer's mm→m
+ * scenes without per-scene tuning. OutputPass applies tone mapping + color space (taking over the
+ * roles the renderer did directly in the non-composer path).
+ *
+ * Camera swaps: the active camera can flip perspective↔ortho. Rather than rebuild the composer, we
+ * retarget the passes' `camera` each render via {@link setCamera}.
+ */
+interface RenderPipeline {
+    render(deltaTime: number): void;
+    setSize(width: number, height: number, pixelRatio: number): void;
+    /** Point the passes at the currently active camera (call when projection changes). */
+    setCamera(camera: THREE.Camera): void;
+    dispose(): void;
+}
+interface RenderPipelineOptions {
+    /** Tone mapping to apply in OutputPass (mirror the renderer's). */
+    toneMapping: THREE.ToneMapping;
+    toneMappingExposure: number;
+    /** AO strength 0–1. Default 1. */
+    aoIntensity?: number;
+}
+declare function createRenderPipeline(renderer: THREE.WebGLRenderer, scene: THREE.Scene, camera: THREE.Camera, width: number, height: number, options: RenderPipelineOptions): RenderPipeline;
+
 declare const SCALE_FACTORS: Record<string, number>;
 /**
  * Extracts and processes display meshes from a ComputePointerResponse using the Grasshopper WebDisplay component.
@@ -405,4 +598,4 @@ interface DisplayItemParseOptions {
  */
 declare function parseDisplayItems(items: DisplayItem[] | undefined, options?: DisplayItemParseOptions): THREE.Object3D[];
 
-export { type CameraConfig, type ControlsConfig, DisplayBatch, DisplayItem, type DisplayItemParseOptions, type EnvironmentConfig, type EventConfig, type FloorConfig, type LightingConfig, threeMaterials as Materials, MeshExtractionOptions, type RenderConfig, SCALE_FACTORS, type ThreeInitializerOptions, getThreeMeshesFromComputeResponse, initThree, parseDisplayItems, parseMeshBatchBlob, parseMeshBatchObject, updateScene };
+export { type CameraConfig, type CameraController, type CameraProjection, type ControlsConfig, DisplayBatch, DisplayItem, type DisplayItemParseOptions, EDGE_USERDATA_KIND, type EdgeOptions, type EdgesConfig, type EnvironmentConfig, type EventConfig, type FloorConfig, type GizmoConfig, type Grid, type GridConfig, type GridOptions, type LabelHandle, type LabelLayer, type LightingConfig, threeMaterials as Materials, type MeasureConfig, type MeasureOptions, type MeasureTool, MeshExtractionOptions, type RenderConfig, type RenderPipeline, type RenderPipelineOptions, SCALE_FACTORS, type ThreeInitializerOptions, type ViewGizmo, type ViewPreset, addEdges, applyOffset, computeCombinedBoundingBox, createCameraController, createGrid, createLabelLayer, createMeasureTool, createRenderPipeline, createViewGizmo, getThreeMeshesFromComputeResponse, initThree, isEdgeOverlay, parseColor, parseDisplayItems, parseMeshBatchBlob, parseMeshBatchObject, removeEdges, snapToVertex, updateScene };

package/dist/visualization.d.ts

@@ -1,5 +1,7 @@
 import * as THREE from 'three';
 import { OrbitControls } from 'three/addons/controls/OrbitControls.js';
+import { CSS2DObject } from 'three/addons/renderers/CSS2DRenderer.js';
+import { LineSegments2 } from 'three/addons/lines/LineSegments2.js';
 import { f as GrasshopperComputeResponse, M as MeshExtractionOptions, m as MeshBatchParsingOptions, n as DisplayBatch, o as DisplayItem } from './types-jPuWWtnU.js';
 export { p as DisplayCurve, q as DisplayIdentity, r as DisplayItemBase, s as DisplayPoint, t as DisplayPosition, u as MeshBatch } from './types-jPuWWtnU.js';
 import { RhinoModule } from 'rhino3dm';
@@ -183,7 +185,40 @@ interface CameraController {
     /** Keep the orthographic frustum aspect in sync on canvas resize. Called by the resize loop. */
     updateAspect(width: number, height: number): void;
 }
+interface CameraControllerDeps {
+    scene: THREE.Scene;
+    perspective: THREE.PerspectiveCamera;
+    controls: OrbitControls;
+    /** Called whenever the active camera identity changes, so callers can re-point the renderer/raycaster. */
+    onActiveCameraChange: (camera: THREE.Camera) => void;
+}
+declare function createCameraController(deps: CameraControllerDeps): CameraController;
 
+/**
+ * An "infinite", distance-fading reference grid — the single strongest visual cue that reads as CAD.
+ *
+ * Why not `GridHelper`: it's a fixed-size square of line segments that visibly ends and looks wrong
+ * once you pan or zoom past it. Instead we draw one large screen-facing plane and compute the grid
+ * in the fragment shader from world coordinates, fading lines out with distance so the edge is never
+ * a hard cutoff. The plane is big enough to cover any reasonable view; the fade hides its bounds.
+ *
+ * Two line frequencies (minor + major every 10th) give the usual graph-paper depth read. Spacing is
+ * in world units (meters — the scene's normalized unit), so a `cellSize` of 1 = 1m minor cells.
+ */
+interface GridOptions {
+    /** Minor cell size in world units (meters). Default 1. */
+    cellSize?: number;
+    /** How many minor cells per major line. Default 10. */
+    majorEvery?: number;
+    /** Minor line color. */
+    cellColor?: THREE.ColorRepresentation;
+    /** Major line color. */
+    majorColor?: THREE.ColorRepresentation;
+    /** World-space radius at which the grid has fully faded out. Default 100. */
+    fadeDistance?: number;
+    /** Plane to lay the grid on. 'y' = horizontal ground (Three Y-up). Default 'y'. */
+    plane?: 'x' | 'y' | 'z';
+}
 interface Grid {
     /** The grid mesh; add to the scene. Tagged `userData.id = 'grid'` so pick/fit code skips it. */
     readonly object: THREE.Mesh;
@@ -192,6 +227,7 @@ interface Grid {
     setVisible(visible: boolean): void;
     dispose(): void;
 }
+declare function createGrid(options?: GridOptions): Grid;
 
 /**
  * The corner nav-cube/axis gizmo. Wraps three's {@link ViewHelper} (the standard, well-tested
@@ -222,6 +258,49 @@ interface ViewGizmo {
     isVisible(): boolean;
     dispose(): void;
 }
+interface ViewGizmoDeps {
+    /** The perspective (primary) camera ViewHelper orients and animates. */
+    camera: THREE.PerspectiveCamera;
+    domElement: HTMLElement;
+    controls: OrbitControls;
+    controller: CameraController;
+}
+declare function createViewGizmo(deps: ViewGizmoDeps): ViewGizmo;
+
+/**
+ * An HTML label layer that tracks 3D positions, via three's {@link CSS2DRenderer}. Labels are real
+ * DOM nodes (crisp text, CSS-stylable) positioned each frame to follow points in the scene — the
+ * foundation for measurement readouts, dimension annotations, and point tags.
+ *
+ * The CSS2D renderer draws into its own absolutely-positioned DOM overlay stacked on top of the
+ * WebGL canvas (pointer-events disabled so it never steals clicks from the viewer). The viewer owns
+ * one of these; features like the measure tool add/remove labels through it.
+ */
+interface LabelHandle {
+    /** The CSS2DObject in the scene graph. */
+    readonly object: CSS2DObject;
+    /** Move the label to a new world position. */
+    setPosition(position: THREE.Vector3): void;
+    /** Replace the label's text/HTML. */
+    setText(text: string): void;
+    /** Remove the label from the scene and the DOM. */
+    remove(): void;
+}
+interface LabelLayer {
+    /** Create a label at a world position. `className` lets callers theme groups of labels. */
+    addLabel(text: string, position: THREE.Vector3, className?: string): LabelHandle;
+    /** Render the DOM overlay. Call each frame after the WebGL render, with the active camera. */
+    render(scene: THREE.Scene, camera: THREE.Camera): void;
+    setSize(width: number, height: number): void;
+    dispose(): void;
+}
+/**
+ * @param container element to overlay labels onto — normally the canvas's parent, so the overlay and
+ * canvas share a positioning context. The overlay is appended here and absolutely positioned.
+ * @param scene labels are parented to a group added to this scene, so they render and follow the
+ * camera without the caller wiring scene-graph parenting.
+ */
+declare function createLabelLayer(container: HTMLElement, scene: THREE.Scene): LabelLayer;
 
 /**
  * A two-click distance measurement tool — the CAD verb users expect. Click a point, click a second,
@@ -246,6 +325,35 @@ interface MeasureTool {
     clear(): void;
     dispose(): void;
 }
+interface MeasureOptions {
+    /** Snap to a vertex when the cursor is within this many screen pixels of it. Default 12. */
+    snapPixels?: number;
+    /** Marker + line color. Default yellow. */
+    color?: THREE.ColorRepresentation;
+    /** CSS class applied to the distance label, for styling. */
+    labelClassName?: string;
+    /** Format the distance number → label text. Default: 3 significant digits + " m". */
+    format?: (distance: number) => string;
+}
+interface MeasureDeps {
+    canvas: HTMLCanvasElement;
+    scene: THREE.Scene;
+    getActiveCamera: () => THREE.Camera;
+    labelLayer: LabelLayer;
+    options?: MeasureOptions;
+}
+/**
+ * Snap a raycast hit to the nearest vertex of the struck triangle if it's within `snapPixels` on
+ * screen; otherwise return the raw hit point. Pure (no DOM) so it's unit-testable: it takes the
+ * screen size explicitly rather than reading the canvas. Exported for that reason.
+ *
+ * Falls back to the raw point for non-mesh hits (e.g. a curve) or geometry without a face/positions.
+ */
+declare function snapToVertex(hit: THREE.Intersection, camera: THREE.Camera, screenSize: {
+    width: number;
+    height: number;
+}, snapPixels: number): THREE.Vector3;
+declare function createMeasureTool(deps: MeasureDeps): MeasureTool;
 
 /**
  * Initializes a Three.js environment with scene, camera, renderer, and event handling.
@@ -282,6 +390,22 @@ declare const initThree: (canvas: HTMLCanvasElement, options?: ThreeInitializerO
  * @param initialPositionSet - A boolean indicating whether the initial position of the camera and controls have been set.
  */
 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.
+ */
+declare function parseColor(colorString: string): THREE.Color;
+declare function applyOffset(meshes: THREE.Object3D[], offsetY: number): void;
+/**
+ * Computes the combined world-axis-aligned bounding box of a set of objects (meshes, lines, points).
+ * Correctly accounts for transformations (rotation, position, scale).
+ */
+declare function computeCombinedBoundingBox(meshes: THREE.Object3D[]): THREE.Box3;
 
 declare const EMISSIVE_MATERIAL: THREE.MeshPhysicalMaterial;
 declare const METAL_MATERIAL: THREE.MeshPhysicalMaterial;
@@ -302,6 +426,75 @@ declare namespace threeMaterials {
   export { threeMaterials_CONCRETE_MATERIAL as CONCRETE_MATERIAL, threeMaterials_EMISSIVE_MATERIAL as EMISSIVE_MATERIAL, threeMaterials_GLASS_MATERIAL as GLASS_MATERIAL, threeMaterials_METAL_MATERIAL as METAL_MATERIAL, threeMaterials_PLASTIC_MATERIAL as PLASTIC_MATERIAL, threeMaterials_RUBBER_MATERIAL as RUBBER_MATERIAL, threeMaterials_WOOD_MATERIAL as WOOD_MATERIAL };
 }
 
+/**
+ * Crisp boundary/crease edges overlaid on meshes — the defining "technical drawing" look that makes
+ * shaded geometry read as discrete objects rather than blobs.
+ *
+ * Built with `EdgesGeometry` (which keeps only edges whose adjacent faces meet above a threshold
+ * angle, so flat tessellation noise is dropped) rendered as a fat `LineSegments2` using the same
+ * `LineMaterial` family as curves (Phase 1) — so edges get controllable thickness, not the 1px cap
+ * of `THREE.LineSegments`. The overlay is added as a *child* of each mesh, so it inherits the mesh's
+ * transform and is disposed when the mesh subtree is cleared.
+ */
+interface EdgeOptions {
+    /** Edge color. Default near-black. */
+    color?: THREE.ColorRepresentation;
+    /** Edge thickness in CSS px. Default 1.5. */
+    width?: number;
+    /**
+     * Crease angle in degrees: an edge is kept only where its two faces differ by more than this.
+     * Default 30. Higher = fewer edges (only sharp creases); lower = more (catches gentle bends).
+     */
+    thresholdAngle?: number;
+}
+/** Tag on edge overlays so pick/fit/clear logic can recognize and skip or dispose them. */
+declare const EDGE_USERDATA_KIND = "edge-overlay";
+/**
+ * Walk an object subtree and attach an edge overlay to every `Mesh` found, returning the created
+ * overlays (so callers can dispose them explicitly if they don't clear the whole subtree). Meshes
+ * that already carry an overlay are skipped, so this is safe to call more than once.
+ *
+ * Skips the floor and the grid (they're aids, not content) and anything already tagged as an edge.
+ */
+declare function addEdges(root: THREE.Object3D, options?: EdgeOptions): LineSegments2[];
+/** Whether an object is an edge overlay (for pick/fit filters elsewhere). */
+declare function isEdgeOverlay(object: THREE.Object3D): boolean;
+/**
+ * Remove every edge overlay under `root`, disposing its geometry and material. The inverse of
+ * {@link addEdges}; together they make edges a live on/off toggle. Returns how many were removed.
+ */
+declare function removeEdges(root: THREE.Object3D): number;
+
+/**
+ * Optional postprocessing pipeline for ambient occlusion. Default-OFF: the viewer only constructs
+ * this when `render.ambientOcclusion` is enabled, and otherwise renders with a plain
+ * `renderer.render` so the cheap path stays cheap (the chosen tradeoff — see cad-viewer-plan.md).
+ *
+ * Pipeline: RenderPass → GTAOPass → OutputPass. GTAO (ground-truth AO) is the modern replacement for
+ * SSAO/SAO — better contact shadows in crevices, the "engineered" depth cue. `screenSpaceRadius` is
+ * on so the AO radius is in screen space, which keeps it scale-robust across the viewer's mm→m
+ * scenes without per-scene tuning. OutputPass applies tone mapping + color space (taking over the
+ * roles the renderer did directly in the non-composer path).
+ *
+ * Camera swaps: the active camera can flip perspective↔ortho. Rather than rebuild the composer, we
+ * retarget the passes' `camera` each render via {@link setCamera}.
+ */
+interface RenderPipeline {
+    render(deltaTime: number): void;
+    setSize(width: number, height: number, pixelRatio: number): void;
+    /** Point the passes at the currently active camera (call when projection changes). */
+    setCamera(camera: THREE.Camera): void;
+    dispose(): void;
+}
+interface RenderPipelineOptions {
+    /** Tone mapping to apply in OutputPass (mirror the renderer's). */
+    toneMapping: THREE.ToneMapping;
+    toneMappingExposure: number;
+    /** AO strength 0–1. Default 1. */
+    aoIntensity?: number;
+}
+declare function createRenderPipeline(renderer: THREE.WebGLRenderer, scene: THREE.Scene, camera: THREE.Camera, width: number, height: number, options: RenderPipelineOptions): RenderPipeline;
+
 declare const SCALE_FACTORS: Record<string, number>;
 /**
  * Extracts and processes display meshes from a ComputePointerResponse using the Grasshopper WebDisplay component.
@@ -405,4 +598,4 @@ interface DisplayItemParseOptions {
  */
 declare function parseDisplayItems(items: DisplayItem[] | undefined, options?: DisplayItemParseOptions): THREE.Object3D[];
 
-export { type CameraConfig, type ControlsConfig, DisplayBatch, DisplayItem, type DisplayItemParseOptions, type EnvironmentConfig, type EventConfig, type FloorConfig, type LightingConfig, threeMaterials as Materials, MeshExtractionOptions, type RenderConfig, SCALE_FACTORS, type ThreeInitializerOptions, getThreeMeshesFromComputeResponse, initThree, parseDisplayItems, parseMeshBatchBlob, parseMeshBatchObject, updateScene };
+export { type CameraConfig, type CameraController, type CameraProjection, type ControlsConfig, DisplayBatch, DisplayItem, type DisplayItemParseOptions, EDGE_USERDATA_KIND, type EdgeOptions, type EdgesConfig, type EnvironmentConfig, type EventConfig, type FloorConfig, type GizmoConfig, type Grid, type GridConfig, type GridOptions, type LabelHandle, type LabelLayer, type LightingConfig, threeMaterials as Materials, type MeasureConfig, type MeasureOptions, type MeasureTool, MeshExtractionOptions, type RenderConfig, type RenderPipeline, type RenderPipelineOptions, SCALE_FACTORS, type ThreeInitializerOptions, type ViewGizmo, type ViewPreset, addEdges, applyOffset, computeCombinedBoundingBox, createCameraController, createGrid, createLabelLayer, createMeasureTool, createRenderPipeline, createViewGizmo, getThreeMeshesFromComputeResponse, initThree, isEdgeOverlay, parseColor, parseDisplayItems, parseMeshBatchBlob, parseMeshBatchObject, removeEdges, snapToVertex, updateScene };

package/dist/visualization.js

@@ -1,2 +1,2 @@
-import{A as p,a as e,p as t,q as i,r as s,x as o,y as a,z as r}from"./chunk-Z4TVQVMV.js";import"./chunk-GTTKNF4G.js";export{i as Materials,r as SCALE_FACTORS,p as getThreeMeshesFromComputeResponse,t as initThree,s as parseDisplayItems,a as parseMeshBatchBlob,o as parseMeshBatchObject,e as updateScene};
+import{A 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,q as C,r as g,x as h,y as c,z as v}from"./chunk-PGOKADJC.js";import"./chunk-XFYFC2DH.js";export{p as EDGE_USERDATA_KIND,C as Materials,v as SCALE_FACTORS,n as addEdges,t as applyOffset,o as computeCombinedBoundingBox,i as createCameraController,a as createGrid,y as createLabelLayer,d as createMeasureTool,m as createRenderPipeline,s as createViewGizmo,j as getThreeMeshesFromComputeResponse,x as initThree,l as isEdgeOverlay,r as parseColor,g as parseDisplayItems,c as parseMeshBatchBlob,h as parseMeshBatchObject,f as removeEdges,u as snapToVertex,e as updateScene};
 //# sourceMappingURL=visualization.js.map

package/package.json

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