@tresjs/cientos 5.7.2 → 5.8.0

package/dist/trescientos.js

@@ -1,6 +1,6 @@
 /**
   * name: @tresjs/cientos
-  * version: v5.7.2
+  * version: v5.8.0
   * (c) 2026
   * description: Collection of useful helpers and fully functional, ready-made abstractions for Tres
   * author: Alvaro Saburido <hola@alvarosaburido.dev> (https://github.com/alvarosabu/)
@@ -8,7 +8,7 @@
 import { Fragment, Suspense, Transition, computed, createBlock, createCommentVNode, createElementBlock, createElementVNode, createTextVNode, createVNode, defineComponent, inject, isReactive, isRef, mergeDefaults, mergeProps, nextTick, normalizeClass, normalizeProps, normalizeStyle, onBeforeUnmount, onMounted, onUnmounted, openBlock, provide, reactive, ref, render, renderList, renderSlot, shallowReactive, shallowRef, toDisplayString, toRaw, toRefs, toValue, triggerRef, unref, useAttrs, useSlots, useTemplateRef, vShow, watch, watchEffect, withAsyncContext, withCtx, withDirectives, withModifiers } from "vue";
 import { buildGraph, createTimer, extend, isObject3D, logError, logWarning, normalizeColor, normalizeVectorFlexibleParam, useLoader, useLoop, useTres, useTresContext } from "@tresjs/core";
 import * as THREE from "three";
-import { AdditiveBlending, AlwaysStencilFunc, AnimationMixer, Audio, AudioListener, AudioLoader, BackSide, Box2, Box3, BoxGeometry, BufferAttribute, BufferGeometry, Camera, CatmullRomCurve3, ClampToEdgeWrapping, Color, CubeCamera, CubeReflectionMapping, CubeTextureLoader, CubicBezierCurve3, DataTexture, DefaultLoadingManager, DepthTexture, DirectionalLight, DoubleSide, EdgesGeometry, EqualStencilFunc, EquirectangularReflectionMapping, Euler, FloatType, FramebufferTexture, FrontSide, Group, HalfFloatType, IcosahedronGeometry, InstancedMesh, InterleavedBuffer, InterleavedBufferAttribute, KeepStencilOp, LOD, LinearFilter, MOUSE, MathUtils, Matrix4, Mesh, MeshBasicMaterial, MeshDepthMaterial, MeshLambertMaterial, MeshStandardMaterial, NearestFilter, NoBlending, NotEqualStencilFunc, Object3D, OrthographicCamera, PerspectiveCamera, Plane, PlaneGeometry, Points, PointsMaterial, QuadraticBezierCurve3, Quaternion, REVISION, RGBAFormat, RawShaderMaterial, Raycaster, RepeatWrapping, ReplaceStencilOp, Scene, ShaderChunk, ShaderMaterial, ShapeGeometry, SkinnedMesh, Sphere, Spherical, TOUCH, TangentSpaceNormalMap, Texture, TextureLoader, UVMapping, Uniform, UniformsUtils, UnsignedByteType, Vector2, Vector3, Vector4, VideoTexture, WebGLCubeRenderTarget, WebGLRenderTarget, WebGLRenderer } from "three";
+import { AdditiveBlending, AlwaysStencilFunc, AnimationMixer, Audio, AudioListener, AudioLoader, BackSide, Box2, Box3, BoxGeometry, BufferAttribute, BufferGeometry, Camera, CatmullRomCurve3, ClampToEdgeWrapping, Color, CubeCamera, CubeReflectionMapping, CubeTextureLoader, CubicBezierCurve3, DataTexture, DefaultLoadingManager, DepthTexture, DirectionalLight, DoubleSide, EdgesGeometry, EqualStencilFunc, EquirectangularReflectionMapping, Euler, FloatType, FramebufferTexture, FrontSide, Group, HalfFloatType, IcosahedronGeometry, InstancedMesh, InterleavedBuffer, InterleavedBufferAttribute, KeepStencilOp, LOD, LinearFilter, MOUSE, MathUtils, Matrix4, Mesh, MeshBasicMaterial, MeshDepthMaterial, MeshLambertMaterial, MeshPhysicalMaterial, MeshStandardMaterial, NearestFilter, NoBlending, NoToneMapping, NotEqualStencilFunc, Object3D, OrthographicCamera, PerspectiveCamera, Plane, PlaneGeometry, Points, PointsMaterial, QuadraticBezierCurve3, Quaternion, REVISION, RGBAFormat, RawShaderMaterial, Raycaster, RepeatWrapping, ReplaceStencilOp, Scene, ShaderChunk, ShaderMaterial, ShapeGeometry, SkinnedMesh, Sphere, Spherical, TOUCH, TangentSpaceNormalMap, Texture, TextureLoader, UVMapping, Uniform, UniformsUtils, UnsignedByteType, Vector2, Vector3, Vector4, VideoTexture, WebGLCubeRenderTarget, WebGLRenderTarget, WebGLRenderer } from "three";
 import { onKeyStroke, tryOnScopeDispose, useDebounceFn, useDraggable, useElementSize, useEventListener, useMagicKeys, useMouse, useResizeObserver, useScroll, useWindowScroll, useWindowSize, watchThrottled, whenever } from "@vueuse/core";
 import { DRACOLoader, DecalGeometry, FBXLoader, FontLoader, GLTFExporter, GLTFLoader, HorizontalBlurShader, Line2, LineGeometry, LineMaterial, MapControls, MarchingCubes, MeshSurfaceSampler, OrbitControls, PointerLockControls, PositionalAudioHelper, RGBELoader, Reflector, RoundedBoxGeometry, SVGLoader, SimplexNoise, Sky, TextGeometry, TransformControls, VerticalBlurShader, Water, toCreasedNormals } from "three-stdlib";
 import BaseCameraControls, { default as CameraControls } from "camera-controls";
@@ -1162,7 +1162,7 @@ function useDecalEditor() {
 
 //#endregion
 //#region src/core/abstractions/Decal/DecalItem.vue?vue&type=script&setup=true&lang.ts
-const _hoisted_1$62 = [
+const _hoisted_1$63 = [
 	"name",
 	"render-order",
 	"material-polygonOffsetFactor"
@@ -1389,7 +1389,7 @@ var DecalItem_vue_vue_type_script_setup_true_lang_default = /* @__PURE__ */ defi
 				color: __props.edgeColor,
 				"depth-test": false,
 				transparent: true
-			}, null, 8, _hoisted_3$9)], 8, _hoisted_2$31)) : createCommentVNode("v-if", true)], 40, _hoisted_1$62);
+			}, null, 8, _hoisted_3$9)], 8, _hoisted_2$31)) : createCommentVNode("v-if", true)], 40, _hoisted_1$63);
 		};
 	}
 });
@@ -1400,7 +1400,7 @@ var DecalItem_default = DecalItem_vue_vue_type_script_setup_true_lang_default;
 
 //#endregion
 //#region src/core/abstractions/Decal/DecalEditor.vue?vue&type=script&setup=true&lang.ts
-const _hoisted_1$61 = ["visible"];
+const _hoisted_1$62 = ["visible"];
 const DRAG_THRESHOLD_SQ = 25;
 var DecalEditor_vue_vue_type_script_setup_true_lang_default = /* @__PURE__ */ defineComponent({
 	__name: "DecalEditor",
@@ -1683,7 +1683,7 @@ var DecalEditor_vue_vue_type_script_setup_true_lang_default = /* @__PURE__ */ de
 				color: "#0000ff",
 				"depth-test": false,
 				transparent: true
-			}, null, -1)])], 8, _hoisted_1$61), renderSlot(_ctx.$slots, "default")], 64);
+			}, null, -1)])], 8, _hoisted_1$62), renderSlot(_ctx.$slots, "default")], 64);
 		};
 	}
 });
