Improve TypeDoc categories (#5977)

src/platform/graphics/graphics-device-create.js

@@ -37,6 +37,7 @@ import { NullGraphicsDevice } from './null/null-graphics-device.js';
  *
  * Defaults to 'default'.
  * @returns {Promise} - Promise object representing the created graphics device.
+ * @category Graphics
  */
 function createGraphicsDevice(canvas, options = {}) {
 

src/platform/input/touch-event.js

@@ -5,6 +5,7 @@
  * @param {globalThis.Touch} touch - The browser Touch object.
  * @returns {object} The coordinates of the touch relative to the touch.target DOM element. In the
  * format \{x, y\}.
+ * @category Input
  */
 function getTouchTargetCoords(touch) {
     let totalOffsetX = 0;

src/scene/graphics/quad-render-utils.js

@@ -19,6 +19,7 @@ const _tempRect = new Vec4();
  * pixels. Defaults to fullscreen (`0, 0, target.width, target.height`).
  * @param {import('../../core/math/vec4.js').Vec4} [scissorRect] - The scissor rectangle of the
  * quad, in pixels. Defaults to fullscreen (`0, 0, target.width, target.height`).
+ * @category Graphics
  */
 function drawQuadWithShader(device, target, shader, rect, scissorRect) {
 
@@ -78,6 +79,7 @@ function drawQuadWithShader(device, target, shader, rect, scissorRect) {
  * texture, in pixels. Defaults to fullscreen (`0, 0, target.width, target.height`).
  * @param {import('../../core/math/vec4.js').Vec4} [scissorRect] - The scissor rectangle to use for
  * the texture, in pixels. Defaults to fullscreen (`0, 0, target.width, target.height`).
+ * @category Graphics
  */
 function drawTexture(device, texture, target, shader, rect, scissorRect) {
     Debug.assert(!device.isWebGPU, 'pc.drawTexture is not currently supported on WebGPU platform.');

src/scene/graphics/reproject-texture.js

@@ -397,6 +397,7 @@ void main(void) {
  * @param {import('../../core/math/vec4.js').Vec4} [options.rect] - Optional viewport rectangle.
  * @param {number} [options.seamPixels] - Optional number of seam pixels to render
  * @returns {boolean} True if the reprojection was applied and false otherwise (e.g. if rect is empty)
+ * @category Graphics
  */
 function reprojectTexture(source, target, options = {}) {
     // maintain backwards compatibility with previous function signature

src/scene/procedural.js

@@ -29,6 +29,7 @@ const shapePrimitives = [];
  *     uvs: uvs,
  *     indices: indices
  * });
+ * @category Graphics
  */
 function calculateNormals(positions, indices) {
     const triangleCount = indices.length / 3;
@@ -103,6 +104,7 @@ function calculateNormals(positions, indices) {
  *     uvs: uvs,
  *     indices: indices
  * });
+ * @category Graphics
  */
 function calculateTangents(positions, normals, uvs, indices) {
     // Lengyel's Method
@@ -238,6 +240,7 @@ function calculateTangents(positions, normals, uvs, indices) {
  *     uvs: [0, 0, 1, 0, 0, 1],
  *     indices: [0, 1, 2]
  * });
+ * @category Graphics
  */
 function createMesh(device, positions, opts) {
 
@@ -307,6 +310,7 @@ function createMesh(device, positions, opts) {
  * (defaults to 30).
  * @param {boolean} [opts.calculateTangents] - Generate tangent information (defaults to false).
  * @returns {Mesh} A new torus-shaped mesh.
+ * @category Graphics
  */
 function createTorus(device, opts = {}) {
     // Check the supplied options and provide defaults for unspecified ones
@@ -605,6 +609,7 @@ function _createConeData(baseRadius, peakRadius, height, heightSegments, capSegm
  * cylinder (defaults to 20).
  * @param {boolean} [opts.calculateTangents] - Generate tangent information (defaults to false).
  * @returns {Mesh} A new cylinder-shaped mesh.
+ * @category Graphics
  */
 function createCylinder(device, opts = {}) {
     // Check the supplied options and provide defaults for unspecified ones
@@ -647,6 +652,7 @@ function createCylinder(device, opts = {}) {
  * (defaults to 20).
  * @param {boolean} [opts.calculateTangents] - Generate tangent information (defaults to false).
  * @returns {Mesh} A new cylinder-shaped mesh.
+ * @category Graphics
  */
 function createCapsule(device, opts = {}) {
     // Check the supplied options and provide defaults for unspecified ones
@@ -688,6 +694,7 @@ function createCapsule(device, opts = {}) {
  * (defaults to 18).
  * @param {boolean} [opts.calculateTangents] - Generate tangent information (defaults to false).
  * @returns {Mesh} A new cone-shaped mesh.
+ * @category Graphics
  */
 function createCone(device, opts = {}) {
     // Check the supplied options and provide defaults for unspecified ones
@@ -727,6 +734,7 @@ function createCone(device, opts = {}) {
  * the sphere (defaults to 16).
  * @param {boolean} [opts.calculateTangents] - Generate tangent information (defaults to false).
  * @returns {Mesh} A new sphere-shaped mesh.
+ * @category Graphics
  */
 function createSphere(device, opts = {}) {
     // Check the supplied options and provide defaults for unspecified ones
@@ -810,6 +818,7 @@ function createSphere(device, opts = {}) {
  * (defaults to 5).
  * @param {boolean} [opts.calculateTangents] - Generate tangent information (defaults to false).
  * @returns {Mesh} A new plane-shaped mesh.
+ * @category Graphics
  */
 function createPlane(device, opts = {}) {
     // Check the supplied options and provide defaults for unspecified ones
@@ -895,6 +904,7 @@ function createPlane(device, opts = {}) {
  * @param {number} [opts.yOffset] - Move the box vertically by given offset in local space. Pass
  * 0.5 to generate the box with pivot point at the bottom face. Defaults to 0.
  * @returns {Mesh} A new box-shaped mesh.
+ * @category Graphics
  */
 function createBox(device, opts = {}) {
     // Check the supplied options and provide defaults for unspecified ones

src/scene/shader-lib/chunks/chunks.js

@@ -206,6 +206,7 @@ import webgpuVS from '../../../platform/graphics/shader-chunks/vert/webgpu.js';
  * Object containing all default shader chunks used by shader generators.
  *
  * @type {object}
+ * @category Graphics
  */
 const shaderChunks = {
     alphaTestPS,

src/scene/shader-lib/utils.js

@@ -70,6 +70,7 @@ function createShader(device, vsName, fsName, useTransformFeedback = false, shad
  * attachments. Passing an array will set the output type for each color attachment.
  * @see ShaderUtils.createDefinition
  * @returns {Shader} The newly created shader.
+ * @category Graphics
  */
 function createShaderFromCode(device, vsCode, fsCode, uniqueName, attributes, useTransformFeedback = false, shaderDefinitionOptions = {}) {