@selvajs/compute 3.1.0-beta.11 → 3.1.0-beta.13

package/dist/index.cjs

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true});var _chunkQZECCPT3cjs = require('./chunk-QZECCPT3.cjs');var _chunkCUQQ3ZBVcjs = require('./chunk-CUQQ3ZBV.cjs');exports.ComputeServerStats = _chunkCUQQ3ZBVcjs.n; exports.ErrorCodes = _chunkCUQQ3ZBVcjs.c; exports.GrasshopperClient = _chunkQZECCPT3cjs.g; exports.GrasshopperResponseProcessor = _chunkQZECCPT3cjs.h; exports.RhinoComputeError = _chunkCUQQ3ZBVcjs.d; exports.SolveScheduler = _chunkQZECCPT3cjs.f; exports.TreeBuilder = _chunkQZECCPT3cjs.m; exports.camelcaseKeys = _chunkCUQQ3ZBVcjs.p; exports.downloadFileData = _chunkCUQQ3ZBVcjs.t; exports.enableDebugLogging = _chunkCUQQ3ZBVcjs.g; exports.extractFilesFromComputeResponse = _chunkCUQQ3ZBVcjs.s; exports.fetchDefinitionIO = _chunkQZECCPT3cjs.k; exports.fetchParsedDefinitionIO = _chunkQZECCPT3cjs.l; exports.fetchRhinoCompute = _chunkCUQQ3ZBVcjs.l; exports.getLogger = _chunkCUQQ3ZBVcjs.e; exports.hashDefinition = _chunkQZECCPT3cjs.e; exports.hashSolveInput = _chunkQZECCPT3cjs.d; exports.isDefinitionRef = _chunkQZECCPT3cjs.a; exports.processInput = _chunkQZECCPT3cjs.i; exports.processInputs = _chunkQZECCPT3cjs.j; exports.setLogger = _chunkCUQQ3ZBVcjs.f; exports.solveGrasshopperDefinition = _chunkQZECCPT3cjs.b; exports.stableStringify = _chunkQZECCPT3cjs.c; exports.toCamelCase = _chunkCUQQ3ZBVcjs.o;
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});var _chunk6R4EL3ZJcjs = require('./chunk-6R4EL3ZJ.cjs');var _chunkH3FZW6OXcjs = require('./chunk-H3FZW6OX.cjs');exports.ComputeServerStats = _chunkH3FZW6OXcjs.p; exports.ErrorCodes = _chunkH3FZW6OXcjs.c; exports.GrasshopperClient = _chunk6R4EL3ZJcjs.g; exports.GrasshopperResponseProcessor = _chunk6R4EL3ZJcjs.h; exports.RhinoComputeError = _chunkH3FZW6OXcjs.d; exports.SolveScheduler = _chunk6R4EL3ZJcjs.f; exports.TreeBuilder = _chunk6R4EL3ZJcjs.m; exports.camelcaseKeys = _chunkH3FZW6OXcjs.r; exports.downloadFileData = _chunkH3FZW6OXcjs.v; exports.enableDebugLogging = _chunkH3FZW6OXcjs.g; exports.extractFilesFromComputeResponse = _chunkH3FZW6OXcjs.u; exports.fetchDefinitionIO = _chunk6R4EL3ZJcjs.k; exports.fetchParsedDefinitionIO = _chunk6R4EL3ZJcjs.l; exports.fetchRhinoCompute = _chunkH3FZW6OXcjs.n; exports.getLogger = _chunkH3FZW6OXcjs.e; exports.getResponseWireSize = _chunkH3FZW6OXcjs.m; exports.hashDefinition = _chunk6R4EL3ZJcjs.e; exports.hashSolveInput = _chunk6R4EL3ZJcjs.d; exports.isDefinitionRef = _chunk6R4EL3ZJcjs.a; exports.processInput = _chunk6R4EL3ZJcjs.i; exports.processInputs = _chunk6R4EL3ZJcjs.j; exports.setLogger = _chunkH3FZW6OXcjs.f; exports.setResponseWireSize = _chunkH3FZW6OXcjs.l; exports.solveGrasshopperDefinition = _chunk6R4EL3ZJcjs.b; exports.stableStringify = _chunk6R4EL3ZJcjs.c; exports.toCamelCase = _chunkH3FZW6OXcjs.q;
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["/home/runner/work/selva/selva/packages/compute/dist/index.cjs"],"names":[],"mappings":"AAAA,iIAA4H,wDAAqG,moCAA4hB","file":"/home/runner/work/selva/selva/packages/compute/dist/index.cjs"}
+{"version":3,"sources":["/home/runner/work/selva/selva/packages/compute/dist/index.cjs"],"names":[],"mappings":"AAAA,iIAA4H,wDAAmH,yuCAA8kB","file":"/home/runner/work/selva/selva/packages/compute/dist/index.cjs"}

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-export { Logger, camelcaseKeys, enableDebugLogging, fetchRhinoCompute, getLogger, setLogger, toCamelCase } from './core.cjs';
+export { Logger, camelcaseKeys, enableDebugLogging, fetchRhinoCompute, getLogger, getResponseWireSize, setLogger, setResponseWireSize, toCamelCase } from './core.cjs';
 export { C as ComputeServerStats, E as ErrorCode, a as ErrorCodes, F as FileBaseInfo, b as FileData, P as ProcessedFile, R as RhinoComputeError, d as downloadFileData, e as extractFilesFromComputeResponse } from './handle-files-BISo_wob.cjs';
 export { C as ComputeConfig, R as RetryPolicy, a as RhinoModelUnit, S as ServerTiming } from './types-BGhtYxZ-.cjs';
 export { CacheOptions, DataTreeValue, DefinitionRef, GetValuesOptions, GetValuesResult, GrasshopperClient, GrasshopperResponseProcessor, ParsedContext, SchedulerMode, SolveContext, SolveDefinition, SolveOptions, SolveResult, SolveScheduler, SolveSchedulerOptions, TreeBuilder, fetchDefinitionIO, fetchParsedDefinitionIO, hashDefinition, hashSolveInput, isDefinitionRef, processInput, processInputs, solveGrasshopperDefinition, stableStringify } from './grasshopper.cjs';

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-export { Logger, camelcaseKeys, enableDebugLogging, fetchRhinoCompute, getLogger, setLogger, toCamelCase } from './core.js';
+export { Logger, camelcaseKeys, enableDebugLogging, fetchRhinoCompute, getLogger, getResponseWireSize, setLogger, setResponseWireSize, toCamelCase } from './core.js';
 export { C as ComputeServerStats, E as ErrorCode, a as ErrorCodes, F as FileBaseInfo, b as FileData, P as ProcessedFile, R as RhinoComputeError, d as downloadFileData, e as extractFilesFromComputeResponse } from './handle-files-BISo_wob.js';
 export { C as ComputeConfig, R as RetryPolicy, a as RhinoModelUnit, S as ServerTiming } from './types-BGhtYxZ-.js';
 export { CacheOptions, DataTreeValue, DefinitionRef, GetValuesOptions, GetValuesResult, GrasshopperClient, GrasshopperResponseProcessor, ParsedContext, SchedulerMode, SolveContext, SolveDefinition, SolveOptions, SolveResult, SolveScheduler, SolveSchedulerOptions, TreeBuilder, fetchDefinitionIO, fetchParsedDefinitionIO, hashDefinition, hashSolveInput, isDefinitionRef, processInput, processInputs, solveGrasshopperDefinition, stableStringify } from './grasshopper.js';

