v5.0.0

5.0.0 (2025-09-20)

⚠ BREAKING CHANGES

• ESM Only: Cientos is now ESM only - UMD support has been dropped for better module compatibility
• Peer Dependencies: Updated @Tresjs/core to v5.0.0
• useFBX: No longer returns the plain object. Now returns an object with reactive data (state, isLoading, error) and a load method
• useGLTF: No longer returns the plain object. Now returns an object with reactive data (state, isLoading, error) and a load method

✨ New Features

New Components

• AccumulativeShadows: Advanced shadow accumulation for realistic lighting (#558)
• Align: Component for object alignment operations (#544)
• Billboard: Always face-camera components (#527)
• Bounds: Automatic bounding box fitting (#568)
• CircleShadow: Circular shadow effects (#549)
• CubicBezierLine: Smooth cubic bezier curve lines (#546)
• CubeCamera: Cube camera for reflections and environment mapping (#537)
• Edges: Geometry edge highlighting (#390)
• GradientTexture: Procedural gradient textures (#531)
• Grid: 3D grid helper (#540)
• Helper: Generic three.js helper component (#543)
• Image: 2D image display in 3D space (#529)
• LOD: Level of Detail for performance optimization (#524)
• MarchingCubes: Metaball rendering (#553)
• Mask: Object masking capabilities (#552)
• MeshDiscardMaterial: Material with discard functionality (#525)
• Outline: Object outline effects (#532)
• PointMaterial: Point cloud material (#545)
• QuadraticBezierLine: Quadratic bezier curve lines (#548)
• ScreenQuad: Full-screen quad rendering (#530)
• ScreenSizer: Screen-relative sizing (#535)
• ScreenSpace: Screen space transformations (#536)
• SoftShadows: Soft shadow effects (#541)
• Stage: Pre-configured lighting and environment setup (#572)

New Composables

• useIntersect: Object intersection detection (#550)
• useTexture: Moved from @Tresjs/core to cientos (#617)

Enhanced Features

• useAnimations: Enhanced with manual update option (#637)

• Model Loaders: Added traverse option for custom model processing (#635)

• Core Integration: Updated to work with @Tresjs/core v5.0.0 breaking changes (#620, #621)

• release v5 (#563) (28808b5), closes #543

🐛 Bug Fixes

• precipitation speed (#643) (8958ecc)
• HTML: create local raycast for better interaction (#627)
• Transform Controls: use correct emit on mouse up (#625)
• TypeScript: resolved build issues and type compatibility (#624)
• Renderer: adapt to renderer.instance no longer being shallowRef
• OrbitControls: added key to force re-render and fixed parameter consistency
• Environment: fixed lightformer functionality (#584)

What's Changed

• fix: precipitation speed by @JaimeTorrealba in #643
• feat: release v5 by @alvarosabu in #563
• feat: add traverse option to model loaders #635 by @lihbr

Full Changelog: 4.3.1...5.0.0

v5.0.0-rc.0

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

Full Changelog: 5.0.0-alpha.1...5.0.0-rc.0

v5.0.0-alpha.1

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

Features

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

What's Changed

• feat: enhance useAnimations composable with manual update option by @alvarosabu in #637

Full Changelog: 5.0.0-alpha.0...5.0.0-alpha.1

v5.0.0-alpha.0

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

Features

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

What's Changed

• feat: alpha release by @alvarosabu in #641

Full Changelog: 5.0.0-next.7...5.0.0-alpha.0

v5.0.0-next.7

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)

What's Changed

• feat: add traverse option to model loaders by @lihbr in #635

New Contributors

• @lihbr made their first contribution in #635

Full Changelog: 5.0.0-next.6...5.0.0-next.7

v5.0.0-next.6

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

Bug Fixes

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

Full Changelog: 5.0.0-next.5...5.0.0-next.6

v5.0.0-next.5

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

• refactor useFBX (#628) (d59ef26)

What's Changed

• feat!: refactor useFBX by @alvarosabu in #628
• refactor: streamline instance exposure and remove unused refs by @alvarosabu in #629
• refactor(Atlas.ts): replace useLoader with TextureLoader for improved texture handling by @alvarosabu in #631
• refactor: replace SVG component with useSVG composable for improved SVG handling by @alvarosabu in #632

Full Changelog: 5.0.0-next.4...5.0.0-next.5

v5.0.0-next.4

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)

What's Changed

• fix(transform-controls): use correct emit on mouse up by @AsLogd in #625
• fix: create a local raycast for the HTML component by @alvarosabu in #627

New Contributors

• @AsLogd made their first contribution in #625

Full Changelog: 5.0.0-next.3...5.0.0-next.4

v5.0.0-next.3

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

Bug Fixes

• typescript issues (#624) (3c1640e)

What's Changed

• fix: typescript issues by @alvarosabu in #624

Full Changelog: 5.0.0-next.2...5.0.0-next.3

v5.0.0-next.2

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)

Full Changelog: 5.0.0-next.1...5.0.0-next.2