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
This commit is contained in:
Maribeth Bottorff
2022-08-23 14:27:22 -07:00
committed by GitHub
parent bb37d1b7aa
commit 037eb59b89
261 changed files with 3876 additions and 2341 deletions

View File

@@ -4,14 +4,10 @@
* SPDX-License-Identifier: Apache-2.0
*/
/**
* @fileoverview Module that provides constants for use inside Blockly. Do not
* use these constants outside of the core library.
*/
/**
* Module that provides constants for use inside Blockly. Do not
* use these constants outside of the core library.
*
* @namespace Blockly.internalConstants
*/
import * as goog from '../closure/goog/goog.js';
@@ -22,6 +18,7 @@ import {ConnectionType} from './connection_type.js';
/**
* Number of characters to truncate a collapsed block to.
*
* @alias Blockly.internalConstants.COLLAPSE_CHARS
* @internal
*/
@@ -30,6 +27,7 @@ export const COLLAPSE_CHARS = 30;
/**
* When dragging a block out of a stack, split the stack in two (true), or drag
* out the block healing the stack (false).
*
* @alias Blockly.internalConstants.DRAG_STACK
* @internal
*/
@@ -37,6 +35,7 @@ export const DRAG_STACK = true;
/**
* Lookup table for determining the opposite type of a connection.
*
* @alias Blockly.internalConstants.OPPOSITE_TYPE
* @internal
*/
@@ -52,6 +51,7 @@ OPPOSITE_TYPE[ConnectionType.PREVIOUS_STATEMENT] =
* String for use in the dropdown created in field_variable.
* This string indicates that this option in the dropdown is 'Rename
* variable...' and if selected, should trigger the prompt to rename a variable.
*
* @alias Blockly.internalConstants.RENAME_VARIABLE_ID
* @internal
*/
@@ -61,6 +61,7 @@ export const RENAME_VARIABLE_ID = 'RENAME_VARIABLE_ID';
* String for use in the dropdown created in field_variable.
* This string indicates that this option in the dropdown is 'Delete the "%1"
* variable' and if selected, should trigger the prompt to delete a variable.
*
* @alias Blockly.internalConstants.DELETE_VARIABLE_ID
* @internal
*/