Capitalize jsdoc array and object types

[noahtallen]

Proposed Changes

Split from #72308, this PR would enforce capitalized types for Object in jsdoc. E.g.:

/*
 * @param {Array} foo Some list
 * @returns {Object} Some object
/*
function arrToObj( foo ) {
  return {};
}

Note that Array is capitalized by default.

Why? This is what WordPress coding style uses, because it's what the JSdoc standard uses. Thankfully, with a minimal rule change, this is completely autofixable. And if you accidentally write a lower-case variant, it should be auto-fixed in the editor if you lint on save :)

The counterpoint to this is the documentation here: https://github.com/gajus/eslint-plugin-jsdoc/tree/v39.0.0#why-not-capital-case-everything.

Testing Instructions

Verify code and rule changes make sense.

[github-actions]

Calypso Live (direct link)

https://calypso.live?image=registry.a8c.com/calypso/app:build-54840

Jetpack Cloud live (direct link)

https://calypso.live?image=registry.a8c.com/calypso/app:build-54840&env=jetpack

[matticbot]

This PR modifies the release build for editing-toolkit

To test your changes on WordPress.com, run install-plugin.sh editing-toolkit capitalize-jsdoc-arrays-objects on your sandbox.

To deploy your changes after merging, see the documentation: PCYsg-mMA-p2

[WunderBart]

Fastest ~3k lines review ever 🚢 😎

[tyxla]

🚢 Thank you!

I almost missed this as I was reviewing #72308 first.

I appreciate it that we maintain consistency with Gutenberg's codebase.

🚀

[matticbot]

This PR modifies the release build for happy-blocks

To test your changes on WordPress.com, run install-plugin.sh happy-blocks capitalize-jsdoc-arrays-objects on your sandbox.

To deploy your changes after merging, see the documentation: PCYsg-r7r-p2

[matticbot]

This PR modifies the release build for wpcom-block-editor

To test your changes on WordPress.com, run install-plugin.sh wpcom-block-editor capitalize-jsdoc-arrays-objects on your sandbox.

To deploy your changes after merging, see the documentation: PCYsg-l4k-p2

[matticbot]

This PR does not affect the size of JS and CSS bundles shipped to the user's browser.

Generated by performance advisor bot at iscalypsofastyet.com.

[noahtallen]

I had to ignore a couple of existing problems in order to get everything passing. But I added @todo comments and links to relevant info in those cases. (There were only two or three of these.) I added all that to 05403f1, and kept the auto fix separate in 60f70ce

[noahtallen]

I'll look into why translate is timing out next :)

[noahtallen]

I'll look into why translate is timing out next :)

I think it's just because the number of files changing is very large. The script loops through every changed file, and then every changed line. But I'll keep an eye on it after merging