10000 Enhancement: [no-unused-vars] False-positive when referencing imported value in a TSDoc · Issue #5017 · typescript-eslint/typescript-eslint · GitHub
[go: up one dir, main page]

Skip to content
Enhancement: [no-unused-vars] False-positive when referencing imported value in a TSDoc #5017
Closed
@anton-johansson

Description

@anton-johansson

Before You File a Proposal Please Confirm You Have Done The Following...

My proposal is suitable for this project

  • I believe my proposal would be useful to the broader TypeScript community (meaning it is not a niche proposal).

Link to the rule's documentation

https://typescript-eslint.io/rules/no-unused-vars

Description

I propose that the rule should not give a warning if the imported type is being referenced in a TSDoc. It's very useful, specially in combination with @deprecated Use {@link myOtherType} instead..

Fail

import myNotDeprecatedFunction from "./other-file.ts";

/**
 * @deprecated Use myNotDeprecatedFunction instead.
 */
export const myDeprecatedFunction = () => {
    console.log("Hello world");
};

Pass

import myNotDeprecatedFunction from "./other-file.ts";

/**
 * @deprecated Use {@link myNotDeprecatedFunction} instead.
 */
export const myDeprecatedFunction = () => {
    console.log("Hello world");
};

Additional Info

TypeScript has a similar check, and I've created a similar issue for that too:
microsoft/TypeScript#49173

Metadata

Metadata

Assignees

No one assigned

    Labels

    externalThis issue is with another package, not typescript-eslint itselfpackage: eslint-pluginIssues related to @typescript-eslint/eslint-pluginwontfixThis will not be worked on

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions

      0