package/dist/index.js

@@ -1,2 +1,2 @@
-import{a as d,b as g,c as h,d as i,e as j,f as k,g as l,h as n,i as q,j as s,k as u,l as v,m as w}from"./chunk-C7P43VZF.js";import{c as o,d as r,e,f,g as m,l as p,n as t,o as x,p as a,s as b,t as c}from"./chunk-WPB2LKCD.js";export{t as ComputeServerStats,o as ErrorCodes,l as GrasshopperClient,n as GrasshopperResponseProcessor,r as RhinoComputeError,k as SolveScheduler,w as TreeBuilder,a as camelcaseKeys,c as downloadFileData,m as enableDebugLogging,b as extractFilesFromComputeResponse,u as fetchDefinitionIO,v as fetchParsedDefinitionIO,p as fetchRhinoCompute,e as getLogger,j as hashDefinition,i as hashSolveInput,d as isDefinitionRef,q as processInput,s as processInputs,f as setLogger,g as solveGrasshopperDefinition,h as stableStringify,x as toCamelCase};
+import{a as h,b as i,c as j,d as k,e as l,f as n,g as q,h as s,i as u,j as v,k as w,l as y,m as z}from"./chunk-6TMSTNHN.js";import{c as o,d as r,e,f,g as m,l as p,m as t,n as x,p as a,q as b,r as c,u as d,v as g}from"./chunk-Y3M7P3BW.js";export{a as ComputeServerStats,o as ErrorCodes,q as GrasshopperClient,s as GrasshopperResponseProcessor,r as RhinoComputeError,n as SolveScheduler,z as TreeBuilder,c as camelcaseKeys,g as downloadFileData,m as enableDebugLogging,d as extractFilesFromComputeResponse,w as fetchDefinitionIO,y as fetchParsedDefinitionIO,x as fetchRhinoCompute,e as getLogger,t as getResponseWireSize,l as hashDefinition,k as hashSolveInput,h as isDefinitionRef,u as processInput,v as processInputs,f as setLogger,p as setResponseWireSize,i as solveGrasshopperDefinition,j as stableStringify,b as toCamelCase};
 //# sourceMappingURL=index.js.map

