Summary

Docs-only PR fixing a small set of objectively-wrong JSDoc issues in public-facing APIs. No runtime behaviour changes.

Type corrections

• CalculateSortDistanceCallback in src/scene/mesh-instance.js: was documented as @returns {void}, but Layer#_calculateSortDistances uses the result as a numeric sort distance. Corrected to @returns {number}.
• Compute#getParameter in src/platform/graphics/compute.js: return union was missing TextureView, which is an allowed value per setParameter. Added to the union.

Typos / grammar in public JSDoc prose

• src/scene/graph-node.js:
  • findByName param described "the name of the graph" -> "the name of the node".
  • find / findOne said "the valued passed" -> "the value passed".
  • findOne @returns "A graph node that match" -> "that matches".
  • findByTag description "each tag of array" -> "each tag of the array"; examples "nodes that tagged by" -> "nodes tagged with" (and fixed "assets" -> "graph nodes" for accuracy).
• src/framework/script/script-type.js: class summary rewritten from "You should not use this inherit from this class directly." to "Do not inherit from this class directly.", and fixed missing article.
• Removed duplicated "when when" in event descriptions in src/extras/gizmo/transform-gizmo.js (2 sites), src/extras/gizmo/gizmo.js, and src/framework/i18n/i18n.js.

Broken @example

• TransformGizmo.EVENT_TRANSFORMMOVE example used ${...} inside single quotes, so it logged literal ${pointDelta}. Converted to a backtick template literal.

Public API changes

Only JSDoc types change; no runtime signatures change. Two documented types are widened:

Before:

/**
 * @callback CalculateSortDistanceCallback
 * @returns {void}
 */

After:

/**
 * @callback CalculateSortDistanceCallback
 * @returns {number}
 */

Before:

/**
 * @returns {number|number[]|Float32Array|Texture|StorageBuffer|VertexBuffer|IndexBuffer|undefined}
 */
getParameter(name) { ... }

After:

/**
 * @returns {number|number[]|Float32Array|Texture|StorageBuffer|VertexBuffer|IndexBuffer|TextureView|undefined}
 */
getParameter(name) { ... }

Test plan

• npx eslint on all touched files passes.
• No behavioural code changes; nothing else to test.