eslint-plugin-jsdoc 52.0.1 → 52.0.3

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.
Files changed (357) hide show
  1. package/dist/WarnSettings.cjs +18 -35
  2. package/dist/WarnSettings.cjs.map +1 -1
  3. package/dist/WarnSettings.js +20 -0
  4. package/dist/WarnSettings.js.map +1 -0
  5. package/dist/_virtual/rolldown_runtime.cjs +32 -0
  6. package/dist/_virtual/rolldown_runtime.js +11 -0
  7. package/dist/alignTransform.cjs +224 -305
  8. package/dist/alignTransform.cjs.map +1 -1
  9. package/dist/alignTransform.js +241 -0
  10. package/dist/alignTransform.js.map +1 -0
  11. package/dist/defaultTagOrder.cjs +132 -43
  12. package/dist/defaultTagOrder.cjs.map +1 -1
  13. package/dist/defaultTagOrder.js +134 -0
  14. package/dist/defaultTagOrder.js.map +1 -0
  15. package/dist/exportParser.cjs +478 -696
  16. package/dist/exportParser.cjs.map +1 -1
  17. package/dist/exportParser.js +518 -0
  18. package/dist/exportParser.js.map +1 -0
  19. package/dist/getDefaultTagStructureForMode.cjs +184 -288
  20. package/dist/getDefaultTagStructureForMode.cjs.map +1 -1
  21. package/dist/getDefaultTagStructureForMode.js +188 -0
  22. package/dist/getDefaultTagStructureForMode.js.map +1 -0
  23. package/dist/getJsdocProcessorPlugin.cjs +365 -532
  24. package/dist/getJsdocProcessorPlugin.cjs.map +1 -1
  25. package/dist/getJsdocProcessorPlugin.d.cts +70 -0
  26. package/dist/getJsdocProcessorPlugin.d.cts.map +1 -0
  27. package/dist/getJsdocProcessorPlugin.d.ts +68 -90
  28. package/dist/getJsdocProcessorPlugin.d.ts.map +1 -1
  29. package/dist/getJsdocProcessorPlugin.js +383 -0
  30. package/dist/getJsdocProcessorPlugin.js.map +1 -0
  31. package/dist/index.cjs +398 -383
  32. package/dist/index.cjs.map +1 -1
  33. package/dist/index.d.cts +22 -0
  34. package/dist/index.d.cts.map +1 -0
  35. package/dist/index.d.ts +11 -6
  36. package/dist/index.d.ts.map +1 -1
  37. package/dist/index.js +425 -0
  38. package/dist/index.js.map +1 -0
  39. package/dist/iterateJsdoc.cjs +1528 -1988
  40. package/dist/iterateJsdoc.cjs.map +1 -1
  41. package/dist/iterateJsdoc.d.cts +471 -0
  42. package/dist/iterateJsdoc.d.cts.map +1 -0
  43. package/dist/iterateJsdoc.d.ts +358 -349
  44. package/dist/iterateJsdoc.d.ts.map +1 -1
  45. package/dist/iterateJsdoc.js +1617 -0
  46. package/dist/iterateJsdoc.js.map +1 -0
  47. package/dist/jsdocUtils.cjs +1009 -1376
  48. package/dist/jsdocUtils.cjs.map +1 -1
  49. package/dist/jsdocUtils.js +1123 -0
  50. package/dist/jsdocUtils.js.map +1 -0
  51. package/dist/rules/checkAccess.cjs +29 -36
  52. package/dist/rules/checkAccess.cjs.map +1 -1
  53. package/dist/rules/checkAccess.js +33 -0
  54. package/dist/rules/checkAccess.js.map +1 -0
  55. package/dist/rules/checkAlignment.cjs +41 -54
  56. package/dist/rules/checkAlignment.cjs.map +1 -1
  57. package/dist/rules/checkAlignment.js +47 -0
  58. package/dist/rules/checkAlignment.js.map +1 -0
  59. package/dist/rules/checkExamples.cjs +327 -484
  60. package/dist/rules/checkExamples.cjs.map +1 -1
  61. package/dist/rules/checkExamples.js +348 -0
  62. package/dist/rules/checkExamples.js.map +1 -0
  63. package/dist/rules/checkIndentation.cjs +50 -65
  64. package/dist/rules/checkIndentation.cjs.map +1 -1
  65. package/dist/rules/checkIndentation.js +59 -0
  66. package/dist/rules/checkIndentation.js.map +1 -0
  67. package/dist/rules/checkLineAlignment.cjs +220 -311
  68. package/dist/rules/checkLineAlignment.cjs.map +1 -1
  69. package/dist/rules/checkLineAlignment.js +229 -0
  70. package/dist/rules/checkLineAlignment.js.map +1 -0
  71. package/dist/rules/checkParamNames.cjs +227 -335
  72. package/dist/rules/checkParamNames.cjs.map +1 -1
  73. package/dist/rules/checkParamNames.js +237 -0
  74. package/dist/rules/checkParamNames.js.map +1 -0
  75. package/dist/rules/checkPropertyNames.cjs +78 -106
  76. package/dist/rules/checkPropertyNames.cjs.map +1 -1
  77. package/dist/rules/checkPropertyNames.js +88 -0
  78. package/dist/rules/checkPropertyNames.js.map +1 -0
  79. package/dist/rules/checkSyntax.cjs +21 -34
  80. package/dist/rules/checkSyntax.cjs.map +1 -1
  81. package/dist/rules/checkSyntax.js +25 -0
  82. package/dist/rules/checkSyntax.js.map +1 -0
  83. package/dist/rules/checkTagNames.cjs +188 -210
  84. package/dist/rules/checkTagNames.cjs.map +1 -1
  85. package/dist/rules/checkTagNames.js +191 -0
  86. package/dist/rules/checkTagNames.js.map +1 -0
  87. package/dist/rules/checkTemplateNames.cjs +121 -178
  88. package/dist/rules/checkTemplateNames.cjs.map +1 -1
  89. package/dist/rules/checkTemplateNames.js +124 -0
  90. package/dist/rules/checkTemplateNames.js.map +1 -0
  91. package/dist/rules/checkTypes.cjs +291 -385
  92. package/dist/rules/checkTypes.cjs.map +1 -1
  93. package/dist/rules/checkTypes.js +299 -0
  94. package/dist/rules/checkTypes.js.map +1 -0
  95. package/dist/rules/checkValues.cjs +100 -146
  96. package/dist/rules/checkValues.cjs.map +1 -1
  97. package/dist/rules/checkValues.js +103 -0
  98. package/dist/rules/checkValues.js.map +1 -0
  99. package/dist/rules/convertToJsdocComments.cjs +228 -306
  100. package/dist/rules/convertToJsdocComments.cjs.map +1 -1
  101. package/dist/rules/convertToJsdocComments.js +231 -0
  102. package/dist/rules/convertToJsdocComments.js.map +1 -0
  103. package/dist/rules/emptyTags.cjs +62 -72
  104. package/dist/rules/emptyTags.cjs.map +1 -1
  105. package/dist/rules/emptyTags.js +67 -0
  106. package/dist/rules/emptyTags.js.map +1 -0
  107. package/dist/rules/implementsOnClasses.cjs +36 -56
  108. package/dist/rules/implementsOnClasses.cjs.map +1 -1
  109. package/dist/rules/implementsOnClasses.js +40 -0
  110. package/dist/rules/implementsOnClasses.js.map +1 -0
  111. package/dist/rules/importsAsDependencies.cjs +62 -99
  112. package/dist/rules/importsAsDependencies.cjs.map +1 -1
  113. package/dist/rules/importsAsDependencies.js +68 -0
  114. package/dist/rules/importsAsDependencies.js.map +1 -0
  115. package/dist/rules/informativeDocs.cjs +105 -142
  116. package/dist/rules/informativeDocs.cjs.map +1 -1
  117. package/dist/rules/informativeDocs.js +110 -0
  118. package/dist/rules/informativeDocs.js.map +1 -0
  119. package/dist/rules/linesBeforeBlock.cjs +70 -105
  120. package/dist/rules/linesBeforeBlock.cjs.map +1 -1
  121. package/dist/rules/linesBeforeBlock.js +75 -0
  122. package/dist/rules/linesBeforeBlock.js.map +1 -0
  123. package/dist/rules/matchDescription.cjs +160 -222
  124. package/dist/rules/matchDescription.cjs.map +1 -1
  125. package/dist/rules/matchDescription.js +167 -0
  126. package/dist/rules/matchDescription.js.map +1 -0
  127. package/dist/rules/matchName.cjs +73 -128
  128. package/dist/rules/matchName.cjs.map +1 -1
  129. package/dist/rules/matchName.js +77 -0
  130. package/dist/rules/matchName.js.map +1 -0
  131. package/dist/rules/multilineBlocks.cjs +235 -352
  132. package/dist/rules/multilineBlocks.cjs.map +1 -1
  133. package/dist/rules/multilineBlocks.js +245 -0
  134. package/dist/rules/multilineBlocks.js.map +1 -0
  135. package/dist/rules/noBadBlocks.cjs +63 -86
  136. package/dist/rules/noBadBlocks.cjs.map +1 -1
  137. package/dist/rules/noBadBlocks.js +68 -0
  138. package/dist/rules/noBadBlocks.js.map +1 -0
  139. package/dist/rules/noBlankBlockDescriptions.cjs +35 -57
  140. package/dist/rules/noBlankBlockDescriptions.cjs.map +1 -1
  141. package/dist/rules/noBlankBlockDescriptions.js +41 -0
  142. package/dist/rules/noBlankBlockDescriptions.js.map +1 -0
  143. package/dist/rules/noBlankBlocks.cjs +26 -48
  144. package/dist/rules/noBlankBlocks.cjs.map +1 -1
  145. package/dist/rules/noBlankBlocks.js +30 -0
  146. package/dist/rules/noBlankBlocks.js.map +1 -0
  147. package/dist/rules/noDefaults.cjs +52 -79
  148. package/dist/rules/noDefaults.cjs.map +1 -1
  149. package/dist/rules/noDefaults.js +56 -0
  150. package/dist/rules/noDefaults.js.map +1 -0
  151. package/dist/rules/noMissingSyntax.cjs +115 -165
  152. package/dist/rules/noMissingSyntax.cjs.map +1 -1
  153. package/dist/rules/noMissingSyntax.js +126 -0
  154. package/dist/rules/noMissingSyntax.js.map +1 -0
  155. package/dist/rules/noMultiAsterisks.cjs +48 -89
  156. package/dist/rules/noMultiAsterisks.cjs.map +1 -1
  157. package/dist/rules/noMultiAsterisks.js +58 -0
  158. package/dist/rules/noMultiAsterisks.js.map +1 -0
  159. package/dist/rules/noRestrictedSyntax.cjs +45 -79
  160. package/dist/rules/noRestrictedSyntax.cjs.map +1 -1
  161. package/dist/rules/noRestrictedSyntax.js +49 -0
  162. package/dist/rules/noRestrictedSyntax.js.map +1 -0
  163. package/dist/rules/noTypes.cjs +59 -80
  164. package/dist/rules/noTypes.cjs.map +1 -1
  165. package/dist/rules/noTypes.js +65 -0
  166. package/dist/rules/noTypes.js.map +1 -0
  167. package/dist/rules/noUndefinedTypes.cjs +297 -388
  168. package/dist/rules/noUndefinedTypes.cjs.map +1 -1
  169. package/dist/rules/noUndefinedTypes.js +303 -0
  170. package/dist/rules/noUndefinedTypes.js.map +1 -0
  171. package/dist/rules/requireAsteriskPrefix.cjs +108 -159
  172. package/dist/rules/requireAsteriskPrefix.cjs.map +1 -1
  173. package/dist/rules/requireAsteriskPrefix.js +112 -0
  174. package/dist/rules/requireAsteriskPrefix.js.map +1 -0
  175. package/dist/rules/requireDescription.cjs +89 -129
  176. package/dist/rules/requireDescription.cjs.map +1 -1
  177. package/dist/rules/requireDescription.js +95 -0
  178. package/dist/rules/requireDescription.js.map +1 -0
  179. package/dist/rules/requireDescriptionCompleteSentence.cjs +201 -262
  180. package/dist/rules/requireDescriptionCompleteSentence.cjs.map +1 -1
  181. package/dist/rules/requireDescriptionCompleteSentence.js +220 -0
  182. package/dist/rules/requireDescriptionCompleteSentence.js.map +1 -0
  183. package/dist/rules/requireExample.cjs +73 -104
  184. package/dist/rules/requireExample.cjs.map +1 -1
  185. package/dist/rules/requireExample.js +77 -0
  186. package/dist/rules/requireExample.js.map +1 -0
  187. package/dist/rules/requireFileOverview.cjs +75 -129
  188. package/dist/rules/requireFileOverview.cjs.map +1 -1
  189. package/dist/rules/requireFileOverview.js +81 -0
  190. package/dist/rules/requireFileOverview.js.map +1 -0
  191. package/dist/rules/requireHyphenBeforeParamDescription.cjs +85 -133
  192. package/dist/rules/requireHyphenBeforeParamDescription.cjs.map +1 -1
  193. package/dist/rules/requireHyphenBeforeParamDescription.js +89 -0
  194. package/dist/rules/requireHyphenBeforeParamDescription.js.map +1 -0
  195. package/dist/rules/requireJsdoc.cjs +384 -557
  196. package/dist/rules/requireJsdoc.cjs.map +1 -1
  197. package/dist/rules/requireJsdoc.js +404 -0
  198. package/dist/rules/requireJsdoc.js.map +1 -0
  199. package/dist/rules/requireParam.cjs +336 -526
  200. package/dist/rules/requireParam.cjs.map +1 -1
  201. package/dist/rules/requireParam.js +344 -0
  202. package/dist/rules/requireParam.js.map +1 -0
  203. package/dist/rules/requireParamDescription.cjs +55 -80
  204. package/dist/rules/requireParamDescription.cjs.map +1 -1
  205. package/dist/rules/requireParamDescription.js +59 -0
  206. package/dist/rules/requireParamDescription.js.map +1 -0
  207. package/dist/rules/requireParamName.cjs +32 -50
  208. package/dist/rules/requireParamName.cjs.map +1 -1
  209. package/dist/rules/requireParamName.js +36 -0
  210. package/dist/rules/requireParamName.js.map +1 -0
  211. package/dist/rules/requireParamType.cjs +55 -80
  212. package/dist/rules/requireParamType.cjs.map +1 -1
  213. package/dist/rules/requireParamType.js +59 -0
  214. package/dist/rules/requireParamType.js.map +1 -0
  215. package/dist/rules/requireProperty.cjs +31 -42
  216. package/dist/rules/requireProperty.cjs.map +1 -1
  217. package/dist/rules/requireProperty.js +35 -0
  218. package/dist/rules/requireProperty.js.map +1 -0
  219. package/dist/rules/requirePropertyDescription.cjs +17 -25
  220. package/dist/rules/requirePropertyDescription.cjs.map +1 -1
  221. package/dist/rules/requirePropertyDescription.js +21 -0
  222. package/dist/rules/requirePropertyDescription.js.map +1 -0
  223. package/dist/rules/requirePropertyName.cjs +17 -25
  224. package/dist/rules/requirePropertyName.cjs.map +1 -1
  225. package/dist/rules/requirePropertyName.js +21 -0
  226. package/dist/rules/requirePropertyName.js.map +1 -0
  227. package/dist/rules/requirePropertyType.cjs +17 -25
  228. package/dist/rules/requirePropertyType.cjs.map +1 -1
  229. package/dist/rules/requirePropertyType.js +21 -0
  230. package/dist/rules/requirePropertyType.js.map +1 -0
  231. package/dist/rules/requireReturns.cjs +125 -203
  232. package/dist/rules/requireReturns.cjs.map +1 -1
  233. package/dist/rules/requireReturns.js +131 -0
  234. package/dist/rules/requireReturns.js.map +1 -0
  235. package/dist/rules/requireReturnsCheck.cjs +60 -103
  236. package/dist/rules/requireReturnsCheck.cjs.map +1 -1
  237. package/dist/rules/requireReturnsCheck.js +66 -0
  238. package/dist/rules/requireReturnsCheck.js.map +1 -0
  239. package/dist/rules/requireReturnsDescription.cjs +39 -54
  240. package/dist/rules/requireReturnsDescription.cjs.map +1 -1
  241. package/dist/rules/requireReturnsDescription.js +43 -0
  242. package/dist/rules/requireReturnsDescription.js.map +1 -0
  243. package/dist/rules/requireReturnsType.cjs +32 -50
  244. package/dist/rules/requireReturnsType.cjs.map +1 -1
  245. package/dist/rules/requireReturnsType.js +36 -0
  246. package/dist/rules/requireReturnsType.js.map +1 -0
  247. package/dist/rules/requireTemplate.cjs +119 -178
  248. package/dist/rules/requireTemplate.cjs.map +1 -1
  249. package/dist/rules/requireTemplate.js +122 -0
  250. package/dist/rules/requireTemplate.js.map +1 -0
  251. package/dist/rules/requireThrows.cjs +61 -95
  252. package/dist/rules/requireThrows.cjs.map +1 -1
  253. package/dist/rules/requireThrows.js +67 -0
  254. package/dist/rules/requireThrows.js.map +1 -0
  255. package/dist/rules/requireYields.cjs +106 -166
  256. package/dist/rules/requireYields.cjs.map +1 -1
  257. package/dist/rules/requireYields.js +115 -0
  258. package/dist/rules/requireYields.js.map +1 -0
  259. package/dist/rules/requireYieldsCheck.cjs +96 -152
  260. package/dist/rules/requireYieldsCheck.cjs.map +1 -1
  261. package/dist/rules/requireYieldsCheck.js +105 -0
  262. package/dist/rules/requireYieldsCheck.js.map +1 -0
  263. package/dist/rules/sortTags.cjs +258 -444
  264. package/dist/rules/sortTags.cjs.map +1 -1
  265. package/dist/rules/sortTags.js +262 -0
  266. package/dist/rules/sortTags.js.map +1 -0
  267. package/dist/rules/tagLines.cjs +179 -266
  268. package/dist/rules/tagLines.cjs.map +1 -1
  269. package/dist/rules/tagLines.js +183 -0
  270. package/dist/rules/tagLines.js.map +1 -0
  271. package/dist/rules/textEscaping.cjs +92 -127
  272. package/dist/rules/textEscaping.cjs.map +1 -1
  273. package/dist/rules/textEscaping.js +102 -0
  274. package/dist/rules/textEscaping.js.map +1 -0
  275. package/dist/rules/validTypes.cjs +252 -265
  276. package/dist/rules/validTypes.cjs.map +1 -1
  277. package/dist/rules/validTypes.js +259 -0
  278. package/dist/rules/validTypes.js.map +1 -0
  279. package/dist/tagNames.cjs +134 -170
  280. package/dist/tagNames.cjs.map +1 -1
  281. package/dist/tagNames.js +144 -0
  282. package/dist/tagNames.js.map +1 -0
  283. package/dist/utils/hasReturnValue.cjs +246 -474
  284. package/dist/utils/hasReturnValue.cjs.map +1 -1
  285. package/dist/utils/hasReturnValue.js +265 -0
  286. package/dist/utils/hasReturnValue.js.map +1 -0
  287. package/package.json +48 -38
  288. package/dist/generateRule.cjs +0 -242
  289. package/dist/generateRule.cjs.map +0 -1
  290. package/src/WarnSettings.js +0 -34
  291. package/src/alignTransform.js +0 -358
  292. package/src/defaultTagOrder.js +0 -169
  293. package/src/exportParser.js +0 -978
  294. package/src/getDefaultTagStructureForMode.js +0 -969
  295. package/src/getJsdocProcessorPlugin.js +0 -652
  296. package/src/index.js +0 -530
  297. package/src/iterateJsdoc.js +0 -2518
  298. package/src/jsdocUtils.js +0 -1896
  299. package/src/rules/checkAccess.js +0 -45
  300. package/src/rules/checkAlignment.js +0 -63
  301. package/src/rules/checkExamples.js +0 -589
  302. package/src/rules/checkIndentation.js +0 -75
  303. package/src/rules/checkLineAlignment.js +0 -372
  304. package/src/rules/checkParamNames.js +0 -474
  305. package/src/rules/checkPropertyNames.js +0 -152
  306. package/src/rules/checkSyntax.js +0 -30
  307. package/src/rules/checkTagNames.js +0 -314
  308. package/src/rules/checkTemplateNames.js +0 -204
  309. package/src/rules/checkTypes.js +0 -535
  310. package/src/rules/checkValues.js +0 -248
  311. package/src/rules/convertToJsdocComments.js +0 -398
  312. package/src/rules/emptyTags.js +0 -98
  313. package/src/rules/implementsOnClasses.js +0 -64
  314. package/src/rules/importsAsDependencies.js +0 -133
  315. package/src/rules/informativeDocs.js +0 -189
  316. package/src/rules/linesBeforeBlock.js +0 -134
  317. package/src/rules/matchDescription.js +0 -286
  318. package/src/rules/matchName.js +0 -151
  319. package/src/rules/multilineBlocks.js +0 -493
  320. package/src/rules/noBadBlocks.js +0 -119
  321. package/src/rules/noBlankBlockDescriptions.js +0 -69
  322. package/src/rules/noBlankBlocks.js +0 -53
  323. package/src/rules/noDefaults.js +0 -85
  324. package/src/rules/noMissingSyntax.js +0 -195
  325. package/src/rules/noMultiAsterisks.js +0 -134
  326. package/src/rules/noRestrictedSyntax.js +0 -91
  327. package/src/rules/noTypes.js +0 -93
  328. package/src/rules/noUndefinedTypes.js +0 -543
  329. package/src/rules/requireAsteriskPrefix.js +0 -190
  330. package/src/rules/requireDescription.js +0 -161
  331. package/src/rules/requireDescriptionCompleteSentence.js +0 -335
  332. package/src/rules/requireExample.js +0 -118
  333. package/src/rules/requireFileOverview.js +0 -154
  334. package/src/rules/requireHyphenBeforeParamDescription.js +0 -176
  335. package/src/rules/requireJsdoc.js +0 -743
  336. package/src/rules/requireParam.js +0 -602
  337. package/src/rules/requireParamDescription.js +0 -89
  338. package/src/rules/requireParamName.js +0 -55
  339. package/src/rules/requireParamType.js +0 -89
  340. package/src/rules/requireProperty.js +0 -48
  341. package/src/rules/requirePropertyDescription.js +0 -25
  342. package/src/rules/requirePropertyName.js +0 -25
  343. package/src/rules/requirePropertyType.js +0 -25
  344. package/src/rules/requireReturns.js +0 -238
  345. package/src/rules/requireReturnsCheck.js +0 -145
  346. package/src/rules/requireReturnsDescription.js +0 -59
  347. package/src/rules/requireReturnsType.js +0 -51
  348. package/src/rules/requireTemplate.js +0 -201
  349. package/src/rules/requireThrows.js +0 -111
  350. package/src/rules/requireYields.js +0 -216
  351. package/src/rules/requireYieldsCheck.js +0 -208
  352. package/src/rules/sortTags.js +0 -558
  353. package/src/rules/tagLines.js +0 -359
  354. package/src/rules/textEscaping.js +0 -154
  355. package/src/rules/validTypes.js +0 -401
  356. package/src/tagNames.js +0 -238
  357. package/src/utils/hasReturnValue.js +0 -572
