@selvajs/visualization 1.6.0-beta.1 → 1.6.0-beta.11

package/dist/gpu-dispose-Cxu3dFmA.cjs

@@ -0,0 +1,469 @@
+const require_gpu_ownership = require("./gpu-ownership-ADRZBxxs.cjs");
+let three = require("three");
+three = require_gpu_ownership.__toESM(three, 1);
+// src/shared/errors.ts
+/**
+* Errors for the visualization package. Replaces `@selvajs/compute`'s `RhinoComputeError`, which
+* mis-named failures on paths (e.g. the plugin WebSocket) that never touch Rhino.Compute. `code`
+* values match compute's so existing catch-sites keep working.
+*/
+const ErrorCodes = {
+	/** Structural check failed: bad magic bytes, out-of-window index, malformed metadata. */
+	VALIDATION_ERROR: "VALIDATION_ERROR",
+	INVALID_STATE: "INVALID_STATE",
+	/** No `DecompressionStream`, no WebGL context, etc. */
+	ENVIRONMENT_ERROR: "ENVIRONMENT_ERROR",
+	INVALID_CONFIG: "INVALID_CONFIG",
+	/** Base64 input could not be decoded. */
+	ENCODING_ERROR: "ENCODING_ERROR",
+	UNKNOWN_ERROR: "UNKNOWN_ERROR"
+};
+var VisualizationError = class extends Error {
+	code;
+	context;
+	originalError;
+	constructor(message, code = ErrorCodes.UNKNOWN_ERROR, options) {
+		super(message);
+		this.name = "VisualizationError";
+		this.code = code;
+		this.context = options?.context;
+		this.originalError = options?.originalError;
+		if (options?.originalError) this.cause = options.originalError;
+	}
+};
+// src/shared/logger.ts
+/**
+* Logging facility for the visualization package. Deliberately local rather than imported from
+* `@selvajs/compute` (logging isn't a compute concern). Mirrors compute's logger shape so a host
+* wanting one sink for both can call `setLogger(computeLogger.getLogger())`.
+*/
+var NoOpLogger = class {
+	debug() {}
+	info() {}
+	warn() {}
+	error() {}
+};
+var ConsoleLogger = class {
+	debug(message, ...args) {
+		console.debug(message, ...args);
+	}
+	info(message, ...args) {
+		console.info(message, ...args);
+	}
+	warn(message, ...args) {
+		console.warn(message, ...args);
+	}
+	error(message, ...args) {
+		console.error(message, ...args);
+	}
+};
+let internalLogger = new NoOpLogger();
+function getLogger() {
+	return internalLogger;
+}
+function setLogger(logger) {
+	if (logger === null) {
+		internalLogger = new NoOpLogger();
+		return;
+	}
+	const missing = [
+		"debug",
+		"info",
+		"warn",
+		"error"
+	].filter((method) => typeof logger[method] !== "function");
+	if (missing.length > 0) throw new VisualizationError(`Logger is missing required method(s): ${missing.join(", ")}. A logger must implement debug, info, warn and error.`, ErrorCodes.INVALID_CONFIG, { context: { missingMethods: missing } });
+	internalLogger = logger;
+}
+function enableDebugLogging() {
+	setLogger(new ConsoleLogger());
+}
+// src/shared/looks.ts
+/** The look applied when the caller passes no `look` option. */
+const DEFAULT_LOOK = "technical";
+/**
+* Single source of truth for both `applyDefaults` (construction) and `setLook` (runtime), so the two
+* can't drift.
+*
+* Every shaded look pairs a key light with contact shading (GTAO), because image-based lighting on
+* its own lights all faces of a box nearly equally — the result is a white silhouette with no
+* readable form. GTAO is a full-screen pass and does cost frames; `xray` skips it since there are no
+* opaque contacts left to shade.
+*/
+const LOOK_PRESETS = {
+	studio: {
+		toneMapping: three.ACESFilmicToneMapping,
+		toneMappingExposure: 1,
+		envMapIntensity: 1,
+		environmentIntensity: .85,
+		hemisphereIntensity: .5,
+		ambientIntensity: .25,
+		cullBackfaces: false,
+		ambientOcclusion: true,
+		sunlightIntensity: 1.6
+	},
+	technical: {
+		toneMapping: three.NeutralToneMapping,
+		toneMappingExposure: 1,
+		envMapIntensity: .55,
+		environmentIntensity: .6,
+		hemisphereIntensity: .25,
+		ambientIntensity: .15,
+		cullBackfaces: false,
+		ambientOcclusion: true,
+		sunlightIntensity: 2.2
+	},
+	showcase: {
+		toneMapping: three.ACESFilmicToneMapping,
+		toneMappingExposure: 1.15,
+		envMapIntensity: 1.4,
+		environmentIntensity: 1,
+		hemisphereIntensity: .2,
+		ambientIntensity: .1,
+		cullBackfaces: false,
+		ambientOcclusion: true,
+		sunlightIntensity: 2.6
+	},
+	arctic: {
+		toneMapping: three.NeutralToneMapping,
+		toneMappingExposure: 1.05,
+		envMapIntensity: .85,
+		environmentIntensity: 1.1,
+		hemisphereIntensity: .3,
+		ambientIntensity: .15,
+		cullBackfaces: false,
+		ambientOcclusion: true,
+		sunlightIntensity: 2,
+		materialOverride: {
+			color: 15659509,
+			metalness: 0,
+			roughness: .75,
+			emissiveIntensity: 0
+		}
+	},
+	xray: {
+		toneMapping: three.NeutralToneMapping,
+		toneMappingExposure: 1.3,
+		envMapIntensity: .4,
+		environmentIntensity: .8,
+		hemisphereIntensity: .6,
+		ambientIntensity: .6,
+		cullBackfaces: false,
+		ambientOcclusion: false,
+		sunlightIntensity: .6,
+		materialOverride: {
+			color: 10470632,
+			metalness: 0,
+			roughness: .9,
+			emissiveIntensity: 0,
+			opacity: .28,
+			depthWrite: false,
+			side: three.DoubleSide
+		}
+	},
+	lineart: {
+		toneMapping: three.NeutralToneMapping,
+		toneMappingExposure: 1,
+		envMapIntensity: 1,
+		environmentIntensity: 1,
+		hemisphereIntensity: .6,
+		ambientIntensity: 3.2,
+		cullBackfaces: false,
+		ambientOcclusion: false,
+		sunlightIntensity: 0,
+		requiresEdges: true,
+		materialOverride: {
+			color: 16251130,
+			metalness: 0,
+			roughness: 1,
+			emissiveIntensity: 0
+		}
+	},
+	night: {
+		toneMapping: three.ACESFilmicToneMapping,
+		toneMappingExposure: 1,
+		envMapIntensity: .32,
+		environmentIntensity: .15,
+		hemisphereIntensity: .26,
+		ambientIntensity: .05,
+		cullBackfaces: false,
+		ambientOcclusion: true,
+		sunlightIntensity: .14,
+		background: 658962,
+		bloom: {
+			strength: .2,
+			radius: .3,
+			threshold: 1.8
+		},
+		emissiveLights: true,
+		lowPower: {
+			ambientOcclusion: false,
+			bloom: void 0,
+			maxEmissiveLights: 1,
+			maxPixelRatio: 1.5
+		}
+	},
+	wireframe: {
+		toneMapping: three.NeutralToneMapping,
+		toneMappingExposure: 1,
+		envMapIntensity: 1,
+		environmentIntensity: 1,
+		hemisphereIntensity: .4,
+		ambientIntensity: 2,
+		cullBackfaces: false,
+		ambientOcclusion: false,
+		sunlightIntensity: 0,
+		materialOverride: {
+			color: 2830648,
+			metalness: 0,
+			roughness: 1,
+			emissiveIntensity: 0,
+			wireframe: true,
+			side: three.DoubleSide
+		}
+	}
+};
+/** A look's preset, with its `lowPower` fields applied on a low-power device. */
+function lookPreset(look, lowPower = false) {
+	const preset = LOOK_PRESETS[look];
+	return lowPower ? {
+		...preset,
+		...preset.lowPower
+	} : preset;
+}
+/** `userData` key marking a material whose emission came from the wire, not from a selection tint. */
+const OWN_EMISSIVE = "selvaEmissive";
+/** `userData` key holding the light a material casts, from real lumens rather than its look. */
+const EMISSIVE_LIGHT = "selvaEmissiveLight";
+/**
+* `userData` key holding a material's own `envMapIntensity`, set by the parser when the wire
+* material carries one. `setLook` keeps it instead of the look's value, except in looks with a
+* `materialOverride`: those restyle every mesh alike, so the look's value wins there.
+*/
+const OWN_ENV_MAP_INTENSITY = "selvaEnvMapIntensity";
+/**
+* A look dims `envMapIntensity` to turn down fill, but three scales a material's diffuse and
+* specular IBL together. A metal has no diffuse, so the same dimming would only take away its
+* reflection, which is all a metal shows. Blending toward 1 by metalness keeps a dielectric's fill
+* on the look and a metal's reflection the same in every look.
+*/
+function lookEnvMapIntensity(lookValue, metalness) {
+	return lookValue + (1 - lookValue) * Math.min(1, Math.max(0, metalness));
+}
+/** Baked at parse time (not toggleable at runtime). */
+function materialAppearanceForLook(look) {
+	const preset = LOOK_PRESETS[look];
+	return {
+		envMapIntensity: preset.envMapIntensity,
+		cullBackfaces: preset.cullBackfaces
+	};
+}
+// src/shared/geometry.ts
+function parseColor(colorString) {
+	if (!colorString || typeof colorString !== "string") {
+		getLogger().warn(`Invalid color input: ${colorString}, using white`);
+		return new three.Color(16777215);
+	}
+	const trimmed = colorString.trim();
+	if (/^#?[0-9A-Fa-f]{6}$/.test(trimmed)) try {
+		const hex = trimmed.startsWith("#") ? trimmed : `#${trimmed}`;
+		return new three.Color(hex);
+	} catch {
+		getLogger().warn(`Invalid hex color: ${colorString}, using white`);
+		return new three.Color(16777215);
+	}
+	if (trimmed.includes(",")) {
+		const rgb = trimmed.split(",").map((c) => parseInt(c.trim(), 10));
+		if (rgb.length === 3 && rgb.every((n) => !isNaN(n) && n >= 0 && n <= 255)) return new three.Color(rgb[0] / 255, rgb[1] / 255, rgb[2] / 255);
+	}
+	const named = trimmed.toLowerCase();
+	if (named in three.Color.NAMES) return new three.Color(three.Color.NAMES[named]);
+	getLogger().warn(`Invalid color string: ${colorString}, using white`);
+	return new three.Color(16777215);
+}
+/** Defaults to `z` (Rhino's up axis); pass an explicit axis when the scene uses a different `sceneUp`. */
+function applyOffset(meshes, offset, axis = "z") {
+	meshes.forEach((mesh) => {
+		mesh.position[axis] -= offset;
+	});
+}
+function computeCombinedBoundingBox(meshes) {
+	const combinedBoundingBox = new three.Box3();
+	if (meshes.length === 0) return combinedBoundingBox;
+	meshes.forEach((mesh) => {
+		mesh.updateMatrixWorld(true);
+		const bbox = new three.Box3().setFromObject(mesh);
+		combinedBoundingBox.union(bbox);
+	});
+	return combinedBoundingBox;
+}
+// src/shared/gpu-capabilities.ts
+const observers = /* @__PURE__ */ new Set();
+let maxAnisotropy = 1;
+function publishMaxAnisotropy(value) {
+	const next = Math.max(1, value);
+	if (next === maxAnisotropy) return;
+	maxAnisotropy = next;
+	for (const observe of observers) observe(next);
+}
+/** Fires immediately with the current value (1 until a renderer has reported), then on every change. */
+function observeMaxAnisotropy(observe) {
+	observers.add(observe);
+	observe(maxAnisotropy);
+	return () => observers.delete(observe);
+}
+// src/shared/gpu-dispose.ts
+/** Frees a material and its textures, respecting ownership (`./gpu-ownership.ts`). */
+function disposeMaterial(material) {
+	if (!require_gpu_ownership.canDisposeMaterial(material)) return;
+	for (const [key, value] of Object.entries(material)) {
+		if (key === "envMap") continue;
+		if (value instanceof three.Texture) value.dispose();
+	}
+	material.dispose();
+}
+function disposeMaterials(material) {
+	if (!material) return;
+	if (Array.isArray(material)) material.forEach(disposeMaterial);
+	else disposeMaterial(material);
+}
+/**
+* Frees the GPU resources of an object subtree, respecting ownership. **The only traversal that
+* should dispose scene content** — a second disposing `traverse` risks missing an ownership guard.
+*/
+function disposeObjectTree(root, options = {}) {
+	const { materials = true, keepUploaded } = options;
+	root.traverse((object) => {
+		const renderable = object;
+		if (!renderable.geometry && !renderable.material) return;
+		if (renderable.geometry) disposeGeometry(renderable.geometry, keepUploaded);
+		if (materials) disposeMaterials(renderable.material);
+	});
+}
+function disposeGeometry(geometry, keepUploaded) {
+	const source = require_gpu_ownership.cachedSourceOf(geometry);
+	if (source !== geometry) {
+		if (source) {
+			geometry.setIndex(null);
+			for (const name of Object.keys(geometry.attributes)) geometry.deleteAttribute(name);
+		}
+		geometry.dispose();
+	}
+	if (source && keepUploaded && !keepUploaded.has(source)) source.dispose();
+}
+Object.defineProperty(exports, "DEFAULT_LOOK", {
+	enumerable: true,
+	get: function() {
+		return DEFAULT_LOOK;
+	}
+});
+Object.defineProperty(exports, "EMISSIVE_LIGHT", {
+	enumerable: true,
+	get: function() {
+		return EMISSIVE_LIGHT;
+	}
+});
+Object.defineProperty(exports, "ErrorCodes", {
+	enumerable: true,
+	get: function() {
+		return ErrorCodes;
+	}
+});
+Object.defineProperty(exports, "LOOK_PRESETS", {
+	enumerable: true,
+	get: function() {
+		return LOOK_PRESETS;
+	}
+});
+Object.defineProperty(exports, "OWN_EMISSIVE", {
+	enumerable: true,
+	get: function() {
+		return OWN_EMISSIVE;
+	}
+});
+Object.defineProperty(exports, "OWN_ENV_MAP_INTENSITY", {
+	enumerable: true,
+	get: function() {
+		return OWN_ENV_MAP_INTENSITY;
+	}
+});
+Object.defineProperty(exports, "VisualizationError", {
+	enumerable: true,
+	get: function() {
+		return VisualizationError;
+	}
+});
+Object.defineProperty(exports, "applyOffset", {
+	enumerable: true,
+	get: function() {
+		return applyOffset;
+	}
+});
+Object.defineProperty(exports, "computeCombinedBoundingBox", {
+	enumerable: true,
+	get: function() {
+		return computeCombinedBoundingBox;
+	}
+});
+Object.defineProperty(exports, "disposeObjectTree", {
+	enumerable: true,
+	get: function() {
+		return disposeObjectTree;
+	}
+});
+Object.defineProperty(exports, "enableDebugLogging", {
+	enumerable: true,
+	get: function() {
+		return enableDebugLogging;
+	}
+});
+Object.defineProperty(exports, "getLogger", {
+	enumerable: true,
+	get: function() {
+		return getLogger;
+	}
+});
+Object.defineProperty(exports, "lookEnvMapIntensity", {
+	enumerable: true,
+	get: function() {
+		return lookEnvMapIntensity;
+	}
+});
+Object.defineProperty(exports, "lookPreset", {
+	enumerable: true,
+	get: function() {
+		return lookPreset;
+	}
+});
+Object.defineProperty(exports, "materialAppearanceForLook", {
+	enumerable: true,
+	get: function() {
+		return materialAppearanceForLook;
+	}
+});
+Object.defineProperty(exports, "observeMaxAnisotropy", {
+	enumerable: true,
+	get: function() {
+		return observeMaxAnisotropy;
+	}
+});
+Object.defineProperty(exports, "parseColor", {
+	enumerable: true,
+	get: function() {
+		return parseColor;
+	}
+});
+Object.defineProperty(exports, "publishMaxAnisotropy", {
+	enumerable: true,
+	get: function() {
+		return publishMaxAnisotropy;
+	}
+});
+Object.defineProperty(exports, "setLogger", {
+	enumerable: true,
+	get: function() {
+		return setLogger;
+	}
+});
+
+//# sourceMappingURL=gpu-dispose-Cxu3dFmA.cjs.map

