@selvajs/visualization 1.6.0-beta.8 → 1.6.0-beta.9

package/dist/gpu-ownership-Bs9l7hrU.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gpu-ownership-Bs9l7hrU.js","names":[],"sources":["../src/shared/gpu-ownership.ts"],"sourcesContent":["import type * as THREE from 'three';\n\n// ============================================================================\n// GPU resource ownership — the single rule every disposal path obeys\n// ============================================================================\n\n/**\n * A GPU resource has exactly one owner: a **module singleton** (nobody ever frees it), a **cache**\n * (frees it on eviction) or the **scene** (freed on teardown). Every disposal path asks\n * {@link canDisposeMaterial} before freeing a material. Textures are always scene-owned.\n *\n * A cached geometry's data belongs to the cache, but its GPU copy lives only while a scene draws it.\n * Scene teardown resolves each geometry with {@link cachedSourceOf} and frees the GPU copy of every\n * cached geometry the next scene does not draw; three uploads it again if it comes back. A cached\n * geometry can back several meshes at once, so nothing may write to its arrays.\n */\n\n// Module-scope singletons from `render/three-materials.ts`, shared across meshes and solves —\n// disposing one would free textures still in use and force a recompile. Held here (not imported\n// there) to avoid an import cycle.\nconst protectedMaterials = new Set<THREE.Material>();\n\n/** Register materials as never-disposable. Called once by `render/three-materials.ts`. */\nexport function protectMaterials(materials: Iterable<THREE.Material>): void {\n\tfor (const material of materials) protectedMaterials.add(material);\n}\n\n/** True when `material` is scene-owned (not one of the protected singletons). */\nexport function canDisposeMaterial(material: THREE.Material | undefined): boolean {\n\tif (!material) return false;\n\treturn !protectedMaterials.has(material);\n}\n\n// Geometries the parser's finished-geometry cache hands out across solves.\nconst sharedGeometries = new WeakSet<THREE.BufferGeometry>();\n\nexport function shareGeometry(geometry: THREE.BufferGeometry): void {\n\tsharedGeometries.add(geometry);\n}\n\nexport function unshareGeometry(geometry: THREE.BufferGeometry): void {\n\tsharedGeometries.delete(geometry);\n}\n\nexport function isCachedGeometry(geometry: THREE.BufferGeometry): boolean {\n\treturn sharedGeometries.has(geometry);\n}\n\n// Scene-owned geometries drawing a cached geometry's attributes under their own groups. Disposing\n// one as is would free those attributes' GPU buffers out from under the cache.\nconst borrowers = new WeakMap<THREE.BufferGeometry, THREE.BufferGeometry>();\n\nexport function borrowGeometry(borrower: THREE.BufferGeometry, source: THREE.BufferGeometry): void {\n\tborrowers.set(borrower, source);\n}\n\n/** The cached geometry whose GPU buffers `geometry` draws, or null when it owns its own. */\nexport function cachedSourceOf(geometry: THREE.BufferGeometry): THREE.BufferGeometry | null {\n\tif (sharedGeometries.has(geometry)) return geometry;\n\t// Once evicted, the source is scene-owned like any other geometry, and the borrower frees it.\n\tconst source = borrowers.get(geometry);\n\treturn source && sharedGeometries.has(source) ? source : null;\n}\n"],"mappings":";;;;;;;;;;;AAoBA,MAAM,qCAAqB,IAAI,IAAoB;;AAQnD,SAAgB,mBAAmB,UAA+C;CACjF,IAAI,CAAC,UAAU,OAAO;CACtB,OAAO,CAAC,mBAAmB,IAAI,QAAQ;AACxC;AAGA,MAAM,mCAAmB,IAAI,QAA8B;AAE3D,SAAgB,cAAc,UAAsC;CACnE,iBAAiB,IAAI,QAAQ;AAC9B;AAEA,SAAgB,gBAAgB,UAAsC;CACrE,iBAAiB,OAAO,QAAQ;AACjC;AAEA,SAAgB,iBAAiB,UAAyC;CACzE,OAAO,iBAAiB,IAAI,QAAQ;AACrC;AAIA,MAAM,4BAAY,IAAI,QAAoD;AAE1E,SAAgB,eAAe,UAAgC,QAAoC;CAClG,UAAU,IAAI,UAAU,MAAM;AAC/B;;AAGA,SAAgB,eAAe,UAA6D;CAC3F,IAAI,iBAAiB,IAAI,QAAQ,GAAG,OAAO;CAE3C,MAAM,SAAS,UAAU,IAAI,QAAQ;CACrC,OAAO,UAAU,iBAAiB,IAAI,MAAM,IAAI,SAAS;AAC1D"}

