Skip to content
This repository was archived by the owner on Feb 1, 2026. It is now read-only.

CHANGELOG.md

Latest commit

 

History

History
803 lines (522 loc) · 62.6 KB

CHANGELOG.md

File metadata and controls

803 lines (522 loc) · 62.6 KB
Raw

Changelog

5.0.0 (2025-09-20)

Features

Bug Fixes

5.0.0-rc.0 (2025-09-20)

5.0.0-alpha.1 (2025-09-06)

Features

  • enhance useAnimations composable with manual update option (#637) (b2b60e6)

5.0.0-alpha.0 (2025-08-30)

Features

  • set peer @tresjs/core to 5.0.0 and alpha, updated dev deps (#641) (48817fd)

5.0.0-next.7 (2025-08-11)

Features

  • add traverse option to model loaders (#635) (421350f)

Bug Fixes

  • enhance audio and sprite loading logic (4319fa9)

5.0.0-next.6 (2025-07-31)

Bug Fixes

  • orbit-controls: added key to force re-render (c93f6c1)

5.0.0-next.5 (2025-07-08)

⚠ BREAKING CHANGES

  • useFBX no longer returns the plain obj, it now returns an object with reactive data (state, isLoading, error) and a load method.
  • Updated vue to version 3.5.17 and three to version 0.178.0 in package.json for enhanced compatibility and features.
  • Upgraded @vitejs/plugin-vue to version 6.0.0 and vite to version 7.0.2 to leverage the latest improvements in the build process.
  • Enhanced the useFBX composable to provide a reactive state for loading FBX models, allowing for better handling of model properties and loading states.
  • Improved the FBXModel component to support shadow properties and added a new demo for better visualization of FBX model loading.
  • Updated documentation to reflect changes in the FBX model loading process and added examples for better clarity.
  • fix(TheModel.vue): remove unused type import for improved clarity
  • Removed the unused import of Group from TheModel.vue to enhance code clarity and maintainability. This change aligns with the ongoing effort to streamline type imports and improve type safety across the codebase.
  • feat: expose model state in useFBX and useGLTF components
  • Added defineExpose to both useFBX and useGLTF components to expose the reactive model state, allowing for better integration and access to the model instance in parent components.
  • This enhancement improves the usability of the components by providing a direct reference to the model state, facilitating more dynamic interactions and updates.
  • fix(useFBX): add missing comma in defineExpose for model instance
  • Added a missing comma in the defineExpose call within the useFBX component to ensure proper syntax and prevent potential runtime errors. This minor fix enhances code clarity and maintains consistency in the component's structure.

Features

5.0.0-next.4 (2025-06-30)

Bug Fixes

  • create a local raycast for the HTML component (#627) (614505f)
  • transform-controls: use correct emit on mouse up (#625) (f04a63c)

5.0.0-next.3 (2025-06-22)

Bug Fixes

5.0.0-next.2 (2025-06-15)

Bug Fixes

  • adapt to renderer.isntance no longer being shallowRef (430534a)
  • remove unused type import in MouseParallax.vue (0899ecf)
  • type issues from v5 (bd0e0c6)

5.0.0-next.1 (2025-06-15)

5.0.0-next.0 (2025-06-06)

⚠ BREAKING CHANGES

  • cientos is now ESM only
  • Added 'es' format to the Vite configuration for better module compatibility.
  • Removed the UMD globals section from the output configuration as it is no longer necessary, streamlining the build process.
  • useGLTF no longer returns the plain obj, it now returns an object with reactive data (state, isLoading, error) and a load method.
  • Refactored GLTF loading in components to use the updated useGLTF composable, improving state management and performance.
  • Removed unnecessary Suspense wrappers in demo components for cleaner rendering.
  • Added new demo components for showcasing GLTF model loading with DRACO compression.
  • Updated documentation to reflect changes in GLTF model usage.
  • fix: update import syntax and clean up unused code
  • Changed import statement for TresObject in gltf-model.md to use the correct TypeScript syntax.
  • Removed unused imports in use-gltf/index.vue for cleaner code.
  • Added ESLint directive to disable console warnings in TheModel.vue for development purposes.
  • docs: update useGLTF implementation and clean up components
  • Refactored components to utilize the new useGLTF structure, replacing direct access to nodes with reactive state management.
  • Removed unused imports and commented-out code for improved clarity and maintainability.
  • Updated documentation references to reflect changes in component usage and structure.
  • feat: adapt useAnimations to new useAsyncState loader's model
  • Added a new demo page for use-animations showcasing the animated GLTF model.
  • Refactored the useAnimations composable to support reactive animations using MaybeRef.
  • Updated the TheModel.vue component to utilize the new reactive state for animations.
  • Enhanced the main demo layout with TresCanvas, OrbitControls, and lighting for improved visualization.
  • chore: update @tresjs/core dependency to version 5.0.0-next.0
  • Changed the dependency for @tresjs/core in package.json and playground/vue/package.json to the stable version 5.0.0-next.0 from a previous URL reference.
  • Updated pnpm-lock.yaml to reflect the new version of @tresjs/core across all relevant sections.
  • Adjusted the useGLTF implementation in documentation to align with the new state management approach.

Features

  • 608 drop umd support (#622) (14afe95)
  • 609-refactor-usegltf (#610) (13943b0)
  • 611 move cores usetexture to cientos (#617) (430377d)
  • 615-adapt-camera-dependant-abstractions-to-core-v5-camera-changes (#621) (682d38f)
  • 616-adapt-code-to-core-ctx-renderer-state-breaking-change (#620) (2ae981f)
  • AccumulativeShadows: add component, demo, docs (#558) (7e6b8d0)
  • Bounds: add component, demo, docs (#408) (#568) (592ec68)
  • CircleShadow: add component, demo, docs (#549) (c0c1bcc)
  • CubicBezierLine: add component, demo, docs (#546) (99c3a60)
  • Helper: add component, demo, docs (#543) (63535a2)
  • LOD: add component, playground, docs (#524) (ef6438c)
  • MarchingCubes: add component, demo, docs (#553) (2ebc1e6)
  • PointMaterial: add component, demo, docs (#545) (4528f64)
  • QuadraticBezierLine: add component, demo, docs (#548) (4a9f006)
  • ScreenQuad: add component, playground, docs (#530) (34a3db5)
  • Stage: add component, demo, docs (#572) (9db8c78)
  • useIntersect: add function, demo, docs (#550) (b0ba621)

Bug Fixes

  • fixes to next components and docs (#586) (bc54a1d)
  • return nodes and materials computed directly (#612) (4fe342a)
  • rollback to previous use tres usage (#623) (cfa38b1)

4.3.1 (2025-05-16)

Bug Fixes

  • deps: update @tresjs/core and @types/three to latest versions (#619) (9a94785)

4.3.0 (2025-03-25)

Features

  • environment: enhance environment and background props (#590) (7e96136)

4.2.0 (2025-03-07)

Features

  • OrbitControls: add mouseButtons prop to customize mouse interactions (#603) (5a7c2ca)

4.1.1 (2025-03-05)

Bug Fixes

  • remove will-change that makes Html components blurry (#602) (2b50296)
  • update html on camera dolly zoom (#600) (e5628f2)

4.1.0 (2025-01-17)

Features

Bug Fixes

  • 581 environment lightformers are not working (#584) (653a5df)
  • build dts error TS7056 (#521) (c16c6e5)
  • deps: update dependency @tresjs/core to v4.3.0 (#503) (83fa2bf)
  • deps: update dependency vue-router to v4.4.5 (#488) (0840b88)
  • instance properties and fix demo (#561) (f0fb337)
  • KeyboardControls: support non-qwerty keyboards (#573) (#574) (efdde6d)
  • MeshReflectionMaterial: remove unneeded material.onBeforeRender (#534) (f622324)
  • typescript build issues (#578) (09584be)
  • update core version with patch (#508) (cbae8ee)

4.0.3 (2024-10-04)

Bug Fixes

  • deps: update dependency @tresjs/core to v4.2.10 (#479) (fb3026a)
  • discrepancy between param enableDamping in OrbitControl (#486) (97a224c)

4.0.2 (2024-08-30)

Bug Fixes

  • useGltf: use-loader fix for gltf with textures (#480) (f1f983f)

4.0.1 (2024-08-30)

Bug Fixes

  • adapt to changes on useloader for Cube Textures (#476) (3641dc6)
  • deps: update dependency @tresjs/core to v4.2.7 (#466) (0596353)

4.0.0 (2024-08-20)

Features

Bug Fixes

  • SkyDemo: value.value -> value (82fe77b)
  • vue attrs hyphenation issues (4f9b61b)

4.0.0-rc.2 (2024-07-26)

4.0.0-rc.1 (2024-07-25)

Features

  • fbo: add autoRender flag as an option to useFBO (#458) (ddcd4ac)

4.0.0-rc.0 (2024-07-24)

Features

Bug Fixes

  • reimplement ContactShadows for v4 (#449) (d71c328)
  • update to core v4.2.2 to remove warning on invalidation (42afa6e)

4.0.0-next.1 (2024-07-17)

⚠ BREAKING CHANGES

  • MeshReflectionMaterial: add features/docs, reorganize

Features

  • 423 enable on demand render mode usage (#436) (b3eef40)
  • AnimatedSprite: add asSprite prop (7a14b55)
  • AnimatedSprite: dispose texture onUnmounted (18d6904)
  • AnimatedSprite: remove explicit click event (042c350)
  • AnimatedSprite: remove unnecessary Suspense (082d695)
  • app: 421 Update components to use useLoop instead of useRenderLoop (ad3b290)
  • app: Add the option for x and y in mouseparallax component (#444) (12d5834)
  • re-remove tweakpane (#425) (72284ce)
  • update to core v4.2 (14b30f9)

Bug Fixes

  • Lensflare demo: add camera #435 (#441) (981de57)
  • MeshReflectionMaterial: add features/docs, reorganize (58703e3)
  • remove hardcoded speed number, that setting at 0 doesn't stop the effect (e67f3a2)
  • SkyDemo: value.value -> value (82fe77b)
  • types: fixed types generics for useGLTF (#448) (62a9bcc)
  • uncomment section (fac2253)
  • vue attrs hyphenation issues (4f9b61b)

4.0.0-next.0 (2024-03-27)

⚠ BREAKING CHANGES

  • app: 349 Remove directives from cientos
  • app: 227 Change the keyboardcontrols implementation

Features

  • add arrow keys support (39e2094)
  • AnimatedSprite: add AnimatedSprite, playground, docs (d6ea81b)
  • AnimatedSprite: allow [numCols, numRows] as atlas prop (3309d9c)
  • AnimatedSprite: always emit last frame name on loop and on end (ed16136)
  • AnimatedSprite: change default fps (44831a4)
  • app: 227 Change the keyboardcontrols implementation (fed0f86)
  • app: 227 Final details, ready to go (6f06213)

Bug Fixes

  • AnimatedSprite: return nullFrame animation if requested animation not found (453819e)
  • Atlas: add missing argument to function call (e6b147e)

Code Refactoring

  • app: 349 Remove directives from cientos (8fc4cd5)

3.9.0 (2024-05-07)

Features

  • add local props (b9192fb)
  • add camera recognition for default props setup (c8ebba0)
  • app: 252 adding ocean component (7efb293)
  • app: 252 Renamed as ocean, add sky support (473bac6)
  • app: Add holographic material to cientos (f0f4eab)
  • app: Add RoundedBox component (8b6cb67)
  • cientos/positional-audio: add positional audio component (39c334c)
  • cientos/positional-audio: adding more logic and examples for playground (73c94de)
  • cientos/positional-audio: delete medias, modifications doc (ae34177)
  • cientos/positional-audio: demo clean (7bc1b61)
  • cientos/positional-audio: documentation v1, main example v1 (bb68bda)
  • cientos/positional-audio: fix issues async, add gui example doc (65c4c17)
  • cientos/positional-audio: fix lint issue, wip doc (4e2b5fb)
  • cientos/positional-audio: fix material issue for the helper, documentation wip (e0d8f41)
  • cientos/positional-audio: fix positional async helper and documentation (f1b9476)
  • cientos/positional-audio: improve documentation (00c4551)
  • cientos/positional-audio: improve documentation (eb30d85)
  • cientos/positional-audio: improve documentation (8b65696)
  • cientos/positional-audio: improve documentation (a0f02a2)
  • cientos/positional-audio: improved code and documentation (46ca4c4)
  • cientos/positional-audio: rename positionAudioRef (a036caa)
  • cientos/positional-audio: start writing documentation (1824cbb)
  • cientos/positional-audio: start writing documentation (6131e41)
  • cientos/transform-controls: add camera prop (0ce732d)
  • docs: add local prop to docs (d21694b)
  • Fit: add component, playground, demo (a521903)

Bug Fixes

  • add support for camera prop (7844743)
  • app: 252 Apply review feedback (4449208)
  • apply feedback (3a50bc2)
  • camera controls ignored props (37fa163)
  • docs: better description (703ab70)
  • little detail in the interface (fb6456a)
  • transformControls throws error when switching active camera (f1a477a)
  • type: correct the east description (c26da1f)

4.0.0-next.0 (2024-03-27)

Features

  • app: 252 adding ocean component (7efb293)
  • app: 252 Renamed as ocean, add sky support (473bac6)
  • app: Add RoundedBox component (8b6cb67)

Bug Fixes

  • app: 252 Apply review feedback (4449208)
  • apply feedback (3a50bc2)
  • little detail in the interface (fb6456a)

3.8.0 (2024-02-07)

Features

  • add BakeShadows component (77df084)
  • add gltfExporter composable (0c77d33)
  • app: 329 Add cast-shadow/receive-shadow to 3D model (471e28a)
  • reflection material (5cccaa9)

Bug Fixes

  • app: 336 Fix stats-gl problem (505e243)
  • deps: update dependency @tresjs/core to v3.7.0 (#333) (4d09ebb)
  • reduce beforeRenderer time (b9df580)
  • reduce lagging on the reflection (dca5c31)

Reverts

3.7.0 (2023-12-13)

Features

  • add 'change' event to pointerlock controls, improve docs (c394f10)
  • add rectAreaLightHelper to vLightHelper directive (#283) (8bc64a1)
  • add reflector (#136) (bd4d710)
  • sampler and useSampler (#286) (826833c)

Bug Fixes

  • remove wrapper element on unmounted (#310) (1a37c92)
  • wrap Text3D inside Suspense in the docs (#307) (27ce1f0)

3.6.0 (2023-11-07)

Features

Bug Fixes

  • avoid html container to be appended again (#278) (8c2b17d)

Reverts

3.5.1 (2023-10-18)

Bug Fixes

3.5.0 (2023-10-10)

Features

  • 178 v distance to (#220) (d2e2521)
  • 23 html component (#184) (3a488f0)
  • add <Fbo /> abstraction (#228) (6efc076)
  • add global-audio component (f66d81d)
  • change stats to renderless component (3ae6f5d)
  • Lines: add CatumullRomLine, Line2 (4a267a5)
  • Lines: add docs, correct name (f868d4e)
  • Lines: adjust types (e876314)
  • Lines: correct segments prop description (a22d25d)
  • Lines: fix linter errors (6ab3ef5)
  • Lines: format docs (a3b612f)
  • Lines: format docs (28e78b1)
  • Lines: make Line2 import relative (6788d8e)
  • Lines: remove unneeded refs, objects from demos (128ea59)
  • Lines: reword docs (45002ed)
  • remove pauseTrigger, now play-trigger element also work for pause state when is playing (6973f23)

Bug Fixes

  • 147 enhance environment and useenvironment abstractions (#219) (876fa9f)
  • deps: update dependency @tresjs/core to v3.3.0 (#200) (c33d383)
  • Levioso: changing speed causes jerkiness (#212) (a941576)
  • v3.4.1 (#238) (8be6c82)

3.4.1 (2023-09-27)

Bug Fixes

  • fake commit to force a patch (b1a055c)
  • remove es only format bundle (b9bb1b9)

3.4.0 (2023-09-26)

Features

  • add first directive vLog (071c63f)
  • add smoke demo (6aa3f06)
  • add stats-gl component (68bee97)
  • add v-always-look-at directive (ab3cfa3)
  • add v-light-helper component (d3e79d7)
  • cientos: 176 remove models (#199) (1314488)
  • cientos: 178 v-light-helper (#214) (0652eed)
  • Lensflare: add color, distance, size, texture to component (f90988e)
  • Lensflare: add defaultChoice (4246245)
  • Lensflare: add docs (dcd956b)
  • Lensflare: add Leches (14e03a0)
  • Lensflare: add Lensflare (6605eaa)
  • Lensflare: add Lensflare (fb1f52d)
  • Lensflare: add seed, color (c895fe1)
  • Lensflare: change exposed ref name (9279cfe)
  • Lensflare: clean up imports (b8ef198)
  • Lensflare: fix linter error (84f3a79)
  • Lensflare: fix linter errors (224ecc4)
  • Lensflare: fix path (7f18278)
  • Lensflare: fix paths (7bc7cd2)
  • Lensflare: formatting (fc8ad30)
  • Lensflare: group constants into objects (022529f)
  • Lensflare: guard against undefined ref value (2c6c912)
  • Lensflare: move easing functions to /src/utils (f443bbc)
  • Lensflare: move preset values to constants.ts (9766d6b)
  • Lensflare: move to own subdirectory (76e897c)
  • Lensflare: refactor Leches setup (f8c69c0)
  • Lensflare: refactor Leches setup (0715ccf)
  • Lensflare: remove 4, 8 sided textures (3c23042)
  • Lensflare: remove duplicate RandUtils (d816e8e)
  • Lensflare: remove scaleRef from demo (50271ea)
  • Lensflare: rename folder (3fc7374)
  • Lensflare: rename function, variables (e0c382d)
  • Lensflare: rename prop flare -> elements (fb199f6)
  • Lensflare: resolve infinite while loop bug (dfa5d8a)
  • Lensflare: scale fix (c439895)
  • Lensflare: simplify prop precedence (91833e6)
  • Lensflare: smooth out types/conversion (b9a60e8)
  • Lensflare: update route to LensflareDemo (7dfce1b)
  • Lensflare: update seed with random value (fba64dc)
  • Lensflare: use Tresjs/assets for texture URLS (3dc7e90)
  • RandUtils: add RandUtils (e1693c1)
  • RandUtils: add RandUtils (5fa7111)
  • remove cardbobot, suzanne. Add blender-cube in backdrop demo (c9f95ac)
  • Sky: add distance prop to docs (5c29e9b)
  • Sky: add distance to demo (7440216)
  • Sky: add docs (110e4a8)
  • Sky: add exposure to demo (323fc82)
  • Sky: add Sky (894d71e)
  • Sky: change azimuth default (12b7c38)
  • Sky: disable zoom/pan idiomatically in demo (08d2f67)
  • Sky: fix linter whitespace errors (dbc191d)
  • Sky: make prop descriptions consistent in docs (a62b6d2)
  • Sky: remove grid (0eaa3e6)
  • Sky: remove unused ref from from demo (4968785)
  • Sky: set demo max mieDirectionalG to 0.99 (a4475db)
  • Sky: use Vue props instead of watchers for uniforms (c45ed6f)

Bug Fixes

  • check background prop if its empty string (#217) (ec20d69)
  • use camera's z position as default distance in CameraControls (8a62a43)

3.3.0 (2023-09-11)

Features

Bug Fixes

3.3.0-next.0 (2023-09-11)

Features

Bug Fixes

3.2.1 (2023-09-01)

Bug Fixes

  • deps: update dependency @tresjs/core to v3.1.1 (#186) (0f5d9cf)
  • removed toFixed for progress value (#191) (d46f90f)

3.2.0 (2023-08-25)

Features

Bug Fixes

3.2.0-next.0 (2023-08-23)

Features

Bug Fixes

  • remove tweakpane essentials import (eeed334)

3.1.0 (2023-08-17)

Features

  • add camera controls to new context (21ab955)
  • chg to event, rmv vmodel, (9b739a2)
  • remove tweakpane deps from final bundle (#169) (b99ac3c)

Bug Fixes

3.0.1 (2023-07-29)

Bug Fixes

  • removed axesHelper from Contact Shadows (#152) (821205a)

3.0.0 (2023-07-29)

⚠ BREAKING CHANGES

  • core v3 provides a new state context useTresContext which impacts all the abstractions depending on the state

  • chore: move core to deps

  • chore: updated lock

  • chore: fix lint

  • feat: removed useCientos and useTresContext instead

Features

  • 120 refactor usecientos to new state context provider (#143) (723a323)
  • add more camera-controls playground examples (d3c5dd3)
  • add preliminary camera-controls abstraction (bef41b9)
  • backdrop stage abstraction (#116) (62f677c)

Bug Fixes

  • add reactivity to stars component, rmv factor as props unnecessary (#144) (ad5c6c8)
  • background not checked right useEnvironment (#138) (28d40fd)
  • map correct camera-controls events (e7095eb)
  • MouseParallax, clean code (#134) (257238a)
  • nuxt problem with scrollControls (#130) (1739965)

2.3.0 (2023-07-11)

Features

Bug Fixes

2.2.0 (2023-06-29)

Features

Bug Fixes

  • add playground to examples (#104) (ce442a4)
  • added default for touches prop (#100) (#111) (de6ebab)
  • deps: update dependency @tresjs/core to v2.3.0 (599f36b)
  • styles in dark theme, same as in the core (#105) (1a8d0a5)
  • useProgress correct export from loaders (af33533)

2.1.4 (2023-06-14)

Bug Fixes

  • chg log linter rule to warn (18eeb72)
  • fix types in precipitation, stars. rmv log rule linter (1c15ecb)
  • precipitation-area issue, rmv log mouseparallax, add rule lint (994efaa)
  • return control value on event emitters (d072223)

2.1.2 (2023-05-26)

Bug Fixes

  • fix lint on the demo (8873e41)
  • refactor transform controls with deconstructor (8e7f673)

2.1.1 (2023-05-24)

Bug Fixes

  • contact shadows helper as prop (f7054d0)

2.1.0 (2023-05-24)

Features

  • add events to orbit controls (6815d12)
  • add Rain component (7dca86d)
  • contact shadows is alive and reactive (188cf8c)
  • contact-shadows implementation (81baf86)
  • deconstruct those Props (ccd0581)
  • enhanced orbit-controls (27f2e88)
  • temporally tweak eslint for deconstructed props (8803e8f)
  • update parallax mouse abstraction (88885a3)
  • update to core v2.1.0 and fix types (f099387)

Bug Fixes

  • added missing prop target and removed withDefaults (43ddf6b)
  • change smoke texture encoding for colorSpace (2338803)
  • core types (266088b)
  • event headline h2 (c506769)
  • remove import leftovers (fef7e86)
  • templateRef name casing (8844612)

2.0.0 (2023-05-12)

2.0.0-rc.3 (2023-05-08)

Bug Fixes

2.0.0-rc.1 (2023-05-03)