package/dist/gpu-dispose-Cxu3dFmA.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"gpu-dispose-Cxu3dFmA.cjs","names":["THREE","THREE","canDisposeMaterial","THREE","cachedSourceOf"],"sources":["../src/shared/errors.ts","../src/shared/logger.ts","../src/shared/looks.ts","../src/shared/geometry.ts","../src/shared/gpu-capabilities.ts","../src/shared/gpu-dispose.ts"],"sourcesContent":["/**\n * Errors for the visualization package. Replaces `@selvajs/compute`'s `RhinoComputeError`, which\n * mis-named failures on paths (e.g. the plugin WebSocket) that never touch Rhino.Compute. `code`\n * values match compute's so existing catch-sites keep working.\n */\n\nexport const ErrorCodes = {\n\t/** Structural check failed: bad magic bytes, out-of-window index, malformed metadata. */\n\tVALIDATION_ERROR: 'VALIDATION_ERROR',\n\tINVALID_STATE: 'INVALID_STATE',\n\t/** No `DecompressionStream`, no WebGL context, etc. */\n\tENVIRONMENT_ERROR: 'ENVIRONMENT_ERROR',\n\tINVALID_CONFIG: 'INVALID_CONFIG',\n\t/** Base64 input could not be decoded. */\n\tENCODING_ERROR: 'ENCODING_ERROR',\n\tUNKNOWN_ERROR: 'UNKNOWN_ERROR'\n} as const;\n\nexport type ErrorCode = (typeof ErrorCodes)[keyof typeof ErrorCodes];\n\nexport class VisualizationError extends Error {\n\tpublic readonly code: ErrorCode;\n\tpublic readonly context?: Record<string, unknown>;\n\tpublic readonly originalError?: Error;\n\n\tconstructor(\n\t\tmessage: string,\n\t\tcode: ErrorCode = ErrorCodes.UNKNOWN_ERROR,\n\t\toptions?: { context?: Record<string, unknown>; originalError?: Error }\n\t) {\n\t\tsuper(message);\n\t\tthis.name = 'VisualizationError';\n\t\tthis.code = code;\n\t\tthis.context = options?.context;\n\t\tthis.originalError = options?.originalError;\n\t\tif (options?.originalError) {\n\t\t\t(this as { cause?: unknown }).cause = options.originalError;\n\t\t}\n\t}\n}\n","/**\n * Logging facility for the visualization package. Deliberately local rather than imported from\n * `@selvajs/compute` (logging isn't a compute concern). Mirrors compute's logger shape so a host\n * wanting one sink for both can call `setLogger(computeLogger.getLogger())`.\n */\n\nimport { VisualizationError, ErrorCodes } from './errors.js';\n\nexport interface Logger {\n\tdebug(message: string, ...args: unknown[]): void;\n\tinfo(message: string, ...args: unknown[]): void;\n\twarn(message: string, ...args: unknown[]): void;\n\terror(message: string, ...args: unknown[]): void;\n}\n\nclass NoOpLogger implements Logger {\n\tdebug(): void {}\n\tinfo(): void {}\n\twarn(): void {}\n\terror(): void {}\n}\n\nclass ConsoleLogger implements Logger {\n\tdebug(message: string, ...args: unknown[]): void {\n\t\t// eslint-disable-next-line no-console -- this class exists to be the console sink\n\t\tconsole.debug(message, ...args);\n\t}\n\n\tinfo(message: string, ...args: unknown[]): void {\n\t\tconsole.info(message, ...args);\n\t}\n\n\twarn(message: string, ...args: unknown[]): void {\n\t\tconsole.warn(message, ...args);\n\t}\n\n\terror(message: string, ...args: unknown[]): void {\n\t\tconsole.error(message, ...args);\n\t}\n}\n\n// Defaults to no-op: a library that writes to the console uninvited is a nuisance in a host with\n// its own logging. Opt in with setLogger or enableDebugLogging.\nlet internalLogger: Logger = new NoOpLogger();\n\n// Call per-use rather than caching — the sink is settable at any time.\nexport function getLogger(): Logger {\n\treturn internalLogger;\n}\n\n// Validates logger shape up front: failing here beats a confusing \"getLogger().debug is not a\n// function\" at some later, unrelated call site.\nexport function setLogger(logger: Logger | Console | null): void {\n\tif (logger === null) {\n\t\tinternalLogger = new NoOpLogger();\n\t\treturn;\n\t}\n\n\tconst missing = (['debug', 'info', 'warn', 'error'] as const).filter(\n\t\t(method) => typeof (logger as unknown as Record<string, unknown>)[method] !== 'function'\n\t);\n\tif (missing.length > 0) {\n\t\tthrow new VisualizationError(\n\t\t\t`Logger is missing required method(s): ${missing.join(', ')}. A logger must implement debug, info, warn and error.`,\n\t\t\tErrorCodes.INVALID_CONFIG,\n\t\t\t{ context: { missingMethods: missing } }\n\t\t);\n\t}\n\n\tinternalLogger = logger as Logger;\n}\n\nexport function enableDebugLogging(): void {\n\tsetLogger(new ConsoleLogger());\n}\n","import * as THREE from 'three';\n\nimport type { Look, LookPreset, MaterialAppearanceOptions } from './types.js';\n\n/** The look applied when the caller passes no `look` option. */\nexport const DEFAULT_LOOK: Look = 'technical';\n\n/**\n * Single source of truth for both `applyDefaults` (construction) and `setLook` (runtime), so the two\n * can't drift.\n *\n * Every shaded look pairs a key light with contact shading (GTAO), because image-based lighting on\n * its own lights all faces of a box nearly equally — the result is a white silhouette with no\n * readable form. GTAO is a full-screen pass and does cost frames; `xray` skips it since there are no\n * opaque contacts left to shade.\n */\nexport const LOOK_PRESETS: Record<Look, LookPreset> = {\n\t// Fills shadows in (vs. showcase, which lets them fall off), but still key-lit: ACES plus a\n\t// moderate sun, with fill high enough that shadowed faces keep detail.\n\tstudio: {\n\t\ttoneMapping: THREE.ACESFilmicToneMapping,\n\t\ttoneMappingExposure: 1,\n\t\tenvMapIntensity: 1.0,\n\t\tenvironmentIntensity: 0.85,\n\t\themisphereIntensity: 0.5,\n\t\tambientIntensity: 0.25,\n\t\tcullBackfaces: false,\n\t\tambientOcclusion: true,\n\t\tsunlightIntensity: 1.6\n\t},\n\t// The sun carries this look and the ambient/IBL only lift shadows off black. Fill was the thing\n\t// making it read as flat white paper: every source except the sun is orientation-independent, so\n\t// the more of them you stack the less the three faces of a corner differ.\n\ttechnical: {\n\t\ttoneMapping: THREE.NeutralToneMapping,\n\t\ttoneMappingExposure: 1,\n\t\tenvMapIntensity: 0.55,\n\t\tenvironmentIntensity: 0.6,\n\t\themisphereIntensity: 0.25,\n\t\tambientIntensity: 0.15,\n\t\tcullBackfaces: false,\n\t\tambientOcclusion: true,\n\t\tsunlightIntensity: 2.2\n\t},\n\t// Fill pulled furthest DOWN and the sun pushed hardest, so light-to-shadow falloff is steepest —\n\t// a dramatic hero shot, unlike `studio` which fills shadows back in.\n\tshowcase: {\n\t\ttoneMapping: THREE.ACESFilmicToneMapping,\n\t\ttoneMappingExposure: 1.15,\n\t\tenvMapIntensity: 1.4,\n\t\tenvironmentIntensity: 1.0,\n\t\themisphereIntensity: 0.2,\n\t\tambientIntensity: 0.1,\n\t\tcullBackfaces: false,\n\t\tambientOcclusion: true,\n\t\tsunlightIntensity: 2.6\n\t},\n\t// Every mesh forced to one near-white clay, so form and shadow carry the image instead of the\n\t// model's own colours. AO on: with all albedo differences gone, contact shading is the only thing\n\t// left separating touching parts — without it the model reads as one white blob.\n\tarctic: {\n\t\ttoneMapping: THREE.NeutralToneMapping,\n\t\ttoneMappingExposure: 1.05,\n\t\tenvMapIntensity: 0.85,\n\t\tenvironmentIntensity: 1.1,\n\t\themisphereIntensity: 0.3,\n\t\tambientIntensity: 0.15,\n\t\tcullBackfaces: false,\n\t\tambientOcclusion: true,\n\t\tsunlightIntensity: 2.0,\n\t\tmaterialOverride: {\n\t\t\tcolor: 0xeef1f5,\n\t\t\tmetalness: 0,\n\t\t\troughness: 0.75,\n\t\t\temissiveIntensity: 0\n\t\t}\n\t},\n\t// See-through blue-white with depth writes off, so interior geometry shows through the shell.\n\t// Exposure pushed up because stacked transparent layers darken fast; the sun is dialled back\n\t// because a hard highlight on a transparent shell hides what is behind it.\n\txray: {\n\t\ttoneMapping: THREE.NeutralToneMapping,\n\t\ttoneMappingExposure: 1.3,\n\t\tenvMapIntensity: 0.4,\n\t\tenvironmentIntensity: 0.8,\n\t\themisphereIntensity: 0.6,\n\t\tambientIntensity: 0.6,\n\t\tcullBackfaces: false,\n\t\tambientOcclusion: false,\n\t\tsunlightIntensity: 0.6,\n\t\tmaterialOverride: {\n\t\t\tcolor: 0x9fc4e8,\n\t\t\tmetalness: 0,\n\t\t\troughness: 0.9,\n\t\t\temissiveIntensity: 0,\n\t\t\topacity: 0.28,\n\t\t\tdepthWrite: false,\n\t\t\tside: THREE.DoubleSide\n\t\t}\n\t},\n\t// The architectural line drawing: feature edges over flat white faces. The faces are the whole\n\t// point even though you never really see them — they still write depth, so a near member hides\n\t// the ones behind it. True wireframe can't do that, and on a dense frame (thousands of members,\n\t// every edge of every one drawn at once) it collapses into a black mass.\n\t//\n\t// Unlit on purpose: any directional shading would compete with the lines for the eye. Ambient\n\t// alone lands every face on the same flat white, so the only contrast in the image is the edges.\n\t// AO is off for the same reason — a grey contact smear under a line drawing just muddies it.\n\tlineart: {\n\t\ttoneMapping: THREE.NeutralToneMapping,\n\t\ttoneMappingExposure: 1,\n\t\t// The faces are MeshPhysicalMaterial, so they take their brightness from lighting, not from\n\t\t// `color`: zero out the lights and they render black however white the override is. Hemisphere\n\t\t// and ambient carry it rather than IBL, because `scene.environment` only exists if the host\n\t\t// loaded an HDR — leaning on IBL would render this look black in any viewer without one. Both\n\t\t// are orientation-independent, so every face lands on the same flat white and the edges stay\n\t\t// the only contrast in the image. Ambient is weighted over hemisphere because hemisphere's\n\t\t// ground colour is a warm brown by default: leaning on it tints every downward face grey and\n\t\t// the drawing stops reading as one flat white.\n\t\tenvMapIntensity: 1.0,\n\t\tenvironmentIntensity: 1.0,\n\t\themisphereIntensity: 0.6,\n\t\tambientIntensity: 3.2,\n\t\tcullBackfaces: false,\n\t\tambientOcclusion: false,\n\t\tsunlightIntensity: 0,\n\t\trequiresEdges: true,\n\t\tmaterialOverride: {\n\t\t\tcolor: 0xf7f8fa,\n\t\t\tmetalness: 0,\n\t\t\troughness: 1,\n\t\t\temissiveIntensity: 0\n\t\t}\n\t},\n\t// Triangle edges only — the tessellation itself, diagonals and all. That makes it a mesh-\n\t// inspection tool, not a drawing: for a readable line drawing use `lineart`, which draws\n\t// feature edges and lets near faces occlude far ones. Nothing here is a lit surface:\n\t// the sun is off and fill carries the image, because a directional light on a line renders it\n\t// black wherever the line runs away from the key. AO is off for the same reason — a full-screen\n\t// contact pass has no contacts to find between wires, and it only costs frames.\n\t// After dark: the only real light comes from what the model emits, so a lamp lights its desk.\n\t// A little sky stays so the unlit half of the model keeps its shape instead of going black.\n\tnight: {\n\t\ttoneMapping: THREE.ACESFilmicToneMapping,\n\t\ttoneMappingExposure: 1,\n\t\tenvMapIntensity: 0.32,\n\t\tenvironmentIntensity: 0.15,\n\t\themisphereIntensity: 0.26,\n\t\tambientIntensity: 0.05,\n\t\tcullBackfaces: false,\n\t\tambientOcclusion: true,\n\t\tsunlightIntensity: 0.14,\n\t\tbackground: 0x0a0e12,\n\t\t// Above what the environment reaches on polished metal, so only emitters glow.\n\t\tbloom: { strength: 0.2, radius: 0.3, threshold: 1.8 },\n\t\temissiveLights: true,\n\t\t// Full-screen passes are the cost here: AO alone takes a quarter of the frame on an integrated\n\t\t// GPU, and without it there is no composer. A bounce light costs next to nothing and is all\n\t\t// that lights the room outside the shade, so one stays with its key.\n\t\tlowPower: {\n\t\t\tambientOcclusion: false,\n\t\t\tbloom: undefined,\n\t\t\tmaxEmissiveLights: 1,\n\t\t\tmaxPixelRatio: 1.5\n\t\t}\n\t},\n\twireframe: {\n\t\ttoneMapping: THREE.NeutralToneMapping,\n\t\ttoneMappingExposure: 1,\n\t\t// Lit for the same reason as lineart (see there): PBR lines are black unlit, and hemisphere\n\t\t// plus ambient work with no HDR loaded. Dimmer than lineart because these lines are dark\n\t\t// on white, not white on dark.\n\t\tenvMapIntensity: 1.0,\n\t\tenvironmentIntensity: 1.0,\n\t\themisphereIntensity: 0.4,\n\t\tambientIntensity: 2.0,\n\t\tcullBackfaces: false,\n\t\tambientOcclusion: false,\n\t\tsunlightIntensity: 0,\n\t\tmaterialOverride: {\n\t\t\tcolor: 0x2b3138,\n\t\t\tmetalness: 0,\n\t\t\troughness: 1,\n\t\t\temissiveIntensity: 0,\n\t\t\twireframe: true,\n\t\t\tside: THREE.DoubleSide\n\t\t}\n\t}\n};\n\n/** A look's preset, with its `lowPower` fields applied on a low-power device. */\nexport function lookPreset(look: Look, lowPower = false): LookPreset {\n\tconst preset = LOOK_PRESETS[look];\n\treturn lowPower ? { ...preset, ...preset.lowPower } : preset;\n}\n\n/** `userData` key marking a material whose emission came from the wire, not from a selection tint. */\nexport const OWN_EMISSIVE = 'selvaEmissive';\n\n/** `userData` key holding the light a material casts, from real lumens rather than its look. */\nexport const EMISSIVE_LIGHT = 'selvaEmissiveLight';\n\n/**\n * `userData` key holding a material's own `envMapIntensity`, set by the parser when the wire\n * material carries one. `setLook` keeps it instead of the look's value, except in looks with a\n * `materialOverride`: those restyle every mesh alike, so the look's value wins there.\n */\nexport const OWN_ENV_MAP_INTENSITY = 'selvaEnvMapIntensity';\n\n/**\n * A look dims `envMapIntensity` to turn down fill, but three scales a material's diffuse and\n * specular IBL together. A metal has no diffuse, so the same dimming would only take away its\n * reflection, which is all a metal shows. Blending toward 1 by metalness keeps a dielectric's fill\n * on the look and a metal's reflection the same in every look.\n */\nexport function lookEnvMapIntensity(lookValue: number, metalness: number): number {\n\treturn lookValue + (1 - lookValue) * Math.min(1, Math.max(0, metalness));\n}\n\n/** Baked at parse time (not toggleable at runtime). */\nexport function materialAppearanceForLook(look: Look): MaterialAppearanceOptions {\n\tconst preset = LOOK_PRESETS[look];\n\treturn {\n\t\tenvMapIntensity: preset.envMapIntensity,\n\t\tcullBackfaces: preset.cullBackfaces\n\t};\n}\n","import * as THREE from 'three';\n\nimport { getLogger } from './logger.js';\n\n// parse/ needs these and must never import upward from render/, so they live in shared/ instead\n// of render's three-helpers.\n\nexport function parseColor(colorString: string): THREE.Color {\n\tif (!colorString || typeof colorString !== 'string') {\n\t\tgetLogger().warn(`Invalid color input: ${colorString}, using white`);\n\t\treturn new THREE.Color(0xffffff);\n\t}\n\n\tconst trimmed = colorString.trim();\n\n\tif (/^#?[0-9A-Fa-f]{6}$/.test(trimmed)) {\n\t\ttry {\n\t\t\tconst hex = trimmed.startsWith('#') ? trimmed : `#${trimmed}`;\n\t\t\treturn new THREE.Color(hex);\n\t\t} catch {\n\t\t\tgetLogger().warn(`Invalid hex color: ${colorString}, using white`);\n\t\t\treturn new THREE.Color(0xffffff);\n\t\t}\n\t}\n\n\tif (trimmed.includes(',')) {\n\t\tconst rgb = trimmed.split(',').map((c) => parseInt(c.trim(), 10));\n\t\tif (rgb.length === 3 && rgb.every((n) => !isNaN(n) && n >= 0 && n <= 255)) {\n\t\t\treturn new THREE.Color(rgb[0] / 255, rgb[1] / 255, rgb[2] / 255);\n\t\t}\n\t}\n\n\t// `new THREE.Color(name)` never throws on unknown names (it logs its own warning and leaves the\n\t// color white), so validate against three's CSS name table instead.\n\tconst named = trimmed.toLowerCase();\n\tif (named in THREE.Color.NAMES) {\n\t\treturn new THREE.Color(THREE.Color.NAMES[named as keyof typeof THREE.Color.NAMES]);\n\t}\n\n\tgetLogger().warn(`Invalid color string: ${colorString}, using white`);\n\treturn new THREE.Color(0xffffff);\n}\n\n/** Defaults to `z` (Rhino's up axis); pass an explicit axis when the scene uses a different `sceneUp`. */\nexport function applyOffset(\n\tmeshes: THREE.Object3D[],\n\toffset: number,\n\taxis: 'x' | 'y' | 'z' = 'z'\n): void {\n\tmeshes.forEach((mesh) => {\n\t\tmesh.position[axis] -= offset;\n\t});\n}\n\nexport function computeCombinedBoundingBox(meshes: THREE.Object3D[]): THREE.Box3 {\n\tconst combinedBoundingBox = new THREE.Box3();\n\tif (meshes.length === 0) return combinedBoundingBox;\n\tmeshes.forEach((mesh) => {\n\t\tmesh.updateMatrixWorld(true);\n\t\tconst bbox = new THREE.Box3().setFromObject(mesh);\n\t\tcombinedBoundingBox.union(bbox);\n\t});\n\treturn combinedBoundingBox;\n}\n","// ============================================================================\n// GPU capabilities — published by the renderer, read by whoever needs them\n// ============================================================================\n\n// Lets a renderer publish GPU capabilities (max anisotropy) without `render/` and `parse/` importing\n// each other: the renderer publishes on init, interested parties subscribe.\n\ntype AnisotropyObserver = (value: number) => void;\n\nconst observers = new Set<AnisotropyObserver>();\n\n// Module load order between layers isn't guaranteed, so a subscriber arriving after init still\n// needs the current value rather than waiting for a second renderer to publish.\nlet maxAnisotropy = 1;\n\nexport function publishMaxAnisotropy(value: number): void {\n\tconst next = Math.max(1, value);\n\tif (next === maxAnisotropy) return;\n\tmaxAnisotropy = next;\n\tfor (const observe of observers) observe(next);\n}\n\n/** Fires immediately with the current value (1 until a renderer has reported), then on every change. */\nexport function observeMaxAnisotropy(observe: AnisotropyObserver): () => void {\n\tobservers.add(observe);\n\tobserve(maxAnisotropy);\n\treturn () => observers.delete(observe);\n}\n","import * as THREE from 'three';\n\nimport { cachedSourceOf, canDisposeMaterial } from './gpu-ownership.js';\n\n// ============================================================================\n// The disposal walkers — every teardown path in the package goes through these\n// ============================================================================\n\n/** Frees a material and its textures, respecting ownership (`./gpu-ownership.ts`). */\nexport function disposeMaterial(material: THREE.Material): void {\n\tif (!canDisposeMaterial(material)) return;\n\n\tfor (const [key, value] of Object.entries(material)) {\n\t\t// An envMap is the scene's, shared by every metal: freeing it here would blank them all.\n\t\tif (key === 'envMap') continue;\n\t\tif (value instanceof THREE.Texture) {\n\t\t\tvalue.dispose();\n\t\t}\n\t}\n\tmaterial.dispose();\n}\n\nfunction disposeMaterials(material: THREE.Material | THREE.Material[] | undefined): void {\n\tif (!material) return;\n\tif (Array.isArray(material)) material.forEach(disposeMaterial);\n\telse disposeMaterial(material);\n}\n\nexport interface DisposeOptions {\n\t/** Free materials and their textures too. Default true; the solve memo passes false. */\n\tmaterials?: boolean;\n\t/** Called for each geometry before disposal, so a subsystem can free derived resources keyed on it (e.g. edge caches). */\n\tonGeometry?: (geometry: THREE.BufferGeometry) => void;\n\t/**\n\t * Cached geometries whose GPU copy survives. When given, every other cached geometry this walk\n\t * reaches loses its GPU copy.\n\t */\n\tkeepUploaded?: ReadonlySet<THREE.BufferGeometry>;\n}\n\n/**\n * Frees the GPU resources of an object subtree, respecting ownership. **The only traversal that\n * should dispose scene content** — a second disposing `traverse` risks missing an ownership guard.\n */\nexport function disposeObjectTree(root: THREE.Object3D, options: DisposeOptions = {}): void {\n\tconst { materials = true, keepUploaded } = options;\n\n\troot.traverse((object) => {\n\t\tconst renderable = object as Partial<THREE.Mesh> & THREE.Object3D;\n\t\tif (!renderable.geometry && !renderable.material) return;\n\n\t\tif (renderable.geometry) disposeGeometry(renderable.geometry, keepUploaded);\n\n\t\tif (materials) disposeMaterials(renderable.material);\n\t});\n}\n\nfunction disposeGeometry(\n\tgeometry: THREE.BufferGeometry,\n\tkeepUploaded: ReadonlySet<THREE.BufferGeometry> | undefined\n): void {\n\tconst source = cachedSourceOf(geometry);\n\tif (source !== geometry) {\n\t\t// three's dispose frees the GPU buffers of whatever attributes are attached, so a borrower\n\t\t// lets go of the cache's attributes first.\n\t\tif (source) {\n\t\t\tgeometry.setIndex(null);\n\t\t\tfor (const name of Object.keys(geometry.attributes)) geometry.deleteAttribute(name);\n\t\t}\n\t\tgeometry.dispose();\n\t}\n\tif (source && keepUploaded && !keepUploaded.has(source)) source.dispose();\n}\n"],"mappings":"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"}