package/dist/visualization-BIHTM2KJ.js

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

package/dist/visualization-FLDYIZ3F.cjs

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});var _chunkGLOTP5TCcjs = require('./chunk-GLOTP5TC.cjs');require('./chunk-H3FZW6OX.cjs');exports.BINARY_MESH_MAGIC = _chunkGLOTP5TCcjs.A; exports.BINARY_MESH_VERSION = _chunkGLOTP5TCcjs.C; exports.COMPRESSED_MESH_MAGIC = _chunkGLOTP5TCcjs.B; exports.EDGES_SKIPPED_TRIANGLE_CAP = _chunkGLOTP5TCcjs.j; exports.EDGE_USERDATA_KIND = _chunkGLOTP5TCcjs.i; exports.FLAG_DELTA_ENCODED = _chunkGLOTP5TCcjs.G; exports.FLAG_FLOAT32 = _chunkGLOTP5TCcjs.E; exports.FLAG_HAS_UVS = _chunkGLOTP5TCcjs.H; exports.FLAG_HAS_VERTEX_COLORS = _chunkGLOTP5TCcjs.I; exports.FLAG_UINT16_INDICES = _chunkGLOTP5TCcjs.F; exports.LOOKS = _chunkGLOTP5TCcjs.y; exports.MIN_SUPPORTED_VERSION = _chunkGLOTP5TCcjs.D; exports.Materials = _chunkGLOTP5TCcjs.a; exports.SCALE_FACTORS = _chunkGLOTP5TCcjs.P; exports.TEXTURE_CACHE_MAX_ENTRIES = _chunkGLOTP5TCcjs.t; exports.UV_FORMAT_FLOAT32 = _chunkGLOTP5TCcjs.K; exports.UV_FORMAT_UINT16 = _chunkGLOTP5TCcjs.J; exports.addEdges = _chunkGLOTP5TCcjs.l; exports.addEdgesAsync = _chunkGLOTP5TCcjs.m; exports.applyOffset = _chunkGLOTP5TCcjs.d; exports.clearTextureCache = _chunkGLOTP5TCcjs.v; exports.computeCombinedBoundingBox = _chunkGLOTP5TCcjs.e; exports.createCameraController = _chunkGLOTP5TCcjs.f; exports.createGrid = _chunkGLOTP5TCcjs.g; exports.createLabelLayer = _chunkGLOTP5TCcjs.q; exports.createMeasureTool = _chunkGLOTP5TCcjs.s; exports.createRenderPipeline = _chunkGLOTP5TCcjs.p; exports.createViewGizmo = _chunkGLOTP5TCcjs.h; exports.getThreeMeshesFromComputeResponse = _chunkGLOTP5TCcjs.Q; exports.initThree = _chunkGLOTP5TCcjs.x; exports.isEdgeOverlay = _chunkGLOTP5TCcjs.k; exports.materialAppearanceForLook = _chunkGLOTP5TCcjs.w; exports.parseBinaryMeshBatch = _chunkGLOTP5TCcjs.L; exports.parseColor = _chunkGLOTP5TCcjs.c; exports.parseDisplayItems = _chunkGLOTP5TCcjs.z; exports.parseMeshBatch = _chunkGLOTP5TCcjs.M; exports.parseMeshBatchBlob = _chunkGLOTP5TCcjs.O; exports.parseMeshBatchObject = _chunkGLOTP5TCcjs.N; exports.removeEdges = _chunkGLOTP5TCcjs.n; exports.setTextureAnisotropy = _chunkGLOTP5TCcjs.u; exports.snapToVertex = _chunkGLOTP5TCcjs.r; exports.updateScene = _chunkGLOTP5TCcjs.b;
+//# sourceMappingURL=visualization-FLDYIZ3F.cjs.map

