CHANGELOG.md

1.0.3 (2026-03-09)

Bug Fixes

• 👷 Should fix release GH action, attempt 8. (d876018)
• 👷 Should fix release GH action, attempt 9. (1607716)

1.0.2 (2026-03-09)

Bug Fixes

• 👷 Should fix release GH action, attempt 7. (3183019)

1.0.1 (2026-03-09)

Bug Fixes

• 👷 Should fix release GH action, attempt 6. (3db88c4)

1.0.0 (2026-03-09)

• [v1] SSR handling (#30) (95fd039)

Bug Fixes

• [v1] ssr / node fixes (#31) (c9df308)
• adapt rollups babel threshold to CRA (0698825)
• add reset method to TransformControls (#158) (7e25150)
• add HTMLMesh and InteractiveGroup to exports (#210) (9220981)
• add missing meta files to build (#257) (0c92d46)
• add story for PLC (#107) (5ec51f7)
• Add support for sRGBTransferOETF to fix the runtime error 'LinearTosRGB' : no matching overloaded function found (#380) (232a4cd)
• allow PLC connect to take a dom node (6366143)
• allow tree-shaking, cleanup (#84) (8cb5580)
• arcballcontrols scale and target (c7cc48c)
• babel-runtime should be dep when using plugin-transform-runtime (#39) (633e73d)
• BatchedMesh: move render hooks to constructor for dts (#311) (e7b3328)
• BatchedMesh: upstream fixes (#316) (6441de6)
• BatchedMesh: use zero-scale matrix for visibility (#314) (8a1b676)
• BufferGeometry rename uv2 to uv1 (#377) (442de29)
• buffergeometry uteil import (921e613)
• bug in arcballcontrols, handleresize must be public in trackballcontrols (3085d2f)
• build (04aa0df)
• build steps so we get the declaration files (2dce5f5)
• build-time annotations for tree-shaking, sourcemaps (#292) (ff8f2ff)
• Bumped Chevrotain to 10.1.2 to fix missing missing src map files. (#136) (ceed439)
• cannot append to UniformsLib (1d08c90)
• CCDIKHelper: missing scope (09db426)
• cjs transpiles, it should maintain classes (57382f3)
• classes should be called with this (f0ea855)
• colorSpace <=> encoding fallback (#232) (d7c8e9f)
• compat (#261) (6071171)
• constructors require new calls (7080889)
• controls event dispatcher types (#388) (5d9e6ec)
• convert CSS2DRenderer to ES6, use new matrix flags (#213) (5ade008)
• Convert MeshoptDecoder to es6 to handle flat import not exposed (27dc5dd)
• ConvexGeometry: support clone (#186) (95eb491)
• correctly flag targets for Node resolution (#157) (53960ea)
• create CTS definition aliases for NodeNext (#343) (8e15117)
• createControllerModel now unsubscribes from controller group events (#214) (c3cffec)
• CSS3DRenderer: modify perspective transform to avoid browser issues (#308) (4f06413)
• curly bracket position in USDZExporter (#100) (f6a201c)
• cursorzoom+ortho maxdist (6a8b853)
• curve modifier (39314c8)
• data3dtexture (6e7cda4)
• deprecate usage of *BufferGeometry aliases (#174) (3fb0473)
• domElement can be null, add checkers (b9ceb5a)
• don't locally increment version (#256) (5c0d28f)
• don't use Node ext for module field (#253) (df7cae7)
• don't use this in NURBSUtils (#146) (f47cfe4)
• dont call this before super (637f11d)
• dont need to call Function.call when it's a class (ab2e560), closes #52
• dont' access this before super (be82014), closes #62
• downgrade chevrotain for tree-shaking (#288) (6469af6)
• edgeSplit modifier constructor call (83d75c8)
• edgesplitmodifier (08e9a0a)
• enum => object (b87633c)
• error when used on server side via SVGRenderer (#398) (5b1448e)
• exclude globals (1399589)
• export GeometryUtils (#151) (5d46ce4)
• export shaders (#185) (e44de5f)
• export Timer (#217) (202c94c)
• export water2 as water2 (04087ac)
• EXRLoader: harden colorSpace compat (#264) (413ea5b)
• EXRLoader: support longname flag (#330) (45e22a1)
• Fix alignment of integer vertex attributes (#408) (c122b5c)
• flycontrols side effects, convert to pointer events (75d99d1)
• flycontrols type (79de3e6)
• force release? (48e90dd)
• GLTFExporter: alias colorspace properties (#248) (9037b4c)
• GLTFExporter: hoist static methods (#294) (2d0c6d5)
• GLTFExporter: return populated json (#313) (89d7e63)
• GLTFLoader compat (#260) (fd47a04)
• GLTFLoader forgot to remove GLBFormat (#121) (69a401b)
• GLTFLoader: add uv fallback (#227) (6eb82b7)
• GLTFLoader: align attenuation (#195) (de7b063)
• GLTFLoader: harden navigator check (73b1298)
• GLTFLoader: play nice with headless environments (#192) (8f4f9e8)
• GLTFLoader: remove alphawrite (#125) (ba6217b)
• GLTFLoader: revert use of TextDecoder (#228) (74c3774)
• GLTFLoader: unmangle missing constant (#238) (d4cef41)
• GLTFLoader: upstream with three (#226) (73531c8)
• harden GLTFLoader (#193) (1b44593)
• harden type qualifier keywords (646ba34)
• HDRCubeTextureLoader: colorSpace <=> encoding fallback (#339) (da07863)
• helpers: don't use this before construction (#205) (cffb859)
• hoisting (24dd59a)
• imports (1eb2091)
• Inline 'regexp-to-ast' dependency (#289) (d7e051d)
• KTX2Loader: mips, cube, p3 (#329) (833b47c)
• KTX2Loader: remove parse overload from types (017639d)
• KTX2Loader: web worker scope (#374) (22fb85e)
• Lensflare: FramebufferTexture => Texture (#144) (a11a320)
• Lensflare: implement framebuffer texture for GPU storage (#397) (7555435)
• lightmap (1023bcd)
• LightProbeHelper: cleanup use of this before super (#208) (92ba8f4)
• lineMaterial (174ab6c)
• LineMaterial accepts THREE Colors (#68) (67cff5f)
• LineMaterial: don't multiply unset vertexColors (#338) (fd81ff3)
• LineSegmentsGeometry: dynamic interleave offset (#336) (6a37a19)
• lint (d616b74)
• lint (c395985)
• lint (23ed8ab)
• loaders: add divergent loadAsync signatures (#258) (e3fc9e0)
• loaders: vendor decodeText for r165 deprecation (#371) (eab87ab)
• lottie-web: remove expressions eval (#415) (b51a7c9)
• lottie: harden SSR check (d274145)
• lottie: harden SSR check to exclude react-native (#424) (f7fe1af)
• LottieLoader: use lottie-web (#298) (6639f4d)
• main.yml (cfbe066)
• Make MapControls domElement parameter optional (#48) (017051d)
• make PLC domElement optional (690c6aa)
• make trackballcontrols domelement optional (46ac4f4)
• MeshOptDecoder not exported in dist (1c14fff)
• MeshoptDecoder: rewrite in TypeScript for types export (#235) (0ec4ef9)
• minor TS bugs (06e7f6e)
• missed master in branches config (4af8337)
• missing RaycasterHelper index export (#390) (c840a9b)
• modernize & tree-shake (#241) (858d35d)
• mouseButtons and touches allow undefined in OrbitControls (#220) (c0211c9)
• move LineGeometry methods from instance to prototype methods (#42) (fc4389a)
• move setting touchAction to .connect in orbit controls (#72) (a1274d6)
• NodeLoader: prune generated nodes (#234) (10a5ddb)
• OculusHandModel: don't accept array (#165) (1b1af21)
• OculusHandPointerModel: cleanup on disconnect, implement dispose (#266) (0a6a015)
• OculusHandPointerModel: safely dispose pointer mesh (#271) (048da9a)
• opentype: remove Node impl (9753e6b)
• options should be for textgeometry, not fontloader in specific (585d148)
• orbit controls stickiness regression (#102) (5809073)
• OrbitControls: don't preventDefault in wheel (#360) (0a5de57)
• OrbitControls: make "wheel" listener passive (#353) (f357e50)
• OrbitControls: make use of setPointerCapture (#297) (347c19c)
• OrbitControls: orthographic zoom update (#328) (21f7410)
• OrbitControls: remove document validation (0d281ea)
• OrbitControls: respect zoom (#252) (7c9c2b4)
• OrbitControls: restore touchAction on dispose (e1f6d3e)
• OrbitControls: revert passive wheel (#362) (d0dc70d)
• OrbitControls: update camera up direction (#273) (6616a6e)
• OrbitControls: update lookAt when matrixAutoUpdate false (#319) (f35f76e)
• OrbitControls: upstream fixes (#365) (5bf7324)
• ParametricGeometries: vendor ParametricGeometry (#180) (f74ba1b)
• pass.js -> pass (a6edd0b)
• polyfill Data3DTexture (#233) (6b3590a)
• postprocessing: use premult alpha (#277) (e7dad43)
• preserve modules (#306) (5382719)
• pull loaders from upstream (#109) (f384cd5)
• r137: remove RGBFormat (#115) (930cbb0)
• r154 shader chunk compat (#276) (4c04593)
• rebuild (#242) (a99e965)
• rebuild (#243) (0e08e98)
• rebuild (#255) (a28bb39)
• remove ctor side effects from timer (5302d15)
• remove deprecated keyCode in controls (#59) (cf15c71)
• remove depreciated encodings with r136 (#108) (3be7b18)
• remove keydown bindings for ArcballControls (fixes #110) (#118) (d21d57c)
• remove prototype.function.call because it doesn't work in classes (932021a)
• remove rgbformat (f9ff4da)
• remove type=module (#254) (8c41cd2)
• remove use of WebGL1 LuminanceFormat (#419) (e079bc8)
• removing backslash string line continuations (#209) (8325fd0)
• rename arcball._tbcenter to target, like any other control (6ff2738)
• rename setscale to applyscale (a86c644)
• rename timer.getelapsed to getelapsedtime for clock backward compat (e43a9c9)
• replace old Euler.toVector3 with setFromEuler (#200) (bb11a73)
• restore config (#250) (03d95e3)
• restore STLExporter (#321) (d5df2b3)
• return type (289d5e4)
• revert (1314a26)
• revert chevotain (#290) (ab3d413)
• revert rollup conf (#187) (3efa0e4)
• revert tree-shaking around use of classes (bc97e08)
• revert TS mods (#403) (6bed3f4)
• revert use of setPointerCapture (#305) (f58eee2)
• rgbe and rgbm (50d48dc)
• RGBELoader: upstream fixes (#358) (fb716b0)
• run prettier & add prettierignore (95da4b2)
• src/objects -> classes, Water.format (bb65634)
• SSR w/lottie (#299) (029c7a4)
• STLExporter: no positionAttributes + TS (#326) (a960357)
• storybook & WebGPURenderer (acfbca9)
• SVGLoader accepts Vector3 (#274) (4df2314)
• svgloader shouldnt parse masks (bcbef78)
• SVGLoader: upstream fixes (#359) (ea1e4bf)
• syntax errors in shaders (#405) (12f00a3)
• textgeo clone (2e0728b)
• textgeo clone broken (db34460)
• TiltLoader (51fd78a)
• trackball connect (37d3212)
• Transform Controls & add story (295ca10)
• transform controls event system can't have _ as preffix (cc079be), closes #51
• transform controls has wrong reference to this in defineProperty funciton (37b3de8)
• tree-shake chevrotain (#291) (7bf780c)
• tree-shake remaining libs (#304) (35e55ad)
• tree-shaking (e925563), closes #395
• tree-shaking (#395) (a9e93f2)
• turn FlakesTexture into ts file (#199) (6c478ac)
• type compatibility with @types/three@0.172.0 (#394) (f33f122)
• types: compatibility with @types/three@0.167.0 (#375) (40a4d33)
• types: move @types/offscreencanvas to dependencies (#177) (33c1831)
• types: remove references to Shader type (#327) (8449f8e)
• types: Remove usages of ambient THREE namespace (#346) (ba6a58d)
• types: stub TextureEncoding (#347) (11bd428)
• types: three r160 breaking changes (#332) (6033736)
• types: type errors in declaration files (#176) (4c97f5c)
• update chevrotain (#284) (644d2ad)
• update chevrotain from v9.0.2 to v10.1.1 (#134) (d9ff694)
• update CSM shader (#90) (5618b2a)
• update curvemod (fdbc8a4)
• Update devDependencies of three & @types/three to latest (fixes #123) (#124) (e49ebbc)
• update gltfloader (da2d398)
• update line2 to latest (96887bc)
• Update LineSegments2.ts to fix raycaster (#73) (bdaa33c), closes /github.com/mrdoob/three.js/blob/e8877dfb85ae017f53ef8d91237909bc162f524b/examples/jsm/lines/LineSegments2.js#L165
• update pointer lock (baa84a4)
• update rgbe (ab512ad)
• update shaders (b70a1ca)
• update transform controls axes visual feedback to match threejs (#64) (0661ff6)
• updated RenderPixelatedPass types to match source file (#265) (1401fce)
• upgrading semantic-release (#391) (1f41939)
• USDZExporter: alpha issues in diffuse map (#364) (880e2eb)
• use arrow function in scene.traverse argument (#161) (252f19d)
• use correct package name (#50) (492231b)
• use correct value for LinearSRGBColorSpace (#368) (430ffd7)
• use vite, vendor types (#236) (940d6f7)
• utils: toCreasedNormals(): call toNonIndexed() only on indexed geometries (#269) (9ecea65)
• vendor opentype as ESM (#295) (238d81d)
• VRButton: SSR compat (#293) (55cabc8)
• water2 was broken (4d561a2)
• water2: fix water2 shader enum wrong. (#189) (4d7533d)
• waterpass export (b55ba83)
• webgl interface was still an object collection, create context for detection only once, free it as well (375e140)
• WebGPURenderer: add explicit ext for glslang (#245) (93a82d8)
• webxr: convert to TS (#163) (ac03664)
• webxr: update xr modules, vendor motion controllers (#130) (55b233d)

chore

• update for r128 (2815d8e)

Features

• RaycasterHelper (#389) (9bf7ea3)
• add arcballcontrols and implement a connect function (8edbc52)
• add connect method to FirstPersonControls (#119) (07956be)
• add CurveModifier (8882d72)
• add FontLoader, Font, & TextGeometry (#111) (bb8ae8c)
• add GammaCorrectionShader (3838cab)
• add GroundProjectedEnv (#172) (cda89a0)
• add HorizontalBlurShader (81f67ab)
• add HTMLMesh (#206) (3d42c87)
• add Line2, LineMaterial & LineGeometry (3dc2f86)
• add SimplexNoise (c451acb)
• add SimplexNoise TS (606e2dc)
• add TrackballControls (dd66580)
• add transform controls (f59f1e2)
• add VerticalBlurShader (2fc77a5)
• add waterpass (7e7693e)
• Automatic enabling of USE_DASH define in lines (#67) (0061945)
• BatchedMesh (#307) (a51d1f3)
• CCDIKHelper: add sphereSize arg (e924202)
• CCDIKSolver: convert to classes, export CCDIKHelper (#181) (273a63b)
• controls: Remove preventDefault() from mouse handlers (#66) (f992685)
• Copy @three/types/examples at build time (#45) (89430e5)
• cursor zoom (#104) (9fb179e)
• EffectComposer: add dispose (#378) (9d656b2)
• Expose direct polar/azimuthal angle controls (#65) (2a72eb9)
• GLTFExporter: add support for 4 uv channels (#303) (086fadb)
• GLTFLoader: dispersion (#363) (bdfe295)
• GLTFLoader: emissive strength, iridescence, morph colors (#190) (3191f75)
• interactive: adding InteractiveObject (#171) (72aa608)
• KTX2Loader: add support for compressed arraytextures (#230) (a806897)
• Lines: alpha support for line color (#335) (06d48dc)
• Migrated vendored MotionControllers and XRControllerModelFactory to ts (#194) (697b6ba)
• Move AfterimagePass to a class with customizable shader (#49) (4450baf)
• OrbitControls: expose zoom methods for programmatical controls (#383) (98aaa0b)
• OrbitControls: reverse horizontal and vertical orbits separately (#280) (53efecd)
• OrbitControls: stopListenToKeyEvents (#275) (7aa3117)
• OrbitControls: zoomToCursor (#286) (6472f69)
• PointerLockControls: sensitivity const (#416) (e6653ce)
• refactor control classes to use readonly for target property (#370) (002e780)
• refactor orbit controls to pointer events (#71) (926bd8a)
• remove need for manually assigning Line2 material resolution (#376) (d89e3c3)
• renderpixelatedpass (5356691)
• reverse orbit (#89) (cb9f44c), closes #57
• TrackballControls: expose target (#249) (400af03)
• transform multiple JS postprocessing functions to TS classes (#150) (6d29730)
• update ktx2loader, add letterspacing and lineheight to fontloader (a2a572a)
• updategltfloader (3c4699a)
• webxr: convert buttons to TS, passthrough vr sessioninit (#164) (93a17c9)
• XRHandMeshModel: add custom model path arg (#162) (61d0f77)

Reverts

• Revert "removes unused interface + CameraControl.js" (f366596)

BREAKING CHANGES

• min v three r128

• this is the start of v1 beta

• remove new TextureLoader from top level import

• run prettier