# typescript-jsdoctag-completions-plugin > This plugin provides jsdoc tag completion and completion details. (with document of tag Latest version **2.1.9-beta** (published 2026-03-08) · MIT license · 0 weekly downloads ## Install ```sh npm install typescript-jsdoctag-completions-plugin pnpm add typescript-jsdoctag-completions-plugin yarn add typescript-jsdoctag-completions-plugin bun add typescript-jsdoctag-completions-plugin ``` ## Health **Score 50/100 (C)** — status: stable. Positive: has types; no vulnerabilities. Warnings: low downloads; no esm support. ## Facts | | | |---|---| | Version | 2.1.9-beta | | Published | 2026-03-08 | | First published | 2020-09-15 | | Weekly downloads | 0 | | License | MIT | | TypeScript types | bundled | | Module format | CommonJS | | Dependencies | 3 | | Unpacked size | 384.2 KB | | Known vulnerabilities | 0 | | Install scripts | no | | GitHub stars | 4 | | Author | jeffy-g | | Maintainers | motrohi | | Keywords | typescript, javascript, jsdoc, jsdoc-tag, plugin, tsserver, language | ## Links - npm: https://www.npmjs.com/package/typescript-jsdoctag-completions-plugin - Repository: https://github.com/jeffy-g/typescript-jsdoctag-completions-plugin-beta - Homepage: https://github.com/jeffy-g/typescript-jsdoctag-completions-plugin-beta#readme - Issues: https://github.com/jeffy-g/typescript-jsdoctag-completions-plugin-beta/issues - npm.io page: https://npm.io/package/typescript-jsdoctag-completions-plugin ## Dependencies (3) - [os-locale-s](https://npm.io/package/os-locale-s.md) ^1.1.3 - [literate-regex](https://npm.io/package/literate-regex.md) ^0.6.11 - [mini-semaphore](https://npm.io/package/mini-semaphore.md) ^1.5.4 ## Alternatives - [@openai/codex-sdk](https://npm.io/package/@openai/codex-sdk.md) — 731.4K weekly downloads - [babel-plugin-transform-react-jsx](https://npm.io/package/babel-plugin-transform-react-jsx.md) — 565.0K weekly downloads - [babel-helper-remove-or-void](https://npm.io/package/babel-helper-remove-or-void.md) — 508.5K weekly downloads - [@pnpm/store-controller-types](https://npm.io/package/@pnpm/store-controller-types.md) — 186.9K weekly downloads - [react-native-signature-canvas](https://npm.io/package/react-native-signature-canvas.md) — 155.6K weekly downloads ## Recent versions - 2.1.9-beta (latest) — 2026-03-08 - 2.1.7-beta (beta) — 2026-01-13 - 2.1.8-beta — 2026-01-20 - 2.1.6-beta — 2026-01-12 - 4.2.5-dev — 2026-01-12 - 2.1.5-beta — 2026-01-03 - 2.1.4-beta — 2025-12-24 - 2.1.3-beta — 2025-12-21 - 2.1.2-beta — 2025-05-08 - 2.1.1-beta — 2025-02-22 - 2.1.0-beta — 2025-02-20 - 2.0.9-beta — 2025-02-20 - 2.0.8-beta — 2025-01-27 - 2.0.7-beta — 2025-01-24 - 2.0.6-beta — 2025-01-17 - … 24 more at https://npm.io/package/typescript-jsdoctag-completions-plugin/versions ## README ![GitHub](https://img.shields.io/github/license/jeffy-g/typescript-jsdoctag-completions-plugin-beta?style=plastic) ![NPM Version](https://img.shields.io/npm/v/typescript-jsdoctag-completions-plugin?style=plastic&color=green) ![npm bundle size](https://img.shields.io/bundlephobia/min/typescript-jsdoctag-completions-plugin?style=plastic) ![NPM Downloads](https://img.shields.io/npm/dm/typescript-jsdoctag-completions-plugin?style=plastic) # TypeScript JSDoc Tag Completions Plugin This plugin provides JSDoc tag completion and detailed documentation for each tag. + In the __Preset API__, define __documentation__ and __syntax__ for each `tag` to display detailed information in the completion UI. ## Features + JSDoc tag completion with syntax-aware suggestions + Completion details for tag documentation, syntax, and aliases + Hover details for JSDoc tags (Quick Info); see the animation below + Locale-aware documentation output + Preset-based tag definitions (`default`, `closure`, or custom) ## **Requirements** + Works with the TypeScript Language Service (tsserver) (e.g. VS Code) + Applies to files handled by tsserver: TypeScript (`.ts`, `.tsx`, `.mts`, `.cts`, …) and JavaScript (`.js`, `.jsx`, `.mjs`, `.cjs`) + Note: VS Code `files.associations` changes the editor’s language mode, but does not guarantee tsserver support for non-standard extensions. ## This plugin follows standard JSDoc syntax and provides completions. + JSDoc blocks start with `/**`. + Each JSDoc line starts with `/\s+\*?\s/`. + JSDoc tags can be grouped into `marker`, `simple`, and `complex`. + `Marker` tags have no body. + `Simple` tags consist of a tag and a body (inline tags such as `@link`). + `Complex` tags consist of a tag, an optional type annotation, and a body (inline tags such as `@link`). ## Behavior + Hovering a JSDoc tag displays its details. ![mouse-hover](https://cdn.jsdelivr.net/gh/jeffy-g/typescript-jsdoctag-completions-plugin-beta@master/assets/mouse-hover.gif) > NOTE: When completion is triggered, the same details are shown in Quick Info. ## Installation ``` $ npm install --save-dev typescript typescript-jsdoctag-completions-plugin ``` Configure the plugin in `tsconfig.json`. Minimal configuration: ```jsonc { "compilerOptions": { "plugins": [ { "name": "typescript-jsdoctag-completions-plugin" } ] } } ``` Custom preset configuration: ```jsonc { "compilerOptions": { "target": "es2019", "module": "esnext", "strict": true, // In TypeScript 5.x, compilerOptions/locale was removed, // so Moved locale to plugin settings. // however, for older versions of ts, // this value is still referenced as before from this plugin. // "locale": "ja", "plugins": [ { "name": "typescript-jsdoctag-completions-plugin", // Plugin specific configuration // builtin preset is "default" and "closure". // If you want to use a jsdoc tag preset that you have defined yourself based on the preset API, // specify the path of that module. "preset": "closure", "verbose": true, // enable/disable plugin logging // plugin refers to the value of `@compilerOptions/plugins[@name=typescript-jsdoctag-completions-plugin]/locale` // *Changing this value will immediately change the translation language.* // If not set, use the OS locale "locale": "ja", // 2026/1/18 1:40:29 /** * since 2.1.8-beta */ "disableQuickInfo": true, // 2026/1/21 14:20:24 /** * since 2.1.9-beta */ "disableTypeDedentInQuickInfo": true, } ] } } ``` Launch [Visual Studio Code](https://code.visualstudio.com/download) (or another supported editor). ## Configuration Notes + `verbose`: Enable plugin logging (`true` or `false`). + `locale`: Overrides documentation language (falls back to OS locale when omitted). + `preset`: Use `default`, `closure`, or a custom preset module path. + `disableQuickInfo`: Disable Quick Info augmentation by this plugin (default: `false`). + `disableTypeDedentInQuickInfo`: Disable dedenting of Quick Info type details from 4 spaces to 2 spaces (default: `false`). ## JSDoc Tag Presets * Built-in presets | Preset name | Details | |:---|:---| | default | [TypeScript](https://github.com/microsoft/TypeScript) builtin JSDoc Tags with [Inline JSDoc Tags](https://jsdoc.app/) | | closure | [Closure Compiler](https://github.com/google/closure-compiler/wiki/Annotating-JavaScript-for-the-Closure-Compiler) JSDoc Tags | * Custom presets + To create your own preset, implement `TJSDocTagRawPreset` as defined in [preset-api.d.ts](https://github.com/jeffy-g/typescript-jsdoctag-completions-plugin-beta/blob/master/lib/preset-api.d.ts#L110). ## `Locale` priority + Locale resolution priority * #1 ts project (tsconfig.json, etc) * #1-2 vscode setting (vscode extension [vscode-typescript-jsdoctag-completions](https://marketplace.visualstudio.com/items?itemName=jeffy-g.vscode-typescript-jsdoctag-completions)) * #2 OS native ## Usage Notes + Set the TypeScript version in VSCode: Ensure the version in VSCode matches the version installed in your project. + Include sources in tsconfig.json: The plugin only applies to sources specified in the "include" section of tsconfig.json. If completions do not appear, verify the workspace TypeScript version and that the file is included in tsconfig. ### License This project is licensed under the MIT License. See [LICENSE](LICENSE) for details. --- _Source: https://npm.io/package/typescript-jsdoctag-completions-plugin · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._