package/dist/visualization-FLDYIZ3F.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/home/runner/work/selva/selva/packages/compute/dist/visualization-FLDYIZ3F.cjs"],"names":[],"mappings":"AAAA,iIAAkU,gCAA6B,y/DAA87B","file":"/home/runner/work/selva/selva/packages/compute/dist/visualization-FLDYIZ3F.cjs"}

package/dist/visualization.cjs

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true});var _chunk7XMD5YXPcjs = require('./chunk-7XMD5YXP.cjs');require('./chunk-CUQQ3ZBV.cjs');exports.EDGE_USERDATA_KIND = _chunk7XMD5YXPcjs.i; exports.LOOKS = _chunk7XMD5YXPcjs.v; exports.Materials = _chunk7XMD5YXPcjs.a; exports.SCALE_FACTORS = _chunk7XMD5YXPcjs.M; exports.addEdges = _chunk7XMD5YXPcjs.j; exports.applyOffset = _chunk7XMD5YXPcjs.d; exports.computeCombinedBoundingBox = _chunk7XMD5YXPcjs.e; exports.createCameraController = _chunk7XMD5YXPcjs.f; exports.createGrid = _chunk7XMD5YXPcjs.g; exports.createLabelLayer = _chunk7XMD5YXPcjs.n; exports.createMeasureTool = _chunk7XMD5YXPcjs.p; exports.createRenderPipeline = _chunk7XMD5YXPcjs.m; exports.createViewGizmo = _chunk7XMD5YXPcjs.h; exports.getThreeMeshesFromComputeResponse = _chunk7XMD5YXPcjs.N; exports.initThree = _chunk7XMD5YXPcjs.u; exports.isEdgeOverlay = _chunk7XMD5YXPcjs.k; exports.parseColor = _chunk7XMD5YXPcjs.c; exports.parseDisplayItems = _chunk7XMD5YXPcjs.w; exports.parseMeshBatchBlob = _chunk7XMD5YXPcjs.L; exports.parseMeshBatchObject = _chunk7XMD5YXPcjs.K; exports.removeEdges = _chunk7XMD5YXPcjs.l; exports.snapToVertex = _chunk7XMD5YXPcjs.o; exports.updateScene = _chunk7XMD5YXPcjs.b;
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});var _chunkGLOTP5TCcjs = require('./chunk-GLOTP5TC.cjs');require('./chunk-H3FZW6OX.cjs');exports.EDGES_SKIPPED_TRIANGLE_CAP = _chunkGLOTP5TCcjs.j; exports.EDGE_USERDATA_KIND = _chunkGLOTP5TCcjs.i; exports.EdgeDetectionPass = _chunkGLOTP5TCcjs.o; exports.LOOKS = _chunkGLOTP5TCcjs.y; exports.Materials = _chunkGLOTP5TCcjs.a; exports.SCALE_FACTORS = _chunkGLOTP5TCcjs.P; exports.addEdges = _chunkGLOTP5TCcjs.l; exports.addEdgesAsync = _chunkGLOTP5TCcjs.m; exports.applyOffset = _chunkGLOTP5TCcjs.d; exports.computeCombinedBoundingBox = _chunkGLOTP5TCcjs.e; exports.createCameraController = _chunkGLOTP5TCcjs.f; exports.createGrid = _chunkGLOTP5TCcjs.g; exports.createLabelLayer = _chunkGLOTP5TCcjs.q; exports.createMeasureTool = _chunkGLOTP5TCcjs.s; exports.createRenderPipeline = _chunkGLOTP5TCcjs.p; exports.createViewGizmo = _chunkGLOTP5TCcjs.h; exports.getThreeMeshesFromComputeResponse = _chunkGLOTP5TCcjs.Q; exports.initThree = _chunkGLOTP5TCcjs.x; exports.isEdgeOverlay = _chunkGLOTP5TCcjs.k; exports.parseColor = _chunkGLOTP5TCcjs.c; exports.parseDisplayItems = _chunkGLOTP5TCcjs.z; exports.parseMeshBatchBlob = _chunkGLOTP5TCcjs.O; exports.parseMeshBatchObject = _chunkGLOTP5TCcjs.N; exports.removeEdges = _chunkGLOTP5TCcjs.n; exports.snapToVertex = _chunkGLOTP5TCcjs.r; exports.updateScene = _chunkGLOTP5TCcjs.b;
 //# sourceMappingURL=visualization.cjs.map