@@ -2141,7 +2141,7 @@ function getTextureLabel(tex) {
 
 //#endregion
 //#region src/core/abstractions/Decal/DebugUI/Handle.vue?vue&type=script&setup=true&lang.ts
-const _hoisted_1$60 = {
+const _hoisted_1$61 = {
 	class: "snap-vignette",
 	"aria-hidden": "true"
 };
@@ -2340,7 +2340,7 @@ var Handle_vue_vue_type_script_setup_true_lang_default = /* @__PURE__ */ defineC
 				style: normalizeStyle(innerStyle.value),
 				class: "handle-inner"
 			}, [
-				withDirectives(createElementVNode("div", _hoisted_1$60, null, 512), [[vShow, unref(isSnapEnabled)]]),
+				withDirectives(createElementVNode("div", _hoisted_1$61, null, 512), [[vShow, unref(isSnapEnabled)]]),
 				withDirectives((openBlock(), createElementBlock("svg", _hoisted_2$30, [(openBlock(true), createElementBlock(Fragment, null, renderList(snapTicks.value, (angle, i) => {
 					return openBlock(), createElementBlock("g", {
 						key: i,
@@ -2378,7 +2378,7 @@ var Handle_default = Handle_vue_vue_type_script_setup_true_lang_default;
 
 //#endregion
 //#region src/core/abstractions/Decal/DebugUI/Dock.vue?vue&type=script&setup=true&lang.ts
-const _hoisted_1$59 = {
+const _hoisted_1$60 = {
 	key: 0,
 	class: "dock"
 };
@@ -2555,7 +2555,7 @@ var Dock_vue_vue_type_script_setup_true_lang_default = /* @__PURE__ */ defineCom
 			return openBlock(), createElementBlock("div", { class: normalizeClass(["dock-stack", isVisible.value ? "is-visible" : ""]) }, [
 				createCommentVNode(" Top row: edit-only tools, slides in/out as edits start/end. "),
 				createVNode(Transition, { name: "edit-dock" }, {
-					default: withCtx(() => [isEditing.value && !isDraggingTexture.value ? (openBlock(), createElementBlock("div", _hoisted_1$59, [
+					default: withCtx(() => [isEditing.value && !isDraggingTexture.value ? (openBlock(), createElementBlock("div", _hoisted_1$60, [
 						createElementVNode("button", {
 							class: normalizeClass(["icon-btn", { "is-active": unref(isSnapEnabled) }]),
 							title: "Snap rotation (15°)",
@@ -2925,7 +2925,7 @@ var Dock_default = Dock_vue_vue_type_script_setup_true_lang_default;
 
 //#endregion
 //#region src/core/abstractions/Decal/DebugUI/LayerList.vue?vue&type=script&setup=true&lang.ts
-const _hoisted_1$58 = { class: "dock decal-list" };
+const _hoisted_1$59 = { class: "dock decal-list" };
 const _hoisted_2$28 = { class: "list-header" };
 const _hoisted_3$6 = { class: "list-header__count" };
 const _hoisted_4$4 = {
@@ -3095,7 +3095,7 @@ var LayerList_vue_vue_type_script_setup_true_lang_default = /* @__PURE__ */ defi
 			dragOverPosition.value = null;
 		}
 		return (_ctx, _cache) => {
-			return openBlock(), createElementBlock("div", _hoisted_1$58, [
+			return openBlock(), createElementBlock("div", _hoisted_1$59, [
 				createElementVNode("header", _hoisted_2$28, [_cache[2] || (_cache[2] = createElementVNode("span", { class: "list-header__title" }, "Layers", -1)), createElementVNode("span", _hoisted_3$6, toDisplayString(totalCount.value), 1)]),
 				totalCount.value === 0 ? (openBlock(), createElementBlock("div", _hoisted_4$4, " No decals yet ")) : createCommentVNode("v-if", true),
 				(openBlock(true), createElementBlock(Fragment, null, renderList(groups.value, (group) => {
@@ -3386,7 +3386,7 @@ var DecalDebugUI_default = DecalDebugUI_vue_vue_type_script_setup_true_lang_defa
 
 //#endregion
 //#region src/core/abstractions/Edges.vue?vue&type=script&setup=true&lang.ts
-const _hoisted_1$57 = ["color"];
+const _hoisted_1$58 = ["color"];
 var Edges_vue_vue_type_script_setup_true_lang_default = /* @__PURE__ */ defineComponent({
 	__name: "Edges",
 	props: {
@@ -3424,7 +3424,7 @@ var Edges_vue_vue_type_script_setup_true_lang_default = /* @__PURE__ */ defineCo
 			return openBlock(), createElementBlock("TresLineSegments", {
 				ref_key: "lineSegmentsRef",
 				ref: lineSegmentsRef
-			}, [renderSlot(_ctx.$slots, "default", {}, () => [createElementVNode("TresLineBasicMaterial", { color: unref(color) }, null, 8, _hoisted_1$57)])], 512);
+			}, [renderSlot(_ctx.$slots, "default", {}, () => [createElementVNode("TresLineBasicMaterial", { color: unref(color) }, null, 8, _hoisted_1$58)])], 512);
 		};
 	}
 });
@@ -3598,7 +3598,7 @@ var Levioso_default = Levioso_vue_vue_type_script_setup_true_lang_default;
 
 //#endregion
 //#region src/core/abstractions/Mask/component.vue?vue&type=script&setup=true&lang.ts
-const _hoisted_1$56 = ["render-order"];
+const _hoisted_1$57 = ["render-order"];
 var component_vue_vue_type_script_setup_true_lang_default$18 = /* @__PURE__ */ defineComponent({
 	__name: "component",
 	props: {
@@ -3640,7 +3640,7 @@ var component_vue_vue_type_script_setup_true_lang_default$18 = /* @__PURE__ */ d
 				ref_key: "meshRef",
 				ref: meshRef,
 				"render-order": -props.id
-			}, [renderSlot(_ctx.$slots, "default")], 8, _hoisted_1$56);
+			}, [renderSlot(_ctx.$slots, "default")], 8, _hoisted_1$57);
 		};
 	}
 });
@@ -3944,7 +3944,7 @@ var component_vue_vue_type_script_setup_true_lang_default$16 = /* @__PURE__ */ d
 			invalidate();
 		});
 		watchEffect(() => {
-			instancedRef.value = props.instanceMesh ?? samplerRef.value?.children.find((c) => Object.prototype.hasOwnProperty.call(c, "instanceMatrix"));
+			instancedRef.value = props.instanceMesh ?? samplerRef.value?.children.find((c) => Object.hasOwn(c, "instanceMatrix"));
 			meshToSampleRef.value = props.mesh ?? samplerRef.value?.children.find((c) => c.type === "Mesh");
 			useSurfaceSampler(meshToSampleRef.value, props.count, instancedRef.value, props.weight, props.transform);
 		});
@@ -4030,7 +4030,7 @@ var ScreenSizer_default = ScreenSizer_vue_vue_type_script_setup_true_lang_defaul
 
 //#endregion
 //#region src/core/abstractions/ScreenSpace.vue?vue&type=script&setup=true&lang.ts
-const _hoisted_1$55 = ["position"];
+const _hoisted_1$56 = ["position"];
 var ScreenSpace_vue_vue_type_script_setup_true_lang_default = /* @__PURE__ */ defineComponent({
 	__name: "ScreenSpace",
 	props: {
@@ -4097,7 +4097,7 @@ var ScreenSpace_vue_vue_type_script_setup_true_lang_default = /* @__PURE__ */ de
 			return openBlock(), createElementBlock("TresGroup", {
 				ref_key: "outerRef",
 				ref: outerRef
-			}, [createElementVNode("TresGroup", { position: innerPosition.value }, [renderSlot(_ctx.$slots, "default")], 8, _hoisted_1$55)], 512);
+			}, [createElementVNode("TresGroup", { position: innerPosition.value }, [renderSlot(_ctx.$slots, "default")], 8, _hoisted_1$56)], 512);
 		};
 	}
 });
@@ -4131,7 +4131,7 @@ const isOrthographicCamera$1 = (camera) => Boolean(camera && camera.isOrthograph
 
 //#endregion
 //#region src/core/controls/CameraControls.vue?vue&type=script&setup=true&lang.ts
-const _hoisted_1$54 = [
+const _hoisted_1$55 = [
 	"min-polar-angle",
 	"max-polar-angle",
 	"min-azimuth-angle",
@@ -4400,7 +4400,7 @@ var CameraControls_vue_vue_type_script_setup_true_lang_default = /* @__PURE__ */
 				args: [__props.camera || unref(activeCamera), __props.domElement || unref(renderer).domElement],
 				"mouse-buttons": mouseButtons.value,
 				touches: touches.value
-			}, null, 8, _hoisted_1$54)) : createCommentVNode("v-if", true);
+			}, null, 8, _hoisted_1$55)) : createCommentVNode("v-if", true);
 		};
 	}
 });
@@ -4568,7 +4568,7 @@ function useOrbitLikeControls(controlsRef, props, emit) {
 
 //#endregion
 //#region src/core/controls/MapControls.vue?vue&type=script&setup=true&lang.ts
-const _hoisted_1$53 = [
+const _hoisted_1$54 = [
 	"args",
 	"target",
 	"auto-rotate",
@@ -4756,7 +4756,7 @@ var MapControls_vue_vue_type_script_setup_true_lang_default = /* @__PURE__ */ de
 				"rotate-speed": __props.rotateSpeed,
 				"mouse-buttons": __props.mouseButtons,
 				"screen-space-panning": __props.screenSpacePanning
-			}, null, 8, _hoisted_1$53)) : createCommentVNode("v-if", true);
+			}, null, 8, _hoisted_1$54)) : createCommentVNode("v-if", true);
 		};
 	}
 });
@@ -4767,7 +4767,7 @@ var MapControls_default = MapControls_vue_vue_type_script_setup_true_lang_defaul
 
 //#endregion
 //#region src/core/controls/OrbitControls.vue?vue&type=script&setup=true&lang.ts
-const _hoisted_1$52 = [
+const _hoisted_1$53 = [
 	"args",
 	"target",
 	"auto-rotate",
@@ -4955,7 +4955,7 @@ var OrbitControls_vue_vue_type_script_setup_true_lang_default = /* @__PURE__ */
 				"rotate-speed": __props.rotateSpeed,
 				"mouse-buttons": __props.mouseButtons,
 				"screen-space-panning": __props.screenSpacePanning
-			}, null, 8, _hoisted_1$52)) : createCommentVNode("v-if", true);
+			}, null, 8, _hoisted_1$53)) : createCommentVNode("v-if", true);
 		};
 	}
 });
@@ -4966,7 +4966,7 @@ var OrbitControls_default = OrbitControls_vue_vue_type_script_setup_true_lang_de
 
 //#endregion
 //#region src/core/controls/PointerLockControls.vue?vue&type=script&setup=true&lang.ts
-const _hoisted_1$51 = ["args"];
+const _hoisted_1$52 = ["args"];
 var PointerLockControls_vue_vue_type_script_setup_true_lang_default = /* @__PURE__ */ defineComponent({
 	__name: "PointerLockControls",
 	props: {
@@ -4999,29 +4999,36 @@ var PointerLockControls_vue_vue_type_script_setup_true_lang_default = /* @__PURE
 		const controlsRef = shallowRef(null);
 		let triggerSelector;
 		extend$1({ PointerLockControls });
-		const isLockEmitter = (event) => {
-			emit("isLock", event);
-		};
-		watch(controlsRef, (value) => {
-			if (value && props.makeDefault) controls.value = value;
-			else controls.value = null;
+		const onLock = () => emit("isLock", true);
+		const onUnlock = () => emit("isLock", false);
+		const onChange = () => invalidate();
+		watch(controlsRef, (value, oldValue) => {
+			if (oldValue) {
+				oldValue.removeEventListener("lock", onLock);
+				oldValue.removeEventListener("unlock", onUnlock);
+				oldValue.removeEventListener("change", onChange);
+			}
+			if (!value) {
+				controls.value = null;
+				return;
+			}
+			if (props.makeDefault) controls.value = value;
+			value.addEventListener("lock", onLock);
+			value.addEventListener("unlock", onUnlock);
+			value.addEventListener("change", onChange);
 			triggerSelector = document.getElementById(props.selector || "") || renderer.domElement;
 			useEventListener(triggerSelector, "click", () => {
-				if (controlsRef.value) {
-					controlsRef.value.lock();
-					controlsRef.value.addEventListener("lock", () => isLockEmitter(true));
-					controlsRef.value.addEventListener("unlock", () => isLockEmitter(false));
-					controlsRef.value.addEventListener("change", () => invalidate());
-					invalidate();
-				}
+				value.lock();
+				invalidate();
 			});
 		});
 		onUnmounted(() => {
-			const controls$1 = controlsRef.value;
-			if (controls$1) {
-				controls$1.removeEventListener("lock", () => isLockEmitter(true));
-				controls$1.removeEventListener("unlock", () => isLockEmitter(false));
-				controls$1.dispose();
+			const instance = controlsRef.value;
+			if (instance) {
+				instance.removeEventListener("lock", onLock);
+				instance.removeEventListener("unlock", onUnlock);
+				instance.removeEventListener("change", onChange);
+				instance.dispose();
 			}
 		});
 		__expose({ instance: controls });
@@ -5031,7 +5038,7 @@ var PointerLockControls_vue_vue_type_script_setup_true_lang_default = /* @__PURE
 				ref_key: "controlsRef",
 				ref: controlsRef,
 				args: [__props.camera || unref(activeCamera), __props.domElement || unref(renderer).domElement]
-			}, null, 8, _hoisted_1$51)) : createCommentVNode("v-if", true);
+			}, null, 8, _hoisted_1$52)) : createCommentVNode("v-if", true);
 		};
 	}
 });
@@ -5184,7 +5191,7 @@ var ScrollControls_default = ScrollControls_vue_vue_type_script_setup_true_lang_
 
 //#endregion
 //#region src/core/controls/TransformControls.vue?vue&type=script&setup=true&lang.ts
-const _hoisted_1$50 = [
+const _hoisted_1$51 = [
 	"object",
 	"args",
 	"mode",
@@ -5347,7 +5354,7 @@ var TransformControls_vue_vue_type_script_setup_true_lang_default = /* @__PURE__
 				"show-y": unref(showY),
 				"show-z": unref(showZ),
 				visible: true
-			}, null, 8, _hoisted_1$50)) : createCommentVNode("v-if", true);
+			}, null, 8, _hoisted_1$51)) : createCommentVNode("v-if", true);
 		};
 	}
 });
@@ -5755,7 +5762,7 @@ var RandomizedLights = class extends Group {
 
 //#endregion
 //#region src/core/light-shadow/RandomizedLights/component.vue?vue&type=script&setup=true&lang.ts
-const _hoisted_1$49 = [
+const _hoisted_1$50 = [
 	"count",
 	"radius",
 	"intensity",
@@ -5856,7 +5863,7 @@ var component_vue_vue_type_script_setup_true_lang_default$14 = /* @__PURE__ */ d
 				near: __props.near,
 				far: __props.far,
 				position: pos.value
-			}, null, 8, _hoisted_1$49);
+			}, null, 8, _hoisted_1$50);
 		};
 	}
 });
