eslint-plugin-jsdoc 52.0.1 → 52.0.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (357) hide show
  1. package/dist/WarnSettings.cjs +18 -35
  2. package/dist/WarnSettings.cjs.map +1 -1
  3. package/dist/WarnSettings.js +20 -0
  4. package/dist/WarnSettings.js.map +1 -0
  5. package/dist/_virtual/rolldown_runtime.cjs +32 -0
  6. package/dist/_virtual/rolldown_runtime.js +11 -0
  7. package/dist/alignTransform.cjs +224 -305
  8. package/dist/alignTransform.cjs.map +1 -1
  9. package/dist/alignTransform.js +241 -0
  10. package/dist/alignTransform.js.map +1 -0
  11. package/dist/defaultTagOrder.cjs +132 -43
  12. package/dist/defaultTagOrder.cjs.map +1 -1
  13. package/dist/defaultTagOrder.js +134 -0
  14. package/dist/defaultTagOrder.js.map +1 -0
  15. package/dist/exportParser.cjs +478 -696
  16. package/dist/exportParser.cjs.map +1 -1
  17. package/dist/exportParser.js +518 -0
  18. package/dist/exportParser.js.map +1 -0
  19. package/dist/getDefaultTagStructureForMode.cjs +184 -288
  20. package/dist/getDefaultTagStructureForMode.cjs.map +1 -1
  21. package/dist/getDefaultTagStructureForMode.js +188 -0
  22. package/dist/getDefaultTagStructureForMode.js.map +1 -0
  23. package/dist/getJsdocProcessorPlugin.cjs +365 -532
  24. package/dist/getJsdocProcessorPlugin.cjs.map +1 -1
  25. package/dist/getJsdocProcessorPlugin.d.cts +70 -0
  26. package/dist/getJsdocProcessorPlugin.d.cts.map +1 -0
  27. package/dist/getJsdocProcessorPlugin.d.ts +68 -90
  28. package/dist/getJsdocProcessorPlugin.d.ts.map +1 -1
  29. package/dist/getJsdocProcessorPlugin.js +383 -0
  30. package/dist/getJsdocProcessorPlugin.js.map +1 -0
  31. package/dist/index.cjs +398 -383
  32. package/dist/index.cjs.map +1 -1
  33. package/dist/index.d.cts +22 -0
  34. package/dist/index.d.cts.map +1 -0
  35. package/dist/index.d.ts +11 -6
  36. package/dist/index.d.ts.map +1 -1
  37. package/dist/index.js +425 -0
  38. package/dist/index.js.map +1 -0
  39. package/dist/iterateJsdoc.cjs +1528 -1988
  40. package/dist/iterateJsdoc.cjs.map +1 -1
  41. package/dist/iterateJsdoc.d.cts +471 -0
  42. package/dist/iterateJsdoc.d.cts.map +1 -0
  43. package/dist/iterateJsdoc.d.ts +358 -349
  44. package/dist/iterateJsdoc.d.ts.map +1 -1
  45. package/dist/iterateJsdoc.js +1617 -0
  46. package/dist/iterateJsdoc.js.map +1 -0
  47. package/dist/jsdocUtils.cjs +1009 -1376
  48. package/dist/jsdocUtils.cjs.map +1 -1
  49. package/dist/jsdocUtils.js +1123 -0
  50. package/dist/jsdocUtils.js.map +1 -0
  51. package/dist/rules/checkAccess.cjs +29 -36
  52. package/dist/rules/checkAccess.cjs.map +1 -1
  53. package/dist/rules/checkAccess.js +33 -0
  54. package/dist/rules/checkAccess.js.map +1 -0
  55. package/dist/rules/checkAlignment.cjs +41 -54
  56. package/dist/rules/checkAlignment.cjs.map +1 -1
  57. package/dist/rules/checkAlignment.js +47 -0
  58. package/dist/rules/checkAlignment.js.map +1 -0
  59. package/dist/rules/checkExamples.cjs +327 -484
  60. package/dist/rules/checkExamples.cjs.map +1 -1
  61. package/dist/rules/checkExamples.js +348 -0
  62. package/dist/rules/checkExamples.js.map +1 -0
  63. package/dist/rules/checkIndentation.cjs +50 -65
  64. package/dist/rules/checkIndentation.cjs.map +1 -1
  65. package/dist/rules/checkIndentation.js +59 -0
  66. package/dist/rules/checkIndentation.js.map +1 -0
  67. package/dist/rules/checkLineAlignment.cjs +220 -311
  68. package/dist/rules/checkLineAlignment.cjs.map +1 -1
  69. package/dist/rules/checkLineAlignment.js +229 -0
  70. package/dist/rules/checkLineAlignment.js.map +1 -0
  71. package/dist/rules/checkParamNames.cjs +227 -335
  72. package/dist/rules/checkParamNames.cjs.map +1 -1
  73. package/dist/rules/checkParamNames.js +237 -0
  74. package/dist/rules/checkParamNames.js.map +1 -0
  75. package/dist/rules/checkPropertyNames.cjs +78 -106
  76. package/dist/rules/checkPropertyNames.cjs.map +1 -1
  77. package/dist/rules/checkPropertyNames.js +88 -0
  78. package/dist/rules/checkPropertyNames.js.map +1 -0
  79. package/dist/rules/checkSyntax.cjs +21 -34
  80. package/dist/rules/checkSyntax.cjs.map +1 -1
  81. package/dist/rules/checkSyntax.js +25 -0
  82. package/dist/rules/checkSyntax.js.map +1 -0
  83. package/dist/rules/checkTagNames.cjs +188 -210
  84. package/dist/rules/checkTagNames.cjs.map +1 -1
  85. package/dist/rules/checkTagNames.js +191 -0
  86. package/dist/rules/checkTagNames.js.map +1 -0
  87. package/dist/rules/checkTemplateNames.cjs +121 -178
  88. package/dist/rules/checkTemplateNames.cjs.map +1 -1
  89. package/dist/rules/checkTemplateNames.js +124 -0
  90. package/dist/rules/checkTemplateNames.js.map +1 -0
  91. package/dist/rules/checkTypes.cjs +291 -385
  92. package/dist/rules/checkTypes.cjs.map +1 -1
  93. package/dist/rules/checkTypes.js +299 -0
  94. package/dist/rules/checkTypes.js.map +1 -0
  95. package/dist/rules/checkValues.cjs +100 -146
  96. package/dist/rules/checkValues.cjs.map +1 -1
  97. package/dist/rules/checkValues.js +103 -0
  98. package/dist/rules/checkValues.js.map +1 -0
  99. package/dist/rules/convertToJsdocComments.cjs +228 -306
  100. package/dist/rules/convertToJsdocComments.cjs.map +1 -1
  101. package/dist/rules/convertToJsdocComments.js +231 -0
  102. package/dist/rules/convertToJsdocComments.js.map +1 -0
  103. package/dist/rules/emptyTags.cjs +62 -72
  104. package/dist/rules/emptyTags.cjs.map +1 -1
  105. package/dist/rules/emptyTags.js +67 -0
  106. package/dist/rules/emptyTags.js.map +1 -0
  107. package/dist/rules/implementsOnClasses.cjs +36 -56
  108. package/dist/rules/implementsOnClasses.cjs.map +1 -1
  109. package/dist/rules/implementsOnClasses.js +40 -0
  110. package/dist/rules/implementsOnClasses.js.map +1 -0
  111. package/dist/rules/importsAsDependencies.cjs +62 -99
  112. package/dist/rules/importsAsDependencies.cjs.map +1 -1
  113. package/dist/rules/importsAsDependencies.js +68 -0
  114. package/dist/rules/importsAsDependencies.js.map +1 -0
  115. package/dist/rules/informativeDocs.cjs +105 -142
  116. package/dist/rules/informativeDocs.cjs.map +1 -1
  117. package/dist/rules/informativeDocs.js +110 -0
  118. package/dist/rules/informativeDocs.js.map +1 -0
  119. package/dist/rules/linesBeforeBlock.cjs +70 -105
  120. package/dist/rules/linesBeforeBlock.cjs.map +1 -1
  121. package/dist/rules/linesBeforeBlock.js +75 -0
  122. package/dist/rules/linesBeforeBlock.js.map +1 -0
  123. package/dist/rules/matchDescription.cjs +160 -222
  124. package/dist/rules/matchDescription.cjs.map +1 -1
  125. package/dist/rules/matchDescription.js +167 -0
  126. package/dist/rules/matchDescription.js.map +1 -0
  127. package/dist/rules/matchName.cjs +73 -128
  128. package/dist/rules/matchName.cjs.map +1 -1
  129. package/dist/rules/matchName.js +77 -0
  130. package/dist/rules/matchName.js.map +1 -0
  131. package/dist/rules/multilineBlocks.cjs +235 -352
  132. package/dist/rules/multilineBlocks.cjs.map +1 -1
  133. package/dist/rules/multilineBlocks.js +245 -0
  134. package/dist/rules/multilineBlocks.js.map +1 -0
  135. package/dist/rules/noBadBlocks.cjs +63 -86
  136. package/dist/rules/noBadBlocks.cjs.map +1 -1
  137. package/dist/rules/noBadBlocks.js +68 -0
  138. package/dist/rules/noBadBlocks.js.map +1 -0
  139. package/dist/rules/noBlankBlockDescriptions.cjs +35 -57
  140. package/dist/rules/noBlankBlockDescriptions.cjs.map +1 -1
  141. package/dist/rules/noBlankBlockDescriptions.js +41 -0
  142. package/dist/rules/noBlankBlockDescriptions.js.map +1 -0
  143. package/dist/rules/noBlankBlocks.cjs +26 -48
  144. package/dist/rules/noBlankBlocks.cjs.map +1 -1
  145. package/dist/rules/noBlankBlocks.js +30 -0
  146. package/dist/rules/noBlankBlocks.js.map +1 -0
  147. package/dist/rules/noDefaults.cjs +52 -79
  148. package/dist/rules/noDefaults.cjs.map +1 -1
  149. package/dist/rules/noDefaults.js +56 -0
  150. package/dist/rules/noDefaults.js.map +1 -0
  151. package/dist/rules/noMissingSyntax.cjs +115 -165
  152. package/dist/rules/noMissingSyntax.cjs.map +1 -1
  153. package/dist/rules/noMissingSyntax.js +126 -0
  154. package/dist/rules/noMissingSyntax.js.map +1 -0
  155. package/dist/rules/noMultiAsterisks.cjs +48 -89
  156. package/dist/rules/noMultiAsterisks.cjs.map +1 -1
  157. package/dist/rules/noMultiAsterisks.js +58 -0
  158. package/dist/rules/noMultiAsterisks.js.map +1 -0
  159. package/dist/rules/noRestrictedSyntax.cjs +45 -79
  160. package/dist/rules/noRestrictedSyntax.cjs.map +1 -1
  161. package/dist/rules/noRestrictedSyntax.js +49 -0
  162. package/dist/rules/noRestrictedSyntax.js.map +1 -0
  163. package/dist/rules/noTypes.cjs +59 -80
  164. package/dist/rules/noTypes.cjs.map +1 -1
  165. package/dist/rules/noTypes.js +65 -0
  166. package/dist/rules/noTypes.js.map +1 -0
  167. package/dist/rules/noUndefinedTypes.cjs +297 -388
  168. package/dist/rules/noUndefinedTypes.cjs.map +1 -1
  169. package/dist/rules/noUndefinedTypes.js +303 -0
  170. package/dist/rules/noUndefinedTypes.js.map +1 -0
  171. package/dist/rules/requireAsteriskPrefix.cjs +108 -159
  172. package/dist/rules/requireAsteriskPrefix.cjs.map +1 -1
  173. package/dist/rules/requireAsteriskPrefix.js +112 -0
  174. package/dist/rules/requireAsteriskPrefix.js.map +1 -0
  175. package/dist/rules/requireDescription.cjs +89 -129
  176. package/dist/rules/requireDescription.cjs.map +1 -1
  177. package/dist/rules/requireDescription.js +95 -0
  178. package/dist/rules/requireDescription.js.map +1 -0
  179. package/dist/rules/requireDescriptionCompleteSentence.cjs +201 -262
  180. package/dist/rules/requireDescriptionCompleteSentence.cjs.map +1 -1
  181. package/dist/rules/requireDescriptionCompleteSentence.js +220 -0
  182. package/dist/rules/requireDescriptionCompleteSentence.js.map +1 -0
  183. package/dist/rules/requireExample.cjs +73 -104
  184. package/dist/rules/requireExample.cjs.map +1 -1
  185. package/dist/rules/requireExample.js +77 -0
  186. package/dist/rules/requireExample.js.map +1 -0
  187. package/dist/rules/requireFileOverview.cjs +75 -129
  188. package/dist/rules/requireFileOverview.cjs.map +1 -1
  189. package/dist/rules/requireFileOverview.js +81 -0
  190. package/dist/rules/requireFileOverview.js.map +1 -0
  191. package/dist/rules/requireHyphenBeforeParamDescription.cjs +85 -133
  192. package/dist/rules/requireHyphenBeforeParamDescription.cjs.map +1 -1
  193. package/dist/rules/requireHyphenBeforeParamDescription.js +89 -0
  194. package/dist/rules/requireHyphenBeforeParamDescription.js.map +1 -0
  195. package/dist/rules/requireJsdoc.cjs +384 -557
  196. package/dist/rules/requireJsdoc.cjs.map +1 -1
  197. package/dist/rules/requireJsdoc.js +404 -0
  198. package/dist/rules/requireJsdoc.js.map +1 -0
  199. package/dist/rules/requireParam.cjs +336 -526
  200. package/dist/rules/requireParam.cjs.map +1 -1
  201. package/dist/rules/requireParam.js +344 -0
  202. package/dist/rules/requireParam.js.map +1 -0
  203. package/dist/rules/requireParamDescription.cjs +55 -80
  204. package/dist/rules/requireParamDescription.cjs.map +1 -1
  205. package/dist/rules/requireParamDescription.js +59 -0
  206. package/dist/rules/requireParamDescription.js.map +1 -0
  207. package/dist/rules/requireParamName.cjs +32 -50
  208. package/dist/rules/requireParamName.cjs.map +1 -1
  209. package/dist/rules/requireParamName.js +36 -0
  210. package/dist/rules/requireParamName.js.map +1 -0
  211. package/dist/rules/requireParamType.cjs +55 -80
  212. package/dist/rules/requireParamType.cjs.map +1 -1
  213. package/dist/rules/requireParamType.js +59 -0
  214. package/dist/rules/requireParamType.js.map +1 -0
  215. package/dist/rules/requireProperty.cjs +31 -42
  216. package/dist/rules/requireProperty.cjs.map +1 -1
  217. package/dist/rules/requireProperty.js +35 -0
  218. package/dist/rules/requireProperty.js.map +1 -0
  219. package/dist/rules/requirePropertyDescription.cjs +17 -25
  220. package/dist/rules/requirePropertyDescription.cjs.map +1 -1
  221. package/dist/rules/requirePropertyDescription.js +21 -0
  222. package/dist/rules/requirePropertyDescription.js.map +1 -0
  223. package/dist/rules/requirePropertyName.cjs +17 -25
  224. package/dist/rules/requirePropertyName.cjs.map +1 -1
  225. package/dist/rules/requirePropertyName.js +21 -0
  226. package/dist/rules/requirePropertyName.js.map +1 -0
  227. package/dist/rules/requirePropertyType.cjs +17 -25
  228. package/dist/rules/requirePropertyType.cjs.map +1 -1
  229. package/dist/rules/requirePropertyType.js +21 -0
  230. package/dist/rules/requirePropertyType.js.map +1 -0
  231. package/dist/rules/requireReturns.cjs +125 -203
  232. package/dist/rules/requireReturns.cjs.map +1 -1
  233. package/dist/rules/requireReturns.js +131 -0
  234. package/dist/rules/requireReturns.js.map +1 -0
  235. package/dist/rules/requireReturnsCheck.cjs +60 -103
  236. package/dist/rules/requireReturnsCheck.cjs.map +1 -1
  237. package/dist/rules/requireReturnsCheck.js +66 -0
  238. package/dist/rules/requireReturnsCheck.js.map +1 -0
  239. package/dist/rules/requireReturnsDescription.cjs +39 -54
  240. package/dist/rules/requireReturnsDescription.cjs.map +1 -1
  241. package/dist/rules/requireReturnsDescription.js +43 -0
  242. package/dist/rules/requireReturnsDescription.js.map +1 -0
  243. package/dist/rules/requireReturnsType.cjs +32 -50
  244. package/dist/rules/requireReturnsType.cjs.map +1 -1
  245. package/dist/rules/requireReturnsType.js +36 -0
  246. package/dist/rules/requireReturnsType.js.map +1 -0
  247. package/dist/rules/requireTemplate.cjs +119 -178
  248. package/dist/rules/requireTemplate.cjs.map +1 -1
  249. package/dist/rules/requireTemplate.js +122 -0
  250. package/dist/rules/requireTemplate.js.map +1 -0
  251. package/dist/rules/requireThrows.cjs +61 -95
  252. package/dist/rules/requireThrows.cjs.map +1 -1
  253. package/dist/rules/requireThrows.js +67 -0
  254. package/dist/rules/requireThrows.js.map +1 -0
  255. package/dist/rules/requireYields.cjs +106 -166
  256. package/dist/rules/requireYields.cjs.map +1 -1
  257. package/dist/rules/requireYields.js +115 -0
  258. package/dist/rules/requireYields.js.map +1 -0
  259. package/dist/rules/requireYieldsCheck.cjs +96 -152
  260. package/dist/rules/requireYieldsCheck.cjs.map +1 -1
  261. package/dist/rules/requireYieldsCheck.js +105 -0
  262. package/dist/rules/requireYieldsCheck.js.map +1 -0
  263. package/dist/rules/sortTags.cjs +258 -444
  264. package/dist/rules/sortTags.cjs.map +1 -1
  265. package/dist/rules/sortTags.js +262 -0
  266. package/dist/rules/sortTags.js.map +1 -0
  267. package/dist/rules/tagLines.cjs +179 -266
  268. package/dist/rules/tagLines.cjs.map +1 -1
  269. package/dist/rules/tagLines.js +183 -0
  270. package/dist/rules/tagLines.js.map +1 -0
  271. package/dist/rules/textEscaping.cjs +92 -127
  272. package/dist/rules/textEscaping.cjs.map +1 -1
  273. package/dist/rules/textEscaping.js +102 -0
  274. package/dist/rules/textEscaping.js.map +1 -0
  275. package/dist/rules/validTypes.cjs +252 -265
  276. package/dist/rules/validTypes.cjs.map +1 -1
  277. package/dist/rules/validTypes.js +259 -0
  278. package/dist/rules/validTypes.js.map +1 -0
  279. package/dist/tagNames.cjs +134 -170
  280. package/dist/tagNames.cjs.map +1 -1
  281. package/dist/tagNames.js +144 -0
  282. package/dist/tagNames.js.map +1 -0
  283. package/dist/utils/hasReturnValue.cjs +246 -474
  284. package/dist/utils/hasReturnValue.cjs.map +1 -1
  285. package/dist/utils/hasReturnValue.js +265 -0
  286. package/dist/utils/hasReturnValue.js.map +1 -0
  287. package/package.json +48 -38
  288. package/dist/generateRule.cjs +0 -242
  289. package/dist/generateRule.cjs.map +0 -1
  290. package/src/WarnSettings.js +0 -34
  291. package/src/alignTransform.js +0 -358
  292. package/src/defaultTagOrder.js +0 -169
  293. package/src/exportParser.js +0 -978
  294. package/src/getDefaultTagStructureForMode.js +0 -969
  295. package/src/getJsdocProcessorPlugin.js +0 -652
  296. package/src/index.js +0 -530
  297. package/src/iterateJsdoc.js +0 -2518
  298. package/src/jsdocUtils.js +0 -1896
  299. package/src/rules/checkAccess.js +0 -45
  300. package/src/rules/checkAlignment.js +0 -63
  301. package/src/rules/checkExamples.js +0 -589
  302. package/src/rules/checkIndentation.js +0 -75
  303. package/src/rules/checkLineAlignment.js +0 -372
  304. package/src/rules/checkParamNames.js +0 -474
  305. package/src/rules/checkPropertyNames.js +0 -152
  306. package/src/rules/checkSyntax.js +0 -30
  307. package/src/rules/checkTagNames.js +0 -314
  308. package/src/rules/checkTemplateNames.js +0 -204
  309. package/src/rules/checkTypes.js +0 -535
  310. package/src/rules/checkValues.js +0 -248
  311. package/src/rules/convertToJsdocComments.js +0 -398
  312. package/src/rules/emptyTags.js +0 -98
  313. package/src/rules/implementsOnClasses.js +0 -64
  314. package/src/rules/importsAsDependencies.js +0 -133
  315. package/src/rules/informativeDocs.js +0 -189
  316. package/src/rules/linesBeforeBlock.js +0 -134
  317. package/src/rules/matchDescription.js +0 -286
  318. package/src/rules/matchName.js +0 -151
  319. package/src/rules/multilineBlocks.js +0 -493
  320. package/src/rules/noBadBlocks.js +0 -119
  321. package/src/rules/noBlankBlockDescriptions.js +0 -69
  322. package/src/rules/noBlankBlocks.js +0 -53
  323. package/src/rules/noDefaults.js +0 -85
  324. package/src/rules/noMissingSyntax.js +0 -195
  325. package/src/rules/noMultiAsterisks.js +0 -134
  326. package/src/rules/noRestrictedSyntax.js +0 -91
  327. package/src/rules/noTypes.js +0 -93
  328. package/src/rules/noUndefinedTypes.js +0 -543
  329. package/src/rules/requireAsteriskPrefix.js +0 -190
  330. package/src/rules/requireDescription.js +0 -161
  331. package/src/rules/requireDescriptionCompleteSentence.js +0 -335
  332. package/src/rules/requireExample.js +0 -118
  333. package/src/rules/requireFileOverview.js +0 -154
  334. package/src/rules/requireHyphenBeforeParamDescription.js +0 -176
  335. package/src/rules/requireJsdoc.js +0 -743
  336. package/src/rules/requireParam.js +0 -602
  337. package/src/rules/requireParamDescription.js +0 -89
  338. package/src/rules/requireParamName.js +0 -55
  339. package/src/rules/requireParamType.js +0 -89
  340. package/src/rules/requireProperty.js +0 -48
  341. package/src/rules/requirePropertyDescription.js +0 -25
  342. package/src/rules/requirePropertyName.js +0 -25
  343. package/src/rules/requirePropertyType.js +0 -25
  344. package/src/rules/requireReturns.js +0 -238
  345. package/src/rules/requireReturnsCheck.js +0 -145
  346. package/src/rules/requireReturnsDescription.js +0 -59
  347. package/src/rules/requireReturnsType.js +0 -51
  348. package/src/rules/requireTemplate.js +0 -201
  349. package/src/rules/requireThrows.js +0 -111
  350. package/src/rules/requireYields.js +0 -216
  351. package/src/rules/requireYieldsCheck.js +0 -208
  352. package/src/rules/sortTags.js +0 -558
  353. package/src/rules/tagLines.js +0 -359
  354. package/src/rules/textEscaping.js +0 -154
  355. package/src/rules/validTypes.js +0 -401
  356. package/src/tagNames.js +0 -238
  357. package/src/utils/hasReturnValue.js +0 -572
