eslint-plugin-jsdoc 52.0.4 → 53.0.0

package/dist/rules/noUndefinedTypes.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"noUndefinedTypes.cjs","names":["_iterateJsdoc","_interopRequireWildcard","require","_jsdoccomment","_parseImportsExports","e","t","WeakMap","r","n","__esModule","o","i","f","__proto__","default","has","get","set","hasOwnProperty","call","Object","defineProperty","getOwnPropertyDescriptor","extraTypes","typescriptGlobals","stripPseudoTypes","str","replace","_default","exports","iterateJsdoc","context","node","report","settings","sourceCode","utils","scopeManager","globalScope","definedTypes","disableReporting","markVariablesAsUsed","options","definedPreferredTypes","mode","preferredTypes","structuredTags","keys","length","values","map","preferredType","undefined","reportSettings","replacement","filter","Boolean","allComments","getAllComments","comments","comment","test","value","commentNode","parseComment","globals","flatMap","trim","split","concat","languageOptions","typedefDeclarations","doc","tags","tag","isNamepathDefiningTag","name","importTags","description","type","typePart","imprt","importsExports","parseImportsExports","types","namedImports","push","names","namespaceImports","namespace","ancestorNodes","currentNode","parent","getTemplateTags","ancestorNode","getJSDocComment","jsdoc","templateTags","getPresentTags","closureGenericTypes","parseClosureTemplateTag","cjsOrESMScope","childScopes","block","getValidRuntimeIdentifiers","scope","result","Set","scp","variables","add","upper","imports","allDefinedTypes","identifiers","globalItem","body","item","property","key","init","callee","id","methodOrProp","getScope","tagToParsedType","propertyName","potentialType","parsedType","tryParseType","parseType","typeTags","filterTags","tagMightHaveTypePosition","namepathReferencingTags","isNamepathReferencingTag","namepathOrUrlReferencingTags","filterAllTags","isNamepathOrUrlReferencingTag","tagsWithTypes","traverse","nde","parentNode","_parent","val","currNode","includes","right","structuredTypes","Array","isArray","markVariableAsUsed","iterateAllJsdocs","meta","docs","url","schema","additionalProperties","properties","items","module"],"sources":["../../src/rules/noUndefinedTypes.js"],"sourcesContent":["import iterateJsdoc, {\n  parseComment,\n} from '../iterateJsdoc.js';\nimport {\n  getJSDocComment,\n  parse as parseType,\n  traverse,\n  tryParse as tryParseType,\n} from '@es-joy/jsdoccomment';\nimport {\n  parseImportsExports,\n} from 'parse-imports-exports';\n\nconst extraTypes = [\n  'null', 'undefined', 'void', 'string', 'boolean', 'object',\n  'function', 'symbol',\n  'number', 'bigint', 'NaN', 'Infinity',\n  'any', '*', 'never', 'unknown', 'const',\n  'this', 'true', 'false',\n  'Array', 'Object', 'RegExp', 'Date', 'Function', 'Intl',\n];\n\nconst typescriptGlobals = [\n  // https://www.typescriptlang.org/docs/handbook/utility-types.html\n  'Awaited',\n  'Partial',\n  'Required',\n  'Readonly',\n  'Record',\n  'Pick',\n  'Omit',\n  'Exclude',\n  'Extract',\n  'NonNullable',\n  'Parameters',\n  'ConstructorParameters',\n  'ReturnType',\n  'InstanceType',\n  'ThisParameterType',\n  'OmitThisParameter',\n  'ThisType',\n  'Uppercase',\n  'Lowercase',\n  'Capitalize',\n  'Uncapitalize',\n];\n\n/**\n * @param {string|false|undefined} [str]\n * @returns {undefined|string|false}\n */\nconst stripPseudoTypes = (str) => {\n  return str && str.replace(/(?:\\.|<>|\\.<>|\\[\\])$/v, '');\n};\n\nexport default iterateJsdoc(({\n  context,\n  node,\n  report,\n  settings,\n  sourceCode,\n  utils,\n}) => {\n  const {\n    scopeManager,\n  } = sourceCode;\n\n  // When is this ever `null`?\n  const globalScope = /** @type {import('eslint').Scope.Scope} */ (\n    scopeManager.globalScope\n  );\n\n  const\n    /**\n     * @type {{\n     *   definedTypes: string[],\n     *   disableReporting: boolean,\n     *   markVariablesAsUsed: boolean\n     * }}\n     */ {\n      definedTypes = [],\n      disableReporting = false,\n      markVariablesAsUsed = true,\n    } = context.options[0] || {};\n\n  /** @type {(string|undefined)[]} */\n  let definedPreferredTypes = [];\n  const {\n    mode,\n    preferredTypes,\n    structuredTags,\n  } = settings;\n  if (Object.keys(preferredTypes).length) {\n    definedPreferredTypes = /** @type {string[]} */ (Object.values(preferredTypes).map((preferredType) => {\n      if (typeof preferredType === 'string') {\n        // May become an empty string but will be filtered out below\n        return stripPseudoTypes(preferredType);\n      }\n\n      if (!preferredType) {\n        return undefined;\n      }\n\n      if (typeof preferredType !== 'object') {\n        utils.reportSettings(\n          'Invalid `settings.jsdoc.preferredTypes`. Values must be falsy, a string, or an object.',\n        );\n      }\n\n      return stripPseudoTypes(preferredType.replacement);\n    })\n      .filter(Boolean));\n  }\n\n  const allComments = sourceCode.getAllComments();\n  const comments = allComments\n    .filter((comment) => {\n      return (/^\\*\\s/v).test(comment.value);\n    })\n    .map((commentNode) => {\n      return parseComment(commentNode, '');\n    });\n\n  const globals = allComments\n    .filter((comment) => {\n      return (/^\\s*globals/v).test(comment.value);\n    }).flatMap((commentNode) => {\n      return commentNode.value.replace(/^\\s*globals/v, '').trim().split(/,\\s*/v);\n    }).concat(Object.keys(context.languageOptions.globals ?? []));\n\n  const typedefDeclarations = comments\n    .flatMap((doc) => {\n      return doc.tags.filter(({\n        tag,\n      }) => {\n        return utils.isNamepathDefiningTag(tag);\n      });\n    })\n    .map((tag) => {\n      return tag.name;\n    });\n\n  const importTags = settings.mode === 'typescript' ? /** @type {string[]} */ (comments.flatMap((doc) => {\n    return doc.tags.filter(({\n      tag,\n    }) => {\n      return tag === 'import';\n    });\n  }).flatMap((tag) => {\n    const {\n      description,\n      name,\n      type,\n    } = tag;\n    const typePart = type ? `{${type}} ` : '';\n    const imprt = 'import ' + (description ?\n      `${typePart}${name} ${description}` :\n      `${typePart}${name}`);\n\n    const importsExports = parseImportsExports(imprt.trim());\n\n    const types = [];\n    const namedImports = Object.values(importsExports.namedImports || {})[0]?.[0];\n    if (namedImports) {\n      if (namedImports.default) {\n        types.push(namedImports.default);\n      }\n\n      if (namedImports.names) {\n        types.push(...Object.keys(namedImports.names));\n      }\n    }\n\n    const namespaceImports = Object.values(importsExports.namespaceImports || {})[0]?.[0];\n    if (namespaceImports) {\n      if (namespaceImports.namespace) {\n        types.push(namespaceImports.namespace);\n      }\n\n      if (namespaceImports.default) {\n        types.push(namespaceImports.default);\n      }\n    }\n\n    return types;\n  }).filter(Boolean)) : [];\n\n  const ancestorNodes = [];\n\n  let currentNode = node;\n  // No need for Program node?\n  while (currentNode?.parent) {\n    ancestorNodes.push(currentNode);\n    currentNode = currentNode.parent;\n  }\n\n  /**\n   * @param {import('eslint').Rule.Node} ancestorNode\n   * @returns {import('comment-parser').Spec[]}\n   */\n  const getTemplateTags = function (ancestorNode) {\n    const commentNode = getJSDocComment(sourceCode, ancestorNode, settings);\n    if (!commentNode) {\n      return [];\n    }\n\n    const jsdoc = parseComment(commentNode, '');\n\n    return jsdoc.tags.filter((tag) => {\n      return tag.tag === 'template';\n    });\n  };\n\n  // `currentScope` may be `null` or `Program`, so in such a case,\n  //  we look to present tags instead\n  const templateTags = ancestorNodes.length ?\n    ancestorNodes.flatMap((ancestorNode) => {\n      return getTemplateTags(ancestorNode);\n    }) :\n    utils.getPresentTags([\n      'template',\n    ]);\n\n  const closureGenericTypes = templateTags.flatMap((tag) => {\n    return utils.parseClosureTemplateTag(tag);\n  });\n\n  // In modules, including Node, there is a global scope at top with the\n  //  Program scope inside\n  const cjsOrESMScope = globalScope.childScopes[0]?.block?.type === 'Program';\n\n  /**\n   * @param {import(\"eslint\").Scope.Scope | null} scope\n   * @returns {Set<string>}\n   */\n  const getValidRuntimeIdentifiers = (scope) => {\n    const result = new Set();\n\n    let scp = scope;\n    while (scp) {\n      for (const {\n        name,\n      } of scp.variables) {\n        result.add(name);\n      }\n\n      scp = scp.upper;\n    }\n\n    return result;\n  };\n\n  /**\n   * We treat imports differently as we can't introspect their children.\n   * @type {string[]}\n   */\n  const imports = [];\n\n  const allDefinedTypes = new Set(globalScope.variables.map(({\n    name,\n  }) => {\n    return name;\n  })\n\n    // If the file is a module, concat the variables from the module scope.\n    .concat(\n      cjsOrESMScope ?\n        globalScope.childScopes.flatMap(({\n          variables,\n        }) => {\n          return variables;\n        }).flatMap(({\n          identifiers,\n          name,\n        }) => {\n          const globalItem = /** @type {import('estree').Identifier & {parent: import('@typescript-eslint/types').TSESTree.Node}} */ (\n            identifiers?.[0]\n          )?.parent;\n          switch (globalItem?.type) {\n            case 'ClassDeclaration':\n              return [\n                name,\n                ...globalItem.body.body.map((item) => {\n                  const property = /** @type {import('@typescript-eslint/types').TSESTree.Identifier} */ (\n                    /** @type {import('@typescript-eslint/types').TSESTree.PropertyDefinition} */ (\n                      item)?.key)?.name;\n                  /* c8 ignore next 3 -- Guard */\n                  if (!property) {\n                    return '';\n                  }\n\n                  return `${name}.${property}`;\n                }).filter(Boolean),\n              ];\n            case 'ImportDefaultSpecifier':\n            case 'ImportNamespaceSpecifier':\n            case 'ImportSpecifier':\n              imports.push(name);\n              break;\n            case 'TSInterfaceDeclaration':\n              return [\n                name,\n                ...globalItem.body.body.map((item) => {\n                  const property = /** @type {import('@typescript-eslint/types').TSESTree.Identifier} */ (\n                    /** @type {import('@typescript-eslint/types').TSESTree.TSPropertySignature} */ (\n                      item)?.key)?.name;\n                  /* c8 ignore next 3 -- Guard */\n                  if (!property) {\n                    return '';\n                  }\n\n                  return `${name}.${property}`;\n                }).filter(Boolean),\n              ];\n            case 'VariableDeclarator':\n              if (/** @type {import('@typescript-eslint/types').TSESTree.Identifier} */ (\n                /** @type {import('@typescript-eslint/types').TSESTree.CallExpression} */ (\n                  globalItem?.init\n                )?.callee)?.name === 'require'\n              ) {\n                imports.push(/** @type {import('@typescript-eslint/types').TSESTree.Identifier} */ (\n                  globalItem.id\n                ).name);\n                break;\n              }\n\n              return [];\n          }\n\n          return [\n            name,\n          ];\n        /* c8 ignore next */\n        }) : [],\n    )\n    .concat(extraTypes)\n    .concat(typedefDeclarations)\n    .concat(importTags)\n    .concat(definedTypes)\n    .concat(/** @type {string[]} */ (definedPreferredTypes))\n    .concat((() => {\n      // Other methods are not in scope, but we need them, and we grab them here\n      if (node?.type === 'MethodDefinition') {\n        return /** @type {import('estree').ClassBody} */ (node.parent).body.flatMap((methodOrProp) => {\n          if (methodOrProp.type === 'MethodDefinition') {\n            // eslint-disable-next-line unicorn/no-lonely-if -- Pattern\n            if (methodOrProp.key.type === 'Identifier') {\n              return [\n                methodOrProp.key.name,\n                `${/** @type {import('estree').ClassDeclaration} */ (\n                  node.parent?.parent\n                )?.id?.name}.${methodOrProp.key.name}`,\n              ];\n            }\n          }\n\n          if (methodOrProp.type === 'PropertyDefinition') {\n            // eslint-disable-next-line unicorn/no-lonely-if -- Pattern\n            if (methodOrProp.key.type === 'Identifier') {\n              return [\n                methodOrProp.key.name,\n                `${/** @type {import('estree').ClassDeclaration} */ (\n                  node.parent?.parent\n                )?.id?.name}.${methodOrProp.key.name}`,\n              ];\n            }\n          }\n          /* c8 ignore next 2 -- Not yet built */\n\n          return '';\n        }).filter(Boolean);\n      }\n\n      return [];\n    })())\n    .concat(...getValidRuntimeIdentifiers(node && (\n      (sourceCode.getScope &&\n      /* c8 ignore next 2 */\n      sourceCode.getScope(node)) ||\n      context.getScope()\n    )))\n    .concat(\n      settings.mode === 'jsdoc' ?\n        [] :\n        [\n          ...settings.mode === 'typescript' ? typescriptGlobals : [],\n          ...closureGenericTypes,\n        ],\n    ));\n\n  /**\n   * @typedef {{\n   *   parsedType: import('jsdoc-type-pratt-parser').RootResult;\n   *   tag: import('comment-parser').Spec|import('@es-joy/jsdoccomment').JsdocInlineTagNoType & {\n   *     line?: import('../iterateJsdoc.js').Integer\n   *   }\n   * }} TypeAndTagInfo\n   */\n\n  /**\n   * @param {string} propertyName\n   * @returns {(tag: (import('@es-joy/jsdoccomment').JsdocInlineTagNoType & {\n   *     name?: string,\n   *     type?: string,\n   *     line?: import('../iterateJsdoc.js').Integer\n   *   })|import('comment-parser').Spec & {\n   *     namepathOrURL?: string\n   *   }\n   * ) => undefined|TypeAndTagInfo}\n   */\n  const tagToParsedType = (propertyName) => {\n    return (tag) => {\n      try {\n        const potentialType = tag[\n          /** @type {\"type\"|\"name\"|\"namepathOrURL\"} */ (propertyName)\n        ];\n        return {\n          parsedType: mode === 'permissive' ?\n            tryParseType(/** @type {string} */ (potentialType)) :\n            parseType(/** @type {string} */ (potentialType), mode),\n          tag,\n        };\n      } catch {\n        return undefined;\n      }\n    };\n  };\n\n  const typeTags = utils.filterTags(({\n    tag,\n  }) => {\n    return tag !== 'import' && utils.tagMightHaveTypePosition(tag) && (tag !== 'suppress' || settings.mode !== 'closure');\n  }).map(tagToParsedType('type'));\n\n  const namepathReferencingTags = utils.filterTags(({\n    tag,\n  }) => {\n    return utils.isNamepathReferencingTag(tag);\n  }).map(tagToParsedType('name'));\n\n  const namepathOrUrlReferencingTags = utils.filterAllTags(({\n    tag,\n  }) => {\n    return utils.isNamepathOrUrlReferencingTag(tag);\n  }).map(tagToParsedType('namepathOrURL'));\n\n  const tagsWithTypes = /** @type {TypeAndTagInfo[]} */ ([\n    ...typeTags,\n    ...namepathReferencingTags,\n    ...namepathOrUrlReferencingTags,\n    // Remove types which failed to parse\n  ].filter(Boolean));\n\n  for (const {\n    parsedType,\n    tag,\n  } of tagsWithTypes) {\n    traverse(parsedType, (nde, parentNode) => {\n      /**\n       * @type {import('jsdoc-type-pratt-parser').NameResult & {\n       *   _parent?: import('jsdoc-type-pratt-parser').NonRootResult\n       * }}\n       */\n      // eslint-disable-next-line canonical/id-match -- Avoid clashes\n      (nde)._parent = parentNode;\n      const {\n        type,\n        value,\n      } = /** @type {import('jsdoc-type-pratt-parser').NameResult} */ (nde);\n\n      let val = value;\n\n      /** @type {import('jsdoc-type-pratt-parser').NonRootResult|undefined} */\n      let currNode = nde;\n      do {\n        currNode =\n          /**\n           * @type {import('jsdoc-type-pratt-parser').NameResult & {\n           *   _parent?: import('jsdoc-type-pratt-parser').NonRootResult\n           * }}\n           */ (currNode)._parent;\n        if (\n          // Avoid appending for imports and globals since we don't want to\n          //  check their properties which may or may not exist\n          !imports.includes(val) && !globals.includes(val) &&\n          !importTags.includes(val) &&\n          !extraTypes.includes(val) &&\n          !typedefDeclarations.includes(val) &&\n          currNode && 'right' in currNode &&\n          currNode.right?.type === 'JsdocTypeProperty') {\n          val = val + '.' + currNode.right.value;\n        }\n      } while (currNode?.type === 'JsdocTypeNamePath');\n\n      if (type === 'JsdocTypeName') {\n        const structuredTypes = structuredTags[tag.tag]?.type;\n        if (!allDefinedTypes.has(val) &&\n          (!Array.isArray(structuredTypes) || !structuredTypes.includes(val))\n        ) {\n          if (!disableReporting) {\n            report(`The type '${val}' is undefined.`, null, tag);\n          }\n        } else if (markVariablesAsUsed && !extraTypes.includes(val)) {\n          if (sourceCode.markVariableAsUsed) {\n            sourceCode.markVariableAsUsed(val);\n          /* c8 ignore next 3 */\n          } else {\n            context.markVariableAsUsed(val);\n          }\n        }\n      }\n    });\n  }\n}, {\n  iterateAllJsdocs: true,\n  meta: {\n    docs: {\n      description: 'Checks that types in jsdoc comments are defined.',\n      url: 'https://github.com/gajus/eslint-plugin-jsdoc/blob/main/docs/rules/no-undefined-types.md#repos-sticky-header',\n    },\n    schema: [\n      {\n        additionalProperties: false,\n        properties: {\n          definedTypes: {\n            items: {\n              type: 'string',\n            },\n            type: 'array',\n          },\n          disableReporting: {\n            type: 'boolean',\n          },\n          markVariablesAsUsed: {\n            type: 'boolean',\n          },\n        },\n        type: 'object',\n      },\n    ],\n    type: 'suggestion',\n  },\n});\n"],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"noUndefinedTypes.cjs","names":["iterateJsdoc"],"sources":["../../src/rules/noUndefinedTypes.js"],"sourcesContent":["import iterateJsdoc, {\n  parseComment,\n} from '../iterateJsdoc.js';\nimport {\n  getJSDocComment,\n  parse as parseType,\n  traverse,\n  tryParse as tryParseType,\n} from '@es-joy/jsdoccomment';\nimport {\n  parseImportsExports,\n} from 'parse-imports-exports';\n\nconst extraTypes = [\n  'null', 'undefined', 'void', 'string', 'boolean', 'object',\n  'function', 'symbol',\n  'number', 'bigint', 'NaN', 'Infinity',\n  'any', '*', 'never', 'unknown', 'const',\n  'this', 'true', 'false',\n  'Array', 'Object', 'RegExp', 'Date', 'Function', 'Intl',\n];\n\nconst typescriptGlobals = [\n  // https://www.typescriptlang.org/docs/handbook/utility-types.html\n  'Awaited',\n  'Partial',\n  'Required',\n  'Readonly',\n  'Record',\n  'Pick',\n  'Omit',\n  'Exclude',\n  'Extract',\n  'NonNullable',\n  'Parameters',\n  'ConstructorParameters',\n  'ReturnType',\n  'InstanceType',\n  'ThisParameterType',\n  'OmitThisParameter',\n  'ThisType',\n  'Uppercase',\n  'Lowercase',\n  'Capitalize',\n  'Uncapitalize',\n];\n\n/**\n * @param {string|false|undefined} [str]\n * @returns {undefined|string|false}\n */\nconst stripPseudoTypes = (str) => {\n  return str && str.replace(/(?:\\.|<>|\\.<>|\\[\\])$/v, '');\n};\n\nexport default iterateJsdoc(({\n  context,\n  node,\n  report,\n  settings,\n  sourceCode,\n  utils,\n}) => {\n  const {\n    scopeManager,\n  } = sourceCode;\n\n  // When is this ever `null`?\n  const globalScope = /** @type {import('eslint').Scope.Scope} */ (\n    scopeManager.globalScope\n  );\n\n  const\n    /**\n     * @type {{\n     *   definedTypes: string[],\n     *   disableReporting: boolean,\n     *   markVariablesAsUsed: boolean\n     * }}\n     */ {\n      definedTypes = [],\n      disableReporting = false,\n      markVariablesAsUsed = true,\n    } = context.options[0] || {};\n\n  /** @type {(string|undefined)[]} */\n  let definedPreferredTypes = [];\n  const {\n    mode,\n    preferredTypes,\n    structuredTags,\n  } = settings;\n  if (Object.keys(preferredTypes).length) {\n    definedPreferredTypes = /** @type {string[]} */ (Object.values(preferredTypes).map((preferredType) => {\n      if (typeof preferredType === 'string') {\n        // May become an empty string but will be filtered out below\n        return stripPseudoTypes(preferredType);\n      }\n\n      if (!preferredType) {\n        return undefined;\n      }\n\n      if (typeof preferredType !== 'object') {\n        utils.reportSettings(\n          'Invalid `settings.jsdoc.preferredTypes`. Values must be falsy, a string, or an object.',\n        );\n      }\n\n      return stripPseudoTypes(preferredType.replacement);\n    })\n      .filter(Boolean));\n  }\n\n  const allComments = sourceCode.getAllComments();\n  const comments = allComments\n    .filter((comment) => {\n      return (/^\\*\\s/v).test(comment.value);\n    })\n    .map((commentNode) => {\n      return parseComment(commentNode, '');\n    });\n\n  const globals = allComments\n    .filter((comment) => {\n      return (/^\\s*globals/v).test(comment.value);\n    }).flatMap((commentNode) => {\n      return commentNode.value.replace(/^\\s*globals/v, '').trim().split(/,\\s*/v);\n    }).concat(Object.keys(context.languageOptions.globals ?? []));\n\n  const typedefDeclarations = comments\n    .flatMap((doc) => {\n      return doc.tags.filter(({\n        tag,\n      }) => {\n        return utils.isNamepathDefiningTag(tag);\n      });\n    })\n    .map((tag) => {\n      return tag.name;\n    });\n\n  const importTags = settings.mode === 'typescript' ? /** @type {string[]} */ (comments.flatMap((doc) => {\n    return doc.tags.filter(({\n      tag,\n    }) => {\n      return tag === 'import';\n    });\n  }).flatMap((tag) => {\n    const {\n      description,\n      name,\n      type,\n    } = tag;\n    const typePart = type ? `{${type}} ` : '';\n    const imprt = 'import ' + (description ?\n      `${typePart}${name} ${description}` :\n      `${typePart}${name}`);\n\n    const importsExports = parseImportsExports(imprt.trim());\n\n    const types = [];\n    const namedImports = Object.values(importsExports.namedImports || {})[0]?.[0];\n    if (namedImports) {\n      if (namedImports.default) {\n        types.push(namedImports.default);\n      }\n\n      if (namedImports.names) {\n        types.push(...Object.keys(namedImports.names));\n      }\n    }\n\n    const namespaceImports = Object.values(importsExports.namespaceImports || {})[0]?.[0];\n    if (namespaceImports) {\n      if (namespaceImports.namespace) {\n        types.push(namespaceImports.namespace);\n      }\n\n      if (namespaceImports.default) {\n        types.push(namespaceImports.default);\n      }\n    }\n\n    return types;\n  }).filter(Boolean)) : [];\n\n  const ancestorNodes = [];\n\n  let currentNode = node;\n  // No need for Program node?\n  while (currentNode?.parent) {\n    ancestorNodes.push(currentNode);\n    currentNode = currentNode.parent;\n  }\n\n  /**\n   * @param {import('eslint').Rule.Node} ancestorNode\n   * @returns {import('comment-parser').Spec[]}\n   */\n  const getTemplateTags = function (ancestorNode) {\n    const commentNode = getJSDocComment(sourceCode, ancestorNode, settings);\n    if (!commentNode) {\n      return [];\n    }\n\n    const jsdoc = parseComment(commentNode, '');\n\n    return jsdoc.tags.filter((tag) => {\n      return tag.tag === 'template';\n    });\n  };\n\n  // `currentScope` may be `null` or `Program`, so in such a case,\n  //  we look to present tags instead\n  const templateTags = ancestorNodes.length ?\n    ancestorNodes.flatMap((ancestorNode) => {\n      return getTemplateTags(ancestorNode);\n    }) :\n    utils.getPresentTags([\n      'template',\n    ]);\n\n  const closureGenericTypes = templateTags.flatMap((tag) => {\n    return utils.parseClosureTemplateTag(tag);\n  });\n\n  // In modules, including Node, there is a global scope at top with the\n  //  Program scope inside\n  const cjsOrESMScope = globalScope.childScopes[0]?.block?.type === 'Program';\n\n  /**\n   * @param {import(\"eslint\").Scope.Scope | null} scope\n   * @returns {Set<string>}\n   */\n  const getValidRuntimeIdentifiers = (scope) => {\n    const result = new Set();\n\n    let scp = scope;\n    while (scp) {\n      for (const {\n        name,\n      } of scp.variables) {\n        result.add(name);\n      }\n\n      scp = scp.upper;\n    }\n\n    return result;\n  };\n\n  /**\n   * We treat imports differently as we can't introspect their children.\n   * @type {string[]}\n   */\n  const imports = [];\n\n  const allDefinedTypes = new Set(globalScope.variables.map(({\n    name,\n  }) => {\n    return name;\n  })\n\n    // If the file is a module, concat the variables from the module scope.\n    .concat(\n      cjsOrESMScope ?\n        globalScope.childScopes.flatMap(({\n          variables,\n        }) => {\n          return variables;\n        }).flatMap(({\n          identifiers,\n          name,\n        }) => {\n          const globalItem = /** @type {import('estree').Identifier & {parent: import('@typescript-eslint/types').TSESTree.Node}} */ (\n            identifiers?.[0]\n          )?.parent;\n          switch (globalItem?.type) {\n            case 'ClassDeclaration':\n              return [\n                name,\n                ...globalItem.body.body.map((item) => {\n                  const property = /** @type {import('@typescript-eslint/types').TSESTree.Identifier} */ (\n                    /** @type {import('@typescript-eslint/types').TSESTree.PropertyDefinition} */ (\n                      item)?.key)?.name;\n                  /* c8 ignore next 3 -- Guard */\n                  if (!property) {\n                    return '';\n                  }\n\n                  return `${name}.${property}`;\n                }).filter(Boolean),\n              ];\n            case 'ImportDefaultSpecifier':\n            case 'ImportNamespaceSpecifier':\n            case 'ImportSpecifier':\n              imports.push(name);\n              break;\n            case 'TSInterfaceDeclaration':\n              return [\n                name,\n                ...globalItem.body.body.map((item) => {\n                  const property = /** @type {import('@typescript-eslint/types').TSESTree.Identifier} */ (\n                    /** @type {import('@typescript-eslint/types').TSESTree.TSPropertySignature} */ (\n                      item)?.key)?.name;\n                  /* c8 ignore next 3 -- Guard */\n                  if (!property) {\n                    return '';\n                  }\n\n                  return `${name}.${property}`;\n                }).filter(Boolean),\n              ];\n            case 'VariableDeclarator':\n              if (/** @type {import('@typescript-eslint/types').TSESTree.Identifier} */ (\n                /** @type {import('@typescript-eslint/types').TSESTree.CallExpression} */ (\n                  globalItem?.init\n                )?.callee)?.name === 'require'\n              ) {\n                imports.push(/** @type {import('@typescript-eslint/types').TSESTree.Identifier} */ (\n                  globalItem.id\n                ).name);\n                break;\n              }\n\n              return [];\n          }\n\n          return [\n            name,\n          ];\n        /* c8 ignore next */\n        }) : [],\n    )\n    .concat(extraTypes)\n    .concat(typedefDeclarations)\n    .concat(importTags)\n    .concat(definedTypes)\n    .concat(/** @type {string[]} */ (definedPreferredTypes))\n    .concat((() => {\n      // Other methods are not in scope, but we need them, and we grab them here\n      if (node?.type === 'MethodDefinition') {\n        return /** @type {import('estree').ClassBody} */ (node.parent).body.flatMap((methodOrProp) => {\n          if (methodOrProp.type === 'MethodDefinition') {\n            // eslint-disable-next-line unicorn/no-lonely-if -- Pattern\n            if (methodOrProp.key.type === 'Identifier') {\n              return [\n                methodOrProp.key.name,\n                `${/** @type {import('estree').ClassDeclaration} */ (\n                  node.parent?.parent\n                )?.id?.name}.${methodOrProp.key.name}`,\n              ];\n            }\n          }\n\n          if (methodOrProp.type === 'PropertyDefinition') {\n            // eslint-disable-next-line unicorn/no-lonely-if -- Pattern\n            if (methodOrProp.key.type === 'Identifier') {\n              return [\n                methodOrProp.key.name,\n                `${/** @type {import('estree').ClassDeclaration} */ (\n                  node.parent?.parent\n                )?.id?.name}.${methodOrProp.key.name}`,\n              ];\n            }\n          }\n          /* c8 ignore next 2 -- Not yet built */\n\n          return '';\n        }).filter(Boolean);\n      }\n\n      return [];\n    })())\n    .concat(...getValidRuntimeIdentifiers(node && (\n      (sourceCode.getScope &&\n      /* c8 ignore next 2 */\n      sourceCode.getScope(node)) ||\n      context.getScope()\n    )))\n    .concat(\n      settings.mode === 'jsdoc' ?\n        [] :\n        [\n          ...settings.mode === 'typescript' ? typescriptGlobals : [],\n          ...closureGenericTypes,\n        ],\n    ));\n\n  /**\n   * @typedef {{\n   *   parsedType: import('jsdoc-type-pratt-parser').RootResult;\n   *   tag: import('comment-parser').Spec|import('@es-joy/jsdoccomment').JsdocInlineTagNoType & {\n   *     line?: import('../iterateJsdoc.js').Integer\n   *   }\n   * }} TypeAndTagInfo\n   */\n\n  /**\n   * @param {string} propertyName\n   * @returns {(tag: (import('@es-joy/jsdoccomment').JsdocInlineTagNoType & {\n   *     name?: string,\n   *     type?: string,\n   *     line?: import('../iterateJsdoc.js').Integer\n   *   })|import('comment-parser').Spec & {\n   *     namepathOrURL?: string\n   *   }\n   * ) => undefined|TypeAndTagInfo}\n   */\n  const tagToParsedType = (propertyName) => {\n    return (tag) => {\n      try {\n        const potentialType = tag[\n          /** @type {\"type\"|\"name\"|\"namepathOrURL\"} */ (propertyName)\n        ];\n        return {\n          parsedType: mode === 'permissive' ?\n            tryParseType(/** @type {string} */ (potentialType)) :\n            parseType(/** @type {string} */ (potentialType), mode),\n          tag,\n        };\n      } catch {\n        return undefined;\n      }\n    };\n  };\n\n  const typeTags = utils.filterTags(({\n    tag,\n  }) => {\n    return tag !== 'import' && utils.tagMightHaveTypePosition(tag) && (tag !== 'suppress' || settings.mode !== 'closure');\n  }).map(tagToParsedType('type'));\n\n  const namepathReferencingTags = utils.filterTags(({\n    tag,\n  }) => {\n    return utils.isNamepathReferencingTag(tag);\n  }).map(tagToParsedType('name'));\n\n  const namepathOrUrlReferencingTags = utils.filterAllTags(({\n    tag,\n  }) => {\n    return utils.isNamepathOrUrlReferencingTag(tag);\n  }).map(tagToParsedType('namepathOrURL'));\n\n  const tagsWithTypes = /** @type {TypeAndTagInfo[]} */ ([\n    ...typeTags,\n    ...namepathReferencingTags,\n    ...namepathOrUrlReferencingTags,\n    // Remove types which failed to parse\n  ].filter(Boolean));\n\n  for (const {\n    parsedType,\n    tag,\n  } of tagsWithTypes) {\n    traverse(parsedType, (nde, parentNode) => {\n      /**\n       * @type {import('jsdoc-type-pratt-parser').NameResult & {\n       *   _parent?: import('jsdoc-type-pratt-parser').NonRootResult\n       * }}\n       */\n      // eslint-disable-next-line canonical/id-match -- Avoid clashes\n      (nde)._parent = parentNode;\n      const {\n        type,\n        value,\n      } = /** @type {import('jsdoc-type-pratt-parser').NameResult} */ (nde);\n\n      let val = value;\n\n      /** @type {import('jsdoc-type-pratt-parser').NonRootResult|undefined} */\n      let currNode = nde;\n      do {\n        currNode =\n          /**\n           * @type {import('jsdoc-type-pratt-parser').NameResult & {\n           *   _parent?: import('jsdoc-type-pratt-parser').NonRootResult\n           * }}\n           */ (currNode)._parent;\n        if (\n          // Avoid appending for imports and globals since we don't want to\n          //  check their properties which may or may not exist\n          !imports.includes(val) && !globals.includes(val) &&\n          !importTags.includes(val) &&\n          !extraTypes.includes(val) &&\n          !typedefDeclarations.includes(val) &&\n          currNode && 'right' in currNode &&\n          currNode.right?.type === 'JsdocTypeProperty') {\n          val = val + '.' + currNode.right.value;\n        }\n      } while (currNode?.type === 'JsdocTypeNamePath');\n\n      if (type === 'JsdocTypeName') {\n        const structuredTypes = structuredTags[tag.tag]?.type;\n        if (!allDefinedTypes.has(val) &&\n          (!Array.isArray(structuredTypes) || !structuredTypes.includes(val))\n        ) {\n          if (!disableReporting) {\n            report(`The type '${val}' is undefined.`, null, tag);\n          }\n        } else if (markVariablesAsUsed && !extraTypes.includes(val)) {\n          if (sourceCode.markVariableAsUsed) {\n            sourceCode.markVariableAsUsed(val);\n          /* c8 ignore next 3 */\n          } else {\n            context.markVariableAsUsed(val);\n          }\n        }\n      }\n    });\n  }\n}, {\n  iterateAllJsdocs: true,\n  meta: {\n    docs: {\n      description: 'Checks that types in jsdoc comments are defined.',\n      url: 'https://github.com/gajus/eslint-plugin-jsdoc/blob/main/docs/rules/no-undefined-types.md#repos-sticky-header',\n    },\n    schema: [\n      {\n        additionalProperties: false,\n        properties: {\n          definedTypes: {\n            items: {\n              type: 'string',\n            },\n            type: 'array',\n          },\n          disableReporting: {\n            type: 'boolean',\n          },\n          markVariablesAsUsed: {\n            type: 'boolean',\n          },\n        },\n        type: 'object',\n      },\n    ],\n    type: 'suggestion',\n  },\n});\n"],"mappings":"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"}

