copper3d 3.4.9 → 3.6.0

package/dist/bundle.umd.js

@@ -18023,7 +18023,7 @@
 
 	// Flattening for arrays of vectors and matrices
 
-	function flatten( array, nBlocks, blockSize ) {
+	function flatten$1( array, nBlocks, blockSize ) {
 
 		const firstElem = array[ 0 ];
 
@@ -18651,7 +18651,7 @@
 
 	function setValueV2fArray( gl, v ) {
 
-		const data = flatten( v, this.size, 2 );
+		const data = flatten$1( v, this.size, 2 );
 
 		gl.uniform2fv( this.addr, data );
 
@@ -18659,7 +18659,7 @@
 
 	function setValueV3fArray( gl, v ) {
 
-		const data = flatten( v, this.size, 3 );
+		const data = flatten$1( v, this.size, 3 );
 
 		gl.uniform3fv( this.addr, data );
 
@@ -18667,7 +18667,7 @@
 
 	function setValueV4fArray( gl, v ) {
 
-		const data = flatten( v, this.size, 4 );
+		const data = flatten$1( v, this.size, 4 );
 
 		gl.uniform4fv( this.addr, data );
 
@@ -18677,7 +18677,7 @@
 
 	function setValueM2Array( gl, v ) {
 
-		const data = flatten( v, this.size, 4 );
+		const data = flatten$1( v, this.size, 4 );
 
 		gl.uniformMatrix2fv( this.addr, false, data );
 
@@ -18685,7 +18685,7 @@
 
 	function setValueM3Array( gl, v ) {
 
-		const data = flatten( v, this.size, 9 );
+		const data = flatten$1( v, this.size, 9 );
 
 		gl.uniformMatrix3fv( this.addr, false, data );
 
@@ -18693,7 +18693,7 @@
 
 	function setValueM4Array( gl, v ) {
 
-		const data = flatten( v, this.size, 16 );
+		const data = flatten$1( v, this.size, 16 );
 
 		gl.uniformMatrix4fv( this.addr, false, data );
 
@@ -33068,7 +33068,7 @@ void main() {
 	const _vEnd = /*@__PURE__*/ new Vector3();
 
 	const _inverseMatrix$1 = /*@__PURE__*/ new Matrix4();
-	const _ray$1 = /*@__PURE__*/ new Ray();
+	const _ray$1$1 = /*@__PURE__*/ new Ray();
 	const _sphere$1 = /*@__PURE__*/ new Sphere();
 
 	const _intersectPointOnRay = /*@__PURE__*/ new Vector3();
@@ -33155,7 +33155,7 @@ void main() {
 			//
 
 			_inverseMatrix$1.copy( matrixWorld ).invert();
-			_ray$1.copy( raycaster.ray ).applyMatrix4( _inverseMatrix$1 );
+			_ray$1$1.copy( raycaster.ray ).applyMatrix4( _inverseMatrix$1 );
 
 			const localThreshold = threshold / ( ( this.scale.x + this.scale.y + this.scale.z ) / 3 );
 			const localThresholdSq = localThreshold * localThreshold;
@@ -33176,7 +33176,7 @@ void main() {
 					const a = index.getX( i );
 					const b = index.getX( i + 1 );
 
-					const intersect = checkIntersection( this, raycaster, _ray$1, localThresholdSq, a, b );
+					const intersect = checkIntersection( this, raycaster, _ray$1$1, localThresholdSq, a, b );
 
 					if ( intersect ) {
 
@@ -33191,7 +33191,7 @@ void main() {
 					const a = index.getX( end - 1 );
 					const b = index.getX( start );
 
-					const intersect = checkIntersection( this, raycaster, _ray$1, localThresholdSq, a, b );
+					const intersect = checkIntersection( this, raycaster, _ray$1$1, localThresholdSq, a, b );
 
 					if ( intersect ) {
 
@@ -33208,7 +33208,7 @@ void main() {
 
 				for ( let i = start, l = end - 1; i < l; i += step ) {
 
-					const intersect = checkIntersection( this, raycaster, _ray$1, localThresholdSq, i, i + 1 );
+					const intersect = checkIntersection( this, raycaster, _ray$1$1, localThresholdSq, i, i + 1 );
 
 					if ( intersect ) {
 
@@ -33220,7 +33220,7 @@ void main() {
 
 				if ( this.isLineLoop ) {
 
-					const intersect = checkIntersection( this, raycaster, _ray$1, localThresholdSq, end - 1, start );
+					const intersect = checkIntersection( this, raycaster, _ray$1$1, localThresholdSq, end - 1, start );
 
 					if ( intersect ) {
 
@@ -33300,8 +33300,8 @@ void main() {
 
 	}
 
-	const _start = /*@__PURE__*/ new Vector3();
-	const _end = /*@__PURE__*/ new Vector3();
+	const _start$1 = /*@__PURE__*/ new Vector3();
+	const _end$1 = /*@__PURE__*/ new Vector3();
 
 	class LineSegments extends Line {
 
@@ -33328,11 +33328,11 @@ void main() {
 
 				for ( let i = 0, l = positionAttribute.count; i < l; i += 2 ) {
 
-					_start.fromBufferAttribute( positionAttribute, i );
-					_end.fromBufferAttribute( positionAttribute, i + 1 );
+					_start$1.fromBufferAttribute( positionAttribute, i );
+					_end$1.fromBufferAttribute( positionAttribute, i + 1 );
 
 					lineDistances[ i ] = ( i === 0 ) ? 0 : lineDistances[ i - 1 ];
-					lineDistances[ i + 1 ] = lineDistances[ i ] + _start.distanceTo( _end );
+					lineDistances[ i + 1 ] = lineDistances[ i ] + _start$1.distanceTo( _end$1 );
 
 				}
 
@@ -33416,7 +33416,7 @@ void main() {
 
 	const _inverseMatrix = /*@__PURE__*/ new Matrix4();
 	const _ray$4 = /*@__PURE__*/ new Ray();
-	const _sphere = /*@__PURE__*/ new Sphere();
+	const _sphere$2 = /*@__PURE__*/ new Sphere();
 	const _position$2 = /*@__PURE__*/ new Vector3();
 
 	class Points extends Object3D {
@@ -33458,11 +33458,11 @@ void main() {
 
 			if ( geometry.boundingSphere === null ) geometry.computeBoundingSphere();
 
-			_sphere.copy( geometry.boundingSphere );
-			_sphere.applyMatrix4( matrixWorld );
-			_sphere.radius += threshold;
+			_sphere$2.copy( geometry.boundingSphere );
+			_sphere$2.applyMatrix4( matrixWorld );
+			_sphere$2.radius += threshold;
 
-			if ( raycaster.ray.intersectsSphere( _sphere ) === false ) return;
+			if ( raycaster.ray.intersectsSphere( _sphere$2 ) === false ) return;
 
 			//
 
@@ -33762,6 +33762,279 @@ void main() {
 
 	}
 
+	class SphereGeometry extends BufferGeometry {
+
+		constructor( radius = 1, widthSegments = 32, heightSegments = 16, phiStart = 0, phiLength = Math.PI * 2, thetaStart = 0, thetaLength = Math.PI ) {
+
+			super();
+
+			this.type = 'SphereGeometry';
+
+			this.parameters = {
+				radius: radius,
+				widthSegments: widthSegments,
+				heightSegments: heightSegments,
+				phiStart: phiStart,
+				phiLength: phiLength,
+				thetaStart: thetaStart,
+				thetaLength: thetaLength
+			};
+
+			widthSegments = Math.max( 3, Math.floor( widthSegments ) );
+			heightSegments = Math.max( 2, Math.floor( heightSegments ) );
+
+			const thetaEnd = Math.min( thetaStart + thetaLength, Math.PI );
+
+			let index = 0;
+			const grid = [];
+
+			const vertex = new Vector3();
+			const normal = new Vector3();
+
+			// buffers
+
+			const indices = [];
+			const vertices = [];
+			const normals = [];
+			const uvs = [];
+
+			// generate vertices, normals and uvs
+
+			for ( let iy = 0; iy <= heightSegments; iy ++ ) {
+
+				const verticesRow = [];
+
+				const v = iy / heightSegments;
+
+				// special case for the poles
+
+				let uOffset = 0;
+
+				if ( iy === 0 && thetaStart === 0 ) {
+
+					uOffset = 0.5 / widthSegments;
+
+				} else if ( iy === heightSegments && thetaEnd === Math.PI ) {
+
+					uOffset = - 0.5 / widthSegments;
+
+				}
+
+				for ( let ix = 0; ix <= widthSegments; ix ++ ) {
+
+					const u = ix / widthSegments;
+
+					// vertex
+
+					vertex.x = - radius * Math.cos( phiStart + u * phiLength ) * Math.sin( thetaStart + v * thetaLength );
+					vertex.y = radius * Math.cos( thetaStart + v * thetaLength );
+					vertex.z = radius * Math.sin( phiStart + u * phiLength ) * Math.sin( thetaStart + v * thetaLength );
+
+					vertices.push( vertex.x, vertex.y, vertex.z );
+
+					// normal
+
+					normal.copy( vertex ).normalize();
+					normals.push( normal.x, normal.y, normal.z );
+
+					// uv
+
+					uvs.push( u + uOffset, 1 - v );
+
+					verticesRow.push( index ++ );
+
+				}
+
+				grid.push( verticesRow );
+
+			}
+
+			// indices
+
+			for ( let iy = 0; iy < heightSegments; iy ++ ) {
+
+				for ( let ix = 0; ix < widthSegments; ix ++ ) {
+
+					const a = grid[ iy ][ ix + 1 ];
+					const b = grid[ iy ][ ix ];
+					const c = grid[ iy + 1 ][ ix ];
+					const d = grid[ iy + 1 ][ ix + 1 ];
+
+					if ( iy !== 0 || thetaStart > 0 ) indices.push( a, b, d );
+					if ( iy !== heightSegments - 1 || thetaEnd < Math.PI ) indices.push( b, c, d );
+
+				}
+
+			}
+
+			// build geometry
+
+			this.setIndex( indices );
+			this.setAttribute( 'position', new Float32BufferAttribute( vertices, 3 ) );
+			this.setAttribute( 'normal', new Float32BufferAttribute( normals, 3 ) );
+			this.setAttribute( 'uv', new Float32BufferAttribute( uvs, 2 ) );
+
+		}
+
+		copy( source ) {
+
+			super.copy( source );
+
+			this.parameters = Object.assign( {}, source.parameters );
+
+			return this;
+
+		}
+
+		static fromJSON( data ) {
+
+			return new SphereGeometry( data.radius, data.widthSegments, data.heightSegments, data.phiStart, data.phiLength, data.thetaStart, data.thetaLength );
+
+		}
+
+	}
+
+	class WireframeGeometry extends BufferGeometry {
+
+		constructor( geometry = null ) {
+
+			super();
+
+			this.type = 'WireframeGeometry';
+
+			this.parameters = {
+				geometry: geometry
+			};
+
+			if ( geometry !== null ) {
+
+				// buffer
+
+				const vertices = [];
+				const edges = new Set();
+
+				// helper variables
+
+				const start = new Vector3();
+				const end = new Vector3();
+
+				if ( geometry.index !== null ) {
+
+					// indexed BufferGeometry
+
+					const position = geometry.attributes.position;
+					const indices = geometry.index;
+					let groups = geometry.groups;
+
+					if ( groups.length === 0 ) {
+
+						groups = [ { start: 0, count: indices.count, materialIndex: 0 } ];
+
+					}
+
+					// create a data structure that contains all edges without duplicates
+
+					for ( let o = 0, ol = groups.length; o < ol; ++ o ) {
+
+						const group = groups[ o ];
+
+						const groupStart = group.start;
+						const groupCount = group.count;
+
+						for ( let i = groupStart, l = ( groupStart + groupCount ); i < l; i += 3 ) {
+
+							for ( let j = 0; j < 3; j ++ ) {
+
+								const index1 = indices.getX( i + j );
+								const index2 = indices.getX( i + ( j + 1 ) % 3 );
+
+								start.fromBufferAttribute( position, index1 );
+								end.fromBufferAttribute( position, index2 );
+
+								if ( isUniqueEdge( start, end, edges ) === true ) {
+
+									vertices.push( start.x, start.y, start.z );
+									vertices.push( end.x, end.y, end.z );
+
+								}
+
+							}
+
+						}
+
+					}
+
+				} else {
+
+					// non-indexed BufferGeometry
+
+					const position = geometry.attributes.position;
+
+					for ( let i = 0, l = ( position.count / 3 ); i < l; i ++ ) {
+
+						for ( let j = 0; j < 3; j ++ ) {
+
+							// three edges per triangle, an edge is represented as (index1, index2)
+							// e.g. the first triangle has the following edges: (0,1),(1,2),(2,0)
+
+							const index1 = 3 * i + j;
+							const index2 = 3 * i + ( ( j + 1 ) % 3 );
+
+							start.fromBufferAttribute( position, index1 );
+							end.fromBufferAttribute( position, index2 );
+
+							if ( isUniqueEdge( start, end, edges ) === true ) {
+
+								vertices.push( start.x, start.y, start.z );
+								vertices.push( end.x, end.y, end.z );
+
+							}
+
+						}
+
+					}
+
+				}
+
+				// build geometry
+
+				this.setAttribute( 'position', new Float32BufferAttribute( vertices, 3 ) );
+
+			}
+
+		}
+
+		copy( source ) {
+
+			super.copy( source );
+
+			this.parameters = Object.assign( {}, source.parameters );
+
+			return this;
+
+		}
+
+	}
+
+	function isUniqueEdge( start, end, edges ) {
+
+		const hash1 = `${start.x},${start.y},${start.z}-${end.x},${end.y},${end.z}`;
+		const hash2 = `${end.x},${end.y},${end.z}-${start.x},${start.y},${start.z}`; // coincident edge
+
+		if ( edges.has( hash1 ) === true || edges.has( hash2 ) === true ) {
+
+			return false;
+
+		} else {
+
+			edges.add( hash1 );
+			edges.add( hash2 );
+			return true;
+
+		}
+
+	}
+
 	class RawShaderMaterial extends ShaderMaterial {
 
 		static get type() {
@@ -37270,6 +37543,43 @@ void main() {
 
 	}
 
+	class InstancedBufferGeometry extends BufferGeometry {
+
+		constructor() {
+
+			super();
+
+			this.isInstancedBufferGeometry = true;
+
+			this.type = 'InstancedBufferGeometry';
+			this.instanceCount = Infinity;
+
+		}
+
+		copy( source ) {
+
+			super.copy( source );
+
+			this.instanceCount = source.instanceCount;
+
+			return this;
+
+		}
+
+		toJSON() {
+
+			const data = super.toJSON();
+
+			data.instanceCount = this.instanceCount;
+
+			data.isInstancedBufferGeometry = true;
+
+			return data;
+
+		}
+
+	}
+
 	class ImageBitmapLoader extends Loader {
 
 		constructor( manager ) {
@@ -39948,6 +40258,51 @@ void main() {
 
 	}
 
+	class InstancedInterleavedBuffer extends InterleavedBuffer {
+
+		constructor( array, stride, meshPerAttribute = 1 ) {
+
+			super( array, stride );
+
+			this.isInstancedInterleavedBuffer = true;
+
+			this.meshPerAttribute = meshPerAttribute;
+
+		}
+
+		copy( source ) {
+
+			super.copy( source );
+
+			this.meshPerAttribute = source.meshPerAttribute;
+
+			return this;
+
+		}
+
+		clone( data ) {
+
+			const ib = super.clone( data );
+
+			ib.meshPerAttribute = this.meshPerAttribute;
+
+			return ib;
+
+		}
+
+		toJSON( data ) {
+
+			const json = super.toJSON( data );
+
+			json.isInstancedInterleavedBuffer = true;
+			json.meshPerAttribute = this.meshPerAttribute;
+
+			return json;
+
+		}
+
+	}
+
 	const _matrix = /*@__PURE__*/ new Matrix4();
 
 	class Raycaster {
@@ -40153,7 +40508,118 @@ void main() {
 
 	}
 
-	const _box = /*@__PURE__*/ new Box3();
+	const _startP = /*@__PURE__*/ new Vector3();
+	const _startEnd = /*@__PURE__*/ new Vector3();
+
+	class Line3 {
+
+		constructor( start = new Vector3(), end = new Vector3() ) {
+
+			this.start = start;
+			this.end = end;
+
+		}
+
+		set( start, end ) {
+
+			this.start.copy( start );
+			this.end.copy( end );
+
+			return this;
+
+		}
+
+		copy( line ) {
+
+			this.start.copy( line.start );
+			this.end.copy( line.end );
+
+			return this;
+
+		}
+
+		getCenter( target ) {
+
+			return target.addVectors( this.start, this.end ).multiplyScalar( 0.5 );
+
+		}
+
+		delta( target ) {
+
+			return target.subVectors( this.end, this.start );
+
+		}
+
+		distanceSq() {
+
+			return this.start.distanceToSquared( this.end );
+
+		}
+
+		distance() {
+
+			return this.start.distanceTo( this.end );
+
+		}
+
+		at( t, target ) {
+
+			return this.delta( target ).multiplyScalar( t ).add( this.start );
+
+		}
+
+		closestPointToPointParameter( point, clampToLine ) {
+
+			_startP.subVectors( point, this.start );
+			_startEnd.subVectors( this.end, this.start );
+
+			const startEnd2 = _startEnd.dot( _startEnd );
+			const startEnd_startP = _startEnd.dot( _startP );
+
+			let t = startEnd_startP / startEnd2;
+
+			if ( clampToLine ) {
+
+				t = clamp( t, 0, 1 );
+
+			}
+
+			return t;
+
+		}
+
+		closestPointToPoint( point, clampToLine, target ) {
+
+			const t = this.closestPointToPointParameter( point, clampToLine );
+
+			return this.delta( target ).multiplyScalar( t ).add( this.start );
+
+		}
+
+		applyMatrix4( matrix ) {
+
+			this.start.applyMatrix4( matrix );
+			this.end.applyMatrix4( matrix );
+
+			return this;
+
+		}
+
+		equals( line ) {
+
+			return line.start.equals( this.start ) && line.end.equals( this.end );
+
+		}
+
+		clone() {
+
+			return new this.constructor().copy( this );
+
+		}
+
+	}
+
+	const _box$5 = /*@__PURE__*/ new Box3();
 
 	class BoxHelper extends LineSegments {
 
@@ -40187,14 +40653,14 @@ void main() {
 
 			if ( this.object !== undefined ) {
 
-				_box.setFromObject( this.object );
+				_box$5.setFromObject( this.object );
 
 			}
 
-			if ( _box.isEmpty() ) return;
+			if ( _box$5.isEmpty() ) return;
 
-			const min = _box.min;
-			const max = _box.max;
+			const min = _box$5.min;
+			const max = _box$5.max;
 
 			/*
 				5____4
@@ -47515,7 +47981,7 @@ void main() {
 	const _changeEvent$1 = { type: 'change' };
 	const _startEvent$1 = { type: 'start' };
 	const _endEvent$1 = { type: 'end' };
-	const _ray = new Ray();
+	const _ray$1 = new Ray();
 	const _plane = new Plane();
 	const _TILT_LIMIT = Math.cos( 70 * MathUtils.DEG2RAD );
 
@@ -47958,19 +48424,19 @@ void main() {
 					} else {
 
 						// get the ray and translation plane to compute target
-						_ray.origin.copy( this.object.position );
-						_ray.direction.set( 0, 0, - 1 ).transformDirection( this.object.matrix );
+						_ray$1.origin.copy( this.object.position );
+						_ray$1.direction.set( 0, 0, - 1 ).transformDirection( this.object.matrix );
 
 						// if the camera is 20 degrees above the horizon then don't adjust the focus target to avoid
 						// extremely large values
-						if ( Math.abs( this.object.up.dot( _ray.direction ) ) < _TILT_LIMIT ) {
+						if ( Math.abs( this.object.up.dot( _ray$1.direction ) ) < _TILT_LIMIT ) {
 
 							this.object.lookAt( this.target );
 
 						} else {
 
 							_plane.setFromNormalAndCoplanarPoint( this.object.up, this.target );
-							_ray.intersectPlane( _plane, this.target );
+							_ray$1.intersectPlane( _plane, this.target );
 
 						}
 
@@ -50094,6 +50560,7 @@ void main() {
 	class baseRenderer {
 	    constructor(container, options) {
 	        var _a, _b, _c, _d, _e;
+	        this.running = true;
 	        this.visualCtrls = [];
 	        this.container = container;
 	        this.options = options;
@@ -50194,6 +50661,25 @@ void main() {
 	    setClearColor(clearColor = 0x000000, alpha = 0) {
 	        this.renderer.setClearColor(clearColor, alpha);
 	    }
+	    // Stop the render loop (cancels the requestAnimationFrame chain).
+	    stop() {
+	        this.running = false;
+	    }
+	    // Full teardown: stop the loop, free the GPU resources, release the WebGL context
+	    // (browsers cap live contexts ~16), and remove the canvas. Call on page unmount.
+	    dispose() {
+	        var _a, _b;
+	        this.running = false;
+	        try {
+	            (_a = this.pmremGenerator) === null || _a === void 0 ? void 0 : _a.dispose();
+	            this.renderer.dispose();
+	            this.renderer.forceContextLoss();
+	        }
+	        catch (e) {
+	            /* ignore */
+	        }
+	        (_b = this.renderer.domElement) === null || _b === void 0 ? void 0 : _b.remove();
+	    }
 	    addGui() {
 	        var _a, _b, _c;
 	        const gui = (this.gui = new GUI$1({
@@ -50311,6 +50797,169 @@ void main() {
 	    }
 	}
 
+	/**
+	 * @param {BufferGeometry} geometry
+	 * @param {number} tolerance
+	 * @return {BufferGeometry}
+	 */
+	function mergeVertices( geometry, tolerance = 1e-4 ) {
+
+		tolerance = Math.max( tolerance, Number.EPSILON );
+
+		// Generate an index buffer if the geometry doesn't have one, or optimize it
+		// if it's already available.
+		const hashToIndex = {};
+		const indices = geometry.getIndex();
+		const positions = geometry.getAttribute( 'position' );
+		const vertexCount = indices ? indices.count : positions.count;
+
+		// next value for triangle indices
+		let nextIndex = 0;
+
+		// attributes and new attribute arrays
+		const attributeNames = Object.keys( geometry.attributes );
+		const tmpAttributes = {};
+		const tmpMorphAttributes = {};
+		const newIndices = [];
+		const getters = [ 'getX', 'getY', 'getZ', 'getW' ];
+		const setters = [ 'setX', 'setY', 'setZ', 'setW' ];
+
+		// Initialize the arrays, allocating space conservatively. Extra
+		// space will be trimmed in the last step.
+		for ( let i = 0, l = attributeNames.length; i < l; i ++ ) {
+
+			const name = attributeNames[ i ];
+			const attr = geometry.attributes[ name ];
+
+			tmpAttributes[ name ] = new attr.constructor(
+				new attr.array.constructor( attr.count * attr.itemSize ),
+				attr.itemSize,
+				attr.normalized
+			);
+
+			const morphAttributes = geometry.morphAttributes[ name ];
+			if ( morphAttributes ) {
+
+				if ( ! tmpMorphAttributes[ name ] ) tmpMorphAttributes[ name ] = [];
+				morphAttributes.forEach( ( morphAttr, i ) => {
+
+					const array = new morphAttr.array.constructor( morphAttr.count * morphAttr.itemSize );
+					tmpMorphAttributes[ name ][ i ] = new morphAttr.constructor( array, morphAttr.itemSize, morphAttr.normalized );
+
+				} );
+
+			}
+
+		}
+
+		// convert the error tolerance to an amount of decimal places to truncate to
+		const halfTolerance = tolerance * 0.5;
+		const exponent = Math.log10( 1 / tolerance );
+		const hashMultiplier = Math.pow( 10, exponent );
+		const hashAdditive = halfTolerance * hashMultiplier;
+		for ( let i = 0; i < vertexCount; i ++ ) {
+
+			const index = indices ? indices.getX( i ) : i;
+
+			// Generate a hash for the vertex attributes at the current index 'i'
+			let hash = '';
+			for ( let j = 0, l = attributeNames.length; j < l; j ++ ) {
+
+				const name = attributeNames[ j ];
+				const attribute = geometry.getAttribute( name );
+				const itemSize = attribute.itemSize;
+
+				for ( let k = 0; k < itemSize; k ++ ) {
+
+					// double tilde truncates the decimal value
+					hash += `${ ~ ~ ( attribute[ getters[ k ] ]( index ) * hashMultiplier + hashAdditive ) },`;
+
+				}
+
+			}
+
+			// Add another reference to the vertex if it's already
+			// used by another index
+			if ( hash in hashToIndex ) {
+
+				newIndices.push( hashToIndex[ hash ] );
+
+			} else {
+
+				// copy data to the new index in the temporary attributes
+				for ( let j = 0, l = attributeNames.length; j < l; j ++ ) {
+
+					const name = attributeNames[ j ];
+					const attribute = geometry.getAttribute( name );
+					const morphAttributes = geometry.morphAttributes[ name ];
+					const itemSize = attribute.itemSize;
+					const newArray = tmpAttributes[ name ];
+					const newMorphArrays = tmpMorphAttributes[ name ];
+
+					for ( let k = 0; k < itemSize; k ++ ) {
+
+						const getterFunc = getters[ k ];
+						const setterFunc = setters[ k ];
+						newArray[ setterFunc ]( nextIndex, attribute[ getterFunc ]( index ) );
+
+						if ( morphAttributes ) {
+
+							for ( let m = 0, ml = morphAttributes.length; m < ml; m ++ ) {
+
+								newMorphArrays[ m ][ setterFunc ]( nextIndex, morphAttributes[ m ][ getterFunc ]( index ) );
+
+							}
+
+						}
+
+					}
+
+				}
+
+				hashToIndex[ hash ] = nextIndex;
+				newIndices.push( nextIndex );
+				nextIndex ++;
+
+			}
+
+		}
+
+		// generate result BufferGeometry
+		const result = geometry.clone();
+		for ( const name in geometry.attributes ) {
+
+			const tmpAttribute = tmpAttributes[ name ];
+
+			result.setAttribute( name, new tmpAttribute.constructor(
+				tmpAttribute.array.slice( 0, nextIndex * tmpAttribute.itemSize ),
+				tmpAttribute.itemSize,
+				tmpAttribute.normalized,
+			) );
+
+			if ( ! ( name in tmpMorphAttributes ) ) continue;
+
+			for ( let j = 0; j < tmpMorphAttributes[ name ].length; j ++ ) {
+
+				const tmpMorphAttribute = tmpMorphAttributes[ name ][ j ];
+
+				result.morphAttributes[ name ][ j ] = new tmpMorphAttribute.constructor(
+					tmpMorphAttribute.array.slice( 0, nextIndex * tmpMorphAttribute.itemSize ),
+					tmpMorphAttribute.itemSize,
+					tmpMorphAttribute.normalized,
+				);
+
+			}
+
+		}
+
+		// indices
+
+		result.setIndex( newIndices );
+
+		return result;
+
+	}
+
 	/**
 	 * @param {BufferGeometry} geometry
 	 * @param {number} drawMode
@@ -58688,185 +59337,2351 @@ void main() {
 			this._moveCurr.copy( this._getMouseOnCircle( event.pageX, event.pageY ) );
 			this._movePrev.copy( this._moveCurr );
 
-		} else if ( state === _STATE.ZOOM && ! this.noZoom ) {
+		} else if ( state === _STATE.ZOOM && ! this.noZoom ) {
+
+			this._zoomStart.copy( this._getMouseOnScreen( event.pageX, event.pageY ) );
+			this._zoomEnd.copy( this._zoomStart );
+
+		} else if ( state === _STATE.PAN && ! this.noPan ) {
+
+			this._panStart.copy( this._getMouseOnScreen( event.pageX, event.pageY ) );
+			this._panEnd.copy( this._panStart );
+
+		}
+
+		this.dispatchEvent( _startEvent );
+
+	}
+
+	function onMouseMove( event ) {
+
+		const state = ( this.keyState !== _STATE.NONE ) ? this.keyState : this.state;
+
+		if ( state === _STATE.ROTATE && ! this.noRotate ) {
+
+			this._movePrev.copy( this._moveCurr );
+			this._moveCurr.copy( this._getMouseOnCircle( event.pageX, event.pageY ) );
+
+		} else if ( state === _STATE.ZOOM && ! this.noZoom ) {
+
+			this._zoomEnd.copy( this._getMouseOnScreen( event.pageX, event.pageY ) );
+
+		} else if ( state === _STATE.PAN && ! this.noPan ) {
+
+			this._panEnd.copy( this._getMouseOnScreen( event.pageX, event.pageY ) );
+
+		}
+
+	}
+
+	function onMouseUp() {
+
+		this.state = _STATE.NONE;
+
+		this.dispatchEvent( _endEvent );
+
+	}
+
+	function onMouseWheel( event ) {
+
+		if ( this.enabled === false ) return;
+
+		if ( this.noZoom === true ) return;
+
+		event.preventDefault();
+
+		switch ( event.deltaMode ) {
+
+			case 2:
+				// Zoom in pages
+				this._zoomStart.y -= event.deltaY * 0.025;
+				break;
+
+			case 1:
+				// Zoom in lines
+				this._zoomStart.y -= event.deltaY * 0.01;
+				break;
+
+			default:
+				// undefined, 0, assume pixels
+				this._zoomStart.y -= event.deltaY * 0.00025;
+				break;
+
+		}
+
+		this.dispatchEvent( _startEvent );
+		this.dispatchEvent( _endEvent );
+
+	}
+
+	function onContextMenu( event ) {
+
+		if ( this.enabled === false ) return;
+
+		event.preventDefault();
+
+	}
+
+	function onTouchStart( event ) {
+
+		this._trackPointer( event );
+
+		switch ( this._pointers.length ) {
+
+			case 1:
+				this.state = _STATE.TOUCH_ROTATE;
+				this._moveCurr.copy( this._getMouseOnCircle( this._pointers[ 0 ].pageX, this._pointers[ 0 ].pageY ) );
+				this._movePrev.copy( this._moveCurr );
+				break;
+
+			default: // 2 or more
+				this.state = _STATE.TOUCH_ZOOM_PAN;
+				const dx = this._pointers[ 0 ].pageX - this._pointers[ 1 ].pageX;
+				const dy = this._pointers[ 0 ].pageY - this._pointers[ 1 ].pageY;
+				this._touchZoomDistanceEnd = this._touchZoomDistanceStart = Math.sqrt( dx * dx + dy * dy );
+
+				const x = ( this._pointers[ 0 ].pageX + this._pointers[ 1 ].pageX ) / 2;
+				const y = ( this._pointers[ 0 ].pageY + this._pointers[ 1 ].pageY ) / 2;
+				this._panStart.copy( this._getMouseOnScreen( x, y ) );
+				this._panEnd.copy( this._panStart );
+				break;
+
+		}
+
+		this.dispatchEvent( _startEvent );
+
+	}
+
+	function onTouchMove( event ) {
+
+		this._trackPointer( event );
+
+		switch ( this._pointers.length ) {
+
+			case 1:
+				this._movePrev.copy( this._moveCurr );
+				this._moveCurr.copy( this._getMouseOnCircle( event.pageX, event.pageY ) );
+				break;
+
+			default: // 2 or more
+
+				const position = this._getSecondPointerPosition( event );
+
+				const dx = event.pageX - position.x;
+				const dy = event.pageY - position.y;
+				this._touchZoomDistanceEnd = Math.sqrt( dx * dx + dy * dy );
+
+				const x = ( event.pageX + position.x ) / 2;
+				const y = ( event.pageY + position.y ) / 2;
+				this._panEnd.copy( this._getMouseOnScreen( x, y ) );
+				break;
+
+		}
+
+	}
+
+	function onTouchEnd( event ) {
+
+		switch ( this._pointers.length ) {
+
+			case 0:
+				this.state = _STATE.NONE;
+				break;
+
+			case 1:
+				this.state = _STATE.TOUCH_ROTATE;
+				this._moveCurr.copy( this._getMouseOnCircle( event.pageX, event.pageY ) );
+				this._movePrev.copy( this._moveCurr );
+				break;
+
+			case 2:
+				this.state = _STATE.TOUCH_ZOOM_PAN;
+
+				for ( let i = 0; i < this._pointers.length; i ++ ) {
+
+					if ( this._pointers[ i ].pointerId !== event.pointerId ) {
+
+						const position = this._pointerPositions[ this._pointers[ i ].pointerId ];
+						this._moveCurr.copy( this._getMouseOnCircle( position.x, position.y ) );
+						this._movePrev.copy( this._moveCurr );
+						break;
+
+					}
+
+				}
+
+				break;
+
+		}
+
+		this.dispatchEvent( _endEvent );
+
+	}
+
+	const _inv = new Matrix4();
+	/** 世界系命中点 → local 顶点(位置 worldToLocal,法线用逆变换)。 */
+	function worldHitToLocalVertex(h, mesh) {
+	    const lp = mesh.worldToLocal(h.point.clone());
+	    _inv.copy(mesh.matrixWorld).invert();
+	    const ln = h.normal.clone().transformDirection(_inv).normalize();
+	    return {
+	        x: lp.x,
+	        y: lp.y,
+	        z: lp.z,
+	        nx: ln.x,
+	        ny: ln.y,
+	        nz: ln.z,
+	        faceIndex: h.faceIndex,
+	    };
+	}
+	const _nm = new Matrix3();
+	/** local 顶点 → world 位置 + world 法线(供渲染)。 */
+	function localVertexToWorld(v, mesh) {
+	    const p = new Vector3(v.x, v.y, v.z).applyMatrix4(mesh.matrixWorld);
+	    _nm.getNormalMatrix(mesh.matrixWorld);
+	    const n = new Vector3(v.nx, v.ny, v.nz).applyMatrix3(_nm).normalize();
+	    return { p, n };
+	}
+
+	const ray = new Raycaster();
+	const ndc = new Vector2();
+	/**
+	 * 把屏幕坐标(clientX/Y)投射到 mesh 表面,返回命中点、world-space 法线与 faceIndex。
+	 * 未命中返回 null。本地实现,不依赖 Copper3D 未导出的 raycast 内部函数。
+	 */
+	function raycastSurface(camera, container, mesh, clientX, clientY) {
+	    var _a;
+	    const rect = container.getBoundingClientRect();
+	    ndc.x = ((clientX - rect.left) / rect.width) * 2 - 1;
+	    ndc.y = -((clientY - rect.top) / rect.height) * 2 + 1;
+	    ray.setFromCamera(ndc, camera);
+	    const hits = ray.intersectObject(mesh, false);
+	    if (hits.length === 0)
+	        return null;
+	    const h = hits[0];
+	    const point = h.point.clone();
+	    const normal = new Vector3(0, 0, 1);
+	    if (h.face) {
+	        normal.copy(h.face.normal);
+	        const nm = new Matrix3().getNormalMatrix(mesh.matrixWorld);
+	        normal.applyMatrix3(nm).normalize();
+	    }
+	    return { point, normal, faceIndex: (_a = h.faceIndex) !== null && _a !== void 0 ? _a : -1 };
+	}
+
+	/**
+	 * 在 local 顶点处生成一个标记小球(fiducial)。local→world 后沿 world 法线略外移,
+	 * 避免一半埋进表面。radius 由调用方按模型 bbox 缩放传入。
+	 */
+	function makePointMarker(v, mesh, color, radius) {
+	    const geo = new SphereGeometry(radius, 16, 16);
+	    const mat = new MeshBasicMaterial({ color });
+	    const m = new Mesh(geo, mat);
+	    const { p, n } = localVertexToWorld(v, mesh);
+	    m.position.copy(p.addScaledVector(n, radius * 0.5));
+	    m.renderOrder = 999;
+	    return m;
+	}
+
+	/**
+	 * 模式 A(自由手绘)一笔的状态机。
+	 * pointermove 时不断 addSample;与上一采样点世界距离 < minGap 的样本丢弃,避免过密。
+	 * 顶点以 local 存(由 mesh 把世界命中点转 local)。
+	 */
+	class StrokeContour {
+	    constructor(minGap, mesh) {
+	        this.minGap = minGap;
+	        this.mesh = mesh;
+	        this.verts = [];
+	        this.last = new Vector3();
+	        this.has = false;
+	    }
+	    begin() {
+	        this.verts = [];
+	        this.has = false;
+	    }
+	    addSample(hit) {
+	        // gap 判定用世界距离(屏幕笔触在世界系采样)
+	        if (this.has && hit.point.distanceTo(this.last) < this.minGap)
+	            return;
+	        this.verts.push(worldHitToLocalVertex(hit, this.mesh));
+	        this.last.copy(hit.point);
+	        this.has = true;
+	    }
+	    get vertices() {
+	        return this.verts;
+	    }
+	    end() {
+	        return this.verts;
+	    }
+	}
+
+	const _box$1 = new Box3();
+	const _vector = new Vector3();
+
+	class LineSegmentsGeometry extends InstancedBufferGeometry {
+
+		constructor() {
+
+			super();
+
+			this.isLineSegmentsGeometry = true;
+
+			this.type = 'LineSegmentsGeometry';
+
+			const positions = [ - 1, 2, 0, 1, 2, 0, - 1, 1, 0, 1, 1, 0, - 1, 0, 0, 1, 0, 0, - 1, - 1, 0, 1, - 1, 0 ];
+			const uvs = [ - 1, 2, 1, 2, - 1, 1, 1, 1, - 1, - 1, 1, - 1, - 1, - 2, 1, - 2 ];
+			const index = [ 0, 2, 1, 2, 3, 1, 2, 4, 3, 4, 5, 3, 4, 6, 5, 6, 7, 5 ];
+
+			this.setIndex( index );
+			this.setAttribute( 'position', new Float32BufferAttribute( positions, 3 ) );
+			this.setAttribute( 'uv', new Float32BufferAttribute( uvs, 2 ) );
+
+		}
+
+		applyMatrix4( matrix ) {
+
+			const start = this.attributes.instanceStart;
+			const end = this.attributes.instanceEnd;
+
+			if ( start !== undefined ) {
+
+				start.applyMatrix4( matrix );
+
+				end.applyMatrix4( matrix );
+
+				start.needsUpdate = true;
+
+			}
+
+			if ( this.boundingBox !== null ) {
+
+				this.computeBoundingBox();
+
+			}
+
+			if ( this.boundingSphere !== null ) {
+
+				this.computeBoundingSphere();
+
+			}
+
+			return this;
+
+		}
+
+		setPositions( array ) {
+
+			let lineSegments;
+
+			if ( array instanceof Float32Array ) {
+
+				lineSegments = array;
+
+			} else if ( Array.isArray( array ) ) {
+
+				lineSegments = new Float32Array( array );
+
+			}
+
+			const instanceBuffer = new InstancedInterleavedBuffer( lineSegments, 6, 1 ); // xyz, xyz
+
+			this.setAttribute( 'instanceStart', new InterleavedBufferAttribute( instanceBuffer, 3, 0 ) ); // xyz
+			this.setAttribute( 'instanceEnd', new InterleavedBufferAttribute( instanceBuffer, 3, 3 ) ); // xyz
+
+			this.instanceCount = this.attributes.instanceStart.count;
+
+			//
+
+			this.computeBoundingBox();
+			this.computeBoundingSphere();
+
+			return this;
+
+		}
+
+		setColors( array ) {
+
+			let colors;
+
+			if ( array instanceof Float32Array ) {
+
+				colors = array;
+
+			} else if ( Array.isArray( array ) ) {
+
+				colors = new Float32Array( array );
+
+			}
+
+			const instanceColorBuffer = new InstancedInterleavedBuffer( colors, 6, 1 ); // rgb, rgb
+
+			this.setAttribute( 'instanceColorStart', new InterleavedBufferAttribute( instanceColorBuffer, 3, 0 ) ); // rgb
+			this.setAttribute( 'instanceColorEnd', new InterleavedBufferAttribute( instanceColorBuffer, 3, 3 ) ); // rgb
+
+			return this;
+
+		}
+
+		fromWireframeGeometry( geometry ) {
+
+			this.setPositions( geometry.attributes.position.array );
+
+			return this;
+
+		}
+
+		fromEdgesGeometry( geometry ) {
+
+			this.setPositions( geometry.attributes.position.array );
+
+			return this;
+
+		}
+
+		fromMesh( mesh ) {
+
+			this.fromWireframeGeometry( new WireframeGeometry( mesh.geometry ) );
+
+			// set colors, maybe
+
+			return this;
+
+		}
+
+		fromLineSegments( lineSegments ) {
+
+			const geometry = lineSegments.geometry;
+
+			this.setPositions( geometry.attributes.position.array ); // assumes non-indexed
+
+			// set colors, maybe
+
+			return this;
+
+		}
+
+		computeBoundingBox() {
+
+			if ( this.boundingBox === null ) {
+
+				this.boundingBox = new Box3();
+
+			}
+
+			const start = this.attributes.instanceStart;
+			const end = this.attributes.instanceEnd;
+
+			if ( start !== undefined && end !== undefined ) {
+
+				this.boundingBox.setFromBufferAttribute( start );
+
+				_box$1.setFromBufferAttribute( end );
+
+				this.boundingBox.union( _box$1 );
+
+			}
+
+		}
+
+		computeBoundingSphere() {
+
+			if ( this.boundingSphere === null ) {
+
+				this.boundingSphere = new Sphere();
+
+			}
+
+			if ( this.boundingBox === null ) {
+
+				this.computeBoundingBox();
+
+			}
+
+			const start = this.attributes.instanceStart;
+			const end = this.attributes.instanceEnd;
+
+			if ( start !== undefined && end !== undefined ) {
+
+				const center = this.boundingSphere.center;
+
+				this.boundingBox.getCenter( center );
+
+				let maxRadiusSq = 0;
+
+				for ( let i = 0, il = start.count; i < il; i ++ ) {
+
+					_vector.fromBufferAttribute( start, i );
+					maxRadiusSq = Math.max( maxRadiusSq, center.distanceToSquared( _vector ) );
+
+					_vector.fromBufferAttribute( end, i );
+					maxRadiusSq = Math.max( maxRadiusSq, center.distanceToSquared( _vector ) );
+
+				}
+
+				this.boundingSphere.radius = Math.sqrt( maxRadiusSq );
+
+				if ( isNaN( this.boundingSphere.radius ) ) {
+
+					console.error( 'THREE.LineSegmentsGeometry.computeBoundingSphere(): Computed radius is NaN. The instanced position data is likely to have NaN values.', this );
+
+				}
+
+			}
+
+		}
+
+		toJSON() {
+
+			// todo
+
+		}
+
+		applyMatrix( matrix ) {
+
+			console.warn( 'THREE.LineSegmentsGeometry: applyMatrix() has been renamed to applyMatrix4().' );
+
+			return this.applyMatrix4( matrix );
+
+		}
+
+	}
+
+	UniformsLib.line = {
+
+		worldUnits: { value: 1 },
+		linewidth: { value: 1 },
+		resolution: { value: new Vector2( 1, 1 ) },
+		dashOffset: { value: 0 },
+		dashScale: { value: 1 },
+		dashSize: { value: 1 },
+		gapSize: { value: 1 } // todo FIX - maybe change to totalSize
+
+	};
+
+	ShaderLib[ 'line' ] = {
+
+		uniforms: UniformsUtils.merge( [
+			UniformsLib.common,
+			UniformsLib.fog,
+			UniformsLib.line
+		] ),
+
+		vertexShader:
+		/* glsl */`
+		#include <common>
+		#include <color_pars_vertex>
+		#include <fog_pars_vertex>
+		#include <logdepthbuf_pars_vertex>
+		#include <clipping_planes_pars_vertex>
+
+		uniform float linewidth;
+		uniform vec2 resolution;
+
+		attribute vec3 instanceStart;
+		attribute vec3 instanceEnd;
+
+		attribute vec3 instanceColorStart;
+		attribute vec3 instanceColorEnd;
+
+		#ifdef WORLD_UNITS
+
+			varying vec4 worldPos;
+			varying vec3 worldStart;
+			varying vec3 worldEnd;
+
+			#ifdef USE_DASH
+
+				varying vec2 vUv;
+
+			#endif
+
+		#else
+
+			varying vec2 vUv;
+
+		#endif
+
+		#ifdef USE_DASH
+
+			uniform float dashScale;
+			attribute float instanceDistanceStart;
+			attribute float instanceDistanceEnd;
+			varying float vLineDistance;
+
+		#endif
+
+		void trimSegment( const in vec4 start, inout vec4 end ) {
+
+			// trim end segment so it terminates between the camera plane and the near plane
+
+			// conservative estimate of the near plane
+			float a = projectionMatrix[ 2 ][ 2 ]; // 3nd entry in 3th column
+			float b = projectionMatrix[ 3 ][ 2 ]; // 3nd entry in 4th column
+			float nearEstimate = - 0.5 * b / a;
+
+			float alpha = ( nearEstimate - start.z ) / ( end.z - start.z );
+
+			end.xyz = mix( start.xyz, end.xyz, alpha );
+
+		}
+
+		void main() {
+
+			#ifdef USE_COLOR
+
+				vColor.xyz = ( position.y < 0.5 ) ? instanceColorStart : instanceColorEnd;
+
+			#endif
+
+			#ifdef USE_DASH
+
+				vLineDistance = ( position.y < 0.5 ) ? dashScale * instanceDistanceStart : dashScale * instanceDistanceEnd;
+				vUv = uv;
+
+			#endif
+
+			float aspect = resolution.x / resolution.y;
+
+			// camera space
+			vec4 start = modelViewMatrix * vec4( instanceStart, 1.0 );
+			vec4 end = modelViewMatrix * vec4( instanceEnd, 1.0 );
+
+			#ifdef WORLD_UNITS
+
+				worldStart = start.xyz;
+				worldEnd = end.xyz;
+
+			#else
+
+				vUv = uv;
+
+			#endif
+
+			// special case for perspective projection, and segments that terminate either in, or behind, the camera plane
+			// clearly the gpu firmware has a way of addressing this issue when projecting into ndc space
+			// but we need to perform ndc-space calculations in the shader, so we must address this issue directly
+			// perhaps there is a more elegant solution -- WestLangley
+
+			bool perspective = ( projectionMatrix[ 2 ][ 3 ] == - 1.0 ); // 4th entry in the 3rd column
+
+			if ( perspective ) {
+
+				if ( start.z < 0.0 && end.z >= 0.0 ) {
+
+					trimSegment( start, end );
+
+				} else if ( end.z < 0.0 && start.z >= 0.0 ) {
+
+					trimSegment( end, start );
+
+				}
+
+			}
+
+			// clip space
+			vec4 clipStart = projectionMatrix * start;
+			vec4 clipEnd = projectionMatrix * end;
+
+			// ndc space
+			vec3 ndcStart = clipStart.xyz / clipStart.w;
+			vec3 ndcEnd = clipEnd.xyz / clipEnd.w;
+
+			// direction
+			vec2 dir = ndcEnd.xy - ndcStart.xy;
+
+			// account for clip-space aspect ratio
+			dir.x *= aspect;
+			dir = normalize( dir );
+
+			#ifdef WORLD_UNITS
+
+				vec3 worldDir = normalize( end.xyz - start.xyz );
+				vec3 tmpFwd = normalize( mix( start.xyz, end.xyz, 0.5 ) );
+				vec3 worldUp = normalize( cross( worldDir, tmpFwd ) );
+				vec3 worldFwd = cross( worldDir, worldUp );
+				worldPos = position.y < 0.5 ? start: end;
+
+				// height offset
+				float hw = linewidth * 0.5;
+				worldPos.xyz += position.x < 0.0 ? hw * worldUp : - hw * worldUp;
+
+				// don't extend the line if we're rendering dashes because we
+				// won't be rendering the endcaps
+				#ifndef USE_DASH
+
+					// cap extension
+					worldPos.xyz += position.y < 0.5 ? - hw * worldDir : hw * worldDir;
+
+					// add width to the box
+					worldPos.xyz += worldFwd * hw;
+
+					// endcaps
+					if ( position.y > 1.0 || position.y < 0.0 ) {
+
+						worldPos.xyz -= worldFwd * 2.0 * hw;
+
+					}
+
+				#endif
+
+				// project the worldpos
+				vec4 clip = projectionMatrix * worldPos;
+
+				// shift the depth of the projected points so the line
+				// segments overlap neatly
+				vec3 clipPose = ( position.y < 0.5 ) ? ndcStart : ndcEnd;
+				clip.z = clipPose.z * clip.w;
+
+			#else
+
+				vec2 offset = vec2( dir.y, - dir.x );
+				// undo aspect ratio adjustment
+				dir.x /= aspect;
+				offset.x /= aspect;
+
+				// sign flip
+				if ( position.x < 0.0 ) offset *= - 1.0;
+
+				// endcaps
+				if ( position.y < 0.0 ) {
+
+					offset += - dir;
+
+				} else if ( position.y > 1.0 ) {
+
+					offset += dir;
+
+				}
+
+				// adjust for linewidth
+				offset *= linewidth;
+
+				// adjust for clip-space to screen-space conversion // maybe resolution should be based on viewport ...
+				offset /= resolution.y;
+
+				// select end
+				vec4 clip = ( position.y < 0.5 ) ? clipStart : clipEnd;
+
+				// back to clip space
+				offset *= clip.w;
+
+				clip.xy += offset;
+
+			#endif
+
+			gl_Position = clip;
+
+			vec4 mvPosition = ( position.y < 0.5 ) ? start : end; // this is an approximation
+
+			#include <logdepthbuf_vertex>
+			#include <clipping_planes_vertex>
+			#include <fog_vertex>
+
+		}
+		`,
+
+		fragmentShader:
+		/* glsl */`
+		uniform vec3 diffuse;
+		uniform float opacity;
+		uniform float linewidth;
+
+		#ifdef USE_DASH
+
+			uniform float dashOffset;
+			uniform float dashSize;
+			uniform float gapSize;
+
+		#endif
+
+		varying float vLineDistance;
+
+		#ifdef WORLD_UNITS
+
+			varying vec4 worldPos;
+			varying vec3 worldStart;
+			varying vec3 worldEnd;
+
+			#ifdef USE_DASH
+
+				varying vec2 vUv;
+
+			#endif
+
+		#else
+
+			varying vec2 vUv;
+
+		#endif
+
+		#include <common>
+		#include <color_pars_fragment>
+		#include <fog_pars_fragment>
+		#include <logdepthbuf_pars_fragment>
+		#include <clipping_planes_pars_fragment>
+
+		vec2 closestLineToLine(vec3 p1, vec3 p2, vec3 p3, vec3 p4) {
+
+			float mua;
+			float mub;
+
+			vec3 p13 = p1 - p3;
+			vec3 p43 = p4 - p3;
+
+			vec3 p21 = p2 - p1;
+
+			float d1343 = dot( p13, p43 );
+			float d4321 = dot( p43, p21 );
+			float d1321 = dot( p13, p21 );
+			float d4343 = dot( p43, p43 );
+			float d2121 = dot( p21, p21 );
+
+			float denom = d2121 * d4343 - d4321 * d4321;
+
+			float numer = d1343 * d4321 - d1321 * d4343;
+
+			mua = numer / denom;
+			mua = clamp( mua, 0.0, 1.0 );
+			mub = ( d1343 + d4321 * ( mua ) ) / d4343;
+			mub = clamp( mub, 0.0, 1.0 );
+
+			return vec2( mua, mub );
+
+		}
+
+		void main() {
+
+			#include <clipping_planes_fragment>
+
+			#ifdef USE_DASH
+
+				if ( vUv.y < - 1.0 || vUv.y > 1.0 ) discard; // discard endcaps
+
+				if ( mod( vLineDistance + dashOffset, dashSize + gapSize ) > dashSize ) discard; // todo - FIX
+
+			#endif
+
+			float alpha = opacity;
+
+			#ifdef WORLD_UNITS
+
+				// Find the closest points on the view ray and the line segment
+				vec3 rayEnd = normalize( worldPos.xyz ) * 1e5;
+				vec3 lineDir = worldEnd - worldStart;
+				vec2 params = closestLineToLine( worldStart, worldEnd, vec3( 0.0, 0.0, 0.0 ), rayEnd );
+
+				vec3 p1 = worldStart + lineDir * params.x;
+				vec3 p2 = rayEnd * params.y;
+				vec3 delta = p1 - p2;
+				float len = length( delta );
+				float norm = len / linewidth;
+
+				#ifndef USE_DASH
+
+					#ifdef USE_ALPHA_TO_COVERAGE
+
+						float dnorm = fwidth( norm );
+						alpha = 1.0 - smoothstep( 0.5 - dnorm, 0.5 + dnorm, norm );
+
+					#else
+
+						if ( norm > 0.5 ) {
+
+							discard;
+
+						}
+
+					#endif
+
+				#endif
+
+			#else
+
+				#ifdef USE_ALPHA_TO_COVERAGE
+
+					// artifacts appear on some hardware if a derivative is taken within a conditional
+					float a = vUv.x;
+					float b = ( vUv.y > 0.0 ) ? vUv.y - 1.0 : vUv.y + 1.0;
+					float len2 = a * a + b * b;
+					float dlen = fwidth( len2 );
+
+					if ( abs( vUv.y ) > 1.0 ) {
+
+						alpha = 1.0 - smoothstep( 1.0 - dlen, 1.0 + dlen, len2 );
+
+					}
+
+				#else
+
+					if ( abs( vUv.y ) > 1.0 ) {
+
+						float a = vUv.x;
+						float b = ( vUv.y > 0.0 ) ? vUv.y - 1.0 : vUv.y + 1.0;
+						float len2 = a * a + b * b;
+
+						if ( len2 > 1.0 ) discard;
+
+					}
+
+				#endif
+
+			#endif
+
+			vec4 diffuseColor = vec4( diffuse, alpha );
+
+			#include <logdepthbuf_fragment>
+			#include <color_fragment>
+
+			gl_FragColor = vec4( diffuseColor.rgb, alpha );
+
+			#include <tonemapping_fragment>
+			#include <colorspace_fragment>
+			#include <fog_fragment>
+			#include <premultiplied_alpha_fragment>
+
+		}
+		`
+	};
+
+	class LineMaterial extends ShaderMaterial {
+
+
+		static get type() {
+
+			return 'LineMaterial';
+
+		}
+
+		constructor( parameters ) {
+
+			super( {
+
+				uniforms: UniformsUtils.clone( ShaderLib[ 'line' ].uniforms ),
+
+				vertexShader: ShaderLib[ 'line' ].vertexShader,
+				fragmentShader: ShaderLib[ 'line' ].fragmentShader,
+
+				clipping: true // required for clipping support
+
+			} );
+
+			this.isLineMaterial = true;
+
+			this.setValues( parameters );
+
+		}
+
+		get color() {
+
+			return this.uniforms.diffuse.value;
+
+		}
+
+		set color( value ) {
+
+			this.uniforms.diffuse.value = value;
+
+		}
+
+		get worldUnits() {
+
+			return 'WORLD_UNITS' in this.defines;
+
+		}
+
+		set worldUnits( value ) {
+
+			if ( value === true ) {
+
+				this.defines.WORLD_UNITS = '';
+
+			} else {
+
+				delete this.defines.WORLD_UNITS;
+
+			}
+
+		}
+
+		get linewidth() {
+
+			return this.uniforms.linewidth.value;
+
+		}
+
+		set linewidth( value ) {
+
+			if ( ! this.uniforms.linewidth ) return;
+			this.uniforms.linewidth.value = value;
+
+		}
+
+		get dashed() {
+
+			return 'USE_DASH' in this.defines;
+
+		}
+
+		set dashed( value ) {
+
+			if ( ( value === true ) !== this.dashed ) {
+
+				this.needsUpdate = true;
+
+			}
+
+			if ( value === true ) {
+
+				this.defines.USE_DASH = '';
+
+			} else {
+
+				delete this.defines.USE_DASH;
+
+			}
+
+		}
+
+		get dashScale() {
+
+			return this.uniforms.dashScale.value;
+
+		}
+
+		set dashScale( value ) {
+
+			this.uniforms.dashScale.value = value;
+
+		}
+
+		get dashSize() {
+
+			return this.uniforms.dashSize.value;
+
+		}
+
+		set dashSize( value ) {
+
+			this.uniforms.dashSize.value = value;
+
+		}
+
+		get dashOffset() {
+
+			return this.uniforms.dashOffset.value;
+
+		}
+
+		set dashOffset( value ) {
+
+			this.uniforms.dashOffset.value = value;
+
+		}
+
+		get gapSize() {
+
+			return this.uniforms.gapSize.value;
+
+		}
+
+		set gapSize( value ) {
+
+			this.uniforms.gapSize.value = value;
+
+		}
+
+		get opacity() {
+
+			return this.uniforms.opacity.value;
+
+		}
+
+		set opacity( value ) {
+
+			if ( ! this.uniforms ) return;
+			this.uniforms.opacity.value = value;
+
+		}
+
+		get resolution() {
+
+			return this.uniforms.resolution.value;
+
+		}
+
+		set resolution( value ) {
+
+			this.uniforms.resolution.value.copy( value );
+
+		}
+
+		get alphaToCoverage() {
+
+			return 'USE_ALPHA_TO_COVERAGE' in this.defines;
+
+		}
+
+		set alphaToCoverage( value ) {
+
+			if ( ! this.defines ) return;
+
+			if ( ( value === true ) !== this.alphaToCoverage ) {
+
+				this.needsUpdate = true;
+
+			}
+
+			if ( value === true ) {
+
+				this.defines.USE_ALPHA_TO_COVERAGE = '';
+
+			} else {
+
+				delete this.defines.USE_ALPHA_TO_COVERAGE;
+
+			}
+
+		}
+
+	}
+
+	const _viewport = new Vector4();
+
+	const _start = new Vector3();
+	const _end = new Vector3();
+
+	const _start4 = new Vector4();
+	const _end4 = new Vector4();
+
+	const _ssOrigin = new Vector4();
+	const _ssOrigin3 = new Vector3();
+	const _mvMatrix = new Matrix4();
+	const _line = new Line3();
+	const _closestPoint = new Vector3();
+
+	const _box = new Box3();
+	const _sphere = new Sphere();
+	const _clipToWorldVector = new Vector4();
+
+	let _ray, _lineWidth;
+
+	// Returns the margin required to expand by in world space given the distance from the camera,
+	// line width, resolution, and camera projection
+	function getWorldSpaceHalfWidth( camera, distance, resolution ) {
+
+		// transform into clip space, adjust the x and y values by the pixel width offset, then
+		// transform back into world space to get world offset. Note clip space is [-1, 1] so full
+		// width does not need to be halved.
+		_clipToWorldVector.set( 0, 0, - distance, 1.0 ).applyMatrix4( camera.projectionMatrix );
+		_clipToWorldVector.multiplyScalar( 1.0 / _clipToWorldVector.w );
+		_clipToWorldVector.x = _lineWidth / resolution.width;
+		_clipToWorldVector.y = _lineWidth / resolution.height;
+		_clipToWorldVector.applyMatrix4( camera.projectionMatrixInverse );
+		_clipToWorldVector.multiplyScalar( 1.0 / _clipToWorldVector.w );
+
+		return Math.abs( Math.max( _clipToWorldVector.x, _clipToWorldVector.y ) );
+
+	}
+
+	function raycastWorldUnits( lineSegments, intersects ) {
+
+		const matrixWorld = lineSegments.matrixWorld;
+		const geometry = lineSegments.geometry;
+		const instanceStart = geometry.attributes.instanceStart;
+		const instanceEnd = geometry.attributes.instanceEnd;
+		const segmentCount = Math.min( geometry.instanceCount, instanceStart.count );
+
+		for ( let i = 0, l = segmentCount; i < l; i ++ ) {
+
+			_line.start.fromBufferAttribute( instanceStart, i );
+			_line.end.fromBufferAttribute( instanceEnd, i );
+
+			_line.applyMatrix4( matrixWorld );
+
+			const pointOnLine = new Vector3();
+			const point = new Vector3();
+
+			_ray.distanceSqToSegment( _line.start, _line.end, point, pointOnLine );
+			const isInside = point.distanceTo( pointOnLine ) < _lineWidth * 0.5;
+
+			if ( isInside ) {
+
+				intersects.push( {
+					point,
+					pointOnLine,
+					distance: _ray.origin.distanceTo( point ),
+					object: lineSegments,
+					face: null,
+					faceIndex: i,
+					uv: null,
+					uv1: null,
+				} );
+
+			}
+
+		}
+
+	}
+
+	function raycastScreenSpace( lineSegments, camera, intersects ) {
+
+		const projectionMatrix = camera.projectionMatrix;
+		const material = lineSegments.material;
+		const resolution = material.resolution;
+		const matrixWorld = lineSegments.matrixWorld;
+
+		const geometry = lineSegments.geometry;
+		const instanceStart = geometry.attributes.instanceStart;
+		const instanceEnd = geometry.attributes.instanceEnd;
+		const segmentCount = Math.min( geometry.instanceCount, instanceStart.count );
+
+		const near = - camera.near;
+
+		//
+
+		// pick a point 1 unit out along the ray to avoid the ray origin
+		// sitting at the camera origin which will cause "w" to be 0 when
+		// applying the projection matrix.
+		_ray.at( 1, _ssOrigin );
+
+		// ndc space [ - 1.0, 1.0 ]
+		_ssOrigin.w = 1;
+		_ssOrigin.applyMatrix4( camera.matrixWorldInverse );
+		_ssOrigin.applyMatrix4( projectionMatrix );
+		_ssOrigin.multiplyScalar( 1 / _ssOrigin.w );
+
+		// screen space
+		_ssOrigin.x *= resolution.x / 2;
+		_ssOrigin.y *= resolution.y / 2;
+		_ssOrigin.z = 0;
+
+		_ssOrigin3.copy( _ssOrigin );
+
+		_mvMatrix.multiplyMatrices( camera.matrixWorldInverse, matrixWorld );
+
+		for ( let i = 0, l = segmentCount; i < l; i ++ ) {
+
+			_start4.fromBufferAttribute( instanceStart, i );
+			_end4.fromBufferAttribute( instanceEnd, i );
+
+			_start4.w = 1;
+			_end4.w = 1;
+
+			// camera space
+			_start4.applyMatrix4( _mvMatrix );
+			_end4.applyMatrix4( _mvMatrix );
+
+			// skip the segment if it's entirely behind the camera
+			const isBehindCameraNear = _start4.z > near && _end4.z > near;
+			if ( isBehindCameraNear ) {
+
+				continue;
+
+			}
+
+			// trim the segment if it extends behind camera near
+			if ( _start4.z > near ) {
+
+				const deltaDist = _start4.z - _end4.z;
+				const t = ( _start4.z - near ) / deltaDist;
+				_start4.lerp( _end4, t );
+
+			} else if ( _end4.z > near ) {
+
+				const deltaDist = _end4.z - _start4.z;
+				const t = ( _end4.z - near ) / deltaDist;
+				_end4.lerp( _start4, t );
+
+			}
+
+			// clip space
+			_start4.applyMatrix4( projectionMatrix );
+			_end4.applyMatrix4( projectionMatrix );
+
+			// ndc space [ - 1.0, 1.0 ]
+			_start4.multiplyScalar( 1 / _start4.w );
+			_end4.multiplyScalar( 1 / _end4.w );
+
+			// screen space
+			_start4.x *= resolution.x / 2;
+			_start4.y *= resolution.y / 2;
+
+			_end4.x *= resolution.x / 2;
+			_end4.y *= resolution.y / 2;
+
+			// create 2d segment
+			_line.start.copy( _start4 );
+			_line.start.z = 0;
+
+			_line.end.copy( _end4 );
+			_line.end.z = 0;
+
+			// get closest point on ray to segment
+			const param = _line.closestPointToPointParameter( _ssOrigin3, true );
+			_line.at( param, _closestPoint );
+
+			// check if the intersection point is within clip space
+			const zPos = MathUtils.lerp( _start4.z, _end4.z, param );
+			const isInClipSpace = zPos >= - 1 && zPos <= 1;
+
+			const isInside = _ssOrigin3.distanceTo( _closestPoint ) < _lineWidth * 0.5;
+
+			if ( isInClipSpace && isInside ) {
+
+				_line.start.fromBufferAttribute( instanceStart, i );
+				_line.end.fromBufferAttribute( instanceEnd, i );
+
+				_line.start.applyMatrix4( matrixWorld );
+				_line.end.applyMatrix4( matrixWorld );
+
+				const pointOnLine = new Vector3();
+				const point = new Vector3();
+
+				_ray.distanceSqToSegment( _line.start, _line.end, point, pointOnLine );
+
+				intersects.push( {
+					point: point,
+					pointOnLine: pointOnLine,
+					distance: _ray.origin.distanceTo( point ),
+					object: lineSegments,
+					face: null,
+					faceIndex: i,
+					uv: null,
+					uv1: null,
+				} );
+
+			}
+
+		}
+
+	}
+
+	class LineSegments2 extends Mesh {
+
+		constructor( geometry = new LineSegmentsGeometry(), material = new LineMaterial( { color: Math.random() * 0xffffff } ) ) {
+
+			super( geometry, material );
+
+			this.isLineSegments2 = true;
+
+			this.type = 'LineSegments2';
+
+		}
+
+		// for backwards-compatibility, but could be a method of LineSegmentsGeometry...
+
+		computeLineDistances() {
+
+			const geometry = this.geometry;
+
+			const instanceStart = geometry.attributes.instanceStart;
+			const instanceEnd = geometry.attributes.instanceEnd;
+			const lineDistances = new Float32Array( 2 * instanceStart.count );
+
+			for ( let i = 0, j = 0, l = instanceStart.count; i < l; i ++, j += 2 ) {
+
+				_start.fromBufferAttribute( instanceStart, i );
+				_end.fromBufferAttribute( instanceEnd, i );
+
+				lineDistances[ j ] = ( j === 0 ) ? 0 : lineDistances[ j - 1 ];
+				lineDistances[ j + 1 ] = lineDistances[ j ] + _start.distanceTo( _end );
+
+			}
+
+			const instanceDistanceBuffer = new InstancedInterleavedBuffer( lineDistances, 2, 1 ); // d0, d1
+
+			geometry.setAttribute( 'instanceDistanceStart', new InterleavedBufferAttribute( instanceDistanceBuffer, 1, 0 ) ); // d0
+			geometry.setAttribute( 'instanceDistanceEnd', new InterleavedBufferAttribute( instanceDistanceBuffer, 1, 1 ) ); // d1
+
+			return this;
+
+		}
+
+		raycast( raycaster, intersects ) {
+
+			const worldUnits = this.material.worldUnits;
+			const camera = raycaster.camera;
+
+			if ( camera === null && ! worldUnits ) {
+
+				console.error( 'LineSegments2: "Raycaster.camera" needs to be set in order to raycast against LineSegments2 while worldUnits is set to false.' );
+
+			}
+
+			const threshold = ( raycaster.params.Line2 !== undefined ) ? raycaster.params.Line2.threshold || 0 : 0;
+
+			_ray = raycaster.ray;
+
+			const matrixWorld = this.matrixWorld;
+			const geometry = this.geometry;
+			const material = this.material;
+
+			_lineWidth = material.linewidth + threshold;
+
+			// check if we intersect the sphere bounds
+			if ( geometry.boundingSphere === null ) {
+
+				geometry.computeBoundingSphere();
+
+			}
+
+			_sphere.copy( geometry.boundingSphere ).applyMatrix4( matrixWorld );
+
+			// increase the sphere bounds by the worst case line screen space width
+			let sphereMargin;
+			if ( worldUnits ) {
+
+				sphereMargin = _lineWidth * 0.5;
+
+			} else {
+
+				const distanceToSphere = Math.max( camera.near, _sphere.distanceToPoint( _ray.origin ) );
+				sphereMargin = getWorldSpaceHalfWidth( camera, distanceToSphere, material.resolution );
+
+			}
+
+			_sphere.radius += sphereMargin;
+
+			if ( _ray.intersectsSphere( _sphere ) === false ) {
+
+				return;
+
+			}
+
+			// check if we intersect the box bounds
+			if ( geometry.boundingBox === null ) {
+
+				geometry.computeBoundingBox();
+
+			}
 
-			this._zoomStart.copy( this._getMouseOnScreen( event.pageX, event.pageY ) );
-			this._zoomEnd.copy( this._zoomStart );
+			_box.copy( geometry.boundingBox ).applyMatrix4( matrixWorld );
 
-		} else if ( state === _STATE.PAN && ! this.noPan ) {
+			// increase the box bounds by the worst case line width
+			let boxMargin;
+			if ( worldUnits ) {
 
-			this._panStart.copy( this._getMouseOnScreen( event.pageX, event.pageY ) );
-			this._panEnd.copy( this._panStart );
+				boxMargin = _lineWidth * 0.5;
 
-		}
+			} else {
 
-		this.dispatchEvent( _startEvent );
+				const distanceToBox = Math.max( camera.near, _box.distanceToPoint( _ray.origin ) );
+				boxMargin = getWorldSpaceHalfWidth( camera, distanceToBox, material.resolution );
 
-	}
+			}
 
-	function onMouseMove( event ) {
+			_box.expandByScalar( boxMargin );
 
-		const state = ( this.keyState !== _STATE.NONE ) ? this.keyState : this.state;
+			if ( _ray.intersectsBox( _box ) === false ) {
 
-		if ( state === _STATE.ROTATE && ! this.noRotate ) {
+				return;
 
-			this._movePrev.copy( this._moveCurr );
-			this._moveCurr.copy( this._getMouseOnCircle( event.pageX, event.pageY ) );
+			}
 
-		} else if ( state === _STATE.ZOOM && ! this.noZoom ) {
+			if ( worldUnits ) {
 
-			this._zoomEnd.copy( this._getMouseOnScreen( event.pageX, event.pageY ) );
+				raycastWorldUnits( this, intersects );
 
-		} else if ( state === _STATE.PAN && ! this.noPan ) {
+			} else {
 
-			this._panEnd.copy( this._getMouseOnScreen( event.pageX, event.pageY ) );
+				raycastScreenSpace( this, camera, intersects );
 
-		}
+			}
 
-	}
+		}
 
-	function onMouseUp() {
+		onBeforeRender( renderer ) {
 
-		this.state = _STATE.NONE;
+			const uniforms = this.material.uniforms;
 
-		this.dispatchEvent( _endEvent );
+			if ( uniforms && uniforms.resolution ) {
 
-	}
+				renderer.getViewport( _viewport );
+				this.material.uniforms.resolution.value.set( _viewport.z, _viewport.w );
 
-	function onMouseWheel( event ) {
+			}
 
-		if ( this.enabled === false ) return;
+		}
 
-		if ( this.noZoom === true ) return;
+	}
 
-		event.preventDefault();
+	class LineGeometry extends LineSegmentsGeometry {
 
-		switch ( event.deltaMode ) {
+		constructor() {
 
-			case 2:
-				// Zoom in pages
-				this._zoomStart.y -= event.deltaY * 0.025;
-				break;
+			super();
 
-			case 1:
-				// Zoom in lines
-				this._zoomStart.y -= event.deltaY * 0.01;
-				break;
+			this.isLineGeometry = true;
 
-			default:
-				// undefined, 0, assume pixels
-				this._zoomStart.y -= event.deltaY * 0.00025;
-				break;
+			this.type = 'LineGeometry';
 
 		}
 
-		this.dispatchEvent( _startEvent );
-		this.dispatchEvent( _endEvent );
+		setPositions( array ) {
 
-	}
+			// converts [ x1, y1, z1,  x2, y2, z2, ... ] to pairs format
 
-	function onContextMenu( event ) {
+			const length = array.length - 3;
+			const points = new Float32Array( 2 * length );
 
-		if ( this.enabled === false ) return;
+			for ( let i = 0; i < length; i += 3 ) {
 
-		event.preventDefault();
+				points[ 2 * i ] = array[ i ];
+				points[ 2 * i + 1 ] = array[ i + 1 ];
+				points[ 2 * i + 2 ] = array[ i + 2 ];
 
-	}
+				points[ 2 * i + 3 ] = array[ i + 3 ];
+				points[ 2 * i + 4 ] = array[ i + 4 ];
+				points[ 2 * i + 5 ] = array[ i + 5 ];
 
-	function onTouchStart( event ) {
+			}
 
-		this._trackPointer( event );
+			super.setPositions( points );
 
-		switch ( this._pointers.length ) {
+			return this;
 
-			case 1:
-				this.state = _STATE.TOUCH_ROTATE;
-				this._moveCurr.copy( this._getMouseOnCircle( this._pointers[ 0 ].pageX, this._pointers[ 0 ].pageY ) );
-				this._movePrev.copy( this._moveCurr );
-				break;
+		}
 
-			default: // 2 or more
-				this.state = _STATE.TOUCH_ZOOM_PAN;
-				const dx = this._pointers[ 0 ].pageX - this._pointers[ 1 ].pageX;
-				const dy = this._pointers[ 0 ].pageY - this._pointers[ 1 ].pageY;
-				this._touchZoomDistanceEnd = this._touchZoomDistanceStart = Math.sqrt( dx * dx + dy * dy );
+		setColors( array ) {
 
-				const x = ( this._pointers[ 0 ].pageX + this._pointers[ 1 ].pageX ) / 2;
-				const y = ( this._pointers[ 0 ].pageY + this._pointers[ 1 ].pageY ) / 2;
-				this._panStart.copy( this._getMouseOnScreen( x, y ) );
-				this._panEnd.copy( this._panStart );
-				break;
+			// converts [ r1, g1, b1,  r2, g2, b2, ... ] to pairs format
 
-		}
+			const length = array.length - 3;
+			const colors = new Float32Array( 2 * length );
 
-		this.dispatchEvent( _startEvent );
+			for ( let i = 0; i < length; i += 3 ) {
 
-	}
+				colors[ 2 * i ] = array[ i ];
+				colors[ 2 * i + 1 ] = array[ i + 1 ];
+				colors[ 2 * i + 2 ] = array[ i + 2 ];
 
-	function onTouchMove( event ) {
+				colors[ 2 * i + 3 ] = array[ i + 3 ];
+				colors[ 2 * i + 4 ] = array[ i + 4 ];
+				colors[ 2 * i + 5 ] = array[ i + 5 ];
 
-		this._trackPointer( event );
+			}
 
-		switch ( this._pointers.length ) {
+			super.setColors( colors );
 
-			case 1:
-				this._movePrev.copy( this._moveCurr );
-				this._moveCurr.copy( this._getMouseOnCircle( event.pageX, event.pageY ) );
-				break;
+			return this;
 
-			default: // 2 or more
+		}
 
-				const position = this._getSecondPointerPosition( event );
+		fromLine( line ) {
 
-				const dx = event.pageX - position.x;
-				const dy = event.pageY - position.y;
-				this._touchZoomDistanceEnd = Math.sqrt( dx * dx + dy * dy );
+			const geometry = line.geometry;
 
-				const x = ( event.pageX + position.x ) / 2;
-				const y = ( event.pageY + position.y ) / 2;
-				this._panEnd.copy( this._getMouseOnScreen( x, y ) );
-				break;
+			this.setPositions( geometry.attributes.position.array ); // assumes non-indexed
 
-		}
+			// set colors, maybe
 
-	}
+			return this;
 
-	function onTouchEnd( event ) {
+		}
 
-		switch ( this._pointers.length ) {
+	}
 
-			case 0:
-				this.state = _STATE.NONE;
-				break;
+	class Line2 extends LineSegments2 {
 
-			case 1:
-				this.state = _STATE.TOUCH_ROTATE;
-				this._moveCurr.copy( this._getMouseOnCircle( event.pageX, event.pageY ) );
-				this._movePrev.copy( this._moveCurr );
-				break;
+		constructor( geometry = new LineGeometry(), material = new LineMaterial( { color: Math.random() * 0xffffff } ) ) {
 
-			case 2:
-				this.state = _STATE.TOUCH_ZOOM_PAN;
+			super( geometry, material );
 
-				for ( let i = 0; i < this._pointers.length; i ++ ) {
+			this.isLine2 = true;
 
-					if ( this._pointers[ i ].pointerId !== event.pointerId ) {
+			this.type = 'Line2';
 
-						const position = this._pointerPositions[ this._pointers[ i ].pointerId ];
-						this._moveCurr.copy( this._getMouseOnCircle( position.x, position.y ) );
-						this._movePrev.copy( this._moveCurr );
-						break;
+		}
 
-					}
+	}
 
-				}
+	/**
+	 * 把标注顶点(local)序列展平成 Line2 需要的 world [x,y,z, ...]。
+	 * 每个点 local→world,再沿 world 法线外移 epsilon,避免与模型表面 z-fighting。
+	 * closed 时把首点追加到末尾形成环。
+	 */
+	function flatten(verts, closed, epsilon, mesh) {
+	    const pts = [];
+	    const push = (v) => {
+	        const { p, n } = localVertexToWorld(v, mesh);
+	        pts.push(p.x + n.x * epsilon, p.y + n.y * epsilon, p.z + n.z * epsilon);
+	    };
+	    verts.forEach(push);
+	    if (closed && verts.length > 1)
+	        push(verts[0]);
+	    return pts;
+	}
+	function makeContourLine(verts, color, closed, container, epsilon, mesh) {
+	    const geo = new LineGeometry();
+	    const pos = flatten(verts, closed, epsilon, mesh);
+	    // Line2 至少需要 2 个点;不足时给一个退化占位,后续 update 会补上。
+	    geo.setPositions(pos.length >= 6 ? pos : [0, 0, 0, 0, 0, 0]);
+	    const mat = new LineMaterial({
+	        color: new Color$1(color).getHex(),
+	        linewidth: 3, // 像素宽(需 resolution 配合)
+	    });
+	    mat.resolution.set(container.clientWidth, container.clientHeight);
+	    const line = new Line2(geo, mat);
+	    line.computeLineDistances();
+	    line.renderOrder = 998;
+	    // 关键:Line2 的包围球停留在初始点,拖拽生长后真实几何会被错误剔除。
+	    // 关闭视锥剔除,保证线始终渲染。
+	    line.frustumCulled = false;
+	    return line;
+	}
+	function updateContourLine(line, verts, closed, epsilon, mesh) {
+	    const pos = flatten(verts, closed, epsilon, mesh);
+	    if (pos.length < 6)
+	        return; // Line2 需要 >=2 点
+	    // 关键:Line2 在原 geometry 上 setPositions 扩容后只渲染首段(已知坑)。
+	    // 改为每次重建一个新 LineGeometry 并替换,保证实例数正确、全段渲染。
+	    const geo = new LineGeometry();
+	    geo.setPositions(pos);
+	    const old = line.geometry;
+	    line.geometry = geo;
+	    old.dispose();
+	    line.computeLineDistances();
+	}
+	/** 改变已有 contour 线的颜色。 */
+	function setContourColor(line, color) {
+	    line.material.color.set(color);
+	}
 
-				break;
+	/**
+	 * 从 BufferGeometry 的索引构建顶点邻接图,用于模式 B(测地线)的最短路径。
+	 * 顶点坐标按 local 存;传入的查询点需先转为 local(mesh.worldToLocal)。
+	 *
+	 * 说明:几何须为已索引(indexed)。modelLoader 用 mergeVertices 焊接重复顶点,
+	 * 保证同一表面位置共享顶点,邻接图才连通。
+	 *
+	 * 性能:O(V²) Dijkstra + O(V) 最近顶点查找。对几万顶点单次点击可接受;
+	 * 若过大可后续换二叉堆 + 空间网格加速(留作升级)。
+	 */
+	class MeshGraph {
+	    constructor(geometry) {
+	        this.adj = [];
+	        const pos = geometry.getAttribute("position");
+	        this.positions = pos.array;
+	        const nrm = geometry.getAttribute("normal");
+	        this.normals = nrm ? nrm.array : null;
+	        this.vertexCount = pos.count;
+	        for (let i = 0; i < this.vertexCount; i++)
+	            this.adj.push(new Set());
+	        const addEdge = (a, b) => {
+	            this.adj[a].add(b);
+	            this.adj[b].add(a);
+	        };
+	        const index = geometry.getIndex();
+	        if (index) {
+	            for (let i = 0; i < index.count; i += 3) {
+	                const a = index.getX(i);
+	                const b = index.getX(i + 1);
+	                const c = index.getX(i + 2);
+	                addEdge(a, b);
+	                addEdge(b, c);
+	                addEdge(c, a);
+	            }
+	        }
+	        else {
+	            // 非索引兜底(连通性差,仅避免崩溃)。
+	            for (let i = 0; i + 2 < this.vertexCount; i += 3) {
+	                addEdge(i, i + 1);
+	                addEdge(i + 1, i + 2);
+	                addEdge(i + 2, i);
+	            }
+	        }
+	    }
+	    px(i) {
+	        return this.positions[i * 3];
+	    }
+	    py(i) {
+	        return this.positions[i * 3 + 1];
+	    }
+	    pz(i) {
+	        return this.positions[i * 3 + 2];
+	    }
+	    /** 最近顶点(传入 local 坐标)。 */
+	    nearestVertex(localPoint) {
+	        let best = -1;
+	        let bestD = Infinity;
+	        for (let i = 0; i < this.vertexCount; i++) {
+	            const dx = this.px(i) - localPoint.x;
+	            const dy = this.py(i) - localPoint.y;
+	            const dz = this.pz(i) - localPoint.z;
+	            const d = dx * dx + dy * dy + dz * dz;
+	            if (d < bestD) {
+	                bestD = d;
+	                best = i;
+	            }
+	        }
+	        return best;
+	    }
+	    /**
+	     * 两顶点间最短路径(含端点的顶点索引序列)。二叉堆 Dijkstra,O(E log V)。
+	     * 不连通时返回 [start,end] 兜底。
+	     */
+	    shortestPath(startV, endV) {
+	        if (startV === endV)
+	            return [startV];
+	        const dist = new Float64Array(this.vertexCount).fill(Infinity);
+	        const prev = new Int32Array(this.vertexCount).fill(-1);
+	        const done = new Uint8Array(this.vertexCount);
+	        dist[startV] = 0;
+	        const heap = new MinHeap();
+	        heap.push(startV, 0);
+	        while (heap.size > 0) {
+	            const u = heap.pop();
+	            if (done[u])
+	                continue;
+	            done[u] = 1;
+	            if (u === endV)
+	                break;
+	            const ud = dist[u];
+	            const ux = this.px(u);
+	            const uy = this.py(u);
+	            const uz = this.pz(u);
+	            for (const w of this.adj[u]) {
+	                if (done[w])
+	                    continue;
+	                const dx = this.px(w) - ux;
+	                const dy = this.py(w) - uy;
+	                const dz = this.pz(w) - uz;
+	                const nd = ud + Math.sqrt(dx * dx + dy * dy + dz * dz);
+	                if (nd < dist[w]) {
+	                    dist[w] = nd;
+	                    prev[w] = u;
+	                    heap.push(w, nd);
+	                }
+	            }
+	        }
+	        if (prev[endV] === -1 && startV !== endV)
+	            return [startV, endV];
+	        const path = [];
+	        for (let c = endV; c !== -1; c = prev[c]) {
+	            path.push(c);
+	            if (c === startV)
+	                break;
+	        }
+	        return path.reverse();
+	    }
+	    vertexWorld(i, matrixWorld) {
+	        return new Vector3(this.px(i), this.py(i), this.pz(i)).applyMatrix4(matrixWorld);
+	    }
+	    vertexNormalWorld(i, mesh) {
+	        const n = new Vector3(0, 0, 1);
+	        if (this.normals) {
+	            n.set(this.normals[i * 3], this.normals[i * 3 + 1], this.normals[i * 3 + 2]);
+	        }
+	        const nm = new Matrix3().getNormalMatrix(mesh.matrixWorld);
+	        return n.applyMatrix3(nm).normalize();
+	    }
+	    /** 顶点的 local 坐标 + local 法线(图几何即 local 空间)。 */
+	    vertexLocal(i) {
+	        return {
+	            x: this.px(i),
+	            y: this.py(i),
+	            z: this.pz(i),
+	            nx: this.normals ? this.normals[i * 3] : 0,
+	            ny: this.normals ? this.normals[i * 3 + 1] : 0,
+	            nz: this.normals ? this.normals[i * 3 + 2] : 1,
+	            faceIndex: -1,
+	        };
+	    }
+	}
+	/** 极简二叉最小堆(按 priority 排序,存顶点索引)。用于 Dijkstra。 */
+	class MinHeap {
+	    constructor() {
+	        this.ids = [];
+	        this.prio = [];
+	    }
+	    get size() {
+	        return this.ids.length;
+	    }
+	    push(id, priority) {
+	        this.ids.push(id);
+	        this.prio.push(priority);
+	        let i = this.ids.length - 1;
+	        while (i > 0) {
+	            const parent = (i - 1) >> 1;
+	            if (this.prio[parent] <= this.prio[i])
+	                break;
+	            this.swap(i, parent);
+	            i = parent;
+	        }
+	    }
+	    pop() {
+	        const topId = this.ids[0];
+	        const lastId = this.ids.pop();
+	        const lastPrio = this.prio.pop();
+	        if (this.ids.length > 0) {
+	            this.ids[0] = lastId;
+	            this.prio[0] = lastPrio;
+	            let i = 0;
+	            const n = this.ids.length;
+	            for (;;) {
+	                const l = 2 * i + 1;
+	                const r = 2 * i + 2;
+	                let smallest = i;
+	                if (l < n && this.prio[l] < this.prio[smallest])
+	                    smallest = l;
+	                if (r < n && this.prio[r] < this.prio[smallest])
+	                    smallest = r;
+	                if (smallest === i)
+	                    break;
+	                this.swap(i, smallest);
+	                i = smallest;
+	            }
+	        }
+	        return topId;
+	    }
+	    swap(a, b) {
+	        const ti = this.ids[a];
+	        this.ids[a] = this.ids[b];
+	        this.ids[b] = ti;
+	        const tp = this.prio[a];
+	        this.prio[a] = this.prio[b];
+	        this.prio[b] = tp;
+	    }
+	}
 
-		}
+	/**
+	 * 模式 B(测地线)状态机:逐次点击锚点,相邻锚点之间用 MeshGraph 求最短路径,
+	 * 拼成一条贴合表面的折线。Enter 结束并可闭合(首尾再求一段)。
+	 */
+	class GeodesicContour {
+	    constructor(graph, mesh) {
+	        this.graph = graph;
+	        this.mesh = mesh;
+	        this.anchors = []; // 顶点索引
+	        this.segments = []; // 相邻锚点间路径(含端点)
+	    }
+	    /** 传入 local 命中点,snap 到最近顶点并对上一锚点求路径。 */
+	    addAnchor(localHitPoint) {
+	        const v = this.graph.nearestVertex(localHitPoint);
+	        if (this.anchors.length > 0) {
+	            const prev = this.anchors[this.anchors.length - 1];
+	            this.segments.push(this.graph.shortestPath(prev, v));
+	        }
+	        this.anchors.push(v);
+	    }
+	    get anchorCount() {
+	        return this.anchors.length;
+	    }
+	    /** 把所有路径顶点(world)+ 法线 拼成折线;closed 时补一段首尾路径。 */
+	    buildVertices(closed) {
+	        const segs = this.segments.slice();
+	        if (closed && this.anchors.length > 2) {
+	            segs.push(this.graph.shortestPath(this.anchors[this.anchors.length - 1], this.anchors[0]));
+	        }
+	        const idxPath = [];
+	        segs.forEach((s, si) => {
+	            const start = si === 0 ? 0 : 1; // 去重相邻段共享端点
+	            for (let k = start; k < s.length; k++)
+	                idxPath.push(s[k]);
+	        });
+	        if (idxPath.length === 0 && this.anchors.length === 1) {
+	            idxPath.push(this.anchors[0]);
+	        }
+	        // 图几何即 local 空间,直接产出 local 顶点(渲染时再派生 world)。
+	        return idxPath.map((i) => this.graph.vertexLocal(i));
+	    }
+	}
 
-		this.dispatchEvent( _endEvent );
+	/**
+	 * 标注数据模型 + 撤销栈 + 导出。纯数据,无 three / DOM 依赖。
+	 * 撤销只记录 add / remove 两类原子操作(满足"撤销最近添加 / 恢复删除")。
+	 * 通过 subscribe 通知 UI 与渲染层(后者据 list() 做场景对账)。
+	 */
+	class AnnotationStore {
+	    constructor() {
+	        this.items = [];
+	        this.undoStack = [];
+	        this.subs = new Set();
+	    }
+	    notify() {
+	        this.subs.forEach((f) => f());
+	    }
+	    subscribe(cb) {
+	        this.subs.add(cb);
+	        return () => this.subs.delete(cb);
+	    }
+	    add(a) {
+	        this.items.push(a);
+	        this.undoStack.push({ kind: "add", ann: a });
+	        this.notify();
+	    }
+	    remove(id) {
+	        const i = this.items.findIndex((x) => x.id === id);
+	        if (i < 0)
+	            return undefined;
+	        const [ann] = this.items.splice(i, 1);
+	        this.undoStack.push({ kind: "remove", ann });
+	        this.notify();
+	        return ann;
+	    }
+	    undo() {
+	        const op = this.undoStack.pop();
+	        if (!op)
+	            return;
+	        if (op.kind === "add") {
+	            const i = this.items.findIndex((x) => x.id === op.ann.id);
+	            if (i >= 0)
+	                this.items.splice(i, 1);
+	        }
+	        else {
+	            this.items.push(op.ann);
+	        }
+	        this.notify();
+	    }
+	    /** 清空,返回被清掉的项(供渲染层 dispose three 对象)。 */
+	    clear() {
+	        const old = this.items;
+	        this.items = [];
+	        this.undoStack = [];
+	        this.notify();
+	        return old;
+	    }
+	    list() {
+	        return this.items;
+	    }
+	    get(id) {
+	        return this.items.find((x) => x.id === id);
+	    }
+	    setLabel(id, label) {
+	        const a = this.get(id);
+	        if (a) {
+	            a.label = label;
+	            this.notify();
+	        }
+	    }
+	    setColor(id, color) {
+	        const a = this.get(id);
+	        if (a) {
+	            a.color = color;
+	            this.notify();
+	        }
+	    }
+	    toJSON(modelName, mesh, opts = {}) {
+	        var _a;
+	        const space = (_a = opts.space) !== null && _a !== void 0 ? _a : "local";
+	        const toPt = (v) => {
+	            let x = v.x, y = v.y, z = v.z;
+	            if (space === "world") {
+	                const p = new Vector3(v.x, v.y, v.z).applyMatrix4(mesh.matrixWorld);
+	                x = p.x;
+	                y = p.y;
+	                z = p.z;
+	            }
+	            return opts.includeNormals ? [x, y, z, v.nx, v.ny, v.nz] : [x, y, z];
+	        };
+	        return {
+	            model: modelName,
+	            exportedAt: new Date().toISOString(),
+	            space,
+	            annotations: this.items.map((a) => ({
+	                id: a.id,
+	                type: a.type,
+	                mode: a.mode,
+	                label: a.label,
+	                color: a.color,
+	                closed: a.closed,
+	                points: a.vertices.map(toPt),
+	            })),
+	        };
+	    }
+	}
 
+	const LINE_W = 3;
+	const LINE_W_SEL = 6;
+	/**
+	 * 表面标注主控制器(Phase 4):navigate / freehand / geodesic / point 四模式,
+	 * Enter 闭合,数据交给 AnnotationStore 管理(多条带颜色标签、撤销/删除/清空、导出)。
+	 * 渲染层据 store.list() 做场景对账(reconcile),撤销/删除自动加/移 three 对象。
+	 */
+	class SurfaceAnnotator {
+	    constructor(opts) {
+	        var _a, _b;
+	        this.mode = "navigate";
+	        this.spaceHeld = false;
+	        this.pointerDown = false;
+	        this.store = new AnnotationStore();
+	        this.managed = new Set();
+	        this.seq = 0;
+	        this.selectedId = null;
+	        /** 窗口尺寸变化时更新所有 fat line 的像素分辨率,否则线宽会失真。 */
+	        this.onResize = () => {
+	            const w = this.o.container.clientWidth;
+	            const h = this.o.container.clientHeight;
+	            for (const a of this.store.list()) {
+	                if (a.type === "contour" && a.object3D) {
+	                    const mat = a.object3D.material;
+	                    mat.resolution.set(w, h);
+	                }
+	            }
+	            if (this.activeLine)
+	                (this.activeLine.material.resolution.set(w, h));
+	            if (this.activeGeoLine)
+	                (this.activeGeoLine.material.resolution.set(w, h));
+	        };
+	        this.onPointerDown = (e) => {
+	            if (this.spaceHeld)
+	                return;
+	            if (e.button !== 0)
+	                return; // 仅左键
+	            if (!this.insideContainer(e))
+	                return;
+	            this.pointerDown = true;
+	            if (this.mode === "point") {
+	                const h = this.hit(e);
+	                if (!h)
+	                    return;
+	                const v = worldHitToLocalVertex(h, this.o.mesh);
+	                const marker = makePointMarker(v, this.o.mesh, this.pointColorVal, this.markerRadius);
+	                this.o.scene.add(marker);
+	                const ann = {
+	                    id: this.nextId(),
+	                    type: "points",
+	                    mode: null,
+	                    label: `Point ${this.seq}`,
+	                    color: this.pointColorVal,
+	                    closed: false,
+	                    vertices: [v],
+	                    object3D: marker,
+	                };
+	                this.store.add(ann);
+	                return;
+	            }
+	            if (this.mode === "freehand") {
+	                this.activeStroke = new StrokeContour(this.minGap, this.o.mesh);
+	                this.activeStroke.begin();
+	                const h = this.hit(e);
+	                if (h)
+	                    this.activeStroke.addSample(h);
+	                this.activeLine = makeContourLine(this.activeStroke.vertices, this.freehandColor, false, this.o.container, this.epsilon, this.o.mesh);
+	                this.o.scene.add(this.activeLine);
+	                return;
+	            }
+	            if (this.mode === "geodesic") {
+	                const h = this.hit(e);
+	                if (!h)
+	                    return;
+	                if (!this.activeGeo) {
+	                    this.activeGeo = new GeodesicContour(this.graph, this.o.mesh);
+	                }
+	                const local = this.o.mesh.worldToLocal(h.point.clone());
+	                this.activeGeo.addAnchor(local);
+	                const verts = this.activeGeo.buildVertices(false);
+	                if (!this.activeGeoLine) {
+	                    this.activeGeoLine = makeContourLine(verts, this.geodesicColor, false, this.o.container, this.epsilon, this.o.mesh);
+	                    this.o.scene.add(this.activeGeoLine);
+	                }
+	                else {
+	                    updateContourLine(this.activeGeoLine, verts, false, this.epsilon, this.o.mesh);
+	                }
+	            }
+	        };
+	        this.onPointerMove = (e) => {
+	            if (this.spaceHeld)
+	                return;
+	            if (this.mode === "freehand" &&
+	                this.pointerDown &&
+	                this.activeStroke &&
+	                this.activeLine) {
+	                const h = this.hit(e);
+	                if (!h)
+	                    return;
+	                this.activeStroke.addSample(h);
+	                updateContourLine(this.activeLine, this.activeStroke.vertices, false, this.epsilon, this.o.mesh);
+	            }
+	        };
+	        this.onPointerUp = () => {
+	            if (!this.pointerDown)
+	                return;
+	            this.pointerDown = false;
+	            if (this.activeStroke && this.activeLine) {
+	                const verts = this.activeStroke.end();
+	                if (verts.length >= 2) {
+	                    const ann = {
+	                        id: this.nextId(),
+	                        type: "contour",
+	                        mode: "freehand",
+	                        label: `Contour ${this.seq}`,
+	                        color: this.freehandColor,
+	                        closed: false,
+	                        vertices: verts,
+	                        object3D: this.activeLine,
+	                    };
+	                    this.store.add(ann);
+	                    this.lastFreehand = ann;
+	                }
+	                else {
+	                    this.o.scene.remove(this.activeLine);
+	                }
+	                this.activeStroke = undefined;
+	                this.activeLine = undefined;
+	            }
+	        };
+	        this.onKeyDown = (e) => {
+	            if (this.isTypingTarget(e))
+	                return;
+	            if (e.code === "Space") {
+	                this.spaceHeld = true;
+	                this.applyCameraGating();
+	                return;
+	            }
+	            if (e.key === "Escape") {
+	                this.setMode("navigate");
+	                return;
+	            }
+	            if ((e.ctrlKey || e.metaKey) && (e.key === "z" || e.key === "Z")) {
+	                e.preventDefault();
+	                this.undo();
+	                return;
+	            }
+	            if (e.key === "Delete" || e.key === "Backspace") {
+	                if (this.selectedId)
+	                    this.deleteAnnotation(this.selectedId);
+	                return;
+	            }
+	            if (e.key === "Enter") {
+	                // 测地线进行中 → 结束并闭合;否则闭合最近一条自由手绘线。
+	                if (this.activeGeo)
+	                    this.finishGeodesic();
+	                else
+	                    this.closeLastContour();
+	                return;
+	            }
+	            if (e.key === "1")
+	                this.setMode("navigate");
+	            if (e.key === "2")
+	                this.setMode("freehand");
+	            if (e.key === "3")
+	                this.setMode("geodesic");
+	            if (e.key === "4")
+	                this.setMode("point");
+	        };
+	        this.onKeyUp = (e) => {
+	            if (e.code === "Space") {
+	                this.spaceHeld = false;
+	                this.applyCameraGating();
+	            }
+	        };
+	        this.o = opts;
+	        const meshGeo = opts.mesh.geometry;
+	        if (!meshGeo.getAttribute("normal"))
+	            meshGeo.computeVertexNormals(); // 渲染需要法线
+	        meshGeo.computeBoundingBox();
+	        const diag = (_a = opts.bboxDiagonal) !== null && _a !== void 0 ? _a : meshGeo.boundingBox.getSize(new Vector3()).length();
+	        this.markerRadius = (_b = opts.markerRadius) !== null && _b !== void 0 ? _b : diag * 0.006;
+	        this.epsilon = diag * 0.002;
+	        this.minGap = diag * 0.004;
+	        // 测地线连通性:单独焊接一份"仅位置"的几何给 MeshGraph 用——
+	        // 不动被渲染的 mesh(保留其法线/UV/纹理)。仅位置可保证同表面位置的顶点
+	        // 被 mergeVertices 合并(否则逐面法线/UV 会阻止合并,图断裂 → 闭合穿模)。
+	        const posOnly = new BufferGeometry();
+	        posOnly.setAttribute("position", meshGeo.getAttribute("position").clone());
+	        const graphGeo = mergeVertices(posOnly);
+	        graphGeo.computeVertexNormals();
+	        this.graph = new MeshGraph(graphGeo);
+	        this.store.subscribe(() => this.reconcile());
+	        // 监听挂到 window 的捕获阶段(capture=true):在 copper 的 TrackballControls
+	        // 之前拿到每一个指针事件,避免它的 setPointerCapture / 事件路由导致拖拽中途丢 move。
+	        window.addEventListener("pointerdown", this.onPointerDown, true);
+	        window.addEventListener("pointermove", this.onPointerMove, true);
+	        window.addEventListener("pointerup", this.onPointerUp, true);
+	        window.addEventListener("keydown", this.onKeyDown);
+	        window.addEventListener("keyup", this.onKeyUp);
+	        window.addEventListener("resize", this.onResize);
+	        this.applyCameraGating();
+	    }
+	    get freehandColor() {
+	        var _a;
+	        return (_a = this.o.freehandColor) !== null && _a !== void 0 ? _a : "#e5006e";
+	    }
+	    get geodesicColor() {
+	        var _a;
+	        return (_a = this.o.geodesicColor) !== null && _a !== void 0 ? _a : "#ffa24e";
+	    }
+	    get pointColorVal() {
+	        var _a;
+	        return (_a = this.o.pointColor) !== null && _a !== void 0 ? _a : "#ffd166";
+	    }
+	    // ---- 对外 API(供 Vue 调用) ----
+	    getMode() {
+	        return this.mode;
+	    }
+	    setMode(m) {
+	        var _a, _b;
+	        this.mode = m;
+	        this.applyCameraGating();
+	        (_b = (_a = this.o).onModeChange) === null || _b === void 0 ? void 0 : _b.call(_a, m);
+	    }
+	    getStore() {
+	        return this.store;
+	    }
+	    /** 当前标注列表快照。 */
+	    getAnnotations() {
+	        return this.store.list();
+	    }
+	    undo() {
+	        this.store.undo();
+	    }
+	    clearAll() {
+	        const removed = this.store.clear();
+	        removed.forEach((a) => {
+	            if (a.object3D) {
+	                this.o.scene.remove(a.object3D);
+	                this.disposeObject(a.object3D);
+	            }
+	        });
+	        this.managed.clear();
+	        this.selectedId = null;
+	    }
+	    deleteAnnotation(id) {
+	        if (this.selectedId === id)
+	            this.selectedId = null;
+	        this.store.remove(id);
+	    }
+	    selectAnnotation(id) {
+	        this.selectedId = id;
+	        this.applySelection();
+	    }
+	    /** 颜色变更后重画对应 three 对象。 */
+	    refreshAnnotation(id) {
+	        const a = this.store.get(id);
+	        if (!a || !a.object3D)
+	            return;
+	        if (a.type === "contour") {
+	            setContourColor(a.object3D, a.color);
+	        }
+	        else {
+	            const m = a.object3D;
+	            m.material.color.set(a.color);
+	        }
+	    }
+	    exportJSON(modelName, opts) {
+	        return this.store.toJSON(modelName, this.o.mesh, opts);
+	    }
+	    // ---- 内部 ----
+	    applyCameraGating() {
+	        // 按住 Space 临时旋转优先;否则仅 navigate 模式开相机。
+	        this.o.controls.enabled = this.spaceHeld || this.mode === "navigate";
+	    }
+	    /** 据 store.list() 对账场景:补齐缺失对象、移除已删对象(不 dispose,留给撤销恢复)。 */
+	    reconcile() {
+	        var _a, _b;
+	        const present = new Set();
+	        for (const a of this.store.list())
+	            if (a.object3D)
+	                present.add(a.object3D);
+	        for (const o of this.managed) {
+	            if (!present.has(o))
+	                this.o.scene.remove(o);
+	        }
+	        for (const o of present) {
+	            if (!this.managed.has(o))
+	                this.o.scene.add(o);
+	        }
+	        this.managed = present;
+	        this.applySelection();
+	        (_b = (_a = this.o).onChange) === null || _b === void 0 ? void 0 : _b.call(_a, this.store.list());
+	    }
+	    applySelection() {
+	        for (const a of this.store.list()) {
+	            if (!a.object3D)
+	                continue;
+	            const sel = a.id === this.selectedId;
+	            if (a.type === "contour") {
+	                const mat = a.object3D.material;
+	                mat.linewidth = sel ? LINE_W_SEL : LINE_W;
+	            }
+	            else {
+	                a.object3D.scale.setScalar(sel ? 1.6 : 1);
+	            }
+	        }
+	    }
+	    disposeObject(o) {
+	        var _a, _b, _c;
+	        const any = o;
+	        (_b = (_a = any.geometry) === null || _a === void 0 ? void 0 : _a.dispose) === null || _b === void 0 ? void 0 : _b.call(_a);
+	        const mat = any.material;
+	        if (Array.isArray(mat))
+	            mat.forEach((m) => m.dispose());
+	        else
+	            (_c = mat === null || mat === void 0 ? void 0 : mat.dispose) === null || _c === void 0 ? void 0 : _c.call(mat);
+	    }
+	    nextId() {
+	        return "a" + ++this.seq;
+	    }
+	    hit(e) {
+	        return raycastSurface(this.o.camera, this.o.container, this.o.mesh, e.clientX, e.clientY);
+	    }
+	    /** 事件目标是否落在标注容器内(排除面板/页面其它区域的点击)。 */
+	    insideContainer(e) {
+	        const t = e.target;
+	        return !!t && this.o.container.contains(t);
+	    }
+	    closeLastContour() {
+	        const last = this.lastFreehand;
+	        if (!last || last.closed || last.vertices.length < 3 || !last.object3D)
+	            return;
+	        // 用测地线沿表面把末点连回首点,避免直线弦从模型内部"抄近路"被遮挡。
+	        const tail = last.vertices[last.vertices.length - 1];
+	        const head = last.vertices[0];
+	        const closing = this.surfacePathBetween(tail, head);
+	        last.vertices = last.vertices.concat(closing);
+	        last.closed = true;
+	        updateContourLine(last.object3D, last.vertices, true, this.epsilon, this.o.mesh);
+	    }
+	    /** 沿网格表面求 a→b 的测地路径(local 顶点),去掉与 a 重合的首点。a/b 已是 local。 */
+	    surfacePathBetween(a, b) {
+	        const va = this.graph.nearestVertex(new Vector3(a.x, a.y, a.z));
+	        const vb = this.graph.nearestVertex(new Vector3(b.x, b.y, b.z));
+	        const path = this.graph.shortestPath(va, vb);
+	        return path.slice(1).map((i) => this.graph.vertexLocal(i));
+	    }
+	    /** 结束当前测地线:闭合成环并落定为一条 contour。 */
+	    finishGeodesic() {
+	        if (!this.activeGeo || !this.activeGeoLine)
+	            return;
+	        const closed = this.activeGeo.anchorCount > 2;
+	        const verts = this.activeGeo.buildVertices(closed);
+	        if (verts.length >= 2) {
+	            updateContourLine(this.activeGeoLine, verts, closed, this.epsilon, this.o.mesh);
+	            const ann = {
+	                id: this.nextId(),
+	                type: "contour",
+	                mode: "geodesic",
+	                label: `Contour ${this.seq}`,
+	                color: this.geodesicColor,
+	                closed,
+	                vertices: verts,
+	                object3D: this.activeGeoLine,
+	            };
+	            this.store.add(ann);
+	        }
+	        else {
+	            this.o.scene.remove(this.activeGeoLine);
+	        }
+	        this.activeGeo = undefined;
+	        this.activeGeoLine = undefined;
+	    }
+	    isTypingTarget(e) {
+	        const t = e.target;
+	        if (!t)
+	            return false;
+	        const tag = t.tagName;
+	        return tag === "INPUT" || tag === "TEXTAREA" || t.isContentEditable;
+	    }
+	    dispose() {
+	        window.removeEventListener("pointerdown", this.onPointerDown, true);
+	        window.removeEventListener("pointermove", this.onPointerMove, true);
+	        window.removeEventListener("pointerup", this.onPointerUp, true);
+	        window.removeEventListener("keydown", this.onKeyDown);
+	        window.removeEventListener("keyup", this.onKeyUp);
+	        window.removeEventListener("resize", this.onResize);
+	    }
 	}
 
 	class copperScene extends baseScene {
@@ -58878,6 +61693,7 @@ void main() {
 	        this.mixer = null;
 	        this.playRate = 1.0;
 	        this.modelReady = false;
+	        this.surfaceAnnotators = [];
 	        if ((opt === null || opt === void 0 ? void 0 : opt.controls) === "trackball") {
 	            this.controls = new TrackballControls(this.camera, this.renderer.domElement);
 	        }
@@ -58953,53 +61769,45 @@ void main() {
 	            console.log("An error happened: ", error);
 	        });
 	    }
-	    // loadOBJ(url: string, callback?: (mesh: THREE.Group) => void) {
-	    //   objLoader.load(
-	    //     url,
-	    //     (obj) => {
-	    //       obj.traverse((child) => {
-	    //         if ((child as THREE.Mesh).isMesh) {
-	    //           // (child as THREE.Mesh).material = new THREE.MeshStandardMaterial({
-	    //           //   side: THREE.DoubleSide,
-	    //           //   color: 0xffffff,
-	    //           // });
-	    //           // ((child as THREE.Mesh).material as THREE.MeshPhongMaterial).color =
-	    //           //   new THREE.Color(0xffffff);
-	    //         }
-	    //       });
-	    //       const box = new THREE.Box3().setFromObject(obj);
-	    //       const size = box.getSize(new THREE.Vector3()).length();
-	    //       const center = box.getCenter(new THREE.Vector3());
-	    //       this.controls.maxDistance = size * 10;
-	    //       obj.position.x += obj.position.x - center.x;
-	    //       obj.position.y += obj.position.y - center.y;
-	    //       obj.position.z += obj.position.z - center.z;
-	    //       if (!this.cameraPositionFlag) {
-	    //         this.camera.position.copy(center);
-	    //         this.camera.position.x += size / 2.0;
-	    //         this.camera.position.y += size / 5.0;
-	    //         this.camera.position.z += size / 2.0;
-	    //         this.camera.lookAt(center);
-	    //         this.viewPoint = this.setViewPoint(
-	    //           this.camera as THREE.PerspectiveCamera,
-	    //           [center.x, center.y, center.z]
-	    //         );
-	    //       }
-	    //       this.scene.add(obj);
-	    //       !!callback && callback(obj);
-	    //     }, // called when loading is in progresses
-	    //     (xhr: any) => {
-	    //       console.log((xhr.loaded / xhr.total) * 100 + "% loaded");
-	    //     },
-	    //     // called when loading has errors
-	    //     (error: any) => {
-	    //       console.log("An error happened");
-	    //     }
-	    //   );
-	    // }
 	    loadVtk(url) {
 	        copperVtkLoader(url, this.scene, this.content);
 	    }
+	    /**
+	     * 在给定模型表面创建标注器(画 contour / 放点 / 导出坐标)。
+	     * target 可为单个 Mesh,或 Group/Object3D(自动选顶点数最多的 mesh)。
+	     * 复用本 scene 的 camera / container / controls;几何非索引时内部自动焊接索引化。
+	     */
+	    createSurfaceAnnotator(target, opts) {
+	        const mesh = this.pickAnnotatableMesh(target);
+	        if (!mesh)
+	            throw new Error("createSurfaceAnnotator: no mesh found in target");
+	        const annotator = new SurfaceAnnotator(Object.assign({ scene: this.scene, camera: this.camera, container: this.container, controls: this.controls, mesh }, (opts !== null && opts !== void 0 ? opts : {})));
+	        this.surfaceAnnotators.push(annotator);
+	        return annotator;
+	    }
+	    pickAnnotatableMesh(target) {
+	        if (target.isMesh)
+	            return target;
+	        let best = null;
+	        let bestCount = -1;
+	        target.traverse((c) => {
+	            var _a, _b;
+	            const m = c;
+	            if (m.isMesh) {
+	                const n = (_b = (_a = m.geometry.getAttribute("position")) === null || _a === void 0 ? void 0 : _a.count) !== null && _b !== void 0 ? _b : 0;
+	                if (n > bestCount) {
+	                    bestCount = n;
+	                    best = m;
+	                }
+	            }
+	        });
+	        return best;
+	    }
+	    /** 释放本 scene 创建的所有标注器(移除事件监听与标注对象)。 */
+	    disposeSurfaceAnnotators() {
+	        this.surfaceAnnotators.forEach((a) => a.dispose());
+	        this.surfaceAnnotators = [];
+	    }
 	    loadVtks(models) {
 	        let count = 0;
 	        let { vtkLoader } = copperMultipleVtk();
@@ -59359,7 +62167,6 @@ void main() {
 	        this.delta = 0;
 	        this.interval = 1 / this.fps;
 	        this.preRenderCallbackFunctions = [];
-	        this.running = true;
 	        this.animate = (time) => {
 	            var _a, _b, _c;
 	            if (!this.running)
@@ -59390,10 +62197,6 @@ void main() {
 	            }
 	        };
 	    }
-	    // Stop the render loop (call on teardown to release the RAF and let GC reclaim).
-	    stop() {
-	        this.running = false;
-	    }
 	    getSceneByName(name) {
 	        return this.sceneMap[name];
 	    }
@@ -59918,6 +62721,7 @@ void main() {
 	            alpha: true,
 	            antialias: true,
 	        });
+	        this.running = true;
 	        this.renderSceneInfo = (sceneInfo) => {
 	            const elem = sceneInfo.container;
 	            // get the viewpoint relative position of this element
@@ -59956,6 +62760,8 @@ void main() {
 	            }
 	        };
 	        this.animate = () => {
+	            if (!this.running)
+	                return;
 	            const clearColor = new Color$1("#000");
 	            this.renderer.setScissorTest(false);
 	            this.renderer.setClearColor(clearColor, 0);
@@ -60021,6 +62827,25 @@ void main() {
 	            }, undefined, reject);
 	        });
 	    }
+	    stop() {
+	        this.running = false;
+	    }
+	    // Full teardown: stop the loop, free GPU resources, release the WebGL context, and
+	    // remove the canvas. Call on page unmount to avoid context exhaustion / leaks.
+	    dispose() {
+	        var _a, _b;
+	        this.running = false;
+	        try {
+	            (_a = this.pmremGenerator) === null || _a === void 0 ? void 0 : _a.dispose();
+	            this.renderer.dispose();
+	            this.renderer.forceContextLoss();
+	        }
+	        catch (e) {
+	            /* ignore */
+	        }
+	        (_b = this.canvas) === null || _b === void 0 ? void 0 : _b.remove();
+	        this.elems.forEach((el) => el.remove());
+	    }
 	}
 
 	/******************************************************************************
@@ -70440,6 +73265,36 @@ void main() {
 	    7: '#f97316',
 	    8: '#8b5cf6', // Violet
 	};
+	/**
+	 * AI-Assist channel palette. Identical to the default palette EXCEPT:
+	 *  - channel 1 = cyan (the AI-Assist accent #5ec8ff), so the 2D AI overlay aligns
+	 *    with the cyan ai_generated GLB in the 3D panel;
+	 *  - channel 6 takes the emerald that channel 1 vacated, so cyan isn't duplicated.
+	 * Applied ONLY to the AI scratch layer (set per-volume in AiAssistTool.enter) —
+	 * the global palette above is untouched, so the clinician mask stays emerald.
+	 */
+	const AI_MASK_CHANNEL_COLORS = {
+	    0: { r: 0, g: 0, b: 0, a: 0 },
+	    1: { r: 94, g: 200, b: 255, a: 255 },
+	    2: { r: 244, g: 63, b: 94, a: 255 },
+	    3: { r: 59, g: 130, b: 246, a: 255 },
+	    4: { r: 251, g: 191, b: 36, a: 255 },
+	    5: { r: 217, g: 70, b: 239, a: 255 },
+	    6: { r: 16, g: 185, b: 129, a: 255 },
+	    7: { r: 249, g: 115, b: 22, a: 255 },
+	    8: { r: 139, g: 92, b: 246, a: 255 }, // Violet
+	};
+	const AI_CHANNEL_HEX_COLORS = {
+	    0: '#000000',
+	    1: '#5ec8ff',
+	    2: '#f43f5e',
+	    3: '#3b82f6',
+	    4: '#fbbf24',
+	    5: '#d946ef',
+	    6: '#10b981',
+	    7: '#f97316',
+	    8: '#8b5cf6', // Violet
+	};
 	// ── Color Conversion Utilities ──────────────────────────────────────────
 	/**
 	 * Convert an RGBAColor to a hex string (no alpha), e.g. '#ff0000'.
@@ -73588,6 +76443,8 @@ void main() {
 	    constructor(config) {
 	        // === State ===
 	        this.mode = 'idle';
+	        /** Mode to restore after a right-drag pan ends (so pan doesn't drop aiAssist). */
+	        this.modeBeforePan = 'idle';
 	        this.guiTool = 'pencil';
 	        this.state = {
 	            shiftHeld: false,
@@ -73713,7 +76570,20 @@ void main() {
 	     * Set the GUI tool (from UI buttons).
 	     */
 	    setGuiTool(tool) {
+	        const prevTool = this.guiTool;
 	        this.guiTool = tool;
+	        // AI-assist owns the canvas: left-click/drag = prompt. Taking the
+	        // 'aiAssist' mode (not 'idle') is what auto-disables left-drag slice
+	        // scrubbing — `isDragSliceActive()` requires mode === 'idle'.
+	        if (tool === 'aiAssist') {
+	            this.state.crosshairEnabled = false;
+	            this.setMode('aiAssist');
+	            return;
+	        }
+	        // Leaving aiAssist → restore idle so slice-drag / wheel resume.
+	        if (prevTool === 'aiAssist' && this.mode === 'aiAssist') {
+	            this.setMode('idle');
+	        }
 	        // When entering any sphere-family tool, keep crosshair if active, otherwise idle
 	        if (SPHERE_TOOLS.has(tool)) {
 	            if (!this.state.crosshairEnabled) {
@@ -73727,8 +76597,9 @@ void main() {
 	     * Blocked when draw or contrast mode is active, or left button is held (mutual exclusion).
 	     */
 	    toggleCrosshair() {
-	        // Allow crosshair in drawing tools and all sphere-family tools (sphere / sphereBrush / sphereEraser)
-	        if (!DRAWING_TOOLS.has(this.guiTool) && !SPHERE_TOOLS.has(this.guiTool))
+	        // Allow crosshair in drawing tools, all sphere-family tools, AND aiAssist
+	        // (so the crosshair can be used to debug while AI-assist is active).
+	        if (!DRAWING_TOOLS.has(this.guiTool) && !SPHERE_TOOLS.has(this.guiTool) && this.guiTool !== 'aiAssist')
 	            return;
 	        // Block crosshair activation during draw, contrast, or while left button held.
 	        // The leftButtonDown guard also enforces "once a sphere preview is on screen,
@@ -73736,7 +76607,15 @@ void main() {
 	        if (this.state.shiftHeld || this.state.leftButtonDown || this.mode === 'draw' || this.mode === 'contrast')
 	            return;
 	        this.state.crosshairEnabled = !this.state.crosshairEnabled;
-	        this.setMode(this.state.crosshairEnabled ? 'crosshair' : 'idle');
+	        // Crosshair has PRIORITY over aiAssist: turning it on takes the mode (so
+	        // AI point/box/scribble are suspended); turning it off restores aiAssist
+	        // (not idle) when the AI tool is the active tool, otherwise idle.
+	        if (this.state.crosshairEnabled) {
+	            this.setMode('crosshair');
+	        }
+	        else {
+	            this.setMode(this.guiTool === 'aiAssist' ? 'aiAssist' : 'idle');
+	        }
 	    }
 	    /**
 	     * Check if crosshair mode is enabled.
@@ -73872,8 +76751,8 @@ void main() {
 	            }
 	        }
 	        if (this.contrastEnabled && this.keyboardSettings.contrast.includes(ev.key)) {
-	            // Block contrast state when crosshair, draw, or any sphere-family tool is active (mutual exclusion)
-	            if (!this.state.crosshairEnabled && this.mode !== 'draw'
+	            // Block contrast state when crosshair, draw, aiAssist, or any sphere-family tool is active (mutual exclusion)
+	            if (!this.state.crosshairEnabled && this.mode !== 'draw' && this.mode !== 'aiAssist'
 	                && !SPHERE_TOOLS.has(this.guiTool)) {
 	                this.state.ctrlHeld = true;
 	            }
@@ -73910,6 +76789,10 @@ void main() {
 	        }
 	        else if (ev.button === 2) {
 	            this.state.rightButtonDown = true;
+	            // Remember the mode we're panning out of so we can restore it on
+	            // release — otherwise aiAssist (and any non-idle mode) is lost.
+	            if (this.mode !== 'pan')
+	                this.modeBeforePan = this.mode;
 	            this.setMode('pan');
 	        }
 	        // Route to external handler
@@ -73930,7 +76813,10 @@ void main() {
 	        else if (ev.button === 2) {
 	            this.state.rightButtonDown = false;
 	            if (this.mode === 'pan') {
-	                this.setMode('idle');
+	                // Restore aiAssist if we panned out of it; otherwise idle (unchanged
+	                // behaviour for normal drawing modes).
+	                this.setMode(this.modeBeforePan === 'aiAssist' ? 'aiAssist' : 'idle');
+	                this.modeBeforePan = 'idle';
 	            }
 	        }
 	        // Route to external handler
@@ -75853,6 +78739,474 @@ void main() {
 	    }
 	}
 
+	/**
+	 * AiAssistTool — interactive prompt-based segmentation (experimental).
+	 *
+	 * The clinician left-clicks foreground / background points (or drags a box /
+	 * scribbles) on the current slice; a backend model returns a region mask that
+	 * is written into an INDEPENDENT scratch MaskVolume (`aiAssistMaskVolume`,
+	 * registered as `maskData.volumes['aiScratch']`) — never the validated layers.
+	 *
+	 * Network lives in the app layer: this tool only (a) maps screen → voxel-slice
+	 * coordinates, (b) accumulates the prompt for the current slice, (c) fires
+	 * `onPrompt` so the app can call the backend, and (d) applies the returned mask
+	 * via `applyMask`. The app's `useAiAssist` composable wires (c)→(d).
+	 *
+	 * Sandbox: snapshot on enter (`snapshot`), then on exit either `discard`
+	 * (restore snapshot) or merge is handled by NrrdTools (clone + pushGroup).
+	 *
+	 * Coordinate mapping supports all three views (axial/sagittal/coronal); it
+	 * inverts the per-axis display transform of RenderingUtils.renderSliceToCanvas
+	 * (only coronal 'y' is vertically flipped). Merge captures painted voxels from
+	 * any view (the scratch is a full 3D volume).
+	 */
+	/** Scratch volume key in maskData.volumes — kept OUT of image.layers so
+	 *  compositeAllLayers ignores it (we render it ourselves in start()). */
+	const AI_SCRATCH_LAYER = "aiScratch";
+	class AiAssistTool extends BaseTool {
+	    constructor(ctx, host) {
+	        super(ctx);
+	        /** Independent scratch volume (also registered at maskData.volumes['aiScratch']). */
+	        this.scratchVol = null;
+	        /** Snapshot of the scratch buffer taken on enter (for discard). */
+	        this.snapshotData = null;
+	        /** Frozen regions ("New region" commits here). Pixels recorded here survive a
+	         *  later re-prediction — even on the SAME channel — so multiple separate regions
+	         *  can be drawn without the newest prediction wiping the previous ones. Null =
+	         *  nothing frozen yet (applySliceRle then behaves as a single live region). */
+	        this.committedVol = null;
+	        this.promptTool = "point";
+	        this.polarity = 1; // 1 = foreground (positive), 0 = background
+	        /** Target channel/label (1-8) the AI paints into — the "AI layer" channel. */
+	        this.channel = 1;
+	        /** Scribble brush radius (px), user-adjustable via slider. */
+	        this.scribbleSize = 5;
+	        /** Accumulated prompts for the CURRENT slice; reset on slice/axis change. */
+	        this.points = [];
+	        this.scribble = [];
+	        this.activeSlice = -1;
+	        // Drag state (box / scribble) — voxel coords for the prompt
+	        this.dragging = false;
+	        this.dragStart = null;
+	        // Screen-space (display px) copies for the LIVE preview drawn each frame.
+	        this.dragScreenStart = null;
+	        this.dragScreen = null;
+	        this.screenScribble = [];
+	        // Live cursor position (screen px) for the scribble brush-size preview ring —
+	        // updated on every hover move so the ring follows the mouse like the paint brush.
+	        this.hoverScreen = null;
+	        /** Fired when a prompt gesture completes — app calls backend, then applyMask(). */
+	        this.onPrompt = null;
+	        this.host = host;
+	    }
+	    // ── Configuration (driven from the panel via NrrdTools) ────────────────────
+	    setPromptTool(tool) {
+	        // Switching tool starts a clean gesture — drop any stale points/box/scribble
+	        // and drag state so the next click behaves predictably.
+	        if (tool !== this.promptTool) {
+	            this.resetPrompts();
+	            this.dragging = false;
+	            this.dragStart = null;
+	        }
+	        this.promptTool = tool;
+	    }
+	    setPolarity(label) { this.polarity = label === 0 ? 0 : 1; }
+	    setScribbleSize(size) {
+	        this.scribbleSize = Math.max(1, Math.min(40, Math.round(size)));
+	    }
+	    setChannel(channel) {
+	        const c = Math.max(1, Math.min(8, Math.round(channel)));
+	        // Changing channel starts a NEW region in the new colour — otherwise the
+	        // accumulated points would be re-predicted and repainted in the new label,
+	        // recolouring the previous channel's region.
+	        if (c !== this.channel)
+	            this.resetPrompts();
+	        this.channel = c;
+	    }
+	    getChannel() { return this.channel; }
+	    getScratchVolume() { return this.scratchVol; }
+	    /** Serialize the scratch volume as per-z-slice RLE (only NON-empty slices),
+	     *  for persisting to ai_generated_nii_LPS on the backend. Binary (any channel →
+	     *  1); RLE is alternating run lengths starting with a 0-run — the exact format
+	     *  the backend's rle_decode expects. Uses getSliceUint8 (the same path the
+	     *  clinician layer's /api/mask/replace uses) so orientation matches. */
+	    getScratchSlices() {
+	        if (!this.scratchVol)
+	            return null;
+	        const { depth } = this.scratchVol.getDimensions();
+	        const out = [];
+	        let width = 0;
+	        let height = 0;
+	        for (let z = 0; z < depth; z++) {
+	            const { data, width: w, height: h } = this.scratchVol.getSliceUint8(z, "z");
+	            width = w;
+	            height = h;
+	            // RLE-encode (binarized) in one pass; skip fully-empty slices.
+	            const runs = [];
+	            let value = 0; // always begin with a 0-run (matches backend rle_encode)
+	            let count = 0;
+	            let any = false;
+	            for (let i = 0; i < data.length; i++) {
+	                const v = data[i] !== 0 ? 1 : 0;
+	                if (v)
+	                    any = true;
+	                if (v === value) {
+	                    count++;
+	                }
+	                else {
+	                    runs.push(count);
+	                    value = v;
+	                    count = 1;
+	                }
+	            }
+	            runs.push(count);
+	            if (any)
+	                out.push({ sliceIndex: z, rle: runs });
+	        }
+	        return { axis: "z", width, height, slices: out };
+	    }
+	    // ── Sandbox lifecycle ──────────────────────────────────────────────────────
+	    /** Create (or reuse) the scratch volume sized to the layer grid and register
+	     *  it under maskData.volumes['aiScratch']. Snapshots the empty buffer. */
+	    enter() {
+	        const volumes = this.ctx.protectedData.maskData.volumes;
+	        const baseId = this.ctx.nrrd_states.image.layers[0];
+	        const base = volumes[baseId];
+	        if (!base)
+	            return;
+	        const d = base.getDimensions();
+	        if (!this.scratchVol ||
+	            this.scratchVol.getDimensions().width !== d.width ||
+	            this.scratchVol.getDimensions().height !== d.height ||
+	            this.scratchVol.getDimensions().depth !== d.depth) {
+	            this.scratchVol = new MaskVolume(d.width, d.height, d.depth, 1);
+	        }
+	        else {
+	            this.scratchVol.clear();
+	        }
+	        volumes[AI_SCRATCH_LAYER] = this.scratchVol;
+	        // Paint the AI scratch with the AI-Assist palette (channel 1 = cyan) so the 2D
+	        // overlay matches the cyan ai_generated GLB. Scoped to THIS volume only — the
+	        // global palette / clinician mask colours are untouched.
+	        for (let ch = 1; ch <= 8; ch++) {
+	            const c = AI_MASK_CHANNEL_COLORS[ch];
+	            if (c)
+	                this.scratchVol.setChannelColor(ch, { r: c.r, g: c.g, b: c.b, a: c.a });
+	        }
+	        this.snapshotData = this.scratchVol.getRawData().slice();
+	        this.committedVol = null; // nothing frozen at session start
+	        this.resetPrompts();
+	    }
+	    /** Remove the scratch volume from the registry and drop references. */
+	    exit() {
+	        const volumes = this.ctx.protectedData.maskData.volumes;
+	        delete volumes[AI_SCRATCH_LAYER];
+	        this.scratchVol = null;
+	        this.snapshotData = null;
+	        this.committedVol = null;
+	        this.resetPrompts();
+	        this.dragging = false;
+	        this.dragStart = null;
+	    }
+	    /** Discard everything painted since enter() — restore the snapshot. */
+	    discard() {
+	        if (this.scratchVol && this.snapshotData) {
+	            this.scratchVol.setRawData(this.snapshotData.slice());
+	        }
+	        this.committedVol = null; // discard wipes frozen regions too
+	        this.resetPrompts();
+	    }
+	    /** "New region": freeze every voxel painted so far so it survives later
+	     *  re-predictions (even on the same channel), then start a fresh prompt set.
+	     *  This is what makes drawing multiple separate regions actually work — without
+	     *  it the next prediction's same-channel cleanup erases the previous region. */
+	    commitRegion() {
+	        if (this.scratchVol) {
+	            const d = this.scratchVol.getDimensions();
+	            if (!this.committedVol ||
+	                this.committedVol.getDimensions().width !== d.width ||
+	                this.committedVol.getDimensions().height !== d.height ||
+	                this.committedVol.getDimensions().depth !== d.depth) {
+	                this.committedVol = new MaskVolume(d.width, d.height, d.depth, 1);
+	            }
+	            this.committedVol.setRawData(this.scratchVol.getRawData().slice());
+	        }
+	        this.resetPrompts();
+	    }
+	    /** Clear the in-progress prompt set (e.g. slice/axis change). Does NOT freeze —
+	     *  use commitRegion() for the "New region" action. */
+	    resetPrompts() {
+	        this.points = [];
+	        this.scribble = [];
+	        this.box = undefined;
+	        this.dragScreenStart = null;
+	        this.dragScreen = null;
+	        this.screenScribble = [];
+	    }
+	    // ── Coordinate mapping (all three views) ───────────────────────────────────
+	    //
+	    // Mapping must INVERT exactly what RenderingUtils.renderSliceToCanvas does to
+	    // display the overlay (it is the renderer used by renderOverlay):
+	    //   - axial (z) / sagittal (x): no flip
+	    //   - coronal (y): vertical flip (scale(1,-1))
+	    // Slice voxel dims & canvas mm extents per axis (matches MaskVolume
+	    // getSliceDimensions + SphereTool.setSphereCanvasSize):
+	    //   z → (W=width,  H=height) over (x_mm, y_mm)
+	    //   y → (W=width,  H=depth ) over (x_mm, z_mm)   [vertical flip]
+	    //   x → (W=depth,  H=height) over (z_mm, y_mm)
+	    /** Voxel-slice (width,height) for the current axis. */
+	    sliceDims() {
+	        if (!this.scratchVol)
+	            return null;
+	        const d = this.scratchVol.getDimensions();
+	        switch (this.ctx.protectedData.axis) {
+	            case "z": return { w: d.width, h: d.height };
+	            case "y": return { w: d.width, h: d.depth };
+	            case "x": return { w: d.depth, h: d.height };
+	            default: return null;
+	        }
+	    }
+	    /** Screen offset → voxel-slice (vx,vy) for the current axis. */
+	    toVoxel(e) {
+	        const sd = this.sliceDims();
+	        if (!sd || !this.scratchVol)
+	            return null;
+	        const nrrd = this.ctx.nrrd_states;
+	        const img = nrrd.image;
+	        const mx = e.offsetX / nrrd.view.sizeFactor;
+	        const my = e.offsetY / nrrd.view.sizeFactor;
+	        let hMM, vMM, flipV;
+	        switch (this.ctx.protectedData.axis) {
+	            case "z":
+	                hMM = img.nrrd_x_mm;
+	                vMM = img.nrrd_y_mm;
+	                flipV = false;
+	                break;
+	            case "y":
+	                hMM = img.nrrd_x_mm;
+	                vMM = img.nrrd_z_mm;
+	                flipV = true;
+	                break;
+	            case "x":
+	                hMM = img.nrrd_z_mm;
+	                vMM = img.nrrd_y_mm;
+	                flipV = false;
+	                break;
+	            default: return null;
+	        }
+	        const vx = Math.round(mx * sd.w / hMM);
+	        let vy = Math.round(my * sd.h / vMM);
+	        if (flipV)
+	            vy = sd.h - 1 - vy;
+	        if (vx < 0 || vx >= sd.w || vy < 0 || vy >= sd.h)
+	            return null;
+	        return { vx, vy, w: sd.w, h: sd.h };
+	    }
+	    // ── Pointer handlers (left button; right stays pan in EventRouter) ──────────
+	    onPointerDown(e) {
+	        const hit = this.toVoxel(e);
+	        if (!hit)
+	            return;
+	        this.syncSlice();
+	        if (this.promptTool === "point") {
+	            this.points.push({ x: hit.vx, y: hit.vy, label: this.polarity });
+	            this.emit();
+	        }
+	        else {
+	            // box / scribble: begin a drag
+	            this.dragging = true;
+	            this.dragStart = { x: hit.vx, y: hit.vy };
+	            this.dragScreenStart = { x: e.offsetX, y: e.offsetY };
+	            this.dragScreen = { x: e.offsetX, y: e.offsetY };
+	            this.screenScribble = [];
+	            if (this.promptTool === "scribble") {
+	                this.scribble.push({ x: hit.vx, y: hit.vy, label: this.polarity });
+	                this.screenScribble.push({ x: e.offsetX, y: e.offsetY });
+	            }
+	        }
+	    }
+	    onPointerMove(e) {
+	        // Track hover for the scribble preview ring even when not drawing.
+	        this.hoverScreen = { x: e.offsetX, y: e.offsetY };
+	        if (!this.dragging)
+	            return;
+	        // Track screen pos first so the live preview follows even slightly out of bounds.
+	        this.dragScreen = { x: e.offsetX, y: e.offsetY };
+	        const hit = this.toVoxel(e);
+	        if (!hit)
+	            return;
+	        if (this.promptTool === "scribble") {
+	            this.scribble.push({ x: hit.vx, y: hit.vy, label: this.polarity });
+	            this.screenScribble.push({ x: e.offsetX, y: e.offsetY });
+	        }
+	        else if (this.promptTool === "box" && this.dragStart) {
+	            this.box = {
+	                x0: this.dragStart.x, y0: this.dragStart.y,
+	                x1: hit.vx, y1: hit.vy,
+	                label: this.polarity, // foreground box grows within; background box excludes
+	            };
+	        }
+	    }
+	    onPointerUp(_e) {
+	        if (!this.dragging)
+	            return;
+	        this.dragging = false;
+	        this.emit();
+	        this.dragStart = null;
+	        this.dragScreenStart = null;
+	        this.dragScreen = null;
+	        this.screenScribble = [];
+	    }
+	    /** Reset the accumulated prompt set when the user scrubs to a new slice. */
+	    syncSlice() {
+	        const slice = this.ctx.nrrd_states.view.currentSliceIndex;
+	        if (slice !== this.activeSlice) {
+	            this.activeSlice = slice;
+	            this.resetPrompts();
+	        }
+	    }
+	    emit() {
+	        if (!this.onPrompt)
+	            return;
+	        const sd = this.sliceDims();
+	        if (!sd)
+	            return;
+	        this.onPrompt({
+	            axis: this.ctx.protectedData.axis,
+	            sliceIndex: this.ctx.nrrd_states.view.currentSliceIndex,
+	            width: sd.w,
+	            height: sd.h,
+	            points: [...this.points],
+	            box: this.box,
+	            scribble: this.scribble.length ? [...this.scribble] : undefined,
+	            scribbleRadius: this.scribbleSize,
+	        });
+	    }
+	    // ── Apply backend result → scratch volume ──────────────────────────────────
+	    applyMask(result) {
+	        if (!this.scratchVol)
+	            return;
+	        // 3D result (engine B): write each slice across the covered span.
+	        if (result.slices && result.sliceRange) {
+	            const [lo] = result.sliceRange;
+	            for (let k = 0; k < result.slices.length; k++) {
+	                this.applySliceRle(result.slices[k], result.axis, lo + k, result.width, result.height);
+	            }
+	            return;
+	        }
+	        // 2D result (engines mock / regiongrow / medsam2d): single slice.
+	        this.applySliceRle(result.rle, result.axis, result.sliceIndex, result.width, result.height);
+	    }
+	    /** Merge one RLE-encoded predicted slice into the scratch volume at sliceIndex.
+	     *  Predicted pixels → current channel; stale current-channel pixels cleared
+	     *  UNLESS they belong to a frozen (committed) region; OTHER channels preserved. */
+	    applySliceRle(rle, axis, sliceIndex, width, height) {
+	        if (!this.scratchVol)
+	            return;
+	        const predicted = new Uint8Array(width * height);
+	        let pos = 0;
+	        let value = 0;
+	        for (const run of rle) {
+	            if (value === 1 && run > 0) {
+	                const end = Math.min(pos + run, predicted.length);
+	                for (let i = pos; i < end; i++)
+	                    predicted[i] = 1;
+	            }
+	            pos += run;
+	            value ^= 1;
+	        }
+	        const ch = this.channel;
+	        try {
+	            const out = this.scratchVol.getSliceUint8(sliceIndex, axis).data; // copy
+	            // Frozen same-channel pixels for this slice (if any region was committed).
+	            let frozen = null;
+	            if (this.committedVol) {
+	                try {
+	                    frozen = this.committedVol.getSliceUint8(sliceIndex, axis).data;
+	                }
+	                catch (_a) {
+	                    frozen = null;
+	                }
+	            }
+	            const n = Math.min(out.length, predicted.length);
+	            for (let i = 0; i < n; i++) {
+	                if (predicted[i])
+	                    out[i] = ch;
+	                // Clear stale LIVE same-channel pixels (refinement), but never erase a
+	                // frozen region committed via "New region".
+	                else if (out[i] === ch && !(frozen && frozen[i] === ch))
+	                    out[i] = 0;
+	            }
+	            this.scratchVol.setSliceUint8(sliceIndex, out, axis);
+	        }
+	        catch (_b) {
+	            // slice out of bounds / dims changed — ignore
+	        }
+	    }
+	    // ── Overlay render (called from DrawToolCore.start() while in aiAssist) ──────
+	    renderOverlay(targetCtx) {
+	        if (!this.scratchVol)
+	            return;
+	        const axis = this.ctx.protectedData.axis;
+	        const slice = this.ctx.nrrd_states.view.currentSliceIndex;
+	        const buffer = this.host.getOrCreateSliceBuffer(axis);
+	        if (!buffer)
+	            return;
+	        try {
+	            this.host.renderSliceToCanvas(AI_SCRATCH_LAYER, axis, slice, buffer, targetCtx, this.ctx.nrrd_states.view.changedWidth, this.ctx.nrrd_states.view.changedHeight);
+	        }
+	        catch (_a) {
+	            // volume not ready / slice out of bounds
+	        }
+	        // Live drag preview (screen space) — rubber-band box / scribble stroke so the
+	        // user sees the gesture before the prediction lands on pointer-up.
+	        if (this.dragging && this.dragScreenStart && this.dragScreen) {
+	            targetCtx.save();
+	            // Green-ish for foreground (include), red-ish for background (exclude).
+	            const color = this.polarity === 1 ? "rgba(120,255,180,0.95)" : "rgba(255,120,120,0.95)";
+	            targetCtx.strokeStyle = color;
+	            if (this.promptTool === "box") {
+	                targetCtx.setLineDash([5, 4]);
+	                targetCtx.lineWidth = 1.5;
+	                const x = Math.min(this.dragScreenStart.x, this.dragScreen.x);
+	                const y = Math.min(this.dragScreenStart.y, this.dragScreen.y);
+	                const w = Math.abs(this.dragScreen.x - this.dragScreenStart.x);
+	                const h = Math.abs(this.dragScreen.y - this.dragScreenStart.y);
+	                targetCtx.strokeRect(x, y, w, h);
+	            }
+	            else if (this.promptTool === "scribble" && this.screenScribble.length > 1) {
+	                targetCtx.lineCap = "round";
+	                targetCtx.lineJoin = "round";
+	                // Stroke thickness reflects the scribble brush size (diameter ≈ 2·radius).
+	                targetCtx.lineWidth = Math.max(2, this.scribbleSize * 2);
+	                targetCtx.beginPath();
+	                targetCtx.moveTo(this.screenScribble[0].x, this.screenScribble[0].y);
+	                for (let i = 1; i < this.screenScribble.length; i++) {
+	                    targetCtx.lineTo(this.screenScribble[i].x, this.screenScribble[i].y);
+	                }
+	                targetCtx.stroke();
+	            }
+	            targetCtx.restore();
+	        }
+	        // Scribble brush-size preview ring (when NOT dragging) — a circle centred on
+	        // the cursor whose radius = scribbleSize, so the user sees the brush size and
+	        // how the slider changes it (mirrors the paint brush's preview ring). Drawn
+	        // every frame from the live hover position by copper3d's render loop.
+	        if (this.promptTool === "scribble" && !this.dragging && this.hoverScreen) {
+	            targetCtx.save();
+	            const fg = this.polarity === 1;
+	            targetCtx.strokeStyle = fg ? "rgba(120,255,180,0.9)" : "rgba(255,120,120,0.9)";
+	            targetCtx.lineWidth = 1.5;
+	            if (!fg)
+	                targetCtx.setLineDash([4, 4]); // dashed for background (exclude), like the eraser
+	            targetCtx.beginPath();
+	            targetCtx.arc(this.hoverScreen.x, this.hoverScreen.y, Math.max(2, this.scribbleSize), 0, Math.PI * 2);
+	            targetCtx.stroke();
+	            targetCtx.restore();
+	        }
+	    }
+	}
+
 	/**
 	 * DrawToolCore — Tool orchestration and event routing.
 	 *
@@ -75973,6 +79327,10 @@ void main() {
 	            setEmptyCanvasSize: (axis) => this.setEmptyCanvasSize(axis),
 	            reloadMasksFromVolume: () => this.reloadMasksFromVolume(),
 	        });
+	        this.aiAssistTool = new AiAssistTool(toolCtx, {
+	            renderSliceToCanvas: (layer, axis, sliceIndex, buffer, ctx, w, h) => this.renderer.renderSliceToCanvas(layer, axis, sliceIndex, buffer, ctx, w, h),
+	            getOrCreateSliceBuffer: (axis) => this.renderer.getOrCreateSliceBuffer(axis),
+	        });
 	    }
 	    initDrawToolCore() {
 	        // Initialize EventRouter for centralized event handling
@@ -76079,6 +79437,8 @@ void main() {
 	                // Block contrast toggle during crosshair, draw, or sphere (mutual exclusion)
 	                if (this.eventRouter.isCrosshairEnabled() || this.eventRouter.getMode() === 'draw')
 	                    return;
+	                if (this.eventRouter.getMode() === 'aiAssist')
+	                    return;
 	                if (this.state.gui_states.mode.sphere)
 	                    return;
 	                // Toggle contrast mode manually since it's on keyup
@@ -76092,6 +79452,10 @@ void main() {
 	        });
 	        // Register pointer handlers with EventRouter
 	        this.eventRouter.setPointerMoveHandler((e) => {
+	            if (this.eventRouter.getMode() === 'aiAssist') {
+	                this.aiAssistTool.onPointerMove(e);
+	                return;
+	            }
 	            if (this.drawingTool.isActive || this.panTool.isActive) {
 	                this.drawingPrameters.handleOnDrawingMouseMove(e);
 	            }
@@ -76106,6 +79470,14 @@ void main() {
 	            }
 	        });
 	        this.eventRouter.setPointerUpHandler((e) => {
+	            if (this.eventRouter.getMode() === 'aiAssist') {
+	                if (e.button === 0)
+	                    this.aiAssistTool.onPointerUp(e);
+	                // Right-button pan must still clean up (cursor/state) even in AI mode.
+	                else if (e.button === 2)
+	                    this.panTool.onPointerUp(e, this.state.gui_states.viewConfig.defaultPaintCursor);
+	                return;
+	            }
 	            // Restore Scroll:Zoom if we swapped to Scroll:Slice on drag-start.
 	            // Must run outside the drawing-tool gate below: slice-drag doesn't
 	            // flip any of those flags, so the gate would skip restoration.
@@ -76265,7 +79637,10 @@ void main() {
 	                this.activeWheelMode = 'none';
 	            }
 	            if (e.button === 0) {
-	                if (this.eventRouter.getMode() === 'draw') {
+	                if (this.eventRouter.getMode() === 'aiAssist') {
+	                    this.aiAssistTool.onPointerDown(e);
+	                }
+	                else if (this.eventRouter.getMode() === 'draw') {
 	                    this.drawingTool.onPointerDown(e);
 	                }
 	                else if (this.eventRouter.isCrosshairEnabled()) {
@@ -76380,6 +79755,12 @@ void main() {
 	                    || this.state.gui_states.mode.sphereEraser) {
 	                    this.state.protectedData.ctxes.drawingCtx.drawImage(this.state.protectedData.canvases.drawingSphereCanvas, 0, 0, this.state.nrrd_states.view.changedWidth, this.state.nrrd_states.view.changedHeight);
 	                }
+	                // AI-assist scratch overlay — drawn each frame whenever an AI session is
+	                // active (scratch volume exists), so it stays visible even when crosshair
+	                // temporarily takes over the interaction mode for debugging.
+	                if (this.aiAssistTool.getScratchVolume()) {
+	                    this.aiAssistTool.renderOverlay(this.state.protectedData.ctxes.drawingCtx);
+	                }
 	            }
 	            else {
 	                this.redrawDisplayCanvas();
@@ -77984,6 +81365,13 @@ void main() {
 	        this._calculatorActive = false;
 	        /** Stored closure callbacks from gui.ts setupGui() */
 	        this.guiCallbacks = null;
+	        // ═══════════════════════════════════════════════════════════════════════════
+	        // 10b. AI Assist (experimental) — interactive prompt segmentation
+	        // ═══════════════════════════════════════════════════════════════════════════
+	        /** Whether AI-assist mode is currently active. */
+	        this._aiAssistActive = false;
+	        /** Layer visibility snapshot taken on enter, restored on exit. */
+	        this._aiPrevVisibility = null;
 	        this.container = container;
 	        // Create shared state
 	        const mainAreaContainer = document.createElement("div");
@@ -78151,6 +81539,13 @@ void main() {
 	        var _a, _b, _c;
 	        if (!this.guiCallbacks)
 	            return;
+	        // While AI-assist owns the canvas, BLOCK switching to other tools — the user
+	        // must explicitly Exit AI Assist from its panel first. (The Operation panel
+	        // also disables its tool buttons via the AiAssist:ActiveChanged event, so this
+	        // is just a defensive guard.)
+	        if (this._aiAssistActive && mode !== "aiAssist") {
+	            return;
+	        }
 	        const prevSphere = this.state.gui_states.mode.sphere;
 	        const prevSphereBrush = this.state.gui_states.mode.sphereBrush;
 	        const prevSphereEraser = this.state.gui_states.mode.sphereEraser;
@@ -78799,6 +82194,111 @@ void main() {
 	        this.resetLayerCanvas();
 	        this.reloadMasksFromVolume();
 	    }
+	    isAiAssistActive() { return this._aiAssistActive; }
+	    /**
+	     * Enter AI-assist mode (sandbox): hides the existing layer masks so ONLY the
+	     * AI overlay is shown, takes canvas ownership (left-click = prompt), and creates
+	     * the scratch volume. Right-drag still pans; wheel/slider still scrub slices.
+	     * The hidden masks are restored on exit (merge writes into them first if asked).
+	     */
+	    enterAiAssistMode() {
+	        var _a;
+	        if (this._aiAssistActive)
+	            return;
+	        this._aiAssistActive = true;
+	        this.dragOperator.removeDragMode();
+	        // Hide all layer masks (visibility=false survives recomposite on slice change).
+	        const vis = this.state.gui_states.layerChannel.layerVisibility;
+	        this._aiPrevVisibility = Object.assign({}, vis);
+	        for (const layerId of this.state.nrrd_states.image.layers)
+	            vis[layerId] = false;
+	        this.drawCore.renderer.compositeAllLayers();
+	        this.drawCore.aiAssistTool.enter();
+	        (_a = this.drawCore.eventRouter) === null || _a === void 0 ? void 0 : _a.setGuiTool("aiAssist");
+	    }
+	    /**
+	     * Exit AI-assist mode: drop the scratch volume, restore normal tooling AND the
+	     * layer-mask visibility hidden on enter. If the caller merged first, the merged
+	     * result is now part of the layer volume and reappears with the restored masks.
+	     */
+	    exitAiAssistMode() {
+	        var _a;
+	        if (!this._aiAssistActive)
+	            return;
+	        this._aiAssistActive = false;
+	        this.drawCore.aiAssistTool.exit();
+	        this.dragOperator.configDragMode();
+	        (_a = this.drawCore.eventRouter) === null || _a === void 0 ? void 0 : _a.setGuiTool("pencil");
+	        if (this._aiPrevVisibility) {
+	            const vis = this.state.gui_states.layerChannel.layerVisibility;
+	            for (const k of Object.keys(this._aiPrevVisibility))
+	                vis[k] = this._aiPrevVisibility[k];
+	            this._aiPrevVisibility = null;
+	        }
+	        this.reloadMasksFromVolume();
+	    }
+	    // — Driver methods called by the app-layer composable —
+	    aiSetPromptTool(tool) { this.drawCore.aiAssistTool.setPromptTool(tool); }
+	    aiSetPolarity(label) { this.drawCore.aiAssistTool.setPolarity(label); }
+	    /** Set the AI-layer channel (1-8) the predictions paint into. */
+	    aiSetChannel(channel) { this.drawCore.aiAssistTool.setChannel(channel); }
+	    /** Set the scribble brush radius (px). */
+	    aiSetScribbleSize(size) { this.drawCore.aiAssistTool.setScribbleSize(size); }
+	    /** Register the callback invoked when a prompt gesture completes (app → backend). */
+	    aiOnPrompt(cb) { this.drawCore.aiAssistTool.onPrompt = cb; }
+	    /** Apply a backend mask result into the scratch volume (overlay repaints next frame). */
+	    aiApplyMask(result) { this.drawCore.aiAssistTool.applyMask(result); }
+	    /** Clear the in-progress prompt set (e.g. slice change). */
+	    aiClearPrompts() { this.drawCore.aiAssistTool.resetPrompts(); }
+	    /** "New region": freeze current regions (they persist) + start a fresh prompt set. */
+	    aiCommitRegion() { this.drawCore.aiAssistTool.commitRegion(); }
+	    /** Discard all AI scratch painting since enter (sandbox discard). */
+	    aiDiscard() { this.drawCore.aiAssistTool.discard(); }
+	    /** True if the scratch volume holds any predicted voxels. */
+	    aiHasData() { var _a, _b; return (_b = (_a = this.drawCore.aiAssistTool.getScratchVolume()) === null || _a === void 0 ? void 0 : _a.hasData()) !== null && _b !== void 0 ? _b : false; }
+	    /** Serialize the AI scratch as per-slice RLE for persisting to ai_generated_nii_LPS. */
+	    aiGetScratchSlices() {
+	        return this.drawCore.aiAssistTool.getScratchSlices();
+	    }
+	    /**
+	     * Merge the AI scratch into a target layer as a single undoable group (sandbox
+	     * merge — best-practice: non-destructive + one Ctrl+Z). The scratch's channel
+	     * labels are PRESERVED (each AI channel maps onto the same channel of the
+	     * target layer). Scans all z-slices, so voxels painted from any view are caught.
+	     */
+	    aiCommitToLayer(targetLayer = "layer1") {
+	        const scratch = this.drawCore.aiAssistTool.getScratchVolume();
+	        if (!scratch)
+	            return;
+	        const target = this.state.protectedData.maskData.volumes[targetLayer];
+	        if (!target)
+	            return;
+	        const dims = scratch.getDimensions();
+	        const deltas = [];
+	        for (let z = 0; z < dims.depth; z++) {
+	            const sc = scratch.getSliceUint8(z, "z").data;
+	            let any = false;
+	            for (let i = 0; i < sc.length; i++) {
+	                if (sc[i] !== 0) {
+	                    any = true;
+	                    break;
+	                }
+	            }
+	            if (!any)
+	                continue;
+	            const oldSlice = target.getSliceUint8(z, "z").data; // copy
+	            const newSlice = oldSlice.slice();
+	            for (let i = 0; i < newSlice.length; i++) {
+	                if (sc[i] !== 0)
+	                    newSlice[i] = sc[i]; // preserve the AI channel label
+	            }
+	            target.setSliceUint8(z, newSlice, "z");
+	            deltas.push({ layerId: targetLayer, axis: "z", sliceIndex: z, oldSlice, newSlice: newSlice.slice() });
+	        }
+	        if (deltas.length)
+	            this.drawCore.undoManager.pushGroup(deltas);
+	        this.reloadMasksFromVolume();
+	    }
 	    // ═══════════════════════════════════════════════════════════════════════════
 	    // 11. Clear / Reset
 	    // ═══════════════════════════════════════════════════════════════════════════
@@ -79162,9 +82662,11 @@ void main() {
 	}
 
 	// import * as kiwrious from "copper3d_plugin_heart_k";
-	const REVISION = "v3.4.9-beta";
+	const REVISION = "v3.6.0-beta";
 	console.log(`%cCopper3D Visualisation %cBeta:${REVISION}`, "padding: 3px;color:white; background:#023047", "padding: 3px;color:white; background:#f50a25");
 
+	exports.AI_CHANNEL_HEX_COLORS = AI_CHANNEL_HEX_COLORS;
+	exports.AI_MASK_CHANNEL_COLORS = AI_MASK_CHANNEL_COLORS;
 	exports.CHANNEL_COLORS = CHANNEL_COLORS;
 	exports.CHANNEL_HEX_COLORS = CHANNEL_HEX_COLORS;
 	exports.CameraViewPoint = CameraViewPoint;
@@ -79173,6 +82675,7 @@ void main() {
 	exports.MeshNodeTool = MeshNodeTool;
 	exports.NrrdTools = NrrdTools;
 	exports.REVISION = REVISION;
+	exports.SurfaceAnnotator = SurfaceAnnotator;
 	exports.addBoxHelper = addBoxHelper;
 	exports.addLabelToScene = addLabelToScene;
 	exports.configKiwriousHeart = configKiwriousHeart;