@@ -6020,7 +6027,7 @@ const SoftShadowMaterial = /* @__PURE__ */ shaderMaterial({
 
 //#endregion
 //#region src/core/light-shadow/AccumulativeShadows/component.vue?vue&type=script&setup=true&lang.ts
-const _hoisted_1$48 = ["scale", "rotation"];
+const _hoisted_1$49 = ["scale", "rotation"];
 const _hoisted_2$27 = [
 	"alpha-test",
 	"blend",
@@ -6219,7 +6226,7 @@ var component_vue_vue_type_script_setup_true_lang_default$13 = /* @__PURE__ */ d
 				opacity: __props.opacity,
 				"tone-mapped": __props.toneMapped,
 				transparent: true
-			}, null, 8, _hoisted_2$27)], 8, _hoisted_1$48)], 512);
+			}, null, 8, _hoisted_2$27)], 8, _hoisted_1$49)], 512);
 		};
 	}
 });
@@ -6245,7 +6252,7 @@ const BakeShadows = defineComponent({
 
 //#endregion
 //#region src/core/light-shadow/CircleShadow.vue?vue&type=script&setup=true&lang.ts
-const _hoisted_1$47 = ["rotation-x"];
+const _hoisted_1$48 = ["rotation-x"];
 const _hoisted_2$26 = [
 	"opacity",
 	"fog",
@@ -6319,7 +6326,7 @@ var CircleShadow_vue_vue_type_script_setup_true_lang_default = /* @__PURE__ */ d
 				"depth-write": __props.depthWrite,
 				side: unref(DoubleSide),
 				map: unref(texture$1)
-			}, null, 8, _hoisted_2$26)], 8, _hoisted_1$47);
+			}, null, 8, _hoisted_2$26)], 8, _hoisted_1$48);
 		};
 	}
 });
@@ -6330,7 +6337,7 @@ var CircleShadow_default = CircleShadow_vue_vue_type_script_setup_true_lang_defa
 
 //#endregion
 //#region src/core/light-shadow/ContactShadows.vue?vue&type=script&setup=true&lang.ts
-const _hoisted_1$46 = ["object"];
+const _hoisted_1$47 = ["object"];
 var ContactShadows_vue_vue_type_script_setup_true_lang_default = /* @__PURE__ */ defineComponent({
 	__name: "ContactShadows",
 	props: {
@@ -6538,7 +6545,7 @@ var ContactShadows_vue_vue_type_script_setup_true_lang_default = /* @__PURE__ */
 		});
 		__expose({ instance: pool.shadowGroup });
 		return (_ctx, _cache) => {
-			return openBlock(), createElementBlock("primitive", { object: unref(pool).shadowGroup }, null, 8, _hoisted_1$46);
+			return openBlock(), createElementBlock("primitive", { object: unref(pool).shadowGroup }, null, 8, _hoisted_1$47);
 		};
 	}
 });
