JSDoc: Add @deprecated

[s-rigaud]

Description

I tried to add @deprecated for various methods. I'm not sure if the old inline comment should be keep or not for readability.

Adding the @deprecated tag has two benefits:

• It adds a warning in the doc
  

• Depending on your IDE, it also makes more clear what is deprecated. If the method comments are properly exported in TS, this will allow to see the warning and the expected replacement before running any code.
  

[github-actions]

📦 Bundle size

Full ESM build, minified and gzipped.

	Before	After	Diff
WebGL	339.51 79.09	339.51 79.09	+0 B +0 B
WebGPU	490.96 136.34	490.96 136.34	+0 B +0 B
WebGPU Nodes	490.43 136.23	490.43 136.23	+0 B +0 B

🌳 Bundle size after tree-shaking

Minimal build including a renderer, camera, empty scene, and dependencies.

	Before	After	Diff
WebGL	465.35 112.14	465.35 112.14	+0 B +0 B
WebGPU	560.26 151.75	560.26 151.75	+0 B +0 B
WebGPU Nodes	516.35 141.53	516.35 141.53	+0 B +0 B

[Mugen87]

I think it makes sense to add these docs. When we deprecate things in the future, methods and properties are already documented so it's simply adding the @deprecated to provide good feedback.