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.
Files changed (359) hide show
  1. package/dist/WarnSettings.cjs +35 -18
  2. package/dist/WarnSettings.cjs.map +1 -1
  3. package/dist/alignTransform.cjs +305 -224
  4. package/dist/alignTransform.cjs.map +1 -1
  5. package/dist/defaultTagOrder.cjs +43 -132
  6. package/dist/defaultTagOrder.cjs.map +1 -1
  7. package/dist/exportParser.cjs +696 -478
  8. package/dist/exportParser.cjs.map +1 -1
  9. package/dist/generateRule.cjs +242 -0
  10. package/dist/generateRule.cjs.map +1 -0
  11. package/dist/getDefaultTagStructureForMode.cjs +288 -184
  12. package/dist/getDefaultTagStructureForMode.cjs.map +1 -1
  13. package/dist/getJsdocProcessorPlugin.cjs +550 -364
  14. package/dist/getJsdocProcessorPlugin.cjs.map +1 -1
  15. package/dist/getJsdocProcessorPlugin.d.ts +65 -68
  16. package/dist/getJsdocProcessorPlugin.d.ts.map +1 -1
  17. package/dist/index.cjs +410 -2
  18. package/dist/index.cjs.map +1 -0
  19. package/dist/index.d.ts +17 -2
  20. package/dist/index.d.ts.map +1 -0
  21. package/dist/iterateJsdoc.cjs +2005 -1539
  22. package/dist/iterateJsdoc.cjs.map +1 -1
  23. package/dist/iterateJsdoc.d.ts +350 -359
  24. package/dist/iterateJsdoc.d.ts.map +1 -1
  25. package/dist/jsdocUtils.cjs +1376 -1009
  26. package/dist/jsdocUtils.cjs.map +1 -1
  27. package/dist/rules/checkAccess.cjs +36 -29
  28. package/dist/rules/checkAccess.cjs.map +1 -1
  29. package/dist/rules/checkAlignment.cjs +54 -41
  30. package/dist/rules/checkAlignment.cjs.map +1 -1
  31. package/dist/rules/checkExamples.cjs +484 -327
  32. package/dist/rules/checkExamples.cjs.map +1 -1
  33. package/dist/rules/checkIndentation.cjs +65 -50
  34. package/dist/rules/checkIndentation.cjs.map +1 -1
  35. package/dist/rules/checkLineAlignment.cjs +311 -220
  36. package/dist/rules/checkLineAlignment.cjs.map +1 -1
  37. package/dist/rules/checkParamNames.cjs +335 -227
  38. package/dist/rules/checkParamNames.cjs.map +1 -1
  39. package/dist/rules/checkPropertyNames.cjs +106 -78
  40. package/dist/rules/checkPropertyNames.cjs.map +1 -1
  41. package/dist/rules/checkSyntax.cjs +34 -21
  42. package/dist/rules/checkSyntax.cjs.map +1 -1
  43. package/dist/rules/checkTagNames.cjs +210 -188
  44. package/dist/rules/checkTagNames.cjs.map +1 -1
  45. package/dist/rules/checkTemplateNames.cjs +178 -121
  46. package/dist/rules/checkTemplateNames.cjs.map +1 -1
  47. package/dist/rules/checkTypes.cjs +385 -291
  48. package/dist/rules/checkTypes.cjs.map +1 -1
  49. package/dist/rules/checkValues.cjs +146 -100
  50. package/dist/rules/checkValues.cjs.map +1 -1
  51. package/dist/rules/convertToJsdocComments.cjs +306 -228
  52. package/dist/rules/convertToJsdocComments.cjs.map +1 -1
  53. package/dist/rules/emptyTags.cjs +72 -62
  54. package/dist/rules/emptyTags.cjs.map +1 -1
  55. package/dist/rules/implementsOnClasses.cjs +56 -36
  56. package/dist/rules/implementsOnClasses.cjs.map +1 -1
  57. package/dist/rules/importsAsDependencies.cjs +99 -62
  58. package/dist/rules/importsAsDependencies.cjs.map +1 -1
  59. package/dist/rules/informativeDocs.cjs +142 -105
  60. package/dist/rules/informativeDocs.cjs.map +1 -1
  61. package/dist/rules/linesBeforeBlock.cjs +105 -70
  62. package/dist/rules/linesBeforeBlock.cjs.map +1 -1
  63. package/dist/rules/matchDescription.cjs +222 -160
  64. package/dist/rules/matchDescription.cjs.map +1 -1
  65. package/dist/rules/matchName.cjs +128 -73
  66. package/dist/rules/matchName.cjs.map +1 -1
  67. package/dist/rules/multilineBlocks.cjs +352 -235
  68. package/dist/rules/multilineBlocks.cjs.map +1 -1
  69. package/dist/rules/noBadBlocks.cjs +86 -63
  70. package/dist/rules/noBadBlocks.cjs.map +1 -1
  71. package/dist/rules/noBlankBlockDescriptions.cjs +57 -35
  72. package/dist/rules/noBlankBlockDescriptions.cjs.map +1 -1
  73. package/dist/rules/noBlankBlocks.cjs +48 -26
  74. package/dist/rules/noBlankBlocks.cjs.map +1 -1
  75. package/dist/rules/noDefaults.cjs +79 -52
  76. package/dist/rules/noDefaults.cjs.map +1 -1
  77. package/dist/rules/noMissingSyntax.cjs +165 -115
  78. package/dist/rules/noMissingSyntax.cjs.map +1 -1
  79. package/dist/rules/noMultiAsterisks.cjs +89 -48
  80. package/dist/rules/noMultiAsterisks.cjs.map +1 -1
  81. package/dist/rules/noRestrictedSyntax.cjs +79 -45
  82. package/dist/rules/noRestrictedSyntax.cjs.map +1 -1
  83. package/dist/rules/noTypes.cjs +80 -59
  84. package/dist/rules/noTypes.cjs.map +1 -1
  85. package/dist/rules/noUndefinedTypes.cjs +388 -297
  86. package/dist/rules/noUndefinedTypes.cjs.map +1 -1
  87. package/dist/rules/requireAsteriskPrefix.cjs +159 -108
  88. package/dist/rules/requireAsteriskPrefix.cjs.map +1 -1
  89. package/dist/rules/requireDescription.cjs +129 -89
  90. package/dist/rules/requireDescription.cjs.map +1 -1
  91. package/dist/rules/requireDescriptionCompleteSentence.cjs +262 -201
  92. package/dist/rules/requireDescriptionCompleteSentence.cjs.map +1 -1
  93. package/dist/rules/requireExample.cjs +104 -73
  94. package/dist/rules/requireExample.cjs.map +1 -1
  95. package/dist/rules/requireFileOverview.cjs +129 -75
  96. package/dist/rules/requireFileOverview.cjs.map +1 -1
  97. package/dist/rules/requireHyphenBeforeParamDescription.cjs +133 -85
  98. package/dist/rules/requireHyphenBeforeParamDescription.cjs.map +1 -1
  99. package/dist/rules/requireJsdoc.cjs +557 -384
  100. package/dist/rules/requireJsdoc.cjs.map +1 -1
  101. package/dist/rules/requireParam.cjs +526 -336
  102. package/dist/rules/requireParam.cjs.map +1 -1
  103. package/dist/rules/requireParamDescription.cjs +80 -55
  104. package/dist/rules/requireParamDescription.cjs.map +1 -1
  105. package/dist/rules/requireParamName.cjs +50 -32
  106. package/dist/rules/requireParamName.cjs.map +1 -1
  107. package/dist/rules/requireParamType.cjs +80 -55
  108. package/dist/rules/requireParamType.cjs.map +1 -1
  109. package/dist/rules/requireProperty.cjs +42 -31
  110. package/dist/rules/requireProperty.cjs.map +1 -1
  111. package/dist/rules/requirePropertyDescription.cjs +25 -17
  112. package/dist/rules/requirePropertyDescription.cjs.map +1 -1
  113. package/dist/rules/requirePropertyName.cjs +25 -17
  114. package/dist/rules/requirePropertyName.cjs.map +1 -1
  115. package/dist/rules/requirePropertyType.cjs +25 -17
  116. package/dist/rules/requirePropertyType.cjs.map +1 -1
  117. package/dist/rules/requireReturns.cjs +203 -125
  118. package/dist/rules/requireReturns.cjs.map +1 -1
  119. package/dist/rules/requireReturnsCheck.cjs +103 -60
  120. package/dist/rules/requireReturnsCheck.cjs.map +1 -1
  121. package/dist/rules/requireReturnsDescription.cjs +54 -39
  122. package/dist/rules/requireReturnsDescription.cjs.map +1 -1
  123. package/dist/rules/requireReturnsType.cjs +50 -32
  124. package/dist/rules/requireReturnsType.cjs.map +1 -1
  125. package/dist/rules/requireTemplate.cjs +178 -119
  126. package/dist/rules/requireTemplate.cjs.map +1 -1
  127. package/dist/rules/requireThrows.cjs +95 -61
  128. package/dist/rules/requireThrows.cjs.map +1 -1
  129. package/dist/rules/requireYields.cjs +166 -106
  130. package/dist/rules/requireYields.cjs.map +1 -1
  131. package/dist/rules/requireYieldsCheck.cjs +152 -96
  132. package/dist/rules/requireYieldsCheck.cjs.map +1 -1
  133. package/dist/rules/sortTags.cjs +444 -258
  134. package/dist/rules/sortTags.cjs.map +1 -1
  135. package/dist/rules/tagLines.cjs +266 -179
  136. package/dist/rules/tagLines.cjs.map +1 -1
  137. package/dist/rules/textEscaping.cjs +127 -92
  138. package/dist/rules/textEscaping.cjs.map +1 -1
  139. package/dist/rules/validTypes.cjs +265 -252
  140. package/dist/rules/validTypes.cjs.map +1 -1
  141. package/dist/tagNames.cjs +170 -134
  142. package/dist/tagNames.cjs.map +1 -1
  143. package/dist/utils/hasReturnValue.cjs +474 -246
  144. package/dist/utils/hasReturnValue.cjs.map +1 -1
  145. package/package.json +24 -40
  146. package/src/WarnSettings.js +34 -0
  147. package/src/alignTransform.js +358 -0
  148. package/src/defaultTagOrder.js +169 -0
  149. package/src/exportParser.js +978 -0
  150. package/src/getDefaultTagStructureForMode.js +969 -0
  151. package/src/getJsdocProcessorPlugin.js +672 -0
  152. package/src/index.js +530 -0
  153. package/src/iterateJsdoc.js +2541 -0
  154. package/src/jsdocUtils.js +1896 -0
  155. package/src/rules/checkAccess.js +45 -0
  156. package/src/rules/checkAlignment.js +63 -0
  157. package/src/rules/checkExamples.js +589 -0
  158. package/src/rules/checkIndentation.js +75 -0
  159. package/src/rules/checkLineAlignment.js +372 -0
  160. package/src/rules/checkParamNames.js +474 -0
  161. package/src/rules/checkPropertyNames.js +152 -0
  162. package/src/rules/checkSyntax.js +30 -0
  163. package/src/rules/checkTagNames.js +314 -0
  164. package/src/rules/checkTemplateNames.js +204 -0
  165. package/src/rules/checkTypes.js +535 -0
  166. package/src/rules/checkValues.js +248 -0
  167. package/src/rules/convertToJsdocComments.js +398 -0
  168. package/src/rules/emptyTags.js +98 -0
  169. package/src/rules/implementsOnClasses.js +64 -0
  170. package/src/rules/importsAsDependencies.js +133 -0
  171. package/src/rules/informativeDocs.js +189 -0
  172. package/src/rules/linesBeforeBlock.js +134 -0
  173. package/src/rules/matchDescription.js +286 -0
  174. package/src/rules/matchName.js +151 -0
  175. package/src/rules/multilineBlocks.js +493 -0
  176. package/src/rules/noBadBlocks.js +119 -0
  177. package/src/rules/noBlankBlockDescriptions.js +69 -0
  178. package/src/rules/noBlankBlocks.js +53 -0
  179. package/src/rules/noDefaults.js +85 -0
  180. package/src/rules/noMissingSyntax.js +195 -0
  181. package/src/rules/noMultiAsterisks.js +134 -0
  182. package/src/rules/noRestrictedSyntax.js +91 -0
  183. package/src/rules/noTypes.js +93 -0
  184. package/src/rules/noUndefinedTypes.js +543 -0
  185. package/src/rules/requireAsteriskPrefix.js +190 -0
  186. package/src/rules/requireDescription.js +161 -0
  187. package/src/rules/requireDescriptionCompleteSentence.js +335 -0
  188. package/src/rules/requireExample.js +118 -0
  189. package/src/rules/requireFileOverview.js +154 -0
  190. package/src/rules/requireHyphenBeforeParamDescription.js +176 -0
  191. package/src/rules/requireJsdoc.js +743 -0
  192. package/src/rules/requireParam.js +602 -0
  193. package/src/rules/requireParamDescription.js +89 -0
  194. package/src/rules/requireParamName.js +55 -0
  195. package/src/rules/requireParamType.js +89 -0
  196. package/src/rules/requireProperty.js +48 -0
  197. package/src/rules/requirePropertyDescription.js +25 -0
  198. package/src/rules/requirePropertyName.js +25 -0
  199. package/src/rules/requirePropertyType.js +25 -0
  200. package/src/rules/requireReturns.js +238 -0
  201. package/src/rules/requireReturnsCheck.js +145 -0
  202. package/src/rules/requireReturnsDescription.js +59 -0
  203. package/src/rules/requireReturnsType.js +51 -0
  204. package/src/rules/requireTemplate.js +201 -0
  205. package/src/rules/requireThrows.js +111 -0
  206. package/src/rules/requireYields.js +216 -0
  207. package/src/rules/requireYieldsCheck.js +208 -0
  208. package/src/rules/sortTags.js +558 -0
  209. package/src/rules/tagLines.js +359 -0
  210. package/src/rules/textEscaping.js +154 -0
  211. package/src/rules/validTypes.js +401 -0
  212. package/src/tagNames.js +238 -0
  213. package/src/utils/hasReturnValue.js +572 -0
  214. package/dist/WarnSettings.js +0 -20
  215. package/dist/WarnSettings.js.map +0 -1
  216. package/dist/_virtual/rolldown_runtime.cjs +0 -32
  217. package/dist/_virtual/rolldown_runtime.js +0 -11
  218. package/dist/alignTransform.js +0 -241
  219. package/dist/alignTransform.js.map +0 -1
  220. package/dist/defaultTagOrder.js +0 -134
  221. package/dist/defaultTagOrder.js.map +0 -1
  222. package/dist/exportParser.js +0 -518
  223. package/dist/exportParser.js.map +0 -1
  224. package/dist/getDefaultTagStructureForMode.js +0 -188
  225. package/dist/getDefaultTagStructureForMode.js.map +0 -1
  226. package/dist/getJsdocProcessorPlugin.d.cts +0 -70
  227. package/dist/getJsdocProcessorPlugin.d.cts.map +0 -1
  228. package/dist/getJsdocProcessorPlugin.js +0 -383
  229. package/dist/getJsdocProcessorPlugin.js.map +0 -1
  230. package/dist/index.d.cts +0 -2
  231. package/dist/index.js +0 -3
  232. package/dist/iterateJsdoc.d.cts +0 -472
  233. package/dist/iterateJsdoc.d.cts.map +0 -1
  234. package/dist/iterateJsdoc.js +0 -1628
  235. package/dist/iterateJsdoc.js.map +0 -1
  236. package/dist/jsdocUtils.js +0 -1123
  237. package/dist/jsdocUtils.js.map +0 -1
  238. package/dist/plugin.cjs +0 -427
  239. package/dist/plugin.cjs.map +0 -1
  240. package/dist/plugin.js +0 -427
  241. package/dist/plugin.js.map +0 -1
  242. package/dist/rules/checkAccess.js +0 -33
  243. package/dist/rules/checkAccess.js.map +0 -1
  244. package/dist/rules/checkAlignment.js +0 -47
  245. package/dist/rules/checkAlignment.js.map +0 -1
  246. package/dist/rules/checkExamples.js +0 -348
  247. package/dist/rules/checkExamples.js.map +0 -1
  248. package/dist/rules/checkIndentation.js +0 -59
  249. package/dist/rules/checkIndentation.js.map +0 -1
  250. package/dist/rules/checkLineAlignment.js +0 -229
  251. package/dist/rules/checkLineAlignment.js.map +0 -1
  252. package/dist/rules/checkParamNames.js +0 -237
  253. package/dist/rules/checkParamNames.js.map +0 -1
  254. package/dist/rules/checkPropertyNames.js +0 -88
  255. package/dist/rules/checkPropertyNames.js.map +0 -1
  256. package/dist/rules/checkSyntax.js +0 -25
  257. package/dist/rules/checkSyntax.js.map +0 -1
  258. package/dist/rules/checkTagNames.js +0 -191
  259. package/dist/rules/checkTagNames.js.map +0 -1
  260. package/dist/rules/checkTemplateNames.js +0 -124
  261. package/dist/rules/checkTemplateNames.js.map +0 -1
  262. package/dist/rules/checkTypes.js +0 -299
  263. package/dist/rules/checkTypes.js.map +0 -1
  264. package/dist/rules/checkValues.js +0 -103
  265. package/dist/rules/checkValues.js.map +0 -1
  266. package/dist/rules/convertToJsdocComments.js +0 -231
  267. package/dist/rules/convertToJsdocComments.js.map +0 -1
  268. package/dist/rules/emptyTags.js +0 -67
  269. package/dist/rules/emptyTags.js.map +0 -1
  270. package/dist/rules/implementsOnClasses.js +0 -40
  271. package/dist/rules/implementsOnClasses.js.map +0 -1
  272. package/dist/rules/importsAsDependencies.js +0 -68
  273. package/dist/rules/importsAsDependencies.js.map +0 -1
  274. package/dist/rules/informativeDocs.js +0 -110
  275. package/dist/rules/informativeDocs.js.map +0 -1
  276. package/dist/rules/linesBeforeBlock.js +0 -75
  277. package/dist/rules/linesBeforeBlock.js.map +0 -1
  278. package/dist/rules/matchDescription.js +0 -167
  279. package/dist/rules/matchDescription.js.map +0 -1
  280. package/dist/rules/matchName.js +0 -77
  281. package/dist/rules/matchName.js.map +0 -1
  282. package/dist/rules/multilineBlocks.js +0 -245
  283. package/dist/rules/multilineBlocks.js.map +0 -1
  284. package/dist/rules/noBadBlocks.js +0 -68
  285. package/dist/rules/noBadBlocks.js.map +0 -1
  286. package/dist/rules/noBlankBlockDescriptions.js +0 -41
  287. package/dist/rules/noBlankBlockDescriptions.js.map +0 -1
  288. package/dist/rules/noBlankBlocks.js +0 -30
  289. package/dist/rules/noBlankBlocks.js.map +0 -1
  290. package/dist/rules/noDefaults.js +0 -56
  291. package/dist/rules/noDefaults.js.map +0 -1
  292. package/dist/rules/noMissingSyntax.js +0 -126
  293. package/dist/rules/noMissingSyntax.js.map +0 -1
  294. package/dist/rules/noMultiAsterisks.js +0 -58
  295. package/dist/rules/noMultiAsterisks.js.map +0 -1
  296. package/dist/rules/noRestrictedSyntax.js +0 -49
  297. package/dist/rules/noRestrictedSyntax.js.map +0 -1
  298. package/dist/rules/noTypes.js +0 -65
  299. package/dist/rules/noTypes.js.map +0 -1
  300. package/dist/rules/noUndefinedTypes.js +0 -303
  301. package/dist/rules/noUndefinedTypes.js.map +0 -1
  302. package/dist/rules/requireAsteriskPrefix.js +0 -112
  303. package/dist/rules/requireAsteriskPrefix.js.map +0 -1
  304. package/dist/rules/requireDescription.js +0 -95
  305. package/dist/rules/requireDescription.js.map +0 -1
  306. package/dist/rules/requireDescriptionCompleteSentence.js +0 -220
  307. package/dist/rules/requireDescriptionCompleteSentence.js.map +0 -1
  308. package/dist/rules/requireExample.js +0 -77
  309. package/dist/rules/requireExample.js.map +0 -1
  310. package/dist/rules/requireFileOverview.js +0 -81
  311. package/dist/rules/requireFileOverview.js.map +0 -1
  312. package/dist/rules/requireHyphenBeforeParamDescription.js +0 -89
  313. package/dist/rules/requireHyphenBeforeParamDescription.js.map +0 -1
  314. package/dist/rules/requireJsdoc.js +0 -404
  315. package/dist/rules/requireJsdoc.js.map +0 -1
  316. package/dist/rules/requireParam.js +0 -344
  317. package/dist/rules/requireParam.js.map +0 -1
  318. package/dist/rules/requireParamDescription.js +0 -59
  319. package/dist/rules/requireParamDescription.js.map +0 -1
  320. package/dist/rules/requireParamName.js +0 -36
  321. package/dist/rules/requireParamName.js.map +0 -1
  322. package/dist/rules/requireParamType.js +0 -59
  323. package/dist/rules/requireParamType.js.map +0 -1
  324. package/dist/rules/requireProperty.js +0 -35
  325. package/dist/rules/requireProperty.js.map +0 -1
  326. package/dist/rules/requirePropertyDescription.js +0 -21
  327. package/dist/rules/requirePropertyDescription.js.map +0 -1
  328. package/dist/rules/requirePropertyName.js +0 -21
  329. package/dist/rules/requirePropertyName.js.map +0 -1
  330. package/dist/rules/requirePropertyType.js +0 -21
  331. package/dist/rules/requirePropertyType.js.map +0 -1
  332. package/dist/rules/requireReturns.js +0 -131
  333. package/dist/rules/requireReturns.js.map +0 -1
  334. package/dist/rules/requireReturnsCheck.js +0 -66
  335. package/dist/rules/requireReturnsCheck.js.map +0 -1
  336. package/dist/rules/requireReturnsDescription.js +0 -43
  337. package/dist/rules/requireReturnsDescription.js.map +0 -1
  338. package/dist/rules/requireReturnsType.js +0 -36
  339. package/dist/rules/requireReturnsType.js.map +0 -1
  340. package/dist/rules/requireTemplate.js +0 -122
  341. package/dist/rules/requireTemplate.js.map +0 -1
  342. package/dist/rules/requireThrows.js +0 -67
  343. package/dist/rules/requireThrows.js.map +0 -1
  344. package/dist/rules/requireYields.js +0 -115
  345. package/dist/rules/requireYields.js.map +0 -1
  346. package/dist/rules/requireYieldsCheck.js +0 -105
  347. package/dist/rules/requireYieldsCheck.js.map +0 -1
  348. package/dist/rules/sortTags.js +0 -262
  349. package/dist/rules/sortTags.js.map +0 -1
  350. package/dist/rules/tagLines.js +0 -183
  351. package/dist/rules/tagLines.js.map +0 -1
  352. package/dist/rules/textEscaping.js +0 -102
  353. package/dist/rules/textEscaping.js.map +0 -1
  354. package/dist/rules/validTypes.js +0 -259
  355. package/dist/rules/validTypes.js.map +0 -1
  356. package/dist/tagNames.js +0 -144
  357. package/dist/tagNames.js.map +0 -1
  358. package/dist/utils/hasReturnValue.js +0 -265
  359. package/dist/utils/hasReturnValue.js.map +0 -1