package/dist/rules/noUndefinedTypes.js

@@ -0,0 +1,303 @@
+import iterateJsdoc, { parseComment } from "../iterateJsdoc.js";
+import { getJSDocComment, parse, traverse, tryParse } from "@es-joy/jsdoccomment";
+import { parseImportsExports } from "parse-imports-exports";
+
+//#region src/rules/noUndefinedTypes.js
+const extraTypes = [
+	"null",
+	"undefined",
+	"void",
+	"string",
+	"boolean",
+	"object",
+	"function",
+	"symbol",
+	"number",
+	"bigint",
+	"NaN",
+	"Infinity",
+	"any",
+	"*",
+	"never",
+	"unknown",
+	"const",
+	"this",
+	"true",
+	"false",
+	"Array",
+	"Object",
+	"RegExp",
+	"Date",
+	"Function",
+	"Intl"
+];
+const typescriptGlobals = [
+	"Awaited",
+	"Partial",
+	"Required",
+	"Readonly",
+	"Record",
+	"Pick",
+	"Omit",
+	"Exclude",
+	"Extract",
+	"NonNullable",
+	"Parameters",
+	"ConstructorParameters",
+	"ReturnType",
+	"InstanceType",
+	"ThisParameterType",
+	"OmitThisParameter",
+	"ThisType",
+	"Uppercase",
+	"Lowercase",
+	"Capitalize",
+	"Uncapitalize"
+];
+/**
+* @param {string|false|undefined} [str]
+* @returns {undefined|string|false}
+*/
+const stripPseudoTypes = (str) => {
+	return str && str.replace(/(?:\.|<>|\.<>|\[\])$/v, "");
+};
+var noUndefinedTypes_default = iterateJsdoc(({ context, node, report, settings, sourceCode, utils }) => {
+	const { scopeManager } = sourceCode;
+	const globalScope = scopeManager.globalScope;
+	const { definedTypes = [], disableReporting = false, markVariablesAsUsed = true } = context.options[0] || {};
+	/** @type {(string|undefined)[]} */
+	let definedPreferredTypes = [];
+	const { mode, preferredTypes, structuredTags } = settings;
+	if (Object.keys(preferredTypes).length) definedPreferredTypes = Object.values(preferredTypes).map((preferredType) => {
+		if (typeof preferredType === "string") return stripPseudoTypes(preferredType);
+		if (!preferredType) return void 0;
+		if (typeof preferredType !== "object") utils.reportSettings("Invalid `settings.jsdoc.preferredTypes`. Values must be falsy, a string, or an object.");
+		return stripPseudoTypes(preferredType.replacement);
+	}).filter(Boolean);
+	const allComments = sourceCode.getAllComments();
+	const comments = allComments.filter((comment) => {
+		return /^\*\s/v.test(comment.value);
+	}).map((commentNode) => {
+		return parseComment(commentNode, "");
+	});
+	const globals = allComments.filter((comment) => {
+		return /^\s*globals/v.test(comment.value);
+	}).flatMap((commentNode) => {
+		return commentNode.value.replace(/^\s*globals/v, "").trim().split(/,\s*/v);
+	}).concat(Object.keys(context.languageOptions.globals ?? []));
+	const typedefDeclarations = comments.flatMap((doc) => {
+		return doc.tags.filter(({ tag }) => {
+			return utils.isNamepathDefiningTag(tag);
+		});
+	}).map((tag) => {
+		return tag.name;
+	});
+	const importTags = settings.mode === "typescript" ? comments.flatMap((doc) => {
+		return doc.tags.filter(({ tag }) => {
+			return tag === "import";
+		});
+	}).flatMap((tag) => {
+		const { description, name, type } = tag;
+		const typePart = type ? `{${type}} ` : "";
+		const imprt = "import " + (description ? `${typePart}${name} ${description}` : `${typePart}${name}`);
+		const importsExports = parseImportsExports(imprt.trim());
+		const types = [];
+		const namedImports = Object.values(importsExports.namedImports || {})[0]?.[0];
+		if (namedImports) {
+			if (namedImports.default) types.push(namedImports.default);
+			if (namedImports.names) types.push(...Object.keys(namedImports.names));
+		}
+		const namespaceImports = Object.values(importsExports.namespaceImports || {})[0]?.[0];
+		if (namespaceImports) {
+			if (namespaceImports.namespace) types.push(namespaceImports.namespace);
+			if (namespaceImports.default) types.push(namespaceImports.default);
+		}
+		return types;
+	}).filter(Boolean) : [];
+	const ancestorNodes = [];
+	let currentNode = node;
+	while (currentNode?.parent) {
+		ancestorNodes.push(currentNode);
+		currentNode = currentNode.parent;
+	}
+	/**
+	* @param {import('eslint').Rule.Node} ancestorNode
+	* @returns {import('comment-parser').Spec[]}
+	*/
+	const getTemplateTags = function(ancestorNode) {
+		const commentNode = getJSDocComment(sourceCode, ancestorNode, settings);
+		if (!commentNode) return [];
+		const jsdoc = parseComment(commentNode, "");
+		return jsdoc.tags.filter((tag) => {
+			return tag.tag === "template";
+		});
+	};
+	const templateTags = ancestorNodes.length ? ancestorNodes.flatMap((ancestorNode) => {
+		return getTemplateTags(ancestorNode);
+	}) : utils.getPresentTags(["template"]);
+	const closureGenericTypes = templateTags.flatMap((tag) => {
+		return utils.parseClosureTemplateTag(tag);
+	});
+	const cjsOrESMScope = globalScope.childScopes[0]?.block?.type === "Program";
+	/**
+	* @param {import("eslint").Scope.Scope | null} scope
+	* @returns {Set<string>}
+	*/
+	const getValidRuntimeIdentifiers = (scope) => {
+		const result = /* @__PURE__ */ new Set();
+		let scp = scope;
+		while (scp) {
+			for (const { name } of scp.variables) result.add(name);
+			scp = scp.upper;
+		}
+		return result;
+	};
+	/**
+	* We treat imports differently as we can't introspect their children.
+	* @type {string[]}
+	*/
+	const imports = [];
+	const allDefinedTypes = new Set(globalScope.variables.map(({ name }) => {
+		return name;
+	}).concat(cjsOrESMScope ? globalScope.childScopes.flatMap(({ variables }) => {
+		return variables;
+	}).flatMap(({ identifiers, name }) => {
+		const globalItem = (identifiers?.[0])?.parent;
+		switch (globalItem?.type) {
+			case "ClassDeclaration": return [name, ...globalItem.body.body.map((item) => {
+				const property = (item?.key)?.name;
+				/* c8 ignore next 3 -- Guard */
+				if (!property) return "";
+				return `${name}.${property}`;
+			}).filter(Boolean)];
+			case "ImportDefaultSpecifier":
+			case "ImportNamespaceSpecifier":
+			case "ImportSpecifier":
+				imports.push(name);
+				break;
+			case "TSInterfaceDeclaration": return [name, ...globalItem.body.body.map((item) => {
+				const property = (item?.key)?.name;
+				/* c8 ignore next 3 -- Guard */
+				if (!property) return "";
+				return `${name}.${property}`;
+			}).filter(Boolean)];
+			case "VariableDeclarator":
+				if (((globalItem?.init)?.callee)?.name === "require") {
+					imports.push(
+						/** @type {import('@typescript-eslint/types').TSESTree.Identifier} */
+						globalItem.id.name
+					);
+					break;
+				}
+				return [];
+		}
+		return [name];
+		/* c8 ignore next */
+	}) : []).concat(extraTypes).concat(typedefDeclarations).concat(importTags).concat(definedTypes).concat(definedPreferredTypes).concat((() => {
+		if (node?.type === "MethodDefinition") return node.parent.body.flatMap((methodOrProp) => {
+			if (methodOrProp.type === "MethodDefinition") {
+				if (methodOrProp.key.type === "Identifier") return [methodOrProp.key.name, `${(node.parent?.parent)?.id?.name}.${methodOrProp.key.name}`];
+			}
+			if (methodOrProp.type === "PropertyDefinition") {
+				if (methodOrProp.key.type === "Identifier") return [methodOrProp.key.name, `${(node.parent?.parent)?.id?.name}.${methodOrProp.key.name}`];
+			}
+			/* c8 ignore next 2 -- Not yet built */
+			return "";
+		}).filter(Boolean);
+		return [];
+	})()).concat(...getValidRuntimeIdentifiers(node && (sourceCode.getScope && sourceCode.getScope(node) || context.getScope()))).concat(settings.mode === "jsdoc" ? [] : [...settings.mode === "typescript" ? typescriptGlobals : [], ...closureGenericTypes]));
+	/**
+	* @typedef {{
+	*   parsedType: import('jsdoc-type-pratt-parser').RootResult;
+	*   tag: import('comment-parser').Spec|import('@es-joy/jsdoccomment').JsdocInlineTagNoType & {
+	*     line?: import('../iterateJsdoc.js').Integer
+	*   }
+	* }} TypeAndTagInfo
+	*/
+	/**
+	* @param {string} propertyName
+	* @returns {(tag: (import('@es-joy/jsdoccomment').JsdocInlineTagNoType & {
+	*     name?: string,
+	*     type?: string,
+	*     line?: import('../iterateJsdoc.js').Integer
+	*   })|import('comment-parser').Spec & {
+	*     namepathOrURL?: string
+	*   }
+	* ) => undefined|TypeAndTagInfo}
+	*/
+	const tagToParsedType = (propertyName) => {
+		return (tag) => {
+			try {
+				const potentialType = tag[propertyName];
+				return {
+					parsedType: mode === "permissive" ? tryParse(potentialType) : parse(potentialType, mode),
+					tag
+				};
+			} catch {
+				return void 0;
+			}
+		};
+	};
+	const typeTags = utils.filterTags(({ tag }) => {
+		return tag !== "import" && utils.tagMightHaveTypePosition(tag) && (tag !== "suppress" || settings.mode !== "closure");
+	}).map(tagToParsedType("type"));
+	const namepathReferencingTags = utils.filterTags(({ tag }) => {
+		return utils.isNamepathReferencingTag(tag);
+	}).map(tagToParsedType("name"));
+	const namepathOrUrlReferencingTags = utils.filterAllTags(({ tag }) => {
+		return utils.isNamepathOrUrlReferencingTag(tag);
+	}).map(tagToParsedType("namepathOrURL"));
+	const tagsWithTypes = [
+		...typeTags,
+		...namepathReferencingTags,
+		...namepathOrUrlReferencingTags
+	].filter(Boolean);
+	for (const { parsedType, tag } of tagsWithTypes) traverse(parsedType, (nde, parentNode) => {
+		/**
+		* @type {import('jsdoc-type-pratt-parser').NameResult & {
+		*   _parent?: import('jsdoc-type-pratt-parser').NonRootResult
+		* }}
+		*/
+		nde._parent = parentNode;
+		const { type, value } = nde;
+		let val = value;
+		/** @type {import('jsdoc-type-pratt-parser').NonRootResult|undefined} */
+		let currNode = nde;
+		do {
+			currNode = currNode._parent;
+			if (!imports.includes(val) && !globals.includes(val) && !importTags.includes(val) && !extraTypes.includes(val) && !typedefDeclarations.includes(val) && currNode && "right" in currNode && currNode.right?.type === "JsdocTypeProperty") val = val + "." + currNode.right.value;
+		} while (currNode?.type === "JsdocTypeNamePath");
+		if (type === "JsdocTypeName") {
+			const structuredTypes = structuredTags[tag.tag]?.type;
+			if (!allDefinedTypes.has(val) && (!Array.isArray(structuredTypes) || !structuredTypes.includes(val))) {
+				if (!disableReporting) report(`The type '${val}' is undefined.`, null, tag);
+			} else if (markVariablesAsUsed && !extraTypes.includes(val)) if (sourceCode.markVariableAsUsed) sourceCode.markVariableAsUsed(val);
+			else context.markVariableAsUsed(val);
+		}
+	});
+}, {
+	iterateAllJsdocs: true,
+	meta: {
+		docs: {
+			description: "Checks that types in jsdoc comments are defined.",
+			url: "https://github.com/gajus/eslint-plugin-jsdoc/blob/main/docs/rules/no-undefined-types.md#repos-sticky-header"
+		},
+		schema: [{
+			additionalProperties: false,
+			properties: {
+				definedTypes: {
+					items: { type: "string" },
+					type: "array"
+				},
+				disableReporting: { type: "boolean" },
+				markVariablesAsUsed: { type: "boolean" }
+			},
+			type: "object"
+		}],
+		type: "suggestion"
+	}
+});
+
+//#endregion
+export { noUndefinedTypes_default as default };
+//# sourceMappingURL=noUndefinedTypes.js.map