package/dist/index.js

@@ -1 +1 @@
-export{};
+export {};

package/dist/merged-draw-CO4rr2Co.js

@@ -0,0 +1,129 @@
+import { i as isCachedGeometry, t as borrowGeometry } from "./gpu-ownership-Bs9l7hrU.js";
+import * as THREE from "three";
+// src/shared/merged-draw.ts
+const states = /* @__PURE__ */ new WeakMap();
+const listeners = /* @__PURE__ */ new WeakMap();
+const tintOrigins = /* @__PURE__ */ new WeakMap();
+const NONE = /* @__PURE__ */ new Set();
+function windowsOf(mesh) {
+	const members = mesh.userData?.members;
+	if (!Array.isArray(members) || members.length === 0) return null;
+	if (members.some((m) => m.indexStart == null || m.indexCount == null)) return null;
+	return members;
+}
+function stateOf(mesh) {
+	let state = states.get(mesh);
+	if (!state) {
+		state = {
+			base: Array.isArray(mesh.material) ? mesh.material[0] : mesh.material,
+			hidden: NONE,
+			selection: null,
+			hover: null
+		};
+		states.set(mesh, state);
+	}
+	return state;
+}
+function ownGeometry(mesh) {
+	const shared = mesh.geometry;
+	if (!isCachedGeometry(shared)) return shared;
+	const own = new THREE.BufferGeometry();
+	own.setIndex(shared.index);
+	for (const [name, attribute] of Object.entries(shared.attributes)) own.setAttribute(name, attribute);
+	own.boundingBox = shared.boundingBox?.clone() ?? null;
+	own.boundingSphere = shared.boundingSphere?.clone() ?? null;
+	borrowGeometry(own, shared);
+	mesh.geometry = own;
+	return own;
+}
+function rebuild(mesh, windows, state) {
+	const geometry = ownGeometry(mesh);
+	geometry.clearGroups();
+	const { selection, hover } = state;
+	if (state.hidden.size === 0 && !selection && !hover) {
+		mesh.material = state.base;
+		states.delete(mesh);
+		return;
+	}
+	const materials = [state.base];
+	const selectionSlot = selection ? materials.push(selection.material) - 1 : 0;
+	const hoverSlot = hover ? materials.push(hover.material) - 1 : 0;
+	let runStart = -1;
+	let runEnd = 0;
+	let runMaterial = 0;
+	const flush = () => {
+		if (runStart >= 0) geometry.addGroup(runStart, runEnd - runStart, runMaterial);
+		runStart = -1;
+	};
+	for (let i = 0; i < windows.length; i++) {
+		if (state.hidden.has(i)) {
+			flush();
+			continue;
+		}
+		const { indexStart, indexCount } = windows[i];
+		const material = selection?.members.has(i) ? selectionSlot : hover?.members.has(i) ? hoverSlot : 0;
+		if (runStart < 0 || material !== runMaterial || indexStart !== runEnd) {
+			flush();
+			runStart = indexStart;
+			runMaterial = material;
+		}
+		runEnd = indexStart + indexCount;
+	}
+	flush();
+	mesh.material = materials;
+}
+function update(mesh, change) {
+	const windows = windowsOf(mesh);
+	if (!windows) return;
+	const state = stateOf(mesh);
+	change(state);
+	rebuild(mesh, windows, state);
+	listeners.get(mesh)?.forEach((listener) => listener());
+}
+/** Members of `mesh` not drawn, by index into `userData.members`. */
+function getHiddenMembers(mesh) {
+	return states.get(mesh)?.hidden ?? NONE;
+}
+function setHiddenMembers(mesh, hidden) {
+	const current = getHiddenMembers(mesh);
+	if (current.size === hidden.size && [...hidden].every((i) => current.has(i))) return;
+	update(mesh, (state) => {
+		state.hidden = new Set(hidden);
+	});
+}
+/** The material `mesh` draws with when nothing is highlighted. */
+function getBaseMaterial(mesh) {
+	const material = states.get(mesh)?.base ?? (Array.isArray(mesh.material) ? mesh.material[0] : mesh.material);
+	return tintOrigins.get(material) ?? material;
+}
+/** A clone to tint and swap onto a mesh. `getBaseMaterial` keeps answering with `material`. */
+function cloneForTint(material) {
+	const clone = material.clone();
+	tintOrigins.set(clone, tintOrigins.get(material) ?? material);
+	return clone;
+}
+/** Draws `members` with `material`. The caller owns `material` and disposes it. */
+function setMemberHighlight(mesh, members, material, kind = "selection") {
+	update(mesh, (state) => {
+		state[kind] = {
+			members,
+			material
+		};
+	});
+}
+function clearMemberHighlight(mesh, kind = "selection") {
+	if (!states.get(mesh)?.[kind]) return;
+	update(mesh, (state) => {
+		state[kind] = null;
+	});
+}
+/** Calls `listener` after the hidden set or highlight of `mesh` changes. Returns an unsubscribe. */
+function onMemberDrawChange(mesh, listener) {
+	let set = listeners.get(mesh);
+	if (!set) listeners.set(mesh, set = /* @__PURE__ */ new Set());
+	set.add(listener);
+	return () => set.delete(listener);
+}
+export { onMemberDrawChange as a, getHiddenMembers as i, cloneForTint as n, setHiddenMembers as o, getBaseMaterial as r, setMemberHighlight as s, clearMemberHighlight as t };
+
+//# sourceMappingURL=merged-draw-CO4rr2Co.js.map