package/dist/gpu-ownership-ADRZBxxs.cjs

@@ -0,0 +1,102 @@
+// \0rolldown/runtime.js
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+		key = keys[i];
+		if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
+			get: ((k) => from[k]).bind(null, key),
+			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+		});
+	}
+	return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule || !__hasOwnProp.call(mod, "default") ? __defProp(target, "default", {
+	value: mod,
+	enumerable: true
+}) : target, mod));
+// src/shared/gpu-ownership.ts
+/**
+* A GPU resource has exactly one owner: a **module singleton** (nobody ever frees it), a **cache**
+* (frees it on eviction) or the **scene** (freed on teardown). Every disposal path asks
+* {@link canDisposeMaterial} before freeing a material. Textures are always scene-owned.
+*
+* A cached geometry's data belongs to the cache, but its GPU copy lives only while a scene draws it.
+* Scene teardown resolves each geometry with {@link cachedSourceOf} and frees the GPU copy of every
+* cached geometry the next scene does not draw; three uploads it again if it comes back. A cached
+* geometry can back several meshes at once, so nothing may write to its arrays.
+*/
+const protectedMaterials = /* @__PURE__ */ new Set();
+/** True when `material` is scene-owned (not one of the protected singletons). */
+function canDisposeMaterial(material) {
+	if (!material) return false;
+	return !protectedMaterials.has(material);
+}
+const sharedGeometries = /* @__PURE__ */ new WeakSet();
+function shareGeometry(geometry) {
+	sharedGeometries.add(geometry);
+}
+function unshareGeometry(geometry) {
+	sharedGeometries.delete(geometry);
+}
+function isCachedGeometry(geometry) {
+	return sharedGeometries.has(geometry);
+}
+const borrowers = /* @__PURE__ */ new WeakMap();
+function borrowGeometry(borrower, source) {
+	borrowers.set(borrower, source);
+}
+/** The cached geometry whose GPU buffers `geometry` draws, or null when it owns its own. */
+function cachedSourceOf(geometry) {
+	if (sharedGeometries.has(geometry)) return geometry;
+	const source = borrowers.get(geometry);
+	return source && sharedGeometries.has(source) ? source : null;
+}
+Object.defineProperty(exports, "__toESM", {
+	enumerable: true,
+	get: function() {
+		return __toESM;
+	}
+});
+Object.defineProperty(exports, "borrowGeometry", {
+	enumerable: true,
+	get: function() {
+		return borrowGeometry;
+	}
+});
+Object.defineProperty(exports, "cachedSourceOf", {
+	enumerable: true,
+	get: function() {
+		return cachedSourceOf;
+	}
+});
+Object.defineProperty(exports, "canDisposeMaterial", {
+	enumerable: true,
+	get: function() {
+		return canDisposeMaterial;
+	}
+});
+Object.defineProperty(exports, "isCachedGeometry", {
+	enumerable: true,
+	get: function() {
+		return isCachedGeometry;
+	}
+});
+Object.defineProperty(exports, "shareGeometry", {
+	enumerable: true,
+	get: function() {
+		return shareGeometry;
+	}
+});
+Object.defineProperty(exports, "unshareGeometry", {
+	enumerable: true,
+	get: function() {
+		return unshareGeometry;
+	}
+});
+
+//# sourceMappingURL=gpu-ownership-ADRZBxxs.cjs.map