package/dist/visualization.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["/home/runner/work/selva/selva/packages/compute/dist/visualization.cjs"],"names":[],"mappings":"AAAA,iIAAkM,gCAA6B,ujCAA0e","file":"/home/runner/work/selva/selva/packages/compute/dist/visualization.cjs"}
+{"version":3,"sources":["/home/runner/work/selva/selva/packages/compute/dist/visualization.cjs"],"names":[],"mappings":"AAAA,iIAAuN,gCAA6B,+sCAAojB","file":"/home/runner/work/selva/selva/packages/compute/dist/visualization.cjs"}

package/dist/visualization.d.cts

@@ -4,6 +4,7 @@ import { M as MaterialAppearanceOptions, f as GrasshopperComputeResponse, m as M
 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 { Pass } from 'three/addons/postprocessing/Pass.js';
 import { RhinoModule } from 'rhino3dm';
 import './types-BGhtYxZ-.cjs';
 
@@ -88,6 +89,13 @@ type RenderConfig = {
      * toward the display DPR for sharper AO at higher cost; only relevant when AO is enabled.
      */
     aoPixelRatio?: number;
+    /**
+     * Render only when something changed (camera motion, invalidate(), pointer input, resize), with
+     * a ~500 ms safety repaint, instead of every animation frame. Default true — cuts idle GPU/battery
+     * to ~2 fps worth of work, which matters especially with ambient occlusion on. Set false to
+     * restore the legacy continuous loop.
+     */
+    onDemand?: boolean;
 };
 /**
  * A ready-to-go visual look. A `look` is a named bundle of LIGHTING/MATERIAL defaults only — it is
@@ -114,14 +122,31 @@ type Look = (typeof LOOKS)[number];
 type EdgesConfig = {
     /** Auto-attach edge overlays to meshes as they load. Default false (opt-in). */
     enabled?: boolean;
-    /** Edge color. Default near-black. */
+    /**
+     * Force a single edge color for all meshes. Omit (the default) to derive each mesh's edge color
+     * from its own surface material, darkened by `darken` — so edges read as the object's own outline.
+     */
     color?: THREE.ColorRepresentation;
+    /**
+     * How far derived edge colors are darkened toward black, 0–1 (default 0.75). Ignored when `color`
+     * is set.
+     */
+    darken?: number;
     /** Edge thickness in CSS px. Default 1.5. */
     width?: number;
-    /** Crease angle (degrees): keep edges where faces differ by more than this. Default 30. */
+    /** Crease angle (degrees): keep edges where faces differ by more than this. Default 44. */
     thresholdAngle?: number;
     /** Fade an overlay out as its mesh shrinks on screen, so far zoom-outs stay clean. Default true. */
     distanceFade?: boolean;
+    /** Skip overlay extraction for meshes above this triangle count. Default 4M. See `EdgeOptions`. */
+    maxTriangles?: number;
+    /** Overlays above this segment count render opaque (no distance fade). Default 2M. */
+    maxSegments?: number;
+    /**
+     * When a mesh is skipped for exceeding `maxTriangles`, approximate its edges with the
+     * screen-space edge-detection pass (constant cost in triangle count). Default true.
+     */
+    screenSpaceFallback?: boolean;
 };
 type ControlsConfig = {
     enableDamping?: boolean;
@@ -320,6 +345,13 @@ interface Grid {
     readonly object: THREE.Mesh;
     /** Keep the fade centered on the camera so the grid feels infinite as you move. Call per frame. */
     update(cameraPosition: THREE.Vector3): void;
+    /**
+     * Rescale the grid's cell spacing and fade radius to the loaded content's extent. Call after a
+     * geometry change (e.g. right after `updateScene`) so a part that is 3 units or 3000 units wide
+     * both get sensibly-sized cells and a fade that reaches past the model. No-op for empty/degenerate
+     * bounds — the grid keeps its last (or default) scale. See {@link Grid.fitToContent}'s impl notes.
+     */
+    fitToContent(bounds: THREE.Box3): void;
     setVisible(visible: boolean): void;
     dispose(): void;
 }
@@ -500,9 +532,24 @@ declare const initThree: (canvas: HTMLCanvasElement, options?: ThreeInitializerO
     measureTool: MeasureTool | null;
     /**
      * Attach edge overlays to the meshes under `root` (no-op unless `edges.enabled`). Call after
-     * loading meshes via `updateScene`, since meshes arrive after init.
+     * loading meshes via `updateScene`, since meshes arrive after init. Extraction for large meshes
+     * runs off-thread — their overlays attach a beat later; meshes over `edges.maxTriangles` are
+     * skipped and (by default) covered by the screen-space edge fallback instead.
      */
     applyEdges: (root: THREE.Object3D) => void;
+    /**
+     * Remove edge overlays under `root` — the toggle-off counterpart of `applyEdges`. Prefer this
+     * over calling `removeEdges` directly: it also cancels in-flight async attaches' fallout and
+     * stands down the screen-space edge fallback if it was active.
+     */
+    clearEdges: (root: THREE.Object3D) => void;
+    /**
+     * Request a repaint from the on-demand render loop. Camera motion, resizes, pointer input, and
+     * the built-in setters invalidate automatically; call this after mutating the scene externally
+     * (e.g. `updateScene`, adding user geometry) so the change shows immediately rather than on the
+     * next safety repaint. No-op (harmless) when `render.onDemand` is false.
+     */
+    invalidate: () => void;
     /** Toggle ambient occlusion at runtime — builds or tears down the postprocessing pipeline. */
     setAmbientOcclusion: (enabled: boolean) => void;
     /**
@@ -550,6 +597,12 @@ declare const initThree: (canvas: HTMLCanvasElement, options?: ThreeInitializerO
      * loading or replacing geometry (e.g. after `updateScene`). No-op when sunlight/shadows are off.
      */
     updateShadowBounds: () => void;
+    /**
+     * Rescale the grid's cell spacing and fade radius to the current scene content, so parts of any
+     * size get readable cells and a fade that reaches past the model. Call after loading or replacing
+     * geometry (e.g. after `updateScene`). No-op when the grid is off or there's no content.
+     */
+    updateGridScale: () => void;
     dispose: () => void;
     fitToView: () => void;
     clearSelection: () => void;
@@ -606,11 +659,23 @@ declare namespace threeMaterials {
  * 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.
+ * Edge segments are extracted by `extractEdgeSegments` (see edge-extract.ts — an
+ * `EdgesGeometry`-equivalent that is ~an order of magnitude faster and worker-portable) and
+ * rendered as fat `LineSegments2` using the same `LineMaterial` family as curves — 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.
+ *
+ * Performance model (docs/plans/4.edge-overlay-performance.md):
+ * - Extraction results are cached at two levels: per source `BufferGeometry` (object identity,
+ *   helps instanced parts within one solve) and by *content fingerprint* in an LRU — the viewer
+ *   rebuilds all geometry objects every solve, so only a content key survives re-solves.
+ * - {@link addEdgesAsync} runs extraction for large meshes in a Worker built from a blob URL
+ *   (bundler-agnostic; falls back to inline extraction when Workers are unavailable), keeping the
+ *   main thread free of the multi-second stalls extraction causes at millions of triangles.
+ * - Caps bound the pathological cases: meshes above `maxTriangles` are skipped outright (tagged
+ *   `userData.edgesSkipped = 'triangle-cap'`), overlays above `maxSegments` lose the distance
+ *   fade so they render in the cheaper opaque pass.
  *
  * Depth strategy: edges render at TRUE depth; the mesh's own surface is pushed back a hair with
  * polygonOffset instead (see {@link setSurfaceDepthOffset}). Biasing the lines toward the camera —
@@ -622,13 +687,23 @@ declare namespace threeMaterials {
  * occlusion of hidden edges exact.
  */
 interface EdgeOptions {
-    /** Edge color. Default near-black. */
+    /**
+     * Force a single edge color for every overlay. When omitted (the default), each overlay derives
+     * its color from its own mesh's material — a darkened tint of the surface — so edges read as the
+     * object's own outline rather than a uniform black frame. Meshes with no readable material color
+     * fall back to {@link DEFAULT_EDGE_COLOR}.
+     */
     color?: THREE.ColorRepresentation;
+    /**
+     * How far to darken the derived edge color toward black, 0–1 (default 0.75). Only applies when
+     * `color` is omitted. Higher = darker edges; 0 leaves edges the surface color, 1 makes them black.
+     */
+    darken?: number;
     /** 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).
+     * Default 44. Higher = fewer edges (only sharp creases); lower = more (catches gentle bends).
      */
     thresholdAngle?: number;
     /**
@@ -636,34 +711,120 @@ interface EdgeOptions {
      * covering only tens of pixels alias into dark noise; fading them keeps far zoom-outs clean.
      */
     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
+     * `userData.edgesSkipped = 'triangle-cap'` so hosts can react (e.g. enable the render-pipeline
+     * edge pass).
+     */
+    maxTriangles?: number;
+    /**
+     * Above this many extracted segments (default 2M), an overlay drops the distance fade so it
+     * renders opaque — millions of blended fat-line quads are a fill-rate cliff; opaque ones aren't.
+     */
+    maxSegments?: number;
 }
 /** Tag on edge overlays so pick/fit/clear logic can recognize and skip or dispose them. */
 declare const EDGE_USERDATA_KIND = "edge-overlay";
+/** `userData.edgesSkipped` value on meshes whose triangle count exceeded {@link EdgeOptions.maxTriangles}. */
+declare const EDGES_SKIPPED_TRIANGLE_CAP = "triangle-cap";
+/** Whether an object is an edge overlay (for pick/fit filters elsewhere). */
+declare function isEdgeOverlay(object: THREE.Object3D): boolean;
 /**
  * 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.
+ *
+ * Fully synchronous — extraction for every mesh runs on the calling thread. Interactive hosts with
+ * potentially-large meshes should prefer {@link addEdgesAsync}, which offloads big extractions to
+ * a worker.
  */
 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;
+/**
+ * Like {@link addEdges}, but extraction for large meshes runs in a Worker so the main thread never
+ * stalls. Small meshes (< ~25k triangles) still attach synchronously before this returns — only
+ * heavy extractions arrive a beat later. Resolves with every overlay actually attached.
+ *
+ * Late results are dropped (never attached) when the mesh has left the root's subtree (scene was
+ * cleared by a newer solve), the root's edges were removed via {@link removeEdges}, or another
+ * apply already attached an overlay to that mesh.
+ */
+declare function addEdgesAsync(root: THREE.Object3D, options?: EdgeOptions): Promise<LineSegments2[]>;
 /**
  * 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.
+ * {@link addEdges}/{@link addEdgesAsync}; together they make edges a live on/off toggle — this
+ * also cancels any in-flight async attaches for `root`. 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).
+ * Screen-space edge detection: draws crease/silhouette lines by finding depth and normal
+ * discontinuities, as a fullscreen pass — cost is O(pixels), independent of triangle count.
+ *
+ * This is the fallback look for scenes too heavy for geometry edge overlays (see
+ * docs/plans/4.edge-overlay-performance.md Phase 3): meshes over `EdgeOptions.maxTriangles` skip
+ * extraction, and this pass approximates the technical-drawing read at constant cost. Trade-offs
+ * vs geometry edges: uniform pixel width, one global color (no per-object tinting), view-dependent
+ * response, and gentle creases below the normal threshold don't register.
  *
- * Pipeline: RenderPass → GTAOPass → SMAAPass → 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.
+ * Works like GTAOPass internally: the scene is re-rendered with a `MeshNormalMaterial` override
+ * into a normal target carrying a depth texture (a pattern this scene already tolerates for AO),
+ * then a fullscreen shader Roberts-crosses depth (relative view-Z difference, so far scenes don't
+ * dissolve into noise) and normals, and blends the edge color over the composed image.
+ *
+ * The render target is allocated lazily on first enabled render, so constructing the pass
+ * disabled costs nothing but the material.
+ */
+interface EdgeDetectionOptions {
+    /** Edge line color. Default 0x222222 — matches the geometry overlays' default. */
+    color?: THREE.ColorRepresentation;
+    /** Edge blend strength 0–1. Default 1. */
+    opacity?: number;
+    /**
+     * Normal discontinuity threshold, in summed `1 - dot(n₁, n₂)` across the two diagonal pairs.
+     * Lower catches gentler creases. Default 0.4 (≈ the 44° crease default of geometry edges).
+     */
+    normalThreshold?: number;
+    /** Relative view-depth discontinuity threshold. Default 0.02 (2% of the center depth). */
+    depthThreshold?: number;
+    /** Sample offset in device px — line thickness. Default 1. */
+    thickness?: number;
+}
+declare class EdgeDetectionPass extends Pass {
+    camera: THREE.Camera;
+    private readonly scene;
+    private readonly normalMaterial;
+    private readonly edgeMaterial;
+    private readonly fsQuad;
+    private normalTarget;
+    private width;
+    private height;
+    constructor(scene: THREE.Scene, camera: THREE.Camera, width: number, height: number, options?: EdgeDetectionOptions);
+    private acquireNormalTarget;
+    setSize(width: number, height: number): void;
+    render(renderer: THREE.WebGLRenderer, writeBuffer: THREE.WebGLRenderTarget, readBuffer: THREE.WebGLRenderTarget): void;
+    dispose(): void;
+}
+
+/**
+ * Optional postprocessing pipeline. Default-OFF: the viewer only constructs this when a
+ * postprocessed feature (ambient occlusion, screen-space edges) 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? → EdgeDetectionPass? → SMAAPass → 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.
+ *
+ * EdgeDetectionPass draws crease/silhouette lines in screen space at O(pixels) — the fallback for
+ * scenes too triangle-heavy for geometry edge overlays (docs/plans/4.edge-overlay-performance.md).
+ * It sits before SMAA so its 1px lines get antialiased. Always constructed (its render target is
+ * lazy), so it can be toggled at runtime via {@link RenderPipeline.setEdgeDetection} without a
+ * pipeline rebuild.
  *
  * SMAA restores antialiasing on this path. The EffectComposer renders into an offscreen target, so
  * the WebGLRenderer's own MSAA (`antialias: true`) does nothing here — without a dedicated AA pass,
@@ -681,12 +842,18 @@ interface RenderPipeline {
     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;
+    /** Toggle the screen-space edge pass at runtime (no pipeline rebuild). */
+    setEdgeDetection(enabled: boolean): void;
+    /** Whether the screen-space edge pass currently runs. */
+    edgeDetectionEnabled(): boolean;
     dispose(): void;
 }
 interface RenderPipelineOptions {
     /** Tone mapping to apply in OutputPass (mirror the renderer's). */
     toneMapping: THREE.ToneMapping;
     toneMappingExposure: number;
+    /** Build the pipeline with the GTAO ambient-occlusion pass. Default true. */
+    ambientOcclusion?: boolean;
     /** AO strength 0–1. Default 1. */
     aoIntensity?: number;
     /**
@@ -695,6 +862,11 @@ interface RenderPipelineOptions {
      * pixelRatio is clamped to this. Default 1.
      */
     aoPixelRatio?: number;
+    /**
+     * Start with the screen-space edge pass enabled; pass an object to tune it. The pass itself is
+     * always constructed (cheap while disabled) so it can be toggled later via `setEdgeDetection`.
+     */
+    edgeDetection?: boolean | EdgeDetectionOptions;
 }
 declare function createRenderPipeline(renderer: THREE.WebGLRenderer, scene: THREE.Scene, camera: THREE.Camera, width: number, height: number, options: RenderPipelineOptions): RenderPipeline;
 
@@ -811,4 +983,4 @@ interface DisplayItemParseOptions {
  */
 declare function parseDisplayItems(items: DisplayItem[] | undefined, options?: DisplayItemParseOptions): THREE.Object3D[];
 
-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, LOOKS, type LabelHandle, type LabelLayer, type LightingConfig, type Look, 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 };
+export { type CameraConfig, type CameraController, type CameraProjection, type ControlsConfig, DisplayBatch, DisplayItem, type DisplayItemParseOptions, EDGES_SKIPPED_TRIANGLE_CAP, EDGE_USERDATA_KIND, type EdgeDetectionOptions, EdgeDetectionPass, type EdgeOptions, type EdgesConfig, type EnvironmentConfig, type EventConfig, type FloorConfig, type GizmoConfig, type Grid, type GridConfig, type GridOptions, LOOKS, type LabelHandle, type LabelLayer, type LightingConfig, type Look, 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, addEdgesAsync, applyOffset, computeCombinedBoundingBox, createCameraController, createGrid, createLabelLayer, createMeasureTool, createRenderPipeline, createViewGizmo, getThreeMeshesFromComputeResponse, initThree, isEdgeOverlay, parseColor, parseDisplayItems, parseMeshBatchBlob, parseMeshBatchObject, removeEdges, snapToVertex, updateScene };