eslint-plugin-esdoc not respecting noStandardTags default (false)

If I use this tsdoc.json

{
    "$schema": "https://developer.microsoft.com/json-schemas/tsdoc/v0/tsdoc.schema.json",

    "supportForTags": {
        "@fileoverview": true,
        "@name": true
    },

    "tagDefinitions": [
        {
            "tagName": "@fileoverview",
            "syntaxKind": "block",
            "allowMultiple": false
        },
        {
            "tagName": "@name",
            "syntaxKind": "modifier",
            "allowMultiple": false
        }
    ]
}

Then all the standard tags are giving errors:

Same result if I explicitly set noStandardTags: false

Do I have to add them all to supportForTags?
Or is there a reference file I can add to extends?

Neither of those options make sense as tagDefinitions says "Additional tags to support when parsing documentation comments with TSDoc" which implies they're additional to the standard tags.

eslint versions:

{
"@eslint/js": "^9.9.1",
"eslint": "^9.9.1",
"eslint-plugin-tsdoc": "^0.3.0",
"typescript-eslint": "^8.3.0"
}

#298

Similar issue here that confirms what I thought - MS are too lazy to properly document or support their own tools.

Thanksfully there aren't too many tags and I added them here if anyone else comes across this issue:

    "extends": ["./node_modules/typedoc/tsdoc.json"],
    "supportForTags": {
        // Indicate that the custom tag is supported by your tooling.  (Without this, warnings may
        // be reported saying that the tag is unsupported.)
        "@fileoverview": true,
        "@name": true,

        // Indicate that the default tags are supported: https://github.com/microsoft/tsdoc/issues/424
        "@alpha": true,
        "@beta": true,
        "@decorator": true,
        "@deprecated": true,
        "@defaultValue": true,
        "@eventProperty": true,
        "@example": true,
        "@experimental": true,
        "@inheritDoc": true,
        "@internal": true,
        "@label": true,
        "@link": true,
        "@override": true,
        "@packageDocumentation": true,
        "@param": true,
        "@privateRemarks": true,
        "@public": true,
        "@readonly": true,
        "@remarks": true,
        "@returns": true,
        "@sealed": true,
        "@see": true,
        "@throws": true,
        "@typeParam": true,
        "@virtual": true,

        // TypeDoc
        "@category": true,
        "@categoryDescription": true,
        "@document": true,
        "@enum": true,
        "@event": true,
        "@group": true,
        "@groupDescription": true,
        "@hidden": true,
        "@hideconstructor": true,
        "@ignore": true,
        "@interface": true,
        "@module": true,
        "@namespace": true,
        "@overload": true,
        "@private": true,
        "@property": true,
        "@protected": true,
        "@satisfies": true,
        "@template": true,
    },

Navigation Menu

Repository navigation

eslint-plugin-esdoc not respecting noStandardTags default (false) #424

Metadata

Assignees

Labels

Type

Projects

Milestone

Relationships

Development

eslint-plugin-esdoc not respecting noStandardTags default (false) #424

Description

Activity

blipk commented on Sep 2, 2024

Metadata

Metadata

Assignees

Labels

Type

Projects

Milestone

Relationships

Development

Issue actions