New Docs: Generate old docs system and design (#32036)

* New Docs: Generate old doc system.

* New Docs: Added THREE instance and ASCII Art.

* New Docs: Templates clean up.

* New Docs: Clean up.

* New Docs: Avoid generating redundant tags.

* New Docs: Fixed search results and link colors.

* New Docs: Implemented full inheritance breadcrumbs.

* New Docs: Reimplemented old css.

* New Docs: Fixed hash links.

* New Docs: Implemented @marcofugaro search results design.

* New Docs: Clean up.

* New Docs: Clean up.

* New Docs: Do not include private properties/methods in results.

* New Docs: Separated Global from TSL.

* New Docs: Clean up.

* New Docs: Clean up.

* New Docs: Clean up.

* New Docs: Removed fuse.js.

* New Docs: Replaced examples link with manual.

* New Docs: Removed (nullable) from properties/methods.

* New Docs: Bring back geometry/materials/... viewers.

* New Docs: Separate code snippet from description.

* New Docs: Removed unused div container.

* New Docs: Moved Import section before Constructor section.

* New Docs: Ensure TSL is always uppercase.

* New Docs: Clean up.

* New Docs: Added missing @tsl tags.

* New Docs: Added missing @tsl and @Private tags.

* New Docs: Simplified TSL handling.

* Added webgpu_materials_basic to puppeteer exceition list.

Author: mrdoob

examples/jsm/tsl/display/DenoiseNode.js

@@ -259,6 +259,7 @@ export default DenoiseNode;
 /**
  * Generates denoise samples based on the given parameters.
  *
+ * @private
  * @param {number} numSamples - The number of samples.
  * @param {number} numRings - The number of rings.
  * @param {number} radiusExponent - The radius exponent.
@@ -283,6 +284,7 @@ function generateDenoiseSamples( numSamples, numRings, radiusExponent ) {
 /**
  * Generates a default noise texture for the given size.
  *
+ * @private
  * @param {number} [size=64] - The texture size.
  * @return {DataTexture} The generated noise texture.
  */

examples/jsm/tsl/display/boxBlur.js

@@ -14,6 +14,7 @@ import { Fn, vec2, uv, Loop, vec4, premultiplyAlpha, unpremultiplyAlpha, max, in
  *
  * Reference: {@link https://github.com/lettier/3d-game-shaders-for-beginners/blob/master/demonstration/shaders/fragment/box-blur.frag}.
  *
+ * @tsl
  * @function
  * @param {Node<vec4>} textureNode - The texture node that should be blurred.
  * @param {Object} [options={}] - Additional options for the hash blur effect.

examples/jsm/tsl/display/hashBlur.js

@@ -12,6 +12,7 @@ import { float, Fn, vec2, uv, sin, rand, degrees, cos, Loop, vec4, premultiplyAl
  *
  * Reference: {@link https://www.shadertoy.com/view/4lXXWn}.
  *
+ * @tsl
  * @function
  * @param {Node<vec4>} textureNode - The texture node that should be blurred.
  * @param {Node<float>} [bluramount=float(0.1)] - This node determines the amount of blur.

examples/jsm/tsl/lighting/TiledLightsNode.js

@@ -5,6 +5,17 @@ import {
 	Fn, If, Return, textureLoad, instanceIndex, screenCoordinate, directPointLight
 } from 'three/tsl';
 
+/**
+ * TSL function that checks if a circle intersects with an axis-aligned bounding box (AABB).
+ *
+ * @tsl
+ * @function
+ * @param {Node<vec2>} circleCenter - The center of the circle.
+ * @param {Node<float>} radius - The radius of the circle.
+ * @param {Node<vec2>} minBounds - The minimum bounds of the AABB.
+ * @param {Node<vec2>} maxBounds - The maximum bounds of the AABB.
+ * @return {Node<bool>} True if the circle intersects the AABB.
+ */
 export const circleIntersectsAABB = /*@__PURE__*/ Fn( ( [ circleCenter, radius, minBounds, maxBounds ] ) => {
 
 	// Find the closest point on the AABB to the circle's center using method chaining
@@ -419,4 +430,13 @@ class TiledLightsNode extends LightsNode {
 
 export default TiledLightsNode;
 
+/**
+ * TSL function that creates a tiled lights node.
+ *
+ * @tsl
+ * @function
+ * @param {number} [maxLights=1024] - The maximum number of lights.
+ * @param {number} [tileSize=32] - The tile size.
+ * @return {TiledLightsNode} The tiled lights node.
+ */
 export const tiledLights = /*@__PURE__*/ nodeProxy( TiledLightsNode );

files/main.css

@@ -304,6 +304,50 @@ hr {
 		padding: 0 var(--panel-padding) var(--panel-padding) var(--panel-padding);
 	}
 
+	#panel #searchResults {
+		flex: 1;
+		overflow-y: auto;
+		overflow-x: hidden;
+		-webkit-overflow-scrolling: touch;
+		padding: 0 var(--panel-padding) var(--panel-padding) var(--panel-padding);
+	}
+
+		#panel #searchResults .search-result-group {
+			margin-bottom: 12px;
+		}
+
+		#panel #searchResults .search-result-class {
+			display: block;
+			color: var(--text-color);
+			font-weight: 500;
+			margin-bottom: 2px;
+		}
+
+		#panel #searchResults .search-result-class:hover {
+			color: var(--color-blue);
+		}
+
+		#panel #searchResults .search-result-member {
+			display: block;
+			color: var(--text-color);
+			margin-left: 16px;
+			margin-bottom: 1px;
+		}
+
+		#panel #searchResults .search-result-member:hover {
+			color: var(--color-blue);
+		}
+
+		#panel #searchResults .search-result-class.selected,
+		#panel #searchResults .search-result-member.selected {
+			color: var(--color-blue);
+			text-decoration: underline;
+		}
+
+		#panel #searchResults strong {
+			font-weight: 600;
+		}
+
 		#panel #content ul {
 			list-style-type: none;
 			padding: 0px;

src/geometries/BoxGeometry.js

@@ -15,6 +15,7 @@ import { Vector3 } from '../math/Vector3.js';
  * ```
  *
  * @augments BufferGeometry
+ * @demo scenes/geometry-browser.html#BoxGeometry
  */
 class BoxGeometry extends BufferGeometry {
 

src/geometries/CapsuleGeometry.js

@@ -13,6 +13,7 @@ import { Vector3 } from '../math/Vector3.js';
  * ```
  *
  * @augments BufferGeometry
+ * @demo scenes/geometry-browser.html#CapsuleGeometry
  */
 class CapsuleGeometry extends BufferGeometry {
 

src/geometries/CircleGeometry.js

@@ -19,6 +19,7 @@ import { Vector2 } from '../math/Vector2.js';
  * ```
  *
  * @augments BufferGeometry
+ * @demo scenes/geometry-browser.html#CircleGeometry
  */
 class CircleGeometry extends BufferGeometry {
 

src/geometries/ConeGeometry.js

@@ -11,6 +11,7 @@ import { CylinderGeometry } from './CylinderGeometry.js';
  * ```
  *
  * @augments CylinderGeometry
+ * @demo scenes/geometry-browser.html#ConeGeometry
  */
 class ConeGeometry extends CylinderGeometry {
 

src/geometries/CylinderGeometry.js

@@ -14,6 +14,7 @@ import { Vector2 } from '../math/Vector2.js';
  * ```
  *
  * @augments BufferGeometry
+ * @demo scenes/geometry-browser.html#CylinderGeometry
  */
 class CylinderGeometry extends BufferGeometry {