@tresjs/cientos 5.9.0 → 5.9.1

package/dist/trescientos.js

@@ -1,11 +1,11 @@
 /**
   * name: @tresjs/cientos
-  * version: v5.9.0
+  * version: v5.9.1
   * (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/)
   */
-import { Fragment, Suspense, Transition, computed, createBlock, createCommentVNode, createElementBlock, createElementVNode, createTextVNode, createVNode, defineComponent, inject, isReactive, isRef, mergeDefaults, mergeProps, nextTick, normalizeClass, normalizeProps, normalizeStyle, onBeforeUnmount, onMounted, onScopeDispose, 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 { Fragment, Suspense, Transition, computed, createBlock, createCommentVNode, createElementBlock, createElementVNode, createTextVNode, createVNode, defineComponent, guardReactiveProps, inject, isReactive, isRef, mergeDefaults, mergeProps, nextTick, normalizeClass, normalizeProps, normalizeStyle, onBeforeUnmount, onMounted, onScopeDispose, 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 { INJECTION_KEY, TresPortal, 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, DynamicDrawUsage, EdgesGeometry, EqualStencilFunc, EquirectangularReflectionMapping, Euler, FloatType, FramebufferTexture, FrontSide, Group, HalfFloatType, IcosahedronGeometry, InstancedBufferAttribute, 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";
@@ -92,6 +92,7 @@ var Align_vue_vue_type_script_setup_true_lang_default = /* @__PURE__ */ defineCo
 			if (!outer.value || !inner.value || !ref$1.value) return;
 			outer.value.matrixWorld.identity();
 			box3.setFromObject(inner.value, props.precise);
+			if (box3.isEmpty()) return;
 			const width = box3.max.x - box3.min.x;
 			const height = box3.max.y - box3.min.y;
 			const depth = box3.max.z - box3.min.z;
@@ -6088,60 +6089,71 @@ var RandomizedLights = class extends Group {
 	castShadow = true;
 	/** Default shadow bias */
 	bias = 0;
+	_mapSize = 512;
+	_size = 10;
+	_near = .5;
+	_far = 500;
 	constructor(config = {}) {
 		super();
 		Object.assign(this, config);
 		if (this.count === 0) this.count = 8;
-		if (!config.mapSize) this.mapSize = 512;
-		if (!config.size) this.size = 10;
-		if (!config.near) this.near = .5;
-		if (!config.far) this.far = 500;
 	}
 	get length() {
 		return this.position.length();
 	}
 	set count(n) {
+		for (const light of this.lights) light.dispose();
 		this.clear();
 		for (let i = 0; i < n; i++) this.add(new DirectionalLight("white", this.intensity));
+		this.configureShadows();
 	}
 	get count() {
 		return this.children.filter((c) => "isDirectionalLight" in c).length;
 	}
 	get mapSize() {
-		return this.lights[0].shadow.mapSize.width;
+		return this._mapSize;
 	}
 	set mapSize(n) {
-		for (const light of this.lights) {
-			light.shadow.mapSize.set(n, n);
-			light.shadow.map?.setSize(n, n);
-		}
+		this._mapSize = n;
+		this.configureShadows();
 	}
 	get size() {
-		return this.lights[0].shadow.camera.right;
+		return this._size;
 	}
 	set size(n) {
-		for (const light of this.lights) {
-			light.shadow.camera.left = -n;
-			light.shadow.camera.right = n;
-			light.shadow.camera.top = n;
-			light.shadow.camera.bottom = -n;
-		}
+		this._size = n;
+		this.configureShadows();
 	}
 	get near() {
-		return this.lights[0].shadow.camera.near;
+		return this._near;
 	}
 	set near(n) {
-		for (const light of this.lights) light.shadow.camera.near = n;
+		this._near = n;
+		this.configureShadows();
 	}
 	get far() {
-		return this.lights[0].shadow.camera.far;
+		return this._far;
 	}
 	set far(n) {
-		for (const light of this.lights) light.shadow.camera.far = n;
+		this._far = n;
+		this.configureShadows();
 	}
 	get lights() {
 		return this.children.filter((c) => "isDirectionalLight" in c);
 	}
+	configureShadows() {
+		for (const light of this.lights) {
+			light.shadow.mapSize.set(this._mapSize, this._mapSize);
+			light.shadow.map?.setSize(this._mapSize, this._mapSize);
+			light.shadow.camera.left = -this._size;
+			light.shadow.camera.right = this._size;
+			light.shadow.camera.top = this._size;
+			light.shadow.camera.bottom = -this._size;
+			light.shadow.camera.near = this._near;
+			light.shadow.camera.far = this._far;
+			light.shadow.camera.updateProjectionMatrix();
+		}
+	}
 	update() {
 		const lights = this.lights;
 		const lightIntensity = this.intensity / lights.length;
@@ -6400,6 +6412,12 @@ var ProgressiveLightMap = class {
 		this.scene.background = oldBg;
 		this.scene.environment = oldEnv;
 	}
+	dispose() {
+		this.progressiveLightMap1.dispose();
+		this.progressiveLightMap2.dispose();
+		this.discardMat.dispose();
+		this.targetMat.dispose();
+	}
 };
 
 //#endregion
@@ -6515,6 +6533,8 @@ var component_vue_vue_type_script_setup_true_lang_default$13 = /* @__PURE__ */ d
 		const gLights = shallowRef(new Group());
 		const progressiveLightMap = computed(() => new ProgressiveLightMap(renderer, scene.value, props.resolution));
 		const shadowMapTexture = shallowRef();
+		watch(progressiveLightMap, (_, previous) => previous.dispose());
+		onUnmounted(() => progressiveLightMap.value.dispose());
 		let frameCount = 0;
 		let frameLimitRemaining = props.limit;
 		function reset() {
@@ -9781,6 +9801,10 @@ var index_vue_vue_type_script_setup_true_lang_default$3 = /* @__PURE__ */ define
 		const hasDepth = computed(() => props.sharpDepthScale > 0 || props.blurDepthScale > 0);
 		const hasDistortion = computed(() => !!props.distortionMap);
 		const hasRoughness = computed(() => !!props.roughnessMap);
+		const tresProps = computed(() => {
+			const { resolution: _r, blurSize: _bs, blurDepthEdgeMin: _bdemin, blurDepthEdgeMax: _bdemax, blurDepthScale: _bds, blurDepthBias: _bdb, reflectorOffset: _ro, ...rest } = props;
+			return rest;
+		});
 		const materialRef = shallowRef();
 		let blurpass;
 		const state = {
@@ -9927,7 +9951,7 @@ var index_vue_vue_type_script_setup_true_lang_default$3 = /* @__PURE__ */ define
 				key: `key${hasBlur.value ? "0" : "1"}${hasDepth.value ? "0" : "1"}${hasDistortion.value ? "0" : "1"}${hasRoughness.value ? "0" : "1"}`,
 				ref_key: "materialRef",
 				ref: materialRef
-			}, props, {
+			}, tresProps.value, {
 				"texture-matrix": state.textureMatrix,
 				"t-sharp": unref(fboSharp)?.texture,
 				"t-depth": unref(fboSharp)?.depthTexture,
@@ -16577,6 +16601,41 @@ var component_vue_vue_type_script_setup_true_lang_default = /* @__PURE__ */ defi
 //#region src/core/staging/Sparkles/component.vue
 var component_default$16 = component_vue_vue_type_script_setup_true_lang_default;
 
+//#endregion
+//#region src/utils/index.ts
+/**
+* Update the function signature to explicitly specify the type of the props parameter
+*
+* @export
+* @template T
+* @template K
+* @param {T} obj
+* @param {K[]} props
+* @return {*}  {Pick<T, K>}
+*/
+function pick(obj, props) {
+	const pickedProperties = {};
+	for (const prop of props) if (Object.hasOwn(obj, prop)) pickedProperties[prop] = obj[prop];
+	return pickedProperties;
+}
+/**
+* Check if the object has a setter for the given property
+*
+* @export
+* @param {*} obj
+* @param {string} prop
+* @return {*}  {boolean}
+*/
+function hasSetter(obj, prop) {
+	return obj[`set${prop[0].toUpperCase()}${prop.slice(1)}`] !== void 0;
+}
+function extractBindingPosition(binding) {
+	let observer = binding.value;
+	if (binding.value && binding.value?.value?.isMesh) observer = binding.value.value.position;
+	if (Array.isArray(binding.value)) observer = new Vector3(...observer);
+	return observer;
+}
+
 //#endregion
 //#region src/core/staging/Stage.vue?vue&type=script&setup=true&lang.ts
 const _hoisted_1$1 = { key: 0 };
@@ -16610,7 +16669,8 @@ var Stage_vue_vue_type_script_setup_true_lang_default = /* @__PURE__ */ defineCo
 			type: [
 				Boolean,
 				String,
-				Object
+				Object,
+				null
 			],
 			required: false,
 			default: "contact"
@@ -16688,7 +16748,7 @@ var Stage_vue_vue_type_script_setup_true_lang_default = /* @__PURE__ */ defineCo
 			}
 		};
 		const radius = ref(2);
-		const height = ref(0);
+		const floor = ref(0);
 		const stageRef = shallowRef();
 		const boundsRef = shallowRef();
 		const alignRef = shallowRef();
@@ -16719,15 +16779,31 @@ var Stage_vue_vue_type_script_setup_true_lang_default = /* @__PURE__ */ defineCo
 			return lightingPresetComputed.value.fill.map((v) => v * radius.value);
 		});
 		const contactShadowsComputed = computed(() => {
-			if (props.shadows === true || props.shadows === "contact") return { type: "contact" };
-			else if (typeof props.shadows === "object" && props.shadows.type === "contact") return props.shadows;
+			if (props.shadows === true || props.shadows === "contact") return {};
+			else if (props.shadows && typeof props.shadows === "object" && props.shadows.type === "contact") return pick(props.shadows, Object.keys(ContactShadows_default.props));
 			else return null;
 		});
 		const accumulativeShadowsComputed = computed(() => {
-			if (props.shadows === "accumulative") return { type: "accumulative" };
-			else if (typeof props.shadows === "object" && props.shadows.type === "accumulative") return props.shadows;
+			if (props.shadows === "accumulative") return {};
+			else if (props.shadows && typeof props.shadows === "object" && props.shadows.type === "accumulative") return pick(props.shadows, Object.keys(component_default.props));
 			else return null;
 		});
+		const randomizedLightsComputed = computed(() => {
+			const shadows = props.shadows && typeof props.shadows === "object" ? props.shadows : {};
+			return {
+				count: shadows.count ?? 8,
+				radius: shadows.radius ?? radius.value,
+				intensity: shadows.intensity ?? 1.5,
+				ambient: shadows.ambient ?? .5,
+				castShadow: shadows.castShadow,
+				near: shadows.near,
+				far: shadows.far,
+				bias: -(shadows.bias ?? -1e-4),
+				mapSize: shadows.mapSize ?? shadows.size ?? 1024,
+				size: radius.value * 4,
+				position: shadows.position ?? lightingMainComputed.value
+			};
+		});
 		const environmentComputed = computed(() => {
 			if (props.environment === null) return null;
 			else if (!props.environment) return { preset: "city" };
@@ -16736,6 +16812,7 @@ var Stage_vue_vue_type_script_setup_true_lang_default = /* @__PURE__ */ defineCo
 		});
 		const onAlignChange = (alignProps) => {
 			radius.value = alignProps.boundingSphere.radius;
+			floor.value = props.align?.disable || props.align?.disableY ? alignProps.boundingBox.min.y : alignProps.verticalAlignment - alignProps.height / 2;
 			if (props.adjustCamera !== false) debouncedLookAt();
 		};
 		__expose({
@@ -16754,7 +16831,7 @@ var Stage_vue_vue_type_script_setup_true_lang_default = /* @__PURE__ */ defineCo
 						position: lightingMainComputed.value,
 						intensity: __props.intensity * 2,
 						castShadow: !!__props.shadows,
-						"shadow-bias": __props.shadows?.bias ?? 0,
+						"shadow-bias": __props.shadows?.bias ?? -1e-4,
 						"shadow-normalBias": __props.shadows?.normalBias ?? 0,
 						"shadow-mapSize-x": __props.shadows?.size ?? 1024,
 						"shadow-mapSize-y": __props.shadows?.size ?? 1024
@@ -16764,14 +16841,14 @@ var Stage_vue_vue_type_script_setup_true_lang_default = /* @__PURE__ */ defineCo
 						intensity: __props.intensity
 					}, null, 8, _hoisted_4)
 				])) : createCommentVNode("v-if", true),
