eslint-plugin-jsdoc 53.0.1 → 54.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/WarnSettings.cjs +35 -18
- package/dist/WarnSettings.cjs.map +1 -1
- package/dist/alignTransform.cjs +305 -224
- package/dist/alignTransform.cjs.map +1 -1
- package/dist/defaultTagOrder.cjs +43 -132
- package/dist/defaultTagOrder.cjs.map +1 -1
- package/dist/exportParser.cjs +696 -478
- package/dist/exportParser.cjs.map +1 -1
- package/dist/generateRule.cjs +242 -0
- package/dist/generateRule.cjs.map +1 -0
- package/dist/getDefaultTagStructureForMode.cjs +288 -184
- package/dist/getDefaultTagStructureForMode.cjs.map +1 -1
- package/dist/getJsdocProcessorPlugin.cjs +550 -364
- package/dist/getJsdocProcessorPlugin.cjs.map +1 -1
- package/dist/getJsdocProcessorPlugin.d.ts +65 -68
- package/dist/getJsdocProcessorPlugin.d.ts.map +1 -1
- package/dist/index.cjs +410 -2
- package/dist/index.cjs.map +1 -0
- package/dist/index.d.ts +17 -2
- package/dist/index.d.ts.map +1 -0
- package/dist/iterateJsdoc.cjs +2005 -1539
- package/dist/iterateJsdoc.cjs.map +1 -1
- package/dist/iterateJsdoc.d.ts +350 -359
- package/dist/iterateJsdoc.d.ts.map +1 -1
- package/dist/jsdocUtils.cjs +1376 -1009
- package/dist/jsdocUtils.cjs.map +1 -1
- package/dist/rules/checkAccess.cjs +36 -29
- package/dist/rules/checkAccess.cjs.map +1 -1
- package/dist/rules/checkAlignment.cjs +54 -41
- package/dist/rules/checkAlignment.cjs.map +1 -1
- package/dist/rules/checkExamples.cjs +484 -327
- package/dist/rules/checkExamples.cjs.map +1 -1
- package/dist/rules/checkIndentation.cjs +65 -50
- package/dist/rules/checkIndentation.cjs.map +1 -1
- package/dist/rules/checkLineAlignment.cjs +311 -220
- package/dist/rules/checkLineAlignment.cjs.map +1 -1
- package/dist/rules/checkParamNames.cjs +335 -227
- package/dist/rules/checkParamNames.cjs.map +1 -1
- package/dist/rules/checkPropertyNames.cjs +106 -78
- package/dist/rules/checkPropertyNames.cjs.map +1 -1
- package/dist/rules/checkSyntax.cjs +34 -21
- package/dist/rules/checkSyntax.cjs.map +1 -1
- package/dist/rules/checkTagNames.cjs +210 -188
- package/dist/rules/checkTagNames.cjs.map +1 -1
- package/dist/rules/checkTemplateNames.cjs +178 -121
- package/dist/rules/checkTemplateNames.cjs.map +1 -1
- package/dist/rules/checkTypes.cjs +385 -291
- package/dist/rules/checkTypes.cjs.map +1 -1
- package/dist/rules/checkValues.cjs +146 -100
- package/dist/rules/checkValues.cjs.map +1 -1
- package/dist/rules/convertToJsdocComments.cjs +306 -228
- package/dist/rules/convertToJsdocComments.cjs.map +1 -1
- package/dist/rules/emptyTags.cjs +72 -62
- package/dist/rules/emptyTags.cjs.map +1 -1
- package/dist/rules/implementsOnClasses.cjs +56 -36
- package/dist/rules/implementsOnClasses.cjs.map +1 -1
- package/dist/rules/importsAsDependencies.cjs +99 -62
- package/dist/rules/importsAsDependencies.cjs.map +1 -1
- package/dist/rules/informativeDocs.cjs +142 -105
- package/dist/rules/informativeDocs.cjs.map +1 -1
- package/dist/rules/linesBeforeBlock.cjs +105 -70
- package/dist/rules/linesBeforeBlock.cjs.map +1 -1
- package/dist/rules/matchDescription.cjs +222 -160
- package/dist/rules/matchDescription.cjs.map +1 -1
- package/dist/rules/matchName.cjs +128 -73
- package/dist/rules/matchName.cjs.map +1 -1
- package/dist/rules/multilineBlocks.cjs +352 -235
- package/dist/rules/multilineBlocks.cjs.map +1 -1
- package/dist/rules/noBadBlocks.cjs +86 -63
- package/dist/rules/noBadBlocks.cjs.map +1 -1
- package/dist/rules/noBlankBlockDescriptions.cjs +57 -35
- package/dist/rules/noBlankBlockDescriptions.cjs.map +1 -1
- package/dist/rules/noBlankBlocks.cjs +48 -26
- package/dist/rules/noBlankBlocks.cjs.map +1 -1
- package/dist/rules/noDefaults.cjs +79 -52
- package/dist/rules/noDefaults.cjs.map +1 -1
- package/dist/rules/noMissingSyntax.cjs +165 -115
- package/dist/rules/noMissingSyntax.cjs.map +1 -1
- package/dist/rules/noMultiAsterisks.cjs +89 -48
- package/dist/rules/noMultiAsterisks.cjs.map +1 -1
- package/dist/rules/noRestrictedSyntax.cjs +79 -45
- package/dist/rules/noRestrictedSyntax.cjs.map +1 -1
- package/dist/rules/noTypes.cjs +80 -59
- package/dist/rules/noTypes.cjs.map +1 -1
- package/dist/rules/noUndefinedTypes.cjs +388 -297
- package/dist/rules/noUndefinedTypes.cjs.map +1 -1
- package/dist/rules/requireAsteriskPrefix.cjs +159 -108
- package/dist/rules/requireAsteriskPrefix.cjs.map +1 -1
- package/dist/rules/requireDescription.cjs +129 -89
- package/dist/rules/requireDescription.cjs.map +1 -1
- package/dist/rules/requireDescriptionCompleteSentence.cjs +262 -201
- package/dist/rules/requireDescriptionCompleteSentence.cjs.map +1 -1
- package/dist/rules/requireExample.cjs +104 -73
- package/dist/rules/requireExample.cjs.map +1 -1
- package/dist/rules/requireFileOverview.cjs +129 -75
- package/dist/rules/requireFileOverview.cjs.map +1 -1
- package/dist/rules/requireHyphenBeforeParamDescription.cjs +133 -85
- package/dist/rules/requireHyphenBeforeParamDescription.cjs.map +1 -1
- package/dist/rules/requireJsdoc.cjs +557 -384
- package/dist/rules/requireJsdoc.cjs.map +1 -1
- package/dist/rules/requireParam.cjs +526 -336
- package/dist/rules/requireParam.cjs.map +1 -1
- package/dist/rules/requireParamDescription.cjs +80 -55
- package/dist/rules/requireParamDescription.cjs.map +1 -1
- package/dist/rules/requireParamName.cjs +50 -32
- package/dist/rules/requireParamName.cjs.map +1 -1
- package/dist/rules/requireParamType.cjs +80 -55
- package/dist/rules/requireParamType.cjs.map +1 -1
- package/dist/rules/requireProperty.cjs +42 -31
- package/dist/rules/requireProperty.cjs.map +1 -1
- package/dist/rules/requirePropertyDescription.cjs +25 -17
- package/dist/rules/requirePropertyDescription.cjs.map +1 -1
- package/dist/rules/requirePropertyName.cjs +25 -17
- package/dist/rules/requirePropertyName.cjs.map +1 -1
- package/dist/rules/requirePropertyType.cjs +25 -17
- package/dist/rules/requirePropertyType.cjs.map +1 -1
- package/dist/rules/requireReturns.cjs +203 -125
- package/dist/rules/requireReturns.cjs.map +1 -1
- package/dist/rules/requireReturnsCheck.cjs +103 -60
- package/dist/rules/requireReturnsCheck.cjs.map +1 -1
- package/dist/rules/requireReturnsDescription.cjs +54 -39
- package/dist/rules/requireReturnsDescription.cjs.map +1 -1
- package/dist/rules/requireReturnsType.cjs +50 -32
- package/dist/rules/requireReturnsType.cjs.map +1 -1
- package/dist/rules/requireTemplate.cjs +178 -119
- package/dist/rules/requireTemplate.cjs.map +1 -1
- package/dist/rules/requireThrows.cjs +95 -61
- package/dist/rules/requireThrows.cjs.map +1 -1
- package/dist/rules/requireYields.cjs +166 -106
- package/dist/rules/requireYields.cjs.map +1 -1
- package/dist/rules/requireYieldsCheck.cjs +152 -96
- package/dist/rules/requireYieldsCheck.cjs.map +1 -1
- package/dist/rules/sortTags.cjs +444 -258
- package/dist/rules/sortTags.cjs.map +1 -1
- package/dist/rules/tagLines.cjs +266 -179
- package/dist/rules/tagLines.cjs.map +1 -1
- package/dist/rules/textEscaping.cjs +127 -92
- package/dist/rules/textEscaping.cjs.map +1 -1
- package/dist/rules/validTypes.cjs +265 -252
- package/dist/rules/validTypes.cjs.map +1 -1
- package/dist/tagNames.cjs +170 -134
- package/dist/tagNames.cjs.map +1 -1
- package/dist/utils/hasReturnValue.cjs +474 -246
- package/dist/utils/hasReturnValue.cjs.map +1 -1
- package/package.json +24 -40
- package/src/WarnSettings.js +34 -0
- package/src/alignTransform.js +358 -0
- package/src/defaultTagOrder.js +169 -0
- package/src/exportParser.js +978 -0
- package/src/getDefaultTagStructureForMode.js +969 -0
- package/src/getJsdocProcessorPlugin.js +672 -0
- package/src/index.js +530 -0
- package/src/iterateJsdoc.js +2541 -0
- package/src/jsdocUtils.js +1896 -0
- package/src/rules/checkAccess.js +45 -0
- package/src/rules/checkAlignment.js +63 -0
- package/src/rules/checkExamples.js +589 -0
- package/src/rules/checkIndentation.js +75 -0
- package/src/rules/checkLineAlignment.js +372 -0
- package/src/rules/checkParamNames.js +474 -0
- package/src/rules/checkPropertyNames.js +152 -0
- package/src/rules/checkSyntax.js +30 -0
- package/src/rules/checkTagNames.js +314 -0
- package/src/rules/checkTemplateNames.js +204 -0
- package/src/rules/checkTypes.js +535 -0
- package/src/rules/checkValues.js +248 -0
- package/src/rules/convertToJsdocComments.js +398 -0
- package/src/rules/emptyTags.js +98 -0
- package/src/rules/implementsOnClasses.js +64 -0
- package/src/rules/importsAsDependencies.js +133 -0
- package/src/rules/informativeDocs.js +189 -0
- package/src/rules/linesBeforeBlock.js +134 -0
- package/src/rules/matchDescription.js +286 -0
- package/src/rules/matchName.js +151 -0
- package/src/rules/multilineBlocks.js +493 -0
- package/src/rules/noBadBlocks.js +119 -0
- package/src/rules/noBlankBlockDescriptions.js +69 -0
- package/src/rules/noBlankBlocks.js +53 -0
- package/src/rules/noDefaults.js +85 -0
- package/src/rules/noMissingSyntax.js +195 -0
- package/src/rules/noMultiAsterisks.js +134 -0
- package/src/rules/noRestrictedSyntax.js +91 -0
- package/src/rules/noTypes.js +93 -0
- package/src/rules/noUndefinedTypes.js +543 -0
- package/src/rules/requireAsteriskPrefix.js +190 -0
- package/src/rules/requireDescription.js +161 -0
- package/src/rules/requireDescriptionCompleteSentence.js +335 -0
- package/src/rules/requireExample.js +118 -0
- package/src/rules/requireFileOverview.js +154 -0
- package/src/rules/requireHyphenBeforeParamDescription.js +176 -0
- package/src/rules/requireJsdoc.js +743 -0
- package/src/rules/requireParam.js +602 -0
- package/src/rules/requireParamDescription.js +89 -0
- package/src/rules/requireParamName.js +55 -0
- package/src/rules/requireParamType.js +89 -0
- package/src/rules/requireProperty.js +48 -0
- package/src/rules/requirePropertyDescription.js +25 -0
- package/src/rules/requirePropertyName.js +25 -0
- package/src/rules/requirePropertyType.js +25 -0
- package/src/rules/requireReturns.js +238 -0
- package/src/rules/requireReturnsCheck.js +145 -0
- package/src/rules/requireReturnsDescription.js +59 -0
- package/src/rules/requireReturnsType.js +51 -0
- package/src/rules/requireTemplate.js +201 -0
- package/src/rules/requireThrows.js +111 -0
- package/src/rules/requireYields.js +216 -0
- package/src/rules/requireYieldsCheck.js +208 -0
- package/src/rules/sortTags.js +558 -0
- package/src/rules/tagLines.js +359 -0
- package/src/rules/textEscaping.js +154 -0
- package/src/rules/validTypes.js +401 -0
- package/src/tagNames.js +238 -0
- package/src/utils/hasReturnValue.js +572 -0
- package/dist/WarnSettings.js +0 -20
- package/dist/WarnSettings.js.map +0 -1
- package/dist/_virtual/rolldown_runtime.cjs +0 -32
- package/dist/_virtual/rolldown_runtime.js +0 -11
- package/dist/alignTransform.js +0 -241
- package/dist/alignTransform.js.map +0 -1
- package/dist/defaultTagOrder.js +0 -134
- package/dist/defaultTagOrder.js.map +0 -1
- package/dist/exportParser.js +0 -518
- package/dist/exportParser.js.map +0 -1
- package/dist/getDefaultTagStructureForMode.js +0 -188
- package/dist/getDefaultTagStructureForMode.js.map +0 -1
- package/dist/getJsdocProcessorPlugin.d.cts +0 -70
- package/dist/getJsdocProcessorPlugin.d.cts.map +0 -1
- package/dist/getJsdocProcessorPlugin.js +0 -383
- package/dist/getJsdocProcessorPlugin.js.map +0 -1
- package/dist/index.d.cts +0 -2
- package/dist/index.js +0 -3
- package/dist/iterateJsdoc.d.cts +0 -472
- package/dist/iterateJsdoc.d.cts.map +0 -1
- package/dist/iterateJsdoc.js +0 -1628
- package/dist/iterateJsdoc.js.map +0 -1
- package/dist/jsdocUtils.js +0 -1123
- package/dist/jsdocUtils.js.map +0 -1
- package/dist/plugin.cjs +0 -427
- package/dist/plugin.cjs.map +0 -1
- package/dist/plugin.js +0 -427
- package/dist/plugin.js.map +0 -1
- package/dist/rules/checkAccess.js +0 -33
- package/dist/rules/checkAccess.js.map +0 -1
- package/dist/rules/checkAlignment.js +0 -47
- package/dist/rules/checkAlignment.js.map +0 -1
- package/dist/rules/checkExamples.js +0 -348
- package/dist/rules/checkExamples.js.map +0 -1
- package/dist/rules/checkIndentation.js +0 -59
- package/dist/rules/checkIndentation.js.map +0 -1
- package/dist/rules/checkLineAlignment.js +0 -229
- package/dist/rules/checkLineAlignment.js.map +0 -1
- package/dist/rules/checkParamNames.js +0 -237
- package/dist/rules/checkParamNames.js.map +0 -1
- package/dist/rules/checkPropertyNames.js +0 -88
- package/dist/rules/checkPropertyNames.js.map +0 -1
- package/dist/rules/checkSyntax.js +0 -25
- package/dist/rules/checkSyntax.js.map +0 -1
- package/dist/rules/checkTagNames.js +0 -191
- package/dist/rules/checkTagNames.js.map +0 -1
- package/dist/rules/checkTemplateNames.js +0 -124
- package/dist/rules/checkTemplateNames.js.map +0 -1
- package/dist/rules/checkTypes.js +0 -299
- package/dist/rules/checkTypes.js.map +0 -1
- package/dist/rules/checkValues.js +0 -103
- package/dist/rules/checkValues.js.map +0 -1
- package/dist/rules/convertToJsdocComments.js +0 -231
- package/dist/rules/convertToJsdocComments.js.map +0 -1
- package/dist/rules/emptyTags.js +0 -67
- package/dist/rules/emptyTags.js.map +0 -1
- package/dist/rules/implementsOnClasses.js +0 -40
- package/dist/rules/implementsOnClasses.js.map +0 -1
- package/dist/rules/importsAsDependencies.js +0 -68
- package/dist/rules/importsAsDependencies.js.map +0 -1
- package/dist/rules/informativeDocs.js +0 -110
- package/dist/rules/informativeDocs.js.map +0 -1
- package/dist/rules/linesBeforeBlock.js +0 -75
- package/dist/rules/linesBeforeBlock.js.map +0 -1
- package/dist/rules/matchDescription.js +0 -167
- package/dist/rules/matchDescription.js.map +0 -1
- package/dist/rules/matchName.js +0 -77
- package/dist/rules/matchName.js.map +0 -1
- package/dist/rules/multilineBlocks.js +0 -245
- package/dist/rules/multilineBlocks.js.map +0 -1
- package/dist/rules/noBadBlocks.js +0 -68
- package/dist/rules/noBadBlocks.js.map +0 -1
- package/dist/rules/noBlankBlockDescriptions.js +0 -41
- package/dist/rules/noBlankBlockDescriptions.js.map +0 -1
- package/dist/rules/noBlankBlocks.js +0 -30
- package/dist/rules/noBlankBlocks.js.map +0 -1
- package/dist/rules/noDefaults.js +0 -56
- package/dist/rules/noDefaults.js.map +0 -1
- package/dist/rules/noMissingSyntax.js +0 -126
- package/dist/rules/noMissingSyntax.js.map +0 -1
- package/dist/rules/noMultiAsterisks.js +0 -58
- package/dist/rules/noMultiAsterisks.js.map +0 -1
- package/dist/rules/noRestrictedSyntax.js +0 -49
- package/dist/rules/noRestrictedSyntax.js.map +0 -1
- package/dist/rules/noTypes.js +0 -65
- package/dist/rules/noTypes.js.map +0 -1
- package/dist/rules/noUndefinedTypes.js +0 -303
- package/dist/rules/noUndefinedTypes.js.map +0 -1
- package/dist/rules/requireAsteriskPrefix.js +0 -112
- package/dist/rules/requireAsteriskPrefix.js.map +0 -1
- package/dist/rules/requireDescription.js +0 -95
- package/dist/rules/requireDescription.js.map +0 -1
- package/dist/rules/requireDescriptionCompleteSentence.js +0 -220
- package/dist/rules/requireDescriptionCompleteSentence.js.map +0 -1
- package/dist/rules/requireExample.js +0 -77
- package/dist/rules/requireExample.js.map +0 -1
- package/dist/rules/requireFileOverview.js +0 -81
- package/dist/rules/requireFileOverview.js.map +0 -1
- package/dist/rules/requireHyphenBeforeParamDescription.js +0 -89
- package/dist/rules/requireHyphenBeforeParamDescription.js.map +0 -1
- package/dist/rules/requireJsdoc.js +0 -404
- package/dist/rules/requireJsdoc.js.map +0 -1
- package/dist/rules/requireParam.js +0 -344
- package/dist/rules/requireParam.js.map +0 -1
- package/dist/rules/requireParamDescription.js +0 -59
- package/dist/rules/requireParamDescription.js.map +0 -1
- package/dist/rules/requireParamName.js +0 -36
- package/dist/rules/requireParamName.js.map +0 -1
- package/dist/rules/requireParamType.js +0 -59
- package/dist/rules/requireParamType.js.map +0 -1
- package/dist/rules/requireProperty.js +0 -35
- package/dist/rules/requireProperty.js.map +0 -1
- package/dist/rules/requirePropertyDescription.js +0 -21
- package/dist/rules/requirePropertyDescription.js.map +0 -1
- package/dist/rules/requirePropertyName.js +0 -21
- package/dist/rules/requirePropertyName.js.map +0 -1
- package/dist/rules/requirePropertyType.js +0 -21
- package/dist/rules/requirePropertyType.js.map +0 -1
- package/dist/rules/requireReturns.js +0 -131
- package/dist/rules/requireReturns.js.map +0 -1
- package/dist/rules/requireReturnsCheck.js +0 -66
- package/dist/rules/requireReturnsCheck.js.map +0 -1
- package/dist/rules/requireReturnsDescription.js +0 -43
- package/dist/rules/requireReturnsDescription.js.map +0 -1
- package/dist/rules/requireReturnsType.js +0 -36
- package/dist/rules/requireReturnsType.js.map +0 -1
- package/dist/rules/requireTemplate.js +0 -122
- package/dist/rules/requireTemplate.js.map +0 -1
- package/dist/rules/requireThrows.js +0 -67
- package/dist/rules/requireThrows.js.map +0 -1
- package/dist/rules/requireYields.js +0 -115
- package/dist/rules/requireYields.js.map +0 -1
- package/dist/rules/requireYieldsCheck.js +0 -105
- package/dist/rules/requireYieldsCheck.js.map +0 -1
- package/dist/rules/sortTags.js +0 -262
- package/dist/rules/sortTags.js.map +0 -1
- package/dist/rules/tagLines.js +0 -183
- package/dist/rules/tagLines.js.map +0 -1
- package/dist/rules/textEscaping.js +0 -102
- package/dist/rules/textEscaping.js.map +0 -1
- package/dist/rules/validTypes.js +0 -259
- package/dist/rules/validTypes.js.map +0 -1
- package/dist/tagNames.js +0 -144
- package/dist/tagNames.js.map +0 -1
- package/dist/utils/hasReturnValue.js +0 -265
- package/dist/utils/hasReturnValue.js.map +0 -1
package/dist/tagNames.js
DELETED
|
@@ -1,144 +0,0 @@
|
|
|
1
|
-
//#region src/tagNames.js
|
|
2
|
-
/**
|
|
3
|
-
* @typedef {{
|
|
4
|
-
* [key: string]: string[]
|
|
5
|
-
* }} AliasedTags
|
|
6
|
-
*/
|
|
7
|
-
/**
|
|
8
|
-
* @type {AliasedTags}
|
|
9
|
-
*/
|
|
10
|
-
const jsdocTagsUndocumented = { modifies: [] };
|
|
11
|
-
/**
|
|
12
|
-
* @type {AliasedTags}
|
|
13
|
-
*/
|
|
14
|
-
const jsdocTags = {
|
|
15
|
-
...jsdocTagsUndocumented,
|
|
16
|
-
abstract: ["virtual"],
|
|
17
|
-
access: [],
|
|
18
|
-
alias: [],
|
|
19
|
-
async: [],
|
|
20
|
-
augments: ["extends"],
|
|
21
|
-
author: [],
|
|
22
|
-
borrows: [],
|
|
23
|
-
callback: [],
|
|
24
|
-
class: ["constructor"],
|
|
25
|
-
classdesc: [],
|
|
26
|
-
constant: ["const"],
|
|
27
|
-
constructs: [],
|
|
28
|
-
copyright: [],
|
|
29
|
-
default: ["defaultvalue"],
|
|
30
|
-
deprecated: [],
|
|
31
|
-
description: ["desc"],
|
|
32
|
-
enum: [],
|
|
33
|
-
event: [],
|
|
34
|
-
example: [],
|
|
35
|
-
exports: [],
|
|
36
|
-
external: ["host"],
|
|
37
|
-
file: ["fileoverview", "overview"],
|
|
38
|
-
fires: ["emits"],
|
|
39
|
-
function: ["func", "method"],
|
|
40
|
-
generator: [],
|
|
41
|
-
global: [],
|
|
42
|
-
hideconstructor: [],
|
|
43
|
-
ignore: [],
|
|
44
|
-
implements: [],
|
|
45
|
-
inheritdoc: [],
|
|
46
|
-
inheritDoc: [],
|
|
47
|
-
inner: [],
|
|
48
|
-
instance: [],
|
|
49
|
-
interface: [],
|
|
50
|
-
kind: [],
|
|
51
|
-
lends: [],
|
|
52
|
-
license: [],
|
|
53
|
-
listens: [],
|
|
54
|
-
member: ["var"],
|
|
55
|
-
memberof: [],
|
|
56
|
-
"memberof!": [],
|
|
57
|
-
mixes: [],
|
|
58
|
-
mixin: [],
|
|
59
|
-
module: [],
|
|
60
|
-
name: [],
|
|
61
|
-
namespace: [],
|
|
62
|
-
override: [],
|
|
63
|
-
package: [],
|
|
64
|
-
param: ["arg", "argument"],
|
|
65
|
-
private: [],
|
|
66
|
-
property: ["prop"],
|
|
67
|
-
protected: [],
|
|
68
|
-
public: [],
|
|
69
|
-
readonly: [],
|
|
70
|
-
requires: [],
|
|
71
|
-
returns: ["return"],
|
|
72
|
-
see: [],
|
|
73
|
-
since: [],
|
|
74
|
-
static: [],
|
|
75
|
-
summary: [],
|
|
76
|
-
this: [],
|
|
77
|
-
throws: ["exception"],
|
|
78
|
-
todo: [],
|
|
79
|
-
tutorial: [],
|
|
80
|
-
type: [],
|
|
81
|
-
typedef: [],
|
|
82
|
-
variation: [],
|
|
83
|
-
version: [],
|
|
84
|
-
yields: ["yield"]
|
|
85
|
-
};
|
|
86
|
-
/**
|
|
87
|
-
* @type {AliasedTags}
|
|
88
|
-
*/
|
|
89
|
-
const typeScriptTags = {
|
|
90
|
-
...jsdocTags,
|
|
91
|
-
import: [],
|
|
92
|
-
internal: [],
|
|
93
|
-
overload: [],
|
|
94
|
-
satisfies: [],
|
|
95
|
-
template: []
|
|
96
|
-
};
|
|
97
|
-
/**
|
|
98
|
-
* @type {AliasedTags}
|
|
99
|
-
*/
|
|
100
|
-
const undocumentedClosureTags = {
|
|
101
|
-
closurePrimitive: [],
|
|
102
|
-
customElement: [],
|
|
103
|
-
expose: [],
|
|
104
|
-
hidden: [],
|
|
105
|
-
idGenerator: [],
|
|
106
|
-
meaning: [],
|
|
107
|
-
mixinClass: [],
|
|
108
|
-
mixinFunction: [],
|
|
109
|
-
ngInject: [],
|
|
110
|
-
owner: [],
|
|
111
|
-
typeSummary: [],
|
|
112
|
-
wizaction: []
|
|
113
|
-
};
|
|
114
|
-
const { inheritdoc, internal, overload, returns, satisfies,...typeScriptTagsInClosure } = typeScriptTags;
|
|
115
|
-
/**
|
|
116
|
-
* @type {AliasedTags}
|
|
117
|
-
*/
|
|
118
|
-
const closureTags = {
|
|
119
|
-
...typeScriptTagsInClosure,
|
|
120
|
-
...undocumentedClosureTags,
|
|
121
|
-
define: [],
|
|
122
|
-
dict: [],
|
|
123
|
-
export: [],
|
|
124
|
-
externs: [],
|
|
125
|
-
final: [],
|
|
126
|
-
implicitCast: [],
|
|
127
|
-
noalias: [],
|
|
128
|
-
nocollapse: [],
|
|
129
|
-
nocompile: [],
|
|
130
|
-
noinline: [],
|
|
131
|
-
nosideeffects: [],
|
|
132
|
-
polymer: [],
|
|
133
|
-
polymerBehavior: [],
|
|
134
|
-
preserve: [],
|
|
135
|
-
record: [],
|
|
136
|
-
return: ["returns"],
|
|
137
|
-
struct: [],
|
|
138
|
-
suppress: [],
|
|
139
|
-
unrestricted: []
|
|
140
|
-
};
|
|
141
|
-
|
|
142
|
-
//#endregion
|
|
143
|
-
export { closureTags, jsdocTags, typeScriptTags };
|
|
144
|
-
//# sourceMappingURL=tagNames.js.map
|
package/dist/tagNames.js.map
DELETED
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"tagNames.js","names":[],"sources":["../src/tagNames.js"],"sourcesContent":["/**\n * @typedef {{\n * [key: string]: string[]\n * }} AliasedTags\n */\n\n/**\n * @type {AliasedTags}\n */\nconst jsdocTagsUndocumented = {\n // Undocumented but present; see\n // https://github.com/jsdoc/jsdoc/issues/1283#issuecomment-516816802\n // https://github.com/jsdoc/jsdoc/blob/master/packages/jsdoc/lib/jsdoc/tag/dictionary/definitions.js#L594\n modifies: [],\n};\n\n/**\n * @type {AliasedTags}\n */\nconst jsdocTags = {\n ...jsdocTagsUndocumented,\n abstract: [\n 'virtual',\n ],\n access: [],\n alias: [],\n async: [],\n augments: [\n 'extends',\n ],\n author: [],\n borrows: [],\n callback: [],\n class: [\n 'constructor',\n ],\n classdesc: [],\n constant: [\n 'const',\n ],\n constructs: [],\n copyright: [],\n default: [\n 'defaultvalue',\n ],\n deprecated: [],\n description: [\n 'desc',\n ],\n enum: [],\n event: [],\n example: [],\n exports: [],\n external: [\n 'host',\n ],\n file: [\n 'fileoverview',\n 'overview',\n ],\n fires: [\n 'emits',\n ],\n function: [\n 'func',\n 'method',\n ],\n generator: [],\n global: [],\n hideconstructor: [],\n ignore: [],\n implements: [],\n inheritdoc: [],\n\n // Allowing casing distinct from jsdoc `definitions.js` (required in Closure)\n inheritDoc: [],\n\n inner: [],\n instance: [],\n interface: [],\n kind: [],\n lends: [],\n license: [],\n listens: [],\n member: [\n 'var',\n ],\n memberof: [],\n 'memberof!': [],\n mixes: [],\n mixin: [],\n\n module: [],\n name: [],\n namespace: [],\n override: [],\n package: [],\n param: [\n 'arg',\n 'argument',\n ],\n private: [],\n property: [\n 'prop',\n ],\n protected: [],\n public: [],\n readonly: [],\n requires: [],\n returns: [\n 'return',\n ],\n see: [],\n since: [],\n static: [],\n summary: [],\n\n this: [],\n throws: [\n 'exception',\n ],\n todo: [],\n tutorial: [],\n type: [],\n typedef: [],\n variation: [],\n version: [],\n yields: [\n 'yield',\n ],\n};\n\n/**\n * @type {AliasedTags}\n */\nconst typeScriptTags = {\n ...jsdocTags,\n\n // https://github.com/microsoft/TypeScript/issues/22160\n // https://devblogs.microsoft.com/typescript/announcing-typescript-5-5/#the-jsdoc-import-tag\n import: [],\n\n // https://www.typescriptlang.org/tsconfig/#stripInternal\n internal: [],\n\n // https://devblogs.microsoft.com/typescript/announcing-typescript-5-0/#overload-support-in-jsdoc\n overload: [],\n\n // https://devblogs.microsoft.com/typescript/announcing-typescript-5-0/#satisfies-support-in-jsdoc\n satisfies: [],\n\n // `@template` is also in TypeScript per:\n // https://www.typescriptlang.org/docs/handbook/type-checking-javascript-files.html#supported-jsdoc\n template: [],\n};\n\n/**\n * @type {AliasedTags}\n */\nconst undocumentedClosureTags = {\n // These are in Closure source but not in jsdoc source nor in the Closure\n // docs: https://github.com/google/closure-compiler/blob/master/src/com/google/javascript/jscomp/parsing/Annotation.java\n closurePrimitive: [],\n customElement: [],\n expose: [],\n hidden: [],\n idGenerator: [],\n meaning: [],\n mixinClass: [],\n mixinFunction: [],\n ngInject: [],\n owner: [],\n typeSummary: [],\n wizaction: [],\n};\n\nconst {\n /* eslint-disable no-unused-vars */\n inheritdoc,\n internal,\n overload,\n // Will be inverted to prefer `return`\n returns,\n\n satisfies,\n /* eslint-enable no-unused-vars */\n ...typeScriptTagsInClosure\n} = typeScriptTags;\n\n/**\n * @type {AliasedTags}\n */\nconst closureTags = {\n ...typeScriptTagsInClosure,\n ...undocumentedClosureTags,\n\n // From https://github.com/google/closure-compiler/wiki/Annotating-JavaScript-for-the-Closure-Compiler\n // These are all recognized in https://github.com/jsdoc/jsdoc/blob/master/packages/jsdoc/lib/jsdoc/tag/dictionary/definitions.js\n // except for the experimental `noinline` and the casing differences noted below\n\n // Defined as a synonym of `const` in jsdoc `definitions.js`\n define: [],\n\n dict: [],\n export: [],\n externs: [],\n final: [],\n\n // With casing distinct from jsdoc `definitions.js`\n implicitCast: [],\n\n noalias: [],\n nocollapse: [],\n nocompile: [],\n noinline: [],\n nosideeffects: [],\n polymer: [],\n polymerBehavior: [],\n preserve: [],\n\n // Defined as a synonym of `interface` in jsdoc `definitions.js`\n record: [],\n\n return: [\n 'returns',\n ],\n\n struct: [],\n suppress: [],\n\n unrestricted: [],\n};\n\nexport {\n closureTags,\n jsdocTags,\n typeScriptTags,\n};\n"],"mappings":";;;;;;;;;AASA,MAAM,wBAAwB,EAI5B,UAAU,CAAE,EACb;;;;AAKD,MAAM,YAAY;CAChB,GAAG;CACH,UAAU,CACR,SACD;CACD,QAAQ,CAAE;CACV,OAAO,CAAE;CACT,OAAO,CAAE;CACT,UAAU,CACR,SACD;CACD,QAAQ,CAAE;CACV,SAAS,CAAE;CACX,UAAU,CAAE;CACZ,OAAO,CACL,aACD;CACD,WAAW,CAAE;CACb,UAAU,CACR,OACD;CACD,YAAY,CAAE;CACd,WAAW,CAAE;CACb,SAAS,CACP,cACD;CACD,YAAY,CAAE;CACd,aAAa,CACX,MACD;CACD,MAAM,CAAE;CACR,OAAO,CAAE;CACT,SAAS,CAAE;CACX,SAAS,CAAE;CACX,UAAU,CACR,MACD;CACD,MAAM,CACJ,gBACA,UACD;CACD,OAAO,CACL,OACD;CACD,UAAU,CACR,QACA,QACD;CACD,WAAW,CAAE;CACb,QAAQ,CAAE;CACV,iBAAiB,CAAE;CACnB,QAAQ,CAAE;CACV,YAAY,CAAE;CACd,YAAY,CAAE;CAGd,YAAY,CAAE;CAEd,OAAO,CAAE;CACT,UAAU,CAAE;CACZ,WAAW,CAAE;CACb,MAAM,CAAE;CACR,OAAO,CAAE;CACT,SAAS,CAAE;CACX,SAAS,CAAE;CACX,QAAQ,CACN,KACD;CACD,UAAU,CAAE;CACZ,aAAa,CAAE;CACf,OAAO,CAAE;CACT,OAAO,CAAE;CAET,QAAQ,CAAE;CACV,MAAM,CAAE;CACR,WAAW,CAAE;CACb,UAAU,CAAE;CACZ,SAAS,CAAE;CACX,OAAO,CACL,OACA,UACD;CACD,SAAS,CAAE;CACX,UAAU,CACR,MACD;CACD,WAAW,CAAE;CACb,QAAQ,CAAE;CACV,UAAU,CAAE;CACZ,UAAU,CAAE;CACZ,SAAS,CACP,QACD;CACD,KAAK,CAAE;CACP,OAAO,CAAE;CACT,QAAQ,CAAE;CACV,SAAS,CAAE;CAEX,MAAM,CAAE;CACR,QAAQ,CACN,WACD;CACD,MAAM,CAAE;CACR,UAAU,CAAE;CACZ,MAAM,CAAE;CACR,SAAS,CAAE;CACX,WAAW,CAAE;CACb,SAAS,CAAE;CACX,QAAQ,CACN,OACD;AACF;;;;AAKD,MAAM,iBAAiB;CACrB,GAAG;CAIH,QAAQ,CAAE;CAGV,UAAU,CAAE;CAGZ,UAAU,CAAE;CAGZ,WAAW,CAAE;CAIb,UAAU,CAAE;AACb;;;;AAKD,MAAM,0BAA0B;CAG9B,kBAAkB,CAAE;CACpB,eAAe,CAAE;CACjB,QAAQ,CAAE;CACV,QAAQ,CAAE;CACV,aAAa,CAAE;CACf,SAAS,CAAE;CACX,YAAY,CAAE;CACd,eAAe,CAAE;CACjB,UAAU,CAAE;CACZ,OAAO,CAAE;CACT,aAAa,CAAE;CACf,WAAW,CAAE;AACd;AAED,MAAM,EAEJ,YACA,UACA,UAEA,SAEA,UAEA,GAAG,yBACJ,GAAG;;;;AAKJ,MAAM,cAAc;CAClB,GAAG;CACH,GAAG;CAOH,QAAQ,CAAE;CAEV,MAAM,CAAE;CACR,QAAQ,CAAE;CACV,SAAS,CAAE;CACX,OAAO,CAAE;CAGT,cAAc,CAAE;CAEhB,SAAS,CAAE;CACX,YAAY,CAAE;CACd,WAAW,CAAE;CACb,UAAU,CAAE;CACZ,eAAe,CAAE;CACjB,SAAS,CAAE;CACX,iBAAiB,CAAE;CACnB,UAAU,CAAE;CAGZ,QAAQ,CAAE;CAEV,QAAQ,CACN,SACD;CAED,QAAQ,CAAE;CACV,UAAU,CAAE;CAEZ,cAAc,CAAE;AACjB"}
|
|
@@ -1,265 +0,0 @@
|
|
|
1
|
-
//#region src/utils/hasReturnValue.js
|
|
2
|
-
/**
|
|
3
|
-
* @typedef {import('estree').Node|
|
|
4
|
-
* import('@typescript-eslint/types').TSESTree.Node} ESTreeOrTypeScriptNode
|
|
5
|
-
*/
|
|
6
|
-
/**
|
|
7
|
-
* Checks if a node is a promise but has no resolve value or an empty value.
|
|
8
|
-
* An `undefined` resolve does not count.
|
|
9
|
-
* @param {ESTreeOrTypeScriptNode|undefined|null} node
|
|
10
|
-
* @returns {boolean|undefined|null}
|
|
11
|
-
*/
|
|
12
|
-
const isNewPromiseExpression = (node) => {
|
|
13
|
-
return node && node.type === "NewExpression" && node.callee.type === "Identifier" && node.callee.name === "Promise";
|
|
14
|
-
};
|
|
15
|
-
/**
|
|
16
|
-
* @param {ESTreeOrTypeScriptNode|null|undefined} node
|
|
17
|
-
* @returns {boolean}
|
|
18
|
-
*/
|
|
19
|
-
const isVoidPromise = (node) => {
|
|
20
|
-
return node?.typeArguments?.params?.[0]?.type === "TSVoidKeyword" || node?.typeParameters?.params?.[0]?.type === "TSVoidKeyword";
|
|
21
|
-
};
|
|
22
|
-
const undefinedKeywords = new Set([
|
|
23
|
-
"TSNeverKeyword",
|
|
24
|
-
"TSUndefinedKeyword",
|
|
25
|
-
"TSVoidKeyword"
|
|
26
|
-
]);
|
|
27
|
-
/**
|
|
28
|
-
* Checks if a node has a return statement. Void return does not count.
|
|
29
|
-
* @param {ESTreeOrTypeScriptNode|undefined|null} node
|
|
30
|
-
* @param {boolean} [throwOnNullReturn]
|
|
31
|
-
* @param {PromiseFilter} [promFilter]
|
|
32
|
-
* @returns {boolean|undefined}
|
|
33
|
-
*/
|
|
34
|
-
const hasReturnValue = (node, throwOnNullReturn, promFilter) => {
|
|
35
|
-
if (!node) return false;
|
|
36
|
-
switch (node.type) {
|
|
37
|
-
case "ArrowFunctionExpression":
|
|
38
|
-
case "FunctionDeclaration":
|
|
39
|
-
case "FunctionExpression": return "expression" in node && node.expression && (!isNewPromiseExpression(node.body) || !isVoidPromise(node.body)) || hasReturnValue(node.body, throwOnNullReturn, promFilter);
|
|
40
|
-
case "BlockStatement": return node.body.some((bodyNode) => {
|
|
41
|
-
return bodyNode.type !== "FunctionDeclaration" && hasReturnValue(bodyNode, throwOnNullReturn, promFilter);
|
|
42
|
-
});
|
|
43
|
-
case "DoWhileStatement":
|
|
44
|
-
case "ForInStatement":
|
|
45
|
-
case "ForOfStatement":
|
|
46
|
-
case "ForStatement":
|
|
47
|
-
case "LabeledStatement":
|
|
48
|
-
case "WhileStatement":
|
|
49
|
-
case "WithStatement": return hasReturnValue(node.body, throwOnNullReturn, promFilter);
|
|
50
|
-
case "IfStatement": return hasReturnValue(node.consequent, throwOnNullReturn, promFilter) || hasReturnValue(node.alternate, throwOnNullReturn, promFilter);
|
|
51
|
-
case "MethodDefinition": return hasReturnValue(node.value, throwOnNullReturn, promFilter);
|
|
52
|
-
case "ReturnStatement":
|
|
53
|
-
if (node.argument === null) {
|
|
54
|
-
if (throwOnNullReturn) throw new Error("Null return");
|
|
55
|
-
return false;
|
|
56
|
-
}
|
|
57
|
-
if (promFilter && isNewPromiseExpression(node.argument)) return promFilter(node.argument);
|
|
58
|
-
return true;
|
|
59
|
-
case "SwitchStatement": return node.cases.some((someCase) => {
|
|
60
|
-
return someCase.consequent.some((nde) => {
|
|
61
|
-
return hasReturnValue(nde, throwOnNullReturn, promFilter);
|
|
62
|
-
});
|
|
63
|
-
});
|
|
64
|
-
case "TryStatement": return hasReturnValue(node.block, throwOnNullReturn, promFilter) || hasReturnValue(node.handler && node.handler.body, throwOnNullReturn, promFilter) || hasReturnValue(node.finalizer, throwOnNullReturn, promFilter);
|
|
65
|
-
case "TSDeclareFunction":
|
|
66
|
-
case "TSFunctionType":
|
|
67
|
-
case "TSMethodSignature": {
|
|
68
|
-
const type = node?.returnType?.typeAnnotation?.type;
|
|
69
|
-
return type && !undefinedKeywords.has(type);
|
|
70
|
-
}
|
|
71
|
-
default: return false;
|
|
72
|
-
}
|
|
73
|
-
};
|
|
74
|
-
/**
|
|
75
|
-
* Checks if a node has a return statement. Void return does not count.
|
|
76
|
-
* @param {ESTreeOrTypeScriptNode|null|undefined} node
|
|
77
|
-
* @param {PromiseFilter} promFilter
|
|
78
|
-
* @returns {undefined|boolean|ESTreeOrTypeScriptNode}
|
|
79
|
-
*/
|
|
80
|
-
const allBrancheshaveReturnValues = (node, promFilter) => {
|
|
81
|
-
if (!node) return false;
|
|
82
|
-
switch (node.type) {
|
|
83
|
-
case "ArrowFunctionExpression":
|
|
84
|
-
case "FunctionDeclaration":
|
|
85
|
-
case "FunctionExpression": return "expression" in node && node.expression && (!isNewPromiseExpression(node.body) || !isVoidPromise(node.body)) || allBrancheshaveReturnValues(node.body, promFilter) || node.body.body.some((nde) => {
|
|
86
|
-
return nde.type === "ReturnStatement";
|
|
87
|
-
});
|
|
88
|
-
case "BlockStatement": {
|
|
89
|
-
const lastBodyNode = node.body.slice(-1)[0];
|
|
90
|
-
return allBrancheshaveReturnValues(lastBodyNode, promFilter);
|
|
91
|
-
}
|
|
92
|
-
case "DoWhileStatement":
|
|
93
|
-
case "WhileStatement": if (node.test.value === true) return hasReturnValue(node.body, false, promFilter);
|
|
94
|
-
case "ForStatement": if (node.test === null) return hasReturnValue(node.body, false, promFilter);
|
|
95
|
-
case "ForInStatement":
|
|
96
|
-
case "ForOfStatement":
|
|
97
|
-
case "LabeledStatement":
|
|
98
|
-
case "WithStatement": return allBrancheshaveReturnValues(node.body, promFilter);
|
|
99
|
-
case "IfStatement": return allBrancheshaveReturnValues(node.consequent, promFilter) && allBrancheshaveReturnValues(node.alternate, promFilter);
|
|
100
|
-
case "ReturnStatement":
|
|
101
|
-
if (node.argument === null) return false;
|
|
102
|
-
if (promFilter && isNewPromiseExpression(node.argument)) return promFilter(node.argument);
|
|
103
|
-
return true;
|
|
104
|
-
case "SwitchStatement": return node.cases.every((someCase) => {
|
|
105
|
-
return !someCase.consequent.some((consNode) => {
|
|
106
|
-
return consNode.type === "BreakStatement" || consNode.type === "ReturnStatement" && consNode.argument === null;
|
|
107
|
-
});
|
|
108
|
-
});
|
|
109
|
-
case "ThrowStatement": return true;
|
|
110
|
-
case "TryStatement": return node.finalizer && allBrancheshaveReturnValues(node.finalizer, promFilter) || allBrancheshaveReturnValues(node.block, promFilter) && (!node.handler || allBrancheshaveReturnValues(node.handler && node.handler.body, promFilter)) && (!node.finalizer || (() => {
|
|
111
|
-
try {
|
|
112
|
-
hasReturnValue(node.finalizer, true, promFilter);
|
|
113
|
-
} catch (error) {
|
|
114
|
-
if (error.message === "Null return") return false;
|
|
115
|
-
/* c8 ignore next 3 */
|
|
116
|
-
throw error;
|
|
117
|
-
}
|
|
118
|
-
return true;
|
|
119
|
-
})());
|
|
120
|
-
case "TSDeclareFunction":
|
|
121
|
-
case "TSFunctionType":
|
|
122
|
-
case "TSMethodSignature": {
|
|
123
|
-
const type = node?.returnType?.typeAnnotation?.type;
|
|
124
|
-
return type && !undefinedKeywords.has(type);
|
|
125
|
-
}
|
|
126
|
-
default: return false;
|
|
127
|
-
}
|
|
128
|
-
};
|
|
129
|
-
/**
|
|
130
|
-
* @callback PromiseFilter
|
|
131
|
-
* @param {ESTreeOrTypeScriptNode|undefined} node
|
|
132
|
-
* @returns {boolean}
|
|
133
|
-
*/
|
|
134
|
-
/**
|
|
135
|
-
* Avoids further checking child nodes if a nested function shadows the
|
|
136
|
-
* resolver, but otherwise, if name is used (by call or passed in as an
|
|
137
|
-
* argument to another function), will be considered as non-empty.
|
|
138
|
-
*
|
|
139
|
-
* This could check for redeclaration of the resolver, but as such is
|
|
140
|
-
* unlikely, we avoid the performance cost of checking everywhere for
|
|
141
|
-
* (re)declarations or assignments.
|
|
142
|
-
* @param {import('@typescript-eslint/types').TSESTree.Node|null|undefined} node
|
|
143
|
-
* @param {string} resolverName
|
|
144
|
-
* @returns {boolean}
|
|
145
|
-
*/
|
|
146
|
-
const hasNonEmptyResolverCall = (node, resolverName) => {
|
|
147
|
-
if (!node) return false;
|
|
148
|
-
switch (node.type) {
|
|
149
|
-
case "ArrayExpression":
|
|
150
|
-
case "ArrayPattern": return node.elements.some((element) => {
|
|
151
|
-
return hasNonEmptyResolverCall(element, resolverName);
|
|
152
|
-
});
|
|
153
|
-
case "ArrowFunctionExpression":
|
|
154
|
-
case "FunctionDeclaration":
|
|
155
|
-
case "FunctionExpression":
|
|
156
|
-
if (node.params[0]?.name === resolverName) return false;
|
|
157
|
-
return hasNonEmptyResolverCall(node.body, resolverName);
|
|
158
|
-
case "AssignmentExpression":
|
|
159
|
-
case "BinaryExpression":
|
|
160
|
-
case "LogicalExpression": return hasNonEmptyResolverCall(node.left, resolverName) || hasNonEmptyResolverCall(node.right, resolverName);
|
|
161
|
-
case "AssignmentPattern": return hasNonEmptyResolverCall(node.right, resolverName);
|
|
162
|
-
case "AwaitExpression":
|
|
163
|
-
case "SpreadElement":
|
|
164
|
-
case "UnaryExpression":
|
|
165
|
-
case "YieldExpression": return hasNonEmptyResolverCall(node.argument, resolverName);
|
|
166
|
-
case "BlockStatement":
|
|
167
|
-
case "ClassBody": return node.body.some((bodyNode) => {
|
|
168
|
-
return hasNonEmptyResolverCall(bodyNode, resolverName);
|
|
169
|
-
});
|
|
170
|
-
case "CallExpression":
|
|
171
|
-
case "OptionalCallExpression": return node.callee.name === resolverName && (node.arguments.length > 1 || node.arguments[0] !== void 0) || node.arguments.some((nde) => {
|
|
172
|
-
return nde.type === "Identifier" && nde.name === resolverName || hasNonEmptyResolverCall(nde, resolverName);
|
|
173
|
-
});
|
|
174
|
-
case "ChainExpression":
|
|
175
|
-
case "Decorator":
|
|
176
|
-
case "ExpressionStatement": return hasNonEmptyResolverCall(node.expression, resolverName);
|
|
177
|
-
case "ClassDeclaration":
|
|
178
|
-
case "ClassExpression": return hasNonEmptyResolverCall(node.body, resolverName);
|
|
179
|
-
case "ClassMethod":
|
|
180
|
-
case "MethodDefinition": return node.decorators && node.decorators.some((decorator) => {
|
|
181
|
-
return hasNonEmptyResolverCall(decorator, resolverName);
|
|
182
|
-
}) || node.computed && hasNonEmptyResolverCall(node.key, resolverName) || hasNonEmptyResolverCall(node.value, resolverName);
|
|
183
|
-
case "ClassProperty":
|
|
184
|
-
case "ObjectProperty":
|
|
185
|
-
case "Property":
|
|
186
|
-
case "PropertyDefinition": return node.computed && hasNonEmptyResolverCall(node.key, resolverName) || hasNonEmptyResolverCall(node.value, resolverName);
|
|
187
|
-
case "ConditionalExpression":
|
|
188
|
-
case "IfStatement": return hasNonEmptyResolverCall(node.test, resolverName) || hasNonEmptyResolverCall(node.consequent, resolverName) || hasNonEmptyResolverCall(node.alternate, resolverName);
|
|
189
|
-
case "DoWhileStatement":
|
|
190
|
-
case "ForInStatement":
|
|
191
|
-
case "ForOfStatement":
|
|
192
|
-
case "ForStatement":
|
|
193
|
-
case "LabeledStatement":
|
|
194
|
-
case "WhileStatement":
|
|
195
|
-
case "WithStatement": return hasNonEmptyResolverCall(node.body, resolverName);
|
|
196
|
-
case "Import":
|
|
197
|
-
case "ImportExpression": return hasNonEmptyResolverCall(node.source, resolverName);
|
|
198
|
-
case "MemberExpression":
|
|
199
|
-
case "OptionalMemberExpression": return hasNonEmptyResolverCall(node.object, resolverName) || hasNonEmptyResolverCall(node.property, resolverName);
|
|
200
|
-
case "ObjectExpression":
|
|
201
|
-
case "ObjectPattern": return node.properties.some((property) => {
|
|
202
|
-
return hasNonEmptyResolverCall(property, resolverName);
|
|
203
|
-
});
|
|
204
|
-
case "ObjectMethod":
|
|
205
|
-
/* c8 ignore next 6 -- In Babel? */
|
|
206
|
-
return node.computed && hasNonEmptyResolverCall(node.key, resolverName) || node.arguments.some((nde) => {
|
|
207
|
-
return hasNonEmptyResolverCall(nde, resolverName);
|
|
208
|
-
});
|
|
209
|
-
case "ReturnStatement":
|
|
210
|
-
if (node.argument === null) return false;
|
|
211
|
-
return hasNonEmptyResolverCall(node.argument, resolverName);
|
|
212
|
-
case "SequenceExpression":
|
|
213
|
-
case "TemplateLiteral": return node.expressions.some((subExpression) => {
|
|
214
|
-
return hasNonEmptyResolverCall(subExpression, resolverName);
|
|
215
|
-
});
|
|
216
|
-
case "SwitchStatement": return node.cases.some((someCase) => {
|
|
217
|
-
return someCase.consequent.some((nde) => {
|
|
218
|
-
return hasNonEmptyResolverCall(nde, resolverName);
|
|
219
|
-
});
|
|
220
|
-
});
|
|
221
|
-
case "TaggedTemplateExpression": return hasNonEmptyResolverCall(node.quasi, resolverName);
|
|
222
|
-
case "TryStatement": return hasNonEmptyResolverCall(node.block, resolverName) || hasNonEmptyResolverCall(node.handler && node.handler.body, resolverName) || hasNonEmptyResolverCall(node.finalizer, resolverName);
|
|
223
|
-
case "VariableDeclaration": return node.declarations.some((nde) => {
|
|
224
|
-
return hasNonEmptyResolverCall(nde, resolverName);
|
|
225
|
-
});
|
|
226
|
-
case "VariableDeclarator": return hasNonEmptyResolverCall(node.id, resolverName) || hasNonEmptyResolverCall(node.init, resolverName);
|
|
227
|
-
default: return false;
|
|
228
|
-
}
|
|
229
|
-
};
|
|
230
|
-
/**
|
|
231
|
-
* Checks if a Promise executor has no resolve value or an empty value.
|
|
232
|
-
* An `undefined` resolve does not count.
|
|
233
|
-
* @param {ESTreeOrTypeScriptNode} node
|
|
234
|
-
* @param {boolean} anyPromiseAsReturn
|
|
235
|
-
* @param {boolean} [allBranches]
|
|
236
|
-
* @returns {boolean}
|
|
237
|
-
*/
|
|
238
|
-
const hasValueOrExecutorHasNonEmptyResolveValue = (node, anyPromiseAsReturn, allBranches) => {
|
|
239
|
-
const hasReturnMethod = allBranches ? (nde, promiseFilter) => {
|
|
240
|
-
let hasReturn;
|
|
241
|
-
try {
|
|
242
|
-
hasReturn = hasReturnValue(nde, true, promiseFilter);
|
|
243
|
-
} catch (error) {
|
|
244
|
-
// c8 ignore else
|
|
245
|
-
if (error.message === "Null return") return false;
|
|
246
|
-
/* c8 ignore next 3 */
|
|
247
|
-
throw error;
|
|
248
|
-
}
|
|
249
|
-
return Boolean(hasReturn && allBrancheshaveReturnValues(nde, promiseFilter));
|
|
250
|
-
} : (nde, promiseFilter) => {
|
|
251
|
-
return Boolean(hasReturnValue(nde, false, promiseFilter));
|
|
252
|
-
};
|
|
253
|
-
return hasReturnMethod(node, (prom) => {
|
|
254
|
-
if (anyPromiseAsReturn) return true;
|
|
255
|
-
if (isVoidPromise(prom)) return false;
|
|
256
|
-
const { body, params } = prom.arguments[0] || {};
|
|
257
|
-
if (!params?.length) return false;
|
|
258
|
-
const { name: resolverName } = params[0];
|
|
259
|
-
return hasNonEmptyResolverCall(body, resolverName);
|
|
260
|
-
});
|
|
261
|
-
};
|
|
262
|
-
|
|
263
|
-
//#endregion
|
|
264
|
-
export { hasReturnValue, hasValueOrExecutorHasNonEmptyResolveValue };
|
|
265
|
-
//# sourceMappingURL=hasReturnValue.js.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"hasReturnValue.js","names":[],"sources":["../../src/utils/hasReturnValue.js"],"sourcesContent":["/**\n * @typedef {import('estree').Node|\n * import('@typescript-eslint/types').TSESTree.Node} ESTreeOrTypeScriptNode\n */\n\n/**\n * Checks if a node is a promise but has no resolve value or an empty value.\n * An `undefined` resolve does not count.\n * @param {ESTreeOrTypeScriptNode|undefined|null} node\n * @returns {boolean|undefined|null}\n */\nconst isNewPromiseExpression = (node) => {\n return node && node.type === 'NewExpression' && node.callee.type === 'Identifier' &&\n node.callee.name === 'Promise';\n};\n\n/**\n * @param {ESTreeOrTypeScriptNode|null|undefined} node\n * @returns {boolean}\n */\nconst isVoidPromise = (node) => {\n return /** @type {import('@typescript-eslint/types').TSESTree.TSTypeReference} */ (node)?.typeArguments?.params?.[0]?.type === 'TSVoidKeyword'\n /* c8 ignore next 5 */\n // eslint-disable-next-line @stylistic/operator-linebreak -- c8\n || /** @type {import('@typescript-eslint/types').TSESTree.TSTypeReference} */ (\n node\n // @ts-expect-error Ok\n )?.typeParameters?.params?.[0]?.type === 'TSVoidKeyword';\n};\n\nconst undefinedKeywords = new Set([\n 'TSNeverKeyword', 'TSUndefinedKeyword', 'TSVoidKeyword',\n]);\n\n/**\n * Checks if a node has a return statement. Void return does not count.\n * @param {ESTreeOrTypeScriptNode|undefined|null} node\n * @param {boolean} [throwOnNullReturn]\n * @param {PromiseFilter} [promFilter]\n * @returns {boolean|undefined}\n */\n// eslint-disable-next-line complexity\nconst hasReturnValue = (node, throwOnNullReturn, promFilter) => {\n if (!node) {\n return false;\n }\n\n switch (node.type) {\n case 'ArrowFunctionExpression':\n case 'FunctionDeclaration':\n case 'FunctionExpression': {\n return 'expression' in node && node.expression && (!isNewPromiseExpression(\n node.body,\n ) || !isVoidPromise(node.body)) ||\n hasReturnValue(node.body, throwOnNullReturn, promFilter);\n }\n\n case 'BlockStatement': {\n return node.body.some((bodyNode) => {\n return bodyNode.type !== 'FunctionDeclaration' && hasReturnValue(bodyNode, throwOnNullReturn, promFilter);\n });\n }\n\n case 'DoWhileStatement':\n case 'ForInStatement':\n case 'ForOfStatement':\n\n case 'ForStatement':\n\n case 'LabeledStatement':\n case 'WhileStatement':\n case 'WithStatement': {\n return hasReturnValue(node.body, throwOnNullReturn, promFilter);\n }\n\n case 'IfStatement': {\n return hasReturnValue(node.consequent, throwOnNullReturn, promFilter) ||\n hasReturnValue(node.alternate, throwOnNullReturn, promFilter);\n }\n\n case 'MethodDefinition':\n return hasReturnValue(node.value, throwOnNullReturn, promFilter);\n case 'ReturnStatement': {\n // void return does not count.\n if (node.argument === null) {\n if (throwOnNullReturn) {\n throw new Error('Null return');\n }\n\n return false;\n }\n\n if (promFilter && isNewPromiseExpression(node.argument)) {\n // Let caller decide how to filter, but this is, at the least,\n // a return of sorts and truthy\n return promFilter(node.argument);\n }\n\n return true;\n }\n\n case 'SwitchStatement': {\n return node.cases.some(\n (someCase) => {\n return someCase.consequent.some((nde) => {\n return hasReturnValue(nde, throwOnNullReturn, promFilter);\n });\n },\n );\n }\n\n case 'TryStatement': {\n return hasReturnValue(node.block, throwOnNullReturn, promFilter) ||\n hasReturnValue(node.handler && node.handler.body, throwOnNullReturn, promFilter) ||\n hasReturnValue(node.finalizer, throwOnNullReturn, promFilter);\n }\n\n case 'TSDeclareFunction':\n\n case 'TSFunctionType':\n\n case 'TSMethodSignature': {\n const type = node?.returnType?.typeAnnotation?.type;\n return type && !undefinedKeywords.has(type);\n }\n\n default: {\n return false;\n }\n }\n};\n\n/**\n * Checks if a node has a return statement. Void return does not count.\n * @param {ESTreeOrTypeScriptNode|null|undefined} node\n * @param {PromiseFilter} promFilter\n * @returns {undefined|boolean|ESTreeOrTypeScriptNode}\n */\n// eslint-disable-next-line complexity\nconst allBrancheshaveReturnValues = (node, promFilter) => {\n if (!node) {\n return false;\n }\n\n switch (node.type) {\n // case 'MethodDefinition':\n // return allBrancheshaveReturnValues(node.value, promFilter);\n case 'ArrowFunctionExpression':\n case 'FunctionDeclaration':\n case 'FunctionExpression': {\n return 'expression' in node && node.expression && (!isNewPromiseExpression(node.body) || !isVoidPromise(node.body)) ||\n allBrancheshaveReturnValues(node.body, promFilter) ||\n /** @type {import('@typescript-eslint/types').TSESTree.BlockStatement} */\n (node.body).body.some((nde) => {\n return nde.type === 'ReturnStatement';\n });\n }\n\n case 'BlockStatement': {\n const lastBodyNode = node.body.slice(-1)[0];\n return allBrancheshaveReturnValues(lastBodyNode, promFilter);\n }\n\n case 'DoWhileStatement':\n case 'WhileStatement':\n if (\n /**\n * @type {import('@typescript-eslint/types').TSESTree.Literal}\n */\n (node.test).value === true\n ) {\n // If this is an infinite loop, we assume only one branch\n // is needed to provide a return\n return hasReturnValue(node.body, false, promFilter);\n }\n\n // Fallthrough\n case 'ForStatement':\n if (node.test === null) {\n // If this is an infinite loop, we assume only one branch\n // is needed to provide a return\n return hasReturnValue(node.body, false, promFilter);\n }\n\n case 'ForInStatement':\n case 'ForOfStatement':\n\n case 'LabeledStatement':\n\n case 'WithStatement': {\n return allBrancheshaveReturnValues(node.body, promFilter);\n }\n\n case 'IfStatement': {\n return allBrancheshaveReturnValues(node.consequent, promFilter) &&\n allBrancheshaveReturnValues(node.alternate, promFilter);\n }\n\n case 'ReturnStatement': {\n // void return does not count.\n if (node.argument === null) {\n return false;\n }\n\n if (promFilter && isNewPromiseExpression(node.argument)) {\n // Let caller decide how to filter, but this is, at the least,\n // a return of sorts and truthy\n return promFilter(node.argument);\n }\n\n return true;\n }\n\n case 'SwitchStatement': {\n return /** @type {import('@typescript-eslint/types').TSESTree.SwitchStatement} */ (node).cases.every(\n (someCase) => {\n return !someCase.consequent.some((consNode) => {\n return consNode.type === 'BreakStatement' ||\n consNode.type === 'ReturnStatement' && consNode.argument === null;\n });\n },\n );\n }\n\n case 'ThrowStatement': {\n return true;\n }\n\n case 'TryStatement': {\n // If `finally` returns, all return\n return node.finalizer && allBrancheshaveReturnValues(node.finalizer, promFilter) ||\n // Return in `try`/`catch` may still occur despite `finally`\n allBrancheshaveReturnValues(node.block, promFilter) &&\n (!node.handler ||\n allBrancheshaveReturnValues(node.handler && node.handler.body, promFilter)) &&\n (!node.finalizer || (() => {\n try {\n hasReturnValue(node.finalizer, true, promFilter);\n } catch (error) {\n if (/** @type {Error} */ (error).message === 'Null return') {\n return false;\n }\n /* c8 ignore next 3 */\n // eslint-disable-next-line @stylistic/padding-line-between-statements -- c8\n throw error;\n }\n\n // As long as not an explicit empty return, then return true\n return true;\n })());\n }\n\n case 'TSDeclareFunction':\n\n case 'TSFunctionType':\n\n case 'TSMethodSignature': {\n const type = node?.returnType?.typeAnnotation?.type;\n return type && !undefinedKeywords.has(type);\n }\n\n default: {\n return false;\n }\n }\n};\n\n/**\n * @callback PromiseFilter\n * @param {ESTreeOrTypeScriptNode|undefined} node\n * @returns {boolean}\n */\n\n/**\n * Avoids further checking child nodes if a nested function shadows the\n * resolver, but otherwise, if name is used (by call or passed in as an\n * argument to another function), will be considered as non-empty.\n *\n * This could check for redeclaration of the resolver, but as such is\n * unlikely, we avoid the performance cost of checking everywhere for\n * (re)declarations or assignments.\n * @param {import('@typescript-eslint/types').TSESTree.Node|null|undefined} node\n * @param {string} resolverName\n * @returns {boolean}\n */\n// eslint-disable-next-line complexity\nconst hasNonEmptyResolverCall = (node, resolverName) => {\n if (!node) {\n return false;\n }\n\n // Arrow function without block\n switch (node.type) {\n case 'ArrayExpression':\n case 'ArrayPattern':\n return node.elements.some((element) => {\n return hasNonEmptyResolverCall(element, resolverName);\n });\n case 'ArrowFunctionExpression':\n case 'FunctionDeclaration':\n case 'FunctionExpression': {\n // Shadowing\n if (/** @type {import('@typescript-eslint/types').TSESTree.Identifier} */ (\n node.params[0]\n )?.name === resolverName) {\n return false;\n }\n\n return hasNonEmptyResolverCall(node.body, resolverName);\n }\n\n case 'AssignmentExpression':\n case 'BinaryExpression':\n case 'LogicalExpression': {\n return hasNonEmptyResolverCall(node.left, resolverName) ||\n hasNonEmptyResolverCall(node.right, resolverName);\n }\n\n case 'AssignmentPattern':\n return hasNonEmptyResolverCall(node.right, resolverName);\n case 'AwaitExpression':\n\n case 'SpreadElement':\n case 'UnaryExpression':\n case 'YieldExpression':\n return hasNonEmptyResolverCall(node.argument, resolverName);\n case 'BlockStatement':\n case 'ClassBody':\n return node.body.some((bodyNode) => {\n return hasNonEmptyResolverCall(bodyNode, resolverName);\n });\n /* c8 ignore next 2 -- In Babel? */\n case 'CallExpression':\n // @ts-expect-error Babel?\n case 'OptionalCallExpression':\n return /** @type {import('@typescript-eslint/types').TSESTree.Identifier} */ (\n node.callee\n ).name === resolverName && (\n\n // Implicit or explicit undefined\n node.arguments.length > 1 || node.arguments[0] !== undefined\n ) ||\n node.arguments.some((nde) => {\n // Being passed in to another function (which might invoke it)\n return nde.type === 'Identifier' && nde.name === resolverName ||\n\n // Handle nested items\n hasNonEmptyResolverCall(nde, resolverName);\n });\n\n case 'ChainExpression':\n case 'Decorator':\n\n case 'ExpressionStatement':\n return hasNonEmptyResolverCall(node.expression, resolverName);\n\n case 'ClassDeclaration':\n\n case 'ClassExpression':\n return hasNonEmptyResolverCall(node.body, resolverName);\n /* c8 ignore next 2 -- In Babel? */\n // @ts-expect-error Babel?\n case 'ClassMethod':\n\n case 'MethodDefinition':\n return node.decorators && node.decorators.some((decorator) => {\n return hasNonEmptyResolverCall(decorator, resolverName);\n }) ||\n node.computed && hasNonEmptyResolverCall(node.key, resolverName) ||\n hasNonEmptyResolverCall(node.value, resolverName);\n\n /* c8 ignore next 2 -- In Babel? */\n // @ts-expect-error Babel?\n case 'ClassProperty':\n /* c8 ignore next 2 -- In Babel? */\n // @ts-expect-error Babel?\n case 'ObjectProperty':\n case 'Property':\n\n case 'PropertyDefinition':\n return node.computed && hasNonEmptyResolverCall(node.key, resolverName) ||\n hasNonEmptyResolverCall(node.value, resolverName);\n case 'ConditionalExpression':\n\n case 'IfStatement': {\n return hasNonEmptyResolverCall(node.test, resolverName) ||\n hasNonEmptyResolverCall(node.consequent, resolverName) ||\n hasNonEmptyResolverCall(node.alternate, resolverName);\n }\n\n case 'DoWhileStatement':\n case 'ForInStatement':\n case 'ForOfStatement':\n\n case 'ForStatement':\n case 'LabeledStatement':\n case 'WhileStatement':\n case 'WithStatement': {\n return hasNonEmptyResolverCall(node.body, resolverName);\n }\n\n /* c8 ignore next 2 -- In Babel? */\n // @ts-expect-error Babel?\n case 'Import':\n\n case 'ImportExpression':\n return hasNonEmptyResolverCall(node.source, resolverName);\n // ?.\n /* c8 ignore next 2 -- In Babel? */\n case 'MemberExpression':\n\n // @ts-expect-error Babel?\n case 'OptionalMemberExpression':\n return hasNonEmptyResolverCall(node.object, resolverName) ||\n hasNonEmptyResolverCall(node.property, resolverName);\n case 'ObjectExpression':\n case 'ObjectPattern':\n return node.properties.some((property) => {\n return hasNonEmptyResolverCall(property, resolverName);\n });\n /* c8 ignore next 2 -- In Babel? */\n // @ts-expect-error Babel?\n case 'ObjectMethod':\n /* c8 ignore next 6 -- In Babel? */\n // @ts-expect-error\n return node.computed && hasNonEmptyResolverCall(node.key, resolverName) ||\n // @ts-expect-error\n node.arguments.some((nde) => {\n return hasNonEmptyResolverCall(nde, resolverName);\n });\n\n case 'ReturnStatement': {\n if (node.argument === null) {\n return false;\n }\n\n return hasNonEmptyResolverCall(node.argument, resolverName);\n }\n\n // Comma\n case 'SequenceExpression':\n\n case 'TemplateLiteral':\n return node.expressions.some((subExpression) => {\n return hasNonEmptyResolverCall(subExpression, resolverName);\n });\n\n case 'SwitchStatement': {\n return node.cases.some(\n (someCase) => {\n return someCase.consequent.some((nde) => {\n return hasNonEmptyResolverCall(nde, resolverName);\n });\n },\n );\n }\n\n case 'TaggedTemplateExpression':\n return hasNonEmptyResolverCall(node.quasi, resolverName);\n\n case 'TryStatement': {\n return hasNonEmptyResolverCall(node.block, resolverName) ||\n hasNonEmptyResolverCall(node.handler && node.handler.body, resolverName) ||\n hasNonEmptyResolverCall(node.finalizer, resolverName);\n }\n\n case 'VariableDeclaration': {\n return node.declarations.some((nde) => {\n return hasNonEmptyResolverCall(nde, resolverName);\n });\n }\n\n case 'VariableDeclarator': {\n return hasNonEmptyResolverCall(node.id, resolverName) ||\n hasNonEmptyResolverCall(node.init, resolverName);\n }\n\n /*\n // Shouldn't need to parse literals/literal components, etc.\n\n case 'Identifier':\n case 'TemplateElement':\n case 'Super':\n // Exports not relevant in this context\n */\n default:\n return false;\n }\n};\n\n/**\n * Checks if a Promise executor has no resolve value or an empty value.\n * An `undefined` resolve does not count.\n * @param {ESTreeOrTypeScriptNode} node\n * @param {boolean} anyPromiseAsReturn\n * @param {boolean} [allBranches]\n * @returns {boolean}\n */\nconst hasValueOrExecutorHasNonEmptyResolveValue = (node, anyPromiseAsReturn, allBranches) => {\n const hasReturnMethod = allBranches ?\n /**\n * @param {ESTreeOrTypeScriptNode} nde\n * @param {PromiseFilter} promiseFilter\n * @returns {boolean}\n */\n (nde, promiseFilter) => {\n let hasReturn;\n try {\n hasReturn = hasReturnValue(nde, true, promiseFilter);\n } catch (error) {\n // c8 ignore else\n if (/** @type {Error} */ (error).message === 'Null return') {\n return false;\n }\n /* c8 ignore next 3 */\n // eslint-disable-next-line @stylistic/padding-line-between-statements -- c8\n throw error;\n }\n\n // `hasReturn` check needed since `throw` treated as valid return by\n // `allBrancheshaveReturnValues`\n return Boolean(hasReturn && allBrancheshaveReturnValues(nde, promiseFilter));\n } :\n /**\n * @param {ESTreeOrTypeScriptNode} nde\n * @param {PromiseFilter} promiseFilter\n * @returns {boolean}\n */\n (nde, promiseFilter) => {\n return Boolean(hasReturnValue(nde, false, promiseFilter));\n };\n\n return hasReturnMethod(node, (prom) => {\n if (anyPromiseAsReturn) {\n return true;\n }\n\n if (isVoidPromise(prom)) {\n return false;\n }\n\n const {\n body,\n params,\n } =\n /**\n * @type {import('@typescript-eslint/types').TSESTree.FunctionExpression|\n * import('@typescript-eslint/types').TSESTree.ArrowFunctionExpression}\n */ (\n /** @type {import('@typescript-eslint/types').TSESTree.NewExpression} */ (\n prom\n ).arguments[0]\n ) || {};\n\n if (!params?.length) {\n return false;\n }\n\n const {\n name: resolverName,\n } = /** @type {import('@typescript-eslint/types').TSESTree.Identifier} */ (\n params[0]\n );\n\n return hasNonEmptyResolverCall(body, resolverName);\n });\n};\n\nexport {\n hasReturnValue,\n hasValueOrExecutorHasNonEmptyResolveValue,\n};\n"],"mappings":"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"}
|