Small JSDoc normalization/fixes (playcanvas#6369)

* Fix/normalize examples/utils/plugins/rollup-copy-static.mjs, targets#once is optional

* Mark `y`/`z` as optional when `x` can be the entire `Vec3`

examples/utils/plugins/rollup-copy-static.mjs

@@ -13,7 +13,10 @@ const copied = new Set();
  * This plugin copies static files from source to destination.
  *
  * @param {string} nodeEnv - The node environment.
- * @param {{ src: string, dest: string, once: boolean }[]} targets - Array of source and destination objects.
+ * @param {object[]} targets - Array of source and destination objects.
+ * @param {string} targets.src - File or entire dir.
+ * @param {string} targets.dest - File or entire dir, usually into `dist/`.
+ * @param {boolean} [targets.once] - Copy files only once for speed-up (external libs).
  * @param {boolean} log - Log the copy status.
  * @returns {import('rollup').Plugin} The plugin.
  */

src/framework/components/element/component.js

@@ -1735,8 +1735,8 @@ class ElementComponent extends Component {
      * Patched method for setting the position.
      *
      * @param {number|Vec3} x - The x coordinate or Vec3
-     * @param {number} y - The y coordinate
-     * @param {number} z - The z coordinate
+     * @param {number} [y] - The y coordinate
+     * @param {number} [z] - The z coordinate
      * @private
      */
     _setPosition(x, y, z) {
@@ -1764,8 +1764,8 @@ class ElementComponent extends Component {
      * Patched method for setting the local position.
      *
      * @param {number|Vec3} x - The x coordinate or Vec3
-     * @param {number} y - The y coordinate
-     * @param {number} z - The z coordinate
+     * @param {number} [y] - The y coordinate
+     * @param {number} [z] - The z coordinate
      * @private
      */
     _setLocalPosition(x, y, z) {