Docs: Add three/renderer jsdoc (#1516)

* Add initial docs

* Remove use of "classdesc"

* Update buffer

* Add docs for three/renderer

* Lint fixes

* Update config

* Fix config

* lint fixes

Author: gkjohnson

eslint.config.js

@@ -118,12 +118,14 @@ export default [
 					String: 'string',
 				},
 				tagNamePreference: {
-					returns: 'return',
-					extends: 'augments',
+					return: 'returns',
+					augments: 'extends',
+					classdesc: false,
 				},
 			},
 		},
 		rules: {
+			'jsdoc/check-tag-names': [ 'error', { definedTags: [ 'component', 'warn', 'note' ] } ],
 			'jsdoc/check-types': 'error',
 			'jsdoc/require-param-type': 'error',
 			'jsdoc/require-returns-type': 'error',

src/babylonjs/renderer/loaders/B3DMLoader.js

@@ -3,10 +3,9 @@ import { B3DMLoaderBase } from '3d-tiles-renderer/core';
 import { GLTFLoader } from './GLTFLoader.js';
 
 /**
- * @classdesc
  * Babylon.js loader for B3DM (Batched 3D Model) tile content. Parses the B3DM binary
  * structure and delegates embedded GLB loading to GLTFLoader.
- * @augments B3DMLoaderBase
+ * @extends B3DMLoaderBase
  */
 export class B3DMLoader extends B3DMLoaderBase {
 

src/babylonjs/renderer/loaders/GLTFLoader.js

@@ -6,10 +6,9 @@ import '@babylonjs/loaders/glTF/2.0';
 const _worldMatrix = /* @__PURE__ */ Matrix.Identity();
 
 /**
- * @classdesc
  * Babylon.js loader for GLTF and GLB tile content. Loads a buffer into a Babylon.js scene
  * and applies an optional adjustment transform for coordinate-system correction.
- * @augments LoaderBase
+ * @extends LoaderBase
  */
 export class GLTFLoader extends LoaderBase {
 

src/babylonjs/renderer/tiles/TilesRenderer.js

@@ -15,11 +15,10 @@ const _frustumPlanes = /* @__PURE__ */ new Array( 6 ).fill( null ).map( () => ne
 
 // TODO: implementation does not support left handed coordinate system
 /**
- * @classdesc
  * Babylon.js implementation of the 3D Tiles renderer. Manages tile loading, caching, traversal,
  * and scene management using the Babylon.js scene graph and camera APIs. Dispatches all events
  * defined by TilesRendererBase via Babylon.js Observables.
- * @augments TilesRendererBase
+ * @extends TilesRendererBase
  */
 export class TilesRenderer extends TilesRendererBase {
 

src/core/plugins/CesiumIonAuthPlugin.js

@@ -9,7 +9,6 @@ import { GoogleCloudAuthPlugin } from './GoogleCloudAuthPlugin.js';
  */
 
 /**
- * @classdesc
  * Plugin for authenticating requests to Cesium Ion. Handles token refresh, asset endpoint
  * resolution, and attribution collection. Automatically registers a GoogleCloudAuthPlugin
  * when the resolved asset is an external Google photorealistic tileset.

src/core/plugins/EnforceNonZeroErrorPlugin.js

@@ -1,5 +1,4 @@
 /**
- * @classdesc
  * Plugin that ensures every tile has a non-zero geometric error. Tiles with a geometric
  * error of zero are assigned a derived value based on the nearest ancestor with a non-zero
  * error, halved once per level of depth below that ancestor.

src/core/plugins/GoogleCloudAuthPlugin.js

@@ -4,7 +4,6 @@ import { GoogleAttributionsManager } from './GoogleAttributionsManager.js';
 const TILES_3D_API = 'https://tile.googleapis.com/v1/3dtiles/root.json';
 
 /**
- * @classdesc
  * Plugin for authenticating requests to the Google Cloud Maps APIs, including the
  * Photorealistic 3D Tiles and 2D Map Tiles APIs. Handles session-token management,
  * per-tile attribution collection, and optional logo attribution.

src/core/plugins/ImplicitTilingPlugin.js

@@ -1,7 +1,6 @@
 import { SUBTREELoader } from './SUBTREELoader.js';
 
 /**
- * @classdesc
  * Plugin that adds support for 3D Tiles 1.1 implicit tiling. Intercepts tiles that carry
  * an `implicitTiling` field and expands them by loading and parsing `.subtree` files,
  * generating child tiles according to the implicit subdivision scheme.

src/core/plugins/SUBTREELoader.js

@@ -94,7 +94,7 @@ export class SUBTREELoader extends LoaderBase {
 	/**
 	 *
 	 * @param {ArrayBuffer} buffer
-	 * @return {Subtree}
+	 * @returns {Subtree}
 	 */
 	parseBuffer( buffer ) {
 
@@ -713,7 +713,7 @@ export class SUBTREELoader extends LoaderBase {
 	 * the actual bounding volumes should not be computed progressively by subdividing a non-root tile volume.
 	 * Instead, the exact bounding volumes are computed directly for a given level.
 	 * @param {Object | SubtreeTile} tile
-	 * @return {Object} object containing the bounding volume.
+	 * @returns {Object} object containing the bounding volume.
 	 */
 	getTileBoundingVolume( tile ) {
 
@@ -800,7 +800,7 @@ export class SUBTREELoader extends LoaderBase {
 	/**
 	 * Each child’s geometricError is half of its parent’s geometricError.
 	 * @param {Object | SubtreeTile} tile
-	 * @return {number}
+	 * @returns {number}
 	 */
 	getGeometricError( tile ) {
 

src/core/plugins/auth/CesiumIonAuth.js

@@ -1,5 +1,4 @@
 /**
- * @classdesc
  * Authentication helper for Cesium Ion. Fetches and caches a bearer token from the
  * Cesium Ion endpoint and injects it into outgoing requests. Supports optional
  * automatic token refresh on 4xx responses.