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