fix: add TS import tag; fixes #1218

Author: brettz9

.README/rules/informative-docs.md

@@ -46,6 +46,7 @@ For example, with `{ excludedTags: ["category"] }`, the following comment would
 function computeTypes(node) {
   // ...
 }
+```
 
 No tags are excluded by default.
 

.README/rules/sort-tags.md

@@ -63,6 +63,7 @@ a fixed order that doesn't change into the future, supply your own
   'file',
   'fileoverview',
   'overview',
+  'import',
 
   // Identifying (name, type)
   'typedef',

docs/rules/check-tag-names.md

@@ -714,6 +714,7 @@ function quux (foo) {}
  * @variation
  * @version
  * @yields
+ * @import
  * @internal
  * @overload
  * @satisfies
@@ -1028,6 +1029,7 @@ function quux (foo) {}
  * @variation
  * @version
  * @yields
+ * @import
  * @internal
  * @overload
  * @satisfies

docs/rules/informative-docs.md

@@ -4,6 +4,7 @@
 
 * [Options](#user-content-informative-docs-options)
     * [`aliases`](#user-content-informative-docs-options-aliases)
+    * [`excludedTags`](#user-content-informative-docs-options-excludedtags)
     * [`uselessWords`](#user-content-informative-docs-options-uselesswords)
 * [Context and settings](#user-content-informative-docs-context-and-settings)
 * [Failing examples](#user-content-informative-docs-failing-examples)
@@ -60,6 +61,7 @@ For example, with `{ excludedTags: ["category"] }`, the following comment would
 function computeTypes(node) {
   // ...
 }
+```
 
 No tags are excluded by default.
 

docs/rules/sort-tags.md

@@ -11,6 +11,7 @@ const defaultTagOrder = [
       'file',
       'fileoverview',
       'overview',
+      'import',
 
       // Identifying (name, type)
       'typedef',

src/defaultTagOrder.js

@@ -136,6 +136,9 @@ const jsdocTags = {
 const typeScriptTags = {
   ...jsdocTags,
 
+  // https://github.com/microsoft/TypeScript/issues/22160
+  import: [],
+
   // https://www.typescriptlang.org/tsconfig/#stripInternal
   internal: [],
 

src/tagNames.js

@@ -856,6 +856,10 @@ export default {
     {
       code: `${ALL_TYPESCRIPT_TAGS_COMMENT}\nfunction quux (foo) {}`,
       errors: [
+        {
+          line: lineCount(ALL_TYPESCRIPT_TAGS_COMMENT) - 4,
+          message: 'Invalid JSDoc tag name "import".',
+        },
         {
           line: lineCount(ALL_TYPESCRIPT_TAGS_COMMENT) - 3,
           message: 'Invalid JSDoc tag name "internal".',