@@ -1,495 +1,267 @@
1
- "use strict";
2
1
 
3
- Object.defineProperty(exports, "__esModule", {
4
- value: true
5
- });
6
- exports.hasValueOrExecutorHasNonEmptyResolveValue = exports.hasReturnValue = void 0;
2
+ //#region src/utils/hasReturnValue.js
7
3
  /**
8
- * @typedef {import('estree').Node|
9
- * import('@typescript-eslint/types').TSESTree.Node} ESTreeOrTypeScriptNode
10
- */
11
-
4
+ * @typedef {import('estree').Node|
5
+ * import('@typescript-eslint/types').TSESTree.Node} ESTreeOrTypeScriptNode
6
+ */
12
7
  /**
13
- * Checks if a node is a promise but has no resolve value or an empty value.
14
- * An `undefined` resolve does not count.
15
- * @param {ESTreeOrTypeScriptNode|undefined|null} node
16
- * @returns {boolean|undefined|null}
17
- */
18
- const isNewPromiseExpression = node => {
19
- return node && node.type === 'NewExpression' && node.callee.type === 'Identifier' && node.callee.name === 'Promise';
8
+ * Checks if a node is a promise but has no resolve value or an empty value.
9
+ * An `undefined` resolve does not count.
10
+ * @param {ESTreeOrTypeScriptNode|undefined|null} node
11
+ * @returns {boolean|undefined|null}
12
+ */
13
+ const isNewPromiseExpression = (node) => {
14
+ return node && node.type === "NewExpression" && node.callee.type === "Identifier" && node.callee.name === "Promise";
20
15
  };
21
-
22
16
  /**
23
- * @param {ESTreeOrTypeScriptNode|null|undefined} node
24
- * @returns {boolean}
25
- */
26
- const isVoidPromise = node => {
27
- return /** @type {import('@typescript-eslint/types').TSESTree.TSTypeReference} */node?.typeArguments?.params?.[0]?.type === 'TSVoidKeyword'
28
- /* c8 ignore next 5 */
29
- // eslint-disable-next-line @stylistic/operator-linebreak -- c8
30
- || /** @type {import('@typescript-eslint/types').TSESTree.TSTypeReference} */node
31
- // @ts-expect-error Ok
32
- ?.typeParameters?.params?.[0]?.type === 'TSVoidKeyword';
17
+ * @param {ESTreeOrTypeScriptNode|null|undefined} node
18
+ * @returns {boolean}
19
+ */
20
+ const isVoidPromise = (node) => {
21
+ return node?.typeArguments?.params?.[0]?.type === "TSVoidKeyword" || node?.typeParameters?.params?.[0]?.type === "TSVoidKeyword";
33
22
  };
34
- const undefinedKeywords = new Set(['TSNeverKeyword', 'TSUndefinedKeyword', 'TSVoidKeyword']);
35
-
23
+ const undefinedKeywords = new Set([
24
+ "TSNeverKeyword",
25
+ "TSUndefinedKeyword",
26
+ "TSVoidKeyword"
27
+ ]);
36
28
  /**
37
- * Checks if a node has a return statement. Void return does not count.
38
- * @param {ESTreeOrTypeScriptNode|undefined|null} node
39
- * @param {boolean} [throwOnNullReturn]
40
- * @param {PromiseFilter} [promFilter]
41
- * @returns {boolean|undefined}
42
- */
43
- // eslint-disable-next-line complexity
29
+ * Checks if a node has a return statement. Void return does not count.
30
+ * @param {ESTreeOrTypeScriptNode|undefined|null} node
31
+ * @param {boolean} [throwOnNullReturn]
32
+ * @param {PromiseFilter} [promFilter]
33
+ * @returns {boolean|undefined}
34
+ */
44
35
  const hasReturnValue = (node, throwOnNullReturn, promFilter) => {
45
- if (!node) {
46
- return false;
47
- }
48
- switch (node.type) {
49
- case 'ArrowFunctionExpression':
50
- case 'FunctionDeclaration':
51
- case 'FunctionExpression':
52
- {
53
- return 'expression' in node && node.expression && (!isNewPromiseExpression(node.body) || !isVoidPromise(node.body)) || hasReturnValue(node.body, throwOnNullReturn, promFilter);
54
- }
55
- case 'BlockStatement':
56
- {
57
- return node.body.some(bodyNode => {
58
- return bodyNode.type !== 'FunctionDeclaration' && hasReturnValue(bodyNode, throwOnNullReturn, promFilter);
59
- });
60
- }
61
- case 'DoWhileStatement':
62
- case 'ForInStatement':
63
- case 'ForOfStatement':
64
- case 'ForStatement':
65
- case 'LabeledStatement':
66
- case 'WhileStatement':
67
- case 'WithStatement':
68
- {
69
- return hasReturnValue(node.body, throwOnNullReturn, promFilter);
70
- }
71
- case 'IfStatement':
72
- {
73
- return hasReturnValue(node.consequent, throwOnNullReturn, promFilter) || hasReturnValue(node.alternate, throwOnNullReturn, promFilter);
74
- }
75
- case 'MethodDefinition':
76
- return hasReturnValue(node.value, throwOnNullReturn, promFilter);
77
- case 'ReturnStatement':
78
- {
79
- // void return does not count.
80
- if (node.argument === null) {
81
- if (throwOnNullReturn) {
82
- throw new Error('Null return');
83
- }
84
- return false;
85
- }
86
- if (promFilter && isNewPromiseExpression(node.argument)) {
87
- // Let caller decide how to filter, but this is, at the least,
88
- // a return of sorts and truthy
89
- return promFilter(node.argument);
90
- }
91
- return true;
92
- }
93
- case 'SwitchStatement':
94
- {
95
- return node.cases.some(someCase => {
96
- return someCase.consequent.some(nde => {
97
- return hasReturnValue(nde, throwOnNullReturn, promFilter);
98
- });
99
- });
100
- }
101
- case 'TryStatement':
102
- {
103
- return hasReturnValue(node.block, throwOnNullReturn, promFilter) || hasReturnValue(node.handler && node.handler.body, throwOnNullReturn, promFilter) || hasReturnValue(node.finalizer, throwOnNullReturn, promFilter);
104
- }
105
- case 'TSDeclareFunction':
106
- case 'TSFunctionType':
107
- case 'TSMethodSignature':
108
- {
109
- const type = node?.returnType?.typeAnnotation?.type;
110
- return type && !undefinedKeywords.has(type);
111
- }
112
- default:
113
- {
114
- return false;
115
- }
116
- }
36
+ if (!node) return false;
37
+ switch (node.type) {
38
+ case "ArrowFunctionExpression":
39
+ case "FunctionDeclaration":
40
+ case "FunctionExpression": return "expression" in node && node.expression && (!isNewPromiseExpression(node.body) || !isVoidPromise(node.body)) || hasReturnValue(node.body, throwOnNullReturn, promFilter);
41
+ case "BlockStatement": return node.body.some((bodyNode) => {
42
+ return bodyNode.type !== "FunctionDeclaration" && hasReturnValue(bodyNode, throwOnNullReturn, promFilter);
43
+ });
44
+ case "DoWhileStatement":
45
+ case "ForInStatement":
46
+ case "ForOfStatement":
47
+ case "ForStatement":
48
+ case "LabeledStatement":
49
+ case "WhileStatement":
50
+ case "WithStatement": return hasReturnValue(node.body, throwOnNullReturn, promFilter);
51
+ case "IfStatement": return hasReturnValue(node.consequent, throwOnNullReturn, promFilter) || hasReturnValue(node.alternate, throwOnNullReturn, promFilter);
52
+ case "MethodDefinition": return hasReturnValue(node.value, throwOnNullReturn, promFilter);
53
+ case "ReturnStatement":
54
+ if (node.argument === null) {
55
+ if (throwOnNullReturn) throw new Error("Null return");
56
+ return false;
57
+ }
58
+ if (promFilter && isNewPromiseExpression(node.argument)) return promFilter(node.argument);
59
+ return true;
60
+ case "SwitchStatement": return node.cases.some((someCase) => {
61
+ return someCase.consequent.some((nde) => {
62
+ return hasReturnValue(nde, throwOnNullReturn, promFilter);
63
+ });
64
+ });
65
+ case "TryStatement": return hasReturnValue(node.block, throwOnNullReturn, promFilter) || hasReturnValue(node.handler && node.handler.body, throwOnNullReturn, promFilter) || hasReturnValue(node.finalizer, throwOnNullReturn, promFilter);
66
+ case "TSDeclareFunction":
67
+ case "TSFunctionType":
68
+ case "TSMethodSignature": {
69
+ const type = node?.returnType?.typeAnnotation?.type;
70
+ return type && !undefinedKeywords.has(type);
71
+ }
72
+ default: return false;
73
+ }
117
74
  };
118
-
119
75
  /**
120
- * Checks if a node has a return statement. Void return does not count.
121
- * @param {ESTreeOrTypeScriptNode|null|undefined} node
122
- * @param {PromiseFilter} promFilter
123
- * @returns {undefined|boolean|ESTreeOrTypeScriptNode}
124
- */
125
- // eslint-disable-next-line complexity
126
- exports.hasReturnValue = hasReturnValue;
76
+ * Checks if a node has a return statement. Void return does not count.
77
+ * @param {ESTreeOrTypeScriptNode|null|undefined} node
78
+ * @param {PromiseFilter} promFilter
79
+ * @returns {undefined|boolean|ESTreeOrTypeScriptNode}
80
+ */
127
81
  const allBrancheshaveReturnValues = (node, promFilter) => {
128
- if (!node) {
129
- return false;
130
- }
131
- switch (node.type) {
132
- // case 'MethodDefinition':
133
- // return allBrancheshaveReturnValues(node.value, promFilter);
134
- case 'ArrowFunctionExpression':
135
- case 'FunctionDeclaration':
136
- case 'FunctionExpression':
137
- {
138
- return 'expression' in node && node.expression && (!isNewPromiseExpression(node.body) || !isVoidPromise(node.body)) || allBrancheshaveReturnValues(node.body, promFilter) || /** @type {import('@typescript-eslint/types').TSESTree.BlockStatement} */
139
- node.body.body.some(nde => {
140
- return nde.type === 'ReturnStatement';
141
- });
142
- }
143
- case 'BlockStatement':
144
- {
145
- const lastBodyNode = node.body.slice(-1)[0];
146
- return allBrancheshaveReturnValues(lastBodyNode, promFilter);
147
- }
148
- case 'DoWhileStatement':
149
- case 'WhileStatement':
150
- if (
151
- /**
152
- * @type {import('@typescript-eslint/types').TSESTree.Literal}
153
- */
154
- node.test.value === true) {
155
- // If this is an infinite loop, we assume only one branch
156
- // is needed to provide a return
157
- return hasReturnValue(node.body, false, promFilter);
158
- }
159
-
160
- // Fallthrough
161
- case 'ForStatement':
162
- if (node.test === null) {
163
- // If this is an infinite loop, we assume only one branch
164
- // is needed to provide a return
165
- return hasReturnValue(node.body, false, promFilter);
166
- }
167
- case 'ForInStatement':
168
- case 'ForOfStatement':
169
- case 'LabeledStatement':
170
- case 'WithStatement':
171
- {
172
- return allBrancheshaveReturnValues(node.body, promFilter);
173
- }
174
- case 'IfStatement':
175
- {
176
- return allBrancheshaveReturnValues(node.consequent, promFilter) && allBrancheshaveReturnValues(node.alternate, promFilter);
177
- }
178
- case 'ReturnStatement':
179
- {
180
- // void return does not count.
181
- if (node.argument === null) {
182
- return false;
183
- }
184
- if (promFilter && isNewPromiseExpression(node.argument)) {
185
- // Let caller decide how to filter, but this is, at the least,
186
- // a return of sorts and truthy
187
- return promFilter(node.argument);
188
- }
189
- return true;
190
- }
191
- case 'SwitchStatement':
192
- {
193
- return /** @type {import('@typescript-eslint/types').TSESTree.SwitchStatement} */node.cases.every(someCase => {
194
- return !someCase.consequent.some(consNode => {
195
- return consNode.type === 'BreakStatement' || consNode.type === 'ReturnStatement' && consNode.argument === null;
196
- });
197
- });
198
- }
199
- case 'ThrowStatement':
200
- {
201
- return true;
202
- }
203
- case 'TryStatement':
204
- {
205
- // If `finally` returns, all return
206
- return node.finalizer && allBrancheshaveReturnValues(node.finalizer, promFilter) ||
207
- // Return in `try`/`catch` may still occur despite `finally`
208
- allBrancheshaveReturnValues(node.block, promFilter) && (!node.handler || allBrancheshaveReturnValues(node.handler && node.handler.body, promFilter)) && (!node.finalizer || (() => {
209
- try {
210
- hasReturnValue(node.finalizer, true, promFilter);
211
- } catch (error) {
212
- if (/** @type {Error} */error.message === 'Null return') {
213
- return false;
214
- }
215
- /* c8 ignore next 3 */
216
- // eslint-disable-next-line @stylistic/padding-line-between-statements -- c8
217
- throw error;
218
- }
219
-
220
- // As long as not an explicit empty return, then return true
221
- return true;
222
- })());
223
- }
224
- case 'TSDeclareFunction':
225
- case 'TSFunctionType':
226
- case 'TSMethodSignature':
227
- {
228
- const type = node?.returnType?.typeAnnotation?.type;
229
- return type && !undefinedKeywords.has(type);
230
- }
231
- default:
232
- {
233
- return false;
234
- }
235
- }
82
+ if (!node) return false;
83
+ switch (node.type) {
84
+ case "ArrowFunctionExpression":
85
+ case "FunctionDeclaration":
86
+ case "FunctionExpression": return "expression" in node && node.expression && (!isNewPromiseExpression(node.body) || !isVoidPromise(node.body)) || allBrancheshaveReturnValues(node.body, promFilter) || node.body.body.some((nde) => {
87
+ return nde.type === "ReturnStatement";
88
+ });
89
+ case "BlockStatement": {
90
+ const lastBodyNode = node.body.slice(-1)[0];
91
+ return allBrancheshaveReturnValues(lastBodyNode, promFilter);
92
+ }
93
+ case "DoWhileStatement":
94
+ case "WhileStatement": if (node.test.value === true) return hasReturnValue(node.body, false, promFilter);
95
+ case "ForStatement": if (node.test === null) return hasReturnValue(node.body, false, promFilter);
96
+ case "ForInStatement":
97
+ case "ForOfStatement":
98
+ case "LabeledStatement":
99
+ case "WithStatement": return allBrancheshaveReturnValues(node.body, promFilter);
100
+ case "IfStatement": return allBrancheshaveReturnValues(node.consequent, promFilter) && allBrancheshaveReturnValues(node.alternate, promFilter);
101
+ case "ReturnStatement":
102
+ if (node.argument === null) return false;
103
+ if (promFilter && isNewPromiseExpression(node.argument)) return promFilter(node.argument);
104
+ return true;
105
+ case "SwitchStatement": return node.cases.every((someCase) => {
106
+ return !someCase.consequent.some((consNode) => {
107
+ return consNode.type === "BreakStatement" || consNode.type === "ReturnStatement" && consNode.argument === null;
108
+ });
109
+ });
110
+ case "ThrowStatement": return true;
111
+ case "TryStatement": return node.finalizer && allBrancheshaveReturnValues(node.finalizer, promFilter) || allBrancheshaveReturnValues(node.block, promFilter) && (!node.handler || allBrancheshaveReturnValues(node.handler && node.handler.body, promFilter)) && (!node.finalizer || (() => {
112
+ try {
113
+ hasReturnValue(node.finalizer, true, promFilter);
114
+ } catch (error) {
115
+ if (error.message === "Null return") return false;
116
+ /* c8 ignore next 3 */
117
+ throw error;
118
+ }
119
+ return true;
120
+ })());
121
+ case "TSDeclareFunction":
122
+ case "TSFunctionType":
123
+ case "TSMethodSignature": {
124
+ const type = node?.returnType?.typeAnnotation?.type;
125
+ return type && !undefinedKeywords.has(type);
126
+ }
127
+ default: return false;
128
+ }
236
129
  };
237
-
238
130
  /**
239
- * @callback PromiseFilter
240
- * @param {ESTreeOrTypeScriptNode|undefined} node
241
- * @returns {boolean}
242
- */
243
-
131
+ * @callback PromiseFilter
132
+ * @param {ESTreeOrTypeScriptNode|undefined} node
133
+ * @returns {boolean}
134
+ */
244
135
  /**
245
- * Avoids further checking child nodes if a nested function shadows the
246
- * resolver, but otherwise, if name is used (by call or passed in as an
247
- * argument to another function), will be considered as non-empty.
248
- *
249
- * This could check for redeclaration of the resolver, but as such is
250
- * unlikely, we avoid the performance cost of checking everywhere for
251
- * (re)declarations or assignments.
252
- * @param {import('@typescript-eslint/types').TSESTree.Node|null|undefined} node
253
- * @param {string} resolverName
254
- * @returns {boolean}
255
- */
256
- // eslint-disable-next-line complexity
136
+ * Avoids further checking child nodes if a nested function shadows the
137
+ * resolver, but otherwise, if name is used (by call or passed in as an
138
+ * argument to another function), will be considered as non-empty.
139
+ *
140
+ * This could check for redeclaration of the resolver, but as such is
141
+ * unlikely, we avoid the performance cost of checking everywhere for
142
+ * (re)declarations or assignments.
143
+ * @param {import('@typescript-eslint/types').TSESTree.Node|null|undefined} node
144
+ * @param {string} resolverName
145
+ * @returns {boolean}
146
+ */
257
147
  const hasNonEmptyResolverCall = (node, resolverName) => {
258
- if (!node) {
259
- return false;
260
- }
261
-
262
- // Arrow function without block
263
- switch (node.type) {
264
- case 'ArrayExpression':
265
- case 'ArrayPattern':
266
- return node.elements.some(element => {
267
- return hasNonEmptyResolverCall(element, resolverName);
268
- });
269
- case 'ArrowFunctionExpression':
270
- case 'FunctionDeclaration':
271
- case 'FunctionExpression':
272
- {
273
- // Shadowing
274
- if (/** @type {import('@typescript-eslint/types').TSESTree.Identifier} */node.params[0]?.name === resolverName) {
275
- return false;
276
- }
277
- return hasNonEmptyResolverCall(node.body, resolverName);
278
- }
279
- case 'AssignmentExpression':
280
- case 'BinaryExpression':
281
- case 'LogicalExpression':
282
- {
283
- return hasNonEmptyResolverCall(node.left, resolverName) || hasNonEmptyResolverCall(node.right, resolverName);
284
- }
285
- case 'AssignmentPattern':
286
- return hasNonEmptyResolverCall(node.right, resolverName);
287
- case 'AwaitExpression':
288
- case 'SpreadElement':
289
- case 'UnaryExpression':
290
- case 'YieldExpression':
291
- return hasNonEmptyResolverCall(node.argument, resolverName);
292
- case 'BlockStatement':
293
- case 'ClassBody':
294
- return node.body.some(bodyNode => {
295
- return hasNonEmptyResolverCall(bodyNode, resolverName);
296
- });
297
- /* c8 ignore next 2 -- In Babel? */
298
- case 'CallExpression':
299
- // @ts-expect-error Babel?
300
- case 'OptionalCallExpression':
301
- return /** @type {import('@typescript-eslint/types').TSESTree.Identifier} */node.callee.name === resolverName && (
302
- // Implicit or explicit undefined
303
- node.arguments.length > 1 || node.arguments[0] !== undefined) || node.arguments.some(nde => {
304
- // Being passed in to another function (which might invoke it)
305
- return nde.type === 'Identifier' && nde.name === resolverName ||
306
- // Handle nested items
307
- hasNonEmptyResolverCall(nde, resolverName);
308
- });
309
- case 'ChainExpression':
310
- case 'Decorator':
311
- case 'ExpressionStatement':
312
- return hasNonEmptyResolverCall(node.expression, resolverName);
313
- case 'ClassDeclaration':
314
- case 'ClassExpression':
315
- return hasNonEmptyResolverCall(node.body, resolverName);
316
- /* c8 ignore next 2 -- In Babel? */
317
- // @ts-expect-error Babel?
318
- case 'ClassMethod':
319
- case 'MethodDefinition':
320
- return node.decorators && node.decorators.some(decorator => {
321
- return hasNonEmptyResolverCall(decorator, resolverName);
322
- }) || node.computed && hasNonEmptyResolverCall(node.key, resolverName) || hasNonEmptyResolverCall(node.value, resolverName);
323
-
324
- /* c8 ignore next 2 -- In Babel? */
325
- // @ts-expect-error Babel?
326
- case 'ClassProperty':
327
- /* c8 ignore next 2 -- In Babel? */
328
- // @ts-expect-error Babel?
329
- case 'ObjectProperty':
330
- case 'Property':
331
- case 'PropertyDefinition':
332
- return node.computed && hasNonEmptyResolverCall(node.key, resolverName) || hasNonEmptyResolverCall(node.value, resolverName);
333
- case 'ConditionalExpression':
334
- case 'IfStatement':
335
- {
336
- return hasNonEmptyResolverCall(node.test, resolverName) || hasNonEmptyResolverCall(node.consequent, resolverName) || hasNonEmptyResolverCall(node.alternate, resolverName);
337
- }
338
- case 'DoWhileStatement':
339
- case 'ForInStatement':
340
- case 'ForOfStatement':
341
- case 'ForStatement':
342
- case 'LabeledStatement':
343
- case 'WhileStatement':
344
- case 'WithStatement':
345
- {
346
- return hasNonEmptyResolverCall(node.body, resolverName);
347
- }
348
-
349
- /* c8 ignore next 2 -- In Babel? */
350
- // @ts-expect-error Babel?
351
- case 'Import':
352
- case 'ImportExpression':
353
- return hasNonEmptyResolverCall(node.source, resolverName);
354
- // ?.
355
- /* c8 ignore next 2 -- In Babel? */
356
- case 'MemberExpression':
357
-
358
- // @ts-expect-error Babel?
359
- case 'OptionalMemberExpression':
360
- return hasNonEmptyResolverCall(node.object, resolverName) || hasNonEmptyResolverCall(node.property, resolverName);
361
- case 'ObjectExpression':
362
- case 'ObjectPattern':
363
- return node.properties.some(property => {
364
- return hasNonEmptyResolverCall(property, resolverName);
365
- });
366
- /* c8 ignore next 2 -- In Babel? */
367
- // @ts-expect-error Babel?
368
- case 'ObjectMethod':
369
- /* c8 ignore next 6 -- In Babel? */
370
- // @ts-expect-error
371
- return node.computed && hasNonEmptyResolverCall(node.key, resolverName) ||
372
- // @ts-expect-error
373
- node.arguments.some(nde => {
374
- return hasNonEmptyResolverCall(nde, resolverName);
375
- });
376
- case 'ReturnStatement':
377
- {
378
- if (node.argument === null) {
379
- return false;
380
- }
381
- return hasNonEmptyResolverCall(node.argument, resolverName);
382
- }
383
-
384
- // Comma
385
- case 'SequenceExpression':
386
- case 'TemplateLiteral':
387
- return node.expressions.some(subExpression => {
388
- return hasNonEmptyResolverCall(subExpression, resolverName);
389
- });
390
- case 'SwitchStatement':
391
- {
392
- return node.cases.some(someCase => {
393
- return someCase.consequent.some(nde => {
394
- return hasNonEmptyResolverCall(nde, resolverName);
395
- });
396
- });
397
- }
398
- case 'TaggedTemplateExpression':
399
- return hasNonEmptyResolverCall(node.quasi, resolverName);
400
- case 'TryStatement':
401
- {
402
- return hasNonEmptyResolverCall(node.block, resolverName) || hasNonEmptyResolverCall(node.handler && node.handler.body, resolverName) || hasNonEmptyResolverCall(node.finalizer, resolverName);
403
- }
404
- case 'VariableDeclaration':
405
- {
406
- return node.declarations.some(nde => {
407
- return hasNonEmptyResolverCall(nde, resolverName);
408
- });
409
- }
410
- case 'VariableDeclarator':
411
- {
412
- return hasNonEmptyResolverCall(node.id, resolverName) || hasNonEmptyResolverCall(node.init, resolverName);
413
- }
414
-
415
- /*
416
- // Shouldn't need to parse literals/literal components, etc.
417
- case 'Identifier':
418
- case 'TemplateElement':
419
- case 'Super':
420
- // Exports not relevant in this context
421
- */
422
- default:
423
- return false;
424
- }
148
+ if (!node) return false;
149
+ switch (node.type) {
150
+ case "ArrayExpression":
151
+ case "ArrayPattern": return node.elements.some((element) => {
152
+ return hasNonEmptyResolverCall(element, resolverName);
153
+ });
154
+ case "ArrowFunctionExpression":
155
+ case "FunctionDeclaration":
156
+ case "FunctionExpression":
157
+ if (node.params[0]?.name === resolverName) return false;
158
+ return hasNonEmptyResolverCall(node.body, resolverName);
159
+ case "AssignmentExpression":
160
+ case "BinaryExpression":
161
+ case "LogicalExpression": return hasNonEmptyResolverCall(node.left, resolverName) || hasNonEmptyResolverCall(node.right, resolverName);
162
+ case "AssignmentPattern": return hasNonEmptyResolverCall(node.right, resolverName);
163
+ case "AwaitExpression":
164
+ case "SpreadElement":
165
+ case "UnaryExpression":
166
+ case "YieldExpression": return hasNonEmptyResolverCall(node.argument, resolverName);
167
+ case "BlockStatement":
168
+ case "ClassBody": return node.body.some((bodyNode) => {
169
+ return hasNonEmptyResolverCall(bodyNode, resolverName);
170
+ });
171
+ case "CallExpression":
172
+ case "OptionalCallExpression": return node.callee.name === resolverName && (node.arguments.length > 1 || node.arguments[0] !== void 0) || node.arguments.some((nde) => {
173
+ return nde.type === "Identifier" && nde.name === resolverName || hasNonEmptyResolverCall(nde, resolverName);
174
+ });
175
+ case "ChainExpression":
176
+ case "Decorator":
177
+ case "ExpressionStatement": return hasNonEmptyResolverCall(node.expression, resolverName);
178
+ case "ClassDeclaration":
179
+ case "ClassExpression": return hasNonEmptyResolverCall(node.body, resolverName);
180
+ case "ClassMethod":
181
+ case "MethodDefinition": return node.decorators && node.decorators.some((decorator) => {
182
+ return hasNonEmptyResolverCall(decorator, resolverName);
183
+ }) || node.computed && hasNonEmptyResolverCall(node.key, resolverName) || hasNonEmptyResolverCall(node.value, resolverName);
184
+ case "ClassProperty":
185
+ case "ObjectProperty":
186
+ case "Property":
187
+ case "PropertyDefinition": return node.computed && hasNonEmptyResolverCall(node.key, resolverName) || hasNonEmptyResolverCall(node.value, resolverName);
188
+ case "ConditionalExpression":
189
+ case "IfStatement": return hasNonEmptyResolverCall(node.test, resolverName) || hasNonEmptyResolverCall(node.consequent, resolverName) || hasNonEmptyResolverCall(node.alternate, resolverName);
190
+ case "DoWhileStatement":
191
+ case "ForInStatement":
192
+ case "ForOfStatement":
193
+ case "ForStatement":
194
+ case "LabeledStatement":
195
+ case "WhileStatement":
196
+ case "WithStatement": return hasNonEmptyResolverCall(node.body, resolverName);
197
+ case "Import":
198
+ case "ImportExpression": return hasNonEmptyResolverCall(node.source, resolverName);
199
+ case "MemberExpression":
200
+ case "OptionalMemberExpression": return hasNonEmptyResolverCall(node.object, resolverName) || hasNonEmptyResolverCall(node.property, resolverName);
201
+ case "ObjectExpression":
202
+ case "ObjectPattern": return node.properties.some((property) => {
203
+ return hasNonEmptyResolverCall(property, resolverName);
204
+ });
205
+ case "ObjectMethod":
206
+ /* c8 ignore next 6 -- In Babel? */
207
+ return node.computed && hasNonEmptyResolverCall(node.key, resolverName) || node.arguments.some((nde) => {
208
+ return hasNonEmptyResolverCall(nde, resolverName);
209
+ });
210
+ case "ReturnStatement":
211
+ if (node.argument === null) return false;
212
+ return hasNonEmptyResolverCall(node.argument, resolverName);
213
+ case "SequenceExpression":
214
+ case "TemplateLiteral": return node.expressions.some((subExpression) => {
215
+ return hasNonEmptyResolverCall(subExpression, resolverName);
216
+ });
217
+ case "SwitchStatement": return node.cases.some((someCase) => {
218
+ return someCase.consequent.some((nde) => {
219
+ return hasNonEmptyResolverCall(nde, resolverName);
220
+ });
221
+ });
222
+ case "TaggedTemplateExpression": return hasNonEmptyResolverCall(node.quasi, resolverName);
223
+ case "TryStatement": return hasNonEmptyResolverCall(node.block, resolverName) || hasNonEmptyResolverCall(node.handler && node.handler.body, resolverName) || hasNonEmptyResolverCall(node.finalizer, resolverName);
224
+ case "VariableDeclaration": return node.declarations.some((nde) => {
225
+ return hasNonEmptyResolverCall(nde, resolverName);
226
+ });
227
+ case "VariableDeclarator": return hasNonEmptyResolverCall(node.id, resolverName) || hasNonEmptyResolverCall(node.init, resolverName);
228
+ default: return false;
229
+ }
425
230
  };
426
-
427
231
  /**
428
- * Checks if a Promise executor has no resolve value or an empty value.
429
- * An `undefined` resolve does not count.
430
- * @param {ESTreeOrTypeScriptNode} node
431
- * @param {boolean} anyPromiseAsReturn
432
- * @param {boolean} [allBranches]
433
- * @returns {boolean}
434
- */
232
+ * Checks if a Promise executor has no resolve value or an empty value.
233
+ * An `undefined` resolve does not count.
234
+ * @param {ESTreeOrTypeScriptNode} node
235
+ * @param {boolean} anyPromiseAsReturn
236
+ * @param {boolean} [allBranches]
237
+ * @returns {boolean}
238
+ */
435
239
  const hasValueOrExecutorHasNonEmptyResolveValue = (node, anyPromiseAsReturn, allBranches) => {
436
- const hasReturnMethod = allBranches ?
437
- /**
438
- * @param {ESTreeOrTypeScriptNode} nde
439
- * @param {PromiseFilter} promiseFilter
440
- * @returns {boolean}
441
- */
442
- (nde, promiseFilter) => {
443
- let hasReturn;
444
- try {
445
- hasReturn = hasReturnValue(nde, true, promiseFilter);
446
- } catch (error) {
447
- // c8 ignore else
448
- if (/** @type {Error} */error.message === 'Null return') {
449
- return false;
450
- }
451
- /* c8 ignore next 3 */
452
- // eslint-disable-next-line @stylistic/padding-line-between-statements -- c8
453
- throw error;
454
- }
455
-
456
- // `hasReturn` check needed since `throw` treated as valid return by
457
- // `allBrancheshaveReturnValues`
458
- return Boolean(hasReturn && allBrancheshaveReturnValues(nde, promiseFilter));
459
- } :
460
- /**
461
- * @param {ESTreeOrTypeScriptNode} nde
462
- * @param {PromiseFilter} promiseFilter
463
- * @returns {boolean}
464
- */
465
- (nde, promiseFilter) => {
466
- return Boolean(hasReturnValue(nde, false, promiseFilter));
467
- };
468
- return hasReturnMethod(node, prom => {
469
- if (anyPromiseAsReturn) {
470
- return true;
471
- }
472
- if (isVoidPromise(prom)) {
473
- return false;
474
- }
475
- const {
476
- body,
477
- params
478
- } =
479
- /**
480
- * @type {import('@typescript-eslint/types').TSESTree.FunctionExpression|
481
- * import('@typescript-eslint/types').TSESTree.ArrowFunctionExpression}
482
- */
483
- (/** @type {import('@typescript-eslint/types').TSESTree.NewExpression} */prom.arguments[0]) || {};
484
- if (!params?.length) {
485
- return false;
486
- }
487
- const {
488
- name: resolverName
489
- } = /** @type {import('@typescript-eslint/types').TSESTree.Identifier} */
490
- params[0];
491
- return hasNonEmptyResolverCall(body, resolverName);
492
- });
240
+ const hasReturnMethod = allBranches ? (nde, promiseFilter) => {
241
+ let hasReturn;
242
+ try {
243
+ hasReturn = hasReturnValue(nde, true, promiseFilter);
244
+ } catch (error) {
245
+ // c8 ignore else
246
+ if (error.message === "Null return") return false;
247
+ /* c8 ignore next 3 */
248
+ throw error;
249
+ }
250
+ return Boolean(hasReturn && allBrancheshaveReturnValues(nde, promiseFilter));
251
+ } : (nde, promiseFilter) => {
252
+ return Boolean(hasReturnValue(nde, false, promiseFilter));
253
+ };
254
+ return hasReturnMethod(node, (prom) => {
255
+ if (anyPromiseAsReturn) return true;
256
+ if (isVoidPromise(prom)) return false;
257
+ const { body, params } = prom.arguments[0] || {};
258
+ if (!params?.length) return false;
259
+ const { name: resolverName } = params[0];
260
+ return hasNonEmptyResolverCall(body, resolverName);
261
+ });
493
262
  };
263
+
264
+ //#endregion
265
+ exports.hasReturnValue = hasReturnValue;
494
266
  exports.hasValueOrExecutorHasNonEmptyResolveValue = hasValueOrExecutorHasNonEmptyResolveValue;
495
267
  //# sourceMappingURL=hasReturnValue.cjs.map