@@ -1,534 +1,344 @@
1
- "use strict";
1
+ const require_iterateJsdoc = require('../iterateJsdoc.cjs');
2
2
 
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 }; }
3
+ //#region src/rules/requireParam.js
9
4
  /**
10
- * @typedef {[string, boolean, () => RootNamerReturn]} RootNamerReturn
11
- */
12
-
5
+ * @typedef {[string, boolean, () => RootNamerReturn]} RootNamerReturn
6
+ */
13
7
  /**
14
- * @param {string[]} desiredRoots
15
- * @param {number} currentIndex
16
- * @returns {RootNamerReturn}
17
- */
8
+ * @param {string[]} desiredRoots
9
+ * @param {number} currentIndex
10
+ * @returns {RootNamerReturn}
11
+ */
18
12
  const rootNamer = (desiredRoots, currentIndex) => {
19
- /** @type {string} */
20
- let name;
21
- let idx = currentIndex;
22
- const incremented = desiredRoots.length <= 1;
23
- if (incremented) {
24
- const base = desiredRoots[0];
25
- const suffix = idx++;
26
- name = `${base}${suffix}`;
27
- } else {
28
- name = /** @type {string} */desiredRoots.shift();
29
- }
30
- return [name, incremented, () => {
31
- return rootNamer(desiredRoots, idx);
32
- }];
13
+ /** @type {string} */
14
+ let name;
15
+ let idx = currentIndex;
16
+ const incremented = desiredRoots.length <= 1;
17
+ if (incremented) {
18
+ const base = desiredRoots[0];
19
+ const suffix = idx++;
20
+ name = `${base}${suffix}`;
21
+ } else name = desiredRoots.shift();
22
+ return [
23
+ name,
24
+ incremented,
25
+ () => {
26
+ return rootNamer(desiredRoots, idx);
27
+ }
28
+ ];
33
29
  };
