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 +1 @@
1
- {"version":3,"file":"jsdocUtils.cjs","names":["getDefaultTagStructureForMode","WarnSettings","closureTags","jsdocTags","typeScriptTags"],"sources":["../src/jsdocUtils.js"],"sourcesContent":["import getDefaultTagStructureForMode from './getDefaultTagStructureForMode.js';\nimport {\n closureTags,\n jsdocTags,\n typeScriptTags,\n} from './tagNames.js';\nimport WarnSettings from './WarnSettings.js';\nimport {\n tryParse,\n} from '@es-joy/jsdoccomment';\n\n/**\n * @typedef {number} Integer\n */\n/**\n * @typedef {import('./utils/hasReturnValue.js').ESTreeOrTypeScriptNode} ESTreeOrTypeScriptNode\n */\n\n/**\n * @typedef {\"jsdoc\"|\"typescript\"|\"closure\"|\"permissive\"} ParserMode\n */\n\n/**\n * @type {import('./getDefaultTagStructureForMode.js').TagStructure}\n */\nlet tagStructure;\n\n/**\n * @param {ParserMode} mode\n * @returns {void}\n */\nconst setTagStructure = (mode) => {\n tagStructure = getDefaultTagStructureForMode(mode);\n};\n\n/**\n * @typedef {undefined|string|{\n * name: Integer,\n * restElement: boolean\n * }|{\n * isRestProperty: boolean|undefined,\n * name: string,\n * restElement: boolean\n * }|{\n * name: string,\n * restElement: boolean\n * }} ParamCommon\n */\n/**\n * @typedef {ParamCommon|[string|undefined, (FlattendRootInfo & {\n * annotationParamName?: string,\n * })]|NestedParamInfo} ParamNameInfo\n */\n\n/**\n * @typedef {{\n * hasPropertyRest: boolean,\n * hasRestElement: boolean,\n * names: string[],\n * rests: boolean[],\n * }} FlattendRootInfo\n */\n/**\n * @typedef {[string, (string[]|ParamInfo[])]} NestedParamInfo\n */\n/**\n * @typedef {ParamCommon|\n * [string|undefined, (FlattendRootInfo & {\n * annotationParamName?: string\n * })]|\n * NestedParamInfo} ParamInfo\n */\n\n/**\n * Given a nested array of property names, reduce them to a single array,\n * appending the name of the root element along the way if present.\n * @callback FlattenRoots\n * @param {ParamInfo[]} params\n * @param {string} [root]\n * @returns {FlattendRootInfo}\n */\n\n/** @type {FlattenRoots} */\nconst flattenRoots = (params, root = '') => {\n let hasRestElement = false;\n let hasPropertyRest = false;\n\n /**\n * @type {boolean[]}\n */\n const rests = [];\n\n const names = params.reduce(\n /**\n * @param {string[]} acc\n * @param {ParamInfo} cur\n * @returns {string[]}\n */\n (acc, cur) => {\n if (Array.isArray(cur)) {\n let nms;\n if (Array.isArray(cur[1])) {\n nms = cur[1];\n } else {\n if (cur[1].hasRestElement) {\n hasRestElement = true;\n }\n\n if (cur[1].hasPropertyRest) {\n hasPropertyRest = true;\n }\n\n nms = cur[1].names;\n }\n\n const flattened = flattenRoots(nms, root ? `${root}.${cur[0]}` : cur[0]);\n if (flattened.hasRestElement) {\n hasRestElement = true;\n }\n\n if (flattened.hasPropertyRest) {\n hasPropertyRest = true;\n }\n\n const inner = /** @type {string[]} */ ([\n root ? `${root}.${cur[0]}` : cur[0],\n ...flattened.names,\n ].filter(Boolean));\n rests.push(false, ...flattened.rests);\n\n return acc.concat(inner);\n }\n\n if (typeof cur === 'object') {\n if ('isRestProperty' in cur && cur.isRestProperty) {\n hasPropertyRest = true;\n rests.push(true);\n } else {\n rests.push(false);\n }\n\n if ('restElement' in cur && cur.restElement) {\n hasRestElement = true;\n }\n\n acc.push(root ? `${root}.${String(cur.name)}` : String(cur.name));\n } else if (typeof cur !== 'undefined') {\n rests.push(false);\n acc.push(root ? `${root}.${cur}` : cur);\n }\n\n return acc;\n }, [],\n );\n\n return {\n hasPropertyRest,\n hasRestElement,\n names,\n rests,\n };\n};\n\n/**\n * @param {import('@typescript-eslint/types').TSESTree.TSIndexSignature|\n * import('@typescript-eslint/types').TSESTree.TSConstructSignatureDeclaration|\n * import('@typescript-eslint/types').TSESTree.TSCallSignatureDeclaration|\n * import('@typescript-eslint/types').TSESTree.TSPropertySignature} propSignature\n * @returns {undefined|string|[string, string[]]}\n */\nconst getPropertiesFromPropertySignature = (propSignature) => {\n if (\n propSignature.type === 'TSIndexSignature' ||\n propSignature.type === 'TSConstructSignatureDeclaration' ||\n propSignature.type === 'TSCallSignatureDeclaration'\n ) {\n return undefined;\n }\n\n if (propSignature.typeAnnotation && propSignature.typeAnnotation.typeAnnotation.type === 'TSTypeLiteral') {\n return [\n /** @type {import('@typescript-eslint/types').TSESTree.Identifier} */ (\n propSignature.key\n ).name,\n propSignature.typeAnnotation.typeAnnotation.members.map((member) => {\n return /** @type {string} */ (\n getPropertiesFromPropertySignature(\n /** @type {import('@typescript-eslint/types').TSESTree.TSPropertySignature} */ (\n member\n ),\n )\n );\n }),\n ];\n }\n\n return /** @type {import('@typescript-eslint/types').TSESTree.Identifier} */ (\n propSignature.key\n ).name;\n};\n\n/**\n * @param {ESTreeOrTypeScriptNode|null} functionNode\n * @param {boolean} [checkDefaultObjects]\n * @throws {Error}\n * @returns {ParamNameInfo[]}\n */\nconst getFunctionParameterNames = (\n functionNode, checkDefaultObjects,\n) => {\n /* eslint-disable complexity -- Temporary */\n /**\n * @param {import('estree').Identifier|import('estree').AssignmentPattern|\n * import('estree').ObjectPattern|import('estree').Property|\n * import('estree').RestElement|import('estree').ArrayPattern|\n * import('@typescript-eslint/types').TSESTree.TSParameterProperty|\n * import('@typescript-eslint/types').TSESTree.Property|\n * import('@typescript-eslint/types').TSESTree.RestElement|\n * import('@typescript-eslint/types').TSESTree.Identifier|\n * import('@typescript-eslint/types').TSESTree.ObjectPattern|\n * import('@typescript-eslint/types').TSESTree.BindingName|\n * import('@typescript-eslint/types').TSESTree.Parameter\n * } param\n * @param {boolean} [isProperty]\n * @returns {ParamNameInfo|[string, ParamNameInfo[]]}\n */\n const getParamName = (param, isProperty) => {\n /* eslint-enable complexity -- Temporary */\n const hasLeftTypeAnnotation = 'left' in param && 'typeAnnotation' in param.left;\n\n if ('typeAnnotation' in param || hasLeftTypeAnnotation) {\n const typeAnnotation = hasLeftTypeAnnotation ?\n /** @type {import('@typescript-eslint/types').TSESTree.Identifier} */ (\n param.left\n ).typeAnnotation :\n /** @type {import('@typescript-eslint/types').TSESTree.Identifier|import('@typescript-eslint/types').TSESTree.ObjectPattern} */\n (param).typeAnnotation;\n\n if (typeAnnotation?.typeAnnotation?.type === 'TSTypeLiteral') {\n const propertyNames = typeAnnotation.typeAnnotation.members.map((member) => {\n return getPropertiesFromPropertySignature(\n /** @type {import('@typescript-eslint/types').TSESTree.TSPropertySignature} */\n (member),\n );\n });\n\n const flattened = {\n ...flattenRoots(propertyNames),\n annotationParamName: 'name' in param ? param.name : undefined,\n };\n const hasLeftName = 'left' in param && 'name' in param.left;\n\n if ('name' in param || hasLeftName) {\n return [\n hasLeftName ?\n /** @type {import('@typescript-eslint/types').TSESTree.Identifier} */ (\n param.left\n ).name :\n /** @type {import('@typescript-eslint/types').TSESTree.Identifier} */ (\n param\n ).name,\n flattened,\n ];\n }\n\n return [\n undefined, flattened,\n ];\n }\n }\n\n if ('name' in param) {\n return param.name;\n }\n\n if ('left' in param && 'name' in param.left) {\n return param.left.name;\n }\n\n if (\n param.type === 'ObjectPattern' ||\n ('left' in param &&\n (\n param\n ).left.type === 'ObjectPattern')\n ) {\n const properties = /** @type {import('@typescript-eslint/types').TSESTree.ObjectPattern} */ (\n param\n ).properties ||\n /** @type {import('estree').ObjectPattern} */\n (\n /** @type {import('@typescript-eslint/types').TSESTree.AssignmentPattern} */ (\n param\n ).left\n )?.properties;\n const roots = properties.map((prop) => {\n return getParamName(prop, true);\n });\n\n return [\n undefined, flattenRoots(roots),\n ];\n }\n\n if (param.type === 'Property') {\n switch (param.value.type) {\n case 'ArrayPattern': {\n return [\n /** @type {import('estree').Identifier} */\n (param.key).name,\n /** @type {import('estree').ArrayPattern} */ (\n param.value\n ).elements.map((prop, idx) => {\n return {\n name: idx,\n restElement: prop?.type === 'RestElement',\n };\n }),\n ];\n }\n\n case 'ObjectPattern': {\n return [\n /** @type {import('estree').Identifier} */ (param.key).name,\n /** @type {import('estree').ObjectPattern} */ (\n param.value\n ).properties.map((prop) => {\n return /** @type {string|[string, string[]]} */ (getParamName(prop, isProperty));\n }),\n ];\n }\n\n case 'AssignmentPattern': {\n switch (param.value.left.type) {\n case 'ArrayPattern':\n return [\n /** @type {import('estree').Identifier} */\n (param.key).name,\n /** @type {import('estree').ArrayPattern} */ (\n param.value.left\n ).elements.map((prop, idx) => {\n return {\n name: idx,\n restElement: prop?.type === 'RestElement',\n };\n }),\n ];\n case 'Identifier':\n // Default parameter\n if (checkDefaultObjects && param.value.right.type === 'ObjectExpression') {\n return [\n /** @type {import('estree').Identifier} */ (\n param.key\n ).name,\n /** @type {import('estree').AssignmentPattern} */ (\n param.value\n ).right.properties.map((prop) => {\n return /** @type {string} */ (getParamName(\n /** @type {import('estree').Property} */\n (prop),\n isProperty,\n ));\n }),\n ];\n }\n\n break;\n case 'ObjectPattern':\n return [\n /** @type {import('estree').Identifier} */\n (param.key).name,\n /** @type {import('estree').ObjectPattern} */ (\n param.value.left\n ).properties.map((prop) => {\n return getParamName(prop, isProperty);\n }),\n ];\n }\n }\n }\n\n switch (param.key.type) {\n case 'Identifier':\n return param.key.name;\n\n // The key of an object could also be a string or number\n case 'Literal':\n /* c8 ignore next 2 -- `raw` may not be present in all parsers */\n return /** @type {string} */ (param.key.raw ||\n param.key.value);\n\n // case 'MemberExpression':\n default:\n // Todo: We should really create a structure (and a corresponding\n // option analogous to `checkRestProperty`) which allows for\n // (and optionally requires) dynamic properties to have a single\n // line of documentation\n return undefined;\n }\n }\n\n if (\n param.type === 'ArrayPattern' ||\n /** @type {import('estree').AssignmentPattern} */ (\n param\n ).left?.type === 'ArrayPattern'\n ) {\n const elements = /** @type {import('estree').ArrayPattern} */ (\n param\n ).elements || /** @type {import('estree').ArrayPattern} */ (\n /** @type {import('estree').AssignmentPattern} */ (\n param\n ).left\n )?.elements;\n const roots = elements.map((prop, idx) => {\n return {\n name: `\"${idx}\"`,\n restElement: prop?.type === 'RestElement',\n };\n });\n\n return [\n undefined, flattenRoots(roots),\n ];\n }\n\n if ([\n 'ExperimentalRestProperty', 'RestElement',\n ].includes(param.type)) {\n return {\n isRestProperty: isProperty,\n name: /** @type {import('@typescript-eslint/types').TSESTree.Identifier} */ (\n /** @type {import('@typescript-eslint/types').TSESTree.RestElement} */ (\n param\n // @ts-expect-error Ok\n ).argument).name ?? param?.argument?.elements?.map(({\n // @ts-expect-error Ok\n name,\n }) => {\n return name;\n }),\n restElement: true,\n };\n }\n\n if (param.type === 'TSParameterProperty') {\n return getParamName(\n /** @type {import('@typescript-eslint/types').TSESTree.Identifier} */ (\n /** @type {import('@typescript-eslint/types').TSESTree.TSParameterProperty} */ (\n param\n ).parameter\n ),\n true,\n );\n }\n\n throw new Error(`Unsupported function signature format: \\`${param.type}\\`.`);\n };\n\n if (!functionNode) {\n return [];\n }\n\n return (/** @type {import('@typescript-eslint/types').TSESTree.FunctionDeclaration} */ (\n functionNode\n ).params || /** @type {import('@typescript-eslint/types').TSESTree.MethodDefinition} */ (\n functionNode\n ).value?.params || []).map((param) => {\n return getParamName(param);\n });\n};\n\n/**\n * @param {ESTreeOrTypeScriptNode} functionNode\n * @returns {Integer}\n */\nconst hasParams = (functionNode) => {\n // Should also check `functionNode.value.params` if supporting `MethodDefinition`\n return /** @type {import('@typescript-eslint/types').TSESTree.FunctionDeclaration} */ (\n functionNode\n ).params.length;\n};\n\n/**\n * Gets all names of the target type, including those that refer to a path, e.g.\n * `foo` or `foo.bar`.\n * @param {import('comment-parser').Block} jsdoc\n * @param {string} targetTagName\n * @returns {{\n * idx: Integer,\n * name: string,\n * type: string\n * }[]}\n */\nconst getJsdocTagsDeep = (jsdoc, targetTagName) => {\n const ret = [];\n for (const [\n idx,\n {\n name,\n tag,\n type,\n },\n ] of jsdoc.tags.entries()) {\n if (tag !== targetTagName) {\n continue;\n }\n\n ret.push({\n idx,\n name,\n type,\n });\n }\n\n return ret;\n};\n\nconst modeWarnSettings = WarnSettings();\n\n/**\n * @param {ParserMode|undefined} mode\n * @param {Reporter} context\n * @returns {import('./tagNames.js').AliasedTags}\n */\nconst getTagNamesForMode = (mode, context) => {\n switch (mode) {\n case 'closure':\n case 'permissive':\n return closureTags;\n case 'jsdoc':\n return jsdocTags; case 'typescript':\n return typeScriptTags;\n default:\n if (!modeWarnSettings.hasBeenWarned(context, 'mode')) {\n context.report({\n loc: {\n end: {\n column: 1,\n line: 1,\n },\n start: {\n column: 1,\n line: 1,\n },\n },\n message: `Unrecognized value \\`${mode}\\` for \\`settings.jsdoc.mode\\`.`,\n });\n modeWarnSettings.markSettingAsWarned(context, 'mode');\n }\n\n // We'll avoid breaking too many other rules\n return jsdocTags;\n }\n};\n\n/**\n * @param {import('comment-parser').Spec} tg\n * @param {boolean} [returnArray]\n * @returns {string[]|string}\n */\nconst getTagDescription = (tg, returnArray) => {\n /**\n * @type {string[]}\n */\n const descriptions = [];\n tg.source.some(({\n tokens: {\n description,\n end,\n lineEnd,\n name,\n postDelimiter,\n postTag,\n tag,\n type,\n },\n }) => {\n const desc = (\n tag && postTag ||\n !tag && !name && !type && postDelimiter || ''\n\n // Remove space\n ).slice(1) +\n (description || '') + (lineEnd || '');\n\n if (end) {\n if (desc) {\n descriptions.push(desc);\n }\n\n return true;\n }\n\n descriptions.push(desc);\n\n return false;\n });\n\n return returnArray ? descriptions : descriptions.join('\\n');\n};\n\n/**\n * @typedef {{\n * report: (descriptor: import('eslint').Rule.ReportDescriptor) => void\n * }} Reporter\n */\n\n/**\n * @param {string} name\n * @param {ParserMode|undefined} mode\n * @param {TagNamePreference} tagPreference\n * @param {Reporter} context\n * @returns {string|false|{\n * message: string;\n * replacement?: string|undefined;\n * }}\n */\nconst getPreferredTagNameSimple = (\n name,\n mode,\n tagPreference = {},\n // eslint-disable-next-line unicorn/no-object-as-default-parameter -- Ok\n context = {\n report () {\n // No-op\n },\n },\n) => {\n const prefValues = Object.values(tagPreference);\n if (prefValues.includes(name) || prefValues.some((prefVal) => {\n return prefVal && typeof prefVal === 'object' && prefVal.replacement === name;\n })) {\n return name;\n }\n\n // Allow keys to have a 'tag ' prefix to avoid upstream bug in ESLint\n // that disallows keys that conflict with Object.prototype,\n // e.g. 'tag constructor' for 'constructor':\n // https://github.com/eslint/eslint/issues/13289\n // https://github.com/gajus/eslint-plugin-jsdoc/issues/537\n const tagPreferenceFixed = Object.fromEntries(\n Object\n .entries(tagPreference)\n .map(([\n key,\n value,\n ]) => {\n return [\n key.replace(/^tag /v, ''), value,\n ];\n }),\n );\n\n if (Object.hasOwn(tagPreferenceFixed, name)) {\n return tagPreferenceFixed[name];\n }\n\n const tagNames = getTagNamesForMode(mode, context);\n\n const preferredTagName = Object.entries(tagNames).find(([\n , aliases,\n ]) => {\n return aliases.includes(name);\n })?.[0];\n if (preferredTagName) {\n return preferredTagName;\n }\n\n return name;\n};\n\n/**\n * @param {import('eslint').Rule.RuleContext} context\n * @param {ParserMode|undefined} mode\n * @param {string} name\n * @param {string[]} definedTags\n * @returns {boolean}\n */\nconst isValidTag = (\n context,\n mode,\n name,\n definedTags,\n) => {\n const tagNames = getTagNamesForMode(mode, context);\n\n const validTagNames = Object.keys(tagNames).concat(Object.values(tagNames).flat());\n const additionalTags = definedTags;\n const allTags = validTagNames.concat(additionalTags);\n\n return allTags.includes(name);\n};\n\n/**\n * @param {import('./iterateJsdoc.js').JsdocBlockWithInline} jsdoc\n * @param {string} targetTagName\n * @returns {boolean}\n */\nconst hasTag = (jsdoc, targetTagName) => {\n const targetTagLower = targetTagName.toLowerCase();\n\n return jsdoc.tags.some((doc) => {\n return doc.tag.toLowerCase() === targetTagLower;\n });\n};\n\n/**\n * @param {import('./iterateJsdoc.js').JsdocBlockWithInline} jsdoc\n * @param {(tag: import('@es-joy/jsdoccomment').JsdocTagWithInline) => boolean} filter\n * @returns {import('@es-joy/jsdoccomment').JsdocTagWithInline[]}\n */\nconst filterTags = (jsdoc, filter) => {\n return jsdoc.tags.filter((tag) => {\n return filter(tag);\n });\n};\n\n/**\n * @param {import('./iterateJsdoc.js').JsdocBlockWithInline} jsdoc\n * @param {string} tagName\n * @returns {import('comment-parser').Spec[]}\n */\nconst getTags = (jsdoc, tagName) => {\n return filterTags(jsdoc, (item) => {\n return item.tag === tagName;\n });\n};\n\n/**\n * @param {import('./iterateJsdoc.js').JsdocBlockWithInline} jsdoc\n * @param {{\n * tagName: string,\n * context?: import('eslint').Rule.RuleContext,\n * mode?: ParserMode,\n * report?: import('./iterateJsdoc.js').Report\n * tagNamePreference?: TagNamePreference\n * skipReportingBlockedTag?: boolean,\n * allowObjectReturn?: boolean,\n * defaultMessage?: string,\n * }} cfg\n * @returns {string|undefined|false|{\n * message: string;\n * replacement?: string|undefined;\n * }|{\n * blocked: true,\n * tagName: string\n * }}\n */\nconst getPreferredTagName = (jsdoc, {\n allowObjectReturn = false,\n context,\n tagName,\n defaultMessage = `Unexpected tag \\`@${tagName}\\``,\n mode,\n report = () => {},\n skipReportingBlockedTag = false,\n tagNamePreference,\n}) => {\n const ret = getPreferredTagNameSimple(tagName, mode, tagNamePreference, context);\n const isObject = ret && typeof ret === 'object';\n if (hasTag(jsdoc, tagName) && (ret === false || isObject && !ret.replacement)) {\n if (skipReportingBlockedTag) {\n return {\n blocked: true,\n tagName,\n };\n }\n\n const message = isObject && ret.message || defaultMessage;\n report(message, null, getTags(jsdoc, tagName)[0]);\n\n return false;\n }\n\n return isObject && !allowObjectReturn ? ret.replacement : ret;\n};\n\n/**\n * @param {import('./iterateJsdoc.js').JsdocBlockWithInline} jsdoc\n * @param {string} tagName\n * @param {(\n * matchingJsdocTag: import('@es-joy/jsdoccomment').JsdocTagWithInline,\n * targetTagName: string\n * ) => void} arrayHandler\n * @param {object} cfg\n * @param {import('eslint').Rule.RuleContext} [cfg.context]\n * @param {ParserMode} [cfg.mode]\n * @param {import('./iterateJsdoc.js').Report} [cfg.report]\n * @param {TagNamePreference} [cfg.tagNamePreference]\n * @param {boolean} [cfg.skipReportingBlockedTag]\n * @returns {void}\n */\nconst forEachPreferredTag = (\n jsdoc, tagName, arrayHandler,\n {\n context,\n mode,\n report,\n skipReportingBlockedTag = false,\n tagNamePreference,\n } = {},\n) => {\n const targetTagName = /** @type {string|false} */ (\n getPreferredTagName(jsdoc, {\n context,\n mode,\n report,\n skipReportingBlockedTag,\n tagName,\n tagNamePreference,\n })\n );\n if (!targetTagName ||\n skipReportingBlockedTag && targetTagName && typeof targetTagName === 'object'\n ) {\n return;\n }\n\n const matchingJsdocTags = jsdoc.tags.filter(({\n tag,\n }) => {\n return tag === targetTagName;\n });\n\n for (const matchingJsdocTag of matchingJsdocTags) {\n arrayHandler(\n /**\n * @type {import('@es-joy/jsdoccomment').JsdocTagWithInline}\n */ (\n matchingJsdocTag\n ), targetTagName,\n );\n }\n};\n\n/**\n * Get all tags, inline tags and inline tags in tags\n * @param {import('./iterateJsdoc.js').JsdocBlockWithInline} jsdoc\n * @returns {(import('comment-parser').Spec|\n * import('@es-joy/jsdoccomment').JsdocInlineTagNoType)[]}\n */\nconst getAllTags = (jsdoc) => {\n return [\n ...jsdoc.tags,\n ...jsdoc.inlineTags.map((inlineTag) => {\n // Tags don't have source or line numbers, so add before returning\n let line = -1;\n for (const {\n tokens: {\n description,\n },\n } of jsdoc.source) {\n line++;\n if (description && description.includes(`{@${inlineTag.tag}`)) {\n break;\n }\n }\n\n inlineTag.line = line;\n\n return inlineTag;\n }),\n ...jsdoc.tags.flatMap((tag) => {\n let tagBegins = -1;\n for (const {\n tokens: {\n tag: tg,\n },\n } of jsdoc.source) {\n tagBegins++;\n if (tg) {\n break;\n }\n }\n\n for (const inlineTag of tag.inlineTags) {\n /** @type {import('./iterateJsdoc.js').Integer} */\n let line = 0;\n for (const {\n number,\n tokens: {\n description,\n },\n } of tag.source) {\n if (description && description.includes(`{@${inlineTag.tag}`)) {\n line = number;\n break;\n }\n }\n\n inlineTag.line = tagBegins + line - 1;\n }\n\n return (\n /**\n * @type {import('comment-parser').Spec & {\n * inlineTags: import('@es-joy/jsdoccomment').JsdocInlineTagNoType[]\n * }}\n */ (\n tag\n ).inlineTags\n );\n }),\n ];\n};\n\n/**\n * @param {import('./iterateJsdoc.js').JsdocBlockWithInline} jsdoc\n * @param {string[]} targetTagNames\n * @returns {boolean}\n */\nconst hasATag = (jsdoc, targetTagNames) => {\n return targetTagNames.some((targetTagName) => {\n return hasTag(jsdoc, targetTagName);\n });\n};\n\n/**\n * Checks if the JSDoc comment has an undefined type.\n * @param {import('comment-parser').Spec|null|undefined} tag\n * the tag which should be checked.\n * @param {ParserMode} mode\n * @returns {boolean}\n * true in case a defined type is undeclared; otherwise false.\n */\nconst mayBeUndefinedTypeTag = (tag, mode) => {\n // The function should not continue in the event the type is not defined...\n if (typeof tag === 'undefined' || tag === null) {\n return true;\n }\n\n // .. same applies if it declares an `{undefined}` or `{void}` type\n const tagType = tag.type.trim();\n\n // Exit early if matching\n if (\n tagType === 'undefined' || tagType === 'void' ||\n tagType === '*' || tagType === 'any'\n ) {\n return true;\n }\n\n let parsedTypes;\n try {\n parsedTypes = tryParse(\n tagType,\n mode === 'permissive' ? undefined : [\n mode,\n ],\n );\n } catch {\n // Ignore\n }\n\n if (\n // We do not traverse deeply as it could be, e.g., `Promise<void>`\n parsedTypes &&\n parsedTypes.type === 'JsdocTypeUnion' &&\n parsedTypes.elements.find((elem) => {\n return elem.type === 'JsdocTypeUndefined' ||\n elem.type === 'JsdocTypeName' && elem.value === 'void';\n })) {\n return true;\n }\n\n // In any other case, a type is present\n return false;\n};\n\n/**\n * @param {import('./getDefaultTagStructureForMode.js').TagStructure} map\n * @param {string} tag\n * @returns {Map<string, string|string[]|boolean|undefined>}\n */\nconst ensureMap = (map, tag) => {\n if (!map.has(tag)) {\n map.set(tag, new Map());\n }\n\n return /** @type {Map<string, string | boolean>} */ (map.get(tag));\n};\n\n/**\n * @param {import('./iterateJsdoc.js').StructuredTags} structuredTags\n * @param {import('./getDefaultTagStructureForMode.js').TagStructure} tagMap\n * @returns {void}\n */\nconst overrideTagStructure = (structuredTags, tagMap = tagStructure) => {\n for (const [\n tag,\n {\n name,\n required = [],\n type,\n },\n ] of Object.entries(structuredTags)) {\n const tagStruct = ensureMap(tagMap, tag);\n\n tagStruct.set('namepathRole', name);\n tagStruct.set('typeAllowed', type);\n\n const requiredName = required.includes('name');\n if (requiredName && name === false) {\n throw new Error('Cannot add \"name\" to `require` with the tag\\'s `name` set to `false`');\n }\n\n tagStruct.set('nameRequired', requiredName);\n\n const requiredType = required.includes('type');\n if (requiredType && type === false) {\n throw new Error('Cannot add \"type\" to `require` with the tag\\'s `type` set to `false`');\n }\n\n tagStruct.set('typeRequired', requiredType);\n\n const typeOrNameRequired = required.includes('typeOrNameRequired');\n if (typeOrNameRequired && name === false) {\n throw new Error('Cannot add \"typeOrNameRequired\" to `require` with the tag\\'s `name` set to `false`');\n }\n\n if (typeOrNameRequired && type === false) {\n throw new Error('Cannot add \"typeOrNameRequired\" to `require` with the tag\\'s `type` set to `false`');\n }\n\n tagStruct.set('typeOrNameRequired', typeOrNameRequired);\n }\n};\n\n/**\n * @param {ParserMode} mode\n * @param {import('./iterateJsdoc.js').StructuredTags} structuredTags\n * @returns {import('./getDefaultTagStructureForMode.js').TagStructure}\n */\nconst getTagStructureForMode = (mode, structuredTags) => {\n const tagStruct = getDefaultTagStructureForMode(mode);\n\n try {\n overrideTagStructure(structuredTags, tagStruct);\n /* c8 ignore next 3 */\n } catch {\n //\n }\n\n return tagStruct;\n};\n\n/**\n * @param {string} tag\n * @param {import('./getDefaultTagStructureForMode.js').TagStructure} tagMap\n * @returns {boolean}\n */\nconst isNamepathDefiningTag = (tag, tagMap = tagStructure) => {\n const tagStruct = ensureMap(tagMap, tag);\n\n return tagStruct.get('namepathRole') === 'namepath-defining';\n};\n\n/**\n * @param {string} tag\n * @param {import('./getDefaultTagStructureForMode.js').TagStructure} tagMap\n * @returns {boolean}\n */\nconst isNamepathReferencingTag = (tag, tagMap = tagStructure) => {\n const tagStruct = ensureMap(tagMap, tag);\n return tagStruct.get('namepathRole') === 'namepath-referencing';\n};\n\n/**\n * @param {string} tag\n * @param {import('./getDefaultTagStructureForMode.js').TagStructure} tagMap\n * @returns {boolean}\n */\nconst isNamepathOrUrlReferencingTag = (tag, tagMap = tagStructure) => {\n const tagStruct = ensureMap(tagMap, tag);\n return tagStruct.get('namepathRole') === 'namepath-or-url-referencing';\n};\n\n/**\n * @param {string} tag\n * @param {import('./getDefaultTagStructureForMode.js').TagStructure} tagMap\n * @returns {boolean|undefined}\n */\nconst tagMustHaveTypePosition = (tag, tagMap = tagStructure) => {\n const tagStruct = ensureMap(tagMap, tag);\n\n return /** @type {boolean|undefined} */ (tagStruct.get('typeRequired'));\n};\n\n/**\n * @param {string} tag\n * @param {import('./getDefaultTagStructureForMode.js').TagStructure} tagMap\n * @returns {boolean|string}\n */\nconst tagMightHaveTypePosition = (tag, tagMap = tagStructure) => {\n if (tagMustHaveTypePosition(tag, tagMap)) {\n return true;\n }\n\n const tagStruct = ensureMap(tagMap, tag);\n\n const ret = /** @type {boolean|undefined} */ (tagStruct.get('typeAllowed'));\n\n return ret === undefined ? true : ret;\n};\n\nconst namepathTypes = new Set([\n 'namepath-defining', 'namepath-referencing',\n]);\n\n/**\n * @param {string} tag\n * @param {import('./getDefaultTagStructureForMode.js').TagStructure} tagMap\n * @returns {boolean}\n */\nconst tagMightHaveNamePosition = (tag, tagMap = tagStructure) => {\n const tagStruct = ensureMap(tagMap, tag);\n\n const ret = tagStruct.get('namepathRole');\n\n return ret === undefined ? true : Boolean(ret);\n};\n\n/**\n * @param {string} tag\n * @param {import('./getDefaultTagStructureForMode.js').TagStructure} tagMap\n * @returns {boolean}\n */\nconst tagMightHaveNamepath = (tag, tagMap = tagStructure) => {\n const tagStruct = ensureMap(tagMap, tag);\n\n const nampathRole = tagStruct.get('namepathRole');\n\n return nampathRole !== false &&\n namepathTypes.has(/** @type {string} */ (nampathRole));\n};\n\n/**\n * @param {string} tag\n * @param {import('./getDefaultTagStructureForMode.js').TagStructure} tagMap\n * @returns {boolean|undefined}\n */\nconst tagMustHaveNamePosition = (tag, tagMap = tagStructure) => {\n const tagStruct = ensureMap(tagMap, tag);\n\n return /** @type {boolean|undefined} */ (tagStruct.get('nameRequired'));\n};\n\n/**\n * @param {string} tag\n * @param {import('./getDefaultTagStructureForMode.js').TagStructure} tagMap\n * @returns {boolean}\n */\nconst tagMightHaveEitherTypeOrNamePosition = (tag, tagMap) => {\n return Boolean(tagMightHaveTypePosition(tag, tagMap)) || tagMightHaveNamepath(tag, tagMap);\n};\n\n/**\n * @param {string} tag\n * @param {import('./getDefaultTagStructureForMode.js').TagStructure} tagMap\n * @returns {boolean|undefined}\n */\nconst tagMustHaveEitherTypeOrNamePosition = (tag, tagMap) => {\n const tagStruct = ensureMap(tagMap, tag);\n\n return /** @type {boolean} */ (tagStruct.get('typeOrNameRequired'));\n};\n\n/**\n * @param {import('comment-parser').Spec} tag\n * @param {import('./getDefaultTagStructureForMode.js').TagStructure} tagMap\n * @returns {boolean|undefined}\n */\nconst tagMissingRequiredTypeOrNamepath = (tag, tagMap = tagStructure) => {\n const mustHaveTypePosition = tagMustHaveTypePosition(tag.tag, tagMap);\n const mightHaveTypePosition = tagMightHaveTypePosition(tag.tag, tagMap);\n const hasTypePosition = mightHaveTypePosition && Boolean(tag.type);\n const hasNameOrNamepathPosition = (\n tagMustHaveNamePosition(tag.tag, tagMap) ||\n tagMightHaveNamepath(tag.tag, tagMap)\n ) && Boolean(tag.name);\n const mustHaveEither = tagMustHaveEitherTypeOrNamePosition(tag.tag, tagMap);\n const hasEither = tagMightHaveEitherTypeOrNamePosition(tag.tag, tagMap) &&\n (hasTypePosition || hasNameOrNamepathPosition);\n\n return mustHaveEither && !hasEither && !mustHaveTypePosition;\n};\n\n/* eslint-disable complexity -- Temporary */\n/**\n * @param {ESTreeOrTypeScriptNode|null|undefined} node\n * @param {boolean} [checkYieldReturnValue]\n * @returns {boolean}\n */\nconst hasNonFunctionYield = (node, checkYieldReturnValue) => {\n /* eslint-enable complexity -- Temporary */\n if (!node) {\n return false;\n }\n\n switch (node.type) {\n case 'ArrayExpression':\n\n case 'ArrayPattern':\n return node.elements.some((element) => {\n return hasNonFunctionYield(element, checkYieldReturnValue);\n });\n case 'AssignmentExpression':\n case 'BinaryExpression':\n case 'LogicalExpression': {\n return hasNonFunctionYield(node.left, checkYieldReturnValue) ||\n hasNonFunctionYield(node.right, checkYieldReturnValue);\n }\n\n case 'AssignmentPattern':\n return hasNonFunctionYield(node.right, checkYieldReturnValue);\n case 'BlockStatement': {\n return node.body.some((bodyNode) => {\n return ![\n 'ArrowFunctionExpression',\n 'FunctionDeclaration',\n 'FunctionExpression',\n ].includes(bodyNode.type) && hasNonFunctionYield(\n bodyNode, checkYieldReturnValue,\n );\n });\n }\n\n /* c8 ignore next 2 -- In Babel? */\n case 'CallExpression':\n // @ts-expect-error In Babel?\n case 'OptionalCallExpression':\n return node.arguments.some((element) => {\n return hasNonFunctionYield(element, checkYieldReturnValue);\n });\n case 'ChainExpression':\n case 'ExpressionStatement': {\n return hasNonFunctionYield(node.expression, checkYieldReturnValue);\n }\n\n /* c8 ignore next 2 -- In Babel? */\n // @ts-expect-error In Babel?\n case 'ClassProperty':\n\n /* c8 ignore next 2 -- In Babel? */\n // @ts-expect-error In Babel?\n case 'ObjectProperty':\n /* c8 ignore next 2 -- In Babel? */\n case 'Property':\n\n case 'PropertyDefinition':\n return node.computed && hasNonFunctionYield(node.key, checkYieldReturnValue) ||\n hasNonFunctionYield(node.value, checkYieldReturnValue);\n\n case 'ConditionalExpression':\n\n case 'IfStatement': {\n return hasNonFunctionYield(node.test, checkYieldReturnValue) ||\n hasNonFunctionYield(node.consequent, checkYieldReturnValue) ||\n hasNonFunctionYield(node.alternate, checkYieldReturnValue);\n }\n\n case 'DoWhileStatement':\n case 'ForInStatement':\n\n case 'ForOfStatement':\n\n case 'ForStatement':\n\n case 'LabeledStatement':\n case 'WhileStatement':\n case 'WithStatement': {\n return hasNonFunctionYield(node.body, checkYieldReturnValue);\n }\n\n /* c8 ignore next 2 -- In Babel? */\n // @ts-expect-error In Babel?\n case 'Import':\n case 'ImportExpression':\n return hasNonFunctionYield(node.source, checkYieldReturnValue);\n\n // ?.\n /* c8 ignore next 2 -- In Babel? */\n case 'MemberExpression':\n // @ts-expect-error In Babel?\n case 'OptionalMemberExpression':\n return hasNonFunctionYield(node.object, checkYieldReturnValue) ||\n hasNonFunctionYield(node.property, checkYieldReturnValue);\n\n case 'ObjectExpression':\n /* eslint-disable no-fallthrough */\n case 'ObjectPattern':\n /* eslint-enable no-fallthrough */\n return node.properties.some((property) => {\n return hasNonFunctionYield(property, checkYieldReturnValue);\n });\n /* c8 ignore next 2 -- In Babel? */\n // @ts-expect-error In Babel?\n case 'ObjectMethod':\n /* c8 ignore next 6 -- In Babel? */\n // @ts-expect-error In Babel?\n return node.computed && hasNonFunctionYield(node.key, checkYieldReturnValue) ||\n // @ts-expect-error In Babel?\n node.arguments.some((nde) => {\n return hasNonFunctionYield(nde, checkYieldReturnValue);\n });\n case 'ReturnStatement': {\n if (node.argument === null) {\n return false;\n }\n\n return hasNonFunctionYield(node.argument, checkYieldReturnValue);\n }\n\n // Comma\n case 'SequenceExpression':\n\n case 'TemplateLiteral':\n return node.expressions.some((subExpression) => {\n return hasNonFunctionYield(subExpression, checkYieldReturnValue);\n });\n case 'SpreadElement':\n\n case 'UnaryExpression':\n return hasNonFunctionYield(node.argument, checkYieldReturnValue);\n\n case 'SwitchStatement': {\n return node.cases.some(\n (someCase) => {\n return someCase.consequent.some((nde) => {\n return hasNonFunctionYield(nde, checkYieldReturnValue);\n });\n },\n );\n }\n\n case 'TaggedTemplateExpression':\n return hasNonFunctionYield(node.quasi, checkYieldReturnValue);\n\n case 'TryStatement': {\n return hasNonFunctionYield(node.block, checkYieldReturnValue) ||\n hasNonFunctionYield(\n node.handler && node.handler.body, checkYieldReturnValue,\n ) ||\n hasNonFunctionYield(\n /** @type {import('@typescript-eslint/types').TSESTree.BlockStatement} */\n (node.finalizer),\n checkYieldReturnValue,\n );\n }\n\n case 'VariableDeclaration': {\n return node.declarations.some((nde) => {\n return hasNonFunctionYield(nde, checkYieldReturnValue);\n });\n }\n\n case 'VariableDeclarator': {\n return hasNonFunctionYield(node.id, checkYieldReturnValue) ||\n hasNonFunctionYield(node.init, checkYieldReturnValue);\n }\n\n case 'YieldExpression': {\n if (checkYieldReturnValue) {\n if (\n /** @type {import('eslint').Rule.Node} */ (\n node\n ).parent.type === 'VariableDeclarator'\n ) {\n return true;\n }\n\n return false;\n }\n\n // void return does not count.\n if (node.argument === null) {\n return false;\n }\n\n return true;\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} node\n * @param {boolean} [checkYieldReturnValue]\n * @returns {boolean}\n */\nconst hasYieldValue = (node, checkYieldReturnValue) => {\n return /** @type {import('@typescript-eslint/types').TSESTree.FunctionDeclaration} */ (\n node\n ).generator && (\n /** @type {import('@typescript-eslint/types').TSESTree.FunctionDeclaration} */ (\n node\n ).expression || hasNonFunctionYield(\n /** @type {import('@typescript-eslint/types').TSESTree.FunctionDeclaration} */\n (node).body,\n checkYieldReturnValue,\n )\n );\n};\n\n/**\n * Checks if a node has a throws statement.\n * @param {ESTreeOrTypeScriptNode|null|undefined} node\n * @param {boolean} [innerFunction]\n * @returns {boolean}\n */\n// eslint-disable-next-line complexity\nconst hasThrowValue = (node, innerFunction) => {\n if (!node) {\n return false;\n }\n\n // There are cases where a function may execute its inner function which\n // throws, but we're treating functions atomically rather than trying to\n // follow them\n switch (node.type) {\n case 'ArrowFunctionExpression':\n case 'FunctionDeclaration':\n case 'FunctionExpression': {\n return !innerFunction && !node.async && hasThrowValue(node.body, true);\n }\n\n case 'BlockStatement': {\n return node.body.some((bodyNode) => {\n return bodyNode.type !== 'FunctionDeclaration' && hasThrowValue(bodyNode);\n });\n }\n\n case 'DoWhileStatement':\n case 'ForInStatement':\n case 'ForOfStatement':\n case 'ForStatement':\n case 'LabeledStatement':\n case 'WhileStatement':\n case 'WithStatement': {\n return hasThrowValue(node.body);\n }\n\n case 'IfStatement': {\n return hasThrowValue(node.consequent) || hasThrowValue(node.alternate);\n }\n\n case 'SwitchStatement': {\n return node.cases.some(\n (someCase) => {\n return someCase.consequent.some((nde) => {\n return hasThrowValue(nde);\n });\n },\n );\n }\n\n case 'ThrowStatement': {\n return true;\n }\n\n // We only consider it to throw an error if the catch or finally blocks throw an error.\n case 'TryStatement': {\n return hasThrowValue(node.handler && node.handler.body) ||\n hasThrowValue(node.finalizer);\n }\n\n default: {\n return false;\n }\n }\n};\n\n/**\n * @param {string} tag\n */\n/*\nconst isInlineTag = (tag) => {\n return /^(@link|@linkcode|@linkplain|@tutorial) /v.test(tag);\n};\n*/\n\n/**\n * Parses GCC Generic/Template types\n * @see {@link https://github.com/google/closure-compiler/wiki/Generic-Types}\n * @see {@link https://www.typescriptlang.org/docs/handbook/jsdoc-supported-types.html#template}\n * @param {import('comment-parser').Spec} tag\n * @returns {string[]}\n */\nconst parseClosureTemplateTag = (tag) => {\n return tag.name\n .split(',')\n .map((type) => {\n return type.trim().replace(/^\\[?(?<name>.*?)=.*$/v, '$<name>');\n });\n};\n\n/**\n * @typedef {true|string[]} DefaultContexts\n */\n\n/**\n * Checks user option for `contexts` array, defaulting to\n * contexts designated by the rule. Returns an array of\n * ESTree AST types, indicating allowable contexts.\n * @param {import('eslint').Rule.RuleContext} context\n * @param {DefaultContexts|undefined} defaultContexts\n * @param {{\n * contexts?: import('./iterateJsdoc.js').Context[]\n * }} settings\n * @returns {(string|import('./iterateJsdoc.js').ContextObject)[]}\n */\nconst enforcedContexts = (context, defaultContexts, settings) => {\n const contexts = context.options[0]?.contexts || settings.contexts || (defaultContexts === true ? [\n 'ArrowFunctionExpression',\n 'FunctionDeclaration',\n 'FunctionExpression',\n 'TSDeclareFunction',\n ] : defaultContexts);\n\n return contexts;\n};\n\n/**\n * @param {import('./iterateJsdoc.js').Context[]} contexts\n * @param {import('./iterateJsdoc.js').CheckJsdoc} checkJsdoc\n * @param {import('@es-joy/jsdoccomment').CommentHandler} [handler]\n * @returns {import('eslint').Rule.RuleListener}\n */\nconst getContextObject = (contexts, checkJsdoc, handler) => {\n /** @type {import('eslint').Rule.RuleListener} */\n const properties = {};\n\n for (const [\n idx,\n prop,\n ] of contexts.entries()) {\n /** @type {string} */\n let property;\n\n /** @type {(node: import('eslint').Rule.Node) => void} */\n let value;\n\n if (typeof prop === 'object') {\n const selInfo = {\n lastIndex: idx,\n selector: prop.context,\n };\n if (prop.comment) {\n property = /** @type {string} */ (prop.context);\n value = checkJsdoc.bind(\n null,\n {\n ...selInfo,\n comment: prop.comment,\n },\n /**\n * @type {(jsdoc: import('@es-joy/jsdoccomment').JsdocBlockWithInline) => boolean}\n */\n (/** @type {import('@es-joy/jsdoccomment').CommentHandler} */ (\n handler\n ).bind(null, prop.comment)),\n );\n } else {\n property = /** @type {string} */ (prop.context);\n value = checkJsdoc.bind(null, selInfo, null);\n }\n } else {\n const selInfo = {\n lastIndex: idx,\n selector: prop,\n };\n property = prop;\n value = checkJsdoc.bind(null, selInfo, null);\n }\n\n const old = /**\n * @type {((node: import('eslint').Rule.Node) => void)}\n */ (properties[property]);\n properties[property] = old ?\n /**\n * @type {((node: import('eslint').Rule.Node) => void)}\n */\n function (node) {\n old(node);\n value(node);\n } :\n value;\n }\n\n return properties;\n};\n\nconst tagsWithNamesAndDescriptions = new Set([\n 'arg', 'argument', 'param', 'prop', 'property',\n 'return',\n\n // These two are parsed by our custom parser as though having a `name`\n 'returns', 'template',\n]);\n\n/**\n * @typedef {{\n * [key: string]: false|string|\n * {message: string, replacement?: string}\n * }} TagNamePreference\n */\n\n/**\n * @param {import('eslint').Rule.RuleContext} context\n * @param {ParserMode|undefined} mode\n * @param {import('comment-parser').Spec[]} tags\n * @returns {{\n * tagsWithNames: import('comment-parser').Spec[],\n * tagsWithoutNames: import('comment-parser').Spec[]\n * }}\n */\nconst getTagsByType = (context, mode, tags) => {\n /**\n * @type {import('comment-parser').Spec[]}\n */\n const tagsWithoutNames = [];\n const tagsWithNames = tags.filter((tag) => {\n const {\n tag: tagName,\n } = tag;\n const tagWithName = tagsWithNamesAndDescriptions.has(tagName);\n if (!tagWithName) {\n tagsWithoutNames.push(tag);\n }\n\n return tagWithName;\n });\n\n return {\n tagsWithNames,\n tagsWithoutNames,\n };\n};\n\n/**\n * @param {import('eslint').SourceCode|{\n * text: string\n * }} sourceCode\n * @returns {string}\n */\nconst getIndent = (sourceCode) => {\n return (sourceCode.text.match(/^\\n*([ \\t]+)/v)?.[1] ?? '') + ' ';\n};\n\n/**\n * @param {import('eslint').Rule.Node|null} node\n * @returns {boolean}\n */\nconst isConstructor = (node) => {\n return node?.type === 'MethodDefinition' && node.kind === 'constructor' ||\n /** @type {import('@typescript-eslint/types').TSESTree.MethodDefinition} */ (\n node?.parent\n )?.kind === 'constructor';\n};\n\n/**\n * @param {import('eslint').Rule.Node|null} node\n * @returns {boolean}\n */\nconst isGetter = (node) => {\n return node !== null &&\n /**\n * @type {import('@typescript-eslint/types').TSESTree.MethodDefinition|\n * import('@typescript-eslint/types').TSESTree.Property}\n */ (\n node.parent\n )?.kind === 'get';\n};\n\n/**\n * @param {import('eslint').Rule.Node|null} node\n * @returns {boolean}\n */\nconst isSetter = (node) => {\n return node !== null &&\n /**\n * @type {import('@typescript-eslint/types').TSESTree.MethodDefinition|\n * import('@typescript-eslint/types').TSESTree.Property}\n */(\n node.parent\n )?.kind === 'set';\n};\n\n/**\n * @param {import('eslint').Rule.Node} node\n * @returns {boolean}\n */\nconst hasAccessorPair = (node) => {\n const {\n key,\n kind: sourceKind,\n type,\n } =\n /**\n * @type {import('@typescript-eslint/types').TSESTree.MethodDefinition|\n * import('@typescript-eslint/types').TSESTree.Property}\n */ (node);\n\n const sourceName =\n /** @type {import('@typescript-eslint/types').TSESTree.Identifier} */ (\n key\n ).name;\n\n const oppositeKind = sourceKind === 'get' ? 'set' : 'get';\n\n const sibling = type === 'MethodDefinition' ?\n /** @type {import('@typescript-eslint/types').TSESTree.ClassBody} */ (\n node.parent\n ).body :\n /** @type {import('@typescript-eslint/types').TSESTree.ObjectExpression} */ (\n node.parent\n ).properties;\n\n return (\n sibling.some((child) => {\n const {\n key: ky,\n kind,\n } = /**\n * @type {import('@typescript-eslint/types').TSESTree.MethodDefinition|\n * import('@typescript-eslint/types').TSESTree.Property}\n */ (child);\n\n const name =\n /** @type {import('@typescript-eslint/types').TSESTree.Identifier} */ (\n ky\n ).name;\n\n return kind === oppositeKind && name === sourceName;\n })\n );\n};\n\n/**\n * @param {import('./iterateJsdoc.js').JsdocBlockWithInline} jsdoc\n * @param {import('eslint').Rule.Node|null} node\n * @param {import('eslint').Rule.RuleContext} context\n * @param {import('json-schema').JSONSchema4} schema\n * @returns {boolean}\n */\nconst exemptSpeciaMethods = (jsdoc, node, context, schema) => {\n /**\n * @param {\"checkGetters\"|\"checkSetters\"|\"checkConstructors\"} prop\n * @returns {boolean|\"no-setter\"|\"no-getter\"}\n */\n const hasSchemaOption = (prop) => {\n const schemaProperties = schema[0].properties;\n\n return context.options[0]?.[prop] ??\n (schemaProperties[prop] && schemaProperties[prop].default);\n };\n\n const checkGetters = hasSchemaOption('checkGetters');\n const checkSetters = hasSchemaOption('checkSetters');\n\n return !hasSchemaOption('checkConstructors') &&\n (\n isConstructor(node) ||\n hasATag(jsdoc, [\n 'class',\n 'constructor',\n ])) ||\n isGetter(node) && (\n !checkGetters ||\n checkGetters === 'no-setter' && hasAccessorPair(/** @type {import('./iterateJsdoc.js').Node} */ (node).parent)\n ) ||\n isSetter(node) && (\n !checkSetters ||\n checkSetters === 'no-getter' && hasAccessorPair(/** @type {import('./iterateJsdoc.js').Node} */ (node).parent)\n );\n};\n\n/**\n * Since path segments may be unquoted (if matching a reserved word,\n * identifier or numeric literal) or single or double quoted, in either\n * the `@param` or in source, we need to strip the quotes to give a fair\n * comparison.\n * @param {string} str\n * @returns {string}\n */\nconst dropPathSegmentQuotes = (str) => {\n return str.replaceAll(/\\.(['\"])(.*)\\1/gv, '.$2');\n};\n\n/**\n * @param {string} name\n * @returns {(otherPathName: string) => boolean}\n */\nconst comparePaths = (name) => {\n return (otherPathName) => {\n return otherPathName === name ||\n dropPathSegmentQuotes(otherPathName) === dropPathSegmentQuotes(name);\n };\n};\n\n/**\n * @callback PathDoesNotBeginWith\n * @param {string} name\n * @param {string} otherPathName\n * @returns {boolean}\n */\n\n/** @type {PathDoesNotBeginWith} */\nconst pathDoesNotBeginWith = (name, otherPathName) => {\n return !name.startsWith(otherPathName) &&\n !dropPathSegmentQuotes(name).startsWith(dropPathSegmentQuotes(otherPathName));\n};\n\n/**\n * @param {string} regexString\n * @param {string} [requiredFlags]\n * @returns {RegExp}\n */\nconst getRegexFromString = (regexString, requiredFlags) => {\n const match = regexString.match(/^\\/(.*)\\/([gimyvus]*)$/vs);\n let flags = 'v';\n let regex = regexString;\n if (match) {\n [\n , regex,\n flags,\n ] = match;\n if (!flags) {\n flags = 'v';\n }\n }\n\n const uniqueFlags = [\n ...new Set(flags + (requiredFlags || '')),\n ];\n flags = uniqueFlags.join('');\n\n return new RegExp(regex, flags);\n};\n\nexport {\n comparePaths,\n dropPathSegmentQuotes,\n enforcedContexts,\n exemptSpeciaMethods,\n filterTags,\n flattenRoots,\n forEachPreferredTag,\n getAllTags,\n getContextObject,\n getFunctionParameterNames,\n getIndent,\n getJsdocTagsDeep,\n getPreferredTagName,\n getPreferredTagNameSimple,\n getRegexFromString,\n getTagDescription,\n getTags,\n getTagsByType,\n getTagStructureForMode,\n hasATag,\n hasParams,\n\n hasTag,\n hasThrowValue,\n\n hasYieldValue,\n isConstructor,\n isGetter,\n isNamepathDefiningTag,\n isNamepathOrUrlReferencingTag,\n isNamepathReferencingTag,\n isSetter,\n isValidTag,\n mayBeUndefinedTypeTag,\n overrideTagStructure,\n parseClosureTemplateTag,\n pathDoesNotBeginWith,\n setTagStructure,\n tagMightHaveEitherTypeOrNamePosition,\n tagMightHaveNamepath,\n tagMightHaveNamePosition,\n tagMightHaveTypePosition,\n tagMissingRequiredTypeOrNamepath,\n tagMustHaveNamePosition,\n tagMustHaveTypePosition,\n};\nexport {\n hasReturnValue,\n hasValueOrExecutorHasNonEmptyResolveValue,\n} from './utils/hasReturnValue.js';\n"],"mappings":"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"}
1
+ {"version":3,"file":"jsdocUtils.cjs","names":["_getDefaultTagStructureForMode","_interopRequireDefault","require","_tagNames","_WarnSettings","_jsdoccomment","_hasReturnValue","e","__esModule","default","tagStructure","setTagStructure","mode","getDefaultTagStructureForMode","exports","flattenRoots","params","root","hasRestElement","hasPropertyRest","rests","names","reduce","acc","cur","Array","isArray","nms","flattened","inner","filter","Boolean","push","concat","isRestProperty","restElement","String","name","getPropertiesFromPropertySignature","propSignature","type","undefined","typeAnnotation","key","members","map","member","getFunctionParameterNames","functionNode","checkDefaultObjects","getParamName","param","isProperty","hasLeftTypeAnnotation","left","propertyNames","annotationParamName","hasLeftName","properties","roots","prop","value","elements","idx","right","raw","includes","argument","parameter","Error","hasParams","length","getJsdocTagsDeep","jsdoc","targetTagName","ret","tag","tags","entries","modeWarnSettings","WarnSettings","getTagNamesForMode","context","closureTags","jsdocTags","typeScriptTags","hasBeenWarned","report","loc","end","column","line","start","message","markSettingAsWarned","getTagDescription","tg","returnArray","descriptions","source","some","tokens","description","lineEnd","postDelimiter","postTag","desc","slice","join","getPreferredTagNameSimple","tagPreference","prefValues","Object","values","prefVal","replacement","tagPreferenceFixed","fromEntries","replace","hasOwn","tagNames","preferredTagName","find","aliases","isValidTag","definedTags","validTagNames","keys","flat","additionalTags","allTags","hasTag","targetTagLower","toLowerCase","doc","filterTags","getTags","tagName","item","getPreferredTagName","allowObjectReturn","defaultMessage","skipReportingBlockedTag","tagNamePreference","isObject","blocked","forEachPreferredTag","arrayHandler","matchingJsdocTags","matchingJsdocTag","getAllTags","inlineTags","inlineTag","flatMap","tagBegins","number","hasATag","targetTagNames","mayBeUndefinedTypeTag","tagType","trim","parsedTypes","tryParse","elem","ensureMap","has","set","Map","get","overrideTagStructure","structuredTags","tagMap","required","tagStruct","requiredName","requiredType","typeOrNameRequired","getTagStructureForMode","isNamepathDefiningTag","isNamepathReferencingTag","isNamepathOrUrlReferencingTag","tagMustHaveTypePosition","tagMightHaveTypePosition","namepathTypes","Set","tagMightHaveNamePosition","tagMightHaveNamepath","nampathRole","tagMustHaveNamePosition","tagMightHaveEitherTypeOrNamePosition","tagMustHaveEitherTypeOrNamePosition","tagMissingRequiredTypeOrNamepath","mustHaveTypePosition","mightHaveTypePosition","hasTypePosition","hasNameOrNamepathPosition","mustHaveEither","hasEither","hasNonFunctionYield","node","checkYieldReturnValue","element","body","bodyNode","arguments","expression","computed","test","consequent","alternate","object","property","nde","expressions","subExpression","cases","someCase","quasi","block","handler","finalizer","declarations","id","init","parent","hasYieldValue","generator","hasThrowValue","innerFunction","async","parseClosureTemplateTag","split","enforcedContexts","defaultContexts","settings","contexts","options","getContextObject","checkJsdoc","selInfo","lastIndex","selector","comment","bind","old","tagsWithNamesAndDescriptions","getTagsByType","tagsWithoutNames","tagsWithNames","tagWithName","getIndent","sourceCode","text","match","isConstructor","kind","isGetter","isSetter","hasAccessorPair","sourceKind","sourceName","oppositeKind","sibling","child","ky","exemptSpeciaMethods","schema","hasSchemaOption","schemaProperties","checkGetters","checkSetters","dropPathSegmentQuotes","str","replaceAll","comparePaths","otherPathName","pathDoesNotBeginWith","startsWith","getRegexFromString","regexString","requiredFlags","flags","regex","uniqueFlags","RegExp"],"sources":["../src/jsdocUtils.js"],"sourcesContent":["import getDefaultTagStructureForMode from './getDefaultTagStructureForMode.js';\nimport {\n closureTags,\n jsdocTags,\n typeScriptTags,\n} from './tagNames.js';\nimport WarnSettings from './WarnSettings.js';\nimport {\n tryParse,\n} from '@es-joy/jsdoccomment';\n\n/**\n * @typedef {number} Integer\n */\n/**\n * @typedef {import('./utils/hasReturnValue.js').ESTreeOrTypeScriptNode} ESTreeOrTypeScriptNode\n */\n\n/**\n * @typedef {\"jsdoc\"|\"typescript\"|\"closure\"|\"permissive\"} ParserMode\n */\n\n/**\n * @type {import('./getDefaultTagStructureForMode.js').TagStructure}\n */\nlet tagStructure;\n\n/**\n * @param {ParserMode} mode\n * @returns {void}\n */\nconst setTagStructure = (mode) => {\n tagStructure = getDefaultTagStructureForMode(mode);\n};\n\n/**\n * @typedef {undefined|string|{\n * name: Integer,\n * restElement: boolean\n * }|{\n * isRestProperty: boolean|undefined,\n * name: string,\n * restElement: boolean\n * }|{\n * name: string,\n * restElement: boolean\n * }} ParamCommon\n */\n/**\n * @typedef {ParamCommon|[string|undefined, (FlattendRootInfo & {\n * annotationParamName?: string,\n * })]|NestedParamInfo} ParamNameInfo\n */\n\n/**\n * @typedef {{\n * hasPropertyRest: boolean,\n * hasRestElement: boolean,\n * names: string[],\n * rests: boolean[],\n * }} FlattendRootInfo\n */\n/**\n * @typedef {[string, (string[]|ParamInfo[])]} NestedParamInfo\n */\n/**\n * @typedef {ParamCommon|\n * [string|undefined, (FlattendRootInfo & {\n * annotationParamName?: string\n * })]|\n * NestedParamInfo} ParamInfo\n */\n\n/**\n * Given a nested array of property names, reduce them to a single array,\n * appending the name of the root element along the way if present.\n * @callback FlattenRoots\n * @param {ParamInfo[]} params\n * @param {string} [root]\n * @returns {FlattendRootInfo}\n */\n\n/** @type {FlattenRoots} */\nconst flattenRoots = (params, root = '') => {\n let hasRestElement = false;\n let hasPropertyRest = false;\n\n /**\n * @type {boolean[]}\n */\n const rests = [];\n\n const names = params.reduce(\n /**\n * @param {string[]} acc\n * @param {ParamInfo} cur\n * @returns {string[]}\n */\n (acc, cur) => {\n if (Array.isArray(cur)) {\n let nms;\n if (Array.isArray(cur[1])) {\n nms = cur[1];\n } else {\n if (cur[1].hasRestElement) {\n hasRestElement = true;\n }\n\n if (cur[1].hasPropertyRest) {\n hasPropertyRest = true;\n }\n\n nms = cur[1].names;\n }\n\n const flattened = flattenRoots(nms, root ? `${root}.${cur[0]}` : cur[0]);\n if (flattened.hasRestElement) {\n hasRestElement = true;\n }\n\n if (flattened.hasPropertyRest) {\n hasPropertyRest = true;\n }\n\n const inner = /** @type {string[]} */ ([\n root ? `${root}.${cur[0]}` : cur[0],\n ...flattened.names,\n ].filter(Boolean));\n rests.push(false, ...flattened.rests);\n\n return acc.concat(inner);\n }\n\n if (typeof cur === 'object') {\n if ('isRestProperty' in cur && cur.isRestProperty) {\n hasPropertyRest = true;\n rests.push(true);\n } else {\n rests.push(false);\n }\n\n if ('restElement' in cur && cur.restElement) {\n hasRestElement = true;\n }\n\n acc.push(root ? `${root}.${String(cur.name)}` : String(cur.name));\n } else if (typeof cur !== 'undefined') {\n rests.push(false);\n acc.push(root ? `${root}.${cur}` : cur);\n }\n\n return acc;\n }, [],\n );\n\n return {\n hasPropertyRest,\n hasRestElement,\n names,\n rests,\n };\n};\n\n/**\n * @param {import('@typescript-eslint/types').TSESTree.TSIndexSignature|\n * import('@typescript-eslint/types').TSESTree.TSConstructSignatureDeclaration|\n * import('@typescript-eslint/types').TSESTree.TSCallSignatureDeclaration|\n * import('@typescript-eslint/types').TSESTree.TSPropertySignature} propSignature\n * @returns {undefined|string|[string, string[]]}\n */\nconst getPropertiesFromPropertySignature = (propSignature) => {\n if (\n propSignature.type === 'TSIndexSignature' ||\n propSignature.type === 'TSConstructSignatureDeclaration' ||\n propSignature.type === 'TSCallSignatureDeclaration'\n ) {\n return undefined;\n }\n\n if (propSignature.typeAnnotation && propSignature.typeAnnotation.typeAnnotation.type === 'TSTypeLiteral') {\n return [\n /** @type {import('@typescript-eslint/types').TSESTree.Identifier} */ (\n propSignature.key\n ).name,\n propSignature.typeAnnotation.typeAnnotation.members.map((member) => {\n return /** @type {string} */ (\n getPropertiesFromPropertySignature(\n /** @type {import('@typescript-eslint/types').TSESTree.TSPropertySignature} */ (\n member\n ),\n )\n );\n }),\n ];\n }\n\n return /** @type {import('@typescript-eslint/types').TSESTree.Identifier} */ (\n propSignature.key\n ).name;\n};\n\n/**\n * @param {ESTreeOrTypeScriptNode|null} functionNode\n * @param {boolean} [checkDefaultObjects]\n * @throws {Error}\n * @returns {ParamNameInfo[]}\n */\nconst getFunctionParameterNames = (\n functionNode, checkDefaultObjects,\n) => {\n /* eslint-disable complexity -- Temporary */\n /**\n * @param {import('estree').Identifier|import('estree').AssignmentPattern|\n * import('estree').ObjectPattern|import('estree').Property|\n * import('estree').RestElement|import('estree').ArrayPattern|\n * import('@typescript-eslint/types').TSESTree.TSParameterProperty|\n * import('@typescript-eslint/types').TSESTree.Property|\n * import('@typescript-eslint/types').TSESTree.RestElement|\n * import('@typescript-eslint/types').TSESTree.Identifier|\n * import('@typescript-eslint/types').TSESTree.ObjectPattern|\n * import('@typescript-eslint/types').TSESTree.BindingName|\n * import('@typescript-eslint/types').TSESTree.Parameter\n * } param\n * @param {boolean} [isProperty]\n * @returns {ParamNameInfo|[string, ParamNameInfo[]]}\n */\n const getParamName = (param, isProperty) => {\n /* eslint-enable complexity -- Temporary */\n const hasLeftTypeAnnotation = 'left' in param && 'typeAnnotation' in param.left;\n\n if ('typeAnnotation' in param || hasLeftTypeAnnotation) {\n const typeAnnotation = hasLeftTypeAnnotation ?\n /** @type {import('@typescript-eslint/types').TSESTree.Identifier} */ (\n param.left\n ).typeAnnotation :\n /** @type {import('@typescript-eslint/types').TSESTree.Identifier|import('@typescript-eslint/types').TSESTree.ObjectPattern} */\n (param).typeAnnotation;\n\n if (typeAnnotation?.typeAnnotation?.type === 'TSTypeLiteral') {\n const propertyNames = typeAnnotation.typeAnnotation.members.map((member) => {\n return getPropertiesFromPropertySignature(\n /** @type {import('@typescript-eslint/types').TSESTree.TSPropertySignature} */\n (member),\n );\n });\n\n const flattened = {\n ...flattenRoots(propertyNames),\n annotationParamName: 'name' in param ? param.name : undefined,\n };\n const hasLeftName = 'left' in param && 'name' in param.left;\n\n if ('name' in param || hasLeftName) {\n return [\n hasLeftName ?\n /** @type {import('@typescript-eslint/types').TSESTree.Identifier} */ (\n param.left\n ).name :\n /** @type {import('@typescript-eslint/types').TSESTree.Identifier} */ (\n param\n ).name,\n flattened,\n ];\n }\n\n return [\n undefined, flattened,\n ];\n }\n }\n\n if ('name' in param) {\n return param.name;\n }\n\n if ('left' in param && 'name' in param.left) {\n return param.left.name;\n }\n\n if (\n param.type === 'ObjectPattern' ||\n ('left' in param &&\n (\n param\n ).left.type === 'ObjectPattern')\n ) {\n const properties = /** @type {import('@typescript-eslint/types').TSESTree.ObjectPattern} */ (\n param\n ).properties ||\n /** @type {import('estree').ObjectPattern} */\n (\n /** @type {import('@typescript-eslint/types').TSESTree.AssignmentPattern} */ (\n param\n ).left\n )?.properties;\n const roots = properties.map((prop) => {\n return getParamName(prop, true);\n });\n\n return [\n undefined, flattenRoots(roots),\n ];\n }\n\n if (param.type === 'Property') {\n switch (param.value.type) {\n case 'ArrayPattern': {\n return [\n /** @type {import('estree').Identifier} */\n (param.key).name,\n /** @type {import('estree').ArrayPattern} */ (\n param.value\n ).elements.map((prop, idx) => {\n return {\n name: idx,\n restElement: prop?.type === 'RestElement',\n };\n }),\n ];\n }\n\n case 'ObjectPattern': {\n return [\n /** @type {import('estree').Identifier} */ (param.key).name,\n /** @type {import('estree').ObjectPattern} */ (\n param.value\n ).properties.map((prop) => {\n return /** @type {string|[string, string[]]} */ (getParamName(prop, isProperty));\n }),\n ];\n }\n\n case 'AssignmentPattern': {\n switch (param.value.left.type) {\n case 'ArrayPattern':\n return [\n /** @type {import('estree').Identifier} */\n (param.key).name,\n /** @type {import('estree').ArrayPattern} */ (\n param.value.left\n ).elements.map((prop, idx) => {\n return {\n name: idx,\n restElement: prop?.type === 'RestElement',\n };\n }),\n ];\n case 'Identifier':\n // Default parameter\n if (checkDefaultObjects && param.value.right.type === 'ObjectExpression') {\n return [\n /** @type {import('estree').Identifier} */ (\n param.key\n ).name,\n /** @type {import('estree').AssignmentPattern} */ (\n param.value\n ).right.properties.map((prop) => {\n return /** @type {string} */ (getParamName(\n /** @type {import('estree').Property} */\n (prop),\n isProperty,\n ));\n }),\n ];\n }\n\n break;\n case 'ObjectPattern':\n return [\n /** @type {import('estree').Identifier} */\n (param.key).name,\n /** @type {import('estree').ObjectPattern} */ (\n param.value.left\n ).properties.map((prop) => {\n return getParamName(prop, isProperty);\n }),\n ];\n }\n }\n }\n\n switch (param.key.type) {\n case 'Identifier':\n return param.key.name;\n\n // The key of an object could also be a string or number\n case 'Literal':\n /* c8 ignore next 2 -- `raw` may not be present in all parsers */\n return /** @type {string} */ (param.key.raw ||\n param.key.value);\n\n // case 'MemberExpression':\n default:\n // Todo: We should really create a structure (and a corresponding\n // option analogous to `checkRestProperty`) which allows for\n // (and optionally requires) dynamic properties to have a single\n // line of documentation\n return undefined;\n }\n }\n\n if (\n param.type === 'ArrayPattern' ||\n /** @type {import('estree').AssignmentPattern} */ (\n param\n ).left?.type === 'ArrayPattern'\n ) {\n const elements = /** @type {import('estree').ArrayPattern} */ (\n param\n ).elements || /** @type {import('estree').ArrayPattern} */ (\n /** @type {import('estree').AssignmentPattern} */ (\n param\n ).left\n )?.elements;\n const roots = elements.map((prop, idx) => {\n return {\n name: `\"${idx}\"`,\n restElement: prop?.type === 'RestElement',\n };\n });\n\n return [\n undefined, flattenRoots(roots),\n ];\n }\n\n if ([\n 'ExperimentalRestProperty', 'RestElement',\n ].includes(param.type)) {\n return {\n isRestProperty: isProperty,\n name: /** @type {import('@typescript-eslint/types').TSESTree.Identifier} */ (\n /** @type {import('@typescript-eslint/types').TSESTree.RestElement} */ (\n param\n // @ts-expect-error Ok\n ).argument).name ?? param?.argument?.elements?.map(({\n // @ts-expect-error Ok\n name,\n }) => {\n return name;\n }),\n restElement: true,\n };\n }\n\n if (param.type === 'TSParameterProperty') {\n return getParamName(\n /** @type {import('@typescript-eslint/types').TSESTree.Identifier} */ (\n /** @type {import('@typescript-eslint/types').TSESTree.TSParameterProperty} */ (\n param\n ).parameter\n ),\n true,\n );\n }\n\n throw new Error(`Unsupported function signature format: \\`${param.type}\\`.`);\n };\n\n if (!functionNode) {\n return [];\n }\n\n return (/** @type {import('@typescript-eslint/types').TSESTree.FunctionDeclaration} */ (\n functionNode\n ).params || /** @type {import('@typescript-eslint/types').TSESTree.MethodDefinition} */ (\n functionNode\n ).value?.params || []).map((param) => {\n return getParamName(param);\n });\n};\n\n/**\n * @param {ESTreeOrTypeScriptNode} functionNode\n * @returns {Integer}\n */\nconst hasParams = (functionNode) => {\n // Should also check `functionNode.value.params` if supporting `MethodDefinition`\n return /** @type {import('@typescript-eslint/types').TSESTree.FunctionDeclaration} */ (\n functionNode\n ).params.length;\n};\n\n/**\n * Gets all names of the target type, including those that refer to a path, e.g.\n * `foo` or `foo.bar`.\n * @param {import('comment-parser').Block} jsdoc\n * @param {string} targetTagName\n * @returns {{\n * idx: Integer,\n * name: string,\n * type: string\n * }[]}\n */\nconst getJsdocTagsDeep = (jsdoc, targetTagName) => {\n const ret = [];\n for (const [\n idx,\n {\n name,\n tag,\n type,\n },\n ] of jsdoc.tags.entries()) {\n if (tag !== targetTagName) {\n continue;\n }\n\n ret.push({\n idx,\n name,\n type,\n });\n }\n\n return ret;\n};\n\nconst modeWarnSettings = WarnSettings();\n\n/**\n * @param {ParserMode|undefined} mode\n * @param {Reporter} context\n * @returns {import('./tagNames.js').AliasedTags}\n */\nconst getTagNamesForMode = (mode, context) => {\n switch (mode) {\n case 'closure':\n case 'permissive':\n return closureTags;\n case 'jsdoc':\n return jsdocTags; case 'typescript':\n return typeScriptTags;\n default:\n if (!modeWarnSettings.hasBeenWarned(context, 'mode')) {\n context.report({\n loc: {\n end: {\n column: 1,\n line: 1,\n },\n start: {\n column: 1,\n line: 1,\n },\n },\n message: `Unrecognized value \\`${mode}\\` for \\`settings.jsdoc.mode\\`.`,\n });\n modeWarnSettings.markSettingAsWarned(context, 'mode');\n }\n\n // We'll avoid breaking too many other rules\n return jsdocTags;\n }\n};\n\n/**\n * @param {import('comment-parser').Spec} tg\n * @param {boolean} [returnArray]\n * @returns {string[]|string}\n */\nconst getTagDescription = (tg, returnArray) => {\n /**\n * @type {string[]}\n */\n const descriptions = [];\n tg.source.some(({\n tokens: {\n description,\n end,\n lineEnd,\n name,\n postDelimiter,\n postTag,\n tag,\n type,\n },\n }) => {\n const desc = (\n tag && postTag ||\n !tag && !name && !type && postDelimiter || ''\n\n // Remove space\n ).slice(1) +\n (description || '') + (lineEnd || '');\n\n if (end) {\n if (desc) {\n descriptions.push(desc);\n }\n\n return true;\n }\n\n descriptions.push(desc);\n\n return false;\n });\n\n return returnArray ? descriptions : descriptions.join('\\n');\n};\n\n/**\n * @typedef {{\n * report: (descriptor: import('eslint').Rule.ReportDescriptor) => void\n * }} Reporter\n */\n\n/**\n * @param {string} name\n * @param {ParserMode|undefined} mode\n * @param {TagNamePreference} tagPreference\n * @param {Reporter} context\n * @returns {string|false|{\n * message: string;\n * replacement?: string|undefined;\n * }}\n */\nconst getPreferredTagNameSimple = (\n name,\n mode,\n tagPreference = {},\n // eslint-disable-next-line unicorn/no-object-as-default-parameter -- Ok\n context = {\n report () {\n // No-op\n },\n },\n) => {\n const prefValues = Object.values(tagPreference);\n if (prefValues.includes(name) || prefValues.some((prefVal) => {\n return prefVal && typeof prefVal === 'object' && prefVal.replacement === name;\n })) {\n return name;\n }\n\n // Allow keys to have a 'tag ' prefix to avoid upstream bug in ESLint\n // that disallows keys that conflict with Object.prototype,\n // e.g. 'tag constructor' for 'constructor':\n // https://github.com/eslint/eslint/issues/13289\n // https://github.com/gajus/eslint-plugin-jsdoc/issues/537\n const tagPreferenceFixed = Object.fromEntries(\n Object\n .entries(tagPreference)\n .map(([\n key,\n value,\n ]) => {\n return [\n key.replace(/^tag /v, ''), value,\n ];\n }),\n );\n\n if (Object.hasOwn(tagPreferenceFixed, name)) {\n return tagPreferenceFixed[name];\n }\n\n const tagNames = getTagNamesForMode(mode, context);\n\n const preferredTagName = Object.entries(tagNames).find(([\n , aliases,\n ]) => {\n return aliases.includes(name);\n })?.[0];\n if (preferredTagName) {\n return preferredTagName;\n }\n\n return name;\n};\n\n/**\n * @param {import('eslint').Rule.RuleContext} context\n * @param {ParserMode|undefined} mode\n * @param {string} name\n * @param {string[]} definedTags\n * @returns {boolean}\n */\nconst isValidTag = (\n context,\n mode,\n name,\n definedTags,\n) => {\n const tagNames = getTagNamesForMode(mode, context);\n\n const validTagNames = Object.keys(tagNames).concat(Object.values(tagNames).flat());\n const additionalTags = definedTags;\n const allTags = validTagNames.concat(additionalTags);\n\n return allTags.includes(name);\n};\n\n/**\n * @param {import('./iterateJsdoc.js').JsdocBlockWithInline} jsdoc\n * @param {string} targetTagName\n * @returns {boolean}\n */\nconst hasTag = (jsdoc, targetTagName) => {\n const targetTagLower = targetTagName.toLowerCase();\n\n return jsdoc.tags.some((doc) => {\n return doc.tag.toLowerCase() === targetTagLower;\n });\n};\n\n/**\n * @param {import('./iterateJsdoc.js').JsdocBlockWithInline} jsdoc\n * @param {(tag: import('@es-joy/jsdoccomment').JsdocTagWithInline) => boolean} filter\n * @returns {import('@es-joy/jsdoccomment').JsdocTagWithInline[]}\n */\nconst filterTags = (jsdoc, filter) => {\n return jsdoc.tags.filter((tag) => {\n return filter(tag);\n });\n};\n\n/**\n * @param {import('./iterateJsdoc.js').JsdocBlockWithInline} jsdoc\n * @param {string} tagName\n * @returns {import('comment-parser').Spec[]}\n */\nconst getTags = (jsdoc, tagName) => {\n return filterTags(jsdoc, (item) => {\n return item.tag === tagName;\n });\n};\n\n/**\n * @param {import('./iterateJsdoc.js').JsdocBlockWithInline} jsdoc\n * @param {{\n * tagName: string,\n * context?: import('eslint').Rule.RuleContext,\n * mode?: ParserMode,\n * report?: import('./iterateJsdoc.js').Report\n * tagNamePreference?: TagNamePreference\n * skipReportingBlockedTag?: boolean,\n * allowObjectReturn?: boolean,\n * defaultMessage?: string,\n * }} cfg\n * @returns {string|undefined|false|{\n * message: string;\n * replacement?: string|undefined;\n * }|{\n * blocked: true,\n * tagName: string\n * }}\n */\nconst getPreferredTagName = (jsdoc, {\n allowObjectReturn = false,\n context,\n tagName,\n defaultMessage = `Unexpected tag \\`@${tagName}\\``,\n mode,\n report = () => {},\n skipReportingBlockedTag = false,\n tagNamePreference,\n}) => {\n const ret = getPreferredTagNameSimple(tagName, mode, tagNamePreference, context);\n const isObject = ret && typeof ret === 'object';\n if (hasTag(jsdoc, tagName) && (ret === false || isObject && !ret.replacement)) {\n if (skipReportingBlockedTag) {\n return {\n blocked: true,\n tagName,\n };\n }\n\n const message = isObject && ret.message || defaultMessage;\n report(message, null, getTags(jsdoc, tagName)[0]);\n\n return false;\n }\n\n return isObject && !allowObjectReturn ? ret.replacement : ret;\n};\n\n/**\n * @param {import('./iterateJsdoc.js').JsdocBlockWithInline} jsdoc\n * @param {string} tagName\n * @param {(\n * matchingJsdocTag: import('@es-joy/jsdoccomment').JsdocTagWithInline,\n * targetTagName: string\n * ) => void} arrayHandler\n * @param {object} cfg\n * @param {import('eslint').Rule.RuleContext} [cfg.context]\n * @param {ParserMode} [cfg.mode]\n * @param {import('./iterateJsdoc.js').Report} [cfg.report]\n * @param {TagNamePreference} [cfg.tagNamePreference]\n * @param {boolean} [cfg.skipReportingBlockedTag]\n * @returns {void}\n */\nconst forEachPreferredTag = (\n jsdoc, tagName, arrayHandler,\n {\n context,\n mode,\n report,\n skipReportingBlockedTag = false,\n tagNamePreference,\n } = {},\n) => {\n const targetTagName = /** @type {string|false} */ (\n getPreferredTagName(jsdoc, {\n context,\n mode,\n report,\n skipReportingBlockedTag,\n tagName,\n tagNamePreference,\n })\n );\n if (!targetTagName ||\n skipReportingBlockedTag && targetTagName && typeof targetTagName === 'object'\n ) {\n return;\n }\n\n const matchingJsdocTags = jsdoc.tags.filter(({\n tag,\n }) => {\n return tag === targetTagName;\n });\n\n for (const matchingJsdocTag of matchingJsdocTags) {\n arrayHandler(\n /**\n * @type {import('@es-joy/jsdoccomment').JsdocTagWithInline}\n */ (\n matchingJsdocTag\n ), targetTagName,\n );\n }\n};\n\n/**\n * Get all tags, inline tags and inline tags in tags\n * @param {import('./iterateJsdoc.js').JsdocBlockWithInline} jsdoc\n * @returns {(import('comment-parser').Spec|\n * import('@es-joy/jsdoccomment').JsdocInlineTagNoType)[]}\n */\nconst getAllTags = (jsdoc) => {\n return [\n ...jsdoc.tags,\n ...jsdoc.inlineTags.map((inlineTag) => {\n // Tags don't have source or line numbers, so add before returning\n let line = -1;\n for (const {\n tokens: {\n description,\n },\n } of jsdoc.source) {\n line++;\n if (description && description.includes(`{@${inlineTag.tag}`)) {\n break;\n }\n }\n\n inlineTag.line = line;\n\n return inlineTag;\n }),\n ...jsdoc.tags.flatMap((tag) => {\n let tagBegins = -1;\n for (const {\n tokens: {\n tag: tg,\n },\n } of jsdoc.source) {\n tagBegins++;\n if (tg) {\n break;\n }\n }\n\n for (const inlineTag of tag.inlineTags) {\n /** @type {import('./iterateJsdoc.js').Integer} */\n let line = 0;\n for (const {\n number,\n tokens: {\n description,\n },\n } of tag.source) {\n if (description && description.includes(`{@${inlineTag.tag}`)) {\n line = number;\n break;\n }\n }\n\n inlineTag.line = tagBegins + line - 1;\n }\n\n return (\n /**\n * @type {import('comment-parser').Spec & {\n * inlineTags: import('@es-joy/jsdoccomment').JsdocInlineTagNoType[]\n * }}\n */ (\n tag\n ).inlineTags\n );\n }),\n ];\n};\n\n/**\n * @param {import('./iterateJsdoc.js').JsdocBlockWithInline} jsdoc\n * @param {string[]} targetTagNames\n * @returns {boolean}\n */\nconst hasATag = (jsdoc, targetTagNames) => {\n return targetTagNames.some((targetTagName) => {\n return hasTag(jsdoc, targetTagName);\n });\n};\n\n/**\n * Checks if the JSDoc comment has an undefined type.\n * @param {import('comment-parser').Spec|null|undefined} tag\n * the tag which should be checked.\n * @param {ParserMode} mode\n * @returns {boolean}\n * true in case a defined type is undeclared; otherwise false.\n */\nconst mayBeUndefinedTypeTag = (tag, mode) => {\n // The function should not continue in the event the type is not defined...\n if (typeof tag === 'undefined' || tag === null) {\n return true;\n }\n\n // .. same applies if it declares an `{undefined}` or `{void}` type\n const tagType = tag.type.trim();\n\n // Exit early if matching\n if (\n tagType === 'undefined' || tagType === 'void' ||\n tagType === '*' || tagType === 'any'\n ) {\n return true;\n }\n\n let parsedTypes;\n try {\n parsedTypes = tryParse(\n tagType,\n mode === 'permissive' ? undefined : [\n mode,\n ],\n );\n } catch {\n // Ignore\n }\n\n if (\n // We do not traverse deeply as it could be, e.g., `Promise<void>`\n parsedTypes &&\n parsedTypes.type === 'JsdocTypeUnion' &&\n parsedTypes.elements.find((elem) => {\n return elem.type === 'JsdocTypeUndefined' ||\n elem.type === 'JsdocTypeName' && elem.value === 'void';\n })) {\n return true;\n }\n\n // In any other case, a type is present\n return false;\n};\n\n/**\n * @param {import('./getDefaultTagStructureForMode.js').TagStructure} map\n * @param {string} tag\n * @returns {Map<string, string|string[]|boolean|undefined>}\n */\nconst ensureMap = (map, tag) => {\n if (!map.has(tag)) {\n map.set(tag, new Map());\n }\n\n return /** @type {Map<string, string | boolean>} */ (map.get(tag));\n};\n\n/**\n * @param {import('./iterateJsdoc.js').StructuredTags} structuredTags\n * @param {import('./getDefaultTagStructureForMode.js').TagStructure} tagMap\n * @returns {void}\n */\nconst overrideTagStructure = (structuredTags, tagMap = tagStructure) => {\n for (const [\n tag,\n {\n name,\n required = [],\n type,\n },\n ] of Object.entries(structuredTags)) {\n const tagStruct = ensureMap(tagMap, tag);\n\n tagStruct.set('namepathRole', name);\n tagStruct.set('typeAllowed', type);\n\n const requiredName = required.includes('name');\n if (requiredName && name === false) {\n throw new Error('Cannot add \"name\" to `require` with the tag\\'s `name` set to `false`');\n }\n\n tagStruct.set('nameRequired', requiredName);\n\n const requiredType = required.includes('type');\n if (requiredType && type === false) {\n throw new Error('Cannot add \"type\" to `require` with the tag\\'s `type` set to `false`');\n }\n\n tagStruct.set('typeRequired', requiredType);\n\n const typeOrNameRequired = required.includes('typeOrNameRequired');\n if (typeOrNameRequired && name === false) {\n throw new Error('Cannot add \"typeOrNameRequired\" to `require` with the tag\\'s `name` set to `false`');\n }\n\n if (typeOrNameRequired && type === false) {\n throw new Error('Cannot add \"typeOrNameRequired\" to `require` with the tag\\'s `type` set to `false`');\n }\n\n tagStruct.set('typeOrNameRequired', typeOrNameRequired);\n }\n};\n\n/**\n * @param {ParserMode} mode\n * @param {import('./iterateJsdoc.js').StructuredTags} structuredTags\n * @returns {import('./getDefaultTagStructureForMode.js').TagStructure}\n */\nconst getTagStructureForMode = (mode, structuredTags) => {\n const tagStruct = getDefaultTagStructureForMode(mode);\n\n try {\n overrideTagStructure(structuredTags, tagStruct);\n /* c8 ignore next 3 */\n } catch {\n //\n }\n\n return tagStruct;\n};\n\n/**\n * @param {string} tag\n * @param {import('./getDefaultTagStructureForMode.js').TagStructure} tagMap\n * @returns {boolean}\n */\nconst isNamepathDefiningTag = (tag, tagMap = tagStructure) => {\n const tagStruct = ensureMap(tagMap, tag);\n\n return tagStruct.get('namepathRole') === 'namepath-defining';\n};\n\n/**\n * @param {string} tag\n * @param {import('./getDefaultTagStructureForMode.js').TagStructure} tagMap\n * @returns {boolean}\n */\nconst isNamepathReferencingTag = (tag, tagMap = tagStructure) => {\n const tagStruct = ensureMap(tagMap, tag);\n return tagStruct.get('namepathRole') === 'namepath-referencing';\n};\n\n/**\n * @param {string} tag\n * @param {import('./getDefaultTagStructureForMode.js').TagStructure} tagMap\n * @returns {boolean}\n */\nconst isNamepathOrUrlReferencingTag = (tag, tagMap = tagStructure) => {\n const tagStruct = ensureMap(tagMap, tag);\n return tagStruct.get('namepathRole') === 'namepath-or-url-referencing';\n};\n\n/**\n * @param {string} tag\n * @param {import('./getDefaultTagStructureForMode.js').TagStructure} tagMap\n * @returns {boolean|undefined}\n */\nconst tagMustHaveTypePosition = (tag, tagMap = tagStructure) => {\n const tagStruct = ensureMap(tagMap, tag);\n\n return /** @type {boolean|undefined} */ (tagStruct.get('typeRequired'));\n};\n\n/**\n * @param {string} tag\n * @param {import('./getDefaultTagStructureForMode.js').TagStructure} tagMap\n * @returns {boolean|string}\n */\nconst tagMightHaveTypePosition = (tag, tagMap = tagStructure) => {\n if (tagMustHaveTypePosition(tag, tagMap)) {\n return true;\n }\n\n const tagStruct = ensureMap(tagMap, tag);\n\n const ret = /** @type {boolean|undefined} */ (tagStruct.get('typeAllowed'));\n\n return ret === undefined ? true : ret;\n};\n\nconst namepathTypes = new Set([\n 'namepath-defining', 'namepath-referencing',\n]);\n\n/**\n * @param {string} tag\n * @param {import('./getDefaultTagStructureForMode.js').TagStructure} tagMap\n * @returns {boolean}\n */\nconst tagMightHaveNamePosition = (tag, tagMap = tagStructure) => {\n const tagStruct = ensureMap(tagMap, tag);\n\n const ret = tagStruct.get('namepathRole');\n\n return ret === undefined ? true : Boolean(ret);\n};\n\n/**\n * @param {string} tag\n * @param {import('./getDefaultTagStructureForMode.js').TagStructure} tagMap\n * @returns {boolean}\n */\nconst tagMightHaveNamepath = (tag, tagMap = tagStructure) => {\n const tagStruct = ensureMap(tagMap, tag);\n\n const nampathRole = tagStruct.get('namepathRole');\n\n return nampathRole !== false &&\n namepathTypes.has(/** @type {string} */ (nampathRole));\n};\n\n/**\n * @param {string} tag\n * @param {import('./getDefaultTagStructureForMode.js').TagStructure} tagMap\n * @returns {boolean|undefined}\n */\nconst tagMustHaveNamePosition = (tag, tagMap = tagStructure) => {\n const tagStruct = ensureMap(tagMap, tag);\n\n return /** @type {boolean|undefined} */ (tagStruct.get('nameRequired'));\n};\n\n/**\n * @param {string} tag\n * @param {import('./getDefaultTagStructureForMode.js').TagStructure} tagMap\n * @returns {boolean}\n */\nconst tagMightHaveEitherTypeOrNamePosition = (tag, tagMap) => {\n return Boolean(tagMightHaveTypePosition(tag, tagMap)) || tagMightHaveNamepath(tag, tagMap);\n};\n\n/**\n * @param {string} tag\n * @param {import('./getDefaultTagStructureForMode.js').TagStructure} tagMap\n * @returns {boolean|undefined}\n */\nconst tagMustHaveEitherTypeOrNamePosition = (tag, tagMap) => {\n const tagStruct = ensureMap(tagMap, tag);\n\n return /** @type {boolean} */ (tagStruct.get('typeOrNameRequired'));\n};\n\n/**\n * @param {import('comment-parser').Spec} tag\n * @param {import('./getDefaultTagStructureForMode.js').TagStructure} tagMap\n * @returns {boolean|undefined}\n */\nconst tagMissingRequiredTypeOrNamepath = (tag, tagMap = tagStructure) => {\n const mustHaveTypePosition = tagMustHaveTypePosition(tag.tag, tagMap);\n const mightHaveTypePosition = tagMightHaveTypePosition(tag.tag, tagMap);\n const hasTypePosition = mightHaveTypePosition && Boolean(tag.type);\n const hasNameOrNamepathPosition = (\n tagMustHaveNamePosition(tag.tag, tagMap) ||\n tagMightHaveNamepath(tag.tag, tagMap)\n ) && Boolean(tag.name);\n const mustHaveEither = tagMustHaveEitherTypeOrNamePosition(tag.tag, tagMap);\n const hasEither = tagMightHaveEitherTypeOrNamePosition(tag.tag, tagMap) &&\n (hasTypePosition || hasNameOrNamepathPosition);\n\n return mustHaveEither && !hasEither && !mustHaveTypePosition;\n};\n\n/* eslint-disable complexity -- Temporary */\n/**\n * @param {ESTreeOrTypeScriptNode|null|undefined} node\n * @param {boolean} [checkYieldReturnValue]\n * @returns {boolean}\n */\nconst hasNonFunctionYield = (node, checkYieldReturnValue) => {\n /* eslint-enable complexity -- Temporary */\n if (!node) {\n return false;\n }\n\n switch (node.type) {\n case 'ArrayExpression':\n\n case 'ArrayPattern':\n return node.elements.some((element) => {\n return hasNonFunctionYield(element, checkYieldReturnValue);\n });\n case 'AssignmentExpression':\n case 'BinaryExpression':\n case 'LogicalExpression': {\n return hasNonFunctionYield(node.left, checkYieldReturnValue) ||\n hasNonFunctionYield(node.right, checkYieldReturnValue);\n }\n\n case 'AssignmentPattern':\n return hasNonFunctionYield(node.right, checkYieldReturnValue);\n case 'BlockStatement': {\n return node.body.some((bodyNode) => {\n return ![\n 'ArrowFunctionExpression',\n 'FunctionDeclaration',\n 'FunctionExpression',\n ].includes(bodyNode.type) && hasNonFunctionYield(\n bodyNode, checkYieldReturnValue,\n );\n });\n }\n\n /* c8 ignore next 2 -- In Babel? */\n case 'CallExpression':\n // @ts-expect-error In Babel?\n case 'OptionalCallExpression':\n return node.arguments.some((element) => {\n return hasNonFunctionYield(element, checkYieldReturnValue);\n });\n case 'ChainExpression':\n case 'ExpressionStatement': {\n return hasNonFunctionYield(node.expression, checkYieldReturnValue);\n }\n\n /* c8 ignore next 2 -- In Babel? */\n // @ts-expect-error In Babel?\n case 'ClassProperty':\n\n /* c8 ignore next 2 -- In Babel? */\n // @ts-expect-error In Babel?\n case 'ObjectProperty':\n /* c8 ignore next 2 -- In Babel? */\n case 'Property':\n\n case 'PropertyDefinition':\n return node.computed && hasNonFunctionYield(node.key, checkYieldReturnValue) ||\n hasNonFunctionYield(node.value, checkYieldReturnValue);\n\n case 'ConditionalExpression':\n\n case 'IfStatement': {\n return hasNonFunctionYield(node.test, checkYieldReturnValue) ||\n hasNonFunctionYield(node.consequent, checkYieldReturnValue) ||\n hasNonFunctionYield(node.alternate, checkYieldReturnValue);\n }\n\n case 'DoWhileStatement':\n case 'ForInStatement':\n\n case 'ForOfStatement':\n\n case 'ForStatement':\n\n case 'LabeledStatement':\n case 'WhileStatement':\n case 'WithStatement': {\n return hasNonFunctionYield(node.body, checkYieldReturnValue);\n }\n\n /* c8 ignore next 2 -- In Babel? */\n // @ts-expect-error In Babel?\n case 'Import':\n case 'ImportExpression':\n return hasNonFunctionYield(node.source, checkYieldReturnValue);\n\n // ?.\n /* c8 ignore next 2 -- In Babel? */\n case 'MemberExpression':\n // @ts-expect-error In Babel?\n case 'OptionalMemberExpression':\n return hasNonFunctionYield(node.object, checkYieldReturnValue) ||\n hasNonFunctionYield(node.property, checkYieldReturnValue);\n\n case 'ObjectExpression':\n /* eslint-disable no-fallthrough */\n case 'ObjectPattern':\n /* eslint-enable no-fallthrough */\n return node.properties.some((property) => {\n return hasNonFunctionYield(property, checkYieldReturnValue);\n });\n /* c8 ignore next 2 -- In Babel? */\n // @ts-expect-error In Babel?\n case 'ObjectMethod':\n /* c8 ignore next 6 -- In Babel? */\n // @ts-expect-error In Babel?\n return node.computed && hasNonFunctionYield(node.key, checkYieldReturnValue) ||\n // @ts-expect-error In Babel?\n node.arguments.some((nde) => {\n return hasNonFunctionYield(nde, checkYieldReturnValue);\n });\n case 'ReturnStatement': {\n if (node.argument === null) {\n return false;\n }\n\n return hasNonFunctionYield(node.argument, checkYieldReturnValue);\n }\n\n // Comma\n case 'SequenceExpression':\n\n case 'TemplateLiteral':\n return node.expressions.some((subExpression) => {\n return hasNonFunctionYield(subExpression, checkYieldReturnValue);\n });\n case 'SpreadElement':\n\n case 'UnaryExpression':\n return hasNonFunctionYield(node.argument, checkYieldReturnValue);\n\n case 'SwitchStatement': {\n return node.cases.some(\n (someCase) => {\n return someCase.consequent.some((nde) => {\n return hasNonFunctionYield(nde, checkYieldReturnValue);\n });\n },\n );\n }\n\n case 'TaggedTemplateExpression':\n return hasNonFunctionYield(node.quasi, checkYieldReturnValue);\n\n case 'TryStatement': {\n return hasNonFunctionYield(node.block, checkYieldReturnValue) ||\n hasNonFunctionYield(\n node.handler && node.handler.body, checkYieldReturnValue,\n ) ||\n hasNonFunctionYield(\n /** @type {import('@typescript-eslint/types').TSESTree.BlockStatement} */\n (node.finalizer),\n checkYieldReturnValue,\n );\n }\n\n case 'VariableDeclaration': {\n return node.declarations.some((nde) => {\n return hasNonFunctionYield(nde, checkYieldReturnValue);\n });\n }\n\n case 'VariableDeclarator': {\n return hasNonFunctionYield(node.id, checkYieldReturnValue) ||\n hasNonFunctionYield(node.init, checkYieldReturnValue);\n }\n\n case 'YieldExpression': {\n if (checkYieldReturnValue) {\n if (\n /** @type {import('eslint').Rule.Node} */ (\n node\n ).parent.type === 'VariableDeclarator'\n ) {\n return true;\n }\n\n return false;\n }\n\n // void return does not count.\n if (node.argument === null) {\n return false;\n }\n\n return true;\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} node\n * @param {boolean} [checkYieldReturnValue]\n * @returns {boolean}\n */\nconst hasYieldValue = (node, checkYieldReturnValue) => {\n return /** @type {import('@typescript-eslint/types').TSESTree.FunctionDeclaration} */ (\n node\n ).generator && (\n /** @type {import('@typescript-eslint/types').TSESTree.FunctionDeclaration} */ (\n node\n ).expression || hasNonFunctionYield(\n /** @type {import('@typescript-eslint/types').TSESTree.FunctionDeclaration} */\n (node).body,\n checkYieldReturnValue,\n )\n );\n};\n\n/**\n * Checks if a node has a throws statement.\n * @param {ESTreeOrTypeScriptNode|null|undefined} node\n * @param {boolean} [innerFunction]\n * @returns {boolean}\n */\n// eslint-disable-next-line complexity\nconst hasThrowValue = (node, innerFunction) => {\n if (!node) {\n return false;\n }\n\n // There are cases where a function may execute its inner function which\n // throws, but we're treating functions atomically rather than trying to\n // follow them\n switch (node.type) {\n case 'ArrowFunctionExpression':\n case 'FunctionDeclaration':\n case 'FunctionExpression': {\n return !innerFunction && !node.async && hasThrowValue(node.body, true);\n }\n\n case 'BlockStatement': {\n return node.body.some((bodyNode) => {\n return bodyNode.type !== 'FunctionDeclaration' && hasThrowValue(bodyNode);\n });\n }\n\n case 'DoWhileStatement':\n case 'ForInStatement':\n case 'ForOfStatement':\n case 'ForStatement':\n case 'LabeledStatement':\n case 'WhileStatement':\n case 'WithStatement': {\n return hasThrowValue(node.body);\n }\n\n case 'IfStatement': {\n return hasThrowValue(node.consequent) || hasThrowValue(node.alternate);\n }\n\n case 'SwitchStatement': {\n return node.cases.some(\n (someCase) => {\n return someCase.consequent.some((nde) => {\n return hasThrowValue(nde);\n });\n },\n );\n }\n\n case 'ThrowStatement': {\n return true;\n }\n\n // We only consider it to throw an error if the catch or finally blocks throw an error.\n case 'TryStatement': {\n return hasThrowValue(node.handler && node.handler.body) ||\n hasThrowValue(node.finalizer);\n }\n\n default: {\n return false;\n }\n }\n};\n\n/**\n * @param {string} tag\n */\n/*\nconst isInlineTag = (tag) => {\n return /^(@link|@linkcode|@linkplain|@tutorial) /v.test(tag);\n};\n*/\n\n/**\n * Parses GCC Generic/Template types\n * @see {@link https://github.com/google/closure-compiler/wiki/Generic-Types}\n * @see {@link https://www.typescriptlang.org/docs/handbook/jsdoc-supported-types.html#template}\n * @param {import('comment-parser').Spec} tag\n * @returns {string[]}\n */\nconst parseClosureTemplateTag = (tag) => {\n return tag.name\n .split(',')\n .map((type) => {\n return type.trim().replace(/^\\[?(?<name>.*?)=.*$/v, '$<name>');\n });\n};\n\n/**\n * @typedef {true|string[]} DefaultContexts\n */\n\n/**\n * Checks user option for `contexts` array, defaulting to\n * contexts designated by the rule. Returns an array of\n * ESTree AST types, indicating allowable contexts.\n * @param {import('eslint').Rule.RuleContext} context\n * @param {DefaultContexts|undefined} defaultContexts\n * @param {{\n * contexts?: import('./iterateJsdoc.js').Context[]\n * }} settings\n * @returns {(string|import('./iterateJsdoc.js').ContextObject)[]}\n */\nconst enforcedContexts = (context, defaultContexts, settings) => {\n const contexts = context.options[0]?.contexts || settings.contexts || (defaultContexts === true ? [\n 'ArrowFunctionExpression',\n 'FunctionDeclaration',\n 'FunctionExpression',\n 'TSDeclareFunction',\n ] : defaultContexts);\n\n return contexts;\n};\n\n/**\n * @param {import('./iterateJsdoc.js').Context[]} contexts\n * @param {import('./iterateJsdoc.js').CheckJsdoc} checkJsdoc\n * @param {import('@es-joy/jsdoccomment').CommentHandler} [handler]\n * @returns {import('eslint').Rule.RuleListener}\n */\nconst getContextObject = (contexts, checkJsdoc, handler) => {\n /** @type {import('eslint').Rule.RuleListener} */\n const properties = {};\n\n for (const [\n idx,\n prop,\n ] of contexts.entries()) {\n /** @type {string} */\n let property;\n\n /** @type {(node: import('eslint').Rule.Node) => void} */\n let value;\n\n if (typeof prop === 'object') {\n const selInfo = {\n lastIndex: idx,\n selector: prop.context,\n };\n if (prop.comment) {\n property = /** @type {string} */ (prop.context);\n value = checkJsdoc.bind(\n null,\n {\n ...selInfo,\n comment: prop.comment,\n },\n /**\n * @type {(jsdoc: import('@es-joy/jsdoccomment').JsdocBlockWithInline) => boolean}\n */\n (/** @type {import('@es-joy/jsdoccomment').CommentHandler} */ (\n handler\n ).bind(null, prop.comment)),\n );\n } else {\n property = /** @type {string} */ (prop.context);\n value = checkJsdoc.bind(null, selInfo, null);\n }\n } else {\n const selInfo = {\n lastIndex: idx,\n selector: prop,\n };\n property = prop;\n value = checkJsdoc.bind(null, selInfo, null);\n }\n\n const old = /**\n * @type {((node: import('eslint').Rule.Node) => void)}\n */ (properties[property]);\n properties[property] = old ?\n /**\n * @type {((node: import('eslint').Rule.Node) => void)}\n */\n function (node) {\n old(node);\n value(node);\n } :\n value;\n }\n\n return properties;\n};\n\nconst tagsWithNamesAndDescriptions = new Set([\n 'arg', 'argument', 'param', 'prop', 'property',\n 'return',\n\n // These two are parsed by our custom parser as though having a `name`\n 'returns', 'template',\n]);\n\n/**\n * @typedef {{\n * [key: string]: false|string|\n * {message: string, replacement?: string}\n * }} TagNamePreference\n */\n\n/**\n * @param {import('eslint').Rule.RuleContext} context\n * @param {ParserMode|undefined} mode\n * @param {import('comment-parser').Spec[]} tags\n * @returns {{\n * tagsWithNames: import('comment-parser').Spec[],\n * tagsWithoutNames: import('comment-parser').Spec[]\n * }}\n */\nconst getTagsByType = (context, mode, tags) => {\n /**\n * @type {import('comment-parser').Spec[]}\n */\n const tagsWithoutNames = [];\n const tagsWithNames = tags.filter((tag) => {\n const {\n tag: tagName,\n } = tag;\n const tagWithName = tagsWithNamesAndDescriptions.has(tagName);\n if (!tagWithName) {\n tagsWithoutNames.push(tag);\n }\n\n return tagWithName;\n });\n\n return {\n tagsWithNames,\n tagsWithoutNames,\n };\n};\n\n/**\n * @param {import('eslint').SourceCode|{\n * text: string\n * }} sourceCode\n * @returns {string}\n */\nconst getIndent = (sourceCode) => {\n return (sourceCode.text.match(/^\\n*([ \\t]+)/v)?.[1] ?? '') + ' ';\n};\n\n/**\n * @param {import('eslint').Rule.Node|null} node\n * @returns {boolean}\n */\nconst isConstructor = (node) => {\n return node?.type === 'MethodDefinition' && node.kind === 'constructor' ||\n /** @type {import('@typescript-eslint/types').TSESTree.MethodDefinition} */ (\n node?.parent\n )?.kind === 'constructor';\n};\n\n/**\n * @param {import('eslint').Rule.Node|null} node\n * @returns {boolean}\n */\nconst isGetter = (node) => {\n return node !== null &&\n /**\n * @type {import('@typescript-eslint/types').TSESTree.MethodDefinition|\n * import('@typescript-eslint/types').TSESTree.Property}\n */ (\n node.parent\n )?.kind === 'get';\n};\n\n/**\n * @param {import('eslint').Rule.Node|null} node\n * @returns {boolean}\n */\nconst isSetter = (node) => {\n return node !== null &&\n /**\n * @type {import('@typescript-eslint/types').TSESTree.MethodDefinition|\n * import('@typescript-eslint/types').TSESTree.Property}\n */(\n node.parent\n )?.kind === 'set';\n};\n\n/**\n * @param {import('eslint').Rule.Node} node\n * @returns {boolean}\n */\nconst hasAccessorPair = (node) => {\n const {\n key,\n kind: sourceKind,\n type,\n } =\n /**\n * @type {import('@typescript-eslint/types').TSESTree.MethodDefinition|\n * import('@typescript-eslint/types').TSESTree.Property}\n */ (node);\n\n const sourceName =\n /** @type {import('@typescript-eslint/types').TSESTree.Identifier} */ (\n key\n ).name;\n\n const oppositeKind = sourceKind === 'get' ? 'set' : 'get';\n\n const sibling = type === 'MethodDefinition' ?\n /** @type {import('@typescript-eslint/types').TSESTree.ClassBody} */ (\n node.parent\n ).body :\n /** @type {import('@typescript-eslint/types').TSESTree.ObjectExpression} */ (\n node.parent\n ).properties;\n\n return (\n sibling.some((child) => {\n const {\n key: ky,\n kind,\n } = /**\n * @type {import('@typescript-eslint/types').TSESTree.MethodDefinition|\n * import('@typescript-eslint/types').TSESTree.Property}\n */ (child);\n\n const name =\n /** @type {import('@typescript-eslint/types').TSESTree.Identifier} */ (\n ky\n ).name;\n\n return kind === oppositeKind && name === sourceName;\n })\n );\n};\n\n/**\n * @param {import('./iterateJsdoc.js').JsdocBlockWithInline} jsdoc\n * @param {import('eslint').Rule.Node|null} node\n * @param {import('eslint').Rule.RuleContext} context\n * @param {import('json-schema').JSONSchema4} schema\n * @returns {boolean}\n */\nconst exemptSpeciaMethods = (jsdoc, node, context, schema) => {\n /**\n * @param {\"checkGetters\"|\"checkSetters\"|\"checkConstructors\"} prop\n * @returns {boolean|\"no-setter\"|\"no-getter\"}\n */\n const hasSchemaOption = (prop) => {\n const schemaProperties = schema[0].properties;\n\n return context.options[0]?.[prop] ??\n (schemaProperties[prop] && schemaProperties[prop].default);\n };\n\n const checkGetters = hasSchemaOption('checkGetters');\n const checkSetters = hasSchemaOption('checkSetters');\n\n return !hasSchemaOption('checkConstructors') &&\n (\n isConstructor(node) ||\n hasATag(jsdoc, [\n 'class',\n 'constructor',\n ])) ||\n isGetter(node) && (\n !checkGetters ||\n checkGetters === 'no-setter' && hasAccessorPair(/** @type {import('./iterateJsdoc.js').Node} */ (node).parent)\n ) ||\n isSetter(node) && (\n !checkSetters ||\n checkSetters === 'no-getter' && hasAccessorPair(/** @type {import('./iterateJsdoc.js').Node} */ (node).parent)\n );\n};\n\n/**\n * Since path segments may be unquoted (if matching a reserved word,\n * identifier or numeric literal) or single or double quoted, in either\n * the `@param` or in source, we need to strip the quotes to give a fair\n * comparison.\n * @param {string} str\n * @returns {string}\n */\nconst dropPathSegmentQuotes = (str) => {\n return str.replaceAll(/\\.(['\"])(.*)\\1/gv, '.$2');\n};\n\n/**\n * @param {string} name\n * @returns {(otherPathName: string) => boolean}\n */\nconst comparePaths = (name) => {\n return (otherPathName) => {\n return otherPathName === name ||\n dropPathSegmentQuotes(otherPathName) === dropPathSegmentQuotes(name);\n };\n};\n\n/**\n * @callback PathDoesNotBeginWith\n * @param {string} name\n * @param {string} otherPathName\n * @returns {boolean}\n */\n\n/** @type {PathDoesNotBeginWith} */\nconst pathDoesNotBeginWith = (name, otherPathName) => {\n return !name.startsWith(otherPathName) &&\n !dropPathSegmentQuotes(name).startsWith(dropPathSegmentQuotes(otherPathName));\n};\n\n/**\n * @param {string} regexString\n * @param {string} [requiredFlags]\n * @returns {RegExp}\n */\nconst getRegexFromString = (regexString, requiredFlags) => {\n const match = regexString.match(/^\\/(.*)\\/([gimyvus]*)$/vs);\n let flags = 'v';\n let regex = regexString;\n if (match) {\n [\n , regex,\n flags,\n ] = match;\n if (!flags) {\n flags = 'v';\n }\n }\n\n const uniqueFlags = [\n ...new Set(flags + (requiredFlags || '')),\n ];\n flags = uniqueFlags.join('');\n\n return new RegExp(regex, flags);\n};\n\nexport {\n comparePaths,\n dropPathSegmentQuotes,\n enforcedContexts,\n exemptSpeciaMethods,\n filterTags,\n flattenRoots,\n forEachPreferredTag,\n getAllTags,\n getContextObject,\n getFunctionParameterNames,\n getIndent,\n getJsdocTagsDeep,\n getPreferredTagName,\n getPreferredTagNameSimple,\n getRegexFromString,\n getTagDescription,\n getTags,\n getTagsByType,\n getTagStructureForMode,\n hasATag,\n hasParams,\n\n hasTag,\n hasThrowValue,\n\n hasYieldValue,\n isConstructor,\n isGetter,\n isNamepathDefiningTag,\n isNamepathOrUrlReferencingTag,\n isNamepathReferencingTag,\n isSetter,\n isValidTag,\n mayBeUndefinedTypeTag,\n overrideTagStructure,\n parseClosureTemplateTag,\n pathDoesNotBeginWith,\n setTagStructure,\n tagMightHaveEitherTypeOrNamePosition,\n tagMightHaveNamepath,\n tagMightHaveNamePosition,\n tagMightHaveTypePosition,\n tagMissingRequiredTypeOrNamepath,\n tagMustHaveNamePosition,\n tagMustHaveTypePosition,\n};\nexport {\n hasReturnValue,\n hasValueOrExecutorHasNonEmptyResolveValue,\n} from './utils/hasReturnValue.js';\n"],"mappings":"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","ignoreList":[]}
@@ -1,33 +1,40 @@
1
- const require_iterateJsdoc = require('../iterateJsdoc.cjs');
1
+ "use strict";
2
2
 