@@ -7565,7 +7572,7 @@ function useSVG(path, options = {}) {
 
 //#endregion
 //#region src/core/loaders/useSVG/component.vue?vue&type=script&setup=true&lang.ts
-const _hoisted_1$45 = { key: 0 };
+const _hoisted_1$46 = { key: 0 };
 const _hoisted_2$25 = ["geometry", "render-order"];
 var component_vue_vue_type_script_setup_true_lang_default$11 = /* @__PURE__ */ defineComponent({
 	__name: "component",
@@ -7623,7 +7630,7 @@ var component_vue_vue_type_script_setup_true_lang_default$11 = /* @__PURE__ */ d
 			dispose();
 		});
 		return (_ctx, _cache) => {
-			return !unref(isLoading) ? (openBlock(), createElementBlock("TresGroup", _hoisted_1$45, [(openBlock(true), createElementBlock(Fragment, null, renderList(unref(layers), ({ geometry, material, isStroke }, i) => {
+			return !unref(isLoading) ? (openBlock(), createElementBlock("TresGroup", _hoisted_1$46, [(openBlock(true), createElementBlock(Fragment, null, renderList(unref(layers), ({ geometry, material, isStroke }, i) => {
 				return openBlock(), createElementBlock("TresMesh", mergeProps({ key: `${i}` }, { ref_for: true }, isStroke ? props.strokeMeshProps : props.fillMeshProps, {
 					geometry,
 					"render-order": props.depth === "renderOrder" ? i : 0
@@ -7674,7 +7681,7 @@ function useFBX(path, options) {
 
 //#endregion
 //#region src/core/loaders/useFBX/component.vue?vue&type=script&setup=true&lang.ts
-const _hoisted_1$44 = ["object"];
+const _hoisted_1$45 = ["object"];
 var component_vue_vue_type_script_setup_true_lang_default$10 = /* @__PURE__ */ defineComponent({
 	__name: "component",
 	props: {
@@ -7709,7 +7716,7 @@ var component_vue_vue_type_script_setup_true_lang_default$10 = /* @__PURE__ */ d
 			return !unref(isLoading) && unref(model) ? (openBlock(), createElementBlock("primitive", {
 				key: 0,
 				object: unref(model)
-			}, null, 8, _hoisted_1$44)) : createCommentVNode("v-if", true);
+			}, null, 8, _hoisted_1$45)) : createCommentVNode("v-if", true);
 		};
 	}
 });
@@ -7764,7 +7771,7 @@ function useGLTF(path, options) {
 
 //#endregion
 //#region src/core/loaders/useGLTF/component.vue?vue&type=script&setup=true&lang.ts
-const _hoisted_1$43 = ["object"];
+const _hoisted_1$44 = ["object"];
 var component_vue_vue_type_script_setup_true_lang_default$9 = /* @__PURE__ */ defineComponent({
 	__name: "component",
 	props: {
@@ -7812,7 +7819,7 @@ var component_vue_vue_type_script_setup_true_lang_default$9 = /* @__PURE__ */ de
 			return !unref(isLoading) && unref(state)?.scene ? (openBlock(), createElementBlock("primitive", {
 				key: 0,
 				object: unref(state)?.scene
-			}, null, 8, _hoisted_1$43)) : createCommentVNode("v-if", true);
+			}, null, 8, _hoisted_1$44)) : createCommentVNode("v-if", true);
 		};
 	}
 });
@@ -8013,8 +8020,8 @@ function useTextures(paths) {
 
 //#endregion
 //#region src/core/materials/customShaderMaterial/index.vue?vue&type=script&setup=true&lang.ts
-const _hoisted_1$42 = ["args"];
-var index_vue_vue_type_script_setup_true_lang_default$6 = /* @__PURE__ */ defineComponent({
+const _hoisted_1$43 = ["args"];
+var index_vue_vue_type_script_setup_true_lang_default$7 = /* @__PURE__ */ defineComponent({
 	__name: "index",
 	props: {
 		baseMaterial: {
@@ -8052,14 +8059,14 @@ var index_vue_vue_type_script_setup_true_lang_default$6 = /* @__PURE__ */ define
 				ref_key: "customShaderMaterialClass",
 				ref: customShaderMaterialClass,
 				args: [props]
-			}, null, 8, _hoisted_1$42);
+			}, null, 8, _hoisted_1$43);
 		};
 	}
 });
 
 //#endregion
 //#region src/core/materials/customShaderMaterial/index.vue
-var customShaderMaterial_default = index_vue_vue_type_script_setup_true_lang_default$6;
+var customShaderMaterial_default = index_vue_vue_type_script_setup_true_lang_default$7;
 
 //#endregion
 //#region src/core/materials/holographicMaterial/HolographicMaterialParameters.ts
@@ -8240,7 +8247,7 @@ var HolographicMaterialParameters_default = HolographicMaterial;
 
 //#endregion
 //#region src/core/materials/holographicMaterial/index.vue?vue&type=script&setup=true&lang.ts
-const _hoisted_1$41 = [
+const _hoisted_1$42 = [
 	"uniforms-fresnelAmount-value",
 	"uniforms-enableBlinking-value",
 	"uniforms-fresnelOpacity-value",
@@ -8253,7 +8260,7 @@ const _hoisted_1$41 = [
 	"enableAdditive",
 	"side"
 ];
-var index_vue_vue_type_script_setup_true_lang_default$5 = /* @__PURE__ */ defineComponent({
+var index_vue_vue_type_script_setup_true_lang_default$6 = /* @__PURE__ */ defineComponent({
 	__name: "index",
 	props: {
 		fresnelAmount: {
@@ -8341,18 +8348,18 @@ var index_vue_vue_type_script_setup_true_lang_default$5 = /* @__PURE__ */ define
 				"uniforms-blinkFresnelOnly-value": props.blinkFresnelOnly,
 				enableAdditive: props.enableAdditive,
 				side: props.side
-			}, null, 8, _hoisted_1$41);
+			}, null, 8, _hoisted_1$42);
 		};
 	}
 });
 
 //#endregion
 //#region src/core/materials/holographicMaterial/index.vue
-var holographicMaterial_default = index_vue_vue_type_script_setup_true_lang_default$5;
+var holographicMaterial_default = index_vue_vue_type_script_setup_true_lang_default$6;
 
 //#endregion
 //#region src/core/materials/meshDiscardMaterial/index.vue?vue&type=script&setup=true&lang.ts
-var index_vue_vue_type_script_setup_true_lang_default$4 = /* @__PURE__ */ defineComponent({
+var index_vue_vue_type_script_setup_true_lang_default$5 = /* @__PURE__ */ defineComponent({
 	__name: "index",
 	setup(__props, { expose: __expose }) {
 		const meshDiscardMaterialRef = shallowRef();
@@ -8370,7 +8377,7 @@ var index_vue_vue_type_script_setup_true_lang_default$4 = /* @__PURE__ */ define
 
 //#endregion
 //#region src/core/materials/meshDiscardMaterial/index.vue
-var meshDiscardMaterial_default = index_vue_vue_type_script_setup_true_lang_default$4;
+var meshDiscardMaterial_default = index_vue_vue_type_script_setup_true_lang_default$5;
 
 //#endregion
 //#region src/core/materials/meshGlassMaterial/material.ts
@@ -8472,7 +8479,7 @@ var material_default = MeshGlassMaterial;
 
 //#endregion
 //#region src/core/materials/meshGlassMaterial/index.vue?vue&type=script&setup=true&lang.ts
-var index_vue_vue_type_script_setup_true_lang_default$3 = /* @__PURE__ */ defineComponent({
+var index_vue_vue_type_script_setup_true_lang_default$4 = /* @__PURE__ */ defineComponent({
 	__name: "index",
 	setup(__props, { expose: __expose }) {
 		const MeshGlassMaterialClass = shallowRef();
@@ -8490,7 +8497,7 @@ var index_vue_vue_type_script_setup_true_lang_default$3 = /* @__PURE__ */ define
 
 //#endregion
 //#region src/core/materials/meshGlassMaterial/index.vue
-var meshGlassMaterial_default = index_vue_vue_type_script_setup_true_lang_default$3;
+var meshGlassMaterial_default = index_vue_vue_type_script_setup_true_lang_default$4;
 
 //#endregion
 //#region src/utils/constants.ts
@@ -8909,7 +8916,7 @@ var MeshReflectionMaterial = class extends MeshStandardMaterial {
 
 //#endregion
 //#region src/core/materials/meshReflectionMaterial/index.vue?vue&type=script&setup=true&lang.ts
-const _hoisted_1$40 = [
+const _hoisted_1$41 = [
 	"texture-matrix",
 	"t-sharp",
 	"t-depth",
@@ -8918,7 +8925,7 @@ const _hoisted_1$40 = [
 	"defines-USE_DEPTH",
 	"defines-USE_DISTORTION"
 ];
-var index_vue_vue_type_script_setup_true_lang_default$2 = /* @__PURE__ */ defineComponent({
+var index_vue_vue_type_script_setup_true_lang_default$3 = /* @__PURE__ */ defineComponent({
 	__name: "index",
 	props: {
 		resolution: {
@@ -9315,14 +9322,473 @@ var index_vue_vue_type_script_setup_true_lang_default$2 = /* @__PURE__ */ define
 				"defines-USE_BLUR": hasBlur.value ? "" : void 0,
 				"defines-USE_DEPTH": hasDepth.value ? "" : void 0,
 				"defines-USE_DISTORTION": hasDistortion.value ? "" : void 0
-			}), null, 16, _hoisted_1$40);
+			}), null, 16, _hoisted_1$41);
 		};
 	}
 });
 
 //#endregion
 //#region src/core/materials/meshReflectionMaterial/index.vue
-var meshReflectionMaterial_default = index_vue_vue_type_script_setup_true_lang_default$2;
+var meshReflectionMaterial_default = index_vue_vue_type_script_setup_true_lang_default$3;
+
+//#endregion
+//#region src/core/materials/meshTransmissionMaterial/material.ts
+var MeshTransmissionMaterial = class extends MeshPhysicalMaterial {
+	uniforms;
+	constructor({ samples = 6, transmissionSampler = false, chromaticAberration = .05, transmission = 0, _transmission = 1, transmissionMap = null, roughness = 0, thickness = 0, thicknessMap = null, attenuationDistance = Infinity, attenuationColor = new Color("white"), anisotropicBlur = .1, time = 0, distortion = 0, distortionScale = .5, temporalDistortion = 0, buffer = null } = {}) {
+		super();
+		this.uniforms = {
+			chromaticAberration: new Uniform(chromaticAberration),
+			transmission: new Uniform(transmission),
+			_transmission: new Uniform(_transmission),
+			transmissionMap: new Uniform(transmissionMap),
+			roughness: new Uniform(roughness),
+			thickness: new Uniform(thickness),
+			thicknessMap: new Uniform(thicknessMap),
+			attenuationDistance: new Uniform(attenuationDistance),
+			attenuationColor: new Uniform(attenuationColor),
+			anisotropicBlur: new Uniform(anisotropicBlur),
+			time: new Uniform(time),
+			distortion: new Uniform(distortion),
+			distortionScale: new Uniform(distortionScale),
+			temporalDistortion: new Uniform(temporalDistortion),
+			buffer: new Uniform(buffer)
+		};
+		this.onBeforeCompile = (shader) => {
+			shader.uniforms = {
+				...shader.uniforms,
+				...this.uniforms
+			};
+			shader.defines = shader.defines ?? {};
+			if (transmissionSampler) shader.defines.USE_SAMPLER = "";
+			else shader.defines.USE_TRANSMISSION = "";
+			shader.fragmentShader = `
+      uniform float chromaticAberration;
+      uniform float anisotropicBlur;
+      uniform float time;
+      uniform float distortion;
+      uniform float distortionScale;
+      uniform float temporalDistortion;
+      uniform sampler2D buffer;
+
+      vec3 random3(vec3 c) {
+        float j = 4096.0*sin(dot(c,vec3(17.0, 59.4, 15.0)));
+        vec3 r;
+        r.z = fract(512.0*j);
+        j *= .125;
+        r.x = fract(512.0*j);
+        j *= .125;
+        r.y = fract(512.0*j);
+        return r-0.5;
+      }
+
+      uint hash( uint x ) {
+        x += ( x << 10u );
+        x ^= ( x >>  6u );
+        x += ( x <<  3u );
+        x ^= ( x >> 11u );
+        x += ( x << 15u );
+        return x;
+      }
+
+      uint hash( uvec2 v ) { return hash( v.x ^ hash(v.y)                         ); }
+      uint hash( uvec3 v ) { return hash( v.x ^ hash(v.y) ^ hash(v.z)             ); }
+      uint hash( uvec4 v ) { return hash( v.x ^ hash(v.y) ^ hash(v.z) ^ hash(v.w) ); }
+
+      float floatConstruct( uint m ) {
+        const uint ieeeMantissa = 0x007FFFFFu;
+        const uint ieeeOne      = 0x3F800000u;
+        m &= ieeeMantissa;
+        m |= ieeeOne;
+        float  f = uintBitsToFloat( m );
+        return f - 1.0;
+      }
+
+      float randomBase( float x ) { return floatConstruct(hash(floatBitsToUint(x))); }
+      float randomBase( vec2  v ) { return floatConstruct(hash(floatBitsToUint(v))); }
+      float randomBase( vec3  v ) { return floatConstruct(hash(floatBitsToUint(v))); }
+      float randomBase( vec4  v ) { return floatConstruct(hash(floatBitsToUint(v))); }
+      float rand(float seed) {
+        float result = randomBase(vec3(gl_FragCoord.xy, seed));
+        return result;
+      }
+
+      const float F3 =  0.3333333;
+      const float G3 =  0.1666667;
+
+      float snoise(vec3 p) {
+        vec3 s = floor(p + dot(p, vec3(F3)));
+        vec3 x = p - s + dot(s, vec3(G3));
+        vec3 e = step(vec3(0.0), x - x.yzx);
+        vec3 i1 = e*(1.0 - e.zxy);
+        vec3 i2 = 1.0 - e.zxy*(1.0 - e);
+        vec3 x1 = x - i1 + G3;
+        vec3 x2 = x - i2 + 2.0*G3;
+        vec3 x3 = x - 1.0 + 3.0*G3;
+        vec4 w, d;
+        w.x = dot(x, x);
+        w.y = dot(x1, x1);
+        w.z = dot(x2, x2);
+        w.w = dot(x3, x3);
+        w = max(0.6 - w, 0.0);
+        d.x = dot(random3(s), x);
+        d.y = dot(random3(s + i1), x1);
+        d.z = dot(random3(s + i2), x2);
+        d.w = dot(random3(s + 1.0), x3);
+        w *= w;
+        w *= w;
+        d *= w;
+        return dot(d, vec4(52.0));
+      }
+
+      float snoiseFractal(vec3 m) {
+        return 0.5333333* snoise(m)
+              +0.2666667* snoise(2.0*m)
+              +0.1333333* snoise(4.0*m)
+              +0.0666667* snoise(8.0*m);
+      }
+      ${shader.fragmentShader}`;
+			shader.fragmentShader = shader.fragmentShader.replace("#include <transmission_pars_fragment>", `
+        #ifdef USE_TRANSMISSION
+          uniform float _transmission;
+          uniform float thickness;
+          uniform float attenuationDistance;
+          uniform vec3 attenuationColor;
+          #ifdef USE_TRANSMISSIONMAP
+            uniform sampler2D transmissionMap;
+          #endif
+          #ifdef USE_THICKNESSMAP
+            uniform sampler2D thicknessMap;
+          #endif
+          uniform vec2 transmissionSamplerSize;
+          uniform sampler2D transmissionSamplerMap;
+          uniform mat4 modelMatrix;
+          uniform mat4 projectionMatrix;
+          varying vec3 vWorldPosition;
+          vec3 getVolumeTransmissionRay( const in vec3 n, const in vec3 v, const in float thickness, const in float ior, const in mat4 modelMatrix ) {
+            vec3 refractionVector = refract( - v, normalize( n ), 1.0 / ior );
+            vec3 modelScale;
+            modelScale.x = length( vec3( modelMatrix[ 0 ].xyz ) );
+            modelScale.y = length( vec3( modelMatrix[ 1 ].xyz ) );
+            modelScale.z = length( vec3( modelMatrix[ 2 ].xyz ) );
+            return normalize( refractionVector ) * thickness * modelScale;
+          }
+          float applyIorToRoughness( const in float roughness, const in float ior ) {
+            return roughness * clamp( ior * 2.0 - 2.0, 0.0, 1.0 );
+          }
+          vec4 getTransmissionSample( const in vec2 fragCoord, const in float roughness, const in float ior ) {
+            float framebufferLod = log2( transmissionSamplerSize.x ) * applyIorToRoughness( roughness, ior );
+            #ifdef USE_SAMPLER
+              #ifdef texture2DLodEXT
+                return texture2DLodEXT(transmissionSamplerMap, fragCoord.xy, framebufferLod);
+              #else
+                return texture2D(transmissionSamplerMap, fragCoord.xy, framebufferLod);
+              #endif
+            #else
+              return texture2D(buffer, fragCoord.xy);
+            #endif
+          }
+          vec3 applyVolumeAttenuation( const in vec3 radiance, const in float transmissionDistance, const in vec3 attenuationColor, const in float attenuationDistance ) {
+            if ( isinf( attenuationDistance ) ) {
+              return radiance;
+            } else {
+              vec3 attenuationCoefficient = -log( attenuationColor ) / attenuationDistance;
+              vec3 transmittance = exp( - attenuationCoefficient * transmissionDistance );
+              return transmittance * radiance;
+            }
+          }
+          vec4 getIBLVolumeRefraction( const in vec3 n, const in vec3 v, const in float roughness, const in vec3 diffuseColor,
+            const in vec3 specularColor, const in float specularF90, const in vec3 position, const in mat4 modelMatrix,
+            const in mat4 viewMatrix, const in mat4 projMatrix, const in float ior, const in float thickness,
+            const in vec3 attenuationColor, const in float attenuationDistance ) {
+            vec3 transmissionRay = getVolumeTransmissionRay( n, v, thickness, ior, modelMatrix );
+            vec3 refractedRayExit = position + transmissionRay;
+            vec4 ndcPos = projMatrix * viewMatrix * vec4( refractedRayExit, 1.0 );
+            vec2 refractionCoords = ndcPos.xy / ndcPos.w;
+            refractionCoords += 1.0;
+            refractionCoords /= 2.0;
+            vec4 transmittedLight = getTransmissionSample( refractionCoords, roughness, ior );
+            vec3 attenuatedColor = applyVolumeAttenuation( transmittedLight.rgb, length( transmissionRay ), attenuationColor, attenuationDistance );
+            vec3 F = EnvironmentBRDF( n, v, specularColor, specularF90, roughness );
+            return vec4( ( 1.0 - F ) * attenuatedColor * diffuseColor, transmittedLight.a );
+          }
+        #endif
+        `);
+			shader.fragmentShader = shader.fragmentShader.replace("#include <transmission_fragment>", `
+        material.transmission = _transmission;
+        material.transmissionAlpha = 1.0;
+        material.thickness = thickness;
+        material.attenuationDistance = attenuationDistance;
+        material.attenuationColor = attenuationColor;
+        #ifdef USE_TRANSMISSIONMAP
+          material.transmission *= texture2D( transmissionMap, vUv ).r;
+        #endif
+        #ifdef USE_THICKNESSMAP
+          material.thickness *= texture2D( thicknessMap, vUv ).g;
+        #endif
+
+        vec3 pos = vWorldPosition;
+        float runningSeed = 0.0;
+        vec3 v = normalize( cameraPosition - pos );
+        vec3 n = inverseTransformDirection( normal, viewMatrix );
+        vec3 transmission = vec3(0.0);
+        float transmissionR, transmissionB, transmissionG;
+        float randomCoords = rand(runningSeed++);
+        float thickness_smear = thickness * max(pow(roughnessFactor, 0.33), anisotropicBlur);
+        vec3 distortionNormal = vec3(0.0);
+        vec3 temporalOffset = vec3(time, -time, -time) * temporalDistortion;
+        if (distortion > 0.0) {
+          distortionNormal = distortion * vec3(snoiseFractal(vec3((pos * distortionScale + temporalOffset))), snoiseFractal(vec3(pos.zxy * distortionScale - temporalOffset)), snoiseFractal(vec3(pos.yxz * distortionScale + temporalOffset)));
+        }
+        for (float i = 0.0; i < ${samples}.0; i ++) {
+          vec3 sampleNorm = normalize(n + roughnessFactor * roughnessFactor * 2.0 * normalize(vec3(rand(runningSeed++) - 0.5, rand(runningSeed++) - 0.5, rand(runningSeed++) - 0.5)) * pow(rand(runningSeed++), 0.33) + distortionNormal);
+          transmissionR = getIBLVolumeRefraction(
+            sampleNorm, v, material.roughness, material.diffuseColor, material.specularColor, material.specularF90,
+            pos, modelMatrix, viewMatrix, projectionMatrix, material.ior, material.thickness + thickness_smear * (i + randomCoords) / float(${samples}),
+            material.attenuationColor, material.attenuationDistance
+          ).r;
+          transmissionG = getIBLVolumeRefraction(
+            sampleNorm, v, material.roughness, material.diffuseColor, material.specularColor, material.specularF90,
+            pos, modelMatrix, viewMatrix, projectionMatrix, material.ior * (1.0 + chromaticAberration * (i + randomCoords) / float(${samples})), material.thickness + thickness_smear * (i + randomCoords) / float(${samples}),
+            material.attenuationColor, material.attenuationDistance
+          ).g;
+          transmissionB = getIBLVolumeRefraction(
+            sampleNorm, v, material.roughness, material.diffuseColor, material.specularColor, material.specularF90,
+            pos, modelMatrix, viewMatrix, projectionMatrix, material.ior * (1.0 + 2.0 * chromaticAberration * (i + randomCoords) / float(${samples})), material.thickness + thickness_smear * (i + randomCoords) / float(${samples}),
+            material.attenuationColor, material.attenuationDistance
+          ).b;
+          transmission.r += transmissionR;
+          transmission.g += transmissionG;
+          transmission.b += transmissionB;
+        }
+        transmission /= ${samples}.0;
+        totalDiffuse = mix( totalDiffuse, transmission.rgb, material.transmission );
+        `);
+		};
+		Object.keys(this.uniforms).forEach((name) => {
+			Object.defineProperty(this, name, {
+				get: () => this.uniforms[name].value,
+				set: (v) => {
+					this.uniforms[name].value = v;
+				}
+			});
+		});
+	}
+};
+
+//#endregion
+//#region src/core/materials/meshTransmissionMaterial/index.vue?vue&type=script&setup=true&lang.ts
+const _hoisted_1$40 = ["args"];
+var index_vue_vue_type_script_setup_true_lang_default$2 = /* @__PURE__ */ defineComponent({
+	__name: "index",
+	props: {
+		samples: {
+			type: Number,
+			required: false,
+			default: 6
+		},
+		transmissionSampler: {
+			type: Boolean,
+			required: false,
+			default: false
+		},
+		transmission: {
+			type: Number,
+			required: false,
+			default: 1
+		},
+		thickness: {
+			type: Number,
+			required: false,
+			default: 0
+		},
+		backsideThickness: {
+			type: Number,
+			required: false,
+			default: 0
+		},
+		roughness: {
+			type: Number,
+			required: false,
+			default: 0
+		},
+		chromaticAberration: {
+			type: Number,
+			required: false,
+			default: .03
+		},
+		anisotropicBlur: {
+			type: Number,
+			required: false,
+			default: .1
+		},
+		distortion: {
+			type: Number,
+			required: false,
+			default: 0
+		},
+		distortionScale: {
+			type: Number,
+			required: false,
+			default: .5
+		},
+		temporalDistortion: {
+			type: Number,
+			required: false,
+			default: 0
+		},
+		ior: {
+			type: Number,
+			required: false,
+			default: 1.5
+		},
+		color: {
+			type: null,
+			required: false
+		},
+		clearcoat: {
+			type: Number,
+			required: false
+		},
+		clearcoatRoughness: {
+			type: Number,
+			required: false
+		},
+		attenuationDistance: {
+			type: Number,
+			required: false
+		},
+		attenuationColor: {
+			type: null,
+			required: false
+		},
+		resolution: {
+			type: Number,
+			required: false,
+			default: 256
+		},
+		backsideResolution: {
+			type: Number,
+			required: false
+		},
+		backside: {
+			type: Boolean,
+			required: false,
+			default: false
+		},
+		background: {
+			type: [Object, null],
+			required: false
+		},
+		buffer: {
+			type: [Object, null],
+			required: false
+		}
+	},
+	setup(__props, { expose: __expose }) {
+		const props = __props;
+		const { extend: extend$1, invalidate } = useTres();
+		extend$1({ MeshTransmissionMaterial });
+		const materialRef = shallowRef();
+		watch(() => [props.samples, props.transmissionSampler], () => {
+			logWarning("MeshTransmissionMaterial: samples and transmissionSampler are baked into the shader at compile time. Changes require remounting the component.");
+		});
+		const constructorArgs = computed(() => [{
+			samples: props.samples,
+			transmissionSampler: props.transmissionSampler
+		}]);
+		const constructorKey = computed(() => `${props.samples}-${props.transmissionSampler}`);
+		const tresProps = computed(() => {
+			const { transmission, transmissionSampler: _ts, samples: _s, resolution: _r, backsideResolution: _br, backside: _bs, backsideThickness: _bt, background: _bg, buffer: _buf, ...rest } = props;
+			return {
+				...Object.fromEntries(Object.entries(rest).filter(([, value]) => value !== void 0)),
+				_transmission: transmission,
+				transmission: 0
+			};
+		});
+		const fboMain = new WebGLRenderTarget(props.resolution, props.resolution, {
+			minFilter: LinearFilter,
+			magFilter: LinearFilter,
+			type: HalfFloatType
+		});
+		const fboBack = new WebGLRenderTarget(props.backsideResolution ?? props.resolution, props.backsideResolution ?? props.resolution, {
+			minFilter: LinearFilter,
+			magFilter: LinearFilter,
+			type: HalfFloatType
+		});
+		watch(() => props.resolution, (res) => {
+			fboMain.setSize(res, res);
+		});
+		watch(() => props.backsideResolution ?? props.resolution, (res) => {
+			fboBack.setSize(res, res);
+		});
+		const discardMat = new MeshDiscardMaterial();
+		const backsideMat = new MeshPhysicalMaterial({
+			side: BackSide,
+			transparent: true
+		});
+		const { onBeforeRender } = useLoop();
+		onBeforeRender(({ renderer, scene, camera, elapsed }) => {
+			const mat = materialRef.value;
+			if (!mat) return;
+			if ("isWebGPURenderer" in renderer && renderer.isWebGPURenderer === true) {
+				logWarning("MeshTransmissionMaterial: WebGPURenderer is not supported yet");
+				return;
+			}
+			if (!(renderer instanceof WebGLRenderer)) return;
+			const parent = mat?.__tres?.parent;
+			if (!parent) return;
+			mat.time = elapsed;
+			if (props.transmissionSampler) return;
+			if (!camera.value) return;
+			if (props.buffer) {
+				mat.buffer = props.buffer;
+				return;
+			}
+			invalidate();
+			const oldBg = toValue(scene).background;
+			const oldTone = renderer.toneMapping;
+			const savedMaterial = parent.material;
+			if (props.background) toValue(scene).background = props.background;
+			renderer.toneMapping = NoToneMapping;
+			if (props.backside) {
+				parent.material = backsideMat;
+				renderer.setRenderTarget(fboBack);
+				renderer.render(toValue(scene), camera.value);
+				mat.buffer = fboBack.texture;
+				mat.thickness = props.backsideThickness;
+				parent.material = discardMat;
+			} else parent.material = discardMat;
+			renderer.setRenderTarget(fboMain);
+			renderer.render(toValue(scene), camera.value);
+			mat.buffer = fboMain.texture;
+			if (props.backside) mat.thickness = props.thickness;
+			parent.material = savedMaterial;
+			renderer.toneMapping = oldTone;
+			toValue(scene).background = oldBg;
+			renderer.setRenderTarget(null);
+		});
+		onBeforeUnmount(() => {
+			fboMain.dispose();
+			fboBack.dispose();
+			discardMat.dispose();
+			backsideMat.dispose();
+		});
+		__expose({ instance: materialRef });
+		return (_ctx, _cache) => {
+			return openBlock(), createElementBlock("TresMeshTransmissionMaterial", mergeProps({
+				key: constructorKey.value,
+				ref_key: "materialRef",
+				ref: materialRef,
+				args: constructorArgs.value
+			}, tresProps.value), null, 16, _hoisted_1$40);
+		};
+	}
+});
+
+//#endregion
+//#region src/core/materials/meshTransmissionMaterial/index.vue
+var meshTransmissionMaterial_default = index_vue_vue_type_script_setup_true_lang_default$2;
 
 //#endregion
 //#region src/core/materials/meshWobbleMaterial/material.ts
@@ -10337,7 +10803,8 @@ async function getTextureAndAtlasAsync(imagePathOrImageData, atlasPathOrAtlasish
 	});
 	const atlasishPromise = typeof atlasPathOrAtlasish !== "string" ? new Promise((resolve) => resolve(atlasPathOrAtlasish)) : fetch(atlasPathOrAtlasish).then((response) => response.json()).catch((e) => logError(`Cientos Atlas - ${e}`));
 	return Promise.all([texturePromise, atlasishPromise]).then(([texture$1, atlasish]) => {
-		return [texture$1, getAtlas(atlasish, texture$1.image.width, texture$1.image.height)];
+		const image = texture$1.image;
+		return [texture$1, getAtlas(atlasish, image.width, image.height)];
 	});
 }
 function getAtlas(atlasish, textureWidth, textureHeight) {
@@ -10466,7 +10933,7 @@ function groupAtlasFramesByKey(frames) {
 	const result = {};
 	for (const frame of frames) if (getNumbersFromEnd(frame.name) !== null) {
 		const key = stripUnderscoresNumbersFromEnd(frame.name);
-		if (Object.prototype.hasOwnProperty.call(result, key)) result[key].push(frame);
+		if (Object.hasOwn(result, key)) result[key].push(frame);
 		else result[key] = [frame];
 	}
 	for (const entry of Object.values(result)) entry.sort((a, b) => a.name.localeCompare(b.name));
@@ -11030,15 +11497,37 @@ var GradientTexture_default = GradientTexture_vue_vue_type_script_setup_true_lan
 
 //#endregion
 //#region src/core/objects/html/shaders/fragment.glsl
-var fragment_default = "void main() {\n  gl_FragColor = vec4(0.0, 0.0, 0.0, 0.0);\n}";
+var fragment_default = `void main() {
+  gl_FragColor = vec4(0.0, 0.0, 0.0, 0.0);
+}`;
 
 //#endregion
 //#region src/core/objects/html/shaders/vertex.glsl
-var vertex_default = "#include <common>\n\nuniform float uWidth;\nuniform float uHeight;\n\nvoid main() {\n\n  vec4 mvPosition = modelViewMatrix * vec4(0.0, 0.0, 0.0, 1.0);\n\n  vec2 quad = position.xy;\n\n  vec2 alignedPosition = quad * vec2(uWidth, uHeight);\n\n  mvPosition.xy += alignedPosition;\n\n  gl_Position = projectionMatrix * mvPosition;\n}";
+var vertex_default = `#include <common>
+
+uniform float uWidth;
+uniform float uHeight;
+
+void main() {
+
+  vec4 mvPosition = modelViewMatrix * vec4(0.0, 0.0, 0.0, 1.0);
+
+  vec2 quad = position.xy;
+
+  vec2 alignedPosition = quad * vec2(uWidth, uHeight);
+
+  mvPosition.xy += alignedPosition;
+
+  gl_Position = projectionMatrix * mvPosition;
+}`;
 
 //#endregion
 //#region src/core/objects/html/shaders/passthrough-vertex.glsl
-var passthrough_vertex_default = "#include <common>\n\nvoid main() {\n  gl_Position = projectionMatrix * modelViewMatrix * vec4(position, 1.0);\n}";
+var passthrough_vertex_default = `#include <common>
+
+void main() {
+  gl_Position = projectionMatrix * modelViewMatrix * vec4(position, 1.0);
+}`;
 
 //#endregion
 //#region src/core/objects/html/utils.ts
@@ -11595,7 +12084,7 @@ const ImageMaterialImpl = /* @__PURE__ */ shaderMaterial({
       vec2 res = vec2(scale * resolution);
       vec2 halfRes = 0.5 * res;
       float b = udRoundBox(vUv.xy * res - halfRes, halfRes, resolution * radius);
-        vec3 a = mix(vec3(1.0,0.0,0.0), vec3(0.0,0.0,0.0), smoothstep(0.0, 1.0, b));
+      float a = 1.0 - smoothstep(0.0, 1.0, b);
       gl_FragColor = toGrayscale(texture2D(map, zUv) * vec4(color, opacity * a), grayscale);
 
       #include <tonemapping_fragment>
@@ -11696,12 +12185,15 @@ var component_vue_vue_type_script_setup_true_lang_default$2 = /* @__PURE__ */ de
 		const texture$1 = shallowRef(props.texture ?? null);
 		const { sizes: size, renderer } = useTres();
 		const planeBounds = computed(() => Array.isArray(props.scale) ? [props.scale[0], props.scale[1]] : [props.scale, props.scale]);
-		const imageBounds = computed(() => [texture$1.value?.image?.width ?? 0, texture$1.value?.image?.height ?? 0]);
+		const imageBounds = computed(() => {
+			const image = texture$1.value?.image;
+			return [image?.width ?? 1, image?.height ?? 1];
+		});
 		const resolution = computed(() => Math.max(size.width.value, size.height.value));
-		const { state, isLoading } = useTexture(props.url);
+		const { state, isLoading } = useTexture(computed(() => props.url));
 		watchEffect(() => {
 			if (props.texture) texture$1.value = props.texture;
-			if (!isLoading.value) {
+			else if (!isLoading.value) {
 				texture$1.value = state.value;
 				texture$1.value.colorSpace = renderer.outputColorSpace;
 			}
@@ -11943,7 +12435,7 @@ var Reflector_vue_vue_type_script_setup_true_lang_default = /* @__PURE__ */ defi
 		const reflectorRef = shallowRef();
 		extend$1({ Reflector });
 		const { color, textureWidth, textureHeight, clipBias, multisample, shader } = toRefs(props);
-		const colorValue = computed(() => new Color(color.value));
+		const colorValue = computed(() => Array.isArray(color.value) ? new Color(...color.value) : new Color(color.value));
 		watch(props, () => {
 			invalidate();
 		});
@@ -13615,19 +14107,23 @@ var Backdrop_default = Backdrop_vue_vue_type_script_setup_true_lang_default;
 
 //#endregion
 //#region src/core/staging/useEnvironment/const.ts
+/**
+* Base paths (without resolution suffix) for the preset HDRs hosted in `Tresjs/assets`.
+* The loader appends `_${quality}.hdr` to resolve the final file.
+*/
 const environmentPresets = {
-	sunset: "venice/venice_sunset_1k.hdr",
-	studio: "studio/poly_haven_studio_1k.hdr",
-	city: "city/canary_wharf_1k.hdr",
-	umbrellas: "outdoor/outdoor_umbrellas_1k.hdr",
-	night: "outdoor/satara_night_1k.hdr",
-	forest: "outood/mossy_forest_1k.hdr",
-	snow: "outdoor/snowy_forest_path_01_1k.hdr",
-	dawn: "kiara/kiara_1_dawn_1k.hdr",
-	hangar: "indoor/small_hangar_01_1k.hdr",
-	urban: "indoor/abandoned_games_room_02_1k.hdr",
-	modern: "city/modern_buildings_2_1k.hdr",
-	shangai: "city/shanghai_bund_1k.hdr"
+	sunset: "venice/venice_sunset",
+	studio: "studio/poly_haven_studio",
+	city: "city/canary_wharf",
+	umbrellas: "outdoor/outdoor_umbrellas",
+	night: "outdoor/satara_night",
+	forest: "outdoor/mossy_forest",
+	snow: "outdoor/snowy_forest_path_01",
+	dawn: "kiara/kiara_1_dawn",
+	hangar: "indoor/small_hangar_01",
+	urban: "indoor/abandoned_games_room_02",
+	modern: "city/modern_buildings_2",
+	shangai: "city/shanghai_bund"
 };
 
 //#endregion
@@ -13676,7 +14172,7 @@ function updateMaterials(scene) {
 */
 async function useEnvironment(options, fbo) {
 	const { scene, invalidate } = useTres();
-	const { preset, blur, files = ref([]), path = ref(""), background, backgroundIntensity = ref(1), environmentIntensity = ref(1), backgroundRotation = ref([
+	const { preset, quality = ref("1k"), blur, files = ref([]), path = ref(""), background, backgroundIntensity = ref(1), environmentIntensity = ref(1), backgroundRotation = ref([
 		0,
 		0,
 		0
@@ -13750,10 +14246,11 @@ async function useEnvironment(options, fbo) {
 			}
 		}
 	}, { immediate: true });
-	watch(() => preset?.value, async (value) => {
+	watch([() => preset?.value, () => quality?.value], async ([value]) => {
 		if (value && value in environmentPresets) {
 			const _path = PRESET_ROOT;
-			const _files = environmentPresets[value];
+			const _quality = quality?.value;
+			const _files = `${environmentPresets[value]}_${_quality}.hdr`;
 			try {
 				rgbeLoader.setPath(_path);
 				texture$1.value = await new Promise((resolve, reject) => {
@@ -13838,6 +14335,11 @@ var component_vue_vue_type_script_setup_true_lang_default$1 = /* @__PURE__ */ de
 			required: false,
 			default: void 0
 		},
+		quality: {
+			type: String,
+			required: false,
+			default: "1k"
+		},
 		resolution: {
 			type: Number,
 			required: false,
@@ -14172,7 +14674,7 @@ var Ocean_vue_vue_type_script_setup_true_lang_default = /* @__PURE__ */ defineCo
 		watch(alpha, changeAlpha);
 		__expose({ instance: waterRef });
 		scene.value.traverse((child) => {
-			if (Object.prototype.hasOwnProperty.call(child, "isSky")) sunRef.value = child;
+			if (Object.hasOwn(child, "isSky")) sunRef.value = child;
 		});
 		onMounted(async () => {
 			await nextTick();
@@ -15599,7 +16101,7 @@ var Stars_default = Stars_vue_vue_type_script_setup_true_lang_default;
 */
 function pick(obj, props) {
 	const pickedProperties = {};
-	for (const prop of props) if (Object.prototype.hasOwnProperty.call(obj, prop)) pickedProperties[prop] = obj[prop];
+	for (const prop of props) if (Object.hasOwn(obj, prop)) pickedProperties[prop] = obj[prop];
 	return pickedProperties;
 }
 /**
@@ -15621,4 +16123,4 @@ function extractBindingPosition(binding) {
 }
 
 //#endregion
-export { component_default as AccumulativeShadows, Align_default as Align, component_default$1 as AnimatedSprite, Backdrop_default as Backdrop, BakeShadows, BaseCameraControls, Billboard_default as Billboard, component_default$2 as Bounds, Box_default as Box, CameraControls_default as CameraControls, CameraShake_default as CameraShake, CatmullRomCurve3_default as CatmullRomCurve3, Circle_default as Circle, CircleShadow_default as CircleShadow, Cone_default as Cone, ContactShadows_default as ContactShadows, component_default$3 as CubeCamera, CubicBezierLine_default as CubicBezierLine, customShaderMaterial_default as CustomShaderMaterial, Cylinder_default as Cylinder, Decal_default as Decal, DecalDebugUI_default as DecalDebugUI, Dodecahedron_default as Dodecahedron, Edges_default as Edges, component_default$4 as Environment, component_default$5 as FBXModel, component_default$6 as Fbo, Fit_default as Fit, component_default$7 as GLTFModel, GlobalAudio, GradientTexture_default as GradientTexture, Grid_default as Grid, component_default$8 as Helper, holographicMaterial_default as HolographicMaterial, HTML_default as Html, Icosahedron_default as Icosahedron, component_default$9 as Image, KeyboardControls_default as KeyboardControls, LOD_default as LOD, component_default$10 as Lensflare, Levioso_default as Levioso, lightformer_default as Lightformer, Line2_default as Line2, MapControls_default as MapControls, MarchingCube_default as MarchingCube, MarchingCubes_default as MarchingCubes, MarchingPlane_default as MarchingPlane, component_default$11 as Mask, meshDiscardMaterial_default as MeshDiscardMaterial, meshGlassMaterial_default as MeshGlassMaterial, meshReflectionMaterial_default as MeshReflectionMaterial, meshWobbleMaterial_default as MeshWobbleMaterial, MouseParallax_default as MouseParallax, Ocean_default as Ocean, Octahedron_default as Octahedron, OrbitControls_default as OrbitControls, component_default$12 as Outline, Plane_default as Plane, component_default$13 as PointMaterial, PointerLockControls_default as PointerLockControls, PositionalAudio_default as PositionalAudio, Precipitation_default as Precipitation, QuadraticBezierLine_default as QuadraticBezierLine, component_default$14 as RandomizedLights, Reflector_default as Reflector, Ring_default as Ring, RoundedBox_default as RoundedBox, component_default$15 as Sampler, ScreenQuad_default as ScreenQuad, ScreenSizer_default as ScreenSizer, ScreenSpace_default as ScreenSpace, ScrollControls_default as ScrollControls, Sky_default as Sky, Smoke_default as Smoke, SoftShadows_default as SoftShadows, component_default$16 as Sparkles, Sphere_default as Sphere, Stage_default as Stage, Stars_default as Stars, Stats, StatsGl, Superformula_default as Superformula, Tetrahedron_default as Tetrahedron, Text3D_default as Text3D, Torus_default as Torus, TorusKnot_default as TorusKnot, TransformControls_default as TransformControls, Tube_default as Tube, component_default$17 as UseSVG, component_default$18 as UseTexture, ensureTextureNames, extractBindingPosition, getTextureAspect, getTextureName, hasSetter, invalidateDecalGeometry, pick, useAnimations, useBVH, useDecalEditor, useEnvironment, useFBO, useFBX, useGLTF, useGLTFExporter, useHelper, useIntersect, useMask, useProgress, useSVG, useSurfaceSampler, useTexture, useTextures, useVideoTexture };
+export { component_default as AccumulativeShadows, Align_default as Align, component_default$1 as AnimatedSprite, Backdrop_default as Backdrop, BakeShadows, BaseCameraControls, Billboard_default as Billboard, component_default$2 as Bounds, Box_default as Box, CameraControls_default as CameraControls, CameraShake_default as CameraShake, CatmullRomCurve3_default as CatmullRomCurve3, Circle_default as Circle, CircleShadow_default as CircleShadow, Cone_default as Cone, ContactShadows_default as ContactShadows, component_default$3 as CubeCamera, CubicBezierLine_default as CubicBezierLine, customShaderMaterial_default as CustomShaderMaterial, Cylinder_default as Cylinder, Decal_default as Decal, DecalDebugUI_default as DecalDebugUI, Dodecahedron_default as Dodecahedron, Edges_default as Edges, component_default$4 as Environment, component_default$5 as FBXModel, component_default$6 as Fbo, Fit_default as Fit, component_default$7 as GLTFModel, GlobalAudio, GradientTexture_default as GradientTexture, Grid_default as Grid, component_default$8 as Helper, holographicMaterial_default as HolographicMaterial, HTML_default as Html, Icosahedron_default as Icosahedron, component_default$9 as Image, KeyboardControls_default as KeyboardControls, LOD_default as LOD, component_default$10 as Lensflare, Levioso_default as Levioso, lightformer_default as Lightformer, Line2_default as Line2, MapControls_default as MapControls, MarchingCube_default as MarchingCube, MarchingCubes_default as MarchingCubes, MarchingPlane_default as MarchingPlane, component_default$11 as Mask, meshDiscardMaterial_default as MeshDiscardMaterial, meshGlassMaterial_default as MeshGlassMaterial, meshReflectionMaterial_default as MeshReflectionMaterial, meshTransmissionMaterial_default as MeshTransmissionMaterial, meshWobbleMaterial_default as MeshWobbleMaterial, MouseParallax_default as MouseParallax, Ocean_default as Ocean, Octahedron_default as Octahedron, OrbitControls_default as OrbitControls, component_default$12 as Outline, Plane_default as Plane, component_default$13 as PointMaterial, PointerLockControls_default as PointerLockControls, PositionalAudio_default as PositionalAudio, Precipitation_default as Precipitation, QuadraticBezierLine_default as QuadraticBezierLine, component_default$14 as RandomizedLights, Reflector_default as Reflector, Ring_default as Ring, RoundedBox_default as RoundedBox, component_default$15 as Sampler, ScreenQuad_default as ScreenQuad, ScreenSizer_default as ScreenSizer, ScreenSpace_default as ScreenSpace, ScrollControls_default as ScrollControls, Sky_default as Sky, Smoke_default as Smoke, SoftShadows_default as SoftShadows, component_default$16 as Sparkles, Sphere_default as Sphere, Stage_default as Stage, Stars_default as Stars, Stats, StatsGl, Superformula_default as Superformula, Tetrahedron_default as Tetrahedron, Text3D_default as Text3D, Torus_default as Torus, TorusKnot_default as TorusKnot, TransformControls_default as TransformControls, Tube_default as Tube, component_default$17 as UseSVG, component_default$18 as UseTexture, ensureTextureNames, extractBindingPosition, getTextureAspect, getTextureName, hasSetter, invalidateDecalGeometry, pick, useAnimations, useBVH, useDecalEditor, useEnvironment, useFBO, useFBX, useGLTF, useGLTFExporter, useHelper, useIntersect, useMask, useProgress, useSVG, useSurfaceSampler, useTexture, useTextures, useVideoTexture };