docs: fix more incorrect JSDoc in public APIs (#8615)

* docs: fix more incorrect JSDoc in public APIs

Made-with: Cursor

* docs: correct registerKeys description and document @throws

Made-with: Cursor

* docs: register with registry, not to it

Made-with: Cursor

* docs: align @param app wording with summary

Made-with: Cursor

* docs: close quote in URI#setQuery example comment

Made-with: Cursor

Author: willeastcott

src/core/indexed-list.js

@@ -17,7 +17,7 @@ class IndexedList {
     _index = {};
 
     /**
-     * Add a new item into the list with a index key.
+     * Add a new item into the list with an index key.
      *
      * @param {string} key - Key used to look up item in index.
      * @param {object} item - Item to be stored.

src/core/uri.js

@@ -169,7 +169,7 @@ class URI {
     }
 
     /**
-     * Set the query section of the URI from a Object.
+     * Set the query section of the URI from an Object.
      *
      * @param {object} params - Key-Value pairs to encode into the query string.
      * @example
@@ -179,7 +179,7 @@ class URI {
      *     "a": 1,
      *     "b": 2
      * });
-     * console.log(uri.toString()); // logs "http://example.com?a=1&b=2
+     * console.log(uri.toString()); // logs "http://example.com?a=1&b=2"
      */
     setQuery(params) {
         let q = '';

src/extras/render-passes/render-pass-upsample.js

@@ -6,7 +6,7 @@ import wgslUpsamplePS from '../../scene/shader-lib/wgsl/chunks/render-pass/frag/
 import { ShaderChunks } from '../../scene/shader-lib/shader-chunks.js';
 
 /**
- * Render pass implementation of a up-sample filter.
+ * Render pass implementation of an up-sample filter.
  *
  * @category Graphics
  * @ignore

src/framework/script/script-create.js

@@ -83,12 +83,12 @@ ScriptAttributes.reservedNames.forEach((value, value2, set) => {
 createScript.reservedAttributes = reservedAttributes;
 
 /**
- * Register a existing class type as a Script Type to {@link ScriptRegistry}. Useful when defining
- * a ES6 script class that extends {@link ScriptType} (see example).
+ * Register an existing class type as a Script Type with {@link ScriptRegistry}. Useful when defining
+ * an ES6 script class that extends {@link ScriptType} (see example).
  *
  * @param {typeof ScriptType} script - The existing class type (constructor function) to be
  * registered as a Script Type. Class must extend {@link ScriptType} (see example). Please note: A
- * class created using {@link createScript} is auto-registered, and should therefore not be pass
+ * class created using {@link createScript} is auto-registered, and should therefore not be passed
  * into {@link registerScript} (which would result in swapping out all related script instances).
  * @param {string} [name] - Optional unique name of the Script Type. By default it will use the
  * same name as the existing class. If a Script Type with the same name has already been registered
@@ -98,10 +98,10 @@ createScript.reservedAttributes = reservedAttributes;
  * (underscore): system, entity, create, destroy, swap, move, scripts, onEnable, onDisable,
  * onPostStateChange, has, on, off, fire, once, hasEvent.
  * @param {AppBase} [app] - Optional application handler, to choose which {@link ScriptRegistry}
- * to register the script type to. By default it will use `Application.getApplication()` to get
- * current {@link AppBase}.
+ * to register the script type with. By default it will use `Application.getApplication()` to get
+ * the current {@link AppBase}.
  * @example
- * // define a ES6 script class
+ * // define an ES6 script class
  * class PlayerController extends pc.ScriptType {
  *
  *     initialize() {

src/platform/graphics/vertex-iterator.js

@@ -172,10 +172,10 @@ class VertexIteratorAccessor {
     }
 
     /**
-     * Get a attribute component at the iterator's current index.
+     * Get an attribute component at the iterator's current index.
      *
      * @param {number} offset - The component offset. Should be either 0, 1, 2, or 3.
-     * @returns {number} The value of a attribute component.
+     * @returns {number} The value of an attribute component.
      */
     get(offset) {
         return this.array[this.index + offset];

src/platform/input/controller.js

@@ -168,10 +168,11 @@ class Controller {
     }
 
     /**
-     * Create or update a action which is enabled when the supplied keys are pressed.
+     * Register a new action which is enabled when the supplied keys are pressed.
      *
      * @param {string} action - The name of the action.
      * @param {number[]} keys - A list of keycodes.
+     * @throws {Error} If the action is already registered, or if `keys` is undefined.
      */
     registerKeys(action, keys) {
         if (!this._keyboard) {

src/scene/light.js

@@ -1103,7 +1103,7 @@ class Light {
     }
 
     /**
-     * Updates a integer key for the light. The key is used to identify all shader related features
+     * Updates an integer key for the light. The key is used to identify all shader related features
      * of the light, and so needs to have all properties that modify the generated shader encoded.
      * Properties without an effect on the shader (color, shadow intensity) should not be encoded.
      */