package/dist/gpu-ownership-ADRZBxxs.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"gpu-ownership-ADRZBxxs.cjs","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/gpu-ownership-Bs9l7hrU.js

@@ -0,0 +1,40 @@
+// src/shared/gpu-ownership.ts
+/**
+* A GPU resource has exactly one owner: a **module singleton** (nobody ever frees it), a **cache**
+* (frees it on eviction) or the **scene** (freed on teardown). Every disposal path asks
+* {@link canDisposeMaterial} before freeing a material. Textures are always scene-owned.
+*
+* A cached geometry's data belongs to the cache, but its GPU copy lives only while a scene draws it.
+* Scene teardown resolves each geometry with {@link cachedSourceOf} and frees the GPU copy of every
+* cached geometry the next scene does not draw; three uploads it again if it comes back. A cached
+* geometry can back several meshes at once, so nothing may write to its arrays.
+*/
+const protectedMaterials = /* @__PURE__ */ new Set();
+/** True when `material` is scene-owned (not one of the protected singletons). */
+function canDisposeMaterial(material) {
+	if (!material) return false;
+	return !protectedMaterials.has(material);
+}
+const sharedGeometries = /* @__PURE__ */ new WeakSet();
+function shareGeometry(geometry) {
+	sharedGeometries.add(geometry);
+}
+function unshareGeometry(geometry) {
+	sharedGeometries.delete(geometry);
+}
+function isCachedGeometry(geometry) {
+	return sharedGeometries.has(geometry);
+}
+const borrowers = /* @__PURE__ */ new WeakMap();
+function borrowGeometry(borrower, source) {
+	borrowers.set(borrower, source);
+}
+/** The cached geometry whose GPU buffers `geometry` draws, or null when it owns its own. */
+function cachedSourceOf(geometry) {
+	if (sharedGeometries.has(geometry)) return geometry;
+	const source = borrowers.get(geometry);
+	return source && sharedGeometries.has(source) ? source : null;
+}
+export { shareGeometry as a, isCachedGeometry as i, cachedSourceOf as n, unshareGeometry as o, canDisposeMaterial as r, borrowGeometry as t };
+
+//# sourceMappingURL=gpu-ownership-Bs9l7hrU.js.map