package/dist/rules/noUndefinedTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"noUndefinedTypes.js","names":["tryParseType","parseType"],"sources":["../../src/rules/noUndefinedTypes.js"],"sourcesContent":["import iterateJsdoc, {\n  parseComment,\n} from '../iterateJsdoc.js';\nimport {\n  getJSDocComment,\n  parse as parseType,\n  traverse,\n  tryParse as tryParseType,\n} from '@es-joy/jsdoccomment';\nimport {\n  parseImportsExports,\n} from 'parse-imports-exports';\n\nconst extraTypes = [\n  'null', 'undefined', 'void', 'string', 'boolean', 'object',\n  'function', 'symbol',\n  'number', 'bigint', 'NaN', 'Infinity',\n  'any', '*', 'never', 'unknown', 'const',\n  'this', 'true', 'false',\n  'Array', 'Object', 'RegExp', 'Date', 'Function', 'Intl',\n];\n\nconst typescriptGlobals = [\n  // https://www.typescriptlang.org/docs/handbook/utility-types.html\n  'Awaited',\n  'Partial',\n  'Required',\n  'Readonly',\n  'Record',\n  'Pick',\n  'Omit',\n  'Exclude',\n  'Extract',\n  'NonNullable',\n  'Parameters',\n  'ConstructorParameters',\n  'ReturnType',\n  'InstanceType',\n  'ThisParameterType',\n  'OmitThisParameter',\n  'ThisType',\n  'Uppercase',\n  'Lowercase',\n  'Capitalize',\n  'Uncapitalize',\n];\n\n/**\n * @param {string|false|undefined} [str]\n * @returns {undefined|string|false}\n */\nconst stripPseudoTypes = (str) => {\n  return str && str.replace(/(?:\\.|<>|\\.<>|\\[\\])$/v, '');\n};\n\nexport default iterateJsdoc(({\n  context,\n  node,\n  report,\n  settings,\n  sourceCode,\n  utils,\n}) => {\n  const {\n    scopeManager,\n  } = sourceCode;\n\n  // When is this ever `null`?\n  const globalScope = /** @type {import('eslint').Scope.Scope} */ (\n    scopeManager.globalScope\n  );\n\n  const\n    /**\n     * @type {{\n     *   definedTypes: string[],\n     *   disableReporting: boolean,\n     *   markVariablesAsUsed: boolean\n     * }}\n     */ {\n      definedTypes = [],\n      disableReporting = false,\n      markVariablesAsUsed = true,\n    } = context.options[0] || {};\n\n  /** @type {(string|undefined)[]} */\n  let definedPreferredTypes = [];\n  const {\n    mode,\n    preferredTypes,\n    structuredTags,\n  } = settings;\n  if (Object.keys(preferredTypes).length) {\n    definedPreferredTypes = /** @type {string[]} */ (Object.values(preferredTypes).map((preferredType) => {\n      if (typeof preferredType === 'string') {\n        // May become an empty string but will be filtered out below\n        return stripPseudoTypes(preferredType);\n      }\n\n      if (!preferredType) {\n        return undefined;\n      }\n\n      if (typeof preferredType !== 'object') {\n        utils.reportSettings(\n          'Invalid `settings.jsdoc.preferredTypes`. Values must be falsy, a string, or an object.',\n        );\n      }\n\n      return stripPseudoTypes(preferredType.replacement);\n    })\n      .filter(Boolean));\n  }\n\n  const allComments = sourceCode.getAllComments();\n  const comments = allComments\n    .filter((comment) => {\n      return (/^\\*\\s/v).test(comment.value);\n    })\n    .map((commentNode) => {\n      return parseComment(commentNode, '');\n    });\n\n  const globals = allComments\n    .filter((comment) => {\n      return (/^\\s*globals/v).test(comment.value);\n    }).flatMap((commentNode) => {\n      return commentNode.value.replace(/^\\s*globals/v, '').trim().split(/,\\s*/v);\n    }).concat(Object.keys(context.languageOptions.globals ?? []));\n\n  const typedefDeclarations = comments\n    .flatMap((doc) => {\n      return doc.tags.filter(({\n        tag,\n      }) => {\n        return utils.isNamepathDefiningTag(tag);\n      });\n    })\n    .map((tag) => {\n      return tag.name;\n    });\n\n  const importTags = settings.mode === 'typescript' ? /** @type {string[]} */ (comments.flatMap((doc) => {\n    return doc.tags.filter(({\n      tag,\n    }) => {\n      return tag === 'import';\n    });\n  }).flatMap((tag) => {\n    const {\n      description,\n      name,\n      type,\n    } = tag;\n    const typePart = type ? `{${type}} ` : '';\n    const imprt = 'import ' + (description ?\n      `${typePart}${name} ${description}` :\n      `${typePart}${name}`);\n\n    const importsExports = parseImportsExports(imprt.trim());\n\n    const types = [];\n    const namedImports = Object.values(importsExports.namedImports || {})[0]?.[0];\n    if (namedImports) {\n      if (namedImports.default) {\n        types.push(namedImports.default);\n      }\n\n      if (namedImports.names) {\n        types.push(...Object.keys(namedImports.names));\n      }\n    }\n\n    const namespaceImports = Object.values(importsExports.namespaceImports || {})[0]?.[0];\n    if (namespaceImports) {\n      if (namespaceImports.namespace) {\n        types.push(namespaceImports.namespace);\n      }\n\n      if (namespaceImports.default) {\n        types.push(namespaceImports.default);\n      }\n    }\n\n    return types;\n  }).filter(Boolean)) : [];\n\n  const ancestorNodes = [];\n\n  let currentNode = node;\n  // No need for Program node?\n  while (currentNode?.parent) {\n    ancestorNodes.push(currentNode);\n    currentNode = currentNode.parent;\n  }\n\n  /**\n   * @param {import('eslint').Rule.Node} ancestorNode\n   * @returns {import('comment-parser').Spec[]}\n   */\n  const getTemplateTags = function (ancestorNode) {\n    const commentNode = getJSDocComment(sourceCode, ancestorNode, settings);\n    if (!commentNode) {\n      return [];\n    }\n\n    const jsdoc = parseComment(commentNode, '');\n\n    return jsdoc.tags.filter((tag) => {\n      return tag.tag === 'template';\n    });\n  };\n\n  // `currentScope` may be `null` or `Program`, so in such a case,\n  //  we look to present tags instead\n  const templateTags = ancestorNodes.length ?\n    ancestorNodes.flatMap((ancestorNode) => {\n      return getTemplateTags(ancestorNode);\n    }) :\n    utils.getPresentTags([\n      'template',\n    ]);\n\n  const closureGenericTypes = templateTags.flatMap((tag) => {\n    return utils.parseClosureTemplateTag(tag);\n  });\n\n  // In modules, including Node, there is a global scope at top with the\n  //  Program scope inside\n  const cjsOrESMScope = globalScope.childScopes[0]?.block?.type === 'Program';\n\n  /**\n   * @param {import(\"eslint\").Scope.Scope | null} scope\n   * @returns {Set<string>}\n   */\n  const getValidRuntimeIdentifiers = (scope) => {\n    const result = new Set();\n\n    let scp = scope;\n    while (scp) {\n      for (const {\n        name,\n      } of scp.variables) {\n        result.add(name);\n      }\n\n      scp = scp.upper;\n    }\n\n    return result;\n  };\n\n  /**\n   * We treat imports differently as we can't introspect their children.\n   * @type {string[]}\n   */\n  const imports = [];\n\n  const allDefinedTypes = new Set(globalScope.variables.map(({\n    name,\n  }) => {\n    return name;\n  })\n\n    // If the file is a module, concat the variables from the module scope.\n    .concat(\n      cjsOrESMScope ?\n        globalScope.childScopes.flatMap(({\n          variables,\n        }) => {\n          return variables;\n        }).flatMap(({\n          identifiers,\n          name,\n        }) => {\n          const globalItem = /** @type {import('estree').Identifier & {parent: import('@typescript-eslint/types').TSESTree.Node}} */ (\n            identifiers?.[0]\n          )?.parent;\n          switch (globalItem?.type) {\n            case 'ClassDeclaration':\n              return [\n                name,\n                ...globalItem.body.body.map((item) => {\n                  const property = /** @type {import('@typescript-eslint/types').TSESTree.Identifier} */ (\n                    /** @type {import('@typescript-eslint/types').TSESTree.PropertyDefinition} */ (\n                      item)?.key)?.name;\n                  /* c8 ignore next 3 -- Guard */\n                  if (!property) {\n                    return '';\n                  }\n\n                  return `${name}.${property}`;\n                }).filter(Boolean),\n              ];\n            case 'ImportDefaultSpecifier':\n            case 'ImportNamespaceSpecifier':\n            case 'ImportSpecifier':\n              imports.push(name);\n              break;\n            case 'TSInterfaceDeclaration':\n              return [\n                name,\n                ...globalItem.body.body.map((item) => {\n                  const property = /** @type {import('@typescript-eslint/types').TSESTree.Identifier} */ (\n                    /** @type {import('@typescript-eslint/types').TSESTree.TSPropertySignature} */ (\n                      item)?.key)?.name;\n                  /* c8 ignore next 3 -- Guard */\n                  if (!property) {\n                    return '';\n                  }\n\n                  return `${name}.${property}`;\n                }).filter(Boolean),\n              ];\n            case 'VariableDeclarator':\n              if (/** @type {import('@typescript-eslint/types').TSESTree.Identifier} */ (\n                /** @type {import('@typescript-eslint/types').TSESTree.CallExpression} */ (\n                  globalItem?.init\n                )?.callee)?.name === 'require'\n              ) {\n                imports.push(/** @type {import('@typescript-eslint/types').TSESTree.Identifier} */ (\n                  globalItem.id\n                ).name);\n                break;\n              }\n\n              return [];\n          }\n\n          return [\n            name,\n          ];\n        /* c8 ignore next */\n        }) : [],\n    )\n    .concat(extraTypes)\n    .concat(typedefDeclarations)\n    .concat(importTags)\n    .concat(definedTypes)\n    .concat(/** @type {string[]} */ (definedPreferredTypes))\n    .concat((() => {\n      // Other methods are not in scope, but we need them, and we grab them here\n      if (node?.type === 'MethodDefinition') {\n        return /** @type {import('estree').ClassBody} */ (node.parent).body.flatMap((methodOrProp) => {\n          if (methodOrProp.type === 'MethodDefinition') {\n            // eslint-disable-next-line unicorn/no-lonely-if -- Pattern\n            if (methodOrProp.key.type === 'Identifier') {\n              return [\n                methodOrProp.key.name,\n                `${/** @type {import('estree').ClassDeclaration} */ (\n                  node.parent?.parent\n                )?.id?.name}.${methodOrProp.key.name}`,\n              ];\n            }\n          }\n\n          if (methodOrProp.type === 'PropertyDefinition') {\n            // eslint-disable-next-line unicorn/no-lonely-if -- Pattern\n            if (methodOrProp.key.type === 'Identifier') {\n              return [\n                methodOrProp.key.name,\n                `${/** @type {import('estree').ClassDeclaration} */ (\n                  node.parent?.parent\n                )?.id?.name}.${methodOrProp.key.name}`,\n              ];\n            }\n          }\n          /* c8 ignore next 2 -- Not yet built */\n\n          return '';\n        }).filter(Boolean);\n      }\n\n      return [];\n    })())\n    .concat(...getValidRuntimeIdentifiers(node && (\n      (sourceCode.getScope &&\n      /* c8 ignore next 2 */\n      sourceCode.getScope(node)) ||\n      context.getScope()\n    )))\n    .concat(\n      settings.mode === 'jsdoc' ?\n        [] :\n        [\n          ...settings.mode === 'typescript' ? typescriptGlobals : [],\n          ...closureGenericTypes,\n        ],\n    ));\n\n  /**\n   * @typedef {{\n   *   parsedType: import('jsdoc-type-pratt-parser').RootResult;\n   *   tag: import('comment-parser').Spec|import('@es-joy/jsdoccomment').JsdocInlineTagNoType & {\n   *     line?: import('../iterateJsdoc.js').Integer\n   *   }\n   * }} TypeAndTagInfo\n   */\n\n  /**\n   * @param {string} propertyName\n   * @returns {(tag: (import('@es-joy/jsdoccomment').JsdocInlineTagNoType & {\n   *     name?: string,\n   *     type?: string,\n   *     line?: import('../iterateJsdoc.js').Integer\n   *   })|import('comment-parser').Spec & {\n   *     namepathOrURL?: string\n   *   }\n   * ) => undefined|TypeAndTagInfo}\n   */\n  const tagToParsedType = (propertyName) => {\n    return (tag) => {\n      try {\n        const potentialType = tag[\n          /** @type {\"type\"|\"name\"|\"namepathOrURL\"} */ (propertyName)\n        ];\n        return {\n          parsedType: mode === 'permissive' ?\n            tryParseType(/** @type {string} */ (potentialType)) :\n            parseType(/** @type {string} */ (potentialType), mode),\n          tag,\n        };\n      } catch {\n        return undefined;\n      }\n    };\n  };\n\n  const typeTags = utils.filterTags(({\n    tag,\n  }) => {\n    return tag !== 'import' && utils.tagMightHaveTypePosition(tag) && (tag !== 'suppress' || settings.mode !== 'closure');\n  }).map(tagToParsedType('type'));\n\n  const namepathReferencingTags = utils.filterTags(({\n    tag,\n  }) => {\n    return utils.isNamepathReferencingTag(tag);\n  }).map(tagToParsedType('name'));\n\n  const namepathOrUrlReferencingTags = utils.filterAllTags(({\n    tag,\n  }) => {\n    return utils.isNamepathOrUrlReferencingTag(tag);\n  }).map(tagToParsedType('namepathOrURL'));\n\n  const tagsWithTypes = /** @type {TypeAndTagInfo[]} */ ([\n    ...typeTags,\n    ...namepathReferencingTags,\n    ...namepathOrUrlReferencingTags,\n    // Remove types which failed to parse\n  ].filter(Boolean));\n\n  for (const {\n    parsedType,\n    tag,\n  } of tagsWithTypes) {\n    traverse(parsedType, (nde, parentNode) => {\n      /**\n       * @type {import('jsdoc-type-pratt-parser').NameResult & {\n       *   _parent?: import('jsdoc-type-pratt-parser').NonRootResult\n       * }}\n       */\n      // eslint-disable-next-line canonical/id-match -- Avoid clashes\n      (nde)._parent = parentNode;\n      const {\n        type,\n        value,\n      } = /** @type {import('jsdoc-type-pratt-parser').NameResult} */ (nde);\n\n      let val = value;\n\n      /** @type {import('jsdoc-type-pratt-parser').NonRootResult|undefined} */\n      let currNode = nde;\n      do {\n        currNode =\n          /**\n           * @type {import('jsdoc-type-pratt-parser').NameResult & {\n           *   _parent?: import('jsdoc-type-pratt-parser').NonRootResult\n           * }}\n           */ (currNode)._parent;\n        if (\n          // Avoid appending for imports and globals since we don't want to\n          //  check their properties which may or may not exist\n          !imports.includes(val) && !globals.includes(val) &&\n          !importTags.includes(val) &&\n          !extraTypes.includes(val) &&\n          !typedefDeclarations.includes(val) &&\n          currNode && 'right' in currNode &&\n          currNode.right?.type === 'JsdocTypeProperty') {\n          val = val + '.' + currNode.right.value;\n        }\n      } while (currNode?.type === 'JsdocTypeNamePath');\n\n      if (type === 'JsdocTypeName') {\n        const structuredTypes = structuredTags[tag.tag]?.type;\n        if (!allDefinedTypes.has(val) &&\n          (!Array.isArray(structuredTypes) || !structuredTypes.includes(val))\n        ) {\n          if (!disableReporting) {\n            report(`The type '${val}' is undefined.`, null, tag);\n          }\n        } else if (markVariablesAsUsed && !extraTypes.includes(val)) {\n          if (sourceCode.markVariableAsUsed) {\n            sourceCode.markVariableAsUsed(val);\n          /* c8 ignore next 3 */\n          } else {\n            context.markVariableAsUsed(val);\n          }\n        }\n      }\n    });\n  }\n}, {\n  iterateAllJsdocs: true,\n  meta: {\n    docs: {\n      description: 'Checks that types in jsdoc comments are defined.',\n      url: 'https://github.com/gajus/eslint-plugin-jsdoc/blob/main/docs/rules/no-undefined-types.md#repos-sticky-header',\n    },\n    schema: [\n      {\n        additionalProperties: false,\n        properties: {\n          definedTypes: {\n            items: {\n              type: 'string',\n            },\n            type: 'array',\n          },\n          disableReporting: {\n            type: 'boolean',\n          },\n          markVariablesAsUsed: {\n            type: 'boolean',\n          },\n        },\n        type: 'object',\n      },\n    ],\n    type: 'suggestion',\n  },\n});\n"],"mappings":"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"}