package/dist/merged-draw-CO4rr2Co.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"merged-draw-CO4rr2Co.js","names":[],"sources":["../src/shared/merged-draw.ts"],"sourcesContent":["// ============================================================================\n// Which parts of a merged mesh draw, and with what material\n// ============================================================================\n//\n// A merged mesh draws many source members in one call. Two features draw only part of it: hiding\n// a member (`scene/`) and tinting a selected or hovered member (`render/`). Both need geometry groups, and\n// three honours groups only when `material` is an array: with a single material it draws the whole\n// index range and ignores them. So one owner builds the groups and the material array from both\n// states together. Two writers each replacing the groups would undo each other.\n//\n// Members are addressed by their index in `userData.members`, which carries each member's window\n// into the index buffer (`finalizeMergedMesh`).\n\nimport * as THREE from 'three';\n\nimport { borrowGeometry, isCachedGeometry } from './gpu-ownership.js';\n\ninterface MemberWindow {\n\tindexStart?: number;\n\tindexCount?: number;\n}\n\nexport type HighlightKind = 'selection' | 'hover';\n\ninterface Highlight {\n\tmembers: ReadonlySet<number>;\n\tmaterial: THREE.Material;\n}\n\ninterface DrawState extends Record<HighlightKind, Highlight | null> {\n\t/** The mesh's own material, restored once nothing is hidden or highlighted. */\n\tbase: THREE.Material;\n\thidden: ReadonlySet<number>;\n}\n\nconst states = new WeakMap<THREE.Mesh, DrawState>();\nconst listeners = new WeakMap<THREE.Mesh, Set<() => void>>();\n\nconst tintOrigins = new WeakMap<THREE.Material, THREE.Material>();\n\nconst NONE: ReadonlySet<number> = new Set();\n\nfunction windowsOf(mesh: THREE.Mesh): Required<MemberWindow>[] | null {\n\tconst members = mesh.userData?.members as MemberWindow[] | undefined;\n\tif (!Array.isArray(members) || members.length === 0) return null;\n\t// One member without a window means the ranges can't be rebuilt without dropping geometry.\n\tif (members.some((m) => m.indexStart == null || m.indexCount == null)) return null;\n\treturn members as Required<MemberWindow>[];\n}\n\nfunction stateOf(mesh: THREE.Mesh): DrawState {\n\tlet state = states.get(mesh);\n\tif (!state) {\n\t\tconst base = Array.isArray(mesh.material) ? mesh.material[0]! : mesh.material;\n\t\tstate = { base, hidden: NONE, selection: null, hover: null };\n\t\tstates.set(mesh, state);\n\t}\n\treturn state;\n}\n\n// Groups live on the geometry, and a cached geometry can back two meshes at once (two identical\n// branches), so a mesh gets its own geometry over the same attributes before writing any.\nfunction ownGeometry(mesh: THREE.Mesh): THREE.BufferGeometry {\n\tconst shared = mesh.geometry;\n\tif (!isCachedGeometry(shared)) return shared;\n\n\tconst own = new THREE.BufferGeometry();\n\town.setIndex(shared.index);\n\tfor (const [name, attribute] of Object.entries(shared.attributes))\n\t\town.setAttribute(name, attribute);\n\town.boundingBox = shared.boundingBox?.clone() ?? null;\n\town.boundingSphere = shared.boundingSphere?.clone() ?? null;\n\tborrowGeometry(own, shared);\n\tmesh.geometry = own;\n\treturn own;\n}\n\nfunction rebuild(mesh: THREE.Mesh, windows: Required<MemberWindow>[], state: DrawState): void {\n\tconst geometry = ownGeometry(mesh);\n\tgeometry.clearGroups();\n\n\tconst { selection, hover } = state;\n\tif (state.hidden.size === 0 && !selection && !hover) {\n\t\tmesh.material = state.base;\n\t\tstates.delete(mesh);\n\t\treturn;\n\t}\n\n\tconst materials = [state.base];\n\tconst selectionSlot = selection ? materials.push(selection.material) - 1 : 0;\n\tconst hoverSlot = hover ? materials.push(hover.material) - 1 : 0;\n\n\t// Coalesce neighbours with the same material, so hiding one member costs two draws, not N.\n\tlet runStart = -1;\n\tlet runEnd = 0;\n\tlet runMaterial = 0;\n\tconst flush = () => {\n\t\tif (runStart >= 0) geometry.addGroup(runStart, runEnd - runStart, runMaterial);\n\t\trunStart = -1;\n\t};\n\tfor (let i = 0; i < windows.length; i++) {\n\t\tif (state.hidden.has(i)) {\n\t\t\tflush();\n\t\t\tcontinue;\n\t\t}\n\t\tconst { indexStart, indexCount } = windows[i]!;\n\t\t// Selection wins, so pointing at a selected member doesn't make it look unselected.\n\t\tconst material = selection?.members.has(i)\n\t\t\t? selectionSlot\n\t\t\t: hover?.members.has(i)\n\t\t\t\t? hoverSlot\n\t\t\t\t: 0;\n\t\tif (runStart < 0 || material !== runMaterial || indexStart !== runEnd) {\n\t\t\tflush();\n\t\t\trunStart = indexStart;\n\t\t\trunMaterial = material;\n\t\t}\n\t\trunEnd = indexStart + indexCount;\n\t}\n\tflush();\n\n\tmesh.material = materials;\n}\n\nfunction update(mesh: THREE.Mesh, change: (state: DrawState) => void): void {\n\tconst windows = windowsOf(mesh);\n\tif (!windows) return;\n\tconst state = stateOf(mesh);\n\tchange(state);\n\trebuild(mesh, windows, state);\n\tlisteners.get(mesh)?.forEach((listener) => listener());\n}\n\n/** Members of `mesh` not drawn, by index into `userData.members`. */\nexport function getHiddenMembers(mesh: THREE.Mesh): ReadonlySet<number> {\n\treturn states.get(mesh)?.hidden ?? NONE;\n}\n\nexport function setHiddenMembers(mesh: THREE.Mesh, hidden: ReadonlySet<number>): void {\n\tconst current = getHiddenMembers(mesh);\n\tif (current.size === hidden.size && [...hidden].every((i) => current.has(i))) return;\n\tupdate(mesh, (state) => {\n\t\tstate.hidden = new Set(hidden);\n\t});\n}\n\n/** The material `mesh` draws with when nothing is highlighted. */\nexport function getBaseMaterial(mesh: THREE.Mesh): THREE.Material {\n\tconst material =\n\t\tstates.get(mesh)?.base ?? (Array.isArray(mesh.material) ? mesh.material[0]! : mesh.material);\n\treturn tintOrigins.get(material) ?? material;\n}\n\n/** A clone to tint and swap onto a mesh. `getBaseMaterial` keeps answering with `material`. */\nexport function cloneForTint(material: THREE.Material): THREE.Material {\n\tconst clone = material.clone();\n\ttintOrigins.set(clone, tintOrigins.get(material) ?? material);\n\treturn clone;\n}\n\n/** Draws `members` with `material`. The caller owns `material` and disposes it. */\nexport function setMemberHighlight(\n\tmesh: THREE.Mesh,\n\tmembers: ReadonlySet<number>,\n\tmaterial: THREE.Material,\n\tkind: HighlightKind = 'selection'\n): void {\n\tupdate(mesh, (state) => {\n\t\tstate[kind] = { members, material };\n\t});\n}\n\nexport function clearMemberHighlight(mesh: THREE.Mesh, kind: HighlightKind = 'selection'): void {\n\tif (!states.get(mesh)?.[kind]) return;\n\tupdate(mesh, (state) => {\n\t\tstate[kind] = null;\n\t});\n}\n\n/** Calls `listener` after the hidden set or highlight of `mesh` changes. Returns an unsubscribe. */\nexport function onMemberDrawChange(mesh: THREE.Mesh, listener: () => void): () => void {\n\tlet set = listeners.get(mesh);\n\tif (!set) listeners.set(mesh, (set = new Set()));\n\tset.add(listener);\n\treturn () => set.delete(listener);\n}\n"],"mappings":"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"}