@@ -1,267 +1,495 @@
1
+ "use strict";
1
2
 
2
- //#region src/utils/hasReturnValue.js
3
+ Object.defineProperty(exports, "__esModule", {
4
+ value: true
5
+ });
6
+ exports.hasValueOrExecutorHasNonEmptyResolveValue = exports.hasReturnValue = void 0;
3
7
  /**
4
- * @typedef {import('estree').Node|
5
- * import('@typescript-eslint/types').TSESTree.Node} ESTreeOrTypeScriptNode
6
- */
8
+ * @typedef {import('estree').Node|
9
+ * import('@typescript-eslint/types').TSESTree.Node} ESTreeOrTypeScriptNode
10
+ */
11
+
7
12
  /**
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";
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';
15
20
  };
21
+
16
22
  /**
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";
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';
22
33
  };
23
- const undefinedKeywords = new Set([
24
- "TSNeverKeyword",
25
- "TSUndefinedKeyword",
26
- "TSVoidKeyword"
27
- ]);
34
+ const undefinedKeywords = new Set(['TSNeverKeyword', 'TSUndefinedKeyword', 'TSVoidKeyword']);
35
+
28
36
  /**
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
- */
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
35
44
  const hasReturnValue = (node, throwOnNullReturn, promFilter) => {
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
- }
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
+ }
74
117
  };
118
+
75
119
  /**
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
- */
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;
81
127
  const allBrancheshaveReturnValues = (node, promFilter) => {
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
- }
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
+ }
129
236
  };
237
+
130
238
  /**
131
- * @callback PromiseFilter
132
- * @param {ESTreeOrTypeScriptNode|undefined} node
133
- * @returns {boolean}
134
- */
239
+ * @callback PromiseFilter
240
+ * @param {ESTreeOrTypeScriptNode|undefined} node
241
+ * @returns {boolean}
242
+ */
243
+
135
244
  /**
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
- */
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
147
257
  const hasNonEmptyResolverCall = (node, resolverName) => {
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
- }
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
+ }
230
425
  };
426
+
231
427
  /**
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
- */
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
+ */
239
435
  const hasValueOrExecutorHasNonEmptyResolveValue = (node, anyPromiseAsReturn, allBranches) => {
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
- });
262
- };
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
+ }
263
455
 
264
- //#endregion
265
- exports.hasReturnValue = hasReturnValue;
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
+ });
493
+ };
266
494
  exports.hasValueOrExecutorHasNonEmptyResolveValue = hasValueOrExecutorHasNonEmptyResolveValue;
267
495
  //# sourceMappingURL=hasReturnValue.cjs.map