Deprecated Import Gatekeeper

Create a lint helper that blocks consumption of exports documented with @deprecated JSDoc tags while letting current APIs pass.

Capabilities

Flags deprecated named imports

• When a module exports a named function documented with an @deprecated reason, running lintFiles on a consumer that imports that name returns an error mentioning the identifier and the deprecation reason. @test

Flags deprecated default imports

• When a module's default export is marked @deprecated, lintFiles run on a file importing that default reports an error tied to the default import location. @test

Reports multiple occurrences

• If a file imports two different deprecated exports from separate modules, lintFiles returns two distinct errors with source locations matching each import statement. @test

Allows non-deprecated alternatives

• Importing only non-deprecated exports from the same modules yields zero errors from lintFiles. @test

Implementation

@generates

API

export async function lintFiles(paths: string[]): Promise<
  { filePath: string; errors: { message: string; line: number; column: number }[] }[]
>;

Dependencies { .dependencies }

eslint-plugin-import-x { .dependency }

Enforces import hygiene and detects usage of exports documented as deprecated.