package/dist/merged-draw-ma_2r4N8.cjs

@@ -0,0 +1,171 @@
+const require_gpu_ownership = require("./gpu-ownership-ADRZBxxs.cjs");
+let three = require("three");
+three = require_gpu_ownership.__toESM(three, 1);
+// src/shared/merged-draw.ts
+const states = /* @__PURE__ */ new WeakMap();
+const listeners = /* @__PURE__ */ new WeakMap();
+const tintOrigins = /* @__PURE__ */ new WeakMap();
+const NONE = /* @__PURE__ */ new Set();
+function windowsOf(mesh) {
+	const members = mesh.userData?.members;
+	if (!Array.isArray(members) || members.length === 0) return null;
+	if (members.some((m) => m.indexStart == null || m.indexCount == null)) return null;
+	return members;
+}
+function stateOf(mesh) {
+	let state = states.get(mesh);
+	if (!state) {
+		state = {
+			base: Array.isArray(mesh.material) ? mesh.material[0] : mesh.material,
+			hidden: NONE,
+			selection: null,
+			hover: null
+		};
+		states.set(mesh, state);
+	}
+	return state;
+}
+function ownGeometry(mesh) {
+	const shared = mesh.geometry;
+	if (!require_gpu_ownership.isCachedGeometry(shared)) return shared;
+	const own = new three.BufferGeometry();
+	own.setIndex(shared.index);
+	for (const [name, attribute] of Object.entries(shared.attributes)) own.setAttribute(name, attribute);
+	own.boundingBox = shared.boundingBox?.clone() ?? null;
+	own.boundingSphere = shared.boundingSphere?.clone() ?? null;
+	require_gpu_ownership.borrowGeometry(own, shared);
+	mesh.geometry = own;
+	return own;
+}
+function rebuild(mesh, windows, state) {
+	const geometry = ownGeometry(mesh);
+	geometry.clearGroups();
+	const { selection, hover } = state;
+	if (state.hidden.size === 0 && !selection && !hover) {
+		mesh.material = state.base;
+		states.delete(mesh);
+		return;
+	}
+	const materials = [state.base];
+	const selectionSlot = selection ? materials.push(selection.material) - 1 : 0;
+	const hoverSlot = hover ? materials.push(hover.material) - 1 : 0;
+	let runStart = -1;
+	let runEnd = 0;
+	let runMaterial = 0;
+	const flush = () => {
+		if (runStart >= 0) geometry.addGroup(runStart, runEnd - runStart, runMaterial);
+		runStart = -1;
+	};
+	for (let i = 0; i < windows.length; i++) {
+		if (state.hidden.has(i)) {
+			flush();
+			continue;
+		}
+		const { indexStart, indexCount } = windows[i];
+		const material = selection?.members.has(i) ? selectionSlot : hover?.members.has(i) ? hoverSlot : 0;
+		if (runStart < 0 || material !== runMaterial || indexStart !== runEnd) {
+			flush();
+			runStart = indexStart;
+			runMaterial = material;
+		}
+		runEnd = indexStart + indexCount;
+	}
+	flush();
+	mesh.material = materials;
+}
+function update(mesh, change) {
+	const windows = windowsOf(mesh);
+	if (!windows) return;
+	const state = stateOf(mesh);
+	change(state);
+	rebuild(mesh, windows, state);
+	listeners.get(mesh)?.forEach((listener) => listener());
+}
+/** Members of `mesh` not drawn, by index into `userData.members`. */
+function getHiddenMembers(mesh) {
+	return states.get(mesh)?.hidden ?? NONE;
+}
+function setHiddenMembers(mesh, hidden) {
+	const current = getHiddenMembers(mesh);
+	if (current.size === hidden.size && [...hidden].every((i) => current.has(i))) return;
+	update(mesh, (state) => {
+		state.hidden = new Set(hidden);
+	});
+}
+/** The material `mesh` draws with when nothing is highlighted. */
+function getBaseMaterial(mesh) {
+	const material = states.get(mesh)?.base ?? (Array.isArray(mesh.material) ? mesh.material[0] : mesh.material);
+	return tintOrigins.get(material) ?? material;
+}
+/** A clone to tint and swap onto a mesh. `getBaseMaterial` keeps answering with `material`. */
+function cloneForTint(material) {
+	const clone = material.clone();
+	tintOrigins.set(clone, tintOrigins.get(material) ?? material);
+	return clone;
+}
+/** Draws `members` with `material`. The caller owns `material` and disposes it. */
+function setMemberHighlight(mesh, members, material, kind = "selection") {
+	update(mesh, (state) => {
+		state[kind] = {
+			members,
+			material
+		};
+	});
+}
+function clearMemberHighlight(mesh, kind = "selection") {
+	if (!states.get(mesh)?.[kind]) return;
+	update(mesh, (state) => {
+		state[kind] = null;
+	});
+}
+/** Calls `listener` after the hidden set or highlight of `mesh` changes. Returns an unsubscribe. */
+function onMemberDrawChange(mesh, listener) {
+	let set = listeners.get(mesh);
+	if (!set) listeners.set(mesh, set = /* @__PURE__ */ new Set());
+	set.add(listener);
+	return () => set.delete(listener);
+}
+Object.defineProperty(exports, "clearMemberHighlight", {
+	enumerable: true,
+	get: function() {
+		return clearMemberHighlight;
+	}
+});
+Object.defineProperty(exports, "cloneForTint", {
+	enumerable: true,
+	get: function() {
+		return cloneForTint;
+	}
+});
+Object.defineProperty(exports, "getBaseMaterial", {
+	enumerable: true,
+	get: function() {
+		return getBaseMaterial;
+	}
+});
+Object.defineProperty(exports, "getHiddenMembers", {
+	enumerable: true,
+	get: function() {
+		return getHiddenMembers;
+	}
+});
+Object.defineProperty(exports, "onMemberDrawChange", {
+	enumerable: true,
+	get: function() {
+		return onMemberDrawChange;
+	}
+});
+Object.defineProperty(exports, "setHiddenMembers", {
+	enumerable: true,
+	get: function() {
+		return setHiddenMembers;
+	}
+});
+Object.defineProperty(exports, "setMemberHighlight", {
+	enumerable: true,
+	get: function() {
+		return setMemberHighlight;
+	}
+});
+
+//# sourceMappingURL=merged-draw-ma_2r4N8.cjs.map