-				createVNode(component_default$2, mergeProps({
+				createVNode(component_default$2, {
 					ref_key: "boundsRef",
 					ref: boundsRef,
 					clip: !!__props.adjustCamera,
 					offset: typeof props.adjustCamera === "boolean" ? .3 : props.adjustCamera,
 					"use-mounted": "",
 					"use-resize": ""
-				}, props), {
+				}, {
 					default: withCtx(() => [createVNode(Align_default, mergeProps({
 						ref_key: "alignRef",
 						ref: alignRef
@@ -16780,10 +16857,10 @@ var Stage_vue_vue_type_script_setup_true_lang_default = /* @__PURE__ */ defineCo
 						_: 3
 					}, 16)]),
 					_: 3
-				}, 16, ["clip", "offset"]),
+				}, 8, ["clip", "offset"]),
 				createElementVNode("TresGroup", { position: [
 					0,
-					-height.value / 2 - (__props.shadows?.offset ?? 0) / 2,
+					floor.value - (__props.shadows?.offset ?? 0),
 					0
 				] }, [
 					contactShadowsComputed.value ? (openBlock(), createBlock(unref(ContactShadows_default), mergeProps({
@@ -16801,25 +16878,7 @@ var Stage_vue_vue_type_script_setup_true_lang_default = /* @__PURE__ */ defineCo
 						"tone-mapped": true,
 						scale: radius.value * 4
 					}, accumulativeShadowsComputed.value), {
-						default: withCtx(() => [createVNode(unref(component_default$14), mergeProps({
-							position: lightingMainComputed.value,
-							count: accumulativeShadowsComputed.value.count ?? 8,
-							radius: accumulativeShadowsComputed.value.radius ?? radius.value,
-							intensity: accumulativeShadowsComputed.value.intensity ?? 1.5,
-							ambient: accumulativeShadowsComputed.value.ambient ?? .5,
-							size: radius.value * 4,
-							bias: accumulativeShadowsComputed.value.bias ?? 0,
-							"map-size": accumulativeShadowsComputed.value.size ?? 1024
-						}, accumulativeShadowsComputed.value), null, 16, [
-							"position",
-							"count",
-							"radius",
-							"intensity",
-							"ambient",
-							"size",
-							"bias",
-							"map-size"
-						])]),
+						default: withCtx(() => [createVNode(unref(component_default$14), normalizeProps(guardReactiveProps(randomizedLightsComputed.value)), null, 16)]),
 						_: 1
 					}, 16, ["scale"])) : createCommentVNode("v-if", true),
 					(openBlock(), createBlock(Suspense, null, {
@@ -16941,40 +17000,5 @@ var Stars_vue_vue_type_script_setup_true_lang_default = /* @__PURE__ */ defineCo
 //#region src/core/staging/Stars.vue
 var Stars_default = Stars_vue_vue_type_script_setup_true_lang_default;
 
-//#endregion
-//#region src/utils/index.ts
-/**
-* Update the function signature to explicitly specify the type of the props parameter
-*
-* @export
-* @template T
-* @template K
-* @param {T} obj
-* @param {K[]} props
-* @return {*}  {Pick<T, K>}
-*/
-function pick(obj, props) {
-	const pickedProperties = {};
-	for (const prop of props) if (Object.hasOwn(obj, prop)) pickedProperties[prop] = obj[prop];
-	return pickedProperties;
-}
-/**
-* Check if the object has a setter for the given property
-*
-* @export
-* @param {*} obj
-* @param {string} prop
-* @return {*}  {boolean}
-*/
-function hasSetter(obj, prop) {
-	return obj[`set${prop[0].toUpperCase()}${prop.slice(1)}`] !== void 0;
-}
-function extractBindingPosition(binding) {
-	let observer = binding.value;
-	if (binding.value && binding.value?.value?.isMesh) observer = binding.value.value.position;
-	if (Array.isArray(binding.value)) observer = new Vector3(...observer);
-	return observer;
-}
-
 //#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, INSTANCES_INJECTION_KEY, Icosahedron_default as Icosahedron, component_default$9 as Image, Instance_default as Instance, Instances_default as Instances, 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, MERGED_INJECTION_KEY, MapControls_default as MapControls, MarchingCube_default as MarchingCube, MarchingCubes_default as MarchingCubes, MarchingPlane_default as MarchingPlane, component_default$11 as Mask, Merged_default as Merged, meshDiscardMaterial_default as MeshDiscardMaterial, meshGlassMaterial_default as MeshGlassMaterial, meshPortalMaterial_default as MeshPortalMaterial, 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, PositionMesh, PositionalAudio_default as PositionalAudio, Precipitation_default as Precipitation, QuadraticBezierLine_default as QuadraticBezierLine, component_default$14 as RandomizedLights, Reflector_default as Reflector, Refractor_default as Refractor, Ring_default as Ring, RoundedBox_default as RoundedBox, RoundedPlane_default as RoundedPlane, 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 };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@tresjs/cientos",
   "type": "module",
-  "version": "5.9.0",
+  "version": "5.9.1",
   "description": "Collection of useful helpers and fully functional, ready-made abstractions for Tres",
   "author": "Alvaro Saburido <hola@alvarosaburido.dev> (https://github.com/alvarosabu/)",
   "license": "MIT",
@@ -41,7 +41,7 @@
     "access": "public"
   },
   "peerDependencies": {
-    "@tresjs/core": "5.9.0",
+    "@tresjs/core": "5.9.1",
     "three": ">=0.133",
     "vue": ">=3.5.17"
   },
@@ -76,8 +76,8 @@
     "vite-svg-loader": "^5.1.1",
     "vue": "^3.5.38",
     "vue-tsc": "^3.3.4",
-    "@tresjs/core": "5.9.0",
-    "@tresjs/eslint-config": "1.6.0"
+    "@tresjs/eslint-config": "1.6.0",
+    "@tresjs/core": "5.9.1"
   },
   "nx": {
     "implicitDependencies": [