34
-
35
- /* eslint-disable complexity -- Temporary */
36
- var _default = exports.default = (0, _iterateJsdoc.default)(({
37
- context,
38
- jsdoc,
39
- utils
40
- }) => {
41
- /* eslint-enable complexity -- Temporary */
42
- if (utils.avoidDocs()) {
43
- return;
44
- }
45
-
46
- // Param type is specified by type in @type
47
- if (utils.hasTag('type')) {
48
- return;
49
- }
50
- const {
51
- autoIncrementBase = 0,
52
- checkDestructured = true,
53
- checkDestructuredRoots = true,
54
- checkRestProperty = false,
55
- checkTypesPattern = '/^(?:[oO]bject|[aA]rray|PlainObject|Generic(?:Object|Array))$/',
56
- enableFixer = true,
57
- enableRestElementFixer = true,
58
- enableRootFixer = true,
59
- ignoreWhenAllParamsMissing = false,
60
- unnamedRootBase = ['root'],
61
- useDefaultObjectProperties = false
62
- } = context.options[0] || {};
63
- const preferredTagName = /** @type {string} */utils.getPreferredTagName({
64
- tagName: 'param'
65
- });
66
- if (!preferredTagName) {
67
- return;
68
- }
69
- const functionParameterNames = utils.getFunctionParameterNames(useDefaultObjectProperties);
70
- if (!functionParameterNames.length) {
71
- return;
72
- }
73
- const jsdocParameterNames =
74
- /**
75
- * @type {{
76
- * idx: import('../iterateJsdoc.js').Integer;
77
- * name: string;
78
- * type: string;
79
- * }[]}
80
- */
81
- utils.getJsdocTagsDeep(preferredTagName);
82
- if (ignoreWhenAllParamsMissing && !jsdocParameterNames.length) {
83
- return;
84
- }
85
- const shallowJsdocParameterNames = jsdocParameterNames.filter(tag => {
86
- return !tag.name.includes('.');
87
- }).map((tag, idx) => {
88
- return {
89
- ...tag,
90
- idx
91
- };
92
- });
93
- const checkTypesRegex = utils.getRegexFromString(checkTypesPattern);
94
-
95
- /**
96
- * @type {{
97
- * functionParameterIdx: import('../iterateJsdoc.js').Integer,
98
- * functionParameterName: string,
99
- * inc: boolean|undefined,
100
- * remove?: true,
101
- * type?: string|undefined
102
- * }[]}
103
- */
104
- const missingTags = [];
105
- const flattenedRoots = utils.flattenRoots(functionParameterNames).names;
106
-
107
- /**
108
- * @type {{
109
- * [key: string]: import('../iterateJsdoc.js').Integer
110
- * }}
111
- */
112
- const paramIndex = {};
113
-
114
- /**
115
- * @param {string} cur
116
- * @returns {boolean}
117
- */
118
- const hasParamIndex = cur => {
119
- return utils.dropPathSegmentQuotes(String(cur)) in paramIndex;
120
- };
121
-
122
- /**
123
- *
124
- * @param {string|number|undefined} cur
125
- * @returns {import('../iterateJsdoc.js').Integer}
126
- */
127
- const getParamIndex = cur => {
128
- return paramIndex[utils.dropPathSegmentQuotes(String(cur))];
129
- };
130
-
131
- /**
132
- *
133
- * @param {string} cur
134
- * @param {import('../iterateJsdoc.js').Integer} idx
135
- * @returns {void}
136
- */
137
- const setParamIndex = (cur, idx) => {
138
- paramIndex[utils.dropPathSegmentQuotes(String(cur))] = idx;
139
- };
140
- for (const [idx, cur] of flattenedRoots.entries()) {
141
- setParamIndex(cur, idx);
142
- }
143
-
144
- /**
145
- *
146
- * @param {(import('@es-joy/jsdoccomment').JsdocTagWithInline & {
147
- * newAdd?: boolean
148
- * })[]} jsdocTags
149
- * @param {import('../iterateJsdoc.js').Integer} indexAtFunctionParams
150
- * @returns {import('../iterateJsdoc.js').Integer}
151
- */
152
- const findExpectedIndex = (jsdocTags, indexAtFunctionParams) => {
153
- const remainingRoots = functionParameterNames.slice(indexAtFunctionParams || 0);
154
- const foundIndex = jsdocTags.findIndex(({
155
- name,
156
- newAdd
157
- }) => {
158
- return !newAdd && remainingRoots.some(remainingRoot => {
159
- if (Array.isArray(remainingRoot)) {
160
- return (
161
- /**
162
- * @type {import('../jsdocUtils.js').FlattendRootInfo & {
163
- * annotationParamName?: string|undefined;
164
- * }}
165
- */
166
- remainingRoot[1].names.includes(name)
167
- );
168
- }
169
- if (typeof remainingRoot === 'object') {
170
- return name === remainingRoot.name;
171
- }
172
- return name === remainingRoot;
173
- });
174
- });
175
- const tags = foundIndex > -1 ? jsdocTags.slice(0, foundIndex) : jsdocTags.filter(({
176
- tag
177
- }) => {
178
- return tag === preferredTagName;
179
- });
180
- let tagLineCount = 0;
181
- for (const {
182
- source
183
- } of tags) {
184
- for (const {
185
- tokens: {
186
- end
187
- }
188
- } of source) {
189
- if (!end) {
190
- tagLineCount++;
191
- }
192
- }
193
- }
194
- return tagLineCount;
195
- };
196
- let [nextRootName, incremented, namer] = rootNamer([...unnamedRootBase], autoIncrementBase);
197
- const thisOffset = functionParameterNames[0] === 'this' ? 1 : 0;
198
- for (const [functionParameterIdx, functionParameterName] of functionParameterNames.entries()) {
199
- let inc;
200
- if (Array.isArray(functionParameterName)) {
201
- const matchedJsdoc = shallowJsdocParameterNames[functionParameterIdx - thisOffset];
202
-
203
- /** @type {string} */
204
- let rootName;
205
- if (functionParameterName[0]) {
206
- rootName = functionParameterName[0];
207
- } else if (matchedJsdoc && matchedJsdoc.name) {
208
- rootName = matchedJsdoc.name;
209
- if (matchedJsdoc.type && matchedJsdoc.type.search(checkTypesRegex) === -1) {
210
- continue;
211
- }
212
- } else {
213
- rootName = nextRootName;
214
- inc = incremented;
215
- }
216
- [nextRootName, incremented, namer] = namer();
217
- const {
218
- hasPropertyRest,
219
- hasRestElement,
220
- names,
221
- rests
222
- } =
223
- /**
224
- * @type {import('../jsdocUtils.js').FlattendRootInfo & {
225
- * annotationParamName?: string | undefined;
226
- * }}
227
- */
228
- functionParameterName[1];
229
- const notCheckingNames = [];
230
- if (!enableRestElementFixer && hasRestElement) {
231
- continue;
232
- }
233
- if (!checkDestructuredRoots) {
234
- continue;
235
- }
236
- for (const [idx, paramName] of names.entries()) {
237
- // Add root if the root name is not in the docs (and is not already
238
- // in the tags to be fixed)
239
- if (!jsdocParameterNames.find(({
240
- name
241
- }) => {
242
- return name === rootName;
243
- }) && !missingTags.find(({
244
- functionParameterName: fpn
245
- }) => {
246
- return fpn === rootName;
247
- })) {
248
- const emptyParamIdx = jsdocParameterNames.findIndex(({
249
- name
250
- }) => {
251
- return !name;
252
- });
253
- if (emptyParamIdx > -1) {
254
- missingTags.push({
255
- functionParameterIdx: emptyParamIdx,
256
- functionParameterName: rootName,
257
- inc,
258
- remove: true
259
- });
260
- } else {
261
- missingTags.push({
262
- functionParameterIdx: hasParamIndex(rootName) ? getParamIndex(rootName) : getParamIndex(paramName),
263
- functionParameterName: rootName,
264
- inc
265
- });
266
- }
267
- }
268
- if (!checkDestructured) {
269
- continue;
270
- }
271
- if (!checkRestProperty && rests[idx]) {
272
- continue;
273
- }
274
- const fullParamName = `${rootName}.${paramName}`;
275
- const notCheckingName = jsdocParameterNames.find(({
276
- name,
277
- type: paramType
278
- }) => {
279
- return utils.comparePaths(name)(fullParamName) && paramType.search(checkTypesRegex) === -1 && paramType !== '';
280
- });
281
- if (notCheckingName !== undefined) {
282
- notCheckingNames.push(notCheckingName.name);
283
- }
284
- if (notCheckingNames.find(name => {
285
- return fullParamName.startsWith(name);
286
- })) {
287
- continue;
288
- }
289
- if (jsdocParameterNames && !jsdocParameterNames.find(({
290
- name
291
- }) => {
292
- return utils.comparePaths(name)(fullParamName);
293
- })) {
294
- missingTags.push({
295
- functionParameterIdx: getParamIndex(functionParameterName[0] ? fullParamName : paramName),
296
- functionParameterName: fullParamName,
297
- inc,
298
- type: hasRestElement && !hasPropertyRest ? '{...any}' : undefined
299
- });
300
- }
301
- }
302
- continue;
303
- }
304
-
305
- /** @type {string} */
306
- let funcParamName;
307
- let type;
308
- if (typeof functionParameterName === 'object') {
309
- if (!enableRestElementFixer && functionParameterName.restElement) {
310
- continue;
311
- }
312
- funcParamName = /** @type {string} */functionParameterName.name;
313
- type = '{...any}';
314
- } else {
315
- funcParamName = /** @type {string} */functionParameterName;
316
- }
317
- if (jsdocParameterNames && !jsdocParameterNames.find(({
318
- name
319
- }) => {
320
- return name === funcParamName;
321
- }) && funcParamName !== 'this') {
322
- missingTags.push({
323
- functionParameterIdx: getParamIndex(funcParamName),
324
- functionParameterName: funcParamName,
325
- inc,
326
- type
327
- });
328
- }
329
- }
330
-
331
- /**
332
- *
333
- * @param {{
334
- * functionParameterIdx: import('../iterateJsdoc.js').Integer,
335
- * functionParameterName: string,
336
- * remove?: true,
337
- * inc?: boolean,
338
- * type?: string
339
- * }} cfg
340
- */
341
- const fix = ({
342
- functionParameterIdx,
343
- functionParameterName,
344
- inc,
345
- remove,
346
- type
347
- }) => {
348
- if (inc && !enableRootFixer) {
349
- return;
350
- }
351
-
352
- /**
353
- *
354
- * @param {import('../iterateJsdoc.js').Integer} tagIndex
355
- * @param {import('../iterateJsdoc.js').Integer} sourceIndex
356
- * @param {import('../iterateJsdoc.js').Integer} spliceCount
357
- * @returns {void}
358
- */
359
- const createTokens = (tagIndex, sourceIndex, spliceCount) => {
360
- // console.log(sourceIndex, tagIndex, jsdoc.tags, jsdoc.source);
361
- const tokens = {
362
- number: sourceIndex + 1,
363
- source: '',
364
- tokens: {
365
- delimiter: '*',
366
- description: '',
367
- end: '',
368
- lineEnd: '',
369
- name: functionParameterName,
370
- newAdd: true,
371
- postDelimiter: ' ',
372
- postName: '',
373
- postTag: ' ',
374
- postType: type ? ' ' : '',
375
- start: jsdoc.source[sourceIndex].tokens.start,
376
- tag: `@${preferredTagName}`,
377
- type: type ?? ''
378
- }
379
- };
380
-
381
- /**
382
- * @type {(import('@es-joy/jsdoccomment').JsdocTagWithInline & {
383
- * newAdd?: true
384
- * })[]}
385
- */
386
- jsdoc.tags.splice(tagIndex, spliceCount, {
387
- description: '',
388
- inlineTags: [],
389
- name: functionParameterName,
390
- newAdd: true,
391
- optional: false,
392
- problems: [],
393
- source: [tokens],
394
- tag: preferredTagName,
395
- type: type ?? ''
396
- });
397
- const firstNumber = jsdoc.source[0].number;
398
- jsdoc.source.splice(sourceIndex, spliceCount, tokens);
399
- for (const [idx, src] of jsdoc.source.slice(sourceIndex).entries()) {
400
- src.number = firstNumber + sourceIndex + idx;
401
- }
402
- };
403
- const offset = jsdoc.source.findIndex(({
404
- tokens: {
405
- end,
406
- tag
407
- }
408
- }) => {
409
- return tag || end;
410
- });
411
- if (remove) {
412
- createTokens(functionParameterIdx, offset + functionParameterIdx, 1);
413
- } else {
414
- const expectedIdx = findExpectedIndex(jsdoc.tags, functionParameterIdx);
415
- createTokens(expectedIdx, offset + expectedIdx, 0);
416
- }
417
- };
418
-
419
- /**
420
- * @returns {void}
421
- */
422
- const fixer = () => {
423
- for (const missingTag of missingTags) {
424
- fix(missingTag);
425
- }
426
- };
427
- if (missingTags.length && jsdoc.source.length === 1) {
428
- utils.makeMultiline();
429
- }
430
- for (const {
431
- functionParameterName
432
- } of missingTags) {
433
- utils.reportJSDoc(`Missing JSDoc @${preferredTagName} "${functionParameterName}" declaration.`, null, enableFixer ? fixer : null);
434
- }
30
+ var requireParam_default = require_iterateJsdoc.default(({ context, jsdoc, utils }) => {
31
+ if (utils.avoidDocs()) return;
32
+ if (utils.hasTag("type")) return;
33
+ const { autoIncrementBase = 0, checkDestructured = true, checkDestructuredRoots = true, checkRestProperty = false, checkTypesPattern = "/^(?:[oO]bject|[aA]rray|PlainObject|Generic(?:Object|Array))$/", enableFixer = true, enableRestElementFixer = true, enableRootFixer = true, ignoreWhenAllParamsMissing = false, unnamedRootBase = ["root"], useDefaultObjectProperties = false } = context.options[0] || {};
34
+ const preferredTagName = utils.getPreferredTagName({ tagName: "param" });
35
+ if (!preferredTagName) return;
36
+ const functionParameterNames = utils.getFunctionParameterNames(useDefaultObjectProperties);
37
+ if (!functionParameterNames.length) return;
38
+ const jsdocParameterNames = utils.getJsdocTagsDeep(preferredTagName);
39
+ if (ignoreWhenAllParamsMissing && !jsdocParameterNames.length) return;
40
+ const shallowJsdocParameterNames = jsdocParameterNames.filter((tag) => {
41
+ return !tag.name.includes(".");
42
+ }).map((tag, idx) => {
43
+ return {
44
+ ...tag,
45
+ idx
46
+ };
47
+ });
48
+ const checkTypesRegex = utils.getRegexFromString(checkTypesPattern);
49
+ /**
50
+ * @type {{
51
+ * functionParameterIdx: import('../iterateJsdoc.js').Integer,
52
+ * functionParameterName: string,
53
+ * inc: boolean|undefined,
54
+ * remove?: true,
55
+ * type?: string|undefined
56
+ * }[]}
57
+ */
58
+ const missingTags = [];
59
+ const flattenedRoots = utils.flattenRoots(functionParameterNames).names;
60
+ /**
61
+ * @type {{
62
+ * [key: string]: import('../iterateJsdoc.js').Integer
63
+ * }}
64
+ */
65
+ const paramIndex = {};
66
+ /**
67
+ * @param {string} cur
68
+ * @returns {boolean}
69
+ */
70
+ const hasParamIndex = (cur) => {
71
+ return utils.dropPathSegmentQuotes(String(cur)) in paramIndex;
72
+ };
73
+ /**
74
+ *
75
+ * @param {string|number|undefined} cur
76
+ * @returns {import('../iterateJsdoc.js').Integer}
77
+ */
78
+ const getParamIndex = (cur) => {
79
+ return paramIndex[utils.dropPathSegmentQuotes(String(cur))];
80
+ };
81
+ /**
82
+ *
83
+ * @param {string} cur
84
+ * @param {import('../iterateJsdoc.js').Integer} idx
85
+ * @returns {void}
86
+ */
87
+ const setParamIndex = (cur, idx) => {
88
+ paramIndex[utils.dropPathSegmentQuotes(String(cur))] = idx;
89
+ };
90
+ for (const [idx, cur] of flattenedRoots.entries()) setParamIndex(cur, idx);
91
+ /**
92
+ *
93
+ * @param {(import('@es-joy/jsdoccomment').JsdocTagWithInline & {
94
+ * newAdd?: boolean
95
+ * })[]} jsdocTags
96
+ * @param {import('../iterateJsdoc.js').Integer} indexAtFunctionParams
97
+ * @returns {import('../iterateJsdoc.js').Integer}
98
+ */
99
+ const findExpectedIndex = (jsdocTags, indexAtFunctionParams) => {
100
+ const remainingRoots = functionParameterNames.slice(indexAtFunctionParams || 0);
101
+ const foundIndex = jsdocTags.findIndex(({ name, newAdd }) => {
102
+ return !newAdd && remainingRoots.some((remainingRoot) => {
103
+ if (Array.isArray(remainingRoot)) return remainingRoot[1].names.includes(name);
104
+ if (typeof remainingRoot === "object") return name === remainingRoot.name;
105
+ return name === remainingRoot;
106
+ });
107
+ });
108
+ const tags = foundIndex > -1 ? jsdocTags.slice(0, foundIndex) : jsdocTags.filter(({ tag }) => {
109
+ return tag === preferredTagName;
110
+ });
111
+ let tagLineCount = 0;
112
+ for (const { source } of tags) for (const { tokens: { end } } of source) if (!end) tagLineCount++;
113
+ return tagLineCount;
114
+ };
115
+ let [nextRootName, incremented, namer] = rootNamer([...unnamedRootBase], autoIncrementBase);
116
+ const thisOffset = functionParameterNames[0] === "this" ? 1 : 0;
117
+ for (const [functionParameterIdx, functionParameterName] of functionParameterNames.entries()) {
118
+ let inc;
119
+ if (Array.isArray(functionParameterName)) {
120
+ const matchedJsdoc = shallowJsdocParameterNames[functionParameterIdx - thisOffset];
121
+ /** @type {string} */
122
+ let rootName;
123
+ if (functionParameterName[0]) rootName = functionParameterName[0];
124
+ else if (matchedJsdoc && matchedJsdoc.name) {
125
+ rootName = matchedJsdoc.name;
126
+ if (matchedJsdoc.type && matchedJsdoc.type.search(checkTypesRegex) === -1) continue;
127
+ } else {
128
+ rootName = nextRootName;
129
+ inc = incremented;
130
+ }
131
+ [nextRootName, incremented, namer] = namer();
132
+ const { hasPropertyRest, hasRestElement, names, rests } = functionParameterName[1];
133
+ const notCheckingNames = [];
134
+ if (!enableRestElementFixer && hasRestElement) continue;
135
+ if (!checkDestructuredRoots) continue;
136
+ for (const [idx, paramName] of names.entries()) {
137
+ if (!jsdocParameterNames.find(({ name }) => {
138
+ return name === rootName;
139
+ }) && !missingTags.find(({ functionParameterName: fpn }) => {
140
+ return fpn === rootName;
141
+ })) {
142
+ const emptyParamIdx = jsdocParameterNames.findIndex(({ name }) => {
143
+ return !name;
144
+ });
145
+ if (emptyParamIdx > -1) missingTags.push({
146
+ functionParameterIdx: emptyParamIdx,
147
+ functionParameterName: rootName,
148
+ inc,
149
+ remove: true
150
+ });
151
+ else missingTags.push({
152
+ functionParameterIdx: hasParamIndex(rootName) ? getParamIndex(rootName) : getParamIndex(paramName),
153
+ functionParameterName: rootName,
154
+ inc
155
+ });
156
+ }
157
+ if (!checkDestructured) continue;
158
+ if (!checkRestProperty && rests[idx]) continue;
159
+ const fullParamName = `${rootName}.${paramName}`;
160
+ const notCheckingName = jsdocParameterNames.find(({ name, type: paramType }) => {
161
+ return utils.comparePaths(name)(fullParamName) && paramType.search(checkTypesRegex) === -1 && paramType !== "";
162
+ });
163
+ if (notCheckingName !== void 0) notCheckingNames.push(notCheckingName.name);
164
+ if (notCheckingNames.find((name) => {
165
+ return fullParamName.startsWith(name);
166
+ })) continue;
167
+ if (jsdocParameterNames && !jsdocParameterNames.find(({ name }) => {
168
+ return utils.comparePaths(name)(fullParamName);
169
+ })) missingTags.push({
170
+ functionParameterIdx: getParamIndex(functionParameterName[0] ? fullParamName : paramName),
171
+ functionParameterName: fullParamName,
172
+ inc,
173
+ type: hasRestElement && !hasPropertyRest ? "{...any}" : void 0
174
+ });
175
+ }
176
+ continue;
177
+ }
178
+ /** @type {string} */
179
+ let funcParamName;
180
+ let type;
181
+ if (typeof functionParameterName === "object") {
182
+ if (!enableRestElementFixer && functionParameterName.restElement) continue;
183
+ funcParamName = functionParameterName.name;
184
+ type = "{...any}";
185
+ } else funcParamName = functionParameterName;
186
+ if (jsdocParameterNames && !jsdocParameterNames.find(({ name }) => {
187
+ return name === funcParamName;
188
+ }) && funcParamName !== "this") missingTags.push({
189
+ functionParameterIdx: getParamIndex(funcParamName),
190
+ functionParameterName: funcParamName,
191
+ inc,
192
+ type
193
+ });
194
+ }
195
+ /**
196
+ *
197
+ * @param {{
198
+ * functionParameterIdx: import('../iterateJsdoc.js').Integer,
199
+ * functionParameterName: string,
200
+ * remove?: true,
201
+ * inc?: boolean,
202
+ * type?: string
203
+ * }} cfg
204
+ */
205
+ const fix = ({ functionParameterIdx, functionParameterName, inc, remove, type }) => {
206
+ if (inc && !enableRootFixer) return;
207
+ /**
208
+ *
209
+ * @param {import('../iterateJsdoc.js').Integer} tagIndex
210
+ * @param {import('../iterateJsdoc.js').Integer} sourceIndex
211
+ * @param {import('../iterateJsdoc.js').Integer} spliceCount
212
+ * @returns {void}
213
+ */
214
+ const createTokens = (tagIndex, sourceIndex, spliceCount) => {
215
+ const tokens = {
216
+ number: sourceIndex + 1,
217
+ source: "",
218
+ tokens: {
219
+ delimiter: "*",
220
+ description: "",
221
+ end: "",
222
+ lineEnd: "",
223
+ name: functionParameterName,
224
+ newAdd: true,
225
+ postDelimiter: " ",
226
+ postName: "",
227
+ postTag: " ",
228
+ postType: type ? " " : "",
229
+ start: jsdoc.source[sourceIndex].tokens.start,
230
+ tag: `@${preferredTagName}`,
231
+ type: type ?? ""
232
+ }
233
+ };
234
+ /**
235
+ * @type {(import('@es-joy/jsdoccomment').JsdocTagWithInline & {
236
+ * newAdd?: true
237
+ * })[]}
238
+ */ jsdoc.tags.splice(tagIndex, spliceCount, {
239
+ description: "",
240
+ inlineTags: [],
241
+ name: functionParameterName,
242
+ newAdd: true,
243
+ optional: false,
244
+ problems: [],
245
+ source: [tokens],
246
+ tag: preferredTagName,
247
+ type: type ?? ""
248
+ });
249
+ const firstNumber = jsdoc.source[0].number;
250
+ jsdoc.source.splice(sourceIndex, spliceCount, tokens);
251
+ for (const [idx, src] of jsdoc.source.slice(sourceIndex).entries()) src.number = firstNumber + sourceIndex + idx;
252
+ };
253
+ const offset = jsdoc.source.findIndex(({ tokens: { end, tag } }) => {
254
+ return tag || end;
255
+ });
256
+ if (remove) createTokens(functionParameterIdx, offset + functionParameterIdx, 1);
257
+ else {
258
+ const expectedIdx = findExpectedIndex(jsdoc.tags, functionParameterIdx);
259
+ createTokens(expectedIdx, offset + expectedIdx, 0);
260
+ }
261
+ };
262
+ /**
263
+ * @returns {void}
264
+ */
265
+ const fixer = () => {
266
+ for (const missingTag of missingTags) fix(missingTag);
267
+ };
268
+ if (missingTags.length && jsdoc.source.length === 1) utils.makeMultiline();
269
+ for (const { functionParameterName } of missingTags) utils.reportJSDoc(`Missing JSDoc @${preferredTagName} "${functionParameterName}" declaration.`, null, enableFixer ? fixer : null);
435
270
  }, {
436
- contextDefaults: true,
437
- meta: {
438
- docs: {
439
- description: 'Requires that all function parameters are documented.',
440
- url: 'https://github.com/gajus/eslint-plugin-jsdoc/blob/main/docs/rules/require-param.md#repos-sticky-header'
441
- },
442
- fixable: 'code',
443
- schema: [{
444
- additionalProperties: false,
445
- properties: {
446
- autoIncrementBase: {
447
- default: 0,
448
- type: 'integer'
449
- },
450
- checkConstructors: {
451
- default: true,
452
- type: 'boolean'
453
- },
454
- checkDestructured: {
455
- default: true,
456
- type: 'boolean'
457
- },
458
- checkDestructuredRoots: {
459
- default: true,
460
- type: 'boolean'
461
- },
462
- checkGetters: {
463
- default: false,
464
- type: 'boolean'
465
- },
466
- checkRestProperty: {
467
- default: false,
468
- type: 'boolean'
469
- },
470
- checkSetters: {
471
- default: false,
472
- type: 'boolean'
473
- },
474
- checkTypesPattern: {
475
- type: 'string'
476
- },
477
- contexts: {
478
- items: {
479
- anyOf: [{
480
- type: 'string'
481
- }, {
482
- additionalProperties: false,
483
- properties: {
484
- comment: {
485
- type: 'string'
486
- },
487
- context: {
488
- type: 'string'
489
- }
490
- },
491
- type: 'object'
492
- }]
493
- },
494
- type: 'array'
495
- },
496
- enableFixer: {
497
- type: 'boolean'
498
- },
499
- enableRestElementFixer: {
500
- type: 'boolean'
501
- },
502
- enableRootFixer: {
503
- type: 'boolean'
504
- },
505
- exemptedBy: {
506
- items: {
507
- type: 'string'
508
- },
509
- type: 'array'
510
- },
511
- ignoreWhenAllParamsMissing: {
512
- type: 'boolean'
513
- },
514
- unnamedRootBase: {
515
- items: {
516
- type: 'string'
517
- },
518
- type: 'array'
519
- },
520
- useDefaultObjectProperties: {
521
- type: 'boolean'
522
- }
523
- },
524
- type: 'object'
525
- }],
526
- type: 'suggestion'
527
- },
528
- // We cannot cache comment nodes as the contexts may recur with the
529
- // same comment node but a different JS node, and we may need the different
530
- // JS node to ensure we iterate its context
531
- noTracking: true
271
+ contextDefaults: true,
272
+ meta: {
273
+ docs: {
274
+ description: "Requires that all function parameters are documented.",
275
+ url: "https://github.com/gajus/eslint-plugin-jsdoc/blob/main/docs/rules/require-param.md#repos-sticky-header"
276
+ },
277
+ fixable: "code",
278
+ schema: [{
279
+ additionalProperties: false,
280
+ properties: {
281
+ autoIncrementBase: {
282
+ default: 0,
283
+ type: "integer"
284
+ },
285
+ checkConstructors: {
286
+ default: true,
287
+ type: "boolean"
288
+ },
289
+ checkDestructured: {
290
+ default: true,
291
+ type: "boolean"
292
+ },
293
+ checkDestructuredRoots: {
294
+ default: true,
295
+ type: "boolean"
296
+ },
297
+ checkGetters: {
298
+ default: false,
299
+ type: "boolean"
300
+ },
301
+ checkRestProperty: {
302
+ default: false,
303
+ type: "boolean"
304
+ },
305
+ checkSetters: {
306
+ default: false,
307
+ type: "boolean"
308
+ },
309
+ checkTypesPattern: { type: "string" },
310
+ contexts: {
311
+ items: { anyOf: [{ type: "string" }, {
312
+ additionalProperties: false,
313
+ properties: {
314
+ comment: { type: "string" },
315
+ context: { type: "string" }
316
+ },
317
+ type: "object"
318
+ }] },
319
+ type: "array"
320
+ },
321
+ enableFixer: { type: "boolean" },
322
+ enableRestElementFixer: { type: "boolean" },
323
+ enableRootFixer: { type: "boolean" },
324
+ exemptedBy: {
325
+ items: { type: "string" },
326
+ type: "array"
327
+ },
328
+ ignoreWhenAllParamsMissing: { type: "boolean" },
329
+ unnamedRootBase: {
330
+ items: { type: "string" },
331
+ type: "array"
332
+ },
333
+ useDefaultObjectProperties: { type: "boolean" }
334
+ },
335
+ type: "object"
336
+ }],
337
+ type: "suggestion"
338
+ },
339
+ noTracking: true
532
340
  });
533
- module.exports = exports.default;
341
+
342
+ //#endregion
343
+ exports.default = requireParam_default;
534
344
  //# sourceMappingURL=requireParam.cjs.map