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
traverseoption for custom model processing (#635) -
Core Integration: Updated to work with @Tresjs/core v5.0.0 breaking changes (#620, #621)
🐛 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
Contributors
alvarosabu, lihbr, and JaimeTorrealba