package/dist/merged-draw-ma_2r4N8.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"merged-draw-ma_2r4N8.cjs","names":["isCachedGeometry","THREE"],"sources":["../src/shared/merged-draw.ts"],"sourcesContent":["// ============================================================================\n// Which parts of a merged mesh draw, and with what material\n// ============================================================================\n//\n// A merged mesh draws many source members in one call. Two features draw only part of it: hiding\n// a member (`scene/`) and tinting a selected or hovered member (`render/`). Both need geometry groups, and\n// three honours groups only when `material` is an array: with a single material it draws the whole\n// index range and ignores them. So one owner builds the groups and the material array from both\n// states together. Two writers each replacing the groups would undo each other.\n//\n// Members are addressed by their index in `userData.members`, which carries each member's window\n// into the index buffer (`finalizeMergedMesh`).\n\nimport * as THREE from 'three';\n\nimport { borrowGeometry, isCachedGeometry } from './gpu-ownership.js';\n\ninterface MemberWindow {\n\tindexStart?: number;\n\tindexCount?: number;\n}\n\nexport type HighlightKind = 'selection' | 'hover';\n\ninterface Highlight {\n\tmembers: ReadonlySet<number>;\n\tmaterial: THREE.Material;\n}\n\ninterface DrawState extends Record<HighlightKind, Highlight | null> {\n\t/** The mesh's own material, restored once nothing is hidden or highlighted. */\n\tbase: THREE.Material;\n\thidden: ReadonlySet<number>;\n}\n\nconst states = new WeakMap<THREE.Mesh, DrawState>();\nconst listeners = new WeakMap<THREE.Mesh, Set<() => void>>();\n\nconst tintOrigins = new WeakMap<THREE.Material, THREE.Material>();\n\nconst NONE: ReadonlySet<number> = new Set();\n\nfunction windowsOf(mesh: THREE.Mesh): Required<MemberWindow>[] | null {\n\tconst members = mesh.userData?.members as MemberWindow[] | undefined;\n\tif (!Array.isArray(members) || members.length === 0) return null;\n\t// One member without a window means the ranges can't be rebuilt without dropping geometry.\n\tif (members.some((m) => m.indexStart == null || m.indexCount == null)) return null;\n\treturn members as Required<MemberWindow>[];\n}\n\nfunction stateOf(mesh: THREE.Mesh): DrawState {\n\tlet state = states.get(mesh);\n\tif (!state) {\n\t\tconst base = Array.isArray(mesh.material) ? mesh.material[0]! : mesh.material;\n\t\tstate = { base, hidden: NONE, selection: null, hover: null };\n\t\tstates.set(mesh, state);\n\t}\n\treturn state;\n}\n\n// Groups live on the geometry, and a cached geometry can back two meshes at once (two identical\n// branches), so a mesh gets its own geometry over the same attributes before writing any.\nfunction ownGeometry(mesh: THREE.Mesh): THREE.BufferGeometry {\n\tconst shared = mesh.geometry;\n\tif (!isCachedGeometry(shared)) return shared;\n\n\tconst own = new THREE.BufferGeometry();\n\town.setIndex(shared.index);\n\tfor (const [name, attribute] of Object.entries(shared.attributes))\n\t\town.setAttribute(name, attribute);\n\town.boundingBox = shared.boundingBox?.clone() ?? null;\n\town.boundingSphere = shared.boundingSphere?.clone() ?? null;\n\tborrowGeometry(own, shared);\n\tmesh.geometry = own;\n\treturn own;\n}\n\nfunction rebuild(mesh: THREE.Mesh, windows: Required<MemberWindow>[], state: DrawState): void {\n\tconst geometry = ownGeometry(mesh);\n\tgeometry.clearGroups();\n\n\tconst { selection, hover } = state;\n\tif (state.hidden.size === 0 && !selection && !hover) {\n\t\tmesh.material = state.base;\n\t\tstates.delete(mesh);\n\t\treturn;\n\t}\n\n\tconst materials = [state.base];\n\tconst selectionSlot = selection ? materials.push(selection.material) - 1 : 0;\n\tconst hoverSlot = hover ? materials.push(hover.material) - 1 : 0;\n\n\t// Coalesce neighbours with the same material, so hiding one member costs two draws, not N.\n\tlet runStart = -1;\n\tlet runEnd = 0;\n\tlet runMaterial = 0;\n\tconst flush = () => {\n\t\tif (runStart >= 0) geometry.addGroup(runStart, runEnd - runStart, runMaterial);\n\t\trunStart = -1;\n\t};\n\tfor (let i = 0; i < windows.length; i++) {\n\t\tif (state.hidden.has(i)) {\n\t\t\tflush();\n\t\t\tcontinue;\n\t\t}\n\t\tconst { indexStart, indexCount } = windows[i]!;\n\t\t// Selection wins, so pointing at a selected member doesn't make it look unselected.\n\t\tconst material = selection?.members.has(i)\n\t\t\t? selectionSlot\n\t\t\t: hover?.members.has(i)\n\t\t\t\t? hoverSlot\n\t\t\t\t: 0;\n\t\tif (runStart < 0 || material !== runMaterial || indexStart !== runEnd) {\n\t\t\tflush();\n\t\t\trunStart = indexStart;\n\t\t\trunMaterial = material;\n\t\t}\n\t\trunEnd = indexStart + indexCount;\n\t}\n\tflush();\n\n\tmesh.material = materials;\n}\n\nfunction update(mesh: THREE.Mesh, change: (state: DrawState) => void): void {\n\tconst windows = windowsOf(mesh);\n\tif (!windows) return;\n\tconst state = stateOf(mesh);\n\tchange(state);\n\trebuild(mesh, windows, state);\n\tlisteners.get(mesh)?.forEach((listener) => listener());\n}\n\n/** Members of `mesh` not drawn, by index into `userData.members`. */\nexport function getHiddenMembers(mesh: THREE.Mesh): ReadonlySet<number> {\n\treturn states.get(mesh)?.hidden ?? NONE;\n}\n\nexport function setHiddenMembers(mesh: THREE.Mesh, hidden: ReadonlySet<number>): void {\n\tconst current = getHiddenMembers(mesh);\n\tif (current.size === hidden.size && [...hidden].every((i) => current.has(i))) return;\n\tupdate(mesh, (state) => {\n\t\tstate.hidden = new Set(hidden);\n\t});\n}\n\n/** The material `mesh` draws with when nothing is highlighted. */\nexport function getBaseMaterial(mesh: THREE.Mesh): THREE.Material {\n\tconst material =\n\t\tstates.get(mesh)?.base ?? (Array.isArray(mesh.material) ? mesh.material[0]! : mesh.material);\n\treturn tintOrigins.get(material) ?? material;\n}\n\n/** A clone to tint and swap onto a mesh. `getBaseMaterial` keeps answering with `material`. */\nexport function cloneForTint(material: THREE.Material): THREE.Material {\n\tconst clone = material.clone();\n\ttintOrigins.set(clone, tintOrigins.get(material) ?? material);\n\treturn clone;\n}\n\n/** Draws `members` with `material`. The caller owns `material` and disposes it. */\nexport function setMemberHighlight(\n\tmesh: THREE.Mesh,\n\tmembers: ReadonlySet<number>,\n\tmaterial: THREE.Material,\n\tkind: HighlightKind = 'selection'\n): void {\n\tupdate(mesh, (state) => {\n\t\tstate[kind] = { members, material };\n\t});\n}\n\nexport function clearMemberHighlight(mesh: THREE.Mesh, kind: HighlightKind = 'selection'): void {\n\tif (!states.get(mesh)?.[kind]) return;\n\tupdate(mesh, (state) => {\n\t\tstate[kind] = null;\n\t});\n}\n\n/** Calls `listener` after the hidden set or highlight of `mesh` changes. Returns an unsubscribe. */\nexport function onMemberDrawChange(mesh: THREE.Mesh, listener: () => void): () => void {\n\tlet set = listeners.get(mesh);\n\tif (!set) listeners.set(mesh, (set = new Set()));\n\tset.add(listener);\n\treturn () => set.delete(listener);\n}\n"],"mappings":"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"}