3
- //#region src/rules/checkAccess.js
4
- const accessLevels = [
5
- "package",
6
- "private",
7
- "protected",
8
- "public"
9
- ];
10
- var checkAccess_default = require_iterateJsdoc.default(({ report, utils }) => {
11
- utils.forEachPreferredTag("access", (jsdocParameter, targetTagName) => {
12
- const desc = jsdocParameter.name + " " + jsdocParameter.description;
13
- if (!accessLevels.includes(desc.trim())) report(`Missing valid JSDoc @${targetTagName} level.`, null, jsdocParameter);
14
- });
15
- const accessLength = utils.getTags("access").length;
16
- const individualTagLength = utils.getPresentTags(accessLevels).length;
17
- if (accessLength && individualTagLength) report("The @access tag may not be used with specific access-control tags (@package, @private, @protected, or @public).");
18
- if (accessLength > 1 || individualTagLength > 1) report("At most one access-control tag may be present on a jsdoc block.");
3
+ Object.defineProperty(exports, "__esModule", {
4
+ value: true
5
+ });
6
+ exports.default = void 0;
7
+ var _iterateJsdoc = _interopRequireDefault(require("../iterateJsdoc.cjs"));
8
+ function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
9
+ const accessLevels = ['package', 'private', 'protected', 'public'];
10
+ var _default = exports.default = (0, _iterateJsdoc.default)(({
11
+ report,
12
+ utils
13
+ }) => {
14
+ utils.forEachPreferredTag('access', (jsdocParameter, targetTagName) => {
15
+ const desc = jsdocParameter.name + ' ' + jsdocParameter.description;
16
+ if (!accessLevels.includes(desc.trim())) {
17
+ report(`Missing valid JSDoc @${targetTagName} level.`, null, jsdocParameter);
18
+ }
19
+ });
20
+ const accessLength = utils.getTags('access').length;
21
+ const individualTagLength = utils.getPresentTags(accessLevels).length;
22
+ if (accessLength && individualTagLength) {
23
+ report('The @access tag may not be used with specific access-control tags (@package, @private, @protected, or @public).');
24
+ }
25
+ if (accessLength > 1 || individualTagLength > 1) {
26
+ report('At most one access-control tag may be present on a jsdoc block.');
27
+ }
19
28
  }, {
20
- checkPrivate: true,
21
- iterateAllJsdocs: true,
22
- meta: {
23
- docs: {
24
- description: "Checks that `@access` tags have a valid value.",
25
- url: "https://github.com/gajus/eslint-plugin-jsdoc/blob/main/docs/rules/check-access.md#repos-sticky-header"
26
- },
27
- type: "suggestion"
28
- }
29
+ checkPrivate: true,
30
+ iterateAllJsdocs: true,
31
+ meta: {
32
+ docs: {
33
+ description: 'Checks that `@access` tags have a valid value.',
34
+ url: 'https://github.com/gajus/eslint-plugin-jsdoc/blob/main/docs/rules/check-access.md#repos-sticky-header'
35
+ },
36
+ type: 'suggestion'
37
+ }
29
38
  });
30
-
31
- //#endregion
32
- exports.default = checkAccess_default;
39
+ module.exports = exports.default;
33
40
  //# sourceMappingURL=checkAccess.cjs.map
@@ -1 +1 @@
1
- {"version":3,"file":"checkAccess.cjs","names":["iterateJsdoc"],"sources":["../../src/rules/checkAccess.js"],"sourcesContent":["import iterateJsdoc from '../iterateJsdoc.js';\n\nconst accessLevels = [\n 'package', 'private', 'protected', 'public',\n];\n\nexport default iterateJsdoc(({\n report,\n utils,\n}) => {\n utils.forEachPreferredTag('access', (jsdocParameter, targetTagName) => {\n const desc = jsdocParameter.name + ' ' + jsdocParameter.description;\n\n if (!accessLevels.includes(desc.trim())) {\n report(\n `Missing valid JSDoc @${targetTagName} level.`,\n null,\n jsdocParameter,\n );\n }\n });\n const accessLength = utils.getTags('access').length;\n const individualTagLength = utils.getPresentTags(accessLevels).length;\n if (accessLength && individualTagLength) {\n report(\n 'The @access tag may not be used with specific access-control tags (@package, @private, @protected, or @public).',\n );\n }\n\n if (accessLength > 1 || individualTagLength > 1) {\n report(\n 'At most one access-control tag may be present on a jsdoc block.',\n );\n }\n}, {\n checkPrivate: true,\n iterateAllJsdocs: true,\n meta: {\n docs: {\n description: 'Checks that `@access` tags have a valid value.',\n url: 'https://github.com/gajus/eslint-plugin-jsdoc/blob/main/docs/rules/check-access.md#repos-sticky-header',\n },\n type: 'suggestion',\n },\n});\n"],"mappings":";;;AAEA,MAAM,eAAe;CACnB;CAAW;CAAW;CAAa;AACpC;AAED,0BAAeA,6BAAa,CAAC,EAC3B,QACA,OACD,KAAK;CACJ,MAAM,oBAAoB,UAAU,CAAC,gBAAgB,kBAAkB;EACrE,MAAM,OAAO,eAAe,OAAO,MAAM,eAAe;AAExD,MAAI,CAAC,aAAa,SAAS,KAAK,MAAM,CAAC,EACrC,OACE,CAAC,qBAAqB,EAAE,cAAc,OAAO,CAAC,EAC9C,MACA,eACD;CAEJ,EAAC;CACF,MAAM,eAAe,MAAM,QAAQ,SAAS,CAAC;CAC7C,MAAM,sBAAsB,MAAM,eAAe,aAAa,CAAC;AAC/D,KAAI,gBAAgB,qBAClB,OACE,kHACD;AAGH,KAAI,eAAe,KAAK,sBAAsB,GAC5C,OACE,kEACD;AAEJ,GAAE;CACD,cAAc;CACd,kBAAkB;CAClB,MAAM;EACJ,MAAM;GACJ,aAAa;GACb,KAAK;EACN;EACD,MAAM;CACP;AACF,EAAC"}
1
+ {"version":3,"file":"checkAccess.cjs","names":["_iterateJsdoc","_interopRequireDefault","require","e","__esModule","default","accessLevels","_default","exports","iterateJsdoc","report","utils","forEachPreferredTag","jsdocParameter","targetTagName","desc","name","description","includes","trim","accessLength","getTags","length","individualTagLength","getPresentTags","checkPrivate","iterateAllJsdocs","meta","docs","url","type","module"],"sources":["../../src/rules/checkAccess.js"],"sourcesContent":["import iterateJsdoc from '../iterateJsdoc.js';\n\nconst accessLevels = [\n 'package', 'private', 'protected', 'public',\n];\n\nexport default iterateJsdoc(({\n report,\n utils,\n}) => {\n utils.forEachPreferredTag('access', (jsdocParameter, targetTagName) => {\n const desc = jsdocParameter.name + ' ' + jsdocParameter.description;\n\n if (!accessLevels.includes(desc.trim())) {\n report(\n `Missing valid JSDoc @${targetTagName} level.`,\n null,\n jsdocParameter,\n );\n }\n });\n const accessLength = utils.getTags('access').length;\n const individualTagLength = utils.getPresentTags(accessLevels).length;\n if (accessLength && individualTagLength) {\n report(\n 'The @access tag may not be used with specific access-control tags (@package, @private, @protected, or @public).',\n );\n }\n\n if (accessLength > 1 || individualTagLength > 1) {\n report(\n 'At most one access-control tag may be present on a jsdoc block.',\n );\n }\n}, {\n checkPrivate: true,\n iterateAllJsdocs: true,\n meta: {\n docs: {\n description: 'Checks that `@access` tags have a valid value.',\n url: 'https://github.com/gajus/eslint-plugin-jsdoc/blob/main/docs/rules/check-access.md#repos-sticky-header',\n },\n type: 'suggestion',\n },\n});\n"],"mappings":";;;;;;AAAA,IAAAA,aAAA,GAAAC,sBAAA,CAAAC,OAAA;AAA8C,SAAAD,uBAAAE,CAAA,WAAAA,CAAA,IAAAA,CAAA,CAAAC,UAAA,GAAAD,CAAA,KAAAE,OAAA,EAAAF,CAAA;AAE9C,MAAMG,YAAY,GAAG,CACnB,SAAS,EAAE,SAAS,EAAE,WAAW,EAAE,QAAQ,CAC5C;AAAC,IAAAC,QAAA,GAAAC,OAAA,CAAAH,OAAA,GAEa,IAAAI,qBAAY,EAAC,CAAC;EAC3BC,MAAM;EACNC;AACF,CAAC,KAAK;EACJA,KAAK,CAACC,mBAAmB,CAAC,QAAQ,EAAE,CAACC,cAAc,EAAEC,aAAa,KAAK;IACrE,MAAMC,IAAI,GAAGF,cAAc,CAACG,IAAI,GAAG,GAAG,GAAGH,cAAc,CAACI,WAAW;IAEnE,IAAI,CAACX,YAAY,CAACY,QAAQ,CAACH,IAAI,CAACI,IAAI,CAAC,CAAC,CAAC,EAAE;MACvCT,MAAM,CACJ,wBAAwBI,aAAa,SAAS,EAC9C,IAAI,EACJD,cACF,CAAC;IACH;EACF,CAAC,CAAC;EACF,MAAMO,YAAY,GAAGT,KAAK,CAACU,OAAO,CAAC,QAAQ,CAAC,CAACC,MAAM;EACnD,MAAMC,mBAAmB,GAAGZ,KAAK,CAACa,cAAc,CAAClB,YAAY,CAAC,CAACgB,MAAM;EACrE,IAAIF,YAAY,IAAIG,mBAAmB,EAAE;IACvCb,MAAM,CACJ,iHACF,CAAC;EACH;EAEA,IAAIU,YAAY,GAAG,CAAC,IAAIG,mBAAmB,GAAG,CAAC,EAAE;IAC/Cb,MAAM,CACJ,iEACF,CAAC;EACH;AACF,CAAC,EAAE;EACDe,YAAY,EAAE,IAAI;EAClBC,gBAAgB,EAAE,IAAI;EACtBC,IAAI,EAAE;IACJC,IAAI,EAAE;MACJX,WAAW,EAAE,gDAAgD;MAC7DY,GAAG,EAAE;IACP,CAAC;IACDC,IAAI,EAAE;EACR;AACF,CAAC,CAAC;AAAAC,MAAA,CAAAvB,OAAA,GAAAA,OAAA,CAAAH,OAAA","ignoreList":[]}
@@ -1,47 +1,60 @@
1
- const require_iterateJsdoc = require('../iterateJsdoc.cjs');
1
+ "use strict";
2
2
 
3
- //#region src/rules/checkAlignment.js
3
+ Object.defineProperty(exports, "__esModule", {
4
+ value: true
5
+ });
6
+ exports.default = void 0;
7
+ var _iterateJsdoc = _interopRequireDefault(require("../iterateJsdoc.cjs"));
8
+ function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
4
9
  /**
5
- * @param {string} string
6
- * @returns {string}
7
- */
8
- const trimStart = (string) => {
9
- return string.replace(/^\s+/v, "");
10
+ * @param {string} string
11
+ * @returns {string}
12
+ */
13
+ const trimStart = string => {
14
+ return string.replace(/^\s+/v, '');
10
15
  };
11
- var checkAlignment_default = require_iterateJsdoc.default(({ indent, jsdocNode, report, sourceCode }) => {
12
- const indentLevel = indent.length + 1;
13
- const sourceLines = sourceCode.getText(jsdocNode).split("\n").slice(1).map((line) => {
14
- return line.split("*")[0];
15
- }).filter((line) => {
16
- return !trimStart(line).length;
17
- });
18
- /** @type {import('eslint').Rule.ReportFixer} */
19
- const fix = (fixer) => {
20
- const replacement = sourceCode.getText(jsdocNode).split("\n").map((line, index) => {
21
- const ignored = !index || trimStart(line.split("*")[0]).length;
22
- return ignored ? line : `${indent} ${trimStart(line)}`;
23
- }).join("\n");
24
- return fixer.replaceText(jsdocNode, replacement);
25
- };
26
- sourceLines.some((line, lineNum) => {
27
- if (line.length !== indentLevel) {
28
- report("Expected JSDoc block to be aligned.", fix, { line: lineNum + 1 });
29
- return true;
30
- }
31
- return false;
32
- });
16
+ var _default = exports.default = (0, _iterateJsdoc.default)(({
17
+ indent,
18
+ jsdocNode,
19
+ report,
20
+ sourceCode
21
+ }) => {
22
+ // `indent` is whitespace from line 1 (`/**`), so slice and account for "/".
23
+ const indentLevel = indent.length + 1;
24
+ const sourceLines = sourceCode.getText(jsdocNode).split('\n').slice(1).map(line => {
25
+ return line.split('*')[0];
26
+ }).filter(line => {
27
+ return !trimStart(line).length;
28
+ });
29
+
30
+ /** @type {import('eslint').Rule.ReportFixer} */
31
+ const fix = fixer => {
32
+ const replacement = sourceCode.getText(jsdocNode).split('\n').map((line, index) => {
33
+ // Ignore the first line and all lines not starting with `*`
34
+ const ignored = !index || trimStart(line.split('*')[0]).length;
35
+ return ignored ? line : `${indent} ${trimStart(line)}`;
36
+ }).join('\n');
37
+ return fixer.replaceText(jsdocNode, replacement);
38
+ };
39
+ sourceLines.some((line, lineNum) => {
40
+ if (line.length !== indentLevel) {
41
+ report('Expected JSDoc block to be aligned.', fix, {
42
+ line: lineNum + 1
43
+ });
44
+ return true;
45
+ }
46
+ return false;
47
+ });
33
48
  }, {
34
- iterateAllJsdocs: true,
35
- meta: {
36
- docs: {
37
- description: "Reports invalid alignment of JSDoc block asterisks.",
38
- url: "https://github.com/gajus/eslint-plugin-jsdoc/blob/main/docs/rules/check-alignment.md#repos-sticky-header"
39
- },
40
- fixable: "code",
41
- type: "layout"
42
- }
49
+ iterateAllJsdocs: true,
50
+ meta: {
51
+ docs: {
52
+ description: 'Reports invalid alignment of JSDoc block asterisks.',
53
+ url: 'https://github.com/gajus/eslint-plugin-jsdoc/blob/main/docs/rules/check-alignment.md#repos-sticky-header'
54
+ },
55
+ fixable: 'code',
56
+ type: 'layout'
57
+ }
43
58
  });
44
-
45
- //#endregion
46
- exports.default = checkAlignment_default;
59
+ module.exports = exports.default;
47
60
  //# sourceMappingURL=checkAlignment.cjs.map