chore: Lint TsDoc. (#6353)

* chore: add linting for tsdoc

* chore: don't require types on return

* chore: remove redundant fileoverview from ts

* chore: change return to returns and add some newlines

* chore: remove license tag

* chore: don't require params/return docs

* chore: remove spurious struct tags

* Revert "chore: change return to returns and add some newlines"

This reverts commit d6d8656a45.

* chore: don't auto-add param names

* chore: disable require-param bc it breaks on this

* return to returns and add line breaks

* chore: configure additional jsdoc rules

* chore: run format

* Revert "chore: remove license tag"

This reverts commit 173455588a.

* chore: allow license tag format

* chore: only require jsdoc on exported items

* chore: add missing jsdoc or silence where needed

* chore: run format

* chore: lint fixes

core/field_image.ts

@@ -4,12 +4,9 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 
-/**
- * @fileoverview Image field.  Used for pictures, icons, etc.
- */
-
 /**
  * Image field.  Used for pictures, icons, etc.
+ *
  * @class
  */
 import * as goog from '../closure/goog/goog.js';
@@ -26,6 +23,7 @@ import {Svg} from './utils/svg.js';
 
 /**
  * Class for an image on a block.
+ *
  * @alias Blockly.FieldImage
  */
 export class FieldImage extends Field {
@@ -127,6 +125,7 @@ export class FieldImage extends Field {
 
   /**
    * Configure the field based on the given map of options.
+   *
    * @param config A map of options to configure the field based on.
    */
   protected override configure_(config: FieldImageConfig) {
@@ -139,6 +138,7 @@ export class FieldImage extends Field {
 
   /**
    * Create the block UI for this image.
+   *
    * @internal
    */
   override initView() {
@@ -162,8 +162,9 @@ export class FieldImage extends Field {
 
   /**
    * Ensure that the input value (the source URL) is a string.
+   *
    * @param opt_newValue The input value.
-   * @return A string, or null if invalid.
+   * @returns A string, or null if invalid.
    */
   protected override doClassValidation_(opt_newValue?: AnyDuringMigration):
       string|null {
@@ -175,6 +176,7 @@ export class FieldImage extends Field {
 
   /**
    * Update the value of this image field, and update the displayed image.
+   *
    * @param newValue The value to be saved. The default validator guarantees
    *     that this is a string.
    */
@@ -188,7 +190,8 @@ export class FieldImage extends Field {
 
   /**
    * Get whether to flip this image in RTL
-   * @return True if we should flip in RTL.
+   *
+   * @returns True if we should flip in RTL.
    */
   override getFlipRtl(): boolean {
     return this.flipRtl_;
@@ -196,6 +199,7 @@ export class FieldImage extends Field {
 
   /**
    * Set the alt text of this image.
+   *
    * @param alt New alt text.
    */
   setAlt(alt: string|null) {
@@ -220,6 +224,7 @@ export class FieldImage extends Field {
 
   /**
    * Set the function that is called when this image  is clicked.
+   *
    * @param func The function that is called when the image is clicked, or null
    *     to remove.
    */
@@ -231,7 +236,8 @@ export class FieldImage extends Field {
    * Use the `getText_` developer hook to override the field's text
    * representation.
    * Return the image alt text instead.
-   * @return The image alt text.
+   *
+   * @returns The image alt text.
    */
   protected override getText_(): string|null {
     return this.altText_;
@@ -240,9 +246,10 @@ export class FieldImage extends Field {
   /**
    * Construct a FieldImage from a JSON arg object,
    * dereferencing any string table references.
+   *
    * @param options A JSON object with options (src, width, height, alt, and
    *     flipRtl).
-   * @return The new field instance.
+   * @returns The new field instance.
    * @nocollapse
    * @internal
    */