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.
- package/dist/WarnSettings.cjs +18 -35
- package/dist/WarnSettings.cjs.map +1 -1
- package/dist/WarnSettings.js +20 -0
- package/dist/WarnSettings.js.map +1 -0
- package/dist/_virtual/rolldown_runtime.cjs +32 -0
- package/dist/_virtual/rolldown_runtime.js +11 -0
- package/dist/alignTransform.cjs +224 -305
- package/dist/alignTransform.cjs.map +1 -1
- package/dist/alignTransform.js +241 -0
- package/dist/alignTransform.js.map +1 -0
- package/dist/defaultTagOrder.cjs +132 -43
- package/dist/defaultTagOrder.cjs.map +1 -1
- package/dist/defaultTagOrder.js +134 -0
- package/dist/defaultTagOrder.js.map +1 -0
- package/dist/exportParser.cjs +478 -696
- package/dist/exportParser.cjs.map +1 -1
- package/dist/exportParser.js +518 -0
- package/dist/exportParser.js.map +1 -0
- package/dist/getDefaultTagStructureForMode.cjs +184 -288
- package/dist/getDefaultTagStructureForMode.cjs.map +1 -1
- package/dist/getDefaultTagStructureForMode.js +188 -0
- package/dist/getDefaultTagStructureForMode.js.map +1 -0
- package/dist/getJsdocProcessorPlugin.cjs +365 -532
- package/dist/getJsdocProcessorPlugin.cjs.map +1 -1
- package/dist/getJsdocProcessorPlugin.d.cts +70 -0
- package/dist/getJsdocProcessorPlugin.d.cts.map +1 -0
- package/dist/getJsdocProcessorPlugin.d.ts +68 -90
- package/dist/getJsdocProcessorPlugin.d.ts.map +1 -1
- package/dist/getJsdocProcessorPlugin.js +383 -0
- package/dist/getJsdocProcessorPlugin.js.map +1 -0
- package/dist/index.cjs +398 -383
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.cts +22 -0
- package/dist/index.d.cts.map +1 -0
- package/dist/index.d.ts +11 -6
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +425 -0
- package/dist/index.js.map +1 -0
- package/dist/iterateJsdoc.cjs +1528 -1988
- package/dist/iterateJsdoc.cjs.map +1 -1
- package/dist/iterateJsdoc.d.cts +471 -0
- package/dist/iterateJsdoc.d.cts.map +1 -0
- package/dist/iterateJsdoc.d.ts +358 -349
- package/dist/iterateJsdoc.d.ts.map +1 -1
- package/dist/iterateJsdoc.js +1617 -0
- package/dist/iterateJsdoc.js.map +1 -0
- package/dist/jsdocUtils.cjs +1009 -1376
- package/dist/jsdocUtils.cjs.map +1 -1
- package/dist/jsdocUtils.js +1123 -0
- package/dist/jsdocUtils.js.map +1 -0
- package/dist/rules/checkAccess.cjs +29 -36
- package/dist/rules/checkAccess.cjs.map +1 -1
- package/dist/rules/checkAccess.js +33 -0
- package/dist/rules/checkAccess.js.map +1 -0
- package/dist/rules/checkAlignment.cjs +41 -54
- package/dist/rules/checkAlignment.cjs.map +1 -1
- package/dist/rules/checkAlignment.js +47 -0
- package/dist/rules/checkAlignment.js.map +1 -0
- package/dist/rules/checkExamples.cjs +327 -484
- package/dist/rules/checkExamples.cjs.map +1 -1
- package/dist/rules/checkExamples.js +348 -0
- package/dist/rules/checkExamples.js.map +1 -0
- package/dist/rules/checkIndentation.cjs +50 -65
- package/dist/rules/checkIndentation.cjs.map +1 -1
- package/dist/rules/checkIndentation.js +59 -0
- package/dist/rules/checkIndentation.js.map +1 -0
- package/dist/rules/checkLineAlignment.cjs +220 -311
- package/dist/rules/checkLineAlignment.cjs.map +1 -1
- package/dist/rules/checkLineAlignment.js +229 -0
- package/dist/rules/checkLineAlignment.js.map +1 -0
- package/dist/rules/checkParamNames.cjs +227 -335
- package/dist/rules/checkParamNames.cjs.map +1 -1
- package/dist/rules/checkParamNames.js +237 -0
- package/dist/rules/checkParamNames.js.map +1 -0
- package/dist/rules/checkPropertyNames.cjs +78 -106
- package/dist/rules/checkPropertyNames.cjs.map +1 -1
- package/dist/rules/checkPropertyNames.js +88 -0
- package/dist/rules/checkPropertyNames.js.map +1 -0
- package/dist/rules/checkSyntax.cjs +21 -34
- package/dist/rules/checkSyntax.cjs.map +1 -1
- package/dist/rules/checkSyntax.js +25 -0
- package/dist/rules/checkSyntax.js.map +1 -0
- package/dist/rules/checkTagNames.cjs +188 -210
- package/dist/rules/checkTagNames.cjs.map +1 -1
- package/dist/rules/checkTagNames.js +191 -0
- package/dist/rules/checkTagNames.js.map +1 -0
- package/dist/rules/checkTemplateNames.cjs +121 -178
- package/dist/rules/checkTemplateNames.cjs.map +1 -1
- package/dist/rules/checkTemplateNames.js +124 -0
- package/dist/rules/checkTemplateNames.js.map +1 -0
- package/dist/rules/checkTypes.cjs +291 -385
- package/dist/rules/checkTypes.cjs.map +1 -1
- package/dist/rules/checkTypes.js +299 -0
- package/dist/rules/checkTypes.js.map +1 -0
- package/dist/rules/checkValues.cjs +100 -146
- package/dist/rules/checkValues.cjs.map +1 -1
- package/dist/rules/checkValues.js +103 -0
- package/dist/rules/checkValues.js.map +1 -0
- package/dist/rules/convertToJsdocComments.cjs +228 -306
- package/dist/rules/convertToJsdocComments.cjs.map +1 -1
- package/dist/rules/convertToJsdocComments.js +231 -0
- package/dist/rules/convertToJsdocComments.js.map +1 -0
- package/dist/rules/emptyTags.cjs +62 -72
- package/dist/rules/emptyTags.cjs.map +1 -1
- package/dist/rules/emptyTags.js +67 -0
- package/dist/rules/emptyTags.js.map +1 -0
- package/dist/rules/implementsOnClasses.cjs +36 -56
- package/dist/rules/implementsOnClasses.cjs.map +1 -1
- package/dist/rules/implementsOnClasses.js +40 -0
- package/dist/rules/implementsOnClasses.js.map +1 -0
- package/dist/rules/importsAsDependencies.cjs +62 -99
- package/dist/rules/importsAsDependencies.cjs.map +1 -1
- package/dist/rules/importsAsDependencies.js +68 -0
- package/dist/rules/importsAsDependencies.js.map +1 -0
- package/dist/rules/informativeDocs.cjs +105 -142
- package/dist/rules/informativeDocs.cjs.map +1 -1
- package/dist/rules/informativeDocs.js +110 -0
- package/dist/rules/informativeDocs.js.map +1 -0
- package/dist/rules/linesBeforeBlock.cjs +70 -105
- package/dist/rules/linesBeforeBlock.cjs.map +1 -1
- package/dist/rules/linesBeforeBlock.js +75 -0
- package/dist/rules/linesBeforeBlock.js.map +1 -0
- package/dist/rules/matchDescription.cjs +160 -222
- package/dist/rules/matchDescription.cjs.map +1 -1
- package/dist/rules/matchDescription.js +167 -0
- package/dist/rules/matchDescription.js.map +1 -0
- package/dist/rules/matchName.cjs +73 -128
- package/dist/rules/matchName.cjs.map +1 -1
- package/dist/rules/matchName.js +77 -0
- package/dist/rules/matchName.js.map +1 -0
- package/dist/rules/multilineBlocks.cjs +235 -352
- package/dist/rules/multilineBlocks.cjs.map +1 -1
- package/dist/rules/multilineBlocks.js +245 -0
- package/dist/rules/multilineBlocks.js.map +1 -0
- package/dist/rules/noBadBlocks.cjs +63 -86
- package/dist/rules/noBadBlocks.cjs.map +1 -1
- package/dist/rules/noBadBlocks.js +68 -0
- package/dist/rules/noBadBlocks.js.map +1 -0
- package/dist/rules/noBlankBlockDescriptions.cjs +35 -57
- package/dist/rules/noBlankBlockDescriptions.cjs.map +1 -1
- package/dist/rules/noBlankBlockDescriptions.js +41 -0
- package/dist/rules/noBlankBlockDescriptions.js.map +1 -0
- package/dist/rules/noBlankBlocks.cjs +26 -48
- package/dist/rules/noBlankBlocks.cjs.map +1 -1
- package/dist/rules/noBlankBlocks.js +30 -0
- package/dist/rules/noBlankBlocks.js.map +1 -0
- package/dist/rules/noDefaults.cjs +52 -79
- package/dist/rules/noDefaults.cjs.map +1 -1
- package/dist/rules/noDefaults.js +56 -0
- package/dist/rules/noDefaults.js.map +1 -0
- package/dist/rules/noMissingSyntax.cjs +115 -165
- package/dist/rules/noMissingSyntax.cjs.map +1 -1
- package/dist/rules/noMissingSyntax.js +126 -0
- package/dist/rules/noMissingSyntax.js.map +1 -0
- package/dist/rules/noMultiAsterisks.cjs +48 -89
- package/dist/rules/noMultiAsterisks.cjs.map +1 -1
- package/dist/rules/noMultiAsterisks.js +58 -0
- package/dist/rules/noMultiAsterisks.js.map +1 -0
- package/dist/rules/noRestrictedSyntax.cjs +45 -79
- package/dist/rules/noRestrictedSyntax.cjs.map +1 -1
- package/dist/rules/noRestrictedSyntax.js +49 -0
- package/dist/rules/noRestrictedSyntax.js.map +1 -0
- package/dist/rules/noTypes.cjs +59 -80
- package/dist/rules/noTypes.cjs.map +1 -1
- package/dist/rules/noTypes.js +65 -0
- package/dist/rules/noTypes.js.map +1 -0
- package/dist/rules/noUndefinedTypes.cjs +297 -388
- package/dist/rules/noUndefinedTypes.cjs.map +1 -1
- package/dist/rules/noUndefinedTypes.js +303 -0
- package/dist/rules/noUndefinedTypes.js.map +1 -0
- package/dist/rules/requireAsteriskPrefix.cjs +108 -159
- package/dist/rules/requireAsteriskPrefix.cjs.map +1 -1
- package/dist/rules/requireAsteriskPrefix.js +112 -0
- package/dist/rules/requireAsteriskPrefix.js.map +1 -0
- package/dist/rules/requireDescription.cjs +89 -129
- package/dist/rules/requireDescription.cjs.map +1 -1
- package/dist/rules/requireDescription.js +95 -0
- package/dist/rules/requireDescription.js.map +1 -0
- package/dist/rules/requireDescriptionCompleteSentence.cjs +201 -262
- package/dist/rules/requireDescriptionCompleteSentence.cjs.map +1 -1
- package/dist/rules/requireDescriptionCompleteSentence.js +220 -0
- package/dist/rules/requireDescriptionCompleteSentence.js.map +1 -0
- package/dist/rules/requireExample.cjs +73 -104
- package/dist/rules/requireExample.cjs.map +1 -1
- package/dist/rules/requireExample.js +77 -0
- package/dist/rules/requireExample.js.map +1 -0
- package/dist/rules/requireFileOverview.cjs +75 -129
- package/dist/rules/requireFileOverview.cjs.map +1 -1
- package/dist/rules/requireFileOverview.js +81 -0
- package/dist/rules/requireFileOverview.js.map +1 -0
- package/dist/rules/requireHyphenBeforeParamDescription.cjs +85 -133
- package/dist/rules/requireHyphenBeforeParamDescription.cjs.map +1 -1
- package/dist/rules/requireHyphenBeforeParamDescription.js +89 -0
- package/dist/rules/requireHyphenBeforeParamDescription.js.map +1 -0
- package/dist/rules/requireJsdoc.cjs +384 -557
- package/dist/rules/requireJsdoc.cjs.map +1 -1
- package/dist/rules/requireJsdoc.js +404 -0
- package/dist/rules/requireJsdoc.js.map +1 -0
- package/dist/rules/requireParam.cjs +336 -526
- package/dist/rules/requireParam.cjs.map +1 -1
- package/dist/rules/requireParam.js +344 -0
- package/dist/rules/requireParam.js.map +1 -0
- package/dist/rules/requireParamDescription.cjs +55 -80
- package/dist/rules/requireParamDescription.cjs.map +1 -1
- package/dist/rules/requireParamDescription.js +59 -0
- package/dist/rules/requireParamDescription.js.map +1 -0
- package/dist/rules/requireParamName.cjs +32 -50
- package/dist/rules/requireParamName.cjs.map +1 -1
- package/dist/rules/requireParamName.js +36 -0
- package/dist/rules/requireParamName.js.map +1 -0
- package/dist/rules/requireParamType.cjs +55 -80
- package/dist/rules/requireParamType.cjs.map +1 -1
- package/dist/rules/requireParamType.js +59 -0
- package/dist/rules/requireParamType.js.map +1 -0
- package/dist/rules/requireProperty.cjs +31 -42
- package/dist/rules/requireProperty.cjs.map +1 -1
- package/dist/rules/requireProperty.js +35 -0
- package/dist/rules/requireProperty.js.map +1 -0
- package/dist/rules/requirePropertyDescription.cjs +17 -25
- package/dist/rules/requirePropertyDescription.cjs.map +1 -1
- package/dist/rules/requirePropertyDescription.js +21 -0
- package/dist/rules/requirePropertyDescription.js.map +1 -0
- package/dist/rules/requirePropertyName.cjs +17 -25
- package/dist/rules/requirePropertyName.cjs.map +1 -1
- package/dist/rules/requirePropertyName.js +21 -0
- package/dist/rules/requirePropertyName.js.map +1 -0
- package/dist/rules/requirePropertyType.cjs +17 -25
- package/dist/rules/requirePropertyType.cjs.map +1 -1
- package/dist/rules/requirePropertyType.js +21 -0
- package/dist/rules/requirePropertyType.js.map +1 -0
- package/dist/rules/requireReturns.cjs +125 -203
- package/dist/rules/requireReturns.cjs.map +1 -1
- package/dist/rules/requireReturns.js +131 -0
- package/dist/rules/requireReturns.js.map +1 -0
- package/dist/rules/requireReturnsCheck.cjs +60 -103
- package/dist/rules/requireReturnsCheck.cjs.map +1 -1
- package/dist/rules/requireReturnsCheck.js +66 -0
- package/dist/rules/requireReturnsCheck.js.map +1 -0
- package/dist/rules/requireReturnsDescription.cjs +39 -54
- package/dist/rules/requireReturnsDescription.cjs.map +1 -1
- package/dist/rules/requireReturnsDescription.js +43 -0
- package/dist/rules/requireReturnsDescription.js.map +1 -0
- package/dist/rules/requireReturnsType.cjs +32 -50
- package/dist/rules/requireReturnsType.cjs.map +1 -1
- package/dist/rules/requireReturnsType.js +36 -0
- package/dist/rules/requireReturnsType.js.map +1 -0
- package/dist/rules/requireTemplate.cjs +119 -178
- package/dist/rules/requireTemplate.cjs.map +1 -1
- package/dist/rules/requireTemplate.js +122 -0
- package/dist/rules/requireTemplate.js.map +1 -0
- package/dist/rules/requireThrows.cjs +61 -95
- package/dist/rules/requireThrows.cjs.map +1 -1
- package/dist/rules/requireThrows.js +67 -0
- package/dist/rules/requireThrows.js.map +1 -0
- package/dist/rules/requireYields.cjs +106 -166
- package/dist/rules/requireYields.cjs.map +1 -1
- package/dist/rules/requireYields.js +115 -0
- package/dist/rules/requireYields.js.map +1 -0
- package/dist/rules/requireYieldsCheck.cjs +96 -152
- package/dist/rules/requireYieldsCheck.cjs.map +1 -1
- package/dist/rules/requireYieldsCheck.js +105 -0
- package/dist/rules/requireYieldsCheck.js.map +1 -0
- package/dist/rules/sortTags.cjs +258 -444
- package/dist/rules/sortTags.cjs.map +1 -1
- package/dist/rules/sortTags.js +262 -0
- package/dist/rules/sortTags.js.map +1 -0
- package/dist/rules/tagLines.cjs +179 -266
- package/dist/rules/tagLines.cjs.map +1 -1
- package/dist/rules/tagLines.js +183 -0
- package/dist/rules/tagLines.js.map +1 -0
- package/dist/rules/textEscaping.cjs +92 -127
- package/dist/rules/textEscaping.cjs.map +1 -1
- package/dist/rules/textEscaping.js +102 -0
- package/dist/rules/textEscaping.js.map +1 -0
- package/dist/rules/validTypes.cjs +252 -265
- package/dist/rules/validTypes.cjs.map +1 -1
- package/dist/rules/validTypes.js +259 -0
- package/dist/rules/validTypes.js.map +1 -0
- package/dist/tagNames.cjs +134 -170
- package/dist/tagNames.cjs.map +1 -1
- package/dist/tagNames.js +144 -0
- package/dist/tagNames.js.map +1 -0
- package/dist/utils/hasReturnValue.cjs +246 -474
- package/dist/utils/hasReturnValue.cjs.map +1 -1
- package/dist/utils/hasReturnValue.js +265 -0
- package/dist/utils/hasReturnValue.js.map +1 -0
- package/package.json +48 -38
- package/dist/generateRule.cjs +0 -242
- package/dist/generateRule.cjs.map +0 -1
- package/src/WarnSettings.js +0 -34
- package/src/alignTransform.js +0 -358
- package/src/defaultTagOrder.js +0 -169
- package/src/exportParser.js +0 -978
- package/src/getDefaultTagStructureForMode.js +0 -969
- package/src/getJsdocProcessorPlugin.js +0 -652
- package/src/index.js +0 -530
- package/src/iterateJsdoc.js +0 -2518
- package/src/jsdocUtils.js +0 -1896
- package/src/rules/checkAccess.js +0 -45
- package/src/rules/checkAlignment.js +0 -63
- package/src/rules/checkExamples.js +0 -589
- package/src/rules/checkIndentation.js +0 -75
- package/src/rules/checkLineAlignment.js +0 -372
- package/src/rules/checkParamNames.js +0 -474
- package/src/rules/checkPropertyNames.js +0 -152
- package/src/rules/checkSyntax.js +0 -30
- package/src/rules/checkTagNames.js +0 -314
- package/src/rules/checkTemplateNames.js +0 -204
- package/src/rules/checkTypes.js +0 -535
- package/src/rules/checkValues.js +0 -248
- package/src/rules/convertToJsdocComments.js +0 -398
- package/src/rules/emptyTags.js +0 -98
- package/src/rules/implementsOnClasses.js +0 -64
- package/src/rules/importsAsDependencies.js +0 -133
- package/src/rules/informativeDocs.js +0 -189
- package/src/rules/linesBeforeBlock.js +0 -134
- package/src/rules/matchDescription.js +0 -286
- package/src/rules/matchName.js +0 -151
- package/src/rules/multilineBlocks.js +0 -493
- package/src/rules/noBadBlocks.js +0 -119
- package/src/rules/noBlankBlockDescriptions.js +0 -69
- package/src/rules/noBlankBlocks.js +0 -53
- package/src/rules/noDefaults.js +0 -85
- package/src/rules/noMissingSyntax.js +0 -195
- package/src/rules/noMultiAsterisks.js +0 -134
- package/src/rules/noRestrictedSyntax.js +0 -91
- package/src/rules/noTypes.js +0 -93
- package/src/rules/noUndefinedTypes.js +0 -543
- package/src/rules/requireAsteriskPrefix.js +0 -190
- package/src/rules/requireDescription.js +0 -161
- package/src/rules/requireDescriptionCompleteSentence.js +0 -335
- package/src/rules/requireExample.js +0 -118
- package/src/rules/requireFileOverview.js +0 -154
- package/src/rules/requireHyphenBeforeParamDescription.js +0 -176
- package/src/rules/requireJsdoc.js +0 -743
- package/src/rules/requireParam.js +0 -602
- package/src/rules/requireParamDescription.js +0 -89
- package/src/rules/requireParamName.js +0 -55
- package/src/rules/requireParamType.js +0 -89
- package/src/rules/requireProperty.js +0 -48
- package/src/rules/requirePropertyDescription.js +0 -25
- package/src/rules/requirePropertyName.js +0 -25
- package/src/rules/requirePropertyType.js +0 -25
- package/src/rules/requireReturns.js +0 -238
- package/src/rules/requireReturnsCheck.js +0 -145
- package/src/rules/requireReturnsDescription.js +0 -59
- package/src/rules/requireReturnsType.js +0 -51
- package/src/rules/requireTemplate.js +0 -201
- package/src/rules/requireThrows.js +0 -111
- package/src/rules/requireYields.js +0 -216
- package/src/rules/requireYieldsCheck.js +0 -208
- package/src/rules/sortTags.js +0 -558
- package/src/rules/tagLines.js +0 -359
- package/src/rules/textEscaping.js +0 -154
- package/src/rules/validTypes.js +0 -401
- package/src/tagNames.js +0 -238
- package/src/utils/hasReturnValue.js +0 -572
package/dist/tagNames.cjs.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"tagNames.cjs","names":[
|
|
1
|
+
{"version":3,"file":"tagNames.cjs","names":[],"sources":["../src/tagNames.js"],"sourcesContent":["/**\n * @typedef {{\n * [key: string]: string[]\n * }} AliasedTags\n */\n\n/**\n * @type {AliasedTags}\n */\nconst jsdocTagsUndocumented = {\n // Undocumented but present; see\n // https://github.com/jsdoc/jsdoc/issues/1283#issuecomment-516816802\n // https://github.com/jsdoc/jsdoc/blob/master/packages/jsdoc/lib/jsdoc/tag/dictionary/definitions.js#L594\n modifies: [],\n};\n\n/**\n * @type {AliasedTags}\n */\nconst jsdocTags = {\n ...jsdocTagsUndocumented,\n abstract: [\n 'virtual',\n ],\n access: [],\n alias: [],\n async: [],\n augments: [\n 'extends',\n ],\n author: [],\n borrows: [],\n callback: [],\n class: [\n 'constructor',\n ],\n classdesc: [],\n constant: [\n 'const',\n ],\n constructs: [],\n copyright: [],\n default: [\n 'defaultvalue',\n ],\n deprecated: [],\n description: [\n 'desc',\n ],\n enum: [],\n event: [],\n example: [],\n exports: [],\n external: [\n 'host',\n ],\n file: [\n 'fileoverview',\n 'overview',\n ],\n fires: [\n 'emits',\n ],\n function: [\n 'func',\n 'method',\n ],\n generator: [],\n global: [],\n hideconstructor: [],\n ignore: [],\n implements: [],\n inheritdoc: [],\n\n // Allowing casing distinct from jsdoc `definitions.js` (required in Closure)\n inheritDoc: [],\n\n inner: [],\n instance: [],\n interface: [],\n kind: [],\n lends: [],\n license: [],\n listens: [],\n member: [\n 'var',\n ],\n memberof: [],\n 'memberof!': [],\n mixes: [],\n mixin: [],\n\n module: [],\n name: [],\n namespace: [],\n override: [],\n package: [],\n param: [\n 'arg',\n 'argument',\n ],\n private: [],\n property: [\n 'prop',\n ],\n protected: [],\n public: [],\n readonly: [],\n requires: [],\n returns: [\n 'return',\n ],\n see: [],\n since: [],\n static: [],\n summary: [],\n\n this: [],\n throws: [\n 'exception',\n ],\n todo: [],\n tutorial: [],\n type: [],\n typedef: [],\n variation: [],\n version: [],\n yields: [\n 'yield',\n ],\n};\n\n/**\n * @type {AliasedTags}\n */\nconst typeScriptTags = {\n ...jsdocTags,\n\n // https://github.com/microsoft/TypeScript/issues/22160\n // https://devblogs.microsoft.com/typescript/announcing-typescript-5-5/#the-jsdoc-import-tag\n import: [],\n\n // https://www.typescriptlang.org/tsconfig/#stripInternal\n internal: [],\n\n // https://devblogs.microsoft.com/typescript/announcing-typescript-5-0/#overload-support-in-jsdoc\n overload: [],\n\n // https://devblogs.microsoft.com/typescript/announcing-typescript-5-0/#satisfies-support-in-jsdoc\n satisfies: [],\n\n // `@template` is also in TypeScript per:\n // https://www.typescriptlang.org/docs/handbook/type-checking-javascript-files.html#supported-jsdoc\n template: [],\n};\n\n/**\n * @type {AliasedTags}\n */\nconst undocumentedClosureTags = {\n // These are in Closure source but not in jsdoc source nor in the Closure\n // docs: https://github.com/google/closure-compiler/blob/master/src/com/google/javascript/jscomp/parsing/Annotation.java\n closurePrimitive: [],\n customElement: [],\n expose: [],\n hidden: [],\n idGenerator: [],\n meaning: [],\n mixinClass: [],\n mixinFunction: [],\n ngInject: [],\n owner: [],\n typeSummary: [],\n wizaction: [],\n};\n\nconst {\n /* eslint-disable no-unused-vars */\n inheritdoc,\n internal,\n overload,\n // Will be inverted to prefer `return`\n returns,\n\n satisfies,\n /* eslint-enable no-unused-vars */\n ...typeScriptTagsInClosure\n} = typeScriptTags;\n\n/**\n * @type {AliasedTags}\n */\nconst closureTags = {\n ...typeScriptTagsInClosure,\n ...undocumentedClosureTags,\n\n // From https://github.com/google/closure-compiler/wiki/Annotating-JavaScript-for-the-Closure-Compiler\n // These are all recognized in https://github.com/jsdoc/jsdoc/blob/master/packages/jsdoc/lib/jsdoc/tag/dictionary/definitions.js\n // except for the experimental `noinline` and the casing differences noted below\n\n // Defined as a synonym of `const` in jsdoc `definitions.js`\n define: [],\n\n dict: [],\n export: [],\n externs: [],\n final: [],\n\n // With casing distinct from jsdoc `definitions.js`\n implicitCast: [],\n\n noalias: [],\n nocollapse: [],\n nocompile: [],\n noinline: [],\n nosideeffects: [],\n polymer: [],\n polymerBehavior: [],\n preserve: [],\n\n // Defined as a synonym of `interface` in jsdoc `definitions.js`\n record: [],\n\n return: [\n 'returns',\n ],\n\n struct: [],\n suppress: [],\n\n unrestricted: [],\n};\n\nexport {\n closureTags,\n jsdocTags,\n typeScriptTags,\n};\n"],"mappings":";;;;;;;;;;AASA,MAAM,wBAAwB,EAI5B,UAAU,CAAE,EACb;;;;AAKD,MAAM,YAAY;CAChB,GAAG;CACH,UAAU,CACR,SACD;CACD,QAAQ,CAAE;CACV,OAAO,CAAE;CACT,OAAO,CAAE;CACT,UAAU,CACR,SACD;CACD,QAAQ,CAAE;CACV,SAAS,CAAE;CACX,UAAU,CAAE;CACZ,OAAO,CACL,aACD;CACD,WAAW,CAAE;CACb,UAAU,CACR,OACD;CACD,YAAY,CAAE;CACd,WAAW,CAAE;CACb,SAAS,CACP,cACD;CACD,YAAY,CAAE;CACd,aAAa,CACX,MACD;CACD,MAAM,CAAE;CACR,OAAO,CAAE;CACT,SAAS,CAAE;CACX,SAAS,CAAE;CACX,UAAU,CACR,MACD;CACD,MAAM,CACJ,gBACA,UACD;CACD,OAAO,CACL,OACD;CACD,UAAU,CACR,QACA,QACD;CACD,WAAW,CAAE;CACb,QAAQ,CAAE;CACV,iBAAiB,CAAE;CACnB,QAAQ,CAAE;CACV,YAAY,CAAE;CACd,YAAY,CAAE;CAGd,YAAY,CAAE;CAEd,OAAO,CAAE;CACT,UAAU,CAAE;CACZ,WAAW,CAAE;CACb,MAAM,CAAE;CACR,OAAO,CAAE;CACT,SAAS,CAAE;CACX,SAAS,CAAE;CACX,QAAQ,CACN,KACD;CACD,UAAU,CAAE;CACZ,aAAa,CAAE;CACf,OAAO,CAAE;CACT,OAAO,CAAE;CAET,QAAQ,CAAE;CACV,MAAM,CAAE;CACR,WAAW,CAAE;CACb,UAAU,CAAE;CACZ,SAAS,CAAE;CACX,OAAO,CACL,OACA,UACD;CACD,SAAS,CAAE;CACX,UAAU,CACR,MACD;CACD,WAAW,CAAE;CACb,QAAQ,CAAE;CACV,UAAU,CAAE;CACZ,UAAU,CAAE;CACZ,SAAS,CACP,QACD;CACD,KAAK,CAAE;CACP,OAAO,CAAE;CACT,QAAQ,CAAE;CACV,SAAS,CAAE;CAEX,MAAM,CAAE;CACR,QAAQ,CACN,WACD;CACD,MAAM,CAAE;CACR,UAAU,CAAE;CACZ,MAAM,CAAE;CACR,SAAS,CAAE;CACX,WAAW,CAAE;CACb,SAAS,CAAE;CACX,QAAQ,CACN,OACD;AACF;;;;AAKD,MAAM,iBAAiB;CACrB,GAAG;CAIH,QAAQ,CAAE;CAGV,UAAU,CAAE;CAGZ,UAAU,CAAE;CAGZ,WAAW,CAAE;CAIb,UAAU,CAAE;AACb;;;;AAKD,MAAM,0BAA0B;CAG9B,kBAAkB,CAAE;CACpB,eAAe,CAAE;CACjB,QAAQ,CAAE;CACV,QAAQ,CAAE;CACV,aAAa,CAAE;CACf,SAAS,CAAE;CACX,YAAY,CAAE;CACd,eAAe,CAAE;CACjB,UAAU,CAAE;CACZ,OAAO,CAAE;CACT,aAAa,CAAE;CACf,WAAW,CAAE;AACd;AAED,MAAM,EAEJ,YACA,UACA,UAEA,SAEA,UAEA,GAAG,yBACJ,GAAG;;;;AAKJ,MAAM,cAAc;CAClB,GAAG;CACH,GAAG;CAOH,QAAQ,CAAE;CAEV,MAAM,CAAE;CACR,QAAQ,CAAE;CACV,SAAS,CAAE;CACX,OAAO,CAAE;CAGT,cAAc,CAAE;CAEhB,SAAS,CAAE;CACX,YAAY,CAAE;CACd,WAAW,CAAE;CACb,UAAU,CAAE;CACZ,eAAe,CAAE;CACjB,SAAS,CAAE;CACX,iBAAiB,CAAE;CACnB,UAAU,CAAE;CAGZ,QAAQ,CAAE;CAEV,QAAQ,CACN,SACD;CAED,QAAQ,CAAE;CACV,UAAU,CAAE;CAEZ,cAAc,CAAE;AACjB"}
|
package/dist/tagNames.js
ADDED
|
@@ -0,0 +1,144 @@
|
|
|
1
|
+
//#region src/tagNames.js
|
|
2
|
+
/**
|
|
3
|
+
* @typedef {{
|
|
4
|
+
* [key: string]: string[]
|
|
5
|
+
* }} AliasedTags
|
|
6
|
+
*/
|
|
7
|
+
/**
|
|
8
|
+
* @type {AliasedTags}
|
|
9
|
+
*/
|
|
10
|
+
const jsdocTagsUndocumented = { modifies: [] };
|
|
11
|
+
/**
|
|
12
|
+
* @type {AliasedTags}
|
|
13
|
+
*/
|
|
14
|
+
const jsdocTags = {
|
|
15
|
+
...jsdocTagsUndocumented,
|
|
16
|
+
abstract: ["virtual"],
|
|
17
|
+
access: [],
|
|
18
|
+
alias: [],
|
|
19
|
+
async: [],
|
|
20
|
+
augments: ["extends"],
|
|
21
|
+
author: [],
|
|
22
|
+
borrows: [],
|
|
23
|
+
callback: [],
|
|
24
|
+
class: ["constructor"],
|
|
25
|
+
classdesc: [],
|
|
26
|
+
constant: ["const"],
|
|
27
|
+
constructs: [],
|
|
28
|
+
copyright: [],
|
|
29
|
+
default: ["defaultvalue"],
|
|
30
|
+
deprecated: [],
|
|
31
|
+
description: ["desc"],
|
|
32
|
+
enum: [],
|
|
33
|
+
event: [],
|
|
34
|
+
example: [],
|
|
35
|
+
exports: [],
|
|
36
|
+
external: ["host"],
|
|
37
|
+
file: ["fileoverview", "overview"],
|
|
38
|
+
fires: ["emits"],
|
|
39
|
+
function: ["func", "method"],
|
|
40
|
+
generator: [],
|
|
41
|
+
global: [],
|
|
42
|
+
hideconstructor: [],
|
|
43
|
+
ignore: [],
|
|
44
|
+
implements: [],
|
|
45
|
+
inheritdoc: [],
|
|
46
|
+
inheritDoc: [],
|
|
47
|
+
inner: [],
|
|
48
|
+
instance: [],
|
|
49
|
+
interface: [],
|
|
50
|
+
kind: [],
|
|
51
|
+
lends: [],
|
|
52
|
+
license: [],
|
|
53
|
+
listens: [],
|
|
54
|
+
member: ["var"],
|
|
55
|
+
memberof: [],
|
|
56
|
+
"memberof!": [],
|
|
57
|
+
mixes: [],
|
|
58
|
+
mixin: [],
|
|
59
|
+
module: [],
|
|
60
|
+
name: [],
|
|
61
|
+
namespace: [],
|
|
62
|
+
override: [],
|
|
63
|
+
package: [],
|
|
64
|
+
param: ["arg", "argument"],
|
|
65
|
+
private: [],
|
|
66
|
+
property: ["prop"],
|
|
67
|
+
protected: [],
|
|
68
|
+
public: [],
|
|
69
|
+
readonly: [],
|
|
70
|
+
requires: [],
|
|
71
|
+
returns: ["return"],
|
|
72
|
+
see: [],
|
|
73
|
+
since: [],
|
|
74
|
+
static: [],
|
|
75
|
+
summary: [],
|
|
76
|
+
this: [],
|
|
77
|
+
throws: ["exception"],
|
|
78
|
+
todo: [],
|
|
79
|
+
tutorial: [],
|
|
80
|
+
type: [],
|
|
81
|
+
typedef: [],
|
|
82
|
+
variation: [],
|
|
83
|
+
version: [],
|
|
84
|
+
yields: ["yield"]
|
|
85
|
+
};
|
|
86
|
+
/**
|
|
87
|
+
* @type {AliasedTags}
|
|
88
|
+
*/
|
|
89
|
+
const typeScriptTags = {
|
|
90
|
+
...jsdocTags,
|
|
91
|
+
import: [],
|
|
92
|
+
internal: [],
|
|
93
|
+
overload: [],
|
|
94
|
+
satisfies: [],
|
|
95
|
+
template: []
|
|
96
|
+
};
|
|
97
|
+
/**
|
|
98
|
+
* @type {AliasedTags}
|
|
99
|
+
*/
|
|
100
|
+
const undocumentedClosureTags = {
|
|
101
|
+
closurePrimitive: [],
|
|
102
|
+
customElement: [],
|
|
103
|
+
expose: [],
|
|
104
|
+
hidden: [],
|
|
105
|
+
idGenerator: [],
|
|
106
|
+
meaning: [],
|
|
107
|
+
mixinClass: [],
|
|
108
|
+
mixinFunction: [],
|
|
109
|
+
ngInject: [],
|
|
110
|
+
owner: [],
|
|
111
|
+
typeSummary: [],
|
|
112
|
+
wizaction: []
|
|
113
|
+
};
|
|
114
|
+
const { inheritdoc, internal, overload, returns, satisfies,...typeScriptTagsInClosure } = typeScriptTags;
|
|
115
|
+
/**
|
|
116
|
+
* @type {AliasedTags}
|
|
117
|
+
*/
|
|
118
|
+
const closureTags = {
|
|
119
|
+
...typeScriptTagsInClosure,
|
|
120
|
+
...undocumentedClosureTags,
|
|
121
|
+
define: [],
|
|
122
|
+
dict: [],
|
|
123
|
+
export: [],
|
|
124
|
+
externs: [],
|
|
125
|
+
final: [],
|
|
126
|
+
implicitCast: [],
|
|
127
|
+
noalias: [],
|
|
128
|
+
nocollapse: [],
|
|
129
|
+
nocompile: [],
|
|
130
|
+
noinline: [],
|
|
131
|
+
nosideeffects: [],
|
|
132
|
+
polymer: [],
|
|
133
|
+
polymerBehavior: [],
|
|
134
|
+
preserve: [],
|
|
135
|
+
record: [],
|
|
136
|
+
return: ["returns"],
|
|
137
|
+
struct: [],
|
|
138
|
+
suppress: [],
|
|
139
|
+
unrestricted: []
|
|
140
|
+
};
|
|
141
|
+
|
|
142
|
+
//#endregion
|
|
143
|
+
export { closureTags, jsdocTags, typeScriptTags };
|
|
144
|
+
//# sourceMappingURL=tagNames.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"tagNames.js","names":[],"sources":["../src/tagNames.js"],"sourcesContent":["/**\n * @typedef {{\n * [key: string]: string[]\n * }} AliasedTags\n */\n\n/**\n * @type {AliasedTags}\n */\nconst jsdocTagsUndocumented = {\n // Undocumented but present; see\n // https://github.com/jsdoc/jsdoc/issues/1283#issuecomment-516816802\n // https://github.com/jsdoc/jsdoc/blob/master/packages/jsdoc/lib/jsdoc/tag/dictionary/definitions.js#L594\n modifies: [],\n};\n\n/**\n * @type {AliasedTags}\n */\nconst jsdocTags = {\n ...jsdocTagsUndocumented,\n abstract: [\n 'virtual',\n ],\n access: [],\n alias: [],\n async: [],\n augments: [\n 'extends',\n ],\n author: [],\n borrows: [],\n callback: [],\n class: [\n 'constructor',\n ],\n classdesc: [],\n constant: [\n 'const',\n ],\n constructs: [],\n copyright: [],\n default: [\n 'defaultvalue',\n ],\n deprecated: [],\n description: [\n 'desc',\n ],\n enum: [],\n event: [],\n example: [],\n exports: [],\n external: [\n 'host',\n ],\n file: [\n 'fileoverview',\n 'overview',\n ],\n fires: [\n 'emits',\n ],\n function: [\n 'func',\n 'method',\n ],\n generator: [],\n global: [],\n hideconstructor: [],\n ignore: [],\n implements: [],\n inheritdoc: [],\n\n // Allowing casing distinct from jsdoc `definitions.js` (required in Closure)\n inheritDoc: [],\n\n inner: [],\n instance: [],\n interface: [],\n kind: [],\n lends: [],\n license: [],\n listens: [],\n member: [\n 'var',\n ],\n memberof: [],\n 'memberof!': [],\n mixes: [],\n mixin: [],\n\n module: [],\n name: [],\n namespace: [],\n override: [],\n package: [],\n param: [\n 'arg',\n 'argument',\n ],\n private: [],\n property: [\n 'prop',\n ],\n protected: [],\n public: [],\n readonly: [],\n requires: [],\n returns: [\n 'return',\n ],\n see: [],\n since: [],\n static: [],\n summary: [],\n\n this: [],\n throws: [\n 'exception',\n ],\n todo: [],\n tutorial: [],\n type: [],\n typedef: [],\n variation: [],\n version: [],\n yields: [\n 'yield',\n ],\n};\n\n/**\n * @type {AliasedTags}\n */\nconst typeScriptTags = {\n ...jsdocTags,\n\n // https://github.com/microsoft/TypeScript/issues/22160\n // https://devblogs.microsoft.com/typescript/announcing-typescript-5-5/#the-jsdoc-import-tag\n import: [],\n\n // https://www.typescriptlang.org/tsconfig/#stripInternal\n internal: [],\n\n // https://devblogs.microsoft.com/typescript/announcing-typescript-5-0/#overload-support-in-jsdoc\n overload: [],\n\n // https://devblogs.microsoft.com/typescript/announcing-typescript-5-0/#satisfies-support-in-jsdoc\n satisfies: [],\n\n // `@template` is also in TypeScript per:\n // https://www.typescriptlang.org/docs/handbook/type-checking-javascript-files.html#supported-jsdoc\n template: [],\n};\n\n/**\n * @type {AliasedTags}\n */\nconst undocumentedClosureTags = {\n // These are in Closure source but not in jsdoc source nor in the Closure\n // docs: https://github.com/google/closure-compiler/blob/master/src/com/google/javascript/jscomp/parsing/Annotation.java\n closurePrimitive: [],\n customElement: [],\n expose: [],\n hidden: [],\n idGenerator: [],\n meaning: [],\n mixinClass: [],\n mixinFunction: [],\n ngInject: [],\n owner: [],\n typeSummary: [],\n wizaction: [],\n};\n\nconst {\n /* eslint-disable no-unused-vars */\n inheritdoc,\n internal,\n overload,\n // Will be inverted to prefer `return`\n returns,\n\n satisfies,\n /* eslint-enable no-unused-vars */\n ...typeScriptTagsInClosure\n} = typeScriptTags;\n\n/**\n * @type {AliasedTags}\n */\nconst closureTags = {\n ...typeScriptTagsInClosure,\n ...undocumentedClosureTags,\n\n // From https://github.com/google/closure-compiler/wiki/Annotating-JavaScript-for-the-Closure-Compiler\n // These are all recognized in https://github.com/jsdoc/jsdoc/blob/master/packages/jsdoc/lib/jsdoc/tag/dictionary/definitions.js\n // except for the experimental `noinline` and the casing differences noted below\n\n // Defined as a synonym of `const` in jsdoc `definitions.js`\n define: [],\n\n dict: [],\n export: [],\n externs: [],\n final: [],\n\n // With casing distinct from jsdoc `definitions.js`\n implicitCast: [],\n\n noalias: [],\n nocollapse: [],\n nocompile: [],\n noinline: [],\n nosideeffects: [],\n polymer: [],\n polymerBehavior: [],\n preserve: [],\n\n // Defined as a synonym of `interface` in jsdoc `definitions.js`\n record: [],\n\n return: [\n 'returns',\n ],\n\n struct: [],\n suppress: [],\n\n unrestricted: [],\n};\n\nexport {\n closureTags,\n jsdocTags,\n typeScriptTags,\n};\n"],"mappings":";;;;;;;;;AASA,MAAM,wBAAwB,EAI5B,UAAU,CAAE,EACb;;;;AAKD,MAAM,YAAY;CAChB,GAAG;CACH,UAAU,CACR,SACD;CACD,QAAQ,CAAE;CACV,OAAO,CAAE;CACT,OAAO,CAAE;CACT,UAAU,CACR,SACD;CACD,QAAQ,CAAE;CACV,SAAS,CAAE;CACX,UAAU,CAAE;CACZ,OAAO,CACL,aACD;CACD,WAAW,CAAE;CACb,UAAU,CACR,OACD;CACD,YAAY,CAAE;CACd,WAAW,CAAE;CACb,SAAS,CACP,cACD;CACD,YAAY,CAAE;CACd,aAAa,CACX,MACD;CACD,MAAM,CAAE;CACR,OAAO,CAAE;CACT,SAAS,CAAE;CACX,SAAS,CAAE;CACX,UAAU,CACR,MACD;CACD,MAAM,CACJ,gBACA,UACD;CACD,OAAO,CACL,OACD;CACD,UAAU,CACR,QACA,QACD;CACD,WAAW,CAAE;CACb,QAAQ,CAAE;CACV,iBAAiB,CAAE;CACnB,QAAQ,CAAE;CACV,YAAY,CAAE;CACd,YAAY,CAAE;CAGd,YAAY,CAAE;CAEd,OAAO,CAAE;CACT,UAAU,CAAE;CACZ,WAAW,CAAE;CACb,MAAM,CAAE;CACR,OAAO,CAAE;CACT,SAAS,CAAE;CACX,SAAS,CAAE;CACX,QAAQ,CACN,KACD;CACD,UAAU,CAAE;CACZ,aAAa,CAAE;CACf,OAAO,CAAE;CACT,OAAO,CAAE;CAET,QAAQ,CAAE;CACV,MAAM,CAAE;CACR,WAAW,CAAE;CACb,UAAU,CAAE;CACZ,SAAS,CAAE;CACX,OAAO,CACL,OACA,UACD;CACD,SAAS,CAAE;CACX,UAAU,CACR,MACD;CACD,WAAW,CAAE;CACb,QAAQ,CAAE;CACV,UAAU,CAAE;CACZ,UAAU,CAAE;CACZ,SAAS,CACP,QACD;CACD,KAAK,CAAE;CACP,OAAO,CAAE;CACT,QAAQ,CAAE;CACV,SAAS,CAAE;CAEX,MAAM,CAAE;CACR,QAAQ,CACN,WACD;CACD,MAAM,CAAE;CACR,UAAU,CAAE;CACZ,MAAM,CAAE;CACR,SAAS,CAAE;CACX,WAAW,CAAE;CACb,SAAS,CAAE;CACX,QAAQ,CACN,OACD;AACF;;;;AAKD,MAAM,iBAAiB;CACrB,GAAG;CAIH,QAAQ,CAAE;CAGV,UAAU,CAAE;CAGZ,UAAU,CAAE;CAGZ,WAAW,CAAE;CAIb,UAAU,CAAE;AACb;;;;AAKD,MAAM,0BAA0B;CAG9B,kBAAkB,CAAE;CACpB,eAAe,CAAE;CACjB,QAAQ,CAAE;CACV,QAAQ,CAAE;CACV,aAAa,CAAE;CACf,SAAS,CAAE;CACX,YAAY,CAAE;CACd,eAAe,CAAE;CACjB,UAAU,CAAE;CACZ,OAAO,CAAE;CACT,aAAa,CAAE;CACf,WAAW,CAAE;AACd;AAED,MAAM,EAEJ,YACA,UACA,UAEA,SAEA,UAEA,GAAG,yBACJ,GAAG;;;;AAKJ,MAAM,cAAc;CAClB,GAAG;CACH,GAAG;CAOH,QAAQ,CAAE;CAEV,MAAM,CAAE;CACR,QAAQ,CAAE;CACV,SAAS,CAAE;CACX,OAAO,CAAE;CAGT,cAAc,CAAE;CAEhB,SAAS,CAAE;CACX,YAAY,CAAE;CACd,WAAW,CAAE;CACb,UAAU,CAAE;CACZ,eAAe,CAAE;CACjB,SAAS,CAAE;CACX,iBAAiB,CAAE;CACnB,UAAU,CAAE;CAGZ,QAAQ,CAAE;CAEV,QAAQ,CACN,SACD;CAED,QAAQ,CAAE;CACV,UAAU,CAAE;CAEZ,cAAc,CAAE;AACjB"}
|